@heroui/agent 0.2.0-beta.1 → 0.2.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
- import { T as TrustedAgentClientData, S as SignedTrustedAgentClientData } from './identity-NYCXY1mT.js';
3
- export { A as AGENT_CONVERSATION_SOURCE, a as AgentAuthIdentity, b as AgentAuthProfile, c as AgentAuthToken, d as AgentConversationSource, e as AgentProjectConfig, f as AgentSurfaceVariant, g as AgentTheme, h as AgentTokenClaims, C as CreateAgentAuthTokenRequest, i as agentAuthIdentitySchema, j as agentAuthProfileSchema, k as agentAuthTokenSchema, l as agentIdentityIdSchema, m as agentProjectConfigSchema, n as agentSurfaceVariantSchema, o as agentThemeSchema, p as agentTokenClaimsSchema, q as createAgentAuthTokenRequestSchema, r as pageContextSchema, s as signedTrustedAgentClientDataSchema, t as trustedAgentClientDataSchema } from './identity-NYCXY1mT.js';
2
+ import { T as TrustedAgentClientData, S as SignedTrustedAgentClientData } from './identity-hIGFpObN.js';
3
+ export { A as AGENT_CONVERSATION_SOURCE, a as AgentAuthIdentity, b as AgentAuthProfile, c as AgentAuthToken, d as AgentConversationSource, e as AgentProjectConfig, f as AgentSurfaceVariant, g as AgentTheme, h as AgentTokenClaims, C as CreateAgentAuthTokenRequest, i as agentAuthIdentitySchema, j as agentAuthProfileSchema, k as agentAuthTokenSchema, l as agentIdentityIdSchema, m as agentProjectConfigSchema, n as agentSurfaceVariantSchema, o as agentThemeSchema, p as agentTokenClaimsSchema, q as createAgentAuthTokenRequestSchema, r as pageContextSchema, s as signedTrustedAgentClientDataSchema, t as trustedAgentClientDataSchema } from './identity-hIGFpObN.js';
4
4
  import { UIMessage } from 'ai';
5
5
 
6
6
  /** Maximum number of files accepted on one HeroUI Agent message. */
@@ -214,7 +214,17 @@ type KpiGridComponent = ComponentBase & {
214
214
  }>;
215
215
  };
216
216
  type LineChartComponent = CartesianComponent & {
217
+ /**
218
+ * `profit-loss` splits one series around `baseline`; `live` keeps the newest
219
+ * window visible and emphasizes its latest value. Both modes require one
220
+ * series so their visual meaning stays unambiguous.
221
+ */
222
+ baseline?: number;
217
223
  kind: "line-chart";
224
+ mode?: "live" | "profit-loss" | "standard";
225
+ negativeColor?: ChartColor;
226
+ positiveColor?: ChartColor;
227
+ windowSize?: number;
218
228
  };
