@zhin.js/agent 0.3.1 → 1.0.2

package/lib/tool/context-tools.js

@@ -0,0 +1,107 @@
+function formatTranscriptHitLine(hit) {
+    const role = hit.direction === 'inbound' ? '用户' : '助手';
+    const time = new Date(hit.time).toLocaleString('zh-CN');
+    const who = hit.senderName && hit.direction === 'inbound' ? ` (${hit.senderName})` : '';
+    return `[${time}] ${role}${who}: ${hit.body}`;
+}
+function formatTranscriptToolResult(result, header) {
+    let output = header;
+    if (result.messages.length > 0) {
+        output += `\n\n💬 聊天记录：\n${result.messages.map(formatTranscriptHitLine).join('\n')}`;
+    }
+    else {
+        output += '\n\n未找到相关聊天记录。';
+    }
+    return output;
+}
+export function createImTranscriptHistoryTool(store, query) {
+    return {
+        name: 'chat_history',
+        source: 'builtin:context',
+        description: '从 im_transcripts 按需查询本场景历史聊天（platform+bot+群/私聊）。支持关键词模糊搜索 body；keyword 留空则返回最近若干条。当用户问「之前聊过什么」「我们讨论过什么」时使用。',
+        parameters: {
+            type: 'object',
+            properties: {
+                keyword: {
+                    type: 'string',
+                    description: '搜索关键词（匹配消息正文）。留空则返回最近记录',
+                },
+                limit: {
+                    type: 'number',
+                    description: '最多返回条数（默认 10，最大 100）',
+                },
+            },
+        },
+        tags: ['memory', 'history', '聊天记录', '回忆', '之前'],
+        keywords: ['之前', '历史', '聊过', '讨论过', '记得', '上次', '以前', '回忆'],
+        async execute(args) {
+            const keyword = typeof args.keyword === 'string' ? args.keyword : '';
+            const limit = typeof args.limit === 'number' && Number.isFinite(args.limit)
+                ? Math.floor(args.limit)
+                : 10;
+            if (keyword.trim()) {
+                const result = await store.search(query, keyword, limit);
+                return formatTranscriptToolResult(result, `关键词「${keyword.trim()}」的搜索结果（最多 ${limit} 条）：`);
+            }
+            const result = await store.listRecent(query, limit);
+            return formatTranscriptToolResult(result, `最近 ${limit} 条聊天记录：`);
+        },
+    };
+}
+export function createUserProfileTool(userId, profiles) {
+    return {
+        name: 'user_profile',
+        source: 'builtin:context',
+        description: '读取或保存用户的个人偏好和信息。当用户告诉你他的名字、偏好、兴趣、习惯等个人信息时，用 set 操作保存。当需要了解用户偏好时，用 get 操作读取。',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    description: '操作类型: get（读取所有偏好）, set（保存偏好）, delete（删除偏好）',
+                    enum: ['get', 'set', 'delete'],
+                },
+                key: {
+                    type: 'string',
+                    description: '偏好名称，如: name, style, interests, timezone, language 等',
+                },
+                value: {
+                    type: 'string',
+                    description: '偏好值（仅 set 操作需要）。language / preferred_language 会影响回复与 web_search 的 Bing 市场语言。',
+                },
+            },
+            required: ['action'],
+        },
+        tags: ['profile', '偏好', '用户', '个性化', '记住'],
+        keywords: ['我叫', '我的名字', '记住我', '我喜欢', '我偏好', '我习惯', '叫我', '我是'],
+        async execute(args) {
+            const action = typeof args.action === 'string' ? args.action : '';
+            const key = typeof args.key === 'string' ? args.key : '';
+            const value = typeof args.value === 'string' ? args.value : '';
+            switch (action) {
+                case 'get': {
+                    const all = await profiles.getAll(userId);
+                    const entries = Object.entries(all);
+                    if (entries.length === 0)
+                        return '暂无保存的用户偏好。';
+                    return '用户偏好：\n' + entries.map(([k, v]) => `  ${k}: ${v}`).join('\n');
+                }
+                case 'set': {
+                    if (!key || !value)
+                        return '需要提供 key 和 value';
+                    await profiles.set(userId, key, value);
+                    return `已保存: ${key} = ${value}`;
+                }
+                case 'delete': {
+                    if (!key)
+                        return '需要提供 key';
+                    const deleted = await profiles.delete(userId, key);
+                    return deleted ? `已删除: ${key}` : `未找到偏好: ${key}`;
+                }
+                default:
+                    return '不支持的操作，请使用 get/set/delete';
+            }
+        },
+    };
+}
+//# sourceMappingURL=context-tools.js.map

