@xgjktech/xg_cwork_im 1.19.28 → 1.19.29

package/dist/src/user-facing-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-facing-errors.d.ts","sourceRoot":"","sources":["../../src/user-facing-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG/E,MAAM,MAAM,sBAAsB,GAAG;IACjC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;OAEG;IACH,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACzC,CAAC;AAEF,8BAA8B;AAC9B,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,aAAa,GAAG,0BAA0B,CAAC;AAIlG,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQxE;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGxE;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAatE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBrE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACpC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,sBAAsB,GACjC,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,MAAM,CAgChG"}

package/dist/src/user-facing-errors.js

@@ -0,0 +1,120 @@
+/**
+ * 面向 IM 的确认错误文案：仅白名单翻译或透传上游原文；不编造「没有生成回复」等结论。
+ */
+import { summarizeMediaRef } from "./resource-file.js";
+const UPSTREAM_ERROR_PASSTHROUGH_MAX = 500;
+export function isAttachmentBlockedErrorMessage(message) {
+    const lower = message.trim().toLowerCase();
+    return (lower.includes("blocked attachment") ||
+        lower.includes("outside allowed roots") ||
+        lower.includes("not under an allowed directory") ||
+        (lower.includes("skipping attachment") && lower.includes("blocked")));
+}
+export function isWebSocketNotReadyErrorMessage(message) {
+    const lower = message.trim().toLowerCase();
+    return lower.includes("websocket is not ready");
+}
+export function isContextOverflowErrorMessage(message) {
+    const lower = message.trim().toLowerCase();
+    return (lower.includes("context overflow") ||
+        lower.includes("context-overflow") ||
+        lower.includes("overflowtokens") ||
+        lower.includes("overflow tokens") ||
+        lower.includes("prompt too large") ||
+        lower.includes("too large for the model") ||
+        lower.includes("too large for this model") ||
+        lower.includes("promptbudget") ||
+        (lower.includes("precheck") && lower.includes("overflow")));
+}
+export function isNasVolumeErrorMessage(message) {
+    const trimmed = message.trim();
+    return trimmed.includes("NAS_VOLUME_") || trimmed.includes("nasVolumes.dockerDir");
+}
+/**
+ * 上游错误 → IM 正文：确认白名单译人话，否则透传截断原文；无内容则空串。
+ */
+export function formatConfirmedUpstreamErrorForIm(raw) {
+    const t = raw.trim();
+    if (!t || t === "(empty)")
+        return "";
+    if (isAttachmentBlockedErrorMessage(t)) {
+        return "您发送的图片或附件未能加载（系统路径访问受限），模型可能看不到附件内容；文本消息已收到。";
+    }
+    if (isWebSocketNotReadyErrorMessage(t)) {
+        return "网络不太稳定，请稍后再试。";
+    }
+    if (isContextOverflowErrorMessage(t)) {
+        return "当前对话上下文过大，处理失败。";
+    }
+    if (isNasVolumeErrorMessage(t)) {
+        return "当前会话工作区准备失败，消息未执行。";
+    }
+    if (t.length <= UPSTREAM_ERROR_PASSTHROUGH_MAX)
+        return t;
+    return `${t.slice(0, UPSTREAM_ERROR_PASSTHROUGH_MAX - 1)}…`;
+}
+/**
+ * 终态 HTTP 文案：仅 delivery_failed / 确认错误等；no_reply / timeout / compaction 返回空（不发）。
+ */
+export function buildTerminalUserMessage(state, context) {
+    switch (state) {
+        case "no_reply":
+        case "timeout":
+        case "compaction_failed":
+        case "success":
+            return "";
+        case "precheck_error":
+        case "runtime_error":
+            return formatConfirmedUpstreamErrorForIm(context?.errorMessage ?? "");
+        case "delivery_failed":
+            return "回复已生成，但发送到 IM 时失败。";
+        case "cancelled":
+            return "当前请求已取消。";
+        case "superseded":
+            return "当前请求已被更新的处理覆盖。";
+    }
+}
+/**
+ * 出站发文件失败时，将技术错误转为用户可读说明（不含实现细节与操作建议）。
+ */
+export function formatUserFacingMediaDeliverError(err, mediaRefs = []) {
+    const raw = err instanceof Error ? err.message : String(err);
+    const lower = raw.toLowerCase();
+    const ref = mediaRefs.find((u) => u.trim())?.trim() ?? extractPathFromMediaError(raw);
+    const shortRef = ref ? summarizeMediaRef(ref, 120) : undefined;
+    if (lower.includes("无法读取媒体") || lower.includes("unsupported ref")) {
+        if (shortRef && looksLikeWorkspaceRelativePath(shortRef)) {
+            return `未能将文件发送到 IM：找不到或无法读取「${shortRef}」。`;
+        }
+        return "未能将文件发送到 IM：找不到或无法读取附件路径。";
+    }
+    if (lower.includes("enoent") || lower.includes("no such file")) {
+        return shortRef
+            ? `未能将文件发送到 IM：本地找不到「${shortRef}」。`
+            : "未能将文件发送到 IM：本地找不到对应文件。";
+    }
+    if (lower.includes("eacces") || lower.includes("permission denied")) {
+        return "未能将文件发送到 IM：没有读取该文件的权限。";
+    }
+    if (lower.includes("abort") || lower.includes("timeout") || lower.includes("timed out")) {
+        return "未能将文件发送到 IM：读取或上传超时。";
+    }
+    if (lower.includes("axios") || lower.includes("network") || lower.includes("econnrefused")) {
+        return "未能将文件发送到 IM：网络或上传服务异常。";
+    }
+    return "未能将文件发送到 IM。";
+}
+function looksLikeWorkspaceRelativePath(ref) {
+    const t = ref.trim();
+    return (t.startsWith("project/") ||
+        t.startsWith("./project/") ||
+        t.startsWith("/project/") ||
+        t.startsWith("xg-cwork-im/") ||
+        t.startsWith("./xg") ||
+        t.startsWith("/workspace/"));
+}
+function extractPathFromMediaError(raw) {
+    const m = /:\s*(\S+)\s*$/.exec(raw.trim());
+    return m?.[1];
+}
+//# sourceMappingURL=user-facing-errors.js.map

