@agent-native/core 0.0.0-beta-20260820010957 → 0.0.0-beta-20260820052446

package/dist/client/EnvironmentBadge.d.ts

@@ -1,6 +1,5 @@
 import type { AgentNativeDeploymentEnvironment, AgentNativeConfig } from "../config.js";
-export declare const BETA_OPT_OUT_STORAGE_KEY = "agent-native:beta-opt-out-until";
-export { BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, type EnvironmentBadgeTargets, } from "../shared/environment-lanes.js";
+export { BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, type EnvironmentBadgeTargets, } from "../shared/environment-lanes.js";
 export declare function isBuilderIoEmployee(email: string | null | undefined): boolean;
 export declare function resolveEnvironmentChannel(config: AgentNativeConfig, hostname: string | undefined): Extract<AgentNativeDeploymentEnvironment, "beta" | "production"> | null;
 export declare function isBetaOptOutActive(value: string | number | null | undefined, now?: number): boolean;

package/dist/client/EnvironmentBadge.js

@@ -2,12 +2,11 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Button } from "@agent-native/toolkit/ui/button";
 import { Popover, PopoverContent, PopoverTrigger, } from "@agent-native/toolkit/ui/popover";
 import { useEffect, useMemo, useRef } from "react";
-import { BETA_OPT_OUT_QUERY_PARAM, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, } from "../shared/environment-lanes.js";
+import { BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, } from "../shared/environment-lanes.js";
 import { trackEvent } from "./analytics.js";
 import { injectedAgentNativeConfig } from "./app-config.js";
 import { useSession } from "./use-session.js";
-export const BETA_OPT_OUT_STORAGE_KEY = "agent-native:beta-opt-out-until";
-export { BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, } from "../shared/environment-lanes.js";
+export { BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, } from "../shared/environment-lanes.js";
 export function isBuilderIoEmployee(email) {
     return email?.trim().toLowerCase().endsWith("@builder.io") ?? false;
 }

package/dist/collab/awareness.d.ts

@@ -62,11 +62,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
-    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
+    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -77,9 +77,9 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
-    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
+    error?: undefined;
 }>>;

package/dist/deploy/build.d.ts

@@ -224,6 +224,13 @@ export declare function emitSingleTemplateNetlifyBackgroundFunction(projectCwd:
  */
 export declare function assertEmittedBackgroundFunctionOnDisk(destDir: string, functionName: string): void;
 export declare function emitSingleTemplateNetlifyIntegrationRecoveryFunction(projectCwd: string): void;
+/**
+ * A host-side prebuilt Netlify output can accidentally carry the native
+ * better-sqlite3 binary from the developer's machine. Netlify functions run
+ * on Linux, so fail before publication unless every copied binary is an ELF
+ * object produced by the Linux build.
+ */
+export declare function findNonLinuxBetterSqlite3Binaries(serverDir: string): string[];
 /**
  * Nitro receives the React Router SSR build as prebuilt chunks, so its normal
  * dependency resolver cannot reliably fold the preserved bare `yjs` imports

package/dist/deploy/build.js

@@ -2996,6 +2996,51 @@ function walkServerJavaScriptFiles(dir, onFile) {
             onFile(entryPath);
     }
 }
+/**
+ * A host-side prebuilt Netlify output can accidentally carry the native
+ * better-sqlite3 binary from the developer's machine. Netlify functions run
+ * on Linux, so fail before publication unless every copied binary is an ELF
+ * object produced by the Linux build.
+ */
+export function findNonLinuxBetterSqlite3Binaries(serverDir) {
+    const failures = [];
+    const walk = (dir) => {
+        if (!fs.existsSync(dir))
+            return;
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const entryPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(entryPath);
+                continue;
+            }
+            if (entry.name !== "better_sqlite3.node")
+                continue;
+            const normalizedPath = entryPath.split(path.sep).join("/");
+            if (!normalizedPath.includes("/node_modules/better-sqlite3/build/Release/better_sqlite3.node")) {
+                continue;
+            }
+            const header = fs.readFileSync(entryPath).subarray(0, 20);
+            const isLittleEndian = header[5] === 1;
+            const machine = header.length >= 20 && header[5] === 1
+                ? header.readUInt16LE(18)
+                : header.length >= 20 && header[5] === 2
+                    ? header.readUInt16BE(18)
+                    : null;
+            if (header.length < 20 ||
+                header[0] !== 0x7f ||
+                header[1] !== 0x45 ||
+                header[2] !== 0x4c ||
+                header[3] !== 0x46 ||
+                header[4] !== 2 ||
+                !isLittleEndian ||
+                machine !== 62) {
+                failures.push(entryPath);
+            }
+        }
+    };
+    walk(serverDir);
+    return failures;
+}
 /**
  * Nitro receives the React Router SSR build as prebuilt chunks, so its normal
  * dependency resolver cannot reliably fold the preserved bare `yjs` imports
@@ -3242,6 +3287,12 @@ export function assertSingleTemplateNetlifyBuildOutput(projectCwd) {
     if (privateYjsImports.length > 0) {
         failures.push(`Netlify server bundle imports Nitro's internal tree-shaken _libs/yjs.mjs: ${privateYjsImports.join(", ")}`);
     }
+    const nonLinuxBetterSqlite3Binaries = findNonLinuxBetterSqlite3Binaries(serverDir);
+    if (nonLinuxBetterSqlite3Binaries.length > 0) {
+        failures.push(`Netlify server bundle contains non-Linux better-sqlite3 native binaries: ${nonLinuxBetterSqlite3Binaries
+            .map((filePath) => path.relative(projectCwd, filePath))
+            .join(", ")}; build in Netlify's Linux environment instead of uploading a host-native prebuilt output`);
+    }
     // React Router's filesystem route discovery can accidentally treat a
     // co-located *.test.ts route as production code. That bundles Vitest into
     // SSR and only fails when the first request executes the test helpers.

package/dist/notifications/routes.d.ts

@@ -11,14 +11,14 @@
  *   DELETE /_agent-native/notifications/:id         — delete
  */
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
-    error?: undefined;
     count: number;
     updated?: undefined;
