@bluefly/openstandardagents 0.3.6 → 0.4.1

package/examples/skills-example.ossa.yaml

@@ -0,0 +1,140 @@
+apiVersion: ossa/v0.4.1
+kind: Agent
+metadata:
+  name: research-agent
+  version: 1.0.0
+  description: Research agent with multiple Claude Skills
+  labels:
+    ossa.io/created-by: wizard-v2
+    ossa.io/schema-validated: "true"
+spec:
+  role: |
+    You are a research assistant that helps users gather information,
+    analyze data, and provide insights on various topics.
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-20250514
+    temperature: 0.7
+
+  # Claude Skills Configuration
+  skills:
+    - id: research-skill
+      name: Research Skill
+      description: Research topics and gather comprehensive information from multiple sources
+      instructions: |
+        You are a research assistant. When given a topic, you should:
+
+        Capabilities:
+        - Search for relevant information from reliable sources
+        - Synthesize findings into clear summaries
+        - Identify key insights and patterns
+        - Cite sources appropriately
+
+        Guidelines:
+        - Prioritize authoritative and recent sources
+        - Provide balanced perspectives
+        - Highlight uncertainties or contradictions
+        - Format findings clearly
+      type: task
+      parameters:
+        type: object
+        properties:
+          topic:
+            type: string
+            description: The research topic or question
+          depth:
+            type: string
+            description: Research depth level
+        required:
+          - topic
+
+    - id: data-analysis-skill
+      name: Data Analysis Skill
+      description: Analyze datasets and generate statistical insights
+      instructions: |
+        You are a data analyst. When given data, you should:
+
+        Capabilities:
+        - Perform statistical analysis
+        - Identify trends and patterns
+        - Create data visualizations
+        - Generate actionable insights
+
+        Guidelines:
+        - Use appropriate statistical methods
+        - Validate assumptions
+        - Explain findings clearly
+        - Recommend next steps
+      type: analysis
+      parameters:
+        type: object
+        properties:
+          data_format:
+            type: string
+            description: Format of input data (csv, json, etc.)
+          analysis_type:
+            type: string
+            description: Type of analysis to perform
+        required:
+          - data_format
+
+    - id: summary-skill
+      name: Summary Skill
+      description: Create concise summaries of long documents or articles
+      instructions: |
+        You are a summarization expert. When given content, you should:
+
+        Capabilities:
+        - Extract key points and main ideas
+        - Maintain context and accuracy
+        - Adapt length to requirements
+        - Preserve critical details
+
+        Guidelines:
+        - Focus on essential information
+        - Use clear, concise language
+        - Maintain original meaning
+        - Structure logically
+      type: creative
+      parameters:
+        type: object
+        properties:
+          content:
+            type: string
+            description: The content to summarize
+          max_length:
+            type: number
+            description: Maximum length of summary in words
+        required:
+          - content
+
+  tools:
+    - type: mcp
+      name: filesystem
+      description: File system access
+      config:
+        server: npx -y @modelcontextprotocol/server-filesystem
+
+    - type: http
+      name: web-search
+      description: Web search capabilities
+      endpoint: https://api.example.com/search
+
+  observability:
+    tracing:
+      enabled: true
+      exporter: otlp
+    metrics:
+      enabled: true
+      exporter: prometheus
+    logging:
+      level: info
+
+  safety:
+    content_filtering:
+      enabled: true
+      categories:
+        - hate_speech
+        - violence
+      action: block

