@bluefly/openstandardagents 0.3.5 → 0.4.0

package/examples/migrations/swarm-to-ossa/before-triage-agent.py

@@ -0,0 +1,234 @@
+"""
+OpenAI Swarm: Customer Service Triage Agent
+
+This is a typical OpenAI Swarm implementation of a customer service triage system.
+The triage agent routes customer requests to specialized agents (sales or refunds).
+
+Swarm Documentation: https://github.com/openai/swarm
+"""
+
+from swarm import Swarm, Agent
+from typing import Dict, Any
+
+# Initialize Swarm client
+client = Swarm()
+
+# ============================================================================
+# Transfer Functions (Swarm's handoff mechanism)
+# ============================================================================
+
+def transfer_to_sales_agent():
+    """Transfer conversation to the sales agent."""
+    return sales_agent
+
+
+def transfer_to_refunds_agent():
+    """Transfer conversation to the refunds agent."""
+    return refunds_agent
+
+
+# ============================================================================
+# Agent Functions (Tools/Capabilities)
+# ============================================================================
+
+def execute_order(product_id: str, quantity: int = 1) -> str:
+    """
+    Execute a product order.
+
+    Args:
+        product_id: The product identifier
+        quantity: Number of items to order (default: 1)
+
+    Returns:
+        Order confirmation message
+    """
+    # Simulated order processing
+    total_price = quantity * 99.99  # Simplified pricing
+    return f"Order confirmed! {quantity}x {product_id} for ${total_price:.2f}"
+
+
+def process_refund(item_id: str, reason: str) -> str:
+    """
+    Process a refund request.
+
+    Args:
+        item_id: The item identifier to refund
+        reason: Reason for the refund
+
+    Returns:
+        Refund confirmation message
+    """
+    # Simulated refund processing
+    return f"Refund processed for item {item_id}. Reason: {reason}. Refund ID: REF-{item_id}-001"
+
+
+# ============================================================================
+# Agent Definitions
+# ============================================================================
+
+# Triage Agent - Entry point, routes to specialized agents
+triage_agent = Agent(
+    name="Customer Service Triage Agent",
+    instructions="""You are a friendly customer service triage agent.
+
+Your role is to:
+1. Greet customers warmly
+2. Understand their request or issue
+3. Route them to the appropriate specialist:
+   - Sales Agent: For product inquiries, purchases, or general questions
+   - Refunds Agent: For returns, refunds, or order issues
+
+Be concise and efficient in your routing.""",
+    functions=[transfer_to_sales_agent, transfer_to_refunds_agent]
+)
+
+# Sales Agent - Handles purchases and product questions
+sales_agent = Agent(
+    name="Sales Agent",
+    instructions="""You are a knowledgeable sales agent.
+
+Your role is to:
+1. Answer product questions
+2. Help customers make purchases
+3. Provide recommendations
+4. Execute orders when customers are ready
+
+Be helpful and enthusiastic about our products!""",
+    functions=[execute_order, transfer_to_refunds_agent]
+)
+
+# Refunds Agent - Handles returns and refunds
+refunds_agent = Agent(
+    name="Refunds Agent",
+    instructions="""You are an empathetic refunds specialist.
+
+Your role is to:
+1. Listen to customer concerns
+2. Process refund requests
+3. Explain refund policies clearly
+4. Resolve issues with care
+
+Be understanding and process refunds quickly.""",
+    functions=[process_refund, transfer_to_sales_agent]
+)
+
+
+# ============================================================================
+# Usage Examples
+# ============================================================================
+
+def run_customer_service_example():
+    """Run example customer service conversations."""
+
+    # Example 1: Customer wants to make a purchase
+    print("=" * 80)
+    print("Example 1: Sales Inquiry")
+    print("=" * 80)
+
+    messages = [{"role": "user", "content": "I want to buy your premium widget"}]
+    response = client.run(
+        agent=triage_agent,
+        messages=messages,
+        context_variables={"user_id": "USER123", "account_type": "premium"}
+    )
+
+    print(f"Agent: {response.agent.name}")
+    print(f"Response: {response.messages[-1]['content']}")
+
+    # Example 2: Customer wants a refund
+    print("\n" + "=" * 80)
+    print("Example 2: Refund Request")
+    print("=" * 80)
+
+    messages = [{"role": "user", "content": "I need a refund for order #12345"}]
+    response = client.run(
+        agent=triage_agent,
+        messages=messages,
+        context_variables={"user_id": "USER456", "account_type": "standard"}
+    )
+
+    print(f"Agent: {response.agent.name}")
+    print(f"Response: {response.messages[-1]['content']}")
+
+    # Example 3: Multi-turn conversation with handoffs
+    print("\n" + "=" * 80)
+    print("Example 3: Multi-turn Conversation")
+    print("=" * 80)
+
+    messages = [
+        {"role": "user", "content": "Hi, I have a question about your products"}
+    ]
+    response = client.run(
+        agent=triage_agent,
+        messages=messages
+    )
+    print(f"Agent: {response.agent.name}")
+    print(f"Response: {response.messages[-1]['content']}")
+
+    # Continue conversation
+    messages.append(response.messages[-1])
+    messages.append({"role": "user", "content": "Actually, I want to order 3 premium widgets"})
+    response = client.run(
+        agent=response.agent,  # Continue with current agent
+        messages=messages
+    )
+    print(f"Agent: {response.agent.name}")
+    print(f"Response: {response.messages[-1]['content']}")
+
+
+def run_streaming_example():
+    """Example with streaming responses."""
+    print("\n" + "=" * 80)
+    print("Example 4: Streaming Response")
+    print("=" * 80)
+
+    messages = [{"role": "user", "content": "Tell me about your products"}]
+
+    stream = client.run(
+        agent=triage_agent,
+        messages=messages,
+        stream=True
+    )
+
+    print("Streaming response: ", end="", flush=True)
+    for chunk in stream:
+        if "content" in chunk:
+            print(chunk["content"], end="", flush=True)
+    print()
+
+
+# ============================================================================
+# Key Swarm Limitations Demonstrated Here
+# ============================================================================
+
+# 1. PYTHON ONLY: This code only runs in Python, can't deploy to other runtimes
+# 2. NO DECLARATIVE CONFIG: Agent logic mixed with code, hard to version control
+# 3. NO OBSERVABILITY: No built-in metrics, tracing, or monitoring
+# 4. NO AUTHENTICATION: Must manually handle auth and permissions
+# 5. NO RATE LIMITING: No built-in cost controls or rate limits
+# 6. EXPERIMENTAL: Not production-ready according to OpenAI
+# 7. MANUAL TESTING: No built-in testing framework
+# 8. NO GOVERNANCE: No compliance, audit, or policy enforcement
+
+# See after-triage-agent.ossa.yaml for OSSA equivalent with all these features!
+
+
+if __name__ == "__main__":
+    print("OpenAI Swarm - Customer Service Triage Example")
+    print("=" * 80)
+    print()
+
+    # Run examples
+    run_customer_service_example()
+    run_streaming_example()
+
+    print("\n" + "=" * 80)
+    print("Migration to OSSA")
+    print("=" * 80)
+    print("See after-triage-agent.ossa.yaml for the OSSA equivalent.")
+    print("OSSA provides:")
+    print("  ✓ Declarative YAML configuration")
+    print("  ✓ Deploy to any platform (Anthropic, OpenAI, LangChain, etc.)")
+    print("  ✓ Built-in observability, auth, rate limiting")
+    print("  ✓ Production-ready with governance and compliance")
+    print("  ✓ 50% less code, 100% more features")

