@ai-setting/roy-agent-core 1.7.88 → 1.7.90

package/dist/env/task/storage/index.js

@@ -1,9 +1,20 @@
-import"../../../shared/@ai-setting/roy-agent-core-vpcxv1ty.js";
+import"../../../shared/@ai-setting/roy-agent-core-05z35shp.js";
+import {
+  REMOTE_PROTOCOL_MAJOR,
+  REMOTE_TASK_STORE_METHODS,
+  RemoteAuthError,
+  RemoteBatchBusyError,
+  RemoteIdempotencyConflictError,
+  RemoteProtocolError,
+  RemoteTaskStore,
+  RemoteTaskStoreError,
+  createRemoteTaskStore
+} from "../../../shared/@ai-setting/roy-agent-core-zhwcje5a.js";
 import {
   SQLiteTaskStore,
   getDefaultDataDir,
   getDefaultTaskDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-6k8mb7zx.js";
+} from "../../../shared/@ai-setting/roy-agent-core-m66ysky0.js";
 import"../../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
@@ -11,5 +22,14 @@ import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   getDefaultTaskDbPath,
   getDefaultDataDir,
-  SQLiteTaskStore
+  createRemoteTaskStore,
+  SQLiteTaskStore,
+  RemoteTaskStoreError,
+  RemoteTaskStore,
+  RemoteProtocolError,
+  RemoteIdempotencyConflictError,
+  RemoteBatchBusyError,
+  RemoteAuthError,
+  REMOTE_TASK_STORE_METHODS,
+  REMOTE_PROTOCOL_MAJOR
 };

package/dist/env/task/storage/migrations/006_add_task_owner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Task Migration 006: Add owner column
+ *
+ * Migration ID: 006_add_task_owner
+ * Description: 给 task 表加 `owner` 列（负责人，可空）。
+ *              Task #5440 —— roy-agent 接入 task-service 时，service 后端
+ *              （Task #5443）已扩展 owner 字段，core 侧必须同源，
+ *              否则 remote 模式的 owner 写不进去、读不回来。
+ *
+ * 语义：
+ * - `owner TEXT`（NULL 表示未指派）—— 刻意**不**加 NOT NULL DEFAULT ''，
+ *   因为「未指派」与「指派给空字符串」在业务上是两件事，null 更准确。
+ * - 加索引 `idx_task_owner`（按负责人筛任务是主要用法）。
+ *
+ * 幂等：重复执行安全（列已存在则跳过）。
+ *
+ * Date: 2026-11-13
+ */
+/**
+ * Run migration 006 on the given database file.
+ *
+ * @param dbPath SQLite database file path
+ */
+export declare function runMigration(dbPath: string): void;

package/dist/env/task/storage/remote-task-store.d.ts

