keyring-agent-core 0.2.0 → 0.2.2

package/dist/agent/Router.js

@@ -1,229 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Router = void 0;
-const historyUtils_1 = require("../memory/historyUtils");
-const ROUTER_SYSTEM_PROMPT = `You are a ROUTER.
-
-The incoming user query has ALREADY been contextualized upstream — it is a
-self-contained, standalone question. Your ONLY job: decide which subagent(s)
-to call. You MUST NOT answer the user — output JSON only.
-
-## OUTPUT FORMAT
-
-{
-  "analysis": "<one-line intent summary in user's language>",
-  "assignments": [
-    {
-      "subagent": "<exact subagent name>",
-      "query": "<focused sub-query for that subagent, user's language>",
-      "reasoning": "<one-line reason>"
-    }
-  ]
-}
-
-## HOW TO DECIDE
-
-Read each subagent's description carefully — they fully define what each agent handles and what it does NOT handle.
-Apply this priority order:
-
-1. Does the query match a specific subagent's described scope? → assign it.
-2. Does it span multiple subagent scopes? → emit MULTIPLE assignments (they run in PARALLEL).
-3. No specific subagent matches BUT the query is about blockchain / crypto / token / NFT / wallet / DeFi / on-chain data / smart contracts / any supported EVM chain → assign "ai-agent" with the user's original query.
-4. Only return "assignments": [] for pure general knowledge, small-talk, or clearly non-crypto queries.
-
-NOTE: wallet-agent / token-agent / nft-agent each have an internal AI Cortex fallback,
-so it is safe to route a wallet/token/NFT-shaped query to its matching domain agent even
-if no specific structured tool obviously fits — the agent will fall back to Cortex on its own.
-
-## HARD RULES
-
-- ONLY use subagent names from the provided list. NEVER invent names.
-- Keep each "query" focused and concise — do not copy the full user message if only part belongs to that subagent.
-- Do NOT include tool names, chain ids, or implementation details in the query field.
-- Match the user's language in all fields.`;
-/**
- * Router — top-level orchestrator in the Router → Subagent → Tool architecture.
- *
- * The router's LLM sees only subagent "cards" (name + one-liner), which keeps
- * the planning prompt small and predictable regardless of how many tools
- * each subagent owns.
- */
-class Router {
-    llm;
-    historyMessages;
-    debug;
-    constructor(llm, options) {
-        this.llm = llm;
-        // Wider default window so follow-ups ("the first one", "yes") can still
-        // see the previous assistant reply even after a couple of short turns.
-        this.historyMessages = options?.historyMessages ?? 10;
-        this.debug = options?.debug ?? false;
-    }
-    /**
-     * Ask the LLM to decide which subagent(s) should handle the query.
-     * Returns `{ assignments: [] }` when no subagent is needed.
-     *
-     * @param lastSubagents Subagent(s) that handled the previous assistant
-     *   turn. Passed as a "sticky" hint — useful for short follow-ups.
-     */
-    async route(userQuery, conversationHistory, cards, userContext, lastSubagents = []) {
-        const cardsText = cards.map((c) => `### ${c.name} (domain: ${c.domain})\n${c.description}`).join('\n\n');
-        const contextParts = [];
-        if (userContext?.walletAddress)
-            contextParts.push(`Connected wallet: ${userContext.walletAddress}`);
-        if (userContext?.chain)
-            contextParts.push(`Current chain: ${userContext.chain}`);
-        const contextSection = contextParts.length > 0 ? `\n\nUser context:\n${contextParts.join('\n')}` : '';
-        // Sticky-routing hint: if the previous turn was handled by subagent X,
-        // a follow-up very likely belongs to X too. The router is free to
-        // override when the query clearly belongs elsewhere.
-        const stickyHint = lastSubagents.length > 0
-            ? `\n\nPrevious turn handled by: ${lastSubagents.join(', ')}. ` +
-                `If this query is a natural continuation (same topic), prefer the same subagent(s). ` +
-                `Override only if the query clearly belongs to a different domain.`
-            : '';
-        // Router has NO tools declared, so strip tool messages (otherwise Gemini
-        // sees orphan functionResponse parts). Then keep the recent window
-        // without splitting any remaining tool-call group.
-        const cleanHistory = (0, historyUtils_1.stripToolMessages)(conversationHistory);
-        const windowed = (0, historyUtils_1.sliceRecentKeepingToolPairs)(cleanHistory, this.historyMessages);
-        if (this.debug) {
-            console.log(`\n[Router] history window (${windowed.length} msg${windowed.length === 1 ? '' : 's'}):`);
-            console.log(`[Router] user query: "${userQuery}"`);
-        }
-        const messages = [
-            { role: 'system', content: ROUTER_SYSTEM_PROMPT, timestamp: 0 },
-            ...windowed,
-            {
-                role: 'user',
-                content: `Available subagents:\n${cardsText}${contextSection}${stickyHint}\n\nUser query: ${userQuery}`,
-                timestamp: Date.now(),
-            },
-        ];
-        const t0 = Date.now();
-        // The router LLM occasionally answers in prose ("I can help you send USDC…")
-        // instead of the required JSON. Retry once, re-prompting it to emit ONLY
-        // JSON, before giving up and falling back to a direct answer.
-        let parsed = null;
-        let lastRaw = '';
-        let lastErr = null;
-        for (let attempt = 1; attempt <= 2; attempt++) {
-            const response = await this.llm.chat(messages);
-            lastRaw = response.text;
-            try {
-                parsed = this.parseJSON(response.text);
-                break;
-            }
-            catch (err) {
-                lastErr = err;
-                if (attempt < 2) {
-                    if (this.debug)
-                        console.log(`[Router] JSON parse failed (attempt ${attempt}) — re-prompting for JSON`);
-                    messages.push({ role: 'assistant', content: response.text || '', timestamp: Date.now() });
-                    messages.push({
-                        role: 'user',
-                        content: 'That response was not valid JSON. Do NOT answer the user and do NOT ask any questions. ' +
-                            'Reply with ONLY the routing JSON object ' +
-                            '({"analysis": "...", "assignments": [...]}) and nothing else.',
-                        timestamp: Date.now(),
-                    });
-                }
-            }
-        }
-        const routerMs = Date.now() - t0;
-        if (!parsed) {
-            if (this.debug) {
-                console.log(`[Router] JSON parse failed after retry: ${lastErr}`);
-                console.log(`[Router] raw response: ${lastRaw.slice(0, 300)}`);
-            }
-            return { analysis: 'Router could not parse response.', assignments: [] };
-        }
-        const validNames = new Set(cards.map((c) => c.name));
-        const assignments = Array.isArray(parsed.assignments)
-            ? parsed.assignments
-                .filter((a) => !!a && typeof a.subagent === 'string')
-                .filter((a) => validNames.has(a.subagent))
-                .map((a) => ({
-                subagent: a.subagent,
-                query: typeof a.query === 'string' && a.query ? a.query : userQuery,
-                reasoning: typeof a.reasoning === 'string' ? a.reasoning : '',
-            }))
-            : [];
-        if (this.debug) {
-            const label = assignments.length > 0 ? assignments.map((a) => a.subagent).join(', ') : '(none — direct answer)';
-            console.log(`\n[Router] (${routerMs}ms)`);
-            console.log(`  analysis : ${parsed.analysis ?? ''}`);
-            console.log(`  dispatch : ${label}`);
-            if (assignments.length > 0) {
-                for (const a of assignments) {
-                    console.log(`    → ${a.subagent}: "${a.query}"`);
-                    console.log(`       reason: ${a.reasoning}`);
-                }
-            }
-        }
-        return {
-            analysis: typeof parsed.analysis === 'string' ? parsed.analysis : '',
-            assignments,
-        };
-    }
-    /**
-     * Dispatch assignments to the matching subagents in parallel.
-     * Each subagent runs its own ReAct loop and returns a SubagentResult.
-     */
-    async dispatch(decision, subagents, conversationHistory, userContext) {
-        if (decision.assignments.length === 0)
-            return [];
-        if (this.debug) {
-            console.log(`\n[Router] dispatching ${decision.assignments.length} subagent(s) in parallel…`);
-        }
-        const t0 = Date.now();
-        const runs = decision.assignments.map(async (a) => {
-            const agent = subagents.get(a.subagent);
-            if (!agent) {
-                if (this.debug)
-                    console.log(`[Router] WARN: subagent "${a.subagent}" not registered`);
-                return {
-                    subagentName: a.subagent,
-                    steps: [],
-                    finalAnswer: `Subagent "${a.subagent}" is not registered.`,
-                    toolResults: [],
-                    toolMessages: [],
-                };
-            }
-            const t1 = Date.now();
-            const result = await agent.run({ query: a.query, reasoning: a.reasoning }, conversationHistory, userContext);
-            if (this.debug) {
-                const toolNames = result.toolResults.map((r) => r.toolName).join(', ') || '—';
-                console.log(`[Router] ${a.subagent} done in ${Date.now() - t1}ms | tools: ${toolNames}`);
-            }
-            return result;
-        });
-        const results = await Promise.all(runs);
-        if (this.debug) {
-            console.log(`[Router] all subagents done in ${Date.now() - t0}ms total`);
-        }
-        return results;
-    }
-    parseJSON(text) {
-        let clean = text.trim();
-        if (clean.startsWith('```')) {
-            clean = clean
-                .replace(/^```(?:json)?\s*/, '')
-                .replace(/```\s*$/, '')
-                .trim();
-        }
-        try {
-            return JSON.parse(clean);
-        }
-        catch (err) {
-            // Salvage a JSON object embedded in prose (model prepended a sentence
-            // before the object). Grab from the first "{" to the last "}".
-            const match = clean.match(/\{[\s\S]*\}/);
-            if (match)
-                return JSON.parse(match[0]);
-            throw err;
-        }
-    }
-}
-exports.Router = Router;
-//# sourceMappingURL=Router.js.map

