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