@zhin.js/agent 0.3.1 → 1.0.2

package/lib/tool-catalog/types.js

@@ -0,0 +1,18 @@
+export const DEFAULT_ALWAYS_LOADED_TOOLS = [
+    'ask_user',
+    'spawn_task',
+    'discover',
+    'load_tool',
+    'load_skill',
+];
+export const DEFAULT_DEFERRED_TOOLS_CONFIG = {
+    maxLoadedPerSession: 12,
+    discoverTopK: 5,
+    alwaysLoadedTools: [...DEFAULT_ALWAYS_LOADED_TOOLS],
+};
+export const DEFERRED_META_TOOL_NAMES = new Set([
+    'discover',
+    'load_tool',
+    'load_skill',
+]);
+//# sourceMappingURL=types.js.map

package/lib/tool-catalog/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tool-catalog/types.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,UAAU;IACV,YAAY;IACZ,UAAU;IACV,WAAW;IACX,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,6BAA6B,GAAsG;IAC9I,mBAAmB,EAAE,EAAE;IACvB,YAAY,EAAE,CAAC;IACf,iBAAiB,EAAE,CAAC,GAAG,2BAA2B,CAAC;CACpD,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IAC9C,UAAU;IACV,WAAW;IACX,YAAY;CACb,CAAC,CAAC"}

package/lib/turn/auto-continue.d.ts

@@ -0,0 +1,18 @@
+import type { Message } from '../orchestrator/types.js';
+import type { SubagentCompletePayload, SubagentResultSender } from '../subagent/index.js';
+import type { DeferredWorkerResult } from '../deferred-worker-runner.js';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import type { PromptController } from './prompt-controller.js';
+import type { ZhinAgentConfig } from '../config/index.js';
+export interface AutoContinueHost {
+    config: Required<ZhinAgentConfig>;
+    promptController: PromptController;
+    getDeferredAutoContinueDepth(sessionKey: string): number;
+    setDeferredAutoContinueDepth(sessionKey: string, depth: number): void;
+    resetDeferredAutoContinueDepth(sessionKey: string): void;
+    getDeferredResultSender(): SubagentResultSender | null;
+    runInTurnContext<T>(turnId: string, fn: () => Promise<T>): Promise<T>;
+}
+export declare function continueAfterDeferredWorker(host: AutoContinueHost, agent: ZhinAgentPrivate, commMessage: Message, taskId: string, goal: string, result: DeferredWorkerResult): Promise<void>;
+export declare function continueAfterSubagent(host: AutoContinueHost, agent: ZhinAgentPrivate, payload: SubagentCompletePayload): Promise<void>;
+//# sourceMappingURL=auto-continue.d.ts.map

package/lib/turn/auto-continue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-continue.d.ts","sourceRoot":"","sources":["../../src/turn/auto-continue.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAQzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAClC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACzD,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtE,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,uBAAuB,IAAI,oBAAoB,GAAG,IAAI,CAAC;IACvD,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACvE;AA2CD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/lib/turn/auto-continue.js

