@teaflask/assistant 0.0.0 → 0.3.0

package/src/generated/models/index.ts

@@ -0,0 +1,173 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+export * from "./activityMessage.js";
+export * from "./activityMessageContent.js";
+export * from "./activityMessageMetadata.js";
+export * from "./agentDispatchStatus.js";
+export * from "./apiErrorBody.js";
+export * from "./apiErrorCode.js";
+export * from "./approvalRequestedMarker.js";
+export * from "./approvalRequestedMarkerToolArgs.js";
+export * from "./approvalRequestedMarkerToolInputSchema.js";
+export * from "./approvalRequestedMarkerToolOutputSchema.js";
+export * from "./approvalResolvedMarker.js";
+export * from "./askQuestionsAction.js";
+export * from "./askQuestionsResult.js";
+export * from "./assistantConfigResponse.js";
+export * from "./assistantMessage.js";
+export * from "./assistantMessageMetadata.js";
+export * from "./assistantStreamMarkerName.js";
+export * from "./assistantTurnKind.js";
+export * from "./assistantTurnStatus.js";
+export * from "./attachmentKind.js";
+export * from "./attachmentPolicyResponse.js";
+export * from "./audioInputContent.js";
+export * from "./audioPart.js";
+export * from "./binaryInputContent.js";
+export * from "./connectProjectionResponse.js";
+export * from "./connectProjectionResponseGate.js";
+export * from "./connectProjectionResponseReason.js";
+export * from "./context.js";
+export * from "./createDeviceAuthorizationResponse.js";
+export * from "./createServingAttachmentUploadRequest.js";
+export * from "./createServingAttachmentUploadResponse.js";
+export * from "./currentVisitorResponse.js";
+export * from "./dataSource.js";
+export * from "./deliveredSubagentResult.js";
+export * from "./developerMessage.js";
+export * from "./developerMessageMetadata.js";
+export * from "./docHeading.js";
+export * from "./docHeadingLevel.js";
+export * from "./documentInputContent.js";
+export * from "./documentPart.js";
+export * from "./endUserIdentity.js";
+export * from "./errorEnvelope.js";
+export * from "./evidenceAfterVoidRecordedMarker.js";
+export * from "./evidenceAfterVoidRecordedMarkerError.js";
+export * from "./evidenceAfterVoidRecordedMarkerResult.js";
+export * from "./fileSource.js";
+export * from "./functionCall.js";
+export * from "./getServingAssistantThreadParams.js";
+export * from "./helpHostResolution.js";
+export * from "./helpPageResponse.js";
+export * from "./helpSearchHit.js";
+export * from "./helpSearchMode.js";
+export * from "./helpSearchResponse.js";
+export * from "./helpSiteGroup.js";
+export * from "./helpSitePage.js";
+export * from "./helpSiteResponse.js";
+export * from "./helpSiteTab.js";
+export * from "./highlightResult.js";
+export * from "./httpIntentResult.js";
+export * from "./httpIntentResultHeaders.js";
+export * from "./imageInputContent.js";
+export * from "./imagePart.js";
+export * from "./inputContentDataSource.js";
+export * from "./inputContentUrlSource.js";
+export * from "./interruptAnswerConsumedMarker.js";
+export * from "./interruptAnswerConsumedMarkerFamily.js";
+export * from "./listServingAssistantThreadsParams.js";
+export * from "./memoryUpdatedMarker.js";
+export * from "./mintVisitorTokenRequest.js";
+export * from "./mintVisitorTokenResponse.js";
+export * from "./modelChoiceOption.js";
+export * from "./modelChoiceResponse.js";
+export * from "./modelPickRequest.js";
+export * from "./navigateResult.js";
+export * from "./pollDeviceAuthorizationRequest.js";
+export * from "./pollDeviceAuthorizationResponse.js";
+export * from "./prefillFormResult.js";
+export * from "./publishableKeyMode.js";
+export * from "./question.js";
+export * from "./questionAnswer.js";
+export * from "./questionOption.js";
+export * from "./readPageResult.js";
+export * from "./reasoningMessage.js";
+export * from "./reasoningMessageMetadata.js";
+export * from "./refusedField.js";
+export * from "./resolvedLanding.js";
+export * from "./resolvedLandingCard.js";
+export * from "./resolveServingTurnApprovalRequest.js";
+export * from "./resolveServingTurnApprovalResponse.js";
+export * from "./resolveServingTurnToolResultsRequest.js";
+export * from "./resolveServingTurnToolResultsResponse.js";
+export * from "./resumeEntry.js";
+export * from "./resumeEntryMetadata.js";
+export * from "./resumeEntryStatus.js";
+export * from "./routeSuggestions.js";
+export * from "./runAgentInput.js";
+export * from "./runResumedMarker.js";
+export * from "./sectionProvenance.js";
+export * from "./sectionProvenanceState.js";
+export * from "./sendServingAssistantMessageRequest.js";
+export * from "./sendServingAssistantMessageResponse.js";
+export * from "./servingAgentDispatchResponse.js";
+export * from "./servingApprovalDelivery.js";
+export * from "./servingAssistantThreadDetailResponse.js";
+export * from "./servingAssistantThreadResponse.js";
+export * from "./servingAssistantTurnResponse.js";
+export * from "./servingAssistantTurnResponsePendingApprovalDisplays.js";
+export * from "./servingAttachmentDownloadUrlResponse.js";
+export * from "./servingAttachmentResponse.js";
+export * from "./servingCoworkerApprovalRequest.js";
+export * from "./servingCoworkerExecutionRequest.js";
+export * from "./servingDeviceAuthorizationStatus.js";
+export * from "./servingErrorCode.js";
+export * from "./servingStopDelivery.js";
+export * from "./servingSubscriptionsResponse.js";
+export * from "./servingSubscriptionStatus.js";
+export * from "./servingSubscriptionStatusBounceCause.js";
+export * from "./servingToolResultDelivery.js";
+export * from "./servingToolResultReport.js";
+export * from "./servingToolResultReportError.js";
+export * from "./servingToolResultReportResult.js";
+export * from "./servingTurnApprovalDecision.js";
+export * from "./servingTurnAttachmentResponse.js";
+export * from "./siteTheme.js";
+export * from "./siteThemeDefaultAppearance.js";
+export * from "./steeringFiredAction.js";
+export * from "./steeringFiredMarker.js";
+export * from "./stopServingTurnResponse.js";
+export * from "./subagentResultsDeliveredMarker.js";
+export * from "./subscriptionCredentialState.js";
+export * from "./subscriptionProvider.js";
+export * from "./suggestionItem.js";
+export * from "./suggestionKind.js";
+export * from "./suggestionsConfig.js";
+export * from "./systemMessage.js";
+export * from "./systemMessageMetadata.js";
+export * from "./textInputContent.js";
+export * from "./textPart.js";
+export * from "./thinkingEffort.js";
+export * from "./threadModelPickResponse.js";
+export * from "./tool.js";
+export * from "./toolCall.js";
+export * from "./toolCallAnnotatedMarker.js";
+export * from "./toolCallAnnotatedMarkerToolInputSchema.js";
+export * from "./toolCallAnnotatedMarkerToolOutputSchema.js";
+export * from "./toolCallDisplayPayload.js";
+export * from "./toolCallMetadata.js";
+export * from "./toolExecutionRequestedMarker.js";
+export * from "./toolExecutionRequestPayload.js";
+export * from "./toolExecutionRequestPayloadAction.js";
+export * from "./toolExecutionRequestPayloadIntent.js";
+export * from "./toolMessage.js";
+export * from "./toolMessageMetadata.js";
+export * from "./toolMetadata.js";
+export * from "./toolResultRecordedMarker.js";
+export * from "./toolViewRef.js";
+export * from "./turnFailedMarker.js";
+export * from "./turnStoppedMarker.js";
+export * from "./turnUsageRecordedMarker.js";
+export * from "./turnVoidedMarker.js";
+export * from "./urlSource.js";
+export * from "./userMessage.js";
+export * from "./userMessageMetadata.js";
+export * from "./videoInputContent.js";
+export * from "./videoPart.js";
+export * from "./visitorTier.js";

