@pi-unipi/unipi 3.0.0-alpha.2 → 3.0.0-alpha.3

package/CHANGELOG.md

@@ -6,6 +6,36 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.3] — 2026-09-27
+
+### Breaking Changes
+
+- **BREAKING: `subagents` rebuilt on Devin's model.** `spawn_helper`/`get_helper_result` and `bg_delegate`/`bg_result` are gone, along with workflow scripts, missions, schedules, budgets, acceptance gates, agent memory, worktrees, prompt templates and the bundled agents. **Migration path:** use `run_subagent` (foreground / background / resume) with `subagent_explore` or `subagent_general`, or a custom markdown agent in `~/.unipi/config/agents` / `<project>/.unipi/config/agents` (`/unipi:agents` creates them). `read_subagent` replaces the old result tools. Saved `backgroundTasks.delegate.*` settings are ignored, not deleted.
+- **BREAKING: `btw` is an inline panel.** `/unipi:btw-new`, `-tangent`, `-clear`, `-inject`, `-summarize` and `--save` are removed; each `/unipi:btw` question runs in a fresh read-only session seeded from the main branch. Old btw notes still render.
+- **BREAKING: `/unipi:model` saves the default with Alt+Enter**, not Ctrl+S (which clashed with terminals, VS Code, Zellij and XOFF). The startup model and thinking level are also in `/unipi:settings → Fusion → Startup`.
+- `long-horizon`: default mode is now `none` (the judge still routes); set `longHorizon.defaultMode` to keep the old behaviour.
+- `workflow`: the all-projects permission mode moved to its own `permission.defaultMode` key (migrated once from a legacy global `mode`).
+
+### Added
+
+- **subagents: Devin-parity screens.** Live foreground card, `N subagents (k running) · ↓ select` strip, ↓ opens a dock (view transcript, `f` foreground, `x` cancel), Ctrl+B backgrounds and Esc cancels a foreground run, state survives resume. Settings hub: default model, thinking, max running, "Manage agents…".
+- **fusion: Devin-parity sidekick.** Steps stream into the chat, blocking handoffs forward approvals to you, background handoffs deny them; the sidekick runs the lead's extensions. Fusion's lead policy and long-horizon's mode block are named system-prompt sections (long-horizon used to drop the lead policy).
+- **kanboard:** task strategies (none/goal/ralph/swarm/graph) and plan-first labels, board default strategy `auto` (jev picks), blocking policy `avoid` (agents note assumptions instead of blocking), grouped board settings dialog written through to the extension settings, Review lane "Done all".
+- **TUI:** one visual language from a shared kit in `@pi-unipi/core` — crafted spinner, badges, rails, progress bars. Subagent cards settle to ✓/✗ in place; background notices, `read_subagent` and the dock are badges; memory cards are rails.
+- **Progress bars** for ralph (checklist), kanboard (board) and goal (a user-only side estimate + summary per loop and on `/unipi:goal status`, configurable in Long-Horizon → Progress).
+- **input-shortcuts:** Ctrl+C keeps the cleared input struck through in the transcript (never sent to the model); ↑ restores it.
+- `core`: every unipi command echoes `❭ /cmd args` in the transcript; the settings engine has an optional `onSet` hook.
+- `npm run tui:gallery` — standalone preview of UniPi's TUI designs, spinners and terminal capabilities.
+
+### Fixed
+
+- **long-horizon: goal and ralph loops no longer stop after the first turn.** The next-turn message was sent while pi still counted the turn as running and was rejected (`Agent is already processing`); it is now queued as a follow-up.
+- **long-horizon: batched goals no longer stall.** A turn that changed files and then claimed completion counted as no progress when the verifier said not met, so goals that claim after every batch got a generic nudge instead of the verifier's feedback and paused after eight claims.
+- **fusion:** the Fusion row can always be applied — the model cache refreshes on a miss (bridge-registered models were "not available"), stale saved lead/sidekick keys are dropped, and Enter/Tab opens the dropdown for a missing half. Sidekick tools only appear while Fusion is active; the picker is wide again.
+- **settings:** the permission project and default rows no longer open two pickers at once.
+- **kanboard:** the binary lookup prefers a source checkout's dev build over a stale platform package.
+- **memory:** at most one queued save reminder.
+
 ## [3.0.0-alpha.2] — 2026-09-26
 
 ### Fixed