@@ -0,0 +1,186 @@
+/**
+ * @fileoverview RemoteTaskStore — 把 `TaskStore` 做成一个 HTTP 客户端
+ *
+ * Task #5440（方案 v3 §4.2 / M2）。roy-agent 的 task 存储除了本地 SQLite，
+ * 还可以指向常驻的 **task-service**（`/home/dzk/work/codework/personal/roy_world/roy-task-service`）。
+ *
+ * ## 契约
+ *
+ * - 服务端 `POST /store/<method>`：`TaskStore` 方法 **1:1 映射**，body 为
+ *   `{ "args": [...] }`（多参方法按位置透传），响应体就是方法的返回值。
+ * - 鉴权：`Authorization: Bearer <token>`。
+ * - 幂等：**写方法**带 `Idempotency-Key`。同一逻辑调用重试时**复用同一个 key**
+ *   （服务端重放缓存，避免重试造成重复写入）；不同调用必须用不同 key。
+ * - 握手：首次调用前 `GET /version` 校验 `protocol.major`，不匹配即明确报错
+ *   （不静默降级 —— 方案 §1.3 非目标：**无本地 fallback**）。
+ *
+ * ## 故障语义（方案 §5.3）
+ *
+ * | 情况 | 处理 |
+ * |---|---|
+ * | 401 | `RemoteAuthError`，**不重试**（token 错，重试无用） |
+ * | 409 IDEMPOTENCY_CONFLICT | `RemoteIdempotencyConflictError`，**不重试** |
+ * | 400 VALIDATION | 明确报错（payload 错） |
+ * | 404 METHOD_NOT_FOUND | `RemoteProtocolError`（服务端版本过旧） |
+ * | 503 BUSY | sqlite 单连接 batch 事务占用 → 有界重试，超限 `RemoteBatchBusyError` |
+ * | 5xx / 超时 / 网络错 | 有界重试（写方法靠幂等 key 保证重放安全） |
+ *
+ * 所有错误信息都带 endpoint 与排障指引，绝不悄悄退回本地库。
+ */
+import type { TaskStore } from "./sqlite-task-store";
+import type { ListTagsOptions, SearchTagsOptions } from "../tag-service";
+import type { CreateOperationOptions, CreateTaskOptions, ListOperationsOptions, ListTasksOptions, SearchTasksOptions, Task, TaskListResult, TaskOperation, TaskTag, UpdateTaskOptions } from "../types";
+/** 远端 task-service 的基础错误（带 endpoint，便于排障）。 */
+export declare class RemoteTaskStoreError extends Error {
+    readonly endpoint: string;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, endpoint: string, cause?: unknown | undefined);
+}
+/** Bearer token 缺失/失效（401）。**不重试**。 */
+export declare class RemoteAuthError extends RemoteTaskStoreError {
+}
+/** 幂等 key 被不同 payload 复用（409 IDEMPOTENCY_CONFLICT）。**不重试**。 */
+export declare class RemoteIdempotencyConflictError extends RemoteTaskStoreError {
+}
+/**
+ * sqlite 后端的 batch 事务独占单连接，期间普通请求被拒（503 BUSY）。
+ *
+ * 重试后仍失败才抛这个 —— 调用方可以据此选择「稍后再试」还是报错。
+ */
+export declare class RemoteBatchBusyError extends RemoteTaskStoreError {
+}
+/** 协议不兼容（major 版本不一致 / 服务端不认识该方法）。**不重试**。 */
+export declare class RemoteProtocolError extends RemoteTaskStoreError {
+}
+/**
+ * 服务端 `TASK_STORE_METHODS` 白名单的**本地副本**。
+ *
+ * 用途：握手时对齐协议面（服务端白名单变化 = 协议变化），以及让
+ * `RemoteTaskStore` 的方法集有单一可断言的来源（测试可对照）。
+ * ⚠️ 与 roy-task-service `packages/backend/src/types.ts` 的
+ * `TASK_STORE_METHODS` 必须保持一致。
+ */
+export declare const REMOTE_TASK_STORE_METHODS: readonly ["createTask", "getTask", "updateTask", "deleteTask", "listTasks", "getTaskIdBySessionId", "getTaskIdsBySessionId", "createOperation", "getOperation", "updateOperation", "deleteOperation", "listOperations", "listOperationsFresh", "invalidateOperationsCache", "createTag", "getTag", "getTagByName", "listTags", "searchTags", "deleteTag", "addTagsToTask", "removeTagsFromTask", "getTagsForTask", "getTaskIdsByTags", "updateTaskTags", "searchTasksByKeywords", "findSimilarTasksByKeywords", "getTaskTree", "getChildTasks", "findSimilarTasks", "searchTasks", "findTasksByContextValue"];
+/** 本 client 支持的协议 major（与服务端 `PROTOCOL_VERSION.major` 对齐）。 */
+export declare const REMOTE_PROTOCOL_MAJOR = 1;
+/**
+ * 裁掉参数数组**尾部**的 `null` / `undefined`。
+ *
+ * 为什么只裁尾部：位置参数中间的空位有语义（`updateTask(7, null)` 的 null 是
+ * 「要改的那个值」），只有尾部才是「调用方没传」的表达。裁掉后服务端才会
+ * 用它自己的默认参数。
+ *
+ * ⚠️ 不能按 falsy 裁：`limit: 0` / `offset: 0` / `""` 都是调用方的显式意图。
+ */
+export declare function trimTrailingNullish(args: unknown[]): unknown[];
+/** 只用到 warning/debug 两档（避免把整个 logger 类型泄漏到公开 API）。 */
+export interface RemoteLogger {
+    warn?(message: string): void;
+    debug?(message: string): void;
+}
+export interface RemoteTaskStoreOptions {
+    /** service 地址，如 `http://127.0.0.1:7820`（末尾斜杠可有可无）。 */
+    endpoint: string;
+    /** Bearer token；service 未配置 token 时留空。 */
+    authToken?: string;
+    /** 单请求超时（毫秒），默认 5000。 */
+    timeoutMs?: number;
+    /** 可重试失败的最大**重试**次数（不含首次），默认 3。 */
+    maxRetries?: number;
+    /** 重试退避基数（毫秒），第 n 次重试等 `base * 2^n`，默认 200。 */
+    retryBaseDelayMs?: number;
+    /** 注入 fetch（测试/自定义传输）。 */
+    fetchImpl?: typeof fetch;
+    /** 注入 logger（默认用 core logger）。 */
+    log?: RemoteLogger;
+}
+export interface RemoteTaskStoreStats {
+    /** /version 握手次数（正常为 1；重连后可增加）。 */
+    handshakes: number;
+    /** 累计请求数（含重试）。 */
+    requests: number;
+    /** 累计重试次数。 */
+    retries: number;
+}
+export declare class RemoteTaskStore implements TaskStore {
+    private readonly endpoint;
+    private readonly authToken?;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly retryBaseDelayMs;
+    private readonly fetchImpl;
+    private readonly log;
+    private readonly stats;
+    private handshake?;
+    private closed;
+    constructor(options: RemoteTaskStoreOptions);
+    /** 诊断用统计（联调/健康检查）。 */
+    getStats(): Readonly<RemoteTaskStoreStats>;
+    private ensureOpen;
+    /** `/version` 握手（只做一次；失败则下次调用重试）。 */
+    private ensureHandshake;
+    private doHandshake;
+    private fetchWithTimeout;
+    /** 分类：该错误值得重试吗？ */
+    private isRetryableStatus;
+    /**
+     * 一次逻辑调用 = 一次 `POST /store/<method>`，内含**有界重试**。
+     *
+     * @param method TaskStore 方法名
+     * @param args   按位置透传的实参
+     */
+    private call;
+    createTask(options: CreateTaskOptions): Promise<Task>;
+    getTask(id: number): Promise<Task | undefined>;
+    updateTask(id: number, options: UpdateTaskOptions): Promise<Task | undefined>;
+    deleteTask(id: number): Promise<boolean>;
+    listTasks(options?: ListTasksOptions): Promise<TaskListResult>;
+    getTaskIdBySessionId(sessionId: string): Promise<number | undefined>;
+    getTaskIdsBySessionId(sessionId: string): Promise<number[]>;
+    createOperation(options: CreateOperationOptions): Promise<TaskOperation>;
+    getOperation(id: number): Promise<TaskOperation | undefined>;
+    updateOperation(id: number, updates: Parameters<TaskStore["updateOperation"]>[1]): Promise<TaskOperation | undefined>;
+    deleteOperation(id: number): Promise<boolean>;
+    listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /** optional — 绕过缓存直读（跨进程写入可见）。 */
+    listOperationsFresh(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * optional — 失效 operations 缓存。
+     *
+     * 接口签名是**同步 void**，而远端失效必然是一次网络调用：这里
+     * fire-and-forget（不阻塞调用方，失败仅 WARN）。服务端缓存只在 service
+     * 进程内，失效语义"尽力而为"即可 —— 真正需要新鲜数据时用
+     * `listOperationsFresh`。
+     */
+    invalidateOperationsCache(taskId: number): void;
+    createTag(name: string): Promise<TaskTag>;
+    getTag(id: number): Promise<TaskTag | undefined>;
+    getTagByName(name: string): Promise<TaskTag | undefined>;
+    listTags(options?: ListTagsOptions): Promise<TaskTag[]>;
+    searchTags(options: SearchTagsOptions): Promise<TaskTag[]>;
+    deleteTag(id: number): Promise<boolean>;
+    addTagsToTask(taskId: number, tagIds: number[]): Promise<void>;
+    removeTagsFromTask(taskId: number, tagIds: number[]): Promise<void>;
+    getTagsForTask(taskId: number): Promise<TaskTag[]>;
+    getTaskIdsByTags(tagNames: string[]): Promise<number[]>;
+    updateTaskTags(taskId: number, tagNames: string[]): Promise<void>;
+    searchTasksByKeywords(keywords: string[], options?: SearchTasksOptions): Promise<TaskListResult>;
+    findSimilarTasksByKeywords(keywords: string[], options?: {
+        limit?: number;
+        excludeTaskId?: number;
+    }): Promise<Task[]>;
+    getTaskTree(taskId: number, depth?: number): Promise<Task[]>;
+    getChildTasks(taskId: number, options?: ListTasksOptions): Promise<TaskListResult>;
+    findSimilarTasks(taskId: number, limit?: number): Promise<Task[]>;
+    searchTasks(query: string, limit?: number): Promise<Task[]>;
+    findTasksByContextValue(value: string, limit?: number): Promise<Task[]>;
+    /**
+     * 关闭 client（幂等）。
+     *
+     * 与本地 store 不同：**没有连接需要释放**，只是把实例标记为已关闭，
+     * 后续调用立即报错（避免组件被 dispose 后仍有请求飞出去）。
+     */
+    close(): void;
+}
+/** 便捷工厂（与 `createSQLiteTaskPort` 对称）。 */
+export declare function createRemoteTaskStore(options: RemoteTaskStoreOptions): RemoteTaskStore;

package/dist/env/task/task-component.d.ts

@@ -115,6 +115,13 @@ export declare class TaskComponent extends BaseComponent {
      * 根据配置初始化 store
      */
     private initStore;
+    /**
+     * 按配置**构造**（不安装）一个 store。
+     *
+     * 单独抽出来是为了让 `initStore` 能「先构造后安装」——构造失败时旧 store
+     * 保持原样（CV MAJOR-2）。
+     */
+    private buildStore;
     /**
      * 将配置对象展平为点号路径
      */

package/dist/env/task/tools/index.js

@@ -11,7 +11,7 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-qwd2dq5q.js";
+} from "../../../shared/@ai-setting/roy-agent-core-9cen1jvg.js";
 import"../../../shared/@ai-setting/roy-agent-core-d6zdbgtc.js";
 import"../../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
 import"../../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";

package/dist/env/task/tools/task-types.d.ts

@@ -29,6 +29,7 @@ export declare const CreateTaskToolSchema: z.ZodObject<{
     project_path: z.ZodDefault<z.ZodString>;
     parent_task_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
     context: z.ZodDefault<z.ZodString>;
+    owner: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
 }, "strip", z.ZodTypeAny, {
     type: "normal" | "cycle" | "longterm";
     title: string;
@@ -40,6 +41,7 @@ export declare const CreateTaskToolSchema: z.ZodObject<{
     goals_and_expected_deliverables?: string | undefined;
     due_date?: string | undefined;
     parent_task_id?: number | null | undefined;
+    owner?: string | null | undefined;
 }, {
     title: string;
     type?: "normal" | "cycle" | "longterm" | undefined;
@@ -51,6 +53,7 @@ export declare const CreateTaskToolSchema: z.ZodObject<{
     project_path?: string | undefined;
     parent_task_id?: number | null | undefined;
     context?: string | undefined;
+    owner?: string | null | undefined;
 }>;
 export type CreateTaskToolParams = z.infer<typeof CreateTaskToolSchema>;
 /**
@@ -166,6 +169,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
     project_path: z.ZodOptional<z.ZodString>;
     context: z.ZodOptional<z.ZodString>;
     parent_task_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
+    owner: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
 }, "strip", z.ZodTypeAny, {
     task_id: number;
     type?: "normal" | "cycle" | "longterm" | undefined;
@@ -180,6 +184,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
     project_path?: string | undefined;
     parent_task_id?: number | null | undefined;
     context?: string | undefined;
+    owner?: string | null | undefined;
     current_status?: string | undefined;
 }, {
     task_id: number;
@@ -195,6 +200,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
     project_path?: string | undefined;
     parent_task_id?: number | null | undefined;
     context?: string | undefined;
+    owner?: string | null | undefined;
     current_status?: string | undefined;
 }>, {
     task_id: number;
@@ -210,6 +216,7 @@ export declare const UpdateTaskToolSchema: z.ZodEffects<z.ZodObject<{
     project_path?: string | undefined;
     parent_task_id?: number | null | undefined;
     context?: string | undefined;
+    owner?: string | null | undefined;
     current_status?: string | undefined;
 }, unknown>;
 export type UpdateTaskToolParams = z.infer<typeof UpdateTaskToolSchema>;

package/dist/env/task/types.d.ts

@@ -59,6 +59,16 @@ export interface Task {
     project_path: string;
     /** JSON string with time-space positioning info (worktree, branch, etc.) */
     context: string;
+    /**
+     * 负责人（Task #5440）。
+     *
+     * 语义：这个任务的**人**（open_id / 用户名 / 邮箱，字符串，core 不解释格式）。
+     * - 可空：`null` 表示未指派（新建任务的默认值）
+     * - 多人协作场景下用来区分「谁在负责推进」，与 `sessionId`（谁在操作）
+     *   和 `project_path`（在哪个项目）正交
+     * - 与 task-service 后端的 `owner` 列同源，remote 模式下原样落库
+     */
+    owner?: string | null;
 }
 /**
  * TaskOperation entity — 双维度操作记录（Task #2211 重构后版本）
@@ -171,6 +181,8 @@ export interface CreateTaskOptions {
      * Must be a valid JSON string.
      */
     context: string;
+    /** 负责人（可选，不传即 null；参见 Task.owner）。 */
+    owner?: string | null;
 }
 export interface UpdateTaskOptions {
     title?: string;
@@ -187,6 +199,11 @@ export interface UpdateTaskOptions {
     project_path?: string;
     /** 任务上下文信息，用于存储额外上下文 */
     context?: string;
+    /**
+     * 负责人（可选）。传 `null` 或 `""` 表示清空；传字符串表示改为该负责人；
+     * **字段省略**表示不改（与 status/progress 等字段语义一致）。
+     */
+    owner?: string | null;
     /** 父任务 ID，null = 设为根任务（无父任务） */
     parent_task_id?: number | null;
 }

package/dist/env/workflow/plugins/index.js

@@ -1,10 +1,10 @@
 import {
   LarkCliWorkflowNotifyHook,
   createLarkCliWorkflowNotifyHook
-} from "../../../shared/@ai-setting/roy-agent-core-wr1qexzq.js";
-import"../../../shared/@ai-setting/roy-agent-core-shb1qsyg.js";
+} from "../../../shared/@ai-setting/roy-agent-core-5dhvfgaw.js";
+import"../../../shared/@ai-setting/roy-agent-core-0n1wwndq.js";
 import"../../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
-import"../../../shared/@ai-setting/roy-agent-core-6k8mb7zx.js";
+import"../../../shared/@ai-setting/roy-agent-core-m66ysky0.js";
 import"../../../shared/@ai-setting/roy-agent-core-h83zdsrq.js";
 import"../../../shared/@ai-setting/roy-agent-core-smf94h73.js";
 import"../../../shared/@ai-setting/roy-agent-core-yet36q5k.js";

package/dist/index.d.ts

@@ -31,7 +31,7 @@ export { cascadeStopSessionTree, type CascadeStopOptions, type CascadeStopResult
 export { createMemoryAgentTools, } from "./env/memory/tools/memory-agent-tools";
 export type { SearchSessionsParams, GetSessionParams, WriteMemoryParams, } from "./env/memory/tools/memory-agent-tools";
 export { getBuiltInPrompt, getBuiltInPromptNames, } from "./env/prompt/prompts-index";
-export { TaskComponent, SQLiteTaskStore, getDefaultTaskDbPath, TASK_COMPLETED_STATUS_WORD, TASK_CANCELLED_STATUS_WORD, TASK_ARCHIVED_STATUS_WORD, TASK_DELIVERABLE_RECORDED, } from "./env/task";
+export { TaskComponent, SQLiteTaskStore, RemoteTaskStore, createRemoteTaskStore, getDefaultTaskDbPath, TASK_COMPLETED_STATUS_WORD, TASK_CANCELLED_STATUS_WORD, TASK_ARCHIVED_STATUS_WORD, TASK_DELIVERABLE_RECORDED, } from "./env/task";
 export type { Task, TaskOperation, TaskStatus, TaskPriority, ActionType, CreateTaskOptions, UpdateTaskOptions, ListTasksOptions, CreateOperationOptions, ListOperationsOptions, TaskConfig, } from "./env/task/types";
 export { TaskTagPlugin, createAutoTaskPlugin, type AutoTaskPluginConfig, } from "./env/task/plugins";
 export { TaskHookPoints, type TaskHookPoint, } from "./env/task/hooks";

package/dist/index.js

@@ -62,21 +62,25 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-an35dzbf.js";
+} from "./shared/@ai-setting/roy-agent-core-dvec4nn2.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-fan8g0z1.js";
+} from "./shared/@ai-setting/roy-agent-core-49qcpqwg.js";
 import"./shared/@ai-setting/roy-agent-core-2akfd64z.js";
 import"./shared/@ai-setting/roy-agent-core-jm136jzh.js";
 import"./shared/@ai-setting/roy-agent-core-0sbmdz8d.js";
 import"./shared/@ai-setting/roy-agent-core-fttgm52a.js";
