@agent-native/core 0.136.0 → 0.136.3

package/dist/server/transcribe-voice.js

@@ -46,6 +46,7 @@ const MAX_TRANSCRIPT_CHARS = 150_000;
 // Public Builder transcription model id. The Builder gateway maps this to
 // Gemini 3.1 Flash-Lite.
 const BUILDER_GEMINI_TRANSCRIPTION_MODEL = "gemini-3-1-flash-lite";
+const BUILDER_CLEANUP_MODEL = "gpt-5-6-luna";
 // Gemini Flash Lite BYOK path when GEMINI_API_KEY is configured.
 // Gemini accepts inline audio; we just give it the bytes and a "transcribe
 // this" prompt and it replies with text. 2.5x faster TTFT than 2.5 Flash
@@ -492,7 +493,14 @@ async function cleanupTranscriptText({ event, text, instructions, contextPack, p
             };
         }
         try {
-            const cleaned = await withRequestContext(() => cleanupWithBuilder({ text: original, instructions, clientAbortSignal }));
+            const cleaned = await withRequestContext(() => cleanupWithBuilder({
+                text: original,
+                instructions,
+                clientAbortSignal,
+                model: providerPref === "builder-gemini"
+                    ? BUILDER_GEMINI_TRANSCRIPTION_MODEL
+                    : undefined,
+            }));
             return { text: finalizeText(cleaned || original) };
         }
         catch (err) {
@@ -562,12 +570,13 @@ async function cleanupTranscriptText({ event, text, instructions, contextPack, p
             // Fall through to BYOK providers, then raw text.
         }
     }
-    const geminiKey = await resolveApiKey("GEMINI_API_KEY");
-    if (geminiKey) {
+    const openaiKey = await resolveApiKey("OPENAI_API_KEY");
+    if (openaiKey) {
         try {
-            const cleaned = await cleanupWithGemini({
+            const cleaned = await cleanupWithChatProvider({
+                provider: "openai",
                 text: original,
-                apiKey: geminiKey,
+                apiKey: openaiKey,
                 instructions,
                 clientAbortSignal,
             });
@@ -578,13 +587,12 @@ async function cleanupTranscriptText({ event, text, instructions, contextPack, p
             // Fall through.
         }
     }
-    const groqKey = await resolveApiKey("GROQ_API_KEY");
-    if (groqKey) {
+    const geminiKey = await resolveApiKey("GEMINI_API_KEY");
+    if (geminiKey) {
         try {
-            const cleaned = await cleanupWithChatProvider({
-                provider: "groq",
+            const cleaned = await cleanupWithGemini({
                 text: original,
-                apiKey: groqKey,
+                apiKey: geminiKey,
                 instructions,
                 clientAbortSignal,
             });
@@ -595,13 +603,13 @@ async function cleanupTranscriptText({ event, text, instructions, contextPack, p
             // Fall through.
         }
     }
-    const openaiKey = await resolveApiKey("OPENAI_API_KEY");
-    if (openaiKey) {
+    const groqKey = await resolveApiKey("GROQ_API_KEY");
+    if (groqKey) {
         try {
             const cleaned = await cleanupWithChatProvider({
-                provider: "openai",
+                provider: "groq",
                 text: original,
-                apiKey: openaiKey,
+                apiKey: groqKey,
                 instructions,
                 clientAbortSignal,
             });
@@ -614,7 +622,7 @@ async function cleanupTranscriptText({ event, text, instructions, contextPack, p
     }
     return { text: finalizeText(original) };
 }
-async function cleanupWithBuilder({ text, instructions, clientAbortSignal, }) {
+async function cleanupWithBuilder({ text, instructions, clientAbortSignal, model, }) {
     const engine = createBuilderEngine();
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 8_000);
@@ -623,7 +631,7 @@ async function cleanupWithBuilder({ text, instructions, clientAbortSignal, }) {
     let terminalError;
     try {
         for await (const event of engine.stream({
-            model: BUILDER_GEMINI_TRANSCRIPTION_MODEL,
+            model: model ?? BUILDER_CLEANUP_MODEL,
             systemPrompt: buildCleanupSystemPrompt(instructions),
             messages: [
                 {

package/dist/vite/client.d.ts

@@ -17,6 +17,42 @@ import { type AgentNativeRouteWarmupConfigInput } from "../shared/route-warmup-c
  * this has no effect outside `vite dev`.
  */
 declare function debounceNitroFullReloadHotUpdate(plugin: Plugin): Plugin;
+/**
+ * Invalidate every React Router virtual module in every Vite environment, and
+ * tell each affected server environment's runner to re-import.
+ *
+ * Returns the environment names that had something to invalidate.
+ */
+declare function mirrorReactRouterVirtualInvalidation(server: any, now?: () => number): string[];
+/**
+ * Mirror React Router's dev-time virtual-module invalidation into the
+ * environment that actually serves requests.
+ *
+ * `@react-router/dev`'s framework-mode plugin invalidates its virtual modules
+ * through `server.moduleGraph` — Vite's deprecated back-compat graph, which
+ * proxies only the `client` and `ssr` environments. Agent Native serves SSR
+ * from Nitro's `nitro` environment, so that invalidation never reaches the
+ * `virtual:react-router/server-build` the request path evaluates, and the route
+ * table stays frozen at whatever it was when the dev server booted. A new route
+ * file then 404s forever, and a deleted one makes the stale manifest import a
+ * file that no longer exists — which fails the whole build, so EVERY page 500s
+ * with "Failed to load url … Does the file exist?" until the process restarts.
+ * Editing a route's contents hides all of this, because that path goes through
+ * Vite's normal HMR pipeline, which is environment-aware.
+ *
+ * Hooking React Router's call rather than the file watcher is what makes this
+ * ordering-safe: it awaits `updatePluginContext()` before invalidating, so by
+ * the time we mirror, the freshly resolved routes are already in place.
+ *
+ * React Router's RSC plugin already iterates `environments`; only the classic
+ * plugin still uses the back-compat graph (still true in 8.3.0). Delete this
+ * once upstream's classic path is environment-aware.
+ */
+declare function installReactRouterVirtualInvalidationMirror(server: any, { debounceMs, now, warn, }?: {
+    debounceMs?: number;
+    now?: () => number;
+    warn?: (message: string) => void;
+}): boolean;
 /**
  * Build the `resolve.dedupe` list dynamically. Reads core's package.json and
  * collects every peerDependency that the consuming app also declares. This
@@ -179,5 +215,5 @@ export declare function agentNative(options?: AgentNativeVitePluginOptions): Plu
  * preset. This compatibility wrapper remains for existing templates.
  */
 export declare function defineConfig(options?: ClientConfigOptions): UserConfig;
-export { getClientDedupe as _getClientDedupe, getDefaultOptimizeDeps as _getDefaultOptimizeDeps, findCorePackageRoot as _findCorePackageRoot, getReactRouterAliases as _getReactRouterAliases, nitroStartupGate as _nitroStartupGate, nitroStartupRecovery as _nitroStartupRecovery, nitroModuleGraphSignature as _nitroModuleGraphSignature, debounceNitroFullReloadHotUpdate as _debounceNitroFullReloadHotUpdate, };
+export { getClientDedupe as _getClientDedupe, getDefaultOptimizeDeps as _getDefaultOptimizeDeps, findCorePackageRoot as _findCorePackageRoot, getReactRouterAliases as _getReactRouterAliases, nitroStartupGate as _nitroStartupGate, nitroStartupRecovery as _nitroStartupRecovery, nitroModuleGraphSignature as _nitroModuleGraphSignature, debounceNitroFullReloadHotUpdate as _debounceNitroFullReloadHotUpdate, installReactRouterVirtualInvalidationMirror as _installReactRouterVirtualInvalidationMirror, mirrorReactRouterVirtualInvalidation as _mirrorReactRouterVirtualInvalidation, };
 //# sourceMappingURL=client.d.ts.map

package/dist/vite/client.js

@@ -285,6 +285,114 @@ function debounceNitroFullReloadHotUpdate(plugin) {
     }
     return { ...plugin, hotUpdate: wrappedHotUpdate };
 }
+/** Prefix Vite gives React Router's virtual modules. */
+const REACT_ROUTER_VIRTUAL_ID_PREFIX = "\0virtual:react-router/";
+/**
+ * Debounce window for coalescing mirrored route-table reloads.
+ *
+ * A coding agent that rewrites a route tree emits one watcher event per file,
+ * and React Router re-resolves its config for each one. Keep this independent
+ * of `NITRO_FULL_RELOAD_DEBOUNCE_MS`: that one throttles Nitro's own reload
+ * broadcasts, this one throttles ours, and tuning either must not silently
+ * retune the other.
+ */
+const REACT_ROUTER_INVALIDATION_MIRROR_DEBOUNCE_MS = 300;
+/**
+ * Invalidate every React Router virtual module in every Vite environment, and
+ * tell each affected server environment's runner to re-import.
+ *
+ * Returns the environment names that had something to invalidate.
+ */
+function mirrorReactRouterVirtualInvalidation(server, now = Date.now) {
+    const timestamp = now();
+    const touched = [];
+    for (const [name, environment] of Object.entries(server?.environments ?? {})) {
+        const moduleGraph = environment?.moduleGraph;
+        if (!moduleGraph?.idToModuleMap)
+            continue;
+        const seen = new Set();
+        let invalidated = 0;
+        for (const id of [...moduleGraph.idToModuleMap.keys()]) {
+            if (!id.startsWith(REACT_ROUTER_VIRTUAL_ID_PREFIX))
+                continue;
+            const mod = moduleGraph.getModuleById(id);
+            if (!mod)
+                continue;
+            moduleGraph.invalidateModule(mod, seen, timestamp, true);
+            invalidated += 1;
+        }
+        if (invalidated === 0)
+            continue;
+        touched.push(name);
+        // Server environments evaluate the build inside a runner that keeps its own
+        // module cache; graph invalidation alone never reaches it. Client
+        // environments get their update through React Router's own HMR handling.
+        if (environment?.config?.consumer !== "client") {
+            environment?.hot?.send?.({ type: "full-reload" });
+        }
+    }
+    return touched;
+}
+/**
+ * Mirror React Router's dev-time virtual-module invalidation into the
+ * environment that actually serves requests.
+ *
+ * `@react-router/dev`'s framework-mode plugin invalidates its virtual modules
+ * through `server.moduleGraph` — Vite's deprecated back-compat graph, which
+ * proxies only the `client` and `ssr` environments. Agent Native serves SSR
+ * from Nitro's `nitro` environment, so that invalidation never reaches the
+ * `virtual:react-router/server-build` the request path evaluates, and the route
+ * table stays frozen at whatever it was when the dev server booted. A new route
+ * file then 404s forever, and a deleted one makes the stale manifest import a
+ * file that no longer exists — which fails the whole build, so EVERY page 500s
+ * with "Failed to load url … Does the file exist?" until the process restarts.
+ * Editing a route's contents hides all of this, because that path goes through
+ * Vite's normal HMR pipeline, which is environment-aware.
+ *
+ * Hooking React Router's call rather than the file watcher is what makes this
+ * ordering-safe: it awaits `updatePluginContext()` before invalidating, so by
+ * the time we mirror, the freshly resolved routes are already in place.
+ *
+ * React Router's RSC plugin already iterates `environments`; only the classic
+ * plugin still uses the back-compat graph (still true in 8.3.0). Delete this
+ * once upstream's classic path is environment-aware.
+ */
+function installReactRouterVirtualInvalidationMirror(server, { debounceMs = REACT_ROUTER_INVALIDATION_MIRROR_DEBOUNCE_MS, now = Date.now, warn = console.warn, } = {}) {
+    const backCompatGraph = server?.moduleGraph;
+    const original = backCompatGraph?.invalidateModule;
+    if (typeof original !== "function") {
+        warn("[agent-native] Vite's server.moduleGraph.invalidateModule is unavailable, " +
+            "so React Router route additions and deletions cannot be mirrored into " +
+            "the Nitro dev environment. Adding or deleting a route file will need a " +
+            "dev server restart to take effect.");
+        return false;
+    }
+    let pending;
+    backCompatGraph.invalidateModule = function patchedInvalidateModule(mod, ...rest) {
+        const result = original.call(this, mod, ...rest);
+        if (!mod?.id?.startsWith(REACT_ROUTER_VIRTUAL_ID_PREFIX))
+            return result;
+        if (pending)
+            clearTimeout(pending);
+        pending = setTimeout(() => {
+            pending = undefined;
+            mirrorReactRouterVirtualInvalidation(server, now);
+        }, debounceMs);
+        // Never hold the process open just for a pending reload.
+        pending.unref?.();
+        return result;
+    };
+    return true;
+}
+function reactRouterVirtualInvalidationMirrorPlugin() {
+    return {
+        name: "agent-native-react-router-invalidation-mirror",
+        apply: "serve",
+        configureServer(server) {
+            installReactRouterVirtualInvalidationMirror(server);
+        },
+    };
+}
 /**
  * Sync discovery for the workspace-core in an enterprise monorepo.
  *
@@ -2408,6 +2516,7 @@ function createAgentNativePlugins(options, { command, includeReactTransform, use
         baseRedirectGuard(),
         portExposer(),
         nitroStartupGate(),
+        reactRouterVirtualInvalidationMirrorPlugin(),
         silenceConnectionResets(),
         rolldownInputFix(),
         // Nitro Vite plugin for dev-mode API route serving and HMR.
@@ -2778,5 +2887,5 @@ export function defineConfig(options = {}) {
         }),
     };
 }
-export { getClientDedupe as _getClientDedupe, getDefaultOptimizeDeps as _getDefaultOptimizeDeps, findCorePackageRoot as _findCorePackageRoot, getReactRouterAliases as _getReactRouterAliases, nitroStartupGate as _nitroStartupGate, nitroStartupRecovery as _nitroStartupRecovery, nitroModuleGraphSignature as _nitroModuleGraphSignature, debounceNitroFullReloadHotUpdate as _debounceNitroFullReloadHotUpdate, };
+export { getClientDedupe as _getClientDedupe, getDefaultOptimizeDeps as _getDefaultOptimizeDeps, findCorePackageRoot as _findCorePackageRoot, getReactRouterAliases as _getReactRouterAliases, nitroStartupGate as _nitroStartupGate, nitroStartupRecovery as _nitroStartupRecovery, nitroModuleGraphSignature as _nitroModuleGraphSignature, debounceNitroFullReloadHotUpdate as _debounceNitroFullReloadHotUpdate, installReactRouterVirtualInvalidationMirror as _installReactRouterVirtualInvalidationMirror, mirrorReactRouterVirtualInvalidation as _mirrorReactRouterVirtualInvalidation, };
 //# sourceMappingURL=client.js.map

package/docs/content/template-assets.mdx

@@ -5,7 +5,7 @@ description: "An agent-native digital asset manager and cross-agent generation s
 
 # Assets
 
-Assets is a workspace for creating and managing brand-consistent media — for anyone who needs on-brand images and video without wrangling prompts, models, and aspect ratios every time. It organizes uploads and generated results into libraries and folders, lets teams collect examples for blog heroes, diagrams, landing pages, product shots, videos, and logos, then routes generation through the agent chat so every asset can be reviewed and refined.
+Assets is a workspace for creating and managing brand-consistent media, especially when image or video models have a clear advantage. It organizes uploads and generated results into libraries and folders, lets teams collect approved references for product shots, logos, social images, photorealistic scenes, and other media to use in a Design composition or elsewhere, then routes generation through the agent chat so every asset can be reviewed and refined.
 
 <WireframeBlock id="doc-block-assets1">
   <Screen
@@ -81,6 +81,14 @@ When you open the app, the selected library, prompt, references, and generated c
 
 </Diagram>
 
+## Assets vs Design
+
+Use **Design** for most visual work. Start there for landing pages, ads, diagrams, and other compositions when you need HTML/CSS, precise layout, editable structure, or design-tool import/export.
+
+Use **Assets** when image or video models are better suited to the job and the result can be used as media rather than edited piece by piece. This includes photorealistic or pixel-based imagery, product shots, social images, and video. Hand-drawn or Excalidraw-style diagrams can be an exception when you want the generated image as-is.
+
+The intended workflow is to start in Design and let the Design agent delegate supporting image generation to Assets when a PNG or other media asset is the right fit. Use the result in the Design composition or in another app.
+
 ## When to pick it
 
 - **Your team needs reusable visual direction**, not one-off generic media prompts — collect approved logos, product shots, and style examples so generations stay on brand.
@@ -104,9 +112,11 @@ Live demo: [assets.agent-native.com](https://assets.agent-native.com).
    want to manage.
 2. **Upload references.** Add approved logos, product shots, style examples, or
    existing videos so the agent has concrete material to work from.
-3. **Generate from chat or a library.** Ask for a hero image, diagram, product
-   shot, or video variant. Assets stores the prompt, references, model, status,
-   and lineage for review.
+3. **Generate a media asset from chat or a library.** Ask for a product shot,
+   social image, photorealistic scene, image-based diagram, or video variant.
+   For a landing page, ad, or other editable composition, start in Design and
+   use Assets for supporting media. Assets stores the prompt, references,
+   model, status, and lineage for review.
 4. **Use the asset elsewhere.** Copy the export, embed the picker in another
    app, or let another agent call Assets over A2A.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.136.0",
+  "version": "0.136.3",
   "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": {
@@ -400,7 +400,7 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31",
     "zod": "^4.3.6",
-    "@agent-native/recap-cli": "0.5.2",
+    "@agent-native/recap-cli": "0.5.3",
     "@agent-native/toolkit": "^0.12.2"
   },
   "devDependencies": {
@@ -441,7 +441,7 @@
     "express": "^5.2.1",
     "mermaid": "11.15.0",
     "node-pty": "^1.1.0",
-    "playwright": "^1.61.1",
+    "playwright": "1.61.1",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "react-router": "^8.1.0",
@@ -579,7 +579,6 @@
     "jszip": "^3.10.1",
     "mammoth": "^1.12.0",
     "officeparser": "^7.3.0",
-    "playwright": "^1.61.1",
     "sharp": "^0.35.3"
   },
   "engines": {