package/README.md

@@ -41,7 +41,7 @@ pi install npm:@pi-unipi/unipi
 
 **[Footer](./packages/footer/README.md)** — Persistent status bar showing live stats from every package. Now with the Glance footer: a framed input box with an animated rainbow brand, git branch title, and a live session strip (turns, wall/tool time, TTFT, tok/s, cache hit). Responsive layout, presets, per-segment toggling.
 
-**[BTW](./packages/btw/README.md)** — Side conversations that run in parallel. Ask questions without interrupting the main agent.
+**[BTW](./packages/btw/README.md)** — Inline side questions (`/unipi:btw`) answered by a fresh read-only session seeded from the current context — the main agent never sees them.
 
 **[Ask User](./packages/ask-user/README.md)** — Structured input for decision gates. Single-select, multi-select, freeform. The agent asks instead of guessing.
 
@@ -96,7 +96,7 @@ Coexists triggers enhance behavior when packages are installed together. Workflo
 | Notify | `/unipi:notify-` | settings, test, set-tg, set-ntfy |
 | MCP | `/unipi:mcp-` | add, settings, sync, status |
 | Web | `/unipi:web-` | settings, cache-clear |
-| BTW | `/unipi:btw` | question, btw-new, btw-tangent, btw-inject, btw-summarize |
+| BTW | `/unipi:btw` | question |
 | Utility | `/unipi:` | env, doctor, status, cleanup, badge-name |
 | Kanboard | `/unipi:kanboard` | toggle, doctor |
 | Footer | `/unipi:footer` | toggle, settings |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.2",
+  "version": "3.0.0-alpha.3",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -29,6 +29,7 @@
     "publish:all": "npm publish --workspaces --access public",
     "test": "npx tsx --test tests/*.test.js packages/memory/tests/*.test.ts && npm test --workspaces --if-present",
     "typecheck": "npx tsc --noEmit --skipLibCheck",
