@bluefly/openstandardagents 0.3.2 → 0.3.3

package/spec/v0.3.2/extensions/drupal.md

@@ -1,4 +1,4 @@
-# Drupal Extension for OSSA v0.3.1
+# Drupal Extension for OSSA v0.3.3
 
 ## Overview
 
@@ -133,7 +133,7 @@ extensions:
 An agent that generates content autonomously without user context:
 
 ```yaml
-apiVersion: ossa/v0.3.1
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: content-writer
@@ -168,7 +168,7 @@ extensions:
 An agent that reviews user-submitted content with merged permissions:
 
 ```yaml
-apiVersion: ossa/v0.3.1
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: content-reviewer
@@ -195,7 +195,7 @@ extensions:
 An agent integrated into ECA (Events-Conditions-Actions) module:
 
 ```yaml
-apiVersion: ossa/v0.3.1
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: moderation-assistant
@@ -397,7 +397,7 @@ dependencies:
 id: content_writer
 label: Content Writer
 manifest: |
-  apiVersion: ossa/v0.3.1
+  apiVersion: ossa/v0.3.3
   kind: Agent
   # ... full manifest ...
 ```

package/spec/v0.3.2/infrastructure/service-ports.yaml

@@ -7,7 +7,7 @@
 # NOTE: This is a reference configuration, not an OSSA manifest.
 # It documents recommended port allocations for infrastructure guidance.
 #
-# @see https://openstandardagents.org/spec/v0.3.2/infrastructure
+# @see https://openstandardagents.org/spec/v0.3.3/infrastructure
 # ============================================================================
 
 # Configuration metadata

