roughbook 0.0.0-stage → 0.1.0

package/dist/agents/codex.js

@@ -0,0 +1,179 @@
+// OpenAI's Codex CLI. `codex exec` flags checked against OpenAI's CLI reference (2026-10-05):
+// --json, --sandbox workspace-write, --cd, --model, --skip-git-repo-check, and "-" for a prompt
+// on standard input. The sandbox confines writes to the working directory, so a headless run
+// works in the run's folder and is told where the repo root is. Unattended runs use the
+// designer's own API key (CODEX_API_KEY or OPENAI_API_KEY), never a ChatGPT login. No Codex CLI
+// was installed where this was written: check the event names against the first real run.
+import path from 'node:path';
+import { diskProbe } from '../launch/platform.js';
+import { findNpmScript, findOnPath, fromEnv } from '../launch/which.js';
+import { count, record, runCommand } from './command.js';
+const NOT_FOUND = 'Codex was not found. Install it (npm install -g @openai/codex), or set ROUGHBOOK_CODEX_BIN to the full path of codex.';
+function apiKey(env) {
+    return env.CODEX_API_KEY?.trim() || env.OPENAI_API_KEY?.trim() || null;
+}
+export function parseCodexLine(line) {
+    let parsed;
+    try {
+        parsed = record(JSON.parse(line.trim()));
+    }
+    catch {
+        return {};
+    }
+    const item = record(parsed.item);
+    switch (parsed.type) {
+        case 'thread.started':
+            return typeof parsed.thread_id === 'string'
+                ? { event: { kind: 'session', id: parsed.thread_id } }
+                : {};
+        case 'item.started':
+            if (item.type === 'command_execution')
+                return { event: { kind: 'tool', name: 'Shell' } };
+            if (item.type === 'file_change')
+                return { event: { kind: 'tool', name: 'Write' } };
+            return {};
+        case 'item.completed': {
+            if (item.type === 'agent_message' && typeof item.text === 'string' && item.text.trim()) {
+                return { event: { kind: 'message', text: item.text } };
+            }
+            if (item.type === 'file_change') {
+                const first = record(Array.isArray(item.changes) ? item.changes[0] : null).path;
+                return {
+                    event: { kind: 'file', name: typeof first === 'string' ? path.basename(first) : 'files' }
+                };
+            }
+            return {};
+        }
+        case 'turn.completed': {
+            const usage = record(parsed.usage);
+            const input = count(usage.input_tokens);
+            const cached = count(usage.cached_input_tokens);
+            return {
+                event: { kind: 'result', ok: true, text: null },
+                usage: {
+                    // Codex does not say which model ran; the run fills it in.
+                    model: '',
+                    // As the backend counts them: input without the cached part.
+                    inputTokens: input === null ? null : Math.max(0, input - (cached ?? 0)),
+                    outputTokens: count(usage.output_tokens),
+                    cacheReadTokens: cached,
+                    cacheWriteTokens: null
+                }
+            };
+        }
+        case 'turn.failed':
+        case 'error': {
+            const message = record(parsed.error).message ?? parsed.message;
+            return {
+                event: {
+                    kind: 'result',
+                    ok: false,
+                    text: typeof message === 'string' ? message.slice(0, 300) : null
+                }
+            };
+        }
+        default:
+            return {};
+    }
+}
+export const codex = {
+    id: 'codex',
+    name: 'Codex',
+    kind: 'terminal',
+    capabilities: { interactive: true, headless: true, permissions: true, usage: true },
+    notFound: NOT_FOUND,
+    find(lookup) {
+        const p = lookup.platform === 'win32' ? path.win32 : path.posix;
+        const probe = lookup.probe ?? diskProbe;
+        const explicit = fromEnv('ROUGHBOOK_CODEX_BIN', lookup);
+        if (explicit)
+            return explicit;
+        const onPath = findOnPath('codex', lookup);
+        if (onPath)
+            return { command: onPath, prefixArgs: [], source: 'PATH' };
+        const npm = findNpmScript('codex', '@openai/codex', 'bin/codex.js', lookup);
+        if (npm)
+            return npm;
+        const native = p.join(lookup.home, '.local', 'bin', lookup.platform === 'win32' ? 'codex.exe' : 'codex');
+        return probe.exists(native)
+            ? { command: native, prefixArgs: [], source: 'native install' }
+            : null;
+    },
+    async detect(lookup) {
+        const base = {
+            id: this.id,
+            name: this.name,
+            kind: this.kind,
+            capabilities: this.capabilities
+        };
+        const executable = this.find(lookup);
+        if (!executable) {
+            return {
+                ...base,
+                found: false,
+                executable: null,
+                version: null,
+                signedIn: null,
+                signIn: null,
+                headless: { ready: false, reason: NOT_FOUND }
+            };
+        }
+        const version = await runCommand(executable, ['--version']);
+        const status = await runCommand(executable, ['login', 'status']);
+        const said = (status.stdout || status.stderr).trim().split('\n')[0]?.slice(0, 80) || null;
+        return {
+            ...base,
+            found: version.ok,
+            executable,
+            version: (version.stdout || version.stderr).trim().split(/\s+/).pop() || null,
+            signedIn: status.ok,
+            signIn: status.ok ? said : 'not signed in',
+            headless: !version.ok
+                ? { ready: false, reason: 'Codex could not be run.' }
+                : apiKey(lookup.env)
+                    ? { ready: true }
+                    : {
+                        ready: false,
+                        reason: 'Unattended runs use your own OpenAI API key: set CODEX_API_KEY or OPENAI_API_KEY. A ChatGPT login works for terminal sessions.'
+                    }
+        };
+    },
+    interactiveArgs(run) {
+        return [...(run.model ? ['--model', run.model] : []), run.instruction];
+    },
+    headless(run, executable, env) {
+        const key = apiKey(env);
+        if (!key) {
+            return {
+                refused: 'Unattended runs use your own OpenAI API key: set CODEX_API_KEY or OPENAI_API_KEY, or run it in a terminal session.'
+            };
+        }
+        const folder = path.join(run.repoRoot, ...run.targetFolder.split('/'));
+        return {
+            command: executable.command,
+            args: [
+                ...executable.prefixArgs,
+                'exec',
+                '--json',
+                '--sandbox',
+                'workspace-write',
+                '--cd',
+                folder,
+                '--skip-git-repo-check',
+                ...(run.model ? ['--model', run.model] : []),
+                '-'
+            ],
+            cwd: folder,
+            stdin: [
+                `Your working directory is ${run.targetFolder}, the one folder you may write to.`,
+                `The repository root is ${run.repoRoot}. Every path in your instructions is relative to it: read from there, write only in your working directory.`,
+                '',
+                run.instruction,
+                ''
+            ].join('\n'),
+            env: { CODEX_API_KEY: key }
+        };
+    },
+    parseLine: parseCodexLine
+};
+//# sourceMappingURL=codex.js.map

