@ai-setting/roy-agent-core 1.7.58 → 1.7.61

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-ymcvsdzn.js";
+import {
+  createOperationTool,
+  listOperationsTool
+} from "../../../shared/@ai-setting/roy-agent-core-rn57psp0.js";
+import"../../../shared/@ai-setting/roy-agent-core-qrjs2500.js";
+import"../../../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../../../shared/@ai-setting/roy-agent-core-y0k9kaxz.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-n1ck0x1r.js";
+import"../../../shared/@ai-setting/roy-agent-core-z51jktet.js";
+import"../../../shared/@ai-setting/roy-agent-core-xeqp659x.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-yd85623y.js";
+import"../../../shared/@ai-setting/roy-agent-core-8fy467qs.js";
+import"../../../shared/@ai-setting/roy-agent-core-60p2380d.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-hf0t8agb.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-bdzdw1g3.js";
+import"../../../shared/@ai-setting/roy-agent-core-qrjs2500.js";
+import"../../../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../../../shared/@ai-setting/roy-agent-core-y0k9kaxz.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/storage/index.js

@@ -1,11 +1,11 @@
-import"../../../shared/@ai-setting/roy-agent-core-7q4wdze2.js";
+import"../../../shared/@ai-setting/roy-agent-core-khc23qs1.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-xeqp659x.js";
+import"../../../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../../../shared/@ai-setting/roy-agent-core-y0k9kaxz.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;

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

@@ -11,6 +11,26 @@
  * - 内存缓存提高性能
  * - 默认路径：~/.local/share/roy-agent/tasks.db
  */
+/**
+ * 获取 SQLite 数据库类
+ *
+ * 根据运行时环境选择正确的实现：
+ * - Bun 运行时：使用 bun:sqlite（命名导出）
+ * - Node.js 22.5+：使用 node:sqlite（内置，无需原生编译）
+ * - 旧版 Node.js/Electron：使用 better-sqlite3（默认导出，需要原生编译）
+ *
+ * ⚠️ Task #4619：`node:sqlite` 优先于 `better-sqlite3`。
+ *
+ * `better-sqlite3` 是**原生插件**。插件的 Claude 侧 MCP server 是
+ * `#!/usr/bin/env node` 的 `.mjs` 脚本 —— 纯 node 环境。它不能依赖一个
+ * 需要编译的原生模块（插件自己的 `bridge.mjs` 注释记录了 better-sqlite3
+ * 在 node 24 下 `Assertion failed: (env) != nullptr` 直接 abort 进程）。
+ *
+ * `node:sqlite`（Node 22.5+，Node 24 已 stable）是 **node 内置**的，
+ * 且 `prepare(sql).all() / .get() / .run()` 与 better-sqlite3 同形，
+ * 所以 `createCompatibleDatabase` 的 shim 无需改动即可工作。
+ */
+export declare function getDatabaseClass(): new (path: string) => any;
 /**
  * 创建兼容的 Database 实例
  *
@@ -21,6 +41,15 @@
  * 此函数确保两种实现都有 run() 方法
  */
 export declare function createCompatibleDatabase(path: string): any;
+/**
+ * Apply the bun:sqlite ↔ better-sqlite3 / node:sqlite compat shim to an
+ * **existing** database handle.
+ *
+ * Task #4619 — factored out of `createCompatibleDatabase` so the shim can be
+ * applied to a `node:sqlite` handle (which the plugin's plain-node MCP
+ * server uses) without going through the driver constructor.
+ */
+export declare function createCompatibleDatabaseFrom(db: any): any;
 import type { Task, TaskOperation, TaskTag, CreateTaskOptions, UpdateTaskOptions, ListTasksOptions, TaskListResult, SearchTasksOptions, CreateOperationOptions, ListOperationsOptions } from "../types";
 import type { ListTagsOptions, SearchTagsOptions } from "../tag-service";
 /**

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

@@ -137,11 +137,56 @@ export declare class TaskComponent extends BaseComponent {
     getTaskIdBySessionId(sessionId: string): Promise<number | undefined>;
     /**
      * Get task with operations
+     *
+     * Task #4619 (cross-validation M-2): the result is **flat** —
+     * `{ ...task, operations }` — not `{ task, operations }`.
+     *
+     * Two independent reasons, both about the published contract:
+     *
+     * 1. The old plugin's `taskGet` returned `{ ...task, operations }`, and
+     *    that flat shape is what every client written against the published
+     *    plugin reads (`task.title`, `task.operations`). Nesting moved every
+     *    task field one level down — just as breaking as dropping the
+     *    operations.
+     * 2. `TaskStoreBackend.getTaskWithOperations()` (the backend the plugin
+     *    binds) already returns the flat shape. The two implementations had
+     *    drifted, so the same tool produced two different shapes depending on
+     *    which backend it was bound to.
+     *
+     * ---
+     *
+     * Task #4622: the flat shape ALSO carries a **nested `task` alias**, so
+     * the already-published `@ai-setting/roy-agent-cli@1.7.59` keeps working.
+     *
+     * That CLI declares `"@ai-setting/roy-agent-core": "^1.5.83"` — a range
+     * that accepts 1.7.61 — and its `tasks get` command reads the **nested**
+     * shape:
+     *
+     *     const result = await taskComponent.getTaskWithOperations(args.id);
+     *     output.log(`Task #${result.task.id}: ${result.task.title}`);
+     *
+     * Publishing the flat-only shape therefore broke `roy-agent tasks get`
+     * for every user still on CLI 1.7.59:
+     *
+     *     TypeError: Cannot read properties of undefined (reading 'id')
+     *
+     * (Measured against the real published tarball, not reasoned about.)
+     *
+     * So the result carries **both** views:
+     *
+     *     result.id        → flat access (the plugin's MCP contract)
+     *     result.task.id   → nested access (published CLI 1.7.59)
+     *
+     * The alias points at the **same object** the flat fields were spread
+     * from, so the two views can never disagree. It is deliberately **not**
+     * self-referential (`result.task === result`), because that would make
+     * `JSON.stringify` throw "Converting circular structure to JSON" — and
+     * this very object is what `task_get` serialises for the MCP wire.
      */
-    getTaskWithOperations(id: number): Promise<{
-        task: Task;
+    getTaskWithOperations(id: number): Promise<(Task & {
         operations: TaskOperation[];
-    } | undefined>;
+        task: Task;
+    }) | undefined>;
     /**
      * Update task
      */

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

@@ -9,10 +9,10 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-vh0qzb24.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";
+} from "../../../shared/@ai-setting/roy-agent-core-ymcvsdzn.js";
+import"../../../shared/@ai-setting/roy-agent-core-qrjs2500.js";
+import"../../../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../../../shared/@ai-setting/roy-agent-core-y0k9kaxz.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {