@botiverse/oar 0.0.1

package/dist/runtimes/claude/session.js

@@ -0,0 +1,166 @@
+import { randomUUID } from "node:crypto";
+import { spawnLineProcess } from "../../shared/executable/index.js";
+import { asRecord, parseJson } from "../../shared/json.js";
+import { claudeContextUsageFromResult } from "./context-usage.js";
+import { sealSession } from "../../shared/seal-session.js";
+import { createSessionKernel } from "../../shared/session-kernel.js";
+import { claudeAbortRequested, claudePrompted, foldClaudeStdout, initialClaudeProjection, } from "./projection.js";
+/*
+ * Live semantics this adapter is built on (drydock probes, 2026-08-21):
+ * - stdin accepts writes at every phase; a mid-turn write is delivered into
+ *   the ACTIVE turn at the next model-step boundary (steer), or becomes the
+ *   next turn when no step remains. Landing shows up in the event stream.
+ * - each turn is framed by its own system/init … result pair.
+ * - `control_request {subtype:"interrupt"}` is acked with control_response and
+ *   settles the active turn with an error-subtype result.
+ * - steer `accepted` here means: the user message was written to stdin.
+ *   Landing (same turn vs auto-queued next turn) is claude's timing and shows
+ *   up only in the event stream. Live probe: claude-session-adapter.ts.
+ */
+function userMessage(text) {
+    return `${JSON.stringify({
+        type: "user",
+        message: { role: "user", content: [{ type: "text", text }] },
+    })}\n`;
+}
+export const claudeSession = async (installation, options) => {
+    if (installation.via !== "executable") {
+        throw new Error("The claude session adapter needs an executable installation");
+    }
+    // Session identity is claude's own: we either choose it up front
+    // (--session-id) or reattach to an existing one (--resume), so Session.id
+    // is always the runtime-native persistent id.
+    const sessionId = options.resume ?? randomUUID();
+    const child = spawnLineProcess(installation.command, [
+        "-p",
+        "--input-format", "stream-json",
+        "--output-format", "stream-json",
+        "--verbose",
+        // YOLO by default (repo policy, 2026-08-24): in embedded/SDK use there is
+        // no human at an approval prompt — a permission gate is a hang, not
+        // safety. Isolation is the sandbox's job, not the approval flow's.
+        "--dangerously-skip-permissions",
+        ...(options.resume === undefined ? ["--session-id", sessionId] : ["--resume", sessionId]),
+        ...(options.model === undefined ? [] : ["--model", options.model]),
+        ...(options.systemPrompt === undefined ? [] : ["--system-prompt", options.systemPrompt]),
+        ...(options.appendSystemPrompt === undefined ? [] : ["--append-system-prompt", options.appendSystemPrompt]),
+    ], {
+        cwd: options.cwd,
+        env: { ...process.env, CLAUDECODE: undefined, ...options.env },
+    });
+    await child.spawned;
+    const kernel = createSessionKernel(sessionId);
+    const state = { child, turn: null, projection: initialClaudeProjection, disposed: false };
+    let interruptCounter = 0;
+    // claude cannot hold input for a LATER turn natively (an active-turn write
+    // steers), so queueing is adapter-held: drained one message per turn end.
+    const heldQueue = [];
+    // Current context fullness snapshot (last-write-wins from the result frame).
+    let latestContextUsage = null;
+    // Drive the pure projection fold, applying its commands to the kernel. The
+    // fold owns turn framing and event translation; this owns only transport.
+    child.onLine((line) => {
+        const message = asRecord(parseJson(line));
+        if (message === null) {
+            return;
+        }
+        if (message.type === "result") {
+            latestContextUsage = claudeContextUsageFromResult(message) ?? latestContextUsage;
+        }
+        const { state: nextProjection, commands } = foldClaudeStdout(state.projection, message);
+        state.projection = nextProjection;
+        let settled = false;
+        for (const command of commands) {
+            switch (command.kind) {
+                case "begin":
+                    state.turn = kernel.begin();
+                    break;
+                case "emit":
+                    state.turn?.emit(command.body);
+                    break;
+                case "settle":
+                    state.turn?.settle(command.outcome);
+                    state.turn = null;
+                    settled = true;
+                    break;
+                default:
+                    break;
+            }
+        }
+        if (settled && !state.disposed) {
+            const next = heldQueue.shift();
+            if (next !== undefined) {
+                child.write(userMessage(next));
+            }
+        }
+    });
+    child.onExit(() => {
+        const active = kernel.active();
+        if (active !== null && !state.disposed) {
+            active.settle({ kind: "failed", reason: "claude process exited", failure: "runtime_exited" });
+        }
+    });
+    const makeTurn = (turn) => ({
+        id: turn.id,
+        outcome: turn.outcome,
+        abort: async () => {
+            if (turn.settled()) {
+                return;
+            }
+            state.projection = claudeAbortRequested(state.projection);
+            interruptCounter += 1;
+            child.write(`${JSON.stringify({
+                type: "control_request",
+                request_id: `interrupt-${interruptCounter}`,
+                request: { subtype: "interrupt" },
+            })}\n`);
+            await turn.outcome;
+        },
+        steer: async (input) => {
+            await Promise.resolve();
+            if (turn.settled()) {
+                return { kind: "not_steerable", reason: "turn already ended" };
+            }
+            child.write(userMessage(input));
+            return { kind: "accepted" };
+        },
+    });
+    const session = sealSession({
+        id: kernel.sessionId,
+        prompt(input) {
+            const turn = kernel.begin();
+            if (turn === null) {
+                return { kind: "busy" };
+            }
+            state.turn = turn;
+            state.projection = claudePrompted();
+            child.write(userMessage(input));
+            return { kind: "turn", turn: makeTurn(turn) };
+        },
+        subscribe: (observer) => kernel.subscribe(observer),
+        contextUsage: () => latestContextUsage,
+        queue: {
+            durable: false,
+            add: async (input) => {
+                await Promise.resolve();
+                if (kernel.active() === null) {
+                    child.write(userMessage(input));
+                }
+                else {
+                    heldQueue.push(input);
+                }
+            },
+        },
+        dispose: async () => {
+            if (state.disposed) {
+                return;
+            }
+            state.disposed = true;
+            kernel.active()?.settle({ kind: "aborted" });
+            child.kill();
+            await child.exited; // release point for anything the process held
+        },
+    });
+    return session;
+};
+//# sourceMappingURL=session.js.map

