@desplega.ai/agent-swarm 1.121.0 → 1.122.0

package/dist/{pi-mono-adapter-ke789738.js → pi-mono-adapter-k3z6e5fn.js}

@@ -22,7 +22,7 @@ import {
   streamSimple,
   summarizeSession,
   validateToolArguments
-} from "./cli-dmzv0986.js";
+} from "./cli-vh3h1grg.js";
 import {
   checkToolLoop,
   clearToolHistory
@@ -46,6 +46,10 @@ import"./cli-tk9vyqzh.js";
 import {
   applyReasoningEffort
 } from "./cli-e61fs2hp.js";
+import {
+  DEFAULT_OPENROUTER_BASE_URL,
+  getOpenRouterBaseUrl
+} from "./cli-3dpj7atn.js";
 import {
   McpHttpClient
 } from "./cli-jkhwmmgg.js";
@@ -161168,7 +161172,8 @@ async function summarizeSessionForPi(config, sessionFile, deps = {}) {
         prompt: taskDetails?.task
       },
       apiUrl: config.apiUrl,
-      apiKey: config.apiKey
+      apiKey: config.apiKey,
+      env: config.env
     });
     if (!result)
       return;
@@ -161564,6 +161569,95 @@ async function createPiRuntimeAuth(env = process.env) {
   }
   return modelRuntime;
 }
+var OPENROUTER_OVERRIDE_MARKER = ".agent-swarm-openrouter-override.json";
+async function readJsonFile(path12) {
+  try {
+    const file = Bun.file(path12);
+    if (!await file.exists())
+      return;
+    const parsed = JSON.parse(await file.text());
+    return typeof parsed === "object" && parsed !== null ? parsed : undefined;
+  } catch {
+    return;
+  }
+}
+async function ensureOpenRouterModelsOverride(agentDir, env = process.env) {
+  const baseUrl = getOpenRouterBaseUrl(env);
+  const modelsPath = join39(agentDir, "models.json");
+  const markerPath = join39(agentDir, OPENROUTER_OVERRIDE_MARKER);
+  if (baseUrl === DEFAULT_OPENROUTER_BASE_URL) {
+    await revertOpenRouterModelsOverride(modelsPath, markerPath);
+    return;
+  }
+  let existing = {};
+  try {
+    const file = Bun.file(modelsPath);
+    if (await file.exists()) {
+      existing = JSON.parse(await file.text());
+    }
+  } catch (err2) {
+    console.warn(`[pi-mono] ${modelsPath} is unreadable/invalid (${err2 instanceof Error ? err2.message : err2}); rewriting with the OpenRouter gateway override`);
+    existing = {};
+  }
+  const providers = typeof existing.providers === "object" && existing.providers !== null ? existing.providers : {};
+  const openrouter = typeof providers.openrouter === "object" && providers.openrouter !== null ? providers.openrouter : {};
+  const priorMarker = await readJsonFile(markerPath);
+  const currentBaseUrl = typeof openrouter.baseUrl === "string" ? openrouter.baseUrl : undefined;
+  const previous = priorMarker ? priorMarker.previous : currentBaseUrl !== baseUrl ? currentBaseUrl : undefined;
+  const next = {
+    ...existing,
+    providers: {
+      ...providers,
+      openrouter: { ...openrouter, baseUrl }
+    }
+  };
+  await Bun.write(modelsPath, `${JSON.stringify(next, null, 2)}
+`);
+  const marker = {
+    baseUrl,
+    ...previous !== undefined ? { previous } : {}
+  };
+  await Bun.write(markerPath, `${JSON.stringify(marker, null, 2)}
+`);
+}
+async function revertOpenRouterModelsOverride(modelsPath, markerPath) {
+  const marker = await readJsonFile(markerPath);
+  if (!marker)
+    return;
+  const removeMarker = () => Bun.file(markerPath).delete();
+  const existing = await readJsonFile(modelsPath);
+  if (!existing) {
+    await removeMarker();
+    return;
+  }
+  const providers = typeof existing.providers === "object" && existing.providers !== null ? { ...existing.providers } : undefined;
+  const openrouter = providers && typeof providers.openrouter === "object" && providers.openrouter !== null ? { ...providers.openrouter } : undefined;
+  if (!providers || !openrouter || openrouter.baseUrl !== marker.baseUrl) {
+    await removeMarker();
+    return;
+  }
+  if (marker.previous !== undefined) {
+    openrouter.baseUrl = marker.previous;
+  } else {
+    delete openrouter.baseUrl;
+  }
+  if (Object.keys(openrouter).length === 0) {
+    delete providers.openrouter;
+  } else {
+    providers.openrouter = openrouter;
+  }
+  const next = { ...existing, providers };
+  if (Object.keys(providers).length === 0) {
+    delete next.providers;
+  }
+  if (Object.keys(next).length === 0) {
+    await Bun.file(modelsPath).delete();
+  } else {
+    await Bun.write(modelsPath, `${JSON.stringify(next, null, 2)}
+`);
+  }
+  await removeMarker();
+}
 function resolveModel(modelStr, env = process.env) {
   if (!modelStr)
     return;
@@ -161972,14 +162066,17 @@ class PiMonoAdapter {
       } catch {}
     }
     const sessionEnv = config.env ?? process.env;
-    const model = resolveModel(config.model, sessionEnv);
+    await ensureOpenRouterModelsOverride(getAgentDir(), sessionEnv);
+    const builtinModel = resolveModel(config.model, sessionEnv);
     const modelRuntime = await createPiRuntimeAuth(sessionEnv);
+    const model = builtinModel ? modelRuntime.getModel(builtinModel.provider, builtinModel.id) ?? builtinModel : builtinModel;
     const swarmExtension = createSwarmHooksExtension({
       apiUrl: config.apiUrl,
       apiKey: config.apiKey,
       agentId: config.agentId,
       taskId: config.taskId,
-      isLead: config.role === "lead"
+      isLead: config.role === "lead",
+      env: sessionEnv
     });
     const resourceLoader = new DefaultResourceLoader({
       cwd: config.cwd,
@@ -162018,6 +162115,7 @@ export {
   runBedrockSdkProbeAndEnumerate,
   resolveModel,
   extractPiAssistantText,
+  ensureOpenRouterModelsOverride,
   createPiRuntimeAuth,
   checkPiMonoCredentials,
   PiMonoSession,

package/dist/{pricing-refresh-2rqf114z.js → pricing-refresh-01kg9gky.js}

@@ -2,11 +2,11 @@ import {
   PRICING_REFRESH_INTERVAL_MS,
   refreshPricingFromModelsDev,
   startPricingRefreshLoop
-} from "./cli-b2mqkg1h.js";
-import"./cli-ghq3v4c9.js";
-import"./cli-0df2g86x.js";
+} from "./cli-j89ph4c4.js";
+import"./cli-7jb8mk4n.js";
+import"./cli-mjxnr12j.js";
 import"./cli-z2zcxes1.js";
-import"./cli-46etyprn.js";
+import"./cli-w48hgc2y.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{rbac-roles-6vtafvzb.js → rbac-roles-f9bdj93y.js}

@@ -4,9 +4,9 @@ import {
 import {
   getDb,
   init_db
-} from "./cli-0df2g86x.js";
+} from "./cli-mjxnr12j.js";
 import"./cli-z2zcxes1.js";
-import"./cli-46etyprn.js";
+import"./cli-w48hgc2y.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{rbac-roles-5wkhc8xv.js → rbac-roles-jqfp0zza.js}

@@ -7,11 +7,11 @@ import {
   getUserGrant,
   listUserRoles,
   runRbacCliCommand
-} from "./cli-7pzae66m.js";
+} from "./cli-hjq6c6vz.js";
 import"./cli-wwsaj97q.js";
-import"./cli-0df2g86x.js";
+import"./cli-mjxnr12j.js";
 import"./cli-z2zcxes1.js";
-import"./cli-46etyprn.js";
+import"./cli-w48hgc2y.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{seed-pricing-23wrb873.js → seed-pricing-z2t7rank.js}

@@ -1,10 +1,10 @@
 import {
   buildModelsDevSeedRows,
   seedPricingFromModelsDev
-} from "./cli-ghq3v4c9.js";
-import"./cli-0df2g86x.js";
+} from "./cli-7jb8mk4n.js";
+import"./cli-mjxnr12j.js";
 import"./cli-z2zcxes1.js";
