@agent-native/core 0.103.0 → 0.104.0

package/corpus/core/src/workspace-connections/index.ts

@@ -64,3 +64,9 @@ export {
   type WorkspaceConnectionCredentialResolutionStatus,
   type WorkspaceConnectionCredentialsResolution,
 } from "./credentials.js";
+
+export {
+  registerWorkspaceConnectionLifecycleListener,
+  type WorkspaceConnectionLifecycleEvent,
+  type WorkspaceConnectionLifecycleListener,
+} from "./lifecycle.js";

package/corpus/core/src/workspace-connections/lifecycle.ts

@@ -0,0 +1,43 @@
+export type WorkspaceConnectionLifecycleEvent =
+  | {
+      type: "connection-deleted";
+      connectionId: string;
+      ownerEmail: string;
+      orgId: string | null;
+    }
+  | {
+      type: "grant-revoked";
+      connectionId: string;
+      appId: string;
+      ownerEmail: string;
+      orgId: string | null;
+    };
+
+export type WorkspaceConnectionLifecycleListener = (
+  event: WorkspaceConnectionLifecycleEvent,
+) => void | Promise<void>;
+
+const LISTENERS_KEY = Symbol.for(
+  "@agent-native/core.workspace-connection-lifecycle-listeners",
+);
+
+function listeners(): Set<WorkspaceConnectionLifecycleListener> {
+  const global = globalThis as typeof globalThis & {
+    [LISTENERS_KEY]?: Set<WorkspaceConnectionLifecycleListener>;
+  };
+  global[LISTENERS_KEY] ??= new Set();
+  return global[LISTENERS_KEY];
+}
+
+export function registerWorkspaceConnectionLifecycleListener(
+  listener: WorkspaceConnectionLifecycleListener,
+): () => void {
+  listeners().add(listener);
+  return () => listeners().delete(listener);
+}
+
+export async function notifyWorkspaceConnectionLifecycle(
+  event: WorkspaceConnectionLifecycleEvent,
+): Promise<void> {
+  await Promise.all([...listeners()].map((listener) => listener(event)));
+}

package/corpus/core/src/workspace-connections/store.ts

@@ -24,6 +24,7 @@ import {
   getRequestOrgId,
   getRequestUserEmail,
 } from "../server/request-context.js";
+import { notifyWorkspaceConnectionLifecycle } from "./lifecycle.js";
 
 export type WorkspaceConnectionStatus =
   | "connected"
@@ -1903,6 +1904,15 @@ export async function revokeWorkspaceConnectionGrant(
     sql: `DELETE FROM ${table} WHERE connection_id = ? AND app_id = ? AND ${where.sql}`,
     args: [normalizedConnectionId, normalizedAppId, ...where.args],
   });
+  if (result.rowsAffected > 0) {
+    await notifyWorkspaceConnectionLifecycle({
+      type: "grant-revoked",
+      connectionId: normalizedConnectionId,
+      appId: normalizedAppId,
+      ownerEmail: scope.ownerEmail,
+      orgId: scope.orgId,
+    });
+  }
   return result.rowsAffected > 0;
 }
 
@@ -1922,6 +1932,12 @@ export async function deleteWorkspaceConnection(id: string): Promise<boolean> {
       sql: `DELETE FROM ${grantsTable} WHERE connection_id = ? AND ${where.sql}`,
       args: [id, ...where.args],
     });
+    await notifyWorkspaceConnectionLifecycle({
+      type: "connection-deleted",
+      connectionId: id,
+      ownerEmail: scope.ownerEmail,
+      orgId: scope.orgId,
+    });
   }
   return result.rowsAffected > 0;
 }

package/corpus/templates/analytics/.agents/skills/dashboard-management/SKILL.md

@@ -192,6 +192,20 @@ re-typing it as a `content` argument.
    extension panel (`chartType: "extension"`, `config.extensionId`), then
    `navigate` to it.
 
