@bluefly/openstandardagents 0.2.4 → 0.2.5-RC

package/openapi/reference-implementations/worker-agent-api.openapi.yaml

@@ -0,0 +1,208 @@
+openapi: 3.1.0
+info:
+  title: Data Processing Worker Agent API
+  version: 1.2.0
+  description: |
+    High-performance worker agent for distributed data processing tasks.
+    Executes tasks delegated by orchestrator agents.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: intermediate
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: data-processing-worker
+    type: worker
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: https://worker.platform.com/api/v1
+    description: Production
+  - url: http://worker:3000/api/v1
+    description: Kubernetes internal
+
+tags:
+  - name: processing
+    description: Data processing operations
+  - name: tasks
+    description: Task management operations
+
+paths:
+  /process:
+    post:
+      summary: Process data records
+      description: Process a batch of data records with transformation and validation
+      operationId: processRecords
+      tags: [processing]
+      x-ossa-capability: process-records
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [records]
+              properties:
+                records:
+                  type: array
+                  items:
+                    type: object
+                transformation:
+                  type: object
+                  description: Transformation rules to apply
+                validation:
+                  type: object
+                  description: Validation rules
+      responses:
+        '200':
+          description: Processing completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  processed:
+                    type: integer
+                  failed:
+                    type: integer
+                  results:
+                    type: array
+                    items:
+                      type: object
+                  errors:
+                    type: array
+                    items:
+                      type: object
+
+  /transform:
+    post:
+      summary: Transform data
+      description: Apply transformation rules to input data
+      operationId: transformData
+      tags: [processing]
+      x-ossa-capability: transform-data
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [data, rules]
+              properties:
+                data:
+                  type: object
+                rules:
+                  type: array
+                  items:
+                    type: object
+      responses:
+        '200':
+          description: Transformation completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  transformed:
+                    type: object
+                  metadata:
+                    type: object
+
+  /validate:
+    post:
+      summary: Validate input data
+      description: Validate input data against schema and business rules
+      operationId: validateInput
+      tags: [processing]
+      x-ossa-capability: validate-input
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [data, schema]
+              properties:
+                data:
+                  type: object
+                schema:
+                  type: object
+                rules:
+                  type: array
+                  items:
+                    type: string
+      responses:
+        '200':
+          description: Validation completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  valid:
+                    type: boolean
+                  errors:
+                    type: array
+                    items:
+                      type: object
+                  warnings:
+                    type: array
+                    items:
+                      type: string
+
+  /tasks/{task_id}/status:
+    get:
+      summary: Get task status
+      description: Retrieve the status of an asynchronous task
+      operationId: getTaskStatus
+      tags: [tasks]
+      x-ossa-capability: report-progress
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      parameters:
+        - name: task_id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Task status
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  task_id:
+                    type: string
+                  status:
+                    type: string
+                    enum: [pending, running, completed, failed]
+                  progress:
+                    type: number
+                    minimum: 0
+                    maximum: 100
+                  result:
+                    type: object
+

package/openapi/reference-implementations/workflow-orchestrator-api.openapi.yaml

@@ -0,0 +1,193 @@
+openapi: 3.1.0
+info:
+  title: Workflow Orchestration Agent API
+  version: 2.0.0
+  description: |
+    Advanced workflow orchestration agent that coordinates multi-step processes,
+    manages agent swarms, and provides intelligent task routing.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: enterprise
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: workflow-orchestrator
+    type: orchestrator
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: https://workflow-orchestrator.platform.com/api/v1
+    description: Production
+
+tags:
+  - name: workflows
+    description: Workflow execution operations
+  - name: coordination
+    description: Agent coordination operations
+
+paths:
+  /workflows/execute:
+    post:
+      summary: Execute workflow
+      description: Execute multi-step workflow with agent coordination
+      operationId: executeWorkflow
+      tags: [workflows]
+      x-ossa-capability: execute_workflow
+      x-ossa-autonomy:
+        level: semi-autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [workflow_definition]
+              properties:
+                workflow_definition:
+                  type: object
+                  required: [name, steps]
+                  properties:
+                    name:
+                      type: string
+                    steps:
+                      type: array
+                      items:
+                        type: object
+                        properties:
+                          step_id:
+                            type: string
+                          agent_id:
+                            type: string
+                          capability:
+                            type: string
+                          input:
+                            type: object
+                          dependencies:
+                            type: array
+                            items:
+                              type: string
+                options:
+                  type: object
+                  properties:
+                    parallel:
+                      type: boolean
+                      default: false
+                    retry:
+                      type: object
+      responses:
+        '202':
+          description: Workflow execution started
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  workflow_id:
+                    type: string
+                  status:
+                    type: string
+                    enum: [pending, running, completed, failed]
+
+  /workflows/{workflow_id}:
+    get:
+      summary: Get workflow status
+      description: Retrieve workflow execution status and results
+      operationId: getWorkflowStatus
+      tags: [workflows]
+      x-ossa-capability: execute_workflow
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      parameters:
+        - name: workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Workflow status
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  workflow_id:
+                    type: string
+                  status:
+                    type: string
+                  steps:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        step_id:
+                          type: string
+                        status:
+                          type: string
+                        result:
+                          type: object
+                  result:
+                    type: object
+
+  /coordinate/swarm:
+    post:
+      summary: Coordinate agent swarm
+      description: Coordinate multiple agents for parallel task execution
+      operationId: coordinateSwarm
+      tags: [coordination]
+      x-ossa-capability: coordinate_agents
+      x-ossa-autonomy:
+        level: semi-autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [agents, task]
+              properties:
+                agents:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      agent_id:
+                        type: string
+                      capability:
+                        type: string
+                task:
+                  type: object
+                strategy:
+                  type: string
+                  enum: [parallel, sequential, priority]
+      responses:
+        '200':
+          description: Swarm coordination initiated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  coordination_id:
+                    type: string
+                  agents:
+                    type: array
+                    items:
+                      type: object
+                  status:
+                    type: string
+

