@johnnygreco/pizza-pi 0.1.1

package/node_modules/pi-interactive-subagents/.pi/settings.json

@@ -0,0 +1,13 @@
+{
+  "packages": [
+    {
+      "source": "git:github.com/HazAT/pi-interactive-subagents",
+      "extensions": [],
+      "skills": []
+    }
+  ],
+  "extensions": [
+    "../pi-extension/subagents/index.ts",
+    "../pi-extension/session-artifacts/index.ts"
+  ]
+}

package/node_modules/pi-interactive-subagents/.pi/skills/release/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: release
+description: Create a GitHub release with changelog. Use when asked to "release", "cut a release", "publish version", "bump version", "create release".
+---
+
+# Release
+
+Create a versioned GitHub release with an auto-generated changelog from commits since the last release.
+
+## Step 1: Determine Version
+
+Check the current version and latest git tag:
+
+```bash
+cat package.json | grep '"version"'
+git tag -l --sort=-v:refname | head -5
+```
+
+If the user provided a version, use it. Otherwise ask:
+
+> What version? (current is X.Y.Z — patch/minor/major, or exact version)
+
+Resolve semver:
+- `patch` → X.Y.(Z+1)
+- `minor` → X.(Y+1).0
+- `major` → (X+1).0.0
+- Exact version string → use as-is
+
+## Step 2: Generate Changelog
+
+Get commits since the last tag (or all commits if no tags exist):
+
+```bash
+# If tags exist:
+git log $(git tag -l --sort=-v:refname | head -1)..HEAD --pretty=format:"- %s" --no-merges
+
+# If no tags:
+git log --pretty=format:"- %s" --no-merges
+```
+
+Group commits by type using conventional commit prefixes:
+
+| Prefix | Section |
+|--------|---------|
+| `feat` | ✨ Features |
+| `fix` | 🐛 Bug Fixes |
+| `refactor` | ♻️ Refactoring |
+| `docs` | 📝 Documentation |
+| `chore`, `test`, `perf`, `ci` | 🔧 Other Changes |
+| No prefix | 🔧 Other Changes |
+
+Format as markdown. Omit empty sections. Strip the `type(scope):` prefix from each line for readability.
+
+**Always start the changelog with this install block** (hardcoded):
+
+````markdown
+Install:
+
+```bash
+pi install git:github.com/HazAT/pi-interactive-subagents@v<VERSION>
+```
+
+Or latest:
+
+```bash
+pi install git:github.com/HazAT/pi-interactive-subagents
+```
+````
+
+Then add the grouped commit sections below it.
+
+Example output:
+
+```markdown
+## ✨ Features
+
+- Add live subagent status widget
+- Make subagent tool async — return immediately, steer on completion
+
+## 🐛 Bug Fixes
+
+- Fix session file collision with 3+ concurrent agents
+- Truncate widget lines to terminal width
+```
+
+## Step 3: Update package.json
+
+Bump the version in `package.json`:
+
+```bash
+# Read, update, write back — don't use npm version (it may auto-commit)
+```
+
+Use a precise edit to change only the version field.
+
+## Step 4: Commit, Tag, Push
+
+```bash
+git add package.json
+git commit -m "chore(release): v<VERSION>"
+git tag v<VERSION>
+git push && git push --tags
+```
+
+## Step 5: Create GitHub Release
+
+```bash
+gh release create v<VERSION> --title "v<VERSION>" --notes "<CHANGELOG>"
+```
+
+Pass the generated changelog as the `--notes` value. Use a temp file if the changelog is long:
+
+```bash
+echo "<CHANGELOG>" > /tmp/release-notes.md
+gh release create v<VERSION> --title "v<VERSION>" --notes-file /tmp/release-notes.md
+rm /tmp/release-notes.md
+```
+
+## Step 6: Verify
+
+Confirm the release was created:
+
+```bash
+gh release view v<VERSION>
+```
+
+Print a summary:
+
+```
+✅ Released v<VERSION>
+   Tag: v<VERSION>
+   URL: https://github.com/<owner>/<repo>/releases/tag/v<VERSION>
+```

package/node_modules/pi-interactive-subagents/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HazAT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/node_modules/pi-interactive-subagents/README.md