package/spec/v0.3.2/ossa-0.3.2.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://openstandardagents.org/schemas/v0.3.2/manifest.json",
-  "title": "OSSA v0.3.2 Manifest Schema",
-  "description": "Open Standard for Scalable AI Agents (OSSA) v0.3.2 - Unified Task Schema with Access Tiers & Separation of Duties. Supports Agent (agentic loops with LLM), Task (deterministic workflow steps), and Workflow (composition of Tasks and Agents) kinds. Includes Agent-to-Agent Messaging Extension and Access Control Tiers for privilege separation.",
+  "$id": "https://openstandardagents.org/schemas/v0.3.3/manifest.json",
+  "title": "OSSA v0.3.3 Manifest Schema",
+  "description": "Open Standard for Scalable AI Agents (OSSA) v0.3.3 - Unified Task Schema with Access Tiers & Separation of Duties. Supports Agent (agentic loops with LLM), Task (deterministic workflow steps), and Workflow (composition of Tasks and Agents) kinds. Includes Agent-to-Agent Messaging Extension and Access Control Tiers for privilege separation.",
   "type": "object",
   "required": [
     "apiVersion",
@@ -13,9 +13,9 @@
     "apiVersion": {
       "type": "string",
       "pattern": "^ossa/v(0\\.3\\.[0-9]+(-[a-zA-Z0-9]+)?|0\\.2\\.[2-9](-dev)?|1)(\\.[0-9]+)?(-[a-zA-Z0-9]+)?$",
-      "description": "OSSA API version (v0.3.2+ supports Task and Workflow kinds)",
+      "description": "OSSA API version (v0.3.3+ supports Task and Workflow kinds)",
       "examples": [
-        "ossa/v0.3.2",
+        "ossa/v0.3.3",
         "ossa/v1",
         "ossa/v0.2.9"
       ]
@@ -41,6 +41,9 @@
       "properties": {
         "mcp": {
           "$ref": "#/definitions/MCPExtension"
+        },
+        "skills": {
+          "$ref": "#/definitions/SkillsExtension"
         }
       },
       "additionalProperties": true
@@ -112,7 +115,7 @@
   "definitions": {
     "AccessTier": {
       "type": "object",
-      "description": "Access tier configuration for separation of duties (v0.3.2+). Defines privilege levels and role separations for agents.",
+      "description": "Access tier configuration for separation of duties (v0.3.3+). Defines privilege levels and role separations for agents.",
       "required": ["tier"],
       "properties": {
         "tier": {
@@ -286,7 +289,7 @@
     },
     "TaxonomyClassification": {
       "type": "object",
-      "description": "Hierarchical taxonomy classification for agents (v0.3.2+). Links to taxonomy.yaml spec.",
+      "description": "Hierarchical taxonomy classification for agents (v0.3.3+). Links to taxonomy.yaml spec.",
       "required": ["domain"],
       "properties": {
         "domain": {
@@ -954,7 +957,7 @@
         },
         "messaging": {
           "$ref": "#/definitions/MessagingExtension",
-          "description": "Agent-to-agent messaging configuration (v0.3.2+)"
+          "description": "Agent-to-agent messaging configuration (v0.3.3+)"
         },
         "functions": {
           "type": "array",
@@ -965,28 +968,28 @@
         },
         "identity": {
           "$ref": "#/definitions/AgentIdentity",
-          "description": "Agent identity configuration including service accounts, authentication, and observability (v0.3.2+)"
+          "description": "Agent identity configuration including service accounts, authentication, and observability (v0.3.3+)"
         },
         "access": {
           "$ref": "#/definitions/AccessTier",
-          "description": "Access tier configuration for separation of duties (v0.3.2+). Defines privilege level and allowed operations."
+          "description": "Access tier configuration for separation of duties (v0.3.3+). Defines privilege level and allowed operations."
         },
         "separation": {
           "$ref": "#/definitions/SeparationOfDuties",
-          "description": "Role separation configuration to prevent conflicts of interest (v0.3.2+)"
+          "description": "Role separation configuration to prevent conflicts of interest (v0.3.3+)"
         },
         "delegation": {
           "$ref": "#/definitions/DelegationConfig",
-          "description": "Delegation configuration for multi-agent hierarchies (v0.3.2+)"
+          "description": "Delegation configuration for multi-agent hierarchies (v0.3.3+)"
         },
         "type": {
           "type": "string",
           "enum": ["analyzer", "worker", "operator", "supervisor", "orchestrator", "governor", "specialist", "critic"],
-          "description": "Agent type classification aligned with access tiers (v0.3.2+)"
+          "description": "Agent type classification aligned with access tiers (v0.3.3+)"
         },
         "taxonomy": {
           "$ref": "#/definitions/TaxonomyClassification",
-          "description": "Taxonomy classification for domain and cross-cutting concerns (v0.3.2+)"
+          "description": "Taxonomy classification for domain and cross-cutting concerns (v0.3.3+)"
         },
         "compliance": {
           "type": "object",
@@ -2591,6 +2594,74 @@
       },
       "additionalProperties": false
     },
+    "SkillsExtension": {
+      "type": "object",
+      "description": "Anthropic/AgentSkills.io compatibility extension - enables OSSA agents to be packaged as Skills",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Enable Skills format export/import for this agent"
+        },
+        "allowedTools": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Pre-approved tools list (maps to spec.capabilities). Matches Skills allowed-tools field."
+        },
+        "platforms": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "examples": ["Claude", "Claude Code", "Cursor", "Kiro"]
+          },
+          "description": "Compatible AI platforms/environments"
+        },
+        "license": {
+          "type": "string",
+          "description": "License for the skill (e.g., Apache-2.0, MIT, GPL-2.0-or-later)"
+        },
+        "progressiveDisclosure": {
+          "type": "object",
+          "description": "Token budget for progressive disclosure stages",
+          "properties": {
+            "metadataTokens": {
+              "type": "integer",
+              "default": 100,
+              "description": "Max tokens for metadata stage (name + description)"
+            },
+            "instructionsTokens": {
+              "type": "integer",
+              "default": 5000,
+              "description": "Max tokens for instructions stage (full SKILL.md body)"
+            }
+          }
+        },
+        "directories": {
+          "type": "object",
+          "description": "Skills directory structure mapping",
+          "properties": {
+            "scripts": {
+              "type": "string",
+              "default": "scripts/",
+              "description": "Path to executable scripts"
+            },
+            "references": {
+              "type": "string",
+              "default": "references/",
+              "description": "Path to on-demand documentation"
+            },
+            "assets": {
+              "type": "string",
+              "default": "assets/",
+              "description": "Path to static resources"
+            }
+          }
+        }
+      },
+      "additionalProperties": true
+    },
     "MCPTool": {
       "type": "object",
       "description": "MCP tool definition - actions/functions the agent can invoke",
@@ -2706,7 +2777,7 @@
     },
     "MessagingExtension": {
       "type": "object",
-      "description": "Agent-to-agent messaging configuration (v0.3.2+)",
+      "description": "Agent-to-agent messaging configuration (v0.3.3+)",
       "properties": {
         "publishes": {
           "type": "array",

package/spec/v0.3.2/protocols/delegation.yaml

@@ -7,7 +7,7 @@
 # NOTE: This is a reference specification, not an OSSA manifest.
 # It documents the delegation protocol for implementation guidance.
 #
-# @see https://openstandardagents.org/spec/v0.3.2/access-tiers
+# @see https://openstandardagents.org/spec/v0.3.3/access-tiers
 # ============================================================================
 
 # Specification metadata

package/spec/v0.3.2/protocols/websocket.md

@@ -18,7 +18,7 @@ ws.onopen = () => {
     type: 'register',
     agentId: 'agent://example.com/my-agent',
     capabilities: ['process_data', 'analyze_content'],
-    version: 'ossa/v0.3.1'
+    version: 'ossa/v0.3.3'
   }));
 };
 ```
@@ -352,7 +352,7 @@ ws.send(JSON.stringify({
 
 - WebSocket protocol version: RFC 6455
 - Minimum TLS version: 1.2
-- Supported subprotocols: `ossa.v0.3.1`
+- Supported subprotocols: `ossa.v0.3.3`
 - JSON payload encoding: UTF-8
 
 ## References

package/spec/v0.3.2/runtime/RUNTIME.md

@@ -1,4 +1,4 @@
-# OSSA v0.3.2 Runtime Specification
+# OSSA v0.3.3 Runtime Specification
 
 This document provides human-readable documentation for the OSSA Agent Runtime Specification, which defines how agents execute, communicate, and manage state.
 
@@ -393,7 +393,7 @@ All memory providers MUST implement these operations:
 ## Example Configuration
 
 ```yaml
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: RuntimeSpec
 
 lifecycle:
@@ -454,4 +454,4 @@ network_isolation:
 
 | Version | Date | Changes |
 |---------|------|---------|
-| 0.3.2 | 2024-01 | Initial runtime specification with lifecycle, control signals, execution model, network isolation, and memory model |
+| 0.3.3 | 2024-01 | Initial runtime specification with lifecycle, control signals, execution model, network isolation, and memory model |

package/spec/v0.3.2/runtime/memory-model.yaml

@@ -1,4 +1,4 @@
-# OSSA v0.3.2 - Agent Memory Model Specification
+# OSSA v0.3.3 - Agent Memory Model Specification
 # Defines memory types, providers, and interfaces for agent state management
 #
 # Related schemas:
@@ -6,7 +6,7 @@
 #   - ../schemas/agent-unified.yaml (agent specification)
 
 $schema: http://json-schema.org/draft-07/schema#
-$id: https://openstandardagents.org/schemas/v0.3.2/runtime/memory-model.yaml
+$id: https://openstandardagents.org/schemas/v0.3.3/runtime/memory-model.yaml
 
 title: OSSA Agent Memory Model
 description: |
@@ -26,7 +26,7 @@ required:
 properties:
   apiVersion:
     type: string
-    const: ossa/v0.3.2
+    const: ossa/v0.3.3
     description: Memory model specification version
 
   kind:
@@ -819,7 +819,7 @@ definitions:
         description: Whether operation is asynchronous
 
 examples:
-  - apiVersion: ossa/v0.3.2
+  - apiVersion: ossa/v0.3.3
     kind: MemoryModel
     short_term:
       enabled: true

package/spec/v0.3.2/runtime/runtime.yaml

@@ -1,4 +1,4 @@
-# OSSA v0.3.2 - Agent Runtime Specification
+# OSSA v0.3.3 - Agent Runtime Specification
 # Defines agent lifecycle, control signals, execution model, and network isolation
 #
 # Related schemas:
@@ -6,7 +6,7 @@
 #   - ./memory-model.yaml (memory provider interface)
 
 $schema: http://json-schema.org/draft-07/schema#
-$id: https://openstandardagents.org/schemas/v0.3.2/runtime/runtime.yaml
+$id: https://openstandardagents.org/schemas/v0.3.3/runtime/runtime.yaml
 
 title: OSSA Agent Runtime Specification
 description: |
@@ -25,7 +25,7 @@ required:
 properties:
   apiVersion:
     type: string
-    const: ossa/v0.3.2
+    const: ossa/v0.3.3
     description: Runtime specification version
 
   kind:
@@ -852,7 +852,7 @@ definitions:
                 type: integer
 
 examples:
-  - apiVersion: ossa/v0.3.2
+  - apiVersion: ossa/v0.3.3
     kind: RuntimeSpec
     lifecycle:
       phases:

package/spec/v0.3.2/schemas/agent-unified.yaml

@@ -1,8 +1,8 @@
-# OSSA v0.3.1 - Unified Agent Schema
+# OSSA v0.3.3 - Unified Agent Schema
 # Universal agent platform: OSSA + GitLab Duo + Google A2A + MCP
 # Zero hardcoded models, runtime-agnostic, infrastructure-driven
 
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Agent
 
 metadata:

package/spec/v0.3.2/schemas/capabilities.yaml

@@ -1,8 +1,8 @@
-# OSSA v0.3.1 - Capabilities Schema
+# OSSA v0.3.3 - Capabilities Schema
 # Google A2A and GitLab Duo compatible capability declarations
 
 $schema: http://json-schema.org/draft-07/schema#
-$id: https://openstandardagents.org/schemas/v0.3.1/capabilities.yaml
+$id: https://openstandardagents.org/schemas/v0.3.3/capabilities.yaml
 
 title: Agent Capabilities
 description: |

package/spec/v0.3.2/schemas/functions.yaml

@@ -1,8 +1,8 @@
-# OSSA v0.3.1 - Functions Schema
+# OSSA v0.3.3 - Functions Schema
 # Google A2A compatible function declarations (OpenAI function calling format)
 
 $schema: http://json-schema.org/draft-07/schema#
-$id: https://openstandardagents.org/schemas/v0.3.1/functions.yaml
+$id: https://openstandardagents.org/schemas/v0.3.3/functions.yaml
 
 title: Agent Functions
 description: |

package/spec/v0.3.2/schemas/messaging/channel.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://openstandardagents.org/schemas/v0.3.1/messaging/channel.json",
+  "$id": "https://openstandardagents.org/schemas/v0.3.3/messaging/channel.json",
   "title": "OSSA Channel Schema",
-  "description": "Schema for message channel configuration in OSSA v0.3.1",
+  "description": "Schema for message channel configuration in OSSA v0.3.3",
   "type": "object",
   "required": [
     "name",

package/spec/v0.3.2/schemas/messaging/delivery-receipt.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://openstandardagents.org/schemas/v0.3.1/messaging/delivery-receipt.json",
+  "$id": "https://openstandardagents.org/schemas/v0.3.3/messaging/delivery-receipt.json",
   "title": "OSSA Delivery Receipt Schema",
-  "description": "Schema for message delivery receipts in OSSA v0.3.1",
+  "description": "Schema for message delivery receipts in OSSA v0.3.3",
   "type": "object",
   "required": [
     "messageId",

package/spec/v0.3.2/schemas/messaging/message.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://openstandardagents.org/schemas/v0.3.1/messaging/message.json",
+  "$id": "https://openstandardagents.org/schemas/v0.3.3/messaging/message.json",
   "title": "OSSA Message Schema",
-  "description": "Schema for Agent-to-Agent messages in OSSA v0.3.1",
+  "description": "Schema for Agent-to-Agent messages in OSSA v0.3.3",
   "type": "object",
   "required": [
     "id",
@@ -141,7 +141,7 @@
           "examples": [
             {
               "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
-              "user-agent": "OSSA/0.3.1"
+              "user-agent": "OSSA/0.3.3"
             }
           ]
         }

package/spec/v0.3.2/schemas/messaging/subscription.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://openstandardagents.org/schemas/v0.3.1/messaging/subscription.json",
+  "$id": "https://openstandardagents.org/schemas/v0.3.3/messaging/subscription.json",
   "title": "OSSA Subscription Schema",
-  "description": "Schema for agent message subscriptions in OSSA v0.3.1",
+  "description": "Schema for agent message subscriptions in OSSA v0.3.3",
   "type": "object",
   "required": [
     "channel",

package/spec/v0.3.2/schemas/runtime.yaml

@@ -1,8 +1,8 @@
-# OSSA v0.3.1 - Runtime Declaration Schema
+# OSSA v0.3.3 - Runtime Declaration Schema
 # Multi-runtime compatibility: Google A2A, GitLab Duo, OSSA Mesh, MCP
 
 $schema: http://json-schema.org/draft-07/schema#
-$id: https://openstandardagents.org/schemas/v0.3.1/runtime.yaml
+$id: https://openstandardagents.org/schemas/v0.3.3/runtime.yaml
 
 title: Agent Runtime Declaration
 description: |

package/spec/v0.3.2/schemas/taxonomy.yaml

@@ -1,12 +1,12 @@
-# OSSA Agent Taxonomy Schema v0.3.1
+# OSSA Agent Taxonomy Schema v0.3.3
 # Comprehensive hierarchical classification for AI agents
 # Aligned with OSSA spec roles, multi-agent patterns, and industry standards
 
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Taxonomy
 metadata:
   name: agent-taxonomy
-  version: "0.3.1"
+  version: "0.3.3"
   description: |
     Formal agent taxonomy with hierarchical domains, cross-cutting capabilities,
     autonomy levels, and multi-agent orchestration patterns. Designed for

package/spec/v0.3.2/schemas/unified-llm.yaml

@@ -1,9 +1,9 @@
-# OSSA v0.3.1 - Unified LLM Configuration Schema
+# OSSA v0.3.3 - Unified LLM Configuration Schema
 # Compatible with: OSSA, GitLab Duo, Google A2A, MCP
 # Zero hardcoded models, runtime-configurable, multi-provider
 
 $schema: http://json-schema.org/draft-07/schema#
-$id: https://openstandardagents.org/schemas/v0.3.1/unified-llm.yaml
+$id: https://openstandardagents.org/schemas/v0.3.3/unified-llm.yaml
 
 title: Unified LLM Configuration
 description: |

package/spec/v0.3.2/taxonomy.yaml

@@ -1,5 +1,5 @@
 # =============================================================================
-# OSSA v0.3.2 - Agent Taxonomy Specification
+# OSSA v0.3.3 - Agent Taxonomy Specification
 # =============================================================================
 # Hierarchical classification system for agents with cross-cutting concerns
 # Now includes access tier integration for separation of duties
@@ -8,7 +8,7 @@
 #   - https://gitlab.com/blueflyio/openstandardagents/-/issues/363 (separation of duties)
 # =============================================================================
 
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: TaxonomySpec
 version: "2.0.0"
 

package/spec/v0.3.3/MIGRATION-v0.3.2-to-v0.3.3.md

@@ -0,0 +1,117 @@
+# Migration Guide: OSSA v0.3.2 → v0.3.3
+
+> **Status**: Draft
+> **Last Updated**: 2025-12-31
+
+---
+
+## Overview
+
+OSSA v0.3.3 introduces **Skills Compatibility Extension** for interoperability with Anthropic Skills and AgentSkills.io specifications.
+
+### Key Changes
+
+- ✅ **Backward Compatible**: v0.3.2 manifests validate against v0.3.3 schema
+- ✅ **Skills Extension**: New `extensions.skills` for bidirectional Skills format support
+- ✅ **Progressive Disclosure**: Token-budgeted metadata → instructions → resources pattern
+
+---
+
+## Migration Path
+
+### Option 1: No Changes Required (Recommended for Existing Agents)
+
+**v0.3.2 agents continue to work without modification:**
+
+```yaml
+apiVersion: ossa/v0.3.2
+kind: Agent
+metadata:
+  name: my-agent
+  version: 1.0.0
+# ... rest of manifest unchanged
+```
+
+### Option 2: Add Skills Compatibility
+
+**Enable Skills format export/import:**
+
+```yaml
+apiVersion: ossa/v0.3.3
+kind: Agent
+metadata:
+  name: my-skill-compatible-agent
+  version: 1.0.0
+  description: Agent with Skills compatibility
+spec:
+  # ... existing spec
+extensions:
+  skills:
+    enabled: true
+    platforms:
+      - Claude
+      - Claude Code
+      - Cursor
+    allowedTools:
+      - Read
+      - Write
+      - Bash
+    progressiveDisclosure:
+      metadataTokens: 100
+      instructionsTokens: 5000
+```
+
+---
+
+## New Features in v0.3.3
+
+### Skills Extension
+
+The Skills extension enables OSSA agents to be packaged and distributed as Skills, and allows Skills to be consumed by OSSA-compliant runtimes.
+
+**Key Properties:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `enabled` | boolean | Enable Skills format export/import |
+| `platforms` | string[] | Compatible platforms (Claude, Cursor, etc.) |
+| `allowedTools` | string[] | Pre-approved tools list |
+| `progressiveDisclosure` | object | Token budgets for disclosure stages |
+| `directories` | object | Skills directory structure mapping |
+
+**CLI Commands:**
+
+```bash
+# Export OSSA manifest to Skills format
+ossa export --format skills --output ./my-skill/
+
+# Import Skills into OSSA
+ossa import --format skills --path ./my-skill/
+```
+
+---
+
+## Schema Changes
+
+### Added Definitions
+
+- `SkillsExtension`: Full Skills compatibility configuration
+
+### Extensions Object
+
+```json
+{
+  "extensions": {
+    "mcp": { "$ref": "#/definitions/MCPExtension" },
+    "skills": { "$ref": "#/definitions/SkillsExtension" }
+  }
+}
+```
+
+---
+
+## References
+
+- [Skills Compatibility Extension](../extensions/skills-compatibility.md)
+- [Anthropic Skills Repository](https://github.com/anthropics/skills)
+- [AgentSkills.io Specification](https://agentskills.io/specification)

package/spec/{v0.3.0 → v0.3.3}/UNIFIED-SCHEMA.md

@@ -1,4 +1,4 @@
-# OSSA v0.3.0 - Unified Agent Schema
+# OSSA v0.3.3 - Unified Agent Schema
 
 ## The Rocketship 🚀
 
@@ -13,7 +13,7 @@ llm:
   model: claude-sonnet-4-20250514
 ```
 
-**After (v0.3.0):**
+**After (v0.3.3):**
 ```yaml
 llm:
   provider: ${LLM_PROVIDER:-anthropic}
@@ -35,7 +35,7 @@ llm:
 
 ### Compatibility Matrix
 
-| Feature | OSSA v0.2.x | Duo | A2A | v0.3.0 |
+| Feature | OSSA v0.2.x | Duo | A2A | v0.3.3 |
 |---------|-------------|-----|-----|--------|
 | Runtime-configurable models | ❌ | ❌ | ✅ | ✅ |
 | Execution profiles | ❌ | ❌ | ✅ | ✅ |