@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/session/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/session/inbound-model.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-model.test.js","sourceRoot":"","sources":["../../../src/session/inbound-model.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACH,4BAA4B,EAC5B,qBAAqB,EACrB,8BAA8B,EAC9B,yBAAyB,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,GAAG,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AAE5E,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;QACnB,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC,EAAE;YAC9E,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,sBAAsB;SAChC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,gCAAgC,CAAC,EAAE;YAC1F,IAAI,EAAE,SAAS;SAClB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACxG,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QACjF,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9D,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACxE,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACxE,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * IM 单轮 ai_model 与 OpenClaw isFallbackNotice 的协调。
+ * 仅当用户指定模型与通知中的「实际使用模型」一致时，抑制误报。
+ *
+ * 注意：onModelSelected 在 failover 候选启动时触发，早于 before_model_resolve，
+ * 不能作为「实际 API 模型」依据；以通知正文中的 active/selected 为准。
+ */
+export type RuntimeModelRef = {
+    provider: string;
+    model: string;
+};
+/** OpenClaw 侧 model ref 规范化：provider/model 均转小写便于比较 */
+export declare function normalizeRuntimeModelRef(provider: string, model: string): string;
+export declare function normalizeModelRefString(raw: string): string;
+/**
+ * 从 OpenClaw fallback 运营通知正文解析「实际/恢复」的模型 ref。
+ * - `↪️ Model Fallback: <active> (selected …`
+ * - `↪️ Model Fallback cleared: <selected> (was …`
+ */
+export declare function parseFallbackNoticeEffectiveModelRef(noticeText: string): string | undefined;
+export declare function runtimeModelRefsMatch(requestedRaw: string | undefined, actualKey: string | undefined): boolean;
+/**
+ * 是否应抑制发往 IM 的 fallback 运营通知（在通道已开启投递时的细粒度规则）。
+ * - 无 ai_model：不抑制
+ * - 有 ai_model 且通知中的实际模型与指定一致：抑制（误报）
+ * - 有 ai_model 但实际模型不同：不抑制（真实 failover）
+ */
+export declare function shouldSuppressPerMessageFallbackNotice(params: {
+    isFallbackNotice: boolean;
+    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/session/per-message-fallback-notice.d.ts.map

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

@@ -0,0 +1,93 @@
+/**
+ * IM 单轮 ai_model 与 OpenClaw isFallbackNotice 的协调。
+ * 仅当用户指定模型与通知中的「实际使用模型」一致时，抑制误报。
+ *
+ * 注意：onModelSelected 在 failover 候选启动时触发，早于 before_model_resolve，
+ * 不能作为「实际 API 模型」依据；以通知正文中的 active/selected 为准。
+ */
+import { splitModelRef } from "./per-message-model-pending.js";
+/** OpenClaw 侧 model ref 规范化：provider/model 均转小写便于比较 */
+export function normalizeRuntimeModelRef(provider, model) {
+    const p = provider.trim().toLowerCase();
+    const m = model.trim().toLowerCase();
+    if (!p || !m)
+        return "";
+    return `${p}/${m}`;
+}
+export function normalizeModelRefString(raw) {
+    const parsed = splitModelRef(raw);
+    if (!parsed?.provider)
+        return parsed?.model.trim().toLowerCase() ?? "";
+    return normalizeRuntimeModelRef(parsed.provider, parsed.model);
+}
+/** 通知 token 已是 provider/model 或单段 model id */
+function normalizeNoticeModelToken(token) {
+    const t = token.trim().toLowerCase();
+    if (!t)
+        return "";
+    if (t.includes("/"))
+        return t;
+    return t;
+}
+/**
+ * 从 OpenClaw fallback 运营通知正文解析「实际/恢复」的模型 ref。
+ * - `↪️ Model Fallback: <active> (selected …`
+ * - `↪️ Model Fallback cleared: <selected> (was …`
+ */
+export function parseFallbackNoticeEffectiveModelRef(noticeText) {
+    const text = noticeText.trim();
+    const activeMatch = /^↪️\s*Model Fallback:\s*(\S+)\s*\(/u.exec(text);
+    if (activeMatch?.[1])
+        return normalizeNoticeModelToken(activeMatch[1]);
+    const clearedMatch = /^↪️\s*Model Fallback cleared:\s*(\S+)/u.exec(text);
+    if (clearedMatch?.[1])
+        return normalizeNoticeModelToken(clearedMatch[1]);
+    return undefined;
+}
+export function runtimeModelRefsMatch(requestedRaw, actualKey) {
+    if (!requestedRaw?.trim() || !actualKey?.trim())
+        return false;
+    const requestedKey = normalizeModelRefString(requestedRaw);
+    if (!requestedKey || !actualKey)
+        return false;
+    if (requestedKey === actualKey)
+        return true;
+    // 别名-only 请求（如 "minimax"）与全名（provider/minimax-latest-cloud）无法在此展开，保守不匹配
+    if (!requestedKey.includes("/") && actualKey.endsWith(`/${requestedKey}`))
+        return true;
+    return false;
+}
+/**
+ * 是否应抑制发往 IM 的 fallback 运营通知（在通道已开启投递时的细粒度规则）。
+ * - 无 ai_model：不抑制
+ * - 有 ai_model 且通知中的实际模型与指定一致：抑制（误报）
+ * - 有 ai_model 但实际模型不同：不抑制（真实 failover）
+ */
+export function shouldSuppressPerMessageFallbackNotice(params) {
+    if (!params.isFallbackNotice)
+        return false;
+    if (!params.requestedModelRaw?.trim())
+        return false;
+    const effectiveFromNotice = params.noticeText
+        ? parseFallbackNoticeEffectiveModelRef(params.noticeText)
+        : undefined;
+    if (!effectiveFromNotice)
+        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/session/per-message-fallback-notice.js.map

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

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

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

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

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

package/dist/src/session/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 "../plugin/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/session/per-message-fallback-notice.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-message-fallback-notice.test.js","sourceRoot":"","sources":["../../../src/session/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,6BAA6B,CAAC;AACnF,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/session/per-message-model-pending.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 单轮模型覆盖：在 dispatch 前登记，由 before_model_resolve 消费。
+ *
+ * 语义：
+ * - 覆盖只作用于本轮回复的「首次模型解析」（runId 首次调用）；模型 fallback 重试不重复覆盖。
+ * - 若登记时该 session 正处于自动降级（modelOverrideSource === "auto"）且用户点名的正是降级来源
+ *   （被冷却/额度跳过的原模型），则放弃覆盖，避免把降级候选改回不可用的原模型。
+ *
+ * 注意：OpenClaw 的 replyOptions 并不消费 modelOverride（该字段仅 2026.5.17~2026.5.22 短暂存在，
+ * 用于 WebChat 图片模型路由，之后已移除）。因此本机制是单轮模型覆盖的唯一生效通道。
+ */
+import type { SessionEntry } from "openclaw/plugin-sdk/session-store-runtime";
+export interface PendingPerMessageModelFallbackOrigin {
+    provider?: string;
+    model: string;
+}
+/** 登记时该 session 的自动降级上下文。 */
+export interface SessionModelFallbackContext {
+    sessionInAutoFallback: boolean;
+    fallbackOrigin?: PendingPerMessageModelFallbackOrigin;
+}
+export interface PendingPerMessageModel extends SessionModelFallbackContext {
+    /** 原始 model ref，如 xgjk-newapi/MiniMax-M2.7-Cloud */
+    raw: string;
+    provider?: string;
+    model: string;
+}
+export declare function normalizeModelRefRaw(raw: string): string;
+/** 将 provider/model 或别名拆成 hook 可用的字段 */
+export declare function splitModelRef(raw: string): PendingPerMessageModel | undefined;
+/** 比较用归一化 key：有 provider 时 `provider/model`，否则仅 model。 */
+export declare function normalizeModelRefForCompare(provider: string | undefined, model: string | undefined): string;
+/**
+ * 用户点名的目标模型是否就是当前自动降级的来源模型。
+ * 先比对 model（大小写不敏感）；origin 带 provider 时再要求 provider 一致（目标未带 provider 视为通配）。
+ */
+export declare function targetMatchesFallbackOrigin(pending: PendingPerMessageModel): boolean;
+/** session 正处于自动降级，且目标就是降级来源时，放弃覆盖。 */
+export declare function shouldSkipOverrideForActiveFallback(pending: PendingPerMessageModel): boolean;
+/**
+ * 本轮 run 是否首次解析模型。模型 fallback 会为同一 runId 再次调用 before_model_resolve，
+ * 此时返回 false，避免降级候选被覆盖回主模型。runId 缺失时不限制。
+ */
+export declare function claimPerMessageModelRun(runId: string | undefined): boolean;
+/** 从 session entry 提取自动降级上下文（纯函数，便于单测）。 */
+export declare function resolveSessionFallbackContextFromEntry(entry: SessionEntry | undefined): SessionModelFallbackContext;
+export declare function setPendingPerMessageModel(sessionKey: string, raw: string, fallbackContext?: SessionModelFallbackContext): PendingPerMessageModel | undefined;
+export declare function takePendingPerMessageModel(sessionKey: string | undefined): PendingPerMessageModel | undefined;
+export declare function clearPendingPerMessageModel(sessionKey: string | undefined): void;
+/** 插件卸载/重载时清空全部待消费的单轮模型覆盖。 */
+export declare function clearAllPendingPerMessageModel(): void;
+//# sourceMappingURL=per-message-model-pending.d.ts.map

package/dist/src/session/per-message-model-pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-message-model-pending.d.ts","sourceRoot":"","sources":["../../../src/session/per-message-model-pending.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAG9E,MAAM,WAAW,oCAAoC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,6BAA6B;AAC7B,MAAM,WAAW,2BAA2B;IACxC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,oCAAoC,CAAC;CACzD;AAED,MAAM,WAAW,sBAAuB,SAAQ,2BAA2B;IACvE,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACjB;AAOD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAW7E;AAED,0DAA0D;AAC1D,wBAAgB,2BAA2B,CACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,GAC1B,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAQpF;AAED,uCAAuC;AACvC,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAE5F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAc1E;AAED,2CAA2C;AAC3C,wBAAgB,sCAAsC,CAClD,KAAK,EAAE,YAAY,GAAG,SAAS,GAChC,2BAA2B,CAmB7B;AAED,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,eAAe,CAAC,EAAE,2BAA2B,GAC9C,sBAAsB,GAAG,SAAS,CAUpC;AAED,wBAAgB,0BAA0B,CACtC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC/B,sBAAsB,GAAG,SAAS,CAMpC;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAGhF;AAED,8BAA8B;AAC9B,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD"}

package/dist/src/session/per-message-model-pending.js

@@ -0,0 +1,134 @@
+/**
+ * 单轮模型覆盖：在 dispatch 前登记，由 before_model_resolve 消费。
+ *
+ * 语义：
+ * - 覆盖只作用于本轮回复的「首次模型解析」（runId 首次调用）；模型 fallback 重试不重复覆盖。
+ * - 若登记时该 session 正处于自动降级（modelOverrideSource === "auto"）且用户点名的正是降级来源
+ *   （被冷却/额度跳过的原模型），则放弃覆盖，避免把降级候选改回不可用的原模型。
+ *
+ * 注意：OpenClaw 的 replyOptions 并不消费 modelOverride（该字段仅 2026.5.17~2026.5.22 短暂存在，
+ * 用于 WebChat 图片模型路由，之后已移除）。因此本机制是单轮模型覆盖的唯一生效通道。
+ */
+import { getSharedMap } from "../plugin/process-shared-store.js";
+const pendingBySessionKey = getSharedMap("pending-per-message-model");
+const appliedRunIds = getSharedMap("per-message-model-applied-run");
+const APPLIED_RUN_TTL_MS = 60 * 60_000;
+export function normalizeModelRefRaw(raw) {
+    return raw.trim().replace(/^["']|["']$/g, "").trim();
+}
+/** 将 provider/model 或别名拆成 hook 可用的字段 */
+export function splitModelRef(raw) {
+    const normalized = normalizeModelRefRaw(raw);
+    if (!normalized)
+        return undefined;
+    const slash = normalized.indexOf("/");
+    if (slash > 0) {
+        const provider = normalized.slice(0, slash).trim();
+        const model = normalized.slice(slash + 1).trim();
+        if (!provider || !model)
+            return undefined;
+        return { raw: normalized, provider, model, sessionInAutoFallback: false };
+    }
+    return { raw: normalized, model: normalized, sessionInAutoFallback: false };
+}
+/** 比较用归一化 key：有 provider 时 `provider/model`，否则仅 model。 */
+export function normalizeModelRefForCompare(provider, model) {
+    const p = (provider ?? "").trim().toLowerCase();
+    const m = (model ?? "").trim().toLowerCase();
+    if (!m)
+        return "";
+    return p ? `${p}/${m}` : m;
+}
+/**
+ * 用户点名的目标模型是否就是当前自动降级的来源模型。
+ * 先比对 model（大小写不敏感）；origin 带 provider 时再要求 provider 一致（目标未带 provider 视为通配）。
+ */
+export function targetMatchesFallbackOrigin(pending) {
+    const originModel = pending.fallbackOrigin?.model?.trim().toLowerCase() ?? "";
+    const targetModel = pending.model.trim().toLowerCase();
+    if (!originModel || !targetModel || originModel !== targetModel)
+        return false;
+    const originProvider = (pending.fallbackOrigin?.provider ?? "").trim().toLowerCase();
+    if (!originProvider)
+        return true;
+    const targetProvider = (pending.provider ?? "").trim().toLowerCase();
+    return targetProvider === "" || targetProvider === originProvider;
+}
+/** session 正处于自动降级，且目标就是降级来源时，放弃覆盖。 */
+export function shouldSkipOverrideForActiveFallback(pending) {
+    return pending.sessionInAutoFallback === true && targetMatchesFallbackOrigin(pending);
+}
+/**
+ * 本轮 run 是否首次解析模型。模型 fallback 会为同一 runId 再次调用 before_model_resolve，
+ * 此时返回 false，避免降级候选被覆盖回主模型。runId 缺失时不限制。
+ */
+export function claimPerMessageModelRun(runId) {
+    const key = runId?.trim();
+    if (!key)
+        return true;
+    const now = Date.now();
+    for (const [id, ts] of appliedRunIds) {
+        if (now - ts > APPLIED_RUN_TTL_MS) {
+            appliedRunIds.delete(id);
+        }
+    }
+    if (appliedRunIds.has(key)) {
+        return false;
+    }
+    appliedRunIds.set(key, now);
+    return true;
+}
+/** 从 session entry 提取自动降级上下文（纯函数，便于单测）。 */
+export function resolveSessionFallbackContextFromEntry(entry) {
+    if (!entry)
+        return { sessionInAutoFallback: false };
+    const originModel = entry.modelOverrideFallbackOriginModel?.trim();
+    const originProvider = entry.modelOverrideFallbackOriginProvider?.trim();
+    const sessionInAutoFallback = entry.modelOverrideSource === "auto";
+    if (!sessionInAutoFallback && !originModel) {
+        return { sessionInAutoFallback: false };
+    }
+    return {
+        sessionInAutoFallback,
+        ...(originModel
+            ? {
+                fallbackOrigin: {
+                    ...(originProvider ? { provider: originProvider } : {}),
+                    model: originModel,
+                },
+            }
+            : {}),
+    };
+}
+export function setPendingPerMessageModel(sessionKey, raw, fallbackContext) {
+    const parsed = splitModelRef(raw);
+    if (!parsed)
+        return undefined;
+    const pending = {
+        ...parsed,
+        sessionInAutoFallback: fallbackContext?.sessionInAutoFallback === true,
+        ...(fallbackContext?.fallbackOrigin ? { fallbackOrigin: fallbackContext.fallbackOrigin } : {}),
+    };
+    pendingBySessionKey.set(sessionKey, pending);
+    return pending;
+}
+export function takePendingPerMessageModel(sessionKey) {
+    if (!sessionKey?.trim())
+        return undefined;
+    const pending = pendingBySessionKey.get(sessionKey);
+    if (!pending)
+        return undefined;
+    pendingBySessionKey.delete(sessionKey);
+    return pending;
+}
+export function clearPendingPerMessageModel(sessionKey) {
+    if (!sessionKey?.trim())
+        return;
+    pendingBySessionKey.delete(sessionKey);
+}
+/** 插件卸载/重载时清空全部待消费的单轮模型覆盖。 */
+export function clearAllPendingPerMessageModel() {
+    pendingBySessionKey.clear();
+    appliedRunIds.clear();
+}
+//# sourceMappingURL=per-message-model-pending.js.map

package/dist/src/session/per-message-model-pending.js.map

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

package/dist/src/session/register-group-prompt-hook.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 续轮群背景补注入 hook。
+ *
+ * 问题：`GroupSystemPrompt`（`userInfo.background` + `agentContext`）只在入站 @ 回合注入，
+ * heartbeat / exec 完成唤醒等自触发回合没有入站消息，OpenClaw 不会重新注入，
+ * 导致 agent 在续轮丢失「待办背景」并反问用户补充材料。
+ *
+ * 方案：入站回合已把动态段写入 `session-group-prompt` 缓存（`account-connection.ts`），
+ * 这里在**非入站回合**把缓存补回模型上下文：
+ * - `heartbeat_prompt_contribution`：仅在 `trigger === "heartbeat"` 触发，返回 `prependContext`；
+ * - `before_prompt_build`：每轮都触发，因此跳过 `user`（core 已注入 GroupSystemPrompt）与
+ *   `heartbeat`（上一个钩子已处理），其余自触发回合（cron / tool / system / runtime_continue）
+ *   返回 `appendSystemContext` 进系统提示。
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-plugin-common";
+export declare function registerGroupPromptHook(api: OpenClawPluginApi): void;
+//# sourceMappingURL=register-group-prompt-hook.d.ts.map

package/dist/src/session/register-group-prompt-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-group-prompt-hook.d.ts","sourceRoot":"","sources":["../../../src/session/register-group-prompt-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAYnF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAkBpE"}

package/dist/src/session/register-group-prompt-hook.js

@@ -0,0 +1,45 @@
+/**
+ * 续轮群背景补注入 hook。
+ *
+ * 问题：`GroupSystemPrompt`（`userInfo.background` + `agentContext`）只在入站 @ 回合注入，
+ * heartbeat / exec 完成唤醒等自触发回合没有入站消息，OpenClaw 不会重新注入，
+ * 导致 agent 在续轮丢失「待办背景」并反问用户补充材料。
+ *
+ * 方案：入站回合已把动态段写入 `session-group-prompt` 缓存（`account-connection.ts`），
+ * 这里在**非入站回合**把缓存补回模型上下文：
+ * - `heartbeat_prompt_contribution`：仅在 `trigger === "heartbeat"` 触发，返回 `prependContext`；
+ * - `before_prompt_build`：每轮都触发，因此跳过 `user`（core 已注入 GroupSystemPrompt）与
+ *   `heartbeat`（上一个钩子已处理），其余自触发回合（cron / tool / system / runtime_continue）
+ *   返回 `appendSystemContext` 进系统提示。
+ */
+import { getSessionGroupPrompt } from "./session-group-prompt.js";
+/** 注入标题：让模型知道这是此前 @ 消息下发的会话背景，而不是新一轮用户输入。 */
+const INJECTION_HEADER = "以下为本会话群背景（由此前 @ 消息下发，供续轮参考）：";
+function buildInjection(sessionKey) {
+    const cached = getSessionGroupPrompt(sessionKey);
+    if (!cached)
+        return undefined;
+    return `${INJECTION_HEADER}\n\n${cached}`;
+}
+export function registerGroupPromptHook(api) {
+    // heartbeat 回合（含 exec 完成唤醒，OpenClaw 归为 trigger=heartbeat）：天然不与入站回合重复。
+    api.on("heartbeat_prompt_contribution", (_event, ctx) => {
+        const text = buildInjection(ctx?.sessionKey);
+        if (!text)
+            return;
+        return { prependContext: text };
+    });
+    // 其余自触发回合：before_prompt_build 每轮（含回合内每次模型调用）都会跑，
+    // 必须跳过 user（core 已把 GroupSystemPrompt 写进系统提示）与 heartbeat（已由上面的钩子处理），
+    // 否则同一份背景会被重复注入。
+    api.on("before_prompt_build", (_event, ctx) => {
+        const trigger = ctx?.trigger;
+        if (trigger === "user" || trigger === "heartbeat")
+            return;
+        const text = buildInjection(ctx?.sessionKey);
+        if (!text)
+            return;
+        return { appendSystemContext: text };
+    });
+}
+//# sourceMappingURL=register-group-prompt-hook.js.map

package/dist/src/session/register-group-prompt-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-group-prompt-hook.js","sourceRoot":"","sources":["../../../src/session/register-group-prompt-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,6CAA6C;AAC7C,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAExD,SAAS,cAAc,CAAC,UAA8B;IAClD,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,GAAG,gBAAgB,OAAO,MAAM,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAsB;IAC1D,sEAAsE;IACtE,GAAG,CAAC,EAAE,CAAC,+BAA+B,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QACpD,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,iDAAiD;IACjD,qEAAqE;IACrE,iBAAiB;IACjB,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QAC1C,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,CAAC;QAC7B,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,WAAW;YAAE,OAAO;QAC1D,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/session/register-group-prompt-hook.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register-group-prompt-hook.test.d.ts.map

package/dist/src/session/register-group-prompt-hook.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-group-prompt-hook.test.d.ts","sourceRoot":"","sources":["../../../src/session/register-group-prompt-hook.test.ts"],"names":[],"mappings":""}