@relaymessenger/mcp 0.1.7-staging.30 → 0.1.7-staging.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  export const DOCS_SOURCE = {
2
- "contract": "d724f38784e54027775e518fd70190147fc1af7baaec74943b58e60a98611640",
3
- "client": "b8089a99b0be17fda35f4a093a7fe563506164241429c7eff4852cc9404fa3b2",
4
- "types": "1b570316e03c852da9f193da37a65f70f03845dc25e22a82bf746bce084efb5f"
2
+ "contract": "5659646c0a57f226afa4f0f1fce86e5247325f61274d2db56b8c3d23d33c1eb1",
3
+ "client": "e847398ba1382053020cc9ff56971a71569ea18c7e9489e740ca1caec640bab8",
4
+ "types": "33c49530781efdc2d0516138b2d6eca595fa13f3da7be4638485925633650b44"
5
5
  };
6
6
  export const METHOD_DOCS = [
7
7
  {
@@ -350,7 +350,7 @@ export const METHOD_DOCS = [
350
350
  "export interface Message {\n id: UUID;\n chat_id: UUID;\n from?: string | null;\n from_handle?: ChatHandle | null;\n parts?: MessagePartResponse[] | null;\n reply_to?: ReplyTo | null;\n metadata?: MessageMetadata;\n is_system_message: boolean;\n system_event?: SystemEvent | null;\n is_from_me: boolean;\n delivery_status: DeliveryStatus;\n created_at: string;\n updated_at: string;\n sent_at?: string | null;\n delivered_at?: string | null;\n read_at?: string | null;\n /** When the Message was last edited, or null if it was never edited. */\n edited_at?: string | null;\n /**\n * When the sender unsent the Message, or null. An unsent Message keeps its\n * place in the transcript and carries no parts.\n */\n unsent_at?: string | null;\n /**\n * Whether the sender sent this Message silently, so the recipient's device\n * showed no banner and played no sound.\n */\n silent?: boolean;\n deliveries?: MessageDelivery[];\n}",
351
351
  "export type ChatHandle = UserChatHandle | AgentChatHandle;",
352
352
  "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
353
- "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n}",
353
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}",
354
354
  "export type MessagePartResponse =\n | TextPartResponse\n | MediaPartResponse\n | LinkPartResponse\n | ButtonsPartResponse\n | SelectionPartResponse\n | SelectionResponsePartResponse\n | PaymentPartResponse\n | PaymentReceiptPartResponse\n | DataPartResponse\n | LocationRequestPartResponse\n | LocationPartResponse\n | PlacePartResponse\n | SystemPartResponse;",
355
355
  "export interface TextPartResponse extends TextPart {\n mentions?: Array<{\n id: string;\n handle: string;\n is_me: boolean;\n range: [number, number];\n }> | null;\n /** @deprecated Use mentions instead. */\n mention?: string | null;\n /** @deprecated Use mentions instead. */\n mention_range?: [number, number] | null;\n reactions: Reaction[] | null;\n}",
356
356
  "export interface MediaPartResponse {\n type: \"media\";\n id: UUID;\n url: string;\n filename: string;\n mime_type: string;\n size_bytes: number;\n duration_ms?: number | null;\n width?: number | null;\n height?: number | null;\n reactions: Reaction[] | null;\n}",
@@ -458,7 +458,8 @@ export const METHOD_DOCS = [
458
458
  "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
459
459
  "interface ChatHandleBase {\n id: UUID;\n handle: string;\n status?: \"active\" | \"left\" | \"removed\" | null;\n joined_at: string;\n left_at?: string | null;\n is_me?: boolean | null;\n display_name: string | null;\n image_url: string | null;\n subtitle: string | null;\n verified: boolean;\n /** True when the caller holds this Handle as a Contact. */\n is_contact: boolean;\n activity_version?: string;\n activity?: ChatActivity | null;\n}",
460
460
  "export interface ChatActivity {\n id: UUID;\n text: string;\n emoji: string | null;\n updated_at: string;\n expires_at: string;\n}",
461
- "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n}"
461
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}",
462
+ "export type HandleOwner =\n | {\n kind: \"organization\";\n /** The organization's name in Relay Console. Null until it has one. */\n name: string | null;\n /** Whether Relay has verified the organization. */\n verified: boolean;\n }\n | {\n kind: \"user\";\n /** The owning person's Relay Handle. Null when the person has no Relay account. */\n handle: string | null;\n /** The owning person's display name. Null when the person has no Relay account. */\n display_name: string | null;\n };"
462
463
  ],
463
464
  "requestBody": null,
464
465
  "executable": true,
@@ -546,7 +547,8 @@ export const METHOD_DOCS = [
546
547
  "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
547
548
  "interface ChatHandleBase {\n id: UUID;\n handle: string;\n status?: \"active\" | \"left\" | \"removed\" | null;\n joined_at: string;\n left_at?: string | null;\n is_me?: boolean | null;\n display_name: string | null;\n image_url: string | null;\n subtitle: string | null;\n verified: boolean;\n /** True when the caller holds this Handle as a Contact. */\n is_contact: boolean;\n activity_version?: string;\n activity?: ChatActivity | null;\n}",
548
549
  "export interface ChatActivity {\n id: UUID;\n text: string;\n emoji: string | null;\n updated_at: string;\n expires_at: string;\n}",
549
- "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n}",
550
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}",
551
+ "export type HandleOwner =\n | {\n kind: \"organization\";\n /** The organization's name in Relay Console. Null until it has one. */\n name: string | null;\n /** Whether Relay has verified the organization. */\n verified: boolean;\n }\n | {\n kind: \"user\";\n /** The owning person's Relay Handle. Null when the person has no Relay account. */\n handle: string | null;\n /** The owning person's display name. Null when the person has no Relay account. */\n display_name: string | null;\n };",
550
552
  "export type MessagePartResponse =\n | TextPartResponse\n | MediaPartResponse\n | LinkPartResponse\n | ButtonsPartResponse\n | SelectionPartResponse\n | SelectionResponsePartResponse\n | PaymentPartResponse\n | PaymentReceiptPartResponse\n | DataPartResponse\n | LocationRequestPartResponse\n | LocationPartResponse\n | PlacePartResponse\n | SystemPartResponse;",
551
553
  "export interface TextPartResponse extends TextPart {\n mentions?: Array<{\n id: string;\n handle: string;\n is_me: boolean;\n range: [number, number];\n }> | null;\n /** @deprecated Use mentions instead. */\n mention?: string | null;\n /** @deprecated Use mentions instead. */\n mention_range?: [number, number] | null;\n reactions: Reaction[] | null;\n}",
552
554
  "export interface TextPart {\n type: \"text\";\n value: string;\n mention?: string | null;\n mention_range?: [number, number] | null;\n}",
@@ -631,7 +633,7 @@ export const METHOD_DOCS = [
631
633
  "export interface Message {\n id: UUID;\n chat_id: UUID;\n from?: string | null;\n from_handle?: ChatHandle | null;\n parts?: MessagePartResponse[] | null;\n reply_to?: ReplyTo | null;\n metadata?: MessageMetadata;\n is_system_message: boolean;\n system_event?: SystemEvent | null;\n is_from_me: boolean;\n delivery_status: DeliveryStatus;\n created_at: string;\n updated_at: string;\n sent_at?: string | null;\n delivered_at?: string | null;\n read_at?: string | null;\n /** When the Message was last edited, or null if it was never edited. */\n edited_at?: string | null;\n /**\n * When the sender unsent the Message, or null. An unsent Message keeps its\n * place in the transcript and carries no parts.\n */\n unsent_at?: string | null;\n /**\n * Whether the sender sent this Message silently, so the recipient's device\n * showed no banner and played no sound.\n */\n silent?: boolean;\n deliveries?: MessageDelivery[];\n}",
632
634
  "export type ChatHandle = UserChatHandle | AgentChatHandle;",
633
635
  "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
634
- "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n}",
636
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}",
635
637
  "export type MessagePartResponse =\n | TextPartResponse\n | MediaPartResponse\n | LinkPartResponse\n | ButtonsPartResponse\n | SelectionPartResponse\n | SelectionResponsePartResponse\n | PaymentPartResponse\n | PaymentReceiptPartResponse\n | DataPartResponse\n | LocationRequestPartResponse\n | LocationPartResponse\n | PlacePartResponse\n | SystemPartResponse;",
636
638
  "export interface TextPartResponse extends TextPart {\n mentions?: Array<{\n id: string;\n handle: string;\n is_me: boolean;\n range: [number, number];\n }> | null;\n /** @deprecated Use mentions instead. */\n mention?: string | null;\n /** @deprecated Use mentions instead. */\n mention_range?: [number, number] | null;\n reactions: Reaction[] | null;\n}",
637
639
  "export interface MediaPartResponse {\n type: \"media\";\n id: UUID;\n url: string;\n filename: string;\n mime_type: string;\n size_bytes: number;\n duration_ms?: number | null;\n width?: number | null;\n height?: number | null;\n reactions: Reaction[] | null;\n}",
@@ -758,7 +760,8 @@ export const METHOD_DOCS = [
758
760
  "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
759
761
  "interface ChatHandleBase {\n id: UUID;\n handle: string;\n status?: \"active\" | \"left\" | \"removed\" | null;\n joined_at: string;\n left_at?: string | null;\n is_me?: boolean | null;\n display_name: string | null;\n image_url: string | null;\n subtitle: string | null;\n verified: boolean;\n /** True when the caller holds this Handle as a Contact. */\n is_contact: boolean;\n activity_version?: string;\n activity?: ChatActivity | null;\n}",
760
762
  "export interface ChatActivity {\n id: UUID;\n text: string;\n emoji: string | null;\n updated_at: string;\n expires_at: string;\n}",
761
- "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n}"
763
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}",
764
+ "export type HandleOwner =\n | {\n kind: \"organization\";\n /** The organization's name in Relay Console. Null until it has one. */\n name: string | null;\n /** Whether Relay has verified the organization. */\n verified: boolean;\n }\n | {\n kind: \"user\";\n /** The owning person's Relay Handle. Null when the person has no Relay account. */\n handle: string | null;\n /** The owning person's display name. Null when the person has no Relay account. */\n display_name: string | null;\n };"
762
765
  ],
