@ai-setting/roy-agent-core 1.7.59 → 1.7.62

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

@@ -1,21 +1,23 @@
+import {
+  createStopTool
+} from "../../../shared/@ai-setting/roy-agent-core-jm136jzh.js";
 import {
   BackgroundTaskEventTypes,
   BackgroundTaskManager,
-  createDelegateTool,
-  createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-6bradb0j.js";
-import"../../../shared/@ai-setting/roy-agent-core-14bq77wr.js";
-import"../../../shared/@ai-setting/roy-agent-core-2ctyjy62.js";
+  createDelegateTool
+} from "../../../shared/@ai-setting/roy-agent-core-fqandv0a.js";
+import"../../../shared/@ai-setting/roy-agent-core-jw63js86.js";
+import"../../../shared/@ai-setting/roy-agent-core-a08dpf71.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-6masakz4.js";
-import"../../../shared/@ai-setting/roy-agent-core-ygn5tzt1.js";
+import"../../../shared/@ai-setting/roy-agent-core-06jakebr.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
-import"../../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
-import"../../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
-import"../../../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+import"../../../shared/@ai-setting/roy-agent-core-v7mwj8eq.js";
+import"../../../shared/@ai-setting/roy-agent-core-33hn1beg.js";
+import"../../../shared/@ai-setting/roy-agent-core-hfyxv2kx.js";
+import"../../../shared/@ai-setting/roy-agent-core-386wa4wy.js";
+import"../../../shared/@ai-setting/roy-agent-core-6awgfh3x.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/task/index.js

@@ -5,34 +5,35 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-991pk4ss.js";
+} from "../../shared/@ai-setting/roy-agent-core-cqpd41gf.js";
 import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
-import"../../shared/@ai-setting/roy-agent-core-7q4wdze2.js";
-import"../../shared/@ai-setting/roy-agent-core-vh0qzb24.js";
-import"../../shared/@ai-setting/roy-agent-core-rn57psp0.js";
+import"../../shared/@ai-setting/roy-agent-core-jm136jzh.js";
+import"../../shared/@ai-setting/roy-agent-core-fqandv0a.js";
+import"../../shared/@ai-setting/roy-agent-core-jw63js86.js";
+import"../../shared/@ai-setting/roy-agent-core-5mrynf9g.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-6bradb0j.js";
-import"../../shared/@ai-setting/roy-agent-core-14bq77wr.js";
+import"../../shared/@ai-setting/roy-agent-core-as0dd70m.js";
+import"../../shared/@ai-setting/roy-agent-core-rn57psp0.js";
+import"../../shared/@ai-setting/roy-agent-core-a08dpf71.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
-} from "../../shared/@ai-setting/roy-agent-core-fbjd7bt6.js";
-import"../../shared/@ai-setting/roy-agent-core-2ctyjy62.js";
+} from "../../shared/@ai-setting/roy-agent-core-th92f833.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-6masakz4.js";
-import"../../shared/@ai-setting/roy-agent-core-ygn5tzt1.js";
+import"../../shared/@ai-setting/roy-agent-core-06jakebr.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-0kn3zt1t.js";
-import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
-import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
-import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
-import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
-import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+import"../../shared/@ai-setting/roy-agent-core-gtdtzbs7.js";
+import"../../shared/@ai-setting/roy-agent-core-7tce05jt.js";
+import"../../shared/@ai-setting/roy-agent-core-v7mwj8eq.js";
+import"../../shared/@ai-setting/roy-agent-core-33hn1beg.js";
+import"../../shared/@ai-setting/roy-agent-core-hfyxv2kx.js";
+import"../../shared/@ai-setting/roy-agent-core-386wa4wy.js";
+import"../../shared/@ai-setting/roy-agent-core-6awgfh3x.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/task/mcp/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Task MCP Server — public entry point.
+ *
+ * Task #4619 — 让「roy 拥有全部逻辑，插件只是薄的一层」在 MCP 侧成立。
+ *
+ * ```ts
+ * import { createTaskMcpServer } from "@ai-setting/roy-agent-core/env/task/mcp";
+ * import { TaskStoreBackend, createSQLiteTaskPort } from "@ai-setting/roy-agent-core/env/task/backend";
+ *
+ * const server = createTaskMcpServer(new TaskStoreBackend(createSQLiteTaskPort()));
+ * ```
+ *
+ * 宿主只负责「把字节接上」；工具清单、JSON Schema、task 语义、错误封装
+ * 全在 core。
+ */
+export { createTaskMcpServer, createTaskMcpToolDefinitions, negotiateTaskMcpProtocolVersion, toJsonSchemaDocument, TASK_MCP_TOOL_NAMES, TASK_MCP_SUPPORTED_PROTOCOL_VERSIONS, TASK_MCP_DEFAULT_PROTOCOL_VERSION, TASK_MCP_JSON_RPC_ERRORS, type TaskMcpToolName, type TaskMcpToolDefinition, type TaskMcpServerOptions, type TaskMcpServer, type TaskMcpRequest, type TaskMcpResponse, } from "./task-mcp-server";

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