+    "tui:gallery": "npx tsx scripts/tui-gallery/index.ts",
     "publish:kanboard": "node scripts/publish-kanboard-platforms.mjs"
   },
   "files": [
@@ -83,27 +84,27 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "3.0.0-alpha.2",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.2",
-    "@pi-unipi/btw": "3.0.0-alpha.2",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.2",
-    "@pi-unipi/compactor": "3.0.0-alpha.2",
-    "@pi-unipi/core": "3.0.0-alpha.2",
-    "@pi-unipi/footer": "3.0.0-alpha.2",
-    "@pi-unipi/image": "3.0.0-alpha.2",
-    "@pi-unipi/fusion": "3.0.0-alpha.2",
-    "@pi-unipi/info-screen": "3.0.0-alpha.2",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.2",
-    "@pi-unipi/kanboard": "3.0.0-alpha.2",
-    "@pi-unipi/mcp": "3.0.0-alpha.2",
-    "@pi-unipi/memory": "3.0.0-alpha.2",
-    "@pi-unipi/notify": "3.0.0-alpha.2",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.2",
-    "@pi-unipi/subagents": "3.0.0-alpha.2",
-    "@pi-unipi/updater": "3.0.0-alpha.2",
-    "@pi-unipi/utility": "3.0.0-alpha.2",
-    "@pi-unipi/web-api": "3.0.0-alpha.2",
-    "@pi-unipi/workflow": "3.0.0-alpha.2"
+    "@pi-unipi/ask-user": "3.0.0-alpha.3",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.3",
+    "@pi-unipi/btw": "3.0.0-alpha.3",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.3",
+    "@pi-unipi/compactor": "3.0.0-alpha.3",
+    "@pi-unipi/core": "3.0.0-alpha.3",
+    "@pi-unipi/footer": "3.0.0-alpha.3",
+    "@pi-unipi/image": "3.0.0-alpha.3",
+    "@pi-unipi/fusion": "3.0.0-alpha.3",
+    "@pi-unipi/info-screen": "3.0.0-alpha.3",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.3",
+    "@pi-unipi/kanboard": "3.0.0-alpha.3",
+    "@pi-unipi/mcp": "3.0.0-alpha.3",
+    "@pi-unipi/memory": "3.0.0-alpha.3",
+    "@pi-unipi/notify": "3.0.0-alpha.3",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.3",
+    "@pi-unipi/subagents": "3.0.0-alpha.3",
+    "@pi-unipi/updater": "3.0.0-alpha.3",
+    "@pi-unipi/utility": "3.0.0-alpha.3",
+    "@pi-unipi/web-api": "3.0.0-alpha.3",
+    "@pi-unipi/workflow": "3.0.0-alpha.3"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.87.1",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0-alpha.2",
+  "version": "3.0.0-alpha.3",
   "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": "3.0.0-alpha.2"
+    "@pi-unipi/core": "3.0.0-alpha.3"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "3.0.0-alpha.2",
+  "version": "3.0.0-alpha.3",
   "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

@@ -58,13 +58,12 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   "unipi:memory-forget":       "memory",
   "unipi:global-memory-list":  "memory",
 
-  // btw (6 commands)
+  // btw
   "unipi:btw":           "btw",
-  "unipi:btw-tangent":   "btw",
-  "unipi:btw-new":       "btw",
-  "unipi:btw-clear":     "btw",
-  "unipi:btw-inject":    "btw",
-  "unipi:btw-summarize": "btw",
+
+  // subagents
+  "unipi:subagents":     "subagents",
+  "unipi:agents":        "subagents",
 
   // mcp (5 commands)
   "unipi:mcp-status":   "mcp",
@@ -82,10 +81,7 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   // utility (settings hub)
   "unipi:settings":         "utility",
 
-  // subagents (3 commands)
-  "unipi:subagents-fleet":  "subagents",
-  "unipi:subagents-doctor": "subagents",
-  "unipi:subagents-guide":  "subagents",
+  // subagents (no user commands — Devin model)
 
   // background-tasks (8 commands)
   "unipi:bg":          "background-tasks",
@@ -150,12 +146,10 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:memory-forget":      "Delete a memory by title",
   "unipi:global-memory-list": "List all memories across all projects",
 
-  "unipi:btw":           "Run a parallel side conversation",
-  "unipi:btw-tangent":   "Start a contextless BTW tangent thread",
-  "unipi:btw-new":       "Start a fresh BTW thread with session context",
-  "unipi:btw-clear":     "Dismiss and clear the BTW thread",
-  "unipi:btw-inject":    "Inject the BTW thread into the main agent",
-  "unipi:btw-summarize": "Summarize and inject the BTW thread",
+  "unipi:btw":           "Ask a side question in an inline panel (read-only)",
+
+  "unipi:subagents":     "Open the subagent panel (also ↓ from an empty input)",
+  "unipi:agents":        "Manage subagent profiles — create, edit, copy, delete custom agents",
 
   "unipi:mcp-status":   "Show MCP server status",
 
@@ -195,9 +189,6 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:bg-tasks":    "Open the background task manager UI",
   "unipi:model":         "Pick a model or Fusion lead+sidekick pair (Devin-style picker)",
   "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",
 };
 
 // ─── Package Display Names ───────────────────────────────────────────

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "3.0.0-alpha.2",
+  "version": "3.0.0-alpha.3",
   "description": "Background tasks for UniPi — durable shell jobs and delegated background agents with a footer dock",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.87.1",
-    "@pi-unipi/core": "3.0.0-alpha.2",
+    "@pi-unipi/core": "3.0.0-alpha.3",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

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

