@bluefly/openstandardagents 0.4.9 → 0.5.0

package/examples/export/langchain/production-agent-with-memory/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: production-agent-with-memory
@@ -16,36 +16,29 @@ metadata:
     use-case: production-showcase
     tier: production
     version: v0.4.1
-
 spec:
   role: |
     You are a production assistant with advanced memory capabilities.
     You maintain conversation context across sessions and track entities.
-
   llm:
     provider: openai
     model: gpt-4o
     temperature: 0.7
     maxTokens: 2000
-
-  # Memory Configuration (Full OSSA spec)
   memory:
     enabled: true
     type: conversation_buffer
     window_size: 20
     max_token_limit: 4000
     return_messages: true
-
-    # Persistence Configuration
     persistence:
       enabled: true
-      backend: redis  # or: postgres
-      ttl: 86400  # 24 hours
+      backend: redis
+      ttl: 86400
       connection:
-        url: ${REDIS_URL}  # or ${POSTGRES_URL}
+        url: ${REDIS_URL}
         pool_size: 10
         timeout: 30
-
   tools:
     - type: function
       name: remember_fact
@@ -58,7 +51,6 @@ spec:
             description: Fact to remember
         required:
           - fact
-
     - type: function
       name: recall_conversation
       description: Recall previous conversation
@@ -70,11 +62,9 @@ spec:
             description: What to recall
         required:
           - query
-
   autonomy:
     level: supervised
     approval_required: false
-
   observability:
     logging:
       level: info
@@ -84,14 +74,14 @@ spec:
     tracing:
       enabled: true
       provider: opentelemetry
-
 extensions:
   langchain:
-    agent_type: react
-    memory_type: conversation_buffer  # buffer, summary, entity
-    export_config:
-      format: python
-      include_dependencies: true
-      include_api_server: true
-      api_port: 8000
-      memory_backend: redis  # buffer, summary, entity, redis, postgres
+    enabled: true
+    chain_type: agent
+    memory:
+      type: buffer
+    tools:
+      - name: remember_fact
+        description: Remember an important fact
+      - name: recall_conversation
+        description: Recall previous conversation

package/examples/export/langchain/production-agent-with-streaming/agent.ossa.yaml

@@ -1,4 +1,3 @@
-ossaVersion: 0.4.1
 kind: Agent
 metadata:
   name: production-streaming-agent
@@ -12,7 +11,6 @@ metadata:
     - sse
     - websocket
     - a2a
-
 spec:
   role: |
     You are a production streaming agent that demonstrates real-time response streaming.
@@ -23,13 +21,11 @@ spec:
     - Agent-to-agent (a2a) streaming integration
     - Token-by-token streaming responses
     - Real-time tool execution updates
-
   llm:
     provider: openai
     model: gpt-4-turbo-preview
     temperature: 0.7
     max_tokens: 2000
-
   tools:
     - name: search_web
       type: function
@@ -42,7 +38,6 @@ spec:
             description: Search query
         required:
           - query
-
     - name: analyze_data
       type: function
       description: Analyze data and return insights
@@ -54,7 +49,6 @@ spec:
             description: Data to analyze
         required:
           - data
-
   memory:
     type: redis
     config:
@@ -62,32 +56,23 @@ spec:
       port: ${REDIS_PORT:6379}
       db: 0
       session_ttl: 3600
-
   streaming:
-    # Server-Sent Events (SSE) Configuration
     sse:
       enabled: true
       endpoint: /chat/stream
-
-    # WebSocket Configuration
     websocket:
       enabled: true
       endpoint: /ws
       port: 8000
