@xgjktech/xg_cwork_im 1.19.26 → 1.19.27

package/dist/src/plugin-dispose.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 插件卸载/重载时的统一拆解入口。
+ *
+ * 语义（跨模块共享改造后）：
+ * - 真卸载 / gateway_stop：`disposePluginModule()`（skipConnections=false）——连同进程级共享的
+ *   account-reconciler 一起 stopAll，并清空全部共享内存态（连接/流客户端/会话上下文/轮次/去重/env/
+ *   subagent 监控）。由 index.ts 的 gateway_stop 钩子触发，且用 once 闸门保证只执行一次。
+ * - 插件热重载 / registry 代际交替：cleanup 以 `disposePluginModule({ skipConnections: true,
+ *   skipPlanResources: true })` 调用——只收尾可安全代际清理的句柄，保留动作读库与 plan-ws 路由，
+ *   **绝不 stopAll、绝不清理共享连接/内存态**。连接只在 AccountReconciler（配置 diff，账号级）
+ *   与 gateway_stop（进程停机）处拆解，避免 OpenClaw runtime 代际交替误拆全部 WebSocket。
+ */
+export interface DisposePluginModuleOptions {
+    /** 注册表代际交替（热重载）场景：只收尾独占句柄，跳过共享连接与共享内存态。 */
+    skipConnections?: boolean;
+    /** 注册表代际交替时保留计划读库、动作读库句柄与计划 WS 路由——这些资源仍被代际交替后
+     *  可能继续调用的旧中间件读取路径使用，清空会令反查在打开数据库前即失败；gateway_stop 使用默认 false 完整清理。 */
+    skipPlanResources?: boolean;
+}
+/** skipConnections=false（gateway_stop）时停连接+清共享态；true（cleanup）只收尾独占句柄。 */
+export declare function disposePluginModule(options?: DisposePluginModuleOptions): Promise<void>;
+//# sourceMappingURL=plugin-dispose.d.ts.map

package/dist/src/plugin-dispose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-dispose.d.ts","sourceRoot":"","sources":["../../src/plugin-dispose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqBH,MAAM,WAAW,0BAA0B;IACvC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;2EACuE;IACvE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,yEAAyE;AACzE,wBAAsB,mBAAmB,CACrC,OAAO,GAAE,0BAA+B,GACzC,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/src/plugin-dispose.js