@@ -0,0 +1,222 @@
+import {
+  completeTaskTool,
+  createTaskTool,
+  getTaskTool,
+  listTasksTool,
+  searchTasksTool,
+  treeTasksTool,
+  updateTaskTool
+} from "../../../shared/@ai-setting/roy-agent-core-as0dd70m.js";
+import {
+  createOperationTool,
+  listOperationsTool
+} from "../../../shared/@ai-setting/roy-agent-core-rn57psp0.js";
+import"../../../shared/@ai-setting/roy-agent-core-hfyxv2kx.js";
+import"../../../shared/@ai-setting/roy-agent-core-386wa4wy.js";
+import"../../../shared/@ai-setting/roy-agent-core-6awgfh3x.js";
+import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
+import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
+
+// src/env/task/mcp/task-mcp-server.ts
+import { zodToJsonSchema } from "zod-to-json-schema";
+var TASK_MCP_TOOL_NAMES = [
+  "task_create",
+  "task_tree",
+  "task_get",
+  "task_list",
+  "task_search",
+  "task_update",
+  "task_complete",
+  "task_operation_create",
+  "task_operation_list"
+];
+var TASK_MCP_JSON_RPC_ERRORS = Object.freeze({
+  PARSE_ERROR: -32700,
+  INVALID_REQUEST: -32600,
+  METHOD_NOT_FOUND: -32601,
+  INVALID_PARAMS: -32602,
+  INTERNAL_ERROR: -32603
+});
+var TASK_MCP_SUPPORTED_PROTOCOL_VERSIONS = Object.freeze([
+  "2025-11-25",
+  "2025-06-18",
+  "2025-03-26",
+  "2024-11-05",
+  "2024-10-07"
+]);
+var TASK_MCP_DEFAULT_PROTOCOL_VERSION = "2025-11-25";
+var TASK_TOOL_FACTORIES = [
+  createTaskTool,
+  treeTasksTool,
+  getTaskTool,
+  listTasksTool,
+  searchTasksTool,
+  updateTaskTool,
+  completeTaskTool,
+  createOperationTool,
+  listOperationsTool
+];
+function toJsonSchemaDocument(parameters) {
+  const p = parameters;
+  if (!p)
+    return {};
+  const target = p.shape ? p : p._def?.schema ?? p;
+  try {
+    const doc = zodToJsonSchema(target, {
+      target: "jsonSchema7",
+      $refStrategy: "none",
+      effectStrategy: "input"
+    });
+    const { $schema: _ignored, ...rest } = doc;
+    return { type: "object", properties: {}, ...rest };
+  } catch {
+    return { type: "object", properties: {} };
+  }
+}
+function createTaskMcpToolDefinitions(backend) {
+  return TASK_TOOL_FACTORIES.map((factory) => {
+    const tool = factory(backend);
+    return {
+      name: tool.name,
+      description: tool.description,
+      inputSchema: toJsonSchemaDocument(tool.parameters)
+    };
+  });
+}
+function negotiateTaskMcpProtocolVersion(requested) {
+  if (requested && TASK_MCP_SUPPORTED_PROTOCOL_VERSIONS.includes(requested)) {
+    return requested;
+  }
+  return TASK_MCP_DEFAULT_PROTOCOL_VERSION;
+}
+function toolErrorText(message) {
+  return {
+    content: [{ type: "text", text: message }],
+    isError: true
+  };
+}
+function createTaskMcpServer(backend, options = {}) {
+  const name = options.name ?? "roy-task";
+  const version = options.version ?? "1.0.0";
+  const toolDefs = createTaskMcpToolDefinitions(backend);
+  const byName = new Map(toolDefs.map((d) => [d.name, d]));
+  const callTool = async (toolName, args) => {
+    const factory = TASK_TOOL_FACTORIES.find((f) => f(backend).name === toolName);
+    if (!factory) {
+      throw new Error(`unknown tool: ${toolName}`);
+    }
+    const tool = factory(backend);
+    const ctx = {
+      session_id: options.sessionId ?? "unknown",
+      workdir: options.workdir
+    };
+    const result = await tool.execute(args ?? {}, ctx);
+    const r = result;
+    if (r && r.success === false) {
+      throw new Error(r.error ?? `tool "${toolName}" failed`);
+    }
+    return r && "output" in r ? r.output : result;
+  };
+  const handleRequest = async (request) => {
+    const { id, method, params } = request;
+    if (id === undefined || id === null) {
+      return null;
+    }
+    switch (method) {
+      case "initialize": {
+        const requested = params?.protocolVersion;
+        return {
+          jsonrpc: "2.0",
+          id,
+          result: {
+            protocolVersion: negotiateTaskMcpProtocolVersion(typeof requested === "string" ? requested : undefined),
+            capabilities: { tools: {} },
+            serverInfo: { name, version }
+          }
+        };
+      }
+      case "server/discover": {
+        const meta = params?._meta;
+        const requested = meta?.["io.modelcontextprotocol/protocolVersion"];
+        return {
+          jsonrpc: "2.0",
+          id,
+          result: {
+            protocolVersion: negotiateTaskMcpProtocolVersion(typeof requested === "string" ? requested : undefined),
+            capabilities: { tools: {} },
+            serverInfo: { name, version }
+          }
+        };
+      }
+      case "ping":
+        return { jsonrpc: "2.0", id, result: {} };
+      case "tools/list":
+        return { jsonrpc: "2.0", id, result: { tools: toolDefs } };
+      case "tools/call": {
+        const toolName = params?.name;
+        const args = params?.arguments || {};
+        if (typeof toolName !== "string") {
+          return {
+            jsonrpc: "2.0",
+            id,
+            error: {
+              code: TASK_MCP_JSON_RPC_ERRORS.INVALID_PARAMS,
+              message: "tools/call requires a tool name"
+            }
+          };
+        }
+        if (!byName.has(toolName)) {
+          return {
+            jsonrpc: "2.0",
+            id,
+            error: {
+              code: TASK_MCP_JSON_RPC_ERRORS.INVALID_PARAMS,
+              message: `unknown tool: ${toolName}`
+            }
+          };
+        }
+        try {
+          const value = await callTool(toolName, args);
+          return {
+            jsonrpc: "2.0",
+            id,
+            result: {
+              content: [{ type: "text", text: JSON.stringify(value ?? null, null, 2) }]
+            }
+          };
+        } catch (err) {
+          const message = err instanceof Error ? err.message : `tool "${toolName}" failed: ${String(err)}`;
+          return {
+            jsonrpc: "2.0",
+            id,
+            result: toolErrorText(message)
+          };
+        }
+      }
+      default:
+        return {
+          jsonrpc: "2.0",
+          id,
+          error: {
+            code: TASK_MCP_JSON_RPC_ERRORS.METHOD_NOT_FOUND,
+            message: `method not found: ${method}`
+          }
+        };
+    }
+  };
+  return {
+    handleRequest,
+    listTools: () => toolDefs,
+    callTool
+  };
+}
+export {
+  toJsonSchemaDocument,
+  negotiateTaskMcpProtocolVersion,
+  createTaskMcpToolDefinitions,
+  createTaskMcpServer,
+  TASK_MCP_TOOL_NAMES,
+  TASK_MCP_SUPPORTED_PROTOCOL_VERSIONS,
+  TASK_MCP_JSON_RPC_ERRORS,
+  TASK_MCP_DEFAULT_PROTOCOL_VERSION
+};