package/lib/tool/context-tools.js.map

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

package/lib/tool/contracts.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tool System — 模块契约（与实现同步）。
+ *
+ * 实现：`ToolSystem.collectForTurn` 同步收集 `AgentTool[]`（`ToolSource.collectTools` 亦为同步）；
+ * 每 turn 通过 `createDefaultToolSources` 独立 Source 列表，避免并发 mutate。
+ */
+import type { AgentTool } from '@zhin.js/ai';
+import type { Message } from '@zhin.js/core';
+export interface TurnContext {
+    message: Message;
+}
+export interface FilterContext {
+    message: Message;
+}
+export interface ToolSource {
+    name: string;
+    priority: number;
+    collectTools(context: TurnContext): AgentTool[];
+}
+export interface ToolFilter {
+    name: string;
+    filter(tools: AgentTool[], context: FilterContext): AgentTool[];
+}
+export interface ToolSystemConfig {
+}
+//# sourceMappingURL=contracts.d.ts.map

package/lib/tool/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/tool/contracts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE,CAAC;CACjE;AAED,MAAM,WAAW,gBAAgB;CAEhC"}

package/lib/tool/contracts.js

@@ -0,0 +1,8 @@
+/**
+ * Tool System — 模块契约（与实现同步）。
+ *
+ * 实现：`ToolSystem.collectForTurn` 同步收集 `AgentTool[]`（`ToolSource.collectTools` 亦为同步）；
+ * 每 turn 通过 `createDefaultToolSources` 独立 Source 列表，避免并发 mutate。
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/lib/tool/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/tool/contracts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/tool/deferred-resolution.d.ts

@@ -0,0 +1,14 @@
+import { type AgentTool, type LlmTool, type DeferredToolSessionSnapshot } from '@zhin.js/ai';
+import type { ToolCatalogItem } from '../tool-catalog/types.js';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+export interface ResolvedToolsForTurn {
+    tools: AgentTool[];
+    catalog: ToolCatalogItem[];
+    deferred: true;
+    deferredStats?: string;
+    sessionSnapshot: DeferredToolSessionSnapshot;
+}
+export declare function resolveAgentToolsForTurn(agent: ZhinAgentPrivate, allTools: AgentTool[], sessionId: string): Promise<ResolvedToolsForTurn>;
+export declare function persistDeferredToolSnapshot(agent: ZhinAgentPrivate, sessionId: string, snapshot: DeferredToolSessionSnapshot): Promise<void>;
+export declare function buildLlmToolsForProvider(sdk: string | undefined, catalog: ToolCatalogItem[], apiTools: AgentTool[], alwaysLoaded: Set<string>, sessionLoadedNames: string[]): LlmTool[];
+//# sourceMappingURL=deferred-resolution.d.ts.map

package/lib/tool/deferred-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-resolution.d.ts","sourceRoot":"","sources":["../../src/tool/deferred-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAA4E,KAAK,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAOvK,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,IAAI,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,2BAA2B,CAAC;CAC9C;AAmBD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,SAAS,EAAE,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC,CA2C/B;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,2BAA2B,GACpC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,OAAO,EAAE,eAAe,EAAE,EAC1B,QAAQ,EAAE,SAAS,EAAE,EACrB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,kBAAkB,EAAE,MAAM,EAAE,GAC3B,OAAO,EAAE,CAWX"}

package/lib/tool/deferred-resolution.js

@@ -0,0 +1,72 @@
+import { getLoadedToolNamesFromSnapshot, addSkillToSnapshot, touchToolsInSnapshot } from '@zhin.js/ai';
+import { agentToolToLlmTool } from '../tool-bridge.js';
+import { buildDeferredStats, buildToolCatalog, resolveDeferredApiTools, } from '../tool-catalog/tool-catalog.js';
+import { resolveDeferredToolsConfig } from '../tool-catalog/resolve-config.js';
+function buildMcpServerMap(tools) {
+    const map = new Map();
+    for (const tool of tools) {
+        const src = tool.source ?? '';
+        const mcpMatch = /^mcp:([^:]+)/.exec(src);
+        if (mcpMatch) {
+            map.set(tool.name, mcpMatch[1]);
+            continue;
+        }
+        const prefixMatch = /^mcp_([^_]+)_/.exec(tool.name);
+        if (prefixMatch) {
+            map.set(tool.name, prefixMatch[1]);
+        }
+    }
+    return map;
+}
+export async function resolveAgentToolsForTurn(agent, allTools, sessionId) {
+    const deferredCfg = resolveDeferredToolsConfig(agent.config);
+    const alwaysLoaded = new Set(deferredCfg.alwaysLoadedTools);
+    const mcpServerByTool = buildMcpServerMap(allTools);
+    const catalog = buildToolCatalog({
+        tools: allTools,
+        mcpServerByTool,
+        alwaysLoaded,
+    });
+    let sessionSnapshot = await agent.contextRepository.getDeferredToolSnapshot(sessionId);
+    let touched = false;
+    const alwaysSkills = agent.skillSystem?.getAlwaysSkills()
+        ?? agent.skillRegistry?.getAlwaysSkills?.()
+        ?? [];
+    if (alwaysSkills.length > 0) {
+        for (const skill of alwaysSkills) {
+            sessionSnapshot = addSkillToSnapshot(sessionSnapshot, skill.name);
+            sessionSnapshot = touchToolsInSnapshot(sessionSnapshot, skill.tools.map(t => t.name), deferredCfg.maxLoadedPerSession);
+            touched = true;
+        }
+    }
+    if (touched) {
+        await persistDeferredToolSnapshot(agent, sessionId, sessionSnapshot);
+    }
+    const sessionLoaded = getLoadedToolNamesFromSnapshot(sessionSnapshot);
+    const apiTools = resolveDeferredApiTools(catalog, alwaysLoaded, sessionLoaded);
+    const deferredStats = buildDeferredStats(catalog, apiTools);
+    agent.deferredCatalog = catalog.map(c => c.fullTool);
+    return {
+        tools: apiTools,
+        catalog,
+        deferred: true,
+        deferredStats,
+        sessionSnapshot,
+    };
+}
+export async function persistDeferredToolSnapshot(agent, sessionId, snapshot) {
+    await agent.contextRepository.setDeferredToolSnapshot(sessionId, snapshot);
+}
+export function buildLlmToolsForProvider(sdk, catalog, apiTools, alwaysLoaded, sessionLoadedNames) {
+    const loaded = new Set([...alwaysLoaded, ...sessionLoadedNames]);
+    if (sdk === 'anthropic') {
+        return catalog
+            .filter(item => item.source !== 'meta')
+            .map(item => ({
+            ...agentToolToLlmTool(item.fullTool),
+            deferLoading: !loaded.has(item.name),
+        }));
+    }
+    return apiTools.map(t => agentToolToLlmTool(t));
+}
+//# sourceMappingURL=deferred-resolution.js.map

package/lib/tool/deferred-resolution.js.map

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

package/lib/tool/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tool System — ToolSystem + Source + 运行时/延迟解析（契约见 contracts.ts）。
+ */
+export type { ToolSource, ToolFilter, ToolSystemConfig, TurnContext, FilterContext, } from './contracts.js';
+export type { ResolvedToolsForTurn } from './deferred-resolution.js';
+export type { CollectToolsContext, CollectToolsForTurnInput } from './tool-system.js';
+export type { CollectRuntimeToolsOptions, ToolRunPlan } from './runtime.js';
+export { ToolSystem, defaultToolSystem, createToolSystem, createDefaultToolSources, planToolRun, buildPreExecFastPathPrompt, } from './tool-system.js';
+export { ExternalToolSource, SkillToolSource, RegisteredToolSource, BuiltinToolSource, McpToolSource, DedupeToolFilter, } from './sources.js';
+export { resolveAgentToolsForTurn, persistDeferredToolSnapshot, buildLlmToolsForProvider, } from './deferred-resolution.js';
+export { collectRuntimeTools } from './runtime.js';
+export { prepareTurnTools } from './prepare-turn-tools.js';
+export type { TurnToolsPrep } from './prepare-turn-tools.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/tool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACtF,YAAY,EAAE,0BAA0B,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,EACX,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/lib/tool/index.js

