mirascope 1.25.7__py3-none-any.whl → 2.0.0a0__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 (474) hide show
  1. mirascope/__init__.py +3 -59
  2. mirascope/graphs/__init__.py +22 -0
  3. mirascope/{experimental/graphs → graphs}/finite_state_machine.py +70 -159
  4. mirascope/llm/__init__.py +206 -16
  5. mirascope/llm/agents/__init__.py +15 -0
  6. mirascope/llm/agents/agent.py +97 -0
  7. mirascope/llm/agents/agent_template.py +45 -0
  8. mirascope/llm/agents/decorator.py +176 -0
  9. mirascope/llm/calls/__init__.py +16 -0
  10. mirascope/llm/calls/base_call.py +33 -0
  11. mirascope/llm/calls/calls.py +315 -0
  12. mirascope/llm/calls/decorator.py +255 -0
  13. mirascope/llm/clients/__init__.py +34 -0
  14. mirascope/llm/clients/anthropic/__init__.py +11 -0
  15. mirascope/llm/clients/anthropic/_utils/__init__.py +13 -0
  16. mirascope/llm/clients/anthropic/_utils/decode.py +244 -0
  17. mirascope/llm/clients/anthropic/_utils/encode.py +243 -0
  18. mirascope/llm/clients/anthropic/clients.py +819 -0
  19. mirascope/llm/clients/anthropic/model_ids.py +8 -0
  20. mirascope/llm/clients/base/__init__.py +15 -0
  21. mirascope/llm/clients/base/_utils.py +192 -0
  22. mirascope/llm/clients/base/client.py +1256 -0
  23. mirascope/llm/clients/base/kwargs.py +12 -0
  24. mirascope/llm/clients/base/params.py +93 -0
  25. mirascope/llm/clients/google/__init__.py +6 -0
  26. mirascope/llm/clients/google/_utils/__init__.py +13 -0
  27. mirascope/llm/clients/google/_utils/decode.py +231 -0
  28. mirascope/llm/clients/google/_utils/encode.py +279 -0
  29. mirascope/llm/clients/google/clients.py +853 -0
  30. mirascope/llm/clients/google/message.py +7 -0
  31. mirascope/llm/clients/google/model_ids.py +15 -0
  32. mirascope/llm/clients/openai/__init__.py +25 -0
  33. mirascope/llm/clients/openai/completions/__init__.py +9 -0
  34. mirascope/llm/clients/openai/completions/_utils/__init__.py +13 -0
  35. mirascope/llm/clients/openai/completions/_utils/decode.py +187 -0
  36. mirascope/llm/clients/openai/completions/_utils/encode.py +358 -0
  37. mirascope/llm/clients/openai/completions/_utils/model_features.py +81 -0
  38. mirascope/llm/clients/openai/completions/clients.py +833 -0
  39. mirascope/llm/clients/openai/completions/model_ids.py +8 -0
  40. mirascope/llm/clients/openai/responses/__init__.py +9 -0
  41. mirascope/llm/clients/openai/responses/_utils/__init__.py +13 -0
  42. mirascope/llm/clients/openai/responses/_utils/decode.py +194 -0
  43. mirascope/llm/clients/openai/responses/_utils/encode.py +333 -0
  44. mirascope/llm/clients/openai/responses/_utils/model_features.py +87 -0
  45. mirascope/llm/clients/openai/responses/clients.py +832 -0
  46. mirascope/llm/clients/openai/responses/model_ids.py +8 -0
  47. mirascope/llm/clients/openai/shared/__init__.py +7 -0
  48. mirascope/llm/clients/openai/shared/_utils.py +55 -0
  49. mirascope/llm/clients/providers.py +175 -0
  50. mirascope/llm/content/__init__.py +70 -0
  51. mirascope/llm/content/audio.py +173 -0
  52. mirascope/llm/content/document.py +94 -0
  53. mirascope/llm/content/image.py +206 -0
  54. mirascope/llm/content/text.py +47 -0
  55. mirascope/llm/content/thought.py +58 -0
  56. mirascope/llm/content/tool_call.py +63 -0
  57. mirascope/llm/content/tool_output.py +26 -0
  58. mirascope/llm/context/__init__.py +6 -0
  59. mirascope/llm/context/_utils.py +28 -0
  60. mirascope/llm/context/context.py +24 -0
  61. mirascope/llm/exceptions.py +105 -0
  62. mirascope/llm/formatting/__init__.py +22 -0
  63. mirascope/llm/formatting/_utils.py +74 -0
  64. mirascope/llm/formatting/format.py +104 -0
  65. mirascope/llm/formatting/from_call_args.py +30 -0
  66. mirascope/llm/formatting/partial.py +58 -0
  67. mirascope/llm/formatting/types.py +109 -0
  68. mirascope/llm/mcp/__init__.py +5 -0
  69. mirascope/llm/mcp/client.py +118 -0
  70. mirascope/llm/messages/__init__.py +32 -0
  71. mirascope/llm/messages/message.py +182 -0
  72. mirascope/llm/models/__init__.py +16 -0
  73. mirascope/llm/models/models.py +1243 -0
  74. mirascope/llm/prompts/__init__.py +33 -0
  75. mirascope/llm/prompts/_utils.py +60 -0
  76. mirascope/llm/prompts/decorator.py +286 -0
  77. mirascope/llm/prompts/protocols.py +99 -0
  78. mirascope/llm/responses/__init__.py +57 -0
  79. mirascope/llm/responses/_utils.py +56 -0
  80. mirascope/llm/responses/base_response.py +91 -0
  81. mirascope/llm/responses/base_stream_response.py +697 -0
  82. mirascope/llm/responses/finish_reason.py +27 -0
  83. mirascope/llm/responses/response.py +345 -0
  84. mirascope/llm/responses/root_response.py +177 -0
  85. mirascope/llm/responses/stream_response.py +572 -0
  86. mirascope/llm/responses/streams.py +363 -0
  87. mirascope/llm/tools/__init__.py +40 -0
  88. mirascope/llm/tools/_utils.py +25 -0
  89. mirascope/llm/tools/decorator.py +175 -0
  90. mirascope/llm/tools/protocols.py +96 -0
  91. mirascope/llm/tools/tool_schema.py +246 -0
  92. mirascope/llm/tools/toolkit.py +152 -0
  93. mirascope/llm/tools/tools.py +169 -0
  94. mirascope/llm/types/__init__.py +22 -0
  95. mirascope/llm/types/dataclass.py +9 -0
  96. mirascope/llm/types/jsonable.py +44 -0
  97. mirascope/llm/types/type_vars.py +19 -0
  98. mirascope-2.0.0a0.dist-info/METADATA +117 -0
  99. mirascope-2.0.0a0.dist-info/RECORD +101 -0
  100. mirascope/beta/__init__.py +0 -3
  101. mirascope/beta/openai/__init__.py +0 -17
  102. mirascope/beta/openai/realtime/__init__.py +0 -13
  103. mirascope/beta/openai/realtime/_utils/__init__.py +0 -3
  104. mirascope/beta/openai/realtime/_utils/_audio.py +0 -74
  105. mirascope/beta/openai/realtime/_utils/_protocols.py +0 -50
  106. mirascope/beta/openai/realtime/realtime.py +0 -500
  107. mirascope/beta/openai/realtime/recording.py +0 -98
  108. mirascope/beta/openai/realtime/tool.py +0 -113
  109. mirascope/beta/rag/__init__.py +0 -24
  110. mirascope/beta/rag/base/__init__.py +0 -22
  111. mirascope/beta/rag/base/chunkers/__init__.py +0 -2
  112. mirascope/beta/rag/base/chunkers/base_chunker.py +0 -37
  113. mirascope/beta/rag/base/chunkers/text_chunker.py +0 -33
  114. mirascope/beta/rag/base/config.py +0 -8
  115. mirascope/beta/rag/base/document.py +0 -11
  116. mirascope/beta/rag/base/embedders.py +0 -35
  117. mirascope/beta/rag/base/embedding_params.py +0 -18
  118. mirascope/beta/rag/base/embedding_response.py +0 -30
  119. mirascope/beta/rag/base/query_results.py +0 -7
  120. mirascope/beta/rag/base/vectorstore_params.py +0 -18
  121. mirascope/beta/rag/base/vectorstores.py +0 -37
  122. mirascope/beta/rag/chroma/__init__.py +0 -11
  123. mirascope/beta/rag/chroma/types.py +0 -62
  124. mirascope/beta/rag/chroma/vectorstores.py +0 -121
  125. mirascope/beta/rag/cohere/__init__.py +0 -11
  126. mirascope/beta/rag/cohere/embedders.py +0 -87
  127. mirascope/beta/rag/cohere/embedding_params.py +0 -29
  128. mirascope/beta/rag/cohere/embedding_response.py +0 -29
  129. mirascope/beta/rag/cohere/py.typed +0 -0
  130. mirascope/beta/rag/openai/__init__.py +0 -11
  131. mirascope/beta/rag/openai/embedders.py +0 -144
  132. mirascope/beta/rag/openai/embedding_params.py +0 -18
  133. mirascope/beta/rag/openai/embedding_response.py +0 -14
  134. mirascope/beta/rag/openai/py.typed +0 -0
  135. mirascope/beta/rag/pinecone/__init__.py +0 -19
  136. mirascope/beta/rag/pinecone/types.py +0 -143
  137. mirascope/beta/rag/pinecone/vectorstores.py +0 -148
  138. mirascope/beta/rag/weaviate/__init__.py +0 -6
  139. mirascope/beta/rag/weaviate/types.py +0 -92
  140. mirascope/beta/rag/weaviate/vectorstores.py +0 -103
  141. mirascope/core/__init__.py +0 -109
  142. mirascope/core/anthropic/__init__.py +0 -31
  143. mirascope/core/anthropic/_call.py +0 -67
  144. mirascope/core/anthropic/_call_kwargs.py +0 -13
  145. mirascope/core/anthropic/_thinking.py +0 -70
  146. mirascope/core/anthropic/_utils/__init__.py +0 -16
  147. mirascope/core/anthropic/_utils/_convert_common_call_params.py +0 -25
  148. mirascope/core/anthropic/_utils/_convert_finish_reason_to_common_finish_reasons.py +0 -21
  149. mirascope/core/anthropic/_utils/_convert_message_params.py +0 -102
  150. mirascope/core/anthropic/_utils/_get_json_output.py +0 -31
  151. mirascope/core/anthropic/_utils/_handle_stream.py +0 -113
  152. mirascope/core/anthropic/_utils/_message_param_converter.py +0 -154
  153. mirascope/core/anthropic/_utils/_setup_call.py +0 -146
  154. mirascope/core/anthropic/call_params.py +0 -44
  155. mirascope/core/anthropic/call_response.py +0 -226
  156. mirascope/core/anthropic/call_response_chunk.py +0 -152
  157. mirascope/core/anthropic/dynamic_config.py +0 -40
  158. mirascope/core/anthropic/py.typed +0 -0
  159. mirascope/core/anthropic/stream.py +0 -204
  160. mirascope/core/anthropic/tool.py +0 -101
  161. mirascope/core/azure/__init__.py +0 -31
  162. mirascope/core/azure/_call.py +0 -67
  163. mirascope/core/azure/_call_kwargs.py +0 -13
  164. mirascope/core/azure/_utils/__init__.py +0 -14
  165. mirascope/core/azure/_utils/_convert_common_call_params.py +0 -26
  166. mirascope/core/azure/_utils/_convert_finish_reason_to_common_finish_reasons.py +0 -21
  167. mirascope/core/azure/_utils/_convert_message_params.py +0 -121
  168. mirascope/core/azure/_utils/_get_credential.py +0 -33
  169. mirascope/core/azure/_utils/_get_json_output.py +0 -27
  170. mirascope/core/azure/_utils/_handle_stream.py +0 -130
  171. mirascope/core/azure/_utils/_message_param_converter.py +0 -117
  172. mirascope/core/azure/_utils/_setup_call.py +0 -183
  173. mirascope/core/azure/call_params.py +0 -59
  174. mirascope/core/azure/call_response.py +0 -215
  175. mirascope/core/azure/call_response_chunk.py +0 -105
  176. mirascope/core/azure/dynamic_config.py +0 -30
  177. mirascope/core/azure/py.typed +0 -0
  178. mirascope/core/azure/stream.py +0 -147
  179. mirascope/core/azure/tool.py +0 -93
  180. mirascope/core/base/__init__.py +0 -86
  181. mirascope/core/base/_call_factory.py +0 -256
  182. mirascope/core/base/_create.py +0 -253
  183. mirascope/core/base/_extract.py +0 -175
  184. mirascope/core/base/_extract_with_tools.py +0 -189
  185. mirascope/core/base/_partial.py +0 -95
  186. mirascope/core/base/_utils/__init__.py +0 -92
  187. mirascope/core/base/_utils/_base_message_param_converter.py +0 -22
  188. mirascope/core/base/_utils/_base_type.py +0 -26
  189. mirascope/core/base/_utils/_convert_base_model_to_base_tool.py +0 -48
  190. mirascope/core/base/_utils/_convert_base_type_to_base_tool.py +0 -24
  191. mirascope/core/base/_utils/_convert_function_to_base_tool.py +0 -139
  192. mirascope/core/base/_utils/_convert_messages_to_message_params.py +0 -178
  193. mirascope/core/base/_utils/_convert_provider_finish_reason_to_finish_reason.py +0 -20
  194. mirascope/core/base/_utils/_default_tool_docstring.py +0 -6
  195. mirascope/core/base/_utils/_extract_tool_return.py +0 -42
  196. mirascope/core/base/_utils/_fn_is_async.py +0 -24
  197. mirascope/core/base/_utils/_format_template.py +0 -32
  198. mirascope/core/base/_utils/_get_audio_type.py +0 -18
  199. mirascope/core/base/_utils/_get_common_usage.py +0 -20
  200. mirascope/core/base/_utils/_get_create_fn_or_async_create_fn.py +0 -137
  201. mirascope/core/base/_utils/_get_document_type.py +0 -7
  202. mirascope/core/base/_utils/_get_dynamic_configuration.py +0 -69
  203. mirascope/core/base/_utils/_get_fields_from_call_args.py +0 -34
  204. mirascope/core/base/_utils/_get_fn_args.py +0 -23
  205. mirascope/core/base/_utils/_get_image_dimensions.py +0 -39
  206. mirascope/core/base/_utils/_get_image_type.py +0 -26
  207. mirascope/core/base/_utils/_get_metadata.py +0 -17
  208. mirascope/core/base/_utils/_get_possible_user_message_param.py +0 -21
  209. mirascope/core/base/_utils/_get_prompt_template.py +0 -28
  210. mirascope/core/base/_utils/_get_template_values.py +0 -51
  211. mirascope/core/base/_utils/_get_template_variables.py +0 -38
  212. mirascope/core/base/_utils/_get_unsupported_tool_config_keys.py +0 -10
  213. mirascope/core/base/_utils/_is_prompt_template.py +0 -24
  214. mirascope/core/base/_utils/_json_mode_content.py +0 -17
  215. mirascope/core/base/_utils/_messages_decorator.py +0 -121
  216. mirascope/core/base/_utils/_parse_content_template.py +0 -323
  217. mirascope/core/base/_utils/_parse_prompt_messages.py +0 -63
  218. mirascope/core/base/_utils/_pil_image_to_bytes.py +0 -13
  219. mirascope/core/base/_utils/_protocols.py +0 -901
  220. mirascope/core/base/_utils/_setup_call.py +0 -79
  221. mirascope/core/base/_utils/_setup_extract_tool.py +0 -30
  222. mirascope/core/base/call_kwargs.py +0 -13
  223. mirascope/core/base/call_params.py +0 -36
  224. mirascope/core/base/call_response.py +0 -338
  225. mirascope/core/base/call_response_chunk.py +0 -130
  226. mirascope/core/base/dynamic_config.py +0 -82
  227. mirascope/core/base/from_call_args.py +0 -30
  228. mirascope/core/base/merge_decorators.py +0 -59
  229. mirascope/core/base/message_param.py +0 -175
  230. mirascope/core/base/messages.py +0 -116
  231. mirascope/core/base/metadata.py +0 -13
  232. mirascope/core/base/prompt.py +0 -497
  233. mirascope/core/base/response_model_config_dict.py +0 -9
  234. mirascope/core/base/stream.py +0 -479
  235. mirascope/core/base/stream_config.py +0 -11
  236. mirascope/core/base/structured_stream.py +0 -296
  237. mirascope/core/base/tool.py +0 -214
  238. mirascope/core/base/toolkit.py +0 -176
  239. mirascope/core/base/types.py +0 -344
  240. mirascope/core/bedrock/__init__.py +0 -34
  241. mirascope/core/bedrock/_call.py +0 -68
  242. mirascope/core/bedrock/_call_kwargs.py +0 -12
  243. mirascope/core/bedrock/_types.py +0 -104
  244. mirascope/core/bedrock/_utils/__init__.py +0 -14
  245. mirascope/core/bedrock/_utils/_convert_common_call_params.py +0 -39
  246. mirascope/core/bedrock/_utils/_convert_finish_reason_to_common_finish_reasons.py +0 -23
  247. mirascope/core/bedrock/_utils/_convert_message_params.py +0 -111
  248. mirascope/core/bedrock/_utils/_get_json_output.py +0 -30
  249. mirascope/core/bedrock/_utils/_handle_stream.py +0 -104
  250. mirascope/core/bedrock/_utils/_message_param_converter.py +0 -172
  251. mirascope/core/bedrock/_utils/_setup_call.py +0 -258
  252. mirascope/core/bedrock/call_params.py +0 -38
  253. mirascope/core/bedrock/call_response.py +0 -248
  254. mirascope/core/bedrock/call_response_chunk.py +0 -111
  255. mirascope/core/bedrock/dynamic_config.py +0 -37
  256. mirascope/core/bedrock/py.typed +0 -0
  257. mirascope/core/bedrock/stream.py +0 -154
  258. mirascope/core/bedrock/tool.py +0 -100
  259. mirascope/core/cohere/__init__.py +0 -30
  260. mirascope/core/cohere/_call.py +0 -67
  261. mirascope/core/cohere/_call_kwargs.py +0 -11
  262. mirascope/core/cohere/_types.py +0 -20
  263. mirascope/core/cohere/_utils/__init__.py +0 -14
  264. mirascope/core/cohere/_utils/_convert_common_call_params.py +0 -26
  265. mirascope/core/cohere/_utils/_convert_finish_reason_to_common_finish_reasons.py +0 -24
  266. mirascope/core/cohere/_utils/_convert_message_params.py +0 -32
  267. mirascope/core/cohere/_utils/_get_json_output.py +0 -30
  268. mirascope/core/cohere/_utils/_handle_stream.py +0 -35
  269. mirascope/core/cohere/_utils/_message_param_converter.py +0 -54
  270. mirascope/core/cohere/_utils/_setup_call.py +0 -150
  271. mirascope/core/cohere/call_params.py +0 -62
  272. mirascope/core/cohere/call_response.py +0 -205
  273. mirascope/core/cohere/call_response_chunk.py +0 -125
  274. mirascope/core/cohere/dynamic_config.py +0 -32
  275. mirascope/core/cohere/py.typed +0 -0
  276. mirascope/core/cohere/stream.py +0 -113
  277. mirascope/core/cohere/tool.py +0 -93
  278. mirascope/core/costs/__init__.py +0 -5
  279. mirascope/core/costs/_anthropic_calculate_cost.py +0 -219
  280. mirascope/core/costs/_azure_calculate_cost.py +0 -11
  281. mirascope/core/costs/_bedrock_calculate_cost.py +0 -15
  282. mirascope/core/costs/_cohere_calculate_cost.py +0 -44
  283. mirascope/core/costs/_gemini_calculate_cost.py +0 -67
  284. mirascope/core/costs/_google_calculate_cost.py +0 -427
  285. mirascope/core/costs/_groq_calculate_cost.py +0 -156
  286. mirascope/core/costs/_litellm_calculate_cost.py +0 -11
  287. mirascope/core/costs/_mistral_calculate_cost.py +0 -64
  288. mirascope/core/costs/_openai_calculate_cost.py +0 -416
  289. mirascope/core/costs/_vertex_calculate_cost.py +0 -67
  290. mirascope/core/costs/_xai_calculate_cost.py +0 -104
  291. mirascope/core/costs/calculate_cost.py +0 -86
  292. mirascope/core/gemini/__init__.py +0 -40
  293. mirascope/core/gemini/_call.py +0 -67
  294. mirascope/core/gemini/_call_kwargs.py +0 -12
  295. mirascope/core/gemini/_utils/__init__.py +0 -14
  296. mirascope/core/gemini/_utils/_convert_common_call_params.py +0 -39
  297. mirascope/core/gemini/_utils/_convert_finish_reason_to_common_finish_reasons.py +0 -23
  298. mirascope/core/gemini/_utils/_convert_message_params.py +0 -156
  299. mirascope/core/gemini/_utils/_get_json_output.py +0 -35
  300. mirascope/core/gemini/_utils/_handle_stream.py +0 -33
  301. mirascope/core/gemini/_utils/_message_param_converter.py +0 -209
  302. mirascope/core/gemini/_utils/_setup_call.py +0 -149
  303. mirascope/core/gemini/call_params.py +0 -52
  304. mirascope/core/gemini/call_response.py +0 -216
  305. mirascope/core/gemini/call_response_chunk.py +0 -100
  306. mirascope/core/gemini/dynamic_config.py +0 -26
  307. mirascope/core/gemini/stream.py +0 -120
  308. mirascope/core/gemini/tool.py +0 -104
  309. mirascope/core/google/__init__.py +0 -29
  310. mirascope/core/google/_call.py +0 -67
  311. mirascope/core/google/_call_kwargs.py +0 -13
  312. mirascope/core/google/_utils/__init__.py +0 -14
  313. mirascope/core/google/_utils/_convert_common_call_params.py +0 -38
  314. mirascope/core/google/_utils/_convert_finish_reason_to_common_finish_reasons.py +0 -27
  315. mirascope/core/google/_utils/_convert_message_params.py +0 -297
  316. mirascope/core/google/_utils/_get_json_output.py +0 -37
  317. mirascope/core/google/_utils/_handle_stream.py +0 -58
  318. mirascope/core/google/_utils/_message_param_converter.py +0 -200
  319. mirascope/core/google/_utils/_setup_call.py +0 -201
  320. mirascope/core/google/_utils/_validate_media_type.py +0 -58
  321. mirascope/core/google/call_params.py +0 -22
  322. mirascope/core/google/call_response.py +0 -255
  323. mirascope/core/google/call_response_chunk.py +0 -135
  324. mirascope/core/google/dynamic_config.py +0 -26
  325. mirascope/core/google/stream.py +0 -199
  326. mirascope/core/google/tool.py +0 -146
  327. mirascope/core/groq/__init__.py +0 -30
  328. mirascope/core/groq/_call.py +0 -67
  329. mirascope/core/groq/_call_kwargs.py +0 -13
  330. mirascope/core/groq/_utils/__init__.py +0 -14
  331. mirascope/core/groq/_utils/_convert_common_call_params.py +0 -26
  332. mirascope/core/groq/_utils/_convert_message_params.py +0 -112
  333. mirascope/core/groq/_utils/_get_json_output.py +0 -27
  334. mirascope/core/groq/_utils/_handle_stream.py +0 -123
  335. mirascope/core/groq/_utils/_message_param_converter.py +0 -89
  336. mirascope/core/groq/_utils/_setup_call.py +0 -132
  337. mirascope/core/groq/call_params.py +0 -52
  338. mirascope/core/groq/call_response.py +0 -213
  339. mirascope/core/groq/call_response_chunk.py +0 -104
  340. mirascope/core/groq/dynamic_config.py +0 -29
  341. mirascope/core/groq/py.typed +0 -0
  342. mirascope/core/groq/stream.py +0 -135
  343. mirascope/core/groq/tool.py +0 -80
  344. mirascope/core/litellm/__init__.py +0 -28
  345. mirascope/core/litellm/_call.py +0 -67
  346. mirascope/core/litellm/_utils/__init__.py +0 -5
  347. mirascope/core/litellm/_utils/_setup_call.py +0 -109
  348. mirascope/core/litellm/call_params.py +0 -10
  349. mirascope/core/litellm/call_response.py +0 -24
  350. mirascope/core/litellm/call_response_chunk.py +0 -14
  351. mirascope/core/litellm/dynamic_config.py +0 -8
  352. mirascope/core/litellm/py.typed +0 -0
  353. mirascope/core/litellm/stream.py +0 -86
  354. mirascope/core/litellm/tool.py +0 -13
  355. mirascope/core/mistral/__init__.py +0 -36
  356. mirascope/core/mistral/_call.py +0 -65
  357. mirascope/core/mistral/_call_kwargs.py +0 -19
  358. mirascope/core/mistral/_utils/__init__.py +0 -14
  359. mirascope/core/mistral/_utils/_convert_common_call_params.py +0 -24
  360. mirascope/core/mistral/_utils/_convert_finish_reason_to_common_finish_reasons.py +0 -22
  361. mirascope/core/mistral/_utils/_convert_message_params.py +0 -122
  362. mirascope/core/mistral/_utils/_get_json_output.py +0 -34
  363. mirascope/core/mistral/_utils/_handle_stream.py +0 -139
  364. mirascope/core/mistral/_utils/_message_param_converter.py +0 -176
  365. mirascope/core/mistral/_utils/_setup_call.py +0 -164
  366. mirascope/core/mistral/call_params.py +0 -36
  367. mirascope/core/mistral/call_response.py +0 -205
  368. mirascope/core/mistral/call_response_chunk.py +0 -105
  369. mirascope/core/mistral/dynamic_config.py +0 -33
  370. mirascope/core/mistral/py.typed +0 -0
  371. mirascope/core/mistral/stream.py +0 -120
  372. mirascope/core/mistral/tool.py +0 -81
  373. mirascope/core/openai/__init__.py +0 -31
  374. mirascope/core/openai/_call.py +0 -67
  375. mirascope/core/openai/_call_kwargs.py +0 -13
  376. mirascope/core/openai/_utils/__init__.py +0 -14
  377. mirascope/core/openai/_utils/_convert_common_call_params.py +0 -26
  378. mirascope/core/openai/_utils/_convert_message_params.py +0 -148
  379. mirascope/core/openai/_utils/_get_json_output.py +0 -31
  380. mirascope/core/openai/_utils/_handle_stream.py +0 -138
  381. mirascope/core/openai/_utils/_message_param_converter.py +0 -105
  382. mirascope/core/openai/_utils/_setup_call.py +0 -155
  383. mirascope/core/openai/call_params.py +0 -92
  384. mirascope/core/openai/call_response.py +0 -273
  385. mirascope/core/openai/call_response_chunk.py +0 -139
  386. mirascope/core/openai/dynamic_config.py +0 -34
  387. mirascope/core/openai/py.typed +0 -0
  388. mirascope/core/openai/stream.py +0 -185
  389. mirascope/core/openai/tool.py +0 -101
  390. mirascope/core/py.typed +0 -0
  391. mirascope/core/vertex/__init__.py +0 -45
  392. mirascope/core/vertex/_call.py +0 -62
  393. mirascope/core/vertex/_call_kwargs.py +0 -12
  394. mirascope/core/vertex/_utils/__init__.py +0 -14
  395. mirascope/core/vertex/_utils/_convert_common_call_params.py +0 -37
  396. mirascope/core/vertex/_utils/_convert_finish_reason_to_common_finish_reasons.py +0 -23
  397. mirascope/core/vertex/_utils/_convert_message_params.py +0 -171
  398. mirascope/core/vertex/_utils/_get_json_output.py +0 -36
  399. mirascope/core/vertex/_utils/_handle_stream.py +0 -33
  400. mirascope/core/vertex/_utils/_message_param_converter.py +0 -133
  401. mirascope/core/vertex/_utils/_setup_call.py +0 -160
  402. mirascope/core/vertex/call_params.py +0 -24
  403. mirascope/core/vertex/call_response.py +0 -206
  404. mirascope/core/vertex/call_response_chunk.py +0 -99
  405. mirascope/core/vertex/dynamic_config.py +0 -28
  406. mirascope/core/vertex/stream.py +0 -119
  407. mirascope/core/vertex/tool.py +0 -101
  408. mirascope/core/xai/__init__.py +0 -28
  409. mirascope/core/xai/_call.py +0 -67
  410. mirascope/core/xai/_utils/__init__.py +0 -5
  411. mirascope/core/xai/_utils/_setup_call.py +0 -113
  412. mirascope/core/xai/call_params.py +0 -10
  413. mirascope/core/xai/call_response.py +0 -16
  414. mirascope/core/xai/call_response_chunk.py +0 -14
  415. mirascope/core/xai/dynamic_config.py +0 -8
  416. mirascope/core/xai/py.typed +0 -0
  417. mirascope/core/xai/stream.py +0 -57
  418. mirascope/core/xai/tool.py +0 -13
  419. mirascope/experimental/graphs/__init__.py +0 -5
  420. mirascope/integrations/__init__.py +0 -16
  421. mirascope/integrations/_middleware_factory.py +0 -403
  422. mirascope/integrations/langfuse/__init__.py +0 -3
  423. mirascope/integrations/langfuse/_utils.py +0 -114
  424. mirascope/integrations/langfuse/_with_langfuse.py +0 -70
  425. mirascope/integrations/logfire/__init__.py +0 -3
  426. mirascope/integrations/logfire/_utils.py +0 -225
  427. mirascope/integrations/logfire/_with_logfire.py +0 -63
  428. mirascope/integrations/otel/__init__.py +0 -10
  429. mirascope/integrations/otel/_utils.py +0 -270
  430. mirascope/integrations/otel/_with_hyperdx.py +0 -60
  431. mirascope/integrations/otel/_with_otel.py +0 -59
  432. mirascope/integrations/tenacity.py +0 -14
  433. mirascope/llm/_call.py +0 -401
  434. mirascope/llm/_context.py +0 -384
  435. mirascope/llm/_override.py +0 -3639
  436. mirascope/llm/_protocols.py +0 -500
  437. mirascope/llm/_response_metaclass.py +0 -31
  438. mirascope/llm/call_response.py +0 -158
  439. mirascope/llm/call_response_chunk.py +0 -66
  440. mirascope/llm/stream.py +0 -162
  441. mirascope/llm/tool.py +0 -64
  442. mirascope/mcp/__init__.py +0 -7
  443. mirascope/mcp/_utils.py +0 -288
  444. mirascope/mcp/client.py +0 -167
  445. mirascope/mcp/server.py +0 -356
  446. mirascope/mcp/tools.py +0 -110
  447. mirascope/py.typed +0 -0
  448. mirascope/retries/__init__.py +0 -11
  449. mirascope/retries/fallback.py +0 -131
  450. mirascope/retries/tenacity.py +0 -50
  451. mirascope/tools/__init__.py +0 -37
  452. mirascope/tools/base.py +0 -98
  453. mirascope/tools/system/__init__.py +0 -0
  454. mirascope/tools/system/_docker_operation.py +0 -166
  455. mirascope/tools/system/_file_system.py +0 -267
  456. mirascope/tools/web/__init__.py +0 -0
  457. mirascope/tools/web/_duckduckgo.py +0 -111
  458. mirascope/tools/web/_httpx.py +0 -125
  459. mirascope/tools/web/_parse_url_content.py +0 -94
  460. mirascope/tools/web/_requests.py +0 -54
  461. mirascope/v0/__init__.py +0 -43
  462. mirascope/v0/anthropic.py +0 -54
  463. mirascope/v0/base/__init__.py +0 -12
  464. mirascope/v0/base/calls.py +0 -118
  465. mirascope/v0/base/extractors.py +0 -122
  466. mirascope/v0/base/ops_utils.py +0 -207
  467. mirascope/v0/base/prompts.py +0 -48
  468. mirascope/v0/base/types.py +0 -14
  469. mirascope/v0/base/utils.py +0 -21
  470. mirascope/v0/openai.py +0 -54
  471. mirascope-1.25.7.dist-info/METADATA +0 -169
  472. mirascope-1.25.7.dist-info/RECORD +0 -378
  473. {mirascope-1.25.7.dist-info → mirascope-2.0.0a0.dist-info}/WHEEL +0 -0
  474. {mirascope-1.25.7.dist-info → mirascope-2.0.0a0.dist-info}/licenses/LICENSE +0 -0