package/dist/env/task/mcp/task-mcp-server.d.ts

@@ -0,0 +1,142 @@
+/**
+ * @fileoverview Task MCP Server — roy's task tools over MCP, reusable by any host.
+ *
+ * Task #4619 —「代码逻辑都在 roy-agent，插件只是薄的一层」的核心交付之一。
+ *
+ * ## 为什么 core 需要这个模块
+ *
+ * `roy-agent-core` 之前**只有 MCP client**（`packages/core/src/env/mcp/*`），
+ * 没有任何 server。结果每一个「MCP 说话」的宿主都得自己写一个 server，
+ * 而 server 之上还得自己实现一遍 task 语义 —— 于是出现了
+ * `roy-plugin-for-agent/claude/mcp/roy-task-mcp-server.mjs`（281 行）+
+ * `claude/mcp/bridge.mjs`（482 行裸 SQL）这套复刻。
+ *
+ * 本模块把「MCP 传输 + 工具装配」收进 core：
+ *
+ * ```
+ *   宿主（Claude Code / Codex / opencode / …）
+ *     └─ 只做一件事：new TaskMcpServer(backend) 并把 stdin/stdout 接上
+ *          └─ 工具定义、JSON Schema、语义、错误封装  ← 全在 core
+ * ```
+ *
+ * 语义本身来自 `TaskBackend`（= `TaskStoreBackend`），工具描述与参数 schema
+ * 来自 core 自己的工具工厂（`createTaskTool` / `treeTasksTool` / …），
+ * **不是**手抄的副本。
+ *
+ * ## 依赖注入
+ *
+ * 宿主提供 `TaskBackend`（`@ai-setting/roy-agent-core/env/task/backend`）：
+ *
+ * - 想读 roy 自己的库 → `createSQLiteTaskPort()` + `TaskStoreBackend`
+ * - 想用自己的库     → 实现 `TaskPersistencePort` + `TaskStoreBackend`
+ * - 已有 sidecar 词表 → `createRoySidecarTaskPort(store, vocabulary)`
+ *
+ * 三种都拿到**完全相同**的语义与工具面。
+ */
+import type { TaskBackend } from "../backend/types";
+/** The task tools exposed over MCP. */
+export declare const TASK_MCP_TOOL_NAMES: readonly ["task_create", "task_tree", "task_get", "task_list", "task_search", "task_update", "task_complete", "task_operation_create", "task_operation_list"];
+export type TaskMcpToolName = (typeof TASK_MCP_TOOL_NAMES)[number];
+/** An MCP tool definition (JSON Schema document — MCP requires JSON Schema). */
+export interface TaskMcpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/** JSON-RPC error codes used by this server. */
+export declare const TASK_MCP_JSON_RPC_ERRORS: Readonly<{
+    PARSE_ERROR: -32700;
+    INVALID_REQUEST: -32600;
+    METHOD_NOT_FOUND: -32601;
+    INVALID_PARAMS: -32602;
+    INTERNAL_ERROR: -32603;
+}>;
+/**
+ * MCP protocol versions this server understands.
+ *
+ * ⚠️ Task #4622 — `2025-11-25` was **missing** here.
+ *
+ * Task #4619 moved this contract into core but copied the list without the
+ * newest entry. That regressed the handshake in two ways:
+ *
+ * 1. `@modelcontextprotocol/sdk@1.29.0` (this repo's own dependency)
+ *    declares `LATEST_PROTOCOL_VERSION = '2025-11-25'` — a modern client
+ *    asks for exactly that version.
+ * 2. The **already published** plugin (`@ai-setting/roy-task-plugin@0.6.1`)
+ *    listed `2025-11-25` first and used it as its `DEFAULT_PROTOCOL_VERSION`.
+ *
+ * So core without it silently *downgraded* the negotiated version relative
+ * to the plugin release users already run. The list must stay a superset of
+ * the SDK's own list, newest first.
+ */
+export declare const TASK_MCP_SUPPORTED_PROTOCOL_VERSIONS: readonly string[];
+export declare const TASK_MCP_DEFAULT_PROTOCOL_VERSION = "2025-11-25";
+export interface TaskMcpServerOptions {
+    /** Server name reported in `initialize`. */
+    name?: string;
+    /** Server version reported in `initialize`. */
+    version?: string;
+    /** Session id stamped on created tasks / operations. */
+    sessionId?: string;
+    /** Working directory reported to tools that want one. */
+    workdir?: string;
+}
+/** A JSON-RPC request as it arrives on the wire. */
+export interface TaskMcpRequest {
+    jsonrpc?: string;
+    id?: number | string | null;
+    method?: string;
+    params?: Record<string, unknown>;
+}
+/** A JSON-RPC response. `null` means "no response" (notification). */
+export interface TaskMcpResponse {
+    jsonrpc: "2.0";
+    id: number | string | null;
+    result?: Record<string, unknown>;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** The server handle a host drives. */
+export interface TaskMcpServer {
+    /**
+     * Handle one JSON-RPC request. Returns `null` for notifications.
+     *
+     * Async because tool execution is async — a host that speaks JSON-RPC over
+     * stdio awaits this before writing the response.
+     */
+    handleRequest(request: TaskMcpRequest): Promise<TaskMcpResponse | null>;
+    /** The tool surface this server exposes. */
+    listTools(): TaskMcpToolDefinition[];
+    /** Invoke a tool by name (throws on unknown tool). */
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+}
+/**
+ * Convert a zod schema (v3) into a JSON Schema document.
+ *
+ * MCP requires a **JSON Schema document**, not a zod object. roy's
+ * `task_operation_create` / `task_operation_list` use `ZodEffects`
+ * (preprocess + transform), so the inner schema is unwrapped first.
+ *
+ * Fault-isolated: a conversion failure degrades to `{}` (the tool advertises
+ * no parameters) rather than breaking server startup.
+ */
+export declare function toJsonSchemaDocument(parameters: unknown): Record<string, unknown>;
+/**
+ * Build the MCP tool definitions for a backend.
+ *
+ * The descriptions and parameter schemas come from **core's own tool
+ * factories** — a host never has to hand-write them.
+ */
+export declare function createTaskMcpToolDefinitions(backend: TaskBackend): TaskMcpToolDefinition[];
+/** Negotiate a protocol version, falling back to our default. */
+export declare function negotiateTaskMcpProtocolVersion(requested?: string): string;
+/**
+ * Create a task MCP server bound to a `TaskBackend`.
+ *
+ * The returned handle is transport-agnostic: the host decides how bytes get
+ * in and out (stdio for Claude Code, an HTTP/SSE transport, a socket, …).
+ */
+export declare function createTaskMcpServer(backend: TaskBackend, options?: TaskMcpServerOptions): TaskMcpServer;

package/dist/env/task/plugins/index.d.ts

@@ -6,3 +6,4 @@ export { createAutoTaskPlugin, type AutoTaskPluginConfig, } from "./auto-task-pl
 export { WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, } from "./workflow-extractor-agent";
 export { LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, type TaskNotifyConfig, NotifyType, } from "./lark-cli-task-notify-plugin";
 export { PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin, type PerTaskGroupConfig, } from "./per-task-group-chat-plugin";
+export { LarkCardPatchNotifier, type LarkCardPatchNotifierOptions, buildTaskCard, buildWorkflowCard, renderProgressBar, renderMilestones, renderProcessSteps, renderTaskInfoLines, renderContextAsLines, renderWorkflowInfoLines, formatTimestampForDisplay, formatDateTimeForDisplay, formatDurationMs, sanitizeInlineText, humanizeValue, resolveTaskTitleForDisplay, buildChatAppLink, DEFAULT_APP_LINK_BASE, type CardStatus, type WorkflowCardStatus, type Milestone, type ProcessStep, type TaskMeta, type WorkflowMeta, type CardPayload, type StartTaskOptions, type UpdateTaskOptions, type FinishTaskOptions, type StartTaskResult, type StartWorkflowOptions, type UpdateWorkflowOptions, type FinishWorkflowOptions, } from "./lark-card-patch-notifier";

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

@@ -10,34 +10,69 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-8bngppw0.js";
-import"../../../shared/@ai-setting/roy-agent-core-fbjd7bt6.js";
-import"../../../shared/@ai-setting/roy-agent-core-2ctyjy62.js";
+} from "../../../shared/@ai-setting/roy-agent-core-ye4bfzqg.js";
+import"../../../shared/@ai-setting/roy-agent-core-a08dpf71.js";
+import"../../../shared/@ai-setting/roy-agent-core-th92f833.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-6masakz4.js";
-import"../../../shared/@ai-setting/roy-agent-core-c36335nw.js";
-import"../../../shared/@ai-setting/roy-agent-core-89sxsrc7.js";
-import"../../../shared/@ai-setting/roy-agent-core-08njdcpj.js";
+import {
+  DEFAULT_APP_LINK_BASE,
+  LarkCardPatchNotifier,
+  buildChatAppLink,
+  buildTaskCard,
+  buildWorkflowCard,
+  formatDateTimeForDisplay,
+  formatDurationMs,
+  formatTimestampForDisplay,
+  humanizeValue,
+  renderContextAsLines,
+  renderMilestones,
+  renderProcessSteps,
+  renderProgressBar,
+  renderTaskInfoLines,
+  renderWorkflowInfoLines,
+  resolveTaskTitleForDisplay,
+  sanitizeInlineText
+} from "../../../shared/@ai-setting/roy-agent-core-m3w3ytxt.js";
+import"../../../shared/@ai-setting/roy-agent-core-kmvw6b4v.js";
+import"../../../shared/@ai-setting/roy-agent-core-p6a4v4fq.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
-import"../../../shared/@ai-setting/roy-agent-core-gksw1gjb.js";
+import"../../../shared/@ai-setting/roy-agent-core-p8rf4z89.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
-import"../../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
-import"../../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
-import"../../../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+import"../../../shared/@ai-setting/roy-agent-core-33hn1beg.js";
+import"../../../shared/@ai-setting/roy-agent-core-hfyxv2kx.js";
+import"../../../shared/@ai-setting/roy-agent-core-386wa4wy.js";
+import"../../../shared/@ai-setting/roy-agent-core-6awgfh3x.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
+  sanitizeInlineText,
+  resolveTaskTitleForDisplay,
+  renderWorkflowInfoLines,
+  renderTaskInfoLines,
+  renderProgressBar,
+  renderProcessSteps,
+  renderMilestones,
+  renderContextAsLines,
   parseExtractorOutput,
