@bluefly/openstandardagents 0.3.6 → 0.4.1

package/examples/agents/01-customer-support-bot/agent.ossa.yaml

@@ -0,0 +1,172 @@
+apiVersion: ossa/v0.4.1
+kind: Agent
+metadata:
+  name: customer-support-bot
+  version: 1.0.0
+  description: |
+    Production customer support agent with memory, multi-channel support, and ticket creation.
+    Handles customer inquiries, searches documentation, creates tickets, and sends follow-up emails.
+  labels:
+    platform: langchain
+    export: langchain
+    use-case: customer-support
+    tier: production
+spec:
+  role: |
+    You are a professional customer support agent for TechCorp. Your responsibilities:
+
+    1. Answer customer questions accurately and professionally
+    2. Search documentation to provide accurate technical information
+    3. Create support tickets for issues requiring human intervention
+    4. Send follow-up emails to keep customers informed
+    5. Maintain conversation context to provide personalized support
+
+    Communication style:
+    - Professional, friendly, and empathetic
+    - Clear and concise explanations
+    - Proactive in offering solutions
+    - Transparent about limitations
+
+  llm:
+    provider: openai
+    model: gpt-4o
+    temperature: 0.7
+    maxTokens: 1500
+
+  capabilities:
+    - search_documentation
+    - create_ticket
+    - send_email
+    - conversation_memory
+
+  tools:
+    - type: function
+      name: search_docs
+      description: Search the knowledge base for relevant documentation
+      parameters:
+        type: object
+        properties:
+          query:
+            type: string
+            description: Search query for documentation
+          max_results:
+            type: integer
+            description: Maximum number of results to return
+            default: 5
+        required:
+          - query
+
+    - type: function
+      name: create_ticket
+      description: Create a support ticket for issues requiring human attention
+      parameters:
+        type: object
+        properties:
+          title:
+            type: string
+            description: Brief title of the issue
+          description:
+            type: string
+            description: Detailed description of the issue
+          priority:
+            type: string
+            enum: [low, medium, high, urgent]
+            description: Priority level of the ticket
+          category:
+            type: string
+            description: Category (billing, technical, account, etc.)
+        required:
+          - title
+          - description
+          - priority
+
+    - type: function
+      name: send_email
+      description: Send follow-up email to customer
+      parameters:
+        type: object
+        properties:
+          to:
+            type: string
+            description: Customer email address
+          subject:
+            type: string
+            description: Email subject line
+          body:
+            type: string
+            description: Email body content
+          template:
+            type: string
+            description: Email template to use
+            enum: [follow_up, resolution, escalation]
+        required:
+          - to
+          - subject
+          - body
+
+  autonomy:
+    level: supervised
+    approval_required: false
+    escalation_rules:
+      - condition: priority == 'urgent'
+        action: notify_human
+      - condition: ticket_count > 3
+        action: escalate
+
+  memory:
+    enabled: true
+    type: conversation_buffer
+    window_size: 10
+    persistence:
+      enabled: true
+      backend: redis
+      ttl: 86400
+
+  safety:
+    input_filters:
+      - type: pii_detection
+        action: redact
+      - type: profanity_filter
+        action: reject
+    output_validation:
+      - type: hallucination_check
+        threshold: 0.8
+      - type: tone_analysis
+        required_sentiment: [positive, neutral]
+
+  observability:
+    logging:
+      level: info
+      format: json
+      include_pii: false
+    metrics:
+      enabled: true
+      port: 9090
+      metrics:
+        - conversations_total
+        - tickets_created
+        - emails_sent
+        - response_time
+    tracing:
+      enabled: true
+      provider: opentelemetry
+
+extensions:
+  langchain:
+    agent_type: react
+    memory_type: conversation_buffer
+    chain_type: conversation
+    tools_mapping:
+      - ossa_capability: search_documentation
+        langchain_tool: search_docs
+        tool_class: CustomSearchTool
+      - ossa_capability: create_ticket
+        langchain_tool: create_ticket
+        tool_class: TicketingTool
+      - ossa_capability: send_email
+        langchain_tool: send_email
+        tool_class: EmailTool
+    export_config:
+      format: python
+      include_dependencies: true
+      output_file: customer_support_agent.py