@@ -1,901 +0,0 @@
1
- """Protocols for reusable type hints."""
2
-
3
- from collections.abc import (
4
- AsyncGenerator,
5
- AsyncIterable,
6
- Awaitable,
7
- Callable,
8
- Coroutine,
9
- Generator,
10
- Iterable,
11
- )
12
- from enum import Enum
13
- from typing import (
14
- Any,
15
- Literal,
16
- NoReturn,
17
- ParamSpec,
18
- Protocol,
19
- TypeVar,
20
- overload,
21
- )
22
-
23
- from pydantic import BaseModel
24
-
25
- from ..call_kwargs import BaseCallKwargs
26
- from ..call_response import BaseCallResponse
27
- from ..call_response_chunk import BaseCallResponseChunk
28
- from ..messages import Messages
29
- from ..stream_config import StreamConfig
30
- from ..tool import BaseTool
31
- from ._base_type import BaseType
32
-
33
- _BaseCallResponseT = TypeVar(
34
- "_BaseCallResponseT", covariant=True, bound=BaseCallResponse
35
- )
36
- _BaseCallResponseChunkT = TypeVar(
37
- "_BaseCallResponseChunkT", covariant=True, bound=BaseCallResponseChunk
38
- )
39
- _BaseStreamT = TypeVar("_BaseStreamT", covariant=True)
40
- _ResponseModelT = TypeVar("_ResponseModelT", bound=BaseModel | BaseType | Enum)
41
- _SameSyncAndAsyncClientT = TypeVar("_SameSyncAndAsyncClientT", contravariant=True)
42
- _SyncBaseClientT = TypeVar("_SyncBaseClientT", contravariant=True)
43
- _AsyncBaseClientT = TypeVar("_AsyncBaseClientT", contravariant=True)
44
- _BaseCallParamsT = TypeVar("_BaseCallParamsT", contravariant=True)
45
- _AsyncBaseDynamicConfigT = TypeVar("_AsyncBaseDynamicConfigT", contravariant=True)
46
- _BaseDynamicConfigT = TypeVar("_BaseDynamicConfigT", contravariant=True)
47
- _ResponseT = TypeVar("_ResponseT", covariant=True)
48
- _AsyncResponseT = TypeVar("_AsyncResponseT", covariant=True)
49
- _ResponseChunkT = TypeVar("_ResponseChunkT", covariant=True)
50
- _AsyncResponseChunkT = TypeVar("_AsyncResponseChunkT", covariant=True)
51
- _InvariantResponseChunkT = TypeVar("_InvariantResponseChunkT", contravariant=True)
52
- _BaseToolT = TypeVar("_BaseToolT", bound=BaseTool)
53
- _ParsedOutputT = TypeVar("_ParsedOutputT")
54
- _P = ParamSpec("_P")
55
- _R = TypeVar("_R", contravariant=True)
56
-
57
-
58
- class AsyncLLMFunctionDecorator(Protocol[_AsyncBaseDynamicConfigT, _AsyncResponseT]):
59
- @overload
60
- def __call__(
61
- self,
62
- fn: Callable[
63
- _P,
64
- Awaitable[_AsyncBaseDynamicConfigT]
65
- | Coroutine[Any, Any, _AsyncBaseDynamicConfigT],
66
- ],
67
- ) -> Callable[_P, Awaitable[_AsyncResponseT]]: ...
68
-
69
- @overload
70
- def __call__(
71
- self,
72
- fn: Callable[_P, Awaitable[Messages.Type] | Coroutine[Any, Any, Messages.Type]],
73
- ) -> Callable[_P, Awaitable[_AsyncResponseT]]: ...
74
-
75
- def __call__(
76
- self,
77
- fn: Callable[
78
- _P,
79
- Awaitable[_AsyncBaseDynamicConfigT]
80
- | Coroutine[Any, Any, _AsyncBaseDynamicConfigT],
81
- ]
82
- | Callable[_P, Awaitable[Messages.Type] | Coroutine[Any, Any, Messages.Type]],
83
- ) -> Callable[_P, Awaitable[_AsyncResponseT]]: ... # pragma: no cover
84
-
85
-
86
- class SyncLLMFunctionDecorator(Protocol[_BaseDynamicConfigT, _ResponseT]):
87
- @overload
88
- def __call__(
89
- self, fn: Callable[_P, _BaseDynamicConfigT]
90
- ) -> Callable[_P, _ResponseT]: ...
91
-
92
- @overload
93
- def __call__(self, fn: Callable[_P, Messages.Type]) -> Callable[_P, _ResponseT]: ...
94
-
95
- def __call__(
96
- self, fn: Callable[_P, _BaseDynamicConfigT] | Callable[_P, Messages.Type]
97
- ) -> Callable[_P, _ResponseT]: ... # pragma: no cover
98
-
99
-
100
- class LLMFunctionDecorator(
101
- Protocol[_BaseDynamicConfigT, _AsyncBaseDynamicConfigT, _ResponseT, _AsyncResponseT]
102
- ):
103
- @overload
104
- def __call__(
105
- self, fn: Callable[_P, _BaseDynamicConfigT]
106
- ) -> Callable[_P, _ResponseT]: ...
107
-
108
- @overload
109
- def __call__(self, fn: Callable[_P, Messages.Type]) -> Callable[_P, _ResponseT]: ...
110
-
111
- @overload
112
- def __call__(
113
- self, fn: Callable[_P, Awaitable[_AsyncBaseDynamicConfigT]]
114
- ) -> Callable[_P, Awaitable[_AsyncResponseT]]: ...
115
-
116
- @overload
117
- def __call__(
118
- self, fn: Callable[_P, Awaitable[Messages.Type]]
119
- ) -> Callable[_P, Awaitable[_AsyncResponseT]]: ...
120
-
121
- def __call__(
122
- self,
123
- fn: Callable[_P, _BaseDynamicConfigT]
124
- | Callable[_P, Awaitable[_AsyncBaseDynamicConfigT]]
125
- | Callable[_P, Messages.Type]
126
- | Callable[_P, Awaitable[Messages.Type]],
127
- ) -> Callable[_P, _ResponseT | Awaitable[_AsyncResponseT]]: ... # pragma: no cover
128
-
129
-
130
- class AsyncCreateFn(Protocol[_ResponseT, _ResponseChunkT]):
131
- @overload
132
- def __call__( # pyright: ignore[reportOverlappingOverload]
133
- self,
134
- *,
135
- stream: Literal[False] = False,
136
- **kwargs: Any, # noqa: ANN401
137
- ) -> Awaitable[_ResponseT]: ...
138
-
139
- @overload
140
- def __call__(
141
- self,
142
- *,
143
- stream: Literal[True] | StreamConfig = True,
144
- **kwargs: Any, # noqa: ANN401
145
- ) -> Awaitable[AsyncGenerator[_ResponseChunkT, None]]: ...
146
-
147
- def __call__(
148
- self, *, stream: bool | StreamConfig = False, **kwargs: Any
149
- ) -> Awaitable[
150
- _ResponseT | AsyncGenerator[_ResponseChunkT, None]
151
- ]: ... # pragma: no cover
152
-
153
-
154
- class CreateFn(Protocol[_ResponseT, _ResponseChunkT]):
155
- @overload
156
- def __call__( # pyright: ignore[reportOverlappingOverload]
157
- self,
158
- *,
159
- stream: Literal[False] = False,
160
- **kwargs: Any, # noqa: ANN401
161
- ) -> _ResponseT: ...
162
-
163
- @overload
164
- def __call__(
165
- self,
166
- *,
167
- stream: Literal[True] | StreamConfig = True,
168
- **kwargs: Any, # noqa: ANN401
169
- ) -> Generator[_ResponseChunkT, None, None]: ...
170
-
171
- def __call__(
172
- self,
173
- *,
174
- stream: bool | StreamConfig = False,
175
- **kwargs: Any, # noqa: F821
176
- ) -> _ResponseT | Generator[_ResponseChunkT, None, None]: ...
177
-
178
-
179
- class SetupCall(
180
- Protocol[
181
- _SyncBaseClientT,
182
- _AsyncBaseClientT,
183
- _BaseDynamicConfigT,
184
- _AsyncBaseDynamicConfigT,
185
- _BaseCallParamsT,
186
- _ResponseT,
187
- _ResponseChunkT,
188
- _AsyncResponseT,
189
- _AsyncResponseChunkT,
190
- _BaseToolT,
191
- ]
192
- ):
193
- @overload
194
- def __call__(
195
- self,
196
- *,
197
- model: str,
198
- client: _AsyncBaseClientT | None,
199
- fn: Callable[..., Awaitable[_AsyncBaseDynamicConfigT]],
200
- fn_args: dict[str, Any],
201
- dynamic_config: _AsyncBaseDynamicConfigT,
202
- tools: list[type[BaseTool] | Callable] | None,
203
- json_mode: bool,
204
- call_params: _BaseCallParamsT,
205
- response_model: type[BaseModel] | None,
206
- stream: bool | StreamConfig,
207
- ) -> tuple[
208
- AsyncCreateFn[_AsyncResponseT, _AsyncResponseChunkT],
209
- str | None,
210
- list[Any],
211
- list[type[_BaseToolT]] | None,
212
- BaseCallKwargs,
213
- ]: ...
214
-
215
- @overload
216
- def __call__(
217
- self,
218
- *,
219
- model: str,
220
- client: _SyncBaseClientT | None,
221
- fn: Callable[..., _BaseDynamicConfigT],
222
- fn_args: dict[str, Any],
223
- dynamic_config: _BaseDynamicConfigT,
224
- tools: list[type[BaseTool] | Callable] | None,
225
- json_mode: bool,
226
- call_params: _BaseCallParamsT,
227
- response_model: type[BaseModel] | None,
228
- stream: bool | StreamConfig,
229
- ) -> tuple[
230
- CreateFn[_ResponseT, _ResponseChunkT],
231
- str | None,
232
- list[Any],
233
- list[type[_BaseToolT]] | None,
234
- BaseCallKwargs,
235
- ]: ...
236
-
237
- def __call__(
238
- self,
239
- *,
240
- model: str,
241
- client: _SyncBaseClientT | _AsyncBaseClientT | None,
242
- fn: Callable[..., _BaseDynamicConfigT | Awaitable[_AsyncBaseDynamicConfigT]],
243
- fn_args: dict[str, Any],
244
- dynamic_config: _BaseDynamicConfigT | _AsyncBaseDynamicConfigT,
245
- tools: list[type[BaseTool] | Callable] | None,
246
- json_mode: bool,
247
- call_params: _BaseCallParamsT,
248
- response_model: type[BaseModel] | None,
249
- stream: bool | StreamConfig,
250
- ) -> tuple[
251
- CreateFn[_ResponseT, _ResponseChunkT]
252
- | AsyncCreateFn[_AsyncResponseT, _AsyncResponseChunkT],
253
- str | None,
254
- list[Any],
255
- list[type[_BaseToolT]] | None,
256
- BaseCallKwargs,
257
- ]: ... # pragma: no cover
258
-
259
-
260
- class SameSyncAndAsyncClientSetupCall(
261
- Protocol[
262
- _SameSyncAndAsyncClientT,
263
- _BaseDynamicConfigT,
264
- _AsyncBaseDynamicConfigT,
265
- _BaseCallParamsT,
266
- _ResponseT,
267
- _ResponseChunkT,
268
- _AsyncResponseT,
269
- _AsyncResponseChunkT,
270
- _BaseToolT,
271
- ]
272
- ):
273
- @overload
274
- def __call__(
275
- self,
276
- *,
277
- model: str,
278
- client: _SameSyncAndAsyncClientT | None,
279
- fn: Callable[..., Awaitable[_AsyncBaseDynamicConfigT]],
280
- fn_args: dict[str, Any],
281
- dynamic_config: _AsyncBaseDynamicConfigT,
282
- tools: list[type[BaseTool] | Callable] | None,
283
- json_mode: bool,
284
- call_params: _BaseCallParamsT,
285
- response_model: type[BaseModel] | None,
286
- stream: bool | StreamConfig,
287
- ) -> tuple[
288
- AsyncCreateFn[_AsyncResponseT, _AsyncResponseChunkT],
289
- str | None,
290
- list[Any],
291
- list[type[_BaseToolT]] | None,
292
- BaseCallKwargs,
293
- ]: ...
294
-
295
- @overload
296
- def __call__(
297
- self,
298
- *,
299
- model: str,
300
- client: _SameSyncAndAsyncClientT | None,
301
- fn: Callable[..., _BaseDynamicConfigT],
302
- fn_args: dict[str, Any],
303
- dynamic_config: _BaseDynamicConfigT,
304
- tools: list[type[BaseTool] | Callable] | None,
305
- json_mode: bool,
306
- call_params: _BaseCallParamsT,
307
- response_model: type[BaseModel] | None,
308
- stream: bool | StreamConfig,
309
- ) -> tuple[
310
- CreateFn[_ResponseT, _ResponseChunkT],
311
- str | None,
312
- list[Any],
313
- list[type[_BaseToolT]] | None,
314
- BaseCallKwargs,
315
- ]: ...
316
-
317
- def __call__(
318
- self,
319
- *,
320
- model: str,
321
- client: _SameSyncAndAsyncClientT | None,
322
- fn: Callable[..., _BaseDynamicConfigT | Awaitable[_AsyncBaseDynamicConfigT]],
323
- fn_args: dict[str, Any],
324
- dynamic_config: _BaseDynamicConfigT | _AsyncBaseDynamicConfigT,
325
- tools: list[type[BaseTool] | Callable] | None,
326
- json_mode: bool,
327
- call_params: _BaseCallParamsT,
328
- response_model: type[BaseModel] | None,
329
- stream: bool | StreamConfig,
330
- ) -> tuple[
331
- CreateFn[_ResponseT, _ResponseChunkT]
332
- | AsyncCreateFn[_AsyncResponseT, _AsyncResponseChunkT],
333
- str | None,
334
- list[Any],
335
- list[type[_BaseToolT]] | None,
336
- BaseCallKwargs,
337
- ]: ... # pragma: no cover
338
-
339
-
340
- class HandleStream(
341
- Protocol[_InvariantResponseChunkT, _BaseCallResponseChunkT, _BaseToolT]
342
- ):
343
- def __call__(
344
- self,
345
- stream: Generator[_InvariantResponseChunkT, None, None],
346
- tool_types: list[type[_BaseToolT]] | None,
347
- partial_tools: bool = False,
348
- ) -> Generator[
349
- tuple[_BaseCallResponseChunkT, _BaseToolT | None], None, None
350
- ]: ... # pragma: no cover
351
-
352
-
353
- class HandleStreamAsync(
354
- Protocol[_InvariantResponseChunkT, _BaseCallResponseChunkT, _BaseToolT]
355
- ):
356
- def __call__(
357
- self,
358
- stream: AsyncGenerator[_InvariantResponseChunkT, None],
359
- tool_types: list[type[_BaseToolT]] | None,
360
- partial_tools: bool = False,
361
- ) -> AsyncGenerator[
362
- tuple[_BaseCallResponseChunkT, _BaseToolT | None], None
363
- ]: ... # pragma: no cover
364
-
365
-
366
- class GetJsonOutput(Protocol[_R]):
367
- def __call__(self, response: _R, json_mode: bool) -> str: ... # pragma: no cover
368
-
369
-
370
- class CalculateCost(Protocol):
371
- def __call__(
372
- self,
373
- input_tokens: int | float | None,
374
- cached_tokens: int | float | None,
375
- output_tokens: int | float | None,
376
- model: str,
377
- ) -> float | None: ... # pragma: no cover
378
-
379
-
380
- class CallDecorator(
381
- Protocol[
382
- _BaseCallResponseT,
383
- _BaseCallResponseChunkT,
384
- _BaseDynamicConfigT,
385
- _AsyncBaseDynamicConfigT,
386
- _BaseCallParamsT,
387
- _BaseStreamT,
388
- _SyncBaseClientT,
389
- _AsyncBaseClientT,
390
- _SameSyncAndAsyncClientT,
391
- ],
392
- ):
393
- @overload
394
- def __call__( # pyright: ignore[reportOverlappingOverload]
395
- self,
396
- model: str,
397
- *,
398
- stream: Literal[False] = False,
399
- tools: list[type[BaseTool] | Callable] | None = None,
400
- response_model: None = None,
401
- output_parser: None = None,
402
- json_mode: bool = False,
403
- client: _SameSyncAndAsyncClientT | None = None,
404
- call_params: _BaseCallParamsT | None = None,
405
- ) -> LLMFunctionDecorator[
406
- _BaseDynamicConfigT,
407
- _AsyncBaseDynamicConfigT,
408
- _BaseCallResponseT,
409
- _BaseCallResponseT,
410
- ]: ...
411
-
412
- @overload
413
- def __call__( # pyright: ignore[reportOverlappingOverload]
414
- self,
415
- model: str,
416
- *,
417
- stream: Literal[False] = False,
418
- tools: list[type[BaseTool] | Callable] | None = None,
419
- response_model: None = None,
420
- output_parser: None = None,
421
- json_mode: bool = False,
422
- client: _AsyncBaseClientT = ...,
423
- call_params: _BaseCallParamsT | None = None,
424
- ) -> AsyncLLMFunctionDecorator[_AsyncBaseDynamicConfigT, _BaseCallResponseT]: ...
425
-
426
- @overload
427
- def __call__(
428
- self,
429
- model: str,
430
- *,
431
- stream: Literal[False] = False,
432
- tools: list[type[BaseTool] | Callable] | None = None,
433
- response_model: None = None,
434
- output_parser: None = None,
435
- json_mode: bool = False,
436
- client: _SyncBaseClientT = ...,
437
- call_params: _BaseCallParamsT | None = None,
438
- ) -> SyncLLMFunctionDecorator[_BaseDynamicConfigT, _BaseCallResponseT]: ...
439
-
440
- @overload
441
- def __call__( # pyright: ignore[reportOverlappingOverload]
442
- self,
443
- model: str,
444
- *,
445
- stream: Literal[False] = False,
446
- tools: list[type[BaseTool] | Callable] | None = None,
447
- response_model: None = None,
448
- output_parser: Callable[[_BaseCallResponseT], _ParsedOutputT],
449
- json_mode: bool = False,
450
- client: _SameSyncAndAsyncClientT | None = None,
451
- call_params: _BaseCallParamsT | None = None,
452
- ) -> LLMFunctionDecorator[
453
- _BaseDynamicConfigT, _AsyncBaseDynamicConfigT, _ParsedOutputT, _ParsedOutputT
454
- ]: ...
455
-
456
- @overload
457
- def __call__(
458
- self,
459
- model: str,
460
- *,
461
- stream: Literal[False] = False,
462
- tools: list[type[BaseTool] | Callable] | None = None,
463
- response_model: None = None,
464
- output_parser: Callable[[_BaseCallResponseT], _ParsedOutputT],
465
- json_mode: bool = False,
466
- client: _AsyncBaseClientT = ...,
467
- call_params: _BaseCallParamsT | None = None,
468
- ) -> AsyncLLMFunctionDecorator[_AsyncBaseDynamicConfigT, _ParsedOutputT]: ...
469
-
470
- @overload
471
- def __call__(
472
- self,
473
- model: str,
474
- *,
475
- stream: Literal[False] = False,
476
- tools: list[type[BaseTool] | Callable] | None = None,
477
- response_model: None = None,
478
- output_parser: Callable[[_BaseCallResponseT], _ParsedOutputT],
479
- json_mode: bool = False,
480
- client: _SyncBaseClientT = ...,
481
- call_params: _BaseCallParamsT | None = None,
482
- ) -> SyncLLMFunctionDecorator[_BaseDynamicConfigT, _ParsedOutputT]: ...
483
-
484
- @overload
485
- def __call__(
486
- self,
487
- model: str,
488
- *,
489
- stream: Literal[False] = False,
490
- tools: list[type[BaseTool] | Callable] | None = None,
491
- response_model: None = None,
492
- output_parser: Callable[[_BaseCallResponseChunkT], _ParsedOutputT],
493
- json_mode: bool = False,
494
- client: _SameSyncAndAsyncClientT
495
- | _SyncBaseClientT
496
- | _AsyncBaseClientT
497
- | None = None,
498
- call_params: _BaseCallParamsT | None = None,
499
- ) -> NoReturn: ...
500
-
501
- @overload
502
- def __call__(
503
- self,
504
- model: str,
505
- *,
506
- stream: Literal[True] | StreamConfig = True,
507
- tools: list[type[BaseTool] | Callable] | None = None,
508
- response_model: None = None,
509
- output_parser: None = None,
510
- json_mode: bool = False,
511
- client: _SameSyncAndAsyncClientT | None = None,
512
- call_params: _BaseCallParamsT | None = None,
513
- ) -> LLMFunctionDecorator[
514
- _BaseDynamicConfigT, _AsyncBaseDynamicConfigT, _BaseStreamT, _BaseStreamT
515
- ]: ...
516
-
517
- @overload
518
- def __call__(
519
- self,
520
- model: str,
521
- *,
522
- stream: Literal[True] | StreamConfig = True,
523
- tools: list[type[BaseTool] | Callable] | None = None,
524
- response_model: None = None,
525
- output_parser: None = None,
526
- json_mode: bool = False,
527
- client: _AsyncBaseClientT = ...,
528
- call_params: _BaseCallParamsT | None = None,
529
- ) -> AsyncLLMFunctionDecorator[_AsyncBaseDynamicConfigT, _BaseStreamT]: ...
530
-
531
- @overload
532
- def __call__(
533
- self,
534
- model: str,
535
- *,
536
- stream: Literal[True] | StreamConfig = True,
537
- tools: list[type[BaseTool] | Callable] | None = None,
538
- response_model: None = None,
539
- output_parser: None = None,
540
- json_mode: bool = False,
541
- client: _SyncBaseClientT = ...,
542
- call_params: _BaseCallParamsT | None = None,
543
- ) -> SyncLLMFunctionDecorator[_BaseDynamicConfigT, _BaseStreamT]: ...
544
-
545
- @overload
546
- def __call__(
547
- self,
548
- model: str,
549
- *,
550
- stream: Literal[True] | StreamConfig = True,
551
- tools: list[type[BaseTool] | Callable] | None = None,
552
- response_model: None = None,
553
- output_parser: Callable[[_BaseCallResponseChunkT], _ParsedOutputT],
554
- json_mode: bool = False,
555
- client: _SameSyncAndAsyncClientT
556
- | _SyncBaseClientT
557
- | _AsyncBaseClientT
558
- | None = None,
559
- call_params: _BaseCallParamsT | None = None,
560
- ) -> NoReturn: ...
561
-
562
- @overload
563
- def __call__(
564
- self,
565
- model: str,
566
- *,
567
- stream: Literal[True] | StreamConfig = True,
568
- tools: list[type[BaseTool] | Callable] | None = None,
569
- response_model: None = None,
570
- output_parser: Callable[[_BaseCallResponseT], _ParsedOutputT],
571
- json_mode: bool = False,
572
- client: _SameSyncAndAsyncClientT
573
- | _SyncBaseClientT
574
- | _AsyncBaseClientT
575
- | None = None,
576
- call_params: _BaseCallParamsT | None = None,
577
- ) -> NoReturn: ...
578
-
579
- @overload
580
- def __call__( # pyright: ignore[reportOverlappingOverload]
581
- self,
582
- model: str,
583
- *,
584
- stream: Literal[False] = False,
585
- tools: None = None,
586
- response_model: type[_ResponseModelT],
587
- output_parser: None = None,
588
- json_mode: bool = False,
589
- client: _SameSyncAndAsyncClientT | None = None,
590
- call_params: _BaseCallParamsT | None = None,
591
- ) -> LLMFunctionDecorator[
592
- _BaseDynamicConfigT, _AsyncBaseDynamicConfigT, _ResponseModelT, _ResponseModelT
593
- ]: ...
594
-
595
- @overload
596
- def __call__(
597
- self,
598
- model: str,
599
- *,
600
- stream: Literal[False] = False,
601
- tools: None = None,
602
- response_model: type[_ResponseModelT],
603
- output_parser: None = None,
604
- json_mode: bool = False,
605
- client: _AsyncBaseClientT = ...,
606
- call_params: _BaseCallParamsT | None = None,
607
- ) -> AsyncLLMFunctionDecorator[_AsyncBaseDynamicConfigT, _ResponseModelT]: ...
608
-
609
- @overload
610
- def __call__(
611
- self,
612
- model: str,
613
- *,
614
- stream: Literal[False] = False,
615
- tools: None = None,
616
- response_model: type[_ResponseModelT],
617
- output_parser: None = None,
618
- json_mode: bool = False,
619
- client: _SyncBaseClientT = ...,
620
- call_params: _BaseCallParamsT | None = None,
621
- ) -> SyncLLMFunctionDecorator[_BaseDynamicConfigT, _ResponseModelT]: ...
622
-
623
- @overload
624
- def __call__(
625
- self,
626
- model: str,
627
- *,
628
- stream: Literal[False] = False,
629
- tools: None = None,
630
- response_model: type[_ResponseModelT],
631
- output_parser: Callable[[_ResponseModelT], _ParsedOutputT],
632
- json_mode: bool = False,
633
- client: _SameSyncAndAsyncClientT | None = None,
634
- call_params: _BaseCallParamsT | None = None,
635
- ) -> LLMFunctionDecorator[
636
- _BaseDynamicConfigT, _AsyncBaseDynamicConfigT, _ParsedOutputT, _ParsedOutputT
637
- ]: ...
638
-
639
- @overload
640
- def __call__(
641
- self,
642
- model: str,
643
- *,
644
- stream: Literal[False] = False,
645
- tools: None = None,
646
- response_model: type[_ResponseModelT],
647
- output_parser: Callable[[_ResponseModelT], _ParsedOutputT],
648
- json_mode: bool = False,
649
- client: _AsyncBaseClientT = ...,
650
- call_params: _BaseCallParamsT | None = None,
651
- ) -> AsyncLLMFunctionDecorator[_AsyncBaseDynamicConfigT, _ParsedOutputT]: ...
652
-
653
- @overload
654
- def __call__(
655
- self,
656
- model: str,
657
- *,
658
- stream: Literal[False] = False,
659
- tools: None = None,
660
- response_model: type[_ResponseModelT],
661
- output_parser: Callable[[_ResponseModelT], _ParsedOutputT],
662
- json_mode: bool = False,
663
- client: _SyncBaseClientT = ...,
664
- call_params: _BaseCallParamsT | None = None,
665
- ) -> SyncLLMFunctionDecorator[_BaseDynamicConfigT, _ParsedOutputT]: ...
666
-
667
- @overload
668
- def __call__( # pyright: ignore[reportOverlappingOverload]
669
- self,
670
- model: str,
671
- *,
672
- stream: Literal[False] = False,
673
- tools: list[type[BaseTool] | Callable],
674
- response_model: type[_ResponseModelT],
675
- output_parser: None = None,
676
- json_mode: bool = False,
677
- client: _SameSyncAndAsyncClientT | None = None,
678
- call_params: _BaseCallParamsT | None = None,
679
- ) -> LLMFunctionDecorator[
680
- _BaseDynamicConfigT,
681
- _AsyncBaseDynamicConfigT,
682
- _ResponseModelT | _BaseCallResponseT,
683
- _ResponseModelT | _BaseCallResponseT,
684
- ]: ...
685
-
686
- @overload
687
- def __call__(
688
- self,
689
- model: str,
690
- *,
691
- stream: Literal[False] = False,
692
- tools: list[type[BaseTool] | Callable],
693
- response_model: type[_ResponseModelT],
694
- output_parser: None = None,
695
- json_mode: bool = False,
696
- client: _SyncBaseClientT = ...,
697
- call_params: _BaseCallParamsT | None = None,
698
- ) -> SyncLLMFunctionDecorator[
699
- _BaseDynamicConfigT,
700
- _ResponseModelT | _BaseCallResponseT,
701
- ]: ...
702
-
703
- @overload
704
- def __call__(
705
- self,
706
- model: str,
707
- *,
708
- stream: Literal[False] = False,
709
- tools: list[type[BaseTool] | Callable],
710
- response_model: type[_ResponseModelT],
711
- output_parser: None = None,
712
- json_mode: bool = False,
713
- client: _AsyncBaseClientT = ...,
714
- call_params: _BaseCallParamsT | None = None,
715
- ) -> AsyncLLMFunctionDecorator[
716
- _AsyncBaseDynamicConfigT,
717
- _ResponseModelT | _BaseCallResponseT,
718
- ]: ...
719
-
720
- ####
721
-
722
- @overload
723
- def __call__(
724
- self,
725
- model: str,
726
- *,
727
- stream: Literal[False] = False,
728
- tools: list[type[BaseTool] | Callable],
729
- response_model: type[_ResponseModelT],
730
- output_parser: Callable[[_ResponseModelT], _ParsedOutputT],
731
- json_mode: bool = False,
732
- client: _SameSyncAndAsyncClientT | None = None,
733
- call_params: _BaseCallParamsT | None = None,
734
- ) -> LLMFunctionDecorator[
735
- _BaseDynamicConfigT,
736
- _AsyncBaseDynamicConfigT,
737
- _ParsedOutputT | _BaseCallResponseT,
738
- _ParsedOutputT | _BaseCallResponseT,
739
- ]: ...
740
-
741
- @overload
742
- def __call__(
743
- self,
744
- model: str,
745
- *,
746
- stream: Literal[False] = False,
747
- tools: list[type[BaseTool] | Callable],
748
- response_model: type[_ResponseModelT],
749
- output_parser: Callable[[_ResponseModelT], _ParsedOutputT],
750
- json_mode: bool = False,
751
- client: _SyncBaseClientT = ...,
752
- call_params: _BaseCallParamsT | None = None,
753
- ) -> SyncLLMFunctionDecorator[
754
- _BaseDynamicConfigT,
755
- _ParsedOutputT | _BaseCallResponseT,
756
- ]: ...
757
-
758
- @overload
759
- def __call__(
760
- self,
761
- model: str,
762
- *,
763
- stream: Literal[False] = False,
764
- tools: list[type[BaseTool] | Callable],
765
- response_model: type[_ResponseModelT],
766
- output_parser: Callable[[_ResponseModelT], _ParsedOutputT],
767
- json_mode: bool = False,
768
- client: _AsyncBaseClientT = ...,
769
- call_params: _BaseCallParamsT | None = None,
770
- ) -> AsyncLLMFunctionDecorator[
771
- _AsyncBaseDynamicConfigT,
772
- _ParsedOutputT | _BaseCallResponseT,
773
- ]: ...
774
-
775
- ####
776
-
777
- @overload
778
- def __call__( # pyright: ignore[reportOverlappingOverload]
779
- self,
780
- model: str,
781
- *,
782
- stream: Literal[True] | StreamConfig,
783
- tools: list[type[BaseTool] | Callable] | None = None,
784
- response_model: type[_ResponseModelT],
785
- output_parser: None = None,
786
- json_mode: bool = False,
787
- client: _SameSyncAndAsyncClientT | None = None,
788
- call_params: _BaseCallParamsT | None = None,
789
- ) -> LLMFunctionDecorator[
790
- _BaseDynamicConfigT,
791
- _AsyncBaseDynamicConfigT,
792
- Iterable[_ResponseModelT],
793
- AsyncIterable[_ResponseModelT],
794
- ]: ...
795
-
796
- @overload
797
- def __call__(
798
- self,
799
- model: str,
800
- *,
801
- stream: Literal[True] | StreamConfig,
802
- tools: list[type[BaseTool] | Callable] | None = None,
803
- response_model: type[_ResponseModelT],
804
- output_parser: None = None,
805
- json_mode: bool = False,
806
- client: _AsyncBaseClientT = ...,
807
- call_params: _BaseCallParamsT | None = None,
808
- ) -> AsyncLLMFunctionDecorator[
809
- _AsyncBaseDynamicConfigT, AsyncIterable[_ResponseModelT]
810
- ]: ...
811
-
812
- @overload
813
- def __call__(
814
- self,
815
- model: str,
816
- *,
817
- stream: Literal[True] | StreamConfig,
818
- tools: list[type[BaseTool] | Callable] | None = None,
819
- response_model: type[_ResponseModelT],
820
- output_parser: None = None,
821
- json_mode: bool = False,
822
- client: _SyncBaseClientT = ...,
823
- call_params: _BaseCallParamsT | None = None,
824
- ) -> SyncLLMFunctionDecorator[_BaseDynamicConfigT, Iterable[_ResponseModelT]]: ...
825
-
826
- @overload
827
- def __call__(
828
- self,
829
- model: str,
830
- *,
831
- stream: Literal[True] | StreamConfig,
832
- tools: list[type[BaseTool] | Callable] | None = None,
833
- response_model: type[_ResponseModelT],
834
- output_parser: Callable[[_BaseCallResponseT], _ParsedOutputT]
835
- | Callable[[_BaseCallResponseChunkT], _ParsedOutputT]
836
- | Callable[[_ResponseModelT], _ParsedOutputT]
837
- | None,
838
- json_mode: bool = False,
839
- client: _SameSyncAndAsyncClientT
840
- | _AsyncBaseClientT
841
- | _SyncBaseClientT
842
- | None = None,
843
- call_params: _BaseCallParamsT | None = None,
844
- ) -> NoReturn: ...
845
-
846
- def __call__(
847
- self,
848
- model: str,
849
- *,
850
- stream: bool | StreamConfig = False,
851
- tools: list[type[BaseTool] | Callable] | None = None,
852
- response_model: type[_ResponseModelT] | None = None,
853
- output_parser: Callable[[_BaseCallResponseT], _ParsedOutputT]
854
- | Callable[[_BaseCallResponseChunkT], _ParsedOutputT]
855
- | Callable[[_ResponseModelT], _ParsedOutputT]
856
- | None = None,
857
- json_mode: bool = False,
858
- client: _SameSyncAndAsyncClientT
859
- | _AsyncBaseClientT
860
- | _SyncBaseClientT
861
- | None = None,
862
- call_params: _BaseCallParamsT | None = None,
863
- ) -> (
864
- AsyncLLMFunctionDecorator[
865
- _AsyncBaseDynamicConfigT,
866
- _BaseCallResponseT
867
- | _ParsedOutputT
868
- | _BaseStreamT
869
- | _ResponseModelT
870
- | (_ResponseModelT | _BaseCallResponseT)
871
- | AsyncIterable[_ResponseModelT],
872
- ]
873
- | SyncLLMFunctionDecorator[
874
- _BaseDynamicConfigT,
875
- _BaseCallResponseT
876
- | _ParsedOutputT
877
- | _BaseStreamT
878
- | _ResponseModelT
879
- | (_ResponseModelT | _BaseCallResponseT)
880
- | (_ParsedOutputT | _BaseCallResponseT)
881
- | Iterable[_ResponseModelT],
882
- ]
883
- | LLMFunctionDecorator[
884
- _BaseDynamicConfigT,
885
- _AsyncBaseDynamicConfigT,
886
- _BaseCallResponseT
887
- | _ParsedOutputT
888
- | _BaseStreamT
889
- | _ResponseModelT
890
- | (_ResponseModelT | _BaseCallResponseT)
891
- | (_ParsedOutputT | _BaseCallResponseT)
892
- | Iterable[_ResponseModelT],
893
- _BaseCallResponseT
894
- | _ParsedOutputT
895
- | _BaseStreamT
896
- | _ResponseModelT
897
- | (_ResponseModelT | _BaseCallResponseT)
898
- | (_ParsedOutputT | _BaseCallResponseT)
899
- | AsyncIterable[_ResponseModelT],
900
- ]
901
- ): ...