@naturali/sdk 0.40.1 → 0.42.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.
package/dist/index.d.cts CHANGED
@@ -1460,6 +1460,11 @@ type KnowledgeDocument = {
1460
1460
  collection_id: string;
1461
1461
  project_id: string;
1462
1462
  filename: string | null;
1463
+ /**
1464
+ * Media type of the source file; null for an inline-text document.
1465
+ *
1466
+ */
1467
+ content_type: string | null;
1463
1468
  /**
1464
1469
  * Ingestion status (API.md §4, K1). `pending` — enqueued/processing; `indexed` — fully embedded and retrievable; `failed` — ingestion error (see `error`).
1465
1470
  *
@@ -1473,6 +1478,11 @@ type KnowledgeDocument = {
1473
1478
  * Source size in bytes.
1474
1479
  */
1475
1480
  size: number | null;
1481
+ /**
1482
+ * Number of embedded chunks the document was split into; null until ingestion finishes.
1483
+ *
1484
+ */
1485
+ chunk_count: number | null;
1476
1486
  /**
1477
1487
  * Text content — present on get when indexed, null on list.
1478
1488
  */
@@ -1480,19 +1490,48 @@ type KnowledgeDocument = {
1480
1490
  created_at: Date;
1481
1491
  updated_at: Date;
1482
1492
  };
1493
+ /**
1494
+ * Exactly one of `content` (inline text) or `file` (a base64-encoded upload). `file` additionally requires `content_type` and `filename`.
1495
+ *
1496
+ */
1483
1497
  type KnowledgeDocumentCreate = {
1484
1498
  /**
1485
- * The document's text content.
1499
+ * The document's text content. Mutually exclusive with `file`.
1486
1500
  */
1487
- content: string;
1501
+ content?: string;
1502
+ /**
1503
+ * The file's bytes, base64-encoded. Mutually exclusive with `content`.
1504
+ *
1505
+ */
1506
+ file?: string;
1507
+ /**
1508
+ * Media type of `file`. `application/pdf`, `text/plain` and `text/markdown` are extracted natively; anything else needs a matching converter in the project. Required with `file`.
1509
+ *
1510
+ */
1511
+ content_type?: string;
1488
1512
  /**
1489
- * A label for the document; also its logical filename.
1513
+ * A label for the document; also its logical filename. Required with `file`.
1514
+ *
1490
1515
  */
1491
1516
  filename?: string;
1492
1517
  /**
1493
1518
  * Human-readable title.
1494
1519
  */
1495
1520
  title?: string;
1521
+ /**
1522
+ * How the extracted text is split for embedding. `page` (the default) makes one chunk per page, which is what lets a retrieved chunk cite a page number; `size` makes fixed-width character windows, which retrieves more sharply on dense pages at the cost of that citation; `whole` keeps the document as a single chunk. Ignored for inline text.
1523
+ *
1524
+ */
1525
+ chunk_strategy?: 'page' | 'size' | 'whole';
1526
+ /**
1527
+ * Window width in characters, when `chunk_strategy` is `size`.
1528
+ */
1529
+ chunk_size?: number;
1530
+ /**
1531
+ * Characters of overlap between consecutive windows, when `chunk_strategy` is `size`. Must be smaller than `chunk_size`.
1532
+ *
1533
+ */
1534
+ chunk_overlap?: number;
1496
1535
  };
1497
1536
  type KnowledgeDocumentList = {
1498
1537
  data: Array<KnowledgeDocument>;
@@ -1501,6 +1540,103 @@ type KnowledgeDocumentList = {
1501
1540
  */
1502
1541
  next_cursor: string | null;
1503
1542
  };
1543
+ type KnowledgeConverter = {
1544
+ /**
1545
+ * Public converter ID (igr_ prefix).
1546
+ */
1547
+ id: string;
1548
+ project_id: string;
1549
+ /**
1550
+ * The media-type glob this converter claims, matched against an uploaded file's `content_type`.
1551
+ *
1552
+ */
1553
+ content_type: string;
1554
+ /**
1555
+ * The agent that converts the file; null for a tool converter.
1556
+ */
1557
+ agent_id: string | null;
1558
+ /**
1559
+ * The tool that converts the file; null for an agent converter.
1560
+ */
1561
+ tool_id: string | null;
1562
+ /**
1563
+ * Fixed arguments merged into every call to a tool converter (e.g. `{ "language": "en" }`). Null for an agent converter.
1564
+ *
1565
+ */
1566
+ preset_parameters: {
1567
+ [key: string]: unknown;
1568
+ } | null;
1569
+ /**
1570
+ * What to do for a media type the platform *can* extract natively (PDF, text, markdown). `first` — try native extraction and fall back to the converter only when it yields no text, which is what makes a converter a scanned-PDF fallback; `skip` — always convert.
1571
+ *
1572
+ */
1573
+ native_extraction: 'first' | 'skip';
1574
+ /**
1575
+ * Default chunking for documents this converter produces, overridable per document at create time.
1576
+ *
1577
+ */
1578
+ chunk_strategy: 'page' | 'size' | 'whole';
1579
+ chunk_size: number | null;
1580
+ chunk_overlap: number | null;
1581
+ created_at: Date;
1582
+ updated_at: Date;
1583
+ };
1584
+ /**
1585
+ * Exactly one of `agent_id` or `tool_id` is required.
1586
+ */
1587
+ type KnowledgeConverterCreate = {
1588
+ /**
1589
+ * The media-type glob to claim — an exact type (`audio/mpeg`) or a `*` wildcard on the subtype (`image*`).
1590
+ *
1591
+ */
1592
+ content_type: string;
1593
+ /**
1594
+ * An agent in this project, used as the converter.
1595
+ */
1596
+ agent_id?: string;
1597
+ /**
1598
+ * An `http` tool in this project, used as the converter.
1599
+ */
1600
+ tool_id?: string;
1601
+ /**
1602
+ * Fixed arguments merged into every tool-converter call.
1603
+ */
1604
+ preset_parameters?: {
1605
+ [key: string]: unknown;
1606
+ };
1607
+ native_extraction?: 'first' | 'skip';
1608
+ chunk_strategy?: 'page' | 'size' | 'whole';
1609
+ chunk_size?: number;
1610
+ chunk_overlap?: number;
1611
+ };
1612
+ /**
1613
+ * At least one field must be present.
1614
+ */
1615
+ type KnowledgeConverterUpdate = {
1616
+ content_type?: string;
1617
+ /**
1618
+ * Switches the converter to this agent, clearing `tool_id`.
1619
+ */
1620
+ agent_id?: string;
1621
+ /**
1622
+ * Switches the converter to this tool, clearing `agent_id`.
1623
+ */
1624
+ tool_id?: string;
1625
+ preset_parameters?: {
1626
+ [key: string]: unknown;
1627
+ } | null;
1628
+ native_extraction?: 'first' | 'skip';
1629
+ chunk_strategy?: 'page' | 'size' | 'whole';
1630
+ chunk_size?: number;
1631
+ chunk_overlap?: number;
1632
+ };
1633
+ type KnowledgeConverterList = {
1634
+ data: Array<KnowledgeConverter>;
1635
+ /**
1636
+ * Cursor for the next page, or null at the end.
1637
+ */
1638
+ next_cursor: string | null;
1639
+ };
1504
1640
  type KnowledgeQueryRequest = {
1505
1641
  /**
1506
1642
  * The question to preview retrieval for.
@@ -2269,6 +2405,151 @@ type TraceList = {
2269
2405
  limit: number;
2270
2406
  offset: number;
2271
2407
  };
2408
+ /**
2409
+ * A naturali event type. The set below is what v1 emits — deliberately only the events naturali itself causes, so no declared name is one that never fires.
2410
+ *
2411
+ */
2412
+ type EventType = 'task.created' | 'task.updated' | 'conversation.started' | 'message.received' | 'knowledge.document_ingested' | 'knowledge.ingest_failed' | 'generation.completed' | 'generation.failed';
2413
+ /**
2414
+ * Which events this endpoint receives. Each entry is an exact type (`task.created`), a resource wildcard (`task.*`), or `*` for everything. A bare resource name (`task`) matches nothing and is rejected.
2415
+ *
2416
+ */
2417
+ type EventSubscription = Array<string>;
2418
+ /**
2419
+ * The envelope POSTed to your endpoint. It is also what a delivery's `payload` holds, byte for byte, so the signed body and the recorded one are the same document.
2420
+ *
2421
+ */
2422
+ type Event = {
2423
+ /**
2424
+ * Unique per event (`evt_` prefix), and stable across redeliveries — dedupe on this if your receiver must process an event exactly once.
2425
+ *
2426
+ */
2427
+ id: string;
2428
+ type: EventType;
2429
+ project_id: string;
2430
+ /**
2431
+ * What the event is about.
2432
+ */
2433
+ resource_type: 'task' | 'conversation' | 'message' | 'knowledge_document' | 'generation';
2434
+ /**
2435
+ * The id of that resource, in the form its own API uses.
2436
+ */
2437
+ resource_id: string;
2438
+ /**
2439
+ * The resource, shaped exactly as its own API returns it — a `task.created` payload carries the same object `getTask` would.
2440
+ *
2441
+ */
2442
+ data: {
2443
+ [key: string]: unknown;
2444
+ };
2445
+ created_at: Date;
2446
+ };
2447
+ type Webhook = {
2448
+ /**
2449
+ * Public webhook ID (whk_ prefix).
2450
+ */
2451
+ id: string;
2452
+ project_id: string;
2453
+ /**
2454
+ * Where deliveries are POSTed.
2455
+ */
2456
+ url: string;
2457
+ events: EventSubscription;
2458
+ /**
2459
+ * Operator-facing label.
2460
+ */
2461
+ description: string | null;
2462
+ /**
2463
+ * Whether deliveries are attempted.
2464
+ */
2465
+ active: boolean;
2466
+ created_at: Date;
2467
+ updated_at: Date;
2468
+ };
2469
+ type WebhookWithSecret = Webhook & {
2470
+ /**
2471
+ * The signing key (`whsec_` prefix), returned only by create and rotate. Never readable afterwards.
2472
+ *
2473
+ */
2474
+ secret: string;
2475
+ };
2476
+ type WebhookCreate = {
2477
+ /**
2478
+ * An `https://` endpoint (`http://` is accepted for localhost, so a tunnel works in development).
2479
+ *
2480
+ */
2481
+ url: string;
2482
+ events: EventSubscription;
2483
+ description?: string | null;
2484
+ active?: boolean;
2485
+ };
2486
+ /**
2487
+ * At least one field is required.
2488
+ */
2489
+ type WebhookUpdate = {
2490
+ url?: string;
2491
+ events?: EventSubscription;
2492
+ description?: string | null;
2493
+ active?: boolean;
2494
+ };
2495
+ type WebhookList = {
2496
+ data: Array<Webhook>;
2497
+ /**
2498
+ * Cursor for the next page, or null when there are no more.
2499
+ */
2500
+ next_cursor: string | null;
2501
+ };
2502
+ /**
2503
+ * One event addressed to one endpoint, and everything that happened to it.
2504
+ */
2505
+ type WebhookDelivery = {
2506
+ /**
2507
+ * Public delivery ID (whd_ prefix). Sent with the request as `X-Naturali-Delivery`.
2508
+ *
2509
+ */
2510
+ id: string;
2511
+ project_id: string;
2512
+ webhook_id: string;
2513
+ /**
2514
+ * The event's id; shared by every delivery and redelivery of it.
2515
+ */
2516
+ event_id: string;
2517
+ event_type: EventType;
2518
+ payload: Event;
2519
+ /**
2520
+ * `pending` until a 2xx is received (`success`) or the attempts are exhausted (`failed`). A failed delivery can be replayed with `…:redeliver`.
2521
+ *
2522
+ */
2523
+ status: 'pending' | 'success' | 'failed';
2524
+ /**
2525
+ * The receiver's HTTP status on the last attempt; null when the attempt never got a response (DNS, TLS, refused, timed out).
2526
+ *
2527
+ */
2528
+ status_code: number | null;
2529
+ /**
2530
+ * Attempts made so far.
2531
+ */
2532
+ attempts: number;
2533
+ /**
2534
+ * When the next retry is due; null once the delivery is terminal.
2535
+ */
2536
+ next_attempt_at: Date | null;
2537
+ last_attempt_at: Date | null;
2538
+ /**
2539
+ * A truncated snippet of the receiver's response, or the transport error when there was no response.
2540
+ *
2541
+ */
2542
+ response_body: string | null;
2543
+ created_at: Date;
2544
+ updated_at: Date;
2545
+ };
2546
+ type WebhookDeliveryList = {
2547
+ data: Array<WebhookDelivery>;
2548
+ /**
2549
+ * Cursor for the next page, or null when there are no more.
2550
+ */
2551
+ next_cursor: string | null;
2552
+ };
2272
2553
  /**
2273
2554
  * Maximum items per page.
2274
2555
  */
@@ -2346,6 +2627,10 @@ type CollectionId = string;
2346
2627
  * Knowledge document public ID (doc_ prefix) — the runtime document id.
2347
2628
  */
2348
2629
  type DocumentId = string;
2630
+ /**
2631
+ * Knowledge converter public ID (igr_ prefix).
2632
+ */
2633
+ type ConverterId = string;
2349
2634
  /**
2350
2635
  * Provider public ID (aip_ prefix).
2351
2636
  */
@@ -2382,6 +2667,14 @@ type ToolId = string;
2382
2667
  * Trace public ID (trace_ prefix).
2383
2668
  */
2384
2669
  type TraceId = string;
2670
+ /**
2671
+ * Webhook public ID (whk_ prefix).
2672
+ */
2673
+ type WebhookId = string;
2674
+ /**
2675
+ * Delivery public ID (whd_ prefix).
2676
+ */
2677
+ type DeliveryId = string;
2385
2678
  type ListAgentsData = {
2386
2679
  body?: never;
2387
2680
  path: {
@@ -4505,6 +4798,10 @@ type CreateKnowledgeDocumentErrors = {
4505
4798
  * The resource does not exist (existence is not leaked).
4506
4799
  */
4507
4800
  404: ErrorResponse;
4801
+ /**
4802
+ * The uploaded file exceeds the maximum size.
4803
+ */
4804
+ 413: ErrorResponse;
4508
4805
  /**
4509
4806
  * The upstream runtime could not complete the operation.
4510
4807
  */
@@ -4641,9 +4938,14 @@ type ReingestKnowledgeDocumentResponses = {
4641
4938
  202: KnowledgeDocument;
4642
4939
  };
4643
4940
  type ReingestKnowledgeDocumentResponse = ReingestKnowledgeDocumentResponses[keyof ReingestKnowledgeDocumentResponses];
4644
- type ListModelsData = {
4941
+ type ListKnowledgeConvertersData = {
4645
4942
  body?: never;
4646
- path?: never;
4943
+ path: {
4944
+ /**
4945
+ * Project public ID (proj_ prefix).
4946
+ */
4947
+ project_id: string;
4948
+ };
4647
4949
  query?: {
4648
4950
  /**
4649
4951
  * Maximum items per page.
@@ -4653,61 +4955,53 @@ type ListModelsData = {
4653
4955
  * Opaque pagination cursor from a previous response's next_cursor.
4654
4956
  */
4655
4957
  cursor?: string;
4656
- /**
4657
- * Filter by model maker (e.g. anthropic, amazon, meta).
4658
- */
4659
- vendor?: string;
4660
- /**
4661
- * Filter by the provider slug that serves the model.
4662
- */
4663
- provider?: string;
4664
- /**
4665
- * Filter to models whose input or output modalities include this value (e.g. text, image, embedding, speech).
4666
- *
4667
- */
4668
- modality?: string;
4669
- /**
4670
- * Filter by lifecycle status.
4671
- */
4672
- status?: 'available' | 'deprecated';
4673
- /**
4674
- * Filter by whether the model can back a managed provider — `managed=true` is the set you can pass to `POST /v1/projects/{project_id}/providers` with `kind: managed`. Omit to leave the catalog unfiltered on this axis; `false` returns only the BYOK-only models. Any other value is a 400.
4675
- *
4676
- */
4677
- managed?: boolean;
4678
4958
  };
4679
- url: '/v1/models';
4959
+ url: '/v1/projects/{project_id}/knowledge/converters';
4680
4960
  };
4681
- type ListModelsErrors = {
4682
- /**
4683
- * The request was malformed or failed validation.
4684
- */
4685
- 400: ErrorResponse;
4961
+ type ListKnowledgeConvertersErrors = {
4686
4962
  /**
4687
4963
  * Missing or invalid credentials.
4688
4964
  */
4689
4965
  401: ErrorResponse;
4966
+ /**
4967
+ * The resource does not exist (existence is not leaked).
4968
+ */
4969
+ 404: ErrorResponse;
4970
+ /**
4971
+ * The upstream runtime could not complete the operation.
4972
+ */
4973
+ 502: ErrorResponse;
4690
4974
  };
4691
- type ListModelsError = ListModelsErrors[keyof ListModelsErrors];
4692
- type ListModelsResponses = {
4975
+ type ListKnowledgeConvertersError = ListKnowledgeConvertersErrors[keyof ListKnowledgeConvertersErrors];
4976
+ type ListKnowledgeConvertersResponses = {
4693
4977
  /**
4694
- * A page of models.
4978
+ * A page of converters.
4695
4979
  */
4696
- 200: ModelList;
4980
+ 200: KnowledgeConverterList;
4697
4981
  };
4698
- type ListModelsResponse = ListModelsResponses[keyof ListModelsResponses];
4699
- type GetModelData = {
4700
- body?: never;
4982
+ type ListKnowledgeConvertersResponse = ListKnowledgeConvertersResponses[keyof ListKnowledgeConvertersResponses];
4983
+ type CreateKnowledgeConverterData = {
4984
+ body: KnowledgeConverterCreate;
4985
+ headers?: {
4986
+ /**
4987
+ * Client-supplied key to make this mutating POST idempotent.
4988
+ */
4989
+ 'Idempotency-Key'?: string;
4990
+ };
4701
4991
  path: {
4702
4992
  /**
4703
- * Public model id.
4993
+ * Project public ID (proj_ prefix).
4704
4994
  */
4705
- model_id: string;
4995
+ project_id: string;
4706
4996
  };
4707
4997
  query?: never;
4708
- url: '/v1/models/{model_id}';
4998
+ url: '/v1/projects/{project_id}/knowledge/converters';
4709
4999
  };
4710
- type GetModelErrors = {
5000
+ type CreateKnowledgeConverterErrors = {
5001
+ /**
5002
+ * The request was malformed or failed validation.
5003
+ */
5004
+ 400: ErrorResponse;
4711
5005
  /**
4712
5006
  * Missing or invalid credentials.
4713
5007
  */
@@ -4716,15 +5010,226 @@ type GetModelErrors = {
4716
5010
  * The resource does not exist (existence is not leaked).
4717
5011
  */
4718
5012
  404: ErrorResponse;
4719
- };
4720
- type GetModelError = GetModelErrors[keyof GetModelErrors];
4721
- type GetModelResponses = {
4722
5013
  /**
4723
- * Model details.
5014
+ * The request conflicts with the resource's current state.
4724
5015
  */
4725
- 200: Model;
4726
- };
4727
- type GetModelResponse = GetModelResponses[keyof GetModelResponses];
5016
+ 409: ErrorResponse;
5017
+ /**
5018
+ * The upstream runtime could not complete the operation.
5019
+ */
5020
+ 502: ErrorResponse;
5021
+ };
5022
+ type CreateKnowledgeConverterError = CreateKnowledgeConverterErrors[keyof CreateKnowledgeConverterErrors];
5023
+ type CreateKnowledgeConverterResponses = {
5024
+ /**
5025
+ * Converter created.
5026
+ */
5027
+ 201: KnowledgeConverter;
5028
+ };
5029
+ type CreateKnowledgeConverterResponse = CreateKnowledgeConverterResponses[keyof CreateKnowledgeConverterResponses];
5030
+ type DeleteKnowledgeConverterData = {
5031
+ body?: never;
5032
+ path: {
5033
+ /**
5034
+ * Project public ID (proj_ prefix).
5035
+ */
5036
+ project_id: string;
5037
+ /**
5038
+ * Knowledge converter public ID (igr_ prefix).
5039
+ */
5040
+ converter_id: string;
5041
+ };
5042
+ query?: never;
5043
+ url: '/v1/projects/{project_id}/knowledge/converters/{converter_id}';
5044
+ };
5045
+ type DeleteKnowledgeConverterErrors = {
5046
+ /**
5047
+ * Missing or invalid credentials.
5048
+ */
5049
+ 401: ErrorResponse;
5050
+ /**
5051
+ * The resource does not exist (existence is not leaked).
5052
+ */
5053
+ 404: ErrorResponse;
5054
+ /**
5055
+ * The upstream runtime could not complete the operation.
5056
+ */
5057
+ 502: ErrorResponse;
5058
+ };
5059
+ type DeleteKnowledgeConverterError = DeleteKnowledgeConverterErrors[keyof DeleteKnowledgeConverterErrors];
5060
+ type DeleteKnowledgeConverterResponses = {
5061
+ /**
5062
+ * Converter deleted.
5063
+ */
5064
+ 204: void;
5065
+ };
5066
+ type DeleteKnowledgeConverterResponse = DeleteKnowledgeConverterResponses[keyof DeleteKnowledgeConverterResponses];
5067
+ type GetKnowledgeConverterData = {
5068
+ body?: never;
5069
+ path: {
5070
+ /**
5071
+ * Project public ID (proj_ prefix).
5072
+ */
5073
+ project_id: string;
5074
+ /**
5075
+ * Knowledge converter public ID (igr_ prefix).
5076
+ */
5077
+ converter_id: string;
5078
+ };
5079
+ query?: never;
5080
+ url: '/v1/projects/{project_id}/knowledge/converters/{converter_id}';
5081
+ };
5082
+ type GetKnowledgeConverterErrors = {
5083
+ /**
5084
+ * Missing or invalid credentials.
5085
+ */
5086
+ 401: ErrorResponse;
5087
+ /**
5088
+ * The resource does not exist (existence is not leaked).
5089
+ */
5090
+ 404: ErrorResponse;
5091
+ /**
5092
+ * The upstream runtime could not complete the operation.
5093
+ */
5094
+ 502: ErrorResponse;
5095
+ };
5096
+ type GetKnowledgeConverterError = GetKnowledgeConverterErrors[keyof GetKnowledgeConverterErrors];
5097
+ type GetKnowledgeConverterResponses = {
5098
+ /**
5099
+ * Converter details.
5100
+ */
5101
+ 200: KnowledgeConverter;
5102
+ };
5103
+ type GetKnowledgeConverterResponse = GetKnowledgeConverterResponses[keyof GetKnowledgeConverterResponses];
5104
+ type UpdateKnowledgeConverterData = {
5105
+ body: KnowledgeConverterUpdate;
5106
+ path: {
5107
+ /**
5108
+ * Project public ID (proj_ prefix).
5109
+ */
5110
+ project_id: string;
5111
+ /**
5112
+ * Knowledge converter public ID (igr_ prefix).
5113
+ */
5114
+ converter_id: string;
5115
+ };
5116
+ query?: never;
5117
+ url: '/v1/projects/{project_id}/knowledge/converters/{converter_id}';
5118
+ };
5119
+ type UpdateKnowledgeConverterErrors = {
5120
+ /**
5121
+ * The request was malformed or failed validation.
5122
+ */
5123
+ 400: ErrorResponse;
5124
+ /**
5125
+ * Missing or invalid credentials.
5126
+ */
5127
+ 401: ErrorResponse;
5128
+ /**
5129
+ * The resource does not exist (existence is not leaked).
5130
+ */
5131
+ 404: ErrorResponse;
5132
+ /**
5133
+ * The request conflicts with the resource's current state.
5134
+ */
5135
+ 409: ErrorResponse;
5136
+ /**
5137
+ * The upstream runtime could not complete the operation.
5138
+ */
5139
+ 502: ErrorResponse;
5140
+ };
5141
+ type UpdateKnowledgeConverterError = UpdateKnowledgeConverterErrors[keyof UpdateKnowledgeConverterErrors];
5142
+ type UpdateKnowledgeConverterResponses = {
5143
+ /**
5144
+ * Converter updated.
5145
+ */
5146
+ 200: KnowledgeConverter;
5147
+ };
5148
+ type UpdateKnowledgeConverterResponse = UpdateKnowledgeConverterResponses[keyof UpdateKnowledgeConverterResponses];
5149
+ type ListModelsData = {
5150
+ body?: never;
5151
+ path?: never;
5152
+ query?: {
5153
+ /**
5154
+ * Maximum items per page.
5155
+ */
5156
+ limit?: number;
5157
+ /**
5158
+ * Opaque pagination cursor from a previous response's next_cursor.
5159
+ */
5160
+ cursor?: string;
5161
+ /**
5162
+ * Filter by model maker (e.g. anthropic, amazon, meta).
5163
+ */
5164
+ vendor?: string;
5165
+ /**
5166
+ * Filter by the provider slug that serves the model.
5167
+ */
5168
+ provider?: string;
5169
+ /**
5170
+ * Filter to models whose input or output modalities include this value (e.g. text, image, embedding, speech).
5171
+ *
5172
+ */
5173
+ modality?: string;
5174
+ /**
5175
+ * Filter by lifecycle status.
5176
+ */
5177
+ status?: 'available' | 'deprecated';
5178
+ /**
5179
+ * Filter by whether the model can back a managed provider — `managed=true` is the set you can pass to `POST /v1/projects/{project_id}/providers` with `kind: managed`. Omit to leave the catalog unfiltered on this axis; `false` returns only the BYOK-only models. Any other value is a 400.
5180
+ *
5181
+ */
5182
+ managed?: boolean;
5183
+ };
5184
+ url: '/v1/models';
5185
+ };
5186
+ type ListModelsErrors = {
5187
+ /**
5188
+ * The request was malformed or failed validation.
5189
+ */
5190
+ 400: ErrorResponse;
5191
+ /**
5192
+ * Missing or invalid credentials.
5193
+ */
5194
+ 401: ErrorResponse;
5195
+ };
5196
+ type ListModelsError = ListModelsErrors[keyof ListModelsErrors];
5197
+ type ListModelsResponses = {
5198
+ /**
5199
+ * A page of models.
5200
+ */
5201
+ 200: ModelList;
5202
+ };
5203
+ type ListModelsResponse = ListModelsResponses[keyof ListModelsResponses];
5204
+ type GetModelData = {
5205
+ body?: never;
5206
+ path: {
5207
+ /**
5208
+ * Public model id.
5209
+ */
5210
+ model_id: string;
5211
+ };
5212
+ query?: never;
5213
+ url: '/v1/models/{model_id}';
5214
+ };
5215
+ type GetModelErrors = {
5216
+ /**
5217
+ * Missing or invalid credentials.
5218
+ */
5219
+ 401: ErrorResponse;
5220
+ /**
5221
+ * The resource does not exist (existence is not leaked).
5222
+ */
5223
+ 404: ErrorResponse;
5224
+ };
5225
+ type GetModelError = GetModelErrors[keyof GetModelErrors];
5226
+ type GetModelResponses = {
5227
+ /**
5228
+ * Model details.
5229
+ */
5230
+ 200: Model;
5231
+ };
5232
+ type GetModelResponse = GetModelResponses[keyof GetModelResponses];
4728
5233
  type ListProjectsData = {
4729
5234
  body?: never;
4730
5235
  path?: never;
@@ -6002,6 +6507,353 @@ type ListTraceGenerationsResponses = {
6002
6507
  200: GenerationList;
6003
6508
  };
6004
6509
  type ListTraceGenerationsResponse = ListTraceGenerationsResponses[keyof ListTraceGenerationsResponses];
6510
+ type ListWebhooksData = {
6511
+ body?: never;
6512
+ path: {
6513
+ /**
6514
+ * Project public ID (proj_ prefix).
6515
+ */
6516
+ project_id: string;
6517
+ };
6518
+ query?: {
6519
+ /**
6520
+ * Maximum items per page.
6521
+ */
6522
+ limit?: number;
6523
+ /**
6524
+ * Opaque pagination cursor from a previous response's next_cursor.
6525
+ */
6526
+ cursor?: string;
6527
+ };
6528
+ url: '/v1/projects/{project_id}/webhooks';
6529
+ };
6530
+ type ListWebhooksErrors = {
6531
+ /**
6532
+ * The request was malformed or failed validation.
6533
+ */
6534
+ 400: ErrorResponse;
6535
+ /**
6536
+ * Missing or invalid credentials.
6537
+ */
6538
+ 401: ErrorResponse;
6539
+ /**
6540
+ * The resource does not exist (existence is not leaked).
6541
+ */
6542
+ 404: ErrorResponse;
6543
+ };
6544
+ type ListWebhooksError = ListWebhooksErrors[keyof ListWebhooksErrors];
6545
+ type ListWebhooksResponses = {
6546
+ /**
6547
+ * A page of webhooks.
6548
+ */
6549
+ 200: WebhookList;
6550
+ };
6551
+ type ListWebhooksResponse = ListWebhooksResponses[keyof ListWebhooksResponses];
6552
+ type CreateWebhookData = {
6553
+ body: WebhookCreate;
6554
+ headers?: {
6555
+ /**
6556
+ * Client-supplied key to make this mutating POST idempotent.
6557
+ */
6558
+ 'Idempotency-Key'?: string;
6559
+ };
6560
+ path: {
6561
+ /**
6562
+ * Project public ID (proj_ prefix).
6563
+ */
6564
+ project_id: string;
6565
+ };
6566
+ query?: never;
6567
+ url: '/v1/projects/{project_id}/webhooks';
6568
+ };
6569
+ type CreateWebhookErrors = {
6570
+ /**
6571
+ * The request was malformed or failed validation.
6572
+ */
6573
+ 400: ErrorResponse;
6574
+ /**
6575
+ * Missing or invalid credentials.
6576
+ */
6577
+ 401: ErrorResponse;
6578
+ /**
6579
+ * The resource does not exist (existence is not leaked).
6580
+ */
6581
+ 404: ErrorResponse;
6582
+ /**
6583
+ * The requested path is not enabled on this deployment (e.g. embedded signup before Meta App credentials are configured, or a Discord channel before `CHANNEL_TOKEN_KEY` is set).
6584
+ *
6585
+ */
6586
+ 501: ErrorResponse;
6587
+ };
6588
+ type CreateWebhookError = CreateWebhookErrors[keyof CreateWebhookErrors];
6589
+ type CreateWebhookResponses = {
6590
+ /**
6591
+ * Webhook created. The signing secret is included, once.
6592
+ */
6593
+ 201: WebhookWithSecret;
6594
+ };
6595
+ type CreateWebhookResponse = CreateWebhookResponses[keyof CreateWebhookResponses];
6596
+ type DeleteWebhookData = {
6597
+ body?: never;
6598
+ path: {
6599
+ /**
6600
+ * Project public ID (proj_ prefix).
6601
+ */
6602
+ project_id: string;
6603
+ /**
6604
+ * Webhook public ID (whk_ prefix).
6605
+ */
6606
+ webhook_id: string;
6607
+ };
6608
+ query?: never;
6609
+ url: '/v1/projects/{project_id}/webhooks/{webhook_id}';
6610
+ };
6611
+ type DeleteWebhookErrors = {
6612
+ /**
6613
+ * Missing or invalid credentials.
6614
+ */
6615
+ 401: ErrorResponse;
6616
+ /**
6617
+ * The resource does not exist (existence is not leaked).
6618
+ */
6619
+ 404: ErrorResponse;
6620
+ };
6621
+ type DeleteWebhookError = DeleteWebhookErrors[keyof DeleteWebhookErrors];
6622
+ type DeleteWebhookResponses = {
6623
+ /**
6624
+ * Webhook deleted.
6625
+ */
6626
+ 204: void;
6627
+ };
6628
+ type DeleteWebhookResponse = DeleteWebhookResponses[keyof DeleteWebhookResponses];
6629
+ type GetWebhookData = {
6630
+ body?: never;
6631
+ path: {
6632
+ /**
6633
+ * Project public ID (proj_ prefix).
6634
+ */
6635
+ project_id: string;
6636
+ /**
6637
+ * Webhook public ID (whk_ prefix).
6638
+ */
6639
+ webhook_id: string;
6640
+ };
6641
+ query?: never;
6642
+ url: '/v1/projects/{project_id}/webhooks/{webhook_id}';
6643
+ };
6644
+ type GetWebhookErrors = {
6645
+ /**
6646
+ * Missing or invalid credentials.
6647
+ */
6648
+ 401: ErrorResponse;
6649
+ /**
6650
+ * The resource does not exist (existence is not leaked).
6651
+ */
6652
+ 404: ErrorResponse;
6653
+ };
6654
+ type GetWebhookError = GetWebhookErrors[keyof GetWebhookErrors];
6655
+ type GetWebhookResponses = {
6656
+ /**
6657
+ * The webhook.
6658
+ */
6659
+ 200: Webhook;
6660
+ };
6661
+ type GetWebhookResponse = GetWebhookResponses[keyof GetWebhookResponses];
6662
+ type UpdateWebhookData = {
6663
+ body: WebhookUpdate;
6664
+ path: {
6665
+ /**
6666
+ * Project public ID (proj_ prefix).
6667
+ */
6668
+ project_id: string;
6669
+ /**
6670
+ * Webhook public ID (whk_ prefix).
6671
+ */
6672
+ webhook_id: string;
6673
+ };
6674
+ query?: never;
6675
+ url: '/v1/projects/{project_id}/webhooks/{webhook_id}';
6676
+ };
6677
+ type UpdateWebhookErrors = {
6678
+ /**
6679
+ * The request was malformed or failed validation.
6680
+ */
6681
+ 400: ErrorResponse;
6682
+ /**
6683
+ * Missing or invalid credentials.
6684
+ */
6685
+ 401: ErrorResponse;
6686
+ /**
6687
+ * The resource does not exist (existence is not leaked).
6688
+ */
6689
+ 404: ErrorResponse;
6690
+ };
6691
+ type UpdateWebhookError = UpdateWebhookErrors[keyof UpdateWebhookErrors];
6692
+ type UpdateWebhookResponses = {
6693
+ /**
6694
+ * Webhook updated.
6695
+ */
6696
+ 200: Webhook;
6697
+ };
6698
+ type UpdateWebhookResponse = UpdateWebhookResponses[keyof UpdateWebhookResponses];
6699
+ type RotateWebhookSecretData = {
6700
+ body?: never;
6701
+ path: {
6702
+ /**
6703
+ * Project public ID (proj_ prefix).
6704
+ */
6705
+ project_id: string;
6706
+ /**
6707
+ * Webhook public ID (whk_ prefix).
6708
+ */
6709
+ webhook_id: string;
6710
+ };
6711
+ query?: never;
6712
+ url: '/v1/projects/{project_id}/webhooks/{webhook_id}:rotate-secret';
6713
+ };
6714
+ type RotateWebhookSecretErrors = {
6715
+ /**
6716
+ * Missing or invalid credentials.
6717
+ */
6718
+ 401: ErrorResponse;
6719
+ /**
6720
+ * The resource does not exist (existence is not leaked).
6721
+ */
6722
+ 404: ErrorResponse;
6723
+ /**
6724
+ * The requested path is not enabled on this deployment (e.g. embedded signup before Meta App credentials are configured, or a Discord channel before `CHANNEL_TOKEN_KEY` is set).
6725
+ *
6726
+ */
6727
+ 501: ErrorResponse;
6728
+ };
6729
+ type RotateWebhookSecretError = RotateWebhookSecretErrors[keyof RotateWebhookSecretErrors];
6730
+ type RotateWebhookSecretResponses = {
6731
+ /**
6732
+ * A new signing secret was issued.
6733
+ */
6734
+ 200: WebhookWithSecret;
6735
+ };
6736
+ type RotateWebhookSecretResponse = RotateWebhookSecretResponses[keyof RotateWebhookSecretResponses];
6737
+ type ListWebhookDeliveriesData = {
6738
+ body?: never;
6739
+ path: {
6740
+ /**
6741
+ * Project public ID (proj_ prefix).
6742
+ */
6743
+ project_id: string;
6744
+ };
6745
+ query?: {
6746
+ /**
6747
+ * Maximum items per page.
6748
+ */
6749
+ limit?: number;
6750
+ /**
6751
+ * Opaque pagination cursor from a previous response's next_cursor.
6752
+ */
6753
+ cursor?: string;
6754
+ /**
6755
+ * Only deliveries addressed to this endpoint.
6756
+ */
6757
+ webhook_id?: string;
6758
+ /**
6759
+ * Only deliveries in this state.
6760
+ */
6761
+ status?: 'pending' | 'success' | 'failed';
6762
+ /**
6763
+ * Only deliveries of this event type.
6764
+ */
6765
+ event_type?: string;
6766
+ };
6767
+ url: '/v1/projects/{project_id}/webhook-deliveries';
6768
+ };
6769
+ type ListWebhookDeliveriesErrors = {
6770
+ /**
6771
+ * The request was malformed or failed validation.
6772
+ */
6773
+ 400: ErrorResponse;
6774
+ /**
6775
+ * Missing or invalid credentials.
6776
+ */
6777
+ 401: ErrorResponse;
6778
+ /**
6779
+ * The resource does not exist (existence is not leaked).
6780
+ */
6781
+ 404: ErrorResponse;
6782
+ };
6783
+ type ListWebhookDeliveriesError = ListWebhookDeliveriesErrors[keyof ListWebhookDeliveriesErrors];
6784
+ type ListWebhookDeliveriesResponses = {
6785
+ /**
6786
+ * A page of deliveries.
6787
+ */
6788
+ 200: WebhookDeliveryList;
6789
+ };
6790
+ type ListWebhookDeliveriesResponse = ListWebhookDeliveriesResponses[keyof ListWebhookDeliveriesResponses];
6791
+ type GetWebhookDeliveryData = {
6792
+ body?: never;
6793
+ path: {
6794
+ /**
6795
+ * Project public ID (proj_ prefix).
6796
+ */
6797
+ project_id: string;
6798
+ /**
6799
+ * Delivery public ID (whd_ prefix).
6800
+ */
6801
+ delivery_id: string;
6802
+ };
6803
+ query?: never;
6804
+ url: '/v1/projects/{project_id}/webhook-deliveries/{delivery_id}';
6805
+ };
6806
+ type GetWebhookDeliveryErrors = {
6807
+ /**
6808
+ * Missing or invalid credentials.
6809
+ */
6810
+ 401: ErrorResponse;
6811
+ /**
6812
+ * The resource does not exist (existence is not leaked).
6813
+ */
6814
+ 404: ErrorResponse;
6815
+ };
6816
+ type GetWebhookDeliveryError = GetWebhookDeliveryErrors[keyof GetWebhookDeliveryErrors];
6817
+ type GetWebhookDeliveryResponses = {
6818
+ /**
6819
+ * The delivery.
6820
+ */
6821
+ 200: WebhookDelivery;
6822
+ };
6823
+ type GetWebhookDeliveryResponse = GetWebhookDeliveryResponses[keyof GetWebhookDeliveryResponses];
6824
+ type RedeliverWebhookDeliveryData = {
6825
+ body?: never;
6826
+ path: {
6827
+ /**
6828
+ * Project public ID (proj_ prefix).
6829
+ */
6830
+ project_id: string;
6831
+ /**
6832
+ * Delivery public ID (whd_ prefix).
6833
+ */
6834
+ delivery_id: string;
6835
+ };
6836
+ query?: never;
6837
+ url: '/v1/projects/{project_id}/webhook-deliveries/{delivery_id}:redeliver';
6838
+ };
6839
+ type RedeliverWebhookDeliveryErrors = {
6840
+ /**
6841
+ * Missing or invalid credentials.
6842
+ */
6843
+ 401: ErrorResponse;
6844
+ /**
6845
+ * The resource does not exist (existence is not leaked).
6846
+ */
6847
+ 404: ErrorResponse;
6848
+ };
6849
+ type RedeliverWebhookDeliveryError = RedeliverWebhookDeliveryErrors[keyof RedeliverWebhookDeliveryErrors];
6850
+ type RedeliverWebhookDeliveryResponses = {
6851
+ /**
6852
+ * A new delivery was queued.
6853
+ */
6854
+ 202: WebhookDelivery;
6855
+ };
6856
+ type RedeliverWebhookDeliveryResponse = RedeliverWebhookDeliveryResponses[keyof RedeliverWebhookDeliveryResponses];
6005
6857
  //#endregion
6006
6858
  //#region src/generated/sdk.gen.d.ts
6007
6859
  type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options$1<TData, ThrowOnError, TResponse> & {
@@ -6404,7 +7256,11 @@ declare class Knowledge {
6404
7256
  /**
6405
7257
  * Create a document
6406
7258
  *
6407
- * Add an inline-text document to the collection. The platform ingests the content (chunk + embed) and records the document's ingestion status. File upload (PDF/binary) is a deliberate follow-up.
7259
+ * Add a document to the collection, from **inline text** (`content`) or from an **uploaded file** (`file`, base64, plus `content_type` and `filename`) exactly one of the two.
7260
+ *
7261
+ * `application/pdf`, `text/plain` and `text/markdown` are extracted natively. Any other media type needs a converter (`POST /v1/projects/{project_id}/knowledge/converters`) registered for it in the project; without one the request is rejected with `unsupported_content_type` and no document is created.
7262
+ *
7263
+ * Ingestion (extract → chunk → embed) runs in the background: the document comes back `pending` and becomes `indexed` or `failed`, which is announced by the `knowledge.document_ingested` / `knowledge.ingest_failed` webhook events.
6408
7264
  *
6409
7265
  */
6410
7266
  static createKnowledgeDocument<ThrowOnError extends boolean = false>(options: Options<CreateKnowledgeDocumentData, ThrowOnError>): RequestResult<CreateKnowledgeDocumentResponses, CreateKnowledgeDocumentErrors, ThrowOnError>;
@@ -6425,6 +7281,53 @@ declare class Knowledge {
6425
7281
  *
6426
7282
  */
6427
7283
  static reingestKnowledgeDocument<ThrowOnError extends boolean = false>(options: Options<ReingestKnowledgeDocumentData, ThrowOnError>): RequestResult<ReingestKnowledgeDocumentResponses, ReingestKnowledgeDocumentErrors, ThrowOnError>;
7284
+ /**
7285
+ * List converters
7286
+ *
7287
+ * Lists the media converters registered in the project.
7288
+ */
7289
+ static listKnowledgeConverters<ThrowOnError extends boolean = false>(options: Options<ListKnowledgeConvertersData, ThrowOnError>): RequestResult<ListKnowledgeConvertersResponses, ListKnowledgeConvertersErrors, ThrowOnError>;
7290
+ /**
7291
+ * Create a converter
7292
+ *
7293
+ * Register a converter for a media type the platform cannot extract natively, so files of that type become ingestable documents like any other. A converter maps a `content_type` glob (`image*`, `audio/mpeg`, …) onto one of two workers:
7294
+ *
7295
+ * - an **agent** (`agent_id`) — the file is handed to a
7296
+ * multimodal model with a fixed "extract all the text" instruction and
7297
+ * its answer becomes the document text. The shortest path for images
7298
+ * and scanned PDFs; nothing to map.
7299
+ *
7300
+ * - a **tool** (`tool_id`) — the file is passed to an
7301
+ * `http` tool as `{ content_type, filename, data_base64 }`, and
7302
+ * whatever string the tool returns becomes the document text. The path
7303
+ * for dedicated non-chat APIs (speech-to-text, a specialist OCR
7304
+ * engine); use the tool's `execute.body_mode: multipart` for
7305
+ * form-data endpoints and its `output_mapping` to reduce a JSON
7306
+ * response to the bare string.
7307
+ *
7308
+ *
7309
+ * Exactly one of `agent_id` / `tool_id`, and one converter per `content_type` in a project.
7310
+ *
7311
+ */
7312
+ static createKnowledgeConverter<ThrowOnError extends boolean = false>(options: Options<CreateKnowledgeConverterData, ThrowOnError>): RequestResult<CreateKnowledgeConverterResponses, CreateKnowledgeConverterErrors, ThrowOnError>;
7313
+ /**
7314
+ * Delete a converter
7315
+ *
7316
+ * Removes the converter. Documents already ingested through it are untouched; new files of that media type stop being ingestable until another converter covers them.
7317
+ *
7318
+ */
7319
+ static deleteKnowledgeConverter<ThrowOnError extends boolean = false>(options: Options<DeleteKnowledgeConverterData, ThrowOnError>): RequestResult<DeleteKnowledgeConverterResponses, DeleteKnowledgeConverterErrors, ThrowOnError>;
7320
+ /**
7321
+ * Get a converter
7322
+ */
7323
+ static getKnowledgeConverter<ThrowOnError extends boolean = false>(options: Options<GetKnowledgeConverterData, ThrowOnError>): RequestResult<GetKnowledgeConverterResponses, GetKnowledgeConverterErrors, ThrowOnError>;
7324
+ /**
7325
+ * Update a converter
7326
+ *
7327
+ * Change the worker or the chunking defaults. At least one field is required; `agent_id` and `tool_id` stay mutually exclusive, so setting one clears the other.
7328
+ *
7329
+ */
7330
+ static updateKnowledgeConverter<ThrowOnError extends boolean = false>(options: Options<UpdateKnowledgeConverterData, ThrowOnError>): RequestResult<UpdateKnowledgeConverterResponses, UpdateKnowledgeConverterErrors, ThrowOnError>;
6428
7331
  }
6429
7332
  declare class Models {
6430
7333
  /**
@@ -6656,6 +7559,73 @@ declare class Traces {
6656
7559
  */
6657
7560
  static listTraceGenerations<ThrowOnError extends boolean = false>(options: Options<ListTraceGenerationsData, ThrowOnError>): RequestResult<ListTraceGenerationsResponses, ListTraceGenerationsErrors, ThrowOnError>;
6658
7561
  }
7562
+ declare class Webhooks {
7563
+ /**
7564
+ * List webhooks
7565
+ *
7566
+ * The endpoints registered in the project, newest first.
7567
+ */
7568
+ static listWebhooks<ThrowOnError extends boolean = false>(options: Options<ListWebhooksData, ThrowOnError>): RequestResult<ListWebhooksResponses, ListWebhooksErrors, ThrowOnError>;
7569
+ /**
7570
+ * Create a webhook
7571
+ *
7572
+ * Register an endpoint and subscribe it to one or more event types.
7573
+ * The response carries `secret` — the signing key, in plaintext. **This is the only time it is returned.** Store it where your receiver can read it; if you lose it, rotate rather than re-create, so the endpoint keeps its delivery history.
7574
+ * Returns `501` on a deployment with no credential-sealing key configured, since the secret could not then be stored safely.
7575
+ *
7576
+ */
7577
+ static createWebhook<ThrowOnError extends boolean = false>(options: Options<CreateWebhookData, ThrowOnError>): RequestResult<CreateWebhookResponses, CreateWebhookErrors, ThrowOnError>;
7578
+ /**
7579
+ * Delete a webhook
7580
+ *
7581
+ * Removes the endpoint and its delivery records. To stop deliveries while keeping the audit trail, `PATCH` it to `active: false` instead.
7582
+ *
7583
+ */
7584
+ static deleteWebhook<ThrowOnError extends boolean = false>(options: Options<DeleteWebhookData, ThrowOnError>): RequestResult<DeleteWebhookResponses, DeleteWebhookErrors, ThrowOnError>;
7585
+ /**
7586
+ * Get a webhook
7587
+ */
7588
+ static getWebhook<ThrowOnError extends boolean = false>(options: Options<GetWebhookData, ThrowOnError>): RequestResult<GetWebhookResponses, GetWebhookErrors, ThrowOnError>;
7589
+ /**
7590
+ * Update a webhook
7591
+ *
7592
+ * Change the destination, the subscription, the label, or whether deliveries are attempted at all. At least one field is required.
7593
+ * Setting `active: false` is the reversible half of `DELETE`: deliveries stop, the endpoint and its history stay. It is what to reach for while a receiver is being repaired.
7594
+ *
7595
+ */
7596
+ static updateWebhook<ThrowOnError extends boolean = false>(options: Options<UpdateWebhookData, ThrowOnError>): RequestResult<UpdateWebhookResponses, UpdateWebhookErrors, ThrowOnError>;
7597
+ /**
7598
+ * Rotate the signing secret
7599
+ *
7600
+ * Issues a new signing secret for the same endpoint and returns it — the second and last time a secret is ever returned. This is the `…:rotate-secret` action; the path segment is `{webhook_id}:rotate-secret`.
7601
+ * The change takes effect on the next delivery, including retries of deliveries already queued, so roll the new secret out to your receiver promptly. There is no overlap window in which both secrets verify.
7602
+ *
7603
+ */
7604
+ static rotateWebhookSecret<ThrowOnError extends boolean = false>(options: Options<RotateWebhookSecretData, ThrowOnError>): RequestResult<RotateWebhookSecretResponses, RotateWebhookSecretErrors, ThrowOnError>;
7605
+ /**
7606
+ * List webhook deliveries
7607
+ *
7608
+ * Every delivery attempted in the project, newest first — what was sent, where, how many times, and what came back. Filter by endpoint, by lifecycle status, or by event type.
7609
+ * Deliveries are per (event, endpoint): an event matching two subscribed endpoints produces two rows, retried and observed independently.
7610
+ *
7611
+ */
7612
+ static listWebhookDeliveries<ThrowOnError extends boolean = false>(options: Options<ListWebhookDeliveriesData, ThrowOnError>): RequestResult<ListWebhookDeliveriesResponses, ListWebhookDeliveriesErrors, ThrowOnError>;
7613
+ /**
7614
+ * Get a webhook delivery
7615
+ *
7616
+ * One delivery, including the exact payload that was signed and sent.
7617
+ *
7618
+ */
7619
+ static getWebhookDelivery<ThrowOnError extends boolean = false>(options: Options<GetWebhookDeliveryData, ThrowOnError>): RequestResult<GetWebhookDeliveryResponses, GetWebhookDeliveryErrors, ThrowOnError>;
7620
+ /**
7621
+ * Redeliver an event
7622
+ *
7623
+ * Queue the same event at the same endpoint again — the recovery path for a delivery that failed, or one your receiver dropped. This is the `…:redeliver` action; the path segment is `{delivery_id}:redeliver`.
7624
+ * A **new** delivery is created and returned; the original record is left untouched, because its attempt history is the evidence you redelivered on. The event's `id` is carried over unchanged, so a receiver deduping on the event sees the same event twice while one deduping on `X-Naturali-Delivery` sees a distinct delivery.
7625
+ *
7626
+ */
7627
+ static redeliverWebhookDelivery<ThrowOnError extends boolean = false>(options: Options<RedeliverWebhookDeliveryData, ThrowOnError>): RequestResult<RedeliverWebhookDeliveryResponses, RedeliverWebhookDeliveryErrors, ThrowOnError>;
7628
+ }
6659
7629
  //#endregion
6660
7630
  //#region src/naturaliClient.d.ts
6661
7631
  interface NaturaliClientOptions {
@@ -6713,9 +7683,10 @@ declare class NaturaliClient {
6713
7683
  readonly tasks: typeof Tasks;
6714
7684
  readonly tools: typeof Tools;
6715
7685
  readonly traces: typeof Traces;
7686
+ readonly webhooks: typeof Webhooks;
6716
7687
  /** The underlying HTTP client, for interceptors or one-off requests. */
6717
7688
  readonly http: Client;
6718
7689
  constructor({ token, headers }?: NaturaliClientOptions);
6719
7690
  }
6720
7691
  //#endregion
6721
- 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, 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 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 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 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 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 DiscordModes, type DocumentId, type ErrorResponse, 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 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 GetTraceTreeData, type GetTraceTreeError, type GetTraceTreeErrors, type GetTraceTreeResponse, type GetTraceTreeResponses, type HttpExecute, type IdempotencyKey, type IdentityId, Knowledge, type KnowledgeChunk, type KnowledgeCollection, type KnowledgeCollectionCreate, type KnowledgeCollectionList, type KnowledgeCollectionUpdate, type KnowledgeDocument, type KnowledgeDocumentCreate, type KnowledgeDocumentList, type KnowledgeQueryRequest, type KnowledgeQueryResult, type Limit, 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 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 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 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 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 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 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 RotateApiKeyData, type RotateApiKeyError, type RotateApiKeyErrors, type RotateApiKeyResponse, type RotateApiKeyResponses, type Session, type SessionCreate, type SessionGenerate, type SessionGeneration, type SessionId, type SessionMessage, type SessionMessageCreate, Sessions, type SetChannelBindingData, type SetChannelBindingError, type SetChannelBindingErrors, type SetChannelBindingResponse, type SetChannelBindingResponses, type SignInCodeRequest, type SignInCodeVerify, type StateFilter, type StatusFilter, 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 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 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 UsageGroup, type UsageTokens, type User, type VerifySignInCodeData, type VerifySignInCodeError, type VerifySignInCodeErrors, type VerifySignInCodeResponse, type VerifySignInCodeResponses, createClient, createConfig };
7692
+ 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, 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 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 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 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 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 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 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 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 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, Sessions, type SetChannelBindingData, type SetChannelBindingError, type SetChannelBindingErrors, type SetChannelBindingResponse, type SetChannelBindingResponses, type SignInCodeRequest, type SignInCodeVerify, type StateFilter, type StatusFilter, 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 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 };