@agent-native/core 0.148.1 → 0.149.0

package/dist/templates/workspace-root/pnpm-workspace.yaml

@@ -24,6 +24,7 @@ onlyBuiltDependencies:
   - esbuild
   - lightningcss
   - node-pty
+  - tesseract.js
 
 allowBuilds:
   "@swc/core": true
@@ -33,3 +34,4 @@ allowBuilds:
   esbuild: true
   lightningcss: true
   node-pty: true
+  tesseract.js: true

package/docs/content/cloneable-saas.mdx

@@ -298,12 +298,12 @@ If you're scaffolding now, the CLI command is:
 npx @agent-native/core@latest create my-platform
 ```
 
-The CLI first asks **How do you want to start?** — pick **Full template(s)**
-to reach the multi-select picker (Chat and Headless each scaffold a single
-standalone app directly instead, skipping the picker). Pick one app
-(standalone) or several (workspace — apps share auth, brand, agent config, and
-database). Each picked app is scaffolded into `apps/<name>/` with every file
-you need. For a no-browser automation instead of an app UI, use
+The CLI first asks **How do you want to start?** — pick **Chat** for a minimal
+workspace with Chat and Dispatch, or pick **First-party template(s)** to reach the
+multi-select picker. Community and Headless are the standalone on-ramps.
+Workspace apps share auth, brand, agent config, and database; each app is
+scaffolded into `apps/<name>/` with every file you need. For a no-browser
+automation instead of an app UI, use
 `npx @agent-native/core@latest create my-agent --headless`.
 
 Fill in `.env` (mostly `ANTHROPIC_API_KEY` and `DATABASE_URL`), `pnpm install`, `pnpm dev`, and it works. No "TODO: implement login," no placeholder routes.

package/docs/content/deployment.mdx

@@ -435,19 +435,20 @@ The workspace build writes static assets under `dist/_workspace_static/` and rou
 
 ### Keep-warm and scale-to-zero databases {#netlify-keep-warm}
 
-The Netlify build emits a scheduled function that requests `/_agent-native/health` **every minute**. That keeps the server function and its database warm so the next visitor after an idle period doesn't pay a cold start (1–5s on Neon). On provisioned compute this is the right default.
+When enabled, the Netlify build emits a scheduled function that requests `/_agent-native/health` **every minute**. That keeps the server function and its database warm so the next visitor after an idle period doesn't pay a cold start (1–5s on Neon).
 
-**On a metered scale-to-zero database it is the wrong default.** A once-a-minute wake means autosuspend never fires, so the database bills and quota-limits as though it were awake continuously with nobody using the app. On a free-tier Neon this exhausts the compute quota, and the database then rejects **all** reads mid-session — the symptom is a dead app, not a slow one.
+Keep-warm is **disabled by default** because a once-a-minute wake prevents autosuspend on metered scale-to-zero databases. On a free-tier Neon this can exhaust the compute quota, and the database then rejects **all** reads mid-session — the symptom is a dead app, not a slow one. Set `AGENT_NATIVE_ENABLE_KEEP_WARM=1` when the lower next-visitor latency is worth the database awake-time.
 
-Three knobs, all opt-in, defaults unchanged:
+The keep-warm schedule and background-function warm only apply after the main keep-warm flag is enabled:
 
 | Variable                                    | Effect                                                                                                                                                                       |
 | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `AGENT_NATIVE_DISABLE_KEEP_WARM`            | Skips the scheduled function entirely. The database is free to autosuspend; the next visitor after an idle period pays its cold start.                                       |
-| `AGENT_NATIVE_KEEP_WARM_SCHEDULE`           | Overrides the cadence with a 5-field cron expression, e.g. `*/5 * * * *`. An unparseable value **fails the build** rather than silently reverting to once a minute.          |
+| `AGENT_NATIVE_ENABLE_KEEP_WARM`             | Opts into the scheduled server/database warm. Unset by default.                                                                                                              |
+| `AGENT_NATIVE_DISABLE_KEEP_WARM`            | Compatibility kill switch that wins over the opt-in flag when set.                                                                                                           |
+| `AGENT_NATIVE_KEEP_WARM_SCHEDULE`           | Overrides the cadence with a 5-field cron expression, e.g. `*/5 * * * *`. The default cadence when enabled is `* * * * *`; an unparseable value **fails the build**.         |
 | `AGENT_NATIVE_DISABLE_KEEP_WARM_BACKGROUND` | Drops only the background-function warm, keeping the server warm. Warming `server` is one request; warming `-background` starts a fresh container that re-probes the schema. |
 
-If you are on a free or otherwise quota-limited database tier, set `AGENT_NATIVE_DISABLE_KEEP_WARM=1` or pick a slower cadence.
+If you are on a free or otherwise quota-limited database tier, leave `AGENT_NATIVE_ENABLE_KEEP_WARM` unset. If you opt in, use a slower cadence or set `AGENT_NATIVE_DISABLE_KEEP_WARM_BACKGROUND=1` to drop the more expensive background warm.
 
 ### On-demand schema DDL {#skip-ensure-tables}
 
@@ -575,8 +576,9 @@ hosting behavior.
 | `APP_URL`                                   | Optional canonical public origin. Checked ahead of `BETTER_AUTH_URL` when resolving the A2A JWT audience, the OAuth public origin, self-dispatch webhook targets, and generated resource links. Set it explicitly on preview/staging deploys where the request host is unreliable.                                                                                      |
 | `AGENT_PROD_CODE_EXECUTION`                 | Optional production code-execution mode: `off` (default), `sandboxed`, or `trusted`. See [Production Code Execution](#production-code-execution).                                                                                                                                                                                                                       |
 | `AGENT_NATIVE_SSR_CACHE`                    | Deployment-wide SSR shell cache policy: unset/`on` keeps the default hard-cache, `off` sends `no-store`, or a duration such as `30s` / `5m` sets a shorter freshness. See [SSR Caching](#ssr-caching).                                                                                                                                                                  |
-| `AGENT_NATIVE_DISABLE_KEEP_WARM`            | Skip the Netlify keep-warm scheduled function so a scale-to-zero database can autosuspend. See [Keep-warm](#netlify-keep-warm).                                                                                                                                                                                                                                         |
-| `AGENT_NATIVE_KEEP_WARM_SCHEDULE`           | Override the keep-warm cadence with a 5-field cron expression (default `* * * * *`). An unparseable value fails the build. See [Keep-warm](#netlify-keep-warm).                                                                                                                                                                                                         |
+| `AGENT_NATIVE_ENABLE_KEEP_WARM`             | Opt into the Netlify keep-warm scheduled function. Unset by default; see [Keep-warm](#netlify-keep-warm).                                                                                                                                                                                                                                                               |
+| `AGENT_NATIVE_DISABLE_KEEP_WARM`            | Compatibility kill switch for the Netlify keep-warm scheduled function. See [Keep-warm](#netlify-keep-warm).                                                                                                                                                                                                                                                            |
+| `AGENT_NATIVE_KEEP_WARM_SCHEDULE`           | Override the keep-warm cadence with a 5-field cron expression (default `* * * * *` when enabled). An unparseable value fails the build. See [Keep-warm](#netlify-keep-warm).                                                                                                                                                                                            |
 | `AGENT_NATIVE_DISABLE_KEEP_WARM_BACKGROUND` | Drop only the background-function warm and keep the server warm. See [Keep-warm](#netlify-keep-warm).                                                                                                                                                                                                                                                                   |
 | `AGENT_NATIVE_DISABLE_INPROCESS_SWEEPS`     | Turn off the in-process backstop sweep timers (automation redispatch, agent-teams reconciliation, sandbox-execution recovery). On serverless these run per warm container, so their query rate scales with instance count. Set it **only** where a durable scheduler already drives the same recovery, or queued work will not be retried.                              |
 | `AGENT_NATIVE_SKIP_ENSURE_TABLES`           | Skip on-demand schema DDL entirely. Removes the schema-probe round trips every cold start pays before doing any work. Requires that your schema is already migrated — see [On-demand schema DDL](#skip-ensure-tables).                                                                                                                                                  |

package/docs/content/environment-variables.mdx

@@ -50,9 +50,10 @@ deployment-specific values in the environment or scoped secret store.
 | `ACCESS_TOKEN` / `ACCESS_TOKENS`               | Static bearer fallback for MCP and Connect clients.                                                                                                                     | One token or a delimited token list; these are not browser auth.                                               |
 | `AGENT_PROD_CODE_EXECUTION`                    | Production code-execution policy.                                                                                                                                       | `off`, `sandboxed`, or `trusted`. See [Production Code Execution](/docs/deployment#production-code-execution). |
 | `AGENT_NATIVE_SSR_CACHE`                       | Deployment-wide public SSR shell cache policy.                                                                                                                          | Unset/`on`, `off`, or a duration such as `30s` or `5m`. See [SSR Caching](/docs/deployment#ssr-caching).       |
-| `AGENT_NATIVE_DISABLE_KEEP_WARM`               | Lets a scale-to-zero database autosuspend instead of being woken every minute.                                                                                          | `1`; see [Keep-warm](/docs/deployment#netlify-keep-warm).                                                      |
-| `AGENT_NATIVE_KEEP_WARM_SCHEDULE`              | Keep-warm cadence override.                                                                                                                                             | A 5-field cron expression such as `*/5 * * * *`; an unparseable value fails the build.                         |
-| `AGENT_NATIVE_DISABLE_KEEP_WARM_BACKGROUND`    | Drops only the background-function warm and keeps the server warm.                                                                                                      | `1`; see [Keep-warm](/docs/deployment#netlify-keep-warm).                                                      |
+| `AGENT_NATIVE_ENABLE_KEEP_WARM`                | Opts into the Netlify keep-warm scheduled function; unset by default.                                                                                                   | `1`; see [Keep-warm](/docs/deployment#netlify-keep-warm).                                                      |
+| `AGENT_NATIVE_DISABLE_KEEP_WARM`               | Compatibility kill switch for the Netlify keep-warm scheduled function.                                                                                                 | `1`; see [Keep-warm](/docs/deployment#netlify-keep-warm).                                                      |
+| `AGENT_NATIVE_KEEP_WARM_SCHEDULE`              | Keep-warm cadence override when enabled.                                                                                                                                | A 5-field cron expression such as `*/5 * * * *`; an unparseable value fails the build.                         |
+| `AGENT_NATIVE_DISABLE_KEEP_WARM_BACKGROUND`    | Drops only the background-function warm and keeps the server warm when keep-warm is enabled.                                                                            | `1`; see [Keep-warm](/docs/deployment#netlify-keep-warm).                                                      |
 | `AGENT_NATIVE_DISABLE_INPROCESS_SWEEPS`        | Turns off the in-process backstop sweep timers where a durable scheduler drives the same work.                                                                          | `1`; queued work is not retried without another driver.                                                        |
 | `AGENT_NATIVE_SKIP_ENSURE_TABLES`              | Skips on-demand schema DDL for an already-migrated database.                                                                                                            | `1`; see [On-demand schema DDL](/docs/deployment#skip-ensure-tables). You own migrations when this is set.     |
 | `COOKIE_DOMAIN`                                | Shares auth cookies across same-database subdomains when explicitly configured.                                                                                         | A cookie domain.                                                                                               |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.148.1",
+  "version": "0.149.0",
   "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": {
@@ -414,7 +414,7 @@
     "yjs": "^13.6.31",
     "zod": "^4.3.6",
     "@agent-native/recap-cli": "0.5.4",
-    "@agent-native/toolkit": "^0.13.7"
+    "@agent-native/toolkit": "^0.13.8"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",

package/src/templates/default/app/i18n/ar-SA.ts

@@ -232,7 +232,7 @@ const messages = {
     newTerminal: "محطة جديدة",
     panelOptions: "خيارات لوحة الوكيل",
     collapseSidebar: "طي الشريط الجانبي",
-    widenChat: "توسيع الدردشة إلى 75٪",
+    widenChat: "توسيع الدردشة",
     returnChatToLayout: "إعادة الدردشة إلى تخطيط الصفحة",
     hideChats: "إخفاء الدردشات",
     allChats: "جميع الدردشات",

package/src/templates/default/app/i18n/de-DE.ts

@@ -234,7 +234,7 @@ const messages = {
     newTerminal: "Neues Terminal",
     panelOptions: "Optionen im Agentenpanel",
     collapseSidebar: "Seitenleiste einklappen",
-    widenChat: "Chat auf 75 % verbreitern",
+    widenChat: "Chat verbreitern",
     returnChatToLayout: "Chat zurück ins Layout",
     hideChats: "Chats ausblenden",
     allChats: "Alle Chats",

package/src/templates/default/app/i18n/en-US.ts

@@ -229,7 +229,7 @@ const messages = {
     newTerminal: "New terminal",
     panelOptions: "Agent panel options",
     collapseSidebar: "Collapse sidebar",
-    widenChat: "Widen chat to 75%",
+    widenChat: "Widen chat",
     returnChatToLayout: "Return chat to layout",
     hideChats: "Hide chats",
     allChats: "All chats",

package/src/templates/default/app/i18n/es-ES.ts

@@ -235,7 +235,7 @@ const messages = {
     newTerminal: "Nueva terminal",
     panelOptions: "Opciones del panel de agentes",
     collapseSidebar: "Contraer barra lateral",
-    widenChat: "Ampliar el chat al 75 %",
+    widenChat: "Ampliar el chat",
     returnChatToLayout: "Devolver el chat al diseño",
     hideChats: "Ocultar chats",
     allChats: "Todos los chats",

package/src/templates/default/app/i18n/fr-FR.ts

@@ -236,7 +236,7 @@ const messages = {
     newTerminal: "Nouvelle borne",
     panelOptions: "Options du panneau d'agent",
     collapseSidebar: "Réduire la barre latérale",
-    widenChat: "Élargir le chat à 75 %",
+    widenChat: "Élargir le chat",
     returnChatToLayout: "Remettre le chat dans la mise en page",
     hideChats: "Masquer les discussions",
     allChats: "Toutes les discussions",

package/src/templates/default/app/i18n/hi-IN.ts

@@ -221,7 +221,7 @@ const messages = {
     newTerminal: "नया टर्मिनल",
     panelOptions: "एजेंट पैनल विकल्प",
     collapseSidebar: "साइडबार समेटें",
-    widenChat: "चैट को 75% चौड़ा करें",
+    widenChat: "चैट को चौड़ा करें",
     returnChatToLayout: "चैट को लेआउट में वापस लाएँ",
     hideChats: "चैट छुपाएं",
     allChats: "सभी चैट",

package/src/templates/default/app/i18n/ja-JP.ts

@@ -230,7 +230,7 @@ const messages = {
     newTerminal: "新しいターミナル",
     panelOptions: "エージェントパネルのオプション",
     collapseSidebar: "サイドバーを折りたたむ",
-    widenChat: "チャットを75%に広げる",
+    widenChat: "チャットを広げる",
     returnChatToLayout: "チャットをレイアウトに戻す",
     hideChats: "チャットを非表示にする",
     allChats: "すべてのチャット",

package/src/templates/default/app/i18n/ko-KR.ts

@@ -225,7 +225,7 @@ const messages = {
     newTerminal: "새로운 터미널",
     panelOptions: "상담원 패널 옵션",
     collapseSidebar: "사이드바 접기",
-    widenChat: "채팅을 75% 너비로 넓히기",
+    widenChat: "채팅 넓히기",
     returnChatToLayout: "채팅을 레이아웃으로 되돌리기",
     hideChats: "채팅 숨기기",
     allChats: "모든 채팅",

package/src/templates/default/app/i18n/pt-BR.ts

@@ -234,7 +234,7 @@ const messages = {
     newTerminal: "Novo terminal",
     panelOptions: "Opções do painel do agente",
     collapseSidebar: "Recolher barra lateral",
-    widenChat: "Ampliar o chat para 75%",
+    widenChat: "Ampliar o chat",
     returnChatToLayout: "Retornar o chat ao layout",
     hideChats: "Ocultar bate-papos",
     allChats: "Todos os bate-papos",

package/src/templates/default/app/i18n/zh-CN.ts

@@ -219,7 +219,7 @@ const messages = {
     newTerminal: "新航站楼",
     panelOptions: "代理面板选项",
     collapseSidebar: "收起侧边栏",
-    widenChat: "将聊天窗口加宽到 75%",
+    widenChat: "加宽聊天窗口",
     returnChatToLayout: "将聊天窗口恢复到布局中",
     hideChats: "隐藏聊天记录",
     allChats: "所有聊天记录",

package/src/templates/default/app/i18n/zh-TW.ts

@@ -217,7 +217,7 @@ const messages = {
     newTerminal: "新航站樓",
     panelOptions: "代理面板選項",
     collapseSidebar: "收起側邊欄",
-    widenChat: "將聊天視窗加寬至 75%",
+    widenChat: "將聊天視窗加寬",
     returnChatToLayout: "將聊天視窗放回版面配置",
     hideChats: "隱藏聊天紀錄",
     allChats: "所有聊天紀錄",

package/src/templates/default/pnpm-workspace.yaml

@@ -6,3 +6,4 @@ overrides:
 allowBuilds:
   better-sqlite3: true
   esbuild: true
+  tesseract.js: true

package/src/templates/workspace-root/pnpm-workspace.yaml

@@ -24,6 +24,7 @@ onlyBuiltDependencies:
   - esbuild
   - lightningcss
   - node-pty
+  - tesseract.js
 
 allowBuilds:
   "@swc/core": true
@@ -33,3 +34,4 @@ allowBuilds:
   esbuild: true
   lightningcss: true
   node-pty: true
+  tesseract.js: true