package/dist/agents/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/agents/codex.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,gGAAgG;AAChG,6FAA6F;AAC7F,wFAAwF;AACxF,gGAAgG;AAChG,0FAA0F;AAC1F,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGzD,MAAM,SAAS,GACb,uHAAuH,CAAC;AAE1H,SAAS,MAAM,CAAC,GAAsB;IACpC,OAAO,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,gBAAgB;YACnB,OAAO,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;gBACzC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE;gBACtD,CAAC,CAAC,EAAE,CAAC;QACT,KAAK,cAAc;YACjB,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB;gBAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;YACzF,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;gBAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;YACnF,OAAO,EAAE,CAAC;QACZ,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBACvF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACzD,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;gBAChF,OAAO;oBACL,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE;iBAC1F,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAChD,OAAO;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;gBAC/C,KAAK,EAAE;oBACL,2DAA2D;oBAC3D,KAAK,EAAE,EAAE;oBACT,6DAA6D;oBAC7D,WAAW,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;oBACvE,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC;oBACxC,eAAe,EAAE,MAAM;oBACvB,gBAAgB,EAAE,IAAI;iBACvB;aACF,CAAC;QACJ,CAAC;QACD,KAAK,aAAa,CAAC;QACnB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;YAC/D,OAAO;gBACL,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,EAAE,EAAE,KAAK;oBACT,IAAI,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;iBACjE;aACF,CAAC;QACJ,CAAC;QACD;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAoB;IACpC,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,UAAU;IAChB,YAAY,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;IACnF,QAAQ,EAAE,SAAS;IAEnB,IAAI,CAAC,MAAM;QACT,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QAChE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,MAAM;YAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACvE,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;QAC5E,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CACnB,MAAM,CAAC,IAAI,EACX,QAAQ,EACR,KAAK,EACL,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CACpD,CAAC;QACF,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YACzB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE;YAC/D,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAM;QACjB,MAAM,IAAI,GAAG;YACX,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;SACvB,CAAC;QACX,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,GAAG,IAAI;gBACP,KAAK,EAAE,KAAK;gBACZ,UAAU,EAAE,IAAI;gBAChB,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;aAC9C,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;QAC1F,OAAO;YACL,GAAG,IAAI;YACP,KAAK,EAAE,OAAO,CAAC,EAAE;YACjB,UAAU;YACV,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI;YAC7E,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe;YAC1C,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;gBACnB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,EAAE;gBACrD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;oBAClB,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;oBACjB,CAAC,CAAC;wBACE,KAAK,EAAE,KAAK;wBACZ,MAAM,EACJ,gIAAgI;qBACnI;SACR,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,GAAG;QACjB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACzE,CAAC;IAED,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;gBACL,OAAO,EACL,oHAAoH;aACvH,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,IAAI,EAAE;gBACJ,GAAG,UAAU,CAAC,UAAU;gBACxB,MAAM;gBACN,QAAQ;gBACR,WAAW;gBACX,iBAAiB;gBACjB,MAAM;gBACN,MAAM;gBACN,uBAAuB;gBACvB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5C,GAAG;aACJ;YACD,GAAG,EAAE,MAAM;YACX,KAAK,EAAE;gBACL,6BAA6B,GAAG,CAAC,YAAY,oCAAoC;gBACjF,0BAA0B,GAAG,CAAC,QAAQ,6GAA6G;gBACnJ,EAAE;gBACF,GAAG,CAAC,WAAW;gBACf,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC;YACZ,GAAG,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE;SAC5B,CAAC;IACJ,CAAC;IAED,SAAS,EAAE,cAAc;CAC1B,CAAC"}

