@xgjktech/xg_cwork_im 1.12.9 → 1.14.6

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

@@ -0,0 +1,61 @@
+/**
+ * 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;
+    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;
+/** 模型/OpenClaw 主动静默（NO_REPLY、heartbeat）时不应向 IM 发「没有生成回复」HTTP。 */
+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;
+//# 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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"}

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

@@ -0,0 +1,177 @@
+/**
+ * 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,
+        fields.no_reply_cause ? `no_reply_cause=${fields.no_reply_cause}` : undefined,
+        fields.deliver_invoke_count != null ? `deliver_invoke_count=${fields.deliver_invoke_count}` : undefined,
+        fields.deliver_call_count != null ? `deliver_call_count=${fields.deliver_call_count}` : undefined,
+        fields.normalizer_silent_skip != null
+            ? `normalizer_silent_skip=${fields.normalizer_silent_skip}`
+            : undefined,
+        fields.normalizer_heartbeat_skip != null
+            ? `normalizer_heartbeat_skip=${fields.normalizer_heartbeat_skip}`
+            : undefined,
+        fields.http_suppressed_reason ? `http_suppressed_reason=${fields.http_suppressed_reason}` : undefined,
+    ].filter(Boolean);
+    return parts.join(" ");
+}
+export function resolveHttpSuppressedReason(state, input) {
+    if (state !== "no_reply") {
+        return undefined;
+    }
+    if (input.normalizerSilentSkip) {
+        return "intentional_silent";
+    }
+    if (input.normalizerHeartbeatSkip) {
+        return "heartbeat_only";
+    }
+    return undefined;
+}
+/** 模型/OpenClaw 主动静默（NO_REPLY、heartbeat）时不应向 IM 发「没有生成回复」HTTP。 */
+export function shouldSendTerminalHttpForState(state, input) {
+    if (state !== "no_reply") {
+        return true;
+    }
+    if (input.normalizerSilentSkip || input.normalizerHeartbeatSkip) {
+        return false;
+    }
+    return true;
+}
+export function resolveNoReplyCause(input) {
+    if (input.hasBusinessReply) {
+        return undefined;
+    }
+    if (input.normalizerSilentSkip) {
+        return "intentional_silent";
+    }
+    if (input.normalizerHeartbeatSkip) {
+        return "heartbeat_only";
+    }
+    if (input.deliverInvokeCount === 0) {
+        return "zero_deliver";
+    }
+    if (input.deliverInvokeCount > 0 && input.deliverCallCount === 0) {
+        return "all_deliver_skipped";
+    }
+    return "unknown";
+}
+/** 在 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.deliverInvokeCount > 0 &&
+        input.deliverCallCount === 0 &&
+        input.runtimeErrorHint === undefined &&
+        input.dispatchError === undefined &&
+        input.lastDeliverError === undefined) {
+        return "no_reply";
+    }
+    if (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,203 @@
+import assert from "node:assert/strict";
+import { describe, it, beforeEach } from "node:test";
+import { buildTerminalUserMessage, classifyRuntimeErrorMessage, hasGlobalTerminalSent, markGlobalTerminalSent, resetGlobalTerminalSentForTests, resolveNoReplyCause, resolveTerminalState, shouldSendTerminalHttpForState, } 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,
+        }), "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,
+            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,
+        }), "compaction_failed");
+    });
+    it("returns no_reply when deliver invoked but all plugin-skipped", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 3,
+            deliverCallCount: 0,
+        }), "no_reply");
+    });
+    it("returns no_reply for silent turn without deliver", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+        }), "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,
+        }), "timeout");
+    });
+});
+describe("shouldSendTerminalHttpForState", () => {
+    it("suppresses HTTP for intentional NO_REPLY silent skip", () => {
+        assert.equal(shouldSendTerminalHttpForState("no_reply", { normalizerSilentSkip: true }), false);
+    });
+    it("keeps HTTP for genuine empty deliver", () => {
+        assert.equal(shouldSendTerminalHttpForState("no_reply", {
+            normalizerSilentSkip: false,
+            normalizerHeartbeatSkip: false,
+        }), true);
+    });
+});
+describe("resolveNoReplyCause", () => {
+    it("classifies intentional silent", () => {
+        assert.equal(resolveNoReplyCause({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+            normalizerSilentSkip: true,
+        }), "intentional_silent");
+    });
+});
+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");
+    });
+    it("does not send HTTP for intentional NO_REPLY silent skip", async () => {
+        const controller = new InboundTerminalController({
+            messageId: "msg-3003",
+            groupId: "g3",
+            sessionKey: "sk3",
+            log: noopLog,
+            logPrefix: "[test]",
+        });
+        controller.noteNormalizerSkip("silent");
+        let sendCount = 0;
+        const state = await controller.finalizeAndDeliver({
+            sendFn: async () => {
+                sendCount++;
+            },
+            dispatchThrew: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+        });
+        assert.equal(state, "no_reply");
+        assert.equal(sendCount, 0);
+    });
+});
+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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"}

package/dist/src/per-message-fallback-notice.d.ts

@@ -20,7 +20,7 @@ export declare function normalizeModelRefString(raw: string): string;
 export declare function parseFallbackNoticeEffectiveModelRef(noticeText: string): string | undefined;
 export declare function runtimeModelRefsMatch(requestedRaw: string | undefined, actualKey: string | undefined): boolean;
 /**
- * 是否应抑制发往 IM 的 fallback 运营通知。
+ * 是否应抑制发往 IM 的 fallback 运营通知（在通道已开启投递时的细粒度规则）。
  * - 无 ai_model：不抑制
  * - 有 ai_model 且通知中的实际模型与指定一致：抑制（误报）
  * - 有 ai_model 但实际模型不同：不抑制（真实 failover）
@@ -30,4 +30,14 @@ export declare function shouldSuppressPerMessageFallbackNotice(params: {
     requestedModelRaw: string | undefined;
     noticeText?: string;
 }): boolean;
+/**
+ * IM deliver 是否应抑制 fallback 运营通知。
+ * 默认不投递；仅 `deliverModelFallbackNotice: true` 时考虑下发，并仍过滤 ai_model 误报。
+ */
+export declare function shouldSuppressFallbackNoticeForIm(params: {
+    isFallbackNotice: boolean;
+    deliverModelFallbackNotice?: boolean;
+    requestedModelRaw?: string;
+    noticeText?: string;
+}): boolean;
 //# sourceMappingURL=per-message-fallback-notice.d.ts.map