package/examples/swarm/pso-optimizer.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3.6",
+  "apiVersion": "ossa/v0.4.1",
   "kind": "Agent",
   "metadata": {
     "name": "infrastructure-optimizer-swarm",

package/examples/tasks/batch-email-sender.yaml

@@ -1,6 +1,6 @@
 # Example: Batch Email Sender Task
 # A deterministic batch task that sends emails to multiple recipients
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Task
 metadata:
   name: batch-email-sender

package/examples/tasks/data-transform.yaml

@@ -1,6 +1,6 @@
 # Example: Data Transform Task
 # A pure function task that transforms data between formats
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Task
 metadata:
   name: data-transform

package/examples/tasks/publish-content.yaml

@@ -1,6 +1,6 @@
 # Example: Publish Content Task
 # A deterministic task that publishes content - no AI required
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Task
 metadata:
   name: publish-content

package/examples/templates/ossa-compliance.yaml

@@ -1,6 +1,6 @@
 # OSSA v0.1.9 Compliance Configuration for __ARCHIVE_REPORTS
 
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: 'ComplianceConfiguration'
 metadata:
   name: '__ARCHIVE_REPORTS-compliance'

package/examples/unified/security-scanner.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 metadata:
   name: security-scanner

package/examples/v0.3.6-features/genetics-breeding-advanced.ossa.yaml

@@ -18,7 +18,7 @@
 #   - Inbreeding analysis
 #   - Elite breeding strategies
 
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 
 metadata:

package/examples/v0.3.6-features/genetics-breeding-simple.ossa.yaml

@@ -15,7 +15,7 @@
 #   - Fitness evaluation
 #   - Breeding eligibility criteria
 
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 
 metadata:

package/examples/v0.3.6-features/genetics-fitness-scoring.ossa.yaml

@@ -19,7 +19,7 @@
 #   - Selection strategies (tournament, roulette, elite)
 #   - Pareto frontier analysis
 
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Agent
 
 metadata:

package/examples/vercel/edge-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3",
+  "apiVersion": "ossa/v0.4.1",
   "kind": "Agent",
   "metadata": {
     "name": "edge-chat-agent",

package/examples/workflows/batch-email-campaign.yaml

@@ -1,6 +1,6 @@
 # Example: Batch Email Campaign Workflow
 # Demonstrates loops, parallel execution, and batch processing
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Workflow
 metadata:
   name: batch-email-campaign

package/examples/workflows/content-review-publish.yaml

@@ -1,6 +1,6 @@
 # Example: Content Review and Publish Workflow
 # Demonstrates mixed Task + Agent composition
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Workflow
 metadata:
   name: content-review-publish

package/examples/workflows/simple-etl.yaml

@@ -1,6 +1,6 @@
 # Example: Simple ETL Workflow
 # Demonstrates sequential Tasks with data transformation
-apiVersion: ossa/v0.3.6
+apiVersion: ossa/v0.4.1
 kind: Workflow
 metadata:
   name: simple-etl

package/openapi/agent-crud.yaml

@@ -719,9 +719,9 @@ components:
           type: string
 
     AgentType:
-      $ref: '../schemas/common/agent.yaml#/components/schemas/AgentType'
+      $ref: './schemas/common/agent.yaml#/components/schemas/AgentType'
     AgentStatus:
-      $ref: '../schemas/common/agent.yaml#/components/schemas/AgentStatus'
+      $ref: './schemas/common/agent.yaml#/components/schemas/AgentStatus'
 
     AgentMetrics:
       type: object
@@ -745,7 +745,7 @@ components:
 
     # Error Schemas (RFC7807) - Using shared schema
     Problem:
-      $ref: '../schemas/common/errors.yaml#/components/schemas/Problem'
+      $ref: './schemas/common/errors.yaml#/components/schemas/Problem'
 
   responses:
     BadRequest:

package/openapi/agent-taxonomy.yaml

@@ -0,0 +1,323 @@
+openapi: 3.1.0
+info:
+  title: OSSA Agent Taxonomy API
+  version: 0.3.6
+  description: |
+    Agent classification and taxonomy system for OSSA v0.3.x.
+    Provides hierarchical categorization of agents by:
+    - Primary role (analyzer, executor, coordinator, reviewer)
+    - Domain expertise (devops, security, data, ml, etc.)
+    - Capability level (tier_1_read, tier_2_write, tier_3_full, tier_4_policy)
+    - Runtime environment (kubernetes, docker, serverless, local)
+
+servers:
+  - url: http://localhost:3000/api/v1
+    description: Local development
+
+paths:
+  /taxonomy/categories:
+    get:
+      summary: List all taxonomy categories
+      operationId: listTaxonomyCategories
+      tags: [Taxonomy]
+      responses:
+        '200':
+          description: List of taxonomy categories
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  categories:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/TaxonomyCategory'
+                  total:
+                    type: integer
+
+  /taxonomy/categories/{categoryId}:
+    get:
+      summary: Get category by ID
+      operationId: getTaxonomyCategory
+      tags: [Taxonomy]
+      parameters:
+        - name: categoryId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Taxonomy category details
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TaxonomyCategory'
+        '404':
+          description: Category not found
+
+    put:
+      summary: Update category
+      operationId: updateTaxonomyCategory
+      tags: [Taxonomy]
+      parameters:
+        - name: categoryId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TaxonomyCategoryInput'
+      responses:
+        '200':
+          description: Category updated
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TaxonomyCategory'
+
+    delete:
+      summary: Delete category
+      operationId: deleteTaxonomyCategory
+      tags: [Taxonomy]
+      parameters:
+        - name: categoryId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '204':
+          description: Category deleted
+        '404':
+          description: Category not found
+
+  /taxonomy/categories:
+    post:
+      summary: Create new category
+      operationId: createTaxonomyCategory
+      tags: [Taxonomy]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TaxonomyCategoryInput'
+      responses:
+        '201':
+          description: Category created
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TaxonomyCategory'
+
+  /taxonomy/classify:
+    post:
+      summary: Classify an agent manifest
+      operationId: classifyAgent
+      tags: [Taxonomy]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                manifest:
+                  type: object
+                  description: OSSA agent manifest to classify
+      responses:
+        '200':
+          description: Classification result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentClassification'
+
+  /taxonomy/validate:
+    post:
+      summary: Validate taxonomy assignment
+      operationId: validateTaxonomy
+      tags: [Taxonomy]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                categoryId:
+                  type: string
+                manifest:
+                  type: object
+      responses:
+        '200':
+          description: Validation result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ValidationResult'
+
+components:
+  schemas:
+    TaxonomyCategory:
+      type: object
+      required:
+        - id
+        - name
+        - type
+        - level
+        - created_at
+        - updated_at
+      properties:
+        id:
+          type: string
+          format: uuid
+          description: Unique category identifier
+        name:
+          type: string
+          description: Category name (e.g., "DevOps Automation", "Security Analysis")
+        description:
+          type: string
+          description: Category description
+        type:
+          type: string
+          enum: [role, domain, capability, runtime, custom]
+          description: Category type
+        level:
+          type: integer
+          minimum: 1
+          maximum: 5
+          description: Hierarchy level (1=top, 5=most specific)
+        parent_id:
+          type: string
+          format: uuid
+          nullable: true
+          description: Parent category ID for hierarchical taxonomy
+        metadata:
+          type: object
+          additionalProperties: true
+          description: Additional category metadata
+        tags:
+          type: array
+          items:
+            type: string
+          description: Category tags for search/filter
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+
+    TaxonomyCategoryInput:
+      type: object
+      required:
+        - name
+        - type
+        - level
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        type:
+          type: string
+          enum: [role, domain, capability, runtime, custom]
+        level:
+          type: integer
+          minimum: 1
+          maximum: 5
+        parent_id:
+          type: string
+          format: uuid
+          nullable: true
+        metadata:
+          type: object
+          additionalProperties: true
+        tags:
+          type: array
+          items:
+            type: string
+
+    AgentClassification:
+      type: object
+      required:
+        - agent_id
+        - classifications
+        - confidence
+      properties:
+        agent_id:
+          type: string
+          description: Agent identifier
+        classifications:
+          type: array
+          items:
+            type: object
+            properties:
+              category_id:
+                type: string
+                format: uuid
+              category_name:
+                type: string
+              confidence:
+                type: number
+                format: float
+                minimum: 0
+                maximum: 1
+              reason:
+                type: string
+        confidence:
+          type: number
+          format: float
+          minimum: 0
+          maximum: 1
+          description: Overall classification confidence
+        suggested_categories:
+          type: array
+          items:
+            type: string
+          description: Suggested categories based on manifest analysis
+
+    ValidationResult:
+      type: object
+      required:
+        - valid
+        - category_id
+      properties:
+        valid:
+          type: boolean
+          description: Whether taxonomy assignment is valid
+        category_id:
+          type: string
+          format: uuid
+        errors:
+          type: array
+          items:
+            type: object
+            properties:
+              field:
+                type: string
+              message:
+                type: string
+              severity:
+                type: string
+                enum: [error, warning, info]
+        warnings:
+          type: array
+          items:
+            type: object
+            properties:
+              field:
+                type: string
+              message:
+                type: string
+        recommendations:
+          type: array
+          items:
+            type: string
+          description: Recommendations for improving taxonomy fit