@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/agents/IndexAgent.js

@@ -0,0 +1,417 @@
+"use strict";
+/**
+ * IndexAgent - 多层级文档索引 Agent
+ *
+ * 职责：为文件生成摘要和 embedding，使其可检索。
+ *
+ * 支持三个索引层级：
+ * - L0：摘要级别，1-3句话描述文件
+ * - L1：目录级别，提取主要标题和结构
+ * - L2：全文级别，完整分块和向量化
+ *
+ * @see docs/indexing-agent.md 完整设计文档
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexAgent = exports.IndexAgent = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const CodeBuddyExecutor_1 = require("./CodeBuddyExecutor");
+/**
+ * L0 索引 System Prompt
+ */
+const L0_SYSTEM_PROMPT = `你是 IndexAgent，负责 L0 文档索引，帮助用户的 Pod 中的文件变得可检索。
+
+## 任务
+
+为文件生成简短摘要和 embedding，使其可通过语义搜索被找到。
+
+## L0 索引标准
+
+| 项目 | 说明 |
+|------|------|
+| 内容 | 文件的简短描述（1-3句话） |
+| 来源 | 文件名、类型、前几行内容 |
+| 产物 | 描述文本 + embedding |
+| 成本 | 最低 |
+
+## 处理流程
+
+1. **读取文件信息**：类型、大小、文件名
+2. **获取内容预览**：
+   - 文本文件：读取前 500 字符
+   - 其他类型：根据文件名和类型推断
+3. **生成摘要**：1-3句话描述文件内容和用途
+4. **生成 embedding**：调用 Embedding API
+5. **更新状态**：写入 .meta 记录索引完成
+
+## 存储规范
+
+索引状态存储在资源的 .meta 辅助资源：
+
+\`\`\`turtle
+</docs/report.pdf> 
+    udfs:indexLevel "L0" ;
+    udfs:lastIndexedAt "2026-01-09T10:00:00Z"^^xsd:dateTime ;
+    udfs:summary "2024年度财务报告，包含收入、支出、利润分析" ;
+    udfs:vectorId 12345 .
+\`\`\`
+
+## 可用工具
+
+- **Read**：读取 Pod 中的文件
+- **Write**：写入文件到 Pod
+- **Bash**：执行命令（如需要）
+
+## 输出格式
+
+完成后返回 JSON：
+{
+  "success": true,
+  "indexLevel": "L0",
+  "summary": "文件摘要...",
+  "vectorId": 12345
+}
+
+如果文件不需要索引或出错：
+{
+  "success": false,
+  "reason": "说明原因"
+}
+`;
+/**
+ * L1 索引 System Prompt - 目录级别
+ */
+const L1_SYSTEM_PROMPT = `你是 IndexAgent，负责 L1 文档索引（目录级别），帮助用户的 Pod 中的文件变得可检索。
+
+## 任务
+
+提取文件的目录结构和主要标题，为每个主要部分生成描述和 embedding。
+
+## L1 索引标准
+
+| 项目 | 说明 |
+|------|------|
+| 内容 | 目录结构，主要标题的描述 |
+| 来源 | PDF/Word：提取 TOC；Markdown：扫描标题行 |
+| 产物 | 主要标题 chunks + embeddings |
+| 成本 | 低 |
+
+## 处理流程
+
+1. **读取文件**：获取完整内容
+2. **提取目录结构**：
+   - Markdown：提取 # 和 ## 标题
+   - 其他格式：尝试识别结构
+3. **生成标题描述**：为每个主要标题生成简短描述
+4. **生成 embeddings**：为每个标题 chunk 生成向量
+5. **更新状态**：写入 .meta 记录索引完成
+
+## 存储规范
+
+\`\`\`turtle
+</docs/report.pdf> 
+    udfs:indexLevel "L1" ;
+    udfs:lastIndexedAt "2026-01-09T10:00:00Z"^^xsd:dateTime ;
+    udfs:hasChunk </docs/report.pdf#chunk-1> ;
+    udfs:hasChunk </docs/report.pdf#chunk-2> .
+
+</docs/report.pdf#chunk-1> a udfs:TextChunk ;
+    udfs:level 1 ;
+    udfs:heading "Introduction" ;
+    udfs:summary "介绍部分的简要描述" ;
+    udfs:vectorId 12345 .
+\`\`\`
+
+## 输出格式
+
+{
+  "success": true,
+  "indexLevel": "L1",
+  "chunks": [
+    {"heading": "Introduction", "level": 1, "summary": "..."},
+    {"heading": "Background", "level": 2, "summary": "..."}
+  ],
+  "chunkCount": 5
+}
+`;
+/**
+ * L2 索引 System Prompt - 全文级别
+ */
+const L2_SYSTEM_PROMPT = `你是 IndexAgent，负责 L2 文档索引（全文级别），帮助用户的 Pod 中的文件变得可检索。
+
+## 任务
+
+对文件进行全文分块，为每个内容块生成描述和 embedding，实现深度语义检索。
+
+## L2 索引标准
+
+| 项目 | 说明 |
+|------|------|
+| 内容 | 全文分块（所有标题层级） |
+| 前置 | 需要完整 parse |
+| 产物 | 所有 chunks + embeddings |
+| 成本 | 高 |
+
+## 处理流程
+
+1. **读取完整文件**：获取全部内容
+2. **解析文档结构**：识别所有层级的标题和段落
+3. **智能分块**：
+   - 按标题层级分割（H1, H2, H3...）
+   - 保持语义完整性
+   - 每块控制在 500-2000 字符
+4. **生成 embeddings**：为每个 chunk 生成向量
+5. **建立 chunk 关系**：记录父子关系
+6. **更新状态**：写入 .meta 记录索引完成
+
+## 分块策略
+
+对于 Markdown 文件：
+\`\`\`python
+# 按标题层级分割
+headers = ["#", "##", "###", "####"]
+# 每个标题下的内容作为一个 chunk
+# 保留父子关系
+\`\`\`
+
+## 存储规范
+
+\`\`\`turtle
+</docs/report.pdf> 
+    udfs:indexLevel "L2" ;
+    udfs:lastIndexedAt "2026-01-09T10:00:00Z"^^xsd:dateTime ;
+    udfs:hasChunk </docs/report.pdf#chunk-1> ;
+    udfs:hasChunk </docs/report.pdf#chunk-2> ;
+    udfs:hasChunk </docs/report.pdf#chunk-3> .
+
+# chunk 父子关系
+</docs/report.pdf#chunk-2> udfs:parentChunk </docs/report.pdf#chunk-1> .
+</docs/report.pdf#chunk-3> udfs:parentChunk </docs/report.pdf#chunk-1> .
+
+# chunk 实体
+</docs/report.pdf#chunk-1> a udfs:TextChunk ;
+    udfs:level 1 ;
+    udfs:heading "Introduction" ;
+    udfs:content "This document describes..." ;
+    udfs:startOffset 0 ;
+    udfs:endOffset 256 ;
+    udfs:vectorId 12345 .
+
+</docs/report.pdf#chunk-2> a udfs:TextChunk ;
+    udfs:level 2 ;
+    udfs:heading "Background" ;
+    udfs:content "The background of this project..." ;
+    udfs:startOffset 257 ;
+    udfs:endOffset 512 ;
+    udfs:vectorId 12346 .
+\`\`\`
+
+## 可用工具
+
+- **Read**：读取 Pod 中的文件
+- **Write**：写入文件到 Pod
+- **Bash**：执行命令（如需要）
+
+## 输出格式
+
+{
+  "success": true,
+  "indexLevel": "L2",
+  "chunks": [
+    {
+      "id": "chunk-1",
+      "heading": "Introduction",
+      "level": 1,
+      "content": "摘要或前100字...",
+      "vectorId": 12345
+    },
+    {
+      "id": "chunk-2", 
+      "heading": "Background",
+      "level": 2,
+      "parent": "chunk-1",
+      "content": "摘要或前100字...",
+      "vectorId": 12346
+    }
+  ],
+  "chunkCount": 15,
+  "totalCharacters": 8500
+}
+
+如果失败：
+{
+  "success": false,
+  "reason": "说明原因"
+}
+`;
+/**
+ * 获取指定层级的 System Prompt
+ */
+function getSystemPrompt(level) {
+    switch (level) {
+        case 'L0':
+            return L0_SYSTEM_PROMPT;
+        case 'L1':
+            return L1_SYSTEM_PROMPT;
+        case 'L2':
+            return L2_SYSTEM_PROMPT;
+        default:
+            return L0_SYSTEM_PROMPT;
+    }
+}
+/**
+ * IndexAgent 实现
+ *
+ * 通过 CodeBuddy SDK 执行，支持 L0/L1/L2 三个索引层级。
+ */
+class IndexAgent {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.executor = new CodeBuddyExecutor_1.CodeBuddyExecutor();
+        this.name = 'indexing';
+        this.description = '文档索引 Agent，帮助用户的文件变得可检索';
+        this.defaultLevel = options?.level ?? 'L0';
+    }
+    /**
+     * Agent 配置
+     *
+     * 根据索引层级配置不同的 system prompt 和参数
+     */
+    getConfig(level, _context) {
+        // 根据层级调整 maxTurns
+        const maxTurns = level === 'L0' ? 10 : level === 'L1' ? 15 : 20;
+        return {
+            name: `${this.name}-${level}`,
+            description: `${this.description} (${level})`,
+            systemPrompt: getSystemPrompt(level),
+            // L0/L1 不需要额外的 MCP 服务器
+            // L2 可能需要 JINA 等，但由 CodeBuddyExecutor 根据 context 注入
+            mcpServers: {},
+            // 使用 GLM-4.7 模型
+            model: 'glm-4.7',
+            maxTurns,
+            // 接受编辑模式
+            permissionMode: 'acceptEdits',
+        };
+    }
+    /**
+     * 从消息中解析索引层级
+     */
+    parseLevel(message) {
+        const lowerMessage = message.toLowerCase();
+        if (lowerMessage.includes('l2') || lowerMessage.includes('全文') || lowerMessage.includes('深度')) {
+            return 'L2';
+        }
+        if (lowerMessage.includes('l1') || lowerMessage.includes('目录') || lowerMessage.includes('结构')) {
+            return 'L1';
+        }
+        if (lowerMessage.includes('l0') || lowerMessage.includes('摘要') || lowerMessage.includes('简要')) {
+            return 'L0';
+        }
+        return this.defaultLevel;
+    }
+    /**
+     * 转换 usage 格式（ExecuteResult -> AgentResult）
+     */
+    convertUsage(usage) {
+        if (!usage)
+            return undefined;
+        return {
+            inputTokens: usage.promptTokens,
+            outputTokens: usage.completionTokens,
+            cost: 0, // CodeBuddy SDK 不返回 cost
+            turns: 0, // CodeBuddy SDK 不返回 turns
+            durationMs: usage.durationMs,
+        };
+    }
+    /**
+     * 执行任务
+     *
+     * @param message 任务消息，可包含层级指示（如 "L2 索引"、"深度索引"、"全文索引"）
+     * @param context Agent 上下文
+     */
+    async execute(message, context) {
+        const level = this.parseLevel(message);
+        context.log.info(`IndexAgent (${level}) received: ${message}`);
+        try {
+            const config = this.getConfig(level, context);
+            // 通过 CodeBuddy SDK 执行
+            const result = await this.executor.executeAndWaitWithConfig(config, message, {
+                podBaseUrl: context.podBaseUrl,
+                accessToken: context.accessToken,
+                timeout: level === 'L2' ? 600000 : 300000, // L2 给 10 分钟，其他 5 分钟
+            });
+            if (result.success) {
+                context.log.info(`IndexAgent (${level}) completed: ${result.result}`);
+                return {
+                    success: true,
+                    data: result.structuredOutput ?? result.result,
+                    usage: this.convertUsage(result.usage),
+                };
+            }
+            else {
+                context.log.error(`IndexAgent (${level}) failed: ${result.error}`);
+                return {
+                    success: false,
+                    error: result.error,
+                    usage: this.convertUsage(result.usage),
+                };
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            context.log.error(`IndexAgent (${level}) error: ${errorMsg}`);
+            return {
+                success: false,
+                error: errorMsg,
+            };
+        }
+    }
+    /**
+     * 执行指定层级的索引
+     *
+     * @param level 索引层级
+     * @param message 任务消息
+     * @param context Agent 上下文
+     */
+    async executeWithLevel(level, message, context) {
+        context.log.info(`IndexAgent (${level}) received: ${message}`);
+        try {
+            const config = this.getConfig(level, context);
+            const result = await this.executor.executeAndWaitWithConfig(config, message, {
+                podBaseUrl: context.podBaseUrl,
+                accessToken: context.accessToken,
+                timeout: level === 'L2' ? 600000 : 300000,
+            });
+            if (result.success) {
+                context.log.info(`IndexAgent (${level}) completed: ${result.result}`);
+                return {
+                    success: true,
+                    data: result.structuredOutput ?? result.result,
+                    usage: this.convertUsage(result.usage),
+                };
+            }
+            else {
+                context.log.error(`IndexAgent (${level}) failed: ${result.error}`);
+                return {
+                    success: false,
+                    error: result.error,
+                    usage: this.convertUsage(result.usage),
+                };
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            context.log.error(`IndexAgent (${level}) error: ${errorMsg}`);
+            return {
+                success: false,
+                error: errorMsg,
+            };
+        }
+    }
+}
+exports.IndexAgent = IndexAgent;
+/**
+ * 默认 IndexAgent 实例
+ */
+exports.indexAgent = new IndexAgent();
+//# sourceMappingURL=IndexAgent.js.map

package/dist/agents/IndexAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexAgent.js","sourceRoot":"","sources":["../../src/agents/IndexAgent.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * IndexAgent - 多层级文档索引 Agent\n *\n * 职责：为文件生成摘要和 embedding，使其可检索。\n *\n * 支持三个索引层级：\n * - L0：摘要级别，1-3句话描述文件\n * - L1：目录级别，提取主要标题和结构\n * - L2：全文级别，完整分块和向量化\n *\n * @see docs/indexing-agent.md 完整设计文档\n */\n\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { Agent, AgentContext, AgentResult } from '../task/types';\nimport { CodeBuddyExecutor } from './CodeBuddyExecutor';\nimport type { CodeBuddyConfig } from './types';\n\n/**\n * 索引层级类型\n */\nexport type IndexLevel = 'L0' | 'L1' | 'L2';\n\n/**\n * L0 索引 System Prompt\n */\nconst L0_SYSTEM_PROMPT = `你是 IndexAgent，负责 L0 文档索引，帮助用户的 Pod 中的文件变得可检索。\n\n## 任务\n\n为文件生成简短摘要和 embedding，使其可通过语义搜索被找到。\n\n## L0 索引标准\n\n| 项目 | 说明 |\n|------|------|\n| 内容 | 文件的简短描述（1-3句话） |\n| 来源 | 文件名、类型、前几行内容 |\n| 产物 | 描述文本 + embedding |\n| 成本 | 最低 |\n\n## 处理流程\n\n1. **读取文件信息**：类型、大小、文件名\n2. **获取内容预览**：\n   - 文本文件：读取前 500 字符\n   - 其他类型：根据文件名和类型推断\n3. **生成摘要**：1-3句话描述文件内容和用途\n4. **生成 embedding**：调用 Embedding API\n5. **更新状态**：写入 .meta 记录索引完成\n\n## 存储规范\n\n索引状态存储在资源的 .meta 辅助资源：\n\n\\`\\`\\`turtle\n</docs/report.pdf> \n    udfs:indexLevel \"L0\" ;\n    udfs:lastIndexedAt \"2026-01-09T10:00:00Z\"^^xsd:dateTime ;\n    udfs:summary \"2024年度财务报告，包含收入、支出、利润分析\" ;\n    udfs:vectorId 12345 .\n\\`\\`\\`\n\n## 可用工具\n\n- **Read**：读取 Pod 中的文件\n- **Write**：写入文件到 Pod\n- **Bash**：执行命令（如需要）\n\n## 输出格式\n\n完成后返回 JSON：\n{\n  \"success\": true,\n  \"indexLevel\": \"L0\",\n  \"summary\": \"文件摘要...\",\n  \"vectorId\": 12345\n}\n\n如果文件不需要索引或出错：\n{\n  \"success\": false,\n  \"reason\": \"说明原因\"\n}\n`;\n\n/**\n * L1 索引 System Prompt - 目录级别\n */\nconst L1_SYSTEM_PROMPT = `你是 IndexAgent，负责 L1 文档索引（目录级别），帮助用户的 Pod 中的文件变得可检索。\n\n## 任务\n\n提取文件的目录结构和主要标题，为每个主要部分生成描述和 embedding。\n\n## L1 索引标准\n\n| 项目 | 说明 |\n|------|------|\n| 内容 | 目录结构，主要标题的描述 |\n| 来源 | PDF/Word：提取 TOC；Markdown：扫描标题行 |\n| 产物 | 主要标题 chunks + embeddings |\n| 成本 | 低 |\n\n## 处理流程\n\n1. **读取文件**：获取完整内容\n2. **提取目录结构**：\n   - Markdown：提取 # 和 ## 标题\n   - 其他格式：尝试识别结构\n3. **生成标题描述**：为每个主要标题生成简短描述\n4. **生成 embeddings**：为每个标题 chunk 生成向量\n5. **更新状态**：写入 .meta 记录索引完成\n\n## 存储规范\n\n\\`\\`\\`turtle\n</docs/report.pdf> \n    udfs:indexLevel \"L1\" ;\n    udfs:lastIndexedAt \"2026-01-09T10:00:00Z\"^^xsd:dateTime ;\n    udfs:hasChunk </docs/report.pdf#chunk-1> ;\n    udfs:hasChunk </docs/report.pdf#chunk-2> .\n\n</docs/report.pdf#chunk-1> a udfs:TextChunk ;\n    udfs:level 1 ;\n    udfs:heading \"Introduction\" ;\n    udfs:summary \"介绍部分的简要描述\" ;\n    udfs:vectorId 12345 .\n\\`\\`\\`\n\n## 输出格式\n\n{\n  \"success\": true,\n  \"indexLevel\": \"L1\",\n  \"chunks\": [\n    {\"heading\": \"Introduction\", \"level\": 1, \"summary\": \"...\"},\n    {\"heading\": \"Background\", \"level\": 2, \"summary\": \"...\"}\n  ],\n  \"chunkCount\": 5\n}\n`;\n\n/**\n * L2 索引 System Prompt - 全文级别\n */\nconst L2_SYSTEM_PROMPT = `你是 IndexAgent，负责 L2 文档索引（全文级别），帮助用户的 Pod 中的文件变得可检索。\n\n## 任务\n\n对文件进行全文分块，为每个内容块生成描述和 embedding，实现深度语义检索。\n\n## L2 索引标准\n\n| 项目 | 说明 |\n|------|------|\n| 内容 | 全文分块（所有标题层级） |\n| 前置 | 需要完整 parse |\n| 产物 | 所有 chunks + embeddings |\n| 成本 | 高 |\n\n## 处理流程\n\n1. **读取完整文件**：获取全部内容\n2. **解析文档结构**：识别所有层级的标题和段落\n3. **智能分块**：\n   - 按标题层级分割（H1, H2, H3...）\n   - 保持语义完整性\n   - 每块控制在 500-2000 字符\n4. **生成 embeddings**：为每个 chunk 生成向量\n5. **建立 chunk 关系**：记录父子关系\n6. **更新状态**：写入 .meta 记录索引完成\n\n## 分块策略\n\n对于 Markdown 文件：\n\\`\\`\\`python\n# 按标题层级分割\nheaders = [\"#\", \"##\", \"###\", \"####\"]\n# 每个标题下的内容作为一个 chunk\n# 保留父子关系\n\\`\\`\\`\n\n## 存储规范\n\n\\`\\`\\`turtle\n</docs/report.pdf> \n    udfs:indexLevel \"L2\" ;\n    udfs:lastIndexedAt \"2026-01-09T10:00:00Z\"^^xsd:dateTime ;\n    udfs:hasChunk </docs/report.pdf#chunk-1> ;\n    udfs:hasChunk </docs/report.pdf#chunk-2> ;\n    udfs:hasChunk </docs/report.pdf#chunk-3> .\n\n# chunk 父子关系\n</docs/report.pdf#chunk-2> udfs:parentChunk </docs/report.pdf#chunk-1> .\n</docs/report.pdf#chunk-3> udfs:parentChunk </docs/report.pdf#chunk-1> .\n\n# chunk 实体\n</docs/report.pdf#chunk-1> a udfs:TextChunk ;\n    udfs:level 1 ;\n    udfs:heading \"Introduction\" ;\n    udfs:content \"This document describes...\" ;\n    udfs:startOffset 0 ;\n    udfs:endOffset 256 ;\n    udfs:vectorId 12345 .\n\n</docs/report.pdf#chunk-2> a udfs:TextChunk ;\n    udfs:level 2 ;\n    udfs:heading \"Background\" ;\n    udfs:content \"The background of this project...\" ;\n    udfs:startOffset 257 ;\n    udfs:endOffset 512 ;\n    udfs:vectorId 12346 .\n\\`\\`\\`\n\n## 可用工具\n\n- **Read**：读取 Pod 中的文件\n- **Write**：写入文件到 Pod\n- **Bash**：执行命令（如需要）\n\n## 输出格式\n\n{\n  \"success\": true,\n  \"indexLevel\": \"L2\",\n  \"chunks\": [\n    {\n      \"id\": \"chunk-1\",\n      \"heading\": \"Introduction\",\n      \"level\": 1,\n      \"content\": \"摘要或前100字...\",\n      \"vectorId\": 12345\n    },\n    {\n      \"id\": \"chunk-2\", \n      \"heading\": \"Background\",\n      \"level\": 2,\n      \"parent\": \"chunk-1\",\n      \"content\": \"摘要或前100字...\",\n      \"vectorId\": 12346\n    }\n  ],\n  \"chunkCount\": 15,\n  \"totalCharacters\": 8500\n}\n\n如果失败：\n{\n  \"success\": false,\n  \"reason\": \"说明原因\"\n}\n`;\n\n/**\n * 获取指定层级的 System Prompt\n */\nfunction getSystemPrompt(level: IndexLevel): string {\n  switch (level) {\n    case 'L0':\n      return L0_SYSTEM_PROMPT;\n    case 'L1':\n      return L1_SYSTEM_PROMPT;\n    case 'L2':\n      return L2_SYSTEM_PROMPT;\n    default:\n      return L0_SYSTEM_PROMPT;\n  }\n}\n\n/**\n * IndexAgent 配置选项\n */\nexport interface IndexAgentOptions {\n  /** 索引层级，默认 L0 */\n  level?: IndexLevel;\n}\n\n/**\n * IndexAgent 实现\n *\n * 通过 CodeBuddy SDK 执行，支持 L0/L1/L2 三个索引层级。\n */\nexport class IndexAgent implements Agent {\n  private readonly logger = getLoggerFor(this);\n  private readonly executor = new CodeBuddyExecutor();\n  private readonly defaultLevel: IndexLevel;\n\n  public readonly name = 'indexing';\n  public readonly description = '文档索引 Agent，帮助用户的文件变得可检索';\n\n  constructor(options?: IndexAgentOptions) {\n    this.defaultLevel = options?.level ?? 'L0';\n  }\n\n  /**\n   * Agent 配置\n   *\n   * 根据索引层级配置不同的 system prompt 和参数\n   */\n  private getConfig(level: IndexLevel, _context: AgentContext): CodeBuddyConfig {\n    // 根据层级调整 maxTurns\n    const maxTurns = level === 'L0' ? 10 : level === 'L1' ? 15 : 20;\n\n    return {\n      name: `${this.name}-${level}`,\n      description: `${this.description} (${level})`,\n      systemPrompt: getSystemPrompt(level),\n      // L0/L1 不需要额外的 MCP 服务器\n      // L2 可能需要 JINA 等，但由 CodeBuddyExecutor 根据 context 注入\n      mcpServers: {},\n      // 使用 GLM-4.7 模型\n      model: 'glm-4.7',\n      maxTurns,\n      // 接受编辑模式\n      permissionMode: 'acceptEdits',\n    };\n  }\n\n  /**\n   * 从消息中解析索引层级\n   */\n  private parseLevel(message: string): IndexLevel {\n    const lowerMessage = message.toLowerCase();\n    if (lowerMessage.includes('l2') || lowerMessage.includes('全文') || lowerMessage.includes('深度')) {\n      return 'L2';\n    }\n    if (lowerMessage.includes('l1') || lowerMessage.includes('目录') || lowerMessage.includes('结构')) {\n      return 'L1';\n    }\n    if (lowerMessage.includes('l0') || lowerMessage.includes('摘要') || lowerMessage.includes('简要')) {\n      return 'L0';\n    }\n    return this.defaultLevel;\n  }\n\n  /**\n   * 转换 usage 格式（ExecuteResult -> AgentResult）\n   */\n  private convertUsage(usage?: {\n    promptTokens: number;\n    completionTokens: number;\n    totalTokens: number;\n    durationMs: number;\n  }): { inputTokens: number; outputTokens: number; cost: number; turns: number; durationMs: number } | undefined {\n    if (!usage) return undefined;\n    return {\n      inputTokens: usage.promptTokens,\n      outputTokens: usage.completionTokens,\n      cost: 0, // CodeBuddy SDK 不返回 cost\n      turns: 0, // CodeBuddy SDK 不返回 turns\n      durationMs: usage.durationMs,\n    };\n  }\n\n  /**\n   * 执行任务\n   *\n   * @param message 任务消息，可包含层级指示（如 \"L2 索引\"、\"深度索引\"、\"全文索引\"）\n   * @param context Agent 上下文\n   */\n  public async execute(message: string, context: AgentContext): Promise<AgentResult> {\n    const level = this.parseLevel(message);\n    context.log.info(`IndexAgent (${level}) received: ${message}`);\n\n    try {\n      const config = this.getConfig(level, context);\n\n      // 通过 CodeBuddy SDK 执行\n      const result = await this.executor.executeAndWaitWithConfig(config, message, {\n        podBaseUrl: context.podBaseUrl,\n        accessToken: context.accessToken,\n        timeout: level === 'L2' ? 600000 : 300000, // L2 给 10 分钟，其他 5 分钟\n      });\n\n      if (result.success) {\n        context.log.info(`IndexAgent (${level}) completed: ${result.result}`);\n        return {\n          success: true,\n          data: result.structuredOutput ?? result.result,\n          usage: this.convertUsage(result.usage),\n        };\n      } else {\n        context.log.error(`IndexAgent (${level}) failed: ${result.error}`);\n        return {\n          success: false,\n          error: result.error,\n          usage: this.convertUsage(result.usage),\n        };\n      }\n    } catch (error) {\n      const errorMsg = error instanceof Error ? error.message : String(error);\n      context.log.error(`IndexAgent (${level}) error: ${errorMsg}`);\n      return {\n        success: false,\n        error: errorMsg,\n      };\n    }\n  }\n\n  /**\n   * 执行指定层级的索引\n   *\n   * @param level 索引层级\n   * @param message 任务消息\n   * @param context Agent 上下文\n   */\n  public async executeWithLevel(\n    level: IndexLevel,\n    message: string,\n    context: AgentContext,\n  ): Promise<AgentResult> {\n    context.log.info(`IndexAgent (${level}) received: ${message}`);\n\n    try {\n      const config = this.getConfig(level, context);\n\n      const result = await this.executor.executeAndWaitWithConfig(config, message, {\n        podBaseUrl: context.podBaseUrl,\n        accessToken: context.accessToken,\n        timeout: level === 'L2' ? 600000 : 300000,\n      });\n\n      if (result.success) {\n        context.log.info(`IndexAgent (${level}) completed: ${result.result}`);\n        return {\n          success: true,\n          data: result.structuredOutput ?? result.result,\n          usage: this.convertUsage(result.usage),\n        };\n      } else {\n        context.log.error(`IndexAgent (${level}) failed: ${result.error}`);\n        return {\n          success: false,\n          error: result.error,\n          usage: this.convertUsage(result.usage),\n        };\n      }\n    } catch (error) {\n      const errorMsg = error instanceof Error ? error.message : String(error);\n      context.log.error(`IndexAgent (${level}) error: ${errorMsg}`);\n      return {\n        success: false,\n        error: errorMsg,\n      };\n    }\n  }\n}\n\n/**\n * 默认 IndexAgent 实例\n */\nexport const indexAgent = new IndexAgent();\n"]}

