ralph-research 0.1.2 → 0.1.4

package/dist/adapters/proposer/codex-cli-session-driver.js

@@ -0,0 +1,182 @@
+export class CodexCliSessionDriver {
+    sessionId;
+    session;
+    now;
+    transcript;
+    detachOutputListeners;
+    nextOrder = 1;
+    pendingInput = Promise.resolve();
+    finalizedExit = null;
+    constructor(sessionId, session, dependencies = {}) {
+        this.sessionId = sessionId;
+        this.session = session;
+        this.now = dependencies.now ?? (() => new Date());
+        const startedAt = this.now().toISOString();
+        this.transcript = {
+            sessionId,
+            pid: session.pid,
+            startedAt,
+            updatedAt: startedAt,
+            entries: [],
+        };
+        this.detachOutputListeners = this.attachOutputListeners();
+    }
+    async run(options) {
+        await this.sendResearchPrompt(options.researchPrompt);
+        for (const input of options.controlInputs ?? []) {
+            await this.sendControlInput(input);
+        }
+        const exit = await this.waitForExit();
+        return {
+            exit,
+            transcript: this.getTranscript(),
+        };
+    }
+    async sendResearchPrompt(prompt) {
+        const normalized = normalizeRequiredText(prompt, "Research prompt");
+        await this.enqueueInput(async () => {
+            const payload = withTrailingNewline(normalized);
+            this.recordEntry({
+                stream: "stdin",
+                text: payload,
+                inputType: "research_prompt",
+            });
+            await writeToStream(this.session.stdin, payload);
+        });
+    }
+    async sendControlInput(input) {
+        const control = normalizeControlInput(input);
+        await this.enqueueInput(async () => {
+            const payload = control.appendNewline ? withTrailingNewline(control.text) : control.text;
+            this.recordEntry({
+                stream: "stdin",
+                text: payload,
+                inputType: "control",
+                ...(control.label ? { label: control.label } : {}),
+            });
+            await writeToStream(this.session.stdin, payload);
+        });
+    }
+    async waitForExit() {
+        return this.finalizeExit(this.session.waitForExit());
+    }
+    async stop(signal) {
+        return this.finalizeExit(this.session.stop(signal));
+    }
+    getTranscript() {
+        return {
+            ...this.transcript,
+            entries: this.transcript.entries.map((entry) => ({ ...entry })),
+        };
+    }
+    attachOutputListeners() {
+        const onStdout = (chunk) => {
+            this.recordEntry({
+                stream: "stdout",
+                text: toUtf8(chunk),
+            });
+        };
+        const onStderr = (chunk) => {
+            this.recordEntry({
+                stream: "stderr",
+                text: toUtf8(chunk),
+            });
+        };
+        this.session.stdout.on("data", onStdout);
+        this.session.stderr.on("data", onStderr);
+        return () => {
+            this.session.stdout.off("data", onStdout);
+            this.session.stderr.off("data", onStderr);
+        };
+    }
+    recordEntry(entry) {
+        const capturedAt = this.now().toISOString();
+        this.transcript.entries.push({
+            order: this.nextOrder,
+            capturedAt,
+            ...entry,
+        });
+        this.nextOrder += 1;
+        this.transcript.updatedAt = capturedAt;
+    }
+    enqueueInput(operation) {
+        const next = this.pendingInput.then(operation);
+        this.pendingInput = next.catch(() => undefined);
+        return next;
+    }
+    async finalizeExit(exitPromise) {
+        if (!this.finalizedExit) {
+            this.finalizedExit = exitPromise.then((exit) => {
+                this.detachOutputListeners();
+                const endedAt = this.now().toISOString();
+                this.transcript.endedAt = endedAt;
+                this.transcript.updatedAt = endedAt;
+                this.transcript.exit = exit;
+                return exit;
+            });
+        }
+        return this.finalizedExit;
+    }
+}
+async function writeToStream(stream, value) {
+    await new Promise((resolve, reject) => {
+        const writable = asWritable(stream);
+        const onError = (error) => {
+            cleanup();
+            reject(error);
+        };
+        const onDrain = () => {
+            cleanup();
+            resolve();
+        };
+        const cleanup = () => {
+            writable.off("error", onError);
+            writable.off("drain", onDrain);
+        };
+        writable.on("error", onError);
+        const accepted = writable.write(value, "utf8");
+        if (accepted) {
+            cleanup();
+            resolve();
+            return;
+        }
+        writable.once("drain", onDrain);
+    });
+}
+function normalizeControlInput(input) {
+    if (typeof input === "string") {
+        return {
+            text: normalizeRequiredText(input, "Control input"),
+            label: "",
+            appendNewline: true,
+        };
+    }
+    return {
+        text: normalizeRequiredText(input.text, "Control input"),
+        label: input.label?.trim() ?? "",
+        appendNewline: input.appendNewline ?? true,
+    };
+}
+function normalizeRequiredText(value, label) {
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new Error(`${label} is required`);
+    }
+    return normalized;
+}
+function withTrailingNewline(value) {
+    return value.endsWith("\n") ? value : `${value}\n`;
+}
+function toUtf8(chunk) {
+    if (typeof chunk === "string") {
+        return chunk;
+    }
+    if (Buffer.isBuffer(chunk)) {
+        return chunk.toString("utf8");
+    }
+    return String(chunk);
+}
+function asWritable(stream) {
+    return stream;
+}
+//# sourceMappingURL=codex-cli-session-driver.js.map

