@1claw/sdk 0.42.0 → 0.43.0

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.
@@ -5019,6 +5019,224 @@ export interface paths {
5019
5019
  patch?: never;
5020
5020
  trace?: never;
5021
5021
  };
5022
+ "/v1/agents/{agent_id}/chat": {
5023
+ parameters: {
5024
+ query?: never;
5025
+ header?: never;
5026
+ path?: never;
5027
+ cookie?: never;
5028
+ };
5029
+ get?: never;
5030
+ put?: never;
5031
+ /**
5032
+ * Send chat message
5033
+ * @description Send a message to an agent and receive a response via Shroud LLM.
5034
+ * Supports SSE streaming when Accept: text/event-stream is set.
5035
+ */
5036
+ post: operations["sendChatMessage"];
5037
+ delete?: never;
5038
+ options?: never;
5039
+ head?: never;
5040
+ patch?: never;
5041
+ trace?: never;
5042
+ };
5043
+ "/v1/agents/{agent_id}/chat/conversations": {
5044
+ parameters: {
5045
+ query?: never;
5046
+ header?: never;
5047
+ path?: never;
5048
+ cookie?: never;
5049
+ };
5050
+ /**
5051
+ * List conversations
5052
+ * @description List all chat conversations for an agent.
5053
+ */
5054
+ get: operations["listChatConversations"];
5055
+ put?: never;
5056
+ post?: never;
5057
+ delete?: never;
5058
+ options?: never;
5059
+ head?: never;
5060
+ patch?: never;
5061
+ trace?: never;
5062
+ };
5063
+ "/v1/agents/{agent_id}/chat/conversations/{conversation_id}": {
5064
+ parameters: {
5065
+ query?: never;
5066
+ header?: never;
5067
+ path?: never;
5068
+ cookie?: never;
5069
+ };
5070
+ /**
5071
+ * Get conversation
5072
+ * @description Get a conversation with its full message history.
5073
+ */
5074
+ get: operations["getChatConversation"];
5075
+ put?: never;
5076
+ post?: never;
5077
+ /**
5078
+ * Archive conversation
5079
+ * @description Archive (soft-delete) a chat conversation.
5080
+ */
5081
+ delete: operations["deleteChatConversation"];
5082
+ options?: never;
5083
+ head?: never;
5084
+ patch?: never;
5085
+ trace?: never;
5086
+ };
5087
+ "/v1/agents/{agent_id}/channels": {
5088
+ parameters: {
5089
+ query?: never;
5090
+ header?: never;
5091
+ path?: never;
5092
+ cookie?: never;
5093
+ };
5094
+ /**
5095
+ * List channels
5096
+ * @description List all messaging channels for an agent.
5097
+ */
5098
+ get: operations["listChannels"];
5099
+ put?: never;
5100
+ /**
5101
+ * Register channel
5102
+ * @description Register a new external messaging channel (Telegram, WhatsApp, Discord)
5103
+ * for an agent. Human-only. Returns the channel with its webhook URL.
5104
+ */
5105
+ post: operations["createChannel"];
5106
+ delete?: never;
5107
+ options?: never;
5108
+ head?: never;
5109
+ patch?: never;
5110
+ trace?: never;
5111
+ };
5112
+ "/v1/agents/{agent_id}/channels/{channel_id}": {
5113
+ parameters: {
5114
+ query?: never;
5115
+ header?: never;
5116
+ path?: never;
5117
+ cookie?: never;
5118
+ };
5119
+ get?: never;
5120
+ put?: never;
5121
+ post?: never;
5122
+ /**
5123
+ * Delete channel
5124
+ * @description Delete a messaging channel. Human-only.
5125
+ */
5126
+ delete: operations["deleteChannel"];
5127
+ options?: never;
5128
+ head?: never;
5129
+ /**
5130
+ * Update channel
5131
+ * @description Update a channel's name, active status, or config. Human-only.
5132
+ */
5133
+ patch: operations["updateChannel"];
5134
+ trace?: never;
5135
+ };
5136
+ "/v1/agents/{agent_id}/channels/{channel_id}/send": {
5137
+ parameters: {
5138
+ query?: never;
5139
+ header?: never;
5140
+ path?: never;
5141
+ cookie?: never;
5142
+ };
5143
+ get?: never;
5144
+ put?: never;
5145
+ /**
5146
+ * Send outbound message
5147
+ * @description Send an outbound message via a registered channel.
5148
+ */
5149
+ post: operations["sendChannelMessage"];
5150
+ delete?: never;
5151
+ options?: never;
5152
+ head?: never;
5153
+ patch?: never;
5154
+ trace?: never;
5155
+ };
5156
+ "/v1/agents/{agent_id}/channels/{channel_id}/messages": {
5157
+ parameters: {
5158
+ query?: never;
5159
+ header?: never;
5160
+ path?: never;
5161
+ cookie?: never;
5162
+ };
5163
+ /**
5164
+ * Channel message history
5165
+ * @description List inbound and outbound messages for a channel.
5166
+ */
5167
+ get: operations["listChannelMessages"];
5168
+ put?: never;
5169
+ post?: never;
5170
+ delete?: never;
5171
+ options?: never;
5172
+ head?: never;
5173
+ patch?: never;
5174
+ trace?: never;
5175
+ };
5176
+ "/v1/webhooks/telegram/{webhook_path}": {
5177
+ parameters: {
5178
+ query?: never;
5179
+ header?: never;
5180
+ path?: never;
5181
+ cookie?: never;
5182
+ };
5183
+ get?: never;
5184
+ put?: never;
5185
+ /**
5186
+ * Telegram webhook
5187
+ * @description Public webhook endpoint for receiving Telegram bot updates.
5188
+ */
5189
+ post: operations["telegramWebhook"];
5190
+ delete?: never;
5191
+ options?: never;
5192
+ head?: never;
5193
+ patch?: never;
5194
+ trace?: never;
5195
+ };
5196
+ "/v1/webhooks/whatsapp/{webhook_path}": {
5197
+ parameters: {
5198
+ query?: never;
5199
+ header?: never;
5200
+ path?: never;
5201
+ cookie?: never;
5202
+ };
5203
+ /**
5204
+ * WhatsApp webhook verification
5205
+ * @description Verification endpoint for WhatsApp Cloud API webhook setup.
5206
+ */
5207
+ get: operations["whatsappWebhookVerify"];
5208
+ put?: never;
5209
+ /**
5210
+ * WhatsApp webhook
5211
+ * @description Public webhook endpoint for receiving WhatsApp Cloud API events.
5212
+ */
5213
+ post: operations["whatsappWebhook"];
5214
+ delete?: never;
5215
+ options?: never;
5216
+ head?: never;
5217
+ patch?: never;
5218
+ trace?: never;
5219
+ };
5220
+ "/v1/webhooks/discord/{webhook_path}": {
5221
+ parameters: {
5222
+ query?: never;
5223
+ header?: never;
5224
+ path?: never;
5225
+ cookie?: never;
5226
+ };
5227
+ get?: never;
5228
+ put?: never;
5229
+ /**
5230
+ * Discord webhook
5231
+ * @description Public webhook endpoint for receiving Discord bot interactions.
5232
+ */
5233
+ post: operations["discordWebhook"];
5234
+ delete?: never;
5235
+ options?: never;
5236
+ head?: never;
5237
+ patch?: never;
5238
+ trace?: never;
5239
+ };
5022
5240
  }