@@ -0,0 +1,76 @@
+import { randomUUID } from 'node:crypto';
+import { formatCompact, Logger } from '@zhin.js/logger';
+import { resolveAgentTurnSessionKey } from '../collaboration/resolve-agent-session-key.js';
+import { deliverDeferredAutoContinueReply } from './deferred-delivery.js';
+import { buildDeferredAutoContinueUserMessage, shouldDeferredAutoContinue } from './deferred-auto-continue.js';
+import { buildSubagentAutoContinueUserMessage } from './subagent-auto-continue.js';
+import { persistSubagentResultToContext } from './persist-subagent-context.js';
+import { persistDeferredWorkerResultToContext } from './persist-deferred-context.js';
+import { processTextTurn } from './turn-pipeline.js';
+const logger = new Logger(null, 'ZhinAgent');
+async function executeAutoContinueTurn(host, agent, commMessage, sessionKey, taskId, depth, kind, buildMessage) {
+    await host.promptController.waitForIdle();
+    host.setDeferredAutoContinueDepth(sessionKey, depth + 1);
+    logger.info(formatCompact({
+        [kind]: 'auto_continue',
+        task_id: taskId,
+        depth: depth + 1,
+    }));
+    const elements = await host.runInTurnContext(randomUUID(), () => processTextTurn(agent, '', commMessage, [], undefined, {
+        prebuiltMessages: [buildMessage()],
+        deferredAutoContinue: true,
+    }));
+    const sender = host.getDeferredResultSender();
+    if (sender && elements.length > 0) {
+        await deliverDeferredAutoContinueReply(sender, commMessage, elements);
+    }
+    logger.info(formatCompact({
+        [kind]: 'auto_continue_done',
+        task_id: taskId,
+        depth: depth + 1,
+        outbound: elements.length,
+    }));
+}
+export async function continueAfterDeferredWorker(host, agent, commMessage, taskId, goal, result) {
+    const sessionKey = resolveAgentTurnSessionKey(commMessage);
+    const depth = host.getDeferredAutoContinueDepth(sessionKey);
+    const persisted = await persistDeferredWorkerResultToContext(agent, commMessage, taskId, goal, result);
+    if (!shouldDeferredAutoContinue(host.config, result, depth, persisted)) {
+        logger.warn(formatCompact({
+            deferred: 'auto_continue_skipped',
+            task_id: taskId,
+            depth,
+            persisted,
+            status: result.status,
+        }));
+        return;
+    }
+    await executeAutoContinueTurn(host, agent, commMessage, sessionKey, taskId, depth, 'deferred', () => buildDeferredAutoContinueUserMessage(taskId, goal, result.status));
+}
+export async function continueAfterSubagent(host, agent, payload) {
+    if (host.config.subagentAutoContinue === false)
+        return;
+    const commMessage = payload.origin.message;
+    const sessionKey = resolveAgentTurnSessionKey(commMessage);
+    const depth = host.getDeferredAutoContinueDepth(sessionKey);
+    if (depth >= host.config.deferredAutoContinueMaxDepth) {
+        logger.warn(formatCompact({
+            subagent: 'auto_continue_skipped',
+            task_id: payload.taskId,
+            reason: 'max_depth',
+            depth,
+        }));
+        return;
+    }
+    const persisted = await persistSubagentResultToContext(agent, commMessage, payload);
+    if (!persisted) {
+        logger.warn(formatCompact({
+            subagent: 'auto_continue_skipped',
+            task_id: payload.taskId,
+            reason: 'persist_failed',
+        }));
+        return;
+    }
+    await executeAutoContinueTurn(host, agent, commMessage, sessionKey, payload.taskId, depth, 'subagent', () => buildSubagentAutoContinueUserMessage(payload.taskId, payload.label, payload.status));
+}
+//# sourceMappingURL=auto-continue.js.map

package/lib/turn/auto-continue.js.map

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

package/lib/turn/deferred-auto-continue.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Deferred worker 完成后自动唤醒主 Agent 续聊（方案 B）。
+ */
+import { type UserMessage } from '@zhin.js/ai';
+import type { DeferredWorkerResult } from '../deferred-worker-runner.js';
+import type { ZhinAgentConfig } from '../config/index.js';
+export declare const DEFERRED_AUTO_CONTINUE_MARKER = "[Deferred worker \u5B8C\u6210 \u2014 \u81EA\u52A8\u7EED\u804A]";
+export declare function isDeferredAutoContinueEnabled(config: Required<ZhinAgentConfig>, env?: NodeJS.ProcessEnv): boolean;
+export declare function shouldDeferredAutoContinue(config: Required<ZhinAgentConfig>, result: DeferredWorkerResult, depth: number, persisted: boolean, env?: NodeJS.ProcessEnv): boolean;
+export declare function buildDeferredAutoContinueUserMessage(taskId: string, goal: string, status: DeferredWorkerResult['status']): UserMessage;
+//# sourceMappingURL=deferred-auto-continue.d.ts.map

package/lib/turn/deferred-auto-continue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-auto-continue.d.ts","sourceRoot":"","sources":["../../src/turn/deferred-auto-continue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,eAAO,MAAM,6BAA6B,mEAAgC,CAAC;AAK3E,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAKT;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EACjC,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAMT;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACrC,WAAW,CAWb"}