package/dist/adapters/proposer/codex-cli-session-driver.js.map

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

package/dist/adapters/proposer/codex-cli-session-manager.d.ts

@@ -0,0 +1,79 @@
+import { type ChildProcess, type SpawnOptions } from "node:child_process";
+export type CodexCliApprovalPolicy = "never" | "on-failure" | "on-request" | "untrusted";
+export type CodexCliSandboxMode = "read-only" | "workspace-write" | "danger-full-access";
+type RuntimeEvent = NodeJS.Signals | "exit";
+type RuntimeListener = (...args: unknown[]) => void;
+type SpawnChildProcess = (command: string, args: string[], options: SpawnOptions) => ChildProcess;
+export interface CodexCliSessionLaunchOptions {
+    cwd: string;
+    sessionId: string;
+    existingSessionId?: string;
+    approvalPolicy: CodexCliApprovalPolicy;
+    sandboxMode: CodexCliSandboxMode;
+    command?: string;
+    prompt?: string;
+    model?: string;
+    webSearch?: boolean;
+    extraWritableDirectories?: string[];
+    env?: Record<string, string>;
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+    shutdownGracePeriodMs?: number;
+}
+export interface CodexCliSessionExit {
+    code: number | null;
+    signal: NodeJS.Signals | null;
+}
+export interface CodexCliSessionTtyMetadata {
+    stdinIsTty: boolean;
+    stdoutIsTty: boolean;
+    columns?: number;
+    rows?: number;
+    term?: string;
+}
+export interface CodexCliSessionMetadata {
+    launchMode: "new" | "resume";
+    researchSessionId: string;
+    codexSessionId?: string;
+}
+export interface CodexCliSessionHandle {
+    pid: number | undefined;
+    command: string;
+    args: string[];
+    metadata: CodexCliSessionMetadata;
+    tty?: CodexCliSessionTtyMetadata;
+    waitForExit(): Promise<CodexCliSessionExit>;
+    stop(signal?: NodeJS.Signals): Promise<CodexCliSessionExit>;
+}
+export interface CodexCliSessionReattachOptions {
+    sessionId: string;
+    codexSessionId?: string;
+}
+export interface CodexCliSessionManagerDependencies {
+    spawn?: SpawnChildProcess;
+    runtimeProcess?: {
+        env: NodeJS.ProcessEnv;
+        stdin: NodeJS.ReadableStream;
+        stdout: NodeJS.WritableStream;
+        on(event: RuntimeEvent, listener: RuntimeListener): unknown;
+        off(event: RuntimeEvent, listener: RuntimeListener): unknown;
+    };
+    setTimeout?: typeof globalThis.setTimeout;
+    clearTimeout?: typeof globalThis.clearTimeout;
+}
+export declare class CodexCliSessionManager {
+    private readonly spawnChild;
+    private readonly runtimeProcess;
+    private readonly setTimeoutFn;
+    private readonly clearTimeoutFn;
+    private activeSession;
+    constructor(dependencies?: CodexCliSessionManagerDependencies);
+    startSession(options: CodexCliSessionLaunchOptions): CodexCliSessionHandle;
+    reattachSession(options: CodexCliSessionReattachOptions): CodexCliSessionHandle;
+    private attachRuntimeHandlers;
+}
+export declare function buildCodexCliArgs(options: CodexCliSessionLaunchOptions): string[];
+export declare function buildCodexCliEnvironment(baseEnvironment: NodeJS.ProcessEnv, options: Pick<CodexCliSessionLaunchOptions, "cwd" | "env" | "sessionId">): NodeJS.ProcessEnv;
+export declare function isInteractiveTerminal(input: NodeJS.ReadableStream, output: NodeJS.WritableStream): boolean;
+export declare function getCodexCliSessionTtyMetadata(input: NodeJS.ReadableStream, output: NodeJS.WritableStream, environment: NodeJS.ProcessEnv): CodexCliSessionTtyMetadata;
+export {};