package/dist/agent/Router.js.map

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

package/dist/agent/Subagent.d.ts

@@ -1,80 +0,0 @@
-import type { ChatMessage, LLMProvider, SubagentCard, SubagentResult, SubagentTask, UserContext } from '../types';
-import type { ToolRegistry } from '../tools/ToolRegistry';
-export interface SubagentOptions {
-    /** Max number of tool calls inside one run (budget). Default: 5 */
-    maxToolCalls?: number;
-    /** Max tokens of recent conversation history to include. Default: 6 messages */
-    historyMessages?: number;
-    /** Enable debug logging */
-    debug?: boolean;
-    /**
-     * Website link for adding liquidity / creating a pool, sourced from
-     * `AgentConfig.subgraph.linkAddLiquidity`. Only the `pool-subgraph` subagent
-     * uses it: when set, its prompt is told to append this URL whenever the user
-     * asks to add liquidity. Ignored by every other subagent.
-     */
-    linkAddLiquidity?: string;
-}
-export interface SubagentParams {
-    /** Unique id, e.g. "wallet-agent" */
-    name: string;
-    /** Capability description shown to the router LLM (dense, one-liner) */
-    description: string;
-    /** Domain tag, e.g. "wallet" */
-    domain: string;
-    /** Tool names this subagent is allowed to invoke. */
-    toolNames: string[];
-    /** Domain-expert system prompt */
-    systemPrompt: string;
-    /**
-     * Optional Cortex AI fallback tool name. When set, if the first LLM turn
-     * returns no tool calls, the subagent re-prompts the LLM and forces it to
-     * call this tool — guaranteeing the user's query goes to Cortex instead of
-     * being answered by the LLM's own knowledge with no on-chain data.
-     */
-    cortexFallbackTool?: string;
-    /**
-     * When true, this subagent must act via a tool on every routed query — it
-     * may never answer with plain text on the first turn. If the LLM tries to
-     * (e.g. asks "which token?" instead of opening the form), the subagent
-     * re-prompts once forcing it to pick the matching tool. Used by the
-     * wallet-action agent, whose whole job is to emit a form. Ignored when
-     * `cortexFallbackTool` is set (that path already forces a tool).
-     */
-    mustCallTool?: boolean;
-    llm: LLMProvider;
-    registry: ToolRegistry;
-    options?: SubagentOptions;
-}
-/**
- * Domain-specialised worker in the Router → Subagent → Tool architecture.
- *
- * Each subagent:
- *  - owns a narrow subset of tools (by name)
- *  - runs its own ReAct loop via native function calling
- *  - produces a domain-scoped summary + the raw tool results
- *
- * Keeping each subagent's tool surface small is the main token-cost win:
- * the LLM receives only ~5 tool schemas instead of ~23.
- */
-export declare class Subagent {
-    readonly name: string;
-    readonly description: string;
-    readonly domain: string;
-    private readonly toolNames;
-    private readonly systemPrompt;
-    private readonly cortexFallbackTool?;
-    private readonly mustCallTool;
-    private readonly llm;
-    private readonly registry;
-    private readonly maxToolCalls;
-    private readonly historyMessages;
-    private readonly debug;
-    constructor(params: SubagentParams);
-    /** Card shown to the router for selection. */
-    getCard(): SubagentCard;
-    /** Only the tools this subagent owns, resolved from the shared registry. */
-    private getTools;
-    run(task: SubagentTask, conversationHistory: ChatMessage[], userContext?: UserContext): Promise<SubagentResult>;
-}
-//# sourceMappingURL=Subagent.d.ts.map