5023
5241
  export type webhooks = Record<string, never>;
5024
5242
  export interface components {
@@ -8297,6 +8515,123 @@ export interface components {
8297
8515
  public_description?: string;
8298
8516
  public_tags?: string[];
8299
8517
  };
8518
+ SendChatMessageRequest: {
8519
+ message: string;
8520
+ /** Format: uuid */
8521
+ conversation_id?: string;
8522
+ mode?: string;
8523
+ model?: string;
8524
+ provider?: string;
8525
+ system_prompt?: string;
8526
+ };
8527
+ ChatMessageResponse: {
8528
+ /** Format: uuid */
8529
+ id?: string;
8530
+ /** Format: uuid */
8531
+ conversation_id?: string;
8532
+ role?: string;
8533
+ content?: string;
8534
+ tool_calls?: unknown;
8535
+ tool_results?: unknown;
8536
+ tokens_prompt?: number;
8537
+ tokens_completion?: number;
8538
+ model?: string;
8539
+ /** Format: date-time */
8540
+ created_at?: string;
8541
+ };
8542
+ ChatConversationResponse: {
8543
+ /** Format: uuid */
8544
+ id?: string;
8545
+ /** Format: uuid */
8546
+ agent_id?: string;
8547
+ title?: string;
8548
+ mode?: string;
8549
+ model?: string;
8550
+ provider?: string;
8551
+ /** Format: date-time */
8552
+ created_at?: string;
8553
+ /** Format: date-time */
8554
+ updated_at?: string;
8555
+ };
8556
+ ChatConversationListResponse: {
8557
+ conversations?: components["schemas"]["ChatConversationResponse"][];
8558
+ };
8559
+ ConversationDetailResponse: {
8560
+ conversation?: components["schemas"]["ChatConversationResponse"];
8561
+ messages?: components["schemas"]["ChatMessageResponse"][];
8562
+ };
8563
+ SendChatMessageResponse: {
8564
+ /** Format: uuid */
8565
+ conversation_id?: string;
8566
+ message?: components["schemas"]["ChatMessageResponse"];
8567
+ };
8568
+ CreateChannelRequest: {
8569
+ /** @enum {string} */
8570
+ channel_type: "telegram" | "whatsapp" | "discord";
8571
+ channel_name?: string;
8572
+ /**
8573
+ * @description Platform-specific config.
8574
+ * Telegram: { bot_token }.
8575
+ * WhatsApp: { phone_number_id, access_token, verify_token }.
8576
+ * Discord: { bot_token, application_id }.
8577
+ */
8578
+ config: {
8579
+ [key: string]: string;
8580
+ };
8581
+ };
8582
+ UpdateChannelRequest: {
8583
+ channel_name?: string;
8584
+ is_active?: boolean;
8585
+ config?: {
8586
+ [key: string]: string;
8587
+ };
8588
+ };
8589
+ ChannelResponse: {
8590
+ /** Format: uuid */
8591
+ id?: string;
8592
+ /** Format: uuid */
8593
+ org_id?: string;
8594
+ /** Format: uuid */
8595
+ agent_id?: string;
8596
+ /** @enum {string} */
8597
+ channel_type?: "telegram" | "whatsapp" | "discord";
8598
+ channel_name?: string;
8599
+ webhook_path?: string;
8600
+ webhook_url?: string;
8601
+ is_active?: boolean;
8602
+ /** Format: date-time */
8603
+ created_at?: string;
8604
+ /** Format: date-time */
8605
+ updated_at?: string;
8606
+ };
8607
+ ChannelListResponse: {
8608
+ channels?: components["schemas"]["ChannelResponse"][];
8609
+ };
8610
+ SendChannelMessageRequest: {
8611
+ /** @description External platform chat/user ID */
8612
+ external_chat_id: string;
8613
+ content: string;
8614
+ /** @description External message ID to reply to */
8615
+ reply_to?: string;
8616
+ };
8617
+ ChannelMessageResponse: {
8618
+ /** Format: uuid */
8619
+ id?: string;
8620
+ /** Format: uuid */
8621
+ channel_id?: string;
8622
+ /** @enum {string} */
8623
+ direction?: "inbound" | "outbound";
8624
+ external_chat_id?: string;
8625
+ external_message_id?: string;
8626
+ sender_name?: string;
8627
+ content?: string;
8628
+ media_url?: string;
8629
+ /** Format: date-time */
8630
+ created_at?: string;
8631
+ };
8632
+ ChannelMessageListResponse: {
8633
+ messages?: components["schemas"]["ChannelMessageResponse"][];
8634
+ };
8300
8635
  };
