@bluefly/openstandardagents 0.4.9 → 0.5.0

package/examples/production-ready/10-meeting-assistant/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: meeting-assistant
@@ -19,19 +19,16 @@ spec:
     - Action item identification and tracking
     - Meeting minutes generation
     - Follow-up task creation
-
   llm:
     provider: openai
     model: gpt-4o
     temperature: 0.5
     maxTokens: 3000
-
   capabilities:
     - transcribe_audio
     - summarize_meeting
     - extract_action_items
     - generate_minutes
-
   tools:
     - type: function
       name: transcribe_audio
@@ -50,7 +47,6 @@ spec:
             default: true
         required:
           - audioUrl
-
     - type: function
       name: summarize_meeting
       description: Generate meeting summary
@@ -61,13 +57,15 @@ spec:
             type: string
           summaryType:
             type: string
-            enum: [brief, detailed, executive]
+            enum:
+              - brief
+              - detailed
+              - executive
           includeTopic:
             type: boolean
             default: true
         required:
           - transcript
-
     - type: function
       name: extract_action_items
       description: Extract action items from meeting
@@ -82,7 +80,6 @@ spec:
               type: string
         required:
           - transcript
-
     - type: function
       name: generate_minutes
       description: Generate formal meeting minutes
@@ -103,19 +100,22 @@ spec:
                 type: array
           format:
             type: string
-            enum: [markdown, html, pdf]
+            enum:
+              - markdown
+              - html
+              - pdf
             default: markdown
         required:
           - meetingData
-
   triggers:
     - type: webhook
       source: zoom
-      events: [recording.completed]
+      events:
+        - recording.completed
     - type: webhook
       source: google_meet
-      events: [recording.ready]
-
+      events:
+        - recording.ready
   tasks:
     - name: process-recording
       steps:
@@ -125,20 +125,17 @@ spec:
           params:
             audioUrl: ${inputs.recording_url}
             speakerDiarization: true
-
         - name: generate-summary
           action: function_call
           function: summarize_meeting
           params:
             transcript: ${outputs.transcript}
             summaryType: detailed
-
         - name: extract-actions
           action: function_call
           function: extract_action_items
           params:
             transcript: ${outputs.transcript}
-
         - name: create-minutes
           action: function_call
           function: generate_minutes
@@ -148,26 +145,23 @@ spec:
               attendees: ${inputs.attendees}
               topics: ${outputs.summary}
               decisions: ${outputs.action_items}
-
         - name: send-to-participants
           action: http
           method: POST
           url: ${env.EMAIL_SERVICE_URL}/send
           body:
             to: ${inputs.attendees}
-            subject: "Meeting Notes: ${inputs.meeting_title}"
+            subject: 'Meeting Notes: ${inputs.meeting_title}'
             body: ${outputs.minutes}
             attachments:
               - type: pdf
                 content: ${outputs.minutes_pdf}
-
   memory:
     enabled: true
     type: conversation_buffer
     window_size: 5
     persistence:
       enabled: false
-
   outputs:
     - name: transcript
       type: string
@@ -181,7 +175,6 @@ spec:
     - name: minutes
       type: string
       description: Formal meeting minutes
-
   observability:
     logging:
       level: info
@@ -193,19 +186,18 @@ spec:
         - action_items_extracted
     tracing:
       enabled: true
-
 extensions:
   langchain:
-    agent_type: react
-    memory_type: conversation_buffer
-    tools_mapping:
-      - ossa_capability: transcribe_audio
-        langchain_tool: whisper_transcriber
-      - ossa_capability: summarize_meeting
-        langchain_tool: meeting_summarizer
-      - ossa_capability: extract_action_items
-        langchain_tool: action_extractor
-    export_config:
-      format: python
-      include_dependencies: true
-      output_file: meeting_assistant.py
+    enabled: true
+    chain_type: agent
+    memory:
+      type: buffer
+    tools:
+      - name: transcribe_audio
+        description: Transcribe meeting audio to text
+      - name: summarize_meeting
+        description: Generate meeting summary
+      - name: extract_action_items
+        description: Extract action items from meeting
+      - name: generate_minutes
+        description: Generate formal meeting minutes

