@agent-native/core 0.131.7 → 0.132.0

package/corpus/templates/analytics/server/lib/native-v2-dashboards.ts

@@ -0,0 +1,457 @@
+import type {
+  SqlDashboardConfig,
+  SqlPanel,
+} from "../../app/pages/adhoc/sql-dashboard/types";
+
+export const NATIVE_V2_DASHBOARD_VERSION = "2026-07-30-v1";
+
+export const NATIVE_V2_DASHBOARD_IDS = [
+  "customer-roi-v2",
+  "account-engagement-v2",
+  "cross-sell-v2",
+  "win-loss-v2",
+] as const;
+
+export type NativeV2DashboardId = (typeof NATIVE_V2_DASHBOARD_IDS)[number];
+
+export type NativeV2BindingKey =
+  | "roi.kpi"
+  | "roi.trend"
+  | "roi.detail"
+  | "engagement.kpi"
+  | "engagement.trend"
+  | "engagement.heatmap"
+  | "engagement.alerts"
+  | "cross_sell.funnel"
+  | "cross_sell.kpi"
+  | "cross_sell.pipeline"
+  | "cross_sell.trend"
+  | "win_loss.summary"
+  | "win_loss.reasons"
+  | "win_loss.evidence"
+  | "win_loss.alerts";
+
+export interface NativeV2Binding {
+  programId: string;
+  params?: Record<string, unknown>;
+}
+
+export interface NativeV2PanelManifest {
+  id: string;
+  title: string;
+  bindingKey?: NativeV2BindingKey;
+  chartType: SqlPanel["chartType"];
+  width: number;
+  columns?: number;
+  tab?: string;
+  config?: SqlPanel["config"];
+  requiredColumns?: string[];
+}
+
+export interface NativeV2DashboardManifest {
+  id: NativeV2DashboardId;
+  name: string;
+  description: string;
+  category: "Acquisition" | "Product" | "Operations";
+  tags: string[];
+  requiredBindings: NativeV2BindingKey[];
+  panels: NativeV2PanelManifest[];
+}
+
+const section = (
+  id: string,
+  title: string,
+  tab: string,
+  columns = 6,
+): NativeV2PanelManifest => ({
+  id,
+  title,
+  chartType: "section",
+  width: 1,
+  columns,
+  tab,
+});
+
+const boundPanel = (
+  panel: Omit<NativeV2PanelManifest, "bindingKey"> & {
+    bindingKey: NativeV2BindingKey;
+    requiredColumns: string[];
+  },
+): NativeV2PanelManifest => panel;
+
+export const nativeV2DashboardManifests: readonly NativeV2DashboardManifest[] =
+  [
+    {
+      id: "customer-roi-v2",
+      name: "Customer ROI v2",
+      description:
+        "Native value-realization dashboard: KPI, period trend, account detail, and evidence callouts.",
+      category: "Acquisition",
+      tags: ["native", "v2", "roi", "value-realization", "customer"],
+      requiredBindings: ["roi.kpi", "roi.trend", "roi.detail"],
+      panels: [
+        section("roi-overview", "Value realization", "Overview"),
+        boundPanel({
+          id: "roi-kpi",
+          title: "Realized value",
+          bindingKey: "roi.kpi",
+          chartType: "metric",
+          width: 1,
+          tab: "Overview",
+          config: {
+            yKey: "value",
+            yFormatter: "currency",
+            description: "The bound program's current realized-value KPI.",
+          },
+          requiredColumns: ["value"],
+        }),
+        boundPanel({
+          id: "roi-trend",
+          title: "Value over time",
+          bindingKey: "roi.trend",
+          chartType: "line",
+          width: 3,
+          tab: "Overview",
+          config: {
+            xKey: "period",
+            yKey: "value",
+            yFormatter: "currency",
+            legend: false,
+          },
+          requiredColumns: ["period", "value"],
+        }),
+        boundPanel({
+          id: "roi-detail",
+          title: "Account-level value evidence",
+          bindingKey: "roi.detail",
+          chartType: "table",
+          width: 3,
+          tab: "Accounts",
+          config: {
+            columns: [
+              { key: "account", label: "Account" },
+              { key: "period", label: "Period", format: "date" },
+              { key: "investment", label: "Investment", format: "currency" },
+              { key: "value", label: "Value", format: "currency" },
+              { key: "roi", label: "ROI", format: "percent" },
+              { key: "matched_by", label: "Matched by" },
+              { key: "match_quality", label: "Match quality" },
+            ],
+            limit: 100,
+          },
+          requiredColumns: [
+            "account",
+            "period",
+            "investment",
+            "value",
+            "roi",
+            "matched_by",
+            "match_quality",
+          ],
+        }),
+      ],
+    },
+    {
+      id: "account-engagement-v2",
+      name: "Account Engagement v2",
+      description:
+        "Native engagement coverage dashboard: headline coverage, daily trend, segment heatmap, and alerts.",
+      category: "Product",
+      tags: ["native", "v2", "engagement", "adoption", "customer"],
+      requiredBindings: [
+        "engagement.kpi",
+        "engagement.trend",
+        "engagement.heatmap",
+        "engagement.alerts",
+      ],
+      panels: [
+        section("engagement-overview", "Account engagement", "Overview"),
+        boundPanel({
+          id: "engagement-kpi",
+          title: "Engaged accounts",
+          bindingKey: "engagement.kpi",
+          chartType: "metric",
+          width: 1,
+          tab: "Overview",
+          config: {
+            yKey: "value",
+            description: "The bound program's current engaged-account count.",
+          },
+          requiredColumns: ["value"],
+        }),
+        boundPanel({
+          id: "engagement-trend",
+          title: "Engagement over time",
+          bindingKey: "engagement.trend",
+          chartType: "line",
+          width: 3,
+          tab: "Overview",
+          config: {
+            xKey: "period",
+            yKey: "value",
+            legend: false,
+          },
+          requiredColumns: ["period", "value"],
+        }),
+        boundPanel({
+          id: "engagement-heatmap",
+          title: "Engagement by segment",
+          bindingKey: "engagement.heatmap",
+          chartType: "heatmap",
+          width: 3,
+          tab: "Segments",
+          config: {
+            xKey: "period",
+            yKey: "value",
+            color: "segment",
+            yFormatter: "percent",
+          },
+          requiredColumns: ["period", "segment", "value"],
+        }),
+        boundPanel({
+          id: "engagement-alerts",
+          title: "Engagement alerts",
+          bindingKey: "engagement.alerts",
+          chartType: "callout",
+          width: 3,
+          tab: "Alerts",
+          requiredColumns: ["severity", "message"],
+        }),
+      ],
+    },
+    {
+      id: "cross-sell-v2",
+      name: "Cross-sell v2",
+      description:
+        "Native cross-sell dashboard: ordered opportunity funnel, pipeline value, account table, and trend.",
+      category: "Acquisition",
+      tags: ["native", "v2", "cross-sell", "pipeline", "gtm"],
+      requiredBindings: [
+        "cross_sell.funnel",
+        "cross_sell.kpi",
+        "cross_sell.pipeline",
+        "cross_sell.trend",
+      ],
+      panels: [
+        section("cross-sell-overview", "Cross-sell pipeline", "Overview"),
+        boundPanel({
+          id: "cross-sell-funnel",
+          title: "Opportunity funnel",
+          bindingKey: "cross_sell.funnel",
+          chartType: "funnel",
+          width: 3,
+          tab: "Overview",
+          config: {
+            xKey: "stage",
+            yKey: "value",
+            yFormatter: "currency",
+          },
+          requiredColumns: ["stage", "value"],
+        }),
+        boundPanel({
+          id: "cross-sell-kpi",
+          title: "Pipeline value",
+          bindingKey: "cross_sell.kpi",
+          chartType: "metric",
+          width: 1,
+          tab: "Overview",
+          config: {
+            yKey: "value",
+            yFormatter: "currency",
+          },
+          requiredColumns: ["value"],
+        }),
+        boundPanel({
+          id: "cross-sell-pipeline",
+          title: "Account pipeline",
+          bindingKey: "cross_sell.pipeline",
+          chartType: "table",
+          width: 3,
+          tab: "Accounts",
+          config: {
+            columns: [
+              { key: "account", label: "Account" },
+              { key: "stage", label: "Stage" },
+              { key: "value", label: "Value", format: "currency" },
+              { key: "owner", label: "Owner" },
+              { key: "matched_by", label: "Matched by" },
+              { key: "match_quality", label: "Match quality" },
+            ],
+            limit: 100,
+          },
+          requiredColumns: [
+            "account",
+            "stage",
+            "value",
+            "owner",
+            "matched_by",
+            "match_quality",
+          ],
+        }),
+        boundPanel({
+          id: "cross-sell-trend",
+          title: "Pipeline over time",
+          bindingKey: "cross_sell.trend",
+          chartType: "area",
+          width: 3,
+          tab: "Trend",
+          config: {
+            xKey: "period",
+            yKey: "value",
+            yFormatter: "currency",
+            legend: false,
+          },
+          requiredColumns: ["period", "value"],
+        }),
+      ],
+    },
+    {
+      id: "win-loss-v2",
+      name: "Win / Loss v2",
+      description:
+        "Native outcome dashboard: win/loss totals, reason breakdown, evidence table, and follow-up alerts.",
+      category: "Operations",
+      tags: ["native", "v2", "win-loss", "sales", "evidence"],
+      requiredBindings: [
+        "win_loss.summary",
+        "win_loss.reasons",
+        "win_loss.evidence",
+        "win_loss.alerts",
+      ],
+      panels: [
+        section("win-loss-overview", "Win / loss outcomes", "Overview"),
+        boundPanel({
+          id: "win-loss-summary",
+          title: "Outcome totals",
+          bindingKey: "win_loss.summary",
+          chartType: "bar",
+          width: 3,
+          tab: "Overview",
+          config: {
+            xKey: "outcome",
+            yKey: "value",
+            yFormatter: "currency",
+            legend: false,
+          },
+          requiredColumns: ["outcome", "value"],
+        }),
+        boundPanel({
+          id: "win-loss-reasons",
+          title: "Reasons",
+          bindingKey: "win_loss.reasons",
+          chartType: "bar",
+          width: 3,
+          tab: "Reasons",
+          config: {
+            xKey: "reason",
+            yKey: "value",
+            legend: false,
+          },
+          requiredColumns: ["reason", "value"],
+        }),
+        boundPanel({
+          id: "win-loss-evidence",
+          title: "Outcome evidence",
+          bindingKey: "win_loss.evidence",
+          chartType: "table",
+          width: 3,
+          tab: "Evidence",
+          config: {
+            columns: [
+              { key: "account", label: "Account" },
+              { key: "outcome", label: "Outcome" },
+              { key: "reason", label: "Reason" },
+              { key: "value", label: "Value", format: "currency" },
+              { key: "evidence", label: "Evidence" },
+              { key: "match_quality", label: "Match quality" },
+            ],
+            limit: 100,
+          },
+          requiredColumns: [
+            "account",
+            "outcome",
+            "reason",
+            "value",
+            "evidence",
+            "match_quality",
+          ],
+        }),
+        boundPanel({
+          id: "win-loss-alerts",
+          title: "Follow-up alerts",
+          bindingKey: "win_loss.alerts",
+          chartType: "callout",
+          width: 3,
+          tab: "Alerts",
+          requiredColumns: ["severity", "message"],
+        }),
+      ],
+    },
+  ] as const;
+
+export function getNativeV2DashboardManifest(
+  id: NativeV2DashboardId,
+): NativeV2DashboardManifest {
+  const manifest = nativeV2DashboardManifests.find((entry) => entry.id === id);
+  if (!manifest) throw new Error(`Unknown native v2 dashboard: ${id}`);
+  return manifest;
+}
+
+export function compileNativeV2Dashboard(
+  manifest: NativeV2DashboardManifest,
+  bindings: Partial<Record<NativeV2BindingKey, NativeV2Binding>>,
+  installedAt: string,
+): SqlDashboardConfig {
+  const missing = manifest.requiredBindings.filter(
+    (bindingKey) => !bindings[bindingKey]?.programId.trim(),
+  );
+  if (missing.length > 0) {
+    throw new Error(
+      `${manifest.id} is missing required bindings: ${missing.join(", ")}`,
+    );
+  }
+
+  return {
+    name: manifest.name,
+    description: manifest.description,
+    columns: 6,
+    catalog: {
+      templateId: manifest.id,
+      templateVersion: NATIVE_V2_DASHBOARD_VERSION,
+      installedAt,
+    },
+    panels: manifest.panels.map((panel) => {
+      if (!panel.bindingKey) {
+        return {
+          id: panel.id,
+          title: panel.title,
+          source: "first-party",
+          chartType: panel.chartType,
+          width: panel.width,
+          ...(panel.columns ? { columns: panel.columns } : {}),
+          ...(panel.tab ? { tab: panel.tab } : {}),
+          ...(panel.config ? { config: panel.config } : {}),
+          sql: "",
+        } satisfies SqlPanel;
+      }
+
+      const binding = bindings[panel.bindingKey];
+      if (!binding) {
+        throw new Error(`Missing binding: ${panel.bindingKey}`);
+      }
+      return {
+        id: panel.id,
+        title: panel.title,
+        source: "program",
+        chartType: panel.chartType,
+        width: panel.width,
+        ...(panel.tab ? { tab: panel.tab } : {}),
+        ...(panel.config ? { config: panel.config } : {}),
+        sql: JSON.stringify({
+          programId: binding.programId,
+          ...(binding.params ? { params: binding.params } : {}),
+        }),
+      } satisfies SqlPanel;
+    }),
+  };
+}

