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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { ComponentType, ReactNode, CSSProperties } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import { z } from 'zod';
 import { AnimateOptions, CustomRenderer, CustomRendererProps } from 'streamdown';
 
@@ -30,6 +31,16 @@ type ClientToolSchema<TArgs> = {
     parse: (input: unknown) => TArgs;
     safeParse: (input: unknown) => unknown;
 };
+/**
+ * Stable identity for one agent-initiated browser tool effect. Pass
+ * `idempotencyKey` through to mutation APIs so an ambiguous network retry can
+ * return the original result instead of applying the side effect twice.
+ */
+type ClientToolExecutionContext = Readonly<{
+    conversationId: string;
+    idempotencyKey: string;
+    toolCallId: string;
+}>;
 /**
  * A tool the agent can call in the user's browser. Execution and rendering
  * never leave the page — only the name, description, schema, and approval
@@ -39,7 +50,7 @@ type ClientTool<TArgs = any, TContext = any> = {
     description: string;
     /** Human-readable name shown in the default tool card. Defaults to `name`. */
     displayName?: string;
-    execute: (args: TArgs, context: TContext) => Promise<unknown> | unknown;
+    execute: (args: TArgs, context: TContext, execution: ClientToolExecutionContext) => Promise<unknown> | unknown;
     /** Icon component for the default tool card ({size, color, stroke} props). */
     icon?: ComponentType<ClientToolIconProps>;
     iconColor?: string;
@@ -98,6 +109,22 @@ declare const agentThemeSchema: z.ZodEnum<{
 }>;
 type AgentTheme = z.infer<typeof agentThemeSchema>;
 
+/** Browser event emitted when protocol-v6 runtime latency checkpoints arrive. */
+declare const HEROUI_AGENT_RUNTIME_TIMING_EVENT: "heroui-agent:runtime-timing";
+type AgentActivityPhase = "accepted" | "preparing" | "generating" | "waiting-client-tool" | "running-server-tool" | "recovering";
+type AgentRuntimeTiming = {
+    completedAt?: number;
+    firstSemanticTextAt?: number;
+    providerFirstEventAt?: number;
+    providerRequestedAt?: number;
+    runtimeAdmittedAt?: number;
+    turnId?: string;
+};
+type AgentRuntimeTimingEventDetail = AgentRuntimeTiming & {
+    agentId: string;
+    conversationId: string;
+};
+
 /**
  * Deliberately Zod-free: the model catalogue is re-exported from the package
  * root, so importing Zod here would pull the whole validation library into the
@@ -296,7 +323,7 @@ type AgentMarkdownPlugins = {
 type AgentMarkdownOptions = {
     /**
      * Animate newly streamed content. Pass `false` to disable text animation.
-     * @default {animation: "blurIn", duration: 160, easing: "ease-out", sep: "word", stagger: 18}
+     * @default {animation: "fadeIn", duration: 160, easing: "ease-out", sep: "word", stagger: 18}
      */
     animated?: AgentMarkdownAnimation;
     /** Streaming caret style. Pass `false` to hide it. @default "block" */