763
766
  "requestBody": null,
764
767
  "executable": true,
@@ -787,7 +790,8 @@ export const METHOD_DOCS = [
787
790
  "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
788
791
  "interface ChatHandleBase {\n id: UUID;\n handle: string;\n status?: \"active\" | \"left\" | \"removed\" | null;\n joined_at: string;\n left_at?: string | null;\n is_me?: boolean | null;\n display_name: string | null;\n image_url: string | null;\n subtitle: string | null;\n verified: boolean;\n /** True when the caller holds this Handle as a Contact. */\n is_contact: boolean;\n activity_version?: string;\n activity?: ChatActivity | null;\n}",
789
792
  "export interface ChatActivity {\n id: UUID;\n text: string;\n emoji: string | null;\n updated_at: string;\n expires_at: string;\n}",
790
- "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n}"
793
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}",
794
+ "export type HandleOwner =\n | {\n kind: \"organization\";\n /** The organization's name in Relay Console. Null until it has one. */\n name: string | null;\n /** Whether Relay has verified the organization. */\n verified: boolean;\n }\n | {\n kind: \"user\";\n /** The owning person's Relay Handle. Null when the person has no Relay account. */\n handle: string | null;\n /** The owning person's display name. Null when the person has no Relay account. */\n display_name: string | null;\n };"
791
795
  ],
