sofias-sdk-lite 0.1.5__tar.gz → 0.2.1__tar.gz

sofias_sdk_lite-0.2.1/LICENSE

@@ -0,0 +1,69 @@
+Sofias SDK Lite License
+
+Copyright (c) 2026 Sofias Tech, S.L. All rights reserved.
+
+This licence applies to the software distributed as "sofias-sdk-lite" (the
+"SDK"), including its source code, documentation and examples. By installing
+or using the SDK you accept it. If you do not accept it, do not use the SDK.
+
+1. Permitted use
+
+   Sofias Tech, S.L. ("Sofias") grants you a free, non-exclusive,
+   non-transferable and revocable licence to download, install and use the SDK
+   solely to develop, test and run agents intended to run on the Sofias
+   platform, including its developer portal and marketplace.
+
+2. Source availability
+
+   The source code is made available so that you can read it and understand
+   how the SDK works. Access to the source code does not grant any right
+   beyond those set out in section 1.
+
+3. Restrictions
+
+   Except as expressly permitted in section 1, you may not:
+
+   a) use the SDK, or any part or derivative of it, to build, run or offer
+      agents, applications or services for any platform other than Sofias;
+   b) copy, modify, adapt, translate or create derivative works of the SDK,
+      other than the local copies needed for the permitted use;
+   c) distribute, publish, sublicense, sell, rent or otherwise make the SDK or
+      any derivative of it available to third parties;
+   d) remove or alter this notice or any other notice of ownership.
+
+4. Your agents
+
+   The agents you build with the SDK are yours. This licence does not give
+   Sofias any right over them. Any right Sofias needs to host, run or offer
+   your agents is governed by the terms you accept when you publish on the
+   Sofias platform.
+
+5. Termination
+
+   This licence ends automatically if you breach any of its terms. Sofias may
+   also revoke it by written notice. On termination you must stop using the SDK
+   and delete every copy in your possession.
+
+6. No warranty
+
+   THE SDK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING WITHOUT LIMITATION THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
+
+7. Limitation of liability
+
+   TO THE MAXIMUM EXTENT PERMITTED BY LAW, SOFIAS SHALL NOT BE LIABLE FOR ANY
+   DAMAGE ARISING FROM THE USE OF, OR THE INABILITY TO USE, THE SDK.
+
+8. Changes
+
+   Sofias may publish new versions of this licence. Each release of the SDK is
+   governed by the licence included with it.
+
+9. Governing law and jurisdiction
+
+   This licence is governed by Spanish law. Any dispute shall be submitted to
+   the courts of Donostia - San Sebastian (Gipuzkoa), Spain, unless mandatory
+   law provides otherwise.
+
+Contact: support@sofias.ai

sofias_sdk_lite-0.1.5/README.md → sofias_sdk_lite-0.2.1/PKG-INFO

@@ -1,7 +1,45 @@
+Metadata-Version: 2.4
+Name: sofias-sdk-lite
+Version: 0.2.1
+Summary: Build agents on the Sofias agent graph and run them over RabbitMQ.
+Keywords: agents,ai,llm,rabbitmq,sofias
+Author: Sofias Tech, S.L.
+Author-email: Sofias Tech, S.L. <support@sofias.ai>
+License-Expression: LicenseRef-Sofias-SDK-Lite
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Dist: pydantic>=2.0
+Requires-Dist: aio-pika>=9.0.0
+Requires-Dist: rstream>=1.0.0
+Requires-Dist: nh3>=0.3.6
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mkdocs>=1.6,<2 ; extra == 'docs'
+Requires-Dist: mkdocs-material>=9.5 ; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.25 ; extra == 'docs'
+Requires-Dist: opentelemetry-api>=1.20.0 ; extra == 'otel'
+Requires-Python: >=3.11
+Project-URL: Homepage, https://sofias.ai/
+Project-URL: Documentation, https://docs.sofias.ai/
+Project-URL: Repository, https://github.com/Sofias-ai/sofias-sdk-lite
+Project-URL: Changelog, https://github.com/Sofias-ai/sofias-sdk-lite/blob/main/CHANGELOG.md
+Provides-Extra: docs
+Provides-Extra: otel
+Description-Content-Type: text/markdown
+
 # sofias-sdk-lite
 
 Build multi-node agents on a declarative graph and run them against RabbitMQ.
 