package/lib/turn/deferred-auto-continue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-auto-continue.js","sourceRoot":"","sources":["../../src/turn/deferred-auto-continue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAoB,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,CAAC,MAAM,6BAA6B,GAAG,6BAA6B,CAAC;AAE3E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAErD,MAAM,UAAU,6BAA6B,CAC3C,MAAiC,EACjC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,GAAG,GAAG,GAAG,CAAC,2BAA2B,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,IAAI,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,MAAM,CAAC,oBAAoB,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAiC,EACjC,MAA4B,EAC5B,KAAa,EACb,SAAkB,EAClB,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,CAAC,6BAA6B,CAAC,MAAM,EAAE,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,IAAI,MAAM,CAAC,4BAA4B;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,MAAc,EACd,IAAY,EACZ,MAAsC;IAEtC,MAAM,KAAK,GAAG,2BAA2B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG;QACX,6BAA6B;QAC7B,MAAM,MAAM,MAAM,KAAK,EAAE;QACzB,aAAa,MAAM,GAAG;QACtB,8EAA8E;QAC9E,wDAAwD;QACxD,2BAA2B;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/lib/turn/deferred-delivery.d.ts

@@ -0,0 +1,9 @@
+import type { OutputElement } from '@zhin.js/ai';
+import type { DeferredWorkerResult } from '../deferred-worker-runner.js';
+import type { Message } from '../orchestrator/types.js';
+import type { SubagentResultSender } from '../subagent/index.js';
+export declare function extractDeferredBody(result: DeferredWorkerResult): string;
+export declare function deliverDeferredWorkerResult(sender: SubagentResultSender, commMessage: Message, goal: string, taskId: string, result: DeferredWorkerResult): Promise<void>;
+/** deferred auto-continue 完成后将主 Agent 续聊回复推送到 IM */
+export declare function deliverDeferredAutoContinueReply(sender: SubagentResultSender, commMessage: Message, elements: OutputElement[]): Promise<void>;
+//# sourceMappingURL=deferred-delivery.d.ts.map

package/lib/turn/deferred-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-delivery.d.ts","sourceRoot":"","sources":["../../src/turn/deferred-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAaxE;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,oBAAoB,EAC5B,WAAW,EAAE,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,oDAAoD;AACpD,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,oBAAoB,EAC5B,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/lib/turn/deferred-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-delivery.js","sourceRoot":"","sources":["../../src/turn/deferred-delivery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAEzE,MAAM,UAAU,mBAAmB,CAAC,MAA4B;IAC9D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAIvC,CAAC;QACF,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrD,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAA4B,EAC5B,WAAoB,EACpB,IAAY,EACZ,MAAc,EACd,MAA4B;IAE5B,MAAM,KAAK,GAAG,2BAA2B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,yBAAyB,CAAC;QACzC,KAAK,EAAE,YAAY,MAAM,IAAI,KAAK,EAAE;QACpC,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAClD,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;KAClC,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,MAA4B,EAC5B,WAAoB,EACpB,QAAyB;IAEzB,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO;IAC7B,MAAM,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/lib/turn/inbound-queue-config.d.ts

@@ -0,0 +1,14 @@
+import type { Message } from '../orchestrator/types.js';
+import type { InboundQueueConfig, InboundGroupQueueMode } from '../config/zhin-agent-config.js';
+export type { InboundQueueConfig, InboundGroupQueueMode } from '../config/zhin-agent-config.js';
+export interface ResolvedInboundQueueConfig {
+    groupMode: InboundGroupQueueMode;
+    ttlMs: number;
+    coalesceWindowMs: number;
+}
+export declare const DEFAULT_INBOUND_QUEUE_CONFIG: ResolvedInboundQueueConfig;
+export declare function normalizeInboundQueueConfig(raw?: InboundQueueConfig | null): ResolvedInboundQueueConfig;
+export declare function validateInboundQueueConfig(raw?: InboundQueueConfig | null): string[];
+export declare function isGroupOrChannelMessage(message: Message): boolean;
+export declare function shouldUseGroupFifoQueue(message: Message, config: ResolvedInboundQueueConfig): boolean;
+//# sourceMappingURL=inbound-queue-config.d.ts.map

package/lib/turn/inbound-queue-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-queue-config.d.ts","sourceRoot":"","sources":["../../src/turn/inbound-queue-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEhG,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEhG,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,4BAA4B,EAAE,0BAI1C,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,GAAG,CAAC,EAAE,kBAAkB,GAAG,IAAI,GAC9B,0BAA0B,CAS5B;AAED,wBAAgB,0BAA0B,CAAC,GAAG,CAAC,EAAE,kBAAkB,GAAG,IAAI,GAAG,MAAM,EAAE,CAgBpF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAGjE;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAET"}

