@bluefly/openstandardagents 0.4.0 → 0.4.1

package/examples/production-ready/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/production-ready/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/production-ready/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}}"
+```

package/examples/production-ready/02-code-review-agent/agent.ossa.yaml

@@ -0,0 +1,239 @@
+apiVersion: ossa/v0.4.1
+kind: Agent
+metadata:
+  name: code-review-agent
+  version: 1.0.0
+  description: |
+    Automated code review agent using Anthropic Claude with advanced analysis capabilities.
+    Performs static analysis, security scanning, and provides detailed feedback on code quality.
+  labels:
+    platform: anthropic
+    export: anthropic
+    use-case: code-review
+    tier: production
+spec:
+  role: |
+    You are an expert code reviewer with deep knowledge of:
+    - Software engineering best practices
+    - Security vulnerabilities and patterns
+    - Performance optimization
+    - Code readability and maintainability
+    - Language-specific idioms and patterns
+
+    Your review process:
+    1. Analyze code structure and organization
+    2. Identify security vulnerabilities
+    3. Suggest performance improvements
+    4. Check for code smells and anti-patterns
+    5. Provide constructive, actionable feedback
+
+    Review style:
+    - Specific and actionable
+    - Educational (explain WHY, not just WHAT)
+    - Balanced (highlight good patterns too)
+    - Respectful and encouraging
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-20250514
+    temperature: 0.3
+    maxTokens: 4000
+
+  capabilities:
+    - read_file
+    - analyze_code
+    - suggest_fix
+    - run_linter
+    - security_scan
+
+  tools:
+    - type: function
+      name: read_file
+      description: Read source code file from repository
+      parameters:
+        type: object
+        properties:
+          filePath:
+            type: string
+            description: Path to file in repository
+          ref:
+            type: string
+            description: Git ref (branch, commit, tag)
+            default: main
+        required:
+          - filePath
+
+    - type: function
+      name: analyze_code
+      description: Perform static code analysis
+      parameters:
+        type: object
+        properties:
+          code:
+            type: string
+            description: Source code to analyze
+          language:
+            type: string
+            description: Programming language
+            enum: [javascript, typescript, python, java, go, rust]
+          analysisType:
+            type: string
+            enum: [complexity, security, performance, style]
+        required:
+          - code
+          - language
+
+    - type: function
+      name: suggest_fix
+      description: Generate fix suggestion for identified issue
+      parameters:
+        type: object
+        properties:
+          issue:
+            type: string
+            description: Description of the issue
+          code:
+            type: string
+            description: Problematic code snippet
+          context:
+            type: string
+            description: Surrounding code context
+        required:
+          - issue
+          - code
+
+  triggers:
+    - type: webhook
+      source: github
+      events: [pull_request]
+    - type: webhook
+      source: gitlab
+      events: [merge_request]
+
+  tasks:
+    - name: analyze-pr
+      description: Analyze pull request changes
+      steps:
+        - name: get-changed-files
+          action: git
+          operation: diff
+          ref: ${inputs.base_ref}...${inputs.head_ref}
+
+        - name: review-each-file
+          action: foreach
+          items: ${outputs.changed_files}
+          steps:
+            - name: read-file-content
+              action: function_call
+              function: read_file
+              params:
+                filePath: ${item.path}
+                ref: ${inputs.head_ref}
+
+            - name: analyze-changes
+              action: llm
+              provider: anthropic
+              model: claude-sonnet-4-20250514
+              prompt: |
+                Review this code change:
+
+                File: ${item.path}
+                Language: ${item.language}
+
+                Changes:
+                ${item.diff}
+
+                Full context:
+                ${outputs.file_content}
+
+                Provide:
+                1. Security issues (CRITICAL, HIGH, MEDIUM, LOW)
+                2. Performance concerns
+                3. Code quality issues
+                4. Best practice violations
+                5. Positive aspects worth highlighting
+
+            - name: security-scan
+              action: function_call
+              function: analyze_code
+              params:
+                code: ${outputs.file_content}
+                language: ${item.language}
+                analysisType: security
+
+        - name: generate-review-summary
+          action: llm
+          provider: anthropic
+          prompt: |
+            Summarize the code review findings:
+
+            Files reviewed: ${outputs.files_analyzed}
+            Issues found: ${outputs.all_issues}
+
+            Generate:
+            1. Executive summary
+            2. Critical issues requiring immediate attention
+            3. Recommendations for improvement
+            4. Overall quality score (1-10)
+
+        - name: post-review-comment
+          action: http
+          method: POST
+          url: ${inputs.pr_comment_url}
+          headers:
+            Authorization: Bearer ${env.GITHUB_TOKEN}
+          body:
+            body: ${outputs.review_summary}
+
+  outputs:
+    - name: review_summary
+      type: string
+      description: Complete review summary
+    - name: issues_found
+      type: array
+      description: List of issues identified
+    - name: quality_score
+      type: integer
+      description: Overall quality score (1-10)
+
+  autonomy:
+    level: autonomous
+    approval_required: false
+    guardrails:
+      - type: confidence_threshold
+        threshold: 0.85
+      - type: rate_limit
+        max_reviews_per_hour: 50
+
+  safety:
+    input_validation:
+      - type: code_sanitization
+        remove_secrets: true
+      - type: size_limit
+        max_file_size: 1048576  # 1MB
+
+  observability:
+    logging:
+      level: info
+      format: json
+    metrics:
+      enabled: true
+      port: 9090
+      metrics:
+        - reviews_completed
+        - issues_detected
+        - review_duration
+        - quality_scores
+    tracing:
+      enabled: true
+      provider: opentelemetry
+
+extensions:
+  anthropic:
+    use_extended_thinking: true
+    max_thinking_tokens: 2000
+    response_format: structured
+    export_config:
+      format: typescript
+      include_types: true
+      output_file: code-review-agent.ts

package/examples/production-ready/02-code-review-agent/docker-compose.yml

@@ -0,0 +1,22 @@
+version: '3.8'
+
+services:
+  code-review-agent:
+    build: .
+    container_name: code-review-agent
+    ports:
+      - "8081:8081"
+      - "9091:9090"
+    environment:
+      - NODE_ENV=production
+      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
+      - GITHUB_TOKEN=${GITHUB_TOKEN}
+      - GITLAB_TOKEN=${GITLAB_TOKEN}
+      - LOG_LEVEL=info
+    restart: unless-stopped
+    networks:
+      - review-network
+
+networks:
+  review-network:
+    driver: bridge