pyagent-studio 0.2.3__tar.gz → 0.2.4__tar.gz

pyagent_studio-0.2.3/README.md → pyagent_studio-0.2.4/PKG-INFO

@@ -1,10 +1,52 @@
+Metadata-Version: 2.4
+Name: pyagent-studio
+Version: 0.2.4
+Summary: Kubernetes Dashboard for Agent Systems — CLI + web control plane for multi-agent LLM blueprints
+Project-URL: Homepage, https://pyagent.org
+Project-URL: Repository, https://github.com/pyagent-core/pyagent
+Project-URL: Documentation, https://pyagent.org
+Project-URL: Agent Orchestration Patterns, https://pyagent.org/patterns/orchestrator-worker/
+Project-URL: Agent Harness Architecture, https://pyagent.org/architecture/multi-agent-harness/
+Project-URL: Agent Experience Optimization, https://pyagent.org/concepts/agent-experience-optimization/
+Author-email: PyAgent Team <team@pyagent.org>
+License: MIT
+Keywords: LLM,agent control plane,agent harness,agents,dashboard,fastapi,litellm,multi-agent observability,studio,workbench
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: fastapi>=0.115
+Requires-Dist: jinja2>=3.1
+Requires-Dist: litellm>=1.40
+Requires-Dist: pyagent-blueprint>=0.1.0
+Requires-Dist: pyagent-providers>=0.1.0
+Requires-Dist: pyagent-trace>=0.1.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: rich>=13.0
+Requires-Dist: uvicorn>=0.30
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
 # pyagent-studio
 
