@bluefly/openstandardagents 0.3.2 → 0.3.3

package/examples/multi-agent/conditional-router.ossa.yaml

@@ -1,42 +1,42 @@
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: conditional-router
-  version: "1.0.0"
+  version: 1.0.0
   description: Router agent that conditionally routes to specialist agents
 spec:
   role: Router that analyzes requests and routes to appropriate specialist
   llm:
     provider: openai
     model: gpt-4o-mini
-  
   tools:
-    - type: function
-      name: route_to_code_specialist
-      description: Route coding questions to code specialist agent
-      parameters:
-        type: object
-        properties:
-          question:
-            type: string
-        required: [question]
-    
-    - type: function
-      name: route_to_data_specialist
-      description: Route data questions to data specialist agent
-      parameters:
-        type: object
-        properties:
-          question:
-            type: string
-        required: [question]
-    
-    - type: function
-      name: route_to_general_assistant
-      description: Route general questions to general assistant
-      parameters:
-        type: object
-        properties:
-          question:
-            type: string
-        required: [question]
+  - type: function
+    name: route_to_code_specialist
+    description: Route coding questions to code specialist agent
+    parameters:
+      type: object
+      properties:
+        question:
+          type: string
+      required:
+      - question
+  - type: function
+    name: route_to_data_specialist
+    description: Route data questions to data specialist agent
+    parameters:
+      type: object
+      properties:
+        question:
+          type: string
+      required:
+      - question
+  - type: function
+    name: route_to_general_assistant
+    description: Route general questions to general assistant
+    parameters:
+      type: object
+      properties:
+        question:
+          type: string
+      required:
+      - question

package/examples/multi-agent/parallel-execution.ossa.yaml

@@ -1,54 +1,54 @@
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: parallel-executor
-  version: "1.0.0"
+  version: 1.0.0
   description: Parallel execution with fan-out/fan-in pattern
 spec:
   role: Orchestrator for parallel task execution
   llm:
     provider: openai
     model: gpt-4o-mini
-  
   tools:
-    - type: function
-      name: call_agent_a
-      description: Execute task on agent A (runs in parallel)
-      parameters:
-        type: object
-        properties:
-          task:
+  - type: function
+    name: call_agent_a
+    description: Execute task on agent A (runs in parallel)
+    parameters:
+      type: object
+      properties:
+        task:
+          type: string
+      required:
+      - task
+  - type: function
+    name: call_agent_b
+    description: Execute task on agent B (runs in parallel)
+    parameters:
+      type: object
+      properties:
+        task:
+          type: string
+      required:
+      - task
+  - type: function
+    name: call_agent_c
+    description: Execute task on agent C (runs in parallel)
+    parameters:
+      type: object
+      properties:
+        task:
+          type: string
+      required:
+      - task
+  - type: function
+    name: aggregate_results
+    description: Combine results from all parallel agents
+    parameters:
+      type: object
+      properties:
+        results:
+          type: array
+          items:
             type: string
-        required: [task]
-    
-    - type: function
-      name: call_agent_b
-      description: Execute task on agent B (runs in parallel)
-      parameters:
-        type: object
-        properties:
-          task:
-            type: string
-        required: [task]
-    
-    - type: function
-      name: call_agent_c
-      description: Execute task on agent C (runs in parallel)
-      parameters:
-        type: object
-        properties:
-          task:
-            type: string
-        required: [task]
-    
-    - type: function
-      name: aggregate_results
-      description: Combine results from all parallel agents
-      parameters:
-        type: object
-        properties:
-          results:
-            type: array
-            items:
-              type: string
-        required: [results]
+      required:
+      - results

package/examples/multi-agent/sequential-pipeline.ossa.yaml

@@ -1,45 +1,45 @@
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: sequential-pipeline
-  version: "1.0.0"
+  version: 1.0.0
   description: Sequential pipeline with 3 agents processing data in chain
 spec:
   role: Orchestrator for sequential data processing pipeline
   llm:
     provider: openai
     model: gpt-4o-mini
-  
   tools:
