@pi-unipi/unipi 2.16.0 → 2.17.0

package/CHANGELOG.md

@@ -6,7 +6,30 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
-## [2.16.0] — 2026-09-03
+## [2.17.0] — 2026-09-15
+
+### Added
+
+- `fusion`: **Local Fusion runtime — a real lead + sidekick pair.** Picking a Fusion preset now wires up a persistent sidekick subagent, not just a status label, via two new agent tools:
+  - `sidekick` — hand off implementation/verification work to a persistent sidekick child process, spawned in pi's RPC mode (`--mode rpc`) with the active pair's sidekick model + effort and its own session file under `~/.unipi/state/fusion/sidekick/<session>.jsonl`. Blocking dispatch is the default (`block:true` waits and returns the report); `block:false` returns immediately and later delivers a `<subagent_completion_notification>` with the report. Calling `sidekick` again while a handoff is running injects the message as an interrupt instead of spawning a second process.
+  - `read_subagent` — read a handoff report by `agent_id` (or the latest); `block:true` waits (default 2700s), `block:false` returns a live progress snapshot (tool-call count, recent tools, text tail).
+  - The runtime (`sidekick-runtime.ts`) keeps one persistent child per session, streams progress (`◆ sidekick working · N tool calls · 12.3s`), accumulates usage (input/output/cache-read/cache-write tokens + cost), and returns a structured `HandoffReport` (`status`, `text`, `usage`, `toolCalls`, `durationMs`).
+  - A delegate-by-default policy (`leadPolicy()` in `prompts.ts`) is appended to the lead's system prompt on every turn while Fusion is active, the sidekick child gets a dedicated role prompt (`sidekickSystemPrompt()`), and a one-time `FIRST_EDIT_NUDGE` reminds the lead to brief the sidekick instead of editing when a change is larger than trivial.
+- `fusion`: **`/unipi:fusion-stats`** command — reports sidekick token usage, estimated savings, handoff count, and runtime liveness.
+- `fusion`: **savings estimation** (`estimateSavings()` in `savings.ts`) — prices sidekick usage at both the sidekick and lead model rates and reports the difference; surfaced in the stats command and the footer.
+- `footer`: **the glance frame now renders the active Fusion pair** in the model slot — `Fusion · <lead> <effort> ◆ <sidekick>` with the lead lit and the sidekick muted, plus `· saved $X.XX` once savings pass half a cent; the separate thinking slot is suppressed while a pair is active.
+- `core`: new `fusion-status` module (`setSharedFusionStatus`/`getSharedFusionStatus`) — a `Symbol.for` shared registry (same pattern as background-tasks) that lets `fusion` publish the active pair and `footer` render it without a hard dependency.
+
+### Changed
+
+- `fusion`: **now depends on `@pi-unipi/subagents`** — the sidekick child is spawned via `getPiSpawnCommand` from `@pi-unipi/subagents/src/pi-spawn.js`, reusing the subagents package's spawn logic instead of re-implementing it.
+- `fusion`: the picker shows **model badges** (from the preset), decouples effort selection, and renders a **rainbow price slider** (`slider.ts`) placing each model on a log-scaled cost gradient; confirming a Fusion pair now records it as the preset default.
+
+## [2.16.1] — 2026-09-11
+
+### Fixed
+
+- `notify`: **recap no longer silently degrades on thinking models** (GitHub [#36](https://github.com/Neuron-Mr-White/UniPi/issues/36)) — recap summarizes with a 100-token budget, and a thinking model served by llama.cpp/vLLM could burn the entire budget on reasoning tokens and return no visible content, falling back to the raw 100-character truncation. New `recap.disableThinking` config flag (default `false`) sends `chat_template_kwargs: { enable_thinking: false, preserve_thinking: false }` with recap requests so chat-template servers skip reasoning entirely. Opt-in because strict OpenAI-compatible endpoints reject unknown body params; the Anthropic path is unaffected. 5 new tests in `src/__tests__/summarize.test.ts`.
 
 ### Added
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -35,7 +35,9 @@
     "docs/prefix-cache-architecture.md",
     "packages/*/package.json",
     "packages/*/*.ts",
+    "packages/*/tests/**/*.ts",
     "packages/*/src/**/*.ts",
+    "packages/*/src/**/*.json",
     "packages/*/extensions/**/*.ts",
     "packages/*/bridge/**/*.py",
     "packages/*/platforms/*",
@@ -82,28 +84,29 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "2.16.0",
-    "@pi-unipi/background-tasks": "2.16.0",
-    "@pi-unipi/btw": "2.16.0",
-    "@pi-unipi/command-enchantment": "2.16.0",
-    "@pi-unipi/compactor": "2.16.0",
-    "@pi-unipi/core": "2.16.0",
-    "@pi-unipi/footer": "2.16.0",
-    "@pi-unipi/image": "2.16.0",
-    "@pi-unipi/info-screen": "2.16.0",
-    "@pi-unipi/input-shortcuts": "2.16.0",
-    "@pi-unipi/kanboard": "2.16.0",
-    "@pi-unipi/mcp": "2.16.0",
-    "@pi-unipi/memory": "2.16.0",
-    "@pi-unipi/milestone": "2.16.0",
-    "@pi-unipi/notify": "2.16.0",
-    "@pi-unipi/ralph": "2.16.0",
-    "@pi-unipi/subagents": "2.16.0",
-    "@pi-unipi/trajectory": "2.16.0",
-    "@pi-unipi/updater": "2.16.0",
-    "@pi-unipi/utility": "2.16.0",
-    "@pi-unipi/web-api": "2.16.0",
-    "@pi-unipi/workflow": "2.16.0"
+    "@pi-unipi/ask-user": "2.17.0",
+    "@pi-unipi/background-tasks": "2.17.0",
+    "@pi-unipi/btw": "2.17.0",
+    "@pi-unipi/command-enchantment": "2.17.0",
+    "@pi-unipi/compactor": "2.17.0",
+    "@pi-unipi/core": "2.17.0",
+    "@pi-unipi/footer": "2.17.0",
+    "@pi-unipi/image": "2.17.0",
+    "@pi-unipi/fusion": "2.17.0",
+    "@pi-unipi/info-screen": "2.17.0",
+    "@pi-unipi/input-shortcuts": "2.17.0",
+    "@pi-unipi/kanboard": "2.17.0",
+    "@pi-unipi/mcp": "2.17.0",
+    "@pi-unipi/memory": "2.17.0",
+    "@pi-unipi/milestone": "2.17.0",
+    "@pi-unipi/notify": "2.17.0",
+    "@pi-unipi/ralph": "2.17.0",
+    "@pi-unipi/subagents": "2.17.0",
+    "@pi-unipi/trajectory": "2.17.0",
+    "@pi-unipi/updater": "2.17.0",
+    "@pi-unipi/utility": "2.17.0",
+    "@pi-unipi/web-api": "2.17.0",
+    "@pi-unipi/workflow": "2.17.0"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.84.0",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.16.0"
+    "@pi-unipi/core": "2.17.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/autocomplete/src/constants.ts

@@ -37,6 +37,7 @@ export const PACKAGE_ORDER: string[] = [
   "image",
   "subagents",
   "background-tasks",
+  "fusion",
 ];
 
 // ─── Package Colors ──────────────────────────────────────────────────
@@ -62,6 +63,7 @@ export const PACKAGE_COLORS: Record<string, string> = {
   image:     `${ESC}[35m`, // Magenta
   subagents: `${ESC}[34m`, // Blue
   "background-tasks": `${ESC}[91m`, // Bright Red
+  fusion:    `${ESC}[96m`, // Bright Cyan
 };
 
 // ─── Command Registry ────────────────────────────────────────────────
@@ -143,17 +145,13 @@ export const COMMAND_REGISTRY: Record<string, string> = {
 
   // background-tasks (8 commands)
   "unipi:bg":          "background-tasks",
-  "unipi:bg-clear":    "background-tasks",
   "unipi:bg-tasks":    "background-tasks",
   "unipi:bg-settings": "background-tasks",
-  "unipi:bg-update":   "background-tasks",
-  "unipi:tasks":       "background-tasks",
-  "unipi:jobs":        "background-tasks",
-  "unipi:kill":        "background-tasks",
-  "unipi:logs":        "background-tasks",
-  "unipi:claude-cache": "background-tasks",
-  "unipi:fusion":        "background-tasks",
-  "unipi:fusion-models": "background-tasks",
+
+  // fusion (3 commands)
+  "unipi:model":         "fusion",
+  "unipi:fusion-preset": "fusion",
+  "unipi:fusion-stats":  "fusion",
 
   // info (2 commands)
   "unipi:info":          "info",
@@ -316,17 +314,11 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:stash-settings":   "Open input shortcuts settings — customize keybindings",
 
   "unipi:bg":          "Start a shell command as a tracked background task",
-  "unipi:bg-clear":    "Clear finished background task footer notices",
   "unipi:bg-tasks":    "Open the background task manager UI",
   "unipi:bg-settings": "Open background-tasks settings (master toggle, defaults)",
-  "unipi:bg-update":  "Show installed background-tasks version and update instructions",
-  "unipi:tasks":       "Open the background task manager UI",
-  "unipi:jobs":        "List running and recent background tasks",
-  "unipi:kill":        "Stop a running background task: /unipi:kill <id>",
-  "unipi:logs":        "Show bounded output from a background task",
-  "unipi:claude-cache": "Show or set Claude cache retention for this session",
-  "unipi:fusion":        "Run the Fusion reason workflow with a prompt",
-  "unipi:fusion-models": "Open the Fusion five-slot model selector",
+  "unipi:model":         "Pick a model or Fusion lead+sidekick pair (Devin-style picker)",
+  "unipi:fusion-preset": "Curate the model preset used by /unipi:model",
+  "unipi:fusion-stats":  "Estimated Fusion savings (sidekick tokens priced at lead rates)",
   "unipi:subagents-fleet":  "Open the subagents fleet view",
   "unipi:subagents-doctor": "Diagnose subagents configuration",
   "unipi:subagents-guide":  "Show the subagents usage guide",
@@ -355,4 +347,5 @@ export const PACKAGE_LABELS: Record<string, string> = {
   image:     "image",
   subagents: "subagents",
   "background-tasks": "background-tasks",
+  fusion:    "fusion",
 };

package/packages/background-tasks/README.md

@@ -1,10 +1,11 @@
 # @pi-unipi/background-tasks
 
-Background tasks for UniPi — a full adoption of
-[pi-background-tasks](https://github.com/ismailsaleekh/pi-background-tasks) into the
-unipi conventions: durable background shell jobs, read-only delegated agents,
-attested Pi runs, fixed-purpose multi-model Fusion workflows, and package-owned
-Anthropic subscription attribution.
+Background tasks for UniPi — durable background shell jobs plus one read-only
+delegated background agent, with a footer dock the user can manage while the
+agent keeps working. Originally adopted from
+[pi-background-tasks](https://github.com/ismailsaleekh/pi-background-tasks);
+the Fusion council, attested Pi runs, and Anthropic attribution surfaces were
+removed in 2.17.0 so the module does exactly one thing.
 
 ## Master toggle
 
@@ -19,37 +20,37 @@ One config key disables the entire module — no tools, no commands, no hooks, n
 ```
 
 Open `/unipi:bg-settings` for the interactive settings overlay (master toggle,
-defaults, output caps, delegate/fusion defaults).
+defaults, output caps, delegate defaults).
 
 ## Surfaces
 
-### Tools (reference names kept)
+### Tools
 
 | Tool | Purpose |
 | --- | --- |
 | `bg_run` | Start a named long-running shell command; terminal notification wakes a follow-up turn by default |
 | `bg_status` / `bg_logs` / `bg_kill` | Point-in-time inspection, bounded log reads, stop — never polling primitives |
 | `bg_delegate` + `bg_result` | One read-only child Pi agent seeded with a frozen projection of this conversation; hash-verified answer retrieval |
-| `bg_run_pi_attested` | Evidence-oriented direct Pi spawn with local hashes and route attestation |
-| `fusion_reason` | 3 candidates → blind evaluator → merger on the session projection |
-| `fusion_investigate` / `fusion_research` / `fusion_validate` | Fixed-purpose multi-model workflows on clean-task input (inspect tools / caller-URL research / advisory review) |
 
-### Commands (our namespace)
+### Commands
 
-`/unipi:bg`, `/unipi:bg-clear`, `/unipi:bg-tasks`, `/unipi:bg-update`,
-`/unipi:tasks`, `/unipi:jobs`, `/unipi:kill`, `/unipi:logs`,
-`/unipi:bg-settings`, `/unipi:fusion`, `/unipi:fusion-models`,
-`/unipi:claude-cache`.
+`/unipi:bg` (start a shell task), `/unipi:bg-tasks` (open the dock),
+`/unipi:bg-settings`.
 
 Shortcuts: `Shift↓` opens the task manager dock; `Ctrl+Alt+C` clears finished notices.
 
+## What the user sees
+
+- **Launch card** — `bg_run` results render as a tinted card (`● bg started <name> · wakes agent on completion`) so the start of a task is visible in the transcript.
+- **Pending-wake line** — while the agent is idle but a task that will wake it is still running, a spinner line sits above the editor: `⠋ waiting on 1 bg task · <name> 12s — agent resumes automatically when done`. Without this the UI looks finished and users assume the turn is over.
+- **Completion card** — the terminal notification renders as a tinted card (`✓ bg done <name> · exit 0 · 25s · agent woken`) with the last three output lines. Failed / stopped tasks use the error tint.
+- **Dock** (`Shift↓`) — rows show `⏰ wakes agent` for tasks that will resume the agent, and the last output line for running shell tasks.
+
 ## Storage layout (ours — never `.pi/`)
 
 - Runtime artifacts (task output/metadata): `$TMPDIR/unipi-bg-tasks/<session>-<pid>-<nonce>/`
 - Durable delegate artifacts: `<workspace>/.unipi/delegate/<session>-<pid>/<task-id>/`
-- Durable fusion artifacts: `<workspace>/.unipi/fusion/<session>-<pid>/<run-id>/`
 - Config: `~/.unipi/config/background-tasks.json` + workspace override
-- Fusion model config: five-slot selector persisted through `/unipi:fusion-models`
 
 ## Environment
 
@@ -67,13 +68,6 @@ Shortcuts: `Shift↓` opens the task manager dock; `Ctrl+Alt+C` clears finished
 
 Treat `<background-task-notification>` as durable terminal truth — do not poll.
 
-## Attribution
-
-`extensions/anthropic-attribution.ts` loads first (provider-gated): Claude Code
-subscription OAuth attribution, exact-match system-prompt sanitization, and
-cache-retention policy for Anthropic routes. Duplicate installed copies resolve
-ownership through an EventBus claim; later copies go inert.
-
 ## Shared registry (for sibling extensions)
 
 Other packages can read the live task registry synchronously — no events, no polling:
@@ -94,10 +88,10 @@ treat that as "no data", e.g. the footer's glance process line does.
 
 - Commands live in the `/unipi:*` namespace; env prefix is `UNIPI_BG_*`.
 - Runtime artifacts under the OS temp root (per-registry nonce) and durable
-  delegate/fusion artifacts under workspace `.unipi/` — never `.pi/`.
+  delegate artifacts under workspace `.unipi/` — never `.pi/`.
 - The reference's `update-check` footer surface is dropped (unipi's updater
   module owns updates).
-- `agent_settled` / `before_provider_headers` hooks register defensively on our
-  pi SDK with an `agent_end` settlement fallback.
+- Removed: attested Pi runs, the five-slot Fusion council tools, and the
+  Anthropic attribution provider override.
 
 ISC-licensed reference: Copyright Ismail <ismailsalikhodjaev@gmail.com>.

package/packages/background-tasks/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "2.16.0",
-  "description": "Background tasks for UniPi — durable shell jobs, delegated agents, attested Pi runs, and fixed-purpose Fusion workflows",
+  "version": "2.17.0",
+  "description": "Background tasks for UniPi — durable shell jobs and delegated background agents with a footer dock",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.84.0",
-    "@pi-unipi/core": "2.16.0",
+    "@pi-unipi/core": "2.17.0",
     "turndown": "^7.2.4"
   },
   "devDependencies": {
@@ -31,7 +31,6 @@
   ],
   "pi": {
     "extensions": [
-      "./extensions/anthropic-attribution.ts",
       "./src/index.ts"
     ],
     "skills": [],

package/packages/background-tasks/src/cards.ts

@@ -0,0 +1,76 @@
+/**
+ * @pi-unipi/background-tasks — tinted chat cards
+ *
+ * Background-task launch/completion messages were plain single lines that got
+ * lost in the transcript. These helpers render them as padded, background-
+ * tinted boxes (same visual language as pi's tool cards) so a user scanning
+ * the chat can spot "a bg task started here" / "it finished here" at a glance.
+ */
+import { Box, Text } from "@earendil-works/pi-tui";
+import { formatDuration, taskDisplayName, type BgTaskSnapshot } from "./types.js";
+
+type ThemeLike = {
+  fg: (color: string, text: string) => string;
+  bg: (color: string, text: string) => string;
+  bold: (text: string) => string;
+};
+
+type CardTone = "pending" | "success" | "error";
+
+const BG_FOR_TONE: Record<CardTone, string> = {
+  pending: "toolPendingBg",
+  success: "toolSuccessBg",
+  error: "toolErrorBg",
+};
+
+function toneFor(status: BgTaskSnapshot["status"]): CardTone {
+  if (status === "running") return "pending";
+  if (status === "completed") return "success";
+  return "error";
+}
+
+function statusGlyph(theme: ThemeLike, status: BgTaskSnapshot["status"]): string {
+  if (status === "running") return theme.fg("accent", "●");
+  if (status === "completed") return theme.fg("success", "✓");
+  if (status === "killed") return theme.fg("warning", "■");
+  return theme.fg("error", "✗");
+}
+
+function card(theme: ThemeLike, tone: CardTone, lines: string[]): Box {
+  const box = new Box(1, 0, (text) => theme.bg(BG_FOR_TONE[tone], text));
+  box.addChild(new Text(lines.join("\n"), 0, 0));
+  return box;
+}
+
+/** `bg_run` result card: "● bg started <name> (id) · will wake agent" */
+export function renderLaunchCard(theme: ThemeLike, task: BgTaskSnapshot): Box {
+  const wake = task.triggerOnCompletion
+    ? theme.fg("dim", " · wakes agent on completion")
+    : task.notifyOnCompletion
+      ? theme.fg("dim", " · notifies on completion")
+      : theme.fg("dim", " · silent");
+  const head = `${statusGlyph(theme, "running")} ${theme.fg("accent", theme.bold("bg started"))} ${theme.fg("accent", taskDisplayName(task))} ${theme.fg("dim", `(${task.id})`)}${wake}`;
+  const cmd = theme.fg("dim", `$ ${task.command.length > 120 ? `${task.command.slice(0, 120)}…` : task.command}`);
+  return card(theme, "pending", [head, cmd]);
+}
+
+/** Completion notification card: "✓ bg done <name> · exit 0 · 25s" + last output lines */
+export function renderCompletionCard(theme: ThemeLike, task: BgTaskSnapshot | undefined): Box {
+  if (task === undefined) {
+    return card(theme, "success", [`${theme.fg("success", "✓")} ${theme.fg("accent", theme.bold("bg done"))}`]);
+  }
+  const tone = toneFor(task.status);
+  const label =
+    task.status === "completed" ? "bg done" : task.status === "killed" ? "bg stopped" : "bg failed";
+  const meta: string[] = [];
+  if (task.exitCode !== undefined && task.exitCode !== null) meta.push(`exit ${String(task.exitCode)}`);
+  if (task.endTime !== undefined) meta.push(formatDuration(task.endTime - task.startTime));
+  if (task.triggerOnCompletion) meta.push("agent woken");
+  const head = `${statusGlyph(theme, task.status)} ${theme.fg(tone === "error" ? "error" : "success", theme.bold(label))} ${theme.fg("accent", taskDisplayName(task))} ${theme.fg("dim", `(${task.id})`)}${meta.length > 0 ? theme.fg("dim", ` · ${meta.join(" · ")}`) : ""}`;
+  const lines = [head];
+  if (task.error) lines.push(theme.fg("error", task.error));
+  const tail = task.outputTail ?? [];
+  for (const line of tail) lines.push(theme.fg("toolOutput", `  ${line}`));
+  lines.push(theme.fg("dim", `  ${task.outputPath}`));
+  return card(theme, tone, lines);
+}

package/packages/background-tasks/src/child-process.ts

@@ -1,7 +1,7 @@
 /**
  * @pi-unipi/background-tasks — Shared child-process & context interfaces
  *
- * Consumed by types.ts, registry.ts, attested-pi-run.ts, and tests.
+ * Consumed by types.ts, registry.ts, and tests.
  */
 
 import type { SpawnOptions } from "node:child_process";

package/packages/background-tasks/src/config.ts

@@ -34,13 +34,6 @@ export interface BackgroundTasksConfig {
     maxToolCalls: number;
     timeoutSeconds: number;
   };
-  /** Fusion defaults. */
-  fusion: {
-    /** Five-slot model selections ('' = $current). */
-    candidates: [string, string, string];
-    evaluator: string;
-    merger: string;
-  };
 }
 
 export const DEFAULT_CONFIG: BackgroundTasksConfig = {
@@ -57,11 +50,6 @@ export const DEFAULT_CONFIG: BackgroundTasksConfig = {
     maxToolCalls: 120,
     timeoutSeconds: 900,
   },
-  fusion: {
-    candidates: ["", "", ""],
-    evaluator: "",
-    merger: "",
-  },
 };
 
 function getGlobalConfigPath(): string {
@@ -181,28 +169,6 @@ export function validateBackgroundTasksConfig(config: unknown): string[] {
       }
     }
   }
-  if (c.fusion !== undefined) {
-    if (typeof c.fusion !== "object" || c.fusion === null) {
-      problems.push("fusion must be an object");
-    } else {
-      const f = c.fusion as Record<string, unknown>;
-      for (const key of ["candidates", "evaluator", "merger"] as const) {
-        const value = f[key];
-        if (value === undefined) continue;
-        if (key === "candidates") {
-          if (
-            !Array.isArray(value) ||
-            value.length !== 3 ||
-            value.some((v) => typeof v !== "string")
-          ) {
-            problems.push("fusion.candidates must be an array of exactly 3 strings");
-          }
-        } else if (typeof value !== "string") {
-          problems.push(`fusion.${key} must be a string`);
-        }
-      }
-    }
-  }
   return problems;
 }
 
@@ -272,14 +238,6 @@ export function loadBackgroundTasksConfig(cwd: string): LoadedBackgroundTasksCon
           ? merged.delegate.autoDeliver
           : "when_small",
     },
-    fusion: {
-      candidates:
-        Array.isArray(merged.fusion?.candidates) && merged.fusion.candidates.length === 3
-          ? ([...merged.fusion.candidates] as [string, string, string])
-          : DEFAULT_CONFIG.fusion.candidates,
-      evaluator: typeof merged.fusion?.evaluator === "string" ? merged.fusion.evaluator : "",
-      merger: typeof merged.fusion?.merger === "string" ? merged.fusion.merger : "",
-    },
   };
   return { config, warnings };
 }

package/packages/background-tasks/src/context-visible-conversation-v2.ts

@@ -1,6 +1,6 @@
 import { createHash } from 'node:crypto';
 import type { Message } from '@earendil-works/pi-ai';
-import { canonicalJson } from './attested-pi-run.js';
+import { canonicalJson } from './json-utils.js';
 
 /**
  * Frozen `visible-conversation-ledger-v2` transform.

package/packages/background-tasks/src/delegate/artifacts.ts

@@ -2,7 +2,7 @@ import { createHash } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { chmod, mkdir, open, readFile, rename, rm } from 'node:fs/promises';
 import { basename, isAbsolute, join, relative, sep } from 'node:path';
-import { canonicalJson } from '../attested-pi-run.js';
+import { canonicalJson } from '../json-utils.js';
 import { sanitizePathSegment } from '../types.js';
 import { replaceFileDurable, writeFileDurable } from '../durable-fs.js';
 import {

package/packages/background-tasks/src/delegate/hook-contract-evidence.json

@@ -0,0 +1,18 @@
+{
+  "schema_version": "pi-background-tasks.delegate-hook-contract.v1",
+  "contract_id": "context-measure-abort-v1+tool-result-spill-v1",
+  "guarantees": {
+    "context_fires_before_every_model_call": true,
+    "context_result_messages_reach_provider": true,
+    "context_abort_blocks_provider_call": true,
+    "context_abort_skips_stream_invocation": false,
+    "context_abort_terminates_run": true,
+    "context_throw_blocks_provider_call": false,
+    "context_throw_isolated_to_throwing_handler": true,
+    "tool_result_fires_before_transcript_entry": true,
+    "tool_result_replacement_reaches_provider": true,
+    "tool_result_replacement_preserves_identity": true,
+    "tool_result_chains_in_load_order": true,
+    "handlers_run_in_extension_load_order": true
+  }
+}

package/packages/background-tasks/src/delegate/launch.ts

@@ -1,5 +1,6 @@
 import { randomBytes } from 'node:crypto';
 import { existsSync } from 'node:fs';
+import { packageAssetSearchHint, resolvePackageAsset } from '../package-assets.js';
 import { mkdir } from 'node:fs/promises';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -184,15 +185,20 @@ export function resolveDelegateChildExtensionPath(
   moduleUrl = import.meta.url,
   pathExists: (path: string) => boolean = existsSync,
 ): string {
-  const modulePath = fileURLToPath(moduleUrl);
-  const extension = modulePath.endsWith('.ts') ? 'delegate-child.ts' : 'delegate-child.js';
-  const candidate = resolve(dirname(modulePath), '../../extensions', extension);
-  if (!pathExists(candidate)) {
-    throw new DelegateError(`delegate child extension is missing: ${candidate}`, {
-      code: 'delegate_isolation_unsupported',
-      childCreated: false,
-      remediation: ['Reinstall the package; the child guard extension is required to spawn.'],
-    });
+  // Prefer the TypeScript guard (pi loads extensions through jiti); fall back
+  // to a compiled copy when one exists.
+  const candidate =
+    resolvePackageAsset('extensions/delegate-child.ts', { moduleUrl, pathExists }) ??
+    resolvePackageAsset('extensions/delegate-child.js', { moduleUrl, pathExists });
+  if (candidate === undefined) {
+    throw new DelegateError(
+      `delegate child extension is missing: ${packageAssetSearchHint('extensions/delegate-child.ts')}`,
+      {
+        code: 'delegate_isolation_unsupported',
+        childCreated: false,
+        remediation: ['Reinstall the package; the child guard extension is required to spawn.'],
+      },
+    );
   }
   return candidate;
 }
@@ -201,7 +207,7 @@ export function resolveDelegateChildExtensionPath(
  * Tools the inspect capability permits.
  *
  * v1 is read-only by construction: no shell, no network, no edit/write, no
- * recursive delegation, no Fusion. The list is passed to `--tools`, so it is
+ * recursive delegation. The list is passed to `--tools`, so it is
  * enforced by the child's tool registry rather than by prompt text.
  */
 export const DELEGATE_INSPECT_TOOLS: readonly string[] = [
@@ -223,12 +229,6 @@ export const DELEGATE_FORBIDDEN_TOOLS: readonly string[] = [
   'bg_kill',
   'bg_status',
   'bg_logs',
-  'bg_run_pi_attested',
-  'fusion_brainstorm',
-  'fusion_reason',
-  'fusion_investigate',
-  'fusion_research',
-  'fusion_validate',
 ];
 
 export function delegateToolsFor(capability: DelegateCapability): readonly string[] {
@@ -256,7 +256,6 @@ export interface DelegateChildArgvInput {
   childSessionId: string;
   childSessionDir: string;
   childExtensionPath: string;
-  attributionExtensionPath?: string | undefined;
   systemPrompt: string;
 }
 
@@ -282,19 +281,7 @@ export function buildDelegateChildArgv(input: DelegateChildArgvInput): string[]
       );
     }
   }
-  const extensionPaths =
-    input.route.provider === 'anthropic'
-      ? [
-          input.attributionExtensionPath ??
-            (() => {
-              throw new DelegateError(
-                'Anthropic delegate launch requires the package attribution extension',
-                { code: 'delegate_isolation_unsupported', childCreated: false },
-              );
-            })(),
-          input.childExtensionPath,
-        ]
-      : [input.childExtensionPath];
+  const extensionPaths = [input.childExtensionPath];
 
   return [
     '--mode',

package/packages/background-tasks/src/delegate/result-package.ts

@@ -1,5 +1,5 @@
 import { createHash } from 'node:crypto';
-import { canonicalJson } from '../attested-pi-run.js';
+import { canonicalJson } from '../json-utils.js';
 import {
   DELEGATE_RECEIPT_SCHEMA_VERSION,
   DELEGATE_RESULT_PACKAGE_SCHEMA_VERSION,