package/dist/src/user-facing-errors.js.map

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

package/dist/src/user-facing-errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=user-facing-errors.test.d.ts.map

package/dist/src/user-facing-errors.test.d.ts.map

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

package/dist/src/user-facing-errors.test.js

@@ -0,0 +1,102 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { buildTerminalUserMessage, formatConfirmedUpstreamErrorForIm, formatUserFacingMediaDeliverError, isAttachmentBlockedErrorMessage, isContextOverflowErrorMessage, isNasVolumeErrorMessage, isWebSocketNotReadyErrorMessage, } from "./user-facing-errors.js";
+describe("isContextOverflowErrorMessage", () => {
+    it("detects context-overflow-precheck log style", () => {
+        assert.equal(isContextOverflowErrorMessage("[context-overflow-precheck] overflowTokens=72970 estimatedPromptTokens=328586"), true);
+    });
+});
+describe("isAttachmentBlockedErrorMessage", () => {
+    it("detects blocked attachment roots", () => {
+        assert.equal(isAttachmentBlockedErrorMessage("Blocked attachment path outside allowed roots: ./project/a.png"), true);
+        assert.equal(isAttachmentBlockedErrorMessage("Local media path is not under an allowed directory: /Users/x/ws/project/a.png"), true);
+    });
+});
+describe("isWebSocketNotReadyErrorMessage", () => {
+    it("detects WebSocket not ready error", () => {
+        assert.equal(isWebSocketNotReadyErrorMessage("[cwork_im:main] WebSocket is not ready for sending stream message"), true);
+        assert.equal(isWebSocketNotReadyErrorMessage("WebSocket is not ready"), true);
+        assert.equal(isWebSocketNotReadyErrorMessage("Some other error"), false);
+    });
+});
+describe("formatConfirmedUpstreamErrorForIm", () => {
+    it("maps overflow and attachment; passthrough unknown", () => {
+        assert.ok(formatConfirmedUpstreamErrorForIm("[context-overflow-precheck] overflowTokens=100").includes("上下文过大"));
+        assert.ok(formatConfirmedUpstreamErrorForIm("Blocked attachment path outside allowed roots: ./x.png").includes("附件未能加载"));
+        assert.equal(formatConfirmedUpstreamErrorForIm("Some upstream boom"), "Some upstream boom");
+        assert.equal(formatConfirmedUpstreamErrorForIm(""), "");
+    });
+    it("maps WebSocket not ready to network unstable", () => {
+        const msg = formatConfirmedUpstreamErrorForIm("[cwork_im:main] WebSocket is not ready for sending stream message");
+        assert.ok(msg.includes("网络不太稳定"));
+        assert.ok(!msg.includes("[cwork_im:"));
+        assert.ok(!msg.includes("WebSocket"));
+    });
+    it("hides NAS host paths and configuration details", () => {
+        const raw = "NAS_VOLUME_SOURCE_FORBIDDEN: realDir 不在允许根内: /data/touqian/secret";
+        assert.equal(isNasVolumeErrorMessage(raw), true);
+        const msg = formatConfirmedUpstreamErrorForIm(raw);
+        assert.equal(msg, "当前会话工作区准备失败，消息未执行。");
+        assert.ok(!msg.includes("/data/"));
+    });
+});
+describe("buildTerminalUserMessage", () => {
+    it("refines runtime_error for attachment block", () => {
+        const msg = buildTerminalUserMessage("runtime_error", {
+            errorMessage: "Blocked attachment path outside allowed roots: ./project/x.png",
+        });
+        assert.ok(msg.includes("附件未能加载"));
+        assert.ok(!msg.includes("Blocked attachment"));
+    });
+    it("refines runtime_error for context overflow", () => {
+        const msg = buildTerminalUserMessage("runtime_error", {
+            errorMessage: "[context-overflow-precheck] overflowTokens=100",
+        });
+        assert.ok(msg.includes("上下文过大"));
+    });
+    it("does not invent no_reply or timeout copy", () => {
+        assert.equal(buildTerminalUserMessage("no_reply", { noReplyCause: "zero_deliver" }), "");
+        assert.equal(buildTerminalUserMessage("no_reply"), "");
+        assert.equal(buildTerminalUserMessage("timeout", { timeoutCause: "in_progress" }), "");
+        assert.equal(buildTerminalUserMessage("timeout"), "");
+        assert.equal(buildTerminalUserMessage("compaction_failed"), "");
+    });
+    it("passthrough unknown runtime errors; empty without upstream text", () => {
+        assert.equal(buildTerminalUserMessage("runtime_error", { errorMessage: "boom-xyz" }), "boom-xyz");
+        assert.equal(buildTerminalUserMessage("runtime_error"), "");
+        assert.equal(buildTerminalUserMessage("precheck_error"), "");
+    });
+    it("keeps delivery_failed as channel fact", () => {
+        assert.ok(buildTerminalUserMessage("delivery_failed").includes("发送到 IM 时失败"));
+    });
+    it("does not include operational suggestions in terminal copy", () => {
+        const cases = [
+            buildTerminalUserMessage("runtime_error", { errorMessage: "x" }),
+            buildTerminalUserMessage("precheck_error", {
+                errorMessage: "Context overflow: prompt too large for the model (precheck)",
+            }),
+            buildTerminalUserMessage("delivery_failed"),
+        ];
+        for (const msg of cases) {
+            assert.ok(!/请(稍后|发送|联系|确认|新开|换)/.test(msg));
+            assert.ok(!msg.includes("管理员"));
+        }
+    });
+});
+describe("formatUserFacingMediaDeliverError", () => {
+    it("maps workspace-relative media read failure", () => {
+        const msg = formatUserFacingMediaDeliverError(new Error("[cwork_im] 无法读取媒体（请使用 http(s)...）: project/202607/207/artifacts/daily/summary.md"), ["project/202607/207/artifacts/daily/summary.md"]);
+        assert.ok(msg.includes("未能将文件发送到 IM"));
+        assert.ok(msg.includes("project/"));
+        assert.ok(!msg.includes("[cwork_im]"));
+        assert.ok(!msg.includes("http(s)"));
+        assert.ok(!/请(稍后|发送|联系|确认)/.test(msg));
+    });
+    it("maps enoent", () => {
+        const msg = formatUserFacingMediaDeliverError(new Error("ENOENT: no such file"), [
+            "./project/a.md",
+        ]);
+        assert.ok(msg.includes("找不到"));
+    });
+});
+//# sourceMappingURL=user-facing-errors.test.js.map

