@pi-unipi/unipi 3.0.0-alpha.40 → 3.0.0-alpha.41

package/CHANGELOG.md

@@ -6,6 +6,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.41] — 2026-10-13
+
+### Changed
+- Graph and swarm now follow Maka's agent graph. The model adds work with dependencies, and pi runs each step as a background subagent. Before, the model had to start every subagent and report back by hand, and weaker models skipped it. The model yields while steps run, and pi wakes it once at each checkpoint (a failure, nothing left to run, or everything settled). A graph closes only when the model finishes it with the results it chose. Swarm is the same graph with Maka's swarm instructions. New tools: `update_agent_graph` (`add_work` / `stop` / `finish`), `view_agent_graph`, `yield_agent_graph`, `agent_output`, `agent_swarm_status`. Removed: `swarm_report`, `swarm_status`, `swarm_yield`, `graph_output`, and the declare-once `update_agent_graph`. (UNI-279, UNI-280, UNI-281)
+
+### Added
+- The agent graph is saved in the project's state folder. It survives restarts: steps that were running when pi closed resume once in their own subagent session. `/unipi:graph history` and `/unipi:swarm history` list past graphs, and a new graph can reuse results a finished one selected. (UNI-279, UNI-280)
+- The UniPi app's Progress sheet shows finished and past graphs with their chart. It adds each step's details, its full result and its subagent session, plus Stop graph and a picker for earlier runs. The app can also open any subagent's transcript. (UNI-282)
+- Goal: the next continuation is saved before it is sent. If pi crashes, the next start sends it again, up to 2 times, then pauses the goal. A completion claim while the todo list still has open items gets a task reminder first, up to 2 times. (UNI-283)
+
+### Fixed
+- `/unipi:ralph start` from an empty prompt started the loop but never ran the first iteration. (UNI-283)
+- After a restart, `ralph_done` failed with "no active loop". Prompts and tools also pointed the model at the wrong task-file path. (UNI-283)
+- Stopping a ralph loop with `/unipi:regular` left its goal active, so the next `/unipi:goal` resumed the old checklist. (UNI-283)
+
 ## [3.0.0-alpha.40] — 2026-10-12
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.40",
+  "version": "3.0.0-alpha.41",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -80,28 +80,28 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/app-bridge": "3.0.0-alpha.40",
-    "@pi-unipi/ask-user": "3.0.0-alpha.40",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.40",
-    "@pi-unipi/btw": "3.0.0-alpha.40",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.40",
-    "@pi-unipi/compactor": "3.0.0-alpha.40",
-    "@pi-unipi/core": "3.0.0-alpha.40",
-    "@pi-unipi/dream": "3.0.0-alpha.40",
-    "@pi-unipi/footer": "3.0.0-alpha.40",
-    "@pi-unipi/fusion": "3.0.0-alpha.40",
-    "@pi-unipi/info-screen": "3.0.0-alpha.40",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.40",
-    "@pi-unipi/kanboard": "3.0.0-alpha.40",
-    "@pi-unipi/mcp": "3.0.0-alpha.40",
-    "@pi-unipi/memory": "3.0.0-alpha.40",
-    "@pi-unipi/notify": "3.0.0-alpha.40",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.40",
-    "@pi-unipi/subagents": "3.0.0-alpha.40",
-    "@pi-unipi/updater": "3.0.0-alpha.40",
-    "@pi-unipi/utility": "3.0.0-alpha.40",
-    "@pi-unipi/web-api": "3.0.0-alpha.40",
-    "@pi-unipi/workflow": "3.0.0-alpha.40",
+    "@pi-unipi/app-bridge": "3.0.0-alpha.41",
+    "@pi-unipi/ask-user": "3.0.0-alpha.41",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.41",
+    "@pi-unipi/btw": "3.0.0-alpha.41",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.41",
+    "@pi-unipi/compactor": "3.0.0-alpha.41",
+    "@pi-unipi/core": "3.0.0-alpha.41",
+    "@pi-unipi/dream": "3.0.0-alpha.41",
+    "@pi-unipi/footer": "3.0.0-alpha.41",
+    "@pi-unipi/fusion": "3.0.0-alpha.41",
+    "@pi-unipi/info-screen": "3.0.0-alpha.41",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.41",
+    "@pi-unipi/kanboard": "3.0.0-alpha.41",
+    "@pi-unipi/mcp": "3.0.0-alpha.41",
+    "@pi-unipi/memory": "3.0.0-alpha.41",
+    "@pi-unipi/notify": "3.0.0-alpha.41",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.41",
+    "@pi-unipi/subagents": "3.0.0-alpha.41",
+    "@pi-unipi/updater": "3.0.0-alpha.41",
+    "@pi-unipi/utility": "3.0.0-alpha.41",
+    "@pi-unipi/web-api": "3.0.0-alpha.41",
+    "@pi-unipi/workflow": "3.0.0-alpha.41",
     "@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-alpha.40",
