LLV Helix Framework

Instructions

Implementation Reference

• index.js:361-428 (handler)

  The primary handler function for the 'create_line' tool. It validates inputs (name, from, to, optional rhythm), checks for duplicates, creates and stores a line object in the 'lines' Map, generates a rhythm generator, and returns a formatted success response with visualization.

  createLine(args) {
    const { name, from, to, rhythm = 'steady' } = args;
  
    if (!name || name.trim().length === 0) {
      return {
        content: [
          {
            type: 'text',
            text: `❌ Line name is required. Please provide a name for the line.`,
          },
        ],
      };
    }
  
    if (!from || from.trim().length === 0) {
      return {
        content: [
          {
            type: 'text',
            text: `❌ Starting point (from) is required. Please specify where the line starts.`,
          },
        ],
      };
    }
  
    if (!to || to.trim().length === 0) {
      return {
        content: [
          {
            type: 'text',
            text: `❌ Ending point (to) is required. Please specify where the line ends.`,
          },
        ],
      };
    }
  
    if (this.lines.has(name)) {
      return {
        content: [
          {
            type: 'text',
            text: `⚠️ Line "${name}" already exists. Use a different name or trace the existing line.`,
          },
        ],
      };
    }
  
    const line = {
      name,
      from,
      to,
      rhythm,
      created_at: new Date().toISOString(),
      traces: [],
    };
  
    this.lines.set(name, line);
    this.rhythms.set(`line_${name}`, this.generateRhythm(rhythm));
  
    return {
      content: [
        {
          type: 'text',
          text: `〰️ Line "${name}" created!\n\nFrom: ${from} → To: ${to}\nRhythm: ${rhythm}\n\n${this.visualizeLineRhythm(rhythm)}\n\nThe line is ready to carry messages with ${rhythm} rhythm.`,
        },
      ],
    };
  }

• index.js:48-70 (schema)

  The input schema defining the parameters for the 'create_line' tool, including required fields name, from, to and optional rhythm with enum values.

  inputSchema: {
    type: 'object',
    properties: {
      name: {
        type: 'string',
        description: 'Name of the line',
      },
      from: {
        type: 'string',
        description: 'Starting point',
      },
      to: {
        type: 'string',
        description: 'Ending point',
      },
      rhythm: {
        type: 'string',
        enum: ['steady', 'accelerating', 'pulsing', 'syncopated', 'flowing'],
        description: 'Rhythm of the line',
      },
    },
    required: ['name', 'from', 'to'],
  },

• index.js:45-71 (registration)

  The tool registration object returned in ListToolsRequestSchema handler, specifying name, description, and inputSchema for 'create_line'.

  {
    name: 'create_line',
    description: 'Create a line - a connection or path between points',
    inputSchema: {
      type: 'object',
      properties: {
        name: {
          type: 'string',
          description: 'Name of the line',
        },
        from: {
          type: 'string',
          description: 'Starting point',
        },
        to: {
          type: 'string',
          description: 'Ending point',
        },
        rhythm: {
          type: 'string',
          enum: ['steady', 'accelerating', 'pulsing', 'syncopated', 'flowing'],
          description: 'Rhythm of the line',
        },
      },
      required: ['name', 'from', 'to'],
    },
  },

• index.js:331-332 (registration)

  The switch case in CallToolRequestSchema handler that dispatches 'create_line' calls to the createLine method.

  case 'create_line':
    return this.createLine(args);