@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

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

@@ -0,0 +1,241 @@
+/**
+ * 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"]>;
+    /**
+     * pull: NAS → workspace（拷贝，不挂载）
+     * push: workspace → NAS（拷贝，不挂载）
+     * none / 空 / 缺省: 原逻辑（Docker bind 挂载）
+     */
+    sync: z.ZodOptional<z.ZodString>;
+    /**
+     * 逗号/分号分隔的简易 glob，如 `*.md,*.html`；空/缺省=全部（仍忽略点开头路径）。
+     */
+    include: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    realDir: string;
+    dockerDir: string;
+    mode: "ro" | "rw";
+    sync?: string | undefined;
+    include?: string | undefined;
+}, {
+    realDir: string;
+    dockerDir: string;
+    mode: "ro" | "rw";
+    sync?: string | undefined;
+    include?: string | undefined;
+}>;
+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"]>;
+        /**
+         * pull: NAS → workspace（拷贝，不挂载）
+         * push: workspace → NAS（拷贝，不挂载）
+         * none / 空 / 缺省: 原逻辑（Docker bind 挂载）
+         */
+        sync: z.ZodOptional<z.ZodString>;
+        /**
+         * 逗号/分号分隔的简易 glob，如 `*.md,*.html`；空/缺省=全部（仍忽略点开头路径）。
+         */
+        include: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        realDir: string;
+        dockerDir: string;
+        mode: "ro" | "rw";
+        sync?: string | undefined;
+        include?: string | undefined;
+    }, {
+        realDir: string;
+        dockerDir: string;
+        mode: "ro" | "rw";
+        sync?: string | undefined;
+        include?: string | undefined;
+    }>, "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";
+        sync?: string | undefined;
+        include?: string | undefined;
+    }[] | 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";
+        sync?: string | undefined;
+        include?: string | undefined;
+    }[] | 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";
+        sync?: string | undefined;
+        include?: string | undefined;
+    }[] | 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";
+        sync?: string | undefined;
+        include?: string | undefined;
+    }[] | 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/session/agent-context-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-types.d.ts","sourceRoot":"","sources":["../../../src/session/agent-context-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,eAAe;;;;IAIxB;;;;OAIG;;IAEH;;OAEG;;;;;;;;;;;;;;EAEL,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;;;;;;;;;;;;;;;QAvCvC;;;;WAIG;;QAEH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CL,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/session/agent-context-types.js