package/package.json

@@ -1,14 +1,8 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.2.4",
-  "description": "OSSA - Open Standard for Scalable AI Agents. A specification standard for AI agents (like OpenAPI for REST APIs). NOT a framework.",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "ossa": "bin/ossa"
-  },
+  "version": "0.2.5-RC",
   "exports": {
+    "./schema": "./spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json",
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
@@ -34,13 +28,20 @@
       "import": "./dist/types/index.js",
       "require": "./dist/types/index.js"
     },
-    "./schema": "./spec/v0.2.2/ossa-0.2.2.schema.json",
     "./openapi-extensions": {
       "types": "./dist/types/openapi-extensions.d.ts",
       "import": "./dist/types/openapi-extensions.js",
       "require": "./dist/types/openapi-extensions.js"
-    },
-    "./openapi-extensions-schema": "./docs/schemas/openapi-extensions.schema.json"
+    }
+  },
+  "description": "OSSA - Open Standard for Scalable AI Agents. A specification standard for AI agents (like OpenAPI for REST APIs). NOT a framework.",
+  "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"
   },
   "publishConfig": {
     "access": "public",
@@ -48,15 +49,21 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/blueflyio/openstandardagents.git"
+    "url": "https://github.com/blueflyio/openstandardagents/"
   },
   "bugs": {
     "url": "https://github.com/blueflyio/openstandardagents/issues"
   },
   "homepage": "https://openstandardagents.org",
   "scripts": {
+    "version:sync": "tsx scripts/sync-versions.ts",
+    "version:bump": "tsx scripts/bump-version.ts",
+    "version:enhanced": "tsx scripts/enhanced-version-manager.ts",
+    "version:check": "tsx scripts/sync-versions.ts --check",
+    "docs:process": "tsx scripts/process-doc-templates.ts",
+    "prebuild": "npm run version:sync && npm run docs:process",
     "build": "tsc && npm run copy-assets",
-    "copy-assets": "cp -r spec dist/ && mkdir -p dist/docs/schemas && cp docs/schemas/*.json dist/docs/schemas/ 2>/dev/null || true",
+    "copy-assets": "cp -r spec dist/",
     "dev": "tsc --watch",
     "clean": "rm -rf dist coverage",
     "test": "jest",
@@ -70,11 +77,11 @@
     "lint:fix": "eslint src tests --ext .ts --fix",
     "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
-    "validate:schema": "ajv validate -s spec/v0.2.2/ossa-0.2.2.schema.json",
+    "validate:schema": "tsx scripts/validate-schema.ts",
     "validate:examples": "node -r ts-node/register tests/integration/examples/validate-all-examples.test.ts",
-    "validate:power-suite": "ts-node bin/validate-ossa-0.2.2.ts",
-    "gen:types": "json-schema-to-typescript spec/v0.2.2/ossa-0.2.2.schema.json > src/types/generated/ossa-v0.2.2.types.ts",
-    "gen:zod": "json-schema-to-zod spec/v0.2.2/ossa-0.2.2.schema.json > src/types/generated/ossa-v0.2.2.zod.ts",
+    "validate:power-suite": "tsx bin/validate-ossa.ts",
+    "gen:types": "tsx scripts/gen-types.ts",
+    "gen:zod": "tsx scripts/gen-zod.ts",
     "gen:all": "npm run gen:types && npm run gen:zod",
     "cli:legacy": "node cli/bin/ossa --help",
     "prepublishOnly": "npm run clean && npm run build && npm run test && npm run lint"
@@ -95,10 +102,11 @@
   "dependencies": {
     "ajv": "^8.12.0",
     "ajv-formats": "^3.0.1",
+    "axios": "^1.12.2",
     "chalk": "^5.6.2",
     "commander": "^11.1.0",
     "glob": "^11.0.3",
-    "inversify": "^7.10.3",
+    "inversify": "^7.10.4",
     "openai": "^6.9.1",
     "readline": "^1.3.0",
     "reflect-metadata": "^0.2.2",
@@ -106,7 +114,9 @@
     "zod": "^4.1.11"
   },
   "devDependencies": {
+    "@gitbeaker/rest": "^43.8.0",
     "@jest/globals": "^29.7.0",
+    "@octokit/rest": "^22.0.1",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/gitlab": "^13.2.9",
@@ -114,9 +124,8 @@
     "@types/node": "^20.19.19",
     "@types/pg": "^8.15.5",
     "@types/redis": "^4.0.10",
-    "@typescript-eslint/eslint-plugin": "^5.62.0",
-    "@typescript-eslint/parser": "^5.62.0",
-    "axios": "^1.12.2",
+    "@typescript-eslint/eslint-plugin": "^8.48.0",
+    "@typescript-eslint/parser": "^8.48.0",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
@@ -127,6 +136,7 @@
     "semantic-release": "^25.0.1",
     "ts-jest": "^29.4.4",
     "ts-node": "^10.9.2",
+    "tsx": "^4.20.6",
     "typescript": "^5.9.3"
   }
 }

