@pi-unipi/unipi 2.7.1 → 2.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.7.1",
+  "version": "2.8.1",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -83,6 +83,7 @@
   },
   "dependencies": {
     "@pi-unipi/ask-user": "2.6.1",
+    "@pi-unipi/background-tasks": "2.6.3",
     "@pi-unipi/btw": "2.6.1",
     "@pi-unipi/command-enchantment": "2.6.1",
     "@pi-unipi/compactor": "2.6.1",

package/packages/autocomplete/src/constants.ts

@@ -34,6 +34,8 @@ export const PACKAGE_ORDER: string[] = [
   "updater",
   "input-shortcuts",
   "image",
+  "subagents",
+  "background-tasks",
 ];
 
 // ─── Package Colors ──────────────────────────────────────────────────
@@ -56,6 +58,8 @@ export const PACKAGE_COLORS: Record<string, string> = {
   updater:   `${ESC}[93m`, // Bright Yellow
   "input-shortcuts": `${ESC}[95m`, // Bright Magenta
   image:     `${ESC}[35m`, // Magenta
+  subagents: `${ESC}[34m`, // Blue
+  "background-tasks": `${ESC}[91m`, // Bright Red
 };
 
 // ─── Command Registry ────────────────────────────────────────────────
@@ -134,6 +138,20 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   "unipi:subagents-doctor": "subagents",
   "unipi:subagents-guide":  "subagents",
 
+  // 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",
+
   // info (2 commands)
   "unipi:info":          "info",
   "unipi:info-settings": "info",
@@ -288,6 +306,22 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:updater-settings":  "Configure updater — check interval and auto-update",
 
   "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:subagents-fleet":  "Open the subagents fleet view",
+  "unipi:subagents-doctor": "Diagnose subagents configuration",
+  "unipi:subagents-guide":  "Show the subagents usage guide",
 };
 
 // ─── Package Display Names ───────────────────────────────────────────
@@ -310,4 +344,6 @@ export const PACKAGE_LABELS: Record<string, string> = {
   updater:   "updater",
   "input-shortcuts": "input-shortcuts",
   image:     "image",
+  subagents: "subagents",
+  "background-tasks": "background-tasks",
 };

package/packages/background-tasks/README.md

@@ -0,0 +1,87 @@
+# @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.
+
+## Master toggle
+
+One config key disables the entire module — no tools, no commands, no hooks, no UI:
+
+```json
+// ~/.unipi/config/background-tasks.json (global)
+// <workspace>/.unipi/config/background-tasks.json (override; workspace wins)
+{
+  "enabled": true
+}
+```
+
+Open `/unipi:bg-settings` for the interactive settings overlay (master toggle,
+defaults, output caps, delegate/fusion defaults).
+
+## Surfaces
+
+### Tools (reference names kept)
+
+| 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)
+
+`/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`.
+
+Shortcuts: `Shift↓` opens the task manager dock; `Ctrl+Alt+C` clears finished notices.
+
+## 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
+
+`UNIPI_BG_*` prefix (replaces the reference `PI_BG_*`):
+`UNIPI_BG_TMP_DIR`, `UNIPI_BG_MAX_OUTPUT_BYTES`, `UNIPI_BG_SHELL`,
+`UNIPI_BG_SHELL_PATH`, `UNIPI_BG_DISABLE_PI_TELEMETRY`, `UNIPI_BG_DELEGATE_*`.
+
+## Completion delivery
+
+| `notifyOnCompletion` | `triggerOnCompletion` | Mode |
+| --- | --- | --- |
+| true (default) | true (bg_run default) | Durable terminal notification + automatic follow-up turn |
+| true | false (`/unipi:bg` default) | Notification only |
+| false | — | Manual monitoring |
+
+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.
+
+## Differences from the reference
+
+- 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/`.
+- 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.
+
+ISC-licensed reference: Copyright Ismail <ismailsalikhodjaev@gmail.com>.

package/packages/background-tasks/extensions/anthropic-attribution.ts

@@ -0,0 +1 @@
+export { default } from '../src/anthropic-attribution.js';

package/packages/background-tasks/extensions/delegate-child.ts

@@ -0,0 +1 @@
+export { default } from '../src/delegate-child-extension.js';

package/packages/background-tasks/extensions/fusion-child.ts

@@ -0,0 +1 @@
+export { default } from '../src/fusion-child-extension.js';

package/packages/background-tasks/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@pi-unipi/background-tasks",
+  "version": "2.6.3",
+  "description": "Background tasks for UniPi \u2014 durable shell jobs, delegated agents, attested Pi runs, and fixed-purpose Fusion workflows",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "scripts": {
+    "test": "npx tsx --test src/__tests__/*.test.ts"
+  },
+  "dependencies": {
+    "@earendil-works/pi-ai": "^0.80.0",
+    "@pi-unipi/core": "2.6.1",
+    "turndown": "^7.2.4"
+  },
+  "devDependencies": {
+    "@types/turndown": "^5.0.6",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.80.0",
+    "@earendil-works/pi-tui": "^0.80.0",
+    "typebox": "^1.1.38"
+  },
+  "files": [
+    "src/**/*.ts",
+    "src/**/*.json",
+    "extensions/*.ts",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions/anthropic-attribution.ts",
+      "./src/index.ts"
+    ],
+    "skills": [],
+    "prompts": [],
+    "themes": []
+  }
+}

package/packages/background-tasks/src/anthropic-attribution-path.ts

@@ -0,0 +1,21 @@
+/**
+ * @pi-unipi/background-tasks — Anthropic attribution extension path
+ *
+ * Resolves this package's own attribution extension entry so isolated child Pi
+ * processes can load it explicitly. Mirrors the reference layout:
+ * extensions/anthropic-attribution.ts re-exports src/anthropic-attribution.ts.
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+
+export function resolveAnthropicAttributionExtensionPath(): string {
+  // src/anthropic-attribution-path.ts -> packages/background-tasks/extensions/
+  const here = dirname(fileURLToPath(import.meta.url));
+  const candidate = resolve(here, "..", "extensions", "anthropic-attribution.ts");
+  if (!existsSync(candidate)) {
+    throw new Error(`Anthropic attribution extension is missing: ${candidate}`);
+  }
+  return candidate;
+}