@bluefly/openstandardagents 0.4.4 → 0.4.5

package/examples/swarm-handoff.ossa.yaml

@@ -0,0 +1,67 @@
+apiVersion: ossa/v0.4
+kind: Agent
+metadata:
+  name: customer-support-swarm
+  version: 1.0.0
+  description: OpenAI Swarm pattern - triage agent routes to specialists via handoffs
+  agentType: openai
+  agentKind: coordinator
+  agentArchitecture:
+    pattern: swarm
+    capabilities:
+      - handoff
+      - tools
+      - context
+    coordination:
+      handoffStrategy: automatic
+      teamModel: swarm
+spec:
+  role: >
+    You are the triage agent for customer support. Route incoming
+    requests to the appropriate specialist agent.
+  llm:
+    provider: openai
+    model: gpt-4o
+  team:
+    model: swarm
+    lead: triage
+    delegateMode: capability-match
+    members:
+      - name: triage
+        kind: team-lead
+        role: >
+          Route customer requests to the correct specialist.
+          Analyze intent and handoff to sales, support, or billing.
+        tools:
+          - classify-intent
+      - name: sales-agent
+        kind: teammate
+        role: >
+          Handle sales inquiries, product information, pricing,
+          and purchase assistance.
+        tools:
+          - product-catalog
+          - pricing-api
+          - create-quote
+      - name: support-agent
+        kind: teammate
+        role: >
+          Handle technical support, troubleshooting, and bug reports.
+        tools:
+          - knowledge-base
+          - ticket-system
+          - diagnostic-tool
+      - name: billing-agent
+        kind: teammate
+        role: >
+          Handle billing inquiries, invoices, refunds, and payment issues.
+        tools:
+          - billing-api
+          - invoice-lookup
+          - refund-process
+    communication:
+      channel: direct-message
+      consensus: leader-decides
+    deployment:
+      backend: in-process
+      maxConcurrency: 4

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.4.1
+apiVersion: ossa/v0.4.5
 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.4.1
+apiVersion: ossa/v0.4.5
 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.4.1
+apiVersion: ossa/v0.4.5
 kind: Task
 metadata:
   name: publish-content

package/examples/team-agent.ossa.yaml

