@aintela/bi 0.2.2 → 0.2.3

package/dist/{index-K50t61iI.js → index-DChE_l-p.js}

@@ -1,4 +1,4 @@
-import { C as e, S as a, a as r, r as o, u as t } from "./ScriptDashboardViewerVertical-CuwnxisJ.js";
+import { C as e, S as a, a as r, r as o, u as t } from "./ScriptDashboardViewerVertical-Rr_4adpH.js";
 const i = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   CATEGORY_PREFIXES: e,
@@ -10,4 +10,4 @@ const i = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
 export {
   i as V
 };
-//# sourceMappingURL=index-K50t61iI.js.map
+//# sourceMappingURL=index-DChE_l-p.js.map

package/dist/index-DChE_l-p.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DChE_l-p.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/{index-DOpx0R4Y.js → index-Dy6hwDjs.js}

@@ -1,5 +1,5 @@
 import { D as a, c as t, a as e, b as r, d as s, e as o, f as m, g as l, h as i, i as u, j as c, k as f, l as n, m as p, p as C, t as D, n as d, o as b, q as h, r as x, s as S, u as P, v as T, w as g, x as v } from "./dataUtils-CAUE5uZY.js";
-import { C as y, a as B, u as _ } from "./ChartCardDefaultsContext-Cl5T25H0.js";
+import { C as y, a as B, u as _ } from "./ChartCardDefaultsContext-BDRsVljO.js";
 import { c as j, r as F, u as N } from "./createBiTheme-TyUv_UHM.js";
 const w = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
@@ -38,4 +38,4 @@ const w = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
 export {
   w as D
 };
-//# sourceMappingURL=index-DOpx0R4Y.js.map
+//# sourceMappingURL=index-Dy6hwDjs.js.map

package/dist/index-Dy6hwDjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-Dy6hwDjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.js

@@ -1,40 +1,40 @@
 import { b as s, a as r, c as t, d as o, r as i, u as n, w as d } from "./createBiTheme-TyUv_UHM.js";
-import { B as l, c as m, u } from "./index-D7Oo_dC-.js";
-import { B as c, b as E, c as S, d as D, u as T, a as h, e as P } from "./BiClientProvider-CWJochvi.js";
-import { D as f, c as I, a as B, b as R, d as b, e as g, f as A, g as L, h as x, i as G, j as v, k as M, l as O, m as V, p as F, t as N, n as y, o as k, q as U, r as H, s as w, u as z, v as Y, w as W, x as X } from "./dataUtils-CAUE5uZY.js";
-import { C as j, a as q, u as Z } from "./ChartCardDefaultsContext-Cl5T25H0.js";
-import { B as Q, C as $, a as aa, D as ea, G as sa, b as ra, c as ta, d as oa, e as ia, f as na, M as da, g as Ca, h as la, i as ma, j as ua, T as pa, k as ca, l as Ea, m as Sa, n as Da, u as Ta, w as ha, o as Pa } from "./index-DeiweWw8.js";
+import { B as C, c as u, u as m } from "./index-D7Oo_dC-.js";
+import { B as c, b as E, c as S, d as D, u as T, a as P, e as h } from "./BiClientProvider-CWJochvi.js";
+import { D as f, c as I, a as B, b as R, d as b, e as g, f as A, g as L, h as x, i as v, j as G, k as O, l as M, m as V, p as F, t as N, n as y, o as k, q as z, r as H, s as U, u as w, v as Y, w as W, x as X } from "./dataUtils-CAUE5uZY.js";
+import { C as j, a as q, u as Z } from "./ChartCardDefaultsContext-BDRsVljO.js";
+import { B as Q, C as $, a as aa, D as ea, G as sa, b as ra, c as ta, d as oa, e as ia, f as na, M as da, g as la, h as Ca, i as ua, j as ma, T as pa, k as ca, l as Ea, m as Sa, n as Da, u as Ta, w as Pa, o as ha } from "./index-9LcZjCK0.js";
 import { u as fa } from "./useContainerRectangle-D464wPFX.js";