package/src/generated/models/inputContentDataSource.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+/**
+ * Bytes carried inline, under the published name.
+ */
+export interface InputContentDataSource {
+  type?: "data";
+  value: string;
+  mimeType: string;
+  [key: string]: unknown;
+}

package/src/generated/models/inputContentUrlSource.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+/**
+ * A fetchable location, under the published name.
+ */
+export interface InputContentUrlSource {
+  type?: "url";
+  value: string;
+  mimeType?: string | null;
+  [key: string]: unknown;
+}

package/src/generated/models/interruptAnswerConsumedMarker.ts

@@ -0,0 +1,27 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { InterruptAnswerConsumedMarkerFamily } from "./interruptAnswerConsumedMarkerFamily.js";
+
+/**
+ * The interrupt_answer_consumed CUSTOM event's value payload — the
+ * CONSUMPTION shape, one of TWO shapes riding this marker name,
+ * discriminated by the presence of ``shape``: the doors' RECORDED row
+ * carries ``shape`` and NO top-level ``round``, so a reader keying on the
+ * fields below must skip rows carrying ``shape``. ``interrupt_id`` is the
+ * pause interrupt whose answer was consumed; ``round`` is the loop round
+ * of that PAUSE (== the ``round`` on its request cards == the serving
+ * ``awaiting_round`` while it stood); ``family`` is which answer family
+ * was consumed, ``approval`` or ``tool_result``. Identity is the set key
+ * ``(run_id, round, interrupt_id)``; written on every consuming attempt,
+ * so duplicates are legal and meaningless — readers MUST fold into a set,
+ * never count.
+ */
+export interface InterruptAnswerConsumedMarker {
+  interrupt_id: string;
+  round: number;
+  family: InterruptAnswerConsumedMarkerFamily;
+}

