experimental-ash 0.26.0 → 0.28.0

package/dist/src/public/tools/defaults.js

@@ -1,70 +1 @@
-/**
- * Framework-provided tool definitions exposed as plain {@link ToolDefinition}
- * values so authors can spread, wrap, or patch them inside their own
- * `agent/tools/*.ts` files.
- */
-import { BASH_TOOL_DEFINITION } from "#runtime/framework-tools/bash.js";
-import { GLOB_TOOL_DEFINITION } from "#runtime/framework-tools/glob.js";
-import { GREP_TOOL_DEFINITION } from "#runtime/framework-tools/grep.js";
-import { READ_FILE_TOOL_DEFINITION } from "#runtime/framework-tools/read-file.js";
-import { SKILL_TOOL_DEFINITION } from "#runtime/framework-tools/skill.js";
-import { TODO_TOOL_DEFINITION } from "#runtime/framework-tools/todo.js";
-import { WEB_FETCH_TOOL_DEFINITION } from "#runtime/framework-tools/web-fetch.js";
-import { WEB_SEARCH_TOOL_DEFINITION } from "#runtime/framework-tools/web-search.js";
-import { WRITE_FILE_TOOL_DEFINITION } from "#runtime/framework-tools/write-file.js";
-import { toPublicToolDefinition } from "#public/tools/internal.js";
-/**
- * Framework-provided shell execution tool. Spread or wrap to customize.
- */
-export const bash = toPublicToolDefinition(BASH_TOOL_DEFINITION);
-/**
- * Framework-provided file search tool. Finds files by glob pattern. Spread
- * or wrap to customize.
- */
-export const glob = toPublicToolDefinition(GLOB_TOOL_DEFINITION);
-/**
- * Framework-provided content search tool. Searches file contents by regex
- * pattern. Spread or wrap to customize.
- */
-export const grep = toPublicToolDefinition(GREP_TOOL_DEFINITION);
-/**
- * Framework-provided file reader tool. Spread or wrap to customize. Carries
- * compaction state-reset behavior so a wrapped replacement still clears the
- * durable read-file stamps on context compaction.
- */
-export const readFile = toPublicToolDefinition(READ_FILE_TOOL_DEFINITION);
-/**
- * Framework-provided file writer tool. Spread or wrap to customize.
- * Enforces read-before-write for existing files and stale-read detection.
- */
-export const writeFile = toPublicToolDefinition(WRITE_FILE_TOOL_DEFINITION);
-/**
- * Framework-provided HTTP fetch tool. Spread or wrap to customize.
- */
-export const webFetch = toPublicToolDefinition(WEB_FETCH_TOOL_DEFINITION);
-/**
- * Framework-provided durable todo list tool. Spreading the default carries
- * its closure-bound state behavior — the executor still reads and writes the
- * framework's internal todo state. Replace with a fully custom executor (and
- * your own `ContextKey`) if you need different state semantics.
- */
-export const todo = toPublicToolDefinition(TODO_TOOL_DEFINITION);
-/**
- * Framework-provided skill loading tool. Only effective when the agent has
- * skills declared (the framework otherwise omits it from the default tool
- * list).
- */
-export const loadSkill = toPublicToolDefinition(SKILL_TOOL_DEFINITION);
-/**
- * Framework-provided web search tool. The actual implementation is resolved
- * at runtime based on the model provider — there is no local execute.
- * Override with `defineTool()` to provide a custom implementation.
- */
-export const webSearch = {
-    description: WEB_SEARCH_TOOL_DEFINITION.description,
-    inputSchema: {},
-    execute() {
-        throw new Error("web_search is provider-managed and has no local execute. " +
-            "Override with defineTool() to provide a custom implementation.");
-    },
-};
+import{WEB_SEARCH_TOOL_DEFINITION}from"#runtime/framework-tools/web-search.js";import{BASH_TOOL_DEFINITION}from"#runtime/framework-tools/bash.js";import{GLOB_TOOL_DEFINITION}from"#runtime/framework-tools/glob.js";import{GREP_TOOL_DEFINITION}from"#runtime/framework-tools/grep.js";import{READ_FILE_TOOL_DEFINITION}from"#runtime/framework-tools/read-file.js";import{SKILL_TOOL_DEFINITION}from"#runtime/framework-tools/skill.js";import{TODO_TOOL_DEFINITION}from"#runtime/framework-tools/todo.js";import{WEB_FETCH_TOOL_DEFINITION}from"#runtime/framework-tools/web-fetch.js";import{WRITE_FILE_TOOL_DEFINITION}from"#runtime/framework-tools/write-file.js";import{toPublicToolDefinition}from"#public/tools/internal.js";var bash=toPublicToolDefinition(BASH_TOOL_DEFINITION),glob=toPublicToolDefinition(GLOB_TOOL_DEFINITION),grep=toPublicToolDefinition(GREP_TOOL_DEFINITION),readFile=toPublicToolDefinition(READ_FILE_TOOL_DEFINITION),writeFile=toPublicToolDefinition(WRITE_FILE_TOOL_DEFINITION),webFetch=toPublicToolDefinition(WEB_FETCH_TOOL_DEFINITION),todo=toPublicToolDefinition(TODO_TOOL_DEFINITION),loadSkill=toPublicToolDefinition(SKILL_TOOL_DEFINITION),webSearch={description:WEB_SEARCH_TOOL_DEFINITION.description,inputSchema:{},execute(){throw Error(`web_search is provider-managed and has no local execute. Override with defineTool() to provide a custom implementation.`)}};export{bash,glob,grep,loadSkill,readFile,todo,webFetch,webSearch,writeFile};