package/lib/turn/inbound-queue-config.js

@@ -0,0 +1,39 @@
+export const DEFAULT_INBOUND_QUEUE_CONFIG = {
+    groupMode: 'supersede',
+    ttlMs: 180_000,
+    coalesceWindowMs: 30_000,
+};
+export function normalizeInboundQueueConfig(raw) {
+    const groupMode = raw?.groupMode === 'fifo' ? 'fifo' : 'supersede';
+    const ttlMs = typeof raw?.ttlMs === 'number' && raw.ttlMs >= 0
+        ? raw.ttlMs
+        : DEFAULT_INBOUND_QUEUE_CONFIG.ttlMs;
+    const coalesceWindowMs = typeof raw?.coalesceWindowMs === 'number' && raw.coalesceWindowMs >= 0
+        ? raw.coalesceWindowMs
+        : DEFAULT_INBOUND_QUEUE_CONFIG.coalesceWindowMs;
+    return { groupMode, ttlMs, coalesceWindowMs };
+}
+export function validateInboundQueueConfig(raw) {
+    const errors = [];
+    if (!raw)
+        return errors;
+    if (raw.groupMode !== undefined && raw.groupMode !== 'supersede' && raw.groupMode !== 'fifo') {
+        errors.push('ai.agent.inboundQueue.groupMode must be supersede or fifo');
+    }
+    if (raw.ttlMs !== undefined && (typeof raw.ttlMs !== 'number' || !Number.isFinite(raw.ttlMs) || raw.ttlMs < 0)) {
+        errors.push('ai.agent.inboundQueue.ttlMs must be a non-negative number');
+    }
+    if (raw.coalesceWindowMs !== undefined
+        && (typeof raw.coalesceWindowMs !== 'number' || !Number.isFinite(raw.coalesceWindowMs) || raw.coalesceWindowMs < 0)) {
+        errors.push('ai.agent.inboundQueue.coalesceWindowMs must be a non-negative number');
+    }
+    return errors;
+}
+export function isGroupOrChannelMessage(message) {
+    const kind = message.$channel?.type;
+    return kind === 'group' || kind === 'channel';
+}
+export function shouldUseGroupFifoQueue(message, config) {
+    return config.groupMode === 'fifo' && isGroupOrChannelMessage(message);
+}
+//# sourceMappingURL=inbound-queue-config.js.map

package/lib/turn/inbound-queue-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-queue-config.js","sourceRoot":"","sources":["../../src/turn/inbound-queue-config.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,4BAA4B,GAA+B;IACtE,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,gBAAgB,EAAE,MAAM;CACzB,CAAC;AAEF,MAAM,UAAU,2BAA2B,CACzC,GAA+B;IAE/B,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;IACnE,MAAM,KAAK,GAAG,OAAO,GAAG,EAAE,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC;QAC5D,CAAC,CAAC,GAAG,CAAC,KAAK;QACX,CAAC,CAAC,4BAA4B,CAAC,KAAK,CAAC;IACvC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,gBAAgB,KAAK,QAAQ,IAAI,GAAG,CAAC,gBAAgB,IAAI,CAAC;QAC7F,CAAC,CAAC,GAAG,CAAC,gBAAgB;QACtB,CAAC,CAAC,4BAA4B,CAAC,gBAAgB,CAAC;IAClD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAA+B;IACxE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO,MAAM,CAAC;IACxB,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,WAAW,IAAI,GAAG,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAC7F,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;QAC/G,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC3E,CAAC;IACD,IACE,GAAG,CAAC,gBAAgB,KAAK,SAAS;WAC/B,CAAC,OAAO,GAAG,CAAC,gBAAgB,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC,EACnH,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;IACpC,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAgB,EAChB,MAAkC;IAElC,OAAO,MAAM,CAAC,SAAS,KAAK,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACzE,CAAC"}

package/lib/turn/inbound-queue-runtime.d.ts