+  "version": "3.0.0-alpha.41",
   "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-alpha.40"
+    "@pi-unipi/core": "3.0.0-alpha.41"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/app-bridge/src/bridge.ts

@@ -44,7 +44,7 @@ import { setRemoteDialogs } from "./remote.js";
 import { fileSuggestions } from "./files.js";
 import { statPaths } from "./paths.js";
 import { registerPath, resolveMedia } from "./media.js";
-import { listWorkItems, stopWorkItem, backgroundWorkItem, workLogPage } from "./work.js";
+import { listWorkItems, stopWorkItem, backgroundWorkItem, workLogPage, workTranscript } from "./work.js";
 import { bus, callCommandRunner, commandArgCompleters, pendingWorkLabel, silenceCommandEcho, subscribePendingWork, UNIPI_EVENTS } from "@pi-unipi/core";
 import type { BtwListPage } from "./wire.js";
 
@@ -62,6 +62,8 @@ export function recordLhMode(state: LhModeInfo | undefined): { lhMode: string |
 
 /** UNI-269: long-horizon's command runner behind `set_lh_mode` (packages/long-horizon/src/commands.ts). */
 export const LH_MODE_RUNNER = "unipi:lh-mode";
+/** UNI-282: long-horizon's agent graph ops runner (packages/long-horizon/index.ts). */
+export const LH_GRAPH_RUNNER = "unipi:lh-graph";
 /** UNI-118: dream_status pushes coalesce within this window. */
 export const DREAM_COALESCE_MS = 250;
 
@@ -1581,6 +1583,26 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
         }
         return;
       }
+      case "lh_graph": {
+        try {
+          const out = await callCommandRunner<{ ok: boolean; reason?: string; output?: { text?: string }; runs?: unknown[] }>(LH_GRAPH_RUNNER, ctx, { op: msg.op, id: msg.id, graphId: msg.graphId });
+          if (!out.found) return fail("The agent graph needs a newer unipi on this PC.");
+          if (!out.result?.ok) return fail(out.result?.reason ?? "The graph op failed.");
+          if (msg.op === "stop") {
+            ack();
+            return;
+          }
+          if (msg.op === "output") {
+            const o = out.result.output ?? {};
+            write(sock, { t: "lh_graph", op: "output", output: { ...o, ...(typeof o.text === "string" ? { text: clipText(o.text, 256 * 1024) } : {}) }, ref: msg.ref });
+            return;
+          }
+          write(sock, { t: "lh_graph", op: "history", runs: out.result.runs ?? [], ref: msg.ref });
+        } catch (error) {
+          fail(error instanceof Error ? error.message : String(error));
+        }
+        return;
+      }
       case "dream_get":
         write(sock, { t: "dream_status", status: dreamStatus(), ref: msg.ref });
         return;
