@agent-native/core 0.86.0 → 0.86.1

package/corpus/core/src/server/builder-design-systems.ts

@@ -12,6 +12,68 @@ export interface BuilderDesignSystemIndexFile {
   mimeType?: string;
 }
 
+export interface BuilderDesignSystemCodeFileInput {
+  filename: string;
+  content: string;
+  mimeType?: string;
+}
+
+export interface BuildBuilderDesignSystemIndexFilesOptions {
+  codeFiles?: BuilderDesignSystemCodeFileInput[];
+  designMd?: string;
+  designMdFilename?: string;
+  maxCodeFiles?: number;
+  maxTotalCodeBytes?: number;
+}
+
+export interface BuilderDesignSystemProxyFieldsOptions {
+  result: BuilderDesignSystemIndexResult;
+  projectName?: string;
+  description?: string;
+  surface: "design" | "slides";
+}
+
+export interface BuilderDesignSystemProxyFields {
+  title: string;
+  description: string;
+  data: string;
+  customInstructions: string;
+}
+
+export interface BuilderDesignSystemProxyReference {
+  source: "builder";
+  builderDesignSystemId: string;
+  builderJobId: string;
+  builderProjectId?: string;
+  builderUrl?: string;
+  builderStatus?: string;
+}
+
+export interface BuilderDesignSystemDocsOptions {
+  page?: number;
+  pageSize?: number;
+  minimal?: boolean;
+  type?: string;
+}
+
+export interface BuilderDesignSystemDocument {
+  id?: string;
+  name?: string;
+  type?: string;
+  description?: string;
+  content?: string;
+  tokenValues?: Record<string, string>;
+  rawTokens?: string[];
+  relevantFiles?: string[];
+  relatedComponents?: string[];
+}
+
+export interface BuilderDesignSystemHydratedReference extends BuilderDesignSystemProxyReference {
+  docs: BuilderDesignSystemDocument[];
+  tokenValues: Record<string, string>;
+  docCount: number;
+}
+
 export interface BuilderDesignSystemIndexOptions {
   projectName?: string;
   description?: string;
@@ -49,6 +111,10 @@ interface GenerateResponse {
   designSystemId?: string;
 }
 
+const DEFAULT_MAX_CODE_FILES = 50;
+const DEFAULT_MAX_TOTAL_CODE_BYTES = 2 * 1024 * 1024;
+const MAX_DOC_CONTENT_CHARS = 4_000;
+
 function trimTrailingSlash(value: string): string {
   return value.replace(/\/+$/, "");
 }
@@ -89,6 +155,66 @@ function makeBuilderHeaders(
   };
 }
 
