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

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sofias-sdk-lite
-Version: 0.2.0
+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.

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

@@ -1,6 +1,6 @@
 [project]
 name = "sofias-sdk-lite"
-version = "0.2.0"
+version = "0.2.1"
 description = "Build agents on the Sofias agent graph and run them over RabbitMQ."
 readme = "README.md"
 requires-python = ">=3.11"

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

@@ -1,6 +1,6 @@
 [project]
 name = "sofias-sdk-lite"
-version = "0.2.0"
+version = "0.2.1"
 description = "Build agents on the Sofias agent graph and run them over RabbitMQ."
 readme = "README.md"
 requires-python = ">=3.11"

{sofias_sdk_lite-0.2.0 → 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.2.0 → 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.2.0 → 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.2.0 → 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.2.0 → 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.2.0 → 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) ---

{sofias_sdk_lite-0.2.0 → 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.2.0 → 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.2.0 → 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.2.0 → 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.2.0 → 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

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/errors/error_handler.py

@@ -153,12 +153,14 @@ class ErrorHandler:
     callable provided by the agent.
 
     Example:
+        ```python
         handler = ErrorHandler(config=config, store=store)
         result = await handler.handle_node_execution(
             node_name="processor",
             execute_fn=node.execute,
             input_data={"query": "hello"},
         )
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/messaging/models.py

@@ -332,6 +332,7 @@ class DelegationTarget(BaseModel):
     the communication with a specific target agent.
 
     Example:
+        ```python
         target = DelegationTarget(
             agent_name="summarizer",
             routing_key="agents.summarizer.tasks",
@@ -339,6 +340,7 @@ class DelegationTarget(BaseModel):
             output_contract=SummaryOutput,
             timeout_seconds=120,
         )
+        ```
 
     .. note::
         Unlike the internal platform, this SDK does **not** assume any
@@ -394,12 +396,14 @@ class DelegationStep(BaseModel):
     on other steps. Used when dynamic targets are enabled.
 
     Example:
+        ```python
         step = DelegationStep(
             id="step_1",
             agent_name="web-search",
             input={"query": "Bitcoin price"},
             depends_on=[],
         )
+        ```
     """
 
     model_config = {"frozen": True}
@@ -445,6 +449,7 @@ class DelegationPlan(BaseModel):
     delegation node running in DAG mode with dynamic targets.
 
     Example:
+        ```python
         plan = DelegationPlan(
             steps=[
                 DelegationStep(id="s1", agent_name="search", input={"q": "A"}),
@@ -452,6 +457,7 @@ class DelegationPlan(BaseModel):
                 DelegationStep(id="s3", agent_name="synthesizer", input={}, depends_on=["s1", "s2"]),
             ]
         )
+        ```
     """
 
     model_config = {"frozen": True}

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/nodes/aggregator_config.py

@@ -19,6 +19,7 @@ class AggregatorNodeConfig(BaseModel):
     to a configurable policy (all, any, majority).
 
     Example:
+        ```python
         config = AggregatorNodeConfig(
             name="collect_results",
             description="Collects responses from all sub-agents",
@@ -26,6 +27,7 @@ class AggregatorNodeConfig(BaseModel):
             timeout_seconds=120.0,
             on_timeout="partial_result",
         )
+        ```
     """
 
     model_config = ConfigDict(frozen=True)

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/nodes/aggregator_node.py

@@ -53,6 +53,7 @@ class AggregatorNode(BaseNode):
     controlled by retry_timeout_seconds (or timeout_seconds if not set).
 
     Example:
+        ```python
         config = AggregatorNodeConfig(
             name="collect_results",
             resolution_policy="all",
@@ -73,6 +74,7 @@ class AggregatorNode(BaseNode):
         #     "total_expected": 2,
         #     "total_received": 2,
         # }
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/nodes/base_node.py

@@ -50,10 +50,12 @@ class BaseNode(ABC):
         - FunctionNode: Nodes that execute deterministic Python logic.
 
     Example:
+        ```python
         class MyCustomNode(BaseNode):
             async def _run(self, input_data: dict, context: dict | None = None) -> dict:
                 # Custom logic here
                 return {"result": "processed"}
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/nodes/delegation_config.py

@@ -26,6 +26,7 @@ class DelegationTarget(BaseModel):
     the communication with a specific target agent.
 
     Example:
+        ```python
         target = DelegationTarget(
             agent_name="summarizer",
             routing_key="agent.summarizer",
@@ -33,6 +34,7 @@ class DelegationTarget(BaseModel):
             output_contract=SummaryOutput,
             timeout_seconds=120,
         )
+        ```
     """
 
     model_config = ConfigDict(frozen=True)
@@ -69,12 +71,14 @@ class DelegationStep(BaseModel):
     on other steps. Used when dynamic_targets is enabled.
 
     Example:
+        ```python
         step = DelegationStep(
             id="step_1",
             agent_name="web-search",
             input={"query": "Bitcoin price"},
             depends_on=[],
         )
+        ```
     """
 
     model_config = ConfigDict(frozen=True)
@@ -107,6 +111,7 @@ class DelegationPlan(BaseModel):
     when execution_mode='dag' and dynamic_targets=True.
 
     Example:
+        ```python
         plan = DelegationPlan(
             steps=[
                 DelegationStep(id="s1", agent_name="search", input={"q": "A"}),
@@ -114,6 +119,7 @@ class DelegationPlan(BaseModel):
                 DelegationStep(id="s3", agent_name="synthesizer", input={}, depends_on=["s1", "s2"]),
             ]
         )
+        ```
     """
 
     model_config = ConfigDict(frozen=True)

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/nodes/function_node.py

@@ -63,6 +63,7 @@ class FunctionNode(BaseNode):
                 return {"merged": ...}
 
     Example:
+        ```python
         node = FunctionNode(
             name="transformer",
             contract=NodeContract(input_schema=RawInput, output_schema=FormattedOutput),
@@ -70,6 +71,7 @@ class FunctionNode(BaseNode):
         )
         result = await node.execute({"input": 5})
         # result: {"value": 10}
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/nodes/llm_node.py

@@ -133,6 +133,7 @@ class LLMNode(BaseNode):
     result.
 
     Example:
+        ```python
         node = LLMNode(
             config=node_config,
             contract=NodeContract(input_schema=MyInput, output_schema=MyOutput),
@@ -140,6 +141,7 @@ class LLMNode(BaseNode):
             tools=[tool1, tool2],
         )
         result = await node.execute({"query": "Hello"})
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/nodes/llm_node_config.py

@@ -157,6 +157,7 @@ class LLMNodeConfig(BaseModel):
     are optional and default to None, meaning "inherit from parent level".
 
     Example:
+        ```python
         config = LLMNodeConfig(
             name="classifier",
             description="Classifies incoming emails",
@@ -168,6 +169,7 @@ class LLMNodeConfig(BaseModel):
                 template_variables={"categories": ["spam", "urgent", "normal"]},
             ),
         )
+        ```
     """
 
     model_config = ConfigDict(frozen=True)
@@ -256,11 +258,13 @@ class FunctionNodeConfig(BaseModel):
     without an LLM. No prompt, tool loop, or LLM settings are needed.
 
     Example:
+        ```python
         config = FunctionNodeConfig(
             name="data_merger",
             description="Merges outputs from multiple upstream nodes",
             retry_policy=RetryPolicy(max_retries=2),
         )
+        ```
     """
 
     model_config = ConfigDict(frozen=True)

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/nodes/planner_node.py

@@ -38,6 +38,7 @@ class PlannerNode(BaseNode):
     routes the output to PlanExecutor for execution.
 
     Example:
+        ```python
         planner = PlannerNode(
             name="planner",
             contract=planner_contract,
@@ -47,6 +48,7 @@ class PlannerNode(BaseNode):
                 NodeDescriptor(name="summarize", node_type=NodeType.LLM, description="Summarize text"),
             ],
         )
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/nodes/prompt_assembler.py

