@teaflask/assistant 0.0.0 → 0.3.0

package/dist/transport/door-budget.js

@@ -0,0 +1,76 @@
+// The tool-results door refuses results whose serialized JSON passes 20k
+// chars — measured server-side with ensure_ascii escaping and spaced
+// separators — and a refused POST would strand the turn until it parks.
+// Every client-side size bound on a deliverable payload must therefore be
+// taken against a CEILING of the door's own metric, never against raw JS
+// string length: non-ASCII re-escapes into 6-char \uXXXX sequences and a
+// truncated-text payload re-escapes its quotes, either of which can
+// inflate a "small" payload past the cap. Shared by whichever producer
+// ships text through the door (action responses, page reads).
+/**
+ * A ceiling on the length the tool-results door will measure for a
+ * client-serialized JSON text: the door re-serializes with ensure_ascii
+ * (every non-ASCII UTF-16 unit becomes a 6-char \uXXXX) and spaced
+ * separators (every comma and colon may gain a space). In-string commas
+ * are over-counted — a ceiling never needs to be exact, only never under.
+ */
+export function doorLengthCeilingOf(serialized) {
+    let length = 0;
+    for (let index = 0; index < serialized.length; index += 1) {
+        const code = serialized.charCodeAt(index);
+        if (code > 0x7f) {
+            length += 6;
+        }
+        else if (code === 0x2c /* , */ || code === 0x3a /* : */) {
+            length += 2;
+        }
+        else {
+            length += 1;
+        }
+    }
+    return length;
+}
+/**
+ * Truncate by what each unit will cost once this text rides as a JSON
+ * string through the door's ensure_ascii serializer, at worst case — a
+ * raw-length cut could still blow the cap on re-escaping. Never splits a
+ * surrogate pair.
+ */
+export function boundedTextOf(text, maxEscapedChars) {
+    let budget = maxEscapedChars;
+    let end = 0;
+    while (end < text.length) {
+        const cost = escapedCostOf(text.charCodeAt(end));
+        if (cost > budget) {
+            break;
+        }
+        budget -= cost;
+        end += 1;
+    }
+    if (end > 0 && _isHighSurrogate(text.charCodeAt(end - 1))) {
+        end -= 1; // never cut a surrogate pair in half
+    }
+    return text.slice(0, end);
+}
+/** The worst-case door footprint of a whole text inside a JSON string. */
+export function doorCostOfText(text) {
+    let cost = 0;
+    for (let index = 0; index < text.length; index += 1) {
+        cost += escapedCostOf(text.charCodeAt(index));
+    }
+    return cost;
+}
+/** The worst-case door footprint of one UTF-16 unit inside a JSON string. */
+export function escapedCostOf(code) {
+    if (code > 0x7f || code < 0x20) {
+        return 6;
+    }
+    if (code === 0x22 /* " */ || code === 0x5c /* \ */) {
+        return 2;
+    }
+    return 1;
+}
+function _isHighSurrogate(code) {
+    return code >= 0xd800 && code <= 0xdbff;
+}
+//# sourceMappingURL=door-budget.js.map

package/dist/transport/door-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"door-budget.js","sourceRoot":"","sources":["../../src/transport/door-budget.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,qEAAqE;AACrE,wEAAwE;AACxE,0EAA0E;AAC1E,yEAAyE;AACzE,yEAAyE;AACzE,oEAAoE;AACpE,uEAAuE;AACvE,8DAA8D;AAE9D;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;aAAM,IAAI,IAAI,KAAK,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1D,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,eAAuB;IACjE,IAAI,MAAM,GAAG,eAAe,CAAC;IAC7B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACjD,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC;YAClB,MAAM;QACR,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;QACf,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,GAAG,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,IAAI,CAAC,CAAC,CAAC,qCAAqC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAC/B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACnD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;AAC1C,CAAC"}

package/dist/transport/replay-stream-agent.d.ts

