agentbyte 0.32.1__tar.gz → 0.32.2__tar.gz

{agentbyte-0.32.1 → agentbyte-0.32.2}/CHANGELOG.md

@@ -6,6 +6,12 @@ The format follows Keep a Changelog principles and semantic versioning.
 
 ## [Unreleased]
 
+## [0.32.2] - 2026-10-01
+
+### Fixed
+
+- `import agentbyte` no longer requires the `openai` package. OpenAI and Azure OpenAI clients in `agentbyte.llm` are imported on first use; without the extra, using them raises `ModuleNotFoundError` naming the extra to install (`pip install 'agentbyte[openai]'` or `'agentbyte[azureopenai]'`). `agentbyte.presets.build_chat_client` imports the provider client it needs at call time.
+
 ## [0.32.1] - 2026-09-30
 
 ### Fixed

{agentbyte-0.32.1 → agentbyte-0.32.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentbyte
-Version: 0.32.1
+Version: 0.32.2
 Summary: A toolkit for designing multiagent systems
 Author-email: MrDataPsycho <mr.data.psycho@gmail.com>
 License-Expression: LicenseRef-Proprietary
@@ -90,7 +90,7 @@ Description-Content-Type: text/markdown
 
 Agentbyte is an observability-first agentic AI framework for building and studying multiagent systems with a learning-first, implementation-oriented workflow.
 
-Current release: **0.32.1**
+Current release: **0.32.2**
 
 ## Building an Agent
 

{agentbyte-0.32.1 → agentbyte-0.32.2}/README.md

@@ -2,7 +2,7 @@
 
 Agentbyte is an observability-first agentic AI framework for building and studying multiagent systems with a learning-first, implementation-oriented workflow.
 
-Current release: **0.32.1**
+Current release: **0.32.2**
 
 ## Building an Agent
 

agentbyte-0.32.2/src/agentbyte/__about__.py

@@ -0,0 +1,2 @@
+__version__ = "0.32.2"
+VERSION = __version__

{agentbyte-0.32.1 → agentbyte-0.32.2}/src/agentbyte/llm/__init__.py

@@ -33,23 +33,6 @@ from .base import (
 )
 from .retry_policy import RetryPolicy
 from .embeddings_base import BaseEmbeddingClient, BaseEmbeddingClientConfig
-from .openai import OpenAIChatCompletionClient, OpenAIChatCompletionClientConfig
-from .openai import OpenAIEmbeddingClient, OpenAIEmbeddingClientConfig
-from .openai import OpenAISettings
-from .azure import (
-    AzureOpenAIChatCompletionClient,
-    AzureOpenAIChatCompletionClientConfig,
-)
-from .azure import (
-    AzureOpenAIEmbeddingClient,
-    AzureOpenAIEmbeddingClientConfig,
-)
-from .azure import (
-    get_default_token_provider,
-    get_certificate_token_provider,
-    create_token_provider_from_string,
-)
-from .azure import AzureOpenAISettings, AzureServicePrincipalSettings
 # Import message types and usage from root module (picoagents-aligned)
 from agentbyte.messages import (
     BaseMessage,
@@ -117,3 +100,63 @@ __all__ = [
     "EmbeddingResult",
     "ModelPricing",
 ]
+
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:  # editors and type checkers see the provider classes eagerly
+    from .azure import (
+        AzureOpenAIChatCompletionClient,
+        AzureOpenAIChatCompletionClientConfig,
+        AzureOpenAIEmbeddingClient,
+        AzureOpenAIEmbeddingClientConfig,
+        AzureOpenAISettings,
+        AzureServicePrincipalSettings,
+        create_token_provider_from_string,
+        get_certificate_token_provider,
+        get_default_token_provider,
+    )
+    from .openai import (
+        OpenAIChatCompletionClient,
+        OpenAIChatCompletionClientConfig,
+        OpenAIEmbeddingClient,
+        OpenAIEmbeddingClientConfig,
+        OpenAISettings,
+    )
+
+# Provider clients need optional extras (``openai``, ``azureopenai``); they are
+# imported on first access so ``import agentbyte`` works with core dependencies only.
+_PROVIDER_EXPORTS = {
+    "OpenAIChatCompletionClient": ".openai",
+    "OpenAIChatCompletionClientConfig": ".openai",
+    "OpenAIEmbeddingClient": ".openai",
+    "OpenAIEmbeddingClientConfig": ".openai",
+    "OpenAISettings": ".openai",
+    "AzureOpenAIChatCompletionClient": ".azure",
+    "AzureOpenAIChatCompletionClientConfig": ".azure",
+    "AzureOpenAIEmbeddingClient": ".azure",
+    "AzureOpenAIEmbeddingClientConfig": ".azure",
+    "get_default_token_provider": ".azure",
+    "get_certificate_token_provider": ".azure",
+    "create_token_provider_from_string": ".azure",
+    "AzureOpenAISettings": ".azure",
+    "AzureServicePrincipalSettings": ".azure",
+}
+
+
+def __getattr__(name: str):
+    module_name = _PROVIDER_EXPORTS.get(name)
+    if module_name is None:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    from importlib import import_module
+
+    try:
+        module = import_module(module_name, __name__)
+    except ModuleNotFoundError as exc:
+        extra = "openai" if module_name == ".openai" else "azureopenai"
+        raise ModuleNotFoundError(
+            f"{name} needs the '{extra}' extra: pip install 'agentbyte[{extra}]'", name=exc.name
+        ) from exc
+    value = getattr(module, name)
+    globals()[name] = value
+    return value

{agentbyte-0.32.1 → agentbyte-0.32.2}/src/agentbyte/presets/clients.py

@@ -5,11 +5,7 @@ from __future__ import annotations
 import os
 from typing import Any
 
-from agentbyte.llm import (
-    AzureOpenAIChatCompletionClient,
-    BaseChatCompletionClient,
-    OpenAIChatCompletionClient,
-)
+from agentbyte.llm import BaseChatCompletionClient
 
 DEFAULT_OPENAI_MODEL = "gpt-4.1-mini"
 DEFAULT_CLIENT_CONFIG = {"temperature": 0.2}
@@ -53,11 +49,15 @@ def build_chat_client(
     )
 
     if resolved_provider == "openai":
+        from agentbyte.llm import OpenAIChatCompletionClient
+
         return OpenAIChatCompletionClient.from_api_key(
             model=model or DEFAULT_OPENAI_MODEL,
             config=resolved_config,
         )
 
+    from agentbyte.llm import AzureOpenAIChatCompletionClient
+
     if os.getenv("AZURE_TENANT_ID"):
         return AzureOpenAIChatCompletionClient.from_certificate(
             model=resolved_model,

{agentbyte-0.32.1 → agentbyte-0.32.2}/tests/presets/test_clients.py

@@ -4,6 +4,7 @@ from types import SimpleNamespace
 
 import pytest
 
+import agentbyte.llm as llm
 from agentbyte.presets import clients as preset_clients
 
 
@@ -43,7 +44,7 @@ class DummyAzureClient:
 
 
 def test_build_chat_client_explicit_openai(monkeypatch):
-    monkeypatch.setattr(preset_clients, "OpenAIChatCompletionClient", DummyOpenAIClient)
+    monkeypatch.setattr(llm, "OpenAIChatCompletionClient", DummyOpenAIClient)
 
     client = preset_clients.build_chat_client(provider="openai", model="gpt-test")
 
@@ -53,8 +54,7 @@ def test_build_chat_client_explicit_openai(monkeypatch):
 
 
 def test_build_chat_client_explicit_azure_with_api_key(monkeypatch):
-    monkeypatch.setattr(
-        preset_clients, "AzureOpenAIChatCompletionClient", DummyAzureClient
+    monkeypatch.setattr(llm, "AzureOpenAIChatCompletionClient", DummyAzureClient
     )
     monkeypatch.setenv("AZURE_OPENAI_API_KEY", "secret")
 
@@ -69,8 +69,7 @@ def test_build_chat_client_explicit_azure_with_api_key(monkeypatch):
 
 
 def test_build_chat_client_prefers_azure_certificate_over_api_key(monkeypatch):
-    monkeypatch.setattr(
-        preset_clients, "AzureOpenAIChatCompletionClient", DummyAzureClient
+    monkeypatch.setattr(llm, "AzureOpenAIChatCompletionClient", DummyAzureClient
     )
     monkeypatch.setenv("AZURE_OPENAI_ENDPOINT", "https://example.openai.azure.com/")
     monkeypatch.setenv("AZURE_OPENAI_API_KEY", "secret")
@@ -83,8 +82,7 @@ def test_build_chat_client_prefers_azure_certificate_over_api_key(monkeypatch):
 
 
 def test_build_chat_client_uses_azure_env_model_name_when_present(monkeypatch):
-    monkeypatch.setattr(
-        preset_clients, "AzureOpenAIChatCompletionClient", DummyAzureClient
+    monkeypatch.setattr(llm, "AzureOpenAIChatCompletionClient", DummyAzureClient
     )
     monkeypatch.delenv("OPENAI_API_KEY", raising=False)
     monkeypatch.delenv("AZURE_OPENAI_API_KEY", raising=False)
@@ -98,7 +96,7 @@ def test_build_chat_client_uses_azure_env_model_name_when_present(monkeypatch):
 
 
 def test_build_chat_client_infers_openai_from_env(monkeypatch):
-    monkeypatch.setattr(preset_clients, "OpenAIChatCompletionClient", DummyOpenAIClient)
+    monkeypatch.setattr(llm, "OpenAIChatCompletionClient", DummyOpenAIClient)
     monkeypatch.setenv("OPENAI_API_KEY", "secret")
 
     client = preset_clients.build_chat_client()
@@ -108,8 +106,7 @@ def test_build_chat_client_infers_openai_from_env(monkeypatch):
 
 
 def test_build_chat_client_uses_azure_default_credential_when_no_key(monkeypatch):
-    monkeypatch.setattr(
-        preset_clients, "AzureOpenAIChatCompletionClient", DummyAzureClient
+    monkeypatch.setattr(llm, "AzureOpenAIChatCompletionClient", DummyAzureClient
     )
     monkeypatch.delenv("OPENAI_API_KEY", raising=False)
     monkeypatch.delenv("AZURE_OPENAI_API_KEY", raising=False)

{agentbyte-0.32.1 → agentbyte-0.32.2}/tests/test_package_api.py

@@ -512,3 +512,26 @@ def test_package_root_otel_bootstrap_instruments_agent_init(
         assert getattr(AgentClass.__init__, "__agentbyte_otel_instrumented__", False) is True
     finally:
         AgentClass.__init__ = original_init
+
+
+OPTIONAL_MODULES = [
+    "openai", "azure", "azure.identity", "aiosqlite", "sqlalchemy", "sqlmodel", "asyncpg",
+    "aioboto3", "fastapi", "uvicorn", "opentelemetry", "graphviz", "gepa",
+]
+
+
+def test_core_import_works_without_optional_extras() -> None:
+    """`import agentbyte` and the CLI must not need any optional extra (regression for 0.32.1)."""
+    import subprocess
+
+    blocked = "\n".join(f"sys.modules[{name!r}] = None" for name in OPTIONAL_MODULES)
+    script = (
+        f"import sys\n{blocked}\n"
+        "import agentbyte, agentbyte.llm, agentbyte.presets, agentbyte.cli.main\n"
+        "from agentbyte.llm import BaseChatCompletionClient\n"
+        "try:\n    agentbyte.llm.OpenAIChatCompletionClient\n"
+        "except ModuleNotFoundError as exc:\n    print(exc)\n"
+    )
+    result = subprocess.run([sys.executable, "-c", script], capture_output=True, text=True, timeout=120)
+    assert result.returncode == 0, result.stderr
+    assert "pip install 'agentbyte[openai]'" in result.stdout

agentbyte-0.32.1/src/agentbyte/__about__.py

@@ -1,2 +0,0 @@
-__version__ = "0.32.1"
-VERSION = __version__