-import"./cli-46etyprn.js";
+import"./cli-w48hgc2y.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{setup-6rny4fk6.js → setup-kw2ps002.js}

@@ -4,14 +4,14 @@ import {
   createDefaultMcpJson,
   createDefaultSettingsLocal,
   createHooksConfig
-} from "./cli-p9w7kb3h.js";
+} from "./cli-zpa6gjwq.js";
 import {
   require_jsx_dev_runtime
 } from "./cli-wx82tw1k.js";
 import {
   getApiKey
 } from "./cli-f14fvzag.js";
-import"./cli-46etyprn.js";
+import"./cli-w48hgc2y.js";
 import {
   Box_default,
   Spinner,

package/dist/{worker-yapewe14.js → worker-336w8930.js}

@@ -1,20 +1,20 @@
 import {
   runAgent
-} from "./cli-avw9ev3x.js";
-import"./cli-7pt9sc83.js";
+} from "./cli-wmx631p8.js";
+import"./cli-zweca3q3.js";
 import"./cli-5c4327dx.js";
 import"./cli-07er7wrs.js";
 import"./cli-tyfxrrdd.js";
-import"./cli-6s3ytc5x.js";
+import"./cli-16dv125e.js";
 import"./cli-r94z9p1z.js";
-import"./cli-dmzv0986.js";
+import"./cli-vh3h1grg.js";
 import"./cli-yv9dttkh.js";
 import"./cli-yazx6hap.js";
 import"./cli-d6n0thxw.js";
 import"./cli-v1mwc5v2.js";
 import {
   getEnabledCapabilities
-} from "./cli-gdpx70nc.js";
+} from "./cli-y3an9mk7.js";
 import"./cli-1z7048dy.js";
 import"./cli-gz9sbyk3.js";
 import"./cli-ftyf58xj.js";
@@ -25,35 +25,36 @@ import"./cli-tng3131n.js";
 import"./cli-zm7njwzd.js";
 import"./cli-cw70hymf.js";
 import"./cli-e61fs2hp.js";
-import"./cli-vg3zrw6h.js";
-import"./cli-b2mqkg1h.js";
-import"./cli-ghq3v4c9.js";
-import"./cli-7pzae66m.js";
+import"./cli-586x669g.js";
+import"./cli-j89ph4c4.js";
+import"./cli-7jb8mk4n.js";
+import"./cli-hjq6c6vz.js";
 import"./cli-wwsaj97q.js";
-import"./cli-agdrxyex.js";
-import"./cli-95rbe11h.js";
+import"./cli-haeq79yf.js";
+import"./cli-m7dmk462.js";
 import"./cli-f14fvzag.js";
-import"./cli-tv7vekye.js";
-import"./cli-072t49hf.js";
+import"./cli-3dpj7atn.js";
+import"./cli-tc8xk5zh.js";
+import"./cli-8x745f40.js";
 import"./cli-jkhwmmgg.js";
-import"./cli-5hpvd15x.js";
-import"./cli-3fxqwfh3.js";
+import"./cli-60q15ncp.js";
+import"./cli-qf0qxzw5.js";
 import"./cli-q25ejbyn.js";
-import"./cli-1728qh70.js";
+import"./cli-z3hcrghs.js";
 import"./cli-fad8m16k.js";
 import"./cli-7zd05xb4.js";