-import { B as Ba, D as Ra, a as ba, b as ga, c as Aa, d as La, G as xa, e as Ga } from "./GridLayout-1gWuIKeZ.js";
-import { G as Ma } from "./GridCardPlaceHolder-DVVT3pqn.js";
+import { B as Ba, D as Ra, a as ba, b as ga, c as Aa, d as La, G as xa, e as va } from "./GridLayout-1gWuIKeZ.js";
+import { G as Oa } from "./GridCardPlaceHolder-DVVT3pqn.js";
 import { C as Va, u as Fa } from "./ChartContext-C_f_6khG.js";
-import { t as ya, a as ka, b as Ua, u as Ha } from "./index-BzUugG0A.js";
-import { C as za, I as Ya, M as Wa, a as Xa, p as Ka } from "./index-BYc79sSy.js";
+import { t as ya, a as ka, b as za, u as Ha } from "./index-BzUugG0A.js";
+import { C as wa, I as Ya, M as Wa, a as Xa, p as Ka } from "./index-BYc79sSy.js";
 import { A as qa, D as Za, a as Ja, V as Qa, b as $a, c as ae, d as ee, g as se } from "./filterFactory-Ysv0FOQ2.js";
 import { V as te, a as oe, b as ie } from "./index-BRx4bRbe.js";
