veryfront 0.1.277 → 0.1.279

package/esm/deno.js

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

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

@@ -23,6 +23,7 @@ export declare class LazySandbox {
     private heartbeatPromise;
     private heartbeatTimer;
     private lastHeartbeatAt;
+    private readonly activeCommandJobEndpoints;
     constructor(options?: LazySandboxOptions);
     ensure(): Promise<void>;
     executeCommand(command: string, options?: ExecOptions): Promise<ExecResult>;
@@ -51,6 +52,9 @@ export declare class LazySandbox {
     private requireEndpoint;
     private resolveProjectId;
     private resetSessionState;
+    private resolveExecOptions;
+    private resolveCommandJobEndpoint;
+    private updateTrackedCommandJob;
     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":"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;CAC3B;AAaD,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;IAE1C,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;gBAEhB,OAAO,GAAE,kBAAuB;IAUtC,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;IAwCvF,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;IAkB5E,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBjD,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuB7D,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAkBxC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBpD,SAAS,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CvC,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;IAWzB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;CAMpB"}
+{"version":3,"file":"lazy-sandbox.d.ts","sourceRoot":"","sources":["../../../src/src/sandbox/lazy-sandbox.ts"],"names":[],"mappings":"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"}

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

@@ -22,6 +22,7 @@ export class LazySandbox {
     heartbeatPromise = null;
     heartbeatTimer = null;
     lastHeartbeatAt = 0;
+    activeCommandJobEndpoints = new Map();
     constructor(options = {}) {
         this.apiUrl = resolveSandboxApiUrl(options);
         this.authToken = resolveSandboxAuthToken(options);
@@ -73,7 +74,7 @@ export class LazySandbox {
         const res = await fetch(`${this.requireEndpoint()}/exec`, {
             method: "POST",
             headers: this.jsonHeaders(),
-            body: JSON.stringify({ command, ...options }),
+            body: JSON.stringify({ command, ...this.resolveExecOptions(options) }),
         });
         if (!res.ok) {
             throw REQUEST_ERROR.create({ detail: `Exec failed: ${res.status} ${await res.text()}` });
@@ -126,21 +127,24 @@ export class LazySandbox {
     }
     async startCommandJob(command, options) {
         await this.touchSession();
-        const res = await fetch(`${this.requireEndpoint()}/exec/jobs`, {
+        const endpoint = this.requireEndpoint();
+        const res = await fetch(`${endpoint}/exec/jobs`, {
             method: "POST",
             headers: this.jsonHeaders(),
-            body: JSON.stringify({ command, ...options }),
+            body: JSON.stringify({ command, ...this.resolveExecOptions(options) }),
         });
         if (!res.ok) {
             throw REQUEST_ERROR.create({
                 detail: `Start command job failed: ${res.status} ${await res.text()}`,
             });
         }
-        return mapCommandJob(await res.json());
+        const job = mapCommandJob(await res.json());
+        this.updateTrackedCommandJob(job, endpoint);
+        return job;
     }
     async getCommandJob(jobId) {
-        await this.ensure();
-        const res = await fetch(`${this.requireEndpoint()}/exec/jobs/${jobId}`, {
+        const endpoint = await this.resolveCommandJobEndpoint(jobId);
+        const res = await fetch(`${endpoint}/exec/jobs/${jobId}`, {
             headers: this.authHeaders(),
         });
         if (!res.ok) {
@@ -148,11 +152,13 @@ export class LazySandbox {
                 detail: `Get command job failed: ${res.status} ${await res.text()}`,
             });
         }
-        return mapCommandJob(await res.json());
+        const job = mapCommandJob(await res.json());
+        this.updateTrackedCommandJob(job, endpoint);
+        return job;
     }
     async getCommandJobOutput(jobId) {
-        await this.ensure();
-        const res = await fetch(`${this.requireEndpoint()}/exec/jobs/${jobId}/output`, {
+        const endpoint = await this.resolveCommandJobEndpoint(jobId);
+        const res = await fetch(`${endpoint}/exec/jobs/${jobId}/output`, {
             headers: this.authHeaders(),
         });
         if (!res.ok) {
@@ -161,13 +167,15 @@ export class LazySandbox {
             });
         }
         const json = await res.json();
-        return {
+        const output = {
             ...mapCommandJob(json),
             stdout: json.stdout,
             stderr: json.stderr,
             stdoutTruncated: json.stdout_truncated,
             stderrTruncated: json.stderr_truncated,
         };
+        this.updateTrackedCommandJob(output, endpoint);
+        return output;
     }
     async listCommandJobs() {
         await this.ensure();
@@ -184,8 +192,8 @@ export class LazySandbox {
         return jobs.map((job) => mapCommandJob(job));
     }
     async cancelCommandJob(jobId) {
-        await this.ensure();
-        const res = await fetch(`${this.requireEndpoint()}/exec/jobs/${jobId}/cancel`, {
+        const endpoint = await this.resolveCommandJobEndpoint(jobId);
+        const res = await fetch(`${endpoint}/exec/jobs/${jobId}/cancel`, {
             method: "POST",
             headers: this.authHeaders(),
         });
@@ -194,7 +202,9 @@ export class LazySandbox {
                 detail: `Cancel command job failed: ${res.status} ${await res.text()}`,
             });
         }
-        return mapCommandJob(await res.json());
+        const job = mapCommandJob(await res.json());
+        this.updateTrackedCommandJob(job, endpoint);
+        return job;
     }
     async heartbeat(force = false) {
         const currentSessionId = this.sessionId;
@@ -215,8 +225,10 @@ export class LazySandbox {
             });
             if (!res.ok) {
                 if (this.sessionId === currentSessionId) {
-                    await this.deleteSession(currentSessionId);
-                    this.resetSessionState(currentSessionId);
+                    if (this.activeCommandJobEndpoints.size === 0) {
+                        await this.deleteSession(currentSessionId);
+                        this.resetSessionState(currentSessionId);
+                    }
                 }
                 throw new Error(`Sandbox heartbeat failed: ${res.status} ${await res.text()}`);
             }
@@ -338,7 +350,7 @@ export class LazySandbox {
         await this.heartbeat();
     }
     startHeartbeatLoop() {
-        if (!this.sessionId || this.heartbeatTimer)
+        if (!this.sessionId || this.heartbeatTimer || this.activeCommandJobEndpoints.size > 0)
             return;
         this.heartbeatTimer = dntShim.setInterval(() => {
             void this.heartbeat().catch(() => {
@@ -370,6 +382,7 @@ export class LazySandbox {
     resetSessionState(sessionId) {
         if (!sessionId || this.sessionId === sessionId) {
             this.stopHeartbeatLoop();
+            this.activeCommandJobEndpoints.clear();
             this.endpoint = null;
             this.sessionId = null;
             this.sessionProjectId = null;
@@ -377,6 +390,31 @@ export class LazySandbox {
             this.lastHeartbeatAt = 0;
         }
     }
+    resolveExecOptions(options) {
+        const projectReference = options?.projectReference ?? this.resolveProjectId() ?? undefined;
+        return projectReference ? { ...options, projectReference } : options;
+    }
+    async resolveCommandJobEndpoint(jobId) {
+        const trackedEndpoint = this.activeCommandJobEndpoints.get(jobId);
+        if (trackedEndpoint) {
+            return trackedEndpoint;
+        }
+        await this.ensure();
+        return this.requireEndpoint();
+    }
+    updateTrackedCommandJob(job, endpoint) {
+        if (job.status === "running") {
+            this.activeCommandJobEndpoints.set(job.id, endpoint);
+            this.stopHeartbeatLoop();
+            return;
+        }
+        if (!this.activeCommandJobEndpoints.delete(job.id)) {
+            return;
+        }
+        if (this.activeCommandJobEndpoints.size === 0 && this.endpoint) {
+            this.startHeartbeatLoop();
+        }
+    }
     authHeaders() {
         return { Authorization: `Bearer ${this.authToken}` };
     }

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

@@ -1,5 +1,5 @@
 import { LazySandbox, type LazySandboxOptions } from "./lazy-sandbox.js";
-/** Options for command execution: working directory, timeout, and environment variables. */
+/** Options for command execution: working directory, timeout, environment variables, and optional project reference. */
 export interface ExecOptions {
     /** Working directory for the command. */
     cwd?: string;
@@ -7,6 +7,8 @@ export interface ExecOptions {
     timeout_seconds?: number;
     /** Additional environment variables for the command. */
     env?: Record<string, string>;
+    /** Optional project reference forwarded to sandbox command surfaces that support project-scoped execution. */
+    projectReference?: string;
 }
 /** Options for creating a sandbox session. */
 export interface SandboxOptions {

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

@@ -1 +1 @@
-{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../../src/src/sandbox/sandbox.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../../src/src/sandbox/sandbox.ts"],"names":[],"mappings":"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"}

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.277";
+export declare const VERSION = "0.1.279";
 //# 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.277";
+export const VERSION = "0.1.279";

package/package.json

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

package/src/deno.js

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

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

@@ -50,6 +50,7 @@ export class LazySandbox {
   private heartbeatPromise: Promise<void> | null = null;
   private heartbeatTimer: ReturnType<typeof dntShim.setInterval> | null = null;
   private lastHeartbeatAt = 0;
+  private readonly activeCommandJobEndpoints = new Map<string, string>();
 
   constructor(options: LazySandboxOptions = {}) {
     this.apiUrl = resolveSandboxApiUrl(options);
@@ -108,7 +109,7 @@ export class LazySandbox {
     const res = await fetch(`${this.requireEndpoint()}/exec`, {
       method: "POST",
       headers: this.jsonHeaders(),
-      body: JSON.stringify({ command, ...options }),
+      body: JSON.stringify({ command, ...this.resolveExecOptions(options) }),
     });
 
     if (!res.ok) {
@@ -174,11 +175,12 @@ export class LazySandbox {
 
   async startCommandJob(command: string, options?: ExecOptions): Promise<CommandJob> {
     await this.touchSession();
+    const endpoint = this.requireEndpoint();
 
-    const res = await fetch(`${this.requireEndpoint()}/exec/jobs`, {
+    const res = await fetch(`${endpoint}/exec/jobs`, {
       method: "POST",
       headers: this.jsonHeaders(),
-      body: JSON.stringify({ command, ...options }),
+      body: JSON.stringify({ command, ...this.resolveExecOptions(options) }),
     });
 
     if (!res.ok) {
@@ -187,13 +189,15 @@ export class LazySandbox {
       });
     }
 
-    return mapCommandJob(await res.json());
+    const job = mapCommandJob(await res.json());
+    this.updateTrackedCommandJob(job, endpoint);
+    return job;
   }
 
   async getCommandJob(jobId: string): Promise<CommandJob> {
-    await this.ensure();
+    const endpoint = await this.resolveCommandJobEndpoint(jobId);
 
-    const res = await fetch(`${this.requireEndpoint()}/exec/jobs/${jobId}`, {
+    const res = await fetch(`${endpoint}/exec/jobs/${jobId}`, {
       headers: this.authHeaders(),
     });
 
@@ -203,13 +207,15 @@ export class LazySandbox {
       });
     }
 
-    return mapCommandJob(await res.json());
+    const job = mapCommandJob(await res.json());
+    this.updateTrackedCommandJob(job, endpoint);
+    return job;
   }
 
   async getCommandJobOutput(jobId: string): Promise<CommandJobOutput> {
-    await this.ensure();
+    const endpoint = await this.resolveCommandJobEndpoint(jobId);
 
-    const res = await fetch(`${this.requireEndpoint()}/exec/jobs/${jobId}/output`, {
+    const res = await fetch(`${endpoint}/exec/jobs/${jobId}/output`, {
       headers: this.authHeaders(),
     });
 
@@ -220,13 +226,15 @@ export class LazySandbox {
     }
 
     const json = await res.json();
-    return {
+    const output = {
       ...mapCommandJob(json),
       stdout: json.stdout,
       stderr: json.stderr,
       stdoutTruncated: json.stdout_truncated,
       stderrTruncated: json.stderr_truncated,
     };
+    this.updateTrackedCommandJob(output, endpoint);
+    return output;
   }
 
   async listCommandJobs(): Promise<CommandJob[]> {
@@ -248,9 +256,9 @@ export class LazySandbox {
   }
 
   async cancelCommandJob(jobId: string): Promise<CommandJob> {
-    await this.ensure();
+    const endpoint = await this.resolveCommandJobEndpoint(jobId);
 
-    const res = await fetch(`${this.requireEndpoint()}/exec/jobs/${jobId}/cancel`, {
+    const res = await fetch(`${endpoint}/exec/jobs/${jobId}/cancel`, {
       method: "POST",
       headers: this.authHeaders(),
     });
@@ -261,7 +269,9 @@ export class LazySandbox {
       });
     }
 
-    return mapCommandJob(await res.json());
+    const job = mapCommandJob(await res.json());
+    this.updateTrackedCommandJob(job, endpoint);
+    return job;
   }
 
   async heartbeat(force = false): Promise<void> {
@@ -288,8 +298,10 @@ export class LazySandbox {
 
       if (!res.ok) {
         if (this.sessionId === currentSessionId) {
-          await this.deleteSession(currentSessionId);
-          this.resetSessionState(currentSessionId);
+          if (this.activeCommandJobEndpoints.size === 0) {
+            await this.deleteSession(currentSessionId);
+            this.resetSessionState(currentSessionId);
+          }
         }
 
         throw new Error(`Sandbox heartbeat failed: ${res.status} ${await res.text()}`);
@@ -432,7 +444,7 @@ export class LazySandbox {
   }
 
   private startHeartbeatLoop(): void {
-    if (!this.sessionId || this.heartbeatTimer) return;
+    if (!this.sessionId || this.heartbeatTimer || this.activeCommandJobEndpoints.size > 0) return;
 
     this.heartbeatTimer = dntShim.setInterval(() => {
       void this.heartbeat().catch(() => {
@@ -468,6 +480,7 @@ export class LazySandbox {
   private resetSessionState(sessionId?: string): void {
     if (!sessionId || this.sessionId === sessionId) {
       this.stopHeartbeatLoop();
+      this.activeCommandJobEndpoints.clear();
       this.endpoint = null;
       this.sessionId = null;
       this.sessionProjectId = null;
@@ -476,6 +489,37 @@ export class LazySandbox {
     }
   }
 
+  private resolveExecOptions(options?: ExecOptions): ExecOptions | undefined {
+    const projectReference = options?.projectReference ?? this.resolveProjectId() ?? undefined;
+    return projectReference ? { ...options, projectReference } : options;
+  }
+
+  private async resolveCommandJobEndpoint(jobId: string): Promise<string> {
+    const trackedEndpoint = this.activeCommandJobEndpoints.get(jobId);
+    if (trackedEndpoint) {
+      return trackedEndpoint;
+    }
+
+    await this.ensure();
+    return this.requireEndpoint();
+  }
+
+  private updateTrackedCommandJob(job: Pick<CommandJob, "id" | "status">, endpoint: string): void {
+    if (job.status === "running") {
+      this.activeCommandJobEndpoints.set(job.id, endpoint);
+      this.stopHeartbeatLoop();
+      return;
+    }
+
+    if (!this.activeCommandJobEndpoints.delete(job.id)) {
+      return;
+    }
+
+    if (this.activeCommandJobEndpoints.size === 0 && this.endpoint) {
+      this.startHeartbeatLoop();
+    }
+  }
+
   private authHeaders(): HeadersInit {
     return { Authorization: `Bearer ${this.authToken}` };
   }

package/src/src/sandbox/sandbox.ts

@@ -20,7 +20,7 @@ import { getVeryfrontCloudAuthToken } from "../platform/cloud/resolver.js";
 import { getHostEnv } from "../platform/compat/process.js";
 import { LazySandbox, type LazySandboxOptions } from "./lazy-sandbox.js";
 
-/** Options for command execution: working directory, timeout, and environment variables. */
+/** Options for command execution: working directory, timeout, environment variables, and optional project reference. */
 export interface ExecOptions {
   /** Working directory for the command. */
   cwd?: string;
@@ -28,6 +28,8 @@ export interface ExecOptions {
   timeout_seconds?: number;
   /** Additional environment variables for the command. */
   env?: Record<string, string>;
+  /** Optional project reference forwarded to sandbox command surfaces that support project-scoped execution. */
+  projectReference?: string;
 }
 
 /** Options for creating a sandbox session. */

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.277";
+export const VERSION = "0.1.279";