@zhin.js/agent 1.0.1 → 1.0.3

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

@@ -0,0 +1,87 @@
+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';
+import { applyDynamicTurnOverrides } from '../dynamic/dynamic-registry.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;
+    host.turnDynamicInstructions = undefined;
+    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;
+    let 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 dynamicApplied = await applyDynamicTurnOverrides({
+        tools: allTools,
+        ctx: {
+            sessionId: opts.sessionId,
+            userId,
+            adapter: String(contextForTools.$adapter),
+            commMessage: contextForTools,
+            agentId: host.activeBinding?.name,
+        },
+    });
+    allTools = dynamicApplied.tools;
+    host.turnDynamicInstructions = dynamicApplied.additionalInstructions;
+    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"}

package/lib/tool/sources.js

@@ -0,0 +1,110 @@
+import { isReservedToolName } from '@zhin.js/ai';
+import { sceneRefFromMessage, Logger } from '@zhin.js/core';
+import { KEYWORD_TRIGGERS } from '../config/keyword-triggers.js';
+import { createImTranscriptHistoryTool, createUserProfileTool, } from '../tool/context-tools.js';
+import { buildImTranscriptQuery } from '../session/session-io.js';
+import { sharedToolSelection } from '../orchestrator/tool-selection.js';
+import { RESERVED_TOOL_NAMES, RESERVED_TOOL_NAME_PREFIXES } from '../reserved-tools.js';
+const logger = new Logger(null, 'ToolSystem');
+function canAccessTool(tool, message) {
+    const perms = tool.permissions;
+    if (!perms?.length)
+        return true;
+    const adapter = String(message.$adapter ?? '');
+    const scene = sceneRefFromMessage(message)?.kind ?? '';
+    return perms.some(p => p === adapter || p === scene || p === '*');
+}
+export class ExternalToolSource {
+    externalTools;
+    name = 'external';
+    priority = 200;
+    constructor(externalTools) {
+        this.externalTools = externalTools;
+    }
+    collectTools(context) {
+        const tools = [];
+        for (const tool of this.externalTools) {
+            if (!canAccessTool(tool, context.message))
+                continue;
+            tools.push(sharedToolSelection.normalize(tool, context.message));
+        }
+        return tools;
+    }
+}
+export class SkillToolSource {
+    skillRegistry;
+    name = 'skills';
+    priority = 100;
+    constructor(skillRegistry) {
+        this.skillRegistry = skillRegistry;
+    }
+    collectTools(context) {
+        if (!this.skillRegistry)
+            return [];
+        return this.skillRegistry.collectAllTools().map((tool) => sharedToolSelection.normalize(tool, context.message));
+    }
+}
+export class RegisteredToolSource {
+    externalRegistered;
+    name = 'registered';
+    priority = 150;
+    constructor(externalRegistered) {
+        this.externalRegistered = externalRegistered;
+    }
+    collectTools(_context) {
+        return [...this.externalRegistered.values()];
+    }
+}
+export class BuiltinToolSource {
+    name = 'builtin';
+    priority = 1000;
+    collectTools(context) {
+        const tools = [];
+        if (KEYWORD_TRIGGERS.chatHistory.test(context.content)) {
+            tools.push(createImTranscriptHistoryTool(context.imTranscriptStore, buildImTranscriptQuery(context.message)));
+        }
+        if (KEYWORD_TRIGGERS.userProfile.test(context.content)) {
+            tools.push(createUserProfileTool(context.userId, context.userProfiles));
+        }
+        return tools;
+    }
+}
+export class McpToolSource {
+    name = 'mcp';
+    priority = 50;
+    collectTools(context) {
+        const tools = [];
+        for (const mcpTool of context.mcpTools ?? []) {
+            if (isReservedToolName(mcpTool.name, {
+                reservedNames: RESERVED_TOOL_NAMES,
+                reservedPrefixes: RESERVED_TOOL_NAME_PREFIXES,
+            })) {
+                logger.warn(`[MCP] Skipping tool "${mcpTool.name}": conflicts with reserved tool name`);
+                continue;
+            }
+            tools.push(mcpTool);
+        }
+        return tools;
+    }
+}
+export class PermissionToolFilter {
+    name = 'permission';
+    filter(tools) {
+        return tools;
+    }
+}
+export class DedupeToolFilter {
+    name = 'dedupe';
+    filter(tools) {
+        const names = new Set();
+        const out = [];
+        for (const tool of tools) {
+            if (names.has(tool.name))
+                continue;
+            out.push(tool);
+            names.add(tool.name);
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=sources.js.map

package/lib/tool/sources.js.map

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

package/lib/tool/tool-approval-gate.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Per-tool approval gate — stacks with ExecPolicy (ADR 0039 P1).
+ */
+import type { Message, Plugin } from '@zhin.js/core';
+import type { ToolApprovalPolicy } from '@zhin.js/ai/tool-policy';
+import type { AgentStreamBus, AgentStreamPublishContext } from '../event/agent-stream-bus.js';
+import type { SessionInteractionPort } from '../session/session-interaction-port.js';
+import type { ToolApprovalOnceStore } from './tool-approval-once-store.js';
+export declare function resolveToolApprovalRequired(policy: ToolApprovalPolicy | undefined, input: {
+    toolName: string;
+    args: Record<string, unknown>;
+    sessionId: string;
+}, onceStore?: ToolApprovalOnceStore): Promise<boolean>;
+export interface ToolApprovalGateOptions {
+    toolName: string;
+    args: Record<string, unknown>;
+    sessionId: string;
+    commMessage: Message;
+    policy?: ToolApprovalPolicy;
+    plugin?: Plugin;
+    bus?: AgentStreamBus;
+    port?: SessionInteractionPort;
+    onceStore?: ToolApprovalOnceStore;
+    publishCtx?: AgentStreamPublishContext;
+}
+/**
+ * Returns denial message when approval is required but not granted; otherwise null.
+ */
+export declare function runToolApprovalGate(options: ToolApprovalGateOptions): Promise<string | null>;
+//# sourceMappingURL=tool-approval-gate.d.ts.map

package/lib/tool/tool-approval-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-approval-gate.d.ts","sourceRoot":"","sources":["../../src/tool/tool-approval-gate.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC7E,SAAS,CAAC,EAAE,qBAAqB,GAChC,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6DxB"}

package/lib/tool/tool-approval-gate.js

@@ -0,0 +1,74 @@
+import { AgentStreamEventType } from '@zhin.js/ai/agent-stream';
+export async function resolveToolApprovalRequired(policy, input, onceStore) {
+    if (!policy || policy === 'never')
+        return false;
+    if (policy === 'always')
+        return true;
+    if (policy === 'once') {
+        if (!onceStore)
+            return true;
+        return !onceStore.has(input.sessionId, input.toolName);
+    }
+    return Boolean(await policy({ toolName: input.toolName, args: input.args }));
+}
+/**
+ * Returns denial message when approval is required but not granted; otherwise null.
+ */
+export async function runToolApprovalGate(options) {
+    const required = await resolveToolApprovalRequired(options.policy, {
+        toolName: options.toolName,
+        args: options.args,
+        sessionId: options.sessionId,
+    }, options.onceStore);
+    if (!required)
+        return null;
+    if (!options.bus || !options.port) {
+        return 'Error: approval required but AgentStreamBus / SessionInteractionPort unavailable';
+    }
+    const requestId = `approval_${options.toolName}_${Date.now()}`;
+    const publishCtx = {
+        sessionId: options.sessionId,
+        ...options.publishCtx,
+    };
+    await options.bus.publish({
+        type: AgentStreamEventType.INPUT_REQUESTED,
+        data: {
+            sessionId: options.sessionId,
+            requestId,
+            toolName: options.toolName,
+            kind: 'approval',
+            args: options.args,
+        },
+    }, publishCtx);
+    const question = `工具「${options.toolName}」需要确认后执行。是否继续？`;
+    let approved;
+    try {
+        approved = await options.port.requestApproval({
+            requestId,
+            toolName: options.toolName,
+            question,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return `Error: approval wait failed — ${msg}`;
+    }
+    await options.bus.publish({
+        type: AgentStreamEventType.INPUT_COMPLETED,
+        data: {
+            sessionId: options.sessionId,
+            requestId,
+            toolName: options.toolName,
+            kind: 'approval',
+            approved,
+        },
+    }, publishCtx);
+    if (!approved) {
+        return `Error: tool "${options.toolName}" execution denied by user`;
+    }
+    if (options.policy === 'once' && options.onceStore) {
+        options.onceStore.add(options.sessionId, options.toolName);
+    }
+    return null;
+}
+//# sourceMappingURL=tool-approval-gate.js.map

package/lib/tool/tool-approval-gate.js.map

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

package/lib/tool/tool-approval-once-store.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Per-orchestrator store for policy: 'once' tool approvals (ADR 0039 P1).
+ */
+export declare class ToolApprovalOnceStore {
+    private readonly keys;
+    has(sessionId: string, toolName: string): boolean;
+    add(sessionId: string, toolName: string): void;
+    clear(): void;
+}
+//# sourceMappingURL=tool-approval-once-store.d.ts.map

package/lib/tool/tool-approval-once-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-approval-once-store.d.ts","sourceRoot":"","sources":["../../src/tool/tool-approval-once-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAE1C,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9C,KAAK,IAAI,IAAI;CAGd"}

package/lib/tool/tool-approval-once-store.js

@@ -0,0 +1,16 @@
+/**
+ * Per-orchestrator store for policy: 'once' tool approvals (ADR 0039 P1).
+ */
+export class ToolApprovalOnceStore {
+    keys = new Set();
+    has(sessionId, toolName) {
+        return this.keys.has(`${sessionId}:${toolName}`);
+    }
+    add(sessionId, toolName) {
+        this.keys.add(`${sessionId}:${toolName}`);
+    }
+    clear() {
+        this.keys.clear();
+    }
+}
+//# sourceMappingURL=tool-approval-once-store.js.map

package/lib/tool/tool-approval-once-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-approval-once-store.js","sourceRoot":"","sources":["../../src/tool/tool-approval-once-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACf,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,GAAG,CAAC,SAAiB,EAAE,QAAgB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,GAAG,CAAC,SAAiB,EAAE,QAAgB;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF"}

package/lib/tool/tool-model-output.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '@zhin.js/ai';
+export declare function applyToolToModelOutput(tool: Pick<AgentTool, 'toModelOutput'>, raw: unknown, args: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=tool-model-output.d.ts.map

package/lib/tool/tool-model-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-model-output.d.ts","sourceRoot":"","sources":["../../src/tool/tool-model-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EACtC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,CAKjB"}

package/lib/tool/tool-model-output.js

@@ -0,0 +1,7 @@
+export async function applyToolToModelOutput(tool, raw, args) {
+    if (!tool.toModelOutput) {
+        return typeof raw === 'string' ? raw : JSON.stringify(raw ?? null);
+    }
+    return tool.toModelOutput({ result: raw, args });
+}
+//# sourceMappingURL=tool-model-output.js.map

package/lib/tool/tool-model-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-model-output.js","sourceRoot":"","sources":["../../src/tool/tool-model-output.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAsC,EACtC,GAAY,EACZ,IAA6B;IAE7B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QACxB,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/lib/tool/tool-system.d.ts

@@ -0,0 +1,36 @@
+import type { AgentTool } from '@zhin.js/ai';
+import { type PreExecuteResult } from './pre-exec.js';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import type { ToolFilter, ToolSource, ToolSystemConfig } from './contracts.js';
+import { type CollectToolsContext } from './sources.js';
+import { type ResolvedToolsForTurn } from './deferred-resolution.js';
+export type { CollectToolsContext } from './sources.js';
+export type { ResolvedToolsForTurn } from './deferred-resolution.js';
+export interface CollectToolsForTurnInput extends CollectToolsContext {
+    host: ZhinAgentPrivate;
+    spawnableAgentNames?: string[];
+}
+/** 每 turn 独立 Source 列表，不 mutate 共享 ToolSystem 实例。 */
+export declare function createDefaultToolSources(context: CollectToolsContext): ToolSource[];
+export declare function createToolSystem(config?: ToolSystemConfig): ToolSystem;
+export declare class ToolSystem {
+    private readonly customSources;
+    private readonly filters;
+    constructor(_config?: ToolSystemConfig);
+    addSource(source: ToolSource): void;
+    addFilter(filter: ToolFilter): void;
+    collectTools(context: CollectToolsContext, sources?: ToolSource[]): AgentTool[];
+    collectForTurn(input: CollectToolsForTurnInput): AgentTool[];
+    resolveForTurn(host: ZhinAgentPrivate, allTools: AgentTool[], sessionId: string): Promise<ResolvedToolsForTurn>;
+}
+export interface ToolRunPlan {
+    preExecTools: AgentTool[];
+    preExecution: PreExecuteResult;
+    hasNonPreExecTools: boolean;
+    mode: 'chat' | 'pre-exec-fast-path' | 'agent';
+}
+export declare function planToolRun(tools: AgentTool[], timeoutMs: number): Promise<ToolRunPlan>;
+export declare function buildPreExecFastPathPrompt(persona: string, preData: string): string;
+/** 无 per-turn 可变 state；并发 collectForTurn 安全。 */
+export declare const defaultToolSystem: ToolSystem;
+//# sourceMappingURL=tool-system.d.ts.map

package/lib/tool/tool-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-system.d.ts","sourceRoot":"","sources":["../../src/tool/tool-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,gBAAgB,EAAyB,MAAM,eAAe,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAOL,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE,IAAI,EAAE,gBAAgB,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,qDAAqD;AACrD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,UAAU,EAAE,CAQnF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,gBAAqB,GAAG,UAAU,CAE1E;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,OAAO,GAAE,gBAAqB;IAI1C,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKnC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,EAAE;IAe/E,cAAc,CAAC,KAAK,EAAE,wBAAwB,GAAG,SAAS,EAAE;IAetD,cAAc,CAClB,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,SAAS,EAAE,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC;CAGjC;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,OAAO,CAAC;CAC/C;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,SAAS,EAAE,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CAWtB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAOnF;AAED,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,YAAqB,CAAC"}

package/lib/tool/tool-system.js

@@ -0,0 +1,84 @@
+import { runPreExecutableTools } from './pre-exec.js';
+import { createSpawnTaskTool } from '../builtin/spawn-task-tool.js';
+import { filterAgentsForSpawnDescription } from '../spawn/permission-task.js';
+import { BuiltinToolSource, DedupeToolFilter, ExternalToolSource, McpToolSource, RegisteredToolSource, SkillToolSource, } from './sources.js';
+import { resolveAgentToolsForTurn, } from './deferred-resolution.js';
+/** 每 turn 独立 Source 列表，不 mutate 共享 ToolSystem 实例。 */
+export function createDefaultToolSources(context) {
+    return [
+        new ExternalToolSource(context.externalTools),
+        new SkillToolSource(context.skillRegistry),
+        new RegisteredToolSource(context.externalRegistered),
+        new BuiltinToolSource(),
+        new McpToolSource(),
+    ];
+}
+export function createToolSystem(config = {}) {
+    return new ToolSystem(config);
+}
+export class ToolSystem {
+    customSources = [];
+    filters = [];
+    constructor(_config = {}) {
+        this.addFilter(new DedupeToolFilter());
+    }
+    addSource(source) {
+        this.customSources.push(source);
+        this.customSources.sort((a, b) => b.priority - a.priority);
+    }
+    addFilter(filter) {
+        this.filters.push(filter);
+    }
+    collectTools(context, sources) {
+        const activeSources = sources ?? [
+            ...createDefaultToolSources(context),
+            ...this.customSources,
+        ];
+        let tools = [];
+        for (const source of activeSources) {
+            tools.push(...source.collectTools(context));
+        }
+        for (const filter of this.filters) {
+            tools = filter.filter(tools, { message: context.message });
+        }
+        return tools;
+    }
+    collectForTurn(input) {
+        const { host, spawnableAgentNames, ...ctx } = input;
+        const tools = this.collectTools(ctx, createDefaultToolSources(ctx));
+        if (host.subagentSystem && spawnableAgentNames) {
+            const permissionTask = host.activeBinding?.permission?.task;
+            tools.push(createSpawnTaskTool(ctx.message, host.subagentSystem, {
+                allowedAgents: filterAgentsForSpawnDescription(spawnableAgentNames, permissionTask),
+                permissionTaskRules: permissionTask,
+            }));
+        }
+        return tools;
+    }
+    async resolveForTurn(host, allTools, sessionId) {
+        return resolveAgentToolsForTurn(host, allTools, sessionId);
+    }
+}
+export async function planToolRun(tools, timeoutMs) {
+    const preExecution = await runPreExecutableTools(tools, timeoutMs);
+    const hasNonPreExecTools = tools.some(tool => !tool.preExecutable);
+    return {
+        preExecTools: preExecution.tools,
+        preExecution,
+        hasNonPreExecTools,
+        mode: tools.length === 0
+            ? 'chat'
+            : (!hasNonPreExecTools && preExecution.data ? 'pre-exec-fast-path' : 'agent'),
+    };
+}
+export function buildPreExecFastPathPrompt(persona, preData) {
+    return `${persona}
+
+Pre-fetched data (from user's question):
+${preData}
+
+Answer the user's question based on the data above. Be clear and concise; use emoji when appropriate.`;
+}
+/** 无 per-turn 可变 state；并发 collectForTurn 安全。 */
+export const defaultToolSystem = createToolSystem();
+//# sourceMappingURL=tool-system.js.map