@mostok/codexes 0.1.0

package/dist/commands/root/run-root-command.js

@@ -0,0 +1,175 @@
+import { createLogger } from "../../logging/logger.js";
+import { createAccountRegistry } from "../../accounts/account-registry.js";
+import { createRuntimeContract, summarizeRuntimeContract, } from "../../runtime/runtime-contract.js";
+import { runAccountAddCommand } from "../account-add/run-account-add-command.js";
+import { runAccountListCommand } from "../account-list/run-account-list-command.js";
+import { runAccountRemoveCommand } from "../account-remove/run-account-remove-command.js";
+import { runAccountUseCommand } from "../account-use/run-account-use-command.js";
+import { acquireRuntimeLock } from "../../runtime/lock/runtime-lock.js";
+import { activateAccountIntoSharedRuntime, restoreSharedRuntimeFromBackup, syncSharedRuntimeBackToAccount, } from "../../runtime/activate-account/activate-account.js";
+import { spawnCodexCommand } from "../../process/spawn-codex-command.js";
+import { selectAccountForExecution } from "../../selection/select-account.js";
+export async function runRootCommand(context) {
+    const logger = createLogger({
+        level: context.logging.level,
+        name: "root",
+        sink: context.logging.sink,
+    });
+    logger.debug("argv.received", { argv: context.argv });
+    logger.debug("runtime.detected", {
+        sharedCodexHome: context.paths.sharedCodexHome,
+        accountRoot: context.paths.accountRoot,
+        runtimeRoot: context.paths.runtimeRoot,
+        registryFile: context.paths.registryFile,
+        wrapperConfigFile: context.paths.wrapperConfigFile,
+        selectionCacheFile: context.paths.selectionCacheFile,
+        firstRun: context.runtimeInitialization.firstRun,
+        copiedSharedArtifacts: context.runtimeInitialization.copiedSharedArtifacts,
+        createdRuntimeFiles: context.runtimeInitialization.createdFiles,
+        credentialStoreMode: context.wrapperConfig.credentialStoreMode,
+        accountSelectionStrategy: context.wrapperConfig.accountSelectionStrategy,
+        experimentalSelection: context.wrapperConfig.experimentalSelection,
+        codexBinaryPath: context.codexBinary.path,
+        recursionGuardSource: context.executablePath,
+    });
+    const runtimeContract = createRuntimeContract({
+        accountRoot: context.paths.accountRoot,
+        credentialStoreMode: context.wrapperConfig.credentialStoreMode,
+        logger,
+        runtimeRoot: context.paths.runtimeRoot,
+        sharedCodexHome: context.paths.sharedCodexHome,
+    });
+    const runtimeSummary = summarizeRuntimeContract(runtimeContract);
+    logger.debug("runtime.contract_ready", runtimeSummary);
+    if (context.wrapperConfig.credentialStoreMode !== "file") {
+        logger.warn("credential_store.unsupported", {
+            credentialStoreMode: context.wrapperConfig.credentialStoreMode,
+            codexConfigFile: context.paths.codexConfigFile,
+            reason: context.wrapperConfig.credentialStorePolicyReason,
+        });
+    }
+    if (context.argv[0] === "account" && context.argv[1] === "add") {
+        logger.info("command.dispatch", {
+            command: "account add",
+            argv: context.argv.slice(2),
+        });
+        return runAccountAddCommand(context, context.argv.slice(2));
+    }
+    if (context.argv[0] === "account" && context.argv[1] === "list") {
+        logger.info("command.dispatch", {
+            command: "account list",
+            argv: context.argv.slice(2),
+        });
+        return runAccountListCommand(context);
+    }
+    if (context.argv[0] === "account" && context.argv[1] === "remove") {
+        logger.info("command.dispatch", {
+            command: "account remove",
+            argv: context.argv.slice(2),
+        });
+        return runAccountRemoveCommand(context, context.argv.slice(2));
+    }
+    if (context.argv[0] === "account" && context.argv[1] === "use") {
+        logger.info("command.dispatch", {
+            command: "account use",
+            argv: context.argv.slice(2),
+        });
+        return runAccountUseCommand(context, context.argv.slice(2));
+    }
+    if (context.argv.includes("--help")) {
+        context.io.stdout.write(`${buildHelpText()}\n`);
+        logger.info("help.rendered");
+        return 0;
+    }
+    if (!context.codexBinary.path) {
+        logger.error("command.binary_missing", {
+            candidates: context.codexBinary.candidates,
+            rejectedCandidates: context.codexBinary.rejectedCandidates,
+        });
+        throw new Error("Could not find the real `codex` binary on PATH.");
+    }
+    const registry = createAccountRegistry({
+        accountRoot: context.paths.accountRoot,
+        logger,
+        registryFile: context.paths.registryFile,
+    });
+    if (context.wrapperConfig.accountSelectionStrategy === "remaining-limit-experimental") {
+        logger.warn("selection.experimental_enabled", {
+            endpoint: "https://chatgpt.com/backend-api/wham/usage",
+            fallbackStrategy: "manual-default",
+            timeoutMs: context.wrapperConfig.experimentalSelection.probeTimeoutMs,
+            cacheTtlMs: context.wrapperConfig.experimentalSelection.cacheTtlMs,
+            useAccountIdHeader: context.wrapperConfig.experimentalSelection.useAccountIdHeader,
+        });
+    }
+    const activeAccount = await selectAccountForExecution({
+        experimentalSelection: context.wrapperConfig.experimentalSelection,
+        fetchImpl: fetch,
+        logger,
+        registry,
+        selectionCacheFilePath: context.paths.selectionCacheFile,
+        strategy: context.wrapperConfig.accountSelectionStrategy,
+    });
+    const lock = await acquireRuntimeLock({
+        logger,
+        runtimeRoot: context.paths.runtimeRoot,
+    });
+    try {
+        const activation = await activateAccountIntoSharedRuntime({
+            account: activeAccount,
+            logger,
+            runtimeContract,
+            sharedCodexHome: context.paths.sharedCodexHome,
+        });
+        try {
+            const exitCode = await spawnCodexCommand({
+                argv: context.argv,
+                codexBinaryPath: context.codexBinary.path,
+                codexHome: context.paths.sharedCodexHome,
+                logger,
+            });
+            await syncSharedRuntimeBackToAccount({
+                logger,
+                session: activation,
+            });
+            return exitCode;
+        }
+        catch (error) {
+            await restoreSharedRuntimeFromBackup({
+                account: activeAccount,
+                backupRoot: activation.backupRoot,
+                logger,
+                runtimeContract,
+                sharedCodexHome: context.paths.sharedCodexHome,
+            });
+            throw error;
+        }
+    }
+    finally {
+        await lock.release();
+    }
+}
+function buildHelpText() {
+    return [
+        "codexes",
+        "",
+        "Transparent multi-account wrapper around the Codex CLI.",
+        "",
+        "Usage:",
+        "  codexes [args...]",
+        "  codexes account add <label> [--timeout-ms <milliseconds>]",
+        "  codexes account list",
+        "  codexes account use <account-id-or-label>",
+        "  codexes account remove <account-id-or-label>",
+        "",
+        "Runtime model:",
+        "  Shared CODEX_HOME is preserved in a wrapper-owned runtime root.",
+        "  Account auth state is stored per account and synced back selectively.",
+        "",
+        "Current status:",
+        "  Account management and default Codex passthrough are implemented.",
+        "  Selection strategies: manual-default, single-account, remaining-limit-experimental.",
+        "  Experimental mode probes https://chatgpt.com/backend-api/wham/usage and falls back to manual-default when ranking is unreliable.",
+    ].join("\n");
+}
+//# sourceMappingURL=run-root-command.js.map