@@ -0,0 +1,15 @@
+import type { Message } from '../orchestrator/types.js';
+import type { ZhinAgentEventEmitter } from '../event/event-emitter.js';
+import { InboundTurnQueue } from './inbound-turn-queue.js';
+import { type ResolvedInboundQueueConfig } from './inbound-queue-config.js';
+import type { ZhinAgentConfig } from '../config/index.js';
+export declare function createInboundTurnQueue(config: Required<ZhinAgentConfig>, emitter: ZhinAgentEventEmitter): {
+    config: ResolvedInboundQueueConfig;
+    queue: InboundTurnQueue;
+};
+export declare function runWithInboundQueue<T>(commMessage: Message, inboundQueueConfig: ResolvedInboundQueueConfig, queue: InboundTurnQueue, opts: {
+    content?: string;
+    coalesce?: boolean;
+    run: (mergedContent: string) => Promise<T>;
+}): Promise<T>;
+//# sourceMappingURL=inbound-queue-runtime.d.ts.map

package/lib/turn/inbound-queue-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-queue-runtime.d.ts","sourceRoot":"","sources":["../../src/turn/inbound-queue-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EACjC,OAAO,EAAE,qBAAqB,GAC7B;IAAE,MAAM,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAiBjE;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,WAAW,EAAE,OAAO,EACpB,kBAAkB,EAAE,0BAA0B,EAC9C,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE;IACJ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5C,GACA,OAAO,CAAC,CAAC,CAAC,CAYZ"}

package/lib/turn/inbound-queue-runtime.js

@@ -0,0 +1,29 @@
+import { resolveIMSessionIdFromMessage } from '@zhin.js/core';
+import { InboundTurnQueue } from './inbound-turn-queue.js';
+import { normalizeInboundQueueConfig, shouldUseGroupFifoQueue, } from './inbound-queue-config.js';
+export function createInboundTurnQueue(config, emitter) {
+    const inboundQueueConfig = normalizeInboundQueueConfig(config.inboundQueue);
+    const queue = new InboundTurnQueue(inboundQueueConfig, {
+        emitQueuedStart: (commMessage, sessionKey) => {
+            emitter.emit('ai.activity.queued.start', emitter.createPayload(sessionKey, commMessage, 'text'));
+        },
+        emitQueuedClear: (commMessage, sessionKey) => {
+            emitter.emit('ai.activity.queued.clear', emitter.createPayload(sessionKey, commMessage, 'text'));
+        },
+    });
+    return { config: inboundQueueConfig, queue };
+}
+export async function runWithInboundQueue(commMessage, inboundQueueConfig, queue, opts) {
+    if (!shouldUseGroupFifoQueue(commMessage, inboundQueueConfig)) {
+        return opts.run(opts.content ?? '');
+    }
+    const sessionKey = resolveIMSessionIdFromMessage(commMessage);
+    return queue.schedule({
+        sessionKey,
+        commMessage,
+        content: opts.content,
+        coalesce: opts.coalesce,
+        run: opts.run,
+    });
+}
+//# sourceMappingURL=inbound-queue-runtime.js.map

package/lib/turn/inbound-queue-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-queue-runtime.js","sourceRoot":"","sources":["../../src/turn/inbound-queue-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,GAExB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,UAAU,sBAAsB,CACpC,MAAiC,EACjC,OAA8B;IAE9B,MAAM,kBAAkB,GAAG,2BAA2B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,kBAAkB,EAAE;QACrD,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE;YAC3C,OAAO,CAAC,IAAI,CACV,0BAA0B,EAC1B,OAAO,CAAC,aAAa,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CACvD,CAAC;QACJ,CAAC;QACD,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE;YAC3C,OAAO,CAAC,IAAI,CACV,0BAA0B,EAC1B,OAAO,CAAC,aAAa,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CACvD,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAoB,EACpB,kBAA8C,EAC9C,KAAuB,EACvB,IAIC;IAED,IAAI,CAAC,uBAAuB,CAAC,WAAW,EAAE,kBAAkB,CAAC,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,UAAU,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC,QAAQ,CAAC;QACpB,UAAU;QACV,WAAW;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;AACL,CAAC"}

package/lib/turn/inbound-turn-queue.d.ts