@@ -0,0 +1,66 @@
+/**
+ * 插件卸载/重载时的统一拆解入口。
+ *
+ * 语义（跨模块共享改造后）：
+ * - 真卸载 / gateway_stop：`disposePluginModule()`（skipConnections=false）——连同进程级共享的
+ *   account-reconciler 一起 stopAll，并清空全部共享内存态（连接/流客户端/会话上下文/轮次/去重/env/
+ *   subagent 监控）。由 index.ts 的 gateway_stop 钩子触发，且用 once 闸门保证只执行一次。
+ * - 插件热重载 / registry 代际交替：cleanup 以 `disposePluginModule({ skipConnections: true,
+ *   skipPlanResources: true })` 调用——只收尾可安全代际清理的句柄，保留动作读库与 plan-ws 路由，
+ *   **绝不 stopAll、绝不清理共享连接/内存态**。连接只在 AccountReconciler（配置 diff，账号级）
+ *   与 gateway_stop（进程停机）处拆解，避免 OpenClaw runtime 代际交替误拆全部 WebSocket。
+ */
+import { accountReconciler } from "./account-reconciler.js";
+import { disposeAssistantItemSinks } from "./assistant-item-sink.js";
+import { disposeActiveCronContextStore } from "./active-cron-context-store.js";
+import { clearStreamClients } from "./agent-stream-client-registry.js";
+import { disposeActiveRoundRegistry } from "./active-round-registry.js";
+import { disposeActionStore } from "./action-store-access.js";
+import { clearAllTokenCache } from "./auth.js";
+import { disposeCronAppKeyBindingStore } from "./cron-appkey-binding-store.js";
+import { disposeGlobalTerminalSent } from "./inbound-terminal-state.js";
+import { clearSessionNasVolumeStates } from "./nas-volumes.js";
+import { clearAllPendingPerMessageModel } from "./per-message-model-pending.js";
+import { disposeSessionEnvStore } from "./session-env-store.js";
+import { disposePlanWsRegistry } from "./plan-ws-registry.js";
+import { disposeSessionImContext } from "./session-im-context.js";
+import { clearAllSessionGroupPrompts } from "./session-group-prompt.js";
+import { disposeSubagentMonitor } from "./subagent-monitor.js";
+import { disposeTurnAgentEvents } from "./turn-agent-event-subscription.js";
+import { disposeTurnEndController } from "./turn-end-controller.js";
+/** skipConnections=false（gateway_stop）时停连接+清共享态；true（cleanup）只收尾独占句柄。 */
+export async function disposePluginModule(options = {}) {
+    const { skipConnections = false } = options;
+    const { skipPlanResources = false } = options;
+    if (skipConnections) {
+        console.log(`[xg_cwork_im] [reload] disposePluginModule skipConnections=true ` +
+            `skipPlanResources=${skipPlanResources} (registry cycle)`);
+    }
+    else {
+        // gateway_stop：停共享连接 + 清空共享热路径内存态（含 subagent 监控 maps/ticker）。
+        await accountReconciler.stopAll("gateway-stop");
+        disposeSubagentMonitor();
+        disposeTurnAgentEvents();
+        disposeAssistantItemSinks();
+        disposeTurnEndController();
+        clearStreamClients();
+        disposeSessionImContext();
+        clearAllSessionGroupPrompts();
+        disposeActiveRoundRegistry();
+        disposeGlobalTerminalSent();
+        clearAllPendingPerMessageModel();
+        clearSessionNasVolumeStates();
+        disposeSessionEnvStore();
+        disposeActiveCronContextStore();
+        disposeCronAppKeyBindingStore();
+    }
+    // 动作读库与 plan-ws 路由可能被代际交替后仍在调用的旧中间件/旧发送路径继续使用：旧 cleanup 绝不能清空
+    // 它们的配置/句柄——action 若被清空，getActionById 会在打开数据库之前就因 stateDir 缺失而失败，
+    // 表现为「反查不到 action，跳过 ACTION_DISPATCH 发送」；gateway_stop（skipPlanResources=false）仍完整释放。
+    if (!skipPlanResources) {
+        disposeActionStore();
+        disposePlanWsRegistry();
+    }
+    clearAllTokenCache();
+}
+//# sourceMappingURL=plugin-dispose.js.map

package/dist/src/plugin-dispose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-dispose.js","sourceRoot":"","sources":["../../src/plugin-dispose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAUpE,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,UAAsC,EAAE;IAExC,MAAM,EAAE,eAAe,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC5C,MAAM,EAAE,iBAAiB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC9C,IAAI,eAAe,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CACP,kEAAkE;YAC9D,qBAAqB,iBAAiB,mBAAmB,CAChE,CAAC;IACN,CAAC;SAAM,CAAC;QACJ,8DAA8D;QAC9D,MAAM,iBAAiB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAChD,sBAAsB,EAAE,CAAC;QACzB,sBAAsB,EAAE,CAAC;QACzB,yBAAyB,EAAE,CAAC;QAC5B,wBAAwB,EAAE,CAAC;QAC3B,kBAAkB,EAAE,CAAC;QACrB,uBAAuB,EAAE,CAAC;QAC1B,2BAA2B,EAAE,CAAC;QAC9B,0BAA0B,EAAE,CAAC;QAC7B,yBAAyB,EAAE,CAAC;QAC5B,8BAA8B,EAAE,CAAC;QACjC,2BAA2B,EAAE,CAAC;QAC9B,sBAAsB,EAAE,CAAC;QACzB,6BAA6B,EAAE,CAAC;QAChC,6BAA6B,EAAE,CAAC;IACpC,CAAC;IACD,8DAA8D;IAC9D,kEAAkE;IAClE,qFAAqF;IACrF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACrB,kBAAkB,EAAE,CAAC;QACrB,qBAAqB,EAAE,CAAC;IAC5B,CAAC;IACD,kBAAkB,EAAE,CAAC;AACzB,CAAC"}

