@redplanethq/corebrain 2.8.12 → 2.8.14

package/dist/server/api/browser/cdp.js

@@ -0,0 +1,137 @@
+import WebSocket from 'ws';
+import { getSessionCdpInfo } from '../../../utils/browser-manager.js';
+import { gatewayLog } from '../../../server/gateway-log.js';
+/**
+ * WebSocket proxy that pipes Chrome DevTools Protocol traffic between the
+ * webapp and a running Playwright-launched Chromium.
+ *
+ *   GET /api/browser/cdp/:session
+ *
+ * Looks up the session's `--remote-debugging-port` endpoint (captured at
+ * launch time in `browser-manager.ts`), opens a client WS to the local
+ * Chromium, and pipes frames in both directions. The exposed endpoint is
+ * the *browser-level* CDP — the webapp viewer issues `Target.getTargets`
+ * and `Target.attachToTarget` to talk to a specific page.
+ *
+ * Closes with `4404` if the session isn't running. Closes with `4502` if
+ * the upstream Chromium WS handshake fails.
+ */
+export const browserCdpRoute = async (app) => {
+    app.get('/cdp/:session', { websocket: true }, (client, req) => {
+        const sessionName = req.params?.session;
+        if (!sessionName) {
+            client.close(4400, 'session is required');
+            return;
+        }
+        const info = getSessionCdpInfo(sessionName);
+        if (!info) {
+            client.close(4404, `browser session "${sessionName}" is not running`);
+            return;
+        }
+        gatewayLog(`browser cdp proxy: session=${sessionName} → ${info.wsEndpoint}`);
+        const upstream = new WebSocket(info.wsEndpoint, {
+            perMessageDeflate: false,
+        });
+        // 1005/1006/1015 etc. are reserved "received-only" codes — passing them
+        // to ws.close() throws. Forward only sendable codes; fall back to 1000.
+        const sanitizeCode = (code) => code === 1000 || (code >= 3000 && code <= 4999) ? code : 1000;
+        const closeBoth = (code = 1000, reason = '') => {
+            const safe = sanitizeCode(code);
+            try {
+                if (client.readyState === client.OPEN)
+                    client.close(safe, reason);
+            }
+            catch {
+                /* already closing */
+            }
+            try {
+                if (upstream.readyState === upstream.OPEN)
+                    upstream.close(safe, reason);
+            }
+            catch {
+                /* already closing */
+            }
+        };
+        // CDP frames are JSON text — `ws` delivers them as Buffer by default,
+        // and `send(buffer)` would re-emit them as a binary frame, which
+        // Chromium rejects (it closes the socket on a binary frame against
+        // a text protocol). Normalize to UTF-8 strings before forwarding so
+        // the relay always emits text frames in both directions.
+        const toText = (data) => {
+            if (typeof data === 'string')
+                return data;
+            if (Buffer.isBuffer(data))
+                return data.toString('utf8');
+            if (Array.isArray(data))
+                return Buffer.concat(data).toString('utf8');
+            if (data instanceof ArrayBuffer)
+                return Buffer.from(data).toString('utf8');
+            return String(data);
+        };
+        // Fastify accepts the client WS upgrade before this handler runs, so
+        // the browser may have already sent its first CDP frames (e.g.
+        // `Target.setDiscoverTargets`) by the time we get here. Buffer them
+        // until upstream is open so nothing is dropped.
+        const queue = [];
+        let upstreamReady = false;
+        let clientFrames = 0;
+        let upstreamFrames = 0;
+        const previewFrame = (frame) => {
+            try {
+                const parsed = JSON.parse(frame);
+                return parsed.method ?? `id=${parsed.id ?? '?'}`;
+            }
+            catch {
+                return frame.slice(0, 60);
+            }
+        };
+        client.on('message', data => {
+            const frame = toText(data);
+            clientFrames += 1;
+            if (clientFrames <= 2) {
+                gatewayLog(`cdp client→upstream [${clientFrames}]: ${previewFrame(frame)} (queued=${!upstreamReady})`);
+            }
+            if (upstreamReady && upstream.readyState === upstream.OPEN) {
+                upstream.send(frame);
+            }
+            else {
+                queue.push(frame);
+            }
+        });
+        upstream.on('open', () => {
+            upstreamReady = true;
+            gatewayLog(`cdp upstream open, flushing ${queue.length} queued frame(s)`);
+            for (const frame of queue) {
+                if (upstream.readyState === upstream.OPEN)
+                    upstream.send(frame);
+            }
+            queue.length = 0;
+            upstream.on('message', data => {
+                const frame = toText(data);
+                upstreamFrames += 1;
+                if (upstreamFrames <= 2) {
+                    gatewayLog(`cdp upstream→client [${upstreamFrames}]: ${previewFrame(frame)}`);
+                }
+                if (client.readyState === client.OPEN)
+                    client.send(frame);
+            });
+        });
+        upstream.on('close', (code, reason) => {
+            gatewayLog(`cdp upstream closed: code=${code} reason=${reason?.toString() ?? ''}`);
+            closeBoth(code, reason?.toString());
+        });
+        client.on('close', (code, reason) => {
+            gatewayLog(`cdp client closed: code=${code} reason=${reason?.toString() ?? ''}`);
+            closeBoth(code, reason?.toString());
+        });
+        upstream.on('error', err => {
+            gatewayLog(`browser cdp upstream error: ${err.message}`);
+            closeBoth(4502, 'upstream cdp error');
+        });
+        client.on('error', err => {
+            gatewayLog(`browser cdp client error: ${err instanceof Error ? err.message : String(err)}`);
+            closeBoth(1011, 'client error');
+        });
+    });
+};
+//# sourceMappingURL=cdp.js.map