@@ -27,14 +27,6 @@ export interface BackgroundTasksConfig {
   maxFinishedTasks: number;
   /** Output cap in bytes before a task is killed+failed (default 20 MiB). */
   maxOutputBytes: number;
-  /** Delegate defaults. */
-  delegate: {
-    extensionMode: "isolated" | "ambient";
-    autoDeliver: "never" | "when_small" | "always";
-    maxTurns: number;
-    maxToolCalls: number;
-    timeoutSeconds: number;
-  };
 }
 
 export const DEFAULT_CONFIG: BackgroundTasksConfig = {
@@ -44,13 +36,6 @@ export const DEFAULT_CONFIG: BackgroundTasksConfig = {
   defaultTimeoutSeconds: 0,
   maxFinishedTasks: 30,
   maxOutputBytes: 20 * 1024 * 1024,
-  delegate: {
-    extensionMode: "isolated",
-    autoDeliver: "when_small",
-    maxTurns: 40,
-    maxToolCalls: 120,
-    timeoutSeconds: 900,
-  },
 };
 
 function getGlobalConfigPath(): string {
@@ -144,32 +129,6 @@ export function validateBackgroundTasksConfig(config: unknown): string[] {
       problems.push("maxOutputBytes must be an integer >= 1024");
     }
   }
-  if (c.delegate !== undefined) {
-    if (typeof c.delegate !== "object" || c.delegate === null) {
-      problems.push("delegate must be an object");
-    } else {
-      const d = c.delegate as Record<string, unknown>;
-      if (d.extensionMode !== undefined && d.extensionMode !== "isolated" && d.extensionMode !== "ambient") {
-        problems.push('delegate.extensionMode must be "isolated" or "ambient"');
-      }
-      if (
-        d.autoDeliver !== undefined &&
-        d.autoDeliver !== "never" &&
-        d.autoDeliver !== "when_small" &&
-        d.autoDeliver !== "always"
-      ) {
-        problems.push('delegate.autoDeliver must be "never", "when_small", or "always"');
-      }
-      for (const key of ["maxTurns", "maxToolCalls"] as const) {
-        if (d[key] !== undefined && (typeof d[key] !== "number" || !Number.isInteger(d[key]) || (d[key] as number) < 1)) {
-          problems.push(`delegate.${key} must be a positive integer`);
-        }
-      }
-      if (d.timeoutSeconds !== undefined && (typeof d.timeoutSeconds !== "number" || !Number.isFinite(d.timeoutSeconds) || (d.timeoutSeconds as number) <= 0)) {
-        problems.push("delegate.timeoutSeconds must be a positive number");
-      }
-    }
-  }
   return problems;
 }
 
@@ -203,29 +162,6 @@ registerSettings({
         { key: "maxOutputBytes", type: "number", label: "Output cap bytes", min: 1024, description: "Kill+fail a task past this output size" },
       ],
     },
-    {
-      title: "Delegate",
-      fields: [
-        {
-          key: "delegate.extensionMode",
-          type: "enum",
-          label: "Extension mode",
-          options: [
-            { value: "isolated", label: "isolated" },
-            { value: "ambient", label: "ambient (weakens isolation)" },
-          ],
-        },
-        {
-          key: "delegate.autoDeliver",
-          type: "enum",
-          label: "Auto deliver",
-          options: ["when_small", "always", "never"],
-        },
-        { key: "delegate.maxTurns", type: "number", label: "Max turns", min: 1 },
-        { key: "delegate.maxToolCalls", type: "number", label: "Max tool calls", min: 1 },
-        { key: "delegate.timeoutSeconds", type: "number", label: "Timeout s", min: 1 },
-      ],
-    },
   ],
 });
 
@@ -278,15 +214,6 @@ export function loadBackgroundTasksConfig(cwd: string): LoadedBackgroundTasksCon
       typeof merged.maxOutputBytes === "number" && Number.isInteger(merged.maxOutputBytes) && merged.maxOutputBytes >= 1024
         ? merged.maxOutputBytes
         : DEFAULT_CONFIG.maxOutputBytes,
-    delegate: {
-      ...DEFAULT_CONFIG.delegate,
-      ...merged.delegate,
-      extensionMode: merged.delegate?.extensionMode === "ambient" ? "ambient" : "isolated",
-      autoDeliver:
-        merged.delegate?.autoDeliver === "never" || merged.delegate?.autoDeliver === "always"
-          ? merged.delegate.autoDeliver
-          : "when_small",
-    },
   };
   return { config, warnings };
 }

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

@@ -18,7 +18,6 @@ import {
   type BackgroundTaskExtensionService,
 } from "./extension-api.js";
 import { registerToolsAndCommands } from "./tools.js";
-import { registerDelegateExtension } from "./delegate-extension.js";
 import { setSharedTaskRegistry, clearSharedTaskRegistry } from "./registry-shared.js";
 import { formatDuration, taskDisplayName, type BgTask, type StartTaskOptions } from "./types.js";
 