package/dist/src/process-shared-store.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 进程级共享存储（跨插件模块重载实例存活）。
+ *
+ * OpenClaw 热重载插件时会重新 import 插件模块 → 新模块作用域里的「模块级单例」与旧实例不互通，
+ * 旧模块由 registerRuntimeLifecycle cleanup 拆解。为了做到「WebSocket 连接与 runtime 不随模块
+ * 重建」，把必须在重载后仍存活的状态放到 globalThis（Symbol key），任何一代模块实例读写同一份。
+ *
+ * 用途：
+ * - 模块代际（epoch）：模块每次（重）import 时取号，register() 后 cleanup 据此判断「是否已有更新的
+ *   模块实例接管」，接管时不再拆连接。
+ * - runtime 持有：每次 register() 把最新 PluginRuntime 写入，连接派发时按需现取，避免绑定旧代际。
+ * - 通用 namespace：后续状态迁移（reconciler 等）统一放这里。
+ */
+export interface ProcessSharedStore {
+    /** 模块代际计数：每个模块实例在顶层（重）import 时递增取号（仅用于观测重载）。 */
+    moduleEpoch: number;
+    /** register() 序列：每次 register() 自增（仅观测用，不再作为 teardown 判定依据）。 */
+    registerSeq: number;
+    /** 当前生效的插件 runtime（每次 register() 覆盖）。 */
+    runtime: unknown;
+    /** 进程级共享命名空间（连接/reconciler 等状态）。 */
+    namespace: Record<string, unknown>;
+    /** gateway_stop 全量 teardown 只执行一次的闸门。 */
+    fullTeardownDone: boolean;
+}
+/** 模块实例顶层调用一次：领取一个全局单调递增的代际号（仅观测用）。 */
+export declare function nextModuleEpoch(): number;
+/** 读取当前最大的模块代际号。 */
+export declare function currentModuleEpoch(): number;
+/** register() 时调用：领取本次 register 的全局序列号。 */
+export declare function nextRegisterSeq(): number;
+/** 读取当前最大的 register 序列号。 */
+export declare function currentRegisterSeq(): number;
+/** 全量 teardown（gateway_stop）幂等闸门：首次调用返回 true，其后返回 false。 */
+export declare function requestFullTeardownOnce(): boolean;
+/** 出现新的 register() 时复位 teardown 闸门（允许下次停机再次 teardown）。 */
+export declare function resetFullTeardownGate(): void;
+/** register() 时写入最新 runtime（连接派发按需现取）。 */
+export declare function setSharedRuntime(rt: unknown): void;
+/** 读取当前最新 runtime。 */
+export declare function getSharedRuntime<T = unknown>(): T | undefined;
+/** 进程级 getOrCreate：跨模块重载共享单例（如 account-reconciler）。 */
+export declare function getOrCreateShared<T>(key: string, factory: () => T): T;
+/** 进程级共享 Map：跨模块重载共享状态（旧连接派发写入 / 新模块 hooks 读取同一份）。 */
+export declare function getSharedMap<K, V>(key: string): Map<K, V>;
+/** 仅供测试：整表重置（避免测试文件间串状态）。 */
+export declare function __resetProcessSharedStoreForTests(): void;
+//# sourceMappingURL=process-shared-store.d.ts.map

package/dist/src/process-shared-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-shared-store.d.ts","sourceRoot":"","sources":["../../src/process-shared-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,kBAAkB;IAC/B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,yCAAyC;IACzC,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAkBD,uCAAuC;AACvC,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED,oBAAoB;AACpB,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED,4BAA4B;AAC5B,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,4DAA4D;AAC5D,wBAAgB,uBAAuB,IAAI,OAAO,CAKjD;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,sBAAsB;AACtB,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,SAAS,CAE7D;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAMrE;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAEzD;AAED,6BAA6B;AAC7B,wBAAgB,iCAAiC,IAAI,IAAI,CAKxD"}

package/dist/src/process-shared-store.js