package/examples/multi-agent/conditional-router.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: conditional-router

package/examples/multi-agent/parallel-execution.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: parallel-executor

package/examples/multi-agent/sequential-pipeline.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: sequential-pipeline

package/examples/multi-platform/single-manifest/README.md

@@ -0,0 +1,72 @@
+# Multi-Platform Deployment Example
+
+This example demonstrates deploying a single OSSA manifest to multiple platforms.
+
+## Agent Manifest
+
+See `agent.ossa.yaml` for the complete OSSA manifest.
+
+## Build for All Platforms
+
+```bash
+ossa build agent.ossa.yaml --platform all --output dist/build
+```
+
+This generates:
+- `dist/build/kagent/agent-crd.yaml` - kagent.dev CRD
+- `dist/build/langchain/agent.py` - LangChain Python code
+- `dist/build/crewai/agent.py` - CrewAI Python code
+- `dist/build/temporal/agent-workflow.ts` - Temporal TypeScript
+- `dist/build/n8n/agent-workflow.json` - n8n workflow
+- `dist/build/gitlab/.gitlab-ci.yml` - GitLab CI config
+- `dist/build/docker/Dockerfile` - Dockerfile
+- `dist/build/kubernetes/` - K8s manifests
+
+## Deploy to Each Platform
+
+### kagent.dev
+```bash
+ossa deploy agent.ossa.yaml --platform kagent --namespace production
+```
+
+### LangChain
+```bash
+cd dist/build/langchain
+pip install langchain langchain-openai
+python agent.py
+```
+
+### CrewAI
+```bash
+cd dist/build/crewai
+pip install crewai
+python agent.py
+```
+
+### Docker
+```bash
+cd dist/build/docker
+docker build -t agent .
+docker run agent
+```
+
+### Kubernetes
+```bash
+cd dist/build/kubernetes
+kubectl apply -f deployment.yaml
+kubectl apply -f service.yaml
+kubectl apply -f configmap.yaml
+```
+
+## Comparison Matrix
+
+| Platform | Language | Deployment | Best For |
+|----------|----------|------------|----------|
+| kagent.dev | YAML | Kubernetes | Production K8s |
+| LangChain | Python | Local/Cloud | Python ecosystems |
+| CrewAI | Python | Local/Cloud | Multi-agent teams |
+| Temporal | TypeScript | Cloud | Long-running workflows |
+| n8n | JSON | Self-hosted | Visual workflows |
+| GitLab CI | YAML | GitLab | CI/CD automation |
+| Docker | Dockerfile | Any | Containerized deployment |
+| Kubernetes | YAML | K8s clusters | Production orchestration |

