@bluefly/openstandardagents 0.3.2 → 0.3.5

package/openapi/schemas/common/pagination.yaml

@@ -0,0 +1,72 @@
+openapi: 3.1.0
+components:
+  schemas:
+    Pagination:
+      type: object
+      required:
+        - page
+        - limit
+        - total
+        - total_pages
+      properties:
+        page:
+          type: integer
+          minimum: 1
+        limit:
+          type: integer
+          minimum: 1
+        total:
+          type: integer
+          minimum: 0
+        total_pages:
+          type: integer
+          minimum: 0
+        has_next:
+          type: boolean
+        has_prev:
+          type: boolean
+
+  parameters:
+    PageParam:
+      name: page
+      in: query
+      schema:
+        type: integer
+        minimum: 1
+        default: 1
+      description: Page number
+
+    LimitParam:
+      name: limit
+      in: query
+      schema:
+        type: integer
+        minimum: 1
+        maximum: 100
+        default: 20
+      description: Items per page
+
+    OffsetParam:
+      name: offset
+      in: query
+      schema:
+        type: integer
+        minimum: 0
+        default: 0
+      description: Number of items to skip for pagination
+
+    SearchParam:
+      name: search
+      in: query
+      schema:
+        type: string
+      description: Search query
+
+    SortParam:
+      name: sort
+      in: query
+      schema:
+        type: string
+        enum: [name, downloads, updated, created]
+        default: downloads
+      description: Sort field

package/openapi/schemas/common/security.yaml

@@ -0,0 +1,88 @@
+openapi: 3.1.0
+components:
+  securitySchemes:
+    ApiKeyAuth:
+      type: apiKey
+      in: header
+      name: X-API-Key
+      description: API key for server-to-server authentication
+
+    BearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: JWT token obtained from authentication endpoint
+
+    OAuth2:
+      type: oauth2
+      description: OAuth2 authorization code flow
+      flows:
+        authorizationCode:
+          authorizationUrl: https://auth.llm.bluefly.io/oauth/authorize
+          tokenUrl: https://auth.llm.bluefly.io/oauth/token
+          scopes:
+            read: Read access to resources
+            write: Write access to resources
+            execute: Execute agent tasks and workflows
+            admin: Administrative access
+            messaging: Agent-to-agent messaging
+
+    AgentMTLS:
+      type: mutualTLS
+      description: Mutual TLS for agent-to-agent communication
+
+  schemas:
+    TokenResponse:
+      type: object
+      properties:
+        access_token:
+          type: string
+        token_type:
+          type: string
+          default: Bearer
+        expires_in:
+          type: integer
+        scope:
+          type: array
+          items:
+            type: string
+        instance_id:
+          type: string
+          format: uuid
+        issued_at:
+          type: string
+          format: date-time
+        token_id:
+          type: string
+          format: uuid
+
+    SecurityContext:
+      type: object
+      properties:
+        authenticated:
+          type: boolean
+        principal:
+          type: object
+          properties:
+            agent_id:
+              type: string
+            instance_id:
+              type: string
+              format: uuid
+            tenant_id:
+              type: string
+            user_id:
+              type: string
+        scopes:
+          type: array
+          items:
+            type: string
+        permissions:
+          type: object
+          properties:
+            resources:
+              type: array
+              items:
+                type: object
+            policy_version:
+              type: string

package/openapi/schemas/index.yaml

