@heroui/agent 1.0.0-beta.5 → 1.0.0-beta.7

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## Unreleased
 
+- Move the model catalog, attachment limits and MIME allowlist, and design theme
+  list out of the published package and into the hosted runtime. Adding a model,
+  attachment type, or theme variant no longer requires a customer npm release.
+  Removed exports: `AGENT_MODEL_IDS`, `AGENT_MODEL_OPTIONS`,
+  `DEFAULT_AGENT_PICKER_MODEL_ID`, `LEGACY_AGENT_MODEL_IDS`,
+  `resolveAgentModelId`, `isAgentModelId`, `getAgentModelTier`,
+  `AgentModelOption`, `AgentModelTier`, `AGENT_DESIGN_THEMES`, every
+  `HEROUI_AGENT_*ATTACHMENT*` constant, `isHeroUIAgentAttachmentContentType`,
+  `resolveHeroUIAgentAttachmentContentType`, and
+  `HeroUIAgentAttachmentContentType`.
+- Type `composer.defaultModel` (`AgentModelId`), `composer.attachments`
+  (`AgentAttachmentContentType`), and `theme.designTheme` (`AgentDesignTheme`)
+  as plain strings. The hosted runtime validates them: retired model ids resolve
+  to their replacement, unknown model ids fall back to the hosted default,
+  unsupported attachment types are dropped, and unknown design themes render
+  `base`.
+- Accept client tool results and page context whose optional fields are
+  `undefined`. The bridge previously rejected them as not JSON-serializable
+  even though `JSON.stringify` drops them; it now forwards the canonical JSON.
 - Move the visible Agent UI into a cross-origin iframe hosted by HeroUI. This is
   the one-time host-bridge upgrade; UI, renderer, chart, PDF/XLSX, and backend
   changes no longer require another customer npm release.

package/README.md