@@ -33,12 +33,14 @@ class PromptAssembler:
     variables merged with runtime variables (runtime takes precedence).
 
     Example:
+        ```python
         assembler = PromptAssembler(
             config=node_config,
             tools=[tool_spec_1, tool_spec_2],
             output_contract=MyOutputContract,
         )
         prompt = assembler.assemble(runtime_vars={"user_name": "Alice"})
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/observability/events.py

@@ -134,6 +134,7 @@ class EventAdapter:
     - Error handling and logging
 
     Example:
+        ```python
         publisher = RabbitMQPublisher(connection)
         listener = RabbitMQListener(connection)
         events = EventAdapter(publisher, listener)
@@ -151,6 +152,7 @@ class EventAdapter:
             agent_name="inbox_assist",
             handler=my_handler,
         )
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/observability/tracing.py

@@ -215,6 +215,7 @@ class TracingAdapter:
     - No-op behavior when provider is None
 
     Example:
+        ```python
         provider = OTelTracingProvider("my-agent-service")
         tracing = TracingAdapter(provider)
 
@@ -226,6 +227,7 @@ class TracingAdapter:
         # Trace node execution
         with tracing.trace_node_execution("classifier", input_data) as span:
             result = await node.execute(input_data)
+        ```
     """
 
     def __init__(self, provider: TracingProvider | None = None) -> None:
@@ -298,9 +300,11 @@ class TracingAdapter:
             The span for adding events and attributes.
 
         Example:
+            ```python
             with tracing.trace_agent_execution("my_agent", "1.0.0") as span:
                 span.set_attribute("input.type", "email")
                 response = agent.execute(message)
+            ```
         """
         attributes = {
             "agent.name": agent_name,

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/rabbitmq/consumer.py

@@ -27,7 +27,8 @@ class RabbitMQConsumer:
     The handler receives a :class:`MessageContext` with the deserialized
     payload, AMQP metadata, and ack/nack helpers.
 
-    Example::
+    Example:
+        ```python
 
         async with RabbitMQClient(config) as client:
             consumer = RabbitMQConsumer(
@@ -40,6 +41,7 @@ class RabbitMQConsumer:
                 await asyncio.Event().wait()
             except asyncio.CancelledError:
                 await consumer.stop()
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/rabbitmq/delegation_transport.py

@@ -38,6 +38,7 @@ class RabbitMQDelegationTransport:
     - Responses arriving before wait_* are buffered, not lost
 
     Example:
+        ```python
         client = RabbitMQClient(config)
         await client.connect()
 
@@ -65,6 +66,7 @@ class RabbitMQDelegationTransport:
             print(f"{cid} responded with: {response}")
 
         await client.disconnect()
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/rabbitmq/rpc_client.py

@@ -38,6 +38,7 @@ class RabbitMQRPCClient:
     3. Waits for responses matching the correlation_id
 
     Example:
+        ```python
         client = RabbitMQClient(config)
         await client.connect()
 
@@ -49,6 +50,7 @@ class RabbitMQRPCClient:
             )
 
         await client.disconnect()
+        ```
     """
 
     def __init__(

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/routing/router.py

@@ -31,6 +31,7 @@ class Router:
     graph. Execution is handled by the agent (Phase 5).
 
     Example:
+        ```python
         router = Router()
         router.add_route(
             "classifier",
@@ -47,6 +48,7 @@ class Router:
         # Later, during execution:
         next_node = router.resolve("classifier", {"category": "urgent"})
         # Returns "priority_handler"
+        ```
     """
 
     def __init__(self) -> None:

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/routing/strategies.py

@@ -57,6 +57,7 @@ class FieldValueStrategy:
     outputs where different categories lead to different processing paths.
 
     Example:
+        ```python
         strategy = FieldValueStrategy(
             field="category",
             mapping={"urgent": "priority_handler", "spam": "discard"},
@@ -65,6 +66,7 @@ class FieldValueStrategy:
         # If output["category"] == "urgent" -> "priority_handler"
         # If output["category"] == "spam" -> "discard"
         # If output["category"] == "other" -> "normal_handler" (default)
+        ```
     """
 
     def __init__(
@@ -127,6 +129,7 @@ class ConfidenceThresholdStrategy:
     leads to automated processing and low confidence requires human review.
 
     Example:
+        ```python
         strategy = ConfidenceThresholdStrategy(
             field="confidence",
             threshold=0.8,
@@ -135,6 +138,7 @@ class ConfidenceThresholdStrategy:
         )
         # If output["confidence"] >= 0.8 -> "auto_respond"
         # If output["confidence"] < 0.8 -> "human_review"
+        ```
     """
 
     def __init__(
@@ -199,6 +203,7 @@ class FieldPresenceStrategy:
     "present" if it exists, is not None, and is not empty (for collections).
 
     Example:
+        ```python
         strategy = FieldPresenceStrategy(
             field="tool_calls",
             present="tool_executor",
@@ -206,6 +211,7 @@ class FieldPresenceStrategy:
         )
         # If output["tool_calls"] has content -> "tool_executor"
         # If output["tool_calls"] is None/empty -> "final_response"
+        ```
     """
 
     def __init__(
@@ -270,12 +276,14 @@ class ConditionalStrategy:
     and returns the target node name.
 
     Example:
+        ```python
         def custom_router(output: dict) -> str:
             if output["score"] > 0.9 and output["verified"]:
                 return "premium_handler"
             return "standard_handler"
 
         strategy = ConditionalStrategy(condition=custom_router)
+        ```
     """
 
     def __init__(
@@ -325,12 +333,14 @@ class FanOutStrategy:
     collects the results after all parallel branches complete.
 
     Example:
+        ```python
         strategy = FanOutStrategy(
             targets=["sentiment", "entities", "summary"],
             join_node="merger",
         )
         # Dispatches to all three nodes in parallel.
         # After all complete, execution continues at "merger".
+        ```
     """
 
     def __init__(
@@ -402,6 +412,7 @@ class CompositeStrategy:
     default.
 
     Example:
+        ```python
         strategy = CompositeStrategy(
             strategies=[
                 FieldPresenceStrategy("error", "error_handler", None),
@@ -409,6 +420,7 @@ class CompositeStrategy:
             ],
             default="fallback",
         )
+        ```
     """
 
     def __init__(
@@ -455,8 +467,10 @@ class StaticRoute:
     For conditional routing, use FieldValueStrategy or ConditionalStrategy.
 
     Example:
+        ```python
         strategy = StaticRoute("responder")
         # output is ignored — always returns "responder"
+        ```
     """
 
     def __init__(self, target: str) -> None:

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/runner/runner.py

@@ -4,7 +4,8 @@ Subclass and implement:
 - build_agent(settings, workflow) -> Agent
 - prepare_input(task, history, role) -> AgentMessage
 
-Example::
+Example:
+    ```python
 
     class MyAgentRunner(AgentRunner):
         settings_class = MySettings
@@ -30,6 +31,7 @@ Example::
             agent_name="my_agent",
             rabbitmq=RabbitMQConfig(host="localhost"),
         )).run()
+    ```
 """
 
 from __future__ import annotations

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/state/conversation_state.py

@@ -105,12 +105,14 @@ class ConversationStateAdapter:
     (``raise_on_error=False``).
 
     Example:
+        ```python
         provider = InMemoryStateProvider()
         state = ConversationStateAdapter(provider)
 
         await state.set("conv-123", "validation:doc1", {"questions": [...]})
         data = await state.get("conv-123", "validation:doc1")
         await state.delete("conv-123", "validation:doc1")
+        ```
     """
 
     def __init__(
@@ -221,11 +223,13 @@ class InMemoryStateProvider:
     (state is lost on process restart).
 
     Example:
+        ```python
         provider = InMemoryStateProvider()
         await provider.set("conv-1", "key-a", {"foo": "bar"})
         data = await provider.get("conv-1", "key-a")  # {"foo": "bar"}
         await provider.delete("conv-1", "key-a")
         data = await provider.get("conv-1", "key-a")  # None
+        ```
     """
 
     def __init__(self) -> None:

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/state/history.py

@@ -114,9 +114,11 @@ class InMemoryHistory:
     (history is lost on process restart).
 
     Example:
+        ```python
         history = InMemoryHistory()
         await history.append("conv-1", Message(role="user", content="hi"))
         messages = await history.get("conv-1")  # [Message(role="user", ...)]
+        ```
     """
 
     def __init__(self) -> None:

{sofias_sdk_lite-0.2.0 → sofias_sdk_lite-0.2.1}/src/sofias_sdk_lite/llm/factory.py

@@ -232,6 +232,14 @@ def create_llm(
             "reasoning_effort": reasoning_effort,
         },
     )
+    if not config.base_url.strip():
+        raise LLMConfigurationError(
+            f"No LLM gateway URL configured for model '{config.model}'. On the Sofias "
+            f"platform {ENV_LLM_BASE_URL} is injected automatically; to run locally, "
+            "export it or install a fake LLM with default_llm(...).",
+            missing=["base_url"],
+        )
+
     if not config.api_key.get_secret_value():
         logger.warning(
             "LLM gateway configured without an API key; requests will be unauthenticated",
@@ -251,14 +259,6 @@ def create_llm(
     if config.temperature is not None:
         common["temperature"] = config.temperature
 
-    if not config.base_url.strip():
-        raise LLMConfigurationError(
-            f"No LLM gateway URL configured for model '{config.model}'. On the Sofias "
-            f"platform {ENV_LLM_BASE_URL} is injected automatically; to run locally, "
-            "export it or install a fake LLM with default_llm(...).",
-            missing=["base_url"],
-        )
-
     provider_name = config.provider.lower()
     if provider_name == PROVIDER_GATEWAY:
         return GatewayLLM(reasoning_effort=config.reasoning_effort, **common)