@inneranimalmedia/agentsam-sdk 1.1.1 → 1.2.0

package/DEVELOPMENT.md

@@ -51,5 +51,8 @@ npx agentsam init \
 ## Known gaps (roadmap)
 
 - `agentsam deploy`, `status`, `logs` — not implemented yet
-- CMS lane in README — CLI has 4 lanes today (Full Stack, Data, CRM, Creative)
+- Gorilla Shell Phase 1 — PTY WebSocket bridge to ExecOS
+- CMS lane in README — CLI has 5 lanes (Full Stack, CMS, Data, CRM, Creative)
 - Published API route may differ; stub mode works without `AGENTSAM_API_KEY`
+
+See [docs/CLI_SHELL.md](./docs/CLI_SHELL.md) for the game-feel terminal UX path.

package/README.md

@@ -4,6 +4,8 @@
 
 Agent Sam is a full-stack autonomous agent SDK built on Cloudflare Workers, D1, Supabase, Durable Objects, and MCP — designed to converse, plan, and execute real work across your entire stack. CMS websites, full-stack applications, data pipelines, creative workflows, terminal execution, deployments, and multi-step agentic pipelines — all through one unified agent interface.
 
+**Repo:** [github.com/SamPrimeaux/agentsam-sdk](https://github.com/SamPrimeaux/agentsam-sdk) · **npm:** `@inneranimalmedia/agentsam-sdk`
+
 ---
 
 ## What is Agent Sam?
@@ -22,32 +24,54 @@ It is not a wrapper around a chat API. It is a command fabric with a conversatio
 
 ## Quickstart
 
-\`\`\`bash
+```bash
 npx @inneranimalmedia/agentsam-sdk init
-\`\`\`
+```
 
 Non-interactive (CI / scripts):
 
-\`\`\`bash
-npx @inneranimalmedia/agentsam-sdk init \\
-  --name my-agent \\
-  --lane fullstack \\
-  --provider cloudflare \\
-  --agent orchestrator \\
+```bash
+npx @inneranimalmedia/agentsam-sdk init \
+  --name my-agent \
+  --lane fullstack \
+  --provider cloudflare \
+  --agent orchestrator \
   --yes
-\`\`\`
+```
 
-Scaffolded workers expose \`GET /health\` and \`POST /chat\` immediately (stub mode without an API key).
+Scaffolded workers expose `GET /health` and `POST /chat` immediately (stub mode without an API key).
 
 See [DEVELOPMENT.md](./DEVELOPMENT.md) for linking the SDK into Inner Animal Media locally.
 
 ---
 
+## CLI Shell Experience (Gorilla)
+
+The SDK ships a **game-feel terminal UX** alongside the scaffold CLI — consolidated from the Gorilla Mode experiment:
+
+```bash
+npx @inneranimalmedia/agentsam-sdk shell
+```
+
+| Piece | Location |
+|-------|----------|
+| Slash command registry | `src/lib/slash-commands.js` |
+| Phase 0 visual prototype | `examples/gorilla-shell/` |
+| Architecture + phases | [docs/CLI_SHELL.md](./docs/CLI_SHELL.md) |
+
+Run the prototype:
+
+```bash
+cd examples/gorilla-shell && npm install && npm run dev
+```
+
+---
+
 ## Installation
 
-\`\`\`bash
+```bash
 npm install @inneranimalmedia/agentsam-sdk
-\`\`\`
+```
 
 ---
 
@@ -77,7 +101,7 @@ npm install @inneranimalmedia/agentsam-sdk
 
 ## How It Works
 
-\`\`\`
+```
 User Intent (chat or CLI)
         ↓
    Agent Sam — intent classification + command match
@@ -87,7 +111,7 @@ User Intent (chat or CLI)
    Execution — terminal / D1 / Supabase / R2 / KV / DO / browser / deploy / MCP
         ↓
    Telemetry — every action logged, measured, improvable
-\`\`\`
+```
 
 Capabilities are data-driven — new tools are added via D1, not Worker redeployments. The same tool catalog powers the dashboard, the CLI, and any MCP-connected client like Cursor or Claude Desktop.
 
@@ -125,35 +149,25 @@ Agent Sam routes work to the right environment automatically:
 
 ## What Gets Scaffolded
 
-Running \`agentsam init\` generates a production-ready project for your lane:
+Running `agentsam init` generates a production-ready project for your lane:
 
 **All lanes include:**
-- \`agentsam.config.js\` — project config, lane, provider, agent
-- \`wrangler.toml\` — Worker, D1, R2, KV, Durable Object bindings
-- \`.env.example\` — all required secrets pre-listed
-- \`src/index.js\` — Worker entry point wired to your agent
-- \`README.md\` — setup and deploy instructions
-
-**CMS lane adds:**
-- Page, section, asset, and theme schema migrations
-- CMS worker with live edit, draft/publish, and R2 asset pipeline
-
-**Data lane adds:**
-- D1 + Supabase Hyperdrive connection config
-- Vector embedding pipeline scaffold
-- Migration templates for core data models
-
-**Full Stack adds:**
-- Durable Object session scaffold
-- Auth tables and session management
-- Full agent chat + tool loop worker
+- `agentsam.config.js` — project config, lane, provider, agent
+- `wrangler.toml` — Worker, D1, R2, KV, Durable Object bindings
+- `.env.example` — all required secrets pre-listed
+- `src/index.js` — Worker entry point wired to your agent
+- `README.md` — setup and deploy instructions
+
+**CMS lane adds:** page/section/asset schema migrations and CMS worker scaffold.
+
+**Data lane adds:** D1 + Hyperdrive config and migration templates.
+
+**Full Stack adds:** Durable Object session scaffold, auth tables, full agent chat loop.
 
 ---
 
 ## Multi-Tenant & Client Policy
 
-Agent Sam is built for isolation from the ground up:
-
 - Each user or client gets a scoped workspace
 - Terminal execution is path-isolated — no cross-tenant access
 - AI usage is policy-gated — BYOK, managed, or disabled per client
@@ -164,10 +178,12 @@ Agent Sam is built for isolation from the ground up:
 
 ## Roadmap
 
-- [ ] \`agentsam deploy\` — push your project from CLI
-- [ ] \`agentsam status\` — live agent and infrastructure health
-- [ ] \`agentsam logs\` — tail tool call and command logs
-- [ ] \`agentsam kit\` — install pre-built capability kits
+- [x] `agentsam shell` — shell UX info + slash command registry
+- [x] Gorilla Shell Phase 0 prototype in `examples/gorilla-shell/`
+- [ ] `agentsam deploy` — push your project from CLI
+- [ ] `agentsam status` — live agent and infrastructure health
+- [ ] `agentsam logs` — tail tool call and command logs
+- [ ] PTY bridge (Phase 1) — ExecOS WebSocket in shell
 - [ ] Kit marketplace — CMS, ecommerce, nonprofit, SaaS starters
 - [ ] BYOK AI key support per project
 
@@ -175,7 +191,9 @@ Agent Sam is built for isolation from the ground up:
 
 ## Built By
 
-[Inner Animal Media](https://inneranimalmedia.com) — Agent Sam is the operator brain behind the Inner Animal Media platform. The SDK is how we share that infrastructure with other developers.
+[Inner Animal Media](https://inneranimalmedia.com) — Agent Sam is the operator brain behind the platform. The SDK is how we productize that infrastructure for other developers.
+
+**Legacy:** [InnerAnimal/gorilla-mode](https://github.com/InnerAnimal/gorilla-mode) → consolidated here.
 
 ---
 

package/docs/CLI_SHELL.md

@@ -0,0 +1,90 @@
+# Agent Sam SDK — CLI Shell Experience
+
+The SDK ships two complementary surfaces:
+
+1. **`agentsam init`** — scaffold Workers + D1 + agent loop (resell/scale path)
+2. **Gorilla Shell** (`examples/gorilla-shell/`) — game-feel terminal UX layer (unique install experience)
+
+Gorilla Mode was consolidated from the standalone [InnerAnimal/gorilla-mode](https://github.com/InnerAnimal/gorilla-mode) experiment into this repo. **Do not start new work in gorilla-mode** — extend here.
+
+---
+
+## Why a game shell?
+
+Developers installing `@inneranimalmedia/agentsam-sdk` get:
+
+- Efficient tooling (`init`, future `deploy` / `status` / `logs`)
+- A **memorable CLI identity** — pixel HUD, slash commands, themed moods, deploy reactions
+
+The shell is not a toy terminal emulator. It is a **presentation layer** on real PTY + MCP + D1 tool execution — the same stack IAM runs in production.
+
+---
+
+## Architecture
+
+```
+User
+  └─ agentsam shell (CLI) or embedded <AgentSamShell />
+       └─ Gorilla HUD (themes, sprite, quest log)
+            └─ xterm.js ↔ ExecOS / iam-pty WebSocket
+                 └─ Slash commands → SDK router → MCP / wrangler / D1
+```
+
+| Layer | Location in SDK |
+|-------|-----------------|
+| Slash command registry | `src/lib/slash-commands.js` |
+| Phase 0 visual prototype | `examples/gorilla-shell/App.tsx` |
+| Scaffold + Worker agent | `src/lib/scaffold.js`, `src/AgentSam.js` |
+| Future PTY bridge | `src/lib/shell/` (Phase 1) |
+
+---
+
+## Phases
+
+See `SHELL_PHASES` in `src/lib/slash-commands.js`. Current status:
+
+| Phase | Status |
+|-------|--------|
+| 0 — Visual prototype | **Complete** (demo scenarios, themes, sprite) |
+| 1 — Real PTY | **Next** — wire to ExecOS / `terminal.inneranimalmedia.com` |
+| 2 — HUD (quest log, tool gate, XP) | Planned |
+| 3 — Buddy (`/buddy`, MCP stream) | Planned |
+| 4 — Dashboard embed | Planned |
+| 5 — Standalone PWA as SDK default | Planned |
+
+---
+
+## Run the prototype
+
+```bash
+cd examples/gorilla-shell
+npm install
+npm run dev
+```
+
+Deploy preview (Cloudflare Pages):
+
+```bash
+npm run build
+npx wrangler pages deploy dist
+```
+
+---
+
+## Platform linkage (IAM)
+
+| Shell feature | IAM SSOT |
+|---------------|----------|
+| PTY sessions | `terminal_connections` + ExecOS |
+| Tool execution | `agentsam_tools` → catalog executor |
+| Buddy / MCP | `mcp.inneranimalmedia.com` |
+| XP (future) | `gorilla_xp` D1 table |
+| Themes (future) | user preferences / `cms_themes` pattern |
+
+---
+
+## Repo history
+
+- **Before:** `InnerAnimal/gorilla-mode` (Phase 0 only, single-file React artifact)
+- **Now:** `SamPrimeaux/agentsam-sdk/examples/gorilla-shell`
+- **D1 project:** `proj_agentsam_sdk` (replaces `proj_gorilla_mode` on the IAM projects grid)

package/examples/gorilla-shell/App.tsx

@@ -0,0 +1,540 @@
+import { useState, useEffect, useRef, useMemo, useCallback } from "react";
+
+const PS = 5;
+const PAL = ['transparent','#060e1a','#0f2040','#1a3568','#6a6a90','#9898b8','#2a1006','#8a5830','#ff1a1a','#ffd88a','#0e0400','#ffffff','#ffd700','#ffaa00','#ff6600','#ff2200','#9B6E14','#6B4808','#3a2604','#c09030','#ffee44','#cc8800','#44ff88','#ff4444'];
+
+const GORILLA = [
+[0,0,0,2,2,2,2,2,2,2,2,2,2,2,0,0,0,0],
+[0,0,2,3,3,3,3,3,3,3,3,3,3,2,2,0,0,0],
+[0,2,2,3,3,3,3,3,3,3,3,3,3,3,2,2,0,0],
+[0,2,3,3,7,7,3,3,3,7,7,3,3,3,2,0,0,0],
+[2,2,3,7,7,8,7,3,3,7,8,7,7,3,3,2,2,0],
+[2,2,3,7,7,7,7,7,7,7,7,7,7,3,3,2,2,0],
+[2,3,3,7,6,10,6,7,7,6,10,6,7,3,3,3,2,0],
+[2,3,3,7,7,7,9,9,9,9,7,7,7,3,3,3,2,0],
+[0,2,3,3,3,3,3,3,3,3,3,3,3,3,3,2,0,0],
+[0,2,2,3,4,4,4,4,4,4,4,4,4,3,2,2,0,0],
+[2,2,2,3,4,5,5,5,5,5,5,5,4,3,3,2,2,2],
+[2,3,2,3,4,5,5,5,5,5,5,5,4,3,2,3,2,2],
+[2,3,3,3,3,4,4,5,5,4,4,3,3,3,3,3,2,0],
+[0,2,3,3,3,3,3,3,3,3,3,3,3,3,2,2,0,0],
+[0,0,2,3,3,3,3,3,3,3,3,3,3,2,2,0,0,0],
+[0,0,2,2,3,3,3,3,3,3,3,3,2,2,0,0,0,0],
+[0,0,0,2,2,3,3,0,0,3,3,2,2,0,0,0,0,0],
+[0,0,0,2,2,2,2,0,0,2,2,2,2,0,0,0,0,0],
+[0,0,0,0,2,2,2,0,0,2,2,2,0,0,0,0,0,0],
+[0,0,0,0,2,3,2,0,0,2,3,2,0,0,0,0,0,0],
+];
+const GORILLA_PUMP = GORILLA.map((r,i) => {
+if (i===8)  return [2,2,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,0];
+if (i===9)  return [2,2,3,4,5,5,5,5,5,5,5,5,5,4,3,2,2,0];
+if (i===10) return [0,2,3,4,5,5,5,5,5,5,5,5,5,4,3,2,0,0];
+if (i===11) return [0,2,3,3,4,5,5,5,5,5,5,5,4,3,3,2,0,0];
+return r;
+});
+
+const COIN = [[0,12,12,12,12,12,0],[12,20,20,20,20,20,12],[12,20,12,20,12,20,12],[12,20,20,20,20,20,12],[0,12,12,12,12,12,0],[0,0,21,21,0,0,0]];
+const FLAME_FRAMES = [
+[[0,0,14,0,0],[0,14,15,14,0],[14,15,13,14,0],[14,13,20,14,0],[0,14,13,14,0],[0,13,14,13,0]],
+[[0,14,0,14,0],[14,15,14,0,0],[14,13,15,14,0],[0,14,13,14,0],[0,13,14,0,0],[0,14,13,0,0]],
+[[0,14,14,0,0],[0,14,15,14,0],[14,15,13,15,0],[14,13,14,13,0],[0,14,13,14,0],[0,0,14,13,0]],
+];
+
+const THEMES = {
+NIGHT: { bg:'#030a14', panel:'rgba(4,12,26,.97)', accent:'#00e5ff', dim:'#00e5ff22', glow:'0 0 14px #00e5ff55', border:'#00e5ff33' },
+DAY:   { bg:'#071a0a', panel:'rgba(6,20,10,.97)', accent:'#44ff88', dim:'#44ff8822', glow:'0 0 14px #44ff8855', border:'#44ff8833' },
+LAVA:  { bg:'#0e0003', panel:'rgba(18,2,4,.97)',  accent:'#ff4400', dim:'#ff440022', glow:'0 0 14px #ff440055', border:'#ff440033' },
+VOID:  { bg:'#06001a', panel:'rgba(8,2,28,.97)',  accent:'#aa44ff', dim:'#aa44ff22', glow:'0 0 14px #aa44ff55', border:'#aa44ff33' },
+};
+const TKEYS = Object.keys(THEMES);
+
+// ── Line colors ───────────────────────────────────────────────────────────────
+const LC = {
+cmd:     '#00e5ff',
+success: '#44ff88',
+error:   '#ff4444',
+warn:    '#ffcc00',
+info:    '#88bbff',
+muted:   'rgba(255,255,255,.45)',
+dim:     'rgba(255,255,255,.18)',
+white:   'rgba(255,255,255,.9)',
+sam:     '#cc88ff',
+table:   '#ffdd88',
+pass:    '#44ff88',
+fail:    '#ff4444',
+accent:  '#00e5ff',
+};
+
+// ── Scenario Builders ─────────────────────────────────────────────────────────
+const BENCH_TESTS = [
+['health_check',13],['auth_superadmin',8],['auth_regular',9],['d1_query_basic',45],
+['d1_query_join',67],['d1_write_record',38],['mcp_tool_routing',23],['mcp_auth_bearer',11],
+['mcp_audit_log',19],['agent_context_load',88],['r2_upload_asset',54],['r2_fetch_asset',31],
+['kv_read_hit',7],['kv_write_ttl',14],['queue_publish',28],['worker_ai_t0',112],
+['gemini_flash_lite',189],['haiku_route',145],['sonnet_route',234],['budget_check',6],
+['cicd_sandbox_gate',17],['cicd_benchmark_gate',22],['deploy_record_insert',33],
+['workspace_switch',12],['terminal_session_resume',19],['rag_cosine_query',78],
+['tool_intent_match',15],['client_workflow_run',44],['project_context_load',29],
+['skill_lookup',11],['cicd_pipeline_e2e',156],
+];
+
+function buildDeploy() {
+let d = 0; const L = (text, color, gap=120) => { d+=gap; return {text,color,delay:d}; };
+return [
+L('gorilla@inneranimal ~ % /deploy sandbox','cmd',0),
+L('','dim',60),
+L('  ./scripts/with-cloudflare-env.sh npx wrangler deploy','muted',80),
+L('  –config wrangler.sandbox.toml','muted',40),
+L('','dim',80),
+L('  Bundling worker…','muted',300),
+L('  esbuild: scanning 847 modules…','muted',500),
+L('  Tree-shaking complete: 284kb','muted',400),
+L('  Build time: 1.24s','muted',200),
+L('','dim',80),
+L('  Uploading script…','muted',350),
+L('','dim',60),
+L('  Worker         inneranimal-dashboard','info',200),
+L('  Compat date    2026-04-08','info',60),
+L('  D1 binding     inneranimalmedia-business [cf87b717]','info',60),
+L('  R2 binding     agent-sam-sandbox-cicd','info',60),
+L('  KV binding     IAM_KV, RATE_LIMIT_KV','info',60),
+L('  Queues         DEPLOY_QUEUE, AGENT_QUEUE','info',60),
+L('','dim',80),
+L('  Routing table:','muted',200),
+L('    dashboard.inneranimalmedia.com  /* -> inneranimal-dashboard','dim',60),
+L('','dim',80),
+L('  [OK] Deployed successfully  3.41s','success',400),
+L('  >> https://inneranimal-dashboard.samprimeaux.workers.dev','accent',80),
+L('','dim',100),
+L('  Next: run /benchmark to proceed to prod','warn',200),
+];
+}
+
+function buildBenchmark() {
+let d = 0; const L = (text, color, gap=80) => { d+=gap; return {text,color,delay:d}; };
+const lines = [
+L('gorilla@inneranimal ~ % /benchmark','cmd',0),
+L('','dim',60),
+L('  Running 31 tests against inneranimal-dashboard…','muted',200),
+L('','dim',60),
+];
+BENCH_TESTS.forEach(([name, ms], i) => {
+const num = String(i+1).padStart(2,'0');
+const dots = '.'.repeat(Math.max(2, 36 - name.length));
+lines.push(L(`  [${num}/31] ${name} ${dots} PASS   ${ms}ms`,'pass',75));
+});
+lines.push(L('','dim',100));
+lines.push(L('  '+'-'.repeat(52),'dim',100));
+lines.push(L('  RESULTS   31 / 31 PASSED   avg 47ms   total 1.46s','success',200));
+lines.push(L('  '+'-'.repeat(52),'dim',60));
+lines.push(L('','dim',80));
+lines.push(L('  [GATE PASSED] Cleared for production promote','success',300));
+return lines;
+}
+
+function buildD1() {
+let d = 0; const L = (text, color, gap=100) => { d+=gap; return {text,color,delay:d}; };
+const SEP = '  +—————————+———+———————+';
+const rows = [
+['inneranimalmedia','success','2026-04-07 23:10:56'],
+['inneranimal-dashboard','success','2026-04-07 22:55:15'],
+['inneranimal-dashboard','success','2026-04-07 22:06:28'],
+['inneranimalmedia','success','2026-04-06 18:32:11'],
+['inneranimal-dashboard','error','2026-04-06 17:44:03'],
+];
+return [
+L('gorilla@inneranimal ~ % /d1 SELECT name, status, created_at FROM deployments ORDER BY created_at DESC LIMIT 5','cmd',0),
+L('','dim',60),
+L('  DB: inneranimalmedia-business','muted',150),
+L('  ID: cf87b717-d4e2-4cf8-bab0-a81268e32d49','dim',60),
+L('','dim',100),
+L(SEP,'table',200),
+L('  | name                      | status  | created_at          |','table',60),
+L(SEP,'table',60),
+…rows.map(([n,s,t]) => L(
+`  | ${n.padEnd(25)} | ${s.padEnd(7)} | ${t} |`,
+s==='error'?'error':'white', 90
+)),
+L(SEP,'table',90),
+L('  5 rows  |  2ms','dim',100),
+];
+}
+
+function buildTail() {
+let d = 0; const L = (text, color, gap=280) => { d+=gap; return {text,color,delay:d}; };
+const reqs = [
+['GET ','/ ','200','14ms',''],
+['POST','/api/agent/chat ','200','234ms',''],
+['GET ','/api/workspace/status ','200','8ms',''],
+['POST','/mcp ','200','45ms','[MCP]'],
+['GET ','/api/deployments ','200','12ms',''],
+['POST','/api/agent/chat ','200','891ms','[LLM]'],
+['GET ','/health ','200','2ms',''],
+['POST','/api/d1/query ','200','34ms',''],
+['GET ','/api/workspace/list ','200','18ms',''],
+['POST','/api/agent/chat ','500','12ms','[ERR]'],
+];
+const delays = [0,320,180,260,400,350,220,310,280,450];
+return [
+L('gorilla@inneranimal ~ % /tail inneranimalmedia','cmd',0),
+L('','dim',60),
+L('  npx wrangler tail inneranimalmedia –format pretty','muted',100),
+L('  Streaming live logs… (CTRL+C to stop)','dim',300),
+L('','dim',100),
+…reqs.map(([m,p,s,t,tag],i) => L(
+`  [10:23:${41+i}] ${m} ${p.padEnd(30)}${s}  ${t.padEnd(8)}${tag}`,
+s==='500'?'error': tag==='[LLM]'?'warn': tag==='[MCP]'?'info': 'muted',
+delays[i] || 300
+)),
+L('','dim',200),
+L('  1 error detected – POST /api/agent/chat returned 500','error',200),
+L('  Tip: run /samiam to diagnose','warn',200),
+];
+}
+
+function buildSamIAm() {
+let d = 0; const L = (text, color, gap=80) => { d+=gap; return {text,color,delay:d}; };
+return [
+L('gorilla@inneranimal ~ % /samiam how is our terminal setup','cmd',0),
+L('','dim',60),
+L('  >> AGENT SAM ACTIVATED','sam',200),
+L('  >> Workspace: ws_inneranimalmedia','sam',100),
+L('  >> PTY context: injecting last 30 lines','sam',100),
+L('  >> Routing: claude-sonnet-4-6 (T2)','sam',100),
+L('','dim',200),
+L('  [SAM] Terminal PTY is running clean. Your xterm.js','sam',400),
+L('        bridge is connected to iam-pty via WebSocket.','sam',150),
+L('        gorilla-mode shell is rendering on top of it.','sam',150),
+L('','dim',80),
+L('  [SAM] One issue flagging: 50 open errors in status','sam',300),
+L('        bar – traced to mcp_services table having 30','sam',150),
+L('        rows all pointing to same endpoint, NULL last_used.','sam',150),
+L('        Table is never read by Worker – safe to truncate.','sam',150),
+L('','dim',80),
+L('  [SAM] Also: terminal_sessions user_id backfill is','sam',300),
+L('        still needed in register INSERT (hardcoded sam).','sam',150),
+L('','dim',80),
+L('  [1] Show me the mcp_services cleanup query','white',300),
+L('  [2] Run /d1 truncate mcp_services directly','white',80),
+L('  [3] Open the terminal_sessions bug in Cursor','white',80),
+L('  [esc] Skip for now','dim',80),
+];
+}
+
+function buildWrangler() {
+let d = 0; const L = (text, color, gap=100) => { d+=gap; return {text,color,delay:d}; };
+return [
+L('gorilla@inneranimal ~ % /wrangler tail inneranimalmedia','cmd',0),
+L('','dim',60),
+L('  [GATE] About to run:','warn',150),
+L('  ./scripts/with-cloudflare-env.sh npx wrangler tail inneranimalmedia','white',80),
+L('','dim',80),
+L('  PROCEED?  [1] YES   [esc] NO','warn',200),
+L('','dim',100),
+L('  >> 1','cmd',600),
+L('','dim',60),
+L('  Connecting to worker: inneranimalmedia','muted',200),
+L('  Account: Inner Animal Media (6f2a…)','muted',80),
+L('  Zone: inneranimalmedia.com','muted',80),
+L('','dim',100),
+L('  [STREAM] Listening for events…','success',300),
+L('','dim',80),
+L('  10:31:04  GET  /                        200  11ms','dim',400),
+L('  10:31:06  POST /api/agent/chat          200  445ms','dim',350),
+L('  10:31:07  GET  /api/status              200  6ms','dim',250),
+L('  10:31:09  POST /mcp                     200  88ms  [MCP]','info',380),
+L('  10:31:11  POST /api/agent/chat          200  1201ms [LLM]','warn',620),
+L('','dim',200),
+L('  LLM call latency spike: 1201ms – check Sonnet routing','warn',200),
+];
+}
+
+const SCENARIOS = [
+{ key:'deploy',    label:'/deploy',    fn:buildDeploy,    status:'DEPLOYING',  coins:6,  pump:true,  errAt:null },
+{ key:'benchmark', label:'/benchmark', fn:buildBenchmark, status:'BENCHMARKING',coins:12, pump:true,  errAt:null },
+{ key:'d1',        label:'/d1 query',  fn:buildD1,        status:'QUERYING D1',coins:3,  pump:false, errAt:null },
+{ key:'tail',      label:'/tail',      fn:buildTail,      status:'TAILING',    coins:0,  pump:false, errAt:9 },
+{ key:'samiam',    label:'/samiam',    fn:buildSamIAm,    status:'SAM ACTIVE', coins:4,  pump:true,  errAt:null },
+{ key:'wrangler',  label:'/wrangler',  fn:buildWrangler,  status:'CF GATE',    coins:2,  pump:false, errAt:null },
+];
+
+// ── Sprite Renderer ───────────────────────────────────────────────────────────
+function Sprite({ data, scale=1 }) {
+const ps = PS * scale;
+return (
+<svg width={data[0].length*ps} height={data.length*ps} style={{imageRendering:'pixelated',display:'block'}}>
+{data.flatMap((row,y) => row.map((c,x) =>
+c ? <rect key={`${x},${y}`} x={x*ps} y={y*ps} width={ps} height={ps} fill={PAL[c]}/> : null
+))}
+</svg>
+);
+}
+
+// ── Bar ───────────────────────────────────────────────────────────────────────
+function Bar({ pct, color, label, val }) {
+return (
+<div style={{marginBottom:10}}>
+<div style={{display:'flex',justifyContent:'space-between',fontSize:9,letterSpacing:2,color:'rgba(255,255,255,.4)',marginBottom:3}}>
+<span>{label}</span><span style={{color}}>{val}</span>
+</div>
+<div style={{height:6,background:'rgba(255,255,255,.07)',position:'relative'}}>
+<div style={{position:'absolute',top:0,left:0,height:'100%',width:`${pct}%`,background:color,transition:'width .4s ease',boxShadow:`0 0 6px ${color}`}}/>
+</div>
+</div>
+);
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+export default function GorillaMode() {
+const [themeIdx, setThemeIdx] = useState(0);
+const [lines, setLines]       = useState([{text:'gorilla@inneranimal ~ % ready. select a demo below.', color:'dim', delay:0}]);
+const [running, setRunning]   = useState(false);
+const [status, setStatus]     = useState('READY');
+const [progress, setProgress] = useState(0);
+const [pump, setPump]         = useState(false);
+const [errorFlash, setError]  = useState(false);
+const [coinCount, setCoinCount] = useState(0);
+const [floatCoins, setFloat]  = useState([]);
+const [flameTick, setFlameTick] = useState(0);
+const [booted, setBooted]     = useState(false);
+const [bootLine, setBootLine] = useState('');
+const [activeScenario, setActive] = useState(null);
+const termRef = useRef(null);
+const timerRefs = useRef([]);
+
+const T = THEMES[TKEYS[themeIdx]];
+
+// Boot
+useEffect(() => {
+const BOOT = ['GORILLA MODE v0.1','>> D1: inneranimalmedia-business','>> MCP TOOLS: 98 LOADED','>> AGENT SAM: ONLINE','>> READY'];
+let i = 0;
+const t = setInterval(() => { if(i<BOOT.length){setBootLine(BOOT[i]);i++;}else{clearInterval(t);setTimeout(()=>setBooted(true),400);}}, 340);
+return () => clearInterval(t);
+}, []);
+
+// Flame tick
+useEffect(() => {
+const t = setInterval(() => setFlameTick(n => (n+1)%3), 190);
+return () => clearInterval(t);
+}, []);
+
+// Auto-scroll terminal
+useEffect(() => {
+if (termRef.current) termRef.current.scrollTop = termRef.current.scrollHeight;
+}, [lines]);
+
+const stars = useMemo(() =>
+Array.from({length:40},(_,i) => ({id:i,x:Math.random()*100,y:Math.random()*45,s:Math.random()<.2?2:1,d:Math.random()*4}))
+,[]);
+
+const spawnCoins = useCallback((n) => {
+if (!n) return;
+const batch = Array.from({length:n},(_,i) => ({id:Date.now()+i,x:15+Math.random()*30,y:40+Math.random()*15,dx:(Math.random()-.5)*50}));
+setFloat(p=>[…p,…batch]);
+setCoinCount(c=>c+n);
+setTimeout(()=>setFloat(p=>p.filter(c=>!batch.find(b=>b.id===c.id))),1400);
+},[]);
+
+const runScenario = useCallback((s) => {
+if (running) return;
+timerRefs.current.forEach(clearTimeout);
+timerRefs.current = [];
+const scenario = SCENARIOS.find(x=>x.key===s);
+if (!scenario) return;
+const sceneLines = scenario.fn();
+const maxDelay = Math.max(…sceneLines.map(l=>l.delay));
+setLines([]);
+setRunning(true);
+setStatus(scenario.status);
+setProgress(0);
+setActive(s);
+
+```
+sceneLines.forEach((line,i) => {
+  const t = setTimeout(() => {
+    setLines(p=>[...p,line]);
+    setProgress(Math.round(((i+1)/sceneLines.length)*100));
+    if (line.color==='error'||line.color==='fail') {
+      setError(true); setTimeout(()=>setError(false),600);
+    }
+  }, line.delay);
+  timerRefs.current.push(t);
+});
+
+const done = setTimeout(() => {
+  setRunning(false);
+  setStatus('READY');
+  setProgress(100);
+  if (scenario.pump) { setPump(true); setTimeout(()=>setPump(false),700); }
+  spawnCoins(scenario.coins);
+}, maxDelay + 400);
+timerRefs.current.push(done);
+```
+
+}, [running, spawnCoins]);
+
+const CSS = `@keyframes idle    {0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)}} @keyframes pump    {0%{transform:scale(1)} 30%{transform:scale(1.12) translateY(-7px)} 70%{transform:scale(.97)} 100%{transform:scale(1)}} @keyframes shake   {0%,100%{transform:translateX(0)} 20%{transform:translateX(-4px)} 40%{transform:translateX(4px)} 60%{transform:translateX(-3px)} 80%{transform:translateX(3px)}} @keyframes rise    {0%{transform:translateY(0) scale(1);opacity:1} 100%{transform:translateY(-80px) scale(.3);opacity:0}} @keyframes blink   {0%,100%{opacity:1} 50%{opacity:0}} @keyframes twinkle {0%,100%{opacity:.7} 50%{opacity:.1}} @keyframes flicker {0%,100%{transform:scaleY(1)} 50%{transform:scaleY(1.12) scaleX(.9)}} @keyframes scan    {0%{opacity:.02} 50%{opacity:.05} 100%{opacity:.02}} @keyframes fadein  {from{opacity:0;transform:translateY(6px)} to{opacity:1;transform:none}} @keyframes errflash{0%,100%{box-shadow:none} 50%{box-shadow:0 0 30px #ff444488 inset}} .scen-btn{cursor:pointer;transition:all .12s;font-family:"Courier New",monospace;} .scen-btn:hover{transform:translateY(-1px);} .scen-btn:disabled{opacity:.35;cursor:not-allowed;transform:none;}`;
+
+if (!booted) return (
+<div style={{width:'100%',height:'100vh',background:'#030a14',display:'flex',flexDirection:'column',alignItems:'center',justifyContent:'center',fontFamily:'"Courier New",monospace',color:'#00e5ff'}}>
+<style>{CSS}</style>
+<div style={{fontSize:10,letterSpacing:6,opacity:.35,marginBottom:14}}>INNERANIMAL MEDIA</div>
+<div style={{fontSize:15,letterSpacing:2,textShadow:'0 0 10px #00e5ff'}}>
+{bootLine}<span style={{animation:'blink .7s infinite'}}>_</span>
+</div>
+</div>
+);
+
+return (
+<div style={{width:'100%',minHeight:'100vh',background:`linear-gradient(160deg,${T.bg} 0%,#030a14 100%)`,fontFamily:'"Courier New",monospace',position:'relative',overflow:'hidden'}}>
+<style>{CSS}</style>
+
+```
+  {/* Scanlines */}
+  <div style={{position:'absolute',inset:0,pointerEvents:'none',zIndex:99,
+    backgroundImage:`repeating-linear-gradient(0deg,${T.dim.replace('22','06')} 0,${T.dim.replace('22','06')} 1px,transparent 1px,transparent 3px)`,
+    animation:'scan 5s infinite'}}/>
+
+  {/* Stars */}
+  {stars.map(s=>(
+    <div key={s.id} style={{position:'absolute',left:`${s.x}%`,top:`${s.y}%`,width:s.s,height:s.s,background:'#fff',
+      animation:`twinkle ${2+s.d}s infinite`,animationDelay:`${s.d}s`,pointerEvents:'none'}}/>
+  ))}
+
+  {/* Floating coins */}
+  {floatCoins.map(c=>(
+    <div key={c.id} style={{position:'absolute',left:`${c.x}%`,top:`${c.y}%`,
+      animation:'rise 1.3s ease-out forwards',transform:`translateX(${c.dx}px)`,pointerEvents:'none',zIndex:60}}>
+      <Sprite data={COIN} scale={.9}/>
+    </div>
+  ))}
+
+  {/* Top bar */}
+  <div style={{display:'flex',alignItems:'center',justifyContent:'space-between',
+    padding:'10px 18px 8px',borderBottom:`1px solid ${T.border}`,background:T.panel}}>
+    <div>
+      <span style={{fontSize:9,letterSpacing:5,color:T.accent,opacity:.6}}>INNERANIMAL MEDIA  //  </span>
+      <span style={{fontSize:12,fontWeight:900,letterSpacing:4,color:'#fff',textShadow:T.glow}}>GORILLA MODE</span>
+    </div>
+    <div style={{display:'flex',alignItems:'center',gap:16}}>
+      <div style={{display:'flex',alignItems:'center',gap:6,background:'rgba(0,0,0,.5)',border:`1px solid ${T.accent}`,padding:'3px 10px'}}>
+        <Sprite data={COIN} scale={.45}/>
+        <span style={{color:T.accent,fontSize:11,letterSpacing:2}}>x {coinCount}</span>
+      </div>
+      <button className="scen-btn" onClick={()=>setThemeIdx(i=>(i+1)%TKEYS.length)}
+        style={{padding:'4px 10px',background:'transparent',border:`1px solid ${T.border}`,color:T.accent,fontSize:9,letterSpacing:2}}>
+        {TKEYS[themeIdx]}
+      </button>
+    </div>
+  </div>
+
+  {/* Main split */}
+  <div style={{display:'flex',height:'calc(100vh - 130px)',minHeight:400}}>
+
+    {/* LEFT: Gorilla + HUD */}
+    <div style={{width:200,minWidth:180,borderRight:`1px solid ${T.border}`,background:T.panel,
+      display:'flex',flexDirection:'column',alignItems:'center',padding:'16px 14px',gap:0,flexShrink:0}}>
+
+      {/* Gorilla */}
+      <div style={{
+        animation: errorFlash ? 'shake .5s ease' : pump ? 'pump .6s ease' : 'idle 2.8s ease-in-out infinite',
+        filter: errorFlash ? 'brightness(1.5) saturate(2) hue-rotate(-20deg)' : 'none',
+        marginBottom:8,
+      }}>
+        <Sprite data={pump ? GORILLA_PUMP : GORILLA} scale={1.05}/>
+      </div>
+
+      {/* Flames */}
+      <div style={{display:'flex',justifyContent:'center',gap:60,marginTop:-4}}>
+        {[0,1].map(i=>(
+          <div key={i} style={{animation:'flicker .45s infinite',animationDelay:`${i*.2}s`}}>
+            <Sprite data={FLAME_FRAMES[flameTick]} scale={.9}/>
+          </div>
+        ))}
+      </div>
+
+      {/* Status */}
+      <div style={{width:'100%',marginTop:14,paddingTop:12,borderTop:`1px solid ${T.border}`}}>
+        <div style={{fontSize:9,letterSpacing:3,color:T.accent,marginBottom:10,textAlign:'center',textShadow:T.glow}}>
+          {status}
+          {running && <span style={{animation:'blink .7s infinite',marginLeft:4}}>_</span>}
+        </div>
+
+        <Bar pct={progress} color={T.accent} label="PROGRESS" val={`${progress}%`}/>
+        <Bar pct={Math.max(0,100-progress)} color="#ff4444" label="ERRORS" val="50"/>
+        <Bar pct={running?65:100} color="#44ff88" label="AGENT" val={running?'BUSY':'READY'}/>
+
+        <div style={{marginTop:12,paddingTop:10,borderTop:`1px solid ${T.border}`,fontSize:9,color:'rgba(255,255,255,.3)',letterSpacing:1,lineHeight:1.8}}>
+          <div>ws_inneranimalmedia</div>
+          <div>branch: main {running&&<span style={{color:T.accent}}>*</span>}</div>
+          <div style={{color:activeScenario?T.accent:'inherit'}}>
+            {activeScenario ? `> ${activeScenario}` : '> idle'}
+          </div>
+        </div>
+      </div>
+    </div>
+
+    {/* RIGHT: Terminal */}
+    <div style={{flex:1,display:'flex',flexDirection:'column',overflow:'hidden'}}>
+
+      {/* Terminal header */}
+      <div style={{padding:'7px 16px',borderBottom:`1px solid ${T.border}`,background:'rgba(0,0,0,.4)',
+        display:'flex',alignItems:'center',gap:8}}>
+        <div style={{width:8,height:8,borderRadius:'50%',background:running?T.accent:'#ffffff22',boxShadow:running?T.glow:'none',transition:'all .3s'}}/>
+        <span style={{fontSize:9,letterSpacing:2,color:'rgba(255,255,255,.3)'}}>TERMINAL OUTPUT</span>
+        <span style={{marginLeft:'auto',fontSize:9,color:'rgba(255,255,255,.2)',letterSpacing:1}}>{lines.length} lines</span>
+      </div>
+
+      {/* Output */}
+      <div ref={termRef} style={{flex:1,overflowY:'auto',padding:'14px 18px',
+        animation: errorFlash ? 'errflash .5s ease' : 'none',
+        scrollbarWidth:'thin',scrollbarColor:`${T.accent}33 transparent`}}>
+        {lines.map((line, i) => (
+          <div key={i} style={{
+            fontFamily:'"Courier New",monospace',fontSize:12,lineHeight:1.65,
+            whiteSpace:'pre',color: LC[line.color] || LC.white,
+            animation: i===lines.length-1 ? 'fadein .15s ease' : 'none',
+          }}>
+            {line.text || '\u00A0'}
+          </div>
+        ))}
+        {running && (
+          <div style={{color:T.accent,fontSize:12,animation:'blink .7s infinite',marginTop:2}}>_</div>
+        )}
+      </div>
+
+      {/* Input line */}
+      <div style={{padding:'8px 16px',borderTop:`1px solid ${T.border}`,background:'rgba(0,0,0,.5)',
+        display:'flex',alignItems:'center',gap:8}}>
+        <span style={{color:T.accent,fontSize:12,whiteSpace:'nowrap'}}>gorilla@inneranimal ~ %</span>
+        <div style={{flex:1,fontSize:12,color:'rgba(255,255,255,.7)',letterSpacing:.5}}>
+          {running ? (
+            <span style={{color:'rgba(255,255,255,.3)'}}>running... <span style={{animation:'blink .5s infinite'}}>|</span></span>
+          ) : (
+            <span style={{color:'rgba(255,255,255,.3)'}}>type /help or select demo below<span style={{animation:'blink 1s infinite'}}>|</span></span>
+          )}
+        </div>
+      </div>
+    </div>
+  </div>
+
+  {/* Scenario buttons */}
+  <div style={{borderTop:`1px solid ${T.border}`,background:T.panel,
+    display:'flex',flexWrap:'wrap',gap:0}}>
+    {SCENARIOS.map(s=>(
+      <button key={s.key} className="scen-btn" disabled={running}
+        onClick={()=>runScenario(s.key)}
+        style={{flex:'1 1 0',padding:'10px 8px',minWidth:100,
+          background: activeScenario===s.key ? T.dim : 'transparent',
+          border:'none',borderRight:`1px solid ${T.border}`,
+          color: activeScenario===s.key ? T.accent : 'rgba(255,255,255,.5)',
+          fontSize:11,letterSpacing:1.5,textShadow: activeScenario===s.key ? T.glow : 'none'}}>
+        {s.label}
+      </button>
+    ))}
+  </div>
+</div>
+```
+
+);
+}

package/examples/gorilla-shell/README.md

@@ -0,0 +1,22 @@
+# Gorilla Shell (Phase 0)
+
+Game-feel terminal UI prototype — consolidated from [InnerAnimal/gorilla-mode](https://github.com/InnerAnimal/gorilla-mode) into **Agent Sam SDK**.
+
+This is the **unique install experience** layer: pixel HUD, themed moods, slash-command demos, deploy/benchmark scenarios. Phase 1 connects real PTY via ExecOS.
+
+## Run locally
+
+```bash
+cd examples/gorilla-shell
+npm install
+npm run dev
+```
+
+## What you see
+
+- Gorilla launch screen + sprite reactions
+- Themes: NIGHT, DAY, LAVA, VOID
+- Six demo scenarios (deploy, benchmark, D1, tail, samiam, wrangler)
+- Slash command registry lives in `../../src/lib/slash-commands.js`
+
+Full architecture: [docs/CLI_SHELL.md](../../docs/CLI_SHELL.md)

package/examples/gorilla-shell/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Agent Sam Shell — Gorilla Mode</title>
+    <style>
+      html, body, #root { margin: 0; height: 100%; background: #030a14; }
+    </style>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/main.jsx"></script>
+  </body>
+</html>

package/examples/gorilla-shell/main.jsx

@@ -0,0 +1,9 @@
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+import App from './App.tsx';
+
+createRoot(document.getElementById('root')).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);

package/examples/gorilla-shell/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@inneranimalmedia/agentsam-shell-example",
+  "private": true,
+  "type": "module",
+  "description": "Phase 0 Gorilla Shell — game-feel CLI UX prototype for Agent Sam SDK",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.5.2",
+    "vite": "^6.3.5"
+  }
+}

