@sireai/optimus 0.1.1

package/dist/problem-solving-core/codex/codex-failure-classifier.js

@@ -0,0 +1,49 @@
+// Failure classification normalizes raw Codex and provider error text into stable failure categories.
+// The runner, health-check flow, and scheduler diagnostics all depend on this shared mapping so failures are interpreted consistently.
+// This module is intentionally heuristic and string-based; it does not own retry policy or recovery behavior.
+// Failure classification is shared between health-check and task execution so scheduler diagnostics stay consistent.
+export function classifyCodexFailureCategory(message) {
+    const normalized = message.toLowerCase();
+    if (normalized.includes("timed out") || normalized.includes("timeout")) {
+        return "timeout";
+    }
+    if (normalized.includes("abort") || normalized.includes("aborted")) {
+        return "unknown";
+    }
+    if (normalized.includes("api key") ||
+        normalized.includes("missing environment variable") ||
+        normalized.includes("auth") ||
+        normalized.includes("authentication") ||
+        normalized.includes("unauthorized") ||
+        normalized.includes("forbidden")) {
+        return "auth_missing";
+    }
+    if (normalized.includes("error sending request for url") ||
+        normalized.includes("dns") ||
+        normalized.includes("network") ||
+        normalized.includes("econn") ||
+        normalized.includes("socket") ||
+        normalized.includes("connection reset") ||
+        normalized.includes("connection refused") ||
+        normalized.includes("stream disconnected")) {
+        return "network_error";
+    }
+    if (normalized.includes("provider") ||
+        normalized.includes("bad gateway") ||
+        normalized.includes("service unavailable") ||
+        normalized.includes("rate limit") ||
+        normalized.includes("too many requests")) {
+        return "provider_error";
+    }
+    if (normalized.includes("sandbox") ||
+        normalized.includes("workspace") ||
+        normalized.includes("permission") ||
+        normalized.includes("enoent")) {
+        return "environment_error";
+    }
+    if (normalized.includes("schema") || normalized.includes("json")) {
+        return "schema_error";
+    }
+    return "unknown";
+}
+//# sourceMappingURL=codex-failure-classifier.js.map

package/dist/problem-solving-core/codex/codex-failure-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-failure-classifier.js","sourceRoot":"","sources":["../../../src/problem-solving-core/codex/codex-failure-classifier.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,uIAAuI;AACvI,8GAA8G;AAI9G,qHAAqH;AACrH,MAAM,UAAU,4BAA4B,CAAC,OAAe;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEzC,IAAI,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACnE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IACE,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC9B,UAAU,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACnD,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC3B,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACrC,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC;QACnC,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,EAChC,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,IACE,UAAU,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACpD,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC1B,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC9B,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC5B,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7B,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACvC,UAAU,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QACzC,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAC1C,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,IACE,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC/B,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC;QAClC,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAC1C,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;QACjC,UAAU,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EACxC,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,IACE,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC9B,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC;QAChC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;QACjC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC7B,CAAC;QACD,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/problem-solving-core/codex/codex-global-config.d.ts

@@ -0,0 +1,17 @@
+import type { OptimusConfig } from "../../types.js";
+export interface GlobalCodexModelProviderConfig {
+    providerId: string;
+    displayName?: string;
+    baseUrl?: string;
+    envKey?: string;
+    wireApi?: "responses" | "chat";
+}
+export interface GlobalCodexConfigSnapshot {
+    sourcePath: string;
+    model?: string;
+    modelProvider?: string;
+    providers: Record<string, GlobalCodexModelProviderConfig>;
+}
+export declare function resolveGlobalCodexConfigPath(config: OptimusConfig, processEnv?: NodeJS.ProcessEnv): string;
+export declare function resolveGlobalCodexHomeDir(config: OptimusConfig, processEnv?: NodeJS.ProcessEnv): string;
+export declare function readGlobalCodexConfigSnapshot(config: OptimusConfig, processEnv?: NodeJS.ProcessEnv): GlobalCodexConfigSnapshot | undefined;

package/dist/problem-solving-core/codex/codex-global-config.js

