keyring-agent-core 0.2.1 → 0.2.3

package/dist/agent/chatGraph.js

@@ -1,184 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildChatGraph = buildChatGraph;
-const langgraph_1 = require("@langchain/langgraph");
-const chainResolver_1 = require("../tools/chainResolver");
-/**
- * Per-turn state. Each channel maps to a value that flows between nodes —
- * the LangGraph replacement for the local variables of the old `chat()`.
- * `subResults` is the only fan-in channel (parallel subagents), so it uses a
- * concat reducer; everything else is single-writer (last value wins).
- */
-const last = (fallback) => ({ reducer: (_, b) => b, default: fallback });
-const TurnState = langgraph_1.Annotation.Root({
-    // inputs
-    userMessage: (0, langgraph_1.Annotation)(),
-    doSuggest: (0, langgraph_1.Annotation)(last(() => true)),
-    overrideLang: (0, langgraph_1.Annotation)(last(() => '')),
-    // setup
-    conversationMessages: (0, langgraph_1.Annotation)(last(() => [])),
-    lastSubagents: (0, langgraph_1.Annotation)(last(() => [])),
-    messageId: (0, langgraph_1.Annotation)(last(() => '')),
-    // rewrite
-    rewrite: (0, langgraph_1.Annotation)(last(() => null)),
-    effectiveQuery: (0, langgraph_1.Annotation)(last(() => '')),
-    turnLanguage: (0, langgraph_1.Annotation)(last(() => '')),
-    // kb
-    kbContext: (0, langgraph_1.Annotation)(last(() => '')),
-    // router
-    decision: (0, langgraph_1.Annotation)(last(() => null)),
-    // fan-out scratch (set per branch by Send)
-    assignment: (0, langgraph_1.Annotation)(last(() => null)),
-    assignmentIndex: (0, langgraph_1.Annotation)(last(() => 0)),
-    // fan-in (parallel subagents append here)
-    subResults: (0, langgraph_1.Annotation)({
-        reducer: (a, b) => a.concat(b),
-        default: () => [],
-    }),
-    // terminal
-    response: (0, langgraph_1.Annotation)(last(() => null)),
-});
-/**
- * Build the compiled chat graph:
- *
- *   START → setup → rewrite → kb ──(KB answered?)──▶ END
- *                                └─▶ route ──(no subagent)──▶ direct ─▶ END
- *                                          └─(Send per subagent)─▶ subagent ─▶ synthesize ─▶ END
- *
- * Subagents fan out via the `Send` API (the standard LangGraph map-reduce) and
- * fan back into `synthesize`, exactly mirroring the old parallel dispatch.
- */
-function buildChatGraph(host) {
-    // ---- nodes ----
-    const setup = async (state) => {
-        host.addUserMessage(state.userMessage);
-        if (host.needsSummary())
-            await host.compactHistory();
-        const conversationMessages = host.conversationForTurn();
-        const lastSubagents = host.lastAssistantSubagents(conversationMessages);
-        if (host.debug && lastSubagents.length > 0) {
-            console.log(`[AgentCore] previous turn handled by: ${lastSubagents.join(', ')}`);
-        }
-        return { conversationMessages, lastSubagents, messageId: host.generateMessageId() };
-    };
-    const rewrite = async (state) => {
-        const rw = await host.rewrite(state.userMessage, state.conversationMessages, state.lastSubagents);
-        const turnLanguage = state.overrideLang || rw.language || '';
-        return { rewrite: rw, effectiveQuery: rw.rewrittenQuery, turnLanguage };
-    };
-    const kb = async (state) => {
-        const rw = state.rewrite;
-        // Follow-ups search with the rewritten query; self-contained turns search
-        // with the original message (closest to what was embedded at upsert time).
-        const kbQuery = rw.isFollowUp ? state.effectiveQuery : state.userMessage;
-        const hits = await host.searchKB(kbQuery);
-        const kbContext = host.formatKBContext(hits);
-        const kbAnswer = await host.tryAnswerFromKB(state.userMessage, hits, kbContext, state.messageId);
-        if (kbAnswer) {
-            return { kbContext, response: { ...kbAnswer, messageId: state.messageId, rewrite: rw } };
-        }
-        return { kbContext };
-    };
-    const route = async (state) => {
-        const decision = await host.route(state.effectiveQuery, state.conversationMessages, host.subagentCards(), state.lastSubagents);
-        return { decision };
-    };
-    const direct = async (state) => {
-        const answer = await host.answerDirectly(state.effectiveQuery, state.conversationMessages, state.kbContext, state.doSuggest, state.messageId, state.rewrite?.needsWebSearch ?? false);
-        return {
-            response: { ...answer, messageId: state.messageId, routerDecision: state.decision, rewrite: state.rewrite },
-        };
-    };
-    const subagent = async (state) => {
-        const result = await host.runSubagent(state.assignment, state.conversationMessages, state.turnLanguage);
-        return { subResults: [{ i: state.assignmentIndex, result }] };
-    };
-    const synthesize = async (state) => {
-        // Restore the router's assignment order (parallel completion is unordered).
-        const results = state.subResults
-            .slice()
-            .sort((a, b) => a.i - b.i)
-            .map((e) => e.result);
-        // Persist tool messages BEFORE synthesising so the synthesiser (and future
-        // turns) can see this turn's tool data via history.
-        host.persistToolMessages(results);
-        const trace = host.mergeTrace(results);
-        const synthesised = await host.synthesise(state.userMessage, trace, host.synthesiserHistory(), state.turnLanguage || undefined);
-        const handledBy = results.map((r) => r.subagentName);
-        const uiActions = host.collectUiActions(results, state.turnLanguage || null);
-        const actionButtons = host.collectActionButtons(results, state.turnLanguage || null);
-        const turnHasSuppressingTool = host.subResultsTriggerNoSuggestions(results);
-        const finalised = await host.finaliseAnswer({
-            userMessage: state.userMessage,
-            answer: synthesised,
-            subagents: handledBy,
-            uiActions,
-            actionButtons,
-            messageId: state.messageId,
-        }, { generateSuggestions: state.doSuggest && !turnHasSuppressingTool && actionButtons.length === 0 });
-        return {
-            response: {
-                ...finalised,
-                messageId: state.messageId,
-                trace,
-                routerDecision: state.decision,
-                subagentResults: results,
-                rewrite: state.rewrite,
-                ...(uiActions.length > 0 ? { uiActions } : {}),
-                ...(actionButtons.length > 0 ? { actionButtons } : {}),
-            },
-        };
-    };
-    /**
-     * Terminal node for the unsupported-connected-chain case: emit a localized
-     * "chain X is not supported" message instead of running chain-scoped tools.
-     */
-    const unsupportedChain = async (state) => {
-        // The unsupported chain is whichever the request targets (named or connected).
-        const raw = (state.rewrite?.mentionedChain || String(host.connectedChain() ?? '')).trim();
-        const answer = await host.answerUnsupportedChain(raw, state.turnLanguage, state.messageId);
-        return {
-            response: { ...answer, messageId: state.messageId, routerDecision: state.decision, rewrite: state.rewrite },
-        };
-    };
-    // ---- conditional edges ----
-    const afterKb = (state) => (state.response ? langgraph_1.END : 'route');
-    const dispatch = (state) => {
-        const assignments = state.decision?.assignments ?? [];
-        if (assignments.length === 0)
-            return 'direct';
-        // The chain this request targets: the one the user explicitly named this
-        // turn (rewriter-extracted), else the connected wallet chain. Block
-        // chain-scoped work when that chain is unsupported — this catches both
-        // "connected to an unsupported chain" AND "asking about an unsupported
-        // chain while connected to a supported one" ("balance on Unichain"). The
-        // chain-agnostic ai-agent is exempt (general/informational answers).
-        const chainScoped = assignments.some((a) => a.subagent !== 'ai-agent');
-        const requested = (state.rewrite?.mentionedChain || host.connectedChain() || '').trim();
-        if (chainScoped && requested !== '' && !(0, chainResolver_1.isSupportedChain)(requested)) {
-            return 'unsupportedChain';
-        }
-        return assignments.map((a, i) => new langgraph_1.Send('subagent', { ...state, assignment: a, assignmentIndex: i }));
-    };
-    // ---- wiring ----
-    return new langgraph_1.StateGraph(TurnState)
-        .addNode('setup', setup)
-        .addNode('contextualize', rewrite)
-        .addNode('kb', kb)
-        .addNode('route', route)
-        .addNode('direct', direct)
-        .addNode('subagent', subagent)
-        .addNode('synthesize', synthesize)
-        .addNode('unsupportedChain', unsupportedChain)
-        .addEdge(langgraph_1.START, 'setup')
-        .addEdge('setup', 'contextualize')
-        .addEdge('contextualize', 'kb')
-        .addConditionalEdges('kb', afterKb, ['route', langgraph_1.END])
-        .addConditionalEdges('route', dispatch, ['direct', 'subagent', 'unsupportedChain'])
-        .addEdge('unsupportedChain', langgraph_1.END)
-        .addEdge('direct', langgraph_1.END)
-        .addEdge('subagent', 'synthesize')
-        .addEdge('synthesize', langgraph_1.END)
-        .compile();
-}
-//# sourceMappingURL=chatGraph.js.map