package/examples/roles/drupal-developer.role.yaml

@@ -0,0 +1,37 @@
+apiVersion: ossa/v0.5
+kind: Role
+metadata:
+  name: drupal-developer
+  version: 1.0.0
+  description: Drupal module development role
+  labels:
+    platform: claude-code
+    domain: drupal
+spec:
+  role: |
+    You are a Drupal module developer following Drupal coding standards.
+  instructions:
+    preamble: |
+      ## Drupal Rules
+      - Use DI everywhere, not \Drupal::service()
+      - All config needs schema YAML
+      - PHPCS with Drupal/DrupalPractice
+    constraints:
+      - Never use db_query()
+      - Never hardcode module paths
+  tools:
+    allowed: [Read, Write, Edit, Bash, Grep, Glob]
+    skills: [drupal-phpcs, drupal-test-runner]
+  context:
+    files:
+      - path: composer.json
+      - path: "*.info.yml"
+  protocols:
+    mcp:
+      servers:
+        - name: drupal-tools
+          transport: stdio
+          command: drush
+          args: [mcp:serve]
+  activation:
+    file_patterns: ["*.module", "*.info.yml", "src/Plugin/**/*.php"]

package/examples/roles/platform-operator.role.yaml

@@ -0,0 +1,28 @@
+apiVersion: ossa/v0.5
+kind: Role
+metadata:
+  name: platform-operator
+  version: 1.0.0
+  description: Full-stack platform operations role
+spec:
+  role: |
+    You are a platform operator managing TypeScript services, CI/CD, and infrastructure.
+  instructions:
+    constraints:
+      - API-first: OpenAPI spec before implementation
+      - Never create shell scripts
+      - Never commit to main/release directly
+  tools:
+    allowed: [Read, Write, Edit, Bash, Grep, Glob]
+    skills: [commit, review-pr]
+  protocols:
+    mcp:
+      servers:
+        - name: gkg
+          transport: sse
+          url: https://gkg.example.com/mcp/sse
+  extends:
+    - role: typescript-developer
+  activation:
+    file_patterns: ["src/**/*.ts", "package.json"]
+    command: "/role platform"

package/examples/roles/security-auditor.role.yaml

@@ -0,0 +1,27 @@
+apiVersion: ossa/v0.5
+kind: Role
+metadata:
+  name: security-auditor
+  version: 1.0.0
+  description: Security audit and compliance review role
+  labels:
+    platform: claude-code
+    domain: security
+spec:
+  role: |
+    You are a security auditor focused on OWASP, CVE analysis, and compliance.
+  instructions:
+    preamble: |
+      ## Security Rules
+      - Check all inputs for injection vulnerabilities
+      - Verify authentication on every endpoint
+      - Review secrets management
+    constraints:
+      - Never approve code with hardcoded credentials
+      - Never skip security tests
+  tools:
+    allowed: [Read, Grep, Glob, Bash]
+    denied: [Write, Edit]
+    skills: [security-scan, ossa-validate]
+  activation:
+    file_patterns: ["**/security/**", "**/*.policy"]

package/examples/swarm-agent.ossa.yaml

