@agent-native/core 0.82.0 → 0.83.0

package/corpus/templates/content/app/root.tsx

@@ -9,14 +9,24 @@ import {
   type LocaleCode,
   type LocaleMessages,
   type LocalizationPreference,
+  useActionQuery,
   useCommandMenuShortcut,
   useT,
 } from "@agent-native/core/client";
 import { configureTracking } from "@agent-native/core/client";
 import { resolveLocaleFromRequest } from "@agent-native/core/server";
-import { IconDeviceDesktop, IconMoon, IconSun } from "@tabler/icons-react";
+import type { ListContentDatabasesResponse } from "@shared/api";
+import {
+  IconDatabase,
+  IconDeviceDesktop,
+  IconFileText,
+  IconFolderOpen,
+  IconLoader2,
+  IconMoon,
+  IconSun,
+} from "@tabler/icons-react";
 import { useTheme } from "next-themes";
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import {
   Links,
   Meta,
@@ -26,6 +36,7 @@ import {
   isRouteErrorResponse,
   useLoaderData,
   useLocation,
+  useNavigate,
   useRouteLoaderData,
   useRouteError,
 } from "react-router";
@@ -40,6 +51,11 @@ import changelog from "../CHANGELOG.md?raw";
 import { useDbSync } from "./hooks/use-db-sync";
 import { useNavigationState } from "./hooks/use-navigation-state";
 import { i18nCatalog } from "./i18n";
+import {
+  contentCommandDocumentPath,
+  groupContentCommandSearchResults,
+  type CommandSearchDocumentsResponse,
+} from "./lib/content-command-search";
 
 import stylesheet from "./global.css?url";
 configureTracking({
@@ -226,6 +242,211 @@ function ThemeToggleItem() {
   );
 }
 
+function CommandStateMessage({
+  children,
+  icon,
+}: {
+  children: React.ReactNode;
+  icon?: React.ReactNode;
+}) {
+  return (
+    <div
+      className="flex items-center gap-2 px-2 py-2 text-sm text-muted-foreground"
+      role="status"
+      aria-live="polite"
+    >
+      {icon}
+      <span className="min-w-0 flex-1">{children}</span>
+    </div>
+  );
+}
+
+function useDebouncedValue<T>(value: T, delayMs: number) {
+  const [debouncedValue, setDebouncedValue] = useState(value);
+
+  useEffect(() => {
+    const id = window.setTimeout(() => setDebouncedValue(value), delayMs);
+    return () => window.clearTimeout(id);
+  }, [delayMs, value]);
+
+  return debouncedValue;
+}
+
+function ContentCommandSearchResults({
+  query,
+  onOpenChange,
+}: {
+  query: string;
+  onOpenChange: (open: boolean) => void;
+}) {
+  const t = useT();
+  const navigate = useNavigate();
+  const trimmedQuery = query.trim();
+  const debouncedQuery = useDebouncedValue(trimmedQuery, 200);
+  const searchEnabled = debouncedQuery.length > 0;
+  const documentsQuery = useActionQuery<CommandSearchDocumentsResponse>(
+    "search-documents",
+    searchEnabled ? { query: debouncedQuery, limit: 8 } : undefined,
+    { enabled: searchEnabled, retry: false },
+  );
+  const databasesQuery = useActionQuery<ListContentDatabasesResponse>(
+    "list-content-databases",
+    searchEnabled ? { query: debouncedQuery, limit: 6 } : undefined,
+    { enabled: searchEnabled, retry: false, staleTime: 60_000 },
+  );
+
+  const searchGroups = useMemo(
+    () =>
+      groupContentCommandSearchResults({
+        documents: documentsQuery.data?.documents ?? [],
+        databases: databasesQuery.data?.databases ?? [],
+        query: debouncedQuery,
+      }),
+    [
+      databasesQuery.data?.databases,
+      documentsQuery.data?.documents,
+      debouncedQuery,
+    ],
+  );
+
+  if (!trimmedQuery) return null;
+
+  const resultCount =
+    searchGroups.documents.length +
+    searchGroups.databases.length +
+    searchGroups.localFiles.length;
+  const isWaitingForDebounce = trimmedQuery !== debouncedQuery;
+  const isLoading =
+    (isWaitingForDebounce ||
+      documentsQuery.isLoading ||
+      databasesQuery.isLoading) &&
+    resultCount === 0;
+  const error = documentsQuery.error ?? databasesQuery.error;
+  const hasResults = resultCount > 0;
+
+  const openDocument = (documentId: string) => {
+    onOpenChange(false);
+    navigate(contentCommandDocumentPath(documentId));
+  };
+
+  if (isLoading) {
+    return (
+      <CommandMenu.Group heading={t("root.commandSearchHeading")}>
+        <CommandStateMessage
+          icon={<IconLoader2 className="size-4 animate-spin" />}
+        >
+          {t("root.commandSearchLoading")}
+        </CommandStateMessage>
+      </CommandMenu.Group>
+    );
+  }
+
+  if (error && !hasResults) {
+    return (
+      <CommandMenu.Group heading={t("root.commandSearchHeading")}>
+        <CommandStateMessage>
+          {t("root.commandSearchError")}
+        </CommandStateMessage>
+      </CommandMenu.Group>
+    );
+  }
+
+  if (!hasResults) {
+    return (
+      <CommandMenu.Group heading={t("root.commandSearchHeading")}>
+        <CommandStateMessage>
+          {t("root.commandSearchEmpty")}
+        </CommandStateMessage>
+      </CommandMenu.Group>
+    );
+  }
+
+  return (
+    <>
+      {error ? (
+        <CommandMenu.Group heading={t("root.commandSearchHeading")}>
+          <CommandStateMessage>
+            {t("root.commandSearchPartialError")}
+          </CommandStateMessage>
+        </CommandMenu.Group>
+      ) : null}
+
+      {searchGroups.documents.length > 0 ? (
+        <CommandMenu.Group heading={t("root.commandDocumentsHeading")}>
+          {searchGroups.documents.map((document) => (
+            <CommandMenu.Item
+              key={`document:${document.id}`}
+              onSelect={() => openDocument(document.id)}
+              deferSelect={false}
+              className="items-start py-2"
+            >
+              <IconFileText className="mt-0.5 size-4 shrink-0 text-muted-foreground" />
+              <span className="min-w-0 flex-1">
+                <span className="block truncate font-medium">
+                  {document.title || t("sidebar.untitled")}
+                </span>
+                {document.snippet ? (
+                  <span className="mt-0.5 block line-clamp-2 text-xs leading-snug text-muted-foreground">
+                    {document.snippet}
+                  </span>
+                ) : null}
+              </span>
+            </CommandMenu.Item>
+          ))}
+        </CommandMenu.Group>
+      ) : null}
+
+      {searchGroups.databases.length > 0 ? (
+        <CommandMenu.Group heading={t("root.commandDatabasesHeading")}>
+          {searchGroups.databases.map((database) => (
+            <CommandMenu.Item
+              key={`database:${database.databaseId}`}
+              onSelect={() => openDocument(database.documentId)}
+              deferSelect={false}
+              className="items-start py-2"
+            >
+              <IconDatabase className="mt-0.5 size-4 shrink-0 text-muted-foreground" />
+              <span className="min-w-0 flex-1">
+                <span className="block truncate font-medium">
+                  {database.title || t("sidebar.untitled")}
+                </span>
+                <span className="mt-0.5 block text-xs leading-snug text-muted-foreground">
+                  {t("root.commandDatabaseResultDescription")}
+                </span>
+              </span>
+            </CommandMenu.Item>
+          ))}
+        </CommandMenu.Group>
+      ) : null}
+
+      {searchGroups.localFiles.length > 0 ? (
+        <CommandMenu.Group heading={t("root.commandLocalFilesHeading")}>
+          {searchGroups.localFiles.map((document) => (
+            <CommandMenu.Item
+              key={`local-file:${document.id}`}
+              onSelect={() => openDocument(document.id)}
+              deferSelect={false}
+              className="items-start py-2"
+            >
+              <IconFolderOpen className="mt-0.5 size-4 shrink-0 text-muted-foreground" />
+              <span className="min-w-0 flex-1">
+                <span className="block truncate font-medium">
+                  {document.title || t("sidebar.untitled")}
+                </span>
+                {document.snippet ? (
+                  <span className="mt-0.5 block line-clamp-2 text-xs leading-snug text-muted-foreground">
+                    {document.snippet}
+                  </span>
+                ) : null}
+              </span>
+            </CommandMenu.Item>
+          ))}
+        </CommandMenu.Group>
+      ) : null}
+    </>
+  );
+}
+
 function PublicAgentShell({ children }: { children: React.ReactNode }) {
   const [mounted, setMounted] = useState(false);
   const t = useT();
@@ -282,14 +503,16 @@ function ContentCommandMenu({
     <CommandMenu
       open={open}
       onOpenChange={onOpenChange}
+      placeholder={t("root.commandSearchPlaceholder")}
       changelog={changelog}
       changelogKey="content"
+      renderResults={(search) => (
+        <ContentCommandSearchResults
+          query={search}
+          onOpenChange={onOpenChange}
+        />
+      )}
     >
-      <CommandMenu.Group heading={t("root.commandContent")}>
-        <CommandMenu.Item onSelect={() => {}}>
-          {t("root.commandSearchDocuments")}
-        </CommandMenu.Item>
-      </CommandMenu.Group>
       <CommandMenu.Group heading={t("root.commandAppearance")}>
         <ThemeToggleItem />
       </CommandMenu.Group>
@@ -302,7 +525,12 @@ export default function Root() {
   const [cmdkOpen, setCmdkOpen] = useState(false);
   const location = useLocation();
   const loaderData = useLoaderData<typeof loader>();
-  useCommandMenuShortcut(useCallback(() => setCmdkOpen(true), []));
+  useCommandMenuShortcut(
+    useCallback(() => setCmdkOpen(true), []),
+    {
+      allowContentEditable: true,
+    },
+  );
 
   // Public document paths (/p/*) SSR real content without the ClientOnly gate
   // so crawlers and unauthenticated visitors receive full markup on first visit.

package/corpus/templates/content/changelog/2026-06-29-builder-cms-sources-now-sync-article-bodies-through-content.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-06-29
+---
+
+Builder CMS sources now sync article bodies into Content and push approved body edits through the Builder review flow.

package/corpus/templates/content/changelog/2026-06-30-builder-article-media-now-render-as-images-and-embeds-when-r.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-30
+---
+
+Builder article media now render as images and embeds when readable body content syncs from Builder.

package/corpus/templates/content/changelog/2026-06-30-builder-source-components-now-render-as-preserved-preview-bl.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-30
+---
+
+Builder source components now render as preserved preview blocks inside hydrated article bodies.

package/corpus/templates/content/changelog/2026-06-30-cmd-k-search-now-opens-from-the-editor-and-finds-real-content.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-30
+---
+
+Cmd+K search now opens from the editor and finds real documents, databases, and local-file results.

package/corpus/templates/content/package.json

@@ -5,13 +5,15 @@
   "type": "module",
   "scripts": {
     "dev": "agent-native dev",
+    "dev:database": "node scripts/check-native-deps.mjs && node scripts/dev-database.mjs",
     "build": "agent-native build",
     "start": "agent-native start",
     "test": "vitest --run",
     "format.fix": "oxfmt --write .",
     "typecheck": "agent-native typecheck",
     "action": "agent-native action",
-    "script": "agent-native script"
+    "script": "agent-native script",
+    "seed:demo": "node scripts/seed-demo-user.mjs"
   },
   "dependencies": {
     "@agent-native/core": "workspace:*",

package/corpus/templates/content/scripts/check-native-deps.mjs

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { existsSync, readdirSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+
+function resolveBetterSqlite3() {
+  try {
+    return require.resolve("better-sqlite3");
+  } catch {
+    const pnpmDir = join(__dirname, "..", "..", "..", "node_modules", ".pnpm");
+    if (!existsSync(pnpmDir))
+      throw new Error("better-sqlite3 is not installed");
+    const packageDir = readdirSync(pnpmDir).find((entry) =>
+      entry.startsWith("better-sqlite3@"),
+    );
+    if (!packageDir) throw new Error("better-sqlite3 is not installed");
+    return join(
+      pnpmDir,
+      packageDir,
+      "node_modules",
+      "better-sqlite3",
+      "lib",
+      "index.js",
+    );
+  }
+}
+
+try {
+  const { default: Database } = await import(
+    pathToFileURL(resolveBetterSqlite3()).href
+  );
+  const db = new Database(":memory:");
+  db.close();
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`
+[content dev preflight] better-sqlite3 could not load its native binding.
+
+This usually means the local install was restored without rebuilding native
+modules. Try:
+
+  pnpm rebuild better-sqlite3
+
+If that still fails, rebuild the package directly:
+
+  cd ../../node_modules/.pnpm/better-sqlite3@*/node_modules/better-sqlite3
+  npm run build-release
+
+Original error:
+${message}
+`);
+  process.exit(1);
+}

package/corpus/templates/content/scripts/dev-database.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const appDir = resolve(scriptDir, "..");
+const envPath = resolve(appDir, ".env.local");
+
+function parseEnv(text) {
+  const result = new Map();
+  for (const line of text.split(/\r?\n/)) {
+    const match = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)\s*$/);
+    if (!match) continue;
+    let value = match[2] ?? "";
+    if (
+      (value.startsWith('"') && value.endsWith('"')) ||
+      (value.startsWith("'") && value.endsWith("'"))
+    ) {
+      value = value.slice(1, -1);
+    }
+    result.set(match[1], value);
+  }
+  return result;
+}
+
+function serializeEnv(values) {
+  return `${[...values.entries()]
+    .map(([key, value]) => `${key}=${value}`)
+    .join("\n")}\n`;
+}
+
+function ensureLocalEnv() {
+  const existing = existsSync(envPath) ? readFileSync(envPath, "utf8") : "";
+  const values = parseEnv(existing);
+  let changed = false;
+
+  if (values.get("AGENT_NATIVE_MODE") !== "database") {
+    values.set("AGENT_NATIVE_MODE", "database");
+    changed = true;
+  }
+  const authSecret = values.get("BETTER_AUTH_SECRET") ?? "";
+  if (authSecret.length < 32) {
+    values.set("BETTER_AUTH_SECRET", randomBytes(32).toString("base64url"));
+    changed = true;
+  }
+
+  if (changed) {
+    writeFileSync(envPath, serializeEnv(values));
+    console.log("[content dev] Wrote local database-mode env to .env.local");
+  }
+  return values;
+}
+
+const envValues = ensureLocalEnv();
+const childEnv = {
+  ...process.env,
+  AGENT_NATIVE_MODE: "database",
+  BETTER_AUTH_SECRET:
+    process.env.BETTER_AUTH_SECRET || envValues.get("BETTER_AUTH_SECRET"),
+};
+
+const pnpmBin = process.platform === "win32" ? "pnpm.cmd" : "pnpm";
+const child = spawn(pnpmBin, ["exec", "agent-native", "dev"], {
+  cwd: appDir,
+  env: childEnv,
+  stdio: "inherit",
+  shell: process.platform === "win32",
+});
+
+child.on("error", (error) => {
+  console.error(
+    `[content dev] Failed to start agent-native dev: ${error.message}`,
+  );
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  process.exit(code ?? 0);
+});

package/corpus/templates/content/scripts/seed-demo-user.mjs

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+
+const DEFAULT_EMAIL = "demo@example.local";
+const DEFAULT_PASSWORD = "demo-content-password";
+
+const args = new Map();
+for (let i = 2; i < process.argv.length; i += 1) {
+  const arg = process.argv[i];
+  if (!arg.startsWith("--")) continue;
+  const key = arg.slice(2);
+  const next = process.argv[i + 1];
+  if (next && !next.startsWith("--")) {
+    args.set(key, next);
+    i += 1;
+  } else {
+    args.set(key, "true");
+  }
+}
+
+const email =
+  args.get("email") || process.env.CONTENT_DEMO_EMAIL || DEFAULT_EMAIL;
+const password =
+  args.get("password") || process.env.CONTENT_DEMO_PASSWORD || DEFAULT_PASSWORD;
+const shouldOpen = args.get("open") !== "false";
+
+function candidateBaseUrls() {
+  if (args.get("base-url") || process.env.CONTENT_BASE_URL) {
+    return [args.get("base-url") || process.env.CONTENT_BASE_URL];
+  }
+  const urls = [];
+  for (const port of [8080, 8081, 8082, 8083, 8084, 8085, 8090]) {
+    urls.push(`http://127.0.0.1:${port}`);
+  }
+  return urls;
+}
+
+async function postJson(baseUrl, path, body) {
+  const response = await fetch(`${baseUrl}${path}`, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+      "x-request-source": "clips-desktop",
+      origin: baseUrl,
+    },
+    body: JSON.stringify(body),
+  });
+  let data = {};
+  try {
+    data = await response.json();
+  } catch {}
+  return { ok: response.ok, status: response.status, data };
+}
+
+async function findRunningBaseUrl() {
+  for (const baseUrl of candidateBaseUrls()) {
+    try {
+      const response = await fetch(`${baseUrl}/`, { method: "HEAD" });
+      if (response.ok || response.status === 401 || response.status === 405) {
+        return baseUrl;
+      }
+    } catch {}
+  }
+  throw new Error(
+    "Content dev server was not reachable. Start it with `pnpm dev:database`.",
+  );
+}
+
+const baseUrl = await findRunningBaseUrl();
+let login = await postJson(baseUrl, "/_agent-native/auth/login", {
+  email,
+  password,
+});
+
+if (!login.ok) {
+  await postJson(baseUrl, "/_agent-native/auth/register", {
+    email,
+    password,
+    name: email.split("@")[0] || "Demo",
+    callbackURL: "/",
+  });
+  login = await postJson(baseUrl, "/_agent-native/auth/login", {
+    email,
+    password,
+  });
+}
+
+if (!login.ok) {
+  throw new Error(
+    `Demo login failed (${login.status}): ${
+      login.data?.error || login.data?.message || "unknown error"
+    }`,
+  );
+}
+
+const token = login.data?.token;
+const url = token
+  ? `${baseUrl}/?_session=${encodeURIComponent(token)}`
+  : `${baseUrl}/`;
+
+console.log(`[content demo] URL: ${url}`);
+console.log(`[content demo] Email: ${email}`);
+console.log(`[content demo] Password: ${password}`);
+
+if (shouldOpen && process.platform === "darwin") {
+  spawnSync("open", ["-a", "Google Chrome", url], { stdio: "ignore" });
+}

package/corpus/templates/content/server/db/schema.ts

@@ -139,10 +139,37 @@ export const contentDatabaseItems = table("content_database_items", {
   databaseId: text("database_id").notNull(),
   documentId: text("document_id").notNull(),
   position: integer("position").notNull().default(0),
+  bodyHydrationStatus: text("body_hydration_status")
+    .notNull()
+    .default("hydrated"),
+  bodyHydrationAttemptedAt: text("body_hydration_attempted_at"),
+  bodyHydrationError: text("body_hydration_error"),
+  bodyHydrationVersion: text("body_hydration_version"),
   createdAt: text("created_at").notNull().default(now()),
   updatedAt: text("updated_at").notNull().default(now()),
 });
 
+export const contentDatabaseBodyHydrationQueue = table(
+  "content_database_body_hydration_queue",
+  {
+    id: text("id").primaryKey(),
+    ownerEmail: text("owner_email").notNull().default("local@localhost"),
+    orgId: text("org_id"),
+    sourceId: text("source_id").notNull(),
+    databaseItemId: text("database_item_id").notNull(),
+    documentId: text("document_id").notNull(),
+    sourceRowId: text("source_row_id").notNull(),
+    sourceTable: text("source_table").notNull(),
+    sourceEntryJson: text("source_entry_json").notNull().default("{}"),
+    priority: integer("priority").notNull().default(10),
+    attempts: integer("attempts").notNull().default(0),
+    lastAttemptedAt: text("last_attempted_at"),
+    lastError: text("last_error"),
+    createdAt: text("created_at").notNull().default(now()),
+    updatedAt: text("updated_at").notNull().default(now()),
+  },
+);
+
 export const contentDatabaseSources = table("content_database_sources", {
   id: text("id").primaryKey(),
   ownerEmail: text("owner_email").notNull().default("local@localhost"),

package/corpus/templates/content/server/plugins/db.ts

@@ -535,6 +535,39 @@ const runContentMigrations = runMigrations(
       sql: `CREATE INDEX IF NOT EXISTS builder_doc_sidecars_document_idx ON builder_doc_sidecars (document_id);
         CREATE UNIQUE INDEX IF NOT EXISTS builder_doc_sidecars_doc_path_idx ON builder_doc_sidecars (document_id, path)`,
     },
+    {
+      version: 58,
+      sql: `ALTER TABLE content_database_items ADD COLUMN IF NOT EXISTS body_hydration_status TEXT NOT NULL DEFAULT 'hydrated';
+        ALTER TABLE content_database_items ADD COLUMN IF NOT EXISTS body_hydration_attempted_at TEXT;
+        ALTER TABLE content_database_items ADD COLUMN IF NOT EXISTS body_hydration_error TEXT;
+        ALTER TABLE content_database_items ADD COLUMN IF NOT EXISTS body_hydration_version TEXT`,
+    },
+    {
+      version: 59,
+      sql: `CREATE TABLE IF NOT EXISTS content_database_body_hydration_queue (
+      id TEXT PRIMARY KEY,
+      owner_email TEXT NOT NULL DEFAULT 'local@localhost',
+      org_id TEXT,
+      source_id TEXT NOT NULL,
+      database_item_id TEXT NOT NULL,
+      document_id TEXT NOT NULL,
+      source_row_id TEXT NOT NULL,
+      source_table TEXT NOT NULL,
+      source_entry_json TEXT NOT NULL DEFAULT '{}',
+      priority INTEGER NOT NULL DEFAULT 10,
+      attempts INTEGER NOT NULL DEFAULT 0,
+      last_attempted_at TEXT,
+      last_error TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )`,
+    },
+    {
+      version: 60,
+      sql: `CREATE INDEX IF NOT EXISTS content_database_body_hydration_queue_source_idx ON content_database_body_hydration_queue (source_id, priority, created_at);
+        CREATE UNIQUE INDEX IF NOT EXISTS content_database_body_hydration_queue_item_idx ON content_database_body_hydration_queue (database_item_id);
+        CREATE INDEX IF NOT EXISTS content_database_items_body_hydration_idx ON content_database_items (database_id, body_hydration_status)`,
+    },
   ],
   { table: "content_migrations" },
 );