@@ -0,0 +1,88 @@
+openapi: 3.1.0
+info:
+  title: OSSA Shared Schemas Index
+  version: 0.3.3
+  description: |
+    Central index for all shared OpenAPI schemas.
+    Import these schemas using $ref in your OpenAPI specs.
+
+    Usage:
+      $ref: '../schemas/common/agent.yaml#/components/schemas/AgentManifest'
+      $ref: '../schemas/common/errors.yaml#/components/schemas/Problem'
+      $ref: '../schemas/common/pagination.yaml#/components/schemas/Pagination'
+
+components:
+  schemas:
+    # Agent Schemas
+    AgentManifest:
+      $ref: './common/agent.yaml#/components/schemas/AgentManifest'
+    AgentSpec:
+      $ref: './common/agent.yaml#/components/schemas/AgentSpec'
+    AgentMetadata:
+      $ref: './common/agent.yaml#/components/schemas/Metadata'
+    AgentType:
+      $ref: './common/agent.yaml#/components/schemas/AgentType'
+    AgentStatus:
+      $ref: './common/agent.yaml#/components/schemas/AgentStatus'
+    Agent:
+      $ref: './common/agent.yaml#/components/schemas/Agent'
+    Capability:
+      $ref: './common/agent.yaml#/components/schemas/Capability'
+    Interface:
+      $ref: './common/agent.yaml#/components/schemas/Interface'
+    Requirements:
+      $ref: './common/agent.yaml#/components/schemas/Requirements'
+    ResourceRequirements:
+      $ref: './common/agent.yaml#/components/schemas/ResourceRequirements'
+
+    # Error Schemas
+    Problem:
+      $ref: './common/errors.yaml#/components/schemas/Problem'
+    ValidationError:
+      $ref: './common/errors.yaml#/components/schemas/ValidationError'
+    ValidationWarning:
+      $ref: './common/errors.yaml#/components/schemas/ValidationWarning'
+    ExecutionError:
+      $ref: './common/errors.yaml#/components/schemas/ExecutionError'
+
+    # Pagination Schemas
+    Pagination:
+      $ref: './common/pagination.yaml#/components/schemas/Pagination'
+
+    # Security Schemas
+    TokenResponse:
+      $ref: './common/security.yaml#/components/schemas/TokenResponse'
+    SecurityContext:
+      $ref: './common/security.yaml#/components/schemas/SecurityContext'
+
+    # Metadata Schemas
+    Timestamps:
+      $ref: './common/metadata.yaml#/components/schemas/Timestamps'
+    Labels:
+      $ref: './common/metadata.yaml#/components/schemas/Labels'
+    Annotations:
+      $ref: './common/metadata.yaml#/components/schemas/Annotations'
+    HealthStatus:
+      $ref: './common/metadata.yaml#/components/schemas/HealthStatus'
+
+  parameters:
+    PageParam:
+      $ref: './common/pagination.yaml#/components/parameters/PageParam'
+    LimitParam:
+      $ref: './common/pagination.yaml#/components/parameters/LimitParam'
+    OffsetParam:
+      $ref: './common/pagination.yaml#/components/parameters/OffsetParam'
+    SearchParam:
+      $ref: './common/pagination.yaml#/components/parameters/SearchParam'
+    SortParam:
+      $ref: './common/pagination.yaml#/components/parameters/SortParam'
+
+  securitySchemes:
+    ApiKeyAuth:
+      $ref: './common/security.yaml#/components/securitySchemes/ApiKeyAuth'
+    BearerAuth:
+      $ref: './common/security.yaml#/components/securitySchemes/BearerAuth'
+    OAuth2:
+      $ref: './common/security.yaml#/components/securitySchemes/OAuth2'
+    AgentMTLS:
+      $ref: './common/security.yaml#/components/securitySchemes/AgentMTLS'

package/package.json

@@ -1,8 +1,23 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.3.2",
+  "version": "0.3.5",
   "exports": {
-    "./schema": "./spec/v0.3.2/ossa-0.3.2.schema.json",
+    "./schema": "./spec/v{{VERSION}}/ossa-{{VERSION}}.schema.json",
+    "./schema/v0.3.3": "./spec/v{{VERSION}}/ossa-{{VERSION}}.schema.json",
+    "./schema/v0.3.4": "./spec/v{{VERSION}}/ossa-{{VERSION}}.schema.json",
+    "./schema/v0.3.5": "./spec/v{{VERSION}}/ossa-{{VERSION}}.schema.json",
+    "./ag2/swarm-topology": "./spec/v0.3.4/extensions/ag2/swarm-topology.schema.json",
+    "./ag2/group-chat": "./spec/v0.3.4/extensions/ag2/group-chat.schema.json",
+    "./ag2/nested-chat": "./spec/v0.3.4/extensions/ag2/nested-chat.schema.json",
+    "./hitl/intervention-points": "./spec/v0.3.4/protocols/hitl/intervention-points.schema.json",
+    "./hitl/human-input-modes": "./spec/v0.3.4/protocols/hitl/human-input-modes.schema.json",
+    "./hitl/approval-workflows": "./spec/v0.3.4/protocols/hitl/approval-workflows.schema.json",
+    "./a2a/service-discovery": "./spec/v0.3.4/protocols/a2a/service-discovery.schema.json",
+    "./a2a/handoff-protocol": "./spec/v0.3.4/protocols/a2a/handoff-protocol.schema.json",
+    "./a2a/capability-advertisement": "./spec/v0.3.4/protocols/a2a/capability-advertisement.schema.json",
+    "./state/context-serialization": "./spec/v0.3.4/runtime/state/context-serialization.schema.json",
+    "./state/memory-portability": "./spec/v0.3.4/runtime/state/memory-portability.schema.json",
+    "./state/teachability": "./spec/v0.3.4/runtime/state/teachability.schema.json",
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
@@ -40,14 +55,15 @@
       "require": "./dist/mesh/index.js"
     }
   },
