@seawork/server 1.0.0

package/.env.example

@@ -0,0 +1,23 @@
+# OpenAI API Key (for GPT-4, Whisper STT, and TTS)
+OPENAI_API_KEY=
+
+# TTS Configuration (optional - defaults shown)
+TTS_VOICE=alloy
+# Available voices: alloy, echo, fable, onyx, nova, shimmer
+TTS_MODEL=tts-1
+# Available models: tts-1 (faster), tts-1-hd (higher quality)
+
+# Server Configuration
+# Location for runtime state (agents.json, etc.). Defaults to ~/.seawork
+SEAWORK_HOME=~/.seawork
+
+# Listen address. Defaults to 127.0.0.1:6767
+# Can be host:port, /path/to/socket, or unix:///path/to/socket
+SEAWORK_LISTEN=127.0.0.1:6767
+
+# Debug recordings (dictation + STT input + TTS output)
+# When enabled, recordings are saved under `${cwd}/.debug/recordings/`
+SEAWORK_DICTATION_DEBUG=1
+
+# Enable verbose Claude SDK stream logging (trace-level per-token logs)
+SEAWORK_CLAUDE_DEBUG=1

package/README.md

@@ -0,0 +1,107 @@
+# Voice Assistant
+
+A voice-controlled terminal assistant that runs as a single local service.
+
+## 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
+SEAWORK_HOME=~/.seawork        # Runtime state directory (agents/, etc.)
+SEAWORK_LISTEN=127.0.0.1:6767  # Listen address (host:port or /path/to/socket)
+```
+
+`SEAWORK_HOME` defaults to `~/.seawork` and isolates runtime artifacts like `agents/`. `SEAWORK_LISTEN` controls the daemon listen address. For blue/green testing you can run a parallel server without touching production state:
+
+```bash
+SEAWORK_HOME=~/.seawork-blue SEAWORK_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/dist/scripts/dev-runner.js

@@ -0,0 +1,27 @@
+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("./supervisor-entrypoint.ts", import.meta.url));
+const result = spawnSync(process.execPath, [
+    "--inspect",
+    "--heapsnapshot-near-heap-limit=3",
+    "--max-old-space-size=3072",
+    "--report-on-fatalerror",
+    "--report-directory=/tmp/seawork-reports",
+    ...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,4BAA4B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAChG,MAAM,MAAM,GAAG,SAAS,CACtB,OAAO,CAAC,QAAQ,EAChB;IACE,WAAW;IACX,kCAAkC;IAClC,2BAA2B;IAC3B,wBAAwB;IACxB,yCAAyC;IACzC,GAAG,OAAO,CAAC,QAAQ;IACnB,iBAAiB;IACjB,OAAO;IACP,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;CACzB,EACD;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);
+});

package/dist/scripts/supervisor-entrypoint.js

