@agent-native/core 0.85.7 → 0.86.1

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

@@ -4,13 +4,13 @@ import { z } from "zod";
 
 export default defineAction({
   description:
-    "Navigate the UI to a specific view, dashboard, analysis, extension, or Analytics session recording. For filter changes (dashboard filter query params like ?f_date=... or session filters like ?range=30d&q=signup), use the framework-level `set-search-params` tool instead of this action.",
+    "Navigate the UI to a specific view, dashboard, analysis, extension, Analytics session recording, or Analytics agent-admin surface. For filter changes (dashboard filter query params like ?f_date=... or session filters like ?range=30d&q=signup), use the framework-level `set-search-params` tool instead of this action.",
   schema: z.object({
     view: z
       .string()
       .optional()
       .describe(
-        "View to navigate to (ask, adhoc, analyses, extensions, sessions, catalog, data-dictionary, data-sources, settings)",
+        "View to navigate to (ask, adhoc, analyses, extensions, sessions, agents, catalog, data-dictionary, data-sources, settings)",
       ),
     dashboardId: z
       .string()
@@ -28,6 +28,16 @@ export default defineAction({
       .string()
       .optional()
       .describe("Session recording id to open (used with view=sessions)"),
+    agentsView: z
+      .enum(["monitoring", "database"])
+      .optional()
+      .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) => {
@@ -36,10 +46,12 @@ export default defineAction({
       !args.dashboardId &&
       !args.analysisId &&
       !args.extensionId &&
-      !args.recordingId
+      !args.recordingId &&
+      !args.agentsView &&
+      !args.dbAdminConnectionId
     ) {
       throw new Error(
-        "At least --view, --dashboardId, --analysisId, --extensionId, or --recordingId is required.",
+        "At least --view, --dashboardId, --analysisId, --extensionId, --recordingId, --agentsView, or --dbAdminConnectionId is required.",
       );
     }
     const nav: Record<string, string> = {};
@@ -60,6 +72,15 @@ export default defineAction({
       nav.recordingId = args.recordingId;
       if (!args.view) nav.view = "sessions";
     }
+    if (args.agentsView) {
+      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[] = [];
@@ -68,6 +89,9 @@ export default defineAction({
     if (nav.analysisId) parts.push(`analysis:${nav.analysisId}`);
     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/query-agent-native-analytics.ts

@@ -15,7 +15,7 @@ function resolveScope() {
 
 export default defineAction({
   description:
-    "Query first-party analytics events recorded through this app's analytics collector endpoint (/track) and session replay summaries recorded through /api/analytics/replay. Use this for questions about app/site traffic, product events, template/app usage, conversions, session recordings, and other first-party data collected by this analytics app. Use source-specific actions such as BigQuery, GA4, Mixpanel, PostHog, or Amplitude when the user asks for those sources or the relevant data lives there. SQL may read analytics_events and session_recordings only; session_replay_chunks is intentionally unavailable, and reads are automatically scoped to the current user/org. analytics_events columns include event_name, timestamp, event_date, user_id, anonymous_id, user_key, session_id, app, template, signed_in, url, path, hostname, referrer, properties, and context. session_recordings columns include id, session_id, user_id, anonymous_id, user_key, started_at, ended_at, duration_ms, chunk_count, event_count, page_count, error_count, rage_click_count, app, template, status, first_url, last_url, path, hostname, referrer, and metadata.",
+    "Query first-party analytics events recorded through this app's analytics collector endpoint (/track) and session replay summaries recorded through /api/analytics/replay. Use this for questions about app/site traffic, product events, template/app usage, conversions, session recordings, LLM/agent observability, model cost, token volume, latency, and other first-party data collected by this analytics app. Use source-specific actions such as BigQuery, GA4, Mixpanel, PostHog, or Amplitude when the user asks for those sources or the relevant data lives there. SQL may read analytics_events and session_recordings only; session_replay_chunks is intentionally unavailable, and reads are automatically scoped to the current user/org. analytics_events columns include event_name, timestamp, event_date, user_id, anonymous_id, user_key, session_id, app, template, signed_in, url, path, hostname, referrer, properties, and context. LLM observability events use event_name = '$ai_generation'; useful properties include $ai_trace_id/run_id, $ai_session_id/thread_id, $ai_model/model, $ai_provider/provider, $ai_input_tokens/input_tokens, $ai_output_tokens/output_tokens, cache_read_tokens, cache_write_tokens, cost_cents_x100, $ai_total_cost_usd/cost_usd, duration_ms/$ai_latency, status, tool_calls, successful_tools, failed_tools, and error_message/$ai_error. session_recordings columns include id, session_id, user_id, anonymous_id, user_key, started_at, ended_at, duration_ms, chunk_count, event_count, page_count, error_count, rage_click_count, app, template, status, first_url, last_url, path, hostname, referrer, and metadata.",
   schema: z.object({
     sql: z
       .string()

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);
+  },
+});

package/corpus/templates/analytics/actions/view-screen.ts

@@ -194,6 +194,71 @@ export default defineAction({
           ),
         }));
       }
+    } else if (nav?.view === "agents") {
+      screen.page = "agents";
+      screen.agentsView = nav?.agentsView || "monitoring";
+      if (nav?.dbAdminConnectionId) {
+        screen.dbAdminConnectionId = nav.dbAdminConnectionId;
+      }
+      screen.agentAdminSurfaces = [
+        {
+          id: "monitoring",
+          label: "Monitoring",
+          path: "/agents",
+          includes: [
+            "agent traces",
+            "agent conversations",
+            "eval results",
+            "experiments",
+            "feedback",
+          ],
+        },
+        {
+          id: "database",
+          label: "App Databases",
+          path: "/agents?view=database",
+          advanced: true,
+          adminOnly: true,
+          includes: [
+            "connected agent-native app databases",
+            "table browser",
+            "row editor",
+            "SQL editor",
+          ],
+        },
+      ];
+      const email = getRequestUserEmail();
+      if (email) {
+        const orgId = getRequestOrgId() || null;
+        const [keys, catalog] = await Promise.all([
+          listAnalyticsPublicKeys({
+            userEmail: email,
+            orgId,
+          }),
+          listDashboardCatalog({
+            email,
+            orgId,
+          }),
+        ]);
+        const llmTemplate = catalog.find(
+          (template) => template.id === "agent-observability-llm",
+        );
+        screen.firstPartyAnalytics = {
+          activeKeys: keys.filter((key: any) => !key.revokedAt).length,
+          serverEnv: "AGENT_NATIVE_ANALYTICS_PUBLIC_KEY",
+          browserEnv: "VITE_AGENT_NATIVE_ANALYTICS_PUBLIC_KEY",
+        };
+        if (llmTemplate) {
+          screen.llmObservabilityDashboard = {
+            templateId: llmTemplate.id,
+            name: llmTemplate.name,
+            installed: llmTemplate.installed,
+            installedDashboardIds: llmTemplate.installedDashboards.map(
+              (dashboard) => dashboard.id,
+            ),
+          };
+        }
+      }
     } else if (nav?.view === "settings") {
       screen.page = "settings";
       const email = getRequestUserEmail();

package/corpus/templates/analytics/app/components/layout/CommandPalette.tsx

@@ -62,15 +62,33 @@ interface ExtensionSearchItem {
 }
 
 const defaultTools = [
+  {
+    id: "agents",
+    nameKey: "navigation.agents",
+    href: "/agents",
+    keywords: [
+      "agent monitoring",
+      "observability",
+      "evals",
+      "experiments",
+      "feedback",
+      "database",
+      "db admin",
+      "ab testing",
+      "llm",
+    ],
+  },
   {
     id: "explorer",
     nameKey: "commandPalette.toolExplorer",
     href: "/dashboards/explorer",
+    keywords: [],
   },
   {
     id: "customer-health",
     nameKey: "commandPalette.toolCustomerHealth",
     href: "/dashboards/customer-health",
+    keywords: [],
   },
 ];
 
@@ -414,7 +432,11 @@ export function CommandPalette() {
               <CommandItem
                 key={`tool-${tool.id}`}
                 onSelect={() => go(tool.href)}
-                keywords={commandPaletteKeywords(t(tool.nameKey), "tool")}
+                keywords={commandPaletteKeywords(
+                  t(tool.nameKey),
+                  "tool",
+                  ...tool.keywords,
+                )}
               >
                 <IconTool className="me-2 h-4 w-4 text-muted-foreground" />
                 {t(tool.nameKey)}

package/corpus/templates/analytics/app/components/layout/Header.tsx

@@ -20,6 +20,7 @@ const pageTitleKeys: Record<string, string> = {
   "/catalog": "navigation.templateCatalog",
   "/analyses": "navigation.analyses",
   "/sessions": "navigation.sessions",
+  "/agents": "navigation.agents",
   "/dashboards/explorer": "navigation.explorer",
   "/settings": "navigation.settings",
 };

package/corpus/templates/analytics/app/components/layout/Sidebar.tsx

@@ -14,6 +14,7 @@ import {
   IconReportAnalytics,
   IconSearch,
   IconArchive,
+  IconActivity,
   IconPin,
   IconPlus,
   IconBuilding,
@@ -2281,6 +2282,12 @@ export function Sidebar({ mobile }: { mobile?: boolean } = {}) {
       href: "/sessions",
       active: location.pathname.startsWith("/sessions"),
     },
+    {
+      icon: IconActivity,
+      label: t("navigation.agents"),
+      href: "/agents",
+      active: location.pathname.startsWith("/agents"),
+    },
     {
       icon: IconDatabase,
       label: t("navigation.dataSources"),
@@ -2458,6 +2465,20 @@ export function Sidebar({ mobile }: { mobile?: boolean } = {}) {
                 {t("navigation.sessions")}
               </Link>
 
+              {/* Agents link */}
+              <Link
+                to="/agents"
+                className={cn(
+                  "flex items-center gap-3 rounded-lg px-3 py-2 transition-all hover:text-primary",
+                  location.pathname.startsWith("/agents")
+                    ? "bg-sidebar-accent text-sidebar-accent-foreground"
+                    : "text-muted-foreground hover:bg-sidebar-accent/50",
+                )}
+              >
+                <IconActivity className="h-4 w-4" />
+                {t("navigation.agents")}
+              </Link>
+
               {/* Data Sources link */}
               <Link
                 to="/data-sources"

package/corpus/templates/analytics/app/hooks/use-navigation-state.ts

@@ -17,6 +17,8 @@ interface NavigationState {
   analysisId?: string;
   extensionId?: string;
   recordingId?: string;
+  agentsView?: string;
+  dbAdminConnectionId?: string;
   filters?: Record<string, string>;
 }
 
@@ -72,6 +74,14 @@ export function useNavigationState() {
           state.recordingId = decodeURIComponent(match[1]);
         }
         state.filters = sessionFilters(searchParams);
+      } else if (pathname === "/agents") {
+        state.view = "agents";
+        state.agentsView = searchParams.get("view") || "monitoring";
+        if (state.agentsView === "database") {
+          const dbAdminConnectionId = searchParams.get("db");
+          if (dbAdminConnectionId)
+            state.dbAdminConnectionId = dbAdminConnectionId;
+        }
       } else if (pathname === "/data-sources") {
         state.view = "data-sources";
       } else if (pathname === "/data-dictionary") {
@@ -96,6 +106,12 @@ export function useNavigationState() {
       if (cmd.view === "sessions" && cmd.recordingId)
         return `/sessions/${encodeURIComponent(cmd.recordingId)}`;
       if (cmd.view === "sessions") return "/sessions";
+      if (cmd.view === "agents" && cmd.agentsView === "database") {
+        const params = new URLSearchParams({ view: "database" });
+        if (cmd.dbAdminConnectionId) params.set("db", cmd.dbAdminConnectionId);
+        return `/agents?${params.toString()}`;
+      }
+      if (cmd.view === "agents") return "/agents";
       if (cmd.view === "data-sources") return "/data-sources";
       if (cmd.view === "data-dictionary") return "/data-dictionary";
       if (cmd.view === "catalog") return "/catalog";

package/corpus/templates/analytics/app/i18n/zh-TW.ts

@@ -10,6 +10,7 @@ const messages = {
     dataSources: "資料來源",
     dataDictionary: "資料字典",
     sessions: "工作階段",
+    agents: "代理",
     templateCatalog: "目錄",
     dashboards: "儀表板",
     analyses: "分析",
@@ -419,7 +420,7 @@ const messages = {
       "例如，“新增 Salesforce 整合，以便我可以查詢 CRM 資料”",
     firstPartyAnalytics: "第一方 Analytics",
     firstPartyDescription:
-      "在第一方端點接收產品事件並將其作為儀表板資料來源進行查詢。",
+      "透過同一個第一方端點接收產品、工作階段與 $ai_generation 事件，用於儀表板和 LLM 可觀測性。",
     defaultKeyName: "託管範本",
     endpoint: "端點",
     serverEnv: "伺服器環境",
@@ -567,6 +568,7 @@ const messages = {
     dataDictionary: "資料字典 - Analytics",
     dataSources: "資料來源 - Analytics",
     sessions: "工作階段 - Analytics",
+    agents: "代理 - Analytics",
     session: "工作階段回放 - Analytics",
     tool: "工具 - Analytics",
     extensions: "擴充功能 - Analytics",
@@ -579,6 +581,38 @@ const messages = {
     sameOriginEmbedsOnly: "僅允許同來源嵌入路徑。",
     embeddedContent: "嵌入內容",
   },
+  agents: {
+    title: "代理",
+    description:
+      "監控代理執行、評估、實驗、回饋，以及只有管理員可檢查的已連接應用程式資料庫。",
+    monitoring: "監控",
+    monitoringDescription:
+      "核心可觀測性集中在這裡：執行、追蹤、評估、實驗與回饋。若需要第一方 token、延遲與成本圖表，請從目錄安裝 LLM 可觀測性儀表板。",
+    advanced: "進階",
+    database: "應用程式資料庫",
+    openCatalog: "開啟目錄",
+    dbConnectionsTitle: "已連接的應用程式資料庫",
+    dbConnectionsDescription:
+      "連接其他 agent-native 應用程式資料庫，供管理員檢查與修復。這不會把 Analytics 資料開放給所有使用者。",
+    selectConnection: "選擇資料庫",
+    connectDatabase: "連接資料庫",
+    connectDatabaseDescription:
+      "使用目標應用程式的資料庫連線字串。只有組織擁有者與管理員可以讀寫已連接資料庫資料。",
+    connectedDatabase: "已連接資料庫",
+    noConnections: "尚未連接應用程式資料庫",
+    noConnectionsDescription:
+      "新增 agent-native 應用程式資料庫，即可在 Analytics 中瀏覽資料表、檢查資料列或執行 SQL。",
+    connectionName: "名稱",
+    connectionAppId: "應用程式 ID",
+    connectionAppUrl: "應用程式 URL",
+    connectionDatabaseUrl: "資料庫 URL",
+    connectionAuthToken: "驗證權杖（選填）",
+    saveConnection: "儲存連線",
+    deleteConnection: "刪除連線",
+    deleteConnectionTitle: "刪除資料庫連線？",
+    deleteConnectionDescription:
+      "這會從 Analytics 移除 {{name}} 並刪除儲存的連線密鑰。目標應用程式資料庫不會被修改。",
+  },
   providerCorpusNotifier: {
     completed: "提供者語料庫作業已完成",
     quotaWait: "等待配額的提供者語料庫作業",
@@ -946,6 +980,7 @@ const messages = {
     devtoolsToggleDetails: "切換詳細資訊",
     devtoolsArgs: "記錄的參數",
     devtoolsStack: "堆疊追蹤",
+    devtoolsResponseBody: "回應內容",
     devtoolsRepeatCount: "×{{count}}",
     devtoolsFailedStatus: "失敗",
     devtoolsDurationMs: "{{ms}} 毫秒",