experimental-ash 0.24.2 → 0.25.0

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

@@ -1,185 +0,0 @@
-import { ASH_SESSION_ID_HEADER, createMessageSessionStreamPath } from "#protocol/message.js";
-import { ASH_CREATE_SESSION_ROUTE_PATH, createAshContinueSessionRoutePath, } from "#protocol/routes.js";
-import { openDevelopmentMessageStream } from "#services/dev-client/live-stream.js";
-import { createDevelopmentRequestHeadersAsync, } from "#services/dev-client/request-headers.js";
-import { createDevelopmentMessageRequest, createDevelopmentSessionState, updateDevelopmentSessionState, } from "#services/dev-client/session.js";
-import { extractCurrentTurnBoundaryEvent } from "#services/dev-client/stream.js";
-import { resolveDevelopmentServerResourceUrl, resolveDevelopmentServerRouteUrl, } from "#services/dev-client/url.js";
-const DEVELOPMENT_TURN_STREAM_RECONNECT_LIMIT = 3;
-async function fetchDevelopmentSessionStreamResponse(input) {
-    const canonicalResourceUrl = resolveDevelopmentServerResourceUrl({
-        resource: createMessageSessionStreamPath(input.sessionId),
-        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: await createDevelopmentRequestHeadersAsync({
-            headers: input.headers,
-            resourceUrl: requestResourceUrl,
-        }),
-        signal: input.signal ?? null,
-    });
-    if (!streamResponse.ok) {
-        const body = await streamResponse.text();
-        throw new Error(body || `Session stream route returned ${streamResponse.status}.`);
-    }
-    return {
-        resourceUrl: canonicalResourceUrl.toString(),
-        response: streamResponse,
-    };
-}
-async function openDevelopmentSessionStream(input) {
-    const streamResponse = await fetchDevelopmentSessionStreamResponse(input);
-    return openDevelopmentMessageStream({
-        resourceUrl: streamResponse.resourceUrl,
-        response: streamResponse.response,
-    });
-}
-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 openDevelopmentSessionStream({
-            headers: input.headers,
-            sessionId: input.sessionId,
-            signal: input.signal,
-            serverUrl: input.serverUrl,
-            startIndex: currentStreamIndex,
-        });
-    }
-}
-/**
- * Sends one message to the configured Ash server and collects its streamed
- * events, forwarding any caller-supplied Ash route headers across the message
- * and stream requests for the current turn.
- */
-export async function sendDevelopmentMessage(input) {
-    const session = input.session;
-    const routePath = session.sessionId
-        ? createAshContinueSessionRoutePath(session.sessionId)
-        : ASH_CREATE_SESSION_ROUTE_PATH;
-    const messageRouteUrl = resolveDevelopmentServerRouteUrl({
-        routePath,
-        serverUrl: input.serverUrl,
-    });
-    let stream;
-    try {
-        const response = await fetch(messageRouteUrl, {
-            body: JSON.stringify(createDevelopmentMessageRequest({
-                message: input.message,
-                session,
-            })),
-            headers: await createDevelopmentRequestHeadersAsync({
-                headers: createMessageRouteHeaders(input.headers),
-                resourceUrl: messageRouteUrl,
-            }),
-            method: "POST",
-            signal: input.signal ?? null,
-        });
-        if (!response.ok) {
-            const body = await response.text();
-            throw new Error(body || `Message route returned ${response.status}.`);
-        }
-        const payload = (await response.json());
-        if (payload.status === "completed" && typeof payload.output === "string") {
-            const continuationToken = typeof payload.continuationToken === "string" ? payload.continuationToken : undefined;
-            return {
-                completedMessage: payload.output,
-                events: [],
-                session: createDevelopmentSessionState({ continuationToken }),
-            };
-        }
-        const sessionId = (typeof payload.sessionId === "string" ? payload.sessionId : undefined) ??
-            response.headers.get(ASH_SESSION_ID_HEADER)?.trim() ??
-            session.sessionId ??
-            undefined;
-        const continuationToken = typeof payload.continuationToken === "string"
-            ? payload.continuationToken
-            : session.continuationToken;
-        if (!sessionId) {
-            throw new Error("Message route did not return a session id.");
-        }
-        input.onResponseStart?.({
-            sessionId,
-        });
-        stream = await openDevelopmentSessionStream({
-            headers: input.headers,
-            sessionId,
-            signal: input.signal,
-            serverUrl: input.serverUrl,
-            startIndex: session.sessionId === sessionId ? session.streamIndex : undefined,
-        });
-        const readResult = await readDevelopmentTurnEvents({
-            headers: input.headers,
-            initialStartIndex: session.sessionId === sessionId ? session.streamIndex : 0,
-            onEvent: input.onEvent,
-            sessionId,
-            signal: input.signal,
-            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({
-            continuationToken,
-            events,
-            sessionId,
-            session,
-        });
-        await stream.close();
-        return {
-            events,
-            sessionId,
-            session: nextSession,
-        };
-    }
-    catch (error) {
-        await stream?.close().catch(() => undefined);
-        throw error;
-    }
-}
-function createMessageRouteHeaders(headers) {
-    const resolvedHeaders = new Headers(copyDevelopmentRequestHeaders(headers));
-    resolvedHeaders.set("content-type", "application/json");
-    return resolvedHeaders;
-}
-function copyDevelopmentRequestHeaders(headers) {
-    if (headers === undefined) {
-        return undefined;
-    }
-    if (headers instanceof Headers) {
-        return headers;
-    }
-    if (Array.isArray(headers)) {
-        return headers.map(([key, value]) => [key, value]);
-    }
-    return headers;
-}

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

@@ -1,54 +0,0 @@
-import type { HandleMessageRequestBody, 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;
-    /**
-     * V2 continuation token for resuming a parked session across turns.
-     */
-    readonly continuationToken?: string;
-    /**
-     * Number of streamed workflow chunks already consumed from the session stream.
-     */
-    readonly streamIndex: number;
-    /**
-     * Active session id when the workflow is parked for the next user message.
-     */
-    readonly sessionId?: 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 continuationToken?: string;
-    readonly sessionId?: string;
-    readonly streamIndex?: number;
-}): DevelopmentSessionState;
-/**
- * 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 continuationToken?: string;
-    readonly events: readonly HandleMessageStreamEvent[];
-    readonly sessionId: string;
-    readonly session: DevelopmentSessionState;
-}): DevelopmentSessionState;

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

@@ -1,52 +0,0 @@
-import { countCurrentTurnBoundaryEvents, extractCurrentTurnBoundaryEvent, } from "#services/dev-client/stream.js";
-/**
- * Returns the session state used before any message is sent or when the
- * client resumes a known waiting run.
- */
-export function createDevelopmentSessionState(input = {}) {
-    return {
-        boundaryCount: input.boundaryCount ?? 0,
-        continuationToken: input.continuationToken,
-        sessionId: input.sessionId,
-        streamIndex: input.streamIndex ?? 0,
-    };
-}
-/**
- * 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.continuationToken) {
-        return {
-            continuationToken: input.session.continuationToken,
-            message: input.message,
-        };
-    }
-    return {
-        message: input.message,
-    };
-}
-/**
- * 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,
-            continuationToken: input.continuationToken ?? input.session.continuationToken,
-            sessionId: input.sessionId,
-            streamIndex,
-        });
-    }
-    return createDevelopmentSessionState();
-}

package/dist/src/services/host.d.ts

@@ -1,14 +0,0 @@
-import { type DevelopmentServerHandle } from "#internal/nitro/host.js";
-export type { DevelopmentServerHandle };
-/**
- * Builds the production host output for one Ash application.
- */
-export declare function buildHost(appRoot: string): Promise<string>;
-/**
- * Starts the development host for one Ash application.
- */
-export declare function startHost(appRoot: string, options?: {
-    host?: string;
-    port?: number;
-    schedules?: boolean;
-}): Promise<DevelopmentServerHandle>;

package/dist/src/services/host.js

@@ -1,13 +0,0 @@
-import { buildApplication, startDevelopmentServer, } from "#internal/nitro/host.js";
-/**
- * Builds the production host output for one Ash application.
- */
-export async function buildHost(appRoot) {
-    return await buildApplication(appRoot);
-}
-/**
- * Starts the development host for one Ash application.
- */
-export async function startHost(appRoot, options = {}) {
-    return await startDevelopmentServer(appRoot, options);
-}