package/dist/agent/chatGraph.js.map

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

package/dist/agent/index.d.ts

@@ -1,10 +0,0 @@
-export { AgentCore } from './AgentCore';
-export type { AgentResponse } from './AgentCore';
-export { Router } from './Router';
-export { Subagent } from './Subagent';
-export type { SubagentOptions, SubagentParams } from './Subagent';
-export { Synthesizer } from './Synthesizer';
-export { QueryRewriter } from './QueryRewriter';
-export type { RewriteResult, QueryRewriterOptions } from './QueryRewriter';
-export { createDefaultSubagents, createWalletAgent, createTokenAgent, createNftAgent, createAiAgent, WALLET_AGENT_TOOL_NAMES, TOKEN_AGENT_TOOL_NAMES, NFT_AGENT_TOOL_NAMES, AI_AGENT_TOOL_NAMES, } from './subagents';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/dist/agent/index.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AI_AGENT_TOOL_NAMES = exports.NFT_AGENT_TOOL_NAMES = exports.TOKEN_AGENT_TOOL_NAMES = exports.WALLET_AGENT_TOOL_NAMES = exports.createAiAgent = exports.createNftAgent = exports.createTokenAgent = exports.createWalletAgent = exports.createDefaultSubagents = exports.QueryRewriter = exports.Synthesizer = exports.Subagent = exports.Router = exports.AgentCore = void 0;
-var AgentCore_1 = require("./AgentCore");
-Object.defineProperty(exports, "AgentCore", { enumerable: true, get: function () { return AgentCore_1.AgentCore; } });
-var Router_1 = require("./Router");
-Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return Router_1.Router; } });
-var Subagent_1 = require("./Subagent");
-Object.defineProperty(exports, "Subagent", { enumerable: true, get: function () { return Subagent_1.Subagent; } });
-var Synthesizer_1 = require("./Synthesizer");
-Object.defineProperty(exports, "Synthesizer", { enumerable: true, get: function () { return Synthesizer_1.Synthesizer; } });
-var QueryRewriter_1 = require("./QueryRewriter");
-Object.defineProperty(exports, "QueryRewriter", { enumerable: true, get: function () { return QueryRewriter_1.QueryRewriter; } });
-var subagents_1 = require("./subagents");
-Object.defineProperty(exports, "createDefaultSubagents", { enumerable: true, get: function () { return subagents_1.createDefaultSubagents; } });
-Object.defineProperty(exports, "createWalletAgent", { enumerable: true, get: function () { return subagents_1.createWalletAgent; } });
-Object.defineProperty(exports, "createTokenAgent", { enumerable: true, get: function () { return subagents_1.createTokenAgent; } });
-Object.defineProperty(exports, "createNftAgent", { enumerable: true, get: function () { return subagents_1.createNftAgent; } });
-Object.defineProperty(exports, "createAiAgent", { enumerable: true, get: function () { return subagents_1.createAiAgent; } });
-Object.defineProperty(exports, "WALLET_AGENT_TOOL_NAMES", { enumerable: true, get: function () { return subagents_1.WALLET_AGENT_TOOL_NAMES; } });
-Object.defineProperty(exports, "TOKEN_AGENT_TOOL_NAMES", { enumerable: true, get: function () { return subagents_1.TOKEN_AGENT_TOOL_NAMES; } });
-Object.defineProperty(exports, "NFT_AGENT_TOOL_NAMES", { enumerable: true, get: function () { return subagents_1.NFT_AGENT_TOOL_NAMES; } });
-Object.defineProperty(exports, "AI_AGENT_TOOL_NAMES", { enumerable: true, get: function () { return subagents_1.AI_AGENT_TOOL_NAMES; } });
-//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":";;;AAAA,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAElB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAEjB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,yCAUqB;AATnB,mHAAA,sBAAsB,OAAA;AACtB,8GAAA,iBAAiB,OAAA;AACjB,6GAAA,gBAAgB,OAAA;AAChB,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AACb,oHAAA,uBAAuB,OAAA;AACvB,mHAAA,sBAAsB,OAAA;AACtB,iHAAA,oBAAoB,OAAA;AACpB,gHAAA,mBAAmB,OAAA"}