@@ -0,0 +1,33 @@
+import { HttpAgent } from "@ag-ui/client";
+import type { BaseEvent, RunAgentInput } from "@ag-ui/core";
+import { type Observable } from "rxjs";
+import { StreamResumeStore } from "./stream-resume.js";
+export interface ServingReplayStreamAgentConfig {
+    streamUrl: string;
+    streamThreadId: string;
+    authorizedFetch: (url: string, requestInit: RequestInit) => Promise<Response>;
+    resume?: StreamResumeStore;
+}
+/**
+ * AG-UI client for the serving thread stream. The endpoint is watch-only
+ * and treats attach and run identically — every connection replays the
+ * recorded log and then tails it — so connecting is just running. With a
+ * resume snapshot the replay is asked to start past the cursor instead of
+ * from the beginning; the transcript is byte-equivalent either way, which
+ * is what keeps full replay the always-correct fallback.
+ */
+export declare class ServingReplayStreamAgent extends HttpAgent {
+    private readonly scanner;
+    private readonly seededSnapshot;
+    private readonly seededContentIds;
+    constructor({ streamUrl, streamThreadId, authorizedFetch, resume, }: ServingReplayStreamAgentConfig);
+    private _reseedWhenTheHostWipesTheList;
+    get resumeCursor(): string | null;
+    get sawBodyBytes(): boolean;
+    run(input: RunAgentInput): Observable<BaseEvent>;
+    protected connect(input: RunAgentInput): Observable<BaseEvent>;
+    protected requestInit(input: RunAgentInput): RequestInit;
+    private _replaceAbortControllerIfAborted;
+    private _alreadySeeded;
+}
+//# sourceMappingURL=replay-stream-agent.d.ts.map

package/dist/transport/replay-stream-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-stream-agent.d.ts","sourceRoot":"","sources":["../../src/transport/replay-stream-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAW,aAAa,EAAE,MAAM,aAAa,CAAC;AAKrE,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAG/C,OAAO,EAEL,iBAAiB,EAElB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAGlB,cAAc,EAAE,MAAM,CAAC;IAGvB,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAK9E,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;gBAE3C,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,MAAM,GACP,EAAE,8BAA8B;IAuBjC,OAAO,CAAC,8BAA8B;IActC,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAMD,IAAI,YAAY,IAAI,OAAO,CAE1B;IAKQ,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC;cAItC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC;cAmBpD,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW;IAOjE,OAAO,CAAC,gCAAgC;IAMxC,OAAO,CAAC,cAAc;CA2BvB"}

package/dist/transport/replay-stream-agent.js