package/dist/server/api/browser/cdp.js.map

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

package/dist/server/api/browser/index.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyPluginAsync } from 'fastify';
+export declare const browserRoutes: FastifyPluginAsync;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/api/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/api/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAMhD,eAAO,MAAM,aAAa,EAAE,kBAI3B,CAAC"}

package/dist/server/api/browser/index.js

@@ -0,0 +1,10 @@
+import { browserTools, executeBrowserTool } from '../../../server/tools/browser-tools.js';
+import { makeToolGroupRoutes } from '../tool-group.js';
+import { browserCdpRoute } from './cdp.js';
+import { browserLaunchRoute } from './launch.js';
+export const browserRoutes = async (app) => {
+    await app.register(makeToolGroupRoutes(browserTools, executeBrowserTool));
+    await app.register(browserCdpRoute);
+    await app.register(browserLaunchRoute);
+};
+//# sourceMappingURL=index.js.map

package/dist/server/api/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/api/browser/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,eAAe,EAAC,MAAM,OAAO,CAAC;AACtC,OAAO,EAAC,kBAAkB,EAAC,MAAM,UAAU,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAuB,KAAK,EAAE,GAAG,EAAE,EAAE;IAC9D,MAAM,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC1E,MAAM,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACpC,MAAM,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AACxC,CAAC,CAAC"}

package/dist/server/api/browser/launch.d.ts

@@ -0,0 +1,17 @@
+import type { FastifyPluginAsync } from 'fastify';
+/**
+ * Lazy-launch (or attach to) a configured browser session by name.
+ *
+ *   POST /api/browser/launch
+ *   body: { session }
+ *   → 200 { ok: true } on success
+ *   → 404 / 500 on failure with `error`
+ *
+ * Always launches headless — the live view is delivered via CDP screencast
+ * (`/api/browser/cdp/<session>`), so no visible window is needed and remote
+ * gateways (Docker / Railway) work the same way as laptop ones. Idempotent —
+ * `getOrLaunchSession` reuses the cached `BrowserSession` if it's already
+ * running.
+ */
+export declare const browserLaunchRoute: FastifyPluginAsync;
+//# sourceMappingURL=launch.d.ts.map

package/dist/server/api/browser/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../../src/server/api/browser/launch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAIhD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBAyBhC,CAAC"}

package/dist/server/api/browser/launch.js

@@ -0,0 +1,41 @@
+import { getOrLaunchSession } from '../../../utils/browser-manager.js';
+import { gatewayLog } from '../../../server/gateway-log.js';
+/**
+ * Lazy-launch (or attach to) a configured browser session by name.
+ *
+ *   POST /api/browser/launch
+ *   body: { session }
+ *   → 200 { ok: true } on success
+ *   → 404 / 500 on failure with `error`
+ *
+ * Always launches headless — the live view is delivered via CDP screencast
+ * (`/api/browser/cdp/<session>`), so no visible window is needed and remote
+ * gateways (Docker / Railway) work the same way as laptop ones. Idempotent —
+ * `getOrLaunchSession` reuses the cached `BrowserSession` if it's already
+ * running.
+ */
+export const browserLaunchRoute = async (app) => {
+    app.post('/launch', async (req, reply) => {
+        const body = (req.body ?? {});
+        if (!body.session) {
+            reply.code(400);
+            return { ok: false, error: '`session` is required' };
+        }
+        gatewayLog(`browser launch: session=${body.session}`);
+        const result = await getOrLaunchSession(body.session, false);
+        if (result.error) {
+            gatewayLog(`browser launch FAILED: ${result.error}`);
+            reply.code(500);
+            return { ok: false, error: result.error };
+        }
+        return {
+            ok: true,
+            session: {
+                name: result.session.sessionName,
+                profile: result.session.profile,
+                cdpReady: Boolean(result.session.cdpWsEndpoint),
+            },
+        };
+    });
+};
+//# sourceMappingURL=launch.js.map