-**The Kubernetes Dashboard for Agent Systems** — CLI + web control plane for designing, simulating, debugging, and governing multi-agent LLM blueprints.
+**Pillar 4 of the PyAgent production stack for multi-agent LLM systems** — CLI + web control plane for designing, simulating, debugging, and governing agent systems.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 
+> **Architecture Pillar: 📊 Observability**
+> The control plane of the Observability pillar — a `kubectl`-style CLI and FastAPI web dashboard for simulating workflows, exploring recorded traces, diffing blueprint versions, and monitoring provider health and costs.
+> Part of the full stack: install `pyagent-all` for all pillars.
+
 ## Install
 
 ```bash
@@ -283,6 +325,41 @@ Studio integrates with every PyAgent package:
 | Live trace streaming (SSE) | ✓ | ✗ | ✗ | ✗ |
 | Governance & compliance | ✓ | ✗ | ✗ | ✗ |
 
+## Other packages in this pillar
+
+- `pyagent-trace` — TraceEventBus, OTel spans, cost tracking, record/replay
+
+## Full stack
+
+Install all pillars at once: `pip install pyagent-all`
+
+→ [pyagent.org](https://pyagent.org) for full documentation.
+
 ## Full Documentation
 
 See [pyagent.org](https://pyagent.org) for full API reference and integration guides.
+
+<!-- pyagent-ecosystem-footer:start -->
+
+## The PyAgent ecosystem
+
+PyAgent is a production stack for multi-agent LLM systems. Each package is independent — install
+only what you need, or get everything with [`pip install pyagent-all`](https://pyagent.org/getting-started/).
+
+| Package | What it gives you |
+|---------|-------------------|
+| `pyagent-blueprint` | [Declarative multi-agent blueprints](https://pyagent.org/guides/blueprint/) — compile, validate, and diff agent systems from YAML |
+| `pyagent-patterns` | [Reusable multi-agent design patterns](https://pyagent.org/packages/patterns/) — Supervisor, Pipeline, ReAct, and 15 more |
+| `pyagent-router` | [Difficulty-aware model routing](https://pyagent.org/guides/router/) — cost-efficient model selection per task |
+| `pyagent-compress` | [Token-efficient agent compression](https://pyagent.org/guides/compression/) — inter-agent token budgets |
+| `pyagent-providers` | [Multi-provider orchestration](https://pyagent.org/guides/providers/) — fallback chains and capability negotiation |
+| `pyagent-context` | [Stateful agent memory](https://pyagent.org/guides/context/) — trust-aware, three-tier context ledger |
+| `pyagent-trace` | [Multi-agent observability & tracing](https://pyagent.org/guides/tracing/) — pattern-aware OpenTelemetry spans |
+| `pyagent-studio` | [Agent control plane dashboard](https://pyagent.org/guides/studio/) — live traces, cost, and governance |
+
+**Learn the concepts:**
+[The Orchestrator-Worker pattern](https://pyagent.org/patterns/orchestrator-worker/) ·
+[Engineering a resilient multi-agent harness](https://pyagent.org/architecture/multi-agent-harness/) ·
+[Agent Experience Optimization (AXO)](https://pyagent.org/concepts/agent-experience-optimization/)
+
+<!-- pyagent-ecosystem-footer:end -->

pyagent_studio-0.2.3/PKG-INFO → pyagent_studio-0.2.4/README.md

@@ -1,44 +1,14 @@
-Metadata-Version: 2.4
-Name: pyagent-studio
-Version: 0.2.3
-Summary: Kubernetes Dashboard for Agent Systems — CLI + web control plane for multi-agent LLM blueprints
-Project-URL: Homepage, https://pyagent.org
-Project-URL: Repository, https://github.com/pyagent-core/pyagent
-Project-URL: Documentation, https://pyagent.org
-Author-email: PyAgent Team <team@pyagent.org>
-License: MIT
-Keywords: LLM,agents,dashboard,fastapi,litellm,studio,workbench
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-Requires-Dist: click>=8.1
-Requires-Dist: fastapi>=0.115
-Requires-Dist: jinja2>=3.1
-Requires-Dist: litellm>=1.40
-Requires-Dist: pyagent-blueprint>=0.1.0
-Requires-Dist: pyagent-providers>=0.1.0
-Requires-Dist: pyagent-trace>=0.1.0
-Requires-Dist: rich>=13.0
-Requires-Dist: uvicorn>=0.30
-Provides-Extra: dev
-Requires-Dist: httpx>=0.27; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
-Requires-Dist: pytest>=8.0; extra == 'dev'
-Description-Content-Type: text/markdown
-
 # pyagent-studio
 
-**The Kubernetes Dashboard for Agent Systems** — CLI + web control plane for designing, simulating, debugging, and governing multi-agent LLM blueprints.
+**Pillar 4 of the PyAgent production stack for multi-agent LLM systems** — CLI + web control plane for designing, simulating, debugging, and governing agent systems.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 
+> **Architecture Pillar: 📊 Observability**
+> The control plane of the Observability pillar — a `kubectl`-style CLI and FastAPI web dashboard for simulating workflows, exploring recorded traces, diffing blueprint versions, and monitoring provider health and costs.
+> Part of the full stack: install `pyagent-all` for all pillars.
+
 ## Install
 
 ```bash
@@ -317,6 +287,41 @@ Studio integrates with every PyAgent package:
 | Live trace streaming (SSE) | ✓ | ✗ | ✗ | ✗ |
 | Governance & compliance | ✓ | ✗ | ✗ | ✗ |
 