-import"./shared/@ai-setting/roy-agent-core-vpcxv1ty.js";
+import"./shared/@ai-setting/roy-agent-core-05z35shp.js";
+import {
+  RemoteTaskStore,
+  createRemoteTaskStore
+} from "./shared/@ai-setting/roy-agent-core-zhwcje5a.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-qwd2dq5q.js";
+import"./shared/@ai-setting/roy-agent-core-9cen1jvg.js";
 import"./shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
 import {
   EventSourceComponent
-} from "./shared/@ai-setting/roy-agent-core-yh68z1bg.js";
+} from "./shared/@ai-setting/roy-agent-core-m7d1t3db.js";
 import {
   BountyIMInstance,
   COMMAND_PREFIX,
@@ -131,7 +135,7 @@ import {
   translateCardActionToCommand,
   wecomCliHandler,
   writeFallbackModelList
-} from "./shared/@ai-setting/roy-agent-core-gr5h1dyr.js";
+} from "./shared/@ai-setting/roy-agent-core-4b38m749.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -148,7 +152,7 @@ import {
   cliCommandHandler,
   parseCliSessionChatId
 } from "./shared/@ai-setting/roy-agent-core-v0hf14bj.js";
-import"./shared/@ai-setting/roy-agent-core-7kvpc0w5.js";
+import"./shared/@ai-setting/roy-agent-core-age3qseb.js";
 import {
   LogTraceComponent,
   LogTraceConfigSchema
@@ -157,7 +161,7 @@ import"./shared/@ai-setting/roy-agent-core-2stt4rp5.js";
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-ra66sf50.js";
+} from "./shared/@ai-setting/roy-agent-core-k3h8t4q1.js";
 import"./shared/@ai-setting/roy-agent-core-h1e1fm9b.js";
 import"./shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
 import {
@@ -187,13 +191,13 @@ import {
   TASK_COMPLETED_STATUS_WORD,
   TASK_DELIVERABLE_RECORDED
 } from "./shared/@ai-setting/roy-agent-core-4rtg69cn.js";
-import"./shared/@ai-setting/roy-agent-core-wr1qexzq.js";
-import"./shared/@ai-setting/roy-agent-core-shb1qsyg.js";
+import"./shared/@ai-setting/roy-agent-core-5dhvfgaw.js";
+import"./shared/@ai-setting/roy-agent-core-0n1wwndq.js";
 import"./shared/@ai-setting/roy-agent-core-418zc9ha.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
-} from "./shared/@ai-setting/roy-agent-core-6k8mb7zx.js";
+} from "./shared/@ai-setting/roy-agent-core-m66ysky0.js";
 import {
   WorkflowComponent
 } from "./shared/@ai-setting/roy-agent-core-n197medr.js";