@@ -0,0 +1,100 @@
+// Global Codex config helpers read user-level Codex settings when Optimus is configured to inherit them.
+// They provide a minimal parser for the subset of config we need: model, model_provider, and model_providers.* provider definitions.
+// This module only reads and interprets config.toml state; it does not resolve secrets, mutate CODEX_HOME, or execute SDK calls.
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export function resolveGlobalCodexConfigPath(config, processEnv = process.env) {
+    const configuredPath = config.codex.globalConfigPath?.trim();
+    if (configuredPath) {
+        return configuredPath;
+    }
+    const homeDir = processEnv.HOME?.trim() || homedir();
+    return join(homeDir, ".codex", "config.toml");
+}
+export function resolveGlobalCodexHomeDir(config, processEnv = process.env) {
+    return dirname(resolveGlobalCodexConfigPath(config, processEnv));
+}
+export function readGlobalCodexConfigSnapshot(config, processEnv = process.env) {
+    const sourcePath = resolveGlobalCodexConfigPath(config, processEnv);
+    let raw = "";
+    try {
+        raw = readFileSync(sourcePath, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    let model;
+    let modelProvider;
+    let currentSection;
+    const providers = {};
+    for (const line of raw.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+            continue;
+        }
+        const sectionMatch = trimmed.match(/^\[(.+)\]$/);
+        if (sectionMatch?.[1]) {
+            currentSection = sectionMatch[1].trim();
+            continue;
+        }
+        const assignment = trimmed.match(/^([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.+)$/);
+        if (!assignment?.[1] || assignment[2] === undefined) {
+            continue;
+        }
+        const key = assignment[1].trim();
+        const value = normalizeTomlString(assignment[2]);
+        if (!value) {
+            continue;
+        }
+        if (!currentSection) {
+            if (key === "model") {
+                model = value;
+            }
+            if (key === "model_provider") {
+                modelProvider = value;
+            }
+            continue;
+        }
+        const providerPrefix = "model_providers.";
+        if (!currentSection.startsWith(providerPrefix)) {
+            continue;
+        }
+        const providerId = currentSection.slice(providerPrefix.length).trim();
+        if (!providerId) {
+            continue;
+        }
+        const provider = (providers[providerId] ??= { providerId });
+        if (key === "name") {
+            provider.displayName = value;
+        }
+        if (key === "base_url") {
+            provider.baseUrl = value;
+        }
+        if (key === "env_key") {
+            provider.envKey = value;
+        }
+        if (key === "wire_api" && (value === "responses" || value === "chat")) {
+            provider.wireApi = value;
+        }
+    }
+    return {
+        sourcePath,
+        ...(model ? { model } : {}),
+        ...(modelProvider ? { modelProvider } : {}),
+        providers
+    };
+}
+function normalizeTomlString(rawValue) {
+    const commentIndex = rawValue.indexOf(" #");
+    const trimmed = (commentIndex >= 0 ? rawValue.slice(0, commentIndex) : rawValue).trim();
+    if (trimmed.length === 0) {
+        return undefined;
+    }
+    const singleQuote = String.fromCharCode(39);
+    if ((trimmed.startsWith("\"") && trimmed.endsWith("\"")) || (trimmed.startsWith(singleQuote) && trimmed.endsWith(singleQuote))) {
+        return trimmed.slice(1, -1).trim() || undefined;
+    }
+    return trimmed;
+}
+//# sourceMappingURL=codex-global-config.js.map

package/dist/problem-solving-core/codex/codex-global-config.js.map

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

package/dist/problem-solving-core/codex/codex-preflight.d.ts

@@ -0,0 +1,13 @@
+import type { CodexPreflightReport, OptimusConfig } from "../../types.js";
+export declare class CodexPreflight {
+    private readonly config;
+    private readonly processEnv;
+    constructor(config: OptimusConfig, processEnv?: NodeJS.ProcessEnv);
+    run(): Promise<CodexPreflightReport>;
+    private buildAuthCheck;
+    private describeMissingAuthInputs;
+    private buildModelCheck;
+    private buildModelProviderCheck;
+    private buildTaskHarnessCheck;
+    private buildApprovalPolicyCheck;
+}

package/dist/problem-solving-core/codex/codex-preflight.js

@@ -0,0 +1,142 @@
+// Codex preflight validates that the runtime is ready before spending time on a real SDK turn.
+// It checks model selection, provider routing, auth readiness, task harness availability, and approval policy invariants.
+// This module only answers "can we start safely" and returns diagnostics; it does not execute tasks or persist task state.
+import { access } from "node:fs/promises";
+import { CodexAuthResolver } from "./codex-auth-resolver.js";
+import { resolveCodexAuthMode, resolveConfiguredCodexModelProvider, resolveConfiguredCodexProvider, resolveEffectiveCodexModel } from "./codex-provider-profile.js";
+import { resolvePrimaryCodexApiKeyEnvName } from "./codex-required-env.js";
+export class CodexPreflight {
+    config;
+    processEnv;
+    constructor(config, processEnv = process.env) {
+        this.config = config;
+        this.processEnv = processEnv;
+    }
+    // Preflight gives operators a deterministic answer before the SDK spends time starting a real turn.
+    async run() {
+        const auth = new CodexAuthResolver(this.config, this.processEnv).resolve();
+        const checks = [];
+        checks.push(this.buildModelCheck());
+        checks.push(this.buildModelProviderCheck());
+        checks.push(this.buildAuthCheck(auth.diagnostics.authenticated));
+        checks.push(await this.buildTaskHarnessCheck());
+        checks.push(this.buildApprovalPolicyCheck());
+        const failedCheck = checks.find((check) => !check.ok);
+        const resolvedModel = resolveEffectiveCodexModel(this.config);
+        const resolvedProvider = resolveConfiguredCodexModelProvider(this.config);
+        return {
+            ok: !failedCheck,
+            summary: failedCheck ? failedCheck.detail : "Codex SDK preflight passed.",
+            auth: auth.diagnostics,
+            checks,
+            ...(resolvedModel ? { resolvedModel } : {}),
+            ...(resolvedProvider ? { resolvedProvider } : {}),
+            ...(failedCheck?.failureCategory ? { failureCategory: failedCheck.failureCategory } : {})
+        };
+    }
+    buildAuthCheck(authenticated) {
+        const authMode = resolveCodexAuthMode(this.config);
+        if (authMode === "codex_cli_login") {
+            return {
+                name: "auth",
+                ok: true,
+                detail: "Codex auth mode is codex_cli_login. Local CLI login will be validated at runtime."
+            };
+        }
+        if (!authenticated) {
+            return {
+                name: "auth",
+                ok: false,
+                detail: `Missing Codex authentication. Missing env vars: ${this.describeMissingAuthInputs()}.`,
+                failureCategory: "auth_missing"
+            };
+        }
+        return {
+            name: "auth",
+            ok: true,
+            detail: "Codex authentication resolved."
+        };
+    }
+    describeMissingAuthInputs() {
+        const auth = new CodexAuthResolver(this.config, this.processEnv).resolve();
+        if (auth.diagnostics.missingEnvVars.length === 0) {
+            return `${resolvePrimaryCodexApiKeyEnvName(this.config, this.processEnv) ?? "runtime login"} or codex.apiKey`;
+        }
+        return auth.diagnostics.missingEnvVars.join(", ");
+    }
+    buildModelCheck() {
+        const model = resolveEffectiveCodexModel(this.config);
+        if (!model || model.trim().length === 0) {
+            return {
+                name: "model",
+                ok: false,
+                detail: "codex.model is required.",
+                failureCategory: "config_error"
+            };
+        }
+        return {
+            name: "model",
+            ok: true,
+            detail: `Codex model configured: ${model}.`
+        };
+    }
+    buildModelProviderCheck() {
+        const authMode = resolveCodexAuthMode(this.config);
+        const modelProvider = resolveConfiguredCodexModelProvider(this.config);
+        const provider = resolveConfiguredCodexProvider(this.config);
+        if (authMode !== "model_provider") {
+            return {
+                name: "model_provider",
+                ok: true,
+                detail: `Codex auth mode is ${authMode}; no custom model provider routing is required.`
+            };
+        }
+        if (!provider) {
+            return {
+                name: "model_provider",
+                ok: false,
+                detail: "codex.provider must include id, displayName, baseUrl, apiKeyEnvName, and wireApi when auth mode is model_provider.",
+                failureCategory: "config_error"
+            };
+        }
+        return {
+            name: "model_provider",
+            ok: true,
+            detail: `Codex provider configured via codex.provider.id=${modelProvider} (${provider.displayName}).`
+        };
+    }
+    async buildTaskHarnessCheck() {
+        try {
+            await access(this.config.runtime.taskHarnessRootDir);
+            return {
+                name: "task_harness_root",
+                ok: true,
+                detail: `Task harness root available at ${this.config.runtime.taskHarnessRootDir}.`
+            };
+        }
+        catch {
+            return {
+                name: "task_harness_root",
+                ok: false,
+                detail: `Task harness root not found: ${this.config.runtime.taskHarnessRootDir}.`,
+                failureCategory: "environment_error"
+            };
+        }
+    }
+    buildApprovalPolicyCheck() {
+        if (this.config.codex.approvalPolicy !== "never") {
+            return {
+                name: "approval_policy",
+                ok: false,
+                detail: `approvalPolicy must stay never, received ${this.config.codex.approvalPolicy}.`,
+                failureCategory: "config_error"
+            };
+        }
+        return {
+            name: "approval_policy",
+            ok: true,
+            detail: "approvalPolicy is locked to never."
+        };
+    }
+}
+//# sourceMappingURL=codex-preflight.js.map

package/dist/problem-solving-core/codex/codex-preflight.js.map

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

package/dist/problem-solving-core/codex/codex-provider-profile.d.ts

@@ -0,0 +1,14 @@
+import type { CodexAuthMode, CodexWireApi, OptimusConfig } from "../../types.js";
+export interface CodexModelProviderProfile {
+    providerId: string;
+    displayName: string;
+    baseUrl: string;
+    envKey: string;
+    wireApi: CodexWireApi;
+}
+export declare function resolveCodexAuthMode(config: OptimusConfig): CodexAuthMode;
+export declare function resolveEffectiveCodexModel(config: OptimusConfig): string | undefined;
+export declare function resolveConfiguredCodexModelProvider(config: OptimusConfig): string | undefined;
+export declare function resolveConfiguredCodexProvider(config: OptimusConfig): CodexModelProviderProfile | undefined;
+export declare function resolveCodexSdkBaseUrl(config: OptimusConfig): string | undefined;
+export declare function renderRuntimeCodexHomeConfig(config: OptimusConfig): string | undefined;

package/dist/problem-solving-core/codex/codex-provider-profile.js

@@ -0,0 +1,68 @@
+// Codex auth/provider helpers normalize project config into one runtime-facing contract.
+// Runtime behavior is fully config-driven; provider metadata must be explicit in project config.
+export function resolveCodexAuthMode(config) {
+    const configuredMode = config.codex.auth?.mode;
+    if (configuredMode) {
+        return configuredMode;
+    }
+    return config.codex.provider ? "model_provider" : "openai_api_key";
+}
+export function resolveEffectiveCodexModel(config) {
+    const configuredModel = config.codex.model?.trim();
+    return configuredModel && configuredModel.length > 0 ? configuredModel : undefined;
+}
+export function resolveConfiguredCodexModelProvider(config) {
+    return resolveConfiguredCodexProvider(config)?.providerId;
+}
+export function resolveConfiguredCodexProvider(config) {
+    if (resolveCodexAuthMode(config) !== "model_provider") {
+        return undefined;
+    }
+    const configured = config.codex.provider;
+    if (!configured || typeof configured !== "object") {
+        return undefined;
+    }
+    const providerId = configured.id?.trim();
+    const displayName = configured.displayName?.trim();
+    const baseUrl = configured.baseUrl?.trim();
+    const envKey = configured.apiKeyEnvName?.trim();
+    const wireApi = configured.wireApi;
+    if (!providerId || !displayName || !baseUrl || !envKey || (wireApi !== "responses" && wireApi !== "chat")) {
+        return undefined;
+    }
+    return {
+        providerId,
+        displayName,
+        baseUrl,
+        envKey,
+        wireApi
+    };
+}
+// Provider routing should prefer explicit provider metadata from config and only fall back to raw baseUrl for legacy direct routing.
+export function resolveCodexSdkBaseUrl(config) {
+    const provider = resolveConfiguredCodexProvider(config);
+    if (provider) {
+        return provider.baseUrl;
+    }
+    const configuredBaseUrl = config.codex.baseUrl?.trim();
+    if (!configuredBaseUrl || resolveCodexAuthMode(config) === "openai_api_key" || resolveCodexAuthMode(config) === "codex_cli_login") {
+        return undefined;
+    }
+    return configuredBaseUrl;
+}
+// The task-private CODEX_HOME gets a minimal runtime config so routing and model defaults stay isolated inside Optimus.
+export function renderRuntimeCodexHomeConfig(config) {
+    const lines = [
+        `model_reasoning_effort = ${JSON.stringify(config.codex.reasoningEffort)}`
+    ];
+    const model = resolveEffectiveCodexModel(config);
+    if (model) {
+        lines.push(`model = ${JSON.stringify(model)}`);
+    }
+    const provider = resolveConfiguredCodexProvider(config);
+    if (provider) {
+        lines.push(`model_provider = ${JSON.stringify(provider.providerId)}`, "", `[model_providers.${provider.providerId}]`, `name = ${JSON.stringify(provider.displayName)}`, `base_url = ${JSON.stringify(provider.baseUrl)}`, `env_key = ${JSON.stringify(provider.envKey)}`, `wire_api = ${JSON.stringify(provider.wireApi)}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=codex-provider-profile.js.map

package/dist/problem-solving-core/codex/codex-provider-profile.js.map

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

package/dist/problem-solving-core/codex/codex-required-env.d.ts

@@ -0,0 +1,3 @@
+import type { OptimusConfig } from "../../types.js";
+export declare function resolvePrimaryCodexApiKeyEnvName(config: OptimusConfig, processEnv?: NodeJS.ProcessEnv): string | undefined;
+export declare function resolveRequiredCodexEnvVars(config: OptimusConfig, processEnv?: NodeJS.ProcessEnv): string[];

package/dist/problem-solving-core/codex/codex-required-env.js

@@ -0,0 +1,21 @@
+// Required-env helpers keep provider-specific credential requirements consistent across auth resolution and preflight.
+// They compute the primary API key env name after provider routing is applied and normalize the final required env list.
+// This module only describes credential requirements; it does not load env files or validate values.
+import { resolveCodexAuthMode, resolveConfiguredCodexProvider } from "./codex-provider-profile.js";
+// Auth mode defines whether runtime should expect an explicit env key or rely on local Codex CLI login state.
+export function resolvePrimaryCodexApiKeyEnvName(config, processEnv = process.env) {
+    const authMode = resolveCodexAuthMode(config);
+    if (authMode === "codex_cli_login") {
+        return undefined;
+    }
+    if (authMode === "model_provider") {
+        return resolveConfiguredCodexProvider(config)?.envKey;
+    }
+    return "OPENAI_API_KEY";
+}
+// Required envs are normalized around the resolved primary provider credential to avoid dual-key confusion.
+export function resolveRequiredCodexEnvVars(config, processEnv = process.env) {
+    const primaryEnvName = resolvePrimaryCodexApiKeyEnvName(config, processEnv);
+    return primaryEnvName ? [primaryEnvName] : [];
+}
+//# sourceMappingURL=codex-required-env.js.map

package/dist/problem-solving-core/codex/codex-required-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-required-env.js","sourceRoot":"","sources":["../../../src/problem-solving-core/codex/codex-required-env.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,yHAAyH;AACzH,qGAAqG;AAIrG,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAEnG,8GAA8G;AAC9G,MAAM,UAAU,gCAAgC,CAAC,MAAqB,EAAE,aAAgC,OAAO,CAAC,GAAG;IACjH,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QACnC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;QAClC,OAAO,8BAA8B,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACxD,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,2BAA2B,CAAC,MAAqB,EAAE,aAAgC,OAAO,CAAC,GAAG;IAC5G,MAAM,cAAc,GAAG,gCAAgC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5E,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC"}

package/dist/problem-solving-core/codex/codex-runner.d.ts

@@ -0,0 +1,37 @@
+import type { CodexHealthCheckResult, OptimusConfig, TaskExecutionContext, TaskExecutionRequest, TaskResult } from "../../types.js";
+export declare class CodexRunner {
+    private readonly config;
+    private readonly logger;
+    constructor(config: OptimusConfig);
+    runTask(request: TaskExecutionRequest, context: TaskExecutionContext): Promise<TaskResult>;
+    runHealthCheck(): Promise<CodexHealthCheckResult>;
+    private runWithCodexSdk;
+    private resolveTurnResult;
+    private tryResolveResultDocumentFallback;
+    private describeStreamEventDetail;
+    private extractCommandPreview;
+    private extractTextPreview;
+    private describeStreamEvent;
+    private buildThreadOptions;
+    private describeCompletedItem;
+    private loadTaskHarnessDocumentSet;
+    private buildPrompt;
+    private renderExecutionFrameSection;
+    private normalizeHarnessMarkdown;
+    private stripRedundantTopHeading;
+    private demoteMarkdownHeadings;
+    private normalizeResultDocumentPaths;
+    private sanitizeResultDocumentPaths;
+    private buildOutputSchema;
+    private parseCodexResponse;
+    private validateResultContract;
+    private previewResponse;
+    private writeDebugResponseArtifact;
+    private parseHealthCheckResponse;
+    private createExecutionSignal;
+    private ensureCodexHome;
+    private createCodexClient;
+    private resolveFailureCategory;
+    private classifyFailureCategory;
+    private createDiagnostics;
+}