@@ -0,0 +1,159 @@
+# OSSA v0.4.5 Example: Team Agent — Claude Code Lead-Teammate Team
+#
+# Demonstrates the lead-teammate pattern modeled after Claude Code Agent
+# Teams. An Opus lead orchestrates Sonnet workers and a Haiku explorer.
+# The lead operates in delegate mode (never implements directly), while
+# teammates self-claim tasks from a shared, file-backed task list with
+# dependency tracking and wave execution.
+#
+# Key characteristics:
+#   - Lead-teammate model with delegate mode
+#   - Shared task list with self-claim coordination
+#   - File-backed persistence with dependency tracking
+#   - Mailbox communication (async, inbox-based)
+#   - Mixed model tiers (Opus lead, Sonnet workers, Haiku explorer)
+#   - In-process deployment with fixed scaling
+
+apiVersion: ossa/v0.4.5
+kind: Agent
+metadata:
+  name: fullstack-dev-team
+  version: "1.0.0"
+  description: >-
+    A Claude Code-style development team for fullstack feature implementation.
+    An Opus lead decomposes tasks and coordinates three teammates: a backend
+    worker (Sonnet), a frontend worker (Sonnet), and a codebase explorer
+    (Haiku). Teammates self-claim tasks from a shared list, communicate via
+    mailbox, and work in isolated directories.
+
+  agentKind: team-lead
+  agentType: a2a
+
+  agentArchitecture:
+    pattern: lead-teammate
+    capabilities:
+      - tools
+      - code
+      - context
+      - function-calling
+      - memory
+    coordination:
+      handoffStrategy: automatic
+      leaderAgent: lead
+      maxDepth: 2
+      teamModel: lead-teammate
+      communicationPattern: mailbox
+      taskCoordination: self-claim
+      conflictResolution: leader-decides
+      taskPersistence: file-backed
+      dependencyTracking: true
+
+  labels:
+    domain: development
+    pattern: lead-teammate
+    framework: claude-code
+
+spec:
+  role: >-
+    You are the lead of a fullstack development team. Your job is to:
+    1. Analyze the user's feature request and decompose it into tasks.
+    2. Create tasks in the shared task list with clear descriptions and
+       dependency relationships.
+    3. Monitor teammate progress and resolve blockers.
+    4. Synthesize completed work into a final deliverable.
+    You operate in delegate mode — you NEVER write code directly. Instead,
+    you coordinate your teammates who do the implementation work.
+
+  llm:
+    provider: anthropic
+    model: claude-opus-4-20250514
+    temperature: 0.4
+    maxTokens: 8192
+    profile: deep
+
+  team:
+    model: lead-teammate
+    lead: lead
+    delegateMode: true
+
+    members:
+      - name: backend-worker
+        kind: teammate
+        role: >-
+          Implement backend features: API endpoints, database schemas,
+          business logic, and server-side tests. Work in the backend/
+          directory. Claim tasks from the shared list and mark them
+          complete when done.
+        model:
+          provider: anthropic
+          name: claude-sonnet-4-20250514
+        tools:
+          - read_file
+          - write_file
+          - bash
+          - grep
+          - glob
+        contextIsolation: true
+        workingDirectory: /backend
+
+      - name: frontend-worker
+        kind: teammate
+        role: >-
+          Implement frontend features: React components, API integration,
+          styling, and UI tests. Work in the frontend/ directory. Claim
+          tasks from the shared list and mark them complete when done.
+        model:
+          provider: anthropic
+          name: claude-sonnet-4-20250514
+        tools:
+          - read_file
+          - write_file
+          - bash
+          - grep
+          - glob
+        contextIsolation: true
+        workingDirectory: /frontend
+
+      - name: codebase-explorer
+        kind: researcher
+        role: >-
+          Explore the codebase to answer questions from the lead and other
+          teammates. Search for patterns, find dependencies, and analyze
+          architecture. Read-only — never modify files.
+        model:
+          provider: anthropic
+          name: claude-haiku-4-5-20250514
+        tools:
+          - read_file
+          - grep
+          - glob
+        contextIsolation: true
+        workingDirectory: /
+
+    taskList:
+      coordination: self-claim
+      persistence: file-backed
+      stateModel:
+        - pending
+        - in-progress
+        - completed
+        - blocked
+      dependencyTracking: true
+      waveExecution: true
+      lockingStrategy: file-lock
+
+    communication:
+      pattern: mailbox
+      broadcastEnabled: false
+
+    deployment:
+      backend: in-process
+      scaling: fixed
+
+  constraints:
+    cost:
+      maxTokensPerDay: 2000000
+      maxCostPerDay: 100.00
+      currency: USD
+    performance:
+      timeoutSeconds: 300

package/examples/team-lead-teammate.ossa.yaml

@@ -0,0 +1,83 @@
+apiVersion: ossa/v0.4
+kind: Agent
+metadata:
+  name: code-review-team
+  version: 1.0.0
+  description: Claude Code teams pattern - lead delegates to specialized reviewers
+  agentType: claude
+  agentKind: team-lead
+  agentArchitecture:
+    pattern: lead-teammate
+    capabilities:
+      - tools
+      - code
+      - context
+      - handoff
+    coordination:
+      teamModel: lead-teammate
+      communicationPattern: task-list
+      taskCoordination: dependency-wave
+      conflictResolution: leader-decides
+      taskPersistence: file-backed
+      dependencyTracking: true
+spec:
+  role: >
+    You lead a code review team. Analyze pull requests and delegate
+    specific review tasks to specialized teammates.
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-5-20250514
+  team:
+    model: lead-teammate
+    lead: lead-reviewer
+    delegateMode: task-list
+    members:
+      - name: lead-reviewer
+        kind: team-lead
+        role: >
+          Senior code reviewer. Analyze PRs, break down review into tasks,
+          delegate to specialists, and synthesize final review.
+        model: claude-sonnet-4-5-20250514
+        tools:
+          - read-file
+          - grep
+          - git-diff
+      - name: security-reviewer
+        kind: specialist
+        role: >
+          Security vulnerability scanner. Check for OWASP top 10,
+          injection attacks, authentication flaws, and data exposure.
+        tools:
+          - sast-scan
+          - dependency-check
+          - read-file
+        maxTokenBudget: 15000
+      - name: style-checker
+        kind: teammate
+        role: >
+          Code style and formatting reviewer. Verify adherence to
+          project conventions, naming, and documentation standards.
+        tools:
+          - eslint
+          - prettier
+          - read-file
+      - name: test-reviewer
+        kind: teammate
+        role: >
+          Test coverage reviewer. Verify test adequacy, check edge cases,
+          and validate test assertions.
+        tools:
+          - run-tests
+          - coverage-report
+          - read-file
+    taskList:
+      persistence: file-backed
+      format: markdown
+      path: review-tasks.md
+      dependencyTracking: true
+    communication:
+      channel: task-list
+      consensus: leader-decides
+    deployment:
+      backend: in-process
+      maxConcurrency: 4

