@agent-native/core 0.88.0 → 0.90.1

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

@@ -284,7 +284,6 @@ const messages = {
       'Create a new widget that fits in slot "{{slotId}}". I\'ll describe what it should do next.',
     whatShouldItDo: "इसे क्या करना चाहिए?",
     createPlaceholder: "एक कार्य सूची, एपीआई डैशबोर्ड, कैलकुलेटर...",
-    backToApp: "ऐप पर वापस जाएं",
     title: "एक्सटेंशन",
     hiddenShown: "छिपाव दिखाया गया",
     showHidden: "छिपे हुए दिखाएं",

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

@@ -287,7 +287,6 @@ const messages = {
       'Create a new widget that fits in slot "{{slotId}}". I\'ll describe what it should do next.',
     whatShouldItDo: "それは何をすべきでしょうか？",
     createPlaceholder: "ToDo リスト、API ダッシュボード、電卓...",
-    backToApp: "アプリに戻る",
     title: "拡張機能",
     hiddenShown: "非表示を表示",
     showHidden: "非表示を表示",

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

@@ -283,7 +283,6 @@ const messages = {
       'Create a new widget that fits in slot "{{slotId}}". I\'ll describe what it should do next.',
     whatShouldItDo: "무엇을 해야 합니까?",
     createPlaceholder: "할 일 목록, API 대시보드, 계산기...",
-    backToApp: "앱으로 돌아가기",
     title: "확장",
     hiddenShown: "숨김 표시됨",
     showHidden: "숨김 항목 표시",

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

@@ -298,7 +298,6 @@ const messages = {
       'Create a new widget that fits in slot "{{slotId}}". I\'ll describe what it should do next.',
     whatShouldItDo: "O que deveria fazer?",
     createPlaceholder: "Uma lista de tarefas, painel de API, calculadora...",
-    backToApp: "Voltar ao aplicativo",
     title: "Extensões",
     hiddenShown: "Ocultando mostrado",
     showHidden: "Mostrar ocultos",

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

@@ -276,7 +276,6 @@ const messages = {
       'Create a new widget that fits in slot "{{slotId}}". I\'ll describe what it should do next.',
     whatShouldItDo: "它应该做什么？",
     createPlaceholder: "待办事项列表、API 仪表板、计算器...",
-    backToApp: "返回应用程序",
     title: "扩展",
     hiddenShown: "显示隐藏",
     showHidden: "显示隐藏项",

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

@@ -276,7 +276,6 @@ const messages = {
       "建立一個適合「{{slotId}}」插槽的新小工具。我接著會描述它應該做什麼。",
     whatShouldItDo: "它應該做什麼？",
     createPlaceholder: "待辦事項清單、API 儀表板、計算器...",
-    backToApp: "返回應用程式",
     title: "擴充功能",
     hiddenShown: "顯示隱藏",
     showHidden: "顯示隱藏項",

package/dist/templates/default/app/routes/settings.tsx

@@ -1,6 +1,7 @@
 import {
   LanguagePicker,
-  openAgentSettings,
+  SettingsTabsPage,
+  useAgentSettingsTabs,
   useT,
 } from "@agent-native/core/client";
 import { Link } from "react-router";
@@ -11,10 +12,11 @@ export function meta() {
 
 export default function SettingsPage() {
   const t = useT();
+  const agentSettingsTabs = useAgentSettingsTabs();
 
   return (
     <main className="min-h-screen bg-background px-6 py-10">
-      <div className="mx-auto w-full max-w-2xl space-y-6">
+      <div className="mx-auto w-full max-w-5xl space-y-6">
         <div className="space-y-2">
           <Link
             to="/"
@@ -30,37 +32,24 @@ export default function SettingsPage() {
           </p>
         </div>
 
-        <section className="rounded-lg border border-border/50 bg-card px-4 py-4">
-          <div className="space-y-1">
-            <h2 className="text-[15px] font-semibold text-foreground">
-              {t("settings.languageTitle")}
-            </h2>
-            <p className="text-[13px] leading-relaxed text-muted-foreground">
-              {t("settings.languageDescription")}
-            </p>
-          </div>
-          <div className="mt-4 max-w-xs">
-            <LanguagePicker label={t("settings.languageLabel")} />
-          </div>
-        </section>
-
-        <section className="rounded-lg border border-border/50 bg-card px-4 py-4">
-          <div className="space-y-1">
-            <h2 className="text-[15px] font-semibold text-foreground">
-              {t("settings.agentTitle")}
-            </h2>
-            <p className="text-[13px] leading-relaxed text-muted-foreground">
-              {t("settings.agentDescription")}
-            </p>
-          </div>
-          <button
-            type="button"
-            className="mt-4 rounded-md border border-border bg-background px-3 py-2 text-[13px] font-medium text-foreground transition-colors hover:bg-accent/50"
-            onClick={() => openAgentSettings()}
-          >
-            {t("settings.openAgentSettings")}
-          </button>
-        </section>
+        <SettingsTabsPage
+          extraTabs={agentSettingsTabs}
+          general={
+            <section className="mx-auto w-full max-w-2xl rounded-lg border border-border/50 bg-card px-4 py-4">
+              <div className="space-y-1">
+                <h2 className="text-[15px] font-semibold text-foreground">
+                  {t("settings.languageTitle")}
+                </h2>
+                <p className="text-[13px] leading-relaxed text-muted-foreground">
+                  {t("settings.languageDescription")}
+                </p>
+              </div>
+              <div className="mt-4 max-w-xs">
+                <LanguagePicker label={t("settings.languageLabel")} />
+              </div>
+            </section>
+          }
+        />
       </div>
     </main>
   );

package/dist/templates/headless/.agents/skills/agent-native-docs/SKILL.md

@@ -1,9 +1,11 @@
 ---
 name: agent-native-docs
 description: >-
-  How to find version-matched Agent Native framework docs bundled in
+  How to find version-matched Agent Native framework docs and source bundled in
   node_modules. Use before implementing or answering questions about
-  @agent-native/core APIs, generated apps, workspaces, or advanced features.
+  @agent-native/core APIs, generated apps, workspaces, templates, or advanced
+  features.
+scope: dev
 metadata:
   internal: true
 ---
@@ -13,13 +15,17 @@ metadata:
 ## Rule
 
 Before implementing or explaining non-trivial Agent Native behavior, read the
-version-matched docs installed with `@agent-native/core`.
+version-matched docs installed with `@agent-native/core`. When examples,
+imports, or implementation details matter, inspect the packaged source corpus
+too.
 
 ## Why
 
 Generated apps and workspaces may be on a different framework version than the
 public docs or model memory. The installed package is the source that matches
-the app in front of you.
+the app in front of you. It also includes a source-only corpus of core and
+first-party templates so agents can replicate current best-practice patterns
+without needing the framework monorepo checkout.
 
 ## How
 
@@ -29,19 +35,26 @@ From a generated app directory:
 pnpm action docs-search --query "<feature>"
 pnpm action docs-search --slug <slug>
 pnpm action docs-search --list
+pnpm action source-search --query "<pattern>"
+pnpm action source-search --path templates/plan/AGENTS.md
+pnpm action source-search --list
 ```
 
 The headless `pnpm agent` loop and built-in app agent also expose a read-only
-`docs-search` tool with the same `query`, `slug`, and `list` options.
+`docs-search` tool with the same `query`, `slug`, and `list` options, plus a
+read-only `source-search` tool with `query`, `path`, and `list`.
 
-If the action runner is unavailable, search the package docs directly:
+If the action runner is unavailable, search the package directly:
 
 ```bash
 rg -n "actions|automations|a2a|sharing" node_modules/@agent-native/core/docs
+rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 ```
 
 Then read `node_modules/@agent-native/core/docs/AGENTS.md` or the matching file
-under `node_modules/@agent-native/core/docs/content/`.
+under `node_modules/@agent-native/core/docs/content/`. For source examples,
+read files under `node_modules/@agent-native/core/corpus/core/` or
+`node_modules/@agent-native/core/corpus/templates/`.
 
 ## Useful Slugs
 

package/dist/templates/headless/AGENTS.md

@@ -45,12 +45,15 @@ root to refresh framework-provided `.agents/skills` and repair `CLAUDE.md` /
 
 ## Actions
 
-| Action      | Args              | Purpose                 |
-| ----------- | ----------------- | ----------------------- |
-| `hello`     | `[--name <name>]` | Return a greeting       |
-| `db-schema` |                   | Show SQL schema         |
-| `db-query`  | `--sql "SELECT"`  | Run a scoped SELECT     |
-| `db-exec`   | `--sql "UPDATE"`  | Last-resort maintenance |
+| Action      | Args              | Purpose             |
+| ----------- | ----------------- | ------------------- |
+| `hello`     | `[--name <name>]` | Return a greeting   |
+| `db-schema` |                   | Show SQL schema     |
+| `db-query`  | `--sql "SELECT"`  | Run a scoped SELECT |
+
+Raw SQL writes are not exposed by default. Add or update a typed action for app
+data writes; opt into `databaseTools: "write"` only for deliberate maintenance
+surfaces.
 
 Run actions from this app root:
 

package/dist/templates/workspace-core/.agents/skills/actions/SKILL.md

@@ -161,6 +161,18 @@ to find likely URLs, `web-request` or `provider-api-docs` with clean
 `webFetch()` when you need to grep, aggregate, or compare many pages before
 returning a small result.
 
+For LONG compute, `run-code` supports durable background executions: pass
+`background: true` and the code is enqueued to a `sandbox_executions` row and
+executed out-of-band with a generous budget (default 10 min), surviving the
+hosted agent run's ~40s soft timeout. The call returns
+`{ executionId, status: "queued" }` immediately with polling guidance; check
+progress with `run-code` `{ executionId }` (or the `get-code-execution` tool
+where registered) — results persist after completion. Use background for big
+cross-source joins, multi-page provider sweeps, and heavy analysis scripts;
+keep quick scripts in the default foreground mode. Agents should continue
+other work between polls, and on `failed`/`timed_out` split the computation or
+persist intermediate progress with `workspaceWrite` and re-run.
+
 ### The `http` Option
 
 Controls how the action is exposed as an HTTP endpoint:
@@ -205,6 +217,49 @@ run: async (args) => {
 }
 ```
 
+### Returning Images the Agent Can See (`_agentImages`)
+
+An action's return object may include the well-known optional field
+`_agentImages` to attach vision images (screenshots, chart previews, rendered
+designs) to the tool result. The agent literally sees them — enabling visual
+self-review loops — while the field itself is stripped from the JSON text the
+model reads.
+
+```ts
+run: async ({ dashboardId }) => {
+  const shot = await renderDashboardPng(dashboardId); // Buffer
+  return {
+    dashboardId,
+    panelCount: 6,
+    _agentImages: [
+      // Either a public https URL (preferred — the provider fetches it)…
+      { url: "https://cdn.example.com/previews/dash-1.png", label: "overview" },
+      // …or base64 without a data: prefix (mediaType required; a full
+      // data:image/png;base64,… URL in `data` is also accepted and parsed).
+      { data: shot.toString("base64"), mediaType: "image/png" },
+    ],
+  };
+},
+```
+
+Rules and limits:
+
+- Shape: `Array<{ url?: string; data?: string; mediaType?: string; label?: string }>`.
+  Each entry needs `url` (https only) **or** `data`. Supported media types:
+  `image/jpeg`, `image/png`, `image/gif`, `image/webp`.
+- Caps: max **4 images** per result; max **~2MB of base64** per image.
+  Over-cap or invalid entries never fail the call — they become text notes in
+  the result telling the model what was dropped and why.
+- Persistence: the run ledger stores only the string result plus compact
+  `[image: …]` notes (URLs verbatim; base64 as a byte-count placeholder) —
+  never the payload. Images are re-attached only for the live turn; replayed
+  history is text-only, so prefer stable `url` images the model can re-request.
+- Engine support: native Anthropic and vision-capable AI-SDK providers
+  (anthropic, openai, google, openrouter) receive real image blocks; other
+  paths (Builder gateway, non-vision providers) degrade to the text notes.
+- External MCP tools need no changes — standard MCP `image` content parts are
+  converted automatically under the same caps.
+
 ### Validating Return Values (`outputSchema`)
 
 `schema` validates inputs; `outputSchema` validates what the action **returns**. Pass any Standard Schema-compatible schema (Zod, Valibot, ArkType) and the framework validates the result _after_ `run()` resolves — input validated before `run`, output after.

package/dist/templates/workspace-core/.agents/skills/data-programs/SKILL.md

@@ -0,0 +1,128 @@
+---
+name: data-programs
+description: >-
+  Save a run-code fetch/join/aggregate script as a stored, refreshable data
+  source any app's own charts/tables can render, instead of a hardcoded
+  provider action or a per-view re-fetch. Use when an ad-hoc run-code or
+  provider-api-request analysis should become a live, cached data source other
+  users or panels can reuse.
+---
+
+# Data Programs
+
+A **data program** is a named, stored, agent-authored JS script that fetches,
+joins, filters, or aggregates data — provider APIs via `providerFetch` /
+`providerFetchAll` / `providerSearchAll`, app data via `appAction`, or
+Resources-backed workspace files — and emits a small `{ rows, schema }`
+result that gets cached in SQL. Any app can render that result through its
+own table/chart components; nothing about the primitive is analytics-specific.
+
+This ships automatically wherever `run-code` is available — there is nothing
+to mount, wire, or configure per app. If your app already has run-code
+enabled, `save-data-program` / `preview-data-program` / `run-data-program` /
+`list-data-programs` / `get-data-program` / `delete-data-program` are already
+registered actions.
+
+## Why this exists
+
+Without it, "build a live view of X" tends to end in one of two bad places:
+a hardcoded action per vendor/query shape (brittle, doesn't scale to every
+customer's custom fields), or re-running the same fetch/join logic from
+scratch on every page view (slow, and it re-spends the same provider quota
+every time someone looks at a chart). A data program is the middle ground:
+write the fetch/join/aggregate logic once as ordinary `run-code`, save it, and
+let the cache + refresh policy handle "how often does this actually need to
+re-run."
+
+## Authoring workflow
+
+1. Prototype the fetch/join/aggregate logic as a normal `run-code` script and
+   confirm it returns the rows you expect.
+2. Change it to call `emit(rows, schema?)` exactly once at the end instead of
+   returning or printing the result.
+3. Save it with `save-data-program({ name, title, description, code,
+   defaultParams?, refreshMode?, refreshTtlMs?, background? })`. This
+   **dry-runs the code with `defaultParams` before persisting** and rejects
+   the save with a structured error if it fails, so a broken program is never
+   stored. On success it returns `{ programId, rowCount, columns,
+   sampleRows }` — use that as proof the program produces the rows you
+   expect.
+4. Bind whatever UI needs the result. Your app's own read path calls
+   `run-data-program({ programId, params?, forceRefresh?, includeRows? })`
+   and gets back rows/schema/cache metadata to hand to your own table/chart
+   components — there is no dashboard-specific plumbing baked into the
+   primitive itself. (The analytics template's `"program"` dashboard panel
+   source is one such adoption, not a required pattern — see its
+   `data-programs` skill if you want a concrete UI wiring reference.)
+5. Iterate without persisting via `preview-data-program({ code, params? })` —
+   same dry-run path, no stored row.
+
+## The sandbox surface
+
+Exactly the `run-code` globals (`providerFetch`, `providerFetchAll`,
+`providerSearchAll`, `appAction`, `webFetch`, `workspace*` Resources helpers),
+plus:
+
+- `params` — a **frozen** global object holding the params for this run.
+  Read-only; mutating it throws.
+- `emit(rows, schema?)` — call exactly once, at the end. `rows` must be an
+  array of plain objects. `schema`, when provided, is
+  `{ name: string, type: string }[]`; when omitted it's inferred from the
+  first 50 rows (a column is `"json"` if rows disagree on primitive type,
+  otherwise `"number"` / `"string"` / `"boolean"`). `console.log` remains free
+  for debugging and never interferes with parsing the emitted result.
+
+Caps enforced on every run:
+
+| Limit | Value |
+| --- | --- |
+| Max emitted rows | 10,000 (excess dropped, `truncated: true`) |
+| Max emitted result size | 4 MiB (rows dropped from the end to fit; a single oversized row is a hard failure) |
+| Max active programs per app | 200 |
+| Minimum refresh TTL | 60,000 ms |
+| Run rows kept per (program, params) | 5 most recent |
+
+Truncation is always explicit (`truncated: true`) — never a silent drop.
+
+## Caching and refresh model
+
+Every `(programId, paramsHash)` pair has its own run history:
+
+| Situation | Behavior |
+| --- | --- |
+| Fresh cache (younger than `refreshTtlMs`, or `refreshMode: "manual"` with a prior success) | Returns cached rows instantly, `cacheHit: true` |
+| Stale cache | Re-executes synchronously (25s budget for view-triggered reads, 120s for agent/manual calls), replacing the cache on success |
+| `refreshMode: "manual"` | Only refreshes on explicit `forceRefresh: true` |
+| No cache yet | Executes synchronously like a normal first fetch |
+| `background: true` program with no fresh cache | Serves the last good run with `stale: true` and enqueues a durable background execution; a later call finalizes it once complete |
+| Background program still running, no prior success | `background_pending` failure — surface an explicit "still computing" state, never a blank result |
+| Execution fails | Structured `{ code, message }` failure; a previous success is attached as `lastGoodRun` for stale-serve |
+| Program archived (soft-deleted) | Explicit `archived` failure |
+
+Use `background: true` only for scripts that routinely exceed the foreground
+timeout (large multi-provider joins, deep pagination). Everything else should
+stay foreground.
+
+## Security notes
+
+- **Credentials are always the calling viewer's, never the program author's.**
+  `providerFetch` inside a program resolves auth using the caller's own
+  request context. A viewer without a configured provider key sees that
+  provider's normal auth error on that program's result — never another
+  user's data.
+- **Programs are shareable org-internal only — never public.** Sharing a
+  program means teammates can view its cached result; because execution uses
+  the *viewer's* credentials, only bind to or view a program you trust.
+- Raw provider tokens never reach the model or the browser. Only the
+  `{ rows, schema }` an `emit()` call produces ever leaves the sandbox.
+- The mutating/executing actions (`save-data-program`, `preview-data-program`,
+  `run-data-program`, `delete-data-program`) are not callable from a
+  sandboxed extension/iframe bridge — only from the agent or a server-side
+  read path.
+
+## Related skills
+
+- `actions` for `run-code` conventions and the sandbox globals this primitive
+  is built on.
+- `sharing` for the org-internal, never-public sharing model programs use.
+- `security` for credential-handling and access-scoping invariants.

package/dist/templates/workspace-core/.agents/skills/harness-agents/SKILL.md

@@ -132,10 +132,16 @@ const custom = resolveAgentHarness("acp", {
   (`packages/core/src/coding-tools/sandbox/`). The default
   `LocalChildProcessAdapter` spawns a locked-down local Node child process;
   swap it via `AGENT_NATIVE_SANDBOX` or `registerSandboxAdapter()` for a
-  Docker/remote/durable backend (the lever to exceed the hosted ~40s code-exec
-  ceiling). An adapter only runs the already-prepared, non-secret module source
-  — it never sees app secrets. See the Sandbox Adapters doc; `agent-native add
-  sandbox docker` emits a full Docker-adapter recipe.
+  Docker/remote backend. An adapter only runs the already-prepared, non-secret
+  module source — it never sees app secrets. See the Sandbox Adapters doc;
+  `agent-native add sandbox docker` emits a full Docker-adapter recipe.
+- Long compute exceeds the hosted ~40s run ceiling via the built-in durable
+  background backend: per-call `background: true` on `run-code` (or
+  `AGENT_NATIVE_SANDBOX=background` to queue every call) enqueues to the
+  `sandbox_executions` table and executes out-of-band — self-dispatched to
+  `/_agent-native/sandbox/_process-execution` on serverless, in-process on
+  long-lived Node — with lease-based claiming, retries, and owner-scoped
+  polling via `run-code {executionId}` / `get-code-execution`.
 
 ## Sub-Agent Delegation Depth
 

package/dist/vite/agents-bundle-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-bundle-plugin.d.ts","sourceRoot":"","sources":["../../src/vite/agents-bundle-plugin.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA6CnC,wBAAgB,kBAAkB,IAAI,MAAM,CAiG3C"}
+{"version":3,"file":"agents-bundle-plugin.d.ts","sourceRoot":"","sources":["../../src/vite/agents-bundle-plugin.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAyDnC,wBAAgB,kBAAkB,IAAI,MAAM,CA8G3C"}

package/dist/vite/agents-bundle-plugin.js

@@ -22,6 +22,17 @@ const TEMPLATE_SKILLS_DIRS = [
     path.join(".agents", "skills"),
     path.join(".agent", "skills"),
 ];
+/**
+ * Coalesce window for the dev-server full-reload sent after AGENTS.md /
+ * SKILL.md changes. Agents (and Fusion editing sessions) frequently write
+ * several skill files back-to-back, and editor atomic saves surface as
+ * unlink+add pairs — without coalescing, every one of those watcher events
+ * triggered its own full page reload, which reads as the app "constantly
+ * refreshing" while an agent works. Module invalidation still happens per
+ * event (it's cheap and keeps the next request fresh); only the browser
+ * reload is batched.
+ */
+const FULL_RELOAD_COALESCE_MS = 500;
 async function emitBundleModule(projectRoot) {
     // If the project is inside an enterprise monorepo with a workspace core,
     // merge in its AGENTS.md + skills. Template skills override workspace
@@ -113,13 +124,27 @@ export function agentsBundlePlugin() {
                 }
                 return false;
             };
+            let reloadTimer = null;
+            const scheduleFullReload = () => {
+                if (reloadTimer)
+                    clearTimeout(reloadTimer);
+                reloadTimer = setTimeout(() => {
+                    reloadTimer = null;
+                    server.ws.send({ type: "full-reload" });
+                }, FULL_RELOAD_COALESCE_MS);
+            };
+            server.httpServer?.once("close", () => {
+                if (reloadTimer)
+                    clearTimeout(reloadTimer);
+                reloadTimer = null;
+            });
             const invalidate = (file) => {
                 if (!shouldInvalidate(file))
                     return;
                 const mod = server.moduleGraph.getModuleById(RESOLVED_ID);
                 if (mod) {
                     server.moduleGraph.invalidateModule(mod);
-                    server.ws.send({ type: "full-reload" });
+                    scheduleFullReload();
                 }
             };
             // Explicitly add template + workspace-core paths to the watcher so

package/dist/vite/agents-bundle-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-bundle-plugin.js","sourceRoot":"","sources":["../../src/vite/agents-bundle-plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"fs\";\n/**\n * Vite plugin that resolves `virtual:agents-bundle` to a statically-inlined\n * ES module containing the template's AGENTS.md + .agents/skills/ content.\n * The legacy singular .agent/skills/ directory is also watched as an alias.\n *\n * This is how the framework's agent gets its instructions and skills into the\n * system prompt on EVERY deployment target — Node, Netlify Functions, Vercel\n * serverless, and Cloudflare Workers. The content is baked into the server\n * bundle at build time, so nothing needs to exist on the runtime filesystem.\n *\n * In dev mode, the plugin re-reads from disk on each import and triggers HMR\n * when any AGENTS.md or SKILL.md file changes, so edits show up instantly\n * without restarting the server.\n */\nimport path from \"path\";\n\nimport type { Plugin } from \"vite\";\n\nimport { getWorkspaceCoreExports } from \"../deploy/workspace-core.js\";\nimport {\n  readAgentsBundleFromFs,\n  type WorkspaceAgentsSource,\n} from \"../server/agents-bundle.js\";\n\nconst VIRTUAL_ID = \"virtual:agents-bundle\";\nconst RESOLVED_ID = \"\\0\" + VIRTUAL_ID;\nconst TEMPLATE_SKILLS_DIRS = [\n  path.join(\".agents\", \"skills\"),\n  path.join(\".agent\", \"skills\"),\n] as const;\n\nasync function emitBundleModule(projectRoot: string): Promise<string> {\n  // If the project is inside an enterprise monorepo with a workspace core,\n  // merge in its AGENTS.md + skills. Template skills override workspace\n  // core skills on name collision.\n  let workspaceSource: WorkspaceAgentsSource | null = null;\n  try {\n    const ws = await getWorkspaceCoreExports(projectRoot);\n    if (ws) {\n      workspaceSource = {\n        skillsDir: ws.skillsDir,\n        agentsMdPath: ws.agentsMdPath,\n        rootDir: ws.packageDir,\n      };\n    }\n  } catch {\n    // fall back to template-only\n  }\n\n  const bundle = readAgentsBundleFromFs(projectRoot, workspaceSource);\n  // Serialize as JSON and wrap in `export default` — this produces a valid\n  // ES module that any bundler (Rollup, esbuild, Rolldown) can statically\n  // analyze and tree-shake if nothing imports it.\n  return `// AUTO-GENERATED by @agent-native/core/vite/agents-bundle-plugin\n// Contains the inlined AGENTS.md + .agents/skills/ content from the template,\n// merged with any workspace AGENTS.md + .agents/skills/ when present.\nconst bundle = ${JSON.stringify(bundle)};\nexport default bundle;\n`;\n}\n\nexport function agentsBundlePlugin(): Plugin {\n  let projectRoot = \"\";\n\n  return {\n    name: \"agent-native-agents-bundle\",\n\n    configResolved(config) {\n      projectRoot = config.root;\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_ID) return RESOLVED_ID;\n      return null;\n    },\n\n    async load(id) {\n      if (id !== RESOLVED_ID) return null;\n      if (!projectRoot) projectRoot = process.cwd();\n      return await emitBundleModule(projectRoot);\n    },\n\n    async configureServer(server) {\n      // Watch AGENTS.md + any SKILL.md changes and invalidate the virtual\n      // module so the next request picks up fresh content. Also watches\n      // the workspace core's AGENTS.md + skills directory (if present)\n      // so edits to the enterprise mid-layer propagate to every app.\n      const watcher = server.watcher;\n\n      // Resolve the workspace core up front so we can tell which files\n      // outside projectRoot should trigger invalidation.\n      let workspaceAgentsMdPath: string | null = null;\n      let workspaceSkillsDir: string | null = null;\n      try {\n        const ws = await getWorkspaceCoreExports(projectRoot);\n        if (ws) {\n          workspaceAgentsMdPath = ws.agentsMdPath;\n          workspaceSkillsDir = ws.skillsDir;\n        }\n      } catch {\n        // ignore\n      }\n\n      const shouldInvalidate = (file: string): boolean => {\n        const rel = path.relative(projectRoot, file);\n        if (!rel.startsWith(\"..\")) {\n          if (rel === \"AGENTS.md\") return true;\n          if (rel.endsWith(\"SKILL.md\")) {\n            for (const skillsDir of TEMPLATE_SKILLS_DIRS) {\n              if (rel.startsWith(skillsDir + path.sep)) return true;\n            }\n          }\n        }\n        // Workspace-core files\n        if (workspaceAgentsMdPath && file === workspaceAgentsMdPath) {\n          return true;\n        }\n        if (\n          workspaceSkillsDir &&\n          file.startsWith(workspaceSkillsDir + path.sep) &&\n          file.endsWith(\"SKILL.md\")\n        ) {\n          return true;\n        }\n        return false;\n      };\n\n      const invalidate = (file: string) => {\n        if (!shouldInvalidate(file)) return;\n        const mod = server.moduleGraph.getModuleById(RESOLVED_ID);\n        if (mod) {\n          server.moduleGraph.invalidateModule(mod);\n          server.ws.send({ type: \"full-reload\" });\n        }\n      };\n\n      // Explicitly add template + workspace-core paths to the watcher so\n      // edits outside the normal Vite watch set still trigger invalidation.\n      const agentsMdPath = path.join(projectRoot, \"AGENTS.md\");\n      const skillsDirs = TEMPLATE_SKILLS_DIRS.map((rel) =>\n        path.join(projectRoot, rel),\n      );\n      if (fs.existsSync(agentsMdPath)) watcher.add(agentsMdPath);\n      for (const skillsDir of skillsDirs) {\n        if (fs.existsSync(skillsDir)) watcher.add(skillsDir);\n      }\n      if (workspaceAgentsMdPath && fs.existsSync(workspaceAgentsMdPath)) {\n        watcher.add(workspaceAgentsMdPath);\n      }\n      if (workspaceSkillsDir && fs.existsSync(workspaceSkillsDir)) {\n        watcher.add(workspaceSkillsDir);\n      }\n\n      watcher.on(\"change\", invalidate);\n      watcher.on(\"add\", invalidate);\n      watcher.on(\"unlink\", invalidate);\n    },\n  };\n}\n"]}
+{"version":3,"file":"agents-bundle-plugin.js","sourceRoot":"","sources":["../../src/vite/agents-bundle-plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"fs\";\n/**\n * Vite plugin that resolves `virtual:agents-bundle` to a statically-inlined\n * ES module containing the template's AGENTS.md + .agents/skills/ content.\n * The legacy singular .agent/skills/ directory is also watched as an alias.\n *\n * This is how the framework's agent gets its instructions and skills into the\n * system prompt on EVERY deployment target — Node, Netlify Functions, Vercel\n * serverless, and Cloudflare Workers. The content is baked into the server\n * bundle at build time, so nothing needs to exist on the runtime filesystem.\n *\n * In dev mode, the plugin re-reads from disk on each import and triggers HMR\n * when any AGENTS.md or SKILL.md file changes, so edits show up instantly\n * without restarting the server.\n */\nimport path from \"path\";\n\nimport type { Plugin } from \"vite\";\n\nimport { getWorkspaceCoreExports } from \"../deploy/workspace-core.js\";\nimport {\n  readAgentsBundleFromFs,\n  type WorkspaceAgentsSource,\n} from \"../server/agents-bundle.js\";\n\nconst VIRTUAL_ID = \"virtual:agents-bundle\";\nconst RESOLVED_ID = \"\\0\" + VIRTUAL_ID;\nconst TEMPLATE_SKILLS_DIRS = [\n  path.join(\".agents\", \"skills\"),\n  path.join(\".agent\", \"skills\"),\n] as const;\n\n/**\n * Coalesce window for the dev-server full-reload sent after AGENTS.md /\n * SKILL.md changes. Agents (and Fusion editing sessions) frequently write\n * several skill files back-to-back, and editor atomic saves surface as\n * unlink+add pairs — without coalescing, every one of those watcher events\n * triggered its own full page reload, which reads as the app \"constantly\n * refreshing\" while an agent works. Module invalidation still happens per\n * event (it's cheap and keeps the next request fresh); only the browser\n * reload is batched.\n */\nconst FULL_RELOAD_COALESCE_MS = 500;\n\nasync function emitBundleModule(projectRoot: string): Promise<string> {\n  // If the project is inside an enterprise monorepo with a workspace core,\n  // merge in its AGENTS.md + skills. Template skills override workspace\n  // core skills on name collision.\n  let workspaceSource: WorkspaceAgentsSource | null = null;\n  try {\n    const ws = await getWorkspaceCoreExports(projectRoot);\n    if (ws) {\n      workspaceSource = {\n        skillsDir: ws.skillsDir,\n        agentsMdPath: ws.agentsMdPath,\n        rootDir: ws.packageDir,\n      };\n    }\n  } catch {\n    // fall back to template-only\n  }\n\n  const bundle = readAgentsBundleFromFs(projectRoot, workspaceSource);\n  // Serialize as JSON and wrap in `export default` — this produces a valid\n  // ES module that any bundler (Rollup, esbuild, Rolldown) can statically\n  // analyze and tree-shake if nothing imports it.\n  return `// AUTO-GENERATED by @agent-native/core/vite/agents-bundle-plugin\n// Contains the inlined AGENTS.md + .agents/skills/ content from the template,\n// merged with any workspace AGENTS.md + .agents/skills/ when present.\nconst bundle = ${JSON.stringify(bundle)};\nexport default bundle;\n`;\n}\n\nexport function agentsBundlePlugin(): Plugin {\n  let projectRoot = \"\";\n\n  return {\n    name: \"agent-native-agents-bundle\",\n\n    configResolved(config) {\n      projectRoot = config.root;\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_ID) return RESOLVED_ID;\n      return null;\n    },\n\n    async load(id) {\n      if (id !== RESOLVED_ID) return null;\n      if (!projectRoot) projectRoot = process.cwd();\n      return await emitBundleModule(projectRoot);\n    },\n\n    async configureServer(server) {\n      // Watch AGENTS.md + any SKILL.md changes and invalidate the virtual\n      // module so the next request picks up fresh content. Also watches\n      // the workspace core's AGENTS.md + skills directory (if present)\n      // so edits to the enterprise mid-layer propagate to every app.\n      const watcher = server.watcher;\n\n      // Resolve the workspace core up front so we can tell which files\n      // outside projectRoot should trigger invalidation.\n      let workspaceAgentsMdPath: string | null = null;\n      let workspaceSkillsDir: string | null = null;\n      try {\n        const ws = await getWorkspaceCoreExports(projectRoot);\n        if (ws) {\n          workspaceAgentsMdPath = ws.agentsMdPath;\n          workspaceSkillsDir = ws.skillsDir;\n        }\n      } catch {\n        // ignore\n      }\n\n      const shouldInvalidate = (file: string): boolean => {\n        const rel = path.relative(projectRoot, file);\n        if (!rel.startsWith(\"..\")) {\n          if (rel === \"AGENTS.md\") return true;\n          if (rel.endsWith(\"SKILL.md\")) {\n            for (const skillsDir of TEMPLATE_SKILLS_DIRS) {\n              if (rel.startsWith(skillsDir + path.sep)) return true;\n            }\n          }\n        }\n        // Workspace-core files\n        if (workspaceAgentsMdPath && file === workspaceAgentsMdPath) {\n          return true;\n        }\n        if (\n          workspaceSkillsDir &&\n          file.startsWith(workspaceSkillsDir + path.sep) &&\n          file.endsWith(\"SKILL.md\")\n        ) {\n          return true;\n        }\n        return false;\n      };\n\n      let reloadTimer: ReturnType<typeof setTimeout> | null = null;\n      const scheduleFullReload = () => {\n        if (reloadTimer) clearTimeout(reloadTimer);\n        reloadTimer = setTimeout(() => {\n          reloadTimer = null;\n          server.ws.send({ type: \"full-reload\" });\n        }, FULL_RELOAD_COALESCE_MS);\n      };\n      server.httpServer?.once(\"close\", () => {\n        if (reloadTimer) clearTimeout(reloadTimer);\n        reloadTimer = null;\n      });\n\n      const invalidate = (file: string) => {\n        if (!shouldInvalidate(file)) return;\n        const mod = server.moduleGraph.getModuleById(RESOLVED_ID);\n        if (mod) {\n          server.moduleGraph.invalidateModule(mod);\n          scheduleFullReload();\n        }\n      };\n\n      // Explicitly add template + workspace-core paths to the watcher so\n      // edits outside the normal Vite watch set still trigger invalidation.\n      const agentsMdPath = path.join(projectRoot, \"AGENTS.md\");\n      const skillsDirs = TEMPLATE_SKILLS_DIRS.map((rel) =>\n        path.join(projectRoot, rel),\n      );\n      if (fs.existsSync(agentsMdPath)) watcher.add(agentsMdPath);\n      for (const skillsDir of skillsDirs) {\n        if (fs.existsSync(skillsDir)) watcher.add(skillsDir);\n      }\n      if (workspaceAgentsMdPath && fs.existsSync(workspaceAgentsMdPath)) {\n        watcher.add(workspaceAgentsMdPath);\n      }\n      if (workspaceSkillsDir && fs.existsSync(workspaceSkillsDir)) {\n        watcher.add(workspaceSkillsDir);\n      }\n\n      watcher.on(\"change\", invalidate);\n      watcher.on(\"add\", invalidate);\n      watcher.on(\"unlink\", invalidate);\n    },\n  };\n}\n"]}

package/dist/vite/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/vite/client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAa,MAAM,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAiB1D,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,kCAAkC,CAAC;AAuY1C;;;;;GAKG;AACH,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAgE9C;AAED;;;;;;GAMG;AACH,iBAAS,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCvD;AAOD;;;;;GAKG;AACH,iBAAS,qBAAqB,CAC5B,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAc9C;AAqCD,iBAAS,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAmNrD;AAwKD,MAAM,WAAW,YAAY;IAC3B,sGAAsG;IACtG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,YAAY,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;IAC9E,oGAAoG;IACpG,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAClC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,YAAY,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IACvD,wCAAwC;IACxC,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,iCAAiC,CAAC;IAChD;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,0BAA0B,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,4BAA6B,SAAQ,IAAI,CACxD,mBAAmB,EACnB,SAAS,GAAG,aAAa,CAC1B;IACC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAkiBD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAWT;AA6vBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,OAAO,GAAE,4BAAiC,GACzC,MAAM,EAAE,CAcV;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAU1E;AAED,OAAO,EACL,eAAe,IAAI,gBAAgB,EACnC,sBAAsB,IAAI,uBAAuB,EACjD,mBAAmB,IAAI,oBAAoB,EAC3C,qBAAqB,IAAI,sBAAsB,GAChD,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/vite/client.ts"],"names":[],"mappings":"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"}

package/dist/vite/client.js

@@ -504,6 +504,7 @@ const CORE_CLIENT_SUBPATHS = [
     "@agent-native/core/client/composer",
     "@agent-native/core/client/conversation",
     "@agent-native/core/client/editor",
+    "@agent-native/core/client/i18n",
     "@agent-native/core/client/resources",
     // Dedicated subpath that exports ONLY appBasePath/agentNativePath/appPath.
     // entry.client.tsx imports from here so it never pulls the full client barrel
@@ -523,6 +524,7 @@ const CORE_CLIENT_SUBPATHS = [
     "@agent-native/core/client/transcription/use-live-transcription",
     "@agent-native/core/voice",
 ];
+const NODE_SSR_NATIVE_EXTERNALS = ["better-sqlite3", "bindings"];
 function getDefaultOptimizeDeps(cwd) {
     const inMonorepo = findCoreSrcDir(cwd) !== null;
     const entries = [
@@ -557,6 +559,10 @@ function getDefaultOptimizeDeps(cwd) {
                     specifier: "@agent-native/core/client/editor",
                     packageName: "@agent-native/core",
                 },
+                {
+                    specifier: "@agent-native/core/client/i18n",
+                    packageName: "@agent-native/core",
+                },
                 {
                     specifier: "@agent-native/core/client/resources",
                     packageName: "@agent-native/core",
@@ -756,6 +762,7 @@ function getCoreSourceAliases(cwd) {
         "@agent-native/core/client/composer": path.join(coreSrc, "client/composer/index.ts"),
         "@agent-native/core/client/conversation": path.join(coreSrc, "client/conversation/index.ts"),
         "@agent-native/core/client/editor": path.join(coreSrc, "client/editor/index.ts"),
+        "@agent-native/core/client/i18n": path.join(coreSrc, "client/i18n.tsx"),
         "@agent-native/core/client/resources": path.join(coreSrc, "client/resources/index.ts"),
         // Dedicated thin subpath — only the URL helpers, no chat stack in the closure.
         "@agent-native/core/client/api-path": path.join(coreSrc, "client/api-path.ts"),
@@ -1882,6 +1889,10 @@ function createAgentNativeConfig(options = {}, command, userConfig = {}) {
             ? {
                 ...(userConfig.ssr ?? {}),
                 noExternal: /^(?!node:)/,
+                external: [
+                    ...NODE_SSR_NATIVE_EXTERNALS,
+                    ...arrayFrom(userConfig.ssr?.external),
+                ],
                 // Pick the workspace-core's compiled `dist/` exports in prod —
                 // Node-style `default` condition matches what edge runtimes (CF
                 // Workers, Deno) can actually load. Without this, Vite's prod