@bluefly/openstandardagents 0.3.6 → 0.4.1

package/examples/agents/07-research-assistant/agent.ossa.yaml

@@ -0,0 +1,119 @@
+apiVersion: ossa/v0.4.1
+kind: Agent
+metadata:
+  name: research-assistant
+  version: 1.0.0
+  description: |
+    Research assistant that searches academic papers, summarizes findings, and generates citations.
+    Uses Claude with summary memory for long research sessions.
+  labels:
+    platform: langchain
+    export: langchain
+    use-case: research
+    tier: production
+spec:
+  role: |
+    You are an academic research assistant specializing in:
+    - Literature search and discovery
+    - Paper summarization and synthesis
+    - Citation management
+    - Research question formulation
+    - Methodology analysis
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-20250514
+    temperature: 0.5
+    maxTokens: 4000
+
+  capabilities:
+    - search_papers
+    - summarize_paper
+    - generate_citations
+    - compare_studies
+
+  tools:
+    - type: function
+      name: search_papers
+      description: Search academic papers and publications
+      parameters:
+        type: object
+        properties:
+          query:
+            type: string
+          databases:
+            type: array
+            items:
+              type: string
+              enum: [pubmed, arxiv, semantic_scholar, google_scholar]
+          filters:
+            type: object
+            properties:
+              year_range:
+                type: object
+              publication_type:
+                type: string
+              impact_factor:
+                type: number
+        required:
+          - query
+
+    - type: function
+      name: summarize_paper
+      description: Generate structured summary of research paper
+      parameters:
+        type: object
+        properties:
+          paperId:
+            type: string
+          summaryType:
+            type: string
+            enum: [abstract, full, methodology, findings]
+        required:
+          - paperId
+
+    - type: function
+      name: generate_citations
+      description: Generate citations in various formats
+      parameters:
+        type: object
+        properties:
+          papers:
+            type: array
+            items:
+              type: string
+          format:
+            type: string
+            enum: [apa, mla, chicago, bibtex]
+        required:
+          - papers
+          - format
+
+  memory:
+    enabled: true
+    type: summary_memory
+    summarization:
+      trigger_threshold: 10
+      summary_prompt: |
+        Summarize the key research topics, papers discussed,
+        and important findings from this session.
+
+  observability:
+    logging:
+      level: info
+    metrics:
+      enabled: true
+      metrics:
+        - papers_searched
+        - summaries_generated
+        - citations_created
+
+extensions:
+  langchain:
+    agent_type: react
+    memory_type: summary
+    tools_mapping:
+      - ossa_capability: search_papers
+        langchain_tool: academic_search
+      - ossa_capability: summarize_paper
+        langchain_tool: paper_summarizer

package/examples/agents/07-research-assistant/openapi.yaml

@@ -0,0 +1,56 @@
+openapi: 3.1.0
+info:
+  title: Research Assistant API
+  version: 1.0.0
+  description: Academic research and paper analysis
+
+servers:
+  - url: http://localhost:8086
+
+paths:
+  /v1/search:
+    post:
+      summary: Search academic papers
+      operationId: searchPapers
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - query
+              properties:
+                query:
+                  type: string
+                databases:
+                  type: array
+                  items:
+                    type: string
+                    enum: [pubmed, arxiv, semantic_scholar, google_scholar]
+      responses:
+        '200':
+          description: Search results
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  papers:
+                    type: array
+
+  /v1/summarize:
+    post:
+      summary: Summarize paper
+      operationId: summarizePaper
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                paperId:
+                  type: string
+      responses:
+        '200':
+          description: Summary

package/examples/agents/08-email-triage-agent/README.md

@@ -0,0 +1,33 @@
+# Email Triage Agent
+
+Email automation agent for categorization and response.
+
+## Features
+
+- Automatic email categorization
+- Priority detection
+- Smart routing to departments
+- Automated response drafting
+- PII protection
+
+## Quick Start
+
+```bash
+export OPENAI_API_KEY=sk-...
+docker-compose up -d
+
+curl -X POST http://localhost:8087/v1/triage \
+  -d '{"emailId": "email_123"}'
+```
+
+## Export to npm
+
+```bash
+ossa export agent.ossa.yaml --platform npm --output dist/
+
+npm install @company/email-triage-agent
+```
+
+## License
+
+Apache-2.0

package/examples/agents/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/agents/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/agents/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/agents/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/agents/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/agents/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