@naturali/sdk 0.46.1 → 0.47.1

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.
package/dist/index.d.cts CHANGED
@@ -1036,7 +1036,7 @@ type ChannelBindingSet = {
1036
1036
  status?: 'active' | 'disabled';
1037
1037
  };
1038
1038
  /**
1039
- * One contact's dialogue on a channel — naturali-native, keyed by (channel, contact identity) so the same identifier never opens two conversations, and mapped 1:1 to the runtime session that carries the message history. `contact_id` is who the dialogue is with (see the Contacts API); a merge moves it without disturbing the identity that keys the dialogue.
1039
+ * An address's dialogue on a channel — naturali-native, keyed by (channel, address) so the same identifier never opens two conversations, and mapped 1:1 to the runtime session that carries the message history.
1040
1040
  *
1041
1041
  */
1042
1042
  type Conversation = {
@@ -1044,21 +1044,17 @@ type Conversation = {
1044
1044
  project_id: string;
1045
1045
  channel_id: string;
1046
1046
  /**
1047
- * The contact this dialogue belongs to.
1048
- */
1049
- contact_id: string;
1050
- /**
1051
- * The `(channel, identifier)` pair the dialogue arrived at — the continuity key.
1047
+ * The address the dialogue arrived at — the continuity key.
1052
1048
  *
1053
1049
  */
1054
- contact_identity_id: string;
1050
+ address_id: string;
1055
1051
  /**
1056
- * The contact's normalized channel identifier a phone number on WhatsApp; a Discord user id in DMs, or `thread:<id>` for a guild thread, where the thread itself is the contact. Read through from the identity above.
1052
+ * The prefixed, self-describing channel identifier (`whatsapp:dm:…`, `discord:dm:…`, `discord:thread:…`). Read through from the address above.
1057
1053
  *
1058
1054
  */
1059
- contact_identifier: string | null;
1055
+ identifier: string | null;
1060
1056
  /**
1061
- * The runtime actor the contact speaks as. Null when the contact has not needed one yet.
1057
+ * The runtime actor the address speaks as. Null when the address has not needed one yet.
1062
1058
  *
1063
1059
  */
1064
1060
  actor_id: string | null;
@@ -1111,179 +1107,6 @@ type ConversationMessageList = {
1111
1107
  limit: number;
1112
1108
  offset: number;
1113
1109
  };
1114
- /**
1115
- * An end-user identity, mergeable across channel identifiers. Scoped to the project, which is what makes merge possible: the same human on WhatsApp and on Discord is one contact with two identities.
1116
- *
1117
- */
1118
- type Contact = {
1119
- /**
1120
- * Public contact ID (cont_ prefix).
1121
- */
1122
- id: string;
1123
- project_id: string;
1124
- display_name: string | null;
1125
- /**
1126
- * The customer's own reference for this human — their `users.id`, a CRM id. Unique within the project, and propagated into a session's `tool_context` as `actor_external_id` so the customer's HTTP tools receive the identity they already key on.
1127
- *
1128
- */
1129
- external_id: string | null;
1130
- /**
1131
- * Free-form customer-owned bag; naturali never reads inside it.
1132
- */
1133
- metadata: {
1134
- [key: string]: unknown;
1135
- } | null;
1136
- /**
1137
- * The runtime actor the contact speaks as — one per contact, created on first need. Memory hangs off it.
1138
- *
1139
- */
1140
- actor_id: string | null;
1141
- /**
1142
- * Set when this contact was merged into another: the survivor's id. The row is kept as a tombstone so the merge can be reverted.
1143
- *
1144
- */
1145
- merged_into_id: string | null;
1146
- /**
1147
- * The `(channel, identifier)` pairs this contact is reachable at.
1148
- */
1149
- identities: Array<ContactIdentity>;
1150
- created_at: Date;
1151
- updated_at: Date;
1152
- };
1153
- type ContactCreate = {
1154
- display_name?: string;
1155
- /**
1156
- * Unique within the project.
1157
- */
1158
- external_id?: string;
1159
- metadata?: {
1160
- [key: string]: unknown;
1161
- };
1162
- /**
1163
- * Identifiers to attach at creation; each must be free (C3).
1164
- */
1165
- identities?: Array<ContactIdentityCreate>;
1166
- };
1167
- /**
1168
- * At least one field is required. Send `external_id: null` to clear the customer-side reference.
1169
- *
1170
- */
1171
- type ContactUpdate = {
1172
- display_name?: string;
1173
- external_id?: string | null;
1174
- metadata?: {
1175
- [key: string]: unknown;
1176
- };
1177
- };
1178
- type ContactList = {
1179
- data: Array<Contact>;
1180
- /**
1181
- * Cursor for the next page, or null when there are no more.
1182
- */
1183
- next_cursor: string | null;
1184
- };
1185
- /**
1186
- * One `(channel, identifier)` pair a contact is reachable at. The identifier is stored as the channel's adapter normalized it; the same normalized identifier never belongs to two contacts in a project (C3).
1187
- *
1188
- */
1189
- type ContactIdentity = {
1190
- /**
1191
- * Public identity ID (cid_ prefix).
1192
- */
1193
- id: string;
1194
- contact_id: string;
1195
- /**
1196
- * The channel *kind*, not a channel id — a project that reconnects its number keeps its contacts.
1197
- */
1198
- channel: 'whatsapp' | 'discord';
1199
- /**
1200
- * A phone number on WhatsApp; a Discord user id, or `thread:<id>` for a guild thread, where the thread itself is the contact.
1201
- *
1202
- */
1203
- identifier: string;
1204
- /**
1205
- * A human-friendly name as this channel reported it.
1206
- */
1207
- display_name: string | null;
1208
- created_at: Date;
1209
- updated_at: Date;
1210
- };
1211
- type ContactIdentityCreate = {
1212
- channel: 'whatsapp' | 'discord';
1213
- identifier: string;
1214
- display_name?: string;
1215
- };
1216
- /**
1217
- * One of the contact's dialogues, as the contacts resource reports it. The channel-scoped Conversation schema carries the same row plus the identifier read through from the identity.
1218
- *
1219
- */
1220
- type ContactConversation = {
1221
- id: string;
1222
- project_id: string;
1223
- channel_id: string;
1224
- contact_id: string;
1225
- contact_identity_id: string;
1226
- /**
1227
- * The runtime session this conversation maps 1:1 to.
1228
- */
1229
- session_id: string;
1230
- created_at: Date;
1231
- updated_at: Date;
1232
- };
1233
- type ContactConversationList = {
1234
- data: Array<ContactConversation>;
1235
- next_cursor: string | null;
1236
- };
1237
- type ContactMergeRequest = {
1238
- /**
1239
- * The contact to fold into this one. It must live in the same project and must not itself already be merged away.
1240
- *
1241
- */
1242
- source_contact_id: string;
1243
- };
1244
- /**
1245
- * The record of one merge — what moved, and what a revert would put back.
1246
- *
1247
- */
1248
- type ContactMerge = {
1249
- /**
1250
- * Public merge ID (cmrg_ prefix).
1251
- */
1252
- id: string;
1253
- project_id: string;
1254
- /**
1255
- * The survivor — the contact everything moved into.
1256
- */
1257
- target_contact_id: string;
1258
- /**
1259
- * The absorbed contact, kept as a tombstone.
1260
- */
1261
- source_contact_id: string;
1262
- /**
1263
- * The identities re-pointed at the target.
1264
- */
1265
- identity_ids: Array<string>;
1266
- /**
1267
- * The conversations re-pointed at the target.
1268
- */
1269
- conversation_ids: Array<string>;
1270
- /**
1271
- * The sessions opened through the sessions API with `contact_id` that were re-pointed at the target.
1272
- *
1273
- */
1274
- session_ids: Array<string>;
1275
- status: 'applied' | 'reverted';
1276
- created_at: Date;
1277
- reverted_at: Date | null;
1278
- };
1279
- type ContactMergeList = {
1280
- data: Array<ContactMerge>;
1281
- next_cursor: string | null;
1282
- };
1283
- type ContactMergeResult = {
1284
- contact: Contact;
1285
- merge: ContactMerge;
1286
- };
1287
1110
  /**
1288
1111
  * The messages to run the agent over, plus optional metering hints.
1289
1112
  */
@@ -1976,12 +1799,7 @@ type SessionCreate = {
1976
1799
  */
1977
1800
  name?: string;
1978
1801
  /**
1979
- * The contact the session is for (Contacts API, §6). naturali resolves it to the contact's runtime actor — minting one on first need — so a web or in-app session gets the same continuity, memory and history a channel conversation gets, instead of a throwaway identity per session. When the contact has an `external_id` it rides along in `tool_context` as `actor_external_id`, so the customer's own HTTP tools receive the user reference they already key on; an explicit `tool_context` entry still wins. Mutually exclusive with `actor_id`.
1980
- *
1981
- */
1982
- contact_id?: string;
1983
- /**
1984
- * Public ID of an existing actor to attach as the user actor. A runtime id showing through the public contract; prefer `contact_id`. Mutually exclusive with it.
1802
+ * Public ID of an existing actor to attach as the user actor — a runtime id showing through the public contract.
1985
1803
  *
1986
1804
  */
1987
1805
  actor_id?: string;
@@ -2752,18 +2570,6 @@ type MessagesLimit = number;
2752
2570
  * Number of messages to skip.
2753
2571
  */
2754
2572
  type Offset = number;
2755
- /**
2756
- * Contact public ID (cont_ prefix).
2757
- */
2758
- type ContactId = string;
2759
- /**
2760
- * Contact identity public ID (cid_ prefix).
2761
- */
2762
- type IdentityId = string;
2763
- /**
2764
- * Contact merge public ID (cmrg_ prefix).
2765
- */
2766
- type MergeId = string;
2767
2573
  /**
2768
2574
  * Generation public ID (gen_ prefix).
2769
2575
  */
@@ -3999,15 +3805,10 @@ type ListChannelConversationsData = {
3999
3805
  */
4000
3806
  cursor?: string;
4001
3807
  /**
4002
- * Filter to one contact's normalized channel identifier (a phone number on WhatsApp; a Discord user id, or `thread:<id>` for a guild thread). Unique within a channel, so at most one row matches.
4003
- *
4004
- */
4005
- contact_identifier?: string;
4006
- /**
4007
- * Filter to one contact — the same question asked of the human rather than of one of their identifiers. A contact with two identities on this channel has a conversation for each.
3808
+ * Filter to one address by its bare, channel-native identifier (a phone number on WhatsApp; a Discord user id, or `thread:<id>` for a guild thread) the same value the channel itself reports, not the prefixed form the `identifier` field above returns. At most one row matches.
4008
3809
  *
4009
3810
  */
4010
- contact_id?: string;
3811
+ identifier?: string;
4011
3812
  };
4012
3813
  url: '/v1/projects/{project_id}/channels/{channel_id}/conversations';
4013
3814
  };
@@ -4124,462 +3925,6 @@ type ListChannelConversationMessagesResponses = {
4124
3925
  200: ConversationMessageList;
4125
3926
  };
4126
3927
  type ListChannelConversationMessagesResponse = ListChannelConversationMessagesResponses[keyof ListChannelConversationMessagesResponses];
4127
- type ListContactsData = {
4128
- body?: never;
4129
- path: {
4130
- /**
4131
- * Project public ID (proj_ prefix).
4132
- */
4133
- project_id: string;
4134
- };
4135
- query?: {
4136
- /**
4137
- * Maximum items per page.
4138
- */
4139
- limit?: number;
4140
- /**
4141
- * Opaque pagination cursor from a previous response's next_cursor.
4142
- */
4143
- cursor?: string;
4144
- /**
4145
- * Channel kind of the identifier to look up; requires `identifier`.
4146
- */
4147
- channel?: 'whatsapp' | 'discord';
4148
- /**
4149
- * Normalized channel identifier to look up; requires `channel`.
4150
- *
4151
- */
4152
- identifier?: string;
4153
- /**
4154
- * The customer's own reference for the contact.
4155
- */
4156
- external_id?: string;
4157
- /**
4158
- * Include contacts that were merged into another (tombstones). Off by default, so the page is the set of humans the project knows today.
4159
- *
4160
- */
4161
- include_merged?: boolean;
4162
- };
4163
- url: '/v1/projects/{project_id}/contacts';
4164
- };
4165
- type ListContactsErrors = {
4166
- /**
4167
- * The request was malformed or failed validation.
4168
- */
4169
- 400: ErrorResponse;
4170
- /**
4171
- * Missing or invalid credentials.
4172
- */
4173
- 401: ErrorResponse;
4174
- /**
4175
- * The resource does not exist (existence is not leaked).
4176
- */
4177
- 404: ErrorResponse;
4178
- };
4179
- type ListContactsError = ListContactsErrors[keyof ListContactsErrors];
4180
- type ListContactsResponses = {
4181
- /**
4182
- * A page of contacts.
4183
- */
4184
- 200: ContactList;
4185
- };
4186
- type ListContactsResponse = ListContactsResponses[keyof ListContactsResponses];
4187
- type CreateContactData = {
4188
- body: ContactCreate;
4189
- headers?: {
4190
- /**
4191
- * Client-supplied key to make this mutating POST idempotent.
4192
- */
4193
- 'Idempotency-Key'?: string;
4194
- };
4195
- path: {
4196
- /**
4197
- * Project public ID (proj_ prefix).
4198
- */
4199
- project_id: string;
4200
- };
4201
- query?: never;
4202
- url: '/v1/projects/{project_id}/contacts';
4203
- };
4204
- type CreateContactErrors = {
4205
- /**
4206
- * The request was malformed or failed validation.
4207
- */
4208
- 400: ErrorResponse;
4209
- /**
4210
- * Missing or invalid credentials.
4211
- */
4212
- 401: ErrorResponse;
4213
- /**
4214
- * The resource does not exist (existence is not leaked).
4215
- */
4216
- 404: ErrorResponse;
4217
- /**
4218
- * The request conflicts with the resource's current state.
4219
- */
4220
- 409: ErrorResponse;
4221
- };
4222
- type CreateContactError = CreateContactErrors[keyof CreateContactErrors];
4223
- type CreateContactResponses = {
4224
- /**
4225
- * Contact created.
4226
- */
4227
- 201: Contact;
4228
- };
4229
- type CreateContactResponse = CreateContactResponses[keyof CreateContactResponses];
4230
- type DeleteContactData = {
4231
- body?: never;
4232
- path: {
4233
- /**
4234
- * Project public ID (proj_ prefix).
4235
- */
4236
- project_id: string;
4237
- /**
4238
- * Contact public ID (cont_ prefix).
4239
- */
4240
- contact_id: string;
4241
- };
4242
- query?: never;
4243
- url: '/v1/projects/{project_id}/contacts/{contact_id}';
4244
- };
4245
- type DeleteContactErrors = {
4246
- /**
4247
- * Missing or invalid credentials.
4248
- */
4249
- 401: ErrorResponse;
4250
- /**
4251
- * The resource does not exist (existence is not leaked).
4252
- */
4253
- 404: ErrorResponse;
4254
- /**
4255
- * The request conflicts with the resource's current state.
4256
- */
4257
- 409: ErrorResponse;
4258
- /**
4259
- * The upstream runtime could not complete the operation.
4260
- */
4261
- 502: ErrorResponse;
4262
- };
4263
- type DeleteContactError = DeleteContactErrors[keyof DeleteContactErrors];
4264
- type DeleteContactResponses = {
4265
- /**
4266
- * Contact erased.
4267
- */
4268
- 204: void;
4269
- };
4270
- type DeleteContactResponse = DeleteContactResponses[keyof DeleteContactResponses];
4271
- type GetContactData = {
4272
- body?: never;
4273
- path: {
4274
- /**
4275
- * Project public ID (proj_ prefix).
4276
- */
4277
- project_id: string;
4278
- /**
4279
- * Contact public ID (cont_ prefix).
4280
- */
4281
- contact_id: string;
4282
- };
4283
- query?: never;
4284
- url: '/v1/projects/{project_id}/contacts/{contact_id}';
4285
- };
4286
- type GetContactErrors = {
4287
- /**
4288
- * Missing or invalid credentials.
4289
- */
4290
- 401: ErrorResponse;
4291
- /**
4292
- * The resource does not exist (existence is not leaked).
4293
- */
4294
- 404: ErrorResponse;
4295
- };
4296
- type GetContactError = GetContactErrors[keyof GetContactErrors];
4297
- type GetContactResponses = {
4298
- /**
4299
- * The contact, with its identities.
4300
- */
4301
- 200: Contact;
4302
- };
4303
- type GetContactResponse = GetContactResponses[keyof GetContactResponses];
4304
- type UpdateContactData = {
4305
- body: ContactUpdate;
4306
- path: {
4307
- /**
4308
- * Project public ID (proj_ prefix).
4309
- */
4310
- project_id: string;
4311
- /**
4312
- * Contact public ID (cont_ prefix).
4313
- */
4314
- contact_id: string;
4315
- };
4316
- query?: never;
4317
- url: '/v1/projects/{project_id}/contacts/{contact_id}';
4318
- };
4319
- type UpdateContactErrors = {
4320
- /**
4321
- * The request was malformed or failed validation.
4322
- */
4323
- 400: ErrorResponse;
4324
- /**
4325
- * Missing or invalid credentials.
4326
- */
4327
- 401: ErrorResponse;
4328
- /**
4329
- * The resource does not exist (existence is not leaked).
4330
- */
4331
- 404: ErrorResponse;
4332
- /**
4333
- * The request conflicts with the resource's current state.
4334
- */
4335
- 409: ErrorResponse;
4336
- };
4337
- type UpdateContactError = UpdateContactErrors[keyof UpdateContactErrors];
4338
- type UpdateContactResponses = {
4339
- /**
4340
- * Contact updated.
4341
- */
4342
- 200: Contact;
4343
- };
4344
- type UpdateContactResponse = UpdateContactResponses[keyof UpdateContactResponses];
4345
- type CreateContactIdentityData = {
4346
- body: ContactIdentityCreate;
4347
- path: {
4348
- /**
4349
- * Project public ID (proj_ prefix).
4350
- */
4351
- project_id: string;
4352
- /**
4353
- * Contact public ID (cont_ prefix).
4354
- */
4355
- contact_id: string;
4356
- };
4357
- query?: never;
4358
- url: '/v1/projects/{project_id}/contacts/{contact_id}/identities';
4359
- };
4360
- type CreateContactIdentityErrors = {
4361
- /**
4362
- * The request was malformed or failed validation.
4363
- */
4364
- 400: ErrorResponse;
4365
- /**
4366
- * Missing or invalid credentials.
4367
- */
4368
- 401: ErrorResponse;
4369
- /**
4370
- * The resource does not exist (existence is not leaked).
4371
- */
4372
- 404: ErrorResponse;
4373
- /**
4374
- * The request conflicts with the resource's current state.
4375
- */
4376
- 409: ErrorResponse;
4377
- };
4378
- type CreateContactIdentityError = CreateContactIdentityErrors[keyof CreateContactIdentityErrors];
4379
- type CreateContactIdentityResponses = {
4380
- /**
4381
- * Identity attached.
4382
- */
4383
- 201: ContactIdentity;
4384
- };
4385
- type CreateContactIdentityResponse = CreateContactIdentityResponses[keyof CreateContactIdentityResponses];
4386
- type DeleteContactIdentityData = {
4387
- body?: never;
4388
- path: {
4389
- /**
4390
- * Project public ID (proj_ prefix).
4391
- */
4392
- project_id: string;
4393
- /**
4394
- * Contact public ID (cont_ prefix).
4395
- */
4396
- contact_id: string;
4397
- /**
4398
- * Contact identity public ID (cid_ prefix).
4399
- */
4400
- identity_id: string;
4401
- };
4402
- query?: never;
4403
- url: '/v1/projects/{project_id}/contacts/{contact_id}/identities/{identity_id}';
4404
- };
4405
- type DeleteContactIdentityErrors = {
4406
- /**
4407
- * Missing or invalid credentials.
4408
- */
4409
- 401: ErrorResponse;
4410
- /**
4411
- * The resource does not exist (existence is not leaked).
4412
- */
4413
- 404: ErrorResponse;
4414
- /**
4415
- * The request conflicts with the resource's current state.
4416
- */
4417
- 409: ErrorResponse;
4418
- };
4419
- type DeleteContactIdentityError = DeleteContactIdentityErrors[keyof DeleteContactIdentityErrors];
4420
- type DeleteContactIdentityResponses = {
4421
- /**
4422
- * Identity detached.
4423
- */
4424
- 204: void;
4425
- };
4426
- type DeleteContactIdentityResponse = DeleteContactIdentityResponses[keyof DeleteContactIdentityResponses];
4427
- type ListContactConversationsData = {
4428
- body?: never;
4429
- path: {
4430
- /**
4431
- * Project public ID (proj_ prefix).
4432
- */
4433
- project_id: string;
4434
- /**
4435
- * Contact public ID (cont_ prefix).
4436
- */
4437
- contact_id: string;
4438
- };
4439
- query?: never;
4440
- url: '/v1/projects/{project_id}/contacts/{contact_id}/conversations';
4441
- };
4442
- type ListContactConversationsErrors = {
4443
- /**
4444
- * Missing or invalid credentials.
4445
- */
4446
- 401: ErrorResponse;
4447
- /**
4448
- * The resource does not exist (existence is not leaked).
4449
- */
4450
- 404: ErrorResponse;
4451
- };
4452
- type ListContactConversationsError = ListContactConversationsErrors[keyof ListContactConversationsErrors];
4453
- type ListContactConversationsResponses = {
4454
- /**
4455
- * The contact's conversations.
4456
- */
4457
- 200: ContactConversationList;
4458
- };
4459
- type ListContactConversationsResponse = ListContactConversationsResponses[keyof ListContactConversationsResponses];
4460
- type MergeContactData = {
4461
- body: ContactMergeRequest;
4462
- path: {
4463
- /**
4464
- * Project public ID (proj_ prefix).
4465
- */
4466
- project_id: string;
4467
- /**
4468
- * Contact public ID (cont_ prefix).
4469
- */
4470
- contact_id: string;
4471
- };
4472
- query?: never;
4473
- url: '/v1/projects/{project_id}/contacts/{contact_id}:merge';
4474
- };
4475
- type MergeContactErrors = {
4476
- /**
4477
- * The request was malformed or failed validation.
4478
- */
4479
- 400: ErrorResponse;
4480
- /**
4481
- * Missing or invalid credentials.
4482
- */
4483
- 401: ErrorResponse;
4484
- /**
4485
- * The resource does not exist (existence is not leaked).
4486
- */
4487
- 404: ErrorResponse;
4488
- /**
4489
- * The request conflicts with the resource's current state.
4490
- */
4491
- 409: ErrorResponse;
4492
- /**
4493
- * The upstream runtime could not complete the operation.
4494
- */
4495
- 502: ErrorResponse;
4496
- };
4497
- type MergeContactError = MergeContactErrors[keyof MergeContactErrors];
4498
- type MergeContactResponses = {
4499
- /**
4500
- * Contacts merged.
4501
- */
4502
- 200: ContactMergeResult;
4503
- };
4504
- type MergeContactResponse = MergeContactResponses[keyof MergeContactResponses];
4505
- type ListContactMergesData = {
4506
- body?: never;
4507
- path: {
4508
- /**
4509
- * Project public ID (proj_ prefix).
4510
- */
4511
- project_id: string;
4512
- /**
4513
- * Contact public ID (cont_ prefix).
4514
- */
4515
- contact_id: string;
4516
- };
4517
- query?: never;
4518
- url: '/v1/projects/{project_id}/contacts/{contact_id}/merges';
4519
- };
4520
- type ListContactMergesErrors = {
4521
- /**
4522
- * Missing or invalid credentials.
4523
- */
4524
- 401: ErrorResponse;
4525
- /**
4526
- * The resource does not exist (existence is not leaked).
4527
- */
4528
- 404: ErrorResponse;
4529
- };
4530
- type ListContactMergesError = ListContactMergesErrors[keyof ListContactMergesErrors];
4531
- type ListContactMergesResponses = {
4532
- /**
4533
- * The contact's merge records.
4534
- */
4535
- 200: ContactMergeList;
4536
- };
4537
- type ListContactMergesResponse = ListContactMergesResponses[keyof ListContactMergesResponses];
4538
- type RevertContactMergeData = {
4539
- body?: never;
4540
- path: {
4541
- /**
4542
- * Project public ID (proj_ prefix).
4543
- */
4544
- project_id: string;
4545
- /**
4546
- * Contact public ID (cont_ prefix).
4547
- */
4548
- contact_id: string;
4549
- /**
4550
- * Contact merge public ID (cmrg_ prefix).
4551
- */
4552
- merge_id: string;
4553
- };
4554
- query?: never;
4555
- url: '/v1/projects/{project_id}/contacts/{contact_id}/merges/{merge_id}:revert';
4556
- };
4557
- type RevertContactMergeErrors = {
4558
- /**
4559
- * Missing or invalid credentials.
4560
- */
4561
- 401: ErrorResponse;
4562
- /**
4563
- * The resource does not exist (existence is not leaked).
4564
- */
4565
- 404: ErrorResponse;
4566
- /**
4567
- * The request conflicts with the resource's current state.
4568
- */
4569
- 409: ErrorResponse;
4570
- /**
4571
- * The upstream runtime could not complete the operation.
4572
- */
4573
- 502: ErrorResponse;
4574
- };
4575
- type RevertContactMergeError = RevertContactMergeErrors[keyof RevertContactMergeErrors];
4576
- type RevertContactMergeResponses = {
4577
- /**
4578
- * Merge reverted.
4579
- */
4580
- 200: ContactMergeResult;
4581
- };
4582
- type RevertContactMergeResponse = RevertContactMergeResponses[keyof RevertContactMergeResponses];
4583
3928
  type ListAgentGenerationsData = {
4584
3929
  body?: never;
4585
3930
  path: {
@@ -7471,7 +6816,7 @@ declare class Channels {
7471
6816
  /**
7472
6817
  * List the channel's conversations
7473
6818
  *
7474
- * A cursor page of the channel's conversations, newest first. A conversation is one contact's dialogue on the channel — the continuity anchor that resumes the same runtime session instead of starting fresh per message — so this is the read path for who has talked to the channel and which actor/session their dialogue resolved to.
6819
+ * A cursor page of the channel's conversations, newest first. A conversation is one address's dialogue on the channel — the continuity anchor that resumes the same runtime session instead of starting fresh per message — so this is the read path for who has talked to the channel and which actor/session their dialogue resolved to.
7475
6820
  * Conversations are created by the inbound path (the WhatsApp webhook, the Discord gateway worker) when a real message arrives; there is no way to create one directly.
7476
6821
  *
7477
6822
  */
@@ -7488,88 +6833,6 @@ declare class Channels {
7488
6833
  */
7489
6834
  static listChannelConversationMessages<ThrowOnError extends boolean = false>(options: Options<ListChannelConversationMessagesData, ThrowOnError>): RequestResult<ListChannelConversationMessagesResponses, ListChannelConversationMessagesErrors, ThrowOnError>;
7490
6835
  }
7491
- declare class Contacts {
7492
- /**
7493
- * List contacts
7494
- *
7495
- * A cursor page of the project's contacts, newest first.
7496
- * `channel` + `identifier` (supplied together) is the identity lookup — "who is this phone number?" — and returns at most one contact, following the merge pointer to whoever holds the identifier today. `external_id` asks the same question from the customer's side of the mapping. Contacts merged away are omitted unless `include_merged` asks for them.
7497
- *
7498
- */
7499
- static listContacts<ThrowOnError extends boolean = false>(options: Options<ListContactsData, ThrowOnError>): RequestResult<ListContactsResponses, ListContactsErrors, ThrowOnError>;
7500
- /**
7501
- * Create a contact
7502
- *
7503
- * Record a contact the customer already knows about, optionally with the identifiers it is expected to arrive at.
7504
- * Optional by design — the inbound path creates contacts on its own. This is for the embedder who has a user in their own system and wants naturali to agree about who that is before the first message, which is what makes `external_id` (and, through it, a session's `tool_context`) useful. No runtime actor is created here; the contact gets one on first need.
7505
- *
7506
- */
7507
- static createContact<ThrowOnError extends boolean = false>(options: Options<CreateContactData, ThrowOnError>): RequestResult<CreateContactResponses, CreateContactErrors, ThrowOnError>;
7508
- /**
7509
- * Erase a contact
7510
- *
7511
- * **Erasure (C4/LGPD).** Not a soft delete and not reversible: the contact's sessions — with their messages and media — its runtime actor, its memory container and every identifier it was reachable at are removed, along with the merge records that reference it.
7512
- * The upstream deletes happen first, so a failure there aborts before the local pointers are dropped and a retry can still find what is left. A contact that was merged into another cannot be erased directly: its data lives with the survivor, so erase that one.
7513
- *
7514
- */
7515
- static deleteContact<ThrowOnError extends boolean = false>(options: Options<DeleteContactData, ThrowOnError>): RequestResult<DeleteContactResponses, DeleteContactErrors, ThrowOnError>;
7516
- /**
7517
- * Get a contact
7518
- */
7519
- static getContact<ThrowOnError extends boolean = false>(options: Options<GetContactData, ThrowOnError>): RequestResult<GetContactResponses, GetContactErrors, ThrowOnError>;
7520
- /**
7521
- * Update a contact
7522
- *
7523
- * Retune the customer-owned fields. At least one is required. Identities are attached and detached through their own sub-resource, because each one is a claim about reachability rather than a property of the record.
7524
- *
7525
- */
7526
- static updateContact<ThrowOnError extends boolean = false>(options: Options<UpdateContactData, ThrowOnError>): RequestResult<UpdateContactResponses, UpdateContactErrors, ThrowOnError>;
7527
- /**
7528
- * Attach an identity
7529
- *
7530
- * Attach a `(channel, identifier)` pair — the manual half of what the inbound path does automatically, and the way a customer tells naturali that a number it has never seen belongs to a user it already knows. The identifier must be free (C3).
7531
- *
7532
- */
7533
- static createContactIdentity<ThrowOnError extends boolean = false>(options: Options<CreateContactIdentityData, ThrowOnError>): RequestResult<CreateContactIdentityResponses, CreateContactIdentityErrors, ThrowOnError>;
7534
- /**
7535
- * Detach an identity
7536
- *
7537
- * Detach an identifier attached in error. Refused with `identity_in_use` once a dialogue hangs off it: dropping an identifier with history is erasure wearing a smaller name, and erasure has its own route that actually removes the messages instead of orphaning them.
7538
- *
7539
- */
7540
- static deleteContactIdentity<ThrowOnError extends boolean = false>(options: Options<DeleteContactIdentityData, ThrowOnError>): RequestResult<DeleteContactIdentityResponses, DeleteContactIdentityErrors, ThrowOnError>;
7541
- /**
7542
- * List the contact's conversations
7543
- *
7544
- * Every dialogue the contact has, across channels, newest first. The channel-scoped list answers "who has talked to this number?"; this one answers "where has this human talked to us?" — the read that makes a merge visible, since both channels' rows then appear under one contact.
7545
- *
7546
- */
7547
- static listContactConversations<ThrowOnError extends boolean = false>(options: Options<ListContactConversationsData, ThrowOnError>): RequestResult<ListContactConversationsResponses, ListContactConversationsErrors, ThrowOnError>;
7548
- /**
7549
- * Merge another contact into this one
7550
- *
7551
- * Fold `source_contact_id` into this contact — "same human, two identifiers" (C4).
7552
- * What moves: every identity and every conversation, so the survivor's history is the union of both. What is *shared* rather than moved: agent memory — the runtime hangs it off the actor, so the source's actor is re-pointed at the survivor's memory container and both keep answering with one recollection. Existing sessions keep working, which is the point of not rewriting them.
7553
- * The source is not deleted: it stays as a tombstone pointing at the survivor, and the returned merge record lists exactly what moved, so the merge can be audited and reverted.
7554
- *
7555
- */
7556
- static mergeContact<ThrowOnError extends boolean = false>(options: Options<MergeContactData, ThrowOnError>): RequestResult<MergeContactResponses, MergeContactErrors, ThrowOnError>;
7557
- /**
7558
- * List the contact's merges
7559
- *
7560
- * The contact's merge history, newest first, from both sides: the merges it absorbed and the one that absorbed it. The audit half of C4.
7561
- *
7562
- */
7563
- static listContactMerges<ThrowOnError extends boolean = false>(options: Options<ListContactMergesData, ThrowOnError>): RequestResult<ListContactMergesResponses, ListContactMergesErrors, ThrowOnError>;
7564
- /**
7565
- * Revert a merge
7566
- *
7567
- * Undo a merge (C4). Replays the record backwards: the identities and conversations it lists go back to the source, the source's actor is re-pointed at the memory it had before, and the tombstone becomes a contact again. Anything that arrived *after* the merge stays with the survivor — it was never the source's.
7568
- * Only the merge still in force can be reverted; a source that has since been merged somewhere else has to be unwound from the top (`merge_superseded`).
7569
- *
7570
- */
7571
- static revertContactMerge<ThrowOnError extends boolean = false>(options: Options<RevertContactMergeData, ThrowOnError>): RequestResult<RevertContactMergeResponses, RevertContactMergeErrors, ThrowOnError>;
7572
- }
7573
6836
  declare class Generations {
7574
6837
  /**
7575
6838
  * List an agent's generations
@@ -8084,7 +7347,6 @@ declare class NaturaliClient {
8084
7347
  readonly auth: typeof Auth;
8085
7348
  readonly boards: typeof Boards;
8086
7349
  readonly channels: typeof Channels;
8087
- readonly contacts: typeof Contacts;
8088
7350
  readonly generations: typeof Generations;
8089
7351
  readonly knowledge: typeof Knowledge;
8090
7352
  readonly models: typeof Models;
@@ -8100,4 +7362,4 @@ declare class NaturaliClient {
8100
7362
  constructor({ token, headers }?: NaturaliClientOptions);
8101
7363
  }
8102
7364
  //#endregion
8103
- export { type Acknowledgement, type AddSessionMessageData, type AddSessionMessageError, type AddSessionMessageErrors, type AddSessionMessageResponse, type AddSessionMessageResponses, type Agent, type AgentCreate, type AgentId, type AgentList, type AgentUpdate, Agents, type ApiKeyCreate, type ApiKeyCreated, type ApiKeyId, type ApiKeyList, type ApiKeyRecord, type ApiKeyUpdate, ApiKeys, type AssigneeFilter, Assistant, type AssistantChannel, type AssistantGrant, type AssistantGrantList, type AssistantLinkPreview, type AssistantLinkRedeem, type AssistantScope, Auth, type AuthSession, type Board, type BoardCompletionRule, type BoardCreate, type BoardDispatch, type BoardId, type BoardIdFilter, type BoardList, type BoardOnEnter, type BoardState, type BoardTransition, type BoardUpdate, Boards, type Channel, type ChannelBinding, type ChannelBindingSet, type ChannelCreate, type ChannelId, type ChannelList, type ChannelUpdate, Channels, type ClientOptions, type CollectionId, type Contact, type ContactConversation, type ContactConversationList, type ContactCreate, type ContactId, type ContactIdentity, type ContactIdentityCreate, type ContactList, type ContactMerge, type ContactMergeList, type ContactMergeRequest, type ContactMergeResult, type ContactUpdate, Contacts, type Conversation, type ConversationId, type ConversationList, type ConversationMessage, type ConversationMessageList, type ConverterId, type CreateAgentData, type CreateAgentError, type CreateAgentErrors, type CreateAgentResponse, type CreateAgentResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateBoardData, type CreateBoardError, type CreateBoardErrors, type CreateBoardResponse, type CreateBoardResponses, type CreateChannelData, type CreateChannelError, type CreateChannelErrors, type CreateChannelResponse, type CreateChannelResponses, type CreateContactData, type CreateContactError, type CreateContactErrors, type CreateContactIdentityData, type CreateContactIdentityError, type CreateContactIdentityErrors, type CreateContactIdentityResponse, type CreateContactIdentityResponses, type CreateContactResponse, type CreateContactResponses, type CreateGenerationData, type CreateGenerationError, type CreateGenerationErrors, type CreateGenerationResponse, type CreateGenerationResponses, type CreateKnowledgeCollectionData, type CreateKnowledgeCollectionError, type CreateKnowledgeCollectionErrors, type CreateKnowledgeCollectionResponse, type CreateKnowledgeCollectionResponses, type CreateKnowledgeConverterData, type CreateKnowledgeConverterError, type CreateKnowledgeConverterErrors, type CreateKnowledgeConverterResponse, type CreateKnowledgeConverterResponses, type CreateKnowledgeDocumentData, type CreateKnowledgeDocumentError, type CreateKnowledgeDocumentErrors, type CreateKnowledgeDocumentResponse, type CreateKnowledgeDocumentResponses, type CreateProjectData, type CreateProjectError, type CreateProjectErrors, type CreateProjectResponse, type CreateProjectResponses, type CreateProviderData, type CreateProviderError, type CreateProviderErrors, type CreateProviderResponse, type CreateProviderResponses, type CreateSessionData, type CreateSessionError, type CreateSessionErrors, type CreateSessionResponse, type CreateSessionResponses, type CreateTaskData, type CreateTaskError, type CreateTaskErrors, type CreateTaskResponse, type CreateTaskResponses, type CreateToolData, type CreateToolError, type CreateToolErrors, type CreateToolResponse, type CreateToolResponses, type CreateWebhookData, type CreateWebhookError, type CreateWebhookErrors, type CreateWebhookResponse, type CreateWebhookResponses, type Cursor, type DeleteAgentData, type DeleteAgentError, type DeleteAgentErrors, type DeleteAgentResponse, type DeleteAgentResponses, type DeleteApiKeyData, type DeleteApiKeyError, type DeleteApiKeyErrors, type DeleteApiKeyResponse, type DeleteApiKeyResponses, type DeleteBoardData, type DeleteBoardError, type DeleteBoardErrors, type DeleteBoardResponse, type DeleteBoardResponses, type DeleteChannelBindingData, type DeleteChannelBindingError, type DeleteChannelBindingErrors, type DeleteChannelBindingResponse, type DeleteChannelBindingResponses, type DeleteChannelData, type DeleteChannelError, type DeleteChannelErrors, type DeleteChannelResponse, type DeleteChannelResponses, type DeleteContactData, type DeleteContactError, type DeleteContactErrors, type DeleteContactIdentityData, type DeleteContactIdentityError, type DeleteContactIdentityErrors, type DeleteContactIdentityResponse, type DeleteContactIdentityResponses, type DeleteContactResponse, type DeleteContactResponses, type DeleteKnowledgeCollectionData, type DeleteKnowledgeCollectionError, type DeleteKnowledgeCollectionErrors, type DeleteKnowledgeCollectionResponse, type DeleteKnowledgeCollectionResponses, type DeleteKnowledgeConverterData, type DeleteKnowledgeConverterError, type DeleteKnowledgeConverterErrors, type DeleteKnowledgeConverterResponse, type DeleteKnowledgeConverterResponses, type DeleteKnowledgeDocumentData, type DeleteKnowledgeDocumentError, type DeleteKnowledgeDocumentErrors, type DeleteKnowledgeDocumentResponse, type DeleteKnowledgeDocumentResponses, type DeleteProjectData, type DeleteProjectError, type DeleteProjectErrors, type DeleteProjectResponse, type DeleteProjectResponses, type DeleteProviderData, type DeleteProviderError, type DeleteProviderErrors, type DeleteProviderResponse, type DeleteProviderResponses, type DeleteTaskData, type DeleteTaskError, type DeleteTaskErrors, type DeleteTaskResponse, type DeleteTaskResponses, type DeleteToolData, type DeleteToolError, type DeleteToolErrors, type DeleteToolResponse, type DeleteToolResponses, type DeleteWebhookData, type DeleteWebhookError, type DeleteWebhookErrors, type DeleteWebhookResponse, type DeleteWebhookResponses, type DeliveryId, type DiscordModes, type DocumentId, type ErrorResponse, type Event, type EventSubscription, type EventType, type Force, type GenerateSessionResponseData, type GenerateSessionResponseError, type GenerateSessionResponseErrors, type GenerateSessionResponseResponse, type GenerateSessionResponseResponses, type Generation, type GenerationCreate, type GenerationId, type GenerationList, type GenerationResult, type GenerationStatus, type GenerationUsage, Generations, type GetAgentData, type GetAgentError, type GetAgentErrors, type GetAgentResponse, type GetAgentResponses, type GetApiKeyData, type GetApiKeyError, type GetApiKeyErrors, type GetApiKeyResponse, type GetApiKeyResponses, type GetBoardData, type GetBoardError, type GetBoardErrors, type GetBoardResponse, type GetBoardResponses, type GetChannelBindingData, type GetChannelBindingError, type GetChannelBindingErrors, type GetChannelBindingResponse, type GetChannelBindingResponses, type GetChannelConversationData, type GetChannelConversationError, type GetChannelConversationErrors, type GetChannelConversationResponse, type GetChannelConversationResponses, type GetChannelData, type GetChannelError, type GetChannelErrors, type GetChannelResponse, type GetChannelResponses, type GetContactData, type GetContactError, type GetContactErrors, type GetContactResponse, type GetContactResponses, type GetCurrentUserData, type GetCurrentUserError, type GetCurrentUserErrors, type GetCurrentUserResponse, type GetCurrentUserResponses, type GetGenerationData, type GetGenerationError, type GetGenerationErrors, type GetGenerationResponse, type GetGenerationResponses, type GetGenerationUsageData, type GetGenerationUsageError, type GetGenerationUsageErrors, type GetGenerationUsageResponse, type GetGenerationUsageResponses, type GetKnowledgeCollectionData, type GetKnowledgeCollectionError, type GetKnowledgeCollectionErrors, type GetKnowledgeCollectionResponse, type GetKnowledgeCollectionResponses, type GetKnowledgeConverterData, type GetKnowledgeConverterError, type GetKnowledgeConverterErrors, type GetKnowledgeConverterResponse, type GetKnowledgeConverterResponses, type GetKnowledgeDocumentData, type GetKnowledgeDocumentError, type GetKnowledgeDocumentErrors, type GetKnowledgeDocumentResponse, type GetKnowledgeDocumentResponses, type GetModelData, type GetModelError, type GetModelErrors, type GetModelResponse, type GetModelResponses, type GetProjectData, type GetProjectError, type GetProjectErrors, type GetProjectResponse, type GetProjectResponses, type GetProjectUsageData, type GetProjectUsageError, type GetProjectUsageErrors, type GetProjectUsageResponse, type GetProjectUsageResponses, type GetProviderData, type GetProviderError, type GetProviderErrors, type GetProviderResponse, type GetProviderResponses, type GetSessionData, type GetSessionError, type GetSessionErrors, type GetSessionResponse, type GetSessionResponses, type GetTaskData, type GetTaskError, type GetTaskErrors, type GetTaskResponse, type GetTaskResponses, type GetToolData, type GetToolError, type GetToolErrors, type GetToolResponse, type GetToolResponses, type GetTraceData, type GetTraceError, type GetTraceErrors, type GetTraceResponse, type GetTraceResponses, type GetTraceStepsData, type GetTraceStepsError, type GetTraceStepsErrors, type GetTraceStepsResponse, type GetTraceStepsResponses, type GetTraceTreeData, type GetTraceTreeError, type GetTraceTreeErrors, type GetTraceTreeResponse, type GetTraceTreeResponses, type GetWebhookData, type GetWebhookDeliveryData, type GetWebhookDeliveryError, type GetWebhookDeliveryErrors, type GetWebhookDeliveryResponse, type GetWebhookDeliveryResponses, type GetWebhookError, type GetWebhookErrors, type GetWebhookResponse, type GetWebhookResponses, type GrantId, type HttpExecute, type IdempotencyKey, type IdentityId, Knowledge, type KnowledgeChunk, type KnowledgeCollection, type KnowledgeCollectionCreate, type KnowledgeCollectionList, type KnowledgeCollectionUpdate, type KnowledgeConverter, type KnowledgeConverterCreate, type KnowledgeConverterList, type KnowledgeConverterUpdate, type KnowledgeDocument, type KnowledgeDocumentCreate, type KnowledgeDocumentList, type KnowledgeQueryRequest, type KnowledgeQueryResult, type Limit, type LinkToken, type ListAgentGenerationsData, type ListAgentGenerationsError, type ListAgentGenerationsErrors, type ListAgentGenerationsResponse, type ListAgentGenerationsResponses, type ListAgentsData, type ListAgentsError, type ListAgentsErrors, type ListAgentsResponse, type ListAgentsResponses, type ListApiKeysData, type ListApiKeysError, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListAssistantGrantsData, type ListAssistantGrantsError, type ListAssistantGrantsErrors, type ListAssistantGrantsResponse, type ListAssistantGrantsResponses, type ListBoardsData, type ListBoardsError, type ListBoardsErrors, type ListBoardsResponse, type ListBoardsResponses, type ListChannelConversationMessagesData, type ListChannelConversationMessagesError, type ListChannelConversationMessagesErrors, type ListChannelConversationMessagesResponse, type ListChannelConversationMessagesResponses, type ListChannelConversationsData, type ListChannelConversationsError, type ListChannelConversationsErrors, type ListChannelConversationsResponse, type ListChannelConversationsResponses, type ListChannelsData, type ListChannelsError, type ListChannelsErrors, type ListChannelsResponse, type ListChannelsResponses, type ListContactConversationsData, type ListContactConversationsError, type ListContactConversationsErrors, type ListContactConversationsResponse, type ListContactConversationsResponses, type ListContactMergesData, type ListContactMergesError, type ListContactMergesErrors, type ListContactMergesResponse, type ListContactMergesResponses, type ListContactsData, type ListContactsError, type ListContactsErrors, type ListContactsResponse, type ListContactsResponses, type ListKnowledgeCollectionsData, type ListKnowledgeCollectionsError, type ListKnowledgeCollectionsErrors, type ListKnowledgeCollectionsResponse, type ListKnowledgeCollectionsResponses, type ListKnowledgeConvertersData, type ListKnowledgeConvertersError, type ListKnowledgeConvertersErrors, type ListKnowledgeConvertersResponse, type ListKnowledgeConvertersResponses, type ListKnowledgeDocumentsData, type ListKnowledgeDocumentsError, type ListKnowledgeDocumentsErrors, type ListKnowledgeDocumentsResponse, type ListKnowledgeDocumentsResponses, type ListModelsData, type ListModelsError, type ListModelsErrors, type ListModelsResponse, type ListModelsResponses, type ListProjectsData, type ListProjectsError, type ListProjectsErrors, type ListProjectsResponse, type ListProjectsResponses, type ListProvidersData, type ListProvidersError, type ListProvidersErrors, type ListProvidersResponse, type ListProvidersResponses, type ListSessionMessagesData, type ListSessionMessagesError, type ListSessionMessagesErrors, type ListSessionMessagesResponse, type ListSessionMessagesResponses, type ListTaskTransitionsData, type ListTaskTransitionsError, type ListTaskTransitionsErrors, type ListTaskTransitionsResponse, type ListTaskTransitionsResponses, type ListTasksData, type ListTasksError, type ListTasksErrors, type ListTasksResponse, type ListTasksResponses, type ListToolsData, type ListToolsError, type ListToolsErrors, type ListToolsResponse, type ListToolsResponses, type ListTraceGenerationsData, type ListTraceGenerationsError, type ListTraceGenerationsErrors, type ListTraceGenerationsResponse, type ListTraceGenerationsResponses, type ListTracesData, type ListTracesError, type ListTracesErrors, type ListTracesResponse, type ListTracesResponses, type ListWebhookDeliveriesData, type ListWebhookDeliveriesError, type ListWebhookDeliveriesErrors, type ListWebhookDeliveriesResponse, type ListWebhookDeliveriesResponses, type ListWebhooksData, type ListWebhooksError, type ListWebhooksErrors, type ListWebhooksResponse, type ListWebhooksResponses, type LogoutData, type LogoutError, type LogoutErrors, type LogoutRequest, type LogoutResponse, type LogoutResponses, type McpConfig, type MergeContactData, type MergeContactError, type MergeContactErrors, type MergeContactResponse, type MergeContactResponses, type MergeId, type Message, type MessagesLimit, type Model, type ModelList, Models, NaturaliClient, type NaturaliClientOptions, type Offset, type Options, type PreviewAssistantLinkData, type PreviewAssistantLinkError, type PreviewAssistantLinkErrors, type PreviewAssistantLinkResponse, type PreviewAssistantLinkResponses, type Project, type ProjectCreate, type ProjectId, type ProjectList, type ProjectUpdate, type ProjectUsage, Projects, type Provider, type ProviderCreate, type ProviderId, type ProviderList, type ProviderUpdate, Providers, type QueryKnowledgeCollectionData, type QueryKnowledgeCollectionError, type QueryKnowledgeCollectionErrors, type QueryKnowledgeCollectionResponse, type QueryKnowledgeCollectionResponses, type RedeemAssistantLinkData, type RedeemAssistantLinkError, type RedeemAssistantLinkErrors, type RedeemAssistantLinkResponse, type RedeemAssistantLinkResponses, type RedeliverWebhookDeliveryData, type RedeliverWebhookDeliveryError, type RedeliverWebhookDeliveryErrors, type RedeliverWebhookDeliveryResponse, type RedeliverWebhookDeliveryResponses, type RefreshRequest, type RefreshSessionData, type RefreshSessionError, type RefreshSessionErrors, type RefreshSessionResponse, type RefreshSessionResponses, type ReingestKnowledgeDocumentData, type ReingestKnowledgeDocumentError, type ReingestKnowledgeDocumentErrors, type ReingestKnowledgeDocumentResponse, type ReingestKnowledgeDocumentResponses, type RequestSignInCodeData, type RequestSignInCodeError, type RequestSignInCodeErrors, type RequestSignInCodeResponse, type RequestSignInCodeResponses, type RevertContactMergeData, type RevertContactMergeError, type RevertContactMergeErrors, type RevertContactMergeResponse, type RevertContactMergeResponses, type RevokeAssistantGrantData, type RevokeAssistantGrantError, type RevokeAssistantGrantErrors, type RevokeAssistantGrantResponse, type RevokeAssistantGrantResponses, type RotateApiKeyData, type RotateApiKeyError, type RotateApiKeyErrors, type RotateApiKeyResponse, type RotateApiKeyResponses, type RotateWebhookSecretData, type RotateWebhookSecretError, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type Session, type SessionCreate, type SessionGenerate, type SessionGeneration, type SessionId, type SessionMessage, type SessionMessageCreate, type SessionMessageList, type SessionTranscriptMessage, Sessions, type SetChannelBindingData, type SetChannelBindingError, type SetChannelBindingErrors, type SetChannelBindingResponse, type SetChannelBindingResponses, type SignInCodeRequest, type SignInCodeVerify, type StateFilter, type StatusFilter, type StepRules, type Task, type TaskCreate, type TaskId, type TaskList, type TaskTransitionList, type TaskTransitionRecord, type TaskTransitionRequest, type TaskUpdate, Tasks, type Tool, type ToolChoice, type ToolContext, type ToolCreate, type ToolId, type ToolList, type ToolUpdate, Tools, type Trace, type TraceId, type TraceList, type TraceSteps, type TraceTreeNode, Traces, type TransitionTaskData, type TransitionTaskError, type TransitionTaskErrors, type TransitionTaskResponse, type TransitionTaskResponses, type UpdateAgentData, type UpdateAgentError, type UpdateAgentErrors, type UpdateAgentResponse, type UpdateAgentResponses, type UpdateApiKeyData, type UpdateApiKeyError, type UpdateApiKeyErrors, type UpdateApiKeyResponse, type UpdateApiKeyResponses, type UpdateBoardData, type UpdateBoardError, type UpdateBoardErrors, type UpdateBoardResponse, type UpdateBoardResponses, type UpdateChannelData, type UpdateChannelError, type UpdateChannelErrors, type UpdateChannelResponse, type UpdateChannelResponses, type UpdateContactData, type UpdateContactError, type UpdateContactErrors, type UpdateContactResponse, type UpdateContactResponses, type UpdateKnowledgeCollectionData, type UpdateKnowledgeCollectionError, type UpdateKnowledgeCollectionErrors, type UpdateKnowledgeCollectionResponse, type UpdateKnowledgeCollectionResponses, type UpdateKnowledgeConverterData, type UpdateKnowledgeConverterError, type UpdateKnowledgeConverterErrors, type UpdateKnowledgeConverterResponse, type UpdateKnowledgeConverterResponses, type UpdateProjectData, type UpdateProjectError, type UpdateProjectErrors, type UpdateProjectResponse, type UpdateProjectResponses, type UpdateProviderData, type UpdateProviderError, type UpdateProviderErrors, type UpdateProviderResponse, type UpdateProviderResponses, type UpdateTaskData, type UpdateTaskError, type UpdateTaskErrors, type UpdateTaskResponse, type UpdateTaskResponses, type UpdateToolData, type UpdateToolError, type UpdateToolErrors, type UpdateToolResponse, type UpdateToolResponses, type UpdateWebhookData, type UpdateWebhookError, type UpdateWebhookErrors, type UpdateWebhookResponse, type UpdateWebhookResponses, type UsageGroup, type UsageTokens, type User, type VerifySignInCodeData, type VerifySignInCodeError, type VerifySignInCodeErrors, type VerifySignInCodeResponse, type VerifySignInCodeResponses, type Webhook, type WebhookCreate, type WebhookDelivery, type WebhookDeliveryList, type WebhookId, type WebhookList, type WebhookUpdate, type WebhookWithSecret, Webhooks, createClient, createConfig };
7365
+ export { type Acknowledgement, type AddSessionMessageData, type AddSessionMessageError, type AddSessionMessageErrors, type AddSessionMessageResponse, type AddSessionMessageResponses, type Agent, type AgentCreate, type AgentId, type AgentList, type AgentUpdate, Agents, type ApiKeyCreate, type ApiKeyCreated, type ApiKeyId, type ApiKeyList, type ApiKeyRecord, type ApiKeyUpdate, ApiKeys, type AssigneeFilter, Assistant, type AssistantChannel, type AssistantGrant, type AssistantGrantList, type AssistantLinkPreview, type AssistantLinkRedeem, type AssistantScope, Auth, type AuthSession, type Board, type BoardCompletionRule, type BoardCreate, type BoardDispatch, type BoardId, type BoardIdFilter, type BoardList, type BoardOnEnter, type BoardState, type BoardTransition, type BoardUpdate, Boards, type Channel, type ChannelBinding, type ChannelBindingSet, type ChannelCreate, type ChannelId, type ChannelList, type ChannelUpdate, Channels, type ClientOptions, type CollectionId, type Conversation, type ConversationId, type ConversationList, type ConversationMessage, type ConversationMessageList, type ConverterId, type CreateAgentData, type CreateAgentError, type CreateAgentErrors, type CreateAgentResponse, type CreateAgentResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateBoardData, type CreateBoardError, type CreateBoardErrors, type CreateBoardResponse, type CreateBoardResponses, type CreateChannelData, type CreateChannelError, type CreateChannelErrors, type CreateChannelResponse, type CreateChannelResponses, type CreateGenerationData, type CreateGenerationError, type CreateGenerationErrors, type CreateGenerationResponse, type CreateGenerationResponses, type CreateKnowledgeCollectionData, type CreateKnowledgeCollectionError, type CreateKnowledgeCollectionErrors, type CreateKnowledgeCollectionResponse, type CreateKnowledgeCollectionResponses, type CreateKnowledgeConverterData, type CreateKnowledgeConverterError, type CreateKnowledgeConverterErrors, type CreateKnowledgeConverterResponse, type CreateKnowledgeConverterResponses, type CreateKnowledgeDocumentData, type CreateKnowledgeDocumentError, type CreateKnowledgeDocumentErrors, type CreateKnowledgeDocumentResponse, type CreateKnowledgeDocumentResponses, type CreateProjectData, type CreateProjectError, type CreateProjectErrors, type CreateProjectResponse, type CreateProjectResponses, type CreateProviderData, type CreateProviderError, type CreateProviderErrors, type CreateProviderResponse, type CreateProviderResponses, type CreateSessionData, type CreateSessionError, type CreateSessionErrors, type CreateSessionResponse, type CreateSessionResponses, type CreateTaskData, type CreateTaskError, type CreateTaskErrors, type CreateTaskResponse, type CreateTaskResponses, type CreateToolData, type CreateToolError, type CreateToolErrors, type CreateToolResponse, type CreateToolResponses, type CreateWebhookData, type CreateWebhookError, type CreateWebhookErrors, type CreateWebhookResponse, type CreateWebhookResponses, type Cursor, type DeleteAgentData, type DeleteAgentError, type DeleteAgentErrors, type DeleteAgentResponse, type DeleteAgentResponses, type DeleteApiKeyData, type DeleteApiKeyError, type DeleteApiKeyErrors, type DeleteApiKeyResponse, type DeleteApiKeyResponses, type DeleteBoardData, type DeleteBoardError, type DeleteBoardErrors, type DeleteBoardResponse, type DeleteBoardResponses, type DeleteChannelBindingData, type DeleteChannelBindingError, type DeleteChannelBindingErrors, type DeleteChannelBindingResponse, type DeleteChannelBindingResponses, type DeleteChannelData, type DeleteChannelError, type DeleteChannelErrors, type DeleteChannelResponse, type DeleteChannelResponses, type DeleteKnowledgeCollectionData, type DeleteKnowledgeCollectionError, type DeleteKnowledgeCollectionErrors, type DeleteKnowledgeCollectionResponse, type DeleteKnowledgeCollectionResponses, type DeleteKnowledgeConverterData, type DeleteKnowledgeConverterError, type DeleteKnowledgeConverterErrors, type DeleteKnowledgeConverterResponse, type DeleteKnowledgeConverterResponses, type DeleteKnowledgeDocumentData, type DeleteKnowledgeDocumentError, type DeleteKnowledgeDocumentErrors, type DeleteKnowledgeDocumentResponse, type DeleteKnowledgeDocumentResponses, type DeleteProjectData, type DeleteProjectError, type DeleteProjectErrors, type DeleteProjectResponse, type DeleteProjectResponses, type DeleteProviderData, type DeleteProviderError, type DeleteProviderErrors, type DeleteProviderResponse, type DeleteProviderResponses, type DeleteTaskData, type DeleteTaskError, type DeleteTaskErrors, type DeleteTaskResponse, type DeleteTaskResponses, type DeleteToolData, type DeleteToolError, type DeleteToolErrors, type DeleteToolResponse, type DeleteToolResponses, type DeleteWebhookData, type DeleteWebhookError, type DeleteWebhookErrors, type DeleteWebhookResponse, type DeleteWebhookResponses, type DeliveryId, type DiscordModes, type DocumentId, type ErrorResponse, type Event, type EventSubscription, type EventType, type Force, type GenerateSessionResponseData, type GenerateSessionResponseError, type GenerateSessionResponseErrors, type GenerateSessionResponseResponse, type GenerateSessionResponseResponses, type Generation, type GenerationCreate, type GenerationId, type GenerationList, type GenerationResult, type GenerationStatus, type GenerationUsage, Generations, type GetAgentData, type GetAgentError, type GetAgentErrors, type GetAgentResponse, type GetAgentResponses, type GetApiKeyData, type GetApiKeyError, type GetApiKeyErrors, type GetApiKeyResponse, type GetApiKeyResponses, type GetBoardData, type GetBoardError, type GetBoardErrors, type GetBoardResponse, type GetBoardResponses, type GetChannelBindingData, type GetChannelBindingError, type GetChannelBindingErrors, type GetChannelBindingResponse, type GetChannelBindingResponses, type GetChannelConversationData, type GetChannelConversationError, type GetChannelConversationErrors, type GetChannelConversationResponse, type GetChannelConversationResponses, type GetChannelData, type GetChannelError, type GetChannelErrors, type GetChannelResponse, type GetChannelResponses, type GetCurrentUserData, type GetCurrentUserError, type GetCurrentUserErrors, type GetCurrentUserResponse, type GetCurrentUserResponses, type GetGenerationData, type GetGenerationError, type GetGenerationErrors, type GetGenerationResponse, type GetGenerationResponses, type GetGenerationUsageData, type GetGenerationUsageError, type GetGenerationUsageErrors, type GetGenerationUsageResponse, type GetGenerationUsageResponses, type GetKnowledgeCollectionData, type GetKnowledgeCollectionError, type GetKnowledgeCollectionErrors, type GetKnowledgeCollectionResponse, type GetKnowledgeCollectionResponses, type GetKnowledgeConverterData, type GetKnowledgeConverterError, type GetKnowledgeConverterErrors, type GetKnowledgeConverterResponse, type GetKnowledgeConverterResponses, type GetKnowledgeDocumentData, type GetKnowledgeDocumentError, type GetKnowledgeDocumentErrors, type GetKnowledgeDocumentResponse, type GetKnowledgeDocumentResponses, type GetModelData, type GetModelError, type GetModelErrors, type GetModelResponse, type GetModelResponses, type GetProjectData, type GetProjectError, type GetProjectErrors, type GetProjectResponse, type GetProjectResponses, type GetProjectUsageData, type GetProjectUsageError, type GetProjectUsageErrors, type GetProjectUsageResponse, type GetProjectUsageResponses, type GetProviderData, type GetProviderError, type GetProviderErrors, type GetProviderResponse, type GetProviderResponses, type GetSessionData, type GetSessionError, type GetSessionErrors, type GetSessionResponse, type GetSessionResponses, type GetTaskData, type GetTaskError, type GetTaskErrors, type GetTaskResponse, type GetTaskResponses, type GetToolData, type GetToolError, type GetToolErrors, type GetToolResponse, type GetToolResponses, type GetTraceData, type GetTraceError, type GetTraceErrors, type GetTraceResponse, type GetTraceResponses, type GetTraceStepsData, type GetTraceStepsError, type GetTraceStepsErrors, type GetTraceStepsResponse, type GetTraceStepsResponses, type GetTraceTreeData, type GetTraceTreeError, type GetTraceTreeErrors, type GetTraceTreeResponse, type GetTraceTreeResponses, type GetWebhookData, type GetWebhookDeliveryData, type GetWebhookDeliveryError, type GetWebhookDeliveryErrors, type GetWebhookDeliveryResponse, type GetWebhookDeliveryResponses, type GetWebhookError, type GetWebhookErrors, type GetWebhookResponse, type GetWebhookResponses, type GrantId, type HttpExecute, type IdempotencyKey, Knowledge, type KnowledgeChunk, type KnowledgeCollection, type KnowledgeCollectionCreate, type KnowledgeCollectionList, type KnowledgeCollectionUpdate, type KnowledgeConverter, type KnowledgeConverterCreate, type KnowledgeConverterList, type KnowledgeConverterUpdate, type KnowledgeDocument, type KnowledgeDocumentCreate, type KnowledgeDocumentList, type KnowledgeQueryRequest, type KnowledgeQueryResult, type Limit, type LinkToken, type ListAgentGenerationsData, type ListAgentGenerationsError, type ListAgentGenerationsErrors, type ListAgentGenerationsResponse, type ListAgentGenerationsResponses, type ListAgentsData, type ListAgentsError, type ListAgentsErrors, type ListAgentsResponse, type ListAgentsResponses, type ListApiKeysData, type ListApiKeysError, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListAssistantGrantsData, type ListAssistantGrantsError, type ListAssistantGrantsErrors, type ListAssistantGrantsResponse, type ListAssistantGrantsResponses, type ListBoardsData, type ListBoardsError, type ListBoardsErrors, type ListBoardsResponse, type ListBoardsResponses, type ListChannelConversationMessagesData, type ListChannelConversationMessagesError, type ListChannelConversationMessagesErrors, type ListChannelConversationMessagesResponse, type ListChannelConversationMessagesResponses, type ListChannelConversationsData, type ListChannelConversationsError, type ListChannelConversationsErrors, type ListChannelConversationsResponse, type ListChannelConversationsResponses, type ListChannelsData, type ListChannelsError, type ListChannelsErrors, type ListChannelsResponse, type ListChannelsResponses, type ListKnowledgeCollectionsData, type ListKnowledgeCollectionsError, type ListKnowledgeCollectionsErrors, type ListKnowledgeCollectionsResponse, type ListKnowledgeCollectionsResponses, type ListKnowledgeConvertersData, type ListKnowledgeConvertersError, type ListKnowledgeConvertersErrors, type ListKnowledgeConvertersResponse, type ListKnowledgeConvertersResponses, type ListKnowledgeDocumentsData, type ListKnowledgeDocumentsError, type ListKnowledgeDocumentsErrors, type ListKnowledgeDocumentsResponse, type ListKnowledgeDocumentsResponses, type ListModelsData, type ListModelsError, type ListModelsErrors, type ListModelsResponse, type ListModelsResponses, type ListProjectsData, type ListProjectsError, type ListProjectsErrors, type ListProjectsResponse, type ListProjectsResponses, type ListProvidersData, type ListProvidersError, type ListProvidersErrors, type ListProvidersResponse, type ListProvidersResponses, type ListSessionMessagesData, type ListSessionMessagesError, type ListSessionMessagesErrors, type ListSessionMessagesResponse, type ListSessionMessagesResponses, type ListTaskTransitionsData, type ListTaskTransitionsError, type ListTaskTransitionsErrors, type ListTaskTransitionsResponse, type ListTaskTransitionsResponses, type ListTasksData, type ListTasksError, type ListTasksErrors, type ListTasksResponse, type ListTasksResponses, type ListToolsData, type ListToolsError, type ListToolsErrors, type ListToolsResponse, type ListToolsResponses, type ListTraceGenerationsData, type ListTraceGenerationsError, type ListTraceGenerationsErrors, type ListTraceGenerationsResponse, type ListTraceGenerationsResponses, type ListTracesData, type ListTracesError, type ListTracesErrors, type ListTracesResponse, type ListTracesResponses, type ListWebhookDeliveriesData, type ListWebhookDeliveriesError, type ListWebhookDeliveriesErrors, type ListWebhookDeliveriesResponse, type ListWebhookDeliveriesResponses, type ListWebhooksData, type ListWebhooksError, type ListWebhooksErrors, type ListWebhooksResponse, type ListWebhooksResponses, type LogoutData, type LogoutError, type LogoutErrors, type LogoutRequest, type LogoutResponse, type LogoutResponses, type McpConfig, type Message, type MessagesLimit, type Model, type ModelList, Models, NaturaliClient, type NaturaliClientOptions, type Offset, type Options, type PreviewAssistantLinkData, type PreviewAssistantLinkError, type PreviewAssistantLinkErrors, type PreviewAssistantLinkResponse, type PreviewAssistantLinkResponses, type Project, type ProjectCreate, type ProjectId, type ProjectList, type ProjectUpdate, type ProjectUsage, Projects, type Provider, type ProviderCreate, type ProviderId, type ProviderList, type ProviderUpdate, Providers, type QueryKnowledgeCollectionData, type QueryKnowledgeCollectionError, type QueryKnowledgeCollectionErrors, type QueryKnowledgeCollectionResponse, type QueryKnowledgeCollectionResponses, type RedeemAssistantLinkData, type RedeemAssistantLinkError, type RedeemAssistantLinkErrors, type RedeemAssistantLinkResponse, type RedeemAssistantLinkResponses, type RedeliverWebhookDeliveryData, type RedeliverWebhookDeliveryError, type RedeliverWebhookDeliveryErrors, type RedeliverWebhookDeliveryResponse, type RedeliverWebhookDeliveryResponses, type RefreshRequest, type RefreshSessionData, type RefreshSessionError, type RefreshSessionErrors, type RefreshSessionResponse, type RefreshSessionResponses, type ReingestKnowledgeDocumentData, type ReingestKnowledgeDocumentError, type ReingestKnowledgeDocumentErrors, type ReingestKnowledgeDocumentResponse, type ReingestKnowledgeDocumentResponses, type RequestSignInCodeData, type RequestSignInCodeError, type RequestSignInCodeErrors, type RequestSignInCodeResponse, type RequestSignInCodeResponses, type RevokeAssistantGrantData, type RevokeAssistantGrantError, type RevokeAssistantGrantErrors, type RevokeAssistantGrantResponse, type RevokeAssistantGrantResponses, type RotateApiKeyData, type RotateApiKeyError, type RotateApiKeyErrors, type RotateApiKeyResponse, type RotateApiKeyResponses, type RotateWebhookSecretData, type RotateWebhookSecretError, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type Session, type SessionCreate, type SessionGenerate, type SessionGeneration, type SessionId, type SessionMessage, type SessionMessageCreate, type SessionMessageList, type SessionTranscriptMessage, Sessions, type SetChannelBindingData, type SetChannelBindingError, type SetChannelBindingErrors, type SetChannelBindingResponse, type SetChannelBindingResponses, type SignInCodeRequest, type SignInCodeVerify, type StateFilter, type StatusFilter, type StepRules, type Task, type TaskCreate, type TaskId, type TaskList, type TaskTransitionList, type TaskTransitionRecord, type TaskTransitionRequest, type TaskUpdate, Tasks, type Tool, type ToolChoice, type ToolContext, type ToolCreate, type ToolId, type ToolList, type ToolUpdate, Tools, type Trace, type TraceId, type TraceList, type TraceSteps, type TraceTreeNode, Traces, type TransitionTaskData, type TransitionTaskError, type TransitionTaskErrors, type TransitionTaskResponse, type TransitionTaskResponses, type UpdateAgentData, type UpdateAgentError, type UpdateAgentErrors, type UpdateAgentResponse, type UpdateAgentResponses, type UpdateApiKeyData, type UpdateApiKeyError, type UpdateApiKeyErrors, type UpdateApiKeyResponse, type UpdateApiKeyResponses, type UpdateBoardData, type UpdateBoardError, type UpdateBoardErrors, type UpdateBoardResponse, type UpdateBoardResponses, type UpdateChannelData, type UpdateChannelError, type UpdateChannelErrors, type UpdateChannelResponse, type UpdateChannelResponses, type UpdateKnowledgeCollectionData, type UpdateKnowledgeCollectionError, type UpdateKnowledgeCollectionErrors, type UpdateKnowledgeCollectionResponse, type UpdateKnowledgeCollectionResponses, type UpdateKnowledgeConverterData, type UpdateKnowledgeConverterError, type UpdateKnowledgeConverterErrors, type UpdateKnowledgeConverterResponse, type UpdateKnowledgeConverterResponses, type UpdateProjectData, type UpdateProjectError, type UpdateProjectErrors, type UpdateProjectResponse, type UpdateProjectResponses, type UpdateProviderData, type UpdateProviderError, type UpdateProviderErrors, type UpdateProviderResponse, type UpdateProviderResponses, type UpdateTaskData, type UpdateTaskError, type UpdateTaskErrors, type UpdateTaskResponse, type UpdateTaskResponses, type UpdateToolData, type UpdateToolError, type UpdateToolErrors, type UpdateToolResponse, type UpdateToolResponses, type UpdateWebhookData, type UpdateWebhookError, type UpdateWebhookErrors, type UpdateWebhookResponse, type UpdateWebhookResponses, type UsageGroup, type UsageTokens, type User, type VerifySignInCodeData, type VerifySignInCodeError, type VerifySignInCodeErrors, type VerifySignInCodeResponse, type VerifySignInCodeResponses, type Webhook, type WebhookCreate, type WebhookDelivery, type WebhookDeliveryList, type WebhookId, type WebhookList, type WebhookUpdate, type WebhookWithSecret, Webhooks, createClient, createConfig };