@bluefly/openstandardagents 0.4.0 → 0.4.2

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

@@ -0,0 +1,150 @@
+openapi: 3.1.0
+info:
+  title: Code Review Agent API
+  version: 1.0.0
+  description: Automated code review service powered by Anthropic Claude
+
+servers:
+  - url: http://localhost:8081
+    description: Local development
+  - url: https://code-review.company.com
+    description: Production
+
+paths:
+  /v1/review/pr:
+    post:
+      summary: Review pull request
+      operationId: reviewPullRequest
+      tags:
+        - Review
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PRReviewRequest'
+      responses:
+        '200':
+          description: Review completed
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ReviewResponse'
+
+  /v1/review/file:
+    post:
+      summary: Review individual file
+      operationId: reviewFile
+      tags:
+        - Review
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/FileReviewRequest'
+      responses:
+        '200':
+          description: File review completed
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/FileReviewResponse'
+
+  /v1/health:
+    get:
+      summary: Health check
+      operationId: healthCheck
+      responses:
+        '200':
+          description: Service healthy
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                  uptime:
+                    type: number
+
+components:
+  schemas:
+    PRReviewRequest:
+      type: object
+      required:
+        - repository
+        - prNumber
+      properties:
+        repository:
+          type: string
+          example: "owner/repo"
+        prNumber:
+          type: integer
+          example: 123
+        baseRef:
+          type: string
+          example: "main"
+        headRef:
+          type: string
+          example: "feature/new-feature"
+
+    FileReviewRequest:
+      type: object
+      required:
+        - code
+        - language
+      properties:
+        code:
+          type: string
+        language:
+          type: string
+          enum: [javascript, typescript, python, java, go, rust]
+        filePath:
+          type: string
+
+    ReviewResponse:
+      type: object
+      properties:
+        reviewId:
+          type: string
+        summary:
+          type: string
+        issues:
+          type: array
+          items:
+            $ref: '#/components/schemas/Issue'
+        qualityScore:
+          type: integer
+          minimum: 1
+          maximum: 10
+
+    FileReviewResponse:
+      type: object
+      properties:
+        issues:
+          type: array
+          items:
+            $ref: '#/components/schemas/Issue'
+        suggestions:
+          type: array
+          items:
+            type: string
+
+    Issue:
+      type: object
+      properties:
+        severity:
+          type: string
+          enum: [critical, high, medium, low, info]
+        category:
+          type: string
+          enum: [security, performance, style, bug, maintainability]
+        message:
+          type: string
+        line:
+          type: integer
+        file:
+          type: string
+        suggestion:
+          type: string

package/examples/production-ready/03-data-analysis-agent/README.md

@@ -0,0 +1,51 @@
+# Data Analysis Agent
+
+Production data analysis agent exported as npm package.
+
+## Features
+
+- Load data from CSV, JSON, SQL, Parquet
+- Statistical analysis (descriptive, correlation, regression, clustering, timeseries)
+- Data visualization (charts, graphs, heatmaps)
+- Automated insights generation
+- Integration with pandas, numpy, scikit-learn
+
+## Quick Start
+
+```bash
+# Install as npm package
+npm install @company/data-analysis-agent
+
+# Or run with Docker
+docker-compose up -d
+
+# Analyze data
+curl -X POST http://localhost:8082/v1/analyze \
+  -H "Content-Type: application/json" \
+  -d '{
+    "data": [...],
+    "analysisType": "descriptive"
+  }'
+```
+
+## Export to npm
+
+```bash
+ossa export agent.ossa.yaml --platform npm --output dist/
+
+# Use in your project
+import { DataAnalysisAgent } from '@company/data-analysis-agent';
+
+const agent = new DataAnalysisAgent();
+const results = await agent.analyze(data, 'correlation');
+```
+
+## API Endpoints
+
+- `POST /v1/analyze` - Analyze dataset
+- `POST /v1/visualize` - Create visualization
+- `GET /v1/health` - Health check
+
+## License
+
+Apache-2.0

package/examples/production-ready/03-data-analysis-agent/agent.ossa.yaml