+**Documentation:** [docs.sofias.ai](https://docs.sofias.ai/) · **Developer portal:** [developers.sofias.ai](https://developers.sofias.ai/) · **Source:** [github.com/Sofias-ai/sofias-sdk-lite](https://github.com/Sofias-ai/sofias-sdk-lite)
+
 `sofias-sdk-lite` gives you:
 
 - **An agent graph** — LLM nodes, function nodes, delegation nodes (agent-to-agent),
@@ -13,8 +51,8 @@ Build multi-node agents on a declarative graph and run them against RabbitMQ.
 - **A runner** — `AgentRunner` consumes tasks from a queue, resolves per-request
   settings, executes your agent, and streams the response back — with graceful
   shutdown, retries, and circuit breakers built in.
-- **An LLM that is already wired** — LLM nodes talk to the Sofias Bifrost
-  gateway (or any OpenAI-compatible endpoint) using the model, URL and key
+- **An LLM that is already wired** — LLM nodes talk to the Sofias gateway
+  (or any OpenAI-compatible endpoint) using the model, URL and key
   from the agent's settings or the `SOFIAS_LLM_*` environment. `create_llm()`
   builds the client when you need it explicitly; `LLMCallable` stays a protocol
   for anything the bundled clients do not cover.
@@ -97,12 +135,11 @@ resolved at `build()`:
 
 1. Under `AgentRunner`, from the per-task settings the platform sends
    (`model_name`, `router_url`, `router_api_key` on `BaseAgentSettings`).
-2. Otherwise from the environment: `SOFIAS_LLM_MODEL`, `SOFIAS_LLM_BASE_URL`
-   (default `http://bifrost:8080/v1`), `SOFIAS_LLM_API_KEY`,
-   `SOFIAS_LLM_PROVIDER` (default `bifrost`). The `BIFROST_MODEL` /
-   `BIFROST_BASE_URL` / `BIFROST_API_KEY` variables the Sofias Developer
-   Portal injects into agent containers are accepted as fallbacks, so a
-   portal-deployed agent needs no LLM configuration at all.
+2. Otherwise from the environment: `SOFIAS_LLM_MODEL`, `SOFIAS_LLM_BASE_URL`,
+   `SOFIAS_LLM_API_KEY` and `SOFIAS_LLM_PROVIDER` (default `sofias`). The
+   Sofias platform injects them into every agent it runs, so an agent
+   deployed through the developer portal needs no LLM configuration at all.
+   There is no default URL: to run locally against a real gateway, set it.
 3. Or explicitly: `.with_llm(create_llm(model="default", api_key=...))`.
 
 ```python
@@ -173,11 +210,21 @@ if __name__ == "__main__":
 ## Scope (v1)
 
 Core agent graph, RabbitMQ messaging, the runner, and LLM clients for the
-Bifrost gateway / any OpenAI-compatible endpoint ship today. Memory and MCP
+Sofias gateway / any OpenAI-compatible endpoint ship today. Memory and MCP
 tool discovery are intentionally out of scope for v1 — the SDK ships the
 relevant protocols (`MemoryProvider`, `ToolProvider`) so you can plug in
 your own, and these become optional extras in a later release.
 
+## Source and contributions
+
+The public repository holds read-only release snapshots: each release of
+`sofias-sdk-lite` appears there as a single commit. Development happens
+elsewhere, so pull requests cannot be merged and we do not accept
+contributions at the moment. For questions or to report a problem, write to
+support@sofias.ai.
+
 ## License
 
-Apache-2.0. See [LICENSE](LICENSE).
+Source-available under the [Sofias SDK Lite License](https://github.com/Sofias-ai/sofias-sdk-lite/blob/main/LICENSE):
+you may use `sofias-sdk-lite` to develop, test and run agents for the Sofias
+platform. The agents you build with it are yours.

sofias_sdk_lite-0.1.5/PKG-INFO → sofias_sdk_lite-0.2.1/README.md

@@ -1,25 +1,9 @@
-Metadata-Version: 2.4
-Name: sofias-sdk-lite
-Version: 0.1.5
-Summary: Build agents on the Sofias agent graph and run them over RabbitMQ.
-License-Expression: Apache-2.0
-Requires-Dist: pydantic>=2.0
-Requires-Dist: aio-pika>=9.0.0
-Requires-Dist: rstream>=1.0.0
-Requires-Dist: nh3>=0.3.6
-Requires-Dist: httpx>=0.27.0
-Requires-Dist: mkdocs-material>=9.5 ; extra == 'docs'
-Requires-Dist: mkdocstrings[python]>=0.25 ; extra == 'docs'
-Requires-Dist: opentelemetry-api>=1.20.0 ; extra == 'otel'
-Requires-Python: >=3.11
-Provides-Extra: docs
-Provides-Extra: otel
-Description-Content-Type: text/markdown
-
 # sofias-sdk-lite
 
 Build multi-node agents on a declarative graph and run them against RabbitMQ.
 
+**Documentation:** [docs.sofias.ai](https://docs.sofias.ai/) · **Developer portal:** [developers.sofias.ai](https://developers.sofias.ai/) · **Source:** [github.com/Sofias-ai/sofias-sdk-lite](https://github.com/Sofias-ai/sofias-sdk-lite)
+
 `sofias-sdk-lite` gives you:
 
 - **An agent graph** — LLM nodes, function nodes, delegation nodes (agent-to-agent),
@@ -31,8 +15,8 @@ Build multi-node agents on a declarative graph and run them against RabbitMQ.
 - **A runner** — `AgentRunner` consumes tasks from a queue, resolves per-request
   settings, executes your agent, and streams the response back — with graceful
   shutdown, retries, and circuit breakers built in.
-- **An LLM that is already wired** — LLM nodes talk to the Sofias Bifrost
-  gateway (or any OpenAI-compatible endpoint) using the model, URL and key
+- **An LLM that is already wired** — LLM nodes talk to the Sofias gateway
+  (or any OpenAI-compatible endpoint) using the model, URL and key
   from the agent's settings or the `SOFIAS_LLM_*` environment. `create_llm()`
   builds the client when you need it explicitly; `LLMCallable` stays a protocol
   for anything the bundled clients do not cover.
@@ -115,12 +99,11 @@ resolved at `build()`:
 
 1. Under `AgentRunner`, from the per-task settings the platform sends
    (`model_name`, `router_url`, `router_api_key` on `BaseAgentSettings`).
-2. Otherwise from the environment: `SOFIAS_LLM_MODEL`, `SOFIAS_LLM_BASE_URL`
-   (default `http://bifrost:8080/v1`), `SOFIAS_LLM_API_KEY`,
-   `SOFIAS_LLM_PROVIDER` (default `bifrost`). The `BIFROST_MODEL` /
-   `BIFROST_BASE_URL` / `BIFROST_API_KEY` variables the Sofias Developer
-   Portal injects into agent containers are accepted as fallbacks, so a
-   portal-deployed agent needs no LLM configuration at all.
+2. Otherwise from the environment: `SOFIAS_LLM_MODEL`, `SOFIAS_LLM_BASE_URL`,
+   `SOFIAS_LLM_API_KEY` and `SOFIAS_LLM_PROVIDER` (default `sofias`). The
+   Sofias platform injects them into every agent it runs, so an agent
+   deployed through the developer portal needs no LLM configuration at all.
+   There is no default URL: to run locally against a real gateway, set it.
 3. Or explicitly: `.with_llm(create_llm(model="default", api_key=...))`.
 
 ```python
@@ -191,11 +174,21 @@ if __name__ == "__main__":
 ## Scope (v1)
 
 Core agent graph, RabbitMQ messaging, the runner, and LLM clients for the
-Bifrost gateway / any OpenAI-compatible endpoint ship today. Memory and MCP
+Sofias gateway / any OpenAI-compatible endpoint ship today. Memory and MCP
 tool discovery are intentionally out of scope for v1 — the SDK ships the
 relevant protocols (`MemoryProvider`, `ToolProvider`) so you can plug in
 your own, and these become optional extras in a later release.
 
+## Source and contributions
+
+The public repository holds read-only release snapshots: each release of
+`sofias-sdk-lite` appears there as a single commit. Development happens
+elsewhere, so pull requests cannot be merged and we do not accept
+contributions at the moment. For questions or to report a problem, write to
+support@sofias.ai.
+
 ## License
 
-Apache-2.0. See [LICENSE](LICENSE).
+Source-available under the [Sofias SDK Lite License](https://github.com/Sofias-ai/sofias-sdk-lite/blob/main/LICENSE):
+you may use `sofias-sdk-lite` to develop, test and run agents for the Sofias
+platform. The agents you build with it are yours.

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/pyproject.toml

@@ -1,10 +1,29 @@
 [project]
 name = "sofias-sdk-lite"
-version = "0.1.5"
+version = "0.2.1"
 description = "Build agents on the Sofias agent graph and run them over RabbitMQ."
 readme = "README.md"
 requires-python = ">=3.11"
-license = "Apache-2.0"
+license = "LicenseRef-Sofias-SDK-Lite"
+license-files = ["LICENSE"]
+keywords = [
+    "agents",
+    "ai",
+    "llm",
+    "rabbitmq",
+    "sofias",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Typing :: Typed",
+]
 dependencies = [
     "pydantic>=2.0",
     "aio-pika>=9.0.0",
@@ -13,9 +32,20 @@ dependencies = [
     "httpx>=0.27.0",
 ]
 
+[[project.authors]]
+name = "Sofias Tech, S.L."
+email = "support@sofias.ai"
+
+[project.urls]
+Homepage = "https://sofias.ai/"
+Documentation = "https://docs.sofias.ai/"
+Repository = "https://github.com/Sofias-ai/sofias-sdk-lite"
+Changelog = "https://github.com/Sofias-ai/sofias-sdk-lite/blob/main/CHANGELOG.md"
+
 [project.optional-dependencies]
 otel = ["opentelemetry-api>=1.20.0"]
 docs = [
+    "mkdocs>=1.6,<2",
     "mkdocs-material>=9.5",
     "mkdocstrings[python]>=0.25",
 ]

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/pyproject.toml.orig

@@ -1,10 +1,24 @@
 [project]
 name = "sofias-sdk-lite"
-version = "0.1.5"
+version = "0.2.1"
 description = "Build agents on the Sofias agent graph and run them over RabbitMQ."
 readme = "README.md"
 requires-python = ">=3.11"
-license = "Apache-2.0"
+license = "LicenseRef-Sofias-SDK-Lite"
+license-files = ["LICENSE"]
+authors = [{ name = "Sofias Tech, S.L.", email = "support@sofias.ai" }]
+keywords = ["agents", "ai", "llm", "rabbitmq", "sofias"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Typing :: Typed",
+]
 dependencies = [
     "pydantic>=2.0",
     "aio-pika>=9.0.0",
@@ -13,11 +27,19 @@ dependencies = [
     "httpx>=0.27.0",
 ]
 
+[project.urls]
+Homepage = "https://sofias.ai/"
+Documentation = "https://docs.sofias.ai/"
+Repository = "https://github.com/Sofias-ai/sofias-sdk-lite"
+Changelog = "https://github.com/Sofias-ai/sofias-sdk-lite/blob/main/CHANGELOG.md"
+
 [project.optional-dependencies]
 otel = [
     "opentelemetry-api>=1.20.0",
 ]
 docs = [
+    # MkDocs 2.0 drops the plugin system this site relies on.
+    "mkdocs>=1.6,<2",
     "mkdocs-material>=9.5",
     "mkdocstrings[python]>=0.25",
 ]

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/__init__.py

@@ -91,7 +91,7 @@ from sofias_sdk_lite.errors import (
     ToolExecutionError,
 )
 from sofias_sdk_lite.llm import (
-    BifrostLLM,
+    GatewayLLM,
     LLMCallable,
     LLMGatewayConfig,
     LLMResponse,
@@ -230,7 +230,7 @@ __all__ = [
     "StreamableLLMCallable",
     "LLMResponse",
     # LLM clients + factory
-    "BifrostLLM",
+    "GatewayLLM",
     "OpenAICompatibleLLM",
     "LLMGatewayConfig",
     "create_llm",

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/agent/agent.py

@@ -67,12 +67,13 @@ class Agent:
     to Node instances which handle their own execution.
 
     Example:
+        ```python
         # Agent is typically built via AgentBuilder
         agent = (
             AgentBuilder("my_agent", version="1.0.0")
             .with_settings_class(MySettings)
             .with_contract(input_schema=MyInput, output_schema=MyOutput)
-            .add_node("start", node_config, contract)
+            .add_llm_node("start", node_config, contract)
             .set_entry_node("start")
             .set_terminal("start")
             .build()
@@ -86,6 +87,7 @@ class Agent:
             )
         )
         assert response.status == ResponseStatus.SUCCESS
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/agent/agent_builder.py