@@ -1,30 +1,11 @@
-# OSSA v0.4.5 Example: Swarm Agent — OpenAI-Style Support Swarm
-#
-# Demonstrates the swarm pattern with hub-spoke coordination. A triage
-# coordinator routes conversations to specialist agents via automatic
-# handoffs. Each member handles a specific domain and can hand back to
-# triage when the query falls outside its scope.
-#
-# Key characteristics:
-#   - Hub-spoke model: triage agent is the central hub
-#   - Direct communication: agents hand off control directly
-#   - Assigned task coordination: triage decides who handles what
-#   - In-memory persistence: no durable task list needed
-
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: support-swarm
-  version: "1.0.0"
-  description: >-
-    An OpenAI Swarm-style customer support system. A triage coordinator
-    routes incoming queries to specialist agents (orders, returns, billing)
-    via automatic handoffs. Each specialist can hand back to triage when
-    it encounters an out-of-scope request.
-
+  version: 1.0.0
+  description: An OpenAI Swarm-style customer support system. A triage coordinator routes incoming queries to specialist agents (orders, returns, billing) via automatic handoffs. Each specialist can hand back to triage when it encounters an out-of-scope request.
   agentKind: coordinator
-  agentType: a2a
-
+  agentType: swarm
   agentArchitecture:
     pattern: swarm
     capabilities:
@@ -40,36 +21,25 @@ metadata:
       taskCoordination: assigned
       conflictResolution: leader-decides
       taskPersistence: in-memory
-
   labels:
     domain: customer-support
     pattern: swarm
     framework: openai-swarm
-
 spec:
-  role: >-
-    You are the triage coordinator for a customer support swarm. Analyze
-    incoming customer messages and route them to the appropriate specialist
-    agent. If a specialist hands back to you, re-evaluate and route to a
-    different specialist or handle the query directly.
-
+  role: You are the triage coordinator for a customer support swarm. Analyze incoming customer messages and route them to the appropriate specialist agent. If a specialist hands back to you, re-evaluate and route to a different specialist or handle the query directly.
   llm:
     provider: openai
     model: gpt-4o
     temperature: 0.2
     maxTokens: 1024
-
   team:
     model: hub-spoke
     lead: triage-agent
     delegateMode: false
-
     members:
       - name: order-agent
         kind: teammate
-        role: >-
-          Handle order-related queries: order status, shipment tracking,
-          order modifications, and cancellations.
+        role: 'Handle order-related queries: order status, shipment tracking, order modifications, and cancellations.'
         model:
           provider: openai
           name: gpt-4o-mini
@@ -80,15 +50,12 @@ spec:
         contextIsolation: true
         handoffs:
           - to: triage-agent
-            condition: "Query is not order-related"
+            condition: Query is not order-related
           - to: returns-agent
-            condition: "Customer wants to return an ordered item"
-
+            condition: Customer wants to return an ordered item
       - name: returns-agent
         kind: teammate
-        role: >-
-          Process returns and exchanges. Validate return eligibility, generate
-          return labels, and track return shipments.
+        role: Process returns and exchanges. Validate return eligibility, generate return labels, and track return shipments.
         model:
           provider: openai
           name: gpt-4o-mini
@@ -99,15 +66,12 @@ spec:
         contextIsolation: true
         handoffs:
           - to: triage-agent
-            condition: "Query is not returns-related"
+            condition: Query is not returns-related
           - to: billing-agent
-            condition: "Customer asks about refund timing or amount"
-
+            condition: Customer asks about refund timing or amount
       - name: billing-agent
         kind: teammate
-        role: >-
-          Handle billing and payment queries. Look up invoices, process
-          refunds, and answer payment-related questions.
+        role: Handle billing and payment queries. Look up invoices, process refunds, and answer payment-related questions.
         model:
           provider: openai
           name: gpt-4o-mini
@@ -118,8 +82,7 @@ spec:
         contextIsolation: true
         handoffs:
           - to: triage-agent
-            condition: "Query is not billing-related"
-
+            condition: Query is not billing-related
     taskList:
       coordination: assigned
       persistence: in-memory
@@ -130,7 +93,6 @@ spec:
       dependencyTracking: false
       waveExecution: false
       lockingStrategy: none
-
     communication:
       pattern: direct
       broadcastEnabled: false

package/examples/team-agent.ossa.yaml