@@ -0,0 +1,9 @@
+/**
+ * Tool System — ToolSystem + Source + 运行时/延迟解析（契约见 contracts.ts）。
+ */
+export { ToolSystem, defaultToolSystem, createToolSystem, createDefaultToolSources, planToolRun, buildPreExecFastPathPrompt, } from './tool-system.js';
+export { ExternalToolSource, SkillToolSource, RegisteredToolSource, BuiltinToolSource, McpToolSource, DedupeToolFilter, } from './sources.js';
+export { resolveAgentToolsForTurn, persistDeferredToolSnapshot, buildLlmToolsForProvider, } from './deferred-resolution.js';
+export { collectRuntimeTools } from './runtime.js';
+export { prepareTurnTools } from './prepare-turn-tools.js';
+//# sourceMappingURL=index.js.map

package/lib/tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,EACX,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/lib/tool/pre-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-exec.d.ts","sourceRoot":"","sources":["../../src/tool/pre-exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,SAAS,EAAE,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CA4B3B"}

package/lib/tool/pre-exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-exec.js","sourceRoot":"","sources":["../../src/tool/pre-exec.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAkB,EAClB,SAAiB;IAEjB,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChB,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAC5B,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;SACrD,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC,CAAC,CACH,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;YAAE,SAAS;QACvC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7F,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACnB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,qBAAqB,CAAC,CAAC,MAAM,eAAe,CAAC;QACrE,CAAC;QACD,IAAI,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}

