@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/workspace/workspace-event-scheduler.js

@@ -0,0 +1,131 @@
+/** 一台 OpenClaw 进程内共享的工作区并发默认值。 */
+export const DEFAULT_WORKSPACE_EVENT_MAX_CONCURRENCY = 32;
+export const DEFAULT_WORKSPACE_EVENT_MAX_FILE_CONCURRENCY = 8;
+export const DEFAULT_WORKSPACE_EVENT_PER_AGENT_CONCURRENCY = 2;
+export const DEFAULT_WORKSPACE_EVENT_QUEUE_LIMIT = 64;
+/**
+ * ws-notify 的回程路由默认 60 秒失效。排队超过 45 秒就返回 BUSY，给回包发送和
+ * 网络转发留出余量，避免插件完成了工作但客户端因 relay 已过期而收不到结果。
+ */
+export const WORKSPACE_EVENT_QUEUE_WAIT_MS = 45_000;
+function positiveInteger(value, fallback) {
+    return Number.isInteger(value) && (value ?? 0) > 0 ? value : fallback;
+}
+function nonNegativeInteger(value, fallback) {
+    return Number.isInteger(value) && (value ?? -1) >= 0 ? value : fallback;
+}
+/**
+ * 并发参数是机器级配置。即使某个旧配置绕过 schema，也在这里补默认值并保证
+ * 文件/单 Agent 上限不会大于全局上限。
+ */
+export function resolveWorkspaceEventConcurrencyLimits(config) {
+    const maxConcurrency = positiveInteger(config.workspaceEventMaxConcurrency, DEFAULT_WORKSPACE_EVENT_MAX_CONCURRENCY);
+    return {
+        maxConcurrency,
+        maxFileConcurrency: Math.min(positiveInteger(config.workspaceEventMaxFileConcurrency, DEFAULT_WORKSPACE_EVENT_MAX_FILE_CONCURRENCY), maxConcurrency),
+        perAgentConcurrency: Math.min(positiveInteger(config.workspaceEventPerAgentConcurrency, DEFAULT_WORKSPACE_EVENT_PER_AGENT_CONCURRENCY), maxConcurrency),
+        queueLimit: nonNegativeInteger(config.workspaceEventQueueLimit, DEFAULT_WORKSPACE_EVENT_QUEUE_LIMIT),
+        queueWaitMs: WORKSPACE_EVENT_QUEUE_WAIT_MS,
+    };
+}
+/**
+ * 进程级工作区调度器。一个插件进程中的所有机器人账户共享同一实例，避免把
+ * “每 Agent 并发”错误地放大为 Agent 数量乘以并发数。
+ */
+export class WorkspaceEventScheduler {
+    activeTotal = 0;
+    activeFiles = 0;
+    activeByAgent = new Map();
+    queue = [];
+    run(args) {
+        const pending = {
+            agentKey: args.agentKey,
+            kind: args.kind,
+            limits: args.limits,
+            task: args.task,
+            onBusy: args.onBusy,
+        };
+        if (this.queue.length === 0 && this.canStart(pending)) {
+            return new Promise((resolve, reject) => {
+                this.start({ ...pending, resolve: resolve, reject });
+            });
+        }
+        if (this.queue.length >= args.limits.queueLimit) {
+            return Promise.resolve(args.onBusy("QUEUE_FULL"));
+        }
+        return new Promise((resolve, reject) => {
+            const queued = {
+                ...pending,
+                resolve: resolve,
+                reject,
+            };
+            queued.timer = setTimeout(() => this.expire(queued), args.limits.queueWaitMs);
+            queued.timer.unref?.();
+            this.queue.push(queued);
+            this.drain();
+        });
+    }
+    /** 只用于测试和运行监控，不暴露队列中的业务参数。 */
+    snapshot() {
+        return {
+            activeTotal: this.activeTotal,
+            activeFiles: this.activeFiles,
+            queued: this.queue.length,
+        };
+    }
+    canStart(task) {
+        if (this.activeTotal >= task.limits.maxConcurrency)
+            return false;
+        if (task.kind === "FILE" && this.activeFiles >= task.limits.maxFileConcurrency)
+            return false;
+        return (this.activeByAgent.get(task.agentKey) ?? 0) < task.limits.perAgentConcurrency;
+    }
+    start(task) {
+        if (task.timer)
+            clearTimeout(task.timer);
+        this.activeTotal += 1;
+        if (task.kind === "FILE")
+            this.activeFiles += 1;
+        this.activeByAgent.set(task.agentKey, (this.activeByAgent.get(task.agentKey) ?? 0) + 1);
+        void Promise.resolve()
+            .then(task.task)
+            .then(task.resolve, task.reject)
+            .finally(() => {
+            this.activeTotal -= 1;
+            if (task.kind === "FILE")
+                this.activeFiles -= 1;
+            const agentActive = (this.activeByAgent.get(task.agentKey) ?? 1) - 1;
+            if (agentActive > 0)
+                this.activeByAgent.set(task.agentKey, agentActive);
+            else
+                this.activeByAgent.delete(task.agentKey);
+            this.drain();
+        });
+    }
+    drain() {
+        let index = 0;
+        while (index < this.queue.length) {
+            const task = this.queue[index];
+            if (!this.canStart(task)) {
+                index += 1;
+                continue;
+            }
+            this.queue.splice(index, 1);
+            this.start(task);
+        }
+    }
+    expire(task) {
+        const index = this.queue.indexOf(task);
+        if (index < 0)
+            return;
+        this.queue.splice(index, 1);
+        try {
+            task.resolve(task.onBusy("QUEUE_TIMEOUT"));
+        }
+        catch (error) {
+            task.reject(error);
+        }
+    }
+}
+export const workspaceEventScheduler = new WorkspaceEventScheduler();
+//# sourceMappingURL=workspace-event-scheduler.js.map