+  humanizeValue,
+  formatTimestampForDisplay,
   formatExtractorInputFromDescription,
   formatExtractorInput,
+  formatDurationMs,
+  formatDateTimeForDisplay,
   createPerTaskGroupChatPlugin,
   createLarkCliTaskNotifyHook,
   createAutoTaskPlugin,
+  buildWorkflowCard,
+  buildTaskCard,
+  buildChatAppLink,
   WORKFLOW_EXTRACTOR_PROMPT,
   TaskTagPlugin,
   PerTaskGroupChatPlugin,
   NotifyType,
-  LarkCliTaskNotifyHook
+  LarkCliTaskNotifyHook,
+  LarkCardPatchNotifier,
+  DEFAULT_APP_LINK_BASE
 };

package/dist/env/task/plugins/lark-card-patch-notifier.js

@@ -0,0 +1,42 @@
+import {
+  DEFAULT_APP_LINK_BASE,
+  LarkCardPatchNotifier,
+  buildChatAppLink,
+  buildTaskCard,
+  buildWorkflowCard,
+  formatDateTimeForDisplay,
+  formatDurationMs,
+  formatTimestampForDisplay,
+  humanizeValue,
+  renderContextAsLines,
+  renderMilestones,
+  renderProcessSteps,
+  renderProgressBar,
+  renderTaskInfoLines,
+  renderWorkflowInfoLines,
+  resolveTaskTitleForDisplay,
+  sanitizeInlineText
+} from "../../../shared/@ai-setting/roy-agent-core-m3w3ytxt.js";
+import"../../../shared/@ai-setting/roy-agent-core-386wa4wy.js";
+import"../../../shared/@ai-setting/roy-agent-core-6awgfh3x.js";
+import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
+import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
+export {
+  sanitizeInlineText,
+  resolveTaskTitleForDisplay,
+  renderWorkflowInfoLines,
+  renderTaskInfoLines,
+  renderProgressBar,
+  renderProcessSteps,
+  renderMilestones,
+  renderContextAsLines,
+  humanizeValue,
+  formatTimestampForDisplay,
+  formatDurationMs,
+  formatDateTimeForDisplay,
+  buildWorkflowCard,
+  buildTaskCard,
+  buildChatAppLink,
+  LarkCardPatchNotifier,
+  DEFAULT_APP_LINK_BASE
+};

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