-  "description": "OSSA - Open Standard for Scalable AI Agents. A specification standard for AI agents (like OpenAPI for REST APIs). NOT a framework.",
+  "description": "OSSA - Open Standard for Software Agents. The OpenAPI for agents. A specification standard (not a framework) that defines contracts/metadata for production agent systems.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
     "ossa": "bin/ossa",
     "ossa-version": "bin/ossa-version",
-    "ossa-validate-all": "bin/ossa-validate-all"
+    "ossa-validate-all": "bin/ossa-validate-all",
+    "ossa-dev": "src/dev-cli/src/index.ts"
   },
   "files": [
     "dist/",
@@ -81,7 +97,7 @@
   },
   "homepage": "https://openstandardagents.org",
   "scripts": {
-    "// ──────────────────────────────────────────────────────────────": "",
+    "// ─────────────────────────────────────────────────────────────────────────────": "",
     "// BUILD & DEVELOPMENT": "",
     "prebuild": "npm run docs:process",
     "build": "tsc && npm run build:assets",
@@ -93,10 +109,17 @@
     "test": "jest",
     "test:unit": "jest tests/unit",
     "test:integration": "jest tests/integration",
-    "test:e2e": "jest tests/e2e",
+    "test:e2e": "jest tests/e2e --passWithNoTests",
+    "test:smoke": "jest tests/e2e --testPathPattern=smoke.spec.ts --runInBand",
+    "test:smoke:cli": "jest tests/e2e/cli.smoke.spec.ts",
+    "test:smoke:npm-pack": "jest tests/e2e/npm-pack.smoke.spec.ts",
+    "test:smoke:schema": "jest tests/e2e/schema-coverage.smoke.spec.ts",
     "test:coverage": "jest --coverage",
     "test:watch": "jest --watch",
     "test:ci": "jest --ci --coverage --reporters=default --reporters=jest-junit",
+    "ci:validate": "npm run build:clean && npm run quality && npm run test:unit && npm run test:smoke && npm run validate:all",
+    "ci:validate:fast": "npm run typecheck && npm run lint && npm run test:unit && npm run validate:schema",
+    "test:current": "jest tests/unit/v$(node -p \"require('./.version.json').current\") tests/integration/v$(node -p \"require('./.version.json').current\")",
     "// CODE QUALITY": "",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src tests --ext .ts",
@@ -106,38 +129,60 @@
     "quality": "npm run typecheck && npm run lint && npm run format:check",
     "quality:fix": "npm run lint:fix && npm run format",
     "// VALIDATION": "",
-    "validate": "npm run validate:schema && npm run validate:examples",
-    "validate:schema": "tsx scripts/validate-schema.ts",
-    "validate:examples": "find examples -name '*.yaml' -o -name '*.yml' | xargs -I {} sh -c 'yq eval . {} > /dev/null || exit 1'",
-    "validate:all": "node scripts/validate-all.js",
-    "validate:power": "tsx bin/validate-ossa.ts",
-    "validate:openapi": "tsx scripts/validate-openapi-extensions.ts",
-    "// VERSION MANAGEMENT (via ossa CLI - single source of truth)": "",
+    "validate": "npm run validate:schema && npm run validate:examples && npm run validate:changelog",
+    "validate:all": "npm run validate && npm run validate:sdks",
+    "validate:changelog": "npx keep-a-changelog validate CHANGELOG.md --url https://github.com/blueflyio/openstandardagents",
+    "validate:sdks": "npm run validate:sdk:typescript && npm run validate:sdk:python",
+    "validate:sdk:typescript": "cd src/sdks/typescript && npm install && npm run build && npm run typecheck",
+    "validate:sdk:python": "cd src/sdks/python && python -m pip install --quiet -e . && python -m pytest tests/ -v || true",
+    "validate:schema": "npx ajv-cli compile -s $(node -p \"require('./.version.json').spec_path\")/$(node -p \"require('./.version.json').schema_file\") -r $(node -p \"require('./.version.json').spec_path\")/extensions/kagent/kagent.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/mcp/mcp.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/a2a/a2a.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/langchain/langchain.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/langgraph/langgraph.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/ag2/ag2.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/crewai/crewai.schema.json --strict=false --allow-union-types",
+    "validate:manifest": "npx ajv-cli validate -s $(node -p \"require('./.version.json').spec_path\")/$(node -p \"require('./.version.json').schema_file\") --strict=false --allow-union-types -d",
+    "validate:examples": "find examples -name '*.ossa.yaml' -o -name '*.ossa.yml' | head -20 | xargs -I {} npm run validate:manifest -- {}",
+    "validate:power": "tsx src/tools/validation/validate-ossa.ts",
+    "validate:openapi": "tsx src/tools/validation/validate-openapi-extensions.ts",
+    "validate:current": "tsx src/tools/validation/validate-v$(node -p \"require('./.version.json').current\")-features.ts",
+    "validate:current:examples": "find spec/v$(node -p \"require('./.version.json').current\")/examples -name '*.ossa.yaml' | xargs -I {} tsx src/tools/validation/validate-v$(node -p \"require('./.version.json').current\")-features.ts {}",
+    "// VERSION MANAGEMENT (via ossa-dev CLI - single source of truth)": "",
+    "version:release": "tsx src/dev-cli/src/index.ts version release",
+    "version:audit": "tsx src/dev-cli/src/index.ts version audit",
+    "version:validate": "tsx src/dev-cli/src/index.ts version validate",
+    "version:sync": "tsx src/dev-cli/src/index.ts version sync",
     "version:status": "node dist/cli/index.js release version status",
-    "version:bump": "node dist/cli/index.js release version bump",
-    "version:sync": "node dist/cli/index.js release version sync",
     "version:check": "node dist/cli/index.js release version check",
     "version:examples": "node dist/cli/index.js release version examples",
+    "// INFRASTRUCTURE (TODO: Move to buildkit)": "",
+    "env:list": "tsx src/dev-cli/src/index.ts env-cleanup --list",
+    "env:cleanup": "tsx src/dev-cli/src/index.ts env-cleanup --stop-stuck",
     "// DOCUMENTATION": "",
-    "docs:process": "tsx scripts/process-doc-templates.ts",
+    "docs:process": "tsx src/tools/docs/process-doc-templates.ts",
     "docs:check": "test -f README.md && test -f CHANGELOG.md",
-    "docs:generate": "tsx scripts/generate-api-docs.ts && tsx scripts/generate-cli-docs.ts && tsx scripts/generate-schema-docs.ts && tsx scripts/generate-examples-docs.ts && tsx scripts/generate-agents-catalog.ts && tsx scripts/generate-types-docs.ts && tsx scripts/generate-errors-docs.ts && tsx scripts/generate-config-docs.ts && tsx scripts/lowercase-docs.ts",
+    "docs:generate": "tsx src/tools/docs/generate-api-docs.ts && tsx src/tools/docs/generate-cli-docs.ts && tsx src/tools/docs/generate-schema-docs.ts && tsx src/tools/docs/generate-examples-docs.ts && tsx src/tools/generators/generate-agents-catalog.ts && tsx src/tools/docs/generate-types-docs.ts && tsx src/tools/docs/generate-errors-docs.ts && tsx src/tools/docs/generate-config-docs.ts && tsx src/tools/docs/lowercase-docs.ts",
+    "docs:current": "tsx src/tools/docs/generate-v$(node -p \"require('./.version.json').current\")-docs.ts",
     "// CODE GENERATION": "",
-    "gen:types": "tsx scripts/gen-types.ts",
-    "gen:zod": "tsx scripts/gen-zod.ts",
+    "gen:types": "tsx src/tools/generators/gen-types.ts",
+    "gen:zod": "tsx src/tools/generators/gen-zod.ts",
     "gen:all": "npm run gen:types && npm run gen:zod",
+    "gen:current:schema": "tsx src/tools/generators/merge-v$(node -p \"require('./.version.json').current\")-schema.ts",
     "// SYNC & COMPLIANCE": "",
     "sync:pr": "tsx src/cli/commands/github-sync.command.ts pr",
     "sync:batch": "tsx src/cli/commands/github-sync.command.ts batch",
     "sync:list": "tsx src/cli/commands/github-sync.command.ts list",
-    "compliance:audit": "tsx scripts/compliance-audit.ts",
+    "migrate:batch": "node dist/cli/index.js migrate-batch",
+    "compliance:audit": "tsx src/tools/compliance-audit.ts",
+    "verify:npm-auth": "tsx src/tools/verify-npm-auth.ts",
+    "audit:mrs": "tsx src/tools/audit-mrs.ts",
     "// MAINTENANCE": "",
-    "fix:schemas": "node scripts/fix-schema-formats.js",
-    "prepare": "husky install || true",
+    "fix:schemas": "node src/tools/generators/fix-schema-formats.js",
+    "hooks:install": "lefthook install",
+    "hooks:uninstall": "lefthook uninstall",
+    "prepare": "lefthook install || true",
+    "postinstall": "node bin/postinstall || true",
     "// RELEASE & PUBLISH": "",
     "prerelease": "npm run quality && npm run test && npm run validate",
     "prepublishOnly": "npm run build:clean && npm run test && npm run lint",
-    "release:check": "npm run prerelease && echo '✅ Ready for release'"
+    "release:check": "npm run prerelease && echo '✅ Ready for release'",
+    "release:verify": "tsx src/dev-cli/src/index.ts release verify",
+    "release:prep": "tsx src/dev-cli/src/index.ts release prep v$(node -p \"require('./.version.json').latest_stable\")"
   },
   "keywords": [
     "ossa",
@@ -158,7 +203,17 @@
     "@gitbeaker/node": "^35.8.1",
     "@google/generative-ai": "^0.21.0",
     "@octokit/rest": "^20.0.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-jaeger": "^1.28.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.54.0",
+    "@opentelemetry/exporter-prometheus": "^0.54.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.54.0",
+    "@opentelemetry/exporter-zipkin": "^1.28.0",
+    "@opentelemetry/resources": "^1.28.0",
+    "@opentelemetry/sdk-node": "^0.54.0",
+    "@opentelemetry/sdk-trace-base": "^1.28.0",
     "@qdrant/js-client-rest": "^1.9.0",
+    "@types/tar": "^6.1.13",
     "ajv": "^8.12.0",
     "ajv-formats": "^3.0.1",
     "axios": "^1.12.2",
@@ -170,6 +225,7 @@
     "readline": "^1.3.0",
     "reflect-metadata": "^0.2.2",
     "semver": "^7.7.3",
+    "tar": "^7.5.3",
     "yaml": "^2.3.0",
     "zod": "^4.1.11"
   },