-import { B as de, c as Ce, n as le, r as me, a as ue } from "./version-BpSiNdYv.js";
-import { getBiModuleSurface as ce } from "./biModuleSurface--gLAiZ9Z.js";
-import { C as Se, S as De, a as Te, c as he, e as Pe, g as _e, b as fe, h as Ie, i as Be, l as Re, r as be, s as ge, u as Ae } from "./ScriptDashboardViewerVertical-CuwnxisJ.js";
-import { C as xe, a as Ge, b as ve, c as Me, d as Oe, e as Ve, f as Fe, g as Ne, h as ye, i as ke, D as Ue, j as He, k as we, l as ze, m as Ye, n as We, o as Xe, p as Ke, q as je, E as qe, r as Ze, s as Je, t as Qe, u as $e, v as as, F as es, w as ss, x as rs, G as ts, y as os, H as is, P as ns, z as ds, A as Cs, S as ls, B as ms, I as us, J as ps, T as cs, K as Es, L as Ss, M as Ds, N as Ts, V as hs, O as Ps, Q as _s, R as fs, U as Is, W as Bs, X as Rs, Y as bs, Z as gs, _ as As, $ as Ls, a0 as xs, a1 as Gs, a2 as vs, a3 as Ms, a4 as Os, a5 as Vs, a6 as Fs, a7 as Ns, a8 as ys, a9 as ks, aa as Us, ab as Hs, ac as ws, ad as zs, ae as Ys, af as Ws, ag as Xs, ah as Ks, ai as js, aj as qs, ak as Zs, al as Js, am as Qs, an as $s, ao as ar, ap as er, aq as sr, ar as rr, as as tr, at as or, au as ir, av as nr, aw as dr, ax as Cr, ay as lr, az as mr } from "./index-DULVx84u.js";
-import { EnvironmentProvider as pr, InertEnvironmentProvider as cr, useEnvironment as Er, useEnvironmentOptional as Sr } from "@aintela/chat/components";
-import { u as Tr, a as hr } from "./index-D3OoOPjl.js";
-import { D as _r, a as fr, u as Ir } from "./DashboardParametersContext-Clv--79U.js";
+import { B as de, c as le, n as Ce, r as ue, a as me } from "./version-BTc4ElDG.js";
+import { getBiModuleSurface as ce } from "./biModuleSurface-BdJK7sSL.js";
+import { C as Se, S as De, a as Te, c as Pe, e as he, g as _e, b as fe, h as Ie, i as Be, l as Re, r as be, s as ge, u as Ae } from "./ScriptDashboardViewerVertical-Rr_4adpH.js";
+import { C as xe, a as ve, b as Ge, c as Oe, d as Me, e as Ve, f as Fe, g as Ne, h as ye, i as ke, D as ze, j as He, k as Ue, l as we, m as Ye, n as We, o as Xe, p as Ke, q as je, E as qe, r as Ze, s as Je, t as Qe, u as $e, v as as, F as es, w as ss, x as rs, G as ts, y as os, H as is, P as ns, z as ds, A as ls, S as Cs, B as us, I as ms, J as ps, K as cs, L as Es, M as Ss, T as Ds, N as Ts, O as Ps, Q as hs, R as _s, V as fs, U as Is, W as Bs, X as Rs, Y as bs, Z as gs, _ as As, $ as Ls, a0 as xs, a1 as vs, a2 as Gs, a3 as Os, a4 as Ms, a5 as Vs, a6 as Fs, a7 as Ns, a8 as ys, a9 as ks, aa as zs, ab as Hs, ac as Us, ad as ws, ae as Ys, af as Ws, ag as Xs, ah as Ks, ai as js, aj as qs, ak as Zs, al as Js, am as Qs, an as $s, ao as ar, ap as er, aq as sr, ar as rr, as as tr, at as or, au as ir, av as nr, aw as dr, ax as lr, ay as Cr, az as ur, aA as mr, aB as pr, aC as cr, aD as Er, aE as Sr, aF as Dr } from "./index-C4_VSDeU.js";
+import { EnvironmentProvider as Pr, InertEnvironmentProvider as hr, useEnvironment as _r, useEnvironmentOptional as fr } from "@aintela/chat/components";
+import { u as Br, a as Rr } from "./index-D3OoOPjl.js";
+import { D as gr, a as Ar, u as Lr } from "./DashboardParametersContext-Clv--79U.js";
 export {
   qa as AutoCompleteInstructions,
   Q as BASE_SCALE,
   de as BI_RUNTIME_VERSION,
   c as BiClientProvider,
   Ba as BiErrorBoundary,
-  l as BiThemeBridge,
+  C as BiThemeBridge,
   xe as CARD_TYPE_CATALOG,
-  Ge as CATEGORY_ICONS,
+  ve as CATEGORY_ICONS,
   Se as CATEGORY_PREFIXES,
-  ve as COLOR_MAP,
+  Ge as COLOR_MAP,
   $ as CONTINENT_PATHS,
-  Me as CardScketch,
-  Oe as CardSketch,
+  Oe as CardScketch,
+  Me as CardSketch,
   Ve as CardTypeIconsProvider,
-  za as Chart,
+  wa as Chart,
   aa as ChartCard,
   j as ChartCardDefaultsContext,
   q as ChartCardDefaultsProvider,
@@ -46,15 +46,15 @@ export {
   Ra as DEFAULT_BREAKPOINTS,
   ba as DEFAULT_COLS,
   ga as DEFAULT_MAX_ROWS,
-  Ue as DEFAULT_PAD_HEIGHT_PX,
+  ze as DEFAULT_PAD_HEIGHT_PX,
   Aa as DEFAULT_ROW_HEIGHT,
   La as DEFAULT_ROW_MULTIPLIER,
   He as DRAFT_SAVE_DEBOUNCE_MS,
-  we as DashboardPad,
-  ze as DashboardPadEditor,
+  Ue as DashboardPad,
+  we as DashboardPadEditor,
   Ye as DashboardPadSketch,
-  _r as DashboardParametersContext,
-  fr as DashboardParametersProvider,
+  gr as DashboardParametersContext,
+  Ar as DashboardParametersProvider,
   We as DashboardPin,
   Xe as DashboardSidePanel,
   f as DataResult,
@@ -65,7 +65,7 @@ export {
   je as DrawablePrompt,
   qe as ENV_HIGHLIGHT_CLASS,
   Ze as EntryEmptyState,
-  pr as EnvironmentProvider,
+  Pr as EnvironmentProvider,
   Je as ExampleCardSkath,
   Qe as ExampleCardSketch,
   $e as ExampleCardSketh,
@@ -82,161 +82,167 @@ export {
   ia as GaugeGroup,
   na as GeoLayersProvider,
   xa as GridCard,
-  Ma as GridCardPlaceHolder,
-  Ga as GridLayout,
+  Oa as GridCardPlaceHolder,
+  va as GridLayout,
   is as HoverButton,
   Ya as IFrame,
-  cr as InertEnvironmentProvider,
+  hr as InertEnvironmentProvider,
   da as MAP_VIEWBOX,
-  Ca as MapBubblesCard,
-  la as MapConnectionsCard,
+  la as MapBubblesCard,
+  Ca as MapConnectionsCard,
   Wa as Metric,
-  ma as MetricCard,
+  ua as MetricCard,
   Xa as MetricGroup,
-  ua as MetricGroupCard,
+  ma as MetricGroupCard,
   ns as PAD_INTERNAL_CLASSES,
   ds as PAD_INTERNAL_IDS,
-  Cs as PrototypePad,
-  ls as SPECIFIC_TYPE_ICONS,
-  ms as SPECIFIC_TYPE_ICON_NAMES,
-  us as STARTER_TEMPLATES,
+  ls as PrototypePad,
+  Cs as SPECIFIC_TYPE_ICONS,
+  us as SPECIFIC_TYPE_ICON_NAMES,
+  ms as STARTER_TEMPLATES,
   De as ScriptDashboardViewer,
   Te as ScriptDashboardViewerVertical,
-  ps as SpotlightOverlay,
-  cs as TEMPLATE_KIND_TO_SKETCH,
-  Es as TextSketh,
-  Ss as TitleSkath,
-  Ds as TitleSketch,
-  Ts as ToolBox,
+  ps as SessionVisualizationsPanel,
+  cs as SessionVisualizationsPanelButton,
+  Es as SessionVisualizationsProvider,
+  Ss as SpotlightOverlay,
+  Ds as TEMPLATE_KIND_TO_SKETCH,
+  Ts as TextSketh,
+  Ps as TitleSkath,
+  hs as TitleSketch,
+  _s as ToolBox,
   pa as TreeMapCard,
-  hs as VIEWER_COMMIT_DEBOUNCE_MS,
+  fs as VIEWER_COMMIT_DEBOUNCE_MS,
+  Is as VISIBLE_THRESHOLD,
+  Bs as VisualizationFrame,
   Qa as VizAutoComplete,
   $a as VizDatePicker,
   ae as VizDateRangePicker,
   te as VizSelect,
   oe as VizTextField,
   ie as VizTriggerButton,
-  Ps as activityPanelVariants,
-  _s as activityPanelVariantsReduced,
-  fs as ambientVariants,
-  Is as ambientVariantsReduced,
-  Bs as autoComplete,
+  Rs as activityPanelVariants,
+  bs as activityPanelVariantsReduced,
+  gs as ambientVariants,
+  As as ambientVariantsReduced,
+  Ls as autoComplete,
   s as biDarkPalette,
   E as biDateReviver,
   r as biLightPalette,
   t as biSeriesColor,
   ca as brazilGeoLayers,
-  Rs as c,
+  xs as c,
   I as capitalize,
-  bs as categoryPrefix,
+  vs as categoryPrefix,
   Ea as chartShade,
-  he as clearBundleCaches,
-  gs as composerLayoutTransition,
-  As as composerLayoutTransitionReduced,
-  m as computeBiCssVars,
+  Pe as clearBundleCaches,
+  Gs as composerLayoutTransition,
+  Os as composerLayoutTransitionReduced,
+  u as computeBiCssVars,
   B as computeDomain,
   Sa as computeMapViewport,
   R as computeTicks,
   S as createBiClient,
   o as createBiTheme,
-  Ce as createBiUiTools,
-  Ls as createComposerStore,
-  xs as createDashboardDraft,
+  le as createBiUiTools,
+  Ms as createComposerStore,
+  Vs as createDashboardDraft,
   ee as createFilterComponent,
-  Gs as datePicker,
-  vs as dateRange,
+  Fs as datePicker,
+  Ns as dateRange,
   D as defaultBiRoutes,
-  Ms as defaultCardTypeIcons,
-  Os as defaultComposerSuggestions,
-  Vs as defaultComposerTemplates,
+  ys as defaultCardTypeIcons,
+  ks as defaultComposerSuggestions,
+  zs as defaultComposerTemplates,
   b as defineSchema,
-  Fs as environmentFromStore,
-  Pe as evaluateDashboardBundle,
+  Hs as environmentFromStore,
+  he as evaluateDashboardBundle,
   g as extractFieldDescriptor,
   A as extractFieldTypeName,
   L as formatBoolean,
   x as formatCompact,
-  G as formatCurrency,
-  v as formatDate,
-  M as formatISODate,
-  O as formatNumber,
+  v as formatCurrency,
+  G as formatDate,
+  O as formatISODate,
+  M as formatNumber,
   V as formatPercent,
-  Ns as fromUpsertResponse,
+  Us as fromUpsertResponse,
   ce as getBiModuleSurface,
   se as getFriendlyName,
   _e as getHostModules,
   fe as getRegisteredSpecifiers,
-  ys as groupCardCatalog,
-  ks as guideStepsRequireSketch,
+  ws as groupCardCatalog,
+  Ys as guideStepsRequireSketch,
   Ie as hashBundleCode,
   Be as instantiateDashboardBundle,
-  Us as isElementVisible,
-  Hs as isSimplePadDefinition,
-  ws as joinClientSideChanges,
+  Ws as isElementVisible,
+  Xs as isSimplePadDefinition,
+  Ks as joinClientSideChanges,
   Da as latLngToXY,
   Re as loadDashboardBundle,
-  le as normalizeMetricArgs,
-  zs as padConfigToDashboard,
+  Ce as normalizeMetricArgs,
+  js as padConfigToDashboard,
   Ka as parseKnownNumbers,
   F as percentChange,
-  Ys as pickBestElement,
-  Ws as randomId,
-  me as registerBiModules,
-  ue as resetBiModuleRegistration,
+  qs as pickBestElement,
+  Zs as randomId,
+  ue as registerBiModules,
+  me as resetBiModuleRegistration,
   i as resolveBiPalette,
   be as resolveCardMetadata,
-  Xs as resolveComposerSurfaces,
-  Ks as resolveEnvironmentElements,
-  js as resolveGuideElement,
-  qs as sanitizeToJsVariable,
-  Zs as seedFromTemplate,
+  Js as resolveComposerSurfaces,
+  Qs as resolveEnvironmentElements,
+  $s as resolveGuideElement,
+  ar as sanitizeToJsVariable,
+  er as seedFromTemplate,
   ge as seedHostModules,
-  Js as sketchCardItemComparer,
-  Qs as sketchFilterComparer,
-  $s as targetSuggestsPadInternal,
-  ar as templateKinds,
+  sr as sketchCardItemComparer,
+  rr as sketchFilterComparer,
+  tr as targetSuggestsPadInternal,
+  or as templateKinds,
   N as toBoolean,
   y as toDashResult,
   k as toDataResultFromList,
-  U as toDate,
-  er as toDraftPayload,
+  z as toDate,
+  ir as toDraftPayload,
   H as toNumber,
-  sr as toSelectorList,
-  w as toStr,
-  z as toTitleCase,
+  nr as toSelectorList,
+  U as toStr,
+  w as toTitleCase,
   ya as translateGridConfig,
   ka as translateGridConfigAutoResponsive,
-  Ua as translateResponsiveGridConfig,
+  za as translateResponsiveGridConfig,
   Y as trendArrow,
   W as trendColor,
   X as truncateText,
-  rr as upsertDashboardDraft,
+  dr as upsertDashboardDraft,
   T as useBiClient,
-  h as useBiClientOptional,
-  u as useBiCssVars,
+  P as useBiClientOptional,
+  m as useBiCssVars,
   n as useBiPalette,
-  P as useBiSessionId,
-  tr as useCardTypeIcons,
+  h as useBiSessionId,
+  lr as useCardTypeIcons,
   Z as useChartCardDefaults,
   Fa as useChartContext,
-  or as useComposer,
-  ir as useComposerChatBridge,
-  nr as useComposerEnvironment,
-  dr as useComposerStore,
-  Cr as useComposerStoreOptional,
+  Cr as useComposer,
+  ur as useComposerChatBridge,
+  mr as useComposerEnvironment,
+  pr as useComposerStore,
+  cr as useComposerStoreOptional,
   fa as useContainerRectangle,
   Ae as useDashboardBundle,
-  Tr as useDashboardData,
-  hr as useDashboardLazyData,
-  lr as useDashboardPad,
-  Ir as useDashboardParameters,
-  Er as useEnvironment,
-  Sr as useEnvironmentOptional,
+  Br as useDashboardData,
+  Rr as useDashboardLazyData,
+  Er as useDashboardPad,
+  Lr as useDashboardParameters,
+  _r as useEnvironment,
+  fr as useEnvironmentOptional,
   Ta as useGeoLayers,
   Ha as useGridConfigTranslator,
-  mr as validateSketch,
-  ha as warnIfMuiXLicenseMissing,
+  Sr as useSessionVisualizations,
+  Dr as validateSketch,
+  Pa as warnIfMuiXLicenseMissing,
   d as withBiPalette,
-  Pa as worldGeoLayers
+  ha as worldGeoLayers
 };
 //# sourceMappingURL=index.js.map

package/dist/runtime/index.d.ts

@@ -6,4 +6,6 @@ export type { DashboardBundleResult } from './loadDashboardBundle';
 export { createBiUiTools, normalizeMetricArgs } from './createBiUiTools';
 export type { CreateBiUiToolsOptions, PresentMetricArgs, PresentChartArgs, PresentMetricGroupArgs, PresentIframeArgs, PresentDashboardPadArgs, PresentGuideArgs } from './createBiUiTools';
 export type { IDashboardDefinition, DashboardCardDefinition, DataSourceDefinition } from './IDashboardDefinition';
+export { SessionVisualizationsProvider, VisualizationFrame, useSessionVisualizations, VISIBLE_THRESHOLD, } from './sessionVisualizations';
+export type { SessionVisualization, SessionVisualizationsApi, SessionVisualizationsProviderProps, VisualizationFrameProps, VisualizationKind, } from './sessionVisualizations';
 export { BI_RUNTIME_VERSION } from './version';

package/dist/runtime/sessionVisualizations.d.ts

@@ -0,0 +1,61 @@
+import { default as React } from 'react';
+/** What kind of thing was drawn — the tag the panel and the card print. */
+export type VisualizationKind = 'metric' | 'chart' | 'table' | 'iframe' | 'dashboard';
+export interface SessionVisualization {
+    id: string;
+    kind: VisualizationKind;
+    /** What the card's header says; the panel repeats it. */
+    title?: string;
+    /** Grouping key — one per agent answer, so the panel can head a run with the time it arrived. */
+    group?: string;
+    /** When it was registered, for the group's eyebrow. */
+    at: number;
+    /** A small stand-in the panel draws: the chart's own image, a metric's value. Optional. */
+    preview?: React.ReactNode;
+    /** False while it is still being produced — the panel shows it dimmed. */
+    ready: boolean;
+    /** At least 60% of it is inside the scroller right now. */
+    visible: boolean;
+}
+export interface SessionVisualizationsProviderProps {
+    children: React.ReactNode;
+}
+/**
+ * Holds the registry for one conversation.
+ *
+ * <p>Mount it around BOTH the transcript and whatever reads the list. Outside a provider every piece here is
+ * inert rather than throwing — `VisualizationFrame` still renders its child, so a host that never wanted this
+ * feature is unaffected by the tools that now wrap their output in it.</p>
+ */
+export declare const SessionVisualizationsProvider: React.FC<SessionVisualizationsProviderProps>;
+export interface SessionVisualizationsApi {
+    /** Everything the session has drawn, in the order it was drawn. */
+    items: SessionVisualization[];
+    /** The ones that are NOT currently at least 60% inside the scroller. */
+    offscreen: SessionVisualization[];
+    /** Scroll the transcript to one of them and flash it. No-op for an id that is gone. */
+    scrollTo: (id: string) => void;
+    /** Tell the registry which element scrolls the transcript. Call from the host's scroller ref. */
+    setScroller: (el: HTMLElement | null) => void;
+}
+/** Read the session's visualizations. Safe outside a provider: an empty list and no-op actions. */
+export declare function useSessionVisualizations(): SessionVisualizationsApi;
+/** How much of a card has to be inside the scroller before the panel stops listing it. */
+export declare const VISIBLE_THRESHOLD = 0.6;
+export interface VisualizationFrameProps {
+    id: string;
+    kind: VisualizationKind;
+    title?: string;
+    group?: string;
+    preview?: React.ReactNode;
+    ready?: boolean;
+    children: React.ReactNode;
+}
+/**
+ * One drawn thing in the transcript, registered and watched.
+ *
+ * <p>It adds `data-viz` and a `data-viz-focus` attribute (set for two seconds when the panel scrolls here)
+ * and NOTHING else — no border, no padding, no colour. Appearance belongs to the card inside it and to the
+ * host's stylesheet, which can target `[data-viz-focus]` to draw the flash however it likes.</p>
+ */
+export declare const VisualizationFrame: React.FC<VisualizationFrameProps>;

package/dist/runtime/version.d.ts

@@ -3,4 +3,4 @@
  * `AIntelA.Bi.Agents` version at handshake (the instruction files describe
  * THIS React API). Kept in sync with package.json by `tests/runtime/version.test.ts`.
  */
-export declare const BI_RUNTIME_VERSION = "0.2.2";
+export declare const BI_RUNTIME_VERSION = "0.2.3";

package/dist/runtime.js

@@ -1,20 +1,25 @@
-import { B as a, c as o, n as r, r as t, a as d } from "./version-BpSiNdYv.js";
-import { getBiModuleSurface as l } from "./biModuleSurface--gLAiZ9Z.js";
-import { c as B, e as n, g as c, b as g, h, i as M, l as f, s as b } from "./ScriptDashboardViewerVertical-CuwnxisJ.js";
+import { B as a, c as o, n as i, r, a as t } from "./version-BTc4ElDG.js";
+import { getBiModuleSurface as d } from "./biModuleSurface-BdJK7sSL.js";
+import { c as n, e as B, g as c, b as g, h, i as M, l as S, s as f } from "./ScriptDashboardViewerVertical-Rr_4adpH.js";
+import { L as p, U as E, W as I, aE as R } from "./index-C4_VSDeU.js";
 export {
   a as BI_RUNTIME_VERSION,
-  B as clearBundleCaches,
+  p as SessionVisualizationsProvider,
+  E as VISIBLE_THRESHOLD,
+  I as VisualizationFrame,
+  n as clearBundleCaches,
   o as createBiUiTools,
-  n as evaluateDashboardBundle,
-  l as getBiModuleSurface,
+  B as evaluateDashboardBundle,
+  d as getBiModuleSurface,
   c as getHostModules,
   g as getRegisteredSpecifiers,
   h as hashBundleCode,
   M as instantiateDashboardBundle,
-  f as loadDashboardBundle,
-  r as normalizeMetricArgs,
-  t as registerBiModules,
-  d as resetBiModuleRegistration,
-  b as seedHostModules
+  S as loadDashboardBundle,
+  i as normalizeMetricArgs,
+  r as registerBiModules,
+  t as resetBiModuleRegistration,
+  f as seedHostModules,
+  R as useSessionVisualizations
 };
 //# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}
+{"version":3,"file":"runtime.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/version-BTc4ElDG.js

@@ -0,0 +1,122 @@
+var M = Object.defineProperty;
+var l = (t, i) => M(t, "name", { value: i, configurable: !0 });
+import { extendModuleRegistry as _, extendDefaultScope as b, createUiToolRegistry as w } from "@aintela/chat/components";
+import { getBiModuleSurface as B } from "./biModuleSurface-BdJK7sSL.js";
+import { s as I } from "./ScriptDashboardViewerVertical-Rr_4adpH.js";
+import { jsx as c } from "react/jsx-runtime";
+import { Box as p } from "@mui/material";
+import { M as g, a as V, C as k, I as E } from "./index-BYc79sSy.js";
+import { B as R } from "./BiClientProvider-CWJochvi.js";
+import { W as $ } from "./index-C4_VSDeU.js";
+const h = /* @__PURE__ */ new Set();
+function O(t) {
+  const i = { ...B(), ...t.extraScope ?? {} }, a = t.specifiers.filter((o) => !h.has(o));
+  for (const o of a)
+    _(o, i), h.add(o);
+  (a.length > 0 || t.extraScope) && b(i), I(t.specifiers, t.extraHostModules);
+}
+l(O, "registerBiModules");
+function P() {
+  h.clear();
+}
+l(P, "resetBiModuleRegistration");
+function y(t) {
+  const i = t ?? {}, a = /* @__PURE__ */ l((o) => {
+    const d = i[o] ?? i[o.charAt(0).toUpperCase() + o.slice(1)];
+    return d == null ? void 0 : String(d);
+  }, "g");
+  return {
+    currentValue: a("currentValue") ?? "",
+    previousValue: a("previousValue"),
+    prefix: a("prefix"),
+    suffix: a("suffix"),
+    differenceStyle: a("differenceStyle"),
+    description: a("description"),
+    icon: a("icon")
+  };
+}
+l(y, "normalizeMetricArgs");
+function S(t, i) {
+  let a = t;
+  for (let o = 0; o < 2 && typeof a == "string"; o++)
+    try {
+      a = JSON.parse(a);
+    } catch {
+      return i;
+    }
+  return a ?? i;
+}
+l(S, "parseJsonArg");
+function A(t) {
+  const i = t == null ? void 0 : t.id;
+  return typeof i == "string" ? i : void 0;
+}
+l(A, "groupOf");
+function T(t = {}) {
+  const { client: i, onExpandChart: a, onExpandIframe: o } = t, d = /* @__PURE__ */ l((e, r) => {
+    const n = /* @__PURE__ */ c(p, { sx: { my: 1 }, children: e }), f = r ? /* @__PURE__ */ c(
+      $,
+      {
+        id: r.frame.callId,
+        kind: r.kind,
+        title: r.title,
+        group: A(r.frame.message),
+        preview: r.preview,
+        ready: !r.frame.onGoing,
+        children: n
+      }
+    ) : n;
+    return i ? /* @__PURE__ */ c(R, { client: i, children: f }) : f;
+  }, "wrap"), x = (t.builder ?? w()).render("present_metric", (e, r) => {
+    const n = y(e);
+    return n.currentValue ? d(/* @__PURE__ */ c(g, { partial: !1, ...n }), {
+      kind: "metric",
+      title: n.description,
+      // The value IS the thumbnail for a KPI — nothing smaller says more about it.
+      preview: /* @__PURE__ */ c(p, { sx: { fontSize: 15, fontWeight: 600, letterSpacing: "-0.02em" }, children: `${n.prefix ?? ""}${n.currentValue}${n.suffix ?? ""}` }),
+      frame: r
+    }) : null;
+  }).render("present_metric_group", (e, r) => {
+    var f;
+    if (!((f = e.metrics) != null && f.length)) return null;
+    const n = e.metrics.map((u) => y(u));
+    return d(
+      /* @__PURE__ */ c(V, { partial: !1, title: e.title, materialIcon: e.materialIcon, footNote: e.footNote, children: n.map((u, m) => /* @__PURE__ */ c(g, { partial: !1, ...u }, m)) }),
+      {
+        kind: "metric",
+        title: e.title,
+        preview: /* @__PURE__ */ c(p, { sx: { display: "flex", gap: 1.5, flexWrap: "wrap", fontSize: 13, fontWeight: 600, letterSpacing: "-0.02em" }, children: n.slice(0, 3).map((u, m) => /* @__PURE__ */ c(p, { component: "span", children: `${u.prefix ?? ""}${u.currentValue}${u.suffix ?? ""}` }, m)) }),
+        frame: r
+      }
+    );
+  }).render("present_chart", (e, r) => e.src ? d(/* @__PURE__ */ c(k, { src: e.src, name: e.name, alt: e.alt, reasoning: e.reasoning, naked: e.naked, onExpand: a }), {
+    kind: "chart",
+    title: e.name ?? e.alt,
+    // The chart's OWN image, scaled down. A hand-drawn sparkline would be a second, different
+    // picture of the same data — and one this package would have to keep in step with the chart.
+    preview: i ? /* @__PURE__ */ c(p, { component: "img", src: i.artifactUrl(e.src), alt: "", sx: { maxWidth: "100%", maxHeight: 44, objectFit: "contain", display: "block" } }) : void 0,
+    frame: r
+  }) : null).render("present_iframe", (e, r) => !e.src || !e.name ? null : d(/* @__PURE__ */ c(E, { partial: !1, src: e.src, name: e.name, onExpand: o }), { kind: "iframe", title: e.name, frame: r })), s = t.environment;
+  return s ? x.action("refresh_dashboard", () => {
+    var e;
+    (e = s.refreshDashboard) == null || e.call(s);
+  }, { status: "Dashboard atualizado" }).action("present_dashboard_pad", (e) => {
+    var n, f;
+    const r = S(e.definitionJson, {});
+    e.mode === "create" ? (n = s.createDashboardPad) == null || n.call(s, r) : (f = s.updateDashboardPad) == null || f.call(s, r);
+  }, { status: "Rascunho atualizado" }).action("present_guide", (e) => {
+    var n;
+    const r = S(e.stepsJson, []);
+    Array.isArray(r) && r.length > 0 && ((n = s.showGuide) == null || n.call(s, r));
+  }, { status: "Guia iniciado" }) : x;
+}
+l(T, "createBiUiTools");
+const j = "0.2.3";
+export {
+  j as B,
+  P as a,
+  T as c,
+  y as n,
+  O as r
+};
+//# sourceMappingURL=version-BTc4ElDG.js.map