@@ -1640,10 +1662,14 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
         return;
       }
       case "work_transcript": {
-        // Subagent mini-transcripts need @pi-unipi/subagents' transcript
-        // builder (TUI-flavoured); UNI-160 ships the live-log half (bg tasks)
-        // first and reports this a known gap (see the task report).
-        fail("Subagent transcripts aren't available yet.");
+        // UNI-282: a subagent's mini-transcript (work id `agent-<id>` or a
+        // graph step's operator id) from @pi-unipi/subagents' builder.
+        const out = workTranscript(msg.id);
+        if ("error" in out) return fail(out.error);
+        const items = out.items.slice(-400).map((item) =>
+          item.kind === "tool" ? { ...item, output: clipText(item.output, 8 * 1024) } : { ...item, text: clipText(item.text, 32 * 1024) },
+        );
+        write(sock, { t: "work_transcript", id: msg.id, items, ...(out.report !== undefined ? { report: clipText(out.report, 256 * 1024) } : {}), ref: msg.ref });
         return;
       }
       case "work_stop": {

package/packages/app-bridge/src/wire.ts

@@ -325,6 +325,8 @@ export type OutMsg =
   | { t: "lh_progress"; progress: LhProgressInfo | undefined; ref?: string }
   /** UNI-269: the working mode changed (pushed to every client, coalesced). */
   | { t: "lh_mode"; mode: LhModeInfo | undefined }
+  /** UNI-282: reply to `lh_graph` (stop replies `ack` instead). */
+  | { t: "lh_graph"; op: "output" | "history"; output?: unknown; runs?: unknown[]; ref?: string }
   /** UNI-118: Dream status changed (pushed to every client, coalesced), or the
    *  reply to `dream_get` (`ref`). `status` undefined = the dream module isn't loaded. */
   | { t: "dream_status"; status: DreamStatusInfo | undefined; ref?: string }
@@ -464,6 +466,11 @@ export type InMsg =
   /** UNI-269: switch the working mode (no prompt); `none` = /unipi:regular.
    *  Replies `ack` (then an `lh_mode` push) or `error{message}`. */
   | { t: "set_lh_mode"; mode: LhModeId; ref?: string }
+  /** UNI-282: agent graph ops for the Progress sheet. `output` = one step's
+   *  full committed result (`id` = work id or result id, `graphId?` for a past
+   *  graph); `stop` = stop the running graph; `history` = past graphs as runs.
+   *  Replies `lh_graph{op, output? | runs?, ref}` or `error`. */
+  | { t: "lh_graph"; op: "output" | "stop" | "history"; id?: string; graphId?: string; ref?: string }
   /** UNI-118: the current Dream status; replies `dream_status{status, ref}`. */
   | { t: "dream_get"; ref?: string }
   /** UNI-118: one run's report + trajectory; replies `dream_detail` (or `error`). */
@@ -510,6 +517,7 @@ const IN_TYPES = new Set([
   "work_background",
   "lh_progress_get",
   "set_lh_mode",
+  "lh_graph",
   "dream_get",
   "dream_detail",
   "dream_action",
@@ -654,6 +662,17 @@ export function parseIn(line: string): InMsg | { bad: string; ref?: string } | u
         return { bad: "set_lh_mode.mode must be goal|ralph|swarm|graph|none", ref };
       }
       return { t: "set_lh_mode", mode: m.mode as LhModeId, ref };
+    case "lh_graph": {
+      if (m.op !== "output" && m.op !== "stop" && m.op !== "history") return { bad: "lh_graph.op must be output|stop|history", ref };
+      if (m.op === "output" && (typeof m.id !== "string" || !m.id)) return { bad: "lh_graph output needs id", ref };
+      return {
+        t: "lh_graph",
+        op: m.op,
+        ...(typeof m.id === "string" && m.id ? { id: m.id } : {}),
+        ...(typeof m.graphId === "string" && m.graphId ? { graphId: m.graphId } : {}),
+        ref,
+      };
+    }
     case "dream_get":
       return { t: "dream_get", ref };
     case "dream_detail":

package/packages/app-bridge/src/work.ts

@@ -11,6 +11,7 @@ export {
   stopWorkItem,
   backgroundWorkItem,
   workLogPage,
+  workTranscript,
   type WorkItem,
   type WorkDot,
 } from "@pi-unipi/core";

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0-alpha.40",
+  "version": "3.0.0-alpha.41",
   "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-alpha.40"
+    "@pi-unipi/core": "3.0.0-alpha.41"
   },
   "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.40",
+  "version": "3.0.0-alpha.41",
   "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-alpha.40",
+  "version": "3.0.0-alpha.41",
   "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.40",
+    "@pi-unipi/core": "3.0.0-alpha.41",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "3.0.0-alpha.40",
+  "version": "3.0.0-alpha.41",
   "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-alpha.40"
+    "@pi-unipi/core": "3.0.0-alpha.41"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "3.0.0-alpha.40",
+  "version": "3.0.0-alpha.41",
   "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-alpha.40",
-    "@pi-unipi/info-screen": "3.0.0-alpha.40",
+    "@pi-unipi/core": "3.0.0-alpha.41",
+    "@pi-unipi/info-screen": "3.0.0-alpha.41",
     "@earendil-works/pi-agent-core": "^0.87.1"
   },
   "peerDependencies": {

package/packages/core/bus.ts

@@ -58,6 +58,17 @@ export interface LhProgressItem {
   /** The committed result / failure note, clipped. */
   summary?: string;
   attempts?: number;
+  /** UNI-282 (graph/swarm): the subagent that runs/ran it (opens its transcript). */
+  operatorId?: string;
+  /** Committed result id (`r-<id>`) — read the full text with the graph output op. */
+  resultId?: string;
+  /** Subagent profile (graph/swarm). */
+  profile?: string;
+  startedAt?: number;
+  endedAt?: number;
+  toolCalls?: number;
+  /** Input + output tokens of the child run (settled). */
+  tokens?: number;
 }
 
 /** One long-horizon run (the current one or the last finished one). */
@@ -73,6 +84,10 @@ export interface LhProgressRun {
   ralph?: { name: string; iteration: number; maxIterations: number; checked: number; total: number };
   goal?: { objective: string; status: string; turn: number; maxTurns: number; percent?: number; summary?: string; estimatedAt?: number };
   endedAt?: number;
+  /** UNI-282 (graph/swarm): the durable graph id (history / output ops). */
+  graphId?: string;
+  /** Graph/swarm: result ids the supervisor's finish selected. */
+  selected?: string[];
 }
 
 /** One line of the shared progress log, generated from state transitions (never hand-written). */

package/packages/core/package.json

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

package/packages/core/src/work/index.ts

@@ -272,6 +272,27 @@ export async function workLogPage(
   }
 }
 
