@agent-native/core 0.95.1 → 0.97.0

package/corpus/templates/analytics/server/plugins/agent-chat.ts

@@ -34,6 +34,18 @@ import {
 const DATA_DICT_PREFIX = "data-dict-";
 const ANALYTICS_BACKGROUND_RUN_SOFT_TIMEOUT_MS = 13 * 60_000;
 
+export const SIMPLE_TIME_BOUNDED_METRIC_FAST_PATH_GUIDANCE =
+  "SIMPLE TIME-BOUNDED METRIC FAST PATH — When the data dictionary or a known canonical source identifies the metric, run one bounded aggregate. Once it returns a valid result, answer the explicit question immediately with the source, time window, row count, and only necessary caveats. Do not schema-discover, retry, enrich, cross-check, or add breakdowns after that successful result unless the query failed or the result conflicts with the known metric definition. This does not waive the real-data requirement: never answer from a guess, stale value, or unverified result. ";
+
+export function analyticsSourceGuidanceOpening(): string {
+  return (
+    "<data-source-guidance>\n" +
+    "Apply real-data requirements only when presenting analytics results, source records, or derived metrics. Do not call data-source tools for workflow migration, recurring-job setup, UI/code fixes, settings help, conceptual planning, or other non-data tasks unless the user explicitly asks for data. " +
+    SIMPLE_TIME_BOUNDED_METRIC_FAST_PATH_GUIDANCE +
+    "SURFACE DIFFERENTIATION — You are the analytics assistant for definitions, deep-dive analysis, and action. For questions about what a metric, model, or table means, use the Data Dictionary and configured schema tools first. For trends, comparisons, anomalies, current data, or anything that requires querying live data, answer directly in chat with the relevant provider query, dashboard analysis, and inline charts when useful. "
+  );
+}
+
 export {
   applyAnalyticsPlanModePolicy,
   INITIAL_TOOL_NAMES,
@@ -55,7 +67,61 @@ function latestUserText(
   return "";
 }
 
-function realDataFinalGuard(context: AgentLoopFinalResponseGuardContext) {
+function configuredDataSourceLabels(
+  toolResults: AgentLoopFinalResponseGuardContext["toolResults"],
+): string[] {
+  const labels = new Set<string>();
+  for (const result of toolResults ?? []) {
+    const normalizedName = String(result.name ?? "")
+      .trim()
+      .toLowerCase()
+      .replace(/[\s_]+/g, "-");
+    if (normalizedName !== "data-source-status" || result.isError) continue;
+
+    let parsed: Record<string, unknown>;
+    try {
+      const value = JSON.parse(String(result.content ?? ""));
+      if (!value || typeof value !== "object" || Array.isArray(value)) continue;
+      parsed = value as Record<string, unknown>;
+    } catch {
+      continue;
+    }
+
+    const compactSources = Array.isArray(parsed.configuredDataSources)
+      ? parsed.configuredDataSources
+      : [];
+    for (const source of compactSources) {
+      if (!source || typeof source !== "object" || Array.isArray(source)) {
+        continue;
+      }
+      const record = source as Record<string, unknown>;
+      const label = record.label ?? record.provider;
+      if (typeof label === "string" && label.trim()) labels.add(label.trim());
+    }
+
+    // Backward compatibility for runs against deployments that predate the
+    // compact configuredDataSources summary.
+    const providers = Array.isArray(parsed.providers) ? parsed.providers : [];
+    for (const provider of providers) {
+      if (
+        !provider ||
+        typeof provider !== "object" ||
+        Array.isArray(provider)
+      ) {
+        continue;
+      }
+      const record = provider as Record<string, unknown>;
+      if (record.configured !== true) continue;
+      const label = record.label ?? record.provider;
+      if (typeof label === "string" && label.trim()) labels.add(label.trim());
+    }
+  }
+  return [...labels];
+}
+
+export function realDataFinalGuard(
+  context: AgentLoopFinalResponseGuardContext,
+) {
   if ((context as { executionMode?: string }).executionMode === "plan") {
     return null;
   }
@@ -125,11 +191,22 @@ function realDataFinalGuard(context: AgentLoopFinalResponseGuardContext) {
     };
   }
 
+  const configuredSources = configuredDataSourceLabels(context.toolResults);
+  const configuredSourceGuidance = configuredSources.length
+    ? ` \`data-source-status\` already confirmed these connected sources: ${configuredSources.join(", ")}. Do not claim that no sources are connected and do not ask the user to reconnect them. Immediately call the relevant query action for one of those sources.`
+    : "";
   return {
     retryMessage:
-      "This looks like an analytics result request, but no real source query ran. If you are making data claims, run one relevant data-source action or connected provider MCP tool now and answer from that result. If the right response is a clarification, plan, or explicit unavailable/credentials-missing message with no metrics or source-record claims, finalize that directly instead.",
-    fallbackMessage:
-      "I can't provide a grounded analytics result yet because no real data-source query ran successfully. Tell me which source to use or connect the missing source, and I'll run it before giving numbers or source-record conclusions.",
+      "This looks like an analytics result request, but no real source query ran. If you are making data claims, run one relevant data-source action or connected provider MCP tool now and answer from that result." +
+      configuredSourceGuidance +
+      " If the right response is a clarification, plan, or explicit unavailable/credentials-missing message with no metrics or source-record claims, finalize that directly instead.",
+    fallbackMessage: configuredSources.length
+      ? `I found connected data sources (${configuredSources.join(", ")}), but the model still did not run a real source query. Please retry the request; you do not need to reconnect those sources.`
+      : "I can't provide a grounded analytics result yet because no real data-source query ran successfully. Tell me which source to use or connect the missing source, and I'll run it before giving numbers or source-record conclusions.",
+    // Some models use separate turns for status, schema discovery, and the
+    // actual query. One corrective turn was enough for Sonnet but caused Luna
+    // to hit the fallback before it reached the query.
+    maxRetries: 2,
   };
 }
 
@@ -159,9 +236,7 @@ export default createAgentChatPlugin({
     // The generic template can ship provider actions without every deployment
     // having credentials or workspace-specific schemas configured.
     const sourceGuidance =
-      "<data-source-guidance>\n" +
-      "Apply real-data requirements only when presenting analytics results, source records, or derived metrics. Do not call data-source tools for workflow migration, recurring-job setup, UI/code fixes, settings help, conceptual planning, or other non-data tasks unless the user explicitly asks for data. " +
-      "SURFACE DIFFERENTIATION — You are the analytics assistant for definitions, deep-dive analysis, and action. For questions about what a metric, model, or table means, use the Data Dictionary and configured schema tools first. For trends, comparisons, anomalies, current data, or anything that requires querying live data, answer directly in chat with the relevant provider query, dashboard analysis, and inline charts when useful. " +
+      analyticsSourceGuidanceOpening() +
       "DASHBOARD CREATION RULE — You may create dashboards, analyses, SQL panels, or other resources only when the user explicitly asks you to (e.g. 'build me a dashboard for...', 'create a new analysis', 'add a chart for...'). Never create any resource proactively during research, trend analysis, or answering questions. If you think a dashboard would be useful, suggest it and wait for explicit confirmation before creating anything. Never add new items to the sidebar or modify existing dashboards without an explicit user directive. " +
       "DASHBOARD MUTATION RULE — For dashboard edits, default to `mutate-dashboard` with the typed `dashboard.*` script API so the main payload is a string and avoids native-array serialization traps. It can move panels by id, edit titles/SQL/config, insert, duplicate, remove, and patch dashboard fields in one atomic save. The script API is constrained: no variables/imports/loops/functions, only JSON-compatible arguments on documented dashboard methods. Do not count shifting `/panels/<index>` positions for ordinary dashboard edits unless the user specifically asks for low-level JSON-pointer operations. " +
       "DASHBOARD READ RULE — `get-sql-dashboard` is compact by default: use its `panels` summaries plus `layout.panelOrder`, `layout.firstPanelIds`, and `layout.groups[].rows[].rowNumber/panelIds` for orientation and verification. Pass `includeConfig: true` only when you truly need full panel SQL/config. " +

package/corpus/templates/assets/package.json

@@ -22,7 +22,7 @@
     "@libsql/client": "^0.15.8",
     "@tabler/icons-react": "catalog:",
     "drizzle-orm": "^0.45.2",
-    "h3": "^2.0.1-rc.20",
+    "h3": "catalog:",
     "isbot": "^5",
     "nanoid": "^5.1.9",
     "p-limit": "^7.3.0",
@@ -66,7 +66,6 @@
     "tailwind-merge": "^3.5.0",
     "tailwindcss": "catalog:",
     "tsx": "^4.20.3",
-    "typescript": "catalog:",
     "typescript-7": "catalog:",
     "vite": "catalog:",
     "vitest": "catalog:"

package/corpus/templates/brain/package.json

@@ -23,7 +23,7 @@
     "@fontsource-variable/inter": "^5.2.8",
     "@libsql/client": "^0.15.0",
     "drizzle-orm": "^0.45.2",
-    "h3": "^2.0.1-rc.22",
+    "h3": "catalog:",
     "isbot": "^5.1.40",
     "react": "catalog:",
     "react-dom": "catalog:",
@@ -57,7 +57,6 @@
     "sonner": "^2.0.7",
     "tailwind-merge": "^3.6.0",
     "tailwindcss": "catalog:",
-    "typescript": "catalog:",
     "typescript-7": "catalog:",
     "vite": "catalog:",
     "vitest": "catalog:"

package/corpus/templates/calendar/package.json

@@ -26,7 +26,7 @@
     "chrono-node": "2.9.1",
     "dotenv": "^17.2.1",
     "drizzle-orm": "^0.45.2",
-    "h3": "^2.0.1-rc.20",
+    "h3": "catalog:",
     "isbot": "^5",
     "nanoid": "^5.1.9",
     "zod": "^4.3.6"
@@ -93,7 +93,6 @@
     "tailwind-merge": "^3.5.0",
     "tailwindcss": "catalog:",
     "tsx": "^4.20.3",
-    "typescript": "catalog:",
     "typescript-7": "catalog:",
     "vaul": "^1.1.2",
     "vite": "catalog:",

package/corpus/templates/chat/package.json

@@ -19,7 +19,7 @@
     "@fontsource-variable/inter": "^5.2.8",
     "@libsql/client": "^0.15.8",
     "@tabler/icons-react": "catalog:",
-    "h3": "^2.0.1-rc.20",
+    "h3": "catalog:",
     "isbot": "^5",
     "node-pty": "^1.1.0",
     "zod": "^4.4.3"
@@ -81,7 +81,6 @@
     "tailwind-merge": "^3.5.0",
     "tailwindcss": "catalog:",
     "tsx": "^4.20.3",
-    "typescript": "catalog:",
     "typescript-7": "catalog:",
     "vaul": "^1.1.2",
     "vite": "catalog:",

package/corpus/templates/clips/changelog/2026-07-10-atomic-view-tracking.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-10
+---
+
+Viewer analytics stay accurate when multiple playback events arrive at the same time.

package/corpus/templates/clips/chrome-extension/package.json

@@ -8,6 +8,7 @@
     "dev:hot": "tsx scripts/dev.ts",
     "build": "vite build",
     "typecheck": "tsc --noEmit",
+    "test": "vitest --run",
     "package": "pnpm build && tsx scripts/package.ts"
   },
   "dependencies": {
@@ -16,8 +17,8 @@
   "devDependencies": {
     "@types/chrome": "^0.2.0",
     "tsx": "catalog:",
-    "typescript": "catalog:",
     "typescript-7": "catalog:",
-    "vite": "catalog:"
+    "vite": "catalog:",
+    "vitest": "catalog:"
   }
 }

package/corpus/templates/clips/desktop/package.json

@@ -12,13 +12,15 @@
     "build:tauri": "CLIPS_DESKTOP_LOCAL_BUILD=1 pnpm run check:prereqs && CLIPS_DESKTOP_LOCAL_BUILD=1 tauri build --config '{\"bundle\":{\"createUpdaterArtifacts\":false},\"plugins\":{\"updater\":{\"active\":false}}}' && node ./scripts/sign-macos-local.ts",
     "tauri": "tauri",
     "vite:dev": "vite",
-    "vite:build": "vite build"
+    "vite:build": "vite build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest --run"
   },
   "dependencies": {
     "@radix-ui/react-popover": "^1.1.15",
     "@radix-ui/react-tooltip": "^1.2.8",
     "@sentry/browser": "10.62.0",
-    "@tabler/icons-react": "^3.26.0",
+    "@tabler/icons-react": "catalog:",
     "@tauri-apps/api": "^2.11.0",
     "@tauri-apps/plugin-fs": "2.5.1",
     "@tauri-apps/plugin-process": "^2.3.1",
@@ -32,8 +34,8 @@
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "catalog:",
-    "typescript": "catalog:",
     "typescript-7": "catalog:",
-    "vite": "catalog:"
+    "vite": "catalog:",
+    "vitest": "catalog:"
   }
 }

package/corpus/templates/clips/desktop/src/lib/recorder.ts

@@ -2147,12 +2147,18 @@ async function startNativeFullscreenRecording(
     console.log(
       `[clips-recorder] native begin durationMs=${Date.now() - beginStartedAt} clickToLiveMs=${Date.now() - clickStartedAt}`,
     );
-    await transcriptionCapture?.resetTimeline().catch((err) => {
-      console.warn(
-        "[clips-recorder] transcription timeline reset failed:",
-        err,
-      );
-    });
+    // Cast: `transcriptionCapture` is only ever reassigned inside the
+    // `startNativeTranscriptionBeforeRecording` closure above, so TS's
+    // control-flow analysis can't see past that call and narrows this
+    // read to `null`. Restate the variable's own declared type.
+    await (transcriptionCapture as TranscriptionCapture | null)
+      ?.resetTimeline()
+      .catch((err) => {
+        console.warn(
+          "[clips-recorder] transcription timeline reset failed:",
+          err,
+        );
+      });
     // Capture is now live — after rebasing the transcript timeline, stamp the
     // timer baseline so the toolbar clock lines up with the real start.
     startedAt = Date.now();
@@ -2164,12 +2170,15 @@ async function startNativeFullscreenRecording(
     localCameraExport?.start(2_000);
   } catch (err) {
     await localCameraExport?.cancel().catch(() => {});
-    await transcriptionCapture?.cancel().catch((cancelErr) => {
-      console.warn(
-        "[clips-recorder] native transcription cancel after start failure failed:",
-        cancelErr,
-      );
-    });
+    // Same TS narrowing gap as above: reassert the declared type.
+    await (transcriptionCapture as TranscriptionCapture | null)
+      ?.cancel()
+      .catch((cancelErr) => {
+        console.warn(
+          "[clips-recorder] native transcription cancel after start failure failed:",
+          cancelErr,
+        );
+      });
     // Tear down any capture started by the warm phase — on a countdown cancel
     // (or a `begin` failure) the SCStream is already running with the mic live,
     // and without this it would keep capturing after the aborted start.
@@ -2629,7 +2638,11 @@ async function startNativeFullscreenRecording(
       console.log(
         "[clips-recorder] native: paused during startup, pausing transcription",
       );
-      void transcriptionCapture.pause().catch(() => {});
+      // The `if` above already proves non-null at runtime; TS just can't see
+      // it (same closure-narrowing gap as above).
+      void (transcriptionCapture as TranscriptionCapture)
+        .pause()
+        .catch(() => {});
     }
   }
 

package/corpus/templates/clips/desktop/src/lib/voice-dictation.ts

@@ -298,7 +298,10 @@ function appendFinalTranscript(session: VoiceSession, text: string): void {
   } else if (clean === committed || clean.startsWith(`${committed} `)) {
     // Some recognizers send the whole dictation as their final result.
     session.finalTranscriptParts = [clean];
-  } else if (session.finalTranscriptParts.at(-1) !== clean) {
+  } else if (
+    session.finalTranscriptParts[session.finalTranscriptParts.length - 1] !==
+    clean
+  ) {
     session.finalTranscriptParts.push(clean);
   }
   session.interimTranscript = "";

package/corpus/templates/clips/package.json

@@ -30,7 +30,7 @@
     "@tabler/icons-react": "catalog:",
     "drizzle-orm": "^0.45.2",
     "ffmpeg-static": "^5.3.0",
-    "h3": "^2.0.1-rc.20",
+    "h3": "catalog:",
     "isbot": "^5",
     "postgres": "^3.4.9",
     "zod": "^4.3.6"
@@ -92,7 +92,6 @@
     "tailwind-merge": "^3.5.0",
     "tailwindcss": "catalog:",
     "tsx": "^4.20.3",
-    "typescript": "catalog:",
     "typescript-7": "catalog:",
     "vaul": "^1.1.2",
     "vite": "catalog:",

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

@@ -6,6 +6,7 @@ import {
   now,
   ownableColumns,
   createSharesTable,
+  uniqueIndex,
 } from "@agent-native/core/db/schema";
 
 // -----------------------------------------------------------------------------
@@ -332,23 +333,34 @@ export const recordingReactions = table("recording_reactions", {
 // Analytics: viewers + granular events
 // -----------------------------------------------------------------------------
 
-export const recordingViewers = table("recording_viewers", {
-  id: text("id").primaryKey(),
-  recordingId: text("recording_id").notNull(),
-  viewerEmail: text("viewer_email"), // null = anonymous
-  viewerName: text("viewer_name"),
-  firstViewedAt: text("first_viewed_at").notNull().default(now()),
-  lastViewedAt: text("last_viewed_at").notNull().default(now()),
-  totalWatchMs: integer("total_watch_ms").notNull().default(0),
-  completedPct: integer("completed_pct").notNull().default(0),
-  // True once they meet the 5s / 75% / end-scrub rule.
-  countedView: integer("counted_view", { mode: "boolean" })
-    .notNull()
-    .default(false),
-  ctaClicked: integer("cta_clicked", { mode: "boolean" })
-    .notNull()
-    .default(false),
-});
+export const recordingViewers = table(
+  "recording_viewers",
+  {
+    id: text("id").primaryKey(),
+    recordingId: text("recording_id").notNull(),
+    // Stable canonical identity for new viewers. Nullable so existing rows can
+    // be migrated additively and claimed on their next event.
+    viewerKey: text("viewer_key"),
+    viewerEmail: text("viewer_email"), // null = anonymous
+    viewerName: text("viewer_name"),
+    firstViewedAt: text("first_viewed_at").notNull().default(now()),
+    lastViewedAt: text("last_viewed_at").notNull().default(now()),
+    totalWatchMs: integer("total_watch_ms").notNull().default(0),
+    completedPct: integer("completed_pct").notNull().default(0),
+    // True once they meet the 5s / 75% / end-scrub rule.
+    countedView: integer("counted_view", { mode: "boolean" })
+      .notNull()
+      .default(false),
+    ctaClicked: integer("cta_clicked", { mode: "boolean" })
+      .notNull()
+      .default(false),
+  },
+  (viewer) => ({
+    recordingViewerKeyUnique: uniqueIndex(
+      "recording_viewers_recording_viewer_key_unique_idx",
+    ).on(viewer.recordingId, viewer.viewerKey),
+  }),
+);
 
 // Per-view records — one row per distinct counted view, so the owner can see
 // *who viewed and when* (not just an aggregate count or a single

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

@@ -825,6 +825,14 @@ const migrations = runMigrations(
         `CREATE UNIQUE INDEX IF NOT EXISTS recording_views_session_unique_idx ON recording_views (recording_id, viewer_key, view_session_id)`,
       ].join("; "),
     },
+    {
+      version: 48,
+      name: "recording-viewers-canonical-viewer-key",
+      sql: [
+        `ALTER TABLE recording_viewers ADD COLUMN IF NOT EXISTS viewer_key TEXT`,
+        `CREATE UNIQUE INDEX IF NOT EXISTS recording_viewers_recording_viewer_key_unique_idx ON recording_viewers (recording_id, viewer_key)`,
+      ].join("; "),
+    },
   ],
   { table: "clips_migrations" },
 );