@pi-unipi/unipi 3.0.0 → 3.0.1

package/CHANGELOG.md

@@ -6,9 +6,28 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.1] — 2026-11-02
+
+### Fixed
+
+- **A subagent profile created mid-turn works immediately.** The profile list was a snapshot taken at the start of each prompt, so an agent file written during a turn stayed invisible: `run_subagent` answered "Unknown profile" and graph work items naming it were refused. The next prompt — or `/reload` — was the only way to make it appear. The agent files are now re-read when a subagent starts and when the graph asks for the available profiles.
+  Do this: nothing.
+- **A new session no longer adopts another session's goal, ralph loop, swarm or agent graph.** Long-horizon state is session-scoped now: `/new`, `/resume` of a different session, a new chat from the app and cron runs start clean instead of "repairing" (and re-running) the other session's in-flight work, waking and replying immediately. One run belongs to the session that started it. Resuming the session that started the run picks it up as before, and the first resume of the owning session picks up pre-3.0.1 runs (the old workspace-level files are adopted once, only when the session's own transcript proves it owned them). A new session in the same project gets a one-line note when another session holds a live graph — `/resume` it to follow it.
+  Do this: nothing. Old runs keep their state; resume the session that started them.
+
+### Added
+
+- **pi publishes the settings catalog for the app's Settings → UniPi screen.** Every module's settings (defaults, types, scopes, enum options) are written to `~/.unipi/config/settings-schema.json` on mount and on each session start; the UniPi host serves them with the current config layers so the app can read and change pi's settings with no pi running. Secret values never leave the PC — the host reports only which keys are set.
+  Do this: update the app to 1.0.1 and start pi once after updating — the catalog is written on mount.
+
+### Changed
+
+- **Graph and swarm show the profiles the model can pick.** `view_agent_graph` now lists `available_profiles`, and the orchestration prompts say that each work item's profile is a per-item choice (a read-only investigation uses `subagent_explore`, write-capable work uses `subagent_general` or a custom profile).
+  Do this: nothing.
+
 ## [3.0.0] — 2026-10-25
 
-UniPi 3.0 is the first stable release of the 3.x line. It replaces 2.20.5 as npm `latest`. Upgrade guide: [docs/guide/upgrade-3.0.md](docs/guide/upgrade-3.0.md).
+UniPi 3.0 is the first stable release of the 3.x line. It replaces 2.20.5 as npm `latest`. Upgrade guide: [docs/guide/upgrade-3.0.md](https://github.com/Neuron-Mr-White/unipi/blob/main/docs/guide/upgrade-3.0.md).
 
 ### Highlights
 

package/README.md

@@ -30,43 +30,15 @@
 pi install npm:@pi-unipi/unipi
 ```
 
-> [!NOTE]
-> **Coming from 2.x?** Read the [3.0 upgrade guide](docs/guide/upgrade-3.0.md).
-> On a 3.0 alpha? The updater offers 3.0.0 at session start, or run
-> `pi install npm:@pi-unipi/unipi` once to move off the `alpha` tag.
-> The 2.x line stays on the [`v2` branch](https://github.com/Neuron-Mr-White/unipi/tree/v2#readme).
-
-UniPi needs [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent)
-`0.87.1` or later. This command installs 21 extension packages. Each package
-also works alone.
-
-> [!TIP]
-> **Windows:** web reads use a native module that needs the Microsoft Visual
-> C++ 2015-2022 runtime. Most Windows installs have it; slimmed images such as
-> tiny11 do not. Without it UniPi still loads and web reads fall back to plain
-> fetch. To install it, run
-> `winget install Microsoft.VCRedist.2015+.x64` or download
-> [vc_redist.x64.exe](https://aka.ms/vs/17/release/vc_redist.x64.exe).
-> `/unipi:doctor` reports whether it is missing.
+Needs [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) `0.87.1`+. Installs 21 packages; each also works alone. Coming from 2.x: [upgrade guide](docs/guide/upgrade-3.0.md).
 
 <p align="center">
   <img src="docs/assets/screenshots/simple-memory-glance.png" alt="A UniPi session in simple mode with memory recall, memory save and the glance footer">
 </p>
 
-This screenshot shows one turn in a demo session:
-
-- **Simple mode** (the default) shows each tool call as one line.
-- **Memory** finds the test setup from an earlier session and saves a new fact
-  for later sessions.
-- **The glance footer** frames the input box. It shows the git branch, the
-  mode, the context use and the model. The strip below it shows tokens in and
-  out, cost, speed, turns, time and cache hits. It fits itself to the window:
-  on a narrow screen the less important parts drop out first.
-
 ## Why UniPi
 
-Pi is a small coding agent for the terminal. It reads files, edits files and
-runs commands. UniPi adds the parts that a long session needs.
+UniPi adds what long Pi sessions need.
 
 | UniPi gives you | How |
 |---|---|
@@ -85,8 +57,7 @@ runs commands. UniPi adds the parts that a long session needs.
 
 ## Proof
 
-Each feature below exists because published results support it. The numbers
-come from the linked sources. They are not UniPi benchmarks.
+Published results behind each feature (not UniPi benchmarks).
 
 | Feature | Benchmark | Source |
 |---|---|---|
@@ -99,31 +70,14 @@ come from the linked sources. They are not UniPi benchmarks.
 | **Graph** | Up to 3.7× lower latency, 6.7× lower cost and about 9% higher accuracy than ReAct. | [LLMCompiler (ICML 2024)](https://arxiv.org/abs/2312.04511) |
 | **Prefix cache** | Up to 90% lower cost and 85% lower latency for long prompts. | [Anthropic prompt caching](https://claude.com/blog/prompt-caching) · [Modular handbook](https://handbook.modular.com/inference-optimization/prefix-caching/) · [our cache study](docs/deepseek-cache-rate-research.md) |
 
-Long work matters more each year. METR measured that the length of software
-tasks that agents can finish doubles about every 7 months
-([METR](https://metr.org/blog/2025-03-19-measuring-ai-ability-to-complete-long-tasks/)).
-UniPi gives these longer runs memory, budgets and a verifier.
-
-Two notes on the sources. OpenRouter's Fusion uses a panel of models and a
-judge. UniPi Fusion uses a lead and a sidekick. The Ralph numbers are a
-reported result, not a controlled benchmark.
-
-The [architecture pages](docs/architecture/README.md) show how each mechanism
-works in UniPi, with the limits from the source.
-
 ## Kanboard
 
-Kanboard is a task board for each project. You and the agent use the same
-board. The agent claims a task, works it, and sends it to review with a
-summary. You approve it or send it back with a note.
+A task board per project, shared by you and the agent. The agent claims a task, works it and sends it to review.
 
 <p align="center">
   <img src="docs/assets/screenshots/kanboard-dashboard.png" alt="Kanboard dashboard: tasks waiting on you, running agents, ready tasks and a 14-day throughput chart">
 </p>
 
-The dashboard shows what needs you across all projects. You can approve a
-review or answer a blocked question in one click.
-
 <p align="center">
   <img src="docs/assets/screenshots/kanboard-board.png" alt="Kanboard board view with Backlog, Todo, In Progress, Blocked, In Review and Done lanes">
 </p>
@@ -134,68 +88,20 @@ review or answer a blocked question in one click.
   board writes.
 - Run `/unipi:kanboard-autowork start` to let the agent work every ready task.
 
-The screenshots use demo data. Read the [Kanboard README](packages/kanboard/README.md).
+More: [Kanboard README](packages/kanboard/README.md).
 
 ## See your session: `/unipi:info`
 
-Pi starts. Unicrab says hello and gives you three facts: how fast Pi got
-ready, the session you came back to, and what you spent today. Then it goes
-away. It does not take your keys, so you can type your first prompt at once.
-
-<p align="center">
-  <img src="docs/assets/screenshots/info-splash.png" width="760" alt="The Unicrab startup splash: mascot, UNIPI wordmark, version, ready time, resumed session and today's spend">
-</p>
-
-Run `/unipi:info` when you want the full picture. The first page is about
-**this session**. It answers the questions you ask during long work:
-
-- **What did this cost?** Cost, tokens, replies and time, in large digits.
-- **What fills my context?** A bucket shows each part in its own colour:
-  system prompt, tool schemas, summaries, your prompts, replies and tool
-  results. The edge of the bucket shows how full the window is. It turns
-  amber at 70% and red at 90%.
-- **Which tool output is the heaviest?** The page names the three largest.
-- **Which tools failed?** Each tool gets a bar, and failures show in red.
+Cost, context use, heaviest tool output, spend history and what compaction saved.
 
 <p align="center">
   <img src="docs/assets/screenshots/info-session.png" alt="The This session page: cost, tokens, replies, time, the context bucket, billed tokens and tools">
 </p>
 
-The other pages answer the questions that come later:
-
-| Page | It shows |
-|---|---|
-| Usage | Spend today, this week and this month, a 30-day chart, and the share of each model. |
-| Compactor | Tokens that compaction kept out of your requests, and the money that saved. |
-| Tools · Skills · Modules | What Pi loaded, where it came from, and what each UniPi module adds. |
-| MCP · Memory · Web · Updates · Keys | The state of each module. |
-
-<table>
-  <tr>
-    <td><img src="docs/assets/screenshots/info-usage.png" alt="The Usage page: spend tiles, a 30-day chart with the peak labelled, and models this month"></td>
-    <td><img src="docs/assets/screenshots/info-compactor.png" alt="The Compactor page: money saved for this session, this project and all projects, and a without-versus-with bar"></td>
-  </tr>
-</table>
-
-A small letter before a number tells you its scope: **`s`** is this session,
-**`p`** is this project and **`g`** is every project on this machine. Numbers
-from one project never show in another.
-
-How the Compactor page counts: each compaction makes the context smaller.
-Every reply after it sends that smaller context. The page multiplies the
-tokens removed by the number of replies that followed. Then it prices them at
-the rate you paid for context. A free model saves tokens but no money.
-
-Keys: `←`/`→` or `1`–`9` change the page, `r` refreshes it, `q` closes it.
-`/unipi:info usage` opens one page. The dashboard opens at once on cached
-numbers, then updates them in the background. The screenshots use demo data.
-Read the [Info Screen README](packages/info-screen/README.md).
+More: [Info Screen README](packages/info-screen/README.md).
 
 ## Harness architecture
 
-UniPi adds these mechanisms to the Pi harness. Each page gives the problem, a
-diagram, the limits from the source, and the files to read.
-
 | Mechanism | Problem it solves |
 |---|---|
 | [Event bus](docs/architecture/event-bus.md) | 21 packages must work together without import-time coupling. |
@@ -231,33 +137,11 @@ flowchart LR
 | See and control | [Footer](packages/footer/README.md) · [Info Screen](packages/info-screen/README.md) · [Input Shortcuts](packages/input-shortcuts/README.md) · [Command Enchantment](packages/autocomplete/README.md) |
 | Maintain | [Utility](packages/utility/README.md) · [Updater](packages/updater/README.md) · [Core](packages/core/README.md) |
 
-The [docs index](docs/README.md#packages) gives one line and the npm name for
-each package.
-
 ## Meet Unicrab
 
 <img align="right" src="docs/assets/unicrab-pixel.png" width="120" alt="Unicrab pixel art">
 
-Unicrab is the UniPi mascot. It started as the author's pet crab. Now it says
-hello when Pi starts and leaves hints above the input box. Press `Alt+H` for the
-next hint, or run `/unipi:hint` to read all 127 of them.
-
-After an update, the first hint tells you what is new in that release.
-
-Read [The making of Unicrab](docs/story/unicrab.md): from a real crab, to pixel
-art, to a terminal character that is 7 columns wide.
-
-<p align="center">
-  <img src="docs/assets/screenshots/unicrab-start.png" alt="The UniPi start screen with Unicrab in half-block pixel art">
-</p>
-
-## What's new
-
-The recent releases, in short. The [changelog](CHANGELOG.md) has the details.
-
-| Release | What changed for you |
-|---|---|
-| 3.0.0 | The first stable UniPi 3. Long work modes, MemPalace memory, the new Kanboard, plan and permission modes, rebuilt subagents and compactor, and the UniPi app bridge. See the [upgrade guide](docs/guide/upgrade-3.0.md). |
+The UniPi mascot. It says hello when Pi starts and leaves hints above the input (`Alt+H`, `/unipi:hint`). [The making of Unicrab](docs/story/unicrab.md).
 
 ## Docs
 
@@ -266,11 +150,6 @@ The recent releases, in short. The [changelog](CHANGELOG.md) has the details.
 - [Architecture](docs/architecture/README.md)
 - [All docs](docs/README.md)
 
-The docs use STE-flavored English
-([ASD-STE100](https://www.asd-ste100.org/)): short sentences, active voice and
-one meaning for each word. The [style guide](docs/contributing/docs-style.md)
-gives the rules.
-
 ## Development
 
 ```bash
@@ -290,9 +169,7 @@ To add a package:
    `package.json`.
 5. Run `npm run typecheck` and `npm test`.
 
-Packages talk over events and shared state holders. Import from
-`@pi-unipi/core`, not from a peer package. The
-[event bus page](docs/architecture/event-bus.md) explains the rules.
+Import from `@pi-unipi/core`, never from a peer package ([event bus](docs/architecture/event-bus.md)).
 
 ## Contributing
 
@@ -302,8 +179,7 @@ Packages talk over events and shared state holders. Import from
 4. Run `npm run typecheck` and `npm test`.
 5. Open a pull request.
 
-Keep one job in each package. For docs, follow the
-[style guide](docs/contributing/docs-style.md).
+One job per package. Docs follow the [style guide](docs/contributing/docs-style.md).
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -82,28 +82,28 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/app-bridge": "3.0.0",
-    "@pi-unipi/ask-user": "3.0.0",
-    "@pi-unipi/background-tasks": "3.0.0",
-    "@pi-unipi/btw": "3.0.0",
-    "@pi-unipi/command-enchantment": "3.0.0",
-    "@pi-unipi/compactor": "3.0.0",
-    "@pi-unipi/core": "3.0.0",
-    "@pi-unipi/dream": "3.0.0",
-    "@pi-unipi/footer": "3.0.0",
-    "@pi-unipi/fusion": "3.0.0",
-    "@pi-unipi/info-screen": "3.0.0",
-    "@pi-unipi/input-shortcuts": "3.0.0",
-    "@pi-unipi/kanboard": "3.0.0",
-    "@pi-unipi/mcp": "3.0.0",
-    "@pi-unipi/memory": "3.0.0",
-    "@pi-unipi/notify": "3.0.0",
-    "@pi-unipi/skill-registry": "3.0.0",
-    "@pi-unipi/subagents": "3.0.0",
-    "@pi-unipi/updater": "3.0.0",
-    "@pi-unipi/utility": "3.0.0",
-    "@pi-unipi/web-api": "3.0.0",
-    "@pi-unipi/workflow": "3.0.0",
+    "@pi-unipi/app-bridge": "3.0.1",
+    "@pi-unipi/ask-user": "3.0.1",
+    "@pi-unipi/background-tasks": "3.0.1",
+    "@pi-unipi/btw": "3.0.1",
+    "@pi-unipi/command-enchantment": "3.0.1",
+    "@pi-unipi/compactor": "3.0.1",
+    "@pi-unipi/core": "3.0.1",
+    "@pi-unipi/dream": "3.0.1",
+    "@pi-unipi/footer": "3.0.1",
+    "@pi-unipi/fusion": "3.0.1",
+    "@pi-unipi/info-screen": "3.0.1",
+    "@pi-unipi/input-shortcuts": "3.0.1",
+    "@pi-unipi/kanboard": "3.0.1",
+    "@pi-unipi/mcp": "3.0.1",
+    "@pi-unipi/memory": "3.0.1",
+    "@pi-unipi/notify": "3.0.1",
+    "@pi-unipi/skill-registry": "3.0.1",
+    "@pi-unipi/subagents": "3.0.1",
+    "@pi-unipi/updater": "3.0.1",
+    "@pi-unipi/utility": "3.0.1",
+    "@pi-unipi/web-api": "3.0.1",
+    "@pi-unipi/workflow": "3.0.1",
     "@resvg/resvg-wasm": "^2.6.2",
     "beautiful-mermaid": "^1.1.3"
   },

package/packages/app-bridge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/app-bridge",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Live bridge between a pi TUI session and the UniPi phone app — streaming chat, prompts, steering and dialogs from the phone",
   "type": "module",
   "main": "index.ts",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0"
+    "@pi-unipi/core": "3.0.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -42,7 +42,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0"
+    "@pi-unipi/core": "3.0.1"
   },
   "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",