package/dist/agents/command.js

@@ -0,0 +1,47 @@
+import { spawn } from 'node:child_process';
+/** Runs a short command and collects its output. Never through a shell. */
+export function runCommand(executable, args, timeoutMs = 10_000) {
+    return new Promise(resolve => {
+        let settled = false;
+        let stdout = '';
+        let stderr = '';
+        const child = spawn(executable.command, [...executable.prefixArgs, ...args], {
+            windowsHide: true,
+            stdio: ['ignore', 'pipe', 'pipe']
+        });
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            child.kill();
+            resolve({ ok: false, stdout, stderr: `${stderr}\n(timed out)`.trim(), code: null });
+        }, timeoutMs);
+        child.stdout.on('data', chunk => (stdout += String(chunk)));
+        child.stderr.on('data', chunk => (stderr += String(chunk)));
+        child.on('error', error => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ ok: false, stdout, stderr: error.message, code: null });
+        });
+        child.on('close', code => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ ok: code === 0, stdout, stderr, code });
+        });
+    });
+}
+export function record(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+export function count(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0
+        ? Math.round(value)
+        : null;
+}
+//# sourceMappingURL=command.js.map

package/dist/agents/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/agents/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAK3C,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CACxB,UAAsB,EACtB,IAAc,EACd,SAAS,GAAG,MAAM;IAElB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,EAAE;YAC3E,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACtF,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5D,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE;YACxB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE;YACvB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QACtE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QACnB,CAAC,CAAC,IAAI,CAAC;AACX,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,21 @@
+import os from 'node:os';
+import { hostPlatform } from '../launch/platform.js';
+import { claudeCode } from './claude.js';
+import { codex } from './codex.js';
+/** The terminal agents this version ships. Editor agents and more CLIs come with S2. */
+export const ADAPTERS = [claudeCode, codex];
+export function adapterFor(id) {
+    const adapter = ADAPTERS.find(item => item.id === id);
+    if (!adapter)
+        throw new Error(`${id} is not supported in this version of the studio.`);
+    return adapter;
+}
+/** Where to look for agents on this machine. */
+export function hostLookup(env) {
+    return { env, platform: hostPlatform(), home: os.homedir(), node: process.execPath };
+}
+/** What each agent is on this machine: found or not, its version, sign-in, and headless rule. */
+export async function detectAgents(lookup) {
+    return Promise.all(ADAPTERS.map(adapter => adapter.detect(lookup)));
+}
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,wFAAwF;AACxF,MAAM,CAAC,MAAM,QAAQ,GAAsB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAE/D,MAAM,UAAU,UAAU,CAAC,EAAY;IACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,kDAAkD,CAAC,CAAC;IACvF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,UAAU,CAAC,GAAsB;IAC/C,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;AACvF,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc;IAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/agents/process.js

@@ -0,0 +1,76 @@
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+/**
+ * Runs an agent unattended: never through a shell, every argument separate. Each line of its
+ * output is parsed by the adapter into events for the local UI and, at the end, token counts.
+ * Aborting stops the process, and then kills it if it lingers.
+ */
+export function runHeadless(adapter, invocation, options) {
+    return new Promise(resolve => {
+        let settled = false;
+        let usage = null;
+        let reportedFailure = null;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(result);
+        };
+        const child = spawn(invocation.command, invocation.args, {
+            cwd: invocation.cwd,
+            env: { ...options.env, ...invocation.env },
+            stdio: ['pipe', 'pipe', 'pipe'],
+            windowsHide: true
+        });
+        const abort = () => {
+            child.kill('SIGTERM');
+            setTimeout(() => {
+                if (child.exitCode === null)
+                    child.kill('SIGKILL');
+            }, 5000).unref();
+        };
+        options.signal?.addEventListener('abort', abort, { once: true });
+        child.on('error', error => finish({
+            ok: false,
+            exitCode: null,
+            cancelled: false,
+            error: `${adapter.name} could not be started: ${error.message}`,
+            usage
+        }));
+        createInterface({ input: child.stdout }).on('line', line => {
+            options.onOutput?.(line);
+            const parsed = adapter.parseLine(line);
+            if (parsed.usage) {
+                usage = { ...parsed.usage, model: parsed.usage.model || options.model || adapter.id };
+            }
+            if (parsed.event) {
+                if (parsed.event.kind === 'result' && !parsed.event.ok) {
+                    reportedFailure = parsed.event.text ?? `${adapter.name} reported a failure.`;
+                }
+                options.onEvent?.(parsed.event);
+            }
+        });
+        child.stderr.on('data', () => { });
+        child.on('close', code => {
+            options.signal?.removeEventListener('abort', abort);
+            const cancelled = options.signal?.aborted ?? false;
+            const ok = !cancelled && code === 0 && !reportedFailure;
+            finish({
+                ok,
+                exitCode: code,
+                cancelled,
+                error: ok
+                    ? null
+                    : cancelled
+                        ? 'Cancelled.'
+                        : (reportedFailure ?? `${adapter.name} exited with code ${code}.`),
+                usage
+            });
+        });
+        child.stdin.on('error', () => { });
+        if (invocation.stdin !== null)
+            child.stdin.write(invocation.stdin);
+        child.stdin.end();
+    });
+}
+//# sourceMappingURL=process.js.map