@@ -0,0 +1,89 @@
+/**
+ * 进程级共享存储（跨插件模块重载实例存活）。
+ *
+ * OpenClaw 热重载插件时会重新 import 插件模块 → 新模块作用域里的「模块级单例」与旧实例不互通，
+ * 旧模块由 registerRuntimeLifecycle cleanup 拆解。为了做到「WebSocket 连接与 runtime 不随模块
+ * 重建」，把必须在重载后仍存活的状态放到 globalThis（Symbol key），任何一代模块实例读写同一份。
+ *
+ * 用途：
+ * - 模块代际（epoch）：模块每次（重）import 时取号，register() 后 cleanup 据此判断「是否已有更新的
+ *   模块实例接管」，接管时不再拆连接。
+ * - runtime 持有：每次 register() 把最新 PluginRuntime 写入，连接派发时按需现取，避免绑定旧代际。
+ * - 通用 namespace：后续状态迁移（reconciler 等）统一放这里。
+ */
+const STORE_KEY = Symbol.for("xg.im.processSharedStore");
+function ensureStore() {
+    const g = globalThis;
+    if (Object.hasOwn(g, STORE_KEY)) {
+        return g[STORE_KEY];
+    }
+    const created = {
+        moduleEpoch: 0,
+        registerSeq: 0,
+        runtime: undefined,
+        namespace: {},
+        fullTeardownDone: false,
+    };
+    g[STORE_KEY] = created;
+    return created;
+}
+/** 模块实例顶层调用一次：领取一个全局单调递增的代际号（仅观测用）。 */
+export function nextModuleEpoch() {
+    const store = ensureStore();
+    store.moduleEpoch += 1;
+    return store.moduleEpoch;
+}
+/** 读取当前最大的模块代际号。 */
+export function currentModuleEpoch() {
+    return ensureStore().moduleEpoch;
+}
+/** register() 时调用：领取本次 register 的全局序列号。 */
+export function nextRegisterSeq() {
+    const store = ensureStore();
+    store.registerSeq += 1;
+    return store.registerSeq;
+}
+/** 读取当前最大的 register 序列号。 */
+export function currentRegisterSeq() {
+    return ensureStore().registerSeq;
+}
+/** 全量 teardown（gateway_stop）幂等闸门：首次调用返回 true，其后返回 false。 */
+export function requestFullTeardownOnce() {
+    const store = ensureStore();
+    if (store.fullTeardownDone)
+        return false;
+    store.fullTeardownDone = true;
+    return true;
+}
+/** 出现新的 register() 时复位 teardown 闸门（允许下次停机再次 teardown）。 */
+export function resetFullTeardownGate() {
+    ensureStore().fullTeardownDone = false;
+}
+/** register() 时写入最新 runtime（连接派发按需现取）。 */
+export function setSharedRuntime(rt) {
+    ensureStore().runtime = rt;
+}
+/** 读取当前最新 runtime。 */
+export function getSharedRuntime() {
+    return ensureStore().runtime;
+}
+/** 进程级 getOrCreate：跨模块重载共享单例（如 account-reconciler）。 */
+export function getOrCreateShared(key, factory) {
+    const ns = ensureStore().namespace;
+    if (!Object.hasOwn(ns, key)) {
+        ns[key] = factory();
+    }
+    return ns[key];
+}
+/** 进程级共享 Map：跨模块重载共享状态（旧连接派发写入 / 新模块 hooks 读取同一份）。 */
+export function getSharedMap(key) {
+    return getOrCreateShared(`map:${key}`, () => new Map());
+}
+/** 仅供测试：整表重置（避免测试文件间串状态）。 */
+export function __resetProcessSharedStoreForTests() {
+    const g = globalThis;
+    if (Object.hasOwn(g, STORE_KEY)) {
+        delete g[STORE_KEY];
+    }
+}
+//# sourceMappingURL=process-shared-store.js.map

