@tangle-network/agent-app 0.44.23 → 0.44.25

package/dist/chat-routes/index.js

@@ -93,7 +93,7 @@ import {
   flattenHistory,
   readSandboxBinaryBytes,
   statSandboxFileSize
-} from "../chunk-2ZSSOYXP.js";
+} from "../chunk-Q74BS43G.js";
 import "../chunk-LWSJK546.js";
 import "../chunk-CQZSAR77.js";
 import "../chunk-ICOHEZK6.js";

package/dist/{chunk-2ZSSOYXP.js → chunk-Q74BS43G.js}

@@ -32,6 +32,75 @@ var fail = (error) => ({
   error: error instanceof Error ? error : new Error(String(error))
 });
 
+// src/sandbox/model.ts
+function resolveModelSelection(config, override) {
+  const c = config ?? {};
+  const explicitBaseUrl = trimOrNull(c.routerBaseUrl);
+  const explicitApiKey = trimOrNull(override?.modelApiKey) ?? trimOrNull(c.apiKey);
+  const providerName = trimOrNull(c.providerName);
+  const openaiApiKey = trimOrNull(c.openaiApiKey);
+  const provider = providerName ?? (explicitApiKey ? "openai-compat" : openaiApiKey ? "openai" : void 0);
+  const overrideModel = trimOrNull(override?.model);
+  const configModel = trimOrNull(c.modelName);
+  const defaultModel = trimOrNull(c.defaultModel);
+  const modelName = overrideModel ?? configModel ?? (provider === "openai" || provider === "openai-compat" ? defaultModel : null);
+  if (!modelName) return { succeeded: true, value: void 0 };
+  const source = overrideModel ? "override" : configModel ? "config" : "default";
+  if (!provider) return { succeeded: false, error: "no_provider", model: modelName, source };
+  const apiKey = explicitApiKey ?? (provider === "openai" ? openaiApiKey : void 0);
+  if (!apiKey && !c.allowKeylessModel) {
+    return { succeeded: false, error: "no_api_key", model: modelName, provider, source };
+  }
+  return {
+    succeeded: true,
+    value: {
+      model: modelName,
+      provider,
+      ...apiKey ? { apiKey } : {},
+      ...explicitBaseUrl ? { baseUrl: explicitBaseUrl } : {}
+    }
+  };
+}
+function resolveModel(config, override) {
+  const selection = resolveModelSelection(config, override);
+  return selection.succeeded ? selection.value : void 0;
+}
+var SandboxModelResolutionError = class extends Error {
+  code;
+  model;
+  provider;
+  source;
+  constructor(failure, context) {
+    const missing = failure.error === "no_provider" ? "no provider could be resolved for it" : `provider "${failure.provider}" resolved but no API key is configured`;
+    const fix = failure.error === "no_provider" ? "set providerName explicitly (provider cannot be inferred without one)" : 'set apiKey (or openaiApiKey when provider is "openai"), or pass allowKeylessModel:true to mint a keyless box';
+    super(
+      `${context}: model "${failure.model}" (from ${failure.source}) is not transportable \u2014 ${missing}. Fix: ${fix}. The requested model was NOT sent to the box.`
+    );
+    this.name = "SandboxModelResolutionError";
+    this.code = failure.error;
+    this.model = failure.model;
+    if (failure.error === "no_api_key") this.provider = failure.provider;
+    this.source = failure.source;
+  }
+};
+function requireTransportableModel(selection, context) {
+  if (selection.succeeded) return selection.value;
+  if (selection.source === "override") {
+    throw new SandboxModelResolutionError(selection, context);
+  }
+  const reason = selection.error === "no_api_key" ? `provider "${selection.provider}" has no api key` : "no provider resolved";
+  if (selection.source === "config") {
+    console.error(
+      `[sandbox] ${context}: dropping configured provider.modelName "${selection.model}" (${reason}); the box will use its own default model \u2014 set allowKeylessModel:true to bake a keyless model, or configure an api key`
+    );
+  } else {
+    console.error(
+      `[sandbox] ${context}: dropping provider.defaultModel "${selection.model}" (${reason}); using the box default`
+    );
+  }
+  return void 0;
+}
+
 // src/sandbox/binary-read.ts
 function shellQuote(value) {
   return `'${value.replaceAll("'", `'"'"'`)}'`;
@@ -722,6 +791,21 @@ var SandboxRuntimeAuthRefreshError = class extends Error {
     this.name = "SandboxRuntimeAuthRefreshError";
   }
 };
