@zhin.js/agent 0.3.1 → 1.0.2

package/lib/core/agent-core.js

@@ -0,0 +1,73 @@
+/**
+ * Agent Core — 薄适配器，委托 agent-core-run AsyncGenerator（ADR 0009）。
+ */
+import { DEFAULT_AGENT_CORE_CONFIG, createDefaultAgentCoreDeps } from './compose-deps.js';
+import { runAgentLoopTextTurnRun, runAgentLoopVisionTurnRun, collectAgentLoopTurnRun, } from './agent-core-run.js';
+export class AgentCore {
+    config;
+    deps;
+    constructor(config, deps) {
+        this.config = config;
+        this.deps = deps;
+    }
+    runText(input) {
+        return runAgentLoopTextTurnRun({ ...input, core: this });
+    }
+    runVision(input) {
+        return runAgentLoopVisionTurnRun({ ...input, core: this });
+    }
+    /** Collector over `runText()` AsyncGenerator. */
+    async runTextTurn(input) {
+        const { eventBus } = this.deps;
+        await eventBus.emit('agent.turn.start', {
+            sessionId: input.sessionId,
+            mode: 'text',
+            modelId: input.modelId,
+        });
+        try {
+            const result = await collectAgentLoopTurnRun(this.runText(input));
+            await eventBus.emit('agent.turn.end', {
+                sessionId: input.sessionId,
+                mode: 'text',
+                path: result.path,
+                iterations: result.iterations,
+            });
+            return result;
+        }
+        catch (error) {
+            await eventBus.emit('agent.turn.error', {
+                sessionId: input.sessionId,
+                mode: 'text',
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    async runVisionTurn(input) {
+        const { eventBus } = this.deps;
+        await eventBus.emit('agent.turn.start', {
+            sessionId: input.sessionId,
+            mode: 'vision',
+        });
+        try {
+            const result = await collectAgentLoopTurnRun(this.runVision(input));
+            await eventBus.emit('agent.turn.end', {
+                sessionId: input.sessionId,
+                mode: 'vision',
+                path: result.path,
+                iterations: result.iterations,
+            });
+            return result;
+        }
+        catch (error) {
+            await eventBus.emit('agent.turn.error', {
+                sessionId: input.sessionId,
+                mode: 'vision',
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+}
+export const defaultAgentCore = new AgentCore(DEFAULT_AGENT_CORE_CONFIG, createDefaultAgentCoreDeps());
+//# sourceMappingURL=agent-core.js.map

package/lib/core/agent-core.js.map

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

package/lib/core/agent-loop-standalone.d.ts

@@ -0,0 +1,42 @@
+import { type AgentTool, type AIProvider, type ContentPart, type Usage, type ToolResultTransform } from '@zhin.js/ai';
+import type { Message } from '../orchestrator/types.js';
+import { type ToolCallRecord } from '../core/tool-calls-user-format.js';
+import { type PhaseTraceConfig } from '../internal/phase-trace.js';
+export interface AgentLoopStandaloneCallbacks {
+    onToolCall?: (toolName: string, args: Record<string, unknown>) => void;
+    onToolResult?: (toolName: string, result: unknown) => void;
+}
+export interface AgentLoopStandaloneInput {
+    provider: AIProvider;
+    resolveProvider?: (alias: string) => AIProvider | undefined;
+    model: string;
+    systemPrompt: string;
+    tools: AgentTool[];
+    userInput: string | ContentPart[];
+    maxIterations: number;
+    commMessage: Message;
+    transformToolResult?: ToolResultTransform;
+    callbacks?: AgentLoopStandaloneCallbacks;
+    signal?: AbortSignal;
+    /** Anthropic / OpenAI prompt cache */
+    promptCache?: boolean;
+    promptCacheKey?: string;
+    promptCacheRetention?: 'in_memory' | '24h';
+    /** 与 orchestrator 一致的 per-iteration phase trace */
+    iterationTrace?: {
+        config: PhaseTraceConfig;
+        sessionId: string;
+        label?: string;
+    };
+    /** 默认 true：子 agent / worker 在 direct bash 上下文执行 */
+    directExecution?: boolean;
+}
+export interface AgentLoopStandaloneResult {
+    content: string;
+    usage: Usage;
+    iterations: number;
+    model: string;
+    toolCalls: ToolCallRecord[];
+}
+export declare function runAgentLoopStandaloneTurn(input: AgentLoopStandaloneInput): Promise<AgentLoopStandaloneResult>;
+//# sourceMappingURL=agent-loop-standalone.d.ts.map

package/lib/core/agent-loop-standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop-standalone.d.ts","sourceRoot":"","sources":["../../src/core/agent-loop-standalone.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,KAAK,EAA+Q,KAAK,mBAAmB,EAAsB,MAAM,aAAa,CAAC;AAEvZ,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,mCAAmC,CAAC;AAGhG,OAAO,EAAE,KAAK,gBAAgB,EAA4B,MAAM,4BAA4B,CAAC;AAwD7F,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACvE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,UAAU,CAAC;IACrB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAC;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,SAAS,CAAC,EAAE,4BAA4B,CAAC;IACzC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAC3C,mDAAmD;IACnD,cAAc,CAAC,EAAE;QAAE,MAAM,EAAE,gBAAgB,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CAsIpC"}

package/lib/core/agent-loop-standalone.js

@@ -0,0 +1,163 @@
+/**
+ * Standalone agentLoop runner (subagent / deferred worker) — isolated memory context.
+ */
+import { formatCompact, Logger } from '@zhin.js/logger';
+import { agentLoop, agentContextFrom, assistantText, createUserMessage, createMemoryContextRepository, getLlmTransportModel, agentToolsToLlmTools, registerLlmApiFromProviders, sdkEntryFromProvider } from '@zhin.js/ai';
+import { runWithCommMessage, runWithDirectAgentExecution } from '../security/comm-message-context.js';
+import { sanitizeAssistantReply } from '../core/text-sanitize.js';
+import { formatToolCallsForUser } from '../core/tool-calls-user-format.js';
+import { buildVisionUserMessage, summarizeMultimodalParts } from '../turn/multimodal-message.js';
+import { DEFAULT_MULTIMODAL_CONFIG } from '../media/media-types.js';
+import { logAgentLoopIterationEnd } from '../internal/phase-trace.js';
+const logger = new Logger(null, 'AgentLoopStandalone');
+function tokenUsageToLegacy(usage) {
+    return {
+        prompt_tokens: usage.input,
+        completion_tokens: usage.output,
+        total_tokens: usage.totalTokens,
+    };
+}
+function toolResultToAgentMessage(toolCall, result, isError) {
+    const text = typeof result === 'string'
+        ? result
+        : result == null
+            ? ''
+            : JSON.stringify(result);
+    return {
+        role: 'toolResult',
+        toolCallId: toolCall.id,
+        toolName: toolCall.name,
+        content: [{ type: 'text', text: text || (isError ? 'Error' : '') }],
+        isError,
+        timestamp: Date.now(),
+    };
+}
+async function buildUserMessages(input) {
+    if (typeof input === 'string') {
+        return [createUserMessage(input)];
+    }
+    const text = summarizeMultimodalParts(input, true);
+    const user = await buildVisionUserMessage(text, input, true, DEFAULT_MULTIMODAL_CONFIG.maxFileBytes);
+    return [user];
+}
+function ensureLlmApi(provider, resolveProvider) {
+    registerLlmApiFromProviders([sdkEntryFromProvider(provider)], (alias) => {
+        const p = alias === provider.name ? provider : resolveProvider?.(alias);
+        return p?.models ?? [];
+    });
+}
+export async function runAgentLoopStandaloneTurn(input) {
+    const { provider, model, systemPrompt, tools, userInput, maxIterations, commMessage, transformToolResult, callbacks, signal, directExecution = true, } = input;
+    ensureLlmApi(provider, input.resolveProvider);
+    const llmModel = getLlmTransportModel(provider.name, model);
+    const { repository } = createMemoryContextRepository();
+    const sessionId = `standalone:${Date.now()}`;
+    const loaded = await repository.loadContext(sessionId);
+    const promptMessages = await buildUserMessages(userInput);
+    const legacyByName = new Map(tools.map((t) => [t.name, t]));
+    const llmTools = agentToolsToLlmTools(tools);
+    const toolCalls = [];
+    let iterations = 0;
+    let lastAssistantText = '';
+    let lastUsage;
+    const runTool = async (toolCall) => {
+        const legacy = legacyByName.get(toolCall.name);
+        if (!legacy) {
+            return toolResultToAgentMessage(toolCall, `Unknown tool: ${toolCall.name}`, true);
+        }
+        try {
+            const exec = () => legacy.execute(toolCall.arguments, commMessage);
+            const raw = directExecution
+                ? await runWithDirectAgentExecution(commMessage, exec)
+                : await runWithCommMessage(commMessage, exec);
+            const rawText = typeof raw === 'string' ? raw : JSON.stringify(raw ?? null);
+            const transformed = transformToolResult
+                ? await transformToolResult({
+                    toolName: toolCall.name,
+                    toolCallId: toolCall.id,
+                    args: toolCall.arguments,
+                    result: rawText,
+                })
+                : rawText;
+            const resultText = typeof transformed === 'string' ? transformed : String(transformed);
+            toolCalls.push({ tool: toolCall.name, args: toolCall.arguments, result: resultText });
+            callbacks?.onToolResult?.(toolCall.name, resultText);
+            return toolResultToAgentMessage(toolCall, resultText, false);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            toolCalls.push({ tool: toolCall.name, args: toolCall.arguments, result: message });
+            callbacks?.onToolResult?.(toolCall.name, message);
+            return toolResultToAgentMessage(toolCall, message, true);
+        }
+    };
+    const loopContext = agentContextFrom({
+        systemPrompt,
+        messages: loaded.messages,
+        tools: llmTools,
+    });
+    const loopConfig = {
+        model: llmModel,
+        maxIterations,
+        streamOptions: {
+            promptCache: input.promptCache !== false,
+            promptCacheKey: input.promptCacheKey,
+            promptCacheRetention: input.promptCacheRetention,
+        },
+        convertToLlm: (messages) => messages,
+        beforeToolCall: async ({ toolCall }) => {
+            callbacks?.onToolCall?.(toolCall.name, toolCall.arguments);
+            return undefined;
+        },
+        executeTool: async (toolCall) => runTool(toolCall),
+    };
+    for await (const event of agentLoop(promptMessages, loopContext, loopConfig, signal)) {
+        if (event.type === 'turn_start') {
+            iterations += 1;
+        }
+        if (event.type === 'message_end' && event.message.role === 'assistant') {
+            const assistant = event.message;
+            lastAssistantText = assistantText(assistant);
+            if (!lastAssistantText.trim() && assistant.errorMessage) {
+                lastAssistantText = `Something went wrong: ${assistant.errorMessage}. Please try again or rephrase your request.`;
+            }
+            lastUsage = assistant.usage;
+            const trace = input.iterationTrace;
+            if (trace) {
+                const toolNames = assistant.content
+                    .filter((b) => b.type === 'toolCall')
+                    .map((b) => b.name)
+                    .join(',');
+                logAgentLoopIterationEnd(trace.config, trace.sessionId, {
+                    iteration: iterations,
+                    model,
+                    label: trace.label ?? 'standalone',
+                    usage: assistant.usage,
+                    stopReason: assistant.stopReason,
+                    toolNames: toolNames || undefined,
+                });
+            }
+        }
+        if (event.type === 'agent_end') {
+            const userBatch = event.userMessages ?? promptMessages;
+            await repository.appendMessages(sessionId, [...userBatch, ...event.messages]);
+        }
+    }
+    const content = sanitizeAssistantReply(lastAssistantText, {
+        toolSummary: formatToolCallsForUser(toolCalls),
+    });
+    logger.debug(formatCompact({
+        mode: 'standalone',
+        model,
+        iterations,
+        tool_calls: toolCalls.length,
+    }));
+    return {
+        content,
+        usage: lastUsage ? tokenUsageToLegacy(lastUsage) : { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },
+        iterations,
+        model,
+        toolCalls,
+    };
+}
+//# sourceMappingURL=agent-loop-standalone.js.map

package/lib/core/agent-loop-standalone.js.map

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

package/lib/core/agent-loop-turn.d.ts

@@ -0,0 +1,8 @@
+/**
+ * agentLoop turn runner (ADR 0009) — types + Promise collectors over AgentCore.run SSOT.
+ */
+export type { AgentLoopTurnInput, AgentLoopTurnResult, AgentLoopVisionTurnInput, AgentLoopVisionTurnResult, } from './agent-core-run.js';
+import type { AgentLoopTurnInput, AgentLoopTurnResult, AgentLoopVisionTurnInput, AgentLoopVisionTurnResult } from './agent-core-run.js';
+export declare function runAgentLoopTextTurn(input: AgentLoopTurnInput): Promise<AgentLoopTurnResult>;
+export declare function runAgentLoopVisionTurn(input: AgentLoopVisionTurnInput): Promise<AgentLoopVisionTurnResult>;
+//# sourceMappingURL=agent-loop-turn.d.ts.map

package/lib/core/agent-loop-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop-turn.d.ts","sourceRoot":"","sources":["../../src/core/agent-loop-turn.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAO7B,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAKlG;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CAKpC"}

package/lib/core/agent-loop-turn.js

@@ -0,0 +1,17 @@
+/**
+ * agentLoop turn runner (ADR 0009) — types + Promise collectors over AgentCore.run SSOT.
+ */
+import { collectAgentLoopTurnRun, runAgentLoopTextTurnRun, runAgentLoopVisionTurnRun, } from './agent-core-run.js';
+export async function runAgentLoopTextTurn(input) {
+    if (input.core) {
+        return input.core.runTextTurn(input);
+    }
+    return collectAgentLoopTurnRun(runAgentLoopTextTurnRun(input));
+}
+export async function runAgentLoopVisionTurn(input) {
+    if (input.core) {
+        return input.core.runVisionTurn(input);
+    }
+    return collectAgentLoopTurnRun(runAgentLoopVisionTurnRun(input));
+}
+//# sourceMappingURL=agent-loop-turn.js.map

package/lib/core/agent-loop-turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop-turn.js","sourceRoot":"","sources":["../../src/core/agent-loop-turn.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAyB;IAClE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,uBAAuB,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA+B;IAE/B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,uBAAuB,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/lib/core/compose-deps.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AgentCore 组合层依赖 — compose / defaultAgentCore 共用（阶段 5）。
+ *
+ * 生产 IM turn 的工具与会话链经 `agent-core-run` + `ZhinAgentPrivate` host；
+ * 此处 `ToolExecutor` / `ContextManager` 为契约占位，供独立测试与 Console 路径接线。
+ * `defaultAgentCore` 仅在 host 未 configure `agentCore` 时作 fallback，工具经 host 执行，不经过下方 stub。
+ */
+import type { AgentCoreConfig, AgentCoreDependencies } from './contracts.js';
+import type { EventSystem } from '../event/event-system.js';
+export declare const DEFAULT_AGENT_CORE_CONFIG: AgentCoreConfig;
+export declare function createAgentCoreDepsForCompose(provider: AgentCoreDependencies['provider'], eventSystem: EventSystem): AgentCoreDependencies;
+export declare function createDefaultAgentCoreDeps(): AgentCoreDependencies;
+//# sourceMappingURL=compose-deps.d.ts.map

package/lib/core/compose-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-deps.d.ts","sourceRoot":"","sources":["../../src/core/compose-deps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,yBAAyB,EAAE,eAIvC,CAAC;AAgCF,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,EAC3C,WAAW,EAAE,WAAW,GACvB,qBAAqB,CAEvB;AAED,wBAAgB,0BAA0B,IAAI,qBAAqB,CAElE"}

package/lib/core/compose-deps.js

@@ -0,0 +1,35 @@
+export const DEFAULT_AGENT_CORE_CONFIG = {
+    maxIterations: 15,
+    timeout: 120_000,
+    toolExecution: 'tiered',
+};
+const NO_OP_EVENT_BUS = { emit: async () => { } };
+/** 占位 provider；`defaultAgentCore` fallback 不发起 LLM 调用。 */
+const NO_OP_PROVIDER = {
+    name: 'no-op',
+    models: [],
+    chat: async () => ({ content: '' }),
+    chatStream: async function* () { },
+};
+/** 占位工具执行器；生产路径经 `agent-core-run` + host，此处返回空结果。 */
+const NO_OP_TOOL_EXECUTOR = {
+    executeAll: async () => [],
+};
+const NO_OP_CONTEXT_MANAGER = {
+    prepare: async (input) => ({ messages: input.messages }),
+    append: async () => { },
+};
+function createStubAgentCoreDeps(overrides) {
+    return {
+        toolExecutor: NO_OP_TOOL_EXECUTOR,
+        contextManager: NO_OP_CONTEXT_MANAGER,
+        ...overrides,
+    };
+}
+export function createAgentCoreDepsForCompose(provider, eventSystem) {
+    return createStubAgentCoreDeps({ provider, eventBus: eventSystem });
+}
+export function createDefaultAgentCoreDeps() {
+    return createStubAgentCoreDeps({ provider: NO_OP_PROVIDER, eventBus: NO_OP_EVENT_BUS });
+}
+//# sourceMappingURL=compose-deps.js.map

package/lib/core/compose-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-deps.js","sourceRoot":"","sources":["../../src/core/compose-deps.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,yBAAyB,GAAoB;IACxD,aAAa,EAAE,EAAE;IACjB,OAAO,EAAE,OAAO;IAChB,aAAa,EAAE,QAAQ;CACxB,CAAC;AAEF,MAAM,eAAe,GAAsC,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,CAAC;AAEpF,0DAA0D;AAC1D,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACnC,UAAU,EAAE,KAAK,SAAS,CAAC,MAAK,CAAC;CACc,CAAC;AAElD,qDAAqD;AACrD,MAAM,mBAAmB,GAA0C;IACjE,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;CAC3B,CAAC;AAEF,MAAM,qBAAqB,GAA4C;IACrE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;IACxD,MAAM,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;CACvB,CAAC;AAEF,SAAS,uBAAuB,CAC9B,SAA+D;IAE/D,OAAO;QACL,YAAY,EAAE,mBAAmB;QACjC,cAAc,EAAE,qBAAqB;QACrC,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,QAA2C,EAC3C,WAAwB;IAExB,OAAO,uBAAuB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,uBAAuB,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;AAC1F,CAAC"}

package/lib/core/contracts.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Agent Core — 模块契约（与实现同步，ADR 0009）。
+ *
+ * 实现：`AgentCore.runText()` / `runVision()` 为 `AsyncGenerator<TurnEvent>` SSOT；
+ * `runTextTurn` / `runVisionTurn` 为 collector 薄包装。
+ * 委托 `agent-core-run` → `@zhin.js/ai` `agentLoop`。
+ * `ToolExecutor` / `ContextManager` 供 `composeZhinAgentRuntime` 占位注入；
+ * 生产 IM turn 经 `ZhinAgentPrivate` host 走完整工具与会话链。
+ */
+import type { AgentEvent } from '@zhin.js/ai';
+export interface AgentCoreConfig {
+    maxIterations: number;
+    timeout: number;
+    toolExecution: 'parallel' | 'sequential' | 'tiered';
+}
+export interface ToolExecutor {
+    executeAll(toolCalls: ToolCall[]): Promise<ToolResult[]>;
+}
+export interface ContextManager {
+    prepare(input: AgentLoopInput): Promise<AgentContext>;
+    append(results: ToolResult[]): Promise<void>;
+}
+/** EventSystem 或 no-op；`AgentCore` 在 turn 起止发出 `agent.turn.*` */
+export interface AgentEventBus {
+    emit(eventType: string, payload: unknown): Promise<void>;
+}
+export interface AgentCoreDependencies {
+    provider: import('@zhin.js/ai').AIProvider;
+    toolExecutor: ToolExecutor;
+    contextManager: ContextManager;
+    eventBus: AgentEventBus;
+}
+export interface AgentLoopInput {
+    messages: import('@zhin.js/ai').AgentMessage[];
+    sessionKey?: string;
+}
+export interface AgentContext {
+    messages: import('@zhin.js/ai').AgentMessage[];
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: unknown;
+}
+export interface ToolResult {
+    toolCallId: string;
+    result: unknown;
+}
+export type AgentCoreEvent = AgentEvent;
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/core/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAC;CACrD;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtD,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,aAAa,EAAE,UAAU,CAAC;IAC3C,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,aAAa,EAAE,YAAY,EAAE,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,aAAa,EAAE,YAAY,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC"}

package/lib/core/contracts.js

@@ -0,0 +1,11 @@
+/**
+ * Agent Core — 模块契约（与实现同步，ADR 0009）。
+ *
+ * 实现：`AgentCore.runText()` / `runVision()` 为 `AsyncGenerator<TurnEvent>` SSOT；
+ * `runTextTurn` / `runVisionTurn` 为 collector 薄包装。
+ * 委托 `agent-core-run` → `@zhin.js/ai` `agentLoop`。
+ * `ToolExecutor` / `ContextManager` 供 `composeZhinAgentRuntime` 占位注入；
+ * 生产 IM turn 经 `ZhinAgentPrivate` host 走完整工具与会话链。
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/lib/core/contracts.js.map

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

package/lib/core/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Agent Core — agentLoop 薄适配器（ADR 0009）；契约见 contracts.ts。
+ */
+export type { AgentCoreConfig, AgentCoreDependencies, AgentLoopInput, AgentContext, ToolCall, ToolResult, ToolExecutor, ContextManager, AgentEventBus, AgentCoreEvent, } from './contracts.js';
+export { AgentCore, defaultAgentCore } from './agent-core.js';
+export type { AgentLoopTurnInput, AgentLoopTurnResult, AgentLoopVisionTurnInput, AgentLoopVisionTurnResult, } from './agent-loop-turn.js';
+export { runAgentLoopTextTurn, runAgentLoopVisionTurn, } from './agent-loop-turn.js';
+export type { ToolCallRecord } from './tool-calls-user-format.js';
+export { formatToolCallsForUser, looksLikeInternalToolDump } from './tool-calls-user-format.js';
+export { sanitizeAssistantReply, stripThinkBlocks, stripHallucinatedToolCalls, looksLikeRawToolMarkup } from './text-sanitize.js';
+export { runAgentLoopStandaloneTurn, } from './agent-loop-standalone.js';
+export type { AgentLoopStandaloneCallbacks, AgentLoopStandaloneInput, AgentLoopStandaloneResult, } from './agent-loop-standalone.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAElI,OAAO,EACL,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC"}

package/lib/core/index.js

@@ -0,0 +1,9 @@
+/**
+ * Agent Core — agentLoop 薄适配器（ADR 0009）；契约见 contracts.ts。
+ */
+export { AgentCore, defaultAgentCore } from './agent-core.js';
+export { runAgentLoopTextTurn, runAgentLoopVisionTurn, } from './agent-loop-turn.js';
+export { formatToolCallsForUser, looksLikeInternalToolDump } from './tool-calls-user-format.js';
+export { sanitizeAssistantReply, stripThinkBlocks, stripHallucinatedToolCalls, looksLikeRawToolMarkup } from './text-sanitize.js';
+export { runAgentLoopStandaloneTurn, } from './agent-loop-standalone.js';
+//# sourceMappingURL=index.js.map

package/lib/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAS9D,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAElI,OAAO,EACL,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC"}

package/lib/core/text-sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-sanitize.d.ts","sourceRoot":"","sources":["../../src/core/text-sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAG7E,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAEtC,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAKD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,MAAM,WAAW,6BAA6B;IAC5C,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AASD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAkBR"}

package/lib/core/text-sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-sanitize.js","sourceRoot":"","sources":["../../src/core/text-sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAEtC,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,kBAAkB,GACtB,0GAA0G,CAAC;AAE7G;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAUD,SAAS,YAAY,CAAC,IAAY,EAAE,GAAY;IAC9C,OAAO,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,mBAAmB,GACvB,uCAAuC,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAW,EACX,UAAyC,EAAE;IAE3C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,QAAQ,GAAG,0BAA0B,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAElD,IAAI,yBAAyB,CAAC,QAAQ,CAAC,IAAI,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;QACvF,OAAO,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,QAAQ,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1F,OAAO,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,OAAO,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,YAAY,CAAC,OAAO,CAAC,YAAY,IAAI,mBAAmB,EAAE,GAAG,CAAC,CAAC;AACxE,CAAC"}

package/lib/core/tool-calls-user-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-calls-user-format.d.ts","sourceRoot":"","sources":["../../src/core/tool-calls-user-format.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AA2ED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CA6C1E;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAS/D"}