mirascope 1.25.7__py3-none-any.whl → 2.0.0a0__py3-none-any.whl

mirascope-2.0.0a0.dist-info/METADATA

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: mirascope
+Version: 2.0.0a0
+Summary: LLM abstractions that aren't obstructions
+Project-URL: Homepage, https://mirascope.com
+Project-URL: Documentation, https://mirascope.com/docs/mirascope/v2
+Project-URL: Repository, https://github.com/Mirascope/mirascope/tree/v2
+Project-URL: Issues, https://github.com/Mirascope/mirascope/issues
+Project-URL: Changelog, https://github.com/Mirascope/mirascope/releases
+Author-email: William Bakst <william@mirascope.com>, Dandelion Mané <dandelion@mirascope.com>
+Maintainer-email: William Bakst <william@mirascope.com>, Dandelion Mané <dandelion@mirascope.com>
+License: MIT License
+        
+        Copyright (c) 2023 Mirascope, Inc.
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: agents,artificial intelligence,developer tools,llm,llm tools,prompt engineering
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: File Formats :: JSON
+Classifier: Topic :: File Formats :: JSON :: JSON Schema
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: docstring-parser>=0.17.0
+Requires-Dist: typing-extensions>=4.10.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic<1.0,>=0.72.0; extra == 'anthropic'
+Provides-Extra: google
+Requires-Dist: google-genai<2,>=1.48.0; extra == 'google'
+Requires-Dist: pillow<11,>=10.4.0; extra == 'google'
+Requires-Dist: proto-plus>=1.24.0; extra == 'google'
+Provides-Extra: mcp
+Requires-Dist: mcp<2,>=1.0.0; extra == 'mcp'
+Provides-Extra: openai
+Requires-Dist: openai<3,>=2.7.1; extra == 'openai'
+Description-Content-Type: text/markdown
+
+## Mirascope v2 Python
+
+This directory contains the Python implementation of Mirascope.
+
+## Development Setup
+
+1. **Environment Variables**: Copy `.env.example` to `.env` and fill in your API keys:
+   ```bash
+   cp .env.example .env
+   # Edit .env with your API keys
+   ```
+
+2. **Install Dependencies**:
+
+   ```bash
+   uv sync --all-extras --dev
+   ```
+
+3. **Run Tests**:
+   ```bash
+   uv run pytest
+   ```
+
+## Testing
+
+### VCR Cassettes
+
+The project uses [VCR.py](https://vcrpy.readthedocs.io/) to record and replay HTTP interactions with LLM APIs. This allows tests to run quickly and consistently without making actual API calls.
+
+- **Cassettes Location**: Test cassettes are stored in `tests/llm/clients/*/cassettes/`
+- **Recording Mode**: Tests use `"once"` mode - records new interactions if no cassette exists, replays existing cassettes otherwise
+- **CI/CD**: In CI environments, tests use existing cassettes and never make real API calls
+
+### Inline Snapshots
+
+The project uses [inline-snapshot](https://15r10nk.github.io/inline-snapshot/) to capture expected test outputs directly in the test code.
+
+- **Update Snapshots**: Run `uv run pytest --inline-snapshot=fix` to update all snapshots with actual values
+- **Review Changes**: Run `uv run pytest --inline-snapshot=review` to preview what would change
+- **Formatted Output**: Snapshots are automatically formatted with `ruff` for consistency
+
+Example:
+```python
+def test_api_response():
+    response = client.call(messages=[user("Hello")])
+    assert response.content == snapshot([Text(text="Hi there!")])
+```
+
+### Recording New Test Interactions
+
+To record new test interactions:
+
+1. Ensure your API keys are set in `.env`
+2. Delete the relevant cassette file (if updating an existing test)
+3. Run the specific test: `uv run pytest tests/path/to/test.py::test_name`
+4. The cassette will be automatically created/updated

mirascope-2.0.0a0.dist-info/RECORD

@@ -0,0 +1,101 @@
+mirascope/__init__.py,sha256=wKvhFqB-FAf_Fxi1_pEenLRUK-QGMbhlsY5aPGc0lug,98
+mirascope/graphs/__init__.py,sha256=fkZHjSt6DvJAX-V3OCnDO7B1zJx5gv1Qp2G6P32wI7I,1086
+mirascope/graphs/finite_state_machine.py,sha256=9j8kwQ6Ne3o-auP0KVdoA0hzW2txfM1wH3GSSnbZOyg,23261
+mirascope/llm/__init__.py,sha256=qHerzIANTngmc1aXg_ga9S7dEY7rRj83e5Z61ObAdN4,4420
+mirascope/llm/exceptions.py,sha256=30yPPCIr8Uwibqpt2Y0cDMsimVlQubAmjqbeO5kVpSA,3090
+mirascope/llm/agents/__init__.py,sha256=aG5ymnBfa4ZFLfGPZjdXybwjC3lrlkkeLjKfx2Zzr0Q,363
+mirascope/llm/agents/agent.py,sha256=obACeIZuD8FIUaZL_NF0u5GNeaxRpbyNb9PNipyYIZE,2959
+mirascope/llm/agents/agent_template.py,sha256=7zm5piQrmClHFr7zw0EOMfWp009EGDfnGAaTtrw0twY,1478
+mirascope/llm/agents/decorator.py,sha256=IrVQMQNd9VGUnngjM-2LqVccZCwQMT9oXsYvf4MMyvI,5025
+mirascope/llm/calls/__init__.py,sha256=rnQ29w8x_EAEecZhP2i6N6u_qE-TO3sBZGAztF3o2QQ,273
+mirascope/llm/calls/base_call.py,sha256=ghD8__Uw-RpL-TWI1zShThWugXmZCiEA2tLsZ-XHU0I,1021
+mirascope/llm/calls/calls.py,sha256=R2hEGVsOHkZlBKcp4CvfssXABoLiIj9aKu80qrx6Ta4,9867
+mirascope/llm/calls/decorator.py,sha256=77JLc1xIotl7dWxzyz5xYeKIRu8ykMxZ40yj9MNd79c,7472
+mirascope/llm/clients/__init__.py,sha256=L00p7Kfk1gu8hSLXz3dvn3y0ku0rG6vPxq2vxRoukJI,770
+mirascope/llm/clients/providers.py,sha256=GwZldKYXGaTPbkbAbGlCYyl2-CuR1dnz4smZGblyfqc,5095
+mirascope/llm/clients/anthropic/__init__.py,sha256=wSYwKLkASUQHEsIjvuMSQHIZ6mhdyOymmzb3clL8SlU,231
+mirascope/llm/clients/anthropic/clients.py,sha256=8Z1Ol8V-JwCxefT2mQYUrfduliES2Yvk88hyM4GCNvc,27460
+mirascope/llm/clients/anthropic/model_ids.py,sha256=0vp-nhDCYMw_3sKFD_tQO2FRlW8QzKiwXKBQ_lEv0yo,197
+mirascope/llm/clients/anthropic/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp1fyk7vSitYFv_5G5Cs,232
+mirascope/llm/clients/anthropic/_utils/decode.py,sha256=zD5__20USLa4YuTMeZo-4oi2-whckP85Ez_ch_Mross,8992
+mirascope/llm/clients/anthropic/_utils/encode.py,sha256=Bul-WPrb7XJ7LW5gIsU2dm1Xvi5TG2lhiotvzZiNcL4,8760
+mirascope/llm/clients/base/__init__.py,sha256=Am1Hbe7iNnVKjcR8PT52NqHgVwFnQaMojEHVrdGHAWo,278
+mirascope/llm/clients/base/_utils.py,sha256=JyVXkbsHgOD_CnCNkq-aVdSmD4me0M40NPsdCt0pKwg,6880
+mirascope/llm/clients/base/client.py,sha256=ffgxwMJ2vmbUB-KKzPwpgumzmGT2IhIr1yGqxYt9oBk,42258
+mirascope/llm/clients/base/kwargs.py,sha256=pjaHVqtlmScUBqG8ZAllVaLoepdKE-KYl2eTqzOBXm0,406
+mirascope/llm/clients/base/params.py,sha256=x2WLz0s5rMZ3u3GBGQmRlYGjecePtsLglHSJBLh35YE,3670
+mirascope/llm/clients/google/__init__.py,sha256=nrUGqVqbUmhi1Y3MNfbmp5ItooNHEV2D3cUNhyeRH_U,197
+mirascope/llm/clients/google/clients.py,sha256=rsWJV5kfwh93RSRE6x45wnBhnP122mLCCuOdy1cD2u4,28073
+mirascope/llm/clients/google/message.py,sha256=ryNsMKPSyBSVXl_H0MQEaSiWC3FFybjxIUuORNSiKTk,179
+mirascope/llm/clients/google/model_ids.py,sha256=zJe9IAX4DIO6JXeTksAx77nwtlz1k2aO0YcJHsNpRx4,338
+mirascope/llm/clients/google/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp1fyk7vSitYFv_5G5Cs,232
+mirascope/llm/clients/google/_utils/decode.py,sha256=z__aZLIL130nCVV5CdAJPTiaCSw61mCrItTHVDffkQQ,9007
+mirascope/llm/clients/google/_utils/encode.py,sha256=XFaRCzMQlUW3sm949pc-rPTavDgxSIjrxOllJ8KgR3k,10482
+mirascope/llm/clients/openai/__init__.py,sha256=LkD4Kkxc-dnpR_K5f539xSfqEaXE1vioDcW7suOJhJE,600
+mirascope/llm/clients/openai/completions/__init__.py,sha256=mdDQfZ0WI0tOH4OUrbnNBIe1kyqdj3y0r4q3LIwr4Os,223
+mirascope/llm/clients/openai/completions/clients.py,sha256=GjfNV1ewRi1ADgsP0t5cxPdQUWyN65gRSPzDJFMhApg,28086
+mirascope/llm/clients/openai/completions/model_ids.py,sha256=bno8SND8YbzoQE3Tjh9dxYo04luDILD3ndzQvgL5pAg,243
+mirascope/llm/clients/openai/completions/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp1fyk7vSitYFv_5G5Cs,232
+mirascope/llm/clients/openai/completions/_utils/decode.py,sha256=yiXPQwL33YNVxIZAABohqSO3ElEtiShVSki8fPQWf0A,6539
+mirascope/llm/clients/openai/completions/_utils/encode.py,sha256=q2jP8By9TUiv66-oJpWZddn709ZRIGkXniSPTxLR2Co,13227
+mirascope/llm/clients/openai/completions/_utils/model_features.py,sha256=iIm0uxNNfYOJ4qn1wmZjNrkCXNJK5czOPmn5UVBIjz4,3397
+mirascope/llm/clients/openai/responses/__init__.py,sha256=PofDWzyxz__hD1AaHn2hQkIPs7xxyiBcgDoCl39Tlq4,215
+mirascope/llm/clients/openai/responses/clients.py,sha256=dMIdp-Ua_stFAtT99gDp89woUyLyWShO4aAz8G_2nog,27627
+mirascope/llm/clients/openai/responses/model_ids.py,sha256=30OQ8wnIVp6A3I4NsTPBLqfi-SB5dhzyB7ic5p_XXhg,239
+mirascope/llm/clients/openai/responses/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp1fyk7vSitYFv_5G5Cs,232
+mirascope/llm/clients/openai/responses/_utils/decode.py,sha256=4D0clsSEhdF3d_z1dF1D54PmNEDm-88YBFwLldAWKfg,7583
+mirascope/llm/clients/openai/responses/_utils/encode.py,sha256=K4Dod2Hs2ncTKTr26kbFRwmVmKqixRL1nLR51nJ9R20,12374
+mirascope/llm/clients/openai/responses/_utils/model_features.py,sha256=nZdT7Wp38o7-u5-zUK2Oqe8KaxLbULad2DWKZDkXALQ,2295
+mirascope/llm/clients/openai/shared/__init__.py,sha256=x4koHwL1YsrZ-vzJ-RZks9xEVUUwGuMmthxRXlmQUqc,104
+mirascope/llm/clients/openai/shared/_utils.py,sha256=iWlQmkQXIk4J65zosjW0KiShZPEUpqgB9axrJIUfnJ4,1678
+mirascope/llm/content/__init__.py,sha256=jgAxB-QvtT6vZduv1ADIc5yFlhTyyk1PtUuBirRXxRI,1877
+mirascope/llm/content/audio.py,sha256=W6liY1PuQ0pF91eDBnNKW52dr-G7-vnd-rhlSqebx9Y,5311
+mirascope/llm/content/document.py,sha256=oz3LSUEhJh-lEUDCss5p_xkPBDYQhAu9m9SGFr64_pI,2369
+mirascope/llm/content/image.py,sha256=lG0nPvObNEva1XjqUJcZI2T7jZ1xhHaSjqsCncg0XEU,6155
+mirascope/llm/content/text.py,sha256=4lDzXXpDy601RAkv9m85InP_CklvLccFATPThBcY1Ho,1099
+mirascope/llm/content/thought.py,sha256=jWtlVWoS-fDjByD-m2SPdPNNxvQhfwfOio0B95j10qU,1729
+mirascope/llm/content/tool_call.py,sha256=Ogs-_ya50dc4Zb-bfNYFaMVdO5ZHpz4caGmr6ExGrVc,1613
+mirascope/llm/content/tool_output.py,sha256=cCaRvfoR8QFQwnI90rfZjIEkK1GVBia3YJ5BjlOoojs,661
+mirascope/llm/context/__init__.py,sha256=2Bx8CQhTXWbtwMirZ8ppmFKPXjuYezyi10XfmRpAE5I,179
+mirascope/llm/context/_utils.py,sha256=lZ2aoAfT7XuIZvQdqGBzOMarAFZNMW0M2HAfD25flkU,907
+mirascope/llm/context/context.py,sha256=qvmRXsyea34wXP-_0CCe6RwkT3H57dojCw6HHnv8LVc,629
+mirascope/llm/formatting/__init__.py,sha256=N7cvwRFqNC1udcPSZPMLMX-1eNhEtqoZzH1uuAtEX7w,592
+mirascope/llm/formatting/_utils.py,sha256=lb7UbFXuubkeuptZ_E2w-FEokGg1SEXOH5wUP1VXMT8,2292
+mirascope/llm/formatting/format.py,sha256=KraFe0mh6b9J7bkY6yJgM_4nthGVfKXYbpVv-WPe3Ic,3621
+mirascope/llm/formatting/from_call_args.py,sha256=OmCzqWn47W_IXOsl1-F2Um-w4E3q71kFLA9I6L093GI,920
+mirascope/llm/formatting/partial.py,sha256=_7WlcHvjNJIVrYGVCGphu5Y6UyZQlKyENp05QAtyJ0Q,1785
+mirascope/llm/formatting/types.py,sha256=GSoY82khvf53lwh8qEVIoeslVvoinx8cwLhh_NygB9k,4086
+mirascope/llm/mcp/__init__.py,sha256=qVMSydtTuNezpxv91w5JoV9b3-1s743X-bxh012JmjQ,192
+mirascope/llm/mcp/client.py,sha256=jbOn0QohgEu40JXvjENM7VE7pws8em3Jyx-Yn1YWZ_s,3613
+mirascope/llm/messages/__init__.py,sha256=YJ4D-s_vQd76GTRmRstI2i9Yx561plmURf-zrydKjSo,708
+mirascope/llm/messages/message.py,sha256=7pXiNqJkO3_DhkJPVwmI88bfDLf-31lo6Y_LIp3lcP8,6114
+mirascope/llm/models/__init__.py,sha256=5Mo-hH-wqiBnCGcs-WG17JR2zBrAGgjMtZNNN4MRDkU,513
+mirascope/llm/models/models.py,sha256=vi3dTml08J0dc74-9ALY8DorhfJKKwqEfCsecX44Wwk,41577
+mirascope/llm/prompts/__init__.py,sha256=OoNJX1vlhpSUoKsig_RwbcOcNS43CNcAioUsht5KVUg,650
+mirascope/llm/prompts/_utils.py,sha256=dTLeB6YjLniev_R93N0FH9J7zaVXnrej3crRZonRuBA,1760
+mirascope/llm/prompts/decorator.py,sha256=hWqGIW5xdYGo-H_bNIP0zzY-HdwATozfDi8ZU_SUZIQ,8589
+mirascope/llm/prompts/protocols.py,sha256=a5k0_WCGMmNo2exgK-2eBBhDg19olCbM2b002LZPlDg,2690
+mirascope/llm/responses/__init__.py,sha256=bWEY1_AkJxBTtq3ML3cJM2arU1XOoDFCv2QvukFz73c,1308
+mirascope/llm/responses/_utils.py,sha256=JkKXzG6-WqAbbmWLKOmbe7gDpp9xwg7xNHXryFbt6ME,1662
+mirascope/llm/responses/base_response.py,sha256=nReMXPSXqo42KJD9SClyggjkYnEfZn_t1u9RHOonrl4,3684
+mirascope/llm/responses/base_stream_response.py,sha256=x-HBW7_mSm4TiRrvBY60cFkp-qQrJlZjt_VcLeI91d4,27787
+mirascope/llm/responses/finish_reason.py,sha256=1iSVaTZP8zlTwc9Pr4r10AzGkMz0iy0om8vKsHJ0OUY,742
+mirascope/llm/responses/response.py,sha256=nsZr2vygDBBEQAIWwrfjL-YOWJ1MbrUOkwhhY1YU0CU,11774
+mirascope/llm/responses/root_response.py,sha256=pATfCrvwsLE4dgx3CA9ZONqcltqg9yHk9uHPQcFxYsM,6128
+mirascope/llm/responses/stream_response.py,sha256=g8hGoKL94intm5w5mOpAh2QAH1eiCbNIJYYgknIOcM0,23656
+mirascope/llm/responses/streams.py,sha256=TmEFvLVEWHfVYplik61yUWisxe8JGbaZdh7yC7e-axI,10789
+mirascope/llm/tools/__init__.py,sha256=3xIhEzpLlTkuDuvkfwVy3gLPRTTJCJH5GKkqCGjgo3A,772
+mirascope/llm/tools/_utils.py,sha256=bBVsZs8SywWspVGBGR7GGuhSmGa5-wCzeXGV6Woof9Q,872
+mirascope/llm/tools/decorator.py,sha256=kZ90qrE7jZHcW5fg3O-SOh6xiI6yjT4fz548e4AxvQc,5326
+mirascope/llm/tools/protocols.py,sha256=VubSZm-N2QEnBzFTsnj4pRtIgJOx2GQWM4IyqZjDk1Q,3054
+mirascope/llm/tools/tool_schema.py,sha256=vFGVNOa8ZrE6gnwelBcPKYK7-0ULqVtlr1oXZsbVxKY,8358
+mirascope/llm/tools/toolkit.py,sha256=pGXchFSO2H7PxFM2sPQYEMDAYHNaX9bhGEyyou_4vsg,4900
+mirascope/llm/tools/tools.py,sha256=AEgTEZoRTxictYxPDxdX18_Ho2sD8SIa-LUTngNHPiM,5972
+mirascope/llm/types/__init__.py,sha256=lqzi1FkZ-s-D9-KQzVkAHuQQ1zp6B6yM3r9UNo46teE,357
+mirascope/llm/types/dataclass.py,sha256=y4_9M3Yqw_4I-H0V4TwvgGIp6JvRdtpW11NxqufnsJk,247
+mirascope/llm/types/jsonable.py,sha256=KY6l21_RBhlHQRXQ_xy6pUqqbTVb_jVFSU4ykRy_OLU,1104
+mirascope/llm/types/type_vars.py,sha256=OsAcQAZh5T_X8ZTLlP4GC1x3qgVY9rfYSnME8aMTDxw,642
+mirascope-2.0.0a0.dist-info/METADATA,sha256=FySDVeLpjaHcLhgRrb12tjVMSLxojbv7AFcnJObI0XU,5035
+mirascope-2.0.0a0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mirascope-2.0.0a0.dist-info/licenses/LICENSE,sha256=LAs5Q8mdawTsVdONpDGukwsoc4KEUBmmonDEL39b23Y,1072
+mirascope-2.0.0a0.dist-info/RECORD,,

mirascope/beta/__init__.py

@@ -1,3 +0,0 @@
-from . import openai
-
-__all__ = ["openai"]

mirascope/beta/openai/__init__.py

@@ -1,17 +0,0 @@
-from .realtime import (
-    Context,
-    OpenAIRealtimeTool,
-    Realtime,
-    async_input,
-    record,
-    record_as_stream,
-)
-
-__all__ = [
-    "Context",
-    "OpenAIRealtimeTool",
-    "Realtime",
-    "async_input",
-    "record",
-    "record_as_stream",
-]

mirascope/beta/openai/realtime/__init__.py

@@ -1,13 +0,0 @@
-from ._utils import Context
-from .realtime import Realtime
-from .recording import async_input, record, record_as_stream
-from .tool import OpenAIRealtimeTool
-
-__all__ = [
-    "Context",
-    "OpenAIRealtimeTool",
-    "Realtime",
-    "async_input",
-    "record",
-    "record_as_stream",
-]

mirascope/beta/openai/realtime/_utils/__init__.py

@@ -1,3 +0,0 @@
-from ._protocols import Context
-
-__all__ = ["Context"]

mirascope/beta/openai/realtime/_utils/_audio.py

@@ -1,74 +0,0 @@
-import asyncio
-import base64
-import io
-from io import BytesIO
-from typing import Any
-
-from pydub import AudioSegment
-
-SAMPLE_WIDTH = 2
-FRAME_RATE = 24000
-CHANNELS = 1
-
-
-def audio_chunk_to_audio_segment(audio_bytes: bytes) -> AudioSegment:
-    return AudioSegment.from_raw(
-        io.BytesIO(audio_bytes),
-        sample_width=SAMPLE_WIDTH,
-        frame_rate=FRAME_RATE,
-        channels=CHANNELS,
-    )
-
-
-def _encode_pcm_as_base64(audio_bytes: bytes | BytesIO) -> str:
-    # Load the audio file from the byte stream
-    audio = AudioSegment.from_file(
-        io.BytesIO(audio_bytes) if isinstance(audio_bytes, bytes) else audio_bytes
-    )
-
-    # Resample to 24kHz mono pcm16
-    pcm_audio = (
-        audio.set_frame_rate(FRAME_RATE)
-        .set_channels(CHANNELS)
-        .set_sample_width(SAMPLE_WIDTH)
-        .raw_data
-    )
-
-    # Encode to base64 string
-    return base64.b64encode(pcm_audio).decode()
-
-
-def audio_to_input_audio_buffer_append_event(
-    audio_bytes: bytes | BytesIO,
-) -> dict[str, Any]:
-    return {
-        "type": "input_audio_buffer.append",
-        "audio": _encode_pcm_as_base64(audio_bytes),
-    }
-
-
-async def async_audio_input_audio_buffer_append_event(
-    audio_bytes: bytes | BytesIO,
-) -> dict[str, Any]:
-    return await asyncio.to_thread(
-        audio_to_input_audio_buffer_append_event, audio_bytes
-    )
-
-
-def audio_to_item_create_event(audio_bytes: bytes | BytesIO) -> dict[str, Any]:
-    return {
-        "type": "conversation.item.create",
-        "item": {
-            "type": "message",
-            "role": "user",
-            "content": [
-                {"type": "input_audio", "audio": _encode_pcm_as_base64(audio_bytes)}
-            ],
-        },
-    }
-
-
-async def async_audio_to_item_create_event(
-    audio_bytes: bytes | BytesIO,
-) -> dict[str, Any]:
-    return await asyncio.to_thread(audio_to_item_create_event, audio_bytes)

mirascope/beta/openai/realtime/_utils/_protocols.py

@@ -1,50 +0,0 @@
-from collections.abc import AsyncGenerator, Awaitable, Callable, Coroutine
-from typing import (
-    Any,
-    Protocol,
-    TypeAlias,
-    TypeVar,
-)
-
-from ..tool import OpenAIRealtimeTool
-
-_ToolTypeBase: TypeAlias = type[OpenAIRealtimeTool] | Callable
-
-_ResponseBaseType = str | bytes
-_ResponseT = TypeVar("_ResponseT", bound=_ResponseBaseType)
-_ReceiverArgumentT = TypeVar("_ReceiverArgumentT")
-_ToolType = TypeVar("_ToolType", bound=_ToolTypeBase)
-# TODO: Improve the type of context
-Context: TypeAlias = dict[str, Any]
-_OpenAIRealtimeToolT = TypeVar("_OpenAIRealtimeToolT", bound=OpenAIRealtimeTool)
-
-
-class SenderFunc(Protocol[_ResponseT]):
-    def __call__(
-        self, context: Context
-    ) -> (
-        AsyncGenerator[
-            _ResponseT | tuple[_ResponseT, list[type[OpenAIRealtimeTool] | Callable]],
-            None,
-        ]
-        | Coroutine[
-            Any,
-            Any,
-            _ResponseT | tuple[_ResponseT, list[type[OpenAIRealtimeTool] | Callable]],
-        ]
-        | Awaitable[
-            _ResponseT | tuple[_ResponseT, list[type[OpenAIRealtimeTool] | Callable]]
-        ]
-    ): ...
-
-
-class ReceiverFunc(Protocol[_ReceiverArgumentT]):
-    def __call__(
-        self, response: _ReceiverArgumentT, context: Context
-    ) -> Awaitable[None]: ...
-
-
-class FunctionCallHandlerFunc(Protocol):
-    def __call__(
-        self, tool: _OpenAIRealtimeToolT, context: Context
-    ) -> Awaitable[str] | str: ...