soe-ai 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

soe/init.py

@@ -14,7 +14,7 @@ from .nodes.agent.factory import create_agent_node_caller
 from .nodes.tool.factory import create_tool_node_caller
 from .nodes.child.factory import create_child_node_caller
 from .lib.yaml_parser import parse_yaml
-from .types import CallLlm, Backends
+from .types import CallLlm, Backends, NodeCaller, BroadcastSignalsCaller
 from .local_backends import create_in_memory_backends, create_local_backends
 
 
@@ -22,7 +22,7 @@ def create_all_nodes(
     backends: Backends,
     call_llm: Optional[CallLlm] = None,
     tools_registry: Optional[Dict[str, Callable]] = None,
-) -> Tuple[Dict[str, Callable], Callable]:
+) -> Tuple[Dict[str, NodeCaller], BroadcastSignalsCaller]:
     """
     Create all node types with automatic wiring.
 

soe/types.py

@@ -7,6 +7,26 @@ from __future__ import annotations
 from typing import Protocol, Optional, Any, Dict, List
 
 
+class EventTypes:
+    """Constants for telemetry event types"""
+
+    ORCHESTRATION_START = "orchestration_start"
+    SIGNALS_BROADCAST = "signals_broadcast"
+    NODE_EXECUTION = "node_execution"
+    TOOL_CALL = "tool_call"
+    LLM_CALL = "llm_call"
+    SIGNALS_TO_PARENT = "signals_to_parent"
+    NODE_ERROR = "node_error"
+    CONTEXT_WARNING = "context_warning"
+    AGENT_TOOLS_LOADED = "agent_tools_loaded"
+    AGENT_TOOL_CALL = "agent_tool_call"
+    AGENT_TOOL_RESULT = "agent_tool_result"
+    AGENT_TOOL_NOT_FOUND = "agent_tool_not_found"
+    CONFIG_INHERITANCE_START = "config_inheritance_start"
+    CONTEXT_INHERITANCE_START = "context_inheritance_start"
+    CONTEXT_MERGE = "context_merge"
+
+
 class TelemetryBackend(Protocol):
     """Protocol for telemetry backend"""
 
@@ -30,7 +50,7 @@ class WorkflowBackend(Protocol):
     def save_workflows_registry(self, id: str, workflows: Dict[str, Any]) -> None:
         ...
 
-    def soe_get_workflows_registry(self, id: str) -> Any:
+    def get_workflows_registry(self, id: str) -> Any:
         ...
 
     def save_current_workflow_name(self, id: str, name: str) -> None:
@@ -40,13 +60,6 @@ class WorkflowBackend(Protocol):
         ...
 
 
-class OrchestrateCaller(Protocol):
-    """Protocol for orchestrate caller function"""
-
-    def __call__(self, execution_id: str, signals: List[str]) -> None:
-        ...
-
-
 class BroadcastSignalsCaller(Protocol):
     """Protocol for broadcast signals caller function"""
 
@@ -54,41 +67,40 @@ class BroadcastSignalsCaller(Protocol):
         ...
 
 
-class RouterNodeCaller(Protocol):
-    """Protocol for router node caller function"""
+class NodeCaller(Protocol):
+    """Protocol for node caller function"""
 
     def __call__(self, execution_id: str, node_config: Dict[str, Any]) -> None:
         ...
 
 
-class AgentNodeCaller(Protocol):
-    """Protocol for agent node caller function"""
+class LlmNodeCaller(NodeCaller):
+    """Protocol for LLM node caller function"""
+    pass
 
-    def __call__(self, execution_id: str, node_config: Dict[str, Any]) -> None:
-        ...
+
+class RouterNodeCaller(NodeCaller):
+    """Protocol for router node caller function"""
+    pass
 
 
-class ToolNodeCaller(Protocol):
-    """Protocol for tool node caller function"""
+class AgentNodeCaller(NodeCaller):
+    """Protocol for agent node caller function"""
+    pass
 
-    def __call__(self, execution_id: str, node_config: Dict[str, Any]) -> None:
-        ...
 
+class ToolNodeCaller(NodeCaller):
+    """Protocol for tool node caller function"""
+    pass
 
-class ChildNodeCaller(Protocol):
-    """Protocol for child node caller function"""
 
-    def __call__(self, execution_id: str, node_config: Dict[str, Any]) -> None:
-        ...
+class ChildNodeCaller(NodeCaller):
+    """Protocol for child node caller function"""
+    pass
 
 
 class OrchestrateCaller(Protocol):
-    """Protocol for starting child workflows (wrapper around orchestrate).
-
-    Supports optional inheritance parameters:
-    - inherit_config_from_id: Inherit workflows, identities, schema from existing execution
-    - inherit_context_from_id: Inherit context from existing execution (resets operational)
-    """
+    """Protocol for starting child workflows (wrapper around orchestrate)"""
 
     def __call__(
         self,

{soe_ai-0.1.0.dist-info → soe_ai-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soe-ai
-Version: 0.1.0
+Version: 0.1.1
 Summary: Signal-driven Orchestration Engine - Agent orchestration with event-driven workflow engine
 Author-email: Pedro Garcia <pedro@example.com>
 License-Expression: MIT
@@ -91,12 +91,44 @@ All workflow state flows through **context**—a shared dictionary accessible vi
 - LLM prompts can interpolate any context field
 - No hidden state—everything is inspectable
 
-### 3. Deterministic + Agentic
-Mix hard-coded logic with LLM-driven behavior in the same workflow. Router nodes are pure conditionals. Agent nodes can call tools. Use what you need.
+### 3. Purely Deterministic or Hybrid Agentic
+SOE is a complete orchestration solution. You can use it as a purely deterministic engine for standard business logic, or mix in LLM-driven "Agentic" behavior.
+- **Deterministic**: Use `router` and `tool` nodes for 100% predictable workflows.
+- **Agentic**: Add `llm` and `agent` nodes for creative, reasoning-based tasks.
+You get the safety of code with the flexibility of AI in a single, unified system.
 
 ### 4. Portable
 Workflows are YAML. Run them locally, in CI, in production. Extract them, version them, share them.
 
+### 5. Self-Evolving
+Workflows can modify themselves at runtime. Built-in tools like `inject_workflow`, `inject_node_configuration`, and `add_signal` allow agents to:
+- Create new workflows dynamically
+- Add or modify nodes in existing workflows
+- Update signal routing on the fly
+
+This enables **meta-programming**: an AI system that can extend its own capabilities without human intervention.
+
+---
+
+## What SOE Unlocks
+
+SOE is a **Protocol for Intelligence** that unlocks new forms of intelligent behavior:
+
+### Self-Evolving Intelligence
+AI systems that can rewrite and improve themselves at runtime - the ultimate evolution of software.
+
+### Swarm Intelligence
+Efficient collective decision-making among multiple agents through signal-based consensus.
+
+### Hybrid Intelligence
+Seamless combination of deterministic logic and AI creativity with programmatic safety rails.
+
+### Fractal Intelligence
+Hierarchical agent organizations that scale complexity while remaining manageable.
+
+### Infrastructure Intelligence
+AI orchestration that works everywhere - from edge devices to cloud platforms.
+
 ---
 
 ## Installation
@@ -117,6 +149,37 @@ cd soe && uv sync
 
 ## Quick Start
 
+### 1. Provide Your LLM
+
+SOE is LLM-agnostic. You must provide a `call_llm` function that matches this signature:
+
+```python
+def call_llm(
+    prompt: str,
+    config: dict,
+) -> str:
+    """
+    Called by SOE when a node needs LLM processing.
+
+    Args:
+        prompt: The rendered prompt string (includes instructions, context, and schemas)
+        config: The full node configuration from YAML (useful for model parameters)
+
+    Returns:
+        The raw text response from the LLM.
+    """
+    # Example with OpenAI:
+    from openai import OpenAI
+    client = OpenAI()
+    response = client.chat.completions.create(
+        model=config.get("model", "gpt-4o"),
+        messages=[{"role": "user", "content": prompt}],
+    )
+    return response.choices[0].message.content
+```
+
+### 2. Run a Workflow
+
 ```python
 from soe import orchestrate, create_all_nodes
 from soe.local_backends import create_local_backends
@@ -134,8 +197,8 @@ example_workflow:
 # Create backends (storage for context, workflows, etc.)
 backends = create_local_backends("./data")
 
-# Create all node handlers
-nodes, broadcast = create_all_nodes(backends)
+# Create all node handlers (pass your call_llm function)
+nodes, broadcast = create_all_nodes(backends, call_llm=call_llm)
 
 # Run the workflow
 execution_id = orchestrate(
@@ -158,8 +221,8 @@ execution_id = orchestrate(
 | Audience | Start Here |
 |----------|------------|
 | **Builders** (workflow authors) | [Documentation](docs/index.md) — Step-by-step chapters |
-| **Engineers** (infrastructure) | [ARCHITECTURE.md](ai_docs/ARCHITECTURE.md) — Design philosophy |
-| **Researchers** (advanced patterns) | [Advanced Patterns](docs/advanced_patterns/index.md) — Swarm, hybrid, self-evolving |
+| **Engineers** (infrastructure) | [Infrastructure Guide](docs/guide_10_infrastructure.md) — Backend protocols |
+| **Researchers** (advanced patterns) | [Advanced Patterns](docs/advanced_patterns/) — Swarm, hybrid, self-evolving |
 
 ---
 

soe_ai-0.1.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+soe/__init__.py,sha256=4g0b-2C4wlr3Aq9eSmISxEMeWRCI4fim_I1v4nfW_Cs,1131
+soe/broker.py,sha256=F_lKV0uqi9_dY1NIzQnUFJm84r6xd1CmvXjjfgRpwrM,5956
+soe/docs_index.py,sha256=L-VkR0rfr9qGbMHIhhc_gAZKToBsFyiAxW42qj1bFag,3425867
+soe/init.py,sha256=SdVV1oTmh63BCtJpaYZavyO0ALfffsFgd75Vb8aJmXI,5928
+soe/types.py,sha256=3CERX7rti_xRSliH2knZKeNDWqbetWg0z-tTQaGZODk,5929
+soe_ai-0.1.1.dist-info/licenses/LICENSE,sha256=SvEn330zvSOu83Vi4lDCX2QHgr6bmSSXOV1YClLGk1Y,1069
+soe_ai-0.1.1.dist-info/METADATA,sha256=3i9sm4-lbSA6kKZhHcEeIkkvvPH2gWDrIaAK7wh3Pl8,8781
+soe_ai-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+soe_ai-0.1.1.dist-info/top_level.txt,sha256=TUufXyVAQnzN6iT6zRb4dRHdfBSiWXuAL8EoyvugZuY,4
+soe_ai-0.1.1.dist-info/RECORD,,

soe/validation.py

@@ -1,8 +0,0 @@
-"""
-DEPRECATED: This module has been moved to soe/validation/ folder.
-This file is kept temporarily but will be removed.
-
-Import from soe.validation instead:
-    from soe.validation import validate_config, validate_operational
-"""
-# This file should be deleted - Python will import from soe/validation/ folder instead

soe_ai-0.1.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-soe/__init__.py,sha256=4g0b-2C4wlr3Aq9eSmISxEMeWRCI4fim_I1v4nfW_Cs,1131
-soe/broker.py,sha256=R5s5GvgmwgBQK9FyI-UAMVb7nf14tMdXpeEZ-t8d3rE,5987
-soe/docs_index.py,sha256=mDnQ-LVyPgF25_8yCuD04j2PxiQCR_6Si_NMkfJyk-0,3055071
-soe/init.py,sha256=Fzw7MDoEOlZLfCwH-kL0evUjc3WHmLEVOaeR2-dgwWs,5876
-soe/types.py,sha256=xSmkRcKehYW2pesnzB0qCZHjpm_IoDTBbQcb1SwV-8o,5712
-soe/validation.py,sha256=SeBfGaaGjUi73ejnHNqVLTv7LYtU_gFHX8OJ3iytJMo,318
-soe_ai-0.1.0.dist-info/licenses/LICENSE,sha256=SvEn330zvSOu83Vi4lDCX2QHgr6bmSSXOV1YClLGk1Y,1069
-soe_ai-0.1.0.dist-info/METADATA,sha256=bWjq5DC6W9NenF18lKAgVkK-xZE_9cYGYJOOCQCoHSM,6558
-soe_ai-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-soe_ai-0.1.0.dist-info/top_level.txt,sha256=TUufXyVAQnzN6iT6zRb4dRHdfBSiWXuAL8EoyvugZuY,4
-soe_ai-0.1.0.dist-info/RECORD,,