@opengeni/runtime 0.6.1 → 0.7.0

package/src/sandbox/display-stack.ts

@@ -106,7 +106,9 @@ export class DisplayStackError extends Error {
             : exitCode === 14
               ? "paint"
               : "unknown";
-    super(`desktop display stack failed at stage "${stage}" (exit ${exitCode})${output ? `:\n${output}` : ""}`);
+    super(
+      `desktop display stack failed at stage "${stage}" (exit ${exitCode})${output ? `:\n${output}` : ""}`,
+    );
     this.name = "DisplayStackError";
     this.exitCode = exitCode;
     this.stage = stage;
@@ -132,8 +134,16 @@ type ExecResultLike = {
   exitCode?: number | null;
 };
 type ExecCapableSession = {
-  exec?: (args: { cmd: string; yieldTimeMs?: number; maxOutputTokens?: number }) => Promise<ExecResultLike>;
-  execCommand?: (args: { cmd: string; yieldTimeMs?: number; maxOutputTokens?: number }) => Promise<string>;
+  exec?: (args: {
+    cmd: string;
+    yieldTimeMs?: number;
+    maxOutputTokens?: number;
+  }) => Promise<ExecResultLike>;
+  execCommand?: (args: {
+    cmd: string;
+    yieldTimeMs?: number;
+    maxOutputTokens?: number;
+  }) => Promise<string>;
 };
 
 export type EnsureDisplayStackOptions = {
@@ -331,6 +341,10 @@ export async function tearDownDisplayStack(session: unknown): Promise<void> {
     return;
   }
   if (typeof s?.execCommand === "function") {
-    await s.execCommand({ cmd: "opengeni-desktop-down", yieldTimeMs: 10_000, maxOutputTokens: 4_000 });
+    await s.execCommand({
+      cmd: "opengeni-desktop-down",
+      yieldTimeMs: 10_000,
+      maxOutputTokens: 4_000,
+    });
   }
 }

package/src/sandbox/errors.ts

@@ -17,6 +17,19 @@ export class SandboxConfigError extends Error {
   }
 }
 
+/** A resume-only caller was handed a warm lease without a provider identity it
+ * can resume. The lease-aware caller must retire that exact epoch and re-enter
+ * admission; silently creating here would bypass the single-spawner guard. */
+export class SandboxResumeStateUnavailableError extends Error {
+  readonly backend: SandboxBackend | string;
+
+  constructor(backend: SandboxBackend | string) {
+    super(`Sandbox lease for backend "${backend}" has no resumable provider identity`);
+    this.name = "SandboxResumeStateUnavailableError";
+    this.backend = backend;
+  }
+}
+
 // Thrown by a provider's build() when its SDK client class is genuinely not
 // available in the installed @openai/agents-extensions. Per the P0.3 ruling we
 // NEVER fake a build body; if a provider cannot be constructed we register the