@superatomai/sdk-node 0.0.90-dsp → 0.0.91-dsp

package/dist/index.d.mts

@@ -5734,8 +5734,22 @@ interface CodexSessionOptions extends CodingAgentSessionOptions {
  * drops the rest without a word; composed instructions run past that, losing their closing rules.
  */
 declare const CODEX_DOC_MAX_BYTES: number;
+/** The env var codex reads the OpenRouter key from: the driver passes only CODEX_* and OPENAI_* through. */
+declare const CODEX_OPENROUTER_KEY_ENV = "CODEX_OPENROUTER_API_KEY";
+interface CodexProvider {
+    config: Record<string, unknown>;
+    env: Record<string, string>;
+}
+/**
+ * OpenRouter by default, on the deployment's OPENROUTER_API_KEY and through the Superatom proxy when
+ * set, so no VM needs its own codex config or login. A provider chosen in config.toml, or
+ * CODEX_MODEL_PROVIDER naming another (e.g. `chatgpt` for a `codex login`), is left alone.
+ */
+declare function codexDefaultProvider(env?: NodeJS.ProcessEnv, configToml?: string): CodexProvider | null;
+/** OpenRouter names models by vendor: `gpt-6-luna` there is `openai/gpt-6-luna`. */
+declare function codexModelFor(model: string | undefined, provider: CodexProvider | null): string | undefined;
 /** The `--config` overrides for one run: per run, so no host's config.toml decides them. */
-declare function codexRunConfig(opts: Pick<CodexSessionOptions, 'mcpServers' | 'instructionsFile' | 'extraConfig'>): Record<string, unknown>;
+declare function codexRunConfig(opts: Pick<CodexSessionOptions, 'mcpServers' | 'instructionsFile' | 'extraConfig'>, provider?: CodexProvider | null): Record<string, unknown>;
 declare function createCodexSession(opts: CodexSessionOptions): CodingAgentSession;
 
 /**
@@ -6840,4 +6854,4 @@ declare class SuperatomSDK {
     getConversationSimilarityThreshold(): number;
 }
 
-export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnalyticsEventType, type AnalyticsStatus, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CODEX_DOC_MAX_BYTES, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type ConstraintFilter, type ConstraintOp, type ConstraintPolicy, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type GeneratedFile, type GraphVersion, type Harness, type HybridSearchOptions, INSTRUCTIONS_FILE, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type PiSessionListener, type PiSessionState, type PiTranscriptEntry, type PolicyException, type PolicyExceptionTable, type Principal, type PromptAttachment, type PromptContext, type RequestContext, type RerankedResult, type ResolvedAccess, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type ShimDef, type ShimSummary, type ShimTarget, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, accessFromConfig, analyticsClient, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, bridgePreamble, captureContext, clearContextTokens, codexRunConfig, constraintPoliciesFromConfig, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getPiSessionState, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, onPiSessionUpdate, openaiLLM, policiesFromConfig, projectForDatasetBinding, promptLoader, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims, writeShims };
+export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnalyticsEventType, type AnalyticsStatus, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CODEX_DOC_MAX_BYTES, CODEX_OPENROUTER_KEY_ENV, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexProvider, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type ConstraintFilter, type ConstraintOp, type ConstraintPolicy, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type GeneratedFile, type GraphVersion, type Harness, type HybridSearchOptions, INSTRUCTIONS_FILE, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type PiSessionListener, type PiSessionState, type PiTranscriptEntry, type PolicyException, type PolicyExceptionTable, type Principal, type PromptAttachment, type PromptContext, type RequestContext, type RerankedResult, type ResolvedAccess, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type ShimDef, type ShimSummary, type ShimTarget, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, accessFromConfig, analyticsClient, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, bridgePreamble, captureContext, clearContextTokens, codexDefaultProvider, codexModelFor, codexRunConfig, constraintPoliciesFromConfig, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getPiSessionState, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, onPiSessionUpdate, openaiLLM, policiesFromConfig, projectForDatasetBinding, promptLoader, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims, writeShims };

package/dist/index.d.ts

@@ -5734,8 +5734,22 @@ interface CodexSessionOptions extends CodingAgentSessionOptions {
  * drops the rest without a word; composed instructions run past that, losing their closing rules.
  */
 declare const CODEX_DOC_MAX_BYTES: number;
+/** The env var codex reads the OpenRouter key from: the driver passes only CODEX_* and OPENAI_* through. */
+declare const CODEX_OPENROUTER_KEY_ENV = "CODEX_OPENROUTER_API_KEY";
+interface CodexProvider {
+    config: Record<string, unknown>;
+    env: Record<string, string>;
+}
+/**
+ * OpenRouter by default, on the deployment's OPENROUTER_API_KEY and through the Superatom proxy when
+ * set, so no VM needs its own codex config or login. A provider chosen in config.toml, or
+ * CODEX_MODEL_PROVIDER naming another (e.g. `chatgpt` for a `codex login`), is left alone.
+ */
+declare function codexDefaultProvider(env?: NodeJS.ProcessEnv, configToml?: string): CodexProvider | null;
+/** OpenRouter names models by vendor: `gpt-6-luna` there is `openai/gpt-6-luna`. */
+declare function codexModelFor(model: string | undefined, provider: CodexProvider | null): string | undefined;
 /** The `--config` overrides for one run: per run, so no host's config.toml decides them. */
-declare function codexRunConfig(opts: Pick<CodexSessionOptions, 'mcpServers' | 'instructionsFile' | 'extraConfig'>): Record<string, unknown>;
+declare function codexRunConfig(opts: Pick<CodexSessionOptions, 'mcpServers' | 'instructionsFile' | 'extraConfig'>, provider?: CodexProvider | null): Record<string, unknown>;
 declare function createCodexSession(opts: CodexSessionOptions): CodingAgentSession;
 
 /**
@@ -6840,4 +6854,4 @@ declare class SuperatomSDK {
     getConversationSimilarityThreshold(): number;
 }
 
-export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnalyticsEventType, type AnalyticsStatus, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CODEX_DOC_MAX_BYTES, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type ConstraintFilter, type ConstraintOp, type ConstraintPolicy, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type GeneratedFile, type GraphVersion, type Harness, type HybridSearchOptions, INSTRUCTIONS_FILE, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type PiSessionListener, type PiSessionState, type PiTranscriptEntry, type PolicyException, type PolicyExceptionTable, type Principal, type PromptAttachment, type PromptContext, type RequestContext, type RerankedResult, type ResolvedAccess, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type ShimDef, type ShimSummary, type ShimTarget, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, accessFromConfig, analyticsClient, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, bridgePreamble, captureContext, clearContextTokens, codexRunConfig, constraintPoliciesFromConfig, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getPiSessionState, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, onPiSessionUpdate, openaiLLM, policiesFromConfig, projectForDatasetBinding, promptLoader, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims, writeShims };
+export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnalyticsEventType, type AnalyticsStatus, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CODEX_DOC_MAX_BYTES, CODEX_OPENROUTER_KEY_ENV, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexProvider, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type ConstraintFilter, type ConstraintOp, type ConstraintPolicy, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type GeneratedFile, type GraphVersion, type Harness, type HybridSearchOptions, INSTRUCTIONS_FILE, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type PiSessionListener, type PiSessionState, type PiTranscriptEntry, type PolicyException, type PolicyExceptionTable, type Principal, type PromptAttachment, type PromptContext, type RequestContext, type RerankedResult, type ResolvedAccess, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type ShimDef, type ShimSummary, type ShimTarget, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, accessFromConfig, analyticsClient, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, bridgePreamble, captureContext, clearContextTokens, codexDefaultProvider, codexModelFor, codexRunConfig, constraintPoliciesFromConfig, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getPiSessionState, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, onPiSessionUpdate, openaiLLM, policiesFromConfig, projectForDatasetBinding, promptLoader, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims, writeShims };

package/dist/index.js

@@ -35,6 +35,7 @@ __export(index_exports, {
   BM25L: () => BM25L,
   CATEGORY_KEYS: () => CATEGORY_KEYS,
   CODEX_DOC_MAX_BYTES: () => CODEX_DOC_MAX_BYTES,
+  CODEX_OPENROUTER_KEY_ENV: () => CODEX_OPENROUTER_KEY_ENV,
   CONTEXT_CONFIG: () => CONTEXT_CONFIG,
   CleanupService: () => CleanupService,
   DEFAULT_AGENT_CONFIG: () => DEFAULT_AGENT_CONFIG,
@@ -63,6 +64,8 @@ __export(index_exports, {
   bridgePreamble: () => bridgePreamble,
   captureContext: () => captureContext,
   clearContextTokens: () => clearContextTokens,
+  codexDefaultProvider: () => codexDefaultProvider,
+  codexModelFor: () => codexModelFor,
   codexRunConfig: () => codexRunConfig,
   constraintPoliciesFromConfig: () => constraintPoliciesFromConfig,
   contextTokenCount: () => contextTokenCount,
@@ -24706,6 +24709,9 @@ async function handleDashboardAgentRequest(data, collections, sendMessage) {
 }
 
 // src/codingAgent/drivers/codex.ts
+var fs8 = __toESM(require("fs"));
+var os2 = __toESM(require("os"));
+var path9 = __toESM(require("path"));
 var dynamicImport = new Function("specifier", "return import(specifier)");
 var codexModulePromise = null;
 function loadCodex() {
@@ -24803,17 +24809,51 @@ function markerFor(event) {
       return null;
   }
 }
-function buildEnv(opts) {
-  if (opts.inheritEnv) return opts.env ? { ...process.env, ...opts.env } : void 0;
+function buildEnv(opts, provider = null) {
+  const extra = { ...provider?.env ?? {}, ...opts.env ?? {} };
+  if (opts.inheritEnv) return Object.keys(extra).length ? { ...process.env, ...extra } : void 0;
   const env = {};
   for (const [k, v] of Object.entries(process.env)) {
     if (v === void 0) continue;
     if (envAllowed(k)) env[k] = v;
   }
-  return { ...env, ...opts.env ?? {} };
+  return { ...env, ...extra };
 }
 var CODEX_DOC_MAX_BYTES = 256 * 1024;
-function codexRunConfig(opts) {
+var CODEX_OPENROUTER_KEY_ENV = "CODEX_OPENROUTER_API_KEY";
+function tomlTopLevel(toml) {
+  const i = toml.search(/^\s*\[/m);
+  return i < 0 ? toml : toml.slice(0, i);
+}
+function readCodexConfig(env) {
+  try {
+    return fs8.readFileSync(path9.join(env.CODEX_HOME || path9.join(os2.homedir(), ".codex"), "config.toml"), "utf-8");
+  } catch {
+    return "";
+  }
+}
+function codexDefaultProvider(env = process.env, configToml) {
+  const choice = env.CODEX_MODEL_PROVIDER?.trim();
+  if (choice && choice !== "openrouter") return null;
+  if (!choice && /^\s*model_provider\s*=/m.test(tomlTopLevel(configToml ?? readCodexConfig(env)))) return null;
+  const key = env.OPENROUTER_API_KEY?.trim();
+  if (!key) return null;
+  const root = env.SUPERATOM_LLM_PROXY_URL?.trim();
+  const baseUrl = env.OPENROUTER_BASE_URL?.trim() || (root ? `${root.replace(/\/+$/, "")}/openrouter` : "https://openrouter.ai/api/v1");
+  return {
+    config: {
+      model_provider: "openrouter",
+      model_providers: { openrouter: { name: "OpenRouter", base_url: baseUrl, env_key: CODEX_OPENROUTER_KEY_ENV, wire_api: "responses" } },
+      // codex's default compacts at ~112k tokens, well short of the model's window.
+      model_auto_compact_token_limit: 23e4
+    },
+    env: { [CODEX_OPENROUTER_KEY_ENV]: key }
+  };
+}
+function codexModelFor(model, provider) {
+  return provider && model && !model.includes("/") ? `openai/${model}` : model;
+}
+function codexRunConfig(opts, provider = null) {
   return {
     // Tools reach codex as MCP servers; each server's name shows up on
     // every tool event, so the runner can tell ours from codex's own.
@@ -24822,12 +24862,14 @@ function codexRunConfig(opts) {
     // the agent with no instructions at all. AGENTS.md still wins if present.
     ...opts.instructionsFile && opts.instructionsFile !== "AGENTS.md" ? { project_doc_fallback_filenames: [opts.instructionsFile] } : {},
     project_doc_max_bytes: CODEX_DOC_MAX_BYTES,
+    ...provider?.config ?? {},
     // Last: a deployment's own value wins.
     ...opts.extraConfig ?? {}
   };
 }
 function createCodexSession(opts) {
-  const model = opts.model ?? process.env.CODEX_AGENT_MODEL;
+  const provider = opts.apiKey || opts.baseUrl ? null : codexDefaultProvider();
+  const model = codexModelFor(opts.model ?? process.env.CODEX_AGENT_MODEL, provider);
   let thread = null;
   let resumeId = opts.resumeId;
   let threadId = opts.resumeId;
@@ -24848,11 +24890,11 @@ function createCodexSession(opts) {
   async function ensureThread() {
     if (thread) return thread;
     const { Codex } = await loadCodex();
-    const config2 = codexRunConfig(opts);
+    const config2 = codexRunConfig(opts, provider);
     const codex = new Codex({
       ...opts.apiKey ? { apiKey: opts.apiKey } : {},
       ...opts.baseUrl ? { baseUrl: opts.baseUrl } : {},
-      env: buildEnv(opts),
+      env: buildEnv(opts, provider),
       config: config2
     });
     thread = resumeId ? codex.resumeThread(resumeId, threadOptions()) : codex.startThread(threadOptions());
@@ -25015,8 +25057,8 @@ ${marker}
 
 // src/codingAgent/drivers/pi.ts
 var crypto3 = __toESM(require("crypto"));
-var fs8 = __toESM(require("fs"));
-var path9 = __toESM(require("path"));
+var fs9 = __toESM(require("fs"));
+var path10 = __toESM(require("path"));
 var dynamicImport2 = new Function("specifier", "return import(specifier)");
 var piModulePromise = null;
 function loadPi() {
@@ -25183,9 +25225,9 @@ function startSweeper() {
 }
 function readInstructions(opts) {
   if (!opts.instructionsFile) return void 0;
-  const file = path9.resolve(opts.cwd, opts.instructionsFile);
+  const file = path10.resolve(opts.cwd, opts.instructionsFile);
   try {
-    return { file, content: fs8.readFileSync(file, "utf-8") };
+    return { file, content: fs9.readFileSync(file, "utf-8") };
   } catch {
     return void 0;
   }
@@ -25208,7 +25250,7 @@ function createPiSession(opts) {
       agentsFilesOverride: (base) => instructions ? { agentsFiles: [{ path: instructions.file, content: instructions.content }] } : base
     });
     await resourceLoader.reload();
-    const sessionManager = resumeFile && fs8.existsSync(resumeFile) ? pi.SessionManager.open(resumeFile) : pi.SessionManager.create(opts.cwd);
+    const sessionManager = resumeFile && fs9.existsSync(resumeFile) ? pi.SessionManager.open(resumeFile) : pi.SessionManager.create(opts.cwd);
     const live = {
       running: false,
       transcript: [],
@@ -25427,11 +25469,11 @@ function createCodingAgentSession(harness, opts) {
 }
 
 // src/codingAgent/registry.ts
-var path10 = __toESM(require("path"));
+var path11 = __toESM(require("path"));
 var agents = /* @__PURE__ */ new Map();
 var config = {
-  promptRoot: path10.join(process.cwd(), ".prompts", "coding-agents"),
-  runtimeDir: path10.join(process.cwd(), ".coding-agent-runtime"),
+  promptRoot: path11.join(process.cwd(), ".prompts", "coding-agents"),
+  runtimeDir: path11.join(process.cwd(), ".coding-agent-runtime"),
   harness: "codex",
   keepRuns: 20,
   keepThreads: 200
@@ -25470,13 +25512,13 @@ function getCodingAgentsConfig() {
   return config;
 }
 function resolvePromptDir(def) {
-  return def.promptDir || path10.join(config.promptRoot, def.id);
+  return def.promptDir || path11.join(config.promptRoot, def.id);
 }
 
 // src/codingAgent/runner.ts
-var fs9 = __toESM(require("fs"));
+var fs10 = __toESM(require("fs"));
 var fsp = __toESM(require("fs/promises"));
-var path11 = __toESM(require("path"));
+var path12 = __toESM(require("path"));
 var DEFAULT_TIMEOUT_MS = 15 * 60 * 1e3;
 var inFlight = /* @__PURE__ */ new Set();
 function slug(v) {
@@ -25486,11 +25528,11 @@ function resolveScope(def, opts) {
   const scope = def.scope ?? (def.mode === "chat" ? "thread" : "project");
   if (scope === "thread") {
     const id = slug(opts.threadId || "default");
-    return { key: `thread:${id}`, dirName: path11.join("threads", id) };
+    return { key: `thread:${id}`, dirName: path12.join("threads", id) };
   }
   if (scope === "user") {
     const id = slug(opts.userId || "anonymous");
-    return { key: `user:${id}`, dirName: path11.join("users", id) };
+    return { key: `user:${id}`, dirName: path12.join("users", id) };
   }
   return { key: "project", dirName: "_project" };
 }
@@ -25499,30 +25541,30 @@ function makeRunId() {
   return `${t}-${Math.random().toString(36).slice(2, 8)}`;
 }
 function statePath(scopeDir) {
-  return path11.join(scopeDir, "_state.json");
+  return path12.join(scopeDir, "_state.json");
 }
 function loadState(scopeDir) {
   try {
-    return JSON.parse(fs9.readFileSync(statePath(scopeDir), "utf-8"));
+    return JSON.parse(fs10.readFileSync(statePath(scopeDir), "utf-8"));
   } catch {
     return { turns: 0, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
   }
 }
 function saveState(scopeDir, state) {
   try {
-    fs9.mkdirSync(scopeDir, { recursive: true });
-    fs9.writeFileSync(statePath(scopeDir), JSON.stringify({ ...state, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2));
+    fs10.mkdirSync(scopeDir, { recursive: true });
+    fs10.writeFileSync(statePath(scopeDir), JSON.stringify({ ...state, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2));
   } catch (err) {
     logger.warn(`[CodingAgent] failed to persist session state: ${err?.message ?? err}`);
   }
 }
 async function clearTransient(dir) {
-  await fsp.rm(path11.join(dir, "input"), { recursive: true, force: true });
+  await fsp.rm(path12.join(dir, "input"), { recursive: true, force: true });
 }
 function createWorkspace(dir, runId) {
-  const abs = (rel) => path11.join(dir, rel);
+  const abs = (rel) => path12.join(dir, rel);
   const ensureDir = async (rel) => {
-    await fsp.mkdir(path11.dirname(abs(rel)), { recursive: true });
+    await fsp.mkdir(path12.dirname(abs(rel)), { recursive: true });
   };
   return {
     dir,
@@ -25551,7 +25593,7 @@ function createWorkspace(dir, runId) {
 }
 var INSTRUCTIONS_FILE = "system.md";
 async function installInstructions(def, ws) {
-  const src = path11.join(resolvePromptDir(def), "system.md");
+  const src = path12.join(resolvePromptDir(def), "system.md");
   try {
     await ws.write(INSTRUCTIONS_FILE, await fsp.readFile(src, "utf-8"));
   } catch {
@@ -25565,7 +25607,7 @@ async function pruneThreads(agentId, threadsDir, keep) {
     const dirs = (await fsp.readdir(threadsDir, { withFileTypes: true })).filter((e) => e.isDirectory());
     if (dirs.length <= keep) return;
     const aged = await Promise.all(dirs.map(async (e) => {
-      const dir = path11.join(threadsDir, e.name);
+      const dir = path12.join(threadsDir, e.name);
       const stat2 = await fsp.stat(statePath(dir)).catch(() => fsp.stat(dir));
       return { name: e.name, dir, used: stat2.mtimeMs };
     }));
@@ -25585,7 +25627,7 @@ async function pruneRuns(agentDir, keep) {
   try {
     const entries = (await fsp.readdir(agentDir, { withFileTypes: true })).filter((e) => e.isDirectory()).map((e) => e.name).sort();
     for (const name of entries.slice(0, Math.max(0, entries.length - keep))) {
-      await fsp.rm(path11.join(agentDir, name), { recursive: true, force: true });
+      await fsp.rm(path12.join(agentDir, name), { recursive: true, force: true });
     }
   } catch {
   }
@@ -25603,17 +25645,17 @@ async function runCodingAgent(agentId, options = {}) {
   }
   const cfg = getCodingAgentsConfig();
   const runId = makeRunId();
-  const agentDir = path11.join(cfg.runtimeDir, def.id);
+  const agentDir = path12.join(cfg.runtimeDir, def.id);
   const policy = def.session ?? {};
   const persistentWorkspace = policy.workspace === "persistent";
   const persistentSession = policy.scope === "persistent";
   const runAsJob = !(options.chat === true && def.mode === "task");
   const { key: scopeKey, dirName } = resolveScope(def, { userId: options.userId, threadId: options.threadId });
-  const scopeDir = path11.join(agentDir, dirName);
-  const dir = options.workspaceDir || (persistentWorkspace ? scopeDir : path11.join(scopeDir, "runs", runId));
-  fs9.mkdirSync(dir, { recursive: true });
+  const scopeDir = path12.join(agentDir, dirName);
+  const dir = options.workspaceDir || (persistentWorkspace ? scopeDir : path12.join(scopeDir, "runs", runId));
+  fs10.mkdirSync(dir, { recursive: true });
   if (persistentWorkspace && !options.workspaceDir) {
-    fs9.mkdirSync(path11.join(dir, "memory"), { recursive: true });
+    fs10.mkdirSync(path12.join(dir, "memory"), { recursive: true });
     if (runAsJob) await clearTransient(dir);
   }
   const lockKey = persistentWorkspace || persistentSession ? `${def.id}:${scopeKey}` : `dir:${dir}`;
@@ -25722,7 +25764,7 @@ async function runCodingAgent(agentId, options = {}) {
           onUsage: ctx.onUsage,
           // Opt-in only: see stopOnDeliverable. Letting the turn end naturally
           // is what makes usage reporting work at all.
-          ...outputPath && def.stopOnDeliverable ? { doneWhen: () => fs9.existsSync(outputPath) } : {}
+          ...outputPath && def.stopOnDeliverable ? { doneWhen: () => fs10.existsSync(outputPath) } : {}
         },
         timeout.signal
       );
@@ -25827,9 +25869,9 @@ Fix ONLY that, and rewrite the same file at the same path. Do not re-run any que
     logger.info(
       `[CodingAgent:${def.id}] ${runAsJob ? "run" : "chat"}=${runId} status=${record.status} ms=${record.ms} tokens=${record.usage.inputTokens}/${record.usage.outputTokens} tools=${record.usage.toolCalls}` + (record.applied ? ` applied="${record.applied.summary}"` : "") + (record.error ? ` error="${record.error}"` : "")
     );
-    if (!options.workspaceDir && !persistentWorkspace) await pruneRuns(path11.join(scopeDir, "runs"), cfg.keepRuns);
-    if (!options.workspaceDir && dirName.startsWith(`threads${path11.sep}`)) {
-      await pruneThreads(def.id, path11.join(agentDir, "threads"), cfg.keepThreads);
+    if (!options.workspaceDir && !persistentWorkspace) await pruneRuns(path12.join(scopeDir, "runs"), cfg.keepRuns);
+    if (!options.workspaceDir && dirName.startsWith(`threads${path12.sep}`)) {
+      await pruneThreads(def.id, path12.join(agentDir, "threads"), cfg.keepThreads);
     }
   }
 }
@@ -25889,14 +25931,14 @@ ${assertReadOnlySql.toString().replace("export function", "function")}
 `;
 
 // src/codingAgent/tools/shims.ts
-var fs10 = __toESM(require("fs"));
-var path12 = __toESM(require("path"));
-var resolve3 = (target, name) => typeof target === "string" ? path12.join(target, name) : target.pathTo(name);
+var fs11 = __toESM(require("fs"));
+var path13 = __toESM(require("path"));
+var resolve3 = (target, name) => typeof target === "string" ? path13.join(target, name) : target.pathTo(name);
 function writeShims(defs, target) {
   for (const def of defs) {
     const file = resolve3(target, def.name);
-    fs10.writeFileSync(file, def.body, "utf-8");
-    fs10.chmodSync(file, 493);
+    fs11.writeFileSync(file, def.body, "utf-8");
+    fs11.chmodSync(file, 493);
   }
   return defs.map((def) => ({ name: `./${def.name}`, summary: def.summary }));
 }
@@ -26163,17 +26205,17 @@ console.log(${JSON.stringify(
 }
 
 // src/codingAgent/triggers.ts
-var fs11 = __toESM(require("fs"));
-var path13 = __toESM(require("path"));
+var fs12 = __toESM(require("fs"));
+var path14 = __toESM(require("path"));
 var EVENT_BURST_CAP = 200;
 var capEvents = (events) => events.length > EVENT_BURST_CAP ? events.slice(-EVENT_BURST_CAP) : events;
 function statePath2(agentId) {
-  return path13.join(getCodingAgentsConfig().runtimeDir, agentId, "_triggers.json");
+  return path14.join(getCodingAgentsConfig().runtimeDir, agentId, "_triggers.json");
 }
 function loadTriggerState(agentId) {
   let raw;
   try {
-    raw = JSON.parse(fs11.readFileSync(statePath2(agentId), "utf-8"));
+    raw = JSON.parse(fs12.readFileSync(statePath2(agentId), "utf-8"));
   } catch {
     return { counts: {}, pending: {} };
   }
@@ -26193,8 +26235,8 @@ function loadTriggerState(agentId) {
 function saveTriggerState(agentId, state) {
   try {
     const p = statePath2(agentId);
-    fs11.mkdirSync(path13.dirname(p), { recursive: true });
-    fs11.writeFileSync(p, JSON.stringify(state, null, 2));
+    fs12.mkdirSync(path14.dirname(p), { recursive: true });
+    fs12.writeFileSync(p, JSON.stringify(state, null, 2));
   } catch (err) {
     logger.warn(`[CodingAgent:${agentId}] failed to persist trigger state: ${err?.message ?? err}`);
   }
@@ -26330,13 +26372,13 @@ function describeTriggers() {
 }
 
 // src/codingAgent/collection.ts
-var fs12 = __toESM(require("fs"));
-var path14 = __toESM(require("path"));
+var fs13 = __toESM(require("fs"));
+var path15 = __toESM(require("path"));
 function isChattable(agent) {
   return agent.mode !== "task";
 }
 function registerCodingAgentCollection(sdk, config2 = {}) {
-  const runtimeDir = config2.runtimeDir || process.env.CODING_AGENT_RUNTIME_DIR || path14.join(process.cwd(), ".coding-agent-runtime");
+  const runtimeDir = config2.runtimeDir || process.env.CODING_AGENT_RUNTIME_DIR || path15.join(process.cwd(), ".coding-agent-runtime");
   const defaultHarness = config2.harness || process.env.CODING_AGENT_HARNESS || "codex";
   const sessions = /* @__PURE__ */ new Map();
   const running = /* @__PURE__ */ new Set();
@@ -26396,8 +26438,8 @@ function registerCodingAgentCollection(sdk, config2 = {}) {
           ...record.status === "skipped" ? { error: `${def.title} is in the middle of a run \u2014 try again in a moment.` } : record.error ? { error: record.error } : {}
         };
       }
-      const cwd = path14.join(runtimeDir, "threads", threadId);
-      fs12.mkdirSync(cwd, { recursive: true });
+      const cwd = path15.join(runtimeDir, "threads", threadId);
+      fs13.mkdirSync(cwd, { recursive: true });
       let session = sessions.get(threadId);
       if (!session) {
         session = createCodingAgentSession(harness || defaultHarness, {
@@ -30350,6 +30392,7 @@ var SuperatomSDK = class {
   BM25L,
   CATEGORY_KEYS,
   CODEX_DOC_MAX_BYTES,
+  CODEX_OPENROUTER_KEY_ENV,
   CONTEXT_CONFIG,
   CleanupService,
   DEFAULT_AGENT_CONFIG,
@@ -30378,6 +30421,8 @@ var SuperatomSDK = class {
   bridgePreamble,
   captureContext,
   clearContextTokens,
+  codexDefaultProvider,
+  codexModelFor,
   codexRunConfig,
   constraintPoliciesFromConfig,
   contextTokenCount,