package/examples/templates/ossa-compliance.yaml

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

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

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

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.4.1
+apiVersion: ossa/v0.4.5
 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.4.1
+apiVersion: ossa/v0.4.5
 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.4.1
+apiVersion: ossa/v0.4.5
 kind: Workflow
 metadata:
   name: simple-etl

package/openapi/agents-md-service.yaml

@@ -263,7 +263,7 @@ components:
       properties:
         repo_path:
           type: string
-          example: /Volumes/AgentPlatform/repos/bare/blueflyio/agent-protocol.git
+          example: /path/to/repos/agent-protocol.git
         branch:
           type: string
           example: main

package/openapi/core/unified-agent-gateway.openapi.yaml

@@ -513,7 +513,7 @@ components:
         gitlab_package:
           type: string
           description: GitLab package to use (if available)
-          example: "@llm/my-agent@1.0.0"
+          example: "@llm/supercali-fragilisticagent@1.0.0"
 
     AgentResponse:
       type: object

package/openapi/ossa-cli-enhancements.openapi.yaml

@@ -21,7 +21,7 @@ info:
 servers:
   - url: http://localhost:4000/api/v1
     description: Local development server
-  - url: https://api.blueflyagents.com/api/v1
+  - url: https://mesh.blueflyagents.com/api/v1
     description: Production API server
 
 tags:
@@ -514,8 +514,8 @@ components:
                 type: number
               examples:
                 type: array
-                  items:
-                    type: string
+                items:
+                  type: string
 
     ExampleGenerationRequest:
       type: object

package/openapi/ossa-cli.yaml

@@ -68,7 +68,7 @@ components:
           pattern: '^[a-z0-9-]+$'
           minLength: 3
           maxLength: 50
-          example: 'my-agent'
+          example: 'supercali-fragilisticagent'
         version:
           type: string
           pattern: '^\d+\.\d+\.\d+$'

package/openapi/protocols/sse-streams.yaml

@@ -401,7 +401,7 @@ components:
           type: string
           format: uri
           description: Agent URI of sender
-          example: agent://example.com/my-agent
+          example: agent://example.com/supercali-fragilisticagent
         streamId:
           type: string
           format: uuid

package/openapi/protocols/websocket-events.yaml

@@ -112,7 +112,7 @@ components:
               type: string
               format: uri
               description: Agent URI (agent://domain/agent-id)
-              example: agent://example.com/my-agent
+              example: agent://example.com/supercali-fragilisticagent
             capabilities:
               type: array
               items:
@@ -353,7 +353,7 @@ components:
           type: string
           format: uri
           description: Agent URI of sender
-          example: agent://example.com/my-agent
+          example: agent://example.com/supercali-fragilisticagent
         correlationId:
           type: string
           format: uuid

package/openapi/release-automation.openapi.yaml

@@ -17,7 +17,7 @@ info:
 servers:
   - url: http://localhost:4000/api/v1
     description: Local development server
-  - url: https://api.blueflyagents.com/api/v1
+  - url: https://mesh.blueflyagents.com/api/v1
     description: Production API server
 
 tags:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "exports": {
     "./schema": "./spec/v0.4/agent.schema.json",
     "./schema/v0.4": "./spec/v0.4/agent.schema.json",
@@ -63,7 +63,33 @@
       "require": "./dist/version-management/index.js"
     }
   },
-  "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.",
+  "description": "OSSA - Open Standard for Software Agents. Infrastructure bridge between agent protocols (MCP, A2A) and deployment platforms. Define once in YAML, export to 9+ platforms (Docker, Kubernetes, LangChain, CrewAI, Claude Skills, etc.).",
+  "keywords": [
+    "ossa",
+    "ai-agents",
+    "agent-framework",
+    "agent-orchestration",
+    "multi-agent",
+    "openapi",
+    "json-schema",
+    "kubernetes",
+    "docker",
+    "langchain",
+    "crewai",
+    "autogen",
+    "claude",
+    "llm",
+    "agent-mesh",
+    "agent-standard",
+    "kagent",
+    "cli",
+    "validation",
+    "agent-generation",
+    "agent-deployment",
+    "agent-interoperability"
+  ],
+  "author": "OSSA Contributors",
+  "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -103,7 +129,7 @@
     "// BUILD & DEVELOPMENT": "",
     "prebuild": "npm run docs:process",
     "build": "tsc && npm run build:assets",