@@ -0,0 +1,29 @@
+import type { Message } from '../orchestrator/types.js';
+import type { ResolvedInboundQueueConfig } from './inbound-queue-config.js';
+export declare class InboundTurnExpiredError extends Error {
+    constructor(sessionKey: string);
+}
+export interface InboundQueueActivityEmitter {
+    emitQueuedStart(commMessage: Message, sessionKey: string): void;
+    emitQueuedClear(commMessage: Message, sessionKey: string): void;
+}
+export declare class InboundTurnQueue {
+    private config;
+    private activityEmitter;
+    private readonly queues;
+    private readonly inFlight;
+    constructor(config: ResolvedInboundQueueConfig, activityEmitter?: InboundQueueActivityEmitter);
+    updateConfig(config: ResolvedInboundQueueConfig): void;
+    schedule<T>(options: {
+        sessionKey: string;
+        commMessage: Message;
+        content?: string;
+        coalesce?: boolean;
+        run: (mergedContent: string) => Promise<T>;
+    }): Promise<T>;
+    dispose(): void;
+    private isExpired;
+    private discardExpired;
+    private pump;
+}
+//# sourceMappingURL=inbound-turn-queue.d.ts.map

package/lib/turn/inbound-turn-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-turn-queue.d.ts","sourceRoot":"","sources":["../../src/turn/inbound-turn-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,UAAU,EAAE,MAAM;CAI/B;AAgBD,MAAM,WAAW,2BAA2B;IAC1C,eAAe,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,eAAe,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACjE;AAOD,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,eAAe;IALzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmD;IAC1E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;gBAGnD,MAAM,EAAE,0BAA0B,EAClC,eAAe,GAAE,2BAAyC;IAGpE,YAAY,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI;IAItD,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,GAAG,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;KAC5C,GAAG,OAAO,CAAC,CAAC,CAAC;IAwDd,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,SAAS;YAIH,cAAc;YAgBd,IAAI;CAqCnB"}

package/lib/turn/inbound-turn-queue.js

@@ -0,0 +1,132 @@
+export class InboundTurnExpiredError extends Error {
+    constructor(sessionKey) {
+        super(`Inbound turn expired in queue for session ${sessionKey}`);
+        this.name = 'InboundTurnExpiredError';
+    }
+}
+const noopEmitter = {
+    emitQueuedStart() { },
+    emitQueuedClear() { },
+};
+export class InboundTurnQueue {
+    config;
+    activityEmitter;
+    queues = new Map();
+    inFlight = new Map();
+    constructor(config, activityEmitter = noopEmitter) {
+        this.config = config;
+        this.activityEmitter = activityEmitter;
+    }
+    updateConfig(config) {
+        this.config = config;
+    }
+    schedule(options) {
+        const { sessionKey, commMessage, run } = options;
+        const coalesceEnabled = options.coalesce !== false;
+        const content = options.content ?? '';
+        const senderId = String(commMessage.$sender?.id ?? 'unknown');
+        const now = Date.now();
+        const queue = this.queues.get(sessionKey) ?? [];
+        this.queues.set(sessionKey, queue);
+        if (coalesceEnabled && content && queue.length > 0) {
+            const tail = queue[queue.length - 1];
+            if (tail.senderId === senderId
+                && now - tail.lastEnqueuedAt < this.config.coalesceWindowMs) {
+                tail.textParts.push(content);
+                tail.lastEnqueuedAt = now;
+                tail.commMessage = commMessage;
+                tail.run = run;
+                void this.pump(sessionKey);
+                return tail.promise;
+            }
+        }
+        let resolve;
+        let reject;
+        const promise = new Promise((res, rej) => {
+            resolve = res;
+            reject = rej;
+        });
+        const entry = {
+            sessionKey,
+            senderId,
+            commMessage,
+            textParts: content ? [content] : [],
+            enqueuedAt: now,
+            lastEnqueuedAt: now,
+            coalesceEnabled,
+            promise,
+            run,
+            resolve,
+            reject,
+        };
+        queue.push(entry);
+        const shouldShowPending = this.inFlight.has(sessionKey) || queue.length > 1;
+        if (shouldShowPending) {
+            this.activityEmitter.emitQueuedStart(commMessage, sessionKey);
+        }
+        void this.pump(sessionKey);
+        return promise;
+    }
+    dispose() {
+        for (const queue of this.queues.values()) {
+            for (const entry of queue) {
+                this.activityEmitter.emitQueuedClear(entry.commMessage, entry.sessionKey);
+                entry.reject(new Error('InboundTurnQueue disposed'));
+            }
+        }
+        this.queues.clear();
+        this.inFlight.clear();
+    }
+    isExpired(entry, now) {
+        return this.config.ttlMs > 0 && entry.enqueuedAt + this.config.ttlMs < now;
+    }
+    async discardExpired(sessionKey) {
+        const queue = this.queues.get(sessionKey);
+        if (!queue?.length)
+            return;
+        const now = Date.now();
+        while (queue.length > 0 && this.isExpired(queue[0], now)) {
+            const expired = queue.shift();
+            this.activityEmitter.emitQueuedClear(expired.commMessage, sessionKey);
+            expired.reject(new InboundTurnExpiredError(sessionKey));
+        }
+        if (!queue.length) {
+            this.queues.delete(sessionKey);
+        }
+    }
+    async pump(sessionKey) {
+        if (this.inFlight.has(sessionKey))
+            return;
+        const runLoop = async () => {
+            while (true) {
+                await this.discardExpired(sessionKey);
+                const queue = this.queues.get(sessionKey);
+                if (!queue?.length) {
+                    this.queues.delete(sessionKey);
+                    return;
+                }
+                const entry = queue.shift();
+                if (!queue.length) {
+                    this.queues.delete(sessionKey);
+                }
+                this.activityEmitter.emitQueuedClear(entry.commMessage, sessionKey);
+                try {
+                    const merged = entry.textParts.filter(Boolean).join('\n');
+                    const result = await entry.run(merged);
+                    entry.resolve(result);
+                }
+                catch (error) {
+                    entry.reject(error);
+                }
+            }
+        };
+        const flight = runLoop().finally(() => {
+            if (this.inFlight.get(sessionKey) === flight) {
+                this.inFlight.delete(sessionKey);
+            }
+        });
+        this.inFlight.set(sessionKey, flight);
+        await flight;
+    }
+}
+//# sourceMappingURL=inbound-turn-queue.js.map

