@zhin.js/agent 0.1.30 → 0.1.31

package/lib/zhin-agent/model-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/model-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,aAAa,EAAE,aAAa,GAAG,IAAI,EACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,GAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAkB,EAC1D,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EAAE,EACxB,aAAa,EAAE,aAAa,GAAG,IAAI,EACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,GAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAkB,EAC1D,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,EAAE,CAqBV"}
+{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/model-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,aAAa,EAAE,aAAa,GAAG,IAAI,EACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,GAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAkB,EAC1D,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EAAE,EACxB,aAAa,EAAE,aAAa,GAAG,IAAI,EACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,GAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAkB,EAC1D,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,EAAE,CAqBV"}

package/lib/zhin-agent/model-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-resolver.js","sourceRoot":"","sources":["../../src/zhin-agent/model-resolver.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,YAAY,CAC1B,cAAwB,EACxB,aAAmC,EACnC,YAAoB,EACpB,MAA2B,EAC3B,OAAoD,MAAM,EAC1D,SAAkB;IAElB,OAAO,sBAAsB,CAAC,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,cAAwB,EACxB,aAAmC,EACnC,YAAoB,EACpB,MAA2B,EAC3B,OAAoD,MAAM,EAC1D,SAAkB;IAElB,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,IAAI,SAAS;QAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAClF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACxF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,aAAa,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE1E,OAAO,UAAU,CAAC;AACpB,CAAC"}
+{"version":3,"file":"model-resolver.js","sourceRoot":"","sources":["../../src/zhin-agent/model-resolver.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,YAAY,CAC1B,cAAwB,EACxB,aAAmC,EACnC,YAAoB,EACpB,MAA2B,EAC3B,OAAoD,MAAM,EAC1D,SAAkB;IAElB,OAAO,sBAAsB,CAAC,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,cAAwB,EACxB,aAAmC,EACnC,YAAoB,EACpB,MAA2B,EAC3B,OAAoD,MAAM,EAC1D,SAAkB;IAElB,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,IAAI,SAAS;QAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAClF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACxF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,aAAa,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE1E,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/lib/zhin-agent/multimodal-message.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ContentPart[] → agentLoop UserMessage（ADR 0009 D2：image blocks）
+ */
+import type { ContentPart, UserMessage } from '@zhin.js/ai';
+/** 从 ContentPart 拼会话可见文本（含 [图片] 等占位） */
+export declare function summarizeMultimodalParts(parts: ContentPart[], supportsVision: boolean): string;
+/** 构建带 image blocks 的 UserMessage（vision 模型走 agentLoop） */
+export declare function buildVisionUserMessage(sessionUserContent: string, parts: ContentPart[], supportsVision: boolean, maxFileBytes: number): Promise<UserMessage>;
+//# sourceMappingURL=multimodal-message.d.ts.map

package/lib/zhin-agent/multimodal-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multimodal-message.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/multimodal-message.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAgB,WAAW,EAAE,MAAM,aAAa,CAAC;AA0B1E,wCAAwC;AACxC,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,EAAE,EACpB,cAAc,EAAE,OAAO,GACtB,MAAM,CAsBR;AAED,2DAA2D;AAC3D,wBAAsB,sBAAsB,CAC1C,kBAAkB,EAAE,MAAM,EAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,cAAc,EAAE,OAAO,EACvB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,CAyBtB"}

package/lib/zhin-agent/multimodal-message.js

@@ -0,0 +1,69 @@
+import { createUserMessage } from '@zhin.js/ai';
+import { normalizeContentPartsToPayloads } from '../media/media-normalize.js';
+function parseDataUri(dataUri) {
+    const m = /^data:([^;]+);base64,(.+)$/i.exec(dataUri.trim());
+    if (!m)
+        return null;
+    return { mime: m[1], base64: m[2] };
+}
+function imageUrlToContent(url) {
+    const parsed = parseDataUri(url);
+    if (parsed) {
+        return { type: 'image', data: parsed.base64, mimeType: parsed.mime };
+    }
+    if (url.startsWith('http://') || url.startsWith('https://')) {
+        return { type: 'image', data: url, mimeType: 'image/jpeg' };
+    }
+    return null;
+}
+/** 从 ContentPart 拼会话可见文本（含 [图片] 等占位） */
+export function summarizeMultimodalParts(parts, supportsVision) {
+    const fragments = [];
+    for (const p of parts) {
+        switch (p.type) {
+            case 'text':
+                fragments.push(p.text);
+                break;
+            case 'image_url':
+                fragments.push('[图片]');
+                break;
+            case 'video_url':
+                fragments.push('[视频]');
+                break;
+            case 'audio':
+                fragments.push('[音频]');
+                break;
+            case 'face':
+                fragments.push(p.face.text || `[表情:${p.face.id}]`);
+                break;
+        }
+    }
+    return fragments.join(' ') || '[多模态消息]';
+}
+/** 构建带 image blocks 的 UserMessage（vision 模型走 agentLoop） */
+export async function buildVisionUserMessage(sessionUserContent, parts, supportsVision, maxFileBytes) {
+    const images = [];
+    if (supportsVision) {
+        const payloads = await normalizeContentPartsToPayloads(parts, maxFileBytes);
+        for (const payload of payloads) {
+            if (payload.kind === 'image') {
+                images.push({
+                    type: 'image',
+                    data: payload.base64,
+                    mimeType: payload.mimeType,
+                });
+            }
+        }
+        if (images.length === 0) {
+            for (const p of parts) {
+                if (p.type !== 'image_url')
+                    continue;
+                const block = imageUrlToContent(p.image_url.url);
+                if (block)
+                    images.push(block);
+            }
+        }
+    }
+    return createUserMessage(sessionUserContent, images.length > 0 ? images : undefined);
+}
+//# sourceMappingURL=multimodal-message.js.map

package/lib/zhin-agent/multimodal-message.js.map

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

package/lib/zhin-agent/prompt-access.d.ts

@@ -0,0 +1,4 @@
+export declare class PromptAccessDeniedError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=prompt-access.d.ts.map

package/lib/zhin-agent/prompt-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-access.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/prompt-access.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B"}

package/lib/zhin-agent/prompt-access.js

@@ -0,0 +1,7 @@
+export class PromptAccessDeniedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PromptAccessDeniedError';
+    }
+}
+//# sourceMappingURL=prompt-access.js.map

package/lib/zhin-agent/prompt-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-access.js","sourceRoot":"","sources":["../../src/zhin-agent/prompt-access.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/lib/zhin-agent/prompt-controller.d.ts

@@ -0,0 +1,53 @@
+import type { AgentEvent, AgentMessage, QueueMode } from '@zhin.js/ai';
+import type { ToolContext } from '../orchestrator/types.js';
+import type { OnChunkCallback } from './config.js';
+import type { AgentLoopTurnResult } from './agent-loop-turn.js';
+export interface PromptTurnHooks {
+    getSteeringMessages: () => Promise<AgentMessage[]>;
+    getFollowUpMessages: () => Promise<AgentMessage[]>;
+}
+export interface PromptTurnRequest {
+    sessionKey: string;
+    sessionId: string;
+    userMessages: AgentMessage[];
+    context: ToolContext;
+    onChunk?: OnChunkCallback;
+    execute: (initialMessages: AgentMessage[], hooks: PromptTurnHooks, signal: AbortSignal, turnId: string) => Promise<AgentLoopTurnResult>;
+}
+type PromptSubscriber = (event: AgentEvent, signal: AbortSignal) => void | Promise<void>;
+export declare class PromptController {
+    private readonly steeringMode;
+    private readonly followUpMode;
+    private readonly subscribers;
+    private readonly activeTurns;
+    private readonly latestTurnBySession;
+    private idleWaiters;
+    private lastResult;
+    constructor(steeringMode: QueueMode, followUpMode: QueueMode);
+    isIdle(): boolean;
+    isBusy(): boolean;
+    getActiveTurnCount(): number;
+    getActiveSessionKey(): string | null;
+    getActiveContext(): ToolContext | null;
+    getLastResult(): AgentLoopTurnResult | null;
+    subscribe(listener: PromptSubscriber): () => void;
+    waitForIdle(): Promise<void>;
+    /** Abort all active turns (optionally scoped to one session). */
+    abort(sessionKey?: string): void;
+    clearSteeringQueue(sessionKey?: string): void;
+    clearFollowUpQueue(sessionKey?: string): void;
+    /** Master-only: inject into the latest active turn on this session. */
+    steer(sessionKey: string, message: AgentMessage | AgentMessage[]): void;
+    /** Master-only: queue continuation on the latest active turn. */
+    followUp(sessionKey: string, message: AgentMessage | AgentMessage[]): void;
+    /** Parallel scheduling: each inbound message spawns an independent turn. */
+    schedule(request: PromptTurnRequest): Promise<AgentLoopTurnResult>;
+    private resolveLatestTurn;
+    private notifyIdle;
+    private emitEvent;
+    private promoteLatestTurn;
+    private demoteLatestTurn;
+    private runTurn;
+}
+export {};
+//# sourceMappingURL=prompt-controller.d.ts.map

package/lib/zhin-agent/prompt-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-controller.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/prompt-controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,MAAM,WAAW,eAAe;IAC9B,mBAAmB,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACnD,mBAAmB,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,CACP,eAAe,EAAE,YAAY,EAAE,EAC/B,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnC;AAED,KAAK,gBAAgB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAUzF,qBAAa,gBAAgB;IAQzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAR/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAC7D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;IACjE,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,UAAU,CAAoC;gBAGnC,YAAY,EAAE,SAAS,EACvB,YAAY,EAAE,SAAS;IAG1C,MAAM,IAAI,OAAO;IAIjB,MAAM,IAAI,OAAO;IAIjB,kBAAkB,IAAI,MAAM;IAI5B,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAKpC,gBAAgB,IAAI,WAAW,GAAG,IAAI;IAMtC,aAAa,IAAI,mBAAmB,GAAG,IAAI;IAI3C,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAO3C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlC,iEAAiE;IACjE,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAOhC,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAO7C,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAO7C,uEAAuE;IACvE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,GAAG,IAAI;IAQvE,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,GAAG,IAAI;IAQ1E,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIlE,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,UAAU;YAQJ,SAAS;IAMvB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,gBAAgB;YAWV,OAAO;CA+CtB"}

package/lib/zhin-agent/prompt-controller.js

@@ -0,0 +1,165 @@
+import { randomUUID } from 'node:crypto';
+import { SessionMessageQueue } from './session-message-queue.js';
+export class PromptController {
+    steeringMode;
+    followUpMode;
+    subscribers = new Set();
+    activeTurns = new Map();
+    latestTurnBySession = new Map();
+    idleWaiters = [];
+    lastResult = null;
+    constructor(steeringMode, followUpMode) {
+        this.steeringMode = steeringMode;
+        this.followUpMode = followUpMode;
+    }
+    isIdle() {
+        return this.activeTurns.size === 0;
+    }
+    isBusy() {
+        return this.activeTurns.size > 0;
+    }
+    getActiveTurnCount() {
+        return this.activeTurns.size;
+    }
+    getActiveSessionKey() {
+        const latest = [...this.latestTurnBySession.entries()].at(-1);
+        return latest?.[0] ?? null;
+    }
+    getActiveContext() {
+        const turnId = [...this.latestTurnBySession.values()].at(-1);
+        if (!turnId)
+            return null;
+        return this.activeTurns.get(turnId)?.context ?? null;
+    }
+    getLastResult() {
+        return this.lastResult;
+    }
+    subscribe(listener) {
+        this.subscribers.add(listener);
+        return () => {
+            this.subscribers.delete(listener);
+        };
+    }
+    async waitForIdle() {
+        if (this.isIdle())
+            return;
+        await new Promise((resolve) => {
+            this.idleWaiters.push(resolve);
+        });
+    }
+    /** Abort all active turns (optionally scoped to one session). */
+    abort(sessionKey) {
+        for (const turn of this.activeTurns.values()) {
+            if (sessionKey && turn.sessionKey !== sessionKey)
+                continue;
+            turn.abortController.abort();
+        }
+    }
+    clearSteeringQueue(sessionKey) {
+        for (const turn of this.activeTurns.values()) {
+            if (sessionKey && turn.sessionKey !== sessionKey)
+                continue;
+            turn.queue.clearSteering();
+        }
+    }
+    clearFollowUpQueue(sessionKey) {
+        for (const turn of this.activeTurns.values()) {
+            if (sessionKey && turn.sessionKey !== sessionKey)
+                continue;
+            turn.queue.clearFollowUp();
+        }
+    }
+    /** Master-only: inject into the latest active turn on this session. */
+    steer(sessionKey, message) {
+        const turn = this.resolveLatestTurn(sessionKey);
+        if (!turn) {
+            throw new Error('steer requires an active turn on the same session');
+        }
+        turn.queue.pushSteering(message);
+    }
+    /** Master-only: queue continuation on the latest active turn. */
+    followUp(sessionKey, message) {
+        const turn = this.resolveLatestTurn(sessionKey);
+        if (!turn) {
+            throw new Error('followUp requires an active turn on the same session');
+        }
+        turn.queue.pushFollowUp(message);
+    }
+    /** Parallel scheduling: each inbound message spawns an independent turn. */
+    schedule(request) {
+        return this.runTurn(request);
+    }
+    resolveLatestTurn(sessionKey) {
+        const turnId = this.latestTurnBySession.get(sessionKey);
+        if (!turnId)
+            return undefined;
+        return this.activeTurns.get(turnId);
+    }
+    notifyIdle() {
+        if (!this.isIdle())
+            return;
+        const waiters = this.idleWaiters.splice(0);
+        for (const resolve of waiters) {
+            resolve();
+        }
+    }
+    async emitEvent(event, signal) {
+        for (const listener of this.subscribers) {
+            await listener(event, signal);
+        }
+    }
+    promoteLatestTurn(sessionKey, turnId) {
+        this.latestTurnBySession.set(sessionKey, turnId);
+    }
+    demoteLatestTurn(sessionKey, turnId) {
+        if (this.latestTurnBySession.get(sessionKey) !== turnId)
+            return;
+        this.latestTurnBySession.delete(sessionKey);
+        for (const [id, turn] of this.activeTurns) {
+            if (turn.sessionKey === sessionKey) {
+                this.latestTurnBySession.set(sessionKey, id);
+                return;
+            }
+        }
+    }
+    async runTurn(request) {
+        const turnId = randomUUID();
+        const abortController = new AbortController();
+        const signal = abortController.signal;
+        const queue = new SessionMessageQueue(this.steeringMode, this.followUpMode);
+        const activeTurn = {
+            turnId,
+            sessionKey: request.sessionKey,
+            context: request.context,
+            queue,
+            abortController,
+        };
+        this.activeTurns.set(turnId, activeTurn);
+        this.promoteLatestTurn(request.sessionKey, turnId);
+        let lastResult = null;
+        try {
+            await this.emitEvent({ type: 'agent_start' }, signal);
+            const hooks = {
+                getSteeringMessages: async () => queue.drainSteering(),
+                getFollowUpMessages: async () => queue.drainFollowUp(),
+            };
+            lastResult = await request.execute(request.userMessages, hooks, signal, turnId);
+            while (queue.hasFollowUp() && !signal.aborted) {
+                const batch = queue.drainFollowUp();
+                lastResult = await request.execute(batch, hooks, signal, turnId);
+            }
+            await this.emitEvent({ type: 'agent_end', messages: request.userMessages }, signal);
+            if (!lastResult) {
+                throw new Error('Prompt turn produced no result');
+            }
+            this.lastResult = lastResult;
+            return lastResult;
+        }
+        finally {
+            this.activeTurns.delete(turnId);
+            this.demoteLatestTurn(request.sessionKey, turnId);
+            this.notifyIdle();
+        }
+    }
+}
+//# sourceMappingURL=prompt-controller.js.map

package/lib/zhin-agent/prompt-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-controller.js","sourceRoot":"","sources":["../../src/zhin-agent/prompt-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AA+BjE,MAAM,OAAO,gBAAgB;IAQR;IACA;IARF,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzD,WAAW,GAAsB,EAAE,CAAC;IACpC,UAAU,GAA+B,IAAI,CAAC;IAEtD,YACmB,YAAuB,EACvB,YAAuB;QADvB,iBAAY,GAAZ,YAAY,CAAW;QACvB,iBAAY,GAAZ,YAAY,CAAW;IACvC,CAAC;IAEJ,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED,mBAAmB;QACjB,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED,gBAAgB;QACd,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC;IACvD,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,SAAS,CAAC,QAA0B;QAClC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,IAAI,CAAC,MAAM,EAAE;YAAE,OAAO;QAC1B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,UAAmB;QACvB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU;gBAAE,SAAS;YAC3D,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,UAAmB;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU;gBAAE,SAAS;YAC3D,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,UAAmB;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU;gBAAE,SAAS;YAC3D,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,UAAkB,EAAE,OAAsC;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,iEAAiE;IACjE,QAAQ,CAAC,UAAkB,EAAE,OAAsC;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,4EAA4E;IAC5E,QAAQ,CAAC,OAA0B;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAEO,iBAAiB,CAAC,UAAkB;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,OAAO;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3C,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,KAAiB,EAAE,MAAmB;QAC5D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAEO,iBAAiB,CAAC,UAAkB,EAAE,MAAc;QAC1D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAEO,gBAAgB,CAAC,UAAkB,EAAE,MAAc;QACzD,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM;YAAE,OAAO;QAChE,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACnC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBAC7C,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAA0B;QAC9C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAE5E,MAAM,UAAU,GAAe;YAC7B,MAAM;YACN,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK;YACL,eAAe;SAChB,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAEnD,IAAI,UAAU,GAA+B,IAAI,CAAC;QAElD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,CAAC;YAEtD,MAAM,KAAK,GAAoB;gBAC7B,mBAAmB,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE;gBACtD,mBAAmB,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE;aACvD,CAAC;YAEF,UAAU,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAEhF,OAAO,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;gBACpC,UAAU,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACnE,CAAC;YAED,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,CAAC;YAEpF,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YAED,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;YAC7B,OAAO,UAAU,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;CACF"}

package/lib/zhin-agent/prompt-input.d.ts

@@ -0,0 +1,3 @@
+import type { AgentMessage, ImageContent } from '@zhin.js/ai';
+export declare function normalizePromptMessages(input: string | AgentMessage | AgentMessage[], images?: ImageContent[]): AgentMessage[];
+//# sourceMappingURL=prompt-input.d.ts.map

package/lib/zhin-agent/prompt-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-input.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/prompt-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG9D,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,EAAE,EAC7C,MAAM,CAAC,EAAE,YAAY,EAAE,GACtB,YAAY,EAAE,CAKhB"}

package/lib/zhin-agent/prompt-input.js

@@ -0,0 +1,8 @@
+import { createUserMessage } from '@zhin.js/ai';
+export function normalizePromptMessages(input, images) {
+    if (typeof input === 'string') {
+        return [createUserMessage(input, images)];
+    }
+    return Array.isArray(input) ? input : [input];
+}
+//# sourceMappingURL=prompt-input.js.map

package/lib/zhin-agent/prompt-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-input.js","sourceRoot":"","sources":["../../src/zhin-agent/prompt-input.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,UAAU,uBAAuB,CACrC,KAA6C,EAC7C,MAAuB;IAEvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/lib/zhin-agent/session-io.d.ts

@@ -1,20 +1,25 @@
-import type { ChatMessage, ChatHistoryContext, ChatHistoryQuery, MemoryIMSessionStore, IMSessionStore, CreateIMSessionInput } from '@zhin.js/ai';
+import type { ChatMessage, MemoryIMSessionStore, IMSessionStore, MemoryAgentSessionStore, AgentSessionStore, ContextRepository, CreateIMSessionInput, CreateAgentSessionInput } from '@zhin.js/ai';
 import type { ToolContext } from '@zhin.js/core';
 export interface SessionIODeps {
-    chatHistory: ChatHistoryContext | null;
     imSessionStore: IMSessionStore | MemoryIMSessionStore;
+    agentSessionStore: AgentSessionStore | MemoryAgentSessionStore;
+    contextRepository: ContextRepository;
 }
 /**
  * 群/频道共享 session 写入时，为 user 消息附加结构化发言者前缀
  */
 export declare function formatUserContentForSession(context: Pick<ToolContext, 'scope' | 'senderId' | 'roles' | 'message'>, rawContent: string): string;
-export declare function buildSessionCreateInput(sessionKey: string, context: Pick<ToolContext, 'platform' | 'botId' | 'scope' | 'sceneId'>): CreateIMSessionInput;
-export declare function buildChatHistoryQuery(sessionId: string, context: Pick<ToolContext, 'platform' | 'botId' | 'sceneId'>): ChatHistoryQuery;
-export declare function buildHistoryMessages(deps: SessionIODeps, sessionId: string, context: Pick<ToolContext, 'platform' | 'botId' | 'sceneId'>, currentUserContent: string): Promise<ChatMessage[]>;
+export declare function buildSessionCreateInput(sessionKey: string, context: Pick<ToolContext, 'platform' | 'botId' | 'scope' | 'sceneId'>): CreateIMSessionInput & CreateAgentSessionInput;
+export declare function buildImTranscriptQuery(context: Pick<ToolContext, 'platform' | 'botId' | 'sceneId'>): import('@zhin.js/ai').ImTranscriptQuery;
+export declare function buildHistoryMessagesFromContext(deps: SessionIODeps, sessionId: string, currentUserContent: string): Promise<ChatMessage[]>;
 /**
  * 在 `getOrCreateActive` 之前调用：是否视为新会话纪元（用于 ai.session.new）。
- * 须在 beginTurnSession 之前判定，否则同轮创建会令 hasAnySession 恒为 true。
  */
-export declare function resolveSessionIsNewBeforeCreate(deps: SessionIODeps, sessionKey: string, context: Pick<ToolContext, 'platform' | 'botId' | 'sceneId'>): Promise<boolean>;
+export declare function resolveSessionIsNewBeforeCreate(deps: SessionIODeps, sessionKey: string): Promise<boolean>;
+export declare function beginTurnSession(deps: SessionIODeps, sessionKey: string, context: Pick<ToolContext, 'platform' | 'botId' | 'scope' | 'sceneId'>): Promise<{
+    sessionKey: string;
+    sessionId: string;
+}>;
 export declare function touchSession(deps: SessionIODeps, sessionId: string): Promise<void>;
+export declare function archiveSessionByKey(deps: SessionIODeps, sessionKey: string): Promise<boolean>;
 //# sourceMappingURL=session-io.d.ts.map

package/lib/zhin-agent/session-io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-io.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/session-io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,eAAe,CAAC;AAM7D,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvC,cAAc,EAAE,cAAc,GAAG,oBAAoB,CAAC;CACvD;AAcD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC,EACtE,UAAU,EAAE,MAAM,GACjB,MAAM,CAUR;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC,GACrE,oBAAoB,CAQtB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC,GAC3D,gBAAgB,CAOlB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC,EAC5D,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,WAAW,EAAE,CAAC,CAQxB;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC,GAC3D,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf"}
+{"version":3,"file":"session-io.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/session-io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,cAAc,GAAG,oBAAoB,CAAC;IACtD,iBAAiB,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC/D,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAcD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC,EACtE,UAAU,EAAE,MAAM,GACjB,MAAM,CAUR;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC,GACrE,oBAAoB,GAAG,uBAAuB,CAQhD;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC,GAC3D,OAAO,aAAa,EAAE,iBAAiB,CAMzC;AAED,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,WAAW,EAAE,CAAC,CAIxB;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC,GACrE,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAIpD;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/lib/zhin-agent/session-io.js

@@ -1,3 +1,4 @@
+import { agentMessagesToOpenAi } from '@zhin.js/ai';
 import { formatSenderRolesForLabel, stripUserSpoofedSenderPrefix, } from '@zhin.js/core';
 function sanitizeSenderAttr(value) {
     const trimmed = value.trim().replace(/[\]\s]+/g, '_');
@@ -33,33 +34,35 @@ export function buildSessionCreateInput(sessionKey, context) {
         scene_type: context.scope || 'private',
     };
 }
-export function buildChatHistoryQuery(sessionId, context) {
+export function buildImTranscriptQuery(context) {
     return {
-        sessionId,
         platform: context.platform || '',
         botId: context.botId || '',
         sceneId: context.sceneId || '',
     };
 }
-export async function buildHistoryMessages(deps, sessionId, context, currentUserContent) {
-    const history = deps.chatHistory != null
-        ? await deps.chatHistory.buildHistoryMessages(buildChatHistoryQuery(sessionId, context))
-        : [];
+export async function buildHistoryMessagesFromContext(deps, sessionId, currentUserContent) {
+    const loaded = await deps.contextRepository.loadContext(sessionId);
+    const history = agentMessagesToOpenAi(loaded.messages);
     return [...history, { role: 'user', content: currentUserContent }];
 }
 /**
  * 在 `getOrCreateActive` 之前调用：是否视为新会话纪元（用于 ai.session.new）。
- * 须在 beginTurnSession 之前判定，否则同轮创建会令 hasAnySession 恒为 true。
  */
-export async function resolveSessionIsNewBeforeCreate(deps, sessionKey, context) {
-    if (await deps.imSessionStore.hasAnySession(sessionKey))
-        return false;
-    if (!deps.chatHistory)
-        return true;
-    const hasMessages = await deps.chatHistory.hasStoredMessages(buildChatHistoryQuery('new-check', context));
-    return !hasMessages;
+export async function resolveSessionIsNewBeforeCreate(deps, sessionKey) {
+    const active = await deps.agentSessionStore.findActive(sessionKey);
+    return !active;
+}
+export async function beginTurnSession(deps, sessionKey, context) {
+    const input = buildSessionCreateInput(sessionKey, context);
+    const record = await deps.agentSessionStore.getOrCreateActive(input);
+    return { sessionKey, sessionId: record.session_id };
 }
 export async function touchSession(deps, sessionId) {
-    await deps.imSessionStore.touch(sessionId);
+    await deps.agentSessionStore.touch(sessionId);
+}
+export async function archiveSessionByKey(deps, sessionKey) {
+    await deps.contextRepository.archiveSession(sessionKey);
+    return deps.agentSessionStore.archiveByKey(sessionKey);
 }
 //# sourceMappingURL=session-io.js.map

package/lib/zhin-agent/session-io.js.map

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

package/lib/zhin-agent/session-message-queue.d.ts

@@ -0,0 +1,20 @@
+import type { AgentMessage } from '@zhin.js/ai';
+import type { QueueMode } from '@zhin.js/ai';
+/** Per-sessionKey steering / follow-up queues (ADR 0009 D6 / Grill #13). */
+export declare class SessionMessageQueue {
+    readonly steeringMode: QueueMode;
+    readonly followUpMode: QueueMode;
+    private steering;
+    private followUp;
+    constructor(steeringMode: QueueMode, followUpMode: QueueMode);
+    pushSteering(input: AgentMessage | AgentMessage[]): void;
+    pushFollowUp(input: AgentMessage | AgentMessage[]): void;
+    drainSteering(): AgentMessage[];
+    drainFollowUp(): AgentMessage[];
+    clearSteering(): void;
+    clearFollowUp(): void;
+    hasFollowUp(): boolean;
+    steeringDepth(): number;
+    followUpDepth(): number;
+}
+//# sourceMappingURL=session-message-queue.d.ts.map

package/lib/zhin-agent/session-message-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-message-queue.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/session-message-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,4EAA4E;AAC5E,qBAAa,mBAAmB;IAK5B,QAAQ,CAAC,YAAY,EAAE,SAAS;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS;IALlC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,QAAQ,CAAsB;gBAG3B,YAAY,EAAE,SAAS,EACvB,YAAY,EAAE,SAAS;IAGlC,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,GAAG,IAAI;IAIxD,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,GAAG,IAAI;IAIxD,aAAa,IAAI,YAAY,EAAE;IAQ/B,aAAa,IAAI,YAAY,EAAE;IAQ/B,aAAa,IAAI,IAAI;IAIrB,aAAa,IAAI,IAAI;IAIrB,WAAW,IAAI,OAAO;IAItB,aAAa,IAAI,MAAM;IAIvB,aAAa,IAAI,MAAM;CAGxB"}

package/lib/zhin-agent/session-message-queue.js

@@ -0,0 +1,52 @@
+function normalizeMessages(input) {
+    return Array.isArray(input) ? input : [input];
+}
+/** Per-sessionKey steering / follow-up queues (ADR 0009 D6 / Grill #13). */
+export class SessionMessageQueue {
+    steeringMode;
+    followUpMode;
+    steering = [];
+    followUp = [];
+    constructor(steeringMode, followUpMode) {
+        this.steeringMode = steeringMode;
+        this.followUpMode = followUpMode;
+    }
+    pushSteering(input) {
+        this.steering.push(...normalizeMessages(input));
+    }
+    pushFollowUp(input) {
+        this.followUp.push(...normalizeMessages(input));
+    }
+    drainSteering() {
+        if (this.steering.length === 0)
+            return [];
+        if (this.steeringMode === 'all') {
+            return this.steering.splice(0);
+        }
+        return this.steering.splice(0, 1);
+    }
+    drainFollowUp() {
+        if (this.followUp.length === 0)
+            return [];
+        if (this.followUpMode === 'all') {
+            return this.followUp.splice(0);
+        }
+        return this.followUp.splice(0, 1);
+    }
+    clearSteering() {
+        this.steering = [];
+    }
+    clearFollowUp() {
+        this.followUp = [];
+    }
+    hasFollowUp() {
+        return this.followUp.length > 0;
+    }
+    steeringDepth() {
+        return this.steering.length;
+    }
+    followUpDepth() {
+        return this.followUp.length;
+    }
+}
+//# sourceMappingURL=session-message-queue.js.map

package/lib/zhin-agent/session-message-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-message-queue.js","sourceRoot":"","sources":["../../src/zhin-agent/session-message-queue.ts"],"names":[],"mappings":"AAGA,SAAS,iBAAiB,CAAC,KAAoC;IAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,4EAA4E;AAC5E,MAAM,OAAO,mBAAmB;IAKnB;IACA;IALH,QAAQ,GAAmB,EAAE,CAAC;IAC9B,QAAQ,GAAmB,EAAE,CAAC;IAEtC,YACW,YAAuB,EACvB,YAAuB;QADvB,iBAAY,GAAZ,YAAY,CAAW;QACvB,iBAAY,GAAZ,YAAY,CAAW;IAC/B,CAAC;IAEJ,YAAY,CAAC,KAAoC;QAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,YAAY,CAAC,KAAoC;QAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,aAAa;QACX,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,aAAa;QACX,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"tool-calls-user-format.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/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;AAwED;;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"}
+{"version":3,"file":"tool-calls-user-format.d.ts","sourceRoot":"","sources":["../../src/zhin-agent/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"}

package/lib/zhin-agent/tool-calls-user-format.js

@@ -36,6 +36,9 @@ function formatRunDeferredTaskResult(result) {
     const raw = asString(result);
     const parsed = parseRunDeferredPayload(raw);
     if (parsed) {
+        if (parsed.status === 'delegated') {
+            return undefined;
+        }
         if (parsed.status === 'error') {
             return parsed.error || '子任务执行失败。';
         }