@tidblink/server 0.0.0-stage → 0.3.0-rc.0

package/dist/session.d.ts

@@ -0,0 +1,136 @@
+import { type AudioTurnInput, type AudioTurnEvent, type AudioTurnResult } from "./audio.js";
+import { type PendingClientToolCall, type ClientToolOutputInput, type ClientToolDeclaration, type ClientToolSet, type ReplaceClientToolsOptions } from "./client-tools.js";
+import { type TurnCommandInput, type RetryReceipt } from "./control.js";
+import { type SessionEvent, type SessionEventsOptions, type ObserveTurnOptions, type TurnObservation } from "./progress.js";
+import type { RequestOptions } from "./organization.js";
+import { HttpClient } from "./http.js";
+import { type OpenRealtimeConnectionInput, type OpenRealtimeConnectionResult, type RealtimeConnectGrant, type RealtimeConnection, type RealtimeModelSelection } from "./realtime.js";
+import { type CreateTurnInput, type TurnResult, type WaitForResultOptions } from "./turn.js";
+import { type SessionInteraction, type SessionInteractionPage, type TurnRecord, type TurnPage, type SessionTimelinePage } from "./history.js";
+import type { ListOptions } from "./http.js";
+/** Model IDs come from the deployment catalog, including newly published models. */
+export type SelectableSessionModel = string;
+export type SessionModel = string;
+export interface CreateSessionOptions extends RequestOptions {
+    idempotencyKey: string;
+    model?: string;
+    realtimeModel?: string;
+    billingTag?: BillingTag | null;
+    tools?: ClientToolDeclaration[];
+}
+export interface SuggestSessionNameInput {
+    userText: string;
+    assistantText?: string;
+}
+export interface BillingTag {
+    key: string;
+    value: string;
+}
+export interface SessionRecord {
+    organizationId: string;
+    sessionId: string;
+    name: string | null;
+    autoTitle: string | null;
+    ownerUserId: string;
+    startedByUserId: string;
+    createdByType: "user" | "scheduler" | "template_preview";
+    readOnly: boolean;
+    sourceSchedulerId: string | null;
+    sourceSchedulerFireId: string | null;
+    billingTag: BillingTag | null;
+    model: SessionModel;
+    modelRevision: number;
+    realtimeModel: string | null;
+    realtimeModelRevision: number;
+    realtimeModelEtag: string;
+    realtimeVoice: import("./realtime.js").RealtimeVoiceSetting | null;
+    template?: {
+        templateId: string;
+        contentDigest: string;
+    } | null;
+    realtime: {
+        id: string;
+        status: "connecting" | "active" | "paused";
+        audio: import("./realtime.js").RealtimeAudioFormats;
+        startedAt: string;
+    } | null;
+    createdWithAgentId: string;
+    modelPolicyStatus: "allowed" | "organization_disallowed";
+    status: "active" | "deleted";
+    activeTurnId: string | null;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt: string | null;
+}
+export type ClarificationItem = {
+    prompt: string;
+    selectionMode: "single";
+    answerChoices: [string, string, string?];
+    response?: {
+        answers: [string];
+        responseTurnId: string;
+    };
+} | {
+    prompt: string;
+    selectionMode: "multiple";
+    answerChoices: [string, string, ...string[]];
+    response?: {
+        answers: [string, ...string[]];
+        responseTurnId: string;
+    };
+};
+export declare class Session {
+    #private;
+    readonly id: string;
+    constructor(http: HttpClient, id: string, record?: SessionRecord, etag?: string);
+    get data(): Readonly<SessionRecord> | undefined;
+    get model(): SessionModel | undefined;
+    refresh(options?: RequestOptions): Promise<this>;
+    setModel(model: SelectableSessionModel, options?: RequestOptions): Promise<this>;
+    rename(name: string, options?: RequestOptions): Promise<this>;
+    suggestName(input: SuggestSessionNameInput, options?: RequestOptions): Promise<this>;
+    setBillingTag(billingTag: BillingTag | null, options?: RequestOptions): Promise<this>;
+    delete(options?: RequestOptions): Promise<this>;
+    openRealtimeConnection(input?: OpenRealtimeConnectionInput, options?: {
+        signal?: AbortSignal;
+    }): Promise<OpenRealtimeConnectionResult>;
+    getRealtimeConnection(options?: {
+        signal?: AbortSignal;
+    }): Promise<RealtimeConnection>;
+    createRealtimeConnectToken(options?: {
+        signal?: AbortSignal;
+    }): Promise<RealtimeConnectGrant>;
+    endRealtimeConnection(options?: {
+        signal?: AbortSignal;
+    }): Promise<RealtimeConnection>;
+    getRealtimeModelSelection(options?: {
+        signal?: AbortSignal;
+    }): Promise<RealtimeModelSelection>;
+    setRealtimeModel(model: string, options: {
+        ifMatch: string;
+        signal?: AbortSignal;
+    }): Promise<RealtimeModelSelection>;
+    events(options?: SessionEventsOptions): AsyncGenerator<SessionEvent>;
+    observe(inputId: string, options?: ObserveTurnOptions): AsyncGenerator<TurnObservation>;
+    streamAudio(input: AudioTurnInput): AsyncGenerator<AudioTurnEvent>;
+    audio(input: AudioTurnInput): Promise<AudioTurnResult>;
+    getClientTools(options?: RequestOptions): Promise<ClientToolSet>;
+    replaceClientTools(tools: readonly ClientToolDeclaration[], options: ReplaceClientToolsOptions): Promise<ClientToolSet>;
+    listPendingClientToolCalls(options?: RequestOptions): Promise<PendingClientToolCall[]>;
+    submitClientToolOutput(input: ClientToolOutputInput): Promise<SessionInteraction>;
+    history(options?: ListOptions): Promise<TurnPage>;
+    getTurn(turnId: string, options?: RequestOptions): Promise<TurnRecord>;
+    timeline(options?: ListOptions): Promise<SessionTimelinePage>;
+    listInteractions(options?: ListOptions): Promise<SessionInteractionPage>;
+    getInteraction(inputId: string, options?: RequestOptions): Promise<SessionInteraction>;
+    reconcileInteraction(clientEventId: string, options?: RequestOptions): Promise<SessionInteraction | null>;
+    /** Acceptance requests cancellation; read the receipt for the eventual outcome. */
+    cancel(input: TurnCommandInput): Promise<SessionInteraction>;
+    /** Explicit checkpoint retry has its own identity and original execution result. */
+    retry(input: TurnCommandInput): Promise<RetryReceipt>;
+    submitMessage(input: CreateTurnInput): Promise<SessionInteraction>;
+    waitForResult(inputId: string, options?: WaitForResultOptions): Promise<TurnResult>;
+    turn(input: CreateTurnInput, options?: WaitForResultOptions): Promise<TurnResult>;
+}
+export declare const createSessionForAgent: (http: HttpClient, agentId: string, options: CreateSessionOptions) => Promise<Session>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -0,0 +1,226 @@
+import { audioTurn, streamAudio, } from "./audio.js";
+import { getClientTools, replaceClientTools, validateClientTools, listPendingClientToolCalls, submitClientToolOutput, } from "./client-tools.js";
+import { submitTurnCommand, } from "./control.js";
+import { sessionEvents, observeTurn, } from "./progress.js";
+import { OutcomeUnknownError } from "./errors.js";
+import { requestOptions, HttpClient, requireEtag, requireKnownKeys, requireCreationKey, } from "./http.js";
+import { realtimeModelSelectionFrom, requireOpenRealtimeConnectionReceipt, requireRealtimeConnectGrantReceipt, requireRealtimeConnectionReceipt, requireRealtimeModelSelectionReceipt, } from "./realtime.js";
+import { submitMessage, waitForResult, validateWaitOptions, } from "./turn.js";
+import { getInteraction, reconcileInteraction, listInteractions, history, getTurn, timeline, } from "./history.js";
+export class Session {
+    #http;
+    id;
+    #etag;
+    #record;
+    constructor(http, id, record, etag) {
+        if (!id)
+            throw new TypeError("Session id is required");
+        this.#http = http;
+        this.id = id;
+        this.#record = record;
+        this.#etag = etag;
+    }
+    get data() {
+        return this.#record;
+    }
+    get model() {
+        return this.#record?.model;
+    }
+    async refresh(options) {
+        options = requestOptions(options);
+        const result = await this.#http.getResponse(`/api/v1/user/sessions/${encodeURIComponent(this.id)}`, options);
+        const etag = requireEtag(result);
+        this.#record = result.data.session;
+        this.#etag = etag;
+        return this;
+    }
+    async setModel(model, options) {
+        options = requestOptions(options);
+        if (!this.#etag)
+            await this.refresh(options);
+        const result = await this.#http.patchResponse(`/api/v1/user/sessions/${encodeURIComponent(this.id)}/model`, { model }, {
+            ifMatch: this.#etag,
+            outcomeUnknown: true,
+            ...options,
+        });
+        if (!result.etag)
+            throw new OutcomeUnknownError("Session model update returned no model ETag; read the Session before changing it again", { requestId: result.requestId });
+        this.#record = sessionReceipt(result.data, result.requestId);
+        const etag = result.etag;
+        this.#etag = etag;
+        return this;
+    }
+    async rename(name, options) {
+        options = requestOptions(options);
+        const result = await this.#http.postResponse(`/api/v1/user/sessions/${encodeURIComponent(this.id)}/name`, { name }, { ...options, outcomeUnknown: true });
+        this.#record = sessionReceipt(result.data, result.requestId);
+        return this;
+    }
+    async suggestName(input, options) {
+        options = requestOptions(options);
+        requireKnownKeys(input, ["userText", "assistantText"], "Session naming input");
+        const result = await this.#http.postResponse(`/api/v1/user/sessions/${encodeURIComponent(this.id)}/name/suggest`, input, { ...options, outcomeUnknown: true });
+        this.#record = sessionReceipt(result.data, result.requestId);
+        return this;
+    }
+    async setBillingTag(billingTag, options) {
+        options = requestOptions(options);
+        const result = await this.#http.patchResponse(`/api/v1/user/sessions/${encodeURIComponent(this.id)}/billing-tag`, { billingTag }, { ...options, outcomeUnknown: true });
+        this.#record = sessionReceipt(result.data, result.requestId);
+        return this;
+    }
+    async delete(options) {
+        options = requestOptions(options);
+        const result = await this.#http.deleteResponse(`/api/v1/user/sessions/${encodeURIComponent(this.id)}`, { ...options, outcomeUnknown: true });
+        this.#record = sessionReceipt(result.data, result.requestId);
+        return this;
+    }
+    async openRealtimeConnection(input = {}, options) {
+        options = requestOptions(options);
+        requireKnownKeys(input, ["audio", "metadata"], "Realtime Connection input");
+        const result = await this.#http.postResponse(`/api/v1/user/sessions/${encodeURIComponent(this.id)}/realtime`, input, {
+            outcomeUnknown: true,
+            ...(options?.signal ? { signal: options.signal } : {}),
+        });
+        return requireOpenRealtimeConnectionReceipt(result.data, result.requestId);
+    }
+    async getRealtimeConnection(options) {
+        options = requestOptions(options);
+        const response = await this.#http.get(`/api/v1/user/sessions/${encodeURIComponent(this.id)}/realtime`, options);
+        return response.realtimeConnection;
+    }
+    async createRealtimeConnectToken(options) {
+        options = requestOptions(options);
+        const result = await this.#http.postResponse(`/api/v1/user/sessions/${encodeURIComponent(this.id)}/realtime/connect-tokens`, undefined, {
+            outcomeUnknown: true,
+            ...(options?.signal ? { signal: options.signal } : {}),
+        });
+        return requireRealtimeConnectGrantReceipt(result.data, result.requestId);
+    }
+    async endRealtimeConnection(options) {
+        options = requestOptions(options);
+        const result = await this.#http.deleteResponse(`/api/v1/user/sessions/${encodeURIComponent(this.id)}/realtime`, {
+            outcomeUnknown: true,
+            ...(options?.signal ? { signal: options.signal } : {}),
+        });
+        return requireRealtimeConnectionReceipt(result.data, result.requestId);
+    }
+    async getRealtimeModelSelection(options) {
+        options = requestOptions(options);
+        const response = await this.#http.get(`/api/v1/user/sessions/${encodeURIComponent(this.id)}`, options);
+        return realtimeModelSelectionFrom(response.session);
+    }
+    async setRealtimeModel(model, options) {
+        requireKnownKeys(options, ["ifMatch", "signal"], "Realtime Model selection options");
+        if (!model || model.length > 128)
+            throw new TypeError("Realtime Model ID must contain 1-128 characters");
+        if (!options.ifMatch)
+            throw new TypeError("Realtime Model selection requires ifMatch");
+        const result = await this.#http.patchResponse(`/api/v1/user/sessions/${encodeURIComponent(this.id)}/realtime-model`, { realtimeModel: model }, {
+            ifMatch: options.ifMatch,
+            outcomeUnknown: true,
+            ...(options.signal ? { signal: options.signal } : {}),
+        });
+        const receipt = result.data;
+        return requireRealtimeModelSelectionReceipt(receipt?.session, result.requestId);
+    }
+    events(options) {
+        return sessionEvents(this.#http, this.id, options);
+    }
+    observe(inputId, options) {
+        return observeTurn(this.#http, this.id, inputId, options);
+    }
+    streamAudio(input) {
+        return streamAudio(this.#http, this.id, input);
+    }
+    audio(input) {
+        return audioTurn(this.#http, this.id, input);
+    }
+    getClientTools(options) {
+        return getClientTools(this.#http, this.id, options);
+    }
+    replaceClientTools(tools, options) {
+        return replaceClientTools(this.#http, this.id, tools, options);
+    }
+    listPendingClientToolCalls(options) {
+        return listPendingClientToolCalls(this.#http, this.id, options);
+    }
+    submitClientToolOutput(input) {
+        return submitClientToolOutput(this.#http, this.id, input);
+    }
+    history(options) {
+        return history(this.#http, this.id, options);
+    }
+    getTurn(turnId, options) {
+        return getTurn(this.#http, this.id, turnId, options);
+    }
+    timeline(options) {
+        return timeline(this.#http, this.id, options);
+    }
+    listInteractions(options) {
+        return listInteractions(this.#http, this.id, options);
+    }
+    getInteraction(inputId, options) {
+        return getInteraction(this.#http, this.id, inputId, options);
+    }
+    reconcileInteraction(clientEventId, options) {
+        return reconcileInteraction(this.#http, this.id, clientEventId, options);
+    }
+    /** Acceptance requests cancellation; read the receipt for the eventual outcome. */
+    cancel(input) {
+        return submitTurnCommand(this.#http, this.id, "cancel", input);
+    }
+    /** Explicit checkpoint retry has its own identity and original execution result. */
+    retry(input) {
+        return submitTurnCommand(this.#http, this.id, "retry", input);
+    }
+    submitMessage(input) {
+        return submitMessage(this.#http, this.id, input);
+    }
+    waitForResult(inputId, options) {
+        return waitForResult(this.#http, this.id, inputId, options);
+    }
+    async turn(input, options) {
+        validateWaitOptions(options);
+        const waitOptions = {
+            ...(input.signal ? { signal: input.signal } : {}),
+            ...options,
+        };
+        const accepted = await this.submitMessage(input);
+        return this.waitForResult(accepted.inputId, waitOptions);
+    }
+}
+const sessionReceipt = (value, requestId) => {
+    if (typeof value?.session?.sessionId !== "string" ||
+        !value.session.sessionId) {
+        throw new OutcomeUnknownError("Session mutation returned no usable Session; reconcile before retrying", { requestId });
+    }
+    return value.session;
+};
+export const createSessionForAgent = async (http, agentId, options) => {
+    requireKnownKeys(options, [
+        "idempotencyKey",
+        "model",
+        "realtimeModel",
+        "billingTag",
+        "tools",
+        "signal",
+        "requestId",
+    ], "Session options");
+    requireCreationKey(options.idempotencyKey);
+    if (options.tools !== undefined)
+        validateClientTools(options.tools);
+    const { idempotencyKey, signal, requestId, ...body } = options;
+    const result = await http.postResponse("/api/v1/user/sessions", { agentId, ...body }, {
+        idempotencyKey,
+        idempotent: true,
+        outcomeUnknown: true,
+        ...(signal ? { signal } : {}),
+        ...(requestId ? { requestId } : {}),
+    });
+    const record = sessionReceipt(result.data, result.requestId);
+    if (!result.etag)
+        throw new OutcomeUnknownError("Session creation returned no model ETag; recover with the same creation key", { requestId: result.requestId });
+    return new Session(http, record.sessionId, record, result.etag);
+};
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/sse.d.ts

@@ -0,0 +1,7 @@
+/** Decode data frames only. A frame is complete only at its blank line. */
+export declare function decodeSse(body: ReadableStream<Uint8Array>): AsyncGenerator<{
+    id: string;
+    event: string;
+    data: string;
+}>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wBAAuB,SAAS,CAC9B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAC/B,cAAc,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAuCD"}

package/dist/sse.js

@@ -0,0 +1,45 @@
+/** Decode data frames only. A frame is complete only at its blank line. */
+export async function* decodeSse(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    let buffer = "";
+    let id = "";
+    let event = "";
+    let data = [];
+    try {
+        while (true) {
+            const chunk = await reader.read();
+            buffer += decoder.decode(chunk.value, { stream: !chunk.done });
+            let end;
+            while ((end = buffer.search(/[\r\n]/)) !== -1) {
+                if (buffer[end] === "\r" && end === buffer.length - 1 && !chunk.done)
+                    break;
+                const line = buffer.slice(0, end);
+                buffer = buffer.slice(end + (buffer.slice(end, end + 2) === "\r\n" ? 2 : 1));
+                if (line === "") {
+                    if (data.length)
+                        yield { id, event, data: data.join("\n") };
+                    event = "";
+                    data = [];
+                    continue;
+                }
+                const separator = line.indexOf(":");
+                const field = separator === -1 ? line : line.slice(0, separator);
+                const value = separator === -1 ? "" : line.slice(separator + 1).replace(/^ /, "");
+                if (field === "data")
+                    data.push(value);
+                else if (field === "event")
+                    event = value;
+                else if (field === "id" && !value.includes("\0"))
+                    id = value;
+            }
+            if (chunk.done)
+                return;
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,SAAS,CAC9B,IAAgC;IAMhC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,IAAI,GAAa,EAAE,CAAC;IACxB,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/D,IAAI,GAAW,CAAC;YAChB,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC9C,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI;oBAClE,MAAM;gBACR,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBAClC,MAAM,GAAG,MAAM,CAAC,KAAK,CACnB,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACtD,CAAC;gBACF,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;oBAChB,IAAI,IAAI,CAAC,MAAM;wBAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5D,KAAK,GAAG,EAAE,CAAC;oBACX,IAAI,GAAG,EAAE,CAAC;oBACV,SAAS;gBACX,CAAC;gBACD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACpC,MAAM,KAAK,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;gBACjE,MAAM,KAAK,GACT,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACtE,IAAI,KAAK,KAAK,MAAM;oBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;qBAClC,IAAI,KAAK,KAAK,OAAO;oBAAE,KAAK,GAAG,KAAK,CAAC;qBACrC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,EAAE,GAAG,KAAK,CAAC;YAC/D,CAAC;YACD,IAAI,KAAK,CAAC,IAAI;gBAAE,OAAO;QACzB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/turn.d.ts

@@ -0,0 +1,43 @@
+import { HttpClient } from "./http.js";
+import { type SessionInteraction } from "./history.js";
+import type { BillingTag, ClarificationItem } from "./session.js";
+export interface CreateTurnInput {
+    /** Persist this Session-local command identity before dispatch. */
+    clientEventId: string;
+    text: string | [string, ...string[]];
+    userFileIds?: string[];
+    clarificationSourceTurnId?: string;
+    billingTag?: BillingTag | null;
+    requestId?: string;
+    signal?: AbortSignal;
+}
+export interface WaitForResultOptions {
+    /** Local deadline only; default 60 seconds. Never cancels execution. */
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    requestId?: string;
+    signal?: AbortSignal;
+}
+type ResultIdentity = {
+    sessionId: string;
+    inputId: string;
+    turnId: string;
+    messageId: string;
+    text: string;
+    interaction: SessionInteraction;
+};
+export type TurnResult = ResultIdentity & ({
+    type: "answer";
+} | {
+    type: "clarification";
+    clarification: ClarificationItem;
+});
+export declare const validClarification: (value: unknown) => value is ClarificationItem;
+export declare const submitMessage: (http: HttpClient, sessionId: string, input: CreateTurnInput) => Promise<SessionInteraction>;
+export declare const validateWaitOptions: (options?: WaitForResultOptions) => {
+    timeoutMs: number;
+    pollIntervalMs: number;
+};
+export declare const waitForResult: (http: HttpClient, sessionId: string, inputId: string, options?: WaitForResultOptions) => Promise<TurnResult>;
+export {};
+//# sourceMappingURL=turn.d.ts.map

package/dist/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../src/turn.ts"],"names":[],"mappings":"AASA,OAAO,EACL,UAAU,EAIX,MAAM,WAAW,CAAC;AACnB,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,KAAK,cAAc,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,kBAAkB,CAAC;CACjC,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,cAAc,GACrC,CACI;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,aAAa,EAAE,iBAAiB,CAAA;CAAE,CAC9D,CAAC;AAEJ,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,iBAkC5D,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,UAAU,EAChB,WAAW,MAAM,EACjB,OAAO,eAAe,KACrB,OAAO,CAAC,kBAAkB,CAmF5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,UAAS,oBAAyB,KACjC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAyB7C,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,UAAU,EAChB,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,oBAAyB,KACjC,OAAO,CAAC,UAAU,CAwHpB,CAAC"}