package/dist/agent/subagents/AiAgent.d.ts

@@ -1,6 +0,0 @@
-import type { LLMProvider } from '../../types';
-import type { ToolRegistry } from '../../tools/ToolRegistry';
-import { Subagent, type SubagentOptions } from '../Subagent';
-export declare const AI_AGENT_TOOL_NAMES: readonly ["gemini-search-ai"];
-export declare function createAiAgent(llm: LLMProvider, registry: ToolRegistry, options?: SubagentOptions): Subagent;
-//# sourceMappingURL=AiAgent.d.ts.map

package/dist/agent/subagents/AiAgent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AiAgent.d.ts","sourceRoot":"","sources":["../../../src/agent/subagents/AiAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAuB7D,eAAO,MAAM,mBAAmB,+BAAgC,CAAC;AAEjE,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAwB3G"}

package/dist/agent/subagents/AiAgent.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AI_AGENT_TOOL_NAMES = void 0;
-exports.createAiAgent = createAiAgent;
-const Subagent_1 = require("../Subagent");
-const AI_AGENT_PROMPT = `You are the Crypto AI fallback expert powered by a search-grounded Gemini model.
-
-You answer ANY blockchain / crypto / token / NFT / DeFi / on-chain question that does not have a
-direct structured tool in the other agents. The underlying model has live web-search grounding —
-trust it to handle market-wide, category-level, and protocol-specific questions.
-
-ROUTING:
-- Call exactly ONE tool per turn: gemini-search-ai.
-- Build the prompt to be SELF-CONTAINED — embed everything the model needs without seeing this
-  conversation: the chain (Ethereum / BSC / Base / …), wallet or contract addresses,
-  token symbols, time range, sort key, count, and what to compare.
-- Defaults when the user is vague: chain = Ethereum (or chain from user context), count = top 10,
-  time = last 24h, sort = 24h trading volume for "top / best / trending" queries.
-- Tell the model to use up-to-date web sources when relevance demands it (news, prices,
-  recent on-chain events).
-
-RULES:
-- ALWAYS call the tool — NEVER refuse, NEVER answer without calling it.
-- NEVER retry with the same prompt if the call fails — return what you have.
-- Answer in the user's language. Do NOT mention tool names.`;
-exports.AI_AGENT_TOOL_NAMES = ['gemini-search-ai'];
-function createAiAgent(llm, registry, options) {
-    return new Subagent_1.Subagent({
-        name: 'ai-agent',
-        domain: 'ai',
-        description: [
-            'Catch-all crypto / blockchain expert powered by a search-grounded Gemini model (live Google',
-            'Search). USE THIS AGENT whenever the query is about blockchain, crypto, tokens, NFTs, DeFi,',
-            'wallets, on-chain data, smart contracts, or any supported EVM chain BUT no other agent',
-            '(wallet-agent, token-agent, nft-agent, pool-agent) has a direct structured tool for it.',
-            'Scope examples: (1) token categories or themes — meme tokens, AI tokens, gaming tokens, L2 tokens, RWA;',
-            '(2) protocol-specific questions — "how does X protocol work", "what happened to Y";',
-            '(3) cross-contract or exploratory EVM analysis spanning many contracts;',
-            '(4) any open-ended on-chain question without a direct structured tool.',
-            'Prefer the specific agents when they clearly match (wallet balances → wallet-agent,',
-            'single-token info/analytics → token-agent, NFT holdings/metadata → nft-agent, DEX pools → pool-agent).',
-            'But for anything crypto-related that falls outside those, route HERE — do not return empty.',
-        ].join(' '),
-        toolNames: [...exports.AI_AGENT_TOOL_NAMES],
-        systemPrompt: AI_AGENT_PROMPT,
-        cortexFallbackTool: 'gemini-search-ai',
-        llm,
-        registry,
-        options,
-    });
-}
-//# sourceMappingURL=AiAgent.js.map

