@xgjktech/xg_cwork_im 1.19.41 → 1.19.43

package/dist/src/action-run-event.test.js.map

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

package/dist/src/action-store-access.d.ts

@@ -0,0 +1,27 @@
+import type { PlanOrigin } from "@xgjktech/xg-openclaw-shared";
+/** 与 xg-harness-tools 的 ActionDispatchEvent 保持兼容。
+ *
+ * shared 包 0.2.2 尚未导出 action store；因此这里仅实现 IM 所需的只读 get，
+ * 直接读取同一个 SQLite 文件的 actions.doc JSON，绝不创建表或写库。
+ */
+export interface ActionDispatchEvent {
+    eventId: string;
+    event: "action_dispatch";
+    action: string;
+    topic?: string;
+    target: string;
+    version: number;
+    status: "completed" | "running" | "pending" | "failed";
+    scopeControl?: {
+        activeSessionOnly?: boolean;
+    };
+    payload: {
+        data: Record<string, unknown>;
+    };
+    timestamp: string;
+    origin?: PlanOrigin;
+}
+export declare function setActionStateDir(dir: string): void;
+/** 按 eventId 反查权威 action。缺库、旧库、畸形数据和读取异常均降级为 undefined。 */
+export declare function getActionById(eventId: string): ActionDispatchEvent | undefined;
+//# sourceMappingURL=action-store-access.d.ts.map

package/dist/src/action-store-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-store-access.d.ts","sourceRoot":"","sources":["../../src/action-store-access.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,YAAY,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;CACvB;AAQD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKnD;AAwCD,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAkB9E"}

package/dist/src/action-store-access.js

@@ -0,0 +1,74 @@
+import { DatabaseSync } from "node:sqlite";
+import { resolvePlanDbPath } from "@xgjktech/xg-openclaw-shared";
+const LOG_PREFIX = "[xg_cwork_im] [action-store]";
+let stateDir;
+let db;
+let warnedNoStateDir = false;
+export function setActionStateDir(dir) {
+    stateDir = dir;
+    db?.close();
+    db = undefined;
+    warnedNoStateDir = false;
+}
+function getDb() {
+    if (db)
+        return db;
+    if (!stateDir) {
+        if (!warnedNoStateDir) {
+            console.warn(`${LOG_PREFIX} stateDir 未设置，无法打开 action 库`);
+            warnedNoStateDir = true;
+        }
+        return undefined;
+    }
+    let dbPath = "<unresolved>";
+    try {
+        dbPath = resolvePlanDbPath(stateDir);
+        db = new DatabaseSync(dbPath, { readOnly: true });
+        db.exec("PRAGMA busy_timeout = 5000;");
+        return db;
+    }
+    catch (cause) {
+        console.warn(`${LOG_PREFIX} 打开 action 库失败 dbPath=${dbPath} 原因=${String(cause)}`);
+        return undefined;
+    }
+}
+function isActionDispatchEvent(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const event = value;
+    const payload = event.payload;
+    return typeof event.eventId === "string" && event.eventId.trim() !== ""
+        && event.event === "action_dispatch"
+        && typeof event.action === "string" && event.action.trim() !== ""
+        && typeof event.target === "string" && event.target.trim() !== ""
+        && typeof event.version === "number" && Number.isFinite(event.version) && event.version > 0
+        && ["completed", "running", "pending", "failed"].includes(event.status)
+        && typeof event.timestamp === "string" && event.timestamp.trim() !== ""
+        && typeof payload === "object" && payload !== null
+        && typeof payload.data === "object"
+        && payload.data !== null;
+}
+/** 按 eventId 反查权威 action。缺库、旧库、畸形数据和读取异常均降级为 undefined。 */
+export function getActionById(eventId) {
+    const handle = getDb();
+    if (!handle)
+        return undefined;
+    try {
+        const row = handle.prepare("SELECT doc FROM actions WHERE event_id = ?").get(eventId);
+        if (!row || typeof row.doc !== "string")
+            return undefined;
+        const action = JSON.parse(row.doc);
+        if (!isActionDispatchEvent(action)) {
+            console.warn(`${LOG_PREFIX} action 文档不符合契约 eventId=${eventId}`);
+            return undefined;
+        }
+        return action;
+    }
+    catch (cause) {
+        console.warn(`${LOG_PREFIX} 读取 action 失败 eventId=${eventId} 原因=${String(cause)}`);
+        db?.close();
+        db = undefined;
+        return undefined;
+    }
+}
+//# sourceMappingURL=action-store-access.js.map