@@ -0,0 +1,362 @@
+# pi-interactive-subagents
+
+Async subagents for [pi](https://github.com/badlogic/pi-mono) — spawn, orchestrate, and manage sub-agent sessions in multiplexer panes. **Fully non-blocking** — the main agent keeps working while subagents run in the background.
+
+https://github.com/user-attachments/assets/30adb156-cfb4-4c47-84ca-dd4aa80cba9f
+
+## How It Works
+
+Call `subagent()` and it **returns immediately**. The sub-agent runs in its own terminal pane. A live widget above the input shows all running agents with elapsed time and progress. When a sub-agent finishes, its result is **steered back** into the main session as an async notification — triggering a new turn so the agent can process it.
+
+```
+╭─ Subagents ──────────────────────── 2 running ─╮
+│ 00:23  Scout: Auth (scout)    8 msgs (5.1KB)   │
+│ 00:45  Scout: DB (scout)     12 msgs (9.3KB)   │
+╰─────────────────────────────────────────────────╯
+```
+
+For parallel execution, just call `subagent` multiple times — they all run concurrently:
+
+```typescript
+subagent({ name: "Scout: Auth", agent: "scout", task: "Analyze auth module" });
+subagent({ name: "Scout: DB", agent: "scout", task: "Map database schema" });
+// Both return immediately, results steer back independently
+```
+
+## Install
+
+```bash
+pi install git:github.com/HazAT/pi-interactive-subagents
+```
+
+Supported multiplexers:
+
+- [cmux](https://github.com/manaflow-ai/cmux)
+- [tmux](https://github.com/tmux/tmux)
+- [zellij](https://zellij.dev)
+- [WezTerm](https://wezfurlong.org/wezterm/) (terminal emulator with built-in multiplexing)
+
+Start pi inside one of them:
+
+```bash
+cmux pi
+# or
+tmux new -A -s pi 'pi'
+# or
+zellij --session pi   # then run: pi
+# or
+# just run pi inside WezTerm — no wrapper needed
+```
+
+Optional: set `PI_SUBAGENT_MUX=cmux|tmux|zellij|wezterm` to force a specific backend.
+
+## What's Included
+
+### Extensions
+
+**Subagents** — 4 tools + 3 commands:
+
+| Tool              | Description                                                                     |
+| ----------------- | ------------------------------------------------------------------------------- |
+| `subagent`        | Spawn a sub-agent in a dedicated multiplexer pane (async — returns immediately) |
+| `subagents_list`  | List available agent definitions                                                |
+| `set_tab_title`   | Update tab/window title to show progress                                        |
+| `subagent_resume` | Resume a previous sub-agent session (async)                                     |
+
+| Command                    | Description                          |
+| -------------------------- | ------------------------------------ |
+| `/plan`                    | Start a full planning workflow       |
+| `/iterate`                 | Fork into a subagent for quick fixes |
+| `/subagent <agent> <task>` | Spawn a named agent directly         |
+
+**Session Artifacts** — 2 tools for session-scoped file storage:
+
+| Tool             | Description                                               |
+| ---------------- | --------------------------------------------------------- |
+| `write_artifact` | Write plans, context, notes to a session-scoped directory |
+| `read_artifact`  | Read artifacts from current or previous sessions          |
+
+### Bundled Agents
+
+| Agent             | Model                  | Role                                                                                     |
+| ----------------- | ---------------------- | ---------------------------------------------------------------------------------------- |
+| **planner**       | Opus (medium thinking) | Brainstorming — clarifies requirements, explores approaches, writes plans, creates todos |
+| **scout**         | Haiku                  | Fast codebase reconnaissance — maps files, patterns, conventions                         |
+| **worker**        | Sonnet                 | Implements tasks from todos — writes code, runs tests, makes polished commits            |
+| **reviewer**      | Opus (medium thinking) | Reviews code for bugs, security issues, correctness                                      |
+| **visual-tester** | Sonnet                 | Visual QA via Chrome CDP — screenshots, responsive testing, interaction testing          |
+
+Agent discovery follows priority: **project-local** (`.pi/agents/`) > **global** (`~/.pi/agent/agents/`) > **package-bundled**. Override any bundled agent by placing your own version in the higher-priority location.
+
+---
+
+## Async Subagent Flow
+
+```
+1. Agent calls subagent()         → returns immediately ("started")
+2. Sub-agent runs in mux pane     → widget shows live progress
+3. User keeps chatting             → main session fully interactive
+4. Sub-agent finishes              → result steered back as interrupt
+5. Main agent processes result     → continues with new context
+```
+
+Multiple subagents run concurrently — each steers its result back independently as it finishes. The live widget above the input tracks all running agents:
+
+```
+╭─ Subagents ──────────────────────── 3 running ─╮
+│ 01:23  Scout: Auth (scout)      15 msgs (12KB) │
+│ 00:45  Researcher (researcher)   8 msgs (6KB)  │
+│ 00:12  Scout: DB (scout)             starting…  │
+╰─────────────────────────────────────────────────╯
+```
+
+Completion messages render with a colored background and are expandable with `Ctrl+O` to show the full summary and session file path.
+
+---
+
+## Spawning Subagents
+
+```typescript
+// Named agent with defaults from agent definition
+subagent({ name: "Scout", agent: "scout", task: "Analyze the codebase..." });
+
+// Fork — sub-agent gets full conversation context
+subagent({ name: "Iterate", fork: true, task: "Fix the bug where..." });
+
+// Override agent defaults
+subagent({
+  name: "Worker",
+  agent: "worker",
+  model: "anthropic/claude-haiku-4-5",
+  task: "Quick fix...",
+});
+
+// Custom working directory
+subagent({ name: "Designer", agent: "game-designer", cwd: "agents/game-designer", task: "..." });
+```
+
+### Parameters
+
+| Parameter      | Type    | Default  | Description                                                             |
+| -------------- | ------- | -------- | ----------------------------------------------------------------------- |
+| `name`         | string  | required | Display name (shown in widget and pane title)                           |
+| `task`         | string  | required | Task prompt for the sub-agent                                           |
+| `agent`        | string  | —        | Load defaults from agent definition                                     |
+| `fork`         | boolean | `false`  | Copy current session for full context                                   |
+| `model`        | string  | —        | Override agent's default model                                          |
+| `systemPrompt` | string  | —        | Append to system prompt                                                 |
+| `skills`       | string  | —        | Comma-separated skill names                                             |
+| `tools`        | string  | —        | Comma-separated tool names                                              |
+| `cwd`          | string  | —        | Working directory for the sub-agent (see [Role Folders](#role-folders)) |
+
+---
+
+## The `/plan` Workflow
+
+The `/plan` command orchestrates a full planning-to-implementation pipeline.
+
+```
+/plan Add a dark mode toggle to the settings page
+```
+
+```
+Phase 1: Investigation    → Quick codebase scan
+Phase 2: Planning         → Interactive planner subagent (user collaborates)
+Phase 3: Review Plan      → Confirm todos, adjust if needed
+Phase 4: Execute          → Scout + sequential workers implement todos
+Phase 5: Review           → Reviewer subagent checks all changes
+```
+
+Tab/window titles update to show current phase:
+
+```
+🔍 Investigating: dark mode → 💬 Planning: dark mode
+→ 🔨 Executing: 1/3 → 🔎 Reviewing → ✅ Done
+```
+
+---
+
+## The `/iterate` Workflow
+
+For quick, focused work without polluting the main session's context.
+
+```
+/iterate Fix the off-by-one error in the pagination logic
+```
+
+This forks the current session into a subagent with full conversation context. Make the fix, verify it, and exit to return. The main session gets a summary of what was done.
+
+---
+
+## Custom Agents
+
+Place a `.md` file in `.pi/agents/` (project) or `~/.pi/agent/agents/` (global):
+
+```markdown
+---
+name: my-agent
+description: Does something specific
+model: anthropic/claude-sonnet-4-6
+thinking: minimal
+tools: read, bash, edit, write
+spawning: false
+---
+
+# My Agent
+
+You are a specialized agent that does X...
+```
+
+### Frontmatter Reference
+
+| Field         | Type    | Description                                                                                                                                                                                                                                                                 |
+| ------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `name`        | string  | Agent name (used in `agent: "my-agent"`)                                                                                                                                                                                                                                    |
+| `description` | string  | Shown in `subagents_list` output                                                                                                                                                                                                                                            |
+| `model`       | string  | Default model (e.g. `anthropic/claude-sonnet-4-6`)                                                                                                                                                                                                                          |
+| `thinking`    | string  | Thinking level: `minimal`, `medium`, `high`                                                                                                                                                                                                                                 |
+| `tools`       | string  | Comma-separated **native pi tools only**: `read`, `bash`, `edit`, `write`, `grep`, `find`, `ls`                                                                                                                                                                             |
+| `skills`      | string  | Comma-separated skill names to auto-load                                                                                                                                                                                                                                    |
+| `spawning`    | boolean | Set `false` to deny all subagent-spawning tools                                                                                                                                                                                                                             |
+| `deny-tools`  | string  | Comma-separated extension tool names to deny                                                                                                                                                                                                                                |
+| `auto-exit`   | boolean | Auto-shutdown when the agent finishes its turn — no `subagent_done` call needed. If the user sends any input, auto-exit is permanently disabled and the user takes over the session. Recommended for autonomous agents (scout, worker); not for interactive ones (planner). |
+| `cwd`         | string  | Default working directory (absolute or relative to project root)                                                                                                                                                                                                            |
+
+---
+
+### `auto-exit`
+
+When set to `true`, the agent session shuts down automatically as soon as the agent finishes its turn — no explicit `subagent_done` call is needed.
+
+**Behavior:**
+
+- The session closes after the agent's final message (on the `agent_end` event)
+- If the user sends **any input** before the agent finishes, auto-exit is permanently disabled for that session — the user takes over interactively
+- The modeHint injected into the agent's task is adjusted accordingly: autonomous agents see "Complete your task autonomously." rather than instructions to call `subagent_done`
+
+**When to use:**
+
+- ✅ Autonomous agents (scout, worker, reviewer) that run to completion
+- ❌ Interactive agents (planner, iterate) where the user drives the session
+
+```yaml
+---
+name: scout
+auto-exit: true
+---
+```
+
+---
+
+## Tool Access Control
+
+By default, every sub-agent can spawn further sub-agents. Control this with frontmatter:
+
+### `spawning: false`
+
+Denies all spawning tools (`subagent`, `subagents_list`, `subagent_resume`):
+
+```yaml
+---
+name: worker
+spawning: false
+---
+```
+
+### `deny-tools`
+
+Fine-grained control over individual extension tools:
+
+```yaml
+---
+name: focused-agent
+deny-tools: subagent, set_tab_title
+---
+```
+
+### Recommended Configuration
+
+| Agent      | `spawning`  | Rationale                                    |
+| ---------- | ----------- | -------------------------------------------- |
+| planner    | _(default)_ | Legitimately spawns scouts for investigation |
+| worker     | `false`     | Should implement tasks, not delegate         |
+| researcher | `false`     | Should research, not spawn                   |
+| reviewer   | `false`     | Should review, not spawn                     |
+| scout      | `false`     | Should gather context, not spawn             |
+
+---
+
+## Role Folders
+
+The `cwd` parameter lets sub-agents start in a specific directory with its own configuration:
+
+```
+project/
+├── agents/
+│   ├── game-designer/
+│   │   └── CLAUDE.md          ← "You are a game designer..."
+│   ├── sre/
+│   │   ├── CLAUDE.md          ← "You are an SRE specialist..."
+│   │   └── .pi/skills/        ← SRE-specific skills
+│   └── narrative/
+│       └── CLAUDE.md          ← "You are a narrative designer..."
+```
+
+```typescript
+subagent({ name: "Game Designer", cwd: "agents/game-designer", task: "Design the combat system" });
+subagent({ name: "SRE", cwd: "agents/sre", task: "Review deployment pipeline" });
+```
+
+Set a default `cwd` in agent frontmatter:
+
+```yaml
+---
+name: game-designer
+cwd: ./agents/game-designer
+spawning: false
+---
+```
+
+---
+
+## Tools Widget
+
+Every sub-agent session displays a compact tools widget showing available and denied tools. Toggle with `Ctrl+J`:
+
+```
+[scout] — 12 tools · 4 denied  (Ctrl+J)              ← collapsed
+[scout] — 12 available  (Ctrl+J to collapse)          ← expanded
+  read, bash, edit, write, todo, ...
+  denied: subagent, subagents_list, ...
+```
+
+---
+
+## Requirements
+
+- [pi](https://github.com/badlogic/pi-mono) — the coding agent
+- One supported multiplexer:
+  - [cmux](https://github.com/manaflow-ai/cmux)
+  - [tmux](https://github.com/tmux/tmux)
+  - [zellij](https://zellij.dev)
+  - [WezTerm](https://wezfurlong.org/wezterm/)
+
+```bash
+cmux pi
+# or
+tmux new -A -s pi 'pi'
+# or
+zellij --session pi   # then run: pi
+# or
+# just run pi inside WezTerm
+```
+
+Optional backend override:
+
+```bash
+export PI_SUBAGENT_MUX=cmux   # or tmux, zellij, wezterm
+```
+
+## License
+
+MIT