package/examples/multi-platform/single-manifest/agent.ossa.yaml

@@ -0,0 +1,32 @@
+apiVersion: ossa/v0.3.6
+kind: Agent
+metadata:
+  name: multi-platform-demo
+  description: "Demo agent that can be deployed to multiple platforms"
+  version: "1.0.0"
+spec:
+  role: "You are a helpful assistant that can answer questions and perform tasks across multiple platforms."
+  llm:
+    provider: openai
+    model: gpt-4
+    temperature: 0.7
+    maxTokens: 2000
+  taxonomy:
+    domain: agents
+    subdomain: orchestration
+  tools:
+    - type: mcp
+      name: filesystem
+      server: filesystem-server
+  constraints:
+    cost:
+      maxTokensPerDay: 100000
+      maxCostPerDay: 50
+      currency: USD
+    performance:
+      maxLatencySeconds: 30
+      timeoutSeconds: 60
+  runtime:
+    type: node
+    image: node:20-alpine
+    command: ["node", "dist/index.js"]

package/examples/observability/activity-stream-full.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: activity-tracked-agent

package/examples/openai/basic-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: basic-openai-agent

package/examples/ossa-templates/11-react-performance-expert.ossa.yaml

@@ -7,7 +7,7 @@ metadata:
     React Performance Expert implementing 40+ Vercel best practices for optimal React application performance.
     Auto-activates on performance-related queries, React/Next.js files, and performance keywords.
   labels:
-    ossa-version: v0.3.5
+    ossa-version: v0.3.6
     domain: frontend
     category: performance
     tier: expert

package/examples/ossa-templates/12-typescript-type-safety-expert.ossa.yaml

@@ -5,7 +5,7 @@ metadata:
   version: 1.0.0
   description: TypeScript Type Safety Expert - Eliminates any types, enforces strict null checks, ensures type safety
   labels:
-    ossa-version: v0.3.5
+    ossa-version: v0.3.6
     domain: typescript
     category: type-safety
     tier: worker

package/examples/ossa-templates/13-accessibility-champion.ossa.yaml

@@ -5,7 +5,7 @@ metadata:
   version: 1.0.0
   description: Accessibility Champion - WCAG 2.1 AA compliance, ARIA best practices, keyboard navigation
   labels:
-    ossa-version: v0.3.5
+    ossa-version: v0.3.6
     domain: accessibility
     category: a11y
     tier: worker

package/examples/ossa-templates/14-security-hardening-agent.ossa.yaml

@@ -5,7 +5,7 @@ metadata:
   version: 1.0.0
   description: Security Hardening Agent - OWASP Top 10 prevention, vulnerability scanning, secure coding practices
   labels:
-    ossa-version: v0.3.5
+    ossa-version: v0.3.6
     domain: security
     category: hardening
     tier: worker

package/examples/quickstart/support-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: support-agent

package/examples/real-world/gitlab-cicd-optimizer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: gitlab-cicd-optimizer

package/examples/real-world/rag-documentation-assistant.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: rag-documentation-assistant

package/examples/registry/agents/code-reviewer/agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: code-reviewer

package/examples/registry/agents/security-scanner/agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: security-scanner

package/examples/runtime-adapters/bedrock-claude-example.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: bedrock-assistant

package/examples/schema/reusable-components.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: component-showcase

package/examples/showcase/ci-pipeline.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: ci-pipeline

package/examples/showcase/code-assistant.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: code-assistant

package/examples/showcase/code-reviewer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: code-reviewer

package/examples/showcase/compliance-validator.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: compliance-validator

package/examples/showcase/content-writer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: content-writer

package/examples/showcase/data-transformer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Task
 metadata:
   name: data-transformer

package/examples/showcase/doc-generator.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: doc-generator

package/examples/showcase/security-scanner.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: security-scanner

package/examples/showcase/test-generator.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Agent
 metadata:
   name: test-generator

package/examples/showcase/workflow-orchestrator.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.3.6
 kind: Workflow
 metadata:
   name: workflow-orchestrator