agentbreeder-sdk 0.1.0__tar.gz

agentbreeder_sdk-0.1.0/.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+*.whl
+
+# Virtual environments
+venv/
+.venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Environment
+.env
+.env.local
+.env.production
+
+# Testing & Coverage
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+*.log
+
+# AgentBreeder local state
+.agentbreeder/
+
+# Node (dashboard)
+node_modules/
+dashboard/dist/
+dashboard/.env
+dashboard/test-results/

agentbreeder_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: agentbreeder-sdk
+Version: 0.1.0
+Summary: AgentBreeder Python SDK — define, validate, and deploy AI agents programmatically.
+Project-URL: Homepage, https://github.com/open-agent-garden/agentbreeder
+Project-URL: Repository, https://github.com/open-agent-garden/agentbreeder
+Project-URL: Documentation, https://open-agent-garden.github.io/agentbreeder
+Author: AgentBreeder Contributors
+License-Expression: Apache-2.0
+Keywords: agentbreeder,agents,ai,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# agentbreeder-sdk
+
+The official Python SDK for [AgentBreeder](https://github.com/open-agent-garden/agentbreeder) — define, validate, and deploy AI agents programmatically.
+
+## Installation
+
+```bash
+pip install agentbreeder-sdk
+```
+
+For MCP server authoring support:
+
+```bash
+pip install "agentbreeder-sdk[mcp]"
+```
+
+## Quick Start
+
+```python
+from agenthub import Agent, Tool, Model, Memory
+
+# Define an agent
+agent = (
+    Agent("customer-support", version="1.0.0", team="customer-success")
+    .with_model(primary="claude-sonnet-4", fallback="gpt-4o")
+    .with_prompt(system="You are a helpful customer support agent.")
+    .with_tool(ref="tools/zendesk-mcp")
+    .with_tool(ref="tools/order-lookup")
+    .with_deploy(cloud="aws", region="us-east-1")
+)
+
+# Validate and export to agent.yaml
+agent.validate()
+agent.to_yaml("agent.yaml")
+```
+
+## Multi-Agent Orchestration
+
+```python
+from agenthub import Orchestration, KeywordRouter
+
+pipeline = (
+    Orchestration("support-router", strategy="router", team="customer-success")
+    .add_agent("triage",  ref="agents/triage-agent")
+    .add_agent("billing", ref="agents/billing-agent")
+    .add_agent("returns", ref="agents/returns-agent")
+    .with_route("triage", condition="billing",  target="billing")
+    .with_route("triage", condition="return",   target="returns")
+)
+
+pipeline.to_yaml("orchestration.yaml")
+```
+
+## Key Classes
+
+| Class | Description |
+|-------|-------------|
+| `Agent` | Define an individual AI agent |
+| `Tool` | Define or reference a tool |
+| `Model` | Configure a model (primary + fallback) |
+| `Memory` | Configure agent memory |
+| `Orchestration` | Define multi-agent orchestration |
+| `Pipeline` | Sequential agent pipeline |
+| `FanOut` | Parallel fan-out orchestration |
+| `Supervisor` | Supervisor + worker orchestration |
+
+All classes serialize to the same `agent.yaml` / `orchestration.yaml` format consumed by `agentbreeder deploy`.
+
+## Tier Mobility
+
+The SDK is the **Full Code** tier of AgentBreeder. You can eject from a YAML config to SDK code at any time:
+
+```bash
+agentbreeder eject agent.yaml --output agent_sdk.py
+```
+
+## Links
+
+- [Documentation](https://open-agent-garden.github.io/agentbreeder)
+- [GitHub](https://github.com/open-agent-garden/agentbreeder)
+- [agent.yaml reference](https://open-agent-garden.github.io/agentbreeder/agent-yaml)

agentbreeder_sdk-0.1.0/README.md

@@ -0,0 +1,81 @@
+# agentbreeder-sdk
+
+The official Python SDK for [AgentBreeder](https://github.com/open-agent-garden/agentbreeder) — define, validate, and deploy AI agents programmatically.
+
+## Installation
+
+```bash
+pip install agentbreeder-sdk
+```
+
+For MCP server authoring support:
+
+```bash
+pip install "agentbreeder-sdk[mcp]"
+```
+
+## Quick Start
+
+```python
+from agenthub import Agent, Tool, Model, Memory
+
+# Define an agent
+agent = (
+    Agent("customer-support", version="1.0.0", team="customer-success")
+    .with_model(primary="claude-sonnet-4", fallback="gpt-4o")
+    .with_prompt(system="You are a helpful customer support agent.")
+    .with_tool(ref="tools/zendesk-mcp")
+    .with_tool(ref="tools/order-lookup")
+    .with_deploy(cloud="aws", region="us-east-1")
+)
+
+# Validate and export to agent.yaml
+agent.validate()
+agent.to_yaml("agent.yaml")
+```
+
+## Multi-Agent Orchestration
+
+```python
+from agenthub import Orchestration, KeywordRouter
+
+pipeline = (
+    Orchestration("support-router", strategy="router", team="customer-success")
+    .add_agent("triage",  ref="agents/triage-agent")
+    .add_agent("billing", ref="agents/billing-agent")
+    .add_agent("returns", ref="agents/returns-agent")
+    .with_route("triage", condition="billing",  target="billing")
+    .with_route("triage", condition="return",   target="returns")
+)
+
+pipeline.to_yaml("orchestration.yaml")
+```
+
+## Key Classes
+
+| Class | Description |
+|-------|-------------|
+| `Agent` | Define an individual AI agent |
+| `Tool` | Define or reference a tool |
+| `Model` | Configure a model (primary + fallback) |
+| `Memory` | Configure agent memory |
+| `Orchestration` | Define multi-agent orchestration |
+| `Pipeline` | Sequential agent pipeline |
+| `FanOut` | Parallel fan-out orchestration |
+| `Supervisor` | Supervisor + worker orchestration |
+
+All classes serialize to the same `agent.yaml` / `orchestration.yaml` format consumed by `agentbreeder deploy`.
+
+## Tier Mobility
+
+The SDK is the **Full Code** tier of AgentBreeder. You can eject from a YAML config to SDK code at any time:
+
+```bash
+agentbreeder eject agent.yaml --output agent_sdk.py
+```
+
+## Links
+
+- [Documentation](https://open-agent-garden.github.io/agentbreeder)
+- [GitHub](https://github.com/open-agent-garden/agentbreeder)
+- [agent.yaml reference](https://open-agent-garden.github.io/agentbreeder/agent-yaml)

agentbreeder_sdk-0.1.0/agenthub/__init__.py

@@ -0,0 +1,81 @@
+"""AgentBreeder Python SDK — Full Code tier.
+
+Define, validate, serialize, and deploy agents and orchestrations programmatically.
+
+Usage::
+
+    from agenthub import Agent, Tool, Model, Memory
+    from agenthub import Orchestration, Pipeline, FanOut, Supervisor
+    from agenthub import KeywordRouter, IntentRouter, RoundRobinRouter, ClassifierRouter
+
+    agent = (
+        Agent("my-agent", version="1.0.0", team="eng")
+        .with_model(primary="claude-sonnet-4")
+        .with_prompt(system="You are helpful.")
+        .with_deploy(cloud="aws")
+    )
+
+    pipeline = (
+        Orchestration("support", strategy="router", team="eng")
+        .add_agent("triage", ref="agents/triage")
+        .add_agent("billing", ref="agents/billing")
+        .with_route("triage", condition="billing", target="billing")
+    )
+"""
+
+from .agent import Agent, AgentConfig
+from .deploy import DeployConfig, PromptConfig
+from .memory import Memory, MemoryConfig
+from .model import Model, ModelConfig
+from .orchestration import (
+    AgentEntry,
+    ClassifierRouter,
+    FanOut,
+    IntentRouter,
+    KeywordRouter,
+    Orchestration,
+    OrchestrationConfig,
+    OrchestrationDeployConfig,
+    Pipeline,
+    RoundRobinRouter,
+    Router,
+    RouteRule,
+    SharedStateConfig,
+    Supervisor,
+    SupervisorConfig,
+)
+from .tool import Tool, ToolConfig
+
+__version__ = "0.1.0"
+
+__all__ = [
+    # Agent
+    "Agent",
+    "AgentConfig",
+    "DeployConfig",
+    "Memory",
+    "MemoryConfig",
+    "Model",
+    "ModelConfig",
+    "PromptConfig",
+    "Tool",
+    "ToolConfig",
+    # Orchestration — builders
+    "Orchestration",
+    "Pipeline",
+    "FanOut",
+    "Supervisor",
+    # Orchestration — routers
+    "Router",
+    "KeywordRouter",
+    "IntentRouter",
+    "RoundRobinRouter",
+    "ClassifierRouter",
+    # Orchestration — data types
+    "OrchestrationConfig",
+    "OrchestrationDeployConfig",
+    "AgentEntry",
+    "RouteRule",
+    "SharedStateConfig",
+    "SupervisorConfig",
+]

agentbreeder_sdk-0.1.0/agenthub/agent.py

@@ -0,0 +1,215 @@
+"""Core Agent class for the AgentBreeder Full Code Python SDK.
+
+Provides a builder-pattern API for defining agents programmatically.
+The resulting agent config can be serialized to valid agent.yaml,
+loaded from YAML, and deployed via the standard pipeline.
+"""
+
+from __future__ import annotations
+
+import logging
+from collections.abc import Callable
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+from .deploy import DeployConfig, PromptConfig
+from .memory import MemoryConfig
+from .model import ModelConfig
+from .tool import Tool, ToolConfig
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class AgentConfig:
+    """Configuration for an AgentBreeder agent."""
+
+    name: str
+    version: str = "1.0.0"
+    description: str = ""
+    team: str = "default"
+    owner: str = ""
+    framework: str = "custom"
+    model: ModelConfig | None = None
+    tools: list[ToolConfig] = field(default_factory=list)
+    prompts: PromptConfig | None = None
+    memory: MemoryConfig | None = None
+    guardrails: list[str] = field(default_factory=list)
+    deploy: DeployConfig | None = None
+    tags: list[str] = field(default_factory=list)
+    knowledge_bases: list[str] = field(default_factory=list)
+    subagents: list[dict[str, str]] = field(default_factory=list)
+    mcp_servers: list[dict[str, str]] = field(default_factory=list)
+
+
+class Agent:
+    """Full Code SDK entry point for defining agents programmatically.
+
+    Supports a fluent builder pattern::
+
+        agent = (
+            Agent("my-agent", version="1.0.0", team="eng")
+            .with_model(primary="claude-sonnet-4")
+            .with_prompt(system="You are helpful.")
+            .with_deploy(cloud="aws")
+        )
+    """
+
+    def __init__(self, name: str, **kwargs: Any) -> None:
+        self.config = AgentConfig(name=name, **kwargs)
+        self._tools: list[Tool] = []
+        self._middleware: list[Callable[..., Any]] = []
+        self._hooks: dict[str, list[Callable[..., Any]]] = {}
+        self._state: dict[str, Any] = {}
+
+    # -----------------------------------------------------------------
+    # Builder pattern methods (all return self for chaining)
+    # -----------------------------------------------------------------
+
+    def with_model(
+        self,
+        primary: str,
+        fallback: str | None = None,
+        **kwargs: Any,
+    ) -> Agent:
+        """Configure the LLM model."""
+        self.config.model = ModelConfig(primary=primary, fallback=fallback, **kwargs)
+        return self
+
+    def with_tool(self, tool: Tool) -> Agent:
+        """Add a tool to this agent."""
+        self._tools.append(tool)
+        self.config.tools.append(tool.to_config())
+        return self
+
+    def with_prompt(self, system: str, **kwargs: Any) -> Agent:
+        """Set the system prompt (inline text or registry ref)."""
+        self.config.prompts = PromptConfig(system=system, **kwargs)
+        return self
+
+    def with_memory(self, backend: str = "in_memory", **kwargs: Any) -> Agent:
+        """Configure conversation memory."""
+        self.config.memory = MemoryConfig(backend=backend, **kwargs)
+        return self
+
+    def with_guardrail(self, name: str) -> Agent:
+        """Add a guardrail by name."""
+        self.config.guardrails.append(name)
+        return self
+
+    def with_subagent(
+        self,
+        ref: str,
+        name: str | None = None,
+        description: str | None = None,
+    ) -> Agent:
+        """Add a subagent reference for A2A communication."""
+        entry: dict[str, str] = {"ref": ref}
+        if name:
+            entry["name"] = name
+        if description:
+            entry["description"] = description
+        self.config.subagents.append(entry)
+        return self
+
+    def with_mcp_server(self, ref: str, transport: str = "stdio") -> Agent:
+        """Attach an MCP server as a sidecar."""
+        self.config.mcp_servers.append({"ref": ref, "transport": transport})
+        return self
+
+    def with_deploy(self, cloud: str = "local", **kwargs: Any) -> Agent:
+        """Configure deployment target."""
+        self.config.deploy = DeployConfig(cloud=cloud, **kwargs)
+        return self
+
+    def tag(self, *tags: str) -> Agent:
+        """Add discovery tags."""
+        self.config.tags.extend(tags)
+        return self
+
+    # -----------------------------------------------------------------
+    # Advanced features
+    # -----------------------------------------------------------------
+
+    def use(self, middleware: Callable[..., Any]) -> Agent:
+        """Add middleware (pre/post processing on every turn)."""
+        self._middleware.append(middleware)
+        return self
+
+    def on(self, event: str, handler: Callable[..., Any]) -> Agent:
+        """Register event hook (tool_call, turn_start, turn_end, error)."""
+        self._hooks.setdefault(event, []).append(handler)
+        return self
+
+    @property
+    def state(self) -> dict[str, Any]:
+        """Typed state persisted across turns."""
+        return self._state
+
+    def route(self, message: str, context: dict[str, Any]) -> str | None:
+        """Override for custom routing logic. Return tool/agent name or None."""
+        return None
+
+    def select_tools(self, message: str) -> list[Tool]:
+        """Override for dynamic tool selection based on input."""
+        return list(self._tools)
+
+    # -----------------------------------------------------------------
+    # Serialization
+    # -----------------------------------------------------------------
+
+    def to_yaml(self) -> str:
+        """Serialize to valid agent.yaml content."""
+        from .yaml_utils import agent_to_yaml
+
+        return agent_to_yaml(self)
+
+    @classmethod
+    def from_yaml(cls, yaml_content: str) -> Agent:
+        """Load agent from YAML string."""
+        from .yaml_utils import yaml_to_agent
+
+        return yaml_to_agent(yaml_content)
+
+    @classmethod
+    def from_file(cls, path: str) -> Agent:
+        """Load agent from YAML file path."""
+        content = Path(path).read_text(encoding="utf-8")
+        return cls.from_yaml(content)
+
+    def save(self, path: str) -> None:
+        """Save agent.yaml to disk."""
+        Path(path).write_text(self.to_yaml(), encoding="utf-8")
+        logger.info("Saved agent config to %s", path)
+
+    # -----------------------------------------------------------------
+    # Deployment
+    # -----------------------------------------------------------------
+
+    def deploy(self, target: str = "local") -> dict[str, Any]:
+        """Deploy this agent (wraps agentbreeder deploy).
+
+        Returns deploy info dict. Currently a placeholder that saves the
+        YAML and returns metadata; the real implementation delegates to
+        the engine.DeployEngine pipeline.
+        """
+        logger.info("Deploying agent '%s' to target '%s'", self.config.name, target)
+        return {
+            "agent": self.config.name,
+            "version": self.config.version,
+            "target": target,
+            "status": "pending",
+        }
+
+    def validate(self) -> list[str]:
+        """Validate the agent config. Returns list of error messages (empty = valid)."""
+        from .validation import validate_agent
+
+        return validate_agent(self)
+
+    def __repr__(self) -> str:
+        return (
+            f"Agent(name={self.config.name!r}, version={self.config.version!r}, "
+            f"framework={self.config.framework!r})"
+        )

agentbreeder_sdk-0.1.0/agenthub/deploy.py

@@ -0,0 +1,47 @@
+"""Deploy and prompt configuration dataclasses for AgentBreeder agents."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any
+
+
+@dataclass
+class DeployConfig:
+    """Deployment target configuration."""
+
+    cloud: str = "local"
+    runtime: str | None = None
+    region: str | None = None
+    scaling: dict[str, Any] | None = None
+    resources: dict[str, str] | None = None
+    env_vars: dict[str, str] = field(default_factory=dict)
+    secrets: list[str] = field(default_factory=list)
+
+    def to_dict(self) -> dict:
+        """Serialize to a dict suitable for YAML output."""
+        d: dict = {"cloud": self.cloud}
+        if self.runtime is not None:
+            d["runtime"] = self.runtime
+        if self.region is not None:
+            d["region"] = self.region
+        if self.scaling is not None:
+            d["scaling"] = self.scaling
+        if self.resources is not None:
+            d["resources"] = self.resources
+        if self.env_vars:
+            d["env_vars"] = self.env_vars
+        if self.secrets:
+            d["secrets"] = self.secrets
+        return d
+
+
+@dataclass
+class PromptConfig:
+    """Prompt configuration for an agent."""
+
+    system: str
+
+    def to_dict(self) -> dict:
+        """Serialize to a dict suitable for YAML output."""
+        return {"system": self.system}