package/dist/src/action-store-access.js.map

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

package/dist/src/active-round-registry.d.ts

@@ -0,0 +1,29 @@
+import type { ImStreamClient } from "./connection.js";
+export interface ActiveRound {
+    roundKey: string;
+    accountId: string;
+    groupId: string;
+    agentId: string;
+    sessionKey: string;
+    replyToMsgId: string;
+    generation: number;
+    streamClient: ImStreamClient;
+    startedAt: number;
+    expiresAt: number;
+    interrupted: boolean;
+}
+export declare const buildRoundKey: (accountId: string, groupId: string) => string;
+export declare function registerActiveRound(params: {
+    accountId: string;
+    groupId: string;
+    agentId: string;
+    sessionKey: string;
+    replyToMsgId: string;
+    streamClient: ImStreamClient;
+    now?: number;
+}): ActiveRound;
+export declare function findActiveRoundForSubagent(groupId: string, now?: number): ActiveRound | undefined;
+export declare function prepareActiveRoundInterrupt(accountId: string, groupId: string, now?: number): ActiveRound | undefined;
+export declare function completeActiveRound(roundKey: string, generation: number): boolean;
+export declare function __resetActiveRoundRegistryForTests(): void;
+//# sourceMappingURL=active-round-registry.d.ts.map

package/dist/src/active-round-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-round-registry.d.ts","sourceRoot":"","sources":["../../src/active-round-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAItD,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,cAAc,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACxB;AAKD,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,EAAE,SAAS,MAAM,KAAG,MACI,CAAC;AAQxE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,cAAc,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,WAAW,CAqBd;AAED,wBAAgB,0BAA0B,CACtC,OAAO,EAAE,MAAM,EACf,GAAG,SAAa,GACjB,WAAW,GAAG,SAAS,CAWzB;AAED,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,SAAa,GACjB,WAAW,GAAG,SAAS,CAMzB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAKjF;AAED,wBAAgB,kCAAkC,IAAI,IAAI,CAGzD"}

package/dist/src/active-round-registry.js

@@ -0,0 +1,60 @@
+const ACTIVE_ROUND_TTL_MS = 30 * 60 * 1000;
+const rounds = new Map();
+const generations = new Map();
+export const buildRoundKey = (accountId, groupId) => `${String(accountId || "").trim()}:${String(groupId || "").trim()}`;
+function pruneExpired(now = Date.now()) {
+    for (const [roundKey, round] of rounds) {
+        if (round.expiresAt <= now)
+            rounds.delete(roundKey);
+    }
+}
+export function registerActiveRound(params) {
+    const now = params.now ?? Date.now();
+    pruneExpired(now);
+    const roundKey = buildRoundKey(params.accountId, params.groupId);
+    const generation = (generations.get(roundKey) ?? 0) + 1;
+    generations.set(roundKey, generation);
+    const round = {
+        roundKey,
+        accountId: params.accountId,
+        groupId: params.groupId,
+        agentId: params.agentId,
+        sessionKey: params.sessionKey,
+        replyToMsgId: params.replyToMsgId,
+        generation,
+        streamClient: params.streamClient,
+        startedAt: now,
+        expiresAt: now + ACTIVE_ROUND_TTL_MS,
+        interrupted: false,
+    };
+    rounds.set(roundKey, round);
+    return round;
+}
+export function findActiveRoundForSubagent(groupId, now = Date.now()) {
+    pruneExpired(now);
+    const matches = Array.from(rounds.values()).filter((round) => !round.interrupted && round.groupId === groupId);
+    if (matches.length > 1) {
+        console.warn(`[xg_cwork_im] [subagent] ambiguous active round groupId=${groupId}; monitoring rejected`);
+    }
+    return matches.length === 1 ? matches[0] : undefined;
+}
+export function prepareActiveRoundInterrupt(accountId, groupId, now = Date.now()) {
+    pruneExpired(now);
+    const round = rounds.get(buildRoundKey(accountId, groupId));
+    if (!round || round.interrupted)
+        return undefined;
+    round.interrupted = true;
+    return round;
+}
+export function completeActiveRound(roundKey, generation) {
+    const current = rounds.get(roundKey);
+    if (!current || current.generation !== generation)
+        return false;
+    rounds.delete(roundKey);
+    return true;
+}
+export function __resetActiveRoundRegistryForTests() {
+    rounds.clear();
+    generations.clear();
+}
+//# sourceMappingURL=active-round-registry.js.map