@@ -180,6 +236,7 @@
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.0",
     "@semantic-release/gitlab": "^13.2.9",
     "@types/jest": "^29.5.14",
     "@types/js-yaml": "^4.0.9",
@@ -189,6 +246,7 @@
     "@types/semver": "^7.7.1",
     "@typescript-eslint/eslint-plugin": "^8.48.0",
     "@typescript-eslint/parser": "^8.48.0",
+    "ajv-cli": "^5.0.0",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
@@ -196,11 +254,17 @@
     "jest-junit": "^16.0.0",
     "json-schema-to-typescript": "^15.0.4",
     "json-schema-to-zod": "^2.6.1",
+    "keep-a-changelog": "^2.8.0",
+    "lefthook": "^1.12.3",
     "prettier": "^3.6.2",
     "semantic-release": "^25.0.1",
-    "ts-jest": "^29.4.4",
+    "ts-jest": "^29.2.5",
     "ts-node": "^10.9.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
+  },
+  "volta": {
+    "node": "18.20.8",
+    "npm": "10.9.4"
   }
 }

package/spec/extensions/a2a-messaging.md

@@ -1,6 +1,6 @@
 # OSSA Extension: Agent-to-Agent Messaging (A2A Messaging)
 
-**Version:** 0.3.1
+**Version:** 0.3.3
 **Status:** Draft
 **Author:** OSSA Core Team
 **Last Updated:** 2025-12-18
