waldiez 0.5.6__tar.gz → 0.5.8__tar.gz

{waldiez-0.5.6 → waldiez-0.5.8}/.gitignore

@@ -37,6 +37,7 @@ dmypy.json
 **/*.tsbuildinfo
 **/*.egg-info
 **/.DS_Store
+chroma/
 waldiez/_version.py
 **/*.mmd
 docs/contribute/index.md

{waldiez-0.5.6 → waldiez-0.5.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: waldiez
-Version: 0.5.6
+Version: 0.5.8
 Dynamic: Keywords
 Summary: Make AG2 Agents Collaborate: Drag, Drop, and Orchestrate with Waldiez.
 Project-URL: Homepage, https://waldiez.io
@@ -27,7 +27,7 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Code Generators
 Classifier: Typing :: Typed
 Requires-Python: <3.14,>=3.10
-Requires-Dist: ag2[openai]==0.9.6
+Requires-Dist: ag2[openai]==0.9.7
 Requires-Dist: aiocsv==1.3.2
 Requires-Dist: aiofiles==24.1.0
 Requires-Dist: aiosqlite==0.21.0
@@ -37,7 +37,7 @@ Requires-Dist: graphviz<=0.21
 Requires-Dist: httpx<1
 Requires-Dist: jupytext
 Requires-Dist: nest-asyncio==1.6.0
-Requires-Dist: numpy<=2.3.1
+Requires-Dist: numpy<=2.3.2
 Requires-Dist: pandas>=2
 Requires-Dist: parso==0.8.4
 Requires-Dist: pillow
@@ -47,45 +47,45 @@ Requires-Dist: pydantic<3,>=2.10.2
 Requires-Dist: rpds-py==0.26.0
 Requires-Dist: typer<1,>=0.9.0
 Provides-Extra: ag2-extras
-Requires-Dist: ag2[anthropic]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[autobuild]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[bedrock]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[blendsearch]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[cohere]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[commsagent-discord]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[commsagent-slack]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[commsagent-telegram]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[crawl4ai]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[duckduckgo]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[gemini-realtime]==0.9.6; (sys_platform != 'win32') and extra == 'ag2-extras'
-Requires-Dist: ag2[gemini-realtime]==0.9.6; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
-Requires-Dist: ag2[gemini]==0.9.6; (sys_platform != 'win32') and extra == 'ag2-extras'
-Requires-Dist: ag2[gemini]==0.9.6; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
-Requires-Dist: ag2[google-api]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[google-client]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[google-search]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[groq]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[interop-crewai]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[interop-langchain]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[lmm]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[mcp]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[mistral]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[neo4j]==0.9.6; (sys_platform != 'win32') and extra == 'ag2-extras'
-Requires-Dist: ag2[neo4j]==0.9.6; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
-Requires-Dist: ag2[ollama]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[openai-realtime]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[rag]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[redis]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[tavily]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[together]==0.9.6; (sys_platform != 'win32') and extra == 'ag2-extras'
-Requires-Dist: ag2[together]==0.9.6; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
-Requires-Dist: ag2[twilio]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[websockets]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[websurfer]==0.9.6; extra == 'ag2-extras'
-Requires-Dist: ag2[wikipedia]==0.9.6; extra == 'ag2-extras'
+Requires-Dist: ag2[anthropic]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[autobuild]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[bedrock]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[blendsearch]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[cohere]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[commsagent-discord]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[commsagent-slack]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[commsagent-telegram]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[crawl4ai]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[duckduckgo]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[gemini-realtime]==0.9.7; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: ag2[gemini-realtime]==0.9.7; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
+Requires-Dist: ag2[gemini]==0.9.7; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: ag2[gemini]==0.9.7; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
+Requires-Dist: ag2[google-api]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[google-client]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[google-search]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[groq]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[interop-crewai]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[interop-langchain]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[lmm]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[mcp]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[mistral]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[neo4j]==0.9.7; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: ag2[neo4j]==0.9.7; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
+Requires-Dist: ag2[ollama]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[openai-realtime]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[rag]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[redis]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[tavily]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[together]==0.9.7; (sys_platform != 'win32') and extra == 'ag2-extras'
+Requires-Dist: ag2[together]==0.9.7; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
+Requires-Dist: ag2[twilio]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[websockets]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[websurfer]==0.9.7; extra == 'ag2-extras'
+Requires-Dist: ag2[wikipedia]==0.9.7; extra == 'ag2-extras'
 Requires-Dist: chromadb>=0.5.10; (sys_platform != 'win32') and extra == 'ag2-extras'
 Requires-Dist: chromadb>=0.5.10; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
-Requires-Dist: couchbase>=4.3.0; extra == 'ag2-extras'
+Requires-Dist: couchbase>=4.4.0; extra == 'ag2-extras'
 Requires-Dist: fastembed>=0.3.1; extra == 'ag2-extras'
 Requires-Dist: pgvector>=0.4.0; extra == 'ag2-extras'
 Requires-Dist: psycopg>=3.2.6; (sys_platform == 'linux') and extra == 'ag2-extras'
@@ -99,21 +99,21 @@ Requires-Dist: pymongo>=4.11; extra == 'ag2-extras'
 Requires-Dist: qdrant-client[fastembed]; (sys_platform != 'win32') and extra == 'ag2-extras'
 Requires-Dist: qdrant-client[fastembed]; (sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64') and extra == 'ag2-extras'
 Provides-Extra: dev
-Requires-Dist: ag2[redis]==0.9.6; extra == 'dev'
-Requires-Dist: ag2[websockets]==0.9.6; extra == 'dev'
+Requires-Dist: ag2[redis]==0.9.7; extra == 'dev'
+Requires-Dist: ag2[websockets]==0.9.7; extra == 'dev'
 Requires-Dist: autoflake==2.3.1; extra == 'dev'
 Requires-Dist: bandit==1.8.6; extra == 'dev'
 Requires-Dist: black[jupyter]==25.1.0; extra == 'dev'
-Requires-Dist: build==1.2.2.post1; extra == 'dev'
-Requires-Dist: fakeredis==2.30.1; extra == 'dev'
+Requires-Dist: build==1.3.0; extra == 'dev'
+Requires-Dist: fakeredis==2.30.3; extra == 'dev'
 Requires-Dist: fastjsonschema>=2.21.1; extra == 'dev'
 Requires-Dist: flake8==7.3.0; extra == 'dev'
 Requires-Dist: hatchling==1.27.0; extra == 'dev'
 Requires-Dist: jsonschema==4.25.0; extra == 'dev'
 Requires-Dist: jupyter-server==2.16.0; extra == 'dev'
-Requires-Dist: jupyterlab<5.0,>=4.4.0; extra == 'dev'
+Requires-Dist: jupyterlab==4.4.5; extra == 'dev'
 Requires-Dist: mypy-extensions>=1.1.0; extra == 'dev'
-Requires-Dist: mypy==1.17.0; extra == 'dev'
+Requires-Dist: mypy==1.17.1; extra == 'dev'
 Requires-Dist: nbclient>=0.10.2; extra == 'dev'
 Requires-Dist: nbconvert>=7.16.6; extra == 'dev'
 Requires-Dist: nbformat>=5.10.4; extra == 'dev'
@@ -125,9 +125,9 @@ Requires-Dist: pre-commit==4.2.0; extra == 'dev'
 Requires-Dist: pydocstyle==6.3.0; extra == 'dev'
 Requires-Dist: pylint==3.3.7; extra == 'dev'
 Requires-Dist: python-dotenv>=1.1.1; extra == 'dev'
-Requires-Dist: ruff==0.12.4; extra == 'dev'
+Requires-Dist: ruff==0.12.7; extra == 'dev'
 Requires-Dist: toml==0.10.2; (python_version <= '3.10') and extra == 'dev'
-Requires-Dist: types-aiofiles==24.1.0.20250708; extra == 'dev'
+Requires-Dist: types-aiofiles==24.1.0.20250801; extra == 'dev'
 Requires-Dist: types-jsonschema==4.25.0.20250720; extra == 'dev'
 Requires-Dist: types-pyyaml==6.0.12.20250516; extra == 'dev'
 Requires-Dist: types-redis==4.6.0.20241004; extra == 'dev'
@@ -143,8 +143,8 @@ Requires-Dist: mkdocs-autorefs==1.4.2; extra == 'docs'
 Requires-Dist: mkdocs-awesome-nav==3.1.2; extra == 'docs'
 Requires-Dist: mkdocs-jupyter==0.25.1; extra == 'docs'
 Requires-Dist: mkdocs-macros-plugin==1.3.7; extra == 'docs'
-Requires-Dist: mkdocs-material==9.6.15; extra == 'docs'
-Requires-Dist: mkdocs-minify-html-plugin==0.3.1; extra == 'docs'
+Requires-Dist: mkdocs-material==9.6.16; extra == 'docs'
+Requires-Dist: mkdocs-minify-html-plugin==0.3.4; extra == 'docs'
 Requires-Dist: mkdocs-open-in-new-tab==1.0.8; extra == 'docs'
 Requires-Dist: mkdocs==1.6.1; extra == 'docs'
 Requires-Dist: mkdocstrings-crystal==0.3.7; extra == 'docs'
@@ -152,21 +152,22 @@ Requires-Dist: mkdocstrings-python==1.16.12; extra == 'docs'
 Requires-Dist: mkdocstrings[crystal,python]==0.30.0; extra == 'docs'
 Requires-Dist: natsort==8.4.0; extra == 'docs'
 Provides-Extra: jupyter
+Requires-Dist: ipywidgets==8.1.7; extra == 'jupyter'
 Requires-Dist: jupyter-server==2.16.0; extra == 'jupyter'
-Requires-Dist: jupyterlab<5.0,>=4.3.0; extra == 'jupyter'
-Requires-Dist: waldiez-jupyter==0.5.6; extra == 'jupyter'
+Requires-Dist: jupyterlab==4.4.5; extra == 'jupyter'
+Requires-Dist: waldiez-jupyter==0.5.8; extra == 'jupyter'
 Provides-Extra: mqtt
 Requires-Dist: paho-mqtt<3.0,>=2.1.0; extra == 'mqtt'
 Provides-Extra: redis
-Requires-Dist: ag2[redis]==0.9.6; extra == 'redis'
+Requires-Dist: ag2[redis]==0.9.7; extra == 'redis'
 Provides-Extra: runner
-Requires-Dist: waldiez-runner==0.5.6; (python_version >= '3.11') and extra == 'runner'
+Requires-Dist: waldiez-runner==0.5.8; (python_version >= '3.11') and extra == 'runner'
 Provides-Extra: studio
-Requires-Dist: waldiez-studio==0.5.6; extra == 'studio'
+Requires-Dist: waldiez-studio==0.5.8; extra == 'studio'
 Provides-Extra: test
-Requires-Dist: ag2[redis]==0.9.6; extra == 'test'
-Requires-Dist: ag2[websockets]==0.9.6; extra == 'test'
-Requires-Dist: fakeredis==2.30.1; extra == 'test'
+Requires-Dist: ag2[redis]==0.9.7; extra == 'test'
+Requires-Dist: ag2[websockets]==0.9.7; extra == 'test'
+Requires-Dist: fakeredis==2.30.3; extra == 'test'
 Requires-Dist: paho-mqtt<3.0,>=2.1.0; extra == 'test'
 Requires-Dist: pytest-asyncio==1.1.0; extra == 'test'
 Requires-Dist: pytest-cov==6.2.1; extra == 'test'
@@ -177,7 +178,7 @@ Requires-Dist: pytest-timeout==2.4.0; extra == 'test'
 Requires-Dist: pytest-xdist==3.8.0; extra == 'test'
 Requires-Dist: pytest==8.4.1; extra == 'test'
 Provides-Extra: websockets
-Requires-Dist: ag2[websockets]==0.9.6; extra == 'websockets'
+Requires-Dist: ag2[websockets]==0.9.7; extra == 'websockets'
 Description-Content-Type: text/markdown
 
 # Waldiez
@@ -216,7 +217,7 @@ python -m pip install git+https://github.com/waldiez/waldiez.git
 
 If you’re looking for the React component, please refer to [README.npm](https://github.com/waldiez/waldiez/blob/main/README.npm.md).
 
-> Note: The React component is only for creating and editing flows — it is not needed to convert or run flows (that functionality is handled by the Python package).
+> Note: The React component is only for creating and editing flows — it is not used for converting or running flows (that functionality is handled by the Python package).
 
 To add the waldiez library to your app:
 
@@ -319,14 +320,15 @@ $CONTAINER_COMMAND run --rm -it \
 
 ### As a library
 
-#### Export a flow
+#### Generate a script or a notebook from a flow
 
 ```python
 # Export a Waldiez flow to a python script or a jupyter notebook
+from pathlib import Path
 from waldiez import WaldiezExporter
 flow_path = "/path/to/a/flow.waldiez"
 output_path = "/path/to/an/output.py"  # or .ipynb
-exporter = WaldiezExporter.load(flow_path)
+exporter = WaldiezExporter.load(Path(flow_path))
 exporter.export(output_path)
 ```
 
@@ -334,10 +336,11 @@ exporter.export(output_path)
 
 ```python
 # Run a flow
+from pathlib import Path
 from waldiez import WaldiezRunner
 flow_path = "/path/to/a/flow.waldiez"
 output_path = "/path/to/an/output.py"
-runner = WaldiezRunner.load(flow_path)
+runner = WaldiezRunner.load(Path(flow_path))
 runner.run(output_path=output_path)
 ```
 
@@ -375,6 +378,7 @@ runner.run(output_path=output_path)
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
 
+<!--suppress ALL -->
 <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->
@@ -392,8 +396,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <tr>
       <td align="center" size="13px" colspan="7">
         <img src="https://raw.githubusercontent.com/all-contributors/all-contributors-cli/1b8533af435da9854653492b1327a23a4dbd0a10/assets/logo-small.svg">
-          <a href="https://all-contributors.js.org/docs/en/bot/usage">Add your contributions</a>
-        </img>
+        <a href="https://all-contributors.js.org/docs/en/bot/usage">Add your contributions</a>
       </td>
     </tr>
   </tfoot>

{waldiez-0.5.6 → waldiez-0.5.8}/README.md

@@ -34,7 +34,7 @@ python -m pip install git+https://github.com/waldiez/waldiez.git
 
 If you’re looking for the React component, please refer to [README.npm](https://github.com/waldiez/waldiez/blob/main/README.npm.md).
 
-> Note: The React component is only for creating and editing flows — it is not needed to convert or run flows (that functionality is handled by the Python package).
+> Note: The React component is only for creating and editing flows — it is not used for converting or running flows (that functionality is handled by the Python package).
 
 To add the waldiez library to your app:
 
@@ -137,14 +137,15 @@ $CONTAINER_COMMAND run --rm -it \
 
 ### As a library
 
-#### Export a flow
+#### Generate a script or a notebook from a flow
 
 ```python
 # Export a Waldiez flow to a python script or a jupyter notebook
+from pathlib import Path
 from waldiez import WaldiezExporter
 flow_path = "/path/to/a/flow.waldiez"
 output_path = "/path/to/an/output.py"  # or .ipynb
-exporter = WaldiezExporter.load(flow_path)
+exporter = WaldiezExporter.load(Path(flow_path))
 exporter.export(output_path)
 ```
 
@@ -152,10 +153,11 @@ exporter.export(output_path)
 
 ```python
 # Run a flow
+from pathlib import Path
 from waldiez import WaldiezRunner
 flow_path = "/path/to/a/flow.waldiez"
 output_path = "/path/to/an/output.py"
-runner = WaldiezRunner.load(flow_path)
+runner = WaldiezRunner.load(Path(flow_path))
 runner.run(output_path=output_path)
 ```
 
@@ -193,6 +195,7 @@ runner.run(output_path=output_path)
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
 
+<!--suppress ALL -->
 <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->
@@ -210,8 +213,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <tr>
       <td align="center" size="13px" colspan="7">
         <img src="https://raw.githubusercontent.com/all-contributors/all-contributors-cli/1b8533af435da9854653492b1327a23a4dbd0a10/assets/logo-small.svg">
-          <a href="https://all-contributors.js.org/docs/en/bot/usage">Add your contributions</a>
-        </img>
+        <a href="https://all-contributors.js.org/docs/en/bot/usage">Add your contributions</a>
       </td>
     </tr>
   </tfoot>

{waldiez-0.5.6 → waldiez-0.5.8}/pyproject.toml

@@ -3,7 +3,7 @@
 build-backend = "hatchling.build"
 requires = [
   "hatchling==1.27.0",
-  "hatch-nodejs-version==0.3.2",
+  "hatch-nodejs-version==0.4.0",
 ]
 [project]
 classifiers = [
@@ -27,12 +27,12 @@ classifiers = [
 ]
 
 dependencies = [
-  "ag2[openai]==0.9.6",
+  "ag2[openai]==0.9.7",
   "aiocsv==1.3.2",
   "aiofiles==24.1.0",
   "aiosqlite==0.21.0",
   "asyncer==0.0.8",
-  "numpy<=2.3.1",
+  "numpy<=2.3.2",
   "nest_asyncio==1.6.0",
   "graphviz<=0.21",
   "pandas>=2",
@@ -43,15 +43,15 @@ dependencies = [
   "rpds-py==0.26.0",
   "platformdirs==4.3.8",
   "pydantic>=2.10.2,<3",
-  # ag2[together]==0.9.6 depends on together>=1.2
+  # ag2[together]==0.9.7 depends on together>=1.2
   # together>=1.2 depends on typer>=0.9,<0.16
   "typer>=0.9.0,<1",
   "click<8.2",
-  # ../site-packages/click/types.py", line 54, in init
+  # ../site-packages/click/types.py, line 54, in init
   #     self.name = func.name
   #                 ^^^^^^^^^^^^^
   # AttributeError: 'tuple' object has no attribute 'name'
-  # ../site-packages/httpx/_main.py", line 379, in <module>
+  # ../site-packages/httpx/_main.py, line 379, in <module>
   #   @click.option(
   #    ~~~~~~~~~~~~^
   #       "--auth",
@@ -72,72 +72,73 @@ waldiez = "waldiez.cli:app"
 [project.optional-dependencies]
 # stream-io-extensions: redis, websockets, mqtt
 redis = [
-    "ag2[redis]==0.9.6",
+    "ag2[redis]==0.9.7",
 ]
 websockets = [
-    "ag2[websockets]==0.9.6",
+    "ag2[websockets]==0.9.7",
 ]
 mqtt = [
     "paho-mqtt>=2.1.0,<3.0",
 ]
 # jupyterlab extension
 jupyter = [
-  "waldiez_jupyter==0.5.6",
-  "jupyterlab>=4.3.0,<5.0",
+  "waldiez_jupyter==0.5.8",
+  "jupyterlab==4.4.5",
+  "ipywidgets==8.1.7",
   "jupyter_server==2.16.0",
 ]
 runner = [
-  "waldiez_runner==0.5.6; python_version >= '3.11'",
+  "waldiez_runner==0.5.8; python_version >= '3.11'",
 ]
 studio = [
-  "waldiez_studio==0.5.6",
+  "waldiez_studio==0.5.8",
 ]
 ag2_extras = [
-  "ag2[anthropic]==0.9.6",
-  "ag2[autobuild]==0.9.6",
-  "ag2[bedrock]==0.9.6",
-  "ag2[blendsearch]==0.9.6",
-  "ag2[cohere]==0.9.6",
-  "ag2[commsagent-discord]==0.9.6",
-  "ag2[commsagent-slack]==0.9.6",
-  "ag2[commsagent-telegram]==0.9.6",
-  "ag2[crawl4ai]==0.9.6",
-  "ag2[duckduckgo]==0.9.6",
-  "ag2[gemini-realtime]==0.9.6;sys_platform != 'win32'",
-  "ag2[gemini-realtime]==0.9.6;sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64'",
-  "ag2[gemini]==0.9.6;sys_platform != 'win32'",
-  "ag2[gemini]==0.9.6;sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64'",
-  "ag2[google-api]==0.9.6",
-  "ag2[google-client]==0.9.6",
-  "ag2[google-search]==0.9.6",
-  "ag2[groq]==0.9.6",
-  "ag2[interop-crewai]==0.9.6",
-  "ag2[interop-langchain]==0.9.6",
-  "ag2[lmm]==0.9.6",
-  # "ag2[mcp-proxy-gen]==0.9.6",
-  "ag2[mcp]==0.9.6",
-  "ag2[mistral]==0.9.6",
-  "ag2[neo4j]==0.9.6;sys_platform != 'win32'",
-  "ag2[neo4j]==0.9.6;sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64'",
-  "ag2[ollama]==0.9.6",
-  "ag2[openai-realtime]==0.9.6",
-  "ag2[rag]==0.9.6",
-  "ag2[redis]==0.9.6",
-  "ag2[tavily]==0.9.6",
-  # "ag2[retrievechat-couchbase]==0.9.6",
-  # "ag2[retrievechat-mongodb]==0.9.6",
-  # "ag2[retrievechat-pgvector]==0.9.6",
-  # "ag2[retrievechat-qdrant]==0.9.6",
-  # "ag2[retrievechat]==0.9.6",
-  "ag2[together]==0.9.6;sys_platform != 'win32'",
-  "ag2[together]==0.9.6;sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64'",
-  "ag2[twilio]==0.9.6",
-  "ag2[websockets]==0.9.6",
-  "ag2[websurfer]==0.9.6",
-  "ag2[wikipedia]==0.9.6",
+  "ag2[anthropic]==0.9.7",
+  "ag2[autobuild]==0.9.7",
+  "ag2[bedrock]==0.9.7",
+  "ag2[blendsearch]==0.9.7",
+  "ag2[cohere]==0.9.7",
+  "ag2[commsagent-discord]==0.9.7",
+  "ag2[commsagent-slack]==0.9.7",
+  "ag2[commsagent-telegram]==0.9.7",
+  "ag2[crawl4ai]==0.9.7",
+  "ag2[duckduckgo]==0.9.7",
+  "ag2[gemini-realtime]==0.9.7;sys_platform != 'win32'",
+  "ag2[gemini-realtime]==0.9.7;sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64'",
+  "ag2[gemini]==0.9.7;sys_platform != 'win32'",
+  "ag2[gemini]==0.9.7;sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64'",
+  "ag2[google-api]==0.9.7",
+  "ag2[google-client]==0.9.7",
+  "ag2[google-search]==0.9.7",
+  "ag2[groq]==0.9.7",
+  "ag2[interop-crewai]==0.9.7",
+  "ag2[interop-langchain]==0.9.7",
+  "ag2[lmm]==0.9.7",
+  # "ag2[mcp-proxy-gen]==0.9.7",
+  "ag2[mcp]==0.9.7",
+  "ag2[mistral]==0.9.7",
+  "ag2[neo4j]==0.9.7;sys_platform != 'win32'",
+  "ag2[neo4j]==0.9.7;sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64'",
+  "ag2[ollama]==0.9.7",
+  "ag2[openai-realtime]==0.9.7",
+  "ag2[rag]==0.9.7",
+  "ag2[redis]==0.9.7",
+  "ag2[tavily]==0.9.7",
+  # "ag2[retrievechat-couchbase]==0.9.7",
+  # "ag2[retrievechat-mongodb]==0.9.7",
+  # "ag2[retrievechat-pgvector]==0.9.7",
+  # "ag2[retrievechat-qdrant]==0.9.7",
+  # "ag2[retrievechat]==0.9.7",
+  "ag2[together]==0.9.7;sys_platform != 'win32'",
+  "ag2[together]==0.9.7;sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64'",
+  "ag2[twilio]==0.9.7",
+  "ag2[websockets]==0.9.7",
+  "ag2[websurfer]==0.9.7",
+  "ag2[wikipedia]==0.9.7",
   "chromadb>=0.5.10;sys_platform != 'win32'",
   "chromadb>=0.5.10;sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64'",
-  "couchbase>=4.3.0",
+  "couchbase>=4.4.0",
   "fastembed>=0.3.1",
   "pgvector>=0.4.0",
   "psycopg>=3.2.6;sys_platform == 'linux'",
@@ -152,16 +153,16 @@ ag2_extras = [
   "qdrant-client[fastembed];sys_platform == 'win32' and platform_machine != 'arm64' and platform_machine != 'aarch64' and platform_machine != 'ARM64' and platform_machine != 'AARCH64'",
 ]
 dev = [
-  "ag2[redis]==0.9.6",
-  "ag2[websockets]==0.9.6",
+  "ag2[redis]==0.9.7",
+  "ag2[websockets]==0.9.7",
   "autoflake==2.3.1",
   "bandit==1.8.6",
   "black[jupyter]==25.1.0",
-  "build==1.2.2.post1",
-  "fakeredis==2.30.1",
+  "build==1.3.0",
+  "fakeredis==2.30.3",
   "flake8==7.3.0",
   "jsonschema==4.25.0",
-  "jupyterlab>=4.4.0,<5.0",
+  "jupyterlab==4.4.5",
   "notebook-shim>=0.2.4",
   "fastjsonschema>=2.21.1",
   "jupyter_server==2.16.0",
@@ -169,7 +170,7 @@ dev = [
   "nbformat>=5.10.4",
   "nbconvert>=7.16.6",
   "hatchling==1.27.0",
-  "mypy==1.17.0",
+  "mypy==1.17.1",
   "mypy-extensions>=1.1.0",
   "paho-mqtt>=2.1.0,<3.0",
   "pandas-stubs==2.3.0.250703",
@@ -178,8 +179,8 @@ dev = [
   "pydocstyle==6.3.0",
   "pylint==3.3.7",
   "python-dotenv>=1.1.1",
-  "ruff==0.12.4",
-  "types-aiofiles==24.1.0.20250708",
+  "ruff==0.12.7",
+  "types-aiofiles==24.1.0.20250801",
   "types-pyyaml==6.0.12.20250516",
   "types-jsonschema==4.25.0.20250720",
   "types-redis==4.6.0.20241004",
@@ -197,8 +198,8 @@ docs = [
   "mkdocs-autorefs==1.4.2",
   "mkdocs-jupyter==0.25.1",
   "mkdocs-macros-plugin==1.3.7",
-  "mkdocs-material==9.6.15",
-  "mkdocs-minify-html-plugin==0.3.1",
+  "mkdocs-material==9.6.16",
+  "mkdocs-minify-html-plugin==0.3.4",
   "mkdocstrings[crystal,python]==0.30.0",
   "mkdocstrings-crystal==0.3.7",
   "mkdocstrings-python==1.16.12",
@@ -207,9 +208,9 @@ docs = [
   "natsort==8.4.0",
 ]
 test = [
-  "ag2[redis]==0.9.6",
-  "ag2[websockets]==0.9.6",
-  "fakeredis==2.30.1",
+  "ag2[redis]==0.9.7",
+  "ag2[websockets]==0.9.7",
+  "fakeredis==2.30.3",
   "paho-mqtt>=2.1.0,<3.0",
   "pytest==8.4.1",
   "pytest-asyncio==1.1.0",
@@ -499,7 +500,7 @@ exclude_dirs = [
 # B104: bind to all interfaces (0.0.0.0)
 # B110: allow pass on try/except
 # B404: allow import subprocess
-# B602, B603: allow shell=True (subprocess,popen)
+# B602, B603: allow shell=True (subprocess, popen)
 skips = ["B104", "B110", "B404", "B602", "B603"]
 [tool.bandit.assert_used]
 skips = ["*_test.py", "*/test_*.py"]

