veryfront 0.1.280 → 0.1.281

package/esm/deno.js

@@ -1,7 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.277",
-    "version": "0.1.280",
+    "version": "0.1.281",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [

package/esm/src/sandbox/lazy-sandbox.d.ts

@@ -5,6 +5,13 @@ export interface LazySandboxOptions extends SandboxOptions {
     pollIntervalMs?: number;
     heartbeatIntervalMs?: number;
     heartbeatGraceMs?: number;
+    execStartTimeoutMs?: number;
+    execStartMaxAttempts?: number;
+    execStartRetryDelayMs?: number;
+    resolveRuntimeEndpoint?: (input: {
+        endpoint: string;
+        sessionId: string;
+    }) => string;
 }
 /** Lazily provisions sandbox sessions and keeps them alive while in use. */
 export declare class LazySandbox {
@@ -15,6 +22,10 @@ export declare class LazySandbox {
     private readonly pollIntervalMs;
     private readonly heartbeatIntervalMs;
     private readonly heartbeatGraceMs;
+    private readonly execStartTimeoutMs;
+    private readonly execStartMaxAttempts;
+    private readonly execStartRetryDelayMs;
+    private readonly resolveRuntimeEndpointOption;
     private endpoint;
     private sessionId;
     private sessionProjectId;
@@ -55,6 +66,12 @@ export declare class LazySandbox {
     private resolveExecOptions;
     private resolveCommandJobEndpoint;
     private updateTrackedCommandJob;
+    private startExec;
+    private fetchExecStart;
+    private waitForExecStartRetry;
+    private reprovisionAfterExecStartFailure;
+    private resolveRuntimeEndpoint;
+    private requireSessionId;
     private authHeaders;
     private jsonHeaders;
 }

package/esm/src/sandbox/lazy-sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-sandbox.d.ts","sourceRoot":"","sources":["../../../src/src/sandbox/lazy-sandbox.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lazy-sandbox.d.ts","sourceRoot":"","sources":["../../../src/src/sandbox/lazy-sandbox.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EAErB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,eAAe,EAGpB,KAAK,cAAc,EAEpB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CACrF;AAsBD,4EAA4E;AAC5E,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAK/B;IAEd,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,cAAc,CAAuD;IAC7E,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA6B;gBAE3D,OAAO,GAAE,kBAAuB;IAetC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBvB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAsB1E,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,eAAe,CAAC;IA0CvF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcvC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1E,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAqB5E,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBjD,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyB7D,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAkBxC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAmBpD,SAAS,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5B,IAAI,EAAE,IAAI,MAAM,GAAG,IAAI,CAEtB;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,CAEvB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;YAEa,gBAAgB;YAiChB,oBAAoB;YA2BpB,YAAY;IAc1B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,iBAAiB;YAMX,aAAa;IAO3B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,kBAAkB;YAKZ,yBAAyB;IAUvC,OAAO,CAAC,uBAAuB;YAgBjB,SAAS;YAkCT,cAAc;IAW5B,OAAO,CAAC,qBAAqB;YAIf,gCAAgC;IAQ9C,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;CAMpB"}

package/esm/src/sandbox/lazy-sandbox.js

@@ -5,6 +5,15 @@ const DEFAULT_STARTUP_TIMEOUT_MS = 180_000;
 const DEFAULT_POLL_INTERVAL_MS = 2_000;
 const DEFAULT_HEARTBEAT_INTERVAL_MS = 30_000;
 const DEFAULT_HEARTBEAT_GRACE_MS = 5_000;
+const DEFAULT_EXEC_START_TIMEOUT_MS = 30_000;
+const DEFAULT_EXEC_START_MAX_ATTEMPTS = 3;
+const DEFAULT_EXEC_START_RETRY_DELAY_MS = 1_000;
+const REPROVISIONABLE_EXEC_START_ERROR_CODES = new Set([
+    "ECONNREFUSED",
+    "ECONNRESET",
+    "ENOTFOUND",
+    "EHOSTUNREACH",
+]);
 /** Lazily provisions sandbox sessions and keeps them alive while in use. */
 export class LazySandbox {
     apiUrl;
@@ -14,6 +23,10 @@ export class LazySandbox {
     pollIntervalMs;
     heartbeatIntervalMs;
     heartbeatGraceMs;
+    execStartTimeoutMs;
+    execStartMaxAttempts;
+    execStartRetryDelayMs;
+    resolveRuntimeEndpointOption;
     endpoint = null;
     sessionId = null;
     sessionProjectId = null;
@@ -31,6 +44,11 @@ export class LazySandbox {
         this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
         this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
         this.heartbeatGraceMs = options.heartbeatGraceMs ?? DEFAULT_HEARTBEAT_GRACE_MS;
+        this.execStartTimeoutMs = options.execStartTimeoutMs ?? DEFAULT_EXEC_START_TIMEOUT_MS;
+        this.execStartMaxAttempts = options.execStartMaxAttempts ?? DEFAULT_EXEC_START_MAX_ATTEMPTS;
+        this.execStartRetryDelayMs = options.execStartRetryDelayMs ??
+            DEFAULT_EXEC_START_RETRY_DELAY_MS;
+        this.resolveRuntimeEndpointOption = options.resolveRuntimeEndpoint;
     }
     async ensure() {
         if (this.endpoint)
@@ -71,13 +89,17 @@ export class LazySandbox {
     }
     async *executeStream(command, options) {
         await this.touchSession();
-        const res = await fetch(`${this.requireEndpoint()}/exec`, {
-            method: "POST",
-            headers: this.jsonHeaders(),
-            body: JSON.stringify({ command, ...this.resolveExecOptions(options) }),
-        });
-        if (!res.ok) {
-            throw REQUEST_ERROR.create({ detail: `Exec failed: ${res.status} ${await res.text()}` });
+        let res;
+        try {
+            res = await this.startExec(command, options);
+        }
+        catch (error) {
+            if (!shouldReprovisionAfterExecStartFailure(error)) {
+                throw error;
+            }
+            await this.reprovisionAfterExecStartFailure();
+            await this.touchSession();
+            res = await this.startExec(command, options);
         }
         if (!res.body) {
             throw new Error("Exec response has no body");
@@ -127,7 +149,7 @@ export class LazySandbox {
     }
     async startCommandJob(command, options) {
         await this.touchSession();
-        const endpoint = this.requireEndpoint();
+        const endpoint = this.resolveRuntimeEndpoint();
         const res = await fetch(`${endpoint}/exec/jobs`, {
             method: "POST",
             headers: this.jsonHeaders(),
@@ -400,7 +422,7 @@ export class LazySandbox {
             return trackedEndpoint;
         }
         await this.ensure();
-        return this.requireEndpoint();
+        return this.resolveRuntimeEndpoint();
     }
     updateTrackedCommandJob(job, endpoint) {
         if (job.status === "running") {
@@ -415,6 +437,65 @@ export class LazySandbox {
             this.startHeartbeatLoop();
         }
     }
+    async startExec(command, options) {
+        const endpoint = this.resolveRuntimeEndpoint();
+        const body = JSON.stringify({ command, ...this.resolveExecOptions(options) });
+        for (let attempt = 1; attempt <= this.execStartMaxAttempts; attempt += 1) {
+            try {
+                const res = await this.fetchExecStart(`${endpoint}/exec`, {
+                    method: "POST",
+                    headers: this.jsonHeaders(),
+                    body,
+                });
+                if (res.ok) {
+                    return res;
+                }
+                if (isRetryableExecStartStatus(res.status) && attempt < this.execStartMaxAttempts) {
+                    await this.waitForExecStartRetry();
+                    continue;
+                }
+                throw REQUEST_ERROR.create({ detail: `Exec failed: ${res.status} ${await res.text()}` });
+            }
+            catch (error) {
+                if (!isRetryableExecStartError(error) || attempt >= this.execStartMaxAttempts) {
+                    throw error;
+                }
+                await this.waitForExecStartRetry();
+            }
+        }
+        throw new Error("Sandbox exec failed before a request was made");
+    }
+    async fetchExecStart(url, init) {
+        const controller = new AbortController();
+        const timeout = dntShim.setTimeout(() => controller.abort(), this.execStartTimeoutMs);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    waitForExecStartRetry() {
+        return new Promise((resolve) => dntShim.setTimeout(resolve, this.execStartRetryDelayMs));
+    }
+    async reprovisionAfterExecStartFailure() {
+        const sessionId = this.sessionId;
+        if (!sessionId)
+            return;
+        await this.deleteSession(sessionId);
+        this.resetSessionState(sessionId);
+    }
+    resolveRuntimeEndpoint() {
+        const endpoint = this.requireEndpoint();
+        const sessionId = this.requireSessionId();
+        return this.resolveRuntimeEndpointOption?.({ endpoint, sessionId }) ?? endpoint;
+    }
+    requireSessionId() {
+        if (!this.sessionId) {
+            throw new Error("Sandbox session unavailable");
+        }
+        return this.sessionId;
+    }
     authHeaders() {
         return { Authorization: `Bearer ${this.authToken}` };
     }
@@ -425,6 +506,23 @@ export class LazySandbox {
         };
     }
 }
+function isRetryableExecStartStatus(status) {
+    return status === 502 || status === 503 || status === 504;
+}
+function isRetryableExecStartError(error) {
+    return error instanceof Error && /fetch failed/i.test(error.message);
+}
+function shouldReprovisionAfterExecStartFailure(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const cause = error.cause;
+    if (typeof cause !== "object" || cause === null || !("code" in cause)) {
+        return false;
+    }
+    return typeof cause.code === "string" &&
+        REPROVISIONABLE_EXEC_START_ERROR_CODES.has(cause.code);
+}
 function mapCommandJob(json) {
     return {
         id: json.id,

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.280";
+export declare const VERSION = "0.1.281";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.280";
+export const VERSION = "0.1.281";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.280",
+  "version": "0.1.281",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,7 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.277",
-  "version": "0.1.280",
+  "version": "0.1.281",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/src/sandbox/lazy-sandbox.ts

@@ -19,6 +19,10 @@ export interface LazySandboxOptions extends SandboxOptions {
   pollIntervalMs?: number;
   heartbeatIntervalMs?: number;
   heartbeatGraceMs?: number;
+  execStartTimeoutMs?: number;
+  execStartMaxAttempts?: number;
+  execStartRetryDelayMs?: number;
+  resolveRuntimeEndpoint?: (input: { endpoint: string; sessionId: string }) => string;
 }
 
 interface SandboxSessionRecord {
@@ -31,6 +35,15 @@ const DEFAULT_STARTUP_TIMEOUT_MS = 180_000;
 const DEFAULT_POLL_INTERVAL_MS = 2_000;
 const DEFAULT_HEARTBEAT_INTERVAL_MS = 30_000;
 const DEFAULT_HEARTBEAT_GRACE_MS = 5_000;
+const DEFAULT_EXEC_START_TIMEOUT_MS = 30_000;
+const DEFAULT_EXEC_START_MAX_ATTEMPTS = 3;
+const DEFAULT_EXEC_START_RETRY_DELAY_MS = 1_000;
+const REPROVISIONABLE_EXEC_START_ERROR_CODES = new Set([
+  "ECONNREFUSED",
+  "ECONNRESET",
+  "ENOTFOUND",
+  "EHOSTUNREACH",
+]);
 
 /** Lazily provisions sandbox sessions and keeps them alive while in use. */
 export class LazySandbox {
@@ -41,6 +54,15 @@ export class LazySandbox {
   private readonly pollIntervalMs: number;
   private readonly heartbeatIntervalMs: number;
   private readonly heartbeatGraceMs: number;
+  private readonly execStartTimeoutMs: number;
+  private readonly execStartMaxAttempts: number;
+  private readonly execStartRetryDelayMs: number;
+  private readonly resolveRuntimeEndpointOption:
+    | ((input: {
+      endpoint: string;
+      sessionId: string;
+    }) => string)
+    | undefined;
 
   private endpoint: string | null = null;
   private sessionId: string | null = null;
@@ -60,6 +82,11 @@ export class LazySandbox {
     this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
     this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
     this.heartbeatGraceMs = options.heartbeatGraceMs ?? DEFAULT_HEARTBEAT_GRACE_MS;
+    this.execStartTimeoutMs = options.execStartTimeoutMs ?? DEFAULT_EXEC_START_TIMEOUT_MS;
+    this.execStartMaxAttempts = options.execStartMaxAttempts ?? DEFAULT_EXEC_START_MAX_ATTEMPTS;
+    this.execStartRetryDelayMs = options.execStartRetryDelayMs ??
+      DEFAULT_EXEC_START_RETRY_DELAY_MS;
+    this.resolveRuntimeEndpointOption = options.resolveRuntimeEndpoint;
   }
 
   async ensure(): Promise<void> {
@@ -105,15 +132,17 @@ export class LazySandbox {
 
   async *executeStream(command: string, options?: ExecOptions): AsyncGenerator<ExecStreamEvent> {
     await this.touchSession();
+    let res: Response;
+    try {
+      res = await this.startExec(command, options);
+    } catch (error) {
+      if (!shouldReprovisionAfterExecStartFailure(error)) {
+        throw error;
+      }
 
-    const res = await fetch(`${this.requireEndpoint()}/exec`, {
-      method: "POST",
-      headers: this.jsonHeaders(),
-      body: JSON.stringify({ command, ...this.resolveExecOptions(options) }),
-    });
-
-    if (!res.ok) {
-      throw REQUEST_ERROR.create({ detail: `Exec failed: ${res.status} ${await res.text()}` });
+      await this.reprovisionAfterExecStartFailure();
+      await this.touchSession();
+      res = await this.startExec(command, options);
     }
 
     if (!res.body) {
@@ -175,7 +204,7 @@ export class LazySandbox {
 
   async startCommandJob(command: string, options?: ExecOptions): Promise<CommandJob> {
     await this.touchSession();
-    const endpoint = this.requireEndpoint();
+    const endpoint = this.resolveRuntimeEndpoint();
 
     const res = await fetch(`${endpoint}/exec/jobs`, {
       method: "POST",
@@ -501,7 +530,7 @@ export class LazySandbox {
     }
 
     await this.ensure();
-    return this.requireEndpoint();
+    return this.resolveRuntimeEndpoint();
   }
 
   private updateTrackedCommandJob(job: Pick<CommandJob, "id" | "status">, endpoint: string): void {
@@ -520,6 +549,77 @@ export class LazySandbox {
     }
   }
 
+  private async startExec(command: string, options?: ExecOptions): Promise<Response> {
+    const endpoint = this.resolveRuntimeEndpoint();
+    const body = JSON.stringify({ command, ...this.resolveExecOptions(options) });
+
+    for (let attempt = 1; attempt <= this.execStartMaxAttempts; attempt += 1) {
+      try {
+        const res = await this.fetchExecStart(`${endpoint}/exec`, {
+          method: "POST",
+          headers: this.jsonHeaders(),
+          body,
+        });
+
+        if (res.ok) {
+          return res;
+        }
+
+        if (isRetryableExecStartStatus(res.status) && attempt < this.execStartMaxAttempts) {
+          await this.waitForExecStartRetry();
+          continue;
+        }
+
+        throw REQUEST_ERROR.create({ detail: `Exec failed: ${res.status} ${await res.text()}` });
+      } catch (error) {
+        if (!isRetryableExecStartError(error) || attempt >= this.execStartMaxAttempts) {
+          throw error;
+        }
+
+        await this.waitForExecStartRetry();
+      }
+    }
+
+    throw new Error("Sandbox exec failed before a request was made");
+  }
+
+  private async fetchExecStart(url: string, init: RequestInit): Promise<Response> {
+    const controller = new AbortController();
+    const timeout = dntShim.setTimeout(() => controller.abort(), this.execStartTimeoutMs);
+
+    try {
+      return await fetch(url, { ...init, signal: controller.signal });
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+
+  private waitForExecStartRetry(): Promise<void> {
+    return new Promise((resolve) => dntShim.setTimeout(resolve, this.execStartRetryDelayMs));
+  }
+
+  private async reprovisionAfterExecStartFailure(): Promise<void> {
+    const sessionId = this.sessionId;
+    if (!sessionId) return;
+
+    await this.deleteSession(sessionId);
+    this.resetSessionState(sessionId);
+  }
+
+  private resolveRuntimeEndpoint(): string {
+    const endpoint = this.requireEndpoint();
+    const sessionId = this.requireSessionId();
+    return this.resolveRuntimeEndpointOption?.({ endpoint, sessionId }) ?? endpoint;
+  }
+
+  private requireSessionId(): string {
+    if (!this.sessionId) {
+      throw new Error("Sandbox session unavailable");
+    }
+
+    return this.sessionId;
+  }
+
   private authHeaders(): HeadersInit {
     return { Authorization: `Bearer ${this.authToken}` };
   }
@@ -532,6 +632,28 @@ export class LazySandbox {
   }
 }
 
+function isRetryableExecStartStatus(status: number): boolean {
+  return status === 502 || status === 503 || status === 504;
+}
+
+function isRetryableExecStartError(error: unknown): boolean {
+  return error instanceof Error && /fetch failed/i.test(error.message);
+}
+
+function shouldReprovisionAfterExecStartFailure(error: unknown): boolean {
+  if (!(error instanceof Error)) {
+    return false;
+  }
+
+  const cause = error.cause;
+  if (typeof cause !== "object" || cause === null || !("code" in cause)) {
+    return false;
+  }
+
+  return typeof cause.code === "string" &&
+    REPROVISIONABLE_EXEC_START_ERROR_CODES.has(cause.code);
+}
+
 function mapCommandJob(json: Record<string, unknown>): CommandJob {
   return {
     id: json.id as string,

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.280";
+export const VERSION = "0.1.281";