package/dist/src/user-facing-errors.test.js.map

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

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

@@ -0,0 +1,3 @@
+/** 工作区请求和结果共用一个 cmd，具体操作只通过 params.event 区分。 */
+export declare const OPENCLAW_WORKSPACE_EVENT_CMD = "openclawWorkspaceEvent";
+//# sourceMappingURL=workspace-event-protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-event-protocol.d.ts","sourceRoot":"","sources":["../../src/workspace-event-protocol.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,eAAO,MAAM,4BAA4B,2BAA2B,CAAC"}

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

@@ -0,0 +1,3 @@
+/** 工作区请求和结果共用一个 cmd，具体操作只通过 params.event 区分。 */
+export const OPENCLAW_WORKSPACE_EVENT_CMD = "openclawWorkspaceEvent";
+//# sourceMappingURL=workspace-event-protocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-event-protocol.js","sourceRoot":"","sources":["../../src/workspace-event-protocol.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC"}

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

@@ -0,0 +1,54 @@
+import type { XgImConfig } from "./types.js";
+/** 一台 OpenClaw 进程内共享的工作区并发默认值。 */
+export declare const DEFAULT_WORKSPACE_EVENT_MAX_CONCURRENCY = 32;
+export declare const DEFAULT_WORKSPACE_EVENT_MAX_FILE_CONCURRENCY = 8;
+export declare const DEFAULT_WORKSPACE_EVENT_PER_AGENT_CONCURRENCY = 2;
+export declare const DEFAULT_WORKSPACE_EVENT_QUEUE_LIMIT = 64;
+/**
+ * ws-notify 的回程路由默认 60 秒失效。排队超过 45 秒就返回 BUSY，给回包发送和
+ * 网络转发留出余量，避免插件完成了工作但客户端因 relay 已过期而收不到结果。
+ */
+export declare const WORKSPACE_EVENT_QUEUE_WAIT_MS = 45000;
+export type WorkspaceEventTaskKind = "TREE" | "FILE";
+export type WorkspaceEventBusyReason = "QUEUE_FULL" | "QUEUE_TIMEOUT";
+export interface WorkspaceEventConcurrencyLimits {
+    maxConcurrency: number;
+    maxFileConcurrency: number;
+    perAgentConcurrency: number;
+    queueLimit: number;
+    queueWaitMs: number;
+}
+/**
+ * 并发参数是机器级配置。即使某个旧配置绕过 schema，也在这里补默认值并保证
+ * 文件/单 Agent 上限不会大于全局上限。
+ */
+export declare function resolveWorkspaceEventConcurrencyLimits(config: Pick<XgImConfig, "workspaceEventMaxConcurrency" | "workspaceEventMaxFileConcurrency" | "workspaceEventPerAgentConcurrency" | "workspaceEventQueueLimit">): WorkspaceEventConcurrencyLimits;
+/**
+ * 进程级工作区调度器。一个插件进程中的所有机器人账户共享同一实例，避免把
+ * “每 Agent 并发”错误地放大为 Agent 数量乘以并发数。
+ */
+export declare class WorkspaceEventScheduler {
+    private activeTotal;
+    private activeFiles;
+    private readonly activeByAgent;
+    private readonly queue;
+    run<T>(args: {
+        agentKey: string;
+        kind: WorkspaceEventTaskKind;
+        limits: WorkspaceEventConcurrencyLimits;
+        task: () => Promise<T>;
+        onBusy: (reason: WorkspaceEventBusyReason) => T;
+    }): Promise<T>;
+    /** 只用于测试和运行监控，不暴露队列中的业务参数。 */
+    snapshot(): {
+        activeTotal: number;
+        activeFiles: number;
+        queued: number;
+    };
+    private canStart;
+    private start;
+    private drain;
+    private expire;
+}
+export declare const workspaceEventScheduler: WorkspaceEventScheduler;
+//# sourceMappingURL=workspace-event-scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-event-scheduler.d.ts","sourceRoot":"","sources":["../../src/workspace-event-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,kCAAkC;AAClC,eAAO,MAAM,uCAAuC,KAAK,CAAC;AAC1D,eAAO,MAAM,4CAA4C,IAAI,CAAC;AAC9D,eAAO,MAAM,6CAA6C,IAAI,CAAC;AAC/D,eAAO,MAAM,mCAAmC,KAAK,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,wBAAwB,GAAG,YAAY,GAAG,eAAe,CAAC;AAEtE,MAAM,WAAW,+BAA+B;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB;AAqBD;;;GAGG;AACH,wBAAgB,sCAAsC,CAClD,MAAM,EAAE,IAAI,CACR,UAAU,EACR,8BAA8B,GAC9B,kCAAkC,GAClC,mCAAmC,GACnC,0BAA0B,CAC/B,GACF,+BAA+B,CAwBjC;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAChC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAE3C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,sBAAsB,CAAC;QAC7B,MAAM,EAAE,+BAA+B,CAAC;QACxC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,CAAC,CAAC;IA+Bd,8BAA8B;IAC9B,QAAQ,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAQxE,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,KAAK;IAmBb,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,MAAM;CAUjB;AAED,eAAO,MAAM,uBAAuB,yBAAgC,CAAC"}

package/dist/src/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-event-scheduler.js.map

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

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

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

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

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

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