package/src/generated/models/interruptAnswerConsumedMarkerFamily.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+export type InterruptAnswerConsumedMarkerFamily =
+  (typeof InterruptAnswerConsumedMarkerFamily)[keyof typeof InterruptAnswerConsumedMarkerFamily];
+
+export const InterruptAnswerConsumedMarkerFamily = {
+  approval: "approval",
+  tool_result: "tool_result",
+} as const;

package/src/generated/models/listServingAssistantThreadsParams.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+export type ListServingAssistantThreadsParams = {
+  before_updated_at?: string | null;
+  before_id?: string | null;
+  /**
+   * @minimum 1
+   * @maximum 200
+   */
+  limit?: number;
+};

package/src/generated/models/memoryUpdatedMarker.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+/**
+ * The memory_updated CUSTOM event's value payload. End-user safe by
+ * construction: the durable memory id (the dedupe identity replay
+ * reconciles by), the scope as an open vocabulary ("org", "user"; clients
+ * render unknown tokens with the generic destination), and a canned
+ * sentence. Never the memory's content, embeddings, or any prompt.
+ */
+export interface MemoryUpdatedMarker {
+  memory_id: string;
+  scope: string;
+  summary: string;
+}

package/src/generated/models/mintVisitorTokenRequest.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+export interface MintVisitorTokenRequest {
+  publishable_key: string;
+  end_user_token?: string | null;
+  claim_thread_id?: string | null;
+}

package/src/generated/models/mintVisitorTokenResponse.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { VisitorTier } from "./visitorTier.js";
+
+export interface MintVisitorTokenResponse {
+  visitor_token: string;
+  expires_in: number;
+  tier: VisitorTier;
+}

package/src/generated/models/modelChoiceOption.ts

@@ -0,0 +1,21 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { ThinkingEffort } from "./thinkingEffort.js";
+
+/**
+ * One pickable model. Display names ride the wire — the widget has
+ * no catalog of its own, and must render what the wire names. efforts
+ * is THIS model's supported set, in ladder order: exactly the
+ * levels the resolve serves unclamped, so the menu never offers a level
+ * the door's validator would refuse (menu ⊆ pickable).
+ */
+export interface ModelChoiceOption {
+  id: string;
+  display_name: string;
+  provider_display_name: string;
+  efforts: ThinkingEffort[];
+}