+## Repairing An Existing Extension-Backed Dashboard
+
+When the user asks to fix data loading in an existing or migrated
+extension-backed dashboard, treat the current extension body as user-authored
+design. Read the dashboard config and extension once, identify the smallest
+data-loading seam, and call `update-extension` with focused `patches` or
+`edits`. Preserve the existing layout, CSS, copy, and interactions. Do not
+send a reconstructed full `content` body for a data-only repair;
+`update-extension` blocks full-body replacement unless
+`allowFullReplacement: true` is explicitly supplied. Use that flag only for a
+user-requested broad visual rewrite or a complete replacement body supplied by
+the user. If a focused edit fails, inspect the current body and change the
+target rather than retrying the same arguments.
+
 ### Display truncation is cosmetic — do not chase the "missing" tail
 
 A tool result ending in `...[truncated — full result was N chars; only first
@@ -315,6 +329,10 @@ calling other actions from the script are not available.
 type DashboardMutationApi = {
   dashboard: {
     set(patch: DashboardPatch): void;
+    setFilterDefault(
+      filterId: string,
+      value: string | number | boolean | null,
+    ): void;
     panel(id: string): PanelSelection;
     section(id: string): SectionSelection;
     panels(ids: string[]): PanelSelection;
@@ -329,6 +347,7 @@ type DashboardPatch = {
   columns?: number;
   filters?: unknown[];
   variables?: Record<string, string>;
+  parentId?: string;
 };
 
 type PanelTimeScope =
@@ -340,6 +359,7 @@ type PanelTimeScope =
 type PanelConfig = Record<string, unknown> & {
   // Use "dashboard" for AI-generated first-party panels by default.
   timeScope?: PanelTimeScope;
+  // Fixed bar width in pixels for bar charts.
 };
 
 type PanelPatch = {
@@ -351,7 +371,8 @@ type PanelPatch = {
     | "amplitude"
     | "first-party"
     | "demo"
-    | "prometheus";
+    | "prometheus"
+    | "program";
   chartType?:
     | "line"
     | "area"
@@ -397,6 +418,14 @@ type PanelSelection = {
   moveBefore(panelId: string): void;
   moveAfter(panelId: string): void;
   moveToIndex(index: number): void;
+  moveNextTo(panelId: string): void;
+  nextTo(panelId: string): void;
+  moveToRow(rowNumber: number): void;
+  moveToRowStart(rowNumber: number): void;
+  moveToRowEnd(rowNumber: number): void;
+  atRow(rowNumber: number): void;
+  atRowStart(rowNumber: number): void;
+  atRowEnd(rowNumber: number): void;
   remove(): void;
   set(patch: PanelPatch): void;
   setTitle(title: string): void;
@@ -404,26 +433,40 @@ type PanelSelection = {
   setWidth(width: number): void;
   setConfig(patch: Record<string, unknown>): void;
   setConfigPath(path: string, value: unknown): void;
-  duplicate(newPanelId: string, patch?: PanelPatch): void;
+  duplicate(newPanelId: string, patch?: PanelPatch): PanelPlacement;
 };
 
 type SectionSelection = PanelSelection & {
   append(panelIds: string[]): void;
 };
 
-type InsertedPanel = {
+type PanelPlacement = {
   atTop(): void;
   atBottom(): void;
   before(panelId: string): void;
   after(panelId: string): void;
   atIndex(index: number): void;
+  nextTo(panelId: string): void;
+  atRow(rowNumber: number): void;
+  atRowStart(rowNumber: number): void;
+  atRowEnd(rowNumber: number): void;
 };
+
+type InsertedPanel = PanelPlacement;
 ```
 
 Examples:
 
 ```ts
 dashboard.panels(["dau-over-time", "wau-over-time"]).moveToTop();
+dashboard
+  .panel("recurring-users-by-template")
+  .duplicate("recurring-users-by-template-bar", {
+    title: "Recurring Signed-In Users by Template (Bar)",
+    chartType: "bar",
+  })
+  .nextTo("recurring-users-by-template");
+dashboard.setFilterDefault("emailFilter", "exclude_builder");
 dashboard.panel("top-referrers").setTitle("Top Referrers by Domain");
 dashboard.panel("retention").set({
   width: 2,

package/corpus/templates/analytics/AGENTS.md

@@ -175,6 +175,15 @@ details live in `.agents/skills/`.
   or bespoke workflow cannot be done faithfully with the built-in dashboard JSON
   config/components or saved-analysis markdown/chart format, automatically build
   it as an extension instead and tell the user why.
+- For an existing extension-backed dashboard or migrated surface such as Risk
+  Meeting, separate data repair from visual redesign. Inspect the dashboard and
+  extension first, then use `update-extension` `patches`/`edits` that touch only
+  the data-loading seam. Preserve the existing layout, CSS, copy, and
+  interactions; never reconstruct the full HTML body for a data-only fix.
+  `update-extension` blocks full-body replacement unless
+  `allowFullReplacement: true` is explicit, and that flag is reserved for a
+  user-requested broad rewrite or a complete replacement body supplied by the
+  user. If a focused edit fails, do not retry unchanged arguments.
 - Use framework sharing and access helpers for dashboards, analyses, and saved
   resources.
 - Dashboard email reports live in SQL via the

package/corpus/templates/analytics/actions/dashboard-mutation-api.ts

@@ -14,6 +14,7 @@ import { movePanelsById, type PanelOrderTarget } from "./dashboard-panel-order";
 export const DASHBOARD_MUTATION_API_TYPES = `type DashboardScript = {
   dashboard: {
     set(patch: DashboardPatch): void;
+    setFilterDefault(filterId: string, value: string | number | boolean | null): void;
     panel(id: string): PanelSelection;
     section(id: string): SectionSelection;
     panels(ids: string[]): PanelSelection;
@@ -41,6 +42,7 @@ type PanelTimeScope =
 type PanelConfig = Record<string, unknown> & {
   /** Use "dashboard" for AI-generated first-party panels by default. */
   timeScope?: PanelTimeScope;
+  /** Fixed bar width in pixels for bar charts. */
 };
 
 type PanelPatch = {
@@ -96,14 +98,14 @@ type PanelSelection = {
   setWidth(width: number): void;
   setConfig(patch: Record<string, unknown>): void;
   setConfigPath(path: string, value: unknown): void; // path under config, e.g. "yAxis.format" or "config.yAxis.format"
-  duplicate(newPanelId: string, patch?: PanelPatch): void;
+  duplicate(newPanelId: string, patch?: PanelPatch): PanelPlacement;
 };
 
 type SectionSelection = PanelSelection & {
   append(panelIds: string[]): void;
 };
 
-type InsertedPanel = {
+type PanelPlacement = {
   atTop(): void;
   atBottom(): void;
   before(panelId: string): void;
@@ -113,10 +115,14 @@ type InsertedPanel = {
   atRow(rowNumber: number): void; // 1-based visible row number, end of row
   atRowStart(rowNumber: number): void;
   atRowEnd(rowNumber: number): void;
-};`;
+};
+
+type InsertedPanel = PanelPlacement;`;
 
 export const DASHBOARD_MUTATION_EXAMPLES = [
   'dashboard.panels(["dau-over-time","wau-over-time"]).moveToTop();',
+  'dashboard.panel("recurring-users-by-template").duplicate("recurring-users-by-template-bar", {"title":"Recurring Signed-In Users by Template (Bar)","chartType":"bar"}).nextTo("recurring-users-by-template");',
+  'dashboard.setFilterDefault("emailFilter","exclude_builder");',
   'dashboard.panel("top-referrers").setTitle("Top Referrers by Domain");',
   'dashboard.panel("retention").set({"width":2,"config":{"description":"Updated definition."}});',
   'dashboard.panelsMatching({"titleIncludes":"Signed-In"}).moveToTop();',
@@ -183,6 +189,11 @@ export type DashboardMutationOperation =
   | {
       op: "setDashboard";
       patch: Record<string, unknown>;
+    }
+  | {
+      op: "setFilterDefault";
+      filterId: string;
+      value: string | number | boolean | null;
     };
 
 export interface DashboardMutationResult {
@@ -217,6 +228,7 @@ type DashboardPlacementTarget = PanelOrderTarget | VisualPlacementTarget;
 
 const DASHBOARD_SUBJECTS = [
   "set",
+  "setFilterDefault",
   "panel",
   "section",
   "panels",
@@ -277,6 +289,49 @@ function panelsFromConfig(config: Record<string, unknown>) {
   return panels as Array<Record<string, unknown>>;
 }
 
+function requireDashboardFilter(
+  config: Record<string, unknown>,
+  filterId: string,
+): Record<string, unknown> {
+  if (!Array.isArray(config.filters)) {
+    throw new Error("config.filters must be an array");
+  }
+  const filters = config.filters as Array<Record<string, unknown>>;
+  const filter = filters.find((item) => item?.id === filterId);
+  if (!filter) {
+    const ids = filters
+      .map((item) => (typeof item?.id === "string" ? item.id : ""))
+      .filter(Boolean);
+    throw new Error(
+      `filter "${filterId}" was not found. Available filter ids: ${compactList(ids)}.`,
+    );
+  }
+  return filter;
+}
+
+function setFilterDefault(
+  config: Record<string, unknown>,
+  filterId: string,
+  value: string | number | boolean | null,
+): void {
+  const filter = requireDashboardFilter(config, filterId);
+  if (Array.isArray(filter.options) && filter.options.length > 0) {
+    const optionValues = filter.options
+      .map((option) =>
+        option && typeof option === "object" && !Array.isArray(option)
+          ? (option as Record<string, unknown>).value
+          : undefined,
+      )
+      .filter((optionValue) => optionValue !== undefined);
+    if (!optionValues.some((optionValue) => Object.is(optionValue, value))) {
+      throw new Error(
+        `filter "${filterId}" default ${JSON.stringify(value)} is not one of its option values: ${optionValues.map((optionValue) => JSON.stringify(optionValue)).join(", ")}`,
+      );
+    }
+  }
+  filter.default = value;
+}
+
 function panelId(panel: Record<string, unknown>): string {
   return typeof panel.id === "string" ? panel.id : "";
 }
@@ -895,6 +950,14 @@ export function applyDashboardMutationOperations(
           );
           break;
         }
+        case "setFilterDefault": {
+          setFilterDefault(config, op.filterId, op.value);
+          dashboardFieldsChanged.add(`filters.${op.filterId}.default`);
+          commandLog.push(
+            `setFilterDefault(${op.filterId}: ${JSON.stringify(op.value)})`,
+          );
+          break;
+        }
         default:
           throw new Error(
             `unsupported dashboard mutation op ${(op as any).op}`,
@@ -1304,6 +1367,33 @@ function operationsFromStatement(
     ];
   }
 
+  if (subject.name === "setFilterDefault") {
+    if (commands.length > 0) {
+      throw new Error("dashboard.setFilterDefault(...) cannot be chained");
+    }
+    if (subject.args.length !== 2) {
+      throw new Error(
+        "dashboard.setFilterDefault(...) requires filterId and value",
+      );
+    }
+    const value = subject.args[1];
+    if (
+      value !== null &&
+      !["string", "number", "boolean"].includes(typeof value)
+    ) {
+      throw new Error(
+        "dashboard.setFilterDefault(...) value must be a string, number, boolean, or null",
+      );
+    }
+    return [
+      {
+        op: "setFilterDefault",
+        filterId: assertString(subject.args[0], "filter id"),
+        value: value as string | number | boolean | null,
+      },
+    ];
+  }
+
   if (commands.length === 0) {
     throw new Error(`mutation statement has no command: ${statement}`);
   }
@@ -1370,9 +1460,33 @@ function operationsFromStatement(
 
   requirePanelIds(config, panelIds);
 
-  return commands.flatMap((command) =>
-    operationFromPanelCommand(panelIds, command),
-  );
+  const operations: DashboardMutationOperation[] = [];
+  for (let index = 0; index < commands.length; index++) {
+    const command = commands[index];
+    if (command.name !== "duplicate") {
+      operations.push(...operationFromPanelCommand(panelIds, command));
+      continue;
+    }
+    if (panelIds.length !== 1) {
+      throw new Error("duplicate requires exactly one selected panel");
+    }
+    const placement = commands[index + 1];
+    if (placement && index + 1 !== commands.length - 1) {
+      throw new Error("duplicate accepts at most one placement method");
+    }
+    operations.push({
+      op: "duplicatePanel",
+      panelId: panelIds[0],
+      newPanelId: assertString(command.args[0], "newPanelId"),
+      patch:
+        command.args[1] === undefined
+          ? undefined
+          : assertObject(command.args[1], "duplicate patch"),
+      ...(placement ? targetFromChainCall(placement) : {}),
+    });
+    if (placement) index++;
+  }
+  return operations;
 }
 
 export function parseDashboardMutationScript(

package/corpus/templates/analytics/actions/mutate-dashboard.ts

@@ -85,6 +85,11 @@ const mutationOperationSchema = z.discriminatedUnion("op", [
     op: z.literal("setDashboard"),
     patch: z.record(z.string(), z.unknown()),
   }),
+  z.object({
+    op: z.literal("setFilterDefault"),
+    filterId: z.string().min(1),
+    value: z.union([z.string(), z.number(), z.boolean(), z.null()]),
+  }),
 ]);
 
 function parseJsonArrayString(
@@ -112,19 +117,41 @@ function parseJsonArrayString(
 const operationsInputSchema = z
   .union([
     z.array(mutationOperationSchema),
-    z.string().transform((value) => parseJsonArrayString(value, "operations")),
+    z.string().transform((value) => {
+      const trimmed = value.trim();
+      return trimmed ? parseJsonArrayString(trimmed, "operations") : undefined;
+    }),
   ])
   .optional();
 
+function nonEmptyCode(value: string | undefined): string | undefined {
+  return value?.trim() ? value : undefined;
+}
+
+function nonEmptyOperations(
+  value: DashboardMutationOperation[] | undefined,
+): DashboardMutationOperation[] | undefined {
+  return value && value.length > 0 ? value : undefined;
+}
+
 const apiHelp =
   "Constrained TypeScript-like dashboard mutation script. The server parses only calls on `dashboard`; it does not execute arbitrary JavaScript. " +
   "No variables, imports, loops, functions, templates, network, filesystem, or DB access. Arguments must be JSON-compatible literals, so quote object keys. " +
-  "Subjects: dashboard.set, dashboard.panel, dashboard.panels, dashboard.panelsMatching, dashboard.section, dashboard.insertPanel. " +
-  "Selection methods: moveToTop, moveToBottom, moveBefore, moveAfter, moveToIndex, moveNextTo, moveToRow, remove, set, setTitle, setSql, setWidth, setConfig, setConfigPath, duplicate. " +
+  "Subjects: dashboard.set, dashboard.setFilterDefault, dashboard.panel, dashboard.panels, dashboard.panelsMatching, dashboard.section, dashboard.insertPanel. " +
+  'For a simple default-filter change, use `dashboard.setFilterDefault("emailFilter","exclude_builder");`; it verifies the filter and option value without resending every filter or revalidating unchanged panel SQL. ' +
+  'Selection methods: moveToTop, moveToBottom, moveBefore, moveAfter, moveToIndex, moveNextTo, moveToRow, remove, set, setTitle, setSql, setWidth, setConfig, setConfigPath, duplicate. Duplicate supports one chained placement method, for example `dashboard.panel("source").duplicate("copy", {"chartType":"bar"}).nextTo("source");`. ' +
   "Inserted panels support atTop, atBottom, before, after, atIndex, nextTo, atRow, atRowStart, and atRowEnd. Use nextTo(panelId) or atRow(rowNumber) for visible row placement. " +
   "AI-generated first-party panels are dashboard-time-bound by default: set config.timeScope to dashboard and include a matching dashboard time filter in SQL. Allowed values are dashboard, fixed-window, cohort-history, and all-time; use all-time only when the user requests full available history and put all-time, lifetime, or historical in the title or description. A {{timeRange}} token requires the timeRange select filter; {{<id>Start}}/{{<id>End}} require a matching date-range filter. Server validation rejects unbound first-party SQL. " +
   `Examples: ${DASHBOARD_MUTATION_EXAMPLES.slice(0, 5).join(" ")}`;
 
+const agentInputSchema = z.object({
+  dashboardId: z
+    .string()
+    .min(1)
+    .describe("Dashboard id, e.g. 'agent-native-templates-first-party'."),
+  code: z.string().min(1).describe(apiHelp),
+});
+
 function resolveScope() {
   const orgId = getRequestOrgId() || null;
   const email = getRequestUserEmail();
@@ -162,17 +189,52 @@ async function syncToCollab(
   }
 }
 
-function mutationCanChangePanelSql(op: DashboardMutationOperation): boolean {
-  if (op.op === "insertPanel" || op.op === "duplicatePanel") return true;
-  if (op.op === "setDashboard") {
-    return Object.keys(op.patch).some((key) =>
-      ["filters", "variables"].includes(key),
-    );
+function sqlValidationScope(
+  operations: DashboardMutationOperation[],
+): ReadonlySet<string> | "all" | null {
+  const panelIds = new Set<string>();
+  for (const op of operations) {
+    if (op.op === "setDashboard") {
+      if (
+        Object.keys(op.patch).some((key) =>
+          ["filters", "variables", "panels"].includes(key),
+        )
+      ) {
+        return "all";
+      }
+      continue;
+    }
+    if (op.op === "insertPanel") {
+      if (typeof op.panel.id === "string") panelIds.add(op.panel.id);
+      continue;
+    }
+    if (op.op === "duplicatePanel") {
+      panelIds.add(op.newPanelId);
+      continue;
+    }
+    if (op.op === "updatePanelPath") {
+      panelIds.add(op.panelId);
+      continue;
+    }
+    if (
+      op.op === "updatePanel" &&
+      Object.keys(op.patch).some((key) =>
+        ["sql", "source", "chartType", "config"].includes(key),
+      )
+    ) {
+      panelIds.add(op.panelId);
+    }
   }
-  if (op.op !== "updatePanel") return false;
-  return Object.keys(op.patch).some((key) =>
-    ["sql", "source", "chartType"].includes(key),
-  );
+  return panelIds.size > 0 ? panelIds : null;
+}
+
+async function validateMutationSql(
+  config: Record<string, unknown>,
+  operations: DashboardMutationOperation[],
+): Promise<string | null> {
+  const scope = sqlValidationScope(operations);
+  if (scope === null) return null;
+  return validatePanelSql(config, scope === "all" ? undefined : scope);
 }
 
 function movedPanelIdsFrom(operations: DashboardMutationOperation[]): string[] {
@@ -214,7 +276,7 @@ export default defineAction({
     code: z.string().optional().describe(apiHelp),
     operations: operationsInputSchema.describe(
       "Structured equivalent of the typed script. Native callers should pass an array of mutation ops; shell/legacy callers may pass a JSON string. " +
-        "Supported ops: movePanels, removePanels, updatePanel, updatePanelPath, insertPanel, duplicatePanel, setDashboard.",
+        "Supported ops: movePanels, removePanels, updatePanel, updatePanelPath, insertPanel, duplicatePanel, setDashboard, setFilterDefault.",
     ),
     dryRun: z
       .boolean()
@@ -233,6 +295,7 @@ export default defineAction({
       .optional()
       .describe("If true, include the allowed TypeScript API and examples."),
   }),
+  agentInputSchema,
   http: { method: "POST" },
   mcpApp: {
     compactCatalog: true,
@@ -245,18 +308,18 @@ export default defineAction({
     }),
   },
   run: async (args) => {
+    const code = nonEmptyCode(args.code);
+    const requestedOperations = nonEmptyOperations(args.operations);
     const wantsHelpOnly =
       args.returnTypes === true &&
       !args.dashboardId &&
       !args.id &&
-      !args.code &&
-      !args.operations;
+      !code &&
+      !requestedOperations;
     if (wantsHelpOnly) return helpResult();
 
     const dashboardId = resolveDashboardId(args);
-    const suppliedModes = [args.code, args.operations].filter(
-      (value) => value !== undefined,
-    ).length;
+    const suppliedModes = [code, requestedOperations].filter(Boolean).length;
     if (suppliedModes === 0) {
       throw new Error("provide `code` or `operations`.");
     }
@@ -282,9 +345,9 @@ export default defineAction({
         );
       }
       const nextRoot = cloneConfig(existing.config as Record<string, unknown>);
-      const nextOperations = args.operations
-        ? (args.operations as DashboardMutationOperation[])
-        : parseDashboardMutationScript(nextRoot, args.code!);
+      const nextOperations = requestedOperations
+        ? requestedOperations
+        : parseDashboardMutationScript(nextRoot, code!);
       const nextMutation = applyDashboardMutationOperations(
         nextRoot,
         nextOperations,
@@ -313,20 +376,19 @@ export default defineAction({
       root = computed.nextRoot;
       operations = computed.nextOperations;
       mutation = computed.nextMutation;
-      if (operations.some(mutationCanChangePanelSql)) {
-        const sqlError = await validatePanelSql(root);
-        if (sqlError) throw new Error(sqlError);
-      }
+      const sqlError = await validateMutationSql(root, operations);
+      if (sqlError) throw new Error(sqlError);
     } else {
       const saved = await upsertDashboardWithRetry(
         dashboardId,
         ctx,
         async (existing) => {
           const computed = computeMutation(existing);
-          if (computed.nextOperations.some(mutationCanChangePanelSql)) {
-            const sqlError = await validatePanelSql(computed.nextRoot);
-            if (sqlError) throw new Error(sqlError);
-          }
+          const sqlError = await validateMutationSql(
+            computed.nextRoot,
+            computed.nextOperations,
+          );
+          if (sqlError) throw new Error(sqlError);
           root = computed.nextRoot;
           operations = computed.nextOperations;
           mutation = computed.nextMutation;

package/corpus/templates/analytics/actions/update-dashboard.ts

@@ -387,19 +387,19 @@ export function validateDashboardConfig(
   return null;
 }
 
-/**
- * Dry-run each BigQuery panel's SQL so bad column names or type
- * mismatches fail here, with the full BigQuery error text, rather than
- * silently saving a broken dashboard that crashes on render.
- */
+/** Validate every query panel, or only the supplied ids for a targeted edit. */
 export async function validatePanelSql(
   config: Record<string, unknown>,
+  panelIds?: ReadonlySet<string>,
 ): Promise<string | null> {
   const panels = config.panels;
   if (!Array.isArray(panels)) return null;
   const vars = buildDryRunVars(config);
   for (let i = 0; i < panels.length; i++) {
     const p = panels[i] as Record<string, unknown>;
+    if (panelIds && (typeof p.id !== "string" || !panelIds.has(p.id))) {
+      continue;
+    }
     // Sections are layout-only and extensions render their own iframe — neither
     // has SQL to dry-run. heatmap, callout, and other query panels still
     // validate normally below.