gsd-pi 2.10.8 → 2.10.9

package/README.md

@@ -11,7 +11,7 @@
 
 The original GSD went viral as a prompt framework for Claude Code. It worked, but it was fighting the tool — injecting prompts through slash commands, hoping the LLM would follow instructions, with no actual control over context windows, sessions, or execution.
 
-This version is different. GSD is now a standalone CLI built on the [Pi SDK](https://github.com/badlogic/pi-mono), which gives it direct TypeScript access to the agent harness itself. That means GSD can actually *do* what v1 could only *ask* the LLM to do: clear context between tasks, inject exactly the right files at dispatch time, manage git branches, track cost and tokens, detect stuck loops, recover from crashes, and auto-advance through an entire milestone without human intervention.
+This version is different. GSD is now a standalone CLI built on the [Pi SDK](https://github.com/badlogic/pi-mono), which gives it direct TypeScript access to the agent harness itself. That means GSD can actually _do_ what v1 could only _ask_ the LLM to do: clear context between tasks, inject exactly the right files at dispatch time, manage git branches, track cost and tokens, detect stuck loops, recover from crashes, and auto-advance through an entire milestone without human intervention.
 
 One command. Walk away. Come back to a built project with clean git history.
 
@@ -30,21 +30,21 @@ The original GSD was a collection of markdown prompts installed into `~/.claude/
 - **No crash recovery.** If the session died mid-task, you started over.
 - **No observability.** No cost tracking, no progress dashboard, no stuck detection.
 
-GSD v2 solves all of these because it's not a prompt framework anymore — it's a TypeScript application that *controls* the agent session.
-
-| | v1 (Prompt Framework) | v2 (Agent Application) |
-|---|---|---|
-| Runtime | Claude Code slash commands | Standalone CLI via Pi SDK |
-| Context management | Hope the LLM doesn't fill up | Fresh session per task, programmatic |
-| Auto mode | LLM self-loop | State machine reading `.gsd/` files |
-| Crash recovery | None | Lock files + session forensics |
-| Git strategy | LLM writes git commands | Programmatic branch-per-slice, squash merge |
-| Cost tracking | None | Per-unit token/cost ledger with dashboard |
-| Stuck detection | None | Retry once, then stop with diagnostics |
-| Timeout supervision | None | Soft/idle/hard timeouts with recovery steering |
-| Context injection | "Read this file" | Pre-inlined into dispatch prompt |
-| Roadmap reassessment | Manual | Automatic after each slice completes |
-| Skill discovery | None | Auto-detect and install relevant skills during research |
+GSD v2 solves all of these because it's not a prompt framework anymore — it's a TypeScript application that _controls_ the agent session.
+
+|                      | v1 (Prompt Framework)        | v2 (Agent Application)                                  |
+| -------------------- | ---------------------------- | ------------------------------------------------------- |
+| Runtime              | Claude Code slash commands   | Standalone CLI via Pi SDK                               |
+| Context management   | Hope the LLM doesn't fill up | Fresh session per task, programmatic                    |
+| Auto mode            | LLM self-loop                | State machine reading `.gsd/` files                     |
+| Crash recovery       | None                         | Lock files + session forensics                          |
+| Git strategy         | LLM writes git commands      | Programmatic branch-per-slice, squash merge             |
+| Cost tracking        | None                         | Per-unit token/cost ledger with dashboard               |
+| Stuck detection      | None                         | Retry once, then stop with diagnostics                  |
+| Timeout supervision  | None                         | Soft/idle/hard timeouts with recovery steering          |
+| Context injection    | "Read this file"             | Pre-inlined into dispatch prompt                        |
+| Roadmap reassessment | Manual                       | Automatic after each slice completes                    |
+| Skill discovery      | None                         | Auto-detect and install relevant skills during research |
 
 ### Migrating from v1
 
@@ -61,6 +61,7 @@ If you have projects with `.planning` directories from the original Get Shit Don
 ```
 
 The migration tool:
+
 - Parses your old `PROJECT.md`, `ROADMAP.md`, `REQUIREMENTS.md`, phase directories, plans, summaries, and research
 - Maps phases → slices, plans → tasks, milestones → milestones
 - Preserves completion state (`[x]` phases stay done, summaries carry over)
@@ -110,7 +111,7 @@ Auto mode is a state machine driven by files on disk. It reads `.gsd/STATE.md`,
 
 2. **Context pre-loading** — The dispatch prompt includes inlined task plans, slice plans, prior task summaries, dependency summaries, roadmap excerpts, and decisions register. The LLM starts with everything it needs instead of spending tool calls reading files.
 
-3. **Git branch-per-slice** — Each slice gets its own branch (`gsd/M001/S01`). Tasks commit atomically on the branch. When the slice completes, it's squash-merged to main as one clean commit.
+3. **Git branch-per-slice** — Each slice gets its own branch (`gsd/M001/S01`). Tasks commit atomically on the branch. When the slice completes, it's squash-merged to main (or whichever branch you started from) as one clean commit.
 
 4. **Crash recovery** — A lock file tracks the current unit. If the session dies, the next `/gsd auto` reads the surviving session file, synthesizes a recovery briefing from every tool call that made it to disk, and resumes with full context.
 
@@ -183,12 +184,14 @@ GSD opens an interactive agent session. From there, you have two ways to work:
 The real workflow: run auto mode in one terminal, steer from another.
 
 **Terminal 1 — let it build**
+
 ```bash
 gsd
 /gsd auto
 ```
 
 **Terminal 2 — steer while it works**
+
 ```bash
 gsd
 /gsd discuss    # talk through architecture decisions
@@ -204,28 +207,28 @@ On first run, GSD launches a branded setup wizard that walks you through LLM pro
 
 ### Commands
 
-| Command | What it does |
-|---------|-------------|
-| `/gsd` | Step mode — executes one unit at a time, pauses between each |
-| `/gsd next` | Explicit step mode (same as bare `/gsd`) |
-| `/gsd auto` | Autonomous mode — researches, plans, executes, commits, repeats |
-| `/gsd stop` | Stop auto mode gracefully |
-| `/gsd discuss` | Discuss architecture and decisions (works alongside auto mode) |
-| `/gsd status` | Progress dashboard |
-| `/gsd queue` | Queue future milestones (safe during auto mode) |
-| `/gsd prefs` | Model selection, timeouts, budget ceiling |
-| `/gsd migrate` | Migrate a v1 `.planning` directory to `.gsd` format |
-| `/gsd doctor` | Validate `.gsd/` integrity, find and fix issues |
-| `/worktree` (`/wt`) | Git worktree lifecycle — create, switch, merge, remove |
-| `/voice` | Toggle real-time speech-to-text (macOS only) |
-| `/exit` | Graceful shutdown — saves session state before exiting |
-| `/kill` | Kill GSD process immediately |
-| `/clear` | Start a new session (alias for `/new`) |
-| `Ctrl+Alt+G` | Toggle dashboard overlay |
-| `Ctrl+Alt+V` | Toggle voice transcription |
-| `Ctrl+Alt+B` | Show background shell processes |
-| `gsd config` | Re-run the setup wizard (LLM provider + tool keys) |
-| `gsd --continue` (`-c`) | Resume the most recent session for the current directory |
+| Command                 | What it does                                                    |
+| ----------------------- | --------------------------------------------------------------- |
+| `/gsd`                  | Step mode — executes one unit at a time, pauses between each    |
+| `/gsd next`             | Explicit step mode (same as bare `/gsd`)                        |
+| `/gsd auto`             | Autonomous mode — researches, plans, executes, commits, repeats |
+| `/gsd stop`             | Stop auto mode gracefully                                       |
+| `/gsd discuss`          | Discuss architecture and decisions (works alongside auto mode)  |
+| `/gsd status`           | Progress dashboard                                              |
+| `/gsd queue`            | Queue future milestones (safe during auto mode)                 |
+| `/gsd prefs`            | Model selection, timeouts, budget ceiling                       |
+| `/gsd migrate`          | Migrate a v1 `.planning` directory to `.gsd` format             |
+| `/gsd doctor`           | Validate `.gsd/` integrity, find and fix issues                 |
+| `/worktree` (`/wt`)     | Git worktree lifecycle — create, switch, merge, remove          |
+| `/voice`                | Toggle real-time speech-to-text (macOS only)                    |
+| `/exit`                 | Graceful shutdown — saves session state before exiting          |
+| `/kill`                 | Kill GSD process immediately                                    |
+| `/clear`                | Start a new session (alias for `/new`)                          |
+| `Ctrl+Alt+G`            | Toggle dashboard overlay                                        |
+| `Ctrl+Alt+V`            | Toggle voice transcription                                      |
+| `Ctrl+Alt+B`            | Show background shell processes                                 |
+| `gsd config`            | Re-run the setup wizard (LLM provider + tool keys)              |
+| `gsd --continue` (`-c`) | Resume the most recent session for the current directory        |
 
 ---
 
@@ -235,18 +238,18 @@ On first run, GSD launches a branded setup wizard that walks you through LLM pro
 
 Every dispatch is carefully constructed. The LLM never wastes tool calls on orientation.
 
-| Artifact | Purpose |
-|----------|---------|
-| `PROJECT.md` | Living doc — what the project is right now |
-| `DECISIONS.md` | Append-only register of architectural decisions |
-| `STATE.md` | Quick-glance dashboard — always read first |
-| `M001-ROADMAP.md` | Milestone plan with slice checkboxes, risk levels, dependencies |
-| `M001-CONTEXT.md` | User decisions from the discuss phase |
-| `M001-RESEARCH.md` | Codebase and ecosystem research |
-| `S01-PLAN.md` | Slice task decomposition with must-haves |
-| `T01-PLAN.md` | Individual task plan with verification criteria |
-| `T01-SUMMARY.md` | What happened — YAML frontmatter + narrative |
-| `S01-UAT.md` | Human test script derived from slice outcomes |
+| Artifact           | Purpose                                                         |
+| ------------------ | --------------------------------------------------------------- |
+| `PROJECT.md`       | Living doc — what the project is right now                      |
+| `DECISIONS.md`     | Append-only register of architectural decisions                 |
+| `STATE.md`         | Quick-glance dashboard — always read first                      |
+| `M001-ROADMAP.md`  | Milestone plan with slice checkboxes, risk levels, dependencies |
+| `M001-CONTEXT.md`  | User decisions from the discuss phase                           |
+| `M001-RESEARCH.md` | Codebase and ecosystem research                                 |
+| `S01-PLAN.md`      | Slice task decomposition with must-haves                        |
+| `T01-PLAN.md`      | Individual task plan with verification criteria                 |
+| `T01-SUMMARY.md`   | What happened — YAML frontmatter + narrative                    |
+| `S01-UAT.md`       | Human test script derived from slice outcomes                   |
 
 ### Git Strategy
 
@@ -265,7 +268,7 @@ gsd/M001/S01 (deleted after merge):
   feat(S01/T01): core types and interfaces
 ```
 
-One commit per slice on main. Squash commits are the permanent record — branches are deleted after merge. Git bisect works. Individual slices are revertable.
+One commit per slice on main (or whichever branch you started from). Squash commits are the permanent record — branches are deleted after merge. Git bisect works. Individual slices are revertable.
 
 ### Verification
 
@@ -313,51 +316,95 @@ auto_supervisor:
   idle_timeout_minutes: 10
   hard_timeout_minutes: 30
 budget_ceiling: 50.00
+unique_milestone_ids: true
 ---
 ```
 
 **Key settings:**
 
-| Setting | What it controls |
-|---------|-----------------|
-| `models.*` | Per-phase model selection — string for a single model, or `{model, fallbacks}` for automatic failover |
-| `skill_discovery` | `auto` / `suggest` / `off` — how GSD finds and applies skills |
-| `auto_supervisor.*` | Timeout thresholds for auto mode supervision |
-| `budget_ceiling` | USD ceiling — auto mode pauses when reached |
-| `uat_dispatch` | Enable automatic UAT runs after slice completion |
-| `always_use_skills` | Skills to always load when relevant |
-| `skill_rules` | Situational rules for skill routing |
+| Setting                | What it controls                                                                                      |
+| ---------------------- | ----------------------------------------------------------------------------------------------------- |
+| `models.*`             | Per-phase model selection — string for a single model, or `{model, fallbacks}` for automatic failover |
+| `skill_discovery`      | `auto` / `suggest` / `off` — how GSD finds and applies skills                                         |
+| `auto_supervisor.*`    | Timeout thresholds for auto mode supervision                                                          |
+| `budget_ceiling`       | USD ceiling — auto mode pauses when reached                                                           |
+| `uat_dispatch`         | Enable automatic UAT runs after slice completion                                                      |
+| `always_use_skills`    | Skills to always load when relevant                                                                   |
+| `skill_rules`          | Situational rules for skill routing                                                                   |
+| `unique_milestone_ids` | Uses unique milestone names to avoid clashes when working in teams of people                          |
 
 ### Bundled Tools
 
 GSD ships with 14 extensions, all loaded automatically:
 
-| Extension | What it provides |
-|-----------|-----------------|
-| **GSD** | Core workflow engine, auto mode, commands, dashboard |
-| **Browser Tools** | Playwright-based browser with form intelligence, intent-ranked element finding, and semantic actions |
-| **Search the Web** | Brave Search, Tavily, or Jina page extraction |
-| **Google Search** | Gemini-powered web search with AI-synthesized answers |
-| **Context7** | Up-to-date library/framework documentation |
-| **Background Shell** | Long-running process management with readiness detection |
-| **Subagent** | Delegated tasks with isolated context windows |
-| **Mac Tools** | macOS native app automation via Accessibility APIs |
-| **MCPorter** | Lazy on-demand MCP server integration |
-| **Voice** | Real-time speech-to-text transcription (macOS) |
-| **Slash Commands** | Custom command creation |
-| **LSP** | Language Server Protocol integration — diagnostics, go-to-definition, references, hover, symbols, rename, code actions |
-| **Ask User Questions** | Structured user input with single/multi-select |
-| **Secure Env Collect** | Masked secret collection without manual .env editing |
+| Extension              | What it provides                                                                                                       |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| **GSD**                | Core workflow engine, auto mode, commands, dashboard                                                                   |
+| **Browser Tools**      | Playwright-based browser with form intelligence, intent-ranked element finding, and semantic actions                   |
+| **Search the Web**     | Brave Search, Tavily, or Jina page extraction                                                                          |
+| **Google Search**      | Gemini-powered web search with AI-synthesized answers                                                                  |
+| **Context7**           | Up-to-date library/framework documentation                                                                             |
+| **Background Shell**   | Long-running process management with readiness detection                                                               |
+| **Subagent**           | Delegated tasks with isolated context windows                                                                          |
+| **Mac Tools**          | macOS native app automation via Accessibility APIs                                                                     |
+| **MCPorter**           | Lazy on-demand MCP server integration                                                                                  |
+| **Voice**              | Real-time speech-to-text transcription (macOS)                                                                         |
+| **Slash Commands**     | Custom command creation                                                                                                |
+| **LSP**                | Language Server Protocol integration — diagnostics, go-to-definition, references, hover, symbols, rename, code actions |
+| **Ask User Questions** | Structured user input with single/multi-select                                                                         |
+| **Secure Env Collect** | Masked secret collection without manual .env editing                                                                   |
 
 ### Bundled Agents
 
 Three specialized subagents for delegated work:
 
-| Agent | Role |
-|-------|------|
-| **Scout** | Fast codebase recon — returns compressed context for handoff |
-| **Researcher** | Web research — finds and synthesizes current information |
-| **Worker** | General-purpose execution in an isolated context window |
+| Agent          | Role                                                         |
+| -------------- | ------------------------------------------------------------ |
+| **Scout**      | Fast codebase recon — returns compressed context for handoff |
+| **Researcher** | Web research — finds and synthesizes current information     |
+| **Worker**     | General-purpose execution in an isolated context window      |
+
+---
+
+## Working in teams
+
+The best practice for working in teams is to ensure unique milestone names across all branches (by using `unique_milestone_ids`) and checking in the right `.gsd/` artifacts to share valueable context between teammates.
+
+### Suggested .gitignore setup
+```bash
+# ── GSD: Runtime / Ephemeral (per-developer, per-session) ──────────────────
+# Crash detection sentinel — PID lock, written per auto-mode session
+.gsd/auto.lock
+# Auto-mode dispatch tracker — prevents re-running completed units
+.gsd/completed-units.json
+# Derived state cache — regenerated from plan/roadmap files on disk
+.gsd/STATE.md
+# Per-developer token/cost accumulator
+.gsd/metrics.json
+# Raw JSONL session dumps — crash recovery forensics, auto-pruned
+.gsd/activity/
+# Unit execution records — dispatch phase, timeouts, recovery tracking
+.gsd/runtime/
+# Git worktree working copies
+.gsd/worktrees/
+# Session-specific interrupted-work markers
+.gsd/milestones/**/continue.md
+.gsd/milestones/**/*-CONTINUE.md
+```
+
+### Unique Milestone Names
+
+Create or amend your `.gsd/preferences.md` file within the repo to include `unique_milestone_ids: true` e.g.
+```markdown
+---
+version: 1
+unique_milestone_ids: true
+---
+```
+
+With the above `.gitignore` set up, the `.gsd/preferences.md` file is checked into the repo ensuring all teammates use unique milestone names to avoid collisions.
+
+Milestone names will now be generated with a 6 char random string appended e.g. instead of `M001` you'll get something like `M001-ush8s3`
 
 ---
 
@@ -397,6 +444,7 @@ gsd (CLI binary)
 - **Git** — initialized automatically if missing
 
 Optional:
+
 - Brave Search API key (web research)
 - Tavily API key (web research — alternative to Brave)
 - Google Gemini API key (web research via Gemini Search grounding)

package/node_modules/@gsd/native/dist/index.d.ts

@@ -34,7 +34,7 @@ export { fuzzyFind } from "./fd/index.js";
 export type { FuzzyFindMatch, FuzzyFindOptions, FuzzyFindResult, } from "./fd/index.js";
 export { parseImage, ImageFormat, SamplingFilter } from "./image/index.js";
 export type { NativeImageHandle } from "./image/index.js";
-export { xxHash32 } from "./xxhash/index.js";
+export { xxHash32, xxHash32Fallback } from "./xxhash/index.js";
 export { ttsrCompileRules, ttsrCheckBuffer, ttsrFreeRules } from "./ttsr/index.js";
 export type { TtsrHandle, TtsrRuleInput } from "./ttsr/index.js";
 export { parseJson, parsePartialJson, parseStreamingJson, } from "./json-parse/index.js";

package/node_modules/@gsd/native/dist/index.js

@@ -24,7 +24,7 @@ export { wrapTextWithAnsi, truncateToWidth, sliceWithWidth, extractSegments, san
 export { normalizeForFuzzyMatch, fuzzyFindText, generateDiff, } from "./diff/index.js";
 export { fuzzyFind } from "./fd/index.js";
 export { parseImage, ImageFormat, SamplingFilter } from "./image/index.js";
-export { xxHash32 } from "./xxhash/index.js";
+export { xxHash32, xxHash32Fallback } from "./xxhash/index.js";
 export { ttsrCompileRules, ttsrCheckBuffer, ttsrFreeRules } from "./ttsr/index.js";
 export { parseJson, parsePartialJson, parseStreamingJson, } from "./json-parse/index.js";
 export { processStreamChunk, stripAnsiNative, sanitizeBinaryOutputNative, } from "./stream-process/index.js";

package/node_modules/@gsd/native/dist/xxhash/index.d.ts

@@ -1,11 +1,20 @@
 /**
- * Native xxHash32 — Rust implementation via napi-rs.
+ * Native xxHash32 — Rust implementation via napi-rs, with a pure-JS fallback.
  *
  * Hashes the UTF-8 representation of the input string with the given seed.
  */
+/**
+ * Pure-JS xxHash32 implementation. Exposed for testing to allow CI to validate
+ * the fallback path independently of native addon availability.
+ */
+export declare function xxHash32Fallback(input: string, seed: number): number;
 /**
  * Compute xxHash32 of a UTF-8 string.
  *
+ * Uses the native Rust implementation when available; falls back to a
+ * pure-JS implementation if the loaded native addon does not export
+ * `xxHash32` (e.g. an older build).
+ *
  * @param input  The string to hash (encoded as UTF-8 internally).
  * @param seed   32-bit seed value.
  * @returns      32-bit unsigned hash.

package/node_modules/@gsd/native/dist/xxhash/index.js

@@ -1,16 +1,85 @@
 /**
- * Native xxHash32 — Rust implementation via napi-rs.
+ * Native xxHash32 — Rust implementation via napi-rs, with a pure-JS fallback.
  *
  * Hashes the UTF-8 representation of the input string with the given seed.
  */
 import { native } from "../native.js";
+// ─── Pure-JS xxHash32 fallback ────────────────────────────────────────────────
+// Used when the native addon is present but does not export xxHash32
+// (e.g. an older build or an unsupported platform variant).
+const PRIME32_1 = 0x9e3779b1;
+const PRIME32_2 = 0x85ebca77;
+const PRIME32_3 = 0xc2b2ae3d;
+const PRIME32_4 = 0x27d4eb2f;
+const PRIME32_5 = 0x165667b1;
+function rotl32(v, n) {
+    return ((v << n) | (v >>> (32 - n))) >>> 0;
+}
+/** Single xxHash32 lane accumulation step (processes one 32-bit word). */
+function accumulate(v, lane) {
+    return Math.imul(rotl32((v + Math.imul(lane, PRIME32_2)) >>> 0, 13), PRIME32_1) >>> 0;
+}
+function xxHash32JS(input, seed) {
+    const data = Buffer.from(input, "utf-8");
+    const len = data.length;
+    let h32;
+    let i = 0;
+    if (len >= 16) {
+        let v1 = (seed + PRIME32_1 + PRIME32_2) >>> 0;
+        let v2 = (seed + PRIME32_2) >>> 0;
+        let v3 = seed >>> 0;
+        let v4 = (seed - PRIME32_1) >>> 0;
+        while (i <= len - 16) {
+            v1 = accumulate(v1, data.readUInt32LE(i));
+            i += 4;
+            v2 = accumulate(v2, data.readUInt32LE(i));
+            i += 4;
+            v3 = accumulate(v3, data.readUInt32LE(i));
+            i += 4;
+            v4 = accumulate(v4, data.readUInt32LE(i));
+            i += 4;
+        }
+        h32 = (rotl32(v1, 1) + rotl32(v2, 7) + rotl32(v3, 12) + rotl32(v4, 18)) >>> 0;
+    }
+    else {
+        h32 = (seed + PRIME32_5) >>> 0;
+    }
+    h32 = (h32 + len) >>> 0;
+    while (i <= len - 4) {
+        h32 = Math.imul(rotl32((h32 + Math.imul(data.readUInt32LE(i), PRIME32_3)) >>> 0, 17), PRIME32_4) >>> 0;
+        i += 4;
+    }
+    while (i < len) {
+        h32 = Math.imul(rotl32((h32 + Math.imul(data[i], PRIME32_5)) >>> 0, 11), PRIME32_1) >>> 0;
+        i++;
+    }
+    h32 = Math.imul(h32 ^ (h32 >>> 15), PRIME32_2) >>> 0;
+    h32 = Math.imul(h32 ^ (h32 >>> 13), PRIME32_3) >>> 0;
+    h32 = (h32 ^ (h32 >>> 16)) >>> 0;
+    return h32;
+}
+/**
+ * Pure-JS xxHash32 implementation. Exposed for testing to allow CI to validate
+ * the fallback path independently of native addon availability.
+ */
+export function xxHash32Fallback(input, seed) {
+    return xxHash32JS(input, seed);
+}
+// Resolve once at module load: prefer native, fall back to JS.
+const _xxHash32Impl = typeof native.xxHash32 === "function"
+    ? (input, seed) => native.xxHash32(input, seed)
+    : xxHash32JS;
 /**
  * Compute xxHash32 of a UTF-8 string.
  *
+ * Uses the native Rust implementation when available; falls back to a
+ * pure-JS implementation if the loaded native addon does not export
+ * `xxHash32` (e.g. an older build).
+ *
  * @param input  The string to hash (encoded as UTF-8 internally).
  * @param seed   32-bit seed value.
  * @returns      32-bit unsigned hash.
  */
 export function xxHash32(input, seed) {
-    return native.xxHash32(input, seed);
+    return _xxHash32Impl(input, seed);
 }

package/node_modules/@gsd/pi-agent-core/dist/agent-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGN,WAAW,EAIX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,EAGZ,QAAQ,EACR,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,SAAS,CACxB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GACjB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CAqBzC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GACjB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CAsBzC"}
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGN,WAAW,EAIX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,EAGZ,QAAQ,EACR,MAAM,YAAY,CAAC;AA8BpB;;;GAGG;AACH,wBAAgB,SAAS,CACxB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GACjB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CA8BzC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GACjB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CA+BzC"}

package/node_modules/@gsd/pi-agent-core/dist/agent-loop.js

@@ -3,6 +3,32 @@
  * Transforms to Message[] only at the LLM call boundary.
  */
 import { EventStream, streamSimple, validateToolArguments, } from "@gsd/pi-ai";
+const ZERO_USAGE = {
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    totalTokens: 0,
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+};
+/**
+ * Build an AssistantMessage for an unhandled error caught outside runLoop.
+ * Uses the model from config so the message satisfies the full interface.
+ */
+function createErrorMessage(error, config) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return {
+        role: "assistant",
+        content: [{ type: "text", text: msg }],
+        api: config.model.api,
+        provider: config.model.provider,
+        model: config.model.id,
+        usage: ZERO_USAGE,
+        stopReason: "error",
+        errorMessage: msg,
+        timestamp: Date.now(),
+    };
+}
 /**
  * Start an agent loop with a new prompt message.
  * The prompt is added to the context and events are emitted for it.
@@ -21,7 +47,17 @@ export function agentLoop(prompts, context, config, signal, streamFn) {
             stream.push({ type: "message_start", message: prompt });
             stream.push({ type: "message_end", message: prompt });
         }
-        await runLoop(currentContext, newMessages, config, signal, stream, streamFn);
+        try {
+            await runLoop(currentContext, newMessages, config, signal, stream, streamFn);
+        }
+        catch (error) {
+            const errMsg = createErrorMessage(error, config);
+            stream.push({ type: "message_start", message: errMsg });
+            stream.push({ type: "message_end", message: errMsg });
+            stream.push({ type: "turn_end", message: errMsg, toolResults: [] });
+            stream.push({ type: "agent_end", messages: [...newMessages, errMsg] });
+            stream.end([...newMessages, errMsg]);
+        }
     })();
     return stream;
 }
@@ -46,7 +82,17 @@ export function agentLoopContinue(context, config, signal, streamFn) {
         const currentContext = { ...context };
         stream.push({ type: "agent_start" });
         stream.push({ type: "turn_start" });
-        await runLoop(currentContext, newMessages, config, signal, stream, streamFn);
+        try {
+            await runLoop(currentContext, newMessages, config, signal, stream, streamFn);
+        }
+        catch (error) {
+            const errMsg = createErrorMessage(error, config);
+            stream.push({ type: "message_start", message: errMsg });
+            stream.push({ type: "message_end", message: errMsg });
+            stream.push({ type: "turn_end", message: errMsg, toolResults: [] });
+            stream.push({ type: "agent_end", messages: [...newMessages, errMsg] });
+            stream.end([...newMessages, errMsg]);
+        }
     })();
     return stream;
 }
@@ -83,7 +129,37 @@ async function runLoop(currentContext, newMessages, config, signal, stream, stre
                 pendingMessages = [];
             }
             // Stream assistant response
-            const message = await streamAssistantResponse(currentContext, config, signal, stream, streamFn);
+            let message;
+            try {
+                message = await streamAssistantResponse(currentContext, config, signal, stream, streamFn);
+            }
+            catch (error) {
+                // Critical failure before stream started (e.g. getApiKey threw, credentials in
+                // backoff, network unavailable). Convert to a graceful error message so the
+                // agent loop can end cleanly instead of crashing with an unhandled rejection.
+                const errorText = error instanceof Error ? error.message : String(error);
+                message = {
+                    role: "assistant",
+                    content: [],
+                    api: config.model.api,
+                    provider: config.model.provider,
+                    model: config.model.id,
+                    usage: {
+                        input: 0,
+                        output: 0,
+                        cacheRead: 0,
+                        cacheWrite: 0,
+                        totalTokens: 0,
+                        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+                    },
+                    stopReason: signal?.aborted ? "aborted" : "error",
+                    errorMessage: errorText,
+                    timestamp: Date.now(),
+                };
+                stream.push({ type: "message_start", message: { ...message } });
+                stream.push({ type: "message_end", message });
+                currentContext.messages.push(message);
+            }
             newMessages.push(message);
             if (message.stopReason === "error" || message.stopReason === "aborted") {
                 stream.push({ type: "turn_end", message, toolResults: [] });