+/** UNI-282: a subagent's mini-transcript (published by @pi-unipi/subagents). */
+export type WorkTranscriptItem =
+  | { kind: "task"; text: string }
+  | { kind: "text"; text: string }
+  | { kind: "tool"; name: string; arg: string; output: string; isError: boolean; running: boolean; durationMs?: number };
+
+const SUBAGENT_TRANSCRIPT_KEY = Symbol.for("unipi.subagents.transcript");
+
+/** Transcript items + final report of a subagent (work id `agent-<id>`, or a bare subagent id). */
+export function workTranscript(id: string): { items: WorkTranscriptItem[]; report?: string; status?: string } | { error: string } {
+  const [kind, rest] = splitId(id);
+  const agentId = kind === "agent" ? rest : kind === "bg" || kind === "sidekick" ? undefined : id;
+  if (agentId === undefined) return { error: "Only subagents have a transcript." };
+  const read = (globalThis as unknown as Record<symbol, unknown>)[SUBAGENT_TRANSCRIPT_KEY] as
+    | ((id: string) => { items: WorkTranscriptItem[]; report?: string; status?: string } | undefined)
+    | undefined;
+  if (!read) return { error: "Subagents are not available." };
+  const out = read(agentId);
+  return out ?? { error: "That subagent is gone." };
+}
+
 // ── change signal ────────────────────────────────────────────────────────
 //
 // A cheap "something in the work list might have changed" notifier so a TUI

package/packages/dream/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/dream",
-  "version": "3.0.0-alpha.40",
+  "version": "3.0.0-alpha.41",
   "description": "A pi extension that dreams: reviews past session struggles in the background, turns repeated false paths into memory lessons, and crafts skills from errors — part of the Unipi suite",
   "type": "module",
   "main": "extensions/dream.ts",
@@ -39,7 +39,7 @@
     "@earendil-works/pi-tui": "^0.87.1"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.40"
