experimental-ash 0.62.0 → 0.64.0

package/dist/src/client/ash-agent-store.d.ts

@@ -0,0 +1,61 @@
+import type { AshAgentReducer } from "#client/reducer.js";
+import type { ClientSession } from "#client/session.js";
+import type { HandleMessageStreamEvent } from "#protocol/message.js";
+import type { ClientAuth, HeadersValue, SendMessageOptions, SendTurnInput, SessionState } from "#client/types.js";
+export type AshAgentStoreStatus = "error" | "ready" | "streaming" | "submitted";
+/**
+ * Prepares one outbound turn immediately before the client sends it.
+ *
+ * Use this to attach fresh, one-turn client state such as page context via
+ * `clientContext`.
+ */
+export type PrepareSend = (input: SendTurnInput) => SendTurnInput | Promise<SendTurnInput>;
+/**
+ * Current projected state for an Ash agent session.
+ */
+export interface AshAgentStoreSnapshot<TData> {
+    readonly data: TData;
+    readonly error: Error | undefined;
+    readonly events: readonly HandleMessageStreamEvent[];
+    readonly session: SessionState;
+    readonly status: AshAgentStoreStatus;
+}
+/**
+ * Lifecycle callbacks invoked while the store processes a turn.
+ */
+export interface AshAgentStoreCallbacks<TData> {
+    readonly onError?: (error: Error) => void;
+    readonly onEvent?: (event: HandleMessageStreamEvent) => void;
+    readonly onFinish?: (snapshot: AshAgentStoreSnapshot<TData>) => void;
+    readonly onSessionChange?: (session: SessionState) => void;
+    readonly prepareSend?: PrepareSend;
+}
+export interface AshAgentStoreInit<TData> {
+    readonly auth?: ClientAuth;
+    readonly headers?: HeadersValue;
+    readonly host?: string;
+    readonly initialEvents?: readonly HandleMessageStreamEvent[];
+    readonly initialSession?: SessionState;
+    readonly maxReconnectAttempts?: number;
+    readonly optimistic?: boolean;
+    readonly reducer: AshAgentReducer<TData>;
+    readonly session?: ClientSession;
+}
+/**
+ * Framework-agnostic state machine for an Ash agent session.
+ *
+ * Manages the send/stream lifecycle, optimistic projection, and
+ * subscriber notification. Framework integrations (React, Vue) wrap this
+ * store with their own reactivity primitives.
+ */
+export declare class AshAgentStore<TData> {
+    #private;
+    constructor(init: AshAgentStoreInit<TData>);
+    get snapshot(): AshAgentStoreSnapshot<TData>;
+    setCallbacks(callbacks: AshAgentStoreCallbacks<TData>): void;
+    subscribe(callback: () => void): () => void;
+    sendMessage(message: string, options?: SendMessageOptions): Promise<void>;
+    send(input: SendTurnInput, options?: SendMessageOptions): Promise<void>;
+    stop(): void;
+    reset(): void;
+}

package/dist/src/client/ash-agent-store.js

