@xgjktech/xg_cwork_im 1.19.41 → 1.19.42

package/dist/src/inbound-model.test.js

@@ -0,0 +1,88 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { extractInboundModelSelection, hasUserThinkDirective, isInboundControlCommandMessage, parseInboundThinkingLevel, } from "./inbound-model.js";
+const ext = (v) => (v === undefined ? undefined : { ai_model: v });
+describe("inbound-model selection", () => {
+    it("no ai_model → default", () => {
+        assert.deepEqual(extractInboundModelSelection(ext(undefined), "你好"), { mode: "default" });
+    });
+    it("empty string → default", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("   "), "你好"), { mode: "default" });
+    });
+    it("non-string ai_model → default", () => {
+        assert.deepEqual(extractInboundModelSelection({ ai_model: 42 }, "你好"), { mode: "default" });
+    });
+    it("auto → auto", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("auto"), "你好"), { mode: "auto" });
+    });
+    it("AUTO → auto (case-insensitive)", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("AUTO"), "你好"), { mode: "auto" });
+    });
+    it("' auto ' → auto (trimmed)", () => {
+        assert.deepEqual(extractInboundModelSelection(ext(" auto "), "你好"), { mode: "auto" });
+    });
+    it("specific model → explicit", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("openai/gpt-5.6-terra"), "你好"), {
+            mode: "explicit",
+            model: "openai/gpt-5.6-terra",
+        });
+    });
+    it("/model control command ignores IM metadata", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("auto"), "/model openai/gpt-5.6-terra 切换"), {
+            mode: "default",
+        });
+    });
+    it("/think control command ignores IM metadata", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("auto"), "/think high"), { mode: "default" });
+    });
+    it("/reset control command ignores IM metadata", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("auto"), "/reset"), { mode: "default" });
+    });
+    it("@robot-prefixed /model still detected as control command", () => {
+        assert.deepEqual(extractInboundModelSelection(ext("auto"), "@bot /model foo"), { mode: "default" });
+    });
+});
+describe("inbound-model think directive", () => {
+    it("detects inline /think in body", () => {
+        assert.equal(hasUserThinkDirective("帮我总结这段 /think high"), true);
+    });
+    it("detects leading /think", () => {
+        assert.equal(hasUserThinkDirective("/think medium"), true);
+    });
+    it("case-insensitive", () => {
+        assert.equal(hasUserThinkDirective("请分析 /THINK max"), true);
+    });
+    it("no /think → false", () => {
+        assert.equal(hasUserThinkDirective("请分析这个系统"), false);
+    });
+    it("distinct word boundaries", () => {
+        assert.equal(hasUserThinkDirective("请你考虑一下思考方式"), false);
+    });
+    it("isInboundControlCommandMessage true for first-line slash", () => {
+        assert.equal(isInboundControlCommandMessage("/stop"), true);
+        assert.equal(isInboundControlCommandMessage("普通问题 /stop 后面"), false);
+    });
+});
+describe("inbound-model ai_thinking", () => {
+    it("parses canonical levels case-insensitively and trimmed", () => {
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "high" }), "high");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: " HIGH " }), "high");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "max" }), "max");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "xhigh" }), "xhigh");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "adaptive" }), "adaptive");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "off" }), "off");
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "ultra" }), "ultra");
+    });
+    it("returns undefined for missing/blank/non-string/invalid values", () => {
+        assert.equal(parseInboundThinkingLevel(undefined), undefined);
+        assert.equal(parseInboundThinkingLevel({}), undefined);
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "" }), undefined);
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "   " }), undefined);
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: 42 }), undefined);
+        assert.equal(parseInboundThinkingLevel({ ai_thinking: "superhigh" }), undefined);
+    });
+    it("does not read ai_model", () => {
+        assert.equal(parseInboundThinkingLevel({ ai_model: "high" }), undefined);
+    });
+});
+//# sourceMappingURL=inbound-model.test.js.map

package/dist/src/inbound-model.test.js.map

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

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