package/dist/agents/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agents 模块导出
+ *
+ * 统一的 AI Agent 执行框架。
+ *
+ * 支持的 AI 供应商（有完整 Agent SDK）：
+ * - CodeBuddy: @tencent-ai/agent-sdk
+ * - Claude: @anthropic-ai/claude-agent-sdk
+ *
+ * 所有执行器都实现 IAgentExecutor 接口，通过 AgentExecutorFactory 从 Pod 读取凭证创建。
+ */
+export type { ExecutorType, AuthType, AiCredential, ProviderConfig, AuthInfo, ExecutorConfig, ExecuteResult, ExecuteMessage, ChatMessage, IAgentExecutor, BaseExecutorOptions, CodeBuddyConfig, CodeBuddyOptions, } from './types';
+export { AgentExecutorFactory, agentExecutorFactory, SUPPORTED_EXECUTOR_TYPES } from './AgentExecutorFactory';
+export { CodeBuddyExecutor, CodeBuddyAuthError, createCodeBuddyExecutor } from './CodeBuddyExecutor';
+export { ClaudeExecutor, ClaudeAuthenticationError, createClaudeExecutor } from './ClaudeExecutor';
+export { BaseAgentExecutor } from './BaseAgentExecutor';
+export { AgentProvider, AgentProviderRelations, ExecutorType as ExecutorTypeEnum } from './schema/tables';
+export { AgentConfig as AgentConfigTable, AgentStatus } from './schema/agent-config';
+export { AgentManager, agentManager } from './AgentManager';
+export type { AgentInstance, AgentConfig } from './AgentManager';
+export { IndexAgent, indexAgent } from './IndexAgent';
+export type { IndexLevel, IndexAgentOptions } from './IndexAgent';