@@ -1,11 +1,11 @@
-import"../../../shared/@ai-setting/roy-agent-core-7q4wdze2.js";
+import"../../../shared/@ai-setting/roy-agent-core-5mrynf9g.js";
 import {
   SQLiteTaskStore,
   getDefaultDataDir,
   getDefaultTaskDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-fbjd7bt6.js";
-import"../../../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+} from "../../../shared/@ai-setting/roy-agent-core-th92f833.js";
+import"../../../shared/@ai-setting/roy-agent-core-386wa4wy.js";
+import"../../../shared/@ai-setting/roy-agent-core-6awgfh3x.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/task/storage/migrations/log-migration.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Migration logging helper.
+ *
+ * Task #4619 — the task migrations used to print with `console.log`, which
+ * is **stdout**.
+ *
+ * That is fatal for a stdio MCP server: the MCP stdio transport is
+ * newline-delimited JSON-RPC on stdout, and one stray non-JSON line makes
+ * the client drop the server (Claude Code reports
+ * `mcp_servers: [{"name":"plugin:roy-task:roy-task","status":"failed"}]`).
+ *
+ * Measured: the plugin's MCP server emitted **24 of 26 stdout lines** that
+ * were not JSON — 5 migration banners plus core's `[INFO]` trace lines.
+ *
+ * So migration output goes to **stderr**, always. It is diagnostics, not
+ * protocol.
+ */
+/** Print one migration diagnostic to stderr (never stdout). */
+export declare function logMigration(message: string): void;