veryfront 0.1.13 → 0.1.15

package/esm/cli/commands/init/interactive-wizard.js

@@ -4,13 +4,21 @@ import { isCiEnv, isDenoTestingEnv } from "../../../src/config/index.js";
 import { isInteractive as checkIsInteractive } from "../../../src/platform/index.js";
 import { select, textInput } from "../../utils/terminal-select.js";
 import { getTemplateSelectOptions, TEMPLATES } from "./catalog.js";
+/** Reject path separators and traversal so the name stays a single directory. */
+export function validateProjectName(name) {
+    if (/[/\\]/.test(name))
+        return 'Project name cannot contain "/" or "\\"';
+    if (name === "." || name === "..")
+        return 'Project name cannot be "." or ".."';
+    return null;
+}
 function canRunWizard() {
     return !(isCiEnv() || isDenoTestingEnv()) && checkIsInteractive();
 }
-export async function runInteractiveWizard() {
+export async function runInteractiveWizard(existingName) {
     if (!canRunWizard()) {
         return {
-            projectName: null,
+            projectName: existingName ?? null,
             template: "minimal",
             initGit: false,
             skipped: true,
@@ -24,25 +32,22 @@ export async function runInteractiveWizard() {
     console.log(`┌  ${brand("Veryfront")}`);
     console.log(`│  Let's set up your project.`);
     console.log("│");
-    // Step 1: Location prompt
-    const locationChoice = await select("Where should we create your project?", [
-        { value: "current", label: "Current folder", description: "Use this directory" },
-        { value: "new", label: "New folder", description: "Create a new directory" },
-    ], 0);
-    if (locationChoice === null) {
-        console.log(muted("\n  Cancelled.\n"));
-        return {
-            projectName: null,
-            template: "minimal",
-            initGit: false,
-            skipped: false,
-            cancelled: true,
-        };
-    }
-    let projectName = null;
-    if (locationChoice === "new") {
-        const name = await textInput("Project name", "my-app");
-        if (name === null) {
+    let projectName = existingName ?? null;
+    // Location prompt (skip when name was provided via CLI)
+    if (!existingName) {
+        const locationChoice = await select("Where should we create your project?", [
+            {
+                value: "current",
+                label: "Current folder",
+                description: "Use this directory",
+            },
+            {
+                value: "new",
+                label: "New folder",
+                description: "Create a new directory",
+            },
+        ], 0);
+        if (locationChoice === null) {
             console.log(muted("\n  Cancelled.\n"));
             return {
                 projectName: null,
@@ -52,11 +57,34 @@ export async function runInteractiveWizard() {
                 cancelled: true,
             };
         }
-        if (name) {
-            projectName = name;
+        if (locationChoice === "new") {
+            const name = await textInput("Project name", "my-app");
+            if (name === null) {
+                console.log(muted("\n  Cancelled.\n"));
+                return {
+                    projectName: null,
+                    template: "minimal",
+                    initGit: false,
+                    skipped: false,
+                    cancelled: true,
+                };
+            }
+            const validName = name || "my-app";
+            const nameError = validateProjectName(validName);
+            if (nameError) {
+                console.log(muted(`\n  ${nameError}\n`));
+                return {
+                    projectName: null,
+                    template: "minimal",
+                    initGit: false,
+                    skipped: false,
+                    cancelled: true,
+                };
+            }
+            projectName = validName;
         }
     }
-    // Step 2: Template selection
+    // Template selection
     const templateChoice = await select("What would you like to build?", getTemplateSelectOptions(), 0);
     if (templateChoice === null) {
         console.log(muted("\n  Cancelled.\n"));
@@ -69,7 +97,7 @@ export async function runInteractiveWizard() {
         };
     }
     const template = templateChoice;
-    // Step 3: Git init prompt
+    // Git init prompt
     const gitChoice = await select("Initialize a git repository?", [
         { value: "yes", label: "Yes", description: "Initialize git and create first commit" },
         { value: "no", label: "No", description: "Skip git initialization" },
@@ -102,6 +130,6 @@ export async function runInteractiveWizard() {
     return { projectName, template, initGit, skipped: false, cancelled: false };
 }
 export function shouldRunWizard(options) {
-    // Run wizard if no template and no name specified via CLI
-    return !options.template && !options.name;
+    // Always run wizard unless template is explicitly specified via --template
+    return !options.template;
 }

package/esm/cli/mcp/remote-file-tools.d.ts

@@ -259,17 +259,14 @@ interface RemoteDeleteBranchOutput {
 }
 export declare const vfRemoteDeleteBranch: MCPTool<RemoteDeleteBranchInput, RemoteDeleteBranchOutput>;
 declare const remoteCreateProjectInput: z.ZodObject<{
-    name: z.ZodString;
     slug: z.ZodString;
     template: z.ZodOptional<z.ZodString>;
     is_public: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    name: string;
     slug: string;
     template?: string | undefined;
     is_public?: boolean | undefined;
 }, {
-    name: string;
     slug: string;
     template?: string | undefined;
     is_public?: boolean | undefined;
@@ -283,17 +280,14 @@ interface RemoteCreateProjectOutput {
 export declare const vfRemoteCreateProject: MCPTool<RemoteCreateProjectInput, RemoteCreateProjectOutput>;
 declare const remoteCloneProjectInput: z.ZodObject<{
     source_project: z.ZodString;
-    target_name: z.ZodString;
     target_slug: z.ZodString;
     file_pattern: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     source_project: string;
-    target_name: string;
     target_slug: string;
     file_pattern?: string | undefined;
 }, {
     source_project: string;
-    target_name: string;
     target_slug: string;
     file_pattern?: string | undefined;
 }>;

package/esm/cli/mcp/remote-file-tools.d.ts.map

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

package/esm/cli/mcp/remote-file-tools.js

@@ -12,6 +12,7 @@ import * as dntShim from "../../_dnt.shims.js";
 import { z } from "zod";
 import { getEnvironmentConfig } from "../../src/config/index.js";
 import { withSpan } from "../../src/observability/tracing/otlp-setup.js";
+import { randomSuffix } from "../shared/slug.js";
 import { DEFAULT_LOCAL_API_URL } from "../shared/constants.js";
 function getApiBaseUrl() {
     return getEnvironmentConfig().apiBaseUrl || DEFAULT_LOCAL_API_URL;
@@ -67,6 +68,35 @@ function getBranchPath(branch) {
 function getBranchParam(branch) {
     return branch ? `?branch_id=${branch}` : "";
 }
+const MAX_SLUG_ATTEMPTS = 10;
+function slugToName(slug) {
+    return slug
+        .split("-")
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+/**
+ * Create a project with slug conflict retry.
+ * On 409, appends a random suffix and retries (matches reserveProjectSlug behavior).
+ * Name is derived from the base slug (without random suffix) for readability.
+ */
+async function createProjectWithRetry(slug, body) {
+    const name = slugToName(slug);
+    let currentSlug = slug;
+    for (let attempt = 1; attempt <= MAX_SLUG_ATTEMPTS; attempt++) {
+        const result = await apiRequest("POST", "/projects", {
+            body: { ...body, slug: currentSlug, name },
+        });
+        if (result.ok && result.data) {
+            return { ok: true, data: result.data, slug: currentSlug };
+        }
+        if (result.status !== 409) {
+            return { ok: false, error: result.error ?? "Failed to create project" };
+        }
+        currentSlug = `${slug}-${randomSuffix()}`;
+    }
+    return { ok: false, error: `Could not find available slug after ${MAX_SLUG_ATTEMPTS} attempts` };
+}
 // ============================================================================
 // Tool: vf_remote_list_files
 // ============================================================================
@@ -333,8 +363,7 @@ export const vfRemoteDeleteBranch = {
 // Tool: vf_remote_create_project
 // ============================================================================
 const remoteCreateProjectInput = z.object({
-    name: z.string().describe("Project name"),
-    slug: z.string().describe("Project slug (lowercase letters, numbers, hyphens only)"),
+    slug: z.string().describe("Project slug (lowercase letters, numbers, hyphens only). A random suffix is appended if the slug is already taken."),
     template: z.string().optional().describe("Template to use (e.g., 'chat', 'rag', 'minimal')"),
     is_public: z.boolean().optional().describe("Whether the project is public (default: false)"),
 });
@@ -343,13 +372,9 @@ export const vfRemoteCreateProject = {
     description: "Create a new Veryfront project. Returns the project details including ID and slug.",
     inputSchema: remoteCreateProjectInput,
     execute: async (input) => {
-        const result = await apiRequest("POST", "/projects", {
-            body: {
-                name: input.name,
-                slug: input.slug,
-                template: input.template,
-                isPublic: input.is_public,
-            },
+        const result = await createProjectWithRetry(input.slug, {
+            template: input.template,
+            isPublic: input.is_public,
         });
         if (!result.ok)
             return { success: false, error: result.error };
@@ -361,8 +386,7 @@ export const vfRemoteCreateProject = {
 // ============================================================================
 const remoteCloneProjectInput = z.object({
     source_project: z.string().describe("Source project slug or ID to clone from"),
-    target_name: z.string().describe("Name for the new project"),
-    target_slug: z.string().describe("Slug for the new project (lowercase letters, numbers, hyphens only)"),
+    target_slug: z.string().describe("Slug for the new project (lowercase letters, numbers, hyphens only). A random suffix is appended if the slug is already taken."),
     file_pattern: z.string().optional().describe("Optional file pattern to filter which files to clone (e.g., '*.tsx')"),
 });
 export const vfRemoteCloneProject = {
@@ -370,9 +394,7 @@ export const vfRemoteCloneProject = {
     description: "Clone a Veryfront project by creating a new project and copying all files from the source.",
     inputSchema: remoteCloneProjectInput,
     execute: (input) => withSpan("cli.mcp.tool.vf_remote_clone_project", async () => {
-        const createResult = await apiRequest("POST", "/projects", {
-            body: { name: input.target_name, slug: input.target_slug },
-        });
+        const createResult = await createProjectWithRetry(input.target_slug, {});
         if (!createResult.ok) {
             return { success: false, error: `Failed to create project: ${createResult.error}` };
         }
@@ -400,7 +422,7 @@ export const vfRemoteCloneProject = {
                 errors.push(`Failed to read ${file.path}`);
                 continue;
             }
-            const createFileResult = await apiRequest("PUT", `/${input.target_slug}/files/${encodeFilePath(file.path)}`, { body: { content: getResult.data.content } });
+            const createFileResult = await apiRequest("PUT", `/${createResult.slug}/files/${encodeFilePath(file.path)}`, { body: { content: getResult.data.content } });
             if (createFileResult.ok) {
                 filesCopied++;
             }

package/esm/cli/shared/reserve-slug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reserve-slug.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/reserve-slug.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,2BAA2B,CAAC;AAGzF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAmBD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,iBAA0C,GAC9C,OAAO,CAAC,aAAa,CAAC,CAsBxB;AAkCD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,iBAA0C,GAC9C,OAAO,CAAC,OAAO,CAAC,CAWlB"}
+{"version":3,"file":"reserve-slug.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/reserve-slug.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,2BAA2B,CAAC;AAQzF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAmBD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,iBAA0C,GAC9C,OAAO,CAAC,aAAa,CAAC,CAuBxB;AAmCD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,iBAA0C,GAC9C,OAAO,CAAC,OAAO,CAAC,CAWlB"}

package/esm/cli/shared/reserve-slug.js

@@ -7,15 +7,20 @@
  */
 import * as dntShim from "../../_dnt.shims.js";
 import { getEnvironmentConfig } from "../../src/config/index.js";
+import { capitalizeSeparatedWords } from "../../src/utils/case-utils.js";
 import { randomSuffix } from "./slug.js";
+function slugToName(slug) {
+    return capitalizeSeparatedWords(slug, "-", " ");
+}
 const MAX_SLUG_ATTEMPTS = 10;
 function getApiUrl(env = getEnvironmentConfig()) {
     return env.apiUrl ?? "https://api.veryfront.com";
 }
 export async function reserveProjectSlug(slug, token, env = getEnvironmentConfig()) {
+    const name = slugToName(slug);
     let currentSlug = slug;
     for (let attempt = 1; attempt <= MAX_SLUG_ATTEMPTS; attempt++) {
-        const result = await tryCreateProject(currentSlug, token, env);
+        const result = await tryCreateProject(currentSlug, name, token, env);
         if (result.success) {
             return {
                 slug: currentSlug,
@@ -30,7 +35,7 @@ export async function reserveProjectSlug(slug, token, env = getEnvironmentConfig
     }
     throw new Error(`Could not find available slug after ${MAX_SLUG_ATTEMPTS} attempts`);
 }
-async function tryCreateProject(slug, token, env = getEnvironmentConfig()) {
+async function tryCreateProject(slug, name, token, env = getEnvironmentConfig()) {
     try {
         const response = await dntShim.fetch(`${getApiUrl(env)}/projects`, {
             method: "POST",
@@ -39,7 +44,7 @@ async function tryCreateProject(slug, token, env = getEnvironmentConfig()) {
                 "Content-Type": "application/json",
                 Accept: "application/json",
             },
-            body: JSON.stringify({ slug, name: slug }),
+            body: JSON.stringify({ slug, name }),
         });
         if (response.ok) {
             const data = (await response.json());

package/esm/cli/utils/env-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-prompt.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/env-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAOD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAiF1B;AAkCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBzE"}
+{"version":3,"file":"env-prompt.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/env-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAOD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAiF1B;AAkCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BzE"}

package/esm/cli/utils/env-prompt.js

@@ -126,6 +126,9 @@ export function generateGitignoreContent(existingContent) {
             "dist/",
             ".veryfront/",
             "",
+            "# Local AI model cache",
+            ".cache/",
+            "",
             "# IDE",
             ".vscode/",
             ".idea/",

package/esm/deno.d.ts

@@ -27,6 +27,7 @@ declare namespace _default {
         "./provider": string;
         "./fs": string;
         "./integrations": string;
+        "./sandbox": string;
         "./cli": string;
     };
     let imports: {
@@ -45,6 +46,7 @@ declare namespace _default {
         "veryfront/react/fonts": string;
         "veryfront/react/components/ai": string;
         "veryfront/components/ai": string;
+        "veryfront/sandbox": string;
         "veryfront/agent/react": string;
         "veryfront/agent/testing": string;
         "veryfront/agent/middleware": string;
@@ -127,6 +129,7 @@ declare namespace _default {
         "#veryfront/testing/bdd.ts": string;
         "#veryfront/testing/deno-compat": string;
         "#veryfront/testing/utils": string;
+        "#veryfront/sandbox": string;
         "#veryfront/tool": string;
         "#veryfront/tool/schema": string;
         "#veryfront/transforms": string;
@@ -243,6 +246,7 @@ declare namespace _default {
         "@babel/traverse": string;
         "@babel/generator": string;
         "@babel/types": string;
+        "@huggingface/transformers": string;
     };
     namespace compilerOptions {
         let jsx: string;
@@ -345,7 +349,7 @@ declare namespace _default {
         export let proseWrap: string;
     }
     namespace allowScripts {
-        let allow: never[];
+        let allow: string[];
         let deny: string[];
     }
 }

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.13",
+    "version": "0.1.15",
     "nodeModulesDir": "auto",
     "exclude": [
         "npm/",
@@ -37,6 +37,7 @@ export default {
         "./provider": "./src/provider/index.ts",
         "./fs": "./src/fs/index.ts",
         "./integrations": "./src/integrations/index.ts",
+        "./sandbox": "./src/sandbox/index.ts",
         "./cli": "./cli/main.ts"
     },
     "imports": {
@@ -55,6 +56,7 @@ export default {
         "veryfront/react/fonts": "./src/react/fonts/index.ts",
         "veryfront/react/components/ai": "./src/react/components/ai/index.ts",
         "veryfront/components/ai": "./src/react/components/ai/index.ts",
+        "veryfront/sandbox": "./src/sandbox/index.ts",
         "veryfront/agent/react": "./src/agent/react/index.ts",
         "veryfront/agent/testing": "./src/agent/testing/index.ts",
         "veryfront/agent/middleware": "./src/agent/middleware/index.ts",
@@ -137,6 +139,7 @@ export default {
         "#veryfront/testing/bdd.ts": "./src/testing/bdd.ts",
         "#veryfront/testing/deno-compat": "./src/testing/deno-compat.ts",
         "#veryfront/testing/utils": "./src/testing/utils.ts",
+        "#veryfront/sandbox": "./src/sandbox/index.ts",
         "#veryfront/tool": "./src/tool/index.ts",
         "#veryfront/tool/schema": "./src/tool/schema/index.ts",
         "#veryfront/transforms": "./src/transforms/index.ts",
@@ -252,7 +255,8 @@ export default {
         "@babel/parser": "npm:@babel/parser@7.26.3",
         "@babel/traverse": "npm:@babel/traverse@7.26.3",
         "@babel/generator": "npm:@babel/generator@7.26.3",
-        "@babel/types": "npm:@babel/types@7.26.3"
+        "@babel/types": "npm:@babel/types@7.26.3",
+        "@huggingface/transformers": "npm:@huggingface/transformers@3.4.2"
     },
     "compilerOptions": {
         "jsx": "react-jsx",
@@ -278,7 +282,7 @@ export default {
         "proxy": "deno run --allow-all cli/main.ts serve --mode=proxy",
         "dev": "deno run --allow-all cli/main.ts dev",
         "production": "deno run --allow-all cli/main.ts serve --mode=production",
-        "build": "deno run -A scripts/build/generate-integrations-module.ts && deno run -A scripts/build/generate-templates-manifest.ts && deno run -A scripts/build/generate-dev-ui-manifest.ts && deno run -A scripts/build/prepare-framework-sources.ts && deno compile --allow-all --include src/platform/polyfills --include src/proxy/main.ts --include dist/framework-src --output ./bin/veryfront cli/main.ts",
+        "build": "deno run -A scripts/build/generate-integrations-module.ts && deno run -A scripts/build/generate-templates-manifest.ts && deno run -A scripts/build/generate-dev-ui-manifest.ts && deno run -A scripts/build/prepare-framework-sources.ts && deno run -A scripts/build/prebundle-client-scripts.ts && deno compile --allow-all --include src/platform/polyfills --include src/proxy/main.ts --include dist/framework-src --output ./bin/veryfront cli/main.ts",
         "build:npm": "deno run -A scripts/build/generate-integrations-module.ts && deno run -A scripts/build/build-npm-dnt.ts",
         "release": "deno run -A scripts/release.ts",
         "test": "VF_DISABLE_LRU_INTERVAL=1 SSR_TRANSFORM_PER_PROJECT_LIMIT=0 REVALIDATION_PER_PROJECT_LIMIT=0 NODE_ENV=production LOG_FORMAT=text deno test --no-check --parallel --allow-all '--ignore=tests/e2e,tests/integration/compiled-binary-e2e.test.ts' --unstable-worker-options --unstable-net",
@@ -383,7 +387,10 @@ export default {
         "proseWrap": "preserve"
     },
     "allowScripts": {
-        "allow": [],
+        "allow": [
+            "npm:sharp@0.33.5",
+            "npm:onnxruntime-node@1.20.1"
+        ],
         "deny": [
             "npm:esbuild@0.20.2",
             "npm:protobufjs@7.5.4"

package/esm/src/agent/chat-handler.d.ts

@@ -6,8 +6,9 @@ export interface ChatHandlerOptions {
 /**
  * Create a POST handler for a chat API route.
  *
- * Encapsulates request validation, message transformation, agent streaming,
- * and error handling so that template routes stay one-liners.
+ * Works with both App Router and Pages Router:
+ * - App Router: `app/api/chat/route.ts` — handler receives `(request, context)`
+ * - Pages Router: `pages/api/chat.ts` — handler receives `(ctx)`
  *
  * @example
  * ```ts
@@ -15,5 +16,5 @@ export interface ChatHandlerOptions {
  * export const POST = createChatHandler("assistant");
  * ```
  */
-export declare function createChatHandler(agentId: string, options?: ChatHandlerOptions): (request: dntShim.Request) => Promise<dntShim.Response>;
+export declare function createChatHandler(agentId: string, options?: ChatHandlerOptions): (requestOrCtx: any) => Promise<dntShim.Response>;
 //# sourceMappingURL=chat-handler.d.ts.map

package/esm/src/agent/chat-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-handler.d.ts","sourceRoot":"","sources":["../../../src/src/agent/chat-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AA0H/C,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,CACD,OAAO,EAAE,OAAO,CAAC,OAAO,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,IAED,SAAS,OAAO,CAAC,OAAO,KAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAsChF"}
+{"version":3,"file":"chat-handler.d.ts","sourceRoot":"","sources":["../../../src/src/agent/chat-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AA4H/C,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,CACD,OAAO,EAAE,OAAO,CAAC,OAAO,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpE;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,IAGD,cAAc,GAAG,KAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CA0EzE"}

package/esm/src/agent/chat-handler.js

@@ -1,6 +1,8 @@
 import * as dntShim from "../../_dnt.shims.js";
 import { z } from "zod";
 import { getAgent } from "./composition/index.js";
+import { fromError } from "../errors/veryfront-error.js";
+import { DEFAULT_LOCAL_MODEL } from "../provider/local/model-catalog.js";
 // ---------------------------------------------------------------------------
 // Zod schemas for validating AI SDK v5 chat UI messages
 // ---------------------------------------------------------------------------
@@ -88,11 +90,26 @@ function transformUIMessages(messages) {
     // after normalization since Zod already validated the request boundary.
     return result;
 }
+/**
+ * Extract the raw Request from either a raw Request or a Pages Router APIContext.
+ * Pages Router handlers receive `(ctx)` where `ctx.request` is the Request.
+ * App Router handlers receive `(request, context)` where `request` IS the Request.
+ */
+function extractRequest(requestOrCtx) {
+    if (requestOrCtx instanceof dntShim.Request)
+        return requestOrCtx;
+    // Pages Router APIContext — has a .request property
+    const ctx = requestOrCtx;
+    if (ctx.request instanceof dntShim.Request)
+        return ctx.request;
+    throw new Error("Invalid handler argument: expected Request or APIContext");
+}
 /**
  * Create a POST handler for a chat API route.
  *
- * Encapsulates request validation, message transformation, agent streaming,
- * and error handling so that template routes stay one-liners.
+ * Works with both App Router and Pages Router:
+ * - App Router: `app/api/chat/route.ts` — handler receives `(request, context)`
+ * - Pages Router: `pages/api/chat.ts` — handler receives `(ctx)`
  *
  * @example
  * ```ts
@@ -101,11 +118,21 @@ function transformUIMessages(messages) {
  * ```
  */
 export function createChatHandler(agentId, options) {
-    return async function POST(request) {
+    // deno-lint-ignore no-explicit-any
+    return async function POST(requestOrCtx) {
+        const request = extractRequest(requestOrCtx);
+        // Resolve agent outside try so it's available in the catch block for
+        // extracting the system prompt in the 503 fallback response.
+        let agent;
+        try {
+            agent = getAgent(agentId);
+        }
+        catch {
+            return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
+        }
         try {
             const body = await request.json();
             const { messages: rawMessages } = chatRequestSchema.parse(body);
-            const agent = getAgent(agentId);
             if (!agent) {
                 return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
             }
@@ -125,6 +152,30 @@ export function createChatHandler(agentId, options) {
             if (error instanceof z.ZodError) {
                 return dntShim.Response.json({ error: "Invalid request", details: error.errors }, { status: 400 });
             }
+            // Detect structured "no_ai_available" errors from local engine
+            const vfError = fromError(error);
+            if (vfError?.type === "no_ai_available") {
+                // Resolve the agent's system prompt so the browser can use it for inference
+                const systemConfig = agent?.config?.system;
+                let systemPrompt = "You are a helpful AI assistant.";
+                if (typeof systemConfig === "string") {
+                    systemPrompt = systemConfig;
+                }
+                else if (typeof systemConfig === "function") {
+                    try {
+                        systemPrompt = await systemConfig();
+                    }
+                    catch {
+                        // Fall back to default
+                    }
+                }
+                return dntShim.Response.json({
+                    code: "NO_AI_AVAILABLE",
+                    fallback: "browser",
+                    model: DEFAULT_LOCAL_MODEL,
+                    systemPrompt,
+                }, { status: 503 });
+            }
             return dntShim.Response.json({ error: "Internal server error" }, { status: 500 });
         }
     };

package/esm/src/agent/react/index.d.ts

@@ -4,7 +4,7 @@
  * @module agent/react
  */
 export { useChat } from "./use-chat/index.js";
-export type { DynamicToolUIPart, OnToolCallArg, ReasoningUIPart, TextUIPart, ToolOutput, ToolResultUIPart, ToolState, ToolUIPart, UIMessage, UIMessagePart, UseChatOptions, UseChatResult, } from "./use-chat/index.js";
+export type { BrowserInferenceStatus, DynamicToolUIPart, InferenceMode, OnToolCallArg, ReasoningUIPart, TextUIPart, ToolOutput, ToolResultUIPart, ToolState, ToolUIPart, UIMessage, UIMessagePart, UseChatOptions, UseChatResult, } from "./use-chat/index.js";
 export { useAgent } from "./use-agent.js";
 export type { UseAgentOptions, UseAgentResult } from "./use-agent.js";
 export { useCompletion } from "./use-completion.js";

package/esm/src/agent/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,eAAe,EACf,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/esm/src/agent/react/use-chat/browser-inference/browser-engine.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Bridge between BrowserInferenceClient (Worker) and useChat's streaming interface.
+ *
+ * Converts UIMessage[] to simple {role, content}[] for the Worker,
+ * and synthesizes the same streaming updates that handleStreamingResponse produces.
+ */
+import type { BrowserInferenceStatus } from "../types.js";
+import type { UIMessage, UIMessagePart } from "../types.js";
+export interface BrowserInferenceCallbacks {
+    onUpdate: (parts: UIMessagePart[], messageId: string) => void;
+    onMessage: (message: UIMessage) => void;
+    onStatusChange: (status: BrowserInferenceStatus) => void;
+    onDownloadProgress?: (progress: number) => void;
+    onError: (error: Error) => void;
+}
+export declare function runBrowserInference(messages: UIMessage[], systemPrompt: string, callbacks: BrowserInferenceCallbacks): void;
+export declare function stopBrowserInference(): void;
+//# sourceMappingURL=browser-engine.d.ts.map

package/esm/src/agent/react/use-chat/browser-inference/browser-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-engine.d.ts","sourceRoot":"","sources":["../../../../../../src/src/agent/react/use-chat/browser-inference/browser-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,SAAS,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC;IACxC,cAAc,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACzD,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAeD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,EAAE,EACrB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,yBAAyB,GACnC,IAAI,CAuCN;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}