trace_line
Trace a line with controlled speed and message delivery to implement strategic flows within the LLV Helix Framework's creativity operating system.
Instructions
Trace along a line with a specific rhythm
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| line_name | Yes | Name of the line to trace | |
| speed | No | Speed multiplier | |
| message | No | Message or data to carry along the line |
Implementation Reference
- index.js:575-608 (handler)The main handler function that implements the logic for the 'trace_line' tool. It validates the line exists, creates a trace entry with rhythm application, updates the line data, and returns a visual response.traceLine(args) { const { line_name, speed = 1, message = '' } = args; const line = this.lines.get(line_name); if (!line) { return { content: [ { type: 'text', text: `❌ Line "${line_name}" not found.`, }, ], }; } const rhythm = this.rhythms.get(`line_${line_name}`); const trace = { timestamp: new Date().toISOString(), message, speed, rhythmStep: rhythm ? rhythm.next() : 1, }; line.traces.push(trace); return { content: [ { type: 'text', text: `〰️ Tracing line "${line_name}"\n\nFrom: ${line.from} → To: ${line.to}\nSpeed: ${speed}x\nMessage: "${message}"\n\n${this.animateLineTrace(line.rhythm, speed)}\n\nRhythm pulse: ${trace.rhythmStep}`, }, ], }; }
- index.js:153-172 (schema)JSON schema defining the input parameters for the 'trace_line' tool, including required line_name and optional speed and message.inputSchema: { type: 'object', properties: { line_name: { type: 'string', description: 'Name of the line to trace', }, speed: { type: 'number', minimum: 0.1, maximum: 10, description: 'Speed multiplier', }, message: { type: 'string', description: 'Message or data to carry along the line', }, }, required: ['line_name'], },
- index.js:150-173 (registration)Tool registration in the listTools response, including name, description, and input schema.{ name: 'trace_line', description: 'Trace along a line with a specific rhythm', inputSchema: { type: 'object', properties: { line_name: { type: 'string', description: 'Name of the line to trace', }, speed: { type: 'number', minimum: 0.1, maximum: 10, description: 'Speed multiplier', }, message: { type: 'string', description: 'Message or data to carry along the line', }, }, required: ['line_name'], }, },
- index.js:339-340 (registration)Dispatch case in the CallToolRequest handler that routes 'trace_line' calls to the traceLine method.case 'trace_line': return this.traceLine(args);