package/src/generated/models/modelChoiceResponse.ts

@@ -0,0 +1,34 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { ModelChoiceOption } from "./modelChoiceOption.js";
+import type { ThinkingEffort } from "./thinkingEffort.js";
+
+/**
+ * The composer's picker menu: the pickable models in the config's
+ * routing order — each carrying its OWN effort ladder — and the config's
+ * defaults. The root efforts is the stale-widget ladder: the
+ * intersection of the offered options' sets, superseded by the
+ * per-option sets and kept because the serving wire evolves
+ * additively only. default_effort is that one-ladder client's
+ * compatibility value: always a member of the root ladder (clamped,
+ * nearest/ties-down) so a root-only client preselects a value it can
+ * show — the two fields may never disagree. configured_effort is the
+ * truth: the config's effort VERBATIM, unclamped — a
+ * per-option-aware client preselects it, clamping only into the SELECTED
+ * model's own ladder, so a config tuned above the root intersection is
+ * never understated; None means the config sends no thinking
+ * (default_effort is then None too, and also when the root ladder is
+ * empty). Clients MUST tolerate unknown model ids and effort values —
+ * render what the wire names.
+ */
+export interface ModelChoiceResponse {
+  models: ModelChoiceOption[];
+  efforts: ThinkingEffort[];
+  default_model_id: string;
+  default_effort: ThinkingEffort | null;
+  configured_effort: ThinkingEffort | null;
+}

package/src/generated/models/modelPickRequest.ts

@@ -0,0 +1,25 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { ThinkingEffort } from "./thinkingEffort.js";
+
+/**
+ * The set-pick write, riding the send: absent (or null)
+ * keeps the thread's current pick, a present object sets exactly this.
+ * NULL model_id means no model pin — the configured model answers and
+ * keeps following operator changes — so an effort-only choice never
+ * pins a model, and {model_id: null, effort: null} is the honest
+ * clear; a pick naming the configured model is normalized to the same
+ * no-pin. model_id is otherwise a plain string, deliberately not the
+ * catalog enum — a delisted id from a stale client must not 422; the
+ * door validates leniently and drops what the config rejects, and the
+ * runtime clears any stale stored pick. NULL effort means the config's
+ * own thinking answers.
+ */
+export interface ModelPickRequest {
+  model_id?: string | null;
+  effort?: ThinkingEffort | null;
+}

package/src/generated/models/navigateResult.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+/**
+ * What the client reports back from executing a navigate request:
+ * whether the browser actually moved, and the path it landed on.
+ */
+export interface NavigateResult {
+  navigated: boolean;
+  path: string;
+}

package/src/generated/models/pollDeviceAuthorizationRequest.ts

@@ -0,0 +1,10 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+export interface PollDeviceAuthorizationRequest {
+  sealed_authorization: string;
+}

package/src/generated/models/pollDeviceAuthorizationResponse.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { ServingDeviceAuthorizationStatus } from "./servingDeviceAuthorizationStatus.js";
+
+/**
+ * One poll's answer. On pending, interval is the seconds the widget
+ * must wait before the next poll — the server absorbs the provider's
+ * slow-down semantics here, so clients only ever obey interval. On
+ * complete, interval is null and the credential is saved VERIFYING
+ * with its probe underway.
+ */
+export interface PollDeviceAuthorizationResponse {
+  status: ServingDeviceAuthorizationStatus;
+  interval: number | null;
+}

package/src/generated/models/prefillFormResult.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { RefusedField } from "./refusedField.js";
+
+/**
+ * The client's report from a prefill_form request: which refs were
+ * filled and which refused, field by field. Filling is all the client
+ * ever does — submitting stays with the human.
+ */
+export interface PrefillFormResult {
+  filled: string[];
+  refused: RefusedField[];
+}

package/src/generated/models/publishableKeyMode.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+export type PublishableKeyMode =
+  (typeof PublishableKeyMode)[keyof typeof PublishableKeyMode];
+
+export const PublishableKeyMode = {
+  live: "live",
+  test: "test",
+} as const;