package/dist/src/process-shared-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-shared-store.js","sourceRoot":"","sources":["../../src/process-shared-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAezD,SAAS,WAAW;IAChB,MAAM,CAAC,GAAG,UAA0C,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC,SAAS,CAAuB,CAAC;IAC9C,CAAC;IACD,MAAM,OAAO,GAAuB;QAChC,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;QACd,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE,KAAK;KAC1B,CAAC;IACF,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IACvB,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,eAAe;IAC3B,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,WAAW,CAAC;AAC7B,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,kBAAkB;IAC9B,OAAO,WAAW,EAAE,CAAC,WAAW,CAAC;AACrC,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,eAAe;IAC3B,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,WAAW,CAAC;AAC7B,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,kBAAkB;IAC9B,OAAO,WAAW,EAAE,CAAC,WAAW,CAAC;AACrC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,uBAAuB;IACnC,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACzC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC9B,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,qBAAqB;IACjC,WAAW,EAAE,CAAC,gBAAgB,GAAG,KAAK,CAAC;AAC3C,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAAC,EAAW;IACxC,WAAW,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC;AAC/B,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,gBAAgB;IAC5B,OAAO,WAAW,EAAE,CAAC,OAAwB,CAAC;AAClD,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,iBAAiB,CAAI,GAAW,EAAE,OAAgB;IAC9D,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC,SAAS,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1B,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,CAAM,CAAC;AACxB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAO,GAAW;IAC1C,OAAO,iBAAiB,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAQ,CAAC,CAAC;AAClE,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,iCAAiC;IAC7C,MAAM,CAAC,GAAG,UAA0C,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;AACL,CAAC"}

package/dist/src/process-shared-store.test.d.ts

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

package/dist/src/process-shared-store.test.d.ts.map

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

package/dist/src/process-shared-store.test.js

@@ -0,0 +1,60 @@
+import assert from "node:assert/strict";
+import { beforeEach, describe, it } from "node:test";
+import { __resetProcessSharedStoreForTests, currentModuleEpoch, currentRegisterSeq, getOrCreateShared, getSharedMap, nextModuleEpoch, nextRegisterSeq, requestFullTeardownOnce, resetFullTeardownGate, } from "./process-shared-store.js";
+beforeEach(() => {
+    __resetProcessSharedStoreForTests();
+});
+describe("process-shared-store: module epoch / register seq", () => {
+    it("moduleEpoch and registerSeq are monotonic per claim (observability only)", () => {
+        assert.equal(nextModuleEpoch(), 1);
+        assert.equal(nextModuleEpoch(), 2);
+        assert.equal(currentModuleEpoch(), 2);
+        assert.equal(nextRegisterSeq(), 1);
+        assert.equal(nextRegisterSeq(), 2);
+        assert.equal(currentRegisterSeq(), 2);
+    });
+    it("registerSeq is NOT used to decide teardown (must never gate stopAll on 'no later register')", () => {
+        // Registry 代际交替可能在批量 register 的尾端触发 cleanup，而无更晚 register；
+        // 该情形绝不能导出「全量 teardown」结论。这里验证 registerSeq 仅单调计数。
+        const last = nextRegisterSeq();
+        nextRegisterSeq();
+        assert.ok(currentRegisterSeq() > last);
+    });
+});
+describe("process-shared-store: cross-module singleton via getOrCreateShared", () => {
+    it("getOrCreateShared returns the same instance for the same key", () => {
+        const a = getOrCreateShared("x", () => new Map());
+        const b = getOrCreateShared("x", () => new Map());
+        assert.equal(a, b);
+    });
+    it("getSharedMap returns the same map for the same key (old/new module read/write one copy)", () => {
+        const a = getSharedMap("shared-map");
+        const b = getSharedMap("shared-map");
+        assert.equal(a, b);
+        a.set("k", 1);
+        assert.equal(b.get("k"), 1);
+    });
+    it("distinct keys produce distinct instances", () => {
+        const a = getOrCreateShared("k1", () => new Map());
+        const b = getOrCreateShared("k2", () => new Map());
+        assert.notEqual(a, b);
+    });
+});
+describe("process-shared-store: full teardown once-gate (gateway_stop)", () => {
+    it("requestFullTeardownOnce returns true only once until reset", () => {
+        assert.equal(requestFullTeardownOnce(), true);
+        assert.equal(requestFullTeardownOnce(), false);
+        assert.equal(requestFullTeardownOnce(), false);
+    });
+    it("a new register resets the gate so a later stop can teardown again", () => {
+        assert.equal(requestFullTeardownOnce(), true);
+        resetFullTeardownGate();
+        assert.equal(requestFullTeardownOnce(), true);
+    });
+    it("repeated gateway_stop handlers (one per register) collapse to a single teardown", () => {
+        const handlers = [requestFullTeardownOnce, requestFullTeardownOnce, requestFullTeardownOnce];
+        const results = handlers.map((h) => h());
+        assert.deepEqual(results, [true, false, false]);
+    });
+});
+//# sourceMappingURL=process-shared-store.test.js.map