@@ -0,0 +1,146 @@
+import { HttpAgent } from "@ag-ui/client";
+import { EventType } from "@ag-ui/core";
+// A compatible range (^7.8.0) so host resolvers dedupe onto
+// @ag-ui/client's exact rxjs pin rather than installing a second copy —
+// rxjs is only named so the emitted declaration can type connect()'s
+// Observable and the overlap filter can ride the returned pipeline.
+import { filter } from "rxjs";
+import { liftToolOutcome } from "../core/tool-outcome.js";
+import { SseFrameIdScanner, StreamResumeStore, } from "./stream-resume.js";
+/**
+ * AG-UI client for the serving thread stream. The endpoint is watch-only
+ * and treats attach and run identically — every connection replays the
+ * recorded log and then tails it — so connecting is just running. With a
+ * resume snapshot the replay is asked to start past the cursor instead of
+ * from the beginning; the transcript is byte-equivalent either way, which
+ * is what keeps full replay the always-correct fallback.
+ */
+export class ServingReplayStreamAgent extends HttpAgent {
+    scanner;
+    seededSnapshot;
+    seededContentIds;
+    constructor({ streamUrl, streamThreadId, authorizedFetch, resume, }) {
+        const scanner = new SseFrameIdScanner();
+        const snapshot = resume?.snapshot ?? null;
+        super({
+            url: streamUrl,
+            threadId: streamThreadId,
+            fetch: scanner.wrap(authorizedFetch),
+            initialMessages: snapshot?.messages,
+        });
+        this.scanner = scanner;
+        this.seededSnapshot = snapshot;
+        this.seededContentIds =
+            snapshot === null ? new Set() : _contentIdsOf(snapshot.messages);
+        this._reseedWhenTheHostWipesTheList();
+    }
+    // CopilotKit's chat clears a non-empty agent message list when it
+    // mounts (its first thread sync sees an unknown thread), which erases
+    // the constructor's initialMessages seeding. onRunInitialized runs
+    // inside connectAgent AFTER that wipe and BEFORE the apply pipeline
+    // captures its message baseline, so re-seeding here is what actually
+    // sticks; on an agent whose list survived (bare transports, tests) the
+    // non-empty guard makes this a no-op.
+    _reseedWhenTheHostWipesTheList() {
+        this.subscribe({
+            onRunInitialized: ({ messages }) => {
+                const snapshot = this.seededSnapshot;
+                if (snapshot !== null && messages.length === 0) {
+                    return { messages: structuredClone(snapshot.messages) };
+                }
+                return undefined;
+            },
+        });
+    }
+    // The newest cursor received on this agent's connection — what the
+    // resume-snapshot recorder pairs with the applied messages at settle.
+    get resumeCursor() {
+        return this.scanner.lastEventId;
+    }
+    // Whether this agent's connection delivered any SSE body bytes at all,
+    // keepalive pings included — the liveness fact failure classification
+    // needs, deliberately not inferred from the replay cursor
+    // (a live-but-idle stream commits no frame).
+    get sawBodyBytes() {
+        return this.scanner.bodyBytesSeen;
+    }
+    // Every path in — connect() below and the client's own runAgent() — funnels
+    // through run(), ahead of the client's schema enforcement: the one seam
+    // where the wire's tool-outcome extras can still be lifted into metadata.
+    run(input) {
+        return liftToolOutcome(super.run(input));
+    }
+    connect(input) {
+        this._replaceAbortControllerIfAborted();
+        const snapshot = this.seededSnapshot ?? null;
+        if (snapshot === null) {
+            return this.run(input);
+        }
+        // The filter de-dupes re-delivered content by the contract's stable
+        // ids before the verifier sees it: the boundary snap re-delivers an
+        // interrupted run in full, and a server that ignores the cursor full-
+        // replays onto the seeded list — where @ag-ui/client would duplicate
+        // tool calls (TOOL_CALL_START pushes unconditionally).
+        return this.run(_resumedPast(input, snapshot.afterId)).pipe(filter((event) => !this._alreadySeeded(event)));
+    }
+    // The endpoint is watch-only by contract: a seeded agent must not
+    // upload its whole transcript in the RunAgentInput body on every
+    // reconnect (prepareRunAgentInput serializes this.messages).
+    requestInit(input) {
+        return super.requestInit({ ...input, messages: [] });
+    }
+    // abortRun() aborts the controller and never replaces it; without this a
+    // remounted surface (React StrictMode, back-navigation) would reconnect
+    // with an already-aborted signal and die instantly.
+    _replaceAbortControllerIfAborted() {
+        if (this.abortController.signal.aborted) {
+            this.abortController = new AbortController();
+        }
+    }
+    _alreadySeeded(event) {
+        switch (event.type) {
+            case EventType.TEXT_MESSAGE_START:
+            case EventType.TEXT_MESSAGE_CONTENT:
+            case EventType.TEXT_MESSAGE_END:
+            case EventType.REASONING_START:
+            case EventType.REASONING_MESSAGE_START:
+            case EventType.REASONING_MESSAGE_CONTENT:
+            case EventType.REASONING_MESSAGE_END:
+            case EventType.REASONING_END:
+            case EventType.TOOL_CALL_RESULT:
+                return this.seededContentIds.has(event.messageId);
+            case EventType.TOOL_CALL_START:
+            case EventType.TOOL_CALL_ARGS:
+            case EventType.TOOL_CALL_END:
+                return this.seededContentIds.has(event.toolCallId);
+            default:
+                // Lifecycle framing and markers pass: RUN_STARTED re-delivery is
+                // idempotent downstream (the injector guards by message id), and
+                // dropping a terminal would leave the run unclosed.
+                return false;
+        }
+    }
+}
+function _resumedPast(input, afterId) {
+    const forwardedProps = (input.forwardedProps ?? {});
+    return {
+        ...input,
+        forwardedProps: { ...forwardedProps, after_id: afterId },
+    };
+}
+// Every id the stream can re-deliver content under: message ids of all
+// roles (tool results dedupe by their tool message's id) plus the tool
+// call ids inside assistant messages.
+function _contentIdsOf(messages) {
+    const ids = new Set();
+    for (const message of messages) {
+        ids.add(message.id);
+        if (message.role === "assistant") {
+            for (const toolCall of message.toolCalls ?? []) {
+                ids.add(toolCall.id);
+            }
+        }
+    }
+    return ids;
+}
+//# sourceMappingURL=replay-stream-agent.js.map