{waldiez-0.5.6 → waldiez-0.5.8}/waldiez/_version.py

@@ -5,4 +5,4 @@
 This file is automatically generated by Hatchling.
 Do not edit this file directly.
 """
-__version__ = VERSION = "0.5.6"
+__version__ = VERSION = "0.5.8"

{waldiez-0.5.6 → waldiez-0.5.8}/waldiez/cli.py

@@ -100,6 +100,19 @@ def run(
         False,
         help="Override the output file if it already exists.",
     ),
+    env_file: Optional[Path] = typer.Option(  # noqa: B008
+        None,
+        "--env-file",
+        "-e",
+        help=(
+            "Path to a .env file containing additional environment variables. "
+            "These variables will be set before running the flow."
+        ),
+        file_okay=True,
+        dir_okay=False,
+        readable=True,
+        resolve_path=True,
+    ),
 ) -> None:
     """Run a Waldiez flow."""
     os.environ["AUTOGEN_USE_DOCKER"] = "0"
@@ -126,6 +139,7 @@ def run(
             structured,  # structured_io
             False,  # skip_mmd
             False,  # skip_timeline
+            env_file,
         )
     else:
         runner.run(
@@ -134,6 +148,7 @@ def run(
             structured_io=structured,
             skip_mmd=False,
             skip_timeline=False,
+            dot_env=env_file,
         )
 
 
@@ -157,7 +172,7 @@ def convert(
             "Path to the output file. "
             "The file extension determines the output format: "
             "`.py` for Python script, `.ipynb` for Jupyter notebook."
-            " If not provided, the output will be saved in the same directory as the input file."
+            " If not provided, the output (.py) will be saved in the same directory as the input file."
             " If the file already exists, it will not be overwritten unless --force is used."
         ),
         file_okay=True,
@@ -230,7 +245,7 @@ def _get_output_path(output: Optional[Path], force: bool) -> Optional[Path]:
     if output is not None and not output.parent.exists():
         output.parent.mkdir(parents=True)
     if output is not None and output.exists():
-        if force is False:
+        if not force:
             LOG.error("Output file already exists.")
             raise typer.Exit(code=1)
         output.unlink()

{waldiez-0.5.6 → waldiez-0.5.8}/waldiez/exporter.py

@@ -97,7 +97,7 @@ class WaldiezExporter:
         if path.is_dir():
             raise IsADirectoryError(f"Output is a directory: {path}")
         if path.exists():
-            if force is False:
+            if not force:
                 raise FileExistsError(f"File already exists: {path}")
             path.unlink(missing_ok=True)
         path.parent.mkdir(parents=True, exist_ok=True)