@teaflask/assistant 0.3.0 → 0.7.0

package/src/generated/serving.ts

@@ -1,593 +0,0 @@
-/**
- * Generated by orval 🍺
- * Do not edit manually.
- * teaflask-serving
- * OpenAPI spec version: 1
- */
-import type {
-  AssistantConfigResponse,
-  CreateDeviceAuthorizationResponse,
-  CreateServingAttachmentUploadRequest,
-  CreateServingAttachmentUploadResponse,
-  CurrentVisitorResponse,
-  GetServingAssistantThreadParams,
-  ListServingAssistantThreadsParams,
-  MintVisitorTokenRequest,
-  MintVisitorTokenResponse,
-  PollDeviceAuthorizationRequest,
-  PollDeviceAuthorizationResponse,
-  ResolveServingTurnApprovalRequest,
-  ResolveServingTurnApprovalResponse,
-  ResolveServingTurnToolResultsRequest,
-  ResolveServingTurnToolResultsResponse,
-  SendServingAssistantMessageRequest,
-  SendServingAssistantMessageResponse,
-  ServingAgentDispatchResponse,
-  ServingAssistantThreadDetailResponse,
-  ServingAssistantThreadResponse,
-  ServingAttachmentDownloadUrlResponse,
-  ServingAttachmentResponse,
-  ServingSubscriptionsResponse,
-  StopServingTurnResponse,
-  SubscriptionProvider,
-} from "./models/index.js";
-
-import { servingFetch } from "../transport/serving-fetch.js";
-export const getMintVisitorTokenUrl = () => {
-  return `/serving/v1/visitor-tokens`;
-};
-
-/**
- * @summary Mint Visitor Token
- */
-export const mintVisitorToken = async (
-  mintVisitorTokenRequest: MintVisitorTokenRequest,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<MintVisitorTokenResponse> => {
-  const getHeaders = (
-    h?: NonNullable<RequestInit["headers"]>,
-  ): Record<string, string | readonly string[]> => {
-    if (!h) return {};
-    if (h instanceof Headers) return Object.fromEntries(h.entries());
-    if (Array.isArray(h)) return Object.fromEntries(h);
-    return h;
-  };
-  return servingFetch<MintVisitorTokenResponse>(getMintVisitorTokenUrl(), {
-    ...options,
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      ...getHeaders(options?.headers),
-    },
-    body: JSON.stringify(mintVisitorTokenRequest),
-  });
-};
-
-export const getReadCurrentVisitorUrl = () => {
-  return `/serving/v1/whoami`;
-};
-
-/**
- * The identity plane's contract exerciser: the widget's session
- * self-check and the definition-of-done probe, until the wave-2
- * assistant endpoints become the plane's real consumers.
- * @summary Read Current Visitor
- */
-export const readCurrentVisitor = async (
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<CurrentVisitorResponse> => {
-  return servingFetch<CurrentVisitorResponse>(getReadCurrentVisitorUrl(), {
-    ...options,
-    method: "GET",
-  });
-};
-
-export const getReadAssistantConfigUrl = () => {
-  return `/serving/v1/assistant-config`;
-};
-
-/**
- * The widget's authored configuration, resolved exactly like a turn:
- * the minting key's selected agent, else the organization's published
- * assistant, else the built-in default.
- * @summary Read Assistant Config
- */
-export const readAssistantConfig = async (
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<AssistantConfigResponse> => {
-  return servingFetch<AssistantConfigResponse>(getReadAssistantConfigUrl(), {
-    ...options,
-    method: "GET",
-  });
-};
-
-export const getSendServingAssistantMessageUrl = () => {
-  return `/serving/v1/assistant-threads/messages`;
-};
-
-/**
- * Create-or-continue the visitor's conversation and start this
- * message's turn workflow — the dashboard send, under the serving trust
- * context. The turn spend is counted before anything else: turns are
- * model calls, so they carry their own small per-IP window beside the
- * blanket — per address, not per visitor, because a fresh token is a
- * fresh visitor id but never a fresh address. A message sent
- * while the previous turn still runs QUEUES (the inbox is the
- * queue, durable and ordered — the busy 409 has no producer left); a
- * parked previous turn is voided at the entity's member open — its
- * pending work superseded with the outcome recorded as unknown, one
- * beat after the 201; an unreachable orchestration
- * service settles the turn failed honestly before the 503 — never a
- * message that silently goes nowhere.
- * @summary Send Serving Assistant Message
- */
-export const sendServingAssistantMessage = async (
-  sendServingAssistantMessageRequest: SendServingAssistantMessageRequest,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<SendServingAssistantMessageResponse> => {
-  const getHeaders = (
-    h?: NonNullable<RequestInit["headers"]>,
-  ): Record<string, string | readonly string[]> => {
-    if (!h) return {};
-    if (h instanceof Headers) return Object.fromEntries(h.entries());
-    if (Array.isArray(h)) return Object.fromEntries(h);
-    return h;
-  };
-  return servingFetch<SendServingAssistantMessageResponse>(
-    getSendServingAssistantMessageUrl(),
-    {
-      ...options,
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...getHeaders(options?.headers),
-      },
-      body: JSON.stringify(sendServingAssistantMessageRequest),
-    },
-  );
-};
-
-export const getListServingAssistantThreadsUrl = (
-  params?: ListServingAssistantThreadsParams,
-) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : String(value));
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `/serving/v1/assistant-threads?${stringifiedParams}`
-    : `/serving/v1/assistant-threads`;
-};
-
-/**
- * The identified visitor's cross-device history, most recently
- * touched first. Page with the last row's updated_at and id as
- * before_updated_at/before_id; a full page means more may exist. An
- * anonymous visitor's only handle on a conversation is its thread id, so
- * the list is empty — one widget code path, nothing enumerable to leak.
- * @summary List Serving Assistant Threads
- */
-export const listServingAssistantThreads = async (
-  params?: ListServingAssistantThreadsParams,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<ServingAssistantThreadResponse[]> => {
-  return servingFetch<ServingAssistantThreadResponse[]>(
-    getListServingAssistantThreadsUrl(params),
-    {
-      ...options,
-      method: "GET",
-    },
-  );
-};
-
-export const getGetServingAssistantThreadUrl = (
-  threadId: string,
-  params?: GetServingAssistantThreadParams,
-) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : String(value));
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `/serving/v1/assistant-threads/${threadId}?${stringifiedParams}`
-    : `/serving/v1/assistant-threads/${threadId}`;
-};
-
-/**
- * The conversation and the newest window of its turns (oldest-first
- * within the window), under the visitor's owner scope. Page backwards
- * with the oldest held turn's created_at and id as
- * before_created_at/before_id; a full window means earlier turns may
- * exist. Turn rows are the display source for user text — user_message
- * stores the bare message, never the LLM-side injected context.
- * @summary Get Serving Assistant Thread
- */
-export const getServingAssistantThread = async (
-  threadId: string,
-  params?: GetServingAssistantThreadParams,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<ServingAssistantThreadDetailResponse> => {
-  return servingFetch<ServingAssistantThreadDetailResponse>(
-    getGetServingAssistantThreadUrl(threadId, params),
-    {
-      ...options,
-      method: "GET",
-    },
-  );
-};
-
-export const getListServingAssistantThreadDispatchesUrl = (
-  threadId: string,
-) => {
-  return `/serving/v1/assistant-threads/${threadId}/dispatches`;
-};
-
-/**
- * The conversation's coworker family in dispatch order, under the
- * visitor's owner scope — the widget transcript's join between its
- * dispatch receipts and the ledger, so a child that outlives its turn
- * reads settled instead of spinning. The family is thread-scoped:
- * assistant turns stamp the thread's session id as the parent, so one
- * read spans every turn. A bare array, deliberately not a keyset page —
- * and deliberately unbounded: each turn's fan-out is capped by the
- * parent's slot budget, but the family grows with every delegating
- * turn, and a newest-N bound would strand older rendered receipts
- * un-joined — a frozen launched receipt with no ledger row reads running
- * forever and keeps the widget polling indefinitely, the exact failure
- * this read exists to end. Revisit with a receipt-scoped read if
- * long-lived widget threads delegate heavily.
- * @summary List Serving Assistant Thread Dispatches
- */
-export const listServingAssistantThreadDispatches = async (
-  threadId: string,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<ServingAgentDispatchResponse[]> => {
-  return servingFetch<ServingAgentDispatchResponse[]>(
-    getListServingAssistantThreadDispatchesUrl(threadId),
-    {
-      ...options,
-      method: "GET",
-    },
-  );
-};
-
-export const getResolveServingAssistantTurnApprovalUrl = (
-  threadId: string,
-  turnId: string,
-) => {
-  return `/serving/v1/assistant-threads/${threadId}/turns/${turnId}/approval`;
-};
-
-/**
- * Answer a paused turn's pending approvals — the dashboard's
- * record-then-wake delivery, owner-scoped to the visitor. The answers
- * land as durable rows, then the thread's ConversationWorkflow routes
- * them: couriered to a live pause, or consumed by the resume it opens
- * for a parked turn (its wait expired) — the answer still counts until
- * a new message voids it, and one already past this door answers a
- * receipt (already_consumed): the turn's own once a resume consumed it,
- * or a coworker's once its row left paused with the decision recorded —
- * however it left, or paused again at a newer round. Interrupt ids are
- * deliberately unvalidated here: an id the pause never raised satisfies
- * nothing.
- * @summary Resolve Serving Assistant Turn Approval
- */
-export const resolveServingAssistantTurnApproval = async (
-  threadId: string,
-  turnId: string,
-  resolveServingTurnApprovalRequest: ResolveServingTurnApprovalRequest,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<ResolveServingTurnApprovalResponse> => {
-  const getHeaders = (
-    h?: NonNullable<RequestInit["headers"]>,
-  ): Record<string, string | readonly string[]> => {
-    if (!h) return {};
-    if (h instanceof Headers) return Object.fromEntries(h.entries());
-    if (Array.isArray(h)) return Object.fromEntries(h);
-    return h;
-  };
-  return servingFetch<ResolveServingTurnApprovalResponse>(
-    getResolveServingAssistantTurnApprovalUrl(threadId, turnId),
-    {
-      ...options,
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...getHeaders(options?.headers),
-      },
-      body: JSON.stringify(resolveServingTurnApprovalRequest),
-    },
-  );
-};
-
-export const getResolveServingAssistantTurnToolResultsUrl = (
-  threadId: string,
-  turnId: string,
-) => {
-  return `/serving/v1/assistant-threads/${threadId}/turns/${turnId}/tool-results`;
-};
-
-/**
- * Deliver a paused turn's client-executed tool results — the
- * execution twin of the approval endpoint, owner-scoped to the visitor.
- * Every result passes the door's gate first: the size cap, validation
- * against the kind the server's own request card declared, and the
- * sanitizer pass — client-posted results are the most injection-prone
- * input this system ingests.
- *
- * While the turn is still answerable (awaiting input, or parked — a
- * parked turn restarts from the persisted session), everything posted
- * delivers: a duplicate is harmless there (the workflow's own
- * first-wins map arbitrates, and the resume answers only interrupts
- * the session still awaits), and a delivered-but-never-consumed result
- * dies with its workflow — the re-POST IS the recovery, so the door
- * must never swallow it. The receipt ledger answers only turns that
- * stopped being answerable: a voided turn records the report as
- * evidence — the only witness of a mutating action's actual outcome —
- * and a settled turn's known interrupts no-op; both say do-not-retry.
- * @summary Resolve Serving Assistant Turn Tool Results
- */
-export const resolveServingAssistantTurnToolResults = async (
-  threadId: string,
-  turnId: string,
-  resolveServingTurnToolResultsRequest: ResolveServingTurnToolResultsRequest,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<ResolveServingTurnToolResultsResponse> => {
-  const getHeaders = (
-    h?: NonNullable<RequestInit["headers"]>,
-  ): Record<string, string | readonly string[]> => {
-    if (!h) return {};
-    if (h instanceof Headers) return Object.fromEntries(h.entries());
-    if (Array.isArray(h)) return Object.fromEntries(h);
-    return h;
-  };
-  return servingFetch<ResolveServingTurnToolResultsResponse>(
-    getResolveServingAssistantTurnToolResultsUrl(threadId, turnId),
-    {
-      ...options,
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...getHeaders(options?.headers),
-      },
-      body: JSON.stringify(resolveServingTurnToolResultsRequest),
-    },
-  );
-};
-
-export const getStopServingAssistantTurnUrl = (threadId: string) => {
-  return `/serving/v1/assistant-threads/${threadId}/stop`;
-};
-
-/**
- * End the thread's live turn as a quiet receipt — the dashboard's
- * stop door, owner-scoped to the visitor. The thread pointer names the
- * live turn (recency is not liveness: a late answer can revive a
- * parked turn behind a newer settled row); the newest row answers only
- * when no workflow holds the thread. One path: record
- * the stop intent durably, wake the live lane, and wake the thread's
- * ConversationWorkflow — the courier and the settler. Stopping an
- * already-settled turn answers a receipt, never an error: the button
- * races the answer by nature. Stop ends the turn, not the
- * conversation: the next message queues a fresh turn against the same
- * persisted session.
- * @summary Stop Serving Assistant Turn
- */
-export const stopServingAssistantTurn = async (
-  threadId: string,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<StopServingTurnResponse> => {
-  return servingFetch<StopServingTurnResponse>(
-    getStopServingAssistantTurnUrl(threadId),
-    {
-      ...options,
-      method: "POST",
-    },
-  );
-};
-
-export const getCreateServingAttachmentUploadUrl = () => {
-  return `/serving/v1/assistant-attachments`;
-};
-
-/**
- * Step one: declare the file, get back the attachment id and the
- * presigned PUT. Both storage-spend windows are counted before anything
- * is written — per address (a re-minted token never sheds one) and per
- * organization per day.
- * @summary Create Serving Attachment Upload
- */
-export const createServingAttachmentUpload = async (
-  createServingAttachmentUploadRequest: CreateServingAttachmentUploadRequest,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<CreateServingAttachmentUploadResponse> => {
-  const getHeaders = (
-    h?: NonNullable<RequestInit["headers"]>,
-  ): Record<string, string | readonly string[]> => {
-    if (!h) return {};
-    if (h instanceof Headers) return Object.fromEntries(h.entries());
-    if (Array.isArray(h)) return Object.fromEntries(h);
-    return h;
-  };
-  return servingFetch<CreateServingAttachmentUploadResponse>(
-    getCreateServingAttachmentUploadUrl(),
-    {
-      ...options,
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...getHeaders(options?.headers),
-      },
-      body: JSON.stringify(createServingAttachmentUploadRequest),
-    },
-  );
-};
-
-export const getFinalizeServingAttachmentUrl = (attachmentId: string) => {
-  return `/serving/v1/assistant-attachments/${attachmentId}/finalize`;
-};
-
-/**
- * Step two, after the PUT: verify the object arrived, sniff what it
- * actually is, enforce its kind's size cap, flip the row ready.
- * Idempotent — a replayed finalize reads the settled row back.
- * @summary Finalize Serving Attachment
- */
-export const finalizeServingAttachment = async (
-  attachmentId: string,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<ServingAttachmentResponse> => {
-  return servingFetch<ServingAttachmentResponse>(
-    getFinalizeServingAttachmentUrl(attachmentId),
-    {
-      ...options,
-      method: "POST",
-    },
-  );
-};
-
-export const getGetServingAttachmentDownloadUrlUrl = (attachmentId: string) => {
-  return `/serving/v1/assistant-attachments/${attachmentId}/download-url`;
-};
-
-/**
- * The render-time exchange, owner-scoped exactly like the threads:
- * the visitor reads their own uploads and the attachments of
- * conversations they may open — an identified visitor their vouched
- * threads', an anonymous visitor unowned same-org threads' (knowledge
- * of the id is the capability). Everything else answers the one 404.
- * @summary Get Serving Attachment Download Url
- */
-export const getServingAttachmentDownloadUrl = async (
-  attachmentId: string,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<ServingAttachmentDownloadUrlResponse> => {
-  return servingFetch<ServingAttachmentDownloadUrlResponse>(
-    getGetServingAttachmentDownloadUrlUrl(attachmentId),
-    {
-      ...options,
-      method: "GET",
-    },
-  );
-};
-
-export const getListServingSubscriptionsUrl = () => {
-  return `/serving/v1/subscriptions`;
-};
-
-/**
- * Every provider's standing for this visitor — the connect panel's
- * one read. Reports the offered axis rather than refusing on it: the
- * panel needs "not offered" as a fact, not an error.
- * @summary List Serving Subscriptions
- */
-export const listServingSubscriptions = async (
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<ServingSubscriptionsResponse> => {
-  return servingFetch<ServingSubscriptionsResponse>(
-    getListServingSubscriptionsUrl(),
-    {
-      ...options,
-      method: "GET",
-    },
-  );
-};
-
-export const getCreateDeviceAuthorizationUrl = (
-  provider: SubscriptionProvider,
-) => {
-  return `/serving/v1/subscriptions/${provider}/device-authorizations`;
-};
-
-/**
- * Begin one device authorization: mint the provider's user code and
- * hand the flow back as a sealed handle. Nothing is stored — an
- * abandoned flow costs nothing and expires inside its own handle.
- * @summary Create Device Authorization
- */
-export const createDeviceAuthorization = async (
-  provider: SubscriptionProvider,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<CreateDeviceAuthorizationResponse> => {
-  return servingFetch<CreateDeviceAuthorizationResponse>(
-    getCreateDeviceAuthorizationUrl(provider),
-    {
-      ...options,
-      method: "POST",
-    },
-  );
-};
-
-export const getPollDeviceAuthorizationUrl = (
-  provider: SubscriptionProvider,
-) => {
-  return `/serving/v1/subscriptions/${provider}/device-authorizations/poll`;
-};
-
-/**
- * One poll of the provider's token door. On approval this is the
- * moment the credential is born: seal, store VERIFYING, start the
- * probe — the raw tokens exist in this process only for the duration
- * of the seal (billing's paste door is the sibling).
- * @summary Poll Device Authorization
- */
-export const pollDeviceAuthorization = async (
-  provider: SubscriptionProvider,
-  pollDeviceAuthorizationRequest: PollDeviceAuthorizationRequest,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<PollDeviceAuthorizationResponse> => {
-  const getHeaders = (
-    h?: NonNullable<RequestInit["headers"]>,
-  ): Record<string, string | readonly string[]> => {
-    if (!h) return {};
-    if (h instanceof Headers) return Object.fromEntries(h.entries());
-    if (Array.isArray(h)) return Object.fromEntries(h);
-    return h;
-  };
-  return servingFetch<PollDeviceAuthorizationResponse>(
-    getPollDeviceAuthorizationUrl(provider),
-    {
-      ...options,
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...getHeaders(options?.headers),
-      },
-      body: JSON.stringify(pollDeviceAuthorizationRequest),
-    },
-  );
-};
-
-export const getDisconnectSubscriptionUrl = (
-  provider: SubscriptionProvider,
-) => {
-  return `/serving/v1/subscriptions/${provider}`;
-};
-
-/**
- * Disconnects entirely — the row goes, no sealed token set lingers.
- * Deliberately no offered check: an org withdrawing the offer must
- * never strand a visitor's stored credential.
- * @summary Disconnect Subscription
- */
-export const disconnectSubscription = async (
-  provider: SubscriptionProvider,
-  options?: Parameters<typeof servingFetch>[1],
-): Promise<void> => {
-  return servingFetch<void>(getDisconnectSubscriptionUrl(provider), {
-    ...options,
-    method: "DELETE",
-  });
-};