package/dist/agents/index.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Agents 模块导出
+ *
+ * 统一的 AI Agent 执行框架。
+ *
+ * 支持的 AI 供应商（有完整 Agent SDK）：
+ * - CodeBuddy: @tencent-ai/agent-sdk
+ * - Claude: @anthropic-ai/claude-agent-sdk
+ *
+ * 所有执行器都实现 IAgentExecutor 接口，通过 AgentExecutorFactory 从 Pod 读取凭证创建。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexAgent = exports.IndexAgent = exports.agentManager = exports.AgentManager = exports.AgentStatus = exports.AgentConfigTable = exports.ExecutorTypeEnum = exports.AgentProviderRelations = exports.AgentProvider = exports.BaseAgentExecutor = exports.createClaudeExecutor = exports.ClaudeAuthenticationError = exports.ClaudeExecutor = exports.createCodeBuddyExecutor = exports.CodeBuddyAuthError = exports.CodeBuddyExecutor = exports.SUPPORTED_EXECUTOR_TYPES = exports.agentExecutorFactory = exports.AgentExecutorFactory = void 0;
+// 执行器工厂
+var AgentExecutorFactory_1 = require("./AgentExecutorFactory");
+Object.defineProperty(exports, "AgentExecutorFactory", { enumerable: true, get: function () { return AgentExecutorFactory_1.AgentExecutorFactory; } });
+Object.defineProperty(exports, "agentExecutorFactory", { enumerable: true, get: function () { return AgentExecutorFactory_1.agentExecutorFactory; } });
+Object.defineProperty(exports, "SUPPORTED_EXECUTOR_TYPES", { enumerable: true, get: function () { return AgentExecutorFactory_1.SUPPORTED_EXECUTOR_TYPES; } });
+// 执行器实现（仅支持有完整 Agent SDK 的供应商）
+var CodeBuddyExecutor_1 = require("./CodeBuddyExecutor");
+Object.defineProperty(exports, "CodeBuddyExecutor", { enumerable: true, get: function () { return CodeBuddyExecutor_1.CodeBuddyExecutor; } });
+Object.defineProperty(exports, "CodeBuddyAuthError", { enumerable: true, get: function () { return CodeBuddyExecutor_1.CodeBuddyAuthError; } });
+Object.defineProperty(exports, "createCodeBuddyExecutor", { enumerable: true, get: function () { return CodeBuddyExecutor_1.createCodeBuddyExecutor; } });
+var ClaudeExecutor_1 = require("./ClaudeExecutor");
+Object.defineProperty(exports, "ClaudeExecutor", { enumerable: true, get: function () { return ClaudeExecutor_1.ClaudeExecutor; } });
+Object.defineProperty(exports, "ClaudeAuthenticationError", { enumerable: true, get: function () { return ClaudeExecutor_1.ClaudeAuthenticationError; } });
+Object.defineProperty(exports, "createClaudeExecutor", { enumerable: true, get: function () { return ClaudeExecutor_1.createClaudeExecutor; } });
+// 抽象基类
+var BaseAgentExecutor_1 = require("./BaseAgentExecutor");
+Object.defineProperty(exports, "BaseAgentExecutor", { enumerable: true, get: function () { return BaseAgentExecutor_1.BaseAgentExecutor; } });
+// Schema
+var tables_1 = require("./schema/tables");
+Object.defineProperty(exports, "AgentProvider", { enumerable: true, get: function () { return tables_1.AgentProvider; } });
+Object.defineProperty(exports, "AgentProviderRelations", { enumerable: true, get: function () { return tables_1.AgentProviderRelations; } });
+Object.defineProperty(exports, "ExecutorTypeEnum", { enumerable: true, get: function () { return tables_1.ExecutorType; } });
+var agent_config_1 = require("./schema/agent-config");
+Object.defineProperty(exports, "AgentConfigTable", { enumerable: true, get: function () { return agent_config_1.AgentConfig; } });
+Object.defineProperty(exports, "AgentStatus", { enumerable: true, get: function () { return agent_config_1.AgentStatus; } });
+// Agent Manager
+var AgentManager_1 = require("./AgentManager");
+Object.defineProperty(exports, "AgentManager", { enumerable: true, get: function () { return AgentManager_1.AgentManager; } });
+Object.defineProperty(exports, "agentManager", { enumerable: true, get: function () { return AgentManager_1.agentManager; } });
+// IndexAgent
+var IndexAgent_1 = require("./IndexAgent");
+Object.defineProperty(exports, "IndexAgent", { enumerable: true, get: function () { return IndexAgent_1.IndexAgent; } });
+Object.defineProperty(exports, "indexAgent", { enumerable: true, get: function () { return IndexAgent_1.indexAgent; } });
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAmBH,QAAQ;AACR,+DAA8G;AAArG,4HAAA,oBAAoB,OAAA;AAAE,4HAAA,oBAAoB,OAAA;AAAE,gIAAA,wBAAwB,OAAA;AAE7E,+BAA+B;AAC/B,yDAAqG;AAA5F,sHAAA,iBAAiB,OAAA;AAAE,uHAAA,kBAAkB,OAAA;AAAE,4HAAA,uBAAuB,OAAA;AACvE,mDAAmG;AAA1F,gHAAA,cAAc,OAAA;AAAE,2HAAA,yBAAyB,OAAA;AAAE,sHAAA,oBAAoB,OAAA;AAExE,OAAO;AACP,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,SAAS;AACT,0CAA0G;AAAjG,uGAAA,aAAa,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAAE,0GAAA,YAAY,OAAoB;AAChF,sDAAqF;AAA5E,gHAAA,WAAW,OAAoB;AAAE,2GAAA,WAAW,OAAA;AAErD,gBAAgB;AAChB,+CAA4D;AAAnD,4GAAA,YAAY,OAAA;AAAE,4GAAA,YAAY,OAAA;AAGnC,aAAa;AACb,2CAAsD;AAA7C,wGAAA,UAAU,OAAA;AAAE,wGAAA,UAAU,OAAA","sourcesContent":["/**\n * Agents 模块导出\n *\n * 统一的 AI Agent 执行框架。\n *\n * 支持的 AI 供应商（有完整 Agent SDK）：\n * - CodeBuddy: @tencent-ai/agent-sdk\n * - Claude: @anthropic-ai/claude-agent-sdk\n *\n * 所有执行器都实现 IAgentExecutor 接口，通过 AgentExecutorFactory 从 Pod 读取凭证创建。\n */\n\n// 类型定义\nexport type {\n  ExecutorType,\n  AuthType,\n  AiCredential,\n  ProviderConfig,\n  AuthInfo,\n  ExecutorConfig,\n  ExecuteResult,\n  ExecuteMessage,\n  ChatMessage,\n  IAgentExecutor,\n  BaseExecutorOptions,\n  CodeBuddyConfig,\n  CodeBuddyOptions,\n} from './types';\n\n// 执行器工厂\nexport { AgentExecutorFactory, agentExecutorFactory, SUPPORTED_EXECUTOR_TYPES } from './AgentExecutorFactory';\n\n// 执行器实现（仅支持有完整 Agent SDK 的供应商）\nexport { CodeBuddyExecutor, CodeBuddyAuthError, createCodeBuddyExecutor } from './CodeBuddyExecutor';\nexport { ClaudeExecutor, ClaudeAuthenticationError, createClaudeExecutor } from './ClaudeExecutor';\n\n// 抽象基类\nexport { BaseAgentExecutor } from './BaseAgentExecutor';\n\n// Schema\nexport { AgentProvider, AgentProviderRelations, ExecutorType as ExecutorTypeEnum } from './schema/tables';\nexport { AgentConfig as AgentConfigTable, AgentStatus } from './schema/agent-config';\n\n// Agent Manager\nexport { AgentManager, agentManager } from './AgentManager';\nexport type { AgentInstance, AgentConfig } from './AgentManager';\n\n// IndexAgent\nexport { IndexAgent, indexAgent } from './IndexAgent';\nexport type { IndexLevel, IndexAgentOptions } from './IndexAgent';\n"]}

