archymedes-cli 3.3.0 → 3.4.0

package/dist/{archymedes-j0vrbr99.mjs → archymedes-ds224xzf.mjs}

@@ -8446,7 +8446,48 @@ function repeatedFailureHint(toolName, failures, missingPathStreak) {
   return null;
 }
 var MAX_VERIFICATION_NUDGES = 1;
-var MAX_UNAVAILABLE_TOOL_RECOVERIES = 1;
+var MAX_UNAVAILABLE_TOOL_RECOVERIES = 3;
+function suggestTools(name, tools) {
+  const words = name.toLowerCase().split(/[^a-z0-9]+/).filter((word) => word.length > 2);
+  const scored = tools.map((tool) => {
+    const own = tool.name.toLowerCase();
+    const ownWords = own.split(/[^a-z0-9]+/);
+    const description = tool.description.toLowerCase();
+    let score = 0;
+    for (const word of words) {
+      if (ownWords.includes(word))
+        score += 3;
+      else if (own.includes(word))
+        score += 2;
+      else if (new RegExp(`\\b${word}`).test(description))
+        score += 1;
+    }
+    if (score === 0 && editDistance(name.toLowerCase(), own) <= 2)
+      score = 2;
+    return { name: tool.name, score };
+  });
+  return scored.filter((entry) => entry.score > 0).sort((a, b) => b.score - a.score || a.name.localeCompare(b.name)).slice(0, 2).map((entry) => entry.name);
+}
+function editDistance(a, b) {
+  if (Math.abs(a.length - b.length) > 2)
+    return 3;
+  let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+  for (let i = 1;i <= a.length; i += 1) {
+    const current = [i];
+    for (let j = 1;j <= b.length; j += 1) {
+      current[j] = Math.min(previous[j] + 1, current[j - 1] + 1, previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+    }
+    previous = current;
+  }
+  return previous[b.length];
+}
+function unavailableToolMessage(name, exists, available) {
+  const names = available.map((tool) => tool.name);
+  const closest = suggestTools(name, available);
+  const head = exists ? `${name} is not allowed in this run (the current mode does not include it).` : `There is no tool named "${name}".`;
+  const hint = closest.length > 0 ? ` The closest: ${closest.join(" or ")}.` : "";
+  return `${head}${hint} Tools you can call: ${names.join(", ")}. Use one of them, or answer without a tool.`;
+}
 var PROVIDER_BACKOFF_BASE_MS = 1000;
 var PROVIDER_BACKOFF_CAP_MS = 30000;
 var PROVIDER_RETRY_AFTER_CAP_MS = 60000;
@@ -8774,6 +8815,7 @@ class BoundedAgentRuntime {
     let workspaceNeedsVerification = false;
     let verificationNudges = 0;
     let unavailableToolRecoveries = 0;
+    let lastUnavailable = "";
     let toolTurnRecoveries = 0;
     let lengthContinuations = 0;
     let strongestEvidence = 0;
@@ -8964,6 +9006,7 @@ ${compactedToolResult(entry.name, 0, undefined, images)}` : compactedToolResult(
           return false;
         toolTurnRecoveries += 1;
         messages.push({ role: "user", content: `${reason} ${instruction}`, internal: true });
+        lastOutcomes = [{ tool: "(malformed call)", isError: true, shallow: true }];
         return true;
       };
       if (turn.finishReason !== "tool_calls" || turn.toolCalls.length === 0) {
@@ -8995,10 +9038,12 @@ ${compactedToolResult(entry.name, 0, undefined, images)}` : compactedToolResult(
         return !tool || !capabilities.has(tool.capabilityId);
       });
       if (unavailable) {
-        if (unavailableToolRecoveries >= MAX_UNAVAILABLE_TOOL_RECOVERIES) {
+        if (unavailable.name === lastUnavailable || unavailableToolRecoveries >= MAX_UNAVAILABLE_TOOL_RECOVERIES) {
           return stop("failed", `Tool ${unavailable.name} is outside the run capability scope.`, iteration);
         }
         unavailableToolRecoveries += 1;
+        lastUnavailable = unavailable.name;
+        lastOutcomes = [{ tool: unavailable.name, isError: true, shallow: true }];
         messages.push({ role: "assistant", content: turn.content, toolCalls: turn.toolCalls });
         for (const call of turn.toolCalls) {
           messages.push({
@@ -9006,11 +9051,13 @@ ${compactedToolResult(entry.name, 0, undefined, images)}` : compactedToolResult(
             toolCallId: call.id,
             name: call.name,
             internal: true,
-            content: call.id === unavailable.id ? `Tool ${call.name} is unavailable in the current mode. Continue with the listed tools, or answer without it.` : "This batch was not executed because another call was unavailable. Retry any still-needed available call separately."
+            content: call.id === unavailable.id ? unavailableToolMessage(call.name, this.toolsByName.has(call.name), tools) : "This batch was not executed because another call was unavailable. Retry any still-needed available call separately."
           });
         }
         continue;
       }
+      unavailableToolRecoveries = 0;
+      lastUnavailable = "";
       const prepared = [];
       for (const call of turn.toolCalls) {
         const tool = this.toolsByName.get(call.name);
@@ -9091,7 +9138,7 @@ ${compactedToolResult(entry.name, 0, undefined, images)}` : compactedToolResult(
           const signature = `${call.name}:${JSON.stringify(call.arguments ?? {})}`;
           const failures = (failedCalls.get(signature) ?? 0) + 1;
           failedCalls.set(signature, failures);
-          missingPathStreak = /does not exist|No such file|not found/i.test(raw) ? missingPathStreak + 1 : 0;
+          missingPathStreak = /does not exist|No such file or directory|ENOENT/i.test(raw) ? missingPathStreak + 1 : 0;
           const hint = repeatedFailureHint(call.name, failures, missingPathStreak);
           if (hint)
             content = `${content}
@@ -9105,6 +9152,7 @@ ${hint}`;
         if (!result.isError && effect === "workspace") {
           workspaceNeedsVerification = true;
           greenSinceEdit = false;
+          failedCalls.clear();
         }
         lastOutcomes.push({
           tool: call.name,

package/dist/archymedes-main.mjs

@@ -44,7 +44,7 @@ import {
   wanderGradeCounts,
   wanderPlannerInstructions,
   withOpenRouterCacheControl
-} from "./archymedes-j0vrbr99.mjs";
+} from "./archymedes-ds224xzf.mjs";
 import {
   __require
 } from "./archymedes-x67v3n58.mjs";
@@ -8028,7 +8028,7 @@ var TEST_COMMAND = /\b(tests?|pytest|jest|vitest|mocha|jasmine|karma|ava|rspec|m
 var CHECK_COMMAND = /\b(typecheck|tsc|lint|eslint|pylint|ruff|flake8|mypy|pyright|check|build|compile|py_compile|vet|clippy|rubocop|audit|fmt|format)\b/i;
 var BEHAVIOR_COMMAND = /\b(e2e|end-to-end|playwright|cypress|puppeteer|selenium|webdriver|testcafe|nightwatch|integration|behave|cucumber|supertest|testcontainers)\b/i;
 var SMOKE_COMMAND = /\b(smoke|healthcheck|health[-_ ]?check|curl|wget|httpie|\bhttp\s+(?:get|post)\b|playwright\s+screenshot)\b/i;
-var PERSISTENT_COMMAND = /(?:^|(?:&&|;|\|)\s*)(?:(?:npm|pnpm|yarn|bun)\s+(?:run\s+)?(?:dev|start|serve)(?:\s|$)|(?:vite|next\s+dev|webpack\s+serve)(?:\s|$)|bun\s+run\s+--hot\b)|(?:^|\s)--watch(?:\s|$)|\b(?:tsc|jest|vitest|mocha|sass|tailwindcss|esbuild|webpack|rollup|nodemon|parcel|tsup|swc)\b[^|;&\n]*\s-w(?:\s|$)/i;
+var PERSISTENT_COMMAND = /(?:^|(?:&&|;|\|)\s*)(?:(?:npm|pnpm|yarn|bun)\s+(?:run\s+)?(?:dev|start|serve)(?:\s|$)|(?:vite|next\s+dev|webpack\s+serve)(?:\s|$)|bun\s+run\s+--hot\b)|(?:^|\s)--watch(?:\s|$)|\b(?:tsc|vitest|mocha|tailwindcss|webpack|rollup|nodemon|tsup|swc)\b[^|;&\n]*\s-w(?:\s|$)/i;
 var CD_PREFIX = /^\s*cd\s+(?:[^&\n|;]|\&(?!\&))+&&\s*/;
 function verificationTarget(command) {
   let target = command;
@@ -10386,10 +10386,12 @@ class ArchymedesAgent {
   get todos() {
     return this.todoList.list();
   }
-  diffPatch() {
+  async diffPatch() {
+    await this.pendingCheckpoint;
     return this.checkpoints.diffPatch();
   }
-  diffStat() {
+  async diffStat() {
+    await this.pendingCheckpoint;
     return this.checkpoints.diffStat();
   }
   listFiles(pattern = "**/*") {
@@ -10501,6 +10503,7 @@ class ArchymedesAgent {
     if (this.turnAbort)
       throw new Error("Cannot undo while a turn is running");
     await this.acquireOwnership();
+    await this.pendingCheckpoint;
     const checkpoint = this.checkpoints.latest();
     if (!checkpoint)
       return;
@@ -10652,6 +10655,7 @@ ${requested}` : requested;
         }).catch(() => {
           return;
         });
+        this.pendingCheckpoint = checkpointReady;
       }
       const compaction = await this.compactIfNeeded(turnId, objective, turnAbort.signal, tokenSaver);
       compactionActualRwf = compaction.actualRwf;
@@ -10660,10 +10664,10 @@ ${requested}` : requested;
       const runtime = new BoundedAgentRuntime({
         model: this.recovery.wrap(this.options.model, () => this.session, this.options.prices, "main"),
         ...this.options.reasoning === "auto" ? { effortPolicy: (signals) => predictEffort({ ...signals, objective, ...this.jevDifficulty ? { difficultyHint: this.jevDifficulty } : {} }) } : {},
-        tools: scoped.map((tool) => tool.effect === "none" ? tool : { ...tool, execute: async (args, context) => {
+        tools: scoped.map((tool) => ({ ...tool, execute: async (args, context) => {
           await checkpointReady;
           return tool.execute(args, context);
-        } }),
+        } })),
         prices: this.options.prices,
         artifacts: this.artifacts,
         control: {
@@ -10824,6 +10828,7 @@ ${hookWarnings.join(`
     return (verdict.outcomeProbabilities[verdict.outcome] ?? 0) >= 0.5;
   }
   jevCorrectionDepth = 0;
+  pendingCheckpoint = Promise.resolve();
   jevDifficulty;
   difficultyStamp = 0;
   startDifficultyReading(objective, signal) {
@@ -12491,6 +12496,8 @@ async function readBody(response) {
 }
 
 // ../core/src/providers/request-pacer.ts
+var MIN_LEARNABLE_CAP = 8;
+var LEARNED_CAP_LIFETIME_WINDOWS = 5;
 var DEFAULTS = { baseGapMs: 2000, maxGapMs: 120000, releaseMs: 500 };
 
 class RequestPacer {
@@ -12501,6 +12508,8 @@ class RequestPacer {
   releaseMs;
   windowMs;
   cap;
+  configuredCap;
+  learnedAt = 0;
   starts = [];
   now;
   sleep;
@@ -12510,6 +12519,7 @@ class RequestPacer {
     this.releaseMs = options.releaseMs ?? DEFAULTS.releaseMs;
     this.windowMs = options.windowMs ?? 60000;
     this.cap = options.windowCap !== undefined && options.windowCap >= 1 ? Math.floor(options.windowCap) : undefined;
+    this.configuredCap = this.cap;
     this.now = options.now ?? Date.now;
     this.sleep = options.sleep ?? ((delayMs, signal) => new Promise((resolve, reject) => {
       if (signal?.aborted) {
@@ -12546,6 +12556,10 @@ class RequestPacer {
   }
   async wait(signal) {
     signal?.throwIfAborted();
+    if (this.learnedAt > 0 && this.now() - this.learnedAt > LEARNED_CAP_LIFETIME_WINDOWS * this.windowMs) {
+      this.cap = this.configuredCap;
+      this.learnedAt = 0;
+    }
     if (this.cap !== undefined) {
       for (;; ) {
         const now = this.now();
@@ -12573,8 +12587,10 @@ class RequestPacer {
   reportRateLimited(retryAfterMs) {
     this.prune(this.now());
     const admitted = this.starts.length - 1;
-    if (admitted >= 2)
-      this.cap = Math.min(this.cap ?? Number.POSITIVE_INFINITY, admitted);
+    if (admitted >= MIN_LEARNABLE_CAP && admitted < (this.cap ?? Number.POSITIVE_INFINITY)) {
+      this.cap = admitted;
+      this.learnedAt = this.now();
+    }
     const doubled = this.gapMs <= 0 ? this.baseGapMs : Math.min(this.maxGapMs, this.gapMs * 2);
     const asked = typeof retryAfterMs === "number" && Number.isFinite(retryAfterMs) && retryAfterMs > 0 ? retryAfterMs : 0;
     this.gapMs = Math.min(this.maxGapMs, Math.max(doubled, Math.min(this.maxGapMs, asked)));
@@ -15438,65 +15454,6 @@ async function showFreePrivacyNoticeOnce(options) {
   return next;
 }
 
-// src/app/acp-setup.ts
-var KEY_URLS = {
-  free: OPENROUTER_KEYS_URL2,
-  openrouter: OPENROUTER_KEYS_URL2,
-  anthropic: "https://console.anthropic.com/settings/keys",
-  openai: "https://platform.openai.com/api-keys",
-  google: "https://aistudio.google.com/apikey",
-  xai: "https://console.x.ai",
-  deepseek: "https://platform.deepseek.com/api_keys",
-  mistral: "https://console.mistral.ai/api-keys",
-  groq: "https://console.groq.com/keys"
-};
-var ORDER = ["free", ...PROVIDER_IDS.filter((id) => id !== "free")];
-function setupStatus(environment, requested = {}) {
-  const resolved = resolveProvider(environment, requested);
-  const providers = ORDER.map((id) => {
-    const info = PROVIDER_INFO[id];
-    const keyOnly = info.requires.length === 1 && SETTING_FIELDS.some((field) => field.key === info.requires[0]);
-    return {
-      id,
-      label: info.label,
-      ...keyOnly ? { keyVariable: info.requires[0] } : {},
-      ...KEY_URLS[id] ? { keyUrl: KEY_URLS[id] } : {},
-      configured: missingRequirements(id, environment).length === 0
-    };
-  });
-  return "error" in resolved ? { configured: false, reason: resolved.error, providers } : { configured: true, providers };
-}
-async function saveSetup(params, deps) {
-  const provider = typeof params.provider === "string" ? params.provider : "";
-  const raw = typeof params.key === "string" ? params.key.trim() : "";
-  if (!isProviderId(provider))
-    return { ok: false, error: `Unknown provider "${provider}".` };
-  const target = setupStatus(deps.environment).providers.find((candidate) => candidate.id === provider);
-  if (!target?.keyVariable)
-    return { ok: false, error: `${PROVIDER_INFO[provider].label} needs more than a key; run archymedes settings.` };
-  if (!raw)
-    return { ok: false, error: "The key is empty." };
-  let key;
-  try {
-    key = validateSetting(target.keyVariable, raw);
-  } catch (error) {
-    return { ok: false, error: error instanceof Error ? error.message : String(error) };
-  }
-  let note;
-  if (provider === "free" || provider === "openrouter") {
-    const result = await (deps.checkOpenRouter ?? ((value) => checkOpenRouterKey(value)))(key);
-    if (!result.ok && result.reason === "invalid")
-      return { ok: false, error: describeKeyCheckFailure(result) };
-    if (!result.ok)
-      note = `${describeKeyCheckFailure(result)} Saved anyway; the first request will confirm it.`;
-  }
-  const current = await (deps.load ?? (() => loadSettings(deps.processEnvironment)))();
-  const settings = { ...current, [target.keyVariable]: key, ARCHYMEDES_PROVIDER: provider };
-  const file = await (deps.save ?? ((value) => saveSettings(value, deps.processEnvironment)))(settings);
-  Object.assign(deps.environment, mergedEnvironment(settings, deps.processEnvironment));
-  return { ok: true, file, ...note ? { note } : {} };
-}
-
 // ../core/src/providers/model-fetch.ts
 import { promises as fs16 } from "node:fs";
 import path21 from "node:path";
@@ -15699,6 +15656,205 @@ function fetchableProviders(environment, providers) {
   return providers.filter((provider) => provider !== "archymedes-cloud" && missingRequirements(provider, environment).length === 0);
 }
 
+// src/app/acp-connect.ts
+var DEFAULT_BASE_URLS = {
+  anthropic: "https://api.anthropic.com",
+  openai: "https://api.openai.com/v1",
+  openrouter: "https://openrouter.ai/api/v1",
+  google: "https://generativelanguage.googleapis.com/v1beta/openai",
+  xai: "https://api.x.ai/v1",
+  deepseek: "https://api.deepseek.com/v1",
+  mistral: "https://api.mistral.ai/v1",
+  groq: "https://api.groq.com/openai/v1",
+  ollama: "http://localhost:11434/v1"
+};
+var fieldSpec = (key) => SETTING_FIELDS.find((field) => field.key === key);
+function providerFields(provider, environment) {
+  const required = PROVIDER_INFO[provider].requires;
+  const baseUrl = provider === "free" ? undefined : `${providerEnvPrefix(provider)}_BASE_URL`;
+  const keys = [...required, ...baseUrl && !required.includes(baseUrl) && fieldSpec(baseUrl) ? [baseUrl] : []];
+  return keys.flatMap((key) => {
+    const spec = fieldSpec(key);
+    if (!spec)
+      return [];
+    const secret = "secret" in spec && spec.secret === true;
+    const url = "url" in spec && spec.url === true;
+    const value = environment[key]?.trim() ?? "";
+    const placeholder = url ? DEFAULT_BASE_URLS[provider] ?? "https://…/v1" : undefined;
+    return [{
+      key: spec.key,
+      label: spec.label,
+      kind: secret ? "secret" : url ? "url" : "text",
+      required: required.includes(key),
+      isSet: value !== "",
+      value: secret && value ? maskSetting(value) : value,
+      ...placeholder ? { placeholder } : {}
+    }];
+  });
+}
+var refused = (error) => /\b40[13]\b/.test(error ?? "");
+async function connectProvider(params, deps) {
+  const provider = typeof params.provider === "string" ? params.provider : "";
+  if (!isProviderId(provider))
+    return { ok: false, error: `Unknown provider "${provider}".` };
+  const label3 = PROVIDER_INFO[provider].label;
+  const values = params.values && typeof params.values === "object" ? params.values : {};
+  const fields = providerFields(provider, deps.environment);
+  const current = await (deps.load ?? (() => loadSettings(deps.processEnvironment)))();
+  const next = { ...current };
+  for (const field of fields) {
+    const raw = typeof values[field.key] === "string" ? values[field.key].trim() : undefined;
+    if (raw === undefined || raw === "") {
+      if (field.kind === "url" && raw === "")
+        delete next[field.key];
+      continue;
+    }
+    try {
+      next[field.key] = validateSetting(field.key, raw);
+    } catch (error) {
+      return { ok: false, field: field.key, error: error instanceof Error ? error.message : String(error) };
+    }
+  }
+  const candidate = mergedEnvironment(next, deps.processEnvironment);
+  const missing = missingRequirements(provider, candidate);
+  if (missing.length > 0)
+    return { ok: false, field: missing[0], error: `${label3} still needs ${missing.join(" and ")}.` };
+  const keyField = fields.find((field) => field.kind === "secret")?.key;
+  let note;
+  if ((provider === "free" || provider === "openrouter") && candidate.OPENROUTER_API_KEY) {
+    const check = await (deps.checkOpenRouter ?? ((value) => checkOpenRouterKey(value)))(candidate.OPENROUTER_API_KEY);
+    if (!check.ok && check.reason === "invalid")
+      return { ok: false, field: keyField, error: describeKeyCheckFailure(check) };
+    if (!check.ok)
+      note = `${describeKeyCheckFailure(check)} Saved anyway; the first request will confirm it.`;
+  }
+  const fetchImpl = deps.fetchImpl ?? globalThis.fetch;
+  const listed = await fetchProviderModels(provider, candidate, fetchImpl, 8000);
+  if (listed.models.length === 0 && refused(listed.error)) {
+    return { ok: false, field: keyField, error: `${label3} refused the key (${listed.error}). Check it and paste it again.` };
+  }
+  if (listed.models.length === 0) {
+    note = note ?? `Could not list ${label3}'s models (${listed.error ?? "none returned"}). Saved; check the base URL if this persists.`;
+  }
+  const file = await (deps.save ?? ((value) => saveSettings(value, deps.processEnvironment)))(next);
+  Object.assign(deps.environment, mergedEnvironment(next, deps.processEnvironment));
+  if (listed.models.length > 0)
+    await rememberModels(provider, listed.models, deps.environment);
+  return { ok: true, file, models: listed.models, ...note ? { note } : {} };
+}
+async function providerModels(params, deps) {
+  const provider = typeof params.provider === "string" ? params.provider : "";
+  if (!isProviderId(provider))
+    return { models: [], error: `Unknown provider "${provider}".` };
+  const fetchImpl = deps.fetchImpl ?? globalThis.fetch;
+  const listed = await fetchProviderModels(provider, deps.environment, fetchImpl, 8000);
+  if (listed.models.length > 0)
+    await rememberModels(provider, listed.models, deps.environment);
+  return { models: listed.models, ...listed.error ? { error: listed.error } : {} };
+}
+async function rememberModels(provider, models, environment) {
+  try {
+    const cache = await readModelCache(environment);
+    await writeModelCache(environment, {
+      fetchedAt: cache?.fetchedAt ?? Date.now(),
+      ...cache?.freeCatalog ? { freeCatalog: cache.freeCatalog } : {},
+      models: { ...cache?.models ?? {}, [provider]: models }
+    });
+  } catch {}
+}
+async function rememberModel(params, deps) {
+  const provider = typeof params.provider === "string" ? params.provider : "";
+  const model = typeof params.model === "string" ? params.model.trim() : "";
+  if (!isProviderId(provider) || !model)
+    return { ok: false, error: "A provider and a model are needed." };
+  const key = `${providerEnvPrefix(provider)}_MODEL`;
+  if (!fieldSpec(key))
+    return { ok: true };
+  let value;
+  try {
+    value = validateSetting(key, model);
+  } catch (error) {
+    return { ok: false, error: error instanceof Error ? error.message : String(error) };
+  }
+  const current = await (deps.load ?? (() => loadSettings(deps.processEnvironment)))();
+  const next = { ...current, [key]: value };
+  await (deps.save ?? ((settings) => saveSettings(settings, deps.processEnvironment)))(next);
+  Object.assign(deps.environment, mergedEnvironment(next, deps.processEnvironment));
+  return { ok: true };
+}
+
+// src/app/acp-setup.ts
+var KEY_URLS = {
+  free: OPENROUTER_KEYS_URL2,
+  openrouter: OPENROUTER_KEYS_URL2,
+  anthropic: "https://console.anthropic.com/settings/keys",
+  openai: "https://platform.openai.com/api-keys",
+  google: "https://aistudio.google.com/apikey",
+  xai: "https://console.x.ai",
+  deepseek: "https://platform.deepseek.com/api_keys",
+  mistral: "https://console.mistral.ai/api-keys",
+  groq: "https://console.groq.com/keys"
+};
+var ORDER = ["free", ...PROVIDER_IDS.filter((id) => id !== "free")];
+function setupStatus(environment, requested = {}) {
+  const resolved = resolveProvider(environment, requested);
+  const providers = ORDER.map((id) => {
+    const info = PROVIDER_INFO[id];
+    const keyOnly = info.requires.length === 1 && SETTING_FIELDS.some((field) => field.key === info.requires[0]);
+    return {
+      id,
+      label: info.label,
+      ...keyOnly ? { keyVariable: info.requires[0] } : {},
+      ...KEY_URLS[id] ? { keyUrl: KEY_URLS[id] } : {},
+      configured: missingRequirements(id, environment).length === 0
+    };
+  });
+  return "error" in resolved ? { configured: false, reason: resolved.error, providers } : { configured: true, providers };
+}
+async function saveSetup(params, deps) {
+  const provider = typeof params.provider === "string" ? params.provider : "";
+  const raw = typeof params.key === "string" ? params.key.trim() : "";
+  if (!isProviderId(provider))
+    return { ok: false, error: `Unknown provider "${provider}".` };
+  const target = setupStatus(deps.environment).providers.find((candidate) => candidate.id === provider);
+  if (!target?.keyVariable)
+    return { ok: false, error: `${PROVIDER_INFO[provider].label} needs more than a key; run archymedes settings.` };
+  if (!raw)
+    return { ok: false, error: "The key is empty." };
+  let key;
+  try {
+    key = validateSetting(target.keyVariable, raw);
+  } catch (error) {
+    return { ok: false, error: error instanceof Error ? error.message : String(error) };
+  }
+  let note;
+  if (provider === "free" || provider === "openrouter") {
+    const result = await (deps.checkOpenRouter ?? ((value) => checkOpenRouterKey(value)))(key);
+    if (!result.ok && result.reason === "invalid")
+      return { ok: false, error: describeKeyCheckFailure(result) };
+    if (!result.ok)
+      note = `${describeKeyCheckFailure(result)} Saved anyway; the first request will confirm it.`;
+  }
+  const current = await (deps.load ?? (() => loadSettings(deps.processEnvironment)))();
+  const settings = { ...current, [target.keyVariable]: key, ARCHYMEDES_PROVIDER: provider };
+  const file = await (deps.save ?? ((value) => saveSettings(value, deps.processEnvironment)))(settings);
+  Object.assign(deps.environment, mergedEnvironment(settings, deps.processEnvironment));
+  return { ok: true, file, ...note ? { note } : {} };
+}
+function providerOverview(environment) {
+  const preferred = environment.ARCHYMEDES_PROVIDER?.trim().toLowerCase();
+  return setupStatus(environment).providers.map((provider) => {
+    const info = PROVIDER_INFO[provider.id];
+    return {
+      ...provider,
+      missing: missingRequirements(provider.id, environment),
+      model: environment[`${providerEnvPrefix(provider.id)}_MODEL`]?.trim() || info.defaultModel,
+      isDefault: preferred === provider.id,
+      fields: providerFields(provider.id, environment)
+    };
+  });
+}
+
 // src/session/models.ts
 function modelsForProvider(provider, asOf) {
   const seen = new Set;
@@ -16380,7 +16536,7 @@ function escapeCodeTimeoutMs(environment = process.env) {
 // package.json
 var package_default = {
   name: "archymedes-cli",
-  version: "3.3.0",
+  version: "3.4.0",
   description: "Archymedes CLI — a coding agent that shows its work. Runs against your working tree or an isolated remote sandbox, with guarded approvals, git checkpoints, and exact, measured cost accounting.",
   keywords: [
     "cli",
@@ -16426,12 +16582,12 @@ var package_default = {
     prepublishOnly: "bun run ../../tooling/build/build-packages.ts"
   },
   optionalDependencies: {
-    "@archymedes/cli-darwin-arm64": "3.3.0",
-    "@archymedes/cli-darwin-x64": "3.3.0",
-    "@archymedes/cli-linux-arm64": "3.3.0",
-    "@archymedes/cli-linux-x64": "3.3.0",
-    "@archymedes/cli-win32-arm64": "3.3.0",
-    "@archymedes/cli-win32-x64": "3.3.0",
+    "@archymedes/cli-darwin-arm64": "3.4.0",
+    "@archymedes/cli-darwin-x64": "3.4.0",
+    "@archymedes/cli-linux-arm64": "3.4.0",
+    "@archymedes/cli-linux-x64": "3.4.0",
+    "@archymedes/cli-win32-arm64": "3.4.0",
+    "@archymedes/cli-win32-x64": "3.4.0",
     "@archymedes/state-darwin-arm64": "0.4.0",
     "@archymedes/state-darwin-x64": "0.4.0",
     "@archymedes/state-linux-arm64-gnu": "0.4.0",
@@ -19554,6 +19710,10 @@ async function runAcpServer(options) {
   const connection = new AcpConnection({
     send,
     extensions: {
+      "_archymedes/providers": async () => ({ providers: providerOverview(options.environment) }),
+      "_archymedes/providers/connect": async (params) => connectProvider(params, { environment: options.environment, processEnvironment: process.env }),
+      "_archymedes/providers/models": async (params) => providerModels(params, { environment: options.environment }),
+      "_archymedes/providers/remember-model": async (params) => rememberModel(params, { environment: options.environment, processEnvironment: process.env }),
       "_archymedes/setup/status": async () => setupStatus(options.environment, { provider: options.provider, model: options.model }),
       "_archymedes/setup/save": async (params) => saveSetup(params, { environment: options.environment, processEnvironment: process.env }),
       "_archymedes/settings/list": async () => listSettings(process.env),
@@ -25336,7 +25496,7 @@ function createWorkspaceFactory(args, environment) {
     const minutes = Math.max(1, Math.min(args.sandboxMinutes, 60));
     if (request.backend === "e2b") {
       const { findWorkspacePreset } = await import("./sandbox-templates-9jcjws23.mjs");
-      const { createE2BProvider } = await import("./factory-r6r0ypm6.mjs");
+      const { createE2BProvider } = await import("./factory-xpqqcyqq.mjs");
       const preset = findWorkspacePreset(request.preset ?? args.preset);
       const sandbox = createE2BProvider(environment, preset.templateAlias);
       if (!sandbox)
@@ -25362,7 +25522,7 @@ function createWorkspaceFactory(args, environment) {
       return { workspace: created };
     }
     if (request.backend === "docker") {
-      const { createDockerProvider } = await import("./factory-r6r0ypm6.mjs");
+      const { createDockerProvider } = await import("./factory-xpqqcyqq.mjs");
       const image = request.dockerImage || args.dockerImage || environment.DOCKER_CODING_IMAGE;
       const sandbox = createDockerProvider({ ...environment, DOCKER_CODING_IMAGE: image });
       if (!sandbox)

package/dist/{factory-r6r0ypm6.mjs → factory-xpqqcyqq.mjs}

@@ -6,7 +6,7 @@ import {
   makeParseableTextFormat,
   modelPricesFromEnvironment,
   wanderPlannerInstructions
-} from "./archymedes-j0vrbr99.mjs";
+} from "./archymedes-ds224xzf.mjs";
 import {
   ALLOWED_GIT_SUBCOMMANDS,
   ALLOWED_SANDBOX_PROGRAMS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archymedes-cli",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Archymedes CLI \u2014 a coding agent that shows its work. Runs against your working tree or an isolated remote sandbox, with guarded approvals, git checkpoints, and exact, measured cost accounting.",
   "keywords": [
     "cli",
@@ -46,12 +46,12 @@
     "prepublishOnly": "bun run ../../tooling/build/build-packages.ts"
   },
   "optionalDependencies": {
-    "@archymedes/cli-darwin-arm64": "3.3.0",
-    "@archymedes/cli-darwin-x64": "3.3.0",
-    "@archymedes/cli-linux-arm64": "3.3.0",
-    "@archymedes/cli-linux-x64": "3.3.0",
-    "@archymedes/cli-win32-arm64": "3.3.0",
-    "@archymedes/cli-win32-x64": "3.3.0",
+    "@archymedes/cli-darwin-arm64": "3.4.0",
+    "@archymedes/cli-darwin-x64": "3.4.0",
+    "@archymedes/cli-linux-arm64": "3.4.0",
+    "@archymedes/cli-linux-x64": "3.4.0",
+    "@archymedes/cli-win32-arm64": "3.4.0",
+    "@archymedes/cli-win32-x64": "3.4.0",
     "@archymedes/state-darwin-arm64": "0.4.0",
     "@archymedes/state-darwin-x64": "0.4.0",
     "@archymedes/state-linux-arm64-gnu": "0.4.0",