219
229
  type AreaChartComponent = CartesianComponent & {
220
230
  kind: "area-chart";
@@ -295,6 +305,51 @@ type HeatmapComponent = ComponentBase & {
295
305
  xKey: string;
296
306
  yKey: string;
297
307
  };
308
+ type CandlestickChartComponent = ComponentBase & {
309
+ closeKey: string;
310
+ data: Datum[];
311
+ downColor?: ChartColor;
312
+ format?: NumberFormat;
313
+ highKey: string;
314
+ kind: "candlestick-chart";
315
+ lowKey: string;
316
+ openKey: string;
317
+ upColor?: ChartColor;
318
+ xKey: string;
319
+ };
320
+ type FunnelChartComponent = ComponentBase & {
321
+ colors?: Record<string, ChartColor>;
322
+ data: Datum[];
323
+ format?: NumberFormat;
324
+ kind: "funnel-chart";
325
+ labelKey: string;
326
+ orientation?: "horizontal" | "vertical";
327
+ showPercentages?: boolean;
328
+ valueKey: string;
329
+ };
330
+ type GaugeChartComponent = ComponentBase & {
331
+ color?: ChartColor;
332
+ format?: NumberFormat;
333
+ kind: "gauge-chart";
334
+ label: string;
335
+ max?: number;
336
+ min?: number;
337
+ notches?: number;
338
+ orientation?: "arc" | "linear";
339
+ value: number;
340
+ };
341
+ type SunburstNode = {
342
+ children?: SunburstNode[];
343
+ color?: ChartColor;
344
+ id: string;
345
+ label: string;
346
+ value?: number;
347
+ };
348
+ type SunburstChartComponent = ComponentBase & {
349
+ data: SunburstNode;
350
+ format?: NumberFormat;
351
+ kind: "sunburst-chart";
352
+ };
298
353
  type DataTableComponent = ComponentBase & {
299
354
  columns: Array<{
300
355
  format?: NumberFormat;
@@ -860,7 +915,7 @@ type WeatherCurrentComponent = ComponentBase & {
860
915
  temperature: number;
861
916
  unit: WeatherUnit;
862
917
  };
863
- type AnalyticalLeafComponent = MetricGridComponent | KpiGridComponent | LineChartComponent | AreaChartComponent | BarChartComponent | ComposedChartComponent | PieChartComponent | DonutChartComponent | RadarChartComponent | RadialChartComponent | SankeyChartComponent | ScatterChartComponent | HeatmapComponent | DataTableComponent | ComparisonListComponent | MeterListComponent;
918
+ type AnalyticalLeafComponent = MetricGridComponent | KpiGridComponent | LineChartComponent | AreaChartComponent | BarChartComponent | ComposedChartComponent | PieChartComponent | DonutChartComponent | RadarChartComponent | RadialChartComponent | SankeyChartComponent | ScatterChartComponent | HeatmapComponent | CandlestickChartComponent | FunnelChartComponent | GaugeChartComponent | SunburstChartComponent | DataTableComponent | ComparisonListComponent | MeterListComponent;
864
919
  type ProductSignalsComponent = ComponentBase & {
865
920
  defaultValue?: string;
866
921
  kind: "product-signals";
@@ -870,7 +925,7 @@ type ProductSignalsComponent = ComponentBase & {
870
925
  label: string;
871
926
  }>;
872
927
  };
873
- type AgentUILeafComponent = MetricGridComponent | KpiGridComponent | LineChartComponent | AreaChartComponent | BarChartComponent | ComposedChartComponent | PieChartComponent | DonutChartComponent | RadarChartComponent | RadialChartComponent | SankeyChartComponent | ScatterChartComponent | HeatmapComponent | DataTableComponent | ComparisonListComponent | MeterListComponent | FormComponent | TextComponent | CalloutComponent | ImageComponent | MapComponent | TagListComponent | ListComponent | ListBlockComponent | AccordionComponent | StepsComponent | CodeBlockComponent | DiagramComponent | TabsComponent | ActionGroupComponent | FollowupComponent | SwitchGroupComponent | ToggleGroupComponent | RecordCardComponent | ProductCardComponent | FlightTrackerComponent | CreateEventComponent | PlaylistComponent | RideStatusComponent | PurchaseItemsComponent | ChannelMessageComponent | PurchaseCompleteComponent | PlayerCardComponent | ViewEventComponent | EventSessionComponent | EnableNotificationComponent | WeatherForecastComponent | WeatherCurrentComponent | ProductSignalsComponent;
928
+ type AgentUILeafComponent = MetricGridComponent | KpiGridComponent | LineChartComponent | AreaChartComponent | BarChartComponent | ComposedChartComponent | PieChartComponent | DonutChartComponent | RadarChartComponent | RadialChartComponent | SankeyChartComponent | ScatterChartComponent | HeatmapComponent | CandlestickChartComponent | FunnelChartComponent | GaugeChartComponent | SunburstChartComponent | DataTableComponent | ComparisonListComponent | MeterListComponent | FormComponent | TextComponent | CalloutComponent | ImageComponent | MapComponent | TagListComponent | ListComponent | ListBlockComponent | AccordionComponent | StepsComponent | CodeBlockComponent | DiagramComponent | TabsComponent | ActionGroupComponent | FollowupComponent | SwitchGroupComponent | ToggleGroupComponent | RecordCardComponent | ProductCardComponent | FlightTrackerComponent | CreateEventComponent | PlaylistComponent | RideStatusComponent | PurchaseItemsComponent | ChannelMessageComponent | PurchaseCompleteComponent | PlayerCardComponent | ViewEventComponent | EventSessionComponent | EnableNotificationComponent | WeatherForecastComponent | WeatherCurrentComponent | ProductSignalsComponent;
874
929
  type DashboardComponent = ComponentBase & {
875
930
  children: AgentUILeafComponent[];
876
931
  kind: "dashboard";
@@ -990,6 +1045,10 @@ declare const radialChartComponentSchema: z.ZodType<RadialChartComponent>;
990
1045
  declare const sankeyChartComponentSchema: z.ZodType<SankeyChartComponent>;
991
1046
  declare const scatterChartComponentSchema: z.ZodType<ScatterChartComponent>;
992
1047
  declare const heatmapComponentSchema: z.ZodType<HeatmapComponent>;
1048
+ declare const candlestickChartComponentSchema: z.ZodType<CandlestickChartComponent>;
1049
+ declare const funnelChartComponentSchema: z.ZodType<FunnelChartComponent>;
1050
+ declare const gaugeChartComponentSchema: z.ZodType<GaugeChartComponent>;
1051
+ declare const sunburstChartComponentSchema: z.ZodType<SunburstChartComponent>;
993
1052
  declare const dataTableComponentSchema: z.ZodType<DataTableComponent>;
994
1053
  declare const comparisonListComponentSchema: z.ZodType<ComparisonListComponent>;
995
1054
  declare const meterListComponentSchema: z.ZodType<MeterListComponent>;
@@ -1206,11 +1265,11 @@ type AgentModelOption = {
1206
1265
  tier: AgentModelTier;
1207
1266
  };
1208
1267
  /**
1209
- * Recommended default selected when the optional picker first opens. Luna
1268
+ * Recommended default selected when the optional picker first opens. Gemini
1210
1269
  * matches the hosted runtime's baked-in default (`DEFAULT_CHAT_MODEL_IDS.herouiAgent`),
1211
1270
  * so what users see in the picker is what actually runs by default.
1212
1271
  */
1213
- declare const DEFAULT_AGENT_PICKER_MODEL_ID = "openai/gpt-5.6-luna";
1272
+ declare const DEFAULT_AGENT_PICKER_MODEL_ID = "google/gemini-3.6-flash";
1214
1273
  /**
1215
1274
  * Small, tool-capable model catalog for HeroUI Agent. These ids are the
1216
1275
  * server-side allowlist as well as the browser picker source of truth.
@@ -1286,8 +1345,8 @@ declare function signTrustedAgentClientData(secret: string, data: TrustedAgentCl
1286
1345
  declare function verifyTrustedAgentClientData(secret: string, value: unknown): Promise<TrustedAgentClientData | null>;
1287
1346
 
1288
1347
  declare const HEROUI_AGENT_PROTOCOL_VERSION: 5;
1289
- declare const HEROUI_AGENT_SDK_VERSION: "0.2.0-beta.1";
1348
+ declare const HEROUI_AGENT_SDK_VERSION: "0.2.0-beta.2";
1290
1349
  declare const HEROUI_AGENT_TASK_ID: "heroui-agents-runtime";
1291
1350
  declare const TRUSTED_AGENT_CLIENT_DATA_KEY: "__heroUiAgentApi";
1292
1351
 
1293
- export { AGENT_MODEL_IDS, AGENT_MODEL_OPTIONS, AGENT_UI_CATALOG, AGENT_UI_CONTAINER_KINDS, AGENT_UI_KIND_NAMES, AGENT_UI_KIND_SCHEMAS, AGENT_UI_LAYOUT_LEAF_KINDS, AGENT_UI_PRIMITIVE_KINDS, type AccordionComponent, type ActionGroupComponent, type ActionToolCall, type ActionVariant, type AgentDataTypes, type AgentIconName, type AgentMessage, type AgentModelId, type AgentModelOption, type AgentModelTier, type AgentRemoteConfig, type AgentRemoteThemeColor, type AgentSource, type AgentUIAmount, type AgentUICatalogEntry, type AgentUICatalogGroup, type AgentUIComponent, type AgentUIContainerComponent, type AgentUIImage, type AgentUILayoutLeafComponent, type AgentUILeafComponent, type AgentUINode, type AgentUIPrimitiveComponent, type AgentUIRenderable, type AgentUIRenderableKind, type AnalyticalLeafComponent, type AreaChartComponent, type BadgeComponent, type BarChartComponent, type ButtonComponent, COMPOSED_UI_MAX_DEPTH, COMPOSED_UI_MAX_NODES, type CalloutComponent, type CardComponent, type CardComponentVariant, type CartesianComponent, type CartesianRange, type CartesianSeries, type ChannelMessageComponent, type ChartColor, type ClientToolManifestEntry, type CodeBlockComponent, type ColComponent, type ComparisonListComponent, type ComponentActionSpec, type ComponentBase, type ComposedChartComponent, type ComposedChartSeries, type CreateEventComponent, DEFAULT_AGENT_PICKER_MODEL_ID, type DashboardComponent, type DataTableComponent, type Datum, type DiagramComponent, type DividerComponent, type DonutChartComponent, type EnableNotificationComponent, type EventSessionComponent, type FlightTrackerComponent, type FollowupComponent, type FormComponent, type FormDateRange, type FormField, type GridComponent, HEROUI_AGENT_ATTACHMENT_ACCEPT, HEROUI_AGENT_ATTACHMENT_CONTENT_TYPES, HEROUI_AGENT_ATTACHMENT_EXTENSION_BY_CONTENT_TYPE, HEROUI_AGENT_ATTACHMENT_MAX_BYTES, HEROUI_AGENT_MAX_ATTACHMENTS, HEROUI_AGENT_PROTOCOL_VERSION, HEROUI_AGENT_REMOTE_CONFIG_VERSION, HEROUI_AGENT_SDK_VERSION, HEROUI_AGENT_TASK_ID, HEROUI_AGENT_TEXT_ATTACHMENT_CONTENT_TYPES, type HeadingComponent, type HeatmapComponent, type HeroUIAgentAttachmentContentType, type IconComponent, type ImageComponent, type ItemCardComponent, type ItemCardGroupComponent, type ItemCardVariant, type KpiGridComponent, LEGACY_AGENT_MODEL_IDS, type LayoutAlign, type LayoutGap, type LayoutJustify, type LineChartComponent, type ListBlockComponent, type ListComponent, MAX_CLIENT_TOOLS, MAX_CLIENT_TOOLS_BYTES, type MapComponent, type MapCoordinate, type MapLocation, type MapLocationAction, type MeterListComponent, type MeterTone, type MetricGridComponent, type NumberFormat, type PieChartComponent, type PlayerCardComponent, type PlaylistComponent, type ProductCardComponent, type ProductCardItem, type ProductCardPrice, type ProductCardRating, type ProductSignalsComponent, type ProgressComponent, type PurchaseCompleteComponent, type PurchaseItemsComponent, RESERVED_AGENT_TOOL_NAMES, RESERVED_AGENT_TOOL_PREFIX, type RadarChartComponent, type RadialChartComponent, type RatingComponent, type RecordCardComponent, type RecordCardLayout, type RecordCardTone, type RideStatusComponent, type RowComponent, type SankeyChartComponent, type ScatterChartComponent, SignedTrustedAgentClientData, type SpacerComponent, type StepStatus, type StepsComponent, type SwitchGroupComponent, TRUSTED_AGENT_CLIENT_DATA_KEY, type TabsComponent, type TagListComponent, type TextComponent, type ToggleGroupComponent, TrustedAgentClientData, type ViewEventComponent, type WeatherCondition, type WeatherCurrentComponent, type WeatherForecastComponent, type WeatherUnit, accordionComponentSchema, actionGroupComponentSchema, agentIconNames, agentIconSchema, agentModelIdSchema, agentSourceSchema, agentSourcesSchema, agentUIComponentSchema, agentUILeafComponentSchema, agentUINodeSchema, agentUIRenderableSchema, analyticalLeafComponentSchema, areaChartComponentSchema, badgeComponentSchema, barChartComponentSchema, buttonComponentSchema, calloutComponentSchema, cardComponentSchema, cardComponentVariantSchema, channelMessageComponentSchema, chartColorSchema, clientToolManifestEntrySchema, clientToolsSchema, codeBlockComponentSchema, colComponentSchema, comparisonListComponentSchema, composeUIInputSchema, composedChartComponentSchema, composedUIComponentSchema, createEventComponentSchema, dashboardComponentSchema, dataTableComponentSchema, diagramComponentSchema, dividerComponentSchema, donutChartComponentSchema, enableNotificationComponentSchema, eventSessionComponentSchema, flightTrackerComponentSchema, followupComponentSchema, formComponentSchema, getAgentModelTier, getAgentUIContainerChildren, gridComponentSchema, headingComponentSchema, heatmapComponentSchema, iconComponentSchema, imageComponentSchema, isAgentModelId, isAgentUIContainerComponent, isAgentUILayoutLeafComponent, isAgentUIPrimitiveComponent, isHeroUIAgentAttachmentContentType, itemCardComponentSchema, itemCardGroupComponentSchema, kpiGridComponentSchema, lineChartComponentSchema, listBlockComponentSchema, listComponentSchema, mapComponentSchema, meterListComponentSchema, metricGridComponentSchema, numberFormatSchema, parseAgentRemoteConfig, pieChartComponentSchema, playerCardComponentSchema, playlistComponentSchema, productCardComponentSchema, productSignalsComponentSchema, progressComponentSchema, purchaseCompleteComponentSchema, purchaseItemsComponentSchema, radarChartComponentSchema, radialChartComponentSchema, ratingComponentSchema, recordCardComponentSchema, recordCardLayoutSchema, renderAgentUICatalogPrompt, renderComponentInputSchema, resolveAgentModelId, rideStatusComponentSchema, rowComponentSchema, sankeyChartComponentSchema, scatterChartComponentSchema, signTrustedAgentClientData, spacerComponentSchema, stepsComponentSchema, switchGroupComponentSchema, tabsComponentSchema, tagListComponentSchema, textComponentSchema, toggleGroupComponentSchema, verifyTrustedAgentClientData, viewEventComponentSchema, weatherConditionSchema, weatherConditions, weatherCurrentComponentSchema, weatherForecastComponentSchema };
1352
+ export { AGENT_MODEL_IDS, AGENT_MODEL_OPTIONS, AGENT_UI_CATALOG, AGENT_UI_CONTAINER_KINDS, AGENT_UI_KIND_NAMES, AGENT_UI_KIND_SCHEMAS, AGENT_UI_LAYOUT_LEAF_KINDS, AGENT_UI_PRIMITIVE_KINDS, type AccordionComponent, type ActionGroupComponent, type ActionToolCall, type ActionVariant, type AgentDataTypes, type AgentIconName, type AgentMessage, type AgentModelId, type AgentModelOption, type AgentModelTier, type AgentRemoteConfig, type AgentRemoteThemeColor, type AgentSource, type AgentUIAmount, type AgentUICatalogEntry, type AgentUICatalogGroup, type AgentUIComponent, type AgentUIContainerComponent, type AgentUIImage, type AgentUILayoutLeafComponent, type AgentUILeafComponent, type AgentUINode, type AgentUIPrimitiveComponent, type AgentUIRenderable, type AgentUIRenderableKind, type AnalyticalLeafComponent, type AreaChartComponent, type BadgeComponent, type BarChartComponent, type ButtonComponent, COMPOSED_UI_MAX_DEPTH, COMPOSED_UI_MAX_NODES, type CalloutComponent, type CandlestickChartComponent, type CardComponent, type CardComponentVariant, type CartesianComponent, type CartesianRange, type CartesianSeries, type ChannelMessageComponent, type ChartColor, type ClientToolManifestEntry, type CodeBlockComponent, type ColComponent, type ComparisonListComponent, type ComponentActionSpec, type ComponentBase, type ComposedChartComponent, type ComposedChartSeries, type CreateEventComponent, DEFAULT_AGENT_PICKER_MODEL_ID, type DashboardComponent, type DataTableComponent, type Datum, type DiagramComponent, type DividerComponent, type DonutChartComponent, type EnableNotificationComponent, type EventSessionComponent, type FlightTrackerComponent, type FollowupComponent, type FormComponent, type FormDateRange, type FormField, type FunnelChartComponent, type GaugeChartComponent, type GridComponent, HEROUI_AGENT_ATTACHMENT_ACCEPT, HEROUI_AGENT_ATTACHMENT_CONTENT_TYPES, HEROUI_AGENT_ATTACHMENT_EXTENSION_BY_CONTENT_TYPE, HEROUI_AGENT_ATTACHMENT_MAX_BYTES, HEROUI_AGENT_MAX_ATTACHMENTS, HEROUI_AGENT_PROTOCOL_VERSION, HEROUI_AGENT_REMOTE_CONFIG_VERSION, HEROUI_AGENT_SDK_VERSION, HEROUI_AGENT_TASK_ID, HEROUI_AGENT_TEXT_ATTACHMENT_CONTENT_TYPES, type HeadingComponent, type HeatmapComponent, type HeroUIAgentAttachmentContentType, type IconComponent, type ImageComponent, type ItemCardComponent, type ItemCardGroupComponent, type ItemCardVariant, type KpiGridComponent, LEGACY_AGENT_MODEL_IDS, type LayoutAlign, type LayoutGap, type LayoutJustify, type LineChartComponent, type ListBlockComponent, type ListComponent, MAX_CLIENT_TOOLS, MAX_CLIENT_TOOLS_BYTES, type MapComponent, type MapCoordinate, type MapLocation, type MapLocationAction, type MeterListComponent, type MeterTone, type MetricGridComponent, type NumberFormat, type PieChartComponent, type PlayerCardComponent, type PlaylistComponent, type ProductCardComponent, type ProductCardItem, type ProductCardPrice, type ProductCardRating, type ProductSignalsComponent, type ProgressComponent, type PurchaseCompleteComponent, type PurchaseItemsComponent, RESERVED_AGENT_TOOL_NAMES, RESERVED_AGENT_TOOL_PREFIX, type RadarChartComponent, type RadialChartComponent, type RatingComponent, type RecordCardComponent, type RecordCardLayout, type RecordCardTone, type RideStatusComponent, type RowComponent, type SankeyChartComponent, type ScatterChartComponent, SignedTrustedAgentClientData, type SpacerComponent, type StepStatus, type StepsComponent, type SunburstChartComponent, type SunburstNode, type SwitchGroupComponent, TRUSTED_AGENT_CLIENT_DATA_KEY, type TabsComponent, type TagListComponent, type TextComponent, type ToggleGroupComponent, TrustedAgentClientData, type ViewEventComponent, type WeatherCondition, type WeatherCurrentComponent, type WeatherForecastComponent, type WeatherUnit, accordionComponentSchema, actionGroupComponentSchema, agentIconNames, agentIconSchema, agentModelIdSchema, agentSourceSchema, agentSourcesSchema, agentUIComponentSchema, agentUILeafComponentSchema, agentUINodeSchema, agentUIRenderableSchema, analyticalLeafComponentSchema, areaChartComponentSchema, badgeComponentSchema, barChartComponentSchema, buttonComponentSchema, calloutComponentSchema, candlestickChartComponentSchema, cardComponentSchema, cardComponentVariantSchema, channelMessageComponentSchema, chartColorSchema, clientToolManifestEntrySchema, clientToolsSchema, codeBlockComponentSchema, colComponentSchema, comparisonListComponentSchema, composeUIInputSchema, composedChartComponentSchema, composedUIComponentSchema, createEventComponentSchema, dashboardComponentSchema, dataTableComponentSchema, diagramComponentSchema, dividerComponentSchema, donutChartComponentSchema, enableNotificationComponentSchema, eventSessionComponentSchema, flightTrackerComponentSchema, followupComponentSchema, formComponentSchema, funnelChartComponentSchema, gaugeChartComponentSchema, getAgentModelTier, getAgentUIContainerChildren, gridComponentSchema, headingComponentSchema, heatmapComponentSchema, iconComponentSchema, imageComponentSchema, isAgentModelId, isAgentUIContainerComponent, isAgentUILayoutLeafComponent, isAgentUIPrimitiveComponent, isHeroUIAgentAttachmentContentType, itemCardComponentSchema, itemCardGroupComponentSchema, kpiGridComponentSchema, lineChartComponentSchema, listBlockComponentSchema, listComponentSchema, mapComponentSchema, meterListComponentSchema, metricGridComponentSchema, numberFormatSchema, parseAgentRemoteConfig, pieChartComponentSchema, playerCardComponentSchema, playlistComponentSchema, productCardComponentSchema, productSignalsComponentSchema, progressComponentSchema, purchaseCompleteComponentSchema, purchaseItemsComponentSchema, radarChartComponentSchema, radialChartComponentSchema, ratingComponentSchema, recordCardComponentSchema, recordCardLayoutSchema, renderAgentUICatalogPrompt, renderComponentInputSchema, resolveAgentModelId, rideStatusComponentSchema, rowComponentSchema, sankeyChartComponentSchema, scatterChartComponentSchema, signTrustedAgentClientData, spacerComponentSchema, stepsComponentSchema, sunburstChartComponentSchema, switchGroupComponentSchema, tabsComponentSchema, tagListComponentSchema, textComponentSchema, toggleGroupComponentSchema, verifyTrustedAgentClientData, viewEventComponentSchema, weatherConditionSchema, weatherConditions, weatherCurrentComponentSchema, weatherForecastComponentSchema };
package/dist/contracts.js CHANGED
@@ -227,6 +227,7 @@ var COMPONENT_CATEGORY_BY_KIND = {
227
227
  "area-chart": "data-visualization",
228
228
  "bar-chart": "data-visualization",
229
229
  callout: "display-information",
230
+ "candlestick-chart": "data-visualization",
230
231
  "channel-message": "display-information",
231
232
  "code-block": "display-information",
232
233
  "comparison-list": "data-visualization",
@@ -240,6 +241,8 @@ var COMPONENT_CATEGORY_BY_KIND = {
240
241
  "flight-tracker": "display-information",
241
242
  followup: "actions",
242
243
  form: "form-elements",
244
+ "funnel-chart": "data-visualization",
245
+ "gauge-chart": "data-visualization",
243
246
  heatmap: "data-visualization",
244
247
  image: "display-information",
245
248
  "kpi-grid": "data-visualization",
@@ -263,6 +266,7 @@ var COMPONENT_CATEGORY_BY_KIND = {
263
266
  "sankey-chart": "data-visualization",
264
267
  "scatter-chart": "data-visualization",
265
268
  steps: "display-information",
269
+ "sunburst-chart": "data-visualization",
266
270
  "switch-group": "form-elements",
267
271
  tabs: "display-information",
268
272
  "tag-list": "display-information",
@@ -275,6 +279,16 @@ var COMPONENT_CATEGORY_BY_KIND = {
275
279
 
276
280
  // ../agent-ui/src/contracts/components.ts
277
281
  import { z } from "zod";
282
+
283
+ // ../agent-ui/src/utils/chart-values.ts
284
+ function resolveGaugeBounds(component) {
285
+ return {
286
+ maximum: component.max ?? (component.format?.style === "percent" ? 1 : 100),
287
+ minimum: component.min ?? 0
288
+ };
289
+ }
290
+
291
+ // ../agent-ui/src/contracts/components.ts
278
292
  var agentIconNames = [
279
293
  "activity",
280
294
  "alert",
@@ -416,6 +430,179 @@ var heatmap = base.extend({
416
430
  xKey: key,
417
431
  yKey: key
418
432
  });
433
+ var line = cartesian.extend({
434
+ baseline: z.number().finite().optional(),
435
+ kind: z.literal("line-chart"),
436
+ mode: z.enum(["live", "profit-loss", "standard"]).optional(),
437
+ negativeColor: chartColorSchema.optional(),
438
+ positiveColor: chartColorSchema.optional(),
439
+ windowSize: z.number().int().min(2).max(200).optional()
440
+ }).superRefine((component, ctx) => {
441
+ if ((component.mode === "live" || component.mode === "profit-loss") && component.series.length !== 1) {
442
+ ctx.addIssue({
443
+ code: "custom",
444
+ message: `${component.mode} line charts require exactly one series`,
445
+ path: ["series"]
446
+ });
447
+ }
448
+ });
449
+ var candlestick = base.extend({
450
+ closeKey: key,
451
+ data: z.array(datum).min(1).max(200),
452
+ downColor: chartColorSchema.optional(),
453
+ format: numberFormatSchema.optional(),
454
+ highKey: key,
455
+ kind: z.literal("candlestick-chart"),
456
+ lowKey: key,
457
+ openKey: key,
458
+ upColor: chartColorSchema.optional(),
459
+ xKey: key
460
+ }).superRefine((component, ctx) => {
461
+ for (const [index, row] of component.data.entries()) {
462
+ const open = row[component.openKey];
463
+ const high = row[component.highKey];
464
+ const low = row[component.lowKey];
465
+ const close = row[component.closeKey];
466
+ const values = [open, high, low, close];
467
+ if (values.some((value) => typeof value !== "number" || !Number.isFinite(value))) {
468
+ ctx.addIssue({
469
+ code: "custom",
470
+ message: "Every candlestick row needs finite open, high, low, and close values",
471
+ path: ["data", index]
472
+ });
473
+ continue;
474
+ }
475
+ const numericOpen = open;
476
+ const numericHigh = high;
477
+ const numericLow = low;
478
+ const numericClose = close;
479
+ if (numericLow > Math.min(numericOpen, numericClose) || numericHigh < Math.max(numericOpen, numericClose) || numericLow > numericHigh) {
480
+ ctx.addIssue({
481
+ code: "custom",
482
+ message: "Candlestick low/high values must contain the open and close values",
483
+ path: ["data", index]
484
+ });
485
+ }
486
+ }
487
+ });
488
+ var funnel = proportional.extend({
489
+ data: z.array(datum).min(2).max(20),
490
+ kind: z.literal("funnel-chart"),
491
+ orientation: z.enum(["horizontal", "vertical"]).optional(),
492
+ showPercentages: z.boolean().optional()
493
+ }).superRefine((component, ctx) => {
494
+ const values = component.data.map((row, index) => {
495
+ const value = row[component.valueKey];
496
+ if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
497
+ ctx.addIssue({
498
+ code: "custom",
499
+ message: "Every funnel stage needs a finite, non-negative value",
500
+ path: ["data", index, component.valueKey]
501
+ });
502
+ return 0;
503
+ }
504
+ return value;
505
+ });
506
+ if (!values.some((value) => value > 0)) {
507
+ ctx.addIssue({
508
+ code: "custom",
509
+ message: "A funnel needs at least one stage above zero",
510
+ path: ["data"]
511
+ });
512
+ }
513
+ if ((values[0] ?? 0) <= 0) {
514
+ ctx.addIssue({
515
+ code: "custom",
516
+ message: "A funnel's first stage must be above zero",
517
+ path: ["data", 0, component.valueKey]
518
+ });
519
+ }
520
+ for (let index = 1; index < values.length; index += 1) {
521
+ if ((values[index] ?? 0) > (values[index - 1] ?? 0)) {
522
+ ctx.addIssue({
523
+ code: "custom",
524
+ message: "Funnel stages must not increase",
525
+ path: ["data", index, component.valueKey]
526
+ });
527
+ }
528
+ }
529
+ });
530
+ var gauge = base.extend({
531
+ color: chartColorSchema.optional(),
532
+ format: numberFormatSchema.optional(),
533
+ kind: z.literal("gauge-chart"),
534
+ label: shortText,
535
+ max: z.number().finite().optional(),
536
+ min: z.number().finite().optional(),
537
+ notches: z.number().int().min(6).max(60).optional(),
538
+ orientation: z.enum(["arc", "linear"]).optional(),
539
+ value: z.number().finite()
540
+ }).superRefine((component, ctx) => {
541
+ const { maximum, minimum } = resolveGaugeBounds(component);
542
+ if (maximum <= minimum) {
543
+ ctx.addIssue({ code: "custom", message: "Gauge max must be greater than min", path: ["max"] });
544
+ } else if (component.value < minimum || component.value > maximum) {
545
+ ctx.addIssue({
546
+ code: "custom",
547
+ message: "Gauge value must be within its min/max range",
548
+ path: ["value"]
549
+ });
550
+ }
551
+ });
552
+ var sunburstNode = z.lazy(
553
+ () => z.object({
554
+ children: z.array(sunburstNode).min(1).max(12).optional(),
555
+ color: chartColorSchema.optional(),
556
+ id,
557
+ label: shortText,
558
+ value: z.number().finite().positive().optional()
559
+ }).superRefine((node, ctx) => {
560
+ if (node.children?.length && node.value !== void 0) {
561
+ ctx.addIssue({
562
+ code: "custom",
563
+ message: "Sunburst branch values are derived from their children",
564
+ path: ["value"]
565
+ });
566
+ }
567
+ if (!node.children?.length && node.value === void 0) {
568
+ ctx.addIssue({
569
+ code: "custom",
570
+ message: "Every sunburst leaf needs a positive value",
571
+ path: ["value"]
572
+ });
573
+ }
574
+ })
575
+ );
576
+ var sunburst = base.extend({
577
+ data: sunburstNode,
578
+ format: numberFormatSchema.optional(),
579
+ kind: z.literal("sunburst-chart")
580
+ }).superRefine((component, ctx) => {
581
+ const ids = /* @__PURE__ */ new Set();
582
+ let count = 0;
583
+ let deepest = 0;
584
+ const visit = (node, depth) => {
585
+ count += 1;
586
+ deepest = Math.max(deepest, depth);
587
+ if (ids.has(node.id)) {
588
+ ctx.addIssue({ code: "custom", message: `Duplicate sunburst node id "${node.id}"` });
589
+ }
590
+ ids.add(node.id);
591
+ node.children?.forEach((child) => visit(child, depth + 1));
592
+ };
593
+ if (!component.data.children?.length) {
594
+ ctx.addIssue({
595
+ code: "custom",
596
+ message: "A sunburst root needs at least one child",
597
+ path: ["data", "children"]
598
+ });
599
+ }
600
+ visit(component.data, 0);
601
+ if (count > 60)
602
+ ctx.addIssue({ code: "custom", message: "Sunburst charts allow at most 60 nodes" });
603
+ if (deepest > 4)
604
+ ctx.addIssue({ code: "custom", message: "Sunburst charts allow at most four nested levels" });
605
+ });
419
606
  var option = z.object({ label: shortText, value: key });
420
607
  var formDateRange = z.object({ end: date, start: date }).refine((range) => range.start <= range.end, "The start date must not be after the end date");
421
608
  var fieldBase = {
@@ -696,6 +883,7 @@ var validators = {
696
883
  kind: z.literal("callout"),
697
884
  tone: z.enum(["accent", "danger", "neutral", "success", "warning"]).optional()
698
885
  }),
886
+ candlestick,
699
887
  channelMessage: base.extend({
700
888
  attachments: z.array(z.object({ id, image: agentUIImage.optional(), name: shortText })).max(8).optional(),
701
889
  author: z.object({ image: agentUIImage.optional(), name: shortText }),
@@ -788,6 +976,8 @@ var validators = {
788
976
  fields: z.array(formField).min(1).max(20),
789
977
  kind: z.literal("form")
790
978
  }),
979
+ funnel,
980
+ gauge,
791
981
  heatmap,
792
982
  image: base.extend({
793
983
  images: z.array(
@@ -817,7 +1007,7 @@ var validators = {
817
1007
  })
818
1008
  ).min(1).max(4)
819
1009
  }),
820
- line: cartesian.extend({ kind: z.literal("line-chart") }),
1010
+ line,
821
1011
  list: base.extend({
822
1012
  items: z.array(
823
1013
  z.object({
@@ -1068,6 +1258,7 @@ var validators = {
1068
1258
  ).min(1).max(12),
1069
1259
  variant: z.enum(["steps", "timeline"]).optional()
1070
1260
  }),
1261
+ sunburst,
1071
1262
  switches: base.extend({
1072
1263
  items: z.array(
1073
1264
  z.object({
@@ -1162,6 +1353,10 @@ var radialChartComponentSchema = validators.radial;
1162
1353
  var sankeyChartComponentSchema = validators.sankey;
1163
1354
  var scatterChartComponentSchema = validators.scatter;
1164
1355
  var heatmapComponentSchema = validators.heatmap;
1356
+ var candlestickChartComponentSchema = validators.candlestick;
1357
+ var funnelChartComponentSchema = validators.funnel;
1358
+ var gaugeChartComponentSchema = validators.gauge;
1359
+ var sunburstChartComponentSchema = validators.sunburst;
1165
1360
  var dataTableComponentSchema = validators.table;
1166
1361
  var comparisonListComponentSchema = validators.comparison;
1167
1362
  var meterListComponentSchema = validators.meterList;
@@ -1211,6 +1406,10 @@ var analyticalLeafComponentSchema = z.discriminatedUnion("kind", [
1211
1406
  validators.sankey,
1212
1407
  validators.scatter,
1213
1408
  validators.heatmap,
1409
+ validators.candlestick,
1410
+ validators.funnel,
1411
+ validators.gauge,
1412
+ validators.sunburst,
1214
1413
  validators.table,
1215
1414
  validators.comparison,
1216
1415
  validators.meterList
@@ -1254,6 +1453,10 @@ var standardAgentUILeafComponentSchema = z.discriminatedUnion("kind", [
1254
1453
  validators.sankey,
1255
1454
  validators.scatter,
1256
1455
  validators.heatmap,
1456
+ validators.candlestick,
1457
+ validators.funnel,
1458
+ validators.gauge,
1459
+ validators.sunburst,
1257
1460
  validators.table,
1258
1461
  validators.comparison,
1259
1462
  validators.meterList,
@@ -1644,6 +1847,7 @@ var AGENT_UI_KIND_SCHEMAS = {
1644
1847
  "bar-chart": barChartComponentSchema,
1645
1848
  button: buttonComponentSchema,
1646
1849
  callout: calloutComponentSchema,
1850
+ "candlestick-chart": candlestickChartComponentSchema,
1647
1851
  card: cardShape.extend({ children: opaqueChildren(COMPOSED_UI_MAX_NODES) }),
1648
1852
  "channel-message": channelMessageComponentSchema,
1649
1853
  "code-block": codeBlockComponentSchema,
@@ -1661,6 +1865,8 @@ var AGENT_UI_KIND_SCHEMAS = {
1661
1865
  "flight-tracker": flightTrackerComponentSchema,
1662
1866
  followup: followupComponentSchema,
1663
1867
  form: formComponentSchema,
1868
+ "funnel-chart": funnelChartComponentSchema,
1869
+ "gauge-chart": gaugeChartComponentSchema,
1664
1870
  grid: gridShape.extend({ children: opaqueChildren(COMPOSED_UI_MAX_NODES) }),
1665
1871
  heading: headingComponentSchema,
1666
1872
  heatmap: heatmapComponentSchema,
@@ -1709,6 +1915,7 @@ var AGENT_UI_KIND_SCHEMAS = {
1709
1915
  "scatter-chart": scatterChartComponentSchema,
1710
1916
  spacer: spacerComponentSchema,
1711
1917
  steps: stepsComponentSchema,
1918
+ "sunburst-chart": sunburstChartComponentSchema,
1712
1919
  "switch-group": switchGroupComponentSchema,
1713
1920
  tabs: base.extend({
1714
1921
  defaultValue: id.optional(),
@@ -1748,6 +1955,7 @@ var SUMMARIES = {
1748
1955
  "bar-chart": "ranked or categorical comparison, horizontal layout for rankings",
1749
1956
  button: "one action with a prompt or client-tool call",
1750
1957
  callout: "one short toned notice: info, success, warning, or danger",
1958
+ "candlestick-chart": "open-high-low-close price movement over ordered periods",
1751
1959
  card: "titled surface grouping related children",
1752
1960
  "channel-message": "a quoted workspace message with author and attachments",
1753
1961
  "code-block": "a syntax-highlighted snippet",
@@ -1765,6 +1973,8 @@ var SUMMARIES = {
1765
1973
  "flight-tracker": "a flight's route, times, and live progress",
1766
1974
  followup: "suggested next prompts the user can send",
1767
1975
  form: "input fields with submit actions",
1976
+ "funnel-chart": "drop-off through ordered conversion or pipeline stages",
1977
+ "gauge-chart": "one bounded value against its minimum and maximum",
1768
1978
  grid: "one to four equal columns of peers",
1769
1979
  heading: "a section title, levels one to four",
1770
1980
  heatmap: "two-dimensional intensity across x and y",
@@ -1773,7 +1983,7 @@ var SUMMARIES = {
1773
1983
  "item-card": "one compact three-slot row with composable left, middle, and right content",
1774
1984
  "item-card-group": "one to twelve related item-card rows in a list or grid",
1775
1985
  "kpi-grid": "up to four headline KPIs, each with a sparkline of its own history",
1776
- "line-chart": "two or more overlapping series needing equal weight",
1986
+ "line-chart": "overlapping series, a live signal, or one series split around a baseline",
1777
1987
  list: "bulleted, numbered, or checklist items with optional children",
1778
1988
  "list-block": "richer rows with title, description, meta, rating, icon, or image",
1779
1989
  map: "ranked places pinned by exact latitude and longitude",
@@ -1797,6 +2007,7 @@ var SUMMARIES = {
1797
2007
  "scatter-chart": "correlation between two numeric fields, optional grouping",
1798
2008
  spacer: "a gap between siblings",
1799
2009
  steps: "task progress or a chronological timeline, up to twelve entries",
2010
+ "sunburst-chart": "hierarchical part-to-whole values across nested levels",
1800
2011
  "switch-group": "toggleable boolean preferences",
1801
2012
  tabs: "parallel text or rich multi-component sections behind labeled tabs",
1802
2013
  "tag-list": "short keyword chips",
@@ -1904,7 +2115,7 @@ var LEGACY_AGENT_MODEL_IDS = {
1904
2115
  function resolveAgentModelId(value) {
1905
2116
  return LEGACY_AGENT_MODEL_IDS[value] ?? value;
1906
2117
  }
1907
- var DEFAULT_AGENT_PICKER_MODEL_ID = "openai/gpt-5.6-luna";
2118
+ var DEFAULT_AGENT_PICKER_MODEL_ID = "google/gemini-3.6-flash";
1908
2119
  var AGENT_MODEL_OPTIONS = [
1909
2120
  {
1910
2121
  description: "Flagship model for coding, reasoning, and knowledge work",
@@ -1973,7 +2184,7 @@ var agentModelIdSchema = z3.preprocess(
1973
2184
 
1974
2185
  // src/contracts/version.ts
1975
2186
  var HEROUI_AGENT_PROTOCOL_VERSION = 5;
1976
- var HEROUI_AGENT_SDK_VERSION = "0.2.0-beta.1";
2187
+ var HEROUI_AGENT_SDK_VERSION = "0.2.0-beta.2";
1977
2188
  var HEROUI_AGENT_TASK_ID = "heroui-agents-runtime";
1978
2189
  var TRUSTED_AGENT_CLIENT_DATA_KEY = "__heroUiAgentApi";
1979
2190
 
@@ -2104,6 +2315,11 @@ var agentProjectConfigSchema = z4.object({
2104
2315
  agentId: z4.string(),
2105
2316
  minimumProtocolVersion: z4.literal(HEROUI_AGENT_PROTOCOL_VERSION),
2106
2317
  name: z4.string().trim().min(1).max(120),
2318
+ /**
2319
+ * InstantDB app used for ephemeral live-conversation presence. Optional so
2320
+ * newer SDKs remain compatible with older Agent API deployments.
2321
+ */
2322
+ presence: z4.object({ appId: z4.uuid() }).optional(),
2107
2323
  protocolVersion: z4.literal(HEROUI_AGENT_PROTOCOL_VERSION),
2108
2324
  /**
2109
2325
  * Internal streaming infrastructure endpoint, resolved server-side so
@@ -2238,6 +2454,7 @@ export {
2238
2454
  barChartComponentSchema,
2239
2455
  buttonComponentSchema,
2240
2456
  calloutComponentSchema,
2457
+ candlestickChartComponentSchema,
2241
2458
  cardComponentSchema,
2242
2459
  cardComponentVariantSchema,
2243
2460
  channelMessageComponentSchema,
@@ -2262,6 +2479,8 @@ export {
2262
2479
  flightTrackerComponentSchema,
2263
2480
  followupComponentSchema,
2264
2481
  formComponentSchema,
2482
+ funnelChartComponentSchema,
2483
+ gaugeChartComponentSchema,
2265
2484
  getAgentModelTier,
2266
2485
  getAgentUIContainerChildren,
2267
2486
  gridComponentSchema,
@@ -2310,6 +2529,7 @@ export {
2310
2529
  signedTrustedAgentClientDataSchema,
2311
2530
  spacerComponentSchema,
2312
2531
  stepsComponentSchema,
2532
+ sunburstChartComponentSchema,
2313
2533
  switchGroupComponentSchema,
2314
2534
  tabsComponentSchema,
2315
2535
  tagListComponentSchema,