package/dist/src/public/tools/define-bash-tool.js

@@ -1,14 +1 @@
-import { executeBashOnSandbox } from "#execution/sandbox/bash-tool.js";
-import { BASH_INPUT_SCHEMA } from "#runtime/framework-tools/bash.js";
-/**
- * Defines a model-visible shell-runner tool for the agent sandbox.
- */
-export function defineBashTool(input = {}) {
-    return {
-        description: input.description ?? "Execute a shell command in the workspace sandbox.",
-        async execute(args) {
-            return executeBashOnSandbox(args);
-        },
-        inputSchema: BASH_INPUT_SCHEMA,
-    };
-}
+import{BASH_INPUT_SCHEMA}from"#runtime/framework-tools/bash.js";import{executeBashOnSandbox}from"#execution/sandbox/bash-tool.js";function defineBashTool(t={}){return{description:t.description??`Execute a shell command in the workspace sandbox.`,async execute(e){return executeBashOnSandbox(e)},inputSchema:BASH_INPUT_SCHEMA}}export{defineBashTool};

package/dist/src/public/tools/define-glob-tool.js

@@ -1,21 +1 @@
-import { executeGlobOnSandbox } from "#execution/sandbox/glob-tool.js";
-import { GLOB_INPUT_SCHEMA } from "#runtime/framework-tools/glob.js";
-/**
- * Defines a model-visible file-search tool that discovers files by
- * glob pattern inside the agent's sandbox. Uses the same executor core
- * as the framework `glob` tool, so input schema, error messages, and
- * result shape are identical.
- *
- * The tool's runtime name comes from the authored file's slug — for
- * example `agent/tools/find_files.ts` becomes a tool named
- * `find_files`.
- */
-export function defineGlobTool(input = {}) {
-    return {
-        description: input.description ?? "Search for files by glob pattern in the workspace sandbox.",
-        async execute(args) {
-            return executeGlobOnSandbox(args);
-        },
-        inputSchema: GLOB_INPUT_SCHEMA,
-    };
-}
+import{GLOB_INPUT_SCHEMA}from"#runtime/framework-tools/glob.js";import{executeGlobOnSandbox}from"#execution/sandbox/glob-tool.js";function defineGlobTool(t={}){return{description:t.description??`Search for files by glob pattern in the workspace sandbox.`,async execute(e){return executeGlobOnSandbox(e)},inputSchema:GLOB_INPUT_SCHEMA}}export{defineGlobTool};

