LLV Helix Framework

Instructions

Implementation Reference

• index.js:488-544 (handler)

  The main handler function for the 'create_vibe' tool. Validates inputs (name required, energy required, frequency 1-100 optional default 50, rhythm enum optional default 'ambient'). Checks if vibe exists, creates vibe object with metadata, stores in this.vibes Map, generates rhythm, returns success message with visualization.

  createVibe(args) {
    const { name, energy, frequency = 50, rhythm = 'ambient' } = args;
  
    if (!name || name.trim().length === 0) {
      return {
        content: [
          {
            type: 'text',
            text: `❌ Vibe name is required. Please provide a name for the vibe.`,
          },
        ],
      };
    }
  
    if (!energy || energy.trim().length === 0) {
      return {
        content: [
          {
            type: 'text',
            text: `❌ Energy type is required. Please specify an energy: calm, intense, chaotic, focused, or expansive.`,
          },
        ],
      };
    }
  
    if (this.vibes.has(name)) {
      return {
        content: [
          {
            type: 'text',
            text: `⚠️ Vibe "${name}" already exists. Use a different name or pulse the existing vibe.`,
          },
        ],
      };
    }
  
    const vibe = {
      name,
      energy,
      frequency,
      rhythm,
      created_at: new Date().toISOString(),
      pulses: [],
    };
  
    this.vibes.set(name, vibe);
    this.rhythms.set(`vibe_${name}`, this.generateRhythm(rhythm));
  
    return {
      content: [
        {
          type: 'text',
          text: `✨ Vibe "${name}" created!\n\nEnergy: ${energy}\nFrequency: ${frequency} Hz\nRhythm: ${rhythm}\n\n${this.visualizeVibeEnergy(energy, frequency)}\n\nThe ${energy} vibe resonates at ${frequency}Hz with ${rhythm} rhythm.`,
        },
      ],
    };
  }

• index.js:96-125 (schema)

  Tool schema definition for 'create_vibe' in the listTools response. Specifies inputSchema with properties name (string req), energy (enum req), frequency (number 1-100 opt), rhythm (enum opt); required: ['name', 'energy'].

  {
    name: 'create_vibe',
    description: 'Create a vibe - an energy or atmosphere',
    inputSchema: {
      type: 'object',
      properties: {
        name: {
          type: 'string',
          description: 'Name of the vibe',
        },
        energy: {
          type: 'string',
          enum: ['calm', 'intense', 'chaotic', 'focused', 'expansive'],
          description: 'Energy type',
        },
        frequency: {
          type: 'number',
          minimum: 1,
          maximum: 100,
          description: 'Frequency/tempo (1-100 Hz)',
        },
        rhythm: {
          type: 'string',
          enum: ['ambient', 'driving', 'syncopated', 'polyrhythmic', 'freeform'],
          description: 'Rhythmic pattern',
        },
      },
      required: ['name', 'energy'],
    },
  },

• index.js:335-336 (registration)

  Registration/dispatch in the CallToolRequestSchema switch statement: routes calls to 'create_vibe' to the createVibe handler method.

  case 'create_vibe':
    return this.createVibe(args);