package/examples/agents/01-customer-support-bot/docker-compose.yml

@@ -0,0 +1,55 @@
+version: '3.8'
+
+services:
+  customer-support-bot:
+    build: .
+    container_name: customer-support-bot
+    ports:
+      - "8080:8080"
+      - "9090:9090"  # Metrics
+    environment:
+      - NODE_ENV=production
+      - OPENAI_API_KEY=${OPENAI_API_KEY}
+      - REDIS_URL=redis://redis:6379
+      - LOG_LEVEL=info
+      - METRICS_ENABLED=true
+    depends_on:
+      - redis
+    restart: unless-stopped
+    networks:
+      - support-network
+    volumes:
+      - ./logs:/app/logs
+
+  redis:
+    image: redis:7-alpine
+    container_name: support-redis
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis-data:/data
+    restart: unless-stopped
+    networks:
+      - support-network
+
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: support-prometheus
+    ports:
+      - "9091:9090"
+    volumes:
+      - ./prometheus.yml:/etc/prometheus/prometheus.yml
+      - prometheus-data:/prometheus
+    command:
+      - '--config.file=/etc/prometheus/prometheus.yml'
+    restart: unless-stopped
+    networks:
+      - support-network
+
+networks:
+  support-network:
+    driver: bridge
+
+volumes:
+  redis-data:
+  prometheus-data:

package/examples/agents/01-customer-support-bot/openapi.yaml

@@ -0,0 +1,238 @@
+openapi: 3.1.0
+info:
+  title: Customer Support Bot API
+  version: 1.0.0
+  description: Production customer support agent API with conversation memory and ticket management
+  contact:
+    name: TechCorp Support
+    email: support@techcorp.com
+
+servers:
+  - url: http://localhost:8080
+    description: Local development
+  - url: https://support-bot.techcorp.com
+    description: Production
+
+paths:
+  /v1/chat:
+    post:
+      summary: Send message to support bot
+      operationId: sendMessage
+      tags:
+        - Chat
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ChatRequest'
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ChatResponse'
+        '400':
+          description: Invalid request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+
+  /v1/session/{sessionId}/history:
+    get:
+      summary: Get conversation history
+      operationId: getHistory
+      tags:
+        - Session
+      parameters:
+        - name: sessionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Conversation history
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ConversationHistory'
+
+  /v1/tickets:
+    post:
+      summary: Create support ticket
+      operationId: createTicket
+      tags:
+        - Tickets
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TicketRequest'
+      responses:
+        '201':
+          description: Ticket created
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TicketResponse'
+
+  /v1/health:
+    get:
+      summary: Health check
+      operationId: healthCheck
+      tags:
+        - System
+      responses:
+        '200':
+          description: Service healthy
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HealthStatus'
+
+components:
+  schemas:
+    ChatRequest:
+      type: object
+      required:
+        - message
+      properties:
+        message:
+          type: string
+          description: User message
+          example: "How do I reset my password?"
+        sessionId:
+          type: string
+          description: Session ID for conversation continuity
+          example: "sess_abc123"
+        userId:
+          type: string
+          description: User identifier
+          example: "user_xyz789"
+        metadata:
+          type: object
+          description: Additional context
+          properties:
+            channel:
+              type: string
+              example: "web"
+            userAgent:
+              type: string
+
+    ChatResponse:
+      type: object
+      properties:
+        message:
+          type: string
+          description: Agent response
+          example: "To reset your password, go to Settings > Security..."
+        sessionId:
+          type: string
+          example: "sess_abc123"
+        actions:
+          type: array
+          items:
+            $ref: '#/components/schemas/Action'
+        metadata:
+          type: object
+          properties:
+            tokensUsed:
+              type: integer
+            responseTime:
+              type: number
+            confidence:
+              type: number
+
+    Action:
+      type: object
+      properties:
+        type:
+          type: string
+          enum: [ticket_created, email_sent, doc_searched]
+        data:
+          type: object
+
+    ConversationHistory:
+      type: object
+      properties:
+        sessionId:
+          type: string
+        messages:
+          type: array
+          items:
+            $ref: '#/components/schemas/Message'
+
+    Message:
+      type: object
+      properties:
+        role:
+          type: string
+          enum: [user, assistant]
+        content:
+          type: string
+        timestamp:
+          type: string
+          format: date-time
+
+    TicketRequest:
+      type: object
+      required:
+        - title
+        - description
+        - priority
+      properties:
+        title:
+          type: string
+          example: "Login issue"
+        description:
+          type: string
+          example: "Unable to login after password reset"
+        priority:
+          type: string
+          enum: [low, medium, high, urgent]
+        category:
+          type: string
+          example: "technical"
+
+    TicketResponse:
+      type: object
+      properties:
+        ticketId:
+          type: string
+          example: "TKT-12345"
+        status:
+          type: string
+          enum: [open, in_progress, resolved, closed]
+        createdAt:
+          type: string
+          format: date-time
+
+    HealthStatus:
+      type: object
+      properties:
+        status:
+          type: string
+          enum: [healthy, degraded, unhealthy]
+        uptime:
+          type: number
+        dependencies:
+          type: object
+          properties:
+            redis:
+              type: string
+            openai:
+              type: string
+
+    Error:
+      type: object
+      properties:
+        error:
+          type: string
+        message:
+          type: string
+        code:
+          type: string

