@shuyhere/takotako 0.0.1

package/dist/commands/dispatch.js

@@ -0,0 +1,68 @@
+/**
+ * Command dispatcher — routes parsed commands to the appropriate handler.
+ *
+ * Supports two dispatch modes:
+ * - tool dispatch: call a tool directly, return result (no model turn)
+ * - model dispatch (default): inject skill instructions into system prompt,
+ *   forward to agent loop as a normal message
+ */
+/**
+ * Dispatch a parsed command against registered skill commands.
+ *
+ * - If the command maps to a tool-dispatch skill, execute the tool directly.
+ * - If the command maps to a model-dispatch skill, return instructions for injection.
+ * - Returns not-found if no skill command matches.
+ */
+export async function dispatchSkillCommand(parsed, specs, context) {
+    // Handle `/skill <name> [input]` generic runner
+    let spec;
+    let args = parsed.args;
+    if (parsed.command === 'skill') {
+        // Parse skill name from args
+        const parts = parsed.args.split(/\s+/, 2);
+        const skillName = parts[0];
+        args = parsed.args.slice(skillName?.length ?? 0).trim();
+        spec = specs.find((s) => s.skillName === skillName || s.name === skillName);
+    }
+    else {
+        spec = specs.find((s) => s.name === parsed.command);
+    }
+    if (!spec) {
+        return { kind: 'not-found' };
+    }
+    // Tool dispatch — execute directly, no model turn
+    if (spec.dispatch?.kind === 'tool') {
+        const tool = context.toolRegistry.getTool(spec.dispatch.toolName);
+        if (!tool) {
+            return {
+                kind: 'tool-result',
+                response: `Tool "${spec.dispatch.toolName}" not found for skill "${spec.skillName}".`,
+            };
+        }
+        try {
+            const result = await tool.execute(spec.dispatch.argMode === 'raw' ? { input: args } : { input: args }, context.toolContext);
+            return {
+                kind: 'tool-result',
+                response: result.output,
+            };
+        }
+        catch (err) {
+            return {
+                kind: 'tool-result',
+                response: `Error executing ${spec.dispatch.toolName}: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    // Model dispatch — inject skill instructions, forward message to agent loop
+    const skill = context.skillLoader.get(spec.skillName);
+    if (!skill) {
+        return { kind: 'not-found' };
+    }
+    return {
+        kind: 'skill-inject',
+        skillName: spec.skillName,
+        instructions: skill.instructions,
+        forwardMessage: args || parsed.raw,
+    };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/commands/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/commands/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoCH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAqB,EACrB,KAAyB,EACzB,OAAwB;IAExB,gDAAgD;IAChD,IAAI,IAAkC,CAAC;IACvC,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEvB,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,6BAA6B;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC9E,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IAED,kDAAkD;IAClD,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ,0BAA0B,IAAI,CAAC,SAAS,IAAI;aACtF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAC/B,IAAI,CAAC,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EACnE,OAAO,CAAC,WAAW,CACpB,CAAC;YACF,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,MAAM,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,mBAAmB,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;aAC3G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,cAAc,EAAE,IAAI,IAAI,MAAM,CAAC,GAAG;KACnC,CAAC;AACJ,CAAC"}

package/dist/commands/model-picker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Interactive Model Picker for Discord.
+ *
+ * Shows an ephemeral embed with provider/model dropdowns and action buttons.
+ * Provider selection dynamically updates the model dropdown.
+ */
+import { type ChatInputCommandInteraction } from 'discord.js';
+export interface ModelPickerDeps {
+    getModel: () => string;
+    setModel: (ref: string) => void;
+    getDefaultModel: () => string;
+    getProviders: () => string[];
+    getModelsForProvider: (provider: string) => string[];
+}
+export declare function showModelPicker(interaction: ChatInputCommandInteraction, deps: ModelPickerDeps): Promise<void>;
+//# sourceMappingURL=model-picker.d.ts.map

package/dist/commands/model-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-picker.d.ts","sourceRoot":"","sources":["../../src/commands/model-picker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAML,KAAK,2BAA2B,EACjC,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,YAAY,EAAE,MAAM,MAAM,EAAE,CAAC;IAC7B,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CACtD;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,2BAA2B,EACxC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CAsIf"}

package/dist/commands/model-picker.js

@@ -0,0 +1,120 @@
+/**
+ * Interactive Model Picker for Discord.
+ *
+ * Shows an ephemeral embed with provider/model dropdowns and action buttons.
+ * Provider selection dynamically updates the model dropdown.
+ */
+import { ActionRowBuilder, StringSelectMenuBuilder, ButtonBuilder, ButtonStyle, EmbedBuilder, } from 'discord.js';
+export async function showModelPicker(interaction, deps) {
+    const current = deps.getModel();
+    const defaultModel = deps.getDefaultModel();
+    const providers = deps.getProviders();
+    // Parse current provider/model from ref like "anthropic/claude-sonnet-4-6"
+    const slashIdx = current.indexOf('/');
+    const currentProvider = slashIdx >= 0 ? current.slice(0, slashIdx) : providers[0];
+    const currentModelName = slashIdx >= 0 ? current.slice(slashIdx + 1) : current;
+    const models = deps.getModelsForProvider(currentProvider);
+    const embed = new EmbedBuilder()
+        .setTitle('Model Picker')
+        .setDescription(`**Current model:** \`${current}\`\n**Default:** \`${defaultModel}\`\n\nSelect a provider and model, then press **Submit**.`)
+        .setColor(0x5865f2);
+    function buildProviderRow(selected) {
+        return new ActionRowBuilder().addComponents(new StringSelectMenuBuilder()
+            .setCustomId('model_picker_provider')
+            .setPlaceholder('Select provider')
+            .addOptions(providers.map((p) => ({
+            label: p,
+            value: p,
+            default: p === selected,
+        }))));
+    }
+    function buildModelRow(modelList, selected) {
+        const opts = modelList.slice(0, 25);
+        if (opts.length === 0) {
+            opts.push('(none)');
+        }
+        return new ActionRowBuilder().addComponents(new StringSelectMenuBuilder()
+            .setCustomId('model_picker_model')
+            .setPlaceholder('Select model')
+            .addOptions(opts.map((m) => ({
+            label: m,
+            value: m,
+            default: m === selected,
+        }))));
+    }
+    const buttons = new ActionRowBuilder().addComponents(new ButtonBuilder()
+        .setCustomId('model_picker_cancel')
+        .setLabel('Cancel')
+        .setStyle(ButtonStyle.Secondary), new ButtonBuilder()
+        .setCustomId('model_picker_reset')
+        .setLabel('Reset to default')
+        .setStyle(ButtonStyle.Secondary), new ButtonBuilder()
+        .setCustomId('model_picker_submit')
+        .setLabel('Submit')
+        .setStyle(ButtonStyle.Primary));
+    await interaction.reply({
+        embeds: [embed],
+        components: [buildProviderRow(currentProvider), buildModelRow(models, currentModelName), buttons],
+        flags: 64, // ephemeral
+    });
+    const replyMessage = await interaction.fetchReply();
+    let selectedProvider = currentProvider;
+    let selectedModel = models.includes(currentModelName) ? currentModelName : models[0] ?? '';
+    const collector = replyMessage.createMessageComponentCollector({
+        time: 60_000,
+    });
+    collector.on('collect', async (i) => {
+        if (i.customId === 'model_picker_provider' && i.isStringSelectMenu()) {
+            selectedProvider = i.values[0];
+            const newModels = deps.getModelsForProvider(selectedProvider);
+            selectedModel = newModels[0] ?? '';
+            await i.update({
+                embeds: [embed],
+                components: [buildProviderRow(selectedProvider), buildModelRow(newModels, selectedModel), buttons],
+            });
+        }
+        else if (i.customId === 'model_picker_model' && i.isStringSelectMenu()) {
+            selectedModel = i.values[0];
+            await i.deferUpdate();
+        }
+        else if (i.customId === 'model_picker_submit' && i.isButton()) {
+            const fullRef = `${selectedProvider}/${selectedModel}`;
+            deps.setModel(fullRef);
+            await i.update({
+                content: `Model switched to **${fullRef}**`,
+                embeds: [],
+                components: [],
+            });
+            collector.stop();
+        }
+        else if (i.customId === 'model_picker_reset' && i.isButton()) {
+            deps.setModel(defaultModel);
+            await i.update({
+                content: `Model reset to default: **${defaultModel}**`,
+                embeds: [],
+                components: [],
+            });
+            collector.stop();
+        }
+        else if (i.customId === 'model_picker_cancel' && i.isButton()) {
+            await i.update({
+                content: 'Model picker cancelled.',
+                embeds: [],
+                components: [],
+            });
+            collector.stop();
+        }
+    });
+    collector.on('end', (_, reason) => {
+        if (reason === 'time') {
+            interaction
+                .editReply({
+                content: 'Model picker timed out.',
+                embeds: [],
+                components: [],
+            })
+                .catch(() => { });
+        }
+    });
+}
+//# sourceMappingURL=model-picker.js.map

package/dist/commands/model-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-picker.js","sourceRoot":"","sources":["../../src/commands/model-picker.ts"],"names":[],"mappings":"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"}

package/dist/commands/parser.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Command parser — extracts /command and args from user messages.
+ */
+/**
+ * Parsed command from a user message.
+ */
+export interface ParsedCommand {
+    /** Command name without the leading / */
+    command: string;
+    /** Everything after the command name (trimmed) */
+    args: string;
+    /** Original message text */
+    raw: string;
+}
+/**
+ * Parse a message for a /command invocation.
+ * Returns null if the message is not a command.
+ *
+ * Matches messages starting with / followed by a-z0-9_.
+ * Special: `/skill <name> [input]` is parsed with command='skill'.
+ */
+export declare function parseCommand(message: string): ParsedCommand | null;
+export interface ApproveCommandArgs {
+    requestId: string;
+    decision: 'allow' | 'deny' | 'allow-always';
+}
+/**
+ * Parse `/approve <id> allow|deny|allow-always` command.
+ * Returns null if the message is not an approve command.
+ */
+export declare function parseApproveCommand(parsed: ParsedCommand): ApproveCommandArgs | null;
+//# sourceMappingURL=parser.d.ts.map

package/dist/commands/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/commands/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAYlE;AAID,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,cAAc,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,GAAG,IAAI,CAUpF"}

package/dist/commands/parser.js

@@ -0,0 +1,39 @@
+/**
+ * Command parser — extracts /command and args from user messages.
+ */
+/**
+ * Parse a message for a /command invocation.
+ * Returns null if the message is not a command.
+ *
+ * Matches messages starting with / followed by a-z0-9_.
+ * Special: `/skill <name> [input]` is parsed with command='skill'.
+ */
+export function parseCommand(message) {
+    const trimmed = message.trim();
+    if (!trimmed.startsWith('/'))
+        return null;
+    const match = trimmed.match(/^\/([a-z0-9_]+)(?:\s+(.*))?$/s);
+    if (!match)
+        return null;
+    return {
+        command: match[1],
+        args: (match[2] ?? '').trim(),
+        raw: trimmed,
+    };
+}
+/**
+ * Parse `/approve <id> allow|deny|allow-always` command.
+ * Returns null if the message is not an approve command.
+ */
+export function parseApproveCommand(parsed) {
+    if (parsed.command !== 'approve')
+        return null;
+    const match = parsed.args.match(/^(\S+)\s+(allow|deny|allow-always)$/);
+    if (!match)
+        return null;
+    return {
+        requestId: match[1],
+        decision: match[2],
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/commands/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/commands/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACjB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC7B,GAAG,EAAE,OAAO;KACb,CAAC;AACJ,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACnB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAsC;KACxD,CAAC;AACJ,CAAC"}

package/dist/commands/registry.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Command registry — handles slash commands locally before they reach the agent loop.
+ *
+ * Built-in commands: /status, /help, /new, /compact, /model, /agents, /whoami
+ */
+import type { Session } from '../gateway/session.js';
+import type { SkillCommandSpec } from './skill-commands.js';
+import type { LoadedSkill } from '../skills/types.js';
+import type { UsageTracker } from '../core/usage-tracker.js';
+export interface CommandContext {
+    channelId: string;
+    authorId: string;
+    authorName: string;
+    session: Session;
+    agentId: string;
+}
+export interface CommandDeps {
+    getModel: () => string;
+    setModel: (ref: string) => void;
+    getDefaultModel?: () => string;
+    getFallbackModels?: () => string[];
+    listAgents: () => Array<{
+        id: string;
+        description?: string;
+        role?: string;
+    }>;
+    compactSession: (sessionId: string, keepLast?: number) => Promise<void>;
+    resetSession?: (sessionId: string) => Promise<void>;
+    estimateTokens: (session: Session) => number;
+    startTime: number;
+    getWorkspaceRoot?: () => string;
+    getSessionCount?: () => number;
+    getChannelNames?: () => string[];
+    getSkillCount?: () => number;
+    getToolCount?: () => number;
+    getQueueMode?: () => string;
+    setQueueMode?: (mode: 'off' | 'collect' | 'debounce') => void;
+    getQueueStatus?: () => Array<{
+        sessionId: string;
+        depth: number;
+        oldestMs: number;
+    }>;
+    usageTracker?: UsageTracker;
+}
+interface Command {
+    name: string;
+    description: string;
+    handler: (args: string, ctx: CommandContext) => Promise<string>;
+}
+export declare class CommandRegistry {
+    private deps;
+    private commands;
+    constructor(deps: CommandDeps);
+    /** Parse and handle a command. Returns response string, or null if not a known command. */
+    handle(input: string, ctx: CommandContext): Promise<string | null>;
+    /** Get all registered commands (for Telegram bot menu, /help, etc.). */
+    list(): Array<{
+        name: string;
+        description: string;
+    }>;
+    /** Get a registered command by name (for external lookup). */
+    getCommand(name: string): Command | undefined;
+    /** Registered skill command specs (for channel registration). */
+    private skillSpecs;
+    /** Get registered skill command specs. */
+    getSkillSpecs(): SkillCommandSpec[];
+    /**
+     * Build and register skill commands from loaded skills.
+     * Returns the generated specs for channel registration.
+     */
+    buildFromSkills(skills: LoadedSkill[]): SkillCommandSpec[];
+    private register;
+    private registerBuiltins;
+}
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/commands/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"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"}