+## Other packages in this pillar
+
+- `pyagent-trace` — TraceEventBus, OTel spans, cost tracking, record/replay
+
+## Full stack
+
+Install all pillars at once: `pip install pyagent-all`
+
+→ [pyagent.org](https://pyagent.org) for full documentation.
+
 ## Full Documentation
 
 See [pyagent.org](https://pyagent.org) for full API reference and integration guides.
+
+<!-- pyagent-ecosystem-footer:start -->
+
+## The PyAgent ecosystem
+
+PyAgent is a production stack for multi-agent LLM systems. Each package is independent — install
+only what you need, or get everything with [`pip install pyagent-all`](https://pyagent.org/getting-started/).
+
+| Package | What it gives you |
+|---------|-------------------|
+| `pyagent-blueprint` | [Declarative multi-agent blueprints](https://pyagent.org/guides/blueprint/) — compile, validate, and diff agent systems from YAML |
+| `pyagent-patterns` | [Reusable multi-agent design patterns](https://pyagent.org/packages/patterns/) — Supervisor, Pipeline, ReAct, and 15 more |
+| `pyagent-router` | [Difficulty-aware model routing](https://pyagent.org/guides/router/) — cost-efficient model selection per task |
+| `pyagent-compress` | [Token-efficient agent compression](https://pyagent.org/guides/compression/) — inter-agent token budgets |
+| `pyagent-providers` | [Multi-provider orchestration](https://pyagent.org/guides/providers/) — fallback chains and capability negotiation |
+| `pyagent-context` | [Stateful agent memory](https://pyagent.org/guides/context/) — trust-aware, three-tier context ledger |
+| `pyagent-trace` | [Multi-agent observability & tracing](https://pyagent.org/guides/tracing/) — pattern-aware OpenTelemetry spans |
+| `pyagent-studio` | [Agent control plane dashboard](https://pyagent.org/guides/studio/) — live traces, cost, and governance |
+
+**Learn the concepts:**
+[The Orchestrator-Worker pattern](https://pyagent.org/patterns/orchestrator-worker/) ·
+[Engineering a resilient multi-agent harness](https://pyagent.org/architecture/multi-agent-harness/) ·
+[Agent Experience Optimization (AXO)](https://pyagent.org/concepts/agent-experience-optimization/)
+
+<!-- pyagent-ecosystem-footer:end -->

{pyagent_studio-0.2.3 → pyagent_studio-0.2.4}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pyagent-studio"
-version = "0.2.3"
+version = "0.2.4"
 description = "Kubernetes Dashboard for Agent Systems — CLI + web control plane for multi-agent LLM blueprints"
 readme = "README.md"
 requires-python = ">=3.11"
 license = {text = "MIT"}
 authors = [{name = "PyAgent Team", email = "team@pyagent.org"}]
-keywords = ["agents", "studio", "LLM", "workbench", "dashboard", "fastapi", "litellm"]
+keywords = ["agents", "studio", "LLM", "workbench", "dashboard", "fastapi", "litellm", "multi-agent observability", "agent control plane", "agent harness"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
@@ -31,12 +31,16 @@ dependencies = [
     "fastapi>=0.115",
     "uvicorn>=0.30",
     "jinja2>=3.1",
+    "python-multipart>=0.0.9",
 ]
 
 [project.urls]
 Homepage = "https://pyagent.org"
 Repository = "https://github.com/pyagent-core/pyagent"
 Documentation = "https://pyagent.org"
+"Agent Orchestration Patterns" = "https://pyagent.org/patterns/orchestrator-worker/"
+"Agent Harness Architecture" = "https://pyagent.org/architecture/multi-agent-harness/"
+"Agent Experience Optimization" = "https://pyagent.org/concepts/agent-experience-optimization/"
 
 [project.optional-dependencies]
 dev = ["pytest>=8.0", "pytest-asyncio>=0.23", "httpx>=0.27"]

{pyagent_studio-0.2.3 → pyagent_studio-0.2.4}/src/pyagent_studio/cli.py

@@ -266,7 +266,21 @@ def describe(file: str) -> None:
 @main.command()
 @click.option("--port", default=8420, type=int, help="Web dashboard port.")
 @click.option("--host", default="127.0.0.1", help="Web dashboard host.")
-def dashboard(port: int, host: str) -> None:
+@click.option(
+    "--trace",
+    "trace_path",
+    type=click.Path(exists=True),
+    default=None,
+    help="Path to a recorded trace JSONL file to load on the Overview dashboard.",
+)
+@click.option(
+    "--blueprint",
+    "blueprint_path",
+    type=click.Path(exists=True),
+    default=None,
+    help="Path to a blueprint YAML to load for the resource tabs (defaults to a bundled sample).",
+)
+def dashboard(port: int, host: str, trace_path: str | None, blueprint_path: str | None) -> None:
     """Launch the web dashboard."""
     try:
         import uvicorn
@@ -277,8 +291,15 @@ def dashboard(port: int, host: str) -> None:
         )
         sys.exit(1)
 
+    from pyagent_studio.web.app import create_app
+
     click.echo(f"Starting dashboard at http://{host}:{port}")
-    uvicorn.run("pyagent_studio.web.app:create_app", host=host, port=port, factory=True)
+    if trace_path:
+        click.echo(f"Loading trace: {trace_path}")
+    if blueprint_path:
+        click.echo(f"Loading blueprint: {blueprint_path}")
+    app = create_app(trace_path=trace_path, blueprint_path=blueprint_path)
+    uvicorn.run(app, host=host, port=port)
 
 
 if __name__ == "__main__":

pyagent_studio-0.2.4/src/pyagent_studio/data/sample_blueprint.yaml

@@ -0,0 +1,73 @@
+api_version: pyagent/v1
+metadata:
+  name: customer-support
+  version: 1.2.0
+  description: Production customer-support routing with billing, classification, and policy checks
+  owner: platform-team
+  tags: [support, production]
+providers:
+  primary:
+    provider: anthropic
+    model: claude-3-5-sonnet
+  classifier_provider:
+    provider: openai
+    model: gpt-4o-mini
+  fallback:
+    provider: openai
+    model: gpt-4o
+agents:
+  classifier:
+    prompt: "Classify incoming requests into: billing, technical, or general."
+    provider: classifier_provider
+    description: Routes customer requests to the right specialist
+    guardrails: [pii_redact]
+  billing:
+    prompt: "Resolve billing inquiries, refunds, and invoice questions."
+    provider: primary
+    description: Billing specialist agent
+    tools: [lookup_invoice, issue_refund]
+    guardrails: [pii_redact, cost_cap]
+  technical:
+    prompt: "Handle technical support and troubleshooting."
+    provider: primary
+    description: Technical support agent
+    tools: [search_kb]
+  policy_checker:
+    prompt: "Verify that responses comply with company policy."
+    provider: classifier_provider
+    description: Policy and compliance gate
+    guardrails: [policy_enforce]
+workflows:
+  customer-support:
+    pattern: supervisor
+    agents:
+      classifier: classifier
+      routes:
+        billing: billing
+        technical: technical
+    recovery:
+      max_retries: 2
+      timeout_seconds: 30
+      fallback_provider: fallback
+  refund-processor:
+    pattern: pipeline
+    agents:
+      stages:
+        billing: billing
+        policy_checker: policy_checker
+contracts:
+  customer-support:
+    input:
+      type: string
+      max_tokens: 2000
+    output:
+      type: string
+    sla:
+      latency_p95_ms: 5000
+      cost_max_usd: 0.05
+observability:
+  tracing:
+    enabled: true
+  cost_budget:
+    daily_usd: 100.0
+    alert_threshold: 0.8

{pyagent_studio-0.2.3 → pyagent_studio-0.2.4}/src/pyagent_studio/services/__init__.py

@@ -2,12 +2,14 @@
 
 from pyagent_studio.services.blueprint_service import BlueprintService
 from pyagent_studio.services.governance_service import GovernanceService
+from pyagent_studio.services.runs_service import RunsService
 from pyagent_studio.services.simulation_service import SimulationService
 from pyagent_studio.services.trace_service import TraceService
 
 __all__ = [
     "BlueprintService",
     "GovernanceService",
+    "RunsService",
     "SimulationService",
     "TraceService",
 ]