package/dist/agent/Subagent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Subagent.d.ts","sourceRoot":"","sources":["../../src/agent/Subagent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EAEX,YAAY,EACZ,cAAc,EACd,YAAY,EAGZ,WAAW,EACZ,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,MAAM,EAAE,cAAc;IAsBlC,8CAA8C;IAC9C,OAAO,IAAI,YAAY;IAIvB,4EAA4E;IAC5E,OAAO,CAAC,QAAQ;IAIV,GAAG,CACP,IAAI,EAAE,YAAY,EAClB,mBAAmB,EAAE,WAAW,EAAE,EAClC,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,cAAc,CAAC;CAgP3B"}

package/dist/agent/Subagent.js

@@ -1,272 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Subagent = void 0;
-const historyUtils_1 = require("../memory/historyUtils");
-/**
- * Domain-specialised worker in the Router → Subagent → Tool architecture.
- *
- * Each subagent:
- *  - owns a narrow subset of tools (by name)
- *  - runs its own ReAct loop via native function calling
- *  - produces a domain-scoped summary + the raw tool results
- *
- * Keeping each subagent's tool surface small is the main token-cost win:
- * the LLM receives only ~5 tool schemas instead of ~23.
- */
-class Subagent {
-    name;
-    description;
-    domain;
-    toolNames;
-    systemPrompt;
-    cortexFallbackTool;
-    mustCallTool;
-    llm;
-    registry;
-    maxToolCalls;
-    historyMessages;
-    debug;
-    constructor(params) {
-        this.name = params.name;
-        this.description = params.description;
-        this.domain = params.domain;
-        this.toolNames = new Set(params.toolNames);
-        this.systemPrompt = params.systemPrompt;
-        this.cortexFallbackTool = params.cortexFallbackTool;
-        this.mustCallTool = params.mustCallTool ?? false;
-        if (this.cortexFallbackTool && !this.toolNames.has(this.cortexFallbackTool)) {
-            throw new Error(`Subagent "${params.name}": cortexFallbackTool "${this.cortexFallbackTool}" must be in toolNames.`);
-        }
-        this.llm = params.llm;
-        this.registry = params.registry;
-        this.maxToolCalls = params.options?.maxToolCalls ?? 5;
-        // Wider default window so follow-up turns ("detail the first one", "more")
-        // can still see the previous assistant reply + tool results they reference.
-        this.historyMessages = params.options?.historyMessages ?? 10;
-        this.debug = params.options?.debug ?? false;
-    }
-    /** Card shown to the router for selection. */
-    getCard() {
-        return { name: this.name, description: this.description, domain: this.domain };
-    }
-    /** Only the tools this subagent owns, resolved from the shared registry. */
-    getTools() {
-        return this.registry.getDefinitions().filter((t) => this.toolNames.has(t.name));
-    }
-    async run(task, conversationHistory, userContext) {
-        const tools = this.getTools();
-        if (this.debug) {
-            console.log(`\n  [${this.name}] query: "${task.query}"`);
-            console.log(`  [${this.name}] tools available: ${tools.map((t) => t.name).join(', ')}`);
-        }
-        if (tools.length === 0) {
-            return {
-                subagentName: this.name,
-                steps: [],
-                finalAnswer: `Subagent "${this.name}" has no registered tools available.`,
-                toolResults: [],
-                toolMessages: [],
-            };
-        }
-        const trace = [];
-        const toolResults = [];
-        // Interleaved assistant+toolCalls / role:'tool' messages for ChatHistory
-        const toolMessages = [];
-        const calledKeys = new Set();
-        let toolCallCount = 0;
-        // Guards the one-shot "you must call a tool" re-prompt (see mustCallTool).
-        let forcedToolRetry = false;
-        const contextParts = [];
-        if (userContext?.walletAddress)
-            contextParts.push(`Connected wallet: ${userContext.walletAddress}`);
-        if (userContext?.chain)
-            contextParts.push(`Current chain: ${userContext.chain}`);
-        const contextSection = contextParts.length > 0 ? `User context:\n${contextParts.join('\n')}` : '';
-        // Tell the LLM the exact language of the current turn. The Routed query is
-        // already in the user's language, but short/normalized queries can read as
-        // English and make the model default any generated strings (e.g. localized
-        // tool arguments like action-button prompts) to English. Stating the tag
-        // explicitly removes that ambiguity.
-        const languageLine = task.language
-            ? `The user's current language is "${task.language}" (BCP-47). Write every user-facing string ` +
-                `you produce — replies AND any localized tool arguments — in this language.`
-            : '';
-        const userContent = [
-            contextSection,
-            languageLine,
-            `Routed query: ${task.query}`,
-            task.reasoning ? `Router reasoning: ${task.reasoning}` : '',
-            "Use only the tools you own. If you already have enough information, respond directly in the user's language.",
-        ]
-            .filter(Boolean)
-            .join('\n\n');
-        // Filter history so only tool messages this subagent owns survive (orphan
-        // functionResponse parts would confuse Gemini since its tool schema only
-        // contains this subagent's tools). Then keep a recent window without
-        // splitting any remaining tool-call group.
-        const filteredHistory = (0, historyUtils_1.filterToolMessagesForSubagent)(conversationHistory, this.toolNames);
-        const windowed = (0, historyUtils_1.sliceRecentKeepingToolPairs)(filteredHistory, this.historyMessages);
-        const messages = [
-            { role: 'system', content: this.systemPrompt, timestamp: 0 },
-            ...windowed,
-            { role: 'user', content: userContent, timestamp: Date.now() },
-        ];
-        // Max chars stored per tool result in history.
-        // Must be large enough to preserve: transaction hashes (66 chars each),
-        // pagination cursors (100–300 chars), and enough transactions for
-        // follow-up lookups ("details of this tx"). 6000 chars ≈ 5–6 transactions
-        // with full ERC-20 transfer data while keeping context cost acceptable.
-        const TOOL_RESULT_MAX_CHARS = 6000;
-        const maxIterations = this.maxToolCalls + 2;
-        for (let i = 0; i < maxIterations; i++) {
-            const budgetLeft = toolCallCount < this.maxToolCalls;
-            const toolsThisTurn = budgetLeft ? tools : undefined;
-            const response = await this.llm.chat(messages, toolsThisTurn);
-            if (response.toolCalls.length === 0) {
-                // First-turn safety net: the subagent owns tools but the LLM tried to
-                // answer from its own knowledge. If a Cortex fallback is declared,
-                // re-prompt the LLM and force it to call Cortex with the user's query.
-                // This guarantees on-chain-shaped questions never get a hallucinated
-                // answer with zero tool calls.
-                if (toolCallCount === 0 && this.cortexFallbackTool && budgetLeft) {
-                    if (this.debug) {
-                        console.log(`  [${this.name}] no tool called — forcing fallback to ${this.cortexFallbackTool}`);
-                    }
-                    messages.push({
-                        role: 'user',
-                        content: `You answered without calling any tool. This is not allowed for on-chain queries. ` +
-                            `Call "${this.cortexFallbackTool}" now with a clear, well-formed English prompt that captures the user's intent. ` +
-                            `Resolve ambiguity with sensible defaults (chain: Ethereum unless specified; result count: top 10; ` +
-                            `time window: last 24h; sort key: 24h volume for "top/best/trending" queries). ` +
-                            `Do NOT answer in text — call the tool.`,
-                        timestamp: Date.now(),
-                    });
-                    continue;
-                }
-                // Action subagents (mustCallTool) must open a form via a tool — they may
-                // never stop to ask the user for missing fields. Force one retry where
-                // the LLM picks the matching tool itself.
-                if (toolCallCount === 0 && this.mustCallTool && budgetLeft && !forcedToolRetry) {
-                    forcedToolRetry = true;
-                    if (this.debug) {
-                        console.log(`  [${this.name}] no tool called — forcing the LLM to pick a tool`);
-                    }
-                    messages.push({
-                        role: 'user',
-                        content: `You answered in text without calling any tool. That is not allowed here: this request needs you to open a form. ` +
-                            `Call exactly ONE of your tools that matches the user's intent now. Pass only the fields the user actually gave; ` +
-                            `leave everything else blank — the tool/form collects the rest (including a token/amount picker when needed). ` +
-                            `Do NOT ask the user for missing fields. Do NOT answer in text — call the tool.`,
-                        timestamp: Date.now(),
-                    });
-                    continue;
-                }
-                if (this.debug) {
-                    console.log(`  [${this.name}] done — ${toolCallCount} tool call(s), answer: "${response.text.slice(0, 80)}…"`);
-                }
-                return { subagentName: this.name, steps: trace, finalAnswer: response.text, toolResults, toolMessages };
-            }
-            // The assistant message sent to Gemini for this iteration.
-            // We push it to `messages` now and will push to `toolMessages` only if
-            // at least one valid tool call succeeds in this iteration.
-            const assistantMsg = {
-                role: 'assistant',
-                content: response.text || '',
-                toolCalls: response.toolCalls,
-                timestamp: Date.now(),
-            };
-            messages.push(assistantMsg);
-            // Collect per-iteration valid tool results before deciding what to store.
-            const iterationToolMsgs = [];
-            for (const tc of response.toolCalls) {
-                if (!this.toolNames.has(tc.toolName)) {
-                    const err = `Tool "${tc.toolName}" is not owned by ${this.name}`;
-                    if (this.debug)
-                        console.log(`  [${this.name}] WARN: ${err}`);
-                    trace.push({ phase: 'observe', content: err, timestamp: Date.now() });
-                    messages.push({
-                        role: 'tool',
-                        content: err,
-                        toolName: tc.toolName,
-                        toolCallId: tc.callId,
-                        timestamp: Date.now(),
-                    });
-                    continue;
-                }
-                const key = `${tc.toolName}::${JSON.stringify(tc.args)}`;
-                if (calledKeys.has(key)) {
-                    const skip = `Skipped duplicate call: ${tc.toolName}`;
-                    if (this.debug)
-                        console.log(`  [${this.name}] SKIP duplicate: ${tc.toolName}`);
-                    trace.push({ phase: 'observe', content: skip, timestamp: Date.now() });
-                    messages.push({
-                        role: 'tool',
-                        content: skip,
-                        toolName: tc.toolName,
-                        toolCallId: tc.callId,
-                        timestamp: Date.now(),
-                    });
-                    continue;
-                }
-                calledKeys.add(key);
-                toolCallCount++;
-                if (this.debug) {
-                    console.log(`  [${this.name}] call #${toolCallCount}: ${tc.toolName} ${JSON.stringify(tc.args)}`);
-                }
-                trace.push({ phase: 'think', content: response.text || `Calling ${tc.toolName}`, timestamp: Date.now() });
-                trace.push({
-                    phase: 'act',
-                    content: `Calling tool: ${tc.toolName}`,
-                    toolCall: { toolName: tc.toolName, args: tc.args },
-                    timestamp: Date.now(),
-                });
-                const t0 = Date.now();
-                const result = await this.registry.execute(tc.toolName, tc.args, userContext);
-                toolResults.push(result);
-                const observation = result.success ? JSON.stringify(result.data) : `Error: ${result.error}`;
-                if (this.debug) {
-                    const status = result.success ? 'OK' : 'ERR';
-                    const preview = result.success
-                        ? `${observation.slice(0, 120)}${observation.length > 120 ? '…' : ''}`
-                        : result.error;
-                    console.log(`  [${this.name}] ${status} (${Date.now() - t0}ms): ${preview}`);
-                }
-                trace.push({ phase: 'observe', content: observation, toolResult: result, timestamp: Date.now() });
-                const toolMsg = {
-                    role: 'tool',
-                    content: observation,
-                    toolName: tc.toolName,
-                    toolCallId: tc.callId,
-                    timestamp: Date.now(),
-                };
-                messages.push(toolMsg);
-                // Store a size-capped version in history so cursors + key data survive
-                // across turns without ballooning the context window.
-                iterationToolMsgs.push({
-                    ...toolMsg,
-                    content: observation.length > TOOL_RESULT_MAX_CHARS
-                        ? observation.slice(0, TOOL_RESULT_MAX_CHARS) + '…[truncated]'
-                        : observation,
-                });
-            }
-            // If any valid tool was called this iteration, persist the assistant
-            // function-call message + truncated results into toolMessages.
-            if (iterationToolMsgs.length > 0) {
-                toolMessages.push(assistantMsg);
-                toolMessages.push(...iterationToolMsgs);
-            }
-        }
-        if (this.debug) {
-            console.log(`  [${this.name}] budget exhausted after ${toolCallCount} calls, forcing final answer`);
-        }
-        messages.push({
-            role: 'user',
-            content: 'Tool budget reached. Give your best answer now based on the data gathered.',
-            timestamp: Date.now(),
-        });
-        const final = await this.llm.chat(messages);
-        return { subagentName: this.name, steps: trace, finalAnswer: final.text, toolResults, toolMessages };
-    }
-}
-exports.Subagent = Subagent;
-//# sourceMappingURL=Subagent.js.map

package/dist/agent/Subagent.js.map

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

package/dist/agent/Synthesizer.d.ts

@@ -1,11 +0,0 @@
-import type { ChatMessage, LLMProvider, ReActTrace } from '../types';
-/**
- * Takes the ReAct execution trace and produces a polished
- * final response suitable for the end user.
- */
-export declare class Synthesizer {
-    private llm;
-    constructor(llm: LLMProvider);
-    synthesise(userQuery: string, trace: ReActTrace, conversationHistory: ChatMessage[], language?: string): Promise<string>;
-}
-//# sourceMappingURL=Synthesizer.d.ts.map

package/dist/agent/Synthesizer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Synthesizer.d.ts","sourceRoot":"","sources":["../../src/agent/Synthesizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAcrE;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAc;gBAEb,GAAG,EAAE,WAAW;IAItB,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,EACjB,mBAAmB,EAAE,WAAW,EAAE,EAClC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;CAoDnB"}