package/dist/agent/subagents/AiAgent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AiAgent.js","sourceRoot":"","sources":["../../../src/agent/subagents/AiAgent.ts"],"names":[],"mappings":";;;AA2BA,sCAwBC;AAjDD,0CAA6D;AAE7D,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;4DAmBoC,CAAC;AAEhD,QAAA,mBAAmB,GAAG,CAAC,kBAAkB,CAAU,CAAC;AAEjE,SAAgB,aAAa,CAAC,GAAgB,EAAE,QAAsB,EAAE,OAAyB;IAC/F,OAAO,IAAI,mBAAQ,CAAC;QAClB,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE;YACX,6FAA6F;YAC7F,6FAA6F;YAC7F,wFAAwF;YACxF,yFAAyF;YACzF,yGAAyG;YACzG,qFAAqF;YACrF,yEAAyE;YACzE,wEAAwE;YACxE,qFAAqF;YACrF,wGAAwG;YACxG,6FAA6F;SAC9F,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,SAAS,EAAE,CAAC,GAAG,2BAAmB,CAAC;QACnC,YAAY,EAAE,eAAe;QAC7B,kBAAkB,EAAE,kBAAkB;QACtC,GAAG;QACH,QAAQ;QACR,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/agent/subagents/NftAgent.d.ts

@@ -1,6 +0,0 @@
-import type { LLMProvider } from '../../types';
-import type { ToolRegistry } from '../../tools/ToolRegistry';
-import { Subagent, type SubagentOptions } from '../Subagent';
-export declare const NFT_AGENT_TOOL_NAMES: readonly ["get-wallet-nfts", "get-nft-metadata", "get-nft-contract-info", "send-nft", "gemini-search-ai"];
-export declare function createNftAgent(llm: LLMProvider, registry: ToolRegistry, options?: SubagentOptions): Subagent;
-//# sourceMappingURL=NftAgent.d.ts.map

package/dist/agent/subagents/NftAgent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"NftAgent.d.ts","sourceRoot":"","sources":["../../../src/agent/subagents/NftAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAiD7D,eAAO,MAAM,oBAAoB,2GAMvB,CAAC;AAEX,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAmB5G"}

package/dist/agent/subagents/NftAgent.js

@@ -1,79 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NFT_AGENT_TOOL_NAMES = void 0;
-exports.createNftAgent = createNftAgent;
-const Subagent_1 = require("../Subagent");
-const NFT_AGENT_PROMPT = `You are the NFT domain expert. You answer questions about NFT holdings and metadata, not transfer history.
-
-SPECIALISED TOOLS (prefer these when intent matches):
-- get-wallet-nfts: user wants to view / browse their NFTs / holdings — returns a fixed website notice
-- get-nft-metadata: user asks about a specific NFT (details, traits, floor) — returns a fixed website notice
-- get-nft-contract-info: user asks about a collection / contract — returns a fixed website notice
-- send-nft: user wants to SEND / transfer an NFT ("send nft", "transfer nft", "gửi nft") — returns a fixed website notice
-
-NFT NOTICE TOOLS (all of the above):
-- They return a fixed message you MUST output verbatim (the tool result's _instructions explain). Do NOT translate, rephrase, or add to it; keep any Markdown link exactly as-is.
-- They take no arguments — call the matching one as soon as the intent is clear; never ask the user for an address, token id, or chain.
-
-AI FALLBACK (mandatory when no specialised tool fits):
-- gemini-search-ai — a search-grounded Gemini model that handles EVM NFT queries.
-- Use for: NFT category / theme queries (top PFP, trending mints, gaming NFTs), market-wide NFT
-  analytics, anything without a direct tool.
-- You MUST call a tool every turn. If no specialised tool fits, call gemini-search-ai.
-  Never answer an NFT query from your own knowledge.
-
-BUILDING THE FALLBACK PROMPT:
-- Write in clear English as a direct, self-contained instruction.
-- Make intent explicit: category, sort key, chain (name it: Ethereum / Base / …), count, fields.
-- Defaults when user is vague: chain = Ethereum (or chain from context), count = top 10,
-  time = last 24h, sort = 24h volume.
-- Keep collection names, contract addresses, and token ids verbatim from the user.
-- Embed the connected wallet address only when relevant to the question — the prompt MUST be
-  self-contained (the model does not see this conversation).
-- Tell the model to use up-to-date web sources when relevant.
-
-Example: user "top PFP collections" → fallback prompt:
-"List the top 10 PFP-style NFT collections on Ethereum right now, ranked by 24h trading volume,
-using up-to-date market data. For each: collection name, contract address, floor price in ETH,
-24h volume, and item count."
-
-SCOPE NOTES:
-- "What NFTs do I own?" → handle here.
-- "Send / transfer an NFT" (the action) → handle here (send-nft).
-- "Did I send / receive an NFT?" (past events) → not here, that is transfer history (wallet-agent).
-
-GENERAL RULES:
-- Always pass "chain" as a hex id when calling specialised tools; default 0x1.
-- For a specific NFT by id, use get-nft-metadata with contract address + token id.
-- One tool per turn. Never repeat a tool call with identical arguments.
-- Answer in the user's language. Do not mention tool names.
-
-Chain ids: 0x1 Ethereum · 0xa Optimism · 0x38 BSC · 0x89 Polygon · 0x2105 Base · 0xa4b1 Arbitrum · 0xa86a Avalanche · 0xe708 Linea.`;
-exports.NFT_AGENT_TOOL_NAMES = [
-    'get-wallet-nfts',
-    'get-nft-metadata',
-    'get-nft-contract-info',
-    'send-nft',
-    'gemini-search-ai',
-];
-function createNftAgent(llm, registry, options) {
-    return new Subagent_1.Subagent({
-        name: 'nft-agent',
-        domain: 'nft',
-        description: [
-            'NFT holdings, metadata, and sending. Specialised tools cover NFT holdings, single-NFT metadata,',
-            'collection / contract info, and sending/transferring an NFT. For NFT category, theme, or market-wide',
-            'questions without a direct tool, this agent falls back to a search-grounded Gemini model internally —',
-            'it never refuses an NFT query and always calls a tool.',
-            'Handles the SEND / TRANSFER-an-NFT action ("send nft", "gửi nft"); but past NFT transfer history (events) → wallet-agent.',
-            'Key distinction: nft-agent = NFT holdings / details / send; wallet-agent = NFT TRANSFER-EVENT history.',
-        ].join(' '),
-        toolNames: [...exports.NFT_AGENT_TOOL_NAMES],
-        systemPrompt: NFT_AGENT_PROMPT,
-        cortexFallbackTool: 'gemini-search-ai',
-        llm,
-        registry,
-        options,
-    });
-}
-//# sourceMappingURL=NftAgent.js.map