@@ -1,34 +1,11 @@
-# OSSA v0.4.5 Example: Team Agent — Claude Code Lead-Teammate Team
-#
-# Demonstrates the lead-teammate pattern modeled after Claude Code Agent
-# Teams. An Opus lead orchestrates Sonnet workers and a Haiku explorer.
-# The lead operates in delegate mode (never implements directly), while
-# teammates self-claim tasks from a shared, file-backed task list with
-# dependency tracking and wave execution.
-#
-# Key characteristics:
-#   - Lead-teammate model with delegate mode
-#   - Shared task list with self-claim coordination
-#   - File-backed persistence with dependency tracking
-#   - Mailbox communication (async, inbox-based)
-#   - Mixed model tiers (Opus lead, Sonnet workers, Haiku explorer)
-#   - In-process deployment with fixed scaling
-
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: fullstack-dev-team
-  version: "1.0.0"
-  description: >-
-    A Claude Code-style development team for fullstack feature implementation.
-    An Opus lead decomposes tasks and coordinates three teammates: a backend
-    worker (Sonnet), a frontend worker (Sonnet), and a codebase explorer
-    (Haiku). Teammates self-claim tasks from a shared list, communicate via
-    mailbox, and work in isolated directories.
-
-  agentKind: team-lead
-  agentType: a2a
-
+  version: 1.0.0
+  description: 'A Claude Code-style development team for fullstack feature implementation. An Opus lead decomposes tasks and coordinates three teammates: a backend worker (Sonnet), a frontend worker (Sonnet), and a codebase explorer (Haiku). Teammates self-claim tasks from a shared list, communicate via mailbox, and work in isolated directories.'
+  agentKind: supervisor
+  agentType: custom
   agentArchitecture:
     pattern: lead-teammate
     capabilities:
@@ -47,43 +24,29 @@ metadata:
       conflictResolution: leader-decides
       taskPersistence: file-backed
       dependencyTracking: true
-
   labels:
     domain: development
     pattern: lead-teammate
     framework: claude-code
-
 spec:
-  role: >-
-    You are the lead of a fullstack development team. Your job is to:
-    1. Analyze the user's feature request and decompose it into tasks.
-    2. Create tasks in the shared task list with clear descriptions and
+  role: |-
+    You are the lead of a fullstack development team. Your job is to: 1. Analyze the user's feature request and decompose it into tasks. 2. Create tasks in the shared task list with clear descriptions and
        dependency relationships.
-    3. Monitor teammate progress and resolve blockers.
-    4. Synthesize completed work into a final deliverable.
-    You operate in delegate mode — you NEVER write code directly. Instead,
-    you coordinate your teammates who do the implementation work.
-
+    3. Monitor teammate progress and resolve blockers. 4. Synthesize completed work into a final deliverable. You operate in delegate mode — you NEVER write code directly. Instead, you coordinate your teammates who do the implementation work.
   llm:
     provider: anthropic
     model: claude-opus-4-20250514
     temperature: 0.4
     maxTokens: 8192
     profile: deep
-
   team:
     model: lead-teammate
     lead: lead
     delegateMode: true
-
     members:
       - name: backend-worker
         kind: teammate
-        role: >-
-          Implement backend features: API endpoints, database schemas,
-          business logic, and server-side tests. Work in the backend/
-          directory. Claim tasks from the shared list and mark them
-          complete when done.
+        role: 'Implement backend features: API endpoints, database schemas, business logic, and server-side tests. Work in the backend/ directory. Claim tasks from the shared list and mark them complete when done.'
         model:
           provider: anthropic
           name: claude-sonnet-4-20250514
@@ -95,13 +58,9 @@ spec:
           - glob
         contextIsolation: true
         workingDirectory: /backend
-
       - name: frontend-worker
         kind: teammate
