@bluefly/openstandardagents 0.3.2 → 0.3.3

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,8 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "exports": {
-    "./schema": "./spec/v0.3.2/ossa-0.3.2.schema.json",
+    "./schema": "./spec/v0.3.3/ossa-0.3.3.schema.json",
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
@@ -40,7 +40,7 @@
       "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",
@@ -81,7 +81,7 @@
   },
   "homepage": "https://openstandardagents.org",
   "scripts": {
-    "// ──────────────────────────────────────────────────────────────": "",
+    "// ─────────────────────────────────────────────────────────────────────────────": "",
     "// BUILD & DEVELOPMENT": "",
     "prebuild": "npm run docs:process",
     "build": "tsc && npm run build:assets",
@@ -93,7 +93,7 @@
     "test": "jest",
     "test:unit": "jest tests/unit",
     "test:integration": "jest tests/integration",
-    "test:e2e": "jest tests/e2e",
+    "test:e2e": "jest tests/e2e --passWithNoTests",
     "test:coverage": "jest --coverage",
     "test:watch": "jest --watch",
     "test:ci": "jest --ci --coverage --reporters=default --reporters=jest-junit",
@@ -107,37 +107,43 @@
     "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:schema": "npx ajv-cli compile -s spec/v$(node -p \"require('./.version.json').current\")/ossa-$(node -p \"require('./.version.json').current\").schema.json --strict=false --allow-union-types",
+    "validate:manifest": "npx ajv-cli validate -s spec/v$(node -p \"require('./.version.json').current\")/ossa-$(node -p \"require('./.version.json').current\").schema.json --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",
+    "// 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",
     "// 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",
     "// 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",
     "// 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",
+    "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",
+    "fix:schemas": "node src/tools/generators/fix-schema-formats.js",
     "prepare": "husky install || 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 v0.3.3"
   },
   "keywords": [
     "ossa",
@@ -180,6 +186,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 +196,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",
@@ -198,7 +206,7 @@
     "json-schema-to-zod": "^2.6.1",
     "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"