@@ -0,0 +1,2 @@
+import{toError}from"#shared/errors.js";import{Client}from"#client/client.js";var AshAgentStore=class{#e;#t;#n;#r=new Set;#i;#a={};#o;#s;#c;#l=0;#u;#d;#f;#p;#m=`ready`;constructor(e){this.#e=e.session?void 0:()=>new Client({auth:e.auth,headers:e.headers,host:e.host??``,maxReconnectAttempts:e.maxReconnectAttempts}).session(e.initialSession),this.#c=[...e.initialEvents??[]],this.#d=[...this.#c],this.#t=e.optimistic??!0,this.#n=e.reducer,this.#f=e.session??this.#h(),this.#o=this.#E(this.#d),this.#p=this.#D()}get snapshot(){return this.#p}setCallbacks(e){this.#a=e}subscribe(e){return this.#r.add(e),()=>{this.#r.delete(e)}}async sendMessage(e,t){await this.send({message:e},t)}async send(t,n){if(this.#m===`streaming`||this.#m===`submitted`)throw Error(`Ash session is already processing a turn.`);let r=this.#g(),i=new AbortController;this.#i=i,this.#s=void 0,this.#m=`submitted`,this.#O();try{let e=await this.#a.prepareSend?.(t)??t;if(!this.#v(r))return;this.#y(e),this.#b(e),this.#O();let a=await this.#f.send(e,{...n,signal:createAbortSignal(n?.signal,i.signal)}),o=!1;for await(let e of a){if(!this.#v(r))return;o||(o=!0,this.#m=`streaming`),this.#c=[...this.#c,e],this.#x(e),this.#a.onEvent?.(e),this.#S(e),this.#O()}if(!this.#v(r))return;this.#m=this.#s===void 0?`ready`:`error`}catch(t){if(!this.#v(r))return;isAbortError(t)?(this.#m=`ready`,this.#C(toError(t))):(this.#s=toError(t),this.#m=`error`,this.#C(this.#s),this.#a.onError?.(this.#s))}finally{this.#v(r)&&(this.#i=void 0,this.#a.onSessionChange?.(this.#f.state),this.#O(),this.#a.onFinish?.(this.#p))}}stop(){this.#i?.abort()}reset(){this.#_(),this.stop(),this.#i=void 0,this.#f=this.#e?.()??this.#f,this.#c=[],this.#u=void 0,this.#d=[],this.#o=this.#n.initial(),this.#s=void 0,this.#m=`ready`,this.#a.onSessionChange?.(this.#f.state),this.#O()}#h(){if(!this.#e)throw Error(`Cannot create an owned Ash session from an external session.`);return this.#e()}#g(){return this.#l+=1,this.#l}#_(){this.#l+=1}#v(e){return this.#l===e}#y(e){if(!this.#t||e.message===void 0)return;let t=createSubmissionId(),n={createdAt:Date.now(),id:t,message:summarizeUserContent(e.message)};this.#u=n,this.#w({data:{createdAt:n.createdAt,message:n.message,submissionId:n.id},type:`client.message.submitted`})}#b(e){e.inputResponses===void 0||e.inputResponses.length===0||this.#w({data:{createdAt:Date.now(),responses:e.inputResponses},type:`client.input.responded`})}#x(e){if(e.type===`message.received`&&this.#u!==void 0){let t=this.#u.id;this.#u=void 0,this.#T(e=>e.type===`client.message.submitted`&&e.data.submissionId===t,e);return}this.#w(e)}#S(e){let t=toTerminalStreamFailureError(e);t!==void 0&&(this.#m=`error`,this.#C(t),this.#s===void 0&&(this.#s=t,this.#a.onError?.(t)))}#C(e){let t=this.#u;t!==void 0&&(this.#u=void 0,this.#T(e=>e.type===`client.message.submitted`&&e.data.submissionId===t.id,{data:{createdAt:t.createdAt,error:{message:e.message},message:t.message,submissionId:t.id},type:`client.message.failed`}))}#w(e){this.#d=[...this.#d,e],this.#o=this.#n.reduce(this.#o,e)}#T(e,t){let n=!1;this.#d=this.#d.map(r=>!n&&e(r)?(n=!0,t):r),n||(this.#d=[...this.#d,t]),this.#o=this.#E(this.#d)}#E(e){let t=this.#n.initial();for(let n of e)t=this.#n.reduce(t,n);return t}#D(){return{data:this.#o,error:this.#s,events:this.#c,session:this.#f.state,status:this.#m}}#O(){this.#p=this.#D();for(let e of this.#r)e()}};let submissionSequence=0;function createSubmissionId(){let e=globalThis.crypto?.randomUUID;return e===void 0?(submissionSequence+=1,`submission_${submissionSequence.toString()}`):e.call(globalThis.crypto)}function createAbortSignal(e,t){return e?AbortSignal.any([e,t]):t}function summarizeUserContent(e){if(typeof e==`string`)return e;let t=[];for(let n of e){if(n.type===`text`){t.push(n.text);continue}n.type===`file`&&t.push(n.filename?`[file: ${n.filename}]`:`[file]`)}return t.join(`
+`)}function isAbortError(e){return e instanceof Error&&e.name===`AbortError`}function toTerminalStreamFailureError(e){if(e.type!==`session.failed`)return;let t=Error(e.data.message);return t.name=e.data.code,t}export{AshAgentStore};

package/dist/src/client/client-error.js

@@ -1 +1 @@
-var ClientError=class extends Error{status;body;constructor(e,t){super(t||`Server returned ${e}.`),this.name=`ClientError`,this.status=e,this.body=t}};export{ClientError};
+import{isObject}from"#shared/guards.js";var ClientError=class extends Error{status;body;constructor(e,t){let n=t||`Server returned ${e}.`;try{let e=JSON.parse(t);isObject(e)&&typeof e.error==`string`&&(n=e.error)}catch{}super(n),this.name=`ClientError`,this.status=e,this.body=t}};export{ClientError};

package/dist/src/client/index.d.ts

@@ -1,8 +1,10 @@
+export { AshAgentStore } from "#client/ash-agent-store.js";
 export { Client } from "#client/client.js";
 export { ClientError } from "#client/client-error.js";
 export { defaultMessageReducer } from "#client/message-reducer.js";
 export { MessageResponse } from "#client/message-response.js";
 export { ClientSession } from "#client/session.js";
+export type { AshAgentStoreCallbacks, AshAgentStoreInit, AshAgentStoreSnapshot, AshAgentStoreStatus, PrepareSend, } from "#client/ash-agent-store.js";
 export type { ClientAuth, ClientOptions, HeadersValue, HealthResult, MessageResult, OpenStreamOptions, SendMessageOptions, SendTurnInput, SessionState, TokenValue, } from "#client/types.js";
 export type { AshAgentReducer, AshAgentReducerEvent, ClientInputRespondedEvent, ClientMessageFailedEvent, ClientMessageSubmittedEvent, } from "#client/reducer.js";
 export type { AshMessageData, AshDynamicToolPart, AshMessageInputRequest, AshMessage, AshMessageMetadata, AshMessagePart, AshMessageToolMetadata, } from "#client/message-reducer.js";

package/dist/src/client/index.js

@@ -1 +1 @@
-import{resolveTextToResponse,resolveTextToResponses}from"#channel/resolve-text.js";import{isCurrentTurnBoundaryEvent}from"#protocol/message.js";import{ClientError}from"#client/client-error.js";import{ClientSession}from"#client/session.js";import{Client}from"#client/client.js";import{defaultMessageReducer}from"#client/message-reducer.js";import{MessageResponse}from"#client/message-response.js";import{inputOptionSchema,inputRequestSchema,inputResponseSchema,isInputRequest,isInputResponse}from"#runtime/input/types.js";export{Client,ClientError,ClientSession,MessageResponse,defaultMessageReducer,inputOptionSchema,inputRequestSchema,inputResponseSchema,isCurrentTurnBoundaryEvent,isInputRequest,isInputResponse,resolveTextToResponse,resolveTextToResponses};
+import{resolveTextToResponse,resolveTextToResponses}from"#channel/resolve-text.js";import{isCurrentTurnBoundaryEvent}from"#protocol/message.js";import{Client}from"#client/client.js";import{ClientError}from"#client/client-error.js";import{ClientSession}from"#client/session.js";import{AshAgentStore}from"#client/ash-agent-store.js";import{defaultMessageReducer}from"#client/message-reducer.js";import{MessageResponse}from"#client/message-response.js";import{inputOptionSchema,inputRequestSchema,inputResponseSchema,isInputRequest,isInputResponse}from"#runtime/input/types.js";export{AshAgentStore,Client,ClientError,ClientSession,MessageResponse,defaultMessageReducer,inputOptionSchema,inputRequestSchema,inputResponseSchema,isCurrentTurnBoundaryEvent,isInputRequest,isInputResponse,resolveTextToResponse,resolveTextToResponses};

package/dist/src/compiled/.vendor-stamp.json

@@ -22,9 +22,9 @@
     "turndown": "7.2.4",
     "@vercel/oidc": "3.5.0",
     "@vercel/sandbox": "2.1.0",
-    "@workflow/core": "5.0.0-beta.11",
-    "@workflow/errors": "5.0.0-beta.6",
-    "@workflow/world": "5.0.0-beta.6",
+    "@workflow/core": "5.0.0-beta.12",
+    "@workflow/errors": "5.0.0-beta.7",
+    "@workflow/world": "5.0.0-beta.7",
     "zod": "4.4.3",
     "zod-validation-error": "5.0.0"
   },