@@ -345,6 +372,12 @@ type AgentCapabilities = {
      * @default true
      */
     imageSearch?: boolean;
+    /**
+     * Allow the hosted agent to include recent news results in web searches.
+     * Only applies when {@link webSearch} is enabled and is off by default.
+     * @default false
+     */
+    newsSearch?: boolean;
     /**
      * Allow the hosted agent to search the public web for current information
      * and images. Results are untrusted external content; keep this off when the
@@ -461,7 +494,6 @@ type AgentStartScreenOptions = {
 /** Internal — for HeroUI platform development only. */
 type AgentApiOverrides = {
     baseUrl?: string;
-    realtimeUrl?: string;
 };
 /**
  * Short-lived browser credential returned by the customer's server.
@@ -506,14 +538,20 @@ type HeroUIAgentProps = {
      * include structured reasons and an optional comment from the feedback popover.
      */
     onFeedback?: (feedback: AgentResponseFeedback) => Promise<void> | void;
+    /**
+     * Fires whenever project configuration and the complete composer are ready
+     * for the current conversation. Use `useAgent().ready` when a custom launcher
+     * also needs the status reactively.
+     */
+    onReady?: () => void;
     /** Client-tool approval defaults and optional end-user picker. */
     permissions?: AgentPermissionOptions;
     /**
-     * Warm the agent up before the visitor touches it: fetch the chat engine,
-     * bootstrap the conversation, and boot the agent run — all while the panel is
-     * still closed, at the browser's idle priority so it never competes with your
-     * page's own loading. The first open is then immediate instead of showing a
-     * loading state.
+     * Warm the agent before the visitor touches it: fetch the chat engine,
+     * configuration, and credentials, then bootstrap and preconnect the runtime
+     * while the panel is still closed. Work starts immediately and in parallel
+     * so readiness follows the launcher as quickly as possible. Opening before
+     * then shows the Agent shell with a loading state.
      *
      * Set to `false` to request nothing until the panel is opened. Worth doing
      * when most visitors never open the agent, or on pages where you want to
@@ -523,6 +561,19 @@ type HeroUIAgentProps = {
      */
     preload?: boolean;
     agentId: string;
+    /**
+     * Reopen the panel after a page refresh when it was open before the refresh.
+     * The restored panel always starts a new chat instead of resuming the
+     * previously active conversation.
+     * @default false
+     */
+    reopenOnRefresh?: boolean;
+    /**
+     * Open the panel on the start screen instead of restoring the most recently
+     * active conversation. Conversation history remains available in the picker.
+     * @default false
+     */
+    startNewConversationOnOpen?: boolean;
     /**
      * Apply the appearance saved for this project in the HeroUI dashboard —
      * launcher icon, colors, typography, greeting, and suggested prompts —
@@ -556,7 +607,8 @@ type HeroUIAgentProps = {
 };
 type AgentController = {
     hide: () => void;
-    newConversation: () => void;
+    /** Start a fresh conversation, optionally submitting its first prompt immediately. */
+    newConversation: (prompt?: string) => void;
     /**
      * Warm the agent now, without opening it — the same work the `preload` prop
      * does on its own. Pair it with `preload={false}` to pick the moment from
@@ -564,6 +616,8 @@ type AgentController = {
      * struggling with. Cheap to call repeatedly; the work happens once.
      */
     preload: () => void;
+    /** Whether project configuration and the complete composer are ready to open. */
+    ready: boolean;
     refreshAuth: () => void;
     show: () => void;
     shutdown: () => void;
@@ -571,7 +625,7 @@ type AgentController = {
 };
 
 /**
- * Imperative controls for the embedded agent. Safe to call before
+ * Imperative controls for the agent embed. Safe to call before
  * `<HeroUIAgent />` mounts (calls are ignored with a console warning). Pass a
  * `agentId` when rendering more than one agent on the same page.
  */
@@ -582,13 +636,13 @@ declare function useAgent(agentId?: string): AgentController;
  * ```tsx
  * <body>
  *   {children}
- *   <HeroUIAgent getAuthToken={getAuthToken} agentId="proj_..." />
+ *   <HeroUIAgent getAuthToken={getAuthToken} agentId={process.env.NEXT_PUBLIC_HEROUI_AGENT_ID!} />
  * </body>
  * ```
  *
  * Renders nothing in the tree; the launcher and chat panel mount into an
  * independent React root on `document.body`.
  */
-declare function HeroUIAgent(props: HeroUIAgentProps): null;
+declare function HeroUIAgent(props: HeroUIAgentProps): react_jsx_runtime.JSX.Element;
 
-export { AGENT_DESIGN_THEMES, AGENT_MODEL_IDS, AGENT_MODEL_OPTIONS, type AgentApiOverrides, type AgentAppearance, type AgentAttachmentContentType, type AgentAuthToken, type AgentCapabilities, type AgentColorScheme, type AgentComponentExportFormat, type AgentComposerOptions, type AgentContext, type AgentController, type AgentDesignTheme, type AgentFeedbackReason, type AgentLauncherOptions, type AgentLauncherPosition, type AgentMarkdownAnimation, type AgentMarkdownCaret, type AgentMarkdownOptions, type AgentMarkdownPlugins, type AgentMarkdownRenderer, type AgentMarkdownRendererProps, type AgentMessageAction, type AgentModelId, type AgentModelOption, type AgentModelTier, type AgentPanelOptions, type AgentPermissionMode, type AgentPermissionOptions, type AgentRadius, type AgentResponseFeedback, type AgentSharedContext, type AgentStartScreenOptions, type AgentThemeColor, type AgentThemeColors, type AgentThemeOptions, type AgentTypography, type AgentViewMode, type ClientTool, type ClientToolIconProps, type ClientToolRenderProps, type ClientToolStatus, DEFAULT_AGENT_PICKER_MODEL_ID, type GetAuthToken, type GetAuthTokenContext, HeroUIAgent, type HeroUIAgentProps, LEGACY_AGENT_MODEL_IDS, createToolHelper, getAgentModelTier, isAgentModelId, resolveAgentModelId, useAgent };
+export { AGENT_DESIGN_THEMES, AGENT_MODEL_IDS, AGENT_MODEL_OPTIONS, type AgentActivityPhase, type AgentApiOverrides, type AgentAppearance, type AgentAttachmentContentType, type AgentAuthToken, type AgentCapabilities, type AgentColorScheme, type AgentComponentExportFormat, type AgentComposerOptions, type AgentContext, type AgentController, type AgentDesignTheme, type AgentFeedbackReason, type AgentLauncherOptions, type AgentLauncherPosition, type AgentMarkdownAnimation, type AgentMarkdownCaret, type AgentMarkdownOptions, type AgentMarkdownPlugins, type AgentMarkdownRenderer, type AgentMarkdownRendererProps, type AgentMessageAction, type AgentModelId, type AgentModelOption, type AgentModelTier, type AgentPanelOptions, type AgentPermissionMode, type AgentPermissionOptions, type AgentRadius, type AgentResponseFeedback, type AgentRuntimeTiming, type AgentRuntimeTimingEventDetail, type AgentSharedContext, type AgentStartScreenOptions, type AgentThemeColor, type AgentThemeColors, type AgentThemeOptions, type AgentTypography, type AgentViewMode, type ClientTool, type ClientToolExecutionContext, type ClientToolIconProps, type ClientToolRenderProps, type ClientToolStatus, DEFAULT_AGENT_PICKER_MODEL_ID, type GetAuthToken, type GetAuthTokenContext, HEROUI_AGENT_RUNTIME_TIMING_EVENT, HeroUIAgent, type HeroUIAgentProps, LEGACY_AGENT_MODEL_IDS, createToolHelper, getAgentModelTier, isAgentModelId, resolveAgentModelId, useAgent };

package/dist/index.js

@@ -1,28 +1 @@
-import {
-  HeroUIAgent,
-  useAgent
-} from "./chunk-GDDNN2XY.js";
-import {
-  AGENT_DESIGN_THEMES,
-  AGENT_MODEL_IDS,
-  AGENT_MODEL_OPTIONS,
-  DEFAULT_AGENT_PICKER_MODEL_ID,
-  LEGACY_AGENT_MODEL_IDS,
-  createToolHelper,
-  getAgentModelTier,
-  isAgentModelId,
-  resolveAgentModelId
-} from "./chunk-RQCTC4JB.js";
-export {
-  AGENT_DESIGN_THEMES,
-  AGENT_MODEL_IDS,
-  AGENT_MODEL_OPTIONS,
-  DEFAULT_AGENT_PICKER_MODEL_ID,
-  HeroUIAgent,
-  LEGACY_AGENT_MODEL_IDS,
-  createToolHelper,
-  getAgentModelTier,
-  isAgentModelId,
-  resolveAgentModelId,
-  useAgent
-};
+import{a as m,b as a}from"./chunk-5XUOZ2ZC.js";import"./chunk-A53R5SMW.js";import"./chunk-6ZJJN322.js";import{a as e}from"./chunk-64RI74L5.js";import{a as t,b as n,c as o,d as r,e as A,f as g,g as i}from"./chunk-OA3TG5CS.js";import{a as s}from"./chunk-7KCGPNEN.js";import{a as p}from"./chunk-2XBFFSW2.js";export{p as AGENT_DESIGN_THEMES,t as AGENT_MODEL_IDS,A as AGENT_MODEL_OPTIONS,r as DEFAULT_AGENT_PICKER_MODEL_ID,s as HEROUI_AGENT_RUNTIME_TIMING_EVENT,a as HeroUIAgent,n as LEGACY_AGENT_MODEL_IDS,e as createToolHelper,i as getAgentModelTier,g as isAgentModelId,o as resolveAgentModelId,m as useAgent};

package/dist/interactive-map-surface-WC2LPCR7.js

@@ -0,0 +1 @@
+"use client";import{a as V,b as x}from"./chunk-HCLXS4HQ.js";import{a as G}from"./chunk-CR3H7AVI.js";import{StarFill as ee}from"@gravity-ui/icons";import Z from"maplibre-gl";import{createContext as D,useCallback as H,useContext as $,useEffect as h,useRef as g,useState as k}from"react";import{createPortal as A}from"react-dom";import{jsx as n,jsxs as y}from"react/jsx-runtime";var _=D(null);function O(){if(!(typeof document>"u")){if(document.documentElement.classList.contains("dark")||document.documentElement.dataset.theme==="dark")return"dark";if(document.documentElement.classList.contains("light")||document.documentElement.dataset.theme==="light")return"light"}}function j(e){let a=e?.closest("[data-theme]")?.dataset.theme;return a==="dark"||a==="light"?a:void 0}function B(){return typeof window>"u"?"light":window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light"}function Q(e){let[r,a]=k(()=>O()??B());return h(()=>{let s=e.current?.closest("[data-theme]"),c=()=>a(j(e.current)??O()??B()),t=new MutationObserver(c),m=window.matchMedia("(prefers-color-scheme: dark)");return c(),t.observe(document.documentElement,{attributeFilter:["class","data-theme"],attributes:!0}),s&&s!==document.documentElement&&t.observe(s,{attributeFilter:["data-theme"],attributes:!0}),m.addEventListener("change",c),()=>{t.disconnect(),m.removeEventListener("change",c)}},[e]),r}function X({center:e,children:r,className:a,padding:s,styles:c,zoom:t,...m}){let[o,u]=e,p=g(null),W=g({...m,center:[o,u],zoom:t}),[i,R]=k(null),[L,M]=k("loading"),z=Q(p),b=c[z],w=g(b),I=g(s),P=g(t);return h(()=>{let d=p.current;if(!d)return;let l=new Z.Map({attributionControl:!1,container:d,renderWorldCopies:!1,style:w.current,...W.current}),f=window.setTimeout(()=>M("error"),12e3),E=()=>{window.clearTimeout(f),M("loaded")},N=new ResizeObserver(()=>l.resize());return l.touchZoomRotate.disableRotation(),I.current&&l.setPadding(I.current),l.on("load",E),N.observe(d),R(l),()=>{window.clearTimeout(f),N.disconnect(),l.off("load",E),l.remove(),R(null)}},[]),h(()=>{if(!i||w.current===b)return;let d=window.setTimeout(()=>M("error"),12e3),l=()=>{window.clearTimeout(d),M("loaded")},f=()=>M("loading");return w.current=b,i.once("styledataloading",f),i.setStyle(b,{diff:!1}),i.once("style.load",l),()=>{window.clearTimeout(d),i.off("style.load",l),i.off("styledataloading",f)}},[b,i]),h(()=>{if(!i)return;let d=i.getCenter(),l=d.lng!==o||d.lat!==u,f=P.current!==t;P.current=t,!(!l&&!f)&&i.easeTo({center:[o,u],duration:window.matchMedia("(prefers-reduced-motion: reduce)").matches?0:350,...f?{zoom:t}:{}})},[u,o,i,t]),n(_,{value:i,children:y("div",{ref:p,className:G("aui-interactive-map",a),"data-load-state":L,"data-slot":"agent-ui-interactive-map",children:[L==="loading"?n("div",{"aria-label":"Loading map",className:"aui-interactive-map__loader",role:"status",children:n("span",{})}):null,L==="error"?y("div",{className:"aui-interactive-map__error",role:"status",children:[n("strong",{children:"Map unavailable"}),n("span",{children:"Location results remain available."})]}):null,i?r:null]})})}function q({children:e,latitude:r,longitude:a}){let s=$(_),c=g({latitude:r,longitude:a}),[t,m]=k(null);return h(()=>{let o=document.createElement("div"),u=c.current,p=new Z.Marker({element:o}).setLngLat([u.longitude,u.latitude]);return o.className="aui-interactive-map__marker-host",m(p),()=>{p.remove()}},[]),h(()=>{if(!s||!t)return;t.addTo(s);let o=t.getElement();return o.removeAttribute("aria-label"),o.removeAttribute("role"),o.removeAttribute("tabindex"),()=>{t.remove()}},[s,t]),h(()=>{t?.setLngLat([a,r])},[r,a,t]),t?A(n("div",{className:"aui-interactive-map__marker-content",children:e}),t.getElement()):null}function T({children:e,label:r,...a}){return n("button",{"aria-label":r,className:"aui-interactive-map__control-button",type:"button",...a,children:e})}function J(e){return n("svg",{"aria-hidden":"true",fill:"none",viewBox:"0 0 16 16",...e,children:n("path",{d:"M8 3v10M3 8h10",stroke:"currentColor",strokeLinecap:"round",strokeWidth:"1.5"})})}function K(e){return n("svg",{"aria-hidden":"true",fill:"none",viewBox:"0 0 16 16",...e,children:n("path",{d:"M3 8h10",stroke:"currentColor",strokeLinecap:"round",strokeWidth:"1.5"})})}function U(e){return y("svg",{"aria-hidden":"true",fill:"none",viewBox:"0 0 24 24",...e,children:[n("path",{d:"M12 2 16 12h-4V2Z","data-needle":"north-right"}),n("path",{d:"m12 2-4 10h4V2Z","data-needle":"north-left"}),n("path",{d:"m12 22 4-10h-4v10Z","data-needle":"south-right"}),n("path",{d:"m12 22-4-10h4v10Z","data-needle":"south-left"})]})}function Y(){let e=$(_),r=g(null),a=H(()=>{!e||!r.current||(r.current.style.transform=`rotateX(${e.getPitch()}deg) rotateZ(${-e.getBearing()}deg)`)},[e]);return h(()=>{if(e)return e.on("pitch",a),e.on("rotate",a),a(),()=>{e.off("pitch",a),e.off("rotate",a)}},[e,a]),y("div",{className:"aui-interactive-map__controls","data-slot":"agent-ui-map-controls",children:[y("div",{className:"aui-interactive-map__control-group",children:[n(T,{label:"Zoom in",onClick:()=>e?.zoomTo(e.getZoom()+1,{duration:250}),children:n(J,{})}),n(T,{label:"Zoom out",onClick:()=>e?.zoomTo(e.getZoom()-1,{duration:250}),children:n(K,{})})]}),n("div",{className:"aui-interactive-map__control-group",children:n(T,{label:"Reset bearing to north",onClick:()=>e?.resetNorthPitch({duration:250}),children:n(U,{ref:r,className:"aui-interactive-map__compass"})})})]})}var C=Object.assign(X,{Controls:Y,Marker:q});import{jsx as v,jsxs as S}from"react/jsx-runtime";var te={dark:"https://basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json",light:"https://basemaps.cartocdn.com/gl/voyager-gl-style/style.json"},ae={bottom:132,left:0,right:0,top:0},F=new Intl.NumberFormat(void 0,{maximumFractionDigits:1,minimumFractionDigits:1});function me({component:e,onSelect:r,selectedLocationId:a}){let s=x(e),c=V(e.locations,a,s.center);return S("div",{"aria-label":`${e.title} map with ${e.locations.length} locations`,className:"aui-map__surface","data-renderer":"interactive","data-slot":"agent-ui-map-surface",role:"region",children:[S(C,{center:[c.longitude,c.latitude],className:"aui-map__interactive-map",dragRotate:!1,padding:ae,pitchWithRotate:!1,styles:te,zoom:s.zoom,children:[e.locations.map((t,m)=>{let o=t.id===a,u=t.rating!==void 0?F.format(t.rating):t.relevance!==void 0?`${Math.round(t.relevance*100)}%`:String(m+1),p=`Select ${t.title} on map${t.rating===void 0?"":`, rated ${F.format(t.rating)} out of 5`}`;return v(C.Marker,{latitude:t.latitude,longitude:t.longitude,children:S("button",{"aria-label":p,"aria-pressed":o,className:"aui-map__marker","data-renderer":"interactive","data-selected":o,"data-slot":"agent-ui-map-marker",title:t.title,type:"button",onClick:()=>r(t),children:[v(ee,{"aria-hidden":"true"}),v("span",{children:u})]})},t.id)}),v(C.Controls,{})]}),S("span",{className:"aui-map__attribution","data-slot":"agent-ui-map-attribution",children:[v("a",{href:"https://www.openstreetmap.org/copyright",rel:"noreferrer",target:"_blank",children:"\xA9 OpenStreetMap"}),v("span",{"aria-hidden":"true",children:" \xB7 "}),v("a",{href:"https://carto.com/attributions",rel:"noreferrer",target:"_blank",children:"\xA9 CARTO"})]})]})}export{me as InteractiveMapSurface};

package/dist/internal/client-tools.js

@@ -0,0 +1 @@
+import{a,b,c,d}from"../chunk-64RI74L5.js";export{a as createToolHelper,b as isZodSchema,c as parseClientToolArgs,d as resolveDirectToolAction};

package/dist/internal/models.js

@@ -0,0 +1 @@
+import{a,b,c,d,e,f,g}from"../chunk-OA3TG5CS.js";export{a as AGENT_MODEL_IDS,e as AGENT_MODEL_OPTIONS,d as DEFAULT_AGENT_PICKER_MODEL_ID,b as LEGACY_AGENT_MODEL_IDS,g as getAgentModelTier,f as isAgentModelId,c as resolveAgentModelId};

package/dist/internal/runtime.js

@@ -0,0 +1 @@
+import{a,b,c,d}from"../chunk-7KCGPNEN.js";export{a as HEROUI_AGENT_RUNTIME_TIMING_EVENT,d as HEROUI_AGENT_TURN_ADMISSION_STATUS_MAX_IDS,c as HEROUI_AGENT_TURN_ADMISSION_STATUS_METHOD,b as HEROUI_AGENT_TURN_ADMITTED_FRAME_TYPE};

package/dist/internal/theme.js

@@ -0,0 +1 @@
+import{a,b,c,d,e,f}from"../chunk-2XBFFSW2.js";export{c as ACCENT_FOREGROUND_CSS,a as AGENT_DESIGN_THEMES,d as LAUNCHER_FOREGROUND_CSS,e as buildLauncherStyle,f as buildThemeStyle,b as resolveAgentDesignTheme};

package/dist/next.d.ts

@@ -1,4 +1,5 @@
-export { AGENT_MODEL_IDS, AGENT_MODEL_OPTIONS, AgentAttachmentContentType, AgentAuthToken, AgentComposerOptions, AgentContext, AgentController, AgentFeedbackReason, AgentMarkdownAnimation, AgentMarkdownCaret, AgentMarkdownOptions, AgentMarkdownPlugins, AgentMarkdownRenderer, AgentMarkdownRendererProps, AgentModelId, AgentModelOption, AgentModelTier, AgentPermissionMode, AgentPermissionOptions, AgentResponseFeedback, AgentSharedContext, ClientTool, ClientToolIconProps, ClientToolRenderProps, ClientToolStatus, DEFAULT_AGENT_PICKER_MODEL_ID, GetAuthToken, GetAuthTokenContext, HeroUIAgent, HeroUIAgentProps, createToolHelper, getAgentModelTier, isAgentModelId, useAgent } from './index.js';
+export { AGENT_MODEL_IDS, AGENT_MODEL_OPTIONS, AgentActivityPhase, AgentAttachmentContentType, AgentAuthToken, AgentComposerOptions, AgentContext, AgentController, AgentFeedbackReason, AgentMarkdownAnimation, AgentMarkdownCaret, AgentMarkdownOptions, AgentMarkdownPlugins, AgentMarkdownRenderer, AgentMarkdownRendererProps, AgentModelId, AgentModelOption, AgentModelTier, AgentPermissionMode, AgentPermissionOptions, AgentResponseFeedback, AgentRuntimeTiming, AgentRuntimeTimingEventDetail, AgentSharedContext, ClientTool, ClientToolExecutionContext, ClientToolIconProps, ClientToolRenderProps, ClientToolStatus, DEFAULT_AGENT_PICKER_MODEL_ID, GetAuthToken, GetAuthTokenContext, HEROUI_AGENT_RUNTIME_TIMING_EVENT, HeroUIAgent, HeroUIAgentProps, createToolHelper, getAgentModelTier, isAgentModelId, useAgent } from './index.js';
 import 'react';
+import 'react/jsx-runtime';
 import 'zod';
 import 'streamdown';

package/dist/next.js

@@ -1,22 +1 @@
-import {
-  HeroUIAgent,
-  useAgent
-} from "./chunk-GDDNN2XY.js";
-import {
-  AGENT_MODEL_IDS,
-  AGENT_MODEL_OPTIONS,
-  DEFAULT_AGENT_PICKER_MODEL_ID,
-  createToolHelper,
-  getAgentModelTier,
-  isAgentModelId
-} from "./chunk-RQCTC4JB.js";
-export {
-  AGENT_MODEL_IDS,
-  AGENT_MODEL_OPTIONS,
-  DEFAULT_AGENT_PICKER_MODEL_ID,
-  HeroUIAgent,
-  createToolHelper,
-  getAgentModelTier,
-  isAgentModelId,
-  useAgent
-};
+import{a as i,b as p}from"./chunk-5XUOZ2ZC.js";import"./chunk-A53R5SMW.js";import"./chunk-6ZJJN322.js";import{a as e}from"./chunk-64RI74L5.js";import{a as t,d as n,e as o,f as r,g as A}from"./chunk-OA3TG5CS.js";import{a as g}from"./chunk-7KCGPNEN.js";import"./chunk-2XBFFSW2.js";export{t as AGENT_MODEL_IDS,o as AGENT_MODEL_OPTIONS,n as DEFAULT_AGENT_PICKER_MODEL_ID,g as HEROUI_AGENT_RUNTIME_TIMING_EVENT,p as HeroUIAgent,e as createToolHelper,A as getAgentModelTier,r as isAgentModelId,i as useAgent};

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { a as AgentAuthIdentity, b as AgentAuthProfile, c as AgentAuthToken } from './identity-NYCXY1mT.js';
+import { a as AgentAuthIdentity, b as AgentAuthProfile, c as AgentAuthToken } from './identity-3P8-17km.js';
 import 'zod';
 
 type CreateAuthTokenOptions = {

package/dist/server.js

@@ -1,256 +1 @@
-// src/contracts/identity.ts
-import { z as z3 } from "zod";
-
-// src/contracts/client-tools.ts
-import { z } from "zod";
-var RESERVED_AGENT_TOOL_NAMES = [
-  "composeUI",
-  "executeSandbox",
-  "getComponentSchema",
-  "loadUIRenderers",
-  "renderComponent",
-  "searchKnowledge",
-  "searchWeb"
-];
-var RESERVED_AGENT_TOOL_PREFIX = "mcp_";
-var MAX_CLIENT_TOOLS = 20;
-var MAX_CLIENT_TOOLS_BYTES = 16 * 1024;
-var clientToolManifestEntrySchema = z.object({
-  description: z.string().trim().min(1).max(1e3),
-  inputSchema: z.record(z.string(), z.unknown()),
-  name: z.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/).refine(
-    (name) => !RESERVED_AGENT_TOOL_NAMES.includes(name) && !name.toLowerCase().startsWith(RESERVED_AGENT_TOOL_PREFIX),
-    "Client tool name is reserved by the HeroUI Agent runtime"
-  ),
-  needsApproval: z.boolean().optional()
-});
-var clientToolsSchema = z.array(clientToolManifestEntrySchema).max(MAX_CLIENT_TOOLS).superRefine((tools, context) => {
-  const names = /* @__PURE__ */ new Set();
-  for (const entry of tools) {
-    if (names.has(entry.name)) {
-      context.addIssue({ code: "custom", message: `Duplicate client tool name: ${entry.name}` });
-    }
-    names.add(entry.name);
-  }
-  if (new TextEncoder().encode(JSON.stringify(tools)).byteLength > MAX_CLIENT_TOOLS_BYTES) {
-    context.addIssue({ code: "custom", message: "Client tool manifest exceeds 16KB" });
-  }
-});
-
-// src/contracts/models.schema.ts
-import { z as z2 } from "zod";
-
-// src/contracts/models.ts
-var AGENT_MODEL_IDS = [
-  "moonshotai/Kimi-K3",
-  "openai/gpt-5.6-luna",
-  "openai/gpt-5.6-terra",
-  "openai/gpt-5.6-sol",
-  "google/gemini-3.6-flash",
-  "anthropic/claude-sonnet-5",
-  "anthropic/claude-opus-4.8"
-];
-var LEGACY_AGENT_MODEL_IDS = {
-  "google/gemini-3.5-flash": "google/gemini-3.6-flash"
-};
-function resolveAgentModelId(value) {
-  return LEGACY_AGENT_MODEL_IDS[value] ?? value;
-}
-var AGENT_MODEL_ID_SET = new Set(AGENT_MODEL_IDS);
-
-// src/contracts/models.schema.ts
-var agentModelIdSchema = z2.preprocess(
-  (value) => typeof value === "string" ? resolveAgentModelId(value) : value,
-  z2.enum(AGENT_MODEL_IDS)
-);
-
-// src/contracts/version.ts
-var HEROUI_AGENT_PROTOCOL_VERSION = 5;
-var HEROUI_AGENT_SDK_VERSION = "0.2.0-beta.1";
-
-// src/contracts/identity.ts
-var agentThemeSchema = z3.enum(["light", "dark", "system"]);
-var agentSurfaceVariantSchema = z3.enum([
-  "outline",
-  "plain",
-  "surface",
-  "surface-secondary"
-]);
-var pageContextSchema = z3.record(z3.string().max(100), z3.unknown());
-var RESERVED_IDENTITY_IDS = /* @__PURE__ */ new Set([
-  "[object object]",
-  "0",
-  "anonymous",
-  "distinct_id",
-  "distinctid",
-  "email",
-  "false",
-  "guest",
-  "id",
-  "nan",
-  "none",
-  "not_authenticated",
-  "null",
-  "true",
-  "undefined"
-]);
-var agentIdentityIdSchema = z3.string().trim().min(1).max(200).refine((value) => !RESERVED_IDENTITY_IDS.has(value.toLowerCase()), {
-  message: "Identity id is reserved"
-});
-var agentAuthIdentitySchema = z3.discriminatedUnion("type", [
-  z3.object({
-    id: agentIdentityIdSchema,
-    type: z3.literal("anonymous")
-  }),
-  z3.object({
-    id: agentIdentityIdSchema,
-    type: z3.literal("user")
-  })
-]);
-var agentAuthProfileSchema = z3.object({
-  avatarUrl: z3.string().trim().pipe(z3.url()).optional(),
-  email: z3.string().trim().max(320).pipe(z3.email()).optional(),
-  name: z3.string().trim().max(120).optional()
-});
-var createAgentAuthTokenRequestSchema = z3.object({
-  /**
-   * Browser-scoped id the SDK passed to the host callback. Sending it together
-   * with an identified `identity` merges that anonymous person's conversations
-   * into the identified user, so history survives login.
-   */
-  anonymousId: agentIdentityIdSchema.optional(),
-  identity: agentAuthIdentitySchema,
-  profile: agentAuthProfileSchema.optional()
-});
-var agentAuthTokenSchema = z3.object({
-  expiresAt: z3.number().int().positive(),
-  token: z3.string().trim().min(1)
-});
-var agentTokenClaimsSchema = z3.object({
-  agentId: z3.string().trim().min(1).max(100),
-  apiKeyId: z3.string().trim().min(1).max(100),
-  aud: z3.literal("heroui-agent"),
-  exp: z3.number().int().positive(),
-  iat: z3.number().int().positive(),
-  iss: z3.literal("https://api.heroui.com"),
-  jti: z3.uuid(),
-  protocolVersion: z3.literal(HEROUI_AGENT_PROTOCOL_VERSION),
-  sub: z3.string().trim().min(1).max(200)
-});
-var trustedAgentClientDataSchema = z3.object({
-  agentId: z3.string(),
-  billingLicenseId: z3.string().nullable(),
-  billingOwnerUserId: z3.string(),
-  /**
-   * Browser-declared client tools the embed can execute for this turn. The
-   * runtime registers them as model-visible tools without an execute function.
-   */
-  clientTools: clientToolsSchema.default([]),
-  conversationId: z3.uuid(),
-  /**
-   * Pseudonymous identity used by persisted conversations. This is signed by
-   * the API so the runtime can link telemetry without handling a raw identity.
-   */
-  endUserKey: z3.string().trim().min(1).max(200).optional(),
-  /**
-   * When web search is enabled, allow image results via `includeImages`.
-   * Defaults to true at the host when omitted; optional here so signed
-   * payloads without the field stay valid and keep image search on.
-   */
-  imageSearch: z3.boolean().optional(),
-  /**
-   * Optional browser-selected OpenRouter model. The API accepts only the
-   * fixed agent allowlist and signs the value before the runtime sees it.
-   */
-  modelId: agentModelIdSchema.optional(),
-  pageContext: pageContextSchema.default({}),
-  /**
-   * Set by the API when the session was authorized by a dashboard preview
-   * credential rather than a host API key, so operator traffic can be separated
-   * from real visitors. Optional (not defaulted) to keep older signed payloads
-   * valid.
-   */
-  preview: z3.boolean().optional(),
-  protocolVersion: z3.literal(HEROUI_AGENT_PROTOCOL_VERSION),
-  requestId: z3.uuid(),
-  sdkVersion: z3.string().trim().min(1).max(80),
-  signedAt: z3.number(),
-  subject: z3.string(),
-  /**
-   * Host-enabled public web search. When true the runtime registers the
-   * `searchWeb` tool (if the search backend is configured) so the agent can
-   * look up public information and images. Optional (not defaulted) so schema
-   * parsing never injects a field into an already-signed payload.
-   */
-  webSearch: z3.boolean().optional()
-});
-var signedTrustedAgentClientDataSchema = trustedAgentClientDataSchema.extend({
-  sig: z3.string().min(1)
-});
-var agentProjectConfigSchema = z3.object({
-  agentId: z3.string(),
-  minimumProtocolVersion: z3.literal(HEROUI_AGENT_PROTOCOL_VERSION),
-  name: z3.string().trim().min(1).max(120),
-  protocolVersion: z3.literal(HEROUI_AGENT_PROTOCOL_VERSION),
-  /**
-   * Internal streaming infrastructure endpoint, resolved server-side so
-   * customers never configure it. Optional for compatibility with older API
-   * deployments; the SDK falls back to Trigger.dev's public endpoint.
-   */
-  realtime: z3.object({ url: z3.url() }).optional(),
-  sdkVersion: z3.string().default(HEROUI_AGENT_SDK_VERSION),
-  suggestedPrompts: z3.array(z3.string().trim().min(1).max(160)).max(5),
-  surfaceVariant: agentSurfaceVariantSchema.default("plain"),
-  theme: agentThemeSchema
-});
-
-// src/server/index.ts
-var DEFAULT_API_BASE_URL = "https://api.heroui.com";
-var HeroUIAgentAuthError = class extends Error {
-  status;
-  constructor(message, status, options) {
-    super(message, options);
-    this.name = "HeroUIAgentAuthError";
-    this.status = status;
-  }
-};
-async function createAuthToken(options) {
-  const apiKey = options.apiKey.trim();
-  const agentId = options.agentId.trim();
-  const request = createAgentAuthTokenRequestSchema.safeParse({
-    anonymousId: options.anonymousId,
-    identity: options.identity,
-    profile: options.profile
-  });
-  if (!apiKey || !agentId || !request.success) {
-    throw new HeroUIAgentAuthError("Invalid HeroUI Agent auth token request", 400);
-  }
-  const apiBaseUrl = (options.apiBaseUrl?.trim() || DEFAULT_API_BASE_URL).replace(/\/$/, "");
-  let response;
-  try {
-    response = await fetch(`${apiBaseUrl}/v1/agents/${encodeURIComponent(agentId)}/auth-tokens`, {
-      body: JSON.stringify(request.data),
-      cache: "no-store",
-      headers: {
-        Accept: "application/json",
-        "Content-Type": "application/json",
-        "X-HeroUI-Agent-Key": apiKey
-      },
-      method: "POST"
-    });
-  } catch (cause) {
-    throw new HeroUIAgentAuthError("HeroUI Agent authentication is unavailable", 503, { cause });
-  }
-  if (!response.ok) {
-    throw new HeroUIAgentAuthError("HeroUI Agent authentication failed", response.status);
-  }
-  const parsed = agentAuthTokenSchema.safeParse(await response.json().catch(() => null));
-  if (!parsed.success) {
-    throw new HeroUIAgentAuthError("HeroUI Agent authentication returned invalid data", 502);
-  }
-  return parsed.data;
-}
-export {
-  HeroUIAgentAuthError,
-  createAuthToken
-};
+import{z as e}from"zod";var m="0.2.0-beta.10";var d=e.enum(["light","dark","system"]),A=e.enum(["outline","plain","surface","surface-secondary"]),y=new Set(["[object object]","0","anonymous","distinct_id","distinctid","email","false","guest","id","nan","none","not_authenticated","null","true","undefined"]),c=e.string().trim().min(1).max(200).refine(t=>!y.has(t.toLowerCase()),{message:"Identity id is reserved"}),f=e.discriminatedUnion("type",[e.object({id:c,type:e.literal("anonymous")}),e.object({id:c,type:e.literal("user")})]),S=e.object({avatarUrl:e.string().trim().pipe(e.url()).optional(),email:e.string().trim().max(320).pipe(e.email()).optional(),name:e.string().trim().max(120).optional()}),u=e.object({anonymousId:c.optional(),identity:f,profile:S.optional()}),g=e.object({expiresAt:e.number().int().positive(),token:e.string().trim().min(1)}),O=e.object({agentId:e.string().trim().min(1).max(100),apiKeyId:e.string().trim().min(1).max(100),aud:e.literal("heroui-agent"),exp:e.number().int().positive(),iat:e.number().int().positive(),iss:e.literal("https://api.heroui.com"),jti:e.uuid(),protocolVersion:e.literal(6),sub:e.string().trim().min(1).max(200)});var R=e.object({agentId:e.string(),minimumProtocolVersion:e.literal(6),name:e.string().trim().min(1).max(120),protocolVersion:e.literal(6),sdkVersion:e.string().default(m),suggestedPrompts:e.array(e.string().trim().min(1).max(160)).max(5),surfaceVariant:A.default("plain"),theme:d});var I="https://api.heroui.com",n=class extends Error{status;constructor(o,i,a){super(o,a),this.name="HeroUIAgentAuthError",this.status=i}};async function C(t){let o=t.apiKey.trim(),i=t.agentId.trim(),a=u.safeParse({anonymousId:t.anonymousId,identity:t.identity,profile:t.profile});if(!o||!i||!a.success)throw new n("Invalid HeroUI Agent auth token request",400);let h=(t.apiBaseUrl?.trim()||I).replace(/\/$/,""),r;try{r=await fetch(`${h}/v1/agents/${encodeURIComponent(i)}/auth-tokens`,{body:JSON.stringify(a.data),cache:"no-store",headers:{Accept:"application/json","Content-Type":"application/json","X-HeroUI-Agent-Key":o},method:"POST"})}catch(l){throw new n("HeroUI Agent authentication is unavailable",503,{cause:l})}if(!r.ok)throw new n("HeroUI Agent authentication failed",r.status);let p=g.safeParse(await r.json().catch(()=>null));if(!p.success)throw new n("HeroUI Agent authentication returned invalid data",502);return p.data}export{n as HeroUIAgentAuthError,C as createAuthToken};

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@heroui/agent",
-  "version": "0.2.0-beta.1",
+  "version": "0.2.0-beta.10",
   "description": "Embed a hosted HeroUI Agent that turns application data into interactive UI.",
   "homepage": "https://www.heroui.com/agents",
   "bugs": {
-    "url": "https://github.com/heroui-inc/heroui-platform/issues"
+    "url": "https://github.com/heroui-inc/heroui-pro/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/heroui-inc/heroui-platform.git",
+    "url": "git+https://github.com/heroui-inc/heroui-pro.git",
     "directory": "packages/agent"
   },
   "keywords": [
@@ -64,31 +64,15 @@
   "engines": {
     "node": ">=20"
   },
-  "scripts": {
-    "build": "rm -rf dist && tsup && pnpm build:styles",
-    "build:contracts": "rm -rf dist && tsup --config tsup.contracts.config.ts",
-    "build:styles": "node scripts/build-styles.mjs",
-    "check:bundle": "node scripts/check-bundle-size.mjs",
-    "check:package": "publint && attw --pack . --profile esm-only --exclude-entrypoints css css/index.css",
-    "check:styles": "node scripts/build-styles.mjs --check",
-    "clean": "rm -rf dist node_modules .turbo",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "prepublishOnly": "export npm_config_dry_run=false && pnpm --dir ../.. exec turbo run build --filter=@heroui/agent && pnpm lint && pnpm typecheck && pnpm test && pnpm check:package && pnpm check:bundle && pnpm verify:pack",
-    "release": "pnpm prepublishOnly && pnpm version:bump",
-    "test": "NODE_OPTIONS=\"${NODE_OPTIONS:+$NODE_OPTIONS }--no-experimental-webstorage\" vitest run",
-    "typecheck": "tsc --noEmit",
-    "version:bump": "bumpp package.json src/contracts/version.ts ../../apps/frontend/src/app/dashboard/agents/_preview/contracts/version.ts --commit \"chore(agent): release heroui-agent-v%s\" --tag \"heroui-agent-v%s\"",
-    "verify:pack": "node scripts/verify-packed-package.mjs"
-  },
   "dependencies": {
     "@ai-sdk/react": "4.0.12",
+    "@cloudflare/ai-chat": "0.10.1",
     "@gravity-ui/icons": "2.18.0",
     "@heroui/react": "3.2.2",
     "@internationalized/date": "3.12.2",
     "@react-aria/utils": "3.34.1",
     "@react-stately/utils": "3.12.1",
-    "@trigger.dev/sdk": "4.5.7",
+    "agents": "0.20.1",
     "ai": "7.0.11",
     "maplibre-gl": "5.24.0",
     "motion": "12.38.0",
@@ -110,10 +94,6 @@
   ],
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.5",
-    "@heroui-pro/config": "workspace:*",
-    "@heroui-pro/react": "workspace:*",
-    "@heroui/agent-client": "workspace:*",
-    "@heroui/agent-ui": "workspace:*",
     "@heroui/styles": "3.2.2",
     "@tailwindcss/cli": "4.2.2",
     "@types/react": "19.2.14",
@@ -128,6 +108,25 @@
     "tailwindcss": "4.2.2",
     "tsup": "8.5.0",
     "typescript": "5.9.3",
-    "vitest": "4.1.0"
+    "vitest": "4.1.0",
+    "@heroui-pro/config": "0.0.0",
+    "@heroui-pro/react": "1.0.0-beta.8",
+    "@heroui/agent-client": "0.0.0",
+    "@heroui/agent-ui": "0.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsup && pnpm build:styles",
+    "build:contracts": "rm -rf dist && tsup --config tsup.contracts.config.ts",
+    "build:styles": "node scripts/build-styles.mjs",
+    "check:bundle": "node scripts/check-bundle-size.mjs",
+    "check:package": "publint && attw --pack . --profile esm-only --exclude-entrypoints css css/index.css",
+    "check:styles": "node scripts/build-styles.mjs --check",
+    "clean": "rm -rf dist node_modules .turbo",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "release": "pnpm prepublishOnly && bumpp package.json src/contracts/version.ts ../../apps/frontend/src/app/dashboard/agents/_preview/contracts/version.ts --commit \"chore(agent): release heroui-agent-v%s\" --tag \"heroui-agent-v%s\"",
+    "test": "NODE_OPTIONS=\"${NODE_OPTIONS:+$NODE_OPTIONS }--no-experimental-webstorage\" vitest run",
+    "typecheck": "tsc --noEmit",
+    "verify:pack": "node scripts/verify-packed-package.mjs"
   }
-}
+}