@@ -0,0 +1,123 @@
+import { fileURLToPath } from "url";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { acquirePidLock, PidLockError, releasePidLock, updatePidLock, } from "../src/server/pid-lock.js";
+import { resolveSeaworkHome } from "../src/server/seawork-home.js";
+import { runSupervisor } from "./supervisor.js";
+import { applySherpaLoaderEnv } from "../src/server/speech/providers/local/sherpa/sherpa-runtime-env.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 resolvePackagedNodeEntrypointRunnerPath(currentScriptPath) {
+    const packageMarker = `${path.sep}node_modules${path.sep}@seaverse${path.sep}server${path.sep}`;
+    const markerIndex = currentScriptPath.lastIndexOf(packageMarker);
+    if (markerIndex === -1) {
+        return null;
+    }
+    const appRoot = currentScriptPath.slice(0, markerIndex);
+    const runnerPath = path.join(appRoot, "dist", "daemon", "node-entrypoint-runner.js");
+    return existsSync(runnerPath) ? runnerPath : null;
+}
+async function main() {
+    const config = parseConfig(process.argv.slice(2));
+    const workerEntry = config.devMode ? resolveDevWorkerEntry() : resolveWorkerEntry();
+    const workerExecArgv = resolveWorkerExecArgv(workerEntry);
+    const workerEnv = { ...process.env, SEAWORK_SUPERVISED: "1" };
+    const packagedNodeEntrypointRunner = process.env.ELECTRON_RUN_AS_NODE === "1"
+        ? resolvePackagedNodeEntrypointRunnerPath(fileURLToPath(import.meta.url))
+        : null;
+    applySherpaLoaderEnv(workerEnv);
+    const seaworkHome = resolveSeaworkHome(workerEnv);
+    try {
+        await acquirePidLock(seaworkHome, null, {
+            ownerPid: process.pid,
+        });
+    }
+    catch (error) {
+        if (error instanceof PidLockError) {
+            process.stderr.write(`${error.message}\n`);
+            process.exit(1);
+            return;
+        }
+        throw error;
+    }
+    let lockReleased = false;
+    const releaseLock = async () => {
+        if (lockReleased) {
+            return;
+        }
+        lockReleased = true;
+        await releasePidLock(seaworkHome, {
+            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,
+        resolveWorkerSpawnSpec: packagedNodeEntrypointRunner
+            ? (resolvedWorkerEntry) => ({
+                command: process.execPath,
+                args: [
+                    packagedNodeEntrypointRunner,
+                    "node-script",
+                    resolvedWorkerEntry,
+                    ...config.workerArgs,
+                ],
+                env: {
+                    ...workerEnv,
+                    ELECTRON_RUN_AS_NODE: "1",
+                },
+            })
+            : undefined,
+        restartOnCrash: config.devMode,
+        onWorkerReady: async ({ listen }) => {
+            await updatePidLock(seaworkHome, { listen }, { ownerPid: process.pid });
+        },
+        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=supervisor-entrypoint.js.map

package/dist/scripts/supervisor-entrypoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-entrypoint.js","sourceRoot":"","sources":["../../scripts/supervisor-entrypoint.ts"],"names":[],"mappings":"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"}

package/dist/scripts/supervisor.js

@@ -0,0 +1,148 @@
+import { fork, spawn } from "child_process";
+function describeExit(code, signal) {
+    return signal ?? (typeof code === "number" ? `code ${code}` : "unknown");
+}
+function parseLifecycleMessage(msg) {
+    if (typeof msg !== "object" || msg === null || !("type" in msg)) {
+        return null;
+    }
+    const type = msg.type;
+    if (type === "seawork:shutdown") {
+        return { type: "seawork:shutdown" };
+    }
+    if (type === "seawork:ready") {
+        const listen = msg.listen;
+        if (typeof listen !== "string" || listen.trim().length === 0) {
+            return null;
+        }
+        return { type: "seawork:ready", listen };
+    }
+    if (type === "seawork:restart") {
+        const reason = msg.reason;
+        return {
+            type: "seawork:restart",
+            ...(typeof reason === "string" && reason.trim().length > 0 ? { reason } : {}),
+        };
+    }
+    return null;
+}
+export function runSupervisor(options) {
+    const restartOnCrash = options.restartOnCrash ?? false;
+    const workerArgs = options.workerArgs ?? process.argv.slice(2);
+    const workerEnv = options.workerEnv ?? process.env;
+    const workerExecArgv = options.workerExecArgv ?? ["--import", "tsx"];
+    const resolveWorkerSpawnSpec = options.resolveWorkerSpawnSpec;
+    let child = null;
+    let restarting = false;
+    let shuttingDown = false;
+    let exiting = false;
+    const log = (message) => {
+        process.stderr.write(`[${options.name}] ${message}\n`);
+    };
+    const exitSupervisor = (code) => {
+        if (exiting) {
+            return;
+        }
+        exiting = true;
+        Promise.resolve(options.onSupervisorExit?.())
+            .catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            log(`Supervisor exit cleanup failed: ${message}`);
+        })
+            .finally(() => {
+            process.exit(code);
+        });
+    };
+    const spawnWorker = () => {
+        let workerEntry;
+        try {
+            // Resolve at spawn time so restarts pick up current filesystem state.
+            workerEntry = options.resolveWorkerEntry();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            log(`Failed to resolve worker entry: ${message}`);
+            exitSupervisor(1);
+            return;
+        }
+        const spawnSpec = resolveWorkerSpawnSpec?.(workerEntry) ?? null;
+        if (spawnSpec) {
+            child = spawn(spawnSpec.command, spawnSpec.args, {
+                stdio: ["inherit", "inherit", "inherit", "ipc"],
+                env: spawnSpec.env ?? workerEnv,
+            });
+        }
+        else {
+            child = fork(workerEntry, workerArgs, {
+                stdio: "inherit",
+                env: workerEnv,
+                execArgv: workerExecArgv,
+            });
+        }
+        child.on("message", (msg) => {
+            const lifecycleMessage = parseLifecycleMessage(msg);
+            if (!lifecycleMessage) {
+                return;
+            }
+            if (lifecycleMessage.type === "seawork:ready") {
+                Promise.resolve(options.onWorkerReady?.({ listen: lifecycleMessage.listen })).catch((error) => {
+                    const message = error instanceof Error ? error.message : String(error);
+                    log(`Worker ready callback failed: ${message}`);
+                });
+                return;
+            }
+            if (lifecycleMessage.type === "seawork:shutdown") {
+                requestShutdown("Shutdown requested by worker");
+                return;
+            }
+            requestRestart("Restart requested by worker");
+        });
+        child.on("exit", (code, signal) => {
+            const exitDescriptor = describeExit(code, signal);
+            if (shuttingDown) {
+                log(`Worker exited (${exitDescriptor}). Supervisor shutting down.`);
+                exitSupervisor(0);
+                return;
+            }
+            const crashed = restartOnCrash &&
+                ((code !== 0 && code !== null) || (signal !== null && signal === "SIGKILL"));
+            if (restarting || crashed) {
+                restarting = false;
+                log(`Worker exited (${exitDescriptor}). Restarting worker...`);
+                spawnWorker();
+                return;
+            }
+            log(`Worker exited (${exitDescriptor}). Supervisor exiting.`);
+            exitSupervisor(typeof code === "number" ? code : 0);
+        });
+    };
+    const requestRestart = (reason) => {
+        if (!child || restarting || shuttingDown) {
+            return;
+        }
+        restarting = true;
+        log(`${reason}. Stopping worker for restart...`);
+        child.kill("SIGTERM");
+    };
+    const requestShutdown = (reason) => {
+        if (shuttingDown) {
+            return;
+        }
+        shuttingDown = true;
+        restarting = false;
+        log(`${reason}. Stopping worker...`);
+        if (!child) {
+            exitSupervisor(0);
+            return;
+        }
+        child.kill("SIGTERM");
+    };
+    const forwardSignal = (signal) => {
+        requestShutdown(`Received ${signal}`);
+    };
+    process.on("SIGINT", () => forwardSignal("SIGINT"));
+    process.on("SIGTERM", () => forwardSignal("SIGTERM"));
+    process.stdout.write(`[${options.name}] ${options.startupMessage}\n`);
+    spawnWorker();
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/scripts/supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../../scripts/supervisor.ts"],"names":[],"mappings":"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"}

package/dist/server/client/daemon-client-relay-e2ee-transport.d.ts

@@ -0,0 +1,8 @@
+import type { DaemonTransport, DaemonTransportFactory, TransportLogger } from "./daemon-client-transport-types.js";
+export declare function createRelayE2eeTransportFactory(args: {
+    baseFactory: DaemonTransportFactory;
+    daemonPublicKeyB64: string;
+    logger: TransportLogger;
+}): DaemonTransportFactory;
+export declare function createEncryptedTransport(base: DaemonTransport, daemonPublicKeyB64: string, logger: TransportLogger): DaemonTransport;
+//# sourceMappingURL=daemon-client-relay-e2ee-transport.d.ts.map

package/dist/server/client/daemon-client-relay-e2ee-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-client-relay-e2ee-transport.d.ts","sourceRoot":"","sources":["../../../src/client/daemon-client-relay-e2ee-transport.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAW5C,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,WAAW,EAAE,sBAAsB,CAAC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;CACzB,GAAG,sBAAsB,CAKzB;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,eAAe,EACrB,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,eAAe,GACtB,eAAe,CAuIjB"}