package/dist/src/workspace/workspace-event-scheduler.js.map

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

package/dist/src/workspace/workspace-event-scheduler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace-event-scheduler.test.d.ts.map

package/dist/src/workspace/workspace-event-scheduler.test.d.ts.map

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

package/dist/src/workspace/workspace-event-scheduler.test.js

@@ -0,0 +1,157 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { DEFAULT_WORKSPACE_EVENT_MAX_CONCURRENCY, DEFAULT_WORKSPACE_EVENT_MAX_FILE_CONCURRENCY, DEFAULT_WORKSPACE_EVENT_PER_AGENT_CONCURRENCY, DEFAULT_WORKSPACE_EVENT_QUEUE_LIMIT, WorkspaceEventScheduler, resolveWorkspaceEventConcurrencyLimits, } from "./workspace-event-scheduler.js";
+function deferred() {
+    let resolve;
+    const promise = new Promise((done) => {
+        resolve = done;
+    });
+    return { promise, resolve };
+}
+const limits = (overrides = {}) => ({
+    maxConcurrency: 2,
+    maxFileConcurrency: 2,
+    perAgentConcurrency: 2,
+    queueLimit: 2,
+    queueWaitMs: 1_000,
+    ...overrides,
+});
+const busy = (reason) => `BUSY:${reason}`;
+describe("workspace event concurrency config", () => {
+    it("uses machine defaults and keeps sub-limits inside the global limit", () => {
+        assert.deepEqual(resolveWorkspaceEventConcurrencyLimits({}), {
+            maxConcurrency: DEFAULT_WORKSPACE_EVENT_MAX_CONCURRENCY,
+            maxFileConcurrency: DEFAULT_WORKSPACE_EVENT_MAX_FILE_CONCURRENCY,
+            perAgentConcurrency: DEFAULT_WORKSPACE_EVENT_PER_AGENT_CONCURRENCY,
+            queueLimit: DEFAULT_WORKSPACE_EVENT_QUEUE_LIMIT,
+            queueWaitMs: 45_000,
+        });
+        assert.deepEqual(resolveWorkspaceEventConcurrencyLimits({
+            workspaceEventMaxConcurrency: 3,
+            workspaceEventMaxFileConcurrency: 8,
+            workspaceEventPerAgentConcurrency: 5,
+            workspaceEventQueueLimit: 9,
+        }), {
+            maxConcurrency: 3,
+            maxFileConcurrency: 3,
+            perAgentConcurrency: 3,
+            queueLimit: 9,
+            queueWaitMs: 45_000,
+        });
+    });
+});
+describe("workspace event scheduler", () => {
+    it("bounds global activity and returns BUSY when the global queue is full", async () => {
+        const scheduler = new WorkspaceEventScheduler();
+        const first = deferred();
+        const second = deferred();
+        const third = deferred();
+        const fourth = deferred();
+        const started = [];
+        const run = (name, gate) => scheduler.run({
+            agentKey: name,
+            kind: "TREE",
+            limits: limits(),
+            task: async () => {
+                started.push(name);
+                return gate.promise;
+            },
+            onBusy: busy,
+        });
+        const p1 = run("agent-1", first);
+        const p2 = run("agent-2", second);
+        const p3 = run("agent-3", third);
+        const p4 = run("agent-4", fourth);
+        const rejected = await run("agent-5", deferred());
+        assert.equal(rejected, "BUSY:QUEUE_FULL");
+        assert.deepEqual(scheduler.snapshot(), { activeTotal: 2, activeFiles: 0, queued: 2 });
+        await new Promise((resolve) => setImmediate(resolve));
+        assert.deepEqual(started, ["agent-1", "agent-2"]);
+        first.resolve("one");
+        assert.equal(await p1, "one");
+        await new Promise((resolve) => setImmediate(resolve));
+        assert.ok(started.includes("agent-3"));
+        second.resolve("two");
+        third.resolve("three");
+        fourth.resolve("four");
+        assert.deepEqual(await Promise.all([p2, p3, p4]), ["two", "three", "four"]);
+        assert.deepEqual(scheduler.snapshot(), { activeTotal: 0, activeFiles: 0, queued: 0 });
+    });
+    it("enforces file and per-Agent limits without blocking other Agents' tree requests", async () => {
+        const scheduler = new WorkspaceEventScheduler();
+        const fileA = deferred();
+        const fileB = deferred();
+        const treeA = deferred();
+        const treeB = deferred();
+        const started = [];
+        const customLimits = limits({
+            maxConcurrency: 4,
+            maxFileConcurrency: 1,
+            perAgentConcurrency: 1,
+            queueLimit: 8,
+        });
+        const run = (agentKey, kind, name, gate) => scheduler.run({
+            agentKey,
+            kind,
+            limits: customLimits,
+            task: async () => {
+                started.push(name);
+                return gate.promise;
+            },
+            onBusy: busy,
+        });
+        const pFileA = run("agent-a", "FILE", "file-a", fileA);
+        const pFileB = run("agent-b", "FILE", "file-b", fileB);
+        const pTreeA = run("agent-a", "TREE", "tree-a", treeA);
+        const pTreeB = run("agent-b", "TREE", "tree-b", treeB);
+        const treeC = deferred();
+        const pTreeC = run("agent-c", "TREE", "tree-c", treeC);
+        await new Promise((resolve) => setImmediate(resolve));
+        assert.deepEqual(started, ["file-a", "tree-b", "tree-c"]);
+        assert.deepEqual(scheduler.snapshot(), { activeTotal: 3, activeFiles: 1, queued: 2 });
+        fileA.resolve("file-a");
+        assert.equal(await pFileA, "file-a");
+        await new Promise((resolve) => setImmediate(resolve));
+        assert.ok(started.includes("tree-a"));
+        assert.equal(started.includes("file-b"), false);
+        treeB.resolve("tree-b");
+        assert.equal(await pTreeB, "tree-b");
+        await new Promise((resolve) => setImmediate(resolve));
+        assert.ok(started.includes("file-b"));
+        fileB.resolve("file-b");
+        treeA.resolve("tree-a");
+        treeC.resolve("tree-c");
+        await Promise.all([pFileB, pTreeA, pTreeC]);
+        assert.deepEqual(scheduler.snapshot(), { activeTotal: 0, activeFiles: 0, queued: 0 });
+    });
+    it("returns BUSY when a queued request waits past its deadline", async () => {
+        const scheduler = new WorkspaceEventScheduler();
+        const gate = deferred();
+        const shortWait = limits({
+            maxConcurrency: 1,
+            maxFileConcurrency: 1,
+            perAgentConcurrency: 1,
+            queueLimit: 1,
+            queueWaitMs: 20,
+        });
+        const active = scheduler.run({
+            agentKey: "agent-a",
+            kind: "FILE",
+            limits: shortWait,
+            task: () => gate.promise,
+            onBusy: busy,
+        });
+        const queued = scheduler.run({
+            agentKey: "agent-b",
+            kind: "TREE",
+            limits: shortWait,
+            task: async () => "unexpected",
+            onBusy: busy,
+        });
+        assert.equal(await queued, "BUSY:QUEUE_TIMEOUT");
+        assert.deepEqual(scheduler.snapshot(), { activeTotal: 1, activeFiles: 1, queued: 0 });
+        gate.resolve("done");
+        assert.equal(await active, "done");
+    });
+});
+//# sourceMappingURL=workspace-event-scheduler.test.js.map

