trace_line
Trace along specified lines with controlled speed and message delivery to implement strategic flows and creative workflows in the LLV Helix Framework.
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 | |
| message | No | Message or data to carry along the line | |
| speed | No | Speed multiplier |
Implementation Reference
- index.js:575-608 (handler)The primary handler function that implements the logic for tracing a line: checks if line exists, creates a trace record with timestamp, message, speed, and rhythm step, appends to line's traces, and returns a formatted response with visualization.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)Input schema defining parameters for the trace_line tool: line_name (required string), optional speed (number 0.1-10), optional message (string).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: defines name, description, and inputSchema for trace_line.{ 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 registration in the CallToolRequestSchema switch statement that calls the traceLine handler.case 'trace_line': return this.traceLine(args);