LLV Helix Framework

Instructions

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);