orca-sdk 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

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.
@@ -0,0 +1,3942 @@
1
+ # Do not edit this file manually! It is generated by scripts/codegen.py
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ import logging
7
+ import os
8
+ import uuid
9
+ from contextlib import contextmanager
10
+ from contextvars import ContextVar
11
+ from string import Formatter
12
+ from typing import (
13
+ Any,
14
+ Callable,
15
+ Generator,
16
+ Literal,
17
+ Mapping,
18
+ NotRequired,
19
+ Self,
20
+ TypedDict,
21
+ cast,
22
+ overload,
23
+ )
24
+
25
+ from httpx import (
26
+ URL,
27
+ USE_CLIENT_DEFAULT,
28
+ AsyncBaseTransport,
29
+ AsyncClient,
30
+ AsyncHTTPTransport,
31
+ BaseTransport,
32
+ Headers,
33
+ HTTPTransport,
34
+ Limits,
35
+ Proxy,
36
+ Request,
37
+ Response,
38
+ Timeout,
39
+ )
40
+ from httpx._client import UseClientDefault # type: ignore
41
+ from httpx._types import AuthTypes # type: ignore
42
+ from httpx._types import CookieTypes # type: ignore
43
+ from httpx._types import FileTypes # type: ignore
44
+ from httpx._types import HeaderTypes # type: ignore
45
+ from httpx._types import RequestContent # type: ignore
46
+ from httpx._types import RequestExtensions # type: ignore
47
+ from httpx._types import TimeoutTypes # type: ignore
48
+ from httpx_retries import Retry, RetryTransport
49
+
50
+
51
+ class ActionRecommendation(TypedDict):
52
+ action: Literal["remove_duplicates", "detect_mislabels", "add_memories", "finetuning"]
53
+ """
54
+ The recommended action to take
55
+ """
56
+ rationale: str
57
+ """
58
+ Explanation for why this action was recommended
59
+ """
60
+
61
+
62
+ class AddMemorySuggestion(TypedDict):
63
+ value: str
64
+ label_name: str
65
+
66
+
67
+ class AliveResponse(TypedDict):
68
+ ok: bool
69
+
70
+
71
+ class ApiKeyMetadata(TypedDict):
72
+ id: str
73
+ org_id: str
74
+ name: str
75
+ created_by: str | None
76
+ created_at: str
77
+ updated_at: str
78
+ scope: list[Literal["ADMINISTER", "PREDICT"]]
79
+
80
+
81
+ class BaseLabelPredictionResult(TypedDict):
82
+ prediction_id: str | None
83
+ confidence: float
84
+ anomaly_score: float | None
85
+ label: int | None
86
+ label_name: str | None
87
+ logits: list[float]
88
+
89
+
90
+ class BaseModel(TypedDict):
91
+ pass
92
+
93
+
94
+ class BaseScorePredictionResult(TypedDict):
95
+ prediction_id: str | None
96
+ confidence: float
97
+ anomaly_score: float | None
98
+ score: float | None
99
+
100
+
101
+ class CascadeEditSuggestionsRequest(TypedDict):
102
+ old_label: int | None
103
+ new_label: int
104
+ max_neighbors: NotRequired[int]
105
+ max_validation_neighbors: NotRequired[int]
106
+ similarity_threshold: NotRequired[float | None]
107
+ only_if_has_old_label: NotRequired[bool]
108
+ exclude_if_new_label: NotRequired[bool]
109
+ suggestion_cooldown_time: NotRequired[float]
110
+ label_confirmation_cooldown_time: NotRequired[float]
111
+
112
+
113
+ class ClassPattern(TypedDict):
114
+ label: int
115
+ name: str
116
+ description: str
117
+
118
+
119
+ class ClassPatternsDescription(TypedDict):
120
+ overview: str
121
+ classes: list[ClassPattern]
122
+ summary: str
123
+
124
+
125
+ class ClassRepresentatives(TypedDict):
126
+ label: int
127
+ label_name: str | None
128
+ representative_memory_ids: list[str]
129
+
130
+
131
+ class ClassificationEvaluationRequest(TypedDict):
132
+ datasource_name_or_id: str
133
+ memoryset_override_name_or_id: NotRequired[str | None]
134
+ datasource_label_column: str
135
+ datasource_value_column: str
136
+ record_telemetry: NotRequired[bool]
137
+ telemetry_tags: NotRequired[list[str] | None]
138
+ subsample: NotRequired[int | float | None]
139
+ ignore_unlabeled: NotRequired[bool]
140
+
141
+
142
+ class CleanupResponse(TypedDict):
143
+ deleted_milvus_collections: list[str]
144
+ deleted_milvus_collections_count: int
145
+ deleted_blob_paths: list[str]
146
+ deleted_blob_paths_count: int
147
+
148
+
149
+ class ClusterMetrics(TypedDict):
150
+ cluster: int
151
+ memory_count: int
152
+
153
+
154
+ ColumnType = Literal["STRING", "FLOAT", "INT", "BOOL", "ENUM", "IMAGE", "OTHER"]
155
+
156
+
157
+ class ConstraintViolationErrorResponse(TypedDict):
158
+ status_code: NotRequired[int]
159
+ constraint: str
160
+
161
+
162
+ class CountPredictionsRequest(TypedDict):
163
+ model_id: NotRequired[str | None]
164
+ tag: NotRequired[str | None]
165
+ prediction_ids: NotRequired[list[str] | None]
166
+ start_timestamp: NotRequired[str | None]
167
+ end_timestamp: NotRequired[str | None]
168
+ memory_id: NotRequired[str | None]
169
+
170
+
171
+ class CreateApiKeyRequest(TypedDict):
172
+ id: NotRequired[str]
173
+ name: NotRequired[str]
174
+ created_by: NotRequired[str | None]
175
+ scope: list[Literal["ADMINISTER", "PREDICT"]]
176
+
177
+
178
+ class CreateApiKeyResponse(TypedDict):
179
+ id: str
180
+ org_id: str
181
+ name: str
182
+ created_by: str | None
183
+ created_at: str
184
+ updated_at: str
185
+ scope: list[Literal["ADMINISTER", "PREDICT"]]
186
+ api_key: str
187
+
188
+
189
+ class CreateDatasourceFromContentRequest(TypedDict):
190
+ name: str
191
+ description: NotRequired[str | None]
192
+ content: Any
193
+
194
+
195
+ class CreateOrgPlanRequest(TypedDict):
196
+ tier: Literal["FREE", "PRO", "ENTERPRISE", "CANCELLED"]
197
+
198
+
199
+ class DatasetFilterItem(TypedDict):
200
+ field: str
201
+ op: Literal["==", "!=", ">", ">=", "<", "<=", "in", "not in", "like"]
202
+ value: Any
203
+
204
+
205
+ class DeleteMemoriesRequest(TypedDict):
206
+ memory_ids: list[str]
207
+
208
+
209
+ class DeleteMemorysetsRequest(TypedDict):
210
+ memoryset_ids: list[str]
211
+
212
+
213
+ class EmbedRequest(TypedDict):
214
+ values: list[str] | list[bytes] | list[str | bytes]
215
+ max_seq_length: NotRequired[int | None]
216
+ prompt: NotRequired[str | None]
217
+
218
+
219
+ class EmbeddingEvaluationRequest(TypedDict):
220
+ datasource_name_or_id: str
221
+ eval_datasource_name_or_id: NotRequired[str | None]
222
+ subsample: NotRequired[int | float | None]
223
+ datasource_value_column: NotRequired[str]
224
+ datasource_label_column: NotRequired[str | None]
225
+ datasource_score_column: NotRequired[str | None]
226
+ neighbor_count: NotRequired[int]
227
+ batch_size: NotRequired[int]
228
+ weigh_memories: NotRequired[bool]
229
+
230
+
231
+ EmbeddingFinetuningMethod = Literal["classification", "regression", "batch_triplet_loss"]
232
+
233
+
234
+ class FeedbackMetrics(TypedDict):
235
+ avg: float | None
236
+ count: int
237
+
238
+
239
+ FeedbackType = Literal["CONTINUOUS", "BINARY"]
240
+
241
+
242
+ class FilterItem(TypedDict):
243
+ field: list
244
+ op: Literal["==", "!=", ">", ">=", "<", "<=", "in", "not in", "like"]
245
+ value: str | int | float | bool | list[str | None] | list[int] | list[float] | list[bool] | None
246
+
247
+
248
+ class GetDatasourceRowCountRequest(TypedDict):
249
+ filters: NotRequired[list[DatasetFilterItem]]
250
+
251
+
252
+ class GetDatasourceRowsRequest(TypedDict):
253
+ filters: NotRequired[list[DatasetFilterItem]]
254
+ limit: NotRequired[int]
255
+ offset: NotRequired[int]
256
+ shuffle: NotRequired[bool]
257
+ shuffle_seed: NotRequired[int | None]
258
+
259
+
260
+ class GetMemoriesRequest(TypedDict):
261
+ memory_ids: list[str]
262
+
263
+
264
+ class HealthyResponse(TypedDict):
265
+ ok: bool
266
+ checks: dict[str, bool]
267
+ durations: dict[str, int]
268
+ draining: bool
269
+ config: dict[str, str | float | int | bool | None]
270
+
271
+
272
+ class InternalServerErrorResponse(TypedDict):
273
+ status_code: NotRequired[int]
274
+ message: str
275
+ request_id: str
276
+
277
+
278
+ JobStatus = Literal["INITIALIZED", "DISPATCHED", "WAITING", "PROCESSING", "COMPLETED", "FAILED", "ABORTING", "ABORTED"]
279
+
280
+
281
+ class JobStatusInfo(TypedDict):
282
+ status: JobStatus
283
+ steps_total: int | None
284
+ steps_completed: int | None
285
+ exception: str | None
286
+ updated_at: str
287
+ created_at: str
288
+
289
+
290
+ class LabelClassMetrics(TypedDict):
291
+ label: int | None
292
+ label_name: NotRequired[str | None]
293
+ average_lookup_score: float
294
+ memory_count: int
295
+
296
+
297
+ class LabelPercentage(TypedDict):
298
+ label: int | None
299
+ percentage: float
300
+
301
+
302
+ class LabeledExample(TypedDict):
303
+ text: str
304
+ label_name: str
305
+
306
+
307
+ class LabeledMemoryInsert(TypedDict):
308
+ memory_id: NotRequired[str | None]
309
+ value: str | bytes
310
+ metadata: NotRequired[dict[str, str | int | float | bool | None]]
311
+ source_id: NotRequired[str | None]
312
+ partition_id: NotRequired[str | None]
313
+ label: int | None
314
+
315
+
316
+ class ListMemoriesRequest(TypedDict):
317
+ offset: NotRequired[int]
318
+ limit: NotRequired[int]
319
+ filters: NotRequired[list[FilterItem]]
320
+
321
+
322
+ class LookupRequest(TypedDict):
323
+ query: list[str]
324
+ count: NotRequired[int]
325
+ prompt: NotRequired[str | None]
326
+
327
+
328
+ class LookupScoreMetrics(TypedDict):
329
+ median: float
330
+ std: float
331
+ quantiles: list[float]
332
+ quantile_values: list[float]
333
+
334
+
335
+ class MemoryMetrics(TypedDict):
336
+ is_duplicate: NotRequired[bool]
337
+ duplicate_memory_ids: NotRequired[list[str]]
338
+ has_potential_duplicates: NotRequired[bool]
339
+ potential_duplicate_memory_ids: NotRequired[list[str] | None]
340
+ cluster: NotRequired[int]
341
+ embedding_2d: NotRequired[list]
342
+ anomaly_score: NotRequired[float]
343
+ neighbor_label_logits: NotRequired[list[float]]
344
+ neighbor_predicted_label: NotRequired[int | None]
345
+ neighbor_predicted_label_ambiguity: NotRequired[float]
346
+ neighbor_predicted_label_confidence: NotRequired[float]
347
+ current_label_neighbor_confidence: NotRequired[float]
348
+ normalized_neighbor_label_entropy: NotRequired[float]
349
+ neighbor_predicted_label_matches_current_label: NotRequired[bool | None]
350
+ spread: NotRequired[float]
351
+ uniformity: NotRequired[float]
352
+ concept_id: NotRequired[int | None]
353
+ subconcept_id: NotRequired[int | None]
354
+
355
+
356
+ MemoryType = Literal["LABELED", "SCORED"]
357
+
358
+
359
+ class MemorysetClassPatternsAnalysisConfig(TypedDict):
360
+ representatives_per_class: NotRequired[int]
361
+ enable_patterns_description: NotRequired[bool]
362
+
363
+
364
+ class MemorysetClassPatternsMetrics(TypedDict):
365
+ class_representatives: list[ClassRepresentatives]
366
+ patterns_description: NotRequired[ClassPatternsDescription | None]
367
+ mean_spread: float
368
+ variance_spread: float
369
+ mean_uniformity: float
370
+ variance_uniformity: float
371
+ updated_at: str
372
+
373
+
374
+ class MemorysetClusterAnalysisConfig(TypedDict):
375
+ min_cluster_size: NotRequired[int | None]
376
+ max_cluster_size: NotRequired[int | None]
377
+ partitioning_method: NotRequired[Literal["ng", "rb", "cpm"]]
378
+ resolution: NotRequired[float | None]
379
+ num_iterations: NotRequired[int]
380
+ random_state: NotRequired[int | None]
381
+
382
+
383
+ class MemorysetClusterMetrics(TypedDict):
384
+ cluster_metrics: list[ClusterMetrics]
385
+ num_outliers: int
386
+ num_clusters: int
387
+ updated_at: str
388
+
389
+
390
+ class MemorysetConceptAnalysisConfig(TypedDict):
391
+ high_level_description: NotRequired[str | None]
392
+ max_sample_rows: NotRequired[int]
393
+ min_lookup_count: NotRequired[int]
394
+ max_lookup_count: NotRequired[int]
395
+ overlap_decay_tau: NotRequired[float]
396
+ target_lcc_fraction: NotRequired[float]
397
+ min_cluster_count: NotRequired[int]
398
+ max_cluster_count: NotRequired[int]
399
+ max_trial_count: NotRequired[int]
400
+ resolution: NotRequired[float]
401
+ iterations: NotRequired[int]
402
+ use_generative_naming: NotRequired[bool]
403
+ naming_examples_count: NotRequired[int]
404
+ naming_counterexample_count: NotRequired[int]
405
+ primary_label_pct_threshold: NotRequired[float]
406
+ seed: NotRequired[int]
407
+
408
+
409
+ class MemorysetDistributionAnalysisConfig(TypedDict):
410
+ neighbor_counts: NotRequired[list[int]]
411
+ quantiles: NotRequired[list[float]]
412
+
413
+
414
+ class MemorysetDistributionMetrics(TypedDict):
415
+ lookup_score_metrics: dict[str, LookupScoreMetrics]
416
+ updated_at: str
417
+
418
+
419
+ class MemorysetDuplicateAnalysisConfig(TypedDict):
420
+ potential_duplicate_threshold: NotRequired[float]
421
+
422
+
423
+ class MemorysetDuplicateMetrics(TypedDict):
424
+ num_duplicates: int
425
+ num_potential_duplicates: int
426
+ updated_at: str
427
+
428
+
429
+ class MemorysetLabelAnalysisConfig(TypedDict):
430
+ normalize_logits: NotRequired[bool]
431
+
432
+
433
+ class MemorysetLabelMetrics(TypedDict):
434
+ label_metrics: list[LabelClassMetrics]
435
+ neighbor_prediction_accuracy: float
436
+ mean_neighbor_label_confidence: float
437
+ mean_neighbor_label_entropy: float
438
+ mean_neighbor_predicted_label_ambiguity: float
439
+ num_no_labeled_neighbors: int
440
+ num_potential_mislabels: int
441
+ updated_at: str
442
+
443
+
444
+ class MemorysetProjectionAnalysisConfig(TypedDict):
445
+ min_dist: NotRequired[float]
446
+ spread: NotRequired[float]
447
+
448
+
449
+ class MemorysetProjectionMetrics(TypedDict):
450
+ updated_at: str
451
+
452
+
453
+ class MemorysetUpdate(TypedDict):
454
+ label_names: NotRequired[list[str]]
455
+ description: NotRequired[str | None]
456
+ name: NotRequired[str]
457
+ notes: NotRequired[str | None]
458
+ hidden: NotRequired[bool]
459
+
460
+
461
+ class NotFoundErrorResponse(TypedDict):
462
+ status_code: NotRequired[int]
463
+ resource: (
464
+ Literal[
465
+ "org",
466
+ "api_key",
467
+ "datasource",
468
+ "memoryset",
469
+ "classification_model",
470
+ "regression_model",
471
+ "prediction",
472
+ "memory",
473
+ "evaluation",
474
+ "analysis",
475
+ "job",
476
+ "pretrained_embedding_model",
477
+ "finetuned_embedding_model",
478
+ "feedback_category",
479
+ "org_plan",
480
+ "worker",
481
+ ]
482
+ | None
483
+ )
484
+
485
+
486
+ class OrgPlan(TypedDict):
487
+ org_id: str
488
+ created_at: str
489
+ updated_at: str
490
+ tier: Literal["FREE", "PRO", "ENTERPRISE", "CANCELLED"]
491
+
492
+
493
+ class PRCurve(TypedDict):
494
+ thresholds: list[float]
495
+ precisions: list[float]
496
+ recalls: list[float]
497
+
498
+
499
+ class PredictionFeedback(TypedDict):
500
+ prediction_id: str
501
+ category_name: str
502
+ value: float | bool
503
+ comment: str | None
504
+ id: str
505
+ org_id: str
506
+ category_id: str
507
+ category_type: FeedbackType
508
+ created_at: str
509
+ updated_at: str
510
+
511
+
512
+ class PredictionFeedbackCategory(TypedDict):
513
+ id: str
514
+ org_id: str
515
+ name: str
516
+ type: FeedbackType
517
+ created_at: str
518
+ updated_at: str
519
+
520
+
521
+ class PredictionFeedbackRequest(TypedDict):
522
+ prediction_id: str
523
+ category_name: str
524
+ value: NotRequired[float | bool | None]
525
+ """
526
+ The feedback value. For updates, UNSET means keep existing value. None means delete the feedback.
527
+ """
528
+ comment: NotRequired[str | None]
529
+ """
530
+ Optional comment. For updates, UNSET means keep existing comment. None means remove the comment.
531
+ """
532
+
533
+
534
+ class PredictionFeedbackResult(TypedDict):
535
+ prediction_ids: list[str]
536
+ deleted_feedback_ids: list[str]
537
+ updated_feedback_ids: list[str]
538
+ inserted_feedback_ids: list[str]
539
+ new_category_ids: list[str]
540
+
541
+
542
+ PredictionSort = list[list]
543
+
544
+
545
+ class PredictiveModelUpdate(TypedDict):
546
+ description: NotRequired[str | None]
547
+ notes: NotRequired[str | None]
548
+ locked: NotRequired[bool]
549
+
550
+
551
+ PretrainedEmbeddingModelName = Literal[
552
+ "CLIP_BASE",
553
+ "GTE_BASE",
554
+ "CDE_SMALL",
555
+ "DISTILBERT",
556
+ "GTE_SMALL",
557
+ "MXBAI_LARGE",
558
+ "E5_LARGE",
559
+ "QWEN2_1_5B",
560
+ "BGE_BASE",
561
+ "GIST_LARGE",
562
+ ]
563
+
564
+
565
+ RACHeadType = Literal["KNN", "MMOE", "FF", "BMMOE"]
566
+
567
+
568
+ RARHeadType = Literal["MMOE", "KNN"]
569
+
570
+
571
+ class ROCCurve(TypedDict):
572
+ thresholds: list[float]
573
+ false_positive_rates: list[float]
574
+ true_positive_rates: list[float]
575
+
576
+
577
+ class ReadyResponse(TypedDict):
578
+ ok: bool
579
+ draining: bool
580
+
581
+
582
+ class RegressionEvaluationRequest(TypedDict):
583
+ datasource_name_or_id: str
584
+ memoryset_override_name_or_id: NotRequired[str | None]
585
+ datasource_score_column: str
586
+ datasource_value_column: str
587
+ record_telemetry: NotRequired[bool]
588
+ telemetry_tags: NotRequired[list[str] | None]
589
+ subsample: NotRequired[int | float | None]
590
+ ignore_unlabeled: NotRequired[bool]
591
+
592
+
593
+ class RegressionMetrics(TypedDict):
594
+ coverage: float
595
+ mse: float
596
+ rmse: float
597
+ mae: float
598
+ r2: float
599
+ explained_variance: float
600
+ loss: float
601
+ anomaly_score_mean: NotRequired[float | None]
602
+ anomaly_score_median: NotRequired[float | None]
603
+ anomaly_score_variance: NotRequired[float | None]
604
+
605
+
606
+ class RegressionModelMetadata(TypedDict):
607
+ id: str
608
+ org_id: str
609
+ name: str
610
+ description: str | None
611
+ notes: str | None
612
+ version: int
613
+ memoryset_id: str
614
+ memory_lookup_count: int
615
+ storage_path: str
616
+ memoryset_collection_name: str
617
+ created_at: str
618
+ updated_at: str
619
+ locked: bool
620
+ head_type: RARHeadType
621
+
622
+
623
+ class RegressionPredictionRequest(TypedDict):
624
+ input_values: list[str] | list[bytes] | list[str | bytes]
625
+ expected_scores: NotRequired[list[float] | None]
626
+ tags: NotRequired[list[str]]
627
+ memoryset_override_name_or_id: NotRequired[str | None]
628
+ save_telemetry: NotRequired[bool]
629
+ save_telemetry_synchronously: NotRequired[bool]
630
+ prompt: NotRequired[str | None]
631
+ use_lookup_cache: NotRequired[bool]
632
+ consistency_level: NotRequired[Literal["Bounded", "Session", "Strong", "Eventual"] | None]
633
+ ignore_unlabeled: NotRequired[bool]
634
+
635
+
636
+ class ScorePredictionMemoryLookup(TypedDict):
637
+ value: str | bytes
638
+ embedding: list[float]
639
+ source_id: str | None
640
+ partition_id: str | None
641
+ metadata: dict[str, str | int | float | bool | None]
642
+ memory_id: str
643
+ memory_version: int
644
+ created_at: str
645
+ updated_at: str
646
+ edited_at: str
647
+ metrics: MemoryMetrics
648
+ lookup_score: float
649
+ score: float | None
650
+ prediction_id: str
651
+ attention_weight: float
652
+
653
+
654
+ class ScorePredictionWithMemoriesAndFeedback(TypedDict):
655
+ prediction_id: str
656
+ confidence: float
657
+ anomaly_score: float | None
658
+ score: float | None
659
+ timestamp: str
660
+ input_value: str | bytes
661
+ input_embedding: list[float]
662
+ expected_score: float | None
663
+ memories: list[ScorePredictionMemoryLookup]
664
+ org_id: str
665
+ memoryset_id: str
666
+ model_id: str
667
+ updated_at: str
668
+ tags: list[str]
669
+ explanation: str | None
670
+ memory_id: str | None
671
+ feedbacks: list[PredictionFeedback]
672
+
673
+
674
+ class ScoredMemory(TypedDict):
675
+ value: str | bytes
676
+ embedding: list[float]
677
+ source_id: str | None
678
+ partition_id: str | None
679
+ metadata: dict[str, str | int | float | bool | None]
680
+ memory_id: str
681
+ memory_version: int
682
+ created_at: str
683
+ updated_at: str
684
+ edited_at: str
685
+ metrics: MemoryMetrics
686
+ score: float | None
687
+
688
+
689
+ class ScoredMemoryInsert(TypedDict):
690
+ memory_id: NotRequired[str | None]
691
+ value: str | bytes
692
+ metadata: NotRequired[dict[str, str | int | float | bool | None]]
693
+ source_id: NotRequired[str | None]
694
+ partition_id: NotRequired[str | None]
695
+ score: float | None
696
+
697
+
698
+ class ScoredMemoryLookup(TypedDict):
699
+ value: str | bytes
700
+ embedding: list[float]
701
+ source_id: str | None
702
+ partition_id: str | None
703
+ metadata: dict[str, str | int | float | bool | None]
704
+ memory_id: str
705
+ memory_version: int
706
+ created_at: str
707
+ updated_at: str
708
+ edited_at: str
709
+ metrics: MemoryMetrics
710
+ lookup_score: float
711
+ score: float | None
712
+
713
+
714
+ class ScoredMemoryUpdate(TypedDict):
715
+ memory_id: str
716
+ value: NotRequired[str | bytes]
717
+ metadata: NotRequired[dict[str, str | int | float | bool | None] | None]
718
+ source_id: NotRequired[str | None]
719
+ partition_id: NotRequired[str | None]
720
+ metrics: NotRequired[MemoryMetrics | None]
721
+ score: NotRequired[float | None]
722
+
723
+
724
+ class ScoredMemoryWithFeedbackMetrics(TypedDict):
725
+ value: str | bytes
726
+ embedding: list[float]
727
+ source_id: str | None
728
+ partition_id: str | None
729
+ metadata: dict[str, str | int | float | bool | None]
730
+ memory_id: str
731
+ memory_version: int
732
+ created_at: str
733
+ updated_at: str
734
+ edited_at: str
735
+ metrics: MemoryMetrics
736
+ score: float | None
737
+ feedback_metrics: dict[str, FeedbackMetrics]
738
+ lookup_count: int
739
+
740
+
741
+ class ServiceUnavailableErrorResponse(TypedDict):
742
+ status_code: NotRequired[int]
743
+ service: str
744
+
745
+
746
+ class SubConceptMetrics(TypedDict):
747
+ id: int
748
+ name: str
749
+ description: str | None
750
+ primary_label: int | None
751
+ memory_count: int
752
+
753
+
754
+ TelemetryField = list
755
+
756
+
757
+ class TelemetryFilterItem(TypedDict):
758
+ field: TelemetryField
759
+ op: Literal["==", "!=", ">", ">=", "<", "<=", "in", "not in"]
760
+ value: float | list[float] | int | list[int]
761
+
762
+
763
+ class TelemetrySortOptions(TypedDict):
764
+ field: TelemetryField
765
+ direction: Literal["asc", "desc"]
766
+
767
+
768
+ class UnauthenticatedErrorResponse(TypedDict):
769
+ status_code: NotRequired[int]
770
+
771
+
772
+ class UnauthorizedErrorResponse(TypedDict):
773
+ status_code: NotRequired[int]
774
+ reason: str
775
+
776
+
777
+ class UpdateOrgPlanRequest(TypedDict):
778
+ tier: Literal["FREE", "PRO", "ENTERPRISE", "CANCELLED"]
779
+
780
+
781
+ class UpdatePredictionRequest(TypedDict):
782
+ expected_label: NotRequired[int | None]
783
+ expected_score: NotRequired[float | None]
784
+ tags: NotRequired[list[str]]
785
+ memory_id: NotRequired[str | None]
786
+
787
+
788
+ class ValidationError(TypedDict):
789
+ loc: list[str | int]
790
+ msg: str
791
+ type: str
792
+
793
+
794
+ WorkerStatus = Literal["IDLE", "BUSY", "DRAINING", "SHUTDOWN", "CRASHED"]
795
+
796
+
797
+ class GetTestErrorByStatusCodeParams(TypedDict):
798
+ status_code: int | Literal["error", "warning"]
799
+
800
+
801
+ class DeleteAuthApiKeyByNameOrIdParams(TypedDict):
802
+ name_or_id: str
803
+
804
+
805
+ class GetMemorysetParams(TypedDict):
806
+ type: NotRequired[MemoryType | None]
807
+ show_hidden: NotRequired[bool | None]
808
+
809
+
810
+ class PostMemorysetByNameOrIdCloneParams(TypedDict):
811
+ name_or_id: str
812
+
813
+
814
+ class PatchMemorysetByNameOrIdParams(TypedDict):
815
+ name_or_id: str
816
+
817
+
818
+ class GetMemorysetByNameOrIdParams(TypedDict):
819
+ name_or_id: str
820
+
821
+
822
+ class DeleteMemorysetByNameOrIdParams(TypedDict):
823
+ name_or_id: str
824
+
825
+
826
+ class PostGpuMemorysetByNameOrIdLookupParams(TypedDict):
827
+ name_or_id: str
828
+
829
+
830
+ class GetMemorysetByNameOrIdMemoryByMemoryIdParams(TypedDict):
831
+ name_or_id: str
832
+ memory_id: str
833
+ """
834
+ ID of the memory
835
+ """
836
+
837
+
838
+ class DeleteMemorysetByNameOrIdMemoryByMemoryIdParams(TypedDict):
839
+ name_or_id: str
840
+ memory_id: str
841
+ """
842
+ ID of the memory
843
+ """
844
+
845
+
846
+ class GetMemorysetByNameOrIdPotentialDuplicateGroupsParams(TypedDict):
847
+ name_or_id: str
848
+
849
+
850
+ class PostMemorysetByNameOrIdMemoriesGetParams(TypedDict):
851
+ name_or_id: str
852
+
853
+
854
+ class PostMemorysetByNameOrIdMemoriesParams(TypedDict):
855
+ name_or_id: str
856
+
857
+
858
+ class PostMemorysetByNameOrIdMemoriesDeleteParams(TypedDict):
859
+ name_or_id: str
860
+
861
+
862
+ class PatchGpuMemorysetByNameOrIdMemoryParams(TypedDict):
863
+ name_or_id: str
864
+
865
+
866
+ class PostGpuMemorysetByNameOrIdMemoryParams(TypedDict):
867
+ name_or_id: str
868
+
869
+
870
+ PostGpuMemorysetByNameOrIdMemoryRequest = list[LabeledMemoryInsert] | list[ScoredMemoryInsert]
871
+
872
+
873
+ class PatchGpuMemorysetByNameOrIdMemoriesParams(TypedDict):
874
+ name_or_id: str
875
+
876
+
877
+ class PostMemorysetByNameOrIdAnalysisParams(TypedDict):
878
+ name_or_id: str
879
+
880
+
881
+ class GetMemorysetByNameOrIdAnalysisParams(TypedDict):
882
+ name_or_id: str
883
+ status: NotRequired[JobStatus | None]
884
+ limit: NotRequired[int | None]
885
+ offset: NotRequired[int | None]
886
+
887
+
888
+ class GetMemorysetByNameOrIdAnalysisByAnalysisJobIdParams(TypedDict):
889
+ name_or_id: str
890
+ analysis_job_id: str
891
+
892
+
893
+ class PostMemorysetByNameOrIdMemoryByMemoryIdCascadingEditsParams(TypedDict):
894
+ name_or_id: str
895
+ memory_id: str
896
+
897
+
898
+ class GetFinetunedEmbeddingModelByNameOrIdParams(TypedDict):
899
+ name_or_id: str
900
+
901
+
902
+ class DeleteFinetunedEmbeddingModelByNameOrIdParams(TypedDict):
903
+ name_or_id: str
904
+
905
+
906
+ class PostGpuFinetunedEmbeddingModelByNameOrIdEmbeddingParams(TypedDict):
907
+ name_or_id: str
908
+
909
+
910
+ class GetPretrainedEmbeddingModelByModelNameParams(TypedDict):
911
+ model_name: PretrainedEmbeddingModelName
912
+
913
+
914
+ class PostGpuPretrainedEmbeddingModelByModelNameEmbeddingParams(TypedDict):
915
+ model_name: PretrainedEmbeddingModelName
916
+
917
+
918
+ class PostFinetunedEmbeddingModelByNameOrIdEvaluationParams(TypedDict):
919
+ name_or_id: str
920
+
921
+
922
+ class PostPretrainedEmbeddingModelByModelNameEvaluationParams(TypedDict):
923
+ model_name: PretrainedEmbeddingModelName
924
+
925
+
926
+ class GetFinetunedEmbeddingModelByNameOrIdEvaluationByJobIdParams(TypedDict):
927
+ name_or_id: str
928
+ job_id: str
929
+
930
+
931
+ class GetPretrainedEmbeddingModelByModelNameEvaluationByJobIdParams(TypedDict):
932
+ model_name: PretrainedEmbeddingModelName
933
+ job_id: str
934
+
935
+
936
+ class GetFinetunedEmbeddingModelByNameOrIdEvaluationsParams(TypedDict):
937
+ name_or_id: str
938
+ datasource: NotRequired[str | None]
939
+ value_column: NotRequired[str | None]
940
+ label_column: NotRequired[str | None]
941
+ score_column: NotRequired[str | None]
942
+
943
+
944
+ class GetPretrainedEmbeddingModelByModelNameEvaluationsParams(TypedDict):
945
+ model_name: PretrainedEmbeddingModelName
946
+ datasource: NotRequired[str | None]
947
+ value_column: NotRequired[str | None]
948
+ label_column: NotRequired[str | None]
949
+ score_column: NotRequired[str | None]
950
+
951
+
952
+ class PostDatasourceUploadRequest(TypedDict):
953
+ name: str
954
+ """
955
+ Name for the datasource
956
+ """
957
+ description: NotRequired[str | None]
958
+ """
959
+ Optional description for the datasource
960
+ """
961
+
962
+
963
+ class GetDatasourceByNameOrIdParams(TypedDict):
964
+ name_or_id: str
965
+
966
+
967
+ class DeleteDatasourceByNameOrIdParams(TypedDict):
968
+ name_or_id: str
969
+
970
+
971
+ class PostDatasourceByNameOrIdRowsParams(TypedDict):
972
+ name_or_id: str
973
+
974
+
975
+ class PostDatasourceByNameOrIdRowsCountParams(TypedDict):
976
+ name_or_id: str
977
+
978
+
979
+ class GetDatasourceByNameOrIdEmbeddingModelEvaluationsParams(TypedDict):
980
+ name_or_id: str
981
+ value_column: NotRequired[str | None]
982
+ label_column: NotRequired[str | None]
983
+ score_column: NotRequired[str | None]
984
+
985
+
986
+ class GetDatasourceByNameOrIdDownloadParams(TypedDict):
987
+ name_or_id: str
988
+ file_type: NotRequired[Literal["hf_dataset", "json", "csv"]]
989
+ """
990
+ File type to download:
991
+ * `hf_dataset`: Zipped HuggingFace dataset (default)
992
+ * `json`: Row-oriented JSON array
993
+ * `csv`: CSV file
994
+ """
995
+
996
+
997
+ class PatchClassificationModelByNameOrIdParams(TypedDict):
998
+ name_or_id: str
999
+
1000
+
1001
+ class GetClassificationModelByNameOrIdParams(TypedDict):
1002
+ name_or_id: str
1003
+
1004
+
1005
+ class DeleteClassificationModelByNameOrIdParams(TypedDict):
1006
+ name_or_id: str
1007
+
1008
+
1009
+ class PatchRegressionModelByNameOrIdParams(TypedDict):
1010
+ name_or_id: str
1011
+
1012
+
1013
+ class GetRegressionModelByNameOrIdParams(TypedDict):
1014
+ name_or_id: str
1015
+
1016
+
1017
+ class DeleteRegressionModelByNameOrIdParams(TypedDict):
1018
+ name_or_id: str
1019
+
1020
+
1021
+ class PostGpuClassificationModelByNameOrIdPredictionParams(TypedDict):
1022
+ name_or_id: str
1023
+
1024
+
1025
+ class PostClassificationModelByNameOrIdPredictionParams(TypedDict):
1026
+ name_or_id: str
1027
+
1028
+
1029
+ class PostGpuRegressionModelByNameOrIdPredictionParams(TypedDict):
1030
+ name_or_id: str
1031
+
1032
+
1033
+ class PostRegressionModelByNameOrIdPredictionParams(TypedDict):
1034
+ name_or_id: str
1035
+
1036
+
1037
+ class PostClassificationModelByModelNameOrIdEvaluationParams(TypedDict):
1038
+ model_name_or_id: str
1039
+
1040
+
1041
+ class GetClassificationModelByModelNameOrIdEvaluationParams(TypedDict):
1042
+ model_name_or_id: str
1043
+
1044
+
1045
+ class PostRegressionModelByModelNameOrIdEvaluationParams(TypedDict):
1046
+ model_name_or_id: str
1047
+
1048
+
1049
+ class GetRegressionModelByModelNameOrIdEvaluationParams(TypedDict):
1050
+ model_name_or_id: str
1051
+
1052
+
1053
+ class GetClassificationModelByModelNameOrIdEvaluationByJobIdParams(TypedDict):
1054
+ model_name_or_id: str
1055
+ job_id: str
1056
+
1057
+
1058
+ class DeleteClassificationModelByModelNameOrIdEvaluationByJobIdParams(TypedDict):
1059
+ model_name_or_id: str
1060
+ job_id: str
1061
+
1062
+
1063
+ class GetRegressionModelByModelNameOrIdEvaluationByJobIdParams(TypedDict):
1064
+ model_name_or_id: str
1065
+ job_id: str
1066
+
1067
+
1068
+ class DeleteRegressionModelByModelNameOrIdEvaluationByJobIdParams(TypedDict):
1069
+ model_name_or_id: str
1070
+ job_id: str
1071
+
1072
+
1073
+ class GetJobByJobIdParams(TypedDict):
1074
+ job_id: str
1075
+
1076
+
1077
+ class GetJobByJobIdStatusParams(TypedDict):
1078
+ job_id: str
1079
+
1080
+
1081
+ class GetJobParams(TypedDict):
1082
+ status: NotRequired[JobStatus | list[JobStatus] | None]
1083
+ type: NotRequired[str | list[str] | None]
1084
+ limit: NotRequired[int | None]
1085
+ offset: NotRequired[int]
1086
+ start_timestamp: NotRequired[str | None]
1087
+ end_timestamp: NotRequired[str | None]
1088
+
1089
+
1090
+ class DeleteJobByJobIdAbortParams(TypedDict):
1091
+ job_id: str
1092
+
1093
+
1094
+ class GetWorkerParams(TypedDict):
1095
+ status: NotRequired[WorkerStatus | list[WorkerStatus] | None]
1096
+ limit: NotRequired[int | None]
1097
+ offset: NotRequired[int]
1098
+
1099
+
1100
+ class GetWorkerByWorkerIdParams(TypedDict):
1101
+ worker_id: str
1102
+
1103
+
1104
+ class GetTelemetryPredictionByPredictionIdParams(TypedDict):
1105
+ prediction_id: str
1106
+
1107
+
1108
+ class PatchTelemetryPredictionByPredictionIdParams(TypedDict):
1109
+ prediction_id: str
1110
+
1111
+
1112
+ class GetTelemetryPredictionByPredictionIdExplanationParams(TypedDict):
1113
+ prediction_id: str
1114
+ refresh: NotRequired[bool]
1115
+
1116
+
1117
+ class GetTelemetryPredictionByPredictionIdActionParams(TypedDict):
1118
+ prediction_id: str
1119
+
1120
+
1121
+ class GetTelemetryPredictionByPredictionIdMemorySuggestionsParams(TypedDict):
1122
+ prediction_id: str
1123
+ """
1124
+ ID of the prediction to generate suggestions for
1125
+ """
1126
+ num_memories: NotRequired[int]
1127
+ """
1128
+ Number of memory suggestions to generate
1129
+ """
1130
+ refresh: NotRequired[bool]
1131
+ """
1132
+ Force the explanation agent to re-run even if a cached explanation exists
1133
+ """
1134
+
1135
+
1136
+ class GetTelemetryFeedbackCategoryByNameOrIdParams(TypedDict):
1137
+ name_or_id: str
1138
+
1139
+
1140
+ class DeleteTelemetryFeedbackCategoryByNameOrIdParams(TypedDict):
1141
+ name_or_id: str
1142
+
1143
+
1144
+ PutTelemetryPredictionFeedbackRequest = list[PredictionFeedbackRequest]
1145
+
1146
+
1147
+ class GetAgentsBootstrapClassificationModelByJobIdParams(TypedDict):
1148
+ job_id: str
1149
+
1150
+
1151
+ class FieldValidationError(TypedDict):
1152
+ loc: list[str | int]
1153
+ msg: str
1154
+ type: NotRequired[str]
1155
+
1156
+
1157
+ class AddMemoryRecommendations(TypedDict):
1158
+ memories: list[AddMemorySuggestion]
1159
+
1160
+
1161
+ class BootstrapClassificationModelRequest(TypedDict):
1162
+ model_description: str
1163
+ label_names: list[str]
1164
+ initial_examples: NotRequired[list[LabeledExample]]
1165
+ num_examples_per_label: NotRequired[int]
1166
+
1167
+
1168
+ class BootstrapClassificationModelResult(TypedDict):
1169
+ model_description: str
1170
+ label_names: list[str]
1171
+ model_name: str
1172
+ generated_examples: NotRequired[list[LabeledExample]]
1173
+
1174
+
1175
+ class ClassificationMetrics(TypedDict):
1176
+ coverage: float
1177
+ f1_score: float
1178
+ accuracy: float
1179
+ loss: float | None
1180
+ anomaly_score_mean: NotRequired[float | None]
1181
+ anomaly_score_median: NotRequired[float | None]
1182
+ anomaly_score_variance: NotRequired[float | None]
1183
+ roc_auc: NotRequired[float | None]
1184
+ pr_auc: NotRequired[float | None]
1185
+ pr_curve: NotRequired[PRCurve | None]
1186
+ roc_curve: NotRequired[ROCCurve | None]
1187
+
1188
+
1189
+ class ClassificationModelMetadata(TypedDict):
1190
+ id: str
1191
+ org_id: str
1192
+ name: str
1193
+ description: str | None
1194
+ notes: str | None
1195
+ version: int
1196
+ memoryset_id: str
1197
+ memory_lookup_count: int
1198
+ storage_path: str
1199
+ memoryset_collection_name: str
1200
+ created_at: str
1201
+ updated_at: str
1202
+ locked: bool
1203
+ num_classes: int
1204
+ head_type: RACHeadType
1205
+ weigh_memories: bool | None
1206
+ min_memory_weight: float | None
1207
+
1208
+
1209
+ class ClassificationPredictionRequest(TypedDict):
1210
+ input_values: list[str] | list[bytes] | list[str | bytes]
1211
+ expected_labels: NotRequired[list[int] | None]
1212
+ filters: NotRequired[list[FilterItem]]
1213
+ tags: NotRequired[list[str]]
1214
+ memoryset_override_name_or_id: NotRequired[str | None]
1215
+ save_telemetry: NotRequired[bool]
1216
+ save_telemetry_synchronously: NotRequired[bool]
1217
+ prompt: NotRequired[str | None]
1218
+ use_lookup_cache: NotRequired[bool]
1219
+ consistency_level: NotRequired[Literal["Bounded", "Session", "Strong", "Eventual"] | None]
1220
+ ignore_unlabeled: NotRequired[bool]
1221
+
1222
+
1223
+ class CloneMemorysetRequest(TypedDict):
1224
+ name: str
1225
+ description: NotRequired[str | None]
1226
+ notes: NotRequired[str | None]
1227
+ pretrained_embedding_model_name: NotRequired[PretrainedEmbeddingModelName | None]
1228
+ finetuned_embedding_model_name_or_id: NotRequired[str | None]
1229
+ max_seq_length_override: NotRequired[int | None]
1230
+ prompt: NotRequired[str]
1231
+
1232
+
1233
+ class ColumnInfo(TypedDict):
1234
+ name: str
1235
+ type: ColumnType
1236
+ enum_options: NotRequired[list[str] | None]
1237
+ string_values: NotRequired[list[str] | None]
1238
+ int_values: NotRequired[list[int] | None]
1239
+ contains_nones: NotRequired[bool]
1240
+
1241
+
1242
+ class ConceptMetrics(TypedDict):
1243
+ id: int
1244
+ name: str
1245
+ description: str | None
1246
+ primary_label: int | None
1247
+ memory_count: int
1248
+ subconcepts: list[SubConceptMetrics]
1249
+ label_percentages: list[LabelPercentage]
1250
+
1251
+
1252
+ class CreateClassificationModelRequest(TypedDict):
1253
+ name: str
1254
+ description: NotRequired[str | None]
1255
+ notes: NotRequired[str | None]
1256
+ memoryset_name: NotRequired[str | None]
1257
+ memoryset_name_or_id: str
1258
+ memory_lookup_count: NotRequired[int | None]
1259
+ head_type: NotRequired[RACHeadType]
1260
+ weigh_memories: NotRequired[bool | None]
1261
+ min_memory_weight: NotRequired[float | None]
1262
+ num_classes: NotRequired[int | None]
1263
+
1264
+
1265
+ class CreateMemorysetRequest(TypedDict):
1266
+ name: str
1267
+ description: NotRequired[str | None]
1268
+ notes: NotRequired[str | None]
1269
+ datasource_name_or_id: str
1270
+ datasource_label_column: NotRequired[str | None]
1271
+ datasource_score_column: NotRequired[str | None]
1272
+ datasource_value_column: str
1273
+ datasource_source_id_column: NotRequired[str | None]
1274
+ remove_duplicates: NotRequired[bool]
1275
+ pretrained_embedding_model_name: NotRequired[PretrainedEmbeddingModelName | None]
1276
+ finetuned_embedding_model_name_or_id: NotRequired[str | None]
1277
+ max_seq_length_override: NotRequired[int | None]
1278
+ label_names: NotRequired[list[str] | None]
1279
+ index_type: NotRequired[Literal["FLAT", "IVF_FLAT", "IVF_SQ8", "IVF_PQ", "HNSW", "DISKANN"]]
1280
+ index_params: NotRequired[dict[str, int | float | str]]
1281
+ prompt: NotRequired[str]
1282
+ hidden: NotRequired[bool]
1283
+ batch_size: NotRequired[int]
1284
+ subsample: NotRequired[int | float | None]
1285
+ memory_type: NotRequired[MemoryType]
1286
+
1287
+
1288
+ class CreateRegressionModelRequest(TypedDict):
1289
+ name: str
1290
+ description: NotRequired[str | None]
1291
+ notes: NotRequired[str | None]
1292
+ memoryset_name_or_id: str
1293
+ memory_lookup_count: NotRequired[int | None]
1294
+ head_type: NotRequired[RARHeadType]
1295
+
1296
+
1297
+ class DatasourceMetadata(TypedDict):
1298
+ id: str
1299
+ org_id: str
1300
+ name: str
1301
+ description: str | None
1302
+ storage_path: str
1303
+ length: int
1304
+ columns: list[ColumnInfo]
1305
+ created_at: str
1306
+ updated_at: str
1307
+
1308
+
1309
+ class EmbeddingEvaluationResponse(TypedDict):
1310
+ job_id: str
1311
+ org_id: str
1312
+ finetuned_embedding_model_id: str | None
1313
+ pretrained_embedding_model_name: PretrainedEmbeddingModelName | None
1314
+ datasource_id: str
1315
+ subsample: int | float | None
1316
+ datasource_value_column: str
1317
+ datasource_label_column: NotRequired[str | None]
1318
+ datasource_score_column: NotRequired[str | None]
1319
+ neighbor_count: int
1320
+ weigh_memories: bool
1321
+ status: JobStatus
1322
+ result: ClassificationMetrics | RegressionMetrics | None
1323
+ created_at: str
1324
+ updated_at: str
1325
+ task_id: str
1326
+
1327
+
1328
+ class EvaluationResponse(TypedDict):
1329
+ job_id: str
1330
+ org_id: str
1331
+ status: JobStatus
1332
+ result: ClassificationMetrics | RegressionMetrics | None
1333
+ created_at: str
1334
+ updated_at: str
1335
+ task_id: str
1336
+
1337
+
1338
+ class EvaluationResponseClassificationMetrics(TypedDict):
1339
+ job_id: str
1340
+ org_id: str
1341
+ status: JobStatus
1342
+ result: ClassificationMetrics | None
1343
+ created_at: str
1344
+ updated_at: str
1345
+ task_id: str
1346
+
1347
+
1348
+ class EvaluationResponseRegressionMetrics(TypedDict):
1349
+ job_id: str
1350
+ org_id: str
1351
+ status: JobStatus
1352
+ result: RegressionMetrics | None
1353
+ created_at: str
1354
+ updated_at: str
1355
+ task_id: str
1356
+
1357
+
1358
+ class FinetuneEmbeddingModelRequest(TypedDict):
1359
+ name: str
1360
+ base_model: PretrainedEmbeddingModelName
1361
+ train_memoryset_name_or_id: NotRequired[str | None]
1362
+ train_datasource_name_or_id: NotRequired[str | None]
1363
+ eval_datasource_name_or_id: NotRequired[str | None]
1364
+ label_column: NotRequired[str | None]
1365
+ score_column: NotRequired[str | None]
1366
+ value_column: NotRequired[str]
1367
+ training_method: NotRequired[EmbeddingFinetuningMethod]
1368
+ training_args: NotRequired[dict[str, str | int | float | bool]]
1369
+
1370
+
1371
+ class FinetunedEmbeddingModelMetadata(TypedDict):
1372
+ embedding_dim: int
1373
+ max_seq_length: int
1374
+ uses_context: bool
1375
+ id: str
1376
+ org_id: str
1377
+ name: str
1378
+ storage_path: str
1379
+ created_at: str
1380
+ updated_at: str
1381
+ base_model: PretrainedEmbeddingModelName
1382
+ finetuning_job_id: str
1383
+ finetuning_status: JobStatus
1384
+ finetuning_task_id: str
1385
+
1386
+
1387
+ class HTTPValidationError(TypedDict):
1388
+ detail: NotRequired[list[ValidationError]]
1389
+
1390
+
1391
+ class InvalidInputErrorResponse(TypedDict):
1392
+ status_code: NotRequired[int]
1393
+ validation_issues: list[FieldValidationError]
1394
+
1395
+
1396
+ class Job(TypedDict):
1397
+ status: JobStatus
1398
+ steps_total: int | None
1399
+ steps_completed: int | None
1400
+ exception: str | None
1401
+ updated_at: str
1402
+ created_at: str
1403
+ id: str
1404
+ org_id: str
1405
+ worker_id: str | None
1406
+ type: str
1407
+ payload: BaseModel
1408
+ result: BaseModel | None
1409
+ depends_on: NotRequired[list[str]]
1410
+ lease_token: str | None
1411
+
1412
+
1413
+ class LabelPredictionMemoryLookup(TypedDict):
1414
+ value: str | bytes
1415
+ embedding: list[float]
1416
+ source_id: str | None
1417
+ partition_id: str | None
1418
+ metadata: dict[str, str | int | float | bool | None]
1419
+ memory_id: str
1420
+ memory_version: int
1421
+ created_at: str
1422
+ updated_at: str
1423
+ edited_at: str
1424
+ metrics: MemoryMetrics
1425
+ label: int | None
1426
+ label_name: str | None
1427
+ lookup_score: float
1428
+ prediction_id: str
1429
+ attention_weight: float
1430
+
1431
+
1432
+ class LabelPredictionWithMemoriesAndFeedback(TypedDict):
1433
+ prediction_id: str
1434
+ confidence: float
1435
+ anomaly_score: float | None
1436
+ label: int | None
1437
+ label_name: str | None
1438
+ logits: list[float]
1439
+ timestamp: str
1440
+ input_value: str | bytes
1441
+ input_embedding: list[float]
1442
+ expected_label: int | None
1443
+ expected_label_name: str | None
1444
+ memories: list[LabelPredictionMemoryLookup]
1445
+ org_id: str
1446
+ memoryset_id: str
1447
+ model_id: str
1448
+ updated_at: str
1449
+ tags: list[str]
1450
+ explanation: str | None
1451
+ memory_id: str | None
1452
+ feedbacks: list[PredictionFeedback]
1453
+
1454
+
1455
+ class LabeledMemory(TypedDict):
1456
+ value: str | bytes
1457
+ embedding: list[float]
1458
+ source_id: str | None
1459
+ partition_id: str | None
1460
+ metadata: dict[str, str | int | float | bool | None]
1461
+ memory_id: str
1462
+ memory_version: int
1463
+ created_at: str
1464
+ updated_at: str
1465
+ edited_at: str
1466
+ metrics: MemoryMetrics
1467
+ label: int | None
1468
+ label_name: str | None
1469
+
1470
+
1471
+ class LabeledMemoryLookup(TypedDict):
1472
+ value: str | bytes
1473
+ embedding: list[float]
1474
+ source_id: str | None
1475
+ partition_id: str | None
1476
+ metadata: dict[str, str | int | float | bool | None]
1477
+ memory_id: str
1478
+ memory_version: int
1479
+ created_at: str
1480
+ updated_at: str
1481
+ edited_at: str
1482
+ metrics: MemoryMetrics
1483
+ label: int | None
1484
+ label_name: str | None
1485
+ lookup_score: float
1486
+
1487
+
1488
+ class LabeledMemoryUpdate(TypedDict):
1489
+ memory_id: str
1490
+ value: NotRequired[str | bytes]
1491
+ metadata: NotRequired[dict[str, str | int | float | bool | None] | None]
1492
+ source_id: NotRequired[str | None]
1493
+ partition_id: NotRequired[str | None]
1494
+ metrics: NotRequired[MemoryMetrics | None]
1495
+ label: NotRequired[int | None]
1496
+
1497
+
1498
+ class LabeledMemoryWithFeedbackMetrics(TypedDict):
1499
+ value: str | bytes
1500
+ embedding: list[float]
1501
+ source_id: str | None
1502
+ partition_id: str | None
1503
+ metadata: dict[str, str | int | float | bool | None]
1504
+ memory_id: str
1505
+ memory_version: int
1506
+ created_at: str
1507
+ updated_at: str
1508
+ edited_at: str
1509
+ metrics: MemoryMetrics
1510
+ label: int | None
1511
+ label_name: str | None
1512
+ feedback_metrics: dict[str, FeedbackMetrics]
1513
+ lookup_count: int
1514
+
1515
+
1516
+ class ListPredictionsRequest(TypedDict):
1517
+ model_id: NotRequired[str | None]
1518
+ tag: NotRequired[str | None]
1519
+ prediction_ids: NotRequired[list[str] | None]
1520
+ start_timestamp: NotRequired[str | None]
1521
+ end_timestamp: NotRequired[str | None]
1522
+ memory_id: NotRequired[str | None]
1523
+ limit: NotRequired[int]
1524
+ offset: NotRequired[int | None]
1525
+ sort: NotRequired[PredictionSort]
1526
+ expected_label_match: NotRequired[bool | None]
1527
+
1528
+
1529
+ class MemorysetAnalysisConfigs(TypedDict):
1530
+ distribution: NotRequired[MemorysetDistributionAnalysisConfig | None]
1531
+ label: NotRequired[MemorysetLabelAnalysisConfig | None]
1532
+ duplicate: NotRequired[MemorysetDuplicateAnalysisConfig | None]
1533
+ projection: NotRequired[MemorysetProjectionAnalysisConfig | None]
1534
+ cluster: NotRequired[MemorysetClusterAnalysisConfig | None]
1535
+ class_patterns: NotRequired[MemorysetClassPatternsAnalysisConfig | None]
1536
+ concepts: NotRequired[MemorysetConceptAnalysisConfig | None]
1537
+
1538
+
1539
+ class MemorysetAnalysisRequest(TypedDict):
1540
+ lookup_count: NotRequired[int]
1541
+ batch_size: NotRequired[int]
1542
+ clear_metrics: NotRequired[bool]
1543
+ configs: MemorysetAnalysisConfigs
1544
+
1545
+
1546
+ class MemorysetConceptMetrics(TypedDict):
1547
+ concepts: list[ConceptMetrics]
1548
+ num_outliers: int
1549
+ updated_at: str
1550
+
1551
+
1552
+ class MemorysetMetrics(TypedDict):
1553
+ distribution: NotRequired[MemorysetDistributionMetrics | None]
1554
+ label: NotRequired[MemorysetLabelMetrics | None]
1555
+ duplicate: NotRequired[MemorysetDuplicateMetrics | None]
1556
+ projection: NotRequired[MemorysetProjectionMetrics | None]
1557
+ cluster: NotRequired[MemorysetClusterMetrics | None]
1558
+ class_patterns: NotRequired[MemorysetClassPatternsMetrics | None]
1559
+ concepts: NotRequired[MemorysetConceptMetrics | None]
1560
+
1561
+
1562
+ class PaginatedJob(TypedDict):
1563
+ items: list[Job]
1564
+ total: int
1565
+ offset: int
1566
+ limit: int
1567
+
1568
+
1569
+ class PaginatedUnionLabeledMemoryWithFeedbackMetricsScoredMemoryWithFeedbackMetrics(TypedDict):
1570
+ items: list[LabeledMemoryWithFeedbackMetrics | ScoredMemoryWithFeedbackMetrics]
1571
+ total: int
1572
+ offset: int
1573
+ limit: int
1574
+
1575
+
1576
+ class PretrainedEmbeddingModelMetadata(TypedDict):
1577
+ embedding_dim: int
1578
+ max_seq_length: int
1579
+ uses_context: bool
1580
+ name: PretrainedEmbeddingModelName
1581
+ experimental: NotRequired[bool]
1582
+ supports_instructions: bool
1583
+ num_params: int
1584
+
1585
+
1586
+ class TelemetryMemoriesRequest(TypedDict):
1587
+ memoryset_id: str
1588
+ offset: NotRequired[int]
1589
+ limit: NotRequired[int]
1590
+ filters: NotRequired[list[FilterItem | TelemetryFilterItem]]
1591
+ sort: NotRequired[list[TelemetrySortOptions] | None]
1592
+
1593
+
1594
+ class WorkerInfo(TypedDict):
1595
+ id: str
1596
+ status: WorkerStatus
1597
+ started_at: str
1598
+ updated_at: str
1599
+ version: str | None
1600
+ git_sha: str
1601
+ config: dict[str, str | float | int | bool | dict[str, str] | None]
1602
+
1603
+
1604
+ PatchGpuMemorysetByNameOrIdMemoryRequest = LabeledMemoryUpdate | ScoredMemoryUpdate
1605
+
1606
+
1607
+ PatchGpuMemorysetByNameOrIdMemoriesRequest = list[LabeledMemoryUpdate] | list[ScoredMemoryUpdate]
1608
+
1609
+
1610
+ class CascadingEditSuggestion(TypedDict):
1611
+ neighbor: LabeledMemoryLookup
1612
+ suggested_label: int
1613
+ lookup_score: float
1614
+
1615
+
1616
+ class MemorysetAnalysisResponse(TypedDict):
1617
+ job_id: str
1618
+ org_id: str
1619
+ memoryset_id: str
1620
+ status: JobStatus
1621
+ lookup_count: int
1622
+ batch_size: int
1623
+ clear_metrics: bool
1624
+ configs: MemorysetAnalysisConfigs
1625
+ results: MemorysetMetrics | None
1626
+ created_at: str
1627
+ updated_at: str
1628
+ task_id: str
1629
+
1630
+
1631
+ class MemorysetMetadata(TypedDict):
1632
+ id: str
1633
+ org_id: str
1634
+ collection_name: str
1635
+ name: str
1636
+ description: str | None
1637
+ notes: str | None
1638
+ length: int
1639
+ pretrained_embedding_model_name: PretrainedEmbeddingModelName | None
1640
+ finetuned_embedding_model_id: str | None
1641
+ created_at: str
1642
+ updated_at: str
1643
+ memories_updated_at: str
1644
+ insertion_job_id: str
1645
+ insertion_status: JobStatus
1646
+ metrics: MemorysetMetrics
1647
+ memory_type: MemoryType
1648
+ label_names: list[str] | None
1649
+ index_type: Literal["FLAT", "IVF_FLAT", "IVF_SQ8", "IVF_PQ", "HNSW", "DISKANN"]
1650
+ index_params: dict[str, Any]
1651
+ database_uri: str | None
1652
+ document_prompt_override: str | None
1653
+ query_prompt_override: str | None
1654
+ hidden: bool
1655
+ insertion_task_id: str
1656
+
1657
+
1658
+ class PaginatedWorkerInfo(TypedDict):
1659
+ items: list[WorkerInfo]
1660
+ total: int
1661
+ offset: int
1662
+ limit: int
1663
+
1664
+
1665
+ class BootstrapClassificationModelMeta(TypedDict):
1666
+ datasource_meta: DatasourceMetadata
1667
+ memoryset_meta: MemorysetMetadata
1668
+ model_meta: ClassificationModelMetadata
1669
+ agent_output: BootstrapClassificationModelResult
1670
+
1671
+
1672
+ class BootstrapClassificationModelResponse(TypedDict):
1673
+ job_id: str
1674
+ org_id: str
1675
+ status: JobStatus
1676
+ result: BootstrapClassificationModelMeta | None
1677
+ input: BootstrapClassificationModelRequest | None
1678
+ task_id: str
1679
+
1680
+
1681
+ class OrcaAsyncClient(AsyncClient):
1682
+ @staticmethod
1683
+ def _parse_params(
1684
+ params: Mapping[str, Any],
1685
+ path: str,
1686
+ ) -> tuple[dict[str, Any], dict[str, Any]]:
1687
+ placeholders = {name for _, name, _, _ in Formatter().parse(path) if name}
1688
+ path_params = {k: v for k, v in params.items() if k in placeholders}
1689
+ query_params = {k: v for k, v in params.items() if k not in placeholders and v is not None}
1690
+ if placeholders - path_params.keys():
1691
+ raise ValueError(f"Missing path params: {', '.join(placeholders - path_params.keys())}")
1692
+ return path_params, query_params
1693
+
1694
+ @overload
1695
+ async def GET(
1696
+ self,
1697
+ path: Literal["/test_error/{status_code}"],
1698
+ *,
1699
+ params: GetTestErrorByStatusCodeParams,
1700
+ parse_as: Literal["json"] = "json",
1701
+ headers: HeaderTypes | None = None,
1702
+ cookies: CookieTypes | None = None,
1703
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1704
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1705
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1706
+ extensions: RequestExtensions | None = None,
1707
+ ) -> Any:
1708
+ pass
1709
+
1710
+ @overload
1711
+ async def GET(
1712
+ self,
1713
+ path: Literal["/check/alive"],
1714
+ *,
1715
+ params: None = None,
1716
+ parse_as: Literal["json"] = "json",
1717
+ headers: HeaderTypes | None = None,
1718
+ cookies: CookieTypes | None = None,
1719
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1720
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1721
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1722
+ extensions: RequestExtensions | None = None,
1723
+ ) -> AliveResponse:
1724
+ pass
1725
+
1726
+ @overload
1727
+ async def GET(
1728
+ self,
1729
+ path: Literal["/check/ready"],
1730
+ *,
1731
+ params: None = None,
1732
+ parse_as: Literal["json"] = "json",
1733
+ headers: HeaderTypes | None = None,
1734
+ cookies: CookieTypes | None = None,
1735
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1736
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1737
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1738
+ extensions: RequestExtensions | None = None,
1739
+ ) -> ReadyResponse:
1740
+ pass
1741
+
1742
+ @overload
1743
+ async def GET(
1744
+ self,
1745
+ path: Literal["/gpu/check/healthy"],
1746
+ *,
1747
+ params: None = None,
1748
+ parse_as: Literal["json"] = "json",
1749
+ headers: HeaderTypes | None = None,
1750
+ cookies: CookieTypes | None = None,
1751
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1752
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1753
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1754
+ extensions: RequestExtensions | None = None,
1755
+ ) -> HealthyResponse:
1756
+ pass
1757
+
1758
+ @overload
1759
+ async def GET(
1760
+ self,
1761
+ path: Literal["/check/healthy"],
1762
+ *,
1763
+ params: None = None,
1764
+ parse_as: Literal["json"] = "json",
1765
+ headers: HeaderTypes | None = None,
1766
+ cookies: CookieTypes | None = None,
1767
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1768
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1769
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1770
+ extensions: RequestExtensions | None = None,
1771
+ ) -> HealthyResponse:
1772
+ pass
1773
+
1774
+ @overload
1775
+ async def GET(
1776
+ self,
1777
+ path: Literal["/gpu/config"],
1778
+ *,
1779
+ params: None = None,
1780
+ parse_as: Literal["json"] = "json",
1781
+ headers: HeaderTypes | None = None,
1782
+ cookies: CookieTypes | None = None,
1783
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1784
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1785
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1786
+ extensions: RequestExtensions | None = None,
1787
+ ) -> dict[str, str | float | int | bool | None]:
1788
+ pass
1789
+
1790
+ @overload
1791
+ async def GET(
1792
+ self,
1793
+ path: Literal["/config"],
1794
+ *,
1795
+ params: None = None,
1796
+ parse_as: Literal["json"] = "json",
1797
+ headers: HeaderTypes | None = None,
1798
+ cookies: CookieTypes | None = None,
1799
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1800
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1801
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1802
+ extensions: RequestExtensions | None = None,
1803
+ ) -> dict[str, str | float | int | bool | None]:
1804
+ pass
1805
+
1806
+ @overload
1807
+ async def GET(
1808
+ self,
1809
+ path: Literal["/auth/root"],
1810
+ *,
1811
+ params: None = None,
1812
+ parse_as: Literal["json"] = "json",
1813
+ headers: HeaderTypes | None = None,
1814
+ cookies: CookieTypes | None = None,
1815
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1816
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1817
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1818
+ extensions: RequestExtensions | None = None,
1819
+ ) -> bool:
1820
+ """Return true only when called with a valid root API key; otherwise 401 Unauthenticated."""
1821
+ pass
1822
+
1823
+ @overload
1824
+ async def GET(
1825
+ self,
1826
+ path: Literal["/auth/api_key"],
1827
+ *,
1828
+ params: None = None,
1829
+ parse_as: Literal["json"] = "json",
1830
+ headers: HeaderTypes | None = None,
1831
+ cookies: CookieTypes | None = None,
1832
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1833
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1834
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1835
+ extensions: RequestExtensions | None = None,
1836
+ ) -> list[ApiKeyMetadata]:
1837
+ """List all API keys for the organization."""
1838
+ pass
1839
+
1840
+ @overload
1841
+ async def GET(
1842
+ self,
1843
+ path: Literal["/auth"],
1844
+ *,
1845
+ params: None = None,
1846
+ parse_as: Literal["json"] = "json",
1847
+ headers: HeaderTypes | None = None,
1848
+ cookies: CookieTypes | None = None,
1849
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1850
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1851
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1852
+ extensions: RequestExtensions | None = None,
1853
+ ) -> bool:
1854
+ """Returns true if the api key header is valid for the org (will be false for admin api key)"""
1855
+ pass
1856
+
1857
+ @overload
1858
+ async def GET(
1859
+ self,
1860
+ path: Literal["/auth/org/plan"],
1861
+ *,
1862
+ params: None = None,
1863
+ parse_as: Literal["json"] = "json",
1864
+ headers: HeaderTypes | None = None,
1865
+ cookies: CookieTypes | None = None,
1866
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1867
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1868
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1869
+ extensions: RequestExtensions | None = None,
1870
+ ) -> OrgPlan:
1871
+ """Get the organization plan."""
1872
+ pass
1873
+
1874
+ @overload
1875
+ async def GET(
1876
+ self,
1877
+ path: Literal["/memoryset"],
1878
+ *,
1879
+ params: GetMemorysetParams,
1880
+ parse_as: Literal["json"] = "json",
1881
+ headers: HeaderTypes | None = None,
1882
+ cookies: CookieTypes | None = None,
1883
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1884
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1885
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1886
+ extensions: RequestExtensions | None = None,
1887
+ ) -> list[MemorysetMetadata]:
1888
+ pass
1889
+
1890
+ @overload
1891
+ async def GET(
1892
+ self,
1893
+ path: Literal["/memoryset/{name_or_id}"],
1894
+ *,
1895
+ params: GetMemorysetByNameOrIdParams,
1896
+ parse_as: Literal["json"] = "json",
1897
+ headers: HeaderTypes | None = None,
1898
+ cookies: CookieTypes | None = None,
1899
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1900
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1901
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1902
+ extensions: RequestExtensions | None = None,
1903
+ ) -> MemorysetMetadata:
1904
+ pass
1905
+
1906
+ @overload
1907
+ async def GET(
1908
+ self,
1909
+ path: Literal["/memoryset/{name_or_id}/memory/{memory_id}"],
1910
+ *,
1911
+ params: GetMemorysetByNameOrIdMemoryByMemoryIdParams,
1912
+ parse_as: Literal["json"] = "json",
1913
+ headers: HeaderTypes | None = None,
1914
+ cookies: CookieTypes | None = None,
1915
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1916
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1917
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1918
+ extensions: RequestExtensions | None = None,
1919
+ ) -> LabeledMemory | ScoredMemory:
1920
+ pass
1921
+
1922
+ @overload
1923
+ async def GET(
1924
+ self,
1925
+ path: Literal["/memoryset/{name_or_id}/potential_duplicate_groups"],
1926
+ *,
1927
+ params: GetMemorysetByNameOrIdPotentialDuplicateGroupsParams,
1928
+ parse_as: Literal["json"] = "json",
1929
+ headers: HeaderTypes | None = None,
1930
+ cookies: CookieTypes | None = None,
1931
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1932
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1933
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1934
+ extensions: RequestExtensions | None = None,
1935
+ ) -> list[list[LabeledMemory]] | list[list[ScoredMemory]]:
1936
+ pass
1937
+
1938
+ @overload
1939
+ async def GET(
1940
+ self,
1941
+ path: Literal["/memoryset/{name_or_id}/analysis"],
1942
+ *,
1943
+ params: GetMemorysetByNameOrIdAnalysisParams,
1944
+ parse_as: Literal["json"] = "json",
1945
+ headers: HeaderTypes | None = None,
1946
+ cookies: CookieTypes | None = None,
1947
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1948
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1949
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1950
+ extensions: RequestExtensions | None = None,
1951
+ ) -> list[MemorysetAnalysisResponse]:
1952
+ pass
1953
+
1954
+ @overload
1955
+ async def GET(
1956
+ self,
1957
+ path: Literal["/memoryset/{name_or_id}/analysis/{analysis_job_id}"],
1958
+ *,
1959
+ params: GetMemorysetByNameOrIdAnalysisByAnalysisJobIdParams,
1960
+ parse_as: Literal["json"] = "json",
1961
+ headers: HeaderTypes | None = None,
1962
+ cookies: CookieTypes | None = None,
1963
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1964
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1965
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1966
+ extensions: RequestExtensions | None = None,
1967
+ ) -> MemorysetAnalysisResponse:
1968
+ pass
1969
+
1970
+ @overload
1971
+ async def GET(
1972
+ self,
1973
+ path: Literal["/finetuned_embedding_model"],
1974
+ *,
1975
+ params: None = None,
1976
+ parse_as: Literal["json"] = "json",
1977
+ headers: HeaderTypes | None = None,
1978
+ cookies: CookieTypes | None = None,
1979
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1980
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1981
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1982
+ extensions: RequestExtensions | None = None,
1983
+ ) -> list[FinetunedEmbeddingModelMetadata]:
1984
+ """List all finetuned embedding models for the organization."""
1985
+ pass
1986
+
1987
+ @overload
1988
+ async def GET(
1989
+ self,
1990
+ path: Literal["/finetuned_embedding_model/{name_or_id}"],
1991
+ *,
1992
+ params: GetFinetunedEmbeddingModelByNameOrIdParams,
1993
+ parse_as: Literal["json"] = "json",
1994
+ headers: HeaderTypes | None = None,
1995
+ cookies: CookieTypes | None = None,
1996
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1997
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
1998
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
1999
+ extensions: RequestExtensions | None = None,
2000
+ ) -> FinetunedEmbeddingModelMetadata:
2001
+ """Get a finetuned embedding model by name or ID."""
2002
+ pass
2003
+
2004
+ @overload
2005
+ async def GET(
2006
+ self,
2007
+ path: Literal["/pretrained_embedding_model"],
2008
+ *,
2009
+ params: None = None,
2010
+ parse_as: Literal["json"] = "json",
2011
+ headers: HeaderTypes | None = None,
2012
+ cookies: CookieTypes | None = None,
2013
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2014
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2015
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2016
+ extensions: RequestExtensions | None = None,
2017
+ ) -> list[PretrainedEmbeddingModelMetadata]:
2018
+ """List all available pretrained embedding models."""
2019
+ pass
2020
+
2021
+ @overload
2022
+ async def GET(
2023
+ self,
2024
+ path: Literal["/pretrained_embedding_model/{model_name}"],
2025
+ *,
2026
+ params: GetPretrainedEmbeddingModelByModelNameParams,
2027
+ parse_as: Literal["json"] = "json",
2028
+ headers: HeaderTypes | None = None,
2029
+ cookies: CookieTypes | None = None,
2030
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2031
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2032
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2033
+ extensions: RequestExtensions | None = None,
2034
+ ) -> PretrainedEmbeddingModelMetadata:
2035
+ """Get metadata for a specific pretrained embedding model."""
2036
+ pass
2037
+
2038
+ @overload
2039
+ async def GET(
2040
+ self,
2041
+ path: Literal["/finetuned_embedding_model/{name_or_id}/evaluation/{job_id}"],
2042
+ *,
2043
+ params: GetFinetunedEmbeddingModelByNameOrIdEvaluationByJobIdParams,
2044
+ parse_as: Literal["json"] = "json",
2045
+ headers: HeaderTypes | None = None,
2046
+ cookies: CookieTypes | None = None,
2047
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2048
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2049
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2050
+ extensions: RequestExtensions | None = None,
2051
+ ) -> EmbeddingEvaluationResponse:
2052
+ """Get evaluation results for a finetuned embedding model by job ID."""
2053
+ pass
2054
+
2055
+ @overload
2056
+ async def GET(
2057
+ self,
2058
+ path: Literal["/pretrained_embedding_model/{model_name}/evaluation/{job_id}"],
2059
+ *,
2060
+ params: GetPretrainedEmbeddingModelByModelNameEvaluationByJobIdParams,
2061
+ parse_as: Literal["json"] = "json",
2062
+ headers: HeaderTypes | None = None,
2063
+ cookies: CookieTypes | None = None,
2064
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2065
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2066
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2067
+ extensions: RequestExtensions | None = None,
2068
+ ) -> EmbeddingEvaluationResponse:
2069
+ """Get evaluation results for a pretrained embedding model by job ID."""
2070
+ pass
2071
+
2072
+ @overload
2073
+ async def GET(
2074
+ self,
2075
+ path: Literal["/finetuned_embedding_model/{name_or_id}/evaluations"],
2076
+ *,
2077
+ params: GetFinetunedEmbeddingModelByNameOrIdEvaluationsParams,
2078
+ parse_as: Literal["json"] = "json",
2079
+ headers: HeaderTypes | None = None,
2080
+ cookies: CookieTypes | None = None,
2081
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2082
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2083
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2084
+ extensions: RequestExtensions | None = None,
2085
+ ) -> list[EmbeddingEvaluationResponse]:
2086
+ """List all evaluation results for a finetuned embedding model."""
2087
+ pass
2088
+
2089
+ @overload
2090
+ async def GET(
2091
+ self,
2092
+ path: Literal["/pretrained_embedding_model/{model_name}/evaluations"],
2093
+ *,
2094
+ params: GetPretrainedEmbeddingModelByModelNameEvaluationsParams,
2095
+ parse_as: Literal["json"] = "json",
2096
+ headers: HeaderTypes | None = None,
2097
+ cookies: CookieTypes | None = None,
2098
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2099
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2100
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2101
+ extensions: RequestExtensions | None = None,
2102
+ ) -> list[EmbeddingEvaluationResponse]:
2103
+ """List all evaluation results for a pretrained embedding model."""
2104
+ pass
2105
+
2106
+ @overload
2107
+ async def GET(
2108
+ self,
2109
+ path: Literal["/datasource"],
2110
+ *,
2111
+ params: None = None,
2112
+ parse_as: Literal["json"] = "json",
2113
+ headers: HeaderTypes | None = None,
2114
+ cookies: CookieTypes | None = None,
2115
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2116
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2117
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2118
+ extensions: RequestExtensions | None = None,
2119
+ ) -> list[DatasourceMetadata]:
2120
+ """List all datasources for the organization."""
2121
+ pass
2122
+
2123
+ @overload
2124
+ async def GET(
2125
+ self,
2126
+ path: Literal["/datasource/{name_or_id}"],
2127
+ *,
2128
+ params: GetDatasourceByNameOrIdParams,
2129
+ parse_as: Literal["json"] = "json",
2130
+ headers: HeaderTypes | None = None,
2131
+ cookies: CookieTypes | None = None,
2132
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2133
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2134
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2135
+ extensions: RequestExtensions | None = None,
2136
+ ) -> DatasourceMetadata:
2137
+ """Get a datasource by name or ID."""
2138
+ pass
2139
+
2140
+ @overload
2141
+ async def GET(
2142
+ self,
2143
+ path: Literal["/datasource/{name_or_id}/embedding_model_evaluations"],
2144
+ *,
2145
+ params: GetDatasourceByNameOrIdEmbeddingModelEvaluationsParams,
2146
+ parse_as: Literal["json"] = "json",
2147
+ headers: HeaderTypes | None = None,
2148
+ cookies: CookieTypes | None = None,
2149
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2150
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2151
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2152
+ extensions: RequestExtensions | None = None,
2153
+ ) -> list[EmbeddingEvaluationResponse]:
2154
+ """List all evaluation results for a datasource."""
2155
+ pass
2156
+
2157
+ @overload
2158
+ async def GET(
2159
+ self,
2160
+ path: Literal["/datasource/{name_or_id}/download"],
2161
+ *,
2162
+ params: GetDatasourceByNameOrIdDownloadParams,
2163
+ parse_as: Literal["json"] = "json",
2164
+ headers: HeaderTypes | None = None,
2165
+ cookies: CookieTypes | None = None,
2166
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2167
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2168
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2169
+ extensions: RequestExtensions | None = None,
2170
+ ) -> list[dict[str, Any]]:
2171
+ """Download datasource in the specified format."""
2172
+ pass
2173
+
2174
+ @overload
2175
+ async def GET(
2176
+ self,
2177
+ path: Literal["/datasource/{name_or_id}/download"],
2178
+ *,
2179
+ params: GetDatasourceByNameOrIdDownloadParams,
2180
+ parse_as: Literal["text"],
2181
+ headers: HeaderTypes | None = None,
2182
+ cookies: CookieTypes | None = None,
2183
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2184
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2185
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2186
+ extensions: RequestExtensions | None = None,
2187
+ ) -> str:
2188
+ """Download datasource in the specified format."""
2189
+ pass
2190
+
2191
+ @overload
2192
+ async def GET(
2193
+ self,
2194
+ path: Literal["/datasource/{name_or_id}/download"],
2195
+ *,
2196
+ params: GetDatasourceByNameOrIdDownloadParams,
2197
+ parse_as: None,
2198
+ headers: HeaderTypes | None = None,
2199
+ cookies: CookieTypes | None = None,
2200
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2201
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2202
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2203
+ extensions: RequestExtensions | None = None,
2204
+ ) -> bytes:
2205
+ """Download datasource in the specified format."""
2206
+ pass
2207
+
2208
+ @overload
2209
+ async def GET(
2210
+ self,
2211
+ path: Literal["/classification_model"],
2212
+ *,
2213
+ params: None = None,
2214
+ parse_as: Literal["json"] = "json",
2215
+ headers: HeaderTypes | None = None,
2216
+ cookies: CookieTypes | None = None,
2217
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2218
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2219
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2220
+ extensions: RequestExtensions | None = None,
2221
+ ) -> list[ClassificationModelMetadata]:
2222
+ pass
2223
+
2224
+ @overload
2225
+ async def GET(
2226
+ self,
2227
+ path: Literal["/regression_model"],
2228
+ *,
2229
+ params: None = None,
2230
+ parse_as: Literal["json"] = "json",
2231
+ headers: HeaderTypes | None = None,
2232
+ cookies: CookieTypes | None = None,
2233
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2234
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2235
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2236
+ extensions: RequestExtensions | None = None,
2237
+ ) -> list[RegressionModelMetadata]:
2238
+ pass
2239
+
2240
+ @overload
2241
+ async def GET(
2242
+ self,
2243
+ path: Literal["/classification_model/{name_or_id}"],
2244
+ *,
2245
+ params: GetClassificationModelByNameOrIdParams,
2246
+ parse_as: Literal["json"] = "json",
2247
+ headers: HeaderTypes | None = None,
2248
+ cookies: CookieTypes | None = None,
2249
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2250
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2251
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2252
+ extensions: RequestExtensions | None = None,
2253
+ ) -> ClassificationModelMetadata:
2254
+ pass
2255
+
2256
+ @overload
2257
+ async def GET(
2258
+ self,
2259
+ path: Literal["/regression_model/{name_or_id}"],
2260
+ *,
2261
+ params: GetRegressionModelByNameOrIdParams,
2262
+ parse_as: Literal["json"] = "json",
2263
+ headers: HeaderTypes | None = None,
2264
+ cookies: CookieTypes | None = None,
2265
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2266
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2267
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2268
+ extensions: RequestExtensions | None = None,
2269
+ ) -> RegressionModelMetadata:
2270
+ pass
2271
+
2272
+ @overload
2273
+ async def GET(
2274
+ self,
2275
+ path: Literal["/predictive_model"],
2276
+ *,
2277
+ params: None = None,
2278
+ parse_as: Literal["json"] = "json",
2279
+ headers: HeaderTypes | None = None,
2280
+ cookies: CookieTypes | None = None,
2281
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2282
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2283
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2284
+ extensions: RequestExtensions | None = None,
2285
+ ) -> list[ClassificationModelMetadata | RegressionModelMetadata]:
2286
+ pass
2287
+
2288
+ @overload
2289
+ async def GET(
2290
+ self,
2291
+ path: Literal["/classification_model/{model_name_or_id}/evaluation"],
2292
+ *,
2293
+ params: GetClassificationModelByModelNameOrIdEvaluationParams,
2294
+ parse_as: Literal["json"] = "json",
2295
+ headers: HeaderTypes | None = None,
2296
+ cookies: CookieTypes | None = None,
2297
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2298
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2299
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2300
+ extensions: RequestExtensions | None = None,
2301
+ ) -> list[EvaluationResponseClassificationMetrics]:
2302
+ pass
2303
+
2304
+ @overload
2305
+ async def GET(
2306
+ self,
2307
+ path: Literal["/regression_model/{model_name_or_id}/evaluation"],
2308
+ *,
2309
+ params: GetRegressionModelByModelNameOrIdEvaluationParams,
2310
+ parse_as: Literal["json"] = "json",
2311
+ headers: HeaderTypes | None = None,
2312
+ cookies: CookieTypes | None = None,
2313
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2314
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2315
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2316
+ extensions: RequestExtensions | None = None,
2317
+ ) -> list[EvaluationResponseRegressionMetrics]:
2318
+ pass
2319
+
2320
+ @overload
2321
+ async def GET(
2322
+ self,
2323
+ path: Literal["/classification_model/{model_name_or_id}/evaluation/{job_id}"],
2324
+ *,
2325
+ params: GetClassificationModelByModelNameOrIdEvaluationByJobIdParams,
2326
+ parse_as: Literal["json"] = "json",
2327
+ headers: HeaderTypes | None = None,
2328
+ cookies: CookieTypes | None = None,
2329
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2330
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2331
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2332
+ extensions: RequestExtensions | None = None,
2333
+ ) -> EvaluationResponseClassificationMetrics:
2334
+ pass
2335
+
2336
+ @overload
2337
+ async def GET(
2338
+ self,
2339
+ path: Literal["/regression_model/{model_name_or_id}/evaluation/{job_id}"],
2340
+ *,
2341
+ params: GetRegressionModelByModelNameOrIdEvaluationByJobIdParams,
2342
+ parse_as: Literal["json"] = "json",
2343
+ headers: HeaderTypes | None = None,
2344
+ cookies: CookieTypes | None = None,
2345
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2346
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2347
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2348
+ extensions: RequestExtensions | None = None,
2349
+ ) -> EvaluationResponseRegressionMetrics:
2350
+ pass
2351
+
2352
+ @overload
2353
+ async def GET(
2354
+ self,
2355
+ path: Literal["/job/{job_id}"],
2356
+ *,
2357
+ params: GetJobByJobIdParams,
2358
+ parse_as: Literal["json"] = "json",
2359
+ headers: HeaderTypes | None = None,
2360
+ cookies: CookieTypes | None = None,
2361
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2362
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2363
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2364
+ extensions: RequestExtensions | None = None,
2365
+ ) -> Job:
2366
+ pass
2367
+
2368
+ @overload
2369
+ async def GET(
2370
+ self,
2371
+ path: Literal["/job/{job_id}/status"],
2372
+ *,
2373
+ params: GetJobByJobIdStatusParams,
2374
+ parse_as: Literal["json"] = "json",
2375
+ headers: HeaderTypes | None = None,
2376
+ cookies: CookieTypes | None = None,
2377
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2378
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2379
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2380
+ extensions: RequestExtensions | None = None,
2381
+ ) -> JobStatusInfo:
2382
+ pass
2383
+
2384
+ @overload
2385
+ async def GET(
2386
+ self,
2387
+ path: Literal["/job"],
2388
+ *,
2389
+ params: GetJobParams,
2390
+ parse_as: Literal["json"] = "json",
2391
+ headers: HeaderTypes | None = None,
2392
+ cookies: CookieTypes | None = None,
2393
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2394
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2395
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2396
+ extensions: RequestExtensions | None = None,
2397
+ ) -> PaginatedJob:
2398
+ pass
2399
+
2400
+ @overload
2401
+ async def GET(
2402
+ self,
2403
+ path: Literal["/worker"],
2404
+ *,
2405
+ params: GetWorkerParams,
2406
+ parse_as: Literal["json"] = "json",
2407
+ headers: HeaderTypes | None = None,
2408
+ cookies: CookieTypes | None = None,
2409
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2410
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2411
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2412
+ extensions: RequestExtensions | None = None,
2413
+ ) -> PaginatedWorkerInfo:
2414
+ """
2415
+ List all workers in the system. Requires root access.
2416
+
2417
+ This endpoint automatically cleans up orphaned workers before returning results.
2418
+ """
2419
+ pass
2420
+
2421
+ @overload
2422
+ async def GET(
2423
+ self,
2424
+ path: Literal["/worker/{worker_id}"],
2425
+ *,
2426
+ params: GetWorkerByWorkerIdParams,
2427
+ parse_as: Literal["json"] = "json",
2428
+ headers: HeaderTypes | None = None,
2429
+ cookies: CookieTypes | None = None,
2430
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2431
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2432
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2433
+ extensions: RequestExtensions | None = None,
2434
+ ) -> WorkerInfo:
2435
+ """Get information about a specific worker. Requires root access."""
2436
+ pass
2437
+
2438
+ @overload
2439
+ async def GET(
2440
+ self,
2441
+ path: Literal["/telemetry/prediction/{prediction_id}"],
2442
+ *,
2443
+ params: GetTelemetryPredictionByPredictionIdParams,
2444
+ parse_as: Literal["json"] = "json",
2445
+ headers: HeaderTypes | None = None,
2446
+ cookies: CookieTypes | None = None,
2447
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2448
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2449
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2450
+ extensions: RequestExtensions | None = None,
2451
+ ) -> LabelPredictionWithMemoriesAndFeedback | ScorePredictionWithMemoriesAndFeedback:
2452
+ """Get a specific prediction by ID."""
2453
+ pass
2454
+
2455
+ @overload
2456
+ async def GET(
2457
+ self,
2458
+ path: Literal["/telemetry/prediction/{prediction_id}/explanation"],
2459
+ *,
2460
+ params: GetTelemetryPredictionByPredictionIdExplanationParams,
2461
+ parse_as: Literal["text"],
2462
+ headers: HeaderTypes | None = None,
2463
+ cookies: CookieTypes | None = None,
2464
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2465
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2466
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2467
+ extensions: RequestExtensions | None = None,
2468
+ ) -> str:
2469
+ """Get explanation for a prediction, optionally streaming the response."""
2470
+ pass
2471
+
2472
+ @overload
2473
+ async def GET(
2474
+ self,
2475
+ path: Literal["/telemetry/prediction/{prediction_id}/action"],
2476
+ *,
2477
+ params: GetTelemetryPredictionByPredictionIdActionParams,
2478
+ parse_as: Literal["json"] = "json",
2479
+ headers: HeaderTypes | None = None,
2480
+ cookies: CookieTypes | None = None,
2481
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2482
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2483
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2484
+ extensions: RequestExtensions | None = None,
2485
+ ) -> ActionRecommendation:
2486
+ """Get action recommendation for improving a specific prediction."""
2487
+ pass
2488
+
2489
+ @overload
2490
+ async def GET(
2491
+ self,
2492
+ path: Literal["/telemetry/prediction/{prediction_id}/memory_suggestions"],
2493
+ *,
2494
+ params: GetTelemetryPredictionByPredictionIdMemorySuggestionsParams,
2495
+ parse_as: Literal["json"] = "json",
2496
+ headers: HeaderTypes | None = None,
2497
+ cookies: CookieTypes | None = None,
2498
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2499
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2500
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2501
+ extensions: RequestExtensions | None = None,
2502
+ ) -> AddMemoryRecommendations:
2503
+ """
2504
+ Generate synthetic memory suggestions to improve a specific prediction.
2505
+
2506
+ The returned suggestions have labels as string representations of integer indices
2507
+ corresponding to the memoryset's label_names.
2508
+ """
2509
+ pass
2510
+
2511
+ @overload
2512
+ async def GET(
2513
+ self,
2514
+ path: Literal["/telemetry/feedback_category"],
2515
+ *,
2516
+ params: None = None,
2517
+ parse_as: Literal["json"] = "json",
2518
+ headers: HeaderTypes | None = None,
2519
+ cookies: CookieTypes | None = None,
2520
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2521
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2522
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2523
+ extensions: RequestExtensions | None = None,
2524
+ ) -> list[PredictionFeedbackCategory]:
2525
+ """List all feedback categories for the organization."""
2526
+ pass
2527
+
2528
+ @overload
2529
+ async def GET(
2530
+ self,
2531
+ path: Literal["/telemetry/feedback_category/{name_or_id}"],
2532
+ *,
2533
+ params: GetTelemetryFeedbackCategoryByNameOrIdParams,
2534
+ parse_as: Literal["json"] = "json",
2535
+ headers: HeaderTypes | None = None,
2536
+ cookies: CookieTypes | None = None,
2537
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2538
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2539
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2540
+ extensions: RequestExtensions | None = None,
2541
+ ) -> PredictionFeedbackCategory:
2542
+ """Get a feedback category by name or ID."""
2543
+ pass
2544
+
2545
+ @overload
2546
+ async def GET(
2547
+ self,
2548
+ path: Literal["/agents/bootstrap_classification_model/{job_id}"],
2549
+ *,
2550
+ params: GetAgentsBootstrapClassificationModelByJobIdParams,
2551
+ parse_as: Literal["json"] = "json",
2552
+ headers: HeaderTypes | None = None,
2553
+ cookies: CookieTypes | None = None,
2554
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2555
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2556
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2557
+ extensions: RequestExtensions | None = None,
2558
+ ) -> BootstrapClassificationModelResponse:
2559
+ """Get the status of a bootstrap classification model job"""
2560
+ pass
2561
+
2562
+ async def GET(
2563
+ self,
2564
+ path: str,
2565
+ *,
2566
+ params: Mapping[str, Any] | None = None,
2567
+ parse_as: Literal["json", "text"] | None = "json",
2568
+ headers: HeaderTypes | None = None,
2569
+ cookies: CookieTypes | None = None,
2570
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2571
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2572
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2573
+ extensions: RequestExtensions | None = None,
2574
+ ) -> Any:
2575
+ path_params, query_params = self._parse_params(params or {}, path)
2576
+ res = await self.get(
2577
+ path.format(**path_params),
2578
+ params=query_params,
2579
+ headers=headers,
2580
+ cookies=cookies,
2581
+ auth=auth,
2582
+ follow_redirects=follow_redirects,
2583
+ timeout=timeout,
2584
+ extensions=extensions,
2585
+ )
2586
+ res.raise_for_status()
2587
+ return (
2588
+ None
2589
+ if res.status_code == 204
2590
+ else res.json() if parse_as == "json" else res.text if parse_as == "text" else res.content
2591
+ )
2592
+
2593
+ @overload
2594
+ async def DELETE(
2595
+ self,
2596
+ path: Literal["/cleanup"],
2597
+ *,
2598
+ params: None = None,
2599
+ parse_as: Literal["json"] = "json",
2600
+ headers: HeaderTypes | None = None,
2601
+ cookies: CookieTypes | None = None,
2602
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2603
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2604
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2605
+ extensions: RequestExtensions | None = None,
2606
+ ) -> CleanupResponse:
2607
+ """Cleanup orphaned milvus collections and blobs"""
2608
+ pass
2609
+
2610
+ @overload
2611
+ async def DELETE(
2612
+ self,
2613
+ path: Literal["/auth/api_key/{name_or_id}"],
2614
+ *,
2615
+ params: DeleteAuthApiKeyByNameOrIdParams,
2616
+ parse_as: Literal["json"] = "json",
2617
+ headers: HeaderTypes | None = None,
2618
+ cookies: CookieTypes | None = None,
2619
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2620
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2621
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2622
+ extensions: RequestExtensions | None = None,
2623
+ ) -> None:
2624
+ """Delete an API key by name or ID."""
2625
+ pass
2626
+
2627
+ @overload
2628
+ async def DELETE(
2629
+ self,
2630
+ path: Literal["/auth/org"],
2631
+ *,
2632
+ params: None = None,
2633
+ parse_as: Literal["json"] = "json",
2634
+ headers: HeaderTypes | None = None,
2635
+ cookies: CookieTypes | None = None,
2636
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2637
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2638
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2639
+ extensions: RequestExtensions | None = None,
2640
+ ) -> None:
2641
+ """Deletes the org and all associated resources"""
2642
+ pass
2643
+
2644
+ @overload
2645
+ async def DELETE(
2646
+ self,
2647
+ path: Literal["/memoryset/{name_or_id}"],
2648
+ *,
2649
+ params: DeleteMemorysetByNameOrIdParams,
2650
+ parse_as: Literal["json"] = "json",
2651
+ headers: HeaderTypes | None = None,
2652
+ cookies: CookieTypes | None = None,
2653
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2654
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2655
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2656
+ extensions: RequestExtensions | None = None,
2657
+ ) -> None:
2658
+ pass
2659
+
2660
+ @overload
2661
+ async def DELETE(
2662
+ self,
2663
+ path: Literal["/memoryset/{name_or_id}/memory/{memory_id}"],
2664
+ *,
2665
+ params: DeleteMemorysetByNameOrIdMemoryByMemoryIdParams,
2666
+ parse_as: Literal["json"] = "json",
2667
+ headers: HeaderTypes | None = None,
2668
+ cookies: CookieTypes | None = None,
2669
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2670
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2671
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2672
+ extensions: RequestExtensions | None = None,
2673
+ ) -> None:
2674
+ pass
2675
+
2676
+ @overload
2677
+ async def DELETE(
2678
+ self,
2679
+ path: Literal["/finetuned_embedding_model/{name_or_id}"],
2680
+ *,
2681
+ params: DeleteFinetunedEmbeddingModelByNameOrIdParams,
2682
+ parse_as: Literal["json"] = "json",
2683
+ headers: HeaderTypes | None = None,
2684
+ cookies: CookieTypes | None = None,
2685
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2686
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2687
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2688
+ extensions: RequestExtensions | None = None,
2689
+ ) -> None:
2690
+ """Delete a finetuned embedding model by name or ID."""
2691
+ pass
2692
+
2693
+ @overload
2694
+ async def DELETE(
2695
+ self,
2696
+ path: Literal["/datasource/{name_or_id}"],
2697
+ *,
2698
+ params: DeleteDatasourceByNameOrIdParams,
2699
+ parse_as: Literal["json"] = "json",
2700
+ headers: HeaderTypes | None = None,
2701
+ cookies: CookieTypes | None = None,
2702
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2703
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2704
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2705
+ extensions: RequestExtensions | None = None,
2706
+ ) -> None:
2707
+ """Delete a datasource by name or ID."""
2708
+ pass
2709
+
2710
+ @overload
2711
+ async def DELETE(
2712
+ self,
2713
+ path: Literal["/classification_model/{name_or_id}"],
2714
+ *,
2715
+ params: DeleteClassificationModelByNameOrIdParams,
2716
+ parse_as: Literal["json"] = "json",
2717
+ headers: HeaderTypes | None = None,
2718
+ cookies: CookieTypes | None = None,
2719
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2720
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2721
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2722
+ extensions: RequestExtensions | None = None,
2723
+ ) -> None:
2724
+ pass
2725
+
2726
+ @overload
2727
+ async def DELETE(
2728
+ self,
2729
+ path: Literal["/regression_model/{name_or_id}"],
2730
+ *,
2731
+ params: DeleteRegressionModelByNameOrIdParams,
2732
+ parse_as: Literal["json"] = "json",
2733
+ headers: HeaderTypes | None = None,
2734
+ cookies: CookieTypes | None = None,
2735
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2736
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2737
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2738
+ extensions: RequestExtensions | None = None,
2739
+ ) -> None:
2740
+ pass
2741
+
2742
+ @overload
2743
+ async def DELETE(
2744
+ self,
2745
+ path: Literal["/classification_model/{model_name_or_id}/evaluation/{job_id}"],
2746
+ *,
2747
+ params: DeleteClassificationModelByModelNameOrIdEvaluationByJobIdParams,
2748
+ parse_as: Literal["json"] = "json",
2749
+ headers: HeaderTypes | None = None,
2750
+ cookies: CookieTypes | None = None,
2751
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2752
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2753
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2754
+ extensions: RequestExtensions | None = None,
2755
+ ) -> None:
2756
+ pass
2757
+
2758
+ @overload
2759
+ async def DELETE(
2760
+ self,
2761
+ path: Literal["/regression_model/{model_name_or_id}/evaluation/{job_id}"],
2762
+ *,
2763
+ params: DeleteRegressionModelByModelNameOrIdEvaluationByJobIdParams,
2764
+ parse_as: Literal["json"] = "json",
2765
+ headers: HeaderTypes | None = None,
2766
+ cookies: CookieTypes | None = None,
2767
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2768
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2769
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2770
+ extensions: RequestExtensions | None = None,
2771
+ ) -> None:
2772
+ pass
2773
+
2774
+ @overload
2775
+ async def DELETE(
2776
+ self,
2777
+ path: Literal["/job/{job_id}/abort"],
2778
+ *,
2779
+ params: DeleteJobByJobIdAbortParams,
2780
+ parse_as: Literal["json"] = "json",
2781
+ headers: HeaderTypes | None = None,
2782
+ cookies: CookieTypes | None = None,
2783
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2784
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2785
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2786
+ extensions: RequestExtensions | None = None,
2787
+ ) -> None:
2788
+ pass
2789
+
2790
+ @overload
2791
+ async def DELETE(
2792
+ self,
2793
+ path: Literal["/telemetry/feedback_category/{name_or_id}"],
2794
+ *,
2795
+ params: DeleteTelemetryFeedbackCategoryByNameOrIdParams,
2796
+ parse_as: Literal["json"] = "json",
2797
+ headers: HeaderTypes | None = None,
2798
+ cookies: CookieTypes | None = None,
2799
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2800
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2801
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2802
+ extensions: RequestExtensions | None = None,
2803
+ ) -> None:
2804
+ """Delete a feedback category and all associated feedback records."""
2805
+ pass
2806
+
2807
+ async def DELETE(
2808
+ self,
2809
+ path: str,
2810
+ *,
2811
+ params: Mapping[str, Any] | None = None,
2812
+ parse_as: Literal["json", "text"] | None = "json",
2813
+ headers: HeaderTypes | None = None,
2814
+ cookies: CookieTypes | None = None,
2815
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2816
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2817
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2818
+ extensions: RequestExtensions | None = None,
2819
+ ) -> Any:
2820
+ path_params, query_params = self._parse_params(params or {}, path)
2821
+ res = await self.delete(
2822
+ path.format(**path_params),
2823
+ params=query_params,
2824
+ headers=headers,
2825
+ cookies=cookies,
2826
+ auth=auth,
2827
+ follow_redirects=follow_redirects,
2828
+ timeout=timeout,
2829
+ extensions=extensions,
2830
+ )
2831
+ res.raise_for_status()
2832
+ return (
2833
+ None
2834
+ if res.status_code == 204
2835
+ else res.json() if parse_as == "json" else res.text if parse_as == "text" else res.content
2836
+ )
2837
+
2838
+ @overload
2839
+ async def POST(
2840
+ self,
2841
+ path: Literal["/auth/api_key"],
2842
+ *,
2843
+ params: None = None,
2844
+ json: CreateApiKeyRequest,
2845
+ data: None = None,
2846
+ files: None = None,
2847
+ content: None = None,
2848
+ parse_as: Literal["json"] = "json",
2849
+ headers: HeaderTypes | None = None,
2850
+ cookies: CookieTypes | None = None,
2851
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2852
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2853
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2854
+ extensions: RequestExtensions | None = None,
2855
+ ) -> CreateApiKeyResponse:
2856
+ """Create a new API key for the organization."""
2857
+ pass
2858
+
2859
+ @overload
2860
+ async def POST(
2861
+ self,
2862
+ path: Literal["/auth/org/plan"],
2863
+ *,
2864
+ params: None = None,
2865
+ json: CreateOrgPlanRequest,
2866
+ data: None = None,
2867
+ files: None = None,
2868
+ content: None = None,
2869
+ parse_as: Literal["json"] = "json",
2870
+ headers: HeaderTypes | None = None,
2871
+ cookies: CookieTypes | None = None,
2872
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2873
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2874
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2875
+ extensions: RequestExtensions | None = None,
2876
+ ) -> OrgPlan:
2877
+ """Create an organization plan."""
2878
+ pass
2879
+
2880
+ @overload
2881
+ async def POST(
2882
+ self,
2883
+ path: Literal["/memoryset"],
2884
+ *,
2885
+ params: None = None,
2886
+ json: CreateMemorysetRequest,
2887
+ data: None = None,
2888
+ files: None = None,
2889
+ content: None = None,
2890
+ parse_as: Literal["json"] = "json",
2891
+ headers: HeaderTypes | None = None,
2892
+ cookies: CookieTypes | None = None,
2893
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2894
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2895
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2896
+ extensions: RequestExtensions | None = None,
2897
+ ) -> MemorysetMetadata:
2898
+ pass
2899
+
2900
+ @overload
2901
+ async def POST(
2902
+ self,
2903
+ path: Literal["/memoryset/{name_or_id}/clone"],
2904
+ *,
2905
+ params: PostMemorysetByNameOrIdCloneParams,
2906
+ json: CloneMemorysetRequest,
2907
+ data: None = None,
2908
+ files: None = None,
2909
+ content: None = None,
2910
+ parse_as: Literal["json"] = "json",
2911
+ headers: HeaderTypes | None = None,
2912
+ cookies: CookieTypes | None = None,
2913
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2914
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2915
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2916
+ extensions: RequestExtensions | None = None,
2917
+ ) -> MemorysetMetadata:
2918
+ pass
2919
+
2920
+ @overload
2921
+ async def POST(
2922
+ self,
2923
+ path: Literal["/batch_delete_memoryset"],
2924
+ *,
2925
+ params: None = None,
2926
+ json: DeleteMemorysetsRequest,
2927
+ data: None = None,
2928
+ files: None = None,
2929
+ content: None = None,
2930
+ parse_as: Literal["json"] = "json",
2931
+ headers: HeaderTypes | None = None,
2932
+ cookies: CookieTypes | None = None,
2933
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2934
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2935
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2936
+ extensions: RequestExtensions | None = None,
2937
+ ) -> None:
2938
+ pass
2939
+
2940
+ @overload
2941
+ async def POST(
2942
+ self,
2943
+ path: Literal["/gpu/memoryset/{name_or_id}/lookup"],
2944
+ *,
2945
+ params: PostGpuMemorysetByNameOrIdLookupParams,
2946
+ json: LookupRequest,
2947
+ data: None = None,
2948
+ files: None = None,
2949
+ content: None = None,
2950
+ parse_as: Literal["json"] = "json",
2951
+ headers: HeaderTypes | None = None,
2952
+ cookies: CookieTypes | None = None,
2953
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2954
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2955
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2956
+ extensions: RequestExtensions | None = None,
2957
+ ) -> list[list[LabeledMemoryLookup | ScoredMemoryLookup]]:
2958
+ pass
2959
+
2960
+ @overload
2961
+ async def POST(
2962
+ self,
2963
+ path: Literal["/memoryset/{name_or_id}/memories/get"],
2964
+ *,
2965
+ params: PostMemorysetByNameOrIdMemoriesGetParams,
2966
+ json: GetMemoriesRequest,
2967
+ data: None = None,
2968
+ files: None = None,
2969
+ content: None = None,
2970
+ parse_as: Literal["json"] = "json",
2971
+ headers: HeaderTypes | None = None,
2972
+ cookies: CookieTypes | None = None,
2973
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2974
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2975
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2976
+ extensions: RequestExtensions | None = None,
2977
+ ) -> list[LabeledMemory] | list[ScoredMemory]:
2978
+ pass
2979
+
2980
+ @overload
2981
+ async def POST(
2982
+ self,
2983
+ path: Literal["/memoryset/{name_or_id}/memories"],
2984
+ *,
2985
+ params: PostMemorysetByNameOrIdMemoriesParams,
2986
+ json: ListMemoriesRequest | None = None,
2987
+ data: None = None,
2988
+ files: None = None,
2989
+ content: None = None,
2990
+ parse_as: Literal["json"] = "json",
2991
+ headers: HeaderTypes | None = None,
2992
+ cookies: CookieTypes | None = None,
2993
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2994
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
2995
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
2996
+ extensions: RequestExtensions | None = None,
2997
+ ) -> list[LabeledMemory] | list[ScoredMemory]:
2998
+ pass
2999
+
3000
+ @overload
3001
+ async def POST(
3002
+ self,
3003
+ path: Literal["/memoryset/{name_or_id}/memories/delete"],
3004
+ *,
3005
+ params: PostMemorysetByNameOrIdMemoriesDeleteParams,
3006
+ json: DeleteMemoriesRequest,
3007
+ data: None = None,
3008
+ files: None = None,
3009
+ content: None = None,
3010
+ parse_as: Literal["json"] = "json",
3011
+ headers: HeaderTypes | None = None,
3012
+ cookies: CookieTypes | None = None,
3013
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3014
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3015
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3016
+ extensions: RequestExtensions | None = None,
3017
+ ) -> None:
3018
+ pass
3019
+
3020
+ @overload
3021
+ async def POST(
3022
+ self,
3023
+ path: Literal["/gpu/memoryset/{name_or_id}/memory"],
3024
+ *,
3025
+ params: PostGpuMemorysetByNameOrIdMemoryParams,
3026
+ json: PostGpuMemorysetByNameOrIdMemoryRequest,
3027
+ data: None = None,
3028
+ files: None = None,
3029
+ content: None = None,
3030
+ parse_as: Literal["json"] = "json",
3031
+ headers: HeaderTypes | None = None,
3032
+ cookies: CookieTypes | None = None,
3033
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3034
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3035
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3036
+ extensions: RequestExtensions | None = None,
3037
+ ) -> list[str]:
3038
+ pass
3039
+
3040
+ @overload
3041
+ async def POST(
3042
+ self,
3043
+ path: Literal["/memoryset/{name_or_id}/analysis"],
3044
+ *,
3045
+ params: PostMemorysetByNameOrIdAnalysisParams,
3046
+ json: MemorysetAnalysisRequest,
3047
+ data: None = None,
3048
+ files: None = None,
3049
+ content: None = None,
3050
+ parse_as: Literal["json"] = "json",
3051
+ headers: HeaderTypes | None = None,
3052
+ cookies: CookieTypes | None = None,
3053
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3054
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3055
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3056
+ extensions: RequestExtensions | None = None,
3057
+ ) -> MemorysetAnalysisResponse:
3058
+ pass
3059
+
3060
+ @overload
3061
+ async def POST(
3062
+ self,
3063
+ path: Literal["/memoryset/{name_or_id}/memory/{memory_id}/cascading_edits"],
3064
+ *,
3065
+ params: PostMemorysetByNameOrIdMemoryByMemoryIdCascadingEditsParams,
3066
+ json: CascadeEditSuggestionsRequest,
3067
+ data: None = None,
3068
+ files: None = None,
3069
+ content: None = None,
3070
+ parse_as: Literal["json"] = "json",
3071
+ headers: HeaderTypes | None = None,
3072
+ cookies: CookieTypes | None = None,
3073
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3074
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3075
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3076
+ extensions: RequestExtensions | None = None,
3077
+ ) -> list[CascadingEditSuggestion]:
3078
+ pass
3079
+
3080
+ @overload
3081
+ async def POST(
3082
+ self,
3083
+ path: Literal["/finetuned_embedding_model"],
3084
+ *,
3085
+ params: None = None,
3086
+ json: FinetuneEmbeddingModelRequest,
3087
+ data: None = None,
3088
+ files: None = None,
3089
+ content: None = None,
3090
+ parse_as: Literal["json"] = "json",
3091
+ headers: HeaderTypes | None = None,
3092
+ cookies: CookieTypes | None = None,
3093
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3094
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3095
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3096
+ extensions: RequestExtensions | None = None,
3097
+ ) -> FinetunedEmbeddingModelMetadata:
3098
+ """Create a finetuned embedding model."""
3099
+ pass
3100
+
3101
+ @overload
3102
+ async def POST(
3103
+ self,
3104
+ path: Literal["/gpu/finetuned_embedding_model/{name_or_id}/embedding"],
3105
+ *,
3106
+ params: PostGpuFinetunedEmbeddingModelByNameOrIdEmbeddingParams,
3107
+ json: EmbedRequest,
3108
+ data: None = None,
3109
+ files: None = None,
3110
+ content: None = None,
3111
+ parse_as: Literal["json"] = "json",
3112
+ headers: HeaderTypes | None = None,
3113
+ cookies: CookieTypes | None = None,
3114
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3115
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3116
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3117
+ extensions: RequestExtensions | None = None,
3118
+ ) -> list[list[float]]:
3119
+ """Embed values using a finetuned embedding model."""
3120
+ pass
3121
+
3122
+ @overload
3123
+ async def POST(
3124
+ self,
3125
+ path: Literal["/gpu/pretrained_embedding_model/{model_name}/embedding"],
3126
+ *,
3127
+ params: PostGpuPretrainedEmbeddingModelByModelNameEmbeddingParams,
3128
+ json: EmbedRequest,
3129
+ data: None = None,
3130
+ files: None = None,
3131
+ content: None = None,
3132
+ parse_as: Literal["json"] = "json",
3133
+ headers: HeaderTypes | None = None,
3134
+ cookies: CookieTypes | None = None,
3135
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3136
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3137
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3138
+ extensions: RequestExtensions | None = None,
3139
+ ) -> list[list[float]]:
3140
+ """Embed values using a pretrained embedding model."""
3141
+ pass
3142
+
3143
+ @overload
3144
+ async def POST(
3145
+ self,
3146
+ path: Literal["/finetuned_embedding_model/{name_or_id}/evaluation"],
3147
+ *,
3148
+ params: PostFinetunedEmbeddingModelByNameOrIdEvaluationParams,
3149
+ json: EmbeddingEvaluationRequest,
3150
+ data: None = None,
3151
+ files: None = None,
3152
+ content: None = None,
3153
+ parse_as: Literal["json"] = "json",
3154
+ headers: HeaderTypes | None = None,
3155
+ cookies: CookieTypes | None = None,
3156
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3157
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3158
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3159
+ extensions: RequestExtensions | None = None,
3160
+ ) -> EmbeddingEvaluationResponse:
3161
+ """Evaluate a finetuned embedding model as a KNN classifier or regressor."""
3162
+ pass
3163
+
3164
+ @overload
3165
+ async def POST(
3166
+ self,
3167
+ path: Literal["/pretrained_embedding_model/{model_name}/evaluation"],
3168
+ *,
3169
+ params: PostPretrainedEmbeddingModelByModelNameEvaluationParams,
3170
+ json: EmbeddingEvaluationRequest,
3171
+ data: None = None,
3172
+ files: None = None,
3173
+ content: None = None,
3174
+ parse_as: Literal["json"] = "json",
3175
+ headers: HeaderTypes | None = None,
3176
+ cookies: CookieTypes | None = None,
3177
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3178
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3179
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3180
+ extensions: RequestExtensions | None = None,
3181
+ ) -> EmbeddingEvaluationResponse:
3182
+ """Evaluate a pretrained embedding model as a KNN classifier or regressor."""
3183
+ pass
3184
+
3185
+ @overload
3186
+ async def POST(
3187
+ self,
3188
+ path: Literal["/datasource/upload"],
3189
+ *,
3190
+ params: None = None,
3191
+ json: None = None,
3192
+ data: PostDatasourceUploadRequest,
3193
+ files: dict[Literal["files"], FileTypes] | list[tuple[Literal["files"], FileTypes]],
3194
+ content: None = None,
3195
+ parse_as: Literal["json"] = "json",
3196
+ headers: HeaderTypes | None = None,
3197
+ cookies: CookieTypes | None = None,
3198
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3199
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3200
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3201
+ extensions: RequestExtensions | None = None,
3202
+ ) -> DatasourceMetadata:
3203
+ """
3204
+ Create a datasource by uploading files.
3205
+
3206
+ Supports multiple file upload scenarios:
3207
+ - Multiple files: HuggingFace Dataset format (dataset_info.json, state.json, .arrow files, etc.)
3208
+ - Single file: CSV, JSON, JSONL, Parquet, or Pickle files
3209
+ """
3210
+ pass
3211
+
3212
+ @overload
3213
+ async def POST(
3214
+ self,
3215
+ path: Literal["/datasource"],
3216
+ *,
3217
+ params: None = None,
3218
+ json: CreateDatasourceFromContentRequest,
3219
+ data: None = None,
3220
+ files: None = None,
3221
+ content: None = None,
3222
+ parse_as: Literal["json"] = "json",
3223
+ headers: HeaderTypes | None = None,
3224
+ cookies: CookieTypes | None = None,
3225
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3226
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3227
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3228
+ extensions: RequestExtensions | None = None,
3229
+ ) -> DatasourceMetadata:
3230
+ """
3231
+ Create a datasource from JSON content.
3232
+
3233
+ Automatically detects and supports multiple JSON formats:
3234
+ - List of records: [{"col1": val1, "col2": val2}, {"col1": val3, "col2": val4}, ...]
3235
+ - Dictionary of columns: {"col1": [val1, val3, ...], "col2": [val2, val4, ...]}
3236
+ """
3237
+ pass
3238
+
3239
+ @overload
3240
+ async def POST(
3241
+ self,
3242
+ path: Literal["/datasource/{name_or_id}/rows"],
3243
+ *,
3244
+ params: PostDatasourceByNameOrIdRowsParams,
3245
+ json: GetDatasourceRowsRequest,
3246
+ data: None = None,
3247
+ files: None = None,
3248
+ content: None = None,
3249
+ parse_as: Literal["json"] = "json",
3250
+ headers: HeaderTypes | None = None,
3251
+ cookies: CookieTypes | None = None,
3252
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3253
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3254
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3255
+ extensions: RequestExtensions | None = None,
3256
+ ) -> list[dict[str, Any]]:
3257
+ """Get rows from a specific datasource with optional filtering."""
3258
+ pass
3259
+
3260
+ @overload
3261
+ async def POST(
3262
+ self,
3263
+ path: Literal["/datasource/{name_or_id}/rows/count"],
3264
+ *,
3265
+ params: PostDatasourceByNameOrIdRowsCountParams,
3266
+ json: GetDatasourceRowCountRequest,
3267
+ data: None = None,
3268
+ files: None = None,
3269
+ content: None = None,
3270
+ parse_as: Literal["json"] = "json",
3271
+ headers: HeaderTypes | None = None,
3272
+ cookies: CookieTypes | None = None,
3273
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3274
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3275
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3276
+ extensions: RequestExtensions | None = None,
3277
+ ) -> int:
3278
+ """Get row count from a specific datasource with optional filtering."""
3279
+ pass
3280
+
3281
+ @overload
3282
+ async def POST(
3283
+ self,
3284
+ path: Literal["/classification_model"],
3285
+ *,
3286
+ params: None = None,
3287
+ json: CreateClassificationModelRequest,
3288
+ data: None = None,
3289
+ files: None = None,
3290
+ content: None = None,
3291
+ parse_as: Literal["json"] = "json",
3292
+ headers: HeaderTypes | None = None,
3293
+ cookies: CookieTypes | None = None,
3294
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3295
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3296
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3297
+ extensions: RequestExtensions | None = None,
3298
+ ) -> ClassificationModelMetadata:
3299
+ pass
3300
+
3301
+ @overload
3302
+ async def POST(
3303
+ self,
3304
+ path: Literal["/regression_model"],
3305
+ *,
3306
+ params: None = None,
3307
+ json: CreateRegressionModelRequest,
3308
+ data: None = None,
3309
+ files: None = None,
3310
+ content: None = None,
3311
+ parse_as: Literal["json"] = "json",
3312
+ headers: HeaderTypes | None = None,
3313
+ cookies: CookieTypes | None = None,
3314
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3315
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3316
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3317
+ extensions: RequestExtensions | None = None,
3318
+ ) -> RegressionModelMetadata:
3319
+ pass
3320
+
3321
+ @overload
3322
+ async def POST(
3323
+ self,
3324
+ path: Literal["/gpu/classification_model/{name_or_id}/prediction"],
3325
+ *,
3326
+ params: PostGpuClassificationModelByNameOrIdPredictionParams,
3327
+ json: ClassificationPredictionRequest,
3328
+ data: None = None,
3329
+ files: None = None,
3330
+ content: None = None,
3331
+ parse_as: Literal["json"] = "json",
3332
+ headers: HeaderTypes | None = None,
3333
+ cookies: CookieTypes | None = None,
3334
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3335
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3336
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3337
+ extensions: RequestExtensions | None = None,
3338
+ ) -> list[BaseLabelPredictionResult]:
3339
+ pass
3340
+
3341
+ @overload
3342
+ async def POST(
3343
+ self,
3344
+ path: Literal["/classification_model/{name_or_id}/prediction"],
3345
+ *,
3346
+ params: PostClassificationModelByNameOrIdPredictionParams,
3347
+ json: ClassificationPredictionRequest,
3348
+ data: None = None,
3349
+ files: None = None,
3350
+ content: None = None,
3351
+ parse_as: Literal["json"] = "json",
3352
+ headers: HeaderTypes | None = None,
3353
+ cookies: CookieTypes | None = None,
3354
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3355
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3356
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3357
+ extensions: RequestExtensions | None = None,
3358
+ ) -> list[BaseLabelPredictionResult]:
3359
+ pass
3360
+
3361
+ @overload
3362
+ async def POST(
3363
+ self,
3364
+ path: Literal["/gpu/regression_model/{name_or_id}/prediction"],
3365
+ *,
3366
+ params: PostGpuRegressionModelByNameOrIdPredictionParams,
3367
+ json: RegressionPredictionRequest,
3368
+ data: None = None,
3369
+ files: None = None,
3370
+ content: None = None,
3371
+ parse_as: Literal["json"] = "json",
3372
+ headers: HeaderTypes | None = None,
3373
+ cookies: CookieTypes | None = None,
3374
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3375
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3376
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3377
+ extensions: RequestExtensions | None = None,
3378
+ ) -> list[BaseScorePredictionResult]:
3379
+ pass
3380
+
3381
+ @overload
3382
+ async def POST(
3383
+ self,
3384
+ path: Literal["/regression_model/{name_or_id}/prediction"],
3385
+ *,
3386
+ params: PostRegressionModelByNameOrIdPredictionParams,
3387
+ json: RegressionPredictionRequest,
3388
+ data: None = None,
3389
+ files: None = None,
3390
+ content: None = None,
3391
+ parse_as: Literal["json"] = "json",
3392
+ headers: HeaderTypes | None = None,
3393
+ cookies: CookieTypes | None = None,
3394
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3395
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3396
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3397
+ extensions: RequestExtensions | None = None,
3398
+ ) -> list[BaseScorePredictionResult]:
3399
+ pass
3400
+
3401
+ @overload
3402
+ async def POST(
3403
+ self,
3404
+ path: Literal["/classification_model/{model_name_or_id}/evaluation"],
3405
+ *,
3406
+ params: PostClassificationModelByModelNameOrIdEvaluationParams,
3407
+ json: ClassificationEvaluationRequest,
3408
+ data: None = None,
3409
+ files: None = None,
3410
+ content: None = None,
3411
+ parse_as: Literal["json"] = "json",
3412
+ headers: HeaderTypes | None = None,
3413
+ cookies: CookieTypes | None = None,
3414
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3415
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3416
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3417
+ extensions: RequestExtensions | None = None,
3418
+ ) -> EvaluationResponse:
3419
+ pass
3420
+
3421
+ @overload
3422
+ async def POST(
3423
+ self,
3424
+ path: Literal["/regression_model/{model_name_or_id}/evaluation"],
3425
+ *,
3426
+ params: PostRegressionModelByModelNameOrIdEvaluationParams,
3427
+ json: RegressionEvaluationRequest,
3428
+ data: None = None,
3429
+ files: None = None,
3430
+ content: None = None,
3431
+ parse_as: Literal["json"] = "json",
3432
+ headers: HeaderTypes | None = None,
3433
+ cookies: CookieTypes | None = None,
3434
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3435
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3436
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3437
+ extensions: RequestExtensions | None = None,
3438
+ ) -> EvaluationResponse:
3439
+ pass
3440
+
3441
+ @overload
3442
+ async def POST(
3443
+ self,
3444
+ path: Literal["/telemetry/prediction"],
3445
+ *,
3446
+ params: None = None,
3447
+ json: ListPredictionsRequest | None = None,
3448
+ data: None = None,
3449
+ files: None = None,
3450
+ content: None = None,
3451
+ parse_as: Literal["json"] = "json",
3452
+ headers: HeaderTypes | None = None,
3453
+ cookies: CookieTypes | None = None,
3454
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3455
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3456
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3457
+ extensions: RequestExtensions | None = None,
3458
+ ) -> list[LabelPredictionWithMemoriesAndFeedback | ScorePredictionWithMemoriesAndFeedback]:
3459
+ """List predictions with optional filtering and sorting."""
3460
+ pass
3461
+
3462
+ @overload
3463
+ async def POST(
3464
+ self,
3465
+ path: Literal["/telemetry/prediction/count"],
3466
+ *,
3467
+ params: None = None,
3468
+ json: CountPredictionsRequest | None = None,
3469
+ data: None = None,
3470
+ files: None = None,
3471
+ content: None = None,
3472
+ parse_as: Literal["json"] = "json",
3473
+ headers: HeaderTypes | None = None,
3474
+ cookies: CookieTypes | None = None,
3475
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3476
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3477
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3478
+ extensions: RequestExtensions | None = None,
3479
+ ) -> int:
3480
+ """Count predictions with optional filtering."""
3481
+ pass
3482
+
3483
+ @overload
3484
+ async def POST(
3485
+ self,
3486
+ path: Literal["/telemetry/memories"],
3487
+ *,
3488
+ params: None = None,
3489
+ json: TelemetryMemoriesRequest,
3490
+ data: None = None,
3491
+ files: None = None,
3492
+ content: None = None,
3493
+ parse_as: Literal["json"] = "json",
3494
+ headers: HeaderTypes | None = None,
3495
+ cookies: CookieTypes | None = None,
3496
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3497
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3498
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3499
+ extensions: RequestExtensions | None = None,
3500
+ ) -> PaginatedUnionLabeledMemoryWithFeedbackMetricsScoredMemoryWithFeedbackMetrics:
3501
+ """
3502
+ List memories with feedback metrics.
3503
+ **Note**: This endpoint will ONLY return memories that have been used in a prediction.
3504
+ If you want to query ALL memories WITHOUT feedback metrics, use the query_memoryset endpoint.
3505
+ """
3506
+ pass
3507
+
3508
+ @overload
3509
+ async def POST(
3510
+ self,
3511
+ path: Literal["/agents/bootstrap_classification_model"],
3512
+ *,
3513
+ params: None = None,
3514
+ json: BootstrapClassificationModelRequest,
3515
+ data: None = None,
3516
+ files: None = None,
3517
+ content: None = None,
3518
+ parse_as: Literal["json"] = "json",
3519
+ headers: HeaderTypes | None = None,
3520
+ cookies: CookieTypes | None = None,
3521
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3522
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3523
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3524
+ extensions: RequestExtensions | None = None,
3525
+ ) -> BootstrapClassificationModelResponse:
3526
+ """
3527
+ Bootstrap a classification model by creating a memoryset with generated memories and a classification model.
3528
+
3529
+ This endpoint uses the bootstrap_classification_model agent to generate:
3530
+ 1. Memoryset configuration with appropriate settings
3531
+ 2. Model configuration with optimal parameters
3532
+ 3. High-quality training memories for each label
3533
+
3534
+ The process involves:
3535
+ 1. Calling the agent to generate configurations and memories
3536
+ 2. Creating a datasource from the generated memories
3537
+ 3. Creating a memoryset from the datasource
3538
+ 4. Creating a classification model from the memoryset
3539
+ """
3540
+ pass
3541
+
3542
+ async def POST(
3543
+ self,
3544
+ path: str,
3545
+ *,
3546
+ params: Mapping[str, Any] | None = None,
3547
+ json: Any | None = None,
3548
+ data: Mapping[str, Any] | None = None,
3549
+ content: RequestContent | None = None,
3550
+ files: dict[Any, FileTypes] | list[tuple[Any, FileTypes]] | None = None,
3551
+ parse_as: Literal["json", "text"] | None = "json",
3552
+ headers: HeaderTypes | None = None,
3553
+ cookies: CookieTypes | None = None,
3554
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3555
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3556
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3557
+ extensions: RequestExtensions | None = None,
3558
+ ) -> Any:
3559
+ path_params, query_params = self._parse_params(params or {}, path)
3560
+ res = await self.post(
3561
+ path.format(**path_params),
3562
+ params=query_params,
3563
+ content=content,
3564
+ data=data,
3565
+ files=files,
3566
+ json=json,
3567
+ headers=headers,
3568
+ cookies=cookies,
3569
+ auth=auth,
3570
+ follow_redirects=follow_redirects,
3571
+ timeout=timeout,
3572
+ extensions=extensions,
3573
+ )
3574
+ res.raise_for_status()
3575
+ return (
3576
+ None
3577
+ if res.status_code == 204
3578
+ else res.json() if parse_as == "json" else res.text if parse_as == "text" else res.content
3579
+ )
3580
+
3581
+ @overload
3582
+ async def PUT(
3583
+ self,
3584
+ path: Literal["/auth/org/plan"],
3585
+ *,
3586
+ params: None = None,
3587
+ json: UpdateOrgPlanRequest,
3588
+ data: None = None,
3589
+ files: None = None,
3590
+ content: None = None,
3591
+ parse_as: Literal["json"] = "json",
3592
+ headers: HeaderTypes | None = None,
3593
+ cookies: CookieTypes | None = None,
3594
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3595
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3596
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3597
+ extensions: RequestExtensions | None = None,
3598
+ ) -> OrgPlan:
3599
+ """Update the organization plan."""
3600
+ pass
3601
+
3602
+ @overload
3603
+ async def PUT(
3604
+ self,
3605
+ path: Literal["/telemetry/prediction/feedback"],
3606
+ *,
3607
+ params: None = None,
3608
+ json: PutTelemetryPredictionFeedbackRequest,
3609
+ data: None = None,
3610
+ files: None = None,
3611
+ content: None = None,
3612
+ parse_as: Literal["json"] = "json",
3613
+ headers: HeaderTypes | None = None,
3614
+ cookies: CookieTypes | None = None,
3615
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3616
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3617
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3618
+ extensions: RequestExtensions | None = None,
3619
+ ) -> PredictionFeedbackResult:
3620
+ """Record feedback for predictions, handling updates, deletions, and insertions."""
3621
+ pass
3622
+
3623
+ async def PUT(
3624
+ self,
3625
+ path: str,
3626
+ *,
3627
+ params: Mapping[str, Any] | None = None,
3628
+ json: Any | None = None,
3629
+ data: Mapping[str, Any] | None = None,
3630
+ content: RequestContent | None = None,
3631
+ files: dict[Any, FileTypes] | list[tuple[Any, FileTypes]] | None = None,
3632
+ parse_as: Literal["json", "text"] | None = "json",
3633
+ headers: HeaderTypes | None = None,
3634
+ cookies: CookieTypes | None = None,
3635
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3636
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3637
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3638
+ extensions: RequestExtensions | None = None,
3639
+ ) -> Any:
3640
+ path_params, query_params = self._parse_params(params or {}, path)
3641
+ res = await self.put(
3642
+ path.format(**path_params),
3643
+ params=query_params,
3644
+ content=content,
3645
+ data=data,
3646
+ files=files,
3647
+ json=json,
3648
+ headers=headers,
3649
+ cookies=cookies,
3650
+ auth=auth,
3651
+ follow_redirects=follow_redirects,
3652
+ timeout=timeout,
3653
+ extensions=extensions,
3654
+ )
3655
+ res.raise_for_status()
3656
+ return (
3657
+ None
3658
+ if res.status_code == 204
3659
+ else res.json() if parse_as == "json" else res.text if parse_as == "text" else res.content
3660
+ )
3661
+
3662
+ @overload
3663
+ async def PATCH(
3664
+ self,
3665
+ path: Literal["/memoryset/{name_or_id}"],
3666
+ *,
3667
+ params: PatchMemorysetByNameOrIdParams,
3668
+ json: MemorysetUpdate,
3669
+ data: None = None,
3670
+ files: None = None,
3671
+ content: None = None,
3672
+ parse_as: Literal["json"] = "json",
3673
+ headers: HeaderTypes | None = None,
3674
+ cookies: CookieTypes | None = None,
3675
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3676
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3677
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3678
+ extensions: RequestExtensions | None = None,
3679
+ ) -> MemorysetMetadata:
3680
+ pass
3681
+
3682
+ @overload
3683
+ async def PATCH(
3684
+ self,
3685
+ path: Literal["/gpu/memoryset/{name_or_id}/memory"],
3686
+ *,
3687
+ params: PatchGpuMemorysetByNameOrIdMemoryParams,
3688
+ json: PatchGpuMemorysetByNameOrIdMemoryRequest,
3689
+ data: None = None,
3690
+ files: None = None,
3691
+ content: None = None,
3692
+ parse_as: Literal["json"] = "json",
3693
+ headers: HeaderTypes | None = None,
3694
+ cookies: CookieTypes | None = None,
3695
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3696
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3697
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3698
+ extensions: RequestExtensions | None = None,
3699
+ ) -> LabeledMemory | ScoredMemory:
3700
+ pass
3701
+
3702
+ @overload
3703
+ async def PATCH(
3704
+ self,
3705
+ path: Literal["/gpu/memoryset/{name_or_id}/memories"],
3706
+ *,
3707
+ params: PatchGpuMemorysetByNameOrIdMemoriesParams,
3708
+ json: PatchGpuMemorysetByNameOrIdMemoriesRequest,
3709
+ data: None = None,
3710
+ files: None = None,
3711
+ content: None = None,
3712
+ parse_as: Literal["json"] = "json",
3713
+ headers: HeaderTypes | None = None,
3714
+ cookies: CookieTypes | None = None,
3715
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3716
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3717
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3718
+ extensions: RequestExtensions | None = None,
3719
+ ) -> list[LabeledMemory] | list[ScoredMemory]:
3720
+ pass
3721
+
3722
+ @overload
3723
+ async def PATCH(
3724
+ self,
3725
+ path: Literal["/classification_model/{name_or_id}"],
3726
+ *,
3727
+ params: PatchClassificationModelByNameOrIdParams,
3728
+ json: PredictiveModelUpdate,
3729
+ data: None = None,
3730
+ files: None = None,
3731
+ content: None = None,
3732
+ parse_as: Literal["json"] = "json",
3733
+ headers: HeaderTypes | None = None,
3734
+ cookies: CookieTypes | None = None,
3735
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3736
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3737
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3738
+ extensions: RequestExtensions | None = None,
3739
+ ) -> ClassificationModelMetadata:
3740
+ pass
3741
+
3742
+ @overload
3743
+ async def PATCH(
3744
+ self,
3745
+ path: Literal["/regression_model/{name_or_id}"],
3746
+ *,
3747
+ params: PatchRegressionModelByNameOrIdParams,
3748
+ json: PredictiveModelUpdate,
3749
+ data: None = None,
3750
+ files: None = None,
3751
+ content: None = None,
3752
+ parse_as: Literal["json"] = "json",
3753
+ headers: HeaderTypes | None = None,
3754
+ cookies: CookieTypes | None = None,
3755
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3756
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3757
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3758
+ extensions: RequestExtensions | None = None,
3759
+ ) -> RegressionModelMetadata:
3760
+ pass
3761
+
3762
+ @overload
3763
+ async def PATCH(
3764
+ self,
3765
+ path: Literal["/telemetry/prediction/{prediction_id}"],
3766
+ *,
3767
+ params: PatchTelemetryPredictionByPredictionIdParams,
3768
+ json: UpdatePredictionRequest,
3769
+ data: None = None,
3770
+ files: None = None,
3771
+ content: None = None,
3772
+ parse_as: Literal["json"] = "json",
3773
+ headers: HeaderTypes | None = None,
3774
+ cookies: CookieTypes | None = None,
3775
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3776
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3777
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3778
+ extensions: RequestExtensions | None = None,
3779
+ ) -> Any:
3780
+ """Update a prediction with new expected values, tags, or memory ID."""
3781
+ pass
3782
+
3783
+ async def PATCH(
3784
+ self,
3785
+ path: str,
3786
+ *,
3787
+ params: Mapping[str, Any] | None = None,
3788
+ json: Any | None = None,
3789
+ data: Mapping[str, Any] | None = None,
3790
+ content: RequestContent | None = None,
3791
+ files: dict[Any, FileTypes] | list[tuple[Any, FileTypes]] | None = None,
3792
+ parse_as: Literal["json", "text"] | None = "json",
3793
+ headers: HeaderTypes | None = None,
3794
+ cookies: CookieTypes | None = None,
3795
+ auth: AuthTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3796
+ follow_redirects: bool | UseClientDefault = USE_CLIENT_DEFAULT,
3797
+ timeout: TimeoutTypes | UseClientDefault = USE_CLIENT_DEFAULT,
3798
+ extensions: RequestExtensions | None = None,
3799
+ ) -> Any:
3800
+ path_params, query_params = self._parse_params(params or {}, path)
3801
+ res = await self.patch(
3802
+ path.format(**path_params),
3803
+ params=query_params,
3804
+ content=content,
3805
+ data=data,
3806
+ files=files,
3807
+ json=json,
3808
+ headers=headers,
3809
+ cookies=cookies,
3810
+ auth=auth,
3811
+ follow_redirects=follow_redirects,
3812
+ timeout=timeout,
3813
+ extensions=extensions,
3814
+ )
3815
+ res.raise_for_status()
3816
+ return (
3817
+ None
3818
+ if res.status_code == 204
3819
+ else res.json() if parse_as == "json" else res.text if parse_as == "text" else res.content
3820
+ )
3821
+
3822
+ @staticmethod
3823
+ async def _raise_error_for_response(response: Response) -> None:
3824
+ if response.status_code == 401:
3825
+ raise ValueError("Invalid API key")
3826
+ # elif response.status_code == 402:
3827
+ # res = cast(QuotaExceededErrorResponse, json.loads((await response.aread()).decode(response.encoding or "utf-8")))
3828
+
3829
+ # raise RuntimeError(
3830
+ # f"{res['quota_type'].replace('_', ' ').title()} limit reached ({res['current']}/{res['quota_limit']})"
3831
+ # )
3832
+ elif response.status_code == 403:
3833
+ raise PermissionError(json.loads((await response.aread()).decode(response.encoding or "utf-8"))["reason"])
3834
+ elif response.status_code == 404:
3835
+ res = cast(NotFoundErrorResponse, json.loads((await response.aread()).decode(response.encoding or "utf-8")))
3836
+ if res["resource"] is not None:
3837
+ raise LookupError(f"The {res['resource']} you are looking for does not exist")
3838
+ else:
3839
+ raise RuntimeError(f"Unknown API route: {response.url}")
3840
+ elif response.status_code == 405:
3841
+ raise RuntimeError(f"Unknown method {response.request.method} for API route: {response.url}")
3842
+ elif response.status_code == 409:
3843
+ res = cast(
3844
+ ConstraintViolationErrorResponse,
3845
+ json.loads((await response.aread()).decode(response.encoding or "utf-8")),
3846
+ )
3847
+ raise RuntimeError(res["constraint"])
3848
+ elif response.status_code == 422:
3849
+ res = cast(
3850
+ InvalidInputErrorResponse, json.loads((await response.aread()).decode(response.encoding or "utf-8"))
3851
+ )
3852
+ issues = [f"{issue['loc'][-1]}: {issue['msg']}" for issue in res["validation_issues"]]
3853
+ raise ValueError("Invalid input:\n\t" + "\n\t".join(issues))
3854
+ elif response.status_code == 500:
3855
+ res = cast(
3856
+ InternalServerErrorResponse, json.loads((await response.aread()).decode(response.encoding or "utf-8"))
3857
+ )
3858
+ raise RuntimeError(f"Unexpected server error: {res['message']}")
3859
+ elif response.status_code == 503:
3860
+ raise RuntimeError("Orca API is currently unavailable, please try again later")
3861
+ elif response.status_code >= 400:
3862
+ raise RuntimeError(f"Unexpected status code: {response.status_code}")
3863
+
3864
+ @staticmethod
3865
+ async def _instrument_request(request: Request) -> None:
3866
+ request.headers["X-Request-ID"] = str(uuid.uuid4())
3867
+
3868
+ def __init__(
3869
+ self,
3870
+ *,
3871
+ api_key: str | None = None,
3872
+ base_url: URL | str = "",
3873
+ headers: HeaderTypes | None = None,
3874
+ transport: AsyncBaseTransport | None = None,
3875
+ timeout: TimeoutTypes | None = None,
3876
+ limits: Limits | None = None,
3877
+ max_redirects: int = 20,
3878
+ event_hooks: None | (Mapping[str, list[Callable[..., Any]]]) = None,
3879
+ http1: bool = True,
3880
+ http2: bool = False,
3881
+ proxy: str | URL | Proxy | None = None,
3882
+ log_level: int = logging.WARNING,
3883
+ ) -> None:
3884
+ """
3885
+ Initialize an OrcaAPI async httpx client
3886
+
3887
+ Params:
3888
+ api_key: API key to use for authentication, will default to ORCA_API_KEY if not set.
3889
+ base_url: URL of the OrcaAPI, will default to ORCA_API_URL or the cloud API URL if not set.
3890
+ """
3891
+ logging.getLogger("httpx").setLevel(log_level)
3892
+ logging.getLogger("httpcore").setLevel(log_level)
3893
+ super().__init__(
3894
+ headers={"Api-Key": api_key or os.environ.get("ORCA_API_KEY", "")} | dict(Headers(headers or {}).items()),
3895
+ http1=http1,
3896
+ http2=http2,
3897
+ proxy=proxy,
3898
+ timeout=timeout or Timeout(connect=3, read=20, write=10, pool=5),
3899
+ follow_redirects=True,
3900
+ limits=limits or Limits(max_connections=100, max_keepalive_connections=20),
3901
+ max_redirects=max_redirects,
3902
+ event_hooks=event_hooks
3903
+ or {"request": [self._instrument_request], "response": [self._raise_error_for_response]},
3904
+ base_url=base_url or os.environ.get("ORCA_API_URL", "https://api.orcadb.ai/"),
3905
+ transport=transport
3906
+ or RetryTransport(
3907
+ transport=AsyncHTTPTransport(),
3908
+ retry=Retry(
3909
+ total=5,
3910
+ backoff_factor=0.5,
3911
+ allowed_methods=["GET", "POST", "PUT", "PATCH", "DELETE"],
3912
+ status_forcelist=[429, 500, 502, 503, 504],
3913
+ ),
3914
+ ),
3915
+ )
3916
+
3917
+ @property
3918
+ def api_key(self) -> str:
3919
+ return self.headers["Api-Key"]
3920
+
3921
+ @api_key.setter
3922
+ def api_key(self, api_key: str) -> None:
3923
+ self.headers.update(Headers({"Api-Key": api_key}))
3924
+
3925
+ client_ctx = ContextVar[Self | None]("orca_async_client", default=None)
3926
+ default_client: Self | None = None
3927
+
3928
+ @contextmanager
3929
+ def use(self) -> Generator[None, None, None]:
3930
+ """Context manager to inject this async client into OrcaSDK async methods"""
3931
+ token = self.client_ctx.set(self)
3932
+ try:
3933
+ yield
3934
+ finally:
3935
+ self.client_ctx.reset(token)
3936
+
3937
+ @classmethod
3938
+ def _resolve_client(cls, client: Self | None = None) -> Self:
3939
+ client = client or cls.client_ctx.get() or cls.default_client
3940
+ if not client:
3941
+ client = cls.default_client = cls()
3942
+ return client