@runfusion/fusion 0.51.0 → 0.53.0

package/dist/pi-claude-cli/index.ts

@@ -5,7 +5,16 @@
  * subprocess using stream-json NDJSON protocol.
  */
 
-import { getModels } from "@earendil-works/pi-ai";
+/*
+ * FNXC:ModelCatalog 2026-07-01-17:30:
+ * pi-ai 0.80 restructured its static catalog API: the top-level `getModels`
+ * export moved to the deprecated `/compat` shim, and the canonical accessor is
+ * `getBuiltinModels` from `@earendil-works/pi-ai/providers/all`. pi-claude-cli
+ * now pins `@earendil-works/pi-ai` and `@earendil-works/pi-coding-agent` to
+ * `^0.80.3` (matching cli/engine) so the whole extension resolves one pi-ai
+ * version and the ExtensionAPI stream types stay compatible.
+ */
+import { getBuiltinModels } from "@earendil-works/pi-ai/providers/all";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { streamViaCli } from "./src/provider.js";
 import { streamViaAcp } from "./src/acp-driver.js";
@@ -175,7 +184,7 @@ export default function (pi: ExtensionAPI) {
     // `claude` subprocess in streamViaCli still reports hard errors on send.
     void runCliValidationOnce();
 
-    const catalogModels = getModels("anthropic").map((model) => ({
+    const catalogModels = getBuiltinModels("anthropic").map((model) => ({
       id: model.id,
       name: model.name,
       reasoning: model.reasoning,
@@ -190,6 +199,42 @@ export default function (pi: ExtensionAPI) {
     // catalog catches up.
     // https://platform.claude.com/docs/en/about-claude/models/overview
     const extraModels: typeof catalogModels = [
+      /*
+       * FNXC:ModelCatalog 2026-07-01-18:18:
+       * Keep Claude CLI supplemental metadata limited to models that Fusion can advertise without triggering the direct-Anthropic Sonnet 5 404 loop. `claude-sonnet-5` must come from the upstream/live registry before this provider shows it, because static metadata cannot prove the current account and CLI surface can call that model.
+       *
+       * FNXC:ModelCatalog 2026-07-01-20:37:
+       * Supersede the prior Claude CLI withholding only for `pi-claude-cli`: the local `claude` subprocess routes through the user's Claude subscription/login and its 2.1.197 `--model` help accepts latest aliases/full names, so the CLI picker should advertise Sonnet 5 and newer CLI-callable rows. Keep direct Anthropic supplemental metadata and static pricing withheld because FN-7374's per-account `404 not_found_error` applies to that API surface, not this subscription-authenticated CLI surface.
+       */
+      {
+        id: "claude-sonnet-5",
+        name: "Claude Sonnet 5",
+        reasoning: true,
+        input: ["text", "image"],
+        cost: { input: 2, output: 10, cacheRead: 0.2, cacheWrite: 2.5 },
+        contextWindow: 1_000_000,
+        maxTokens: 128_000,
+      },
+      {
+        id: "claude-fable-5",
+        name: "Claude Fable 5",
+        reasoning: true,
+        input: ["text", "image"],
+        // FNXC:ModelCatalog 2026-07-01-21:04: Fable 5 must use Anthropic's current $10/$50 per MTok row so Fusion's CLI picker does not understate supplemental model cost estimates.
+        cost: { input: 10, output: 50, cacheRead: 1, cacheWrite: 12.5 },
+        contextWindow: 1_000_000,
+        maxTokens: 128_000,
+      },
+      {
+        id: "claude-opus-4-8",
+        name: "Claude Opus 4.8",
+        reasoning: true,
+        input: ["text", "image"],
+        // FNXC:ModelCatalog 2026-07-01-20:37: The overview confirms Opus 4.8 context/output limits; mirror the closest current Opus CLI supplemental pricing until a precise per-model price row is pinned for this subscription surface.
+        cost: { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
+        contextWindow: 1_000_000,
+        maxTokens: 128_000,
+      },
       {
         id: "claude-opus-4-7",
         name: "Claude Opus 4.7",
@@ -205,8 +250,8 @@ export default function (pi: ExtensionAPI) {
         reasoning: true,
         input: ["text", "image"],
         cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
-        contextWindow: 200_000,
-        maxTokens: 16_384,
+        contextWindow: 1_000_000,
+        maxTokens: 64_000,
       },
       {
         id: "claude-sonnet-4-5",
@@ -215,7 +260,7 @@ export default function (pi: ExtensionAPI) {
         input: ["text", "image"],
         cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
         contextWindow: 200_000,
-        maxTokens: 8_192,
+        maxTokens: 64_000,
       },
       {
         id: "claude-haiku-4-5",
@@ -224,7 +269,7 @@ export default function (pi: ExtensionAPI) {
         input: ["text", "image"],
         cost: { input: 0.8, output: 4, cacheRead: 0.08, cacheWrite: 1 },
         contextWindow: 200_000,
-        maxTokens: 8_192,
+        maxTokens: 64_000,
       },
     ];
 

package/dist/pi-claude-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion/pi-claude-cli",
-  "version": "0.51.0",
+  "version": "0.53.0",
   "type": "module",
   "private": true,
   "main": "index.ts",
@@ -13,12 +13,14 @@
     "@agentclientprotocol/sdk": "0.24.0"
   },
   "devDependencies": {
+    "@earendil-works/pi-ai": "^0.80.3",
+    "@earendil-works/pi-coding-agent": "^0.80.3",
     "@types/node": "^22.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*"
+    "@earendil-works/pi-ai": "^0.80.3",
+    "@earendil-works/pi-coding-agent": "^0.80.3"
   }
 }

package/dist/pi-claude-cli/src/__tests__/process-manager.test.ts

@@ -68,7 +68,7 @@ describe("buildClaudeSpawnArgs", () => {
     });
 
     expect(args).toContain("--model");
-    expect(args).toContain("claude-sonnet-4-6");
+    expect(args[args.indexOf("--model") + 1]).toBe("claude-sonnet-4-6");
     expect(args).toContain("--resume");
     expect(args).toContain("sess-1");
     expect(args).toContain("--effort");

package/dist/pi-claude-cli/src/__tests__/provider.test.ts

@@ -59,13 +59,18 @@ const { MockAssistantMessageEventStream } = vi.hoisted(() => {
 });
 
 vi.mock("@earendil-works/pi-ai", () => ({
-  getModels: vi.fn(() => mockModels),
   AssistantMessageEventStream: MockAssistantMessageEventStream,
   calculateCost: vi.fn(),
 }));
 
+// pi-ai 0.80 moved the static catalog read to `getBuiltinModels` in the
+// `/providers/all` subpath (see index.ts). Mock it there.
+vi.mock("@earendil-works/pi-ai/providers/all", () => ({
+  getBuiltinModels: vi.fn(() => mockModels),
+}));
+
 import { spawn } from "node:child_process";
-import { getModels } from "@earendil-works/pi-ai";
+import { getBuiltinModels } from "@earendil-works/pi-ai/providers/all";
 import { streamViaCli } from "../provider";
 
 describe("provider registration (default export)", () => {
@@ -116,7 +121,7 @@ describe("provider registration (default export)", () => {
     expect(firstModel.cost).toBeDefined();
   });
 
-  it("includes all extra Claude model entries", async () => {
+  it("includes latest Claude models including Sonnet 5 for the CLI surface", async () => {
     const registerProvider = vi.fn();
     const mockPi = { registerProvider, on: vi.fn() } as any;
 
@@ -127,6 +132,9 @@ describe("provider registration (default export)", () => {
     const modelIds = new Set(config.models.map((m: { id: string }) => m.id));
 
     for (const id of [
+      "claude-sonnet-5",
+      "claude-fable-5",
+      "claude-opus-4-8",
       "claude-opus-4-7",
       "claude-sonnet-4-6",
       "claude-sonnet-4-5",
@@ -134,18 +142,36 @@ describe("provider registration (default export)", () => {
     ]) {
       expect(modelIds.has(id)).toBe(true);
     }
+
+    expect(
+      config.models.find((m: { id: string }) => m.id === "claude-fable-5"),
+    ).toMatchObject({
+      cost: { input: 10, output: 50, cacheRead: 1, cacheWrite: 12.5 },
+    });
   });
 
   it("deduplicates extra models when catalog already includes them", async () => {
     const registerProvider = vi.fn();
     const mockPi = { registerProvider, on: vi.fn() } as any;
-    const getModelsMock = vi.mocked(getModels);
+    const getModelsMock = vi.mocked(getBuiltinModels);
+    const upstreamSonnet5 = {
+      id: "claude-sonnet-5",
+      name: "Claude Sonnet 5 Upstream",
+      api: "anthropic",
+      provider: "anthropic",
+      reasoning: false,
+      input: ["text"],
+      cost: { input: 99, output: 199, cacheRead: 9.9, cacheWrite: 24.75 },
+      contextWindow: 123_456,
+      maxTokens: 7_654,
+    } as any;
 
     getModelsMock.mockReturnValueOnce([
       ...mockModels,
+      upstreamSonnet5,
       {
         id: "claude-sonnet-4-6",
-        name: "Claude Sonnet 4.6",
+        name: "Claude Sonnet 4.6 Upstream",
         api: "anthropic",
         provider: "anthropic",
         reasoning: true,
@@ -160,10 +186,23 @@ describe("provider registration (default export)", () => {
     mod.default(mockPi);
 
     const config = registerProvider.mock.calls[0][1];
-    const matches = config.models.filter(
-      (m: { id: string }) => m.id === "claude-sonnet-4-6",
-    );
-    expect(matches).toHaveLength(1);
+    for (const id of ["claude-sonnet-5", "claude-sonnet-4-6"]) {
+      const matches = config.models.filter(
+        (m: { id: string }) => m.id === id,
+      );
+      expect(matches).toHaveLength(1);
+    }
+
+    expect(
+      config.models.find((m: { id: string }) => m.id === "claude-sonnet-5"),
+    ).toMatchObject({
+      name: upstreamSonnet5.name,
+      reasoning: upstreamSonnet5.reasoning,
+      input: upstreamSonnet5.input,
+      cost: upstreamSonnet5.cost,
+      contextWindow: upstreamSonnet5.contextWindow,
+      maxTokens: upstreamSonnet5.maxTokens,
+    });
   });
 });
 

package/dist/plugin-sdk/index.d.ts

@@ -689,6 +689,13 @@ interface CustomFieldRejection {
     detail: string;
 }
 
+type WorkflowLifecycleWarningCode = "missing-completion-summary" | "missing-merge-region" | "unsafe-terminal-before-merge" | "optional-group-after-execution" | "review-gate-without-failure-route";
+interface WorkflowLifecycleWarning {
+    code: WorkflowLifecycleWarningCode;
+    nodeId?: string;
+    message: string;
+}
+
 interface WorkflowNodeLayout {
     x: number;
     y: number;
@@ -698,15 +705,18 @@ interface WorkflowDefinition {
     id: string;
     name: string;
     description: string;
+    icon?: string;
     kind: WorkflowDefinitionKind;
     ir: WorkflowIr;
     layout: Record<string, WorkflowNodeLayout>;
+    lifecycleWarnings?: WorkflowLifecycleWarning[];
     createdAt: string;
     updatedAt: string;
 }
 interface WorkflowDefinitionInput {
     name: string;
     description?: string;
+    icon?: string;
     ir: WorkflowIr;
     layout?: Record<string, WorkflowNodeLayout>;
     kind?: WorkflowDefinitionKind;
@@ -714,6 +724,7 @@ interface WorkflowDefinitionInput {
 interface WorkflowDefinitionUpdate {
     name?: string;
     description?: string;
+    icon?: string | null;
     ir?: WorkflowIr;
     layout?: Record<string, WorkflowNodeLayout>;
     rehomeTo?: string;
@@ -2662,6 +2673,8 @@ declare class TaskStore extends EventEmitter<TaskStoreEvents> {
     private scanAndRecordCitations;
     private getTaskSelectClause;
     private computeTimedExecutionMs;
+    private getLatestAgentLogActivityMs;
+    private hasFreshAgentLogActivitySinceTaskUpdate;
     private getTaskSelectClauseWithActivityLogLimit;
     private createTaskPersistSerializationContext;
     private getTaskPersistValues;
@@ -2902,6 +2915,7 @@ declare class TaskStore extends EventEmitter<TaskStoreEvents> {
     handoffToReview(taskId: string, opts: HandoffToReviewOptions): Promise<Task>;
     private resolveWorkflowMoveActor;
     private resolveWorkflowBypassGuards;
+    private isWorkflowDoneBypassGuardedTask;
     private shouldSkipWorkflowMovePolicies;
     private prepareWorkflowMovePolicyPreflight;
     private evaluateWorkflowMovePolicies;
@@ -3001,6 +3015,7 @@ declare class TaskStore extends EventEmitter<TaskStoreEvents> {
         githubTracking?: TaskGithubTracking | null;
         tokenUsage?: TaskTokenUsage | null;
         modifiedFiles?: string[] | null;
+        workflowTransitionNotification?: Task["workflowTransitionNotification"] | null;
         missionId?: string | null;
         sliceId?: string | null;
     }, runContext?: RunMutationContext): Promise<Task>;
@@ -3309,6 +3324,7 @@ declare class TaskStore extends EventEmitter<TaskStoreEvents> {
     private resolveTaskWorkflowIrSync;
     private resolveEffectiveWorkflowIdSync;
     private countActiveInCapacitySlotSync;
+    private countActiveExecutionWorktreeHoldersSync;
     getTaskWorkflowSelection(taskId: string): {
         workflowId: string;
         stepIds: string[];
@@ -3504,6 +3520,7 @@ interface CreateInteractiveAiSessionOptions {
     requestedSkillNames?: string[];
     additionalSkillPaths?: string[];
     onProgress?: (event: InteractiveAiSessionProgressEvent) => void;
+    allowAnswerQuestionIdDrift?: boolean;
 }
 type InteractiveAiSessionProgressEvent = {
     type: "thinking";
@@ -4328,7 +4345,7 @@ declare const COMPLETION_DOCUMENTATION_MODES: readonly ["off", "changeset", "cha
 type CompletionDocumentationMode = (typeof COMPLETION_DOCUMENTATION_MODES)[number];
 declare const THEME_MODES: readonly ["dark", "light", "system"];
 type ThemeMode = (typeof THEME_MODES)[number];
-declare const COLOR_THEMES: readonly ["default", "ocean", "forest", "sunset", "zen", "berry", "high-contrast", "industrial", "monochrome", "slate", "ash", "air", "graphite", "silver", "solarized", "factory", "factory-mono", "ayu", "one-dark", "nord", "dracula", "gruvbox", "tokyo-night", "catppuccin-mocha", "github-dark", "everforest", "rose-pine", "kanagawa", "night-owl", "palenight", "monokai-pro", "slime", "brutalist", "neon-city", "parchment", "terminal", "glass", "horizon", "vitesse", "outrun", "snazzy", "porple", "espresso", "mars", "poimandres", "ember", "rust", "copper", "foundry", "carbon", "sandstone", "lagoon", "frost", "lavender", "neon-bloom", "sepia", "shadcn", "shadcn-custom", "shadcn-blue", "shadcn-green", "shadcn-red", "shadcn-purple", "shadcn-pink", "shadcn-orange", "shadcn-yellow", "shadcn-mono-red", "shadcn-mono-blue", "shadcn-mono-green", "shadcn-mono-purple", "shadcn-mono-pink", "shadcn-mono-orange", "shadcn-mono-yellow", "shadcn-black", "shadcn-gray", "shadcn-gray-blue"];
+declare const COLOR_THEMES: readonly ["default", "ocean", "forest", "sunset", "zen", "berry", "high-contrast", "industrial", "monochrome", "slate", "ash", "air", "graphite", "silver", "solarized", "factory", "factory-mono", "ayu", "one-dark", "nord", "dracula", "gruvbox", "tokyo-night", "catppuccin-mocha", "github-dark", "everforest", "rose-pine", "kanagawa", "night-owl", "palenight", "monokai-pro", "slime", "brutalist", "neon-city", "parchment", "terminal", "glass", "glass-silver", "horizon", "vitesse", "outrun", "snazzy", "porple", "espresso", "mars", "poimandres", "ember", "rust", "copper", "foundry", "carbon", "sandstone", "lagoon", "frost", "lavender", "neon-bloom", "sepia", "shadcn", "shadcn-ember", "shadcn-custom", "shadcn-blue", "shadcn-green", "shadcn-red", "shadcn-purple", "shadcn-pink", "shadcn-orange", "shadcn-yellow", "shadcn-mono-red", "shadcn-mono-blue", "shadcn-mono-green", "shadcn-mono-purple", "shadcn-mono-pink", "shadcn-mono-orange", "shadcn-mono-yellow", "shadcn-black", "shadcn-gray", "shadcn-gray-blue"];
 type ColorTheme = (typeof COLOR_THEMES)[number];
 declare const SUPPORTED_LOCALES: readonly ["en", "zh-CN", "zh-TW", "fr", "es", "ko"];
 type Locale = (typeof SUPPORTED_LOCALES)[number];
@@ -4419,6 +4436,7 @@ interface WorkflowStepResult {
     workflowStepId: string;
     workflowStepName: string;
     phase?: WorkflowStepPhase;
+    source?: "optional-group" | "node";
     status: "passed" | "failed" | "advisory_failure" | "skipped" | "pending";
     output?: string;
     verdict?: "APPROVE" | "APPROVE_WITH_NOTES" | "REVISE";
@@ -4537,6 +4555,15 @@ interface TaskLogEntry {
     outcome?: string;
     runContext?: RunMutationContext;
 }
+type WorkflowTransitionNotificationKind = "manual-merge-hold" | "recovery-requeue";
+interface WorkflowTransitionNotificationMarker {
+    kind: WorkflowTransitionNotificationKind;
+    column: ColumnId;
+    transitionId: string;
+    nodeId?: string;
+    reason?: string;
+    createdAt: string;
+}
 type ActivityEventType = "task:created" | "task:moved" | "task:updated" | "task:deleted" | "task:merged" | "task:failed" | "task:duplicate-warning-overridden" | "task:auto-archived-deterministic-duplicate" | "task:auto-archived-near-duplicate" | "task:near-duplicate-flagged" | "task:release-authorization-required" | "task:auto-archived-ghost-bug" | "task:auto-archived-duplicate" | "task:merge-worktree-reacquired" | "settings:updated" | "project:isolation-transition";
 interface ActivityLogEntry {
     id: string;
@@ -5115,6 +5142,7 @@ interface Task {
     stalePausedReview?: StalePausedReviewSignal;
     inReviewStalled?: InReviewStalledSignal;
     stalePausedTodo?: StalePausedTodoSignal;
+    workflowTransitionNotification?: WorkflowTransitionNotificationMarker;
     stalledReview?: StalledReviewSignal;
     tokenUsage?: TaskTokenUsage;
     size?: "S" | "M" | "L";
@@ -5403,6 +5431,7 @@ interface GlobalSettings {
     colorTheme?: ColorTheme;
     shadcnCustomColors?: Record<string, string>;
     dashboardFontScalePct?: number;
+    dismissModalsOnOutsideClick?: boolean;
     language?: Locale;
     defaultProvider?: string;
     defaultModelId?: string;
@@ -5579,6 +5608,7 @@ interface ProjectSettings {
     groupOverlappingFiles: boolean;
     ignoreHiddenOverlapPaths?: boolean;
     overlapIgnorePaths?: string[];
+    allowAbsoluteFileBrowserPaths?: boolean;
     autoMerge: boolean;
     testMode?: boolean;
     mergeRequestContractShadowEnabled?: boolean;
@@ -5617,6 +5647,8 @@ interface ProjectSettings {
     recycleWorktrees?: boolean;
     showWorktreeGrouping?: boolean;
     openTasksInRightSidebar?: boolean;
+    openMobileTasksInPopup?: boolean;
+    taskDetailChatFirst?: boolean;
     executorAllowSiblingBranchRename?: boolean;
     worktreeNaming?: "random" | "task-id" | "task-title";
     worktrunk?: WorktrunkSettings;
@@ -5694,7 +5726,8 @@ interface ProjectSettings {
         autoApproveBackendIds?: string[];
     };
     defaultAgentPermissionPolicy?: {
-        rules: Partial<AgentPermissionPolicyRules>;
+        rules?: Partial<AgentPermissionPolicyRules>;
+        toolRules?: AgentPermissionPolicyToolRules;
     };
     specStalenessEnabled?: boolean;
     specStalenessMaxAgeMs?: number;
@@ -5754,6 +5787,7 @@ interface ProjectSettings {
     githubCommentTemplate?: string;
     githubCloseSourceIssueOnDone?: boolean;
     githubTrackingEnabledByDefault?: boolean;
+    githubLinkImportedIssuesToTracking?: boolean;
     githubTrackingDefaultRepo?: string;
     githubTrackingDedupEnabled?: boolean;
     githubAuthMode?: GithubAuthMode;
@@ -5801,7 +5835,9 @@ interface ProjectSettings {
     reflectionAfterTask?: boolean;
     reviewHandoffPolicy?: "disabled" | "comment-triggered" | "always";
     quickChatButtonMode?: "floating" | "footer" | "off";
+    quickChatCloseOnOutsideClick?: boolean;
     showQuickChatFAB?: boolean;
+    showTaskChatsInCommonFeed?: boolean;
     chatAutoCleanupDays?: number;
     mailAutoCleanupDays?: number;
     operationalLogRetentionDays?: number;
@@ -6429,12 +6465,14 @@ declare const SANDBOX_PROVISIONING_APPROVAL_MODES: readonly ["always", "trusted-
 type SandboxProvisioningApprovalMode = (typeof SANDBOX_PROVISIONING_APPROVAL_MODES)[number];
 type AgentPermissionPolicyActionCategory = PermanentAgentSensitiveActionCategory;
 type AgentPermissionPolicyDisposition = "allow" | "block" | "require-approval";
+type AgentPermissionPolicyToolRules = Record<string, AgentPermissionPolicyDisposition>;
 declare const AGENT_PERMISSION_POLICY_PRESET_IDS: readonly ["unrestricted", "approval-required", "locked-down", "custom"];
 type AgentPermissionPolicyPresetId = (typeof AGENT_PERMISSION_POLICY_PRESET_IDS)[number];
 type AgentPermissionPolicyRules = Record<AgentPermissionPolicyActionCategory, AgentPermissionPolicyDisposition>;
 interface AgentPermissionPolicy {
     presetId: AgentPermissionPolicyPresetId;
     rules: AgentPermissionPolicyRules;
+    toolRules?: AgentPermissionPolicyToolRules;
 }
 interface Agent {
     id: string;

package/dist/plugins/fusion-plugin-acp-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/acp-runtime",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-cli-printing-press/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/cli-printing-press",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "type": "module",
   "private": true,
   "exports": {

package/dist/plugins/fusion-plugin-compound-engineering/bundled.js

@@ -1029,10 +1029,15 @@ function buildStageSystemPrompt(stage) {
     `You are running the Compound Engineering "${stage.stageId}" stage.`,
     `Apply the bundled skill "${stage.skillId}" (it has been loaded into this session).`,
     "",
+    /*
+     * FNXC:CompoundEngineering 2026-07-01-13:41:
+     * CE dashboard stages may load rich skills that were authored for chat/terminal flows, including instructions to ask blocking questions or write prose summaries. The interactive session seam is stricter: every visible turn must translate any loaded-skill instruction into the structured question/complete JSON protocol so a newly launched Debug stage cannot become an Error session from non-JSON output.
+     */
+    "The JSON protocol below has priority over any loaded-skill instruction about asking questions, using blocking question tools, writing prose summaries, previewing commits/PRs, or ending with chat text: translate any loaded-skill instruction into a JSON question or JSON complete event.",
     "Drive the stage as an interactive question/answer flow. On every turn respond with ONLY a JSON object:",
     '  - To ask the user something: {"type":"question","data":{"id":"<unique>","type":"single_select|multi_select|text|confirm","question":"...","options":[{"id":"..","label":".."}]}}',
     '  - When the stage is finished: {"type":"complete","data":{"artifact":"<full markdown document>", ...}}',
-    "No markdown fences, no prose outside the JSON object.",
+    "No markdown fences, no prose outside the JSON object. Do not call user-question tools from this interactive stage; emit a JSON question instead.",
     "",
     `The user's reply arrives as {"type":"answer","questionId":"...","response":...}. The response takes one of three shapes:`,
     "  - a direct answer to your question (an option id, array of option ids, text, or boolean),",
@@ -1085,7 +1090,7 @@ var CeOrchestrator = class {
    * bundled skill (closing the U2/U5 skill-discovery carry-forward). Model
    * provider/model are setting-gated (U9); omitted keys let the host pick defaults.
    */
-  buildSessionOptions(stage, sessionId) {
+  buildSessionOptions(stage, sessionId, opts = {}) {
     const defaultProvider = getDefaultProvider(this.ctx.settings);
     const defaultModelId = getDefaultModelId(this.ctx.settings);
     const additionalSkillPaths = resolveStageSkillPaths();
@@ -1096,6 +1101,11 @@ var CeOrchestrator = class {
       tools: "coding",
       requestedSkillNames: [stage.skillId],
       additionalSkillPaths,
+      /*
+       * FNXC:CompoundEngineering 2026-07-01-17:31:
+       * Question-id drift tolerance is recovery-only. Fresh CE sessions keep the strict interactive seam guard so live/DB question divergence is surfaced immediately; rehydration enables the tolerance because the persisted session row is the recovery anchor after a restart.
+       */
+      ...opts.allowAnswerQuestionIdDrift ? { allowAnswerQuestionIdDrift: true } : {},
       onProgress: (event) => this.handleProgress(sessionId, event),
       ...defaultProvider ? { defaultProvider } : {},
       ...defaultModelId ? { defaultModelId } : {}
@@ -1367,7 +1377,9 @@ var CeOrchestrator = class {
     }
   }
   async rehydrateReplay(session, stage) {
-    const interactive = await this.factory(this.buildSessionOptions(stage, session.id));
+    const interactive = await this.factory(
+      this.buildSessionOptions(stage, session.id, { allowAnswerQuestionIdDrift: true })
+    );
     const live = interactive.session;
     const userTurns = session.conversationHistory.filter((t) => t.role === "user");
     try {

package/dist/plugins/fusion-plugin-compound-engineering/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/compound-engineering",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-cursor-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/cursor-runtime",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-dependency-graph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/dependency-graph",
-  "version": "0.1.45",
+  "version": "0.1.47",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-droid-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/droid-runtime",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-hermes-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/hermes-runtime",
-  "version": "0.2.64",
+  "version": "0.2.66",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-openclaw-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/openclaw-runtime",
-  "version": "0.2.64",
+  "version": "0.2.66",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-paperclip-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/paperclip-runtime",
-  "version": "0.2.64",
+  "version": "0.2.66",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-reports/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/reports",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "type": "module",
   "private": true,
   "exports": {

package/dist/plugins/fusion-plugin-roadmap/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/roadmap",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-whatsapp-chat/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/whatsapp-chat",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "type": "module",
   "private": true,
   "exports": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runfusion/fusion",
-  "version": "0.51.0",
+  "version": "0.53.0",
   "license": "MIT",
   "description": "Fusion CLI: HTTP API server, daemon, dashboard launcher, and task tooling for the Fusion AI coding agent.",
   "homepage": "https://github.com/Runfusion/Fusion#readme",
@@ -34,6 +34,7 @@
     "dist/**/*.d.ts.map",
     "dist/**/*.js.map",
     "dist/client/**",
+    "dist/desktop/**",
     "dist/pi-claude-cli/**",
     "dist/droid-cli/**",
     "dist/plugins/**",
@@ -41,8 +42,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@earendil-works/pi-ai": "^0.79.9",
-    "@earendil-works/pi-coding-agent": "^0.79.9",
+    "@earendil-works/pi-ai": "^0.80.3",
+    "@earendil-works/pi-coding-agent": "^0.80.3",
     "dockerode": "^4.0.12",
     "express": "^5.1.0",
     "i18next": "^26.3.1",

package/skill/fusion/SKILL.md

@@ -28,6 +28,7 @@ Mission → Milestone → Slice → Feature → Task
 **Tool categories:**
 <!-- BEGIN: tool-categories (auto-generated by scripts/sync-fusion-skill-tools.mjs — do not edit by hand) -->
 - **Task tools** — `fn_task_create`, `fn_task_update`, `fn_task_list`, `fn_task_show`, `fn_task_attach`, `fn_task_pause`, `fn_task_unpause`, `fn_task_retry`, `fn_task_duplicate`, `fn_task_refine`, `fn_task_archive`, `fn_task_unarchive`, `fn_task_delete`, `fn_task_plan`
+- **Workflow tools** — `fn_workflow_list`, `fn_workflow_get`, `fn_workflow_create`, `fn_workflow_update`, `fn_workflow_delete`, `fn_workflow_settings`, `fn_trait_list`, `fn_workflow_select`
 - **GitHub tools** — `fn_task_import_github`, `fn_task_import_github_issue`, `fn_task_browse_github_issues`
 - **Mission tools** — `fn_mission_create`, `fn_mission_list`, `fn_mission_show`, `fn_mission_list_goals`, `fn_mission_link_goal`, `fn_mission_unlink_goal`, `fn_mission_backfill_assertions`, `fn_mission_delete`, `fn_mission_update`, `fn_milestone_add`, `fn_slice_add`, `fn_feature_add`, `fn_feature_delete`, `fn_slice_delete`, `fn_milestone_delete`, `fn_slice_activate`, `fn_feature_link_task`, `fn_feature_update`, `fn_milestone_update`
 - **Goal tools** — `fn_goal_list`, `fn_goal_create`, `fn_goal_archive`, `fn_goal_show`

package/skill/fusion/references/engine-tools.md

@@ -1,11 +1,11 @@
 # Engine Session-Scoped Tools
 
-These tools are **not** part of the user-invokable extension surface. They are injected by the engine at runtime for specific agent session types.
+This reference documents tools injected by the engine at runtime for specific agent session types. Some shared workflow tools are also part of the public extension surface; use `references/extension-tools.md` as the canonical user-invokable extension reference and this page for runtime agent-role availability.
 
 - Source files: `packages/engine/src/agent-tools.ts`, `triage.ts`, `executor.ts`, `merger.ts`, `agent-heartbeat.ts`
 - Availability: only when the engine creates a session for the matching agent role
 - Runtime contract: engine sessions now forward requested skill names (`skillSelection.requestedSkillNames`) into the generic runtime `skills` field so non-pi runtimes can still receive Fusion skill intent.
-- Important: do not tell users to call these directly from the generic extension tool list
+- Important: do not tell users to call runtime-only tools directly from the generic extension tool list
 
 ## Shared runtime tools (`agent-tools.ts`)
 
@@ -54,7 +54,7 @@ These tools are **not** part of the user-invokable extension surface. They are i
 | `fn_send_message` | executor, step-session, heartbeat | Send inbox messages to agents/users | `to_id` (string), `content` (string), `type?` (`agent-to-agent` \| `agent-to-user`), `reply_to_message_id?` (string) |
 | `fn_read_messages` | executor, step-session, heartbeat | Read inbox messages | `unread_only?` (boolean), `limit?` (number) |
 | `fn_post_room_message` | heartbeat | Post a message to a chat room the agent is a member of | `roomId` (string), `content` (string), `replyToMessageId?` (string), `mentions?` (string[]) |
-| `fn_artifact_register` | triage, executor, heartbeat; chat/planning (explicit `task_id`) | Register an artifact (document, image, video, audio, or other) so other agents and tasks can discover it | `type` (string), `title` (string), `description?` (string), `mimeType?` (string), `uri?` (string), `content?` (string), `taskId?` (string); chat/planning also require `task_id` (string) |
+| `fn_artifact_register` | triage, executor, heartbeat; chat/planning (explicit `task_id`) | Register an artifact (document, image, video, audio, or other) so other agents and tasks can discover it; image artifacts may provide `dataBase64` bytes for registry-managed media storage | `type` (string), `title` (string), `description?` (string), `mimeType?` (string), `uri?` (string), `content?` (string), `dataBase64?` (base64 string), `taskId?` (string); chat/planning also require `task_id` (string) |
 | `fn_artifact_list` | triage, executor, heartbeat; chat/planning (explicit `task_id`) | List registered artifacts across agents and tasks with filters for type, authorId, taskId, search, limit, and offset | `type?` (string), `authorId?` (string), `taskId?` (string), `search?` (string), `limit?` (number), `offset?` (number); chat/planning also require `task_id` (string) |
 | `fn_artifact_view` | triage, executor, heartbeat | View a registered artifact by id, including metadata and inline content or the uri/path reference for media artifacts | `id` (string) |