@@ -0,0 +1,77 @@
+/**
+ * 入站 IM 消息终态投递：幂等、结构化日志、HTTP 兜底发送。
+ */
+import type { Logger } from "./channel-log.js";
+import { type InboundTrigger, type NoReplyCause, type TerminalState } from "./inbound-terminal-state.js";
+import type { FirstReplyTimeoutCause } from "./user-facing-errors.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 normalizerSilentSkip;
+    private normalizerHeartbeatSkip;
+    private normalizerSkipReasons;
+    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;
+    /** OpenClaw reply normalizer 跳过 payload 时记录（onSkip reason）。 */
+    noteNormalizerSkip(reason: string): void;
+    noteCompactionNotice(text: string): void;
+    noteCompactionWsEvent(phase: "start" | "end"): void;
+    noteRuntimeErrorFromPayload(text: string): void;
+    noteRuntimeError(err: unknown): void;
+    /**
+     * 尝试发送终态 HTTP。返回是否已向 IM 发送（含此前已发送的幂等命中）。
+     * no_reply / timeout 等由 shouldSendTerminalHttpForState 拦截；文案为空亦不发。
+     */
+    trySendTerminal(state: TerminalState, sendFn: TerminalSendFn, extra?: {
+        errorMessage?: string;
+        noReplyCause?: NoReplyCause;
+        deliverInvokeCount?: number;
+        deliverCallCount?: number;
+        timeoutCause?: FirstReplyTimeoutCause;
+    }): 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":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAUH,KAAK,cAAc,EACnB,KAAK,YAAY,EAIjB,KAAK,aAAa,EACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,sBAAsB,EAA0B,MAAM,yBAAyB,CAAC;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7D,qBAAa,yBAAyB;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,qBAAqB,CAAgB;IAC7C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,iBAAiB,CAA4B;gBAEzC,IAAI,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;KACrB;IASD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B,qBAAqB,IAAI,IAAI;IAI7B,gBAAgB,IAAI,IAAI;IAIxB,+DAA+D;IAC/D,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAYxC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQxC,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI;IAOnD,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ/C,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAMpC;;;OAGG;IACG,eAAe,CACjB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,cAAc,EACtB,KAAK,CAAC,EAAE;QACJ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,YAAY,CAAC;QAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,YAAY,CAAC,EAAE,sBAAsB,CAAC;KACzC,GACF,OAAO,CAAC,OAAO,CAAC;IAwEb,kBAAkB,CAAC,IAAI,EAAE;QAC3B,MAAM,EAAE,cAAc,CAAC;QACvB,aAAa,EAAE,OAAO,CAAC;QACvB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,aAAa,CAAC;IAoD1B,oBAAoB,IAAI,aAAa,GAAG,SAAS;IAIjD,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B,cAAc,IAAI,OAAO;IAIzB,oBAAoB,IAAI,OAAO;IAI/B,OAAO,CAAC,WAAW;CAyCtB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;CACzB,GAAG,cAAc,CAIjB;AAED,mCAAmC;AACnC,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,GAAG,MAAe,GAAG,MAAM,CAQnG"}

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

