@agent-native/core 0.106.3 → 0.107.1

package/corpus/templates/analytics/actions/clone-creative-context-dashboard.ts

@@ -0,0 +1,86 @@
+import { createHash, randomUUID } from "node:crypto";
+
+import { defineAction } from "@agent-native/core";
+import {
+  readPrivateBlob,
+  type PrivateBlobHandle,
+} from "@agent-native/core/private-blob";
+import {
+  getRequestOrgId,
+  getRequestUserEmail,
+} from "@agent-native/core/server";
+import { resolveNativeContextCloneReference } from "@agent-native/creative-context/server";
+import { z } from "zod";
+
+import {
+  getDashboard,
+  upsertDashboard,
+} from "../server/lib/dashboards-store.js";
+
+const payloadSchema = z.object({
+  id: z.string(),
+  kind: z.enum(["explorer", "sql"]),
+  title: z.string(),
+  config: z.record(z.string(), z.unknown()),
+  updatedAt: z.string(),
+});
+
+export default defineAction({
+  description:
+    "Clone an exact governed SQL-backed Analytics dashboard without executing any of its queries.",
+  schema: z.object({
+    contextId: z.string(),
+    artifactKey: z.string(),
+    resourceId: z.string(),
+    expectedUpdatedAt: z.string().optional(),
+    title: z.string().optional(),
+  }),
+  publicAgent: { expose: true, readOnly: false, requiresAuth: true },
+  run: async (args) => {
+    const email = getRequestUserEmail();
+    if (!email) throw new Error("no authenticated user");
+    const orgId = getRequestOrgId() ?? null;
+    const reference = await resolveNativeContextCloneReference({
+      appId: "analytics",
+      resourceType: "dashboard",
+      resourceId: args.resourceId,
+      expectedUpdatedAt: args.expectedUpdatedAt,
+      contextId: args.contextId,
+      artifactKey: args.artifactKey,
+    });
+    const raw = await readPrivateBlob(
+      reference.cloneHandle as PrivateBlobHandle,
+    );
+    const body = Buffer.from(raw.data).toString("utf8");
+    const hash = createHash("sha256").update(body).digest("hex");
+    if (
+      raw.metadata?.appId !== "analytics" ||
+      raw.metadata?.resourceType !== "dashboard" ||
+      raw.metadata?.resourceId !== args.resourceId ||
+      raw.metadata?.contentHash !== hash
+    )
+      throw new Error(
+        "Governed dashboard clone payload failed integrity verification.",
+      );
+    const payload = payloadSchema.parse(JSON.parse(body));
+    const id = `sql-dashboard-${randomUUID()}`;
+    const dashboard = await upsertDashboard(
+      id,
+      payload.kind,
+      {
+        title: args.title?.trim() || `Copy of ${payload.title}`,
+        ...payload.config,
+      },
+      { email, orgId },
+    );
+    const persisted = await getDashboard(id, { email, orgId });
+    if (!persisted || persisted.updatedAt !== dashboard.updatedAt)
+      throw new Error("Dashboard clone did not persist.");
+    return {
+      id: persisted.id,
+      title: persisted.title,
+      kind: persisted.kind,
+      clonedExactVersion: reference.publishedItemVersionId,
+    };
+  },
+});

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

@@ -132,7 +132,7 @@ export const DASHBOARD_MUTATION_EXAMPLES = [
   `dashboard.insertPanel({"id":"new-kpi","title":"New KPI","source":"first-party","chartType":"metric","width":1,"config":{"timeScope":"dashboard"},"sql":"SELECT COUNT(*) AS value FROM analytics_events WHERE event_date >= '{{dateStart}}' AND event_date < '{{dateEnd}}'"}).atTop();`,
   `dashboard.insertPanel({"id":"new-chart","title":"New Chart","source":"first-party","chartType":"line","width":1,"config":{"timeScope":"dashboard"},"sql":"SELECT event_date AS date, COUNT(*) AS value FROM analytics_events WHERE event_date >= '{{dateStart}}' AND event_date < '{{dateEnd}}' GROUP BY event_date ORDER BY event_date"}).nextTo("retention-over-time");`,
   `dashboard.insertPanel({"id":"row-chart","title":"Row Chart","source":"first-party","chartType":"bar","width":1,"config":{"timeScope":"dashboard"},"sql":"SELECT event_name AS name, COUNT(*) AS value FROM analytics_events WHERE event_date >= '{{dateStart}}' AND event_date < '{{dateEnd}}' GROUP BY event_name"}).atRow(2);`,
-  'dashboard.insertPanel({"id":"pipeline-widget","title":"Pipeline Widget","chartType":"extension","width":3,"config":{"extensionId":"<existing-extension-id>"}}).atBottom();',
+  'dashboard.insertPanel({"id":"pipeline-widget","title":"Pipeline Widget","chartType":"extension","width":3,"config":{"extensionSlotId":"analytics.dashboard.<dashboard-id>.panel.pipeline-widget"}}).atBottom();',
 ] as const;
 
 export type DashboardMutationOperation =

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