package/lib/tool/prepare-turn-tools.d.ts

@@ -0,0 +1,22 @@
+import type { AgentTool } from '@zhin.js/ai';
+import type { Message } from '@zhin.js/core';
+import type { ZhinAgentPrivate, Tool } from '../internal/agent-host.js';
+import type { ResolvedToolsForTurn } from '../tool/deferred-resolution.js';
+export interface TurnToolsPrep {
+    contextForTools: Message;
+    allTools: AgentTool[];
+    resolved: ResolvedToolsForTurn;
+    resolvedTools: AgentTool[];
+    deferredStats?: string;
+    catalog: ResolvedToolsForTurn['catalog'];
+    sessionSnapshot: ResolvedToolsForTurn['sessionSnapshot'];
+}
+export declare function prepareTurnTools(host: ZhinAgentPrivate, opts: {
+    content: string;
+    commMessage: Message;
+    externalTools: Tool[];
+    sessionId: string;
+    userId: string;
+    mcpServerNames: string[];
+}): Promise<TurnToolsPrep>;
+//# sourceMappingURL=prepare-turn-tools.d.ts.map

package/lib/tool/prepare-turn-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-turn-tools.d.ts","sourceRoot":"","sources":["../../src/tool/prepare-turn-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAS7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAO3E,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzC,eAAe,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;CAC1D;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,GACA,OAAO,CAAC,aAAa,CAAC,CAiExB"}

package/lib/tool/prepare-turn-tools.js