-import"./cli-g9vva2qh.js";
-import"./cli-srjqn7fd.js";
-import"./cli-s8bdcke2.js";
-import"./cli-3b1ayz83.js";
+import"./cli-fc1gvt9c.js";
+import"./cli-3ptjc655.js";
+import"./cli-00yr0kxv.js";
+import"./cli-9fhxk91h.js";
 import"./cli-rkndnn90.js";
 import"./cli-b0p7rfnd.js";
 import"./cli-ma04faw5.js";
 import"./cli-wspgs9bt.js";
 import"./cli-dh55d5fg.js";
-import"./cli-0df2g86x.js";
+import"./cli-mjxnr12j.js";
 import"./cli-z2zcxes1.js";
-import"./cli-46etyprn.js";
+import"./cli-w48hgc2y.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.121.0",
+    "version": "1.122.0",
     "description": "Multi-agent orchestration API for Claude Code, Codex, and Gemini CLI. Enables task distribution, agent communication, and service discovery.\n\nMCP tools are documented separately in [MCP.md](./MCP.md)."
   },
   "servers": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.121.0",
+  "version": "1.122.0",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",

package/src/be/memory/constants.ts

@@ -59,17 +59,18 @@ export const ACCESS_BOOST_MAX_MULTIPLIER = numEnv("MEMORY_ACCESS_BOOST_MAX", 1.5
 export const ACCESS_BOOST_RECENCY_WINDOW_HOURS = numEnv("MEMORY_ACCESS_RECENCY_HOURS", 48);
 export const CANDIDATE_SET_MULTIPLIER = numEnv("MEMORY_CANDIDATE_MULTIPLIER", 3);
 
-// Feature flag: enable hybrid (FTS+vec) search. Off by default; set MEMORY_HYBRID_SEARCH=1 to enable.
+// Feature flag: enable hybrid (FTS+vec) search. On by default; set
+// MEMORY_HYBRID_SEARCH=0|false to fall back to vector-only search.
 export function isHybridSearchEnabled(): boolean {
-  const val = process.env.MEMORY_HYBRID_SEARCH ?? "0";
-  return val === "1" || val.toLowerCase() === "true";
+  const val = process.env.MEMORY_HYBRID_SEARCH?.trim().toLowerCase();
+  return val !== "0" && val !== "false";
 }
 
 // Feature flag: expand search candidates with 1-hop memory_link graph neighbors
-// (DES-639a). Off by default; set MEMORY_GRAPH_EXPANSION=1 to enable.
+// (DES-639a). On by default; set MEMORY_GRAPH_EXPANSION=0|false to disable.
 export function isGraphExpansionEnabled(): boolean {
-  const val = process.env.MEMORY_GRAPH_EXPANSION ?? "0";
-  return val === "1" || val.toLowerCase() === "true";
+  const val = process.env.MEMORY_GRAPH_EXPANSION?.trim().toLowerCase();
+  return val !== "0" && val !== "false";
 }
 
 // Embedding defaults

package/src/be/memory/graph-expansion.ts

@@ -12,9 +12,9 @@
  * - `rerank()` stays pure (no DB access),
  * - `recordRetrievals` downstream picks up `retrievalSource: "graph"` for free.
  *
- * Flag-gated: `MEMORY_GRAPH_EXPANSION=1|true` (default off — same rollout
- * pattern as MEMORY_HYBRID_SEARCH). With the flag off the input array is
- * returned unchanged (same reference), keeping results byte-identical.
+ * Enabled by default; set `MEMORY_GRAPH_EXPANSION=0|false` to disable it.
+ * With the flag off the input array is returned unchanged (same reference),
+ * keeping results byte-identical to the vector/hybrid candidate set.
  *
  * Plan: thoughts/taras/plans/2026-07-02-memory-retrieval-v2-graph-and-measurement.md Phase 4
  */

package/src/be/memory/raters/llm-summarizer.ts

@@ -11,6 +11,7 @@
  * No `bun:sqlite` / `src/be/db` imports. Boundary script enforces this.
  */
 import { z } from "zod";
+import { getOpenRouterBaseUrl } from "../../../utils/openrouter-base-url";
 import { type SummaryWithRatings, SummaryWithRatingsSchema } from "./llm";
 
 /**
@@ -27,7 +28,14 @@ export const DEFAULT_MEMORY_RATER_MODEL = "google/gemini-3-flash-preview";
  */
 export const MEMORY_RATER_SCHEMA_NAME = "memory_rater_output";
 
-const OPENROUTER_CHAT_COMPLETIONS_URL = "https://openrouter.ai/api/v1/chat/completions";
+/**
+ * Chat-completions URL, resolved per call so `OPENROUTER_BASE_URL` (gateway
+ * routing — see `src/utils/openrouter-base-url.ts`) is honored even when it
+ * is set after module load (worker subprocess env resolution).
+ */
+function openRouterChatCompletionsUrl(): string {
+  return `${getOpenRouterBaseUrl()}/chat/completions`;
+}
 
 /**
  * JSON Schema derived from {@link SummaryWithRatingsSchema}, the source of
@@ -138,7 +146,7 @@ export async function runMemoryRater(opts: RunMemoryRaterOpts): Promise<RunMemor
 
   let res: Response;
   try {
-    res = await fetchFn(OPENROUTER_CHAT_COMPLETIONS_URL, {
+    res = await fetchFn(openRouterChatCompletionsUrl(), {
       method: "POST",
       headers: {
         "Content-Type": "application/json",

package/src/commands/provider-credentials.ts

@@ -25,6 +25,7 @@ import { checkDevinCredentials } from "../providers/devin-adapter";
 import { checkOpencodeCredentials } from "../providers/opencode-adapter";
 import type { CredCheckOptions, CredStatus } from "../providers/types";
 import type { AgentCredStatus, AgentLatestModel, ProviderName, ReasoningEffort } from "../types";
+import { getOpenRouterBaseUrl } from "../utils/openrouter-base-url";
 import { scrubSecrets } from "../utils/secret-scrubber";
 
 export type SupportedProvider = "claude" | "claude-managed" | "codex" | "devin" | "opencode" | "pi";
@@ -202,7 +203,7 @@ async function checkOpenAiApiKey(apiKey: string): Promise<LiveValidationResult>
 }
 
 async function checkOpenRouter(apiKey: string): Promise<LiveValidationResult> {
-  const r = await timedFetch("https://openrouter.ai/api/v1/models", {
+  const r = await timedFetch(`${getOpenRouterBaseUrl()}/models`, {
     method: "GET",
     headers: { Authorization: `Bearer ${apiKey}` },
   });

package/src/http/memory.ts

@@ -506,7 +506,8 @@ export async function handleMemory(
         isLead: false,
         queryText: query,
       });
-      // 1-hop memory_link neighbor expansion (no-op unless MEMORY_GRAPH_EXPANSION=1).
+      // Default-on 1-hop memory_link neighbor expansion (disable with
+      // MEMORY_GRAPH_EXPANSION=0|false).
       const expanded = expandCandidatesWithGraph(candidates, myAgentId, {
         scope,
         source,

package/src/providers/codex-adapter.ts

@@ -1301,6 +1301,9 @@ export class CodexSession implements ProviderSession {
       },
       apiUrl,
       apiKey,
+      // Per-task resolved env — swarm_config overlays (e.g.
+      // OPENROUTER_BASE_URL) never reach process.env.
+      env: this.config.env,
     });
     // null = no auth resolved or wrapper exhausted retries (already logged inside)
     if (!result) return;

package/src/providers/opencode-adapter.ts

@@ -19,6 +19,7 @@ import {
 } from "../utils/context-window";
 import { validateOpencodeCredentials } from "../utils/credentials";
 import { fetchInstalledMcpServers } from "../utils/mcp-server-fetcher";
+import { DEFAULT_OPENROUTER_BASE_URL, getOpenRouterBaseUrl } from "../utils/openrouter-base-url";
 import { scrubSecrets } from "../utils/secret-scrubber";
 import { resolveSlashSkillPrompt } from "./codex-skill-resolver";
 import { CTX_MODE_NUDGE_EVERY } from "./ctx-mode-env";
@@ -135,6 +136,31 @@ function formatUnknownError(err: unknown): string {
   return err instanceof Error ? err.message : String(err);
 }
 
+/**
+ * Route OpenRouter traffic through the configured gateway (see
+ * src/utils/openrouter-base-url.ts). opencode's bundled openrouter provider
+ * honors `provider.openrouter.options.baseURL`. Mutates `opencodeConfig` in
+ * place; no-op when `OPENROUTER_BASE_URL` is unset/blank/default, so default
+ * openrouter.ai behavior is preserved. Exported for tests.
+ */
+export function applyOpenRouterBaseUrlOverride(
+  opencodeConfig: Config,
+  env: Record<string, string | undefined> = process.env,
+): void {
+  const openRouterBaseUrl = getOpenRouterBaseUrl(env as NodeJS.ProcessEnv);
+  if (openRouterBaseUrl === DEFAULT_OPENROUTER_BASE_URL) return;
+  opencodeConfig.provider = {
+    ...opencodeConfig.provider,
+    openrouter: {
+      ...opencodeConfig.provider?.openrouter,
+      options: {
+        ...opencodeConfig.provider?.openrouter?.options,
+        baseURL: openRouterBaseUrl,
+      },
+    },
+  };
+}
+
 async function refreshOpenRouterModelCache(
   opencodeConfig: Config & { plugin?: string[] },
   configFilePath: string,
@@ -726,6 +752,8 @@ export class OpencodeAdapter implements ProviderAdapter {
       };
     }
 
+    applyOpenRouterBaseUrlOverride(opencodeConfig, config.env ?? process.env);
+
     // Write per-task config file
     try {
       await Bun.write(configFilePath, JSON.stringify(opencodeConfig, null, 2));
@@ -743,12 +771,24 @@ export class OpencodeAdapter implements ProviderAdapter {
       SWARM_AGENT_ID: process.env.SWARM_AGENT_ID,
       SWARM_TASK_ID: process.env.SWARM_TASK_ID,
       SWARM_IS_LEAD: process.env.SWARM_IS_LEAD,
+      OPENROUTER_BASE_URL: process.env.OPENROUTER_BASE_URL,
     };
     process.env.SWARM_API_URL = config.apiUrl;
     process.env.SWARM_API_KEY = config.apiKey;
     process.env.SWARM_AGENT_ID = config.agentId;
     process.env.SWARM_TASK_ID = config.taskId;
     process.env.SWARM_IS_LEAD = config.role === "lead" ? "true" : "false";
+    // Mirror the resolved OpenRouter gateway into the spawn env: the
+    // summarize plugin (and any other plugin OpenRouter fetch) reads its own
+    // process.env inside the opencode subprocess, which inherits OURS — a
+    // per-task swarm_config value in `config.env` would otherwise be
+    // invisible there and the plugin would bypass the gateway.
+    const spawnOpenRouterBaseUrl = getOpenRouterBaseUrl(
+      (config.env ?? process.env) as NodeJS.ProcessEnv,
+    );
+    if (spawnOpenRouterBaseUrl !== DEFAULT_OPENROUTER_BASE_URL) {
+      process.env.OPENROUTER_BASE_URL = spawnOpenRouterBaseUrl;
+    }
     process.env.CONTEXT_MODE_EXTERNAL_MCP_NUDGE_EVERY = CTX_MODE_NUDGE_EVERY;
 
     // Set OPENCODE_CONFIG scoped to the spawn call (save + restore)