The Open Standard for Generative UI
Implement streaming package in Python (#85)
Rabi Shanker Guha643e895ce92c
diff --git a/.github/workflows/build.yml b/.github/workflows/build-js.ymlsimilarity index 91%rename from .github/workflows/build.ymlrename to .github/workflows/build-js.ymlindex cfad8c7e1..d0023d84a 100644--- a/.github/workflows/build.yml+++ b/.github/workflows/build-js.yml@@ -1,10 +1,14 @@-name: Build+name: Build JSon:push:branches: [ main ]+ paths:+ - js/**pull_request:branches: [ main ]+ paths:+ - js/**jobs:build:diff --git a/.github/workflows/build-py.yml b/.github/workflows/build-py.ymlnew file mode 100644index 000000000..d9c5b1d01--- /dev/null+++ b/.github/workflows/build-py.yml@@ -0,0 +1,49 @@+name: Build Python++on:+ push:+ branches: [ main ]+ paths:+ - py/**+ pull_request:+ branches: [ main ]+ paths:+ - py/**++defaults:+ run:+ working-directory: py++jobs:+ build:+ runs-on: ubuntu-latest+ steps:+ - uses: actions/checkout@v4+ with:+ fetch-depth: 0++ - name: Set up Python+ uses: actions/setup-python@v5+ with:+ python-version: '3.11'++ - name: Install Poetry+ uses: snok/install-poetry@v1+ with:+ version: 1.7.1+ virtualenvs-create: true+ virtualenvs-in-project: true++ - name: Load cached Poetry dependencies+ uses: actions/cache@v3+ with:+ path: |+ py/.venv+ py/stream/.venv+ key: venv-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}++ - name: Install dependencies+ run: make install++ - name: Run checks+ run: make cidiff --git a/.github/workflows/publish-pypi-package.yml b/.github/workflows/publish-pypi-package.ymlnew file mode 100644index 000000000..e9975110a--- /dev/null+++ b/.github/workflows/publish-pypi-package.yml@@ -0,0 +1,59 @@+name: Publish PyPI package++on:+ workflow_dispatch:+ inputs:+ package:+ description: 'Package to publish'+ required: true+ type: choice+ options:+ - crayon_stream++defaults:+ run:+ working-directory: py++jobs:+ build:+ runs-on: ubuntu-latest+ # Required for OIDC token+ permissions:+ id-token: write+ contents: read++ steps:+ - uses: actions/checkout@v4+ with:+ fetch-depth: 0++ - name: Set up Python+ uses: actions/setup-python@v5+ with:+ python-version: '3.11'++ - name: Install Poetry+ uses: snok/install-poetry@v1+ with:+ version: 1.7.1+ virtualenvs-create: true+ virtualenvs-in-project: true++ - name: Load cached Poetry dependencies+ uses: actions/cache@v3+ with:+ path: py/${{ inputs.package }}/.venv+ key: venv-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}++ - name: Install dependencies+ working-directory: py/${{ inputs.package }}+ run: poetry install++ - name: Build package+ working-directory: py/${{ inputs.package }}+ run: poetry build++ - name: Publish package distributions to PyPI+ uses: pypa/gh-action-pypi-publish@release/v1+ with:+ packages-dir: py/${{ inputs.package }}/dist/diff --git a/js/packages/stream/src/textSchema.ts b/js/packages/stream/src/textSchema.tsindex 9621f0851..aad71687f 100644--- a/js/packages/stream/src/textSchema.ts+++ b/js/packages/stream/src/textSchema.ts@@ -3,9 +3,9 @@// using structured outputs.export const TextResponseSchema = {type: "object",+ description: "Use this as a fallback when no other response template is applicable",properties: {type: { const: "text" },- description: "Use this as a fallback when no other response template is applicable",text: {type: "string",description: "plaintext message to be displayed to the user",diff --git a/js/packages/stream/src/types.ts b/js/packages/stream/src/types.tsindex a843ca8e3..213524e16 100644--- a/js/packages/stream/src/types.ts+++ b/js/packages/stream/src/types.ts@@ -17,6 +17,7 @@ export enum SSEType {ResponseTemplatePropsChunk = "tpl_props_chunk",ContextAppend = "context_append",MessageUpdate = "message_update",+ Error = "error",}interface Chunk {@@ -103,3 +104,18 @@ export class MessageUpdate implements Chunk {return new MessageUpdate(id);}}++export class Error implements Chunk {+ constructor(readonly error: string) {}++ toSSEString(): string {+ return encode({+ event: SSEType.Error,+ data: this.error,+ });+ }++ static fromSSEData(data: string): Error {+ return new Error(data);+ }+}diff --git a/py/.gitignore b/py/.gitignorenew file mode 100644index 000000000..15201acc1--- /dev/null+++ b/py/.gitignore@@ -0,0 +1,171 @@+# Byte-compiled / optimized / DLL files+__pycache__/+*.py[cod]+*$py.class++# C extensions+*.so++# Distribution / packaging+.Python+build/+develop-eggs/+dist/+downloads/+eggs/+.eggs/+lib/+lib64/+parts/+sdist/+var/+wheels/+share/python-wheels/+*.egg-info/+.installed.cfg+*.egg+MANIFEST++# PyInstaller+# Usually these files are written by a python script from a template+# before PyInstaller builds the exe, so as to inject date/other infos into it.+*.manifest+*.spec++# Installer logs+pip-log.txt+pip-delete-this-directory.txt++# Unit test / coverage reports+htmlcov/+.tox/+.nox/+.coverage+.coverage.*+.cache+nosetests.xml+coverage.xml+*.cover+*.py,cover+.hypothesis/+.pytest_cache/+cover/++# Translations+*.mo+*.pot++# Django stuff:+*.log+local_settings.py+db.sqlite3+db.sqlite3-journal++# Flask stuff:+instance/+.webassets-cache++# Scrapy stuff:+.scrapy++# Sphinx documentation+docs/_build/++# PyBuilder+.pybuilder/+target/++# Jupyter Notebook+.ipynb_checkpoints++# IPython+profile_default/+ipython_config.py++# pyenv+# For a library or package, you might want to ignore these files since the code is+# intended to run in multiple environments; otherwise, check them in:+# .python-version++# pipenv+# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.+# However, in case of collaboration, if having platform-specific dependencies or dependencies+# having no cross-platform support, pipenv may install dependencies that don't work, or not+# install all needed dependencies.+#Pipfile.lock++# UV+# Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.+# This is especially recommended for binary packages to ensure reproducibility, and is more+# commonly ignored for libraries.+#uv.lock++# poetry+# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.+# This is especially recommended for binary packages to ensure reproducibility, and is more+# commonly ignored for libraries.+# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control+#poetry.lock++# pdm+# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.+#pdm.lock+# pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it+# in version control.+# https://pdm.fming.dev/latest/usage/project/#working-with-version-control+.pdm.toml+.pdm-python+.pdm-build/++# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm+__pypackages__/++# Celery stuff+celerybeat-schedule+celerybeat.pid++# SageMath parsed files+*.sage.py++# Environments+.env+.venv+env/+venv/+ENV/+env.bak/+venv.bak/++# Spyder project settings+.spyderproject+.spyproject++# Rope project settings+.ropeproject++# mkdocs documentation+/site++# mypy+.mypy_cache/+.dmypy.json+dmypy.json++# Pyre type checker+.pyre/++# pytype static type analyzer+.pytype/++# Cython debug symbols+cython_debug/++# PyCharm+# JetBrains specific template is maintained in a separate JetBrains.gitignore that can+# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore+# and can be added to the global gitignore or merged into this file. For a more nuclear+# option (not recommended) you can uncomment the following to ignore the entire idea folder.+#.idea/++# PyPI configuration file+.pypircdiff --git a/py/Makefile b/py/Makefilenew file mode 100644index 000000000..fd45131dd--- /dev/null+++ b/py/Makefile@@ -0,0 +1,42 @@+.PHONY: format lint test install check clean mypy flake8++# Colors for pretty output+BLUE=\033[0;34m+NC=\033[0m # No Color++# Python source directories+SOURCES=stream/src++# Install all dependencies+install:+ @echo "${BLUE}Installing dependencies...${NC}"+ poetry install+ cd stream && poetry install++# Format code+format:+ @echo "${BLUE}Formatting code...${NC}"+ poetry run black $(SOURCES)+ poetry run isort $(SOURCES)++# Run all linters and type checks+lint: mypy+ @echo "${BLUE}Running Black and isort in check mode...${NC}"+ poetry run black --check $(SOURCES)+ poetry run isort --check $(SOURCES)++# Run mypy+mypy:+ @echo "${BLUE}Running mypy...${NC}"+ poetry run mypy $(SOURCES)++# Run all checks (useful for CI)+ci: lint mypy++# Clean Python cache files+clean:+ find . -type d -name "__pycache__" -exec rm -r {} ++ find . -type d -name "*.egg-info" -exec rm -r {} ++ find . -type d -name ".pytest_cache" -exec rm -r {} ++ find . -type d -name ".mypy_cache" -exec rm -r {} ++ find . -type f -name "*.pyc" -deletediff --git a/py/poetry.lock b/py/poetry.locknew file mode 100644index 000000000..5030eeb6f--- /dev/null+++ b/py/poetry.lock@@ -0,0 +1,245 @@+# This file is automatically @generated by Poetry 1.8.3 and should not be changed by hand.++[[package]]+name = "black"+version = "24.10.0"+description = "The uncompromising code formatter."+optional = false+python-versions = ">=3.9"+files = [+ {file = "black-24.10.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:e6668650ea4b685440857138e5fe40cde4d652633b1bdffc62933d0db4ed9812"},+ {file = "black-24.10.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:1c536fcf674217e87b8cc3657b81809d3c085d7bf3ef262ead700da345bfa6ea"},+ {file = "black-24.10.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:649fff99a20bd06c6f727d2a27f401331dc0cc861fb69cde910fe95b01b5928f"},+ {file = "black-24.10.0-cp310-cp310-win_amd64.whl", hash = "sha256:fe4d6476887de70546212c99ac9bd803d90b42fc4767f058a0baa895013fbb3e"},+ {file = "black-24.10.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:5a2221696a8224e335c28816a9d331a6c2ae15a2ee34ec857dcf3e45dbfa99ad"},+ {file = "black-24.10.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:f9da3333530dbcecc1be13e69c250ed8dfa67f43c4005fb537bb426e19200d50"},+ {file = "black-24.10.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4007b1393d902b48b36958a216c20c4482f601569d19ed1df294a496eb366392"},+ {file = "black-24.10.0-cp311-cp311-win_amd64.whl", hash = "sha256:394d4ddc64782e51153eadcaaca95144ac4c35e27ef9b0a42e121ae7e57a9175"},+ {file = "black-24.10.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:b5e39e0fae001df40f95bd8cc36b9165c5e2ea88900167bddf258bacef9bbdc3"},+ {file = "black-24.10.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:d37d422772111794b26757c5b55a3eade028aa3fde43121ab7b673d050949d65"},+ {file = "black-24.10.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:14b3502784f09ce2443830e3133dacf2c0110d45191ed470ecb04d0f5f6fcb0f"},+ {file = "black-24.10.0-cp312-cp312-win_amd64.whl", hash = "sha256:30d2c30dc5139211dda799758559d1b049f7f14c580c409d6ad925b74a4208a8"},+ {file = "black-24.10.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:1cbacacb19e922a1d75ef2b6ccaefcd6e93a2c05ede32f06a21386a04cedb981"},+ {file = "black-24.10.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:1f93102e0c5bb3907451063e08b9876dbeac810e7da5a8bfb7aeb5a9ef89066b"},+ {file = "black-24.10.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ddacb691cdcdf77b96f549cf9591701d8db36b2f19519373d60d31746068dbf2"},+ {file = "black-24.10.0-cp313-cp313-win_amd64.whl", hash = "sha256:680359d932801c76d2e9c9068d05c6b107f2584b2a5b88831c83962eb9984c1b"},+ {file = "black-24.10.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:17374989640fbca88b6a448129cd1745c5eb8d9547b464f281b251dd00155ccd"},+ {file = "black-24.10.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:63f626344343083322233f175aaf372d326de8436f5928c042639a4afbbf1d3f"},+ {file = "black-24.10.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ccfa1d0cb6200857f1923b602f978386a3a2758a65b52e0950299ea014be6800"},+ {file = "black-24.10.0-cp39-cp39-win_amd64.whl", hash = "sha256:2cd9c95431d94adc56600710f8813ee27eea544dd118d45896bb734e9d7a0dc7"},+ {file = "black-24.10.0-py3-none-any.whl", hash = "sha256:3bb2b7a1f7b685f85b11fed1ef10f8a9148bceb49853e47a294a3dd963c1dd7d"},+ {file = "black-24.10.0.tar.gz", hash = "sha256:846ea64c97afe3bc677b761787993be4991810ecc7a4a937816dd6bddedc4875"},+]++[package.dependencies]+click = ">=8.0.0"+mypy-extensions = ">=0.4.3"+packaging = ">=22.0"+pathspec = ">=0.9.0"+platformdirs = ">=2"+tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""}+typing-extensions = {version = ">=4.0.1", markers = "python_version < \"3.11\""}++[package.extras]+colorama = ["colorama (>=0.4.3)"]+d = ["aiohttp (>=3.10)"]+jupyter = ["ipython (>=7.8.0)", "tokenize-rt (>=3.2.0)"]+uvloop = ["uvloop (>=0.15.2)"]++[[package]]+name = "click"+version = "8.1.8"+description = "Composable command line interface toolkit"+optional = false+python-versions = ">=3.7"+files = [+ {file = "click-8.1.8-py3-none-any.whl", hash = "sha256:63c132bbbed01578a06712a2d1f497bb62d9c1c0d329b7903a866228027263b2"},+ {file = "click-8.1.8.tar.gz", hash = "sha256:ed53c9d8990d83c2a27deae68e4ee337473f6330c040a31d4225c9574d16096a"},+]++[package.dependencies]+colorama = {version = "*", markers = "platform_system == \"Windows\""}++[[package]]+name = "colorama"+version = "0.4.6"+description = "Cross-platform colored terminal text."+optional = false+python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7"+files = [+ {file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"},+ {file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"},+]++[[package]]+name = "isort"+version = "5.13.2"+description = "A Python utility / library to sort Python imports."+optional = false+python-versions = ">=3.8.0"+files = [+ {file = "isort-5.13.2-py3-none-any.whl", hash = "sha256:8ca5e72a8d85860d5a3fa69b8745237f2939afe12dbf656afbcb47fe72d947a6"},+ {file = "isort-5.13.2.tar.gz", hash = "sha256:48fdfcb9face5d58a4f6dde2e72a1fb8dcaf8ab26f95ab49fab84c2ddefb0109"},+]++[package.extras]+colors = ["colorama (>=0.4.6)"]++[[package]]+name = "mypy"+version = "1.15.0"+description = "Optional static typing for Python"+optional = false+python-versions = ">=3.9"+files = [+ {file = "mypy-1.15.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:979e4e1a006511dacf628e36fadfecbcc0160a8af6ca7dad2f5025529e082c13"},+ {file = "mypy-1.15.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:c4bb0e1bd29f7d34efcccd71cf733580191e9a264a2202b0239da95984c5b559"},+ {file = "mypy-1.15.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:be68172e9fd9ad8fb876c6389f16d1c1b5f100ffa779f77b1fb2176fcc9ab95b"},+ {file = "mypy-1.15.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c7be1e46525adfa0d97681432ee9fcd61a3964c2446795714699a998d193f1a3"},+ {file = "mypy-1.15.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:2e2c2e6d3593f6451b18588848e66260ff62ccca522dd231cd4dd59b0160668b"},+ {file = "mypy-1.15.0-cp310-cp310-win_amd64.whl", hash = "sha256:6983aae8b2f653e098edb77f893f7b6aca69f6cffb19b2cc7443f23cce5f4828"},+ {file = "mypy-1.15.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:2922d42e16d6de288022e5ca321cd0618b238cfc5570e0263e5ba0a77dbef56f"},+ {file = "mypy-1.15.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:2ee2d57e01a7c35de00f4634ba1bbf015185b219e4dc5909e281016df43f5ee5"},+ {file = "mypy-1.15.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:973500e0774b85d9689715feeffcc980193086551110fd678ebe1f4342fb7c5e"},+ {file = "mypy-1.15.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5a95fb17c13e29d2d5195869262f8125dfdb5c134dc8d9a9d0aecf7525b10c2c"},+ {file = "mypy-1.15.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:1905f494bfd7d85a23a88c5d97840888a7bd516545fc5aaedff0267e0bb54e2f"},+ {file = "mypy-1.15.0-cp311-cp311-win_amd64.whl", hash = "sha256:c9817fa23833ff189db061e6d2eff49b2f3b6ed9856b4a0a73046e41932d744f"},+ {file = "mypy-1.15.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:aea39e0583d05124836ea645f412e88a5c7d0fd77a6d694b60d9b6b2d9f184fd"},+ {file = "mypy-1.15.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:2f2147ab812b75e5b5499b01ade1f4a81489a147c01585cda36019102538615f"},+ {file = "mypy-1.15.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ce436f4c6d218a070048ed6a44c0bbb10cd2cc5e272b29e7845f6a2f57ee4464"},+ {file = "mypy-1.15.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8023ff13985661b50a5928fc7a5ca15f3d1affb41e5f0a9952cb68ef090b31ee"},+ {file = "mypy-1.15.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:1124a18bc11a6a62887e3e137f37f53fbae476dc36c185d549d4f837a2a6a14e"},+ {file = "mypy-1.15.0-cp312-cp312-win_amd64.whl", hash = "sha256:171a9ca9a40cd1843abeca0e405bc1940cd9b305eaeea2dda769ba096932bb22"},+ {file = "mypy-1.15.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:93faf3fdb04768d44bf28693293f3904bbb555d076b781ad2530214ee53e3445"},+ {file = "mypy-1.15.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:811aeccadfb730024c5d3e326b2fbe9249bb7413553f15499a4050f7c30e801d"},+ {file = "mypy-1.15.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:98b7b9b9aedb65fe628c62a6dc57f6d5088ef2dfca37903a7d9ee374d03acca5"},+ {file = "mypy-1.15.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c43a7682e24b4f576d93072216bf56eeff70d9140241f9edec0c104d0c515036"},+ {file = "mypy-1.15.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:baefc32840a9f00babd83251560e0ae1573e2f9d1b067719479bfb0e987c6357"},+ {file = "mypy-1.15.0-cp313-cp313-win_amd64.whl", hash = "sha256:b9378e2c00146c44793c98b8d5a61039a048e31f429fb0eb546d93f4b000bedf"},+ {file = "mypy-1.15.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:e601a7fa172c2131bff456bb3ee08a88360760d0d2f8cbd7a75a65497e2df078"},+ {file = "mypy-1.15.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:712e962a6357634fef20412699a3655c610110e01cdaa6180acec7fc9f8513ba"},+ {file = "mypy-1.15.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f95579473af29ab73a10bada2f9722856792a36ec5af5399b653aa28360290a5"},+ {file = "mypy-1.15.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8f8722560a14cde92fdb1e31597760dc35f9f5524cce17836c0d22841830fd5b"},+ {file = "mypy-1.15.0-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:1fbb8da62dc352133d7d7ca90ed2fb0e9d42bb1a32724c287d3c76c58cbaa9c2"},+ {file = "mypy-1.15.0-cp39-cp39-win_amd64.whl", hash = "sha256:d10d994b41fb3497719bbf866f227b3489048ea4bbbb5015357db306249f7980"},+ {file = "mypy-1.15.0-py3-none-any.whl", hash = "sha256:5469affef548bd1895d86d3bf10ce2b44e33d86923c29e4d675b3e323437ea3e"},+ {file = "mypy-1.15.0.tar.gz", hash = "sha256:404534629d51d3efea5c800ee7c42b72a6554d6c400e6a79eafe15d11341fd43"},+]++[package.dependencies]+mypy_extensions = ">=1.0.0"+tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""}+typing_extensions = ">=4.6.0"++[package.extras]+dmypy = ["psutil (>=4.0)"]+faster-cache = ["orjson"]+install-types = ["pip"]+mypyc = ["setuptools (>=50)"]+reports = ["lxml"]++[[package]]+name = "mypy-extensions"+version = "1.0.0"+description = "Type system extensions for programs checked with the mypy type checker."+optional = false+python-versions = ">=3.5"+files = [+ {file = "mypy_extensions-1.0.0-py3-none-any.whl", hash = "sha256:4392f6c0eb8a5668a69e23d168ffa70f0be9ccfd32b5cc2d26a34ae5b844552d"},+ {file = "mypy_extensions-1.0.0.tar.gz", hash = "sha256:75dbf8955dc00442a438fc4d0666508a9a97b6bd41aa2f0ffe9d2f2725af0782"},+]++[[package]]+name = "packaging"+version = "24.2"+description = "Core utilities for Python packages"+optional = false+python-versions = ">=3.8"+files = [+ {file = "packaging-24.2-py3-none-any.whl", hash = "sha256:09abb1bccd265c01f4a3aa3f7a7db064b36514d2cba19a2f694fe6150451a759"},+ {file = "packaging-24.2.tar.gz", hash = "sha256:c228a6dc5e932d346bc5739379109d49e8853dd8223571c7c5b55260edc0b97f"},+]++[[package]]+name = "pathspec"+version = "0.12.1"+description = "Utility library for gitignore style pattern matching of file paths."+optional = false+python-versions = ">=3.8"+files = [+ {file = "pathspec-0.12.1-py3-none-any.whl", hash = "sha256:a0d503e138a4c123b27490a4f7beda6a01c6f288df0e4a8b79c7eb0dc7b4cc08"},+ {file = "pathspec-0.12.1.tar.gz", hash = "sha256:a482d51503a1ab33b1c67a6c3813a26953dbdc71c31dacaef9a838c4e29f5712"},+]++[[package]]+name = "platformdirs"+version = "4.3.6"+description = "A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`."+optional = false+python-versions = ">=3.8"+files = [+ {file = "platformdirs-4.3.6-py3-none-any.whl", hash = "sha256:73e575e1408ab8103900836b97580d5307456908a03e92031bab39e4554cc3fb"},+ {file = "platformdirs-4.3.6.tar.gz", hash = "sha256:357fb2acbc885b0419afd3ce3ed34564c13c9b95c89360cd9563f73aa5e2b907"},+]++[package.extras]+docs = ["furo (>=2024.8.6)", "proselint (>=0.14)", "sphinx (>=8.0.2)", "sphinx-autodoc-typehints (>=2.4)"]+test = ["appdirs (==1.4.4)", "covdefaults (>=2.3)", "pytest (>=8.3.2)", "pytest-cov (>=5)", "pytest-mock (>=3.14)"]+type = ["mypy (>=1.11.2)"]++[[package]]+name = "tomli"+version = "2.2.1"+description = "A lil' TOML parser"+optional = false+python-versions = ">=3.8"+files = [+ {file = "tomli-2.2.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:678e4fa69e4575eb77d103de3df8a895e1591b48e740211bd1067378c69e8249"},+ {file = "tomli-2.2.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:023aa114dd824ade0100497eb2318602af309e5a55595f76b626d6d9f3b7b0a6"},+ {file = "tomli-2.2.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ece47d672db52ac607a3d9599a9d48dcb2f2f735c6c2d1f34130085bb12b112a"},+ {file = "tomli-2.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6972ca9c9cc9f0acaa56a8ca1ff51e7af152a9f87fb64623e31d5c83700080ee"},+ {file = "tomli-2.2.1-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c954d2250168d28797dd4e3ac5cf812a406cd5a92674ee4c8f123c889786aa8e"},+ {file = "tomli-2.2.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:8dd28b3e155b80f4d54beb40a441d366adcfe740969820caf156c019fb5c7ec4"},+ {file = "tomli-2.2.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:e59e304978767a54663af13c07b3d1af22ddee3bb2fb0618ca1593e4f593a106"},+ {file = "tomli-2.2.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:33580bccab0338d00994d7f16f4c4ec25b776af3ffaac1ed74e0b3fc95e885a8"},+ {file = "tomli-2.2.1-cp311-cp311-win32.whl", hash = "sha256:465af0e0875402f1d226519c9904f37254b3045fc5084697cefb9bdde1ff99ff"},+ {file = "tomli-2.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:2d0f2fdd22b02c6d81637a3c95f8cd77f995846af7414c5c4b8d0545afa1bc4b"},+ {file = "tomli-2.2.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:4a8f6e44de52d5e6c657c9fe83b562f5f4256d8ebbfe4ff922c495620a7f6cea"},+ {file = "tomli-2.2.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8d57ca8095a641b8237d5b079147646153d22552f1c637fd3ba7f4b0b29167a8"},+ {file = "tomli-2.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4e340144ad7ae1533cb897d406382b4b6fede8890a03738ff1683af800d54192"},+ {file = "tomli-2.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:db2b95f9de79181805df90bedc5a5ab4c165e6ec3fe99f970d0e302f384ad222"},+ {file = "tomli-2.2.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:40741994320b232529c802f8bc86da4e1aa9f413db394617b9a256ae0f9a7f77"},+ {file = "tomli-2.2.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:400e720fe168c0f8521520190686ef8ef033fb19fc493da09779e592861b78c6"},+ {file = "tomli-2.2.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:02abe224de6ae62c19f090f68da4e27b10af2b93213d36cf44e6e1c5abd19fdd"},+ {file = "tomli-2.2.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:b82ebccc8c8a36f2094e969560a1b836758481f3dc360ce9a3277c65f374285e"},+ {file = "tomli-2.2.1-cp312-cp312-win32.whl", hash = "sha256:889f80ef92701b9dbb224e49ec87c645ce5df3fa2cc548664eb8a25e03127a98"},+ {file = "tomli-2.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:7fc04e92e1d624a4a63c76474610238576942d6b8950a2d7f908a340494e67e4"},+ {file = "tomli-2.2.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:f4039b9cbc3048b2416cc57ab3bda989a6fcf9b36cf8937f01a6e731b64f80d7"},+ {file = "tomli-2.2.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:286f0ca2ffeeb5b9bd4fcc8d6c330534323ec51b2f52da063b11c502da16f30c"},+ {file = "tomli-2.2.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a92ef1a44547e894e2a17d24e7557a5e85a9e1d0048b0b5e7541f76c5032cb13"},+ {file = "tomli-2.2.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9316dc65bed1684c9a98ee68759ceaed29d229e985297003e494aa825ebb0281"},+ {file = "tomli-2.2.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e85e99945e688e32d5a35c1ff38ed0b3f41f43fad8df0bdf79f72b2ba7bc5272"},+ {file = "tomli-2.2.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ac065718db92ca818f8d6141b5f66369833d4a80a9d74435a268c52bdfa73140"},+ {file = "tomli-2.2.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:d920f33822747519673ee656a4b6ac33e382eca9d331c87770faa3eef562aeb2"},+ {file = "tomli-2.2.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:a198f10c4d1b1375d7687bc25294306e551bf1abfa4eace6650070a5c1ae2744"},+ {file = "tomli-2.2.1-cp313-cp313-win32.whl", hash = "sha256:d3f5614314d758649ab2ab3a62d4f2004c825922f9e370b29416484086b264ec"},+ {file = "tomli-2.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:a38aa0308e754b0e3c67e344754dff64999ff9b513e691d0e786265c93583c69"},+ {file = "tomli-2.2.1-py3-none-any.whl", hash = "sha256:cb55c73c5f4408779d0cf3eef9f762b9c9f147a77de7b258bef0a5628adc85cc"},+ {file = "tomli-2.2.1.tar.gz", hash = "sha256:cd45e1dc79c835ce60f7404ec8119f2eb06d38b1deba146f07ced3bbc44505ff"},+]++[[package]]+name = "typing-extensions"+version = "4.12.2"+description = "Backported and Experimental Type Hints for Python 3.8+"+optional = false+python-versions = ">=3.8"+files = [+ {file = "typing_extensions-4.12.2-py3-none-any.whl", hash = "sha256:04e5ca0351e0f3f85c6853954072df659d0d13fac324d0072316b67d7794700d"},+ {file = "typing_extensions-4.12.2.tar.gz", hash = "sha256:1a7ead55c7e559dd4dee8856e3a88b41225abfe1ce8df57b7c13915fe121ffb8"},+]++[metadata]+lock-version = "2.0"+python-versions = "^3.10"+content-hash = "849607d9ca76adbcb68be906d10612bc96c36c9152b958bc660a6a10c27514b1"diff --git a/py/pyproject.toml b/py/pyproject.tomlnew file mode 100644index 000000000..8e68a0125--- /dev/null+++ b/py/pyproject.toml@@ -0,0 +1,32 @@+[tool.poetry]+name = "crayonai"+version = "0.0.1"+description = "Generative UI SDK for your AI agents"+authors = ["Thesys Inc. <[email protected]>"]+license = "MIT"++[tool.poetry.dependencies]+python = "^3.10"++[tool.poetry.group.dev.dependencies]+black = "^24.4.2"+isort = "^5.13.2"+mypy = "^1.11.2"++[build-system]+requires = ["poetry-core>=1.0.0"]+build-backend = "poetry.core.masonry.api"++[tool.isort]+profile = "black"+line_length = 88++[tool.black]+line-length = 88+target-version = ["py310"]++[tool.mypy]+disallow_untyped_calls = true+disallow_untyped_defs = true+ignore_missing_imports = true+follow_imports = "silent"diff --git a/py/stream/README.md b/py/stream/README.mdnew file mode 100644index 000000000..2b79d12a9--- /dev/null+++ b/py/stream/README.md@@ -0,0 +1,54 @@+# CrayonAI Stream++Python package for JSON Schema helpers and streaming utilities used in CrayonAI applications.++## Installation++```bash+pip install crayonai_stream+```++## Usage++### JSON Schema Helpers++Convert Pydantic models to template schemas:++```python+from crayonai_stream import pydantic_to_template_schema+from pydantic import BaseModel++class MyTemplate(BaseModel):+ name: str+ value: int++schema = pydantic_to_template_schema(MyTemplate, "my_template", "A sample template")+```++Create response formats with multiple templates:++```python+from crayonai_stream import templates_to_response_format, TemplateDefinition++response_format = templates_to_response_format(+ TemplateDefinition(+ schema=MyTemplate,+ name="my_template",+ description="A sample template"+ )+)+```++## Development++Install development dependencies:++```bash+pip install -e ".[dev]"+```++Run all checks (useful for CI):++```bash+make ci+```diff --git a/py/stream/poetry.lock b/py/stream/poetry.locknew file mode 100644index 000000000..33153e39d--- /dev/null+++ b/py/stream/poetry.lock@@ -0,0 +1,194 @@+# This file is automatically @generated by Poetry 1.8.3 and should not be changed by hand.++[[package]]+name = "annotated-types"+version = "0.7.0"+description = "Reusable constraint types to use with typing.Annotated"+optional = false+python-versions = ">=3.8"+files = [+ {file = "annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53"},+ {file = "annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89"},+]++[[package]]+name = "pydantic"+version = "2.10.6"+description = "Data validation using Python type hints"+optional = false+python-versions = ">=3.8"+files = [+ {file = "pydantic-2.10.6-py3-none-any.whl", hash = "sha256:427d664bf0b8a2b34ff5dd0f5a18df00591adcee7198fbd71981054cef37b584"},+ {file = "pydantic-2.10.6.tar.gz", hash = "sha256:ca5daa827cce33de7a42be142548b0096bf05a7e7b365aebfa5f8eeec7128236"},+]++[package.dependencies]+annotated-types = ">=0.6.0"+pydantic-core = "2.27.2"+typing-extensions = ">=4.12.2"++[package.extras]+email = ["email-validator (>=2.0.0)"]+timezone = ["tzdata"]++[[package]]+name = "pydantic-core"+version = "2.27.2"+description = "Core functionality for Pydantic validation and serialization"+optional = false+python-versions = ">=3.8"+files = [+ {file = "pydantic_core-2.27.2-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:2d367ca20b2f14095a8f4fa1210f5a7b78b8a20009ecced6b12818f455b1e9fa"},+ {file = "pydantic_core-2.27.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:491a2b73db93fab69731eaee494f320faa4e093dbed776be1a829c2eb222c34c"},+ {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7969e133a6f183be60e9f6f56bfae753585680f3b7307a8e555a948d443cc05a"},+ {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3de9961f2a346257caf0aa508a4da705467f53778e9ef6fe744c038119737ef5"},+ {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e2bb4d3e5873c37bb3dd58714d4cd0b0e6238cebc4177ac8fe878f8b3aa8e74c"},+ {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:280d219beebb0752699480fe8f1dc61ab6615c2046d76b7ab7ee38858de0a4e7"},+ {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47956ae78b6422cbd46f772f1746799cbb862de838fd8d1fbd34a82e05b0983a"},+ {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:14d4a5c49d2f009d62a2a7140d3064f686d17a5d1a268bc641954ba181880236"},+ {file = "pydantic_core-2.27.2-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:337b443af21d488716f8d0b6164de833e788aa6bd7e3a39c005febc1284f4962"},+ {file = "pydantic_core-2.27.2-cp310-cp310-musllinux_1_1_armv7l.whl", hash = "sha256:03d0f86ea3184a12f41a2d23f7ccb79cdb5a18e06993f8a45baa8dfec746f0e9"},+ {file = "pydantic_core-2.27.2-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:7041c36f5680c6e0f08d922aed302e98b3745d97fe1589db0a3eebf6624523af"},+ {file = "pydantic_core-2.27.2-cp310-cp310-win32.whl", hash = "sha256:50a68f3e3819077be2c98110c1f9dcb3817e93f267ba80a2c05bb4f8799e2ff4"},+ {file = "pydantic_core-2.27.2-cp310-cp310-win_amd64.whl", hash = "sha256:e0fd26b16394ead34a424eecf8a31a1f5137094cabe84a1bcb10fa6ba39d3d31"},+ {file = "pydantic_core-2.27.2-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:8e10c99ef58cfdf2a66fc15d66b16c4a04f62bca39db589ae8cba08bc55331bc"},+ {file = "pydantic_core-2.27.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:26f32e0adf166a84d0cb63be85c562ca8a6fa8de28e5f0d92250c6b7e9e2aff7"},+ {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8c19d1ea0673cd13cc2f872f6c9ab42acc4e4f492a7ca9d3795ce2b112dd7e15"},+ {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5e68c4446fe0810e959cdff46ab0a41ce2f2c86d227d96dc3847af0ba7def306"},+ {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d9640b0059ff4f14d1f37321b94061c6db164fbe49b334b31643e0528d100d99"},+ {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:40d02e7d45c9f8af700f3452f329ead92da4c5f4317ca9b896de7ce7199ea459"},+ {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1c1fd185014191700554795c99b347d64f2bb637966c4cfc16998a0ca700d048"},+ {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d81d2068e1c1228a565af076598f9e7451712700b673de8f502f0334f281387d"},+ {file = "pydantic_core-2.27.2-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:1a4207639fb02ec2dbb76227d7c751a20b1a6b4bc52850568e52260cae64ca3b"},+ {file = "pydantic_core-2.27.2-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:3de3ce3c9ddc8bbd88f6e0e304dea0e66d843ec9de1b0042b0911c1663ffd474"},+ {file = "pydantic_core-2.27.2-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:30c5f68ded0c36466acede341551106821043e9afaad516adfb6e8fa80a4e6a6"},+ {file = "pydantic_core-2.27.2-cp311-cp311-win32.whl", hash = "sha256:c70c26d2c99f78b125a3459f8afe1aed4d9687c24fd677c6a4436bc042e50d6c"},+ {file = "pydantic_core-2.27.2-cp311-cp311-win_amd64.whl", hash = "sha256:08e125dbdc505fa69ca7d9c499639ab6407cfa909214d500897d02afb816e7cc"},+ {file = "pydantic_core-2.27.2-cp311-cp311-win_arm64.whl", hash = "sha256:26f0d68d4b235a2bae0c3fc585c585b4ecc51382db0e3ba402a22cbc440915e4"},+ {file = "pydantic_core-2.27.2-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:9e0c8cfefa0ef83b4da9588448b6d8d2a2bf1a53c3f1ae5fca39eb3061e2f0b0"},+ {file = "pydantic_core-2.27.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:83097677b8e3bd7eaa6775720ec8e0405f1575015a463285a92bfdfe254529ef"},+ {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:172fce187655fece0c90d90a678424b013f8fbb0ca8b036ac266749c09438cb7"},+ {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:519f29f5213271eeeeb3093f662ba2fd512b91c5f188f3bb7b27bc5973816934"},+ {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:05e3a55d124407fffba0dd6b0c0cd056d10e983ceb4e5dbd10dda135c31071d6"},+ {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9c3ed807c7b91de05e63930188f19e921d1fe90de6b4f5cd43ee7fcc3525cb8c"},+ {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6fb4aadc0b9a0c063206846d603b92030eb6f03069151a625667f982887153e2"},+ {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:28ccb213807e037460326424ceb8b5245acb88f32f3d2777427476e1b32c48c4"},+ {file = "pydantic_core-2.27.2-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:de3cd1899e2c279b140adde9357c4495ed9d47131b4a4eaff9052f23398076b3"},+ {file = "pydantic_core-2.27.2-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:220f892729375e2d736b97d0e51466252ad84c51857d4d15f5e9692f9ef12be4"},+ {file = "pydantic_core-2.27.2-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:a0fcd29cd6b4e74fe8ddd2c90330fd8edf2e30cb52acda47f06dd615ae72da57"},+ {file = "pydantic_core-2.27.2-cp312-cp312-win32.whl", hash = "sha256:1e2cb691ed9834cd6a8be61228471d0a503731abfb42f82458ff27be7b2186fc"},+ {file = "pydantic_core-2.27.2-cp312-cp312-win_amd64.whl", hash = "sha256:cc3f1a99a4f4f9dd1de4fe0312c114e740b5ddead65bb4102884b384c15d8bc9"},+ {file = "pydantic_core-2.27.2-cp312-cp312-win_arm64.whl", hash = "sha256:3911ac9284cd8a1792d3cb26a2da18f3ca26c6908cc434a18f730dc0db7bfa3b"},+ {file = "pydantic_core-2.27.2-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:7d14bd329640e63852364c306f4d23eb744e0f8193148d4044dd3dacdaacbd8b"},+ {file = "pydantic_core-2.27.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:82f91663004eb8ed30ff478d77c4d1179b3563df6cdb15c0817cd1cdaf34d154"},+ {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:71b24c7d61131bb83df10cc7e687433609963a944ccf45190cfc21e0887b08c9"},+ {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:fa8e459d4954f608fa26116118bb67f56b93b209c39b008277ace29937453dc9"},+ {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ce8918cbebc8da707ba805b7fd0b382816858728ae7fe19a942080c24e5b7cd1"},+ {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:eda3f5c2a021bbc5d976107bb302e0131351c2ba54343f8a496dc8783d3d3a6a"},+ {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bd8086fa684c4775c27f03f062cbb9eaa6e17f064307e86b21b9e0abc9c0f02e"},+ {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:8d9b3388db186ba0c099a6d20f0604a44eabdeef1777ddd94786cdae158729e4"},+ {file = "pydantic_core-2.27.2-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:7a66efda2387de898c8f38c0cf7f14fca0b51a8ef0b24bfea5849f1b3c95af27"},+ {file = "pydantic_core-2.27.2-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:18a101c168e4e092ab40dbc2503bdc0f62010e95d292b27827871dc85450d7ee"},+ {file = "pydantic_core-2.27.2-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:ba5dd002f88b78a4215ed2f8ddbdf85e8513382820ba15ad5ad8955ce0ca19a1"},+ {file = "pydantic_core-2.27.2-cp313-cp313-win32.whl", hash = "sha256:1ebaf1d0481914d004a573394f4be3a7616334be70261007e47c2a6fe7e50130"},+ {file = "pydantic_core-2.27.2-cp313-cp313-win_amd64.whl", hash = "sha256:953101387ecf2f5652883208769a79e48db18c6df442568a0b5ccd8c2723abee"},+ {file = "pydantic_core-2.27.2-cp313-cp313-win_arm64.whl", hash = "sha256:ac4dbfd1691affb8f48c2c13241a2e3b60ff23247cbcf981759c768b6633cf8b"},+ {file = "pydantic_core-2.27.2-cp38-cp38-macosx_10_12_x86_64.whl", hash = "sha256:d3e8d504bdd3f10835468f29008d72fc8359d95c9c415ce6e767203db6127506"},+ {file = "pydantic_core-2.27.2-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:521eb9b7f036c9b6187f0b47318ab0d7ca14bd87f776240b90b21c1f4f149320"},+ {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:85210c4d99a0114f5a9481b44560d7d1e35e32cc5634c656bc48e590b669b145"},+ {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:d716e2e30c6f140d7560ef1538953a5cd1a87264c737643d481f2779fc247fe1"},+ {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f66d89ba397d92f840f8654756196d93804278457b5fbede59598a1f9f90b228"},+ {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:669e193c1c576a58f132e3158f9dfa9662969edb1a250c54d8fa52590045f046"},+ {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9fdbe7629b996647b99c01b37f11170a57ae675375b14b8c13b8518b8320ced5"},+ {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d262606bf386a5ba0b0af3b97f37c83d7011439e3dc1a9298f21efb292e42f1a"},+ {file = "pydantic_core-2.27.2-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:cabb9bcb7e0d97f74df8646f34fc76fbf793b7f6dc2438517d7a9e50eee4f14d"},+ {file = "pydantic_core-2.27.2-cp38-cp38-musllinux_1_1_armv7l.whl", hash = "sha256:d2d63f1215638d28221f664596b1ccb3944f6e25dd18cd3b86b0a4c408d5ebb9"},+ {file = "pydantic_core-2.27.2-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:bca101c00bff0adb45a833f8451b9105d9df18accb8743b08107d7ada14bd7da"},+ {file = "pydantic_core-2.27.2-cp38-cp38-win32.whl", hash = "sha256:f6f8e111843bbb0dee4cb6594cdc73e79b3329b526037ec242a3e49012495b3b"},+ {file = "pydantic_core-2.27.2-cp38-cp38-win_amd64.whl", hash = "sha256:fd1aea04935a508f62e0d0ef1f5ae968774a32afc306fb8545e06f5ff5cdf3ad"},+ {file = "pydantic_core-2.27.2-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:c10eb4f1659290b523af58fa7cffb452a61ad6ae5613404519aee4bfbf1df993"},+ {file = "pydantic_core-2.27.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:ef592d4bad47296fb11f96cd7dc898b92e795032b4894dfb4076cfccd43a9308"},+ {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c61709a844acc6bf0b7dce7daae75195a10aac96a596ea1b776996414791ede4"},+ {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:42c5f762659e47fdb7b16956c71598292f60a03aa92f8b6351504359dbdba6cf"},+ {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4c9775e339e42e79ec99c441d9730fccf07414af63eac2f0e48e08fd38a64d76"},+ {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:57762139821c31847cfb2df63c12f725788bd9f04bc2fb392790959b8f70f118"},+ {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0d1e85068e818c73e048fe28cfc769040bb1f475524f4745a5dc621f75ac7630"},+ {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:097830ed52fd9e427942ff3b9bc17fab52913b2f50f2880dc4a5611446606a54"},+ {file = "pydantic_core-2.27.2-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:044a50963a614ecfae59bb1eaf7ea7efc4bc62f49ed594e18fa1e5d953c40e9f"},+ {file = "pydantic_core-2.27.2-cp39-cp39-musllinux_1_1_armv7l.whl", hash = "sha256:4e0b4220ba5b40d727c7f879eac379b822eee5d8fff418e9d3381ee45b3b0362"},+ {file = "pydantic_core-2.27.2-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5e4f4bb20d75e9325cc9696c6802657b58bc1dbbe3022f32cc2b2b632c3fbb96"},+ {file = "pydantic_core-2.27.2-cp39-cp39-win32.whl", hash = "sha256:cca63613e90d001b9f2f9a9ceb276c308bfa2a43fafb75c8031c4f66039e8c6e"},+ {file = "pydantic_core-2.27.2-cp39-cp39-win_amd64.whl", hash = "sha256:77d1bca19b0f7021b3a982e6f903dcd5b2b06076def36a652e3907f596e29f67"},+ {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:2bf14caea37e91198329b828eae1618c068dfb8ef17bb33287a7ad4b61ac314e"},+ {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:b0cb791f5b45307caae8810c2023a184c74605ec3bcbb67d13846c28ff731ff8"},+ {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:688d3fd9fcb71f41c4c015c023d12a79d1c4c0732ec9eb35d96e3388a120dcf3"},+ {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3d591580c34f4d731592f0e9fe40f9cc1b430d297eecc70b962e93c5c668f15f"},+ {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:82f986faf4e644ffc189a7f1aafc86e46ef70372bb153e7001e8afccc6e54133"},+ {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:bec317a27290e2537f922639cafd54990551725fc844249e64c523301d0822fc"},+ {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:0296abcb83a797db256b773f45773da397da75a08f5fcaef41f2044adec05f50"},+ {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:0d75070718e369e452075a6017fbf187f788e17ed67a3abd47fa934d001863d9"},+ {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:7e17b560be3c98a8e3aa66ce828bdebb9e9ac6ad5466fba92eb74c4c95cb1151"},+ {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-macosx_10_12_x86_64.whl", hash = "sha256:c33939a82924da9ed65dab5a65d427205a73181d8098e79b6b426bdf8ad4e656"},+ {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:00bad2484fa6bda1e216e7345a798bd37c68fb2d97558edd584942aa41b7d278"},+ {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c817e2b40aba42bac6f457498dacabc568c3b7a986fc9ba7c8d9d260b71485fb"},+ {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:251136cdad0cb722e93732cb45ca5299fb56e1344a833640bf93b2803f8d1bfd"},+ {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d2088237af596f0a524d3afc39ab3b036e8adb054ee57cbb1dcf8e09da5b29cc"},+ {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:d4041c0b966a84b4ae7a09832eb691a35aec90910cd2dbe7a208de59be77965b"},+ {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:8083d4e875ebe0b864ffef72a4304827015cff328a1be6e22cc850753bfb122b"},+ {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:f141ee28a0ad2123b6611b6ceff018039df17f32ada8b534e6aa039545a3efb2"},+ {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:7d0c8399fcc1848491f00e0314bd59fb34a9c008761bcb422a057670c3f65e35"},+ {file = "pydantic_core-2.27.2.tar.gz", hash = "sha256:eb026e5a4c1fee05726072337ff51d1efb6f59090b7da90d30ea58625b1ffb39"},+]++[package.dependencies]+typing-extensions = ">=4.6.0,<4.7.0 || >4.7.0"++[[package]]+name = "setuptools"+version = "76.0.0"+description = "Easily download, build, install, upgrade, and uninstall Python packages"+optional = false+python-versions = ">=3.9"+files = [+ {file = "setuptools-76.0.0-py3-none-any.whl", hash = "sha256:199466a166ff664970d0ee145839f5582cb9bca7a0a3a2e795b6a9cb2308e9c6"},+ {file = "setuptools-76.0.0.tar.gz", hash = "sha256:43b4ee60e10b0d0ee98ad11918e114c70701bc6051662a9a675a0496c1a158f4"},+]++[package.extras]+check = ["pytest-checkdocs (>=2.4)", "pytest-ruff (>=0.2.1)", "ruff (>=0.8.0)"]+core = ["importlib_metadata (>=6)", "jaraco.collections", "jaraco.functools (>=4)", "jaraco.text (>=3.7)", "more_itertools", "more_itertools (>=8.8)", "packaging", "packaging (>=24.2)", "platformdirs (>=4.2.2)", "tomli (>=2.0.1)", "wheel (>=0.43.0)"]+cover = ["pytest-cov"]+doc = ["furo", "jaraco.packaging (>=9.3)", "jaraco.tidelift (>=1.4)", "pygments-github-lexers (==0.0.5)", "pyproject-hooks (!=1.1)", "rst.linker (>=1.9)", "sphinx (>=3.5)", "sphinx-favicon", "sphinx-inline-tabs", "sphinx-lint", "sphinx-notfound-page (>=1,<2)", "sphinx-reredirects", "sphinxcontrib-towncrier", "towncrier (<24.7)"]+enabler = ["pytest-enabler (>=2.2)"]+test = ["build[virtualenv] (>=1.0.3)", "filelock (>=3.4.0)", "ini2toml[lite] (>=0.14)", "jaraco.develop (>=7.21)", "jaraco.envs (>=2.2)", "jaraco.path (>=3.7.2)", "jaraco.test (>=5.5)", "packaging (>=24.2)", "pip (>=19.1)", "pyproject-hooks (!=1.1)", "pytest (>=6,!=8.1.*)", "pytest-home (>=0.5)", "pytest-perf", "pytest-subprocess", "pytest-timeout", "pytest-xdist (>=3)", "tomli-w (>=1.0.0)", "virtualenv (>=13.0.0)", "wheel (>=0.44.0)"]+type = ["importlib_metadata (>=7.0.2)", "jaraco.develop (>=7.21)", "mypy (==1.14.*)", "pytest-mypy"]++[[package]]+name = "types-setuptools"+version = "76.0.0.20250313"+description = "Typing stubs for setuptools"+optional = false+python-versions = ">=3.9"+files = [+ {file = "types_setuptools-76.0.0.20250313-py3-none-any.whl", hash = "sha256:bf454b2a49b8cfd7ebcf5844d4dd5fe4c8666782df1e3663c5866fd51a47460e"},+ {file = "types_setuptools-76.0.0.20250313.tar.gz", hash = "sha256:b2be66f550f95f3cad2a7d46177b273c7e9c80df7d257fa57addbbcfc8126a9e"},+]++[package.dependencies]+setuptools = "*"++[[package]]+name = "typing-extensions"+version = "4.12.2"+description = "Backported and Experimental Type Hints for Python 3.8+"+optional = false+python-versions = ">=3.8"+files = [+ {file = "typing_extensions-4.12.2-py3-none-any.whl", hash = "sha256:04e5ca0351e0f3f85c6853954072df659d0d13fac324d0072316b67d7794700d"},+ {file = "typing_extensions-4.12.2.tar.gz", hash = "sha256:1a7ead55c7e559dd4dee8856e3a88b41225abfe1ce8df57b7c13915fe121ffb8"},+]++[metadata]+lock-version = "2.0"+python-versions = ">=3.9"+content-hash = "6dbb4841929e2cd379b2c804ab6a261413788d70cedd18a495e3d62c7105a2f2"diff --git a/py/stream/pyproject.toml b/py/stream/pyproject.tomlnew file mode 100644index 000000000..16041d039--- /dev/null+++ b/py/stream/pyproject.toml@@ -0,0 +1,27 @@+[build-system]+requires = ["poetry-core"]+build-backend = "poetry.core.masonry.api"++[tool.poetry]+name = "crayonai_stream"+version = "0.6.0"+description = "Streaming utilities for CrayonAI"+authors = ["Thesys Inc. <[email protected]>"]+readme = "README.md"+license = "MIT"+packages = [{include = "crayonai_stream", from = "src"}]++[tool.poetry.dependencies]+python = ">=3.9"+pydantic = ">=2.0.0"+typing-extensions = ">=4.0.0"+types-setuptools = "^76.0.0.20250313"+++[tool.black]+line-length = 88+target-version = ["py39"]++[tool.isort]+profile = "black"+multi_line_output = 3diff --git a/py/stream/setup.py b/py/stream/setup.pynew file mode 100644index 000000000..15a99697e--- /dev/null+++ b/py/stream/setup.py@@ -0,0 +1,15 @@+from setuptools import setup, find_packages++setup(+ name="crayonai_stream",+ version="0.6.0",+ description="Streaming utilities for CrayonAI",+ author="CrayonAI",+ packages=find_packages(where="src"),+ package_dir={"": "src"},+ python_requires=">=3.9",+ install_requires=[+ "pydantic>=2.0.0",+ "typing-extensions>=4.0.0",+ ],+)diff --git a/py/stream/src/crayonai_stream/__init__.py b/py/stream/src/crayonai_stream/__init__.pynew file mode 100644index 000000000..7fbf876cd--- /dev/null+++ b/py/stream/src/crayonai_stream/__init__.py@@ -0,0 +1,36 @@+from crayonai_stream.crayon_message import CrayonMessage+from crayonai_stream.js_schema_helpers import (+ TemplateDefinition,+ pydantic_to_template_schema,+ templates_to_response_format,+)+from crayonai_stream.openai_helper import toOpenAIMessage+from crayonai_stream.protocol import (+ Chunk,+ ContextUpdate,+ Error,+ MessageUpdate,+ ResponseTemplate,+ ResponseTemplatePropsChunk,+ SSEType,+ TextChunk,+)+from crayonai_stream.stream import crayon_stream++__all__ = [+ "Chunk",+ "TextChunk",+ "ResponseTemplate",+ "ResponseTemplatePropsChunk",+ "ContextUpdate",+ "MessageUpdate",+ "Error",+ "SSEType",+ "pydantic_to_template_schema",+ "templates_to_response_format",+ "TextResponseSchema",+ "toOpenAIMessage",+ "crayon_stream",+ "CrayonMessage",+ "TemplateDefinition",+]diff --git a/py/stream/src/crayonai_stream/crayon_message.py b/py/stream/src/crayonai_stream/crayon_message.pynew file mode 100644index 000000000..44e2617f5--- /dev/null+++ b/py/stream/src/crayonai_stream/crayon_message.py@@ -0,0 +1,12 @@+from typing import List, Literal, Union++from pydantic import BaseModel+++class CrayonMessage(BaseModel):+ id: str+ role: Literal["user", "assistant"]+ message: Union[str, List[dict]]++ class Config:+ extra = "allow" # Allow extra fieldsdiff --git a/py/stream/src/crayonai_stream/js_schema_helpers.py b/py/stream/src/crayonai_stream/js_schema_helpers.pynew file mode 100644index 000000000..bd0aca132--- /dev/null+++ b/py/stream/src/crayonai_stream/js_schema_helpers.py@@ -0,0 +1,105 @@+"""+Helpers for converting Pydantic models to JSON schemas and creating template response formats.+"""++from typing import List, Literal, Optional, TypedDict++from pydantic import BaseModel++# JSON schema for a simple text based response.+# This should be used as the default/fallback response type when using structured outputs.+TextResponseSchema = {+ "type": "object",+ "description": "Use this as a fallback when no other response template is applicable",+ "properties": {+ "type": {"const": "text"},+ "text": {+ "type": "string",+ "description": "plaintext message to be displayed to the user",+ },+ },+ "required": ["type", "text"],+ "additionalProperties": False,+}+++def pydantic_to_template_schema(+ schema: type[BaseModel], name: str, description: Optional[str] = None+) -> dict:+ """+ Convert a Pydantic model to a template schema.+ Equivalent to zodToTemplateSchema in TypeScript.++ Args:+ schema: A Pydantic model class+ name: The template name+ description: Optional description of the template++ Returns:+ A JSON schema dictionary for the template+ """+ return {+ "type": "object",+ "description": description,+ "properties": {+ "type": {+ "const": "template",+ },+ "name": {"const": name},+ "templateProps": schema.model_json_schema(),+ },+ "required": ["name", "templateProps", "type"],+ "additionalProperties": False,+ }+++class TemplateDefinition(TypedDict):+ """Type definition for template parameters."""++ schema: type[BaseModel]+ name: str+ description: Optional[str]+++def templates_to_response_format(*templates: TemplateDefinition) -> dict:+ """+ Convert multiple templates to a response format schema.+ Equivalent to templatesToResponseFormat in TypeScript.++ Args:+ *templates: Variable number of TemplateDefinition objects++ Returns:+ A dictionary containing the JSON schema configuration+ """+ templates_json_schema = {+ "type": "object",+ "properties": {+ "response": {+ "type": "array",+ "items": {+ "oneOf": [+ TextResponseSchema,+ *[+ pydantic_to_template_schema(+ template["schema"],+ template["name"],+ template.get("description"),+ )+ for template in templates+ ],+ ],+ },+ },+ },+ "required": ["response"],+ "additionalProperties": False,+ }++ return {+ "type": "json_schema",+ "json_schema": {+ "name": "json_schema",+ "schema": templates_json_schema,+ },+ }diff --git a/py/stream/src/crayonai_stream/openai_helper.py b/py/stream/src/crayonai_stream/openai_helper.pynew file mode 100644index 000000000..9b063a5a4--- /dev/null+++ b/py/stream/src/crayonai_stream/openai_helper.py@@ -0,0 +1,40 @@+import json+from typing import Union++from openai.types.chat import (+ ChatCompletionAssistantMessageParam,+ ChatCompletionSystemMessageParam,+ ChatCompletionUserMessageParam,+)+from pydantic import BaseModel++from crayonai_stream.crayon_message import CrayonMessage+++def _message_content(msg: CrayonMessage) -> str:+ if msg.role == "user":+ assert isinstance(msg.message, str), "User messages must be strings"+ return msg.message+ else:+ assert isinstance(msg.message, list), "Assistant messages must be lists"+ return json.dumps({"response": msg.message}, ensure_ascii=False)+++def toOpenAIMessage(+ msg: CrayonMessage,+) -> Union[+ ChatCompletionUserMessageParam,+ ChatCompletionAssistantMessageParam,+ ChatCompletionSystemMessageParam,+]:+ if msg.role == "user":+ return ChatCompletionUserMessageParam(+ role="user",+ content=_message_content(msg),+ )+ elif msg.role == "assistant":+ return ChatCompletionAssistantMessageParam(+ role="assistant",+ content=_message_content(msg),+ )+ raise ValueError(f"Invalid role: {msg.role}")diff --git a/py/stream/src/crayonai_stream/protocol.py b/py/stream/src/crayonai_stream/protocol.pynew file mode 100644index 000000000..500a80aa4--- /dev/null+++ b/py/stream/src/crayonai_stream/protocol.py@@ -0,0 +1,68 @@+from abc import ABC, abstractmethod+from enum import Enum+from typing import Any, Dict, List, Optional, Union++from pydantic import BaseModel++from crayonai_stream.sse import encode_json_sse, encode_sse++JSONValue = Union[str, int, float, bool, Dict[str, Any], List[Any], None]+++class SSEType(str, Enum):+ TextDelta = "text"+ ResponseTemplate = "tpl"+ ResponseTemplatePropsChunk = "tpl_props_chunk"+ ContextAppend = "context_append"+ MessageUpdate = "message_update"+ Error = "error"+++class Chunk(BaseModel, ABC):+ @abstractmethod+ def toSSEString(self) -> str:+ pass+++class TextChunk(Chunk):+ chunk: str++ def toSSEString(self) -> str:+ return encode_sse(SSEType.TextDelta, self.chunk)+++class ResponseTemplate(Chunk):+ name: str+ templateProps: Optional[dict] = None++ def toSSEString(self) -> str:+ data = {"name": self.name, "templateProps": self.templateProps}+ return encode_json_sse(SSEType.ResponseTemplate, data)+++class ResponseTemplatePropsChunk(Chunk):+ chunk: str++ def toSSEString(self) -> str:+ return encode_sse(SSEType.ResponseTemplatePropsChunk, self.chunk)+++class ContextUpdate(Chunk):+ contextItem: JSONValue++ def toSSEString(self) -> str:+ return encode_json_sse(SSEType.ContextAppend, self.contextItem)+++class MessageUpdate(Chunk):+ id: str++ def toSSEString(self) -> str:+ return encode_json_sse(SSEType.MessageUpdate, {"id": self.id})+++class Error(Chunk):+ error: str++ def toSSEString(self) -> str:+ return encode_sse(SSEType.Error, self.error)diff --git a/py/stream/src/crayonai_stream/py.typed b/py/stream/src/crayonai_stream/py.typednew file mode 100644index 000000000..0519ecba6--- /dev/null+++ b/py/stream/src/crayonai_stream/py.typed@@ -0,0 +1 @@+\ No newline at end of filediff --git a/py/stream/src/crayonai_stream/sse.py b/py/stream/src/crayonai_stream/sse.pynew file mode 100644index 000000000..abfd3c7c6--- /dev/null+++ b/py/stream/src/crayonai_stream/sse.py@@ -0,0 +1,42 @@+import json+++def encode_sse(event: str, data: str) -> str:+ """+ Encode data as a Server-Sent Events (SSE) message.+ Similar to the eventsource-encoder package in TypeScript.++ Args:+ event: The event type+ data: The data to send++ Returns:+ A properly formatted SSE message string+ """+ message = []+ if event:+ message.append(f"event: {event}")++ # Split data by newlines and prefix each line with "data: "+ for line in data.split("\n"):+ message.append(f"data: {line}")++ # End with double newline as per SSE spec+ message.append("")+ message.append("")++ return "\n".join(message)+++def encode_json_sse(event: str, data: object) -> str:+ """+ Encode JSON data as a Server-Sent Events (SSE) message.++ Args:+ event: The event type+ data: The data to encode as JSON++ Returns:+ A properly formatted SSE message string with JSON data+ """+ return encode_sse(event, json.dumps(data))diff --git a/py/stream/src/crayonai_stream/stream.py b/py/stream/src/crayonai_stream/stream.pynew file mode 100644index 000000000..71573740e--- /dev/null+++ b/py/stream/src/crayonai_stream/stream.py@@ -0,0 +1,30 @@+import json+from typing import Iterator++from openai import Stream+from openai._streaming import Stream+from openai.types.chat import ChatCompletionChunk++from crayonai_stream import Error, ResponseTemplate, TextChunk+++# TODO: Implement actual streaming.+def crayon_stream(+ stream: Stream[ChatCompletionChunk],+) -> Iterator[str]:+ streamed_text = ""+ try:+ for chunk in stream:+ text = chunk.choices[0].delta.content+ if text is not None:+ streamed_text += text+ parsed = json.loads(streamed_text)+ for item in parsed["response"]:+ if item["type"] == "text":+ yield TextChunk(chunk=item["text"]).toSSEString()+ elif item["type"] == "template":+ yield ResponseTemplate(+ name=item["name"], templateProps=item["templateProps"]+ ).toSSEString()+ except Exception as e:+ yield Error(error=str(e)).toSSEString()