@zhin.js/agent 0.1.30 → 0.1.32

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

@@ -0,0 +1,52 @@
+/**
+ * agentLoop turn runner (ADR 0009) — used when ContextRepository is wired.
+ */
+import type { AgentTool, Usage } from '@zhin.js/ai';
+import { type AgentMessage } from '@zhin.js/ai';
+import { type ToolCallRecord } from './tool-calls-user-format.js';
+import type { PromptTurnHooks } from './prompt-controller.js';
+import type { ZhinAgentPrivate, OnChunkCallback, ToolContext } from './zhin-agent-private.js';
+export interface AgentLoopTurnInput {
+    host: ZhinAgentPrivate;
+    sessionId: string;
+    /** 本轮 user 消息 extra（入库 agent_messages.extra） */
+    userMessageExtra?: import('@zhin.js/ai').AgentMessageExtra;
+    rawContent: string;
+    context: ToolContext;
+    contextForTools: ToolContext;
+    allTools: AgentTool[];
+    resolvedTools: AgentTool[];
+    personaEnhanced: string;
+    modelId: string;
+    modelCandidates: string[];
+    onChunk?: OnChunkCallback;
+    initialMessages?: AgentMessage[];
+    promptHooks?: PromptTurnHooks;
+    signal?: AbortSignal;
+    deferredStats?: string;
+}
+export interface AgentLoopTurnResult {
+    reply: string;
+    usage: Usage;
+    path: 'chat' | 'agent' | 'multimodal';
+    iterations: number;
+    model: string;
+    toolCalls: ToolCallRecord[];
+}
+export interface AgentLoopVisionTurnInput {
+    host: ZhinAgentPrivate;
+    sessionId: string;
+    context: ToolContext;
+    visionSystemPrompt: string;
+    userMessages: AgentMessage[];
+    modelCandidates: string[];
+    onChunk?: OnChunkCallback;
+    promptHooks?: PromptTurnHooks;
+    signal?: AbortSignal;
+}
+export type AgentLoopVisionTurnResult = AgentLoopTurnResult & {
+    path: 'multimodal';
+};
+export declare function runAgentLoopVisionTurn(input: AgentLoopVisionTurnInput): Promise<AgentLoopVisionTurnResult>;
+export declare function runAgentLoopTextTurn(input: AgentLoopTurnInput): Promise<AgentLoopTurnResult>;
+//# sourceMappingURL=agent-loop-turn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop-turn.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/agent-loop-turn.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAOL,KAAK,YAAY,EAIlB,MAAM,aAAa,CAAC;AAQrB,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AA0C9F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,OAAO,aAAa,EAAE,iBAAiB,CAAC;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,eAAe,EAAE,WAAW,CAAC;IAC7B,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAuErF,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CAuBpC;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyOlG"}

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

