void 0.24.0 → 0.26.0

package/dist/{subcommand-prompt-klFCfcor.mjs → subcommand-prompt-B6WS9Aoz.mjs}

@@ -1,5 +1,5 @@
-import { $ as wrapTextWithPrefix, G as promptTitle, M as getGuide, V as optionText, b as S_RADIO_ACTIVE, d as S_CHECKBOX_SELECTED, i as S_BAR_END, it as wrapAnsi, j as formatInstructionFooter, n as SELECT_INSTRUCTIONS, r as S_BAR, t as MULTISELECT_INSTRUCTIONS, u as S_CHECKBOX_INACTIVE, w as S_STEP_SUBMIT } from "./prompts-BNUoTiaf.mjs";
-import { c as import_picocolors } from "./output-CbM85T4k.mjs";
+import { $ as wrapTextWithPrefix, G as promptTitle, M as getGuide, V as optionText, b as S_RADIO_ACTIVE, d as S_CHECKBOX_SELECTED, i as S_BAR_END, it as wrapAnsi, j as formatInstructionFooter, n as SELECT_INSTRUCTIONS, r as S_BAR, t as MULTISELECT_INSTRUCTIONS, u as S_CHECKBOX_INACTIVE, w as S_STEP_SUBMIT } from "./prompts-6OSVA7DJ.mjs";
+import { c as import_picocolors } from "./output-BvdaehtE.mjs";
 //#region src/cli/subcommand-prompt.ts
 function promptSubcommand(command, subcommands) {
 	return new Promise((resolve) => {

package/dist/sveltekit.d.mts

@@ -4,7 +4,7 @@ type TsconfigHook = (config: Tsconfig) => Tsconfig | void;
 export type VoidSvelteKitTsconfigOptions = {
   /** Project root. Defaults to process.cwd(). */
   root?: string;
-  /** SvelteKit output directory. Defaults to ".svelte-kit". */
+  /** @deprecated Generated paths no longer depend on SvelteKit's output directory. */
   outDir?: string;
 };
 /**

package/dist/sveltekit.mjs

@@ -1,4 +1,4 @@
-import { a as join, i as isAbsolute, l as relative, u as resolve } from "./dist-BVqXeR_h.mjs";
+import { a as join, i as isAbsolute, u as resolve } from "./dist-BVqXeR_h.mjs";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/sveltekit.ts
 /**
@@ -7,18 +7,17 @@ import { existsSync, readFileSync } from "node:fs";
 * `kit.typescript.config` in `svelte.config.js`.
 */
 function mergeVoidSvelteKitTsconfig(config, options = {}) {
-	const root = options.root ?? process.cwd();
+	const root = resolve(options.root ?? process.cwd());
 	const voidDir = join(root, ".void");
 	const voidTsconfigPath = join(voidDir, "tsconfig.json");
 	if (!existsSync(voidTsconfigPath)) return config;
 	const voidConfig = JSON.parse(readFileSync(voidTsconfigPath, "utf-8"));
-	const outputDir = resolve(root, options.outDir ?? ".svelte-kit");
 	const voidFiles = Array.isArray(voidConfig.files) ? voidConfig.files.filter((entry) => typeof entry === "string") : [];
-	if (voidFiles.length > 0) config.files = uniqueStrings([...Array.isArray(config.files) ? config.files.filter((entry) => typeof entry === "string") : [], ...voidFiles.map((entry) => relativeFrom(outputDir, resolveTsconfigEntry(voidDir, entry)))]);
+	if (voidFiles.length > 0) config.files = uniqueStrings([...Array.isArray(config.files) ? config.files.filter((entry) => typeof entry === "string") : [], ...voidFiles.map((entry) => resolveTsconfigEntry(voidDir, entry))]);
 	const voidPaths = readPathMap(readObject(readObject(voidConfig.compilerOptions)?.paths));
 	if (Object.keys(voidPaths).length > 0) {
 		const paths = ensureObject(ensureObject(config, "compilerOptions"), "paths");
-		for (const [key, values] of Object.entries(voidPaths)) paths[key] = values.map((entry) => relativeFrom(outputDir, resolveTsconfigEntry(voidDir, entry)));
+		for (const [key, values] of Object.entries(voidPaths)) paths[key] = values.map((entry) => resolveTsconfigEntry(voidDir, entry));
 	}
 	return config;
 }
@@ -51,10 +50,6 @@ function readPathMap(value) {
 function resolveTsconfigEntry(baseDir, entry) {
 	return isAbsolute(entry) ? entry : resolve(baseDir, entry);
 }
-function relativeFrom(fromDir, target) {
-	const value = relative(fromDir, target);
-	return value.startsWith(".") ? value : `./${value}`;
-}
 function uniqueStrings(values) {
 	return Array.from(new Set(values));
 }

package/dist/validate-pna7R3Pv.mjs

@@ -0,0 +1,2 @@
+import { i as validateMigrations } from "./validate-ymhap6M_.mjs";
+export { validateMigrations };

package/dist/{validate-ctOrgiS3.mjs → validate-ymhap6M_.mjs}

@@ -1,6 +1,6 @@
 import { a as join } from "./dist-BVqXeR_h.mjs";
 import { n as readJournal, r as stripSqlExt } from "./collect-DiTn9yr6.mjs";
-import { t as DESTRUCTIVE_PRAGMA } from "./plan-NPpwZ_kc.mjs";
+import { t as DESTRUCTIVE_PRAGMA } from "./plan-CJGEeTEI.mjs";
 import { existsSync, readdirSync } from "node:fs";
 import { tokenizeSql } from "@void/deploy-core";
 //#region src/migrations/validate.ts

package/dist/{wrangler-7K-bW_DL.mjs → wrangler-DhUerFkW.mjs}

@@ -4,7 +4,7 @@ import { m as readConfig } from "./config-Br_JZD6u.mjs";
 import { a as hasSandboxSqliteMigration, c as resolveSandboxConfig, i as assertSandboxNamespaceConfig, l as sandboxContainerConfig, r as SANDBOX_MIGRATION_TAG } from "./config-C_XRIPx2.mjs";
 import { i as persistCloudflareConfig, r as materializeCloudflareConfig } from "./cloudflare-config-Bktvwtpf.mjs";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { appendSqliteClassMigration } from "@void/deploy-core";
+import { appendSqliteClassMigration, isRecord } from "@void/deploy-core";
 import { createHash } from "node:crypto";
 import { SyntaxKind, applyEdits, createScanner, findNodeAtLocation, modify, parse, parseTree } from "jsonc-parser";
 //#region src/cli/wrangler.ts
@@ -686,7 +686,10 @@ function writeProvisionedWranglerConfig(root, patch, options) {
 		const matches = [];
 		for (let i = 0; i < currentList.length; i++) {
 			const entry = currentList[i];
-			if (isRecord(entry) && entry[identityKey] === binding) matches.push(i);
+			if (isRecord(entry) && entry[identityKey] === binding) matches.push({
+				index: i,
+				entry
+			});
 		}
 		if (matches.length > 1) throw new Error(`deploy: cannot update "${configPath}" — binding ${JSON.stringify(binding)} is declared ${matches.length} times in "${field}". Void cannot choose which entry to update, and wrangler rejects duplicate binding names. Remove the duplicate and retry.`);
 		const owners = collectWorkerBindingNames(configWithoutField(currentConfig, field));
@@ -694,8 +697,7 @@ function writeProvisionedWranglerConfig(root, patch, options) {
 		const owner = owners.get(binding);
 		if (owner !== void 0) throw new Error(`deploy: cannot update "${configPath}" — cannot adopt ${JSON.stringify(binding)} into "${field}" because that binding name is already used by a ${owner} binding. Wrangler requires every binding name to be unique across the whole worker, so this would make the config undeployable. Rename the conflicting binding and retry.`);
 		if (matches.length === 1) {
-			const index = matches[0];
-			const existing = isRecord(currentList[index]) ? currentList[index] : {};
+			const { index, entry: existing } = matches[0];
 			for (const [key, value] of Object.entries(properties)) if (!jsonEqual(existing[key], value)) set([
 				field,
 				index,
@@ -752,20 +754,16 @@ function writeProvisionedWranglerConfig(root, patch, options) {
 	const upsertQueueEntries = (section, entries) => {
 		if (!entries || entries.length === 0) return;
 		const currentQueues = assertObjectContainer(parseJsonc(text).queues, "queues");
-		if (section === "producers") assertValidQueueProducers(currentQueues?.producers);
-		const currentList = Array.isArray(currentQueues?.[section]) ? [...currentQueues[section]] : [];
+		const currentList = section === "producers" ? assertValidQueueProducers(currentQueues?.producers) : Array.isArray(currentQueues?.consumers) ? [...currentQueues.consumers] : [];
 		for (const entry of entries) {
 			let index;
 			if (section === "producers") {
 				const matches = [];
-				for (let i = 0; i < currentList.length; i++) {
-					const existing = currentList[i];
-					if (isRecord(existing) && existing.binding === entry.binding) matches.push(i);
-				}
+				for (let i = 0; i < currentList.length; i++) if (currentList[i].binding === entry.binding) matches.push(i);
 				if (matches.length > 1) throw new Error(`deploy: cannot update "${configPath}" — queue producer binding ${JSON.stringify(entry.binding)} is declared ${matches.length} times across producers. A producer binding must map to exactly one queue, so wrangler rejects this config. Remove the duplicate producers and retry.`);
 				if (matches.length === 1) {
 					const existing = currentList[matches[0]];
-					if (isRecord(existing) && existing.queue !== entry.queue) throw new Error(`deploy: cannot update "${configPath}" — queue producer binding ${JSON.stringify(entry.binding)} is already bound to queue ${JSON.stringify(existing.queue)}, but queue ${JSON.stringify(entry.queue)} also requests it. A producer binding must map to exactly one queue. Rename or remove the conflicting producer and retry.`);
+					if (existing.queue !== entry.queue) throw new Error(`deploy: cannot update "${configPath}" — queue producer binding ${JSON.stringify(entry.binding)} is already bound to queue ${JSON.stringify(existing.queue)}, but queue ${JSON.stringify(entry.queue)} also requests it. A producer binding must map to exactly one queue. Rename or remove the conflicting producer and retry.`);
 				}
 				index = matches.length === 1 ? matches[0] : -1;
 				workerBindingOwners ??= collectWorkerBindingNames(parseJsonc(text));
@@ -774,7 +772,7 @@ function writeProvisionedWranglerConfig(root, patch, options) {
 				if (owner !== void 0) throw new Error(`deploy: cannot update "${configPath}" — queue producer binding ${JSON.stringify(bindingName)} is already used by a ${owner} binding. Wrangler requires every binding name to be unique across the whole worker, so this producer would make the config undeployable. Rename the conflicting binding (or the queue) and retry.`);
 			} else index = currentList.findIndex((existing) => isRecord(existing) && existing.queue === entry.queue);
 			if (index >= 0) {
-				const existing = isRecord(currentList[index]) ? currentList[index] : {};
+				const existing = currentList[index];
 				for (const [key, value] of Object.entries(entry)) {
 					if (value === void 0) continue;
 					if (!jsonEqual(existing[key], value)) set([
@@ -1243,9 +1241,6 @@ function offsetToLineColumn(text, offset) {
 		column
 	};
 }
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function validateDurableObjectMigrations(value, configPath) {
 	if (value === void 0) return [];
 	if (!Array.isArray(value)) throw new Error(`deploy: cannot update "${configPath}" — "migrations" must be an array of Durable Object migration steps.`);

package/dist/{ws-CL1w7GXU.d.mts → ws-C79j4aED.d.mts}

@@ -1,6 +1,6 @@
 import { t as StandardSchemaV1 } from "./standard-schema-Fo_vCAZh.mjs";
 import { r as AuthUser } from "./auth-DkcFflXV.mjs";
-import { a as CloudEnv } from "./handler-CZ4nAylQ.mjs";
+import { a as CloudEnv } from "./handler-BeK3weD4.mjs";
 import { WebSocketRouteMap } from "void/routes";
 //#region src/runtime/ws.d.ts
 type MaybePromise<T> = T | Promise<T>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "void",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/voidzero-dev/void.git",
@@ -331,24 +331,24 @@
     }
   },
   "dependencies": {
-    "@cloudflare/build-output-utils": "0.8.4",
-    "@cloudflare/codemods": "0.3.0",
-    "@cloudflare/config": "0.22.0",
+    "@cloudflare/build-output-utils": "0.8.5",
+    "@cloudflare/codemods": "0.4.0",
+    "@cloudflare/config": "0.23.0",
     "@cloudflare/sandbox": "1.0.0",
-    "@cloudflare/vite-plugin": "1.62.2",
-    "@cloudflare/workers-auth": "0.9.5",
+    "@cloudflare/vite-plugin": "1.62.5",
+    "@cloudflare/workers-auth": "0.12.0",
     "@cloudflare/workers-types": "^4.20260702.1",
     "@napi-rs/keyring": "2.1.0",
-    "@void/deploy-cloudflare": "0.24.0",
-    "@void/deploy-core": "0.24.0",
-    "@void/edge": "0.24.0",
-    "@void/isr": "0.24.0",
-    "@void/platform": "0.24.0",
+    "@void/deploy-cloudflare": "0.26.0",
+    "@void/deploy-core": "0.26.0",
+    "@void/edge": "0.26.0",
+    "@void/isr": "0.26.0",
+    "@void/platform": "0.26.0",
     "acorn": "^8.18.0",
-    "better-auth": "^1.7.6",
+    "better-auth": "^1.7.7",
     "better-sqlite3": "^13.0.3",
     "blake3-jit": "^1.1.0",
-    "cf": "1.0.0-beta.9",
+    "cf": "1.0.0-beta.12",
     "drizzle-arktype": "^0.1.3",
     "drizzle-kit": "^0.31.11",
     "drizzle-orm": "^0.45.3",
@@ -356,27 +356,27 @@
     "drizzle-zod": "^0.8.3",
     "email-validator": "^2.0.4",
     "es-module-lexer": "^3.0.2",
-    "hono": "^4.13.11",
-    "ignore": "^7.0.10",
+    "hono": "^4.13.13",
+    "ignore": "^7.0.12",
     "jiti": "^2.7.0",
     "jsonc-parser": "3.3.1",
     "mime": "4.1.0",
-    "miniflare": "5.20260926.1-alpha",
+    "miniflare": "5.20261001.0-alpha",
     "minimatch": "^10.2.6",
     "mysql2": "3.24.5",
-    "pg": "8.23.0",
-    "postal-mime": "^4.0.0",
+    "pg": "8.23.1",
+    "postal-mime": "^4.0.4",
     "proper-lockfile": "^4.1.2",
     "undici": "8.11.2"
   },
   "devDependencies": {
     "@electric-sql/pglite": "0.5.8",
     "@types/better-sqlite3": "^9.6.0",
-    "@types/node": "^26.6.3",
+    "@types/node": "^26.6.4",
     "@types/pg": "^8.23.1",
     "@types/proper-lockfile": "^4.1.4",
     "@voidzero-dev/vite-plus-prompts": "0.0.0",
-    "arktype": "^2.2.5",
+    "arktype": "^2.2.7",
     "ci-info": "^4.4.0",
     "estree-walker": "^3.0.3",
     "fast-wrap-ansi": "^0.2.2",
@@ -393,7 +393,7 @@
     "zod": "^4.6.5"
   },
   "peerDependencies": {
-    "@void/md": "0.24.0",
+    "@void/md": "0.26.0",
     "arktype": ">=2.0.0",
     "valibot": ">=1.0.0-beta.7",
     "vite": "^8.0.0",

package/sandbox.Dockerfile

@@ -1,4 +1,4 @@
-FROM node:24.21.0-trixie-slim
+FROM node:26.10.0-trixie-slim
 COPY --from=docker.io/cloudflare/sandbox:1.0.0 /usr/local/bin/sandbox-shim /usr/local/bin/sandbox-shim
 WORKDIR /workspace
 CMD ["sleep", "infinity"]

package/skills/void/SKILL.md

@@ -19,6 +19,8 @@ Use `void` and `@void/*` in imports, examples, and package manifests. Follow the
 project's existing framework and deployment destination. Deploying to a Void
 platform requires an explicit `void connect <url>` first; never infer a platform
 from old examples, tokens, or project IDs.
+Platform hostnames passed to `void connect` default to HTTPS; include `http://`
+explicitly when connecting to a local HTTP platform.
 For a one-time deployment elsewhere, connect to that platform, then set
 `VOID_API_URL` for the deploy command and pass `--project <slug>`. This preserves
 the app's existing saved destination, including when the target project is new.
@@ -78,7 +80,8 @@ the app's existing saved destination, including when the target project is new.
 - Declare application environment keys in `env.ts` and access them through
   `void/env`; follow `docs/guide/env-vars.md` for local and production values.
 - For platform setup, follow the pages linked from
-  `docs/guide/self-hosted-platform.md`. For recovery, use its documented resume
+  `docs/guide/self-hosted-platform.md`. Use `void platform list` to find the
+  installation slug for maintenance. For recovery, use its documented resume
   or repair workflow and preserve the installation's credentials and resources.
 - Use `--plan` to review platform changes. If an operation has an uncertain
   outcome, inspect its status and events before retrying.
@@ -87,4 +90,4 @@ If the user invokes this skill without a task, inspect the app's local structure
 configuration, and saved deployment destination, give a brief status, and ask
 what they want to work on.
 
-For AI and Sandbox operations, use `.match({ ok, limited })` and choose a useful quota fallback. In Pages, prefer the adapter’s `Form` with `useForm()` so action failures remain visible and entered data is preserved. See `docs/guide/ai.md`, `docs/guide/sandboxes.md`, and `docs/guide/pages-routing/actions-and-forms.md`.
+Await AI and Sandbox operations normally. Usage limits reject with `UsageLimit` from `void/limits`; Void routes and Pages actions automatically return HTTP 429. Optionally catch with `instanceof UsageLimit` for a fallback or custom response. In Pages, prefer the adapter’s `Form` with `useForm()` so action failures remain visible and entered data is preserved. See `docs/guide/ai.md`, `docs/guide/sandboxes.md`, and `docs/guide/pages-routing/actions-and-forms.md`.

package/skills/void/docs/guide/ai.md

@@ -4,19 +4,24 @@ outline: deep
 
 # AI
 
-Void provides a typed AI client for Workers AI and Cloudflare's [AI Gateway](https://developers.cloudflare.com/ai-gateway/). Import `ai` from `void/ai` and run inference directly from your route handlers. Direct deployments use your Cloudflare account; a team platform routes requests through its installation's proxy and usage controls.
+Run Workers AI models and provider APIs from server code with `ai` from `void/ai`. Provider requests use Cloudflare's [AI Gateway](https://developers.cloudflare.com/ai-gateway/).
 
-```ts
-import { ai } from 'void/ai';
-```
+## Local Development
 
-## Handling usage limits
+For a direct Cloudflare project, connect your account and start development:
 
-Every AI operation is lazy and must be executed with `.match({ ok, limited })`. Both handlers are required, including for provider-native requests, model listing and document conversion. Return a useful fallback from `limited`, or use `limit.response({ message: 'AI is temporarily unavailable.' })` to send a structured HTTP 429. Limits expose `resource`, `reason`, and an optional `retryAt`. Other failures still reject.
+```sh
+void connect --platform cloudflare
+npm run dev
+```
 
-Do not await the operation itself; await its `.match()` call. TypeScript checks your handlers and the resulting success/fallback union.
+When the app imports `void/ai`, Void enables a remote Workers AI binding during
+development and preview. Requests use your Cloudflare account and its allowance;
+Workers AI has no local simulator. Use your Cloudflare login or
+`CLOUDFLARE_API_TOKEN` in an automated environment.
 
-Streaming responses end with a `void:error` SSE event if generation is interrupted after the response starts. A recognized quota interruption calls your `limited` handler and emits `void:limit`, preserving the message from `limit.response()`. `fetchStream()` throws on either terminal event so your UI can exit its generating state. This also applies to streaming provider responses and `ai.run()` with `stream: true`.
+For a team platform, use `void connect <platform-url>` and link your project.
+Development requests use that platform's account and usage limits.
 
 ## Basic Usage
 
@@ -29,16 +34,15 @@ import { ai } from 'void/ai';
 export const POST = defineHandler(async (c) => {
   const { prompt } = await c.req.json();
 
-  const result = await ai
-    .run('@cf/meta/llama-3.3-70b-instruct-fp8-fast', {
-      messages: [{ role: 'user', content: prompt }],
-    })
-    .match({ ok: (result) => result, limited: (limit) => limit.response() });
-
+  const result = await ai.run('@cf/meta/llama-3.3-70b-instruct-fp8-fast', {
+    messages: [{ role: 'user', content: prompt }],
+  });
   return c.json(result);
 });
 ```
 
+AI methods return promises. Await them to receive the result, or return the promise directly from a handler. Usage limits reject with [`UsageLimit`](#usage-limits); Void route handlers and Pages actions automatically send a structured HTTP 429 when it is left uncaught.
+
 You can use any model available through Cloudflare's AI binding, including Workers AI models such as `@cf/meta/llama-3.3-70b-instruct-fp8-fast` and Cloudflare Gateway models such as `google/gemini-2.5-flash` or `openai/gpt-4.1-mini`. The input object must match the selected Cloudflare model's schema. Models that return binary data, such as generated images, are returned as a `Blob` from `ai.run()`.
 
 ## Streaming
@@ -52,27 +56,23 @@ import { ai } from 'void/ai';
 export const POST = defineHandler(async (c) => {
   const { prompt } = await c.req.json();
 
-  return ai
-    .stream('@cf/meta/llama-3.3-70b-instruct-fp8-fast', {
-      messages: [{ role: 'user', content: prompt }],
-    })
-    .match({ ok: (result) => result, limited: (limit) => limit.response() });
+  return ai.stream('@cf/meta/llama-3.3-70b-instruct-fp8-fast', {
+    messages: [{ role: 'user', content: prompt }],
+  });
 });
 ```
 
+Streaming responses end with a `void:error` SSE event if generation is interrupted after the response starts, or `void:limit` for a usage limit. `fetchStream()` from `void/client` throws `UsageLimit` for limits before or during streaming and `StreamError` for other terminal errors. Catch the error in your UI to stop its generating state, retain partial output, and offer retry. This also applies to streaming provider responses and `ai.run()` with `stream: true`.
+
 ## Listing Models
 
 Use `ai.models()` to list available models:
 
 ```ts
-const models = await ai
-  .models()
-  .match({ ok: (result) => result, limited: (limit) => limit.response() });
+const models = await ai.models();
 
 // Filter by task
-const textModels = await ai
-  .models({ task: 'Text Generation' })
-  .match({ ok: (result) => result, limited: (limit) => limit.response() });
+const textModels = await ai.models({ task: 'Text Generation' });
 ```
 
 ## Markdown Conversion
@@ -80,28 +80,9 @@ const textModels = await ai
 Use `ai.toMarkdown()` to convert documents to markdown:
 
 ```ts
-const result = await ai
-  .toMarkdown([{ name: 'document.pdf', blob: pdfBytes }])
-  .match({ ok: (result) => result, limited: (limit) => limit.response() });
-```
-
-## Local Development
-
-For a direct Cloudflare project, connect your account and start development:
-
-```sh
-void connect --platform cloudflare
-npm run dev
+const result = await ai.toMarkdown([{ name: 'document.pdf', blob: pdfBytes }]);
 ```
 
-When the app imports `void/ai`, Void enables a remote Workers AI binding during
-development and preview. Requests use your Cloudflare account and its allowance;
-Workers AI has no local simulator. Use your Cloudflare login or
-`CLOUDFLARE_API_TOKEN` in an automated environment.
-
-For a team platform, use `void connect <platform-url>` and link your project.
-Development requests use that platform's account and usage limits.
-
 ## Usage Limits
 
 Workers AI usage is measured in [neurons](https://developers.cloudflare.com/workers-ai/platform/pricing/).
@@ -110,51 +91,50 @@ requests also use your provider credentials and their billing terms.
 
 A team platform uses its own Cloudflare account and may apply per-user limits. Ask your administrator about the available allowance.
 
-## Cloudflare Gateway Models
+Usage limits reject the operation's promise with `UsageLimit` from `void/limits`. It includes `resource`, `reason`, and an optional `retryAt` timestamp. In Void route handlers and Pages actions, an uncaught limit produces a structured HTTP 429 with retry information. In queues, scheduled jobs, and other server code, it remains a rejected promise.
 
-`ai.run()` mirrors Cloudflare's `env.AI.run()` model naming and input schemas. Third-party models use Cloudflare model IDs and Cloudflare-managed credentials.
+Handling a limit is optional. Use `instanceof UsageLimit` when you want a fallback or a message tailored to your app:
 
 ```ts
-const result = await ai
-  .run('google/gemini-2.5-flash', {
-    contents: [
-      {
-        role: 'user',
-        parts: [{ text: 'Explain Durable Objects in one paragraph.' }],
-      },
-    ],
-  })
-  .match({ ok: (result) => result, limited: (limit) => limit.response() });
+import { defineHandler } from 'void';
+import { ai } from 'void/ai';
+import { UsageLimit } from 'void/limits';
+
+export const POST = defineHandler(async (c) => {
+  const { prompt } = await c.req.json();
+  try {
+    const result = await ai.run('@cf/meta/llama-3.3-70b-instruct-fp8-fast', {
+      messages: [{ role: 'user', content: prompt }],
+    });
+    return c.json(result);
+  } catch (error) {
+    if (error instanceof UsageLimit) {
+      return error.response({ message: 'Try again shortly. Your prompt has been kept.' });
+    }
+    throw error;
+  }
+});
 ```
 
-OpenAI-compatible models use OpenAI-style `messages`:
+`error.response()` creates the structured HTTP 429 and accepts an optional custom `message`. Other failures reject normally. When using `fetchStream()`, the same `instanceof UsageLimit` check gives your client access to the message and retry information.
 
-```ts
-const result = await ai
-  .run('openai/gpt-4.1-mini', {
-    messages: [{ role: 'user', content: 'Summarize this deploy.' }],
-  })
-  .match({ ok: (result) => result, limited: (limit) => limit.response() });
-```
+## Cloudflare Gateway Models
 
-Pass Cloudflare AI Gateway options as the third argument:
+`ai.run()` mirrors Cloudflare's `env.AI.run()` model naming and input schemas. Third-party models use Cloudflare model IDs and Cloudflare-managed credentials.
 
 ```ts
-const result = await ai
-  .run(
-    'openai/gpt-4.1-mini',
-    {
-      messages: [{ role: 'user', content: 'Summarize this deploy.' }],
-    },
+const result = await ai.run('google/gemini-2.5-flash', {
+  contents: [
     {
-      gateway: {
-        skipCache: true,
-      },
+      role: 'user',
+      parts: [{ text: 'Explain Durable Objects in one paragraph.' }],
     },
-  )
-  .match({ ok: (result) => result, limited: (limit) => limit.response() });
+  ],
+});
 ```
 
+Pass AI Gateway options as the third argument: `ai.run(model, inputs, { gateway: { skipCache: true } })`.
+
 For provider-native requests on a direct deployment, configure [`ai.gateway`](../integrations/cloudflare.md#ai-self-host).
 
 ## Provider-Native Requests
@@ -173,19 +153,13 @@ import { ai } from 'void/ai';
 export const POST = defineHandler(async (c) => {
   const { prompt } = await c.req.json();
 
-  const response = await ai
-    .provider('openai')
-    .fetch('/chat/completions', {
-      body: {
-        model: 'gpt-4o',
-        messages: [{ role: 'user', content: prompt }],
-        max_tokens: 512,
-      },
-    })
-    .match({ ok: (result) => result, limited: (limit) => limit.response() });
-
-  const result = await response.json();
-  return c.json(result);
+  return ai.provider('openai').fetch('/chat/completions', {
+    body: {
+      model: 'gpt-4o',
+      messages: [{ role: 'user', content: prompt }],
+      max_tokens: 512,
+    },
+  });
 });
 ```
 
@@ -203,10 +177,7 @@ const response = await ai
         },
       ],
     },
-  })
-  .match({ ok: (result) => result, limited: (limit) => limit.response() });
-
-const result = await response.json();
+  });
 ```
 
 ### Custom Providers
@@ -222,8 +193,7 @@ const response = await ai
   })
   .fetch('/v1/respond', {
     body: { prompt: 'Hello' },
-  })
-  .match({ ok: (result) => result, limited: (limit) => limit.response() });
+  });
 ```
 
 ### Image Generation
@@ -233,9 +203,7 @@ Use `ai.run()` or `ai.image()` for Cloudflare-native image models:
 ```ts
 export const POST = defineHandler(async (c) => {
   const { prompt } = await c.req.json();
-  return ai
-    .image('@cf/black-forest-labs/flux-1-schnell', { prompt })
-    .match({ ok: (result) => result, limited: (limit) => limit.response() });
+  return ai.image('@cf/black-forest-labs/flux-1-schnell', { prompt });
 });
 ```
 
@@ -245,16 +213,13 @@ Use `ai.provider().fetch()` for provider-native image APIs. Match the [provider'
 export const POST = defineHandler(async (c) => {
   const { prompt } = await c.req.json();
 
-  return ai
-    .provider('openai')
-    .fetch('/images/generations', {
-      body: {
-        model: 'gpt-image-2.5-sunburst',
-        prompt,
-        size: '1024x1024',
-      },
-    })
-    .match({ ok: (result) => result, limited: (limit) => limit.response() });
+  return ai.provider('openai').fetch('/images/generations', {
+    body: {
+      model: 'gpt-image-2.5-sunburst',
+      prompt,
+      size: '1024x1024',
+    },
+  });
 });
 ```
 
@@ -268,39 +233,15 @@ export const POST = defineHandler(async (c) => {
   form.set('prompt', String(body.prompt));
   form.set('image', body.image as Blob, 'source.png');
 
-  return ai
-    .provider('openai')
-    .fetch('/images/edits', { body: form })
-    .match({ ok: (result) => result, limited: (limit) => limit.response() });
+  return ai.provider('openai').fetch('/images/edits', { body: form });
 });
 ```
 
 ### Provider Key Convention
 
-Provider-native requests require an API key set as a project secret. The env var name is automatically derived from the provider name:
-
-| Provider prefix    | Env var               |
-| ------------------ | --------------------- |
-| `openai`           | `OPENAI_API_KEY`      |
-| `anthropic`        | `ANTHROPIC_API_KEY`   |
-| `google-ai-studio` | `GOOGLE_API_KEY`      |
-| `deepseek`         | `DEEPSEEK_API_KEY`    |
-| `groq`             | `GROQ_API_KEY`        |
-| `mistral`          | `MISTRAL_API_KEY`     |
-| `grok`             | `GROK_API_KEY`        |
-| `openrouter`       | `OPENROUTER_API_KEY`  |
-| `perplexity`       | `PERPLEXITY_API_KEY`  |
-| `cohere`           | `COHERE_API_KEY`      |
-| `cerebras`         | `CEREBRAS_API_KEY`    |
-| `huggingface`      | `HUGGINGFACE_API_KEY` |
-| `replicate`        | `REPLICATE_API_KEY`   |
-| `baseten`          | `BASETEN_API_KEY`     |
-| `cartesia`         | `CARTESIA_API_KEY`    |
-| `deepgram`         | `DEEPGRAM_API_KEY`    |
-| `elevenlabs`       | `ELEVENLABS_API_KEY`  |
-| `fal`              | `FAL_API_KEY`         |
-| `ideogram`         | `IDEOGRAM_API_KEY`    |
-| `parallel`         | `PARALLEL_API_KEY`    |
+Provider-native requests use a project secret, such as `OPENAI_API_KEY` for OpenAI or `GOOGLE_API_KEY` for Google AI Studio.
+
+See the [provider key reference](../reference/api/resources.md#provider-keys) for supported providers and their secret names.
 
 OpenAI-style providers use `Authorization: Bearer <key>`. Google AI Studio uses `x-goog-api-key`. Use `apiKeyHeader` and `apiKeyPrefix` for custom providers.
 

package/skills/void/docs/guide/app-types.md

@@ -45,7 +45,7 @@ Add `voidPlugin()` to the framework's Vite config to get binding inference, type
 
 Any project that produces static files, whether that is an SPA, a static site, or a plain directory. Void serves the assets without requiring application code.
 
-**SPAs** (client-side single-page apps) fall back all non-file paths to `index.html` with a 200 status, so client-side routing works out of the box. Detected when `vite` is a dependency and no backend files exist.
+**SPAs** (client-side single-page apps) serve `index.html` with a 200 status for paths that match no file, so client-side routing works out of the box. On a Void platform, missing files under the hashed assets folder (`/assets/`) return 404 instead. Detected when `vite` is a dependency and no backend files exist.
 
 **Static sites** (static site generators like VitePress, Docusaurus, or any pre-built directory) produce per-page HTML files. Detected when a known SSG is a dependency, or when using the `--dir` flag.
 

package/skills/void/docs/guide/auth.md

@@ -155,5 +155,3 @@ void db generate
 ```
 
 Review and commit the SQL before deploying. Void includes your auth configuration and plugin tables; you don't need to duplicate them in `db/schema.ts` or run the Better Auth CLI.
-
-MySQL stores OAuth access, refresh, and ID tokens as unbounded text. Existing direct-deploy MySQL apps should run `void db generate` once after upgrading to widen earlier `varchar(255)` token columns. Void platform deployments apply the same safe widening automatically.