@bluefly/openstandardagents 0.4.0 → 0.4.1

package/examples/production-ready/08-email-triage-agent/agent.ossa.yaml

@@ -0,0 +1,133 @@
+apiVersion: ossa/v0.4.1
+kind: Agent
+metadata:
+  name: email-triage-agent
+  version: 1.0.0
+  description: |
+    Email triage agent that reads, categorizes, and responds to emails automatically.
+    Exported as npm package for integration with email systems.
+  labels:
+    platform: npm
+    export: npm
+    use-case: email-automation
+    tier: production
+spec:
+  role: |
+    You are an email management assistant responsible for:
+    - Reading and categorizing incoming emails
+    - Prioritizing messages by importance and urgency
+    - Drafting appropriate responses
+    - Routing emails to correct departments
+    - Flagging emails requiring human attention
+
+  llm:
+    provider: openai
+    model: gpt-4o
+    temperature: 0.6
+    maxTokens: 1000
+
+  capabilities:
+    - read_email
+    - categorize_email
+    - draft_response
+    - route_email
+
+  tools:
+    - type: function
+      name: read_email
+      description: Read email content and metadata
+      parameters:
+        type: object
+        properties:
+          emailId:
+            type: string
+          includeAttachments:
+            type: boolean
+            default: false
+        required:
+          - emailId
+
+    - type: function
+      name: categorize_email
+      description: Categorize email by type and priority
+      parameters:
+        type: object
+        properties:
+          email:
+            type: object
+          categories:
+            type: array
+            items:
+              type: string
+              enum: [support, sales, billing, hr, legal, spam]
+          priority:
+            type: string
+            enum: [low, medium, high, urgent]
+        required:
+          - email
+
+    - type: function
+      name: draft_response
+      description: Draft email response
+      parameters:
+        type: object
+        properties:
+          emailId:
+            type: string
+          responseType:
+            type: string
+            enum: [auto_reply, acknowledgment, answer, referral]
+          tone:
+            type: string
+            enum: [professional, friendly, formal]
+        required:
+          - emailId
+          - responseType
+
+    - type: function
+      name: route_email
+      description: Route email to appropriate team/person
+      parameters:
+        type: object
+        properties:
+          emailId:
+            type: string
+          destination:
+            type: string
+          notes:
+            type: string
+
+  autonomy:
+    level: supervised
+    approval_required: false
+    auto_approve_conditions:
+      - category == 'spam'
+      - responseType == 'auto_reply'
+    approval_conditions:
+      - priority == 'urgent'
+      - category == 'legal'
+
+  safety:
+    output_validation:
+      - type: tone_check
+        required_tone: [professional, friendly]
+      - type: pii_protection
+        redact_sensitive: true
+
+  observability:
+    logging:
+      level: info
+    metrics:
+      enabled: true
+      metrics:
+        - emails_processed
+        - emails_categorized
+        - responses_sent
+        - routing_accuracy
+
+extensions:
+  npm:
+    package_name: "@company/email-triage-agent"
+    export_format: esm
+    include_types: true
+    entry_point: index.js

package/examples/production-ready/08-email-triage-agent/openapi.yaml

@@ -0,0 +1,41 @@
+openapi: 3.1.0
+info:
+  title: Email Triage Agent API
+  version: 1.0.0
+  description: Email categorization and automation
+
+servers:
+  - url: http://localhost:8087
+
+paths:
+  /v1/triage:
+    post:
+      summary: Triage email
+      operationId: triageEmail
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - emailId
+              properties:
+                emailId:
+                  type: string
+      responses:
+        '200':
+          description: Email triaged
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  category:
+                    type: string
+                  priority:
+                    type: string
+                  suggestedResponse:
+                    type: string
+                  routeTo:
+                    type: string

package/examples/production-ready/09-security-scanner/README.md