-    - type: function
-      name: call_researcher
-      description: Call the researcher agent to gather information
-      parameters:
-        type: object
-        properties:
-          query:
-            type: string
-            description: Research query
-        required: [query]
-    
-    - type: function
-      name: call_analyzer
-      description: Call the analyzer agent to process research results
-      parameters:
-        type: object
-        properties:
-          data:
-            type: string
-            description: Data to analyze
-        required: [data]
-    
-    - type: function
-      name: call_writer
-      description: Call the writer agent to create final output
-      parameters:
-        type: object
-        properties:
-          analysis:
-            type: string
-            description: Analysis to write about
-        required: [analysis]
+  - type: function
+    name: call_researcher
+    description: Call the researcher agent to gather information
+    parameters:
+      type: object
+      properties:
+        query:
+          type: string
+          description: Research query
+      required:
+      - query
+  - type: function
+    name: call_analyzer
+    description: Call the analyzer agent to process research results
+    parameters:
+      type: object
+      properties:
+        data:
+          type: string
+          description: Data to analyze
+      required:
+      - data
+  - type: function
+    name: call_writer
+    description: Call the writer agent to create final output
+    parameters:
+      type: object
+      properties:
+        analysis:
+          type: string
+          description: Analysis to write about
+      required:
+      - analysis

package/examples/observability/activity-stream-full.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: activity-tracked-agent

package/examples/openai/basic-agent.ossa.yaml

@@ -1,60 +1,59 @@
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Agent
-
 metadata:
   name: basic-openai-agent
   version: 1.0.0
   description: A basic OpenAI agent demonstrating simple tool usage
-
 spec:
-  role: |
-    You are a helpful assistant that can search the web and perform calculations.
+  role: 'You are a helpful assistant that can search the web and perform calculations.
+
     Always provide clear and concise answers.
 
+    '
   llm:
     provider: openai
     model: gpt-4o-mini
     temperature: 0.7
-
 extensions:
   openai_agents:
     model: gpt-4o-mini
-    instructions: |
-      You are a helpful assistant with access to web search and calculator tools.
+    instructions: 'You are a helpful assistant with access to web search and calculator
+      tools.
+
       Use the search tool to find current information.
+
       Use the calculator for mathematical operations.
+
       Always explain your reasoning.
-    
+
+      '
     tools_mapping:
-      - ossa_capability: web_search
-        openai_tool_name: search
-        description: Search the web for current information
-        parameters:
-          type: object
-          properties:
-            query:
-              type: string
-              description: The search query
-          required:
-            - query
-      
-      - ossa_capability: calculator
-        openai_tool_name: calculate
-        description: Perform mathematical calculations
-        parameters:
-          type: object
-          properties:
-            expression:
-              type: string
-              description: Mathematical expression to evaluate (e.g., "2 + 2", "sqrt(16)")
-          required:
-            - expression
-    
+    - ossa_capability: web_search
+      openai_tool_name: search
+      description: Search the web for current information
+      parameters:
+        type: object
+        properties:
+          query:
+            type: string
+            description: The search query
+        required:
+        - query
+    - ossa_capability: calculator
+      openai_tool_name: calculate
+      description: Perform mathematical calculations
+      parameters:
+        type: object
+        properties:
+          expression:
+            type: string
+            description: Mathematical expression to evaluate (e.g., "2 + 2", "sqrt(16)")
+        required:
+        - expression
     guardrails:
       enabled: true
       max_tool_calls: 5
       timeout_seconds: 60
-    
     memory:
       enabled: true
       type: session

