veryfront 0.1.1113 → 0.1.1114

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1113",
+    "version": "0.1.1114",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

package/esm/src/agent/project/agent-runtime.d.ts

@@ -15,7 +15,7 @@ export type ProjectAgentRuntimeAgentIdCandidates = {
 /** Input payload for discover project agent runtime. */
 export type DiscoverProjectAgentRuntimeInput = {
     projectDir: string;
-    adapter: RuntimeAdapter;
+    adapter?: RuntimeAdapter;
     config?: VeryfrontConfig | null;
     fsAdapter?: FileSystemAdapter;
     cacheKey?: string;

package/esm/src/agent/project/agent-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/project/agent-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAKhE,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAIzE,OAAO,KAAK,EACV,8BAA8B,EAE/B,MAAM,gCAAgC,CAAC;AAKxC,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,aAAa,CAAC;AACtD,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,qCAAqC,CAAC;AAO7C,kEAAkE;AAClE,MAAM,MAAM,8BAA8B,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAE1E,yEAAyE;AACzE,MAAM,MAAM,oCAAoC,GAAG;IACjD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,gCAAgC,GAAG;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,uBAAuB,CAAC,EAAE,+BAA+B,CAAC;CAC3D,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,4BAA4B,GAAG,eAAe,GAAG;IAC3D,uBAAuB,EAAE,+BAA+B,CAAC;CAC1D,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,OAAO,EAAE,IAAI,CAAC,4BAA4B,EAAE,yBAAyB,CAAC,EACtE,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAEH;AA8CD,8CAA8C;AAC9C,wBAAgB,kCAAkC,IAAI,IAAI,CAMzD;AAED,6CAA6C;AAC7C,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,4BAA4B,CAAC,CA+BvC;AAED,4DAA4D;AAC5D,wBAAgB,uCAAuC,CACrD,YAAY,EAAE,KAAK,EACnB,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAOT;AAED,kDAAkD;AAClD,wBAAsB,qCAAqC,CACzD,YAAY,EAAE,KAAK,GAClB,OAAO,CAAC,8BAA8B,CAAC,CA+BzC;AAED,wDAAwD;AACxD,wBAAgB,uCAAuC,CACrD,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG,SAAS,GAClE,oCAAoC,CAgBtC;AAED,iEAAiE;AACjE,wBAAgB,4CAA4C,CAC1D,KAAK,EAAE,oCAAoC,GAC1C,MAAM,CAKR;AAED,sDAAsD;AACtD,wBAAgB,uCAAuC,CAAC,KAAK,EAAE;IAC7D,UAAU,EAAE,oCAAoC,CAAC;IACjD,MAAM,EAAE,8BAA8B,CAAC;CACxC,GAAG,MAAM,GAAG,IAAI,CAiBhB"}
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/project/agent-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAKhE,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAKzE,OAAO,KAAK,EACV,8BAA8B,EAE/B,MAAM,gCAAgC,CAAC;AAKxC,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,aAAa,CAAC;AACtD,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,qCAAqC,CAAC;AAO7C,kEAAkE;AAClE,MAAM,MAAM,8BAA8B,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAE1E,yEAAyE;AACzE,MAAM,MAAM,oCAAoC,GAAG;IACjD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,gCAAgC,GAAG;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,uBAAuB,CAAC,EAAE,+BAA+B,CAAC;CAC3D,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,4BAA4B,GAAG,eAAe,GAAG;IAC3D,uBAAuB,EAAE,+BAA+B,CAAC;CAC1D,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,OAAO,EAAE,IAAI,CAAC,4BAA4B,EAAE,yBAAyB,CAAC,EACtE,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAEH;AA8CD,8CAA8C;AAC9C,wBAAgB,kCAAkC,IAAI,IAAI,CAMzD;AAED,6CAA6C;AAC7C,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,4BAA4B,CAAC,CA+BvC;AAED,4DAA4D;AAC5D,wBAAgB,uCAAuC,CACrD,YAAY,EAAE,KAAK,EACnB,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAOT;AAED,kDAAkD;AAClD,wBAAsB,qCAAqC,CACzD,YAAY,EAAE,KAAK,GAClB,OAAO,CAAC,8BAA8B,CAAC,CA+BzC;AAED,wDAAwD;AACxD,wBAAgB,uCAAuC,CACrD,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG,SAAS,GAClE,oCAAoC,CAgBtC;AAED,iEAAiE;AACjE,wBAAgB,4CAA4C,CAC1D,KAAK,EAAE,oCAAoC,GAC1C,MAAM,CAKR;AAED,sDAAsD;AACtD,wBAAgB,uCAAuC,CAAC,KAAK,EAAE;IAC7D,UAAU,EAAE,oCAAoC,CAAC;IACjD,MAAM,EAAE,8BAA8B,CAAC;CACxC,GAAG,MAAM,GAAG,IAAI,CAiBhB"}

package/esm/src/agent/project/agent-runtime.js

@@ -3,6 +3,7 @@ import { clearTrackedAgents } from "../../discovery/discovery-utils.js";
 import { createProjectDiscoveryConfig } from "../../discovery/project-discovery-config.js";
 import { clearTranspileCache } from "../../discovery/transpiler.js";
 import { getConfig } from "../../config/index.js";
+import { getLocalAdapter } from "../../platform/adapters/registry.js";
 import { clearMCPRegistry } from "../../mcp/index.js";
 import { workflowRegistry } from "../../workflow/registry.js";
 import { agentRegistry } from "../composition/index.js";
@@ -60,7 +61,7 @@ export async function discoverProjectAgentRuntime(input) {
     return await runWithEffectiveSourceIntegrationPolicy(input.sourceIntegrationPolicy, async () => {
         clearProjectAgentRuntimeRegistries();
         const config = input.config ??
-            await getConfig(input.projectDir, input.adapter, input.cacheKey ? { cacheKey: input.cacheKey } : undefined);
+            await getConfig(input.projectDir, input.adapter ?? await getLocalAdapter(), input.cacheKey ? { cacheKey: input.cacheKey } : undefined);
         const discoveryOptions = createProjectDiscoveryConfig({
             projectDir: input.projectDir,
             config,

package/esm/src/discovery/import-rewriter.d.ts

@@ -1,9 +1,3 @@
-/**
- * Import Rewriter
- *
- * Transforms import statements for different runtime environments
- * (Deno, Node.js) and handles veryfront package resolution.
- */
 import { createFileSystem } from "../platform/compat/fs.js";
 export declare const DISCOVERY_GLOBAL_VERYFRONT_MODULES: readonly ["veryfront/agent", "veryfront/tool", "veryfront/platform", "veryfront/prompt", "veryfront/resource", "veryfront/embedding", "veryfront/knowledge", "veryfront/workflow", "veryfront/eval", "veryfront/metrics", "veryfront/schemas", "veryfront/integrations", "veryfront/chat/uploads"];
 interface DenoRewriteOptions {

package/esm/src/discovery/import-rewriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-rewriter.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/import-rewriter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,eAAO,MAAM,kCAAkC,oSAerC,CAAC;AAEX,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAClD;AAkHD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA2BR;AAqFD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CA2PjB"}
+{"version":3,"file":"import-rewriter.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/import-rewriter.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,eAAO,MAAM,kCAAkC,oSAerC,CAAC;AAEX,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAClD;AAwHD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA2BR;AAqFD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAyRjB"}

package/esm/src/discovery/import-rewriter.js

@@ -4,6 +4,7 @@
  * Transforms import statements for different runtime environments
  * (Deno, Node.js) and handles veryfront package resolution.
  */
+import * as dntShim from "../../_dnt.shims.js";
 import { isDenoCompiled } from "../platform/compat/runtime.js";
 import * as pathHelper from "../platform/compat/path/index.js";
 import { LRUCache } from "../utils/lru-wrapper.js";
@@ -93,6 +94,12 @@ function isUnprefixedNpmSpecifier(specifier) {
 // `import type` / `export type` lines reference types only; they get erased
 // by TypeScript and must not trigger filesystem resolution.
 const TYPE_ONLY_STATIC_RE = /(?:^|[\s;{}])(?:import|export)\s+type\b/;
+function isNotFoundError(error) {
+    const DenoNotFound = dntShim.dntGlobalThis.Deno?.errors?.NotFound;
+    if (DenoNotFound && error instanceof DenoNotFound)
+        return true;
+    return error?.code === "ENOENT";
+}
 function rewriteBareNpmImportsForDeno(code) {
     return code
         // `import x from "spec"`, `export { x } from "spec"`, `export * from "spec"`.
@@ -229,6 +236,7 @@ export async function rewriteDiscoveryImports(code, projectDir, fs, fileDir) {
     let transformed = code;
     try {
         const { pathToFileURL } = await import("node:url");
+        const projectRoot = pathHelper.resolve(projectDir);
         // Handle relative imports
         transformed = transformed.replace(/from\s+["'](\.\.\/[^"']+)["']/g, (_match, relativePath) => `from "${pathToFileURL(pathHelper.resolve(fileDir, relativePath)).href}"`);
         // Resolve a bare specifier (optionally with subpath) to a file:// URL,
@@ -238,14 +246,14 @@ export async function rewriteDiscoveryImports(code, projectDir, fs, fileDir) {
         // so a subsequent `npm install` of the missing dep is picked up
         // without a process restart.
         const resolvePackageToFileUrl = async (specifier) => {
-            const cacheKey = `${projectDir}::${specifier}`;
+            const cacheKey = `${projectRoot}::${specifier}`;
             const cached = resolvedSpecifierCache.get(cacheKey);
             if (cached !== undefined)
                 return cached;
             const { name: packageName, subpath } = splitPackageSubpath(specifier);
-            let searchDir = projectDir;
+            let searchDir = projectRoot;
             for (let i = 0; i < 10; i++) {
-                const packagePath = pathHelper.join(searchDir, "node_modules", packageName);
+                const packagePath = pathHelper.resolve(searchDir, "node_modules", packageName);
                 const packageJsonPath = pathHelper.join(packagePath, "package.json");
                 try {
                     const pkgJson = JSON.parse(await fs.readTextFile(packageJsonPath));
@@ -357,40 +365,53 @@ export async function rewriteDiscoveryImports(code, projectDir, fs, fileDir) {
                 .replace(new RegExp(`from\\s*["']${escapedSpecifier}["']`, "g"), `from "${resolvedUrl}"`)
                 .replace(new RegExp(`import\\s*\\(\\s*["']${escapedSpecifier}["']\\s*\\)`, "g"), `import("${resolvedUrl}")`);
         };
-        // Handle veryfront package imports
-        let vfPackagePath = pathHelper.join(projectDir, "node_modules", "veryfront");
-        let exportsMap = {};
-        try {
-            const vfPackageJsonPath = pathHelper.join(vfPackagePath, "package.json");
-            const pkgJson = JSON.parse(await fs.readTextFile(vfPackageJsonPath));
-            exportsMap = pkgJson.exports || {};
-        }
-        catch (_) {
-            /* expected: veryfront package.json not found, fallback to deno.json search */
-            // Search for deno.json in parent directories
-            let searchDir = projectDir;
+        const findVeryfrontExportSource = async () => {
+            const nodePackagePath = pathHelper.resolve(projectRoot, "node_modules", "veryfront");
+            const vfPackageJsonPath = pathHelper.join(nodePackagePath, "package.json");
+            let hasNodePackagePath = false;
+            try {
+                await fs.stat(nodePackagePath);
+                hasNodePackagePath = true;
+            }
+            catch (error) {
+                if (!isNotFoundError(error)) {
+                    return { kind: "present", packagePath: nodePackagePath, exportsMap: undefined };
+                }
+                /* expected: veryfront directory absent, fallback to deno.json search */
+            }
+            if (hasNodePackagePath) {
+                try {
+                    const packageJsonText = await fs.readTextFile(vfPackageJsonPath);
+                    const pkgJson = JSON.parse(packageJsonText);
+                    return { kind: "present", packagePath: nodePackagePath, exportsMap: pkgJson.exports };
+                }
+                catch (_) {
+                    return { kind: "present", packagePath: nodePackagePath, exportsMap: undefined };
+                }
+            }
+            // Search for deno.json in parent directories.
+            let searchDir = projectRoot;
             for (let i = 0; i < 5; i++) {
                 try {
                     const denoJsonPath = pathHelper.join(searchDir, "deno.json");
                     const denoJson = JSON.parse(await fs.readTextFile(denoJsonPath));
-                    if (denoJson.name === "veryfront" && denoJson.exports) {
-                        exportsMap = denoJson.exports;
-                        vfPackagePath = searchDir;
-                        break;
+                    if (denoJson.name === "veryfront" && "exports" in denoJson) {
+                        return {
+                            kind: "present",
+                            packagePath: pathHelper.resolve(searchDir),
+                            exportsMap: denoJson.exports,
+                        };
                     }
                 }
                 catch (_) {
                     /* expected: deno.json not found at this level */
                 }
-                searchDir = pathHelper.dirname(searchDir);
+                const parent = pathHelper.dirname(searchDir);
+                if (parent === searchDir)
+                    break;
+                searchDir = parent;
             }
-        }
-        const getExportPath = (entry) => {
-            if (!entry)
-                return null;
-            if (typeof entry === "string")
-                return entry;
-            return entry.import ?? null;
+            return { kind: "absent" };
         };
         const veryfrontSpecifiers = new Set();
         for (const match of transformed.matchAll(/from\s+["'](veryfront(?:\/[^"']+)?)["']/g)) {
@@ -403,29 +424,40 @@ export async function rewriteDiscoveryImports(code, projectDir, fs, fileDir) {
             if (specifier)
                 veryfrontSpecifiers.add(specifier);
         }
+        const veryfrontExportSource = await findVeryfrontExportSource();
+        const resolveVeryfrontExportToFileUrl = (specifier) => {
+            if (veryfrontExportSource.kind === "absent")
+                return { kind: "rejected" };
+            const subpath = specifier === "veryfront" ? "." : "./" + specifier.replace("veryfront/", "");
+            const exportPath = resolveExportPath(veryfrontExportSource.exportsMap, subpath);
+            if (!exportPath)
+                return { kind: "rejected" };
+            const packagePath = veryfrontExportSource.packagePath;
+            const resolvedPath = pathHelper.resolve(packagePath, exportPath);
+            const packagePathPrefix = packagePath.endsWith(pathHelper.SEPARATOR)
+                ? packagePath
+                : packagePath + pathHelper.SEPARATOR;
+            if (resolvedPath !== packagePath && !resolvedPath.startsWith(packagePathPrefix)) {
+                return { kind: "rejected" };
+            }
+            return { kind: "resolved", url: pathToFileURL(resolvedPath).href };
+        };
         for (const specifier of veryfrontSpecifiers) {
-            const resolvedUrl = resolveRuntimeSpecifierToFileUrl(specifier);
-            if (resolvedUrl) {
-                transformed = rewriteResolvedSpecifierImports(transformed, specifier, resolvedUrl);
+            if (veryfrontExportSource.kind === "absent")
+                continue;
+            const result = resolveVeryfrontExportToFileUrl(specifier);
+            if (result.kind === "resolved") {
+                transformed = rewriteResolvedSpecifierImports(transformed, specifier, result.url);
+            }
+        }
+        if (veryfrontExportSource.kind === "absent") {
+            for (const specifier of veryfrontSpecifiers) {
+                const resolvedUrl = resolveRuntimeSpecifierToFileUrl(specifier);
+                if (resolvedUrl) {
+                    transformed = rewriteResolvedSpecifierImports(transformed, specifier, resolvedUrl);
+                }
             }
         }
-        // Rewrite veryfront subpath imports
-        transformed = transformed.replace(/from\s+["'](veryfront\/[^"']+)["']/g, (match, fullSpecifier) => {
-            const subpath = "./" + fullSpecifier.replace("veryfront/", "");
-            const exportPath = getExportPath(exportsMap[subpath]);
-            if (!exportPath)
-                return match;
-            const resolvedPath = pathHelper.join(vfPackagePath, exportPath);
-            return `from "${pathToFileURL(resolvedPath).href}"`;
-        });
-        // Rewrite bare veryfront import
-        transformed = transformed.replace(/from\s+["']veryfront["']/g, () => {
-            const exportPath = getExportPath(exportsMap["."]);
-            if (!exportPath)
-                return 'from "veryfront"';
-            const resolvedPath = pathHelper.join(vfPackagePath, exportPath);
-            return `from "${pathToFileURL(resolvedPath).href}"`;
-        });
     }
     catch (_) {
         /* expected: Node.js URL module unavailable in non-Node runtime */

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

@@ -53,7 +53,7 @@ export declare class LazySandbox {
     private heartbeatPromise;
     private heartbeatTimer;
     private lastHeartbeatAt;
-    private readonly activeBackgroundCommandEndpoints;
+    private readonly activeBackgroundCommands;
     constructor(options?: LazySandboxOptions);
     ensure(): Promise<void>;
     executeCommand(command: string, options?: ExecOptions): Promise<ExecResult>;
@@ -90,15 +90,16 @@ export declare class LazySandbox {
     private resolveProjectId;
     private resetSessionState;
     private resolveExecOptions;
-    private resolveBackgroundCommandEndpoint;
+    private resolveBackgroundCommandRoute;
     private updateTrackedBackgroundCommand;
+    private hasActiveInternalBackgroundCommand;
     private startExec;
     private fetchExecStart;
     private fetchControl;
     private waitForExecStartRetry;
     private reprovisionAfterExecStartFailure;
-    private resolveRuntimeEndpoint;
     private resolveRuntimeEndpointFor;
+    private resolveDataPlaneRoute;
     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":"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"}

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

@@ -2,6 +2,7 @@ import { REQUEST_ERROR } from "../errors/index.js";
 import { getHostEnv } from "../platform/compat/process.js";
 import { logger } from "../utils/index.js";
 import { resolveSandboxApiUrl, resolveSandboxAuthToken } from "./config.js";
+import { readSandboxFileContent, sandboxSessionRoute } from "./proxy-routes.js";
 const DEFAULT_STARTUP_TIMEOUT_MS = 180_000;
 const DEFAULT_POLL_INTERVAL_MS = 2_000;
 const DEFAULT_HEARTBEAT_INTERVAL_MS = 30_000;
@@ -39,6 +40,9 @@ export function resolveDefaultSandboxRuntimeEndpoint(input) {
     }
     return `http://sandbox.veryfront-sandbox-${shortId}.svc.cluster.local`;
 }
+function normalizeDataPlaneBaseUrl(url) {
+    return url.trim().replace(/\/+$/, "");
+}
 /** Lazily provisions sandbox sessions and keeps them alive while in use. */
 export class LazySandbox {
     apiUrl;
@@ -64,7 +68,7 @@ export class LazySandbox {
     heartbeatPromise = null;
     heartbeatTimer = null;
     lastHeartbeatAt = 0;
-    activeBackgroundCommandEndpoints = new Map();
+    activeBackgroundCommands = new Map();
     constructor(options = {}) {
         this.apiUrl = resolveSandboxApiUrl(options);
         this.authToken = resolveSandboxAuthToken(options);
@@ -141,36 +145,48 @@ export class LazySandbox {
         const reader = res.body.getReader();
         const decoder = new TextDecoder();
         let buffer = "";
-        while (true) {
-            const { done, value } = await reader.read();
-            if (done)
-                break;
-            buffer += decoder.decode(value, { stream: true });
-            const lines = buffer.split("\n");
-            buffer = lines.pop() ?? "";
-            for (const line of lines) {
-                if (!line.trim())
-                    continue;
-                yield JSON.parse(line);
+        let completed = false;
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    completed = true;
+                    break;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    yield JSON.parse(line);
+                }
+            }
+            buffer += decoder.decode();
+            if (buffer.trim()) {
+                yield JSON.parse(buffer);
             }
         }
-        if (buffer.trim()) {
-            yield JSON.parse(buffer);
+        finally {
+            if (!completed) {
+                await reader.cancel().catch(() => { });
+            }
+            reader.releaseLock();
         }
     }
     async readFile(path) {
         await this.touchSession();
-        const res = await this.fetchControl(`${this.requireEndpoint()}/file?path=${encodeURIComponent(path)}`, {
+        const res = await this.fetchControl(`${this.resolveDataPlaneRoute().baseUrl}/file?path=${encodeURIComponent(path)}`, {
             headers: this.authHeaders(),
         });
         if (!res.ok) {
             throw REQUEST_ERROR.create({ detail: `Read file failed: ${res.status} ${await res.text()}` });
         }
-        return await res.text();
+        return await readSandboxFileContent(res);
     }
     async writeFiles(files) {
         await this.touchSession();
-        const res = await this.fetchControl(`${this.requireEndpoint()}/files`, {
+        const res = await this.fetchControl(`${this.resolveDataPlaneRoute().baseUrl}/files`, {
             method: "POST",
             headers: this.jsonHeaders(),
             body: JSON.stringify({ files }),
@@ -183,8 +199,9 @@ export class LazySandbox {
     }
     async startBackgroundCommand(command, options) {
         await this.touchSession();
-        const endpoint = this.resolveRuntimeEndpoint();
-        const res = await this.fetchControl(`${endpoint}/exec/commands`, {
+        const route = this.resolveDataPlaneRoute();
+        const commandsUrl = backgroundCommandsUrl(route);
+        const res = await this.fetchControl(commandsUrl, {
             method: "POST",
             headers: this.jsonHeaders(),
             body: JSON.stringify({ command, ...this.resolveExecOptions(options) }),
@@ -195,12 +212,15 @@ export class LazySandbox {
             });
         }
         const backgroundCommand = mapBackgroundCommand(await res.json());
-        this.updateTrackedBackgroundCommand(backgroundCommand, endpoint);
+        this.updateTrackedBackgroundCommand(backgroundCommand, {
+            commandsUrl,
+            routeKind: route.kind,
+        });
         return backgroundCommand;
     }
     async getBackgroundCommand(commandId) {
-        const endpoint = await this.resolveBackgroundCommandEndpoint(commandId);
-        const res = await this.fetchControl(`${endpoint}/exec/commands/${encodeURIComponent(commandId)}`, {
+        const route = await this.resolveBackgroundCommandRoute(commandId);
+        const res = await this.fetchControl(`${route.commandsUrl}/${encodeURIComponent(commandId)}`, {
             headers: this.authHeaders(),
         });
         if (!res.ok) {
@@ -209,12 +229,12 @@ export class LazySandbox {
             });
         }
         const backgroundCommand = mapBackgroundCommand(await res.json());
-        this.updateTrackedBackgroundCommand(backgroundCommand, endpoint);
+        this.updateTrackedBackgroundCommand(backgroundCommand, route);
         return backgroundCommand;
     }
     async getBackgroundCommandOutput(commandId) {
-        const endpoint = await this.resolveBackgroundCommandEndpoint(commandId);
-        const res = await this.fetchControl(`${endpoint}/exec/commands/${encodeURIComponent(commandId)}/output`, {
+        const route = await this.resolveBackgroundCommandRoute(commandId);
+        const res = await this.fetchControl(`${route.commandsUrl}/${encodeURIComponent(commandId)}/output`, {
             headers: this.authHeaders(),
         });
         if (!res.ok) {
@@ -230,12 +250,12 @@ export class LazySandbox {
             stdoutTruncated: json.stdout_truncated,
             stderrTruncated: json.stderr_truncated,
         };
-        this.updateTrackedBackgroundCommand(output, endpoint);
+        this.updateTrackedBackgroundCommand(output, route);
         return output;
     }
     async listBackgroundCommands() {
         await this.ensure();
-        const res = await this.fetchControl(`${this.requireEndpoint()}/exec/commands`, {
+        const res = await this.fetchControl(backgroundCommandsUrl(this.resolveDataPlaneRoute()), {
             headers: this.authHeaders(),
         });
         if (!res.ok) {
@@ -248,8 +268,8 @@ export class LazySandbox {
         return commands.map((command) => mapBackgroundCommand(command));
     }
     async cancelBackgroundCommand(commandId) {
-        const endpoint = await this.resolveBackgroundCommandEndpoint(commandId);
-        const res = await this.fetchControl(`${endpoint}/exec/commands/${encodeURIComponent(commandId)}/cancel`, {
+        const route = await this.resolveBackgroundCommandRoute(commandId);
+        const res = await this.fetchControl(`${route.commandsUrl}/${encodeURIComponent(commandId)}/cancel`, {
             method: "POST",
             headers: this.authHeaders(),
         });
@@ -259,7 +279,7 @@ export class LazySandbox {
             });
         }
         const backgroundCommand = mapBackgroundCommand(await res.json());
-        this.updateTrackedBackgroundCommand(backgroundCommand, endpoint);
+        this.updateTrackedBackgroundCommand(backgroundCommand, route);
         return backgroundCommand;
     }
     async heartbeat(force = false) {
@@ -282,7 +302,7 @@ export class LazySandbox {
                 });
                 if (!res.ok) {
                     if (this.sessionId === currentSessionId) {
-                        if (this.activeBackgroundCommandEndpoints.size === 0) {
+                        if (this.activeBackgroundCommands.size === 0) {
                             await this.deleteSession(currentSessionId);
                             this.resetSessionState(currentSessionId);
                         }
@@ -497,7 +517,7 @@ export class LazySandbox {
     heartbeatFailureCount = 0;
     static HEARTBEAT_WARN_AFTER_FAILURES = 3;
     startHeartbeatLoop() {
-        if (!this.sessionId || this.heartbeatTimer || this.activeBackgroundCommandEndpoints.size > 0) {
+        if (!this.sessionId || this.heartbeatTimer || this.hasActiveInternalBackgroundCommand()) {
             return;
         }
         this.heartbeatTimer = setInterval(() => {
@@ -536,7 +556,7 @@ export class LazySandbox {
     resetSessionState(sessionId) {
         if (!sessionId || this.sessionId === sessionId) {
             this.stopHeartbeatLoop();
-            this.activeBackgroundCommandEndpoints.clear();
+            this.activeBackgroundCommands.clear();
             this.endpoint = null;
             this.sessionId = null;
             this.sessionProjectId = null;
@@ -548,33 +568,47 @@ export class LazySandbox {
         const projectReference = options?.projectReference ?? this.resolveProjectId() ?? undefined;
         return projectReference ? { ...options, projectReference } : options;
     }
-    async resolveBackgroundCommandEndpoint(commandId) {
-        const trackedEndpoint = this.activeBackgroundCommandEndpoints.get(commandId);
-        if (trackedEndpoint) {
-            return trackedEndpoint;
+    async resolveBackgroundCommandRoute(commandId) {
+        const trackedCommand = this.activeBackgroundCommands.get(commandId);
+        if (trackedCommand) {
+            return trackedCommand;
         }
         await this.ensure();
-        return this.resolveRuntimeEndpoint();
+        const route = this.resolveDataPlaneRoute();
+        return {
+            commandsUrl: backgroundCommandsUrl(route),
+            routeKind: route.kind,
+        };
     }
-    updateTrackedBackgroundCommand(backgroundCommand, endpoint) {
+    updateTrackedBackgroundCommand(backgroundCommand, command) {
         if (backgroundCommand.status === "running") {
-            this.activeBackgroundCommandEndpoints.set(backgroundCommand.id, endpoint);
-            this.stopHeartbeatLoop();
+            this.activeBackgroundCommands.set(backgroundCommand.id, command);
+            if (command.routeKind === "internal") {
+                this.stopHeartbeatLoop();
+            }
             return;
         }
-        if (!this.activeBackgroundCommandEndpoints.delete(backgroundCommand.id)) {
+        if (!this.activeBackgroundCommands.delete(backgroundCommand.id)) {
             return;
         }
-        if (this.activeBackgroundCommandEndpoints.size === 0 && this.endpoint) {
+        if (!this.hasActiveInternalBackgroundCommand() && this.endpoint) {
             this.startHeartbeatLoop();
         }
     }
+    hasActiveInternalBackgroundCommand() {
+        for (const command of this.activeBackgroundCommands.values()) {
+            if (command.routeKind === "internal") {
+                return true;
+            }
+        }
+        return false;
+    }
     async startExec(command, options) {
-        const endpoint = this.resolveRuntimeEndpoint();
+        const route = this.resolveDataPlaneRoute();
         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`, {
+                const res = await this.fetchExecStart(commandStreamUrl(route), {
                     method: "POST",
                     headers: this.jsonHeaders(),
                     body,
@@ -615,15 +649,24 @@ export class LazySandbox {
         }
         this.resetSessionState(sessionId);
     }
-    resolveRuntimeEndpoint() {
-        const endpoint = this.requireEndpoint();
-        const sessionId = this.requireSessionId();
-        return this.resolveRuntimeEndpointFor(endpoint, sessionId);
-    }
     resolveRuntimeEndpointFor(endpoint, sessionId) {
         return this.resolveRuntimeEndpointOption?.({ endpoint, sessionId }) ??
             resolveDefaultSandboxRuntimeEndpoint({ endpoint });
     }
+    resolveDataPlaneRoute() {
+        const endpoint = this.requireEndpoint();
+        const sessionId = this.requireSessionId();
+        const runtimeEndpoint = this.resolveRuntimeEndpointFor(endpoint, sessionId);
+        const normalizedEndpoint = normalizeDataPlaneBaseUrl(endpoint);
+        const normalizedRuntimeEndpoint = normalizeDataPlaneBaseUrl(runtimeEndpoint);
+        if (normalizedRuntimeEndpoint !== normalizedEndpoint) {
+            return { baseUrl: normalizedRuntimeEndpoint, kind: "internal" };
+        }
+        return {
+            baseUrl: sandboxSessionRoute(this.apiUrl, sessionId),
+            kind: "proxy",
+        };
+    }
     requireSessionId() {
         if (!this.sessionId) {
             throw new Error("Sandbox session unavailable");
@@ -643,6 +686,12 @@ export class LazySandbox {
 function isRetryableExecStartStatus(status) {
     return status === 502 || status === 503 || status === 504;
 }
+function commandStreamUrl(route) {
+    return `${route.baseUrl}${route.kind === "internal" ? "/exec" : "/commands/stream"}`;
+}
+function backgroundCommandsUrl(route) {
+    return `${route.baseUrl}${route.kind === "internal" ? "/exec/commands" : "/commands"}`;
+}
 /**
  * Heuristic: Deno's fetch throws an `Error` with message "fetch failed" (case-
  * insensitive) when the TCP connection is refused or the host is unreachable.

package/esm/src/sandbox/proxy-routes.d.ts

@@ -0,0 +1,3 @@
+export declare function sandboxSessionRoute(apiUrl: string, sessionId: string, path?: string): string;
+export declare function readSandboxFileContent(res: Response): Promise<string>;
+//# sourceMappingURL=proxy-routes.d.ts.map

package/esm/src/sandbox/proxy-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-routes.d.ts","sourceRoot":"","sources":["../../../src/src/sandbox/proxy-routes.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,SAAK,GACR,MAAM,CAGR;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB3E"}

package/esm/src/sandbox/proxy-routes.js

@@ -0,0 +1,28 @@
+import { REQUEST_ERROR } from "../errors/index.js";
+export function sandboxSessionRoute(apiUrl, sessionId, path = "") {
+    const base = `${apiUrl.replace(/\/+$/, "")}/sandbox-sessions/${encodeURIComponent(sessionId)}`;
+    return path ? `${base}${path}` : base;
+}
+export async function readSandboxFileContent(res) {
+    const contentType = res.headers.get("Content-Type") ?? "";
+    if (!contentType.toLowerCase().includes("application/json")) {
+        return await res.text();
+    }
+    let json;
+    try {
+        json = await res.json();
+    }
+    catch (cause) {
+        throw REQUEST_ERROR.create({
+            detail: "Sandbox file response is not valid JSON",
+            cause,
+        });
+    }
+    const content = json && typeof json === "object"
+        ? json.content
+        : undefined;
+    if (typeof content !== "string") {
+        throw REQUEST_ERROR.create({ detail: "Sandbox file response missing content" });
+    }
+    return content;
+}

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/sandbox/sandbox.js

@@ -9,6 +9,7 @@
 import { INITIALIZATION_ERROR, REQUEST_ERROR, TIMEOUT_ERROR } from "../errors/index.js";
 import { LazySandbox } from "./lazy-sandbox.js";
 import { resolveSandboxApiUrl, resolveSandboxAuthToken } from "./config.js";
+import { readSandboxFileContent, sandboxSessionRoute } from "./proxy-routes.js";
 export { resolveSandboxApiUrl, resolveSandboxAuthToken } from "./config.js";
 /** Client for isolated ephemeral compute environments with command execution and file I/O. */
 export class Sandbox {
@@ -138,7 +139,7 @@ export class Sandbox {
     }
     /** Execute a bash command with streaming output (NDJSON). */
     async *executeStream(command, options) {
-        const res = await fetch(`${this.endpoint}/exec`, {
+        const res = await fetch(sandboxSessionRoute(this.apiUrl, this.sessionId, "/commands/stream"), {
             method: "POST",
             headers: {
                 Authorization: `Bearer ${this.authToken}`,
@@ -155,47 +156,59 @@ export class Sandbox {
         const reader = res.body.getReader();
         const decoder = new TextDecoder();
         let buffer = "";
-        while (true) {
-            const { done, value } = await reader.read();
-            if (done)
-                break;
-            buffer += decoder.decode(value, { stream: true });
-            const lines = buffer.split("\n");
-            buffer = lines.pop();
-            for (const line of lines) {
-                if (line.trim()) {
-                    try {
-                        yield JSON.parse(line);
-                    }
-                    catch {
-                        // Malformed NDJSON line (e.g. truncated network chunk); skip and
-                        // continue streaming so already-buffered output is not lost.
+        let completed = false;
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    completed = true;
+                    break;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop();
+                for (const line of lines) {
+                    if (line.trim()) {
+                        try {
+                            yield JSON.parse(line);
+                        }
+                        catch {
+                            // Malformed NDJSON line (e.g. truncated network chunk); skip and
+                            // continue streaming so already-buffered output is not lost.
+                        }
                     }
                 }
             }
-        }
-        if (buffer.trim()) {
-            try {
-                yield JSON.parse(buffer);
+            buffer += decoder.decode();
+            if (buffer.trim()) {
+                try {
+                    yield JSON.parse(buffer);
+                }
+                catch {
+                    // Malformed final chunk; discard rather than surfacing a SyntaxError.
+                }
             }
-            catch {
-                // Malformed final chunk; discard rather than surfacing a SyntaxError.
+        }
+        finally {
+            if (!completed) {
+                await reader.cancel().catch(() => { });
             }
+            reader.releaseLock();
         }
     }
     /** Read a file from the sandbox workspace. */
     async readFile(path) {
-        const res = await fetch(`${this.endpoint}/file?path=${encodeURIComponent(path)}`, {
+        const res = await fetch(sandboxSessionRoute(this.apiUrl, this.sessionId, `/file?path=${encodeURIComponent(path)}`), {
             headers: { Authorization: `Bearer ${this.authToken}` },
         });
         if (!res.ok) {
             throw REQUEST_ERROR.create({ detail: `Read file failed: ${res.status} ${await res.text()}` });
         }
-        return res.text();
+        return await readSandboxFileContent(res);
     }
     /** Write files to the sandbox workspace. */
     async writeFiles(files) {
-        const res = await fetch(`${this.endpoint}/files`, {
+        const res = await fetch(sandboxSessionRoute(this.apiUrl, this.sessionId, "/files"), {
             method: "POST",
             headers: {
                 Authorization: `Bearer ${this.authToken}`,
@@ -211,7 +224,7 @@ export class Sandbox {
     }
     /** Start an async background command in the sandbox. */
     async startBackgroundCommand(command, options) {
-        const res = await fetch(`${this.endpoint}/exec/commands`, {
+        const res = await fetch(sandboxSessionRoute(this.apiUrl, this.sessionId, "/commands"), {
             method: "POST",
             headers: {
                 Authorization: `Bearer ${this.authToken}`,
@@ -228,7 +241,7 @@ export class Sandbox {
     }
     /** Get the status of an async background command. */
     async getBackgroundCommand(commandId) {
-        const res = await fetch(`${this.endpoint}/exec/commands/${encodeURIComponent(commandId)}`, {
+        const res = await fetch(sandboxSessionRoute(this.apiUrl, this.sessionId, `/commands/${encodeURIComponent(commandId)}`), {
             headers: { Authorization: `Bearer ${this.authToken}` },
         });
         if (!res.ok) {
@@ -240,7 +253,7 @@ export class Sandbox {
     }
     /** Get the output of an async background command. */
     async getBackgroundCommandOutput(commandId) {
-        const res = await fetch(`${this.endpoint}/exec/commands/${encodeURIComponent(commandId)}/output`, {
+        const res = await fetch(sandboxSessionRoute(this.apiUrl, this.sessionId, `/commands/${encodeURIComponent(commandId)}/output`), {
             headers: { Authorization: `Bearer ${this.authToken}` },
         });
         if (!res.ok) {
@@ -259,7 +272,7 @@ export class Sandbox {
     }
     /** List all background commands in the sandbox. */
     async listBackgroundCommands() {
-        const res = await fetch(`${this.endpoint}/exec/commands`, {
+        const res = await fetch(sandboxSessionRoute(this.apiUrl, this.sessionId, "/commands"), {
             headers: { Authorization: `Bearer ${this.authToken}` },
         });
         if (!res.ok) {
@@ -273,7 +286,7 @@ export class Sandbox {
     }
     /** Cancel an async background command. */
     async cancelBackgroundCommand(commandId) {
-        const res = await fetch(`${this.endpoint}/exec/commands/${encodeURIComponent(commandId)}/cancel`, {
+        const res = await fetch(sandboxSessionRoute(this.apiUrl, this.sessionId, `/commands/${encodeURIComponent(commandId)}/cancel`), {
             method: "POST",
             headers: { Authorization: `Bearer ${this.authToken}` },
         });

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

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.1113";
+export declare const VERSION = "0.1.1114";
 //# sourceMappingURL=version-constant.d.ts.map

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

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.1113";
+export const VERSION = "0.1.1114";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.1113",
+  "version": "0.1.1114",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -332,10 +332,10 @@
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "ws": "8.21.0",
-    "@veryfront/ext-bundler-esbuild": "0.1.1113",
-    "@veryfront/ext-content-mdx": "0.1.1113",
-    "@veryfront/ext-css-tailwind": "0.1.1113",
-    "@veryfront/ext-parser-babel": "0.1.1113"
+    "@veryfront/ext-bundler-esbuild": "0.1.1114",
+    "@veryfront/ext-content-mdx": "0.1.1114",
+    "@veryfront/ext-css-tailwind": "0.1.1114",
+    "@veryfront/ext-parser-babel": "0.1.1114"
   },
   "devDependencies": {
     "@types/node": "20.9.0"