package/dist/runtimes/claude/session.js.map

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

package/dist/runtimes/codex/account-usage.d.ts

@@ -0,0 +1,40 @@
+import type { AccountUsageReader, AccountUsageSnapshot } from "../../contracts/account-usage.js";
+/**
+ * Native evidence comes from `codex app-server --listen stdio://`, followed by
+ * `initialize` and `account/rateLimits/read`. `rateLimits` is the
+ * backward-compatible single-bucket view; `rateLimitsByLimitId` is the
+ * optional multi-bucket view. A representative response is:
+ *
+ * ```json
+ * {
+ *   "rateLimits": {
+ *     "limitId": "codex",
+ *     "limitName": null,
+ *     "primary": { "usedPercent": 50, "windowDurationMins": 10080, "resetsAt": 1787820410 },
+ *     "secondary": null,
+ *     "planType": "pro",
+ *     "rateLimitReachedType": null
+ *   },
+ *   "rateLimitsByLimitId": {
+ *     "codex_bengalfox": {
+ *       "limitId": "codex_bengalfox",
+ *       "limitName": "GPT-5.3-Codex-Spark",
+ *       "primary": { "usedPercent": 0, "windowDurationMins": 300, "resetsAt": 1787322278 },
+ *       "secondary": { "usedPercent": 0, "windowDurationMins": 10080, "resetsAt": 1787909078 },
+ *       "planType": "pro"
+ *     },
+ *     "codex": {
+ *       "limitId": "codex",
+ *       "limitName": null,
+ *       "primary": { "usedPercent": 50, "windowDurationMins": 10080, "resetsAt": 1787820410 },
+ *       "secondary": null,
+ *       "planType": "pro",
+ *       "rateLimitReachedType": null
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare function projectCodexUsage(result: unknown): AccountUsageSnapshot;
+export declare const codexAccountUsage: AccountUsageReader;
+//# sourceMappingURL=account-usage.d.ts.map

package/dist/runtimes/codex/account-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-usage.d.ts","sourceRoot":"","sources":["../../../src/runtimes/codex/account-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EAErB,MAAM,kCAAkC,CAAC;AA2E1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,oBAAoB,CA4CvE;AA8BD,eAAO,MAAM,iBAAiB,EAAE,kBAgB/B,CAAC"}

package/dist/runtimes/codex/account-usage.js

@@ -0,0 +1,185 @@
+import { startAppServerClient } from "./app-server-client.js";
+import { asEpochInstant, asNumber, asRecord } from "../../shared/json.js";
+function text(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 && trimmed.length <= 80 ? trimmed : undefined;
+}
+function windowLabel(value) {
+    const minutes = asNumber(value);
+    if (minutes === null || minutes <= 0) {
+        return "Usage limit";
+    }
+    if (minutes % (7 * 24 * 60) === 0) {
+        const weeks = minutes / (7 * 24 * 60);
+        return `${weeks} ${weeks === 1 ? "week" : "weeks"}`;
+    }
+    if (minutes % (24 * 60) === 0) {
+        const days = minutes / (24 * 60);
+        return `${days} ${days === 1 ? "day" : "days"}`;
+    }
+    if (minutes % 60 === 0) {
+        const hours = minutes / 60;
+        return `${hours} ${hours === 1 ? "hour" : "hours"}`;
+    }
+    return `${minutes} minutes`;
+}
+function limitLabel(bucket) {
+    const name = text(bucket.limitName);
+    if (name !== undefined) {
+        return name;
+    }
+    const id = text(bucket.limitId);
+    return id === "codex" ? "Codex" : id;
+}
+/**
+ * Mirrors Codex TUI's `app_server_rate_limit_snapshots` merge and deduplication.
+ * Source (2026-08-22):
+ * https://github.com/openai/codex/blob/4f39251a010a8bd7d692d25fb33832ff06f1635a/codex-rs/tui/src/app_server_session.rs#L2084-L2103
+ */
+function rateLimitBuckets(historical, indexed) {
+    const primaryLimitId = text(historical?.limitId);
+    const buckets = historical === null ? [] : [historical];
+    if (indexed === null) {
+        return buckets;
+    }
+    for (const [limitId, value] of Object.entries(indexed)) {
+        const bucket = asRecord(value);
+        if (bucket === null) {
+            continue;
+        }
+        if (primaryLimitId !== undefined
+            && (primaryLimitId === limitId || primaryLimitId === text(bucket.limitId))) {
+            continue;
+        }
+        buckets.push(bucket);
+    }
+    return buckets;
+}
+/**
+ * Native evidence comes from `codex app-server --listen stdio://`, followed by
+ * `initialize` and `account/rateLimits/read`. `rateLimits` is the
+ * backward-compatible single-bucket view; `rateLimitsByLimitId` is the
+ * optional multi-bucket view. A representative response is:
+ *
+ * ```json
+ * {
+ *   "rateLimits": {
+ *     "limitId": "codex",
+ *     "limitName": null,
+ *     "primary": { "usedPercent": 50, "windowDurationMins": 10080, "resetsAt": 1787820410 },
+ *     "secondary": null,
+ *     "planType": "pro",
+ *     "rateLimitReachedType": null
+ *   },
+ *   "rateLimitsByLimitId": {
+ *     "codex_bengalfox": {
+ *       "limitId": "codex_bengalfox",
+ *       "limitName": "GPT-5.3-Codex-Spark",
+ *       "primary": { "usedPercent": 0, "windowDurationMins": 300, "resetsAt": 1787322278 },
+ *       "secondary": { "usedPercent": 0, "windowDurationMins": 10080, "resetsAt": 1787909078 },
+ *       "planType": "pro"
+ *     },
+ *     "codex": {
+ *       "limitId": "codex",
+ *       "limitName": null,
+ *       "primary": { "usedPercent": 50, "windowDurationMins": 10080, "resetsAt": 1787820410 },
+ *       "secondary": null,
+ *       "planType": "pro",
+ *       "rateLimitReachedType": null
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export function projectCodexUsage(result) {
+    const root = asRecord(result);
+    const historical = asRecord(root?.rateLimits);
+    const indexed = asRecord(root?.rateLimitsByLimitId);
+    const buckets = rateLimitBuckets(historical, indexed);
+    const windows = [];
+    let rateLimited = false;
+    let plan = undefined;
+    for (const bucket of buckets) {
+        const sourceLabel = limitLabel(bucket);
+        plan ??= text(bucket.planType);
+        rateLimited ||= bucket.rateLimitReachedType !== null
+            && bucket.rateLimitReachedType !== undefined;
+        for (const kind of ["primary", "secondary"]) {
+            const candidate = asRecord(bucket[kind]);
+            if (candidate === null) {
+                continue;
+            }
+            const usedPercent = asNumber(candidate.usedPercent);
+            if (usedPercent === null || usedPercent < 0 || usedPercent > 100) {
+                continue;
+            }
+            const resetsAt = asEpochInstant(candidate.resetsAt);
+            const durationLabel = windowLabel(candidate.windowDurationMins);
+            windows.push({
+                label: sourceLabel === undefined ? durationLabel : `${sourceLabel} · ${durationLabel}`,
+                usedRatio: Number((usedPercent / 100).toFixed(6)),
+                ...(resetsAt === null ? {} : { resetsAt }),
+            });
+            rateLimited ||= usedPercent >= 100;
+        }
+    }
+    if (windows.length === 0) {
+        throw new Error("Codex returned no usable account usage windows");
+    }
+    return {
+        kind: "available",
+        ...(plan === undefined ? {} : { plan }),
+        rateLimited,
+        windows,
+    };
+}
+async function readFromAppServer(command, timeoutMs) {
+    const client = startAppServerClient(command);
+    const deadline = setTimeout(() => {
+        client.kill();
+    }, timeoutMs);
+    try {
+        await client.request("initialize", {
+            clientInfo: { name: "oar", version: "0.0.0" },
+            capabilities: { experimentalApi: true },
+        });
+        client.notify("initialized", {});
+        const result = await client.request("account/rateLimits/read", {});
+        return { kind: "ok", result };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "";
+        if (/authentication required/iu.test(message)) {
+            return { kind: "reauth_required" };
+        }
+        if (/method not found|not supported/iu.test(message)) {
+            return { kind: "unsupported" };
+        }
+        return { kind: "error" };
+    }
+    finally {
+        clearTimeout(deadline);
+        client.kill();
+    }
+}
+export const codexAccountUsage = async (installation, options = {}) => {
+    if (installation.via !== "executable") {
+        return { kind: "unsupported" };
+    }
+    const outcome = await readFromAppServer(installation.command, options.timeoutMs ?? 8000);
+    switch (outcome.kind) {
+        case "ok":
+            return projectCodexUsage(outcome.result);
+        case "reauth_required":
+            return { kind: "reauth_required" };
+        case "unsupported":
+            return { kind: "unsupported" };
+        case "error":
+            break;
+    }
+    throw new Error("Failed to read Codex account usage");
+};
+//# sourceMappingURL=account-usage.js.map

package/dist/runtimes/codex/account-usage.js.map

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

package/dist/runtimes/codex/app-server-client.d.ts

@@ -0,0 +1,17 @@
+import { type JsonRecord } from "../../shared/json.js";
+/**
+ * Minimal persistent JSON-RPC client over codex app-server's stdio JSONL
+ * transport. Local to the codex runtime until a second consumer earns a
+ * shared promotion; process mechanics live in shared/executable.
+ */
+export interface AppServerClient {
+    readonly spawned: Promise<void>;
+    readonly exited: Promise<number | null>;
+    request(method: string, params: JsonRecord): Promise<JsonRecord>;
+    notify(method: string, params: JsonRecord): void;
+    onNotification(handler: (method: string, params: JsonRecord) => void): void;
+    onExit(handler: () => void): void;
+    kill(): void;
+}
+export declare function startAppServerClient(command: string, env?: Readonly<Record<string, string>>, configOverrides?: Readonly<Record<string, string>>): AppServerClient;
+//# sourceMappingURL=app-server-client.d.ts.map