+    "@pi-unipi/core": "3.0.0-alpha.41"
   },
   "pi": {
     "extensions": [

package/packages/footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "3.0.0-alpha.40",
+  "version": "3.0.0-alpha.41",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.40",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.40"
+    "@pi-unipi/core": "3.0.0-alpha.41",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.41"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/fusion/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/fusion",
-  "version": "3.0.0-alpha.40",
+  "version": "3.0.0-alpha.41",
   "description": "Devin-style model picker, fusion presets (lead + sidekick), and Local Fusion runtime for UniPi",
   "type": "module",
   "main": "src/index.ts",
@@ -32,9 +32,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.40",
-    "@pi-unipi/subagents": "3.0.0-alpha.40",
-    "@pi-unipi/utility": "3.0.0-alpha.40"
+    "@pi-unipi/core": "3.0.0-alpha.41",
+    "@pi-unipi/subagents": "3.0.0-alpha.41",
+    "@pi-unipi/utility": "3.0.0-alpha.41"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.87.1",

package/packages/info-screen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "3.0.0-alpha.40",
+  "version": "3.0.0-alpha.41",
   "description": "Unicrab startup splash and the /unipi:info dashboard — this session, context, usage, compaction savings",
   "type": "module",
   "main": "index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.40"
+    "@pi-unipi/core": "3.0.0-alpha.41"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "3.0.0-alpha.40",
+  "version": "3.0.0-alpha.41",
   "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle — chord-based overlay system",
   "type": "module",
   "main": "src/index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.40"
+    "@pi-unipi/core": "3.0.0-alpha.41"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "3.0.0-alpha.40",
+  "version": "3.0.0-alpha.41",
   "description": "Kanboard v3 — deferred-work board: CLI/daemon bridge, task runner and skill",
   "type": "module",
   "main": "index.ts",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.40"
+    "@pi-unipi/core": "3.0.0-alpha.41"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",
@@ -48,10 +48,10 @@
     "themes": []
   },
   "optionalDependencies": {
-    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.40",
-    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.40",
-    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.40",
-    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.40",
-    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.40"
+    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.41",
+    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.41",
+    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.41",
+    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.41",
+    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.41"
   }
 }

package/packages/long-horizon/README.md

@@ -41,7 +41,8 @@ when the task finishes or cannot continue.
 | `/unipi:ralph <prompt>` | Runs the prompt in `ralph` mode. |
 | `/unipi:swarm <prompt>` | Runs the prompt in `swarm` mode. |
 | `/unipi:graph <prompt>` | Runs the prompt in `graph` mode. |
-| `/unipi:<mode> status` | Shows the owner, the park slot and the judge settings. |
+| `/unipi:<mode> status` | Shows the owner, the park slot and the judge settings. For `graph` and `swarm`, also the graph's step counts. |
+| `/unipi:graph history`, `/unipi:swarm history` | Lists past agent graphs and the results each one selected. |
 | `/unipi:<mode> stop` | Ends the active owner. For `ralph`, it parks the loop. |
 | `/unipi:<mode> resume` | Starts the parked owner again. |
 | `/unipi:<mode> clear` | Removes the parked owner. |
@@ -58,8 +59,15 @@ Each tool shows only in its mode. `todowrite` shows in all four modes.
 |---|---|---|
 | `create_goal`, `get_goal`, `update_goal` | `goal` | Creates, reads and finishes the goal. Also changes the token budget. |
 | `ralph_done`, `loop_status` | `ralph` | Ends one iteration. Reads the loop state. |
-| `swarm_report`, `swarm_status`, `swarm_yield` | `swarm` | Records item results. Reads the state. Ends the turn while workers run. |
-| `update_agent_graph`, `graph_output`, `view_agent_graph` | `graph` | Declares the graph. Records item results. Reads the graph. |
+| `update_agent_graph`, `view_agent_graph`, `yield_agent_graph`, `agent_output`, `agent_swarm_status` | `graph`, `swarm` | Adds, stops or finishes work on the agent graph. Reads the graph, a step's result and the swarm status. Ends the turn while steps run. |
+
+`graph` and `swarm` share one durable agent graph (the Maka model). The model
+adds work with dependencies (`input_ids`), and the host runs each step as a
+background subagent. The model yields, and pi wakes it once at each
+checkpoint: a failure, nothing left to run, or everything settled. A graph
+closes only when the model finishes it with the results it chose. The graph is
+saved in the project's state folder, so it survives a restart. Steps that
+were running resume once in their own subagent session.
 | `todowrite` | all | Replaces the visible task list. |
 
 ## Settings