orca-sdk 0.0.97__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 (298) hide show
  1. orca_sdk/__init__.py +1 -0
  2. orca_sdk/_shared/__init__.py +1 -0
  3. orca_sdk/_utils/analysis_ui.py +5 -5
  4. orca_sdk/_utils/auth.py +23 -33
  5. orca_sdk/_utils/pagination.py +126 -0
  6. orca_sdk/_utils/pagination_test.py +132 -0
  7. orca_sdk/classification_model.py +188 -126
  8. orca_sdk/classification_model_test.py +57 -8
  9. orca_sdk/client.py +3515 -0
  10. orca_sdk/conftest.py +10 -0
  11. orca_sdk/credentials.py +59 -21
  12. orca_sdk/credentials_test.py +20 -0
  13. orca_sdk/datasource.py +42 -76
  14. orca_sdk/embedding_model.py +225 -71
  15. orca_sdk/embedding_model_test.py +27 -36
  16. orca_sdk/job.py +49 -45
  17. orca_sdk/job_test.py +16 -0
  18. orca_sdk/memoryset.py +340 -353
  19. orca_sdk/memoryset_test.py +7 -11
  20. orca_sdk/regression_model.py +120 -111
  21. orca_sdk/regression_model_test.py +15 -0
  22. orca_sdk/telemetry.py +162 -139
  23. {orca_sdk-0.0.97.dist-info → orca_sdk-0.0.98.dist-info}/METADATA +2 -5
  24. orca_sdk-0.0.98.dist-info/RECORD +40 -0
  25. orca_sdk/_generated_api_client/__init__.py +0 -3
  26. orca_sdk/_generated_api_client/api/__init__.py +0 -307
  27. orca_sdk/_generated_api_client/api/auth/__init__.py +0 -0
  28. orca_sdk/_generated_api_client/api/auth/check_authentication_auth_get.py +0 -128
  29. orca_sdk/_generated_api_client/api/auth/create_api_key_auth_api_key_post.py +0 -170
  30. orca_sdk/_generated_api_client/api/auth/create_org_plan_auth_org_plan_post.py +0 -168
  31. orca_sdk/_generated_api_client/api/auth/delete_api_key_auth_api_key_name_or_id_delete.py +0 -156
  32. orca_sdk/_generated_api_client/api/auth/delete_org_auth_org_delete.py +0 -130
  33. orca_sdk/_generated_api_client/api/auth/get_org_plan_auth_org_plan_get.py +0 -122
  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/auth/update_org_plan_auth_org_plan_put.py +0 -168
  36. orca_sdk/_generated_api_client/api/classification_model/__init__.py +0 -0
  37. orca_sdk/_generated_api_client/api/classification_model/create_classification_model_classification_model_post.py +0 -170
  38. orca_sdk/_generated_api_client/api/classification_model/delete_classification_model_classification_model_name_or_id_delete.py +0 -156
  39. 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
  40. orca_sdk/_generated_api_client/api/classification_model/evaluate_classification_model_classification_model_model_name_or_id_evaluation_post.py +0 -183
  41. orca_sdk/_generated_api_client/api/classification_model/get_classification_model_classification_model_name_or_id_get.py +0 -156
  42. 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
  43. orca_sdk/_generated_api_client/api/classification_model/list_classification_model_evaluations_classification_model_model_name_or_id_evaluation_get.py +0 -161
  44. orca_sdk/_generated_api_client/api/classification_model/list_classification_models_classification_model_get.py +0 -127
  45. orca_sdk/_generated_api_client/api/classification_model/predict_label_gpu_classification_model_name_or_id_prediction_post.py +0 -190
  46. orca_sdk/_generated_api_client/api/classification_model/update_classification_model_classification_model_name_or_id_patch.py +0 -183
  47. orca_sdk/_generated_api_client/api/datasource/__init__.py +0 -0
  48. orca_sdk/_generated_api_client/api/datasource/create_datasource_from_content_datasource_post.py +0 -224
  49. orca_sdk/_generated_api_client/api/datasource/create_datasource_from_files_datasource_upload_post.py +0 -229
  50. orca_sdk/_generated_api_client/api/datasource/create_embedding_evaluation_datasource_name_or_id_embedding_evaluation_post.py +0 -183
  51. orca_sdk/_generated_api_client/api/datasource/delete_datasource_datasource_name_or_id_delete.py +0 -156
  52. orca_sdk/_generated_api_client/api/datasource/download_datasource_datasource_name_or_id_download_get.py +0 -172
  53. orca_sdk/_generated_api_client/api/datasource/get_datasource_datasource_name_or_id_get.py +0 -156
  54. orca_sdk/_generated_api_client/api/datasource/get_embedding_evaluation_datasource_name_or_id_embedding_evaluation_task_id_get.py +0 -169
  55. orca_sdk/_generated_api_client/api/datasource/list_datasources_datasource_get.py +0 -127
  56. orca_sdk/_generated_api_client/api/datasource/list_embedding_evaluations_datasource_name_or_id_embedding_evaluation_get.py +0 -235
  57. orca_sdk/_generated_api_client/api/default/__init__.py +0 -0
  58. orca_sdk/_generated_api_client/api/default/healthcheck_get.py +0 -118
  59. orca_sdk/_generated_api_client/api/default/healthcheck_gpu_get.py +0 -118
  60. orca_sdk/_generated_api_client/api/finetuned_embedding_model/__init__.py +0 -0
  61. orca_sdk/_generated_api_client/api/finetuned_embedding_model/create_finetuned_embedding_model_finetuned_embedding_model_post.py +0 -168
  62. orca_sdk/_generated_api_client/api/finetuned_embedding_model/delete_finetuned_embedding_model_finetuned_embedding_model_name_or_id_delete.py +0 -156
  63. 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
  64. orca_sdk/_generated_api_client/api/finetuned_embedding_model/get_finetuned_embedding_model_finetuned_embedding_model_name_or_id_get.py +0 -156
  65. orca_sdk/_generated_api_client/api/finetuned_embedding_model/list_finetuned_embedding_models_finetuned_embedding_model_get.py +0 -127
  66. orca_sdk/_generated_api_client/api/memoryset/__init__.py +0 -0
  67. orca_sdk/_generated_api_client/api/memoryset/analyze_memoryset_memoryset_name_or_id_analysis_post.py +0 -183
  68. orca_sdk/_generated_api_client/api/memoryset/batch_delete_memoryset_batch_delete_memoryset_post.py +0 -168
  69. orca_sdk/_generated_api_client/api/memoryset/clone_memoryset_memoryset_name_or_id_clone_post.py +0 -181
  70. orca_sdk/_generated_api_client/api/memoryset/create_memoryset_memoryset_post.py +0 -168
  71. orca_sdk/_generated_api_client/api/memoryset/delete_memories_memoryset_name_or_id_memories_delete_post.py +0 -181
  72. orca_sdk/_generated_api_client/api/memoryset/delete_memory_memoryset_name_or_id_memory_memory_id_delete.py +0 -167
  73. orca_sdk/_generated_api_client/api/memoryset/delete_memoryset_memoryset_name_or_id_delete.py +0 -156
  74. orca_sdk/_generated_api_client/api/memoryset/get_analysis_memoryset_name_or_id_analysis_analysis_task_id_get.py +0 -169
  75. orca_sdk/_generated_api_client/api/memoryset/get_memories_memoryset_name_or_id_memories_get_post.py +0 -210
  76. orca_sdk/_generated_api_client/api/memoryset/get_memory_memoryset_name_or_id_memory_memory_id_get.py +0 -186
  77. orca_sdk/_generated_api_client/api/memoryset/get_memoryset_memoryset_name_or_id_get.py +0 -156
  78. orca_sdk/_generated_api_client/api/memoryset/insert_memories_gpu_memoryset_name_or_id_memory_post.py +0 -188
  79. orca_sdk/_generated_api_client/api/memoryset/list_analyses_memoryset_name_or_id_analysis_get.py +0 -235
  80. orca_sdk/_generated_api_client/api/memoryset/list_memorysets_memoryset_get.py +0 -180
  81. orca_sdk/_generated_api_client/api/memoryset/memoryset_lookup_gpu_memoryset_name_or_id_lookup_post.py +0 -212
  82. orca_sdk/_generated_api_client/api/memoryset/potential_duplicate_groups_memoryset_name_or_id_potential_duplicate_groups_get.py +0 -195
  83. orca_sdk/_generated_api_client/api/memoryset/query_memoryset_memoryset_name_or_id_memories_post.py +0 -210
  84. orca_sdk/_generated_api_client/api/memoryset/suggest_cascading_edits_memoryset_name_or_id_memory_memory_id_cascading_edits_post.py +0 -233
  85. orca_sdk/_generated_api_client/api/memoryset/update_memories_gpu_memoryset_name_or_id_memories_patch.py +0 -216
  86. orca_sdk/_generated_api_client/api/memoryset/update_memory_gpu_memoryset_name_or_id_memory_patch.py +0 -205
  87. orca_sdk/_generated_api_client/api/memoryset/update_memoryset_memoryset_name_or_id_patch.py +0 -183
  88. orca_sdk/_generated_api_client/api/predictive_model/__init__.py +0 -0
  89. orca_sdk/_generated_api_client/api/predictive_model/list_predictive_models_predictive_model_get.py +0 -150
  90. orca_sdk/_generated_api_client/api/pretrained_embedding_model/__init__.py +0 -0
  91. orca_sdk/_generated_api_client/api/pretrained_embedding_model/embed_with_pretrained_model_gpu_pretrained_embedding_model_model_name_embedding_post.py +0 -192
  92. orca_sdk/_generated_api_client/api/pretrained_embedding_model/get_pretrained_embedding_model_pretrained_embedding_model_model_name_get.py +0 -161
  93. orca_sdk/_generated_api_client/api/pretrained_embedding_model/list_pretrained_embedding_models_pretrained_embedding_model_get.py +0 -127
  94. orca_sdk/_generated_api_client/api/regression_model/__init__.py +0 -0
  95. orca_sdk/_generated_api_client/api/regression_model/create_regression_model_regression_model_post.py +0 -170
  96. 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
  97. orca_sdk/_generated_api_client/api/regression_model/delete_regression_model_regression_model_name_or_id_delete.py +0 -154
  98. orca_sdk/_generated_api_client/api/regression_model/evaluate_regression_model_regression_model_model_name_or_id_evaluation_post.py +0 -183
  99. 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
  100. orca_sdk/_generated_api_client/api/regression_model/get_regression_model_regression_model_name_or_id_get.py +0 -156
  101. orca_sdk/_generated_api_client/api/regression_model/list_regression_model_evaluations_regression_model_model_name_or_id_evaluation_get.py +0 -161
  102. orca_sdk/_generated_api_client/api/regression_model/list_regression_models_regression_model_get.py +0 -127
  103. orca_sdk/_generated_api_client/api/regression_model/predict_score_gpu_regression_model_name_or_id_prediction_post.py +0 -190
  104. orca_sdk/_generated_api_client/api/regression_model/update_regression_model_regression_model_name_or_id_patch.py +0 -183
  105. orca_sdk/_generated_api_client/api/task/__init__.py +0 -0
  106. orca_sdk/_generated_api_client/api/task/abort_task_task_task_id_abort_delete.py +0 -154
  107. orca_sdk/_generated_api_client/api/task/get_task_status_task_task_id_status_get.py +0 -156
  108. orca_sdk/_generated_api_client/api/task/get_task_task_task_id_get.py +0 -156
  109. orca_sdk/_generated_api_client/api/task/list_tasks_task_get.py +0 -288
  110. orca_sdk/_generated_api_client/api/telemetry/__init__.py +0 -0
  111. orca_sdk/_generated_api_client/api/telemetry/count_predictions_telemetry_prediction_count_post.py +0 -168
  112. orca_sdk/_generated_api_client/api/telemetry/drop_feedback_category_with_data_telemetry_feedback_category_name_or_id_delete.py +0 -162
  113. orca_sdk/_generated_api_client/api/telemetry/explain_prediction_telemetry_prediction_prediction_id_explanation_get.py +0 -182
  114. orca_sdk/_generated_api_client/api/telemetry/generate_memory_suggestions_telemetry_prediction_prediction_id_memory_suggestions_post.py +0 -239
  115. orca_sdk/_generated_api_client/api/telemetry/get_action_recommendation_telemetry_prediction_prediction_id_action_get.py +0 -192
  116. orca_sdk/_generated_api_client/api/telemetry/get_feedback_category_telemetry_feedback_category_name_or_id_get.py +0 -156
  117. orca_sdk/_generated_api_client/api/telemetry/get_prediction_telemetry_prediction_prediction_id_get.py +0 -180
  118. orca_sdk/_generated_api_client/api/telemetry/list_feedback_categories_telemetry_feedback_category_get.py +0 -127
  119. orca_sdk/_generated_api_client/api/telemetry/list_memories_with_feedback_telemetry_memories_post.py +0 -198
  120. orca_sdk/_generated_api_client/api/telemetry/list_predictions_telemetry_prediction_post.py +0 -198
  121. orca_sdk/_generated_api_client/api/telemetry/record_prediction_feedback_telemetry_prediction_feedback_put.py +0 -171
  122. orca_sdk/_generated_api_client/api/telemetry/update_prediction_telemetry_prediction_prediction_id_patch.py +0 -181
  123. orca_sdk/_generated_api_client/client.py +0 -216
  124. orca_sdk/_generated_api_client/errors.py +0 -38
  125. orca_sdk/_generated_api_client/models/__init__.py +0 -345
  126. orca_sdk/_generated_api_client/models/action_recommendation.py +0 -82
  127. orca_sdk/_generated_api_client/models/action_recommendation_action.py +0 -11
  128. orca_sdk/_generated_api_client/models/add_memory_recommendations.py +0 -85
  129. orca_sdk/_generated_api_client/models/add_memory_suggestion.py +0 -79
  130. orca_sdk/_generated_api_client/models/analyze_neighbor_labels_result.py +0 -116
  131. orca_sdk/_generated_api_client/models/api_key_metadata.py +0 -137
  132. orca_sdk/_generated_api_client/models/api_key_metadata_scope_item.py +0 -9
  133. orca_sdk/_generated_api_client/models/base_label_prediction_result.py +0 -130
  134. orca_sdk/_generated_api_client/models/base_model.py +0 -55
  135. orca_sdk/_generated_api_client/models/base_score_prediction_result.py +0 -108
  136. orca_sdk/_generated_api_client/models/body_create_datasource_from_files_datasource_upload_post.py +0 -145
  137. orca_sdk/_generated_api_client/models/cascade_edit_suggestions_request.py +0 -154
  138. orca_sdk/_generated_api_client/models/cascading_edit_suggestion.py +0 -92
  139. orca_sdk/_generated_api_client/models/class_representatives.py +0 -92
  140. orca_sdk/_generated_api_client/models/classification_evaluation_request.py +0 -148
  141. orca_sdk/_generated_api_client/models/classification_metrics.py +0 -259
  142. orca_sdk/_generated_api_client/models/classification_model_metadata.py +0 -227
  143. orca_sdk/_generated_api_client/models/classification_prediction_request.py +0 -220
  144. orca_sdk/_generated_api_client/models/clone_memoryset_request.py +0 -210
  145. orca_sdk/_generated_api_client/models/cluster_metrics.py +0 -78
  146. orca_sdk/_generated_api_client/models/column_info.py +0 -145
  147. orca_sdk/_generated_api_client/models/column_type.py +0 -14
  148. orca_sdk/_generated_api_client/models/constraint_violation_error_response.py +0 -81
  149. orca_sdk/_generated_api_client/models/constraint_violation_error_response_status_code.py +0 -8
  150. orca_sdk/_generated_api_client/models/count_predictions_request.py +0 -195
  151. orca_sdk/_generated_api_client/models/create_api_key_request.py +0 -120
  152. orca_sdk/_generated_api_client/models/create_api_key_request_scope_item.py +0 -9
  153. orca_sdk/_generated_api_client/models/create_api_key_response.py +0 -145
  154. orca_sdk/_generated_api_client/models/create_api_key_response_scope_item.py +0 -9
  155. orca_sdk/_generated_api_client/models/create_classification_model_request.py +0 -237
  156. orca_sdk/_generated_api_client/models/create_datasource_from_content_request.py +0 -101
  157. orca_sdk/_generated_api_client/models/create_memoryset_request.py +0 -365
  158. orca_sdk/_generated_api_client/models/create_memoryset_request_index_params.py +0 -66
  159. orca_sdk/_generated_api_client/models/create_memoryset_request_index_type.py +0 -13
  160. orca_sdk/_generated_api_client/models/create_org_plan_request.py +0 -73
  161. orca_sdk/_generated_api_client/models/create_org_plan_request_tier.py +0 -11
  162. orca_sdk/_generated_api_client/models/create_regression_model_request.py +0 -157
  163. orca_sdk/_generated_api_client/models/datasource_metadata.py +0 -156
  164. orca_sdk/_generated_api_client/models/delete_memories_request.py +0 -70
  165. orca_sdk/_generated_api_client/models/delete_memorysets_request.py +0 -70
  166. orca_sdk/_generated_api_client/models/embed_request.py +0 -155
  167. orca_sdk/_generated_api_client/models/embedding_evaluation_payload.py +0 -205
  168. orca_sdk/_generated_api_client/models/embedding_evaluation_request.py +0 -197
  169. orca_sdk/_generated_api_client/models/embedding_evaluation_response.py +0 -158
  170. orca_sdk/_generated_api_client/models/embedding_evaluation_result.py +0 -86
  171. orca_sdk/_generated_api_client/models/embedding_finetuning_method.py +0 -9
  172. orca_sdk/_generated_api_client/models/embedding_model_result.py +0 -123
  173. orca_sdk/_generated_api_client/models/evaluation_response.py +0 -153
  174. orca_sdk/_generated_api_client/models/evaluation_response_classification_metrics.py +0 -140
  175. orca_sdk/_generated_api_client/models/evaluation_response_regression_metrics.py +0 -140
  176. orca_sdk/_generated_api_client/models/feedback_metrics.py +0 -85
  177. orca_sdk/_generated_api_client/models/feedback_type.py +0 -9
  178. orca_sdk/_generated_api_client/models/filter_item.py +0 -239
  179. orca_sdk/_generated_api_client/models/filter_item_field_type_0_item.py +0 -17
  180. orca_sdk/_generated_api_client/models/filter_item_field_type_1_item_type_0.py +0 -8
  181. orca_sdk/_generated_api_client/models/filter_item_field_type_2_item_type_0.py +0 -8
  182. orca_sdk/_generated_api_client/models/filter_item_field_type_2_item_type_1.py +0 -22
  183. orca_sdk/_generated_api_client/models/filter_item_op.py +0 -16
  184. orca_sdk/_generated_api_client/models/finetune_embedding_model_request.py +0 -259
  185. orca_sdk/_generated_api_client/models/finetune_embedding_model_request_training_args.py +0 -66
  186. orca_sdk/_generated_api_client/models/finetuned_embedding_model_metadata.py +0 -166
  187. orca_sdk/_generated_api_client/models/get_memories_request.py +0 -70
  188. orca_sdk/_generated_api_client/models/http_validation_error.py +0 -86
  189. orca_sdk/_generated_api_client/models/internal_server_error_response.py +0 -81
  190. orca_sdk/_generated_api_client/models/internal_server_error_response_status_code.py +0 -8
  191. orca_sdk/_generated_api_client/models/label_class_metrics.py +0 -108
  192. orca_sdk/_generated_api_client/models/label_prediction_memory_lookup.py +0 -210
  193. orca_sdk/_generated_api_client/models/label_prediction_memory_lookup_metadata.py +0 -68
  194. orca_sdk/_generated_api_client/models/label_prediction_with_memories_and_feedback.py +0 -288
  195. orca_sdk/_generated_api_client/models/labeled_memory.py +0 -186
  196. orca_sdk/_generated_api_client/models/labeled_memory_insert.py +0 -128
  197. orca_sdk/_generated_api_client/models/labeled_memory_insert_metadata.py +0 -68
  198. orca_sdk/_generated_api_client/models/labeled_memory_lookup.py +0 -194
  199. orca_sdk/_generated_api_client/models/labeled_memory_lookup_metadata.py +0 -68
  200. orca_sdk/_generated_api_client/models/labeled_memory_metadata.py +0 -68
  201. orca_sdk/_generated_api_client/models/labeled_memory_update.py +0 -171
  202. orca_sdk/_generated_api_client/models/labeled_memory_update_metadata_type_0.py +0 -68
  203. orca_sdk/_generated_api_client/models/labeled_memory_with_feedback_metrics.py +0 -207
  204. orca_sdk/_generated_api_client/models/labeled_memory_with_feedback_metrics_feedback_metrics.py +0 -68
  205. orca_sdk/_generated_api_client/models/labeled_memory_with_feedback_metrics_metadata.py +0 -68
  206. orca_sdk/_generated_api_client/models/list_memories_request.py +0 -104
  207. orca_sdk/_generated_api_client/models/list_predictions_request.py +0 -319
  208. orca_sdk/_generated_api_client/models/lookup_request.py +0 -101
  209. orca_sdk/_generated_api_client/models/lookup_score_metrics.py +0 -94
  210. orca_sdk/_generated_api_client/models/memory_metrics.py +0 -263
  211. orca_sdk/_generated_api_client/models/memory_type.py +0 -9
  212. orca_sdk/_generated_api_client/models/memoryset_analysis_configs.py +0 -245
  213. orca_sdk/_generated_api_client/models/memoryset_analysis_request.py +0 -105
  214. orca_sdk/_generated_api_client/models/memoryset_analysis_response.py +0 -182
  215. orca_sdk/_generated_api_client/models/memoryset_class_patterns_analysis_config.py +0 -79
  216. orca_sdk/_generated_api_client/models/memoryset_class_patterns_metrics.py +0 -138
  217. orca_sdk/_generated_api_client/models/memoryset_cluster_analysis_config.py +0 -202
  218. orca_sdk/_generated_api_client/models/memoryset_cluster_analysis_config_clustering_method.py +0 -9
  219. orca_sdk/_generated_api_client/models/memoryset_cluster_analysis_config_partitioning_method.py +0 -10
  220. orca_sdk/_generated_api_client/models/memoryset_cluster_metrics.py +0 -100
  221. orca_sdk/_generated_api_client/models/memoryset_duplicate_analysis_config.py +0 -70
  222. orca_sdk/_generated_api_client/models/memoryset_duplicate_metrics.py +0 -70
  223. orca_sdk/_generated_api_client/models/memoryset_label_analysis_config.py +0 -70
  224. orca_sdk/_generated_api_client/models/memoryset_label_metrics.py +0 -116
  225. orca_sdk/_generated_api_client/models/memoryset_metadata.py +0 -333
  226. orca_sdk/_generated_api_client/models/memoryset_metadata_index_params.py +0 -55
  227. orca_sdk/_generated_api_client/models/memoryset_metadata_index_type.py +0 -13
  228. orca_sdk/_generated_api_client/models/memoryset_metrics.py +0 -265
  229. orca_sdk/_generated_api_client/models/memoryset_neighbor_analysis_config.py +0 -83
  230. orca_sdk/_generated_api_client/models/memoryset_neighbor_metrics.py +0 -76
  231. orca_sdk/_generated_api_client/models/memoryset_neighbor_metrics_lookup_score_metrics.py +0 -68
  232. orca_sdk/_generated_api_client/models/memoryset_projection_analysis_config.py +0 -79
  233. orca_sdk/_generated_api_client/models/memoryset_projection_metrics.py +0 -55
  234. orca_sdk/_generated_api_client/models/memoryset_update.py +0 -121
  235. orca_sdk/_generated_api_client/models/not_found_error_response.py +0 -99
  236. orca_sdk/_generated_api_client/models/not_found_error_response_resource_type_0.py +0 -23
  237. orca_sdk/_generated_api_client/models/not_found_error_response_status_code.py +0 -8
  238. orca_sdk/_generated_api_client/models/org_plan.py +0 -99
  239. orca_sdk/_generated_api_client/models/org_plan_tier.py +0 -11
  240. orca_sdk/_generated_api_client/models/paginated_task.py +0 -108
  241. orca_sdk/_generated_api_client/models/paginated_union_labeled_memory_with_feedback_metrics_scored_memory_with_feedback_metrics.py +0 -135
  242. orca_sdk/_generated_api_client/models/pr_curve.py +0 -86
  243. orca_sdk/_generated_api_client/models/prediction_feedback.py +0 -157
  244. orca_sdk/_generated_api_client/models/prediction_feedback_category.py +0 -115
  245. orca_sdk/_generated_api_client/models/prediction_feedback_request.py +0 -122
  246. orca_sdk/_generated_api_client/models/prediction_feedback_result.py +0 -102
  247. orca_sdk/_generated_api_client/models/prediction_sort_item_item_type_0.py +0 -10
  248. orca_sdk/_generated_api_client/models/prediction_sort_item_item_type_1.py +0 -9
  249. orca_sdk/_generated_api_client/models/predictive_model_update.py +0 -111
  250. orca_sdk/_generated_api_client/models/pretrained_embedding_model_metadata.py +0 -115
  251. orca_sdk/_generated_api_client/models/pretrained_embedding_model_name.py +0 -17
  252. orca_sdk/_generated_api_client/models/rac_head_type.py +0 -11
  253. orca_sdk/_generated_api_client/models/rar_head_type.py +0 -8
  254. orca_sdk/_generated_api_client/models/regression_evaluation_request.py +0 -148
  255. orca_sdk/_generated_api_client/models/regression_metrics.py +0 -172
  256. orca_sdk/_generated_api_client/models/regression_model_metadata.py +0 -191
  257. orca_sdk/_generated_api_client/models/regression_prediction_request.py +0 -195
  258. orca_sdk/_generated_api_client/models/roc_curve.py +0 -86
  259. orca_sdk/_generated_api_client/models/score_prediction_memory_lookup.py +0 -196
  260. orca_sdk/_generated_api_client/models/score_prediction_memory_lookup_metadata.py +0 -68
  261. orca_sdk/_generated_api_client/models/score_prediction_with_memories_and_feedback.py +0 -252
  262. orca_sdk/_generated_api_client/models/scored_memory.py +0 -172
  263. orca_sdk/_generated_api_client/models/scored_memory_insert.py +0 -128
  264. orca_sdk/_generated_api_client/models/scored_memory_insert_metadata.py +0 -68
  265. orca_sdk/_generated_api_client/models/scored_memory_lookup.py +0 -180
  266. orca_sdk/_generated_api_client/models/scored_memory_lookup_metadata.py +0 -68
  267. orca_sdk/_generated_api_client/models/scored_memory_metadata.py +0 -68
  268. orca_sdk/_generated_api_client/models/scored_memory_update.py +0 -171
  269. orca_sdk/_generated_api_client/models/scored_memory_update_metadata_type_0.py +0 -68
  270. orca_sdk/_generated_api_client/models/scored_memory_with_feedback_metrics.py +0 -193
  271. orca_sdk/_generated_api_client/models/scored_memory_with_feedback_metrics_feedback_metrics.py +0 -68
  272. orca_sdk/_generated_api_client/models/scored_memory_with_feedback_metrics_metadata.py +0 -68
  273. orca_sdk/_generated_api_client/models/service_unavailable_error_response.py +0 -81
  274. orca_sdk/_generated_api_client/models/service_unavailable_error_response_status_code.py +0 -8
  275. orca_sdk/_generated_api_client/models/task.py +0 -198
  276. orca_sdk/_generated_api_client/models/task_status.py +0 -14
  277. orca_sdk/_generated_api_client/models/task_status_info.py +0 -133
  278. orca_sdk/_generated_api_client/models/telemetry_field_type_0_item_type_0.py +0 -8
  279. orca_sdk/_generated_api_client/models/telemetry_field_type_0_item_type_2.py +0 -9
  280. orca_sdk/_generated_api_client/models/telemetry_field_type_1_item_type_0.py +0 -8
  281. orca_sdk/_generated_api_client/models/telemetry_field_type_1_item_type_1.py +0 -8
  282. orca_sdk/_generated_api_client/models/telemetry_filter_item.py +0 -217
  283. orca_sdk/_generated_api_client/models/telemetry_filter_item_op.py +0 -15
  284. orca_sdk/_generated_api_client/models/telemetry_memories_request.py +0 -181
  285. orca_sdk/_generated_api_client/models/telemetry_sort_options.py +0 -185
  286. orca_sdk/_generated_api_client/models/telemetry_sort_options_direction.py +0 -9
  287. orca_sdk/_generated_api_client/models/unauthenticated_error_response.py +0 -73
  288. orca_sdk/_generated_api_client/models/unauthenticated_error_response_status_code.py +0 -8
  289. orca_sdk/_generated_api_client/models/unauthorized_error_response.py +0 -81
  290. orca_sdk/_generated_api_client/models/unauthorized_error_response_status_code.py +0 -8
  291. orca_sdk/_generated_api_client/models/update_org_plan_request.py +0 -73
  292. orca_sdk/_generated_api_client/models/update_org_plan_request_tier.py +0 -11
  293. orca_sdk/_generated_api_client/models/update_prediction_request.py +0 -133
  294. orca_sdk/_generated_api_client/models/validation_error.py +0 -99
  295. orca_sdk/_generated_api_client/py.typed +0 -1
  296. orca_sdk/_generated_api_client/types.py +0 -56
  297. orca_sdk-0.0.97.dist-info/RECORD +0 -309
  298. {orca_sdk-0.0.97.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"""