package/dist/runtimes/codex/app-server-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-server-client.d.ts","sourceRoot":"","sources":["../../../src/runtimes/codex/app-server-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACjD,cAAc,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5E,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAClC,IAAI,IAAI,IAAI,CAAC;CACd;AAOD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,eAAe,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GACrD,eAAe,CAoEjB"}

package/dist/runtimes/codex/app-server-client.js

@@ -0,0 +1,68 @@
+import { spawnLineProcess } from "../../shared/executable/index.js";
+import { asRecord, parseJson } from "../../shared/json.js";
+export function startAppServerClient(command, env, configOverrides = {}) {
+    // -c KEY=VALUE injects config at launch. This is the ONLY seam that reaches
+    // codex's exec tool: thread/start.sandboxMode does not (pinned on a real
+    // login — thread param honored for its own turns but exec follows config).
+    const overrideArgs = Object.entries(configOverrides).flatMap(([key, value]) => ["-c", `${key}=${value}`]);
+    const child = spawnLineProcess(command, ["app-server", ...overrideArgs, "--listen", "stdio://"], env === undefined ? {} : { env: { ...process.env, ...env } });
+    const pending = new Map();
+    const notificationHandlers = [];
+    let nextId = 1;
+    child.onLine((line) => {
+        const message = asRecord(parseJson(line));
+        if (message === null) {
+            return;
+        }
+        if (typeof message.id === "number" && pending.has(message.id)) {
+            const waiter = pending.get(message.id);
+            pending.delete(message.id);
+            const error = asRecord(message.error);
+            if (error !== null) {
+                waiter?.reject(new Error(typeof error.message === "string" ? error.message : "app-server error"));
+            }
+            else {
+                waiter?.resolve(asRecord(message.result) ?? {});
+            }
+        }
+        else if (typeof message.method === "string") {
+            const params = asRecord(message.params) ?? {};
+            for (const handler of notificationHandlers) {
+                handler(message.method, params);
+            }
+        }
+    });
+    child.onExit(() => {
+        for (const waiter of pending.values()) {
+            waiter.reject(new Error("app-server exited"));
+        }
+        pending.clear();
+    });
+    return {
+        spawned: child.spawned,
+        exited: child.exited,
+        async request(method, params) {
+            const id = nextId;
+            nextId += 1;
+            // oxlint-disable-next-line promise/avoid-new -- settlement is driven by the response pump
+            const result = await new Promise((resolve, reject) => {
+                pending.set(id, { resolve, reject });
+                child.write(`${JSON.stringify({ id, method, params })}\n`);
+            });
+            return result;
+        },
+        notify(method, params) {
+            child.write(`${JSON.stringify({ method, params })}\n`);
+        },
+        onNotification(handler) {
+            notificationHandlers.push(handler);
+        },
+        onExit(handler) {
+            child.onExit(handler);
+        },
+        kill() {
+            child.kill();
+        },
+    };
+}
+//# sourceMappingURL=app-server-client.js.map