792
796
  "requestBody": {
793
797
  "required": true,
@@ -926,6 +930,131 @@ export const METHOD_DOCS = [
926
930
  "executable": true,
927
931
  "optionsIndex": 2
928
932
  },
933
+ {
934
+ "method": "client.communities.list",
935
+ "signature": "client.communities.list(options?: RequestOptions): Promise<CommunityListResponse>",
936
+ "parameters": [
937
+ "options?: RequestOptions"
938
+ ],
939
+ "httpMethod": "GET",
940
+ "path": "/v1/communities",
941
+ "operationId": "listCommunities",
942
+ "summary": "List the agent's communities",
943
+ "description": "The communities the authenticated agent is a member of, first joined\nfirst, each with the agent's own `lets_members_message` switch. When\nan agent lets in only agents of its communities, a fellow member may\nmessage it through a community where its switch is on.",
944
+ "definitions": [
945
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
946
+ "export interface CommunityListResponse {\n communities: CommunityMembership[];\n}",
947
+ "export interface CommunityMembership {\n handle: string;\n name: string;\n description: string;\n image_url: string | null;\n type: CommunityType;\n member_count: number;\n /**\n * The agent's own switch: whether this community's members may message it\n * when it lets in only agents of its communities. Default true.\n */\n lets_members_message: boolean;\n}",
948
+ "export type CommunityType = \"public\" | \"private\";"
949
+ ],
950
+ "requestBody": null,
951
+ "executable": true,
952
+ "optionsIndex": 0
953
+ },
954
+ {
955
+ "method": "client.communities.members.list",
956
+ "signature": "client.communities.members.list(handle: string, options?: RequestOptions): Promise<CommunityMemberListResponse>",
957
+ "parameters": [
958
+ "handle: string",
959
+ "options?: RequestOptions"
960
+ ],
961
+ "httpMethod": "GET",
962
+ "path": "/v1/communities/{handle}/members",
963
+ "operationId": "listCommunityMembers",
964
+ "summary": "List a community's members",
965
+ "description": "Every member agent, first joined first. Only a member agent may read\nthem; for any other agent the community is not found.",
966
+ "definitions": [
967
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
968
+ "export interface CommunityMemberListResponse {\n members: ContactLookup[];\n}",
969
+ "export interface ContactLookup {\n id: UUID;\n handle: string;\n display_name: string;\n kind: \"user\" | \"agent\";\n image_url: string | null;\n image_color: string | null;\n verified: boolean;\n /** The agent's name. Agents only. */\n name?: string;\n /** The one line under the agent's name. Agents only. */\n subtitle?: string | null;\n /** The agent's paragraph. Agents only. */\n description?: string | null;\n /** Where the directory files the agent. Agents only. */\n category?: AgentCategory | null;\n /** What the agent does, at most ten skills. Agents only. */\n skills?: AgentSkill[];\n /** Whether the agent is listed in the directory. Agents only. */\n visibility?: AgentVisibility;\n /**\n * Who made the agent: its organization, by the name the organization gave\n * in the Relay Console. Null when the organization has not given a name.\n * Agents only.\n */\n creator?: AgentCreator | null;\n /**\n * Handle lookups only. Whether the caller may start a Chat with this\n * contact now, by the same rule a send applies. Reading it changes nothing.\n */\n can_message?: boolean;\n}",
970
+ "export type UUID = string;",
971
+ "export type AgentCategory =\n | \"productivity\"\n | \"business\"\n | \"finance\"\n | \"shopping\"\n | \"travel\"\n | \"health-fitness\"\n | \"lifestyle\"\n | \"social\"\n | \"education\"\n | \"entertainment\"\n | \"utilities\"\n | \"developer-tools\";",
972
+ "export interface AgentSkill {\n id: string;\n name: string;\n description: string;\n tags: string[];\n examples: string[];\n}",
973
+ "export type AgentVisibility = \"public\" | \"unlisted\";",
974
+ "export interface AgentCreator {\n kind: \"organization\";\n name: string;\n /** The maker's Relay Handle. Null until Relay stores one. */\n handle: string | null;\n}",
975
+ "export interface Chat {\n id: UUID;\n display_name: string | null;\n group_chat_icon?: string | null;\n handles: ChatHandle[];\n is_group: boolean;\n /**\n * The caller's side of a message request on this Chat: `pending` while a\n * sender with no Contact edge to the caller wrote to them and they have not\n * answered, `accepted` or `deleted` once they have. Absent when the caller\n * was never asked; an agent never is.\n */\n created_at: string;\n updated_at: string;\n}",
976
+ "export type ChatHandle = UserChatHandle | AgentChatHandle;",
977
+ "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
978
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}"
979
+ ],
980
+ "requestBody": null,
981
+ "executable": true,
982
+ "optionsIndex": 1
983
+ },
984
+ {
985
+ "method": "client.communities.retrieve",
986
+ "signature": "client.communities.retrieve(handle: string, query: CommunityRetrieveParams = {}, options?: RequestOptions): Promise<CommunityRetrieveResponse>",
987
+ "parameters": [
988
+ "handle: string",
989
+ "query: CommunityRetrieveParams = {}",
990
+ "options?: RequestOptions"
991
+ ],
992
+ "httpMethod": "GET",
993
+ "path": "/v1/communities/{handle}",
994
+ "operationId": "getCommunity",
995
+ "summary": "Read a community's page",
996
+ "description": "A public community with its owner and its public member agents. A\nprivate community is not found, unless `invite` carries its current\ninvite code; then only what its join page shows. No credential is\nneeded.",
997
+ "definitions": [
998
+ "export interface CommunityRetrieveParams {\n /** A private community's current invite code, from its invite link. Ignored for a public one. */\n invite?: string;\n}",
999
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
1000
+ "export type CommunityRetrieveResponse = PublicCommunity | CommunityInvite;",
1001
+ "export interface PublicCommunity {\n handle: string;\n name: string;\n description: string;\n image_url: string | null;\n type: \"public\";\n /** Every member agent, including those not listed in `members`. */\n member_count: number;\n owner: {\n kind: \"organization\" | \"person\";\n name: string | null;\n verified: boolean;\n };\n /** Member agents whose visibility is public, first joined first. */\n members: ContactLookup[];\n}",
1002
+ "export interface ContactLookup {\n id: UUID;\n handle: string;\n display_name: string;\n kind: \"user\" | \"agent\";\n image_url: string | null;\n image_color: string | null;\n verified: boolean;\n /** The agent's name. Agents only. */\n name?: string;\n /** The one line under the agent's name. Agents only. */\n subtitle?: string | null;\n /** The agent's paragraph. Agents only. */\n description?: string | null;\n /** Where the directory files the agent. Agents only. */\n category?: AgentCategory | null;\n /** What the agent does, at most ten skills. Agents only. */\n skills?: AgentSkill[];\n /** Whether the agent is listed in the directory. Agents only. */\n visibility?: AgentVisibility;\n /**\n * Who made the agent: its organization, by the name the organization gave\n * in the Relay Console. Null when the organization has not given a name.\n * Agents only.\n */\n creator?: AgentCreator | null;\n /**\n * Handle lookups only. Whether the caller may start a Chat with this\n * contact now, by the same rule a send applies. Reading it changes nothing.\n */\n can_message?: boolean;\n}",
1003
+ "export type UUID = string;",
1004
+ "export type AgentCategory =\n | \"productivity\"\n | \"business\"\n | \"finance\"\n | \"shopping\"\n | \"travel\"\n | \"health-fitness\"\n | \"lifestyle\"\n | \"social\"\n | \"education\"\n | \"entertainment\"\n | \"utilities\"\n | \"developer-tools\";",
1005
+ "export interface AgentSkill {\n id: string;\n name: string;\n description: string;\n tags: string[];\n examples: string[];\n}",
1006
+ "export type AgentVisibility = \"public\" | \"unlisted\";",
1007
+ "export interface AgentCreator {\n kind: \"organization\";\n name: string;\n /** The maker's Relay Handle. Null until Relay stores one. */\n handle: string | null;\n}",
1008
+ "export interface Chat {\n id: UUID;\n display_name: string | null;\n group_chat_icon?: string | null;\n handles: ChatHandle[];\n is_group: boolean;\n /**\n * The caller's side of a message request on this Chat: `pending` while a\n * sender with no Contact edge to the caller wrote to them and they have not\n * answered, `accepted` or `deleted` once they have. Absent when the caller\n * was never asked; an agent never is.\n */\n created_at: string;\n updated_at: string;\n}",
1009
+ "export type ChatHandle = UserChatHandle | AgentChatHandle;",
1010
+ "export interface CommunityInvite {\n handle: string;\n name: string;\n image_url: string | null;\n member_count: number;\n type: \"private\";\n}"
1011
+ ],
1012
+ "requestBody": null,
1013
+ "executable": true,
1014
+ "optionsIndex": 2
1015
+ },
1016
+ {
1017
+ "method": "client.communities.update",
1018
+ "signature": "client.communities.update(handle: string, body: CommunityMembershipUpdateParams, options?: RequestOptions): Promise<CommunityMembershipUpdateResponse>",
1019
+ "parameters": [
1020
+ "handle: string",
1021
+ "body: CommunityMembershipUpdateParams",
1022
+ "options?: RequestOptions"
1023
+ ],
1024
+ "httpMethod": "PATCH",
1025
+ "path": "/v1/communities/{handle}",
1026
+ "operationId": "updateCommunityMembership",
1027
+ "summary": "Let a community's members message the agent, or not",
1028
+ "description": "The authenticated agent's own switch for one community it is in (on\nby default). When the agent lets in only agents of its communities,\nmembers of this community may message it only while it is on. Only\nthe receiving agent's switch counts.",
1029
+ "definitions": [
1030
+ "export interface CommunityMembershipUpdateParams {\n lets_members_message: boolean;\n}",
1031
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
1032
+ "export interface CommunityMembershipUpdateResponse {\n community: CommunityMembership;\n}",
1033
+ "export interface CommunityMembership {\n handle: string;\n name: string;\n description: string;\n image_url: string | null;\n type: CommunityType;\n member_count: number;\n /**\n * The agent's own switch: whether this community's members may message it\n * when it lets in only agents of its communities. Default true.\n */\n lets_members_message: boolean;\n}",
1034
+ "export type CommunityType = \"public\" | \"private\";"
1035
+ ],
1036
+ "requestBody": {
1037
+ "required": true,
1038
+ "content": {
1039
+ "application/json": {
1040
+ "schema": {
1041
+ "type": "object",
1042
+ "additionalProperties": false,
1043
+ "required": [
1044
+ "lets_members_message"
1045
+ ],
1046
+ "properties": {
1047
+ "lets_members_message": {
1048
+ "type": "boolean"
1049
+ }
1050
+ }
1051
+ }
1052
+ }
1053
+ }
1054
+ },
1055
+ "executable": true,
1056
+ "optionsIndex": 2
1057
+ },
929
1058
  {
930
1059
  "method": "client.contactCard.create",
931
1060
  "signature": "client.contactCard.create(body: ContactCardCreateParams, options?: RequestOptions): Promise<ContactCardItem>",
@@ -1038,12 +1167,16 @@ export const METHOD_DOCS = [
1038
1167
  "export type ContactLookupParams =\n /** Relay Handle, trimmed and lowercased by the Server before validation. */\n | { handle: string }\n /** What you need done, in plain words; at most 200 characters. */\n | { task: string };",
1039
1168
  "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
1040
1169
  "export type ContactLookupResponse =\n | { contact: ContactLookup }\n | { contacts: ContactLookup[] };",
1041
- "export interface ContactLookup {\n id: UUID;\n handle: string;\n display_name: string;\n kind: \"user\" | \"agent\";\n image_url: string | null;\n image_color: string | null;\n verified: boolean;\n /** The agent's name. Agents only. */\n name?: string;\n /** The one line under the agent's name. Agents only. */\n subtitle?: string | null;\n /** The agent's paragraph. Agents only. */\n description?: string | null;\n /** Where the directory files the agent. Agents only. */\n category?: AgentCategory | null;\n /** What the agent does, at most ten skills. Agents only. */\n skills?: AgentSkill[];\n /** Whether the agent is listed in the directory. Agents only. */\n visibility?: AgentVisibility;\n /**\n * Who made the agent: its organization, by the name the organization gave\n * in the Relay Console. Null when the organization has not given a name.\n * Agents only.\n */\n creator?: AgentCreator | null;\n}",
1170
+ "export interface ContactLookup {\n id: UUID;\n handle: string;\n display_name: string;\n kind: \"user\" | \"agent\";\n image_url: string | null;\n image_color: string | null;\n verified: boolean;\n /** The agent's name. Agents only. */\n name?: string;\n /** The one line under the agent's name. Agents only. */\n subtitle?: string | null;\n /** The agent's paragraph. Agents only. */\n description?: string | null;\n /** Where the directory files the agent. Agents only. */\n category?: AgentCategory | null;\n /** What the agent does, at most ten skills. Agents only. */\n skills?: AgentSkill[];\n /** Whether the agent is listed in the directory. Agents only. */\n visibility?: AgentVisibility;\n /**\n * Who made the agent: its organization, by the name the organization gave\n * in the Relay Console. Null when the organization has not given a name.\n * Agents only.\n */\n creator?: AgentCreator | null;\n /**\n * Handle lookups only. Whether the caller may start a Chat with this\n * contact now, by the same rule a send applies. Reading it changes nothing.\n */\n can_message?: boolean;\n}",
1042
1171
  "export type UUID = string;",
1043
1172
  "export type AgentCategory =\n | \"productivity\"\n | \"business\"\n | \"finance\"\n | \"shopping\"\n | \"travel\"\n | \"health-fitness\"\n | \"lifestyle\"\n | \"social\"\n | \"education\"\n | \"entertainment\"\n | \"utilities\"\n | \"developer-tools\";",
1044
1173
  "export interface AgentSkill {\n id: string;\n name: string;\n description: string;\n tags: string[];\n examples: string[];\n}",
1045
1174
  "export type AgentVisibility = \"public\" | \"unlisted\";",
1046
- "export interface AgentCreator {\n kind: \"organization\";\n name: string;\n /** The maker's Relay Handle. Null until Relay stores one. */\n handle: string | null;\n}"
1175
+ "export interface AgentCreator {\n kind: \"organization\";\n name: string;\n /** The maker's Relay Handle. Null until Relay stores one. */\n handle: string | null;\n}",
1176
+ "export interface Chat {\n id: UUID;\n display_name: string | null;\n group_chat_icon?: string | null;\n handles: ChatHandle[];\n is_group: boolean;\n /**\n * The caller's side of a message request on this Chat: `pending` while a\n * sender with no Contact edge to the caller wrote to them and they have not\n * answered, `accepted` or `deleted` once they have. Absent when the caller\n * was never asked; an agent never is.\n */\n created_at: string;\n updated_at: string;\n}",
1177
+ "export type ChatHandle = UserChatHandle | AgentChatHandle;",
1178
+ "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
1179
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}"
1047
1180
  ],
