@shardworks/claude-code-apparatus 0.1.148 → 0.1.149

package/README.md

@@ -0,0 +1,148 @@
+# `@shardworks/claude-code-apparatus`
+
+Claude Code session provider apparatus for Nexus. Implements the `AnimatorSessionProvider` interface for the Claude Code CLI, enabling the Animator to launch and manage AI sessions. Also provides the **Session Babysitter** — a detached process that hosts sessions independently of the guild lifecycle.
+
+Depends on `@shardworks/animator-apparatus` (types), `@shardworks/tools-apparatus` (tool definitions and routing), and `@shardworks/nexus-core`.
+
+---
+
+## Installation
+
+```json
+{
+  "dependencies": {
+    "@shardworks/claude-code-apparatus": "workspace:*"
+  }
+}
+```
+
+## API
+
+### Session Provider
+
+The default export is a `Plugin` whose apparatus `provides` an `AnimatorSessionProvider`:
+
+```typescript
+import createClaudeCodeProvider from '@shardworks/claude-code-apparatus';
+
+// In guild.json:
+// { "animator": { "sessionProvider": "claude-code" } }
+```
+
+The provider implements `launch()` and `cancel()`:
+
+- **`launch(config)`** — spawns `claude` in autonomous mode (`--print -`, `--output-format stream-json`). When `config.streaming` is true, yields `SessionChunk` objects in real-time. Returns `{ chunks, result, processInfo }`.
+- **`cancel(cancelMetadata)`** — sends SIGTERM to the claude process using the PID from `cancelMetadata`.
+
+### MCP Server
+
+The package exports functions for running MCP tool servers:
+
+```typescript
+import { createMcpServer, startMcpHttpServer } from '@shardworks/claude-code-apparatus';
+
+// Create an MCP server with resolved tool definitions
+const mcpServer = await createMcpServer(toolDefinitions);
+
+// Or start an HTTP server on an ephemeral port
+const handle = await startMcpHttpServer(toolDefinitions);
+console.log(handle.url); // "http://127.0.0.1:PORT/sse"
+await handle.close();    // cleanup
+```
+
+### Stream Parsing
+
+Exported utilities for parsing Claude's NDJSON output:
+
+```typescript
+import {
+  processNdjsonBuffer,
+  parseStreamJsonMessage,
+  extractFinalAssistantText,
+} from '@shardworks/claude-code-apparatus';
+```
+
+- **`processNdjsonBuffer(buffer, handler)`** — splits NDJSON buffer on newlines, calls handler for each parsed JSON object, returns remaining incomplete buffer.
+- **`parseStreamJsonMessage(msg, acc)`** — processes a single NDJSON message, accumulates transcript/metrics, returns `SessionChunk[]`.
+- **`extractFinalAssistantText(transcript)`** — walks transcript backwards to find the last assistant message's text content.
+
+## Session Babysitter
+
+The babysitter is a standalone Node.js script that runs as a detached process, hosting a claude session independently of the guild. It survives guild restarts.
+
+### Entry Point
+
+```bash
+node dist/babysitter.js  # reads config from stdin
+```
+
+Or import the module for programmatic use:
+
+```typescript
+import { runBabysitter } from '@shardworks/claude-code-apparatus/babysitter';
+```
+
+### Config (via stdin)
+
+The spawning process writes JSON config to the babysitter's stdin:
+
+```typescript
+interface BabysitterConfig {
+  sessionId: string;           // Pre-generated session ID
+  guildToolUrl: string;        // Guild's Tool HTTP API URL (e.g. "http://127.0.0.1:7471")
+  dbPath: string;              // Path to guild's SQLite database
+  claudeArgs: string[];        // CLI args for claude (--model, --system-prompt-file, etc.)
+  cwd: string;                 // Working directory for the claude process
+  env: Record<string, string>; // Environment variables for the claude process
+  prompt: string;              // Initial prompt piped to claude's stdin
+  tools: SerializedTool[];     // Tool definitions with JSON Schema params
+  startedAt: string;           // ISO timestamp of session start
+  provider: string;            // Provider name (e.g. "claude-code")
+  metadata?: Record<string, unknown>;  // Optional session metadata
+}
+
+interface SerializedTool {
+  name: string;
+  description: string;
+  params: Record<string, unknown>;  // JSON Schema
+}
+```
+
+### Lifecycle
+
+1. **Read config** from stdin, parse JSON, validate required fields
+2. **Open SQLite** (WAL mode) for real-time transcript streaming
+3. **Start MCP/SSE proxy server** — registers tools that forward calls to the guild's Tool HTTP API with retry and exponential backoff
+4. **Prepare session files** — temp directory, mcp-config.json pointing to the proxy server
+5. **Spawn claude** — pipes prompt to stdin, captures NDJSON stdout
+6. **Report "running"** — calls `session-running` tool on guild via HTTP (DLQ fallback)
+7. **Stream transcript** — parses NDJSON, writes to `books_animator_transcripts` table in SQLite after each message batch
+8. **Report result** — calls `session-record` tool on guild via HTTP (DLQ fallback)
+9. **Cleanup** — close MCP server, close SQLite, remove temp directory
+
+### Error Handling
+
+- **Tool call proxy errors**: retried with exponential backoff (1s initial, 8s max, 60s timeout). If retries exhaust, returns error to claude as MCP tool result — doesn't crash.
+- **Lifecycle reporting errors**: if guild is unreachable, payload is written to `.nexus/dlq/{sessionId}[-running].json` for later drain.
+- **Top-level errors**: attempts to report `status: 'failed'` to guild, falls back to DLQ, then exits non-zero.
+
+## Exports
+
+| Entry point | Description |
+|---|---|
+| `.` (`src/index.ts`) | Session provider plugin, MCP server, stream parsing utilities |
+| `./babysitter` (`src/babysitter.ts`) | Babysitter module — `runBabysitter()`, config parsing, proxy server, transcript DB |
+
+## Configuration
+
+Configured in `guild.json` under the `animator` key:
+
+```json
+{
+  "animator": {
+    "sessionProvider": "claude-code"
+  }
+}
+```
+
+No additional configuration fields. The model is passed per-session via the Animator.

