@bluefly/openstandardagents 0.4.8 → 0.5.0

package/examples/agentscope/react-assistant/agent.ossa.yaml

@@ -1,10 +1,10 @@
-apiVersion: ossa/v0.4.6
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: agentscope-react-assistant
-  namespace: bluefly/examples
-  version: "1.0.0"
-  description: "Example ReAct agent powered by AgentScope runtime with MCP tool integration, A2A protocol support, and Mem0 long-term memory."
+  namespace: bluefly-examples
+  version: 1.0.0
+  description: Example ReAct agent powered by AgentScope runtime with MCP tool integration, A2A protocol support, and Mem0 long-term memory.
   agentType: agentscope
   agentKind: assistant
   status: active
@@ -14,17 +14,14 @@ metadata:
     framework: agentscope
   identity:
     agent_id: agentscope-react-assistant
-    namespace: bluefly/examples
-    version: "1.0.0"
+    namespace: bluefly-examples
+    version: 1.0.0
     publisher:
       name: BlueFly Collective
       website: https://bluefly.io
-
 spec:
-  role: >
-    You are a helpful assistant that uses tools to answer questions accurately.
-    Always verify information before responding. Use available MCP tools for
-    real-time data retrieval and knowledge base queries.
+  role: |
+    You are a helpful assistant that uses tools to answer questions accurately. Always verify information before responding. Use available MCP tools for real-time data retrieval and knowledge base queries.
   llm:
     provider: anthropic
     model: claude-sonnet-4-20250514
@@ -39,18 +36,19 @@ spec:
     - type: mcp
       name: knowledge-base
       endpoint: https://gkg.blueflyagents.com/mcp/sse
-      description: "Graph knowledge base for codebase analysis"
+      description: Graph knowledge base for codebase analysis
     - type: mcp
       name: web-search
       endpoint: https://mcp.blueflyagents.com/api/mcp/sse
-      description: "Web search and content retrieval"
+      description: Web search and content retrieval
   inputs:
     type: object
     properties:
       query:
         type: string
-        description: "User query or task"
-    required: [query]
+        description: User query or task
+    required:
+      - query
   outputs:
     type: object
     properties:
@@ -60,23 +58,26 @@ spec:
         type: integer
       confidence:
         type: number
-
 security:
   tier: tier_1_read
   capabilities:
-    required: [network-outbound, tool-execution]
-    optional: [memory-extended]
+    required:
+      - network-outbound
+      - tool-execution
+    optional:
+      - memory-extended
   network_access:
     allowed_domains:
-      - "*.blueflyagents.com"
-      - "api.anthropic.com"
-    protocols: [https, wss]
+      - '*.blueflyagents.com'
+      - api.anthropic.com
+    protocols:
+      - https
+      - wss
     egress_policy: allow-list
   data_classification: internal
-
 protocols:
   mcp:
-    version: "1.0.0"
+    version: 1.0.0
     role: client
     capabilities:
       tools: true
@@ -84,23 +85,22 @@ protocols:
       prompts: false
       sampling: false
   a2a:
-    version: "0.2.1"
+    version: 0.2.1
     endpoint: https://agents.blueflyagents.com/a2a/react-assistant
     agent_card:
       name: AgentScope React Assistant
-      description: "ReAct agent with tool use and memory"
+      description: ReAct agent with tool use and memory
       skills:
         - id: question-answering
           name: Question Answering
-          description: "Answer questions using tools and knowledge"
+          description: Answer questions using tools and knowledge
         - id: code-analysis
           name: Code Analysis
-          description: "Analyze code using knowledge graph"
+          description: Analyze code using knowledge graph
     capabilities:
       streaming: true
       pushNotifications: false
       stateTransitionHistory: false
-
 token_efficiency:
   serialization_profile: compact
   observation_format: projected
@@ -109,13 +109,17 @@ token_efficiency:
     max_output_tokens: 4096
     allocation_strategy: adaptive
   routing:
-    cascade: [claude-haiku-4-5-20251001, claude-sonnet-4-20250514, claude-opus-4-20250514]
-    complexity_threshold: [0.3, 0.7]
+    cascade:
+      - claude-haiku-4-5-20251001
+      - claude-sonnet-4-20250514
+      - claude-opus-4-20250514
+    complexity_threshold:
+      - 0.3
+      - 0.7
     strategy: cost_optimized
-
 extensions:
   agentscope:
-    version: "1.0.16"
+    version: 1.0.16
     agent_class: ReActAgent
     capabilities:
       - rag

package/examples/drupal/content-moderator.ossa.yaml

@@ -1,7 +1,7 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5.0
 kind: Agent
 metadata:
-  name: content_moderator
+  name: content-moderator
   version: 1.0.0
   description: AI-powered content moderation agent for Drupal
   labels:

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