package/dist/agent/subagents/NftAgent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"NftAgent.js","sourceRoot":"","sources":["../../../src/agent/subagents/NftAgent.ts"],"names":[],"mappings":";;;AA2DA,wCAmBC;AA5ED,0CAA6D;AAE7D,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oIA6C2G,CAAC;AAExH,QAAA,oBAAoB,GAAG;IAClC,iBAAiB;IACjB,kBAAkB;IAClB,uBAAuB;IACvB,UAAU;IACV,kBAAkB;CACV,CAAC;AAEX,SAAgB,cAAc,CAAC,GAAgB,EAAE,QAAsB,EAAE,OAAyB;IAChG,OAAO,IAAI,mBAAQ,CAAC;QAClB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,KAAK;QACb,WAAW,EAAE;YACX,iGAAiG;YACjG,sGAAsG;YACtG,uGAAuG;YACvG,wDAAwD;YACxD,2HAA2H;YAC3H,wGAAwG;SACzG,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,SAAS,EAAE,CAAC,GAAG,4BAAoB,CAAC;QACpC,YAAY,EAAE,gBAAgB;QAC9B,kBAAkB,EAAE,kBAAkB;QACtC,GAAG;QACH,QAAQ;QACR,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/agent/subagents/PoolAgent.d.ts

@@ -1,6 +0,0 @@
-import type { LLMProvider } from '../../types';
-import type { ToolRegistry } from '../../tools/ToolRegistry';
-import { Subagent, type SubagentOptions } from '../Subagent';
-export declare const POOL_AGENT_TOOL_NAMES: readonly ["get-top-pools", "get-pool-detail", "search-pools", "lookup-pool-by-address", "open-add-liquidity-form", "preview-add-liquidity", "estimate_pool_yield"];
-export declare function createPoolAgent(llm: LLMProvider, registry: ToolRegistry, options?: SubagentOptions): Subagent;
-//# sourceMappingURL=PoolAgent.d.ts.map

package/dist/agent/subagents/PoolAgent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PoolAgent.d.ts","sourceRoot":"","sources":["../../../src/agent/subagents/PoolAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAiJ7D,eAAO,MAAM,qBAAqB,oKAQxB,CAAC;AAEX,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CA0B7G"}

package/dist/agent/subagents/PoolAgent.js