@@ -227,7 +227,7 @@ Example: `agents.tasks.assigned.dlq`
 Declare channels an agent publishes to:
 
 ```yaml
-apiVersion: ossa/v0.3.1
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: task-orchestrator
@@ -254,7 +254,7 @@ spec:
 Declare channels an agent subscribes to:
 
 ```yaml
-apiVersion: ossa/v0.3.1
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: code-reviewer
@@ -450,7 +450,7 @@ See:
 
 ## Compatibility
 
-- **Minimum OSSA Version**: v0.3.1
+- **Minimum OSSA Version**: v0.3.3
 - **Supported Runtimes**: Node.js 18+, Deno 1.30+, Bun 1.0+
 - **Transport Requirements**: Redis 6.0+
 
@@ -463,7 +463,7 @@ See:
 
 ## Changelog
 
-### v0.3.1 (2025-12-18)
+### v0.3.3 (2025-12-18)
 
 - Initial specification for A2A Messaging extension
 - Message format and channel types defined

package/spec/extensions/manifest-extensions.md

@@ -1,6 +1,6 @@
 # OSSA Manifest Extensions: Messaging
 
-**Version:** 0.3.1
+**Version:** 0.3.3
 **Status:** Stable
 **Last Updated:** 2025-12-18
 
@@ -13,7 +13,7 @@ This document describes how to integrate the Agent-to-Agent Messaging extension
 The `messaging` field is added to the `spec` section of Agent manifests:
 
 ```yaml
-apiVersion: ossa/v0.3.1
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: my-agent
@@ -285,7 +285,7 @@ spec:
 ## Complete Example
 
 ```yaml