@@ -64,6 +64,7 @@ class AgentBuilder:
     time, catching configuration errors before runtime.
 
     Example:
+        ```python
         agent = (
             AgentBuilder("inbox_assist", version="1.0.0")
             .with_description("Agent that processes incoming emails")
@@ -84,6 +85,7 @@ class AgentBuilder:
             .with_circuit_breaker(CircuitBreakerConfig(failure_threshold=5))
             .build()
         )
+        ```
     """
 
     def __init__(self, name: str, *, version: str = "1.0.0") -> None:
@@ -408,6 +410,7 @@ class AgentBuilder:
             Self for method chaining.
 
         Example:
+            ```python
             builder.with_delegation_transport(my_transport).add_delegation_node(
                 name="delegate_analysis",
                 config=DelegationNodeConfig(
@@ -424,6 +427,7 @@ class AgentBuilder:
                     "transform_for_analyzer": lambda d: {"text": d["content"]},
                 },
             )
+            ```
         """
         self._delegation_node_configs[name] = config
         self._delegation_node_contracts[name] = contract
@@ -709,6 +713,7 @@ class AgentBuilder:
             Self for method chaining.
 
         Example:
+            ```python
             from sofias_sdk_lite.state import (
                 ConversationState,
                 InMemoryStateProvider,
@@ -717,6 +722,7 @@ class AgentBuilder:
             builder.with_conversation_state(
                 ConversationState(InMemoryStateProvider())
             )
+            ```
         """
         self._conversation_state = state
         return self

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/agent/agent_config.py

@@ -47,6 +47,7 @@ class AgentConfig(BaseModel):
     three-level configuration resolution: SDK > Agent > Node.
 
     Example:
+        ```python
         config = AgentConfig(
             name="inbox-assistant",
             version="1.0.0",
@@ -56,6 +57,7 @@ class AgentConfig(BaseModel):
             settings_class=InboxAssistantSettings,
             llm=AgentLLMConfig(model="gpt-4o"),
         )
+        ```
     """
 
     model_config = ConfigDict(frozen=True, arbitrary_types_allowed=True)

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/agent/middleware.py