+export function mimeTypeForBuilderDesignSystemFilename(
+  filename: string,
+  explicit?: string,
+): string {
+  if (explicit?.trim()) return explicit.trim();
+  const lower = filename.toLowerCase();
+  if (lower.endsWith(".fig")) return "application/octet-stream";
+  if (lower.endsWith(".pdf")) return "application/pdf";
+  if (lower.endsWith(".md") || lower.endsWith(".markdown"))
+    return "text/markdown";
+  if (lower.endsWith(".mdx")) return "text/markdown";
+  if (lower.endsWith(".json")) return "application/json";
+  if (lower.endsWith(".css")) return "text/css";
+  if (lower.endsWith(".html") || lower.endsWith(".htm")) return "text/html";
+  if (lower.endsWith(".svg")) return "image/svg+xml";
+  return "text/plain";
+}
+
+export function buildBuilderDesignSystemIndexFiles({
+  codeFiles,
+  designMd,
+  designMdFilename,
+  maxCodeFiles = DEFAULT_MAX_CODE_FILES,
+  maxTotalCodeBytes = DEFAULT_MAX_TOTAL_CODE_BYTES,
+}: BuildBuilderDesignSystemIndexFilesOptions): BuilderDesignSystemIndexFile[] {
+  const encoder = new TextEncoder();
+  const files: BuilderDesignSystemIndexFile[] = [];
+  let totalBytes = 0;
+
+  function pushTextFile(filename: string, content: string, mimeType?: string) {
+    const normalizedName = filename.replace(/^\/+/, "") || "code.txt";
+    const data = encoder.encode(content);
+    if (data.byteLength === 0) return;
+    if (totalBytes + data.byteLength > maxTotalCodeBytes) return;
+    totalBytes += data.byteLength;
+    files.push({
+      name: normalizedName,
+      data,
+      mimeType: mimeTypeForBuilderDesignSystemFilename(
+        normalizedName,
+        mimeType,
+      ),
+    });
+  }
+
+  if (designMd?.trim()) {
+    pushTextFile(
+      designMdFilename?.trim() || "design.md",
+      designMd,
+      "text/markdown",
+    );
+  }
+
+  for (const file of (codeFiles ?? []).slice(0, maxCodeFiles)) {
+    pushTextFile(file.filename, file.content, file.mimeType);
+  }
+
+  return files;
+}
+
 async function resolveBuilderDesignSystemCredentials(): Promise<BuilderDesignSystemCredentials> {
   const credentials = await resolveBuilderCredentials();
   if (!credentials.privateKey || !credentials.publicKey) {
@@ -107,15 +233,7 @@ async function resolveBuilderDesignSystemCredentials(): Promise<BuilderDesignSys
 }
 
 function mimeTypeForFile(file: BuilderDesignSystemIndexFile): string {
-  if (file.mimeType?.trim()) return file.mimeType.trim();
-  const lower = file.name.toLowerCase();
-  if (lower.endsWith(".fig")) return "application/octet-stream";
-  if (lower.endsWith(".pdf")) return "application/pdf";
-  if (lower.endsWith(".md") || lower.endsWith(".markdown"))
-    return "text/markdown";
-  if (lower.endsWith(".json")) return "application/json";
-  if (lower.endsWith(".css")) return "text/css";
-  return "text/plain";
+  return mimeTypeForBuilderDesignSystemFilename(file.name, file.mimeType);
 }
 
 function makeBody(bytes: Uint8Array, mimeType: string): BodyInit {
@@ -204,6 +322,207 @@ export function builderDesignSystemUrl(designSystemId?: string | null): string {
     : `${host}/app/design-system-intelligence`;
 }
 
+export function localBuilderDesignSystemId(
+  builderDesignSystemId: string,
+): string {
+  const slug = builderDesignSystemId
+    .replace(/[^a-zA-Z0-9_-]+/g, "-")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 96);
+  return `builder-${slug || "design-system"}`;
+}
+
+export function createBuilderDesignSystemProxyFields({
+  result,
+  projectName,
+  description,
+  surface,
+}: BuilderDesignSystemProxyFieldsOptions): BuilderDesignSystemProxyFields {
+  const title = projectName?.trim() || "Builder indexed design system";
+  const fallbackDescription =
+    description ?? `Builder indexed design system ${result.designSystemId}`;
+  const surfaceNoun = surface === "slides" ? "slides" : "designs";
+  const spacingKey = surface === "slides" ? "slidePadding" : "pagePadding";
+  const data = JSON.stringify({
+    source: "builder",
+    builderDesignSystemId: result.designSystemId,
+    builderJobId: result.jobId,
+    builderProjectId: result.projectId,
+    builderUrl: result.builderUrl,
+    builderStatus: result.status,
+    colors: {
+      primary: "var(--primary)",
+      secondary: "var(--secondary)",
+      accent: "var(--accent)",
+      background: "var(--background)",
+      surface: "var(--card)",
+      text: "var(--foreground)",
+      textMuted: "var(--muted-foreground)",
+    },
+    typography: {
+      headingFont: "inherit",
+      bodyFont: "inherit",
+      headingWeight: "700",
+      bodyWeight: "400",
+      headingSizes: { h1: "48px", h2: "32px", h3: "24px" },
+    },
+    spacing: { elementGap: "24px", [spacingKey]: "48px" },
+    borders: { radius: "12px", accentWidth: "1px" },
+    logos: [],
+    notes: [
+      "This is a local selectable proxy for a Builder DSI-indexed design system.",
+      `Builder design system id: ${result.designSystemId}`,
+      `Builder indexing job id: ${result.jobId}`,
+      `Builder project id: ${result.projectId}`,
+      `Builder URL: ${result.builderUrl}`,
+      projectName ? `Requested name: ${projectName}` : "",
+      description ? `Context: ${description}` : "",
+      "Builder Design System Intelligence is the source of truth for extracted tokens, components, assets, and usage guidance.",
+    ]
+      .filter(Boolean)
+      .join("\n"),
+  });
+  const customInstructions = [
+    "This design system is indexed by Builder Design System Intelligence (DSI).",
+    `Builder design system id: ${result.designSystemId}`,
+    `Builder job id: ${result.jobId}`,
+    `Builder project id: ${result.projectId}`,
+    `Builder URL: ${result.builderUrl}`,
+    `When generating ${surfaceNoun}, treat Builder DSI as the source of truth for extracted tokens, components, assets, and usage guidance.`,
+    "Call get-design-system for this local id before generation and use the returned builder docs and token values when available.",
+  ].join("\n");
+
+  return {
+    title,
+    description: fallbackDescription,
+    data,
+    customInstructions,
+  };
+}
+
+export function parseBuilderDesignSystemProxyReference(
+  data: unknown,
+): BuilderDesignSystemProxyReference | null {
+  let parsed: unknown = data;
+  if (typeof data === "string") {
+    try {
+      parsed = JSON.parse(data);
+    } catch {
+      return null;
+    }
+  }
+  if (!parsed || typeof parsed !== "object") return null;
+  const value = parsed as Record<string, unknown>;
+  if (value.source !== "builder") return null;
+  if (typeof value.builderDesignSystemId !== "string") return null;
+  if (typeof value.builderJobId !== "string") return null;
+  return {
+    source: "builder",
+    builderDesignSystemId: value.builderDesignSystemId,
+    builderJobId: value.builderJobId,
+    builderProjectId:
+      typeof value.builderProjectId === "string"
+        ? value.builderProjectId
+        : undefined,
+    builderUrl:
+      typeof value.builderUrl === "string" ? value.builderUrl : undefined,
+    builderStatus:
+      typeof value.builderStatus === "string" ? value.builderStatus : undefined,
+  };
+}
+
+function truncateDocContent(content: unknown): string | undefined {
+  if (typeof content !== "string") return undefined;
+  if (content.length <= MAX_DOC_CONTENT_CHARS) return content;
+  return `${content.slice(0, MAX_DOC_CONTENT_CHARS)}\n\n[truncated]`;
+}
+
+function normalizeBuilderDesignSystemDocument(
+  value: unknown,
+): BuilderDesignSystemDocument {
+  const doc =
+    value && typeof value === "object"
+      ? (value as Record<string, unknown>)
+      : {};
+  return {
+    id: typeof doc.id === "string" ? doc.id : undefined,
+    name: typeof doc.name === "string" ? doc.name : undefined,
+    type: typeof doc.type === "string" ? doc.type : undefined,
+    description:
+      typeof doc.description === "string" ? doc.description : undefined,
+    content: truncateDocContent(doc.content),
+    tokenValues:
+      doc.tokenValues && typeof doc.tokenValues === "object"
+        ? (doc.tokenValues as Record<string, string>)
+        : undefined,
+    rawTokens: Array.isArray(doc.rawTokens)
+      ? doc.rawTokens.filter(
+          (token): token is string => typeof token === "string",
+        )
+      : undefined,
+    relevantFiles: Array.isArray(doc.relevantFiles)
+      ? doc.relevantFiles.filter(
+          (file): file is string => typeof file === "string",
+        )
+      : undefined,
+    relatedComponents: Array.isArray(doc.relatedComponents)
+      ? doc.relatedComponents.filter(
+          (component): component is string => typeof component === "string",
+        )
+      : undefined,
+  };
+}
+
+export async function fetchBuilderDesignSystemDocs(
+  designSystemId: string,
+  options: BuilderDesignSystemDocsOptions = {},
+): Promise<BuilderDesignSystemDocument[]> {
+  const credentials = await resolveBuilderDesignSystemCredentials();
+  const url = makeBuilderDesignSystemUrl(
+    `${encodeURIComponent(designSystemId)}/docs`,
+    credentials,
+  );
+  if (options.page !== undefined)
+    url.searchParams.set("page", String(options.page));
+  if (options.pageSize !== undefined)
+    url.searchParams.set("pageSize", String(options.pageSize));
+  if (options.minimal !== undefined)
+    url.searchParams.set("minimal", options.minimal ? "true" : "false");
+  if (options.type?.trim()) url.searchParams.set("type", options.type.trim());
+
+  const response = await fetchWithTimeout(url, {
+    method: "GET",
+    headers: makeBuilderHeaders(credentials),
+  });
+  await assertOk(response, "Builder design-system docs fetch failed");
+  const json = (await response.json()) as unknown;
+  if (!Array.isArray(json)) return [];
+  return json.map(normalizeBuilderDesignSystemDocument);
+}
+
+export async function hydrateBuilderDesignSystemReference(
+  reference: BuilderDesignSystemProxyReference,
+  options: BuilderDesignSystemDocsOptions = { page: 0, pageSize: 40 },
+): Promise<BuilderDesignSystemHydratedReference> {
+  const docs = await fetchBuilderDesignSystemDocs(
+    reference.builderDesignSystemId,
+    options,
+  );
+  const tokenValues: Record<string, string> = {};
+  for (const doc of docs) {
+    if (!doc.tokenValues) continue;
+    for (const [name, value] of Object.entries(doc.tokenValues)) {
+      if (typeof value === "string") tokenValues[name] = value;
+    }
+  }
+  return {
+    ...reference,
+    docs,
+    tokenValues,
+    docCount: docs.length,
+  };
+}
+
 export async function startBuilderDesignSystemIndex(
   options: BuilderDesignSystemIndexOptions,
 ): Promise<BuilderDesignSystemIndexResult> {

package/corpus/core/src/server/index.ts

@@ -388,11 +388,26 @@ export {
 } from "./credential-provider.js";
 export {
   builderDesignSystemUrl,
+  buildBuilderDesignSystemIndexFiles,
+  createBuilderDesignSystemProxyFields,
+  fetchBuilderDesignSystemDocs,
   getBuilderDesignSystemsBaseUrl,
+  hydrateBuilderDesignSystemReference,
+  localBuilderDesignSystemId,
+  mimeTypeForBuilderDesignSystemFilename,
+  parseBuilderDesignSystemProxyReference,
   startBuilderDesignSystemIndex,
+  type BuildBuilderDesignSystemIndexFilesOptions,
+  type BuilderDesignSystemCodeFileInput,
+  type BuilderDesignSystemDocsOptions,
+  type BuilderDesignSystemDocument,
+  type BuilderDesignSystemHydratedReference,
   type BuilderDesignSystemIndexFile,
   type BuilderDesignSystemIndexOptions,
   type BuilderDesignSystemIndexResult,
+  type BuilderDesignSystemProxyFields,
+  type BuilderDesignSystemProxyFieldsOptions,
+  type BuilderDesignSystemProxyReference,
 } from "./builder-design-systems.js";
 export {
   getBuilderBranchProjectId,

package/corpus/core/src/templates/default/app/root.tsx

@@ -1,6 +1,7 @@
 import { useDbSync } from "@agent-native/core/client";
 import {
   AppProviders,
+  ErrorReportActions,
   appPath,
   getLocaleInitScript,
   getThemeInitScript,
@@ -66,6 +67,9 @@ const ERROR_COPY = {
       "This page doesn't exist. It may have been moved or deleted.",
     statusTitle: (status: number) => `${status} Error`,
     goHome: "Go home",
+    sendFeedback: "Send feedback",
+    feedbackPlaceholder: "Describe what happened before this error appeared.",
+    openGitHubIssue: "Open GitHub issue",
   },
   "zh-CN": {
     genericTitle: "出了点问题",
@@ -74,6 +78,9 @@ const ERROR_COPY = {
     notFoundDetails: "此页面不存在。它可能已被移动或删除。",
     statusTitle: (status: number) => `${status} 错误`,
     goHome: "返回首页",
+    sendFeedback: "发送反馈",
+    feedbackPlaceholder: "描述此错误出现前发生了什么。",
+    openGitHubIssue: "打开 GitHub issue",
   },
   "zh-TW": {
     genericTitle: "發生錯誤",
@@ -82,6 +89,9 @@ const ERROR_COPY = {
     notFoundDetails: "此頁面不存在，可能已被移動或刪除。",
     statusTitle: (status: number) => `${status} 錯誤`,
     goHome: "返回首頁",
+    sendFeedback: "傳送意見回饋",
+    feedbackPlaceholder: "描述此錯誤出現前發生了什麼。",
+    openGitHubIssue: "開啟 GitHub issue",
   },
   "es-ES": {
     genericTitle: "Algo salió mal",
@@ -91,6 +101,10 @@ const ERROR_COPY = {
       "Esta página no existe. Puede que se haya movido o eliminado.",
     statusTitle: (status: number) => `Error ${status}`,
     goHome: "Ir al inicio",
+    sendFeedback: "Enviar comentarios",
+    feedbackPlaceholder:
+      "Describe qué pasó antes de que apareciera este error.",
+    openGitHubIssue: "Abrir issue en GitHub",
   },
   "fr-FR": {
     genericTitle: "Une erreur est survenue",
@@ -100,6 +114,9 @@ const ERROR_COPY = {
       "Cette page n'existe pas. Elle a peut-être été déplacée ou supprimée.",
     statusTitle: (status: number) => `Erreur ${status}`,
     goHome: "Retour à l'accueil",
+    sendFeedback: "Envoyer un retour",
+    feedbackPlaceholder: "Décrivez ce qui s'est passé avant cette erreur.",
+    openGitHubIssue: "Ouvrir une issue GitHub",
   },
   "de-DE": {
     genericTitle: "Etwas ist schiefgelaufen",
@@ -109,6 +126,9 @@ const ERROR_COPY = {
       "Diese Seite existiert nicht. Sie wurde möglicherweise verschoben oder gelöscht.",
     statusTitle: (status: number) => `${status} Fehler`,
     goHome: "Zur Startseite",
+    sendFeedback: "Feedback senden",
+    feedbackPlaceholder: "Beschreiben Sie, was vor diesem Fehler passiert ist.",
+    openGitHubIssue: "GitHub-Issue öffnen",
   },
   "ja-JP": {
     genericTitle: "問題が発生しました",
@@ -118,6 +138,9 @@ const ERROR_COPY = {
       "このページは存在しません。移動または削除された可能性があります。",
     statusTitle: (status: number) => `${status} エラー`,
     goHome: "ホームへ",
+    sendFeedback: "フィードバックを送信",
+    feedbackPlaceholder: "このエラーの直前に起きたことを説明してください。",
+    openGitHubIssue: "GitHub issue を開く",
   },
   "ko-KR": {
     genericTitle: "문제가 발생했습니다",
@@ -127,6 +150,10 @@ const ERROR_COPY = {
       "이 페이지는 존재하지 않습니다. 이동되었거나 삭제되었을 수 있습니다.",
     statusTitle: (status: number) => `${status} 오류`,
     goHome: "홈으로 이동",
+    sendFeedback: "피드백 보내기",
+    feedbackPlaceholder:
+      "이 오류가 나타나기 전에 무슨 일이 있었는지 적어 주세요.",
+    openGitHubIssue: "GitHub issue 열기",
   },
   "pt-BR": {
     genericTitle: "Algo deu errado",
@@ -136,6 +163,9 @@ const ERROR_COPY = {
       "Esta página não existe. Ela pode ter sido movida ou excluída.",
     statusTitle: (status: number) => `Erro ${status}`,
     goHome: "Ir para o início",
+    sendFeedback: "Enviar feedback",
+    feedbackPlaceholder: "Descreva o que aconteceu antes deste erro aparecer.",
+    openGitHubIssue: "Abrir issue no GitHub",
   },
   "hi-IN": {
     genericTitle: "कुछ गलत हुआ",
@@ -144,6 +174,9 @@ const ERROR_COPY = {
     notFoundDetails: "यह पेज मौजूद नहीं है। इसे स्थानांतरित या हटाया गया हो सकता है।",
     statusTitle: (status: number) => `${status} त्रुटि`,
     goHome: "होम जाएं",
+    sendFeedback: "फ़ीडबैक भेजें",
+    feedbackPlaceholder: "इस त्रुटि से पहले क्या हुआ, उसका वर्णन करें।",
+    openGitHubIssue: "GitHub issue खोलें",
   },
   "ar-SA": {
     genericTitle: "حدث خطأ",
@@ -152,6 +185,9 @@ const ERROR_COPY = {
     notFoundDetails: "هذه الصفحة غير موجودة. ربما تم نقلها أو حذفها.",
     statusTitle: (status: number) => `خطأ ${status}`,
     goHome: "الذهاب إلى الرئيسية",
+    sendFeedback: "إرسال الملاحظات",
+    feedbackPlaceholder: "صف ما حدث قبل ظهور هذا الخطأ.",
+    openGitHubIssue: "فتح مشكلة في GitHub",
   },
 };
 
@@ -285,6 +321,17 @@ export function ErrorBoundary() {
         >
           {copy.goHome}
         </Link>
+        <ErrorReportActions
+          appName="Agent Native"
+          title={title}
+          details={details}
+          status={status}
+          issueTitle={`Error screen: ${title}`}
+          feedbackLabel={copy.sendFeedback}
+          feedbackPlaceholder={copy.feedbackPlaceholder}
+          githubLabel={copy.openGitHubIssue}
+          className="mt-4"
+        />
         {stack && (
           <pre className="mt-6 w-full text-left text-xs overflow-auto p-4 bg-muted rounded">
             <code>{stack}</code>

package/corpus/templates/analytics/AGENTS.md

@@ -86,8 +86,10 @@ details live in `.agents/skills/`.
 - `/agents` is the Analytics home for core agent-admin surfaces. The default
   Monitoring view embeds the shared observability dashboard for traces,
   conversations, evals, experiments, and feedback. The Advanced menu opens
-  `/agents?view=database`, which embeds the shared Code-mode database admin
-  tool for table browsing, row editing, and SQL inspection. Keep future
+  `/agents?view=database`, where organization owners/admins can connect other
+  agent-native app databases and use the shared database admin tool for table
+  browsing, row editing, and SQL inspection. This surface is for connected
+  target app databases, not broad access to all Analytics data. Keep future
   agent-admin additions inside this route instead of adding many top-level
   sidebar tabs.
 - For dashboard edits, default to `mutate-dashboard` with its typed
@@ -156,8 +158,8 @@ details live in `.agents/skills/`.
   context.
 - `navigate` moves the user to the relevant analytics view, including
   `view="catalog"` for the template catalog, `view="sessions"` for session
-  replay, and `view="agents"` / `agentsView="database"` for agent monitoring
-  or advanced database admin.
+  replay, and `view="agents"` / `agentsView="database"` with optional
+  `dbAdminConnectionId` for agent monitoring or connected app database admin.
 - Use `view-screen` when the active dashboard/chart context is unclear.
 
 ## Session Replay

package/corpus/templates/analytics/actions/delete-db-admin-connection.ts

@@ -0,0 +1,19 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import {
+  deleteDbAdminConnection,
+  requireDbAdminContextFromRequest,
+} from "../server/lib/db-admin-connections";
+
+export default defineAction({
+  description:
+    "Remove a connected agent-native app database from the Analytics DB admin surface and delete its encrypted connection secrets. Requires active organization owner/admin role.",
+  schema: z.object({
+    id: z.string().min(1).describe("Connection id to remove."),
+  }),
+  run: async ({ id }, ctx) => {
+    const admin = await requireDbAdminContextFromRequest(ctx);
+    return deleteDbAdminConnection(admin, id);
+  },
+});

package/corpus/templates/analytics/actions/list-db-admin-connections.ts

@@ -0,0 +1,18 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import {
+  listDbAdminConnections,
+  requireDbAdminContextFromRequest,
+} from "../server/lib/db-admin-connections";
+
+export default defineAction({
+  description:
+    "List admin-only connected agent-native app databases available in Analytics DB admin. Requires the caller to be an owner or admin of the active organization.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async (_args, ctx) => {
+    const admin = await requireDbAdminContextFromRequest(ctx);
+    return listDbAdminConnections(admin);
+  },
+});

package/corpus/templates/analytics/actions/navigate.ts

@@ -31,7 +31,13 @@ export default defineAction({
     agentsView: z
       .enum(["monitoring", "database"])
       .optional()
-      .describe("Agents subview to open (monitoring or database)"),
+      .describe("Agents subview to open (monitoring or app databases)"),
+    dbAdminConnectionId: z
+      .string()
+      .optional()
+      .describe(
+        "Connected app database id to select when navigating to agentsView=database",
+      ),
   }),
   http: false,
   run: async (args) => {
@@ -41,10 +47,11 @@ export default defineAction({
       !args.analysisId &&
       !args.extensionId &&
       !args.recordingId &&
-      !args.agentsView
+      !args.agentsView &&
+      !args.dbAdminConnectionId
     ) {
       throw new Error(
-        "At least --view, --dashboardId, --analysisId, --extensionId, --recordingId, or --agentsView is required.",
+        "At least --view, --dashboardId, --analysisId, --extensionId, --recordingId, --agentsView, or --dbAdminConnectionId is required.",
       );
     }
     const nav: Record<string, string> = {};
@@ -69,6 +76,11 @@ export default defineAction({
       nav.agentsView = args.agentsView;
       if (!args.view) nav.view = "agents";
     }
+    if (args.dbAdminConnectionId) {
+      nav.dbAdminConnectionId = args.dbAdminConnectionId;
+      nav.agentsView = "database";
+      if (!args.view) nav.view = "agents";
+    }
     await writeAppState("navigate", nav);
 
     const parts: string[] = [];
@@ -78,6 +90,8 @@ export default defineAction({
     if (nav.extensionId) parts.push(`extension:${nav.extensionId}`);
     if (nav.recordingId) parts.push(`recording:${nav.recordingId}`);
     if (nav.agentsView) parts.push(`agents:${nav.agentsView}`);
+    if (nav.dbAdminConnectionId)
+      parts.push(`db-admin:${nav.dbAdminConnectionId}`);
     return `Navigating to ${parts.join(" ")}`;
   },
 });

package/corpus/templates/analytics/actions/save-db-admin-connection.ts

@@ -0,0 +1,33 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import {
+  requireDbAdminContextFromRequest,
+  saveDbAdminConnection,
+} from "../server/lib/db-admin-connections";
+
+export default defineAction({
+  description:
+    "Create or update an admin-only connected agent-native app database for the Analytics DB admin surface. Requires active organization owner/admin role. Secret values are encrypted and are not returned.",
+  schema: z.object({
+    id: z.string().optional().describe("Existing connection id to update."),
+    name: z.string().min(1).describe("Human-readable app or agent name."),
+    appId: z.string().optional().describe("Optional app id, such as plan."),
+    appUrl: z
+      .string()
+      .optional()
+      .describe("Optional URL for the connected app."),
+    databaseUrl: z
+      .string()
+      .min(1)
+      .describe("Postgres, PostgreSQL, or libSQL database URL."),
+    databaseAuthToken: z
+      .string()
+      .optional()
+      .describe("Optional libSQL/Turso auth token. Leave empty for Postgres."),
+  }),
+  run: async (args, ctx) => {
+    const admin = await requireDbAdminContextFromRequest(ctx);
+    return saveDbAdminConnection(admin, args);
+  },
+});