package/dist/server/api/browser/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../../src/server/api/browser/launch.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAuB,KAAK,EAAE,GAAG,EAAE,EAAE;IACnE,GAAG,CAAC,IAAI,CAEL,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAuB,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAC,CAAC;QACpD,CAAC;QACD,UAAU,CAAC,2BAA2B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,UAAU,CAAC,0BAA0B,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAC,CAAC;QACzC,CAAC;QACD,OAAO;YACN,EAAE,EAAE,IAAI;YACR,OAAO,EAAE;gBACR,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW;gBAChC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;gBAC/B,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;aAC/C;SACD,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/server/api/coding/coding_spawn.d.ts

@@ -0,0 +1,22 @@
+import type { FastifyPluginAsync } from 'fastify';
+/**
+ * Spawn (or resume) a coding agent's interactive TUI so the xterm WS has a
+ * PTY to attach to. This is a webapp-only primitive — LLM callers use
+ * `coding_ask` which requires a prompt.
+ *
+ *   POST /api/coding/spawn
+ *   body: { agent, dir, sessionId? }
+ *   → 200 { ok: true, sessionId, pid, status }
+ *
+ * Semantics (mirrors the old Tauri PTY reconnect logic):
+ *   - No `sessionId` → new interactive session. A UUID is allocated; for
+ *     codex-cli we re-key to the session id codex writes to disk.
+ *   - `sessionId` present:
+ *       • PTY is live for that id   → noop; xterm attach will reconnect.
+ *       • PTY exited / not present  → spawn fresh using `resumeArgs`.
+ *
+ * `status` is one of `"new" | "reconnect" | "resumed"` so the caller knows
+ * what happened.
+ */
+export declare const codingSpawnRoute: FastifyPluginAsync;
+//# sourceMappingURL=coding_spawn.d.ts.map

package/dist/server/api/coding/coding_spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding_spawn.d.ts","sourceRoot":"","sources":["../../../../src/server/api/coding/coding_spawn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAehD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAqH9B,CAAC"}

package/dist/server/api/coding/coding_spawn.js