package/examples/agents/01-customer-support-bot/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@company/customer-support-bot",
+  "version": "1.0.0",
+  "description": "Production customer support agent built with OSSA and LangChain",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "jest",
+    "test:integration": "jest --testPathPattern=integration",
+    "validate": "ossa validate agent.ossa.yaml",
+    "export:langchain": "ossa export agent.ossa.yaml --platform langchain --output exports/",
+    "docker:build": "docker build -t customer-support-bot .",
+    "docker:run": "docker-compose up -d"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.71.0",
+    "express": "^4.18.2",
+    "langchain": "^0.3.0",
+    "@langchain/openai": "^0.3.0",
+    "@langchain/community": "^0.3.0",
+    "openai": "^6.9.1",
+    "redis": "^4.6.0",
+    "zod": "^4.1.11",
+    "prom-client": "^15.1.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-node": "^0.54.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.19.19",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "jest": "^29.7.0",
+    "@types/jest": "^29.5.14"
+  },
+  "keywords": [
+    "ossa",
+    "agent",
+    "customer-support",
+    "langchain",
+    "chatbot"
+  ],
+  "author": "Your Company",
+  "license": "Apache-2.0"
+}

package/examples/agents/02-code-review-agent/README.md

@@ -0,0 +1,72 @@
+# Code Review Agent
+
+Automated code review agent powered by Anthropic Claude with advanced code analysis capabilities.
+
+## Features
+
+- Automated PR/MR review
+- Security vulnerability detection
+- Performance analysis
+- Code quality scoring
+- Actionable fix suggestions
+- Multi-language support
+
+## Quick Start
+
+```bash
+# Set API key
+export ANTHROPIC_API_KEY=sk-ant-...
+
+# Start service
+docker-compose up -d
+
+# Review a PR
+curl -X POST http://localhost:8081/v1/review/pr \
+  -H "Content-Type: application/json" \
+  -d '{
+    "repository": "owner/repo",
+    "prNumber": 123,
+    "baseRef": "main",
+    "headRef": "feature/new-feature"
+  }'
+```
+
+## OSSA Export
+
+```bash
+# Export to Anthropic TypeScript SDK
+ossa export agent.ossa.yaml --platform anthropic --output code-review.ts
+
+# Export to npm package
+ossa export agent.ossa.yaml --platform npm --output dist/
+```
+
+## Integration
+
+### GitHub Actions
+
+```yaml
+name: Code Review
+on: [pull_request]
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Review Code
+        run: |
+          curl -X POST ${{ secrets.CODE_REVIEW_URL }}/v1/review/pr \
+            -d '{"repository":"${{ github.repository }}","prNumber":${{ github.event.number }}}'
+```
+
+### GitLab CI
+
+```yaml
+code_review:
+  stage: test
+  script:
+    - |
+      curl -X POST ${CODE_REVIEW_URL}/v1/review/pr \
+        -d "{\"repository\":\"${CI_PROJECT_PATH}\",\"prNumber\":${CI_MERGE_REQUEST_IID}}"
+```