@@ -0,0 +1,328 @@
+/**
+ * agentLoop turn runner (ADR 0009) — used when ContextRepository is wired.
+ */
+import { getPlugin } from '@zhin.js/core';
+import { formatCompact, Logger } from '@zhin.js/logger';
+import { agentLoop, agentContextFrom, assistantText, createUserMessage, getModel, convertLegacyTools, } from '@zhin.js/ai';
+import { runWithBashToolContext } from '../security/bash-tool-context.js';
+import { applyExecPolicyToTools } from '../security/exec-policy.js';
+import { createOwnerOrchestratedToolResultTransform } from '../orchestrator/owner-confirm-orchestration.js';
+import { resolveModelHarness } from './model-harness.js';
+import { buildAgentPathSystemPrompt, buildChatPathSystemPrompt } from './prompt-assembly.js';
+import { planToolRun } from './tool-runtime.js';
+import { sanitizeAssistantReply } from './text-sanitize.js';
+import { formatToolCallsForUser } from './tool-calls-user-format.js';
+import { transformContextWithCompaction } from './compaction-runtime.js';
+import { logPhase, usageLogFields } from './phase-trace.js';
+const logger = new Logger(null, 'ZhinAgent:AgentLoopTurn');
+function resolveAIService(plugin) {
+    if (!plugin)
+        return undefined;
+    try {
+        return plugin.inject?.('ai');
+    }
+    catch {
+        return undefined;
+    }
+}
+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 runAgentLoopVisionTurnOnce(input) {
+    const { host, sessionId, context, visionSystemPrompt, modelId, onChunk, promptHooks, signal } = input;
+    const repo = host.contextRepository;
+    const providerAlias = host.getTurnProvider().name;
+    const llmModel = getModel(providerAlias, modelId);
+    const loaded = await repo.loadContext(sessionId);
+    const promptMessages = input.userMessages;
+    let iterations = 0;
+    let lastAssistantText = '';
+    let lastUsage;
+    logPhase(host.phaseConfig, 'agent_loop.vision.start', sessionId, { model: modelId });
+    const loopContext = agentContextFrom({
+        systemPrompt: visionSystemPrompt,
+        messages: loaded.messages,
+        tools: [],
+    });
+    const loopConfig = {
+        model: llmModel,
+        maxIterations: 1,
+        convertToLlm: (messages) => messages,
+        getSteeringMessages: promptHooks?.getSteeringMessages,
+        getFollowUpMessages: promptHooks?.getFollowUpMessages,
+    };
+    for await (const event of agentLoop(promptMessages, loopContext, loopConfig, signal)) {
+        if (event.type === 'turn_start') {
+            iterations += 1;
+        }
+        if (event.type === 'message_update' && event.delta?.type === 'text_delta') {
+            onChunk?.(event.delta.text, lastAssistantText + event.delta.text);
+        }
+        if (event.type === 'message_end' && event.message.role === 'assistant') {
+            const assistant = event.message;
+            lastAssistantText = assistantText(assistant);
+            lastUsage = assistant.usage;
+            onChunk?.(lastAssistantText, lastAssistantText);
+        }
+        if (event.type === 'agent_end') {
+            const userBatch = event.userMessages ?? promptMessages;
+            await repo.appendMessages(sessionId, [...userBatch, ...event.messages]);
+        }
+    }
+    const reply = sanitizeAssistantReply(lastAssistantText);
+    if (!reply.trim()) {
+        throw new Error('Empty vision model response');
+    }
+    logPhase(host.phaseConfig, 'agent_loop.vision.end', sessionId, {
+        iterations,
+        ...usageLogFields(lastUsage ? tokenUsageToLegacy(lastUsage) : undefined),
+    });
+    return {
+        reply,
+        usage: lastUsage ? tokenUsageToLegacy(lastUsage) : { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },
+        path: 'multimodal',
+        iterations,
+        model: modelId,
+        toolCalls: [],
+    };
+}
+export async function runAgentLoopVisionTurn(input) {
+    const candidates = input.modelCandidates.filter(Boolean);
+    if (candidates.length === 0) {
+        throw new Error('No vision model candidates configured');
+    }
+    let lastError;
+    for (let i = 0; i < candidates.length; i++) {
+        const modelId = candidates[i];
+        try {
+            return await runAgentLoopVisionTurnOnce({ ...input, modelId });
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            const isLast = i === candidates.length - 1;
+            if (isLast)
+                break;
+            logger.warn(formatCompact({
+                mode: 'multimodal',
+                fallback: `${modelId}→${candidates[i + 1]}`,
+                error: lastError.message.slice(0, 120),
+            }));
+        }
+    }
+    throw lastError ?? new Error('All vision model candidates failed');
+}
+export async function runAgentLoopTextTurn(input) {
+    const { host, sessionId, userMessageExtra, context, contextForTools, allTools, resolvedTools, personaEnhanced, modelId, onChunk, promptHooks, signal, } = input;
+    const repo = host.contextRepository;
+    const providerAlias = host.getTurnProvider().name;
+    const llmModel = getModel(providerAlias, modelId);
+    const loaded = await repo.loadContext(sessionId);
+    const promptMessages = input.initialMessages?.length
+        ? input.initialMessages
+        : [createUserMessage(input.rawContent)];
+    const toolRun = allTools.length > 0
+        ? await planToolRun(resolvedTools, host.config.preExecTimeout)
+        : { mode: 'agent', preExecution: { tools: [], data: '' } };
+    const preData = toolRun.preExecution.data;
+    const hasTools = allTools.length > 0;
+    const systemPrompt = hasTools
+        ? await buildAgentPathSystemPrompt(host, {
+            content: input.rawContent,
+            context: contextForTools,
+            sessionId,
+            personaEnhanced,
+            preData,
+            deferredStats: input.deferredStats,
+        })
+        : buildChatPathSystemPrompt(host, personaEnhanced, contextForTools);
+    const agentTools = hasTools
+        ? applyExecPolicyToTools(host.config, resolvedTools, {
+            approvalMode: host.config.execApprovalMode,
+        })
+        : [];
+    const harness = resolveModelHarness(host.getTurnProvider().name, modelId, host.config.modelHarness);
+    const maxIterations = hasTools
+        ? (harness.maxIterations ?? host.config.maxIterations)
+        : 1;
+    let orchestrationPlugin = host.emitter.getHostPlugin() ?? undefined;
+    if (!orchestrationPlugin) {
+        try {
+            orchestrationPlugin = getPlugin().root ?? getPlugin();
+        }
+        catch {
+            logger.warn(formatCompact({ warn: 'no_host_plugin' }));
+        }
+    }
+    const transformToolResult = createOwnerOrchestratedToolResultTransform({
+        toolContext: contextForTools,
+        disableHardOrchestration: false,
+        plugin: orchestrationPlugin,
+    });
+    const legacyByName = new Map(agentTools.map((t) => [t.name, t]));
+    const llmTools = convertLegacyTools(agentTools);
+    const toolCalls = [];
+    let iterations = 0;
+    let lastAssistantText = '';
+    let lastUsage;
+    logPhase(host.phaseConfig, 'agent_loop.turn.start', sessionId, {
+        model: modelId,
+        maxIterations,
+        toolCount: agentTools.length,
+    });
+    if (hasTools) {
+        await host.emitter.dispatch('ai.agent.start', host.emitter.createPayload(sessionId, contextForTools, 'text', {
+            path: 'agent',
+            model: modelId,
+        }));
+    }
+    const loopContext = agentContextFrom({
+        systemPrompt,
+        messages: loaded.messages,
+        tools: llmTools,
+    });
+    const contextWindow = llmModel.contextWindow ?? host.config.contextTokens;
+    const aiService = resolveAIService(orchestrationPlugin);
+    const loopHooks = aiService?.loopHooks;
+    const loopConfig = {
+        model: llmModel,
+        maxIterations,
+        sessionId,
+        convertToLlm: (messages) => messages,
+        transformContext: async (messages, ctxSignal) => transformContextWithCompaction(messages, ctxSignal, {
+            host,
+            sessionId,
+            context: contextForTools,
+            model: llmModel,
+            compactionConfig: host.config.compaction,
+            contextWindow,
+            mode: 'text',
+            loopHooks,
+        }),
+        onContextOverflow: async (messages, ctxSignal) => transformContextWithCompaction(messages, ctxSignal, {
+            host,
+            sessionId,
+            context: contextForTools,
+            model: llmModel,
+            compactionConfig: host.config.compaction,
+            contextWindow,
+            mode: 'text',
+            force: true,
+            loopHooks,
+        }),
+        getSteeringMessages: promptHooks?.getSteeringMessages,
+        getFollowUpMessages: promptHooks?.getFollowUpMessages,
+        executeTool: async (toolCall, _tools, toolSignal) => {
+            const legacy = legacyByName.get(toolCall.name);
+            if (!legacy) {
+                return toolResultToAgentMessage(toolCall, `Unknown tool: ${toolCall.name}`, true);
+            }
+            try {
+                const raw = await runWithBashToolContext(contextForTools, () => legacy.execute(toolCall.arguments));
+                const rawText = typeof raw === 'string' ? raw : JSON.stringify(raw ?? null);
+                const transformed = await transformToolResult({
+                    toolName: toolCall.name,
+                    toolCallId: toolCall.id,
+                    args: toolCall.arguments,
+                    result: rawText,
+                });
+                const resultText = typeof transformed === 'string' ? transformed : String(transformed);
+                toolCalls.push({ tool: toolCall.name, args: toolCall.arguments, result: resultText });
+                host.emitter.emit('ai.tool.result', host.emitter.createPayload(sessionId, contextForTools, 'text', {
+                    path: 'agent',
+                    toolName: toolCall.name,
+                    result: 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 });
+                return toolResultToAgentMessage(toolCall, message, true);
+            }
+        },
+        beforeToolCall: async ({ toolCall }) => {
+            host.emitter.emit('ai.tool.call', host.emitter.createPayload(sessionId, contextForTools, 'text', {
+                path: 'agent',
+                toolName: toolCall.name,
+                args: toolCall.arguments,
+            }));
+            return loopHooks?.runBeforeToolCall({ toolCall, sessionId });
+        },
+        afterToolCall: async ({ toolCall, result }) => {
+            await loopHooks?.runAfterToolCall({ toolCall, result, sessionId });
+        },
+    };
+    for await (const event of agentLoop(promptMessages, loopContext, loopConfig, signal)) {
+        if (event.type === 'turn_start') {
+            iterations += 1;
+        }
+        if (event.type === 'message_update' && event.delta?.type === 'text_delta') {
+            onChunk?.(event.delta.text, lastAssistantText + event.delta.text);
+        }
+        if (event.type === 'message_end' && event.message.role === 'assistant') {
+            const assistant = event.message;
+            lastAssistantText = assistantText(assistant);
+            lastUsage = assistant.usage;
+            onChunk?.(lastAssistantText, lastAssistantText);
+        }
+        if (event.type === 'agent_end') {
+            const userBatch = event.userMessages ?? promptMessages;
+            const batch = [...userBatch, ...event.messages];
+            const messageExtras = batch.map((msg, i) => (msg.role === 'user' && i < userBatch.length ? userMessageExtra : undefined));
+            await repo.appendMessages(sessionId, batch, { messageExtras });
+        }
+    }
+    const reply = sanitizeAssistantReply(lastAssistantText, {
+        toolSummary: formatToolCallsForUser(toolCalls),
+    });
+    const spawnedSubagent = toolCalls.some(tc => tc.tool === 'spawn_task');
+    if (spawnedSubagent) {
+        await host.getActiveTurnTracker()?.waitForPendingSubagents();
+    }
+    const delegatedOnly = spawnedSubagent
+        && !toolCalls.some(tc => tc.tool === 'run_deferred_task')
+        && !toolCalls.some(tc => tc.tool === 'generate_image'
+            && tc.result
+            && typeof tc.result === 'object'
+            && typeof tc.result.image === 'string');
+    const finalReply = delegatedOnly ? '' : reply;
+    if (hasTools) {
+        await host.emitter.dispatch('ai.agent.finish', host.emitter.createPayload(sessionId, contextForTools, 'text', {
+            path: 'agent',
+            model: modelId,
+            iterations,
+        }));
+    }
+    logPhase(host.phaseConfig, 'agent_loop.turn.end', sessionId, {
+        iterations,
+        ...usageLogFields(lastUsage ? tokenUsageToLegacy(lastUsage) : undefined),
+    });
+    return {
+        reply: finalReply,
+        usage: lastUsage ? tokenUsageToLegacy(lastUsage) : { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },
+        path: hasTools ? 'agent' : 'chat',
+        iterations,
+        model: modelId,
+        toolCalls,
+    };
+}
+//# sourceMappingURL=agent-loop-turn.js.map

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

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

package/lib/zhin-agent/branch-summarization-runtime.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Branch summarization on session tree switch — ADR 0010 D3.
+ */
+import type { CompactionConfig } from './config.js';
+import type { ZhinAgentPrivate } from './zhin-agent-private.js';
+export interface BranchSummarizationOptions {
+    compactionConfig?: CompactionConfig;
+    contextWindow?: number;
+}
+export declare function summarizeAbandonedBranchIfNeeded(host: ZhinAgentPrivate, sessionId: string, oldLeafId: number | null | undefined, newLeafId: number, options?: BranchSummarizationOptions): Promise<void>;
+export declare function switchActiveLeafWithBranchSummarization(host: ZhinAgentPrivate, sessionId: string, messageId: number, options?: BranchSummarizationOptions): Promise<boolean>;
+export declare function jumpToBranchIndexWithSummarization(host: ZhinAgentPrivate, sessionId: string, index: number, options?: BranchSummarizationOptions): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=branch-summarization-runtime.d.ts.map

package/lib/zhin-agent/branch-summarization-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-summarization-runtime.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/branch-summarization-runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,gCAAgC,CACpD,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED,wBAAsB,uCAAuC,CAC3D,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAsB,kCAAkC,CACtD,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAe3C"}

package/lib/zhin-agent/branch-summarization-runtime.js

@@ -0,0 +1,58 @@
+/**
+ * Branch summarization on session tree switch — ADR 0010 D3.
+ */
+import { abandonedRowsToMessages, collectAbandonedPathRows, compactAgentMessages, estimateAgentMessagesTokens, getModel, } from '@zhin.js/ai';
+export async function summarizeAbandonedBranchIfNeeded(host, sessionId, oldLeafId, newLeafId, options = {}) {
+    const compaction = options.compactionConfig ?? host.config.compaction;
+    if (compaction?.enabled === false)
+        return;
+    if (oldLeafId == null || oldLeafId === newLeafId)
+        return;
+    if (await host.contextRepository.hasBranchSummary(sessionId, newLeafId))
+        return;
+    const allRows = await host.contextRepository.loadMessageRows(sessionId);
+    const abandoned = collectAbandonedPathRows(allRows, oldLeafId, newLeafId);
+    if (abandoned.length === 0)
+        return;
+    const messages = abandonedRowsToMessages(abandoned);
+    const keepRecentTokens = compaction?.keepRecentTokens ?? 20_000;
+    if (estimateAgentMessagesTokens(messages) <= keepRecentTokens)
+        return;
+    const provider = host.getTurnProvider();
+    const modelId = host.config.chatModel || provider.models[0] || '';
+    const llmModel = getModel(provider.name, modelId);
+    const contextWindow = options.contextWindow ?? llmModel.contextWindow ?? host.config.contextTokens;
+    const result = await compactAgentMessages({
+        model: llmModel,
+        messages,
+        contextWindow,
+        keepRecentTokens: Math.min(keepRecentTokens, Math.max(500, Math.floor(messages.length * 200))),
+        minKeepCount: 1,
+        customInstructions: 'Summarize this abandoned conversation branch so it can be recalled later if the user returns to it.',
+    });
+    if (!result.summary?.trim())
+        return;
+    await host.contextRepository.saveSummary(sessionId, result.summary, {
+        branchAnchorMessageId: newLeafId,
+    });
+}
+export async function switchActiveLeafWithBranchSummarization(host, sessionId, messageId, options = {}) {
+    const session = await host.agentSessionStore.getBySessionId(sessionId);
+    const oldLeaf = session?.active_leaf_message_id;
+    if (oldLeaf === messageId)
+        return true;
+    await summarizeAbandonedBranchIfNeeded(host, sessionId, oldLeaf, messageId, options);
+    return host.contextRepository.setActiveLeaf(sessionId, messageId);
+}
+export async function jumpToBranchIndexWithSummarization(host, sessionId, index, options = {}) {
+    const points = await host.contextRepository.listBranchPoints(sessionId);
+    const point = points.find(p => p.index === index);
+    if (!point) {
+        return { ok: false, message: `未找到分支点 #${index}` };
+    }
+    const ok = await switchActiveLeafWithBranchSummarization(host, sessionId, point.messageId, options);
+    return ok
+        ? { ok: true, message: `已跳转到分支点 #${index}：${point.preview}` }
+        : { ok: false, message: '跳转失败' };
+}
+//# sourceMappingURL=branch-summarization-runtime.js.map

package/lib/zhin-agent/branch-summarization-runtime.js.map

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

package/lib/zhin-agent/builtin-tools.d.ts

@@ -5,9 +5,10 @@
  * 由 ZhinAgent.process() 按需创建并注入到工具列表中。
  */
 import type { AgentTool } from '@zhin.js/core';
-import type { ChatHistoryContext, ChatHistoryQuery } from '@zhin.js/ai';
+import type { ImTranscriptQuery, ImTranscriptStore, MemoryImTranscriptStore } from '@zhin.js/ai';
 import type { UserProfileStore } from '../user-profile.js';
 export { createSpawnTaskTool } from '../builtin/spawn-task-tool.js';
-export declare function createChatHistoryTool(chatHistory: ChatHistoryContext, query: ChatHistoryQuery): AgentTool;
+type TranscriptHistoryReader = Pick<ImTranscriptStore, 'search' | 'listRecent'> | Pick<MemoryImTranscriptStore, 'search' | 'listRecent'>;
+export declare function createImTranscriptHistoryTool(store: TranscriptHistoryReader, query: ImTranscriptQuery): AgentTool;
 export declare function createUserProfileTool(userId: string, profiles: UserProfileStore): AgentTool;
 //# sourceMappingURL=builtin-tools.d.ts.map

package/lib/zhin-agent/builtin-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAwB,MAAM,aAAa,CAAC;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAyBpE,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE,gBAAgB,GACtB,SAAS,CAwCX;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAmD3F"}
+{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAyB,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACxH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAsBpE,KAAK,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,uBAAuB,EAAE,QAAQ,GAAG,YAAY,CAAC,CAAC;AAEzI,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,iBAAiB,GACvB,SAAS,CAwCX;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAqD3F"}

package/lib/zhin-agent/builtin-tools.js

@@ -5,30 +5,27 @@
  * 由 ZhinAgent.process() 按需创建并注入到工具列表中。
  */
 export { createSpawnTaskTool } from '../builtin/spawn-task-tool.js';
-function formatHitLine(hit) {
-    const role = hit.role === 'user' ? '用户' : '助手';
+function formatTranscriptHitLine(hit) {
+    const role = hit.direction === 'inbound' ? '用户' : '助手';
     const time = new Date(hit.time).toLocaleString('zh-CN');
-    const who = hit.senderName && hit.role === 'user' ? ` (${hit.senderName})` : '';
-    return `[${time}] ${role}${who}: ${hit.content}`;
+    const who = hit.senderName && hit.direction === 'inbound' ? ` (${hit.senderName})` : '';
+    return `[${time}] ${role}${who}: ${hit.body}`;
 }
-function formatToolResult(result, header) {
+function formatTranscriptToolResult(result, header) {
     let output = header;
-    if (result.summary) {
-        output += `\n\n📋 对话摘要：\n${result.summary}`;
-    }
     if (result.messages.length > 0) {
-        output += `\n\n💬 聊天记录：\n${result.messages.map(formatHitLine).join('\n')}`;
+        output += `\n\n💬 聊天记录：\n${result.messages.map(formatTranscriptHitLine).join('\n')}`;
     }
     else {
         output += '\n\n未找到相关聊天记录。';
     }
     return output;
 }
-export function createChatHistoryTool(chatHistory, query) {
+export function createImTranscriptHistoryTool(store, query) {
     return {
         name: 'chat_history',
         source: 'builtin:context',
-        description: '从数据库按需查询本场景历史聊天（platform+bot+群/私聊）。支持关键词模糊搜索；keyword 留空则返回最近若干条。当用户问「之前聊过什么」「我们讨论过什么」时使用。',
+        description: '从 im_transcripts 按需查询本场景历史聊天（platform+bot+群/私聊）。支持关键词模糊搜索 body；keyword 留空则返回最近若干条。当用户问「之前聊过什么」「我们讨论过什么」时使用。',
         parameters: {
             type: 'object',
             properties: {
@@ -50,11 +47,11 @@ export function createChatHistoryTool(chatHistory, query) {
                 ? Math.floor(args.limit)
                 : 10;
             if (keyword.trim()) {
-                const result = await chatHistory.searchMessages(query, keyword, limit);
-                return formatToolResult(result, `关键词「${keyword.trim()}」的搜索结果（最多 ${limit} 条）：`);
+                const result = await store.search(query, keyword, limit);
+                return formatTranscriptToolResult(result, `关键词「${keyword.trim()}」的搜索结果（最多 ${limit} 条）：`);
             }
-            const result = await chatHistory.listRecentMessages(query, limit);
-            return formatToolResult(result, `最近 ${limit} 条聊天记录：`);
+            const result = await store.listRecent(query, limit);
+            return formatTranscriptToolResult(result, `最近 ${limit} 条聊天记录：`);
         },
     };
 }
@@ -85,7 +82,9 @@ export function createUserProfileTool(userId, profiles) {
         tags: ['profile', '偏好', '用户', '个性化', '记住'],
         keywords: ['我叫', '我的名字', '记住我', '我喜欢', '我偏好', '我习惯', '叫我', '我是'],
         async execute(args) {
-            const { action, key, value } = 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);

package/lib/zhin-agent/builtin-tools.js.map

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

package/lib/zhin-agent/compaction-runtime.d.ts

@@ -0,0 +1,25 @@
+import { type ContextRepository, type Model } from '@zhin.js/ai';
+import type { AgentMessage } from '@zhin.js/ai';
+import type { CompactionConfig } from './config.js';
+import type { PluginAILoopHookRegistry } from '../plugin-loop-hooks.js';
+import type { ZhinAgentPrivate, ToolContext } from './zhin-agent-private.js';
+export interface CompactionRuntimeOptions {
+    host: ZhinAgentPrivate;
+    sessionId: string;
+    context: ToolContext;
+    model: Model;
+    compactionConfig?: CompactionConfig;
+    contextWindow: number;
+    mode?: 'text' | 'multimodal';
+    customInstructions?: string;
+    force?: boolean;
+    loopHooks?: PluginAILoopHookRegistry | null;
+}
+export declare function transformContextWithCompaction(messages: AgentMessage[], signal: AbortSignal | undefined, options: CompactionRuntimeOptions): Promise<AgentMessage[]>;
+export declare function manualCompactSession(repo: ContextRepository, options: Omit<CompactionRuntimeOptions, 'host'> & {
+    host: ZhinAgentPrivate;
+}): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=compaction-runtime.d.ts.map

package/lib/zhin-agent/compaction-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-runtime.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/compaction-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,KAAK,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE7E,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC7C;AA0BD,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,EAAE,CAAC,CAgDzB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,CAAC,GAAG;IAChD,IAAI,EAAE,gBAAgB,CAAC;CACxB,GACA,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB3C"}