package/corpus/templates/analytics/server/lib/report-chart-svg.ts

@@ -1,6 +1,8 @@
 import { OG_FONT_FAMILY } from "@agent-native/core/server";
 
-export type ReportChartType = "bar" | "line" | "area" | "pie";
+import type { DashboardFunnelItem } from "../../shared/dashboard-funnel";
+
+export type ReportChartType = "bar" | "line" | "area" | "pie" | "funnel";
 
 export type ReportChartAxis = "left" | "right";
 
@@ -784,6 +786,75 @@ function renderPieChartSvg({
 </svg>`;
 }
 
+export function renderFunnelChartSvg({
+  title,
+  subtitle,
+  rows,
+  width,
+  height,
+  formatter,
+  colors,
+}: {
+  title?: string;
+  subtitle?: string;
+  rows: DashboardFunnelItem[];
+  width: number;
+  height: number;
+  formatter?: ReportChartValueFormatter;
+  colors?: string[];
+}): string {
+  const theme = CHART_THEMES.light;
+  const palette = CHART_PALETTES.light;
+  const safeWidth = clampSize(width, 360, 2000);
+  const safeHeight = clampSize(height, 240, 1200);
+  const header = renderChartHeader({
+    title: title ?? "",
+    subtitle: subtitle ?? "",
+    width: safeWidth,
+    theme,
+    fontFamily: REPORT_CHART_FONT_FAMILY,
+    fit: true,
+  });
+  const top = header.headerBottom + 30;
+  const bottom = safeHeight - 24;
+  const labelWidth = Math.min(190, Math.max(120, safeWidth * 0.2));
+  const valueWidth = 150;
+  const barLeft = labelWidth;
+  const barRight = safeWidth - valueWidth;
+  const barWidth = Math.max(1, barRight - barLeft);
+  const rowHeight = 31;
+  const maxRows = Math.max(1, Math.floor((bottom - top) / rowHeight));
+  const visible = rows.slice(0, maxRows);
+  const hidden = rows.length - visible.length;
+  const maxValue = Math.max(...rows.map((row) => row.value), 1);
+  const bars = visible
+    .map((row, index) => {
+      const y = top + index * rowHeight;
+      const fillWidth = row.value > 0 ? (row.value / maxValue) * barWidth : 0;
+      const color = safeColor(colors?.[index], palette[index % palette.length]);
+      const dropOff =
+        row.dropOffPercent === null
+          ? ""
+          : `  ${row.dropOffPercent < 0 ? "↑" : "↓"}${Math.abs(row.dropOffPercent).toFixed(1)}%`;
+      return `<text x="${(labelWidth - 12).toFixed(1)}" y="${(y + 20).toFixed(1)}" text-anchor="end" font-size="12" fill="${theme.labelColor}">${escapeXml(truncate(row.label, 24))}</text><rect x="${barLeft.toFixed(1)}" y="${(y + 7).toFixed(1)}" width="${barWidth.toFixed(1)}" height="16" rx="4" fill="${theme.gridColor}"/><rect x="${barLeft.toFixed(1)}" y="${(y + 7).toFixed(1)}" width="${fillWidth.toFixed(1)}" height="16" rx="4" fill="${color}"/><text x="${(barRight + 12).toFixed(1)}" y="${(y + 19).toFixed(1)}" font-size="12" fill="${theme.labelColor}">${escapeXml(`${formatTick(row.value, formatter)}  ${row.percentOfFirst.toFixed(1)}%${dropOff}`)}</text>`;
+    })
+    .join("");
+  const overflow =
+    hidden > 0
+      ? `<text x="${barLeft.toFixed(1)}" y="${(top + visible.length * rowHeight + 18).toFixed(1)}" font-size="12" fill="${theme.tickColor}">${escapeXml(`+${hidden} more stages`)}</text>`
+      : "";
+
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${safeWidth}" height="${safeHeight}" viewBox="0 0 ${safeWidth} ${safeHeight}" font-family="${REPORT_CHART_FONT_FAMILY}" role="img" aria-label="${escapeXml(title ?? "Funnel chart")}">
+  <rect width="${safeWidth}" height="${safeHeight}" rx="8" fill="${theme.background}"/>
+  ${header.titleMarkup}
+  ${header.subtitleMarkup}
+  <g font-family="${REPORT_CHART_FONT_FAMILY}">
+    ${bars}
+    ${overflow}
+  </g>
+</svg>`;
+}
+
 /**
  * Browser-facing renderer: clamps every value to a non-negative number and uses
  * a system font stack. Kept for `generate-chart`'s saved-artifact fallback; the
@@ -867,7 +938,7 @@ export function renderReportChartSvg({
   subtitle?: string;
   labels: string[];
   series: ReportChartSeries[];
-  type: ReportChartType;
+  type: Exclude<ReportChartType, "funnel">;
   width: number;
   height: number;
   stacked?: boolean;

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

@@ -58,7 +58,7 @@ export const NON_ANALYTICS_REQUEST_GUIDANCE =
 export const ANALYTICS_CUSTOM_BLOCK_GUIDANCE =
   "<analytics-artifact-guidance>\n" +
   "Analytics has one user-facing artifact type: dashboards. Build with native dashboard panels and Data Programs first. A sandboxed extension embedded in a dashboard is presented to users as a Custom Block, not as a separate Analytics artifact. " +
-  "Use native chart, table, metric, section, filter, and layout capabilities whenever they can represent the request faithfully. Use a Data Program when the durable need is reusable fetching, transformation, or computed data that native panels can render. Do not create a Custom Block merely because a request says custom, asks for a dashboard, or would take more effort with native components. " +
+  "Use native chart, table, metric, section, funnel, heatmap, callout, filter, and layout capabilities whenever they can represent the request faithfully. Reusable ROI, engagement, cross-sell, and win/loss dashboards should compose these native panels around real SQL or Data Program results. Use a Data Program when the durable need is reusable fetching, transformation, or computed data that native panels can render. Do not create a Custom Block merely because a request says custom, asks for a dashboard, or would take more effort with native components. " +
   'Create a Custom Block only when the user explicitly asks for a genuinely bespoke or one-off visualization or interaction, the native dashboard model cannot represent it faithfully, and its intended scope is this dashboard. Create it with `create-extension`, immediately embed it as a `chartType: "extension"` panel with `config.extensionId`, and set `config.customBlock` to `{ authoredBy: "agent", intent: "one-off", scope: "dashboard", nativeGapReason: "custom-visualization" | "custom-interaction" | "custom-layout" | "other" }`. Choose the narrow categorical reason; never put prompt text, customer data, or other free text in this metadata. Use the host theme CSS variables and match the dashboard typography, card spacing, and density so the sandboxed content reads as an agent-authored patch to Analytics instead of a foreign mini-app. Describe it as a sandboxed, agent-authored dashboard patch. Never leave it standalone or direct the user to an Extensions page. ' +
   "A Custom Block is a fast runtime patch, not the durable destination for reusable product behavior. If the request should work across dashboards or users, changes app chrome or business logic, adds a reusable chart type, needs native accessibility/export/governance, or explicitly asks for app code, a PR, or a native feature, call `connect-builder` with the request verbatim instead of creating a Custom Block. If scope is ambiguous, ask whether the user wants a one-off block for this dashboard or a reusable app feature before choosing. " +
   "When the user chooses Promote to app code, preserve the existing Custom Block and pass its dashboard id, panel id, extension id, and requested native placement through `connect-builder`; do not delete or replace the block until the native implementation is reviewed and deployed. Legacy analyses and existing extension-backed dashboards remain readable and editable for compatibility.\n" +

package/corpus/templates/analytics/shared/dashboard-funnel.ts

@@ -0,0 +1,83 @@
+export interface DashboardFunnelItem {
+  label: string;
+  value: number;
+  percentOfFirst: number;
+  dropOffPercent: number | null;
+}
+
+export interface DashboardFunnelRows {
+  labelKey: string;
+  valueKey: string;
+  items: DashboardFunnelItem[];
+}
+
+function finiteNumber(value: unknown): number | null {
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : null;
+  }
+  if (typeof value !== "string" || value.trim() === "") return null;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+
+function hasNumericValue(
+  rows: Array<Record<string, unknown>>,
+  key: string,
+): boolean {
+  return rows.some((row) => {
+    const value = finiteNumber(row[key]);
+    return value !== null && value >= 0;
+  });
+}
+
+export function resolveDashboardFunnelRows(
+  rows: Array<Record<string, unknown>>,
+  configuredLabelKey?: string,
+  configuredValueKey?: string,
+): DashboardFunnelRows {
+  if (rows.length === 0) {
+    return { labelKey: "", valueKey: "", items: [] };
+  }
+
+  const columns = Object.keys(rows[0]);
+  const columnSet = new Set(columns);
+  const labelKey =
+    (configuredLabelKey && columnSet.has(configuredLabelKey)
+      ? configuredLabelKey
+      : undefined) ||
+    columns.find((key) =>
+      rows.some((row) => typeof row[key] === "string" && row[key].trim()),
+    ) ||
+    columns[0] ||
+    "";
+  const valueKey =
+    (configuredValueKey && columnSet.has(configuredValueKey)
+      ? configuredValueKey
+      : undefined) ||
+    columns.find((key) => key !== labelKey && hasNumericValue(rows, key)) ||
+    "";
+
+  const parsed = rows.flatMap((row) => {
+    const label = String(row[labelKey] ?? "").trim();
+    const value = finiteNumber(row[valueKey]);
+    if (!label || value === null || value < 0) return [];
+    return [{ label, value }];
+  });
+  const firstValue = parsed[0]?.value ?? 0;
+
+  return {
+    labelKey,
+    valueKey,
+    items: parsed.map((item, index) => {
+      const previousValue = parsed[index - 1]?.value;
+      return {
+        ...item,
+        percentOfFirst: firstValue > 0 ? (item.value / firstValue) * 100 : 0,
+        dropOffPercent:
+          previousValue && previousValue > 0
+            ? ((previousValue - item.value) / previousValue) * 100
+            : null,
+      };
+    }),
+  };
+}

package/corpus/templates/clips/actions/generate-workflow.ts

@@ -25,6 +25,7 @@ import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
 import { withFullVideoAiInstructions } from "../shared/clips-ai-prefs.js";
+import { WorkflowKindSchema } from "../shared/workflow.js";
 import { readIncludeFullVideoInAi } from "./lib/clips-ai-prefs.js";
 
 const KIND_PROMPTS = {
@@ -64,7 +65,7 @@ export default defineAction({
     "Ask the agent to generate a structured workflow doc (pr/sop/ticket/email) from this recording's transcript (and the full video when Include full video is enabled). The agent writes the result to clips-workflow-<recordingId> in application_state.",
   schema: z.object({
     recordingId: z.string().describe("Recording ID"),
-    kind: z.enum(["pr", "sop", "ticket", "email"]).describe("Workflow kind"),
+    kind: WorkflowKindSchema.describe("Workflow kind"),
   }),
   run: async (args) => {
     await assertAccess("recording", args.recordingId, "viewer");
@@ -98,7 +99,7 @@ export default defineAction({
 
       const includeFullVideoInAi = await readIncludeFullVideoInAi();
 
-      const existing = await readAppState(stateKey).catch(() => null);
+      const existing = await readAppState(stateKey);
       if (existing?.status === "generating") {
         const requestedAt = Date.parse(String(existing.requestedAt ?? ""));
         const isRecent =
@@ -115,13 +116,14 @@ export default defineAction({
         }
       }
 
+      const requestedAt = new Date().toISOString();
       // Seed the output state with a "generating" placeholder so the UI can show
       // a loading state immediately.
       await writeAppState(stateKey, {
         kind: args.kind,
         status: "generating",
         recordingId: args.recordingId,
-        requestedAt: new Date().toISOString(),
+        requestedAt,
       } as any);
 
       const baseMessage =
@@ -136,7 +138,7 @@ export default defineAction({
         kind: "generate-workflow" as const,
         workflowKind: args.kind,
         recordingId: args.recordingId,
-        requestedAt: new Date().toISOString(),
+        requestedAt,
         recordingTitle: rec.title,
         recordingDescription: rec.description,
         transcriptStatus: transcript?.status ?? "pending",