@@ -4,7 +4,8 @@ Middleware hooks are called before and after each node execution,
 allowing logging, metrics, tracing, and input/output transformation
 without modifying node code.
 
-Example::
+Example:
+    ```python
 
     class MetricsMiddleware:
         async def before_node(self, node_name, input_data):
@@ -24,6 +25,7 @@ Example::
         .with_middleware(MetricsMiddleware())
         .build()
     )
+    ```
 """
 
 from __future__ import annotations

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/agent/response_workflow.py

@@ -21,6 +21,7 @@ This module is transport-agnostic: it has no dependency on any specific
 message broker. Wire it to whatever transport your application uses.
 
 Example:
+    ```python
     class MyRabbitMQWorkflow:
         async def send_response(
             self,
@@ -38,6 +39,7 @@ Example:
         .with_response_workflow(MyRabbitMQWorkflow())
         .build()
     )
+    ```
 """
 
 from __future__ import annotations
@@ -99,6 +101,7 @@ class StreamingResponseWorkflow(Protocol):
     send_response() is still called at the end with the complete response.
 
     Example:
+        ```python
         class MySSEWorkflow:
             async def on_stream_event(
                 self,
@@ -113,6 +116,7 @@ class StreamingResponseWorkflow(Protocol):
                 context: ExecutionContext,
             ) -> None:
                 await self._sse_channel.send_final(response.model_dump_json())
+        ```
     """
 
     async def on_stream_event(
@@ -162,7 +166,8 @@ class BaseDelegationResponseWorkflow:
             the ``result`` string. If *None*, the entire content dict is
             serialized as JSON. Defaults to *None*.
 
-    Example::
+    Example:
+        ```python
 
         async def publish(payload: dict) -> None:
             await my_transport.publish_reply(reply_to, correlation_id, payload)
@@ -171,6 +176,7 @@ class BaseDelegationResponseWorkflow:
             publish_fn=publish,
             output_field="report",
         )
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/config/agent_settings.py

@@ -55,12 +55,13 @@ class BaseAgentSettings(AgentSettings):
     variables), so a ``{api_key}`` placeholder can never inline a secret. Read
     them at the point of use with ``.get_secret_value()``.
 
-    Example::
-
+    Example:
+        ```python
         class MySettings(BaseAgentSettings):
             CREDENTIAL_FIELDS = BaseAgentSettings.CREDENTIAL_FIELDS | {"search_api_key"}
 
             search_api_key: SecretStr = SecretStr("")
+        ```
     """
 
     # --- LLM gateway (canonical platform keys) ---