package/dist/babysitter.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Session Babysitter — detached process that hosts a claude session.
+ *
+ * A standalone Node.js script that:
+ * 1. Reads config from stdin (spawned by the claude-code provider)
+ * 2. Opens the guild's SQLite database for transcript streaming
+ * 3. Starts an MCP/SSE server that proxies tool calls to the guild
+ * 4. Spawns claude with prepared session files
+ * 5. Reports session lifecycle events via the guild's HTTP API
+ * 6. Streams transcript data to SQLite in real-time
+ * 7. Reports the final result and cleans up
+ *
+ * The babysitter is a detached process: it survives guild restarts.
+ * All guild communication is via HTTP (tool server) and SQLite (transcripts).
+ *
+ * See: docs/architecture/detached-sessions.md
+ */
+import { spawn } from 'node:child_process';
+import { type StreamJsonResult } from './index.ts';
+/** A serialized tool definition as received in the babysitter config. */
+export interface SerializedTool {
+    /** Tool name (e.g. 'writ-list'). */
+    name: string;
+    /** Tool description. */
+    description: string;
+    /** JSON Schema for the tool's input parameters. */
+    params: Record<string, unknown>;
+}
+/** Config written to the babysitter's stdin by the spawning process. */
+export interface BabysitterConfig {
+    sessionId: string;
+    guildToolUrl: string;
+    dbPath: string;
+    claudeArgs: string[];
+    cwd: string;
+    env: Record<string, string>;
+    prompt: string;
+    tools: SerializedTool[];
+    startedAt: string;
+    provider: string;
+    metadata?: Record<string, unknown>;
+}
+export interface McpProxyHandle {
+    /** URL for --mcp-config (e.g. "http://127.0.0.1:PORT/sse"). */
+    url: string;
+    /** Shut down the HTTP server and MCP transport. */
+    close(): Promise<void>;
+}
+/**
+ * Read the babysitter config from stdin.
+ *
+ * Reads stdin to completion, parses the JSON, and validates required fields.
+ * The spawning process writes config and closes the write end.
+ */
+export declare function readConfigFromStdin(stream?: NodeJS.ReadableStream): Promise<BabysitterConfig>;
+/**
+ * Call a guild HTTP API endpoint with exponential backoff retry.
+ *
+ * Retries on connection errors (ECONNREFUSED, ECONNRESET, ETIMEDOUT).
+ * Returns the parsed JSON response on success.
+ * Throws after RETRY_TIMEOUT_MS of retrying.
+ */
+export declare function callGuildHttpApi(url: string, sessionId: string, body: unknown, timeoutMs?: number): Promise<unknown>;
+/**
+ * Write a payload to the Dead Letter Queue.
+ *
+ * Creates the DLQ directory if it doesn't exist. Writes the payload as
+ * pretty-printed JSON. Used as a fallback when the guild HTTP API is
+ * unreachable for lifecycle calls.
+ */
+export declare function writeToDlq(cwd: string, filename: string, payload: unknown): void;
+/**
+ * Create an MCP/SSE HTTP server that proxies tool calls to the guild.
+ *
+ * For each tool in the config, registers an MCP tool whose handler
+ * forwards the call to the guild's Tool HTTP API via HTTP POST.
+ *
+ * Uses the low-level MCP Server class to register tools with raw
+ * JSON Schema (the serialized params from the config).
+ */
+export declare function createProxyMcpHttpServer(tools: SerializedTool[], guildToolUrl: string, sessionId: string): Promise<McpProxyHandle>;
+/** Minimal interface for the SQLite database used by the babysitter. */
+export interface TranscriptDb {
+    /** Write a transcript entry (id, content JSON). */
+    writeTranscript(sessionId: string, content: string): void;
+    /** Close the database connection. */
+    close(): void;
+}
+/**
+ * Open the guild's SQLite database for transcript streaming.
+ *
+ * Creates the database file and table if they don't exist.
+ * Enables WAL mode for concurrent read access by other processes
+ * (Oculus, CLI queries, other agents).
+ *
+ * Uses dynamic import() to load better-sqlite3 at runtime. This avoids
+ * requiring the native module at import time (beneficial for type-checking
+ * and testing).
+ */
+export declare function openTranscriptDb(dbPath: string): Promise<TranscriptDb>;
+/**
+ * Initialize a TranscriptDb from a Database constructor.
+ *
+ * Shared logic between openTranscriptDb() and test injection.
+ * Exported for testing — allows injecting a mock Database constructor.
+ */
+export declare function initTranscriptDb(DatabaseConstructor: new (path: string) => {
+    pragma(stmt: string): unknown;
+    prepare(sql: string): {
+        run(...params: unknown[]): void;
+    };
+    exec(sql: string): void;
+    close(): void;
+}, dbPath: string): TranscriptDb;
+/**
+ * Write the current transcript to SQLite.
+ */
+export declare function writeTranscript(db: TranscriptDb, sessionId: string, messages: Record<string, unknown>[]): void;
+/**
+ * Report "running" status to the guild via the session-running tool.
+ *
+ * If the guild is unreachable, writes the payload to the DLQ.
+ */
+export declare function reportRunning(config: BabysitterConfig, claudePid: number, timeoutMs?: number): Promise<void>;
+/**
+ * Report the final session result to the guild via the session-record tool.
+ *
+ * If the guild is unreachable, writes the payload to the DLQ.
+ */
+export declare function reportResult(config: BabysitterConfig, result: StreamJsonResult, transcript: Record<string, unknown>[], timeoutMs?: number): Promise<void>;
+/**
+ * Run the session babysitter.
+ *
+ * This is the main orchestration function. It:
+ * 1. Opens SQLite for transcript streaming
+ * 2. Starts the MCP proxy server
+ * 3. Prepares session files (tmpDir, system prompt, mcp-config)
+ * 4. Spawns claude
+ * 5. Reports "running" status
+ * 6. Streams transcript to SQLite
+ * 7. Reports result on exit
+ * 8. Cleans up
+ */
+export declare function runBabysitter(config: BabysitterConfig, deps?: {
+    /** Injected TranscriptDb for testing (avoids loading better-sqlite3). */
+    db?: TranscriptDb;
+    /** Override spawn for testing. */
+    spawnFn?: typeof spawn;
+    /** Override retry timeout for testing (default: 60_000ms). */
+    retryTimeoutMs?: number;
+}): Promise<void>;
+//# sourceMappingURL=babysitter.d.ts.map