-apiVersion: ossa/v0.3.1
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: task-orchestrator
@@ -413,7 +413,7 @@ spec:
 ## Worker Agent Example
 
 ```yaml
-apiVersion: ossa/v0.3.1
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: code-reviewer

package/spec/extensions/openapi/ossa-openapi-extensions.schema.json

@@ -1,9 +1,9 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://openstandardagents.org/schemas/v0.3.2/extensions/openapi/ossa-openapi-extensions.json",
+  "$id": "https://openstandardagents.org/schemas/v0.3.3/extensions/openapi/ossa-openapi-extensions.json",
   "title": "OSSA OpenAPI Extensions Schema",
-  "description": "JSON Schema for validating OpenAPI 3.x documents that use OSSA (Open Standard for Scalable AI Agents) extensions. This schema defines all OSSA-specific vendor extensions (x-ossa-*) that can be added to OpenAPI specifications to enable agent-aware APIs.",
-  "version": "0.3.2",
+  "description": "JSON Schema for validating OpenAPI 3.x documents that use OSSA (Open Standard for Software Agents) extensions. This schema defines all OSSA-specific vendor extensions (x-ossa-*) that can be added to OpenAPI specifications to enable agent-aware APIs.",
+  "version": "0.3.3",
   "type": "object",
   "properties": {
     "openapi": {
@@ -42,7 +42,7 @@
           "type": "string",
           "pattern": "^(0\\.[0-9]+\\.[0-9]+|[1-9][0-9]*\\.[0-9]+\\.[0-9]+)(-[a-zA-Z0-9.-]+)?(\\+[a-zA-Z0-9.-]+)?$",
           "description": "OSSA specification version (semver format)",
-          "examples": ["0.3.2", "1.0.0", "0.3.2-beta.1"]
+          "examples": ["0.3.3", "1.0.0", "0.3.3-beta.1"]
         },
         "compliance": {
           "type": "object",
@@ -136,7 +136,7 @@
       "additionalProperties": false,
       "examples": [
         {
-          "version": "0.3.2",
+          "version": "0.3.3",
           "compliance": {
             "level": "standard",
             "frameworks": ["SOC2", "GDPR"]
@@ -231,12 +231,12 @@
       "additionalProperties": false,
       "examples": [
         {
-          "version": "0.3.2",
+          "version": "0.3.3",
           "agent": {
             "id": "code-reviewer-agent",
             "type": "specialist",
             "compliance": {
-              "standards": ["OSSA-0.3.2", "SOC2-Type2"],
+              "standards": ["OSSA-0.3.3", "SOC2-Type2"],
               "validated": true,
               "validatedAt": "2025-01-15T10:30:00Z"
             }
@@ -728,7 +728,7 @@
         "description": "API for automated code review agent"
       },
       "x-ossa-metadata": {
-        "version": "0.3.2",
+        "version": "0.3.3",
         "compliance": {
           "level": "standard",
           "frameworks": ["SOC2"]
@@ -744,12 +744,12 @@
         }
       },
       "x-ossa": {
-        "version": "0.3.2",
+        "version": "0.3.3",
         "agent": {
           "id": "code-reviewer",
           "type": "specialist",
           "compliance": {
-            "standards": ["OSSA-0.3.2"],
+            "standards": ["OSSA-0.3.3"],
             "validated": true
           }
         }