package/release.config.js

@@ -1,9 +1,16 @@
 export default {
   branches: [
-    'main',
-    { name: 'development', prerelease: 'dev', channel: 'development' },
+    {
+      name: 'main',
+      channel: false, // Stable releases get 'latest' tag
+    },
+    {
+      name: 'development',
+      prerelease: 'dev',
+      channel: 'dev', // Dev releases get 'dev' tag
+    },
   ],
-  repositoryUrl: 'https://gitlab.bluefly.io/llm/openapi-ai-agents-standard.git',
+  repositoryUrl: 'https://github.com/blueflyio/openstandardagents.git',
   plugins: [
     [
       '@semantic-release/commit-analyzer',
@@ -14,6 +21,9 @@ export default {
           { type: 'refactor', scope: 'core-*', release: 'minor' },
           { type: 'refactor', release: 'patch' },
           { type: 'chore', scope: 'deps', release: 'patch' },
+          // Version is determined automatically by commit analysis
+          // Milestones are used for planning and tracking, but version bump
+          // is controlled by commit messages (feat → minor, fix → patch, BREAKING → major)
         ],
         parserOpts: {
           noteKeywords: ['BREAKING CHANGE', 'BREAKING CHANGES'],
@@ -38,12 +48,17 @@ export default {
     ],
     [
       '@semantic-release/npm',
-      { npmPublish: false, tarballDir: 'dist' },
+      { 
+        npmPublish: true,
+        tarballDir: 'dist',
+        // Tag stable releases as 'latest', dev releases as 'dev'
+        // This is handled by branch configuration below
+      },
     ],
     [
       '@semantic-release/gitlab',
       {
-        gitlabUrl: 'https://gitlab.bluefly.io',
+        gitlabUrl: 'https://gitlab.com',
         assets: [
           { path: 'dist/*.tgz', label: 'OSSA npm package (${nextRelease.gitTag})' },
           {

package/scripts/bump-version.ts

@@ -0,0 +1,57 @@
+#!/usr/bin/env tsx
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+
+const VERSION_FILE = path.join(process.cwd(), '.version.json');
+const versionConfig = JSON.parse(fs.readFileSync(VERSION_FILE, 'utf-8'));
+
+const type = process.argv[2] || 'patch'; // major, minor, patch, rc
+
+function bumpVersion(current: string, type: string): string {
+  const rcMatch = current.match(/^(\d+)\.(\d+)\.(\d+)-RC$/);
+  if (rcMatch) {
+    if (type === 'release') {
+      return `${rcMatch[1]}.${rcMatch[2]}.${rcMatch[3]}`;
+    }
+  }
+  
+  const match = current.match(/^(\d+)\.(\d+)\.(\d+)$/);
+  if (!match) throw new Error(`Invalid version: ${current}`);
+  
+  let [, major, minor, patch] = match.map(Number);
+  
+  switch (type) {
+    case 'major':
+      return `${major + 1}.0.0`;
+    case 'minor':
+      return `${major}.${minor + 1}.0`;
+    case 'patch':
+      return `${major}.${minor}.${patch + 1}`;
+    case 'rc':
+      return `${major}.${minor}.${patch + 1}-RC`;
+    default:
+      throw new Error(`Unknown bump type: ${type}`);
+  }
+}
+
+const newVersion = bumpVersion(versionConfig.current, type);
+versionConfig.latest_stable = versionConfig.current.replace('-RC', '');
+versionConfig.current = newVersion;
+
+fs.writeFileSync(VERSION_FILE, JSON.stringify(versionConfig, null, 2) + '\n');
+
+// Create spec directory
+const specDir = path.join(process.cwd(), 'spec', `v${newVersion}`);
+if (!fs.existsSync(specDir)) {
+  fs.mkdirSync(specDir, { recursive: true });
+  console.log(`✅ Created spec directory: ${specDir}`);
+}
+
+// Run sync
+execSync('npm run version:sync', { stdio: 'inherit' });
+
+console.log(`✅ Bumped version: ${versionConfig.current} → ${newVersion}`);
+console.log(`\nNext steps:`);
+console.log(`1. Update schema: spec/v${newVersion}/ossa-${newVersion}.schema.json`);
+console.log(`2. Commit: git add . && git commit -m "chore: bump version to ${newVersion}"`);