package/dist/transport/replay-stream-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-stream-agent.js","sourceRoot":"","sources":["../../src/transport/replay-stream-agent.ts"],"names":[],"mappings":"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"}

package/dist/transport/serving-api.d.ts

@@ -0,0 +1,40 @@
+import type { GetServingAssistantThreadParams, ListServingAssistantThreadsParams, ServingAttachmentDownloadUrlResponse } from "../generated/models/index.js";
+import type { AssistantConfigResponse } from "../contract/assistant-config.js";
+import type { ThreadDispatch } from "../contract/dispatches.js";
+import type { AssistantThreadDetailResponse, AttachmentUploadIntent, ResolveTurnApprovalRequest, ResolveTurnApprovalResponse, ResolveTurnToolResultsRequest, ResolveTurnToolResultsResponse, SendAssistantMessageRequest, SendAssistantMessageResponse, ServingAssistantThread, ServingAttachment, StopTurnResponse } from "../contract/threads.js";
+import type { SubscriptionDeviceAuthorization, SubscriptionDeviceAuthorizationPoll, SubscriptionProvider, SubscriptionStatus } from "../contract/subscriptions.js";
+import type { TokenSession } from "./token-session.js";
+export declare function sendAssistantMessage(session: TokenSession, request: SendAssistantMessageRequest): Promise<SendAssistantMessageResponse>;
+/** The stop door: thread-scoped on purpose — the server's
+ *  thread pointer names the live turn (liveness, never recency), so the
+ *  caller never picks one. Every answer is a receipt, including
+ *  already_settled: the button races the answer by nature. */
+export declare function stopAssistantTurn(session: TokenSession, threadId: string): Promise<StopTurnResponse>;
+export declare function listAssistantThreads(session: TokenSession, params?: ListServingAssistantThreadsParams): Promise<ServingAssistantThread[]>;
+export declare function getAssistantThread(session: TokenSession, threadId: string, params?: GetServingAssistantThreadParams): Promise<AssistantThreadDetailResponse>;
+export declare function listThreadDispatches(session: TokenSession, threadId: string): Promise<ThreadDispatch[]>;
+export declare function getAssistantConfig(session: TokenSession): Promise<AssistantConfigResponse>;
+export declare function resolveTurnApproval(session: TokenSession, threadId: string, turnId: string, request: ResolveTurnApprovalRequest): Promise<ResolveTurnApprovalResponse>;
+export declare function resolveTurnToolResults(session: TokenSession, threadId: string, turnId: string, request: ResolveTurnToolResultsRequest): Promise<ResolveTurnToolResultsResponse>;
+export declare function createAttachmentUpload(session: TokenSession, request: {
+    filename: string;
+    byte_size: number;
+}): Promise<AttachmentUploadIntent>;
+export declare function finalizeAttachment(session: TokenSession, attachmentId: string): Promise<ServingAttachment>;
+export declare function getAttachmentDownloadUrl(session: TokenSession, attachmentId: string): Promise<ServingAttachmentDownloadUrlResponse>;
+export declare function listSubscriptions(session: TokenSession): Promise<SubscriptionStatus[]>;
+export declare function beginSubscriptionDeviceAuthorization(session: TokenSession, provider: SubscriptionProvider): Promise<SubscriptionDeviceAuthorization>;
+export declare function pollSubscriptionDeviceAuthorization(session: TokenSession, provider: SubscriptionProvider, sealedAuthorization: string): Promise<SubscriptionDeviceAuthorizationPoll>;
+export declare function disconnectSubscription(session: TokenSession, provider: SubscriptionProvider): Promise<void>;
+/**
+ * The direct-to-storage PUT: a plain fetch against the presigned URL —
+ * no auth header (the signature is the credential), no Content-Type (the
+ * server sniffs the stored bytes; the signature pins only the length).
+ */
+export declare function putFileToUploadUrl(uploadUrl: string, file: Blob): Promise<void>;
+export declare function streamUrlForThread(session: TokenSession, threadId: string): string;
+/** The child transcript stream: one dispatched subagent's own
+ *  replay-then-tail, addressed by the thread and the child session id —
+ *  the only child handle on the serving wire. */
+export declare function streamUrlForChild(session: TokenSession, threadId: string, childSessionId: string): string;
+//# sourceMappingURL=serving-api.d.ts.map