package/dist/src/active-round-registry.js.map

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

package/dist/src/active-round-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=active-round-registry.test.d.ts.map

package/dist/src/active-round-registry.test.d.ts.map

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

package/dist/src/active-round-registry.test.js

@@ -0,0 +1,62 @@
+import assert from "node:assert/strict";
+import { afterEach, describe, it } from "node:test";
+import { __resetActiveRoundRegistryForTests, completeActiveRound, findActiveRoundForSubagent, prepareActiveRoundInterrupt, registerActiveRound, } from "./active-round-registry.js";
+const client = {};
+afterEach(() => __resetActiveRoundRegistryForTests());
+describe("active round registry", () => {
+    it("按 accountId:groupId 隔离，并用 generation 防止旧轮次误删新轮次", () => {
+        const first = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-1",
+            agentId: "main",
+            sessionKey: "session-a1",
+            replyToMsgId: "reply-a1",
+            streamClient: client,
+        });
+        const otherAccount = registerActiveRound({
+            accountId: "account-b",
+            groupId: "group-1",
+            agentId: "main",
+            sessionKey: "session-b1",
+            replyToMsgId: "reply-b1",
+            streamClient: client,
+        });
+        assert.equal(findActiveRoundForSubagent("group-1"), undefined);
+        assert.equal(prepareActiveRoundInterrupt("account-a", "group-1"), first);
+        assert.equal(prepareActiveRoundInterrupt("account-b", "group-1"), otherAccount);
+        const next = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-1",
+            agentId: "main",
+            sessionKey: "session-a2",
+            replyToMsgId: "reply-a2",
+            streamClient: client,
+        });
+        assert.equal(completeActiveRound(first.roundKey, first.generation), false);
+        assert.equal(prepareActiveRoundInterrupt("account-a", "group-1"), next);
+    });
+    it("超过 30 分钟的活动轮次不会再被 stop 命中", () => {
+        registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-1",
+            agentId: "main",
+            sessionKey: "session-a1",
+            replyToMsgId: "reply-a1",
+            streamClient: client,
+            now: 1,
+        });
+        assert.equal(prepareActiveRoundInterrupt("account-a", "group-1", 30 * 60_000 + 2), undefined);
+    });
+    it("subagent 的目标 agentId 不影响按 groupId 命中唯一主轮次", () => {
+        const round = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-1",
+            agentId: "main",
+            sessionKey: "session-a1",
+            replyToMsgId: "reply-a1",
+            streamClient: client,
+        });
+        assert.equal(findActiveRoundForSubagent("group-1"), round);
+    });
+});
+//# sourceMappingURL=active-round-registry.test.js.map

package/dist/src/active-round-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-round-registry.test.js","sourceRoot":"","sources":["../../src/active-round-registry.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EACH,kCAAkC,EAClC,mBAAmB,EACnB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,GACtB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,GAAG,EAAoB,CAAC;AAEpC,SAAS,CAAC,GAAG,EAAE,CAAC,kCAAkC,EAAE,CAAC,CAAC;AAEtD,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAC9B,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,YAAY;YACxB,YAAY,EAAE,UAAU;YACxB,YAAY,EAAE,MAAM;SACvB,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,mBAAmB,CAAC;YACrC,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,YAAY;YACxB,YAAY,EAAE,UAAU;YACxB,YAAY,EAAE,MAAM;SACvB,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;QAC/D,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;QACzE,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;QAEhF,MAAM,IAAI,GAAG,mBAAmB,CAAC;YAC7B,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,YAAY;YACxB,YAAY,EAAE,UAAU;YACxB,YAAY,EAAE,MAAM;SACvB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,mBAAmB,CAAC;YAChB,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,YAAY;YACxB,YAAY,EAAE,UAAU;YACxB,YAAY,EAAE,MAAM;YACpB,GAAG,EAAE,CAAC;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACjD,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAC9B,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,YAAY;YACxB,YAAY,EAAE,UAAU;YACxB,YAAY,EAAE,MAAM;SACvB,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/src/agent-context-types.d.ts