+  "version": "3.0.1",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "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",
+    "@pi-unipi/core": "3.0.1",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.87.1"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0"
+    "@pi-unipi/core": "3.0.1"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Compaction for Pi — lossless zero-LLM or model summaries, rebuilt from full history, with session recall",
   "type": "module",
   "main": "src/index.ts",
@@ -33,8 +33,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0",
-    "@pi-unipi/info-screen": "3.0.0",
+    "@pi-unipi/core": "3.0.1",
+    "@pi-unipi/info-screen": "3.0.1",
     "@earendil-works/pi-agent-core": "^0.87.1"
   },
   "peerDependencies": {

package/packages/core/README.md

@@ -11,7 +11,10 @@ file helpers, so packages work together without direct imports.
 
 - Defines the shared event names in `UNIPI_EVENTS` and module names in `MODULES`.
 - Gives the settings engine. Each module registers a namespace. The
-  `/unipi:settings` hub shows all namespaces.
+  `/unipi:settings` hub shows all namespaces, and pi publishes the whole
+  catalog to `~/.unipi/config/settings-schema.json` so the UniPi app's
+  Settings → UniPi screen can show and change pi's settings (served by the
+  unipi-host; secret values stay on the PC).
 - Gives the state layout under `~/.unipi/`. Each module gets `global`, `config`,
   `state` and `session` folders.
 - Gives the turn arbiter, harness message metadata and the shared TUI kit.

package/packages/core/index.ts

@@ -41,6 +41,7 @@ export * from "./src/workspace/state-migration.js";
 export * from "./src/settings/paths.js";
 export * from "./src/settings/engine.js";
 export * from "./src/settings/schema.js";
+export * from "./src/settings/snapshot.js";
 export { SettingsHub, type SettingsHubDeps } from "./src/settings/hub.js";
 export { openSettingsHub } from "./src/settings/open.js";
 export * from "./src/attach/detect.js";

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",