@sajou/mcp-server 0.6.0

package/README.md

@@ -0,0 +1,78 @@
+# @sajou/mcp-server
+
+MCP (Model Context Protocol) server for sajou. Lets AI agents interact with the visual choreographer via the standard MCP protocol.
+
+## Setup
+
+### 1. Start the scene-builder dev server
+
+```bash
+pnpm --filter scene-builder dev
+```
+
+The scene-builder runs on `http://localhost:5175` by default.
+
+### 2. Configure your MCP client
+
+#### Claude Code
+
+Add to your MCP config (`~/.claude/claude_desktop_config.json` or project `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "sajou": {
+      "command": "npx",
+      "args": ["-y", "@sajou/mcp-server"],
+      "env": {
+        "SAJOU_DEV_SERVER": "http://localhost:5175"
+      }
+    }
+  }
+}
+```
+
+#### Development (from this repo)
+
+```json
+{
+  "mcpServers": {
+    "sajou": {
+      "command": "npx",
+      "args": ["tsx", "packages/mcp-server/src/index.ts"],
+      "env": {
+        "SAJOU_DEV_SERVER": "http://localhost:5175"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `emit_signal` | Emit a signal to the scene. Triggers choreographies. |
+| `get_scene_state` | Get current scene entities (id, position, visibility). |
+| `get_choreographies` | List available choreographies with descriptions. |
+| `list_themes` | List available themes (citadel, office). |
+| `get_catalog` | Get entity catalog for a theme (buildings, units, etc.). |
+| `map_signals` | Map a signal type to a choreography. |
+
+## Environment variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SAJOU_DEV_SERVER` | `http://localhost:5175` | URL of the scene-builder dev server |
+
+## Architecture
+
+```
+AI Agent (Claude) ──MCP/stdio──> sajou-mcp ──HTTP──> scene-builder dev server
+                                                      │
+                                                      ├── POST /api/signal (emit signals)
+                                                      ├── GET /api/scene/state (scene state)
+                                                      └── GET /__signals__/stream (SSE)
+```
+
+The MCP server is a thin adapter. It translates MCP tool calls into HTTP requests against the scene-builder's existing API endpoints. The scene-builder handles all signal routing, choreography execution, and rendering.

package/dist/app.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Express application — mounts all route modules.
+ *
+ * This is the HTTP server for the sajou state server. It provides:
+ * - REST API for scene state (read/write)
+ * - SSE streams for real-time updates
+ * - Signal ingestion endpoint
+ * - Local service discovery
+ * - CORS proxy for browser clients
+ * - Tap hook management
+ *
+ * Used both as a standalone server (--http flag) and as Express middleware
+ * for the botoul deployment (createMcpRouter export).
+ */
+import express from "express";
+/** Create the Express app with all routes mounted. */
+export declare function createApp(): express.Express;
+/**
+ * Create an Express Router for use as middleware (botoul deployment).
+ *
+ * Mounts REST routes + MCP Streamable HTTP transport on the router root.
+ * When the parent app mounts this on `/mcp`, MCP requests go to `/mcp/`
+ * and REST API to `/mcp/api/*`.
+ *
+ * Usage in botoul's index.js:
+ * ```js
+ * const { createMcpRouter } = require('./lib/sajou-server.cjs');
+ * app.use('/mcp', createMcpRouter());
+ * ```
+ */
+export declare function createMcpRouter(): express.Router;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAwB9B,sDAAsD;AACtD,wBAAgB,SAAS,IAAI,OAAO,CAAC,OAAO,CAe3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,MAAM,CAiBhD"}

package/dist/app.js

@@ -0,0 +1,76 @@
+/**
+ * Express application — mounts all route modules.
+ *
+ * This is the HTTP server for the sajou state server. It provides:
+ * - REST API for scene state (read/write)
+ * - SSE streams for real-time updates
+ * - Signal ingestion endpoint
+ * - Local service discovery
+ * - CORS proxy for browser clients
+ * - Tap hook management
+ *
+ * Used both as a standalone server (--http flag) and as Express middleware
+ * for the botoul deployment (createMcpRouter export).
+ */
+import express from "express";
+import { createSceneRoutes } from "./routes/scene.js";
+import { createSignalRoutes } from "./routes/signals.js";
+import { createDiscoveryRoutes } from "./routes/discovery.js";
+import { createTapRoutes } from "./routes/tap.js";
+import { createProxyRoutes } from "./routes/proxy.js";
+import { mountMcpTransport } from "./mcp/transport.js";
+import { createServer } from "./server.js";
+/** Simple CORS middleware — allows all origins (dev-friendly). */
+function corsMiddleware(_req, res, next) {
+    res.setHeader("Access-Control-Allow-Origin", "*");
+    res.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
+    res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
+    res.setHeader("Access-Control-Max-Age", "86400");
+    if (_req.method === "OPTIONS") {
+        res.status(204).end();
+        return;
+    }
+    next();
+}
+/** Create the Express app with all routes mounted. */
+export function createApp() {
+    const app = express();
+    // Global middleware
+    app.use(corsMiddleware);
+    app.use(express.json({ limit: "10mb" }));
+    // Mount all route modules
+    app.use(createSceneRoutes());
+    app.use(createSignalRoutes());
+    app.use(createDiscoveryRoutes());
+    app.use(createTapRoutes());
+    app.use(createProxyRoutes());
+    return app;
+}
+/**
+ * Create an Express Router for use as middleware (botoul deployment).
+ *
+ * Mounts REST routes + MCP Streamable HTTP transport on the router root.
+ * When the parent app mounts this on `/mcp`, MCP requests go to `/mcp/`
+ * and REST API to `/mcp/api/*`.
+ *
+ * Usage in botoul's index.js:
+ * ```js
+ * const { createMcpRouter } = require('./lib/sajou-server.cjs');
+ * app.use('/mcp', createMcpRouter());
+ * ```
+ */
+export function createMcpRouter() {
+    const router = express.Router();
+    router.use(corsMiddleware);
+    router.use(express.json({ limit: "10mb" }));
+    // REST API routes
+    router.use(createSceneRoutes());
+    router.use(createSignalRoutes());
+    router.use(createDiscoveryRoutes());
+    router.use(createTapRoutes());
+    router.use(createProxyRoutes());
+    // MCP Streamable HTTP — mounted on "/" (router is already prefixed by parent)
+    mountMcpTransport(router, createServer, "/");
+    return router;
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,kEAAkE;AAClE,SAAS,cAAc,CAAC,IAAa,EAAE,GAAa,EAAE,IAAkB;IACtE,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IAClD,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,iCAAiC,CAAC,CAAC;IACjF,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,6BAA6B,CAAC,CAAC;IAC7E,GAAG,CAAC,SAAS,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;IAEjD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IACD,IAAI,EAAE,CAAC;AACT,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,oBAAoB;IACpB,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACxB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAEzC,0BAA0B;IAC1B,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC7B,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC9B,GAAG,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACjC,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;IAC3B,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAE7B,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAE5C,kBAAkB;IAClB,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEhC,8EAA8E;IAC9E,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;IAE7C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * sajou server entry point — supports both stdio (MCP) and HTTP modes.
+ *
+ * Usage:
+ *   node dist/index.js              → stdio transport (default, for Claude Code)
+ *   node dist/index.js --http       → HTTP server on port 3000
+ *   node dist/index.js --http 8080  → HTTP server on custom port
+ *
+ * In HTTP mode, the server provides:
+ *   - REST API on /api/* (same endpoints as the old Vite dev server)
+ *   - MCP Streamable HTTP on /mcp
+ *   - SSE streams for real-time updates
+ *
+ * In stdio mode, the server behaves exactly as before — MCP JSON-RPC over stdin/stdout.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}

package/dist/index.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/**
+ * sajou server entry point — supports both stdio (MCP) and HTTP modes.
+ *
+ * Usage:
+ *   node dist/index.js              → stdio transport (default, for Claude Code)
+ *   node dist/index.js --http       → HTTP server on port 3000
+ *   node dist/index.js --http 8080  → HTTP server on custom port
+ *
+ * In HTTP mode, the server provides:
+ *   - REST API on /api/* (same endpoints as the old Vite dev server)
+ *   - MCP Streamable HTTP on /mcp
+ *   - SSE streams for real-time updates
+ *
+ * In stdio mode, the server behaves exactly as before — MCP JSON-RPC over stdin/stdout.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+import { createApp } from "./app.js";
+import { mountMcpTransport } from "./mcp/transport.js";
+import { cleanupTapHooks } from "./routes/tap.js";
+/** Parse --http flag and optional port from argv. */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const httpIndex = args.indexOf("--http");
+    if (httpIndex === -1) {
+        return { mode: "stdio", port: 3000 };
+    }
+    const portArg = args[httpIndex + 1];
+    const port = portArg && !portArg.startsWith("-") ? parseInt(portArg, 10) : 3000;
+    return { mode: "http", port: isNaN(port) ? 3000 : port };
+}
+async function main() {
+    const { mode, port } = parseArgs();
+    if (mode === "stdio") {
+        // Classic stdio mode — MCP JSON-RPC over stdin/stdout
+        const server = createServer();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        process.stderr.write("[sajou] Server started (stdio mode)\n");
+    }
+    else {
+        // HTTP mode — Express server with REST + MCP Streamable HTTP
+        const app = createApp();
+        mountMcpTransport(app, createServer);
+        const httpServer = app.listen(port, () => {
+            process.stderr.write(`[sajou] Server started on http://localhost:${port}\n`);
+            process.stderr.write(`[sajou]   REST API: http://localhost:${port}/api/*\n`);
+            process.stderr.write(`[sajou]   MCP:      http://localhost:${port}/mcp\n`);
+        });
+        // Cleanup on shutdown
+        const shutdown = () => {
+            cleanupTapHooks();
+            httpServer.close();
+            process.exit(0);
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    }
+}
+main().catch((error) => {
+    process.stderr.write(`[sajou] Fatal error: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp/transport.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP Streamable HTTP transport — mounts on /mcp for remote agents.
+ *
+ * Creates a per-session StreamableHTTPServerTransport and wires it
+ * to the same McpServer instance used by stdio. Coexists with the
+ * REST routes on the same Express app.
+ */
+import type { Router } from "express";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Mount the MCP Streamable HTTP endpoint on an Express router.
+ *
+ * @param router - Express Router (or app, which extends Router) to mount on
+ * @param serverFactory - Factory that creates McpServer instances (one per session)
+ * @param path - Route path to mount on (default "/mcp")
+ */
+export declare function mountMcpTransport(router: Router, serverFactory: () => McpServer, path?: string): void;
+//# sourceMappingURL=transport.d.ts.map

package/dist/mcp/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/mcp/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAqB,MAAM,EAAE,MAAM,SAAS,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8CzE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,EAAE,IAAI,SAAS,GAAG,IAAI,CAIrG"}

package/dist/mcp/transport.js

@@ -0,0 +1,56 @@
+/**
+ * MCP Streamable HTTP transport — mounts on /mcp for remote agents.
+ *
+ * Creates a per-session StreamableHTTPServerTransport and wires it
+ * to the same McpServer instance used by stdio. Coexists with the
+ * REST routes on the same Express app.
+ */
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+/** Active transports keyed by session ID. */
+const transports = new Map();
+/** Handler for MCP Streamable HTTP requests. */
+async function mcpHandler(req, res, serverFactory) {
+    const sessionId = req.headers["mcp-session-id"];
+    if (sessionId && transports.has(sessionId)) {
+        const transport = transports.get(sessionId);
+        await transport.handleRequest(req, res, req.body);
+        return;
+    }
+    if (req.method === "POST") {
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => crypto.randomUUID(),
+        });
+        transport.onclose = () => {
+            if (transport.sessionId) {
+                transports.delete(transport.sessionId);
+            }
+        };
+        const server = serverFactory();
+        await server.connect(transport);
+        // handleRequest processes the initialize message and assigns sessionId
+        await transport.handleRequest(req, res, req.body);
+        // Store AFTER handleRequest so the sessionId is available
+        if (transport.sessionId) {
+            transports.set(transport.sessionId, transport);
+        }
+        return;
+    }
+    res.status(400).json({
+        jsonrpc: "2.0",
+        error: { code: -32000, message: "No valid session. Send a POST to initialize." },
+        id: null,
+    });
+}
+/**
+ * Mount the MCP Streamable HTTP endpoint on an Express router.
+ *
+ * @param router - Express Router (or app, which extends Router) to mount on
+ * @param serverFactory - Factory that creates McpServer instances (one per session)
+ * @param path - Route path to mount on (default "/mcp")
+ */
+export function mountMcpTransport(router, serverFactory, path = "/mcp") {
+    router.all(path, (req, res) => {
+        void mcpHandler(req, res, serverFactory);
+    });
+}
+//# sourceMappingURL=transport.js.map

package/dist/mcp/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/mcp/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAGnG,6CAA6C;AAC7C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyC,CAAC;AAEpE,gDAAgD;AAChD,KAAK,UAAU,UAAU,CAAC,GAAY,EAAE,GAAa,EAAE,aAA8B;IACnF,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAuB,CAAC;IAEtE,IAAI,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QAC7C,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;YAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE;SAC9C,CAAC,CAAC;QAEH,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;YACvB,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;gBACxB,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;QAC/B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,uEAAuE;QACvE,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAElD,0DAA0D;QAC1D,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YACxB,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACjD,CAAC;QACD,OAAO;IACT,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACnB,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,8CAA8C,EAAE;QAChF,EAAE,EAAE,IAAI;KACT,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,aAA8B,EAAE,IAAI,GAAG,MAAM;IAC7F,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC/C,KAAK,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Middleware entry point — for CJS bundle used by botoul.
+ *
+ * Exports `createMcpRouter()` without starting any server.
+ * This is the entry point for esbuild when building the botoul bundle.
+ *
+ * Usage:
+ * ```js
+ * const { createMcpRouter } = require('./lib/sajou-mcp.cjs');
+ * app.use('/mcp', createMcpRouter());
+ * ```
+ */
+export { createMcpRouter } from "./app.js";
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/middleware.js

@@ -0,0 +1,14 @@
+/**
+ * Middleware entry point — for CJS bundle used by botoul.
+ *
+ * Exports `createMcpRouter()` without starting any server.
+ * This is the entry point for esbuild when building the botoul bundle.
+ *
+ * Usage:
+ * ```js
+ * const { createMcpRouter } = require('./lib/sajou-mcp.cjs');
+ * app.use('/mcp', createMcpRouter());
+ * ```
+ */
+export { createMcpRouter } from "./app.js";
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/routes/discovery.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Local service discovery + OpenClaw token routes.
+ *
+ * Extracted from localDiscoveryPlugin and openclawTokenPlugin in vite.config.ts.
+ */
+import { Router } from "express";
+export declare function createDiscoveryRoutes(): Router;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/routes/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/routes/discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AA+FjC,wBAAgB,qBAAqB,IAAI,MAAM,CA0F9C"}

package/dist/routes/discovery.js

@@ -0,0 +1,155 @@
+/**
+ * Local service discovery + OpenClaw token routes.
+ *
+ * Extracted from localDiscoveryPlugin and openclawTokenPlugin in vite.config.ts.
+ */
+import { Router } from "express";
+import { createConnection } from "node:net";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+// ---------------------------------------------------------------------------
+// Probe helpers
+// ---------------------------------------------------------------------------
+/** Probe a TCP port on localhost. Resolves true if something is listening. */
+function tcpProbe(port, timeoutMs = 300) {
+    return new Promise((resolve) => {
+        const socket = createConnection({ host: "127.0.0.1", port });
+        const timer = setTimeout(() => {
+            socket.destroy();
+            resolve(false);
+        }, timeoutMs);
+        socket.on("connect", () => {
+            clearTimeout(timer);
+            socket.destroy();
+            resolve(true);
+        });
+        socket.on("error", () => {
+            clearTimeout(timer);
+            socket.destroy();
+            resolve(false);
+        });
+    });
+}
+/** Probe an HTTP endpoint. Returns models list on success. */
+async function httpProbe(url, timeoutMs = 300) {
+    try {
+        const resp = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+        if (!resp.ok)
+            return { ok: false };
+        const json = (await resp.json());
+        const data = json["data"];
+        if (Array.isArray(data)) {
+            const models = data.map((m) => {
+                const entry = m;
+                return String(entry["id"] ?? "unknown");
+            });
+            return { ok: true, models };
+        }
+        return { ok: true, models: [] };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+// ---------------------------------------------------------------------------
+// OpenClaw token reader
+// ---------------------------------------------------------------------------
+const OPENCLAW_CONFIG_PATH = join(process.env["HOME"] ?? process.env["USERPROFILE"] ?? ".", ".openclaw", "openclaw.json");
+async function readOpenClawToken() {
+    try {
+        const raw = await readFile(OPENCLAW_CONFIG_PATH, "utf8");
+        const config = JSON.parse(raw);
+        return config.gateway?.auth?.token ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Routes
+// ---------------------------------------------------------------------------
+export function createDiscoveryRoutes() {
+    const router = Router();
+    // GET /api/discover/local — probe known local services
+    router.get("/api/discover/local", (_req, res) => {
+        Promise.allSettled([
+            // Claude Code — always available (SSE internal endpoint)
+            Promise.resolve({
+                id: "local:claude-code",
+                label: "Claude Code",
+                protocol: "sse",
+                url: "/__signals__/stream",
+                available: true,
+                models: [],
+            }),
+            // OpenClaw — TCP probe on 18789
+            tcpProbe(18789, 300).then((up) => ({
+                id: "local:openclaw",
+                label: "OpenClaw",
+                protocol: "openclaw",
+                url: "ws://127.0.0.1:18789",
+                available: up,
+                needsApiKey: true,
+                models: [],
+            })),
+            // LM Studio — HTTP probe on 1234
+            httpProbe("http://127.0.0.1:1234/v1/models", 300).then((r) => ({
+                id: "local:lm-studio",
+                label: "LM Studio",
+                protocol: "openai",
+                url: "http://127.0.0.1:1234",
+                available: r.ok,
+                needsApiKey: true,
+                models: r.models ?? [],
+            })),
+            // Ollama — HTTP probe on 11434
+            httpProbe("http://127.0.0.1:11434/v1/models", 300).then((r) => ({
+                id: "local:ollama",
+                label: "Ollama",
+                protocol: "openai",
+                url: "http://127.0.0.1:11434",
+                available: r.ok,
+                models: r.models ?? [],
+            })),
+            // Codex — TCP probe on 4500
+            tcpProbe(4500, 300).then((up) => ({
+                id: "local:codex",
+                label: "Codex",
+                protocol: "codex",
+                url: "ws://127.0.0.1:4500",
+                available: up,
+                models: [],
+            })),
+        ]).then((results) => {
+            const services = [];
+            for (const result of results) {
+                if (result.status === "fulfilled") {
+                    services.push(result.value);
+                }
+            }
+            res.json({ services });
+        });
+    });
+    // GET /api/openclaw/token — serve OpenClaw gateway token (dev only)
+    router.get("/api/openclaw/token", (req, res) => {
+        const origin = req.headers["origin"] ?? "";
+        // In standalone server mode, allow any localhost origin
+        if (origin && !origin.includes("localhost") && !origin.includes("127.0.0.1") && !origin.includes("0.0.0.0")) {
+            res.status(403).json({ ok: false, error: "Forbidden origin" });
+            return;
+        }
+        readOpenClawToken().then((token) => {
+            if (origin) {
+                res.setHeader("Access-Control-Allow-Origin", origin);
+            }
+            if (token) {
+                res.json({ ok: true, token });
+            }
+            else {
+                res.json({ ok: false });
+            }
+        });
+    });
+    return router;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/routes/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/routes/discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,8EAA8E;AAC9E,SAAS,QAAQ,CAAC,IAAY,EAAE,SAAS,GAAG,GAAG;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8DAA8D;AAC9D,KAAK,UAAU,SAAS,CACtB,GAAW,EACX,SAAS,GAAG,GAAG;IAEf,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAA4B,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC5B,MAAM,KAAK,GAAG,CAA4B,CAAC;gBAC3C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,oBAAoB,GAAG,IAAI,CAC/B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,EACxD,WAAW,EACX,eAAe,CAChB,CAAC;AAMF,KAAK,UAAU,iBAAiB;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QACjD,OAAO,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAgBD,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,MAAM,UAAU,qBAAqB;IACnC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,uDAAuD;IACvD,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC9C,OAAO,CAAC,UAAU,CAAC;YACjB,yDAAyD;YACzD,OAAO,CAAC,OAAO,CAA4B;gBACzC,EAAE,EAAE,mBAAmB;gBACvB,KAAK,EAAE,aAAa;gBACpB,QAAQ,EAAE,KAAK;gBACf,GAAG,EAAE,qBAAqB;gBAC1B,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,EAAE;aACX,CAAC;YAEF,gCAAgC;YAChC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAA4B,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC5D,EAAE,EAAE,gBAAgB;gBACpB,KAAK,EAAE,UAAU;gBACjB,QAAQ,EAAE,UAAU;gBACpB,GAAG,EAAE,sBAAsB;gBAC3B,SAAS,EAAE,EAAE;gBACb,WAAW,EAAE,IAAI;gBACjB,MAAM,EAAE,EAAE;aACX,CAAC,CAAC;YAEH,iCAAiC;YACjC,SAAS,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC,IAAI,CAA4B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACxF,EAAE,EAAE,iBAAiB;gBACrB,KAAK,EAAE,WAAW;gBAClB,QAAQ,EAAE,QAAQ;gBAClB,GAAG,EAAE,uBAAuB;gBAC5B,SAAS,EAAE,CAAC,CAAC,EAAE;gBACf,WAAW,EAAE,IAAI;gBACjB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;aACvB,CAAC,CAAC;YAEH,+BAA+B;YAC/B,SAAS,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC,IAAI,CAA4B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzF,EAAE,EAAE,cAAc;gBAClB,KAAK,EAAE,QAAQ;gBACf,QAAQ,EAAE,QAAQ;gBAClB,GAAG,EAAE,wBAAwB;gBAC7B,SAAS,EAAE,CAAC,CAAC,EAAE;gBACf,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;aACvB,CAAC,CAAC;YAEH,4BAA4B;YAC5B,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAA4B,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC3D,EAAE,EAAE,aAAa;gBACjB,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,OAAO;gBACjB,GAAG,EAAE,qBAAqB;gBAC1B,SAAS,EAAE,EAAE;gBACb,MAAM,EAAE,EAAE;aACX,CAAC,CAAC;SACJ,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YAClB,MAAM,QAAQ,GAAgC,EAAE,CAAC;YACjD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAClC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,oEAAoE;IACpE,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3C,wDAAwD;QACxD,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5G,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QAED,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACjC,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,KAAK,EAAE,CAAC;gBACV,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/routes/proxy.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CORS proxy route — forwards requests to external services.
+ *
+ * Extracted from corsProxyPlugin in vite.config.ts.
+ * Used by the browser to bypass CORS restrictions when probing
+ * LM Studio, Ollama, and other local services.
+ */
+import { Router } from "express";
+export declare function createProxyRoutes(): Router;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/routes/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/routes/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,wBAAgB,iBAAiB,IAAI,MAAM,CA+E1C"}