package/dist/src/public/tools/define-grep-tool.js

@@ -1,21 +1 @@
-import { executeGrepOnSandbox } from "#execution/sandbox/grep-tool.js";
-import { GREP_INPUT_SCHEMA } from "#runtime/framework-tools/grep.js";
-/**
- * Defines a model-visible content-search tool that searches file
- * contents by pattern inside the agent's sandbox. Uses the same
- * executor core as the framework `grep` tool, so input schema, error
- * messages, and result shape are identical.
- *
- * The tool's runtime name comes from the authored file's slug — for
- * example `agent/tools/search_code.ts` becomes a tool named
- * `search_code`.
- */
-export function defineGrepTool(input = {}) {
-    return {
-        description: input.description ?? "Search file contents by pattern in the workspace sandbox.",
-        async execute(args) {
-            return executeGrepOnSandbox(args);
-        },
-        inputSchema: GREP_INPUT_SCHEMA,
-    };
-}
+import{GREP_INPUT_SCHEMA}from"#runtime/framework-tools/grep.js";import{executeGrepOnSandbox}from"#execution/sandbox/grep-tool.js";function defineGrepTool(t={}){return{description:t.description??`Search file contents by pattern in the workspace sandbox.`,async execute(e){return executeGrepOnSandbox(e)},inputSchema:GREP_INPUT_SCHEMA}}export{defineGrepTool};

package/dist/src/public/tools/define-read-file-tool.js

@@ -1,27 +1 @@
-import { executeReadFileOnSandbox } from "#execution/sandbox/read-file-tool.js";
-import { clearReadFileState } from "#runtime/framework-tools/file-state.js";
-import { READ_FILE_INPUT_SCHEMA } from "#runtime/framework-tools/read-file.js";
-/**
- * Defines a model-visible file-reader tool that reads files from the
- * agent's sandbox. Uses the same executor core as the framework
- * `read_file` tool, so input schema, error messages, and result shape
- * are identical.
- *
- * The tool's runtime name comes from the authored file's slug — for
- * example `agent/tools/read_file.ts` becomes a tool named `read_file`.
- */
-export function defineReadFileTool(input = {}) {
-    const onCompact = input.onCompact ??
-        (({ ctx }) => {
-            clearReadFileState(ctx);
-            return {};
-        });
-    return {
-        description: input.description ?? "Read a file from the workspace sandbox.",
-        async execute(args) {
-            return executeReadFileOnSandbox(args);
-        },
-        inputSchema: READ_FILE_INPUT_SCHEMA,
-        onCompact,
-    };
-}
+import{clearReadFileState}from"#runtime/framework-tools/file-state.js";import{READ_FILE_INPUT_SCHEMA}from"#runtime/framework-tools/read-file.js";import{executeReadFileOnSandbox}from"#execution/sandbox/read-file-tool.js";function defineReadFileTool(n={}){let r=n.onCompact??(({ctx:t})=>(clearReadFileState(t),{}));return{description:n.description??`Read a file from the workspace sandbox.`,async execute(e){return executeReadFileOnSandbox(e)},inputSchema:READ_FILE_INPUT_SCHEMA,onCompact:r}}export{defineReadFileTool};

package/dist/src/public/tools/define-write-file-tool.js