package/dist/src/per-message-fallback-notice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"per-message-fallback-notice.d.ts","sourceRoot":"","sources":["../../src/per-message-fallback-notice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE,uDAAuD;AACvD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhF;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI3D;AAUD;;;;GAIG;AACH,wBAAgB,oCAAoC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO3F;AAED,wBAAgB,qBAAqB,CACjC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,GAAG,SAAS,GAC9B,OAAO,CAQT;AAED;;;;;GAKG;AACH,wBAAgB,sCAAsC,CAAC,MAAM,EAAE;IAC3D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAQV"}
+{"version":3,"file":"per-message-fallback-notice.d.ts","sourceRoot":"","sources":["../../src/per-message-fallback-notice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE,uDAAuD;AACvD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhF;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI3D;AAUD;;;;GAIG;AACH,wBAAgB,oCAAoC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO3F;AAED,wBAAgB,qBAAqB,CACjC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,GAAG,SAAS,GAC9B,OAAO,CAQT;AAED;;;;;GAKG;AACH,wBAAgB,sCAAsC,CAAC,MAAM,EAAE;IAC3D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAQV;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACtD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAQV"}

package/dist/src/per-message-fallback-notice.js

@@ -58,7 +58,7 @@ export function runtimeModelRefsMatch(requestedRaw, actualKey) {
     return false;
 }
 /**
- * 是否应抑制发往 IM 的 fallback 运营通知。
+ * 是否应抑制发往 IM 的 fallback 运营通知（在通道已开启投递时的细粒度规则）。
  * - 无 ai_model：不抑制
  * - 有 ai_model 且通知中的实际模型与指定一致：抑制（误报）
  * - 有 ai_model 但实际模型不同：不抑制（真实 failover）
@@ -75,4 +75,19 @@ export function shouldSuppressPerMessageFallbackNotice(params) {
         return false;
     return runtimeModelRefsMatch(params.requestedModelRaw, effectiveFromNotice);
 }
+/**
+ * IM deliver 是否应抑制 fallback 运营通知。
+ * 默认不投递；仅 `deliverModelFallbackNotice: true` 时考虑下发，并仍过滤 ai_model 误报。
+ */
+export function shouldSuppressFallbackNoticeForIm(params) {
+    if (!params.isFallbackNotice)
+        return false;
+    if (params.deliverModelFallbackNotice !== true)
+        return true;
+    return shouldSuppressPerMessageFallbackNotice({
+        isFallbackNotice: true,
+        requestedModelRaw: params.requestedModelRaw,
+        noticeText: params.noticeText,
+    });
+}
 //# sourceMappingURL=per-message-fallback-notice.js.map

package/dist/src/per-message-fallback-notice.js.map

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

package/dist/src/per-message-fallback-notice.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=per-message-fallback-notice.test.d.ts.map

package/dist/src/per-message-fallback-notice.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-message-fallback-notice.test.d.ts","sourceRoot":"","sources":["../../src/per-message-fallback-notice.test.ts"],"names":[],"mappings":""}

package/dist/src/per-message-fallback-notice.test.js

@@ -0,0 +1,47 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { shouldDeliverModelFallbackNoticeToIm } from "./channel-config.js";
+import { parseFallbackNoticeEffectiveModelRef, shouldSuppressFallbackNoticeForIm, shouldSuppressPerMessageFallbackNotice, } from "./per-message-fallback-notice.js";
+function cfg(overrides = {}) {
+    return { baseUrl: "https://example.com", ...overrides };
+}
+const FALLBACK_NOTICE = "↪️ Model Fallback: newapi-xgjk/minimax-latest-cloud (selected newapi-xgjk/gemini-latest-cloud; auth)";
+describe("model fallback notice for IM", () => {
+    it("shouldDeliverModelFallbackNoticeToIm is false unless explicitly true", () => {
+        assert.equal(shouldDeliverModelFallbackNoticeToIm(cfg()), false);
+        assert.equal(shouldDeliverModelFallbackNoticeToIm(cfg({ deliverModelFallbackNotice: false })), false);
+        assert.equal(shouldDeliverModelFallbackNoticeToIm(cfg({ deliverModelFallbackNotice: true })), true);
+    });
+    it("shouldSuppressFallbackNoticeForIm suppresses by default", () => {
+        assert.equal(shouldSuppressFallbackNoticeForIm({
+            isFallbackNotice: true,
+            noticeText: FALLBACK_NOTICE,
+        }), true);
+    });
+    it("shouldSuppressFallbackNoticeForIm delivers when enabled and not spurious", () => {
+        assert.equal(shouldSuppressFallbackNoticeForIm({
+            isFallbackNotice: true,
+            deliverModelFallbackNotice: true,
+            noticeText: FALLBACK_NOTICE,
+        }), false);
+    });
+    it("shouldSuppressFallbackNoticeForIm still suppresses spurious ai_model match when enabled", () => {
+        assert.equal(shouldSuppressFallbackNoticeForIm({
+            isFallbackNotice: true,
+            deliverModelFallbackNotice: true,
+            requestedModelRaw: "newapi-xgjk/minimax-latest-cloud",
+            noticeText: FALLBACK_NOTICE,
+        }), true);
+    });
+    it("parseFallbackNoticeEffectiveModelRef reads active model", () => {
+        assert.equal(parseFallbackNoticeEffectiveModelRef(FALLBACK_NOTICE), "newapi-xgjk/minimax-latest-cloud");
+    });
+    it("shouldSuppressPerMessageFallbackNotice ignores non-fallback payloads", () => {
+        assert.equal(shouldSuppressPerMessageFallbackNotice({
+            isFallbackNotice: false,
+            requestedModelRaw: "a/b",
+            noticeText: FALLBACK_NOTICE,
+        }), false);
+    });
+});
+//# sourceMappingURL=per-message-fallback-notice.test.js.map

package/dist/src/per-message-fallback-notice.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-message-fallback-notice.test.js","sourceRoot":"","sources":["../../src/per-message-fallback-notice.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,oCAAoC,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EACH,oCAAoC,EACpC,iCAAiC,EACjC,sCAAsC,GACzC,MAAM,kCAAkC,CAAC;AAG1C,SAAS,GAAG,CAAC,YAAiC,EAAE;IAC5C,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,GAAG,SAAS,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,eAAe,GACjB,sGAAsG,CAAC;AAE3G,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,GAAG,CAAC,EAAE,0BAA0B,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACtG,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,GAAG,CAAC,EAAE,0BAA0B,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACxG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,KAAK,CACR,iCAAiC,CAAC;YAC9B,gBAAgB,EAAE,IAAI;YACtB,UAAU,EAAE,eAAe;SAC9B,CAAC,EACF,IAAI,CACP,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAChF,MAAM,CAAC,KAAK,CACR,iCAAiC,CAAC;YAC9B,gBAAgB,EAAE,IAAI;YACtB,0BAA0B,EAAE,IAAI;YAChC,UAAU,EAAE,eAAe;SAC9B,CAAC,EACF,KAAK,CACR,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yFAAyF,EAAE,GAAG,EAAE;QAC/F,MAAM,CAAC,KAAK,CACR,iCAAiC,CAAC;YAC9B,gBAAgB,EAAE,IAAI;YACtB,0BAA0B,EAAE,IAAI;YAChC,iBAAiB,EAAE,kCAAkC;YACrD,UAAU,EAAE,eAAe;SAC9B,CAAC,EACF,IAAI,CACP,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,eAAe,CAAC,EAAE,kCAAkC,CAAC,CAAC;IAC5G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,KAAK,CACR,sCAAsC,CAAC;YACnC,gBAAgB,EAAE,KAAK;YACvB,iBAAiB,EAAE,KAAK;YACxB,UAAU,EAAE,eAAe;SAC9B,CAAC,EACF,KAAK,CACR,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/src/project-path-normalize.d.ts

@@ -8,8 +8,22 @@ export interface LocalRootSpec {
     kind: LocalRootKind;
     path: string;
 }
+/** 知识库目录 fileId（IM 信令 remoteRootFolderId → 同步服务 remoteRootFileId） */
+export declare function normalizeRemoteRootFolderId(raw: string): string;
 /** 知识库逻辑路径：去掉首部 `/`，统一为正斜杠分段 */
 export declare function normalizeRemoteRootFolderPath(raw: string): string;
+export interface ResolvedRemoteRoot {
+    /** 写入同步服务 body 的 remoteRootFileId */
+    remoteRootFileId?: string;
+    remoteRootFolderPath?: string;
+}
+/**
+ * 解析 upsert 远端根：remoteRootFolderId 优先；两者都填时 id 决定同步根，path 仍透传供 upload 前缀。
+ */
+export declare function resolveRemoteRootForSync(params: {
+    remoteRootFolderId?: string;
+    remoteRootFolderPath?: string;
+}): ResolvedRemoteRoot;
 /** 规范化 workspace 相对段（去 ./、前导 /、尾部 /，禁止 ..） */
 export declare function normalizeWorkspaceRelativeSegment(userPath: string): string;
 export declare function resolveLocalAbsolutePath(localRoot: LocalRootSpec, workspaceHostRoot: string | undefined): string;