package/examples/gorilla-shell/vite.config.js

@@ -0,0 +1,10 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+  build: {
+    outDir: 'dist',
+    emptyOutDir: true,
+  },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-sdk",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Agent Sam is a full-stack AI agent SDK for autonomous task execution — covering data management, creative workflows, design commands, and multi-step agentic pipelines.",
   "type": "module",
   "main": "./src/index.js",
@@ -9,10 +9,12 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "agentsam": "./src/cli.js"
+    "agentsam": "src/cli.js"
   },
   "files": [
     "src",
+    "docs",
+    "examples",
     "test",
     "README.md",
     "LICENSE",

package/src/cli.js

@@ -3,6 +3,7 @@
 import readline from 'readline';
 import pkg from '../package.json' with { type: 'json' };
 import { scaffoldProject } from './lib/scaffold.js';
+import { SLASH_COMMANDS, SHELL_PHASES } from './lib/slash-commands.js';
 
 const VERSION = pkg.version;
 
@@ -61,6 +62,7 @@ function printHelp() {
 
   Usage:
     agentsam init [options]     Scaffold a new Agent Sam project
+    agentsam shell              CLI shell UX info + slash commands (Gorilla Shell)
     agentsam --version          Print version
     agentsam --help             Show this help
 
@@ -244,6 +246,30 @@ async function initFromArgs(argv) {
   });
 }
 