package/dist/runtimes/codex/app-server-client.js.map

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

package/dist/runtimes/codex/context-usage.d.ts

@@ -0,0 +1,10 @@
+import type { ContextUsage } from "../../contracts/session.js";
+import { type JsonRecord } from "../../shared/json.js";
+/**
+ * Codex reports usage in the streaming thread/tokenUsage/updated notification
+ * (cumulative). `total.inputTokens` is the context sent; codex does NOT
+ * include the context window in this event, so contextWindow/percent stay
+ * null unless a future field carries it. We cache the latest (last-wins).
+ */
+export declare function codexContextUsageFromNotification(params: JsonRecord): ContextUsage | null;
+//# sourceMappingURL=context-usage.d.ts.map

package/dist/runtimes/codex/context-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-usage.d.ts","sourceRoot":"","sources":["../../../src/runtimes/codex/context-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CAOzF"}

package/dist/runtimes/codex/context-usage.js

@@ -0,0 +1,16 @@
+import { asNumber, asRecord } from "../../shared/json.js";
+/**
+ * Codex reports usage in the streaming thread/tokenUsage/updated notification
+ * (cumulative). `total.inputTokens` is the context sent; codex does NOT
+ * include the context window in this event, so contextWindow/percent stay
+ * null unless a future field carries it. We cache the latest (last-wins).
+ */
+export function codexContextUsageFromNotification(params) {
+    const total = asRecord(asRecord(params.tokenUsage)?.total);
+    if (total === null) {
+        return null;
+    }
+    const tokens = asNumber(total.inputTokens);
+    return { tokens: tokens ?? null, contextWindow: null, percent: null };
+}
+//# sourceMappingURL=context-usage.js.map

