@bluefly/openstandardagents 0.4.8 → 0.5.0

package/examples/kagent/ossa-kagent-poc.ossa.yaml

@@ -1,8 +1,4 @@
-# OSSA-first POC: one manifest, export to kagent.dev (v1alpha2 Declarative)
-# Run: ossa export examples/kagent/ossa-kagent-poc.ossa.yaml --platform kagent --crd-version v1alpha2 -o ./poc-out
-# Deploy: kubectl apply -f poc-out/model-config.yaml; kubectl apply -f poc-out/agent.yaml
-# Invoke: kagent invoke --agent ossa-kagent-poc --task "List pods in kagent namespace"
-apiVersion: ossa/v0.4
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: ossa-kagent-poc
@@ -33,14 +29,4 @@ extensions:
         cpu: 500m
         memory: 512Mi
     a2aConfig:
-      skills:
-        - id: cluster-inspection
-          name: Cluster Inspection
-          description: List and inspect Kubernetes resources (pods, deployments, services)
-          inputModes: [text]
-          outputModes: [text]
-          tags: [k8s, ossa, poc]
-          examples:
-            - "List all pods in the kagent namespace"
-            - "What API resources are available in the cluster?"
-            - "Describe the kagent-controller deployment"
+      enabled: true

package/examples/pipeline-agent.ossa.yaml

@@ -1,4 +1,4 @@
-# OSSA v0.4.5 Example: Pipeline Agent — Data Processing Pipeline
+# OSSA v0.5.0 Example: Pipeline Agent — Data Processing Pipeline
 #
 # Demonstrates the pipeline pattern for sequential data processing. A
 # coordinator manages four team members arranged as sequential stages:
@@ -13,7 +13,7 @@
 #   - Assigned task coordination (coordinator assigns stage work)
 #   - Database-backed persistence for auditability
 
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5.0
 kind: Agent
 metadata:
   name: data-processing-pipeline
@@ -26,7 +26,7 @@ metadata:
     tools and model.
 
   agentKind: coordinator
-  agentType: workflow
+  agentType: claude
 
   agentArchitecture:
     pattern: pipeline

package/examples/platform-specific/claude-code-subagent.yaml

@@ -4,7 +4,7 @@ metadata:
   name: claude-code-explorer
   version: 1.0.0
   description: Specialized sub-agent for deep code exploration and codebase analysis
-  author: Bluefly Platform
+  author: Agent Platform
   tags:
     - claude-code
     - subagent

package/examples/platform-specific/cursor-coding-agent.yaml

@@ -4,7 +4,7 @@ metadata:
   name: cursor-coding-assistant
   version: 1.0.0
   description: AI coding assistant for Cursor IDE with advanced code generation and refactoring
-  author: Bluefly Platform
+  author: Agent Platform
   tags:
     - cursor
     - coding-assistant

package/examples/platform-specific/warp-terminal-agent.yaml

@@ -4,7 +4,7 @@ metadata:
   name: warp-dev-agent
   version: 1.0.0
   description: Development workflow agent for Warp Terminal
-  author: Bluefly Platform
+  author: Agent Platform
   tags:
     - warp
     - terminal

package/examples/production-ready/01-customer-support-bot/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: customer-support-bot
@@ -26,19 +26,16 @@ spec:
     - Clear and concise explanations
     - Proactive in offering solutions
     - Transparent about limitations
-
   llm:
     provider: openai
     model: gpt-4o
     temperature: 0.7
     maxTokens: 1500
-
   capabilities:
     - search_documentation
     - create_ticket
     - send_email
     - conversation_memory
-
   tools:
     - type: function
       name: search_docs
@@ -55,7 +52,6 @@ spec:
             default: 5
         required:
           - query
-
     - type: function
       name: create_ticket
       description: Create a support ticket for issues requiring human attention
@@ -70,7 +66,11 @@ spec:
             description: Detailed description of the issue
           priority:
             type: string
-            enum: [low, medium, high, urgent]
+            enum:
+              - low
+              - medium
+              - high
+              - urgent
             description: Priority level of the ticket
           category:
             type: string
@@ -79,7 +79,6 @@ spec:
           - title
           - description
           - priority
-
     - type: function
       name: send_email
       description: Send follow-up email to customer
@@ -98,12 +97,14 @@ spec:
           template:
             type: string
             description: Email template to use
-            enum: [follow_up, resolution, escalation]
+            enum:
+              - follow_up
+              - resolution
+              - escalation
         required:
           - to
           - subject
           - body
-
   autonomy:
     level: supervised
     approval_required: false
@@ -112,7 +113,6 @@ spec:
         action: notify_human
       - condition: ticket_count > 3
         action: escalate
-
   memory:
     enabled: true
     type: conversation_buffer
@@ -121,7 +121,6 @@ spec:
       enabled: true
       backend: redis
       ttl: 86400
-
   safety:
     input_filters:
       - type: pii_detection
@@ -132,8 +131,9 @@ spec:
       - type: hallucination_check
         threshold: 0.8
       - type: tone_analysis
-        required_sentiment: [positive, neutral]
-
+        required_sentiment:
+          - positive
+          - neutral
   observability:
     logging:
       level: info
@@ -150,23 +150,16 @@ spec:
     tracing:
       enabled: true
       provider: opentelemetry
-
 extensions:
   langchain:
-    agent_type: react
-    memory_type: conversation_buffer
-    chain_type: conversation
-    tools_mapping:
-      - ossa_capability: search_documentation
-        langchain_tool: search_docs
-        tool_class: CustomSearchTool
-      - ossa_capability: create_ticket
-        langchain_tool: create_ticket
-        tool_class: TicketingTool
-      - ossa_capability: send_email
-        langchain_tool: send_email
-        tool_class: EmailTool
-    export_config:
-      format: python
-      include_dependencies: true
-      output_file: customer_support_agent.py
+    enabled: true
+    chain_type: agent
+    memory:
+      type: buffer
+    tools:
+      - name: search_docs
+        description: Search the knowledge base for relevant documentation
+      - name: create_ticket
+        description: Create a support ticket for issues requiring human attention
+      - name: send_email
+        description: Send follow-up email to customer

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"