@@ -31,6 +31,7 @@ export function AppAgent() {
       getAuthToken={async (context) => {
         const response = await fetch("/api/heroui-agent/auth-token", {
           method: "POST",
+          signal: context.signal,
           headers: {"Content-Type": "application/json"},
           body: JSON.stringify(context),
         });
@@ -58,6 +59,7 @@ export function AppAgent() {
       getAuthToken={async (context) => {
         const response = await fetch("/api/heroui-agent/auth-token", {
           method: "POST",
+          signal: context.signal,
           headers: {"Content-Type": "application/json"},
           body: JSON.stringify(context),
         });
@@ -264,3 +266,21 @@ MIT — see [LICENSE](LICENSE).
 ---
 
 Built by [HeroUI](https://www.heroui.com)
+
+## Status, recovery, and cancellation
+
+Use `onStatusChange(status)` to observe startup, connection, generation, finishing, and recovery.
+`onError(error)` receives a safe `message`, `category`, `phase`, `retryable`, and `diagnosticId`.
+Use the diagnostic ID to correlate failures; keep prompts, form values, files, credentials, and tool
+outputs out of telemetry. The hosted panel supplies recovery actions and preserves conversation drafts.
+
+Pass `context.signal` from `getAuthToken` into your authentication fetch. Authentication expires
+after 15 seconds and superseded attempts are cancelled. Client tools receive
+`execution.signal` as their third argument; pass it into cancellable requests and use
+`execution.idempotencyKey` for server mutations. Cancellation after dispatch can leave an unknown
+outcome, so the runtime preserves a receipt and does not automatically repeat the effect.
+
+Generated forms submit their validated values as a queued user message without changing the composer
+draft. “Submitted to agent” confirms queue acceptance; action completion is reported separately.
+The selected conversation stays connected while visible. Settled inactive conversations disconnect
+after a grace period; closing the panel leaves active work running.

package/dist/chunk-7NL3SCZA.js

@@ -0,0 +1 @@
+import{b as G}from"./chunk-MPJ6AAXH.js";import{c as K,e as J,f as V,i as X,j as Y,k as Q}from"./chunk-YPHOJDYK.js";function pe(e,t){return e.throwIfAborted(),new Promise((n,r)=>{let l=()=>r(e.reason);e.addEventListener("abort",l,{once:!0});try{t().then(n,r).finally(()=>e.removeEventListener("abort",l))}catch(c){e.removeEventListener("abort",l),r(c)}})}async function _(e,t,n){let r=new AbortController,l=setTimeout(()=>r.abort(new DOMException("Request timed out","TimeoutError")),e),c=n?AbortSignal.any([n,r.signal]):r.signal;try{return await pe(c,()=>t(c))}finally{clearTimeout(l)}}var ge={approval:"This approval has expired. Ask the agent to request it again.",authentication:"Could not authenticate. Sign in if needed, then retry.",chunk:"Could not load the conversation. Retry, or reload the panel.",configuration:"Could not load the agent configuration. Try again.",connection:"Connection interrupted. Check your connection and retry.",credits:"This agent has reached its usage limit.",deleted:"This conversation was deleted. Start a new conversation.",rate_limit:"Too many requests. Wait a moment before retrying.",unknown:"The request could not be completed. Try again."};function Z(e,t="connecting"){let n=e&&typeof e=="object"?e:{},r=[e instanceof Error?e.message:"",n.code,n.status].filter(c=>typeof c=="string"||typeof c=="number").join(" ").toLowerCase(),l=t==="authenticating"||/auth|401|sign.in/.test(r)?"authentication":/429|rate.limit/.test(r)?"rate_limit":/credit|usage.limit|usage_limit|402/.test(r)?"credits":/deleted|conversation_not_found/.test(r)?"deleted":/approval.*expir/.test(r)?"approval":/dynamic.*import|chunk|module.*fetch/.test(r)?"chunk":/config/.test(r)?"configuration":/network|fetch|connect|timeout|timed out/.test(r)?"connection":"unknown";return{category:l,diagnosticId:crypto.randomUUID(),message:ge[l],phase:t,retryable:!["credits","deleted","approval"].includes(l)}}var fe=5e3;function ee(e){return`heroui-agent:anonymous:${e}`}function he(e){return e instanceof Error?e:new Error("Auth token request failed")}var P=class{constructor(t,n){this.agentId=t;this.getAuthToken=n}cached=null;failure=null;generation=0;pending=null;controller=new AbortController;clear(){this.controller.abort(),this.controller=new AbortController,this.generation+=1,this.cached=null,this.failure=null,this.pending=null}reset(){this.clear();try{localStorage.removeItem(ee(this.agentId))}catch{}}async get(){if(this.cached&&this.expiresAt(this.cached)>Date.now()+6e4)return this.cached.token;if(!this.pending&&this.failure&&Date.now()<this.failure.retryAt)throw this.failure.error;let t=this.generation,n=this.pending??this.refresh();this.pending||(this.pending=n);try{let r=await n;return t!==this.generation?this.get():(this.cached=r,this.failure=null,r.token)}catch(r){throw t===this.generation&&(this.failure={error:he(r),retryAt:Date.now()+fe}),r}finally{this.pending===n&&(this.pending=null)}}async subjectHash(){let t=await this.get(),n=me(t),r=typeof n.sub=="string"?n.sub:"anonymous",l=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(`${this.agentId}:${r}`));return Array.from(new Uint8Array(l),c=>c.toString(16).padStart(2,"0")).join("").slice(0,24)}anonymousId(){let t=ee(this.agentId);try{let n=localStorage.getItem(t);if(n)return n;let r=crypto.randomUUID();return localStorage.setItem(t,r),r}catch{return crypto.randomUUID()}}expiresAt(t){return t.expiresAt}async refresh(){let t=await _(15e3,n=>this.getAuthToken({agentId:this.agentId,anonymousId:this.anonymousId(),signal:n}),this.controller.signal);if(!t||typeof t.token!="string"||!t.token.trim()||typeof t.expiresAt!="number"||!Number.isFinite(t.expiresAt)||t.expiresAt<=0)throw new Error("Auth token callback returned invalid data");return{expiresAt:t.expiresAt,token:t.token}}};function me(e){try{let t=e.split(".")[1];if(!t)return{};let n=t.replace(/-/g,"+").replace(/_/g,"/"),r=n.padEnd(Math.ceil(n.length/4)*4,"=");return JSON.parse(atob(r))}catch{return{}}}function te(e){return{bounds:null,closing:!1,dragging:!1,expanded:e.appearance?.panel?.expanded??!1,mounted:!1,open:!1,overlayOpen:!1,ready:!1,resizing:!1,sidebarWidth:null,viewMode:e.appearance?.viewMode??"floating"}}function w(e,t,n){return{background:"transparent",border:"0",clipPath:ye(e,t,n),colorScheme:"normal",height:"100dvh",inset:"0",position:"fixed",width:"100vw",zIndex:t.appearance?.zIndex??40}}function ne(e){if(!e||typeof e!="object")return null;let t=e;return typeof t.open!="boolean"||typeof t.ready!="boolean"||typeof t.expanded!="boolean"||t.viewMode!=="floating"&&t.viewMode!=="sidebar"?null:{bounds:we(t.bounds),closing:t.closing===!0,dragging:t.dragging===!0,expanded:t.expanded,mounted:t.mounted!==!1,open:t.open,overlayOpen:t.overlayOpen===!0,ready:t.ready,resizing:t.resizing===!0,sidebarWidth:L(t.sidebarWidth)?t.sidebarWidth:null,viewMode:t.viewMode}}function oe(){let e=document.documentElement,t=document.body;return{active:!1,body:t,original:{bodyLeft:t.style.left,bodyOverflow:t.style.overflow,bodyPosition:t.style.position,bodyRight:t.style.right,bodyTop:t.style.top,bodyWidth:t.style.width,rootMarginRight:e.style.marginRight,rootOverflow:e.style.overflow,rootTransition:e.style.transition},root:e,scrollLock:null}}function I(e,t,n,r){let l=t.open||t.closing;if(!l&&!e.active)return;l&&(e.active=!0);let c=l&&(r||t.viewMode==="sidebar"&&t.expanded);ie(e,c);let a=l&&t.viewMode==="sidebar"&&!t.expanded&&!r?be(t,n):e.original.rootMarginRight;e.root.style.transition=e.original.rootTransition,e.root.style.marginRight=a,l||(e.active=!1)}function re(e){ie(e,!1),e.root.style.marginRight=e.original.rootMarginRight,e.root.style.transition=e.original.rootTransition,e.active=!1}function ye(e,t,n){let r=e.open||e.closing;if(r&&(n||e.overlayOpen))return"inset(0px)";if(e.bounds)return`inset(${e.bounds.top}px calc(100% - ${e.bounds.right}px) calc(100% - ${e.bounds.bottom}px) ${e.bounds.left}px)`;let l=t.appearance?.launcher,c=l?.position==="bottom-left",g=(l?.offset?.x??24)+60,a=(l?.offset?.y??24)+60;if(!r)return c?`inset(calc(100% - ${a}px) calc(100% - ${g}px) 0px 0px)`:`inset(calc(100% - ${a}px) 0px 0px calc(100% - ${g}px))`;if(e.viewMode==="sidebar")return`inset(0px 0px 0px calc(100% - (${F(t.appearance?.panel?.initialWidth??420)} + 16px)))`;let h=F(t.appearance?.panel?.initialWidth??440),v=`calc(100% - min(calc(${F(t.appearance?.panel?.initialHeight??"max(420px, 56dvh)")} + 32px), 100dvh))`;return c?`inset(${v} calc(100% - min(calc(${h} + 32px), 100vw)) 0px 0px)`:`inset(${v} 0px 0px calc(100% - min(calc(${h} + 32px), 100vw)))`}function we(e){if(!e||typeof e!="object")return null;let t=e;return!L(t.top)||!L(t.right)||!L(t.bottom)||!L(t.left)||t.right<t.left||t.bottom<t.top?null:{bottom:t.bottom,left:t.left,right:t.right,top:t.top}}function L(e){return typeof e=="number"&&Number.isFinite(e)&&e>=0&&e<=1e5}function be(e,t){return e.sidebarWidth===null?F(t.appearance?.panel?.initialWidth??420):`${Math.round(e.sidebarWidth)}px`}function F(e){return typeof e=="number"?`${Math.round(e)}px`:e}function ie(e,t){if(t&&!e.scrollLock){e.scrollLock={x:window.scrollX,y:window.scrollY},e.root.style.overflow="hidden",e.body.style.overflow="hidden",e.body.style.position="fixed",e.body.style.top=`${-e.scrollLock.y}px`,e.body.style.left=`${-e.scrollLock.x}px`,e.body.style.right="0",e.body.style.width="100%";return}if(!t&&e.scrollLock){let{x:n,y:r}=e.scrollLock;e.root.style.overflow=e.original.rootOverflow,e.body.style.overflow=e.original.bodyOverflow,e.body.style.position=e.original.bodyPosition,e.body.style.top=e.original.bodyTop,e.body.style.left=e.original.bodyLeft,e.body.style.right=e.original.bodyRight,e.body.style.width=e.original.bodyWidth,e.scrollLock=null;try{window.scrollTo(n,r)}catch{}}}var ve=16*1024,Ae=64*1024;function De(e,t){let n=e;if(!n?.agentId||typeof n.getAuthToken!="function")throw new Error("HeroUIAgent.mount requires agentId and getAuthToken");let r=crypto.randomUUID(),l=crypto.randomUUID(),c=(n._api?.baseUrl??G).replace(/\/$/,""),g=He(c,n._api?.embedOrigin),a=document.createElement("iframe"),h=new Map,y=[],v=new Set,A=new Map,k=new Set,T=oe(),C=new P(n.agentId,n.getAuthToken),s=te(n),O=null,m=!1,b=!1,x=null,W=!1,$=!1,B=new URL("/embed",g);B.searchParams.set("agentId",n.agentId),B.hash=new URLSearchParams({nonce:l,parentOrigin:window.location.origin,sessionId:r}).toString(),a.allow="microphone; clipboard-write",a.referrerPolicy="origin",a.setAttribute("sandbox","allow-downloads allow-forms allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts"),a.src=B.toString(),a.title="HeroUI Agent",Object.assign(a.style,w(s,n,window.innerWidth<640)),document.body.append(a);let f=(o,i,d)=>{$||a.contentWindow?.postMessage(X(r,l,o,i,d),g)},le=(o,i)=>{let d=crypto.randomUUID();return new Promise((u,p)=>{let H=window.setTimeout(()=>{h.delete(d),p(new Error(`HeroUI Agent iframe request timed out: ${o}`))},3e4);h.set(d,{reject:p,resolve:u,timer:H}),f(o,i,d)})},S=new Map,D=0,q="",N=async(o,i=!1)=>{let d=++D,u=await xe(n,t);if($||d!==D)return;let p=JSON.stringify({props:u.props,tools:u.tools});!i&&p===q||(q=p,f(o,{...u,restoreSession:o==="host.init"&&b}))},E=(o,i)=>{if(!s.mounted){y.push({name:o,payload:i}),y.length>32&&y.shift();return}f("host.command",{name:o,payload:i})},M=o=>{o&&!m&&document.activeElement!==a&&(O=document.activeElement),m=o,o||(b=!1),E(o?"show":"hide")},de=()=>{if(s.mounted)for(let o of y.splice(0))f("host.command",o)},ce=()=>{b=s.mounted&&m&&!s.closing,s={...s,bounds:null,closing:!1,mounted:!1,open:b,ready:!1},W=!1;for(let o of k)o();Object.assign(a.style,w(s,n,window.innerWidth<640)),I(T,s,n,window.innerWidth<640)},z=o=>{if(o.origin!==g||o.source!==a.contentWindow)return;let i=Y(o.data);if(!(!i||i.sessionId!==r||i.nonce!==l)){if(i.type==="iframe.rpc-result"||i.type==="iframe.rpc-error"){Ie(i,h);return}Ee(v,i.requestId)&&ue(i)}},ue=async o=>{try{if(o.type==="iframe.ready"){(s.mounted||s.ready)&&ce(),await N("host.init",!0);return}if(o.type==="iframe.reload"){let i=a.cloneNode(!1),d=new URL(a.src);d.pathname=`/reload/${crypto.randomUUID()}/embed`,i.src=d.href,a.replaceWith(i),a=i;return}if(o.type==="iframe.state"){let i=ne(o.payload);if(i){let d=s.open||s.closing,u=i;b?i.mounted?(b=!1,i.open||(f("host.command",{name:"show"}),u={...i,bounds:null,closing:!1,open:!0,sidebarWidth:i.sidebarWidth??s.sidebarWidth})):u={...i,bounds:null,closing:!1,open:!0,sidebarWidth:i.sidebarWidth??s.sidebarWidth}:i.open?m=!0:(i.closing||s.open||s.closing)&&(m=!1);let p=u.open||u.closing;if(p&&!d&&document.activeElement!==a&&(O=document.activeElement),!p&&d&&O?.isConnected){let H=O;window.requestAnimationFrame(()=>window.requestAnimationFrame(()=>H.focus({preventScroll:!0})))}s=u,p&&s.expanded?a.dataset.expanded="true":a.removeAttribute("data-expanded");for(let H of k)H();Object.assign(a.style,w(s,n,window.innerWidth<640)),I(T,s,n,window.innerWidth<640),de(),s.ready&&!W&&(W=!0,n.onReady?.())}return}if(o.type==="iframe.error"){n.onError?.(o.payload);return}if(o.type==="iframe.status"){n.onStatusChange?.(o.payload);return}if(o.type==="iframe.tool-cancel"){let i=o.payload;i.idempotencyKey&&S.get(i.idempotencyKey)?.abort();return}if(o.type==="iframe.auth-request"){let i=await C.get(),d=await _(15e3,u=>fetch(`${c}/v1/agents/${encodeURIComponent(n.agentId)}/embed-sessions`,{body:JSON.stringify({iframeOrigin:g,sessionId:r}),cache:"no-store",headers:{Authorization:`Bearer ${i}`,"Content-Type":"application/json"},method:"POST",signal:u}));if(!d.ok)throw new Error("Could not authenticate HeroUI Agent");f("host.rpc-result",{value:await d.json()},o.requestId);return}if(o.type==="iframe.context-request"){let i=ae(await n.context?.page?.()??{},ve,"Agent page context");f("host.rpc-result",{value:i},o.requestId);return}if(o.type==="iframe.tool-execute"){let i=ke(o.payload),d=n.tools?.find(p=>p.name===i.name);if(!d)throw new Error(`Unknown client tool: ${i.name}`);let u=A.get(i.idempotencyKey);if(!u){let p=new AbortController;S.set(i.idempotencyKey,p),u=Te(d,i,n,le,p.signal).finally(()=>S.delete(i.idempotencyKey)),A.set(i.idempotencyKey,u),A.size>2048&&A.delete(A.keys().next().value)}f("host.rpc-result",{value:await u},o.requestId);return}if(o.type==="iframe.feedback"){await n.onFeedback?.(o.payload);return}if(o.type==="iframe.storage"){Se(o.payload);return}if(o.type==="iframe.persistence"){let i=await import("./persistence-YI6JSYCT.js").then(({executeAgentHostPersistence:d})=>d(n.agentId,o.payload));f("host.rpc-result",{value:i},o.requestId)}}catch(i){let d=Z(i,o.type==="iframe.auth-request"?"authenticating":"failed");n.onError?.(d),f("host.rpc-error",{error:d.message},o.requestId)}},j=o=>{o.composedPath().includes(a)||s.open&&s.viewMode==="floating"&&(n.appearance?.shouldCloseOnInteractOutside??!0)&&M(!1)},R=()=>{s={...s,bounds:null},Object.assign(a.style,w(s,n,window.innerWidth<640)),I(T,s,n,window.innerWidth<640)},U=()=>{document.visibilityState==="visible"&&(s={...s,bounds:null},Object.assign(a.style,w(s,n,window.innerWidth<640)),I(T,s,n,window.innerWidth<640),m&&s.mounted&&f("host.command",{name:"show"}),x!==null&&window.cancelAnimationFrame(x),x=window.requestAnimationFrame(()=>{x=null,Object.assign(a.style,w(s,n,window.innerWidth<640))}))};return window.addEventListener("message",z),window.addEventListener("pointerdown",j,!0),window.addEventListener("resize",R),window.addEventListener("pageshow",U),window.visualViewport?.addEventListener("resize",R),document.addEventListener("visibilitychange",U),{destroy:()=>{$=!0;for(let o of S.values())o.abort();S.clear(),window.removeEventListener("message",z),window.removeEventListener("pointerdown",j,!0),window.removeEventListener("resize",R),window.removeEventListener("pageshow",U),window.visualViewport?.removeEventListener("resize",R),document.removeEventListener("visibilitychange",U),x!==null&&window.cancelAnimationFrame(x);for(let o of h.values())window.clearTimeout(o.timer),o.reject(new Error("HeroUI Agent iframe was removed"));h.clear(),y.length=0,k.clear(),re(T),a.remove()},hide:()=>M(!1),newConversation:o=>{m=!0,E("newConversation",{prompt:o})},preload:()=>E("preload"),get ready(){return s.ready},refreshAuth:()=>{C.clear(),E("refreshAuth")},show:()=>M(!0),shutdown:()=>{m=!1,b=!1,C.reset(),E("shutdown")},subscribe:o=>(k.add(o),()=>k.delete(o)),toggle:()=>M(!m),update:o=>{if(o.agentId!==n.agentId)throw new Error("HeroUI Agent agentId cannot change without remounting");o.getAuthToken!==n.getAuthToken&&(C=new P(o.agentId,o.getAuthToken)),n=o,Object.assign(a.style,w(s,n,window.innerWidth<640)),I(T,s,n,window.innerWidth<640),s.ready&&N("host.update")}}}async function Te(e,t,n,r,l){let c={conversationId:t.conversationId,idempotencyKey:t.idempotencyKey,signal:l,toolCallId:t.toolCallId,uploadDataSource:async a=>await r("host.upload-data-source",{toolCallId:t.toolCallId,upload:a})},g=await e.execute(K(e,t.args),n.context??{},c)??null;return ae(g,Ae,`Client tool ${e.name} result`)}async function xe(e,t){let{context:n,getAuthToken:r,onError:l,onFeedback:c,onReady:g,onStatusChange:a,tools:h,...y}=e,v=await t(h??[]);return{localStorage:se(window.localStorage),props:JSON.parse(JSON.stringify(y)),sessionStorage:se(window.sessionStorage),tools:v}}function Ie(e,t){let n=t.get(e.requestId);if(n)if(t.delete(e.requestId),window.clearTimeout(n.timer),e.type==="iframe.rpc-error"){let r=e.payload;n.reject(new Error(typeof r?.error=="string"?r.error:"Iframe request failed"))}else{let r=e.payload;n.resolve(r?.value)}}function ke(e){if(!e||typeof e!="object")throw new Error("Invalid client tool request");let t=e;if(typeof t.conversationId!="string"||typeof t.idempotencyKey!="string"||typeof t.name!="string"||typeof t.toolCallId!="string")throw new Error("Invalid client tool request");return t}function ae(e,t,n){if(!Q(e))throw new Error(`${n} must be JSON-serializable`);let r=JSON.stringify(e);if(new TextEncoder().encode(r).byteLength>t)throw new Error(`${n} exceeds ${Math.round(t/1024)} KiB`);return JSON.parse(r)}function se(e){let t={};try{for(let n=0;n<e.length;n+=1){let r=e.key(n);r?.startsWith("heroui-agent:")&&(t[r]=e.getItem(r)??"")}}catch{}return t}function Se(e){if(!e||typeof e!="object")return;let t=e;if(typeof t.key=="string"&&!t.key.startsWith("heroui-agent:"))return;let n=t.storage==="session"?sessionStorage:localStorage;try{if(t.operation==="set"&&typeof t.key=="string"&&typeof t.value=="string")n.setItem(t.key,t.value);else if(t.operation==="remove"&&typeof t.key=="string")n.removeItem(t.key);else if(t.operation==="clear")for(let r=n.length-1;r>=0;r-=1){let l=n.key(r);l?.startsWith("heroui-agent:")&&n.removeItem(l)}}catch{}}function Ee(e,t){return e.has(t)?!1:(e.add(t),e.size>2048&&e.delete(e.values().next().value),!0)}function He(e,t){if(t){let n=new URL(t);if(n.protocol!=="http:"&&n.protocol!=="https:")throw new Error("HeroUI Agent embed origin must use HTTP or HTTPS");return n.origin}return/^https?:\/\/(?:localhost|127\.0\.0\.1)(?::\d+)?$/i.test(e)?"http://localhost:8793":e.includes("staging")?V:J}export{pe as a,_ as b,Z as c,P as d,De as e};

package/dist/chunk-AR424OVX.js

@@ -0,0 +1 @@
+var e={animation:"fadeIn",duration:160,easing:"ease-out",sep:"word",stagger:18};export{e as a};

package/dist/chunk-BDMHEOR3.js

@@ -0,0 +1 @@
+import{b as i,k as a}from"./chunk-YPHOJDYK.js";import{z as t}from"zod";var c=["readConversationHistory","callMcpTool","composeUI","executeSandbox","generateFile","getComponentSchema","renderComponent","searchKnowledge","searchMcpTools","searchWeb"],m="mcp_",p=20,l=16*1024,d=t.object({description:t.string().trim().min(1).max(1e3),inputSchema:t.record(t.string(),t.unknown()),name:t.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/).refine(e=>!c.includes(e)&&!e.toLowerCase().startsWith(m),"Client tool name is reserved by the HeroUI Agent runtime"),needsApproval:t.boolean().optional()}),f=t.array(d).max(p).superRefine((e,n)=>{let o=new Set;for(let r of e)o.has(r.name)&&n.addIssue({code:"custom",message:`Duplicate client tool name: ${r.name}`}),o.add(r.name);new TextEncoder().encode(JSON.stringify(e)).byteLength>l&&n.addIssue({code:"custom",message:"Client tool manifest exceeds 16KB"})});function u(e){let n=i(e.parameters)?t.toJSONSchema(e.parameters):e.parameters;if(!a(n))throw new Error(`Client tool ${e.name} parameters must be a JSON-serializable schema`);return s(n)}function s(e){return Array.isArray(e)?e.map(s):e&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([n,o])=>[n,s(o)])):e}function y(e){return f.parse(e.map(n=>({description:n.description,inputSchema:u(n),name:n.name,...n.needsApproval?{needsApproval:!0}:{}})))}export{c as a,m as b,p as c,l as d,d as e,f,y as g};

package/dist/chunk-MPJ6AAXH.js

@@ -0,0 +1 @@
+var t="1.0.0-beta.7",o="https://api.heroui.pro";export{t as a,o as b};

package/dist/chunk-MVHWCBZK.js

@@ -0,0 +1 @@
+import{e as S}from"./chunk-7NL3SCZA.js";import{b as d}from"./chunk-YPHOJDYK.js";import{useEffect as k,useLayoutEffect as p,useMemo as x,useRef as m,useState as O,useSyncExternalStore as w}from"react";var i=new Map,h=new Set;function f(){for(let e of h)e()}function H(e){return h.add(e),()=>h.delete(e)}function a(e,n,r){let o=e?i.get(e):[...i.values()][i.size-1];if(!o){console.warn("HeroUI Agent is not mounted yet. Add <HeroUIAgent /> to your layout.");return}n==="newConversation"?o.newConversation(r):o[n]()}function R(e){let n=w(H,()=>(e?i.get(e):[...i.values()].at(-1))?.ready??!1,()=>!1);return x(()=>({hide:()=>a(e,"hide"),newConversation:r=>a(e,"newConversation",r),preload:()=>a(e,"preload"),ready:n,refreshAuth:()=>a(e,"refreshAuth"),show:()=>a(e,"show"),shutdown:()=>a(e,"shutdown"),toggle:()=>a(e,"toggle")}),[e,n])}async function E(e){let{serializeClientTools:n}=await import("./client-tools-manifest-3LJBKDBZ.js");return n(e).map(o=>{let s=e.find(l=>l.name===o.name);return{...o,...s?.displayName?{displayName:s.displayName}:{},...s?.icon?{icon:s.icon}:{},...s?.iconColor?{iconColor:s.iconColor}:{}}})}function P(e){let n=m(e),r=m(null),o=m(null);p(()=>{n.current=e}),o.current||(o.current={getAuthToken:t=>n.current.getAuthToken(t),onError:t=>n.current.onError?.(t),onFeedback:t=>n.current.onFeedback?.(t),onReady:()=>n.current.onReady?.(),onStatusChange:t=>n.current.onStatusChange?.(t)},Object.defineProperties(o.current,{context:{enumerable:!0,get(){return n.current.context}},tools:{enumerable:!0,get(){return n.current.tools}}}));let s=T(e),l=o.current;for(let t of Object.keys(l))t!=="context"&&t!=="getAuthToken"&&t!=="onError"&&t!=="onStatusChange"&&t!=="onFeedback"&&t!=="onReady"&&t!=="tools"&&!(t in s)&&delete l[t];Object.assign(l,s,{agentId:e.agentId});let g=o.current;p(()=>{let t=S(g,E),u=t.subscribe(f);return r.current=t,i.set(e.agentId,t),f(),()=>{u(),t.destroy(),i.get(e.agentId)===t&&i.delete(e.agentId),r.current===t&&(r.current=null),f()}},[e.agentId]);let[C,c]=O("");k(()=>{let t=e.tools??[];if(!t.some(A=>d(A.parameters))){c("");return}let u=!1;return import("./client-tools-manifest-3LJBKDBZ.js").then(({serializeClientTools:A})=>{u||c(JSON.stringify(A(t).map(y=>({inputSchema:y.inputSchema,name:y.name}))))}),()=>{u=!0}},[e.tools]);let b=JSON.stringify({props:T(e),tools:(e.tools??[]).map(t=>({description:t.description,displayName:t.displayName,icon:t.icon,iconColor:t.iconColor,name:t.name,needsApproval:t.needsApproval===!0,parameters:d(t.parameters)?null:t.parameters})),zodToolsSchemasKey:C});return p(()=>{r.current?.update(g)},[b]),null}function T(e){let{context:n,getAuthToken:r,onError:o,onFeedback:s,onReady:l,onStatusChange:g,tools:C,...c}=e;return JSON.parse(JSON.stringify(c))}export{R as a,P as b};

package/dist/chunk-YPHOJDYK.js

@@ -0,0 +1 @@
+function m(){return function(e){return e}}function u(t){return!!(t&&typeof t=="object"&&typeof t.safeParse=="function")}function A(t,e){return u(t.parameters)?t.parameters.parse(e):e}function y(t,e){let n=t.get(e);return!n||n.needsApproval?null:n}var x="https://agent.heroui.pro",h="https://staging-agent.heroui.pro",I=262144,S=57671680;function b(t,e,n,s,i=crypto.randomUUID()){return{nonce:e,...s===void 0?{}:{payload:s},requestId:i,sessionId:t,type:n}}function E(t){if(!t||typeof t!="object")return null;let e=t;if(typeof e.sessionId!="string"||!a(e.sessionId)||typeof e.nonce!="string"||!a(e.nonce)||typeof e.requestId!="string"||!a(e.requestId)||typeof e.type!="string"||e.type.length===0||!l.has(e.type))return null;let n=e.type==="iframe.persistence"||e.type==="host.upload-data-source"||e.type==="host.rpc-result"?57671680:262144;return p(t)>n||!f(e.type,e.payload)?null:{nonce:e.nonce,...Object.hasOwn(e,"payload")?{payload:e.payload}:{},requestId:e.requestId,sessionId:e.sessionId,type:e.type}}function d(t,e=new Set){if(t===null||typeof t=="string"||typeof t=="boolean")return!0;if(typeof t=="number")return Number.isFinite(t);if(typeof t!="object"||e.has(t))return!1;e.add(t);let n=i=>i===void 0||d(i,e),s=Array.isArray(t)?t.every(n):Object.getPrototypeOf(t)===Object.prototype&&Object.values(t).every(n);return e.delete(t),s}function p(t){return g(t,new Set)}function g(t,e){if(t==null)return 4;if(typeof t=="string")return new TextEncoder().encode(t).byteLength+2;if(typeof t=="boolean"||typeof t=="number")return 8;if(typeof t!="object"||e.has(t))return Number.POSITIVE_INFINITY;if(t instanceof ArrayBuffer||ArrayBuffer.isView(t))return t.byteLength;if(typeof Blob<"u"&&t instanceof Blob)return t.size;e.add(t);let n=2;for(let[s,i]of Object.entries(t))if(n+=g(s,e)+g(i,e),!Number.isFinite(n))break;return e.delete(t),n}function a(t){return t.length>0&&t.length<=128&&/^[A-Za-z0-9._:-]+$/.test(t)}var l=new Set(["host.command","host.init","host.update","host.rpc-result","host.rpc-error","host.upload-data-source","iframe.ready","iframe.reload","iframe.auth-request","iframe.context-request","iframe.feedback","iframe.persistence","iframe.state","iframe.storage","iframe.rpc-result","iframe.rpc-error","iframe.error","iframe.status","iframe.tool-cancel","iframe.tool-execute"]),c=["loading","authenticating","connecting","ready","generating","finishing","reconnecting","failed"],o=t=>!!(t&&typeof t=="object"&&!Array.isArray(t)),r=t=>typeof t=="string";function f(t,e){if(t==="iframe.ready"||t==="iframe.reload"||t==="iframe.auth-request"||t==="iframe.context-request")return e===void 0;if(t==="iframe.status")return c.includes(e);if(!o(e))return!1;switch(t){case"host.init":case"host.update":return o(e.props)&&o(e.localStorage)&&o(e.sessionStorage)&&Object.values(e.localStorage).every(r)&&Object.values(e.sessionStorage).every(r)&&(e.restoreSession===void 0||typeof e.restoreSession=="boolean")&&Array.isArray(e.tools)&&e.tools.every(n=>o(n)&&r(n.name)&&r(n.description)&&o(n.inputSchema));case"host.command":return["show","hide","toggle","preload","refreshAuth","shutdown","newConversation"].includes(e.name);case"host.rpc-error":case"iframe.rpc-error":return r(e.error);case"host.rpc-result":case"iframe.rpc-result":return!0;case"host.upload-data-source":return r(e.toolCallId)&&o(e.upload);case"iframe.tool-cancel":return r(e.idempotencyKey);case"iframe.tool-execute":return["name","conversationId","idempotencyKey","toolCallId"].every(n=>r(e[n]));case"iframe.error":return["authentication","connection","configuration","chunk","rate_limit","credits","deleted","approval","unknown"].includes(e.category)&&c.includes(e.phase)&&r(e.message)&&r(e.diagnosticId)&&typeof e.retryable=="boolean";case"iframe.state":return["open","ready","expanded","closing","dragging","mounted","overlayOpen","resizing"].every(n=>typeof e[n]=="boolean")&&["floating","sidebar"].includes(e.viewMode);case"iframe.storage":return["local","session"].includes(e.storage)&&(e.operation==="clear"||r(e.key)&&(e.operation==="remove"||e.operation==="set"&&r(e.value)));case"iframe.persistence":return["composer-image-drafts","message-outboxes"].includes(e.store)&&(e.operation==="deletePrefix"?r(e.prefix):["get","put","delete"].includes(e.operation)&&r(e.key));case"iframe.feedback":return r(e.conversationId)&&r(e.messageId)&&["positive","negative"].includes(e.rating)&&Array.isArray(e.reasons)}}export{m as a,u as b,A as c,y as d,x as e,h as f,I as g,S as h,b as i,E as j,d as k,p as l};

package/dist/{client-tools-manifest-62CRLCZY.js → client-tools-manifest-3LJBKDBZ.js}

@@ -1 +1 @@
-import{a,b,c,d,e,f,g}from"./chunk-PKCBDTYR.js";import"./chunk-SWO2ABN5.js";export{c as MAX_CLIENT_TOOLS,d as MAX_CLIENT_TOOLS_BYTES,a as RESERVED_AGENT_TOOL_NAMES,b as RESERVED_AGENT_TOOL_PREFIX,e as clientToolManifestEntrySchema,f as clientToolsSchema,g as serializeClientTools};
+import{a,b,c,d,e,f,g}from"./chunk-BDMHEOR3.js";import"./chunk-YPHOJDYK.js";export{c as MAX_CLIENT_TOOLS,d as MAX_CLIENT_TOOLS_BYTES,a as RESERVED_AGENT_TOOL_NAMES,b as RESERVED_AGENT_TOOL_PREFIX,e as clientToolManifestEntrySchema,f as clientToolsSchema,g as serializeClientTools};

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { a3 as HeroUIAgentProps, l as AgentController } from './types-BdAn3HPv.js';
-export { A as AGENT_DESIGN_THEMES, a as AGENT_MODEL_IDS, b as AGENT_MODEL_OPTIONS, c as AgentApiOverrides, d as AgentAppearance, e as AgentAttachmentContentType, f as AgentAuthToken, g as AgentCapabilities, h as AgentColorScheme, i as AgentComponentExportFormat, j as AgentComposerOptions, k as AgentContext, m as AgentDataSource, n as AgentDataSourceFormat, o as AgentDesignTheme, p as AgentFeedbackReason, q as AgentLauncherOptions, r as AgentLauncherPosition, s as AgentMarkdownAnimation, t as AgentMarkdownAnimationOptions, u as AgentMarkdownCaret, v as AgentMarkdownOptions, w as AgentMessageAction, x as AgentModelId, y as AgentModelOption, z as AgentModelTier, B as AgentPanelOptions, C as AgentPermissionMode, D as AgentPermissionOptions, E as AgentRadius, F as AgentResponseFeedback, G as AgentSharedContext, H as AgentShouldCloseOnInteractOutside, I as AgentStartScreenOptions, J as AgentSurfaceVariant, K as AgentThemeColor, L as AgentThemeColors, M as AgentThemeOptions, N as AgentTypography, O as AgentViewMode, P as ClientTool, Q as ClientToolExecutionContext, R as ClientToolIcon, S as ClientToolStatus, T as DEFAULT_AGENT_PICKER_MODEL_ID, U as DEFAULT_MARKDOWN_ANIMATION, V as GetAuthToken, W as GetAuthTokenContext, X as HEROUI_AGENT_ATTACHMENT_ACCEPT, Y as HEROUI_AGENT_ATTACHMENT_CONTENT_TYPES, Z as HEROUI_AGENT_ATTACHMENT_CONTENT_TYPE_BY_EXTENSION, _ as HEROUI_AGENT_ATTACHMENT_EXTENSION_BY_CONTENT_TYPE, $ as HEROUI_AGENT_ATTACHMENT_MAX_BYTES, a0 as HEROUI_AGENT_MAX_ATTACHMENTS, a1 as HEROUI_AGENT_TEXT_ATTACHMENT_CONTENT_TYPES, a2 as HeroUIAgentAttachmentContentType, a4 as LEGACY_AGENT_MODEL_IDS, a5 as UploadAgentDataSourceInput, a6 as createToolHelper, a7 as getAgentModelTier, a8 as isAgentModelId, a9 as isHeroUIAgentAttachmentContentType, ab as resolveAgentModelId, ad as resolveHeroUIAgentAttachmentContentType } from './types-BdAn3HPv.js';
-export { H as HEROUI_AGENT_API_BASE_URL, a as HEROUI_AGENT_SDK_VERSION } from './version-CIfRqjWe.js';
+import { T as HeroUIAgentProps, i as AgentController } from './types-ZXWEIhzk.js';
+export { A as AgentApiOverrides, a as AgentAppearance, b as AgentAttachmentContentType, c as AgentAuthToken, d as AgentCapabilities, e as AgentColorScheme, f as AgentComponentExportFormat, g as AgentComposerOptions, h as AgentContext, j as AgentDataSource, k as AgentDataSourceFormat, l as AgentDesignTheme, m as AgentError, n as AgentFeedbackReason, o as AgentLauncherOptions, p as AgentLauncherPosition, q as AgentMarkdownAnimation, r as AgentMarkdownAnimationOptions, s as AgentMarkdownCaret, t as AgentMarkdownOptions, u as AgentMessageAction, v as AgentModelId, w as AgentPanelOptions, x as AgentPermissionMode, y as AgentPermissionOptions, z as AgentRadius, B as AgentResponseFeedback, C as AgentSharedContext, D as AgentShouldCloseOnInteractOutside, E as AgentStartScreenOptions, F as AgentStatus, G as AgentSurfaceVariant, H as AgentThemeColor, I as AgentThemeColors, J as AgentThemeOptions, K as AgentTypography, L as AgentViewMode, M as ClientTool, N as ClientToolExecutionContext, O as ClientToolIcon, P as ClientToolStatus, Q as DEFAULT_MARKDOWN_ANIMATION, R as GetAuthToken, S as GetAuthTokenContext, U as UploadAgentDataSourceInput, V as createToolHelper } from './types-ZXWEIhzk.js';
+export { H as HEROUI_AGENT_API_BASE_URL, a as HEROUI_AGENT_SDK_VERSION } from './version-0m_IH9PW.js';
 import 'react';
 
 /** Imperative controls for the hosted iframe Agent. */

package/dist/index.js

@@ -1 +1 @@
-import{a as d,b as e,c as f,d as g,e as h,f as i,g as j,h as k,i as l,j as m}from"./chunk-PX3X4VP2.js";import"./chunk-6O4WPQKO.js";import{a as n,b as o,c as p,d as q,e as r,f as s,g as t,h as u,i as v,j as w}from"./chunk-7OTMWVOC.js";import{a as b,b as c}from"./chunk-KGJ6UDTY.js";import{a}from"./chunk-SWO2ABN5.js";export{m as AGENT_DESIGN_THEMES,f as AGENT_MODEL_IDS,j as AGENT_MODEL_OPTIONS,i as DEFAULT_AGENT_PICKER_MODEL_ID,n as DEFAULT_MARKDOWN_ANIMATION,c as HEROUI_AGENT_API_BASE_URL,s as HEROUI_AGENT_ATTACHMENT_ACCEPT,r as HEROUI_AGENT_ATTACHMENT_CONTENT_TYPES,t as HEROUI_AGENT_ATTACHMENT_CONTENT_TYPE_BY_EXTENSION,q as HEROUI_AGENT_ATTACHMENT_EXTENSION_BY_CONTENT_TYPE,p as HEROUI_AGENT_ATTACHMENT_MAX_BYTES,o as HEROUI_AGENT_MAX_ATTACHMENTS,b as HEROUI_AGENT_SDK_VERSION,u as HEROUI_AGENT_TEXT_ATTACHMENT_CONTENT_TYPES,e as HeroUIAgent,g as LEGACY_AGENT_MODEL_IDS,a as createToolHelper,l as getAgentModelTier,k as isAgentModelId,v as isHeroUIAgentAttachmentContentType,h as resolveAgentModelId,w as resolveHeroUIAgentAttachmentContentType,d as useAgent};
+import{a as d,b as e}from"./chunk-MVHWCBZK.js";import"./chunk-7NL3SCZA.js";import{a as f}from"./chunk-AR424OVX.js";import{a as b,b as c}from"./chunk-MPJ6AAXH.js";import{a}from"./chunk-YPHOJDYK.js";export{f as DEFAULT_MARKDOWN_ANIMATION,c as HEROUI_AGENT_API_BASE_URL,b as HEROUI_AGENT_SDK_VERSION,e as HeroUIAgent,a as createToolHelper,d as useAgent};

package/dist/internal/host.d.ts

@@ -1,43 +1,7 @@
-import { R as ClientToolIcon, l as AgentController, a3 as HeroUIAgentProps, P as ClientTool, V as GetAuthToken } from '../types-BdAn3HPv.js';
-export { aa as parseClientToolArgs, ac as resolveDirectToolAction } from '../types-BdAn3HPv.js';
+import { O as ClientToolIcon, U as UploadAgentDataSourceInput, B as AgentResponseFeedback, m as AgentError, F as AgentStatus, i as AgentController, T as HeroUIAgentProps, M as ClientTool, R as GetAuthToken } from '../types-ZXWEIhzk.js';
+export { W as parseClientToolArgs, X as resolveDirectToolAction } from '../types-ZXWEIhzk.js';
 import 'react';
 
-declare const HEROUI_AGENT_HOSTED_ORIGIN: "https://agent.heroui.pro";
-declare const HEROUI_AGENT_HOSTED_STAGING_ORIGIN: "https://staging-agent.heroui.pro";
-declare const HEROUI_AGENT_BRIDGE_MAX_MESSAGE_BYTES: number;
-declare const HEROUI_AGENT_BRIDGE_MAX_PERSISTENCE_BYTES: number;
-type AgentBridgeJsonValue = boolean | null | number | string | AgentBridgeJsonValue[] | {
-    [key: string]: AgentBridgeJsonValue;
-};
-type HostedAgentToolManifest = {
-    description: string;
-    displayName?: string;
-    icon?: ClientToolIcon;
-    iconColor?: string;
-    inputSchema: Record<string, unknown>;
-    name: string;
-    needsApproval?: boolean;
-};
-type AgentBridgeEnvelope = {
-    nonce: string;
-    payload?: unknown;
-    requestId: string;
-    sessionId: string;
-    type: string;
-};
-declare function createAgentBridgeEnvelope(sessionId: string, nonce: string, type: string, payload?: unknown, requestId?: string): AgentBridgeEnvelope;
-declare function parseAgentBridgeEnvelope(value: unknown): AgentBridgeEnvelope | null;
-declare function isAgentBridgeJsonValue(value: unknown, seen?: Set<object>): value is AgentBridgeJsonValue;
-declare function estimateAgentBridgeMessageBytes(value: unknown): number;
-
-type AgentHostController = AgentController & {
-    destroy: () => void;
-    subscribe: (listener: () => void) => () => void;
-    update: (options: HeroUIAgentProps) => void;
-};
-type ClientToolManifestSerializer = (tools: ClientTool[]) => HostedAgentToolManifest[] | Promise<HostedAgentToolManifest[]>;
-declare function mountAgent(initialOptions: HeroUIAgentProps, serializeTools: ClientToolManifestSerializer): AgentHostController;
-
 type HostedFrameBounds = {
     bottom: number;
     left: number;
@@ -78,6 +42,112 @@ type HostPageLayout = {
     } | null;
 };
 
+declare const HEROUI_AGENT_HOSTED_ORIGIN: "https://agent.heroui.pro";
+declare const HEROUI_AGENT_HOSTED_STAGING_ORIGIN: "https://staging-agent.heroui.pro";
+declare const HEROUI_AGENT_BRIDGE_MAX_MESSAGE_BYTES: number;
+declare const HEROUI_AGENT_BRIDGE_MAX_PERSISTENCE_BYTES: number;
+type AgentBridgeJsonValue = boolean | null | number | string | AgentBridgeJsonValue[] | {
+    [key: string]: AgentBridgeJsonValue;
+};
+type HostedAgentToolManifest = {
+    description: string;
+    displayName?: string;
+    icon?: ClientToolIcon;
+    iconColor?: string;
+    inputSchema: Record<string, unknown>;
+    name: string;
+    needsApproval?: boolean;
+};
+type HostedAgentInit = {
+    restoreSession?: boolean;
+    localStorage: Record<string, string>;
+    sessionStorage: Record<string, string>;
+    props: Record<string, unknown>;
+    tools: HostedAgentToolManifest[];
+};
+type AgentPersistenceRequest = {
+    store: "composer-image-drafts" | "message-outboxes";
+    operation: "get" | "put" | "delete" | "deletePrefix";
+    key?: string;
+    prefix?: string;
+    value?: unknown;
+};
+type AgentBridgePayloads = {
+    "host.command": {
+        name: string;
+        payload?: unknown;
+    };
+    "host.init": HostedAgentInit;
+    "host.update": HostedAgentInit;
+    "host.rpc-result": {
+        value: unknown;
+    };
+    "host.rpc-error": {
+        error: string;
+    };
+    "host.upload-data-source": {
+        toolCallId: string;
+        upload: UploadAgentDataSourceInput;
+    };
+    "iframe.ready": undefined;
+    "iframe.reload": undefined;
+    "iframe.auth-request": undefined;
+    "iframe.context-request": undefined;
+    "iframe.feedback": AgentResponseFeedback;
+    "iframe.persistence": AgentPersistenceRequest;
+    "iframe.state": HostedFrameState;
+    "iframe.storage": {
+        operation: "set" | "remove" | "clear";
+        storage: "local" | "session";
+        key?: string;
+        value?: string;
+    };
+    "iframe.rpc-result": {
+        value: unknown;
+    };
+    "iframe.rpc-error": {
+        error: string;
+    };
+    "iframe.error": AgentError;
+    "iframe.status": AgentStatus;
+    "iframe.tool-cancel": {
+        idempotencyKey: string;
+    };
+    "iframe.tool-execute": {
+        args: unknown;
+        conversationId: string;
+        idempotencyKey: string;
+        name: string;
+        toolCallId: string;
+    };
+};
+type AgentBridgeMessageType = keyof AgentBridgePayloads;
+type AgentBridgeEnvelope<T extends AgentBridgeMessageType = AgentBridgeMessageType> = T extends AgentBridgeMessageType ? {
+    nonce: string;
+    payload?: AgentBridgePayloads[T];
+    requestId: string;
+    sessionId: string;
+    type: T;
+} : never;
+declare function createAgentBridgeEnvelope<T extends AgentBridgeMessageType>(sessionId: string, nonce: string, type: T, payload?: AgentBridgePayloads[T], requestId?: string): AgentBridgeEnvelope<T>;
+declare function parseAgentBridgeEnvelope(value: unknown): AgentBridgeEnvelope | null;
+declare function isAgentBridgeJsonValue(value: unknown, seen?: Set<object>): value is AgentBridgeJsonValue;
+declare function estimateAgentBridgeMessageBytes(value: unknown): number;
+
+/** Bounds even callbacks that do not cooperate with cancellation. */
+declare function abortable<T>(signal: AbortSignal, work: () => Promise<T>): Promise<T>;
+declare function withDeadline<T>(milliseconds: number, work: (signal: AbortSignal) => Promise<T>, parent?: AbortSignal): Promise<T>;
+
+declare function createAgentError(cause: unknown, phase?: AgentStatus): AgentError;
+
+type AgentHostController = AgentController & {
+    destroy: () => void;
+    subscribe: (listener: () => void) => () => void;
+    update: (options: HeroUIAgentProps) => void;
+};
+type ClientToolManifestSerializer = (tools: ClientTool[]) => HostedAgentToolManifest[] | Promise<HostedAgentToolManifest[]>;
+declare function mountAgent(initialOptions: HeroUIAgentProps, serializeTools: ClientToolManifestSerializer): AgentHostController;
+
 /**
  * Requests a short-lived HeroUI Agent credential through the host
  * application's server callback. Refresh and request de-duplication are
@@ -90,6 +160,7 @@ declare class EmbedSessionManager {
     private failure;
     private generation;
     private pending;
+    private controller;
     constructor(agentId: string, getAuthToken: GetAuthToken);
     clear(): void;
     /**
@@ -105,4 +176,4 @@ declare class EmbedSessionManager {
     private refresh;
 }
 
-export { type AgentBridgeEnvelope, type AgentBridgeJsonValue, type AgentHostController, type ClientToolManifestSerializer, EmbedSessionManager, HEROUI_AGENT_BRIDGE_MAX_MESSAGE_BYTES, HEROUI_AGENT_BRIDGE_MAX_PERSISTENCE_BYTES, HEROUI_AGENT_HOSTED_ORIGIN, HEROUI_AGENT_HOSTED_STAGING_ORIGIN, type HostPageLayout, type HostedAgentToolManifest, type HostedFrameState, createAgentBridgeEnvelope, estimateAgentBridgeMessageBytes, isAgentBridgeJsonValue, mountAgent, parseAgentBridgeEnvelope };
+export { type AgentBridgeEnvelope, type AgentBridgeJsonValue, type AgentBridgeMessageType, type AgentBridgePayloads, type AgentHostController, type AgentPersistenceRequest, type ClientToolManifestSerializer, EmbedSessionManager, HEROUI_AGENT_BRIDGE_MAX_MESSAGE_BYTES, HEROUI_AGENT_BRIDGE_MAX_PERSISTENCE_BYTES, HEROUI_AGENT_HOSTED_ORIGIN, HEROUI_AGENT_HOSTED_STAGING_ORIGIN, type HostPageLayout, type HostedAgentInit, type HostedAgentToolManifest, type HostedFrameState, abortable, createAgentBridgeEnvelope, createAgentError, estimateAgentBridgeMessageBytes, isAgentBridgeJsonValue, mountAgent, parseAgentBridgeEnvelope, withDeadline };

package/dist/internal/host.js

@@ -1 +1 @@
-import{a as t,b as r}from"../chunk-6O4WPQKO.js";import"../chunk-KGJ6UDTY.js";import{c as o,d as e,e as s,f as a,g as l,h as n,i as m,j as p,k as i,l as f}from"../chunk-SWO2ABN5.js";export{t as EmbedSessionManager,l as HEROUI_AGENT_BRIDGE_MAX_MESSAGE_BYTES,n as HEROUI_AGENT_BRIDGE_MAX_PERSISTENCE_BYTES,s as HEROUI_AGENT_HOSTED_ORIGIN,a as HEROUI_AGENT_HOSTED_STAGING_ORIGIN,m as createAgentBridgeEnvelope,f as estimateAgentBridgeMessageBytes,i as isAgentBridgeJsonValue,r as mountAgent,p as parseAgentBridgeEnvelope,o as parseClientToolArgs,e as resolveDirectToolAction};
+import{a as r,b as t,c as a,d as l,e as n}from"../chunk-7NL3SCZA.js";import"../chunk-MPJ6AAXH.js";import{c as o,d as e,e as m,f as p,g as s,h as i,i as f,j as x,k as g,l as A}from"../chunk-YPHOJDYK.js";export{l as EmbedSessionManager,s as HEROUI_AGENT_BRIDGE_MAX_MESSAGE_BYTES,i as HEROUI_AGENT_BRIDGE_MAX_PERSISTENCE_BYTES,m as HEROUI_AGENT_HOSTED_ORIGIN,p as HEROUI_AGENT_HOSTED_STAGING_ORIGIN,r as abortable,f as createAgentBridgeEnvelope,a as createAgentError,A as estimateAgentBridgeMessageBytes,g as isAgentBridgeJsonValue,n as mountAgent,x as parseAgentBridgeEnvelope,o as parseClientToolArgs,e as resolveDirectToolAction,t as withDeadline};

package/dist/internal/shared.d.ts

@@ -1,7 +1,7 @@
-import { P as ClientTool } from '../types-BdAn3HPv.js';
-export { U as DEFAULT_MARKDOWN_ANIMATION, X as HEROUI_AGENT_ATTACHMENT_ACCEPT, Y as HEROUI_AGENT_ATTACHMENT_CONTENT_TYPES, a9 as isHeroUIAgentAttachmentContentType } from '../types-BdAn3HPv.js';
-export { H as HEROUI_AGENT_API_BASE_URL, a as HEROUI_AGENT_SDK_VERSION } from '../version-CIfRqjWe.js';
+export { H as HEROUI_AGENT_API_BASE_URL, a as HEROUI_AGENT_SDK_VERSION } from '../version-0m_IH9PW.js';
 import { z } from 'zod';
+import { M as ClientTool } from '../types-ZXWEIhzk.js';
+export { Q as DEFAULT_MARKDOWN_ANIMATION } from '../types-ZXWEIhzk.js';
 import 'react';
 
 declare const agentIdentityIdSchema: z.ZodString;
@@ -41,7 +41,7 @@ type AgentAuthProfile = z.infer<typeof agentAuthProfileSchema>;
 type AgentAuthToken = z.infer<typeof agentAuthTokenSchema>;
 type CreateAgentAuthTokenRequest = z.infer<typeof createAgentAuthTokenRequestSchema>;
 
-declare const RESERVED_AGENT_TOOL_NAMES: readonly ["callMcpTool", "composeUI", "executeSandbox", "generateFile", "getComponentSchema", "renderComponent", "searchKnowledge", "searchMcpTools", "searchWeb"];
+declare const RESERVED_AGENT_TOOL_NAMES: readonly ["readConversationHistory", "callMcpTool", "composeUI", "executeSandbox", "generateFile", "getComponentSchema", "renderComponent", "searchKnowledge", "searchMcpTools", "searchWeb"];
 declare const RESERVED_AGENT_TOOL_PREFIX = "mcp_";
 declare const MAX_CLIENT_TOOLS = 20;
 declare const MAX_CLIENT_TOOLS_BYTES: number;

package/dist/internal/shared.js

@@ -1 +1 @@
-import{a as u,e as E,f as l,i as _}from"../chunk-7OTMWVOC.js";import{a as r,b as a}from"../chunk-KGJ6UDTY.js";import{a as A,b as m,c as p,d as T,e as s,f as c,g as h}from"../chunk-PKCBDTYR.js";import"../chunk-SWO2ABN5.js";import{z as e}from"zod";var g=new Set(["[object object]","0","anonymous","distinct_id","distinctid","email","false","guest","id","nan","none","not_authenticated","null","true","undefined"]),t=e.string().trim().min(1).max(200).refine(i=>!g.has(i.toLowerCase()),{message:"Identity id is reserved"}),n=e.discriminatedUnion("type",[e.object({id:t,type:e.literal("anonymous")}),e.object({id:t,type:e.literal("user")})]),o=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()}),S=e.object({anonymousId:t.optional(),identity:n,profile:o.optional()}),f=e.object({expiresAt:e.number().int().positive(),token:e.string().trim().min(1)});export{u as DEFAULT_MARKDOWN_ANIMATION,a as HEROUI_AGENT_API_BASE_URL,l as HEROUI_AGENT_ATTACHMENT_ACCEPT,E as HEROUI_AGENT_ATTACHMENT_CONTENT_TYPES,r as HEROUI_AGENT_SDK_VERSION,p as MAX_CLIENT_TOOLS,T as MAX_CLIENT_TOOLS_BYTES,A as RESERVED_AGENT_TOOL_NAMES,m as RESERVED_AGENT_TOOL_PREFIX,n as agentAuthIdentitySchema,o as agentAuthProfileSchema,f as agentAuthTokenSchema,t as agentIdentityIdSchema,s as clientToolManifestEntrySchema,c as clientToolsSchema,S as createAgentAuthTokenRequestSchema,_ as isHeroUIAgentAttachmentContentType,h as serializeClientTools};
+import{a as l}from"../chunk-AR424OVX.js";import{a,b as r}from"../chunk-MPJ6AAXH.js";import{a as m,b as A,c as p,d as s,e as c,f as h,g as u}from"../chunk-BDMHEOR3.js";import"../chunk-YPHOJDYK.js";import{z as e}from"zod";var g=new Set(["[object object]","0","anonymous","distinct_id","distinctid","email","false","guest","id","nan","none","not_authenticated","null","true","undefined"]),t=e.string().trim().min(1).max(200).refine(i=>!g.has(i.toLowerCase()),{message:"Identity id is reserved"}),n=e.discriminatedUnion("type",[e.object({id:t,type:e.literal("anonymous")}),e.object({id:t,type:e.literal("user")})]),o=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()}),T=e.object({anonymousId:t.optional(),identity:n,profile:o.optional()}),S=e.object({expiresAt:e.number().int().positive(),token:e.string().trim().min(1)});export{l as DEFAULT_MARKDOWN_ANIMATION,r as HEROUI_AGENT_API_BASE_URL,a as HEROUI_AGENT_SDK_VERSION,p as MAX_CLIENT_TOOLS,s as MAX_CLIENT_TOOLS_BYTES,m as RESERVED_AGENT_TOOL_NAMES,A as RESERVED_AGENT_TOOL_PREFIX,n as agentAuthIdentitySchema,o as agentAuthProfileSchema,S as agentAuthTokenSchema,t as agentIdentityIdSchema,c as clientToolManifestEntrySchema,h as clientToolsSchema,T as createAgentAuthTokenRequestSchema,u as serializeClientTools};

package/dist/next.d.ts

@@ -1,4 +1,4 @@
-export { A as AGENT_DESIGN_THEMES, a as AGENT_MODEL_IDS, b as AGENT_MODEL_OPTIONS, c as AgentApiOverrides, d as AgentAppearance, e as AgentAttachmentContentType, f as AgentAuthToken, g as AgentCapabilities, h as AgentColorScheme, i as AgentComponentExportFormat, j as AgentComposerOptions, k as AgentContext, l as AgentController, m as AgentDataSource, n as AgentDataSourceFormat, o as AgentDesignTheme, p as AgentFeedbackReason, q as AgentLauncherOptions, r as AgentLauncherPosition, s as AgentMarkdownAnimation, t as AgentMarkdownAnimationOptions, u as AgentMarkdownCaret, v as AgentMarkdownOptions, w as AgentMessageAction, x as AgentModelId, y as AgentModelOption, z as AgentModelTier, B as AgentPanelOptions, C as AgentPermissionMode, D as AgentPermissionOptions, E as AgentRadius, F as AgentResponseFeedback, G as AgentSharedContext, H as AgentShouldCloseOnInteractOutside, I as AgentStartScreenOptions, J as AgentSurfaceVariant, K as AgentThemeColor, L as AgentThemeColors, M as AgentThemeOptions, N as AgentTypography, O as AgentViewMode, P as ClientTool, Q as ClientToolExecutionContext, R as ClientToolIcon, S as ClientToolStatus, T as DEFAULT_AGENT_PICKER_MODEL_ID, U as DEFAULT_MARKDOWN_ANIMATION, V as GetAuthToken, W as GetAuthTokenContext, X as HEROUI_AGENT_ATTACHMENT_ACCEPT, Y as HEROUI_AGENT_ATTACHMENT_CONTENT_TYPES, Z as HEROUI_AGENT_ATTACHMENT_CONTENT_TYPE_BY_EXTENSION, _ as HEROUI_AGENT_ATTACHMENT_EXTENSION_BY_CONTENT_TYPE, $ as HEROUI_AGENT_ATTACHMENT_MAX_BYTES, a0 as HEROUI_AGENT_MAX_ATTACHMENTS, a1 as HEROUI_AGENT_TEXT_ATTACHMENT_CONTENT_TYPES, a2 as HeroUIAgentAttachmentContentType, a3 as HeroUIAgentProps, a4 as LEGACY_AGENT_MODEL_IDS, a5 as UploadAgentDataSourceInput, a6 as createToolHelper, a7 as getAgentModelTier, a8 as isAgentModelId, a9 as isHeroUIAgentAttachmentContentType, ab as resolveAgentModelId, ad as resolveHeroUIAgentAttachmentContentType } from './types-BdAn3HPv.js';
+export { A as AgentApiOverrides, a as AgentAppearance, b as AgentAttachmentContentType, c as AgentAuthToken, d as AgentCapabilities, e as AgentColorScheme, f as AgentComponentExportFormat, g as AgentComposerOptions, h as AgentContext, i as AgentController, j as AgentDataSource, k as AgentDataSourceFormat, l as AgentDesignTheme, m as AgentError, n as AgentFeedbackReason, o as AgentLauncherOptions, p as AgentLauncherPosition, q as AgentMarkdownAnimation, r as AgentMarkdownAnimationOptions, s as AgentMarkdownCaret, t as AgentMarkdownOptions, u as AgentMessageAction, v as AgentModelId, w as AgentPanelOptions, x as AgentPermissionMode, y as AgentPermissionOptions, z as AgentRadius, B as AgentResponseFeedback, C as AgentSharedContext, D as AgentShouldCloseOnInteractOutside, E as AgentStartScreenOptions, F as AgentStatus, G as AgentSurfaceVariant, H as AgentThemeColor, I as AgentThemeColors, J as AgentThemeOptions, K as AgentTypography, L as AgentViewMode, M as ClientTool, N as ClientToolExecutionContext, O as ClientToolIcon, P as ClientToolStatus, Q as DEFAULT_MARKDOWN_ANIMATION, R as GetAuthToken, S as GetAuthTokenContext, T as HeroUIAgentProps, U as UploadAgentDataSourceInput, V as createToolHelper } from './types-ZXWEIhzk.js';
 export { HeroUIAgent, useAgent } from './index.js';
-export { H as HEROUI_AGENT_API_BASE_URL, a as HEROUI_AGENT_SDK_VERSION } from './version-CIfRqjWe.js';
+export { H as HEROUI_AGENT_API_BASE_URL, a as HEROUI_AGENT_SDK_VERSION } from './version-0m_IH9PW.js';
 import 'react';

package/dist/next.js

@@ -1 +1 @@
-import{a as f,b as m,c as p,d as t,e as x,f as a,g as b,h as c,i as d,j as g}from"./chunk-PX3X4VP2.js";import"./chunk-6O4WPQKO.js";import{a as h,b as i,c as j,d as k,e as l,f as n,g as q,h as s,i as u,j as v}from"./chunk-7OTMWVOC.js";import{a as r,b as e}from"./chunk-KGJ6UDTY.js";import{a as o}from"./chunk-SWO2ABN5.js";export{g as AGENT_DESIGN_THEMES,p as AGENT_MODEL_IDS,b as AGENT_MODEL_OPTIONS,a as DEFAULT_AGENT_PICKER_MODEL_ID,h as DEFAULT_MARKDOWN_ANIMATION,e as HEROUI_AGENT_API_BASE_URL,n as HEROUI_AGENT_ATTACHMENT_ACCEPT,l as HEROUI_AGENT_ATTACHMENT_CONTENT_TYPES,q as HEROUI_AGENT_ATTACHMENT_CONTENT_TYPE_BY_EXTENSION,k as HEROUI_AGENT_ATTACHMENT_EXTENSION_BY_CONTENT_TYPE,j as HEROUI_AGENT_ATTACHMENT_MAX_BYTES,i as HEROUI_AGENT_MAX_ATTACHMENTS,r as HEROUI_AGENT_SDK_VERSION,s as HEROUI_AGENT_TEXT_ATTACHMENT_CONTENT_TYPES,m as HeroUIAgent,t as LEGACY_AGENT_MODEL_IDS,o as createToolHelper,d as getAgentModelTier,c as isAgentModelId,u as isHeroUIAgentAttachmentContentType,x as resolveAgentModelId,v as resolveHeroUIAgentAttachmentContentType,f as useAgent};
+import{a as f,b as m}from"./chunk-MVHWCBZK.js";import"./chunk-7NL3SCZA.js";import{a as p}from"./chunk-AR424OVX.js";import{a as r,b as e}from"./chunk-MPJ6AAXH.js";import{a as o}from"./chunk-YPHOJDYK.js";export{p as DEFAULT_MARKDOWN_ANIMATION,e as HEROUI_AGENT_API_BASE_URL,r as HEROUI_AGENT_SDK_VERSION,m as HeroUIAgent,o as createToolHelper,f as useAgent};

package/dist/{types-BdAn3HPv.d.ts → types-ZXWEIhzk.d.ts}

@@ -35,6 +35,7 @@ type UploadAgentDataSourceInput = Readonly<{
  * return the original result instead of applying the side effect twice.
  */
 type ClientToolExecutionContext = Readonly<{
+    signal: AbortSignal;
     conversationId: string;
     idempotencyKey: string;
     toolCallId: string;
@@ -80,137 +81,6 @@ declare function parseClientToolArgs(tool: ClientTool, input: unknown): unknown;
  */
 declare function resolveDirectToolAction(tools: ReadonlyMap<string, ClientTool>, toolName: string): ClientTool | null;
 
-/** Maximum number of files accepted on one HeroUI Agent message. */
-declare const HEROUI_AGENT_MAX_ATTACHMENTS = 5;
-/** Maximum stored size for one HeroUI Agent attachment (10 MiB). */
-declare const HEROUI_AGENT_ATTACHMENT_MAX_BYTES: number;
-/**
- * File types that the hosted model pipeline can process consistently.
- *
- * SVG is intentionally excluded because it can carry active content. Hosted
- * document parsing handles the remaining office and publishing formats.
- */
-declare const HEROUI_AGENT_ATTACHMENT_EXTENSION_BY_CONTENT_TYPE: {
-    readonly "application/epub+zip": "epub";
-    readonly "application/json": "json";
-    readonly "application/msword": "doc";
-    readonly "application/pdf": "pdf";
-    readonly "application/rtf": "rtf";
-    readonly "application/vnd.ms-excel": "xls";
-    readonly "application/vnd.ms-excel.sheet.binary.macroenabled.12": "xlsb";
-    readonly "application/vnd.ms-excel.sheet.macroenabled.12": "xlsm";
-    readonly "application/vnd.ms-powerpoint": "ppt";
-    readonly "application/vnd.ms-powerpoint.presentation.macroenabled.12": "pptm";
-    readonly "application/vnd.ms-word.document.macroenabled.12": "docm";
-    readonly "application/vnd.oasis.opendocument.presentation": "odp";
-    readonly "application/vnd.oasis.opendocument.spreadsheet": "ods";
-    readonly "application/vnd.oasis.opendocument.text": "odt";
-    readonly "application/vnd.openxmlformats-officedocument.presentationml.presentation": "pptx";
-    readonly "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "xlsx";
-    readonly "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx";
-    readonly "image/gif": "gif";
-    readonly "image/jpeg": "jpg";
-    readonly "image/png": "png";
-    readonly "image/webp": "webp";
-    readonly "text/csv": "csv";
-    readonly "text/html": "html";
-    readonly "text/markdown": "md";
-    readonly "text/plain": "txt";
-    readonly "text/rtf": "rtf";
-    readonly "text/tab-separated-values": "tsv";
-};
-type HeroUIAgentAttachmentContentType = keyof typeof HEROUI_AGENT_ATTACHMENT_EXTENSION_BY_CONTENT_TYPE;
-declare const HEROUI_AGENT_ATTACHMENT_CONTENT_TYPES: readonly ("application/json" | "text/csv" | "text/tab-separated-values" | "application/epub+zip" | "application/msword" | "application/pdf" | "application/rtf" | "application/vnd.ms-excel" | "application/vnd.ms-excel.sheet.binary.macroenabled.12" | "application/vnd.ms-excel.sheet.macroenabled.12" | "application/vnd.ms-powerpoint" | "application/vnd.ms-powerpoint.presentation.macroenabled.12" | "application/vnd.ms-word.document.macroenabled.12" | "application/vnd.oasis.opendocument.presentation" | "application/vnd.oasis.opendocument.spreadsheet" | "application/vnd.oasis.opendocument.text" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "image/gif" | "image/jpeg" | "image/png" | "image/webp" | "text/html" | "text/markdown" | "text/plain" | "text/rtf")[];
-declare const HEROUI_AGENT_ATTACHMENT_ACCEPT: string;
-declare const HEROUI_AGENT_ATTACHMENT_CONTENT_TYPE_BY_EXTENSION: Readonly<Record<string, "application/json" | "text/csv" | "text/tab-separated-values" | "application/epub+zip" | "application/msword" | "application/pdf" | "application/rtf" | "application/vnd.ms-excel" | "application/vnd.ms-excel.sheet.binary.macroenabled.12" | "application/vnd.ms-excel.sheet.macroenabled.12" | "application/vnd.ms-powerpoint" | "application/vnd.ms-powerpoint.presentation.macroenabled.12" | "application/vnd.ms-word.document.macroenabled.12" | "application/vnd.oasis.opendocument.presentation" | "application/vnd.oasis.opendocument.spreadsheet" | "application/vnd.oasis.opendocument.text" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "image/gif" | "image/jpeg" | "image/png" | "image/webp" | "text/html" | "text/markdown" | "text/plain" | "text/rtf">>;
-declare const HEROUI_AGENT_TEXT_ATTACHMENT_CONTENT_TYPES: ReadonlySet<string>;
-declare function isHeroUIAgentAttachmentContentType(value: string): value is HeroUIAgentAttachmentContentType;
-/** Browsers sometimes omit Office MIME types; fall back to the file extension. */
-declare function resolveHeroUIAgentAttachmentContentType(contentType: string, filename: string): HeroUIAgentAttachmentContentType | null;
-
-/**
- * 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
- * panel shell's first-paint graph. The matching schema lives in
- * `./models.schema`, which only server and contract consumers need.
- */
-/** Model ids the hosted agent accepts from the browser picker. */
-declare const AGENT_MODEL_IDS: readonly ["moonshotai/Kimi-K3", "openai/gpt-5.6-luna", "openai/gpt-5.6-terra", "openai/gpt-5.6-sol", "google/gemini-3.7-flash", "anthropic/claude-sonnet-5", "anthropic/claude-opus-4.8"];
-type AgentModelId = (typeof AGENT_MODEL_IDS)[number];
-/**
- * Retired ids mapped to their replacement. Model ids are a public part of the
- * embed API — a customer pins one in their own code and projects store one as
- * their default — so a retired id keeps resolving instead of failing the
- * session with an "Invalid agent model" error.
- */
-declare const LEGACY_AGENT_MODEL_IDS: Record<string, AgentModelId>;
-/** Resolves a possibly-retired model id to the id the runtime should use. */
-declare function resolveAgentModelId(value: string): string;
-type AgentModelTier = "codegen" | "complex" | "light";
-type AgentModelOption = {
-    description: string;
-    id: AgentModelId;
-    label: string;
-    provider: "Anthropic" | "Google" | "Moonshot AI" | "OpenAI";
-    tier: AgentModelTier;
-};
-/**
- * Recommended default selected when the optional picker first opens. Gemini 3.7 Flash
- * matches the hosted runtime's baked-in default (`DEFAULT_CHAT_MODEL_IDS.herouiAgent`),
- * so what users see in the picker is what actually runs by default.
- */
-declare const DEFAULT_AGENT_PICKER_MODEL_ID = "google/gemini-3.7-flash";
-/**
- * Small, tool-capable model catalog for HeroUI Agent. These ids are the
- * server-side allowlist as well as the browser picker source of truth.
- */
-declare const AGENT_MODEL_OPTIONS: readonly [{
-    readonly description: "Flagship model for coding, reasoning, and knowledge work";
-    readonly id: "moonshotai/Kimi-K3";
-    readonly label: "Kimi K3";
-    readonly provider: "Moonshot AI";
-    readonly tier: "light";
-}, {
-    readonly description: "Fast answers and lightweight agent workflows";
-    readonly id: "openai/gpt-5.6-luna";
-    readonly label: "GPT-5.6 Luna";
-    readonly provider: "OpenAI";
-    readonly tier: "light";
-}, {
-    readonly description: "Balanced reasoning for everyday agent tasks";
-    readonly id: "openai/gpt-5.6-terra";
-    readonly label: "GPT-5.6 Terra";
-    readonly provider: "OpenAI";
-    readonly tier: "codegen";
-}, {
-    readonly description: "Deep reasoning for complex, multi-step analysis";
-    readonly id: "openai/gpt-5.6-sol";
-    readonly label: "GPT-5.6 Sol";
-    readonly provider: "OpenAI";
-    readonly tier: "complex";
-}, {
-    readonly description: "Fast multimodal analysis with a large context window";
-    readonly id: "google/gemini-3.7-flash";
-    readonly label: "Gemini 3.7 Flash";
-    readonly provider: "Google";
-    readonly tier: "light";
-}, {
-    readonly description: "Strong agentic reasoning and polished UI decisions";
-    readonly id: "anthropic/claude-sonnet-5";
-    readonly label: "Claude Sonnet 5";
-    readonly provider: "Anthropic";
-    readonly tier: "codegen";
-}, {
-    readonly description: "Highest-capability Claude for difficult research and analysis";
-    readonly id: "anthropic/claude-opus-4.8";
-    readonly label: "Claude Opus 4.8";
-    readonly provider: "Anthropic";
-    readonly tier: "complex";
-}];
-declare function isAgentModelId(value: unknown): value is AgentModelId;
-/** Unknown/env-overridden models keep the hosted agent's historical light tier. */
-declare function getAgentModelTier(modelId?: string): AgentModelTier;
-
 /**
  * Light/dark color scheme selection for the embed. `"system"` follows the
  * OS preference and updates live when it changes.
@@ -258,13 +128,14 @@ type AgentTypography = {
     fontFamily?: string;
 };
 /**
- * HeroUI Pro theme variant applied to the agent surface.
+ * HeroUI Pro theme variant applied to the agent surface, e.g. `"base"`,
+ * `"brutalism"`, `"glass"`, or `"mouve"`.
  *
- * Hosted Agent deployments include all supported variants; the selected one
- * is activated inside the iframe.
+ * Hosted Agent deployments own the list of supported variants and activate the
+ * selected one inside the iframe; unknown values fall back to `"base"`, so new
+ * variants never require an SDK update.
  */
-type AgentDesignTheme = "base" | "brutalism" | "glass" | "mouve";
-declare const AGENT_DESIGN_THEMES: readonly AgentDesignTheme[];
+type AgentDesignTheme = string;
 /**
  * Intentionally small theme surface: one color scheme, one Pro variant, four
  * radius presets, seven color tokens, and basic typography. No named themes,
@@ -286,8 +157,20 @@ type AgentThemeOptions = {
 
 type AgentComponentExportFormat = "csv" | "png" | "svg";
 type AgentPermissionMode = "ask" | "auto" | "full";
-/** MIME type accepted by the hosted HeroUI Agent attachment pipeline. */
-type AgentAttachmentContentType = HeroUIAgentAttachmentContentType;
+/**
+ * MIME type accepted by the hosted HeroUI Agent attachment pipeline, e.g.
+ * `"application/pdf"` or `"text/csv"`. The hosted Agent owns the supported
+ * list and ignores unknown types, so new formats never require an SDK update.
+ * See https://heroui.pro/docs/agents/api-reference/configuration.
+ */
+type AgentAttachmentContentType = string;
+/**
+ * Model id from the hosted HeroUI Agent catalog, e.g. `"google/gemini-3.8-flash"`.
+ * The hosted Agent owns the catalog: retired ids resolve to their replacement
+ * and unknown ids fall back to the default model, so new models never require
+ * an SDK update. See https://heroui.pro/docs/agents/api-reference/models.
+ */
+type AgentModelId = string;
 type AgentMessageAction = "copy" | "feedback" | "retry";
 type AgentFeedbackReason = "did_not_follow_instructions" | "incomplete" | "incorrect" | "not_relevant" | "other" | "unclear";
 type AgentResponseFeedback = {
@@ -543,11 +426,22 @@ type AgentAuthToken = {
 };
 /** Context supplied whenever the SDK needs a fresh browser credential. */
 type GetAuthTokenContext = {
+    signal: AbortSignal;
     anonymousId: string;
     agentId: string;
 };
 type GetAuthToken = (context: GetAuthTokenContext) => Promise<AgentAuthToken>;
+type AgentStatus = "loading" | "authenticating" | "connecting" | "ready" | "generating" | "finishing" | "reconnecting" | "failed";
+type AgentError = {
+    category: "authentication" | "connection" | "configuration" | "chunk" | "rate_limit" | "credits" | "deleted" | "approval" | "unknown";
+    diagnosticId: string;
+    message: string;
+    phase: AgentStatus;
+    retryable: boolean;
+};
 type HeroUIAgentProps = {
+    onError?: (error: AgentError) => void;
+    onStatusChange?: (status: AgentStatus) => void;
     /** Internal — for HeroUI platform development only. */
     _api?: AgentApiOverrides;
     appearance?: AgentAppearance;
@@ -562,7 +456,7 @@ type HeroUIAgentProps = {
     context?: AgentSharedContext;
     /**
      * Fetches a short-lived browser credential from the host application's
-     * server. Never expose a HeroUI Agent API key in browser code.
+     * server. Never expose a workspace API key in browser code.
      */
     getAuthToken: GetAuthToken;
     /** Streaming Markdown animation and caret preferences. */
@@ -664,4 +558,4 @@ type AgentController = {
     toggle: () => void;
 };
 
-export { HEROUI_AGENT_ATTACHMENT_MAX_BYTES as $, AGENT_DESIGN_THEMES as A, type AgentPanelOptions as B, type AgentPermissionMode as C, type AgentPermissionOptions as D, type AgentRadius as E, type AgentResponseFeedback as F, type AgentSharedContext as G, type AgentShouldCloseOnInteractOutside as H, type AgentStartScreenOptions as I, type AgentSurfaceVariant as J, type AgentThemeColor as K, type AgentThemeColors as L, type AgentThemeOptions as M, type AgentTypography as N, type AgentViewMode as O, type ClientTool as P, type ClientToolExecutionContext as Q, type ClientToolIcon as R, type ClientToolStatus as S, DEFAULT_AGENT_PICKER_MODEL_ID as T, DEFAULT_MARKDOWN_ANIMATION as U, type GetAuthToken as V, type GetAuthTokenContext as W, HEROUI_AGENT_ATTACHMENT_ACCEPT as X, HEROUI_AGENT_ATTACHMENT_CONTENT_TYPES as Y, HEROUI_AGENT_ATTACHMENT_CONTENT_TYPE_BY_EXTENSION as Z, HEROUI_AGENT_ATTACHMENT_EXTENSION_BY_CONTENT_TYPE as _, AGENT_MODEL_IDS as a, HEROUI_AGENT_MAX_ATTACHMENTS as a0, HEROUI_AGENT_TEXT_ATTACHMENT_CONTENT_TYPES as a1, type HeroUIAgentAttachmentContentType as a2, type HeroUIAgentProps as a3, LEGACY_AGENT_MODEL_IDS as a4, type UploadAgentDataSourceInput as a5, createToolHelper as a6, getAgentModelTier as a7, isAgentModelId as a8, isHeroUIAgentAttachmentContentType as a9, parseClientToolArgs as aa, resolveAgentModelId as ab, resolveDirectToolAction as ac, resolveHeroUIAgentAttachmentContentType as ad, AGENT_MODEL_OPTIONS as b, type AgentApiOverrides as c, type AgentAppearance as d, type AgentAttachmentContentType as e, type AgentAuthToken as f, type AgentCapabilities as g, type AgentColorScheme as h, type AgentComponentExportFormat as i, type AgentComposerOptions as j, type AgentContext as k, type AgentController as l, type AgentDataSource as m, type AgentDataSourceFormat as n, type AgentDesignTheme as o, type AgentFeedbackReason as p, type AgentLauncherOptions as q, type AgentLauncherPosition as r, type AgentMarkdownAnimation as s, type AgentMarkdownAnimationOptions as t, type AgentMarkdownCaret as u, type AgentMarkdownOptions as v, type AgentMessageAction as w, type AgentModelId as x, type AgentModelOption as y, type AgentModelTier as z };
+export { type AgentApiOverrides as A, type AgentResponseFeedback as B, type AgentSharedContext as C, type AgentShouldCloseOnInteractOutside as D, type AgentStartScreenOptions as E, type AgentStatus as F, type AgentSurfaceVariant as G, type AgentThemeColor as H, type AgentThemeColors as I, type AgentThemeOptions as J, type AgentTypography as K, type AgentViewMode as L, type ClientTool as M, type ClientToolExecutionContext as N, type ClientToolIcon as O, type ClientToolStatus as P, DEFAULT_MARKDOWN_ANIMATION as Q, type GetAuthToken as R, type GetAuthTokenContext as S, type HeroUIAgentProps as T, type UploadAgentDataSourceInput as U, createToolHelper as V, parseClientToolArgs as W, resolveDirectToolAction as X, type AgentAppearance as a, type AgentAttachmentContentType as b, type AgentAuthToken as c, type AgentCapabilities as d, type AgentColorScheme as e, type AgentComponentExportFormat as f, type AgentComposerOptions as g, type AgentContext as h, type AgentController as i, type AgentDataSource as j, type AgentDataSourceFormat as k, type AgentDesignTheme as l, type AgentError as m, type AgentFeedbackReason as n, type AgentLauncherOptions as o, type AgentLauncherPosition as p, type AgentMarkdownAnimation as q, type AgentMarkdownAnimationOptions as r, type AgentMarkdownCaret as s, type AgentMarkdownOptions as t, type AgentMessageAction as u, type AgentModelId as v, type AgentPanelOptions as w, type AgentPermissionMode as x, type AgentPermissionOptions as y, type AgentRadius as z };

package/dist/{version-CIfRqjWe.d.ts → version-0m_IH9PW.d.ts}

@@ -1,4 +1,4 @@
-declare const HEROUI_AGENT_SDK_VERSION: "1.0.0-beta.5";
+declare const HEROUI_AGENT_SDK_VERSION: "1.0.0-beta.7";
 /** Production Agent API origin used when hosts omit `_api.baseUrl` / `apiBaseUrl`. */
 declare const HEROUI_AGENT_API_BASE_URL: "https://api.heroui.pro";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heroui/agent",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.7",
   "description": "Embed a hosted HeroUI Agent that turns application data into interactive UI.",
   "homepage": "https://heroui.pro/agents",
   "bugs": {

package/dist/chunk-6O4WPQKO.js

@@ -1 +0,0 @@
-import{b as B}from"./chunk-KGJ6UDTY.js";import{c as q,e as G,f as K,i as J,j as V,k as Y}from"./chunk-SWO2ABN5.js";function X(e){return`heroui-agent:anonymous:${e}`}function de(e){return e instanceof Error?e:new Error("Auth token request failed")}var S=class{constructor(t,n){this.agentId=t;this.getAuthToken=n}cached=null;failure=null;generation=0;pending=null;clear(){this.generation+=1,this.cached=null,this.failure=null,this.pending=null}reset(){this.clear();try{localStorage.removeItem(X(this.agentId))}catch{}}async get(){if(this.cached&&this.expiresAt(this.cached)>Date.now()+6e4)return this.cached.token;if(!this.pending&&this.failure&&Date.now()<this.failure.retryAt)throw this.failure.error;let t=this.generation,n=this.pending??this.refresh();this.pending||(this.pending=n);try{let i=await n;return t!==this.generation?this.get():(this.cached=i,this.failure=null,i.token)}catch(i){throw t===this.generation&&(this.failure={error:de(i),retryAt:Date.now()+5e3}),i}finally{this.pending===n&&(this.pending=null)}}async subjectHash(){let t=await this.get(),n=ce(t),i=typeof n.sub=="string"?n.sub:"anonymous",l=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(`${this.agentId}:${i}`));return Array.from(new Uint8Array(l),u=>u.toString(16).padStart(2,"0")).join("").slice(0,24)}anonymousId(){let t=X(this.agentId);try{let n=localStorage.getItem(t);if(n)return n;let i=crypto.randomUUID();return localStorage.setItem(t,i),i}catch{return crypto.randomUUID()}}expiresAt(t){return t.expiresAt}async refresh(){let t=await this.getAuthToken({agentId:this.agentId,anonymousId:this.anonymousId()});if(!t||typeof t.token!="string"||!t.token.trim()||typeof t.expiresAt!="number"||!Number.isFinite(t.expiresAt)||t.expiresAt<=0)throw new Error("Auth token callback returned invalid data");return{expiresAt:t.expiresAt,token:t.token}}};function ce(e){try{let t=e.split(".")[1];if(!t)return{};let n=t.replace(/-/g,"+").replace(/_/g,"/"),i=n.padEnd(Math.ceil(n.length/4)*4,"=");return JSON.parse(atob(i))}catch{return{}}}function Q(e){return{bounds:null,closing:!1,dragging:!1,expanded:e.appearance?.panel?.expanded??!1,mounted:!1,open:!1,overlayOpen:!1,ready:!1,resizing:!1,sidebarWidth:null,viewMode:e.appearance?.viewMode??"floating"}}function y(e,t,n){return{background:"transparent",border:"0",clipPath:ue(e,t,n),colorScheme:"normal",height:"100dvh",inset:"0",position:"fixed",width:"100vw",zIndex:t.appearance?.zIndex??40}}function Z(e){if(!e||typeof e!="object")return null;let t=e;return typeof t.open!="boolean"||typeof t.ready!="boolean"||typeof t.expanded!="boolean"||t.viewMode!=="floating"&&t.viewMode!=="sidebar"?null:{bounds:pe(t.bounds),closing:t.closing===!0,dragging:t.dragging===!0,expanded:t.expanded,mounted:t.mounted!==!1,open:t.open,overlayOpen:t.overlayOpen===!0,ready:t.ready,resizing:t.resizing===!0,sidebarWidth:H(t.sidebarWidth)?t.sidebarWidth:null,viewMode:t.viewMode}}function ee(){let e=document.documentElement,t=document.body;return{active:!1,body:t,original:{bodyLeft:t.style.left,bodyOverflow:t.style.overflow,bodyPosition:t.style.position,bodyRight:t.style.right,bodyTop:t.style.top,bodyWidth:t.style.width,rootMarginRight:e.style.marginRight,rootOverflow:e.style.overflow,rootTransition:e.style.transition},root:e,scrollLock:null}}function x(e,t,n,i){let l=t.open||t.closing;if(!l&&!e.active)return;l&&(e.active=!0);let u=l&&(i||t.viewMode==="sidebar"&&t.expanded);ne(e,u);let a=l&&t.viewMode==="sidebar"&&!t.expanded&&!i?ge(t,n):e.original.rootMarginRight;e.root.style.transition=e.original.rootTransition,e.root.style.marginRight=a,l||(e.active=!1)}function te(e){ne(e,!1),e.root.style.marginRight=e.original.rootMarginRight,e.root.style.transition=e.original.rootTransition,e.active=!1}function ue(e,t,n){let i=e.open||e.closing;if(i&&(n||e.overlayOpen))return"inset(0px)";if(e.bounds)return`inset(${e.bounds.top}px calc(100% - ${e.bounds.right}px) calc(100% - ${e.bounds.bottom}px) ${e.bounds.left}px)`;let l=t.appearance?.launcher,u=l?.position==="bottom-left",p=(l?.offset?.x??24)+60,a=(l?.offset?.y??24)+60;if(!i)return u?`inset(calc(100% - ${a}px) calc(100% - ${p}px) 0px 0px)`:`inset(calc(100% - ${a}px) 0px 0px calc(100% - ${p}px))`;if(e.viewMode==="sidebar")return`inset(0px 0px 0px calc(100% - (${M(t.appearance?.panel?.initialWidth??420)} + 16px)))`;let h=M(t.appearance?.panel?.initialWidth??440),E=`calc(100% - min(calc(${M(t.appearance?.panel?.initialHeight??"max(420px, 56dvh)")} + 32px), 100dvh))`;return u?`inset(${E} calc(100% - min(calc(${h} + 32px), 100vw)) 0px 0px)`:`inset(${E} 0px 0px calc(100% - min(calc(${h} + 32px), 100vw)))`}function pe(e){if(!e||typeof e!="object")return null;let t=e;return!H(t.top)||!H(t.right)||!H(t.bottom)||!H(t.left)||t.right<t.left||t.bottom<t.top?null:{bottom:t.bottom,left:t.left,right:t.right,top:t.top}}function H(e){return typeof e=="number"&&Number.isFinite(e)&&e>=0&&e<=1e5}function ge(e,t){return e.sidebarWidth===null?M(t.appearance?.panel?.initialWidth??420):`${Math.round(e.sidebarWidth)}px`}function M(e){return typeof e=="number"?`${Math.round(e)}px`:e}function ne(e,t){if(t&&!e.scrollLock){e.scrollLock={x:window.scrollX,y:window.scrollY},e.root.style.overflow="hidden",e.body.style.overflow="hidden",e.body.style.position="fixed",e.body.style.top=`${-e.scrollLock.y}px`,e.body.style.left=`${-e.scrollLock.x}px`,e.body.style.right="0",e.body.style.width="100%";return}if(!t&&e.scrollLock){let{x:n,y:i}=e.scrollLock;e.root.style.overflow=e.original.rootOverflow,e.body.style.overflow=e.original.bodyOverflow,e.body.style.position=e.original.bodyPosition,e.body.style.top=e.original.bodyTop,e.body.style.left=e.original.bodyLeft,e.body.style.right=e.original.bodyRight,e.body.style.width=e.original.bodyWidth,e.scrollLock=null;try{window.scrollTo(n,i)}catch{}}}var fe=16*1024,he=64*1024;function Oe(e,t){let n=e;if(!n?.agentId||typeof n.getAuthToken!="function")throw new Error("HeroUIAgent.mount requires agentId and getAuthToken");let i=crypto.randomUUID(),l=crypto.randomUUID(),u=(n._api?.baseUrl??B).replace(/\/$/,""),p=Ie(u,n._api?.embedOrigin),a=document.createElement("iframe"),h=new Map,w=[],E=new Set,b=new Map,k=new Set,v=ee(),P=new S(n.agentId,n.getAuthToken),s=Q(n),W=null,m=!1,A=!1,I=null,U=!1,C=!1,_=new URL("/embed",p);_.searchParams.set("agentId",n.agentId),_.hash=new URLSearchParams({nonce:l,parentOrigin:window.location.origin,sessionId:i}).toString(),a.allow="microphone; clipboard-write",a.referrerPolicy="origin",a.setAttribute("sandbox","allow-downloads allow-forms allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts"),a.src=_.toString(),a.title="HeroUI Agent",Object.assign(a.style,y(s,n,window.innerWidth<640)),document.body.append(a);let g=(o,r,d)=>{C||a.contentWindow?.postMessage(J(i,l,o,r,d),p)},ie=(o,r)=>{let d=crypto.randomUUID();return new Promise((c,f)=>{let F=window.setTimeout(()=>{h.delete(d),f(new Error(`HeroUI Agent iframe request timed out: ${o}`))},3e4);h.set(d,{reject:f,resolve:c,timer:F}),g(o,r,d)})},$=0,N="",z=async(o,r=!1)=>{let d=++$,c=await ye(n,t);if(C||d!==$)return;let f=JSON.stringify({props:c.props,tools:c.tools});!r&&f===N||(N=f,g(o,c))},T=(o,r)=>{if(!s.mounted){w.push({name:o,payload:r}),w.length>32&&w.shift();return}g("host.command",{name:o,payload:r})},O=o=>{m=o,o||(A=!1),T(o?"show":"hide")},se=()=>{if(s.mounted)for(let o of w.splice(0))g("host.command",o)},ae=()=>{A=s.mounted&&m&&!s.closing,s={...s,bounds:null,closing:!1,mounted:!1,open:A,ready:!1},U=!1;for(let o of k)o();Object.assign(a.style,y(s,n,window.innerWidth<640)),x(v,s,n,window.innerWidth<640)},D=o=>{if(o.origin!==p||o.source!==a.contentWindow)return;let r=V(o.data);if(!(!r||r.sessionId!==i||r.nonce!==l)){if(r.type==="iframe.rpc-result"||r.type==="iframe.rpc-error"){we(r,h);return}Ae(E,r.requestId)&&le(r)}},le=async o=>{try{if(o.type==="iframe.ready"){(s.mounted||s.ready)&&ae(),await z("host.init",!0);return}if(o.type==="iframe.state"){let r=Z(o.payload);if(r){let d=s.open||s.closing,c=r;A?r.mounted?(A=!1,r.open||(g("host.command",{name:"show"}),c={...r,bounds:null,closing:!1,open:!0,sidebarWidth:r.sidebarWidth??s.sidebarWidth})):c={...r,bounds:null,closing:!1,open:!0,sidebarWidth:r.sidebarWidth??s.sidebarWidth}:r.open?m=!0:(r.closing||s.open||s.closing)&&(m=!1);let f=c.open||c.closing;f&&!d&&(W=document.activeElement),!f&&d&&W?.focus({preventScroll:!0}),s=c,f&&s.expanded?a.dataset.expanded="true":a.removeAttribute("data-expanded");for(let F of k)F();Object.assign(a.style,y(s,n,window.innerWidth<640)),x(v,s,n,window.innerWidth<640),se(),s.ready&&!U&&(U=!0,n.onReady?.())}return}if(o.type==="iframe.auth-request"){let r=await P.get(),d=await fetch(`${u}/v1/agents/${encodeURIComponent(n.agentId)}/embed-sessions`,{body:JSON.stringify({iframeOrigin:p,sessionId:i}),cache:"no-store",headers:{Authorization:`Bearer ${r}`,"Content-Type":"application/json"},method:"POST"});if(!d.ok)throw new Error("Unable to create HeroUI Agent iframe session");g("host.rpc-result",{value:await d.json()},o.requestId);return}if(o.type==="iframe.context-request"){let r=await n.context?.page?.()??{};re(r,fe,"Agent page context"),g("host.rpc-result",{value:r},o.requestId);return}if(o.type==="iframe.tool-execute"){let r=be(o.payload),d=n.tools?.find(f=>f.name===r.name);if(!d)throw new Error(`Unknown client tool: ${r.name}`);let c=b.get(r.idempotencyKey);c||(c=me(d,r,n,ie),b.set(r.idempotencyKey,c),b.size>2048&&b.delete(b.keys().next().value)),g("host.rpc-result",{value:await c},o.requestId);return}if(o.type==="iframe.feedback"){await n.onFeedback?.(o.payload);return}if(o.type==="iframe.storage"){ve(o.payload);return}if(o.type==="iframe.persistence"){let r=await import("./persistence-YI6JSYCT.js").then(({executeAgentHostPersistence:d})=>d(n.agentId,o.payload));g("host.rpc-result",{value:r},o.requestId)}}catch(r){console.error("HeroUI Agent bridge request failed",r),g("host.rpc-error",{error:r instanceof Error?r.message:"Request failed"},o.requestId)}},j=o=>{o.composedPath().includes(a)||s.open&&s.viewMode==="floating"&&(n.appearance?.shouldCloseOnInteractOutside??!0)&&O(!1)},L=()=>{s={...s,bounds:null},Object.assign(a.style,y(s,n,window.innerWidth<640)),x(v,s,n,window.innerWidth<640)},R=()=>{document.visibilityState==="visible"&&(s={...s,bounds:null},Object.assign(a.style,y(s,n,window.innerWidth<640)),x(v,s,n,window.innerWidth<640),m&&s.mounted&&g("host.command",{name:"show"}),I!==null&&window.cancelAnimationFrame(I),I=window.requestAnimationFrame(()=>{I=null,Object.assign(a.style,y(s,n,window.innerWidth<640))}))};return window.addEventListener("message",D),window.addEventListener("pointerdown",j,!0),window.addEventListener("resize",L),window.addEventListener("pageshow",R),window.visualViewport?.addEventListener("resize",L),document.addEventListener("visibilitychange",R),{destroy:()=>{C=!0,window.removeEventListener("message",D),window.removeEventListener("pointerdown",j,!0),window.removeEventListener("resize",L),window.removeEventListener("pageshow",R),window.visualViewport?.removeEventListener("resize",L),document.removeEventListener("visibilitychange",R),I!==null&&window.cancelAnimationFrame(I);for(let o of h.values())window.clearTimeout(o.timer),o.reject(new Error("HeroUI Agent iframe was removed"));h.clear(),w.length=0,k.clear(),te(v),a.remove()},hide:()=>O(!1),newConversation:o=>{m=!0,T("newConversation",{prompt:o})},preload:()=>T("preload"),get ready(){return s.ready},refreshAuth:()=>{P.clear(),T("refreshAuth")},show:()=>O(!0),shutdown:()=>{m=!1,A=!1,P.reset(),T("shutdown")},subscribe:o=>(k.add(o),()=>k.delete(o)),toggle:()=>O(!m),update:o=>{if(o.agentId!==n.agentId)throw new Error("HeroUI Agent agentId cannot change without remounting");o.getAuthToken!==n.getAuthToken&&(P=new S(o.agentId,o.getAuthToken)),n=o,Object.assign(a.style,y(s,n,window.innerWidth<640)),x(v,s,n,window.innerWidth<640),s.ready&&z("host.update")}}}async function me(e,t,n,i){let l={conversationId:t.conversationId,idempotencyKey:t.idempotencyKey,toolCallId:t.toolCallId,uploadDataSource:async p=>await i("host.upload-data-source",{toolCallId:t.toolCallId,upload:p})},u=await e.execute(q(e,t.args),n.context??{},l)??null;return re(u,he,`Client tool ${e.name} result`),u}async function ye(e,t){let{context:n,getAuthToken:i,onFeedback:l,onReady:u,tools:p,...a}=e,h=await t(p??[]);return{localStorage:oe(window.localStorage),props:JSON.parse(JSON.stringify(a)),sessionStorage:oe(window.sessionStorage),tools:h}}function we(e,t){let n=t.get(e.requestId);if(n)if(t.delete(e.requestId),window.clearTimeout(n.timer),e.type==="iframe.rpc-error"){let i=e.payload;n.reject(new Error(typeof i?.error=="string"?i.error:"Iframe request failed"))}else{let i=e.payload;n.resolve(i?.value)}}function be(e){if(!e||typeof e!="object")throw new Error("Invalid client tool request");let t=e;if(typeof t.conversationId!="string"||typeof t.idempotencyKey!="string"||typeof t.name!="string"||typeof t.toolCallId!="string")throw new Error("Invalid client tool request");return t}function re(e,t,n){if(!Y(e))throw new Error(`${n} must be JSON-serializable`);if(new TextEncoder().encode(JSON.stringify(e)).byteLength>t)throw new Error(`${n} exceeds ${Math.round(t/1024)} KiB`)}function oe(e){let t={};try{for(let n=0;n<e.length;n+=1){let i=e.key(n);i?.startsWith("heroui-agent:")&&(t[i]=e.getItem(i)??"")}}catch{}return t}function ve(e){if(!e||typeof e!="object")return;let t=e;if(typeof t.key=="string"&&!t.key.startsWith("heroui-agent:"))return;let n=t.storage==="session"?sessionStorage:localStorage;try{if(t.operation==="set"&&typeof t.key=="string"&&typeof t.value=="string")n.setItem(t.key,t.value);else if(t.operation==="remove"&&typeof t.key=="string")n.removeItem(t.key);else if(t.operation==="clear")for(let i=n.length-1;i>=0;i-=1){let l=n.key(i);l?.startsWith("heroui-agent:")&&n.removeItem(l)}}catch{}}function Ae(e,t){return e.has(t)?!1:(e.add(t),e.size>2048&&e.delete(e.values().next().value),!0)}function Ie(e,t){if(t){let n=new URL(t);if(n.protocol!=="http:"&&n.protocol!=="https:")throw new Error("HeroUI Agent embed origin must use HTTP or HTTPS");return n.origin}return/^https?:\/\/(?:localhost|127\.0\.0\.1)(?::\d+)?$/i.test(e)?"http://localhost:8793":e.includes("staging")?K:G}export{S as a,Oe as b};

package/dist/chunk-7OTMWVOC.js

@@ -1 +0,0 @@
-var c={animation:"fadeIn",duration:160,easing:"ease-out",sep:"word",stagger:18};var A=5,l=10485760,r={"application/epub+zip":"epub","application/json":"json","application/msword":"doc","application/pdf":"pdf","application/rtf":"rtf","application/vnd.ms-excel":"xls","application/vnd.ms-excel.sheet.binary.macroenabled.12":"xlsb","application/vnd.ms-excel.sheet.macroenabled.12":"xlsm","application/vnd.ms-powerpoint":"ppt","application/vnd.ms-powerpoint.presentation.macroenabled.12":"pptm","application/vnd.ms-word.document.macroenabled.12":"docm","application/vnd.oasis.opendocument.presentation":"odp","application/vnd.oasis.opendocument.spreadsheet":"ods","application/vnd.oasis.opendocument.text":"odt","application/vnd.openxmlformats-officedocument.presentationml.presentation":"pptx","application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":"xlsx","application/vnd.openxmlformats-officedocument.wordprocessingml.document":"docx","image/gif":"gif","image/jpeg":"jpg","image/png":"png","image/webp":"webp","text/csv":"csv","text/html":"html","text/markdown":"md","text/plain":"txt","text/rtf":"rtf","text/tab-separated-values":"tsv"},a=Object.freeze(Object.keys(r)),d=a.join(","),i=Object.freeze({...Object.fromEntries(Object.entries(r).map(([e,t])=>[t,e])),htm:"text/html",xhtml:"text/html"}),p=new Set(a),m=new Set(["application/json","text/csv","text/markdown","text/plain","text/tab-separated-values"]);function s(e){return p.has(e.trim().toLowerCase())}function T(e,t){let n=e.trim().toLowerCase();if(s(n))return n;let o=t.trim().toLowerCase().match(/\.([a-z0-9]+)$/)?.[1];return o?i[o]??null:null}export{c as a,A as b,l as c,r as d,a as e,d as f,i as g,m as h,s as i,T as j};

package/dist/chunk-KGJ6UDTY.js

@@ -1 +0,0 @@
-var t="1.0.0-beta.5",o="https://api.heroui.pro";export{t as a,o as b};

package/dist/chunk-PKCBDTYR.js

@@ -1 +0,0 @@
-import{b as i,k as a}from"./chunk-SWO2ABN5.js";import{z as t}from"zod";var c=["callMcpTool","composeUI","executeSandbox","generateFile","getComponentSchema","renderComponent","searchKnowledge","searchMcpTools","searchWeb"],m="mcp_",p=20,l=16*1024,d=t.object({description:t.string().trim().min(1).max(1e3),inputSchema:t.record(t.string(),t.unknown()),name:t.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/).refine(e=>!c.includes(e)&&!e.toLowerCase().startsWith(m),"Client tool name is reserved by the HeroUI Agent runtime"),needsApproval:t.boolean().optional()}),f=t.array(d).max(p).superRefine((e,n)=>{let o=new Set;for(let r of e)o.has(r.name)&&n.addIssue({code:"custom",message:`Duplicate client tool name: ${r.name}`}),o.add(r.name);new TextEncoder().encode(JSON.stringify(e)).byteLength>l&&n.addIssue({code:"custom",message:"Client tool manifest exceeds 16KB"})});function u(e){let n=i(e.parameters)?t.toJSONSchema(e.parameters):e.parameters;if(!a(n))throw new Error(`Client tool ${e.name} parameters must be a JSON-serializable schema`);return s(n)}function s(e){return Array.isArray(e)?e.map(s):e&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([n,o])=>[n,s(o)])):e}function E(e){return f.parse(e.map(n=>({description:n.description,inputSchema:u(n),name:n.name,...n.needsApproval?{needsApproval:!0}:{}})))}export{c as a,m as b,p as c,l as d,d as e,f,E as g};

package/dist/chunk-PX3X4VP2.js

@@ -1 +0,0 @@
-import{b as E}from"./chunk-6O4WPQKO.js";import{b as p}from"./chunk-SWO2ABN5.js";import{useEffect as S,useLayoutEffect as d,useMemo as x,useRef as u,useState as b,useSyncExternalStore as H}from"react";var s=new Map,m=new Set;function T(){for(let e of m)e()}function k(e){return m.add(e),()=>m.delete(e)}function l(e,o,r){let n=e?s.get(e):[...s.values()][s.size-1];if(!n){console.warn("HeroUI Agent is not mounted yet. Add <HeroUIAgent /> to your layout.");return}o==="newConversation"?n.newConversation(r):n[o]()}function D(e){let o=H(k,()=>(e?s.get(e):[...s.values()].at(-1))?.ready??!1,()=>!1);return x(()=>({hide:()=>l(e,"hide"),newConversation:r=>l(e,"newConversation",r),preload:()=>l(e,"preload"),ready:o,refreshAuth:()=>l(e,"refreshAuth"),show:()=>l(e,"show"),shutdown:()=>l(e,"shutdown"),toggle:()=>l(e,"toggle")}),[e,o])}async function G(e){let{serializeClientTools:o}=await import("./client-tools-manifest-62CRLCZY.js");return o(e).map(n=>{let i=e.find(a=>a.name===n.name);return{...n,...i?.displayName?{displayName:i.displayName}:{},...i?.icon?{icon:i.icon}:{},...i?.iconColor?{iconColor:i.iconColor}:{}}})}function R(e){let o=u(e),r=u(null),n=u(null);d(()=>{o.current=e}),n.current||(n.current={getAuthToken:t=>o.current.getAuthToken(t),onFeedback:t=>o.current.onFeedback?.(t),onReady:()=>o.current.onReady?.()},Object.defineProperties(n.current,{context:{enumerable:!0,get(){return o.current.context}},tools:{enumerable:!0,get(){return o.current.tools}}}));let i=y(e),a=n.current;for(let t of Object.keys(a))t!=="context"&&t!=="getAuthToken"&&t!=="onFeedback"&&t!=="onReady"&&t!=="tools"&&!(t in i)&&delete a[t];Object.assign(a,i,{agentId:e.agentId});let g=n.current;d(()=>{let t=E(g,G),A=t.subscribe(T);return r.current=t,s.set(e.agentId,t),T(),()=>{A(),t.destroy(),s.get(e.agentId)===t&&s.delete(e.agentId),r.current===t&&(r.current=null),T()}},[e.agentId]);let[N,h]=b("");S(()=>{let t=e.tools??[];if(!t.some(c=>p(c.parameters))){h("");return}let A=!1;return import("./client-tools-manifest-62CRLCZY.js").then(({serializeClientTools:c})=>{A||h(JSON.stringify(c(t).map(f=>({inputSchema:f.inputSchema,name:f.name}))))}),()=>{A=!0}},[e.tools]);let M=JSON.stringify({props:y(e),tools:(e.tools??[]).map(t=>({description:t.description,displayName:t.displayName,icon:t.icon,iconColor:t.iconColor,name:t.name,needsApproval:t.needsApproval===!0,parameters:p(t.parameters)?null:t.parameters})),zodToolsSchemasKey:N});return d(()=>{r.current?.update(g)},[M]),null}function y(e){let{context:o,getAuthToken:r,onFeedback:n,onReady:i,tools:a,...g}=e;return JSON.parse(JSON.stringify(g))}var _=["moonshotai/Kimi-K3","openai/gpt-5.6-luna","openai/gpt-5.6-terra","openai/gpt-5.6-sol","google/gemini-3.7-flash","anthropic/claude-sonnet-5","anthropic/claude-opus-4.8"],C={"google/gemini-3.5-flash":"google/gemini-3.7-flash","google/gemini-3.6-flash":"google/gemini-3.7-flash"};function I(e){return C[e]??e}var w="google/gemini-3.7-flash",O=[{description:"Flagship model for coding, reasoning, and knowledge work",id:"moonshotai/Kimi-K3",label:"Kimi K3",provider:"Moonshot AI",tier:"light"},{description:"Fast answers and lightweight agent workflows",id:"openai/gpt-5.6-luna",label:"GPT-5.6 Luna",provider:"OpenAI",tier:"light"},{description:"Balanced reasoning for everyday agent tasks",id:"openai/gpt-5.6-terra",label:"GPT-5.6 Terra",provider:"OpenAI",tier:"codegen"},{description:"Deep reasoning for complex, multi-step analysis",id:"openai/gpt-5.6-sol",label:"GPT-5.6 Sol",provider:"OpenAI",tier:"complex"},{description:"Fast multimodal analysis with a large context window",id:"google/gemini-3.7-flash",label:"Gemini 3.7 Flash",provider:"Google",tier:"light"},{description:"Strong agentic reasoning and polished UI decisions",id:"anthropic/claude-sonnet-5",label:"Claude Sonnet 5",provider:"Anthropic",tier:"codegen"},{description:"Highest-capability Claude for difficult research and analysis",id:"anthropic/claude-opus-4.8",label:"Claude Opus 4.8",provider:"Anthropic",tier:"complex"}],P=new Set(_);function U(e){return typeof e=="string"&&P.has(e)}function v(e){let o=e?I(e):void 0;return O.find(r=>r.id===o)?.tier??"light"}var L=["base","brutalism","glass","mouve"];export{D as a,R as b,_ as c,C as d,I as e,w as f,O as g,U as h,v as i,L as j};

package/dist/chunk-SWO2ABN5.js

@@ -1 +0,0 @@
-function g(){return function(t){return t}}function a(e){return!!(e&&typeof e=="object"&&typeof e.safeParse=="function")}function u(e,t){return a(e.parameters)?e.parameters.parse(t):t}function l(e,t){let n=e.get(t);return!n||n.needsApproval?null:n}var f="https://agent.heroui.pro",y="https://staging-agent.heroui.pro",T=262144,A=57671680;function m(e,t,n,o,r=crypto.randomUUID()){return{nonce:t,...o===void 0?{}:{payload:o},requestId:r,sessionId:e,type:n}}function E(e){if(!e||typeof e!="object")return null;let t=e;if(typeof t.sessionId!="string"||!i(t.sessionId)||typeof t.nonce!="string"||!i(t.nonce)||typeof t.requestId!="string"||!i(t.requestId)||typeof t.type!="string"||t.type.length===0||t.type.length>80)return null;let n=t.type==="iframe.persistence"||t.type==="host.upload-data-source"||t.type==="host.rpc-result"?57671680:262144;return c(e)>n?null:{nonce:t.nonce,...Object.hasOwn(t,"payload")?{payload:t.payload}:{},requestId:t.requestId,sessionId:t.sessionId,type:t.type}}function p(e,t=new Set){if(e===null||typeof e=="string"||typeof e=="boolean")return!0;if(typeof e=="number")return Number.isFinite(e);if(typeof e!="object"||t.has(e))return!1;t.add(e);let n=Array.isArray(e)?e.every(o=>p(o,t)):Object.getPrototypeOf(e)===Object.prototype&&Object.values(e).every(o=>p(o,t));return t.delete(e),n}function c(e){return s(e,new Set)}function s(e,t){if(e==null)return 4;if(typeof e=="string")return new TextEncoder().encode(e).byteLength+2;if(typeof e=="boolean"||typeof e=="number")return 8;if(typeof e!="object"||t.has(e))return Number.POSITIVE_INFINITY;if(e instanceof ArrayBuffer||ArrayBuffer.isView(e))return e.byteLength;if(typeof Blob<"u"&&e instanceof Blob)return e.size;t.add(e);let n=2;for(let[o,r]of Object.entries(e))if(n+=s(o,t)+s(r,t),!Number.isFinite(n))break;return t.delete(e),n}function i(e){return e.length>0&&e.length<=128&&/^[A-Za-z0-9._:-]+$/.test(e)}export{g as a,a as b,u as c,l as d,f as e,y as f,T as g,A as h,m as i,E as j,p as k,c as l};