experimental-ash 0.1.0-alpha.1

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

@@ -0,0 +1,260 @@
+import { ASH_RUN_ID_HEADER, createMessageRunStreamPath, isCurrentTurnBoundaryEvent, } from "../../protocol/message.js";
+import { ASH_MESSAGE_ROUTE_PATH } from "../../protocol/routes.js";
+import { openDevelopmentMessageStream } from "./live-stream.js";
+import { createDevelopmentRequestHeaders } from "./request-headers.js";
+import { createDevelopmentMessageRequest, createDevelopmentSessionState, shouldTailAttachDevelopmentSession, updateDevelopmentSessionState, } from "./session.js";
+import { extractCurrentTurnBoundaryEvent } from "./stream.js";
+import { resolveDevelopmentServerResourceUrl, resolveDevelopmentServerRouteUrl } from "./url.js";
+const DEVELOPMENT_SEEDED_RUN_IDLE_TIMEOUT_MS = 250;
+const DEVELOPMENT_TURN_STREAM_RECONNECT_LIMIT = 3;
+async function fetchDevelopmentRunStreamResponse(input) {
+    const canonicalResourceUrl = resolveDevelopmentServerResourceUrl({
+        resource: createMessageRunStreamPath(input.runId),
+        serverUrl: input.serverUrl,
+    });
+    const requestResourceUrl = new URL(canonicalResourceUrl);
+    if (input.startIndex !== undefined) {
+        requestResourceUrl.searchParams.set("startIndex", String(input.startIndex));
+    }
+    const streamResponse = await fetch(requestResourceUrl, {
+        headers: createDevelopmentRequestHeaders({
+            resourceUrl: requestResourceUrl,
+        }),
+        signal: input.signal ?? null,
+    });
+    if (!streamResponse.ok) {
+        const body = await streamResponse.text();
+        throw new Error(body || `Run stream route returned ${streamResponse.status}.`);
+    }
+    return {
+        resourceUrl: canonicalResourceUrl.toString(),
+        response: streamResponse,
+    };
+}
+async function openDevelopmentRunStream(input) {
+    const streamResponse = await fetchDevelopmentRunStreamResponse(input);
+    return openDevelopmentMessageStream({
+        boundaryCount: input.boundaryCount,
+        resourceUrl: streamResponse.resourceUrl,
+        response: streamResponse.response,
+    });
+}
+function isDevelopmentStreamAbortError(error) {
+    if (error instanceof DOMException) {
+        return error.name === "AbortError";
+    }
+    return error instanceof Error && error.name === "AbortError";
+}
+async function resolveDevelopmentSeededSession(input) {
+    if (!input.session.runId || !shouldTailAttachDevelopmentSession(input.session)) {
+        return input.session;
+    }
+    const controller = new AbortController();
+    const streamResponse = await fetchDevelopmentRunStreamResponse({
+        runId: input.session.runId,
+        serverUrl: input.serverUrl,
+        signal: controller.signal,
+    });
+    const reader = streamResponse.response.body?.getReader();
+    if (!reader) {
+        return createDevelopmentSessionState({
+            boundaryCount: 0,
+            runId: input.session.runId,
+            streamIndex: 0,
+        });
+    }
+    const decoder = new TextDecoder();
+    let boundaryCount = 0;
+    let idleTimedOut = false;
+    let streamIndex = 0;
+    let buffer = "";
+    const handleBufferedLines = () => {
+        while (true) {
+            const newlineIndex = buffer.indexOf("\n");
+            if (newlineIndex === -1) {
+                return;
+            }
+            const line = buffer.slice(0, newlineIndex).trim();
+            buffer = buffer.slice(newlineIndex + 1);
+            if (line.length === 0) {
+                continue;
+            }
+            const event = JSON.parse(line);
+            streamIndex += 1;
+            if (isCurrentTurnBoundaryEvent(event)) {
+                boundaryCount += 1;
+            }
+        }
+    };
+    try {
+        while (true) {
+            let timeoutHandle;
+            const readPromise = reader.read();
+            const result = await Promise.race([
+                readPromise,
+                new Promise((resolve) => {
+                    timeoutHandle = setTimeout(() => {
+                        idleTimedOut = true;
+                        void reader.cancel().catch(() => undefined);
+                        controller.abort();
+                        resolve("idle");
+                    }, DEVELOPMENT_SEEDED_RUN_IDLE_TIMEOUT_MS);
+                }),
+            ]);
+            if (timeoutHandle) {
+                clearTimeout(timeoutHandle);
+            }
+            if (result === "idle") {
+                await readPromise.catch(() => undefined);
+                break;
+            }
+            if (result.done) {
+                buffer += decoder.decode();
+                break;
+            }
+            buffer += decoder.decode(result.value, {
+                stream: true,
+            });
+            handleBufferedLines();
+        }
+    }
+    catch (error) {
+        if (!(idleTimedOut && isDevelopmentStreamAbortError(error))) {
+            throw error;
+        }
+    }
+    finally {
+        controller.abort();
+        try {
+            await reader.cancel();
+        }
+        catch {
+            // The probe intentionally aborts after the stream goes idle.
+        }
+        reader.releaseLock();
+    }
+    const trailingLine = buffer.trim();
+    if (trailingLine.length > 0) {
+        const event = JSON.parse(trailingLine);
+        streamIndex += 1;
+        if (isCurrentTurnBoundaryEvent(event)) {
+            boundaryCount += 1;
+        }
+    }
+    return createDevelopmentSessionState({
+        boundaryCount,
+        runId: input.session.runId,
+        streamIndex,
+    });
+}
+async function readDevelopmentTurnEvents(input) {
+    let currentStream = input.stream;
+    const events = [];
+    let currentStreamIndex = input.initialStartIndex;
+    let remainingReconnectAttempts = DEVELOPMENT_TURN_STREAM_RECONNECT_LIMIT;
+    while (true) {
+        const nextEvents = await currentStream.readEvents({
+            onEvent: input.onEvent,
+        });
+        events.push(...nextEvents);
+        currentStreamIndex += nextEvents.length;
+        if (extractCurrentTurnBoundaryEvent(nextEvents)) {
+            return {
+                events,
+                stream: currentStream,
+            };
+        }
+        if (!currentStream.closed || remainingReconnectAttempts === 0) {
+            return {
+                events,
+                stream: currentStream,
+            };
+        }
+        remainingReconnectAttempts -= 1;
+        await currentStream.close();
+        currentStream = await openDevelopmentRunStream({
+            runId: input.runId,
+            serverUrl: input.serverUrl,
+            startIndex: currentStreamIndex,
+        });
+    }
+}
+/**
+ * Sends one message to the configured Ash server and collects its streamed
+ * events.
+ */
+export async function sendDevelopmentMessage(input) {
+    const messageRouteUrl = resolveDevelopmentServerRouteUrl({
+        routePath: ASH_MESSAGE_ROUTE_PATH,
+        serverUrl: input.serverUrl,
+    });
+    let session = input.session;
+    let stream;
+    try {
+        if (session.runId) {
+            session = await resolveDevelopmentSeededSession({
+                serverUrl: input.serverUrl,
+                session,
+            });
+        }
+        const response = await fetch(messageRouteUrl, {
+            body: JSON.stringify(createDevelopmentMessageRequest({
+                message: input.message,
+                session,
+            })),
+            headers: createDevelopmentRequestHeaders({
+                headers: {
+                    "content-type": "application/json",
+                },
+                resourceUrl: messageRouteUrl,
+            }),
+            method: "POST",
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(body || `Message route returned ${response.status}.`);
+        }
+        const payload = (await response.json());
+        const runId = payload.runId ?? response.headers.get(ASH_RUN_ID_HEADER)?.trim() ?? undefined;
+        if (!runId) {
+            throw new Error("Message route did not return a workflow run id.");
+        }
+        input.onResponseStart?.({
+            runId,
+        });
+        stream = await openDevelopmentRunStream({
+            runId,
+            serverUrl: input.serverUrl,
+            startIndex: session.runId === runId ? session.streamIndex : undefined,
+        });
+        const readResult = await readDevelopmentTurnEvents({
+            initialStartIndex: session.runId === runId ? session.streamIndex : 0,
+            onEvent: input.onEvent,
+            runId,
+            serverUrl: input.serverUrl,
+            stream,
+        });
+        const events = readResult.events;
+        stream = readResult.stream;
+        if (!extractCurrentTurnBoundaryEvent(events)) {
+            await stream.close();
+            throw new Error("Development message stream closed before the current turn reached a boundary.");
+        }
+        const nextSession = updateDevelopmentSessionState({
+            events,
+            runId,
+            session,
+        });
+        await stream.close();
+        return {
+            events,
+            runId,
+            session: nextSession,
+        };
+    }
+    catch (error) {
+        await stream?.close().catch(() => undefined);
+        throw error;
+    }
+}
+//# sourceMappingURL=send-message.js.map

package/dist/src/services/dev-client/send-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-message.js","sourceRoot":"","sources":["../../../../src/services/dev-client/send-message.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,54 @@
+import { type HandleMessageRequestBody, type HandleMessageStreamEvent } from "../../protocol/message.js";
+/**
+ * Durable-session cursor owned by the development client.
+ */
+export interface DevelopmentSessionState {
+    /**
+     * Number of turn-boundary events already consumed from the run stream.
+     */
+    readonly boundaryCount: number;
+    /**
+     * Number of streamed workflow chunks already consumed from the run stream.
+     */
+    readonly streamIndex: number;
+    /**
+     * Active run id when the workflow is parked for the next user message.
+     */
+    readonly runId?: string;
+}
+/**
+ * Returns the session state used before any message is sent or when the
+ * client resumes a known waiting run.
+ */
+export declare function createDevelopmentSessionState(input?: {
+    readonly boundaryCount?: number;
+    readonly runId?: string;
+    readonly streamIndex?: number;
+}): DevelopmentSessionState;
+/**
+ * Returns true when a fresh client session was seeded from an existing run id
+ * and must attach to the stream tail before sending the next message.
+ */
+export declare function shouldTailAttachDevelopmentSession(session: DevelopmentSessionState): boolean;
+/**
+ * Disposes any resources still attached to the durable session cursor.
+ */
+export declare function disposeDevelopmentSession(_: DevelopmentSessionState): Promise<void>;
+/**
+ * Creates the next canonical message-route request for the current session
+ * state.
+ */
+export declare function createDevelopmentMessageRequest(input: {
+    readonly message: string;
+    readonly session: DevelopmentSessionState;
+}): HandleMessageRequestBody;
+/**
+ * Advances the durable session cursor after one streamed turn boundary is
+ * observed.
+ */
+export declare function updateDevelopmentSessionState(input: {
+    readonly events: readonly HandleMessageStreamEvent[];
+    readonly runId: string;
+    readonly session: DevelopmentSessionState;
+}): DevelopmentSessionState;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/services/dev-client/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAE9B,MAAM,2BAA2B,CAAC;AASnC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,GAAE;IACL,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC1B,GACL,uBAAuB,CAoBzB;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAE5F;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;CAC3C,GAAG,wBAAwB,CAY3B;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;CAC3C,GAAG,uBAAuB,CAc1B"}

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

@@ -0,0 +1,71 @@
+import { MessageSessionAction, } from "../../protocol/message.js";
+import { countCurrentTurnBoundaryEvents, extractCurrentTurnBoundaryEvent } from "./stream.js";
+const DEVELOPMENT_TAIL_ATTACH = Symbol("ash.developmentTailAttach");
+/**
+ * Returns the session state used before any message is sent or when the
+ * client resumes a known waiting run.
+ */
+export function createDevelopmentSessionState(input = {}) {
+    const session = {
+        boundaryCount: input.boundaryCount ?? 0,
+        runId: input.runId,
+        streamIndex: input.streamIndex ?? 0,
+    };
+    if (input.runId !== undefined &&
+        (input.boundaryCount === undefined || input.streamIndex === undefined)) {
+        Object.defineProperty(session, DEVELOPMENT_TAIL_ATTACH, {
+            configurable: true,
+            enumerable: false,
+            value: true,
+            writable: false,
+        });
+    }
+    return session;
+}
+/**
+ * Returns true when a fresh client session was seeded from an existing run id
+ * and must attach to the stream tail before sending the next message.
+ */
+export function shouldTailAttachDevelopmentSession(session) {
+    return session[DEVELOPMENT_TAIL_ATTACH] === true;
+}
+/**
+ * Disposes any resources still attached to the durable session cursor.
+ */
+export async function disposeDevelopmentSession(_) {
+    return undefined;
+}
+/**
+ * Creates the next canonical message-route request for the current session
+ * state.
+ */
+export function createDevelopmentMessageRequest(input) {
+    if (!input.session.runId) {
+        return {
+            message: input.message,
+        };
+    }
+    return {
+        action: MessageSessionAction.NextMessage,
+        message: input.message,
+        runId: input.session.runId,
+    };
+}
+/**
+ * Advances the durable session cursor after one streamed turn boundary is
+ * observed.
+ */
+export function updateDevelopmentSessionState(input) {
+    const boundaryEvent = extractCurrentTurnBoundaryEvent(input.events);
+    const boundaryCount = input.session.boundaryCount + countCurrentTurnBoundaryEvents(input.events);
+    const streamIndex = input.session.streamIndex + input.events.length;
+    if (boundaryEvent?.type === "session.waiting") {
+        return createDevelopmentSessionState({
+            boundaryCount,
+            runId: input.runId,
+            streamIndex,
+        });
+    }
+    return createDevelopmentSessionState();
+}
+//# sourceMappingURL=session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../src/services/dev-client/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAE9F,MAAM,uBAAuB,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAwBpE;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAII,EAAE;IAEN,MAAM,OAAO,GAAoC;QAC/C,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;QACvC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC;KACpC,CAAC;IAEF,IACE,KAAK,CAAC,KAAK,KAAK,SAAS;QACzB,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,EACtE,CAAC;QACD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,uBAAuB,EAAE;YACtD,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAAC,OAAgC;IACjF,OAAQ,OAA2C,CAAC,uBAAuB,CAAC,KAAK,IAAI,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,CAA0B;IACxE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAAC,KAG/C;IACC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,oBAAoB,CAAC,WAAW;QACxC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK;KAC3B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAI7C;IACC,MAAM,aAAa,GAAG,+BAA+B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,GAAG,8BAA8B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjG,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAEpE,IAAI,aAAa,EAAE,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC9C,OAAO,6BAA6B,CAAC;YACnC,aAAa;YACb,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW;SACZ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,6BAA6B,EAAE,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { HandleMessageStreamEvent } from "../../protocol/message.js";
+/**
+ * Reads newline-delimited message workflow events from the current response
+ * body.
+ */
+export declare function readMessageStreamEvents(input: {
+    onEvent?(event: HandleMessageStreamEvent): void;
+    response: Response;
+    startAfterBoundaryCount?: number;
+    stopWhen?(event: HandleMessageStreamEvent): boolean;
+}): Promise<HandleMessageStreamEvent[]>;
+/**
+ * Extracts the final completed message text from a streamed message workflow
+ * result.
+ */
+export declare function extractCompletedMessage(events: HandleMessageStreamEvent[]): string | undefined;
+/**
+ * Counts boundary events in one stream slice.
+ */
+export declare function countCurrentTurnBoundaryEvents(events: readonly HandleMessageStreamEvent[]): number;
+/**
+ * Returns the last boundary event observed for the current streamed turn slice.
+ */
+export declare function extractCurrentTurnBoundaryEvent(events: readonly HandleMessageStreamEvent[]): HandleMessageStreamEvent | undefined;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../../src/services/dev-client/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,2BAA2B,CAAC;AAUnC;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,OAAO,CAAC,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAChD,QAAQ,EAAE,QAAQ,CAAC;IACnB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC;CACrD,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAWtC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,GAAG,SAAS,CAI9F;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,wBAAwB,EAAE,GAC1C,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,SAAS,wBAAwB,EAAE,GAC1C,wBAAwB,GAAG,SAAS,CAEtC"}

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

@@ -0,0 +1,42 @@
+import { isCurrentTurnBoundaryEvent } from "../../protocol/message.js";
+import { openDevelopmentMessageStream } from "./live-stream.js";
+function isMessageCompletedEvent(event) {
+    return event.type === "message.completed";
+}
+/**
+ * Reads newline-delimited message workflow events from the current response
+ * body.
+ */
+export async function readMessageStreamEvents(input) {
+    const stream = openDevelopmentMessageStream({
+        resourceUrl: "",
+        response: input.response,
+    });
+    try {
+        return await stream.readEvents(input);
+    }
+    finally {
+        await stream.close();
+    }
+}
+/**
+ * Extracts the final completed message text from a streamed message workflow
+ * result.
+ */
+export function extractCompletedMessage(events) {
+    const completedEvent = [...events].reverse().find(isMessageCompletedEvent);
+    return completedEvent?.data.message ?? undefined;
+}
+/**
+ * Counts boundary events in one stream slice.
+ */
+export function countCurrentTurnBoundaryEvents(events) {
+    return events.filter(isCurrentTurnBoundaryEvent).length;
+}
+/**
+ * Returns the last boundary event observed for the current streamed turn slice.
+ */
+export function extractCurrentTurnBoundaryEvent(events) {
+    return [...events].reverse().find(isCurrentTurnBoundaryEvent);
+}
+//# sourceMappingURL=stream.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../../src/services/dev-client/stream.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAEhE,SAAS,uBAAuB,CAC9B,KAA+B;IAE/B,OAAO,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAK7C;IACC,MAAM,MAAM,GAAG,4BAA4B,CAAC;QAC1C,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAkC;IACxE,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAE3E,OAAO,cAAc,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAA2C;IAE3C,OAAO,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,MAAM,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,MAA2C;IAE3C,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Resolves one Ash route against the configured development server URL.
+ */
+export declare function resolveDevelopmentServerRouteUrl(input: {
+    routePath: string;
+    serverUrl: string;
+}): URL;
+/**
+ * Resolves one server-provided resource reference against the configured
+ * development server URL.
+ */
+export declare function resolveDevelopmentServerResourceUrl(input: {
+    resource: string;
+    serverUrl: string;
+}): URL;
+//# sourceMappingURL=url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../../src/services/dev-client/url.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,GAAG,CAKN;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,GAAG,CAWN"}

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

@@ -0,0 +1,32 @@
+function createDevelopmentServerBaseUrl(serverUrl) {
+    const url = new URL(serverUrl);
+    url.hash = "";
+    url.search = "";
+    if (!url.pathname.endsWith("/")) {
+        url.pathname = `${url.pathname}/`;
+    }
+    return url;
+}
+/**
+ * Resolves one Ash route against the configured development server URL.
+ */
+export function resolveDevelopmentServerRouteUrl(input) {
+    return new URL(input.routePath.replace(/^\/+/, ""), createDevelopmentServerBaseUrl(input.serverUrl));
+}
+/**
+ * Resolves one server-provided resource reference against the configured
+ * development server URL.
+ */
+export function resolveDevelopmentServerResourceUrl(input) {
+    const resource = input.resource.trim();
+    try {
+        return new URL(resource);
+    }
+    catch {
+        return resolveDevelopmentServerRouteUrl({
+            routePath: resource,
+            serverUrl: input.serverUrl,
+        });
+    }
+}
+//# sourceMappingURL=url.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../../src/services/dev-client/url.ts"],"names":[],"mappings":"AAAA,SAAS,8BAA8B,CAAC,SAAiB;IACvD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAE/B,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACd,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,QAAQ,GAAG,GAAG,GAAG,CAAC,QAAQ,GAAG,CAAC;IACpC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAAC,KAGhD;IACC,OAAO,IAAI,GAAG,CACZ,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EACnC,8BAA8B,CAAC,KAAK,CAAC,SAAS,CAAC,CAChD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mCAAmC,CAAC,KAGnD;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEvC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gCAAgC,CAAC;YACtC,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,49 @@
+import type { HandleMessageStreamEvent } from "../protocol/message.js";
+import { type DevelopmentSessionState } from "./dev-client/session.js";
+export { sendDevelopmentMessage } from "./dev-client/send-message.js";
+export { createDevelopmentSessionState, type DevelopmentSessionState, disposeDevelopmentSession, } from "./dev-client/session.js";
+export { extractCompletedMessage } from "./dev-client/stream.js";
+/**
+ * Result returned after one development-client message exchange.
+ */
+export interface DevelopmentClientSendResult {
+    readonly completedMessage?: string;
+    readonly events: HandleMessageStreamEvent[];
+    readonly runId?: string;
+    readonly session: DevelopmentSessionState;
+}
+/**
+ * Stable service-style client for the Ash development message protocol.
+ */
+export interface DevelopmentMessageClient {
+    /**
+     * Clears the current durable run cursor.
+     */
+    clear(): Promise<void>;
+    /**
+     * Closes the client and disposes any session-attached resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Returns the current durable session cursor.
+     */
+    getSession(): DevelopmentSessionState;
+    /**
+     * Sends one user message through the active development session.
+     */
+    sendMessage(input: {
+        readonly message: string;
+        onEvent?(event: HandleMessageStreamEvent): void;
+        onResponseStart?(response: {
+            runId?: string;
+        }): void;
+    }): Promise<DevelopmentClientSendResult>;
+}
+/**
+ * Creates a stateful development client bound to one Ash server URL.
+ */
+export declare function createDevClient(input: {
+    initialRunId?: string;
+    serverUrl: string;
+}): DevelopmentMessageClient;
+//# sourceMappingURL=dev-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-client.d.ts","sourceRoot":"","sources":["../../../src/services/dev-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAEL,KAAK,uBAAuB,EAE7B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EACL,6BAA6B,EAC7B,KAAK,uBAAuB,EAC5B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,UAAU,IAAI,uBAAuB,CAAC;IAEtC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE;QACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAAC;QAChD,eAAe,CAAC,CAAC,QAAQ,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;KACtD,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC1C;AAqDD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,wBAAwB,CAE3B"}

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

@@ -0,0 +1,52 @@
+import { sendDevelopmentMessage } from "./dev-client/send-message.js";
+import { createDevelopmentSessionState, disposeDevelopmentSession, } from "./dev-client/session.js";
+import { extractCompletedMessage } from "./dev-client/stream.js";
+export { sendDevelopmentMessage } from "./dev-client/send-message.js";
+export { createDevelopmentSessionState, disposeDevelopmentSession, } from "./dev-client/session.js";
+export { extractCompletedMessage } from "./dev-client/stream.js";
+class BufferedDevelopmentMessageClient {
+    #session;
+    #serverUrl;
+    constructor(input) {
+        this.#serverUrl = input.serverUrl;
+        this.#session =
+            input.initialRunId === undefined
+                ? createDevelopmentSessionState()
+                : createDevelopmentSessionState({
+                    runId: input.initialRunId,
+                });
+    }
+    async clear() {
+        await disposeDevelopmentSession(this.#session);
+        this.#session = createDevelopmentSessionState();
+    }
+    async close() {
+        await disposeDevelopmentSession(this.#session);
+    }
+    getSession() {
+        return this.#session;
+    }
+    async sendMessage(input) {
+        const result = await sendDevelopmentMessage({
+            message: input.message,
+            onEvent: input.onEvent,
+            onResponseStart: input.onResponseStart,
+            serverUrl: this.#serverUrl,
+            session: this.#session,
+        });
+        this.#session = result.session;
+        return {
+            completedMessage: extractCompletedMessage(result.events),
+            events: result.events,
+            runId: result.runId,
+            session: result.session,
+        };
+    }
+}
+/**
+ * Creates a stateful development client bound to one Ash server URL.
+ */
+export function createDevClient(input) {
+    return new BufferedDevelopmentMessageClient(input);
+}
+//# sourceMappingURL=dev-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-client.js","sourceRoot":"","sources":["../../../src/services/dev-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EACL,6BAA6B,EAE7B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EACL,6BAA6B,EAE7B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAyCjE,MAAM,gCAAgC;IACpC,QAAQ,CAA0B;IACzB,UAAU,CAAS;IAE5B,YAAY,KAAmD;QAC7D,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,QAAQ;YACX,KAAK,CAAC,YAAY,KAAK,SAAS;gBAC9B,CAAC,CAAC,6BAA6B,EAAE;gBACjC,CAAC,CAAC,6BAA6B,CAAC;oBAC5B,KAAK,EAAE,KAAK,CAAC,YAAY;iBAC1B,CAAC,CAAC;IACX,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,6BAA6B,EAAE,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAIjB;QACC,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,OAAO,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;QAE/B,OAAO;YACL,gBAAgB,EAAE,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC;YACxD,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAG/B;IACC,OAAO,IAAI,gCAAgC,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC"}