@@ -1,21 +1 @@
-import { executeWriteFileOnSandbox, } from "#execution/sandbox/write-file-tool.js";
-import { WRITE_FILE_INPUT_SCHEMA } from "#runtime/framework-tools/write-file.js";
-/**
- * Defines a model-visible file-writer tool that writes files to the
- * agent's sandbox. Uses the same executor core as the framework
- * `write_file` tool, so input schema, error messages, and result shape
- * are identical.
- *
- * The tool's runtime name comes from the authored file's slug — for
- * example `agent/tools/write_file.ts` becomes a tool named
- * `write_file`.
- */
-export function defineWriteFileTool(input = {}) {
-    return {
-        description: input.description ?? "Write a file to the workspace sandbox.",
-        async execute(args) {
-            return executeWriteFileOnSandbox(args);
-        },
-        inputSchema: WRITE_FILE_INPUT_SCHEMA,
-    };
-}
+import{WRITE_FILE_INPUT_SCHEMA}from"#runtime/framework-tools/write-file.js";import{executeWriteFileOnSandbox}from"#execution/sandbox/write-file-tool.js";function defineWriteFileTool(t={}){return{description:t.description??`Write a file to the workspace sandbox.`,async execute(e){return executeWriteFileOnSandbox(e)},inputSchema:WRITE_FILE_INPUT_SCHEMA}}export{defineWriteFileTool};

package/dist/src/public/tools/index.js

@@ -1,10 +1 @@
-/**
- * Tool authoring helpers for `agent/tools/*.ts` files.
- */
-export { defineTool, disableTool, isDisabledToolSentinel, } from "#public/definitions/tool.js";
-export { toolResultFrom, } from "#public/tool-result-narrowing.js";
-export { defineBashTool } from "#public/tools/define-bash-tool.js";
-export { defineGlobTool } from "#public/tools/define-glob-tool.js";
-export { defineGrepTool } from "#public/tools/define-grep-tool.js";
-export { defineReadFileTool, } from "#public/tools/define-read-file-tool.js";
-export { defineWriteFileTool, } from "#public/tools/define-write-file-tool.js";
+import{defineTool,disableTool,isDisabledToolSentinel}from"#public/definitions/tool.js";import{toolResultFrom}from"#public/tool-result-narrowing.js";import{defineBashTool}from"#public/tools/define-bash-tool.js";import{defineGlobTool}from"#public/tools/define-glob-tool.js";import{defineGrepTool}from"#public/tools/define-grep-tool.js";import{defineReadFileTool}from"#public/tools/define-read-file-tool.js";import{defineWriteFileTool}from"#public/tools/define-write-file-tool.js";export{defineBashTool,defineGlobTool,defineGrepTool,defineReadFileTool,defineTool,defineWriteFileTool,disableTool,isDisabledToolSentinel,toolResultFrom};

package/dist/src/public/tools/internal.js

@@ -1,24 +1 @@
-/**
- * Converter that strips internal identity fields from a framework
- * {@link ResolvedToolDefinition} so it can be re-exported as a public
- * {@link ToolDefinition}.
- */
-export function toPublicToolDefinition(definition) {
-    if (!definition.execute) {
-        throw new Error(`Tool "${definition.name}" is client-side and cannot be re-exported publicly.`);
-    }
-    const execute = definition.execute;
-    const inputSchema = definition.inputSchema;
-    const publicDefinition = {
-        description: definition.description,
-        execute,
-        inputSchema: (inputSchema ?? {}),
-    };
-    if (definition.needsApproval !== undefined) {
-        publicDefinition.needsApproval = definition.needsApproval;
-    }
-    if (definition.onCompact !== undefined) {
-        publicDefinition.onCompact = definition.onCompact;
-    }
-    return publicDefinition;
-}
+function toPublicToolDefinition(e){if(!e.execute)throw Error(`Tool "${e.name}" is client-side and cannot be re-exported publicly.`);let t=e.execute,n=e.inputSchema,r={description:e.description,execute:t,inputSchema:n??{}};return e.needsApproval!==void 0&&(r.needsApproval=e.needsApproval),e.onCompact!==void 0&&(r.onCompact=e.onCompact),r}export{toPublicToolDefinition};

package/dist/src/public/types/json.js