+var SandboxRecoveryFailedError = class extends Error {
+  boxKey;
+  stage;
+  phase;
+  constructor(stage, boxKey, phase, detail, cause) {
+    super(
+      `${stage} sandbox ${boxKey} failed liveness recovery at ${phase}: ${detail}. The workspace is preserved; pass forceNew to replace the box.`,
+      { cause }
+    );
+    this.name = "SandboxRecoveryFailedError";
+    this.boxKey = boxKey;
+    this.stage = stage;
+    this.phase = phase;
+  }
+};
 function fileApiTarget(mount) {
   if (mount.resource.kind !== "inline") return null;
   let rel;
@@ -1081,6 +1165,39 @@ async function resumeStoppedBox(box, timeoutMs, onProgress) {
     return fail(err);
   }
 }
+async function recoverUnresponsiveBox(client, box, harness, probe, stage, name, resumeTimeout, onProgress) {
+  try {
+    await box.stop();
+  } catch (err) {
+    throw new SandboxRecoveryFailedError(
+      stage,
+      name,
+      "stop",
+      "the platform could not stop the box for a state-preserving restart",
+      err
+    );
+  }
+  const resumed = await resumeStoppedBox(box, resumeTimeout, onProgress);
+  if (!resumed.succeeded) {
+    throw new SandboxRecoveryFailedError(
+      stage,
+      name,
+      "resume",
+      "the box did not reach running after a state-preserving restart",
+      resumed.error
+    );
+  }
+  const recovered = await refreshRuntimeConnection(client, resumed.value);
+  if (!await isReusableBox(recovered, harness, probe)) {
+    throw new SandboxRecoveryFailedError(
+      stage,
+      name,
+      "probe",
+      "the box is still unresponsive after a state-preserving restart"
+    );
+  }
+  return recovered;
+}
 async function resolveWorkspaceSandboxClient(shell, workspaceId, userId) {
   const scope = { workspaceId, ...userId ? { userId } : {} };
   const creds = await shell.credentials(scope);
@@ -1100,6 +1217,29 @@ async function peekWorkspaceSandbox(shell, options) {
   if (match.status !== "running") return { status: "not-running", state: match.status, box: match };
   return { status: "running", box: match };
 }
+async function finalizeExistingBox(shell, client, box, stage, name, workspaceId, userId, harness, scope) {
+  const written = await materializeDeferredFilesForExistingBox(
+    shell,
+    client,
+    box,
+    stage,
+    name,
+    workspaceId,
+    userId,
+    harness
+  );
+  if (!written.succeeded) {
+    throw deferredProfileWriteFailed(stage, name, written.error);
+  }
+  const finalBox = written.value;
+  if (shell.bootstrap) {
+    const boot = await shell.bootstrap(finalBox, scope);
+    if (!boot.succeeded) {
+      throw new Error(`bootstrap failed on ${stage} box ${name}`, { cause: boot.error });
+    }
+  }
+  return finalBox;
+}
 async function ensureWorkspaceSandbox(shell, options) {
   const { workspaceId, userId, harness, forceNew, onProgress, billingOwnerId } = options;
   const resolved = await resolveWorkspaceSandboxClient(shell, workspaceId, userId);
@@ -1119,40 +1259,24 @@ async function ensureWorkspaceSandbox(shell, options) {
     } else if (found.metadata?.harness === harness) {
       const ready = await refreshRuntimeConnection(client, found);
       if (await isReusableBox(ready, harness, shell.livenessProbe)) {
-        const written = await materializeDeferredFilesForExistingBox(
-          shell,
-          client,
-          ready,
-          "reused",
-          name,
-          workspaceId,
-          userId,
-          harness
-        );
-        if (!written.succeeded) {
-          throw deferredProfileWriteFailed("reused", name, written.error);
-        }
-        const reusedBox = written.value;
-        if (shell.bootstrap) {
-          const boot = await shell.bootstrap(reusedBox, scope);
-          if (!boot.succeeded) {
-            throw new Error(`bootstrap failed on reused box ${name}`, { cause: boot.error });
-          }
-        }
-        return reusedBox;
-      }
-      const dropped = await deleteBox(ready);
-      if (!dropped.succeeded) {
-        throw new Error(
-          `sandbox ${name} (was ${String(found.metadata?.harness ?? "unknown")}, want ${harness}, or unresponsive) could not be deleted`,
-          { cause: dropped.error }
-        );
+        return finalizeExistingBox(shell, client, ready, "reused", name, workspaceId, userId, harness, scope);
       }
+      const recovered = await recoverUnresponsiveBox(
+        client,
+        ready,
+        harness,
+        shell.livenessProbe,
+        "reused",
+        name,
+        resumeTimeout,
+        onProgress
+      );
+      return finalizeExistingBox(shell, client, recovered, "reused", name, workspaceId, userId, harness, scope);
     } else {
       const dropped = await deleteBox(found);
       if (!dropped.succeeded) {
         throw new Error(
-          `sandbox ${name} (was ${String(found.metadata?.harness ?? "unknown")}, want ${harness}, or unresponsive) could not be deleted`,
+          `sandbox ${name} (was ${String(found.metadata?.harness ?? "unknown")}, want ${harness}) could not be deleted`,
           { cause: dropped.error }
         );
       }
@@ -1185,35 +1309,19 @@ async function ensureWorkspaceSandbox(shell, options) {
       } else {
         const box2 = await refreshRuntimeConnection(client, resumed.value);
         if (await isReusableBox(box2, harness, shell.livenessProbe)) {
-          const written = await materializeDeferredFilesForExistingBox(
-            shell,
-            client,
-            box2,
-            "resumed",
-            name,
-            workspaceId,
-            userId,
-            harness
-          );
-          if (!written.succeeded) {
-            throw deferredProfileWriteFailed("resumed", name, written.error);
-          }
-          const resumedBox = written.value;
-          if (shell.bootstrap) {
-            const boot = await shell.bootstrap(resumedBox, scope);
-            if (!boot.succeeded) {
-              throw new Error(`bootstrap failed on resumed box ${name}`, { cause: boot.error });
-            }
-          }
-          return resumedBox;
-        }
-        const dropped = await deleteBox(box2);
-        if (!dropped.succeeded) {
-          throw new Error(
-            `resumed sandbox ${name} (was ${String(box2.metadata?.harness ?? "unknown")}, want ${harness}, or unresponsive) could not be deleted`,
-            { cause: dropped.error }
-          );
+          return finalizeExistingBox(shell, client, box2, "resumed", name, workspaceId, userId, harness, scope);
         }
+        const recovered = await recoverUnresponsiveBox(
+          client,
+          box2,
+          harness,
+          shell.livenessProbe,
+          "resumed",
+          name,
+          resumeTimeout,
+          onProgress
+        );
+        return finalizeExistingBox(shell, client, recovered, "resumed", name, workspaceId, userId, harness, scope);
       }
     }
   }
@@ -1232,7 +1340,7 @@ async function ensureWorkspaceSandbox(shell, options) {
   const { leanProfile, deferredFiles } = shell.deferProfileFiles ? splitDeferredProfileFiles(fullProfile) : { leanProfile: fullProfile, deferredFiles: [] };
   const profile = leanProfile;
   const role = userId && shell.permissionRole ? shell.permissionRole("developer") : void 0;
-  let model = shell.backendModelAtCreate ? resolveModel(shell.provider) : void 0;
+  let model = shell.backendModelAtCreate ? requireTransportableModel(resolveModelSelection(shell.provider), `backendModelAtCreate for ${name}`) : void 0;
   if (model && shell.childKeyMint && model.provider === "openai-compat") {
     const minted = await shell.childKeyMint(scope);
     if (minted.succeeded) model = { ...model, apiKey: minted.value };
@@ -1298,22 +1406,6 @@ async function ensureWorkspaceSandbox(shell, options) {
   }
   return box;
 }
-function resolveModel(config, override) {
-  const c = config ?? {};
-  const explicitBaseUrl = c.routerBaseUrl;
-  const explicitApiKey = override?.modelApiKey ?? c.apiKey;
-  const provider = c.providerName ?? (explicitApiKey ? "openai-compat" : c.openaiApiKey ? "openai" : void 0);
-  const modelName = override?.model ?? c.modelName ?? (provider === "openai" || provider === "openai-compat" ? c.defaultModel : void 0);
-  const apiKey = explicitApiKey ?? (provider === "openai" ? c.openaiApiKey : void 0);
-  if (!provider || !modelName) return void 0;
-  if (!apiKey && !c.allowKeylessModel) return void 0;
-  return {
-    model: modelName,
-    provider,
-    ...apiKey ? { apiKey } : {},
-    ...explicitBaseUrl ? { baseUrl: explicitBaseUrl } : {}
-  };
-}
 function historyTranscript(history) {
   return history.map((entry) => `${entry.role === "assistant" ? "Assistant" : "User"}: ${entry.content}`).join("\n\n");
 }
@@ -1359,10 +1451,13 @@ function attachReasoningEffort(profile, harness, effort) {
 }
 async function* streamSandboxPrompt(shell, box, message, options) {
   const harness = options?.harness ?? "opencode";
-  const model = resolveModel(shell.provider, {
-    model: options?.model,
-    modelApiKey: options?.modelApiKey
-  });
+  const model = requireTransportableModel(
+    resolveModelSelection(shell.provider, {
+      model: options?.model,
+      modelApiKey: options?.modelApiKey
+    }),
+    "streamSandboxPrompt"
+  );
   if (model?.model) assertHarnessModelCompatible(harness, model.model);
   const prompt = typeof message === "string" ? flattenHistory(message, options?.history) : mergeHistoryIntoParts(message, options?.history);
   const appToolMcp = options?.appToolMcp ?? {};
@@ -1535,10 +1630,13 @@ async function mintSandboxScopedToken(box, options) {
 }
 async function driveSandboxTurn(shell, box, message, options) {
   const harness = options.harness ?? "opencode";
-  const model = resolveModel(shell.provider, {
-    model: options.model,
-    modelApiKey: options.modelApiKey
-  });
+  const model = requireTransportableModel(
+    resolveModelSelection(shell.provider, {
+      model: options.model,
+      modelApiKey: options.modelApiKey
+    }),
+    "driveSandboxTurn"
+  );
   if (model?.model) assertHarnessModelCompatible(harness, model.model);
   const prompt = typeof message === "string" ? flattenHistory(message, options.history) : mergeHistoryIntoParts(message, options.history);
   const appToolMcp = options.appToolMcp ?? {};
@@ -1614,6 +1712,10 @@ function firstQuestionText(value) {
 }
 
 export {
+  resolveModelSelection,
+  resolveModel,
+  SandboxModelResolutionError,
+  requireTransportableModel,
   shellQuote,
   statSandboxFileSize,
   readSandboxBinaryBytes,
@@ -1645,6 +1747,7 @@ export {
   runSandboxToolPathSetup,
   splitDeferredProfileFiles,
   SandboxRuntimeAuthRefreshError,
+  SandboxRecoveryFailedError,
   writeProfileFilesToBox,
   deferredCorpusHash,
   PROVISION_PAYLOAD_MAX_BYTES,
@@ -1654,7 +1757,6 @@ export {
   assertEnvWithinLimits,
   peekWorkspaceSandbox,
   ensureWorkspaceSandbox,
-  resolveModel,
   flattenHistory,
   mergeHistoryIntoParts,
   mergeExtraMcp,
@@ -1675,4 +1777,4 @@ export {
   isTerminalPromptEvent,
   detectInteractiveQuestion
 };
-//# sourceMappingURL=chunk-2ZSSOYXP.js.map
+//# sourceMappingURL=chunk-Q74BS43G.js.map