experimental-ash 0.22.2 → 0.23.0

package/dist/src/evals/cli/eval.js

@@ -1 +1 @@
-import{n as e}from"../../chunks/paths-C6sp4T2U.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-CKsU8Li3.js";import{n as a}from"../../chunks/host-DREC8e8Z.js";import{discoverAndImportSuites as o,discoverSuiteFiles as s,importSuiteFile as c}from"../runner/discover.js";import{executeSuite as l}from"../runner/execute-suite.js";import{ConsoleReporter as u}from"../runner/reporters/console.js";var d=n();function f(e,t){e.command(`eval`).description(`Run eval suites against an Ash agent.`).option(`--suite <id...>`,`Suite IDs to run (repeatable)`).option(`--all`,`Run all discovered suites`).option(`--url <url>`,`Remote agent URL (skip local host startup)`).option(`--timeout <ms>`,`Per-case timeout in milliseconds`).option(`--max-concurrency <n>`,`Max concurrent case executions per suite`).option(`--json`,`Output results as JSON`).option(`--list-suites`,`List discovered suites and exit`).option(`--skip-report`,`Skip suite-defined reporters (e.g. Braintrust)`).action(async e=>{await p(e,t)})}async function p(n,r){let i=e();if(t(i),n.listSuites){await y(i,r);return}let s=n.suite,c=await o(i,s);if(c.length===0){s&&s.length>0?r.error(`No suites found matching: ${s.join(`, `)}`):r.error(`No eval suites found. Create suite files under evals/ with the *.eval.ts extension.`),process.exitCode=1;return}let u,d;n.url?d={kind:`remote`,url:n.url}:(u=await a(i,{host:`127.0.0.1`,port:0}),d={kind:`local`,url:u.url});let f=m(d);try{let e=[];for(let t of c){let r=_(t,n),a=v(r,{json:n.json===!0,skipReport:n.skipReport===!0}),o=await l({suite:r,target:d,reporters:a,appRoot:i,client:f});e.push(o)}n.json&&r.log(JSON.stringify(e,null,2)),e.some(e=>e.errored>0)&&(process.exitCode=1)}finally{u&&await u.close()}process.exit(process.exitCode??0)}function m(e){if(e.kind===`local`)return new i({host:e.url});let t={},n=process.env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();return n&&(t[r]=n),new i({auth:h(),headers:Object.keys(t).length>0?t:void 0,host:e.url})}function h(){let e=process.env.ASH_EVAL_AUTH_TOKEN?.trim();return e?{bearer:e}:{bearer:g}}async function g(){try{let e=(await(0,d.getVercelOidcToken)()).trim();if(e.length>0)return e}catch{}return process.env.VERCEL_OIDC_TOKEN?.trim()??``}function _(e,t){let n=t.maxConcurrency?Number.parseInt(t.maxConcurrency,10):void 0,r=t.timeout?Number.parseInt(t.timeout,10):void 0;if(n===void 0&&r===void 0)return e;let i={...e};return n!==void 0&&(i.maxConcurrency=n),r!==void 0&&(i.timeoutMs=r),i}function v(e,t){let n=t.json?[]:[new u];return!t.skipReport&&e.reporters&&n.push(...e.reporters),n}async function y(e,t){let n=await s(e);if(n.length===0){t.log(`No eval suites found.`);return}t.log(`Found ${n.length} eval suite file(s):\n`);for(let r of n){let n=await c(e,r);t.log(`  ${n.id}${n.description?`  - ${n.description}`:``}`)}}export{f as registerEvalCommand,p as runEvalCommand};
+import{n as e}from"../../chunks/paths-YoCQlavu.js";import{loadDevelopmentEnvironmentFiles as t}from"../../cli/dev/environment.js";import{a as n,n as r,t as i}from"../../chunks/client-nshDsWNF.js";import{n as a}from"../../chunks/host-tji7W0Nn.js";import{discoverAndImportSuites as o,discoverSuiteFiles as s,importSuiteFile as c}from"../runner/discover.js";import{executeSuite as l}from"../runner/execute-suite.js";import{ConsoleReporter as u}from"../runner/reporters/console.js";var d=n();function f(e,t){e.command(`eval`).description(`Run eval suites against an Ash agent.`).option(`--suite <id...>`,`Suite IDs to run (repeatable)`).option(`--all`,`Run all discovered suites`).option(`--url <url>`,`Remote agent URL (skip local host startup)`).option(`--timeout <ms>`,`Per-case timeout in milliseconds`).option(`--max-concurrency <n>`,`Max concurrent case executions per suite`).option(`--json`,`Output results as JSON`).option(`--list-suites`,`List discovered suites and exit`).option(`--skip-report`,`Skip suite-defined reporters (e.g. Braintrust)`).action(async e=>{await p(e,t)})}async function p(n,r){let i=e();if(t(i),n.listSuites){await y(i,r);return}let s=n.suite,c=await o(i,s);if(c.length===0){s&&s.length>0?r.error(`No suites found matching: ${s.join(`, `)}`):r.error(`No eval suites found. Create suite files under evals/ with the *.eval.ts extension.`),process.exitCode=1;return}let u,d;n.url?d={kind:`remote`,url:n.url}:(u=await a(i,{host:`127.0.0.1`,port:0}),d={kind:`local`,url:u.url});let f=m(d);try{let e=[];for(let t of c){let r=_(t,n),a=v(r,{json:n.json===!0,skipReport:n.skipReport===!0}),o=await l({suite:r,target:d,reporters:a,appRoot:i,client:f});e.push(o)}n.json&&r.log(JSON.stringify(e,null,2)),e.some(e=>e.errored>0)&&(process.exitCode=1)}finally{u&&await u.close()}process.exit(process.exitCode??0)}function m(e){if(e.kind===`local`)return new i({host:e.url});let t={},n=process.env.VERCEL_AUTOMATION_BYPASS_SECRET?.trim();return n&&(t[r]=n),new i({auth:h(),headers:Object.keys(t).length>0?t:void 0,host:e.url})}function h(){let e=process.env.ASH_EVAL_AUTH_TOKEN?.trim();return e?{bearer:e}:{bearer:g}}async function g(){try{let e=(await(0,d.getVercelOidcToken)()).trim();if(e.length>0)return e}catch{}return process.env.VERCEL_OIDC_TOKEN?.trim()??``}function _(e,t){let n=t.maxConcurrency?Number.parseInt(t.maxConcurrency,10):void 0,r=t.timeout?Number.parseInt(t.timeout,10):void 0;if(n===void 0&&r===void 0)return e;let i={...e};return n!==void 0&&(i.maxConcurrency=n),r!==void 0&&(i.timeoutMs=r),i}function v(e,t){let n=t.json?[]:[new u];return!t.skipReport&&e.reporters&&n.push(...e.reporters),n}async function y(e,t){let n=await s(e);if(n.length===0){t.log(`No eval suites found.`);return}t.log(`Found ${n.length} eval suite file(s):\n`);for(let r of n){let n=await c(e,r);t.log(`  ${n.id}${n.description?`  - ${n.description}`:``}`)}}export{f as registerEvalCommand,p as runEvalCommand};