@@ -0,0 +1,121 @@
+import { randomUUID } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { getAgentConfig, buildStartArgs, buildResumeArgs, startAgentProcess, } from '../../../utils/coding-runner.js';
+import { upsertSession, deleteSession } from '../../../utils/coding-sessions.js';
+import { listFolders, resolveFolderForPath } from '../../../config/folders.js';
+import { ptyManager } from '../../../server/pty/manager.js';
+import { findLatestCodexSession } from '../../../utils/coding-agents/index.js';
+import { gatewayLog } from '../../../server/gateway-log.js';
+/**
+ * Spawn (or resume) a coding agent's interactive TUI so the xterm WS has a
+ * PTY to attach to. This is a webapp-only primitive — LLM callers use
+ * `coding_ask` which requires a prompt.
+ *
+ *   POST /api/coding/spawn
+ *   body: { agent, dir, sessionId? }
+ *   → 200 { ok: true, sessionId, pid, status }
+ *
+ * Semantics (mirrors the old Tauri PTY reconnect logic):
+ *   - No `sessionId` → new interactive session. A UUID is allocated; for
+ *     codex-cli we re-key to the session id codex writes to disk.
+ *   - `sessionId` present:
+ *       • PTY is live for that id   → noop; xterm attach will reconnect.
+ *       • PTY exited / not present  → spawn fresh using `resumeArgs`.
+ *
+ * `status` is one of `"new" | "reconnect" | "resumed"` so the caller knows
+ * what happened.
+ */
+export const codingSpawnRoute = async (app) => {
+    app.post('/spawn', async (req, reply) => {
+        const body = (req.body ?? {});
+        if (!body.agent || !body.dir) {
+            reply.code(400);
+            return { ok: false, error: 'agent and dir are required' };
+        }
+        if (!existsSync(body.dir)) {
+            reply.code(400);
+            return { ok: false, error: `dir "${body.dir}" does not exist` };
+        }
+        if (listFolders().length > 0) {
+            const folder = resolveFolderForPath(body.dir, 'coding');
+            if (!folder) {
+                reply.code(403);
+                return {
+                    ok: false,
+                    error: `dir "${body.dir}" is not inside a coding-scoped folder`,
+                };
+            }
+        }
+        const config = getAgentConfig(body.agent);
+        if (!config) {
+            reply.code(400);
+            return {
+                ok: false,
+                error: `agent "${body.agent}" is not configured on this gateway`,
+            };
+        }
+        const isResume = Boolean(body.sessionId);
+        // Reconnect short-circuit: if the PTY is live for this id, don't respawn
+        // — xterm `attach` will replay the scrollback and keep streaming. Stale
+        // (exited) handles at the same id are dropped by `ptyManager.spawn`.
+        if (isResume && ptyManager.isRunning(body.sessionId)) {
+            return {
+                ok: true,
+                sessionId: body.sessionId,
+                pid: ptyManager.getPid(body.sessionId),
+                status: 'reconnect',
+            };
+        }
+        let sessionId = body.sessionId ?? randomUUID();
+        const args = isResume
+            ? buildResumeArgs(config, { sessionId })
+            : buildStartArgs(config, { sessionId });
+        if (isResume && args.length === 0) {
+            reply.code(400);
+            return {
+                ok: false,
+                error: `agent "${body.agent}" has no resumeArgs configured`,
+            };
+        }
+        const startedAt = Date.now();
+        upsertSession({ sessionId, agent: body.agent, dir: body.dir, startedAt });
+        gatewayLog(`spawn: agent=${body.agent} dir=${body.dir} sessionId=${sessionId} ${isResume ? 'resume' : 'new'}`);
+        const { pid, error } = startAgentProcess(sessionId, config, args, body.dir, gatewayLog);
+        if (error) {
+            deleteSession(sessionId);
+            gatewayLog(`spawn FAILED: ${error}`);
+            reply.code(500);
+            return { ok: false, error: `failed to spawn: ${error}` };
+        }
+        upsertSession({
+            sessionId,
+            agent: body.agent,
+            dir: body.dir,
+            pid,
+            startedAt,
+        });
+        // codex-cli writes a session file named with its own UUID. Re-key our
+        // record so downstream lookups (read_session, resume) find the right file.
+        if (!isResume && body.agent === 'codex-cli') {
+            const found = await findLatestCodexSession(body.dir, startedAt);
+            if (found && found.sessionId !== sessionId) {
+                deleteSession(sessionId);
+                sessionId = found.sessionId;
+                upsertSession({
+                    sessionId,
+                    agent: body.agent,
+                    dir: body.dir,
+                    pid,
+                    startedAt,
+                });
+            }
+        }
+        return {
+            ok: true,
+            sessionId,
+            pid,
+            status: isResume ? 'resumed' : 'new',
+        };
+    });
+};
+//# sourceMappingURL=coding_spawn.js.map

package/dist/server/api/coding/coding_spawn.js.map

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

package/dist/server/api/coding/coding_xterm_session.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyPluginAsync } from 'fastify';
+export declare const xtermSessionRoute: FastifyPluginAsync;
+//# sourceMappingURL=coding_xterm_session.d.ts.map

package/dist/server/api/coding/coding_xterm_session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding_xterm_session.d.ts","sourceRoot":"","sources":["../../../../src/server/api/coding/coding_xterm_session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,SAAS,CAAC;AA4GhD,eAAO,MAAM,iBAAiB,EAAE,kBAqG/B,CAAC"}

package/dist/server/api/coding/coding_xterm_session.js