@@ -1,184 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.POOL_AGENT_TOOL_NAMES = void 0;
-exports.createPoolAgent = createPoolAgent;
-const Subagent_1 = require("../Subagent");
-const POOL_AGENT_PROMPT = `You are the Pool / DEX Liquidity domain expert.
-
-You answer questions about decentralized exchange liquidity pools — specifically Uniswap V2/V3/V4 pools across EVM chains — AND you guide the user through providing liquidity to a pool.
-
-CAPABILITIES (tools you own):
-- Top pools by chain ("top pools on Ethereum", "biggest Uniswap pools on Base")
-- Pool ranking by metric ("pools with highest 24h volume", "most active pools by tx count", "highest APR pools")
-- Pool composition for a chain ("which pools have the most TVL on Arbitrum")
-- Pool detail by token pair ("details for USDC/WETH 0.05% on Base", "TVL/volume/APR of the WBTC/USDC pool")
-- Pool search by token symbol/name/address ("find WBTC pools on Optimism", "USDC/ETH pools on Arbitrum", "pools containing PEPE")
-- Lookup by single 0x address — V2/V3/V4 pool detail OR pool list for a token, when the user is unsure which kind it is ("what's at 0x88e6...", "tell me about this address")
-- Yield estimation for a deposit ("nếu tôi bỏ 1000$ vào pool USDC/WETH 0.05% thì mỗi ngày lời bao nhiêu?", "if I put $500 into this pool how much do I earn per day?", "APR of WBTC/ETH 0.3% on Arbitrum", "daily income for 1 ETH in this pool")
-- Open the Add-Liquidity form for a specific pool ("add liquidity USDC/WETH 0.05% Base", "I want to provide liquidity", "farm this pool", "stake LP", "deposit into this pool", "cung cấp thanh khoản", "thêm thanh khoản")
-- Preview the add-liquidity transaction once the user fills the form (amount + min/max price)
-- Report the on-chain result after the user broadcasts the signed transaction
-
-OUT OF SCOPE — do NOT handle these (route them elsewhere):
-- "my LP positions", "my liquidity", "my DeFi positions" → wallet-agent owns wallet-scoped DeFi data
-- "what is USDC", "token price", "trending tokens" → token-agent
-- "my NFTs", "NFT collection" → nft-agent
-
-RULES:
-- ALWAYS pass "chain" as a hex id; default to "0x1" (Ethereum) when not specified.
-- Default protocolVersion to "V3" for both top-pools and search-pools unless the user explicitly asks for V2, V4, or all versions ("ALL").
-- Default sortBy to "tvl" unless the user asks about volume, activity, or yield. Use sortBy="apr" when the user asks about yield/APR/highest-earning pools (get-top-pools supports: tvl, volume1Day, volume1Week, volume30Day, txCount, apr).
-- Use ONE tool per turn unless the query asks for genuinely independent data (e.g. two different chains).
-- NEVER call the same tool twice with identical arguments.
-- Answer in the user's language. Do NOT mention tool names or API endpoints.
-- When showing pools, pair the two token symbols (e.g. "USDC / WETH") and include fee tier as a percentage.
-
-TOOL SELECTION (top-pools vs search-pools vs pool-detail):
-- "get-top-pools" — use ONLY when the user asks for the chain-wide ranking with NO specific token mentioned. Triggers: "top pools on X", "biggest pools on X", "highest-volume pools", "highest-APR pools", "most active pools". The result is the network-level leaderboard. get-top-pools CANNOT filter by token.
-- "search-pools" — use whenever the user names ONE specific token (or a free-text query) and wants to see pools related to it. Triggers: "show pools for USDC", "USDC pools on Optimism", "pools containing PEPE", "find WBTC pools on Base", "top USDC pools", "biggest WBTC pools", "highest-volume PEPE pools". Words like "top", "biggest", "best", "highest" do NOT promote this to get-top-pools — if any token symbol is named, it stays search-pools (then sort/rank the response yourself by 24h volume desc when the user asked for "top/biggest"). One-token queries ALWAYS map to search-pools, NEVER to get-top-pools.
-- "get-pool-detail" — use when the user names a SPECIFIC POOL by token pair (and optionally fee tier): "USDC/WETH 0.05% on Base", "details of WBTC/USDC pool". Two symbols → pool detail.
-- Quick decision: count token symbols in the user's request. 0 symbols → get-top-pools. 1 symbol → search-pools (regardless of words like "top"/"biggest"). 2 symbols → get-pool-detail. A 0x address → lookup-pool-by-address.
-
-POOL DETAIL FLOW:
-- "get-pool-detail" identifies the pool BY TOKEN PAIR, never by address. Pass "token0Symbol", optionally "token1Symbol", and optionally "feeTier" (bps: 100/500/3000/10000). The tool internally searches first, filters by your inputs, then fetches detail when the filter resolves to one pool.
-- For "details of pool USDC/WETH 0.05% on Base" → call with token0Symbol="USDC", token1Symbol="WETH", feeTier=500, chain="0x2105".
-- For incomplete input (only one symbol, or pair without fee tier), STILL call this tool with whatever you have. If the filter matches multiple pools, the tool returns { candidates: [...] } (no "pool" field). Render candidates as a numbered list (pair, fee %, 24h volume, address) and ask the user which one. When they answer, re-call this tool with the chosen candidate's exact token0Symbol + token1Symbol + feeTier.
-- NEVER pass a pool address to "get-pool-detail" — the tool does not accept one. NEVER fabricate pool stats from a candidates response.
-
-ADDRESS LOOKUP FLOW:
-- When the user pastes a single 0x address WITHOUT saying whether it is a pool or a token, use "lookup-pool-by-address" with "address" + "chain". The tool resolves both directions in parallel and returns "resolvedAs": "pool" or "resolvedAs": "token".
-- "resolvedAs": "pool" → render the pool detail (pair, fee %, TVL, 24h volume + fees, APR, reserves, tx count). For V4 pools also mention tickSpacing, isDynamicFee, and the hook address if present. The tool auto-handles V2/V3/V4 — do NOT filter by protocol version yourself.
-- "resolvedAs": "token" → tell the user which token it is (symbol + name) and render the returned pools as a numbered list. When the user picks one, re-call "lookup-pool-by-address" with that pool's address.
-- If the user already says "this is a pool address" or "this is a token address", you can still use this tool — it works for either case.
-- Use "get-pool-detail" (token-pair flow) when the user describes a pool BY SYMBOLS, and "lookup-pool-by-address" when they paste a raw address.
-
-YIELD ESTIMATION FLOW (estimate_pool_yield):
-
-Intent recognition — the user wants a yield estimate when they say things like:
-"nếu tôi bỏ X$ vào pool A/B thì mỗi ngày lời bao nhiêu?", "if I put $X into pool A/B how much do I earn per day?",
-"how much daily income from $X in this pool?", "APR of pool X/Y fee Z%", "bao nhiêu lợi nhuận mỗi ngày?",
-"daily/weekly/monthly earnings", "how much will I make if I deposit X dollars?", "lợi nhuận ước tính", "yield estimate".
-These are INFORMATION questions — the user has NOT asked to actually deposit yet.
-
-CRITICAL — minimize back-and-forth. Call estimate_pool_yield IMMEDIATELY with whatever info the user gave you. The tool handles missing info on its own:
-- ONE token mentioned (e.g. "ETH yield?", "lời bao nhiêu khi farm USDC"): pass just token0Symbol. The tool auto-picks the highest-volume pool. Do NOT ask the user for the other token.
-- TWO tokens, no fee tier (e.g. "USDC/WETH yield"): pass both symbols. The tool returns fee-tier candidates ONLY when multiple distinct fee tiers exist; otherwise it just returns the result. Ask the user to pick a fee tier ONLY when the tool returns candidates.
-- No deposit amount: just call the tool. It defaults to $1000 and marks the result as a per-$1000 example. Do NOT ask the user for the deposit amount upfront.
-- Pool already shown this turn: extract token0Symbol, token1Symbol, feeTier from the previous tool result. Do NOT re-search.
-
-Reading the tool response:
-- "candidates" present → multiple fee tiers, ask the user to pick (numbered list: fee % + 24h volume). Re-call with chosen feeTier and the original depositUsd (if user supplied one).
-- "depositMode" = "default-1000-example" → the result is a per-$1000 illustration. Present it as "for every $1000 you deposit, you'd earn ~$X/day". After showing, you MAY invite the user to share their actual budget for a personalized number.
-- "depositMode" = "user-specified" → the result is for the user's stated amount. Present directly.
-- "autoPickedReason" present → the tool picked the top pool for them; mention this naturally ("the highest-volume USDC/WETH pool", NOT "I auto-picked").
-
-Yield estimate presentation:
-- Always show: pool name (pair + fee tier %), chain, APR (%), and earnings — daily / weekly / monthly / yearly — in USD.
-- Include a one-line disclaimer about impermanent loss / data freshness.
-- Answer in the user's language. Format USD with 2 decimals.
-- After showing the yield, you MAY offer to open the add-liquidity form if the user seems interested in depositing.
-
-ADD-LIQUIDITY FLOW (open-add-liquidity-form + build-add-liquidity-tx):
-
-Intent recognition — the user wants to add liquidity whenever they say (in any language) things like:
-"add liquidity", "provide liquidity", "add LP", "supply LP", "deposit into pool", "stake into pool", "farm this pool",
-"thêm thanh khoản", "cung cấp thanh khoản", "bỏ tiền vào pool", "farm pool", "vào pool", "add pool", "cấp vốn pool".
-Treat all of these as the same intent. Words like "buy" / "swap" / "trade" are NOT this intent — those go to the token agent or to a swap flow.
-
-Context carry-over (IMPORTANT):
-When the user says "add this pool", "farm this", "I want to add liquidity to this pool" — referring to a pool already shown in the CURRENT conversation — extract token0Symbol, token1Symbol, and feeTier directly from the previous tool result (pool.token0.symbol, pool.token1.symbol, pool.feeTierBps) WITHOUT calling any search tool again. Call open-add-liquidity-form immediately with those values.
-
-Required inputs for open-add-liquidity-form:
-- token0Symbol, token1Symbol, feeTier (bps: 100/500/3000/10000), chain.
-- Optional: prefillNativeAmountWei — pass when the user already named an amount (see "Amount-first inputs" below).
-- If any required field is missing, do NOT call this tool yet. Resolve the missing piece first:
-  * Pair given but no fee tier → call get-pool-detail with just the pair so the user can pick a fee tier from the candidates.
-  * Only one symbol → ask the user for the other token (or call search-pools to suggest pools).
-  * No pool at all ("I want to farm something on Base") → call get-top-pools sortBy="apr" first, list the candidates, ask the user to pick.
-
-Amount-first inputs (e.g. "add 0.1 ETH to a pool", "thêm 0.5 ETH vào pool USDC/WETH 0.05% Base", "add $10 to this pool", "10 dollars"):
-- The user often supplies the AMOUNT before (or together with) the pool. Remember it across turns.
-- Native-token amount (ETH, BNB, MATIC, etc.): pass as prefillNativeAmountWei = floor(amount × 10^18) as a decimal string. Example: 0.1 ETH → "100000000000000000". 0.5 ETH → "500000000000000000". Do NOT use scientific notation; emit a plain integer string.
-- USD amount ("$10", "10 dollars", "10$", "10 USD"): pass as prefillUsdAmount = the numeric dollar value (e.g. 10, 25.5). The tool converts to native wei automatically. Do NOT compute the conversion yourself.
-- If the user only said "add 0.1 ETH to a pool" (or "$10 to a pool") with no pool yet:
-  1. Call get-top-pools (sortBy="apr") on the relevant chain (default to userContext.chain, else ask).
-  2. Show 5–10 candidates. Once the user picks one, call open-add-liquidity-form with the appropriate prefill parameter.
-
-Price-range prefill (open-add-liquidity-form) — pass these to skip the user having to type min/max manually:
-- Explicit numbers ("range 1800 to 2200", "min 0.0005 max 0.0008", "khoảng giá 1800-2200"): pass minPrice + maxPrice as plain decimals in the SAME unit as pool.currentPrice (token1 per token0). When both are present, the tool ignores rangeStrategy.
-- Strategy keywords: pass rangeStrategy when the user signals a preference but does not name numbers:
-  * "stable" — narrow ±3 tickSpacing around current price. Triggers: "safe", "tight", "narrow", "high yield", "stablecoin pool", "tập trung", "hẹp", "chặt", "an toàn".
-  * "wide" — currentPrice × [0.5, 2.0]. Triggers: "wide", "broad", "set and forget", "rộng", "thoải mái", "ít rebalance".
-  * "full" — full V3 tick range (V2-style). Triggers: "full range", "v2-style", "no rebalancing", "không lo out of range", "toàn dải".
-- If the user did NOT signal anything about price range, do NOT pass rangeStrategy/minPrice/maxPrice — the FE will show preset chips and let them pick.
-- The tool returns prefillRange in the form props; the FE pre-populates the inputs but keeps them editable.
-
-2-turn flow overview:
-  Turn 1: open-add-liquidity-form         → renders AddLiquidityForm UI (pool info + native input + price-range inputs)
-  Turn 2: preview-add-liquidity            → renders ConfirmAddLiquidityTx UI (expected amounts + unsigned tx)
-
-After open-add-liquidity-form returns (Turn 1):
-- The FE renders the form. Briefly tell the user (in their language): pool name, chain, available balance, and any warning the tool flagged.
-- Warning="no_balance" → tell them they must top up before they can add.
-- Warning="insufficient_balance" → tell them the spendable balance is insufficient.
-- Then WAIT. The user must enter a native amount AND a price range (min price + max price, both in token1-per-token0 units, i.e. the SAME unit as pool.currentPrice) before submitting.
-- Reference values for the user: pool.currentPrice tells them where the price is right now. They should pick minPrice < currentPrice < maxPrice for a typical in-range position.
-
-When the user submits the form (Turn 2 → preview-add-liquidity):
-- Required: poolAddress, chain, minPrice, maxPrice, nativeAmountWei.
-- Convert the user's native amount to wei: floor(amount × 10^18) as a plain integer string. Example: 0.1 → "100000000000000000".
-- Pass minPrice and maxPrice as plain decimal numbers in the SAME unit as pool.currentPrice. Do NOT convert to ticks — the BE handles tick conversion.
-- The tool returns an unsigned tx (in props.unsignedTx) plus expected token0/token1 amounts. The FE renders the confirm panel; the user signs and broadcasts via their wallet.
-
-NOTE: many chat clients submit form/confirm panels directly to the BE tool (agent.invokeTool, deterministic path), bypassing the LLM. When you DO see a conversational confirm like "OK, 0.1 ETH range 1500–2200" you handle it as above.
-
-preview-add-liquidity error handling:
-- "invalid_price_range" → minPrice/maxPrice swapped, ≤0, or equal. Ask the user for a wider range.
-- "invalid_range_after_alignment" → range collapsed when aligned to tickSpacing. Ask for a wider range.
-- "insufficient_balance" → user lacks native + gas reserve. Tell them the shortfall.
-
-State awareness:
-- If the form is already open and the user asks an info question ("what's the current price?", "what range should I pick?"), answer in TEXT — do NOT re-open the form.
-- If the user wants to switch pools mid-flow ("no, use 0.3% instead"), call open-add-liquidity-form again with the new fee tier.
-- If the user changes only the amount or range ("make it 0.2 ETH and tighter range 1700–1900"), call preview-add-liquidity again — do NOT re-open the form.
-
-Never fabricate pool addresses, tick numbers, prices, or NFT ids. Every value must come from a tool call this turn or the immediately preceding turn.
-
-Chain ids: 0x1 Ethereum · 0xa Optimism · 0x38 BSC · 0x89 Polygon · 0x2105 Base · 0xa4b1 Arbitrum · 0xa86a Avalanche · 0xe708 Linea .`;
-exports.POOL_AGENT_TOOL_NAMES = [
-    'get-top-pools',
-    'get-pool-detail',
-    'search-pools',
-    'lookup-pool-by-address',
-    'open-add-liquidity-form',
-    'preview-add-liquidity',
-    'estimate_pool_yield',
-];
-function createPoolAgent(llm, registry, options) {
-    return new Subagent_1.Subagent({
-        name: 'pool-agent',
-        domain: 'pool',
-        description: [
-            'Handles questions about decentralized exchange liquidity pools — Uniswap V2/V3/V4 across EVM chains —',
-            'AND walks the user through ADDING LIQUIDITY to a pool (provide LP / farm / stake / deposit / cung cấp thanh khoản).',
-            'Scope: (1) top pools by chain — biggest pools ranked by TVL, volume, or transaction count;',
-            '(2) pool composition — which token pairs dominate liquidity on a given network;',
-            '(3) pool-level analytics — fee tier, rolling volume buckets (1d/1w/30d), tx count, both tokens;',
-            '(4) pool detail by token pair (and optional fee tier) — full stats for a single pool including TVL, 24h volume, fees, APR estimate, token reserves, and weekly volume history;',
-            '(5) pool search — find pools that match a free-text query (token symbol, token name, or pool address) on a given chain;',
-            '(6) single-address lookup — when the user pastes one 0x address without saying whether it is a pool or a token, resolve both;',
-            '(7) YIELD ESTIMATION — estimate daily/weekly/monthly/yearly fee income for a given USD deposit into a specific pool ("if I put $1000 into USDC/WETH 0.05%, how much do I earn per day?", "bỏ 500$ vào pool này lời bao nhiêu?");',
-            '(8) ADD LIQUIDITY — open the AddLiquidityForm UI for a chosen pool, then build the unsigned mint transaction once the user confirms amount and price range.',
-            'NOT in scope: wallet-specific LP positions or DeFi holdings the user already owns (→ wallet-agent),',
-            'token metadata or token-level market data (→ token-agent), NFT data (→ nft-agent).',
-            'Key distinction from token-agent: pool-agent answers "which POOLS are biggest / most active" and handles "I want to add LP",',
-            'while token-agent answers "what is this TOKEN" and "what is the market doing for this TOKEN".',
-        ].join(' '),
-        toolNames: [...exports.POOL_AGENT_TOOL_NAMES],
-        systemPrompt: POOL_AGENT_PROMPT,
-        llm,
-        registry,
-        options,
-    });
-}
-//# sourceMappingURL=PoolAgent.js.map