package/dist/agents/schema/agent-config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Agent Config Schema - Pod RDF 表定义
+ *
+ * Agent 实例配置，指定使用哪个 Provider、system prompt 等
+ *
+ * 存储位置: /settings/ai/agents.ttl
+ */
+/**
+ * AgentConfig - Agent 配置
+ *
+ * RDF 示例:
+ * <#indexing> a udfs:AgentConfig ;
+ *     udfs:displayName "Indexing Agent" ;
+ *     udfs:description "文档索引 Agent，帮助用户的文件变得可检索" ;
+ *     udfs:provider </settings/ai/agent-providers.ttl#codebuddy> ;
+ *     udfs:model </settings/ai/models.ttl#glm-4.7> ;
+ *     udfs:systemPrompt "你是 IndexAgent..." ;
+ *     udfs:maxTurns "20" ;
+ *     udfs:enabled "true" .
+ *
+ * 说明：
+ * - provider 指向 AgentProvider，决定用哪个 Executor
+ * - model 可以覆盖 provider 的 defaultModel
+ * - systemPrompt 是 Agent 的核心 prompt
+ */
+export declare const AgentConfig: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
+    id: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, false>;
+    displayName: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    description: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    provider: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    model: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    systemPrompt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    maxTurns: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"integer", null, false, false>;
+    timeout: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"integer", null, false, false>;
+    enabled: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+}>>;
+/**
+ * AgentStatus - Agent 运行状态
+ *
+ * 存储位置: /settings/ai/agent-status.ttl
+ *
+ * RDF 示例:
+ * <#indexing> a udfs:AgentStatus ;
+ *     udfs:agentId "indexing" ;
+ *     udfs:status "running" ;
+ *     udfs:startedAt "2026-01-10T10:00:00Z"^^xsd:dateTime ;
+ *     udfs:lastActivityAt "2026-01-10T10:05:00Z"^^xsd:dateTime ;
+ *     udfs:currentTaskId "task-123" .
+ */
+export declare const AgentStatus: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
+    id: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, false>;
+    agentId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    status: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    startedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    lastActivityAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    currentTaskId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    errorMessage: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+}>>;