+    error?: undefined;
     ok?: undefined;
 } | {
-    error?: undefined;
     count?: undefined;
     updated: number;
+    error?: undefined;
     ok?: undefined;
 } | {
     count?: undefined;
@@ -26,8 +26,8 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     count?: undefined;
     updated?: undefined;
+    error?: undefined;
     ok: boolean;
 }>>;

package/dist/observability/routes.d.ts

@@ -41,27 +41,27 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
+    error?: undefined;
+    ok?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
+} | {
     error?: undefined;
     ok?: undefined;
-} | {
     summary?: undefined;
     spans?: undefined;
     id: string;
-    error?: undefined;
-    ok?: undefined;
 } | {
+    ok?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
     error: any;
-    ok?: undefined;
 } | {
+    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
-    error?: undefined;
     ok: boolean;
 }>>;

package/dist/progress/routes.d.ts

@@ -15,6 +15,6 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>>;

package/dist/server/onboarding-html.js

@@ -11,7 +11,7 @@ import { getLocaleInitScript } from "../localization/server.js";
 import { DEFAULT_LOCALE, LOCALE_METADATA, LOCALE_STORAGE_KEY, SUPPORTED_LOCALES, localeDisplayName, } from "../localization/shared.js";
 import { NATIVE_AUTH_COPY } from "../shared/auth-copy.js";
 import { docsUrl } from "../shared/docs-url.js";
-import { BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, ENVIRONMENT_BETA_HOSTS, } from "../shared/environment-lanes.js";
+import { BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, ENVIRONMENT_BETA_HOSTS, } from "../shared/environment-lanes.js";
 import { PASSWORD_MAX_LENGTH, PASSWORD_MIN_LENGTH, } from "../shared/password-policy.js";
 import { signInJourneyInlineScript } from "../shared/sign-in-journey.js";
 import { AGENT_NATIVE_SOCIAL_IMAGE_ALT, AGENT_NATIVE_SOCIAL_IMAGE_HEIGHT, AGENT_NATIVE_SOCIAL_IMAGE_PATH, AGENT_NATIVE_SOCIAL_IMAGE_TYPE, AGENT_NATIVE_SOCIAL_IMAGE_WIDTH, withAgentNativeSocialImageCacheBuster, } from "../shared/social-meta.js";
