@xgjktech/xg_cwork_im 1.12.9 → 1.13.1

package/dist/src/inbound-chat-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"inbound-chat-type.js","sourceRoot":"","sources":["../../src/inbound-chat-type.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAMjF,MAAM,UAAU,eAAe,CAAC,GAAY;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QACpD,OAAO,UAAU,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAuB;IAClD,OAAO,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC;AACzD,CAAC;AAKD,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC3D,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAuB,EAAE,iBAA0B;IAC3F,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACtC,GAAc,EACd,MAAuB,EACvB,GAAqC,EACrC,gBAAwB;IAExB,IAAI,cAAc,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC3D,IAAI,cAAc,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"inbound-chat-type.js","sourceRoot":"","sources":["../../src/inbound-chat-type.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AASjF,MAAM,UAAU,eAAe,CAAC,GAAY;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QACpD,OAAO,UAAU,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAuB;IAClD,OAAO,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC;AACzD,CAAC;AAKD,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC3D,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAuB,EAAE,iBAA0B;IAC3F,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACtC,GAAc,EACd,MAAuB,EACvB,GAAqC,EACrC,gBAAwB;IAExB,IAAI,cAAc,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC3D,IAAI,cAAc,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACjD,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,yCAAyC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,kBAAkB,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/src/inbound-terminal-delivery.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 入站 IM 消息终态投递：幂等、结构化日志、HTTP 兜底发送。
+ */
+import type { Logger } from "./channel-log.js";
+import { type InboundTrigger, type TerminalState } from "./inbound-terminal-state.js";
+import type { SendMessageReply } from "./types.js";
+export type TerminalSendFn = (text: string) => Promise<void>;
+export declare class InboundTerminalController {
+    private readonly messageId;
+    private readonly groupId;
+    private readonly sessionKey;
+    private readonly trigger;
+    private readonly log;
+    private readonly logPrefix;
+    private runId;
+    private hasBusinessReply;
+    private timeoutFired;
+    private compactionShown;
+    private compactionIncomplete;
+    private runtimeErrorHint;
+    private noReplySignaled;
+    private localTerminalSent;
+    private lastResolvedState;
+    constructor(args: {
+        messageId: string;
+        groupId: string;
+        sessionKey: string;
+        trigger?: InboundTrigger;
+        log: Logger;
+        logPrefix: string;
+    });
+    setRunId(runId: string): void;
+    markBusinessReplySent(): void;
+    markTimeoutFired(): void;
+    markNoReplySignaled(): void;
+    noteCompactionNotice(text: string): void;
+    noteCompactionWsEvent(phase: "start" | "end"): void;
+    noteRuntimeErrorFromPayload(text: string): void;
+    noteRuntimeError(err: unknown): void;
+    /**
+     * 尝试发送终态 HTTP 兜底。返回是否已向 IM 发送（含此前已发送的幂等命中）。
+     */
+    trySendTerminal(state: TerminalState, sendFn: TerminalSendFn, extra?: {
+        errorMessage?: string;
+    }): Promise<boolean>;
+    finalizeAndDeliver(args: {
+        sendFn: TerminalSendFn;
+        dispatchThrew: boolean;
+        dispatchError?: unknown;
+        lastDeliverError?: unknown;
+        beforeAgentRunBlocked?: boolean;
+        deliverInvokeCount: number;
+        deliverCallCount: number;
+    }): Promise<TerminalState>;
+    getLastResolvedState(): TerminalState | undefined;
+    getRunId(): string | undefined;
+    didTimeoutFire(): boolean;
+    wasTerminalDelivered(): boolean;
+    private logTerminal;
+}
+export declare function buildTerminalSendFn(args: {
+    sendText: (text: string, replyMeta?: SendMessageReply) => Promise<void>;
+    replyMeta?: SendMessageReply;
+    isSingleChat: boolean;
+}): TerminalSendFn;
+/** cron / 工具主动推送前缀，避免与用户消息回复混淆。 */
+export declare function prefixProactiveOutboundText(text: string, trigger?: "cron" | "tool"): string;
+//# sourceMappingURL=inbound-terminal-delivery.d.ts.map

package/dist/src/inbound-terminal-delivery.d.ts.map

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

package/dist/src/inbound-terminal-delivery.js

@@ -0,0 +1,191 @@
+/**
+ * 入站 IM 消息终态投递：幂等、结构化日志、HTTP 兜底发送。
+ */
+import { buildTerminalUserMessage, classifyRuntimeErrorMessage, formatTerminalLogLine, hasGlobalTerminalSent, markGlobalTerminalSent, resolveTerminalState, } from "./inbound-terminal-state.js";
+export class InboundTerminalController {
+    messageId;
+    groupId;
+    sessionKey;
+    trigger;
+    log;
+    logPrefix;
+    runId;
+    hasBusinessReply = false;
+    timeoutFired = false;
+    compactionShown = false;
+    compactionIncomplete = false;
+    runtimeErrorHint;
+    noReplySignaled = false;
+    localTerminalSent = false;
+    lastResolvedState;
+    constructor(args) {
+        this.messageId = args.messageId.trim();
+        this.groupId = args.groupId.trim();
+        this.sessionKey = args.sessionKey;
+        this.trigger = args.trigger ?? "user";
+        this.log = args.log;
+        this.logPrefix = args.logPrefix;
+    }
+    setRunId(runId) {
+        const id = runId.trim();
+        if (id)
+            this.runId = id;
+    }
+    markBusinessReplySent() {
+        this.hasBusinessReply = true;
+    }
+    markTimeoutFired() {
+        this.timeoutFired = true;
+    }
+    markNoReplySignaled() {
+        this.noReplySignaled = true;
+    }
+    noteCompactionNotice(text) {
+        this.compactionShown = true;
+        const lower = text.toLowerCase();
+        if (lower.includes("incomplete") || lower.includes("失败") || lower.includes("failed")) {
+            this.compactionIncomplete = true;
+        }
+    }
+    noteCompactionWsEvent(phase) {
+        this.compactionShown = true;
+        if (phase === "start") {
+            // 仅 start 不标记 incomplete；end 由 notice 或失败路径设置
+        }
+    }
+    noteRuntimeErrorFromPayload(text) {
+        const hint = classifyRuntimeErrorMessage(text);
+        this.runtimeErrorHint = hint;
+        if (text.toLowerCase().includes("compacting") || text.toLowerCase().includes("compaction")) {
+            this.compactionShown = true;
+        }
+    }
+    noteRuntimeError(err) {
+        this.runtimeErrorHint = classifyRuntimeErrorMessage(err instanceof Error ? err.message : String(err));
+    }
+    /**
+     * 尝试发送终态 HTTP 兜底。返回是否已向 IM 发送（含此前已发送的幂等命中）。
+     */
+    async trySendTerminal(state, sendFn, extra) {
+        if (state === "success") {
+            this.logTerminal(state, false, extra?.errorMessage);
+            return false;
+        }
+        if (this.hasBusinessReply && state !== "timeout") {
+            // 超时提示可与后续成功回复共存；其它终态不再覆盖已有业务回复
+            this.logTerminal(state, false, extra?.errorMessage);
+            return false;
+        }
+        if (this.localTerminalSent || hasGlobalTerminalSent(this.messageId)) {
+            this.logTerminal(state, false, extra?.errorMessage);
+            return false;
+        }
+        const text = buildTerminalUserMessage(state);
+        if (!text.trim()) {
+            this.logTerminal(state, false, extra?.errorMessage);
+            return false;
+        }
+        try {
+            await sendFn(text);
+            this.localTerminalSent = true;
+            markGlobalTerminalSent(this.messageId, state);
+            this.lastResolvedState = state;
+            this.logTerminal(state, true, extra?.errorMessage);
+            if (state === "timeout") {
+                this.hasBusinessReply = true;
+            }
+            return true;
+        }
+        catch (err) {
+            this.log.error(`${this.logPrefix} [terminal] Failed to send terminal notice state=${state}: ${String(err)}`);
+            this.logTerminal(state, false, extra?.errorMessage ?? String(err));
+            return false;
+        }
+    }
+    async finalizeAndDeliver(args) {
+        const input = {
+            hasBusinessReply: this.hasBusinessReply,
+            timeoutFired: this.timeoutFired,
+            dispatchThrew: args.dispatchThrew,
+            dispatchError: args.dispatchError,
+            lastDeliverError: args.lastDeliverError,
+            beforeAgentRunBlocked: args.beforeAgentRunBlocked,
+            compactionShown: this.compactionShown,
+            compactionIncomplete: this.compactionIncomplete,
+            runtimeErrorHint: this.runtimeErrorHint,
+            deliverInvokeCount: args.deliverInvokeCount,
+            deliverCallCount: args.deliverCallCount,
+            noReplySignaled: this.noReplySignaled,
+        };
+        const state = resolveTerminalState(input);
+        this.lastResolvedState = state;
+        if (!this.hasBusinessReply || state === "timeout") {
+            const errMsg = this.runtimeErrorHint?.errorMessage ??
+                (args.dispatchError instanceof Error
+                    ? args.dispatchError.message
+                    : args.dispatchError !== undefined
+                        ? String(args.dispatchError)
+                        : args.lastDeliverError instanceof Error
+                            ? args.lastDeliverError.message
+                            : args.lastDeliverError !== undefined
+                                ? String(args.lastDeliverError)
+                                : undefined);
+            await this.trySendTerminal(state, args.sendFn, { errorMessage: errMsg });
+        }
+        else {
+            this.logTerminal("success", true);
+        }
+        return state;
+    }
+    getLastResolvedState() {
+        return this.lastResolvedState;
+    }
+    getRunId() {
+        return this.runId;
+    }
+    didTimeoutFire() {
+        return this.timeoutFired;
+    }
+    wasTerminalDelivered() {
+        return this.localTerminalSent;
+    }
+    logTerminal(state, sentToIm, errorMessage) {
+        const line = formatTerminalLogLine({
+            message_id: this.messageId,
+            group_id: this.groupId,
+            session_key: this.sessionKey,
+            run_id: this.runId,
+            trigger: this.trigger,
+            terminal_state: state,
+            sent_to_im: sentToIm,
+            error_type: state === "success" ? undefined : state,
+            error_message: errorMessage,
+        });
+        if (state === "success" && sentToIm) {
+            this.log.info(`${this.logPrefix} ${line}`);
+        }
+        else if (sentToIm) {
+            this.log.warn(`${this.logPrefix} ${line}`);
+        }
+        else {
+            this.log.info(`${this.logPrefix} ${line}`);
+        }
+    }
+}
+export function buildTerminalSendFn(args) {
+    return async (text) => {
+        await args.sendText(text, args.isSingleChat ? undefined : args.replyMeta);
+    };
+}
+/** cron / 工具主动推送前缀，避免与用户消息回复混淆。 */
+export function prefixProactiveOutboundText(text, trigger = "cron") {
+    const marker = trigger === "cron" ? "[定时任务]" : "[系统通知]";
+    const t = text.trim();
+    if (!t)
+        return marker;
+    if (t.startsWith(marker) || t.startsWith("[定时任务]") || t.startsWith("[系统通知]")) {
+        return t;
+    }
+    return `${marker} ${t}`;
+}
+//# sourceMappingURL=inbound-terminal-delivery.js.map

package/dist/src/inbound-terminal-delivery.js.map

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

package/dist/src/inbound-terminal-state.d.ts

@@ -0,0 +1,46 @@
+/**
+ * IM 入站消息终态：分类、用户可见文案、结构化日志字段。
+ */
+export type InboundTrigger = "user" | "cron" | "tool" | "heartbeat" | "system" | "runtime_continue";
+export type TerminalState = "success" | "no_reply" | "timeout" | "runtime_error" | "precheck_error" | "compaction_failed" | "delivery_failed" | "cancelled" | "superseded";
+export type RuntimeErrorHint = {
+    errorType: TerminalState;
+    errorMessage: string;
+};
+export declare function classifyRuntimeErrorMessage(message: string): RuntimeErrorHint;
+export declare function classifyRuntimeError(err: unknown): RuntimeErrorHint;
+export declare function buildTerminalUserMessage(state: TerminalState): string;
+export type TerminalLogFields = {
+    message_id: string;
+    group_id: string;
+    session_key: string;
+    run_id?: string;
+    trigger: InboundTrigger;
+    terminal_state: TerminalState;
+    sent_to_im: boolean;
+    error_type?: TerminalState;
+    error_message?: string;
+};
+export declare function formatTerminalLogLine(fields: TerminalLogFields): string;
+export type ResolveTerminalStateInput = {
+    hasBusinessReply: boolean;
+    timeoutFired: boolean;
+    dispatchThrew: boolean;
+    dispatchError?: unknown;
+    lastDeliverError?: unknown;
+    beforeAgentRunBlocked?: boolean;
+    compactionShown: boolean;
+    compactionIncomplete: boolean;
+    runtimeErrorHint?: RuntimeErrorHint;
+    deliverInvokeCount: number;
+    deliverCallCount: number;
+    noReplySignaled: boolean;
+};
+/** 在 finally 阶段根据观测信号推断终态（success 由 hasBusinessReply 在外层短路）。 */
+export declare function resolveTerminalState(input: ResolveTerminalStateInput): TerminalState;
+export declare function hasGlobalTerminalSent(messageId: string): boolean;
+export declare function markGlobalTerminalSent(messageId: string, state: TerminalState): void;
+export declare function peekGlobalTerminalSent(messageId: string): TerminalState | undefined;
+/** 测试用：清空进程级幂等表。 */
+export declare function resetGlobalTerminalSentForTests(): void;
+//# sourceMappingURL=inbound-terminal-state.d.ts.map

package/dist/src/inbound-terminal-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-terminal-state.d.ts","sourceRoot":"","sources":["../../src/inbound-terminal-state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,kBAAkB,CAAC;AAEpG,MAAM,MAAM,aAAa,GACnB,SAAS,GACT,UAAU,GACV,SAAS,GACT,eAAe,GACf,gBAAgB,GAChB,mBAAmB,GACnB,iBAAiB,GACjB,WAAW,GACX,YAAY,CAAC;AAEnB,MAAM,MAAM,gBAAgB,GAAG;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC;AAcF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAkB7E;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAKnE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAuBrE;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;IACxB,cAAc,EAAE,aAAa,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAavE;AAED,MAAM,MAAM,yBAAyB,GAAG;IACpC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,aAAa,CA0BpF;AAKD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAMpF;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEnF;AAED,oBAAoB;AACpB,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}

