sofias-sdk-lite 0.4.1__tar.gz → 0.4.2__tar.gz

{sofias_sdk_lite-0.4.1 → sofias_sdk_lite-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sofias-sdk-lite
-Version: 0.4.1
+Version: 0.4.2
 Summary: Build agents on the Sofias agent graph and run them over RabbitMQ.
 Keywords: agents,ai,llm,rabbitmq,sofias
 Author: Sofias Tech, S.L.
@@ -148,7 +148,9 @@ resolved at `build()`:
 3. Or explicitly: `.with_llm(create_llm(model="default", api_key=...))`.
 
 ```python
-from sofias_sdk_lite import AgentBuilder, LLMNodeConfig, NodeContract
+from sofias_sdk_lite import (
+    AgentBuilder, LLMNodeConfig, NodeContract, NodePromptConfig,
+)
 
 agent = (
     AgentBuilder("qa_agent")
@@ -157,6 +159,9 @@ agent = (
     .add_llm_node(
         "answerer",
         LLMNodeConfig(name="answerer", input_contract=Question, output_contract=Answer,
+                      # {question} is Question.question — this is how the input
+                      # reaches the model. Without it the model answers blind.
+                      prompt=NodePromptConfig(prompt="Answer this: {question}"),
                       system_prompt="Answer in one sentence."),
         NodeContract(input_schema=Question, output_schema=Answer),
     )
@@ -166,8 +171,18 @@ agent = (
 )
 ```
 
+> **`prompt` is how the node's input reaches the model.** The input is
+> substituted into the `{placeholders}` of `NodePromptConfig` and nowhere
+> else: there is no separate "user message" channel, and `system_prompt` does
+> not carry it — that one is standing instruction (*how* to answer), not the
+> task. Name every input field the model needs to see.
+>
+> A node with no prompt at all still works: the SDK appends the input as a
+> JSON `## Input` section so nothing is silently lost. But the template is
+> what gives you control over how the model reads the task, so write it.
+
 See `examples/03_llm_agent.py` and the
-[LLM integration](docs/concepts/llm-integration.md) guide (streaming,
+[LLM integration](docs/concepts/llm-integration.md) guide (prompts, streaming,
 retries, bringing your own client).
 
 ## Running an agent against RabbitMQ

{sofias_sdk_lite-0.4.1 → sofias_sdk_lite-0.4.2}/README.md

@@ -112,7 +112,9 @@ resolved at `build()`:
 3. Or explicitly: `.with_llm(create_llm(model="default", api_key=...))`.
 
 ```python
-from sofias_sdk_lite import AgentBuilder, LLMNodeConfig, NodeContract
+from sofias_sdk_lite import (
+    AgentBuilder, LLMNodeConfig, NodeContract, NodePromptConfig,
+)
 
 agent = (
     AgentBuilder("qa_agent")
@@ -121,6 +123,9 @@ agent = (
     .add_llm_node(
         "answerer",
         LLMNodeConfig(name="answerer", input_contract=Question, output_contract=Answer,
+                      # {question} is Question.question — this is how the input
+                      # reaches the model. Without it the model answers blind.
+                      prompt=NodePromptConfig(prompt="Answer this: {question}"),
                       system_prompt="Answer in one sentence."),
         NodeContract(input_schema=Question, output_schema=Answer),
     )
@@ -130,8 +135,18 @@ agent = (
 )
 ```
 
+> **`prompt` is how the node's input reaches the model.** The input is
+> substituted into the `{placeholders}` of `NodePromptConfig` and nowhere
+> else: there is no separate "user message" channel, and `system_prompt` does
+> not carry it — that one is standing instruction (*how* to answer), not the
+> task. Name every input field the model needs to see.
+>
+> A node with no prompt at all still works: the SDK appends the input as a
+> JSON `## Input` section so nothing is silently lost. But the template is
+> what gives you control over how the model reads the task, so write it.
+
 See `examples/03_llm_agent.py` and the
-[LLM integration](docs/concepts/llm-integration.md) guide (streaming,
+[LLM integration](docs/concepts/llm-integration.md) guide (prompts, streaming,
 retries, bringing your own client).
 
 ## Running an agent against RabbitMQ

{sofias_sdk_lite-0.4.1 → sofias_sdk_lite-0.4.2}/pyproject.toml

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

{sofias_sdk_lite-0.4.1 → sofias_sdk_lite-0.4.2}/pyproject.toml.orig

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

{sofias_sdk_lite-0.4.1 → sofias_sdk_lite-0.4.2}/src/sofias_sdk_lite/__init__.py

@@ -126,8 +126,13 @@ from sofias_sdk_lite.nodes import (
     DelegationNodeConfig,
     DelegationTransport,
     FunctionNode,
+    FunctionNodeConfig,
     LLMNode,
     LLMNodeConfig,
+    LLMSettings,
+    NodePromptConfig,
+    NodeRetryConfig,
+    NodeToolLoopConfig,
     NodeType,
     NullDelegationTransport,
     PlannerNode,
@@ -262,7 +267,16 @@ __all__ = [
     "NodeType",
     "LLMNode",
     "LLMNodeConfig",
+    # The pieces of an LLMNodeConfig. NodePromptConfig above all: the node's
+    # input only reaches the model through the {placeholders} of its prompt,
+    # so a developer who cannot import it from here writes a node the model
+    # answers blind (TKT-066).
+    "NodePromptConfig",
+    "LLMSettings",
+    "NodeToolLoopConfig",
+    "NodeRetryConfig",
     "FunctionNode",
+    "FunctionNodeConfig",
     "AggregatorNode",
     "AggregatorNodeConfig",
     "DelegationNode",