@@ -0,0 +1,251 @@
+/**
+ * 入站 IM 消息终态投递：幂等、结构化日志、HTTP 兜底发送。
+ */
+import { buildTerminalUserMessage, classifyRuntimeErrorMessage, formatTerminalLogLine, hasGlobalTerminalSent, markGlobalTerminalSent, resolveNoReplyCause, resolveTerminalState, resolveHttpSuppressedReason, shouldSendTerminalHttpForState, } from "./inbound-terminal-state.js";
+export class InboundTerminalController {
+    messageId;
+    groupId;
+    sessionKey;
+    trigger;
+    log;
+    logPrefix;
+    runId;
+    hasBusinessReply = false;
+    timeoutFired = false;
+    compactionShown = false;
+    compactionIncomplete = false;
+    runtimeErrorHint;
+    normalizerSilentSkip = false;
+    normalizerHeartbeatSkip = false;
+    normalizerSkipReasons = [];
+    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;
+    }
+    /** OpenClaw reply normalizer 跳过 payload 时记录（onSkip reason）。 */
+    noteNormalizerSkip(reason) {
+        const r = reason.trim();
+        if (r && !this.normalizerSkipReasons.includes(r)) {
+            this.normalizerSkipReasons.push(r);
+        }
+        if (reason === "silent") {
+            this.normalizerSilentSkip = true;
+        }
+        else if (reason === "heartbeat") {
+            this.normalizerHeartbeatSkip = 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 发送（含此前已发送的幂等命中）。
+     * no_reply / timeout 等由 shouldSendTerminalHttpForState 拦截；文案为空亦不发。
+     */
+    async trySendTerminal(state, sendFn, extra) {
+        const metrics = {
+            deliver_invoke_count: extra?.deliverInvokeCount,
+            deliver_call_count: extra?.deliverCallCount,
+            normalizer_silent_skip: this.normalizerSilentSkip,
+            normalizer_heartbeat_skip: this.normalizerHeartbeatSkip,
+        };
+        const suppressedReason = resolveHttpSuppressedReason(state, {
+            normalizerSilentSkip: this.normalizerSilentSkip,
+            normalizerHeartbeatSkip: this.normalizerHeartbeatSkip,
+        });
+        if (state === "success") {
+            this.logTerminal(state, false, extra?.errorMessage, extra?.noReplyCause, metrics);
+            return false;
+        }
+        if (this.hasBusinessReply && state !== "timeout") {
+            this.logTerminal(state, false, extra?.errorMessage, extra?.noReplyCause, metrics);
+            return false;
+        }
+        if (this.localTerminalSent || hasGlobalTerminalSent(this.messageId)) {
+            this.logTerminal(state, false, extra?.errorMessage, extra?.noReplyCause, metrics);
+            return false;
+        }
+        const text = buildTerminalUserMessage(state, {
+            errorMessage: extra?.errorMessage,
+            noReplyCause: extra?.noReplyCause,
+            timeoutCause: extra?.timeoutCause,
+        });
+        if (!text.trim()) {
+            this.logTerminal(state, false, extra?.errorMessage, extra?.noReplyCause, metrics);
+            return false;
+        }
+        if (!shouldSendTerminalHttpForState(state, {
+            normalizerSilentSkip: this.normalizerSilentSkip,
+            normalizerHeartbeatSkip: this.normalizerHeartbeatSkip,
+        })) {
+            this.log.info(`${this.logPrefix} [terminal] HTTP suppressed reason=${suppressedReason} ` +
+                `normalizer_skip_reasons=${JSON.stringify(this.normalizerSkipReasons)} ` +
+                `message_id=${this.messageId} (intentional silence; user sees no HTTP body)`);
+            this.logTerminal(state, false, extra?.errorMessage, extra?.noReplyCause, {
+                ...metrics,
+                http_suppressed_reason: suppressedReason,
+            });
+            return false;
+        }
+        try {
+            await sendFn(text);
+            this.localTerminalSent = true;
+            markGlobalTerminalSent(this.messageId, state);
+            this.lastResolvedState = state;
+            this.logTerminal(state, true, extra?.errorMessage, extra?.noReplyCause, metrics);
+            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), extra?.noReplyCause, metrics);
+            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,
+            normalizerSilentSkip: this.normalizerSilentSkip,
+            normalizerHeartbeatSkip: this.normalizerHeartbeatSkip,
+        };
+        const state = resolveTerminalState(input);
+        const noReplyCause = resolveNoReplyCause(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,
+                noReplyCause,
+                deliverInvokeCount: args.deliverInvokeCount,
+                deliverCallCount: args.deliverCallCount,
+            });
+        }
+        else {
+            this.logTerminal("success", true, undefined, noReplyCause, {
+                deliver_invoke_count: args.deliverInvokeCount,
+                deliver_call_count: args.deliverCallCount,
+                normalizer_silent_skip: this.normalizerSilentSkip,
+                normalizer_heartbeat_skip: this.normalizerHeartbeatSkip,
+            });
+        }
+        return state;
+    }
+    getLastResolvedState() {
+        return this.lastResolvedState;
+    }
+    getRunId() {
+        return this.runId;
+    }
+    didTimeoutFire() {
+        return this.timeoutFired;
+    }
+    wasTerminalDelivered() {
+        return this.localTerminalSent;
+    }
+    logTerminal(state, sentToIm, errorMessage, noReplyCause, metrics) {
+        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,
+            no_reply_cause: state === "no_reply" ? noReplyCause : undefined,
+            deliver_invoke_count: metrics?.deliver_invoke_count,
+            deliver_call_count: metrics?.deliver_call_count,
+            normalizer_silent_skip: metrics?.normalizer_silent_skip,
+            normalizer_heartbeat_skip: metrics?.normalizer_heartbeat_skip,
+            http_suppressed_reason: metrics?.http_suppressed_reason,
+        });
+        if (state === "success" && sentToIm) {
+            this.log.info(`${this.logPrefix} ${line}`);
+        }
+        else if (state === "no_reply" && !sentToIm) {
+            this.log.warn(`${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,68 @@
+/**
+ * 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 { buildTerminalUserMessage } from "./user-facing-errors.js";
+export type { TerminalMessageContext } from "./user-facing-errors.js";
+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;
+    no_reply_cause?: NoReplyCause;
+    deliver_invoke_count?: number;
+    deliver_call_count?: number;
+    normalizer_silent_skip?: boolean;
+    normalizer_heartbeat_skip?: boolean;
+    http_suppressed_reason?: "intentional_silent" | "heartbeat_only";
+};
+export declare function formatTerminalLogLine(fields: TerminalLogFields): string;
+/** 终态为 no_reply 时的细分原因（用于日志与是否发 HTTP 兜底）。 */
+export type NoReplyCause = "intentional_silent" | "heartbeat_only" | "zero_deliver" | "all_deliver_skipped" | "unknown";
+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;
+    /** OpenClaw normalizer 因 NO_REPLY / silent token 跳过 payload（onSkip reason=silent） */
+    normalizerSilentSkip?: boolean;
+    /** normalizer 因 HEARTBEAT_OK 等跳过（onSkip reason=heartbeat） */
+    normalizerHeartbeatSkip?: boolean;
+};
+export declare function resolveHttpSuppressedReason(state: TerminalState, input: Pick<ResolveTerminalStateInput, "normalizerSilentSkip" | "normalizerHeartbeatSkip">): "intentional_silent" | "heartbeat_only" | undefined;
+/**
+ * 是否允许对 IM 发终态 HTTP。
+ * 不发：no_reply / timeout / compaction_failed（避免自造话或通道计时器误导）。
+ * 可发：投递失败、取消/覆盖、以及带上游原文的确认错误（文案为空时 trySend 仍会跳过）。
+ */
+export declare function shouldSendTerminalHttpForState(state: TerminalState, _input?: Pick<ResolveTerminalStateInput, "normalizerSilentSkip" | "normalizerHeartbeatSkip">): boolean;
+export declare function resolveNoReplyCause(input: ResolveTerminalStateInput): NoReplyCause | undefined;
+/** 在 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;
+/** 插件卸载/重载时清空终态幂等表。 */
+export declare function disposeGlobalTerminalSent(): 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":"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"}