@mu-crew/mu 3.11.2 → 3.12.0

package/dist/index.d.ts

@@ -2126,6 +2126,8 @@ type SendResult = {
     runs?: number;
     /** ctl only: when pi entered `state` (epoch ms), from the same status. */
     since?: number;
+    /** ctl only: pi's session file, from the same status. */
+    sessionFile?: string;
     /** Set when the text ran as a pi session command over ctl. */
     command?: CtlCommandName;
 };

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   priorFieldValue,
   resolveGroupId,
   undoGroup
-} from "./chunk-DXKJY3NT.js";
+} from "./chunk-XV7J56GD.js";
 import {
   AGENT_STATE_GLYPH,
   AgentAbortNeedsCtlError,
@@ -252,7 +252,7 @@ import {
   workspacePath,
   workspacesRoot,
   yankCommandForCheck
-} from "./chunk-JYZUNPPO.js";
+} from "./chunk-IRPTNVJC.js";
 import {
   CAPTURE_TRIGGER_DDL,
   CURRENT_SCHEMA_VERSION,
@@ -325,10 +325,10 @@ import {
   withCaptureSuppressed,
   withFileLock,
   withOpContext
-} from "./chunk-WYBOR4FX.js";
+} from "./chunk-R2SVBZAB.js";
 import {
   defaultStateDir
-} from "./chunk-4PACTXAB.js";
+} from "./chunk-L2ABBTYG.js";
 import "./chunk-PZ5AY32C.js";
 export {
   AGENT_STATE_GLYPH,

package/dist/{tui-DGDEH4JX.js → tui-LO75XA3O.js}

@@ -12,7 +12,7 @@ import {
   relTimeBasisForSort,
   sortTasks,
   truncate
-} from "./chunk-2FJK6OOZ.js";
+} from "./chunk-TEGZOXML.js";
 import {
   GLYPH,
   WORKSPACE_STALE_THRESHOLD,
@@ -41,15 +41,15 @@ import {
   summarizeOwnedTasks,
   superscriptDigit,
   yankCommandForCheck
-} from "./chunk-JYZUNPPO.js";
+} from "./chunk-IRPTNVJC.js";
 import {
   TASK_STATUSES,
   ambientSyncPass,
   formatPair,
   syncEnabled,
   tryResolveWorkstreamId
-} from "./chunk-WYBOR4FX.js";
-import "./chunk-4PACTXAB.js";
+} from "./chunk-R2SVBZAB.js";
+import "./chunk-L2ABBTYG.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/cli/tui/index.ts
@@ -6449,4 +6449,4 @@ async function runTui(db, opts) {
 export {
   runTui
 };
-//# sourceMappingURL=tui-DGDEH4JX.js.map
+//# sourceMappingURL=tui-LO75XA3O.js.map

package/dist/tui-sync-worker.js

@@ -1,8 +1,8 @@
 import {
   ambientSyncPass,
   openDb
-} from "./chunk-WYBOR4FX.js";
-import "./chunk-4PACTXAB.js";
+} from "./chunk-R2SVBZAB.js";
+import "./chunk-L2ABBTYG.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/cli/tui/sync-worker.ts

package/docs/architecture/control-socket.md

@@ -28,9 +28,9 @@ reply carries `v: 1`; the client (`src/ctl/client.ts`) throws
 | op | does |
 | --- | --- |
 | `hello` | identity plus `ops` (served ops) and `extVersion` (the mu version the extension was built from) |
-| `status` | `state` (`busy` / `idle`), `since`, `runs`, `pending` |
+| `status` | `state` (`busy` / `idle`), `since`, `runs`, `pending`, and pi's `sessionFile` when it has one |
 | `send` | `pi.sendUserMessage`; when busy, `mode` is `steer` or `followUp` (default). Replies with the `status` fields measured before the dispatch, so `runs` is the baseline for a later `wait` |
