lorcana-oracle

Instructions

Implementation Reference

• src/tools/character-versions.ts:32-76 (handler)

  The handler implementation for the 'character_versions' tool, which fetches cards by name, handles partial matches, and formats the output.

  async (args) => {
    const cards = getCardsByCharacterName(db, args.character_name);
  
    if (cards.length === 0) {
      // Try partial match suggestions
      const suggestions = db
        .prepare(
          'SELECT DISTINCT name FROM cards WHERE name LIKE @pattern LIMIT 5',
        )
        .all({ pattern: `%${args.character_name}%` }) as { name: string }[];
  
      let text = `No versions found for character "${args.character_name}".`;
      if (suggestions.length > 0) {
        text += `\n\nDid you mean one of these?\n${suggestions.map((s) => `  - ${s.name}`).join('\n')}`;
      }
  
      return {
        content: [{ type: 'text' as const, text }],
        isError: true,
      };
    }
  
    // Group by version
    const versionMap = new Map<string, CardRow[]>();
    for (const card of cards) {
      const version = card.version ?? card.full_name ?? card.name;
      const existing = versionMap.get(version) ?? [];
      existing.push(card);
      versionMap.set(version, existing);
    }
  
    const header = `**${args.character_name}** — ${versionMap.size} version${versionMap.size !== 1 ? 's' : ''}, ${cards.length} printing${cards.length !== 1 ? 's' : ''}`;
  
    const sections: string[] = [header, ''];
    for (const [, printings] of versionMap) {
      for (const card of printings) {
        sections.push(formatVersionCard(card));
        sections.push('');
      }
    }
  
    return {
      content: [{ type: 'text' as const, text: sections.join('\n').trimEnd() }],
    };
  },

• src/tools/character-versions.ts:28-30 (schema)

  The Zod schema defining the input for the 'character_versions' tool.

  inputSchema: {
    character_name: z.string().describe('Character base name (e.g. "Elsa", "Mickey Mouse")'),
  },

• src/tools/character-versions.ts:23-23 (registration)

  The tool name registration for the 'character_versions' tool.

  'character_versions',