@@ -68,13 +69,13 @@ class BaseAgentSettings(AgentSettings):
     """Model identifier or gateway alias. Empty means "no LLM configured here"."""
 
     router_url: str = ""
-    """OpenAI-compatible gateway root. Empty falls back to the in-cluster Bifrost URL."""
+    """OpenAI-compatible gateway root, injected by the platform. Required to build an LLM."""
 
     router_api_key: SecretStr = SecretStr("")
     """Gateway bearer token. Empty sends unauthenticated requests."""
 
     router_provider: str = ""
-    """Adapter flavour: ``"bifrost"`` (default when empty) or an OpenAI-compatible label."""
+    """Adapter flavour: ``"sofias"`` (default when empty) or an OpenAI-compatible label."""
 
     @property
     def has_llm_gateway(self) -> bool:

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/config/runtime_config.py

@@ -38,11 +38,13 @@ class AgentSettings(BaseModel):
     required and optional runtime configuration variables.
 
     Example:
+        ```python
         class MyAgentSettings(AgentSettings):
             reasoning_model: str              # required
             fast_model: str                   # required
             max_retries: int = 3              # optional with default
             temperature: float = 0.7          # optional with default
+        ```
     """
 
     model_config = ConfigDict(
@@ -85,6 +87,7 @@ class SettingsResolver(Generic[SettingsT]):
     graph execution without explicit parameter passing.
 
     Example:
+        ```python
         resolver = SettingsResolver(MyAgentSettings)
 
         # Resolve from incoming message
@@ -98,6 +101,7 @@ class SettingsResolver(Generic[SettingsT]):
 
         # Clear after execution
         resolver.clear()
+        ```
     """
 
     def __init__(self, settings_class: type[SettingsT]) -> None:

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/config/sdk_config.py