package/dist/runtimes/codex/context-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-usage.js","sourceRoot":"","sources":["../../../src/runtimes/codex/context-usage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAmB,MAAM,sBAAsB,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAAkB;IAClE,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACxE,CAAC"}

package/dist/runtimes/codex/index.d.ts

@@ -0,0 +1,9 @@
+export declare const codexRuntime: {
+    readonly id: "codex";
+    readonly installation: import("../../index.js").InstallationProbe;
+    readonly accountUsage: import("../../index.js").AccountUsageReader;
+    readonly session: import("../../index.js").StartSession;
+};
+export { codexAccountUsage, projectCodexUsage } from "./account-usage.js";
+export { codexSession } from "./session.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtimes/codex/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtimes/codex/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,YAAY;;;;;CAKvB,CAAC;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/runtimes/codex/index.js

@@ -0,0 +1,13 @@
+import { defineRuntime } from "../../contracts/runtime.js";
+import { codexAccountUsage } from "./account-usage.js";
+import { codexInstallation } from "./installation.js";
+import { codexSession } from "./session.js";
+export const codexRuntime = defineRuntime({
+    id: "codex",
+    installation: codexInstallation,
+    accountUsage: codexAccountUsage,
+    session: codexSession,
+});
+export { codexAccountUsage, projectCodexUsage } from "./account-usage.js";
+export { codexSession } from "./session.js";
+//# sourceMappingURL=index.js.map

