@heroui/agent 0.2.0-beta.7 → 0.2.0-beta.9

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" */
@@ -511,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
@@ -574,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
@@ -582,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;
@@ -607,6 +643,6 @@ declare function useAgent(agentId?: string): AgentController;
  * 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-V5S5FRGV.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-OQGXZY5L.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-SUDHJNTJ.js";import"./chunk-WUAFMD7Z.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-V5S5FRGV.js";
-import {
-  AGENT_MODEL_IDS,
-  AGENT_MODEL_OPTIONS,
-  DEFAULT_AGENT_PICKER_MODEL_ID,
-  createToolHelper,
-  getAgentModelTier,
-  isAgentModelId
-} from "./chunk-OQGXZY5L.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-SUDHJNTJ.js";import"./chunk-WUAFMD7Z.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-Z6i6pL0F.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,260 +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.7";
-
-// 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(),
-  /**
-   * When web search is enabled, allow recent news results via `includeNews`.
-   * Optional and disabled when omitted so older signed payloads remain valid.
-   */
-  newsSearch: z3.boolean().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, images, and optionally news. 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),
-  /**
-   * InstantDB app used for ephemeral live-conversation presence. Optional so
-   * newer SDKs remain compatible with older Agent API deployments.
-   */
-  presence: z3.object({ appId: z3.uuid() }).optional(),
-  protocolVersion: z3.literal(HEROUI_AGENT_PROTOCOL_VERSION),
-  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.9";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,6 +1,6 @@
 {
   "name": "@heroui/agent",
-  "version": "0.2.0-beta.7",
+  "version": "0.2.0-beta.9",
   "description": "Embed a hosted HeroUI Agent that turns application data into interactive UI.",
   "homepage": "https://www.heroui.com/agents",
   "bugs": {
@@ -66,13 +66,13 @@
   },
   "dependencies": {
     "@ai-sdk/react": "4.0.12",
+    "@cloudflare/ai-chat": "0.10.1",
     "@gravity-ui/icons": "2.18.0",
     "@heroui/react": "3.2.2",
-    "@instantdb/core": "1.0.49",
     "@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",
@@ -109,10 +109,10 @@
     "tsup": "8.5.0",
     "typescript": "5.9.3",
     "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"
+    "@heroui-pro/react": "1.0.0-beta.8",
+    "@heroui/agent-ui": "0.0.0",
+    "@heroui-pro/config": "0.0.0"
   },
   "scripts": {
     "build": "rm -rf dist && tsup && pnpm build:styles",