@relaymessenger/sdk 0.3.7-staging.8 → 0.4.0-staging.0

package/dist/types.d.ts

@@ -17,6 +17,14 @@ export interface CallContact {
      * Timestamps stay in UTC; use this to read them in the person's local time.
      */
     timezone?: string | null;
+    /**
+     * People only: The person's age range, as their Relay app last reported it: from Apple's
+     * Declared Age Range, or from a birth year the person gave once (only the
+     * range is kept). Null until the app reports one. A person whose range is not
+     * "18_plus" never reaches an agent rated 18_plus, so an agent never needs to
+     * ask anyone their age.
+     */
+    age_range?: AgeRange | null;
 }
 export type CallTerminalStatus = "completed" | "no-answer" | "canceled" | "busy" | "failed";
 export interface Call {
@@ -360,6 +368,14 @@ export interface UserChatHandle extends ChatHandleBase {
      * stay in UTC; use this to read them in the person's local time.
      */
     timezone?: string | null;
+    /**
+     * The person's age range, as their Relay app last reported it: from Apple's
+     * Declared Age Range, or from a birth year the person gave once (only the
+     * range is kept). Null until the app reports one. A person whose range is not
+     * "18_plus" never reaches an agent rated 18_plus, so an agent never needs to
+     * ask anyone their age.
+     */
+    age_range?: AgeRange | null;
 }
 /** Who owns an agent: its organization, or the person who owns it. */
 export type HandleOwner = {
@@ -381,6 +397,14 @@ export type HandleOwner = {
      * they used last sets it.
      */
     timezone?: string | null;
+    /**
+     * Null when the person has no Relay account. The person's age range, as their Relay app last reported it: from Apple's
+     * Declared Age Range, or from a birth year the person gave once (only the
+     * range is kept). Null until the app reports one. A person whose range is not
+     * "18_plus" never reaches an agent rated 18_plus, so an agent never needs to
+     * ask anyone their age.
+     */
+    age_range?: AgeRange | null;
 };
 export interface AgentChatHandle extends ChatHandleBase {
     kind: "agent";
@@ -430,47 +454,89 @@ export interface ButtonsPart {
     type: "buttons";
     items: ButtonItem[];
 }
-/** Stable machine value and independently editable visible label. */
-export interface SelectionOption {
-    /** Unique case-sensitive ASCII token, 1–100 characters. Never derived from label. */
+/** Stable row identifier, never derived from the visible label. */
+export type SelectionOption = {
+    /** 1–24 characters with id; legacy value-only labels allow 1–80. */
+    label: string;
+    /** Optional row description, 0–72 characters. */
+    subtitle?: string;
+    /** HTTPS row image, at most 2048 characters. */
+    image_url?: string;
+} & ({
+    id: string;
+    value?: string;
+} | {
+    id?: never;
+    value: string;
+});
+/** Normalized response aliases are equal; stored legacy labels may have 80 characters. */
+export interface SelectionOptionResponse {
+    id: string;
     value: string;
-    /** Trimmed visible label, 1–80 characters. */
     label: string;
+    subtitle?: string;
+    image_url?: string;
 }
-/** Agent-only, 1–25 options; one per Message, never with buttons. A text part is optional and shows as an ordinary bubble above the card. */
-export interface SelectionPart {
-    type: "selection";
-    /** The question: the card's title in the chat and the sheet's title. Trimmed, 1–60 characters. */
+export interface SelectionSection {
+    /** Trimmed section heading, 1–24 characters. */
     title: string;
-    /** The person checks any number of options and submits them once; checking sends nothing. */
     options: SelectionOption[];
 }
-export interface SelectionPartResponse extends SelectionPart {
-    /** Durable response state for this viewer across devices. Existing Chat rules allow at most one human user; only that user can respond, once; reopening an answered selection shows what they chose without letting them change it. */
+export interface SelectionSectionResponse {
+    title: string;
+    options: SelectionOptionResponse[];
+}
+/** Source-owned answered-bubble text; does not replace portable selected-label text. */
+export interface SelectionReplyMessage {
+    /** Trimmed text, 1–512 characters. */
+    title: string;
+    /** Trimmed text, 0–512 characters. */
+    subtitle?: string;
+}
+interface SelectionPresentation {
+    type: "selection";
+    /** The question: trimmed, 1–60 characters. */
+    title: string;
+    /** Card second line, trimmed, 0–512 characters. */
+    subtitle?: string;
+    /** Defaults to true when omitted. False permits exactly one chosen option. */
+    multiple?: boolean;
+    reply_message?: SelectionReplyMessage;
+}
+/** Agent-only; exactly one of options or sections, 1–25 total options, up to 10 sections. */
+export type SelectionPart = SelectionPresentation & ({
+    options: SelectionOption[];
+    sections?: never;
+} | {
+    sections: SelectionSection[];
+    options?: never;
+});
+export interface SelectionPartResponse extends SelectionPresentation {
+    /** All rows in display order, retained for old clients even when sections are supplied. */
+    options: SelectionOptionResponse[];
+    sections?: SelectionSectionResponse[];
+    /** Durable viewer state; a user answers once. */
     readonly has_responded: boolean;
-    /** The values the authenticated viewer chose, in source-option order, identical on every one of that user's devices; null until the viewer answers, when the answer Message no longer exists, and always for an agent viewer. */
+    /** Viewer-scoped; null before answering, after answer deletion, and for agents. */
     readonly selected_values: string[] | null;
+    /** Equal to selected_values, including for legacy options. */
+    readonly selected_ids: string[] | null;
     reactions: null;
 }
-/**
- * User-only metadata after canonical text (literal '• ' + each source
- * label, joined with '\n'), with explicit reply_to. Exact legacy comma-joined
- * labels are accepted by the server only for compatibility, never parsed for IDs.
- */
+/** User-only metadata after canonical bullet text, with explicit reply_to. */
 export interface SelectionResponsePart {
     type: "selection_response";
-    /**
-     * Unique known values, nonempty and in source-option order, authoritative with
-     * reply_to. New preceding text is literal '• ' + each source label joined with
-     * '\n'. The server accepts exact legacy comma-joined labels for compatibility
-     * only, never arbitrary label parsing. iOS may draw a checkmark in place of
-     * each bullet and repeat the prompt's title, as presentation only; portable
-     * text remains bullets.
-     */
+    /** Unique known identifiers (1–200 characters), in source-option order. */
     selected_values: string[];
+    /** When supplied, must equal selected_values in the same order. */
+    selected_ids?: string[];
 }
 /** Metadata only: contributes no visible fallback text. */
 export interface SelectionResponsePartResponse extends SelectionResponsePart {
+    /** Source-derived, including for replies sent by legacy clients. */
+    readonly selected_ids: string[];
+    /** Copied by the server from the prompt, never supplied by the replying client. */
+    readonly reply_message?: SelectionReplyMessage;
 }
 /** A card's picture or video, a public https URL, drawn full width at `height` (short 112, medium 168, tall 264 pt). */
 export interface RichCardMedia {
@@ -538,7 +604,7 @@ export interface RichCardPartResponse extends RichCardPart {
 /** Agent-only: 2–10 cards swiped sideways, each as tall as the tallest. Reply ids are unique across cards. */
 export interface CarouselPart {
     type: "carousel";
-    /** small is 180 pt, medium (the default) 296 pt. */
+    /** small is 180 pt; medium (the default) is as wide as a single card, up to 350 pt. */
     card_width?: "small" | "medium";
     cards: CardContent[];
 }
@@ -812,8 +878,7 @@ export type A2uiClientToServerMessage = A2uiActionMessage | A2uiErrorMessage;
 /** Any A2UI v0.9.1 message a data part may carry. */
 export type A2uiMessage = A2uiServerToClientMessage | A2uiClientToServerMessage;
 /**
- * A data part holding A2UI v0.9.1 messages, in order: Relay's REST shape of
- * A2A's DataPart. A Message may carry any number of data parts beside its
+ * A data part holding A2UI v0.9.1 messages, in order. A Message may carry any number of data parts beside its
  * other parts. Relay applies each A2UI message on its own, checked against
  * A2UI's schemas and the surface's catalog: the ones that fail come back in
  * the response's `a2ui_errors`, and a send that applies nothing is refused
@@ -856,7 +921,7 @@ export interface A2uiClientCapabilities {
     };
 }
 /**
- * A2A Message metadata. A tap on a surface that set `sendDataModel` carries
+ * Message metadata. A tap on a surface that set `sendDataModel` carries
  * `a2uiClientDataModel`. Each surface's data model reaches only the sender and
  * the agent that created that surface, unchanged.
  */
@@ -910,6 +975,14 @@ export interface SystemEventParty {
      * Timestamps stay in UTC; use this to read them in the person's local time.
      */
     timezone?: string | null;
+    /**
+     * People only: The person's age range, as their Relay app last reported it: from Apple's
+     * Declared Age Range, or from a birth year the person gave once (only the
+     * range is kept). Null until the app reports one. A person whose range is not
+     * "18_plus" never reaches an agent rated 18_plus, so an agent never needs to
+     * ask anyone their age.
+     */
+    age_range?: AgeRange | null;
 }
 export type TypingContact = SystemEventParty;
 export interface TypingIndicatorWebhookData {
@@ -926,9 +999,16 @@ export interface CallMarker {
     to: [CallContact];
     duration_seconds: number | null;
 }
+/** Who did it, with the name and picture a client shows beside the event. */
+export interface SystemEventActor extends SystemEventParty {
+    /** First and last name joined by a space; empty when the Contact has none. */
+    display_name: string;
+    image_url: string | null;
+    image_color: string | null;
+}
 export interface SystemEvent {
     type: SystemEventType;
-    actor: SystemEventParty;
+    actor: SystemEventActor;
     subject: SystemEventParty | null;
     value: string | null;
     icon_attachment_id: UUID | null;
@@ -952,7 +1032,7 @@ export interface MessageContent {
     parts: MessagePart[];
     reply_to?: ReplyTo;
     /**
-     * A2A Message metadata. A tap (an A2UI `action`) on a surface that set
+     * Message metadata. A tap (an A2UI `action`) on a surface that set
      * `sendDataModel` must carry `a2uiClientDataModel`.
      */
     metadata?: MessageMetadata;
@@ -1056,6 +1136,19 @@ export interface ChatCreateResponse {
         message: SentMessage;
     };
 }
+/** Omit handle to share the authenticated agent's own card. */
+export interface ChatShareContactCardParams {
+    /**
+     * The agent to recommend, trimmed and lowercased by the Server. It must be
+     * active, Public or Unlisted, and let people message it; anything else is
+     * the same 404 as an unknown handle.
+     */
+    handle?: string;
+}
+export interface ChatShareContactCardOptions extends RequestOptions {
+    /** 1 to 255 characters. The same key and body replay with nothing shared; another body is 409. */
+    idempotencyKey?: string;
+}
 export interface ChatUpdateParams {
     display_name?: string;
     /**
@@ -1247,7 +1340,18 @@ export type AgentCategory = "productivity" | "business" | "finance" | "shopping"
  * agents answer by handle only.
  */
 export type AgentVisibility = "public" | "unlisted";
-/** One thing the agent does, in the A2A AgentSkill shape. */
+/**
+ * A person's age range: the bands Apple's Declared Age Range answers for the
+ * age gates 13, 16 and 18.
+ */
+export type AgeRange = "under_13" | "13_15" | "16_17" | "18_plus";
+/**
+ * Who an agent is for, set in the Relay Console. Relay refuses an 18_plus
+ * agent to every person whose age range is not 18_plus (error code 2035) and
+ * leaves it out of their directory, search and suggestions.
+ */
+export type AgentAgeRating = "everyone" | "18_plus";
+/** One thing the agent does. */
 export interface AgentSkill {
     id: string;
     name: string;
@@ -1255,6 +1359,46 @@ export interface AgentSkill {
     tags: string[];
     examples: string[];
 }
+export interface DirectorySearchParams {
+    q?: string;
+    category?: AgentCategory;
+    limit?: number;
+    sort?: "name" | "newest";
+}
+export interface AgentMetrics {
+    chats_people: number;
+    chats_agents: number;
+    chats_people_30d: number;
+    chats_agents_30d: number;
+    reply_rate_30d: number | null;
+    reply_minutes_30d: number | null;
+    messages_total: number;
+    since: string;
+}
+export interface AgentRatingAverage {
+    average: number | null;
+    count: number;
+}
+export interface DirectoryAgent {
+    handle: string;
+    name: string;
+    subtitle: string | null;
+    category: AgentCategory;
+    image_url: string | null;
+    image_color: string | null;
+    accent_color: string | null;
+    verified: boolean;
+    provider: {
+        name: string | null;
+        url: string | null;
+        verified: boolean;
+    };
+    metrics: AgentMetrics;
+    rating: AgentRatingAverage;
+}
+export interface DirectorySearchResponse {
+    agents: DirectoryAgent[];
+}
 export interface ContactLookup {
     id: UUID;
     handle: string;
@@ -1292,6 +1436,16 @@ export interface ContactLookup {
      * stay in UTC; use this to read them in the person's local time.
      */
     timezone?: string | null;
+    /**
+     * People only: The person's age range, as their Relay app last reported it: from Apple's
+     * Declared Age Range, or from a birth year the person gave once (only the
+     * range is kept). Null until the app reports one. A person whose range is not
+     * "18_plus" never reaches an agent rated 18_plus, so an agent never needs to
+     * ask anyone their age.
+     */
+    age_range?: AgeRange | null;
+    /** Who the agent is for: everyone, or only people whose age range is 18_plus. Agents only. */
+    age_rating?: AgentAgeRating;
 }
 /** The organization that made an agent. */
 export interface AgentCreator {
@@ -1309,6 +1463,10 @@ export type ContactLookupParams =
 {
     handle: string;
 }
+/** Contact id, such as a shared Contact Card's id; its handle may since have changed. */
+ | {
+    id: UUID;
+}
 /** What you need done, in plain words; at most 200 characters. */
  | {
     task: string;
@@ -1324,6 +1482,18 @@ export type ContactLookupResponse = {
     contacts: ContactLookup[];
 };
 export interface ContactCardItem {
+    /**
+     * The shared agent's Contact id, only on a card shared by handle. Open the
+     * agent by this id (`contacts.lookup({ id })`); the handle may since have changed.
+     */
+    id?: UUID;
+    /** The shared agent's subtitle when it was shared, only on a card shared by handle. */
+    subtitle?: string | null;
+    /**
+     * Relay link that opens the shared agent's chat, only on a card shared by
+     * handle. Such a card is a snapshot taken when it was shared and never changes.
+     */
+    url?: string;
     /** Detailed agent description, up to 2000 characters. Public agents cannot clear it. */
     description?: string | null;
     handle: string;
@@ -1392,6 +1562,27 @@ export type AgentAccessRule = "allow" | "deny";
  * owner set for people and other agents; a contact on Never Allow may not.
  * The agent's owner is always allowed and is on neither list.
  */
+/** "Log in with Relay" scopes: `openid` and `profile` always, `email` and `phone` optional. */
+export type OAuth2Scope = "openid" | "profile" | "email" | "phone";
+/** The agent's OAuth2 client for Log in with Relay. `client_id` is the agent's ID. */
+export interface OAuth2Client {
+    client_id: string;
+    redirect_uris: string[];
+    scopes: OAuth2Scope[];
+    created_at: string;
+    updated_at: string;
+}
+export interface OAuth2ClientResponse {
+    client: OAuth2Client;
+    /** The client secret (`rel_cs_...`), only when the client was just made or its secret was just reset. */
+    client_secret?: string;
+}
+export interface OAuth2ClientUpdateParams {
+    /** Replaces every redirect. Up to 10 https URLs (http only on localhost). */
+    redirect_uris?: string[];
+    /** Replaces the scopes. `openid` and `profile` are always kept. */
+    scopes?: OAuth2Scope[];
+}
 export interface AgentAccessLists {
     allow: ContactLookup[];
     deny: ContactLookup[];
@@ -1472,27 +1663,12 @@ export interface MessageWebhookData {
     silent?: boolean;
     reply_to?: ReplyTo | null;
     /**
-     * A2A Message metadata. Every `message.received` carries it, with the
+     * Message metadata. Every `message.received` carries it, with the
      * reader's `a2uiClientCapabilities` and, when the sender sent one, its
      * `a2uiClientDataModel` for the surfaces this agent created (see
      * `MessageReceivedMetadata`).
      */
     metadata?: Partial<MessageReceivedMetadata>;
-    /**
-     * On `message.received`: for a message another agent sent to your A2A
-     * address, the request it came from; null for every other message. Answer
-     * with a reply in the chat (the sender gets an A2A Message), or with a Task:
-     * your first `tasks.updateStatus` or `tasks.addArtifact` on `task_id` opens
-     * it. Whichever comes first is the answer.
-     */
-    a2a?: MessageReceivedA2a | null;
-}
-/** `message.received` `a2a`: the A2A request a message came from. */
-export interface MessageReceivedA2a {
-    /** The A2A messageId the sender gave the message. */
-    message_id: string;
-    /** The id Relay keeps for the Task, if you answer with one. */
-    task_id: UUID;
 }
 /**
  * `message.failed`. Relay commits a Message before it answers, so a Message
@@ -1522,6 +1698,14 @@ export interface ContactEventContact {
      * stay in UTC; use this to read them in the person's local time.
      */
     timezone: string | null;
+    /**
+     * The person's age range, as their Relay app last reported it: from Apple's
+     * Declared Age Range, or from a birth year the person gave once (only the
+     * range is kept). Null until the app reports one. A person whose range is not
+     * "18_plus" never reaches an agent rated 18_plus, so an agent never needs to
+     * ask anyone their age.
+     */
+    age_range: AgeRange | null;
 }
 export interface ContactAddedEvent {
     contact: ContactEventContact;
@@ -1549,8 +1733,8 @@ export type ContactAddedWebhookEvent = ContactAddedWebhook;
 export type ContactRemovedWebhookEvent = ContactRemovedWebhook;
 type MessageWebhookEventType = "message.sent" | "message.received" | "message.read" | "message.delivered";
 type TypingIndicatorWebhookEventType = "chat.typing_indicator.started" | "chat.typing_indicator.stopped";
-type OtherWebhookEventType = Exclude<WebhookEventType, MessageWebhookEventType | TypingIndicatorWebhookEventType | "contact.added" | "contact.removed" | "message.failed" | "call.created" | "call.updated" | "call.ended" | "payment.succeeded" | "payment.canceled" | "payment.expired" | "location.sharing.started" | "location.sharing.stopped" | "task.created" | "task.message" | "task.canceled" | "task.updated">;
-export type RelayWebhookEvent = RelayWebhookEnvelope<MessageWebhookData, MessageWebhookEventType> | RelayWebhookEnvelope<TypingIndicatorWebhookData, TypingIndicatorWebhookEventType> | MessageFailedWebhook | ContactAddedWebhookEvent | ContactRemovedWebhookEvent | CallWebhookEvent | PaymentWebhookEvent | LocationSharingStartedWebhookEvent | LocationSharingStoppedWebhookEvent | TaskCreatedWebhookEvent | TaskMessageWebhookEvent | TaskCanceledWebhookEvent | TaskUpdatedWebhookEvent | RelayWebhookEnvelope<Record<string, unknown>, OtherWebhookEventType>;
+type OtherWebhookEventType = Exclude<WebhookEventType, MessageWebhookEventType | TypingIndicatorWebhookEventType | "contact.added" | "contact.removed" | "message.failed" | "call.created" | "call.updated" | "call.ended" | "payment.succeeded" | "payment.canceled" | "payment.expired" | "location.sharing.started" | "location.sharing.stopped">;
+export type RelayWebhookEvent = RelayWebhookEnvelope<MessageWebhookData, MessageWebhookEventType> | RelayWebhookEnvelope<TypingIndicatorWebhookData, TypingIndicatorWebhookEventType> | MessageFailedWebhook | ContactAddedWebhookEvent | ContactRemovedWebhookEvent | CallWebhookEvent | PaymentWebhookEvent | LocationSharingStartedWebhookEvent | LocationSharingStoppedWebhookEvent | RelayWebhookEnvelope<Record<string, unknown>, OtherWebhookEventType>;
 /** Existing Relay avatar gradient pairs, ordered top then base. */
 export type AgentImageGradient = readonly ["EC8A3C", "C85F1C"] | readonly ["E0567A", "AD2A52"] | readonly ["D05FC6", "93217E"] | readonly ["8F6CF2", "5F38CF"] | readonly ["5B9BFA", "0B52C0"] | readonly ["2596A6", "116A79"] | readonly ["2FA46A", "137347"];
 export interface AgentImageBackground {
@@ -1587,67 +1771,6 @@ export interface AgentPhotoImageRecipe {
     background?: never;
 }
 export type AgentImageRecipe = AgentMonogramImageRecipe | AgentEmojiImageRecipe | AgentPhotoImageRecipe;
-/** a2a.proto `TaskState`, without TASK_STATE_UNSPECIFIED. */
-export type A2aTaskState = "TASK_STATE_SUBMITTED" | "TASK_STATE_WORKING" | "TASK_STATE_COMPLETED" | "TASK_STATE_FAILED" | "TASK_STATE_CANCELED" | "TASK_STATE_INPUT_REQUIRED" | "TASK_STATE_REJECTED" | "TASK_STATE_AUTH_REQUIRED";
-/** a2a.proto `Part`: exactly one of `text`, `raw` (base64), `url` or `data`. */
-export interface A2aPart {
-    text?: string;
-    /** Base64 file bytes. */
-    raw?: string;
-    url?: string;
-    /** Any JSON value. */
-    data?: unknown;
-    metadata?: Record<string, unknown>;
-    filename?: string;
-    mediaType?: string;
-}
-/** a2a.proto `Message`. */
-export interface A2aMessage {
-    messageId: string;
-    contextId?: string;
-    taskId?: string;
-    /** ROLE_USER from the agent that sent the task or message, ROLE_AGENT from the agent that answers. */
-    role: "ROLE_USER" | "ROLE_AGENT";
-    /** 1 to 100 parts. */
-    parts: A2aPart[];
-    metadata?: Record<string, unknown>;
-    extensions?: string[];
-    referenceTaskIds?: string[];
-}
-/** a2a.proto `Artifact`: a result of a Task. */
-export interface A2aArtifact {
-    /** Unique within the Task. */
-    artifactId: string;
-    name?: string;
-    description?: string;
-    /** 1 to 100 parts. */
-    parts: A2aPart[];
-    metadata?: Record<string, unknown>;
-    extensions?: string[];
-}
-/** a2a.proto `TaskStatus`. */
-export interface A2aTaskStatus {
-    state: A2aTaskState;
-    message?: A2aMessage;
-    timestamp: string;
-}
-/**
- * a2a.proto `Task`. `metadata.relay.requester` is the verified agent that
- * sent the task: its Card and its `owner`.
- */
-export interface A2aTask {
-    id: UUID;
-    contextId: string;
-    status: A2aTaskStatus;
-    artifacts?: A2aArtifact[];
-    history?: A2aMessage[];
-    metadata: {
-        relay: {
-            requester: Record<string, unknown>;
-        };
-        [key: string]: unknown;
-    };
-}
 /** A person who administers an agent (`OwnerPerson`, contracts/relay-v1-openapi.yaml). */
 export interface OwnerPerson {
     /** The person's Contact identifier. */
@@ -1663,6 +1786,14 @@ export interface OwnerPerson {
      * Timestamps stay in UTC; use this to read them in the person's local time.
      */
     timezone?: string | null;
+    /**
+     * The person's age range, as their Relay app last reported it: from Apple's
+     * Declared Age Range, or from a birth year the person gave once (only the
+     * range is kept). Null until the app reports one. A person whose range is not
+     * "18_plus" never reaches an agent rated 18_plus, so an agent never needs to
+     * ask anyone their age.
+     */
+    age_range?: AgeRange | null;
 }
 /** `GET /v1/me`: the agent the Agent Token authenticates, and who owns it (`AgentMe`). */
 export interface AgentMe {
@@ -1686,114 +1817,5 @@ export interface AgentMe {
      */
     calls_enabled: boolean;
 }
-/** `PATCH /v1/me`: whether the authenticated agent accepts tasks from other agents. */
-export interface AgentMeUpdateParams {
-    accepts_tasks: boolean;
-}
-/** The setting as stored. */
-export interface AgentMeUpdateResponse {
-    accepts_tasks: boolean;
-}
-/**
- * The states the agent working on a task may set, by their a2a.proto names or
- * without the TASK_STATE_ prefix. COMPLETED, FAILED and REJECTED are final.
- */
-export type TaskStatusUpdateState = "TASK_STATE_WORKING" | "TASK_STATE_INPUT_REQUIRED" | "TASK_STATE_AUTH_REQUIRED" | "TASK_STATE_COMPLETED" | "TASK_STATE_FAILED" | "TASK_STATE_REJECTED" | "WORKING" | "INPUT_REQUIRED" | "AUTH_REQUIRED" | "COMPLETED" | "FAILED" | "REJECTED";
-/** `POST /v1/tasks/{taskId}/status`. */
-export interface TaskStatusUpdateParams {
-    state: TaskStatusUpdateState;
-    /** Role ROLE_AGENT; kept in the Task's history too. */
-    message?: A2aMessage;
-}
-/**
- * `POST /v1/tasks/{taskId}/reply`: answer a Task with one Message (role
- * ROLE_AGENT) instead, as your first answer only.
- */
-export interface TaskReplyParams {
-    message: A2aMessage;
-}
-/** `POST /v1/tasks/{taskId}/artifacts`: one whole Artifact, appended. */
-export interface TaskArtifactCreateParams {
-    artifact: A2aArtifact;
-}
-export interface TaskResponse {
-    task: A2aTask;
-}
-/** `GET /v1/tasks`. */
-export interface TaskListParams {
-    /** `callee` (default): tasks other agents sent you. `requester`: tasks you sent. */
-    role?: "callee" | "requester";
-    state?: A2aTaskState;
-    /** 1 to 100; the Server's default is 50. */
-    page_size?: number;
-    page_token?: string;
-}
-export interface TaskListResponse {
-    tasks: A2aTask[];
-    /** Empty on the last page. */
-    next_page_token: string;
-}
-/** a2a.proto `SendMessageConfiguration`, the fields Relay reads. */
-export interface A2aSendMessageConfiguration {
-    acceptedOutputModes?: string[];
-    historyLength?: number;
-    /**
-     * Answer at once with the Task instead of waiting for it to settle. No
-     * effect when the agent answers with a Message (A2A specification 3.2.2).
-     */
-    returnImmediately?: boolean;
-}
-/** Send another agent a task or a message at its A2A address: A2A `SendMessage`. */
-export interface TaskSendParams {
-    /** The Relay Handle of the agent that receives it. */
-    to: string;
-    /**
-     * Role ROLE_USER. With no taskId it starts a Task at an agent that accepts
-     * tasks, and reaches any other agent as a message in your chat with it;
-     * with a taskId it continues that Task.
-     */
-    message: A2aMessage;
-    configuration?: A2aSendMessageConfiguration;
-    /** Kept on the Task's metadata, beside `relay`. */
-    metadata?: Record<string, unknown>;
-}
-/**
- * What `tasks.send` answers, as @a2a-js/sdk's `SendMessageResult` is: a
- * Task from an agent that accepts tasks, or a Message, the reply of any
- * other agent. A Message has a `messageId`; a Task does not.
- */
-export type A2aSendMessageResult = A2aTask | A2aMessage;
-/** A2A `GetTask` at the agent's address; only a Task you sent that agent. */
-export interface TaskGetParams {
-    to: string;
-    id: UUID;
-    historyLength?: number;
-}
-/** A2A `CancelTask` at the agent's address; only a Task you sent that agent. */
-export interface TaskCancelParams {
-    to: string;
-    id: UUID;
-}
-/** `task.created`: another agent sent your agent a task, in TASK_STATE_SUBMITTED. */
-export interface TaskCreatedEvent {
-    task: A2aTask;
-}
-/** `task.message`: the agent that sent the task sent more on it. */
-export interface TaskMessageEvent {
-    task_id: UUID;
-    message: A2aMessage;
-}
-/** `task.canceled`: the agent that sent the task canceled it. */
-export interface TaskCanceledEvent {
-    task_id: UUID;
-}
-/** `task.updated`: the agent working on a task your agent sent changed it. */
-export interface TaskUpdatedEvent {
-    task: A2aTask;
-}
-export type TaskCreatedWebhookEvent = RelayWebhookEnvelope<TaskCreatedEvent, "task.created">;
-export type TaskMessageWebhookEvent = RelayWebhookEnvelope<TaskMessageEvent, "task.message">;
-export type TaskCanceledWebhookEvent = RelayWebhookEnvelope<TaskCanceledEvent, "task.canceled">;
-export type TaskUpdatedWebhookEvent = RelayWebhookEnvelope<TaskUpdatedEvent, "task.updated">;
 export {};
 //# sourceMappingURL=types.d.ts.map