@@ -1,13 +1 @@
-/**
- * Shared JSON primitive used by public Ash APIs that need to declare
- * author-supplied values as JSON-serializable.
- *
- * The canonical use site is {@link AuthorizationDefinition}, whose
- * `State` type is constrained to {@link JsonValue} so that state
- * journaled by WDK between `startAuthorization` and
- * `completeAuthorization` is guaranteed round-trippable through a
- * serializer. Kept in a dedicated module so any future public
- * interface with the same serialization requirement can reuse it
- * without depending on a connection-specific module.
- */
-export {};
+export{};

package/dist/src/react/index.js

@@ -1,3 +1 @@
-export { useAshAgent, } from "#react/use-ash-agent.js";
-export {} from "#client/reducer.js";
-export { defaultMessageReducer, } from "#client/message-reducer.js";
+import{defaultMessageReducer}from"#client/message-reducer.js";import{useAshAgent}from"#react/use-ash-agent.js";export{defaultMessageReducer,useAshAgent};

package/dist/src/react/use-ash-agent.js

@@ -1,348 +1,2 @@
-import { useCallback, useMemo, useRef, useSyncExternalStore } from "react";
-import { Client } from "#client/client.js";
-import { defaultMessageReducer } from "#client/message-reducer.js";
-import { toError } from "#shared/errors.js";
-/**
- * React hook for driving an Ash session and projecting Ash events into UI data.
- */
-export function useAshAgent(options = {}) {
-    const storeRef = useRef(undefined);
-    if (!storeRef.current) {
-        const reducer = options.reducer ?? defaultMessageReducer();
-        storeRef.current = new UseAshAgentStore({
-            auth: options.auth,
-            headers: options.headers,
-            host: options.host,
-            initialEvents: options.initialEvents,
-            initialSession: options.initialSession,
-            maxReconnectAttempts: options.maxReconnectAttempts,
-            optimistic: options.optimistic,
-            reducer,
-            session: options.session,
-        });
-    }
-    const store = storeRef.current;
-    store.setCallbacks({
-        onError: options.onError,
-        onEvent: options.onEvent,
-        onFinish: options.onFinish,
-        onSessionChange: options.onSessionChange,
-        prepareSend: options.prepareSend,
-    });
-    const subscribe = useCallback((onStoreChange) => store.subscribe(onStoreChange), [store]);
-    const snapshot = useSyncExternalStore(subscribe, () => store.snapshot, () => store.snapshot);
-    const reset = useCallback(() => store.reset(), [store]);
-    const send = useCallback((input, sendOptions) => {
-        return store.send(input, sendOptions);
-    }, [store]);
-    const sendMessage = useCallback((message, sendOptions) => {
-        return store.sendMessage(message, sendOptions);
-    }, [store]);
-    const stop = useCallback(() => store.stop(), [store]);
-    return useMemo(() => ({
-        ...snapshot,
-        reset,
-        send,
-        sendMessage,
-        stop,
-    }), [reset, send, sendMessage, snapshot, stop]);
-}
-class UseAshAgentStore {
-    #createSession;
-    #optimistic;
-    #reducer;
-    #subscribers = new Set();
-    #abortController;
-    #callbacks = {};
-    #data;
-    #error;
-    #events;
-    #operationId = 0;
-    #pendingMessageSubmission;
-    #projectionEvents;
-    #session;
-    #snapshot;
-    #status = "ready";
-    constructor(init) {
-        this.#createSession = init.session
-            ? undefined
-            : () => new Client({
-                auth: init.auth,
-                headers: init.headers,
-                host: init.host ?? "",
-                maxReconnectAttempts: init.maxReconnectAttempts,
-            }).session(init.initialSession);
-        this.#events = [...(init.initialEvents ?? [])];
-        this.#projectionEvents = [...this.#events];
-        this.#optimistic = init.optimistic ?? true;
-        this.#reducer = init.reducer;
-        this.#session = init.session ?? this.#createOwnedSession();
-        this.#data = this.#reduceProjectionEvents(this.#projectionEvents);
-        this.#snapshot = this.#createSnapshot();
-    }
-    get snapshot() {
-        return this.#snapshot;
-    }
-    setCallbacks(callbacks) {
-        this.#callbacks = callbacks;
-    }
-    subscribe(callback) {
-        this.#subscribers.add(callback);
-        return () => {
-            this.#subscribers.delete(callback);
-        };
-    }
-    async sendMessage(message, options) {
-        await this.send({ message }, options);
-    }
-    async send(input, options) {
-        if (this.#status === "streaming" || this.#status === "submitted") {
-            throw new Error("Ash session is already processing a turn.");
-        }
-        const operationId = this.#startOperation();
-        const abortController = new AbortController();
-        this.#abortController = abortController;
-        this.#error = undefined;
-        this.#status = "submitted";
-        this.#publish();
-        try {
-            const preparedInput = (await this.#callbacks.prepareSend?.(input)) ?? input;
-            if (!this.#isCurrentOperation(operationId)) {
-                return;
-            }
-            this.#projectOptimisticMessage(preparedInput);
-            this.#projectInputResponses(preparedInput);
-            this.#publish();
-            const response = await this.#session.send(preparedInput, {
-                ...options,
-                signal: createAbortSignal(options?.signal, abortController.signal),
-            });
-            let sawEvent = false;
-            for await (const event of response) {
-                if (!this.#isCurrentOperation(operationId)) {
-                    return;
-                }
-                if (!sawEvent) {
-                    sawEvent = true;
-                    this.#status = "streaming";
-                }
-                this.#events = [...this.#events, event];
-                this.#applyServerEvent(event);
-                this.#callbacks.onEvent?.(event);
-                this.#applyTerminalStreamFailure(event);
-                this.#publish();
-            }
-            if (!this.#isCurrentOperation(operationId)) {
-                return;
-            }
-            this.#status = this.#error === undefined ? "ready" : "error";
-        }
-        catch (error) {
-            if (!this.#isCurrentOperation(operationId)) {
-                return;
-            }
-            if (isAbortError(error)) {
-                this.#status = "ready";
-                this.#failPendingMessageSubmission(toError(error));
-            }
-            else {
-                this.#error = toError(error);
-                this.#status = "error";
-                this.#failPendingMessageSubmission(this.#error);
-                this.#callbacks.onError?.(this.#error);
-            }
-        }
-        finally {
-            if (this.#isCurrentOperation(operationId)) {
-                this.#abortController = undefined;
-                this.#callbacks.onSessionChange?.(this.#session.state);
-                this.#publish();
-                this.#callbacks.onFinish?.(this.#snapshot);
-            }
-        }
-    }
-    stop() {
-        this.#abortController?.abort();
-    }
-    reset() {
-        this.#invalidateOperation();
-        this.stop();
-        this.#abortController = undefined;
-        this.#session = this.#createSession?.() ?? this.#session;
-        this.#events = [];
-        this.#pendingMessageSubmission = undefined;
-        this.#projectionEvents = [];
-        this.#data = this.#reducer.initial();
-        this.#error = undefined;
-        this.#status = "ready";
-        this.#callbacks.onSessionChange?.(this.#session.state);
-        this.#publish();
-    }
-    #createOwnedSession() {
-        if (!this.#createSession) {
-            throw new Error("Cannot create an owned Ash session from an external session.");
-        }
-        return this.#createSession();
-    }
-    #startOperation() {
-        this.#operationId += 1;
-        return this.#operationId;
-    }
-    #invalidateOperation() {
-        this.#operationId += 1;
-    }
-    #isCurrentOperation(operationId) {
-        return this.#operationId === operationId;
-    }
-    #projectOptimisticMessage(input) {
-        if (!this.#optimistic || input.message === undefined) {
-            return;
-        }
-        const id = createSubmissionId();
-        const pending = {
-            createdAt: Date.now(),
-            id,
-            message: summarizeUserContent(input.message),
-        };
-        this.#pendingMessageSubmission = pending;
-        this.#appendProjectionEvent({
-            data: {
-                createdAt: pending.createdAt,
-                message: pending.message,
-                submissionId: pending.id,
-            },
-            type: "client.message.submitted",
-        });
-    }
-    #projectInputResponses(input) {
-        if (input.inputResponses === undefined || input.inputResponses.length === 0) {
-            return;
-        }
-        this.#appendProjectionEvent({
-            data: {
-                createdAt: Date.now(),
-                responses: input.inputResponses,
-            },
-            type: "client.input.responded",
-        });
-    }
-    #applyServerEvent(event) {
-        if (event.type === "message.received" && this.#pendingMessageSubmission !== undefined) {
-            const submissionId = this.#pendingMessageSubmission.id;
-            this.#pendingMessageSubmission = undefined;
-            this.#replaceProjectionEvent((candidate) => candidate.type === "client.message.submitted" &&
-                candidate.data.submissionId === submissionId, event);
-            return;
-        }
-        this.#appendProjectionEvent(event);
-    }
-    #applyTerminalStreamFailure(event) {
-        const error = toTerminalStreamFailureError(event);
-        if (error === undefined) {
-            return;
-        }
-        this.#status = "error";
-        this.#failPendingMessageSubmission(error);
-        if (this.#error === undefined) {
-            this.#error = error;
-            this.#callbacks.onError?.(error);
-        }
-    }
-    #failPendingMessageSubmission(error) {
-        const pending = this.#pendingMessageSubmission;
-        if (pending === undefined) {
-            return;
-        }
-        this.#pendingMessageSubmission = undefined;
-        this.#replaceProjectionEvent((event) => event.type === "client.message.submitted" && event.data.submissionId === pending.id, {
-            data: {
-                createdAt: pending.createdAt,
-                error: {
-                    message: error.message,
-                },
-                message: pending.message,
-                submissionId: pending.id,
-            },
-            type: "client.message.failed",
-        });
-    }
-    #appendProjectionEvent(event) {
-        this.#projectionEvents = [...this.#projectionEvents, event];
-        this.#data = this.#reducer.reduce(this.#data, event);
-    }
-    #replaceProjectionEvent(predicate, replacement) {
-        let replaced = false;
-        this.#projectionEvents = this.#projectionEvents.map((event) => {
-            if (!replaced && predicate(event)) {
-                replaced = true;
-                return replacement;
-            }
-            return event;
-        });
-        if (!replaced) {
-            this.#projectionEvents = [...this.#projectionEvents, replacement];
-        }
-        this.#data = this.#reduceProjectionEvents(this.#projectionEvents);
-    }
-    #reduceProjectionEvents(events) {
-        let data = this.#reducer.initial();
-        for (const event of events) {
-            data = this.#reducer.reduce(data, event);
-        }
-        return data;
-    }
-    #createSnapshot() {
-        return {
-            data: this.#data,
-            error: this.#error,
-            events: this.#events,
-            session: this.#session.state,
-            status: this.#status,
-        };
-    }
-    #publish() {
-        this.#snapshot = this.#createSnapshot();
-        for (const subscriber of this.#subscribers) {
-            subscriber();
-        }
-    }
-}
-let submissionSequence = 0;
-function createSubmissionId() {
-    const randomUUID = globalThis.crypto?.randomUUID;
-    if (randomUUID !== undefined) {
-        return randomUUID.call(globalThis.crypto);
-    }
-    submissionSequence += 1;
-    return `submission_${submissionSequence.toString()}`;
-}
-function createAbortSignal(first, second) {
-    return first ? AbortSignal.any([first, second]) : second;
-}
-function summarizeUserContent(message) {
-    if (typeof message === "string") {
-        return message;
-    }
-    const parts = [];
-    for (const part of message) {
-        if (part.type === "text") {
-            parts.push(part.text);
-            continue;
-        }
-        if (part.type === "file") {
-            parts.push(part.filename ? `[file: ${part.filename}]` : "[file]");
-        }
-    }
-    return parts.join("\n");
-}
-function isAbortError(error) {
-    return error instanceof Error && error.name === "AbortError";
-}
-function toTerminalStreamFailureError(event) {
-    if (event.type !== "session.failed") {
-        return undefined;
-    }
-    const error = new Error(event.data.message);
-    error.name = event.data.code;
-    return error;
-}
+import{toError}from"#shared/errors.js";import{Client}from"#client/client.js";import{defaultMessageReducer}from"#client/message-reducer.js";import{useCallback,useMemo,useRef,useSyncExternalStore}from"react";function useAshAgent(e={}){let t=useRef(void 0);if(!t.current){let r=e.reducer??defaultMessageReducer();t.current=new UseAshAgentStore({auth:e.auth,headers:e.headers,host:e.host,initialEvents:e.initialEvents,initialSession:e.initialSession,maxReconnectAttempts:e.maxReconnectAttempts,optimistic:e.optimistic,reducer:r,session:e.session})}let s=t.current;s.setCallbacks({onError:e.onError,onEvent:e.onEvent,onFinish:e.onFinish,onSessionChange:e.onSessionChange,prepareSend:e.prepareSend});let c=useSyncExternalStore(useCallback(e=>s.subscribe(e),[s]),()=>s.snapshot,()=>s.snapshot),l=useCallback(()=>s.reset(),[s]),u=useCallback((e,t)=>s.send(e,t),[s]),d=useCallback((e,t)=>s.sendMessage(e,t),[s]),f=useCallback(()=>s.stop(),[s]);return useMemo(()=>({...c,reset:l,send:u,sendMessage:d,stop:f}),[l,u,d,c,f])}var UseAshAgentStore=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()}},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{useAshAgent};