package/dist/agents/process.js.map

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

package/dist/agents/session.js

@@ -0,0 +1,26 @@
+import { sessionTitle } from '../launch/terminal.js';
+import { handoffLine } from '../runs/slots.js';
+/** A run as an adapter sees it. The run id doubles as the agent's session id, so it can resume. */
+export function runTarget(repoRoot, run, model) {
+    return {
+        repoRoot,
+        targetFolder: run.targetFolder,
+        promptFile: run.promptFile,
+        instruction: handoffLine(run.promptFile),
+        sessionId: run.runId,
+        model,
+        title: sessionTitle(`${run.component} ${run.iteration}`)
+    };
+}
+/** One terminal session per run, each started with its one-line instruction. */
+export function terminalSessions(adapter, executable, repoRoot, runs, model) {
+    return runs.map(run => {
+        const target = runTarget(repoRoot, run, model);
+        return {
+            title: target.title,
+            command: executable.command,
+            args: [...executable.prefixArgs, ...adapter.interactiveArgs(target)]
+        };
+    });
+}
+//# sourceMappingURL=session.js.map

package/dist/agents/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/agents/session.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,mGAAmG;AACnG,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,GAAc,EAAE,KAAoB;IAC9E,OAAO;QACL,QAAQ;QACR,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC;QACxC,SAAS,EAAE,GAAG,CAAC,KAAK;QACpB,KAAK;QACL,KAAK,EAAE,YAAY,CAAC,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAC9B,OAAwB,EACxB,UAAsB,EACtB,QAAgB,EAChB,IAAiB,EACjB,KAAoB;IAEpB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACpB,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;SACrE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/agents/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":""}

