@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/session/run-model-context.test.js

@@ -0,0 +1,68 @@
+import assert from "node:assert/strict";
+import { beforeEach, describe, it } from "node:test";
+import { __runModelContextSizeForTests, clearAllRunModelContext, clearRunModelContext, readRunModelContext, recordRunModelContext, } from "./run-model-context.js";
+describe("run-model-context", () => {
+    beforeEach(() => {
+        clearAllRunModelContext();
+    });
+    it("records and reads the latest llm_output context per session", () => {
+        recordRunModelContext("session-1", {
+            provider: "openai",
+            model: "gpt-5.5",
+            resolvedRef: "openai/gpt-5.5",
+            contextTokenBudget: 200_000,
+            contextWindowSource: "model",
+            contextWindowReferenceTokens: 200_000,
+            runId: "run-1",
+        });
+        const ctx = readRunModelContext("session-1");
+        assert.ok(ctx);
+        assert.equal(ctx.provider, "openai");
+        assert.equal(ctx.model, "gpt-5.5");
+        assert.equal(ctx.resolvedRef, "openai/gpt-5.5");
+        assert.equal(ctx.contextTokenBudget, 200_000);
+        assert.equal(ctx.contextWindowSource, "model");
+        assert.equal(ctx.contextWindowReferenceTokens, 200_000);
+        assert.equal(ctx.runId, "run-1");
+        assert.equal(typeof ctx.updatedAt, "number");
+    });
+    it("overwrites the previous entry for the same session", () => {
+        recordRunModelContext("session-1", { model: "a", contextTokenBudget: 100_000 });
+        recordRunModelContext("session-1", { model: "b", contextTokenBudget: 128_000 });
+        const ctx = readRunModelContext("session-1");
+        assert.equal(ctx.model, "b");
+        assert.equal(ctx.contextTokenBudget, 128_000);
+        assert.equal(__runModelContextSizeForTests(), 1);
+    });
+    it("isolates sessions", () => {
+        recordRunModelContext("session-1", { model: "a", contextTokenBudget: 100_000 });
+        recordRunModelContext("session-2", { model: "b", contextTokenBudget: 200_000 });
+        assert.equal(readRunModelContext("session-1").model, "a");
+        assert.equal(readRunModelContext("session-2").model, "b");
+        assert.equal(readRunModelContext("session-3"), undefined);
+    });
+    it("ignores empty session key and empty input", () => {
+        assert.equal(recordRunModelContext("", { model: "a" }), undefined);
+        assert.equal(recordRunModelContext(undefined, { model: "a" }), undefined);
+        const recorded = recordRunModelContext("session-1", {});
+        assert.ok(recorded);
+        assert.equal(recorded.model, undefined);
+        assert.equal(recorded.contextTokenBudget, undefined);
+    });
+    it("drops non-positive / non-finite context budgets", () => {
+        recordRunModelContext("session-1", { contextTokenBudget: 0 });
+        assert.equal(readRunModelContext("session-1").contextTokenBudget, undefined);
+        recordRunModelContext("session-1", { contextTokenBudget: -5 });
+        assert.equal(readRunModelContext("session-1").contextTokenBudget, undefined);
+        recordRunModelContext("session-1", { contextTokenBudget: Number.NaN });
+        assert.equal(readRunModelContext("session-1").contextTokenBudget, undefined);
+    });
+    it("clearRunModelContext removes a single session", () => {
+        recordRunModelContext("session-1", { model: "a" });
+        recordRunModelContext("session-2", { model: "b" });
+        clearRunModelContext("session-1");
+        assert.equal(readRunModelContext("session-1"), undefined);
+        assert.equal(readRunModelContext("session-2").model, "b");
+    });
+});
+//# sourceMappingURL=run-model-context.test.js.map

package/dist/src/session/run-model-context.test.js.map

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

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

@@ -0,0 +1,55 @@
+/**
+ * 会话级环境变量存储：按 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 侧直接读配置）。
+ */
+export declare const XG_OPENAPI_APP_KEY = "XG_OPENAPI_APP_KEY";
+/** 过滤非法/危险 env 键值对（key 命名、长度、null 字节）。 */
+export declare function sanitizeSessionEnv(env: Record<string, string>): Record<string, string>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * 初始化持久化（register(api) 时调用一次，传入 api.runtime.state.resolveStateDir()）。
+ * 读盘加载到内存；失败降级为纯内存模式，绝不抛。
+ * 进程级共享：整个进程只从磁盘加载一次，避免插件重载后新模块实例重新 init 覆盖共享内存态。
+ */
+export declare function initSessionEnvPersistence(stateDir: string): void;
+/** 立即落盘（测试 / 进程退出钩子使用）。 */
+export declare function flushSessionEnvPersistence(): void;
+/** 合并写入某个会话的 env（覆盖同 key；空/非法值会被过滤）。 */
+export declare function setSessionEnv(sessionKey: string, env: Record<string, string>): void;
+/** 设置/删除某个会话的单个 env 键；value 为 undefined 时删除。 */
+export declare function setSessionEnvEntry(sessionKey: string, key: string, value: string | undefined): void;
+/** 读取某个会话的 env 快照（浅拷贝）。 */
+export declare function getSessionEnv(sessionKey: string): Record<string, string> | undefined;
+/** 清空某个会话的 env 与父子关联。 */
+export declare function clearSessionEnv(sessionKey: string): void;
+/** 删除某个会话的单个 env 键。 */
+export declare function removeSessionEnvKey(sessionKey: string, key: string): void;
+/** 登记 subagent 子会话到父会话的关联，供 exec env 父子链反查。 */
+export declare function linkChildSession(childSessionKey: string, parentSessionKey: string): void;
+/** 读取运行时登记的 child -> parent 关系；仅作为宿主父链不可用时的兼容回退。 */
+export declare function getLinkedParentSessionKey(sessionKey: string | undefined): string | undefined;
+/** Record the last IM sender for optional Cron binding audit metadata. */
+export declare function setSessionUserContext(sessionKey: string, userId?: string, userName?: string): void;
+export declare function getSessionUserContext(sessionKey: string | undefined): {
+    userId?: string;
+    userName?: string;
+} | undefined;
+/**
+ * 解析某个会话应注入 exec 的 env：先查本会话；查不到则沿 subagent 父子链
+ * 反查父会话（限深，防环）。subagent 内 exec 触发 hook 时 sessionKey 是子会话 key。
+ */
+export declare function resolveEnvForSession(sessionKey: string | undefined): Record<string, string>;
+export declare function __resetSessionEnvStoreForTests(): void;
+/**
+ * 插件真卸载/网关停止时：先把待写数据落盘，再清空共享内存与定时器并复位持久化机器
+ * （下次进程/重载可重新从磁盘加载）。注意：热重载接管场景不应调用本函数（见 plugin-dispose）。
+ */
+export declare function disposeSessionEnvStore(): void;
+//# sourceMappingURL=session-env-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-env-store.d.ts","sourceRoot":"","sources":["../../../src/session/session-env-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAsDvD,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQtF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AA+GD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQhE;AAED,2BAA2B;AAC3B,wBAAgB,0BAA0B,IAAI,IAAI,CASjD;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CASnF;AAED,gDAAgD;AAChD,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAqBN;AAED,2BAA2B;AAC3B,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAMpF;AAED,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAOxD;AAED,uBAAuB;AACvB,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAEzE;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAIxF;AAED,oDAAoD;AACpD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAGlG;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAExH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAc3F;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAkB7C"}

package/dist/src/session/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 "../plugin/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/session-env-store.js.map

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

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

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

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

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

package/dist/src/session/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