@pi-unipi/background-tasks 2.16.1 → 2.17.0

package/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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "2.16.1",
-  "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.1",
+    "@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/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/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/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/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/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/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/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,

package/src/delegate/runner.ts

@@ -1,8 +1,7 @@
 import { existsSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
-import { canonicalJson } from '../attested-pi-run.js';
+import { canonicalJson } from '../json-utils.js';
 import { replaceFileDurable } from '../durable-fs.js';
-import { resolveAnthropicAttributionExtensionPath } from '../anthropic-attribution-path.js';
 import { join } from 'node:path';
 import { DelegateArtifactStore, discardDelegateArtifactRoot } from './artifacts.js';
 import {
@@ -52,7 +51,6 @@ export interface PrepareDelegateLaunchInput extends DelegatePreflightInput {
   autoDeliver: DelegateAutoDeliverMode;
   extensionMode: DelegateExtensionMode;
   childExtensionPath?: string | undefined;
-  attributionExtensionPath?: string | undefined;
   env?: NodeJS.ProcessEnv | undefined;
   now?: (() => Date) | undefined;
 }
@@ -72,22 +70,6 @@ export async function prepareDelegateLaunch(
   // its child guard must refuse rather than spawn an unguarded child.
   const childExtensionPath =
     input.childExtensionPath ?? resolveDelegateChildExtensionPath();
-  let attributionExtensionPath: string | undefined;
-  if (input.route.provider === 'anthropic') {
-    try {
-      attributionExtensionPath =
-        input.attributionExtensionPath ?? resolveAnthropicAttributionExtensionPath();
-    } catch (error) {
-      throw new DelegateError(
-        `Anthropic delegate attribution extension could not be resolved: ${error instanceof Error ? error.message : String(error)}`,
-        {
-          code: 'delegate_isolation_unsupported',
-          childCreated: false,
-          remediation: ['Reinstall the package; Anthropic delegates require attribution.'],
-        },
-      );
-    }
-  }
 
   const preflight = preflightDelegateLaunch(input);
 
@@ -132,7 +114,6 @@ export async function prepareDelegateLaunch(
       childSessionId: preflight.childSessionId,
       childSessionDir: childSessionDirAbs,
       childExtensionPath,
-      attributionExtensionPath,
       systemPrompt: preflight.childSystemPrompt,
     });
     const env = delegateChildEnv(

package/src/delegate/seed.ts

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