@agent-native/core 0.108.0 → 0.109.0

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

@@ -484,12 +484,25 @@ const messages = {
     chartTypePie: "餡餅",
     chartTypeMetric: "公制",
     chartTypeTable: "桌子",
+    chartTypeExtension: "擴充功能",
     failedToSavePanel: "儲存面板失敗",
     failedToFormatSql: "格式化 SQL 失敗",
     title: "標題",
     titlePlaceholder: "例如每週註冊人數",
     chartType: "圖表型別",
     source: "來源",
+    extensionDisplay: "擴充功能顯示方式",
+    sharedExtension: "共用擴充功能",
+    perViewerSlot: "每位檢視者的插槽",
+    extension: "擴充功能",
+    loadingExtensions: "正在載入擴充功能...",
+    selectExtension: "選取擴充功能",
+    noExtensions: "沒有可見的擴充功能。請先建立或共用一個。",
+    sharedExtensionHelp:
+      "選取的擴充功能會與此儀表板共用，並顯示在排程報告中。檢視者仍需具備該擴充功能的存取權。",
+    slotIdOptional: "插槽 ID（選填）",
+    perViewerSlotHelp:
+      "每位檢視者各自安裝擴充功能。排程報告可能會顯示空插槽。留空即可產生穩定的 ID。",
     sectionColumns: "剖面列",
     format: "格式",
     filterInterpolation: "使用 {{example}} 插值濾波器值。",

package/corpus/templates/analytics/app/i18n-data.ts

@@ -908,12 +908,25 @@ const enUS = {
     chartTypePie: "Pie",
     chartTypeMetric: "Metric",
     chartTypeTable: "Table",
+    chartTypeExtension: "Extension",
     failedToSavePanel: "Failed to save panel",
     failedToFormatSql: "Failed to format SQL",
     title: "Title",
     titlePlaceholder: "e.g. Weekly signups",
     chartType: "Chart type",
     source: "Source",
+    extensionDisplay: "Extension display",
+    sharedExtension: "Shared extension",
+    perViewerSlot: "Per-viewer slot",
+    extension: "Extension",
+    loadingExtensions: "Loading extensions...",
+    selectExtension: "Select an extension",
+    noExtensions: "No visible extensions. Create or share one first.",
+    sharedExtensionHelp:
+      "The selected extension is shared with this dashboard and appears in scheduled reports. Viewers still need access to the extension.",
+    slotIdOptional: "Slot ID (optional)",
+    perViewerSlotHelp:
+      "Each viewer installs their own extension. Scheduled reports may show an empty slot. Leave blank to generate a stable ID.",
     sectionColumns: "Section columns",
     format: "Format",
     filterInterpolation: "Use {{example}} to interpolate filter values.",
@@ -1352,12 +1365,25 @@ const analyticsSliceTranslations: {
       chartTypePie: "馅饼",
       chartTypeMetric: "公制",
       chartTypeTable: "桌子",
+      chartTypeExtension: "扩展",
       failedToSavePanel: "保存面板失败",
       failedToFormatSql: "格式化SQL失败",
       title: "标题",
       titlePlaceholder: "例如每周注册人数",
       chartType: "图表类型",
       source: "来源",
+      extensionDisplay: "扩展显示方式",
+      sharedExtension: "共享扩展",
+      perViewerSlot: "每位查看者的插槽",
+      extension: "扩展",
+      loadingExtensions: "正在加载扩展...",
+      selectExtension: "选择扩展",
+      noExtensions: "没有可见的扩展。请先创建或共享一个。",
+      sharedExtensionHelp:
+        "所选扩展会与此仪表板共享并显示在计划报告中。查看者仍需拥有该扩展的访问权限。",
+      slotIdOptional: "插槽 ID（可选）",
+      perViewerSlotHelp:
+        "每位查看者各自安装扩展。计划报告可能显示空插槽。留空即可生成稳定 ID。",
       sectionColumns: "剖面列",
       format: "格式",
       filterInterpolation: "使用 {{example}} 插值滤波器值。",
@@ -1627,12 +1653,25 @@ const analyticsSliceTranslations: {
       chartTypePie: "Pastel",
       chartTypeMetric: "Métrico",
       chartTypeTable: "Mesa",
+      chartTypeExtension: "Extensión",
       failedToSavePanel: "No se pudo guardar el panel",
       failedToFormatSql: "No se pudo formatear SQL",
       title: "Título",
       titlePlaceholder: "p.ej. Inscripciones semanales",
       chartType: "Tipo de gráfico",
       source: "Fuente",
+      extensionDisplay: "Visualización de extensión",
+      sharedExtension: "Extensión compartida",
+      perViewerSlot: "Espacio por usuario",
+      extension: "Extensión",
+      loadingExtensions: "Cargando extensiones...",
+      selectExtension: "Selecciona una extensión",
+      noExtensions: "No hay extensiones visibles. Crea o comparte una primero.",
+      sharedExtensionHelp:
+        "La extensión seleccionada se comparte con este panel y aparece en los informes programados. Los usuarios aún necesitan acceso a ella.",
+      slotIdOptional: "ID del espacio (opcional)",
+      perViewerSlotHelp:
+        "Cada usuario instala su propia extensión. Los informes programados pueden mostrar un espacio vacío. Déjalo en blanco para generar un ID estable.",
       sectionColumns: "Columnas de sección",
       format: "Formato",
       filterInterpolation:
@@ -1918,12 +1957,25 @@ const analyticsSliceTranslations: {
       chartTypePie: "Tarte",
       chartTypeMetric: "Métrique",
       chartTypeTable: "Tableau",
+      chartTypeExtension: "Extension",
       failedToSavePanel: "Échec de l'enregistrement du panneau",
       failedToFormatSql: "Échec du formatage du SQL",
       title: "Titre",
       titlePlaceholder: "par ex. Inscriptions hebdomadaires",
       chartType: "Type de graphique",
       source: "Source de données",
+      extensionDisplay: "Affichage de l'extension",
+      sharedExtension: "Extension partagée",
+      perViewerSlot: "Emplacement par utilisateur",
+      extension: "Extension",
+      loadingExtensions: "Chargement des extensions...",
+      selectExtension: "Sélectionner une extension",
+      noExtensions: "Aucune extension visible. Créez-en ou partagez-en une.",
+      sharedExtensionHelp:
+        "L'extension sélectionnée est partagée avec ce tableau de bord et apparaît dans les rapports planifiés. Les utilisateurs doivent toujours y avoir accès.",
+      slotIdOptional: "ID de l'emplacement (facultatif)",
+      perViewerSlotHelp:
+        "Chaque utilisateur installe sa propre extension. Les rapports planifiés peuvent afficher un emplacement vide. Laissez ce champ vide pour générer un ID stable.",
       sectionColumns: "Colonnes de section",
       format: "Mettre en forme",
       filterInterpolation:
@@ -2207,12 +2259,26 @@ const analyticsSliceTranslations: {
       chartTypePie: "Torte",
       chartTypeMetric: "Metrisch",
       chartTypeTable: "Tisch",
+      chartTypeExtension: "Erweiterung",
       failedToSavePanel: "Das Panel konnte nicht gespeichert werden",
       failedToFormatSql: "SQL konnte nicht formatiert werden",
       title: "Titel",
       titlePlaceholder: "z.B. Wöchentliche Anmeldungen",
       chartType: "Diagrammtyp",
       source: "Datenquelle",
+      extensionDisplay: "Erweiterungsanzeige",
+      sharedExtension: "Geteilte Erweiterung",
+      perViewerSlot: "Slot pro Betrachter",
+      extension: "Erweiterung",
+      loadingExtensions: "Erweiterungen werden geladen...",
+      selectExtension: "Erweiterung auswählen",
+      noExtensions:
+        "Keine sichtbaren Erweiterungen. Erstellen oder teilen Sie zuerst eine.",
+      sharedExtensionHelp:
+        "Die ausgewählte Erweiterung wird mit diesem Dashboard geteilt und erscheint in geplanten Berichten. Betrachter benötigen weiterhin Zugriff darauf.",
+      slotIdOptional: "Slot-ID (optional)",
+      perViewerSlotHelp:
+        "Jeder Betrachter installiert eine eigene Erweiterung. Geplante Berichte können einen leeren Slot zeigen. Leer lassen, um eine stabile ID zu erzeugen.",
       sectionColumns: "Abschnittsspalten",
       format: "Formatieren",
       filterInterpolation:
@@ -2492,12 +2558,26 @@ const analyticsSliceTranslations: {
       chartTypePie: "パイ",
       chartTypeMetric: "メトリック",
       chartTypeTable: "テーブル",
+      chartTypeExtension: "拡張機能",
       failedToSavePanel: "パネルの保存に失敗しました",
       failedToFormatSql: "SQLのフォーマットに失敗しました",
       title: "タイトル",
       titlePlaceholder: "例えば毎週のサインアップ",
       chartType: "グラフの種類",
       source: "ソース",
+      extensionDisplay: "拡張機能の表示",
+      sharedExtension: "共有拡張機能",
+      perViewerSlot: "閲覧者ごとのスロット",
+      extension: "拡張機能",
+      loadingExtensions: "拡張機能を読み込んでいます...",
+      selectExtension: "拡張機能を選択",
+      noExtensions:
+        "表示できる拡張機能がありません。先に作成または共有してください。",
+      sharedExtensionHelp:
+        "選択した拡張機能はこのダッシュボードと共有され、スケジュール済みレポートにも表示されます。閲覧者には拡張機能へのアクセス権が必要です。",
+      slotIdOptional: "スロット ID（任意）",
+      perViewerSlotHelp:
+        "各閲覧者が自分の拡張機能をインストールします。スケジュール済みレポートでは空のスロットが表示される場合があります。空欄にすると安定した ID が生成されます。",
       sectionColumns: "セクション列",
       format: "形式",
       filterInterpolation:
@@ -2771,12 +2851,26 @@ const analyticsSliceTranslations: {
       chartTypePie: "파이",
       chartTypeMetric: "미터법",
       chartTypeTable: "테이블",
+      chartTypeExtension: "확장 프로그램",
       failedToSavePanel: "패널을 저장하지 못했습니다.",
       failedToFormatSql: "SQL 포맷 실패",
       title: "제목",
       titlePlaceholder: "예를 들어 주간 가입",
       chartType: "차트 종류",
       source: "소스",
+      extensionDisplay: "확장 프로그램 표시",
+      sharedExtension: "공유 확장 프로그램",
+      perViewerSlot: "사용자별 슬롯",
+      extension: "확장 프로그램",
+      loadingExtensions: "확장 프로그램을 불러오는 중...",
+      selectExtension: "확장 프로그램 선택",
+      noExtensions:
+        "표시할 확장 프로그램이 없습니다. 먼저 만들거나 공유하세요.",
+      sharedExtensionHelp:
+        "선택한 확장 프로그램은 이 대시보드와 공유되며 예약 보고서에 표시됩니다. 사용자는 해당 확장 프로그램에 대한 액세스 권한이 필요합니다.",
+      slotIdOptional: "슬롯 ID(선택 사항)",
+      perViewerSlotHelp:
+        "각 사용자가 자신의 확장 프로그램을 설치합니다. 예약 보고서에는 빈 슬롯이 표시될 수 있습니다. 비워 두면 안정적인 ID가 생성됩니다.",
       sectionColumns: "섹션 열",
       format: "체재",
       filterInterpolation: "{{example}}를 사용하여 필터 값을 보간합니다.",
@@ -3049,12 +3143,26 @@ const analyticsSliceTranslations: {
       chartTypePie: "Torta",
       chartTypeMetric: "Métrica",
       chartTypeTable: "Mesa",
+      chartTypeExtension: "Extensão",
       failedToSavePanel: "Falha ao salvar painel",
       failedToFormatSql: "Falha ao formatar SQL",
       title: "Título",
       titlePlaceholder: "por exemplo Inscrições semanais",
       chartType: "Tipo de gráfico",
       source: "Fonte",
+      extensionDisplay: "Exibição da extensão",
+      sharedExtension: "Extensão compartilhada",
+      perViewerSlot: "Slot por usuário",
+      extension: "Extensão",
+      loadingExtensions: "Carregando extensões...",
+      selectExtension: "Selecione uma extensão",
+      noExtensions:
+        "Nenhuma extensão visível. Crie ou compartilhe uma primeiro.",
+      sharedExtensionHelp:
+        "A extensão selecionada é compartilhada com este painel e aparece nos relatórios agendados. Os usuários ainda precisam de acesso à extensão.",
+      slotIdOptional: "ID do slot (opcional)",
+      perViewerSlotHelp:
+        "Cada usuário instala sua própria extensão. Relatórios agendados podem mostrar um slot vazio. Deixe em branco para gerar um ID estável.",
       sectionColumns: "Colunas de seção",
       format: "Formatar",
       filterInterpolation: "Use {{example}} para interpolar valores de filtro.",
@@ -3330,12 +3438,25 @@ const analyticsSliceTranslations: {
       chartTypePie: "पाई",
       chartTypeMetric: "मीट्रिक",
       chartTypeTable: "मेज़",
+      chartTypeExtension: "एक्सटेंशन",
       failedToSavePanel: "पैनल सहेजने में विफल",
       failedToFormatSql: "SQL को फ़ॉर्मेट करने में विफल",
       title: "शीर्षक",
       titlePlaceholder: "जैसे साप्ताहिक साइनअप",
       chartType: "चार्ट प्रकार",
       source: "स्रोत",
+      extensionDisplay: "एक्सटेंशन प्रदर्शन",
+      sharedExtension: "साझा एक्सटेंशन",
+      perViewerSlot: "प्रति-दर्शक स्लॉट",
+      extension: "एक्सटेंशन",
+      loadingExtensions: "एक्सटेंशन लोड हो रहे हैं...",
+      selectExtension: "एक एक्सटेंशन चुनें",
+      noExtensions: "कोई दृश्यमान एक्सटेंशन नहीं है। पहले एक बनाएं या साझा करें।",
+      sharedExtensionHelp:
+        "चुना गया एक्सटेंशन इस डैशबोर्ड के साथ साझा होता है और निर्धारित रिपोर्ट में दिखाई देता है। दर्शकों को फिर भी एक्सटेंशन की पहुंच चाहिए।",
+      slotIdOptional: "स्लॉट ID (वैकल्पिक)",
+      perViewerSlotHelp:
+        "हर दर्शक अपना एक्सटेंशन इंस्टॉल करता है। निर्धारित रिपोर्ट में खाली स्लॉट दिख सकता है। स्थिर ID बनाने के लिए खाली छोड़ें।",
       sectionColumns: "अनुभाग स्तंभ",
       format: "प्रारूप",
       filterInterpolation:
@@ -3605,12 +3726,25 @@ const analyticsSliceTranslations: {
       chartTypePie: "فطيرة",
       chartTypeMetric: "متري",
       chartTypeTable: "طاولة",
+      chartTypeExtension: "إضافة",
       failedToSavePanel: "فشل حفظ اللوحة",
       failedToFormatSql: "فشل تهيئة SQL",
       title: "عنوان",
       titlePlaceholder: "على سبيل المثال الاشتراكات الأسبوعية",
       chartType: "نوع الرسم البياني",
       source: "المصدر",
+      extensionDisplay: "عرض الإضافة",
+      sharedExtension: "إضافة مشتركة",
+      perViewerSlot: "فتحة لكل مشاهد",
+      extension: "إضافة",
+      loadingExtensions: "جارٍ تحميل الإضافات...",
+      selectExtension: "اختر إضافة",
+      noExtensions: "لا توجد إضافات ظاهرة. أنشئ إضافة أو شاركها أولاً.",
+      sharedExtensionHelp:
+        "تتم مشاركة الإضافة المحددة مع لوحة المعلومات هذه وتظهر في التقارير المجدولة. لا يزال المشاهدون بحاجة إلى صلاحية الوصول إليها.",
+      slotIdOptional: "معرّف الفتحة (اختياري)",
+      perViewerSlotHelp:
+        "يثبّت كل مشاهد إضافته الخاصة. قد تعرض التقارير المجدولة فتحة فارغة. اتركه فارغاً لإنشاء معرّف ثابت.",
       sectionColumns: "أعمدة القسم",
       format: "شكل",
       filterInterpolation: "استخدم {{example}} لاستكمال قيم التصفية.",

package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/PanelEditorDialog.tsx

@@ -41,6 +41,7 @@ import { Textarea } from "@/components/ui/textarea";
 import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";
 import { canFormatPanelSql, formatPanelSql } from "@/lib/format-sql";
 
+import { dashboardExtensionSlotId } from "./extension-slot";
 import {
   clampDashboardColumns,
   clampPanelWidth,
@@ -58,6 +59,7 @@ const CHART_TYPES: { value: ChartType; labelKey: string }[] = [
   { value: "pie", labelKey: "panelEditor.chartTypePie" },
   { value: "metric", labelKey: "panelEditor.chartTypeMetric" },
   { value: "table", labelKey: "panelEditor.chartTypeTable" },
+  { value: "extension", labelKey: "panelEditor.chartTypeExtension" },
 ];
 
 const SOURCES: { value: DataSourceType; label: string }[] = [
@@ -78,6 +80,22 @@ interface DataProgramSummary {
   archivedAt: string | null;
 }
 
+export interface ExtensionSummary {
+  id: string;
+  name: string;
+}
+
+export function extensionOptionsWithSelectedFallback(
+  extensions: ExtensionSummary[],
+  selectedId: string,
+): ExtensionSummary[] {
+  const id = selectedId.trim();
+  if (!id || extensions.some((extension) => extension.id === id)) {
+    return extensions;
+  }
+  return [{ id, name: id }, ...extensions];
+}
+
 /** Parsed shape of a `program` panel's `sql` field: {programId, params?}. */
 function parseProgramDescriptor(sql: string): {
   programId: string;
@@ -136,9 +154,12 @@ export interface PanelFormValues {
   columns: number;
   sql: string;
   description: string;
+  extensionMode: "shared" | "slot";
+  extensionId: string;
+  extensionSlotId: string;
 }
 
-function panelToForm(panel: SqlPanel | null): PanelFormValues {
+export function panelToForm(panel: SqlPanel | null): PanelFormValues {
   if (!panel) {
     return {
       title: "",
@@ -148,6 +169,9 @@ function panelToForm(panel: SqlPanel | null): PanelFormValues {
       columns: DEFAULT_DASHBOARD_COLUMNS,
       sql: "",
       description: "",
+      extensionMode: "shared",
+      extensionId: "",
+      extensionSlotId: "",
     };
   }
   return {
@@ -158,13 +182,17 @@ function panelToForm(panel: SqlPanel | null): PanelFormValues {
     columns: clampDashboardColumns(panel.columns ?? DEFAULT_DASHBOARD_COLUMNS),
     sql: panel.sql,
     description: panel.config?.description ?? "",
+    extensionMode: panel.config?.extensionSlotId ? "slot" : "shared",
+    extensionId: panel.config?.extensionId ?? "",
+    extensionSlotId: panel.config?.extensionSlotId ?? "",
   };
 }
 
-function formToPanel(
+export function formToPanel(
   form: PanelFormValues,
   existing: SqlPanel | null,
   untitledPanel: string,
+  dashboardId: string,
 ): SqlPanel {
   const id = existing?.id ?? generatePanelId(form.title);
   const description = form.description.trim();
@@ -175,11 +203,23 @@ function formToPanel(
   } else {
     delete config.description;
   }
+  const isExtension = form.chartType === "extension";
+  if (isExtension && form.extensionMode === "slot") {
+    delete config.extensionId;
+    config.extensionSlotId =
+      form.extensionSlotId.trim() || dashboardExtensionSlotId(dashboardId, id);
+  } else if (isExtension) {
+    config.extensionId = form.extensionId.trim();
+    delete config.extensionSlotId;
+  } else {
+    delete config.extensionId;
+    delete config.extensionSlotId;
+  }
   const isSection = form.chartType === "section";
   return {
     id,
     title: form.title.trim() || untitledPanel,
-    sql: form.sql,
+    sql: isExtension ? "" : form.sql,
     source: form.source,
     chartType: form.chartType,
     width: clampPanelWidth(form.width, MAX_DASHBOARD_COLUMNS),
@@ -249,6 +289,7 @@ function PanelEditorContent({
   }, [open, panel]);
 
   const isEdit = !!panel;
+  const isExtensionPanel = form.chartType === "extension";
   const isProgramSource = form.source === "program";
   const { programId, paramsText: initialParamsText } = useMemo(
     () =>
@@ -276,11 +317,25 @@ function PanelEditorContent({
   const availablePrograms = (programsData?.programs ?? []).filter(
     (p) => !p.archivedAt,
   );
+  const { data: extensionsData, isLoading: extensionsLoading } =
+    useActionQuery<{
+      ok: boolean;
+      count: number;
+      extensions: ExtensionSummary[];
+    }>("list-extensions", { limit: 100 }, { enabled: isExtensionPanel });
+  const availableExtensions = extensionsData?.extensions ?? [];
+  const extensionOptions = extensionOptionsWithSelectedFallback(
+    availableExtensions,
+    form.extensionId,
+  );
 
-  const canSave = isProgramSource
-    ? form.title.trim().length > 0 && selectedProgramId.trim().length > 0
-    : form.title.trim().length > 0 && form.sql.trim().length > 0;
-  const canFormat = canFormatPanelSql(form.source);
+  const canSave = isExtensionPanel
+    ? form.title.trim().length > 0 &&
+      (form.extensionMode === "slot" || form.extensionId.trim().length > 0)
+    : isProgramSource
+      ? form.title.trim().length > 0 && selectedProgramId.trim().length > 0
+      : form.title.trim().length > 0 && form.sql.trim().length > 0;
+  const canFormat = !isExtensionPanel && canFormatPanelSql(form.source);
 
   const handleSubmit = async () => {
     if (!canSave || saving) return;
@@ -305,6 +360,7 @@ function PanelEditorContent({
           { ...form, sql: sqlForSave },
           panel,
           t("panelEditor.untitledPanel"),
+          dashboardId,
         ),
       );
       onOpenChange(false);
@@ -327,18 +383,19 @@ function PanelEditorContent({
       message: trimmed,
       context:
         `The user wants to add a new panel to SQL dashboard "${dashboardId}". ${titlesLine} ` +
-        `REAL_DATA_REQUIRED: before saving or answering, run at least one real data-source query action for this panel; \`data-source-status\`, \`list-data-dictionary\`, \`update-dashboard\`, \`mutate-dashboard\`, and dry-run validation do not count as data queries. ` +
+        `REAL_DATA_REQUIRED: before saving or answering with a data panel, run at least one real data-source query action for this panel; \`data-source-status\`, \`list-data-dictionary\`, \`update-dashboard\`, \`mutate-dashboard\`, and dry-run validation do not count as data queries. Embedding an existing extension without presenting new data does not require a data-source query. ` +
         `The \`demo\` source is reserved for the built-in Node Exporter demo and does not satisfy REAL_DATA_REQUIRED unless the user explicitly asks to work on that demo dashboard. ` +
         `If no source can answer, report the exact unavailable/error result instead of saving a panel with guessed schema or metrics. ` +
         `Use the \`mutate-dashboard\` action with code like \`dashboard.insertPanel({"id":"new-panel","title":"New Panel","source":"first-party","chartType":"metric","width":1,"sql":"SELECT COUNT(*) AS value FROM analytics_events"}).atBottom();\` ` +
         `to append, or \`.nextTo("panel-id")\`, \`.atRow(2)\`, \`.atRowStart(2)\`, \`.before("panel-id")\`, \`.after("panel-id")\`, or \`.atIndex(n)\` to place the panel. Prefer \`.nextTo("panel-id")\` or \`.atRow(rowNumber)\` for visible row placement requests; they keep the chart in the intended rendered row and expand/rebalance that row when needed. ` +
-        `Panel shape: { id (unique slug), title, sql, source ('bigquery'|'ga4'|'amplitude'|'first-party'|'demo'|'prometheus'|'program'), chartType ('line'|'area'|'bar'|'metric'|'table'|'pie'|'section'), width (legacy integer 1..6; set to 1 unless editing existing data), tab? (use 'Group / Tab' for grouped tabs), columns? (section panels only - 1..6 max panels per row for panels following this section), config? }. ` +
+        `Panel shape: { id (unique slug), title, sql, source ('bigquery'|'ga4'|'amplitude'|'first-party'|'demo'|'prometheus'|'program'), chartType ('line'|'area'|'bar'|'metric'|'table'|'pie'|'section'|'extension'), width (legacy integer 1..6; set to 1 unless editing existing data), tab? (use 'Group / Tab' for grouped tabs), columns? (section panels only - 1..6 max panels per row for panels following this section), config? }. ` +
         `Visible layout auto-fits by row: one panel in a row spans the row, two split it, three split it into thirds, up to the section column limit. ` +
         `For amplitude panels, sql is a JSON descriptor: {"event":"event name","groupBy":"property","days":30}. ` +
         `For first-party panels, sql is read-only SQL over analytics_events only; use source 'first-party' and do not call db-query for this datasource. ` +
         `For demo panels, sql uses the same Prometheus JSON descriptor shape as source 'prometheus': {"promql":"rate(http_requests_total[5m])","mode":"range","range":"1h","step":"30s"}. ` +
         `For prometheus panels, sql is a JSON descriptor: {"promql":"rate(http_requests_total[5m])","mode":"range","range":"1h","step":"30s"}. mode defaults to "range"; range defaults to "1h"; step is auto if omitted. Returned rows have shape {timestamp, series, value} — set config.xKey="timestamp", config.yKey="value", and a single series in config.yKeys for clean charting. ` +
         `For program panels (arbitrary provider data joins/cohorts not expressible in the other sources), first save-data-program (or reuse an existing one via list-data-programs), then set sql to a JSON descriptor: {"programId":"<id>","params":{...}}. See the data-programs skill for the emit(rows, schema) contract and the Risk Meeting worked example. ` +
+        `For extension panels, use config.extensionId by default so every dashboard viewer and scheduled report renders the author-selected shared extension. Use config.extensionSlotId only when the user explicitly asks for a personal/per-viewer slot; slot installs are per-user and automated report identities may have no install. ` +
         `Config is optional: { xKey, yKey, yKeys, yFormatter ('number'|'currency'|'percent'), description, columns, pivot, limit, color, colors, stacked, legend, valueLabels }. ` +
         `Chart legends render automatically; set config.legend=false only when the user explicitly asks to hide the legend. ` +
         `Use \`get-sql-dashboard.layout.groups[].rows[].rowNumber/panelIds\` to identify and verify visible rows. ` +
@@ -397,26 +454,28 @@ function PanelEditorContent({
           </Select>
         </div>
 
-        <div className="grid gap-1.5">
-          <Label htmlFor="panel-source">{t("panelEditor.source")}</Label>
-          <Select
-            value={form.source}
-            onValueChange={(v: DataSourceType) =>
-              setForm((f) => ({ ...f, source: v }))
-            }
-          >
-            <SelectTrigger id="panel-source" className="h-9 text-sm">
-              <SelectValue />
-            </SelectTrigger>
-            <SelectContent>
-              {SOURCES.map((s) => (
-                <SelectItem key={s.value} value={s.value}>
-                  {s.label}
-                </SelectItem>
-              ))}
-            </SelectContent>
-          </Select>
-        </div>
+        {!isExtensionPanel ? (
+          <div className="grid gap-1.5">
+            <Label htmlFor="panel-source">{t("panelEditor.source")}</Label>
+            <Select
+              value={form.source}
+              onValueChange={(v: DataSourceType) =>
+                setForm((f) => ({ ...f, source: v }))
+              }
+            >
+              <SelectTrigger id="panel-source" className="h-9 text-sm">
+                <SelectValue />
+              </SelectTrigger>
+              <SelectContent>
+                {SOURCES.map((s) => (
+                  <SelectItem key={s.value} value={s.value}>
+                    {s.label}
+                  </SelectItem>
+                ))}
+              </SelectContent>
+            </Select>
+          </div>
+        ) : null}
 
         {form.chartType === "section" ? (
           <div className="grid gap-1.5">
@@ -448,7 +507,99 @@ function PanelEditorContent({
         ) : null}
       </div>
 
-      {isProgramSource ? (
+      {isExtensionPanel ? (
+        <div className="grid gap-4 rounded-lg border p-4">
+          <div className="grid gap-1.5">
+            <Label htmlFor="panel-extension-mode">
+              {t("panelEditor.extensionDisplay")}
+            </Label>
+            <Select
+              value={form.extensionMode}
+              onValueChange={(value: "shared" | "slot") =>
+                setForm((current) => ({
+                  ...current,
+                  extensionMode: value,
+                }))
+              }
+            >
+              <SelectTrigger id="panel-extension-mode" className="h-9 text-sm">
+                <SelectValue />
+              </SelectTrigger>
+              <SelectContent>
+                <SelectItem value="shared">
+                  {t("panelEditor.sharedExtension")}
+                </SelectItem>
+                <SelectItem value="slot">
+                  {t("panelEditor.perViewerSlot")}
+                </SelectItem>
+              </SelectContent>
+            </Select>
+          </div>
+
+          {form.extensionMode === "shared" ? (
+            <div className="grid gap-1.5">
+              <Label htmlFor="panel-extension">
+                {t("panelEditor.extension")}
+              </Label>
+              <Select
+                value={form.extensionId || undefined}
+                onValueChange={(extensionId) =>
+                  setForm((current) => ({ ...current, extensionId }))
+                }
+              >
+                <SelectTrigger id="panel-extension" className="h-9 text-sm">
+                  <SelectValue
+                    placeholder={
+                      extensionsLoading
+                        ? t("panelEditor.loadingExtensions")
+                        : t("panelEditor.selectExtension")
+                    }
+                  />
+                </SelectTrigger>
+                <SelectContent>
+                  {extensionOptions.map((extension) => (
+                    <SelectItem key={extension.id} value={extension.id}>
+                      {extension.name}
+                    </SelectItem>
+                  ))}
+                </SelectContent>
+              </Select>
+              {!extensionsLoading && availableExtensions.length === 0 ? (
+                <p className="text-xs text-muted-foreground">
+                  {t("panelEditor.noExtensions")}
+                </p>
+              ) : null}
+              <p className="text-xs text-muted-foreground">
+                {t("panelEditor.sharedExtensionHelp")}
+              </p>
+            </div>
+          ) : (
+            <div className="grid gap-1.5">
+              <Label htmlFor="panel-extension-slot">
+                {t("panelEditor.slotIdOptional")}
+              </Label>
+              <Input
+                id="panel-extension-slot"
+                value={form.extensionSlotId}
+                onChange={(event) =>
+                  setForm((current) => ({
+                    ...current,
+                    extensionSlotId: event.target.value,
+                  }))
+                }
+                placeholder={dashboardExtensionSlotId(
+                  dashboardId,
+                  panel?.id ?? "generated-panel-id",
+                )}
+                className="font-mono text-xs"
+              />
+              <p className="text-xs text-muted-foreground">
+                {t("panelEditor.perViewerSlotHelp")}
+              </p>
+            </div>
+          )}
+        </div>
+      ) : isProgramSource ? (
         <div className="grid gap-4">
           <div className="grid gap-1.5">
             <Label htmlFor="panel-program">

package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/SqlChartCard.tsx

@@ -404,6 +404,12 @@ export function SqlChartCard({
               {editable ? (
                 <>
                   <DropdownMenuSeparator />
+                  {onEdit ? (
+                    <DropdownMenuItem onSelect={() => onEdit()}>
+                      <IconPencil className="h-4 w-4 mr-2" />
+                      {t("sidebar.edit")}
+                    </DropdownMenuItem>
+                  ) : null}
                   <DropdownMenuItem
                     onSelect={(e) => {
                       e.preventDefault();

package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/types.ts

@@ -99,12 +99,13 @@ export interface SqlPanelConfig {
   /**
    * Extension panels only (`chartType: "extension"`): id of the extension to
    * render inline as a sandboxed iframe instead of running the SQL pipeline.
-   * Kept for dashboards saved before slot-backed dashboard boxes.
+   * This is the default for author-selected dashboard content because the
+   * selection is shared with the dashboard and available to report captures.
    */
   extensionId?: string;
   /**
-   * Extension panels only: a named extension-point slot. The dashboard renders
-   * its installed extensions as this panel's box and supplies dashboard context.
+   * Extension panels only: an opt-in named extension-point slot. Each viewer's
+   * personal installs render in the box and receive dashboard context.
    */
   extensionSlotId?: string;
 }

package/corpus/templates/analytics/changelog/2026-07-17-dashboard-editors-can-add-shared-extensions-or-opt-into-per-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-17
+---
+
+Dashboard editors can add shared extensions or opt into per-viewer widget slots.

package/corpus/templates/analytics/changelog/2026-07-17-dashboard-extensions-show-a-loading-skeleton.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-17
+---
+
+Dashboard extensions now show a loading skeleton while their content loads.