@@ -0,0 +1,49 @@
+# Security Scanner
+
+Automated security scanning and vulnerability detection agent.
+
+## Features
+
+- SAST (Static Application Security Testing)
+- Dependency vulnerability scanning
+- Secret detection
+- Infrastructure-as-Code scanning
+- SARIF report generation
+- GitHub/GitLab integration
+
+## Quick Start
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+export GITHUB_TOKEN=ghp_...
+
+docker-compose up -d
+
+curl -X POST http://localhost:8088/v1/scan \
+  -d '{"repository": "owner/repo", "branch": "main"}'
+```
+
+## Automated Scanning
+
+Configure webhook for automatic PR scanning:
+
+```yaml
+# .github/workflows/security-scan.yml
+on: [pull_request]
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Security Scan
+        run: curl -X POST $SCANNER_URL/v1/scan -d '{"repository":"${{github.repository}}"}'
+```
+
+## Export to Anthropic SDK
+
+```bash
+ossa export agent.ossa.yaml --platform anthropic --output security-scanner.ts
+```
+
+## License
+
+Apache-2.0

package/examples/production-ready/09-security-scanner/agent.ossa.yaml

@@ -0,0 +1,174 @@
+apiVersion: ossa/v0.4.1
+kind: Agent
+metadata:
+  name: security-scanner
+  version: 1.0.0
+  description: |
+    Security scanning agent that analyzes code for vulnerabilities and generates security reports.
+    Uses Anthropic Claude with extended thinking for deep analysis.
+  labels:
+    platform: anthropic
+    export: anthropic
+    use-case: security
+    tier: production
+spec:
+  role: |
+    You are a security expert specializing in:
+    - Vulnerability detection and analysis
+    - Security best practices
+    - Threat modeling
+    - Compliance validation
+    - Security report generation
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-20250514
+    temperature: 0.1
+    maxTokens: 4000
+
+  capabilities:
+    - scan_code
+    - find_vulnerabilities
+    - generate_report
+    - suggest_remediation
+
+  tools:
+    - type: function
+      name: scan_code
+      description: Scan code for security vulnerabilities
+      parameters:
+        type: object
+        properties:
+          repository:
+            type: string
+          branch:
+            type: string
+          scanTypes:
+            type: array
+            items:
+              type: string
+              enum: [sast, dependency, secrets, iac, container]
+          severity_threshold:
+            type: string
+            enum: [low, medium, high, critical]
+        required:
+          - repository
+
+    - type: function
+      name: find_vulnerabilities
+      description: Analyze code for specific vulnerability patterns
+      parameters:
+        type: object
+        properties:
+          code:
+            type: string
+          language:
+            type: string
+          patterns:
+            type: array
+            items:
+              type: string
+              enum: [sql_injection, xss, csrf, authentication, authorization, crypto]
+        required:
+          - code
+          - language
+
+    - type: function
+      name: generate_report
+      description: Generate security analysis report
+      parameters:
+        type: object
+        properties:
+          findings:
+            type: array
+          format:
+            type: string
+            enum: [json, html, pdf, sarif]
+          include_remediation:
+            type: boolean
+            default: true
+        required:
+          - findings
+
+  triggers:
+    - type: webhook
+      source: github
+      events: [push, pull_request]
+    - type: schedule
+      cron: "0 2 * * *"  # Daily at 2 AM
+
+  tasks:
+    - name: security-scan
+      steps:
+        - name: clone-repository
+          action: git
+          operation: clone
+
+        - name: run-sast-scan
+          action: function_call
+          function: scan_code
+          params:
+            scanTypes: [sast, dependency, secrets]
+
+        - name: analyze-findings
+          action: llm
+          provider: anthropic
+          model: claude-sonnet-4-20250514
+          prompt: |
+            Analyze security scan results:
+            ${outputs.scan_results}
+
+            Provide:
+            1. Critical vulnerabilities requiring immediate action
+            2. Risk assessment
+            3. Recommended remediation steps
+            4. Priority ranking
+
+        - name: generate-report
+          action: function_call
+          function: generate_report
+          params:
+            findings: ${outputs.analysis}
+            format: sarif
+
+        - name: create-issues
+          action: http
+          method: POST
+          url: ${env.GITHUB_API_URL}/repos/${inputs.repository}/issues
+          body:
+            title: "Security Scan: ${outputs.critical_count} critical issues found"
+            body: ${outputs.report}
+            labels: [security, automated]
+
+  autonomy:
+    level: autonomous
+    approval_required: false
+    escalation_rules:
+      - condition: severity == 'critical'
+        action: notify_security_team
+
+  safety:
+    input_validation:
+      - type: code_sanitization
+      - type: secret_redaction
+
+  observability:
+    logging:
+      level: info
+    metrics:
+      enabled: true
+      metrics:
+        - scans_completed
+        - vulnerabilities_found
+        - critical_issues
+        - scan_duration
+    tracing:
+      enabled: true
+
+extensions:
+  anthropic:
+    use_extended_thinking: true
+    max_thinking_tokens: 3000
+    export_config:
+      format: typescript
+      output_file: security-scanner.ts

package/examples/production-ready/09-security-scanner/openapi.yaml

@@ -0,0 +1,46 @@
+openapi: 3.1.0
+info:
+  title: Security Scanner API
+  version: 1.0.0
+  description: Automated security scanning and vulnerability detection
+
+servers:
+  - url: http://localhost:8088
+
+paths:
+  /v1/scan:
+    post:
+      summary: Scan repository
+      operationId: scanRepository
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - repository
+              properties:
+                repository:
+                  type: string
+                branch:
+                  type: string
+                scanTypes:
+                  type: array
+                  items:
+                    type: string
+                    enum: [sast, dependency, secrets, iac, container]
+      responses:
+        '200':
+          description: Scan complete
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  scanId:
+                    type: string
+                  findings:
+                    type: array
+                  reportUrl:
+                    type: string

package/examples/production-ready/10-meeting-assistant/README.md

@@ -0,0 +1,53 @@
+# Meeting Assistant
+
+Meeting transcription, summarization, and action item extraction.
+
+## Features
+
+- Audio transcription with speaker diarization
+- Meeting summarization
+- Action item extraction
+- Meeting minutes generation
+- Zoom/Google Meet integration
+- Email distribution
+
+## Quick Start
+
+```bash
+export OPENAI_API_KEY=sk-...
+docker-compose up -d
+
+curl -X POST http://localhost:8089/v1/process-recording \
+  -d '{
+    "recordingUrl": "https://zoom.us/rec/...",
+    "meetingTitle": "Product Planning",
+    "attendees": ["alice@company.com", "bob@company.com"]
+  }'
+```
+
+## Integration
+
+### Zoom Webhook
+
+Configure Zoom webhook to automatically process recordings:
+
+```json
+{
+  "url": "https://your-domain.com/v1/webhook/zoom",
+  "event_types": ["recording.completed"]
+}
+```
+
+### Google Meet
+
+Use Google Calendar API integration for automatic processing.
+
+## Export to LangChain
+
+```bash
+ossa export agent.ossa.yaml --platform langchain --output meeting_assistant.py
+```
+
+## License
+
+Apache-2.0

package/examples/production-ready/10-meeting-assistant/agent.ossa.yaml

@@ -0,0 +1,211 @@
+apiVersion: ossa/v0.4.1
+kind: Agent
+metadata:
+  name: meeting-assistant
+  version: 1.0.0
+  description: |
+    Meeting assistant that transcribes, summarizes, and extracts action items from meetings.
+    Uses GPT-4o with conversation buffer memory for context retention.
+  labels:
+    platform: langchain
+    export: langchain
+    use-case: meeting-automation
+    tier: production
+spec:
+  role: |
+    You are a professional meeting assistant specializing in:
+    - Meeting transcription and note-taking
+    - Summarization and key point extraction
+    - Action item identification and tracking
+    - Meeting minutes generation
+    - Follow-up task creation
+
+  llm:
+    provider: openai
+    model: gpt-4o
+    temperature: 0.5
+    maxTokens: 3000
+
+  capabilities:
+    - transcribe_audio
+    - summarize_meeting
+    - extract_action_items
+    - generate_minutes
+
+  tools:
+    - type: function
+      name: transcribe_audio
+      description: Transcribe meeting audio to text
+      parameters:
+        type: object
+        properties:
+          audioUrl:
+            type: string
+            format: uri
+          language:
+            type: string
+            default: en
+          speakerDiarization:
+            type: boolean
+            default: true
+        required:
+          - audioUrl
+
+    - type: function
+      name: summarize_meeting
+      description: Generate meeting summary
+      parameters:
+        type: object
+        properties:
+          transcript:
+            type: string
+          summaryType:
+            type: string
+            enum: [brief, detailed, executive]
+          includeTopic:
+            type: boolean
+            default: true
+        required:
+          - transcript
+
+    - type: function
+      name: extract_action_items
+      description: Extract action items from meeting
+      parameters:
+        type: object
+        properties:
+          transcript:
+            type: string
+          assignees:
+            type: array
+            items:
+              type: string
+        required:
+          - transcript
+
+    - type: function
+      name: generate_minutes
+      description: Generate formal meeting minutes
+      parameters:
+        type: object
+        properties:
+          meetingData:
+            type: object
+            properties:
+              date:
+                type: string
+                format: date-time
+              attendees:
+                type: array
+              topics:
+                type: array
+              decisions:
+                type: array
+          format:
+            type: string
+            enum: [markdown, html, pdf]
+            default: markdown
+        required:
+          - meetingData
+
+  triggers:
+    - type: webhook
+      source: zoom
+      events: [recording.completed]
+    - type: webhook
+      source: google_meet
+      events: [recording.ready]
+
+  tasks:
+    - name: process-recording
+      steps:
+        - name: transcribe
+          action: function_call
+          function: transcribe_audio
+          params:
+            audioUrl: ${inputs.recording_url}
+            speakerDiarization: true
+
+        - name: generate-summary
+          action: function_call
+          function: summarize_meeting
+          params:
+            transcript: ${outputs.transcript}
+            summaryType: detailed
+
+        - name: extract-actions
+          action: function_call
+          function: extract_action_items
+          params:
+            transcript: ${outputs.transcript}
+
+        - name: create-minutes
+          action: function_call
+          function: generate_minutes
+          params:
+            meetingData:
+              date: ${inputs.meeting_date}
+              attendees: ${inputs.attendees}
+              topics: ${outputs.summary}
+              decisions: ${outputs.action_items}
+
+        - name: send-to-participants
+          action: http
+          method: POST
+          url: ${env.EMAIL_SERVICE_URL}/send
+          body:
+            to: ${inputs.attendees}
+            subject: "Meeting Notes: ${inputs.meeting_title}"
+            body: ${outputs.minutes}
+            attachments:
+              - type: pdf
+                content: ${outputs.minutes_pdf}
+
+  memory:
+    enabled: true
+    type: conversation_buffer
+    window_size: 5
+    persistence:
+      enabled: false
+
+  outputs:
+    - name: transcript
+      type: string
+      description: Full meeting transcript
+    - name: summary
+      type: string
+      description: Meeting summary
+    - name: action_items
+      type: array
+      description: List of action items with assignees
+    - name: minutes
+      type: string
+      description: Formal meeting minutes
+
+  observability:
+    logging:
+      level: info
+    metrics:
+      enabled: true
+      metrics:
+        - meetings_processed
+        - transcription_duration
+        - action_items_extracted
+    tracing:
+      enabled: true
+
+extensions:
+  langchain:
+    agent_type: react
+    memory_type: conversation_buffer
+    tools_mapping:
+      - ossa_capability: transcribe_audio
+        langchain_tool: whisper_transcriber
+      - ossa_capability: summarize_meeting
+        langchain_tool: meeting_summarizer
+      - ossa_capability: extract_action_items
+        langchain_tool: action_extractor
+    export_config:
+      format: python
+      include_dependencies: true
+      output_file: meeting_assistant.py