@@ -73,10 +73,12 @@ class SDKConfig(BaseModel):
     when setting up their agent. All values have sensible defaults.
 
     Example:
+        ```python
         config = SDKConfig(
             llm=LLMConfig(model="gpt-4o-mini"),
             strict_validation=True,
         )
+        ```
     """
 
     model_config = ConfigDict(frozen=True)

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/config/source.py

@@ -35,11 +35,13 @@ class ConfigSource(Protocol):
     return type.
 
     Example:
+        ```python
         class DatabaseConfigSource:
             async def fetch(
                 self, agent_name: str, conversation_id: str | None = None
             ) -> dict[str, Any]:
                 return await my_db.get_agent_config(agent_name)
+        ```
     """
 
     async def fetch(self, agent_name: str, conversation_id: str | None = None) -> dict[str, Any]:
@@ -66,8 +68,10 @@ class StaticConfigSource:
     fixed configuration applies to every agent and conversation.
 
     Example:
+        ```python
         source = StaticConfigSource({"model_name": "gpt-4o-mini", "api_key": "..."})
         config = await source.fetch("my_agent")
+        ```
     """
 
     def __init__(self, config: dict[str, Any]) -> None:
@@ -104,8 +108,10 @@ class EnvConfigSource:
         export SOFIAS_AGENT_CONFIG='{"model_name": "gpt-4o-mini", "api_key": "sk-..."}'
 
     Example:
+        ```python
         source = EnvConfigSource()  # reads SOFIAS_AGENT_CONFIG
         config = await source.fetch("my_agent")
+        ```
     """
 
     def __init__(self, env_var: str = "SOFIAS_AGENT_CONFIG") -> None:

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/contracts/agent_contracts.py

@@ -8,6 +8,7 @@ strongly-typed envelopes that carry domain data plus transport metadata.
 - AgentResponse wraps the validated output with execution metadata.
 
 Example:
+    ```python
     class MyInput(InputContract):
         query: str
 
@@ -22,6 +23,7 @@ Example:
     print(response.content)           # validated output dict
     print(response.execution_path)    # ["classifier", "responder"]
     print(response.execution_time_ms) # 1234.5
+    ```
 """
 
 from __future__ import annotations

{sofias_sdk_lite-0.1.5 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/contracts/base_contracts.py

@@ -6,6 +6,7 @@ a common protocol so that any delegating node knows exactly what to send and
 what to expect back, without needing to know the internals of the target agent.
 
 Example:
+    ```python
     # Agent A delegates to Agent B
     request = DelegationRequest(
         input="Summarize this document",
@@ -18,6 +19,7 @@ Example:
         result="The document discusses...",
         extras={"word_count": 150, "confidence": 0.95},
     )
+    ```
 """
 
 from __future__ import annotations