@@ -369,8 +369,12 @@ export function validateDashboardConfig(
         cfg && typeof cfg.extensionId === "string"
           ? cfg.extensionId.trim()
           : "";
-      if (!extensionId) {
-        return `panel[${i}].config.extensionId is required for extension panels (the id of the extension to render inline)`;
+      const extensionSlotId =
+        cfg && typeof cfg.extensionSlotId === "string"
+          ? cfg.extensionSlotId.trim()
+          : "";
+      if (!extensionId && !extensionSlotId) {
+        return `panel[${i}].config.extensionId or config.extensionSlotId is required for extension panels`;
       }
     }
     if (

package/corpus/templates/analytics/app/components/dashboard/SqlChart.tsx

@@ -1,5 +1,8 @@
 import { useDemoModeStatus, useT } from "@agent-native/core/client";
-import { EmbeddedExtension } from "@agent-native/core/client/extensions";
+import {
+  EmbeddedExtension,
+  ExtensionSlot,
+} from "@agent-native/core/client/extensions";
 import {
   IconArrowsSort,
   IconSortAscending,
@@ -1185,6 +1188,8 @@ interface SqlChartProps {
   className?: string;
   loadData?: boolean;
   onExportCsvChange?: (handler: (() => void) | null) => void;
+  /** Dashboard/panel state sent to slot-backed extension boxes. */
+  extensionContext?: Record<string, unknown> | null;
 }
 
 export function SqlChart({
@@ -1192,6 +1197,7 @@ export function SqlChart({
   resolvedSql,
   loadData = true,
   onExportCsvChange,
+  extensionContext,
 }: SqlChartProps) {
   const t = useT();
   const { enabled: demoModeEnabled } = useDemoModeStatus();
@@ -1266,11 +1272,12 @@ export function SqlChart({
     );
   }
 
-  // Extension panels render a sandboxed extension iframe instead of querying a
-  // data source. The extension id lives in config.extensionId.
+  // Extension panels render either a named extension-point slot or a legacy
+  // direct extension iframe instead of querying a data source.
   if (isExtension) {
     const extensionId = panel.config?.extensionId;
-    if (!extensionId) {
+    const slotId = panel.config?.extensionSlotId;
+    if (!extensionId && !slotId) {
       return (
         <div className="flex flex-1 items-center justify-center px-4 py-8 min-h-[120px]">
           <p className="text-sm text-muted-foreground text-center">
@@ -1280,7 +1287,12 @@ export function SqlChart({
       );
     }
     return (
-      <DashboardExtensionPanel extensionId={extensionId} panelId={panel.id} />
+      <DashboardExtensionPanel
+        extensionId={extensionId}
+        panelId={panel.id}
+        slotId={slotId}
+        context={extensionContext}
+      />
     );
   }
   const colors = panel.config?.colors || DEFAULT_COLORS;
@@ -1409,9 +1421,13 @@ export function SqlChart({
 function DashboardExtensionPanel({
   extensionId,
   panelId,
+  slotId,
+  context,
 }: {
-  extensionId: string;
+  extensionId?: string;
   panelId: string;
+  slotId?: string;
+  context?: Record<string, unknown> | null;
 }) {
   const t = useT();
   // Hold the report-readiness marker until the extension iframe paints so
@@ -1419,6 +1435,18 @@ function DashboardExtensionPanel({
   const [ready, setReady] = useState(false);
   const [unavailable, setUnavailable] = useState(false);
 
+  if (slotId) {
+    return (
+      <ExtensionSlot
+        id={slotId}
+        context={context}
+        showEmptyAffordance
+        className="min-h-[120px] w-full"
+        toolClassName="w-full"
+      />
+    );
+  }
+
   // Embedding never grants access to the extension itself (same model as
   // ExtensionSlots). A viewer with dashboard-only access who can't see the
   // referenced extension gets a clear message instead of a blank panel.
@@ -1438,7 +1466,7 @@ function DashboardExtensionPanel({
       data-dashboard-report-loading={ready ? undefined : "true"}
     >
       <EmbeddedExtension
-        extensionId={extensionId}
+        extensionId={extensionId!}
         slotId={`dashboard-panel-${panelId}`}
         className="w-full"
         // Intentional for v1: extension panels are standalone widgets and do not

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

@@ -10,6 +10,7 @@ import {
   useT,
 } from "@agent-native/core/client";
 import { InvitationBanner } from "@agent-native/core/client/org";
+import { CreativeContextComposerChip } from "@agent-native/creative-context/client";
 import { useEffect, useMemo } from "react";
 import { useLocation, useNavigate } from "react-router";
 
@@ -162,8 +163,6 @@ export function Layout({ children }: LayoutProps) {
     activePath: location.pathname,
     enabled: !isAskRoute && !reportScreenshot,
   });
-  const sidebarScope = chatHomeHandoffActive ? null : analyticsScope;
-
   useEffect(() => {
     function handleChatRunning(event: Event) {
       const detail = (event as CustomEvent).detail;
@@ -293,7 +292,8 @@ export function Layout({ children }: LayoutProps) {
               t("chat.suggestionAnomalies"),
               t("chat.suggestionMrr"),
             ]}
-            scope={sidebarScope}
+            scope={analyticsScope}
+            composerSlot={<CreativeContextComposerChip />}
           >
             {contentFrame}
           </AgentSidebar>

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

@@ -598,6 +598,7 @@ const messages = {
     untitledTheme: "無標題主題",
   },
   dashboard: {
+    sqlDashboard: "SQL 儀表板",
     historyTitle: "儀表板歷史記錄",
     historyDescription: "還原先前的儀表板狀態。還原前會先保存目前狀態。",
     historyEmpty: "尚無歷史記錄。下一次編輯後，變更會自動保存在這裡。",

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

@@ -34,6 +34,7 @@ const enUS = {
     created: "Created {{date}}",
   },
   dashboard: {
+    sqlDashboard: "SQL dashboard",
     historyTitle: "Dashboard history",
     historyDescription:
       "Restore a previous dashboard state. Restoring snapshots the current state first.",

package/corpus/templates/analytics/app/pages/Ask.tsx

@@ -3,6 +3,7 @@ import {
   useAgentChatContext,
   useT,
 } from "@agent-native/core/client";
+import { CreativeContextComposerChip } from "@agent-native/creative-context/client";
 import { useEffect, useMemo, useState } from "react";
 
 import {
@@ -54,10 +55,13 @@ export default function AskPage() {
         composerLayoutVariant="hero"
         composerPlaceholder={t("common.askPlaceholder")}
         composerSlot={
-          <div className="analytics-chat-intro">
-            <h1>{t("common.askIntroTitle")}</h1>
-            <p>{t("common.askIntroBody")}</p>
-          </div>
+          <>
+            <CreativeContextComposerChip />
+            <div className="analytics-chat-intro">
+              <h1>{t("common.askIntroTitle")}</h1>
+              <p>{t("common.askIntroBody")}</p>
+            </div>
+          </>
         }
       />
     </div>

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

@@ -67,6 +67,7 @@ interface SqlChartCardProps {
   isDragSource?: boolean;
   selectedForChat?: boolean;
   onSelectForChat?: (options?: SelectDashboardPanelOptions) => void;
+  extensionContext?: Record<string, unknown> | null;
 }
 
 const PanelDragHandle = memo(function PanelDragHandle({
@@ -122,6 +123,7 @@ export function SqlChartCard({
   isDragSource = false,
   selectedForChat = false,
   onSelectForChat,
+  extensionContext,
 }: SqlChartCardProps) {
   const t = useT();
   const queryClient = useQueryClient();
@@ -346,6 +348,7 @@ export function SqlChartCard({
             panel={panel}
             resolvedSql={resolvedSql}
             loadData
+            extensionContext={extensionContext}
           />
         )}
         <div className="absolute right-1 top-1 flex items-center gap-1 opacity-0 group-hover:opacity-100">
@@ -435,6 +438,7 @@ export function SqlChartCard({
                   panel={panel}
                   resolvedSql={resolvedSql}
                   loadData
+                  extensionContext={extensionContext}
                 />
               </ChartFillHeight>
             </div>
@@ -616,6 +620,7 @@ export function SqlChartCard({
             resolvedSql={resolvedSql}
             loadData={shouldLoadData}
             onExportCsvChange={handleExportCsvChange}
+            extensionContext={extensionContext}
           />
         </CardContent>
       </Card>
@@ -627,7 +632,12 @@ export function SqlChartCard({
           </DialogHeader>
           <div className="flex min-h-0 flex-1 flex-col overflow-auto">
             <ChartFillHeight>
-              <SqlChart panel={panel} resolvedSql={resolvedSql} loadData />
+              <SqlChart
+                panel={panel}
+                resolvedSql={resolvedSql}
+                loadData
+                extensionContext={extensionContext}
+              />
             </ChartFillHeight>
           </div>
         </DialogContent>

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

@@ -0,0 +1,11 @@
+/**
+ * Stable extension-point name for a dashboard box. The dashboard and panel ids
+ * are encoded independently so arbitrary saved ids cannot collapse into one
+ * slot or add path separators to the slots API.
+ */
+export function dashboardExtensionSlotId(
+  dashboardId: string,
+  panelId: string,
+): string {
+  return `analytics.dashboard.${encodeURIComponent(dashboardId)}.panel.${encodeURIComponent(panelId)}`;
+}

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

@@ -13,6 +13,10 @@ import {
   useT,
   type CollabUser,
 } from "@agent-native/core/client";
+import {
+  CreativeContextShareSheet,
+  CreativeContextShareTab,
+} from "@agent-native/creative-context/client";
 import {
   useDroppable,
   DndContext,
@@ -138,6 +142,7 @@ import {
   resolveFilterVars,
 } from "./DashboardFilterBar";
 import { EmailReportDialog } from "./EmailReportDialog";
+import { dashboardExtensionSlotId } from "./extension-slot";
 import { interpolate } from "./interpolate";
 import { serializePanelSql } from "./panel-sql";
 import { AddPanelPopover, PanelEditorDialog } from "./PanelEditorDialog";
@@ -267,6 +272,7 @@ const PanelCell = memo(function PanelCell({
   onRemovePanel,
   onEditPanel,
   onSavePanel,
+  dashboardExtensionContext,
 }: {
   panel: SqlPanel;
   vars: Record<string, string>;
@@ -282,6 +288,7 @@ const PanelCell = memo(function PanelCell({
   onRemovePanel: (panelId: string) => void;
   onEditPanel: (panel: SqlPanel) => void;
   onSavePanel: (panel: SqlPanel) => Promise<void>;
+  dashboardExtensionContext: Record<string, unknown>;
 }) {
   const resolved = useMemo(
     () =>
@@ -362,6 +369,23 @@ const PanelCell = memo(function PanelCell({
         isDragSource={isDragSource}
         selectedForChat={selectedForChat}
         onSelectForChat={handleSelectForChat}
+        extensionContext={
+          panel.chartType === "extension"
+            ? {
+                ...dashboardExtensionContext,
+                panel: {
+                  id: panel.id,
+                  title: panel.title,
+                  slotId:
+                    panel.config?.extensionSlotId ??
+                    dashboardExtensionSlotId(
+                      String(dashboardExtensionContext.dashboardId),
+                      panel.id,
+                    ),
+                },
+              }
+            : undefined
+        }
       />
     </div>
   );
@@ -504,6 +528,7 @@ export default function SqlDashboardPage() {
   const [emailReportOpen, setEmailReportOpen] = useState(false);
   const [historyOpen, setHistoryOpen] = useState(false);
   const [dashboardActionsOpen, setDashboardActionsOpen] = useState(false);
+  const [contextSheetOpen, setContextSheetOpen] = useState(false);
   const [activeDropSlot, setActiveDropSlot] =
     useState<DashboardDropSlot | null>(null);
   const [activeDragPanelId, setActiveDragPanelId] = useState<string | null>(
@@ -1424,6 +1449,29 @@ export default function SqlDashboardPage() {
             resourceId={dashboardId}
             resourceTitle={dashboard.name}
             variant="compact"
+            shareTabs={{
+              tabs: [
+                {
+                  value: "context",
+                  label: "Context",
+                  content: (
+                    <CreativeContextShareTab
+                      resource={{
+                        appId: "analytics",
+                        resourceType: "dashboard",
+                        resourceId: dashboardId,
+                        title: dashboard.name,
+                        updatedAt: dashboardUpdatedAt ?? undefined,
+                        preview: {
+                          kind: "document",
+                          label: t("dashboard.sqlDashboard"),
+                        },
+                      }}
+                    />
+                  ),
+                },
+              ],
+            }}
           />
         ) : null}
         {canEdit ? (
@@ -1509,6 +1557,18 @@ export default function SqlDashboardPage() {
             {(canEdit && !archivedAt) || canManage ? (
               <DropdownMenuSeparator />
             ) : null}
+            {dashboardId && canEdit && !archivedAt ? (
+              <DropdownMenuItem
+                onSelect={(event) => {
+                  event.preventDefault();
+                  setDashboardActionsOpen(false);
+                  setContextSheetOpen(true);
+                }}
+              >
+                <IconPlus className="mr-2 h-3.5 w-3.5" />
+                {t("creativeContext.addToContext" /* i18n-key-ignore */)}
+              </DropdownMenuItem>
+            ) : null}
             {dashboardId ? (
               <>
                 <DropdownMenuSeparator />
@@ -1581,6 +1641,25 @@ export default function SqlDashboardPage() {
             canRestore={canEdit && !archivedAt}
           />
         ) : null}
+        {dashboardId ? (
+          <CreativeContextShareSheet
+            open={contextSheetOpen}
+            onOpenChange={setContextSheetOpen}
+            resource={{
+              appId: "analytics",
+              resourceType: "dashboard",
+              resourceId: dashboardId,
+              title: dashboard.name,
+              updatedAt: dashboardUpdatedAt ?? undefined,
+              visibility: dashboardVisibility ?? undefined,
+              preview: {
+                kind: "document",
+                label: t("dashboard.sqlDashboard"),
+              },
+            }}
+            canManage={canManage}
+          />
+        ) : null}
         {canManage ? (
           <AlertDialog
             open={confirmDeleteOpen}
@@ -1907,6 +1986,13 @@ export default function SqlDashboardPage() {
                                 onRemovePanel={removePanel}
                                 onEditPanel={openEditPanel}
                                 onSavePanel={handleSavePanel}
+                                dashboardExtensionContext={{
+                                  dashboardId,
+                                  dashboardName: dashboard.name,
+                                  dashboardDescription:
+                                    dashboard.description ?? null,
+                                  filters: vars,
+                                }}
                               />
                               <DashboardDropLine
                                 slot={{

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

@@ -99,8 +99,14 @@ 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.
    */
   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.
+   */
+  extensionSlotId?: string;
 }
 
 export interface SqlPanel {

package/corpus/templates/analytics/app/routes/agent.tsx

@@ -1,5 +1,11 @@
 import { AgentTabsPage } from "@agent-native/core/client";
+import { createCreativeContextAgentTab } from "@agent-native/creative-context/client";
 
 export default function AgentRoute() {
-  return <AgentTabsPage appName="Analytics" />;
+  return (
+    <AgentTabsPage
+      appName="Analytics"
+      extraTabFactories={[createCreativeContextAgentTab]}
+    />
+  );
 }

package/corpus/templates/analytics/changelog/2026-07-17-dashboard-extension-boxes.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+Dashboards can now host installed extensions as contextual, slot-backed boxes.

package/corpus/templates/analytics/changelog/2026-07-17-library-now-flags-published-dashboards-with-newer-versions-a.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-17
+---
+
+Library now flags published dashboards with newer versions and lets you submit the update in place.

package/corpus/templates/analytics/changelog/2026-07-17-resources-can-be-added-to-creative-context-from-their-action.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+Resources can be added to Creative Context from their action menus.

package/corpus/templates/analytics/changelog/2026-07-17-you-can-add-exact-approved-artifact-versions-to-governed-cre.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+You can add exact, approved artifact versions to governed Creative Contexts for safe reuse.

package/corpus/templates/analytics/package.json

@@ -15,6 +15,7 @@
   },
   "dependencies": {
     "@agent-native/core": "workspace:*",
+    "@agent-native/creative-context": "workspace:*",
     "@agent-native/toolkit": "workspace:*",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",

package/corpus/templates/analytics/server/lib/agent-readable-resource-context.ts

@@ -64,6 +64,14 @@ function panelSummaries(config: Record<string, unknown>) {
         typeof panelConfig.description === "string"
           ? panelConfig.description
           : undefined,
+      extensionId:
+        typeof panelConfig.extensionId === "string"
+          ? panelConfig.extensionId
+          : undefined,
+      extensionSlotId:
+        typeof panelConfig.extensionSlotId === "string"
+          ? panelConfig.extensionSlotId
+          : undefined,
     };
   });
 }