package/dist/adapters/proposer/codex-cli-session-manager.js

@@ -0,0 +1,248 @@
+import { spawn } from "node:child_process";
+const FORWARDED_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
+const DEFAULT_CODEX_COMMAND = "codex";
+const DEFAULT_SHUTDOWN_GRACE_PERIOD_MS = 5_000;
+const activeSessionRegistry = new Map();
+export class CodexCliSessionManager {
+    spawnChild;
+    runtimeProcess;
+    setTimeoutFn;
+    clearTimeoutFn;
+    activeSession = null;
+    constructor(dependencies = {}) {
+        this.spawnChild = dependencies.spawn ?? spawn;
+        this.runtimeProcess = dependencies.runtimeProcess ?? process;
+        this.setTimeoutFn = dependencies.setTimeout ?? globalThis.setTimeout;
+        this.clearTimeoutFn = dependencies.clearTimeout ?? globalThis.clearTimeout;
+    }
+    startSession(options) {
+        if (this.activeSession && !this.activeSession.closed) {
+            throw new Error("A Codex CLI session is already running");
+        }
+        const input = options.input ?? this.runtimeProcess.stdin;
+        const output = options.output ?? this.runtimeProcess.stdout;
+        if (!isInteractiveTerminal(input, output)) {
+            throw new Error("Codex CLI requires an interactive terminal on stdin and stdout");
+        }
+        const command = options.command?.trim() || DEFAULT_CODEX_COMMAND;
+        const args = buildCodexCliArgs(options);
+        const env = buildCodexCliEnvironment(this.runtimeProcess.env, options);
+        const tty = getCodexCliSessionTtyMetadata(input, output, env);
+        const metadata = buildCodexCliSessionMetadata(options);
+        const registryKeys = buildActiveSessionRegistryKeys(options.sessionId, metadata.codexSessionId);
+        const child = this.spawnChild(command, args, {
+            cwd: options.cwd,
+            env,
+            stdio: "inherit",
+        });
+        let resolveExit;
+        let rejectExit;
+        let forceKillTimer;
+        let activeSession;
+        const cleanup = () => {
+            if (activeSession.closed) {
+                return;
+            }
+            activeSession.closed = true;
+            if (forceKillTimer) {
+                this.clearTimeoutFn(forceKillTimer);
+                forceKillTimer = undefined;
+            }
+            detachRuntimeHandlers();
+            for (const key of activeSession.registryKeys) {
+                activeSessionRegistry.delete(key);
+            }
+            if (this.activeSession === activeSession) {
+                this.activeSession = null;
+            }
+        };
+        const stop = (signal = "SIGTERM") => {
+            if (!activeSession.closed && isChildRunning(child)) {
+                child.kill(signal);
+                if (!forceKillTimer) {
+                    forceKillTimer = this.setTimeoutFn(() => {
+                        if (activeSession.closed || !isChildRunning(child)) {
+                            return;
+                        }
+                        child.kill("SIGKILL");
+                    }, options.shutdownGracePeriodMs ?? DEFAULT_SHUTDOWN_GRACE_PERIOD_MS);
+                }
+            }
+            return activeSession.waitForExit;
+        };
+        const handle = {
+            pid: child.pid,
+            command,
+            args,
+            metadata,
+            tty,
+            waitForExit: () => activeSession.waitForExit,
+            stop,
+        };
+        activeSession = {
+            sessionId: options.sessionId,
+            registryKeys,
+            handle,
+            child,
+            closed: false,
+            waitForExit: new Promise((resolve, reject) => {
+                resolveExit = resolve;
+                rejectExit = reject;
+            }),
+        };
+        this.activeSession = activeSession;
+        for (const key of registryKeys) {
+            activeSessionRegistry.set(key, activeSession);
+        }
+        const exitHandler = (code, signal) => {
+            cleanup();
+            resolveExit?.({ code, signal });
+        };
+        const errorHandler = (error) => {
+            cleanup();
+            rejectExit?.(error);
+        };
+        child.once("exit", exitHandler);
+        child.once("error", errorHandler);
+        const detachRuntimeHandlers = this.attachRuntimeHandlers({
+            onSignal: (signal) => {
+                void stop(signal);
+            },
+            onExit: () => {
+                if (activeSession.closed || !isChildRunning(child)) {
+                    return;
+                }
+                child.kill("SIGTERM");
+            },
+        });
+        return handle;
+    }
+    reattachSession(options) {
+        if (this.activeSession && !this.activeSession.closed) {
+            throw new Error("A Codex CLI session is already running");
+        }
+        const lookupKeys = buildReattachLookupKeys(options);
+        const activeSession = lookupKeys
+            .map((key) => activeSessionRegistry.get(key))
+            .find((candidate) => candidate && !candidate.closed && isChildRunning(candidate.child));
+        if (!activeSession) {
+            throw new Error(`Active Codex CLI session not found for ${lookupKeys[0] ?? options.sessionId}`);
+        }
+        this.activeSession = activeSession;
+        return activeSession.handle;
+    }
+    attachRuntimeHandlers(handlers) {
+        const boundHandlers = new Map();
+        for (const signal of FORWARDED_SIGNALS) {
+            const listener = () => {
+                handlers.onSignal(signal);
+            };
+            boundHandlers.set(signal, listener);
+            this.runtimeProcess.on(signal, listener);
+        }
+        const exitListener = () => {
+            handlers.onExit();
+        };
+        boundHandlers.set("exit", exitListener);
+        this.runtimeProcess.on("exit", exitListener);
+        return () => {
+            for (const [event, listener] of boundHandlers.entries()) {
+                this.runtimeProcess.off(event, listener);
+            }
+        };
+    }
+}
+export function buildCodexCliArgs(options) {
+    const baseArgs = [
+        "-C",
+        options.cwd,
+        "-a",
+        options.approvalPolicy,
+        "-s",
+        options.sandboxMode,
+    ];
+    if (options.model) {
+        baseArgs.push("-m", options.model);
+    }
+    if (options.webSearch ?? true) {
+        baseArgs.push("--search");
+    }
+    for (const directory of options.extraWritableDirectories ?? []) {
+        baseArgs.push("--add-dir", directory);
+    }
+    const existingSessionId = normalizeExistingSessionId(options.existingSessionId);
+    if (existingSessionId) {
+        return [
+            "resume",
+            existingSessionId,
+            ...baseArgs,
+            ...(options.prompt ? [options.prompt] : []),
+        ];
+    }
+    if (options.prompt) {
+        baseArgs.push(options.prompt);
+    }
+    return baseArgs;
+}
+export function buildCodexCliEnvironment(baseEnvironment, options) {
+    return {
+        ...baseEnvironment,
+        ...options.env,
+        INIT_CWD: options.cwd,
+        PWD: options.cwd,
+        RRX_AGENT: "codex_cli",
+        RRX_SESSION_ID: options.sessionId,
+    };
+}
+export function isInteractiveTerminal(input, output) {
+    return Boolean(input.isTTY && output.isTTY);
+}
+export function getCodexCliSessionTtyMetadata(input, output, environment) {
+    const columns = output.columns;
+    const rows = output.rows;
+    return {
+        stdinIsTty: Boolean(input.isTTY),
+        stdoutIsTty: Boolean(output.isTTY),
+        ...(columns && rows ? { columns, rows } : {}),
+        ...(environment.TERM ? { term: environment.TERM } : {}),
+    };
+}
+function isChildRunning(child) {
+    return child.exitCode === null && child.signalCode === null;
+}
+function buildCodexCliSessionMetadata(options) {
+    const existingSessionId = normalizeExistingSessionId(options.existingSessionId);
+    return {
+        launchMode: existingSessionId ? "resume" : "new",
+        researchSessionId: options.sessionId,
+        ...(existingSessionId ? { codexSessionId: existingSessionId } : {}),
+    };
+}
+function buildActiveSessionRegistryKeys(sessionId, codexSessionId) {
+    return [...new Set([sessionId, codexSessionId].filter((value) => Boolean(value)))];
+}
+function buildReattachLookupKeys(options) {
+    const sessionId = normalizeReattachLookupId(options.sessionId, "Research session id");
+    const codexSessionId = options.codexSessionId === undefined
+        ? undefined
+        : normalizeReattachLookupId(options.codexSessionId, "Codex session id");
+    return [...new Set([codexSessionId, sessionId].filter((value) => Boolean(value)))];
+}
+function normalizeExistingSessionId(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new Error("Existing Codex session id must not be blank");
+    }
+    return normalized;
+}
+function normalizeReattachLookupId(value, label) {
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new Error(`${label} must not be blank`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=codex-cli-session-manager.js.map

package/dist/adapters/proposer/codex-cli-session-manager.js.map

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

package/dist/adapters/proposer/codex-cli-session-outcome-extractor.d.ts

@@ -0,0 +1,3 @@
+import type { CodexCliSessionTranscript } from "./codex-cli-session-driver.js";
+import { type CodexCliSessionOutcome } from "../../core/model/codex-cli-session-outcome.js";
+export declare function extractCodexCliSessionOutcome(transcript: CodexCliSessionTranscript): CodexCliSessionOutcome;

package/dist/adapters/proposer/codex-cli-session-outcome-extractor.js

@@ -0,0 +1,94 @@
+import { CODEX_CLI_SESSION_OUTCOME_BEGIN_MARKER, CODEX_CLI_SESSION_OUTCOME_END_MARKER, codexCliAgentTerminalOutcomeSchema, } from "../../core/model/codex-cli-session-outcome.js";
+export function extractCodexCliSessionOutcome(transcript) {
+    const exit = transcript.exit ?? {
+        code: null,
+        signal: null,
+    };
+    if (!transcript.exit || !transcript.endedAt) {
+        return {
+            type: "terminal_runtime_error",
+            reasonCode: "transcript_not_finalized",
+            summary: "Codex CLI transcript is not finalized at a completed cycle boundary.",
+            exit,
+        };
+    }
+    if (transcript.exit.signal) {
+        return {
+            type: "terminal_runtime_error",
+            reasonCode: "process_exit_signaled",
+            summary: `Codex CLI session exited from signal ${transcript.exit.signal}.`,
+            exit,
+        };
+    }
+    if (transcript.exit.code !== 0) {
+        return {
+            type: "terminal_runtime_error",
+            reasonCode: "process_exit_non_zero",
+            summary: `Codex CLI session exited with code ${transcript.exit.code}.`,
+            exit,
+        };
+    }
+    const output = transcript.entries
+        .filter((entry) => entry.stream !== "stdin")
+        .map((entry) => entry.text)
+        .join("");
+    const startMatches = findAllMarkers(output, CODEX_CLI_SESSION_OUTCOME_BEGIN_MARKER);
+    const endMatches = findAllMarkers(output, CODEX_CLI_SESSION_OUTCOME_END_MARKER);
+    const startMarker = startMatches[0];
+    const endMarker = endMatches[0];
+    if (startMatches.length === 0 && endMatches.length === 0) {
+        return {
+            type: "terminal_runtime_error",
+            reasonCode: "missing_terminal_outcome",
+            summary: "Codex CLI transcript did not emit a terminal outcome marker.",
+            exit,
+        };
+    }
+    if (startMatches.length !== 1 ||
+        endMatches.length !== 1 ||
+        startMarker === undefined ||
+        endMarker === undefined ||
+        endMarker < startMarker) {
+        return {
+            type: "terminal_runtime_error",
+            reasonCode: startMatches.length === endMatches.length &&
+                startMatches.length > 1
+                ? "duplicate_terminal_outcomes"
+                : "partial_terminal_outcome",
+            summary: "Codex CLI transcript must contain exactly one complete terminal outcome block.",
+            exit,
+        };
+    }
+    const payload = output
+        .slice(startMarker + CODEX_CLI_SESSION_OUTCOME_BEGIN_MARKER.length, endMarker)
+        .trim();
+    if (!payload) {
+        return {
+            type: "terminal_runtime_error",
+            reasonCode: "invalid_terminal_outcome",
+            summary: "Codex CLI terminal outcome block was empty.",
+            exit,
+        };
+    }
+    try {
+        return codexCliAgentTerminalOutcomeSchema.parse(JSON.parse(payload));
+    }
+    catch {
+        return {
+            type: "terminal_runtime_error",
+            reasonCode: "invalid_terminal_outcome",
+            summary: "Codex CLI terminal outcome block was not valid session outcome JSON.",
+            exit,
+        };
+    }
+}
+function findAllMarkers(haystack, marker) {
+    const positions = [];
+    let index = haystack.indexOf(marker);
+    while (index !== -1) {
+        positions.push(index);
+        index = haystack.indexOf(marker, index + marker.length);
+    }
+    return positions;
+}
+//# sourceMappingURL=codex-cli-session-outcome-extractor.js.map

package/dist/adapters/proposer/codex-cli-session-outcome-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-cli-session-outcome-extractor.js","sourceRoot":"","sources":["../../../src/adapters/proposer/codex-cli-session-outcome-extractor.ts"],"names":[],"mappings":"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"}

package/dist/adapters/proposer/proposer-factory.d.ts

@@ -0,0 +1,22 @@
+import type { LeafProposerConfig } from "../../core/manifest/schema.js";
+import type { CodexCliCycleSessionContext } from "../../core/model/codex-cli-cycle-session.js";
+import type { ProposalAdapterMetadata } from "../../core/model/run-record.js";
+import { type CodexCliSessionProposerDependencies } from "./codex-cli-proposer.js";
+import { runCommandProposer, type CommandProposalResult, type RunCommandProposerInput } from "./command-proposer.js";
+export interface ProposalExecutionInput extends RunCommandProposerInput {
+    codexSession?: CodexCliCycleSessionContext;
+}
+export interface ProposalExecutionResult {
+    proposerType: CommandProposalResult["proposerType"] | "codex_cli";
+    stdout: string;
+    stderr: string;
+    summary: string;
+    adapterMetadata?: ProposalAdapterMetadata;
+}
+export interface ProposerRunner {
+    run(input: ProposalExecutionInput): Promise<ProposalExecutionResult>;
+}
+export interface ProposerFactoryDependencies extends CodexCliSessionProposerDependencies {
+    runCommand?: typeof runCommandProposer;
+}
+export declare function createProposerRunner(proposer: LeafProposerConfig, dependencies?: ProposerFactoryDependencies): ProposerRunner;