-
-    # Agent-to-Agent (a2a) Streaming
     a2a:
       enabled: true
       mesh_url: ${AGENT_MESH_URL:http://localhost:8080}
-
-    # LangChain Callbacks
     callbacks:
       on_llm_start: true
       on_llm_new_token: true
       on_llm_end: true
       on_tool_start: true
       on_tool_end: true
-
   api:
     port: 8000
     cors:
@@ -98,3 +83,4 @@ spec:
     rate_limit:
       enabled: true
       requests_per_minute: 60
+apiVersion: ossa/v0.5

package/examples/export/langchain/production-agent-with-tools/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: production-agent-with-tools
@@ -15,7 +15,6 @@ metadata:
     use-case: production-showcase
     tier: production
     version: v0.4.1
-
 spec:
   role: |
     You are a production assistant with multiple capabilities:
@@ -24,22 +23,18 @@ spec:
     3. Execute MCP tools
     4. Process text and generate reports
     5. Send notifications
-
   llm:
     provider: openai
     model: gpt-4o
     temperature: 0.7
     maxTokens: 2000
-
   capabilities:
     - search
     - api_calls
     - text_processing
     - notifications
     - mcp_tools
-
   tools:
-    # API Tool - Async HTTP requests with Pydantic validation
     - type: api
       name: search_api
       description: Search external knowledge base via REST API
@@ -60,8 +55,6 @@ spec:
             description: Optional search filters
         required:
           - query
-
-    # Function Tool - Complex schema with Pydantic model
     - type: function
       name: analyze_text
       description: Analyze text content and extract insights
@@ -87,8 +80,6 @@ spec:
         required:
           - text
           - analysis_types
-
-    # Function Tool - Data processing with nested schema
     - type: function
       name: generate_report
       description: Generate formatted report from data
@@ -106,7 +97,10 @@ spec:
           format:
             type: string
             description: Output format
-            enum: [markdown, html, pdf]
+            enum:
+              - markdown
+              - html
+              - pdf
             default: markdown
           include_charts:
             type: boolean
@@ -115,8 +109,6 @@ spec:
         required:
           - title
           - sections
-
-    # API Tool - Webhook notification
     - type: api
       name: send_notification
       description: Send notification via webhook
@@ -130,7 +122,11 @@ spec:
             description: Notification message
           priority:
             type: string
-            enum: [low, medium, high, urgent]
+            enum:
+              - low
+              - medium
+              - high
+              - urgent
             description: Notification priority
           channels:
             type: array
@@ -140,8 +136,6 @@ spec:
         required:
           - message
           - priority
-
-    # MCP Tool - Model Context Protocol integration
     - type: mcp
       name: mcp_database_query
       description: Query database via MCP server
@@ -165,8 +159,6 @@ spec:
         required:
           - query
           - database
-
-    # Function Tool - Simple tool without complex schema
     - type: function
       name: format_timestamp
       description: Format timestamp to human-readable string
@@ -179,23 +171,20 @@ spec:
           format:
             type: string
             description: Output format string
-            default: "%Y-%m-%d %H:%M:%S"
+            default: '%Y-%m-%d %H:%M:%S'
           timezone:
             type: string
             description: Timezone (e.g., UTC, America/New_York)
             default: UTC
         required:
           - timestamp
-
   autonomy:
     level: supervised
     approval_required: false
-
   memory:
     enabled: true
     type: conversation_buffer
     window_size: 20
-
   observability:
     logging:
       level: info
@@ -205,12 +194,22 @@ spec:
     tracing:
       enabled: true
       provider: opentelemetry
-
 extensions:
   langchain:
-    agent_type: react
-    export_config:
-      format: python
-      include_dependencies: true
-      include_api_server: true
-      api_port: 8000
+    enabled: true
+    chain_type: agent
+    memory:
+      type: buffer
+    tools:
+      - name: search_api
+        description: Search external knowledge base via REST API
+      - name: analyze_text
+        description: Analyze text content and extract insights
+      - name: generate_report
+        description: Generate formatted report from data
+      - name: send_notification
+        description: Send notification via webhook
+      - name: mcp_database_query
+        description: Query database via MCP server
+      - name: format_timestamp
+        description: Format timestamp to human-readable string

package/examples/getting-started/01-minimal-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5.0
 kind: Agent
 metadata:
   name: hello-world-agent

package/examples/getting-started/02-agent-with-tools.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5.0
 kind: Agent
 metadata:
   name: code-assistant

package/examples/getting-started/03-agent-with-safety.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5.0
 kind: Agent
 metadata:
   name: secure-assistant

package/examples/getting-started/04-agent-with-messaging.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5.0
 kind: Agent
 metadata:
   name: security-scanner

package/examples/getting-started/05-workflow-composition.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5.0
 kind: Workflow
 metadata:
   name: code-review-pipeline

package/examples/getting-started/README.md

@@ -5,7 +5,7 @@ Learn OSSA step-by-step with these progressively complex examples.
 ## Prerequisites
 
 ```bash
-npm install -g @bluefly/ossa-cli
+npm install -g @bluefly/openstandardagents
 ```
 
 ## Examples
@@ -29,7 +29,7 @@ export ANTHROPIC_API_KEY=your-key
 ossa run 01-minimal-agent.ossa.yaml --input "Hello, how can you help me?"
 
 # Export to framework
-ossa export 02-agent-with-tools.ossa.yaml --format langchain
+ossa export 02-agent-with-tools.ossa.yaml --platform langchain
 ```
 
 ## Learning Path
@@ -66,4 +66,4 @@ export OTEL_ENDPOINT=http://localhost:4317
 
 - [Full Examples](../agent-manifests/) - Real-world agent definitions
 - [Framework Adapters](../adapters/) - LangChain, CrewAI, AutoGen
-- [Schema Reference](../../spec/v0.3.0/) - Complete OSSA specification
+- [Schema Reference](../../spec/v0.5/agent.schema.json) - Current OSSA schema

package/examples/getting-started/hello-world-complete.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5.0
 kind: Agent
 metadata:
   name: hello-world-agent

package/examples/gitlab-agents/gitlab-ci-agent.ossa.yaml

@@ -0,0 +1,221 @@
+apiVersion: ossa/v0.5
+kind: Agent
+metadata:
+  name: gitlab-ci-agent
+  version: 1.0.0
+  description: Pipeline fixer agent. Detects broken CI/CD pipelines, inspects job logs, diagnoses failures, and applies fixes. Uses BuildKit CLI and GitLab API.
+  labels:
+    use-case: ci-cd-automation
+    production-ready: 'false'
+    ossa-native: 'true'
+  agentType: custom
+  agentKind: worker
+  identity:
+    namespace: blueflyio/ossa
+    agent_id: gitlab-ci-agent
+    version: 1.0.0
+    publisher:
+      name: BlueFly.io
+      email: agents@bluefly.io
+      website: https://openstandardagents.org
+    created_at: 2026-03-10T12:00:00Z
+    updated_at: 2026-03-10T12:00:00Z
+  catalog:
+    published: true
+    visibility: public
+    categories:
+      - devops
+      - ci-cd
+      - gitlab
+    tags:
+      - gitlab
+      - ci
+      - pipeline
+      - buildkit
+      - ossa-native
+spec:
+  role: |
+    You are an autonomous GitLab CI/CD pipeline fixer agent.
+
+    Your mission:
+    1. Monitor pipelines across GitLab projects
+    2. Detect failed jobs and inspect their logs
+    3. Diagnose root causes (dependency issues, test failures, config errors)
+    4. Apply fixes (update CI config, fix tests, update dependencies)
+    5. Push fixes and verify the pipeline turns green
+
+    Guidelines:
+    - Never force-push to shared branches
+    - Always create fix branches, never commit directly to main/release
+    - Explain your diagnosis clearly in commit messages
+    - Escalate to humans for infrastructure-level issues
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-20250514
+    temperature: 0.1
+    max_tokens: 8192
+  tools:
+    - type: command
+      name: pipeline_list
+      description: List recent pipelines for a project
+      operation: read
+      command: buildkit gitlab pipelines list
+      parameters:
+        project:
+          type: string
+          description: GitLab project path (e.g. blueflyio/agent-platform/tools/agent-buildkit)
+        ref:
+          type: string
+          description: Branch to check (e.g. release/v0.1.x)
+    - type: command
+      name: pipeline_jobs
+      description: List jobs in a pipeline with status
+      operation: read
+      command: buildkit gitlab pipelines jobs
+      parameters:
+        pipeline_id:
+          type: number
+          description: Pipeline ID to inspect
+    - type: command
+      name: job_log
+      description: Fetch the log output of a failed job
+      operation: read
+      command: buildkit gitlab pipelines job-log
+      parameters:
+        job_id:
+          type: number
+          description: Job ID to get log for
+    - type: command
+      name: deploy_service
+      description: Deploy a service to Oracle via BuildKit
+      operation: write
+      command: buildkit deploy oracle
+      parameters:
+        service:
+          type: string
+          description: Service name to deploy (e.g. mcp, mesh, router)
+    - type: api
+      name: gitlab_api
+      description: Direct GitLab API calls for MR management
+      operation: write
+      parameters:
+        method:
+          type: string
+          enum:
+            - GET
+            - POST
+            - PUT
+        endpoint:
+          type: string
+          description: GitLab API endpoint path
+  capabilities:
+    - name: pipeline-monitoring
+      description: Monitor CI/CD pipeline status across projects
+    - name: failure-diagnosis
+      description: Analyze job logs to identify root causes
+    - name: automated-fix
+      description: Apply fixes for common CI failures
+    - name: deployment
+      description: Deploy services via BuildKit
+  safety:
+    guardrails:
+      - no_force_push
+      - no_direct_main_commits
+      - human_escalation_for_infra
+      - audit_all_actions
+    pii_handling: none
+    audit_all_actions: true
+    max_cost_per_execution: 0.3
+security:
+  tier: tier_2_write_limited
+  threat_model:
+    - category: privilege-escalation
+      severity: high
+      mitigations:
+        - scoped-tokens
+        - least-privilege
+      description: CI tokens must be scoped to minimum required permissions
+  capabilities:
+    required:
+      - network-outbound
+      - process-spawn
+      - tool-execution
+    optional:
+      - filesystem-read
+      - filesystem-write
+  sandboxing:
+    required: true
+    type: container
+    resource_limits:
+      max_memory_mb: 1024
+      max_cpu_cores: 1
+      max_execution_seconds: 300
+  network_access:
+    allowed_domains:
+      - gitlab.com
+      - '*.gitlab.com'
+      - api.anthropic.com
+    protocols:
+      - https
+    egress_policy: allow-list
+  data_classification: internal
+protocols:
+  mcp:
+    version: 1.0.0
+    role: client
+    capabilities:
+      tools: true
+      resources: false
+      prompts: false
+      sampling: false
+    servers:
+      - name: buildkit
+        transport: stdio
+        command: buildkit
+        tools:
+          - pipeline_list
+          - pipeline_jobs
+          - job_log
+          - deploy_service
+          - gitlab_api
+  a2a:
+    version: 0.2.0
+    endpoint: https://openstandardagents.org/agents/gitlab-ci-agent
+    agent_card:
+      name: GitLab CI Agent
+      description: Diagnose and repair GitLab CI/CD pipelines
+      skills:
+        - id: fix-pipeline
+          name: Fix Pipeline
+          description: Diagnose and fix a broken CI pipeline
+    capabilities:
+      streaming: true
+      pushNotifications: false
+      stateTransitionHistory: true
+    authentication:
+      schemes:
+        - bearer
+governance:
+  authorization:
+    clearance_level: 2
+    policy_references:
+      - blueflyio/cedar-policies
+    tool_permissions:
+      - tool: pipeline_list
+        risk_level: low
+      - tool: pipeline_jobs
+        risk_level: low
+      - tool: job_log
+        risk_level: low
+      - tool: deploy_service
+        risk_level: high
+        requires_approval: true
+      - tool: gitlab_api
+        risk_level: high
+        requires_approval: true
+  quality_requirements:
+    confidence_threshold: 0.85
+    security_score_threshold: 80
+  compliance:
+    data_classification: internal
+    audit_logging_required: true