package/dist/src/inbound-terminal-state.js

@@ -0,0 +1,120 @@
+/**
+ * IM 入站消息终态：分类、用户可见文案、结构化日志字段。
+ */
+const PRECHECK_MARKERS = [
+    "context overflow",
+    "prompt too large",
+    "precheck",
+    "too large for the model",
+    "too large for this model",
+];
+const TIMEOUT_MARKERS = ["request timed out", "timed out", "idle timeout", "llm idle timeout"];
+const NO_REPLY_MARKERS = ["no_reply", "no reply"];
+export function classifyRuntimeErrorMessage(message) {
+    const raw = message.trim();
+    const lower = raw.toLowerCase();
+    if (PRECHECK_MARKERS.some((m) => lower.includes(m))) {
+        return { errorType: "precheck_error", errorMessage: raw };
+    }
+    if (TIMEOUT_MARKERS.some((m) => lower.includes(m))) {
+        return { errorType: "timeout", errorMessage: raw };
+    }
+    if (NO_REPLY_MARKERS.some((m) => lower.includes(m))) {
+        return { errorType: "no_reply", errorMessage: raw };
+    }
+    if (lower.includes("compaction") && (lower.includes("incomplete") || lower.includes("failed"))) {
+        return { errorType: "compaction_failed", errorMessage: raw };
+    }
+    return { errorType: "runtime_error", errorMessage: raw };
+}
+export function classifyRuntimeError(err) {
+    if (err instanceof Error) {
+        return classifyRuntimeErrorMessage(err.message);
+    }
+    return classifyRuntimeErrorMessage(String(err));
+}
+export function buildTerminalUserMessage(state) {
+    switch (state) {
+        case "precheck_error":
+            return ("当前上下文过大，本轮未能启动模型调用。系统已记录，请稍后重试或等待上下文压缩完成。");
+        case "compaction_failed":
+            return "上下文压缩后仍未生成回复，请精简对话历史或新开话题后再试。";
+        case "timeout":
+            return "当前请求处理超时，请稍后重试。";
+        case "no_reply":
+            return "消息已收到，但这一轮没有生成回复。请换个说法或把需求说具体一些后再试。";
+        case "runtime_error":
+            return "当前请求处理时出现异常，请稍后重试。";
+        case "delivery_failed":
+            return "回复已生成但发送到 IM 失败，请稍后重试。";
+        case "cancelled":
+            return "当前请求已取消。";
+        case "superseded":
+            return "当前请求已被更新的处理覆盖。";
+        case "success":
+            return "";
+    }
+}
+export function formatTerminalLogLine(fields) {
+    const parts = [
+        `[terminal] message_id=${fields.message_id}`,
+        `group_id=${fields.group_id}`,
+        `session_key=${fields.session_key}`,
+        fields.run_id ? `run_id=${fields.run_id}` : undefined,
+        `trigger=${fields.trigger}`,
+        `terminal_state=${fields.terminal_state}`,
+        `sent_to_im=${fields.sent_to_im}`,
+        fields.error_type ? `error_type=${fields.error_type}` : undefined,
+        fields.error_message ? `error_message=${JSON.stringify(fields.error_message)}` : undefined,
+    ].filter(Boolean);
+    return parts.join(" ");
+}
+/** 在 finally 阶段根据观测信号推断终态（success 由 hasBusinessReply 在外层短路）。 */
+export function resolveTerminalState(input) {
+    if (input.hasBusinessReply) {
+        return "success";
+    }
+    if (input.timeoutFired) {
+        return "timeout";
+    }
+    if (input.lastDeliverError !== undefined) {
+        return "delivery_failed";
+    }
+    if (input.runtimeErrorHint) {
+        return input.runtimeErrorHint.errorType;
+    }
+    if (input.dispatchError !== undefined) {
+        return classifyRuntimeError(input.dispatchError).errorType;
+    }
+    if (input.beforeAgentRunBlocked) {
+        return "precheck_error";
+    }
+    if (input.compactionIncomplete || (input.compactionShown && input.deliverCallCount === 0)) {
+        return "compaction_failed";
+    }
+    if (input.noReplySignaled || (input.deliverInvokeCount === 0 && !input.dispatchThrew)) {
+        return "no_reply";
+    }
+    return "runtime_error";
+}
+/** 进程级幂等：同一 message_id 终态 HTTP 最多发一次。 */
+const globalTerminalSent = new Map();
+export function hasGlobalTerminalSent(messageId) {
+    return globalTerminalSent.has(messageId.trim());
+}
+export function markGlobalTerminalSent(messageId, state) {
+    const id = messageId.trim();
+    if (!id)
+        return;
+    if (!globalTerminalSent.has(id)) {
+        globalTerminalSent.set(id, state);
+    }
+}
+export function peekGlobalTerminalSent(messageId) {
+    return globalTerminalSent.get(messageId.trim());
+}
+/** 测试用：清空进程级幂等表。 */
+export function resetGlobalTerminalSentForTests() {
+    globalTerminalSent.clear();
+}
+//# sourceMappingURL=inbound-terminal-state.js.map