package/dist/babysitter.d.ts.map

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

package/dist/babysitter.js

@@ -0,0 +1,471 @@
+/**
+ * Session Babysitter — detached process that hosts a claude session.
+ *
+ * A standalone Node.js script that:
+ * 1. Reads config from stdin (spawned by the claude-code provider)
+ * 2. Opens the guild's SQLite database for transcript streaming
+ * 3. Starts an MCP/SSE server that proxies tool calls to the guild
+ * 4. Spawns claude with prepared session files
+ * 5. Reports session lifecycle events via the guild's HTTP API
+ * 6. Streams transcript data to SQLite in real-time
+ * 7. Reports the final result and cleans up
+ *
+ * The babysitter is a detached process: it survives guild restarts.
+ * All guild communication is via HTTP (tool server) and SQLite (transcripts).
+ *
+ * See: docs/architecture/detached-sessions.md
+ */
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import http from 'node:http';
+import { fileURLToPath } from 'node:url';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { toolNameToRoute } from '@shardworks/tools-apparatus';
+import { processNdjsonBuffer, parseStreamJsonMessage, extractFinalAssistantText, } from "./index.js";
+// ── Retry constants ─────────────────────────────────────────────────────
+const RETRY_INITIAL_DELAY_MS = 1_000;
+const RETRY_MAX_DELAY_MS = 8_000;
+const RETRY_TIMEOUT_MS = 60_000;
+const RETRYABLE_CODES = new Set(['ECONNREFUSED', 'ECONNRESET', 'ETIMEDOUT']);
+// ── stdin config reader ─────────────────────────────────────────────────
+/**
+ * Read the babysitter config from stdin.
+ *
+ * Reads stdin to completion, parses the JSON, and validates required fields.
+ * The spawning process writes config and closes the write end.
+ */
+export async function readConfigFromStdin(stream = process.stdin) {
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    const raw = Buffer.concat(chunks).toString('utf-8');
+    if (!raw.trim()) {
+        throw new Error('Empty config received on stdin');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Invalid JSON config on stdin: ${raw.slice(0, 200)}`);
+    }
+    const config = parsed;
+    // Validate required fields
+    const required = [
+        'sessionId', 'guildToolUrl', 'dbPath', 'claudeArgs',
+        'cwd', 'env', 'prompt', 'tools', 'startedAt', 'provider',
+    ];
+    for (const field of required) {
+        if (config[field] === undefined || config[field] === null) {
+            throw new Error(`Missing required config field: ${field}`);
+        }
+    }
+    return config;
+}
+// ── HTTP retry helper ───────────────────────────────────────────────────
+/**
+ * Call a guild HTTP API endpoint with exponential backoff retry.
+ *
+ * Retries on connection errors (ECONNREFUSED, ECONNRESET, ETIMEDOUT).
+ * Returns the parsed JSON response on success.
+ * Throws after RETRY_TIMEOUT_MS of retrying.
+ */
+export async function callGuildHttpApi(url, sessionId, body, timeoutMs = RETRY_TIMEOUT_MS) {
+    const startTime = Date.now();
+    let delay = RETRY_INITIAL_DELAY_MS;
+    let lastError;
+    while (Date.now() - startTime < timeoutMs) {
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Session-Id': sessionId,
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => '');
+                throw new Error(`HTTP ${response.status}: ${text.slice(0, 500)}`);
+            }
+            return await response.json();
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            // Check if the error is retryable (connection-level error)
+            const code = err.code;
+            const cause = err.cause;
+            const causeCode = cause?.code;
+            const isRetryable = (code && RETRYABLE_CODES.has(code)) ||
+                (causeCode && RETRYABLE_CODES.has(causeCode)) ||
+                (lastError.message.includes('fetch failed'));
+            if (!isRetryable) {
+                throw lastError;
+            }
+            // Wait before retrying
+            const remaining = timeoutMs - (Date.now() - startTime);
+            if (remaining <= 0)
+                break;
+            await new Promise((resolve) => setTimeout(resolve, Math.min(delay, remaining)));
+            delay = Math.min(delay * 2, RETRY_MAX_DELAY_MS);
+        }
+    }
+    throw new Error(`Guild HTTP API unreachable after ${timeoutMs}ms: ${lastError?.message ?? 'unknown error'}`);
+}
+// ── DLQ writer ──────────────────────────────────────────────────────────
+/**
+ * Write a payload to the Dead Letter Queue.
+ *
+ * Creates the DLQ directory if it doesn't exist. Writes the payload as
+ * pretty-printed JSON. Used as a fallback when the guild HTTP API is
+ * unreachable for lifecycle calls.
+ */
+export function writeToDlq(cwd, filename, payload) {
+    const dlqDir = path.join(cwd, '.nexus', 'dlq');
+    fs.mkdirSync(dlqDir, { recursive: true });
+    fs.writeFileSync(path.join(dlqDir, filename), JSON.stringify(payload, null, 2));
+}
+// ── MCP proxy server ────────────────────────────────────────────────────
+/**
+ * Create an MCP/SSE HTTP server that proxies tool calls to the guild.
+ *
+ * For each tool in the config, registers an MCP tool whose handler
+ * forwards the call to the guild's Tool HTTP API via HTTP POST.
+ *
+ * Uses the low-level MCP Server class to register tools with raw
+ * JSON Schema (the serialized params from the config).
+ */
+export async function createProxyMcpHttpServer(tools, guildToolUrl, sessionId) {
+    const server = new Server({ name: 'nexus-guild-proxy', version: '0.0.0' }, { capabilities: { tools: {} } });
+    // Register tools/list handler — advertises all tools with their JSON Schema.
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: {
+                type: 'object',
+                ...t.params,
+            },
+        })),
+    }));
+    // Register tools/call handler — proxies each call to the guild HTTP API.
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const toolName = request.params.name;
+        const params = request.params.arguments ?? {};
+        const route = toolNameToRoute(toolName);
+        const url = `${guildToolUrl}${route}`;
+        try {
+            const result = await callGuildHttpApi(url, sessionId, params);
+            const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+            return {
+                content: [{ type: 'text', text }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // Wrap in HTTP server with SSE transport (same pattern as mcp-server.ts).
+    let transport = null;
+    const httpServer = http.createServer(async (req, res) => {
+        try {
+            if (req.method === 'GET' && req.url === '/sse') {
+                transport = new SSEServerTransport('/message', res);
+                await server.connect(transport);
+            }
+            else if (req.method === 'POST' && req.url?.startsWith('/message')) {
+                if (!transport) {
+                    res.writeHead(400).end('No active SSE connection');
+                    return;
+                }
+                await transport.handlePostMessage(req, res);
+            }
+            else {
+                res.writeHead(404).end('Not found');
+            }
+        }
+        catch {
+            if (!res.headersSent) {
+                res.writeHead(500).end('Internal Server Error');
+            }
+        }
+    });
+    await new Promise((resolve) => {
+        httpServer.listen(0, '127.0.0.1', resolve);
+    });
+    const addr = httpServer.address();
+    if (!addr || typeof addr === 'string') {
+        throw new Error('Failed to get MCP proxy server address');
+    }
+    const url = `http://127.0.0.1:${addr.port}/sse`;
+    return {
+        url,
+        async close() {
+            if (transport) {
+                await transport.close();
+            }
+            await new Promise((resolve, reject) => {
+                httpServer.close((err) => (err ? reject(err) : resolve()));
+            });
+        },
+    };
+}
+/**
+ * Open the guild's SQLite database for transcript streaming.
+ *
+ * Creates the database file and table if they don't exist.
+ * Enables WAL mode for concurrent read access by other processes
+ * (Oculus, CLI queries, other agents).
+ *
+ * Uses dynamic import() to load better-sqlite3 at runtime. This avoids
+ * requiring the native module at import time (beneficial for type-checking
+ * and testing).
+ */
+export async function openTranscriptDb(dbPath) {
+    const { default: Database } = await import('better-sqlite3');
+    return initTranscriptDb(Database, dbPath);
+}
+/**
+ * Initialize a TranscriptDb from a Database constructor.
+ *
+ * Shared logic between openTranscriptDb() and test injection.
+ * Exported for testing — allows injecting a mock Database constructor.
+ */
+export function initTranscriptDb(DatabaseConstructor, dbPath) {
+    const raw = new DatabaseConstructor(dbPath);
+    raw.pragma('journal_mode = WAL');
+    raw.exec(`
+    CREATE TABLE IF NOT EXISTS books_animator_transcripts (
+      id      TEXT PRIMARY KEY,
+      content TEXT NOT NULL
+    )
+  `);
+    const stmt = raw.prepare('INSERT OR REPLACE INTO books_animator_transcripts (id, content) VALUES (?, ?)');
+    return {
+        writeTranscript(sessionId, content) {
+            stmt.run(sessionId, content);
+        },
+        close() {
+            raw.close();
+        },
+    };
+}
+/**
+ * Write the current transcript to SQLite.
+ */
+export function writeTranscript(db, sessionId, messages) {
+    const content = JSON.stringify({ id: sessionId, messages });
+    db.writeTranscript(sessionId, content);
+}
+// ── Session lifecycle reporting ─────────────────────────────────────────
+/**
+ * Report "running" status to the guild via the session-running tool.
+ *
+ * If the guild is unreachable, writes the payload to the DLQ.
+ */
+export async function reportRunning(config, claudePid, timeoutMs) {
+    const route = toolNameToRoute('session-running');
+    const url = `${config.guildToolUrl}${route}`;
+    const payload = {
+        sessionId: config.sessionId,
+        startedAt: config.startedAt,
+        provider: config.provider,
+        metadata: config.metadata,
+        cancelMetadata: { pid: claudePid },
+    };
+    try {
+        await callGuildHttpApi(url, config.sessionId, payload, timeoutMs);
+    }
+    catch {
+        writeToDlq(config.cwd, `${config.sessionId}-running.json`, payload);
+    }
+}
+/**
+ * Report the final session result to the guild via the session-record tool.
+ *
+ * If the guild is unreachable, writes the payload to the DLQ.
+ */
+export async function reportResult(config, result, transcript, timeoutMs) {
+    const route = toolNameToRoute('session-record');
+    const url = `${config.guildToolUrl}${route}`;
+    const status = result.exitCode === 0 ? 'completed' : 'failed';
+    const output = extractFinalAssistantText(transcript);
+    const payload = {
+        sessionId: config.sessionId,
+        status,
+        exitCode: result.exitCode,
+        error: status === 'failed' ? `claude exited with code ${result.exitCode}` : undefined,
+        costUsd: result.costUsd,
+        tokenUsage: result.tokenUsage,
+        output,
+        providerSessionId: result.providerSessionId,
+        transcript,
+    };
+    try {
+        await callGuildHttpApi(url, config.sessionId, payload, timeoutMs);
+    }
+    catch {
+        writeToDlq(config.cwd, `${config.sessionId}.json`, payload);
+    }
+}
+// ── Main babysitter function ────────────────────────────────────────────
+/**
+ * Run the session babysitter.
+ *
+ * This is the main orchestration function. It:
+ * 1. Opens SQLite for transcript streaming
+ * 2. Starts the MCP proxy server
+ * 3. Prepares session files (tmpDir, system prompt, mcp-config)
+ * 4. Spawns claude
+ * 5. Reports "running" status
+ * 6. Streams transcript to SQLite
+ * 7. Reports result on exit
+ * 8. Cleans up
+ */
+export async function runBabysitter(config, deps) {
+    const spawnFn = deps?.spawnFn ?? spawn;
+    const retryTimeoutMs = deps?.retryTimeoutMs;
+    let db = null;
+    let mcpHandle = null;
+    let tmpDir = null;
+    let claudeProc = null;
+    try {
+        // 1. Open SQLite
+        db = deps?.db ?? await openTranscriptDb(config.dbPath);
+        // 2. Start MCP proxy server
+        mcpHandle = await createProxyMcpHttpServer(config.tools, config.guildToolUrl, config.sessionId);
+        // 3. Prepare session files
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'nsg-babysitter-'));
+        const args = [...config.claudeArgs];
+        // Write system prompt if present in args (already handled by claudeArgs)
+        // Write mcp-config pointing to the babysitter's MCP proxy server
+        const mcpConfig = {
+            mcpServers: {
+                'nexus-guild': {
+                    type: 'sse',
+                    url: mcpHandle.url,
+                },
+            },
+        };
+        const mcpConfigPath = path.join(tmpDir, 'mcp-config.json');
+        fs.writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig));
+        args.push('--mcp-config', mcpConfigPath, '--strict-mcp-config');
+        // Add autonomous mode flags
+        args.push('--print', '-', '--output-format', 'stream-json', '--verbose');
+        // 4. Spawn claude
+        claudeProc = spawnFn('claude', args, {
+            cwd: config.cwd,
+            stdio: ['pipe', 'pipe', 'inherit'],
+            env: { ...process.env, ...config.env },
+        });
+        // Pipe prompt to claude's stdin, then close
+        if (config.prompt) {
+            claudeProc.stdin.write(config.prompt);
+        }
+        claudeProc.stdin.end();
+        // 5. Report "running" status (don't await — fire and forget with retry)
+        const runningPromise = reportRunning(config, claudeProc.pid, retryTimeoutMs).catch((err) => {
+            process.stderr.write(`[babysitter] Failed to report running: ${err}\n`);
+        });
+        // 6. Consume stdout, stream transcript
+        const acc = { transcript: [] };
+        let buffer = '';
+        claudeProc.stdout.on('data', (chunk) => {
+            buffer += chunk.toString();
+            const prevLength = acc.transcript.length;
+            buffer = processNdjsonBuffer(buffer, (msg) => {
+                parseStreamJsonMessage(msg, acc);
+            });
+            // Write transcript to SQLite if new messages were added
+            if (acc.transcript.length > prevLength && db) {
+                writeTranscript(db, config.sessionId, acc.transcript);
+            }
+        });
+        // 7. Wait for claude to exit
+        const exitCode = await new Promise((resolve, reject) => {
+            claudeProc.on('error', (err) => {
+                reject(new Error(`Failed to spawn claude: ${err.message}`));
+            });
+            claudeProc.on('close', (code) => {
+                resolve(code ?? 1);
+            });
+        });
+        // Ensure running report completed before recording result
+        await runningPromise;
+        // Build result
+        const result = {
+            exitCode,
+            transcript: acc.transcript,
+            costUsd: acc.costUsd,
+            tokenUsage: acc.tokenUsage,
+            providerSessionId: acc.providerSessionId,
+        };
+        // 8. Report result
+        await reportResult(config, result, acc.transcript, retryTimeoutMs);
+    }
+    catch (err) {
+        // Top-level error: attempt to report failure
+        const message = err instanceof Error ? err.message : String(err);
+        try {
+            const route = toolNameToRoute('session-record');
+            const url = `${config.guildToolUrl}${route}`;
+            await callGuildHttpApi(url, config.sessionId, {
+                sessionId: config.sessionId,
+                status: 'failed',
+                exitCode: 1,
+                error: message,
+            }, retryTimeoutMs);
+        }
+        catch {
+            writeToDlq(config.cwd, `${config.sessionId}.json`, {
+                sessionId: config.sessionId,
+                status: 'failed',
+                exitCode: 1,
+                error: message,
+            });
+        }
+        throw err;
+    }
+    finally {
+        // 9. Cleanup
+        await mcpHandle?.close().catch(() => { });
+        db?.close();
+        if (tmpDir) {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    }
+}
+// ── Entry point ─────────────────────────────────────────────────────────
+/**
+ * Script entry point — reads config from stdin and runs the babysitter.
+ *
+ * Only executes when this file is run directly (not when imported).
+ */
+async function main() {
+    try {
+        const config = await readConfigFromStdin();
+        await runBabysitter(config);
+        process.exit(0);
+    }
+    catch (err) {
+        process.stderr.write(`[babysitter] Fatal error: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+}
+// Check if this module is the entry point
+const isEntryPoint = process.argv[1] &&
+    (process.argv[1] === fileURLToPath(import.meta.url) ||
+        process.argv[1].endsWith('/babysitter.js'));
+if (isEntryPoint) {
+    main();
+}
+//# sourceMappingURL=babysitter.js.map

package/dist/babysitter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardworks/claude-code-apparatus",
-  "version": "0.1.148",
+  "version": "0.1.149",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -13,16 +13,22 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./babysitter": {
+      "types": "./dist/babysitter.d.ts",
+      "import": "./dist/babysitter.js"
     }
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.27.1",
+    "better-sqlite3": "12.8.0",
     "zod": "4.3.6",
-    "@shardworks/tools-apparatus": "0.1.148",
-    "@shardworks/animator-apparatus": "0.1.148",
-    "@shardworks/nexus-core": "0.1.148"
+    "@shardworks/animator-apparatus": "0.1.149",
+    "@shardworks/nexus-core": "0.1.149",
+    "@shardworks/tools-apparatus": "0.1.149"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "7.6.13",
     "@types/node": "25.5.0"
   },
   "files": [