package/dist/agents/schema/agent-config.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Agent Config Schema - Pod RDF 表定义
+ *
+ * Agent 实例配置，指定使用哪个 Provider、system prompt 等
+ *
+ * 存储位置: /settings/ai/agents.ttl
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentStatus = exports.AgentConfig = void 0;
+const drizzle_solid_1 = require("@undefineds.co/drizzle-solid");
+const vocab_1 = require("../../vocab");
+/**
+ * AgentConfig - Agent 配置
+ *
+ * RDF 示例:
+ * <#indexing> a udfs:AgentConfig ;
+ *     udfs:displayName "Indexing Agent" ;
+ *     udfs:description "文档索引 Agent，帮助用户的文件变得可检索" ;
+ *     udfs:provider </settings/ai/agent-providers.ttl#codebuddy> ;
+ *     udfs:model </settings/ai/models.ttl#glm-4.7> ;
+ *     udfs:systemPrompt "你是 IndexAgent..." ;
+ *     udfs:maxTurns "20" ;
+ *     udfs:enabled "true" .
+ *
+ * 说明：
+ * - provider 指向 AgentProvider，决定用哪个 Executor
+ * - model 可以覆盖 provider 的 defaultModel
+ * - systemPrompt 是 Agent 的核心 prompt
+ */
+exports.AgentConfig = (0, drizzle_solid_1.podTable)('AgentConfig', {
+    id: (0, drizzle_solid_1.string)('id').primaryKey(),
+    displayName: (0, drizzle_solid_1.string)('displayName'),
+    description: (0, drizzle_solid_1.string)('description'),
+    provider: (0, drizzle_solid_1.uri)('provider'),
+    model: (0, drizzle_solid_1.uri)('model'),
+    systemPrompt: (0, drizzle_solid_1.string)('systemPrompt'),
+    maxTurns: (0, drizzle_solid_1.int)('maxTurns'),
+    timeout: (0, drizzle_solid_1.int)('timeout'),
+    enabled: (0, drizzle_solid_1.string)('enabled'),
+}, {
+    base: '/settings/ai/agents.ttl',
+    type: vocab_1.UDFS.AgentConfig,
+    namespace: vocab_1.UDFS_NAMESPACE,
+    subjectTemplate: '#{id}',
+});
+/**
+ * AgentStatus - Agent 运行状态
+ *
+ * 存储位置: /settings/ai/agent-status.ttl
+ *
+ * RDF 示例:
+ * <#indexing> a udfs:AgentStatus ;
+ *     udfs:agentId "indexing" ;
+ *     udfs:status "running" ;
+ *     udfs:startedAt "2026-01-10T10:00:00Z"^^xsd:dateTime ;
+ *     udfs:lastActivityAt "2026-01-10T10:05:00Z"^^xsd:dateTime ;
+ *     udfs:currentTaskId "task-123" .
+ */
+exports.AgentStatus = (0, drizzle_solid_1.podTable)('AgentStatus', {
+    id: (0, drizzle_solid_1.string)('id').primaryKey(),
+    agentId: (0, drizzle_solid_1.string)('agentId'),
+    status: (0, drizzle_solid_1.string)('status'),
+    startedAt: (0, drizzle_solid_1.datetime)('startedAt'),
+    lastActivityAt: (0, drizzle_solid_1.datetime)('lastActivityAt'),
+    currentTaskId: (0, drizzle_solid_1.string)('currentTaskId'),
+    errorMessage: (0, drizzle_solid_1.string)('errorMessage'),
+}, {
+    base: '/settings/ai/agent-status.ttl',
+    type: vocab_1.UDFS.AgentStatus,
+    namespace: vocab_1.UDFS_NAMESPACE,
+    subjectTemplate: '#{id}',
+});
+//# sourceMappingURL=agent-config.js.map