-    "build:assets": "cp -r spec dist/ && cp package.json dist/",
+    "build:assets": "cp -r spec dist/ && cp package.json .version.json dist/",
     "build:clean": "npm run clean && npm run build",
     "dev": "tsc --watch",
     "clean": "rm -rf dist coverage .tsbuildinfo",
@@ -181,40 +207,34 @@
     "prepublishOnly": "tsx tools/validate-package.ts",
     "validate:deps": "tsx tools/validate-dependencies.ts",
     "validate:package": "tsx tools/validate-package.ts",
+    "publish:check": "tsx tools/pre-publish-check.ts",
+    "publish:dry-run": "npm publish --dry-run",
     "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",
-    "ai-agents",
-    "openapi",
-    "standard",
-    "kubernetes",
-    "kagent",
-    "cli",
-    "validation",
-    "agent-generation"
-  ],
-  "author": "OSSA Standards Team",
-  "license": "Apache-2.0",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.0",
     "@aws-sdk/client-bedrock-runtime": "^3.955.0",
     "@gitbeaker/node": "^35.8.1",
+    "@gitbeaker/rest": "^43.8.0",
     "@google/generative-ai": "^0.21.0",
     "@langchain/anthropic": "^0.3.10",
     "@langchain/core": "^0.3.29",
     "@langchain/openai": "^0.3.17",
     "@modelcontextprotocol/sdk": "^0.6.0",
     "@octokit/rest": "^20.0.0",
+    "@openai/agents": "^0.4.6",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/exporter-jaeger": "^1.28.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.211.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-logs": "^0.211.0",
+    "@opentelemetry/sdk-metrics": "^2.5.0",
     "@opentelemetry/sdk-node": "^0.54.0",
     "@opentelemetry/sdk-trace-base": "^1.28.0",
     "@qdrant/js-client-rest": "^1.9.0",
@@ -254,13 +274,11 @@
     "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/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^12.0.0",
     "@semantic-release/gitlab": "^13.2.9",
     "@types/express": "^4.17.21",
     "@types/gradient-string": "^1.1.6",

package/spec/extensions/knowledge-graph/knowledge-graph.schema.json

@@ -359,7 +359,7 @@
         "vector_db": {
           "type": "qdrant",
           "url": "${QDRANT_URL}",
-          "collection": "my-agent-kg"
+          "collection": "supercali-fragilisticagent-kg"
         },
         "wiki": {
           "type": "markdown",

package/spec/extensions/manifest-extensions.md

@@ -16,7 +16,7 @@ The `messaging` field is added to the `spec` section of Agent manifests:
 apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
-  name: my-agent
+  name: creative-agent-naming
   version: 1.0.0
 spec:
   messaging:
@@ -33,7 +33,7 @@ spec:
         schema: TaskAssigned
         handler: handleTaskAssigned
         filter:
-          payload.assignedTo: "ossa://agents/my-agent"
+          payload.assignedTo: "ossa://agents/creative-agent-naming"
         priority: high
 
     transport:

package/spec/registry/README.md

@@ -75,7 +75,7 @@ cat > agent.ossa.yaml <<EOF
 apiVersion: ossa/v0.3.0
 kind: Agent
 metadata:
-  name: my-agent
+  name: creative-agent-naming
   version: 1.0.0
 spec:
   role: A helpful assistant

package/spec/registry/registry-spec.md

@@ -2122,14 +2122,14 @@ err = client.Publish(ctx, &registry.PublishRequest{
 
 ```bash
 # 1. Create agent directory
-mkdir my-agent && cd my-agent
+mkdir creative-agent-naming && cd creative-agent-naming
 
 # 2. Create manifest
 cat > agent.ossa.yaml <<EOF
 apiVersion: ossa/v0.3.0
 kind: Agent
 metadata:
-  name: my-agent
+  name: creative-agent-naming
   version: 1.0.0
   description: My first OSSA agent
 spec:
@@ -2142,7 +2142,7 @@ EOF
 # 3. Create package metadata
 cat > ossa.json <<EOF
 {
-  "name": "my-agent",
+  "name": "creative-agent-naming",
   "version": "1.0.0",
   "description": "My first OSSA agent",
   "license": "MIT",
@@ -2215,7 +2215,7 @@ ossa login --registry https://registry.internal.example.com
 ossa publish --registry https://registry.internal.example.com
 
 # Install from private registry
-ossa install my-agent --registry https://registry.internal.example.com
+ossa install creative-agent-naming --registry https://registry.internal.example.com
 ```
 
 ---