package/dist/src/process-shared-store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-shared-store.test.js","sourceRoot":"","sources":["../../src/process-shared-store.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EACH,iCAAiC,EACjC,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,qBAAqB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,UAAU,CAAC,GAAG,EAAE;IACZ,iCAAiC,EAAE,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC/D,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAChF,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6FAA6F,EAAE,GAAG,EAAE;QACnG,2DAA2D;QAC3D,kDAAkD;QAClD,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;QAC/B,eAAe,EAAE,CAAC;QAClB,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oEAAoE,EAAE,GAAG,EAAE;IAChF,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACpE,MAAM,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,GAAG,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yFAAyF,EAAE,GAAG,EAAE;QAC/F,MAAM,CAAC,GAAG,YAAY,CAAiB,YAAY,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,YAAY,CAAiB,YAAY,CAAC,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACd,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8DAA8D,EAAE,GAAG,EAAE;IAC1E,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,KAAK,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9C,qBAAqB,EAAE,CAAC;QACxB,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACvF,MAAM,QAAQ,GAAG,CAAC,uBAAuB,EAAE,uBAAuB,EAAE,uBAAuB,CAAC,CAAC;QAC7F,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * 项目目录映射：路径规范化与宿主绝对路径求解。
+ */
+/** IM 信令 / 项目配置中 localRoot.kind 的合法取值（仅此两种） */
+export declare const LOCAL_ROOT_KINDS: readonly ["workspace_relative", "host_absolute"];
+export type LocalRootKind = (typeof LOCAL_ROOT_KINDS)[number];
+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;
+//# sourceMappingURL=project-path-normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-path-normalize.d.ts","sourceRoot":"","sources":["../../src/project-path-normalize.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,kDAAmD,CAAC;AACjF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CAChB;AAUD,qEAAqE;AACrE,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,gCAAgC;AAChC,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED,MAAM,WAAW,kBAAkB;IAC/B,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC,GAAG,kBAAkB,CAerB;AAED,8CAA8C;AAC9C,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkB1E;AAED,wBAAgB,wBAAwB,CACpC,SAAS,EAAE,aAAa,EACxB,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACtC,MAAM,CAuBR"}

package/dist/src/project-path-normalize.js