package/dist/runtimes/codex/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtimes/codex/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;IACxC,EAAE,EAAE,OAAO;IACX,YAAY,EAAE,iBAAiB;IAC/B,YAAY,EAAE,iBAAiB;IAC/B,OAAO,EAAE,YAAY;CACtB,CAAC,CAAC;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/runtimes/codex/installation.d.ts

@@ -0,0 +1,2 @@
+export declare const codexInstallation: import("../../index.js").InstallationProbe;
+//# sourceMappingURL=installation.d.ts.map

package/dist/runtimes/codex/installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../../../src/runtimes/codex/installation.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,iBAAiB,4CAK7B,CAAC"}

package/dist/runtimes/codex/installation.js

@@ -0,0 +1,17 @@
+import os from "node:os";
+import path from "node:path";
+import { executableInstallation } from "../../shared/installation.js";
+// The macOS Desktop app bundles the Codex CLI instead of putting it on PATH.
+// OpenAI relocated the app from Codex.app to ChatGPT.app, so the new bundle is
+// tried before the legacy one, and system installs before per-user installs.
+const desktopBundles = process.platform === "darwin"
+    ? [
+        "/Applications/ChatGPT.app/Contents/Resources/codex",
+        "/Applications/Codex.app/Contents/Resources/codex",
+        path.join(os.homedir(), "Applications", "ChatGPT.app", "Contents", "Resources", "codex"),
+        path.join(os.homedir(), "Applications", "Codex.app", "Contents", "Resources", "codex"),
+    ]
+    : [];
+// OAR drives Codex through its app-server surface; a codex without it is unsupported.
+export const codexInstallation = executableInstallation("OAR_CODEX_BIN", "codex", desktopBundles, ["app-server", "--help"]);
+//# sourceMappingURL=installation.js.map

package/dist/runtimes/codex/installation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.js","sourceRoot":"","sources":["../../../src/runtimes/codex/installation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAC7E,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ;IAClD,CAAC,CAAC;QACE,oDAAoD;QACpD,kDAAkD;QAClD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC;QACxF,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC;KACvF;IACH,CAAC,CAAC,EAAE,CAAC;AAEP,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,sBAAsB,CACrD,eAAe,EACf,OAAO,EACP,cAAc,EACd,CAAC,YAAY,EAAE,QAAQ,CAAC,CACzB,CAAC"}

package/dist/runtimes/codex/item-detail.d.ts

@@ -0,0 +1,4 @@
+import { type JsonRecord } from "../../shared/json.js";
+export declare function codexItemInput(item: JsonRecord): string | undefined;
+export declare function codexItemOutput(item: JsonRecord): string | undefined;
+//# sourceMappingURL=item-detail.d.ts.map

package/dist/runtimes/codex/item-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-detail.d.ts","sourceRoot":"","sources":["../../../src/runtimes/codex/item-detail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAenE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CA4BpE"}