@@ -688,6 +692,7 @@ export {
   embedParamFilter,
   editFileTool,
   createWorkflowFromClass,
+  createRemoteTaskStore,
   createPriorityHook,
   createMemoryPlugin,
   createMemoryAgentTools,
@@ -749,6 +754,7 @@ export {
   SQLiteSpanStorage,
   RoyError,
   ReplFormatter,
+  RemoteTaskStore,
   ProviderConfigSchema,
   ProviderCapabilitiesSchema,
   PromptStore,

package/dist/shared/@ai-setting/{roy-agent-core-vpcxv1ty.js → roy-agent-core-05z35shp.js}

@@ -1,6 +1,6 @@
 import {
   init_sqlite_task_store
-} from "./roy-agent-core-6k8mb7zx.js";
+} from "./roy-agent-core-m66ysky0.js";
 
 // src/env/task/storage/index.ts
 init_sqlite_task_store();

package/dist/shared/@ai-setting/{roy-agent-core-shb1qsyg.js → roy-agent-core-0n1wwndq.js}

@@ -5,7 +5,7 @@ import {
 import {
   createCompatibleDatabase,
   init_sqlite_task_store
-} from "./roy-agent-core-6k8mb7zx.js";
+} from "./roy-agent-core-m66ysky0.js";
 import {
   TracedAs,
   init_decorator

package/dist/shared/@ai-setting/{roy-agent-core-fan8g0z1.js → roy-agent-core-49qcpqwg.js}

@@ -10,6 +10,9 @@ import {
   BackgroundTaskManager,
   createDelegateTool
 } from "./roy-agent-core-0sbmdz8d.js";
+import {
+  RemoteTaskStore
+} from "./roy-agent-core-zhwcje5a.js";
 import {
   TaskEntityEventTypes
 } from "./roy-agent-core-8gxth0eh.js";
@@ -26,7 +29,7 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "./roy-agent-core-qwd2dq5q.js";
+} from "./roy-agent-core-9cen1jvg.js";
 import {
   createOperationTool,
   deleteOperationTool,
@@ -50,7 +53,7 @@ import {
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
-} from "./roy-agent-core-6k8mb7zx.js";
+} from "./roy-agent-core-m66ysky0.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";
@@ -83,7 +86,9 @@ init_logger();
 // src/env/task/task-config-registration.ts
 var TASK_DEFAULTS = {
   "task.storage.type": "sqlite",
-  "task.storage.dbPath": undefined
+  "task.storage.dbPath": undefined,
+  "task.storage.endpoint": undefined,
+  "task.storage.authToken": undefined
 };
 var TASK_CONFIG_REGISTRATION = {
   name: "task",
@@ -92,7 +97,9 @@ var TASK_CONFIG_REGISTRATION = {
   ],
   keys: [
     { key: "task.storage.type", sources: ["env", "file"] },
-    { key: "task.storage.dbPath", sources: ["env", "file"] }
+    { key: "task.storage.dbPath", sources: ["env", "file"] },
+    { key: "task.storage.endpoint", sources: ["env", "file"] },
+    { key: "task.storage.authToken", sources: ["env", "file"] }
   ]
 };
 
@@ -305,14 +312,40 @@ class TaskComponent extends BaseComponent {
       return;
     const storageType = configComponent.get("task.storage.type") ?? "sqlite";
     const dbPath = configComponent.get("task.storage.dbPath");
-    if (storageType === "sqlite") {
-      this.store = new SQLiteTaskStore(dbPath);
+    const previous = this.store;
+    const nextStore = this.buildStore(storageType, dbPath);
+    if (previous) {
+      try {
+        previous.close();
+      } catch (e) {
+        logger2.warn(`[TaskComponent] Failed to close previous store: ${e instanceof Error ? e.message : String(e)}`);
+      }
+    }
+    this.store = nextStore;
+    this.tagService = new DefaultTagService(this.store);
+    if (storageType === "remote") {
+      const endpoint = configComponent.get("task.storage.endpoint");
+      logger2.info(`[TaskComponent] Using remote task-service: ${endpoint}` + `${configComponent.get("task.storage.authToken") ? " (with bearer token)" : " (no auth token)"}`);
+    } else if (storageType === "sqlite") {
       logger2.info(`[TaskComponent] Using SQLite storage: ${dbPath || "default path"}`);
-    } else {
-      this.store = new SQLiteTaskStore;
-      logger2.info("[TaskComponent] Using SQLite storage (default)");
     }
   }
+  buildStore(storageType, dbPath) {
+    const configComponent = this.configComponent;
+    if (storageType === "remote") {
+      const endpoint = configComponent?.get("task.storage.endpoint");
+      const authToken = configComponent?.get("task.storage.authToken");
+      if (!endpoint) {
+        throw new Error("[TaskComponent] task.storage.type=remote requires task.storage.endpoint " + "(e.g. http://127.0.0.1:7820). Set task.storage.endpoint and task.storage.authToken " + "to match the running roy-task-service. No local fallback is performed by design.");
+      }
+      return new RemoteTaskStore({ endpoint, authToken });
+    }
+    if (storageType === "sqlite") {
+      return new SQLiteTaskStore(dbPath);
+    }
+    logger2.warn(`[TaskComponent] Unknown task.storage.type="${String(storageType)}", ` + `falling back to default SQLite storage. Supported: "sqlite" | "remote".`);
+    return new SQLiteTaskStore;
+  }
   flattenConfig(obj, prefix = "task") {
     const result = {};
     for (const [key, value] of Object.entries(obj)) {
@@ -338,8 +371,10 @@ class TaskComponent extends BaseComponent {
       oldValue: event.oldValue,
       newValue: event.newValue
     });
-    if (event.key === "task.storage.type" || event.key === "task.storage.dbPath") {
-      this.initStore();
+    if (event.key === "task.storage.type" || event.key === "task.storage.dbPath" || event.key === "task.storage.endpoint" || event.key === "task.storage.authToken") {
+      Promise.resolve(this.initStore()).catch((e) => {
+        logger2.error(`[TaskComponent] Failed to re-init store after ${event.key} change: ` + `${e instanceof Error ? e.message : String(e)} (keeping previous store)`);
+      });
     }
   }
   configWatcher;

package/dist/shared/@ai-setting/{roy-agent-core-gr5h1dyr.js → roy-agent-core-4b38m749.js}

@@ -6,7 +6,7 @@ import {
 } from "./roy-agent-core-v0hf14bj.js";
 import {
   getSharedWecomSessionCardStore
-} from "./roy-agent-core-7kvpc0w5.js";
+} from "./roy-agent-core-age3qseb.js";
 import {
   guardConfigWrite
 } from "./roy-agent-core-2stt4rp5.js";
@@ -19,7 +19,7 @@ import {
   createWecomTaskNotifyHook,
   deleteGroupChatViaLarkCli,
   handleCardAction
-} from "./roy-agent-core-ra66sf50.js";
+} from "./roy-agent-core-k3h8t4q1.js";
 import {
   registerWecomRespondTarget,
   sendWecomCliMarkdown,
@@ -37,12 +37,12 @@ import {
 } from "./roy-agent-core-4t3yskp8.js";
 import {
   createLarkCliWorkflowNotifyHook
-} from "./roy-agent-core-wr1qexzq.js";
+} from "./roy-agent-core-5dhvfgaw.js";
 import {
   DEFAULT_APP_LINK_BASE,
   getSharedLarkCardNotifier,
   getSharedLarkCardStateStore
-} from "./roy-agent-core-shb1qsyg.js";
+} from "./roy-agent-core-0n1wwndq.js";
 import {
   RECENT_MESSAGE_LIMIT,
   createActivityProbe,

package/dist/shared/@ai-setting/{roy-agent-core-wr1qexzq.js → roy-agent-core-5dhvfgaw.js}

@@ -1,7 +1,7 @@
 import {
   LarkCardPatchNotifier,
   formatDurationMs
-} from "./roy-agent-core-shb1qsyg.js";
+} from "./roy-agent-core-0n1wwndq.js";
 import {
   WorkflowHookPoints,
   init_workflow_hook_points