package/lib/turn/inbound-turn-queue.js.map

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

package/lib/turn/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Turn module — IM turn pipeline, scheduling, metrics, multimodal helpers.
+ */
+export { processTextTurn, processMultimodalTurn } from './turn-pipeline.js';
+export type { ProcessTextTurnOptions } from './turn-pipeline.js';
+export { processTextTurnStream } from './process-stream.js';
+export { PromptController, TurnSupersededError, } from './prompt-controller.js';
+export type { PromptTurnHooks, PromptTurnRequest } from './prompt-controller.js';
+export { SessionMessageQueue } from './session-message-queue.js';
+export { addUsage, EMPTY_USAGE, formatAiHandlerCompleteLog, formatZhinAgentTurnUsage, } from './turn-metrics.js';
+export type { ZhinAgentTurnMetrics, ZhinAgentTurnPath } from './turn-metrics.js';
+export { TurnTracker } from './turn-tracker.js';
+export { summarizeMultimodalParts, buildVisionUserMessage, } from './multimodal-message.js';
+export { InboundTurnQueue, InboundTurnExpiredError, } from './inbound-turn-queue.js';
+export type { InboundQueueActivityEmitter } from './inbound-turn-queue.js';
+export { DEFAULT_INBOUND_QUEUE_CONFIG, normalizeInboundQueueConfig, validateInboundQueueConfig, isGroupOrChannelMessage, shouldUseGroupFifoQueue, } from './inbound-queue-config.js';
+export type { ResolvedInboundQueueConfig } from './inbound-queue-config.js';
+export { createInboundTurnQueue, runWithInboundQueue } from './inbound-queue-runtime.js';
+export { continueAfterDeferredWorker, continueAfterSubagent, } from './auto-continue.js';
+export type { AutoContinueHost } from './auto-continue.js';
+export { runPromptTurn, steerMessage, followUpMessage, assertMasterForPromptControl, } from './prompt-api.js';
+export { PromptAccessDeniedError } from './prompt-access.js';
+export { normalizePromptMessages } from './prompt-input.js';
+export { extractDeferredBody, deliverDeferredWorkerResult, deliverDeferredAutoContinueReply } from './deferred-delivery.js';
+export { DEFERRED_AUTO_CONTINUE_MARKER, isDeferredAutoContinueEnabled, shouldDeferredAutoContinue, buildDeferredAutoContinueUserMessage, } from './deferred-auto-continue.js';
+export { SUBAGENT_AUTO_CONTINUE_MARKER, buildSubagentAutoContinueUserMessage, } from './subagent-auto-continue.js';
+export { persistDeferredWorkerResultToContext } from './persist-deferred-context.js';
+export { persistSubagentResultToContext } from './persist-subagent-context.js';
+export { computeDeferredDelta } from './turn-deferred-delta.js';
+export { initScheduleTurnContext, initInboundTurnContext, getTurnActiveSkills, runInTurnContext, appendActiveSkills, } from './turn-context-bridge.js';
+export type { TurnContextBridgeState } from './turn-context-bridge.js';
+export { TaskContinuationManager, decomposeTask, getContinuationManager, initContinuationManager, } from './task-continuation.js';
+export type { TaskStatus, TaskProgress, TaskDecomposition, } from './task-continuation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/turn/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACL,QAAQ,EACR,WAAW,EACX,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEzF,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAE5H,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,oCAAoC,GACrC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,6BAA6B,EAC7B,oCAAoC,GACrC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,oCAAoC,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAE/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,UAAU,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,wBAAwB,CAAC"}

