@bluefly/openstandardagents 0.4.9 → 0.5.1

package/examples/drupal/drupal-contributor.ossa.yaml

@@ -0,0 +1,247 @@
+apiVersion: ossa/v0.5.0
+kind: Agent
+metadata:
+  name: drupal-contributor
+  version: 1.0.0
+  description: >-
+    Autonomous Drupal issue contributor. Discovers issues on Drupal.org,
+    analyzes discussions, implements patches, pushes merge requests, and
+    monitors CI pipelines. The first OSSA-native development agent.
+  labels:
+    use-case: open-source-contribution
+    drupal-version: "11"
+    production-ready: "false"
+    ossa-native: "true"
+  agentType: custom
+  agentKind: worker
+  identity:
+    namespace: blueflyio/ossa
+    agent_id: drupal-contributor
+    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:
+      - development
+      - open-source
+      - drupal
+    tags:
+      - drupal
+      - contributor
+      - issue-fixing
+      - merge-request
+      - ci-monitoring
+      - ossa-native
+
+spec:
+  role: |
+    You are an autonomous Drupal open-source contributor agent.
+
+    Your mission:
+    1. Discover open issues on Drupal.org via the drupalorg-cli
+    2. Analyze issue discussions and existing patches
+    3. Implement fixes following Drupal coding standards
+    4. Run static analysis (PHPStan, PHPCS) before pushing
+    5. Create merge requests on GitLab
+    6. Monitor CI pipeline results and iterate
+
+    Guidelines:
+    - Follow Drupal coding standards strictly
+    - Write tests for all changes
+    - Keep patches minimal and focused
+    - Provide clear commit messages referencing the issue
+    - Respect human reviewer feedback
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-20250514
+    temperature: 0.2
+    max_tokens: 8192
+
+  tools:
+    - type: command
+      name: drupal_issue_context
+      description: Fetch issue details and discussion from Drupal.org
+      operation: read
+      command: drupalorg issue:show
+      parameters:
+        issue_id:
+          type: string
+          description: Drupal.org issue ID (e.g. 3456789)
+
+    - type: function
+      name: drupal_issue_checkout
+      description: Checkout issue branch for local development
+      operation: write
+      command: drupalorg issue:checkout
+      parameters:
+        issue_id:
+          type: string
+          description: Drupal.org issue ID to checkout
+
+    - type: function
+      name: drupal_mr_diff
+      description: Show merge request diff for review
+      operation: read
+      command: drupalorg mr:diff
+      parameters:
+        mr_id:
+          type: string
+          description: Merge request ID on Drupal.org GitLab
+
+    - type: function
+      name: phpstan_analyze
+      description: Run PHPStan static analysis on changed files
+      operation: read
+      command: phpstan analyse
+      parameters:
+        path:
+          type: string
+          description: Path to analyze (file or directory)
+        level:
+          type: number
+          description: Analysis level 0-9
+          default: 6
+
+    - type: command
+      name: phpcs_check
+      description: Run PHP CodeSniffer with Drupal coding standards
+      operation: read
+      command: phpcs
+      parameters:
+        path:
+          type: string
+          description: Path to check
+        standard:
+          type: string
+          description: Coding standard to use
+          default: Drupal,DrupalPractice
+
+    - type: command
+      name: git_push_mr
+      description: Stage, commit, and push changes to create a merge request
+      operation: write
+      command: git
+      parameters:
+        message:
+          type: string
+          description: Commit message referencing the issue
+        branch:
+          type: string
+          description: Target branch for the merge request
+
+  capabilities:
+    - name: issue-analysis
+      description: Analyze Drupal.org issue context and patches
+    - name: code-implementation
+      description: Implement fixes following Drupal standards
+    - name: static-analysis
+      description: Run PHPStan and PHPCS checks
+    - name: merge-request-creation
+      description: Create and manage GitLab merge requests
+    - name: ci-monitoring
+      description: Monitor CI pipeline results
+
+  safety:
+    guardrails:
+      - no_production_deploys
+      - human_review_required_before_merge
+      - follow_drupal_coding_standards
+      - audit_all_actions
+    pii_handling: none
+    audit_all_actions: true
+    max_cost_per_execution: 0.50
+
+  observability:
+    telemetry:
+      enabled: true
+      export_traces: true
+      export_metrics: true
+
+security:
+  tier: tier_2_write_limited
+  threat_model:
+    - category: prompt-injection
+      severity: medium
+      mitigations:
+        - input-validation
+        - output-filtering
+      description: Issue text from Drupal.org could contain adversarial content
+    - category: supply-chain
+      severity: high
+      mitigations:
+        - dependency-scanning
+        - code-review
+      description: Patches must be reviewed before merge
+  capabilities:
+    required:
+      - filesystem-read
+      - filesystem-write
+      - network-outbound
+      - process-spawn
+      - tool-execution
+    optional:
+      - browser
+  sandboxing:
+    required: true
+    type: container
+    resource_limits:
+      max_memory_mb: 2048
+      max_cpu_cores: 2
+      max_execution_seconds: 600
+      max_disk_mb: 1024
+  network_access:
+    allowed_domains:
+      - "*.drupal.org"
+      - "*.drupalcode.org"
+      - "gitlab.com"
+      - "api.anthropic.com"
+    protocols:
+      - https
+    egress_policy: allow-list
+  data_classification: internal
+  audit:
+    log_inputs: true
+    log_outputs: true
+    log_tool_calls: true
+    retention_days: 90
+
+protocols:
+  mcp:
+    version: 1.0.0
+    role: client
+    capabilities:
+      tools: true
+      resources: true
+    servers:
+      - name: drupalorg-cli
+        transport: stdio
+        command: drupalorg
+  a2a:
+    version: 0.2.0
+    endpoint: https://openstandardagents.org/agents/drupal-contributor
+    agent_card:
+      name: drupal-contributor
+      description: Analyze and fix a Drupal.org issue
+      skills:
+        - id: fix-drupal-issue
+          name: fix-drupal-issue
+          description: Analyze and fix a Drupal.org issue
+    capabilities:
+      stateTransitionHistory: true
+
+governance:
+  authorization:
+    policy_references:
+      - blueflyio/cedar-policies
+  compliance:
+    frameworks:
+      - NIST-800-53
+    data_classification: internal
+    audit_logging_required: true

package/examples/export/langchain/production-agent-with-memory/README.md

@@ -328,7 +328,7 @@ REDIS_URL=redis://localhost:6379
 
 **PostgreSQL Backend:**
 ```bash
-POSTGRES_URL=postgresql://postgres:postgres@localhost:5432/agent_memory
+POSTGRES_URL=postgresql://postgres:${POSTGRES_PASSWORD}@localhost:5432/agent_memory
 ```
 
 **OpenAI API (for Summary/Entity Memory):**

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.1
 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.1
 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.1
 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.1
 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.1
 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.1
 kind: Agent
 metadata:
   name: hello-world-agent