@shardworks/claude-code-apparatus 0.1.269 → 0.1.271

package/dist/runtime.js

@@ -0,0 +1,357 @@
+/**
+ * Babysitter runtime toolkit — single-purpose primitives shared by the
+ * orchestrator and proxy in `babysitter.ts`.
+ *
+ * Each export is a small, self-contained piece: stdin parsing, retrying
+ * HTTP, the DLQ writer, the SQLite trio, the lifecycle reporters, and
+ * the stderr redirector. The orchestrator composes them; this module
+ * does not know about the orchestrator.
+ *
+ * See: docs/architecture/detached-sessions.md
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { toolNameToRoute } from '@shardworks/tools-apparatus';
+import { 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']);
+/**
+ * Walk an error's cause chain looking for a retryable error code.
+ * Returns the first retryable code found, or null if none.
+ * Caps traversal depth to prevent infinite loops from circular cause chains.
+ */
+export function findRetryableCode(err, maxDepth = 5) {
+    let current = err;
+    for (let i = 0; i < maxDepth && current != null; i++) {
+        const code = current.code;
+        if (code && RETRYABLE_CODES.has(code)) {
+            return code;
+        }
+        current = current.cause;
+    }
+    return null;
+}
+// ── 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', 'logDir', '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.
+ */
+/**
+ * Encode a params object as a query string for GET requests.
+ *
+ * Scalars (string/number/boolean) become their string form. Arrays and
+ * objects are JSON-encoded so the tool-server can still parse them after
+ * its param coercion pass (though read-tools generally take scalar
+ * inputs). null/undefined values are skipped.
+ */
+function encodeParamsAsQuery(params) {
+    if (params == null || typeof params !== 'object')
+        return '';
+    const usp = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value == null)
+            continue;
+        if (typeof value === 'string') {
+            usp.set(key, value);
+        }
+        else if (typeof value === 'number' || typeof value === 'boolean') {
+            usp.set(key, String(value));
+        }
+        else {
+            usp.set(key, JSON.stringify(value));
+        }
+    }
+    const s = usp.toString();
+    return s.length > 0 ? `?${s}` : '';
+}
+export async function callGuildHttpApi(url, sessionId, body, timeoutMs = RETRY_TIMEOUT_MS, method = 'POST') {
+    const startTime = Date.now();
+    let delay = RETRY_INITIAL_DELAY_MS;
+    let lastError;
+    // GET can't carry a body — encode params as query string instead.
+    const targetUrl = method === 'GET' ? `${url}${encodeParamsAsQuery(body)}` : url;
+    const requestBody = method === 'GET' ? undefined : JSON.stringify(body);
+    while (Date.now() - startTime < timeoutMs) {
+        try {
+            const response = await fetch(targetUrl, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Session-Id': sessionId,
+                },
+                ...(requestBody !== undefined ? { body: requestBody } : {}),
+            });
+            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 in the cause chain)
+            const isRetryable = findRetryableCode(err) !== null;
+            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));
+}
+/**
+ * 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, cancelHandle, 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,
+        cancelHandle,
+    };
+    try {
+        await callGuildHttpApi(url, config.sessionId, payload, timeoutMs);
+    }
+    catch {
+        writeToDlq(config.cwd, `${config.sessionId}-running.json`, payload);
+    }
+}
+/**
+ * Resolve the terminal status and error text for a terminated session.
+ *
+ * Cascade order:
+ *   1. A `'cancelled'` override (SIGTERM path) — short-circuits.
+ *   2. A `terminationTag` already carried on the StreamJsonResult —
+ *      set by the NDJSON detection cascade inside
+ *      `parseStreamJsonMessage` (the only active detector).
+ *   3. Generic exit-code mapping (0 → completed, non-zero → failed).
+ *
+ * Generic non-zero exit codes surface as `'failed'`; the Animator's
+ * back-off machine only reacts to structured rate-limit terminals, and
+ * exit-code-based detection was retired because it produced
+ * false-positive pauses.
+ *
+ * Returns the payload status, a human-readable error string (only
+ * populated for the failed branches), and the tag that informed the
+ * decision (if any). The tag is forwarded to the guild so the Animator's
+ * back-off machine can disambiguate rate-limit terminations without
+ * pattern-matching on error text.
+ */
+export function resolveTerminalStatus(result, statusOverride) {
+    if (statusOverride === 'cancelled') {
+        return { status: 'cancelled' };
+    }
+    // Second priority: a structural NDJSON tag observed during stream
+    // parsing. Fire even on exit code 0 because claude may emit the
+    // rate-limit signal and still exit cleanly.
+    if (result.terminationTag) {
+        return {
+            status: 'rate-limited',
+            error: result.terminationTag.detail ?? `Anima provider reported a rate limit (source: ${result.terminationTag.source})`,
+            terminationTag: result.terminationTag,
+        };
+    }
+    if (result.exitCode === 0) {
+        return { status: 'completed' };
+    }
+    return {
+        status: 'failed',
+        error: `claude exited with code ${result.exitCode}`,
+    };
+}
+/** Maximum number of characters to retain for the diagnostic stderr tail. */
+export const STDERR_DIAGNOSTIC_TAIL_LIMIT = 200;
+/**
+ * Report the final session result to the guild via the session-record tool.
+ *
+ * When the resolved terminal status is exactly `'failed'` (non-zero exit,
+ * no structured termination tag, no cancel override), attach a passive
+ * `terminationDiagnostic: { exitCode, stderrExcerpt? }` to the payload.
+ * The diagnostic is informational only — the Animator's back-off
+ * machine never consumes it. The stderr excerpt is only present when
+ * the caller supplied a non-empty tail.
+ *
+ * If the guild is unreachable, writes the payload to the DLQ.
+ */
+export async function reportResult(config, result, transcript, timeoutMs, statusOverride, stderrTail) {
+    const route = toolNameToRoute('session-record');
+    const url = `${config.guildToolUrl}${route}`;
+    const resolved = resolveTerminalStatus(result, statusOverride);
+    const output = extractFinalAssistantText(transcript);
+    // Only attach the passive diagnostic on a clean `'failed'` bucket —
+    // timeout / cancelled / rate-limited are already well-classified.
+    const terminationDiagnostic = resolved.status === 'failed'
+        ? {
+            exitCode: result.exitCode,
+            ...(stderrTail && stderrTail.length > 0 ? { stderrExcerpt: stderrTail } : {}),
+        }
+        : undefined;
+    const payload = {
+        sessionId: config.sessionId,
+        status: resolved.status,
+        exitCode: result.exitCode,
+        signal: result.signal,
+        error: resolved.error,
+        costUsd: result.costUsd,
+        tokenUsage: result.tokenUsage,
+        output,
+        providerSessionId: result.providerSessionId,
+        transcript,
+        ...(resolved.terminationTag ? { terminationTag: resolved.terminationTag } : {}),
+        ...(terminationDiagnostic ? { terminationDiagnostic } : {}),
+    };
+    try {
+        await callGuildHttpApi(url, config.sessionId, payload, timeoutMs);
+    }
+    catch {
+        writeToDlq(config.cwd, `${config.sessionId}.json`, payload);
+    }
+}
+// ── Stderr redirect ────────────────────────────────────────────────────
+/**
+ * Open a per-session log file and redirect process.stderr.write to it.
+ *
+ * Creates the logDir (recursive) and opens `<logDir>/<sessionId>.log`
+ * for append-writing. Replaces process.stderr.write with a function
+ * that calls fs.writeSync on the owned fd. Writes the startup banner
+ * as the first line.
+ *
+ * Returns the owned fd so the caller can close it in a finally block.
+ *
+ * @internal Exported for testing only.
+ */
+export function redirectStderrToFile(logDir, sessionId) {
+    fs.mkdirSync(logDir, { recursive: true });
+    const logFilePath = path.join(logDir, `${sessionId}.log`);
+    const fd = fs.openSync(logFilePath, 'a');
+    // Replace process.stderr.write with a function that writes to our fd.
+    process.stderr.write = function (chunk, encodingOrCallback, callback) {
+        const encoding = typeof encodingOrCallback === 'string' ? encodingOrCallback : 'utf8';
+        const cb = typeof encodingOrCallback === 'function' ? encodingOrCallback : callback;
+        const buffer = typeof chunk === 'string'
+            ? Buffer.from(chunk, encoding)
+            : chunk;
+        fs.writeSync(fd, buffer);
+        if (cb)
+            cb();
+        return true;
+    };
+    // Write the startup banner (now goes to the log file).
+    const pgid = process.getgid?.() ?? process.pid;
+    process.stderr.write(`[babysitter] session=${sessionId} pid=${process.pid} pgid=${pgid} log=${logFilePath} started at ${new Date().toISOString()}\n`);
+    return fd;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardworks/claude-code-apparatus",
-  "version": "0.1.269",
+  "version": "0.1.271",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -26,14 +26,14 @@
     "@modelcontextprotocol/sdk": "1.27.1",
     "better-sqlite3": "12.8.0",
     "zod": "4.3.6",
-    "@shardworks/animator-apparatus": "0.1.269",
-    "@shardworks/stacks-apparatus": "0.1.269",
-    "@shardworks/tools-apparatus": "0.1.269"
+    "@shardworks/animator-apparatus": "0.1.271",
+    "@shardworks/stacks-apparatus": "0.1.271",
+    "@shardworks/tools-apparatus": "0.1.271"
   },
   "devDependencies": {
     "@types/better-sqlite3": "7.6.13",
     "@types/node": "25.5.0",
-    "@shardworks/nexus-core": "0.1.269"
+    "@shardworks/nexus-core": "0.1.271"
   },
   "files": [
     "dist"