-        role: >-
-          Implement frontend features: React components, API integration,
-          styling, and UI tests. Work in the frontend/ directory. Claim
-          tasks from the shared list and mark them complete when done.
+        role: 'Implement frontend features: React components, API integration, styling, and UI tests. Work in the frontend/ directory. Claim tasks from the shared list and mark them complete when done.'
         model:
           provider: anthropic
           name: claude-sonnet-4-20250514
@@ -113,13 +72,9 @@ spec:
           - glob
         contextIsolation: true
         workingDirectory: /frontend
-
       - name: codebase-explorer
         kind: researcher
-        role: >-
-          Explore the codebase to answer questions from the lead and other
-          teammates. Search for patterns, find dependencies, and analyze
-          architecture. Read-only — never modify files.
+        role: Explore the codebase to answer questions from the lead and other teammates. Search for patterns, find dependencies, and analyze architecture. Read-only — never modify files.
         model:
           provider: anthropic
           name: claude-haiku-4-5-20250514
@@ -129,7 +84,6 @@ spec:
           - glob
         contextIsolation: true
         workingDirectory: /
-
     taskList:
       coordination: self-claim
       persistence: file-backed
@@ -141,19 +95,16 @@ spec:
       dependencyTracking: true
       waveExecution: true
       lockingStrategy: file-lock
-
     communication:
       pattern: mailbox
       broadcastEnabled: false
-
     deployment:
       backend: in-process
       scaling: fixed
-
   constraints:
     cost:
       maxTokensPerDay: 2000000
-      maxCostPerDay: 100.00
+      maxCostPerDay: 100
       currency: USD
     performance:
       timeoutSeconds: 300

package/examples/team-lead-teammate.ossa.yaml

@@ -1,11 +1,11 @@
-apiVersion: ossa/v0.4
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: code-review-team
   version: 1.0.0
   description: Claude Code teams pattern - lead delegates to specialized reviewers
   agentType: claude
-  agentKind: team-lead
+  agentKind: supervisor
   agentArchitecture:
     pattern: lead-teammate
     capabilities:
@@ -21,9 +21,8 @@ metadata:
       taskPersistence: file-backed
       dependencyTracking: true
 spec:
-  role: >
-    You lead a code review team. Analyze pull requests and delegate
-    specific review tasks to specialized teammates.
+  role: |
+    You lead a code review team. Analyze pull requests and delegate specific review tasks to specialized teammates.
   llm:
     provider: anthropic
     model: claude-sonnet-4-5-20250514
@@ -34,9 +33,8 @@ spec:
     members:
       - name: lead-reviewer
         kind: team-lead
-        role: >
-          Senior code reviewer. Analyze PRs, break down review into tasks,
-          delegate to specialists, and synthesize final review.
+        role: |
+          Senior code reviewer. Analyze PRs, break down review into tasks, delegate to specialists, and synthesize final review.
         model: claude-sonnet-4-5-20250514
         tools:
           - read-file
@@ -44,9 +42,8 @@ spec:
           - git-diff
       - name: security-reviewer
         kind: specialist
-        role: >
-          Security vulnerability scanner. Check for OWASP top 10,
-          injection attacks, authentication flaws, and data exposure.
+        role: |
+          Security vulnerability scanner. Check for OWASP top 10, injection attacks, authentication flaws, and data exposure.
         tools:
           - sast-scan
           - dependency-check
@@ -54,18 +51,16 @@ spec:
         maxTokenBudget: 15000
       - name: style-checker
         kind: teammate
-        role: >
-          Code style and formatting reviewer. Verify adherence to
-          project conventions, naming, and documentation standards.
+        role: |
+          Code style and formatting reviewer. Verify adherence to project conventions, naming, and documentation standards.
         tools:
           - eslint
           - prettier
           - read-file
       - name: test-reviewer
         kind: teammate
-        role: >
-          Test coverage reviewer. Verify test adequacy, check edge cases,
-          and validate test assertions.
+        role: |
+          Test coverage reviewer. Verify test adequacy, check edge cases, and validate test assertions.
         tools:
           - run-tests
           - coverage-report