@@ -0,0 +1,205 @@
+/**
+ * robotMention.params.agentContext — 可选项目工作区 / NAS 挂载 + 知识库绑定 + 项目背景
+ */
+import { z } from "zod";
+export declare const nasVolumeSchema: z.ZodObject<{
+    realDir: z.ZodString;
+    dockerDir: z.ZodString;
+    mode: z.ZodEnum<["ro", "rw"]>;
+}, "strip", z.ZodTypeAny, {
+    realDir: string;
+    dockerDir: string;
+    mode: "ro" | "rw";
+}, {
+    realDir: string;
+    dockerDir: string;
+    mode: "ro" | "rw";
+}>;
+export type NasVolume = z.infer<typeof nasVolumeSchema>;
+/** 知识库空间 ID + 逻辑目录路径 */
+declare const knowledgeBaseByPathSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    folderPath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    folderPath: string;
+}, {
+    projectId: string;
+    folderPath: string;
+}>;
+/** IM 常见：仅传知识库空间 ID（无 folderPath） */
+declare const knowledgeBaseByProjectIdOnlySchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+export declare const agentContextKnowledgeBaseSchema: z.ZodUnion<[z.ZodObject<{
+    rootFileId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    rootFileId: string;
+}, {
+    rootFileId: string;
+}>, z.ZodObject<{
+    projectId: z.ZodString;
+    folderPath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    folderPath: string;
+}, {
+    projectId: string;
+    folderPath: string;
+}>, z.ZodObject<{
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>]>;
+export type AgentContextKnowledgeBase = z.infer<typeof agentContextKnowledgeBaseSchema>;
+/** 与 IM 后台约定的 `params.agentContext` 结构 */
+export declare const robotMentionAgentContextSchema: z.ZodEffects<z.ZodObject<{
+    localRoot: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<["workspace_relative", "host_absolute"]>;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    }, {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    }>>;
+    nasVolumes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        realDir: z.ZodString;
+        dockerDir: z.ZodString;
+        mode: z.ZodEnum<["ro", "rw"]>;
+    }, "strip", z.ZodTypeAny, {
+        realDir: string;
+        dockerDir: string;
+        mode: "ro" | "rw";
+    }, {
+        realDir: string;
+        dockerDir: string;
+        mode: "ro" | "rw";
+    }>, "many">>;
+    knowledgeBase: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        rootFileId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        rootFileId: string;
+    }, {
+        rootFileId: string;
+    }>, z.ZodObject<{
+        projectId: z.ZodString;
+        folderPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        projectId: string;
+        folderPath: string;
+    }, {
+        projectId: string;
+        folderPath: string;
+    }>, z.ZodObject<{
+        projectId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        projectId: string;
+    }, {
+        projectId: string;
+    }>]>>;
+    background: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    localRoot?: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    } | undefined;
+    nasVolumes?: {
+        realDir: string;
+        dockerDir: string;
+        mode: "ro" | "rw";
+    }[] | undefined;
+    knowledgeBase?: {
+        rootFileId: string;
+    } | {
+        projectId: string;
+        folderPath: string;
+    } | {
+        projectId: string;
+    } | undefined;
+    background?: string | undefined;
+}, {
+    localRoot?: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    } | undefined;
+    nasVolumes?: {
+        realDir: string;
+        dockerDir: string;
+        mode: "ro" | "rw";
+    }[] | undefined;
+    knowledgeBase?: {
+        rootFileId: string;
+    } | {
+        projectId: string;
+        folderPath: string;
+    } | {
+        projectId: string;
+    } | undefined;
+    background?: string | undefined;
+}>, {
+    localRoot?: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    } | undefined;
+    nasVolumes?: {
+        realDir: string;
+        dockerDir: string;
+        mode: "ro" | "rw";
+    }[] | undefined;
+    knowledgeBase?: {
+        rootFileId: string;
+    } | {
+        projectId: string;
+        folderPath: string;
+    } | {
+        projectId: string;
+    } | undefined;
+    background?: string | undefined;
+}, {
+    localRoot?: {
+        kind: "workspace_relative" | "host_absolute";
+        path: string;
+    } | undefined;
+    nasVolumes?: {
+        realDir: string;
+        dockerDir: string;
+        mode: "ro" | "rw";
+    }[] | undefined;
+    knowledgeBase?: {
+        rootFileId: string;
+    } | {
+        projectId: string;
+        folderPath: string;
+    } | {
+        projectId: string;
+    } | undefined;
+    background?: string | undefined;
+}>;
+export type RobotMentionAgentContext = z.infer<typeof robotMentionAgentContextSchema>;
+export type ParseRobotMentionAgentContextResult = {
+    agentContext?: RobotMentionAgentContext;
+    /** 被忽略的非法字段；仅用于日志诊断，不得阻断消息处理。 */
+    fatalError?: string;
+    /** knowledgeBase 存在但无法解析时被丢弃 */
+    knowledgeBaseDropped?: boolean;
+    knowledgeBaseDropReason?: string;
+};
+/**
+ * 解析 agentContext；knowledgeBase 非法时丢弃该字段，仍保留工作区上下文与 background。
+ */
+export declare function parseRobotMentionAgentContextDetailed(params: unknown): ParseRobotMentionAgentContextResult;
+export declare function parseRobotMentionAgentContext(params: unknown): RobotMentionAgentContext | undefined;
+/** 判断 knowledgeBase 是否为 projectId + folderPath 形式 */
+export declare function isKnowledgeBaseByPath(kb: AgentContextKnowledgeBase): kb is z.infer<typeof knowledgeBaseByPathSchema>;
+/** 判断 knowledgeBase 是否仅有 projectId（无 folderPath / rootFileId） */
+export declare function isKnowledgeBaseByProjectIdOnly(kb: AgentContextKnowledgeBase): kb is z.infer<typeof knowledgeBaseByProjectIdOnlySchema>;
+export {};
+//# sourceMappingURL=agent-context-types.d.ts.map

