ralph-research 0.1.2 → 0.1.3

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;

package/dist/adapters/proposer/proposer-factory.js

@@ -0,0 +1,19 @@
+import { CodexCliSessionProposer } from "./codex-cli-proposer.js";
+import { runCommandProposer, } from "./command-proposer.js";
+export function createProposerRunner(proposer, dependencies = {}) {
+    switch (proposer.type) {
+        case "command":
+            return {
+                run: (input) => (dependencies.runCommand ?? runCommandProposer)(proposer, input),
+            };
+        case "codex_cli":
+            return new CodexCliSessionProposer(proposer, {
+                ...(dependencies.createSessionManager ? { createSessionManager: dependencies.createSessionManager } : {}),
+                ...(dependencies.createSessionId ? { createSessionId: dependencies.createSessionId } : {}),
+                ...(dependencies.now ? { now: dependencies.now } : {}),
+            });
+        default:
+            throw new Error(`unsupported proposer type ${proposer.type} in cycle runner`);
+    }
+}
+//# sourceMappingURL=proposer-factory.js.map

package/dist/adapters/proposer/proposer-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposer-factory.js","sourceRoot":"","sources":["../../../src/adapters/proposer/proposer-factory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAA4C,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EACL,kBAAkB,GAGnB,MAAM,uBAAuB,CAAC;AAqB/B,MAAM,UAAU,oBAAoB,CAClC,QAA4B,EAC5B,eAA4C,EAAE;IAE9C,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,SAAS;YACZ,OAAO;gBACL,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,UAAU,IAAI,kBAAkB,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC;aACjF,CAAC;QACJ,KAAK,WAAW;YACd,OAAO,IAAI,uBAAuB,CAAC,QAAQ,EAAE;gBAC3C,GAAG,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,YAAY,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzG,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1F,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD,CAAC,CAAC;QACL;YACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,IAAI,kBAAkB,CAAC,CAAC;IAClF,CAAC;AACH,CAAC"}

package/dist/app/services/codex-cli-session-lifecycle-service.d.ts