package/dist/commands/root/run-root-command.js.map

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

package/dist/config/wrapper-config.d.ts

@@ -0,0 +1,24 @@
+import type { Logger } from "../logging/logger.js";
+import type { ResolvedPaths } from "../core/paths.js";
+export type CredentialStoreMode = "file" | "keyring" | "auto" | "missing" | "unknown";
+export type AccountSelectionStrategy = "manual-default" | "single-account" | "remaining-limit-experimental";
+export interface WrapperConfig {
+    configFilePath: string;
+    codexConfigFilePath: string;
+    selectionCacheFilePath: string;
+    credentialStoreMode: CredentialStoreMode;
+    credentialStorePolicyReason: string;
+    accountSelectionStrategy: AccountSelectionStrategy;
+    experimentalSelection: ExperimentalSelectionConfig;
+}
+export interface ExperimentalSelectionConfig {
+    enabled: boolean;
+    probeTimeoutMs: number;
+    cacheTtlMs: number;
+    useAccountIdHeader: boolean;
+}
+export declare function resolveWrapperConfig(input: {
+    env: NodeJS.ProcessEnv;
+    logger: Logger;
+    paths: ResolvedPaths;
+}): Promise<WrapperConfig>;

package/dist/config/wrapper-config.js

@@ -0,0 +1,145 @@
+import { mkdir, readFile } from "node:fs/promises";
+const DEFAULT_EXPERIMENTAL_PROBE_TIMEOUT_MS = 3_500;
+const DEFAULT_EXPERIMENTAL_CACHE_TTL_MS = 60_000;
+export async function resolveWrapperConfig(input) {
+    await mkdir(input.paths.dataRoot, { recursive: true });
+    const credentialStoreMode = await detectCredentialStoreMode(input.paths.codexConfigFile, input.logger);
+    const resolved = {
+        configFilePath: input.paths.wrapperConfigFile,
+        codexConfigFilePath: input.paths.codexConfigFile,
+        selectionCacheFilePath: input.paths.selectionCacheFile,
+        credentialStoreMode,
+        credentialStorePolicyReason: credentialStoreMode === "file"
+            ? "file mode detected in Codex config"
+            : "codexes currently supports only file-backed auth storage",
+        accountSelectionStrategy: resolveAccountSelectionStrategy(input.env),
+        experimentalSelection: resolveExperimentalSelectionConfig(input.env, input.logger),
+    };
+    input.logger.info("wrapper_config.resolved", {
+        configFilePath: resolved.configFilePath,
+        codexConfigFilePath: resolved.codexConfigFilePath,
+        selectionCacheFilePath: resolved.selectionCacheFilePath,
+        credentialStoreMode: resolved.credentialStoreMode,
+        accountSelectionStrategy: resolved.accountSelectionStrategy,
+        experimentalSelection: resolved.experimentalSelection,
+    });
+    return resolved;
+}
+function resolveExperimentalSelectionConfig(env, logger) {
+    const probeTimeoutMs = resolvePositiveIntegerEnv({
+        defaultValue: DEFAULT_EXPERIMENTAL_PROBE_TIMEOUT_MS,
+        env,
+        envKey: "CODEXES_EXPERIMENTAL_SELECTION_TIMEOUT_MS",
+        logger,
+    });
+    const cacheTtlMs = resolvePositiveIntegerEnv({
+        defaultValue: DEFAULT_EXPERIMENTAL_CACHE_TTL_MS,
+        env,
+        envKey: "CODEXES_EXPERIMENTAL_SELECTION_CACHE_TTL_MS",
+        logger,
+    });
+    const useAccountIdHeader = resolveBooleanEnv(env.CODEXES_EXPERIMENTAL_SELECTION_USE_ACCOUNT_ID_HEADER);
+    const enabled = resolveAccountSelectionStrategy(env) === "remaining-limit-experimental";
+    logger.debug("wrapper_config.experimental_selection_resolved", {
+        enabled,
+        probeTimeoutMs,
+        cacheTtlMs,
+        useAccountIdHeader,
+    });
+    return {
+        enabled,
+        probeTimeoutMs,
+        cacheTtlMs,
+        useAccountIdHeader,
+    };
+}
+function resolveAccountSelectionStrategy(env) {
+    switch (env.CODEXES_ACCOUNT_SELECTION_STRATEGY?.trim().toLowerCase()) {
+        case "single-account":
+            return "single-account";
+        case "remaining-limit-experimental":
+            return "remaining-limit-experimental";
+        case "manual-default":
+        case undefined:
+        case "":
+            return "manual-default";
+        default:
+            return "manual-default";
+    }
+}
+async function detectCredentialStoreMode(configFile, logger) {
+    try {
+        const rawConfig = await readFile(configFile, "utf8");
+        const mode = parseCredentialStoreMode(rawConfig);
+        logger.debug("credential_store.detected", {
+            configFile,
+            credentialStoreMode: mode,
+        });
+        return mode;
+    }
+    catch (error) {
+        if (typeof error === "object" &&
+            error !== null &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            logger.warn("credential_store.config_missing", {
+                configFile,
+                fallbackMode: "missing",
+            });
+            return "missing";
+        }
+        logger.error("credential_store.read_failed", {
+            configFile,
+            message: error instanceof Error ? error.message : String(error),
+        });
+        return "unknown";
+    }
+}
+function parseCredentialStoreMode(rawConfig) {
+    const match = rawConfig.match(/^\s*cli_auth_credentials_store\s*=\s*"([^"]+)"/m);
+    if (!match) {
+        return "missing";
+    }
+    const configuredValue = match[1];
+    if (!configuredValue) {
+        return "unknown";
+    }
+    switch (configuredValue.trim().toLowerCase()) {
+        case "file":
+            return "file";
+        case "keyring":
+            return "keyring";
+        case "auto":
+            return "auto";
+        default:
+            return "unknown";
+    }
+}
+function resolvePositiveIntegerEnv(input) {
+    const raw = input.env[input.envKey]?.trim();
+    if (!raw) {
+        return input.defaultValue;
+    }
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        input.logger.warn("wrapper_config.invalid_env_override", {
+            envKey: input.envKey,
+            rawValue: raw,
+            fallbackValue: input.defaultValue,
+        });
+        return input.defaultValue;
+    }
+    return parsed;
+}
+function resolveBooleanEnv(value) {
+    switch (value?.trim().toLowerCase()) {
+        case "1":
+        case "true":
+        case "yes":
+        case "on":
+            return true;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=wrapper-config.js.map

package/dist/config/wrapper-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper-config.js","sourceRoot":"","sources":["../../src/config/wrapper-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA2BnD,MAAM,qCAAqC,GAAG,KAAK,CAAC;AACpD,MAAM,iCAAiC,GAAG,MAAM,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAI1C;IACC,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvD,MAAM,mBAAmB,GAAG,MAAM,yBAAyB,CACzD,KAAK,CAAC,KAAK,CAAC,eAAe,EAC3B,KAAK,CAAC,MAAM,CACb,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,iBAAiB;QAC7C,mBAAmB,EAAE,KAAK,CAAC,KAAK,CAAC,eAAe;QAChD,sBAAsB,EAAE,KAAK,CAAC,KAAK,CAAC,kBAAkB;QACtD,mBAAmB;QACnB,2BAA2B,EACzB,mBAAmB,KAAK,MAAM;YAC5B,CAAC,CAAC,oCAAoC;YACtC,CAAC,CAAC,0DAA0D;QAChE,wBAAwB,EAAE,+BAA+B,CAAC,KAAK,CAAC,GAAG,CAAC;QACpE,qBAAqB,EAAE,kCAAkC,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;KAC3D,CAAC;IAE1B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE;QAC3C,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;QACjD,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;QACvD,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;QACjD,wBAAwB,EAAE,QAAQ,CAAC,wBAAwB;QAC3D,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB;KACtD,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kCAAkC,CACzC,GAAsB,EACtB,MAAc;IAEd,MAAM,cAAc,GAAG,yBAAyB,CAAC;QAC/C,YAAY,EAAE,qCAAqC;QACnD,GAAG;QACH,MAAM,EAAE,2CAA2C;QACnD,MAAM;KACP,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,yBAAyB,CAAC;QAC3C,YAAY,EAAE,iCAAiC;QAC/C,GAAG;QACH,MAAM,EAAE,6CAA6C;QACrD,MAAM;KACP,CAAC,CAAC;IACH,MAAM,kBAAkB,GAAG,iBAAiB,CAC1C,GAAG,CAAC,oDAAoD,CACzD,CAAC;IACF,MAAM,OAAO,GACX,+BAA+B,CAAC,GAAG,CAAC,KAAK,8BAA8B,CAAC;IAE1E,MAAM,CAAC,KAAK,CAAC,gDAAgD,EAAE;QAC7D,OAAO;QACP,cAAc;QACd,UAAU;QACV,kBAAkB;KACnB,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;QACP,cAAc;QACd,UAAU;QACV,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,GAAsB;IAEtB,QAAQ,GAAG,CAAC,kCAAkC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACrE,KAAK,gBAAgB;YACnB,OAAO,gBAAgB,CAAC;QAC1B,KAAK,8BAA8B;YACjC,OAAO,8BAA8B,CAAC;QACxC,KAAK,gBAAgB,CAAC;QACtB,KAAK,SAAS,CAAC;QACf,KAAK,EAAE;YACL,OAAO,gBAAgB,CAAC;QAC1B;YACE,OAAO,gBAAgB,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,UAAkB,EAClB,MAAc;IAEd,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAEjD,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;YACxC,UAAU;YACV,mBAAmB,EAAE,IAAI;SAC1B,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,MAAM,IAAI,KAAK;YACf,KAAK,CAAC,IAAI,KAAK,QAAQ,EACvB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;gBAC7C,UAAU;gBACV,YAAY,EAAE,SAAS;aACxB,CAAC,CAAC;YACH,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;YAC3C,UAAU;YACV,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,SAAiB;IACjD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAEjF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEjC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,eAAe,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7C,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,KAKlC;IACC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,KAAK,CAAC,YAAY,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE;YACvD,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,GAAG;YACb,aAAa,EAAE,KAAK,CAAC,YAAY;SAClC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,YAAY,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAyB;IAClD,QAAQ,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACpC,KAAK,GAAG,CAAC;QACT,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,IAAI;YACP,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/core/bootstrap.d.ts

@@ -0,0 +1,8 @@
+export interface BootstrapIo {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    executablePath: string;
+    stdout: NodeJS.WriteStream;
+    stderr: NodeJS.WriteStream;
+}
+export declare function runCli(argv: string[], io: BootstrapIo): Promise<number>;

package/dist/core/bootstrap.js

@@ -0,0 +1,32 @@
+import { buildAppContext } from "./context.js";
+import { createLogger } from "../logging/logger.js";
+import { runRootCommand } from "../commands/root/run-root-command.js";
+export async function runCli(argv, io) {
+    const context = await buildAppContext(argv, io);
+    const logger = createLogger({
+        level: context.logging.level,
+        name: "bootstrap",
+        sink: context.logging.sink,
+    });
+    logger.debug("bootstrap.start", {
+        argv,
+        cwd: context.environment.cwd,
+        platform: context.environment.platform,
+        runtime: context.environment.runtime,
+    });
+    try {
+        const exitCode = await runRootCommand(context);
+        logger.debug("bootstrap.exit", { exitCode });
+        return exitCode;
+    }
+    catch (error) {
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        logger.error("bootstrap.fatal", {
+            message: normalized.message,
+            stack: normalized.stack,
+        });
+        context.io.stderr.write(`codexes: ${normalized.message}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/core/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/core/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAUtE,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc,EAAE,EAAe;IAC1D,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK;QAC5B,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;KAC3B,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;QAC9B,IAAI;QACJ,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG;QAC5B,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ;QACtC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO;KACrC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;QAE/C,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE7C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAE7E,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;YAC9B,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;QAE5D,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/core/context.d.ts

@@ -0,0 +1,33 @@
+import { createLogSink } from "../logging/logger.js";
+import { resolveWrapperConfig } from "../config/wrapper-config.js";
+import { resolvePaths } from "./paths.js";
+import { findCodexBinary } from "../process/find-codex-binary.js";
+import { initializeRuntimeEnvironment } from "../runtime/init/initialize-runtime.js";
+export interface AppContext {
+    argv: string[];
+    executablePath: string;
+    environment: {
+        cwd: string;
+        platform: NodeJS.Platform;
+        runtime: string;
+    };
+    io: {
+        stdout: NodeJS.WriteStream;
+        stderr: NodeJS.WriteStream;
+    };
+    logging: {
+        level: string;
+        sink: ReturnType<typeof createLogSink>;
+    };
+    paths: ReturnType<typeof resolvePaths>;
+    runtimeInitialization: Awaited<ReturnType<typeof initializeRuntimeEnvironment>>;
+    wrapperConfig: Awaited<ReturnType<typeof resolveWrapperConfig>>;
+    codexBinary: Awaited<ReturnType<typeof findCodexBinary>>;
+}
+export declare function buildAppContext(argv: string[], io: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    executablePath: string;
+    stdout: NodeJS.WriteStream;
+    stderr: NodeJS.WriteStream;
+}): Promise<AppContext>;

package/dist/core/context.js

@@ -0,0 +1,72 @@
+import { createLogSink, createLogger, resolveLogLevel } from "../logging/logger.js";
+import { resolveWrapperConfig } from "../config/wrapper-config.js";
+import { resolvePaths } from "./paths.js";
+import { findCodexBinary } from "../process/find-codex-binary.js";
+import { initializeRuntimeEnvironment } from "../runtime/init/initialize-runtime.js";
+export async function buildAppContext(argv, io) {
+    const logLevel = resolveLogLevel(io.env.LOG_LEVEL);
+    const sink = createLogSink(io.stderr);
+    const paths = resolvePaths(io.cwd, io.env);
+    const runtimeInitialization = await initializeRuntimeEnvironment({
+        env: io.env,
+        logger: createLogger({
+            level: logLevel,
+            name: "runtime",
+            sink,
+        }),
+        paths,
+    });
+    const wrapperConfig = await resolveWrapperConfig({
+        env: io.env,
+        logger: createLogger({
+            level: logLevel,
+            name: "config",
+            sink,
+        }),
+        paths,
+    });
+    const codexBinary = await findCodexBinary({
+        env: io.env,
+        logger: createLogger({
+            level: logLevel,
+            name: "process",
+            sink,
+        }),
+        wrapperExecutablePath: io.executablePath,
+    });
+    createLogger({
+        level: logLevel,
+        name: "context",
+        sink,
+    }).debug("initialized", {
+        argv,
+        cwd: io.cwd,
+        logLevel,
+        paths,
+        runtimeInitialization,
+        wrapperConfig,
+        codexBinary,
+    });
+    return {
+        argv,
+        executablePath: io.executablePath,
+        environment: {
+            cwd: io.cwd,
+            platform: process.platform,
+            runtime: process.version,
+        },
+        io: {
+            stdout: io.stdout,
+            stderr: io.stderr,
+        },
+        logging: {
+            level: logLevel,
+            sink,
+        },
+        paths,
+        runtimeInitialization,
+        wrapperConfig,
+        codexBinary,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAwBrF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAc,EACd,EAMC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,qBAAqB,GAAG,MAAM,4BAA4B,CAAC;QAC/D,GAAG,EAAE,EAAE,CAAC,GAAG;QACX,MAAM,EAAE,YAAY,CAAC;YACnB,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,SAAS;YACf,IAAI;SACL,CAAC;QACF,KAAK;KACN,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC;QAC/C,GAAG,EAAE,EAAE,CAAC,GAAG;QACX,MAAM,EAAE,YAAY,CAAC;YACnB,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,QAAQ;YACd,IAAI;SACL,CAAC;QACF,KAAK;KACN,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC;QACxC,GAAG,EAAE,EAAE,CAAC,GAAG;QACX,MAAM,EAAE,YAAY,CAAC;YACnB,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,SAAS;YACf,IAAI;SACL,CAAC;QACF,qBAAqB,EAAE,EAAE,CAAC,cAAc;KACzC,CAAC,CAAC;IAEH,YAAY,CAAC;QACX,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,SAAS;QACf,IAAI;KACL,CAAC,CAAC,KAAK,CAAC,aAAa,EAAE;QACtB,IAAI;QACJ,GAAG,EAAE,EAAE,CAAC,GAAG;QACX,QAAQ;QACR,KAAK;QACL,qBAAqB;QACrB,aAAa;QACb,WAAW;KACZ,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;QACJ,cAAc,EAAE,EAAE,CAAC,cAAc;QACjC,WAAW,EAAE;YACX,GAAG,EAAE,EAAE,CAAC,GAAG;YACX,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB;QACD,EAAE,EAAE;YACF,MAAM,EAAE,EAAE,CAAC,MAAM;YACjB,MAAM,EAAE,EAAE,CAAC,MAAM;SAClB;QACD,OAAO,EAAE;YACP,KAAK,EAAE,QAAQ;YACf,IAAI;SACL;QACD,KAAK;QACL,qBAAqB;QACrB,aAAa;QACb,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/core/paths.d.ts

@@ -0,0 +1,12 @@
+export interface ResolvedPaths {
+    projectRoot: string;
+    dataRoot: string;
+    sharedCodexHome: string;
+    accountRoot: string;
+    runtimeRoot: string;
+    registryFile: string;
+    wrapperConfigFile: string;
+    codexConfigFile: string;
+    selectionCacheFile: string;
+}
+export declare function resolvePaths(cwd: string, env: NodeJS.ProcessEnv): ResolvedPaths;

package/dist/core/paths.js

@@ -0,0 +1,30 @@
+import path from "node:path";
+import os from "node:os";
+export function resolvePaths(cwd, env) {
+    const baseDataDir = resolveBaseDataDir(env);
+    return {
+        projectRoot: cwd,
+        dataRoot: baseDataDir,
+        sharedCodexHome: env.CODEX_HOME ?? path.join(baseDataDir, "shared-home"),
+        accountRoot: path.join(baseDataDir, "accounts"),
+        runtimeRoot: path.join(baseDataDir, "runtime"),
+        registryFile: path.join(baseDataDir, "registry.json"),
+        wrapperConfigFile: path.join(baseDataDir, "codexes.json"),
+        codexConfigFile: path.join(env.CODEX_HOME ?? path.join(baseDataDir, "shared-home"), "config.toml"),
+        selectionCacheFile: path.join(baseDataDir, "selection-cache.json"),
+    };
+}
+function resolveBaseDataDir(env) {
+    if (process.platform === "win32") {
+        return path.join(env.LOCALAPPDATA ?? path.join(os.homedir(), "AppData", "Local"), "codexes");
+    }
+    if (process.platform === "darwin") {
+        return path.join(env.HOME ?? os.homedir(), "Library", "Application Support", "codexes");
+    }
+    const xdgStateHome = env.XDG_STATE_HOME;
+    if (xdgStateHome) {
+        return path.join(xdgStateHome, "codexes");
+    }
+    return path.join(env.HOME ?? os.homedir(), ".local", "state", "codexes");
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAczB,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,GAAsB;IAEtB,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAE5C,OAAO;QACL,WAAW,EAAE,GAAG;QAChB,QAAQ,EAAE,WAAW;QACrB,eAAe,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;QACxE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;QAC/C,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;QAC9C,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC;QACrD,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC;QACzD,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,aAAa,CAAC;QAClG,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,sBAAsB,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAsB;IAChD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,IAAI,CACd,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAC/D,SAAS,CACV,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,IAAI,CACd,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,EACxB,SAAS,EACT,qBAAqB,EACrB,SAAS,CACV,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,GAAG,CAAC,cAAc,CAAC;IAExC,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAC3E,CAAC"}

package/dist/logging/logger.d.ts

@@ -0,0 +1,18 @@
+type LogLevel = "DEBUG" | "INFO" | "WARN" | "ERROR";
+export interface LogSink {
+    write(level: LogLevel, event: string, details?: Record<string, unknown>): void;
+}
+export interface Logger {
+    debug(event: string, details?: Record<string, unknown>): void;
+    info(event: string, details?: Record<string, unknown>): void;
+    warn(event: string, details?: Record<string, unknown>): void;
+    error(event: string, details?: Record<string, unknown>): void;
+}
+export declare function resolveLogLevel(value: string | undefined): LogLevel;
+export declare function createLogSink(stream: Pick<NodeJS.WriteStream, "write">): LogSink;
+export declare function createLogger(input: {
+    level: string;
+    name: string;
+    sink: LogSink;
+}): Logger;
+export {};

package/dist/logging/logger.js

@@ -0,0 +1,56 @@
+const LOG_LEVEL_ORDER = {
+    DEBUG: 10,
+    INFO: 20,
+    WARN: 30,
+    ERROR: 40,
+};
+export function resolveLogLevel(value) {
+    switch (value?.toUpperCase()) {
+        case "ERROR":
+            return "ERROR";
+        case "WARN":
+            return "WARN";
+        case "INFO":
+            return "INFO";
+        case "DEBUG":
+            return "DEBUG";
+        default:
+            return "ERROR";
+    }
+}
+export function createLogSink(stream) {
+    return {
+        write(level, event, details = {}) {
+            stream.write(`${JSON.stringify({
+                ts: new Date().toISOString(),
+                level,
+                event,
+                details,
+            })}\n`);
+        },
+    };
+}
+export function createLogger(input) {
+    const configuredLevel = resolveLogLevel(input.level);
+    return {
+        debug(event, details) {
+            logWithLevel("DEBUG", input.name, configuredLevel, input.sink, event, details);
+        },
+        info(event, details) {
+            logWithLevel("INFO", input.name, configuredLevel, input.sink, event, details);
+        },
+        warn(event, details) {
+            logWithLevel("WARN", input.name, configuredLevel, input.sink, event, details);
+        },
+        error(event, details) {
+            logWithLevel("ERROR", input.name, configuredLevel, input.sink, event, details);
+        },
+    };
+}
+function logWithLevel(level, name, configuredLevel, sink, event, details) {
+    if (LOG_LEVEL_ORDER[level] < LOG_LEVEL_ORDER[configuredLevel]) {
+        return;
+    }
+    sink.write(level, `${name}.${event}`, details);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAA6B;IAChD,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAaF,MAAM,UAAU,eAAe,CAAC,KAAyB;IACvD,QAAQ,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC;QAC7B,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAAyC;IAEzC,OAAO;QACL,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,EAAE;YAC9B,MAAM,CAAC,KAAK,CACV,GAAG,IAAI,CAAC,SAAS,CAAC;gBAChB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,KAAK;gBACL,KAAK;gBACL,OAAO;aACR,CAAC,IAAI,CACP,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAI5B;IACC,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAErD,OAAO;QACL,KAAK,CAAC,KAAK,EAAE,OAAO;YAClB,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,OAAO;YACjB,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,OAAO;YACjB,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAChF,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,OAAO;YAClB,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,KAAe,EACf,IAAY,EACZ,eAAyB,EACzB,IAAa,EACb,KAAa,EACb,OAAiC;IAEjC,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}