+async function runShellInfo() {
+  const next = SHELL_PHASES.find((p) => p.status === 'next');
+  console.log(`
+  ╔═══════════════════════════════════╗
+  ║     Agent Sam Shell (Gorilla)     ║
+  ╚═══════════════════════════════════╝
+
+  Game-feel terminal UX for SDK installs — HUD, themes, slash commands, PTY bridge.
+
+  Phase 0 prototype: examples/gorilla-shell/
+  Docs:              docs/CLI_SHELL.md
+  Next milestone:    ${next?.label ?? 'PTY connection'}
+
+  Slash commands (${SLASH_COMMANDS.length} registered):
+`);
+  for (const row of SLASH_COMMANDS) {
+    console.log(`    ${row.cmd.padEnd(14)} ${row.description}`);
+  }
+  console.log(`
+  Run the visual prototype:
+    cd examples/gorilla-shell && npm install && npm run dev
+  `);
+}
+
 const command = process.argv[2];
 const rest = process.argv.slice(3);
 
@@ -251,6 +277,8 @@ if (command === '--version' || command === '-v') {
   console.log(VERSION);
 } else if (command === '--help' || command === '-h' || !command) {
   printHelp();
+} else if (command === 'shell') {
+  await runShellInfo();
 } else if (command === 'init') {
   const hasFlags = rest.some((a) => a.startsWith('--'));
   if (hasFlags) {

package/src/index.js

@@ -6,6 +6,12 @@ export { AgentSam } from './AgentSam.js';
 export { routeIntent } from './lib/router.js';
 export { getToolCatalog } from './lib/tools.js';
 export { scaffoldProject } from './lib/scaffold.js';
+export {
+  SLASH_COMMANDS,
+  SHELL_THEMES,
+  SHELL_PHASES,
+  listSlashCommands,
+} from './lib/slash-commands.js';
 
 export const version = pkg.version;
 export const name = pkg.name;

package/src/lib/slash-commands.js

@@ -0,0 +1,40 @@
+/**
+ * Canonical slash-command surface for Agent Sam SDK CLI / shell UX.
+ * Consumed by the gorilla-shell example and future `agentsam shell` PTY bridge.
+ */
+
+export const SHELL_THEMES = ['NIGHT', 'DAY', 'LAVA', 'VOID'];
+
+/** @type {Array<{ cmd: string, description: string, lane?: string }>} */
+export const SLASH_COMMANDS = [
+  { cmd: '/cd', description: 'Change working directory', lane: 'terminal' },
+  { cmd: '/pwd', description: 'Print working directory', lane: 'terminal' },
+  { cmd: '/gh', description: 'GitHub operations (status, PR, issue)', lane: 'git' },
+  { cmd: '/wrangler', description: 'Wrangler deploy and bindings', lane: 'deploy' },
+  { cmd: '/workspace', description: 'Switch or show active workspace', lane: 'platform' },
+  { cmd: '/samiam', description: 'Agent Sam quick invoke', lane: 'agent' },
+  { cmd: '/claude', description: 'Route prompt to Claude arm', lane: 'agent' },
+  { cmd: '/codex', description: 'Route prompt to Codex arm', lane: 'agent' },
+  { cmd: '/tail', description: 'Tail worker logs', lane: 'observability' },
+  { cmd: '/d1', description: 'D1 query helper', lane: 'data' },
+  { cmd: '/deploy', description: 'Deploy worker (sandbox or prod gate)', lane: 'deploy' },
+  { cmd: '/buddy', description: 'Open Agent Sam buddy panel (MCP)', lane: 'agent' },
+  { cmd: '/status', description: 'Platform + project health', lane: 'platform' },
+  { cmd: '/diagnostics', description: 'Run diagnostic scenario', lane: 'platform' },
+];
+
+/** Shell UX rollout phases (gorilla-shell → SDK default CLI experience). */
+export const SHELL_PHASES = [
+  { id: '0-prototype', label: 'Visual prototype + demo scenarios', status: 'complete' },
+  { id: 'pty-connection', label: 'ExecOS / iam-pty WebSocket bridge', status: 'next' },
+  { id: 'hud-layer', label: 'Quest log, tool gate, XP HUD', status: 'planned' },
+  { id: 'buddy-system', label: 'In-shell Agent Sam via MCP', status: 'planned' },
+  { id: 'dashboard-embed', label: 'Embeddable shell for IAM dashboard', status: 'planned' },
+  { id: 'standalone-pwa', label: 'Installable PWA / SDK default shell', status: 'planned' },
+];
+
+export function listSlashCommands(opts = {}) {
+  const lane = opts.lane ? String(opts.lane).trim().toLowerCase() : '';
+  if (!lane) return [...SLASH_COMMANDS];
+  return SLASH_COMMANDS.filter((row) => !row.lane || row.lane === lane);
+}

package/test/smoke.mjs

@@ -35,4 +35,8 @@ assert.ok(fs.existsSync(path.join(dir, 'src/index.js')));
 assert.ok(fs.readFileSync(path.join(dir, 'migrations/0001_agentsam_core.sql'), 'utf8').includes('cms_pages'));
 assert.ok(fs.readFileSync(path.join(dir, 'package.json'), 'utf8').includes('wrangler'));
 
+import { SLASH_COMMANDS, listSlashCommands } from '../src/lib/slash-commands.js';
+assert.ok(SLASH_COMMANDS.some((c) => c.cmd === '/deploy'));
+assert.equal(listSlashCommands({ lane: 'deploy' }).length, 2);
+
 console.log('SDK smoke tests passed');