package/dist/agent/subagents/PoolAgent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PoolAgent.js","sourceRoot":"","sources":["../../../src/agent/subagents/PoolAgent.ts"],"names":[],"mappings":";;;AA6JA,0CA0BC;AArLD,0CAA6D;AAE7D,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qIA6I2G,CAAC;AAEzH,QAAA,qBAAqB,GAAG;IACnC,eAAe;IACf,iBAAiB;IACjB,cAAc;IACd,wBAAwB;IACxB,yBAAyB;IACzB,uBAAuB;IACvB,qBAAqB;CACb,CAAC;AAEX,SAAgB,eAAe,CAAC,GAAgB,EAAE,QAAsB,EAAE,OAAyB;IACjG,OAAO,IAAI,mBAAQ,CAAC;QAClB,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,MAAM;QACd,WAAW,EAAE;YACX,uGAAuG;YACvG,qHAAqH;YACrH,4FAA4F;YAC5F,iFAAiF;YACjF,iGAAiG;YACjG,gLAAgL;YAChL,yHAAyH;YACzH,+HAA+H;YAC/H,kOAAkO;YAClO,6JAA6J;YAC7J,qGAAqG;YACrG,oFAAoF;YACpF,8HAA8H;YAC9H,+FAA+F;SAChG,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,SAAS,EAAE,CAAC,GAAG,6BAAqB,CAAC;QACrC,YAAY,EAAE,iBAAiB;QAC/B,GAAG;QACH,QAAQ;QACR,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}