package/dist/src/runtime/actions/keys.js

@@ -1,30 +1 @@
-/**
- * Returns the stable match key used to pair one pending runtime action request
- * with its resume result.
- */
-export function getRuntimeActionRequestKey(action) {
-    switch (action.kind) {
-        case "load-skill":
-            return `runtime-action:${action.kind}:${action.callId}`;
-        case "remote-agent-call":
-            return `subagent-call:${action.remoteAgentName}:${action.callId}`;
-        case "subagent-call":
-            return `subagent-call:${action.subagentName}:${action.callId}`;
-        case "tool-call":
-            return `tool-call:${action.toolName}:${action.callId}`;
-    }
-}
-/**
- * Returns the stable match key used to pair one runtime action result with its
- * originating request.
- */
-export function getRuntimeActionResultKey(result) {
-    switch (result.kind) {
-        case "load-skill-result":
-            return `runtime-action:load-skill:${result.callId}`;
-        case "subagent-result":
-            return `subagent-call:${result.subagentName}:${result.callId}`;
-        case "tool-result":
-            return `tool-call:${result.toolName}:${result.callId}`;
-    }
-}
+function getRuntimeActionRequestKey(e){switch(e.kind){case`load-skill`:return`runtime-action:${e.kind}:${e.callId}`;case`remote-agent-call`:return`subagent-call:${e.remoteAgentName}:${e.callId}`;case`subagent-call`:return`subagent-call:${e.subagentName}:${e.callId}`;case`tool-call`:return`tool-call:${e.toolName}:${e.callId}`}}function getRuntimeActionResultKey(e){switch(e.kind){case`load-skill-result`:return`runtime-action:load-skill:${e.callId}`;case`subagent-result`:return`subagent-call:${e.subagentName}:${e.callId}`;case`tool-result`:return`tool-call:${e.toolName}:${e.callId}`}}export{getRuntimeActionRequestKey,getRuntimeActionResultKey};