package/dist/api/client.js

@@ -0,0 +1,138 @@
+import { ApiError, OfflineError } from './errors.js';
+/** Where the backend serves the studio's routes. */
+export const STUDIO_BASE = '/v1/api/studio';
+/** The typed client for `/studio`. Every route the studio calls goes through `request`. */
+export class StudioApi {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    get server() {
+        return this.config.server;
+    }
+    get signedIn() {
+        return this.config.token !== null;
+    }
+    /** The same server, without the token: for signing in. */
+    signedOut() {
+        return new StudioApi({ ...this.config, token: null });
+    }
+    /** The same server with a newly issued token. */
+    withToken(token) {
+        return new StudioApi({ ...this.config, token });
+    }
+    startDeviceLogin(body) {
+        return this.request('POST', '/auth/device', body);
+    }
+    pollDeviceLogin(deviceCode) {
+        return this.request('POST', '/auth/token', { deviceCode });
+    }
+    me() {
+        return this.request('GET', '/me');
+    }
+    logout() {
+        return this.request('POST', '/auth/logout', {});
+    }
+    projects() {
+        return this.request('GET', '/projects');
+    }
+    createProject(orgId, name) {
+        return this.request('POST', `/orgs/${encodeURIComponent(orgId)}/projects`, { name });
+    }
+    /** Allocates the iterations and compiles their prompts for this repo. */
+    startRuns(orgId, project, request) {
+        return this.request('POST', `${projectPath(orgId, project)}/runs`, request);
+    }
+    /** The project with its brief and the server's records of its iterations. */
+    project(orgId, project) {
+        return this.request('GET', projectPath(orgId, project));
+    }
+    /** Renders the promote prompt; the assets are the server file names the iteration uses. */
+    promote(orgId, project, body) {
+        return this.request('POST', `${projectPath(orgId, project)}/promotions`, body);
+    }
+    /** A local iteration's reviews, oldest first. */
+    reviews(orgId, project, page, component, iteration) {
+        return this.request('GET', `${iterationPath(orgId, project, page, component, iteration)}/reviews`);
+    }
+    /** The component's web sketches that can be pulled, newest first. */
+    sketches(orgId, project, page, component) {
+        return this.request('GET', `${componentPath(orgId, project, page, component)}/sketches`);
+    }
+    /** Allocates the next local iteration as a fork of the sketch, with the sketch's files. */
+    pullSketch(orgId, project, page, component, sketch) {
+        return this.request('POST', `${componentPath(orgId, project, page, component)}/sketches/${encodeURIComponent(sketch)}/pull`, {});
+    }
+    heartbeat(body) {
+        return this.request('POST', '/heartbeat', body);
+    }
+    /** An asset file's bytes, to copy into the repo when promoting. */
+    async file(orgId, project, scope, file) {
+        const response = await this.send('GET', `${projectPath(orgId, project)}/files/${scope}/${encodeURIComponent(file)}`, undefined, {}, '*/*');
+        if (response.ok)
+            return Buffer.from(await response.arrayBuffer());
+        throw await readError(response);
+    }
+    link(orgId, body) {
+        return this.request('POST', `/orgs/${encodeURIComponent(orgId)}/links`, body);
+    }
+    async request(method, path, body, options = {}) {
+        const response = await this.send(method, path, body, options);
+        const envelope = await readEnvelope(response);
+        if (envelope.success && response.ok)
+            return envelope.data;
+        throw toApiError(response.status, envelope);
+    }
+    async send(method, path, body, options, accept = 'application/json') {
+        const headers = {
+            accept,
+            'user-agent': this.config.userAgent
+        };
+        if (body !== undefined)
+            headers['content-type'] = 'application/json';
+        if (this.config.token)
+            headers.authorization = `Bearer ${this.config.token}`;
+        if (options.idempotencyKey)
+            headers['idempotency-key'] = options.idempotencyKey;
+        try {
+            return await (this.config.fetch ?? fetch)(`${this.config.server}${STUDIO_BASE}${path}`, {
+                method,
+                headers,
+                body: body === undefined ? undefined : JSON.stringify(body),
+                signal: AbortSignal.timeout(this.config.timeoutMs ?? 30_000)
+            });
+        }
+        catch (error) {
+            throw new OfflineError(this.config.server, error);
+        }
+    }
+}
+function projectPath(orgId, project) {
+    return `/orgs/${encodeURIComponent(orgId)}/projects/${encodeURIComponent(project)}`;
+}
+function componentPath(orgId, project, page, component) {
+    return `${projectPath(orgId, project)}/pages/${encodeURIComponent(page)}/components/${encodeURIComponent(component)}`;
+}
+/** The path of one iteration's review routes. */
+export function iterationPath(orgId, project, page, component, iteration) {
+    return `${componentPath(orgId, project, page, component)}/iterations/${encodeURIComponent(iteration)}`;
+}
+async function readEnvelope(response) {
+    const envelope = (await response.json().catch(() => null));
+    if (!envelope || typeof envelope !== 'object' || typeof envelope.success !== 'boolean') {
+        throw new ApiError(response.ok ? 'BAD_RESPONSE' : `HTTP_${response.status}`, response.status, `The server answered ${response.status} with something the studio cannot read.`);
+    }
+    return envelope;
+}
+async function readError(response) {
+    return toApiError(response.status, await readEnvelope(response));
+}
+function toApiError(status, envelope) {
+    const message = typeof envelope.message === 'string' ? envelope.message : undefined;
+    if (Array.isArray(envelope.error)) {
+        return new ApiError('INVALID_REQUEST', status, message, envelope.error);
+    }
+    const code = typeof envelope.error === 'string' ? envelope.error : `HTTP_${status}`;
+    return new ApiError(code, status, message);
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/errors.js

@@ -0,0 +1,40 @@
+/** The backend answered and refused: a code such as `RUN_NOT_FOUND`, and a message when it has one. */
+export class ApiError extends Error {
+    code;
+    status;
+    /** Field errors from the backend's validation, when the request was malformed. */
+    issues;
+    constructor(code, status, message, issues = null) {
+        super(message || code);
+        this.name = 'ApiError';
+        this.code = code;
+        this.status = status;
+        this.issues = issues;
+    }
+    /** Worth sending again later: the server failed or asked us to slow down. */
+    get retryable() {
+        return this.status >= 500 || this.status === 429 || this.status === 408;
+    }
+}
+/** The backend could not be reached at all: no network, a timeout, or nothing listening. */
+export class OfflineError extends Error {
+    server;
+    constructor(server, cause) {
+        super(`Could not reach ${server}.`, { cause });
+        this.name = 'OfflineError';
+        this.server = server;
+    }
+}
+/** One line for the terminal or the local UI, never a stack. */
+export function describeError(error) {
+    if (error instanceof OfflineError) {
+        return `${error.message} Check your connection, or set ROUGHBOOK_SERVER.`;
+    }
+    if (error instanceof ApiError) {
+        if (error.code === 'INVALID_REQUEST')
+            return 'The server did not accept that request.';
+        return error.message;
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/api/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAS;IACb,MAAM,CAAS;IACxB,kFAAkF;IACzE,MAAM,CAAmB;IAElC,YAAY,IAAY,EAAE,MAAc,EAAE,OAAgB,EAAE,SAA2B,IAAI;QACzF,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,6EAA6E;IAC7E,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IAC1E,CAAC;CACF;AAED,4FAA4F;AAC5F,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,MAAM,CAAS;IAExB,YAAY,MAAc,EAAE,KAAe;QACzC,KAAK,CAAC,mBAAmB,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,GAAG,KAAK,CAAC,OAAO,kDAAkD,CAAC;IAC5E,CAAC;IACD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB;YAAE,OAAO,yCAAyC,CAAC;QACvF,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}