package/dist/src/workspace/workspace-event-scheduler.test.js.map

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

package/dist/src/workspace/workspace-event.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 会话工作区目录浏览与文本文件读取。
+ *
+ * 该信令与 robotMention/groupMessage 完全分流，不创建 Agent 轮次、不写会话记录。
+ * LOCAL 工作区以 IM 计算的 localRoot 为授权根；NAS 工作区只访问 nasVolumes 明确授权的
+ * dockerDir，并通过当前机器 nasVolumeRootMappings 映射到宿主目录。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { Log } from "../plugin/auth.js";
+import type { XgImConfig } from "../plugin/types.js";
+export { OPENCLAW_WORKSPACE_EVENT_CMD } from "./workspace-event-protocol.js";
+export type WorkspaceRequestEvent = "TREE_REQUEST" | "FILE_REQUEST";
+export type WorkspaceResultEvent = "TREE_RESULT" | "FILE_RESULT";
+export type WorkspaceErrorCode = "INVALID_REQUEST" | "PATH_OUTSIDE_WORKSPACE" | "NOT_FOUND" | "NOT_A_DIRECTORY" | "NOT_A_FILE" | "UNSUPPORTED_FILE_TYPE" | "FILE_TOO_LARGE" | "BUSY" | "READ_FAILED";
+export interface WorkspaceEventContext {
+    config: XgImConfig;
+    cfg: OpenClawConfig;
+    log: Log;
+    logPrefix: string;
+    /** 测试或已知运行环境可直接传入；正常运行时由 OpenClaw SDK 按 agentId 解析。 */
+    workspaceHostRoot?: string;
+}
+export type WorkspaceEventResponse = Record<string, unknown>;
+/**
+ * 处理工作区请求。所有账户共享进程级调度器；无效 event 不进入队列，直接返回协议错误。
+ */
+export declare function handleWorkspaceEvent(ctx: WorkspaceEventContext, rawParams: unknown): Promise<WorkspaceEventResponse>;
+//# sourceMappingURL=workspace-event.d.ts.map

package/dist/src/workspace/workspace-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-event.d.ts","sourceRoot":"","sources":["../../../src/workspace/workspace-event.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAiB7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAU7E,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,cAAc,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,aAAa,CAAC;AACjE,MAAM,MAAM,kBAAkB,GACxB,iBAAiB,GACjB,wBAAwB,GACxB,WAAW,GACX,iBAAiB,GACjB,YAAY,GACZ,uBAAuB,GACvB,gBAAgB,GAChB,MAAM,GACN,aAAa,CAAC;AA8BpB,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAmtB7D;;GAEG;AACH,wBAAsB,oBAAoB,CACtC,GAAG,EAAE,qBAAqB,EAC1B,SAAS,EAAE,OAAO,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAajC"}