package/dist/src/agent-context-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-types.d.ts","sourceRoot":"","sources":["../../src/agent-context-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAOxD,wBAAwB;AACxB,QAAA,MAAM,yBAAyB;;;;;;;;;EAG7B,CAAC;AAEH,qCAAqC;AACrC,QAAA,MAAM,kCAAkC;;;;;;EAEtC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;IAI1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,0CAA0C;AAC1C,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAazC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,MAAM,MAAM,mCAAmC,GAAG;IAC9C,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAQF;;GAEG;AACH,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,OAAO,GAAG,mCAAmC,CAoE1G;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,GAAG,wBAAwB,GAAG,SAAS,CAEnG;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CACjC,EAAE,EAAE,yBAAyB,GAC9B,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAEjD;AAED,iEAAiE;AACjE,wBAAgB,8BAA8B,CAC1C,EAAE,EAAE,yBAAyB,GAC9B,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAE1D"}

package/dist/src/agent-context-types.js

@@ -0,0 +1,132 @@
+/**
+ * robotMention.params.agentContext — 可选项目工作区 / NAS 挂载 + 知识库绑定 + 项目背景
+ */
+import { z } from "zod";
+import { LOCAL_ROOT_KINDS } from "./project-path-normalize.js";
+const localRootSchema = z.object({
+    kind: z.enum(LOCAL_ROOT_KINDS),
+    path: z.string().min(1),
+});
+export const nasVolumeSchema = z.object({
+    realDir: z.string().min(1).max(1024),
+    dockerDir: z.string().min(1).max(1024),
+    mode: z.enum(["ro", "rw"]),
+});
+/** 知识库目录 fileId（与 projectId 形式二选一） */
+const knowledgeBaseByFileIdSchema = z.object({
+    rootFileId: z.string().min(1),
+});
+/** 知识库空间 ID + 逻辑目录路径 */
+const knowledgeBaseByPathSchema = z.object({
+    projectId: z.string().min(1),
+    folderPath: z.string().min(1),
+});
+/** IM 常见：仅传知识库空间 ID（无 folderPath） */
+const knowledgeBaseByProjectIdOnlySchema = z.object({
+    projectId: z.string().min(1),
+});
+export const agentContextKnowledgeBaseSchema = z.union([
+    knowledgeBaseByFileIdSchema,
+    knowledgeBaseByPathSchema,
+    knowledgeBaseByProjectIdOnlySchema,
+]);
+/** 与 IM 后台约定的 `params.agentContext` 结构 */
+export const robotMentionAgentContextSchema = z.object({
+    localRoot: localRootSchema.optional(),
+    nasVolumes: z.array(nasVolumeSchema).max(16).optional(),
+    knowledgeBase: agentContextKnowledgeBaseSchema.optional(),
+    background: z.string().optional(),
+}).superRefine((value, ctx) => {
+    if (!value.localRoot && !value.nasVolumes?.length) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["localRoot"],
+            message: "localRoot 与 nasVolumes 至少需要提供一个",
+        });
+    }
+});
+function formatZodIssue(err) {
+    const issue = err.issues[0];
+    const path = issue?.path?.length ? issue.path.join(".") : "agentContext";
+    return `${path}: ${issue?.message ?? err.message}`;
+}
+/**
+ * 解析 agentContext；knowledgeBase 非法时丢弃该字段，仍保留工作区上下文与 background。
+ */
+export function parseRobotMentionAgentContextDetailed(params) {
+    if (params == null || typeof params !== "object") {
+        return {};
+    }
+    const raw = params.agentContext;
+    if (raw == null || typeof raw !== "object") {
+        return {};
+    }
+    const record = raw;
+    const droppedReasons = [];
+    const localRootParsed = record.localRoot == null ? undefined : localRootSchema.safeParse(record.localRoot);
+    if (localRootParsed && !localRootParsed.success) {
+        droppedReasons.push(formatZodIssue(localRootParsed.error));
+    }
+    const nasVolumes = [];
+    if (record.nasVolumes != null) {
+        if (!Array.isArray(record.nasVolumes)) {
+            droppedReasons.push("nasVolumes: Expected array");
+        }
+        else {
+            for (const [index, rawVolume] of record.nasVolumes.slice(0, 16).entries()) {
+                const parsed = nasVolumeSchema.safeParse(rawVolume);
+                if (parsed.success) {
+                    nasVolumes.push(parsed.data);
+                }
+                else {
+                    droppedReasons.push(`nasVolumes.${index}: ${formatZodIssue(parsed.error)}`);
+                }
+            }
+            if (record.nasVolumes.length > 16) {
+                droppedReasons.push("nasVolumes: 超过 16 项的部分已忽略");
+            }
+        }
+    }
+    // 保持旧逻辑：没有有效工作区来源时忽略整个 agentContext，但绝不阻断消息。
+    if (!localRootParsed?.success && nasVolumes.length === 0) {
+        return {
+            ...(droppedReasons.length > 0 ? { fatalError: droppedReasons.join("; ") } : {}),
+        };
+    }
+    let knowledgeBase;
+    let knowledgeBaseDropped = false;
+    let knowledgeBaseDropReason;
+    if (record.knowledgeBase != null) {
+        const kbParsed = agentContextKnowledgeBaseSchema.safeParse(record.knowledgeBase);
+        if (kbParsed.success) {
+            knowledgeBase = kbParsed.data;
+        }
+        else {
+            knowledgeBaseDropped = true;
+            knowledgeBaseDropReason = formatZodIssue(kbParsed.error);
+        }
+    }
+    const background = typeof record.background === "string" ? record.background : undefined;
+    return {
+        agentContext: {
+            ...(localRootParsed?.success ? { localRoot: localRootParsed.data } : {}),
+            ...(nasVolumes.length > 0 ? { nasVolumes } : {}),
+            ...(knowledgeBase ? { knowledgeBase } : {}),
+            ...(background !== undefined ? { background } : {}),
+        },
+        ...(droppedReasons.length > 0 ? { fatalError: droppedReasons.join("; ") } : {}),
+        ...(knowledgeBaseDropped ? { knowledgeBaseDropped, knowledgeBaseDropReason } : {}),
+    };
+}
+export function parseRobotMentionAgentContext(params) {
+    return parseRobotMentionAgentContextDetailed(params).agentContext;
+}
+/** 判断 knowledgeBase 是否为 projectId + folderPath 形式 */
+export function isKnowledgeBaseByPath(kb) {
+    return "projectId" in kb && "folderPath" in kb;
+}
+/** 判断 knowledgeBase 是否仅有 projectId（无 folderPath / rootFileId） */
+export function isKnowledgeBaseByProjectIdOnly(kb) {
+    return "projectId" in kb && !("folderPath" in kb) && !("rootFileId" in kb);
+}
+//# sourceMappingURL=agent-context-types.js.map

package/dist/src/agent-context-types.js.map

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

package/dist/src/agent-context-types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-context-types.test.d.ts.map