@agent-native/core 0.47.1 → 0.48.2

package/dist/templates/default/DEVELOPING.md

@@ -101,6 +101,8 @@ sendToAgentChat({
 
 For most UI handoffs, pass hidden context directly with `sendToAgentChat()`. Use
 `submit: false` when the user should review the draft first. Use
+`newTab: true, background: true, openSidebar: false` when a button should start
+a full agent run without opening or focusing the sidebar. Use
 `useAgentChatContext`, `setAgentChatContextItem`, `listAgentChatContext`,
 `removeAgentChatContextItem`, and `clearAgentChatContext` only for advanced UI
 that needs to read, mirror, stage, remove, or clear staged context chips as local
@@ -113,6 +115,23 @@ import { agentChat } from "@agent-native/core";
 agentChat.submit("Generate something");
 ```
 
+**Server-side one-shot text transforms:**
+
+```ts
+import { completeText } from "@agent-native/core/server";
+
+const result = await completeText({
+  systemPrompt: "Return exactly one category label.",
+  input: body,
+  maxOutputTokens: 16,
+  temperature: 0,
+});
+```
+
+Use this only for narrow transforms that intentionally need no tools, chat
+history, or run state. For user-facing operations, call it inside an action so
+the UI and agent share the same capability.
+
 ## Database
 
 Local development defaults to a SQLite file at `data/app.db`. That local file is for development; containers, previews, and serverless deploys can reset their filesystem. For production/cloud deployment, set `DATABASE_URL` to point to a persistent SQL database. Turso is optional, not required; common choices include Neon, Supabase, Turso/libSQL, plain Postgres, durable SQLite, D1 bindings, and Builder.io-managed environments when available.

package/dist/templates/default/app/entry.client.tsx

@@ -1,4 +1,7 @@
-import { appBasePath } from "@agent-native/core/client";
+// Import only the tiny URL-helper module, not the full client barrel.
+// This keeps the ~650-700 KB gzip chat stack off the static import closure
+// of the client entry point so it can't block the first page parse.
+import { appBasePath } from "@agent-native/core/client/api-path";
 import { hydrateRoot } from "react-dom/client";
 import { HydratedRouter } from "react-router/dom";
 

package/dist/templates/default/app/entry.server.tsx

@@ -1,56 +1,4 @@
-import type { AppLoadContext, EntryContext } from "react-router";
-import { ServerRouter } from "react-router";
-import ReactDOMServer from "react-dom/server.browser";
-const { renderToReadableStream } = ReactDOMServer;
-import { isbot } from "isbot";
-import { wrapWithAnalytics } from "@agent-native/core/server";
-
-export const streamTimeout = 5_000;
-
-export default async function handleRequest(
-  request: Request,
-  responseStatusCode: number,
-  responseHeaders: Headers,
-  routerContext: EntryContext,
-  _loadContext: AppLoadContext,
-) {
-  if (request.method.toUpperCase() === "HEAD") {
-    return new Response(null, {
-      status: responseStatusCode,
-      headers: responseHeaders,
-    });
-  }
-
-  const userAgent = request.headers.get("user-agent");
-  const waitForAll = (userAgent && isbot(userAgent)) || routerContext.isSpaMode;
-
-  const abortController = new AbortController();
-  const timeoutId = setTimeout(() => abortController.abort(), streamTimeout);
-
-  try {
-    const body = await renderToReadableStream(
-      <ServerRouter context={routerContext} url={request.url} />,
-      {
-        signal: abortController.signal,
-        onError(error: unknown) {
-          if (!abortController.signal.aborted) {
-            responseStatusCode = 500;
-            console.error(error);
-          }
-        },
-      },
-    );
-
-    if (waitForAll) {
-      await body.allReady;
-    }
-
-    responseHeaders.set("Content-Type", "text/html");
-    return new Response(wrapWithAnalytics(body), {
-      headers: responseHeaders,
-      status: responseStatusCode,
-    });
-  } finally {
-    clearTimeout(timeoutId);
-  }
-}
+export {
+  handleDocumentRequest as default,
+  streamTimeout,
+} from "@agent-native/core/server/entry-server";

package/dist/templates/default/app/global.css

@@ -1,4 +1,5 @@
-@import url("https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap");
+/* Self-hosted via @fontsource-variable/inter — no render-blocking Google Fonts request */
+@import "@fontsource-variable/inter";
 
 @import "tailwindcss";
 @import "@agent-native/core/styles/agent-native.css";
@@ -71,7 +72,7 @@
   body {
     background: hsl(var(--background));
     color: hsl(var(--foreground));
-    font-family: "Inter", sans-serif;
+    font-family: "Inter Variable", "Inter", sans-serif;
     font-feature-settings: "cv02", "cv03", "cv04", "cv11";
   }
 }

package/dist/templates/default/app/root.tsx

@@ -9,20 +9,14 @@ import {
   useRouteError,
 } from "react-router";
 import { useEffect, useState } from "react";
-import {
-  QueryClient,
-  QueryClientProvider,
-  useQueryClient,
-} from "@tanstack/react-query";
-import { ThemeProvider } from "next-themes";
+import { useQueryClient } from "@tanstack/react-query";
 import { useDbSync } from "@agent-native/core";
 import {
-  ClientOnly,
-  DefaultSpinner,
+  AppProviders,
   appPath,
   getThemeInitScript,
+  createAgentNativeQueryClient,
 } from "@agent-native/core/client";
-import { Toaster } from "sonner";
 import { configureTracking } from "@agent-native/core/client";
 import { useNavigationState } from "./hooks/use-navigation-state";
 import { TAB_ID } from "./lib/tab-id";
@@ -92,22 +86,12 @@ function DbSyncSetup() {
 }
 
 export default function Root() {
-  const [queryClient] = useState(() => new QueryClient());
+  const [queryClient] = useState(() => createAgentNativeQueryClient());
   return (
-    <ClientOnly fallback={<DefaultSpinner />}>
-      <ThemeProvider
-        attribute="class"
-        defaultTheme="system"
-        enableSystem
-        disableTransitionOnChange
-      >
-        <QueryClientProvider client={queryClient}>
-          <DbSyncSetup />
-          <Outlet />
-          <Toaster richColors position="bottom-left" />
-        </QueryClientProvider>
-      </ThemeProvider>
-    </ClientOnly>
+    <AppProviders queryClient={queryClient}>
+      <DbSyncSetup />
+      <Outlet />
+    </AppProviders>
   );
 }
 

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

@@ -1,23 +1,10 @@
 import { useTheme } from "next-themes";
-import { IconLoader2 } from "@tabler/icons-react";
 import { useActionQuery } from "@agent-native/core/client";
 
 export function meta() {
   return [{ title: "{{APP_TITLE}}" }];
 }
 
-export function HydrateFallback() {
-  return (
-    <div className="flex items-center justify-center h-screen">
-      <IconLoader2
-        className="size-8 animate-spin text-foreground"
-        role="status"
-        aria-label="Loading"
-      />
-    </div>
-  );
-}
-
 export default function IndexPage() {
   const { resolvedTheme, setTheme } = useTheme();
   const isDark = resolvedTheme === "dark";

package/dist/templates/default/package.json

@@ -14,7 +14,8 @@
     "@agent-native/core": "latest",
     "@assistant-ui/react": "^0.12.19",
     "@assistant-ui/react-markdown": "^0.12.6",
-    "@tabler/icons-react": "^3.40.0",
+    "@fontsource-variable/inter": "^5.2.8",
+    "@tabler/icons-react": "catalog:",
     "h3": "^2.0.1-rc.20",
     "isbot": "^5",
     "postgres": "^3.4.9",
@@ -26,14 +27,14 @@
     "@tailwindcss/vite": "^4.1.18",
     "@tanstack/react-query": "^5.99.2",
     "@types/node": "^24.2.1",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
+    "@types/react": "catalog:",
+    "@types/react-dom": "catalog:",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "next-themes": "^0.4.6",
     "prettier": "^3.6.2",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
+    "react": "catalog:",
+    "react-dom": "catalog:",
     "react-router": "^7.16.0",
     "sonner": "^2.0.7",
     "tailwind-merge": "^3.5.0",

package/dist/templates/default/tsconfig.json

@@ -6,6 +6,7 @@
     "shared/**/*",
     "vite.config.ts",
     "react-router.config.ts",
-    ".react-router/types/**/*"
+    ".react-router/types/**/*",
+    ".generated/**/*"
   ]
 }

package/dist/templates/starter-shell-sync.spec.ts

@@ -0,0 +1,118 @@
+/**
+ * Guard: the scaffold template (packages/core/src/templates/default) and
+ * templates/starter must ship byte-identical shell files so that scaffolded
+ * apps start from exactly the same code as the reference starter template.
+ *
+ * When you update entry.server.tsx or entry.client.tsx in either location,
+ * update the other copy to match (copy in either direction — the content is
+ * canonical, not the direction).
+ *
+ * Sync commands:
+ *   # scaffold → starter
+ *   cp packages/core/src/templates/default/app/entry.server.tsx \
+ *      templates/starter/app/entry.server.tsx
+ *   cp packages/core/src/templates/default/app/entry.client.tsx \
+ *      templates/starter/app/entry.client.tsx
+ *
+ *   # starter → scaffold
+ *   cp templates/starter/app/entry.server.tsx \
+ *      packages/core/src/templates/default/app/entry.server.tsx
+ *   cp templates/starter/app/entry.client.tsx \
+ *      packages/core/src/templates/default/app/entry.client.tsx
+ */
+
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+
+function workspaceRoot(): string {
+  let current = process.cwd();
+  while (current !== path.dirname(current)) {
+    if (fs.existsSync(path.join(current, "pnpm-workspace.yaml"))) {
+      return current;
+    }
+    current = path.dirname(current);
+  }
+  throw new Error("Could not locate workspace root (pnpm-workspace.yaml).");
+}
+
+const ROOT = workspaceRoot();
+
+const SCAFFOLD_DIR = path.join(ROOT, "packages/core/src/templates/default/app");
+const STARTER_DIR = path.join(ROOT, "templates/starter/app");
+
+function md5(content: string): string {
+  return crypto.createHash("md5").update(content).digest("hex");
+}
+
+function readFile(dir: string, filename: string): string {
+  return fs.readFileSync(path.join(dir, filename), "utf-8");
+}
+
+/**
+ * Shell files that must be byte-identical between scaffold and starter.
+ * Each entry is [filename, reason]:
+ *   entry.server.tsx — both now re-export the shared core handler; any
+ *     future change to the pattern must land in both places at once.
+ *   entry.client.tsx — lightweight hydration entry that sets basename from
+ *     APP_BASE_PATH; must stay in sync for workspace-mount correctness.
+ */
+const SHELL_FILES: Array<[string, string]> = [
+  [
+    "entry.server.tsx",
+    "re-exports @agent-native/core/server/entry-server; must be identical",
+  ],
+  [
+    "entry.client.tsx",
+    "basename hydration from APP_BASE_PATH; must be identical",
+  ],
+];
+
+describe("starter-shell sync guard", () => {
+  it("keeps scaffold and starter shell files byte-identical", () => {
+    const violations: string[] = [];
+
+    for (const [filename] of SHELL_FILES) {
+      const scaffoldContent = readFile(SCAFFOLD_DIR, filename);
+      const starterContent = readFile(STARTER_DIR, filename);
+
+      const scaffoldHash = md5(scaffoldContent);
+      const starterHash = md5(starterContent);
+
+      if (scaffoldHash !== starterHash) {
+        violations.push(
+          `${filename}: scaffold (packages/core/src/templates/default/app) and starter (templates/starter/app) differ.\n` +
+            `  Update both to match or copy one to the other.`,
+        );
+      }
+    }
+
+    expect(
+      violations,
+      [
+        "Scaffold/starter shell files have drifted.",
+        "Copy the updated file to the other location to fix.",
+        "",
+        ...violations,
+      ].join("\n"),
+    ).toEqual([]);
+  });
+
+  it("every listed shell file exists in both scaffold and starter", () => {
+    for (const [filename, reason] of SHELL_FILES) {
+      const scaffoldPath = path.join(SCAFFOLD_DIR, filename);
+      const starterPath = path.join(STARTER_DIR, filename);
+
+      expect(
+        fs.existsSync(scaffoldPath),
+        `${filename} missing from scaffold (${reason})`,
+      ).toBe(true);
+
+      expect(
+        fs.existsSync(starterPath),
+        `${filename} missing from starter (${reason})`,
+      ).toBe(true);
+    }
+  });
+});