@@ -1433,6 +1433,34 @@ ${marketing.description ? `      <p class="app-desc" data-marketing-field="descr
     if (!switcher || !button || !popover || !productionLink) return;
     if (window.parent !== window) return;
 
+    // Persist the beta opt-out before authentication replaces this cached shell.
+    try {
+      var optOutUrl = new URL(window.location.href);
+      var optOutValue = optOutUrl.searchParams.get(${JSON.stringify(BETA_OPT_OUT_QUERY_PARAM)});
+      if (optOutValue !== null) {
+        var optOutExpiry = Number(optOutValue);
+        var optOutIsActive = Number.isFinite(optOutExpiry) && optOutExpiry > Date.now();
+        var optOutStorageReady = false;
+        try {
+          if (optOutIsActive) {
+            window.localStorage.setItem(
+              ${JSON.stringify(BETA_OPT_OUT_STORAGE_KEY)},
+              String(optOutExpiry),
+            );
+          }
+          optOutStorageReady = true;
+        } catch (error) {
+          void error;
+        }
+        if (optOutStorageReady) {
+          optOutUrl.searchParams.delete(${JSON.stringify(BETA_OPT_OUT_QUERY_PARAM)});
+          window.history.replaceState(null, '', optOutUrl.toString());
+        }
+      }
+    } catch (error) {
+      void error;
+    }
+
     var betaHosts = ${JSON.stringify(ENVIRONMENT_BETA_HOSTS)};
     var hostname = (window.location.hostname || '').toLowerCase().replace(/\\.$/, '');
     var productionHost = hostname.indexOf('beta.') === 0 ? hostname.slice(5) : '';

package/dist/server/realtime-token.d.ts

@@ -26,8 +26,8 @@ export declare function createRealtimeTokenHandler(): import("h3").EventHandlerW
     expiresAt?: undefined;
     ttlSeconds?: undefined;
 } | {
+    error?: undefined;
     token: string;
     expiresAt: string;
     ttlSeconds: number;
-    error?: undefined;
 }>>;

package/dist/server/transcribe-voice.d.ts

@@ -20,6 +20,6 @@ export declare function createTranscribeVoiceHandler(): import("h3").EventHandle
     error: string;
     text?: undefined;
 } | {
-    text: string;
     error?: undefined;
+    text: string;
 }>>;

package/dist/shared/environment-lanes.d.ts

@@ -1,5 +1,6 @@
 export declare const BETA_OPT_OUT_QUERY_PARAM = "agentNativeBetaOptOut";
 export declare const BETA_OPT_OUT_DURATION_MS: number;
+export declare const BETA_OPT_OUT_STORAGE_KEY = "agent-native:beta-opt-out-until";
 export declare const ENVIRONMENT_BETA_HOSTS: {
     readonly "agent-workspace.builder.io": "beta.agent-workspace.builder.io";
     readonly "analytics.agent-native.com": "beta.analytics.agent-native.com";

package/dist/shared/environment-lanes.js

@@ -1,5 +1,6 @@
 export const BETA_OPT_OUT_QUERY_PARAM = "agentNativeBetaOptOut";
 export const BETA_OPT_OUT_DURATION_MS = 24 * 60 * 60 * 1000;
+export const BETA_OPT_OUT_STORAGE_KEY = "agent-native:beta-opt-out-until";
 export const ENVIRONMENT_BETA_HOSTS = {
     "agent-workspace.builder.io": "beta.agent-workspace.builder.io",
     "analytics.agent-native.com": "beta.analytics.agent-native.com",

package/docs/content/agent-native-config.mdx

@@ -16,6 +16,12 @@ The resolved configuration is serialized into the browser bundle. Treat every
 value in these files as public. Put credentials and deployment-specific values
 in the environment or the scoped secret store instead.
 
+This file is the home for public, app-owned configuration - the values that
+describe how an app should behave or what capabilities it exposes. It is not a
+second environment-variable file. Environment variables still own secrets,
+provider credentials, database URLs, host-specific values, and other values
+that must change between deployments.
+
 ## File location and loading
 
 Put one configuration file at the app root, alongside `package.json` and the
@@ -77,7 +83,7 @@ recommended form.
 
 ## Supported options
 
-These are the only shared options read from the typed config and the shared
+These are the shared options read from the typed config and the shared
 configuration portion of `agent-native.json`:
 
 | Option                         | Type                                                              | Effect                                                                                                                                                                                    |
@@ -87,9 +93,47 @@ configuration portion of `agent-native.json`:
 | `runtime.auth.enabled`         | `boolean`                                                         | Declares whether the app expects the framework or a custom authentication layer.                                                                                                          |
 | `runtime.database.required`    | `boolean`                                                         | Declares whether production needs a persistent remote SQL database.                                                                                                                       |
 | `runtime.environment.required` | `string[]`                                                        | Declares additional required environment variable names. Names must match `[A-Za-z_][A-Za-z0-9_]*`; values do not belong in the config.                                                   |
+| `deployment.environment`       | `"local"`, `"beta"`, `"production"`, or `"preview"`               | Records the release lane that produced the current client bundle.                                                                                                                         |
 | `diagnostics.failOnBuild`      | `boolean`                                                         | When `true`, a production Vite build throws on runtime configuration issues. When absent or `false`, it reports them without failing the build.                                           |
 | `instructions.runtime`         | `string`                                                          | Optional relative Markdown path for the in-app runtime agent. Defaults to `AGENTS.md`.                                                                                                    |
 | `instructions.development`     | `string`                                                          | Optional relative Markdown path for development/coding agents. Defaults to `AGENTS.md`.                                                                                                   |
+| `translations.locales`         | `string[]`                                                        | Lists the locales the app intentionally ships. `en-US` remains the source locale.                                                                                                         |
+| `changelog.enabled`            | `boolean`                                                         | Enables the app changelog workflow and lets agents create user-facing entries.                                                                                                            |
+| `harness`                      | `boolean` or `{ runtimes: string[] }`                             | Enables the hosted tools-only harness, optionally narrowed to `claude-code`, `codex`, `pi`, or `opencode`. See [Harness Agents](/docs/harness-agents).                                    |
+
+## Configuration vs environment variables
+
+Use the config file or JSON manifest for stable, non-secret application
+defaults. Use environment variables or the scoped secret store for values that
+belong to a deployment or a user or organization connection:
+
+| Put it in                                                             | Examples                                                                                                           | Notes                                                                                                                                               |
+| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `agent-native.config.ts` or the shared section of `agent-native.json` | onboarding mode, required runtime contracts, release lane, shipped locales, changelog, hosted harness capabilities | Committed app policy. It is resolved during the Vite config phase and can use `command`, `mode`, `isDev`, and `isBuild`.                            |
+| Deployment environment variables                                      | `DATABASE_URL`, `BETTER_AUTH_SECRET`, `APP_URL`, `NITRO_PRESET`, provider keys, host-specific toggles              | Set by the deployment platform or local `.env`. Keep secret values out of source control. See [Environment Variables](/docs/environment-variables). |
+| `runtime.environment.required`                                        | `"PUBLIC_API_ORIGIN"`, `"STRIPE_PUBLISHABLE_KEY"`                                                                  | A declaration of names the production readiness check must find. It does not set, expose, or replace the values.                                    |
+
+For example, keep the app's public policy in the config file and inject the
+actual deployment values separately:
+
+```ts filename="agent-native.config.ts"
+import { defineAgentNativeConfig } from "@agent-native/core/config";
+
+export default defineAgentNativeConfig({
+  deployment: { environment: "production" },
+  translations: { locales: ["en-US", "es-ES"] },
+  changelog: { enabled: true },
+  harness: { runtimes: ["codex"] },
+  runtime: {
+    database: { required: true },
+    environment: { required: ["PUBLIC_API_ORIGIN"] },
+  },
+});
+```
+
+Set `DATABASE_URL`, `BETTER_AUTH_SECRET`, and `PUBLIC_API_ORIGIN` in the
+hosting provider or scoped secret store. The config file declares the policy;
+the deployment supplies the values.
 
 ### Separate runtime and development instructions
 

package/docs/content/aws-lambda.mdx

@@ -0,0 +1,36 @@
+---
+title: "AWS Lambda"
+description: "Deploy an Agent-Native app to AWS Lambda with Nitro's aws-lambda preset."
+search: "AWS Lambda deployment Nitro preset serverless"
+---
+
+# AWS Lambda
+
+Use Nitro's `aws-lambda` preset to build a Lambda-compatible server bundle.
+The Lambda filesystem is temporary, so store application data in a persistent
+SQL provider.
+
+```ts filename="vite.config.ts"
+export default defineConfig({
+  plugins: [agentNative({ nitro: { preset: "aws-lambda" } })],
+});
+```
+
+Build the function bundle:
+
+```bash
+npx @agent-native/core@latest build
+```
+
+Publish the generated output with AWS SAM, CDK, Serverless Framework, or the
+AWS console. Configure `DATABASE_URL`, `BETTER_AUTH_SECRET`, and any app
+secrets in Lambda environment variables or AWS Secrets Manager.
+
+See [Nitro's AWS Lambda provider guide](https://nitro.build/deploy/providers/aws)
+for provider-specific packaging and streaming options.
+
+## What's next
+
+- [**Deploy an app**](/docs/deploy-an-app) - the complete app path
+- [**Deployment environment variables**](/docs/deployment-environment-variables) - production configuration
+- [**Deno Deploy**](/docs/deno-deploy) - another serverless runtime

package/docs/content/azure-static-web-apps.mdx

@@ -0,0 +1,36 @@
+---
+title: "Azure Static Web Apps"
+description: "Deploy an Agent-Native app to Azure Static Web Apps with Nitro's azure-swa preset."
+search: "Azure Static Web Apps deployment Nitro preset"
+---
+
+# Azure Static Web Apps
+
+Nitro provides the `azure-swa` preset for Azure Static Web Apps. It packages
+the public assets and server routes for the provider's static and API hosting
+model.
+
+```ts filename="vite.config.ts"
+export default defineConfig({
+  plugins: [agentNative({ nitro: { preset: "azure-swa" } })],
+});
+```
+
+Build the provider output:
+
+```bash
+npx @agent-native/core@latest build
+```
+
+Deploy the generated output with the Azure Static Web Apps CLI or your CI
+workflow. Use a persistent external SQL database and configure
+`DATABASE_URL`, `BETTER_AUTH_SECRET`, and app secrets in the Azure environment.
+
+See [Nitro's Azure provider guide](https://nitro.build/deploy/providers/azure)
+for the current provider workflow.
+
+## What's next
+
+- [**Deploy an app**](/docs/deploy-an-app) - the complete app path
+- [**Deployment environment variables**](/docs/deployment-environment-variables) - production configuration
+- [**Koyeb**](/docs/koyeb) - a managed Node.js target

package/docs/content/cloudflare.mdx

@@ -40,4 +40,4 @@ before deploying. A Worker filesystem is not a persistent application store.
 
 - [**Deployment**](/docs/deployment) — pick a persistent database and a preset before your first production deploy
 - [**Workspace Deployment**](/docs/workspace-deployment) — Cloudflare Pages is the default preset for the unified `deploy` command
-- [**Node.js & Docker**](/docs/node-docker), [**Vercel**](/docs/vercel), [**Netlify**](/docs/netlify), and [**Other Platforms**](/docs/other-platforms) — the other Nitro presets
+- [**Node.js**](/docs/node-js), [**Docker**](/docs/docker), [**Vercel**](/docs/vercel), [**Netlify**](/docs/netlify), [**AWS Lambda**](/docs/aws-lambda), and [**Deno Deploy**](/docs/deno-deploy) — the other Nitro presets

package/docs/content/deno-deploy.mdx

@@ -0,0 +1,36 @@
+---
+title: "Deno Deploy"
+description: "Deploy an Agent-Native app to Deno Deploy with Nitro's deno-deploy preset."
+search: "Deno Deploy deployment Nitro preset serverless"
+---
+
+# Deno Deploy
+
+Use Nitro's `deno-deploy` preset to generate a Deno-compatible server output.
+Keep application data in a persistent SQL provider because a deployment
+filesystem is not durable application storage.
+
+```ts filename="vite.config.ts"
+export default defineConfig({
+  plugins: [agentNative({ nitro: { preset: "deno-deploy" } })],
+});
+```
+
+Build the deployment output:
+
+```bash
+npx @agent-native/core@latest build
+```
+
+Publish the generated output with Deno Deploy's current CLI or dashboard.
+Configure `DATABASE_URL`, `BETTER_AUTH_SECRET`, and any app secrets in the
+deployment environment.
+
+See [Nitro's Deno Deploy provider guide](https://nitro.build/deploy/providers/deno-deploy)
+for the current provider workflow.
+
+## What's next
+
+- [**Deploy an app**](/docs/deploy-an-app) - the complete app path
+- [**Deployment environment variables**](/docs/deployment-environment-variables) - production configuration
+- [**AWS Lambda**](/docs/aws-lambda) - another serverless runtime

package/docs/content/deploy-an-app.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Deploy an app"
 description: "Build and deploy one Agent-Native app to Node.js, Vercel, Netlify, Cloudflare, AWS, or Deno."
-search: "deploy app standalone build Nitro preset Node.js Vercel Netlify Cloudflare AWS Deno"
+search: "deploy app standalone build Nitro preset Node.js Docker Vercel Netlify Cloudflare AWS Lambda Deno Deploy Azure Koyeb Render"
 ---
 
 # Deploy an app
@@ -38,11 +38,17 @@ export default defineConfig({
 
 See the target page for the provider command and runtime details:
 
-- [**Node.js & Docker**](/docs/node-docker)
+- [**Node.js**](/docs/node-js)
+- [**Docker**](/docs/docker)
 - [**Vercel**](/docs/vercel)
 - [**Netlify**](/docs/netlify)
-- [**Cloudflare**](/docs/cloudflare)
-- [**AWS Lambda and Deno Deploy**](/docs/other-platforms)
+- [**Cloudflare Pages**](/docs/cloudflare#cloudflare-pages)
+- [**Cloudflare Workers**](/docs/cloudflare#cloudflare-workers)
+- [**AWS Lambda**](/docs/aws-lambda)
+- [**Deno Deploy**](/docs/deno-deploy)
+- [**Azure Static Web Apps**](/docs/azure-static-web-apps)
+- [**Koyeb**](/docs/koyeb)
+- [**Render**](/docs/render)
 
 ### Build the app
 
@@ -59,7 +65,7 @@ node .output/server/index.mjs
 ```
 
 For a local production-shaped check with Postgres and Docker, follow the
-[Node.js & Docker quickstart](/docs/node-docker#self-host-quickstart).
+[Docker quickstart](/docs/docker#self-host-quickstart).
 
 ### Configure the deployment
 

package/docs/content/deployment.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Deployment"
 description: "Deploy an Agent-Native app or workspace to a Nitro-compatible platform with a persistent SQL database."
-search: "deployment deploy app workspace hosting database Nitro Vercel Netlify Cloudflare Node.js"
+search: "deployment deploy app workspace hosting database Nitro Node.js Docker Vercel Netlify Cloudflare AWS Lambda Deno Deploy Azure Static Web Apps Koyeb Render"
 ---
 
 # Deployment
@@ -65,14 +65,18 @@ In a workspace, every app inherits the root `DATABASE_URL` by default. Set
 Set a Nitro preset for the target you choose. The app code and database
 contract stay the same.
 
-<Diagram id="doc-block-deployment-targets" title="Supported deployment targets" summary="Agent-Native apps can deploy to Node.js, Vercel, Netlify, Cloudflare, AWS Lambda, and Deno Deploy. Provider logos are shown for the hosted targets with first-party deployment pages.">
+<Diagram id="doc-block-deployment-targets" title="Supported deployment targets" summary="Agent-Native apps can deploy to Node.js, Docker, Vercel, Netlify, Cloudflare Pages, Cloudflare Workers, AWS Lambda, Deno Deploy, Azure Static Web Apps, Koyeb, and Render.">
 
 ```html
 <div class="deployment-target-grid">
-  <a class="deployment-target" href="/docs/node-docker">
+  <a class="deployment-target" href="/docs/node-js">
     <span class="deployment-target-mark text-mark">N</span>
     <strong>Node.js</strong>
   </a>
+  <a class="deployment-target" href="/docs/docker">
+    <span class="deployment-target-mark text-mark">D</span>
+    <strong>Docker</strong>
+  </a>
   <a class="deployment-target" href="/docs/vercel">
     <span class="deployment-target-mark">
       <img src="/integration-logos/vercel.svg" alt="" />
@@ -85,20 +89,38 @@ contract stay the same.
     </span>
     <strong>Netlify</strong>
   </a>
-  <a class="deployment-target" href="/docs/cloudflare">
+  <a class="deployment-target" href="/docs/cloudflare#cloudflare-pages">
     <span class="deployment-target-mark">
       <img src="/integration-logos/cloudflare.svg" alt="" />
     </span>
-    <strong>Cloudflare</strong>
+    <strong>Cloudflare Pages</strong>
   </a>
-  <a class="deployment-target" href="/docs/other-platforms#aws-lambda">
+  <a class="deployment-target" href="/docs/cloudflare#cloudflare-workers">
+    <span class="deployment-target-mark">
+      <img src="/integration-logos/cloudflare.svg" alt="" />
+    </span>
+    <strong>Cloudflare Workers</strong>
+  </a>
+  <a class="deployment-target" href="/docs/aws-lambda">
     <span class="deployment-target-mark text-mark">AWS</span>
     <strong>AWS Lambda</strong>
   </a>
-  <a class="deployment-target" href="/docs/other-platforms#deno-deploy">
+  <a class="deployment-target" href="/docs/deno-deploy">
     <span class="deployment-target-mark text-mark">D</span>
     <strong>Deno Deploy</strong>
   </a>
+  <a class="deployment-target" href="/docs/azure-static-web-apps">
+    <span class="deployment-target-mark text-mark">A</span>
+    <strong>Azure Static Web Apps</strong>
+  </a>
+  <a class="deployment-target" href="/docs/koyeb">
+    <span class="deployment-target-mark text-mark">K</span>
+    <strong>Koyeb</strong>
+  </a>
+  <a class="deployment-target" href="/docs/render">
+    <span class="deployment-target-mark text-mark">R</span>
+    <strong>Render</strong>
+  </a>
 </div>
 ```
 
@@ -154,9 +176,12 @@ contract stay the same.
 Start with the path above. Use these pages when you need provider-specific
 settings or production controls:
 
-- [**Node.js & Docker**](/docs/node-docker) - run the default preset directly or in a container
-- [**Vercel**](/docs/vercel), [**Netlify**](/docs/netlify), and [**Cloudflare**](/docs/cloudflare) - configure the main hosted targets
-- [**Other Platforms**](/docs/other-platforms) - deploy to AWS Lambda or Deno Deploy
+- [**Node.js**](/docs/node-js) - run the default Nitro server preset
+- [**Docker**](/docs/docker) - package the Node.js server in a container
+- [**Vercel**](/docs/vercel), [**Netlify**](/docs/netlify), [**Cloudflare Pages**](/docs/cloudflare#cloudflare-pages), and [**Cloudflare Workers**](/docs/cloudflare#cloudflare-workers) - configure hosted targets
+- [**AWS Lambda**](/docs/aws-lambda) and [**Deno Deploy**](/docs/deno-deploy) - deploy to function and Deno runtimes
+- [**Azure Static Web Apps**](/docs/azure-static-web-apps), [**Koyeb**](/docs/koyeb), and [**Render**](/docs/render) - use additional Nitro providers
+- [Nitro's provider list](https://nitro.build/deploy/providers) - see the broader set of presets Nitro supports
 - [**SSR Caching**](/docs/ssr-caching) - configure the public shell cache
 - [**Deployment Environment Variables**](/docs/deployment-environment-variables) - production secrets, runtime flags, and workspace inheritance
 - [**Production Agent Access**](/docs/actions-agent-tools) - control framework tools and code execution
@@ -166,7 +191,7 @@ settings or production controls:
 <a id="skip-ensure-tables"></a>
 
 For compatibility with older links, the local Docker quickstart now lives on
-[Node.js & Docker](/docs/node-docker#self-host-quickstart). Schema setup and
+[Docker](/docs/docker#self-host-quickstart). Schema setup and
 cold-start guidance live in the [deployment environment reference](/docs/deployment-environment-variables#skip-ensure-tables).
 
 ## What's next

package/docs/content/docker.mdx

@@ -0,0 +1,63 @@
+---
+title: "Docker"
+description: "Package an Agent-Native Node.js server in a Docker image or local Compose stack."
+search: "Docker container deployment Node.js Postgres Compose Nitro"
+---
+
+# Docker
+
+Docker is an optional packaging and self-hosting choice. It runs the
+framework's Node.js server. You do not need Docker when deploying directly to
+Node.js, Vercel, Netlify, Cloudflare, or another Nitro target.
+
+## Local quickstart {#self-host-quickstart}
+
+Create an app, install dependencies, and build the image:
+
+```bash
+npx @agent-native/core@latest create my-app --standalone --template chat
+cd my-app
+pnpm install
+docker build -t my-agent-native-app .
+docker run --rm -p 3000:3000 my-agent-native-app
+```
+
+For a local Postgres-backed stack, use Docker Compose. The [self-hosted Chat
+fixture](https://www.agent-native.com/examples/self-hosted-chat/docker-compose.yml)
+includes the app and database services. It is for local development, not an
+internet-facing production deployment.
+
+## Production image
+
+Use a persistent external database. Do not copy the local `data/` directory
+into the image.
+
+```dockerfile filename="Dockerfile"
+FROM node:24-slim AS build
+WORKDIR /app
+COPY package.json pnpm-lock.yaml ./
+RUN corepack enable && pnpm install --frozen-lockfile
+COPY . .
+RUN pnpm build
+
+FROM node:24-slim
+WORKDIR /app
+COPY --from=build /app/.output .output
+ENV NODE_ENV=production
+ENV PORT=3000
+EXPOSE 3000
+CMD ["node", ".output/server/index.mjs"]
+```
+
+Set `DATABASE_URL`, `BETTER_AUTH_SECRET`, and any provider keys in the
+container or host secret store. Configure HTTPS and OAuth callback URLs for
+the public origin.
+
+Self-hosting multiple apps with Docker Compose is covered in
+[Workspace Deployment](/docs/workspace-deployment#workspace-docker-compose).
+
+## What's next
+
+- [**Node.js**](/docs/node-js) - the runtime behind this image
+- [**Deploy an app**](/docs/deploy-an-app) - the complete app path
+- [**Deployment**](/docs/deployment) - compare deployment targets

package/docs/content/koyeb.mdx

@@ -0,0 +1,36 @@
+---
+title: "Koyeb"
+description: "Deploy an Agent-Native app to Koyeb with Nitro's koyeb preset."
+search: "Koyeb deployment Nitro preset Node.js"
+---
+
+# Koyeb
+
+Use Nitro's `koyeb` preset to build an output for Koyeb's managed application
+runtime.
+
+```ts filename="vite.config.ts"
+export default defineConfig({
+  plugins: [agentNative({ nitro: { preset: "koyeb" } })],
+});
+```
+
+Build the app and deploy the generated server with Koyeb's git or container
+workflow:
+
+```bash
+npx @agent-native/core@latest build
+node .output/server/index.mjs
+```
+
+Set `DATABASE_URL`, `BETTER_AUTH_SECRET`, and any app secrets as Koyeb
+environment variables. Use a persistent SQL database instead of local files.
+
+See [Nitro's Koyeb provider guide](https://nitro.build/deploy/providers/koyeb)
+for the current provider workflow.
+
+## What's next
+
+- [**Deploy an app**](/docs/deploy-an-app) - the complete app path
+- [**Node.js**](/docs/node-js) - the default runtime
+- [**Render**](/docs/render) - another managed Node.js target

package/docs/content/netlify.mdx

@@ -44,4 +44,4 @@ If you are on a free or otherwise quota-limited database tier, leave `AGENT_NATI
 
 - [**Deployment**](/docs/deployment) — pick a persistent database and a preset before your first production deploy
 - [**SSR Caching**](/docs/ssr-caching) — the default cache policy and Netlify's separate `netlify-cdn-cache-control` behavior
-- [**Node.js & Docker**](/docs/node-docker), [**Vercel**](/docs/vercel), [**Cloudflare**](/docs/cloudflare), and [**Other Platforms**](/docs/other-platforms) — the other Nitro presets
+- [**Node.js**](/docs/node-js), [**Docker**](/docs/docker), [**Vercel**](/docs/vercel), [**Cloudflare**](/docs/cloudflare), [**AWS Lambda**](/docs/aws-lambda), and [**Deno Deploy**](/docs/deno-deploy) — the other Nitro presets

package/docs/content/node-docker.mdx

@@ -1,138 +1,25 @@
 ---
-title: "Node.js & Docker"
-description: "Deploy an agent-native app with the default Node.js Nitro preset, standalone or containerized with Docker."
+title: "Node.js and Docker"
+description: "Compatibility page for the former combined Node.js and Docker deployment guide."
 ---
 
-# Node.js & Docker
+# Node.js and Docker
 
-Node.js is the default Nitro preset. This page covers running it directly and containerizing it with Docker. See [Deployment](/docs/deployment) for picking a database first, and [Workspace Deployment](/docs/workspace-deployment#workspace-docker-compose) for self-hosting a multi-app workspace with Docker Compose.
+This URL is kept for older links. Node.js and Docker are separate deployment
+choices, so use the individual guides:
 
-## Fast path: self-host a Chat app locally {#self-host-quickstart}
+- [**Node.js**](/docs/node-js) - run the default Nitro server preset
+- [**Docker**](/docs/docker) - package the server in a container
+- [**Workspace Deployment**](/docs/workspace-deployment#workspace-docker-compose) - run several apps with Docker Compose
 
-There are two good starting points, depending on your role:
+<a id="self-host-quickstart"></a>
 
-- **Building an app?** Start with [Getting Started](/docs/getting-started), then return here when you are ready to put the result somewhere permanent.
-- **Operating an app?** Use the local Docker path below first. It exercises the same Node.js, Postgres, authentication, and environment-variable shape you will use on a small server.
+The former local quickstart now lives in the [Docker guide](/docs/docker#self-host-quickstart).
 
-The local stack intentionally uses a fake auth secret, trust authentication, and a local Postgres volume. It is for `localhost`, not an internet-facing deployment. Do not reuse the trust-authentication setting in production.
+<a id="nodejs"></a>
 
-### 1. Create the app
+The former Node.js section now lives in the [Node.js guide](/docs/node-js).
 
-```bash
-npx @agent-native/core@latest create my-app --standalone --template chat
-cd my-app
-pnpm install
-```
+<a id="docker"></a>
 
-The install step creates the lockfile that the production Dockerfile below copies into its build stage.
-
-### 2. Add the local Docker files
-
-Create `Dockerfile`, `.dockerignore`, and `docker-compose.yml` in the app root. `docker compose up --build` needs the Dockerfile, and `.dockerignore` keeps host-only files such as `node_modules` out of the Linux build context. Compose starts Postgres only on the private Compose network.
-
-You can also download the [Dockerfile](https://www.agent-native.com/examples/self-hosted-chat/Dockerfile), [.dockerignore](https://www.agent-native.com/examples/self-hosted-chat/.dockerignore), [Compose file](https://www.agent-native.com/examples/self-hosted-chat/docker-compose.yml), and [environment template](https://www.agent-native.com/examples/self-hosted-chat/env.example) as a starter fixture. The [Dockerfile](#docker) below matches the fixture.
-
-```yaml filename="docker-compose.yml" maxLines=40
-services:
-  app:
-    build: .
-    ports:
-      - "127.0.0.1:3000:3000"
-    environment:
-      DATABASE_URL: postgres://agent_native@postgres:5432/agent_native
-      BETTER_AUTH_SECRET: local-development-secret-change-me-1234567890
-      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}
-    depends_on:
-      postgres:
-        condition: service_healthy
-
-  postgres:
-    image: postgres:18
-    environment:
-      POSTGRES_DB: agent_native
-      POSTGRES_USER: agent_native
-      POSTGRES_HOST_AUTH_METHOD: trust
-    volumes:
-      - postgres-data-v18:/var/lib/postgresql
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U agent_native -d agent_native"]
-      interval: 5s
-      timeout: 5s
-      retries: 10
-
-volumes:
-  postgres-data-v18:
-```
-
-PostgreSQL 18 uses `/var/lib/postgresql` as its volume mount path, unlike PostgreSQL 17 and earlier. The versioned volume name keeps this fresh fixture separate from older local stacks. If you are upgrading an existing PostgreSQL 17 or earlier stack, back up and migrate its data before changing the image or mount path. Do not point this fixture at the old volume without a migration.
-
-### 3. Run it
-
-```bash
-docker compose up --build
-```
-
-Open [http://localhost:3000](http://localhost:3000). The app infers its local auth origin from the browser request. Set `ANTHROPIC_API_KEY` in a local `.env` file if you want to use the embedded agent; leave it empty if you only want to verify that the app and database start. Stop the stack with `docker compose down`; add `-v` when you intentionally want to reset the local database.
-
-Before putting this on the public internet, replace the example secret, configure HTTPS and OAuth callback URLs, use a persistent production database, and complete the [production environment checklist](/docs/deployment-environment-variables#env-required-prod).
-
-## Node.js (Default) {#nodejs}
-
-The default preset. Build and run:
-
-```bash
-npx @agent-native/core@latest build
-node .output/server/index.mjs
-```
-
-Set `PORT` to configure the listen port (default: `3000`).
-
-Use the current Node.js LTS line for production deploys. As of May 2026, that
-is Node.js 24. Node.js 20 reached end-of-life on April 30, 2026 and no longer
-receives upstream security updates.
-
-## Docker {#docker}
-
-This Dockerfile works for the standalone app created above. Run `pnpm install` before building so `pnpm-lock.yaml` exists in the build context. Keep the dependency manifest and lockfile in sync when you update the app.
-
-```dockerfile filename="Dockerfile"
-FROM node:24-slim AS build
-WORKDIR /app
-COPY package.json pnpm-lock.yaml ./
-RUN corepack enable && pnpm install --frozen-lockfile
-COPY . .
-RUN pnpm build
-
-FROM node:24-slim
-WORKDIR /app
-COPY --from=build /app/.output .output
-# data/ is a runtime-created SQLite directory. Do not copy a dev DB into prod.
-# For production, set DATABASE_URL to a hosted Postgres or Turso instance.
-RUN mkdir -p /app/data
-ENV NODE_ENV=production
-ENV PORT=3000
-EXPOSE 3000
-CMD ["node", ".output/server/index.mjs"]
-```
-
-Create `.dockerignore` alongside the Dockerfile:
-
-```text filename=".dockerignore"
-node_modules
-.output
-data
-.env
-.env.*
-!.env.example
-.git
-```
-
-Self-hosting a multi-app workspace with Docker Compose, built on this same
-standalone Dockerfile, is covered in
-[Workspace Deployment](/docs/workspace-deployment#workspace-docker-compose).
-
-## What's next
-
-- [**Deployment**](/docs/deployment) — pick a persistent database and a preset before your first production deploy
-- [**Workspace Deployment**](/docs/workspace-deployment) — self-host a multi-app workspace with Docker Compose
-- [**Vercel**](/docs/vercel), [**Netlify**](/docs/netlify), [**Cloudflare**](/docs/cloudflare), and [**Other Platforms**](/docs/other-platforms) — the other Nitro presets
+The former Docker section now lives in the [Docker guide](/docs/docker).

package/docs/content/node-js.mdx

@@ -0,0 +1,56 @@
+---
+title: "Node.js"
+description: "Deploy an Agent-Native app with Nitro's default Node.js server preset."
+search: "Node.js deployment Nitro node server preset production"
+---
+
+# Node.js
+
+Node.js is the default Nitro target. Use it when you want to run the generated
+server yourself on a VM, a managed Node host, or your own infrastructure.
+
+<Steps>
+
+### Build the app
+
+Build the client and server output:
+
+```bash
+npx @agent-native/core@latest build
+```
+
+You can make the target explicit in a build environment:
+
+```bash
+NITRO_PRESET=node npx @agent-native/core@latest build
+```
+
+### Start the server
+
+Run the generated server with a supported Node.js LTS release:
+
+```bash
+node .output/server/index.mjs
+```
+
+The server listens on port `3000` by default. Set `PORT` when your host assigns
+a different port.
+
+### Configure production
+
+Use a persistent SQL database and set `DATABASE_URL` before the first
+production start. Add a stable `BETTER_AUTH_SECRET` and the provider variables
+your app uses. The [deployment environment reference](/docs/deployment-environment-variables)
+covers the full production configuration.
+
+</Steps>
+
+Node.js is a runtime choice, not a requirement to use Docker. If you want a
+container image, use the separate [Docker guide](/docs/docker).
+
+## What's next
+
+- [**Deploy an app**](/docs/deploy-an-app) - the complete app path
+- [**Workspace Deployment**](/docs/workspace-deployment) - one origin for many apps
+- [**Docker**](/docs/docker) - package this Node.js server in a container
+- [**Deployment**](/docs/deployment) - compare targets and prerequisites

package/docs/content/other-platforms.mdx

@@ -1,27 +1,21 @@
 ---
-title: "Other Platforms"
-description: "Deploy an agent-native app to AWS Lambda or Deno Deploy with the matching Nitro preset."
+title: "Other Nitro Platforms"
+description: "Compatibility page for deployment targets that were formerly grouped under Other Platforms."
 ---
 
-# Other Platforms
+# Other Nitro Platforms
 
-## AWS Lambda {#aws-lambda}
+These targets now have individual pages. This URL is kept for older links.
 
-```ts filename="vite.config.ts"
-export default defineConfig({
-  plugins: [agentNative({ nitro: { preset: "aws_lambda" } })],
-});
-```
+<a id="aws-lambda"></a>
 
-## Deno Deploy {#deno-deploy}
+- [**AWS Lambda**](/docs/aws-lambda)
 
-```ts filename="vite.config.ts"
-export default defineConfig({
-  plugins: [agentNative({ nitro: { preset: "deno_deploy" } })],
-});
-```
+<a id="deno-deploy"></a>
 
-## What's next
+- [**Deno Deploy**](/docs/deno-deploy)
 
-- [**Deployment**](/docs/deployment) — pick a persistent database and a preset before your first production deploy
-- [**Node.js & Docker**](/docs/node-docker), [**Vercel**](/docs/vercel), [**Netlify**](/docs/netlify), and [**Cloudflare**](/docs/cloudflare) — the other Nitro presets
+- [**Azure Static Web Apps**](/docs/azure-static-web-apps)
+- [**Koyeb**](/docs/koyeb)
+- [**Render**](/docs/render)
+- [Nitro's provider list](https://nitro.build/deploy/providers)

package/docs/content/render.mdx

@@ -0,0 +1,35 @@
+---
+title: "Render"
+description: "Deploy an Agent-Native app to Render with Nitro's render-com preset."
+search: "Render deployment Nitro preset Node.js"
+---
+
+# Render
+
+Use Nitro's `render-com` preset to build an output for a Render web service.
+
+```ts filename="vite.config.ts"
+export default defineConfig({
+  plugins: [agentNative({ nitro: { preset: "render-com" } })],
+});
+```
+
+Build the app and use Render's normal web service workflow to run the output:
+
+```bash
+npx @agent-native/core@latest build
+node .output/server/index.mjs
+```
+
+Set `DATABASE_URL`, `BETTER_AUTH_SECRET`, and any app secrets in Render's
+environment configuration. Use a persistent SQL database instead of local
+files.
+
+See [Nitro's Render provider guide](https://nitro.build/deploy/providers/render)
+for the current provider workflow.
+
+## What's next
+
+- [**Deploy an app**](/docs/deploy-an-app) - the complete app path
+- [**Node.js**](/docs/node-js) - the default runtime
+- [**Koyeb**](/docs/koyeb) - another managed Node.js target

package/docs/content/vercel.mdx

@@ -35,4 +35,4 @@ The workspace build copies each app's Nitro `vercel` output into the root `.verc
 
 - [**Deployment**](/docs/deployment) — pick a persistent database and a preset before your first production deploy
 - [**Workspace Deployment**](/docs/workspace-deployment) — the `deploy --preset vercel` workspace build in full
-- [**Node.js & Docker**](/docs/node-docker), [**Netlify**](/docs/netlify), [**Cloudflare**](/docs/cloudflare), and [**Other Platforms**](/docs/other-platforms) — the other Nitro presets
+- [**Node.js**](/docs/node-js), [**Docker**](/docs/docker), [**Netlify**](/docs/netlify), [**Cloudflare**](/docs/cloudflare), [**AWS Lambda**](/docs/aws-lambda), and [**Deno Deploy**](/docs/deno-deploy) — the other Nitro presets

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.0.0-beta-20260820010957",
+  "version": "0.0.0-beta-20260820052446",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {