@harperfast/harper 5.2.8 → 5.2.10

package/studio/web/assets/Chat-DDlysEi_.js

@@ -1,2067 +0,0 @@
-import{r as e,t}from"./rolldown-runtime-hePW80VL.js";import{C as n,S as r,_ as i,b as a,c as o,f as s,g as c,h as l,i as u,l as d,m as f,n as p,o as m,p as h,r as g,s as _,u as v,v as ee,x as te,y}from"./vendor-core-RCcadM3e.js";import{i as b,t as x}from"./button-DhiX-njv.js";import{H as ne,L as re,k as ie,z as ae}from"./vendor-tanstack-BiFWSB3W.js";import{a as oe}from"./vendor-datadog-BRv-mOv1.js";import{r as se}from"./vendor-react-Dyj4O3HE.js";import{n as ce}from"./setSessionStorage-B0bf71m4.js";import{It as le}from"./vendor-ui-vhu-UHhF.js";import{t as S}from"./createLucideIcon-BKGPfjm2.js";import{n as ue,r as de,t as fe}from"./chevron-up-Df2c8uoU.js";import{c as pe,f as me,g as he,h as ge,i as _e,l as ve,m as ye,p as be,r as xe,t as Se,u as Ce}from"./setComponentFile-D8ZLDWhU.js";import{t as we}from"./x-B9o9hsep.js";import{n as Te}from"./setLocalStorage-D_kflv4U.js";import{t as Ee}from"./useLocalStorage-Dtj1QS8_.js";import{An as De,En as Oe,Er as ke,H as Ae,It as je,Mt as Me,Nr as Ne,Nt as Pe,Or as Fe,Pt as Ie,V as Le,Z as Re,br as ze,c as Be,cr as Ve,d as He,dr as Ue,f as We,ft as Ge,gr as Ke,in as qe,kr as Je,m as Ye,or as Xe,pr as Ze,ur as Qe,ut as $e,xr as et,yt as tt}from"./index-BtTvoLf8.js";import{t as nt}from"./useEntityRestURL-C7x-Yz9r.js";import{n as rt,t as it}from"./FloatingChat-DdJ3DZJX.js";import{n as at}from"./getAnalytics-D4LKGeVy.js";var ot=S(`between-horizontal-start`,[[`rect`,{width:`13`,height:`7`,x:`8`,y:`3`,rx:`1`,key:`pkso9a`}],[`path`,{d:`m2 9 3 3-3 3`,key:`1agib5`}],[`rect`,{width:`13`,height:`7`,x:`8`,y:`14`,rx:`1`,key:`1q5fc1`}]]),st=S(`book`,[[`path`,{d:`M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20`,key:`k3hazp`}]]),ct=S(`chart-area`,[[`path`,{d:`M3 3v16a2 2 0 0 0 2 2h16`,key:`c24i48`}],[`path`,{d:`M7 11.207a.5.5 0 0 1 .146-.353l2-2a.5.5 0 0 1 .708 0l3.292 3.292a.5.5 0 0 0 .708 0l4.292-4.292a.5.5 0 0 1 .854.353V16a1 1 0 0 1-1 1H8a1 1 0 0 1-1-1z`,key:`q0gr47`}]]),lt=S(`circle-x`,[[`circle`,{cx:`12`,cy:`12`,r:`10`,key:`1mglay`}],[`path`,{d:`m15 9-6 6`,key:`1uzhvr`}],[`path`,{d:`m9 9 6 6`,key:`z0biqf`}]]),ut=S(`file-pen`,[[`path`,{d:`M12.659 22H18a2 2 0 0 0 2-2V8a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 14 2H6a2 2 0 0 0-2 2v9.34`,key:`o6klzx`}],[`path`,{d:`M14 2v5a1 1 0 0 0 1 1h5`,key:`wfsgrz`}],[`path`,{d:`M10.378 12.622a1 1 0 0 1 3 3.003L8.36 20.637a2 2 0 0 1-.854.506l-2.867.837a.5.5 0 0 1-.62-.62l.836-2.869a2 2 0 0 1 .506-.853z`,key:`zhnas1`}]]),dt=S(`logs`,[[`path`,{d:`M3 5h1`,key:`1mv5vm`}],[`path`,{d:`M3 12h1`,key:`lp3yf2`}],[`path`,{d:`M3 19h1`,key:`w6f3n9`}],[`path`,{d:`M8 5h1`,key:`1nxr5w`}],[`path`,{d:`M8 12h1`,key:`1con00`}],[`path`,{d:`M8 19h1`,key:`k7p10e`}],[`path`,{d:`M13 5h8`,key:`a7qcls`}],[`path`,{d:`M13 12h8`,key:`h98zly`}],[`path`,{d:`M13 19h8`,key:`c3s6r1`}]]),ft=S(`message-square-heart`,[[`path`,{d:`M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z`,key:`18887p`}],[`path`,{d:`M7.5 9.5c0 .687.265 1.383.697 1.844l3.009 3.264a1.14 1.14 0 0 0 .407.314 1 1 0 0 0 .783-.004 1.14 1.14 0 0 0 .398-.31l3.008-3.264A2.77 2.77 0 0 0 16.5 9.5 2.5 2.5 0 0 0 12 8a2.5 2.5 0 0 0-4.5 1.5`,key:`1faxuh`}]]),pt=S(`send`,[[`path`,{d:`M14.536 21.686a.5.5 0 0 0 .937-.024l6.5-19a.496.496 0 0 0-.635-.635l-19 6.5a.5.5 0 0 0-.024.937l7.93 3.18a2 2 0 0 1 1.112 1.11z`,key:`1ffxy3`}],[`path`,{d:`m21.854 2.147-10.94 10.939`,key:`12cjpa`}]]),mt=S(`wrench`,[[`path`,{d:`M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.106-3.105c.32-.322.863-.22.983.218a6 6 0 0 1-8.259 7.057l-7.91 7.91a1 1 0 0 1-2.999-3l7.91-7.91a6 6 0 0 1 7.057-8.259c.438.12.54.662.219.984z`,key:`1ngwbx`}]]);async function ht(){await b.delete(`/Chat/Messages/`)}var C=e(oe(),1),w=se();function gt({setMessages:e}){let[t,n]=(0,C.useState)(!1),r=(0,C.useCallback)(async()=>{if(!t){n(!0);try{await ht(),e([])}catch(e){console.error(`Failed to clear chat:`,e)}finally{n(!1)}}},[t,e]);return(0,w.jsxs)(`button`,{type:`button`,className:`clear-chat-button gap-1`,onClick:r,disabled:t,title:`Clear chat`,children:[t?(0,w.jsx)(ze,{className:`animate-spin`,size:18}):(0,w.jsx)(Qe,{size:18}),`Clear`]})}async function _t(){let{data:e}=await b.get(`/Chat/Messages/`);return e}var vt=`vercel.ai.error`,yt=Symbol.for(vt),bt,xt,T=class e extends (xt=Error,bt=yt,xt){constructor({name:e,message:t,cause:n}){super(t),this[bt]=!0,this.name=e,this.cause=n}static isInstance(t){return e.hasMarker(t,vt)}static hasMarker(e,t){let n=Symbol.for(t);return typeof e==`object`&&!!e&&n in e&&typeof e[n]==`boolean`&&e[n]===!0}};function St(e){return e==null?`unknown error`:typeof e==`string`?e:e instanceof Error?e.toString():JSON.stringify(e)}var Ct=`AI_InvalidArgumentError`,wt=`vercel.ai.error.${Ct}`,Tt=Symbol.for(wt),Et,Dt,Ot=class extends (Dt=T,Et=Tt,Dt){constructor({message:e,cause:t,argument:n}){super({name:Ct,message:e,cause:t}),this[Et]=!0,this.argument=n}static isInstance(e){return T.hasMarker(e,wt)}},kt=`AI_JSONParseError`,At=`vercel.ai.error.${kt}`,jt=Symbol.for(At),Mt,Nt,Pt=class extends (Nt=T,Mt=jt,Nt){constructor({text:e,cause:t}){super({name:kt,message:`JSON parsing failed: Text: ${e}.
-Error message: ${St(t)}`,cause:t}),this[Mt]=!0,this.text=e}static isInstance(e){return T.hasMarker(e,At)}},Ft=`AI_TypeValidationError`,It=`vercel.ai.error.${Ft}`,Lt=Symbol.for(It),Rt,zt,E=class e extends (zt=T,Rt=Lt,zt){constructor({value:e,cause:t,context:n}){let r=`Type validation failed`;if(n?.field&&(r+=` for ${n.field}`),n?.entityName||n?.entityId){r+=` (`;let e=[];n.entityName&&e.push(n.entityName),n.entityId&&e.push(`id: "${n.entityId}"`),r+=e.join(`, `),r+=`)`}super({name:Ft,message:`${r}: Value: ${JSON.stringify(e)}.
-Error message: ${St(t)}`,cause:t}),this[Rt]=!0,this.value=e,this.context=n}static isInstance(e){return T.hasMarker(e,It)}static wrap({value:t,cause:n,context:r}){return e.isInstance(n)&&n.value===t&&n.context?.field===r?.field&&n.context?.entityName===r?.entityName&&n.context?.entityId===r?.entityId?n:new e({value:t,cause:n,context:r})}},Bt=class extends Error{constructor(e,t){super(e),this.name=`ParseError`,this.type=t.type,this.field=t.field,this.value=t.value,this.line=t.line}},Vt=10,Ht=13,D=32;function Ut(e){}function Wt(e){if(typeof e==`function`)throw TypeError("`config` must be an object, got a function instead. Did you mean `createParser({onEvent: fn})`?");let{onEvent:t=Ut,onError:n=Ut,onRetry:r=Ut,onComment:i,maxBufferSize:a}=e,o=[],s=0,c=!0,l,u=``,d=0,f,p=!1;function m(e){if(p)throw Error("Cannot feed parser: it was terminated after exceeding the configured max buffer size. Call `reset()` to resume parsing.");if(c&&(c=!1,e.charCodeAt(0)===239&&e.charCodeAt(1)===187&&e.charCodeAt(2)===191&&(e=e.slice(3))),o.length===0){let t=g(e);t!==``&&(o.push(t),s=t.length),h();return}if(e.indexOf(`
-`)===-1&&e.indexOf(`\r`)===-1){o.push(e),s+=e.length,h();return}o.push(e);let t=o.join(``);o.length=0,s=0;let n=g(t);n!==``&&(o.push(n),s=n.length),h()}function h(){a!==void 0&&(s+u.length<=a||(p=!0,o.length=0,s=0,l=void 0,u=``,d=0,f=void 0,n(new Bt(`Buffered data exceeded max buffer size of ${a} characters`,{type:`max-buffer-size-exceeded`}))))}function g(e){let n=0;if(e.indexOf(`\r`)===-1){let r=e.indexOf(`
-`,n);for(;r!==-1;){if(n===r){d>0&&t({id:l,event:f,data:u}),l=void 0,u=``,d=0,f=void 0,n=r+1,r=e.indexOf(`
-`,n);continue}let i=e.charCodeAt(n);if(Gt(e,n,i)){let i=e.charCodeAt(n+5)===D?n+6:n+5,a=e.slice(i,r);if(d===0&&e.charCodeAt(r+1)===Vt){t({id:l,event:f,data:a}),l=void 0,u=``,f=void 0,n=r+2,r=e.indexOf(`
-`,n);continue}u=d===0?a:`${u}
-${a}`,d++}else Kt(e,n,i)?f=e.slice(e.charCodeAt(n+6)===D?n+7:n+6,r)||void 0:_(e,n,r);n=r+1,r=e.indexOf(`
-`,n)}return e.slice(n)}for(;n<e.length;){let t=e.indexOf(`\r`,n),r=e.indexOf(`
-`,n),i=-1;if(t!==-1&&r!==-1?i=t<r?t:r:t===-1?r!==-1&&(i=r):i=t===e.length-1?-1:t,i===-1)break;_(e,n,i),n=i+1,e.charCodeAt(n-1)===Ht&&e.charCodeAt(n)===Vt&&n++}return e.slice(n)}function _(e,t,n){if(t===n){ee();return}let r=e.charCodeAt(t);if(Gt(e,t,r)){let r=e.charCodeAt(t+5)===D?t+6:t+5,i=e.slice(r,n);u=d===0?i:`${u}
-${i}`,d++;return}if(Kt(e,t,r)){f=e.slice(e.charCodeAt(t+6)===D?t+7:t+6,n)||void 0;return}if(r===105&&e.charCodeAt(t+1)===100&&e.charCodeAt(t+2)===58){let r=e.slice(e.charCodeAt(t+3)===D?t+4:t+3,n);r.includes(`\0`)||(l=r);return}if(r===58){if(i){let r=e.slice(t,n);i(r.slice(e.charCodeAt(t+1)===D?2:1))}return}let a=e.slice(t,n),o=a.indexOf(`:`);if(o===-1){v(a,``,a);return}let s=a.slice(0,o),c=a.charCodeAt(o+1)===D?2:1;v(s,a.slice(o+c),a)}function v(e,t,i){switch(e){case`event`:f=t||void 0;break;case`data`:u=d===0?t:`${u}
-${t}`,d++;break;case`id`:t.includes(`\0`)||(l=t);break;case`retry`:/^\d+$/.test(t)?r(parseInt(t,10)):n(new Bt(`Invalid \`retry\` value: "${t}"`,{type:`invalid-retry`,value:t,line:i}));break;default:n(new Bt(`Unknown field "${e.length>20?`${e.slice(0,20)}\u2026`:e}"`,{type:`unknown-field`,field:e,value:t,line:i}))}}function ee(){d>0&&t({id:l,event:f,data:u}),l=void 0,u=``,d=0,f=void 0}function te(e={}){if(e.consume&&o.length>0){let e=o.join(``);_(e,0,e.length)}c=!0,l=void 0,u=``,d=0,f=void 0,o.length=0,s=0,p=!1}return{feed:m,reset:te}}function Gt(e,t,n){return n===100&&e.charCodeAt(t+1)===97&&e.charCodeAt(t+2)===116&&e.charCodeAt(t+3)===97&&e.charCodeAt(t+4)===58}function Kt(e,t,n){return n===101&&e.charCodeAt(t+1)===118&&e.charCodeAt(t+2)===101&&e.charCodeAt(t+3)===110&&e.charCodeAt(t+4)===116&&e.charCodeAt(t+5)===58}var qt=class extends TransformStream{constructor({onError:e,onRetry:t,onComment:n,maxBufferSize:r}={}){let i;super({start(a){i=Wt({onEvent:e=>{a.enqueue(e)},onError(t){typeof e==`function`&&e(t),(e===`terminate`||t.type===`max-buffer-size-exceeded`)&&a.error(t)},onRetry:t,onComment:n,maxBufferSize:r})},transform(e){i.feed(e)}})}};new TextDecoder;var{btoa:Jt,atob:Yt}=globalThis,Xt=globalThis.fetch;Zt(Xt);function Zt(e){if(typeof e!=`function`)return!1;let t=Function.prototype.toString.call(e);return t.includes(`internal/deps/undici`)||t.includes(`lazy loading of undici`)}var O=({prefix:e,size:t=16,alphabet:n=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`,separator:r=`-`}={})=>{let i=()=>{let e=n.length,r=Array(t);for(let i=0;i<t;i++)r[i]=n[Math.random()*e|0];return r.join(``)};if(e==null)return i;if(n.includes(r))throw new Ot({argument:`separator`,message:`The separator "${r}" must not be part of the alphabet "${n}".`});return()=>`${e}${r}${i()}`},Qt=O();function k(e){if(e==null)return{};let t={};if(e instanceof Headers)e.forEach((e,n)=>{t[n.toLowerCase()]=e});else{Array.isArray(e)||(e=Object.entries(e));for(let[n,r]of e)r!=null&&(t[n.toLowerCase()]=r)}return t}function $t(e){return globalThis.Buffer?.isBuffer(e)??!1}var en=/"(?:_|\\u005[Ff])(?:_|\\u005[Ff])(?:p|\\u0070)(?:r|\\u0072)(?:o|\\u006[Ff])(?:t|\\u0074)(?:o|\\u006[Ff])(?:_|\\u005[Ff])(?:_|\\u005[Ff])"\s*:/,tn=/"(?:c|\\u0063)(?:o|\\u006[Ff])(?:n|\\u006[Ee])(?:s|\\u0073)(?:t|\\u0074)(?:r|\\u0072)(?:u|\\u0075)(?:c|\\u0063)(?:t|\\u0074)(?:o|\\u006[Ff])(?:r|\\u0072)"\s*:/;function nn(e){let t=JSON.parse(e);return typeof t!=`object`||!t||en.test(e)===!1&&tn.test(e)===!1?t:rn(t)}function rn(e){let t=[e];for(;t.length;){let e=t;t=[];for(let n of e){if(Object.prototype.hasOwnProperty.call(n,`__proto__`)||Object.prototype.hasOwnProperty.call(n,`constructor`)&&n.constructor!==null&&typeof n.constructor==`object`&&Object.prototype.hasOwnProperty.call(n.constructor,`prototype`))throw SyntaxError(`Object contains forbidden prototype property`);for(let e in n){let r=n[e];r&&typeof r==`object`&&t.push(r)}}}return e}function an(e){let{stackTraceLimit:t}=Error;try{Error.stackTraceLimit=0}catch{return nn(e)}try{return nn(e)}finally{Error.stackTraceLimit=t}}function on(e){if(e.type===`object`||Array.isArray(e.type)&&e.type.includes(`object`)){e.additionalProperties=!1;let{properties:t}=e;if(t!=null)for(let e of Object.keys(t))t[e]=A(t[e])}e.items!=null&&(e.items=Array.isArray(e.items)?e.items.map(A):A(e.items)),e.anyOf!=null&&(e.anyOf=e.anyOf.map(A)),e.allOf!=null&&(e.allOf=e.allOf.map(A)),e.oneOf!=null&&(e.oneOf=e.oneOf.map(A));let{definitions:t}=e;if(t!=null)for(let e of Object.keys(t))t[e]=A(t[e]);return e}function A(e){return typeof e==`boolean`?e:on(e)}var sn=Symbol(`Let zodToJsonSchema decide on which parser to use`),cn={name:void 0,$refStrategy:`root`,basePath:[`#`],effectStrategy:`input`,pipeStrategy:`all`,dateStrategy:`format:date-time`,mapStrategy:`entries`,removeAdditionalStrategy:`passthrough`,allowedAdditionalProperties:!0,rejectedAdditionalProperties:!1,definitionPath:`definitions`,strictUnions:!1,definitions:{},errorMessages:!1,patternStrategy:`escape`,applyRegexFlags:!1,emailStrategy:`format:email`,base64Strategy:`contentEncoding:base64`,nameStrategy:`ref`},ln=e=>typeof e==`string`?{...cn,name:e}:{...cn,...e};function j(){return{}}function un(e,t){let n={type:`array`};return e.type?._def&&e.type?._def?.typeName!==`ZodAny`&&(n.items=F(e.type._def,{...t,currentPath:[...t.currentPath,`items`]})),e.minLength&&(n.minItems=e.minLength.value),e.maxLength&&(n.maxItems=e.maxLength.value),e.exactLength&&(n.minItems=e.exactLength.value,n.maxItems=e.exactLength.value),n}function dn(e){let t={type:`integer`,format:`int64`};if(!e.checks)return t;for(let n of e.checks)switch(n.kind){case`min`:n.inclusive?t.minimum=n.value:t.exclusiveMinimum=n.value;break;case`max`:n.inclusive?t.maximum=n.value:t.exclusiveMaximum=n.value;break;case`multipleOf`:t.multipleOf=n.value}return t}function fn(){return{type:`boolean`}}function pn(e,t){return F(e.type._def,t)}var mn=(e,t)=>F(e.innerType._def,t);function hn(e,t,n){let r=n??t.dateStrategy;if(Array.isArray(r))return{anyOf:r.map(n=>hn(e,t,n))};switch(r){case`string`:case`format:date-time`:return{type:`string`,format:`date-time`};case`format:date`:return{type:`string`,format:`date`};case`integer`:return gn(e)}}var gn=e=>{let t={type:`integer`,format:`unix-time`};for(let n of e.checks)switch(n.kind){case`min`:t.minimum=n.value;break;case`max`:t.maximum=n.value}return t};function _n(e,t){return{...F(e.innerType._def,t),default:e.defaultValue()}}function vn(e,t){return t.effectStrategy===`input`?F(e.schema._def,t):j()}function yn(e){return{type:`string`,enum:Array.from(e.values)}}var bn=e=>`type`in e&&e.type===`string`?!1:`allOf`in e;function xn(e,t){let n=[F(e.left._def,{...t,currentPath:[...t.currentPath,`allOf`,`0`]}),F(e.right._def,{...t,currentPath:[...t.currentPath,`allOf`,`1`]})].filter(e=>!!e),r=[];return n.forEach(e=>{if(bn(e))r.push(...e.allOf);else{let t=e;if(`additionalProperties`in e&&e.additionalProperties===!1){let{additionalProperties:n,...r}=e;t=r}r.push(t)}}),r.length?{allOf:r}:void 0}function Sn(e){let t=typeof e.value;return t!==`bigint`&&t!==`number`&&t!==`boolean`&&t!==`string`?{type:Array.isArray(e.value)?`array`:`object`}:{type:t===`bigint`?`integer`:t,const:e.value}}var Cn=void 0,M={cuid:/^[cC][^\s-]{8,}$/,cuid2:/^[0-9a-z]+$/,ulid:/^[0-9A-HJKMNP-TV-Z]{26}$/,email:/^(?!\.)(?!.*\.\.)([a-zA-Z0-9_'+\-\.]*)[a-zA-Z0-9_+-]@([a-zA-Z0-9][a-zA-Z0-9\-]*\.)+[a-zA-Z]{2,}$/,emoji:()=>(Cn===void 0&&(Cn=RegExp(`^(\\p{Extended_Pictographic}|\\p{Emoji_Component})+$`,`u`)),Cn),uuid:/^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$/,ipv4:/^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$/,ipv4Cidr:/^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\/(3[0-2]|[12]?[0-9])$/,ipv6:/^(([a-f0-9]{1,4}:){7}|::([a-f0-9]{1,4}:){0,6}|([a-f0-9]{1,4}:){1}:([a-f0-9]{1,4}:){0,5}|([a-f0-9]{1,4}:){2}:([a-f0-9]{1,4}:){0,4}|([a-f0-9]{1,4}:){3}:([a-f0-9]{1,4}:){0,3}|([a-f0-9]{1,4}:){4}:([a-f0-9]{1,4}:){0,2}|([a-f0-9]{1,4}:){5}:([a-f0-9]{1,4}:){0,1})([a-f0-9]{1,4}|(((25[0-5])|(2[0-4][0-9])|(1[0-9]{2})|([0-9]{1,2}))\.){3}((25[0-5])|(2[0-4][0-9])|(1[0-9]{2})|([0-9]{1,2})))$/,ipv6Cidr:/^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))\/(12[0-8]|1[01][0-9]|[1-9]?[0-9])$/,base64:/^([0-9a-zA-Z+/]{4})*(([0-9a-zA-Z+/]{2}==)|([0-9a-zA-Z+/]{3}=))?$/,base64url:/^([0-9a-zA-Z-_]{4})*(([0-9a-zA-Z-_]{2}(==)?)|([0-9a-zA-Z-_]{3}(=)?))?$/,nanoid:/^[a-zA-Z0-9_-]{21}$/,jwt:/^[A-Za-z0-9-_]+\.[A-Za-z0-9-_]+\.[A-Za-z0-9-_]*$/};function wn(e,t){let n={type:`string`};if(e.checks)for(let r of e.checks)switch(r.kind){case`min`:n.minLength=typeof n.minLength==`number`?Math.max(n.minLength,r.value):r.value;break;case`max`:n.maxLength=typeof n.maxLength==`number`?Math.min(n.maxLength,r.value):r.value;break;case`email`:switch(t.emailStrategy){case`format:email`:N(n,`email`,r.message,t);break;case`format:idn-email`:N(n,`idn-email`,r.message,t);break;case`pattern:zod`:P(n,M.email,r.message,t)}break;case`url`:N(n,`uri`,r.message,t);break;case`uuid`:N(n,`uuid`,r.message,t);break;case`regex`:P(n,r.regex,r.message,t);break;case`cuid`:P(n,M.cuid,r.message,t);break;case`cuid2`:P(n,M.cuid2,r.message,t);break;case`startsWith`:P(n,RegExp(`^${Tn(r.value,t)}`),r.message,t);break;case`endsWith`:P(n,RegExp(`${Tn(r.value,t)}$`),r.message,t);break;case`datetime`:N(n,`date-time`,r.message,t);break;case`date`:N(n,`date`,r.message,t);break;case`time`:N(n,`time`,r.message,t);break;case`duration`:N(n,`duration`,r.message,t);break;case`length`:n.minLength=typeof n.minLength==`number`?Math.max(n.minLength,r.value):r.value,n.maxLength=typeof n.maxLength==`number`?Math.min(n.maxLength,r.value):r.value;break;case`includes`:P(n,RegExp(Tn(r.value,t)),r.message,t);break;case`ip`:r.version!==`v6`&&N(n,`ipv4`,r.message,t),r.version!==`v4`&&N(n,`ipv6`,r.message,t);break;case`base64url`:P(n,M.base64url,r.message,t);break;case`jwt`:P(n,M.jwt,r.message,t);break;case`cidr`:r.version!==`v6`&&P(n,M.ipv4Cidr,r.message,t),r.version!==`v4`&&P(n,M.ipv6Cidr,r.message,t);break;case`emoji`:P(n,M.emoji(),r.message,t);break;case`ulid`:P(n,M.ulid,r.message,t);break;case`base64`:switch(t.base64Strategy){case`format:binary`:N(n,`binary`,r.message,t);break;case`contentEncoding:base64`:n.contentEncoding=`base64`;break;case`pattern:zod`:P(n,M.base64,r.message,t)}break;case`nanoid`:P(n,M.nanoid,r.message,t)}return n}function Tn(e,t){return t.patternStrategy===`escape`?Dn(e):e}var En=new Set(`ABCDEFGHIJKLMNOPQRSTUVXYZabcdefghijklmnopqrstuvxyz0123456789`);function Dn(e){let t=``;for(let n=0;n<e.length;n++)En.has(e[n])||(t+=`\\`),t+=e[n];return t}function N(e,t,n,r){e.format||e.anyOf?.some(e=>e.format)?(e.anyOf||=[],e.format&&(e.anyOf.push({format:e.format}),delete e.format),e.anyOf.push({format:t,...n&&r.errorMessages&&{errorMessage:{format:n}}})):e.format=t}function P(e,t,n,r){e.pattern||e.allOf?.some(e=>e.pattern)?(e.allOf||=[],e.pattern&&(e.allOf.push({pattern:e.pattern}),delete e.pattern),e.allOf.push({pattern:On(t,r),...n&&r.errorMessages&&{errorMessage:{pattern:n}}})):e.pattern=On(t,r)}function On(e,t){if(!t.applyRegexFlags||!e.flags)return e.source;let n={i:e.flags.includes(`i`),m:e.flags.includes(`m`),s:e.flags.includes(`s`)},r=n.i?e.source.toLowerCase():e.source,i=``,a=!1,o=!1,s=!1;for(let e=0;e<r.length;e++){if(a){i+=r[e],a=!1;continue}if(n.i){if(o){if(r[e].match(/[a-z]/)){s?(i+=r[e],i+=`${r[e-2]}-${r[e]}`.toUpperCase(),s=!1):r[e+1]===`-`&&r[e+2]?.match(/[a-z]/)?(i+=r[e],s=!0):i+=`${r[e]}${r[e].toUpperCase()}`;continue}}else if(r[e].match(/[a-z]/)){i+=`[${r[e]}${r[e].toUpperCase()}]`;continue}}if(n.m){if(r[e]===`^`){i+=`(^|(?<=[\r
-]))`;continue}if(r[e]===`$`){i+=`($|(?=[\r
-]))`;continue}}if(n.s&&r[e]===`.`){i+=o?`${r[e]}\r
-`:`[${r[e]}\r
-]`;continue}i+=r[e],r[e]===`\\`?a=!0:o&&r[e]===`]`?o=!1:!o&&r[e]===`[`&&(o=!0)}try{new RegExp(i)}catch{return console.warn(`Could not convert regex pattern at ${t.currentPath.join(`/`)} to a flag-independent form! Falling back to the flag-ignorant source`),e.source}return i}function kn(e,t){let n={type:`object`,additionalProperties:F(e.valueType._def,{...t,currentPath:[...t.currentPath,`additionalProperties`]})??t.allowedAdditionalProperties};if(e.keyType?._def.typeName===`ZodString`&&e.keyType._def.checks?.length){let{type:r,...i}=wn(e.keyType._def,t);return{...n,propertyNames:i}}if(e.keyType?._def.typeName===`ZodEnum`)return{...n,propertyNames:{enum:e.keyType._def.values}};if(e.keyType?._def.typeName===`ZodBranded`&&e.keyType._def.type._def.typeName===`ZodString`&&e.keyType._def.type._def.checks?.length){let{type:r,...i}=pn(e.keyType._def,t);return{...n,propertyNames:i}}return n}function An(e,t){return t.mapStrategy===`record`?kn(e,t):{type:`array`,maxItems:125,items:{type:`array`,items:[F(e.keyType._def,{...t,currentPath:[...t.currentPath,`items`,`items`,`0`]})||j(),F(e.valueType._def,{...t,currentPath:[...t.currentPath,`items`,`items`,`1`]})||j()],minItems:2,maxItems:2}}}function jn(e){let t=e.values,n=Object.keys(e.values).filter(e=>typeof t[t[e]]!=`number`).map(e=>t[e]),r=Array.from(new Set(n.map(e=>typeof e)));return{type:r.length===1?r[0]===`string`?`string`:`number`:[`string`,`number`],enum:n}}function Mn(){return{not:j()}}function Nn(){return{type:`null`}}var Pn={ZodString:`string`,ZodNumber:`number`,ZodBigInt:`integer`,ZodBoolean:`boolean`,ZodNull:`null`};function Fn(e,t){let n=e.options instanceof Map?Array.from(e.options.values()):e.options;if(n.every(e=>e._def.typeName in Pn&&(!e._def.checks||!e._def.checks.length))){let e=n.reduce((e,t)=>{let n=Pn[t._def.typeName];return n&&!e.includes(n)?[...e,n]:e},[]);return{type:e.length>1?e:e[0]}}if(n.every(e=>e._def.typeName===`ZodLiteral`&&!e.description)){let e=n.reduce((e,t)=>{let n=typeof t._def.value;switch(n){case`string`:case`number`:case`boolean`:return[...e,n];case`bigint`:return[...e,`integer`];case`object`:if(t._def.value===null)return[...e,`null`];default:return e}},[]);if(e.length===n.length){let t=e.filter((e,t,n)=>n.indexOf(e)===t);return{type:t.length>1?t:t[0],enum:n.reduce((e,t)=>e.includes(t._def.value)?e:[...e,t._def.value],[])}}}else if(n.every(e=>e._def.typeName===`ZodEnum`))return{type:`string`,enum:n.reduce((e,t)=>[...e,...t._def.values.filter(t=>!e.includes(t))],[])};return In(e,t)}var In=(e,t)=>{let n=(e.options instanceof Map?Array.from(e.options.values()):e.options).map((e,n)=>F(e._def,{...t,currentPath:[...t.currentPath,`anyOf`,`${n}`]})).filter(e=>!!e&&(!t.strictUnions||typeof e==`object`&&Object.keys(e).length>0));return n.length?{anyOf:n}:void 0};function Ln(e,t){if([`ZodString`,`ZodNumber`,`ZodBigInt`,`ZodBoolean`,`ZodNull`].includes(e.innerType._def.typeName)&&(!e.innerType._def.checks||!e.innerType._def.checks.length))return{type:[Pn[e.innerType._def.typeName],`null`]};let n=F(e.innerType._def,{...t,currentPath:[...t.currentPath,`anyOf`,`0`]});return n&&{anyOf:[n,{type:`null`}]}}function Rn(e){let t={type:`number`};if(!e.checks)return t;for(let n of e.checks)switch(n.kind){case`int`:t.type=`integer`;break;case`min`:n.inclusive?t.minimum=n.value:t.exclusiveMinimum=n.value;break;case`max`:n.inclusive?t.maximum=n.value:t.exclusiveMaximum=n.value;break;case`multipleOf`:t.multipleOf=n.value}return t}function zn(e,t){let n={type:`object`,properties:{}},r=[],i=e.shape();for(let e in i){let a=i[e];if(a===void 0||a._def===void 0)continue;let o=Vn(a),s=F(a._def,{...t,currentPath:[...t.currentPath,`properties`,e],propertyPath:[...t.currentPath,`properties`,e]});s!==void 0&&(n.properties[e]=s,o||r.push(e))}r.length&&(n.required=r);let a=Bn(e,t);return a!==void 0&&(n.additionalProperties=a),n}function Bn(e,t){if(e.catchall._def.typeName!==`ZodNever`)return F(e.catchall._def,{...t,currentPath:[...t.currentPath,`additionalProperties`]});switch(e.unknownKeys){case`passthrough`:return t.allowedAdditionalProperties;case`strict`:return t.rejectedAdditionalProperties;case`strip`:return t.removeAdditionalStrategy===`strict`?t.allowedAdditionalProperties:t.rejectedAdditionalProperties}}function Vn(e){try{return e.isOptional()}catch{return!0}}var Hn=(e,t)=>{if(t.currentPath.toString()===t.propertyPath?.toString())return F(e.innerType._def,t);let n=F(e.innerType._def,{...t,currentPath:[...t.currentPath,`anyOf`,`1`]});return n?{anyOf:[{not:j()},n]}:j()},Un=(e,t)=>{if(t.pipeStrategy===`input`)return F(e.in._def,t);if(t.pipeStrategy===`output`)return F(e.out._def,t);let n=F(e.in._def,{...t,currentPath:[...t.currentPath,`allOf`,`0`]});return{allOf:[n,F(e.out._def,{...t,currentPath:[...t.currentPath,`allOf`,n?`1`:`0`]})].filter(e=>e!==void 0)}};function Wn(e,t){return F(e.type._def,t)}function Gn(e,t){let n={type:`array`,uniqueItems:!0,items:F(e.valueType._def,{...t,currentPath:[...t.currentPath,`items`]})};return e.minSize&&(n.minItems=e.minSize.value),e.maxSize&&(n.maxItems=e.maxSize.value),n}function Kn(e,t){return e.rest?{type:`array`,minItems:e.items.length,items:e.items.map((e,n)=>F(e._def,{...t,currentPath:[...t.currentPath,`items`,`${n}`]})).reduce((e,t)=>t===void 0?e:[...e,t],[]),additionalItems:F(e.rest._def,{...t,currentPath:[...t.currentPath,`additionalItems`]})}:{type:`array`,minItems:e.items.length,maxItems:e.items.length,items:e.items.map((e,n)=>F(e._def,{...t,currentPath:[...t.currentPath,`items`,`${n}`]})).reduce((e,t)=>t===void 0?e:[...e,t],[])}}function qn(){return{not:j()}}function Jn(){return j()}var Yn=(e,t)=>F(e.innerType._def,t),Xn=(e,t,n)=>{switch(t){case`ZodString`:return wn(e,n);case`ZodNumber`:return Rn(e);case`ZodObject`:return zn(e,n);case`ZodBigInt`:return dn(e);case`ZodBoolean`:return fn();case`ZodDate`:return hn(e,n);case`ZodUndefined`:return qn();case`ZodNull`:return Nn();case`ZodArray`:return un(e,n);case`ZodUnion`:case`ZodDiscriminatedUnion`:return Fn(e,n);case`ZodIntersection`:return xn(e,n);case`ZodTuple`:return Kn(e,n);case`ZodRecord`:return kn(e,n);case`ZodLiteral`:return Sn(e);case`ZodEnum`:return yn(e);case`ZodNativeEnum`:return jn(e);case`ZodNullable`:return Ln(e,n);case`ZodOptional`:return Hn(e,n);case`ZodMap`:return An(e,n);case`ZodSet`:return Gn(e,n);case`ZodLazy`:return()=>e.getter()._def;case`ZodPromise`:return Wn(e,n);case`ZodNaN`:case`ZodNever`:return Mn();case`ZodEffects`:return vn(e,n);case`ZodAny`:return j();case`ZodUnknown`:return Jn();case`ZodDefault`:return _n(e,n);case`ZodBranded`:return pn(e,n);case`ZodReadonly`:return Yn(e,n);case`ZodCatch`:return mn(e,n);case`ZodPipeline`:return Un(e,n);case`ZodFunction`:case`ZodVoid`:case`ZodSymbol`:return;default:return(e=>void 0)(t)}},Zn=(e,t)=>{let n=0;for(;n<e.length&&n<t.length&&e[n]===t[n];n++);return[(e.length-n).toString(),...t.slice(n)].join(`/`)};function F(e,t,n=!1){let r=t.seen.get(e);if(t.override){let i=t.override?.call(t,e,t,r,n);if(i!==sn)return i}if(r&&!n){let e=Qn(r,t);if(e!==void 0)return e}let i={def:e,path:t.currentPath,jsonSchema:void 0};t.seen.set(e,i);let a=Xn(e,e.typeName,t),o=typeof a==`function`?F(a(),t):a;if(o&&$n(e,t,o),t.postProcess){let n=t.postProcess(o,e,t);return i.jsonSchema=o,n}return i.jsonSchema=o,o}var Qn=(e,t)=>{switch(t.$refStrategy){case`root`:return{$ref:e.path.join(`/`)};case`relative`:return{$ref:Zn(t.currentPath,e.path)};case`none`:case`seen`:return e.path.length<t.currentPath.length&&e.path.every((e,n)=>t.currentPath[n]===e)?(console.warn(`Recursive reference detected at ${t.currentPath.join(`/`)}! Defaulting to any`),j()):t.$refStrategy===`seen`?j():void 0}},$n=(e,t,n)=>(e.description&&(n.description=e.description),n),er=e=>{let t=ln(e),n=t.name===void 0?t.basePath:[...t.basePath,t.definitionPath,t.name];return{...t,currentPath:n,propertyPath:void 0,seen:new Map(Object.entries(t.definitions).map(([e,n])=>[n._def,{def:n._def,path:[...t.basePath,t.definitionPath,e],jsonSchema:void 0}]))}},tr=(e,t)=>{let n=er(t),r=typeof t==`object`&&t.definitions?Object.entries(t.definitions).reduce((e,[t,r])=>({...e,[t]:F(r._def,{...n,currentPath:[...n.basePath,n.definitionPath,t]},!0)??j()}),{}):void 0,i=typeof t==`string`?t:t?.nameStrategy===`title`?void 0:t?.name,a=F(e._def,i===void 0?n:{...n,currentPath:[...n.basePath,n.definitionPath,i]},!1)??j(),o=typeof t==`object`&&t.name!==void 0&&t.nameStrategy===`title`?t.name:void 0;o!==void 0&&(a.title=o);let s=i===void 0?r?{...a,[n.definitionPath]:r}:a:{$ref:[...n.$refStrategy===`relative`?[]:n.basePath,n.definitionPath,i].join(`/`),[n.definitionPath]:{...r,[i]:a}};return s.$schema=`http://json-schema.org/draft-07/schema#`,s},nr=Symbol.for(`vercel.ai.schema`);function rr(e){let t;return()=>(t??=e(),t)}function ir(e,{validate:t}={}){return{[nr]:!0,_type:void 0,get jsonSchema(){return typeof e==`function`&&(e=e()),e},validate:t}}function ar(e){return typeof e==`object`&&!!e&&nr in e&&e[nr]===!0&&`jsonSchema`in e&&`validate`in e}function or(e){return e==null?ir({type:`object`,properties:{},additionalProperties:!1}):ar(e)?e:`~standard`in e?e[`~standard`].vendor===`zod`?fr(e):sr(e):e()}function sr(e){return ir(()=>{if(!cr(e))throw Error(`Standard schema vendor '${e[`~standard`].vendor}' does not support JSON Schema conversion.`);return on(e[`~standard`].jsonSchema.input({target:`draft-07`}))},{validate:async t=>{let n=await e[`~standard`].validate(t);return`value`in n?{success:!0,value:n.value}:{success:!1,error:new E({value:t,cause:n.issues})}}})}function cr(e){return e[`~standard`].jsonSchema!=null}function lr(e,t){let n=t?.useReferences??!1;return ir(()=>tr(e,{$refStrategy:n?`root`:`none`}),{validate:async t=>{let n=await e.safeParseAsync(t);return n.success?{success:!0,value:n.data}:{success:!1,error:n.error}}})}function ur(e,t){let i=t?.useReferences??!1;return ir(()=>on(n(e,{target:`draft-7`,io:`input`,reused:i?`ref`:`inline`})),{validate:async t=>{let n=await r(e,t);return n.success?{success:!0,value:n.data}:{success:!1,error:n.error}}})}function dr(e){return`_zod`in e}function fr(e,t){return dr(e)?ur(e,t):lr(e,t)}async function pr({value:e,schema:t,context:n}){let r=await mr({value:e,schema:t,context:n});if(!r.success)throw E.wrap({value:e,cause:r.error,context:n});return r.value}async function mr({value:e,schema:t,context:n}){let r=or(t);try{if(r.validate==null)return{success:!0,value:e,rawValue:e};let t=await r.validate(e);return t.success?{success:!0,value:t.value,rawValue:e}:{success:!1,error:E.wrap({value:e,cause:t.error,context:n}),rawValue:e}}catch(t){return{success:!1,error:E.wrap({value:e,cause:t,context:n}),rawValue:e}}}async function I({text:e,schema:t}){try{let n=an(e);return t==null?{success:!0,value:n,rawValue:n}:await mr({value:n,schema:t})}catch(t){return{success:!1,error:Pt.isInstance(t)?t:new Pt({text:e,cause:t}),rawValue:void 0}}}function hr({stream:e,schema:t}){return e.pipeThrough(new TextDecoderStream).pipeThrough(new qt).pipeThrough(new TransformStream({async transform({data:e},n){e!==`[DONE]`&&n.enqueue(await I({text:e,schema:t}))}}))}async function L(e){return typeof e==`function`&&(e=e()),Promise.resolve(e)}new TextDecoder;var gr=Object.defineProperty,_r=(e,t)=>{for(var n in t)gr(e,n,{get:t[n],enumerable:!0})},vr=`AI_NoObjectGeneratedError`,yr=`vercel.ai.error.${vr}`,br=Symbol.for(yr),xr,R=class extends T{constructor({message:e=`No object generated.`,cause:t,text:n,response:r,usage:i,finishReason:a}){super({name:vr,message:e,cause:t}),this[xr]=!0,this.text=n,this.response=r,this.usage=i,this.finishReason=a}static isInstance(e){return T.hasMarker(e,yr)}};xr=br;var Sr=`AI_UIMessageStreamError`,Cr=`vercel.ai.error.${Sr}`,wr=Symbol.for(Cr),Tr,z=class extends T{constructor({chunkType:e,chunkId:t,message:n}){super({name:Sr,message:n}),this[Tr]=!0,this.chunkType=e,this.chunkId=t}static isInstance(e){return T.hasMarker(e,Cr)}};Tr=wr;function Er(e,t){if(e===void 0&&t===void 0)return;if(e===void 0)return t;if(t===void 0)return e;let n={...e};for(let r in t)if(r!==`__proto__`&&r!==`constructor`&&r!==`prototype`&&Object.prototype.hasOwnProperty.call(t,r)){let i=t[r];if(i===void 0)continue;let a=r in e?e[r]:void 0,o=typeof i==`object`&&!!i&&!Array.isArray(i)&&!(i instanceof Date)&&!(i instanceof RegExp),s=typeof a==`object`&&!!a&&!Array.isArray(a)&&!(a instanceof Date)&&!(a instanceof RegExp);n[r]=o&&s?Er(a,i):i}return n}var B={array:_,boolean:o,custom:d,discriminatedUnion:v,enum:p,instanceof:g,lazy:s,literal:h,looseObject:f,never:l,null:u,number:c,object:i,record:ee,string:y,union:a,unknown:te},V=B.lazy(()=>B.union([B.null(),B.string(),B.number(),B.boolean(),B.record(B.string(),V.optional()),B.array(V)])),H=B.record(B.string(),B.record(B.string(),V.optional())),U=B.union([B.string(),B.instanceof(Uint8Array),B.instanceof(ArrayBuffer),B.custom($t,{message:`Must be a Buffer`})]),Dr=B.record(B.string(),B.string()),Or=B.object({type:B.literal(`text`),text:B.string(),providerOptions:H.optional()}),kr=B.object({type:B.literal(`image`),image:B.union([U,B.instanceof(URL),Dr]),mediaType:B.string().optional(),providerOptions:H.optional()}),Ar=B.discriminatedUnion(`type`,[B.object({type:B.literal(`data`),data:U}),B.object({type:B.literal(`url`),url:B.instanceof(URL)}),B.object({type:B.literal(`reference`),reference:Dr}),B.object({type:B.literal(`text`),text:B.string()})]),jr=B.discriminatedUnion(`type`,[B.object({type:B.literal(`data`),data:U}),B.object({type:B.literal(`url`),url:B.instanceof(URL)})]),Mr=B.object({type:B.literal(`file`),data:B.union([Ar,U,B.instanceof(URL),Dr]),filename:B.string().optional(),mediaType:B.string(),providerOptions:H.optional()}),Nr=B.object({type:B.literal(`reasoning`),text:B.string(),providerOptions:H.optional()}),Pr=B.object({type:B.literal(`custom`),kind:B.string().transform(e=>e),providerOptions:H.optional()}),Fr=B.object({type:B.literal(`reasoning-file`),data:B.union([jr,U,B.instanceof(URL)]),mediaType:B.string(),providerOptions:H.optional()}),Ir=B.object({type:B.literal(`tool-call`),toolCallId:B.string(),toolName:B.string(),input:B.unknown(),providerOptions:H.optional(),providerExecuted:B.boolean().optional()}),Lr=B.discriminatedUnion(`type`,[B.object({type:B.literal(`text`),value:B.string(),providerOptions:H.optional()}),B.object({type:B.literal(`json`),value:V,providerOptions:H.optional()}),B.object({type:B.literal(`execution-denied`),reason:B.string().optional(),providerOptions:H.optional()}),B.object({type:B.literal(`error-text`),value:B.string(),providerOptions:H.optional()}),B.object({type:B.literal(`error-json`),value:V,providerOptions:H.optional()}),B.object({type:B.literal(`content`),value:B.array(B.union([B.object({type:B.literal(`text`),text:B.string(),providerOptions:H.optional()}),B.object({type:B.literal(`file`),data:Ar,mediaType:B.string(),filename:B.string().optional(),providerOptions:H.optional()}),B.object({type:B.literal(`file-data`),data:B.string(),mediaType:B.string(),filename:B.string().optional(),providerOptions:H.optional()}),B.object({type:B.literal(`file-url`),url:B.string(),mediaType:B.string().optional(),providerOptions:H.optional()}),B.object({type:B.literal(`file-id`),fileId:B.union([B.string(),B.record(B.string(),B.string())]),providerOptions:H.optional()}),B.object({type:B.literal(`file-reference`),providerReference:B.record(B.string(),B.string()),providerOptions:H.optional()}),B.object({type:B.literal(`image-data`),data:B.string(),mediaType:B.string(),providerOptions:H.optional()}),B.object({type:B.literal(`image-url`),url:B.string(),providerOptions:H.optional()}),B.object({type:B.literal(`image-file-id`),fileId:B.union([B.string(),B.record(B.string(),B.string())]),providerOptions:H.optional()}),B.object({type:B.literal(`image-file-reference`),providerReference:B.record(B.string(),B.string()),providerOptions:H.optional()}),B.object({type:B.literal(`custom`),providerOptions:H.optional()})]))})]),Rr=B.object({type:B.literal(`tool-result`),toolCallId:B.string(),toolName:B.string(),output:Lr,providerOptions:H.optional()}),zr=B.object({type:B.literal(`tool-approval-request`),approvalId:B.string(),toolCallId:B.string()}),Br=B.object({type:B.literal(`tool-approval-response`),approvalId:B.string(),approved:B.boolean(),reason:B.string().optional()}),Vr=B.object({role:B.literal(`system`),content:B.string(),providerOptions:H.optional()}),Hr=B.object({role:B.literal(`user`),content:B.union([B.string(),B.array(B.union([Or,kr,Mr]))]),providerOptions:H.optional()}),Ur=B.object({role:B.literal(`assistant`),content:B.union([B.string(),B.array(B.union([Or,Pr,Mr,Nr,Fr,Ir,Rr,zr]))]),providerOptions:H.optional()}),Wr=B.object({role:B.literal(`tool`),content:B.array(B.union([Rr,Br])),providerOptions:H.optional()});B.union([Vr,Hr,Ur,Wr]),_r({},{array:()=>Jr,choice:()=>Yr,json:()=>Xr,object:()=>qr,text:()=>Kr});function Gr(e){let t=[`ROOT`],n=-1,r=null,i=0;function a(e){return e>=`0`&&e<=`9`||e>=`A`&&e<=`F`||e>=`a`&&e<=`f`}function o(e,i,a){switch(e){case`"`:n=i,t.pop(),t.push(a),t.push(`INSIDE_STRING`);break;case`f`:case`t`:case`n`:n=i,r=i,t.pop(),t.push(a),t.push(`INSIDE_LITERAL`);break;case`-`:t.pop(),t.push(a),t.push(`INSIDE_NUMBER`);break;case`0`:case`1`:case`2`:case`3`:case`4`:case`5`:case`6`:case`7`:case`8`:case`9`:n=i,t.pop(),t.push(a),t.push(`INSIDE_NUMBER`);break;case`{`:n=i,t.pop(),t.push(a),t.push(`INSIDE_OBJECT_START`);break;case`[`:n=i,t.pop(),t.push(a),t.push(`INSIDE_ARRAY_START`)}}function s(e,r){switch(e){case`,`:t.pop(),t.push(`INSIDE_OBJECT_AFTER_COMMA`);break;case`}`:n=r,t.pop()}}function c(e,r){switch(e){case`,`:t.pop(),t.push(`INSIDE_ARRAY_AFTER_COMMA`);break;case`]`:n=r,t.pop()}}for(let l=0;l<e.length;l++){let u=e[l];switch(t[t.length-1]){case`ROOT`:o(u,l,`FINISH`);break;case`INSIDE_OBJECT_START`:switch(u){case`"`:t.pop(),t.push(`INSIDE_OBJECT_KEY`);break;case`}`:n=l,t.pop()}break;case`INSIDE_OBJECT_AFTER_COMMA`:u===`"`&&(t.pop(),t.push(`INSIDE_OBJECT_KEY`));break;case`INSIDE_OBJECT_KEY`:u===`"`&&(t.pop(),t.push(`INSIDE_OBJECT_AFTER_KEY`));break;case`INSIDE_OBJECT_AFTER_KEY`:u===`:`&&(t.pop(),t.push(`INSIDE_OBJECT_BEFORE_VALUE`));break;case`INSIDE_OBJECT_BEFORE_VALUE`:o(u,l,`INSIDE_OBJECT_AFTER_VALUE`);break;case`INSIDE_OBJECT_AFTER_VALUE`:s(u,l);break;case`INSIDE_STRING`:switch(u){case`"`:t.pop(),n=l;break;case`\\`:t.push(`INSIDE_STRING_ESCAPE`);break;default:n=l}break;case`INSIDE_ARRAY_START`:switch(u){case`]`:n=l,t.pop();break;default:n=l,o(u,l,`INSIDE_ARRAY_AFTER_VALUE`)}break;case`INSIDE_ARRAY_AFTER_VALUE`:switch(u){case`,`:t.pop(),t.push(`INSIDE_ARRAY_AFTER_COMMA`);break;case`]`:n=l,t.pop();break;default:n=l}break;case`INSIDE_ARRAY_AFTER_COMMA`:o(u,l,`INSIDE_ARRAY_AFTER_VALUE`);break;case`INSIDE_STRING_ESCAPE`:t.pop(),u===`u`?(i=0,t.push(`INSIDE_STRING_UNICODE_ESCAPE`)):n=l;break;case`INSIDE_STRING_UNICODE_ESCAPE`:a(u)&&(i++,i===4&&(t.pop(),n=l));break;case`INSIDE_NUMBER`:switch(u){case`0`:case`1`:case`2`:case`3`:case`4`:case`5`:case`6`:case`7`:case`8`:case`9`:n=l;break;case`e`:case`E`:case`-`:case`.`:break;case`,`:t.pop(),t[t.length-1]===`INSIDE_ARRAY_AFTER_VALUE`&&c(u,l),t[t.length-1]===`INSIDE_OBJECT_AFTER_VALUE`&&s(u,l);break;case`}`:t.pop(),t[t.length-1]===`INSIDE_OBJECT_AFTER_VALUE`&&s(u,l);break;case`]`:t.pop(),t[t.length-1]===`INSIDE_ARRAY_AFTER_VALUE`&&c(u,l);break;default:t.pop()}break;case`INSIDE_LITERAL`:{let i=e.substring(r,l+1);!`false`.startsWith(i)&&!`true`.startsWith(i)&&!`null`.startsWith(i)?(t.pop(),t[t.length-1]===`INSIDE_OBJECT_AFTER_VALUE`?s(u,l):t[t.length-1]===`INSIDE_ARRAY_AFTER_VALUE`&&c(u,l)):n=l;break}}}let l=e.slice(0,n+1);for(let n=t.length-1;n>=0;n--)switch(t[n]){case`INSIDE_STRING`:l+=`"`;break;case`INSIDE_OBJECT_KEY`:case`INSIDE_OBJECT_AFTER_KEY`:case`INSIDE_OBJECT_AFTER_COMMA`:case`INSIDE_OBJECT_START`:case`INSIDE_OBJECT_BEFORE_VALUE`:case`INSIDE_OBJECT_AFTER_VALUE`:l+=`}`;break;case`INSIDE_ARRAY_START`:case`INSIDE_ARRAY_AFTER_COMMA`:case`INSIDE_ARRAY_AFTER_VALUE`:l+=`]`;break;case`INSIDE_LITERAL`:{let t=e.substring(r,e.length);`true`.startsWith(t)?l+=`true`.slice(t.length):`false`.startsWith(t)?l+=`false`.slice(t.length):`null`.startsWith(t)&&(l+=`null`.slice(t.length))}}return l}async function W(e){if(e===void 0)return{value:void 0,state:`undefined-input`};let t=await I({text:e});return t.success?{value:t.value,state:`successful-parse`}:(t=await I({text:Gr(e)}),t.success?{value:t.value,state:`repaired-parse`}:{value:void 0,state:`failed-parse`})}var Kr=()=>({name:`text`,responseFormat:Promise.resolve({type:`text`}),async parseCompleteOutput({text:e}){return e},async parsePartialOutput({text:e}){return{partial:e}},createElementStreamTransform(){}}),qr=({schema:e,name:t,description:n})=>{let r=or(e);return{name:`object`,responseFormat:L(r.jsonSchema).then(e=>({type:`json`,schema:e,...t!=null&&{name:t},...n!=null&&{description:n}})),async parseCompleteOutput({text:e},t){let n=await I({text:e});if(!n.success)throw new R({message:`No object generated: could not parse the response.`,cause:n.error,text:e,response:t.response,usage:t.usage,finishReason:t.finishReason});let i=await mr({value:n.value,schema:r});if(!i.success)throw new R({message:`No object generated: response did not match schema.`,cause:i.error,text:e,response:t.response,usage:t.usage,finishReason:t.finishReason});return i.value},async parsePartialOutput({text:e}){let t=await W(e);switch(t.state){case`failed-parse`:case`undefined-input`:return;case`repaired-parse`:case`successful-parse`:return{partial:t.value}}},createElementStreamTransform(){}}},Jr=({element:e,name:t,description:n})=>{let r=or(e);return{name:`array`,responseFormat:L(r.jsonSchema).then(e=>{let{$schema:r,definitions:i,$defs:a,...o}=e;return{type:`json`,schema:{$schema:`http://json-schema.org/draft-07/schema#`,...i!=null&&{definitions:i},...a!=null&&{$defs:a},type:`object`,properties:{elements:{type:`array`,items:o}},required:[`elements`],additionalProperties:!1},...t!=null&&{name:t},...n!=null&&{description:n}}}),async parseCompleteOutput({text:e},t){let n=await I({text:e});if(!n.success)throw new R({message:`No object generated: could not parse the response.`,cause:n.error,text:e,response:t.response,usage:t.usage,finishReason:t.finishReason});let i=n.value;if(typeof i!=`object`||!i||!(`elements`in i)||!Array.isArray(i.elements))throw new R({message:`No object generated: response did not match schema.`,cause:new E({value:i,cause:`response must be an object with an elements array`}),text:e,response:t.response,usage:t.usage,finishReason:t.finishReason});let a=[];for(let n of i.elements){let i=await mr({value:n,schema:r});if(!i.success)throw new R({message:`No object generated: response did not match schema.`,cause:i.error,text:e,response:t.response,usage:t.usage,finishReason:t.finishReason});a.push(i.value)}return a},async parsePartialOutput({text:e}){let t=await W(e);switch(t.state){case`failed-parse`:case`undefined-input`:return;case`repaired-parse`:case`successful-parse`:{let e=t.value;if(typeof e!=`object`||!e||!(`elements`in e)||!Array.isArray(e.elements))return;let n=t.state===`repaired-parse`&&e.elements.length>0?e.elements.slice(0,-1):e.elements,i=[];for(let e of n){let t=await mr({value:e,schema:r});t.success&&i.push(t.value)}return{partial:i}}}},createElementStreamTransform(){let e=0;return new TransformStream({transform({partialOutput:t},n){if(t!=null)for(;e<t.length;e++)n.enqueue(t[e])}})}}},Yr=({options:e,name:t,description:n})=>({name:`choice`,responseFormat:Promise.resolve({type:`json`,schema:{$schema:`http://json-schema.org/draft-07/schema#`,type:`object`,properties:{result:{type:`string`,enum:e}},required:[`result`],additionalProperties:!1},...t!=null&&{name:t},...n!=null&&{description:n}}),async parseCompleteOutput({text:t},n){let r=await I({text:t});if(!r.success)throw new R({message:`No object generated: could not parse the response.`,cause:r.error,text:t,response:n.response,usage:n.usage,finishReason:n.finishReason});let i=r.value;if(typeof i!=`object`||!i||!(`result`in i)||typeof i.result!=`string`||!e.includes(i.result))throw new R({message:`No object generated: response did not match schema.`,cause:new E({value:i,cause:`response must be an object that contains a choice value.`}),text:t,response:n.response,usage:n.usage,finishReason:n.finishReason});return i.result},async parsePartialOutput({text:t}){let n=await W(t);switch(n.state){case`failed-parse`:case`undefined-input`:return;case`repaired-parse`:case`successful-parse`:{let t=n.value;if(typeof t!=`object`||!t||!(`result`in t)||typeof t.result!=`string`)return;let r=e.filter(e=>e.startsWith(t.result));return n.state===`successful-parse`?r.includes(t.result)?{partial:t.result}:void 0:r.length===1?{partial:r[0]}:void 0}}},createElementStreamTransform(){}}),Xr=({name:e,description:t}={})=>({name:`json`,responseFormat:Promise.resolve({type:`json`,...e!=null&&{name:e},...t!=null&&{description:t}}),async parseCompleteOutput({text:e},t){let n=await I({text:e});if(!n.success)throw new R({message:`No object generated: could not parse the response.`,cause:n.error,text:e,response:t.response,usage:t.usage,finishReason:t.finishReason});return n.value},async parsePartialOutput({text:e}){let t=await W(e);switch(t.state){case`failed-parse`:case`undefined-input`:return;case`repaired-parse`:case`successful-parse`:return t.value===void 0?void 0:{partial:t.value}}},createElementStreamTransform(){}});new TextEncoder,new TextEncoder,O({prefix:`aitxt`,size:24}),O({prefix:`call`,size:24}),TransformStream;var G=B.record(B.string(),V.optional()),Zr=rr(()=>fr(B.union([B.looseObject({type:B.literal(`text-start`),id:B.string(),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`text-delta`),id:B.string(),delta:B.string(),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`text-end`),id:B.string(),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`error`),errorText:B.string()}),B.looseObject({type:B.literal(`tool-input-start`),toolCallId:B.string(),toolName:B.string(),providerExecuted:B.boolean().optional(),providerMetadata:H.optional(),toolMetadata:G.optional(),dynamic:B.boolean().optional(),title:B.string().optional()}),B.looseObject({type:B.literal(`tool-input-delta`),toolCallId:B.string(),inputTextDelta:B.string()}),B.looseObject({type:B.literal(`tool-input-available`),toolCallId:B.string(),toolName:B.string(),input:B.unknown(),providerExecuted:B.boolean().optional(),providerMetadata:H.optional(),toolMetadata:G.optional(),dynamic:B.boolean().optional(),title:B.string().optional()}),B.looseObject({type:B.literal(`tool-input-error`),toolCallId:B.string(),toolName:B.string(),input:B.unknown(),providerExecuted:B.boolean().optional(),providerMetadata:H.optional(),toolMetadata:G.optional(),dynamic:B.boolean().optional(),errorText:B.string(),title:B.string().optional()}),B.looseObject({type:B.literal(`tool-approval-request`),approvalId:B.string(),toolCallId:B.string(),isAutomatic:B.boolean().optional(),signature:B.string().optional()}),B.looseObject({type:B.literal(`tool-approval-response`),approvalId:B.string(),approved:B.boolean(),reason:B.string().optional(),providerExecuted:B.boolean().optional(),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`tool-output-available`),toolCallId:B.string(),output:B.unknown(),providerExecuted:B.boolean().optional(),providerMetadata:H.optional(),toolMetadata:G.optional(),dynamic:B.boolean().optional(),preliminary:B.boolean().optional()}),B.looseObject({type:B.literal(`tool-output-error`),toolCallId:B.string(),errorText:B.string(),providerExecuted:B.boolean().optional(),providerMetadata:H.optional(),toolMetadata:G.optional(),dynamic:B.boolean().optional()}),B.looseObject({type:B.literal(`tool-output-denied`),toolCallId:B.string()}),B.looseObject({type:B.literal(`reasoning-start`),id:B.string(),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`reasoning-delta`),id:B.string(),delta:B.string(),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`reasoning-end`),id:B.string(),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`custom`),kind:B.string().transform(e=>e),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`source-url`),sourceId:B.string(),url:B.string(),title:B.string().optional(),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`source-document`),sourceId:B.string(),mediaType:B.string(),title:B.string(),filename:B.string().optional(),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`file`),url:B.string(),mediaType:B.string(),providerMetadata:H.optional()}),B.looseObject({type:B.literal(`reasoning-file`),url:B.string(),mediaType:B.string(),providerMetadata:H.optional()}),B.looseObject({type:B.custom(e=>typeof e==`string`&&e.startsWith(`data-`),{message:`Type must start with "data-"`}),id:B.string().optional(),data:B.unknown(),transient:B.boolean().optional()}),B.looseObject({type:B.literal(`start-step`)}),B.looseObject({type:B.literal(`finish-step`)}),B.looseObject({type:B.literal(`reset-step`)}),B.looseObject({type:B.literal(`start`),messageId:B.string().optional(),messageMetadata:B.unknown().optional()}),B.looseObject({type:B.literal(`finish`),finishReason:B.enum([`stop`,`length`,`content-filter`,`tool-calls`,`error`,`other`]).optional(),messageMetadata:B.unknown().optional()}),B.looseObject({type:B.literal(`abort`),reason:B.string().optional()}),B.looseObject({type:B.literal(`message-metadata`),messageMetadata:B.unknown()})])));function Qr(e){return e.type.startsWith(`data-`)}function K(){return Object.create(null)}function $r(e){return e.type===`text`}function ei(e){return e.type.startsWith(`tool-`)}function ti(e){return e.type===`dynamic-tool`}function q(e){return ei(e)||ti(e)}function ni(e){return e.type.split(`-`).slice(1).join(`-`)}function ri(e){return ti(e)?e.toolName:ni(e)}function ii({lastMessage:e,messageId:t}){return{message:e?.role===`assistant`?e:{id:t,metadata:void 0,role:`assistant`,parts:[]},activeTextParts:K(),activeReasoningParts:K(),partialToolCalls:K()}}function ai({stream:e,messageMetadataSchema:t,dataPartSchemas:n,runUpdateMessageJob:r,onError:i,onToolCall:a,onData:o}){return e.pipeThrough(new TransformStream({async transform(e,s){await r(async({state:r,write:c})=>{function l(){let e=r.message.parts,t=e.length-1;for(;t>=0&&e[t].type!==`step-start`;)t--;return e.slice(t+1)}function u(){return l().filter(q)}function d(e){let t=u().find(t=>t.toolCallId===e);if(t==null){let n=r.message.parts;for(let r=n.length-1;r>=0;r--){let i=n[r];if(q(i)&&i.toolCallId===e){t=i;break}}}if(t==null)throw new z({chunkType:`tool-invocation`,chunkId:e,message:`No tool invocation found for tool call ID "${e}".`});return t}function f(e){let t=r.message.parts.filter(q).find(t=>t.approval?.id===e);if(t==null)throw new z({chunkType:`tool-approval-response`,chunkId:e,message:`No tool invocation found for approval ID "${e}".`});return t}function p(e,t){let n=t??l().find(t=>ei(t)&&t.toolCallId===e.toolCallId),i=e,a=n;if(n!=null){n.state=e.state,a.input=i.input,a.output=i.output,a.errorText=i.errorText,a.rawInput=i.rawInput,a.preliminary=i.preliminary,e.title!==void 0&&(a.title=e.title),e.toolMetadata!==void 0&&(a.toolMetadata=e.toolMetadata),a.providerExecuted=i.providerExecuted??n.providerExecuted;let t=i.providerMetadata;if(t!=null){if(e.state===`output-available`||e.state===`output-error`){let e=n;e.resultProviderMetadata=t}else n.callProviderMetadata=t}}else r.message.parts.push({type:`tool-${e.toolName}`,toolCallId:e.toolCallId,state:e.state,title:e.title,...e.toolMetadata===void 0?{}:{toolMetadata:e.toolMetadata},input:i.input,output:i.output,rawInput:i.rawInput,errorText:i.errorText,providerExecuted:i.providerExecuted,preliminary:i.preliminary,...i.providerMetadata!=null&&(e.state===`output-available`||e.state===`output-error`)?{resultProviderMetadata:i.providerMetadata}:{},...i.providerMetadata!=null&&e.state!==`output-available`&&e.state!==`output-error`?{callProviderMetadata:i.providerMetadata}:{}})}function m(e,t){let n=t??l().find(t=>t.type===`dynamic-tool`&&t.toolCallId===e.toolCallId),i=e,a=n;if(n!=null){n.state=e.state,a.toolName=e.toolName,a.input=i.input,a.output=i.output,a.errorText=i.errorText,a.rawInput=i.rawInput??a.rawInput,a.preliminary=i.preliminary,e.title!==void 0&&(a.title=e.title),e.toolMetadata!==void 0&&(a.toolMetadata=e.toolMetadata),a.providerExecuted=i.providerExecuted??n.providerExecuted;let t=i.providerMetadata;if(t!=null){if(e.state===`output-available`||e.state===`output-error`){let e=n;e.resultProviderMetadata=t}else n.callProviderMetadata=t}}else r.message.parts.push({type:`dynamic-tool`,toolName:e.toolName,toolCallId:e.toolCallId,state:e.state,input:i.input,output:i.output,errorText:i.errorText,preliminary:i.preliminary,providerExecuted:i.providerExecuted,title:e.title,...e.toolMetadata===void 0?{}:{toolMetadata:e.toolMetadata},...i.providerMetadata!=null&&(e.state===`output-available`||e.state===`output-error`)?{resultProviderMetadata:i.providerMetadata}:{},...i.providerMetadata!=null&&e.state!==`output-available`&&e.state!==`output-error`?{callProviderMetadata:i.providerMetadata}:{}})}async function h(e){if(e!=null){let n=r.message.metadata==null?e:Er(r.message.metadata,e);t!=null&&await pr({value:n,schema:t,context:{field:`message.metadata`,entityId:r.message.id}}),r.message.metadata=n}}switch(e.type){case`text-start`:{let t={type:`text`,text:``,providerMetadata:e.providerMetadata,state:`streaming`};r.activeTextParts[e.id]=t,r.message.parts.push(t),c();break}case`text-delta`:{let t=r.activeTextParts[e.id];if(t==null)throw new z({chunkType:`text-delta`,chunkId:e.id,message:`Received text-delta for missing text part with ID "${e.id}". Ensure a "text-start" chunk is sent before any "text-delta" chunks.`});t.text+=e.delta,t.providerMetadata=e.providerMetadata??t.providerMetadata,c();break}case`text-end`:{let t=r.activeTextParts[e.id];if(t==null)throw new z({chunkType:`text-end`,chunkId:e.id,message:`Received text-end for missing text part with ID "${e.id}". Ensure a "text-start" chunk is sent before any "text-end" chunks.`});t.state=`done`,t.providerMetadata=e.providerMetadata??t.providerMetadata,delete r.activeTextParts[e.id],c();break}case`custom`:{let t={type:`custom`,kind:e.kind,providerMetadata:e.providerMetadata};r.message.parts.push(t),c();break}case`reasoning-start`:{let t={type:`reasoning`,id:e.id,text:``,providerMetadata:e.providerMetadata,state:`streaming`};r.activeReasoningParts[e.id]=t,r.message.parts.push(t),c();break}case`reasoning-delta`:{let t=r.activeReasoningParts[e.id];if(t==null)throw new z({chunkType:`reasoning-delta`,chunkId:e.id,message:`Received reasoning-delta for missing reasoning part with ID "${e.id}". Ensure a "reasoning-start" chunk is sent before any "reasoning-delta" chunks.`});t.text+=e.delta,t.providerMetadata=e.providerMetadata??t.providerMetadata,c();break}case`reasoning-end`:{let t=r.activeReasoningParts[e.id];if(t==null)throw new z({chunkType:`reasoning-end`,chunkId:e.id,message:`Received reasoning-end for missing reasoning part with ID "${e.id}". Ensure a "reasoning-start" chunk is sent before any "reasoning-end" chunks.`});t.providerMetadata=e.providerMetadata??t.providerMetadata,t.state=`done`,delete r.activeReasoningParts[e.id],c();break}case`file`:case`reasoning-file`:r.message.parts.push({type:e.type,mediaType:e.mediaType,url:e.url,...e.providerMetadata==null?{}:{providerMetadata:e.providerMetadata}}),c();break;case`source-url`:r.message.parts.push({type:`source-url`,sourceId:e.sourceId,url:e.url,title:e.title,providerMetadata:e.providerMetadata}),c();break;case`source-document`:r.message.parts.push({type:`source-document`,sourceId:e.sourceId,mediaType:e.mediaType,title:e.title,filename:e.filename,providerMetadata:e.providerMetadata}),c();break;case`tool-input-start`:{let t=l().filter(ei);r.partialToolCalls[e.toolCallId]={text:``,toolName:e.toolName,index:t.length,dynamic:e.dynamic,title:e.title,toolMetadata:e.toolMetadata},e.dynamic?m({toolCallId:e.toolCallId,toolName:e.toolName,state:`input-streaming`,input:void 0,providerExecuted:e.providerExecuted,title:e.title,toolMetadata:e.toolMetadata,providerMetadata:e.providerMetadata}):p({toolCallId:e.toolCallId,toolName:e.toolName,state:`input-streaming`,input:void 0,providerExecuted:e.providerExecuted,title:e.title,toolMetadata:e.toolMetadata,providerMetadata:e.providerMetadata}),c();break}case`tool-input-delta`:{let t=r.partialToolCalls[e.toolCallId];if(t==null)throw new z({chunkType:`tool-input-delta`,chunkId:e.toolCallId,message:`Received tool-input-delta for missing tool call with ID "${e.toolCallId}". Ensure a "tool-input-start" chunk is sent before any "tool-input-delta" chunks.`});t.text+=e.inputTextDelta;let{value:n}=await W(t.text);t.dynamic?m({toolCallId:e.toolCallId,toolName:t.toolName,state:`input-streaming`,input:n,title:t.title,toolMetadata:t.toolMetadata}):p({toolCallId:e.toolCallId,toolName:t.toolName,state:`input-streaming`,input:n,title:t.title,toolMetadata:t.toolMetadata}),c();break}case`tool-input-available`:e.dynamic?m({toolCallId:e.toolCallId,toolName:e.toolName,state:`input-available`,input:e.input,providerExecuted:e.providerExecuted,providerMetadata:e.providerMetadata,title:e.title,toolMetadata:e.toolMetadata}):p({toolCallId:e.toolCallId,toolName:e.toolName,state:`input-available`,input:e.input,providerExecuted:e.providerExecuted,providerMetadata:e.providerMetadata,title:e.title,toolMetadata:e.toolMetadata}),c(),a&&!e.providerExecuted&&await a({toolCall:e});break;case`tool-input-error`:{let t=l().filter(q).find(t=>t.toolCallId===e.toolCallId);(t==null?e.dynamic:t.type===`dynamic-tool`)?m({toolCallId:e.toolCallId,toolName:e.toolName,state:`output-error`,input:e.input,errorText:e.errorText,providerExecuted:e.providerExecuted,providerMetadata:e.providerMetadata,toolMetadata:e.toolMetadata}):p({toolCallId:e.toolCallId,toolName:e.toolName,state:`output-error`,input:void 0,rawInput:e.input,errorText:e.errorText,providerExecuted:e.providerExecuted,providerMetadata:e.providerMetadata,toolMetadata:e.toolMetadata}),c();break}case`tool-approval-request`:{let t=d(e.toolCallId);t.state=`approval-requested`,t.approval={id:e.approvalId,...e.isAutomatic===!0?{isAutomatic:!0}:{},...e.signature==null?{}:{signature:e.signature}},c();break}case`tool-approval-response`:{let t=f(e.approvalId),n=t.approval==null?{id:e.approvalId}:t.approval;t.state=`approval-responded`,t.approval={id:e.approvalId,approved:e.approved,...e.reason==null?{}:{reason:e.reason},...n.isAutomatic===!0?{isAutomatic:!0}:{},...n.signature==null?{}:{signature:n.signature}},e.providerExecuted!=null&&(t.providerExecuted=e.providerExecuted),e.providerMetadata!=null&&(t.callProviderMetadata=e.providerMetadata),c();break}case`tool-output-denied`:{let t=d(e.toolCallId);t.state=`output-denied`,c();break}case`tool-output-available`:{let t=d(e.toolCallId);t.type===`dynamic-tool`?m({toolCallId:e.toolCallId,toolName:t.toolName,state:`output-available`,input:t.input,output:e.output,preliminary:e.preliminary,providerExecuted:e.providerExecuted,providerMetadata:e.providerMetadata,title:t.title,toolMetadata:t.toolMetadata},t):p({toolCallId:e.toolCallId,toolName:ni(t),state:`output-available`,input:t.input,output:e.output,providerExecuted:e.providerExecuted,preliminary:e.preliminary,providerMetadata:e.providerMetadata,title:t.title,toolMetadata:t.toolMetadata},t),c();break}case`tool-output-error`:{let t=d(e.toolCallId);t.type===`dynamic-tool`?m({toolCallId:e.toolCallId,toolName:t.toolName,state:`output-error`,input:t.input,errorText:e.errorText,providerExecuted:e.providerExecuted,providerMetadata:e.providerMetadata,title:t.title,toolMetadata:t.toolMetadata},t):p({toolCallId:e.toolCallId,toolName:ni(t),state:`output-error`,input:t.input,rawInput:t.rawInput,errorText:e.errorText,providerExecuted:e.providerExecuted,providerMetadata:e.providerMetadata,title:t.title,toolMetadata:t.toolMetadata},t),c();break}case`start-step`:r.message.parts.push({type:`step-start`});break;case`finish-step`:r.activeTextParts=K(),r.activeReasoningParts=K();break;case`reset-step`:{let e=l();r.activeTextParts=K(),r.activeReasoningParts=K(),r.partialToolCalls=K(),e.length>0&&(r.message.parts.splice(r.message.parts.length-e.length,e.length),c());break}case`start`:e.messageId!=null&&(r.message.id=e.messageId),await h(e.messageMetadata),(e.messageId!=null||e.messageMetadata!=null)&&c({updateStatus:!1});break;case`finish`:e.finishReason!=null&&(r.finishReason=e.finishReason),await h(e.messageMetadata),e.messageMetadata!=null&&c();break;case`message-metadata`:await h(e.messageMetadata),e.messageMetadata!=null&&c();break;case`error`:i?.(Error(e.errorText));break;default:if(Qr(e)){if(n?.[e.type]!=null){let t=r.message.parts.findIndex(t=>`id`in t&&`data`in t&&t.id===e.id&&t.type===e.type),i=t>=0?t:r.message.parts.length;await pr({value:e.data,schema:n[e.type],context:{field:`message.parts[${i}].data`,entityName:e.type,entityId:e.id}})}let t=e;if(t.transient){o?.(t);break}let i=t.id==null?void 0:r.message.parts.find(e=>t.type===e.type&&t.id===e.id);i==null?r.message.parts.push(t):i.data=t.data,o?.(t),c()}}s.enqueue(e)})}}))}async function oi({stream:e,onError:t,abortSignal:n}){let r=e.getReader(),i=()=>{r.cancel().catch(()=>{})};n?.aborted?i():n?.addEventListener(`abort`,i,{once:!0});try{for(;;){let{done:e}=await r.read();if(e)break}}catch(e){t?.(e)}finally{n?.removeEventListener(`abort`,i),r.releaseLock()}}O({prefix:`aitxt`,size:24}),O({prefix:`call`,size:24}),O({prefix:`aitxt`,size:24}),O({prefix:`call`,size:24}),B.record(B.string(),V.optional()),B.record(B.string(),B.string()),O({prefix:`call`,size:24}),O({prefix:`call`,size:24}),O({prefix:`aiobj`,size:24});var si=class{constructor(){this.queue=[],this.isProcessing=!1}async processQueue(){if(!this.isProcessing){for(this.isProcessing=!0;this.queue.length>0;)await this.queue[0](),this.queue.shift();this.isProcessing=!1}}async run(e){return new Promise((t,n)=>{this.queue.push(async()=>{try{await e(),t()}catch(e){n(e)}}),this.processQueue()})}};O({prefix:`aiobj`,size:24}),O({prefix:`call`,size:24});async function ci(e){if(e==null)return[];if(!globalThis.FileList||!(e instanceof globalThis.FileList))throw Error(`FileList is not supported in the current environment`);return Promise.all(Array.from(e).map(async e=>{let{name:t,type:n}=e;return{type:`file`,mediaType:n,filename:t,url:await new Promise((t,n)=>{let r=new FileReader;r.onload=e=>{t(e.target?.result)},r.onerror=e=>n(e),r.readAsDataURL(e)})}}))}var li=class{constructor({api:e=`/api/chat`,credentials:t,headers:n,body:r,fetch:i,prepareSendMessagesRequest:a,prepareReconnectToStreamRequest:o}){this.api=e,this.credentials=t,this.headers=n,this.body=r,this.fetch=i,this.prepareSendMessagesRequest=a,this.prepareReconnectToStreamRequest=o}async sendMessages({abortSignal:e,...t}){let n=await L(this.body),r=await L(this.headers),i=await L(this.credentials),a={...k(r),...k(t.headers)},o=await this.prepareSendMessagesRequest?.call(this,{api:this.api,id:t.chatId,messages:t.messages,body:{...n,...t.body},headers:a,credentials:i,requestMetadata:t.metadata,trigger:t.trigger,messageId:t.messageId}),s=o?.api??this.api,c=o?.headers===void 0?a:k(o.headers),l=o?.body===void 0?{...n,...t.body,id:t.chatId,messages:t.messages,trigger:t.trigger,messageId:t.messageId}:o.body,u=o?.credentials??i,d=await(this.fetch??globalThis.fetch)(s,{method:`POST`,headers:{"Content-Type":`application/json`,...c},body:JSON.stringify(l),credentials:u,signal:e});if(!d.ok)throw Error(await d.text()??`Failed to fetch the chat response.`);if(!d.body)throw Error(`The response body is empty.`);return this.processResponseStream(d.body)}async reconnectToStream(e){let t=await L(this.body),n=await L(this.headers),r=await L(this.credentials),i={...k(n),...k(e.headers)},a=await this.prepareReconnectToStreamRequest?.call(this,{api:this.api,id:e.chatId,body:{...t,...e.body},headers:i,credentials:r,requestMetadata:e.metadata}),o=a?.api??`${this.api}/${e.chatId}/stream`,s=a?.headers===void 0?i:k(a.headers),c=a?.credentials??r,l=await(this.fetch??globalThis.fetch)(o,{method:`GET`,headers:s,credentials:c,signal:e.abortSignal});if(l.status===204)return null;if(!l.ok)throw Error(await l.text()??`Failed to fetch the chat response.`);if(!l.body)throw Error(`The response body is empty.`);return this.processResponseStream(l.body)}},ui=class extends li{constructor(e={}){super(e)}processResponseStream(e){return hr({stream:e,schema:Zr}).pipeThrough(new TransformStream({async transform(e,t){if(!e.success)throw e.error;t.enqueue(e.value)}}))}},di=class{constructor({generateId:e=Qt,id:t=e(),transport:n=new ui,messageMetadataSchema:r,dataPartSchemas:i,state:a,onError:o,onToolCall:s,onFinish:c,onData:l,sendAutomaticallyWhen:u}){this.pendingMessagePreparations=new Set,this.activeResponse=void 0,this.activeResumeRequest=void 0,this.jobExecutor=new si,this.sendMessage=async(e,t)=>{if(e==null){await this.makeRequest({trigger:`submit-message`,messageId:this.lastMessage?.id,...t});return}let n;if(`text`in e||`files`in e){let t=new AbortController;this.pendingMessagePreparations.add(t);let r;try{r=Array.isArray(e.files)?e.files:await ci(e.files)}finally{this.pendingMessagePreparations.delete(t)}if(t.signal.aborted)return;n={parts:[...r,...`text`in e&&e.text!=null?[{type:`text`,text:e.text}]:[]]}}else n=e;if(e.messageId!=null){let t=this.state.messages.findIndex(t=>t.id===e.messageId);if(t===-1)throw Error(`message with id ${e.messageId} not found`);if(this.state.messages[t].role!==`user`)throw Error(`message with id ${e.messageId} is not a user message`);this.state.messages=this.state.messages.slice(0,t+1),this.state.replaceMessage(t,{...n,id:e.messageId,role:n.role??`user`,metadata:e.metadata})}else this.state.pushMessage({...n,id:n.id??this.generateId(),role:n.role??`user`,metadata:e.metadata});await this.makeRequest({trigger:`submit-message`,messageId:e.messageId,...t})},this.regenerate=async({messageId:e,...t}={})=>{let n=e==null?this.state.messages.length-1:this.state.messages.findIndex(t=>t.id===e);if(n===-1)throw Error(`message ${e} not found`);this.state.messages=this.state.messages.slice(0,this.messages[n].role===`assistant`?n:n+1),await this.makeRequest({trigger:`regenerate-message`,messageId:e,...t})},this.resumeStream=async(e={})=>{await this.makeRequest({trigger:`resume-stream`,...e})},this.clearError=()=>{this.status===`error`&&(this.state.error=void 0,this.setStatus({status:`ready`}))},this.addToolApprovalResponse=async({id:e,approved:t,reason:n,options:r})=>this.jobExecutor.run(async()=>{let i=this.state.messages,a=i[i.length-1],o=r=>q(r)&&r.state===`approval-requested`&&r.approval.id===e?{...r,state:`approval-responded`,approval:{...r.approval,id:e,approved:t,reason:n}}:r;this.state.replaceMessage(i.length-1,{...a,parts:a.parts.map(o)}),this.activeResponse&&(this.activeResponse.state.message.parts=this.activeResponse.state.message.parts.map(o)),this.status!==`streaming`&&this.status!==`submitted`&&this.sendAutomaticallyWhen&&this.shouldSendAutomatically().then(e=>{e&&this.makeRequest({trigger:`submit-message`,messageId:this.lastMessage?.id,...r})})}),this.addToolOutput=async({state:e=`output-available`,toolCallId:t,output:n,errorText:r,options:i})=>this.jobExecutor.run(async()=>{let a=this.state.messages,o=a[a.length-1],s=i=>q(i)&&i.toolCallId===t?{...i,state:e,output:n,errorText:r}:i;this.state.replaceMessage(a.length-1,{...o,parts:o.parts.map(s)}),this.activeResponse&&(this.activeResponse.state.message.parts=this.activeResponse.state.message.parts.map(s)),this.status!==`streaming`&&this.status!==`submitted`&&this.sendAutomaticallyWhen&&this.shouldSendAutomatically().then(e=>{e&&this.makeRequest({trigger:`submit-message`,messageId:this.lastMessage?.id,...i})})}),this.addToolResult=this.addToolOutput,this.stop=async()=>{var e,t;for(let e of this.pendingMessagePreparations)e.abort();(e=this.activeResumeRequest)==null||e.abortController.abort(),(t=this.activeResponse)==null||t.abortController.abort()},this.id=t,this.transport=n,this.generateId=e,this.messageMetadataSchema=r,this.dataPartSchemas=i,this.state=a,this.onError=o,this.onToolCall=s,this.onFinish=c,this.onData=l,this.sendAutomaticallyWhen=u}get status(){return this.state.status}setStatus({status:e,error:t}){this.status!==e&&(this.state.status=e,this.state.error=t)}get error(){return this.state.error}get messages(){return this.state.messages}get lastMessage(){return this.state.messages[this.state.messages.length-1]}set messages(e){this.state.messages=e}async shouldSendAutomatically(){if(!this.sendAutomaticallyWhen)return!1;let e=this.sendAutomaticallyWhen({messages:this.state.messages});return e&&typeof e==`object`&&`then`in e?await e:e}async makeRequest({trigger:e,metadata:t,headers:n,body:r,messageId:i}){var a,o;let s=new AbortController,c=e===`resume-stream`?{abortController:s}:void 0;c&&((a=this.activeResumeRequest)==null||a.abortController.abort(),this.activeResumeRequest=c);let l=()=>c==null||this.activeResumeRequest===c,u=()=>{this.activeResumeRequest===c&&(this.activeResumeRequest=void 0)},d;if(e===`resume-stream`)try{let e=await this.transport.reconnectToStream({chatId:this.id,abortSignal:s.signal,metadata:t,headers:n,body:r});if(s.signal.aborted||!l()){await e?.cancel().catch(()=>{}),l()&&this.setStatus({status:`ready`}),u();return}if(e==null){this.setStatus({status:`ready`}),u();return}d=e}catch(e){if(s.signal.aborted||e.name===`AbortError`){l()&&this.setStatus({status:`ready`}),u();return}if(!l())return;this.onError&&e instanceof Error&&this.onError(e),this.setStatus({status:`error`,error:e}),u();return}this.setStatus({status:`submitted`,error:void 0});let f=this.lastMessage,p=!1,m=!1,h=!1,g;try{let a={state:ii({lastMessage:e===`resume-stream`||e===`regenerate-message`?void 0:this.state.snapshot(f),messageId:this.generateId()}),abortController:s};g=a,a.abortController.signal.addEventListener(`abort`,()=>{p=!0}),this.activeResponse=a;let o;if(o=e===`resume-stream`?d:await this.transport.sendMessages({chatId:this.id,messages:this.state.messages,abortSignal:a.abortController.signal,metadata:t,headers:n,body:r,trigger:e,messageId:i}),await oi({stream:ai({stream:o,onToolCall:this.onToolCall,onData:this.onData,messageMetadataSchema:this.messageMetadataSchema,dataPartSchemas:this.dataPartSchemas,runUpdateMessageJob:e=>this.jobExecutor.run(()=>a.abortController.signal.aborted?Promise.resolve():e({state:a.state,write:({updateStatus:e=!0}={})=>{a.abortController.signal.aborted||(e&&this.setStatus({status:`streaming`}),a.state.message.id===this.lastMessage?.id?this.state.replaceMessage(this.state.messages.length-1,a.state.message):this.state.pushMessage(a.state.message))}})),onError:e=>{throw e}}),abortSignal:a.abortController.signal,onError:e=>{throw e}}),p)return l()&&this.setStatus({status:`ready`}),null;l()&&this.setStatus({status:`ready`})}catch(e){if(p||e.name===`AbortError`)return p=!0,l()&&this.setStatus({status:`ready`}),null;if(!l())return null;h=!0,e instanceof TypeError&&(e.message.toLowerCase().includes(`fetch`)||e.message.toLowerCase().includes(`network`))&&(m=!0),this.onError&&e instanceof Error&&this.onError(e),this.setStatus({status:`error`,error:e})}finally{try{g&&((o=this.onFinish)==null||o.call(this,{message:g.state.message,messages:this.state.messages,isAbort:p,isDisconnect:m,isError:h,finishReason:g.state.finishReason}))}finally{this.activeResponse===g&&(this.activeResponse=void 0),u()}}!h&&await this.shouldSendAutomatically()&&await this.makeRequest({trigger:`submit-message`,messageId:this.lastMessage?.id,metadata:t,headers:n,body:r})}};function fi({messages:e}){let t=e[e.length-1];if(!t||t.role!==`assistant`)return!1;let n=t.parts.reduce((e,t,n)=>t.type===`step-start`?n:e,-1),r=t.parts.slice(n+1).filter(q).filter(e=>!e.providerExecuted);return r.length>0&&r.every(e=>e.state===`output-available`||e.state===`output-error`)}function pi(e){return new ui({api:ye(`/`,`Chat/Messages/`),credentials:`include`,body:{orgId:e}})}var mi=e(t(((e,t)=>{function n(e,t){if(typeof e!=`function`)throw TypeError(`Expected the first argument to be a \`function\`, got \`${typeof e}\`.`);let n,r=0;return function(...i){clearTimeout(n);let a=Date.now(),o=t-(a-r);o<=0?(r=a,e.apply(this,i)):n=setTimeout(()=>{r=Date.now(),e.apply(this,i)},o)}}t.exports=n}))(),1),hi=(e,t,n)=>{if(!t.has(e))throw TypeError(`Cannot `+n)},J=(e,t,n)=>(hi(e,t,`read from private field`),n?n.call(e):t.get(e)),Y=(e,t,n)=>{if(t.has(e))throw TypeError(`Cannot add the same private member more than once`);t instanceof WeakSet?t.add(e):t.set(e,n)},X=(e,t,n,r)=>(hi(e,t,`write to private field`),r?r.call(e,n):t.set(e,n),n);function gi(e,t){return t==null?e:(0,mi.default)(e,t)}function _i(e){return Array.isArray(e)?[...e]:typeof e==`object`&&e&&(Object.getPrototypeOf(e)===Object.prototype||Object.getPrototypeOf(e)===null)?{...e}:e}var Z,vi,yi,bi,xi,Si,Q,Ci,wi,Ti=class{constructor(e=[]){Y(this,Z,void 0),Y(this,vi,`ready`),Y(this,yi,void 0),Y(this,bi,new Set),Y(this,xi,new Set),Y(this,Si,new Set),this.pushMessage=e=>{X(this,Z,J(this,Z).concat(e)),J(this,Q).call(this)},this.popMessage=()=>{X(this,Z,J(this,Z).slice(0,-1)),J(this,Q).call(this)},this.replaceMessage=(e,t)=>{X(this,Z,[...J(this,Z).slice(0,e),this.snapshot(t),...J(this,Z).slice(e+1)]),J(this,Q).call(this)},this.snapshot=e=>{if(typeof e!=`object`||!e||!(`parts`in e)||!Array.isArray(e.parts))return e;let t=e,n={...t,parts:t.parts.map(e=>({...e}))};return`metadata`in t&&(n.metadata=_i(t.metadata)),n},this[`~registerMessagesCallback`]=(e,t)=>{let n=t?gi(e,t):e;return J(this,bi).add(n),()=>{J(this,bi).delete(n)}},this[`~registerStatusCallback`]=e=>(J(this,xi).add(e),()=>{J(this,xi).delete(e)}),this[`~registerErrorCallback`]=e=>(J(this,Si).add(e),()=>{J(this,Si).delete(e)}),Y(this,Q,()=>{J(this,bi).forEach(e=>e())}),Y(this,Ci,()=>{J(this,xi).forEach(e=>e())}),Y(this,wi,()=>{J(this,Si).forEach(e=>e())}),X(this,Z,e)}get status(){return J(this,vi)}set status(e){X(this,vi,e),J(this,Ci).call(this)}get error(){return J(this,yi)}set error(e){X(this,yi,e),J(this,wi).call(this)}get messages(){return J(this,Z)}set messages(e){X(this,Z,[...e]),J(this,Q).call(this)}};Z=new WeakMap,vi=new WeakMap,yi=new WeakMap,bi=new WeakMap,xi=new WeakMap,Si=new WeakMap,Q=new WeakMap,Ci=new WeakMap,wi=new WeakMap;var $,Ei=class extends di{constructor({messages:e,...t}){let n=new Ti(e);super({...t,state:n}),Y(this,$,void 0),this[`~registerMessagesCallback`]=(e,t)=>J(this,$)[`~registerMessagesCallback`](e,t),this[`~registerStatusCallback`]=e=>J(this,$)[`~registerStatusCallback`](e),this[`~registerErrorCallback`]=e=>J(this,$)[`~registerErrorCallback`](e),X(this,$,n)}};$=new WeakMap;function Di({throttle:e,experimental_throttle:t,resume:n=!1,...r}={}){let i=e??t,a=(0,C.useRef)({});`chat`in r||(a.current={onToolCall:r.onToolCall,onData:r.onData,onFinish:r.onFinish,onError:r.onError,sendAutomaticallyWhen:r.sendAutomaticallyWhen,transport:r.transport});let o,s=()=>a.current.transport??(o??=new ui),c={...r,transport:{sendMessages:e=>s().sendMessages(e),reconnectToStream:e=>s().reconnectToStream(e)},onToolCall:e=>{var t;return(t=a.current).onToolCall?.call(t,e)},onData:e=>{var t;return(t=a.current).onData?.call(t,e)},onFinish:e=>{var t;return(t=a.current).onFinish?.call(t,e)},onError:e=>{var t;return(t=a.current).onError?.call(t,e)},sendAutomaticallyWhen:e=>{var t;return(t=a.current).sendAutomaticallyWhen?.call(t,e)??!1}},l=(0,C.useRef)(`chat`in r?r.chat:new Ei(c));(`chat`in r&&r.chat!==l.current||`id`in r&&r.id!=null&&l.current.id!==r.id)&&(l.current=`chat`in r?r.chat:new Ei(c));let u=l.current,d=(0,C.useRef)({chat:u,messages:u.messages});d.current.chat!==u&&(d.current={chat:u,messages:u.messages});let f=(0,C.useCallback)(e=>{let t=!0,n=u[`~registerMessagesCallback`](()=>{!t||d.current.chat!==u||(d.current={chat:u,messages:u.messages},e())},i);return d.current={chat:u,messages:u.messages},()=>{t=!1,n()}},[u,i]),p=(0,C.useCallback)(()=>d.current.messages,[]),m=(0,C.useSyncExternalStore)(f,p,p),h=(0,C.useCallback)(e=>u[`~registerStatusCallback`](()=>{d.current.chat===u&&((u.status===`ready`||u.status===`error`)&&(d.current={chat:u,messages:u.messages}),e())}),[u]),g=(0,C.useCallback)(()=>u.status,[u]),_=(0,C.useSyncExternalStore)(h,g,g),v=(0,C.useSyncExternalStore)(l.current[`~registerErrorCallback`],()=>l.current.error,()=>l.current.error),ee=(0,C.useCallback)(e=>{typeof e==`function`&&(e=e(l.current.messages)),l.current.messages=e},[l]);return(0,C.useEffect)(()=>{n&&l.current.resumeStream()},[n,l]),{id:l.current.id,messages:m,setMessages:ee,sendMessage:l.current.sendMessage,regenerate:l.current.regenerate,clearError:l.current.clearError,stop:l.current.stop,error:v,resumeStream:l.current.resumeStream,status:_,addToolResult:l.current.addToolOutput,addToolOutput:l.current.addToolOutput,addToolApprovalResponse:l.current.addToolApprovalResponse}}function Oi({input:e,setInput:t,onSubmit:n,disabled:r,autoFocus:i}){let a=(0,C.useRef)(null);return(0,C.useEffect)(()=>{i&&!r&&a.current?.focus()},[i,r]),(0,w.jsxs)(`form`,{onSubmit:n,className:`input-area`,children:[(0,w.jsx)(`input`,{ref:a,value:e,onChange:e=>t(e.target.value),placeholder:`Type a message...`,disabled:r}),(0,w.jsx)(`button`,{type:`submit`,disabled:r||!e.trim(),children:(0,w.jsx)(pt,{size:18})})]})}function ki(){return(0,w.jsxs)(`div`,{className:`loading-state`,children:[(0,w.jsx)(ze,{className:`animate-spin`,size:24}),(0,w.jsx)(`p`,{children:`Loading conversation...`})]})}var Ai={name:`collectFeedback`,description:`Collects feedback from the user by fetching a link to a pre-populated GitHub Discussion. Use this if the user lets us know we did something well, or if the user seems frustrated, or wants to report a bug.`,inputSchema:i({feedbackSummary:y().describe(`A brief summary of the feedback, used as the discussion title.`),feedbackDetails:y().describe(`Detailed feedback from the user or agent observation.`),recap:y().describe(`A sanitized recap of what the agent and user did together and if it was successful. No sensitive information.`)})};async function ji({input:{feedbackSummary:e,feedbackDetails:t,recap:n}}){let r=e,i=`${t}\n\n${n}`;return{success:!0,url:`https://github.com/HarperFast/harper-agent/discussions/new?category=usage-feedback&title=${encodeURIComponent(r)}&body=${encodeURIComponent(i)}`,message:`Feedback URL created! Ask the user to open it in their browser, and they will be brought to a form to approve the details of the feedback.`}}var Mi={...Ai,icon:ft,execute:ji},Ni={name:`createApp`,description:`Create a new Harper app with the specified name and template type.`,inputSchema:i({name:y().trim(),type:p(be)})};async function Pi({input:{name:e,type:t},instanceClientParams:n,baseURL:r}){let i=qe(e),a=ve(me,`id`,t);if(!a)return{success:!1,message:`Error: Invalid template type, ${t}, please choose from: ${me.map(e=>e.id).join(`, `)}`};let o=le.loading(`Creating from template...`,{description:`This may take a bit.`,duration:3e5});try{await Ce({...n,project:i,template:a.npm||a.githubUrl})}catch(e){return{success:!1,message:`Error: ${e}`}}je(`ReloadApplicationRootEntries`,!0),le.loading(`Created successfully!`,{description:`${i} created! Restarting the HTTP service...`,id:o,duration:3e5});try{await tt({...n,operation:`restart_service`,replicated:n.entityType===`cluster`})}catch(e){return{success:!1,message:`Error: ${e}`}}return le.success(`Created successfully!`,{description:`${i} created!`,id:o,duration:5e3}),{success:!0,message:`App "${i}" created successfully.`,webURL:r}}var Fi={...Ni,icon:et,execute:Pi,requiresApproval:!0},Ii={name:`deleteTableRecords`,description:`Deletes records in a particular table in a particular database on the server by their primary keys.`,inputSchema:i({database:y().trim(),table:y().trim(),primaryKeys:_(y())})};async function Li({input:{database:e,table:t,primaryKeys:n},instanceClientParams:r,params:i}){try{let a=await We({...r,databaseName:e,tableName:t,hashValues:n}),{databaseName:o,tableName:s}=i;return await Xe.invalidateQueries({queryKey:[r.entityId,o,s]}),{success:!0,data:a}}catch(e){return{success:!1,message:`Error: ${e}`}}}var Ri={...Ii,icon:ot,execute:Li,requiresApproval:!0},zi={name:`dropComponentFile`,description:`Drops a component file by its full path (which was returned by getComponents)`,inputSchema:i({path:y().trim()})};async function Bi({input:{path:e},instanceClientParams:t}){try{let n=e.split(`/`),r=n.shift(),i=n.join(`/`);return{success:!0,data:await pe({...t,file:i,project:r})}}catch(e){return{success:!1,message:`Error: ${e}`}}}var Vi={...zi,icon:Ue,execute:Bi,requiresApproval:!0},Hi={name:`getAnalytics`,description:`Retrieves analytics metrics for the server, such as CPU usage or database operations (reads, writes, messages).`,inputSchema:i({metricName:y().describe(`The name of the metric to retrieve.`),startTime:c().describe(`The start of the time range for the metric, in milliseconds since the Unix epoch.`),endTime:c().describe(`The end of the time range for the metric, in milliseconds since the Unix epoch.`)})};async function Ui({input:e,instanceClientParams:t}){try{let{metricName:n,startTime:r,endTime:i}=e;return{success:!0,data:await at({metric:n,startTime:r,endTime:i,instanceParams:t})}}catch(e){return{success:!1,message:`Error retrieving analytics: ${e}`}}}var Wi={...Hi,icon:ct,execute:Ui},Gi={name:`getComponentFile`,description:`Returns the contents of a component file by its full path (which was returned by getComponents)`,inputSchema:i({path:y().trim()})};async function Ki({input:{path:e},instanceClientParams:t}){try{let n=e.split(`/`),r=n.shift(),i=n.join(`/`);return{success:!0,data:await Ye({...t,file:i,project:r})}}catch(e){return{success:!1,message:`Error: ${e}`}}}var qi={...Gi,icon:he,execute:Ki},Ji={name:`getComponents`,description:`Retrieves a tree of all the component (files and folders) names and sizes stored on the server.`,inputSchema:i({})};async function Yi({instanceClientParams:e}){try{let t=await Ge(e),{rootEntries:n}=xe(t.entries);return{success:!0,items:_e(n).items}}catch(e){return{success:!1,message:`Error: ${e}`}}}var Xi={...Ji,icon:ge,execute:Yi},Zi={name:`getDescribeAll`,description:`Retrieves a map of the names of databases and their tables stored on the server.`,inputSchema:i({})};async function Qi({instanceClientParams:e}){try{return{success:!0,map:await $e(e)}}catch(e){return{success:!1,message:`Error: ${e}`}}}var $i={...Zi,icon:Je,execute:Qi},ea={name:`getDescribeTable`,description:`Returns the schema metadata describing a particular table in a particular database on the server.`,inputSchema:i({database:y().trim(),table:y().trim()})};async function ta({input:{database:e,table:t},instanceClientParams:n}){try{return{success:!0,data:await Le({...n,databaseName:e,tableName:t})}}catch(e){return{success:!1,message:`Error: ${e}`}}}var na={...ea,icon:Ze,execute:ta},ra={name:`getUserContext`,description:`Retrieves the context of what the user is looking at on their screen, such as the current page, the file they are viewing, the database and table visible to them, that sort of thing.`,inputSchema:i({})};async function ia({instanceClientParams:e,params:t}){let n=Oe();if(n.includes(`/databases`)){let{databaseName:e,tableName:n}=t;return{success:!0,description:`viewing the database`,data:{databaseName:e,tableName:n}}}if(n.endsWith(`/apis`))return{success:!0,description:`viewing the APIs`};if(n.endsWith(`/status`))return{success:!0,description:`viewing the status graphs`};if(n.endsWith(`/logs`))return{success:!0,description:`viewing the logs`};if(n.includes(`/config/`))return{success:!0,description:`viewing the configuration pages`};let r=ce(`FileFocused/${e.entityId}`,void 0),i=ce(`FolderOpened/${e.entityId}`,[]),a=ce(`FileSelected/${e.entityId}`,[]);return r?{success:!0,description:`editing application files`,data:{openedPath:r,expandedItems:i,selectedItems:a}}:{success:!0,description:n}}var aa={...ra,icon:Ve,execute:ia},oa={name:`insertTableRecords`,description:`Inserts one or more records into a particular table in a particular database on the server.`,inputSchema:i({database:y().trim(),table:y().trim(),records:_(m())})};async function sa({input:{database:e,table:t,records:n},instanceClientParams:r,params:i}){try{let a=await Re({...r,databaseName:e,tableName:t,records:n}),{databaseName:o,tableName:s}=i;return await Xe.invalidateQueries({queryKey:[r.entityId,o,s]}),{success:!0,data:a}}catch(e){return{success:!1,message:`Error: ${e}`}}}var ca={...oa,icon:ot,execute:sa,requiresApproval:!0},la={name:`listAnalyticsMetrics`,description:`Lists the available analytics metric names available for calling getAnalytics upon.`,inputSchema:i({metricTypes:p([`builtin`,`custom`]),customWindowMS:c().optional().describe(`Default to one week time window for finding custom metrics.`)})};async function ua({metricTypes:e,customWindowMS:t,instanceParams:n}){let{data:r}=await n.instanceClient.post(`/`,{operation:`list_analytics_metrics`,metricTypes:e,customWindowMS:t});return r}async function da({input:e,instanceClientParams:t}){try{let{metricTypes:n,customWindowMS:r}=e;return{success:!0,metricNames:await ua({metricTypes:n,customWindowMS:r,instanceParams:t})}}catch(e){return{success:!1,message:`Error retrieving analytics: ${e}`}}}var fa={...la,icon:ct,execute:da},pa=[`adding-tables-with-schemas`,`automatic-apis`,`caching`,`checking-authentication`,`creating-a-fabric-account-and-cluster`,`creating-harper-apps`,`custom-resources`,`defining-relationships`,`delegating-to-the-built-in-agent`,`deploying-to-harper-fabric`,`extending-tables`,`handling-binary-data`,`load-env`,`logging`,`programmatic-table-requests`,`querying-rest-apis`,`real-time-apps`,`schema-design-tooling`,`serving-web-content`,`typescript-type-stripping`,`using-blob-datatype`,`v5-upgrade`,`vector-indexing`],ma={"adding-tables-with-schemas":"---\nname: adding-tables-with-schemas\ndescription: Guidelines for adding tables to a Harper database using GraphQL schemas.\nmetadata:\n  mode: synthesized\n---\n\n# Adding Tables with Schemas\n\nInstructions for the agent to follow when adding tables to a Harper database.\n\n## When to Use\n\nUse this skill when you need to define new data structures or modify existing ones in a Harper database.\n\n## How It Works\n\n1. **Create Dedicated Schema Files**: Prefer having a dedicated schema `.graphql` file for each table. Check the `config.yaml` file under `graphqlSchema.files` to see how it's configured. It typically accepts wildcards (e.g., `schemas/*.graphql`), but may be configured to point at a single file.\n2. **Use Directives**: All available directives for defining your schema are defined in `node_modules/harper/schema.graphql`. Common directives include `@table`, `@export`, `@primaryKey`, `@indexed`, and `@relationship`.\n3. **Define Relationships**: Link tables together using the `@relationship` directive. For more details, see the [Defining Relationships](defining-relationships.md) skill.\n4. **Enable Automatic APIs**: If you add `@table @export` to a schema type, Harper automatically sets up REST and WebSocket APIs for basic CRUD operations against that table. **Important**: REST endpoints also require `rest: true` in `config.yaml` — without it, `@export`ed tables will not respond to HTTP requests. For a detailed list of available endpoints and how to use them, see the [Automatic REST APIs](automatic-apis.md) skill.\n   - `GET /{TableName}`: Describes the schema itself.\n   - `GET /{TableName}/`: Lists all records (supports filtering, sorting, and pagination via query parameters). See the [Querying REST APIs](querying-rest-apis.md) skill for details.\n   - `GET /{TableName}/{id}`: Retrieves a single record by its ID.\n   - `POST /{TableName}/`: Creates a new record.\n   - `PUT /{TableName}/{id}`: Updates an existing record.\n   - `PATCH /{TableName}/{id}`: Performs a partial update on a record.\n   - `DELETE /{TableName}/`: Deletes all records or filtered records.\n   - `DELETE /{TableName}/{id}`: Deletes a single record by its ID.\n5. **Consider Table Extensions**: If you are going to [extend the table](./extending-tables.md) in your resources, then do not `@export` the table from the schema.\n\n## Examples\n\nIn a hypothetical `schemas/ExamplePerson.graphql`:\n\n```graphql\ntype ExamplePerson @table @export {\n	id: ID @primaryKey\n	name: String\n	tag: String @indexed\n}\n```\n","automatic-apis":`---
-name: automatic-apis
-description: How to use Harper's automatically generated REST and WebSocket APIs.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/rest/overview.md
-    - reference/v5/rest/websockets.md
-  sourceCommit: 3749d0c54be457a2a65d9a63c738a5dc88989ecd
-  inputHash: 6c7013b1307d9f7b
----
-
-# Automatic APIs
-
-Instructions for the agent to follow when enabling and using Harper's automatically generated REST and WebSocket APIs.
-
-## When to Use
-
-Apply this rule when adding REST or WebSocket API access to Harper tables or custom resources. Use it when configuring \`config.yaml\` to expose endpoints, mapping HTTP methods to resource operations, or implementing real-time WebSocket connections on a resource class.
-
-## How It Works
-
-1. **Enable the REST plugin**: Add \`rest: true\` to your application's \`config.yaml\`. This activates the HTTP REST interface on the application server port (default \`9926\`) and enables WebSocket support automatically.
-
-   \`\`\`yaml
-   rest: true
-   \`\`\`
-
-   To configure options explicitly:
-
-   \`\`\`yaml
-   rest:
-     lastModified: true # enables Last-Modified response header support
-     webSocket: false # disables automatic WebSocket support (enabled by default)
-   \`\`\`
-
-2. **Export your resource in the schema**: Tables are not exposed by default. Use the \`@export\` directive in your schema definition to expose a table as a REST endpoint. The exported name defines the base URL path.
-
-3. **Use the correct URL structure**: Target resources using these path conventions:
-
-   | Path                                         | Description                                                 |
-   | -------------------------------------------- | ----------------------------------------------------------- |
-   | \`/my-resource\`                               | Returns resource metadata                                   |
-   | \`/my-resource/\`                              | Collection — all records; append query parameters to search |
-   | \`/my-resource/record-id\`                     | Specific record by primary key                              |
-   | \`/my-resource/record-id/\`                    | Collection of records with the given id prefix              |
-   | \`/my-resource/record-id/with/multiple/parts\` | Record id with multiple path segments                       |
-
-4. **Map operations to HTTP methods**: Each HTTP method maps to a resource method:
-   - **GET** — Retrieve a record or search. Calls \`get()\`. Responses include an \`ETag\` header; send \`If-None-Match\` on subsequent requests to receive \`304 Not Modified\` when unchanged.
-   - **PUT** — Create or replace a record (upsert). Calls \`put(record)\`. The stored record exactly matches the submitted body; omitted properties are removed.
-   - **POST** — Create a record without specifying a primary key. Calls \`post(data)\`. The assigned key is returned in the \`Location\` response header.
-   - **PATCH** — Partially update a record, merging only provided top-level properties. Calls the resource's patch handler. Merge is **shallow** — nested objects are replaced entirely, not deep-merged.
-   - **DELETE** — Delete a record by id or all records matching a query.
-
-5. **Connect via WebSocket**: A WebSocket connection to a resource URL subscribes to that resource and streams change events. See [real-time-apps.md](real-time-apps.md) for full real-time patterns.
-
-   \`\`\`javascript
-   let ws = new WebSocket('wss://server/my-resource/341');
-   ws.onmessage = (event) => {
-   	let data = JSON.parse(event.data);
-   };
-   \`\`\`
-
-6. **Implement a custom \`connect()\` handler** on a resource class to control WebSocket behavior. The method receives \`incomingMessages\` and must return an async iterable producing messages to send to the client.
-
-7. **Retrieve the OpenAPI spec**: Harper auto-generates an OpenAPI specification for all exported resources, available at:
-
-   \`\`\`
-   GET /openapi
-   \`\`\`
-
-## Examples
-
-**Simple echo WebSocket server**:
-
-\`\`\`javascript
-export class Echo extends Resource {
-	async *connect(incomingMessages) {
-		for await (let message of incomingMessages) {
-			yield message; // echo each message back
-		}
-	}
-}
-\`\`\`
-
-**Custom \`connect()\` using the default iterable with \`send()\` and \`close\` event**:
-
-\`\`\`javascript
-export class Example extends Resource {
-	connect(incomingMessages) {
-		let outgoingMessages = super.connect();
-
-		let timer = setInterval(() => {
-			outgoingMessages.send({ greeting: 'hi again!' });
-		}, 1000);
-
-		incomingMessages.on('data', (message) => {
-			outgoingMessages.send(message); // echo incoming messages
-		});
-
-		outgoingMessages.on('close', () => {
-			clearInterval(timer);
-		});
-
-		return outgoingMessages;
-	}
-}
-\`\`\`
-
-**Common REST operations**:
-
-\`\`\`
-GET /MyTable/123
-GET /MyTable/?name=Harper
-PUT /MyTable/123
-PATCH /MyTable/123
-DELETE /MyTable/?status=archived
-\`\`\`
-
-\`\`\`json
-{ "name": "some data" }
-\`\`\`
-
-## Notes
-
-- \`rest: true\` is the minimal config to enable both REST and WebSocket support. Set \`webSocket: false\` under the \`rest\` key to disable WebSocket only.
-- The \`@export\` directive in the schema is required for any table to appear as a REST endpoint — tables are not exported by default.
-- PATCH merges are shallow (top-level only). Nested objects in the request body replace the entire existing sub-object. Dot-path keys (e.g., \`"settings.theme"\`) are stored as literal keys, not interpreted as paths.
-- For MQTT over WebSocket, set the sub-protocol header \`Sec-WebSocket-Protocol: mqtt\`.
-- In distributed environments, non-retained messages are delivered in arrival order; retained messages (PUT/updated records) keep only the latest timestamp as the winning record.
-- For full query syntax on GET and DELETE, see [querying-rest-apis.md](querying-rest-apis.md).
-- For building real-time features with WebSocket subscriptions, see [real-time-apps.md](real-time-apps.md).
-`,caching:`---
-name: caching
-description: How to implement integrated data caching in Harper from external sources.
-metadata:
-  mode: generate
-  sources:
-    - learn/developers/caching-with-harper.md
-  sourceCommit: 4fe4c9c95e0974eaa77032f6f10e36fbd8ec64ac
-  inputHash: 60ad55fa37b5eec5
----
-
-# Caching External Data Sources in Harper
-
-Instructions for the agent to implement integrated data caching from external sources using Harper's cache table directives and \`sourcedFrom\` API.
-
-## When to Use
-
-Apply this rule when an application needs to wrap an external API, microservice, or database with a fast local cache. Use it when you need to define TTL-based cache expiration, connect an upstream data source to a Harper table, or implement on-demand cache invalidation.
-
-## How It Works
-
-1. **Define a cache table with \`expiration\`**: Add the \`expiration\` argument to the \`@table\` directive in \`schema.graphql\`. The value is in seconds. When a record becomes stale, the next request fetches a fresh copy from the upstream source.
-
-   \`\`\`graphql
-   type JokeCache @table(expiration: 60) @export {
-   	id: ID @primaryKey
-   	setup: String
-   	punchline: String
-   }
-   \`\`\`
-
-2. **Implement an upstream source object**: In \`resources.js\`, create an object with a \`get(id)\` method that fetches data from the external API.
-
-   \`\`\`javascript
-   const jokeAPI = {
-   	async get(id) {
-   		const response = await fetch(\`https://official-joke-api.appspot.com/jokes/\${id}\`);
-   		return response.json();
-   	},
-   };
-   \`\`\`
-
-3. **Connect the source with \`sourcedFrom\`**: Call \`sourcedFrom\` on the table to register the upstream source. Harper will call \`jokeAPI.get()\` automatically when a record is missing or stale.
-
-   \`\`\`javascript
-   tables.JokeCache.sourcedFrom(jokeAPI);
-   \`\`\`
-
-   Harper's request flow after \`sourcedFrom\` is registered:
-   - Request arrives for \`/JokeCache/1\`.
-   - Harper checks if the record exists and is not stale.
-   - If fresh, Harper returns it immediately.
-   - If missing or stale, Harper calls \`jokeAPI.get()\`, stores the result in \`JokeCache\`, and returns it.
-   - Multiple simultaneous requests for the same missing or stale record wait on a single upstream call — Harper prevents cache stampedes automatically.
-
-4. **Configure plugins in \`config.yaml\`**: Enable \`graphqlSchema\`, \`rest\`, and \`jsResource\`.
-
-   \`\`\`yaml
-   graphqlSchema:
-     files: 'schema.graphql'
-   rest: true
-   jsResource:
-     files: 'resources.js'
-   \`\`\`
-
-5. **Implement on-demand invalidation**: To invalidate a cache entry before its TTL expires, export a class extending the table and call \`this.invalidate(target)\` in a \`post\` handler. Remove \`@export\` from the schema when using this pattern — the exported class provides the endpoint.
-
-   \`\`\`javascript
-   export class JokeCache extends tables.JokeCache {
-   	static async post(target, data) {
-   		const body = await data;
-   		if (body?.action === 'invalidate') {
-   			this.invalidate(target);
-   			return { status: 200, data: { message: 'invalidated' } };
-   		}
-   	}
-   }
-   \`\`\`
-
-   Update the schema to remove \`@export\`:
-
-   \`\`\`graphql
-   type JokeCache @table(expiration: 60) {
-   	id: ID @primaryKey
-   	setup: String
-   	punchline: String
-   }
-   \`\`\`
-
-## Examples
-
-**Complete \`resources.js\`**:
-
-\`\`\`javascript
-// resources.js
-
-const jokeAPI = {
-	async get(id) {
-		const response = await fetch(\`https://official-joke-api.appspot.com/jokes/\${id}\`);
-		return response.json();
-	},
-};
-
-tables.JokeCache.sourcedFrom(jokeAPI);
-
-export class JokeCache extends tables.JokeCache {
-	static async post(target, data) {
-		const body = await data;
-		if (body?.action === 'invalidate') {
-			this.invalidate(target);
-			return { status: 200, data: { message: 'invalidated' } };
-		}
-	}
-}
-\`\`\`
-
-**Complete \`schema.graphql\`**:
-
-\`\`\`graphql
-type JokeCache @table(expiration: 60) {
-	id: ID @primaryKey
-	setup: String
-	punchline: String
-}
-\`\`\`
-
-**Fetch a cached record**:
-
-\`\`\`javascript
-const response = await fetch('http://localhost:9926/JokeCache/1');
-console.log(response.status); // 200
-const etag = response.headers.get('etag'); // e.g. "abCDefGHij"
-const joke = await response.json();
-\`\`\`
-
-**Use ETag for conditional requests** (returns \`304 Not Modified\` if unchanged):
-
-\`\`\`javascript
-const second = await fetch('http://localhost:9926/JokeCache/1', {
-	headers: { 'If-None-Match': etag },
-});
-console.log(second.status); // 304
-\`\`\`
-
-**Bypass the cache with \`Cache-Control: no-cache\`**:
-
-\`\`\`javascript
-const response = await fetch('http://localhost:9926/JokeCache/1', {
-	headers: { 'Cache-Control': 'no-cache' },
-});
-\`\`\`
-
-**Trigger invalidation via POST**:
-
-\`\`\`javascript
-await fetch('http://localhost:9926/JokeCache/1', {
-	method: 'POST',
-	headers: { 'Content-Type': 'application/json' },
-	body: JSON.stringify({ action: 'invalidate' }),
-});
-\`\`\`
-
-## Notes
-
-- \`expiration\` is measured in seconds. Harper also supports separate \`eviction\` and \`scanInterval\` arguments on \`@table\` for fine-grained control over physical record removal.
-- ETags are automatically computed from a record's last-modified timestamp. Include the double quotes when passing an ETag back in \`If-None-Match\` — they are part of the value.
-- Exporting a class with the same name as a table (e.g., \`export class JokeCache extends tables.JokeCache\`) registers it as the HTTP endpoint for that table; \`@export\` in the schema is not required separately.
-- For defining custom upstream source behavior beyond a simple \`get\`, see [custom-resources.md](custom-resources.md).
-- For details on how \`@table\` and \`@export\` expose REST endpoints automatically, see [automatic-apis.md](automatic-apis.md).
-`,"checking-authentication":`---
-name: checking-authentication
-description: How to handle user authentication and sessions in Harper Resources.
-metadata:
-  mode: generate
-  sources:
-    - >-
-      reference/v5/resources/resource-api.md#\`getCurrentUser(): User |
-      undefined\`
-    - reference/v5/resources/resource-api.md#Session and Login from a Resource
-    - reference/v5/security/jwt-authentication.md
-  sourceCommit: b7fbddadd42eb4487190b650a9abc4bcfeef5819
-  inputHash: fdd9ec3b11011490
----
-
-# Checking Authentication
-
-Instructions for the agent to follow when handling user authentication and session management inside Harper Resources.
-
-## When to Use
-
-Apply this rule when implementing authentication checks, login/logout flows, or token issuance inside a custom Resource. Use it any time a Resource needs to identify the current user, establish a session, or issue JWTs to clients. See [custom-resources.md](custom-resources.md) for the general Resource authoring pattern.
-
-## How It Works
-
-1. **Check the current user** with \`getCurrentUser()\`. Call it inside any Resource method to retrieve the authenticated user or \`undefined\` if no user is authenticated. Guard protected endpoints by returning a \`401\` when the result is \`undefined\`.
-
-   \`\`\`javascript
-   async get(target) {
-     const user = this.getCurrentUser();
-     if (!user) return new Response(null, { status: 401 });
-     return { username: user.username, role: user.role };
-   }
-   \`\`\`
-
-   The returned object exposes \`username\`, \`role\`, and \`role.permission\` flags.
-
-2. **Enable sessions** before using session-based login. Set \`authentication.enableSessions: true\` in \`harperdb-config.yaml\`:
-
-   \`\`\`yaml
-   authentication:
-     enableSessions: true
-   \`\`\`
-
-3. **Access login and session helpers** via \`getContext()\`. The context object exposes \`context.login\` and \`context.session\` for sign-in/out flows.
-   - Call \`context.login(username, password)\` to verify credentials and establish a session cookie on success.
-   - To end a session, delete it via \`context.session.delete(context.session.id)\`.
-
-4. **Implement sign-in and sign-out Resources** using the context helpers:
-
-   \`\`\`javascript
-   export class SignIn extends Resource {
-   	async post(_target, data) {
-   		const context = this.getContext();
-   		try {
-   			await context.login(data.username, data.password);
-   		} catch {
-   			return new Response('Invalid credentials', { status: 403 });
-   		}
-   		return new Response('Logged in', { status: 200 });
-   	}
-   }
-
-   export class SignOut extends Resource {
-   	async post() {
-   		const context = this.getContext();
-   		if (!context.session) return new Response(null, { status: 401 });
-   		await context.session.delete(context.session.id);
-   		return new Response('Logged out', { status: 200 });
-   	}
-   }
-   \`\`\`
-
-5. **Issue JWTs for non-browser clients** (CLI tools, mobile apps, service-to-service). Cookie-based sessions are intended for browser clients. For other clients, mint tokens programmatically using \`server.operation()\`:
-
-   \`\`\`javascript
-   import { Resource, server } from 'harper';
-
-   export class IssueTokens extends Resource {
-   	static async get(_target, context) {
-   		const { operation_token, refresh_token } = await server.operation(
-   			{ operation: 'create_authentication_tokens' },
-   			context,
-   			true,
-   		);
-   		return { operation_token, refresh_token };
-   	}
-
-   	static async post(_target, data) {
-   		const { username, password } = await data;
-   		if (!username || !password) {
-   			return new Response('username and password required', { status: 400 });
-   		}
-   		const { operation_token, refresh_token } = await server.operation({
-   			operation: 'create_authentication_tokens',
-   			username,
-   			password,
-   		});
-   		return { operation_token, refresh_token };
-   	}
-   }
-
-   export class RefreshJWT extends Resource {
-   	static async post(_target, data) {
-   		const { refresh_token } = await data;
-   		if (!refresh_token) {
-   			return new Response('refresh_token required', { status: 400 });
-   		}
-   		const { operation_token } = await server.operation({
-   			operation: 'refresh_operation_token',
-   			refresh_token,
-   		});
-   		return { operation_token };
-   	}
-   }
-   \`\`\`
-
-   Pass \`true\` as the third argument to \`server.operation()\` when the operation should run as the current authenticated user. Omit it or pass \`false\` when the operation supplies its own credentials.
-
-6. **Configure JWT token expiry** in \`harperdb-config.yaml\` under the \`authentication\` section:
-
-   \`\`\`yaml
-   authentication:
-     operationTokenTimeout: 1d
-     refreshTokenTimeout: 30d
-   \`\`\`
-
-   Duration strings follow the \`jsonwebtoken\` package format (e.g., \`1d\`, \`12h\`, \`60m\`).
-
-## Examples
-
-**Protecting a resource endpoint and returning user info:**
-
-\`\`\`javascript
-async get(target) {
-  const user = this.getCurrentUser();
-  if (!user) return new Response(null, { status: 401 });
-  return { username: user.username, role: user.role };
-}
-\`\`\`
-
-**Full session-based sign-in/sign-out flow:**
-
-\`\`\`javascript
-export class SignIn extends Resource {
-	async post(_target, data) {
-		const context = this.getContext();
-		try {
-			await context.login(data.username, data.password);
-		} catch {
-			return new Response('Invalid credentials', { status: 403 });
-		}
-		return new Response('Logged in', { status: 200 });
-	}
-}
-
-export class SignOut extends Resource {
-	async post() {
-		const context = this.getContext();
-		if (!context.session) return new Response(null, { status: 401 });
-		await context.session.delete(context.session.id);
-		return new Response('Logged out', { status: 200 });
-	}
-}
-\`\`\`
-
-**JWT token refresh endpoint:**
-
-\`\`\`javascript
-export class RefreshJWT extends Resource {
-	static async post(_target, data) {
-		const { refresh_token } = await data;
-		if (!refresh_token) {
-			return new Response('refresh_token required', { status: 400 });
-		}
-		const { operation_token } = await server.operation({
-			operation: 'refresh_operation_token',
-			refresh_token,
-		});
-		return { operation_token };
-	}
-}
-\`\`\`
-
-## Notes
-
-- \`getCurrentUser()\` and \`getContext()\` are instance methods; call them with \`this\` inside non-static Resource methods.
-- \`enableSessions\` must be \`true\` in config before \`context.login\` or \`context.session\` will function.
-- Cookie-based sessions target browser clients. Use JWT issuance via \`server.operation()\` for all other client types.
-- When both \`operation_token\` and \`refresh_token\` have expired, the client must call \`create_authentication_tokens\` again with credentials.
-`,"creating-a-fabric-account-and-cluster":`---
-name: creating-a-fabric-account-and-cluster
-description: How to create a Harper Fabric account, organization, and cluster.
-metadata:
-  mode: synthesized
----
-
-# Creating a Harper Fabric Account and Cluster
-
-Follow these steps to set up your Harper Fabric environment for deployment.
-
-## How It Works
-
-1. **Sign Up/In**: Go to [https://fabric.harper.fast/](https://fabric.harper.fast/) and sign up or sign in.
-2. **Create an Organization**: Create an organization (org) to manage your projects.
-3. **Create a Cluster**: Create a new cluster. This can be on the free tier, no credit card required.
-4. **Set Credentials**: During setup, set the cluster username and password to finish configuring it.
-5. **Get Application URL**: Navigate to the **Config** tab and copy the **Application URL**.
-6. **Configure Environment**: Update your \`.env\` file or GitHub Actions secrets with cluster-specific credentials.
-7. **Next Steps**: See the [deploying-to-harper-fabric](deploying-to-harper-fabric.md) rule for detailed instructions on deploying your application successfully.
-
-## Examples
-
-### Environment Configuration
-
-\`\`\`bash
-CLI_TARGET_USERNAME='YOUR_CLUSTER_USERNAME'
-CLI_TARGET_PASSWORD='YOUR_CLUSTER_PASSWORD'
-CLI_TARGET='YOUR_CLUSTER_URL'
-\`\`\`
-`,"creating-harper-apps":`---
-name: creating-harper-apps
-description: How to initialize a new Harper application using the CLI.
-metadata:
-  mode: synthesized
----
-
-# Creating Harper Applications
-
-The fastest way to start a new Harper project is using the \`create-harper\` CLI tool. This command
-initializes a project with a standard folder structure, essential configuration files, and basic
-schema definitions.
-
-## When to Use
-
-Use this command when starting a new Harper application or adding a new Harper microservice to an
-existing architecture.
-
-## Commands
-
-Initialize a project using your preferred package manager:
-
-### NPM
-
-\`\`\`bash
-npm create harper@latest
-\`\`\`
-
-### PNPM
-
-\`\`\`bash
-pnpm create harper@latest
-\`\`\`
-
-### Bun
-
-\`\`\`bash
-bun create harper@latest
-\`\`\`
-
-## Options
-
-You can specify the project name and template directly:
-
-\`\`\`bash
-npm create harper@latest my-app --template default
-\`\`\`
-
-## Next Steps
-
-1. **Configure Environment**: Set up your \`.env\` file with local or cloud credentials.
-2. **Define Schema**: Modify \`schema.graphql\` to fit your application's data model.
-3. **Start Development**: Run \`npm run dev\` to start the local Harper instance.
-4. **Deploy**: Use \`npm run deploy\` to push your application to Harper Fabric.
-`,"custom-resources":`---
-name: custom-resources
-description: How to define custom REST endpoints with JavaScript or TypeScript in Harper.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/resources/overview.md#Custom External Data Source
-    - reference/v5/resources/overview.md#Exporting Resources as Endpoints
-    - reference/v5/components/javascript-environment.md#Module Loading
-  sourceCommit: f37a8c4021e20d5c74c1d339a6b6c8c196b5603e
-  inputHash: df69870433c0b3e5
----
-
-# Custom Resources
-
-Instructions for the agent to follow when defining custom REST endpoints with JavaScript or TypeScript in Harper.
-
-## When to Use
-
-Apply this rule when creating custom HTTP endpoints, wrapping external APIs, or registering routes programmatically in a Harper application. Use it any time business logic must live outside a table-backed schema, or when a specific URL shape is required.
-
-## How It Works
-
-1. **Import \`Resource\` from \`harper\`**: Always import from the \`harper\` package rather than relying on globals.
-
-   \`\`\`javascript
-   import { tables, Resource } from 'harper';
-   \`\`\`
-
-2. **Define a class that \`extends Resource\`**: Implement HTTP methods as \`static\` methods. Each method receives a \`target\` object.
-
-   \`\`\`javascript
-   export class CustomEndpoint extends Resource {
-   	static get(target) {
-   		return {
-   			data: doSomething(),
-   		};
-   	}
-   }
-   \`\`\`
-
-3. **Use \`async\` static methods for external calls**: Await fetch or other async operations inside \`static\` handlers.
-
-   \`\`\`javascript
-   export class MyExternalData extends Resource {
-   	static async get(target) {
-   		const response = await fetch(\`https://api.example.com/\${target.id}\`);
-   		return response.json();
-   	}
-
-   	static async put(target, data) {
-   		return fetch(\`https://api.example.com/\${target.id}\`, {
-   			method: 'PUT',
-   			body: JSON.stringify(await data),
-   		});
-   	}
-   }
-   \`\`\`
-
-4. **Export the class to create an endpoint**: The export form controls the resulting URL. Choose the form that matches the URL shape you need.
-
-   | Export form                                 | URL             | Notes                                                           |
-   | ------------------------------------------- | --------------- | --------------------------------------------------------------- |
-   | \`export class Foo extends Resource {}\`      | \`/Foo/\`         | Class name becomes the path segment. Case-sensitive.            |
-   | \`export const Bar = { Foo };\`               | \`/Bar/Foo/\`     | Nest under an object to add a path prefix.                      |
-   | \`export const bar = { 'foo-baz': Foo };\`    | \`/bar/foo-baz/\` | Use object keys for lowercase, hyphens, or non-identifier URLs. |
-   | \`export { Foo as '/widget/:id' }\`           | \`/widget/:id\`   | Rename the export to set the path directly.                     |
-   | \`static path = '/widget/:id'\` (class field) | \`/widget/:id\`   | Declare path on the class; overrides the export name.           |
-   | \`server.resources.set('my-path', Foo);\`     | \`/my-path/\`     | Programmatic registration for dynamic paths.                    |
-
-   URL path matching is case-sensitive — \`/Foo/\` and \`/foo/\` are different endpoints.
-
-5. **Declare path parameters with \`static path\`**: Use \`:name\` for a single segment and \`*name\` as a catch-all. Matched values are bound onto \`target.<name>\`.
-
-   \`\`\`javascript
-   export class Widget extends Resource {
-   	static path = '/widget/:id/action/:action';
-   	static get(target) {
-   		return { id: target.id, action: target.action };
-   	}
-   }
-   \`\`\`
-
-   A \`static path\` takes precedence over the export name. A leading \`/\` makes the path root-relative (top-level). A leading \`./\` or bare name resolves relative to the component directory.
-
-6. **Register programmatically when the path is dynamic**: Use \`server.resources.set(\` when the path cannot be known at export time.
-
-   \`\`\`javascript
-   server.resources.set('my-path', Foo);
-   \`\`\`
-
-7. **Optionally source a table from a custom resource**: Use the resource as a caching layer for a local table.
-   \`\`\`javascript
-   tables.MyCache.sourcedFrom(MyExternalData);
-   \`\`\`
-
-## Examples
-
-### External API wrapper with GET and PUT
-
-\`\`\`javascript
-import { tables, Resource } from 'harper';
-
-export class MyExternalData extends Resource {
-	static async get(target) {
-		const response = await fetch(\`https://api.example.com/\${target.id}\`);
-		return response.json();
-	}
-
-	static async put(target, data) {
-		return fetch(\`https://api.example.com/\${target.id}\`, {
-			method: 'PUT',
-			body: JSON.stringify(await data),
-		});
-	}
-}
-
-// Use as a cache source for a local table
-tables.MyCache.sourcedFrom(MyExternalData);
-\`\`\`
-
-### Path parameters with \`static path\`
-
-\`\`\`javascript
-import { Resource } from 'harper';
-
-export class Widget extends Resource {
-	// GET /widget/10/action/jump  ->  target.id === '10', target.action === 'jump'
-	static path = '/widget/:id/action/:action';
-	static get(target) {
-		return { id: target.id, action: target.action };
-	}
-}
-
-export class Files extends Resource {
-	// GET /files/a/b/c.txt  ->  target.rest === 'a/b/c.txt'
-	static path = '/files/*rest';
-	static get(target) {
-		return { path: target.rest };
-	}
-}
-\`\`\`
-
-### Programmatic registration
-
-\`\`\`javascript
-import { Resource } from 'harper';
-
-export class Foo extends Resource {
-	static get(target) {
-		return { data: doSomething() };
-	}
-}
-
-server.resources.set('my-path', Foo);
-\`\`\`
-
-## Notes
-
-- A bare \`*\` wildcard (no name) binds under \`target.wildcard\`. A wildcard must be the final segment of the path.
-- Resolution order: exact/static paths always win over parameterized ones. Among parameterized routes, more specific paths win — a literal segment beats \`:param\`, which beats \`*\`, compared left to right.
-- Parameterized routes appear in the generated OpenAPI document as templated paths (e.g. \`/widget/{id}/action/{action}\`) and in MCP \`resources/templates/list\` as \`{param}\` URI templates.
-- If a resource \`extends\` an existing table, avoid conflicting exports between the schema and the JavaScript implementation.
-- Link the \`harper\` package in your component directory to ensure correct typings: \`npm link harper\`. All installed components have \`harper\` automatically linked.
-- Harper runs as a single process — \`tables\`, \`databases\`, and other APIs are the same live, process-wide objects regardless of which component accesses them.
-`,"defining-relationships":`---
-name: defining-relationships
-description: How to define and use relationships between tables in Harper using GraphQL.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/database/schema.md#Relationships
-    - reference/v5/rest/querying.md#Relationships and Joins
-  sourceCommit: 3749d0c54be457a2a65d9a63c738a5dc88989ecd
-  inputHash: fd399fd81a88f13e
----
-
-# Defining Relationships Between Tables in Harper
-
-Instructions for the agent to follow when defining and querying relationships between tables in Harper using the \`@relationship\` directive.
-
-## When to Use
-
-Apply this rule when adding foreign key relationships between schema tables, enabling join queries, or returning nested related records in query results. Use it any time a schema type needs to reference records in another table via a foreign key attribute.
-
-## How It Works
-
-1. **Use \`@relationship(from: attribute)\` for many-to-one or many-to-many**: Place this on the field in the table that holds the foreign key. The \`from\` parameter names the attribute on this table that stores the foreign key referencing the target table's primary key.
-
-   \`\`\`graphql
-   type RealityShow @table @export {
-   	id: Long @primaryKey
-   	networkId: Long @indexed
-   	network: Network @relationship(from: networkId) # many-to-one
-   	title: String @indexed
-   }
-
-   type Network @table @export {
-   	id: Long @primaryKey
-   	name: String @indexed
-   }
-   \`\`\`
-
-   If the foreign key attribute is an array, the relationship becomes many-to-many:
-
-   \`\`\`graphql
-   type RealityShow @table @export {
-   	id: Long @primaryKey
-   	networkIds: [Long] @indexed
-   	networks: [Network] @relationship(from: networkIds)
-   }
-   \`\`\`
-
-2. **Use \`@relationship(to: attribute)\` for one-to-many or many-to-many**: Place this on the table whose primary key is referenced by the foreign key in the target table. The \`to\` parameter names the attribute on the target table that holds the foreign key. The result type **must** be an array.
-
-   \`\`\`graphql
-   type Network @table @export {
-   	id: Long @primaryKey
-   	name: String @indexed
-   	shows: [RealityShow] @relationship(to: networkId) # one-to-many
-   }
-   \`\`\`
-
-3. **Use \`@relationship(from: attribute, to: attribute)\` for foreign key to foreign key joins**: Specify both \`from\` and \`to\` when neither side uses the primary key. Harper resolves the relationship by searching the target table's \`to\` attribute for matches using this record's \`from\` attribute value. The result type must be an array.
-
-   \`\`\`graphql
-   type OrderItem @table @export {
-   	id: Long @primaryKey
-   	orderId: Long @indexed
-   	productSku: Long @indexed
-   	products: [Product] @relationship(from: productSku, to: sku)
-   }
-
-   type Product @table @export {
-   	id: Long @primaryKey
-   	sku: Long @indexed
-   	name: String
-   }
-   \`\`\`
-
-4. **Query across relationships using dot-syntax**: Filter records by related table attributes using chained dot notation. This behaves as an INNER JOIN — only records with a matching related record are returned.
-
-   \`\`\`
-   GET /Product/?brand.name=Microsoft
-   GET /Brand/?products.name=Keyboard
-   \`\`\`
-
-5. **Include relationship fields in results using \`select()\`**: Relationship attributes are not returned by default. Use \`select()\` to include them, optionally specifying nested fields with \`{}\`.
-
-   \`\`\`
-   GET /Product/?brand.name=Microsoft&select(name,brand)
-   GET /Product/?brand.name=Microsoft&select(name,brand{name})
-   GET /Product/?name=Keyboard&select(name,brand{name,id})
-   \`\`\`
-
-   When selecting a relationship without filtering on it, Harper performs a LEFT JOIN — the relationship property is omitted if the foreign key is null or references a non-existent record.
-
-6. **Model many-to-many without a junction table**: Store an array of foreign key values and use \`@relationship(from: ...)\` pointing to that array attribute. The array order of the foreign key values is preserved when resolving the relationship.
-
-   \`\`\`graphql
-   type Product @table @export {
-   	id: Long @primaryKey
-   	name: String
-   	resellerIds: [Long] @indexed
-   	resellers: [Reseller] @relationship(from: "resellerIds")
-   }
-   \`\`\`
-
-7. **Define self-referential relationships** for parent-child hierarchies by pointing \`@relationship\` back at the same table type.
-
-## Examples
-
-**Full schema with bidirectional relationships:**
-
-\`\`\`graphql
-type Product @table @export {
-	id: Long @primaryKey
-	name: String
-	brandId: Long @indexed
-	brand: Brand @relationship(from: "brandId")
-}
-
-type Brand @table @export {
-	id: Long @primaryKey
-	name: String
-	products: [Product] @relationship(to: "brandId")
-}
-\`\`\`
-
-**Querying with joins and nested select:**
-
-\`\`\`
-GET /Product/?brand.name=Microsoft&select(name,brand{name,id})
-GET /Brand/?products.name=Keyboard
-\`\`\`
-
-**Many-to-many query with nested select:**
-
-\`\`\`
-GET /Product/?resellers.name=Cool Shop&select(id,name,resellers{name,id})
-\`\`\`
-
-## Notes
-
-- Every attribute named in \`from\` or \`to\` must exist on the respective table and be annotated with \`@indexed\` to support join queries.
-- The \`to\`-only and \`from\`+\`to\` forms both require the result field type to be an array (e.g., \`[RealityShow]\`).
-- The \`from\`-only form on a non-array attribute produces a many-to-one relationship; on an array attribute it produces many-to-many.
-- Self-referential relationships are supported for hierarchical data within a single table.
-`,"delegating-to-the-built-in-agent":`---
-name: delegating-to-the-built-in-agent
-description: How to delegate tasks to Harper's built-in agent via the CLI and the agent operations API.
-metadata:
-  mode: synthesized
----
-
-# Delegating to the Built-in Agent
-
-Harper 5.2+ ships with a **built-in agent** that runs _inside_ the server, on the main thread
-adjacent to the operations API. Because it runs in-process, it can do things a remote client
-cannot: call the operations API as RBAC-filtered tools, read and write component files under the
-instance's components root, attach the V8 inspector to worker threads to debug and profile them,
-schedule follow-up work, and consult the Harper best-practices skill. You send it a natural-language
-task; it runs a tool-using loop under a super_user identity and reports back.
-
-## When to Use
-
-Delegate to the built-in agent when the work is best done **on the instance itself** rather than
-from your local client:
-
-- Operating on a deployed instance in place — inspect the schema, build or adjust a component,
-  restart, run an operation.
-- Debugging or profiling a running instance — attach to a worker thread, capture a CPU profile,
-  set a logpoint.
-- Handing off a larger, multi-step task to an agent that already has the instance's tools,
-  filesystem, and credentials in context.
-
-Do the work in your own client instead when it's purely local (editing source before deploy) or
-when you don't want a server-side agent making changes.
-
-**Prerequisites:** the target instance must have the agent enabled (an \`agent:\` config block with
-\`enabled: true\`) and a configured generative model backend. All agent operations require
-**super_user**.
-
-## How It Works
-
-The lifecycle assumes you have already deployed to and authenticated with the target instance (see
-[deploying-to-harper-fabric.md](deploying-to-harper-fabric.md) — \`harper login\` stores a token so
-you don't repeat credentials). Delegation reuses that same target and credentials.
-
-There are two equivalent ways to drive the agent.
-
-### Option A — the \`harper agent\` CLI (simplest)
-
-A thin client over the agent operations API that reuses your stored \`harper login\` credentials, so
-no connector setup is needed:
-
-\`\`\`bash
-# One-shot: send a task, print the reply, exit
-harper agent "Describe the schema, then add a price index to the Product table."
-
-# Interactive session (REPL)
-harper agent
-
-# Against a specific remote instead of the logged-in default
-harper agent --target <Application URL> "List the databases and tables."
-\`\`\`
-
-The CLI polls the run to completion and renders the transcript (tool calls, results, and the
-agent's reply). When a run needs approval for a destructive action, it prompts you inline.
-
-### Option B — the agent operations API (programmatic)
-
-Call the operations API directly (HTTP POST to the ops endpoint, super_user auth). This is the path
-to use from scripts and services.
-
-1. **Start a task** with \`agent_prompt\`. Returns a \`session_id\` and a \`status\`.
-
-   \`\`\`bash
-   curl -s -u <user>:<pass> <ops-endpoint> \\
-     -H 'Content-Type: application/json' \\
-     -d '{"operation":"agent_prompt","message":"Build a Customer table (id, email, name) exported over REST."}'
-   \`\`\`
-
-2. **Poll for progress** with \`get_agent_session\`, passing the \`session_id\`. The returned session
-   carries the \`status\`, the \`messages\` transcript, and any \`pendingApprovals\`.
-
-   \`\`\`bash
-   curl -s -u <user>:<pass> <ops-endpoint> \\
-     -H 'Content-Type: application/json' \\
-     -d '{"operation":"get_agent_session","session_id":"<id>"}'
-   \`\`\`
-
-   Poll until \`status\` leaves \`running\` — terminal states are \`completed\`, \`aborted\`, and \`error\`;
-   \`awaiting_approval\` means it is paused for an approval decision (see step 3).
-
-3. **Approve or deny a paused action.** When the agent enabled configuration has \`autoApprove:false\`,
-   a destructive tool call pauses the run with a \`pendingApprovals[]\` entry. Resolve it with
-   \`approve_agent_action\`, then poll again — approval executes the saved call, denial hands the
-   rejection back to the agent so it can adjust.
-
-   \`\`\`bash
-   curl -s -u <user>:<pass> <ops-endpoint> \\
-     -H 'Content-Type: application/json' \\
-     -d '{"operation":"approve_agent_action","session_id":"<id>","approval_id":"<approval-id>","approved":true}'
-   \`\`\`
-
-4. **Continue the conversation** by passing the same \`session_id\` back into \`agent_prompt\` with a
-   new \`message\`. Omit \`session_id\` to start a fresh session.
-
-Supporting operations: \`list_agent_sessions\` (recent sessions), \`cancel_agent_run\` (terminate a
-running or paused session), and \`set_agent_config\` (adjust \`autoApprove\`, \`allowDestructive\`,
-\`model\`, and related settings on a running instance).
-
-## Examples
-
-**Delegate a build to a deployed Fabric instance and wait for the result:**
-
-\`\`\`bash
-harper login <Application URL>
-harper agent --target <Application URL> \\
-  "Create a Product table (id, name, price) exported over REST, then confirm the endpoint responds."
-\`\`\`
-
-**Programmatic start-and-poll loop:**
-
-\`\`\`bash
-SID=$(curl -s -u <user>:<pass> <ops-endpoint> -H 'Content-Type: application/json' \\
-  -d '{"operation":"agent_prompt","message":"Add a vector index to the Document.embedding field."}' \\
-  | jq -r .session_id)
-
-while [ "$(curl -s -u <user>:<pass> <ops-endpoint> -H 'Content-Type: application/json' \\
-  -d "{\\"operation\\":\\"get_agent_session\\",\\"session_id\\":\\"$SID\\"}" | jq -r .status)" = "running" ]; do
-  sleep 3
-done
-\`\`\`
-
-## Notes
-
-- **All agent operations require super_user.** Authenticate with \`harper login\`, which stores a
-  short-lived JWT (operation token) plus a refresh token rather than your password — prefer that
-  over passing credentials inline, and never embed a raw password in scripts or client config.
-- **Approvals are your safety gate.** With \`autoApprove:false\`, the agent pauses before destructive
-  tools (writing files, deploying, restarting) so an operator decides. Set \`autoApprove:true\` only
-  when you want unattended runs.
-- **Sessions are single-active.** A session that is \`running\` or \`awaiting_approval\` rejects a new
-  \`agent_prompt\`; resolve the approval or cancel the run first.
-- **MCP alternative.** For MCP-native clients, an instance with MCP enabled exposes the agent as
-  curated MCP tools (\`agent_prompt\`, \`get_agent_session\`, \`list_agent_sessions\`) at the ops API's
-  \`/mcp\` endpoint — the same delegation loop over the MCP transport instead of raw operations.
-`,"deploying-to-harper-fabric":`---
-name: deploying-to-harper-fabric
-description: How to deploy a Harper application to the Harper Fabric cloud.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/components/applications.md#Remote Management
-    - >-
-      fabric/cluster-creation-management.md#Connecting the Harper CLI to a
-      Cluster
-  sourceCommit: 3749d0c54be457a2a65d9a63c738a5dc88989ecd
-  inputHash: 39faf283b6964e93
----
-
-# Deploying to Harper Fabric
-
-Instructions for the agent to follow when deploying a Harper application to a remote Harper Fabric cloud instance.
-
-## When to Use
-
-Apply this rule when deploying a Harper application to a remote Harper Fabric cluster or any remote Harper instance. Use it when setting up CI/CD pipelines that push application packages to a target environment, or when deploying from a local directory or external package source to a remote cluster.
-
-## How It Works
-
-1. **Obtain the target URL**: Get the cluster's **Application URL** from the cluster's **Config → Overview** page. This is the hostname passed to all CLI commands as \`target\`.
-
-2. **Authenticate with \`harper login\`**: Run \`harper login\` once to store an authentication token locally. The CLI also writes \`HARPER_CLI_TARGET\` to a local \`.env\` for subsequent commands.
-
-   \`\`\`bash
-   harper login <Application URL>
-   # Provide cluster username and password when prompted
-   \`\`\`
-
-   See [creating-a-fabric-account-and-cluster.md](creating-a-fabric-account-and-cluster.md) for setting up a cluster before this step.
-
-3. **Deploy with \`harper deploy\`**: After logging in, deploy without repeating credentials.
-
-   \`\`\`bash
-   harper deploy \\
-     project=<name> \\
-     package=<package> \\
-     target=<remote> \\
-     restart=true \\
-     replicated=true
-   \`\`\`
-
-4. **Use environment variables for CI/CD**: Instead of \`harper login\`, export credentials as environment variables before running \`harper deploy\`.
-
-   \`\`\`bash
-   export HARPER_CLI_USERNAME=<username>
-   export HARPER_CLI_PASSWORD=<password>
-   harper deploy \\
-     project=<name> \\
-     package=<package> \\
-     target=<remote> \\
-     restart=true \\
-     replicated=true
-   \`\`\`
-
-5. **Use inline auth parameters for one-off commands**: Pass \`auth_username\` and \`auth_password\` directly. These take precedence over environment variables and saved login tokens. Not recommended for production.
-
-   \`\`\`bash
-   harper deploy \\
-     project=<name> \\
-     package=<package> \\
-     auth_username=<username> \\
-     auth_password=<password> \\
-     target=<remote> \\
-     restart=true \\
-     replicated=true
-   \`\`\`
-
-6. **Choose a package source**: Set the \`package\` parameter to any valid npm dependency value, or omit it to package and deploy the current local directory.
-
-   | Value                                                | Meaning                                        |
-   | ---------------------------------------------------- | ---------------------------------------------- |
-   | _(omitted)_                                          | Package and deploy the current local directory |
-   | \`"@harperdb/status-check"\`                           | npm package                                    |
-   | \`"HarperDB/status-check"\`                            | GitHub shorthand                               |
-   | \`"https://github.com/HarperDB/status-check"\`         | GitHub full URL                                |
-   | \`"git+ssh://git@github.com:HarperDB/secret-app.git"\` | Private repo via SSH                           |
-   | \`"https://example.com/application.tar.gz"\`           | Remote tarball                                 |
-
-   For pinned git tags, use the \`semver\` directive:
-
-   \`\`\`
-   HarperDB/application-template#semver:v1.0.0
-   \`\`\`
-
-   For SSH-based private repos, register keys with the \`Add SSH Key\` operation before deploying.
-
-## Examples
-
-**Interactive login then deploy:**
-
-\`\`\`bash
-harper login https://my-cluster.harperdbcloud.com
-# Enter username and password when prompted
-
-harper deploy \\
-  project=my-app \\
-  package="HarperDB/application-template#semver:v1.0.0" \\
-  target=https://my-cluster.harperdbcloud.com \\
-  restart=true \\
-  replicated=true
-\`\`\`
-
-**CI/CD pipeline deploy using environment variables:**
-
-\`\`\`bash
-export HARPER_CLI_USERNAME=admin
-export HARPER_CLI_PASSWORD=secret
-harper deploy \\
-  project=my-app \\
-  package="@harperdb/status-check" \\
-  target=https://my-cluster.harperdbcloud.com \\
-  restart=true \\
-  replicated=true
-\`\`\`
-
-**Deploy current local directory:**
-
-\`\`\`bash
-harper deploy \\
-  project=my-app \\
-  target=https://my-cluster.harperdbcloud.com \\
-  restart=true \\
-  replicated=true
-\`\`\`
-
-## Notes
-
-- Authentication precedence (highest to lowest): inline \`auth_username\`/\`auth_password\` parameters → environment variables (\`HARPER_CLI_USERNAME\`/\`HARPER_CLI_PASSWORD\`) → saved login token from \`harper login\`.
-- \`harper login\` writes \`HARPER_CLI_TARGET\` to a local \`.env\`, so subsequent commands do not need \`target\` repeated if that file is present.
-- Harper generates a \`package.json\` from component configurations and resolves packages via \`npm install\`. A local file path creates a symlink, so changes are picked up between restarts without redeploying.
-- For SSH-based private repos, register the SSH key with the \`Add SSH Key\` operation before running \`harper deploy\`.
-`,"extending-tables":`---
-name: extending-tables
-description: How to add custom logic to automatically generated table resources in Harper.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/resources/overview.md#Extending a Table
-    - reference/v5/resources/resource-api.md#Throwing Errors
-  sourceCommit: ce0ab713d918d789bc1c9f22e461e963ccc1dff1
-  inputHash: 19738fbc732e0a1a
----
-
-# Extending Tables
-
-Instructions for the agent to follow when adding custom logic to automatically generated table resources in Harper.
-
-## When to Use
-
-Apply this rule when you need to add computed properties, intercept writes, enforce validation, or otherwise customize the behavior of a Harper table resource beyond what the default generated endpoints provide. Use it any time a \`@table\` type needs server-side logic attached to its REST handlers.
-
-## How It Works
-
-1. **Define the schema without \`@export\`**: Declare the table type in \`schema.graphql\` and omit the \`@export\` directive. Leaving \`@export\` on the schema while also exporting a subclass with the same name produces conflicting endpoints. Let the JavaScript class own the URL instead.
-
-   \`\`\`graphql
-   # Omit the \`@export\` directive
-   type MyTable @table {
-   	id: Long @primaryKey
-   	# ...
-   }
-   \`\`\`
-
-2. **Extend the generated table class**: In \`resources.js\`, extend from the \`tables.<TypeName>\` global. The class name you export becomes the URL path. The exported class extends tables.
-
-   \`\`\`javascript
-   export class MyTable extends tables.MyTable {
-   	static async get(target) {
-   		const record = await super.get(target);
-   		return { ...record, computedField: 'value' };
-   	}
-
-   	static async post(target, data) {
-   		this.create({ ...(await data), status: 'pending' });
-   	}
-   }
-   \`\`\`
-
-3. **Call \`super\` to preserve default behavior**: When delegating to \`super\`, match the argument form to the operation:
-   - Reads/deletes: \`super.get(target)\` / \`super.delete(target)\`
-   - Collection create: \`super.post(target, record)\` — target carries no id
-   - Updates: \`super.put(target, data)\` / \`super.patch(target, data)\`
-
-   Omit the \`super\` call only if you intend to replace the default behavior entirely.
-
-4. **Set \`statusCode\` on thrown errors to control HTTP responses**: Uncaught errors are caught by the protocol handler and produce error responses for REST. Use \`.statusCode\` — a plain \`.status\` property is ignored.
-
-   \`\`\`javascript
-   const error = new Error('Name is required');
-   error.statusCode = 400; // use statusCode, NOT status
-   throw error;
-   \`\`\`
-
-5. **Configure Harper to load both files**: Ensure your configuration references the schema and resource files.
-
-   \`\`\`yaml
-   rest: true
-   graphqlSchema:
-     files: schema.graphql
-   jsResource:
-     files: resources.js
-   \`\`\`
-
-## Examples
-
-Full end-to-end example — schema, resource class, and error handling:
-
-\`\`\`graphql
-# schema.graphql — omit @export so the JS class owns the endpoint
-type MyTable @table {
-	id: Long @primaryKey
-}
-\`\`\`
-
-\`\`\`javascript
-// resources.js
-export class MyTable extends tables.MyTable {
-	static async get(target) {
-		// get the record from the database
-		const record = await super.get(target);
-		// add a computed property before returning
-		return { ...record, computedField: 'value' };
-	}
-
-	static async post(target, data) {
-		// custom action on POST
-		this.create({ ...(await data), status: 'pending' });
-	}
-}
-\`\`\`
-
-Throwing a controlled HTTP error:
-
-\`\`\`javascript
-if (!authorized) {
-	const error = new Error('Forbidden');
-	error.statusCode = 403;
-	throw error;
-}
-\`\`\`
-
-## Notes
-
-- Always omit \`@export\` from the schema type when a JavaScript subclass is exporting the same name. The two registrations conflict.
-- \`super\` must be called with the correct arguments for each operation type — mismatched arguments will not behave as expected.
-- \`statusCode\` is the only recognized property for controlling HTTP status on thrown errors; \`.status\` is ignored.
-`,"handling-binary-data":`---
-name: handling-binary-data
-description: How to store and serve binary data like images or audio in Harper.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/database/api.md#Accepting Binary in JSON Requests
-    - reference/v5/database/api.md#Serving Binary from a Resource
-    - reference/v5/rest/content-types.md#Storing Arbitrary Content Types
-  sourceCommit: ce0ab713d918d789bc1c9f22e461e963ccc1dff1
-  inputHash: fa06480e6fae7614
----
-
-# Handling Binary Data
-
-Instructions for the agent to follow when storing and serving binary data (images, audio, arbitrary content types) in Harper.
-
-## When to Use
-
-Apply this rule when a Harper resource needs to accept, store, or serve binary payloads such as images, audio files, or calendar data. Use it when REST clients send \`base64\`-encoded data inside JSON, when raw binary is uploaded via \`PUT\`/\`POST\`, or when a resource must stream binary back to the client with the correct \`Content-Type\`.
-
-## How It Works
-
-1. **Accept base64-encoded binary from JSON clients**: Decode the incoming \`base64\` string with \`Buffer.from\` and wrap it using \`createBlob\`, recording the MIME type. Override \`post\` in your resource class:
-
-   \`\`\`typescript
-   import { type RequestTargetOrId, tables, createBlob } from 'harper';
-
-   export class Photo extends tables.Photo {
-   	static async post(target: RequestTargetOrId, record: any) {
-   		if (record.data) {
-   			record.data = createBlob(Buffer.from(record.data, record.encoding || 'base64'), {
-   				type: record.contentType || 'application/octet-stream',
-   			});
-   		}
-   		return super.post(target, record);
-   	}
-   }
-   \`\`\`
-
-2. **Serve binary from a resource**: Override \`get\` to return a response object with the blob's MIME type in the \`Content-Type\` header and the blob as the body. Harper streams it to the client:
-
-   \`\`\`typescript
-   export class Photo extends tables.Photo {
-   	static async get(target: RequestTargetOrId) {
-   		const record = await super.get(target);
-   		if (record?.data) {
-   			return {
-   				status: 200,
-   				headers: { 'Content-Type': record.data.type || 'application/octet-stream' },
-   				body: record.data,
-   			};
-   		}
-   		return record;
-   	}
-   }
-   \`\`\`
-
-3. **Upload raw binary with a non-standard content type**: Make a \`PUT\` or \`POST\` with any non-standard \`Content-Type\` header. Harper automatically stores the body as a record with \`contentType\` and \`data\` properties:
-
-   \`\`\`http
-   PUT /my-resource/33
-   Content-Type: text/calendar
-
-   BEGIN:VCALENDAR
-   VERSION:2.0
-   ...
-   \`\`\`
-
-   Harper stores this as:
-
-   \`\`\`json
-   { "contentType": "text/calendar", "data": "BEGIN:VCALENDAR\\nVERSION:2.0\\n..." }
-   \`\`\`
-
-   Retrieving that record returns the response with the stored \`Content-Type\` and body. If the content type is not from the \`text\` family, the data is treated as binary (a Node.js \`Buffer\`).
-
-4. **Upload binary to a specific property**: Use \`application/octet-stream\` (or any image/binary MIME type) and target a sub-path to store binary directly on a property:
-
-   \`\`\`http
-   PUT /my-resource/33/image
-   Content-Type: image/gif
-
-   ...image data...
-   \`\`\`
-
-## Examples
-
-**End-to-end: accept base64 JSON, store as blob, serve as binary**
-
-\`\`\`typescript
-import { type RequestTargetOrId, tables, createBlob } from 'harper';
-
-export class Photo extends tables.Photo {
-	// Accept base64-encoded uploads in JSON
-	static async post(target: RequestTargetOrId, record: any) {
-		if (record.data) {
-			record.data = createBlob(Buffer.from(record.data, record.encoding || 'base64'), {
-				type: record.contentType || 'application/octet-stream',
-			});
-		}
-		return super.post(target, record);
-	}
-
-	// Stream the blob back with the correct Content-Type
-	static async get(target: RequestTargetOrId) {
-		const record = await super.get(target);
-		if (record?.data) {
-			return {
-				status: 200,
-				headers: { 'Content-Type': record.data.type || 'application/octet-stream' },
-				body: record.data,
-			};
-		}
-		return record;
-	}
-}
-\`\`\`
-
-## Notes
-
-- \`createBlob\` takes a \`Buffer\` as its first argument and an options object with a \`type\` property for the MIME type. See [using-blob-datatype.md](using-blob-datatype.md) for full details on the blob data type.
-- Always fall back to \`application/octet-stream\` when no MIME type is known, both when creating and when serving blobs.
-- When Harper retrieves a record that has both \`contentType\` and \`data\` properties, it automatically sets the response \`Content-Type\` and body — no custom \`get\` override is required for that case unless you need additional logic.
-- Non-\`text\` content types cause \`data\` to be stored and returned as a Node.js \`Buffer\`.
-`,"load-env":`---
-name: load-env
-description: >-
-  How to load environment variables from .env files into a Harper application
-  using the loadEnv plugin.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/environment-variables/overview.md
-  sourceCommit: 3749d0c54be457a2a65d9a63c738a5dc88989ecd
-  inputHash: b4db5ede6b93d426
----
-
-# Load Environment Variables with loadEnv
-
-Instructions for the agent to follow when loading environment variables from \`.env\` files into a Harper application using the \`loadEnv\` plugin.
-
-## When to Use
-
-Apply this rule when a Harper application needs to supply secrets, API endpoints, or other configuration values to component code via \`process.env\` without hardcoding them. Use \`loadEnv\` any time you need to load one or more \`.env\` files at application startup.
-
-## How It Works
-
-1. **Declare \`loadEnv\` in \`config.yaml\`**: Add \`loadEnv\` as the first entry in \`config.yaml\`. It is built into Harper and requires no installation.
-
-   \`\`\`yaml
-   loadEnv:
-     files: '.env'
-   \`\`\`
-
-2. **Place \`loadEnv\` first**: Harper is a single-process application. List \`loadEnv\` before all other components so that environment variables are available on \`process.env\` before dependent components start.
-
-   \`\`\`yaml
-   # config.yaml — loadEnv must come first
-   loadEnv:
-     files: '.env'
-
-   rest: true
-
-   myApp:
-     files: './src/*.js'
-   \`\`\`
-
-3. **Access loaded values in component code**: After \`loadEnv\` runs, all loaded values are available on \`process.env\` and shared across all components.
-
-4. **Control override behavior**: By default, existing environment variables take precedence over values in \`.env\` files. Set \`override: true\` to make loaded values win instead.
-
-   \`\`\`yaml
-   loadEnv:
-     files: '.env'
-     override: true
-   \`\`\`
-
-5. **Load multiple files**: Pass an array of paths or a glob pattern to \`files\`. Files are loaded in the order specified.
-
-   \`\`\`yaml
-   loadEnv:
-     files:
-       - '.env'
-       - '.env.local'
-   \`\`\`
-
-   or with a glob:
-
-   \`\`\`yaml
-   loadEnv:
-     files: 'env-vars/*'
-   \`\`\`
-
-### Configuration Options
-
-| Option     | Type                 | Required | Description                                                                            |
-| ---------- | -------------------- | -------- | -------------------------------------------------------------------------------------- |
-| \`files\`    | \`string \\| string[]\` | **Yes**  | Path(s) or glob pattern(s) to the env file(s) to load.                                 |
-| \`override\` | \`boolean\`            | No       | If \`true\`, loaded values override existing environment variables. Defaults to \`false\`. |
-
-## Examples
-
-**Single file, default behavior:**
-
-\`\`\`yaml
-# config.yaml
-loadEnv:
-  files: '.env'
-
-rest: true
-
-myApp:
-  files: './src/*.js'
-\`\`\`
-
-**Multiple files with override:**
-
-\`\`\`yaml
-# config.yaml
-loadEnv:
-  files:
-    - '.env'
-    - '.env.local'
-  override: true
-
-rest: true
-
-myApp:
-  files: './src/*.js'
-\`\`\`
-
-## Notes
-
-- \`loadEnv\` loads values into \`process.env\` for **application** code only — it does not configure Harper itself.
-- Harper's own instance-wide configuration is composed at startup **before** any component's \`loadEnv\` runs. Variables such as \`HARPER_CONFIG\`, \`HARPER_SET_CONFIG\`, and \`HARPER_DEFAULT_CONFIG\` delivered through a \`.env\` file are read too late and are ignored. Set Harper configuration directly in the configuration file or export variables in the real process/container environment before Harper starts.
-- For production credentials, prefer the encrypted secrets store over a committed \`.env\` file. Secrets are also delivered to components via \`process.env\`.
-`,logging:`---
-name: logging
-description: >-
-  Best practices for logging in Harper, including console capture, the granular
-  logger interface, and programmatic log retrieval.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/logging/overview.md
-    - reference/v5/logging/api.md
-  sourceCommit: b7fbddadd42eb4487190b650a9abc4bcfeef5819
-  inputHash: 46cd384598304e3b
----
-
-# Harper Logging
-
-Instructions for the agent to follow when implementing logging in Harper applications, including direct logger usage, tagged loggers, and console capture behavior.
-
-## When to Use
-
-Apply this rule when writing any JavaScript component, plugin, or resource that needs to emit structured log entries, filter logs by component, or capture existing \`console.log\` output into Harper's log system. Use it whenever you need to understand log levels, log entry format, or the \`logger\` global API.
-
-## How It Works
-
-1. **Use the \`logger\` global directly** — \`logger\` is available in all JavaScript components without any imports. Call the method matching the desired severity level:
-
-   \`\`\`javascript
-   logger.trace('detailed trace message');
-   logger.debug('debug info', { someContext: 'value' });
-   logger.info('informational message');
-   logger.warn('potential issue');
-   logger.error('error occurred', error);
-   logger.fatal('fatal error');
-   logger.notify('server is ready');
-   \`\`\`
-
-   Only entries at or above the configured \`logging.level\` (or \`logging.external.level\`) are written to \`hdb.log\`.
-
-2. **Create a tagged logger with \`withTag(\`** — Call \`logger.withTag(tag)\` once per module or class to get a \`TaggedLogger\` scoped to that tag. This prefixes every log entry with the tag, making log output filterable by component.
-
-   \`\`\`javascript
-   const log = logger.withTag('my-resource');
-   \`\`\`
-
-   Because \`TaggedLogger\` methods for disabled levels are \`null\`, always use optional chaining (\`?.\`) when calling them:
-
-   \`\`\`javascript
-   log.debug?.('Fetching record', { id });
-   log.warn?.('Record not found', { id });
-   log.error?.('Failed to update record', err);
-   \`\`\`
-
-   \`TaggedLogger\` does not have a \`withTag()\` method.
-
-3. **Understand the interface contracts** — \`MainLogger\` always has all methods defined:
-
-   \`\`\`typescript
-   interface MainLogger {
-   	trace(...messages: any[]): void;
-   	debug(...messages: any[]): void;
-   	info(...messages: any[]): void;
-   	warn(...messages: any[]): void;
-   	error(...messages: any[]): void;
-   	fatal(...messages: any[]): void;
-   	notify(...messages: any[]): void;
-   	withTag(tag: string): TaggedLogger;
-   }
-   \`\`\`
-
-   \`TaggedLogger\` methods may be \`null\`:
-
-   \`\`\`typescript
-   interface TaggedLogger {
-   	trace: ((...messages: any[]) => void) | null;
-   	debug: ((...messages: any[]) => void) | null;
-   	info: ((...messages: any[]) => void) | null;
-   	warn: ((...messages: any[]) => void) | null;
-   	error: ((...messages: any[]) => void) | null;
-   	fatal: ((...messages: any[]) => void) | null;
-   	notify: ((...messages: any[]) => void) | null;
-   }
-   \`\`\`
-
-4. **Know the log levels** — From least to most severe:
-
-   | Level    | Description                                                          |
-   | -------- | -------------------------------------------------------------------- |
-   | \`trace\`  | Highly detailed internal execution tracing.                          |
-   | \`debug\`  | Diagnostic information useful during development.                    |
-   | \`info\`   | General operational events.                                          |
-   | \`warn\`   | Potential issues that don't prevent normal operation.                |
-   | \`error\`  | Errors that affect specific operations.                              |
-   | \`fatal\`  | Critical errors causing process termination.                         |
-   | \`notify\` | Important operational milestones. Always logged regardless of level. |
-
-   The default log level is \`warn\`. Setting a level includes that level and all more-severe levels.
-
-5. **Enable console capture when porting existing code** — When \`logging.console: true\` is set, writes via \`console.log\`, \`console.warn\`, \`console.error\`, etc. are appended verbatim to \`hdb.log\`. Captured lines do **not** pass through \`logger\`'s level filter. Prefer \`logger\` directly in production code so that level filtering and tagging apply. Console capture is intended as a convenience for porting existing code and for debugging.
-
-6. **Know where logs are written** — All standard log output goes to \`<ROOTPATH>/log/hdb.log\` (default: \`~/hdb/log/hdb.log\`). To also log to \`stdout\`/\`stderr\`, set \`logging.stdStreams: true\`.
-
-## Examples
-
-### Basic logging in a resource
-
-\`\`\`javascript
-export class MyResource extends Resource {
-	async get(id) {
-		logger.debug('Fetching record', { id });
-		const record = await super.get(id);
-		if (!record) {
-			logger.warn('Record not found', { id });
-		}
-		return record;
-	}
-
-	async put(record) {
-		logger.info('Updating record', { id: record.id });
-		try {
-			return await super.put(record);
-		} catch (err) {
-			logger.error('Failed to update record', err);
-			throw err;
-		}
-	}
-}
-\`\`\`
-
-### Tagged logging with \`withTag()\`
-
-\`\`\`javascript
-const log = logger.withTag('my-resource');
-
-export class MyResource extends Resource {
-	async get(id) {
-		log.debug?.('Fetching record', { id });
-		const record = await super.get(id);
-		if (!record) {
-			log.warn?.('Record not found', { id });
-		}
-		return record;
-	}
-
-	async put(record) {
-		log.info?.('Updating record', { id: record.id });
-		try {
-			return await super.put(record);
-		} catch (err) {
-			log.error?.('Failed to update record', err);
-			throw err;
-		}
-	}
-}
-\`\`\`
-
-Tagged entries appear in \`hdb.log\` with the tag in the header:
-
-\`\`\`
-2023-03-09T14:25:05.269Z [info] [my-resource]: Updating record
-\`\`\`
-
-## Notes
-
-- All log output is written to \`<ROOTPATH>/log/hdb.log\`. The \`logger\` global writes to this file at the configured \`logging.external\` level.
-- Log entry format for \`logger\`: \`<timestamp> [<level>] [<thread>/<id>]: <message>\`
-- Log entry format for \`TaggedLogger\`: \`<timestamp> [<level>] [<tag>]: <message>\`
-- \`console.log\` output is only forwarded to \`hdb.log\` when \`logging.console: true\` is explicitly set; it is not forwarded by default.
-- When logging to standard streams, run Harper in the foreground (\`harper\`, not \`harper start\`).
-- \`TaggedLogger\` is bound to the configured log level at creation time — always use \`?.\` on its methods.
-`,"programmatic-table-requests":"---\nname: programmatic-table-requests\ndescription: How to interact with Harper tables programmatically using the `tables` object.\nmetadata:\n  mode: generate\n  sources:\n    - reference/v5/database/api.md#`tables`\n    - reference/v5/resources/resource-api.md#Query Object\n    - 'reference/v5/database/api.md#`transaction(context?, callback)`'\n    - >-\n      reference/v5/resources/resource-api.md#`update(target: RequestTarget | Id,\n      updates?: object): Promise<Resource>`\n    - >-\n      reference/v5/resources/resource-api.md#`addTo(property: string, value:\n      number)`\n    - reference/v5/components/javascript-environment.md#Module Loading\n  sourceCommit: 3749d0c54be457a2a65d9a63c738a5dc88989ecd\n  inputHash: ace5c3f4a0ad4519\n---\n\n# Programmatic Table Requests\n\nInstructions for the agent to interact with Harper tables programmatically using the `tables` object and its query API.\n\n## When to Use\n\nApply this rule when writing server-side code that reads from or writes to Harper tables directly — for example, in request handlers, background jobs, or SSR rendering — without going through the REST API. Use it whenever you need to construct queries with `conditions`, `select`, `sort`, or `search(`.\n\n## How It Works\n\n1. **Import `tables`**: Pull `tables` from the `harper` package. Each property on `tables` corresponds to a table defined in `schema.graphql`.\n\n   ```javascript\n   import { tables } from 'harper';\n   const { Product } = tables;\n   // same as: databases.data.Product\n   ```\n\n2. **Define your schema**: Declare tables with `@table` in `schema.graphql`. Each type becomes a property on `tables`.\n\n   ```graphql\n   type Product @table {\n   	id: Long @primaryKey\n   	name: String\n   	price: Float\n   }\n   ```\n\n3. **Create and modify records**: Use `create`, `patch`, and `get` for basic CRUD.\n\n   ```javascript\n   const created = await Product.create({ name: 'Shirt', price: 9.5 });\n   await Product.patch(created.id, { price: Math.round(created.price * 0.8 * 100) / 100 });\n   const record = await Product.get(created.id);\n   ```\n\n4. **Query with `search(`**: Pass a query object to `Product.search(query)`. It returns an async iterable.\n\n   ```javascript\n   const query = {\n   	conditions: [{ attribute: 'price', comparator: 'less_than', value: 8.0 }],\n   };\n   for await (const record of Product.search(query)) {\n   	// process record\n   }\n   ```\n\n5. **Build `conditions`**: Each condition object filters records. Nest conditions with `operator` for boolean logic.\n\n   | Property     | Description                                                                                                                                              |\n   | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |\n   | `attribute`  | Property name, or array for chained/joined properties (e.g. `['brand', 'name']`)                                                                         |\n   | `value`      | The value to match                                                                                                                                       |\n   | `comparator` | `equals` (default), `greater_than`, `greater_than_equal`, `less_than`, `less_than_equal`, `starts_with`, `contains`, `ends_with`, `between`, `not_equal` |\n   | `conditions` | Nested conditions array                                                                                                                                  |\n   | `operator`   | `and` (default) or `or` for the nested `conditions`                                                                                                      |\n\n6. **Use `select`** to control which properties are returned. Accepts an array of property names, a string for a single property, or nested objects for relationships.\n\n   ```javascript\n   // Array of names\n   Product.search({ select: ['name', 'price'] });\n\n   // Nested relationship select\n   Book.get({ id: 42, select: ['id', 'title', { name: 'author', select: ['name'] }] });\n   ```\n\n   Special `select` values:\n   - `$id` — returns the primary key regardless of its name\n   - `$updatedtime` — returns the last-updated timestamp\n   - `$distance` — returns the computed distance when querying a vector index\n\n7. **Use `addTo`** for concurrent-safe numeric increments (CRDT incrementation, safe across threads and nodes).\n\n   ```javascript\n   const record = await Product.update(target.id);\n   record.addTo('quantity', -1);\n   ```\n\n8. **Apply `sort`, `limit`, and `offset`** for ordering and pagination. A `sort` attribute must be `@indexed`, or at least one `conditions` entry must be present. Pass `allowFullScan: true` to permit an unconditional ordered scan.\n\n   ```javascript\n   Product.search({\n   	conditions: [{ attribute: 'id', comparator: 'greater_than', value: '' }],\n   	sort: { attribute: 'id' },\n   });\n   ```\n\n   | Sort property | Description                                                |\n   | ------------- | ---------------------------------------------------------- |\n   | `attribute`   | Property name (or array for chained relationship property) |\n   | `descending`  | Sort descending if `true` (default: `false`)               |\n   | `next`        | Secondary sort to resolve ties (same structure)            |\n\n## Examples\n\n**Nested conditions with `or`:**\n\n```javascript\nProduct.search({\n	conditions: [\n		{ attribute: 'price', comparator: 'less_than', value: 100 },\n		{\n			operator: 'or',\n			conditions: [\n				{ attribute: 'rating', comparator: 'greater_than', value: 4 },\n				{ attribute: 'featured', value: true },\n			],\n		},\n	],\n});\n```\n\n**Chained attribute reference (relationship join):**\n\n```javascript\nProduct.search({ conditions: [{ attribute: ['brand', 'name'], value: 'Harper' }] });\n```\n\n**Deep nested `select` across multiple relationships:**\n\n```javascript\nProduct.search({\n	select: [\n		'id',\n		'name',\n		{ name: 'segments', select: ['id', 'name', { name: 'client', select: ['id', 'name'] }] },\n	],\n});\n```\n\n**SSR usage — read directly from `tables` in a render function:**\n\n```typescript\nimport { tables } from 'harper';\n\nexport async function render(url: string): Promise<string> {\n	const product = await tables.Product.get(idFromUrl(url));\n	return renderToString(/* <App product={product} /> */);\n}\n```\n\n## Notes\n\n- Scope destructive operations (`update`, `patch`, `delete`) with specific `conditions` and validate the affected set before writing. These operate on live data and are not easily reversible.\n- Sorting by a bare `@primaryKey` with no conditions raises `HdbError: <attribute> is not indexed and not combined with any other conditions`. Add an open-ended condition or pass `allowFullScan: true`.\n- Selecting a relationship field without filtering on it behaves as a **LEFT JOIN**. Adding a condition on a related attribute (e.g. `attribute: ['author', 'name']`) behaves as an **INNER JOIN**.\n- A to-many relationship resolves to an array; `await` the property before iterating when needed.\n- `tables` and `databases.data` reference the same live objects — a record written through one component is immediately visible to all others.\n- Keep `harper` external when bundling for SSR (e.g. `ssr: { external: ['harper'] }` in `vite.config`) so it resolves to the runtime.\n","querying-rest-apis":'---\nname: querying-rest-apis\ndescription: \'How to use query parameters to filter, sort, and paginate Harper REST APIs.\'\nmetadata:\n  mode: generate\n  sources:\n    - reference/v5/rest/querying.md\n  sourceCommit: 3749d0c54be457a2a65d9a63c738a5dc88989ecd\n  inputHash: d5ed0e937cd2d7e0\n---\n\n# Querying Harper REST APIs\n\nInstructions for the agent to filter, sort, select, and paginate records using Harper\'s URL-based query language on REST collection endpoints.\n\n## When to Use\n\nApply this rule when building or debugging REST API calls against Harper tables that require filtering by attribute values, comparison ranges, sorting, field selection, or result pagination. This rule also covers OR logic, grouping, and querying across related tables via dot-syntax joins. See [automatic-apis.md](automatic-apis.md) for how Harper exposes tables as REST endpoints.\n\n## How It Works\n\n1. **Filter by attribute**: Add query parameters matching attribute names and values. The queried attribute must be indexed.\n\n   ```\n   GET /Product/?category=software\n   GET /Product/?category=software&inStock=true\n   ```\n\n2. **Filter for null values**: Use `=null` as the value to match null or non-null records.\n\n   ```\n   GET /Product/?discount=null\n   ```\n\n3. **Apply comparison operators (FIQL syntax)**: Use FIQL operators in query parameters for range and string matching.\n\n   | Operator             | Meaning                                |\n   | -------------------- | -------------------------------------- |\n   | `==`                 | Equal                                  |\n   | `=lt=`               | Less than                              |\n   | `=le=`               | Less than or equal                     |\n   | `=gt=`               | Greater than                           |\n   | `=ge=`               | Greater than or equal                  |\n   | `=ne=`, `!=`         | Not equal                              |\n   | `=ct=`               | Contains (strings)                     |\n   | `=sw=`, `==<value>*` | Starts with (strings)                  |\n   | `=ew=`               | Ends with (strings)                    |\n   | `=`, `===`           | Strict equality (no type conversion)   |\n   | `!==`                | Strict inequality (no type conversion) |\n\n   ```\n   GET /Product/?price=gt=100\n   GET /Product/?price=le=20\n   GET /Product/?name==Keyboard*\n   GET /Product/?category=software&price=gt=100&price=lt=200\n   ```\n\n   For date fields, URL-encode colons as `%3A`:\n\n   ```\n   GET /Product/?listDate=gt=2017-03-08T09%3A30%3A00.000Z\n   ```\n\n4. **Chain conditions for range queries**: Omit the attribute name on the second condition to apply it to the same attribute. Only `gt`/`ge` combined with `lt`/`le` is supported for chaining.\n\n   ```\n   GET /Product/?price=gt=100&lt=200\n   ```\n\n5. **Apply type conversion**: For FIQL comparators, Harper converts values automatically. Use explicit prefixes to force a type.\n\n   | Syntax                                    | Behavior                                    |\n   | ----------------------------------------- | ------------------------------------------- |\n   | `name==null`                              | Converts to `null`                          |\n   | `name==123`                               | Converts to number if attribute is untyped  |\n   | `name==true`                              | Converts to boolean if attribute is untyped |\n   | `name==number:123`                        | Explicit number conversion                  |\n   | `name==boolean:true`                      | Explicit boolean conversion                 |\n   | `name==string:some%20text`                | Keep as string with URL decode              |\n   | `name==date:2024-01-05T20%3A07%3A27.955Z` | Explicit Date conversion                    |\n\n   For strict operators (`=`, `===`, `!==`), no automatic type conversion is applied.\n\n6. **Combine conditions with OR logic**: Use `|` instead of `&` to express OR between conditions.\n\n   ```\n   GET /Product/?rating=5|featured=true\n   ```\n\n7. **Group conditions**: Use parentheses or square brackets to control evaluation order. Prefer square brackets when building queries from user input, since `[` and `]` are safely URI-encoded.\n\n   ```\n   GET /Product/?rating=5|(price=gt=100&price=lt=200)\n   GET /Product/?rating=5&[tag=fast|tag=scalable|tag=efficient]\n   ```\n\n   Build grouped queries in JavaScript:\n\n   ```javascript\n   let url = `/Product/?rating=5&[${tags.map(encodeURIComponent).join(\'|\')}]`;\n   ```\n\n   Nest groups for complex conditions:\n\n   ```\n   GET /Product/?price=lt=100|[rating=5&[tag=fast|tag=scalable|tag=efficient]&inStock=true]\n   ```\n\n8. **Select specific properties with `select(`**: Append `select(...)` as a query function separated by `&` to control which fields are returned.\n\n   | Syntax                                 | Returns                                     |\n   | -------------------------------------- | ------------------------------------------- |\n   | `?select(property)`                    | Values of a single property directly        |\n   | `?select(property1,property2)`         | Objects with only the specified properties  |\n   | `?select([property1,property2])`       | Arrays of property values                   |\n   | `?select(property1,)`                  | Objects with a single specified property    |\n   | `?select(property{subProp1,subProp2})` | Nested objects with specific sub-properties |\n\n   ```\n   GET /Product/?category=software&select(name)\n   GET /Product/?brand.name=Microsoft&select(name,brand{name})\n   ```\n\n9. **Paginate results with `limit(`**: Use `limit(end)` or `limit(start,end)` to restrict the number of records returned.\n\n   ```\n   GET /Product/?rating=gt=3&inStock=true&select(rating,name)&limit(20)\n   GET /Product/?rating=gt=3&limit(10,30)\n   ```\n\n10. **Sort results with `sort(`**: Use `sort(property)` or `sort(+property,-property,...)` to order results. Prefix `+` or no prefix = ascending; `-` = descending.\n\n    ```\n    GET /Product/?rating=gt=3&sort(+name)\n    GET /Product/?sort(+rating,-price)\n    ```\n\n11. **Query across relationships using dot-syntax**: Filter on related table attributes using dot-chained property names. Relationships must be defined in the schema with `@relationship`.\n\n    ```\n    GET /Product/?brand.name=Microsoft\n    GET /Brand/?products.name=Keyboard\n    ```\n\n    Use `select()` to include relationship attributes in the response (they are excluded by default):\n\n    ```\n    GET /Product/?brand.name=Microsoft&select(name,brand)\n    GET /Product/?brand.name=Microsoft&select(name,brand{name})\n    ```\n\n12. **Access a specific property by URL**: Append `.propertyName` to a record ID in the URL path. Only works for properties declared in the schema.\n    ```\n    GET /MyTable/123.propertyName\n    ```\n\n## Examples\n\n**Range filter with select and limit**:\n\n```\nGET /Product/?category=software&price=gt=100&price=lt=200&select(name,price)&limit(20)\n```\n\n**Sort and paginate**:\n\n```\nGET /Product/?rating=gt=3&sort(+rating,-price)&limit(10,30)\n```\n\n**OR with grouping**:\n\n```\nGET /Product/?price=lt=100|[rating=5&[tag=fast|tag=scalable|tag=efficient]&inStock=true]\n```\n\n**Join query with nested select** — schema first:\n\n```graphql\ntype Product @table @export {\n	id: Long @primaryKey\n	name: String\n	brandId: Long @indexed\n	brand: Brand @relationship(from: "brandId")\n}\ntype Brand @table @export {\n	id: Long @primaryKey\n	name: String\n	products: [Product] @relationship(to: "brandId")\n}\n```\n\nThen query:\n\n```\nGET /Product/?brand.name=Microsoft&select(name,brand{name,id})\n```\n\n**Many-to-many relationship** — schema:\n\n```graphql\ntype Product @table @export {\n	id: Long @primaryKey\n	name: String\n	resellerIds: [Long] @indexed\n	resellers: [Reseller] @relationship(from: "resellerIds")\n}\n```\n\nQuery:\n\n```\nGET /Product/?resellers.name=Cool Shop&select(id,name,resellers{name,id})\n```\n\n**Date range with URL-encoded colons**:\n\n```\nGET /Product/?listDate=gt=2017-03-08T09%3A30%3A00.000Z\n```\n\n## Notes\n\n- All filtered attributes must be indexed unless at least one other attribute in the same query is indexed.\n- Null queries (`?attr=null`) require indexes created after null indexing support was added. Rebuild existing indexes (remove and re-add) to enable null queries on them.\n- When selecting a related attribute without filtering on it, the join behaves as a LEFT JOIN — the relationship property is omitted if the foreign key is null or references a non-existent record.\n- The array order of foreign key values (e.g., `resellerIds`) is preserved when resolving many-to-many relationships.\n- Square brackets (`[`, `]`) are preferred over parentheses for grouping when constructing queries programmatically, because standard URI encoding safely encodes them.\n- `directURLMapping: true` can be set on a resource to change URL path handling semantics; see your schema configuration for details.\n',"real-time-apps":`---
-name: real-time-apps
-description: How to build real-time features in Harper using WebSockets and Pub/Sub.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/rest/websockets.md
-  sourceCommit: b7fbddadd42eb4487190b650a9abc4bcfeef5819
-  inputHash: a8afd4d3a52f77ba
----
-
-# Real-Time Apps with WebSockets and Pub/Sub
-
-Instructions for the agent to follow when building real-time features in Harper using WebSockets and Pub/Sub.
-
-## When to Use
-
-Apply this rule when implementing any feature that requires real-time bidirectional communication, live data streaming, or push-based updates in a Harper application. This includes chat, live dashboards, sensor feeds, and any scenario where clients must receive resource changes as they happen.
-
-## How It Works
-
-1. **Enable WebSocket support**: WebSocket support is enabled automatically when the \`rest\` plugin is enabled. To explicitly disable it, set the following in your config:
-
-   \`\`\`yaml
-   rest:
-     webSocket: false
-   \`\`\`
-
-2. **Connect a client to a resource**: A WebSocket connection to a resource URL automatically subscribes to that resource. When the record changes or a message is published to it, the connection receives the update.
-
-   \`\`\`javascript
-   let ws = new WebSocket('wss://server/my-resource/341');
-   ws.onmessage = (event) => {
-   	let data = JSON.parse(event.data);
-   };
-   \`\`\`
-
-   \`new WebSocket('wss://server/my-resource/341')\` accesses the resource defined for \`my-resource\` with record id \`341\` and subscribes to it.
-
-3. **Implement a custom \`connect()\` handler**: Override the \`connect(incomingMessages)\` method on a resource class to control WebSocket behavior. The method must return an async iterable (or generator) that produces messages to send to the client. See [automatic-apis.md](automatic-apis.md) for more on defining resource classes.
-
-4. **Use the default \`connect()\` for event-style access**: Call \`super.connect()\` to get a streaming iterable that provides:
-   - A \`send(message)\` method for pushing outgoing messages
-   - A \`close\` event for cleanup on disconnect
-
-5. **Handle message ordering in distributed environments**: Harper delivers messages to local subscribers immediately without inter-node coordination delay.
-
-   | Message Type                                             | Behavior                                                                |
-   | -------------------------------------------------------- | ----------------------------------------------------------------------- |
-   | Non-retained (no \`retain\` flag)                          | Every message delivered in order received; suitable for chat            |
-   | Retained (published with \`retain\`, or PUT/updated in DB) | Only the latest-timestamp message is kept; suitable for sensor readings |
-
-6. **Use MQTT over WebSockets** when needed by setting the sub-protocol header:
-   \`\`\`
-   Sec-WebSocket-Protocol: mqtt
-   \`\`\`
-
-## Examples
-
-**Simple echo server** — override \`connect(incomingMessages)\` to yield each incoming message back to the client:
-
-\`\`\`javascript
-export class Echo extends Resource {
-	async *connect(incomingMessages) {
-		for await (let message of incomingMessages) {
-			yield message; // echo each message back
-		}
-	}
-}
-\`\`\`
-
-**Custom connect with timer and event-style access** — use \`super.connect()\` to get the outgoing stream, push periodic messages, echo incoming messages, and clean up on disconnect:
-
-\`\`\`javascript
-export class Example extends Resource {
-	connect(incomingMessages) {
-		let outgoingMessages = super.connect();
-
-		let timer = setInterval(() => {
-			outgoingMessages.send({ greeting: 'hi again!' });
-		}, 1000);
-
-		incomingMessages.on('data', (message) => {
-			outgoingMessages.send(message); // echo incoming messages
-		});
-
-		outgoingMessages.on('close', () => {
-			clearInterval(timer);
-		});
-
-		return outgoingMessages;
-	}
-}
-\`\`\`
-
-## Notes
-
-- WebSocket connections target a resource URL path. By default, connecting to a resource subscribes to changes for that resource.
-- The \`connect(incomingMessages)\` method **must** return an async iterable or generator; returning a plain value will not work.
-- \`super.connect()\` returns a streaming iterable with \`send(message)\` and a \`close\` event — use this when you need to push messages outside of the incoming message loop.
-- For one-way real-time streaming without bidirectional communication, consider Server-Sent Events instead.
-- For full pub/sub capabilities, Harper also supports MQTT; set \`Sec-WebSocket-Protocol: mqtt\` to use MQTT over WebSockets.
-`,"schema-design-tooling":'---\nname: schema-design-tooling\ndescription: >-\n  Best practices for Harper schema design, including core directives and GraphQL\n  tooling configuration.\nmetadata:\n  mode: generate\n  sources:\n    - reference/v5/database/schema.md#Overview\n    - reference/v5/database/schema.md#Type Directives\n    - reference/v5/database/schema.md#Field Directives\n  sourceCommit: 3749d0c54be457a2a65d9a63c738a5dc88989ecd\n  inputHash: ce22f3fefb660c6e\n---\n\n# Schema Design and GraphQL Tooling\n\nInstructions for the agent to follow when designing Harper schemas, applying core directives, and configuring GraphQL tooling.\n\n## When to Use\n\nApply this rule when creating or modifying Harper schema files (`.graphql`), configuring `graphqlSchema` in `config.yaml`, or deciding which directives to apply to types and fields. Use it any time you need to define tables, primary keys, indexes, or exported endpoints.\n\n## How It Works\n\n1. **Declare the schema file** in the component\'s `config.yaml` using the `graphqlSchema` plugin:\n\n   ```yaml\n   graphqlSchema:\n     files: \'schema.graphql\'\n   ```\n\n   Both plugins and applications can specify schemas.\n\n2. **Mark types as tables** with `@table`. The type name becomes the table name by default:\n\n   ```graphql\n   type Dog @table {\n   	id: Long @primaryKey\n   	name: String\n   	breed: String\n   	age: Int\n   }\n   ```\n\n3. **Set a primary key** on every table using `@primaryKey`. Primary keys must be unique; duplicate-key inserts are rejected. If no primary key is provided on insert, Harper auto-generates one based on the field type:\n   - `String` or `ID` → UUID string\n   - `Int`, `Long`, or `Any` → auto-incrementing integer\n\n   Use `Long` or `Any` for auto-generated numeric keys; `Int` is 32-bit and may be insufficient for large tables.\n\n4. **Index fields for querying** with `@indexed`. Required for filtering by an attribute in REST queries, SQL, or NoSQL operations:\n\n   ```graphql\n   type Breed @table {\n   	id: Long @primaryKey\n   	name: String @indexed\n   }\n   ```\n\n   If the field value is an array, each element is individually indexed. Null values are indexed by default.\n\n5. **Expose a table as an external endpoint** with `@export`. Available via REST, MQTT, and other interfaces. The optional `name` parameter sets the URL path segment:\n\n   ```graphql\n   type MyTable @table @export(name: "my-table") {\n   	id: Long @primaryKey\n   }\n   ```\n\n   Without `name`, the type name is used.\n\n6. **Configure `@table` arguments** as needed. All arguments are optional:\n\n   | Argument       | Type      | Default                       | Description                                                   |\n   | -------------- | --------- | ----------------------------- | ------------------------------------------------------------- |\n   | `table`        | `String`  | type name                     | Override the table name                                       |\n   | `database`     | `String`  | `"data"`                      | Database to place the table in                                |\n   | `expiration`   | `Int`     | —                             | Seconds until a record goes stale                             |\n   | `eviction`     | `Int`     | `0`                           | Additional seconds after `expiration` before physical removal |\n   | `scanInterval` | `Int`     | `(expiration + eviction) / 4` | Seconds between eviction scans                                |\n   | `replicate`    | `Boolean` | `true`                        | Enable replication of this table                              |\n\n7. **Apply additional field directives** where needed:\n   - `@createdTime` — auto-assigns creation timestamp (Unix epoch ms)\n   - `@updatedTime` — auto-assigns update timestamp (Unix epoch ms)\n   - `@expiresAt` — marks a field as the record\'s absolute expiration time (Unix epoch ms)\n   - `@embed(source:, model:)` — computes an embedding vector when the source field is written; field type must be `[Float]`\n   - `@hidden` — suppresses the field from MCP tool descriptors and OpenAPI document (not an access-control mechanism)\n\n8. **Use `@sealed`** on a type to prevent records from including properties beyond those declared in the schema:\n\n   ```graphql\n   type StrictRecord @table @sealed {\n   	id: Long @primaryKey\n   	name: String\n   }\n   ```\n\n9. **Use unique database names** in plugins or applications to avoid table naming collisions, since all tables default to the `data` database.\n\n## Examples\n\n**Minimal schema with two tables:**\n\n```graphql\ntype Dog @table {\n	id: Long @primaryKey\n	name: String\n	breed: String\n	age: Int\n}\n\ntype Breed @table {\n	id: Long @primaryKey\n	name: String @indexed\n}\n```\n\n**Table with expiration, eviction, and scan tuning:**\n\n```graphql\n# Expire after 5 minutes, evict after 1 hour, scan every 10 minutes\ntype WeatherCache @table(expiration: 300, eviction: 3300, scanInterval: 600) {\n	id: ID @primaryKey\n	temperature: Float\n}\n```\n\n**Table with multiple `@table` arguments combined:**\n\n```graphql\ntype Event @table(database: "analytics", expiration: 86400) {\n	id: Long @primaryKey\n	name: String @indexed\n}\n```\n\n**Exported table with overridden table name:**\n\n```graphql\ntype Product @table(table: "products") @export(name: "products") {\n	id: Long @primaryKey\n	category: String @indexed\n	price: Float @indexed\n}\n```\n\n**Table with timestamps and per-record expiration:**\n\n```graphql\ntype Session @table {\n	id: ID @primaryKey\n	token: String\n	createdAt: Long @createdTime\n	updatedAt: Long @updatedTime\n	expiresAt: Long @expiresAt\n}\n```\n\n**Table with a hidden internal field:**\n\n```graphql\ntype Customer @table {\n	id: Long @primaryKey\n	name: String\n\n	"""\n	Internal — do not surface to external consumers.\n	"""\n	creditScore: Int @hidden\n}\n```\n\n## Notes\n\n- `@table`, `@export`, `@sealed`, and `@hidden` are type-level directives; `@primaryKey`, `@indexed`, `@embed`, `@createdTime`, `@updatedTime`, `@expiresAt`, and `@hidden` are field-level directives.\n- `eviction` removes non-indexed record data but does **not** remove a record from its secondary indexes. Indexes remain functional for evicted records; Harper fetches the full record on demand when a query matches an evicted entry.\n- `scanInterval` is clock-aligned to the server\'s local timezone, not startup-aligned. The server\'s startup time does not affect when eviction runs.\n- Replication is enabled by default. If you disable replication on a table and re-enable it later, it will not catch up on writes made while replication was disabled.\n- `@hidden` is a metadata-visibility directive only. Use `attribute_permissions` on roles to enforce data access control.\n- A full-record `put` that omits an `@expiresAt` field clears it; a `patch` of other fields preserves it.\n',"serving-web-content":"---\nname: serving-web-content\ndescription: How to serve static files and integrated Vite/React applications in Harper.\nmetadata:\n  mode: synthesized\n---\n\n# Serving Web Content\n\nInstructions for the agent to follow when serving web content from Harper.\n\n## When to Use\n\nUse this skill when you need to serve a frontend (HTML, CSS, JS, or a React/Vue app) directly from your Harper instance — either plain static files or an integrated Vite app with hot module replacement (HMR) in development and a real production build when deployed.\n\n## How It Works\n\nThere are two building blocks. Harper's built-in `static` plugin **serves** files; the `@harperfast/vite` plugin **builds** (and, for SSR, **renders**) a Vite app. For a Vite app they work **together** — the plugin builds into a directory and `static` serves that same directory.\n\n### Option A: Static plugin only (simple, pre-built assets)\n\nFor a plain static site or already-built assets, use `static` on its own:\n\n```yaml\nstatic:\n  files: 'web/*'\n```\n\n- Place files in a `web/` folder in the project root; they are served from the root URL (e.g. `http://localhost:9926/index.html`).\n- Static files are matched first; if none matches, Harper falls through to your resource and table APIs.\n\n### Option B: Vite plugin + static plugin (integrated Vite app)\n\n> **Renamed in v1:** the plugin was previously `@harperfast/vite-plugin`. From `1.0.0` on it is **`@harperfast/vite`** (same key and `package`). It now pairs with the `static` plugin instead of building into `web/` itself.\n\n`@harperfast/vite` **builds** your app — in `harper dev` it runs Vite in middleware mode with HMR; in `harper run` it runs `vite build` and rebuilds when watched files change (and renders HTML for SSR). The `static` plugin **serves** the built output. Point both at the same directory (`output`, default `dist`) — that shared directory is the only contract between them.\n\n**SPA `config.yaml`** — list the plugin first so its dev server wins in `harper dev`; `notFound` + `fallthrough: false` makes client-side routing work:\n\n```yaml\n'@harperfast/vite':\n  package: '@harperfast/vite'\n  files: 'src/**/*'\n  output: 'dist'\n\nstatic:\n  files: 'dist/**'\n  notFound:\n    file: 'index.html'\n    statusCode: 200\n  fallthrough: false\n```\n\n**SSR `config.yaml`** — add an `ssr` entry so the plugin renders `index.html`, and set `index: false` on `static` so it serves assets only:\n\n```yaml\n'@harperfast/vite':\n  package: '@harperfast/vite'\n  files: 'src/**/*'\n  output: 'dist'\n  ssr: 'src/entry-server.tsx'\n\nstatic:\n  files: 'dist/**'\n  index: false\n```\n\n- Install dependencies: `npm install --save-dev vite @harperfast/vite @vitejs/plugin-react` (swap in your framework's Vite plugin, e.g. `@vitejs/plugin-vue`).\n- Then `harper dev .` runs the app with HMR and `harper run .` runs the production build. Vite does _not_ need to be executed separately.\n\n## Reading Harper Data During SSR\n\nThe render entry (`src/entry-server.tsx`) runs **inside Harper**, so it can read straight from the database and render the data into the HTML — no client-side fetch/XHR. `tables` is the same live, process-wide registry available everywhere (see [Programmatic Table Requests](programmatic-table-requests.md)); import it and query a table in an async `render`:\n\n```tsx\nimport { tables } from 'harper';\n\nexport async function render(url: string): Promise<string> {\n	const product = await tables.Product.get(idFromUrl(url));\n	return renderToString(\n		<StrictMode>\n			<App product={product} />\n		</StrictMode>,\n	);\n}\n```\n\nKeep `harper` external in `vite.config.ts` so this import resolves to Harper's running runtime instead of being bundled. `node_modules/harper` is symlinked to the running install, and symlinked deps aren't reliably auto-externalized for SSR:\n\n```typescript\nexport default defineConfig({\n	ssr: { external: ['harper'] },\n	// ...plugins, resolve, build\n});\n```\n\nTo hydrate on the client without re-fetching, embed the rendered data in the HTML (e.g. an inline `<script type=\"application/json\">`) and read it back before hydration — so the page needs no XHR at all.\n\n## Deploying to Production\n\nBecause `@harperfast/vite` builds on the node and `static` serves the output, deploy the component as-is — no manual build-and-move step is needed:\n\n```json\n{\n	\"scripts\": {\n		\"dev\": \"harper dev .\",\n		\"start\": \"harper run .\",\n		\"deploy\": \"harper deploy_component . restart=true replicated=true\"\n	}\n}\n```\n\nOn deploy the plugin runs `vite build` at startup (and rebuilds when `files` change) while `static` serves the result. If you prefer to build in CI, commit the build output, point `static` at it, and omit `files` so the plugin stays idle while `static` serves the prebuilt assets. Either way, `npm create harper@latest` scaffolds a working setup for you.\n","typescript-type-stripping":`---
-name: typescript-type-stripping
-description: How to run TypeScript files directly in Harper without a build step.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/components/javascript-environment.md#TypeScript Support
-  sourceCommit: b7fbddadd42eb4487190b650a9abc4bcfeef5819
-  inputHash: 4e6bd8b610edd595
----
-
-# TypeScript Type Stripping in Harper
-
-Instructions for the agent to run \`.ts\` files directly in Harper without a build step using Node.js's built-in type stripping.
-
-## When to Use
-
-Apply this rule when writing Harper resource files in TypeScript. Use it any time you need to reference \`.ts\` source files from \`config.yaml\` or import between local TypeScript modules in a Harper project.
-
-## How It Works
-
-1. **Ensure Node.js version**: Require Node.js 22.6 or later. Type stripping is unavailable on earlier versions.
-
-2. **Point \`jsResource\` at \`.ts\` files**: The \`jsResource\` plugin loads both \`.js\` and \`.ts\` files. Set its \`files\` glob in \`config.yaml\` to target your \`.ts\` source files:
-
-   \`\`\`yaml
-   jsResource:
-     files: 'resources/*.ts'
-   \`\`\`
-
-3. **Use explicit \`.ts\` extensions in local imports**: Node's loader does not resolve \`'./helper'\` to \`'./helper.ts'\`, so always include the full extension:
-
-   \`\`\`typescript
-   import { helper } from './helper.ts';
-   \`\`\`
-
-4. **Stay within type-stripping limits**: Only type annotations and declarations are removed. Do not use enums with runtime values, namespaces with runtime semantics, or any other features that require code transformation beyond type stripping.
-
-## Examples
-
-A complete Harper resource written in TypeScript, using imports from the \`harper\` package:
-
-\`\`\`typescript
-import { type RequestTargetOrId, Resource, tables } from 'harper';
-
-export class MyResource extends Resource {
-	async get(target?: RequestTargetOrId): Promise<{ message: string }> {
-		return { message: 'Hello from TS' };
-	}
-}
-\`\`\`
-
-Paired \`config.yaml\` entry loading the file via \`jsResource\`:
-
-\`\`\`yaml
-jsResource:
-  files: 'resources/*.ts'
-\`\`\`
-
-## Notes
-
-- No build step or transpiler is required — Harper runs \`.ts\` files directly.
-- Type imports (e.g., \`import { type RequestTargetOrId }\`) from the \`harper\` package work as usual.
-- Unsupported TypeScript features include: enums with runtime values, namespaces with runtime semantics, and anything requiring code transformation beyond simple type stripping.
-`,"using-blob-datatype":"---\nname: using-blob-datatype\ndescription: How to use the Blob data type for efficient binary storage in Harper.\nmetadata:\n  mode: generate\n  sources:\n    - reference/v5/database/schema.md#Blob Type\n    - reference/v5/database/api.md#Streaming\n    - reference/v5/database/api.md#`BlobOptions`\n    - reference/v5/database/api.md#Blob Coercion\n  sourceCommit: f37a8c4021e20d5c74c1d339a6b6c8c196b5603e\n  inputHash: 92e03eb0b830f335\n---\n\n# Using the Blob Data Type\n\nInstructions for the agent to follow when storing and retrieving large binary content using the `Blob` data type in Harper.\n\n## When to Use\n\nApply this rule when a schema field needs to store large binary content such as images, video, audio, or large HTML — typically content larger than 20KB. Use `Blob` instead of `Bytes` when streaming support and out-of-record storage are required. See [handling-binary-data.md](handling-binary-data.md) for broader binary data guidance.\n\n## How It Works\n\n1. **Declare a `Blob` field in your schema**: Add a field typed as `Blob` to your `@table` type.\n\n   ```graphql\n   type MyTable @table {\n   	id: Any! @primaryKey\n   	data: Blob\n   }\n   ```\n\n2. **Create and store a blob with `createBlob()`**: Pass a buffer or stream to `createBlob()`, then `put` the record.\n\n   ```javascript\n   let blob = createBlob(largeBuffer);\n   await MyTable.put({ id: 'my-record', data: blob });\n   ```\n\n3. **Retrieve blob data using standard Web API methods**: The `Blob` type implements the Web API `Blob` interface. Use `.bytes()`, `.text()`, `.arrayBuffer()`, `.stream()`, or `.slice()` as needed.\n\n   ```javascript\n   let record = await MyTable.get('my-record');\n   let buffer = await record.data.bytes(); // ArrayBuffer\n   let text = await record.data.text(); // string\n   let stream = record.data.stream(); // ReadableStream\n   ```\n\n4. **Use `saveBeforeCommit` when full write must precede commit**: By default, `Blob` is not ACID-compliant — a record can reference a blob before it is fully written. Set `saveBeforeCommit: true` to block the transaction until the blob is fully saved.\n\n   ```javascript\n   let blob = createBlob(stream, { saveBeforeCommit: true });\n   await MyTable.put({ id: 'my-record', data: blob });\n   // put() resolves only after blob is fully written and record is committed\n   ```\n\n5. **Register an error handler when returning a blob via REST**: Interrupted streams must be handled explicitly.\n\n   ```javascript\n   export class MyEndpoint extends MyTable {\n   	static async get(target) {\n   		const record = super.get(target);\n   		let blob = record.data;\n   		blob.on('error', () => {\n   			MyTable.invalidate(target);\n   		});\n   		return { status: 200, headers: {}, body: blob };\n   	}\n   }\n   ```\n\n6. **Rely on automatic coercion where applicable**: When a field is typed as `Blob` in the schema, any string or buffer assigned via `put`, `patch`, or `publish` is automatically coerced to a `Blob` — no manual `createBlob()` call is needed in those cases.\n\n### `BlobOptions` reference\n\nPass an options object as the second argument to `createBlob()`.\n\n| Option             | Type      | Default     | Description                                                                                                              |\n| ------------------ | --------- | ----------- | ------------------------------------------------------------------------------------------------------------------------ |\n| `type`             | `string`  | `undefined` | MIME type to associate with the blob (e.g., `image/jpeg`). Readable via `blob.type` and used when serving HTTP.          |\n| `size`             | `number`  | `undefined` | Size of the data in bytes, if known ahead of time. Otherwise inferred from a buffer or determined as a stream completes. |\n| `saveBeforeCommit` | `boolean` | `false`     | Wait until the blob is fully written before the transaction commits.                                                     |\n| `compress`         | `boolean` | `false`     | Compress the stored data with deflate.                                                                                   |\n| `flush`            | `boolean` | `false`     | Flush the file to disk after writing, before the `createBlob` promise chain resolves.                                    |\n\n## Examples\n\n**Store an image with a MIME type:**\n\n```javascript\nlet blob = createBlob(imageBuffer, { type: 'image/jpeg' });\nawait Photo.put({ id, data: blob });\n```\n\n**Stream a blob in as it streams out (low-latency passthrough):**\n\n```javascript\nlet blob = createBlob(incomingStream);\n// blob exists, but data is still streaming to storage\nawait MyTable.put({ id: 'my-record', data: blob });\n\nlet record = await MyTable.get('my-record');\n// blob data is accessible as it arrives\nlet outgoingStream = record.data.stream();\n```\n\n**Guarantee full write before commit using `saveBeforeCommit`:**\n\n```javascript\nlet blob = createBlob(stream, { saveBeforeCommit: true });\nawait MyTable.put({ id: 'my-record', data: blob });\n```\n\n## Notes\n\n- `Blob` stores data separately from the record. If you need the binary data to be a true, ACID-committed part of the record, use a `Bytes` field instead.\n- All standard Web API `Blob` methods — `.text()`, `.arrayBuffer()`, `.stream()`, `.slice()`, and `.bytes()` — are available on retrieved blob fields.\n- Without `saveBeforeCommit: true`, blobs are **not** ACID-compliant by default; a record can reference a blob before it is fully written to storage.\n","v5-upgrade":"---\nname: v5-upgrade\ndescription: >-\n  Breaking changes and recommended updates when migrating a Harper application\n  to v5.\nmetadata:\n  mode: generate\n  sources:\n    - release-notes/v5-lincoln/v5-migration.md\n  sourceCommit: 3749d0c54be457a2a65d9a63c738a5dc88989ecd\n  inputHash: 5ee6407370219136\n---\n\n# v5 Upgrade: Breaking Changes and Migration Guide\n\nInstructions for the agent to apply when migrating a Harper application to v5, covering all breaking changes and required code updates.\n\n## When to Use\n\nApply this rule when upgrading an existing Harper application to v5, when encountering runtime errors related to renamed packages, changed APIs, or security restrictions introduced in v5, or when reviewing application code for v5 compatibility before deployment.\n\n## How It Works\n\n1. **Update the package import from `harperdb` to `harper`**: All application code must import from `harper` instead of `harperdb`.\n\n   ```javascript\n   import { tables } from 'harper';\n   ```\n\n2. **Enable `allowInstallScripts` if packages require install scripts**: Harper v5 uses `--ignore-scripts` by default when installing packages. If your application requires installation scripts (e.g., to install additional binaries), set the `allowInstallScripts` option when deploying.\n\n3. **Update `Table.get` usage — return value is now a frozen record object**: `Table.get` now returns a plain record object, not a table class instance. The record is frozen; you cannot mutate it directly.\n   - Replace `wasLoadedFromSource()` with `target.loadedFromSource`:\n\n     ```javascript\n     // Old — remove this pattern:\n     const record = await Table.get(id);\n     if (record.wasLoadedFromSource()) { ... }\n\n     // New — use loadedFromSource on the target:\n     const target = new RequestTarget();\n     target.id = id;\n     const record = await Table.get(target);\n     if (target.loadedFromSource) {\n       // record was loaded from origin (not cache)\n     }\n     ```\n\n   - Replace in-place mutation with object spread, since records are frozen:\n\n     ```javascript\n     // Old — throws in v5:\n     const record = await Table.get(id);\n     record.property = 'changed';\n\n     // New — copy instead of mutate:\n     let record = await Table.get(id);\n     record = { ...record, property: 'changed' };\n     ```\n\n   - `getUpdatedTime` and `getExpiresAt` methods remain available on the record object.\n\n4. **Update transaction and context handling**: Harper v5 uses asynchronous context tracking. `Table.get` and other table calls now automatically inherit the current transaction context. Code that previously omitted context to bypass a transaction will no longer work as expected. Use `getContext` (imported from `harper`) to access and commit the current transaction explicitly when you need to see updated data.\n\n   ```javascript\n   import { setTimeout as delay } from 'node:timers/promises';\n   import { getContext, transaction } from 'harper';\n\n   class MyResource {\n   	static async get(target) {\n   		// Commit the current transaction to read latest data:\n   		await getContext().transaction.commit();\n   		// Optionally wrap each poll in a new transaction:\n   		while ((await transaction(() => Table.get(target))).status !== 'ready') {\n   			await delay(100);\n   		}\n   		return Table.get(target);\n   	}\n   }\n   ```\n\n5. **Register allowed spawn commands via `allowedSpawnCommands`**: Any use of `spawn`, `exec`, or `execFile` from `node:child_process` must reference executables listed in `applications.allowedSpawnCommands` in `harperdb-config.yaml`. Provide a `name` property in the options argument to ensure only a single named process is started across threads.\n\n6. **Replace `blob.save()` with `saveBeforeCommit`**: The `blob.save()` method has been removed. Use the `saveBeforeCommit` flag in the options passed to the `Blob` constructor instead.\n\n7. **Configure the `moduleLoader` and `lockdown` settings**: Harper v5 loads application modules through Node.js's VM module API. Control this behavior in `harperdb-config.yaml` under the `applications` key.\n\n   | Setting            | Default              | Options                                             |\n   | ------------------ | -------------------- | --------------------------------------------------- |\n   | `moduleLoader`     | `vm-current-context` | `vm-current-context`, `vm`, `native`, `compartment` |\n   | `lockdown`         | `freeze-after-load`  | `freeze-after-load`, `freeze`, `ses`, `none`        |\n   | `dependencyLoader` | `auto`               | `auto`, `app`, `native`                             |\n   | `allowedDirectory` | `app`                | `app`, `any`                                        |\n   - Use `moduleLoader: native` to disable the VM loader entirely and restore pre-v5 behavior (application-specific context such as tagged logging and per-app `config` will not be available).\n   - Use `lockdown: none` as a temporary workaround if a dependency modifies intrinsic prototypes at runtime and throws a `TypeError`.\n\n## Examples\n\n### Full `harperdb-config.yaml` `applications` block\n\n```yaml\napplications:\n  lockdown: freeze-after-load\n  moduleLoader: vm-current-context\n  dependencyLoader: auto\n  allowedDirectory: app\n  allowedSpawnCommands:\n    - npm\n    - node\n```\n\n### Restricting allowed built-in modules\n\n```yaml\napplications:\n  allowedBuiltinModules:\n    - fs\n    - path\n    - http\n```\n\n### Disabling the VM loader for package compatibility\n\n```yaml\napplications:\n  moduleLoader: native\n```\n\n### Accessing context and committing a transaction\n\n```javascript\nimport { getContext } from 'harper';\n\nawait getContext().transaction.commit();\n```\n\n## Notes\n\n- The `lockdown: freeze-after-load` default freezes `Object`, `Array`, `Promise`, `Map`, `Set`, and other intrinsics after all application code loads. Any code or dependency that mutates intrinsic prototypes after startup will throw a `TypeError`.\n- Under `lockdown: ses`, the constrained `fetch` (https-only) is applied only in `vm` mode. In `vm-current-context` and `native` modes, application code uses the standard global `fetch`.\n- In production, `allowedDirectory: app` prevents loading modules from outside the application's own directory tree. Set `allowedDirectory: any` only if your application legitimately requires it.\n- `dependencyLoader: native` is a narrower alternative to `moduleLoader: native` — it uses native loading only for npm packages while keeping the VM loader for first-party application source files.\n- Access Harper functions and APIs through the `harper` package rather than through global variables. Use `getContext` from `harper` to access request context without passing it explicitly through every call.\n","vector-indexing":`---
-name: vector-indexing
-description: How to enable and query vector indexes for similarity search in Harper.
-metadata:
-  mode: generate
-  sources:
-    - reference/v5/database/schema.md#Vector Indexing
-  sourceCommit: d4cbc1a7dd400462e4a3243f944b3a75d89b29ca
-  inputHash: 1dae788bc850ea90
----
-
-# Vector Indexing
-
-Instructions for the agent to enable HNSW vector indexes on table fields and query them for similarity search in Harper.
-
-## When to Use
-
-Apply this rule when adding a vector similarity search capability to a Harper table — for example, storing text embeddings and querying for nearest neighbors, filtering by distance threshold, or combining vector search with record-level access control. See [adding-tables-with-schemas.md](adding-tables-with-schemas.md) for how to define the surrounding table schema.
-
-## How It Works
-
-1. **Declare the vector index** on a \`[Float]\` field using \`@indexed(type: "HNSW")\`:
-
-   \`\`\`graphql
-   type Document @table {
-   	id: Long @primaryKey
-   	textEmbeddings: [Float] @indexed(type: "HNSW")
-   }
-   \`\`\`
-
-2. **Query nearest neighbors** using \`Document.search()\` with the \`sort\` parameter. Set \`attribute\` to the indexed field and \`target\` to the query vector:
-
-   \`\`\`javascript
-   let results = Document.search({
-   	sort: { attribute: 'textEmbeddings', target: searchVector },
-   	limit: 5,
-   });
-   \`\`\`
-
-3. **Combine with filter conditions** to narrow results before or during graph traversal. Selective conditions are automatically diverted to an exact-scan strategy:
-
-   \`\`\`javascript
-   let results = Document.search({
-   	conditions: [{ attribute: 'price', comparator: 'lt', value: 50 }],
-   	sort: { attribute: 'textEmbeddings', target: searchVector },
-   	limit: 5,
-   });
-   \`\`\`
-
-4. **Apply a function predicate during traversal** using \`vectorFilter\` (JavaScript API only). The function receives each candidate record and must return a synchronous boolean. It must be side-effect free and fast:
-
-   \`\`\`javascript
-   let results = Document.search(
-   	{
-   		sort: { attribute: 'textEmbeddings', target: searchVector },
-   		vectorFilter: (record) =>
-   			record.tenantId === context.user.tenantId && record.status === 'published',
-   		limit: 10,
-   	},
-   	context,
-   );
-   \`\`\`
-
-5. **Filter by distance threshold** using \`target\` directly on a condition alongside \`comparator\` and \`value\`. This returns matches within the threshold without using \`sort\`:
-
-   \`\`\`javascript
-   let results = Document.search({
-   	conditions: {
-   		attribute: 'textEmbeddings',
-   		comparator: 'lt',
-   		value: 0.1,
-   		target: searchVector,
-   	},
-   });
-   \`\`\`
-
-6. **Include computed distance in results** by adding \`$distance\` to \`select\`. Works with both \`sort\`-based and threshold queries:
-
-   \`\`\`javascript
-   let results = Document.search({
-   	select: ['name', '$distance'],
-   	sort: { attribute: 'textEmbeddings', target: searchVector },
-   	limit: 5,
-   });
-   \`\`\`
-
-7. **Tune per-query search options** on the \`sort\` descriptor using \`distance\` and \`ef\`:
-
-   \`\`\`javascript
-   let results = Document.search({
-   	sort: { attribute: 'textEmbeddings', target: searchVector, distance: 'dotProduct', ef: 200 },
-   	limit: 5,
-   });
-   \`\`\`
-
-8. **Tune filtered traversal** with \`ef\` and \`filterExpansion\` when a \`vectorFilter\` is very selective. The visit budget is \`ef * filterExpansion\` nodes (\`filterExpansion\` defaults to \`24\`):
-
-   \`\`\`javascript
-   let results = Document.search(
-   	{
-   		sort: { attribute: 'textEmbeddings', target: searchVector, ef: 200, filterExpansion: 40 },
-   		vectorFilter: (record) => record.category === 'rare',
-   		limit: 10,
-   	},
-   	context,
-   );
-   \`\`\`
-
-9. **Enforce row-level access control** using \`rowFilter\` on search and subscription targets (JavaScript API only). Attach it in an operation override. For vector queries, \`rowFilter\` participates in HNSW traversal so callers receive the k nearest _matching_ records:
-
-   \`\`\`javascript
-   function canReadReport(record, context) {
-   	const user = context.user;
-   	if (user?.role?.permission?.super_user) return true;
-   	return user?.username != null && record.ownerId != null && record.ownerId === user.username;
-   }
-
-   export class Reports extends tables.Reports {
-   	search(target) {
-   		target.rowFilter = canReadReport;
-   		return super.search(target);
-   	}
-   }
-   \`\`\`
-
-### HNSW Index Parameters
-
-Configure parameters directly on \`@indexed(type: "HNSW", ...)\`:
-
-| Parameter              | Default           | Description                                                                                      |
-| ---------------------- | ----------------- | ------------------------------------------------------------------------------------------------ |
-| \`distance\`             | \`"cosine"\`        | Distance function: \`"cosine"\`, \`"euclidean"\`, or \`"dotProduct"\`                                  |
-| \`efConstruction\`       | \`100\`             | Max nodes explored during index construction. Higher = better recall, lower = better performance |
-| \`M\`                    | \`16\`              | Preferred connections per graph layer                                                            |
-| \`optimizeRouting\`      | \`0.5\`             | Heuristic aggressiveness for omitting redundant connections (0 = off, 1 = most aggressive)       |
-| \`mL\`                   | computed from \`M\` | Normalization factor for level generation                                                        |
-| \`efConstructionSearch\` | auto-scaled       | Max nodes explored during search. When unset, auto-scales with index size                        |
-| \`quantization\`         | —                 | \`"int8"\` stores vectors quantized to int8                                                        |
-| \`filterExpansion\`      | \`24\`              | Visit-budget multiplier for filtered search: visits at most \`ef * filterExpansion\` nodes         |
-
-Per-query \`sort\` descriptor options:
-
-| Option     | Values                                    | Description                                            |
-| ---------- | ----------------------------------------- | ------------------------------------------------------ |
-| \`distance\` | \`"cosine"\`, \`"euclidean"\`, \`"dotProduct"\` | Overrides the index's distance function for this query |
-| \`ef\`       | integer                                   | Overrides the search exploration budget for this query |
-
-## Examples
-
-**Index with custom HNSW parameters:**
-
-\`\`\`graphql
-type Document @table {
-	id: Long @primaryKey
-	textEmbeddings: [Float]
-		@indexed(type: "HNSW", distance: "euclidean", optimizeRouting: 0, efConstructionSearch: 100)
-}
-\`\`\`
-
-**Index with int8 quantization:**
-
-\`\`\`graphql
-type Document @table {
-	id: Long @primaryKey
-	textEmbeddings: [Float] @indexed(type: "HNSW", quantization: "int8")
-}
-\`\`\`
-
-**Nearest-neighbor search with distance included:**
-
-\`\`\`javascript
-let results = Document.search({
-	select: ['name', '$distance'],
-	sort: { attribute: 'textEmbeddings', target: searchVector },
-	limit: 5,
-});
-\`\`\`
-
-**Filtered traversal with tuned budget:**
-
-\`\`\`javascript
-let results = Document.search(
-	{
-		sort: { attribute: 'textEmbeddings', target: searchVector, ef: 200, filterExpansion: 40 },
-		vectorFilter: (record) => record.category === 'rare',
-		limit: 10,
-	},
-	context,
-);
-\`\`\`
-
-## Notes
-
-- \`vectorFilter\` and \`rowFilter\` are available from the JavaScript API only; they cannot be set through REST or QUERY request data.
-- \`vectorFilter\` functions must be synchronous, side-effect free, and fast — they can run once per candidate record visited during traversal; verdicts are memoized per query. Records passed to them are frozen.
-- \`rowFilter\` does not apply to a direct primary-key \`get\`.
-- Changing \`efConstructionSearch\` on an existing index does not trigger a rebuild. Structural parameters (\`distance\`, \`M\`, \`efConstruction\`, \`quantization\`) do rebuild the index when changed.
-- With \`quantization: "int8"\`, nearest-neighbor \`sort\` queries re-rank results against full-precision vectors, restoring exact ordering and exact \`$distance\` values. Distance-threshold (\`lt\`/\`le\`) queries filter on the approximate distance.
-- The correct parameter name is \`efConstruction\` (seeds the construction budget) and \`efConstructionSearch\` (controls search budget). The name \`efSearchConstruction\` is a previous documentation error.
-- When no \`ef\` is passed and \`efConstructionSearch\` (or \`efConstruction\`) is not explicitly set, the search budget auto-scales with index size.
-- \`cosine\` is the default distance function when \`distance\` is not specified.
-`},ha={name:`readHarperSkill`,description:`Returns documentation for a Harper skill or best practice. Skills provide guidance on developing Harper applications.`,inputSchema:i({skill:p(pa)})};async function ga({input:{skill:e}}){return{success:!!ma[e],message:ma[e]||`No skill found with the name ${e}`}}var _a={...ha,icon:st,execute:ga},va={name:`readLogs`,description:`Returns the matching logs from the server.`,inputSchema:i({log_name:p([`hdb.log`,`system.log`]).default(`hdb.log`),limit:y().or(u()).optional(),level:p([`notify`,`error`,`warn`,`info`,`debug`,`trace`,`undefined`]).or(u()).optional(),from:y().or(u()).optional(),until:y().or(u()).optional()})};async function ya({input:e,instanceClientParams:t}){try{return{success:!0,data:await Be({...t,logFilters:e,replicated:t.entityType===`cluster`})}}catch(e){return{success:!1,message:`Error: ${e}`}}}var ba={...va,icon:dt,execute:ya},xa={name:`readTableRecords`,description:`Retrieves some or all table records from a database on the server.`,inputSchema:i({database:y().trim(),table:y().trim(),pageIndex:c().default(0),pageSize:c().default(10),primaryKey:y(),conditions:_(i({search_attribute:y(),search_type:p([`between`,`eq`,`equals`,`greater_than`,`greater_than_equal`,`less_than`,`less_than_equal`,`ne`,`not_equal`,`starts_with`]),search_value:m()})),sort:i({attribute:y(),descending:o()})})};async function Sa({input:{database:e,table:t,conditions:n,primaryKey:r,...i},instanceClientParams:a}){try{if(!n.length){let{data:n}=await Pe({...a,databaseName:e,tableName:t,onlyIfCached:!0,searchAttribute:r,...i});return{success:!0,data:n}}let{data:o}=await Ae({...a,databaseName:e,tableName:t,onlyIfCached:!0,conditions:n,...i});return{success:!0,data:o}}catch(e){return{success:!1,message:`Error: ${e}`}}}var Ca={...xa,icon:Ke,execute:Sa},wa={name:`restartHTTPService`,description:`Restarts the HTTP service on the server to allow schema and resource changes to be applied.`,inputSchema:i({})};async function Ta({instanceClientParams:e,baseURL:t}){let n=le.loading(`Restarting HTTP service...`,{description:`This may take a bit.`,duration:3e5});try{await tt({...e,operation:`restart_service`,replicated:e.entityType===`cluster`})}catch(e){return{success:!1,message:`Error: ${e}`}}return le.success(`Done!`,{description:`HTTP Service restarted!`,id:n,duration:5e3}),{success:!0,message:`HTTP Service restarted!`,webURL:t}}var Ea={...wa,icon:ze,execute:Ta,requiresApproval:!0},Da={name:`setComponentFile`,description:`Returns the contents of a component file by its full path (which was returned by getComponents)`,inputSchema:i({path:y().trim(),payload:y(),encoding:p([`utf8`,`ASCII`,`binary`,`hex`,`base64`,`utf16le`,`latin1`,`ucs2`])})};async function Oa({input:{path:e,encoding:t,payload:n},instanceClientParams:r}){try{let i=e.split(`/`),a=i.shift(),o=i.join(`/`),s=await Se({...r,file:o,project:a,payload:n,encoding:t});return await Xe.invalidateQueries({queryKey:[r.entityId,`get_component_file`,a,o]}),je(`ReloadApplicationRootEntries`,!0),{success:!0,data:s}}catch(e){return{success:!1,message:`Error: ${e}`}}}var ka={...Da,icon:ut,execute:Oa,requiresApproval:!0},Aa={name:`updateTableRecords`,description:`Updates records in a particular table in a particular database on the server.`,inputSchema:i({database:y().trim(),table:y().trim(),records:_(m())})};async function ja({input:{database:e,table:t,records:n},instanceClientParams:r,params:i}){try{let a=await He({...r,databaseName:e,tableName:t,records:n}),{databaseName:o,tableName:s}=i;return await Xe.invalidateQueries({queryKey:[r.entityId,o,s]}),{success:!0,data:a}}catch(e){return{success:!1,message:`Error: ${e}`}}}var Ma={readHarperSkill:_a,createApp:Fi,readLogs:ba,getAnalytics:Wi,listAnalyticsMetrics:fa,restartHTTPService:Ea,collectFeedback:Mi,getUserContext:aa,getComponentFile:qi,getComponents:Xi,setComponentFile:ka,dropComponentFile:Vi,getDescribeAll:$i,getDescribeTable:na,insertTableRecords:ca,readTableRecords:Ca,updateTableRecords:{...Aa,icon:ot,execute:ja,requiresApproval:!0},deleteTableRecords:Ri};function Na(e){return Ma[e]}function Pa(e){return e.state===`input-available`&&!!Na(ri(e))?.requiresApproval}function Fa(e){let t=[];for(let[n,r]of(e??[]).entries()){if(q(r)){if(Pa(r)){t.push({kind:`part`,part:r,index:n});continue}let e=t.at(-1);e?.kind===`tool-group`?e.parts.push(r):t.push({kind:`tool-group`,parts:[r],index:n});continue}$r(r)&&r.text.length>0&&t.push({kind:`part`,part:r,index:n})}return t}function Ia({part:e,onApprove:t,onDeny:n,onAlwaysApprove:r,isApproving:i}){let[a,o]=(0,C.useState)(!1),[s,c]=(0,C.useState)(!1),l=ri(e),u=Na(l),d=u?.icon||Fe,f=u?.requiresApproval,p=(0,C.useMemo)(()=>!e.input||typeof e.input==`object`&&Object.keys(e.input).length===0,[e.input]),m=(0,C.useMemo)(()=>{let t=JSON.stringify(e.input,null,`	`);return{json:t,lines:t?t.split(`
-`).length:0}},[e.input]),h=(0,C.useMemo)(()=>{let t=JSON.stringify(e.output,null,`	`);return{json:t,lines:t?t.split(`
-`).length:0}},[e.output]);return(0,w.jsxs)(`div`,{className:`tool-invocation ${e.state}`,children:[(0,w.jsxs)(`div`,{className:`tool-info`,children:[(0,w.jsxs)(`div`,{className:`tool-name`,children:[(0,w.jsx)(d,{size:14}),(0,w.jsx)(`span`,{children:l})]}),(0,w.jsxs)(`div`,{className:`tool-status`,children:[e.state===`input-streaming`&&(0,w.jsx)(`span`,{children:`Thinking...`}),e.state===`input-available`&&(0,w.jsx)(`span`,{children:i?`Executing...`:f?`Awaiting Approval...`:`Executing...`}),e.state===`output-available`&&(e.output?.error?(0,w.jsx)(lt,{size:14,className:`text-destructive`}):(0,w.jsx)(de,{size:14}))]})]}),e.state!==`input-streaming`&&(0,w.jsxs)(`div`,{className:`tool-io`,children:[!p&&(0,w.jsxs)(`div`,{className:`tool-args`,children:[(0,w.jsxs)(`div`,{className:`flex items-center justify-between gap-2 mb-1`,children:[(0,w.jsx)(`strong`,{children:`Input:`}),m.lines>3&&(0,w.jsx)(x,{type:`button`,variant:`ghost`,size:`sm`,className:`h-6 px-2 text-[10px] uppercase tracking-wider text-muted-foreground hover:text-foreground`,onClick:()=>o(!a),children:a?(0,w.jsxs)(w.Fragment,{children:[(0,w.jsx)(fe,{size:12}),`Hide`]}):(0,w.jsxs)(w.Fragment,{children:[(0,w.jsx)(ue,{size:12}),`Show`]})})]}),(0,w.jsx)(`div`,{className:a?`whitespace-pre-wrap`:`line-clamp-3 overflow-hidden whitespace-pre-wrap`,children:m.json})]}),e.state===`input-available`&&f&&(0,w.jsxs)(`div`,{className:`flex gap-2 mt-3 pt-3 border-t`,children:[(0,w.jsxs)(x,{size:`sm`,className:`h-8 text-xs bg-green-600 hover:bg-green-700 text-white`,onClick:()=>t?.(e.toolCallId),disabled:i,children:[i?(0,w.jsx)(ke,{className:`mr-2 h-3 w-3 animate-spin`}):null,`Approve`]}),(0,w.jsx)(x,{type:`button`,size:`sm`,variant:`outline`,className:`h-8 text-xs approval-outline`,onClick:()=>r?.(e.toolCallId),disabled:i,children:`Always Approve`}),(0,w.jsx)(x,{type:`button`,size:`sm`,variant:`outline`,className:`h-8 text-xs approval-outline`,onClick:()=>n?.(e.toolCallId),disabled:i,children:`Deny`})]}),e.state===`output-available`&&(0,w.jsx)(w.Fragment,{children:u?.render?u.render(e):(0,w.jsxs)(`div`,{className:`tool-result`,children:[(0,w.jsxs)(`div`,{className:`flex items-center justify-between gap-2 mb-1`,children:[(0,w.jsx)(`strong`,{children:`Result:`}),h.lines>3&&(0,w.jsx)(x,{type:`button`,variant:`ghost`,size:`sm`,className:`h-6 px-2 text-[10px] uppercase tracking-wider text-muted-foreground hover:text-foreground`,onClick:()=>c(!s),children:s?(0,w.jsxs)(w.Fragment,{children:[(0,w.jsx)(fe,{size:12}),`Hide`]}):(0,w.jsxs)(w.Fragment,{children:[(0,w.jsx)(ue,{size:12}),`Show`]})})]}),(0,w.jsx)(`div`,{className:s?`whitespace-pre-wrap`:`line-clamp-3 overflow-hidden whitespace-pre-wrap`,children:h.json})]})})]})]})}function La({parts:e,onApprove:t,onDeny:n,onAlwaysApprove:r,approvingToolCallIds:i}){let[a,o]=(0,C.useState)(!1),s=e.some(e=>e.state!==`output-available`&&e.state!==`output-error`),c=e.some(e=>e.state===`output-error`||e.state===`output-available`&&e.output?.error),l=e.length===1?ri(e[0]):void 0,u=l&&Na(l)?.icon||mt,d=l??`${e.length} tools`;return(0,w.jsxs)(`div`,{className:`tool-group`,children:[(0,w.jsxs)(`button`,{type:`button`,className:`tool-group-summary`,"aria-expanded":a,onClick:()=>o(!a),children:[a?(0,w.jsx)(ue,{size:14}):(0,w.jsx)(Ne,{size:14}),(0,w.jsx)(u,{size:14}),(0,w.jsx)(`span`,{children:s?`Using ${d}...`:`Used ${d}`}),(0,w.jsx)(`span`,{className:`tool-group-status`,children:s?(0,w.jsx)(ke,{size:14,className:`animate-spin`}):c?(0,w.jsx)(lt,{size:14,className:`text-destructive`}):(0,w.jsx)(de,{size:14})})]}),a&&e.map(e=>(0,w.jsx)(Ia,{part:e,onApprove:t,onDeny:n,onAlwaysApprove:r,isApproving:i?.has(e.toolCallId)},e.toolCallId))]})}function Ra({message:e,onApprove:t,onDeny:n,onAlwaysApprove:r,approvingToolCallIds:i}){return e.parts?.some(e=>$r(e)&&e.text.length>0||q(e))?(0,w.jsxs)(it.div,{initial:{opacity:0,y:10},animate:{opacity:1,y:0},className:`message-bubble ${e.role===`user`?`user`:`assistant`}`,children:[(0,w.jsx)(`div`,{className:`avatar`,children:e.role===`user`?(0,w.jsx)(Ve,{size:18}):(0,w.jsx)(rt,{size:18})}),(0,w.jsx)(`div`,{className:`content`,children:Fa(e.parts).map(e=>{if(e.kind===`tool-group`)return(0,w.jsx)(La,{parts:e.parts,onApprove:t,onDeny:n,onAlwaysApprove:r,approvingToolCallIds:i},e.parts[0].toolCallId);let{part:a,index:o}=e;return $r(a)?(0,w.jsx)(`div`,{className:`text-block`,children:a.text},o):q(a)?(0,w.jsx)(Ia,{part:a,onApprove:t,onDeny:n,onAlwaysApprove:r,isApproving:i?.has(a.toolCallId)},o):null})})]},e.id):null}function za(e,t){if(e!==`submitted`&&e!==`streaming`)return!1;if(t?.role!==`assistant`)return!0;let n=t.parts?.at(-1);return n?$r(n)?n.state!==`streaming`||n.text.length===0:!q(n)||n.state===`output-available`||n.state===`output-error`:!0}function Ba(){return(0,w.jsxs)(it.div,{initial:{opacity:0,y:10},animate:{opacity:1,y:0},transition:{delay:.2},className:`message-bubble assistant`,children:[(0,w.jsx)(`div`,{className:`avatar`,children:(0,w.jsx)(rt,{size:18})}),(0,w.jsxs)(`div`,{className:`content thinking-indicator`,role:`status`,"aria-label":`Harper Agent is thinking`,children:[(0,w.jsx)(`span`,{className:`thinking-dot`}),(0,w.jsx)(`span`,{className:`thinking-dot`}),(0,w.jsx)(`span`,{className:`thinking-dot`})]})]})}function Va(e){return re({queryKey:[`getMyUsage`,e],queryFn:async()=>{let{data:t}=await b.get(`/Chat/Usage/${e}`);return t}})}function Ha(){let{organizationId:e}=ie({strict:!1});return ae(Va(e))}function Ua(){let{data:e,isLoading:t,error:n}=Ha();if(t||n||!e)return null;let{usageUSD:r,monthlyLimitUSD:i,usageBarPercent:a}=e,o=e=>new Intl.NumberFormat(`en-US`,{style:`currency`,currency:`USD`}).format(e);return(0,w.jsxs)(`div`,{className:`usage-container`,children:[(0,w.jsxs)(`div`,{className:`usage-info`,children:[(0,w.jsx)(`span`,{children:`Monthly Org Usage`}),(0,w.jsxs)(`span`,{children:[o(r),` / `,o(i)]}),(0,w.jsxs)(`span`,{children:[Math.round(a),`%`]})]}),(0,w.jsx)(`div`,{className:`usage-bar-bg`,children:(0,w.jsx)(`div`,{className:`usage-bar-fill`,style:{width:`${a}%`}})})]})}function Wa({autoFocus:e,closeChat:t}){let n=ie({strict:!1}),{organizationId:r}=n,[i,a]=Ie(`ApplicationChat`,``),[o,s]=(0,C.useState)(!0),[c,l]=(0,C.useState)({}),[u,d]=(0,C.useState)(new Set),[f,p]=Ee(Te.ChatAlwaysApprovedTools,[]),m=new Set(f),h=nt(),g=De(),_=ne(),{messages:v,sendMessage:ee,status:te,addToolOutput:y,setMessages:b}=Di({transport:pi(r),generateId:O(),sendAutomaticallyWhen:fi,onFinish(){_.invalidateQueries({queryKey:[`getMyUsage`]})},async onToolCall({toolCall:e}){if(e.dynamic)return;let t=Na(e.toolName);if(t){if(t.requiresApproval&&!m.has(e.toolName)){let t={type:`tool-call`,toolCallId:e.toolCallId,toolName:e.toolName,input:e.input};l(n=>({...n,[e.toolCallId]:t}));return}let r=await t.execute({input:e.input,instanceClientParams:g,baseURL:h,params:n});y({tool:e.toolName,toolCallId:e.toolCallId,output:r})}}}),x=(0,C.useCallback)(async e=>{let t=c[e];if(t){d(t=>{let n=new Set(t);return n.add(e),n});try{let r=Na(t.toolName);if(r){let i=await r.execute({input:t.input,instanceClientParams:g,baseURL:h,params:n});y({tool:t.toolName,toolCallId:t.toolCallId,output:i}),l(t=>{let n={...t};return delete n[e],n})}}finally{d(t=>{let n=new Set(t);return n.delete(e),n})}}},[c,g,h,y,n]),re=(0,C.useCallback)(e=>{let t=c[e];t&&(y({tool:t.toolName,toolCallId:t.toolCallId,output:{error:`User denied the tool execution.`}}),l(t=>{let n={...t};return delete n[e],n}))},[c,y]),ae=(0,C.useCallback)(async e=>{let t=c[e];t&&(p(e=>Me([...e,t.toolName])),await x(e))},[c,p,x]);(0,C.useEffect)(()=>{(async()=>{try{let e=await _t();Array.isArray(e)&&b(e)}catch(e){console.error(`Failed to fetch initial messages:`,e)}finally{s(!1)}})()},[b]);let oe=te===`streaming`||te===`submitted`,se=(0,C.useRef)(null);return(0,C.useEffect)(()=>{se.current?.scrollIntoView({behavior:`smooth`})},[v]),(0,w.jsxs)(`div`,{className:`flex flex-col h-full`,children:[(0,w.jsxs)(`div`,{className:`flex items-start justify-between gap-6 px-4 py-2.5 border-b border-border bg-card`,children:[(0,w.jsxs)(`div`,{className:`flex flex-col gap-1 min-w-0 flex-1`,children:[(0,w.jsxs)(`div`,{className:`flex items-center gap-2`,children:[(0,w.jsx)(rt,{className:`text-primary`,size:20}),(0,w.jsx)(`span`,{className:`font-semibold text-foreground`,children:`Harper Agent`})]}),(0,w.jsx)(Ua,{})]}),(0,w.jsxs)(`div`,{className:`flex items-center gap-2 shrink-0`,children:[(0,w.jsx)(gt,{setMessages:b}),(0,w.jsx)(`button`,{onClick:t,className:`p-1 hover:bg-accent rounded-md transition-colors text-muted-foreground hover:text-foreground`,title:`Close chat`,children:(0,w.jsx)(we,{size:20})})]})]}),(0,w.jsx)(`div`,{className:`flex-1 overflow-hidden`,children:(0,w.jsxs)(`div`,{className:`chat-interface h-full w-full`,children:[(0,w.jsxs)(`div`,{className:`messages-area`,children:[o&&(0,w.jsx)(ki,{}),!o&&v.length===0&&(0,w.jsxs)(`div`,{className:`empty-state`,children:[(0,w.jsx)(rt,{size:48}),(0,w.jsx)(`p`,{children:`Ask me to create a Harper app!`})]}),v.map(e=>(0,w.jsx)(Ra,{message:e,onApprove:x,onDeny:re,onAlwaysApprove:ae,approvingToolCallIds:u},e.id)),za(te,v.at(-1))&&(0,w.jsx)(Ba,{}),(0,w.jsx)(`div`,{ref:se})]}),(0,w.jsx)(Oi,{input:i,setInput:a,onSubmit:e=>{e.preventDefault(),i.trim()&&!oe&&!o&&(ee({text:i}),a(``))},disabled:o,autoFocus:e})]})})]})}export{Wa as Chat};