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

package/dist/index.js

@@ -34,6 +34,8 @@ __export(index_exports, {
   ANSWER_COMPONENT_NAMES: () => ANSWER_COMPONENT_NAMES,
   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,
@@ -62,6 +64,9 @@ __export(index_exports, {
   bridgePreamble: () => bridgePreamble,
   captureContext: () => captureContext,
   clearContextTokens: () => clearContextTokens,
+  codexDefaultProvider: () => codexDefaultProvider,
+  codexModelFor: () => codexModelFor,
+  codexRunConfig: () => codexRunConfig,
   constraintPoliciesFromConfig: () => constraintPoliciesFromConfig,
   contextTokenCount: () => contextTokenCount,
   createCodexSession: () => createCodexSession,
@@ -24704,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() {
@@ -24801,17 +24809,67 @@ 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;
+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.
+    ...opts.mcpServers && Object.keys(opts.mcpServers).length ? { mcp_servers: opts.mcpServers } : {},
+    // Per run, not ~/.codex/config.toml: a host without that line would run
+    // 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;
@@ -24832,21 +24890,12 @@ function createCodexSession(opts) {
   async function ensureThread() {
     if (thread) return thread;
     const { Codex } = await loadCodex();
-    const config2 = {
-      // 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.
-      ...opts.mcpServers && Object.keys(opts.mcpServers).length ? { mcp_servers: opts.mcpServers } : {},
-      // Per run, not ~/.codex/config.toml: a host without that line would run
-      // 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] } : {},
-      ...opts.extraConfig ?? {}
-    };
+    const config2 = codexRunConfig(opts, provider);
     const codex = new Codex({
       ...opts.apiKey ? { apiKey: opts.apiKey } : {},
       ...opts.baseUrl ? { baseUrl: opts.baseUrl } : {},
-      env: buildEnv(opts),
-      // Only when non-empty: an empty override is pointless CLI noise.
-      ...Object.keys(config2).length ? { config: config2 } : {}
+      env: buildEnv(opts, provider),
+      config: config2
     });
     thread = resumeId ? codex.resumeThread(resumeId, threadOptions()) : codex.startThread(threadOptions());
     return thread;
@@ -25008,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() {
@@ -25176,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;
   }
@@ -25201,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: [],
@@ -25420,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
@@ -25463,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) {
@@ -25479,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" };
 }
@@ -25492,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,
@@ -25544,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 {
@@ -25558,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 };
     }));
@@ -25578,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 {
   }
@@ -25596,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}`;
@@ -25715,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
       );
@@ -25820,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);
     }
   }
 }
@@ -25882,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 }));
 }
@@ -26156,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: {} };
   }
@@ -26186,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}`);
   }
@@ -26323,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();
@@ -26389,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, {
@@ -30342,6 +30391,8 @@ var SuperatomSDK = class {
   ANSWER_COMPONENT_NAMES,
   BM25L,
   CATEGORY_KEYS,
+  CODEX_DOC_MAX_BYTES,
+  CODEX_OPENROUTER_KEY_ENV,
   CONTEXT_CONFIG,
   CleanupService,
   DEFAULT_AGENT_CONFIG,
@@ -30370,6 +30421,9 @@ var SuperatomSDK = class {
   bridgePreamble,
   captureContext,
   clearContextTokens,
+  codexDefaultProvider,
+  codexModelFor,
+  codexRunConfig,
   constraintPoliciesFromConfig,
   contextTokenCount,
   createCodexSession,