package/lib/turn/index.js

@@ -0,0 +1,26 @@
+/**
+ * Turn module — IM turn pipeline, scheduling, metrics, multimodal helpers.
+ */
+export { processTextTurn, processMultimodalTurn } from './turn-pipeline.js';
+export { processTextTurnStream } from './process-stream.js';
+export { PromptController, TurnSupersededError, } from './prompt-controller.js';
+export { SessionMessageQueue } from './session-message-queue.js';
+export { addUsage, EMPTY_USAGE, formatAiHandlerCompleteLog, formatZhinAgentTurnUsage, } from './turn-metrics.js';
+export { TurnTracker } from './turn-tracker.js';
+export { summarizeMultimodalParts, buildVisionUserMessage, } from './multimodal-message.js';
+export { InboundTurnQueue, InboundTurnExpiredError, } from './inbound-turn-queue.js';
+export { DEFAULT_INBOUND_QUEUE_CONFIG, normalizeInboundQueueConfig, validateInboundQueueConfig, isGroupOrChannelMessage, shouldUseGroupFifoQueue, } from './inbound-queue-config.js';
+export { createInboundTurnQueue, runWithInboundQueue } from './inbound-queue-runtime.js';
+export { continueAfterDeferredWorker, continueAfterSubagent, } from './auto-continue.js';
+export { runPromptTurn, steerMessage, followUpMessage, assertMasterForPromptControl, } from './prompt-api.js';
+export { PromptAccessDeniedError } from './prompt-access.js';
+export { normalizePromptMessages } from './prompt-input.js';
+export { extractDeferredBody, deliverDeferredWorkerResult, deliverDeferredAutoContinueReply } from './deferred-delivery.js';
+export { DEFERRED_AUTO_CONTINUE_MARKER, isDeferredAutoContinueEnabled, shouldDeferredAutoContinue, buildDeferredAutoContinueUserMessage, } from './deferred-auto-continue.js';
+export { SUBAGENT_AUTO_CONTINUE_MARKER, buildSubagentAutoContinueUserMessage, } from './subagent-auto-continue.js';
+export { persistDeferredWorkerResultToContext } from './persist-deferred-context.js';
+export { persistSubagentResultToContext } from './persist-subagent-context.js';
+export { computeDeferredDelta } from './turn-deferred-delta.js';
+export { initScheduleTurnContext, initInboundTurnContext, getTurnActiveSkills, runInTurnContext, appendActiveSkills, } from './turn-context-bridge.js';
+export { TaskContinuationManager, decomposeTask, getContinuationManager, initContinuationManager, } from './task-continuation.js';
+//# sourceMappingURL=index.js.map

package/lib/turn/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/turn/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACL,QAAQ,EACR,WAAW,EACX,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEzF,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAE5H,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,oCAAoC,GACrC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,6BAA6B,EAC7B,oCAAoC,GACrC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,oCAAoC,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAE/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}

package/lib/turn/multimodal-message.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ContentPart[] → agentLoop UserMessage（ADR 0009 D2：image blocks）
+ */
+import { type ContentPart, type 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/turn/multimodal-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multimodal-message.d.ts","sourceRoot":"","sources":["../../src/turn/multimodal-message.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,WAAW,EAAqB,KAAK,WAAW,EAAqB,MAAM,aAAa,CAAC;AAwBvG,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"}