@@ -0,0 +1,142 @@
+/**
+ * robotMention.params.agentContext — 可选项目工作区 / NAS 挂载 + 知识库绑定 + 项目背景
+ */
+import { z } from "zod";
+import { LOCAL_ROOT_KINDS } from "../workspace/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"]),
+    /**
+     * pull: NAS → workspace（拷贝，不挂载）
+     * push: workspace → NAS（拷贝，不挂载）
+     * none / 空 / 缺省: 原逻辑（Docker bind 挂载）
+     */
+    sync: z.string().max(32).optional(),
+    /**
+     * 逗号/分号分隔的简易 glob，如 `*.md,*.html`；空/缺省=全部（仍忽略点开头路径）。
+     */
+    include: z.string().max(512).optional(),
+});
+/** 知识库目录 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/session/agent-context-types.js.map

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

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

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

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

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

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

@@ -0,0 +1,140 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { parseRobotMentionAgentContext, parseRobotMentionAgentContextDetailed, } from "./agent-context-types.js";
+const USER_PAYLOAD = {
+    agentContext: {
+        background: "- 项目名称：Sitavig\n\n该项目对应的知识库根目录id为:2072258063360479234\n\n### 会话背景信息：\n待办内容：BD初审修订任务",
+        knowledgeBase: { projectId: "1660820549716893698" },
+        localRoot: { kind: "workspace_relative", path: "project/202607/2074431529933336577" },
+    },
+};
+describe("parseRobotMentionAgentContext", () => {
+    it("accepts knowledgeBase with projectId only (IM 常见形态)", () => {
+        const ctx = parseRobotMentionAgentContext(USER_PAYLOAD);
+        assert.ok(ctx);
+        assert.equal(ctx.localRoot.path, "project/202607/2074431529933336577");
+        assert.deepEqual(ctx.knowledgeBase, { projectId: "1660820549716893698" });
+        assert.ok(ctx.background?.includes("Sitavig"));
+    });
+    it("accepts knowledgeBase with projectId and folderPath", () => {
+        const ctx = parseRobotMentionAgentContext({
+            agentContext: {
+                localRoot: { kind: "workspace_relative", path: "data/a" },
+                knowledgeBase: { projectId: "p1", folderPath: "团队文档/项目A" },
+            },
+        });
+        assert.deepEqual(ctx.knowledgeBase, {
+            projectId: "p1",
+            folderPath: "团队文档/项目A",
+        });
+    });
+    it("accepts knowledgeBase with rootFileId", () => {
+        const ctx = parseRobotMentionAgentContext({
+            agentContext: {
+                localRoot: { kind: "workspace_relative", path: "data/a" },
+                knowledgeBase: { rootFileId: "2072258063360479234" },
+            },
+        });
+        assert.deepEqual(ctx.knowledgeBase, { rootFileId: "2072258063360479234" });
+    });
+    it("ignores a context with no valid workspace source without making it fatal", () => {
+        const result = parseRobotMentionAgentContextDetailed({
+            agentContext: { background: "x" },
+        });
+        assert.equal(result.agentContext, undefined);
+        assert.equal(result.fatalError, undefined);
+    });
+    it("accepts nasVolumes without localRoot", () => {
+        const ctx = parseRobotMentionAgentContext({
+            agentContext: {
+                nasVolumes: [
+                    {
+                        realDir: "/data/touqian/CP202205250005/sequences/0000",
+                        dockerDir: "touqian/2026/08/biz-1/CP202205250005/sequences/0000",
+                        mode: "ro",
+                    },
+                ],
+                background: "案件资料处理",
+            },
+        });
+        assert.ok(ctx);
+        assert.equal(ctx.localRoot, undefined);
+        assert.equal(ctx.nasVolumes?.[0]?.mode, "ro");
+    });
+    it("accepts optional sync and include on nasVolumes", () => {
+        const ctx = parseRobotMentionAgentContext({
+            agentContext: {
+                nasVolumes: [
+                    {
+                        realDir: "/data/touqian/a",
+                        dockerDir: "case/a",
+                        mode: "ro",
+                        sync: "pull",
+                        include: "*.md,*.html",
+                    },
+                ],
+            },
+        });
+        assert.equal(ctx?.nasVolumes?.[0]?.sync, "pull");
+        assert.equal(ctx?.nasVolumes?.[0]?.include, "*.md,*.html");
+    });
+    it("treats an empty nasVolumes array exactly like an omitted field when localRoot exists", () => {
+        const withoutNas = parseRobotMentionAgentContext({
+            agentContext: { localRoot: { kind: "workspace_relative", path: "data/a" } },
+        });
+        const emptyNas = parseRobotMentionAgentContext({
+            agentContext: {
+                localRoot: { kind: "workspace_relative", path: "data/a" },
+                nasVolumes: [],
+            },
+        });
+        assert.deepEqual(emptyNas, withoutNas);
+        assert.equal(emptyNas?.nasVolumes, undefined);
+    });
+    it("ignores an invalid nasVolumes item without blocking valid items", () => {
+        const result = parseRobotMentionAgentContextDetailed({
+            agentContext: {
+                nasVolumes: [
+                    { realDir: "/data/touqian/a", dockerDir: "case/a", mode: "write" },
+                    { realDir: "/data/touqian/b", dockerDir: "case/b", mode: "rw" },
+                ],
+            },
+        });
+        assert.equal(result.agentContext?.nasVolumes?.length, 1);
+        assert.equal(result.agentContext?.nasVolumes?.[0]?.dockerDir, "case/b");
+        assert.ok(result.fatalError?.includes("mode"));
+    });
+    it("ignores an entirely invalid nasVolumes declaration and leaves the message unblocked", () => {
+        const result = parseRobotMentionAgentContextDetailed({
+            agentContext: {
+                nasVolumes: [{ realDir: "/data/touqian/a", dockerDir: "case/a", mode: "write" }],
+                background: "must not make the context fatal",
+            },
+        });
+        assert.equal(result.agentContext, undefined);
+        assert.ok(result.fatalError?.includes("mode"));
+    });
+    it("ignores oversized NAS paths so cached strings have a fixed upper bound", () => {
+        const result = parseRobotMentionAgentContextDetailed({
+            agentContext: {
+                nasVolumes: [{ realDir: `/${"a".repeat(1024)}`, dockerDir: "case/a", mode: "ro" }],
+            },
+        });
+        assert.equal(result.agentContext, undefined);
+        assert.ok(result.fatalError?.includes("realDir"));
+    });
+    it("drops invalid knowledgeBase but keeps localRoot and background", () => {
+        const result = parseRobotMentionAgentContextDetailed({
+            agentContext: {
+                localRoot: { kind: "workspace_relative", path: "data/a" },
+                knowledgeBase: { rootFileId: "" },
+                background: "项目说明",
+            },
+        });
+        assert.ok(result.agentContext);
+        assert.equal(result.agentContext.background, "项目说明");
+        assert.equal(result.agentContext.knowledgeBase, undefined);
+        assert.equal(result.knowledgeBaseDropped, true);
+    });
+});
+//# sourceMappingURL=agent-context-types.test.js.map

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

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

package/dist/src/session/auto-model-router.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Auto Router：本地确定性路由，纯函数、带版本号。
+ * 只分析当前用户原始请求与附件元数据，不拼接系统上下文/历史记录/附件正文。
+ * 不因文本长度单独升级、不因存在附件单独升级；`max` 必须有明确规则命中。
+ */
+export declare const AUTO_ROUTER_VERSION = "v1";
+export type AutoThinkingLevel = "low" | "medium" | "high" | "xhigh" | "max";
+export type AutoRouteTier = "simple" | "standard" | "complex" | "critical";
+export type AutoRouteReason = "explicit_quality_first" | "complex_reasoning" | "simple_task" | "general_task";
+export interface AutoRouteResult {
+    model: string;
+    thinking: AutoThinkingLevel;
+    tier: AutoRouteTier;
+    reason: AutoRouteReason;
+    version: string;
+}
+export interface AutoRouteInput {
+    query: string;
+    attachmentKinds: string[];
+    attachmentFormats: string[];
+    agentId: string;
+}
+/** Auto Router 只能输出这四个模型槽位（Feature Flag 配置）。 */
+export interface AutoModelRoutingSlots {
+    simpleModel: string;
+    standardModel: string;
+    complexModel: string;
+    criticalModel: string;
+}
+export declare function resolveAutoModelRoute(input: AutoRouteInput, slots: AutoModelRoutingSlots): AutoRouteResult;
+/**
+ * 指定模型模式下的模型默认推理等级：从 `autoModelRouting.thinkingDefaults` 读取。
+ * 未配置或未命中时返回 undefined（由 OpenClaw 自行解析该模型默认配置）。
+ */
+export declare function resolveModelThinkingDefault(thinkingDefaults: Record<string, string> | undefined, modelRef: string): string | undefined;
+//# sourceMappingURL=auto-model-router.d.ts.map

