@ai21/gateway 1.3.1 → 1.5.0

package/dist/agents/codex/config.js

@@ -0,0 +1,347 @@
+/**
+ * Writing and reverting our part of `~/.codex/config.toml`.
+ *
+ * Same constraint as Claude Code's writer: this edits a file the developer owns. Every
+ * path leaves it byte-identical or replaces it atomically, with a `.bak` of the last
+ * state that was not ours, and no refusal touches it.
+ *
+ * What we own: the root `model_provider` line, and the `[model_providers.ai21]` and
+ * `[model_providers.ai21.http_headers]` tables, wrapped in marker comments when we add
+ * them. Whether a file is *ours* is judged by an `x-ai21-client` header naming this
+ * tool — a hand-pasted block from the dashboard has an `x-ai21-key` too, and must stay
+ * the developer's until they say otherwise with `--yes`.
+ */
+import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, realpathSync, rmSync, } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { atomicWrite, backupPathFor, describeFsError } from "../../fs/safeFile.js";
+import { ROOT_LINE, codexHeaders, codexTables } from "./snippets.js";
+import { HEADERS_TABLE, PROVIDER_ID, PROVIDER_TABLE, entries, joinLines, newlineOf, removeRange, scan, stringValue, } from "./toml.js";
+/** What a conflict shows instead of an AI21 key. */
+export const REDACTED = "****";
+export const MARKER_BEGIN = "# >>> AI21 Gateway (managed by ai21-gateway; `ai21-gateway uninstall --client codex` removes it)";
+export const MARKER_END = "# <<< AI21 Gateway";
+/** `CODEX_HOME` wins, as it does for Codex; a relative one is resolved against the cwd, as Codex does. */
+export function codexHome(env) {
+    const override = env.processEnv.CODEX_HOME;
+    return override !== undefined && override !== "" ? resolve(env.cwd, override) : join(env.home, ".codex");
+}
+export function resolveCodexPaths(dir) {
+    const settings = join(dir, "config.toml");
+    return { settings, backup: `${settings}.bak` };
+}
+/** Our client tag marks a block this tool wrote; nothing else does. */
+function isOurs(scanned) {
+    const client = entries(scanned, scanned.headers).get("x-ai21-client");
+    return client !== undefined && /^"ai21-gateway-cli\//.test(client);
+}
+/** The agent id our block names, for the uninstall guard. */
+export function storedAgentId(scanned) {
+    const raw = entries(scanned, scanned.headers).get("x-agent-id");
+    return raw === undefined ? undefined : stringValue(`x = ${raw}`);
+}
+/** The value a root `model_provider` line assigns, or undefined without one. */
+function rootProvider(scanned) {
+    if (scanned.rootModelProvider === undefined)
+        return undefined;
+    return stringValue(scanned.lines[scanned.rootModelProvider].text);
+}
+/** Resolves a symlink one level, so a write goes through the link rather than replacing it. */
+function followLink(path) {
+    try {
+        if (lstatSync(path, { throwIfNoEntry: false })?.isSymbolicLink() === true) {
+            return resolve(dirname(path), readlinkSync(path));
+        }
+    }
+    catch {
+        return path;
+    }
+    return path;
+}
+/**
+ * The file with our part put in: the root line replaced in place or inserted above the
+ * first table, and our tables replaced in place or appended in a marked block. Every
+ * position comes from the scan; nothing is found again by matching text, since another
+ * provider's table can hold the same lines as ours.
+ */
+function withOurs(scanned, inputs) {
+    const nl = newlineOf(scanned.lines);
+    const asLines = (texts) => texts.map((text) => ({ text, eol: nl }));
+    const tables = codexTables(inputs);
+    const split = tables.indexOf(`[${HEADERS_TABLE}]`);
+    const providerLines = tables.slice(0, split);
+    const headerLines = tables.slice(split);
+    /** A region's last line that is a key, so comments and blanks after it stay put. */
+    const keysEnd = (region) => {
+        let end = region.end;
+        while (end > region.start + 1 && /^\s*(#.*)?$/.test(scanned.lines[end - 1].text))
+            end -= 1;
+        return end;
+    };
+    // Edits as [start, end, replacement], applied bottom-up so earlier indices stay valid.
+    const edits = [];
+    const { provider, headers } = scanned;
+    if (provider === undefined && headers === undefined) {
+        const lines = scanned.lines;
+        const last = lines.at(-1);
+        const fix = last !== undefined && last.eol === "" ? [{ ...last, eol: nl }] : [];
+        const gap = lines.length > 0 && lines.at(-1).text.trim() !== "" ? asLines([""]) : [];
+        const at = lines.length - fix.length;
+        edits.push([at, lines.length, [...fix, ...gap, ...asLines([MARKER_BEGIN, ...tables, MARKER_END])]]);
+    }
+    else if (provider !== undefined && headers !== undefined) {
+        edits.push([provider.start, keysEnd(provider), asLines(providerLines)]);
+        edits.push([headers.start, keysEnd(headers), asLines(headerLines)]);
+    }
+    else if (provider !== undefined) {
+        // Headers go straight after the provider table's keys.
+        edits.push([provider.start, keysEnd(provider), asLines([...providerLines, ...headerLines])]);
+    }
+    else {
+        // Provider keys go straight before the headers table.
+        edits.push([headers.start, keysEnd(headers), asLines([...providerLines, ...headerLines])]);
+    }
+    let lines = [...scanned.lines];
+    for (const [start, end, replacement] of edits.sort((x, y) => y[0] - x[0])) {
+        lines = [...lines.slice(0, start), ...replacement, ...lines.slice(end)];
+    }
+    // Root keys sit before the first table, and every edit above is at or after it.
+    if (scanned.rootModelProvider !== undefined) {
+        lines[scanned.rootModelProvider] = { text: ROOT_LINE, eol: lines[scanned.rootModelProvider].eol };
+    }
+    else {
+        lines = [...asLines([ROOT_LINE]), ...lines];
+    }
+    const joined = joinLines(lines);
+    return joined.endsWith(nl) ? joined : joined + nl;
+}
+/**
+ * A structural re-read of what we are about to write: exactly one of each of our tables,
+ * the root line selecting ours, and nothing the scanner would refuse. Not a TOML parser —
+ * a line-level check that our own edit did not break the shape we rely on.
+ */
+function checkWritten(text) {
+    const again = scan(text);
+    if (again.unsupported !== undefined)
+        return "the edited file would not keep a valid shape";
+    if (again.provider === undefined || again.headers === undefined)
+        return "the edited file lost a provider table";
+    if (rootProvider(again) !== PROVIDER_ID)
+        return "the edited file would not select the AI21 provider";
+    return undefined;
+}
+/** Every value we would set, compared with what the file holds now. */
+function differences(scanned, inputs) {
+    const changed = [];
+    const conflicts = [];
+    const want = (key, current, desired, conflicting) => {
+        if (current === desired)
+            return;
+        changed.push(key);
+        // The key is masked here, where the conflict is made, so no later step can print it.
+        const secret = key === `${HEADERS_TABLE}.x-ai21-key`;
+        if (current !== undefined && conflicting) {
+            conflicts.push({ key, current: secret ? REDACTED : current, desired: secret ? REDACTED : desired });
+        }
+    };
+    const provider = entries(scanned, scanned.provider);
+    const headers = entries(scanned, scanned.headers);
+    // A root model_provider naming another provider is the developer's choice; ours replaces it.
+    want("model_provider", rootProvider(scanned), PROVIDER_ID, true);
+    // Only the provider table's own lines: they end where the headers table begins.
+    const tables = codexTables(inputs);
+    const providerKeyLines = tables.slice(1, tables.indexOf(`[${HEADERS_TABLE}]`));
+    for (const line of providerKeyLines) {
+        const [key] = line.split(" = ");
+        want(`${PROVIDER_TABLE}.${key}`, provider.get(key), line.slice(line.indexOf("=") + 1).trim(), true);
+    }
+    for (const [key, value] of codexHeaders(inputs)) {
+        const current = headers.get(key);
+        want(`${HEADERS_TABLE}.${key}`, current === undefined ? undefined : stringValue(`x = ${current}`), value, true);
+    }
+    // Keys in our tables that we do not write, e.g. a stale x-ai21-user-id: they go too.
+    for (const key of [...provider.keys()].filter((k) => !providerKeyLines.some((l) => l.startsWith(`${k} =`)))) {
+        changed.push(`${PROVIDER_TABLE}.${key}`);
+        conflicts.push({ key: `${PROVIDER_TABLE}.${key}`, current: provider.get(key), desired: "(removed)" });
+    }
+    for (const key of [...headers.keys()].filter((k) => !codexHeaders(inputs).some(([h]) => h === k))) {
+        changed.push(`${HEADERS_TABLE}.${key}`);
+        conflicts.push({ key: `${HEADERS_TABLE}.${key}`, current: headers.get(key), desired: "(removed)" });
+    }
+    return { changed, conflicts };
+}
+function load(path) {
+    let realPath;
+    let raw;
+    try {
+        realPath = realpathSync(path);
+        raw = readFileSync(realPath, "utf8");
+    }
+    catch (err) {
+        return { problem: { kind: "failed", reason: describeFsError(err) } };
+    }
+    const scanned = scan(raw);
+    if (scanned.unsupported !== undefined)
+        return { problem: { kind: "malformed", reason: scanned.unsupported } };
+    return { loaded: { realPath, raw, scanned } };
+}
+export function writeCodexConfig(paths, inputs, options) {
+    const { settings: path } = paths;
+    const target = followLink(path);
+    if (!existsSync(path)) {
+        try {
+            mkdirSync(dirname(target), { recursive: true, mode: 0o700 });
+            // A new file has no earlier state, so a backup left by a past install must not be restored into it.
+            rmSync(backupPathFor(paths, target), { force: true });
+            atomicWrite(target, withOurs(scan(""), inputs));
+        }
+        catch (err) {
+            return { kind: "failed", path, reason: describeFsError(err) };
+        }
+        return { kind: "created", path };
+    }
+    const result = load(path);
+    if ("problem" in result)
+        return { ...result.problem, path };
+    const { realPath, scanned } = result.loaded;
+    const { changed, conflicts } = differences(scanned, inputs);
+    // Same rule as Claude Code: any value that would change needs --yes, ours or not.
+    if (conflicts.length > 0 && !options.force)
+        return { kind: "conflict", path, conflicts };
+    if (changed.length === 0)
+        return { kind: "unchanged", path };
+    const next = withOurs(scanned, inputs);
+    const broken = checkWritten(next);
+    if (broken !== undefined)
+        return { kind: "malformed", path, reason: broken };
+    const backupPath = backupPathFor(paths, realPath);
+    try {
+        // The backup holds the last state that was not ours, so a re-run never buries it.
+        if (!isOurs(scanned)) {
+            copyFileSync(realPath, backupPath);
+            chmodSync(backupPath, 0o600);
+        }
+        atomicWrite(realPath, next);
+    }
+    catch (err) {
+        return { kind: "failed", path, reason: describeFsError(err) };
+    }
+    return { kind: "updated", path, backup: backupPath, changed };
+}
+/** The file without our part: our tables removed, and the root line put back as it was before us. */
+function withoutOurs(scanned, before) {
+    const removed = [];
+    const restored = [];
+    let lines = [...scanned.lines];
+    /* The backup holds the last state that was not ours. A table it has — a block the
+     * developer pasted by hand before `--yes` replaced it — goes back as it was, line for
+     * line; a table it lacks is one we added, so it goes. */
+    const previousLines = (name) => {
+        const region = before?.[name];
+        if (before === undefined || region === undefined)
+            return undefined;
+        let end = region.end;
+        while (end > region.start + 1 && /^\s*(#.*)?$/.test(before.lines[end - 1].text))
+            end -= 1;
+        return before.lines.slice(region.start, end);
+    };
+    const ours = ["provider", "headers"]
+        .filter((name) => scanned[name] !== undefined)
+        .sort((a, b) => scanned[b].start - scanned[a].start);
+    for (const name of ours) {
+        const region = scanned[name];
+        const table = name === "headers" ? HEADERS_TABLE : PROVIDER_TABLE;
+        const previous = previousLines(name);
+        let { start, end } = region;
+        while (end > start + 1 && /^\s*(#.*)?$/.test(lines[end - 1].text))
+            end -= 1;
+        if (previous !== undefined) {
+            lines = [...lines.slice(0, start), ...previous, ...lines.slice(end)];
+            restored.push(table);
+            continue;
+        }
+        // Take our marker lines with us when they sit right around the tables.
+        end = region.end;
+        while (end < lines.length && lines[end].text === MARKER_END)
+            end += 1;
+        while (start > 0 && lines[start - 1].text.startsWith(MARKER_BEGIN))
+            start -= 1;
+        lines = removeRange(lines, start, end);
+        removed.push(table);
+    }
+    // A marker left behind by a hand edit between them.
+    lines = lines.filter((l) => !l.text.startsWith(MARKER_BEGIN) && l.text !== MARKER_END);
+    if (scanned.rootModelProvider !== undefined) {
+        const previous = before === undefined ? undefined : before.rootModelProvider;
+        const index = scanned.rootModelProvider;
+        // Put back whatever the backup had, even our own id: a block pasted by hand needs its root line too.
+        if (previous !== undefined) {
+            lines[index] = { ...before.lines[previous], eol: lines[index].eol };
+            restored.push("model_provider");
+        }
+        else {
+            lines = [...lines.slice(0, index), ...lines.slice(index + 1)];
+            removed.push("model_provider");
+        }
+    }
+    // Leading blank lines we left by removing the root line.
+    while (lines.length > 0 && lines[0].text.trim() === "" && (scanned.lines[0]?.text.trim() ?? "") !== "")
+        lines.shift();
+    return { text: joinLines(lines), removed, restored };
+}
+export function revertCodexConfig(paths, options) {
+    const { settings: path } = paths;
+    if (!existsSync(followLink(path)))
+        return { kind: "not-configured", path };
+    const result = load(path);
+    if ("problem" in result)
+        return { ...result.problem, path };
+    const { realPath, raw, scanned } = result.loaded;
+    if (!isOurs(scanned))
+        return { kind: "not-configured", path };
+    if (options.agentIdGuard !== undefined) {
+        const stored = storedAgentId(scanned);
+        if (stored !== options.agentIdGuard) {
+            return { kind: "agent-mismatch", path, expected: options.agentIdGuard, actual: stored ?? "none" };
+        }
+    }
+    const backup = backupPathFor(paths, realPath);
+    let backupRaw;
+    let backupUnreadable = false;
+    if (existsSync(backup)) {
+        try {
+            backupRaw = readFileSync(backup, "utf8");
+        }
+        catch {
+            backupUnreadable = true;
+        }
+    }
+    if (options.fromBackup) {
+        if (backupRaw === undefined)
+            return backupUnreadable
+                ? { kind: "failed", path, reason: "the backup could not be read" }
+                : { kind: "no-backup", path, backup };
+        if (!options.force && withoutOurs(scanned, undefined).text !== withoutOurs(scan(backupRaw), undefined).text) {
+            return { kind: "drifted", path, backup };
+        }
+        try {
+            // Byte for byte: "verbatim" includes the developer's formatting and comments.
+            copyFileSync(backup, realPath);
+        }
+        catch (err) {
+            return { kind: "failed", path, reason: describeFsError(err) };
+        }
+        return { kind: "restored", path, backup };
+    }
+    const before = backupRaw === undefined ? undefined : scan(backupRaw);
+    const { text, removed, restored } = withoutOurs(scanned, before);
+    if (text === raw)
+        return { kind: "not-configured", path };
+    try {
+        atomicWrite(realPath, text);
+    }
+    catch (err) {
+        return { kind: "failed", path, reason: describeFsError(err) };
+    }
+    return { kind: "reverted", path, removed, restored, backupUnreadable };
+}
+//# sourceMappingURL=config.js.map

package/dist/agents/codex/config.js.map

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

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

@@ -0,0 +1,2 @@
+import type { CodingAgent } from "../types.js";
+export declare const codex: CodingAgent;

package/dist/agents/codex/index.js

@@ -0,0 +1,79 @@
+/**
+ * Codex: a provider block in `~/.codex/config.toml`, checked with `codex login status`,
+ * verified with `codex exec`. User-level only: Codex ignores `model_provider` and
+ * `model_providers` in a project's `.codex/config.toml`.
+ */
+import { findOnPath } from "../../process.js";
+import { codexHome, resolveCodexPaths, revertCodexConfig, writeCodexConfig } from "./config.js";
+import { codexPlacementExample, codexTables, ROOT_LINE } from "./snippets.js";
+import { CODEX_COMMAND, checkCodexLogin } from "./status.js";
+import { verifyCodex } from "./verify.js";
+const text = {
+    noSubscriptionOutcome: "no-codex-login",
+    noSubscription: {
+        "logged-out": {
+            headline: "No ChatGPT login detected for Codex.",
+            nextStep: "Run `codex login` and sign in with ChatGPT, then re-run this command.",
+            jsonReason: "no_chatgpt_login",
+            telemetryReason: "agent not logged in",
+        },
+        "api-key-login": {
+            headline: "Codex is signed in with an API key, not a ChatGPT login.",
+            nextStep: "The gateway forwards your ChatGPT login. Run `codex logout`, then `codex login` with ChatGPT, then re-run this command.",
+            jsonReason: "chatgpt_login_required",
+            telemetryReason: "agent logged in with an api key",
+        },
+    },
+    verifiedVia: { "codex-exec": "`codex exec`" },
+    skippedBecause: "the Codex CLI was not found to verify with",
+    notInstalled: {
+        message: "The Codex CLI was not found. Install it, sign in with `codex login`, then re-run this command.",
+        jsonOutcome: "no-codex-cli",
+        jsonReason: "codex_cli_not_installed",
+        telemetryReason: "agent cli not installed",
+    },
+    checkingLogin: "Checking your Codex login…",
+    loginFound: "Codex login found",
+};
+export const codex = {
+    id: "codex",
+    kind: "codex",
+    displayName: "Codex",
+    configLabel: "config.toml",
+    targets: ["user"],
+    verifyFlags: [],
+    checkInstalled(_ctx, deps) {
+        // No stand-in: only the Codex CLI can send the ChatGPT login the gateway forwards.
+        return findOnPath(CODEX_COMMAND, deps.lookup) === undefined ? { kind: "missing" } : { kind: "present" };
+    },
+    resolvePaths(_target, env) {
+        return { ...resolveCodexPaths(codexHome(env)), verifyCwd: env.home };
+    },
+    preview(inputs) {
+        return {
+            text: codexPlacementExample(inputs),
+            json: { config: [ROOT_LINE, "", ...codexTables(inputs)].join("\n") },
+        };
+    },
+    write: writeCodexConfig,
+    revert: revertCodexConfig,
+    // The writer already masks the key in each conflict (see `want` in config.ts); a
+    // conflict value here is one key's value, with no header syntax left to match on.
+    redact: (value) => value,
+    warnings(_paths, processEnv) {
+        const found = [];
+        if (processEnv.OPENAI_BASE_URL !== undefined && processEnv.OPENAI_BASE_URL !== "") {
+            found.push({
+                code: "openai-base-url-set",
+                message: "OPENAI_BASE_URL is set in your environment. Codex has deprecated it, and it can send requests past the gateway — unset it if they do not show up.",
+            });
+        }
+        return found;
+    },
+    checkSubscription(paths, deps) {
+        return checkCodexLogin(paths.verifyCwd, deps);
+    },
+    verify: verifyCodex,
+    text,
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/agents/codex/snippets.d.ts

@@ -0,0 +1,23 @@
+/**
+ * What `install --client codex` writes into `~/.codex/config.toml`, built to match the
+ * webapp snippet byte for byte (AI21Labs/ai21-intelligent-gateway-webapp,
+ * `src/pages/docs/integrations.tsx:codexPlacementExample`). `test/fixtures` pins the
+ * two together; re-capture it when the webapp's snippet changes.
+ *
+ * Two parts, because they go to different places: the root `model_provider` line must
+ * sit above every `[table]` (TOML would otherwise read it as a key of the table before
+ * it), while the provider tables can go anywhere.
+ *
+ * One deliberate divergence, as for Claude Code: the webapp always emits
+ * `x-ai21-user-id`, having a signed-in user; here that line is absent unless
+ * `--user-id` supplies one. `x-ai21-client` is added on what the CLI writes only.
+ */
+import { type SnippetInputs } from "../types.js";
+/** The root key that selects our provider. */
+export declare const ROOT_LINE: string;
+/** The header lines in contract order, as `[key, value]`. */
+export declare function codexHeaders({ agentId, ai21Key, userId, client }: SnippetInputs): [string, string][];
+/** The two provider tables, as lines. */
+export declare function codexTables(inputs: SnippetInputs): string[];
+/** The webapp's paste-in example, comments included. Also what `--print` shows. */
+export declare function codexPlacementExample(inputs: SnippetInputs): string;

package/dist/agents/codex/snippets.js

@@ -0,0 +1,39 @@
+import { HEADERS_TABLE, PROVIDER_ID, PROVIDER_TABLE, tomlKey, tomlString } from "./toml.js";
+/** The root key that selects our provider. */
+export const ROOT_LINE = `model_provider = ${tomlString(PROVIDER_ID)}`;
+/** The header lines in contract order, as `[key, value]`. */
+export function codexHeaders({ agentId, ai21Key, userId, client }) {
+    const headers = [
+        ["x-upstream", "openai-codex"],
+        ["x-ai21-key", ai21Key],
+        ["x-agent-id", agentId],
+    ];
+    if (userId !== undefined)
+        headers.push(["x-ai21-user-id", userId]);
+    if (client !== undefined)
+        headers.push(["x-ai21-client", client]);
+    return headers;
+}
+/** The two provider tables, as lines. */
+export function codexTables(inputs) {
+    return [
+        `[${PROVIDER_TABLE}]`,
+        `name = ${tomlString("AI21 Gateway")}`,
+        `base_url = ${tomlString(`${inputs.gatewayUrl}/v1`)}`,
+        `wire_api = "responses"`,
+        `requires_openai_auth = true`,
+        `[${HEADERS_TABLE}]`,
+        ...codexHeaders(inputs).map(([key, value]) => `${tomlKey(key)} = ${tomlString(value)}`),
+    ];
+}
+/** The webapp's paste-in example, comments included. Also what `--print` shows. */
+export function codexPlacementExample(inputs) {
+    return [
+        "# Adds to your existing ~/.codex/config.toml — nothing else changes.",
+        "# Keep model_provider above every [section]: it is a root key.",
+        ROOT_LINE,
+        "",
+        ...codexTables(inputs),
+    ].join("\n");
+}
+//# sourceMappingURL=snippets.js.map

package/dist/agents/codex/snippets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets.js","sourceRoot":"","sources":["../../../src/agents/codex/snippets.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5F,8CAA8C;AAC9C,MAAM,CAAC,MAAM,SAAS,GAAG,oBAAoB,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;AAEvE,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAiB;IAC9E,MAAM,OAAO,GAAuB;QAClC,CAAC,YAAY,EAAE,cAAc,CAAC;QAC9B,CAAC,YAAY,EAAE,OAAO,CAAC;QACvB,CAAC,YAAY,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;IAEnE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;IAElE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC/C,OAAO;QACL,IAAI,cAAc,GAAG;QACrB,UAAU,UAAU,CAAC,cAAc,CAAC,EAAE;QACtC,cAAc,UAAU,CAAC,GAAG,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE;QACrD,wBAAwB;QACxB,6BAA6B;QAC7B,IAAI,aAAa,GAAG;QACpB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;KACxF,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IACzD,OAAO;QACL,sEAAsE;QACtE,gEAAgE;QAChE,SAAS;QACT,EAAE;QACF,GAAG,WAAW,CAAC,MAAM,CAAC;KACvB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/agents/codex/status.d.ts

@@ -0,0 +1,8 @@
+import type { AgentDeps, SubscriptionStatus } from "../types.js";
+export declare const CODEX_COMMAND = "codex";
+/**
+ * Runs `codex login status` and reads stderr. Only "Logged in using ChatGPT" counts
+ * as present; "Logged in using an API key" or "Not logged in" count as missing.
+ * An unrecognisable output, a missing binary or a timeout are all inconclusive.
+ */
+export declare function checkCodexLogin(cwd: string, deps: AgentDeps): Promise<SubscriptionStatus>;

package/dist/agents/codex/status.js

@@ -0,0 +1,36 @@
+/**
+ * Codex login check with `codex login status`.
+ */
+import { findOnPath } from "../../process.js";
+export const CODEX_COMMAND = "codex";
+const STATUS_TIMEOUT_MS = 5_000;
+/**
+ * Runs `codex login status` and reads stderr. Only "Logged in using ChatGPT" counts
+ * as present; "Logged in using an API key" or "Not logged in" count as missing.
+ * An unrecognisable output, a missing binary or a timeout are all inconclusive.
+ */
+export async function checkCodexLogin(cwd, deps) {
+    const executable = findOnPath(CODEX_COMMAND, deps.lookup);
+    if (executable === undefined)
+        return { kind: "inconclusive" };
+    const result = await deps.runCommand(executable, ["login", "status"], { cwd, timeoutMs: STATUS_TIMEOUT_MS });
+    if (result.timedOut || result.code === null)
+        return { kind: "inconclusive" };
+    // A broken config or missing CODEX_HOME makes the CLI exit 1 and print an error.
+    // That is not "definitely signed out"; it is "could not tell".
+    if (result.code === 1 && !/^(Not logged in|Logged in using an API key)/.test(result.output.trim())) {
+        return { kind: "inconclusive" };
+    }
+    if (result.code === 0 && /^Logged in using ChatGPT/.test(result.output.trim())) {
+        return { kind: "present" };
+    }
+    // "Logged in using an API key" without ChatGPT → not usable through the gateway.
+    if (result.code === 0 && /^Logged in using an API key/.test(result.output.trim())) {
+        return { kind: "missing", reason: "api-key-login" };
+    }
+    if (result.output.trim() === "Not logged in") {
+        return { kind: "missing", reason: "logged-out" };
+    }
+    return { kind: "inconclusive" };
+}
+//# sourceMappingURL=status.js.map

package/dist/agents/codex/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/agents/codex/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,IAAe;IAChE,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC7G,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAE7E,iFAAiF;IACjF,+DAA+D;IAC/D,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACnG,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;IAED,iFAAiF;IACjF,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAClF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,eAAe,EAAE,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACnD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;AAClC,CAAC"}

package/dist/agents/codex/toml.d.ts

@@ -0,0 +1,57 @@
+/**
+ * A targeted edit of `~/.codex/config.toml`: find the few things this tool owns, and
+ * replace or remove exactly those lines. Everything else — comments, ordering, blank
+ * lines, CRLF endings, tables we have never heard of — is carried through byte for byte.
+ *
+ * Not a TOML parser. It reads lines, and understands only what it must to stay safe:
+ * where a table starts, which root key a line assigns, and whether a line is inside a
+ * multi-line string (where a `[` is text, not a header). Anything it owns but cannot
+ * edit safely — our provider as dotted keys or an inline table — is reported as
+ * `unsupported`, and the caller refuses rather than guess.
+ */
+/** The provider id this tool writes. The webapp snippet uses the same one. */
+export declare const PROVIDER_ID = "ai21";
+/** The tables we own, in the order we write them. */
+export declare const PROVIDER_TABLE = "model_providers.ai21";
+export declare const HEADERS_TABLE = "model_providers.ai21.http_headers";
+export interface Line {
+    /** Without its line ending. */
+    readonly text: string;
+    /** "\n", "\r\n", or "" for a last line with no newline. */
+    readonly eol: string;
+}
+export declare function splitLines(raw: string): Line[];
+export declare function joinLines(lines: readonly Line[]): string;
+/** The file's own newline, so lines we add match the ones around them. */
+export declare function newlineOf(lines: readonly Line[]): string;
+export interface Region {
+    /** Index of the header line. */
+    readonly start: number;
+    /** One past the last line that belongs to the table (its header and its keys). */
+    readonly end: number;
+}
+export interface Scan {
+    readonly lines: Line[];
+    /** The root `model_provider = …` line, if any. */
+    readonly rootModelProvider?: number | undefined;
+    /** Index of the first table header; root keys live before it. */
+    readonly firstHeader: number;
+    readonly provider?: Region | undefined;
+    readonly headers?: Region | undefined;
+    /** Why we refuse to edit, when our provider is present in a form we do not handle. */
+    readonly unsupported?: string | undefined;
+}
+export declare function scan(raw: string): Scan;
+/** A basic-string value's contents, or undefined when the line holds anything else. */
+export declare function stringValue(text: string): string | undefined;
+/** The `key = value` lines of a region, keyed by their normalised key. */
+export declare function entries(scanned: Scan, region: Region | undefined): Map<string, string>;
+/** Escapes a value for a TOML basic string. Control characters never reach here: args refuses them. */
+export declare function tomlString(value: string): string;
+/**
+ * Header keys need quoting in TOML only if they are not bare keys. Ours are all bare
+ * (`x-ai21-key`), but the rule is written down once rather than assumed at each site.
+ */
+export declare function tomlKey(key: string): string;
+/** Drops the lines at `[start, end)` and any blank lines left directly above them. */
+export declare function removeRange(lines: Line[], start: number, end: number): Line[];