@@ -0,0 +1,101 @@
+/**
+ * 项目目录映射：路径规范化与宿主绝对路径求解。
+ */
+import path from "node:path";
+/** workspace_relative 每段：ASCII 安全名，或含 Unicode 字母/数字的目录名（如中文路径） */
+const ASCII_SEGMENT = /^[a-zA-Z0-9_\-][a-zA-Z0-9_\-/.]*$/;
+/** 禁止出现在路径段内的字符（路径穿越、Windows 非法字符等） */
+const UNSAFE_SEGMENT_CHAR = /[\0-\x1f\\:*?"<>|]/;
+/** IM 信令 / 项目配置中 localRoot.kind 的合法取值（仅此两种） */
+export const LOCAL_ROOT_KINDS = ["workspace_relative", "host_absolute"];
+function isValidWorkspaceSegment(seg) {
+    if (!seg || seg === "." || seg === "..")
+        return false;
+    if (UNSAFE_SEGMENT_CHAR.test(seg))
+        return false;
+    if (ASCII_SEGMENT.test(seg))
+        return true;
+    // 中文等 Unicode 目录名：至少含一个字母或数字
+    return /[\p{L}\p{N}]/u.test(seg);
+}
+/** 知识库目录 fileId（IM 信令 remoteRootFolderId → 同步服务 remoteRootFileId） */
+export function normalizeRemoteRootFolderId(raw) {
+    const id = raw.trim();
+    if (!id)
+        throw new Error("remoteRootFolderId 不能为空");
+    return id;
+}
+/** 知识库逻辑路径：去掉首部 `/`，统一为正斜杠分段 */
+export function normalizeRemoteRootFolderPath(raw) {
+    let p = raw.trim().replace(/\\/g, "/");
+    while (p.startsWith("/"))
+        p = p.slice(1);
+    p = p.replace(/\/+$/, "");
+    if (!p)
+        throw new Error("remoteRootFolderPath 不能为空");
+    return p;
+}
+/**
+ * 解析 upsert 远端根：remoteRootFolderId 优先；两者都填时 id 决定同步根，path 仍透传供 upload 前缀。
+ */
+export function resolveRemoteRootForSync(params) {
+    const idRaw = params.remoteRootFolderId?.trim();
+    if (idRaw) {
+        const remoteRootFileId = normalizeRemoteRootFolderId(idRaw);
+        const pathRaw = params.remoteRootFolderPath?.trim();
+        return {
+            remoteRootFileId,
+            ...(pathRaw ? { remoteRootFolderPath: normalizeRemoteRootFolderPath(pathRaw) } : {}),
+        };
+    }
+    const pathRaw = params.remoteRootFolderPath?.trim();
+    if (!pathRaw) {
+        throw new Error("remoteRootFolderId 与 remoteRootFolderPath 至少填一个");
+    }
+    return { remoteRootFolderPath: normalizeRemoteRootFolderPath(pathRaw) };
+}
+/** 规范化 workspace 相对段（去 ./、前导 /、尾部 /，禁止 ..） */
+export function normalizeWorkspaceRelativeSegment(userPath) {
+    let p = userPath.trim().replace(/\\/g, "/");
+    while (p.startsWith("./"))
+        p = p.slice(2);
+    while (p.startsWith("/"))
+        p = p.slice(1);
+    p = p.replace(/\/+$/, "");
+    if (!p)
+        throw new Error("localRoot.path 不能为空");
+    const parts = p.split("/").filter(Boolean);
+    for (const seg of parts) {
+        if (seg === "..")
+            throw new Error("路径不能包含 ..");
+    }
+    const invalidSeg = parts.find((seg) => !isValidWorkspaceSegment(seg));
+    if (invalidSeg) {
+        throw new Error(`路径含有非法字符: ${userPath}`);
+    }
+    return parts.join("/");
+}
+export function resolveLocalAbsolutePath(localRoot, workspaceHostRoot) {
+    const p = localRoot.path.trim();
+    if (!p)
+        throw new Error("localRoot.path 不能为空");
+    if (localRoot.kind === "host_absolute") {
+        const abs = path.resolve(p);
+        if (!path.isAbsolute(abs)) {
+            throw new Error("host_absolute 时 localRoot.path 必须是绝对路径");
+        }
+        return abs;
+    }
+    if (!workspaceHostRoot?.trim()) {
+        throw new Error("workspace_relative 需要可用的 Agent workspace 宿主根目录");
+    }
+    const rel = normalizeWorkspaceRelativeSegment(p);
+    const root = path.resolve(workspaceHostRoot.trim());
+    const joined = path.resolve(root, rel);
+    const relCheck = path.relative(root, joined);
+    if (relCheck.startsWith("..") || path.isAbsolute(relCheck)) {
+        throw new Error("localRoot.path 逃出 workspace 根目录");
+    }
+    return joined;
+}
+//# sourceMappingURL=project-path-normalize.js.map

package/dist/src/project-path-normalize.js.map

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

package/dist/src/recommended-system-prompt.d.ts

@@ -0,0 +1,3 @@
+/** 建议复制到 `channels.xg_cwork_im.systemPrompt`。 */
+export declare const XG_IM_RECOMMENDED_CHANNEL_SYSTEM_PROMPT: string;
+//# sourceMappingURL=recommended-system-prompt.d.ts.map

package/dist/src/recommended-system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommended-system-prompt.d.ts","sourceRoot":"","sources":["../../src/recommended-system-prompt.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,eAAO,MAAM,uCAAuC,QAMa,CAAC"}

package/dist/src/recommended-system-prompt.js

@@ -0,0 +1,8 @@
+/** 建议复制到 `channels.xg_cwork_im.systemPrompt`。 */
+export const XG_IM_RECOMMENDED_CHANNEL_SYSTEM_PROMPT = "当用户要求生成、返回或发送文件（报告、HTML、PDF、图片等）时，必须使用 `xg_cwork_im_send_file` 工具发送，不要用 `MEDIA:<路径>`。" +
+    "步骤：1) 先在当前 Agent workspace 内创建具体文件；2) 确认路径存在且是普通文件而非目录；" +
+    "3) 调用 `xg_cwork_im_send_file`，`path` 传 workspace 相对路径（可带 ./ 或 /workspace/ 前缀），可用 `caption` 附说明、`fileName` 指定展示名。" +
+    "不要传 groupId 或账户（由会话上下文自动决定），不要传 URL、宿主机绝对路径、workspace 外或 .. 路径，也不要复制到 /tmp/openclaw。" +
+    "只有工具返回 `ok:true` 后才能告诉用户文件已发送；返回 `ok:false` 时按 `code` 修正文件或路径后重试，不得谎称已发送。" +
+    "纯文本回复照常直接回复即可；`xg_cwork_im_send_group_message` 只发纯文本、不能发附件。";
+//# sourceMappingURL=recommended-system-prompt.js.map

package/dist/src/recommended-system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommended-system-prompt.js","sourceRoot":"","sources":["../../src/recommended-system-prompt.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,CAAC,MAAM,uCAAuC,GAChD,uFAAuF;IACvF,yDAAyD;IACzD,kHAAkH;IAClH,sFAAsF;IACtF,2EAA2E;IAC3E,6DAA6D,CAAC"}

package/dist/src/register-exec-env-hook.d.ts

@@ -0,0 +1,44 @@
+/**
+ * before_tool_call：把当前会话的 per-user 环境变量注入 exec 子进程。
+ *
+ * - XG_OPENAPI_APP_KEY   ← session-env-store（最后触发者，已持久化）
+ * - XG_OPENAPI_BASE_URL  ← 插件配置 baseUrl（每次 exec 直读，重启/配置变更即生效，不持久化）
+ *
+ * 只在 exec 工具调用时生效（toolName 恒为 "exec"），注入方式为改写
+ * event.params.env（优先级低于 resolve_exec_env 的 pluginEnv，但本插件
+ * 不注册 resolve_exec_env，因此 params.env 即最终生效值）。不碰 process.env。
+ *
+ * 当本次会注入 XG_OPENAPI_APP_KEY 时，额外剥掉 params.command 行首对该变量的
+ * Shell 赋值 / `env` 前缀，避免 shell -c 在启动时覆盖已注入的值。
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-plugin-common";
+export declare const XG_OPENAPI_BASE_URL = "XG_OPENAPI_BASE_URL";
+export type CronSessionRef = {
+    agentId: string;
+    jobId: string;
+    runId: string;
+};
+/**
+ * Strip leading shell / `env` assignments of XG_OPENAPI_APP_KEY from an exec command.
+ * Only touches the command prefix; does not search the rest of the string.
+ */
+export declare function stripLeadingXgOpenApiAppKeyAssignments(command: string): {
+    command: string;
+    stripped: boolean;
+};
+type SessionTargetRef = {
+    agentId: string;
+    sessionKey: string;
+};
+export declare function parseCronSessionTarget(sessionTarget: string | undefined): SessionTargetRef | undefined;
+/** Return true only for the supported CLI/API forms that create a Cron job. */
+export declare function isCronCreateCommand(command: string | undefined): boolean;
+/** Extract the authoritative job id from native Cron or CLI results. */
+export declare function extractCronJobIdFromResult(result: unknown): string | undefined;
+/** Parse the stable portion of an OpenClaw Cron run session key. */
+export declare function parseCronSessionKey(sessionKey: string | undefined): CronSessionRef | undefined;
+export declare function registerExecEnvHook(api: OpenClawPluginApi): void;
+/** Register automatic binding when a Cron job is created from an IM session. */
+export declare function registerCronAppKeyBindingHook(api: OpenClawPluginApi): void;
+export {};
+//# sourceMappingURL=register-exec-env-hook.d.ts.map

package/dist/src/register-exec-env-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-exec-env-hook.d.ts","sourceRoot":"","sources":["../../src/register-exec-env-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAqBnF,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAe/E;;;GAGG;AACH,wBAAgB,sCAAsC,CAAC,OAAO,EAAE,MAAM,GAAG;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACrB,CAeA;AAsBD,KAAK,gBAAgB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AA0BhE,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAMtG;AAgJD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKxE;AA0CD,wEAAwE;AACxE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAkB9E;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAkB9F;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CA2DhE;AAED,gFAAgF;AAChF,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CA4G1E"}