@bluefly/openstandardagents 0.4.9 → 0.5.1

package/examples/production-ready/05-sales-assistant/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: sales-assistant
@@ -19,20 +19,17 @@ spec:
     - Automated follow-up communication
     - Meeting scheduling and coordination
     - Sales pipeline management
-
   llm:
     provider: openai
     model: gpt-4o
     temperature: 0.7
     maxTokens: 1500
-
   capabilities:
     - search_crm
     - create_lead
     - send_followup
     - schedule_meeting
     - update_pipeline
-
   tools:
     - type: function
       name: search_crm
@@ -51,7 +48,6 @@ spec:
                 type: string
               revenue_range:
                 type: string
-
     - type: function
       name: create_lead
       description: Create new lead in CRM
@@ -73,7 +69,6 @@ spec:
         required:
           - name
           - email
-
     - type: function
       name: send_followup
       description: Send automated follow-up email
@@ -84,13 +79,16 @@ spec:
             type: string
           template:
             type: string
-            enum: [intro, demo_followup, pricing, closing]
+            enum:
+              - intro
+              - demo_followup
+              - pricing
+              - closing
           personalization:
             type: object
         required:
           - leadId
           - template
-
     - type: function
       name: schedule_meeting
       description: Schedule meeting with lead
@@ -101,7 +99,11 @@ spec:
             type: string
           meetingType:
             type: string
-            enum: [discovery, demo, negotiation, closing]
+            enum:
+              - discovery
+              - demo
+              - negotiation
+              - closing
           duration:
             type: integer
           suggestedTimes:
@@ -112,16 +114,23 @@ spec:
         required:
           - leadId
           - meetingType
-
   memory:
     enabled: true
     type: entity_memory
     entities:
       - type: lead
-        fields: [name, company, status, last_contact, notes]
+        fields:
+          - name
+          - company
+          - status
+          - last_contact
+          - notes
       - type: interaction
-        fields: [date, type, summary, outcome]
-
+        fields:
+          - date
+          - type
+          - summary
+          - outcome
   observability:
     logging:
       level: info
@@ -132,15 +141,18 @@ spec:
         - emails_sent
         - meetings_scheduled
         - conversion_rate
-
 extensions:
   langchain:
-    agent_type: react
-    memory_type: entity
-    tools_mapping:
-      - ossa_capability: search_crm
-        langchain_tool: crm_search
-      - ossa_capability: create_lead
-        langchain_tool: create_lead
-      - ossa_capability: send_followup
-        langchain_tool: send_email
+    enabled: true
+    chain_type: agent
+    memory:
+      type: vector
+    tools:
+      - name: search_crm
+        description: Search CRM for contacts and accounts
+      - name: create_lead
+        description: Create new lead in CRM
+      - name: send_followup
+        description: Send automated follow-up email
+      - name: schedule_meeting
+        description: Schedule meeting with lead

package/examples/production-ready/07-research-assistant/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: research-assistant
@@ -19,19 +19,16 @@ spec:
     - Citation management
     - Research question formulation
     - Methodology analysis
-
   llm:
     provider: anthropic
     model: claude-sonnet-4-20250514
     temperature: 0.5
     maxTokens: 4000
-
   capabilities:
     - search_papers
     - summarize_paper
     - generate_citations
     - compare_studies
-
   tools:
     - type: function
       name: search_papers
@@ -45,7 +42,11 @@ spec:
             type: array
             items:
               type: string
-              enum: [pubmed, arxiv, semantic_scholar, google_scholar]
+              enum:
+                - pubmed
+                - arxiv
+                - semantic_scholar
+                - google_scholar
           filters:
             type: object
             properties:
@@ -57,7 +58,6 @@ spec:
                 type: number
         required:
           - query
-
     - type: function
       name: summarize_paper
       description: Generate structured summary of research paper
@@ -68,10 +68,13 @@ spec:
             type: string
           summaryType:
             type: string
-            enum: [abstract, full, methodology, findings]
+            enum:
+              - abstract
+              - full
+              - methodology
+              - findings
         required:
           - paperId
-
     - type: function
       name: generate_citations
       description: Generate citations in various formats
@@ -84,11 +87,14 @@ spec:
               type: string
           format:
             type: string
-            enum: [apa, mla, chicago, bibtex]
+            enum:
+              - apa
+              - mla
+              - chicago
+              - bibtex
         required:
           - papers
           - format
-
   memory:
     enabled: true
     type: summary_memory
@@ -97,7 +103,6 @@ spec:
       summary_prompt: |
         Summarize the key research topics, papers discussed,
         and important findings from this session.
-
   observability:
     logging:
       level: info
@@ -107,13 +112,16 @@ spec:
         - papers_searched
         - summaries_generated
         - citations_created
-
 extensions:
   langchain:
-    agent_type: react
-    memory_type: summary
-    tools_mapping:
-      - ossa_capability: search_papers
-        langchain_tool: academic_search
-      - ossa_capability: summarize_paper
-        langchain_tool: paper_summarizer
+    enabled: true
+    chain_type: agent
+    memory:
+      type: summary
+    tools:
+      - name: search_papers
+        description: Search academic papers and publications
+      - name: summarize_paper
+        description: Generate structured summary of research paper
+      - name: generate_citations
+        description: Generate citations in various formats

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