@@ -205,11 +204,6 @@ export default function backgroundTasksExtension(pi: ExtensionAPI): void {
               return result;
             },
             rerunTask: async (task) => {
-              if (task.delegate !== undefined) {
-                throw new Error(
-                  "Only shell-command tasks can be rerun from the dock; relaunch this typed workflow through its owning tool.",
-                );
-              }
               const rerunOptions: StartTaskOptions = {
                 name: taskDisplayName(task),
                 isAgent: task.isAgent,
@@ -261,15 +255,6 @@ export default function backgroundTasksExtension(pi: ExtensionAPI): void {
     clearFinishedNotices,
   });
 
-  registerDelegateExtension(pi, {
-    startDelegateTask: async (ctx, options) => {
-      currentCtx = ctx;
-      return registry.startDelegateTask(ctx, options);
-    },
-    snapshot: (task) => registry.snapshot(task),
-    resolveTask: (idOrPrefix) => registry.resolveTask(idOrPrefix),
-  });
-
   pi.on("session_start", async (_event, ctx) => {
     registry.setShuttingDown(false);
     wakeLineInstalled = false; // pi clears extension widgets on reload/new session

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

@@ -27,7 +27,6 @@ import {
   type BgTaskSnapshot,
   type JsonObject,
   type KillKind,
-  type StartDelegateTaskOptions,
   type StartTaskOptions,
   type TaskContextUsage,
   type TaskStatus,
@@ -637,31 +636,6 @@ function noopOnChange(): void {
   return undefined;
 }
 
-/**
- * Deliver the delegate prompt bytes over stdin.
- *
- * A failure to deliver the seed is loud: the caller terminates the task rather
- * than letting a child run without the context it was supposed to receive.
- */
-function writeDelegateStdin(
-  child: BackgroundTaskChildProcess,
-  bytes: Buffer,
-  onError: (error: Error) => void,
-): void {
-  const stdin = child.stdin;
-  if (stdin === undefined || stdin === null) {
-    onError(new Error('delegate child stdin pipe is unavailable'));
-    return;
-  }
-  stdin.once('error', onError);
-  stdin.write(bytes, (error?: Error | null) => {
-    if (error !== undefined && error !== null) {
-      onError(error);
-      return;
-    }
-    stdin.end();
-  });
-}
 
 export class BackgroundTaskRegistry {
   private readonly tasks = new Map<string, BgTask>();
@@ -921,145 +895,6 @@ export class BackgroundTaskRegistry {
     }
   }
 
-  /**
-   * Start a prepared delegate child.
-   *
-   * The caller has already completed preflight, so by the time this runs the
-   * seed, budget plan, and artifact directory exist and the argv is fixed. The
-   * child is launched directly, never through a shell, and its terminal state
-   * flows through the same durable notification path as `bg_run`.
-   */
-  async startDelegateTask(
-    ctx: BackgroundTaskContext,
-    request: StartDelegateTaskOptions,
-  ): Promise<BgTask> {
-    if (this.shuttingDown)
-      throw new Error('Cannot start a delegate task while Pi is shutting down');
-
-    const launch = resolvePiLaunch({ platform: this.platform });
-    assertWindowsCommandLineWithinLimit(launch, request.argv, this.platform, 'bg-delegate');
-
-    const dir = await this.ensureRuntimeDir(ctx);
-    const id = request.facts.taskId;
-    const outputAbsPath = join(dir.abs, `${id}.output`);
-    const metadataAbsPath = join(dir.abs, `${id}.json`);
-    const outputPath = join(dir.display, `${id}.output`);
-
-    const task: BgTask = {
-      id,
-      name: normalizeTaskName(request.name) ?? 'Delegate task',
-      command: ['pi', ...request.argv].map(shellQuote).join(' '),
-      status: 'running',
-      outputPath,
-      outputAbsPath,
-      metadataAbsPath,
-      cwd: ctx.cwd,
-      startTime: this.now(),
-      exitCode: undefined,
-      pid: undefined,
-      bytesWritten: 0,
-      isAgent: true,
-      notified: false,
-      notifyOnCompletion: request.notifyOnCompletion,
-      triggerOnCompletion: request.triggerOnCompletion,
-      timeoutSeconds: request.timeoutSeconds,
-      model: request.facts.route.qualifiedId,
-      delegate: request.facts,
-      waiters: [],
-    };
-    this.tasks.set(id, task);
-
-    const stream = createWriteStream(outputAbsPath, { flags: 'a', encoding: 'utf8' });
-    task.stream = stream;
-    stream.on('error', (error) => {
-      task.error = `Output file write failed: ${error.message}`;
-    });
-
-    try {
-      const child = this.spawn(launch.executable, piLaunchArgv(launch, [...request.argv]), {
-        cwd: ctx.cwd,
-        detached: this.platform !== 'win32',
-        shell: false,
-        // The seed travels over stdin, never as a shell or positional argument,
-        // so the bytes the child reads are exactly the bytes that were persisted
-        // and hashed, with no quoting or command-line length limit in the path.
-        stdio: ['pipe', 'pipe', 'pipe'],
-        env: request.env,
-        windowsHide: true,
-      });
-      task.child = child;
-      task.pid = child.pid;
-      writeDelegateStdin(child, request.stdinBytes, (error) => {
-        this.writeNotice(task, `\n[delegate stdin write failed: ${error.message}]\n`);
-        if (task.status === 'running') {
-          task.killKind = 'user';
-          task.error = `Delegate seed could not be delivered: ${error.message}`;
-          try {
-            this.requestKill(task, 'SIGTERM');
-          } catch {
-            void this.finalizeTask(task, 'failed', null, undefined, task.error);
-          }
-        }
-      });
-
-      child.stdout?.on('data', (data) => {
-        this.appendChildOutput(task, data, 'stdout');
-      });
-      child.stderr?.on('data', (data) => {
-        this.appendChildOutput(task, data, 'stderr');
-      });
-      child.on('error', (error) => {
-        this.writeNotice(task, `\n[delegate spawn error: ${error.message}]\n`);
-        void this.finalizeTask(task, 'failed', null, undefined, error.message);
-      });
-      child.on('close', (code, signalName) => {
-        let status: TaskStatus;
-        let error: string | undefined;
-        if (task.killKind === 'user' || task.killKind === 'shutdown') {
-          status = 'killed';
-        } else if (task.killKind === 'timeout') {
-          status = 'failed';
-          error = task.error ?? `Timed out after ${String(request.timeoutSeconds ?? 0)}s`;
-        } else if ((code ?? 0) === 0) {
-          status = 'completed';
-        } else {
-          status = 'failed';
-          error = `Exited with code ${code === null ? 'null' : String(code)}${signalName ? ` (${signalName})` : ''}`;
-        }
-        void this.finalizeTask(task, status, code, signalName, error);
-      });
-
-      if (request.timeoutSeconds !== undefined) {
-        task.timeoutHandle = setTimeout(() => {
-          if (task.status !== 'running') return;
-          task.killKind = 'timeout';
-          task.error = `Timed out after ${String(request.timeoutSeconds)}s`;
-          this.writeNotice(task, `\n[delegate timeout: ${task.error}]\n`);
-          try {
-            this.requestKill(task, 'SIGTERM');
-          } catch (error) {
-            void this.finalizeTask(
-              task,
-              'failed',
-              null,
-              undefined,
-              `${task.error}; kill failed: ${error instanceof Error ? error.message : String(error)}`,
-            );
-          }
-        }, request.timeoutSeconds * 1000);
-      }
-
-      await this.writeMetadata(task);
-      this.onChange();
-      return task;
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      this.writeNotice(task, `\n[delegate spawn exception: ${message}]\n`);
-      await this.finalizeTask(task, 'failed', null, undefined, message);
-      throw new Error(`Failed to start delegate task: ${message}`);
-    }
-  }
-
   resolveTask(idOrPrefix: string): BgTask {
     const id = idOrPrefix.trim();
     if (!id) throw new Error('Task ID is required');
@@ -1816,12 +1651,7 @@ export class BackgroundTaskRegistry {
       task.exitCode === undefined ? '' : `\n  <exit-code>${String(task.exitCode)}</exit-code>`;
     const error = task.error ? `\n  <error>${escapeXml(task.error)}</error>` : '';
     const taskName = taskDisplayName(task);
-    const guidance =
-      task.delegate === undefined
-        ? 'Terminal state and output metadata are durable. Do not call bg_status to reconfirm; use bg_logs only if output is needed.'
-        : task.status === 'completed'
-          ? `Delegate result is durably committed. Call bg_result({taskId:${JSON.stringify(task.id)}}) once to retrieve it; do not poll.`
-          : `Delegate ended ${task.status}. Inspect the preserved artifacts at ${task.delegate.artifactDir}; do not poll.`;
+    const guidance = 'Terminal state and output metadata are durable. Do not call bg_status to reconfirm; use bg_logs only if output is needed.';
     const content = [
       '<background-task-notification>',
       `  <task-id>${task.id}</task-id>`,

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

@@ -68,26 +68,10 @@ export interface BgTaskSnapshot {
   toolUsage?: TaskToolUsage | undefined;
   model?: string | undefined;
   telemetryUnavailableReason?: string | undefined;
-  delegate?: DelegateTaskFacts | undefined;
   /** Last few non-empty output lines (bounded), for compact chat cards. */
   outputTail?: string[] | undefined;
 }
 
-/** Delegate-specific task facts surfaced through snapshots and `bg_result`. */
-export interface DelegateTaskFacts {
-  taskId: string;
-  launchNonce: string;
-  artifactDir: string;
-  artifactDirAbs: string;
-  seedSha256: string;
-  childSessionId: string;
-  route: { provider: string; model: string; qualifiedId: string };
-  budget: DelegateBudgetRouteSource;
-  extensionMode: DelegateExtensionMode;
-  autoDeliver: "never" | "when_small" | "always";
-  /** Set once the run reaches a terminal state and its result has been evaluated. */
-  outcome?: DelegateTaskOutcome | undefined;
-}
 
 export interface DelegateTaskOutcome {
   status: "committed" | "failed" | "cancelled";
@@ -98,9 +82,6 @@ export interface DelegateTaskOutcome {
   toolCalls?: number | undefined;
 }
 
-/** Forward declarations satisfied by ./delegate/types.js (kept here to avoid cycles). */
-export type DelegateBudgetRouteSource = import("./delegate/types.js").DelegateBudgetRouteSource;
-export type DelegateExtensionMode = import("./delegate/types.js").DelegateExtensionMode;
 
 export interface BgTask extends Omit<BgTaskSnapshot, "name"> {
   name: string;
@@ -129,7 +110,6 @@ export interface BgTask extends Omit<BgTaskSnapshot, "name"> {
   /** Partial trailing stdout line held between chunks while reconstructing wrapped-agent control lines. */
   agentStdoutBuffer?: string | undefined;
   telemetryUnavailableReason?: string | undefined;
-  delegate?: DelegateTaskFacts | undefined;
   outputTail?: string[] | undefined;
   metadataWriteChain?: Promise<void> | undefined;
   waiters: Array<() => void>;
@@ -227,17 +207,6 @@ export interface StartTaskOptions {
   terminalPublicationGate?: Promise<void> | undefined;
 }
 
-export interface StartDelegateTaskOptions {
-  name: string;
-  argv: readonly string[];
-  /** Prompt bytes delivered over stdin, never as a shell or positional argument. */
-  stdinBytes: Buffer;
-  env: NodeJS.ProcessEnv;
-  facts: DelegateTaskFacts;
-  notifyOnCompletion: boolean;
-  triggerOnCompletion: boolean;
-  timeoutSeconds?: number | undefined;
-}
 
 /** Default tool-output byte cap (mirrors pi's DEFAULT_MAX_BYTES). */
 export const DEFAULT_MAX_BYTES = 30 * 1024;
@@ -759,7 +728,6 @@ export function snapshot(task: BgTask): BgTaskSnapshot {
     toolUsage: task.toolUsage,
     model: task.model,
     telemetryUnavailableReason: task.telemetryUnavailableReason,
-    delegate: task.delegate,
     outputTail: task.outputTail === undefined ? undefined : [...task.outputTail],
   };
 }