@xgjktech/xg_cwork_im 1.19.28 → 1.19.29

package/dist/src/session-env-store.js

@@ -0,0 +1,328 @@
+/**
+ * 会话级环境变量存储：按 sessionKey 保存每个会话的 exec 环境变量，
+ * 供 before_tool_call 向 exec 子进程注入（多用户并发安全，不碰 process.env）。
+ *
+ * 语义：同一群内消息按当前会话写入；subagent 的权威父链由 OpenClaw
+ * Session 元数据提供，linkChildSession 仅保留作运行时兼容/性能回退。
+ *
+ * 持久化：仅持久化会话级 env（当前为 XG_OPENAPI_APP_KEY）。写入后防抖落盘到
+ * stateDir/xgjktech/session-env.json，openclaw 重启后恢复；subagent 父子链是
+ * 运行时关系，不持久化。baseUrl 等配置值不在此存储（hook 侧直接读配置）。
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getOrCreateShared, getSharedMap } from "./process-shared-store.js";
+export const XG_OPENAPI_APP_KEY = "XG_OPENAPI_APP_KEY";
+const MAX_ENV_VALUE_LENGTH = 256;
+const CHILD_LINK_MAX_DEPTH = 8;
+const CLEANUP_DELAY_MS = 24 * 60 * 60 * 1000;
+/** 持久化条目超过该时间未写入则加载时清理（不随运行时 TTL）。 */
+const PERSIST_TTL_MS = 24 * 60 * 60 * 1000;
+/** 落盘防抖窗口。 */
+const PERSIST_DEBOUNCE_MS = 300;
+const PERSIST_FILE_NAME = "session-env.json";
+const LOG_PREFIX = "[xg_cwork_im] [session-env]";
+const sessionEnvMap = getSharedMap("session-env-map");
+const sessionUpdatedAt = getSharedMap("session-env-updated-at");
+const sessionChildLinks = getSharedMap("session-env-child-links");
+const sessionUserContexts = getSharedMap("session-env-user-contexts");
+const cleanupTimers = getSharedMap("session-env-cleanup-timers");
+/** 持久化/初始化机器为进程级共享（跨模块重载只初始化/落盘一次，避免新代 init 覆盖旧代数据）。 */
+const persistHolder = getOrCreateShared("session-env-persist", () => ({
+    persistStateDir: undefined,
+    persistPath: undefined,
+    persistTimer: undefined,
+    persistDirty: false,
+    warnedPersistError: false,
+    loadedOnce: false,
+}));
+function isValidEnvKey(key) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(key);
+}
+function isUsableEnvValue(value) {
+    if (value.length === 0 || value.length > MAX_ENV_VALUE_LENGTH)
+        return false;
+    if (/[\0\r\n]/.test(value))
+        return false;
+    return true;
+}
+/** 过滤非法/危险 env 键值对（key 命名、长度、null 字节）。 */
+export function sanitizeSessionEnv(env) {
+    const out = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (isValidEnvKey(key) && isUsableEnvValue(value)) {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function clearCleanupTimer(sessionKey) {
+    const timer = cleanupTimers.get(sessionKey);
+    if (timer !== undefined) {
+        clearTimeout(timer);
+        cleanupTimers.delete(sessionKey);
+    }
+}
+function scheduleCleanup(sessionKey) {
+    clearCleanupTimer(sessionKey);
+    cleanupTimers.set(sessionKey, setTimeout(() => {
+        sessionEnvMap.delete(sessionKey);
+        sessionUpdatedAt.delete(sessionKey);
+        sessionChildLinks.delete(sessionKey);
+        sessionUserContexts.delete(sessionKey);
+        cleanupTimers.delete(sessionKey);
+    }, CLEANUP_DELAY_MS).unref?.());
+}
+function touch(sessionKey) {
+    if (sessionEnvMap.has(sessionKey)) {
+        scheduleCleanup(sessionKey);
+    }
+}
+function warnPersistError(message, cause) {
+    if (!persistHolder.warnedPersistError) {
+        persistHolder.warnedPersistError = true;
+        console.warn(`${LOG_PREFIX} ${message} 原因=${String(cause)}；本次进程降级为纯内存模式`);
+    }
+}
+function resolvePersistPath(stateDir) {
+    return join(stateDir, "xgjktech", PERSIST_FILE_NAME);
+}
+function persistNow() {
+    if (!persistHolder.persistPath)
+        return;
+    try {
+        const entries = {};
+        for (const [sessionKey, env] of sessionEnvMap) {
+            entries[sessionKey] = {
+                ...env,
+                updatedAt: sessionUpdatedAt.get(sessionKey) ?? Date.now(),
+            };
+        }
+        const payload = JSON.stringify({ version: 1, entries });
+        mkdirSync(dirname(persistHolder.persistPath), { recursive: true });
+        const tmpPath = `${persistHolder.persistPath}.tmp`;
+        writeFileSync(tmpPath, payload, "utf8");
+        renameSync(tmpPath, persistHolder.persistPath);
+    }
+    catch (cause) {
+        warnPersistError(`写入 ${persistHolder.persistPath ?? "<unset>"} 失败`, cause);
+    }
+}
+function markPersistDirty() {
+    if (!persistHolder.persistPath)
+        return;
+    persistHolder.persistDirty = true;
+    if (persistHolder.persistTimer)
+        return;
+    persistHolder.persistTimer = setTimeout(() => {
+        persistHolder.persistTimer = undefined;
+        if (persistHolder.persistDirty) {
+            persistHolder.persistDirty = false;
+            persistNow();
+        }
+    }, PERSIST_DEBOUNCE_MS).unref?.();
+}
+function loadPersistedEntries() {
+    if (!persistHolder.persistPath)
+        return;
+    let raw;
+    try {
+        raw = readFileSync(persistHolder.persistPath, "utf8");
+    }
+    catch (cause) {
+        if (cause.code !== "ENOENT") {
+            warnPersistError(`读取 ${persistHolder.persistPath} 失败`, cause);
+        }
+        return;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        const entries = isRecord(parsed) ? parsed.entries : undefined;
+        if (!isRecord(entries))
+            return;
+        const now = Date.now();
+        for (const [sessionKey, value] of Object.entries(entries)) {
+            if (!isRecord(value))
+                continue;
+            const rawUpdatedAt = value.updatedAt;
+            const updatedAt = typeof rawUpdatedAt === "number" ? rawUpdatedAt : 0;
+            if (now - updatedAt > PERSIST_TTL_MS)
+                continue;
+            const env = {};
+            for (const [key, val] of Object.entries(value)) {
+                if (key === "updatedAt")
+                    continue;
+                if (typeof val === "string")
+                    env[key] = val;
+            }
+            const sanitized = sanitizeSessionEnv(env);
+            if (Object.keys(sanitized).length === 0)
+                continue;
+            sessionEnvMap.set(sessionKey, sanitized);
+            sessionUpdatedAt.set(sessionKey, updatedAt || now);
+            scheduleCleanup(sessionKey);
+        }
+    }
+    catch (cause) {
+        warnPersistError(`解析 ${persistHolder.persistPath} 失败`, cause);
+    }
+}
+/**
+ * 初始化持久化（register(api) 时调用一次，传入 api.runtime.state.resolveStateDir()）。
+ * 读盘加载到内存；失败降级为纯内存模式，绝不抛。
+ * 进程级共享：整个进程只从磁盘加载一次，避免插件重载后新模块实例重新 init 覆盖共享内存态。
+ */
+export function initSessionEnvPersistence(stateDir) {
+    persistHolder.persistStateDir = stateDir;
+    persistHolder.persistPath = resolvePersistPath(stateDir);
+    persistHolder.warnedPersistError = false;
+    if (!persistHolder.loadedOnce) {
+        persistHolder.loadedOnce = true;
+        loadPersistedEntries();
+    }
+}
+/** 立即落盘（测试 / 进程退出钩子使用）。 */
+export function flushSessionEnvPersistence() {
+    if (persistHolder.persistTimer) {
+        clearTimeout(persistHolder.persistTimer);
+        persistHolder.persistTimer = undefined;
+    }
+    if (persistHolder.persistDirty) {
+        persistHolder.persistDirty = false;
+        persistNow();
+    }
+}
+/** 合并写入某个会话的 env（覆盖同 key；空/非法值会被过滤）。 */
+export function setSessionEnv(sessionKey, env) {
+    if (!sessionKey)
+        return;
+    const sanitized = sanitizeSessionEnv(env);
+    if (Object.keys(sanitized).length === 0)
+        return;
+    const current = sessionEnvMap.get(sessionKey) ?? {};
+    sessionEnvMap.set(sessionKey, { ...current, ...sanitized });
+    sessionUpdatedAt.set(sessionKey, Date.now());
+    scheduleCleanup(sessionKey);
+    markPersistDirty();
+}
+/** 设置/删除某个会话的单个 env 键；value 为 undefined 时删除。 */
+export function setSessionEnvEntry(sessionKey, key, value) {
+    if (!sessionKey || !isValidEnvKey(key))
+        return;
+    if (value === undefined || !isUsableEnvValue(value)) {
+        const current = sessionEnvMap.get(sessionKey);
+        if (!current)
+            return;
+        delete current[key];
+        sessionUpdatedAt.set(sessionKey, Date.now());
+        if (Object.keys(current).length === 0) {
+            sessionEnvMap.delete(sessionKey);
+            sessionUpdatedAt.delete(sessionKey);
+            clearCleanupTimer(sessionKey);
+        }
+        markPersistDirty();
+        return;
+    }
+    const current = sessionEnvMap.get(sessionKey) ?? {};
+    current[key] = value;
+    sessionEnvMap.set(sessionKey, current);
+    sessionUpdatedAt.set(sessionKey, Date.now());
+    scheduleCleanup(sessionKey);
+    markPersistDirty();
+}
+/** 读取某个会话的 env 快照（浅拷贝）。 */
+export function getSessionEnv(sessionKey) {
+    if (!sessionKey)
+        return undefined;
+    const env = sessionEnvMap.get(sessionKey);
+    if (!env)
+        return undefined;
+    touch(sessionKey);
+    return { ...env };
+}
+/** 清空某个会话的 env 与父子关联。 */
+export function clearSessionEnv(sessionKey) {
+    if (!sessionKey)
+        return;
+    sessionEnvMap.delete(sessionKey);
+    sessionUpdatedAt.delete(sessionKey);
+    sessionChildLinks.delete(sessionKey);
+    clearCleanupTimer(sessionKey);
+    markPersistDirty();
+}
+/** 删除某个会话的单个 env 键。 */
+export function removeSessionEnvKey(sessionKey, key) {
+    setSessionEnvEntry(sessionKey, key, undefined);
+}
+/** 登记 subagent 子会话到父会话的关联，供 exec env 父子链反查。 */
+export function linkChildSession(childSessionKey, parentSessionKey) {
+    if (!childSessionKey || !parentSessionKey || childSessionKey === parentSessionKey)
+        return;
+    sessionChildLinks.set(childSessionKey, parentSessionKey);
+    scheduleCleanup(childSessionKey);
+}
+/** 读取运行时登记的 child -> parent 关系；仅作为宿主父链不可用时的兼容回退。 */
+export function getLinkedParentSessionKey(sessionKey) {
+    return sessionKey ? sessionChildLinks.get(sessionKey) : undefined;
+}
+/** Record the last IM sender for optional Cron binding audit metadata. */
+export function setSessionUserContext(sessionKey, userId, userName) {
+    if (!sessionKey || (!userId && !userName))
+        return;
+    sessionUserContexts.set(sessionKey, { userId, userName });
+}
+export function getSessionUserContext(sessionKey) {
+    return sessionKey ? sessionUserContexts.get(sessionKey) : undefined;
+}
+/**
+ * 解析某个会话应注入 exec 的 env：先查本会话；查不到则沿 subagent 父子链
+ * 反查父会话（限深，防环）。subagent 内 exec 触发 hook 时 sessionKey 是子会话 key。
+ */
+export function resolveEnvForSession(sessionKey) {
+    if (!sessionKey)
+        return {};
+    const own = getSessionEnv(sessionKey);
+    if (own && Object.keys(own).length > 0)
+        return own;
+    let currentKey = sessionKey;
+    for (let depth = 0; depth < CHILD_LINK_MAX_DEPTH; depth += 1) {
+        const parentKey = sessionChildLinks.get(currentKey);
+        if (!parentKey)
+            return {};
+        const parentEnv = getSessionEnv(parentKey);
+        if (parentEnv && Object.keys(parentEnv).length > 0)
+            return parentEnv;
+        currentKey = parentKey;
+    }
+    return {};
+}
+export function __resetSessionEnvStoreForTests() {
+    disposeSessionEnvStore();
+}
+/**
+ * 插件真卸载/网关停止时：先把待写数据落盘，再清空共享内存与定时器并复位持久化机器
+ * （下次进程/重载可重新从磁盘加载）。注意：热重载接管场景不应调用本函数（见 plugin-dispose）。
+ */
+export function disposeSessionEnvStore() {
+    flushSessionEnvPersistence();
+    sessionEnvMap.clear();
+    sessionUpdatedAt.clear();
+    sessionChildLinks.clear();
+    sessionUserContexts.clear();
+    for (const timer of cleanupTimers.values()) {
+        clearTimeout(timer);
+    }
+    cleanupTimers.clear();
+    if (persistHolder.persistTimer) {
+        clearTimeout(persistHolder.persistTimer);
+        persistHolder.persistTimer = undefined;
+    }
+    persistHolder.persistStateDir = undefined;
+    persistHolder.persistPath = undefined;
+    persistHolder.warnedPersistError = false;
+    persistHolder.loadedOnce = false;
+}
+//# sourceMappingURL=session-env-store.js.map

package/dist/src/session-env-store.js.map

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

package/dist/src/session-env-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-env-store.test.d.ts.map

package/dist/src/session-env-store.test.d.ts.map

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

package/dist/src/session-env-store.test.js

@@ -0,0 +1,151 @@
+import assert from "node:assert/strict";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, it } from "node:test";
+import { __resetSessionEnvStoreForTests, clearSessionEnv, flushSessionEnvPersistence, getSessionEnv, initSessionEnvPersistence, linkChildSession, removeSessionEnvKey, resolveEnvForSession, sanitizeSessionEnv, setSessionEnv, setSessionEnvEntry, XG_OPENAPI_APP_KEY, } from "./session-env-store.js";
+afterEach(() => __resetSessionEnvStoreForTests());
+describe("session env store", () => {
+    it("按 sessionKey 读写并合并覆盖", () => {
+        setSessionEnvEntry("session-a", XG_OPENAPI_APP_KEY, "key-a");
+        assert.deepEqual(getSessionEnv("session-a"), { [XG_OPENAPI_APP_KEY]: "key-a" });
+        setSessionEnvEntry("session-a", XG_OPENAPI_APP_KEY, "key-a-2");
+        assert.deepEqual(getSessionEnv("session-a"), { [XG_OPENAPI_APP_KEY]: "key-a-2" });
+        setSessionEnv("session-a", { OTHER_ENV: "v" });
+        assert.deepEqual(getSessionEnv("session-a"), {
+            [XG_OPENAPI_APP_KEY]: "key-a-2",
+            OTHER_ENV: "v",
+        });
+    });
+    it("setSessionEnvEntry 传 undefined 删除键，删除后空会话被回收", () => {
+        setSessionEnvEntry("session-a", XG_OPENAPI_APP_KEY, "key-a");
+        setSessionEnvEntry("session-a", XG_OPENAPI_APP_KEY, undefined);
+        assert.deepEqual(getSessionEnv("session-a"), undefined);
+        assert.deepEqual(resolveEnvForSession("session-a"), {});
+    });
+    it("removeSessionEnvKey 删除单个键", () => {
+        setSessionEnv("session-a", { [XG_OPENAPI_APP_KEY]: "k", OTHER_ENV: "v" });
+        removeSessionEnvKey("session-a", XG_OPENAPI_APP_KEY);
+        assert.deepEqual(getSessionEnv("session-a"), { OTHER_ENV: "v" });
+    });
+    it("clearSessionEnv 清空 env 与父子关联", () => {
+        setSessionEnvEntry("session-a", XG_OPENAPI_APP_KEY, "k");
+        linkChildSession("child", "session-a");
+        clearSessionEnv("session-a");
+        assert.deepEqual(resolveEnvForSession("child"), {});
+    });
+    it("sanitizeSessionEnv 过滤非法 key、空值、超长值、控制字符", () => {
+        assert.deepEqual(sanitizeSessionEnv({
+            GOOD_KEY: "ok",
+            "bad-key": "v",
+            "1BAD": "v",
+            EMPTY: "",
+            TOO_LONG: "x".repeat(257),
+            NULL_BYTE: "a\0b",
+            CR: "a\rb",
+            LF: "a\nb",
+        }), { GOOD_KEY: "ok" });
+    });
+    it("resolveEnvForSession 本会话优先", () => {
+        setSessionEnvEntry("session-a", XG_OPENAPI_APP_KEY, "key-a");
+        linkChildSession("child", "session-a");
+        assert.deepEqual(resolveEnvForSession("session-a"), { [XG_OPENAPI_APP_KEY]: "key-a" });
+        assert.deepEqual(resolveEnvForSession("child"), { [XG_OPENAPI_APP_KEY]: "key-a" });
+    });
+    it("resolveEnvForSession 沿父子链反查并防环限深", () => {
+        linkChildSession("c1", "c2");
+        linkChildSession("c2", "c1");
+        assert.deepEqual(resolveEnvForSession("c1"), {});
+        setSessionEnvEntry("deep-parent", XG_OPENAPI_APP_KEY, "kp");
+        let key = "deep-child";
+        for (let i = 0; i < 5; i += 1) {
+            linkChildSession(key, `parent-${i}`);
+            key = `parent-${i}`;
+        }
+        linkChildSession(key, "deep-parent");
+        assert.deepEqual(resolveEnvForSession("deep-child"), { [XG_OPENAPI_APP_KEY]: "kp" });
+    });
+    it("子会话与父会话相同时不建立关联", () => {
+        linkChildSession("same", "same");
+        assert.deepEqual(resolveEnvForSession("same"), {});
+    });
+    it("空 sessionKey 返回空 env", () => {
+        assert.deepEqual(resolveEnvForSession(undefined), {});
+        assert.deepEqual(resolveEnvForSession(""), {});
+        setSessionEnv("", { [XG_OPENAPI_APP_KEY]: "k" });
+        assert.deepEqual(getSessionEnv(""), undefined);
+    });
+});
+describe("session env store persistence", () => {
+    function makeStateDir() {
+        return mkdtempSync(join(tmpdir(), "xg-session-env-test-"));
+    }
+    function persistFileFor(stateDir) {
+        return join(stateDir, "xgjktech", "session-env.json");
+    }
+    it("flush 落盘后 reset + init 同目录可恢复", () => {
+        const stateDir = makeStateDir();
+        initSessionEnvPersistence(stateDir);
+        setSessionEnvEntry("session-a", XG_OPENAPI_APP_KEY, "key-a");
+        setSessionEnvEntry("session-b", XG_OPENAPI_APP_KEY, "key-b");
+        flushSessionEnvPersistence();
+        assert.equal(existsSync(persistFileFor(stateDir)), true);
+        __resetSessionEnvStoreForTests();
+        initSessionEnvPersistence(stateDir);
+        assert.deepEqual(getSessionEnv("session-a"), { [XG_OPENAPI_APP_KEY]: "key-a" });
+        assert.deepEqual(getSessionEnv("session-b"), { [XG_OPENAPI_APP_KEY]: "key-b" });
+    });
+    it("删除键后 flush 不再含该键；清空会话后文件同步清空", () => {
+        const stateDir = makeStateDir();
+        initSessionEnvPersistence(stateDir);
+        setSessionEnvEntry("session-a", XG_OPENAPI_APP_KEY, "key-a");
+        setSessionEnvEntry("session-b", XG_OPENAPI_APP_KEY, "key-b");
+        removeSessionEnvKey("session-a", XG_OPENAPI_APP_KEY);
+        clearSessionEnv("session-b");
+        flushSessionEnvPersistence();
+        __resetSessionEnvStoreForTests();
+        initSessionEnvPersistence(stateDir);
+        assert.deepEqual(getSessionEnv("session-a"), undefined);
+        assert.deepEqual(getSessionEnv("session-b"), undefined);
+    });
+    it("加载时清理超过持久化 TTL 的过期条目", () => {
+        const stateDir = makeStateDir();
+        const file = persistFileFor(stateDir);
+        mkdirSync(join(stateDir, "xgjktech"), { recursive: true });
+        const stale = Date.now() - 25 * 60 * 60 * 1000;
+        writeFileSync(file, JSON.stringify({
+            version: 1,
+            entries: {
+                stale: { [XG_OPENAPI_APP_KEY]: "old", updatedAt: stale },
+                fresh: { [XG_OPENAPI_APP_KEY]: "new", updatedAt: Date.now() },
+            },
+        }), "utf8");
+        __resetSessionEnvStoreForTests();
+        initSessionEnvPersistence(stateDir);
+        assert.deepEqual(getSessionEnv("stale"), undefined);
+        assert.deepEqual(getSessionEnv("fresh"), { [XG_OPENAPI_APP_KEY]: "new" });
+    });
+    it("持久化目录被普通文件占据时读失败降级为纯内存，不抛", () => {
+        const stateDir = makeStateDir();
+        const namespace = join(stateDir, "xgjktech");
+        writeFileSync(namespace, "i am a file", "utf8");
+        __resetSessionEnvStoreForTests();
+        assert.doesNotThrow(() => initSessionEnvPersistence(stateDir));
+        setSessionEnvEntry("session-a", XG_OPENAPI_APP_KEY, "key-a");
+        assert.deepEqual(getSessionEnv("session-a"), { [XG_OPENAPI_APP_KEY]: "key-a" });
+    });
+    it("防抖自动落盘", async () => {
+        const stateDir = makeStateDir();
+        initSessionEnvPersistence(stateDir);
+        setSessionEnvEntry("session-a", XG_OPENAPI_APP_KEY, "key-a");
+        await new Promise((resolve) => setTimeout(resolve, 450));
+        assert.equal(existsSync(persistFileFor(stateDir)), true);
+        const parsed = JSON.parse(readFileSync(persistFileFor(stateDir), "utf8"));
+        assert.deepEqual(parsed.entries["session-a"], {
+            [XG_OPENAPI_APP_KEY]: "key-a",
+            updatedAt: parsed.entries["session-a"].updatedAt,
+        });
+    });
+});
+//# sourceMappingURL=session-env-store.test.js.map

package/dist/src/session-env-store.test.js.map

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

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

@@ -0,0 +1,34 @@
+/**
+ * 会话级「群背景」缓存（跨回合续轮补注入）。
+ *
+ * 背景：`GroupSystemPrompt` 由入站 @ 回合构建并注入（`account-connection.ts` → `inboundCtx`），
+ * 而 heartbeat / exec 完成唤醒等**自触发回合**没有入站消息，OpenClaw 不会重新注入，
+ * 导致 agent 在续轮丢失 `userInfo.background` + `agentContext`（「待办背景未带入」）。
+ *
+ * 本缓存只保存**动态段**（用户块 + 项目块，见 `resolveInboundGroupPromptParts`），
+ * 不含配置里的静态段；最新一轮动态段为空时**清空**，避免把过期背景补进续轮。
+ *
+ * 过期与容量：TTL + 条目上限双重兜底，防止无界增长；进程级共享，跨热重载存活。
+ */
+export interface SessionGroupPrompt {
+    /** 最近一次入站构建的动态段（已 trim，非空）。 */
+    prompt: string;
+    /** 最近一次写入时间（TTL 判定用）。 */
+    updatedAt: number;
+}
+/**
+ * 记录一次入站构建的群背景动态段。
+ *
+ * - `prompt` 非空 → 覆盖写入并刷新 `updatedAt`；
+ * - `prompt` 为空 / undefined → **删除该会话缓存**（最新一轮没有背景，续轮不得复用旧背景）。
+ */
+export declare function setSessionGroupPrompt(sessionKey: string | undefined, prompt: string | undefined): void;
+/** 读取某会话最近一次入站构建的群背景动态段（过期返回 undefined）。 */
+export declare function getSessionGroupPrompt(sessionKey: string | undefined): string | undefined;
+/** 清除某会话的群背景缓存。 */
+export declare function clearSessionGroupPrompt(sessionKey: string | undefined): void;
+/** 插件卸载/重载时清空全部缓存。 */
+export declare function clearAllSessionGroupPrompts(): void;
+/** 仅供测试：内部条目数。 */
+export declare function __sessionGroupPromptSizeForTests(): number;
+//# sourceMappingURL=session-group-prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-group-prompt.d.ts","sourceRoot":"","sources":["../../src/session-group-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,kBAAkB;IAC/B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACrB;AAyCD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgBtG;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUxF;AAED,mBAAmB;AACnB,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI5E;AAED,sBAAsB;AACtB,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,kBAAkB;AAClB,wBAAgB,gCAAgC,IAAI,MAAM,CAEzD"}

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

@@ -0,0 +1,101 @@
+/**
+ * 会话级「群背景」缓存（跨回合续轮补注入）。
+ *
+ * 背景：`GroupSystemPrompt` 由入站 @ 回合构建并注入（`account-connection.ts` → `inboundCtx`），
+ * 而 heartbeat / exec 完成唤醒等**自触发回合**没有入站消息，OpenClaw 不会重新注入，
+ * 导致 agent 在续轮丢失 `userInfo.background` + `agentContext`（「待办背景未带入」）。
+ *
+ * 本缓存只保存**动态段**（用户块 + 项目块，见 `resolveInboundGroupPromptParts`），
+ * 不含配置里的静态段；最新一轮动态段为空时**清空**，避免把过期背景补进续轮。
+ *
+ * 过期与容量：TTL + 条目上限双重兜底，防止无界增长；进程级共享，跨热重载存活。
+ */
+import { getSharedMap } from "./process-shared-store.js";
+/** 条目上限（防御无界增长）。 */
+const MAX_ENTRIES = 500;
+/**
+ * 条目有效期。唤醒轮多为 **exec 完成唤醒**，后台任务时长可达小时级，故取 24h 覆盖长任务；
+ * 内存由 `MAX_ENTRIES` 兜底，TTL 只负责防陈旧（下一次被 @ 的入站轮会覆盖或清空）。
+ */
+const TTL_MS = 24 * 60 * 60 * 1000;
+const bySessionKey = getSharedMap("session-group-prompt");
+function nonEmpty(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const text = value.trim();
+    return text.length > 0 ? text : undefined;
+}
+function pruneExpired(now) {
+    for (const [key, entry] of bySessionKey) {
+        if (now - entry.updatedAt > TTL_MS) {
+            bySessionKey.delete(key);
+        }
+    }
+}
+function evictOldestIfOverCapacity() {
+    if (bySessionKey.size < MAX_ENTRIES)
+        return;
+    let oldestKey;
+    let oldestAt = Number.POSITIVE_INFINITY;
+    for (const [key, entry] of bySessionKey) {
+        if (entry.updatedAt < oldestAt) {
+            oldestAt = entry.updatedAt;
+            oldestKey = key;
+        }
+    }
+    if (oldestKey !== undefined) {
+        bySessionKey.delete(oldestKey);
+    }
+}
+/**
+ * 记录一次入站构建的群背景动态段。
+ *
+ * - `prompt` 非空 → 覆盖写入并刷新 `updatedAt`；
+ * - `prompt` 为空 / undefined → **删除该会话缓存**（最新一轮没有背景，续轮不得复用旧背景）。
+ */
+export function setSessionGroupPrompt(sessionKey, prompt) {
+    const key = nonEmpty(sessionKey);
+    if (!key)
+        return;
+    const text = nonEmpty(prompt);
+    if (!text) {
+        bySessionKey.delete(key);
+        return;
+    }
+    const now = Date.now();
+    pruneExpired(now);
+    if (!bySessionKey.has(key)) {
+        evictOldestIfOverCapacity();
+    }
+    bySessionKey.set(key, { prompt: text, updatedAt: now });
+}
+/** 读取某会话最近一次入站构建的群背景动态段（过期返回 undefined）。 */
+export function getSessionGroupPrompt(sessionKey) {
+    const key = nonEmpty(sessionKey);
+    if (!key)
+        return undefined;
+    const entry = bySessionKey.get(key);
+    if (!entry)
+        return undefined;
+    if (Date.now() - entry.updatedAt > TTL_MS) {
+        bySessionKey.delete(key);
+        return undefined;
+    }
+    return entry.prompt;
+}
+/** 清除某会话的群背景缓存。 */
+export function clearSessionGroupPrompt(sessionKey) {
+    const key = nonEmpty(sessionKey);
+    if (!key)
+        return;
+    bySessionKey.delete(key);
+}
+/** 插件卸载/重载时清空全部缓存。 */
+export function clearAllSessionGroupPrompts() {
+    bySessionKey.clear();
+}
+/** 仅供测试：内部条目数。 */
+export function __sessionGroupPromptSizeForTests() {
+    return bySessionKey.size;
+}
+//# sourceMappingURL=session-group-prompt.js.map