@@ -0,0 +1,116 @@
+import type { CodexCliSessionLifecyclePhase, CodexCliSessionLifecycleRecord } from "../../core/model/codex-cli-session-lifecycle.js";
+import type { ResearchSessionRecord } from "../../core/model/research-session.js";
+import type { PersistedCodexSessionReference } from "../../core/ports/research-session-repository.js";
+import type { ResearchSessionRecoveryStatus } from "../../core/state/research-session-recovery-classifier.js";
+import { ResearchSessionRecoveryService, type ResearchSessionRecoveryInspection, type ResearchSessionRecoveryInput } from "./research-session-recovery-service.js";
+type ReusableAttachmentPhase = Extract<CodexCliSessionLifecyclePhase, "starting" | "running">;
+export type CodexCliSessionAttachability = {
+    mode: "attach";
+    attachable: true;
+    resumable: false;
+    reason: string;
+} | {
+    mode: "resume";
+    attachable: false;
+    resumable: true;
+    reason: string;
+} | {
+    mode: "inspect";
+    attachable: false;
+    resumable: false;
+    reason: string;
+};
+export interface CodexCliReusableAttachmentTarget {
+    kind: "reusable_attachment_target";
+    session: ResearchSessionRecord;
+    lifecycle: CodexCliSessionLifecycleRecord & {
+        phase: ReusableAttachmentPhase;
+        pid: number;
+        attachmentState: CodexCliSessionLifecycleRecord["attachmentState"] & {
+            status: "bound";
+        };
+    };
+    recovery: ResearchSessionRecoveryStatus;
+    attachability: Extract<CodexCliSessionAttachability, {
+        mode: "attach";
+    }>;
+    target: {
+        researchSessionId: string;
+        codexSessionId: string;
+        pid: number;
+        phase: ReusableAttachmentPhase;
+        command: string;
+        args: string[];
+        workingDirectory: string;
+        attachmentStatus: "bound";
+        trackedGlobs: string[];
+        extraWritableDirectories: string[];
+        tty: CodexCliSessionLifecycleRecord["tty"];
+        workspaceRef?: string;
+        workspacePath?: string;
+        checkpointRunId?: string;
+        checkpointDecisionId?: string;
+    };
+}
+export interface CodexCliStaleSessionOutcome {
+    kind: "stale_session_outcome";
+    session: ResearchSessionRecord;
+    lifecycle: CodexCliSessionLifecycleRecord | null;
+    recovery: ResearchSessionRecoveryStatus;
+    attachability: Exclude<CodexCliSessionAttachability, {
+        mode: "attach";
+    }>;
+    outcome: {
+        runtimeState: ResearchSessionRecoveryStatus["runtime"]["state"];
+        completedCycles: number;
+        resumeFromCycle: number;
+        resumable: boolean;
+        reason: string;
+        phase?: CodexCliSessionLifecyclePhase;
+        attachmentStatus?: CodexCliSessionLifecycleRecord["attachmentState"]["status"];
+    };
+}
+export interface CodexCliReuseExistingSessionDecision {
+    decision: "reuse";
+    session: ResearchSessionRecord;
+    lifecycle: CodexCliSessionLifecycleRecord & {
+        phase: ReusableAttachmentPhase;
+        pid: number;
+        attachmentState: CodexCliSessionLifecycleRecord["attachmentState"] & {
+            status: "bound";
+        };
+    };
+    recovery: ResearchSessionRecoveryStatus;
+    codexSessionReference: PersistedCodexSessionReference;
+    reason: string;
+    reuse: CodexCliReusableAttachmentTarget["target"];
+}
+export interface CodexCliReplaceExistingSessionDecision {
+    decision: "replace";
+    session: ResearchSessionRecord;
+    lifecycle: CodexCliSessionLifecycleRecord | null;
+    recovery: ResearchSessionRecoveryStatus;
+    codexSessionReference: PersistedCodexSessionReference | null;
+    reason: string;
+    replace: CodexCliStaleSessionOutcome["outcome"] & {
+        attachabilityMode: Exclude<CodexCliSessionAttachability["mode"], "attach">;
+    };
+}
+export type CodexCliSessionLifecycleServiceResult = CodexCliReusableAttachmentTarget | CodexCliStaleSessionOutcome;
+export type CodexCliSessionReuseOrReplaceDecision = CodexCliReuseExistingSessionDecision | CodexCliReplaceExistingSessionDecision;
+export interface CodexCliSessionLifecycleServiceDependencies {
+    recoveryService?: Pick<ResearchSessionRecoveryService, "inspectSession">;
+    createRecoveryService?: () => Pick<ResearchSessionRecoveryService, "inspectSession">;
+    attachabilityValidator?: (inspection: ResearchSessionRecoveryInspection) => CodexCliSessionAttachability;
+}
+export declare class CodexCliSessionLifecycleService {
+    private readonly recoveryService;
+    private readonly attachabilityValidator;
+    constructor(dependencies?: CodexCliSessionLifecycleServiceDependencies);
+    inspectSession(input: ResearchSessionRecoveryInput): Promise<CodexCliSessionLifecycleServiceResult>;
+    resolveCycleSession(input: ResearchSessionRecoveryInput): Promise<CodexCliSessionReuseOrReplaceDecision>;
+}
+export declare function classifyCodexCliSessionLifecycleInspection(inspection: ResearchSessionRecoveryInspection): CodexCliSessionLifecycleServiceResult;
+export declare function resolveCodexCliSessionReuseOrReplaceDecision(inspection: ResearchSessionRecoveryInspection, attachability?: CodexCliSessionAttachability): CodexCliSessionReuseOrReplaceDecision;
+export declare function validateCodexCliSessionAttachability(inspection: ResearchSessionRecoveryInspection): CodexCliSessionAttachability;
+export {};