package/dist/transport/serving-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serving-api.d.ts","sourceRoot":"","sources":["../../src/transport/serving-api.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,+BAA+B,EAC/B,iCAAiC,EACjC,oCAAoC,EACrC,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EACV,6BAA6B,EAC7B,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,8BAA8B,EAC9B,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,+BAA+B,EAC/B,mCAAmC,EACnC,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,4BAA4B,CAAC,CAEvC;AAED;;;8DAG8D;AAC9D,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,iCAAiC,GACzC,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAEnC;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,+BAA+B,GACvC,OAAO,CAAC,6BAA6B,CAAC,CAMxC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CAK3B;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CAOtC;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,8BAA8B,CAAC,CAOzC;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,sBAAsB,CAAC,CAEjC;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAK5B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,YAAY,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,oCAAoC,CAAC,CAK/C;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAK/B;AAED,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,+BAA+B,CAAC,CAE1C;AAED,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,oBAAoB,EAC9B,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,mCAAmC,CAAC,CAM9C;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,IAAI,CAAC,CAKf;AAKD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;iDAEiD;AACjD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,MAAM,CAER"}

package/dist/transport/serving-api.js

@@ -0,0 +1,82 @@
+// The session-scoped face over the generated /serving/v1 client: every
+// call threads its TokenSession into the mutator, so streams and REST
+// calls share one token lifecycle. Signatures stay the package's own —
+// components never see the generated layer.
+import { createDeviceAuthorization as createDeviceAuthorizationOperation, createServingAttachmentUpload as createServingAttachmentUploadOperation, disconnectSubscription as disconnectSubscriptionOperation, finalizeServingAttachment as finalizeServingAttachmentOperation, getServingAttachmentDownloadUrl as getServingAttachmentDownloadUrlOperation, getServingAssistantThread as getServingAssistantThreadOperation, listServingAssistantThreadDispatches as listServingAssistantThreadDispatchesOperation, listServingAssistantThreads as listServingAssistantThreadsOperation, listServingSubscriptions as listServingSubscriptionsOperation, pollDeviceAuthorization as pollDeviceAuthorizationOperation, readAssistantConfig as readAssistantConfigOperation, resolveServingAssistantTurnApproval as resolveServingAssistantTurnApprovalOperation, resolveServingAssistantTurnToolResults as resolveServingAssistantTurnToolResultsOperation, sendServingAssistantMessage as sendServingAssistantMessageOperation, stopServingAssistantTurn as stopServingAssistantTurnOperation, } from "../generated/serving.js";
+export async function sendAssistantMessage(session, request) {
+    return sendServingAssistantMessageOperation(request, _withSession(session));
+}
+/** The stop door: thread-scoped on purpose — the server's
+ *  thread pointer names the live turn (liveness, never recency), so the
+ *  caller never picks one. Every answer is a receipt, including
+ *  already_settled: the button races the answer by nature. */
+export async function stopAssistantTurn(session, threadId) {
+    return stopServingAssistantTurnOperation(threadId, _withSession(session));
+}
+export async function listAssistantThreads(session, params) {
+    return listServingAssistantThreadsOperation(params, _withSession(session));
+}
+export async function getAssistantThread(session, threadId, params) {
+    return getServingAssistantThreadOperation(threadId, params, _withSession(session));
+}
+export async function listThreadDispatches(session, threadId) {
+    return listServingAssistantThreadDispatchesOperation(threadId, _withSession(session));
+}
+export async function getAssistantConfig(session) {
+    return readAssistantConfigOperation(_withSession(session));
+}
+export async function resolveTurnApproval(session, threadId, turnId, request) {
+    return resolveServingAssistantTurnApprovalOperation(threadId, turnId, request, _withSession(session));
+}
+export async function resolveTurnToolResults(session, threadId, turnId, request) {
+    return resolveServingAssistantTurnToolResultsOperation(threadId, turnId, request, _withSession(session));
+}
+export async function createAttachmentUpload(session, request) {
+    return createServingAttachmentUploadOperation(request, _withSession(session));
+}
+export async function finalizeAttachment(session, attachmentId) {
+    return finalizeServingAttachmentOperation(attachmentId, _withSession(session));
+}
+export async function getAttachmentDownloadUrl(session, attachmentId) {
+    return getServingAttachmentDownloadUrlOperation(attachmentId, _withSession(session));
+}
+export async function listSubscriptions(session) {
+    const response = await listServingSubscriptionsOperation(_withSession(session));
+    return response.subscriptions;
+}
+export async function beginSubscriptionDeviceAuthorization(session, provider) {
+    return createDeviceAuthorizationOperation(provider, _withSession(session));
+}
+export async function pollSubscriptionDeviceAuthorization(session, provider, sealedAuthorization) {
+    return pollDeviceAuthorizationOperation(provider, { sealed_authorization: sealedAuthorization }, _withSession(session));
+}
+export async function disconnectSubscription(session, provider) {
+    await disconnectSubscriptionOperation(provider, _withSession(session));
+}
+/**
+ * The direct-to-storage PUT: a plain fetch against the presigned URL —
+ * no auth header (the signature is the credential), no Content-Type (the
+ * server sniffs the stored bytes; the signature pins only the length).
+ */
+export async function putFileToUploadUrl(uploadUrl, file) {
+    const response = await fetch(uploadUrl, { method: "PUT", body: file });
+    if (!response.ok) {
+        throw new Error(`The file upload failed (${String(response.status)}).`);
+    }
+}
+// The stream endpoints are deliberately absent from the generated client
+// (they speak SSE through replay-stream-agent, not JSON); their paths are
+// pinned to serving-openapi.json by tests/contract-parity.
+export function streamUrlForThread(session, threadId) {
+    return `${session.baseUrl}/serving/v1/assistant-threads/${threadId}/stream`;
+}
+/** The child transcript stream: one dispatched subagent's own
+ *  replay-then-tail, addressed by the thread and the child session id —
+ *  the only child handle on the serving wire. */
+export function streamUrlForChild(session, threadId, childSessionId) {
+    return `${session.baseUrl}/serving/v1/assistant-threads/${threadId}/dispatches/${childSessionId}/stream`;
+}
+function _withSession(session) {
+    return { session };
+}
+//# sourceMappingURL=serving-api.js.map