-| `wait` | resolves on pi's `agent_settled` after `afterRuns`, with the run's `lastText` |
+| `wait` | resolves on pi's `agent_settled` after `afterRuns`, with the run's `lastText` and pi's `sessionFile` |
 | `abort` | `ctx.abort()` (pi's Esc) |
 | `interrupt` | busy: `ctx.abort()`, wait for `agent_settled` (up to `timeoutMs`), then `pi.sendUserMessage(text)` as a new run; idle: just the send. Replies `wasBusy`, `pending` (measured before the abort) and the `status` fields measured after the settle and before the send, so `runs` is the `wait` baseline for the new run. `timeout`: nothing sent |
 | `fresh` | new session plus prompt as one operation, through the internal `/mu-fresh` command; replies once the new run starts; refused with `busy` unless `force` |

package/docs/guide/delegate.md

@@ -33,6 +33,11 @@ Delegates called in one turn run in parallel.
 - pi's footer shows how many delegates this session is waiting on, and
   `N results pending` for delegates that finished but whose answer has
   not reached the conversation yet (queued behind the running turn).
+  Escape drops those queued answers from pi. The extension then writes
+  one line per answer into the conversation, without starting a turn,
+  pointing at a copy under `~/.cache/mu/delegate-answers/` and
+  at the delegate's own pi session file. An answer that lands after
+  Escape arrives as usual.
 - Each delegate costs a pane and a pi process. A session runs at most
   `MU_DELEGATE_MAX` at once (default 16). Further calls are queued, up
   to four times the cap: the footer reads `16 delegates running, 4 queued`,
@@ -43,6 +48,11 @@ Delegates called in one turn run in parallel.
   keeps its pane. The answer names the error and leaves the choice to
   the model: re-issue, or record the check as unverified. The footer
   counts it as `1 failed` until the pane is closed.
+- Every answer without a final text (API error, empty, timeout, died,
+  `mu_delegate_cancel`) names the delegate's pi session file and, when
+  it wrote anything, a copy of its last message so far under
+  `~/.cache/mu/delegate-answers/` (`*.partial.md`). Quitting pi or
+  `/reload` lists each running delegate's session file.
 - Answers arrive as follow-up messages when pi would otherwise stop,
   never mid-turn. To get several at once, set pi's `followUpMode` to
   `"all"`.
@@ -91,6 +101,8 @@ row carries:
   `error` means the run stopped on an API error after pi's own retries;
   `lastError` holds the message and the pane is kept.
 - `lastText`: the final message, capped at 64 KiB.
+- `sessionFile`: the agent's pi session file, holding the full
+  transcript (absent for an ephemeral pi or an older extension).
 
 Exit codes: `0` met, `5` timeout, `6` pane died. Non-pi agents have no
 `lastText`; read the pane with `mu agent read helper-1 -w scratch -n 80`.

package/docs/reference/env.md

@@ -12,6 +12,7 @@ milliseconds; `0` disables a wait unless noted.
 | `MU_DB_PATH` | SQLite file path. Wins over the state dir. | `<state-dir>/mu.db` |
 | `MU_STATE_DIR` | State directory. Also holds `compile-cache/` (V8 code cache for the CLI; `NODE_DISABLE_COMPILE_CACHE=1` turns it off). | `$XDG_STATE_HOME/mu` |
 | `XDG_STATE_HOME` | XDG state base; mu appends `mu/`. An empty or relative value is ignored. | `~/.local/state` |
+| `XDG_CACHE_HOME` | XDG cache base; mu appends `mu/`. Holds only disposable copies. An empty or relative value is ignored. | `~/.cache` |
 | `MU_SESSION` | Active workstream when `-w` is absent. | current `mu-<name>` mux session |
 | `MU_SYNC_DIR` | Folder holding one segment per machine. This is the whole sync setup; there is no peer list. | unset: sync off |
 

package/docs/reference/naming.md

@@ -95,5 +95,12 @@ Never put `MU_DB_PATH` inside `MU_SYNC_DIR`: syncing a live SQLite
 file and its `-wal` and `-shm` sidecars corrupts it. `mu doctor` checks
 for this.
 
+The cache dir is `$XDG_CACHE_HOME/mu`, else `~/.cache/mu`. Anything in
+it can be deleted at any time.
+
+| Path | Contents |
+| --- | --- |
+| `<cache-dir>/delegate-answers/` | Copies of delegate answers an Escape dropped from pi's queue, and `*.partial.md`: a delegate's last message before it timed out, died, failed or was cancelled (the delegate's pi session file keeps the original) |
+
 mu reads no agent-template directory (`~/.pi/agent/agents/`,
 `.pi/agents/`). A role is a name and a brief.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mu-crew/mu",
-  "version": "3.11.2",
+  "version": "3.12.0",
   "description": "A persistent, observable crew of pi agents running in one tmux or herdr session per workstream, coordinated through a built-in task DAG.",
   "publishConfig": {
     "access": "public"

package/dist/chunk-4PACTXAB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/state-dir.ts"],"sourcesContent":["// The mu state directory, resolved from builtins only so the CLI\n// bootstrap (src/main.ts) can locate its compile cache before it loads\n// any of the CLI graph. db.ts re-exports defaultStateDir.\n\nimport { homedir } from \"node:os\";\nimport { isAbsolute, join } from \"node:path\";\n\n/**\n * Resolve the canonical mu state directory:\n *   MU_STATE_DIR > $XDG_STATE_HOME/mu (absolute only) > ~/.local/state/mu\n */\nexport function defaultStateDir(): string {\n  if (process.env.MU_STATE_DIR) return process.env.MU_STATE_DIR;\n  return join(xdgStateHome(homedir()), \"mu\");\n}\n\n/** `$XDG_STATE_HOME`, or `<home>/.local/state` when it is unset, empty,\n *  or relative: the XDG spec says such a value must be ignored, and a\n *  relative one would scatter state across every cwd mu runs in. */\nexport function xdgStateHome(home: string): string {\n  const xdg = process.env.XDG_STATE_HOME;\n  return xdg !== undefined && isAbsolute(xdg) ? xdg : join(home, \".local\", \"state\");\n}\n"],"mappings":";AAIA,SAAS,eAAe;AACxB,SAAS,YAAY,YAAY;AAM1B,SAAS,kBAA0B;AACxC,MAAI,QAAQ,IAAI,aAAc,QAAO,QAAQ,IAAI;AACjD,SAAO,KAAK,aAAa,QAAQ,CAAC,GAAG,IAAI;AAC3C;AAKO,SAAS,aAAa,MAAsB;AACjD,QAAM,MAAM,QAAQ,IAAI;AACxB,SAAO,QAAQ,UAAa,WAAW,GAAG,IAAI,MAAM,KAAK,MAAM,UAAU,OAAO;AAClF;","names":[]}