@@ -0,0 +1,97 @@
+apiVersion: ossa/v0.4.1
+kind: Agent
+metadata:
+  name: data-analysis-agent
+  version: 1.0.0
+  description: |
+    Data analysis agent that loads, analyzes, and visualizes data.
+    Exported as npm package for easy integration into data pipelines.
+  labels:
+    platform: npm
+    export: npm
+    use-case: data-analysis
+    tier: production
+spec:
+  role: |
+    You are a data analysis expert specializing in:
+    - Statistical analysis and hypothesis testing
+    - Data cleaning and preprocessing
+    - Trend identification and pattern recognition
+    - Data visualization and reporting
+    - Predictive modeling
+
+  llm:
+    provider: openai
+    model: gpt-4o
+    temperature: 0.2
+    maxTokens: 2000
+
+  capabilities:
+    - load_data
+    - analyze_data
+    - visualize_data
+    - generate_insights
+
+  tools:
+    - type: function
+      name: load_data
+      description: Load data from various sources
+      parameters:
+        type: object
+        properties:
+          source:
+            type: string
+            description: Data source (file, database, api)
+          format:
+            type: string
+            enum: [csv, json, parquet, sql]
+          options:
+            type: object
+        required:
+          - source
+
+    - type: function
+      name: analyze_data
+      description: Perform statistical analysis
+      parameters:
+        type: object
+        properties:
+          data:
+            type: array
+          analysisType:
+            type: string
+            enum: [descriptive, correlation, regression, clustering, timeseries]
+          parameters:
+            type: object
+
+    - type: function
+      name: visualize_data
+      description: Create data visualizations
+      parameters:
+        type: object
+        properties:
+          data:
+            type: array
+          chartType:
+            type: string
+            enum: [line, bar, scatter, heatmap, histogram, box]
+          options:
+            type: object
+
+  observability:
+    logging:
+      level: info
+    metrics:
+      enabled: true
+      port: 9090
+
+extensions:
+  npm:
+    package_name: "@company/data-analysis-agent"
+    export_format: esm
+    include_types: true
+    dependencies:
+      - pandas
+      - numpy
+      - matplotlib
+      - scikit-learn

package/examples/production-ready/03-data-analysis-agent/openapi.yaml

@@ -0,0 +1,74 @@
+openapi: 3.1.0
+info:
+  title: Data Analysis Agent API
+  version: 1.0.0
+  description: Data analysis and visualization service
+
+servers:
+  - url: http://localhost:8082
+
+paths:
+  /v1/analyze:
+    post:
+      summary: Analyze dataset
+      operationId: analyzeData
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                data:
+                  type: array
+                analysisType:
+                  type: string
+                  enum: [descriptive, correlation, regression, clustering, timeseries]
+      responses:
+        '200':
+          description: Analysis results
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  results:
+                    type: object
+                  insights:
+                    type: array
+                    items:
+                      type: string
+                  visualizations:
+                    type: array
+
+  /v1/visualize:
+    post:
+      summary: Create visualization
+      operationId: visualizeData
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                data:
+                  type: array
+                chartType:
+                  type: string
+                  enum: [line, bar, scatter, heatmap, histogram, box]
+      responses:
+        '200':
+          description: Visualization created
+          content:
+            image/png:
+              schema:
+                type: string
+                format: binary
+
+  /v1/health:
+    get:
+      summary: Health check
+      responses:
+        '200':
+          description: Service healthy

package/examples/production-ready/04-content-moderator/README.md

@@ -0,0 +1,55 @@
+# Content Moderator
+
+Content moderation agent using OpenAI with automated flagging and human escalation.
+
+## Features
+
+- Detect hate speech, violence, harassment, spam, adult content
+- Automatic flagging with severity levels
+- Human-in-the-loop escalation
+- Multi-modal support (text, image, video, audio)
+- Decision audit trail
+
+## Quick Start
+
+```bash
+export OPENAI_API_KEY=sk-...
+docker-compose up -d
+
+# Moderate content
+curl -X POST http://localhost:8083/v1/moderate \
+  -H "Content-Type: application/json" \
+  -d '{
+    "content": "user submitted content",
+    "contentType": "text"
+  }'
+```
+
+## Export to OpenAI Assistant
+
+```bash
+ossa export agent.ossa.yaml --platform openai-assistant --output moderator.json
+
+# Create assistant via API
+curl https://api.openai.com/v1/assistants \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d @moderator.json
+```
+
+## Configuration
+
+Set moderation thresholds in `agent.ossa.yaml`:
+
+```yaml
+safety:
+  input_filters:
+    - type: content_sanitization
+  output_validation:
+    - type: decision_audit
+      log_all_decisions: true
+```
+
+## License
+
+Apache-2.0

package/examples/production-ready/04-content-moderator/agent.ossa.yaml