@@ -0,0 +1,163 @@
+import { ptyManager } from '../../../server/pty/manager.js';
+import { upsertSession } from '../../../utils/coding-sessions.js';
+import { scanAllSessions } from '../../../utils/coding-agents/index.js';
+import { getAgentConfig, buildResumeArgs, startAgentProcess, } from '../../../utils/coding-runner.js';
+import { gatewayLog } from '../../../server/gateway-log.js';
+/**
+ * WebSocket endpoint that attaches to a coding session's PTY, automatically
+ * resuming the agent when the PTY no longer exists.
+ *
+ *   GET /api/coding/coding_xterm_session?session_id=<id>
+ *
+ * Resume metadata is read from the agent's own on-disk transcripts (claude
+ * `.jsonl` / codex session files) — `sessions.json` carries a stale `dir`
+ * (the path the user asked for) whereas the transcript records the agent's
+ * real `cwd`, which is what `--resume` needs. If the session id isn't found
+ * on disk anywhere, we close with 4404 — there's nothing to resume.
+ *
+ * Behavior on connect (after attach):
+ *   - Replays the scrollback buffer (≤256 KB).
+ *   - Streams new PTY output bytes as raw WS text frames.
+ *   - Forwards incoming WS messages to the PTY — plain text is written to stdin;
+ *     JSON `{"kind":"input","data":"..."}` writes `data`; JSON
+ *     `{"kind":"resize","cols":N,"rows":M}` resizes the PTY.
+ *   - If the PTY has already exited, replays the buffer then closes.
+ */
+async function resolveSessionMeta(sessionId) {
+    try {
+        const { sessions } = await scanAllSessions({});
+        gatewayLog(`xterm resolve: scanned ${sessions.length} sessions for ${sessionId}`);
+        const found = sessions.find(s => s.sessionId === sessionId);
+        if (!found) {
+            gatewayLog(`xterm resolve: session ${sessionId} not in any agent dir`);
+            return null;
+        }
+        gatewayLog(`xterm resolve: session ${sessionId} agent=${found.agent} dir=${found.dir}`);
+        if (!found.dir || !found.agent) {
+            gatewayLog(`xterm resolve: incomplete metadata (agent=${found.agent}, dir=${found.dir})`);
+            return null;
+        }
+        return { agent: found.agent, dir: found.dir };
+    }
+    catch (err) {
+        gatewayLog(`xterm resolve: scan failed: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+function tryRespawn(sessionId, meta) {
+    const config = getAgentConfig(meta.agent);
+    if (!config) {
+        return {
+            ok: false,
+            reason: `agent "${meta.agent}" not configured on this gateway`,
+        };
+    }
+    const args = buildResumeArgs(config, { sessionId });
+    if (args.length === 0) {
+        return {
+            ok: false,
+            reason: `agent "${meta.agent}" has no resumeArgs configured`,
+        };
+    }
+    const startedAt = Date.now();
+    upsertSession({ sessionId, agent: meta.agent, dir: meta.dir, startedAt });
+    gatewayLog(`xterm resume: agent=${meta.agent} dir=${meta.dir} sessionId=${sessionId}`);
+    const { pid, error } = startAgentProcess(sessionId, config, args, meta.dir, gatewayLog);
+    if (error) {
+        gatewayLog(`xterm resume FAILED: ${error}`);
+        return { ok: false, reason: `failed to spawn: ${error}` };
+    }
+    upsertSession({
+        sessionId,
+        agent: meta.agent,
+        dir: meta.dir,
+        pid,
+        startedAt,
+    });
+    return { ok: true, pid };
+}
+export const xtermSessionRoute = async (app) => {
+    app.get('/coding_xterm_session', { websocket: true }, async (socket, req) => {
+        const sessionId = req.query?.session_id;
+        if (!sessionId) {
+            socket.close(4400, 'session_id query param required');
+            return;
+        }
+        const onData = (data) => {
+            if (socket.readyState === socket.OPEN) {
+                socket.send(data);
+            }
+        };
+        const onExit = ({ exitCode, signal, }) => {
+            if (socket.readyState === socket.OPEN) {
+                socket.send(JSON.stringify({ kind: 'exit', exitCode, signal }));
+                socket.close(1000, `pty exited (${exitCode})`);
+            }
+        };
+        let attach = ptyManager.attach(sessionId, onData, onExit);
+        // Resume only when there's no handle for this id at all. If a handle
+        // exists but exited (e.g. user typed `exit` in a shell session), fall
+        // through to the standard "replay buffer + emit exit + close" path
+        // below — re-spawning a fresh agent over a non-coding PTY would be
+        // surprising. `resolveSessionMeta` deliberately scans agent
+        // transcripts only, so resume targets coding sessions.
+        if (!attach) {
+            const meta = await resolveSessionMeta(sessionId);
+            if (!meta) {
+                socket.close(4404, `no session "${sessionId}" — cannot resume`);
+                return;
+            }
+            const result = tryRespawn(sessionId, meta);
+            if (!result.ok) {
+                socket.close(4500, result.reason);
+                return;
+            }
+            attach = ptyManager.attach(sessionId, onData, onExit);
+            if (!attach) {
+                socket.close(4500, 'spawned session but failed to attach');
+                return;
+            }
+        }
+        // Replay scrollback buffer
+        if (attach.replayed) {
+            socket.send(attach.replayed);
+        }
+        // If it already exited, replay + close
+        if (attach.exited) {
+            socket.send(JSON.stringify({
+                kind: 'exit',
+                exitCode: attach.exitInfo?.exitCode ?? null,
+                signal: attach.exitInfo?.signal ?? null,
+            }));
+            socket.close(1000, 'pty already exited');
+            attach.detach();
+            return;
+        }
+        socket.on('message', (raw) => {
+            const msg = typeof raw === 'string' ? raw : raw.toString('utf8');
+            // Try JSON envelope first
+            try {
+                const parsed = JSON.parse(msg);
+                if (parsed && typeof parsed === 'object') {
+                    if (parsed.kind === 'input' && typeof parsed.data === 'string') {
+                        ptyManager.write(sessionId, parsed.data);
+                        return;
+                    }
+                    if (parsed.kind === 'resize' && typeof parsed.cols === 'number' && typeof parsed.rows === 'number') {
+                        ptyManager.resize(sessionId, parsed.cols, parsed.rows);
+                        return;
+                    }
+                }
+            }
+            catch {
+                /* not JSON — fall through to raw */
+            }
+            // Fallback: write raw bytes (CLI xterm clients send keystrokes directly)
+            ptyManager.write(sessionId, msg);
+        });
+        socket.on('close', () => {
+            attach.detach();
+        });
+    });
+};
+//# sourceMappingURL=coding_xterm_session.js.map

package/dist/server/api/coding/coding_xterm_session.js.map

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

package/dist/server/api/coding/index.d.ts

@@ -0,0 +1,10 @@
+import type { FastifyPluginAsync } from 'fastify';
+/**
+ * Mounted at `/api/coding`. Registers one POST route per coding tool, the
+ * xterm WebSocket attach route, and the webapp-only `spawn` primitive used
+ * by the new coding session flow. Agent authentication is set up via env
+ * vars (`CLAUDE_CODE_OAUTH_TOKEN`, `OPENAI_API_KEY`) at gateway boot — no
+ * web UI for it.
+ */
+export declare const codingRoutes: FastifyPluginAsync;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/api/coding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/api/coding/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAMhD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,kBAI1B,CAAC"}

package/dist/server/api/coding/index.js

@@ -0,0 +1,17 @@
+import { codingTools, executeCodingTool } from '../../../server/tools/coding-tools.js';
+import { makeToolGroupRoutes } from '../tool-group.js';
+import { xtermSessionRoute } from './coding_xterm_session.js';
+import { codingSpawnRoute } from './coding_spawn.js';
+/**
+ * Mounted at `/api/coding`. Registers one POST route per coding tool, the
+ * xterm WebSocket attach route, and the webapp-only `spawn` primitive used
+ * by the new coding session flow. Agent authentication is set up via env
+ * vars (`CLAUDE_CODE_OAUTH_TOKEN`, `OPENAI_API_KEY`) at gateway boot — no
+ * web UI for it.
+ */
+export const codingRoutes = async (app) => {
+    await app.register(makeToolGroupRoutes(codingTools, executeCodingTool));
+    await app.register(xtermSessionRoute);
+    await app.register(codingSpawnRoute);
+};
+//# sourceMappingURL=index.js.map

package/dist/server/api/coding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/api/coding/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAE,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,EAAC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAC,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAuB,KAAK,EAAE,GAAG,EAAE,EAAE;IAC7D,MAAM,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACxE,MAAM,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACtC,MAAM,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AACtC,CAAC,CAAC"}

package/dist/server/api/exec/index.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyPluginAsync } from 'fastify';
+export declare const execRoutes: FastifyPluginAsync;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/api/exec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/api/exec/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAIhD,eAAO,MAAM,UAAU,EAAE,kBAExB,CAAC"}

package/dist/server/api/exec/index.js

@@ -0,0 +1,6 @@
+import { execTools, executeExecTool } from '../../../server/tools/exec-tools.js';
+import { makeToolGroupRoutes } from '../tool-group.js';
+export const execRoutes = async (app) => {
+    await app.register(makeToolGroupRoutes(execTools, executeExecTool));
+};
+//# sourceMappingURL=index.js.map

package/dist/server/api/exec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/api/exec/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAE,eAAe,EAAC,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAElD,MAAM,CAAC,MAAM,UAAU,GAAuB,KAAK,EAAE,GAAG,EAAE,EAAE;IAC3D,MAAM,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC"}