package/dist/src/session/auto-model-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-model-router.d.ts","sourceRoot":"","sources":["../../../src/session/auto-model-router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE5E,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAE3E,MAAM,MAAM,eAAe,GACrB,wBAAwB,GACxB,mBAAmB,GACnB,aAAa,GACb,cAAc,CAAC;AAErB,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,qBAAqB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB;AAcD,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,qBAAqB,GAC7B,eAAe,CAwCjB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACvC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACpD,QAAQ,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAKpB"}

package/dist/src/session/auto-model-router.js

@@ -0,0 +1,60 @@
+/**
+ * Auto Router：本地确定性路由，纯函数、带版本号。
+ * 只分析当前用户原始请求与附件元数据，不拼接系统上下文/历史记录/附件正文。
+ * 不因文本长度单独升级、不因存在附件单独升级；`max` 必须有明确规则命中。
+ */
+export const AUTO_ROUTER_VERSION = "v1";
+const SIMPLE_PATTERNS = /翻译|润色|改写|格式调整|提取字段|生成标题|简短总结/;
+const COMPLEX_PATTERNS = /架构设计|根因分析|安全分析|漏洞|跨系统|复杂重构|迁移方案|性能瓶颈/;
+const CRITICAL_PATTERNS = /全面审计|穷尽分析|逐项验证|最高质量|不要遗漏任何|关键生产事故/;
+/** 简单任务仅当文本长度可控时路由到 simple，避免长文档误判为轻任务。 */
+const SIMPLE_QUERY_MAX_LENGTH = 500;
+export function resolveAutoModelRoute(input, slots) {
+    const query = input.query.trim();
+    if (CRITICAL_PATTERNS.test(query)) {
+        return {
+            model: slots.criticalModel,
+            thinking: "max",
+            tier: "critical",
+            reason: "explicit_quality_first",
+            version: AUTO_ROUTER_VERSION,
+        };
+    }
+    if (COMPLEX_PATTERNS.test(query)) {
+        return {
+            model: slots.complexModel,
+            thinking: "high",
+            tier: "complex",
+            reason: "complex_reasoning",
+            version: AUTO_ROUTER_VERSION,
+        };
+    }
+    if (query.length <= SIMPLE_QUERY_MAX_LENGTH && SIMPLE_PATTERNS.test(query)) {
+        return {
+            model: slots.simpleModel,
+            thinking: "low",
+            tier: "simple",
+            reason: "simple_task",
+            version: AUTO_ROUTER_VERSION,
+        };
+    }
+    return {
+        model: slots.standardModel,
+        thinking: "medium",
+        tier: "standard",
+        reason: "general_task",
+        version: AUTO_ROUTER_VERSION,
+    };
+}
+/**
+ * 指定模型模式下的模型默认推理等级：从 `autoModelRouting.thinkingDefaults` 读取。
+ * 未配置或未命中时返回 undefined（由 OpenClaw 自行解析该模型默认配置）。
+ */
+export function resolveModelThinkingDefault(thinkingDefaults, modelRef) {
+    const ref = modelRef.trim();
+    if (!ref || !thinkingDefaults)
+        return undefined;
+    const value = thinkingDefaults[ref];
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+//# sourceMappingURL=auto-model-router.js.map

package/dist/src/session/auto-model-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-model-router.js","sourceRoot":"","sources":["../../../src/session/auto-model-router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAmCxC,MAAM,eAAe,GACjB,8BAA8B,CAAC;AAEnC,MAAM,gBAAgB,GAClB,sCAAsC,CAAC;AAE3C,MAAM,iBAAiB,GACnB,mCAAmC,CAAC;AAExC,2CAA2C;AAC3C,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,MAAM,UAAU,qBAAqB,CACjC,KAAqB,EACrB,KAA4B;IAE5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAEjC,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO;YACH,KAAK,EAAE,KAAK,CAAC,aAAa;YAC1B,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,wBAAwB;YAChC,OAAO,EAAE,mBAAmB;SAC/B,CAAC;IACN,CAAC;IAED,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACH,KAAK,EAAE,KAAK,CAAC,YAAY;YACzB,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,mBAAmB;YAC3B,OAAO,EAAE,mBAAmB;SAC/B,CAAC;IACN,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,IAAI,uBAAuB,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO;YACH,KAAK,EAAE,KAAK,CAAC,WAAW;YACxB,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,mBAAmB;SAC/B,CAAC;IACN,CAAC;IAED,OAAO;QACH,KAAK,EAAE,KAAK,CAAC,aAAa;QAC1B,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,mBAAmB;KAC/B,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACvC,gBAAoD,EACpD,QAAgB;IAEhB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,IAAI,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC"}