package/dist/src/internal/application/package.js

@@ -6,7 +6,7 @@ import { ASH_PACKAGE_NAME } from "#package-name.js";
 let cachedPackageInfo;
 // The package build stamps the published version into `dist` so bundled
 // deployments can still report package metadata without resolving package.json.
-const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.22.2";
+const BUNDLED_FALLBACK_PACKAGE_VERSION = "0.23.0";
 const BUNDLED_FALLBACK_PACKAGE_VERSION_PLACEHOLDER = "__ASH_PACKAGE_VERSION_PLACEHOLDER__";
 const WORKFLOW_MODULE_ALIASES = {
     "workflow/api": "src/compiled/@workflow/core/runtime.js",

package/dist/src/protocol/message.d.ts

@@ -76,20 +76,25 @@ export interface RuntimeIdentity {
  * `message` is either a plain text string or an AI SDK `UserContent`
  * array (mixing `text`, `image`, and `file` parts). Clients pass
  * multimodal attachments with the same shape AI SDK's `useChat`
- * `sendMessage({ files })` produces.
+ * `sendMessage({ files })` produces. `clientContext` is one-turn
+ * client/page context; the channel converts it into internal model context.
  */
 export type HandleMessageRequestBody = {
     readonly message: string | UserContent;
+    readonly clientContext?: string | readonly string[] | JsonObject;
 } | {
     readonly continuationToken: string;
     readonly message: string | UserContent;
+    readonly clientContext?: string | readonly string[] | JsonObject;
 } | {
     readonly continuationToken: string;
     readonly inputResponses: readonly InputResponse[];
+    readonly clientContext?: string | readonly string[] | JsonObject;
 } | {
     readonly continuationToken: string;
     readonly inputResponses: readonly InputResponse[];
     readonly message: string | UserContent;
+    readonly clientContext?: string | readonly string[] | JsonObject;
 };
 /**
  * JSON response returned when the message route accepts a start or resume

package/dist/src/public/channels/ash.js

@@ -1,8 +1,10 @@
+import {} from "ai";
 import { ASH_MESSAGE_STREAM_CONTENT_TYPE, ASH_MESSAGE_STREAM_FORMAT, ASH_MESSAGE_STREAM_VERSION, ASH_SESSION_ID_HEADER, ASH_STREAM_FORMAT_HEADER, ASH_STREAM_VERSION_HEADER, } from "#protocol/message.js";
 import { isInputResponse } from "#runtime/input/types.js";
 import { createUnauthorizedResponse } from "#public/channels/auth.js";
 import { collectUploadPolicyViolations, formatUploadPolicyViolation, mergeUploadPolicy, } from "#public/channels/upload-policy.js";
 import { defineChannel, POST, GET } from "#public/definitions/defineChannel.js";
+import { parseJsonObject } from "#shared/json.js";
 export function ashChannel(input) {
     const uploadPolicy = mergeUploadPolicy(input.uploadPolicy);
     return defineChannel({
@@ -29,7 +31,7 @@ export function ashChannel(input) {
                 if (policyRejection !== null)
                     return policyRejection;
                 const token = `ash:${crypto.randomUUID()}`;
-                const session = await send(body.message, {
+                const session = await send(createSendPayload(body), {
                     auth: sessionAuth,
                     continuationToken: token,
                 });
@@ -79,6 +81,7 @@ export function ashChannel(input) {
                 const session = await send({
                     inputResponses: body.inputResponses,
                     message: body.message,
+                    modelContext: body.modelContext,
                 }, {
                     auth: sessionAuth,
                     continuationToken: body.continuationToken,
@@ -137,10 +140,13 @@ function parseCreateBody(payload) {
     const message = parseMessageField(payload.message);
     if (message instanceof Response)
         return message;
+    const modelContext = parseClientContextField(payload.clientContext);
+    if (modelContext instanceof Response)
+        return modelContext;
     if (message === undefined) {
         return Response.json({ error: "Missing or empty 'message' field.", ok: false }, { status: 400 });
     }
-    return { message };
+    return { message, modelContext };
 }
 function parseContinueBody(payload) {
     const continuationToken = typeof payload.continuationToken === "string" && payload.continuationToken.length > 0
@@ -155,13 +161,22 @@ function parseContinueBody(payload) {
     const inputResponses = parseInputResponses(payload.inputResponses);
     if (inputResponses instanceof Response)
         return inputResponses;
+    const modelContext = parseClientContextField(payload.clientContext);
+    if (modelContext instanceof Response)
+        return modelContext;
     if (message === undefined && inputResponses === undefined) {
         return Response.json({
             error: "Expected a non-empty 'message', a non-empty 'inputResponses' array, or both.",
             ok: false,
         }, { status: 400 });
     }
-    return { message, continuationToken, inputResponses };
+    return { message, continuationToken, inputResponses, modelContext };
+}
+function createSendPayload(body) {
+    if (body.modelContext === undefined) {
+        return body.message;
+    }
+    return { message: body.message, modelContext: body.modelContext };
 }
 function parseMessageField(value) {
     if (value === undefined)
@@ -255,6 +270,38 @@ function parseInputResponses(value) {
     }
     return inputResponses;
 }
+const CLIENT_CONTEXT_PREFIX = "Ephemeral client context:\n";
+function parseClientContextField(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === "string") {
+        return value.length > 0 ? [toClientContextMessage(value)] : undefined;
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return undefined;
+        if (!value.every((entry) => typeof entry === "string" && entry.length > 0)) {
+            return Response.json({ error: "Expected 'clientContext' array entries to be non-empty strings.", ok: false }, { status: 400 });
+        }
+        return value.map((entry) => toClientContextMessage(entry));
+    }
+    if (value === null || typeof value !== "object") {
+        return Response.json({
+            error: "Expected 'clientContext' to be a string, string array, or JSON object.",
+            ok: false,
+        }, { status: 400 });
+    }
+    try {
+        const json = parseJsonObject(value);
+        return [toClientContextMessage(JSON.stringify(json))];
+    }
+    catch {
+        return Response.json({ error: "Expected 'clientContext' to be a JSON-serializable object.", ok: false }, { status: 400 });
+    }
+}
+function toClientContextMessage(content) {
+    return { role: "user", content: `${CLIENT_CONTEXT_PREFIX}${content}` };
+}
 function parseStartIndex(request) {
     const raw = new URL(request.url).searchParams.get("startIndex");
     if (raw === null)

package/dist/src/public/context/index.d.ts

@@ -2,15 +2,12 @@
  * Runtime context helpers for authored code.
  *
  * These APIs work only inside active authored runtime execution such as
- * tools and other Ash-invoked callbacks. They read from a single
- * `AshContext` container bound via `AsyncLocalStorage`.
+ * tools and other Ash-invoked callbacks.
  *
  * @example
  * ```ts
- * import { ContextKey, getContext, setContext } from "experimental-ash/context";
+ * import { defineState, getSession } from "experimental-ash/context";
  * ```
  */
-export { ensureContext, getContext, getSession, hasContext, requireContext, type Session, type SessionAuth, type SessionAuthContext, type SessionParent, type SessionTurn, setContext, } from "#context/accessors.js";
-export type { AshContext } from "#context/container.js";
-export { type ContextAccessor, ContextKey, type ContextKeyOptions } from "#context/key.js";
-export type { ContextProvider, ContextReader } from "#context/provider.js";
+export { getSession, type Session, type SessionAuth, type SessionAuthContext, type SessionParent, type SessionTurn, } from "#context/accessors.js";
+export { defineState, type StateHandle } from "#public/definitions/state.js";

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

@@ -2,13 +2,12 @@
  * Runtime context helpers for authored code.
  *
  * These APIs work only inside active authored runtime execution such as
- * tools and other Ash-invoked callbacks. They read from a single
- * `AshContext` container bound via `AsyncLocalStorage`.
+ * tools and other Ash-invoked callbacks.
  *
  * @example
  * ```ts
- * import { ContextKey, getContext, setContext } from "experimental-ash/context";
+ * import { defineState, getSession } from "experimental-ash/context";
  * ```
  */
-export { ensureContext, getContext, getSession, hasContext, requireContext, setContext, } from "#context/accessors.js";
-export { ContextKey } from "#context/key.js";
+export { getSession, } from "#context/accessors.js";
+export { defineState } from "#public/definitions/state.js";

package/dist/src/public/definitions/state.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Typed handle returned by {@link defineState}. Provides read and
+ * update operations over a named context slot.
+ *
+ * All operations require an active Ash context (ALS scope) and throw
+ * when called outside one.
+ */
+export interface StateHandle<T> {
+    /** Read the current value. Returns `initial()` on first access within a context. */
+    get(): T;
+    /** Update the value with a function that receives the current value. */
+    update(fn: (current: T) => T): void;
+}
+/**
+ * Creates a typed, named state slot backed by a durable `ContextKey`.
+ *
+ * All operations require an active Ash context — calling `get()` or
+ * `update()` outside of tools, hooks, or other framework-managed
+ * code throws.
+ *
+ * State is durable: values survive across workflow step boundaries.
+ * To reset per-turn, use `update(() => freshValue)` in a lifecycle
+ * hook.
+ *
+ * ```ts
+ * const budget = defineState("my-agent.budget", () => ({ count: 0, cap: 25 }));
+ *
+ * // In a tool or hook:
+ * budget.update((s) => ({ ...s, count: s.count + 1 }));
+ * const current = budget.get();
+ * ```
+ */
+export declare function defineState<T>(name: string, initial: () => T): StateHandle<T>;

package/dist/src/public/definitions/state.js

@@ -0,0 +1,34 @@
+import { ContextKey } from "#context/key.js";
+import { loadContext } from "#context/container.js";
+/**
+ * Creates a typed, named state slot backed by a durable `ContextKey`.
+ *
+ * All operations require an active Ash context — calling `get()` or
+ * `update()` outside of tools, hooks, or other framework-managed
+ * code throws.
+ *
+ * State is durable: values survive across workflow step boundaries.
+ * To reset per-turn, use `update(() => freshValue)` in a lifecycle
+ * hook.
+ *
+ * ```ts
+ * const budget = defineState("my-agent.budget", () => ({ count: 0, cap: 25 }));
+ *
+ * // In a tool or hook:
+ * budget.update((s) => ({ ...s, count: s.count + 1 }));
+ * const current = budget.get();
+ * ```
+ */
+export function defineState(name, initial) {
+    const key = new ContextKey(name);
+    return {
+        get() {
+            return loadContext().ensure(key, initial);
+        },
+        update(fn) {
+            const ctx = loadContext();
+            const current = ctx.ensure(key, initial);
+            ctx.set(key, fn(current));
+        },
+    };
+}

package/dist/src/public/next/index.d.ts

@@ -45,6 +45,13 @@ export interface WithAshOptions {
      * absolute. Defaults to the Next.js app root.
      */
     readonly ashRoot?: string;
+    /**
+     * Build command for the generated Ash Vercel service. Defaults to `ash build`.
+     *
+     * Use this when the Ash service needs project-specific prework before the
+     * framework build, without changing the Next.js service build command.
+     */
+    readonly ashBuildCommand?: string;
     /**
      * Set to `false` to skip creating or updating `vercel.json`.
      *

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

@@ -9,6 +9,7 @@ import { ensureAshVercelJson } from "./vercel-json.js";
 export const ASH_NEXT_SERVICE_PREFIX = "/_ash_internal/ash";
 const ASH_NEXT_PRODUCTION_ORIGIN_ENV = "ASH_NEXT_PRODUCTION_ORIGIN";
 const ASH_NEXT_PRODUCTION_PORT_ENV = "ASH_NEXT_PRODUCTION_PORT";
+const DEFAULT_ASH_BUILD_COMMAND = "ash build";
 const DEFAULT_ASH_NEXT_PRODUCTION_PORT = 4274;
 const ASH_PROXY_REWRITE_SOURCES = [`${ASH_ROUTE_PREFIX}/:path+`];
 function resolveApplicationRoot(appPath) {
@@ -129,6 +130,7 @@ export function withAsh(configOrFunction, options = {}) {
         const configuredVercel = shouldConfigureVercelJson
             ? await ensureAshVercelJson({
                 appRoot,
+                ashBuildCommand: options.ashBuildCommand ?? DEFAULT_ASH_BUILD_COMMAND,
                 nextRoot,
                 servicePrefix: servicePrefixInput,
             })

package/dist/src/public/next/vercel-json.d.ts

@@ -3,6 +3,7 @@ export interface EnsureVercelJsonResult {
 }
 export declare function ensureAshVercelJson(input: {
     readonly appRoot: string;
+    readonly ashBuildCommand: string;
     readonly nextRoot: string;
     readonly servicePrefix: string;
 }): Promise<EnsureVercelJsonResult>;

package/dist/src/public/next/vercel-json.js

@@ -57,6 +57,7 @@ export async function ensureAshVercelJson(input) {
     }
     if (configuredAshService === undefined) {
         experimentalServices.ash = {
+            buildCommand: input.ashBuildCommand,
             entrypoint: ashEntrypoint,
             framework: "ash",
             routePrefix: servicePrefix,

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

@@ -1,3 +1,3 @@
-export { useAshAgent, type UseAshAgentHelpers, type UseAshAgentOptions, type UseAshAgentSnapshot, type UseAshAgentStatus, } from "#react/use-ash-agent.js";
+export { useAshAgent, type PrepareSend, type UseAshAgentHelpers, type UseAshAgentOptions, type UseAshAgentSnapshot, type UseAshAgentStatus, } from "#react/use-ash-agent.js";
 export { type AshAgentReducer, type AshAgentReducerEvent, type ClientInputRespondedEvent, type ClientMessageFailedEvent, type ClientMessageSubmittedEvent, } from "#client/reducer.js";
 export { defaultMessageReducer, type AshMessageData, type AshDynamicToolPart, type AshMessageInputRequest, type AshMessage, type AshMessageMetadata, type AshMessagePart, type AshMessageToolMetadata, } from "#client/message-reducer.js";

package/dist/src/react/use-ash-agent.d.ts

@@ -4,6 +4,13 @@ import { type AshMessageData } from "#client/message-reducer.js";
 import type { HandleMessageStreamEvent } from "#protocol/message.js";
 import type { ClientAuth, HeadersValue, SendMessageOptions, SendTurnInput, SessionState } from "#client/types.js";
 export type UseAshAgentStatus = "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.
  */
@@ -22,6 +29,7 @@ export interface UseAshAgentCallbacks<TData> {
     readonly onEvent?: (event: HandleMessageStreamEvent) => void;
     readonly onFinish?: (snapshot: UseAshAgentSnapshot<TData>) => void;
     readonly onSessionChange?: (session: SessionState) => void;
+    readonly prepareSend?: PrepareSend;
 }
 /**
  * Snapshot plus commands returned by `useAshAgent`.

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

@@ -26,6 +26,7 @@ export function useAshAgent(options = {}) {
         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);
@@ -102,11 +103,16 @@ class UseAshAgentStore {
         this.#abortController = abortController;
         this.#error = undefined;
         this.#status = "submitted";
-        this.#projectOptimisticMessage(input);
-        this.#projectInputResponses(input);
         this.#publish();
         try {
-            const response = await this.#session.send(input, {
+            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),
             });
@@ -195,7 +201,7 @@ class UseAshAgentStore {
         const pending = {
             createdAt: Date.now(),
             id,
-            message: input.message,
+            message: summarizeUserContent(input.message),
         };
         this.#pendingMessageSubmission = pending;
         this.#appendProjectionEvent({
@@ -312,6 +318,22 @@ function createSubmissionId() {
 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";
 }

package/dist/src/services/dev-client.d.ts

@@ -1,6 +1,8 @@
+import type { UserContent } from "ai";
 import { type SessionState } from "#client/index.js";
 import type { HandleMessageStreamEvent } from "#protocol/message.js";
 import type { InputResponse } from "#runtime/input/types.js";
+import type { JsonObject } from "#shared/json.js";
 export type { DevelopmentRequestHeaders } from "#services/dev-client/request-headers.js";
 export { extractCompletedMessage } from "#services/dev-client/stream.js";
 /**
@@ -41,8 +43,9 @@ export interface DevelopmentMessageClient {
      * Sends one turn payload through the active development session.
      */
     send(input: {
+        readonly clientContext?: string | readonly string[] | JsonObject;
         readonly inputResponses?: readonly InputResponse[];
-        readonly message?: string;
+        readonly message?: string | UserContent;
         onEvent?(event: HandleMessageStreamEvent): void;
         onResponseStart?(response: {
             sessionId?: string;

package/dist/src/services/dev-client.js

@@ -109,6 +109,7 @@ class BufferedDevelopmentMessageClient {
     }
     async send(input) {
         const res = await this.#session.send({
+            clientContext: input.clientContext,
             inputResponses: input.inputResponses,
             message: input.message,
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "experimental-ash",
-  "version": "0.22.2",
+  "version": "0.23.0",
   "bin": {
     "ash": "./bin/ash.js",
     "experimental-ash": "./bin/ash.js"