package/dist/transport/serving-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serving-api.js","sourceRoot":"","sources":["../../src/transport/serving-api.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,sEAAsE;AACtE,uEAAuE;AACvE,4CAA4C;AAE5C,OAAO,EACL,yBAAyB,IAAI,kCAAkC,EAC/D,6BAA6B,IAAI,sCAAsC,EACvE,sBAAsB,IAAI,+BAA+B,EACzD,yBAAyB,IAAI,kCAAkC,EAC/D,+BAA+B,IAAI,wCAAwC,EAC3E,yBAAyB,IAAI,kCAAkC,EAC/D,oCAAoC,IAAI,6CAA6C,EACrF,2BAA2B,IAAI,oCAAoC,EACnE,wBAAwB,IAAI,iCAAiC,EAC7D,uBAAuB,IAAI,gCAAgC,EAC3D,mBAAmB,IAAI,4BAA4B,EACnD,mCAAmC,IAAI,4CAA4C,EACnF,sCAAsC,IAAI,+CAA+C,EACzF,2BAA2B,IAAI,oCAAoC,EACnE,wBAAwB,IAAI,iCAAiC,GAC9D,MAAM,yBAAyB,CAAC;AA8BjC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAqB,EACrB,OAAoC;IAEpC,OAAO,oCAAoC,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;8DAG8D;AAC9D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAqB,EACrB,QAAgB;IAEhB,OAAO,iCAAiC,CAAC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAqB,EACrB,MAA0C;IAE1C,OAAO,oCAAoC,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAqB,EACrB,QAAgB,EAChB,MAAwC;IAExC,OAAO,kCAAkC,CACvC,QAAQ,EACR,MAAM,EACN,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAqB,EACrB,QAAgB;IAEhB,OAAO,6CAA6C,CAClD,QAAQ,EACR,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAqB;IAErB,OAAO,4BAA4B,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAqB,EACrB,QAAgB,EAChB,MAAc,EACd,OAAmC;IAEnC,OAAO,4CAA4C,CACjD,QAAQ,EACR,MAAM,EACN,OAAO,EACP,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAqB,EACrB,QAAgB,EAChB,MAAc,EACd,OAAsC;IAEtC,OAAO,+CAA+C,CACpD,QAAQ,EACR,MAAM,EACN,OAAO,EACP,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAqB,EACrB,OAAgD;IAEhD,OAAO,sCAAsC,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAqB,EACrB,YAAoB;IAEpB,OAAO,kCAAkC,CACvC,YAAY,EACZ,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAqB,EACrB,YAAoB;IAEpB,OAAO,wCAAwC,CAC7C,YAAY,EACZ,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,iCAAiC,CACtD,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;IACF,OAAO,QAAQ,CAAC,aAAa,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,OAAqB,EACrB,QAA8B;IAE9B,OAAO,kCAAkC,CAAC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,OAAqB,EACrB,QAA8B,EAC9B,mBAA2B;IAE3B,OAAO,gCAAgC,CACrC,QAAQ,EACR,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,EAC7C,YAAY,CAAC,OAAO,CAAC,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAqB,EACrB,QAA8B;IAE9B,MAAM,+BAA+B,CAAC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,IAAU;IAEV,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,0EAA0E;AAC1E,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAChC,OAAqB,EACrB,QAAgB;IAEhB,OAAO,GAAG,OAAO,CAAC,OAAO,iCAAiC,QAAQ,SAAS,CAAC;AAC9E,CAAC;AAED;;iDAEiD;AACjD,MAAM,UAAU,iBAAiB,CAC/B,OAAqB,EACrB,QAAgB,EAChB,cAAsB;IAEtB,OAAO,GAAG,OAAO,CAAC,OAAO,iCAAiC,QAAQ,eAAe,cAAc,SAAS,CAAC;AAC3G,CAAC;AAED,SAAS,YAAY,CAAC,OAAqB;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/transport/serving-error.d.ts

