veryfront 0.1.13 → 0.1.15

package/src/cli/commands/init/init-command.ts

@@ -4,7 +4,7 @@
  *******************************/
 
 import { cliLogger as logger } from "../../utils/index.js";
-import { brand, dim, green } from "../../ui/index.js";
+import { brand, dim, green, red } from "../../ui/index.js";
 import { createSpinner } from "../../ui/progress.js";
 import { box } from "../../ui/box.js";
 import { ensureDir } from "../../../deps/jsr.io/@std/fs/1.0.22/mod.js";
@@ -35,7 +35,11 @@ import {
   loadIntegrations,
   validateIntegrations,
 } from "../../templates/integration-loader.js";
-import { runInteractiveWizard, shouldRunWizard } from "./interactive-wizard.js";
+import {
+  runInteractiveWizard,
+  shouldRunWizard,
+  validateProjectName,
+} from "./interactive-wizard.js";
 
 /**
  * Icon mapping for integrations based on category/name
@@ -185,8 +189,31 @@ export async function initCommand(options: InitOptions): Promise<void> {
   let projectName = name;
   let initGit = false;
 
+  // Validate project name before doing anything else
+  if (name) {
+    const nameError = validateProjectName(name);
+    if (nameError) {
+      console.error(red(nameError));
+      return;
+    }
+  }
+
+  // Check if directory already exists before entering the wizard
+  if (name && !options.force) {
+    const fs = createFileSystem();
+    const targetDir = join(cwd(), name);
+    if (await fs.exists(targetDir)) {
+      console.error(
+        red(
+          `Directory "${name}" already exists. Choose a different name or use --force to overwrite.`,
+        ),
+      );
+      return;
+    }
+  }
+
   if (shouldRunWizard(options)) {
-    const wizardResult = await runInteractiveWizard();
+    const wizardResult = await runInteractiveWizard(name);
     if (wizardResult.cancelled) {
       return;
     }

package/src/cli/commands/init/interactive-wizard.ts

@@ -6,6 +6,13 @@ import { select, textInput } from "../../utils/terminal-select.js";
 import { getTemplateSelectOptions, TEMPLATES } from "./catalog.js";
 import type { InitTemplate } from "./types.js";
 
+/** Reject path separators and traversal so the name stays a single directory. */
+export function validateProjectName(name: string): string | null {
+  if (/[/\\]/.test(name)) return 'Project name cannot contain "/" or "\\"';
+  if (name === "." || name === "..") return 'Project name cannot be "." or ".."';
+  return null;
+}
+
 export interface WizardResult {
   projectName: string | null; // null = use current directory
   template: InitTemplate;
@@ -18,10 +25,10 @@ function canRunWizard(): boolean {
   return !(isCiEnv() || isDenoTestingEnv()) && checkIsInteractive();
 }
 
-export async function runInteractiveWizard(): Promise<WizardResult> {
+export async function runInteractiveWizard(existingName?: string): Promise<WizardResult> {
   if (!canRunWizard()) {
     return {
-      projectName: null,
+      projectName: existingName ?? null,
       template: "minimal",
       initGit: false,
       skipped: true,
@@ -37,31 +44,28 @@ export async function runInteractiveWizard(): Promise<WizardResult> {
   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: string | null = null;
-  if (locationChoice === "new") {
-    const name = await textInput("Project name", "my-app");
-    if (name === null) {
+  let projectName: string | null = 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,
@@ -71,12 +75,36 @@ export async function runInteractiveWizard(): Promise<WizardResult> {
         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(),
@@ -96,7 +124,7 @@ export async function runInteractiveWizard(): Promise<WizardResult> {
 
   const template = templateChoice as InitTemplate;
 
-  // Step 3: Git init prompt
+  // Git init prompt
   const gitChoice = await select(
     "Initialize a git repository?",
     [
@@ -136,7 +164,7 @@ export async function runInteractiveWizard(): Promise<WizardResult> {
   return { projectName, template, initGit, skipped: false, cancelled: false };
 }
 
-export function shouldRunWizard(options: { template?: string; name?: string }): boolean {
-  // Run wizard if no template and no name specified via CLI
-  return !options.template && !options.name;
+export function shouldRunWizard(options: { template?: string }): boolean {
+  // Always run wizard unless template is explicitly specified via --template
+  return !options.template;
 }

package/src/cli/mcp/remote-file-tools.ts

@@ -15,6 +15,7 @@ import { z } from "zod";
 import type { MCPTool } from "./tools.js";
 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";
 
@@ -135,6 +136,46 @@ interface Project {
   created_at?: string;
 }
 
+const MAX_SLUG_ATTEMPTS = 10;
+
+function slugToName(slug: string): string {
+  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: string,
+  body: Record<string, unknown>,
+): Promise<{ ok: true; data: Project; slug: string } | { ok: false; error: string }> {
+  const name = slugToName(slug);
+  let currentSlug = slug;
+
+  for (let attempt = 1; attempt <= MAX_SLUG_ATTEMPTS; attempt++) {
+    const result = await apiRequest<Project>("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
 // ============================================================================
@@ -573,8 +614,9 @@ export const vfRemoteDeleteBranch: MCPTool<RemoteDeleteBranchInput, RemoteDelete
 // ============================================================================
 
 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)"),
 });
@@ -592,13 +634,9 @@ export const vfRemoteCreateProject: MCPTool<RemoteCreateProjectInput, RemoteCrea
   description: "Create a new Veryfront project. Returns the project details including ID and slug.",
   inputSchema: remoteCreateProjectInput,
   execute: async (input) => {
-    const result = await apiRequest<Project>("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 };
@@ -612,9 +650,8 @@ export const vfRemoteCreateProject: MCPTool<RemoteCreateProjectInput, RemoteCrea
 
 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)",
+    "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')",
@@ -639,9 +676,7 @@ export const vfRemoteCloneProject: MCPTool<RemoteCloneProjectInput, RemoteCloneP
     withSpan(
       "cli.mcp.tool.vf_remote_clone_project",
       async () => {
-        const createResult = await apiRequest<Project>("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}` };
@@ -684,7 +719,7 @@ export const vfRemoteCloneProject: MCPTool<RemoteCloneProjectInput, RemoteCloneP
 
           const createFileResult = await apiRequest<{ id: string; path: string }>(
             "PUT",
-            `/${input.target_slug}/files/${encodeFilePath(file.path)}`,
+            `/${createResult.slug}/files/${encodeFilePath(file.path)}`,
             { body: { content: getResult.data.content } },
           );
 

package/src/cli/shared/reserve-slug.ts

@@ -9,8 +9,13 @@ import * as dntShim from "../../_dnt.shims.js";
 
 
 import { type EnvironmentConfig, getEnvironmentConfig } from "../../src/config/index.js";
+import { capitalizeSeparatedWords } from "../../src/utils/case-utils.js";
 import { randomSuffix } from "./slug.js";
 
+function slugToName(slug: string): string {
+  return capitalizeSeparatedWords(slug, "-", " ");
+}
+
 export interface ReserveResult {
   slug: string;
   projectId: string;
@@ -39,10 +44,11 @@ export async function reserveProjectSlug(
   token: string,
   env: EnvironmentConfig = getEnvironmentConfig(),
 ): Promise<ReserveResult> {
+  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 {
@@ -64,6 +70,7 @@ export async function reserveProjectSlug(
 
 async function tryCreateProject(
   slug: string,
+  name: string,
   token: string,
   env: EnvironmentConfig = getEnvironmentConfig(),
 ): Promise<CreateProjectResult> {
@@ -75,7 +82,7 @@ async function tryCreateProject(
         "Content-Type": "application/json",
         Accept: "application/json",
       },
-      body: JSON.stringify({ slug, name: slug }),
+      body: JSON.stringify({ slug, name }),
     });
 
     if (response.ok) {

package/src/cli/utils/env-prompt.ts

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

package/src/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/src/src/agent/chat-handler.ts

@@ -2,6 +2,8 @@ import * as dntShim from "../../_dnt.shims.js";
 import { z } from "zod";
 import { getAgent } from "./composition/index.js";
 import type { Message } from "./types.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
@@ -129,11 +131,25 @@ export interface ChatHandlerOptions {
     ) => Record<string, unknown> | Promise<Record<string, unknown>>);
 }
 
+/**
+ * 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: unknown): dntShim.Request {
+  if (requestOrCtx instanceof dntShim.Request) return requestOrCtx;
+  // Pages Router APIContext — has a .request property
+  const ctx = requestOrCtx as { request?: dntShim.Request };
+  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
@@ -145,12 +161,22 @@ export function createChatHandler(
   agentId: string,
   options?: ChatHandlerOptions,
 ) {
-  return async function POST(request: dntShim.Request): Promise<dntShim.Response> {
+  // deno-lint-ignore no-explicit-any
+  return async function POST(requestOrCtx: any): Promise<dntShim.Response> {
+    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: ReturnType<typeof getAgent> | undefined;
+    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 });
       }
@@ -177,6 +203,33 @@ export function createChatHandler(
         );
       }
 
+      // 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/src/src/agent/react/index.ts

@@ -6,7 +6,9 @@
 
 export { useChat } from "./use-chat/index.js";
 export type {
+  BrowserInferenceStatus,
   DynamicToolUIPart,
+  InferenceMode,
   OnToolCallArg,
   ReasoningUIPart,
   TextUIPart,

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

@@ -0,0 +1,81 @@
+/**
+ * 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";
+import { generateClientId } from "../utils.js";
+import { BrowserInferenceClient } from "./worker-client.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;
+}
+
+function extractTextFromMessages(
+  messages: UIMessage[],
+): Array<{ role: string; content: string }> {
+  return messages
+    .filter((m) => m.role === "user" || m.role === "assistant")
+    .map((m) => {
+      const textPart = m.parts.find((p) => p.type === "text");
+      const content = textPart && "text" in textPart ? textPart.text : "";
+      return { role: m.role, content };
+    })
+    .filter((m) => m.content.length > 0);
+}
+
+export function runBrowserInference(
+  messages: UIMessage[],
+  systemPrompt: string,
+  callbacks: BrowserInferenceCallbacks,
+): void {
+  const client = BrowserInferenceClient.getInstance();
+  const messageId = generateClientId("msg");
+  const simpleMessages = extractTextFromMessages(messages);
+
+  let accumulated = "";
+
+  client.generate(
+    messageId,
+    simpleMessages,
+    { systemPrompt, maxNewTokens: 512, temperature: 0.7 },
+    {
+      onStatus: (status) => callbacks.onStatusChange(status),
+      onDownloadProgress: (progress) => callbacks.onDownloadProgress?.(progress),
+      onToken: (token) => {
+        accumulated = token; // transformers.js callback_function sends full text each time
+        const parts: UIMessagePart[] = [
+          { type: "text", text: accumulated, state: "streaming" },
+        ];
+        callbacks.onUpdate(parts, messageId);
+      },
+      onDone: (text) => {
+        const finalParts: UIMessagePart[] = [
+          { type: "text", text: text || accumulated, state: "done" },
+        ];
+        const assistantMessage: UIMessage = {
+          id: messageId,
+          role: "assistant",
+          parts: finalParts,
+        };
+        callbacks.onMessage(assistantMessage);
+        callbacks.onStatusChange("ready");
+      },
+      onError: (errorMsg) => {
+        callbacks.onStatusChange("error");
+        callbacks.onError(new Error(errorMsg));
+      },
+    },
+  );
+}
+
+export function stopBrowserInference(): void {
+  BrowserInferenceClient.getInstance().stop();
+}

package/src/src/agent/react/use-chat/browser-inference/types.ts

@@ -0,0 +1,52 @@
+/**
+ * Worker ↔ main thread message protocol for browser-side inference.
+ */
+
+export interface WorkerGenerateRequest {
+  type: "generate";
+  id: string;
+  messages: Array<{ role: string; content: string }>;
+  options?: {
+    maxNewTokens?: number;
+    temperature?: number;
+    systemPrompt?: string;
+  };
+}
+
+export type WorkerRequest = WorkerGenerateRequest;
+
+export interface WorkerStatusResponse {
+  type: "status";
+  status: "loading-runtime" | "downloading-model" | "ready" | "generating";
+}
+
+export interface WorkerDownloadProgressResponse {
+  type: "download-progress";
+  progress: number; // 0–100
+  file?: string;
+}
+
+export interface WorkerTokenResponse {
+  type: "token";
+  id: string;
+  token: string;
+}
+
+export interface WorkerDoneResponse {
+  type: "done";
+  id: string;
+  text: string;
+}
+
+export interface WorkerErrorResponse {
+  type: "error";
+  id: string;
+  error: string;
+}
+
+export type WorkerResponse =
+  | WorkerStatusResponse
+  | WorkerDownloadProgressResponse
+  | WorkerTokenResponse
+  | WorkerDoneResponse
+  | WorkerErrorResponse;