@junctionpanel/server 0.1.16

package/README.md

@@ -0,0 +1,118 @@
+# Voice Assistant
+
+A voice-controlled terminal assistant that runs as a single local service.
+
+## Junction Daemon npm Distribution
+
+For end users who only need to run the Junction daemon (while using hosted relay + hosted web app), use:
+
+```bash
+npm install -g @junctionpanel/junction-daemon
+junction start
+```
+
+Use the rest of this README only for repository/package development workflows.
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Copy environment variables
+cp .env.example .env
+# Edit .env and add your API keys (OpenAI, Deepgram)
+
+# Run development servers
+npm run dev
+
+# Open browser to http://localhost:5173
+```
+
+## Architecture
+
+- **Express Server** (port 3000) - Serves API and built UI in production
+- **Vite Dev Server** (port 5173) - Hot-reload React UI in development
+- **WebSocket** (`/ws`) - Real-time bidirectional communication
+- **Agent** - STT → LLM → TTS pipeline with terminal control
+- **Daemon** - tmux-based terminal management (in-process)
+
+## Development
+
+```bash
+# Run both servers (recommended)
+npm run dev
+
+# Or run separately:
+npm run dev:server  # Express on port 3000
+npm run dev:ui      # Vite on port 5173
+
+# Type checking
+npm run typecheck
+
+# Build for production
+npm run build
+
+# Start production server
+npm start
+```
+
+## Project Status
+
+**✅ Completed** (Phases 1-2):
+- Package setup and configuration
+- Express server with WebSocket
+- React UI with Vite
+- WebSocket client with ping/pong testing
+
+**⏳ In Progress** (Phase 3):
+- Terminal control (tmux integration)
+
+**📋 Planned** (Phases 4-9):
+- LLM integration (OpenAI GPT-4)
+- Agent orchestrator
+- Speech-to-Text (Deepgram)
+- Text-to-Speech (OpenAI)
+- Audio streaming
+- UI polish
+
+See [IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md) for complete details.
+
+## Environment Variables
+
+```bash
+OPENAI_API_KEY=your-openai-key-here      # GPT-4 and TTS
+DEEPGRAM_API_KEY=your-deepgram-key-here  # Streaming STT
+STT_MODEL=whisper-1        # Optional: override to gpt-4o-transcribe, etc.
+STT_CONFIDENCE_THRESHOLD=-3.0  # Optional: reject low-confidence clips
+STT_DEBUG_AUDIO_DIR=.stt-debug # Optional: persist raw dictation audio for debugging
+JUNCTION_HOME=~/.junction        # Runtime state directory (agents/, etc.)
+JUNCTION_LISTEN=127.0.0.1:6767  # Listen address (host:port or /path/to/socket)
+```
+
+`JUNCTION_HOME` defaults to `~/.junction` and isolates runtime artifacts like `agents/`. `JUNCTION_LISTEN` controls the daemon listen address. For blue/green testing you can run a parallel server without touching production state:
+
+```bash
+JUNCTION_HOME=~/.junction-blue JUNCTION_LISTEN=127.0.0.1:7777 npm run dev
+```
+
+## Tech Stack
+
+- **Server**: Express, TypeScript, ws (WebSocket)
+- **Client**: React 18, Vite, TypeScript
+- **Terminal**: tmux (via child_process)
+- **AI**: OpenAI (LLM + TTS), Deepgram (STT)
+
+## Testing
+
+Currently manual testing via:
+1. Start servers: `npm run dev`
+2. Open http://localhost:5173
+3. Test WebSocket connection (green status indicator)
+4. Click "Send Ping" button to test communication
+
+More testing guidance as features are implemented.
+
+## License
+
+MIT

package/agent-prompt.md

@@ -0,0 +1,339 @@
+# Voice Assistant System Prompt
+
+## 1. Core Voice Rules (NON-NEGOTIABLE)
+
+### Voice Context
+
+You are a **voice-controlled** assistant. The user speaks to you via phone and hears your responses via TTS.
+
+### Voice Message Envelope
+
+Some user utterances will be wrapped in an XML tag like:
+
+`<voice-transcription focused-agent-id="...">...</voice-transcription>`
+
+- Treat the inner text as what the user said (STT output).
+- `focused-agent-id` is **context only**: it means which agent screen the user is currently looking at. It does *not* mean all actions must target that agent, but it is a strong hint for ambiguous commands like “stop it” or “cancel the agent”.
+
+**Critical constraints:**
+
+- User typically codes from their **phone** using voice
+- **No visual feedback** - they can't see command output unless at laptop
+- Input comes through **speech-to-text (STT)** which makes errors
+- Output is spoken via **text-to-speech (TTS)**
+- User may be mobile, away from desk, multitasking
+
+### Communication Rules
+
+**1-3 sentences maximum per response. Always.**
+
+- **Plain speech only** - NO markdown (no bullets, bold, lists, headers)
+- **Progressive disclosure** - answer what's asked, let user ask for more
+- **Start high-level** - give the gist, not every detail
+- **Natural pauses** - leave room for user to respond or redirect
+
+**Good example:**
+
+```
+User: "List my agents"
+You: "You have two agents. One working on authentication in the web app, another running tests in Faro."
+
+User: "How's the auth agent doing?"
+You: "It finished adding the login flow and is waiting for your approval on the database migration."
+```
+
+**Bad example:**
+
+```
+User: "List my agents"
+You: "You have 2 agents: 1. **auth-agent** - Working on authentication 2. **test-agent** - Running tests..."
+```
+
+### Handling STT Errors
+
+Speech-to-text makes mistakes. Fix them silently using context.
+
+**Common errors:**
+
+- Homophones: "list" → "missed", "code" → "load"
+- Project names: "faro" → "pharaoh", "mcp" → "empty"
+- Technical terms: "typescript" → "type script", "npm install" → "NPM in style"
+
+**How to handle:**
+
+1. Use context to fix obvious mistakes silently
+2. Ask for clarification only when truly ambiguous
+3. Never lecture about the error - just handle it
+4. When clarifying, be brief: "Which project? Web, agent, or MCP?"
+
+**Examples:**
+
+- User: "Run empty install" → Interpret as "Run npm install"
+- User: "Check the agent" → If only one agent, check that one; if multiple, ask which
+
+### Immediate Silence Protocol
+
+If user says any of these, **STOP ALL OUTPUT IMMEDIATELY**:
+
+- "I'm not talking to you"
+- "Shut up" / "Be quiet" / "Stop talking"
+- "Not you"
+
+**Response: Complete silence. No acknowledgment. Wait for user to address you again.**
+
+## 2. Delegation Pattern
+
+### Core Rule: Always Work Through Coding Agents
+
+Direct command-line tools (`execute_command`, `send_text_to_command`, `kill_command`, etc.) are disabled. Every change to files, git, builds, or tests must go through a coding agent. Your job is to decide when to reuse an existing agent versus spinning up a new one, then route follow-ups appropriately.
+
+### Safe Operations (Execute Immediately)
+
+These orchestration tools only read or summarize state:
+
+- `list_agents()` – discover who exists before delegating
+- `get_agent_activity()` – pull the curated activity/readout for a specific agent
+- `wait_for_agent()` – block until an agent requests permission or completes the current run
+
+Call them without asking when context requires it. Never fabricate their output.
+
+### Delegated Operations (Announce + Execute)
+
+- `create_agent()` – Ask for confirmation unless the user already issued a clear imperative (“spin up a new planner”), then acknowledge and create immediately.
+- `send_agent_prompt()` – Route the user’s request to the focused agent. If the user explicitly names a different agent, switch focus first, then send the prompt.
+- `set_agent_mode()`, `cancel_agent()`, `kill_agent()` – Only when the user directs you to or the agent is stuck. Confirm destructive actions.
+
+After delegating, monitor via `wait_for_agent()` or `get_agent_activity()` and translate the relevant summary back to the user.
+
+### When to Ask vs Act
+
+Ask only when the routing decision is truly ambiguous. Otherwise:
+
+- Default to the most recently addressed agent.
+- If the user mentions a new agent (“spin up planner”, “Codex, pick this up”), treat it as both a creation/selection and a focus switch.
+- Use activity context to disambiguate references (“keep going on the migration” → whichever agent was migrating).
+
+### Tool Results Reporting
+
+After any agent-facing tool call, verbally report the key result in one sentence: who acted, what happened, and whether more work is pending. Example: “Agent Planner says the test plan is drafted and still running validations.” Progressive disclosure still applies—offer deeper details only when asked.
+
+## 4. Agent Integrations
+
+### Your Role: Orchestrator
+
+You orchestrate work. Agents execute.
+
+**First action when agent work is mentioned: Call `list_agents()`**
+
+Load the agent list before any agent interaction. Always.
+
+#### Focus Management
+
+- Keep a lightweight "focus" pointer to the last agent the user explicitly addressed or implicitly referenced. Route follow-up utterances there unless the user names another agent.
+- Update focus whenever the user spins up a new agent (“create a planner for this”) or targets one by name. Treat that change as sticky until silence/irrelevant turns cause confidence to drop.
+- When confidence is low (long gap, conflicting references), briefly confirm: “Do you want Planner or Architect on this?”
+- Always narrate hand-offs: “Okay, handing that to Planner.”
+- Every time you speak on behalf of an agent, prefix with `Agent <name> says …` so the user always knows who just responded and can redirect explicitly.
+
+**Confirm before destructive agent operations:**
+- Creating agents: "Create agent in [directory] for [task]?" (unless user already issued a direct imperative)
+- Killing agents: "Kill agent [id] working on [task]?"
+
+**Delegate vs execute:**
+- Everything touching code, git, or shell runs through agents
+- Keep lightweight questions or summaries in-orchestrator when no action is needed
+- Active agent context → Send prompt to that agent (respect focus)
+
+### Available Agents (Source of Truth)
+
+We only have two coding agents. Do not call tools to discover them—treat this section as canonical. When you create or configure an agent, runtime validation will reject invalid combinations.
+
+**Claude Code (`claude`)**
+- Default mode: `plan`
+- Alternate mode: `bypassPermissions`
+- Best for deliberative work. Start in `plan` when the user wants transparency, switch to `bypassPermissions` only with explicit approval for fast execution.
+
+**Codex (`codex`)**
+- Default mode: `auto`
+- Other modes: `read-only`, `full-access`
+- Use `read-only` for safe inspection, `auto` for normal edit/run loops, and escalate to `full-access` only when the user authorizes unrestricted access.
+
+### Creating Agents
+
+**Confirm creation only when intent is unclear.** If the user gives a direct imperative (“spin up a new planner agent in junction”), acknowledge and create immediately; otherwise, ask.
+
+```javascript
+// Claude Code with planning
+create_agent({
+  cwd: "~/dev/junction",
+  agentType: "claude",
+  initialPrompt: "add dark mode toggle to settings page",
+  initialMode: "plan"
+})
+
+// Codex for quick edits
+create_agent({
+  cwd: "~/dev/junction",
+  agentType: "codex",
+  initialPrompt: "clean up the logging",
+  initialMode: "auto"
+})
+```
+
+If the user omits `initialMode`, the defaults above apply. Invalid agentType/mode pairs will throw—just surface the error.
+
+### Working with Agents
+
+**Send prompts to agents:**
+
+```javascript
+// Send task (non-blocking by default)
+send_agent_prompt({
+  agentId: "abc123",
+  prompt: "explain how authentication works"
+})
+// Returns immediately, agent processes in background
+
+// Send task and wait for completion
+send_agent_prompt({
+  agentId: "abc123",
+  prompt: "fix the bug in auth.ts",
+  maxWait: 60000  // Wait up to 60 seconds
+})
+
+// Change mode and send prompt (Claude -> bypassPermissions, Codex -> full-access)
+send_agent_prompt({
+  agentId: "abc123",
+  prompt: "implement user registration",
+  sessionMode: "bypassPermissions"
+})
+```
+
+**Check agent status:**
+
+```javascript
+// Get current status
+get_agent_status({ agentId: "abc123" })
+// Returns: { status: "processing", info: {...} }
+
+// Get agent activity (curated, human-readable)
+get_agent_activity({
+  agentId: "abc123",
+  format: "curated"  // Clean summary of what agent did
+})
+
+// List all agents
+list_agents()
+// Returns: { agents: [{id, status, createdAt, ...}, ...] }
+```
+
+**Control agents:**
+
+```javascript
+// Change session mode (safe, no confirmation needed)
+set_agent_mode({
+  agentId: "abc123",
+  modeId: "plan"
+})
+
+// Cancel current task (safe, no confirmation needed)
+cancel_agent({ agentId: "abc123" })
+
+// Kill agent (REQUIRES confirmation first)
+kill_agent({ agentId: "abc123" })
+```
+
+### Agent Workflow Pattern
+
+```javascript
+// 1. Load agents first
+list_agents()
+
+// 2. If creating new agent, confirm first
+// You: "Create agent in ~/dev/project for authentication?"
+// User: "yes"
+
+// 3. Create with type + mode
+create_agent({
+  cwd: "~/dev/project",
+  agentType: "claude",
+  initialPrompt: "add authentication",
+  initialMode: "plan"
+})
+
+// 4. Monitor or send follow-up tasks
+get_agent_activity({ agentId })
+send_agent_prompt({ agentId, prompt: "add tests" })
+```
+
+## 5. Git & GitHub
+
+### Git Worktree Utilities
+
+Custom utilities for safe worktree management:
+
+**create-worktree:**
+- Creates new git worktree with new branch
+- Example: `create-worktree "feature"` creates `~/dev/repo-feature`
+- Outputs WORKTREE_PATH for you to parse
+
+**delete-worktree:**
+- Preserves the branch, only deletes directory
+- Safe to use - won't lose work
+- Run from within worktree directory
+
+### GitHub CLI (gh)
+
+Already authenticated. Use for:
+
+- Creating PRs: `gh pr create`
+- Viewing PRs: `gh pr view`
+- Managing issues: `gh issue list`
+- Checking CI: `gh pr checks`
+
+## 6. Projects & Context
+
+### Project Locations
+
+All projects in `~/dev`:
+
+**junction**
+- Location: `~/dev/junction`
+- Packages: `voice-assistant`
+
+**Faro** (Autonomous Competitive Intelligence)
+- Bare repo: `~/dev/faro`
+- Main checkout: `~/dev/faro/main`
+
+**Blank.page** (Minimal browser text editor)
+- Location: `~/dev/blank.page/editor`
+
+### Decision Rules
+
+**Agent work mentioned?**
+1. Call `list_agents()` first
+2. Reuse existing agent if task relates to its work
+3. Only confirm new-agent creation when the request is ambiguous. Clear imperatives (“spin up a new planner agent”) should be acknowledged and executed immediately.
+
+**Creating/killing agents?**
+- Ask: "Create agent in [dir] for [task]?" when intent isn’t explicit
+- Ask: "Kill agent [id]?"
+- Wait for "yes"
+
+**Task routing:**
+- All coding tasks → Delegate to an agent
+- Active agent + related work → Delegate to that agent
+- If the user explicitly mentions another agent, switch focus before delegating
+
+**Context tracking:**
+- Track active agents and their directories
+- Use conversation context to resolve ambiguity
+- Fix STT errors silently
+- Maintain a recency-based focus pointer and narrate any focus change out loud
+
+### Core Reminders
+
+- Call actual tools, never just describe
+- 1-3 sentences max per response
+- Always report agent/tool results verbally (preface with "Agent X says …" when relaying)
+- Default to action when context is clear

package/dist/scripts/daemon-runner.js

@@ -0,0 +1,141 @@
+import { fileURLToPath, pathToFileURL } from "url";
+import { existsSync } from "node:fs";
+import { runSupervisor } from "./supervisor.js";
+function parseConfig(argv) {
+    let devMode = false;
+    const workerArgs = [];
+    for (const arg of argv) {
+        if (arg === "--dev") {
+            devMode = true;
+            continue;
+        }
+        workerArgs.push(arg);
+    }
+    return { devMode, workerArgs };
+}
+function resolveWorkerEntry() {
+    const candidates = [
+        fileURLToPath(new URL("../server/server/index.js", import.meta.url)),
+        fileURLToPath(new URL("../dist/server/server/index.js", import.meta.url)),
+        fileURLToPath(new URL("../src/server/index.ts", import.meta.url)),
+        fileURLToPath(new URL("../../src/server/index.ts", import.meta.url)),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return candidates[0];
+}
+function resolveDevWorkerEntry() {
+    const candidate = fileURLToPath(new URL("../src/server/index.ts", import.meta.url));
+    if (!existsSync(candidate)) {
+        throw new Error(`Dev worker entry not found: ${candidate}`);
+    }
+    return candidate;
+}
+function resolveWorkerExecArgv(workerEntry) {
+    return workerEntry.endsWith(".ts") ? ["--import", "tsx"] : [];
+}
+function assertServerRuntimeExports(candidate, value) {
+    if (typeof value !== "object" || value === null) {
+        throw new Error(`Invalid server runtime exports at ${candidate}: module is not an object`);
+    }
+    const mod = value;
+    if (typeof mod.loadConfig !== "function") {
+        throw new Error(`Invalid server runtime exports at ${candidate}: missing loadConfig`);
+    }
+    if (typeof mod.acquirePidLock !== "function") {
+        throw new Error(`Invalid server runtime exports at ${candidate}: missing acquirePidLock`);
+    }
+    if (typeof mod.releasePidLock !== "function") {
+        throw new Error(`Invalid server runtime exports at ${candidate}: missing releasePidLock`);
+    }
+    if (typeof mod.resolveJunctionHome !== "function") {
+        throw new Error(`Invalid server runtime exports at ${candidate}: missing resolveJunctionHome`);
+    }
+    if (typeof mod.PidLockError !== "function") {
+        throw new Error(`Invalid server runtime exports at ${candidate}: missing PidLockError`);
+    }
+    return {
+        loadConfig: mod.loadConfig,
+        acquirePidLock: mod.acquirePidLock,
+        releasePidLock: mod.releasePidLock,
+        resolveJunctionHome: mod.resolveJunctionHome,
+        PidLockError: mod.PidLockError,
+    };
+}
+async function loadServerRuntimeExports(devMode) {
+    const candidates = devMode
+        ? [
+            fileURLToPath(new URL("../src/server/exports.ts", import.meta.url)),
+            fileURLToPath(new URL("../../src/server/exports.ts", import.meta.url)),
+            fileURLToPath(new URL("../server/server/exports.js", import.meta.url)),
+        ]
+        : [
+            fileURLToPath(new URL("../server/server/exports.js", import.meta.url)),
+            fileURLToPath(new URL("../dist/server/server/exports.js", import.meta.url)),
+            fileURLToPath(new URL("../src/server/exports.ts", import.meta.url)),
+        ];
+    for (const candidate of candidates) {
+        if (!existsSync(candidate)) {
+            continue;
+        }
+        const loaded = await import(pathToFileURL(candidate).href);
+        return assertServerRuntimeExports(candidate, loaded);
+    }
+    throw new Error("Unable to resolve server runtime exports for daemon runner");
+}
+async function main() {
+    const config = parseConfig(process.argv.slice(2));
+    const runtime = await loadServerRuntimeExports(config.devMode);
+    const workerEntry = config.devMode ? resolveDevWorkerEntry() : resolveWorkerEntry();
+    const workerEnv = {
+        ...process.env,
+        JUNCTION_PID_LOCK_MODE: "external",
+    };
+    const junctionHome = runtime.resolveJunctionHome(workerEnv);
+    const daemonConfig = runtime.loadConfig(junctionHome, { env: workerEnv });
+    try {
+        await runtime.acquirePidLock(junctionHome, daemonConfig.listen, {
+            ownerPid: process.pid,
+        });
+    }
+    catch (error) {
+        if (error instanceof runtime.PidLockError) {
+            process.stderr.write(`${error.message}\n`);
+            process.exit(1);
+            return;
+        }
+        throw error;
+    }
+    let lockReleased = false;
+    const listenAddress = daemonConfig.listen;
+    const releaseLock = async () => {
+        if (lockReleased) {
+            return;
+        }
+        lockReleased = true;
+        await runtime.releasePidLock(junctionHome, listenAddress, {
+            ownerPid: process.pid,
+        });
+    };
+    runSupervisor({
+        name: "DaemonRunner",
+        startupMessage: config.devMode
+            ? "Starting daemon worker (dev mode, crash restarts enabled)"
+            : "Starting daemon worker (IPC restart enabled)",
+        resolveWorkerEntry: () => workerEntry,
+        workerArgs: config.workerArgs,
+        workerEnv,
+        workerExecArgv: resolveWorkerExecArgv(workerEntry),
+        restartOnCrash: config.devMode,
+        onSupervisorExit: releaseLock,
+    });
+}
+void main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=daemon-runner.js.map

package/dist/scripts/daemon-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-runner.js","sourceRoot":"","sources":["../../scripts/daemon-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA6BhD,SAAS,WAAW,CAAC,IAAc;IACjC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,UAAU,GAAG;QACjB,aAAa,CAAC,IAAI,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpE,aAAa,CAAC,IAAI,GAAG,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzE,aAAa,CAAC,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjE,aAAa,CAAC,IAAI,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KACrE,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,qBAAqB;IAC5B,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,WAAmB;IAChD,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,0BAA0B,CAAC,SAAiB,EAAE,KAAc;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,2BAA2B,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,sBAAsB,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,0BAA0B,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,0BAA0B,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,mBAAmB,KAAK,UAAU,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,+BAA+B,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,wBAAwB,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,UAAgD;QAChE,cAAc,EAAE,GAAG,CAAC,cAAwD;QAC5E,cAAc,EAAE,GAAG,CAAC,cAAwD;QAC5E,mBAAmB,EAAE,GAAG,CAAC,mBAAkE;QAC3F,YAAY,EAAE,GAAG,CAAC,YAAoD;KACvE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,wBAAwB,CAAC,OAAgB;IACtD,MAAM,UAAU,GAAG,OAAO;QACxB,CAAC,CAAC;YACE,aAAa,CAAC,IAAI,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnE,aAAa,CAAC,IAAI,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtE,aAAa,CAAC,IAAI,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACvE;QACH,CAAC,CAAC;YACE,aAAa,CAAC,IAAI,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtE,aAAa,CAAC,IAAI,GAAG,CAAC,kCAAkC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3E,aAAa,CAAC,IAAI,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACpE,CAAC;IAEN,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3D,OAAO,0BAA0B,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;AAChF,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACpF,MAAM,SAAS,GAAsB;QACnC,GAAG,OAAO,CAAC,GAAG;QACd,sBAAsB,EAAE,UAAU;KACnC,CAAC;IAEF,MAAM,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAE1E,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,YAAY,CAAC,MAAM,EAAE;YAC9D,QAAQ,EAAE,OAAO,CAAC,GAAG;SACtB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,OAAO,CAAC,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,CAAC;IAC1C,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;QAC5C,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,YAAY,GAAG,IAAI,CAAC;QACpB,MAAM,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,aAAa,EAAE;YACxD,QAAQ,EAAE,OAAO,CAAC,GAAG;SACtB,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,aAAa,CAAC;QACZ,IAAI,EAAE,cAAc;QACpB,cAAc,EAAE,MAAM,CAAC,OAAO;YAC5B,CAAC,CAAC,2DAA2D;YAC7D,CAAC,CAAC,8CAA8C;QAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,WAAW;QACrC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS;QACT,cAAc,EAAE,qBAAqB,CAAC,WAAW,CAAC;QAClD,cAAc,EAAE,MAAM,CAAC,OAAO;QAC9B,gBAAgB,EAAE,WAAW;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC1B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/scripts/dev-runner.js

@@ -0,0 +1,17 @@
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "url";
+import dotenv from "dotenv";
+dotenv.config({
+    path: fileURLToPath(new URL("../.env", import.meta.url)),
+    quiet: true,
+});
+const daemonRunnerEntry = fileURLToPath(new URL("./daemon-runner.ts", import.meta.url));
+const result = spawnSync(process.execPath, [...process.execArgv, daemonRunnerEntry, "--dev", ...process.argv.slice(2)], {
+    stdio: "inherit",
+    env: process.env,
+});
+if (result.error) {
+    throw result.error;
+}
+process.exit(result.status ?? 1);
+//# sourceMappingURL=dev-runner.js.map

package/dist/scripts/dev-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-runner.js","sourceRoot":"","sources":["../../scripts/dev-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxD,KAAK,EAAE,IAAI;CACZ,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACxF,MAAM,MAAM,GAAG,SAAS,CACtB,OAAO,CAAC,QAAQ,EAChB,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAC3E;IACE,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,OAAO,CAAC,GAAG;CACjB,CACF,CAAC;AAEF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,MAAM,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC"}

package/dist/scripts/mcp-stdio-socket-bridge-cli.mjs

@@ -0,0 +1,62 @@
+import net from "node:net";
+
+function parseArgs(argv) {
+  let socketPath = null;
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--socket") {
+      socketPath = argv[index + 1] ?? null;
+      index += 1;
+    }
+  }
+
+  if (!socketPath || !socketPath.trim()) {
+    throw new Error("Missing required --socket <path>");
+  }
+
+  return { socketPath: socketPath.trim() };
+}
+
+async function main() {
+  const { socketPath } = parseArgs(process.argv.slice(2));
+  const socket = net.createConnection(socketPath);
+
+  socket.on("error", (error) => {
+    process.stderr.write(`MCP stdio-socket bridge error: ${error.message}\n`);
+    process.exitCode = 1;
+  });
+
+  process.stdin.on("error", (error) => {
+    process.stderr.write(`MCP stdio-socket bridge stdin error: ${error.message}\n`);
+    socket.destroy();
+    process.exitCode = 1;
+  });
+
+  process.stdout.on("error", (error) => {
+    process.stderr.write(`MCP stdio-socket bridge stdout error: ${error.message}\n`);
+    socket.destroy();
+    process.exitCode = 1;
+  });
+
+  await new Promise((resolve, reject) => {
+    socket.once("connect", resolve);
+    socket.once("error", reject);
+  });
+
+  process.stdin.pipe(socket);
+  socket.pipe(process.stdout);
+
+  await new Promise((resolve) => {
+    socket.once("close", resolve);
+    process.stdin.once("end", () => {
+      socket.end();
+      resolve();
+    });
+  });
+}
+
+main().catch((error) => {
+  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+  process.exit(1);
+});