@@ -0,0 +1,21 @@
+import type { ServingErrorCodeOnTheWire } from "../contract/errors.js";
+/**
+ * A non-2xx answer from a /serving/v1 surface, decoded from the contract's
+ * error envelope. `message` is the server's human sentence; the package
+ * substitutes its own copy for the codes it knows (see error-copy.ts).
+ */
+export declare class ServingApiError extends Error {
+    readonly code: ServingErrorCodeOnTheWire;
+    readonly status: number;
+    readonly retryAfterSeconds: number | null;
+    readonly details: unknown;
+    constructor(options: {
+        code: ServingErrorCodeOnTheWire;
+        status: number;
+        message: string;
+        retryAfterSeconds: number | null;
+        details?: unknown;
+    });
+}
+export declare function parseServingError(response: Response): Promise<ServingApiError>;
+//# sourceMappingURL=serving-error.d.ts.map

package/dist/transport/serving-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serving-error.d.ts","sourceRoot":"","sources":["../../src/transport/serving-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAIxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAK1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,OAAO,EAAE;QACnB,IAAI,EAAE,yBAAyB,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB;CAQF;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,eAAe,CAAC,CAW1B"}

package/dist/transport/serving-error.js

@@ -0,0 +1,69 @@
+/**
+ * A non-2xx answer from a /serving/v1 surface, decoded from the contract's
+ * error envelope. `message` is the server's human sentence; the package
+ * substitutes its own copy for the codes it knows (see error-copy.ts).
+ */
+export class ServingApiError extends Error {
+    code;
+    status;
+    // From the Retry-After header when the server sent one (RATE_LIMITED
+    // and SUBSCRIPTION_CANNOT_PAY do; ASSISTANT_UNFUNDED deliberately does
+    // not — money, not time, changes that answer).
+    retryAfterSeconds;
+    // The envelope's structured half, when the server sent one — e.g.
+    // SUBSCRIPTION_CONNECT_REQUIRED's `providers` list. Its reader is the
+    // connect gate (connect-gate.ts), which projects it for the connect
+    // panel, so that surface touches no transport code.
+    details;
+    constructor(options) {
+        super(options.message);
+        this.name = "ServingApiError";
+        this.code = options.code;
+        this.status = options.status;
+        this.retryAfterSeconds = options.retryAfterSeconds;
+        this.details = options.details;
+    }
+}
+export async function parseServingError(response) {
+    const envelope = await _readEnvelopeIfPresent(response);
+    return new ServingApiError({
+        code: envelope?.error.code ?? "UNKNOWN",
+        status: response.status,
+        message: envelope?.error.message ??
+            "The assistant service answered unexpectedly. Please try again.",
+        retryAfterSeconds: _retryAfterSecondsOf(response),
+        details: envelope?.error.details,
+    });
+}
+async function _readEnvelopeIfPresent(response) {
+    try {
+        const body = await response.json();
+        if (_looksLikeErrorEnvelope(body)) {
+            return body;
+        }
+    }
+    catch {
+        // A non-JSON error body (a proxy page, an empty response) still needs
+        // a usable error — the fallback envelope covers it.
+    }
+    return null;
+}
+function _looksLikeErrorEnvelope(body) {
+    if (typeof body !== "object" || body === null || !("error" in body)) {
+        return false;
+    }
+    const error = body.error;
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        "message" in error);
+}
+function _retryAfterSecondsOf(response) {
+    const header = response.headers.get("Retry-After");
+    if (header === null) {
+        return null;
+    }
+    const seconds = Number.parseInt(header, 10);
+    return Number.isNaN(seconds) ? null : seconds;
+}
+//# sourceMappingURL=serving-error.js.map

