@standards/client 1.0.0-alpha.419 → 1.0.0-alpha.425

package/dist/app-BgWz3r5k.js

@@ -0,0 +1,9 @@
+/*! © 2025-2026 AND YOU CREATE SAS (RCS Paris 940 190 614). Proprietary — see LICENSE (Standards SDK License 1.0). */
+let e=require("@standards/schema"),t=require("@standards/schema/api");function schemaApiErrorCode(e){if(typeof e!=`object`||!e||!(`code`in e))return;let{code:t}=e;return typeof t==`string`?t:void 0}const n=/* @__PURE__ */ new Set([e.SchemaErrorCode.CONFIGURATION_REQUIRED]);function isPermanentRefusal(e){let t=schemaApiErrorCode(e);return t!==void 0&&n.has(t)}function isObjectNotFound(t){if(typeof t!=`object`||!t)return!1;let{code:n,status:r}=t;return n===e.SchemaErrorCode.OBJECT_NOT_FOUND||r===404}function isDraftRevisionConflict(t){return schemaApiErrorCode(t)===e.SchemaErrorCode.DRAFT_REVISION_CONFLICT}const r=new Set(e.DRAFT_CONFLICT_KINDS);function draftConflictChanges(e){if(!isDraftRevisionConflict(e))return[];let t=e.details?.changes;return Array.isArray(t)?t.filter(e=>typeof e==`object`&&!!e&&typeof e.key==`string`&&typeof e.label==`string`&&typeof e.seen==`string`&&r.has(e.kind)):[]}function isViewNotFound(e){return typeof e!=`object`||!e?!1:e.status===404}var StandardsRequestError=class extends Error{constructor(e,t,n,r){super(t),this.name=`StandardsRequestError`,this.status=e,this.code=n,this.details=r}},StandardsAuthError=class extends StandardsRequestError{constructor(e,t,n,r){super(e,t,n,r),this.name=`StandardsAuthError`}},BundleConflictError=class extends StandardsRequestError{constructor(e,t,n){super(e,t,n),this.name=`BundleConflictError`;let r=/"([^"]+)" is owned by (\S+)/.exec(t);this.objectName=r?.[1]??``,this.owner=r?.[2]??``}},BundleValidationError=class extends StandardsRequestError{constructor(e,t,n){super(e,t,n),this.name=`BundleValidationError`}},StandardsConfigurationError=class extends Error{constructor(e){super(e),this.name=`StandardsConfigurationError`}};const i=[1e3,2e3,5e3],a=/* @__PURE__ */ new Set([`turn.completed`,`turn.failed`,`turn.cancelled`]);function parseSseFrame(e){let t,n=`message`,r,i=[];for(let a of e.split(`
+`)){let e=a.endsWith(`\r`)?a.slice(0,-1):a;if(e===``||e.startsWith(`:`))continue;let o=e.indexOf(`:`),s=o===-1?e:e.slice(0,o),c=o===-1?``:e.slice(o+1);c.startsWith(` `)&&(c=c.slice(1)),s===`id`?t=c:s===`event`?n=c:s===`data`?i.push(c):s===`retry`&&/^\d+$/.test(c)&&(r=Number(c))}return{id:t,event:n,data:i.join(`
+`),retry:r}}function parseEvent(t){let n;try{n=JSON.parse(t.data)}catch{return}if((0,e.isPlainRecord)(n)&&typeof n.type==`string`&&typeof n.seq==`number`&&Number.isSafeInteger(n.seq)&&n.seq>0&&(t.id===void 0||t.id===String(n.seq)))return n}function parseControl(t){let n;try{n=JSON.parse(t.data)}catch{return}if(!(0,e.isPlainRecord)(n))return;let r=n.control;return r===`up-to-date`||r===`lease-ended`||r===`inbox`?r:void 0}function isUnresolvableActor(e){return e.status===401&&e.code===`ACTOR_RESOLUTION_FAILED`}function isTerminalRefusal(e){return e.status===400||e.status===403||e.status===404||isUnresolvableActor(e)}function isCursorExpired(e){return e instanceof StandardsRequestError&&e.status===410&&e.code===`AGENT_SESSION_STREAM_CURSOR_EXPIRED`}function openAgentStream(e){let t=!1,n,r,a,o=1e3,s=0,c,l=e.subscribeAuthChanges?.(()=>{t||(s+=1,c?.(),c=void 0)});function endWait(){r!==void 0&&clearTimeout(r),r=void 0,a?.(),a=void 0}function close(){t||(t=!0,n?.abort(),endWait(),c?.(),c=void 0,l?.())}function waitForAuthChange(e){return t||s!==e?Promise.resolve():new Promise(e=>{c=e})}function sleep(e){return new Promise(t=>{a=t,r=setTimeout(endWait,e)})}function handleFrame(t){let n=parseSseFrame(t);if(n.retry!==void 0&&(o=n.retry),n.data===``)return`skipped`;if(n.event===`control`){let t=parseControl(n);return t&&e.onControl(t),t===`lease-ended`?`lease-ended`:`skipped`}if(n.event!==`event`)return`skipped`;let r=parseEvent(n);return r?r.seq<=e.cursor()?`skipped`:(e.onEvent(r),`delivered`):`malformed`}async function consume(e,n){let r=e.body;if(r===null)return{delivered:!1,end:`failed`};let i=r.getReader(),a=new TextDecoder,o=``,s=!1;try{for(;;){let{done:e,value:r}=await i.read();if(t||e)return{delivered:s,end:`clean`};o+=a.decode(r,{stream:!0}).replace(/\r\n/g,`
+`);let c=o.indexOf(`
+
+`);for(;c!==-1;){let e=o.slice(0,c);o=o.slice(c+2);let r=handleFrame(e);if(r===`delivered`&&(s=!0),t)return{delivered:s,end:`clean`};if(r===`malformed`)return n.abort(),{delivered:s,end:`malformed`};if(r===`lease-ended`)return{delivered:s,end:`lease-ended`};c=o.indexOf(`
+
+`)}}}catch{return{delivered:s,end:`failed`}}finally{i.releaseLock()}}async function afterFailedOpen(t,n,r){if(isCursorExpired(t))try{return await e.onExpired(),r?`back-off`:`reopen`}catch{return`back-off`}return t instanceof StandardsRequestError?isTerminalRefusal(t)?(close(),e.onStatus(`error`,t),`stop`):t.status===401?(e.onStatus(`auth-blocked`,t),await waitForAuthChange(n),`reopen`):`back-off`:`back-off`}let u,d=0;async function rehydratedPastStall(t){if(e.cursor()!==t||(d=u===t?d+1:1,u=t,d<3))return!1;u=void 0,d=0;try{return await e.onExpired(),!0}catch{return!1}}function delayAfter(e,t){return e===`lease-ended`?0:e===`clean`||e===`malformed`?o:i[Math.min(t,i.length-1)]??5e3}async function run(){let r=!0,i=0,a=!1;for(;!t;){e.onStatus(r?`connecting`:`reconnecting`),r=!1;let o=new AbortController;n=o;let c=s,l=`failed`;try{let n=await e.open(e.sessionId,e.cursor(),o.signal,()=>{c=s});if(t)return;e.onStatus(`connected`);let r=e.cursor(),u=await consume(n,o);if(l=u.end,l===`malformed`&&await rehydratedPastStall(r)){if(t)return;continue}u.delivered&&(i=0,a=!1)}catch(e){if(t)return;let n=isCursorExpired(e),r=await afterFailedOpen(e,c,a);if(a=n,r===`stop`||t)return;if(r===`reopen`)continue}if(t)return;e.onStatus(`reconnecting`);let u=delayAfter(l,i);l===`failed`&&(i+=1),u>0&&await sleep(u)}}return run().catch(()=>void 0),{close,wake:endWait}}function parseContentDispositionFilename(e){if(!e)return;let t=e.match(/filename\*\s*=\s*(?:UTF-8|utf-8)''([^;]+)/i);if(t?.[1])try{return decodeURIComponent(t[1].trim())}catch{}let n=e.match(/filename\s*=\s*"([^"]*)"|filename\s*=\s*([^;]+)/i);return(n?.[1]??n?.[2])?.trim()||void 0}function recordsPath(e,...n){return[`/records`,...[e,...n].map(t.encodePathSegment)].join(`/`)}function resolveWithinBase(t,n){let r=t.endsWith(`/`)?t:`${t}/`,i=new URL(r),a=n.replace(/^\/+/,``),[o]=a.split(/[?#]/);if((o??``).split(`/`).some(e=>e===`..`||e===`.`))throw new e.ValidationError(`Request path "${n}" walks outside its own collection`,[]);let s=new URL(a,i);if(s.origin!==i.origin||!s.pathname.startsWith(i.pathname))throw new e.ValidationError(`Request path "${n}" resolves outside the API base "${i.pathname}"`,[]);return s}function readJson(e){return e.status===204||e.headers.get(`content-length`)===`0`?null:e.json()}async function readDownload(e){let t=await e.blob();return{blob:t,filename:parseContentDispositionFilename(e.headers.get(`Content-Disposition`)),mimeType:e.headers.get(`Content-Type`)??t.type}}function multipartBody(e,t){let n=new FormData;for(let[r,i]of Object.entries(t??{}))if(i!=null){if(r===e)for(let t of Array.isArray(i)?i:[i]){let r=t.name;typeof r==`string`?n.append(e,t,r):n.append(e,t)}else n.append(r,String(i))}return n}function headerRecord(e){return e===void 0?{}:e instanceof Headers?Object.fromEntries(e.entries()):Array.isArray(e)?Object.fromEntries(e):{...e}}function withoutContentType(e){return Object.fromEntries(Object.entries(e).filter(([e])=>e.toLowerCase()!==`content-type`))}function parseJsonObject(e){try{let t=JSON.parse(e);return typeof t==`object`&&t?t:{}}catch{return}}function refusalFrom(e,t,n){let r=parseJsonObject(t),i=r?.message??r?.error??r?.detail,a=i==null?n&&r===void 0&&t?t:`Request failed with status ${e}`:String(i),o=typeof r?.code==`string`?r.code:void 0;return new(e===401||e===403?StandardsAuthError:StandardsRequestError)(e,a,o,r?.details)}function refusalOf(e,t){return refusalFrom(e,t,!1)}async function readRefusal(e){return refusalOf(e.status,await e.text().catch(()=>``))}function isTimeout(e){return e instanceof DOMException&&e.name===`TimeoutError`}function trimSlashes(e,t){let n=0,r=e.length;for(;t&&n<r&&e[n]===`/`;)n+=1;for(;r>n&&e[r-1]===`/`;)--r;return e.slice(n,r)}function backoff(e){return new Promise(t=>setTimeout(t,1e3*2**e))}function abortReason(e){return e?.aborted?e.reason:new DOMException(`The operation was aborted.`,`AbortError`)}function canReportUploadProgress(e){return typeof XMLHttpRequest>`u`?!1:e.fetch===void 0||e.uploadAuthorization!==void 0}function sendWithProgress(e,t){let{signal:n}=e;return n?.aborted?Promise.reject(abortReason(n)):new Promise((r,i)=>{let a=new XMLHttpRequest;a.open(e.method,e.url);for(let[t,n]of Object.entries(e.headers))a.setRequestHeader(t,n);let o=Object.keys(e.headers).some(e=>e.toLowerCase()===`authorization`);e.token&&!o&&a.setRequestHeader(`Authorization`,`Bearer ${e.token}`),a.upload.addEventListener(`progress`,t=>{t.lengthComputable&&e.onUploadProgress({loaded:t.loaded,total:t.total})});let onAbort=()=>a.abort();n?.addEventListener(`abort`,onAbort,{once:!0});let settle=()=>n?.removeEventListener(`abort`,onAbort);a.addEventListener(`load`,()=>{if(settle(),a.status<200||a.status>=300)i(refusalOf(a.status,a.responseText));else try{r(t(a.responseText))}catch(e){i(e)}}),a.addEventListener(`error`,()=>{settle(),i(new StandardsRequestError(0,`Network request failed`))}),a.addEventListener(`abort`,()=>{settle(),i(abortReason(n))}),a.send(e.form)})}function createHttpTransport(e){let{baseUrl:n,onUnauthorized:r,getRetries:i=0}=e,a=e.timeoutMs??3e4,o=e.apiPrefix===void 0?void 0:trimSlashes(e.apiPrefix,!0),s=o?`${trimSlashes(n,!1)}/${o}`:n;function buildUrl(e,t){let n=resolveWithinBase(s,e);for(let[e,r]of Object.entries(t??{}))r!=null&&n.searchParams.set(e,String(r));return n.toString()}async function headersFor(t){let n={"Content-Type":`application/json`,...headerRecord(await e.headers?.()),...headerRecord(t.headers)};return t.body instanceof FormData?withoutContentType(n):n}function observe(t){try{e.onResponse?.(t)}catch{}}async function fetchOnce(t,n,r){let i=n.signal??void 0;i?.throwIfAborted();let a=r===null?void 0:AbortSignal.timeout(r),o=new AbortController,expire=()=>o.abort(a?.reason);a?.addEventListener(`abort`,expire,{once:!0});let s=i?AbortSignal.any([i,o.signal]):o.signal,c=new Promise((e,t)=>{s.addEventListener(`abort`,()=>t(s.reason),{once:!0})});try{let r=e.fetch??fetch,i=await headersFor(n);return await Promise.race([r(t,{...n,headers:i,signal:s}),c])}catch(e){throw i?.aborted?i.reason:e}finally{a?.removeEventListener(`abort`,expire)}}function connectionFailure(e){return e instanceof TypeError||isTimeout(e)?new StandardsRequestError(0,`Could not connect to ${n}`):e}async function refreshAndRetry(e,t,n){try{if(!await r?.())return;let i=await fetchOnce(e,t,n);return observe(i),i}catch{if(t.signal?.aborted)throw t.signal.reason;return}}async function readRefusalWithin(e){let t,n=new Promise(n=>{t=setTimeout(()=>n(refusalFrom(e.status,``,!1)),1500)});try{let t=e.text().catch(()=>``).then(t=>refusalFrom(e.status,t,!1));return await Promise.race([t,n])}finally{clearTimeout(t)}}async function send(e,t,n,o){let s=buildUrl(e,n.params),c=(t.method??`GET`).toUpperCase(),l=n.maxRetries??(c===`GET`?i:0),u=n.timeoutMs===void 0?a:n.timeoutMs;for(let e=0;;e++){let i=e<l,a;try{a=await fetchOnce(s,t,u)}catch(n){if(i&&n instanceof TypeError&&!t.signal?.aborted){await backoff(e);continue}throw connectionFailure(n)}if(observe(a),a.status>=500&&i){let t=await readRefusalWithin(a);if(isPermanentRefusal(t))throw t;await backoff(e)}else{if(a.status===401&&r&&(a=await refreshAndRetry(s,t,u)??a),!a.ok){let e=await a.text().catch(()=>``);throw refusalFrom(a.status,e,n.plainTextRefusal??!1)}return await o(a)}}}async function stream(n,i,a={}){let{path:o,query:s,body:c,headers:l}=(0,t.splitOperationInput)(n,i??{}),u=buildUrl(o,s),{signal:d,onRequest:f}=a,p=e.fetch??fetch,attempt=async()=>(f?.(),await p(u,{method:n.method,body:c===void 0?void 0:JSON.stringify(c),signal:d,headers:await headersFor({headers:{...l,...a.headers}})})),m=await attempt();if(m.status===401){let e=await readRefusal(m);if(e.code===`MFA_REQUIRED`||!r||!await r().catch(()=>!1))throw e;d?.throwIfAborted(),m=await attempt()}if(!m.ok)throw await readRefusal(m);return m}async function json(e,t,n){return await send(t,{method:e,body:n?JSON.stringify(n):void 0},{},readJson)}return{async call(n,r,i={}){if(n.response===`events`)return await stream(n,r,{signal:i.signal});let{path:a,query:o,body:s,headers:c}=(0,t.splitOperationInput)(n,r??{});if(n.upload!==void 0&&i.onUploadProgress&&canReportUploadProgress(e)){i.signal?.throwIfAborted();let r=await e.uploadAuthorization?.()??null;return await sendWithProgress({url:buildUrl(a,o),method:n.method,headers:withoutContentType({...headerRecord(await e.headers?.()),...c}),token:r,form:multipartBody(n.upload.field,s),onUploadProgress:i.onUploadProgress,signal:i.signal},e=>(0,t.decodeOperationOutput)(n,e?JSON.parse(e):null))}let l=n.upload===void 0?s===void 0?void 0:JSON.stringify(s):multipartBody(n.upload.field,s),u=n.response===`bytes`?readDownload:async e=>(0,t.decodeOperationOutput)(n,await readJson(e));return await send(a,{method:n.method,body:l,signal:i.signal,...c?{headers:c}:{},...i.keepalive?{keepalive:!0}:{}},{params:o,maxRetries:i.maxRetries,timeoutMs:i.timeoutMs},u)},stream,async get(e,t){return await send(e,{method:`GET`},{params:t},readJson)},post:(e,t)=>json(`POST`,e,t),patch:(e,t)=>json(`PATCH`,e,t),put:(e,t)=>json(`PUT`,e,t),delete:e=>json(`DELETE`,e),async getText(e,t){return await send(e,{method:`GET`},{params:t,plainTextRefusal:!0},e=>e.text())},async postRaw(e,t){return await send(e,{method:`POST`,body:JSON.stringify(t)},{plainTextRefusal:!0},e=>e)},async postMultipart(e,t,n={}){return await send(e,{method:`POST`,body:t},{timeoutMs:n.timeoutMs},readJson)}}}function createTransport(e){let{baseUrl:t,apiKey:n,tenantId:r,timeoutMs:i}=e,a={Authorization:`Bearer ${n}`,...r?{"X-Tenant-ID":r}:{}};return createHttpTransport({baseUrl:t,timeoutMs:i,headers:()=>a})}function asStrings(e){let t=Object.entries(e??{}).flatMap(([e,t])=>t==null?[]:[[e,String(t)]]);return Object.fromEntries(t)}async function uploadedPart(e){let t=e.name;return{name:typeof t==`string`?t:`blob`,mimeType:e.type===``?`application/octet-stream`:e.type,size:e.size,content:new Uint8Array(await e.arrayBuffer())}}async function wireRequest(e,n){let{query:r,body:i,headers:a}=(0,t.splitOperationInput)(e,n),o=Object.fromEntries((0,t.pathParamNames)(e.path).map(e=>[e,String(n[e])])),s=Object.fromEntries(Object.entries(a??{}).map(([e,t])=>[e.toLowerCase(),t])),c={params:o,query:asStrings(r),headers:s};if(e.upload===void 0)return{...c,body:i===void 0?void 0:JSON.parse(JSON.stringify(i))};let{[e.upload.field]:l,...u}=i??{},d=l==null?[]:Array.isArray(l)?l:[l];return{...c,body:asStrings(u),uploads:await Promise.all(d.map(uploadedPart))}}function downloaded(e){let t=typeof e.content==`string`?e.content:new Uint8Array(e.content);return{blob:new Blob([t],{type:e.mimeType}),filename:e.filename,mimeType:e.mimeType}}function createInProcessTransport(e){return transportActingAs(e,void 0)}function transportActingAs(e,n){async function call(r,i,a={}){if(a.signal?.throwIfAborted(),r.response===`events`)throw Error(`Operation ${r.name} streams over HTTP only`);let o=await wireRequest(r,i??{}),s;try{s=await e.execute(r,o,n)}catch(e){throw(0,t.isOperationRefused)(e)?refusalOf(e.status,JSON.stringify(e.body)):e}if(r.response===`bytes`)return downloaded(s);let c=s===void 0?null:JSON.parse(JSON.stringify(s));return(0,t.decodeOperationOutput)(r,c)}return{call,stream:e=>Promise.reject(/* @__PURE__ */ Error(`Operation ${e.name} streams over HTTP only`)),withCaller:t=>transportActingAs(e,t)}}function createAppClient(e){let n={},r=Object.values(t.appOperationGroups);for(let i of r.flatMap(e=>Object.values(e))){let r=(0,t.operationGroup)(i),a=i.name.slice(r.length+1);n[r]??={},n[r][a]=(t,n)=>i.response===`events`?e.stream(i,t,n):e.call(i,t,n)}return n}Object.defineProperty(exports,"_",{enumerable:!0,get:function(){return isDraftRevisionConflict}}),Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return readRefusal}}),Object.defineProperty(exports,"b",{enumerable:!0,get:function(){return isViewNotFound}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return parseContentDispositionFilename}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return BundleConflictError}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return BundleValidationError}}),Object.defineProperty(exports,"g",{enumerable:!0,get:function(){return draftConflictChanges}}),Object.defineProperty(exports,"h",{enumerable:!0,get:function(){return StandardsRequestError}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return createTransport}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return StandardsConfigurationError}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return createInProcessTransport}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return refusalOf}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return StandardsAuthError}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return createHttpTransport}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return recordsPath}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return createAppClient}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return openAgentStream}}),Object.defineProperty(exports,"v",{enumerable:!0,get:function(){return isObjectNotFound}}),Object.defineProperty(exports,"x",{enumerable:!0,get:function(){return schemaApiErrorCode}}),Object.defineProperty(exports,"y",{enumerable:!0,get:function(){return isPermanentRefusal}});

package/dist/app-TJt8rk9y.mjs

@@ -0,0 +1,9 @@
+/*! © 2025-2026 AND YOU CREATE SAS (RCS Paris 940 190 614). Proprietary — see LICENSE (Standards SDK License 1.0). */
+import{DRAFT_CONFLICT_KINDS as e,SchemaErrorCode as t,ValidationError as n,isPlainRecord as r}from"@standards/schema";import{appOperationGroups as i,decodeOperationOutput as a,encodePathSegment as o,isOperationRefused as s,operationGroup as c,pathParamNames as l,splitOperationInput as u}from"@standards/schema/api";function schemaApiErrorCode(e){if(typeof e!=`object`||!e||!(`code`in e))return;let{code:t}=e;return typeof t==`string`?t:void 0}const d=/* @__PURE__ */ new Set([t.CONFIGURATION_REQUIRED]);function isPermanentRefusal(e){let t=schemaApiErrorCode(e);return t!==void 0&&d.has(t)}function isObjectNotFound(e){if(typeof e!=`object`||!e)return!1;let{code:n,status:r}=e;return n===t.OBJECT_NOT_FOUND||r===404}function isDraftRevisionConflict(e){return schemaApiErrorCode(e)===t.DRAFT_REVISION_CONFLICT}const f=new Set(e);function draftConflictChanges(e){if(!isDraftRevisionConflict(e))return[];let t=e.details?.changes;return Array.isArray(t)?t.filter(e=>typeof e==`object`&&!!e&&typeof e.key==`string`&&typeof e.label==`string`&&typeof e.seen==`string`&&f.has(e.kind)):[]}function isViewNotFound(e){return typeof e!=`object`||!e?!1:e.status===404}var StandardsRequestError=class extends Error{constructor(e,t,n,r){super(t),this.name=`StandardsRequestError`,this.status=e,this.code=n,this.details=r}},StandardsAuthError=class extends StandardsRequestError{constructor(e,t,n,r){super(e,t,n,r),this.name=`StandardsAuthError`}},BundleConflictError=class extends StandardsRequestError{constructor(e,t,n){super(e,t,n),this.name=`BundleConflictError`;let r=/"([^"]+)" is owned by (\S+)/.exec(t);this.objectName=r?.[1]??``,this.owner=r?.[2]??``}},BundleValidationError=class extends StandardsRequestError{constructor(e,t,n){super(e,t,n),this.name=`BundleValidationError`}},StandardsConfigurationError=class extends Error{constructor(e){super(e),this.name=`StandardsConfigurationError`}};const p=[1e3,2e3,5e3],m=/* @__PURE__ */ new Set([`turn.completed`,`turn.failed`,`turn.cancelled`]);function parseSseFrame(e){let t,n=`message`,r,i=[];for(let a of e.split(`
+`)){let e=a.endsWith(`\r`)?a.slice(0,-1):a;if(e===``||e.startsWith(`:`))continue;let o=e.indexOf(`:`),s=o===-1?e:e.slice(0,o),c=o===-1?``:e.slice(o+1);c.startsWith(` `)&&(c=c.slice(1)),s===`id`?t=c:s===`event`?n=c:s===`data`?i.push(c):s===`retry`&&/^\d+$/.test(c)&&(r=Number(c))}return{id:t,event:n,data:i.join(`
+`),retry:r}}function parseEvent(e){let t;try{t=JSON.parse(e.data)}catch{return}if(r(t)&&typeof t.type==`string`&&typeof t.seq==`number`&&Number.isSafeInteger(t.seq)&&t.seq>0&&(e.id===void 0||e.id===String(t.seq)))return t}function parseControl(e){let t;try{t=JSON.parse(e.data)}catch{return}if(!r(t))return;let n=t.control;return n===`up-to-date`||n===`lease-ended`||n===`inbox`?n:void 0}function isUnresolvableActor(e){return e.status===401&&e.code===`ACTOR_RESOLUTION_FAILED`}function isTerminalRefusal(e){return e.status===400||e.status===403||e.status===404||isUnresolvableActor(e)}function isCursorExpired(e){return e instanceof StandardsRequestError&&e.status===410&&e.code===`AGENT_SESSION_STREAM_CURSOR_EXPIRED`}function openAgentStream(e){let t=!1,n,r,i,a=1e3,o=0,s,c=e.subscribeAuthChanges?.(()=>{t||(o+=1,s?.(),s=void 0)});function endWait(){r!==void 0&&clearTimeout(r),r=void 0,i?.(),i=void 0}function close(){t||(t=!0,n?.abort(),endWait(),s?.(),s=void 0,c?.())}function waitForAuthChange(e){return t||o!==e?Promise.resolve():new Promise(e=>{s=e})}function sleep(e){return new Promise(t=>{i=t,r=setTimeout(endWait,e)})}function handleFrame(t){let n=parseSseFrame(t);if(n.retry!==void 0&&(a=n.retry),n.data===``)return`skipped`;if(n.event===`control`){let t=parseControl(n);return t&&e.onControl(t),t===`lease-ended`?`lease-ended`:`skipped`}if(n.event!==`event`)return`skipped`;let r=parseEvent(n);return r?r.seq<=e.cursor()?`skipped`:(e.onEvent(r),`delivered`):`malformed`}async function consume(e,n){let r=e.body;if(r===null)return{delivered:!1,end:`failed`};let i=r.getReader(),a=new TextDecoder,o=``,s=!1;try{for(;;){let{done:e,value:r}=await i.read();if(t||e)return{delivered:s,end:`clean`};o+=a.decode(r,{stream:!0}).replace(/\r\n/g,`
+`);let c=o.indexOf(`
+
+`);for(;c!==-1;){let e=o.slice(0,c);o=o.slice(c+2);let r=handleFrame(e);if(r===`delivered`&&(s=!0),t)return{delivered:s,end:`clean`};if(r===`malformed`)return n.abort(),{delivered:s,end:`malformed`};if(r===`lease-ended`)return{delivered:s,end:`lease-ended`};c=o.indexOf(`
+
+`)}}}catch{return{delivered:s,end:`failed`}}finally{i.releaseLock()}}async function afterFailedOpen(t,n,r){if(isCursorExpired(t))try{return await e.onExpired(),r?`back-off`:`reopen`}catch{return`back-off`}return t instanceof StandardsRequestError?isTerminalRefusal(t)?(close(),e.onStatus(`error`,t),`stop`):t.status===401?(e.onStatus(`auth-blocked`,t),await waitForAuthChange(n),`reopen`):`back-off`:`back-off`}let l,u=0;async function rehydratedPastStall(t){if(e.cursor()!==t||(u=l===t?u+1:1,l=t,u<3))return!1;l=void 0,u=0;try{return await e.onExpired(),!0}catch{return!1}}function delayAfter(e,t){return e===`lease-ended`?0:e===`clean`||e===`malformed`?a:p[Math.min(t,p.length-1)]??5e3}async function run(){let r=!0,i=0,a=!1;for(;!t;){e.onStatus(r?`connecting`:`reconnecting`),r=!1;let s=new AbortController;n=s;let c=o,l=`failed`;try{let n=await e.open(e.sessionId,e.cursor(),s.signal,()=>{c=o});if(t)return;e.onStatus(`connected`);let r=e.cursor(),u=await consume(n,s);if(l=u.end,l===`malformed`&&await rehydratedPastStall(r)){if(t)return;continue}u.delivered&&(i=0,a=!1)}catch(e){if(t)return;let n=isCursorExpired(e),r=await afterFailedOpen(e,c,a);if(a=n,r===`stop`||t)return;if(r===`reopen`)continue}if(t)return;e.onStatus(`reconnecting`);let u=delayAfter(l,i);l===`failed`&&(i+=1),u>0&&await sleep(u)}}return run().catch(()=>void 0),{close,wake:endWait}}function parseContentDispositionFilename(e){if(!e)return;let t=e.match(/filename\*\s*=\s*(?:UTF-8|utf-8)''([^;]+)/i);if(t?.[1])try{return decodeURIComponent(t[1].trim())}catch{}let n=e.match(/filename\s*=\s*"([^"]*)"|filename\s*=\s*([^;]+)/i);return(n?.[1]??n?.[2])?.trim()||void 0}function recordsPath(e,...t){return[`/records`,...[e,...t].map(o)].join(`/`)}function resolveWithinBase(e,t){let r=e.endsWith(`/`)?e:`${e}/`,i=new URL(r),a=t.replace(/^\/+/,``),[o]=a.split(/[?#]/);if((o??``).split(`/`).some(e=>e===`..`||e===`.`))throw new n(`Request path "${t}" walks outside its own collection`,[]);let s=new URL(a,i);if(s.origin!==i.origin||!s.pathname.startsWith(i.pathname))throw new n(`Request path "${t}" resolves outside the API base "${i.pathname}"`,[]);return s}function readJson(e){return e.status===204||e.headers.get(`content-length`)===`0`?null:e.json()}async function readDownload(e){let t=await e.blob();return{blob:t,filename:parseContentDispositionFilename(e.headers.get(`Content-Disposition`)),mimeType:e.headers.get(`Content-Type`)??t.type}}function multipartBody(e,t){let n=new FormData;for(let[r,i]of Object.entries(t??{}))if(i!=null){if(r===e)for(let t of Array.isArray(i)?i:[i]){let r=t.name;typeof r==`string`?n.append(e,t,r):n.append(e,t)}else n.append(r,String(i))}return n}function headerRecord(e){return e===void 0?{}:e instanceof Headers?Object.fromEntries(e.entries()):Array.isArray(e)?Object.fromEntries(e):{...e}}function withoutContentType(e){return Object.fromEntries(Object.entries(e).filter(([e])=>e.toLowerCase()!==`content-type`))}function parseJsonObject(e){try{let t=JSON.parse(e);return typeof t==`object`&&t?t:{}}catch{return}}function refusalFrom(e,t,n){let r=parseJsonObject(t),i=r?.message??r?.error??r?.detail,a=i==null?n&&r===void 0&&t?t:`Request failed with status ${e}`:String(i),o=typeof r?.code==`string`?r.code:void 0;return new(e===401||e===403?StandardsAuthError:StandardsRequestError)(e,a,o,r?.details)}function refusalOf(e,t){return refusalFrom(e,t,!1)}async function readRefusal(e){return refusalOf(e.status,await e.text().catch(()=>``))}function isTimeout(e){return e instanceof DOMException&&e.name===`TimeoutError`}function trimSlashes(e,t){let n=0,r=e.length;for(;t&&n<r&&e[n]===`/`;)n+=1;for(;r>n&&e[r-1]===`/`;)--r;return e.slice(n,r)}function backoff(e){return new Promise(t=>setTimeout(t,1e3*2**e))}function abortReason(e){return e?.aborted?e.reason:new DOMException(`The operation was aborted.`,`AbortError`)}function canReportUploadProgress(e){return typeof XMLHttpRequest>`u`?!1:e.fetch===void 0||e.uploadAuthorization!==void 0}function sendWithProgress(e,t){let{signal:n}=e;return n?.aborted?Promise.reject(abortReason(n)):new Promise((r,i)=>{let a=new XMLHttpRequest;a.open(e.method,e.url);for(let[t,n]of Object.entries(e.headers))a.setRequestHeader(t,n);let o=Object.keys(e.headers).some(e=>e.toLowerCase()===`authorization`);e.token&&!o&&a.setRequestHeader(`Authorization`,`Bearer ${e.token}`),a.upload.addEventListener(`progress`,t=>{t.lengthComputable&&e.onUploadProgress({loaded:t.loaded,total:t.total})});let onAbort=()=>a.abort();n?.addEventListener(`abort`,onAbort,{once:!0});let settle=()=>n?.removeEventListener(`abort`,onAbort);a.addEventListener(`load`,()=>{if(settle(),a.status<200||a.status>=300)i(refusalOf(a.status,a.responseText));else try{r(t(a.responseText))}catch(e){i(e)}}),a.addEventListener(`error`,()=>{settle(),i(new StandardsRequestError(0,`Network request failed`))}),a.addEventListener(`abort`,()=>{settle(),i(abortReason(n))}),a.send(e.form)})}function createHttpTransport(e){let{baseUrl:t,onUnauthorized:n,getRetries:r=0}=e,i=e.timeoutMs??3e4,o=e.apiPrefix===void 0?void 0:trimSlashes(e.apiPrefix,!0),s=o?`${trimSlashes(t,!1)}/${o}`:t;function buildUrl(e,t){let n=resolveWithinBase(s,e);for(let[e,r]of Object.entries(t??{}))r!=null&&n.searchParams.set(e,String(r));return n.toString()}async function headersFor(t){let n={"Content-Type":`application/json`,...headerRecord(await e.headers?.()),...headerRecord(t.headers)};return t.body instanceof FormData?withoutContentType(n):n}function observe(t){try{e.onResponse?.(t)}catch{}}async function fetchOnce(t,n,r){let i=n.signal??void 0;i?.throwIfAborted();let a=r===null?void 0:AbortSignal.timeout(r),o=new AbortController,expire=()=>o.abort(a?.reason);a?.addEventListener(`abort`,expire,{once:!0});let s=i?AbortSignal.any([i,o.signal]):o.signal,c=new Promise((e,t)=>{s.addEventListener(`abort`,()=>t(s.reason),{once:!0})});try{let r=e.fetch??fetch,i=await headersFor(n);return await Promise.race([r(t,{...n,headers:i,signal:s}),c])}catch(e){throw i?.aborted?i.reason:e}finally{a?.removeEventListener(`abort`,expire)}}function connectionFailure(e){return e instanceof TypeError||isTimeout(e)?new StandardsRequestError(0,`Could not connect to ${t}`):e}async function refreshAndRetry(e,t,r){try{if(!await n?.())return;let i=await fetchOnce(e,t,r);return observe(i),i}catch{if(t.signal?.aborted)throw t.signal.reason;return}}async function readRefusalWithin(e){let t,n=new Promise(n=>{t=setTimeout(()=>n(refusalFrom(e.status,``,!1)),1500)});try{let t=e.text().catch(()=>``).then(t=>refusalFrom(e.status,t,!1));return await Promise.race([t,n])}finally{clearTimeout(t)}}async function send(e,t,a,o){let s=buildUrl(e,a.params),c=(t.method??`GET`).toUpperCase(),l=a.maxRetries??(c===`GET`?r:0),u=a.timeoutMs===void 0?i:a.timeoutMs;for(let e=0;;e++){let r=e<l,i;try{i=await fetchOnce(s,t,u)}catch(n){if(r&&n instanceof TypeError&&!t.signal?.aborted){await backoff(e);continue}throw connectionFailure(n)}if(observe(i),i.status>=500&&r){let t=await readRefusalWithin(i);if(isPermanentRefusal(t))throw t;await backoff(e)}else{if(i.status===401&&n&&(i=await refreshAndRetry(s,t,u)??i),!i.ok){let e=await i.text().catch(()=>``);throw refusalFrom(i.status,e,a.plainTextRefusal??!1)}return await o(i)}}}async function stream(t,r,i={}){let{path:a,query:o,body:s,headers:c}=u(t,r??{}),l=buildUrl(a,o),{signal:d,onRequest:f}=i,p=e.fetch??fetch,attempt=async()=>(f?.(),await p(l,{method:t.method,body:s===void 0?void 0:JSON.stringify(s),signal:d,headers:await headersFor({headers:{...c,...i.headers}})})),m=await attempt();if(m.status===401){let e=await readRefusal(m);if(e.code===`MFA_REQUIRED`||!n||!await n().catch(()=>!1))throw e;d?.throwIfAborted(),m=await attempt()}if(!m.ok)throw await readRefusal(m);return m}async function json(e,t,n){return await send(t,{method:e,body:n?JSON.stringify(n):void 0},{},readJson)}return{async call(t,n,r={}){if(t.response===`events`)return await stream(t,n,{signal:r.signal});let{path:i,query:o,body:s,headers:c}=u(t,n??{});if(t.upload!==void 0&&r.onUploadProgress&&canReportUploadProgress(e)){r.signal?.throwIfAborted();let n=await e.uploadAuthorization?.()??null;return await sendWithProgress({url:buildUrl(i,o),method:t.method,headers:withoutContentType({...headerRecord(await e.headers?.()),...c}),token:n,form:multipartBody(t.upload.field,s),onUploadProgress:r.onUploadProgress,signal:r.signal},e=>a(t,e?JSON.parse(e):null))}let l=t.upload===void 0?s===void 0?void 0:JSON.stringify(s):multipartBody(t.upload.field,s),d=t.response===`bytes`?readDownload:async e=>a(t,await readJson(e));return await send(i,{method:t.method,body:l,signal:r.signal,...c?{headers:c}:{},...r.keepalive?{keepalive:!0}:{}},{params:o,maxRetries:r.maxRetries,timeoutMs:r.timeoutMs},d)},stream,async get(e,t){return await send(e,{method:`GET`},{params:t},readJson)},post:(e,t)=>json(`POST`,e,t),patch:(e,t)=>json(`PATCH`,e,t),put:(e,t)=>json(`PUT`,e,t),delete:e=>json(`DELETE`,e),async getText(e,t){return await send(e,{method:`GET`},{params:t,plainTextRefusal:!0},e=>e.text())},async postRaw(e,t){return await send(e,{method:`POST`,body:JSON.stringify(t)},{plainTextRefusal:!0},e=>e)},async postMultipart(e,t,n={}){return await send(e,{method:`POST`,body:t},{timeoutMs:n.timeoutMs},readJson)}}}function createTransport(e){let{baseUrl:t,apiKey:n,tenantId:r,timeoutMs:i}=e,a={Authorization:`Bearer ${n}`,...r?{"X-Tenant-ID":r}:{}};return createHttpTransport({baseUrl:t,timeoutMs:i,headers:()=>a})}function asStrings(e){let t=Object.entries(e??{}).flatMap(([e,t])=>t==null?[]:[[e,String(t)]]);return Object.fromEntries(t)}async function uploadedPart(e){let t=e.name;return{name:typeof t==`string`?t:`blob`,mimeType:e.type===``?`application/octet-stream`:e.type,size:e.size,content:new Uint8Array(await e.arrayBuffer())}}async function wireRequest(e,t){let{query:n,body:r,headers:i}=u(e,t),a=Object.fromEntries(l(e.path).map(e=>[e,String(t[e])])),o=Object.fromEntries(Object.entries(i??{}).map(([e,t])=>[e.toLowerCase(),t])),s={params:a,query:asStrings(n),headers:o};if(e.upload===void 0)return{...s,body:r===void 0?void 0:JSON.parse(JSON.stringify(r))};let{[e.upload.field]:c,...d}=r??{},f=c==null?[]:Array.isArray(c)?c:[c];return{...s,body:asStrings(d),uploads:await Promise.all(f.map(uploadedPart))}}function downloaded(e){let t=typeof e.content==`string`?e.content:new Uint8Array(e.content);return{blob:new Blob([t],{type:e.mimeType}),filename:e.filename,mimeType:e.mimeType}}function createInProcessTransport(e){return transportActingAs(e,void 0)}function transportActingAs(e,t){async function call(n,r,i={}){if(i.signal?.throwIfAborted(),n.response===`events`)throw Error(`Operation ${n.name} streams over HTTP only`);let o=await wireRequest(n,r??{}),c;try{c=await e.execute(n,o,t)}catch(e){throw s(e)?refusalOf(e.status,JSON.stringify(e.body)):e}if(n.response===`bytes`)return downloaded(c);let l=c===void 0?null:JSON.parse(JSON.stringify(c));return a(n,l)}return{call,stream:e=>Promise.reject(/* @__PURE__ */ Error(`Operation ${e.name} streams over HTTP only`)),withCaller:t=>transportActingAs(e,t)}}function createAppClient(e){let t={},n=Object.values(i);for(let r of n.flatMap(e=>Object.values(e))){let n=c(r),i=r.name.slice(n.length+1);t[n]??={},t[n][i]=(t,n)=>r.response===`events`?e.stream(r,t,n):e.call(r,t,n)}return t}export{isDraftRevisionConflict as _,readRefusal as a,isViewNotFound as b,parseContentDispositionFilename as c,BundleConflictError as d,BundleValidationError as f,draftConflictChanges as g,StandardsRequestError as h,createTransport as i,m as l,StandardsConfigurationError as m,createInProcessTransport as n,refusalOf as o,StandardsAuthError as p,createHttpTransport as r,recordsPath as s,createAppClient as t,openAgentStream as u,isObjectNotFound as v,schemaApiErrorCode as x,isPermanentRefusal as y};

package/dist/app-_CiXRLoD.d.mts

@@ -0,0 +1,292 @@
+
+import { AgentSessionEvent, AgentStreamControlFrame, DraftConflictChange } from "@standards/schema";
+import { Operation, OperationCaller, OperationHost, OperationInput, OperationResult, appOperationGroups } from "@standards/schema/api";
+/**
+ * Any non-2xx answer from a Standards API. `code` is the server's `SchemaErrorCode` when it sent
+ * one; `details` is the body's `details` field, kept as the server sent it.
+ */
+declare class StandardsRequestError extends Error {
+  readonly status: number;
+  readonly code?: string;
+  readonly details?: unknown;
+  constructor(status: number, message: string, code?: string, details?: unknown);
+}
+/** 401 or 403: the key is missing, invalid, or lacks the permission the route requires. */
+declare class StandardsAuthError extends StandardsRequestError {
+  constructor(status: number, message: string, code?: string, details?: unknown);
+}
+/**
+ * 409 from `PUT /bundles/:name`: a name this bundle declares is owned by core or another bundle.
+ * A declared view that clashes with the workspace's views (a second default for the same object
+ * and context, or a name held by a system view) is a 409 too; its message names no owner, so
+ * `objectName` and `owner` are empty.
+ */
+declare class BundleConflictError extends StandardsRequestError {
+  /** The object or `object:view` name that clashed. */
+  readonly objectName: string;
+  /** `core` or `bundle:<name>`. */
+  readonly owner: string;
+  constructor(status: number, message: string, code: string | undefined);
+}
+/** 400 from `PUT /bundles/:name`: bad name, oversize payload, hash mismatch, invalid definition, or an unresolved migration. */
+declare class BundleValidationError extends StandardsRequestError {
+  constructor(status: number, message: string, code: string | undefined);
+}
+/** The client was constructed in a way it refuses to run (e.g. an API key in a browser). */
+declare class StandardsConfigurationError extends Error {
+  constructor(message: string);
+}
+/** Per-request overrides a multipart upload may carry. */
+interface MultipartRequestOptions {
+  /** This request's timeout in ms, instead of the client's `timeoutMs`. */
+  timeoutMs?: number;
+}
+interface HttpTransportConfig {
+  baseUrl: string;
+  /** A path joined between `baseUrl` and every request path. */
+  apiPrefix?: string;
+  fetch?: typeof fetch;
+  /** Read before every attempt, so a refreshed token reaches the retry. */
+  headers?: () => HeadersInit | Promise<HeadersInit>;
+  /** Asked on a 401; `true` means the credentials were refreshed and the request is sent once more. */
+  onUnauthorized?: () => Promise<boolean>;
+  /** Sees every response — success, refusal, and the retry after a refresh. Read-only: the body belongs to the request. */
+  onResponse?: (response: Response) => void;
+  /** Per attempt, in ms. Defaults to 30 000. */
+  timeoutMs?: number;
+  /** Extra attempts after the first for a GET (5xx and network failures). Defaults to 0. */
+  getRetries?: number;
+  /**
+   * The bearer an upload sent over XMLHttpRequest carries (to report its
+   * progress): XHR cannot run an injected `fetch`, where an app's auth lives,
+   * so with an injected `fetch` and no `uploadAuthorization` an upload goes
+   * through `fetch` and reports no progress.
+   */
+  uploadAuthorization?: () => Promise<string | null>;
+}
+/** Bytes of a multipart body sent so far, out of its total. */
+interface UploadProgress {
+  loaded: number;
+  total: number;
+}
+/** Per-call options of one operation. */
+interface OperationCallOptions {
+  /** Aborts the call: it rejects with the signal's reason (an `AbortError` by default). */
+  signal?: AbortSignal;
+  /** Extra attempts after the first; defaults to `getRetries` for a GET and 0 otherwise. */
+  maxRetries?: number;
+  /**
+   * This call's wait for the response headers, in ms, instead of the client's
+   * `timeoutMs`; `null` waits as long as it takes (an upload's body is sent
+   * before the headers come back, so a large one outlives any fixed deadline).
+   */
+  timeoutMs?: number | null;
+  /**
+   * Lets the request outlive the page that sent it (`fetch`'s `keepalive`),
+   * on every attempt: for a write taken right before a navigation, which the
+   * browser would otherwise cancel in flight.
+   */
+  keepalive?: boolean;
+  /**
+   * The bytes of an `upload` operation's body sent so far. `fetch` cannot
+   * report them, so the upload goes over XMLHttpRequest — one attempt, no
+   * deadline, no refresh on a 401 — when the transport can authenticate it
+   * there (see `uploadAuthorization`); otherwise it goes through `fetch` and
+   * reports nothing.
+   */
+  onUploadProgress?: (progress: UploadProgress) => void;
+}
+/**
+ * Per-call options of an `"events"` operation. No deadline and no retry: a
+ * stream outlives any request timeout, so its signal is the only abort.
+ */
+interface OperationStreamOptions {
+  signal?: AbortSignal;
+  /** Merged over the configured headers (`Accept: text/event-stream`). */
+  headers?: Record<string, string>;
+  /**
+   * Observes each HTTP attempt, the one after a 401 refresh included, so a
+   * reader can tell which credential a refusal answered.
+   */
+  onRequest?: () => void;
+}
+interface HttpTransport {
+  /**
+   * Sends one operation: path parameters fill the path; the rest is the query
+   * for a GET, otherwise the body, except the keys the operation lists in `query`.
+   * An `upload` operation sends its body as multipart, its files under the
+   * operation's field; a `response: "bytes"` one resolves to a `DownloadedFile`.
+   */
+  call<O extends Operation>(op: O, input: OperationInput<O>, options?: OperationCallOptions): Promise<OperationResult<O>>;
+  /**
+   * Opens an `"events"` operation and resolves to its `Response` once the
+   * headers are in, for the caller to read: no deadline, no retry, one
+   * refresh on a 401 (never on `MFA_REQUIRED`, which a token cannot satisfy).
+   * Any refusal is read and thrown as the typed error before a byte streams.
+   */
+  stream<O extends Operation>(op: O, input: OperationInput<O>, options?: OperationStreamOptions): Promise<Response>;
+  get<T = unknown>(path: string, params?: Record<string, unknown>): Promise<T>;
+  post<T = unknown>(path: string, body?: unknown): Promise<T>;
+  patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+  put<T = unknown>(path: string, body?: unknown): Promise<T>;
+  delete<T = unknown>(path: string): Promise<T>;
+  getText(path: string, params?: Record<string, unknown>): Promise<string>;
+  /**
+   * POST that hands back the unread `Response` so a caller can stream a large
+   * body (the CSV export). A refusal is read here and thrown as the typed error.
+   */
+  postRaw(path: string, body: unknown): Promise<Response>;
+  postMultipart<T>(path: string, form: FormData, options?: MultipartRequestOptions): Promise<T>;
+}
+/** The verbs the records, files and schema layers use; `createTransport` returns their superset. */
+/** What `createAppClient` calls: every operation, and a stream for an `"events"` one. */
+type OperationTransport = Pick<HttpTransport, "call" | "stream">;
+type Transport = Pick<HttpTransport, "call" | "get" | "post" | "patch" | "put" | "delete" | "getText" | "postRaw" | "postMultipart">;
+interface TransportConfig {
+  baseUrl: string;
+  apiKey: string;
+  tenantId?: string;
+  timeoutMs?: number;
+}
+/**
+ * A refusal read from its status and body text, for a response that is not a
+ * `Response` (an XMLHttpRequest upload): the same error the transport throws.
+ */
+declare function refusalOf(status: number, text: string): StandardsRequestError;
+/** Reads a refused `Response` into the error the transport itself throws. */
+declare function readRefusal(response: Response): Promise<StandardsRequestError>;
+declare function createHttpTransport(config: HttpTransportConfig): HttpTransport;
+/**
+ * The API-key transport the public SDK documents: `createHttpTransport` with
+ * the bearer key and tenant header, one attempt, no refresh.
+ */
+declare function createTransport(config: TransportConfig): HttpTransport;
+/** The server's `SchemaErrorCode` on a failed call, when it sent one. */
+declare function schemaApiErrorCode(error: unknown): string | undefined;
+/** Whether a failure is an answer, and so must not be asked again. */
+declare function isPermanentRefusal(error: unknown): boolean;
+/**
+ * Whether a failure says the object does not exist, rather than that the read
+ * failed (#3290): with a definition seeded from the cached catalogue, a 500 and
+ * a 404 are opposite answers — a transient failure may be ridden out, an
+ * authoritative not-found may not.
+ *
+ * Either signal is enough, deliberately: reading only the code would tolerate a
+ * deleted object behind a plainer not-found, reading only the status would miss
+ * a coded refusal carrying no status.
+ */
+declare function isObjectNotFound(error: unknown): boolean;
+/**
+ * Whether a write was refused because the draft moved since it was read
+ * (`DRAFT_REVISION_CONFLICT`, a 409): only a fresh read of the draft makes the
+ * next attempt mean something (#4899).
+ */
+declare function isDraftRevisionConflict(error: unknown): boolean;
+/**
+ * What a publish refused for a conflict found published on its targets since
+ * the draft captured them (#5936). Empty for any other refusal, a conflict on
+ * the draft's own revision included: that one is answered by reading it again.
+ */
+declare function draftConflictChanges(error: unknown): DraftConflictChange[];
+/**
+ * Whether a view read failed because the object simply has no view for that
+ * context (#2659) — a working object not laid out yet, not a failure.
+ *
+ * Status-only: the view routes' not-found carries the generic
+ * `SCHEMA_RECORD_NOT_FOUND` code, which says nothing view-specific. Call it
+ * ONLY on a view query's error — on any other query a 404 means something
+ * else entirely.
+ */
+declare function isViewNotFound(error: unknown): boolean;
+type AgentStreamStatus = "connecting" | "connected" | "reconnecting" | "error" | "auth-blocked";
+type AgentStreamHandle = {
+  close(): void;
+  /** Ends a pending reconnect delay now (the tab came back, the network returned). */
+  wake(): void;
+};
+type AgentStreamControl = AgentStreamControlFrame["control"];
+type OpenAgentStreamOptions = {
+  /**
+   * Opens the HTTP stream after `cursor` — the client method from agent-api.
+   * The transport (auth headers, 401 refresh) lives here; this loop owns only
+   * the parser and the reconnect policy.
+   */
+  open(sessionId: string, cursor: number, signal: AbortSignal, onRequest?: () => void): Promise<Response>;
+  sessionId: string;
+  /** The cursor every (re)connection opens after: the last seq the caller holds. */
+  cursor(): number;
+  /** One event, in seq order; the caller advances its cursor before returning. */
+  onEvent(event: AgentSessionEvent): void;
+  onControl(control: AgentStreamControl): void;
+  onStatus(status: AgentStreamStatus, error?: StandardsRequestError): void;
+  /**
+   * The server no longer holds the events after the cursor (410
+   * `AGENT_SESSION_STREAM_CURSOR_EXPIRED`): rehydrate, which moves the cursor
+   * to the history's `committedSeq`, then the loop reopens there.
+   */
+  onExpired(): Promise<void>;
+  /** Changed credentials only; independent of Presence authorization. */
+  subscribeAuthChanges?(listener: () => void): () => void;
+};
+/** The event types that end a turn. */
+declare const TURN_END_TYPES: ReadonlySet<AgentSessionEvent["type"]>;
+/**
+ * Read the session's durable event stream (spec §9.4) and keep it open.
+ *
+ * Fetch-based on purpose: `EventSource` cannot see the 410's code. Every
+ * connection opens after `cursor()`, so a reconnect — a 60 s lease ending, a
+ * network error — resumes exactly where the caller is, and an event at or
+ * below the cursor is never delivered twice. A 410 rehydrates once
+ * (`onExpired`), then reopens at the new cursor; 400/403/404 and an
+ * unresolvable actor are terminal; a 401 waits for a credential change.
+ */
+declare function openAgentStream(options: OpenAgentStreamOptions): AgentStreamHandle;
+/**
+ * Parse the download filename out of a `Content-Disposition` response header.
+ *
+ * The server is the single naming source (see `contentDispositionFilename` in
+ * adapter-nestjs): it emits both the RFC 5987 `filename*=UTF-8''...` form
+ * (accent-safe, percent-encoded) and a sanitized ASCII `filename="..."`
+ * fallback. We prefer the extended form and percent-decode it so accented,
+ * title-based names ("Pièce d'identité – 2.jpg") survive the round trip.
+ *
+ * Returns `undefined` when the header is absent or carries no filename, letting
+ * callers fall back to a client-side name.
+ */
+declare function parseContentDispositionFilename(header: string | null | undefined): string | undefined;
+/**
+ * The in-process transport: an {@link OperationTransport} that can also be
+ * bound to who acts, which a transport over HTTP cannot (its identity is the
+ * API key's).
+ */
+interface InProcessTransport extends OperationTransport {
+  /** The same transport, every call acting as `caller`. */
+  withCaller(caller: OperationCaller): InProcessTransport;
+}
+/**
+ * A transport over operations run in this process (the runtime's
+ * `createOperationHost`), for a server that embeds Standards: the same
+ * `createAppClient` API, inputs, answers and errors as over HTTP, without a
+ * socket. Each call acts as the actor the ambient context implies (the
+ * request's, the job's, the system where none runs), or as the one
+ * `withCaller` names, and each operation's permissions are checked as the
+ * HTTP API checks them. A refusal rejects with the `StandardsRequestError`
+ * (`StandardsAuthError` for 401/403) the HTTP transport would throw.
+ *
+ * Streams (`"events"` operations) are served over HTTP only.
+ */
+declare function createInProcessTransport(host: OperationHost): InProcessTransport;
+type AppOperationGroups = typeof appOperationGroups;
+type AppOperation = { [K in keyof AppOperationGroups]: AppOperationGroups[K][keyof AppOperationGroups[K]]; }[keyof AppOperationGroups];
+type NamespaceOf<N> = N extends `${infer G}.${string}` ? G : never;
+type VerbOf<N> = N extends `${string}.${infer V}` ? V : never;
+/** An `"events"` operation opens a stream (`transport.stream`); any other is one call. */
+type OptionsOf<O extends Operation> = O extends {
+  readonly response: "events";
+} ? OperationStreamOptions : OperationCallOptions;
+/** An input the schema defaults (`.default({})`) may be left out; `options` carries the call's signal. */
+type OperationCall<O extends Operation> = (...args: undefined extends OperationInput<O> ? [input?: OperationInput<O>, options?: OptionsOf<O>] : [input: OperationInput<O>, options?: OptionsOf<O>]) => Promise<OperationResult<O>>;
+type AppClient = { readonly [G in NamespaceOf<AppOperation["name"]>]: { readonly [O in AppOperation as NamespaceOf<O["name"]> extends G ? VerbOf<O["name"]> : never]: OperationCall<O>; }; };
+/** The namespaced client over every app operation: `client.apiKeys.revoke({ id })`. */
+declare function createAppClient(transport: OperationTransport): AppClient;
+export { refusalOf as A, OperationTransport as C, createHttpTransport as D, UploadProgress as E, StandardsRequestError as F, BundleValidationError as M, StandardsAuthError as N, createTransport as O, StandardsConfigurationError as P, OperationStreamOptions as S, TransportConfig as T, schemaApiErrorCode as _, parseContentDispositionFilename as a, MultipartRequestOptions as b, AgentStreamStatus as c, openAgentStream as d, draftConflictChanges as f, isViewNotFound as g, isPermanentRefusal as h, createInProcessTransport as i, BundleConflictError as j, readRefusal as k, OpenAgentStreamOptions as l, isObjectNotFound as m, createAppClient as n, AgentStreamControl as o, isDraftRevisionConflict as p, InProcessTransport as r, AgentStreamHandle as s, AppClient as t, TURN_END_TYPES as u, HttpTransport as v, Transport as w, OperationCallOptions as x, HttpTransportConfig as y };