panopticon-cli 0.4.32 → 0.5.0

package/README.md

@@ -7,64 +7,99 @@
 [![npm version](https://img.shields.io/npm/v/panopticon-cli.svg)](https://www.npmjs.com/package/panopticon-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/eltmon/panopticon/pulls)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/eltmon/panopticon-cli/pulls)
 
 > *"The Panopticon had six sides, one for each of the Founders of Gallifrey..."*
+>
+> — Classic Doctor Who. The Panopticon was the great hall at the heart of the Time Lord Citadel, where all could be observed. We liked the metaphor.
+
+Spawn AI agents from a dashboard. Route tasks to the right model. Review, test, and merge automatically.
 
-<img src="docs/dashboard-overview.png" alt="Panopticon Dashboard" width="800" />
+<img src="docs/screenshot-board.png" alt="Panopticon Kanban Board" width="800" />
 
 </div>
 
 ---
 
-## What is Panopticon?
+## Why Panopticon?
+
+- **Stop babysitting agents.** Spawn them from a dashboard, monitor progress in real time, and let specialists handle code review, testing, and merging.
+- **Use the right model for the job.** Opus for planning, Kimi for implementation, Haiku for quick commands — automatic routing based on task type and required capabilities.
+- **Work survives across sessions.** PRDs, state files, beads, and skills persist context so agents don't start from zero every time.
+- **One skill format, every tool.** Write a SKILL.md once and it works across Claude Code, Codex, Cursor, and Gemini CLI.
+
+---
+
+## How It Works
+
+```
+ Issue         PRD           Agent         Review        Test          Merge
+┌──────┐    ┌──────┐    ┌──────────┐    ┌──────┐    ┌──────┐    ┌──────────┐
+│ Task │ ─► │ Plan │ ─► │ Write    │ ─► │ Code │ ─► │ Run  │ ─► │ PR       │
+│ from │    │ with │    │ code in  │    │ rev. │    │ test │    │ merged   │
+│ any  │    │ Opus │    │ isolated │    │ by   │    │ by   │    │ by       │
+│track-│    │      │    │ worktree │    │ spec-│    │ spec-│    │ spec-    │
+│ er   │    │      │    │          │    │ialist│    │ialist│    │ ialist   │
+└──────┘    └──────┘    └──────────┘    └──────┘    └──────┘    └──────────┘
+ GitHub       Opus        Kimi/Sonnet    Opus        Sonnet       Sonnet
+ Linear                   (routed)
+ GitLab
+ Jira
+ Rally
+```
+
+Create a workspace, and Panopticon handles the rest: planning with Opus, implementation with your configured model, automated code review, test execution, and merge — the only manual step is clicking **MERGE** when you're satisfied.
+
+---
+
+## Key Features
 
-| Without Panopticon | With Panopticon |
-|:------------------|:----------------|
-| Manually juggle multiple AI agents | **Automatic orchestration** - spawn, monitor, and coordinate agents from a dashboard |
-| Agents start fresh every session | **Persistent context** - skills, state files, and beads track work across sessions |
-| Simple tasks eat Opus credits | **Smart model routing** - Haiku for simple, Sonnet for medium, Opus for complex |
-| Stuck agents waste your time | **Automatic recovery** - detect stuck agents and hand off to specialists |
-| AI tools have separate configs | **Universal skills** - one SKILL.md works across Claude, Codex, Cursor, Gemini |
+| Feature | Description |
+|:--------|:------------|
+| **Multi-Agent Orchestration** | Spawn and manage AI agents in tmux sessions via dashboard or CLI |
+| **Cloister Lifecycle Manager** | Automatic model routing, stuck detection, cost tracking, and specialist handoffs |
+| **Mission Control** | 11-view dashboard — project tree, activity feed, kanban board, agent status, costs, metrics, and more |
+| **PRD-Driven Workflow** | Opus writes a PRD before implementation starts; agents are blocked without one |
+| **67+ Universal Skills** | Pre-built skills ship out of the box, synced via `pan sync` — one SKILL.md works across all AI tools |
+| **Multi-Tracker Support** | GitHub Issues, Linear, GitLab, Jira, Rally — all from one dashboard |
+| **Multi-Model Routing** | Anthropic, OpenAI, Google, Kimi, Zhipu — route by task type, capability, and budget |
+| **Workspaces** | Git worktree-based feature branches with Docker isolation (local and remote via exe.dev) |
+| **Convoys** | Run parallel agents on related issues with automatic synthesis |
+| **Specialists** | Dedicated review, test, and merge agents — fully automated quality pipeline |
+| **Beads** | Git-backed task tracking that survives context compaction and works offline |
+| **Cost Tracking** | Per-issue, per-stage token costs with dashboard analytics |
+| **Legacy Codebase Support** | AI self-monitoring skills that learn your codebase conventions over time ([details](docs/LEGACY-CODEBASE.md)) |
+
+---
 
 ## Screenshots
 
 <div align="center">
 <table>
 <tr>
-<td><img src="docs/planning-session-dialog.png" alt="Planning Dialog" width="300" /></td>
-<td><img src="docs/planning-session-discovery.png" alt="Discovery Phase" width="300" /></td>
-<td><img src="docs/planning-session-active.png" alt="Active Session" width="300" /></td>
+<td><img src="docs/dashboard-overview.png" alt="Mission Control" width="400" /></td>
+<td><img src="docs/screenshot-agents.png" alt="Agent Management" width="400" /></td>
 </tr>
 <tr>
-<td align="center"><em>Start planning</em></td>
-<td align="center"><em>Discovery phase</em></td>
-<td align="center"><em>Active session</em></td>
+<td align="center"><em>Mission Control — project tree, activity timeline, specialist pipeline</em></td>
+<td align="center"><em>Cloister Deacon, specialist agents, and issue agent management</em></td>
+</tr>
+<tr>
+<td colspan="2"><img src="docs/screenshot-settings.png" alt="Model Routing Settings" width="800" /></td>
+</tr>
+<tr>
+<td colspan="2" align="center"><em>Tracker integration and capability-based model routing</em></td>
 </tr>
 </table>
 </div>
 
-## Key Features
-
-| Feature | Description |
-|:--------|:------------|
-| **Multi-Agent Orchestration** | Spawn and manage AI agents in tmux sessions via dashboard or CLI |
-| **Cloister Lifecycle Manager** | Automatic model routing, stuck detection, and specialist handoffs |
-| **Universal Skills** | One SKILL.md format works across all supported AI tools |
-| **Workspaces** | Git worktree-based feature branches with Docker isolation |
-| **Convoys** | Run parallel agents on related issues with auto-synthesis |
-| **Specialists** | Dedicated review, test, and merge agents for quality control |
-| **Heartbeat Monitoring** | Real-time agent activity tracking via Claude Code hooks |
-| **Mission Control** | Unified monitoring view — see all active features, agent activity, and planning artifacts at a glance |
-| **Shadow Engineering** | Monitor existing workflows before transitioning to AI-driven development |
-| **Real-Time Dashboard** | Socket.io push with multi-layer caching (in-memory + SQLite) for instant loads |
-| **Legacy Codebase Support** | AI self-monitoring skills that learn from your codebase |
+---
 
 ## Supported Tools
 
 | Tool | Support |
 |:-----|:--------|
-| **Claude Code** | Full support |
+| **Claude Code** | Full support — agent runtime, hooks, skills |
 | **Codex** | Skills sync |
 | **Cursor** | Skills sync |
 | **Gemini CLI** | Skills sync |
@@ -72,133 +107,7 @@
 
 ---
 
-## Legacy Codebase Support
-
-> **"AI works great on greenfield projects, but it's hopeless on our legacy code."**
->
-> Sound familiar? Your developers aren't wrong. But they're not stuck, either.
-
-### The Problem Every Enterprise Faces
-
-AI coding assistants are trained on modern, well-documented open-source code. When they encounter your 15-year-old monolith with:
-
-- Mixed naming conventions (some `snake_case`, some `camelCase`, some `SCREAMING_CASE`)
-- Undocumented tribal knowledge ("we never touch the `processUser()` function directly")
-- Schemas that don't match the ORM ("the `accounts` table is actually users")
-- Three different async patterns in the same codebase
-- Build systems that require arcane incantations
-
-...they stumble. Repeatedly. Every session starts from zero.
-
-### Panopticon's Unique Solution: Adaptive Learning
-
-Panopticon includes two AI self-monitoring skills that **no other orchestration framework provides**:
-
-| Skill | What It Does | Business Impact |
-|-------|--------------|-----------------|
-| **Knowledge Capture** | Detects when AI makes mistakes or gets corrected, prompts to document the learning | AI gets smarter about YOUR codebase over time |
-| **Refactor Radar** | Identifies systemic code issues causing repeated AI confusion, creates actionable proposals | Surfaces technical debt that's costing you AI productivity |
-
-#### How It Works
-
-```
-Session 1: AI queries users.created_at → Error (column is "createdAt")
-           → Knowledge Capture prompts: "Document this convention?"
-           → User: "Yes, create skill"
-           → Creates project-specific skill documenting naming conventions
-
-Session 2: AI knows to use camelCase for this project
-           No more mistakes on column names
-
-Session 5: Refactor Radar detects: "Same entity called 'user', 'account', 'member'
-           across layers - this is causing repeated confusion"
-           → Offers to create issue with refactoring proposal
-           → Tech lead reviews and schedules cleanup sprint
-```
-
-#### The Compound Effect
-
-| Week | Without Panopticon | With Panopticon |
-|------|-------------------|-----------------|
-| 1 | AI makes 20 mistakes/day on conventions | AI makes 20 mistakes, captures 8 learnings |
-| 2 | AI makes 20 mistakes/day (no memory) | AI makes 12 mistakes, captures 5 more |
-| 4 | AI makes 20 mistakes/day (still no memory) | AI makes 3 mistakes, codebase improving |
-| 8 | Developers give up on AI for legacy code | AI is productive, tech debt proposals in backlog |
-
-#### Shared Team Knowledge
-
-**When one developer learns, everyone benefits.**
-
-Captured skills live in your project's `.claude/skills/` directory - they're version-controlled alongside your code. When Sarah documents that "we use camelCase columns" after hitting that error, every developer on the team - and every AI session from that point forward - inherits that knowledge automatically.
-
-```
-myproject/
-├── .claude/skills/
-│   └── project-knowledge/     # ← Git-tracked, shared by entire team
-│       └── SKILL.md           # "Database uses camelCase, not snake_case"
-├── src/
-└── ...
-```
-
-No more repeating the same corrections to AI across 10 different developers. No more tribal knowledge locked in one person's head. The team's collective understanding of your codebase becomes permanent, searchable, and automatically applied.
-
-**New hire onboarding?** The AI already knows your conventions from day one.
-
-#### For Technical Leaders
-
-**What gets measured gets managed.** Panopticon's Refactor Radar surfaces the specific patterns that are costing you AI productivity:
-
-- "Here are the 5 naming inconsistencies causing 40% of AI errors"
-- "These 3 missing FK constraints led to 12 incorrect deletions last month"
-- "Mixed async patterns in payments module caused 8 rollbacks"
-
-Each proposal includes:
-- **Evidence**: Specific file paths and examples
-- **Impact**: How this affects AI (and new developers)
-- **Migration path**: Incremental fix that won't break production
-
-#### For Executives
-
-**ROI is simple:**
-
-- $200K/year senior developer spends 2 hours/day correcting AI on legacy code
-- That's $50K/year in wasted productivity per developer
-- Team of 10 = **$500K/year** in AI friction
-
-Panopticon's learning system:
-- Captures corrections once, applies them forever
-- Identifies root causes (not just symptoms)
-- Creates actionable improvement proposals
-- Works across your entire AI toolchain (Claude, Codex, Cursor, Gemini)
-
-**This isn't "AI for greenfield only." This is AI that learns your business.**
-
-#### Configurable Per Team and Per Developer
-
-Different teams have different ownership boundaries. Individual developers have different preferences. Panopticon respects both:
-
-```markdown
-# In ~/.claude/CLAUDE.md (developer's personal config)
-
-## AI Suggestion Preferences
-
-### refactor-radar
-skip: database-migrations, infrastructure  # DBA/Platform team handles these
-welcome: naming, code-organization         # Always happy for these
-
-### knowledge-capture
-skip: authentication                       # Security team owns this
-```
-
-- **"Skip database migrations"** - Your DBA has a change management process
-- **"Skip infrastructure"** - Platform team owns that
-- **"Welcome naming fixes"** - Low risk, high value, always appreciated
-
-The AI adapts to your org structure, not the other way around.
-
----
-
-## 🚀 Quick Start
+## Quick Start
 
 ```bash
 npm install -g panopticon-cli && pan install && pan sync && pan up
@@ -206,11 +115,9 @@ npm install -g panopticon-cli && pan install && pan sync && pan up
 
 **That's it!** Dashboard runs at https://pan.localhost (or http://localhost:3010 if you skip HTTPS setup).
 
-📖 **[Full documentation →](docs/INDEX.md)**
-
 ---
 
-## 📋 Requirements
+## Requirements
 
 ### Required
 - Node.js 18+
@@ -222,14 +129,12 @@ npm install -g panopticon-cli && pan install && pan sync && pan up
 
 ### Optional
 - **mkcert** - For HTTPS certificates (recommended)
-- **Linear API key** - For issue tracking
+- **Linear API key** - For Linear issue tracking
 - **Beads CLI** - Auto-installed by `pan install`
 
-📖 **[Platform support and detailed requirements →](docs/USAGE.md#requirements)**
-
 ---
 
-## 🔧 Configuration
+## Configuration
 
 ```bash
 # Create config file
@@ -246,49 +151,27 @@ Register your projects:
 pan project add /path/to/your/project --name myproject
 ```
 
-📖 **[Complete configuration guide →](docs/CONFIGURATION.md)**
-📖 **[Work types and model routing →](docs/WORK-TYPES.md)**
-📖 **[Detailed usage examples →](docs/USAGE.md)**
-
 ---
 
-## 🎯 Key Concepts
+## Key Concepts
 
-### Mission Control
-The default landing view. A two-panel layout with a resizable sidebar showing your project tree (grouped by project, filtered to active features) and a main area displaying agent activity, planning artifacts (PRD, STATE.md, transcripts, discussions), and status reviews.
+**Mission Control** — The default view. Project tree on the left, agent activity on the right. Click a feature to see its full pipeline: planning, work, review, test results. Badge bar gives quick access to PRDs, state files, discussions, and transcripts.
 
-- **Project Tree**: Features grouped by project with live state labels (In Progress, Suspended, In Review, Done, Planning, Idle)
-- **Activity View**: Chronological agent sessions with tail-anchored scrolling — click a feature and see what the agent is doing right now
-- **Badge Bar**: Quick access to PRD, STATE.md, discussions, transcripts, status reviews, and file uploads
-- **Status Reviews**: On-demand AI-generated progress reports comparing code changes against the PRD
+**Cloister** — The lifecycle manager. Routes tasks to models based on capabilities, detects stuck agents, triggers specialist handoffs, and tracks costs.
 
-### Shadow Engineering
-A mode for teams adopting AI incrementally. Register existing projects as "shadow" workspaces to monitor ongoing development without AI agents making changes.
+**Workspaces** — Git worktree-based feature branches with optional Docker isolation. Each issue gets its own isolated environment. Supports both local and remote (exe.dev) execution.
 
-- Create shadow features with `pan workspace create --shadow PAN-XXX`
-- Upload meeting transcripts and notes via the Badge Bar
-- Sync issue tracker discussions automatically
-- Generate inference documents (INFERENCE.md) analyzing how AI would approach the work
-- Transition from monitoring to AI-driven development when ready
+**Specialists** — Dedicated agents for code review, testing, and merging. Triggered automatically by Cloister when an agent signals completion. The pipeline is fully automated — code review to merge with zero human intervention (except the final merge click).
 
-### Multi-Agent Orchestration
-Spawn and manage AI agents in tmux sessions, monitored by the Cloister lifecycle manager.
+**Convoys** — Run parallel agents on related issues. Useful for security audits, performance reviews, or breaking an epic into concurrent work streams. Results are auto-synthesized.
 
-### Workspaces
-Git worktree-based feature branches with optional Docker isolation. Supports both local and remote (exe.dev) execution.
+**Skills** — Universal SKILL.md format works across Claude Code, Codex, Cursor, and Gemini. 67+ skills ship out of the box covering development workflows, code review, incident response, and more.
 
-### Specialists
-Dedicated agents for code review, testing, and merging. Automatically triggered by the Cloister manager.
-
-### Skills
-Universal SKILL.md format works across Claude Code, Codex, Cursor, and Gemini. Distributed via `pan sync`.
-
-📖 **[Architecture overview →](AGENTS.md)**
-📖 **[Specialist workflow →](docs/SPECIALIST_WORKFLOW.md)**
+**Shadow Engineering** — Monitor existing workflows before transitioning to AI-driven development. Upload transcripts, sync discussions, generate inference documents.
 
 ---
 
-## 🛠️ Common Commands
+## Common Commands
 
 ```bash
 # Start dashboard
@@ -307,11 +190,21 @@ pan logs agent-pan-123
 pan down
 ```
 
-📖 **[Complete command reference →](docs/USAGE.md#commands)**
+---
+
+## Maturity
+
+Panopticon is actively used in production to develop itself and multiple other projects.
+
+- **62 PRDs** written (16 active, 46 completed)
+- **67+ skills** shipped and synced across tools
+- **5 tracker integrations** (GitHub, Linear, GitLab, Jira, Rally)
+- **6 AI providers** with capability-based model routing
+- **v0.4.33** — hundreds of issues completed through the full pipeline
 
 ---
 
-## 📚 Documentation
+## Documentation
 
 | Document | Description |
 |----------|-------------|
@@ -319,32 +212,25 @@ pan down
 | [docs/USAGE.md](docs/USAGE.md) | Detailed usage guide, examples, troubleshooting |
 | [docs/CONFIGURATION.md](docs/CONFIGURATION.md) | Model routing, API setup, presets |
 | [AGENTS.md](AGENTS.md) | Agent architecture |
-| [docs/ARCHITECTURE-CACHING.md](docs/ARCHITECTURE-CACHING.md) | Dashboard caching and real-time push |
+| [docs/SPECIALIST_WORKFLOW.md](docs/SPECIALIST_WORKFLOW.md) | Review, test, merge pipeline |
+| [docs/LEGACY-CODEBASE.md](docs/LEGACY-CODEBASE.md) | AI adaptive learning for legacy codebases |
 | [CONTRIBUTING.md](CONTRIBUTING.md) | Contribution guidelines |
 | [CLAUDE.md](CLAUDE.md) | Agent development guidance |
-| [docs/MISSION-CONTROL.md](docs/MISSION-CONTROL.md) | Mission Control and Shadow Engineering guide |
 
 ---
 
-## 🤝 Contributing
+## Contributing
 
 Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ---
 
-## ⭐ Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=eltmon/panopticon-cli&type=Date)](https://star-history.com/#eltmon/panopticon-cli&Date)
-
----
-
-## ⚖️ License
+## License
 
 MIT License - see [LICENSE](LICENSE) for details.
 
 ---
 
 <div align="center">
-<p><strong>Made with ❤️ by the Panopticon team</strong></p>
 <p><a href="https://github.com/eltmon/panopticon-cli">GitHub</a> · <a href="https://www.npmjs.com/package/panopticon-cli">npm</a> · <a href="docs/INDEX.md">Documentation</a></p>
 </div>

package/dist/{agents-BDFHF4T3.js → agents-E43Y3HNU.js}

@@ -4,6 +4,7 @@ import {
   detectCrashedAgents,
   getActivity,
   getAgentDir,
+  getAgentRuntimeFile,
   getAgentRuntimeState,
   getAgentState,
   getSessionId,
@@ -17,12 +18,13 @@ import {
   saveSessionId,
   spawnAgent,
   stopAgent
-} from "./chunk-XP2DXWYP.js";
-import "./chunk-VIWUCJ4V.js";
-import "./chunk-LYSBSZYV.js";
-import "./chunk-BBCUK6N2.js";
-import "./chunk-VU4FLXV5.js";
-import "./chunk-6HXKTOD7.js";
+} from "./chunk-HZT2AOPN.js";
+import "./chunk-FTCPTHIJ.js";
+import "./chunk-NTO3EDB3.js";
+import "./chunk-HJSM6E6U.js";
+import "./chunk-FQ66DECN.js";
+import "./chunk-CFCUOV3Q.js";
+import "./chunk-ZTFNYOC7.js";
 import "./chunk-ZHC57RCV.js";
 init_agents();
 export {
@@ -31,6 +33,7 @@ export {
   detectCrashedAgents,
   getActivity,
   getAgentDir,
+  getAgentRuntimeFile,
   getAgentRuntimeState,
   getAgentState,
   getSessionId,
@@ -44,4 +47,4 @@ export {
   spawnAgent,
   stopAgent
 };
-//# sourceMappingURL=agents-BDFHF4T3.js.map
+//# sourceMappingURL=agents-E43Y3HNU.js.map

package/dist/chunk-7SN4L4PH.js

@@ -0,0 +1,150 @@
+import {
+  init_workspace_config,
+  replacePlaceholders
+} from "./chunk-CWELWPWQ.js";
+import {
+  __esm,
+  init_esm_shims
+} from "./chunk-ZHC57RCV.js";
+
+// src/lib/hume.ts
+async function humeFetch(path, apiKey, method = "GET", body) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT);
+  try {
+    const resp = await fetch(`${HUME_API}${path}`, {
+      method,
+      headers: {
+        "X-Hume-Api-Key": apiKey,
+        "Content-Type": "application/json"
+      },
+      body: body ? JSON.stringify(body) : void 0,
+      signal: controller.signal
+    });
+    if (resp.status === 204) {
+      return { ok: true, status: 204, data: null };
+    }
+    const json = await resp.json();
+    return { ok: resp.ok, status: resp.status, data: json };
+  } catch (err) {
+    return { ok: false, status: 0, data: { message: err.message } };
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function createHumeConfig(config, placeholders) {
+  const steps = [];
+  const apiKey = process.env[config.api_key_env || "HUME_API_KEY"];
+  if (!apiKey) {
+    return { success: false, steps: [`[hume] API key not found in env var ${config.api_key_env || "HUME_API_KEY"}`] };
+  }
+  const configName = replacePlaceholders(config.name_pattern, placeholders);
+  const byollmUrl = replacePlaceholders(config.byollm_url_pattern, placeholders);
+  steps.push(`[hume] Target config: ${configName}`);
+  steps.push(`[hume] BYOLLM URL: ${byollmUrl}`);
+  const listResult = await humeFetch(`/configs?name=${encodeURIComponent(configName)}`, apiKey);
+  if (listResult.ok) {
+    const configs = listResult.data?.configs_page ?? [];
+    const existing = Array.isArray(configs) ? configs.find((c) => c.name === configName) : null;
+    if (existing) {
+      steps.push(`[hume] Config "${configName}" already exists (ID: ${existing.id}), skipping creation`);
+      return { success: true, steps, configId: existing.id, configName };
+    }
+  }
+  const templateResult = await humeFetch(`/configs/${config.template_config_id}`, apiKey);
+  if (!templateResult.ok) {
+    steps.push(`[hume] Failed to get template config ${config.template_config_id}: ${JSON.stringify(templateResult.data)}`);
+    return { success: false, steps };
+  }
+  const templatePage = templateResult.data?.configs_page;
+  const template = Array.isArray(templatePage) ? templatePage[0] : templateResult.data;
+  if (!template || !template.id) {
+    steps.push(`[hume] Template config ${config.template_config_id} not found in response`);
+    return { success: false, steps };
+  }
+  steps.push(`[hume] Read template config: ${template.name || config.template_config_id}`);
+  const newConfig = {
+    name: configName,
+    evi_version: template.evi_version || "3",
+    language_model: {
+      model_provider: "CUSTOM_LANGUAGE_MODEL",
+      model_resource: byollmUrl
+    }
+  };
+  if (template.voice) {
+    newConfig.voice = template.voice;
+  }
+  if (template.prompt) {
+    newConfig.prompt = template.prompt;
+  }
+  if (template.event_messages) {
+    newConfig.event_messages = template.event_messages;
+  }
+  if (template.timeouts) {
+    newConfig.timeouts = template.timeouts;
+  }
+  if (template.tools) {
+    newConfig.tools = template.tools;
+  }
+  if (template.builtin_tools) {
+    newConfig.builtin_tools = template.builtin_tools;
+  }
+  if (template.ellm_model) {
+    newConfig.ellm_model = template.ellm_model;
+  }
+  const createResult = await humeFetch("/configs", apiKey, "POST", newConfig);
+  if (!createResult.ok) {
+    steps.push(`[hume] Failed to create config: ${JSON.stringify(createResult.data)}`);
+    return { success: false, steps };
+  }
+  const newId = createResult.data?.id;
+  steps.push(`[hume] Created config "${configName}" (ID: ${newId})`);
+  return { success: true, steps, configId: newId, configName };
+}
+async function deleteHumeConfig(config, placeholders) {
+  const steps = [];
+  const apiKey = process.env[config.api_key_env || "HUME_API_KEY"];
+  if (!apiKey) {
+    return { success: false, steps: [`[hume] API key not found in env var ${config.api_key_env || "HUME_API_KEY"}`] };
+  }
+  const configName = replacePlaceholders(config.name_pattern, placeholders);
+  steps.push(`[hume] Looking for config: ${configName}`);
+  const listResult = await humeFetch(`/configs?name=${encodeURIComponent(configName)}`, apiKey);
+  if (!listResult.ok) {
+    steps.push(`[hume] Failed to list configs: ${JSON.stringify(listResult.data)}`);
+    return { success: false, steps };
+  }
+  const configs = listResult.data?.configs_page ?? [];
+  const matches = Array.isArray(configs) ? configs.filter((c) => c.name === configName) : [];
+  if (matches.length === 0) {
+    steps.push(`[hume] No config found with name "${configName}"`);
+    return { success: true, steps };
+  }
+  let allOk = true;
+  for (const match of matches) {
+    const delResult = await humeFetch(`/configs/${match.id}`, apiKey, "DELETE");
+    if (delResult.ok) {
+      steps.push(`[hume] Deleted config "${configName}" (ID: ${match.id})`);
+    } else {
+      steps.push(`[hume] Failed to delete config ${match.id}: ${JSON.stringify(delResult.data)}`);
+      allOk = false;
+    }
+  }
+  return { success: allOk, steps };
+}
+var HUME_API, FETCH_TIMEOUT;
+var init_hume = __esm({
+  "src/lib/hume.ts"() {
+    init_esm_shims();
+    init_workspace_config();
+    HUME_API = "https://api.hume.ai/v0/evi";
+    FETCH_TIMEOUT = 15e3;
+  }
+});
+
+export {
+  createHumeConfig,
+  deleteHumeConfig,
+  init_hume
+};
+//# sourceMappingURL=chunk-7SN4L4PH.js.map

package/dist/chunk-7SN4L4PH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/hume.ts"],"sourcesContent":["/**\n * Hume EVI Config Management\n *\n * Manages per-workspace Hume EVI configs for BYOLLM (Bring Your Own LLM).\n * Called during workspace create (createHumeConfig) and workspace remove/deep-wipe (deleteHumeConfig).\n *\n * Pattern mirrors tunnel.ts — stateless CRUD against external API.\n */\n\nimport { HumeConfig, TemplatePlaceholders, replacePlaceholders } from './workspace-config.js';\n\nexport interface HumeResult {\n  success: boolean;\n  steps: string[];\n  /** Populated on successful create */\n  configId?: string;\n  configName?: string;\n}\n\nconst HUME_API = 'https://api.hume.ai/v0/evi';\nconst FETCH_TIMEOUT = 15_000;\n\n/**\n * Make an authenticated Hume API request.\n * Auth via X-Hume-Api-Key header.\n */\nasync function humeFetch(\n  path: string,\n  apiKey: string,\n  method: 'GET' | 'POST' | 'DELETE' = 'GET',\n  body?: unknown,\n): Promise<{ ok: boolean; status: number; data: any }> {\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT);\n\n  try {\n    const resp = await fetch(`${HUME_API}${path}`, {\n      method,\n      headers: {\n        'X-Hume-Api-Key': apiKey,\n        'Content-Type': 'application/json',\n      },\n      body: body ? JSON.stringify(body) : undefined,\n      signal: controller.signal,\n    });\n\n    // DELETE returns 204 No Content\n    if (resp.status === 204) {\n      return { ok: true, status: 204, data: null };\n    }\n\n    const json = await resp.json();\n    return { ok: resp.ok, status: resp.status, data: json };\n  } catch (err: any) {\n    return { ok: false, status: 0, data: { message: err.message } };\n  } finally {\n    clearTimeout(timeout);\n  }\n}\n\n/**\n * Create a workspace-specific Hume EVI config by cloning the template config.\n *\n * Steps:\n * 1. Resolve config name from name_pattern with placeholders\n * 2. Check if config already exists (idempotent)\n * 3. GET template config to extract voice, prompt, tools, etc.\n * 4. POST new config with workspace-specific BYOLLM URL\n */\nexport async function createHumeConfig(\n  config: HumeConfig,\n  placeholders: TemplatePlaceholders,\n): Promise<HumeResult> {\n  const steps: string[] = [];\n\n  // Resolve API key\n  const apiKey = process.env[config.api_key_env || 'HUME_API_KEY'];\n  if (!apiKey) {\n    return { success: false, steps: [`[hume] API key not found in env var ${config.api_key_env || 'HUME_API_KEY'}`] };\n  }\n\n  // Resolve config name and BYOLLM URL\n  const configName = replacePlaceholders(config.name_pattern, placeholders);\n  const byollmUrl = replacePlaceholders(config.byollm_url_pattern, placeholders);\n  steps.push(`[hume] Target config: ${configName}`);\n  steps.push(`[hume] BYOLLM URL: ${byollmUrl}`);\n\n  // Check if config already exists (idempotent)\n  const listResult = await humeFetch(`/configs?name=${encodeURIComponent(configName)}`, apiKey);\n  if (listResult.ok) {\n    const configs = listResult.data?.configs_page ?? [];\n    const existing = Array.isArray(configs)\n      ? configs.find((c: any) => c.name === configName)\n      : null;\n    if (existing) {\n      steps.push(`[hume] Config \"${configName}\" already exists (ID: ${existing.id}), skipping creation`);\n      return { success: true, steps, configId: existing.id, configName };\n    }\n  }\n\n  // GET template config (API returns paginated format even for single-config lookup)\n  const templateResult = await humeFetch(`/configs/${config.template_config_id}`, apiKey);\n  if (!templateResult.ok) {\n    steps.push(`[hume] Failed to get template config ${config.template_config_id}: ${JSON.stringify(templateResult.data)}`);\n    return { success: false, steps };\n  }\n\n  // Extract config from paginated response\n  const templatePage = templateResult.data?.configs_page;\n  const template = Array.isArray(templatePage) ? templatePage[0] : templateResult.data;\n  if (!template || !template.id) {\n    steps.push(`[hume] Template config ${config.template_config_id} not found in response`);\n    return { success: false, steps };\n  }\n  steps.push(`[hume] Read template config: ${template.name || config.template_config_id}`);\n\n  // Build new config payload — clone template but override name and BYOLLM URL\n  const newConfig: Record<string, any> = {\n    name: configName,\n    evi_version: template.evi_version || '3',\n    language_model: {\n      model_provider: 'CUSTOM_LANGUAGE_MODEL',\n      model_resource: byollmUrl,\n    },\n  };\n\n  // Preserve voice from template\n  if (template.voice) {\n    newConfig.voice = template.voice;\n  }\n\n  // Preserve prompt from template\n  if (template.prompt) {\n    newConfig.prompt = template.prompt;\n  }\n\n  // Preserve event messages from template\n  if (template.event_messages) {\n    newConfig.event_messages = template.event_messages;\n  }\n\n  // Preserve timeouts from template\n  if (template.timeouts) {\n    newConfig.timeouts = template.timeouts;\n  }\n\n  // Preserve tools from template\n  if (template.tools) {\n    newConfig.tools = template.tools;\n  }\n\n  // Preserve builtin_tools from template\n  if (template.builtin_tools) {\n    newConfig.builtin_tools = template.builtin_tools;\n  }\n\n  // Preserve ellm_model (quick responses) from template\n  if (template.ellm_model) {\n    newConfig.ellm_model = template.ellm_model;\n  }\n\n  // Create new config\n  const createResult = await humeFetch('/configs', apiKey, 'POST', newConfig);\n  if (!createResult.ok) {\n    steps.push(`[hume] Failed to create config: ${JSON.stringify(createResult.data)}`);\n    return { success: false, steps };\n  }\n\n  const newId = createResult.data?.id;\n  steps.push(`[hume] Created config \"${configName}\" (ID: ${newId})`);\n\n  return { success: true, steps, configId: newId, configName };\n}\n\n/**\n * Delete a workspace-specific Hume EVI config.\n *\n * Steps:\n * 1. List configs matching the workspace name\n * 2. DELETE each match\n */\nexport async function deleteHumeConfig(\n  config: HumeConfig,\n  placeholders: TemplatePlaceholders,\n): Promise<HumeResult> {\n  const steps: string[] = [];\n\n  // Resolve API key\n  const apiKey = process.env[config.api_key_env || 'HUME_API_KEY'];\n  if (!apiKey) {\n    return { success: false, steps: [`[hume] API key not found in env var ${config.api_key_env || 'HUME_API_KEY'}`] };\n  }\n\n  const configName = replacePlaceholders(config.name_pattern, placeholders);\n  steps.push(`[hume] Looking for config: ${configName}`);\n\n  // List configs matching the name\n  const listResult = await humeFetch(`/configs?name=${encodeURIComponent(configName)}`, apiKey);\n  if (!listResult.ok) {\n    steps.push(`[hume] Failed to list configs: ${JSON.stringify(listResult.data)}`);\n    return { success: false, steps };\n  }\n\n  const configs = listResult.data?.configs_page ?? [];\n  const matches = Array.isArray(configs)\n    ? configs.filter((c: any) => c.name === configName)\n    : [];\n\n  if (matches.length === 0) {\n    steps.push(`[hume] No config found with name \"${configName}\"`);\n    return { success: true, steps };\n  }\n\n  let allOk = true;\n  for (const match of matches) {\n    const delResult = await humeFetch(`/configs/${match.id}`, apiKey, 'DELETE');\n    if (delResult.ok) {\n      steps.push(`[hume] Deleted config \"${configName}\" (ID: ${match.id})`);\n    } else {\n      steps.push(`[hume] Failed to delete config ${match.id}: ${JSON.stringify(delResult.data)}`);\n      allOk = false;\n    }\n  }\n\n  return { success: allOk, steps };\n}\n"],"mappings":"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","names":[]}