ennodia 0.1.1 → 0.2.0

package/src/server.ts

@@ -152,6 +152,223 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
     },
   );
 
+  server.registerTool(
+    "ennodia_start_plan_advice",
+    {
+      title: "Start Ennodia Plan Advisor",
+      description:
+        "Ask one Advisor to propose a bounded team of harness, model, and skill assignments. This starts only the Advisor task: its output is strict, inert plan data that Ennodia validates and never executes automatically. Poll ennodia_get_plan_advice, then explicitly call ennodia_start_advised_plan with the returned digest.",
+      inputSchema: {
+        prompt: z
+          .string()
+          .min(1)
+          .describe("The work for which the Advisor should propose a team."),
+        cwd: z
+          .string()
+          .optional()
+          .describe(
+            "Optional target working directory used only to discover available skills. The Advisor task runs in a separate empty temporary directory.",
+          ),
+        refresh: z
+          .boolean()
+          .default(false)
+          .describe(
+            "Re-scan harnesses before freezing the Advisor inventory snapshot.",
+          ),
+        advisorHarnessId: z
+          .string()
+          .optional()
+          .describe(
+            `Harness to run the Plan Advisor. Omit to use the default priority: ${comparePriorityText}.`,
+          ),
+        advisorModel: z
+          .string()
+          .optional()
+          .describe("Optional model override for the Plan Advisor task."),
+        allowedHarnessIds: z
+          .array(z.string().min(1))
+          .min(1)
+          .max(64)
+          .optional()
+          .describe(
+            "Worker harness IDs the Advisor may select. Omit to allow every runnable public Ennodia adapter.",
+          ),
+        allowedModels: z
+          .record(z.string().min(1), z.array(z.string().min(1)).max(128))
+          .optional()
+          .describe(
+            "Exact caller-approved worker model IDs by harness. A model omitted by the Advisor uses that harness's default.",
+          ),
+        maxSlices: z
+          .number()
+          .int()
+          .min(1)
+          .max(64)
+          .optional()
+          .describe("Maximum explicit worker slices the Advisor may propose."),
+        maxSkillsPerSlice: z
+          .number()
+          .int()
+          .min(0)
+          .max(64)
+          .optional()
+          .describe("Maximum installed native skills assigned to one slice."),
+        maxTotalSkillAssignments: z
+          .number()
+          .int()
+          .min(0)
+          .max(1_024)
+          .optional()
+          .describe("Maximum skill assignments across the complete plan."),
+        timeoutMs: z
+          .number()
+          .int()
+          .positive()
+          .max(60 * 60 * 1000)
+          .optional()
+          .describe(
+            "Timeout for the single Plan Advisor task in milliseconds, capped at one hour.",
+          ),
+        budget: budgetSchema.optional(),
+      },
+    },
+    async (input) => jsonResult(await core.startPlanAdvice(input)),
+  );
+
+  server.registerTool(
+    "ennodia_list_plan_advice",
+    {
+      title: "List Ennodia plan advice",
+      description:
+        "List recent Plan Advisor requests started by this Ennodia MCP server process.",
+      inputSchema: {
+        includeProposal: z
+          .boolean()
+          .default(false)
+          .describe("Include the untrusted model-authored proposal when available."),
+        includePlan: z
+          .boolean()
+          .default(false)
+          .describe("Include the validated inert execution plan when ready."),
+        includeEvents: z
+          .boolean()
+          .default(false)
+          .describe("Include bounded Plan Advisor event history."),
+        maxEvents: z
+          .number()
+          .int()
+          .nonnegative()
+          .max(300)
+          .default(25)
+          .describe(
+            "Maximum Plan Advisor events per item when includeEvents is true.",
+          ),
+      },
+    },
+    async (options) => jsonResult(core.listPlanAdvice(options)),
+  );
+
+  server.registerTool(
+    "ennodia_get_plan_advice",
+    {
+      title: "Get Ennodia plan advice",
+      description:
+        "Inspect Plan Advisor status, validation issues, frozen inventory identity, proposal, validated plan, digest, budgets, events, and ETA. A plan can be launched only when status is ready. An authorized plan has status consumed and cannot run again.",
+      inputSchema: {
+        adviceId: z
+          .string()
+          .min(1)
+          .describe("Plan advice ID returned by ennodia_start_plan_advice."),
+        includeProposal: z
+          .boolean()
+          .default(true)
+          .describe("Include the untrusted model-authored proposal when available."),
+        includePlan: z
+          .boolean()
+          .default(true)
+          .describe("Include the validated inert execution plan when ready."),
+        includeEvents: z
+          .boolean()
+          .default(true)
+          .describe("Include bounded Plan Advisor event history."),
+        maxEvents: z
+          .number()
+          .int()
+          .nonnegative()
+          .max(300)
+          .default(100)
+          .describe("Maximum Plan Advisor events to include. Use 0 to omit events."),
+      },
+    },
+    async ({ adviceId, ...options }) => {
+      const advice = core.getPlanAdvice(adviceId, options);
+      if (!advice) {
+        throw new Error(`Unknown plan advice: ${adviceId}`);
+      }
+
+      return jsonResult(advice);
+    },
+  );
+
+  server.registerTool(
+    "ennodia_cancel_plan_advice",
+    {
+      title: "Cancel Ennodia plan advice",
+      description: "Cancel a running Plan Advisor request and its Advisor task.",
+      inputSchema: {
+        adviceId: z
+          .string()
+          .min(1)
+          .describe("Plan advice ID returned by ennodia_start_plan_advice."),
+      },
+    },
+    async ({ adviceId }) => jsonResult(core.cancelPlanAdvice(adviceId)),
+  );
+
+  server.registerTool(
+    "ennodia_start_advised_plan",
+    {
+      title: "Start an Ennodia advised plan",
+      description:
+        "Explicitly launch the exact validated worker plan from a ready Plan Advisor request. Ennodia re-checks the caller-supplied digest, current harness and skill inventory, caller allowlisted model assignments, and budget before starting the first worker task; any mismatch fails closed with zero launches. A plan is single-use after authorization. Provider model availability remains unverified until the harness runs.",
+      inputSchema: {
+        adviceId: z
+          .string()
+          .min(1)
+          .describe("Ready plan advice ID returned by ennodia_start_plan_advice."),
+        expectedPlanDigest: z
+          .string()
+          .min(1)
+          .describe(
+            "Exact planDigest returned by ennodia_get_plan_advice for explicit, stale-plan-safe execution.",
+          ),
+        cwd: z
+          .string()
+          .optional()
+          .describe(
+            "Working directory for worker tasks. Omit to reuse the directory whose skills were inventoried.",
+          ),
+        isolateCwd: z
+          .boolean()
+          .optional()
+          .describe(
+            "Run each worker against an ephemeral isolated copy of cwd so parallel writes cannot clobber each other. Isolation fails before task spawn if the copied tree contains a symbolic link. The execution path is reported as the task cwd for traceability and deleted when the task becomes terminal.",
+          ),
+        timeoutMs: z
+          .number()
+          .int()
+          .positive()
+          .max(60 * 60 * 1000)
+          .optional()
+          .describe(
+            "Per-worker timeout in milliseconds, capped at one hour.",
+          ),
+        budget: budgetSchema.optional(),
+      },
+    },
+    async (input) => jsonResult(await core.startAdvisedPlan(input)),
+  );
+
   server.registerTool(
     "ennodia_estimate_budget",
     {
@@ -180,7 +397,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .union([z.literal("auto"), z.boolean()])
           .default("auto")
           .describe(
-            "Whether Compare should be included in the estimate. auto follows the planner.",
+            "Whether the Judge + Result Advisor comparison should be included in the estimate. auto follows the planner.",
           ),
         refresh: z
           .boolean()
@@ -193,7 +410,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .max(200_000)
           .optional()
           .describe(
-            "Maximum characters from each successful task output assumed for Compare input.",
+            "Maximum characters from each successful task output assumed for Judge + Result Advisor input.",
           ),
         budget: budgetSchema.optional(),
       },
@@ -206,13 +423,13 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
     {
       title: "Estimate compositional Ennodia budget",
       description:
-        "Resolve focused compositional slices to harnesses and estimate child-task and Compare budget without starting child processes.",
+        "Resolve focused compositional slices to harnesses and estimate child-task and later Judge + Result Advisor budget without starting child processes.",
       inputSchema: {
         prompt: z
           .string()
           .min(1)
           .describe(
-            "Overall question or synthesis goal that every slice belongs to.",
+            "Overall task or question that every slice belongs to.",
           ),
         slices: z
           .array(compositionalSliceSchema)
@@ -235,13 +452,13 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .array(z.string())
           .optional()
           .describe(
-            "Optional list of installed native skill IDs to validate against every selected slice harness.",
+            "Default installed native skill IDs for slices that omit slice.skillIds. A slice-level list, including [], replaces this default.",
           ),
         includeCompareEstimate: z
           .boolean()
           .default(true)
           .describe(
-            "Include a later Compare pass in the returned preflight budget estimate.",
+            "Include a later Judge + Result Advisor pass in the returned preflight budget estimate.",
           ),
         maxOutputChars: z
           .number()
@@ -250,7 +467,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .max(200_000)
           .optional()
           .describe(
-            "Maximum characters per successful slice output assumed for a later Compare estimate.",
+            "Maximum characters per successful slice output assumed for a later Judge + Result Advisor estimate.",
           ),
         budget: budgetSchema.optional(),
       },
@@ -263,7 +480,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
     {
       title: "Start an Ennodia task",
       description:
-        "Start raw child harness tasks without run-level Compare or final synthesis. Use for debugging, direct harness calls, or manual Compare workflows; prefer ennodia_run for normal end-to-end use.",
+        "Start raw child harness tasks without a run-level Judge + Result Advisor pass. Use for debugging, direct harness calls, or manual comparison workflows; prefer ennodia_run for normal end-to-end use.",
       inputSchema: {
         prompt: z
           .string()
@@ -286,6 +503,12 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .string()
           .optional()
           .describe("Working directory for child harness commands."),
+        isolateCwd: z
+          .boolean()
+          .optional()
+          .describe(
+            "Run each task against an ephemeral isolated copy of cwd instead of cwd itself. Use this whenever starting more than one task against the same cwd (e.g. comparing skills or harnesses), so concurrent file writes cannot clobber each other. Isolation fails before task spawn if the copied tree contains a symbolic link. The reported task cwd is an execution trace; its temporary directory is deleted when the task becomes terminal.",
+          ),
         model: z
           .string()
           .optional()
@@ -320,13 +543,13 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
     {
       title: "Start compositional Ennodia tasks",
       description:
-        "Start one focused child task per slice for compositional reviews. Poll the returned task IDs, then pass useful completed task IDs to ennodia_start_compare for synthesis.",
+        "Start one focused child task per slice for compositional reviews. Poll the returned task IDs, then pass useful completed task IDs to ennodia_start_compare for a Judge + Result Advisor comparison.",
       inputSchema: {
         prompt: z
           .string()
           .min(1)
           .describe(
-            "Overall question or synthesis goal that every slice belongs to.",
+            "Overall task or question that every slice belongs to.",
           ),
         slices: z
           .array(compositionalSliceSchema)
@@ -339,6 +562,12 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .string()
           .optional()
           .describe("Working directory for child harness commands."),
+        isolateCwd: z
+          .boolean()
+          .optional()
+          .describe(
+            "Run each slice's task against an ephemeral isolated copy of cwd instead of cwd itself, so slices that write files cannot clobber each other. Isolation fails before task spawn if the copied tree contains a symbolic link. The reported task cwd is an execution trace; its temporary directory is deleted when the task becomes terminal.",
+          ),
         timeoutMs: z
           .number()
           .int()
@@ -356,13 +585,13 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .array(z.string())
           .optional()
           .describe(
-            "Optional list of installed native skill IDs to ask every selected slice harness to use.",
+            "Default installed native skill IDs for slices that omit slice.skillIds. A slice-level list, including [], replaces this default.",
           ),
         includeCompareEstimate: z
           .boolean()
           .default(true)
           .describe(
-            "Include a later Compare pass in the returned preflight budget estimate.",
+            "Include a later Judge + Result Advisor pass in the returned preflight budget estimate.",
           ),
         maxOutputChars: z
           .number()
@@ -371,7 +600,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .max(200_000)
           .optional()
           .describe(
-            "Maximum characters per successful slice output assumed for a later Compare estimate.",
+            "Maximum characters per successful slice output assumed for a later Judge + Result Advisor estimate.",
           ),
         budget: budgetSchema.optional(),
       },
@@ -417,12 +646,18 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .union([z.literal("auto"), z.boolean()])
           .default("auto")
           .describe(
-            "Whether to run Compare after tasks finish. auto compares when the planner sees value and at least two tasks produce output.",
+            "Whether to run the Judge + Result Advisor after tasks finish. auto compares when the planner sees value and at least two tasks produce output.",
           ),
         cwd: z
           .string()
           .optional()
           .describe("Working directory for child harness commands."),
+        isolateCwd: z
+          .boolean()
+          .optional()
+          .describe(
+            "Run each selected harness against an ephemeral isolated copy of cwd instead of cwd itself. Use this in parallel mode or whenever comparing skills/harnesses against the same cwd, so concurrent file writes cannot clobber each other. Isolation fails before task spawn if the copied tree contains a symbolic link. The reported task cwd is an execution trace; its temporary directory is deleted when the task becomes terminal.",
+          ),
         model: z
           .string()
           .optional()
@@ -444,22 +679,34 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .string()
           .optional()
           .describe(
-            `Harness to use as the Compare judge. Omit to use the default priority: ${comparePriorityText}.`,
+            `Harness to use as the comparison Judge. Omit to use the default priority: ${comparePriorityText}.`,
           ),
         judgeModel: z
           .string()
           .optional()
-          .describe("Optional model override for the Compare judge."),
+          .describe("Optional model override for the comparison Judge."),
+        advisorHarnessId: z
+          .string()
+          .optional()
+          .describe(
+            "Harness that runs the Result Advisor after the Judge. Defaults to the judge harness selection.",
+          ),
+        advisorModel: z
+          .string()
+          .optional()
+          .describe("Optional model override for the Result Advisor."),
         synthesizerHarnessId: z
           .string()
           .optional()
           .describe(
-            "Harness that writes the final synthesized answer. Defaults to the judge harness selection.",
+            "Deprecated alias for advisorHarnessId. Do not send both fields with different values.",
           ),
         synthesizerModel: z
           .string()
           .optional()
-          .describe("Optional model override for the Compare synthesizer."),
+          .describe(
+            "Deprecated alias for advisorModel. Do not send both fields with different values.",
+          ),
         maxOutputChars: z
           .number()
           .int()
@@ -467,7 +714,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .max(200_000)
           .optional()
           .describe(
-            "Maximum characters from each successful task output to pass into Compare. Use 0 to suppress candidate text.",
+            "Maximum characters from each successful task output to pass into the Judge + Result Advisor workflow. Use 0 to suppress candidate text.",
           ),
         skillIds: z
           .array(z.string())
@@ -517,7 +764,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
     {
       title: "List durable Ennodia run history",
       description:
-        "Read terminal run receipts persisted under the local Ennodia history directory. Use after a restart to inspect previous final answers and Compare disagreement analysis.",
+        "Read terminal run receipts persisted under the local Ennodia history directory. Use after a restart to inspect previous final answers and Judge disagreement analysis.",
       inputSchema: {
         limit: z
           .number()
@@ -536,7 +783,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
     {
       title: "Get Ennodia run",
       description:
-        "Inspect run status, selected harnesses, child task IDs, Compare ID, final answer, events, and ETA.",
+        "Inspect run status, selected harnesses, child task IDs, comparison ID, final Advisor answer, events, and ETA.",
       inputSchema: {
         runId: z.string().min(1).describe("Run ID returned by ennodia_run."),
         includeEvents: z
@@ -575,7 +822,8 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
     "ennodia_cancel_run",
     {
       title: "Cancel Ennodia run",
-      description: "Cancel a high-level run and any active child task or Compare.",
+      description:
+        "Cancel a high-level run and any active child task, Judge, or Result Advisor.",
       inputSchema: {
         runId: z.string().min(1).describe("Run ID returned by ennodia_run."),
       },
@@ -623,7 +871,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
     {
       title: "Get compositional Ennodia status",
       description:
-        "Inspect a batch of compositional shard tasks, group running and terminal states, and return Compare-ready successful task IDs.",
+        "Inspect a batch of compositional shard tasks, group running and terminal states, and return successful task IDs ready for Judge + Result Advisor comparison.",
       inputSchema: {
         taskIds: z
           .array(z.string().min(1).describe("Task ID returned by a compositional start."))
@@ -634,7 +882,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .string()
           .optional()
           .describe(
-            "Optional synthesis prompt to include in the returned compareNext object.",
+            "Optional comparison prompt to include in the returned compareNext object.",
           ),
         minSuccessfulTasksForCompare: z
           .number()
@@ -678,9 +926,9 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
   server.registerTool(
     "ennodia_start_compare",
     {
-      title: "Start Ennodia Compare",
+      title: "Start Ennodia Judge + Result Advisor",
       description:
-        "Compare completed Ennodia task outputs or caller-supplied responses. Runs a judge pass, then a synthesizer pass, and returns a Compare ID to inspect with ennodia_get_compare.",
+        "Compare completed Ennodia task outputs or caller-supplied responses. The Judge maps agreements, contradictions, and risks; the Result Advisor then combines that analysis into the final answer. Returns a Compare ID to inspect with ennodia_get_compare.",
       inputSchema: {
         prompt: z
           .string()
@@ -718,26 +966,38 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .string()
           .optional()
           .describe(
-            `Harness to use as the Compare judge. Omit to use the default priority: ${comparePriorityText}.`,
+            `Harness to use as the comparison Judge. Omit to use the default priority: ${comparePriorityText}.`,
           ),
         judgeModel: z
           .string()
           .optional()
-          .describe("Optional model override for the Compare judge."),
+          .describe("Optional model override for the comparison Judge."),
+        advisorHarnessId: z
+          .string()
+          .optional()
+          .describe(
+            "Harness that runs the Result Advisor after the Judge. Defaults to the judge harness selection.",
+          ),
+        advisorModel: z
+          .string()
+          .optional()
+          .describe("Optional model override for the Result Advisor."),
         synthesizerHarnessId: z
           .string()
           .optional()
           .describe(
-            "Harness that writes the final synthesized answer. Defaults to the judge harness selection.",
+            "Deprecated alias for advisorHarnessId. Do not send both fields with different values.",
           ),
         synthesizerModel: z
           .string()
           .optional()
-          .describe("Optional model override for the Compare synthesizer."),
+          .describe(
+            "Deprecated alias for advisorModel. Do not send both fields with different values.",
+          ),
         cwd: z
           .string()
           .optional()
-          .describe("Working directory for judge and synthesizer child tasks."),
+          .describe("Working directory for Judge and Result Advisor child tasks."),
         timeoutMs: z
           .number()
           .int()
@@ -745,7 +1005,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .max(60 * 60 * 1000)
           .optional()
           .describe(
-            "Per-child timeout for judge and synthesizer tasks in milliseconds, capped at one hour.",
+            "Per-child timeout for Judge and Result Advisor tasks in milliseconds, capped at one hour.",
           ),
         maxOutputChars: z
           .number()
@@ -754,7 +1014,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .max(200_000)
           .optional()
           .describe(
-            "Maximum characters from each task output to include as a Compare candidate. Use 0 to suppress task output text.",
+            "Maximum characters from each task output to include as a comparison candidate. Use 0 to suppress task output text.",
           ),
         budget: budgetSchema.optional(),
       },
@@ -765,17 +1025,18 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
   server.registerTool(
     "ennodia_list_compares",
     {
-      title: "List Ennodia compares",
-      description: "List Compare runs started by this Ennodia MCP server process.",
+      title: "List Ennodia Judge + Advisor comparisons",
+      description:
+        "List Judge + Result Advisor comparisons started by this Ennodia MCP server process.",
       inputSchema: {
         includeCandidates: z
           .boolean()
           .default(false)
-          .describe("Include bounded candidate response previews for each Compare."),
+          .describe("Include bounded candidate response previews for each comparison."),
         includeEvents: z
           .boolean()
           .default(false)
-          .describe("Include bounded Compare event history."),
+          .describe("Include bounded Judge + Result Advisor event history."),
         maxCandidateChars: z
           .number()
           .int()
@@ -792,7 +1053,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .max(300)
           .default(25)
           .describe(
-            "Maximum Compare events to include when includeEvents is true.",
+            "Maximum comparison events to include when includeEvents is true.",
           ),
       },
     },
@@ -802,9 +1063,9 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
   server.registerTool(
     "ennodia_get_compare",
     {
-      title: "Get Ennodia Compare",
+      title: "Get Ennodia Judge + Result Advisor comparison",
       description:
-        "Inspect Compare status, candidate inputs, judge analysis, final synthesis, child task IDs, and ETA.",
+        "Inspect comparison status, candidate inputs, Judge analysis, Result Advisor answer, child task IDs, degradation state, and ETA.",
       inputSchema: {
         compareId: z
           .string()
@@ -817,7 +1078,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
         includeEvents: z
           .boolean()
           .default(true)
-          .describe("Include bounded Compare event history."),
+          .describe("Include bounded Judge + Result Advisor event history."),
         maxCandidateChars: z
           .number()
           .int()
@@ -833,7 +1094,7 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
           .nonnegative()
           .max(300)
           .default(100)
-          .describe("Maximum Compare events to include. Use 0 to omit events."),
+          .describe("Maximum comparison events to include. Use 0 to omit events."),
       },
     },
     async ({ compareId, ...options }) => {
@@ -849,8 +1110,9 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
   server.registerTool(
     "ennodia_cancel_compare",
     {
-      title: "Cancel Ennodia Compare",
-      description: "Cancel a running Compare and its active child task.",
+      title: "Cancel Ennodia Judge + Result Advisor comparison",
+      description:
+        "Cancel a running Judge + Result Advisor comparison and its active child task.",
       inputSchema: {
         compareId: z
           .string()
@@ -870,7 +1132,9 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
         taskId: z
           .string()
           .min(1)
-          .describe("Task ID returned by ennodia_start, ennodia_run, or Compare."),
+          .describe(
+            "Task ID returned by a raw, compositional, advised-plan, run, Plan Advisor, or Compare start.",
+          ),
         includeOutput: z
           .boolean()
           .default(true)
@@ -916,7 +1180,9 @@ export function createEnnodiaServer(core: EnnodiaCore = defaultCore): McpServer
         taskId: z
           .string()
           .min(1)
-          .describe("Task ID returned by ennodia_start, ennodia_run, or Compare."),
+          .describe(
+            "Task ID returned by a raw, compositional, advised-plan, run, Plan Advisor, or Compare start.",
+          ),
       },
     },
     async ({ taskId }) => jsonResult(core.cancelTask(taskId)),