@@ -0,0 +1,73 @@
+import { ensureMcpConnectionsForBinding, getMcpToolsForBinding, } from '../orchestrator/mcp-lifecycle.js';
+import { preloadScheduleToolsFromContext } from '../assistant/schedule-tool-runtime.js';
+import { rehydrateTurnActiveSkills } from '../assistant/schedule-skills.js';
+import { captureDeferredSnapshotBefore, cloneDeferredSnapshot } from '../internal/turn-context.js';
+import { attachWebSearchLocale } from './web-search-locale-attach.js';
+import { defaultToolSystem } from '../tool/tool-system.js';
+function listSpawnableAgentNames(host) {
+    const presets = host.orchestrator?.subagents.getAllPresets().map((p) => p.name) ?? [];
+    return [...new Set(presets.filter(Boolean))].sort();
+}
+export async function prepareTurnTools(host, opts) {
+    const userId = opts.userId;
+    const contextForTools = await attachWebSearchLocale(opts.commMessage, userId, host.userProfiles);
+    if (host.orchestrator && opts.mcpServerNames.length > 0) {
+        await ensureMcpConnectionsForBinding(host.orchestrator.mcps, opts.mcpServerNames, (event) => {
+            const payload = host.emitter.createPayload(opts.sessionId, contextForTools, 'text', {
+                path: 'agent',
+                serverName: event.serverName,
+                loadedToolNames: event.toolNames,
+                reason: event.connected === false ? 'disconnected' : undefined,
+                error: event.error,
+            });
+            if (event.phase === 'start') {
+                host.emitter.emit('ai.mcp.connect.start', payload);
+            }
+            else if (event.phase === 'finish') {
+                host.emitter.emit('ai.mcp.connect.finish', payload);
+            }
+            else {
+                host.emitter.emit('ai.mcp.connect.error', payload);
+            }
+        });
+    }
+    const mcpTools = host.orchestrator && opts.mcpServerNames.length > 0
+        ? getMcpToolsForBinding(host.orchestrator.mcps, opts.mcpServerNames)
+        : [];
+    const toolSystem = host.toolSystem ?? defaultToolSystem;
+    const allTools = toolSystem.collectForTurn({
+        host,
+        message: contextForTools,
+        content: opts.content,
+        sessionId: opts.sessionId,
+        userId,
+        config: host.config,
+        skillRegistry: host.skillRegistry,
+        externalTools: opts.externalTools,
+        externalRegistered: host.externalTools,
+        imTranscriptStore: host.imTranscriptStore,
+        userProfiles: host.userProfiles,
+        mcpTools,
+        spawnableAgentNames: host.subagentSystem ? listSpawnableAgentNames(host) : undefined,
+    });
+    const resolved = await toolSystem.resolveForTurn(host, allTools, opts.sessionId);
+    const { tools: resolvedTools, deferredStats, catalog, sessionSnapshot: initialSnapshot } = resolved;
+    let sessionSnapshot = initialSnapshot;
+    sessionSnapshot = await preloadScheduleToolsFromContext(host, opts.sessionId, catalog, sessionSnapshot);
+    captureDeferredSnapshotBefore(sessionSnapshot);
+    host.lastDeferredSnapshotBefore = cloneDeferredSnapshot(sessionSnapshot);
+    await rehydrateTurnActiveSkills(host, opts.sessionId, host.getAlwaysSkillsBaseline());
+    host.lastDeferredSessionSnapshot = sessionSnapshot;
+    host.lastDeferredCatalog = catalog;
+    host.lastToolSearchDeferredStats = deferredStats;
+    return {
+        contextForTools,
+        allTools,
+        resolved,
+        resolvedTools,
+        deferredStats,
+        catalog,
+        sessionSnapshot,
+    };
+}
+//# sourceMappingURL=prepare-turn-tools.js.map

package/lib/tool/prepare-turn-tools.js.map

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

package/lib/tool/runtime.d.ts

@@ -0,0 +1,24 @@
+import type { AgentTool, ImTranscriptStore, MemoryImTranscriptStore } from '@zhin.js/ai';
+import type { Tool, Message } from '../orchestrator/types.js';
+import type { SkillRegistry } from '../orchestrator/skill-registry.js';
+import type { ZhinAgentConfig } from '../config/zhin-agent-config.js';
+import type { UserProfileStore } from '../user-profile.js';
+import { type ToolRunPlan, type ToolSystem } from './tool-system.js';
+export interface CollectRuntimeToolsOptions {
+    content: string;
+    commMessage: Message;
+    externalTools: Tool[];
+    config: Required<ZhinAgentConfig>;
+    skillRegistry: SkillRegistry | null;
+    externalRegistered: Map<string, AgentTool>;
+    sessionId: string;
+    userId: string;
+    imTranscriptStore: ImTranscriptStore | MemoryImTranscriptStore;
+    userProfiles: UserProfileStore;
+    mcpTools?: AgentTool[];
+    toolSystem?: ToolSystem;
+}
+export declare function collectRuntimeTools(options: CollectRuntimeToolsOptions): AgentTool[];
+export type { ToolRunPlan };
+export { planToolRun, buildPreExecFastPathPrompt } from './tool-system.js';
+//# sourceMappingURL=runtime.d.ts.map

package/lib/tool/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/tool/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAC1B,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAClC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC/D,YAAY,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,SAAS,EAAE,CAgBpF;AAED,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/tool/runtime.js

@@ -0,0 +1,20 @@
+import { createDefaultToolSources, defaultToolSystem, } from './tool-system.js';
+export function collectRuntimeTools(options) {
+    const toolSystem = options.toolSystem ?? defaultToolSystem;
+    const ctx = {
+        message: options.commMessage,
+        content: options.content,
+        sessionId: options.sessionId,
+        userId: options.userId,
+        config: options.config,
+        skillRegistry: options.skillRegistry,
+        externalTools: options.externalTools,
+        externalRegistered: options.externalRegistered,
+        imTranscriptStore: options.imTranscriptStore,
+        userProfiles: options.userProfiles,
+        mcpTools: options.mcpTools,
+    };
+    return toolSystem.collectTools(ctx, createDefaultToolSources(ctx));
+}
+export { planToolRun, buildPreExecFastPathPrompt } from './tool-system.js';
+//# sourceMappingURL=runtime.js.map