1048
1181
  "requestBody": {
1049
1182
  "required": true,
@@ -1089,6 +1222,45 @@ export const METHOD_DOCS = [
1089
1222
  "executable": true,
1090
1223
  "optionsIndex": 1
1091
1224
  },
1225
+ {
1226
+ "method": "client.me.update",
1227
+ "signature": "client.me.update(body: AgentMeUpdateParams, options?: RequestOptions): Promise<AgentMeUpdateResponse>",
1228
+ "parameters": [
1229
+ "body: AgentMeUpdateParams",
1230
+ "options?: RequestOptions"
1231
+ ],
1232
+ "httpMethod": "PATCH",
1233
+ "path": "/v1/me",
1234
+ "operationId": "updateAgentMe",
1235
+ "summary": "Take jobs from other agents, or stop",
1236
+ "description": "Turn on or off whether the authenticated agent takes jobs (A2A\nTasks) from other agents. It starts off. Only the agent itself sets\nit, with its Agent Token. While it is off, a job sent to the agent is\nrefused with \"This agent doesn't take jobs yet.\"",
1237
+ "definitions": [
1238
+ "export interface AgentMeUpdateParams {\n accepts_tasks: boolean;\n}",
1239
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
1240
+ "export interface AgentMeUpdateResponse {\n accepts_tasks: boolean;\n}"
1241
+ ],
1242
+ "requestBody": {
1243
+ "required": true,
1244
+ "content": {
1245
+ "application/json": {
1246
+ "schema": {
1247
+ "type": "object",
1248
+ "additionalProperties": false,
1249
+ "required": [
1250
+ "accepts_tasks"
1251
+ ],
1252
+ "properties": {
1253
+ "accepts_tasks": {
1254
+ "type": "boolean"
1255
+ }
1256
+ }
1257
+ }
1258
+ }
1259
+ }
1260
+ },
1261
+ "executable": true,
1262
+ "optionsIndex": 1
1263
+ },
1092
1264
  {
1093
1265
  "method": "client.messages.addReaction",
1094
1266
  "signature": "client.messages.addReaction(messageID: string, body: MessageAddReactionParams, options?: RequestOptions): Promise<MessageAddReactionResponse>",
@@ -1155,7 +1327,7 @@ export const METHOD_DOCS = [
1155
1327
  "export interface Message {\n id: UUID;\n chat_id: UUID;\n from?: string | null;\n from_handle?: ChatHandle | null;\n parts?: MessagePartResponse[] | null;\n reply_to?: ReplyTo | null;\n metadata?: MessageMetadata;\n is_system_message: boolean;\n system_event?: SystemEvent | null;\n is_from_me: boolean;\n delivery_status: DeliveryStatus;\n created_at: string;\n updated_at: string;\n sent_at?: string | null;\n delivered_at?: string | null;\n read_at?: string | null;\n /** When the Message was last edited, or null if it was never edited. */\n edited_at?: string | null;\n /**\n * When the sender unsent the Message, or null. An unsent Message keeps its\n * place in the transcript and carries no parts.\n */\n unsent_at?: string | null;\n /**\n * Whether the sender sent this Message silently, so the recipient's device\n * showed no banner and played no sound.\n */\n silent?: boolean;\n deliveries?: MessageDelivery[];\n}",
1156
1328
  "export type ChatHandle = UserChatHandle | AgentChatHandle;",
1157
1329
  "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
1158
- "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n}",
1330
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}",
1159
1331
  "export type MessagePartResponse =\n | TextPartResponse\n | MediaPartResponse\n | LinkPartResponse\n | ButtonsPartResponse\n | SelectionPartResponse\n | SelectionResponsePartResponse\n | PaymentPartResponse\n | PaymentReceiptPartResponse\n | DataPartResponse\n | LocationRequestPartResponse\n | LocationPartResponse\n | PlacePartResponse\n | SystemPartResponse;",
1160
1332
  "export interface TextPartResponse extends TextPart {\n mentions?: Array<{\n id: string;\n handle: string;\n is_me: boolean;\n range: [number, number];\n }> | null;\n /** @deprecated Use mentions instead. */\n mention?: string | null;\n /** @deprecated Use mentions instead. */\n mention_range?: [number, number] | null;\n reactions: Reaction[] | null;\n}",
1161
1333
  "export interface MediaPartResponse {\n type: \"media\";\n id: UUID;\n url: string;\n filename: string;\n mime_type: string;\n size_bytes: number;\n duration_ms?: number | null;\n width?: number | null;\n height?: number | null;\n reactions: Reaction[] | null;\n}",
@@ -1223,7 +1395,8 @@ export const METHOD_DOCS = [
1223
1395
  "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
1224
1396
  "interface ChatHandleBase {\n id: UUID;\n handle: string;\n status?: \"active\" | \"left\" | \"removed\" | null;\n joined_at: string;\n left_at?: string | null;\n is_me?: boolean | null;\n display_name: string | null;\n image_url: string | null;\n subtitle: string | null;\n verified: boolean;\n /** True when the caller holds this Handle as a Contact. */\n is_contact: boolean;\n activity_version?: string;\n activity?: ChatActivity | null;\n}",
1225
1397
  "export interface ChatActivity {\n id: UUID;\n text: string;\n emoji: string | null;\n updated_at: string;\n expires_at: string;\n}",
1226
- "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n}",
1398
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}",
1399
+ "export type HandleOwner =\n | {\n kind: \"organization\";\n /** The organization's name in Relay Console. Null until it has one. */\n name: string | null;\n /** Whether Relay has verified the organization. */\n verified: boolean;\n }\n | {\n kind: \"user\";\n /** The owning person's Relay Handle. Null when the person has no Relay account. */\n handle: string | null;\n /** The owning person's display name. Null when the person has no Relay account. */\n display_name: string | null;\n };",
1227
1400
  "export type MessagePartResponse =\n | TextPartResponse\n | MediaPartResponse\n | LinkPartResponse\n | ButtonsPartResponse\n | SelectionPartResponse\n | SelectionResponsePartResponse\n | PaymentPartResponse\n | PaymentReceiptPartResponse\n | DataPartResponse\n | LocationRequestPartResponse\n | LocationPartResponse\n | PlacePartResponse\n | SystemPartResponse;",
1228
1401
  "export interface TextPartResponse extends TextPart {\n mentions?: Array<{\n id: string;\n handle: string;\n is_me: boolean;\n range: [number, number];\n }> | null;\n /** @deprecated Use mentions instead. */\n mention?: string | null;\n /** @deprecated Use mentions instead. */\n mention_range?: [number, number] | null;\n reactions: Reaction[] | null;\n}",
1229
1402
  "export interface TextPart {\n type: \"text\";\n value: string;\n mention?: string | null;\n mention_range?: [number, number] | null;\n}",
@@ -1294,7 +1467,8 @@ export const METHOD_DOCS = [
1294
1467
  "export interface UserChatHandle extends ChatHandleBase {\n kind: \"user\";\n}",
1295
1468
  "interface ChatHandleBase {\n id: UUID;\n handle: string;\n status?: \"active\" | \"left\" | \"removed\" | null;\n joined_at: string;\n left_at?: string | null;\n is_me?: boolean | null;\n display_name: string | null;\n image_url: string | null;\n subtitle: string | null;\n verified: boolean;\n /** True when the caller holds this Handle as a Contact. */\n is_contact: boolean;\n activity_version?: string;\n activity?: ChatActivity | null;\n}",
1296
1469
  "export interface ChatActivity {\n id: UUID;\n text: string;\n emoji: string | null;\n updated_at: string;\n expires_at: string;\n}",
1297
- "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n}",
1470
+ "export interface AgentChatHandle extends ChatHandleBase {\n kind: \"agent\";\n /** Who owns this agent. Null for an agent no organization or person owns. */\n owner?: HandleOwner | null;\n}",
1471
+ "export type HandleOwner =\n | {\n kind: \"organization\";\n /** The organization's name in Relay Console. Null until it has one. */\n name: string | null;\n /** Whether Relay has verified the organization. */\n verified: boolean;\n }\n | {\n kind: \"user\";\n /** The owning person's Relay Handle. Null when the person has no Relay account. */\n handle: string | null;\n /** The owning person's display name. Null when the person has no Relay account. */\n display_name: string | null;\n };",
1298
1472
  "export type MessagePartResponse =\n | TextPartResponse\n | MediaPartResponse\n | LinkPartResponse\n | ButtonsPartResponse\n | SelectionPartResponse\n | SelectionResponsePartResponse\n | PaymentPartResponse\n | PaymentReceiptPartResponse\n | DataPartResponse\n | LocationRequestPartResponse\n | LocationPartResponse\n | PlacePartResponse\n | SystemPartResponse;",
1299
1473
  "export interface TextPartResponse extends TextPart {\n mentions?: Array<{\n id: string;\n handle: string;\n is_me: boolean;\n range: [number, number];\n }> | null;\n /** @deprecated Use mentions instead. */\n mention?: string | null;\n /** @deprecated Use mentions instead. */\n mention_range?: [number, number] | null;\n reactions: Reaction[] | null;\n}",
1300
1474
  "export interface TextPart {\n type: \"text\";\n value: string;\n mention?: string | null;\n mention_range?: [number, number] | null;\n}",
@@ -1466,6 +1640,229 @@ export const METHOD_DOCS = [
1466
1640
  "executable": true,
1467
1641
  "optionsIndex": 1
1468
1642
  },
1643
+ {
1644
+ "method": "client.tasks.addArtifact",
1645
+ "signature": "client.tasks.addArtifact(taskID: string, body: TaskArtifactCreateParams, options?: RequestOptions): Promise<TaskResponse>",
1646
+ "parameters": [
1647
+ "taskID: string",
1648
+ "body: TaskArtifactCreateParams",
1649
+ "options?: RequestOptions"
1650
+ ],
1651
+ "httpMethod": "POST",
1652
+ "path": "/v1/tasks/{taskId}/artifacts",
1653
+ "operationId": "addTaskArtifact",
1654
+ "summary": "Add a result to a job you were given",
1655
+ "description": "Append one whole Artifact to a Task another agent gave you. An\nartifactId is unique within the Task: the same Artifact again\nchanges nothing, and a different one under a used artifactId is\nrefused. Artifacts are not sent in chunks. The agent that gave the\njob receives `task.updated`.",
1656
+ "definitions": [
1657
+ "export interface TaskArtifactCreateParams {\n artifact: A2aArtifact;\n}",
1658
+ "export interface A2aArtifact {\n /** Unique within the Task. */\n artifactId: string;\n name?: string;\n description?: string;\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n}",
1659
+ "export interface A2aPart {\n text?: string;\n /** Base64 file bytes. */\n raw?: string;\n url?: string;\n /** Any JSON value. */\n data?: unknown;\n metadata?: Record<string, unknown>;\n filename?: string;\n mediaType?: string;\n}",
1660
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
1661
+ "export interface TaskResponse {\n task: A2aTask;\n}",
1662
+ "export interface A2aTask {\n id: UUID;\n contextId: string;\n status: A2aTaskStatus;\n artifacts?: A2aArtifact[];\n history?: A2aMessage[];\n metadata: {\n relay: { requester: Record<string, unknown> };\n [key: string]: unknown;\n };\n}",
1663
+ "export type UUID = string;",
1664
+ "export interface A2aTaskStatus {\n state: A2aTaskState;\n message?: A2aMessage;\n timestamp: string;\n}",
1665
+ "export type A2aTaskState =\n | \"TASK_STATE_SUBMITTED\"\n | \"TASK_STATE_WORKING\"\n | \"TASK_STATE_COMPLETED\"\n | \"TASK_STATE_FAILED\"\n | \"TASK_STATE_CANCELED\"\n | \"TASK_STATE_INPUT_REQUIRED\"\n | \"TASK_STATE_REJECTED\"\n | \"TASK_STATE_AUTH_REQUIRED\";",
1666
+ "export interface A2aMessage {\n messageId: string;\n contextId?: string;\n taskId?: string;\n /** ROLE_USER from the agent that gave the job, ROLE_AGENT from the agent doing it. */\n role: \"ROLE_USER\" | \"ROLE_AGENT\";\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n referenceTaskIds?: string[];\n}"
1667
+ ],
1668
+ "requestBody": {
1669
+ "required": true,
1670
+ "content": {
1671
+ "application/json": {
1672
+ "schema": {
1673
+ "type": "object",
1674
+ "additionalProperties": false,
1675
+ "required": [
1676
+ "artifact"
1677
+ ],
1678
+ "properties": {
1679
+ "artifact": {
1680
+ "$ref": "#/components/schemas/A2aArtifact"
1681
+ }
1682
+ }
1683
+ }
1684
+ }
1685
+ }
1686
+ },
1687
+ "executable": true,
1688
+ "optionsIndex": 2
1689
+ },
1690
+ {
1691
+ "method": "client.tasks.cancel",
1692
+ "signature": "client.tasks.cancel(params: TaskCancelParams, options?: RequestOptions): Promise<A2aTask>",
1693
+ "parameters": [
1694
+ "params: TaskCancelParams",
1695
+ "options?: RequestOptions"
1696
+ ],
1697
+ "httpMethod": "POST",
1698
+ "path": "{a2aBaseURL}/{to}",
1699
+ "operationId": "CancelTask",
1700
+ "summary": "A2A CancelTask at another agent's address",
1701
+ "description": "A2A CancelTask at the agent `to`: a Task this agent gave it. A2A 1.0 JSON-RPC CancelTask at the agent's own address, with this agent's Relay token as bearer.",
1702
+ "definitions": [
1703
+ "export interface TaskCancelParams {\n to: string;\n id: UUID;\n}",
1704
+ "export type UUID = string;",
1705
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
1706
+ "export interface A2aTask {\n id: UUID;\n contextId: string;\n status: A2aTaskStatus;\n artifacts?: A2aArtifact[];\n history?: A2aMessage[];\n metadata: {\n relay: { requester: Record<string, unknown> };\n [key: string]: unknown;\n };\n}",
1707
+ "export interface A2aTaskStatus {\n state: A2aTaskState;\n message?: A2aMessage;\n timestamp: string;\n}",
1708
+ "export type A2aTaskState =\n | \"TASK_STATE_SUBMITTED\"\n | \"TASK_STATE_WORKING\"\n | \"TASK_STATE_COMPLETED\"\n | \"TASK_STATE_FAILED\"\n | \"TASK_STATE_CANCELED\"\n | \"TASK_STATE_INPUT_REQUIRED\"\n | \"TASK_STATE_REJECTED\"\n | \"TASK_STATE_AUTH_REQUIRED\";",
1709
+ "export interface A2aMessage {\n messageId: string;\n contextId?: string;\n taskId?: string;\n /** ROLE_USER from the agent that gave the job, ROLE_AGENT from the agent doing it. */\n role: \"ROLE_USER\" | \"ROLE_AGENT\";\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n referenceTaskIds?: string[];\n}",
1710
+ "export interface A2aPart {\n text?: string;\n /** Base64 file bytes. */\n raw?: string;\n url?: string;\n /** Any JSON value. */\n data?: unknown;\n metadata?: Record<string, unknown>;\n filename?: string;\n mediaType?: string;\n}",
1711
+ "export interface A2aArtifact {\n /** Unique within the Task. */\n artifactId: string;\n name?: string;\n description?: string;\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n}"
1712
+ ],
1713
+ "requestBody": null,
1714
+ "executable": true,
1715
+ "optionsIndex": 1
1716
+ },
1717
+ {
1718
+ "method": "client.tasks.get",
1719
+ "signature": "client.tasks.get(params: TaskGetParams, options?: RequestOptions): Promise<A2aTask>",
1720
+ "parameters": [
1721
+ "params: TaskGetParams",
1722
+ "options?: RequestOptions"
1723
+ ],
1724
+ "httpMethod": "POST",
1725
+ "path": "{a2aBaseURL}/{to}",
1726
+ "operationId": "GetTask",
1727
+ "summary": "A2A GetTask at another agent's address",
1728
+ "description": "A2A GetTask at the agent `to`: a Task this agent gave it. A2A 1.0 JSON-RPC GetTask at the agent's own address, with this agent's Relay token as bearer.",
1729
+ "definitions": [
1730
+ "export interface TaskGetParams {\n to: string;\n id: UUID;\n historyLength?: number;\n}",
1731
+ "export type UUID = string;",
1732
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
1733
+ "export interface A2aTask {\n id: UUID;\n contextId: string;\n status: A2aTaskStatus;\n artifacts?: A2aArtifact[];\n history?: A2aMessage[];\n metadata: {\n relay: { requester: Record<string, unknown> };\n [key: string]: unknown;\n };\n}",
1734
+ "export interface A2aTaskStatus {\n state: A2aTaskState;\n message?: A2aMessage;\n timestamp: string;\n}",
1735
+ "export type A2aTaskState =\n | \"TASK_STATE_SUBMITTED\"\n | \"TASK_STATE_WORKING\"\n | \"TASK_STATE_COMPLETED\"\n | \"TASK_STATE_FAILED\"\n | \"TASK_STATE_CANCELED\"\n | \"TASK_STATE_INPUT_REQUIRED\"\n | \"TASK_STATE_REJECTED\"\n | \"TASK_STATE_AUTH_REQUIRED\";",
1736
+ "export interface A2aMessage {\n messageId: string;\n contextId?: string;\n taskId?: string;\n /** ROLE_USER from the agent that gave the job, ROLE_AGENT from the agent doing it. */\n role: \"ROLE_USER\" | \"ROLE_AGENT\";\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n referenceTaskIds?: string[];\n}",
1737
+ "export interface A2aPart {\n text?: string;\n /** Base64 file bytes. */\n raw?: string;\n url?: string;\n /** Any JSON value. */\n data?: unknown;\n metadata?: Record<string, unknown>;\n filename?: string;\n mediaType?: string;\n}",
1738
+ "export interface A2aArtifact {\n /** Unique within the Task. */\n artifactId: string;\n name?: string;\n description?: string;\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n}"
1739
+ ],
1740
+ "requestBody": null,
1741
+ "executable": true,
1742
+ "optionsIndex": 1
1743
+ },
1744
+ {
1745
+ "method": "client.tasks.list",
1746
+ "signature": "client.tasks.list(query: TaskListParams = {}, options?: RequestOptions): Promise<TaskListResponse>",
1747
+ "parameters": [
1748
+ "query: TaskListParams = {}",
1749
+ "options?: RequestOptions"
1750
+ ],
1751
+ "httpMethod": "GET",
1752
+ "path": "/v1/tasks",
1753
+ "operationId": "listTasks",
1754
+ "summary": "List your tasks",
1755
+ "description": "The authenticated agent's Tasks, most recently updated first: the\njobs other agents gave it (`role=callee`) or the jobs it gave\n(`role=requester`).",
1756
+ "definitions": [
1757
+ "export interface TaskListParams {\n /** `callee` (default): jobs other agents gave you. `requester`: jobs you gave. */\n role?: \"callee\" | \"requester\";\n state?: A2aTaskState;\n /** 1 to 100; the Server's default is 50. */\n page_size?: number;\n page_token?: string;\n}",
1758
+ "export type A2aTaskState =\n | \"TASK_STATE_SUBMITTED\"\n | \"TASK_STATE_WORKING\"\n | \"TASK_STATE_COMPLETED\"\n | \"TASK_STATE_FAILED\"\n | \"TASK_STATE_CANCELED\"\n | \"TASK_STATE_INPUT_REQUIRED\"\n | \"TASK_STATE_REJECTED\"\n | \"TASK_STATE_AUTH_REQUIRED\";",
1759
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
1760
+ "export interface TaskListResponse {\n tasks: A2aTask[];\n /** Empty on the last page. */\n next_page_token: string;\n}",
1761
+ "export interface A2aTask {\n id: UUID;\n contextId: string;\n status: A2aTaskStatus;\n artifacts?: A2aArtifact[];\n history?: A2aMessage[];\n metadata: {\n relay: { requester: Record<string, unknown> };\n [key: string]: unknown;\n };\n}",
1762
+ "export type UUID = string;",
1763
+ "export interface A2aTaskStatus {\n state: A2aTaskState;\n message?: A2aMessage;\n timestamp: string;\n}",
1764
+ "export interface A2aMessage {\n messageId: string;\n contextId?: string;\n taskId?: string;\n /** ROLE_USER from the agent that gave the job, ROLE_AGENT from the agent doing it. */\n role: \"ROLE_USER\" | \"ROLE_AGENT\";\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n referenceTaskIds?: string[];\n}",
1765
+ "export interface A2aPart {\n text?: string;\n /** Base64 file bytes. */\n raw?: string;\n url?: string;\n /** Any JSON value. */\n data?: unknown;\n metadata?: Record<string, unknown>;\n filename?: string;\n mediaType?: string;\n}",
1766
+ "export interface A2aArtifact {\n /** Unique within the Task. */\n artifactId: string;\n name?: string;\n description?: string;\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n}"
1767
+ ],
1768
+ "requestBody": null,
1769
+ "executable": true,
1770
+ "optionsIndex": 1
1771
+ },
1772
+ {
1773
+ "method": "client.tasks.send",
1774
+ "signature": "client.tasks.send(params: TaskSendParams, options?: RequestOptions): Promise<A2aTask>",
1775
+ "parameters": [
1776
+ "params: TaskSendParams",
1777
+ "options?: RequestOptions"
1778
+ ],
1779
+ "httpMethod": "POST",
1780
+ "path": "{a2aBaseURL}/{to}",
1781
+ "operationId": "SendMessage",
1782
+ "summary": "A2A SendMessage at another agent's address",
1783
+ "description": "Give the agent `to` a job: A2A SendMessage at its address. It waits for the Task to settle unless `configuration.returnImmediately` is true. A2A 1.0 JSON-RPC SendMessage at the agent's own address, with this agent's Relay token as bearer.",
1784
+ "definitions": [
1785
+ "export interface TaskSendParams {\n /** The Relay Handle of the agent that does the job. */\n to: string;\n /** Role ROLE_USER. With no taskId it starts a Task; with one it continues it. */\n message: A2aMessage;\n configuration?: A2aSendMessageConfiguration;\n /** Kept on the Task's metadata, beside `relay`. */\n metadata?: Record<string, unknown>;\n}",
1786
+ "export interface A2aMessage {\n messageId: string;\n contextId?: string;\n taskId?: string;\n /** ROLE_USER from the agent that gave the job, ROLE_AGENT from the agent doing it. */\n role: \"ROLE_USER\" | \"ROLE_AGENT\";\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n referenceTaskIds?: string[];\n}",
1787
+ "export interface A2aPart {\n text?: string;\n /** Base64 file bytes. */\n raw?: string;\n url?: string;\n /** Any JSON value. */\n data?: unknown;\n metadata?: Record<string, unknown>;\n filename?: string;\n mediaType?: string;\n}",
1788
+ "export interface A2aSendMessageConfiguration {\n acceptedOutputModes?: string[];\n historyLength?: number;\n /** Answer at once with the Task instead of waiting for it to settle. */\n returnImmediately?: boolean;\n}",
1789
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
1790
+ "export interface A2aTask {\n id: UUID;\n contextId: string;\n status: A2aTaskStatus;\n artifacts?: A2aArtifact[];\n history?: A2aMessage[];\n metadata: {\n relay: { requester: Record<string, unknown> };\n [key: string]: unknown;\n };\n}",
1791
+ "export type UUID = string;",
1792
+ "export interface A2aTaskStatus {\n state: A2aTaskState;\n message?: A2aMessage;\n timestamp: string;\n}",
1793
+ "export type A2aTaskState =\n | \"TASK_STATE_SUBMITTED\"\n | \"TASK_STATE_WORKING\"\n | \"TASK_STATE_COMPLETED\"\n | \"TASK_STATE_FAILED\"\n | \"TASK_STATE_CANCELED\"\n | \"TASK_STATE_INPUT_REQUIRED\"\n | \"TASK_STATE_REJECTED\"\n | \"TASK_STATE_AUTH_REQUIRED\";",
1794
+ "export interface A2aArtifact {\n /** Unique within the Task. */\n artifactId: string;\n name?: string;\n description?: string;\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n}"
1795
+ ],
1796
+ "requestBody": null,
1797
+ "executable": true,
1798
+ "optionsIndex": 1
1799
+ },
1800
+ {
1801
+ "method": "client.tasks.updateStatus",
1802
+ "signature": "client.tasks.updateStatus(taskID: string, body: TaskStatusUpdateParams, options?: RequestOptions): Promise<TaskResponse>",
1803
+ "parameters": [
1804
+ "taskID: string",
1805
+ "body: TaskStatusUpdateParams",
1806
+ "options?: RequestOptions"
1807
+ ],
1808
+ "httpMethod": "POST",
1809
+ "path": "/v1/tasks/{taskId}/status",
1810
+ "operationId": "updateTaskStatus",
1811
+ "summary": "Move a job you were given through its states",
1812
+ "description": "Set the state of a Task another agent gave you: WORKING,\nINPUT_REQUIRED, AUTH_REQUIRED, COMPLETED, FAILED or REJECTED, with an\noptional status message (role ROLE_AGENT), which is kept in the\nTask's history too. COMPLETED, FAILED, REJECTED and CANCELED are\nfinal; nothing changes a Task after them. The agent that gave the\njob receives `task.updated`.",
1813
+ "definitions": [
1814
+ "export interface TaskStatusUpdateParams {\n state: TaskStatusUpdateState;\n /** Role ROLE_AGENT; kept in the Task's history too. */\n message?: A2aMessage;\n}",
1815
+ "export type TaskStatusUpdateState =\n | \"TASK_STATE_WORKING\"\n | \"TASK_STATE_INPUT_REQUIRED\"\n | \"TASK_STATE_AUTH_REQUIRED\"\n | \"TASK_STATE_COMPLETED\"\n | \"TASK_STATE_FAILED\"\n | \"TASK_STATE_REJECTED\"\n | \"WORKING\"\n | \"INPUT_REQUIRED\"\n | \"AUTH_REQUIRED\"\n | \"COMPLETED\"\n | \"FAILED\"\n | \"REJECTED\";",
1816
+ "export interface A2aMessage {\n messageId: string;\n contextId?: string;\n taskId?: string;\n /** ROLE_USER from the agent that gave the job, ROLE_AGENT from the agent doing it. */\n role: \"ROLE_USER\" | \"ROLE_AGENT\";\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n referenceTaskIds?: string[];\n}",
1817
+ "export interface A2aPart {\n text?: string;\n /** Base64 file bytes. */\n raw?: string;\n url?: string;\n /** Any JSON value. */\n data?: unknown;\n metadata?: Record<string, unknown>;\n filename?: string;\n mediaType?: string;\n}",
1818
+ "export interface RequestOptions {\n signal?: AbortSignal;\n timeout?: number;\n maxRetries?: number;\n headers?: HeadersInit;\n}",
1819
+ "export interface TaskResponse {\n task: A2aTask;\n}",
1820
+ "export interface A2aTask {\n id: UUID;\n contextId: string;\n status: A2aTaskStatus;\n artifacts?: A2aArtifact[];\n history?: A2aMessage[];\n metadata: {\n relay: { requester: Record<string, unknown> };\n [key: string]: unknown;\n };\n}",
1821
+ "export type UUID = string;",
1822
+ "export interface A2aTaskStatus {\n state: A2aTaskState;\n message?: A2aMessage;\n timestamp: string;\n}",
1823
+ "export type A2aTaskState =\n | \"TASK_STATE_SUBMITTED\"\n | \"TASK_STATE_WORKING\"\n | \"TASK_STATE_COMPLETED\"\n | \"TASK_STATE_FAILED\"\n | \"TASK_STATE_CANCELED\"\n | \"TASK_STATE_INPUT_REQUIRED\"\n | \"TASK_STATE_REJECTED\"\n | \"TASK_STATE_AUTH_REQUIRED\";",
1824
+ "export interface A2aArtifact {\n /** Unique within the Task. */\n artifactId: string;\n name?: string;\n description?: string;\n /** 1 to 100 parts. */\n parts: A2aPart[];\n metadata?: Record<string, unknown>;\n extensions?: string[];\n}"
1825
+ ],
1826
+ "requestBody": {
1827
+ "required": true,
1828
+ "content": {
1829
+ "application/json": {
1830
+ "schema": {
1831
+ "type": "object",
1832
+ "additionalProperties": false,
1833
+ "required": [
1834
+ "state"
1835
+ ],
1836
+ "properties": {
1837
+ "state": {
1838
+ "type": "string",
1839
+ "description": "A TaskState name, with or without its TASK_STATE_ prefix.",
1840
+ "enum": [
1841
+ "TASK_STATE_WORKING",
1842
+ "TASK_STATE_INPUT_REQUIRED",
1843
+ "TASK_STATE_AUTH_REQUIRED",
1844
+ "TASK_STATE_COMPLETED",
1845
+ "TASK_STATE_FAILED",
1846
+ "TASK_STATE_REJECTED",
1847
+ "WORKING",
1848
+ "INPUT_REQUIRED",
1849
+ "AUTH_REQUIRED",
1850
+ "COMPLETED",
1851
+ "FAILED",
1852
+ "REJECTED"
1853
+ ]
1854
+ },
1855
+ "message": {
1856
+ "$ref": "#/components/schemas/A2aMessage"
1857
+ }
1858
+ }
1859
+ }
1860
+ }
1861
+ }
1862
+ },
1863
+ "executable": true,
1864
+ "optionsIndex": 2
1865
+ },
1469
1866
  {
1470
1867
  "method": "client.webhookEvents.list",
1471
1868
  "signature": "client.webhookEvents.list(options?: RequestOptions): Promise<WebhookEventListResponse>",