@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/task/TaskExecutor.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * TaskExecutor - 任务执行器
+ *
+ * 职责：
+ * - 从队列获取待执行任务
+ * - 路由到对应的 Agent
+ * - 调用 Agent 执行
+ * - 更新任务状态
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskExecutor = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const agents_1 = require("../agents");
+/**
+ * 任务执行器实现
+ */
+class TaskExecutor {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.agents = new Map();
+        this.running = false;
+        this.pollTimer = null;
+        this.taskQueue = options.taskQueue;
+        this.podBaseUrl = options.podBaseUrl;
+        this.getAuthenticatedFetch = options.getAuthenticatedFetch;
+        this.pollInterval = options.pollInterval ?? 5000;
+    }
+    /**
+     * 注册 Agent
+     */
+    registerAgent(agent) {
+        this.agents.set(agent.name, agent);
+        this.logger.info(`Registered agent: ${agent.name}`);
+    }
+    /**
+     * 启动执行器
+     *
+     * 会先检查 Agent SDK 鉴权状态，如果未鉴权则抛出错误。
+     * 这避免了在服务端环境中 SDK 尝试弹出浏览器进行交互式登录。
+     */
+    async start() {
+        if (this.running) {
+            return;
+        }
+        // 检查 Agent SDK 鉴权状态
+        await this.checkAgentAuthentication();
+        this.running = true;
+        this.logger.info('TaskExecutor started');
+        this.schedulePoll();
+    }
+    /**
+     * 检查 Agent SDK 鉴权状态
+     *
+     * 在服务端环境中，如果 SDK 未鉴权，会尝试弹出浏览器进行交互式登录，
+     * 这在无界面环境中会失败。因此需要在启动时检查鉴权状态。
+     *
+     * @throws CodeBuddyAuthError 如果未鉴权
+     */
+    async checkAgentAuthentication() {
+        const executor = new agents_1.CodeBuddyExecutor();
+        try {
+            const authInfo = await executor.checkAuthentication();
+            this.logger.info(`Agent SDK authenticated via: ${authInfo.authType}`);
+            if (authInfo.account?.email) {
+                this.logger.info(`Agent SDK account: ${authInfo.account.email}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof agents_1.CodeBuddyAuthError) {
+                this.logger.error(`Agent SDK authentication failed: ${error.message}`);
+                this.logger.error('Please run `codebuddy` command to login before starting the server.');
+                throw error;
+            }
+            throw error;
+        }
+    }
+    /**
+     * 停止执行器
+     */
+    async stop() {
+        this.running = false;
+        if (this.pollTimer) {
+            clearTimeout(this.pollTimer);
+            this.pollTimer = null;
+        }
+        this.logger.info('TaskExecutor stopped');
+    }
+    /**
+     * 手动触发执行特定任务
+     */
+    async trigger(taskId) {
+        const task = await this.taskQueue.getTask(taskId);
+        if (!task) {
+            this.logger.warn(`Task not found: ${taskId}`);
+            return;
+        }
+        await this.executeTask(task);
+    }
+    /**
+     * 获取执行器状态
+     */
+    isRunning() {
+        return this.running;
+    }
+    /**
+     * 调度下一次轮询
+     */
+    schedulePoll() {
+        if (!this.running) {
+            return;
+        }
+        this.pollTimer = setTimeout(async () => {
+            await this.poll();
+            this.schedulePoll();
+        }, this.pollInterval);
+    }
+    /**
+     * 轮询待执行任务
+     */
+    async poll() {
+        try {
+            const tasks = await this.taskQueue.listTasks({
+                status: 'pending',
+                limit: 10,
+                orderBy: 'createdAt',
+                order: 'asc',
+            });
+            for (const task of tasks) {
+                await this.executeTask(task);
+            }
+        }
+        catch (error) {
+            this.logger.error(`Poll error: ${error}`);
+        }
+    }
+    /**
+     * 执行任务
+     */
+    async executeTask(task) {
+        const agent = this.agents.get(task.agent);
+        if (!agent) {
+            this.logger.error(`No agent registered for: ${task.agent}`);
+            await this.taskQueue.updateTaskStatus(task.id, 'failed', {
+                error: `No agent registered for: ${task.agent}`,
+            });
+            return;
+        }
+        // 更新状态为执行中
+        await this.taskQueue.updateTaskStatus(task.id, 'running');
+        // 创建执行上下文
+        const context = this.createContext(task);
+        try {
+            this.logger.info(`Executing task ${task.id} with agent ${task.agent}`);
+            const result = await agent.execute(task.message, context);
+            if (result.success) {
+                await this.taskQueue.updateTaskStatus(task.id, 'completed', {
+                    result: result.data,
+                });
+                this.logger.info(`Task ${task.id} completed`);
+            }
+            else {
+                await this.taskQueue.updateTaskStatus(task.id, 'failed', {
+                    error: result.error,
+                });
+                this.logger.warn(`Task ${task.id} failed: ${result.error}`);
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            await this.taskQueue.updateTaskStatus(task.id, 'failed', {
+                error: errorMsg,
+            });
+            this.logger.error(`Task ${task.id} error: ${errorMsg}`);
+        }
+    }
+    /**
+     * 创建 Agent 执行上下文
+     */
+    createContext(task) {
+        return {
+            taskId: task.id,
+            podBaseUrl: this.podBaseUrl,
+            getAuthenticatedFetch: this.getAuthenticatedFetch,
+            updateStatus: async (status) => {
+                await this.taskQueue.updateTaskStatus(task.id, status);
+            },
+            log: {
+                debug: (msg) => this.logger.debug(`[${task.id}] ${msg}`),
+                info: (msg) => this.logger.info(`[${task.id}] ${msg}`),
+                warn: (msg) => this.logger.warn(`[${task.id}] ${msg}`),
+                error: (msg) => this.logger.error(`[${task.id}] ${msg}`),
+            },
+        };
+    }
+}
+exports.TaskExecutor = TaskExecutor;
+//# sourceMappingURL=TaskExecutor.js.map

package/dist/task/TaskExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskExecutor.js","sourceRoot":"","sources":["../../src/task/TaskExecutor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * TaskExecutor - 任务执行器\n *\n * 职责：\n * - 从队列获取待执行任务\n * - 路由到对应的 Agent\n * - 调用 Agent 执行\n * - 更新任务状态\n */\n\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { Agent, AgentContext, Task, TaskQueue, TaskExecutor as ITaskExecutor } from './types';\nimport { CodeBuddyExecutor, CodeBuddyAuthError } from '../agents';\n\nexport interface TaskExecutorOptions {\n  /** 任务队列 */\n  taskQueue: TaskQueue;\n\n  /** Pod base URL */\n  podBaseUrl: string;\n\n  /** 获取认证 fetch */\n  getAuthenticatedFetch: () => Promise<typeof fetch>;\n\n  /** 轮询间隔（毫秒） */\n  pollInterval?: number;\n}\n\n/**\n * 任务执行器实现\n */\nexport class TaskExecutor implements ITaskExecutor {\n  private readonly logger = getLoggerFor(this);\n  private readonly taskQueue: TaskQueue;\n  private readonly podBaseUrl: string;\n  private readonly getAuthenticatedFetch: () => Promise<typeof fetch>;\n  private readonly pollInterval: number;\n\n  private readonly agents: Map<string, Agent> = new Map();\n  private running = false;\n  private pollTimer: ReturnType<typeof setTimeout> | null = null;\n\n  public constructor(options: TaskExecutorOptions) {\n    this.taskQueue = options.taskQueue;\n    this.podBaseUrl = options.podBaseUrl;\n    this.getAuthenticatedFetch = options.getAuthenticatedFetch;\n    this.pollInterval = options.pollInterval ?? 5000;\n  }\n\n  /**\n   * 注册 Agent\n   */\n  public registerAgent(agent: Agent): void {\n    this.agents.set(agent.name, agent);\n    this.logger.info(`Registered agent: ${agent.name}`);\n  }\n\n  /**\n   * 启动执行器\n   * \n   * 会先检查 Agent SDK 鉴权状态，如果未鉴权则抛出错误。\n   * 这避免了在服务端环境中 SDK 尝试弹出浏览器进行交互式登录。\n   */\n  public async start(): Promise<void> {\n    if (this.running) {\n      return;\n    }\n\n    // 检查 Agent SDK 鉴权状态\n    await this.checkAgentAuthentication();\n\n    this.running = true;\n    this.logger.info('TaskExecutor started');\n    this.schedulePoll();\n  }\n\n  /**\n   * 检查 Agent SDK 鉴权状态\n   * \n   * 在服务端环境中，如果 SDK 未鉴权，会尝试弹出浏览器进行交互式登录，\n   * 这在无界面环境中会失败。因此需要在启动时检查鉴权状态。\n   * \n   * @throws CodeBuddyAuthError 如果未鉴权\n   */\n  private async checkAgentAuthentication(): Promise<void> {\n    const executor = new CodeBuddyExecutor();\n    \n    try {\n      const authInfo = await executor.checkAuthentication();\n      this.logger.info(`Agent SDK authenticated via: ${authInfo.authType}`);\n      \n      if (authInfo.account?.email) {\n        this.logger.info(`Agent SDK account: ${authInfo.account.email}`);\n      }\n    } catch (error) {\n      if (error instanceof CodeBuddyAuthError) {\n        this.logger.error(`Agent SDK authentication failed: ${error.message}`);\n        this.logger.error('Please run `codebuddy` command to login before starting the server.');\n        throw error;\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * 停止执行器\n   */\n  public async stop(): Promise<void> {\n    this.running = false;\n\n    if (this.pollTimer) {\n      clearTimeout(this.pollTimer);\n      this.pollTimer = null;\n    }\n\n    this.logger.info('TaskExecutor stopped');\n  }\n\n  /**\n   * 手动触发执行特定任务\n   */\n  public async trigger(taskId: string): Promise<void> {\n    const task = await this.taskQueue.getTask(taskId);\n    if (!task) {\n      this.logger.warn(`Task not found: ${taskId}`);\n      return;\n    }\n\n    await this.executeTask(task);\n  }\n\n  /**\n   * 获取执行器状态\n   */\n  public isRunning(): boolean {\n    return this.running;\n  }\n\n  /**\n   * 调度下一次轮询\n   */\n  private schedulePoll(): void {\n    if (!this.running) {\n      return;\n    }\n\n    this.pollTimer = setTimeout(async () => {\n      await this.poll();\n      this.schedulePoll();\n    }, this.pollInterval);\n  }\n\n  /**\n   * 轮询待执行任务\n   */\n  private async poll(): Promise<void> {\n    try {\n      const tasks = await this.taskQueue.listTasks({\n        status: 'pending',\n        limit: 10,\n        orderBy: 'createdAt',\n        order: 'asc',\n      });\n\n      for (const task of tasks) {\n        await this.executeTask(task);\n      }\n    } catch (error) {\n      this.logger.error(`Poll error: ${error}`);\n    }\n  }\n\n  /**\n   * 执行任务\n   */\n  private async executeTask(task: Task): Promise<void> {\n    const agent = this.agents.get(task.agent);\n\n    if (!agent) {\n      this.logger.error(`No agent registered for: ${task.agent}`);\n      await this.taskQueue.updateTaskStatus(task.id, 'failed', {\n        error: `No agent registered for: ${task.agent}`,\n      });\n      return;\n    }\n\n    // 更新状态为执行中\n    await this.taskQueue.updateTaskStatus(task.id, 'running');\n\n    // 创建执行上下文\n    const context = this.createContext(task);\n\n    try {\n      this.logger.info(`Executing task ${task.id} with agent ${task.agent}`);\n\n      const result = await agent.execute(task.message, context);\n\n      if (result.success) {\n        await this.taskQueue.updateTaskStatus(task.id, 'completed', {\n          result: result.data,\n        });\n        this.logger.info(`Task ${task.id} completed`);\n      } else {\n        await this.taskQueue.updateTaskStatus(task.id, 'failed', {\n          error: result.error,\n        });\n        this.logger.warn(`Task ${task.id} failed: ${result.error}`);\n      }\n    } catch (error) {\n      const errorMsg = error instanceof Error ? error.message : String(error);\n      await this.taskQueue.updateTaskStatus(task.id, 'failed', {\n        error: errorMsg,\n      });\n      this.logger.error(`Task ${task.id} error: ${errorMsg}`);\n    }\n  }\n\n  /**\n   * 创建 Agent 执行上下文\n   */\n  private createContext(task: Task): AgentContext {\n    return {\n      taskId: task.id,\n      podBaseUrl: this.podBaseUrl,\n      getAuthenticatedFetch: this.getAuthenticatedFetch,\n      updateStatus: async (status) => {\n        await this.taskQueue.updateTaskStatus(task.id, status);\n      },\n      log: {\n        debug: (msg) => this.logger.debug(`[${task.id}] ${msg}`),\n        info: (msg) => this.logger.info(`[${task.id}] ${msg}`),\n        warn: (msg) => this.logger.warn(`[${task.id}] ${msg}`),\n        error: (msg) => this.logger.error(`[${task.id}] ${msg}`),\n      },\n    };\n  }\n}\n"]}

package/dist/task/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Task module - 任务系统
+ *
+ * 简化模型：消息 + Agent
+ */
+export { Task as TaskTable, TaskStatus, getTodayTaskPath, getTaskPathForDate } from './schema';
+export type { TaskStatusType } from './schema';
+export type { Task, TaskStatus as TaskStatusString, CreateTaskInput, Agent, AgentContext, AgentResult, ListTasksOptions, TaskQueue, TaskQueueStats, TaskExecutor as ITaskExecutor, } from './types';
+export { DrizzleTaskQueue, type DrizzleTaskQueueOptions } from './DrizzleTaskQueue';
+export { TaskExecutor, type TaskExecutorOptions } from './TaskExecutor';

package/dist/task/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Task module - 任务系统
+ *
+ * 简化模型：消息 + Agent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskExecutor = exports.DrizzleTaskQueue = exports.getTaskPathForDate = exports.getTodayTaskPath = exports.TaskStatus = exports.TaskTable = void 0;
+// Schema
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "TaskTable", { enumerable: true, get: function () { return schema_1.Task; } });
+Object.defineProperty(exports, "TaskStatus", { enumerable: true, get: function () { return schema_1.TaskStatus; } });
+Object.defineProperty(exports, "getTodayTaskPath", { enumerable: true, get: function () { return schema_1.getTodayTaskPath; } });
+Object.defineProperty(exports, "getTaskPathForDate", { enumerable: true, get: function () { return schema_1.getTaskPathForDate; } });
+// Implementations
+var DrizzleTaskQueue_1 = require("./DrizzleTaskQueue");
+Object.defineProperty(exports, "DrizzleTaskQueue", { enumerable: true, get: function () { return DrizzleTaskQueue_1.DrizzleTaskQueue; } });
+var TaskExecutor_1 = require("./TaskExecutor");
+Object.defineProperty(exports, "TaskExecutor", { enumerable: true, get: function () { return TaskExecutor_1.TaskExecutor; } });
+//# sourceMappingURL=index.js.map

package/dist/task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,SAAS;AACT,mCAA+F;AAAtF,mGAAA,IAAI,OAAa;AAAE,oGAAA,UAAU,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAiB5E,kBAAkB;AAClB,uDAAoF;AAA3E,oHAAA,gBAAgB,OAAA;AACzB,+CAAwE;AAA/D,4GAAA,YAAY,OAAA","sourcesContent":["/**\n * Task module - 任务系统\n *\n * 简化模型：消息 + Agent\n */\n\n// Schema\nexport { Task as TaskTable, TaskStatus, getTodayTaskPath, getTaskPathForDate } from './schema';\nexport type { TaskStatusType } from './schema';\n\n// Types\nexport type {\n  Task,\n  TaskStatus as TaskStatusString,\n  CreateTaskInput,\n  Agent,\n  AgentContext,\n  AgentResult,\n  ListTasksOptions,\n  TaskQueue,\n  TaskQueueStats,\n  TaskExecutor as ITaskExecutor,\n} from './types';\n\n// Implementations\nexport { DrizzleTaskQueue, type DrizzleTaskQueueOptions } from './DrizzleTaskQueue';\nexport { TaskExecutor, type TaskExecutorOptions } from './TaskExecutor';\n"]}

package/dist/task/schema.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Task Schema - Pod RDF 表定义
+ *
+ * 简化模型：消息 + Agent
+ *
+ * 任务系统只负责：
+ * - 接收任务 (agent + message)
+ * - 调度执行
+ * - 记录状态
+ *
+ * 具体怎么处理、用什么工具、做到什么程度，全部由 Agent 自己决定。
+ */
+/**
+ * 任务状态
+ */
+export declare const TaskStatus: {
+    readonly PENDING: "pending";
+    readonly RUNNING: "running";
+    readonly COMPLETED: "completed";
+    readonly FAILED: "failed";
+};
+export type TaskStatusType = (typeof TaskStatus)[keyof typeof TaskStatus];
+/**
+ * Task - 任务实例
+ *
+ * 存储位置: /tasks/{YYYY-MM-DD}.ttl (按天分片)
+ *
+ * RDF 示例:
+ * <#task-abc123> a udfs:Task ;
+ *     udfs:agent "indexing" ;
+ *     udfs:message "用户在 </docs/> 上传了文件 </docs/report.pdf>" ;
+ *     udfs:status "pending" ;
+ *     udfs:createdAt "2026-01-09T10:00:00Z"^^xsd:dateTime .
+ */
+export declare const Task: 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>;
+    agent: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    message: 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>;
+    createdAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    startedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    completedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    result: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"json", null, false, false>;
+    error: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+}>>;
+/**
+ * 获取今天的任务文件路径
+ */
+export declare function getTodayTaskPath(): string;
+/**
+ * 获取指定日期的任务文件路径
+ */
+export declare function getTaskPathForDate(date: Date): string;

package/dist/task/schema.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Task Schema - Pod RDF 表定义
+ *
+ * 简化模型：消息 + Agent
+ *
+ * 任务系统只负责：
+ * - 接收任务 (agent + message)
+ * - 调度执行
+ * - 记录状态
+ *
+ * 具体怎么处理、用什么工具、做到什么程度，全部由 Agent 自己决定。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Task = exports.TaskStatus = void 0;
+exports.getTodayTaskPath = getTodayTaskPath;
+exports.getTaskPathForDate = getTaskPathForDate;
+const drizzle_solid_1 = require("@undefineds.co/drizzle-solid");
+const vocab_1 = require("../vocab");
+/**
+ * 任务状态
+ */
+exports.TaskStatus = {
+    PENDING: 'pending',
+    RUNNING: 'running',
+    COMPLETED: 'completed',
+    FAILED: 'failed',
+};
+/**
+ * Task - 任务实例
+ *
+ * 存储位置: /tasks/{YYYY-MM-DD}.ttl (按天分片)
+ *
+ * RDF 示例:
+ * <#task-abc123> a udfs:Task ;
+ *     udfs:agent "indexing" ;
+ *     udfs:message "用户在 </docs/> 上传了文件 </docs/report.pdf>" ;
+ *     udfs:status "pending" ;
+ *     udfs:createdAt "2026-01-09T10:00:00Z"^^xsd:dateTime .
+ */
+exports.Task = (0, drizzle_solid_1.podTable)('Task', {
+    id: (0, drizzle_solid_1.string)('id').primaryKey(),
+    agent: (0, drizzle_solid_1.string)('agent'),
+    message: (0, drizzle_solid_1.string)('message'),
+    status: (0, drizzle_solid_1.string)('status'),
+    createdAt: (0, drizzle_solid_1.datetime)('createdAt'),
+    startedAt: (0, drizzle_solid_1.datetime)('startedAt'),
+    completedAt: (0, drizzle_solid_1.datetime)('completedAt'),
+    result: (0, drizzle_solid_1.json)('result'),
+    error: (0, drizzle_solid_1.string)('error'),
+}, {
+    base: '/tasks/',
+    type: vocab_1.UDFS.Task,
+    namespace: vocab_1.UDFS_NAMESPACE,
+    subjectTemplate: '#{id}',
+});
+/**
+ * 获取今天的任务文件路径
+ */
+function getTodayTaskPath() {
+    const today = new Date().toISOString().split('T')[0];
+    return `/tasks/${today}.ttl`;
+}
+/**
+ * 获取指定日期的任务文件路径
+ */
+function getTaskPathForDate(date) {
+    const dateStr = date.toISOString().split('T')[0];
+    return `/tasks/${dateStr}.ttl`;
+}
+//# sourceMappingURL=schema.js.map

package/dist/task/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/task/schema.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAqDH,4CAGC;AAKD,gDAGC;AA9DD,gEAAgF;AAChF,oCAAgD;AAEhD;;GAEG;AACU,QAAA,UAAU,GAAG;IACxB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;CACR,CAAC;AAIX;;;;;;;;;;;GAWG;AACU,QAAA,IAAI,GAAG,IAAA,wBAAQ,EAC1B,MAAM,EACN;IACE,EAAE,EAAE,IAAA,sBAAM,EAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC7B,KAAK,EAAE,IAAA,sBAAM,EAAC,OAAO,CAAC;IACtB,OAAO,EAAE,IAAA,sBAAM,EAAC,SAAS,CAAC;IAC1B,MAAM,EAAE,IAAA,sBAAM,EAAC,QAAQ,CAAC;IACxB,SAAS,EAAE,IAAA,wBAAQ,EAAC,WAAW,CAAC;IAChC,SAAS,EAAE,IAAA,wBAAQ,EAAC,WAAW,CAAC;IAChC,WAAW,EAAE,IAAA,wBAAQ,EAAC,aAAa,CAAC;IACpC,MAAM,EAAE,IAAA,oBAAI,EAAC,QAAQ,CAAC;IACtB,KAAK,EAAE,IAAA,sBAAM,EAAC,OAAO,CAAC;CACvB,EACD;IACE,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,YAAI,CAAC,IAAI;IACf,SAAS,EAAE,sBAAc;IACzB,eAAe,EAAE,OAAO;CACzB,CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,UAAU,KAAK,MAAM,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,IAAU;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,UAAU,OAAO,MAAM,CAAC;AACjC,CAAC","sourcesContent":["/**\n * Task Schema - Pod RDF 表定义\n *\n * 简化模型：消息 + Agent\n *\n * 任务系统只负责：\n * - 接收任务 (agent + message)\n * - 调度执行\n * - 记录状态\n *\n * 具体怎么处理、用什么工具、做到什么程度，全部由 Agent 自己决定。\n */\n\nimport { podTable, string, datetime, json } from '@undefineds.co/drizzle-solid';\nimport { UDFS, UDFS_NAMESPACE } from '../vocab';\n\n/**\n * 任务状态\n */\nexport const TaskStatus = {\n  PENDING: 'pending',\n  RUNNING: 'running',\n  COMPLETED: 'completed',\n  FAILED: 'failed',\n} as const;\n\nexport type TaskStatusType = (typeof TaskStatus)[keyof typeof TaskStatus];\n\n/**\n * Task - 任务实例\n *\n * 存储位置: /tasks/{YYYY-MM-DD}.ttl (按天分片)\n *\n * RDF 示例:\n * <#task-abc123> a udfs:Task ;\n *     udfs:agent \"indexing\" ;\n *     udfs:message \"用户在 </docs/> 上传了文件 </docs/report.pdf>\" ;\n *     udfs:status \"pending\" ;\n *     udfs:createdAt \"2026-01-09T10:00:00Z\"^^xsd:dateTime .\n */\nexport const Task = podTable(\n  'Task',\n  {\n    id: string('id').primaryKey(),\n    agent: string('agent'),\n    message: string('message'),\n    status: string('status'),\n    createdAt: datetime('createdAt'),\n    startedAt: datetime('startedAt'),\n    completedAt: datetime('completedAt'),\n    result: json('result'),\n    error: string('error'),\n  },\n  {\n    base: '/tasks/',\n    type: UDFS.Task,\n    namespace: UDFS_NAMESPACE,\n    subjectTemplate: '#{id}',\n  },\n);\n\n/**\n * 获取今天的任务文件路径\n */\nexport function getTodayTaskPath(): string {\n  const today = new Date().toISOString().split('T')[0];\n  return `/tasks/${today}.ttl`;\n}\n\n/**\n * 获取指定日期的任务文件路径\n */\nexport function getTaskPathForDate(date: Date): string {\n  const dateStr = date.toISOString().split('T')[0];\n  return `/tasks/${dateStr}.ttl`;\n}\n\n"]}

package/dist/task/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Task System - 基于消息路由的任务系统
+ *
+ * 核心思想：
+ * - 任务系统是消息路由器，将消息发送给对应的 AI Agent 处理
+ * - 不做策略封装，只提供工具和标准
+ * - AI 自己决策：用什么工具、做到什么程度
+ * - 不做固化流程：AI 的使命是帮助用户，随着理解加深持续进化
+ */
+/**
+ * 任务状态
+ */
+export type TaskStatus = 'pending' | 'running' | 'completed' | 'failed';
+/**
+ * 任务
+ *
+ * 简化模型：消息 + Agent
+ */
+export interface Task {
+    /** 任务 ID */
+    id: string;
+    /** 发给哪个 AI Agent */
+    agent: string;
+    /** 任务消息/上下文 */
+    message: string;
+    /** 任务状态 */
+    status: TaskStatus;
+    /** 创建时间 */
+    createdAt: Date;
+    /** 开始执行时间 */
+    startedAt?: Date;
+    /** 完成时间 */
+    completedAt?: Date;
+    /** 执行结果 */
+    result?: unknown;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * 创建任务的输入
+ */
+export interface CreateTaskInput {
+    /** 发给哪个 AI Agent */
+    agent: string;
+    /** 任务消息/上下文 */
+    message: string;
+}
+/**
+ * AI Agent 接口
+ */
+export interface Agent {
+    /** Agent 名称 */
+    readonly name: string;
+    /** Agent 描述 */
+    readonly description: string;
+    /**
+     * 执行任务
+     * @param message 任务消息
+     * @param context 执行上下文
+     * @returns 执行结果
+     */
+    execute(message: string, context: AgentContext): Promise<AgentResult>;
+}
+/**
+ * Agent 执行上下文
+ */
+export interface AgentContext {
+    /** 任务 ID */
+    taskId: string;
+    /** Pod base URL */
+    podBaseUrl: string;
+    /** OAuth access token（用于 MCP 访问 Pod） */
+    accessToken?: string;
+    /** 获取认证 fetch（用于访问 Pod 资源） */
+    getAuthenticatedFetch(): Promise<typeof fetch>;
+    /** 更新任务状态 */
+    updateStatus(status: TaskStatus): Promise<void>;
+    /** 日志 */
+    log: {
+        debug(message: string): void;
+        info(message: string): void;
+        warn(message: string): void;
+        error(message: string): void;
+    };
+}
+/**
+ * Agent 执行结果
+ */
+export interface AgentResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 结果数据 */
+    data?: unknown;
+    /** 错误信息 */
+    error?: string;
+    /** 使用统计 */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        cost: number;
+        turns: number;
+        durationMs: number;
+    };
+}
+/**
+ * 任务队列接口
+ */
+export interface TaskQueue {
+    /**
+     * 创建任务
+     */
+    createTask(input: CreateTaskInput): Promise<Task>;
+    /**
+     * 获取任务
+     */
+    getTask(taskId: string): Promise<Task | null>;
+    /**
+     * 获取任务列表
+     */
+    listTasks(options?: ListTasksOptions): Promise<Task[]>;
+    /**
+     * 更新任务状态
+     */
+    updateTaskStatus(taskId: string, status: TaskStatus, updates?: Partial<Task>): Promise<void>;
+    /**
+     * 删除任务
+     */
+    deleteTask(taskId: string): Promise<void>;
+    /**
+     * 获取队列统计
+     */
+    getStats(): Promise<TaskQueueStats>;
+}
+/**
+ * 列表查询选项
+ */
+export interface ListTasksOptions {
+    /** 任务状态过滤 */
+    status?: TaskStatus;
+    /** Agent 过滤 */
+    agent?: string;
+    /** 限制数量 */
+    limit?: number;
+    /** 偏移量 */
+    offset?: number;
+    /** 排序字段 */
+    orderBy?: 'createdAt' | 'startedAt' | 'completedAt';
+    /** 排序方向 */
+    order?: 'asc' | 'desc';
+}
+/**
+ * 队列统计
+ */
+export interface TaskQueueStats {
+    pending: number;
+    running: number;
+    completed: number;
+    failed: number;
+    total: number;
+    byAgent: Record<string, number>;
+}
+/**
+ * 任务执行器接口
+ */
+export interface TaskExecutor {
+    /**
+     * 注册 Agent
+     */
+    registerAgent(agent: Agent): void;
+    /**
+     * 启动执行器
+     */
+    start(): Promise<void>;
+    /**
+     * 停止执行器
+     */
+    stop(): Promise<void>;
+    /**
+     * 手动触发执行
+     */
+    trigger(taskId: string): Promise<void>;
+    /**
+     * 获取执行器状态
+     */
+    isRunning(): boolean;
+}

package/dist/task/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Task System - 基于消息路由的任务系统
+ *
+ * 核心思想：
+ * - 任务系统是消息路由器，将消息发送给对应的 AI Agent 处理
+ * - 不做策略封装，只提供工具和标准
+ * - AI 自己决策：用什么工具、做到什么程度
+ * - 不做固化流程：AI 的使命是帮助用户，随着理解加深持续进化
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/task/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/task/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG","sourcesContent":["/**\n * Task System - 基于消息路由的任务系统\n *\n * 核心思想：\n * - 任务系统是消息路由器，将消息发送给对应的 AI Agent 处理\n * - 不做策略封装，只提供工具和标准\n * - AI 自己决策：用什么工具、做到什么程度\n * - 不做固化流程：AI 的使命是帮助用户，随着理解加深持续进化\n */\n\n/**\n * 任务状态\n */\nexport type TaskStatus = 'pending' | 'running' | 'completed' | 'failed';\n\n/**\n * 任务\n *\n * 简化模型：消息 + Agent\n */\nexport interface Task {\n  /** 任务 ID */\n  id: string;\n\n  /** 发给哪个 AI Agent */\n  agent: string;\n\n  /** 任务消息/上下文 */\n  message: string;\n\n  /** 任务状态 */\n  status: TaskStatus;\n\n  /** 创建时间 */\n  createdAt: Date;\n\n  /** 开始执行时间 */\n  startedAt?: Date;\n\n  /** 完成时间 */\n  completedAt?: Date;\n\n  /** 执行结果 */\n  result?: unknown;\n\n  /** 错误信息 */\n  error?: string;\n}\n\n/**\n * 创建任务的输入\n */\nexport interface CreateTaskInput {\n  /** 发给哪个 AI Agent */\n  agent: string;\n\n  /** 任务消息/上下文 */\n  message: string;\n}\n\n/**\n * AI Agent 接口\n */\nexport interface Agent {\n  /** Agent 名称 */\n  readonly name: string;\n\n  /** Agent 描述 */\n  readonly description: string;\n\n  /**\n   * 执行任务\n   * @param message 任务消息\n   * @param context 执行上下文\n   * @returns 执行结果\n   */\n  execute(message: string, context: AgentContext): Promise<AgentResult>;\n}\n\n/**\n * Agent 执行上下文\n */\nexport interface AgentContext {\n  /** 任务 ID */\n  taskId: string;\n\n  /** Pod base URL */\n  podBaseUrl: string;\n\n  /** OAuth access token（用于 MCP 访问 Pod） */\n  accessToken?: string;\n\n  /** 获取认证 fetch（用于访问 Pod 资源） */\n  getAuthenticatedFetch(): Promise<typeof fetch>;\n\n  /** 更新任务状态 */\n  updateStatus(status: TaskStatus): Promise<void>;\n\n  /** 日志 */\n  log: {\n    debug(message: string): void;\n    info(message: string): void;\n    warn(message: string): void;\n    error(message: string): void;\n  };\n}\n\n/**\n * Agent 执行结果\n */\nexport interface AgentResult {\n  /** 是否成功 */\n  success: boolean;\n\n  /** 结果数据 */\n  data?: unknown;\n\n  /** 错误信息 */\n  error?: string;\n\n  /** 使用统计 */\n  usage?: {\n    inputTokens: number;\n    outputTokens: number;\n    cost: number;\n    turns: number;\n    durationMs: number;\n  };\n}\n\n/**\n * 任务队列接口\n */\nexport interface TaskQueue {\n  /**\n   * 创建任务\n   */\n  createTask(input: CreateTaskInput): Promise<Task>;\n\n  /**\n   * 获取任务\n   */\n  getTask(taskId: string): Promise<Task | null>;\n\n  /**\n   * 获取任务列表\n   */\n  listTasks(options?: ListTasksOptions): Promise<Task[]>;\n\n  /**\n   * 更新任务状态\n   */\n  updateTaskStatus(taskId: string, status: TaskStatus, updates?: Partial<Task>): Promise<void>;\n\n  /**\n   * 删除任务\n   */\n  deleteTask(taskId: string): Promise<void>;\n\n  /**\n   * 获取队列统计\n   */\n  getStats(): Promise<TaskQueueStats>;\n}\n\n/**\n * 列表查询选项\n */\nexport interface ListTasksOptions {\n  /** 任务状态过滤 */\n  status?: TaskStatus;\n\n  /** Agent 过滤 */\n  agent?: string;\n\n  /** 限制数量 */\n  limit?: number;\n\n  /** 偏移量 */\n  offset?: number;\n\n  /** 排序字段 */\n  orderBy?: 'createdAt' | 'startedAt' | 'completedAt';\n\n  /** 排序方向 */\n  order?: 'asc' | 'desc';\n}\n\n/**\n * 队列统计\n */\nexport interface TaskQueueStats {\n  pending: number;\n  running: number;\n  completed: number;\n  failed: number;\n  total: number;\n  byAgent: Record<string, number>;\n}\n\n/**\n * 任务执行器接口\n */\nexport interface TaskExecutor {\n  /**\n   * 注册 Agent\n   */\n  registerAgent(agent: Agent): void;\n\n  /**\n   * 启动执行器\n   */\n  start(): Promise<void>;\n\n  /**\n   * 停止执行器\n   */\n  stop(): Promise<void>;\n\n  /**\n   * 手动触发执行\n   */\n  trigger(taskId: string): Promise<void>;\n\n  /**\n   * 获取执行器状态\n   */\n  isRunning(): boolean;\n}\n"]}

package/dist/terminal/AclPermissionService.d.ts

@@ -0,0 +1,28 @@
+export declare class AclPermissionService {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private engine?;
+    private readonly sparqlEndpoint?;
+    constructor(sparqlEndpoint?: string);
+    private getEngine;
+    /**
+     * Check if a user has acl:Control permission on a resource.
+     *
+     * Checks for:
+     * - Direct agent match: acl:agent <userId>
+     * - Public access: acl:agentClass foaf:Agent
+     * - Authenticated access: acl:agentClass acl:AuthenticatedAgent
+     *
+     * @param userId - The WebID of the user
+     * @param resourceUrl - The URL of the resource to check
+     * @returns true if user has Control permission
+     */
+    hasControlPermission(userId: string, resourceUrl: string): Promise<boolean>;
+    /**
+     * Get all resources where user has Control permission under a base path.
+     *
+     * @param userId - The WebID of the user
+     * @param basePath - The base path to search under
+     * @returns Array of resource URLs with Control permission
+     */
+    getControlledResources(userId: string, basePath: string): Promise<string[]>;
+}