package/lib/tool/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/tool/runtime.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAIlB,MAAM,kBAAkB,CAAC;AAgB1B,MAAM,UAAU,mBAAmB,CAAC,OAAmC;IACrE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAC3D,MAAM,GAAG,GAAwB;QAC/B,OAAO,EAAE,OAAO,CAAC,WAAW;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;IACF,OAAO,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAGD,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/tool/sources.d.ts

@@ -0,0 +1,59 @@
+import { type AgentTool, type ImTranscriptStore, type MemoryImTranscriptStore } from '@zhin.js/ai';
+import type { Tool, Message } from '../orchestrator/types.js';
+import type { SkillRegistry } from '../orchestrator/skill-registry.js';
+import type { ZhinAgentConfig } from '../config/zhin-agent-config.js';
+import type { UserProfileStore } from '../user-profile.js';
+import type { ToolFilter, ToolSource } from './contracts.js';
+export interface CollectToolsContext {
+    message: Message;
+    content: string;
+    sessionId: string;
+    userId: string;
+    config: Required<ZhinAgentConfig>;
+    skillRegistry: SkillRegistry | null;
+    externalTools: Tool[];
+    externalRegistered: Map<string, AgentTool>;
+    imTranscriptStore: ImTranscriptStore | MemoryImTranscriptStore;
+    userProfiles: UserProfileStore;
+    mcpTools?: AgentTool[];
+}
+export declare class ExternalToolSource implements ToolSource {
+    private readonly externalTools;
+    name: string;
+    priority: number;
+    constructor(externalTools: Tool[]);
+    collectTools(context: CollectToolsContext): AgentTool[];
+}
+export declare class SkillToolSource implements ToolSource {
+    private readonly skillRegistry;
+    name: string;
+    priority: number;
+    constructor(skillRegistry: SkillRegistry | null);
+    collectTools(context: CollectToolsContext): AgentTool[];
+}
+export declare class RegisteredToolSource implements ToolSource {
+    private readonly externalRegistered;
+    name: string;
+    priority: number;
+    constructor(externalRegistered: Map<string, AgentTool>);
+    collectTools(_context: CollectToolsContext): AgentTool[];
+}
+export declare class BuiltinToolSource implements ToolSource {
+    name: string;
+    priority: number;
+    collectTools(context: CollectToolsContext): AgentTool[];
+}
+export declare class McpToolSource implements ToolSource {
+    name: string;
+    priority: number;
+    collectTools(context: CollectToolsContext): AgentTool[];
+}
+export declare class PermissionToolFilter implements ToolFilter {
+    name: string;
+    filter(tools: AgentTool[]): AgentTool[];
+}
+export declare class DedupeToolFilter implements ToolFilter {
+    name: string;
+    filter(tools: AgentTool[]): AgentTool[];
+}
+//# sourceMappingURL=sources.d.ts.map

package/lib/tool/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/tool/sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEvH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAMtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG7D,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAClC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,iBAAiB,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC/D,YAAY,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CACxB;AAUD,qBAAa,kBAAmB,YAAW,UAAU;IAIvC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAH1C,IAAI,SAAc;IAClB,QAAQ,SAAO;gBAEc,aAAa,EAAE,IAAI,EAAE;IAElD,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,EAAE;CAQxD;AAED,qBAAa,eAAgB,YAAW,UAAU;IAIpC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAH1C,IAAI,SAAY;IAChB,QAAQ,SAAO;gBAEc,aAAa,EAAE,aAAa,GAAG,IAAI;IAEhE,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,EAAE;CAMxD;AAED,qBAAa,oBAAqB,YAAW,UAAU;IAIzC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAH/C,IAAI,SAAgB;IACpB,QAAQ,SAAO;gBAEc,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAEvE,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,SAAS,EAAE;CAGzD;AAED,qBAAa,iBAAkB,YAAW,UAAU;IAClD,IAAI,SAAa;IACjB,QAAQ,SAAQ;IAEhB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,EAAE;CAexD;AAED,qBAAa,aAAc,YAAW,UAAU;IAC9C,IAAI,SAAS;IACb,QAAQ,SAAM;IAEd,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,EAAE;CAcxD;AAED,qBAAa,oBAAqB,YAAW,UAAU;IACrD,IAAI,SAAgB;IAEpB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;CAGxC;AAED,qBAAa,gBAAiB,YAAW,UAAU;IACjD,IAAI,SAAY;IAEhB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;CAUxC"}