8301
8636
  responses: {
8302
8637
  /** @description Invalid request */
@@ -15056,5 +15391,362 @@ export interface operations {
15056
15391
  };
15057
15392
  };
15058
15393
  };
15394
+ sendChatMessage: {
15395
+ parameters: {
15396
+ query?: never;
15397
+ header?: never;
15398
+ path: {
15399
+ agent_id: components["parameters"]["AgentId"];
15400
+ };
15401
+ cookie?: never;
15402
+ };
15403
+ requestBody: {
15404
+ content: {
15405
+ "application/json": components["schemas"]["SendChatMessageRequest"];
15406
+ };
15407
+ };
15408
+ responses: {
15409
+ /** @description Chat response */
15410
+ 200: {
15411
+ headers: {
15412
+ [name: string]: unknown;
15413
+ };
15414
+ content: {
15415
+ "application/json": components["schemas"]["SendChatMessageResponse"];
15416
+ "text/event-stream": string;
15417
+ };
15418
+ };
15419
+ 401: components["responses"]["Unauthorized"];
15420
+ 403: components["responses"]["Forbidden"];
15421
+ };
15422
+ };
15423
+ listChatConversations: {
15424
+ parameters: {
15425
+ query?: never;
15426
+ header?: never;
15427
+ path: {
15428
+ agent_id: components["parameters"]["AgentId"];
15429
+ };
15430
+ cookie?: never;
15431
+ };
15432
+ requestBody?: never;
15433
+ responses: {
15434
+ /** @description Conversation list */
15435
+ 200: {
15436
+ headers: {
15437
+ [name: string]: unknown;
15438
+ };
15439
+ content: {
15440
+ "application/json": components["schemas"]["ChatConversationListResponse"];
15441
+ };
15442
+ };
15443
+ 401: components["responses"]["Unauthorized"];
15444
+ };
15445
+ };
15446
+ getChatConversation: {
15447
+ parameters: {
15448
+ query?: never;
15449
+ header?: never;
15450
+ path: {
15451
+ agent_id: components["parameters"]["AgentId"];
15452
+ conversation_id: string;
15453
+ };
15454
+ cookie?: never;
15455
+ };
15456
+ requestBody?: never;
15457
+ responses: {
15458
+ /** @description Conversation detail */
15459
+ 200: {
15460
+ headers: {
15461
+ [name: string]: unknown;
15462
+ };
15463
+ content: {
15464
+ "application/json": components["schemas"]["ConversationDetailResponse"];
15465
+ };
15466
+ };
15467
+ 401: components["responses"]["Unauthorized"];
15468
+ 404: components["responses"]["NotFound"];
15469
+ };
15470
+ };
15471
+ deleteChatConversation: {
15472
+ parameters: {
15473
+ query?: never;
15474
+ header?: never;
15475
+ path: {
15476
+ agent_id: components["parameters"]["AgentId"];
15477
+ conversation_id: string;
15478
+ };
15479
+ cookie?: never;
15480
+ };
15481
+ requestBody?: never;
15482
+ responses: {
15483
+ /** @description Conversation archived */
15484
+ 204: {
15485
+ headers: {
15486
+ [name: string]: unknown;
15487
+ };
15488
+ content?: never;
15489
+ };
15490
+ 401: components["responses"]["Unauthorized"];
15491
+ 404: components["responses"]["NotFound"];
15492
+ };
15493
+ };
15494
+ listChannels: {
15495
+ parameters: {
15496
+ query?: never;
15497
+ header?: never;
15498
+ path: {
15499
+ agent_id: components["parameters"]["AgentId"];
15500
+ };
15501
+ cookie?: never;
15502
+ };
15503
+ requestBody?: never;
15504
+ responses: {
15505
+ /** @description Channel list */
15506
+ 200: {
15507
+ headers: {
15508
+ [name: string]: unknown;
15509
+ };
15510
+ content: {
15511
+ "application/json": components["schemas"]["ChannelListResponse"];
15512
+ };
15513
+ };
15514
+ 401: components["responses"]["Unauthorized"];
15515
+ };
15516
+ };
15517
+ createChannel: {
15518
+ parameters: {
15519
+ query?: never;
15520
+ header?: never;
15521
+ path: {
15522
+ agent_id: components["parameters"]["AgentId"];
15523
+ };
15524
+ cookie?: never;
15525
+ };
15526
+ requestBody: {
15527
+ content: {
15528
+ "application/json": components["schemas"]["CreateChannelRequest"];
15529
+ };
15530
+ };
15531
+ responses: {
15532
+ /** @description Channel created */
15533
+ 201: {
15534
+ headers: {
15535
+ [name: string]: unknown;
15536
+ };
15537
+ content: {
15538
+ "application/json": components["schemas"]["ChannelResponse"];
15539
+ };
15540
+ };
15541
+ 400: components["responses"]["BadRequest"];
15542
+ 401: components["responses"]["Unauthorized"];
15543
+ 403: components["responses"]["Forbidden"];
15544
+ };
15545
+ };
15546
+ deleteChannel: {
15547
+ parameters: {
15548
+ query?: never;
15549
+ header?: never;
15550
+ path: {
15551
+ agent_id: components["parameters"]["AgentId"];
15552
+ channel_id: string;
15553
+ };
15554
+ cookie?: never;
15555
+ };
15556
+ requestBody?: never;
15557
+ responses: {
15558
+ /** @description Channel deleted */
15559
+ 204: {
15560
+ headers: {
15561
+ [name: string]: unknown;
15562
+ };
15563
+ content?: never;
15564
+ };
15565
+ 401: components["responses"]["Unauthorized"];
15566
+ 403: components["responses"]["Forbidden"];
15567
+ 404: components["responses"]["NotFound"];
15568
+ };
15569
+ };
15570
+ updateChannel: {
15571
+ parameters: {
15572
+ query?: never;
15573
+ header?: never;
15574
+ path: {
15575
+ agent_id: components["parameters"]["AgentId"];
15576
+ channel_id: string;
15577
+ };
15578
+ cookie?: never;
15579
+ };
15580
+ requestBody: {
15581
+ content: {
15582
+ "application/json": components["schemas"]["UpdateChannelRequest"];
15583
+ };
15584
+ };
15585
+ responses: {
15586
+ /** @description Channel updated */
15587
+ 200: {
15588
+ headers: {
15589
+ [name: string]: unknown;
15590
+ };
15591
+ content: {
15592
+ "application/json": components["schemas"]["ChannelResponse"];
15593
+ };
15594
+ };
15595
+ 401: components["responses"]["Unauthorized"];
15596
+ 403: components["responses"]["Forbidden"];
15597
+ 404: components["responses"]["NotFound"];
15598
+ };
15599
+ };
15600
+ sendChannelMessage: {
15601
+ parameters: {
15602
+ query?: never;
15603
+ header?: never;
15604
+ path: {
15605
+ agent_id: components["parameters"]["AgentId"];
15606
+ channel_id: string;
15607
+ };
15608
+ cookie?: never;
15609
+ };
15610
+ requestBody: {
15611
+ content: {
15612
+ "application/json": components["schemas"]["SendChannelMessageRequest"];
15613
+ };
15614
+ };
15615
+ responses: {
15616
+ /** @description Message sent */
15617
+ 200: {
15618
+ headers: {
15619
+ [name: string]: unknown;
15620
+ };
15621
+ content: {
15622
+ "application/json": components["schemas"]["ChannelMessageResponse"];
15623
+ };
15624
+ };
15625
+ 401: components["responses"]["Unauthorized"];
15626
+ 404: components["responses"]["NotFound"];
15627
+ };
15628
+ };
15629
+ listChannelMessages: {
15630
+ parameters: {
15631
+ query?: {
15632
+ limit?: number;
15633
+ };
15634
+ header?: never;
15635
+ path: {
15636
+ agent_id: components["parameters"]["AgentId"];
15637
+ channel_id: string;
15638
+ };
15639
+ cookie?: never;
15640
+ };
15641
+ requestBody?: never;
15642
+ responses: {
15643
+ /** @description Message list */
15644
+ 200: {
15645
+ headers: {
15646
+ [name: string]: unknown;
15647
+ };
15648
+ content: {
15649
+ "application/json": components["schemas"]["ChannelMessageListResponse"];
15650
+ };
15651
+ };
15652
+ 401: components["responses"]["Unauthorized"];
15653
+ };
15654
+ };
15655
+ telegramWebhook: {
15656
+ parameters: {
15657
+ query?: never;
15658
+ header?: never;
15659
+ path: {
15660
+ webhook_path: string;
15661
+ };
15662
+ cookie?: never;
15663
+ };
15664
+ requestBody: {
15665
+ content: {
15666
+ "application/json": Record<string, never>;
15667
+ };
15668
+ };
15669
+ responses: {
15670
+ /** @description Webhook processed */
15671
+ 200: {
15672
+ headers: {
15673
+ [name: string]: unknown;
15674
+ };
15675
+ content?: never;
15676
+ };
15677
+ };
15678
+ };
15679
+ whatsappWebhookVerify: {
15680
+ parameters: {
15681
+ query?: {
15682
+ "hub.mode"?: string;
15683
+ "hub.verify_token"?: string;
15684
+ "hub.challenge"?: string;
15685
+ };
15686
+ header?: never;
15687
+ path: {
15688
+ webhook_path: string;
15689
+ };
15690
+ cookie?: never;
15691
+ };
15692
+ requestBody?: never;
15693
+ responses: {
15694
+ /** @description Challenge response */
15695
+ 200: {
15696
+ headers: {
15697
+ [name: string]: unknown;
15698
+ };
15699
+ content?: never;
15700
+ };
15701
+ };
15702
+ };
15703
+ whatsappWebhook: {
15704
+ parameters: {
15705
+ query?: never;
15706
+ header?: never;
15707
+ path: {
15708
+ webhook_path: string;
15709
+ };
15710
+ cookie?: never;
15711
+ };
15712
+ requestBody: {
15713
+ content: {
15714
+ "application/json": Record<string, never>;
15715
+ };
15716
+ };
15717
+ responses: {
15718
+ /** @description Webhook processed */
15719
+ 200: {
15720
+ headers: {
15721
+ [name: string]: unknown;
15722
+ };
15723
+ content?: never;
15724
+ };
15725
+ };
15726
+ };
15727
+ discordWebhook: {
15728
+ parameters: {
15729
+ query?: never;
15730
+ header?: never;
15731
+ path: {
15732
+ webhook_path: string;
15733
+ };
15734
+ cookie?: never;
15735
+ };
15736
+ requestBody: {
15737
+ content: {
15738
+ "application/json": Record<string, never>;
15739
+ };
15740
+ };
15741
+ responses: {
15742
+ /** @description Webhook processed */
15743
+ 200: {
15744
+ headers: {
15745
+ [name: string]: unknown;
15746
+ };
15747
+ content?: never;
15748
+ };
15749
+ };
15750
+ };
15059
15751
  }
15060
15752
  //# sourceMappingURL=api-types.d.ts.map