@@ -0,0 +1,131 @@
+apiVersion: ossa/v0.4.1
+kind: Agent
+metadata:
+  name: content-moderator
+  version: 1.0.0
+  description: |
+    Content moderation agent using OpenAI with automated flagging and escalation.
+    Detects harmful content, hate speech, and policy violations.
+  labels:
+    platform: openai
+    export: openai-assistant
+    use-case: content-moderation
+    tier: production
+spec:
+  role: |
+    You are a content moderation specialist responsible for:
+    - Detecting harmful or inappropriate content
+    - Identifying policy violations
+    - Flagging content for human review
+    - Escalating critical issues
+    - Maintaining community safety
+
+  llm:
+    provider: openai
+    model: gpt-4o
+    temperature: 0.1
+    maxTokens: 1000
+
+  capabilities:
+    - check_content
+    - flag_violation
+    - escalate_issue
+    - categorize_content
+
+  tools:
+    - type: function
+      name: check_content
+      description: Analyze content for policy violations
+      parameters:
+        type: object
+        properties:
+          content:
+            type: string
+            description: Content to moderate
+          contentType:
+            type: string
+            enum: [text, image, video, audio]
+          context:
+            type: object
+        required:
+          - content
+          - contentType
+
+    - type: function
+      name: flag_violation
+      description: Flag content as violating policies
+      parameters:
+        type: object
+        properties:
+          contentId:
+            type: string
+          violationType:
+            type: string
+            enum: [hate_speech, violence, harassment, spam, adult_content, misinformation]
+          severity:
+            type: string
+            enum: [low, medium, high, critical]
+          evidence:
+            type: string
+        required:
+          - contentId
+          - violationType
+          - severity
+
+    - type: function
+      name: escalate_issue
+      description: Escalate to human moderator
+      parameters:
+        type: object
+        properties:
+          contentId:
+            type: string
+          reason:
+            type: string
+          priority:
+            type: string
+            enum: [normal, urgent, critical]
+        required:
+          - contentId
+          - reason
+
+  autonomy:
+    level: supervised
+    approval_required: true
+    approval_conditions:
+      - severity == 'critical'
+      - violationType == 'hate_speech'
+
+  safety:
+    input_filters:
+      - type: content_sanitization
+    output_validation:
+      - type: decision_audit
+        log_all_decisions: true
+
+  observability:
+    logging:
+      level: info
+      include_decisions: true
+    metrics:
+      enabled: true
+      metrics:
+        - content_moderated
+        - violations_flagged
+        - false_positives
+        - escalations
+
+extensions:
+  openai_assistant:
+    assistant_type: moderation
+    instructions: |
+      Analyze content for policy violations.
+      Be objective and consistent.
+      When in doubt, escalate to human review.
+    tools_mapping:
+      - ossa_capability: check_content
+        openai_function: check_content
+      - ossa_capability: flag_violation
+        openai_function: flag_violation
+      - ossa_capability: escalate_issue
+        openai_function: escalate

package/examples/production-ready/04-content-moderator/openapi.yaml

@@ -0,0 +1,50 @@
+openapi: 3.1.0
+info:
+  title: Content Moderator API
+  version: 1.0.0
+  description: Content moderation service
+
+servers:
+  - url: http://localhost:8083
+
+paths:
+  /v1/moderate:
+    post:
+      summary: Moderate content
+      operationId: moderateContent
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - content
+                - contentType
+              properties:
+                content:
+                  type: string
+                contentType:
+                  type: string
+                  enum: [text, image, video, audio]
+      responses:
+        '200':
+          description: Moderation complete
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  safe:
+                    type: boolean
+                  violations:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        type:
+                          type: string
+                        severity:
+                          type: string
+                        confidence:
+                          type: number

package/examples/production-ready/05-sales-assistant/README.md

@@ -0,0 +1,37 @@
+# Sales Assistant
+
+Sales automation agent with CRM integration and entity memory.
+
+## Features
+
+- Lead qualification and management
+- CRM search and updates
+- Automated follow-up emails
+- Meeting scheduling
+- Entity memory for personalization
+- Sales pipeline tracking
+
+## Quick Start
+
+```bash
+export OPENAI_API_KEY=sk-...
+docker-compose up -d
+
+curl -X POST http://localhost:8084/v1/chat \
+  -d '{"message": "Create a lead for John Doe from Acme Corp"}'
+```
+
+## Export to LangChain
+
+```bash
+ossa export agent.ossa.yaml --platform langchain --output sales_agent.py
+
+# Use in Python
+from sales_agent import SalesAssistant
+agent = SalesAssistant()
+response = agent.run("Search for leads in tech industry")
+```
+
+## License
+
+Apache-2.0