package/dist/src/inbound-terminal-state.js.map

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

package/dist/src/inbound-terminal-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inbound-terminal-state.test.d.ts.map

package/dist/src/inbound-terminal-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-terminal-state.test.d.ts","sourceRoot":"","sources":["../../src/inbound-terminal-state.test.ts"],"names":[],"mappings":""}

package/dist/src/inbound-terminal-state.test.js

@@ -0,0 +1,151 @@
+import assert from "node:assert/strict";
+import { describe, it, beforeEach } from "node:test";
+import { buildTerminalUserMessage, classifyRuntimeErrorMessage, hasGlobalTerminalSent, markGlobalTerminalSent, resetGlobalTerminalSentForTests, resolveTerminalState, } from "./inbound-terminal-state.js";
+import { InboundTerminalController, prefixProactiveOutboundText } from "./inbound-terminal-delivery.js";
+describe("classifyRuntimeErrorMessage", () => {
+    it("detects precheck overflow", () => {
+        const hint = classifyRuntimeErrorMessage("Context overflow: prompt too large for the model (precheck)");
+        assert.equal(hint.errorType, "precheck_error");
+    });
+    it("detects timeout", () => {
+        const hint = classifyRuntimeErrorMessage("Request timed out.");
+        assert.equal(hint.errorType, "timeout");
+    });
+    it("detects no_reply", () => {
+        const hint = classifyRuntimeErrorMessage("NO_REPLY");
+        assert.equal(hint.errorType, "no_reply");
+    });
+});
+describe("resolveTerminalState", () => {
+    it("returns success when business reply sent", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: true,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 1,
+            deliverCallCount: 1,
+            noReplySignaled: false,
+        }), "success");
+    });
+    it("returns precheck_error from runtime hint", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 1,
+            deliverCallCount: 0,
+            noReplySignaled: false,
+            runtimeErrorHint: {
+                errorType: "precheck_error",
+                errorMessage: "Context overflow: prompt too large for the model (precheck)",
+            },
+        }), "precheck_error");
+    });
+    it("returns compaction_failed when compaction shown without reply", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: true,
+            compactionIncomplete: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+            noReplySignaled: false,
+        }), "compaction_failed");
+    });
+    it("returns no_reply for silent turn", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+            noReplySignaled: true,
+        }), "no_reply");
+    });
+    it("returns timeout when watchdog fired", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: true,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+            noReplySignaled: false,
+        }), "timeout");
+    });
+});
+describe("buildTerminalUserMessage", () => {
+    it("uses distinct copy for precheck vs no_reply", () => {
+        const precheck = buildTerminalUserMessage("precheck_error");
+        const noReply = buildTerminalUserMessage("no_reply");
+        assert.ok(precheck.includes("上下文过大"));
+        assert.ok(noReply.includes("没有生成回复"));
+        assert.notEqual(precheck, noReply);
+    });
+});
+describe("InboundTerminalController idempotency", () => {
+    const noopLog = {
+        info: () => { },
+        warn: () => { },
+        error: () => { },
+    };
+    beforeEach(() => {
+        resetGlobalTerminalSentForTests();
+    });
+    it("sends terminal only once per message_id", async () => {
+        const controller = new InboundTerminalController({
+            messageId: "msg-1001",
+            groupId: "g1",
+            sessionKey: "sk1",
+            log: noopLog,
+            logPrefix: "[test]",
+        });
+        let sendCount = 0;
+        const sendFn = async () => {
+            sendCount++;
+        };
+        const first = await controller.trySendTerminal("precheck_error", sendFn);
+        const second = await controller.trySendTerminal("precheck_error", sendFn);
+        assert.equal(first, true);
+        assert.equal(second, false);
+        assert.equal(sendCount, 1);
+        assert.equal(hasGlobalTerminalSent("msg-1001"), true);
+    });
+    it("finalize delivers precheck when error payload was noted", async () => {
+        const controller = new InboundTerminalController({
+            messageId: "msg-2002",
+            groupId: "g2",
+            sessionKey: "sk2",
+            log: noopLog,
+            logPrefix: "[test]",
+        });
+        controller.noteRuntimeErrorFromPayload("Context overflow: prompt too large for the model (precheck)");
+        let sent = "";
+        const state = await controller.finalizeAndDeliver({
+            sendFn: async (text) => {
+                sent = text;
+            },
+            dispatchThrew: false,
+            deliverInvokeCount: 1,
+            deliverCallCount: 0,
+        });
+        assert.equal(state, "precheck_error");
+        assert.ok(sent.includes("上下文过大"));
+        markGlobalTerminalSent("msg-2002", "precheck_error");
+    });
+});
+describe("prefixProactiveOutboundText", () => {
+    it("prefixes cron messages once", () => {
+        assert.equal(prefixProactiveOutboundText("今日无新增"), "[定时任务] 今日无新增");
+        assert.equal(prefixProactiveOutboundText("[定时任务] 已有"), "[定时任务] 已有");
+    });
+});
+//# sourceMappingURL=inbound-terminal-state.test.js.map

package/dist/src/inbound-terminal-state.test.js.map

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