package/examples/openai/multi-tool-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3.2",
+  "apiVersion": "ossa/v0.3.3",
   "kind": "Agent",
   "metadata": {
     "name": "multi-tool-agent",

package/examples/openai/swarm-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3.2",
+  "apiVersion": "ossa/v0.3.3",
   "kind": "Agent",
   "metadata": {
     "name": "swarm-agent",

package/examples/ossa-templates/01-code-assistant.ossa.yaml

@@ -0,0 +1,114 @@
+apiVersion: ossa/v0.3.3
+kind: Agent
+metadata:
+  name: code-assistant
+  version: 1.0.0
+  description: Universal AI coding assistant for all major IDEs
+  labels:
+    ossa.dev/category: development
+    ossa.dev/tier: standard-example
+    ossa.dev/ide: universal
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/code-assistant
+spec:
+  capabilities:
+  - name: code.complete
+    description: Intelligent code completion with context awareness
+  - name: code.refactor
+    description: Automated refactoring with safety checks
+  - name: code.explain
+    description: Explain code functionality and architecture
+  - name: code.generate
+    description: Generate code from natural language descriptions
+  - name: code.debug
+    description: Identify and suggest fixes for bugs
+  role: 'You are a universal AI coding assistant integrated across all major IDEs.
+
+    Your capabilities span code completion, refactoring, explanation, generation,
+
+    and debugging across all programming languages.
+
+
+    Key behaviors:
+
+    1. Context-aware completions based on project patterns
+
+    2. Safe refactoring with preview and undo support
+
+    3. Clear explanations with examples
+
+    4. Idiomatic code generation following project conventions
+
+    5. Root cause analysis for debugging
+
+    '
+  llm:
+    provider: ${OSSA_LLM_PROVIDER:-anthropic}
+    model: ${OSSA_LLM_MODEL:-claude-sonnet-4}
+    temperature: ${OSSA_LLM_TEMPERATURE:-0.3}
+    maxTokens: ${OSSA_LLM_MAX_TOKENS:-8192}
+  tools:
+  - name: file.read
+    description: Read file contents with line numbers
+    handler:
+      runtime: ide
+      capability: fs.read
+    type: function
+  - name: file.edit
+    description: Edit file with diff preview
+    handler:
+      runtime: ide
+      capability: fs.edit
+    type: function
+  - name: search.code
+    description: Search codebase with regex
+    handler:
+      runtime: ide
+      capability: search.code
+    type: function
+  - name: search.files
+    description: Find files by glob pattern
+    handler:
+      runtime: ide
+      capability: search.files
+    type: function
+  - name: terminal.run
+    description: Execute terminal commands
+    handler:
+      runtime: ide
+      capability: terminal.execute
+    type: function
+  safety:
+    constraints:
+    - Never execute destructive commands without confirmation
+    - Never expose secrets or credentials in responses
+    - Respect .gitignore and security policies
+    policies:
+    - policy: read-only-by-default
+      description: All file operations require explicit approval
+extensions:
+  claude-code:
+    hooks:
+      before_execute: validate_permissions
+      after_execute: log_action
+    keyboard_shortcuts:
+      toggle: Cmd+Shift+A
+      explain: Cmd+Shift+E
+  cursor:
+    composer_integration: true
+    inline_suggestions: true
+  copilot:
+    suggestions:
+      enabled: true
+      debounce_ms: 300
+  vscode:
+    extension_id: ossa.code-assistant
+    commands:
+    - ossa.explain
+    - ossa.refactor
+    - ossa.generate
+  jetbrains:
+    plugin_id: org.ossa.code-assistant
+    actions:
+    - OSSAExplainAction
+    - OSSARefactorAction

package/examples/ossa-templates/02-security-scanner.ossa.yaml

@@ -0,0 +1,103 @@
+apiVersion: ossa/v0.3.3
+kind: Agent
+metadata:
+  name: security-scanner
+  version: 1.0.0
+  description: Security analysis agent with vulnerability and compliance scanning
+  labels:
+    ossa.dev/category: security
+    ossa.dev/tier: standard-example
+    ossa.dev/access-tier: elevated
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/security-scanner
+spec:
+  capabilities:
+  - name: security.scan
+    description: Scan codebase for security vulnerabilities
+  - name: security.audit
+    description: Audit dependencies for known CVEs
+  - name: security.secrets
+    description: Detect exposed secrets and credentials
+  - name: security.compliance
+    description: Check compliance against security policies
+  role: 'You are a security specialist agent responsible for identifying vulnerabilities,
+
+    auditing dependencies, detecting secrets, and ensuring compliance with security
+
+    policies.
+
+
+    Security scanning process:
+
+    1. Static analysis for common vulnerability patterns (OWASP Top 10)
+
+    2. Dependency vulnerability scanning (CVE database)
+
+    3. Secret detection (API keys, tokens, credentials)
+
+    4. Configuration security review
+
+    5. Compliance policy validation
+
+
+    Always provide:
+
+    - Severity classification (Critical, High, Medium, Low)
+
+    - Affected file and line number
+
+    - Remediation guidance
+
+    - References to CVEs or security advisories
+
+    '
+  llm:
+    provider: ${OSSA_LLM_PROVIDER:-anthropic}
+    model: ${OSSA_LLM_MODEL:-claude-sonnet-4}
+    temperature: 0.1
+    maxTokens: ${OSSA_LLM_MAX_TOKENS:-16384}
+  tools:
+  - name: scan.sast
+    description: Run static application security testing
+    handler:
+      runtime: docker
+      image: returntocorp/semgrep:latest
+      command:
+      - semgrep
+      - --config=auto
+    type: function
+  - name: scan.dependencies
+    description: Scan dependencies for vulnerabilities
+    handler:
+      runtime: docker
+      image: aquasec/trivy:latest
+      command:
+      - trivy
+      - fs
+      - .
+    type: function
+  - name: scan.secrets
+    description: Detect secrets in codebase
+    handler:
+      runtime: docker
+      image: trufflesecurity/trufflehog:latest
+      command:
+      - filesystem
+      - .
+    type: function
+  - name: report.generate
+    description: Generate security report
+    handler:
+      runtime: local
+      capability: report.generate
+    type: function
+  safety:
+    constraints:
+    - Never expose actual secret values in reports
+    - Redact sensitive information before logging
+    - Rate limit external vulnerability database queries
+    policies:
+    - policy: no-secret-exposure
+      description: All detected secrets must be redacted in output
+    - policy: audit-logging
+      description: All scans must be logged for compliance

package/examples/ossa-templates/03-ci-pipeline.ossa.yaml

@@ -0,0 +1,100 @@
+apiVersion: ossa/v0.3.3
+kind: Agent
+metadata:
+  name: ci-pipeline
+  version: 1.0.0
+  description: CI/CD automation agent for pipeline management
+  labels:
+    ossa.dev/category: devops
+    ossa.dev/tier: standard-example
+    ossa.dev/runtime: gitlab-ci
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/ci-pipeline
+spec:
+  capabilities:
+  - name: ci.trigger
+    description: Trigger CI/CD pipeline runs
+  - name: ci.monitor
+    description: Monitor pipeline status and jobs
+  - name: ci.fix
+    description: Analyze and fix pipeline failures
+  - name: ci.optimize
+    description: Optimize pipeline performance
+  role: 'You are a CI/CD automation specialist responsible for managing build, test,
+
+    and deployment pipelines. You can trigger pipelines, monitor their status,
+
+    diagnose failures, and optimize performance.
+
+
+    Pipeline management:
+
+    1. Trigger appropriate pipelines based on changes
+
+    2. Monitor job status and detect failures early
+
+    3. Analyze failure logs and suggest fixes
+
+    4. Optimize pipeline DAGs for faster execution
+
+    5. Manage deployment approvals and rollbacks
+
+    '
+  llm:
+    provider: ${OSSA_LLM_PROVIDER:-anthropic}
+    model: ${OSSA_LLM_MODEL:-claude-sonnet-4}
+    temperature: 0.2
+    maxTokens: ${OSSA_LLM_MAX_TOKENS:-8192}
+  tools:
+  - name: gitlab.pipeline.trigger
+    description: Trigger a GitLab CI pipeline
+    handler:
+      runtime: api
+      endpoint: ${GITLAB_API_URL}/projects/${CI_PROJECT_ID}/pipeline
+      method: POST
+    type: function
+  - name: gitlab.pipeline.status
+    description: Get pipeline status
+    handler:
+      runtime: api
+      endpoint: ${GITLAB_API_URL}/projects/${CI_PROJECT_ID}/pipelines/${PIPELINE_ID}
+      method: GET
+    type: function
+  - name: gitlab.job.log
+    description: Get job logs for analysis
+    handler:
+      runtime: api
+      endpoint: ${GITLAB_API_URL}/projects/${CI_PROJECT_ID}/jobs/${JOB_ID}/trace
+      method: GET
+    type: function
+  - name: gitlab.mr.create
+    description: Create merge request with fixes
+    handler:
+      runtime: api
+      endpoint: ${GITLAB_API_URL}/projects/${CI_PROJECT_ID}/merge_requests
+      method: POST
+    type: function
+  messaging:
+    transport: redis
+    queues:
+    - name: ci-events
+      description: CI/CD event notifications
+    - name: ci-commands
+      description: Pipeline commands
+    events:
+      publish:
+      - pipeline.triggered
+      - pipeline.completed
+      - pipeline.failed
+      subscribe:
+      - merge_request.created
+      - push.received
+extensions:
+  gitlab:
+    project_access_token: ${CI_JOB_TOKEN}
+    api_version: v4
+    webhooks:
+    - event: pipeline_events
+      url: ${OSSA_WEBHOOK_URL}/ci-pipeline
+    - event: merge_request_events
+      url: ${OSSA_WEBHOOK_URL}/ci-pipeline