package/dist/transport/serving-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serving-error.js","sourceRoot":"","sources":["../../src/transport/serving-error.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAA4B;IAChC,MAAM,CAAS;IACxB,qEAAqE;IACrE,uEAAuE;IACvE,+CAA+C;IACtC,iBAAiB,CAAgB;IAC1C,kEAAkE;IAClE,sEAAsE;IACtE,oEAAoE;IACpE,oDAAoD;IAC3C,OAAO,CAAU;IAE1B,YAAY,OAMX;QACC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAkB;IAElB,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACxD,OAAO,IAAI,eAAe,CAAC;QACzB,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,SAAS;QACvC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EACL,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,gEAAgE;QAClE,iBAAiB,EAAE,oBAAoB,CAAC,QAAQ,CAAC;QACjD,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO;KACjC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,QAAkB;IAElB,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;QACtE,oDAAoD;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAa;IAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,SAAS,IAAI,KAAK,CACnB,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAkB;IAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;AAChD,CAAC"}

package/dist/transport/serving-fetch.d.ts

@@ -0,0 +1,6 @@
+import type { TokenSession } from "./token-session.js";
+export type ServingRequestInit = RequestInit & {
+    session?: TokenSession;
+};
+export declare function servingFetch<Body>(url: string, init: ServingRequestInit): Promise<Body>;
+//# sourceMappingURL=serving-fetch.d.ts.map

package/dist/transport/serving-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serving-fetch.d.ts","sourceRoot":"","sources":["../../src/transport/serving-fetch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG;IAAE,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAE1E,wBAAsB,YAAY,CAAC,IAAI,EACrC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/transport/serving-fetch.js

@@ -0,0 +1,23 @@
+// The Orval mutator behind every generated /serving/v1 call. Sessions are
+// per-provider (never module state), so each call carries its TokenSession
+// in the options — Orval propagates this type onto the generated functions'
+// options parameter.
+import { parseServingError } from "./serving-error.js";
+export async function servingFetch(url, init) {
+    const { session, ...requestInit } = init;
+    if (session === undefined) {
+        throw new Error("This serving call has no TokenSession. Call it through the " +
+            "serving-api wrappers, which thread the session into options.");
+    }
+    const response = await session.authorizedFetch(`${session.baseUrl}${url}`, requestInit);
+    if (!response.ok) {
+        throw await parseServingError(response);
+    }
+    // 204 carries no body by definition (the disconnect door answers it);
+    // .json() on the empty body would throw and turn a success into an error.
+    if (response.status === 204) {
+        return undefined;
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=serving-fetch.js.map

package/dist/transport/serving-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serving-fetch.js","sourceRoot":"","sources":["../../src/transport/serving-fetch.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,qBAAqB;AAErB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAQvD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,IAAwB;IAExB,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC;IACzC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,6DAA6D;YAC3D,8DAA8D,CACjE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,eAAe,CAC5C,GAAG,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,EAC1B,WAAW,CACZ,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,sEAAsE;IACtE,0EAA0E;IAC1E,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,SAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAS,CAAC;AACzC,CAAC"}