package/src/generated/models/question.ts

@@ -0,0 +1,33 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { QuestionOption } from "./questionOption.js";
+
+/**
+ * One question of the set: its stable id (the answer's key), the
+ * short heading the panel shows top-left, the question itself, and the
+ * suggestions the panel numbers.
+ */
+export interface Question {
+  /**
+   * @minLength 1
+   * @maxLength 40
+   * @pattern ^[A-Za-z0-9_-]+$
+   */
+  id: string;
+  /**
+   * @minLength 1
+   * @maxLength 60
+   */
+  heading: string;
+  /**
+   * @minLength 1
+   * @maxLength 500
+   */
+  prompt: string;
+  /** @maxItems 8 */
+  options?: QuestionOption[];
+}

package/src/generated/models/questionAnswer.ts

@@ -0,0 +1,18 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+/**
+ * One answer in a question set's report: the question's own id and
+ * the member's text — a chosen suggestion's visible text or their own
+ * words, verbatim (line breaks included). The bound is transport, not
+ * content: nothing here judges what the text says.
+ */
+export interface QuestionAnswer {
+  id: string;
+  /** @maxLength 1900 */
+  text: string;
+}

package/src/generated/models/questionOption.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+/**
+ * One suggested answer: the visible text (which IS the answer when
+ * chosen) and an optional description the panel reveals on request.
+ */
+export interface QuestionOption {
+  /**
+   * @minLength 1
+   * @maxLength 120
+   */
+  text: string;
+  description?: string | null;
+}

package/src/generated/models/readPageResult.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+/**
+ * The client's report from a read_page request: the page's identity
+ * and its accessibility-tree snapshot. content is the snapshot text — or,
+ * when is_diff, a unified diff against the previous read (empty means
+ * unchanged). truncated says the client degraded the tree to fit the cap.
+ */
+export interface ReadPageResult {
+  url: string;
+  title: string;
+  content: string;
+  is_diff: boolean;
+  truncated: boolean;
+}

package/src/generated/models/reasoningMessage.ts

@@ -0,0 +1,21 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { ReasoningMessageMetadata } from "./reasoningMessageMetadata.js";
+
+/**
+ * A span of the agent's reasoning, materialised as a message. Stands alone
+ * rather than composing BaseMessage, because it carries no name.
+ */
+export interface ReasoningMessage {
+  subagentRunId?: string | null;
+  id: string;
+  role?: "reasoning";
+  content: string;
+  encryptedValue?: string | null;
+  metadata?: ReasoningMessageMetadata;
+  [key: string]: unknown;
+}

package/src/generated/models/reasoningMessageMetadata.ts

@@ -0,0 +1,8 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+export type ReasoningMessageMetadata = { [key: string]: unknown } | null;

package/src/generated/models/refusedField.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+
+/**
+ * One field a prefill request could not fill, and the client's own
+ * sentence saying why — canned prose, never customer content.
+ */
+export interface RefusedField {
+  ref_id: string;
+  reason: string;
+}

package/src/generated/models/resolveServingTurnApprovalRequest.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { ServingTurnApprovalDecision } from "./servingTurnApprovalDecision.js";
+
+export interface ResolveServingTurnApprovalRequest {
+  /** @minItems 1 */
+  approvals: ServingTurnApprovalDecision[];
+}

package/src/generated/models/resolveServingTurnApprovalResponse.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { ServingApprovalDelivery } from "./servingApprovalDelivery.js";
+import type { ServingAssistantTurnResponse } from "./servingAssistantTurnResponse.js";
+
+export interface ResolveServingTurnApprovalResponse {
+  delivery: ServingApprovalDelivery;
+  turn: ServingAssistantTurnResponse;
+}

package/src/generated/models/resolveServingTurnToolResultsRequest.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * teaflask-serving
+ * OpenAPI spec version: 1
+ */
+import type { ServingToolResultReport } from "./servingToolResultReport.js";
+
+export interface ResolveServingTurnToolResultsRequest {
+  /** @minItems 1 */
+  results: ServingToolResultReport[];
+}