@bluefly/openstandardagents 0.2.7 → 0.2.9

package/examples/anthropic/claude-assistant.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "claude-assistant",

package/examples/autogen/multi-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "autogen-assistant",

package/examples/claude-code/code-reviewer.ossa.yaml

@@ -0,0 +1,78 @@
+apiVersion: ossa/v0.2.9
+kind: Agent
+metadata:
+  name: claude-code-reviewer
+  version: 1.0.0
+  description: Claude Code agent for TypeScript/Node.js code review
+
+spec:
+  role: |
+    You are a senior code reviewer specializing in TypeScript, Node.js,
+    and OSSA specification compliance. Review code for quality, security,
+    and adherence to best practices.
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-5-20250929
+    temperature: 0.2
+    max_tokens: 16384
+
+  capabilities:
+    - name: review_code
+      description: Review code changes for quality and security
+      input_schema:
+        type: object
+        properties:
+          file_paths:
+            type: array
+            items:
+              type: string
+          focus_areas:
+            type: array
+            items:
+              type: string
+              enum: [security, performance, types, tests, docs]
+        required: [file_paths]
+
+    - name: suggest_improvements
+      description: Suggest code improvements and refactoring
+      input_schema:
+        type: object
+        properties:
+          file_path:
+            type: string
+          improvement_type:
+            type: string
+            enum: [refactor, optimize, simplify, secure]
+        required: [file_path, improvement_type]
+
+  constraints:
+    max_file_size: 100000
+    allowed_extensions:
+      - .ts
+      - .tsx
+      - .js
+      - .json
+      - .yaml
+      - .yml
+
+extensions:
+  claude_code:
+    enabled: true
+    agent_type: reviewer
+    capabilities:
+      - file_read
+      - grep_search
+      - glob_search
+    review_focus:
+      - type_safety
+      - error_handling
+      - security_vulnerabilities
+      - code_clarity
+      - test_coverage
+
+  anthropic:
+    enabled: true
+    model: claude-sonnet-4-5-20250929
+    max_tokens: 16384
+    temperature: 0.2

package/examples/claude-code/ossa-validator.ossa.yaml

@@ -0,0 +1,80 @@
+apiVersion: ossa/v0.2.9
+kind: Agent
+metadata:
+  name: ossa-validator
+  version: 1.0.0
+  description: Claude Code agent for OSSA manifest validation and generation
+
+spec:
+  role: |
+    You are an OSSA specification expert that helps users validate,
+    create, and migrate AI agent manifests to the OSSA standard.
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-5-20250929
+    temperature: 0.3
+    max_tokens: 8192
+
+  capabilities:
+    - name: validate
+      description: Validate OSSA manifests against schema
+      input_schema:
+        type: object
+        properties:
+          manifest_path:
+            type: string
+            description: Path to OSSA manifest file
+        required: [manifest_path]
+
+    - name: generate
+      description: Generate OSSA manifests from templates
+      input_schema:
+        type: object
+        properties:
+          agent_type:
+            type: string
+            enum: [chat, workflow, compliance, worker]
+          name:
+            type: string
+        required: [agent_type, name]
+
+    - name: migrate
+      description: Migrate manifests between OSSA versions
+      input_schema:
+        type: object
+        properties:
+          source_path:
+            type: string
+          target_version:
+            type: string
+            default: "0.2.9"
+        required: [source_path]
+
+  tools:
+    - name: ossa_validate
+      description: Run OSSA CLI validation
+      handler: bash
+      command: npm run cli -- validate ${manifest_path}
+
+    - name: ossa_generate
+      description: Generate new OSSA manifest
+      handler: bash
+      command: npm run cli -- generate ${agent_type} --name "${name}"
+
+extensions:
+  claude_code:
+    enabled: true
+    agent_type: specialist
+    capabilities:
+      - file_read
+      - file_write
+      - bash_execute
+    allowed_commands:
+      - "npm run cli --"
+      - "npm run test"
+      - "npm run build"
+    workspace_paths:
+      - "spec/"
+      - "examples/"
+      - "src/"

package/examples/common_npm/agent-router.ossa.yaml

@@ -1,3 +1,4 @@
+apiVersion: ossa/v0.2.9
 ossaVersion: "1.0"
 
 agent:

package/examples/common_npm/agent-router.v0.2.2.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: agent-router

package/examples/crewai/research-team.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "research-agent",

package/examples/cursor/code-review-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "code-review-agent",

package/examples/drupal/gitlab-ml-recommender.ossa.yaml

@@ -37,6 +37,7 @@
 # ============================================================================
 
 # OSSA specification version - defines which features are available
+apiVersion: ossa/v0.2.9
 ossaVersion: "1.0"
 
 # Agent metadata and configuration

package/examples/drupal/gitlab-ml-recommender.v0.2.2.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: gitlab-ml-recommender

package/examples/extensions/agents-md-v1.yml

@@ -0,0 +1,175 @@
+# OSSA agents.md Extension Schema
+# OpenAI agents.md repository-level agent guidance generation
+# See: https://agents.md | https://github.com/openai/agents.md
+
+apiVersion: ossa/v0.2.9
+kind: ExtensionSchema
+metadata:
+  name: agents-md-extension
+  version: v1
+  namespace: ossa/extensions
+spec:
+  compatibleWith:
+    - agents.md/v1
+  description: "Extension schema for OpenAI agents.md repository-level agent guidance"
+
+  references:
+    specification: https://agents.md
+    repository: https://github.com/openai/agents.md
+    adoption: "20,000+ OSS projects"
+
+  supportedTools:
+    - OpenAI Codex
+    - Google Jules
+    - Cursor
+    - GitHub Copilot
+    - VS Code
+    - Zed
+    - Aider
+    - Gemini CLI
+
+  additionalFields:
+    agent:
+      enabled:
+        type: boolean
+        default: false
+        description: "Enable agents.md generation"
+
+      generate:
+        type: boolean
+        default: true
+        description: "Auto-generate AGENTS.md from manifest"
+
+      output_path:
+        type: string
+        default: "AGENTS.md"
+        description: "Output path for generated file"
+
+      sections:
+        type: object
+        properties:
+          dev_environment:
+            $ref: "#/definitions/AgentsMdSection"
+            description: "Dev environment tips section"
+          testing:
+            $ref: "#/definitions/AgentsMdSection"
+            description: "Testing instructions section"
+          pr_instructions:
+            $ref: "#/definitions/AgentsMdSection"
+            description: "PR guidelines section"
+          code_style:
+            $ref: "#/definitions/AgentsMdSection"
+            description: "Code style guidelines section"
+          security:
+            $ref: "#/definitions/AgentsMdSection"
+            description: "Security considerations section"
+          custom:
+            type: array
+            items:
+              type: object
+              required: [title, content]
+              properties:
+                title:
+                  type: string
+                content:
+                  type: string
+            description: "Custom sections"
+
+      sync:
+        type: object
+        properties:
+          on_manifest_change:
+            type: boolean
+            default: true
+          include_comments:
+            type: boolean
+            default: true
+          watch:
+            type: boolean
+            default: false
+
+      mapping:
+        type: object
+        properties:
+          tools_to_dev_environment:
+            type: boolean
+            default: true
+            description: "Map spec.tools → Dev environment tips"
+          constraints_to_testing:
+            type: boolean
+            default: true
+            description: "Map spec.constraints → Testing requirements"
+          autonomy_to_pr_instructions:
+            type: boolean
+            default: true
+            description: "Map spec.autonomy → PR workflow hints"
+          role_from_agents_md:
+            type: boolean
+            default: false
+            description: "Parse AGENTS.md → spec.role hints"
+
+      cursor_integration:
+        type: boolean
+        default: false
+        description: "Generate Cursor-compatible content"
+
+      nested_files:
+        type: array
+        items:
+          type: object
+          required: [path]
+          properties:
+            path:
+              type: string
+            inherit:
+              type: boolean
+              default: true
+            sections:
+              type: object
+
+  definitions:
+    AgentsMdSection:
+      type: object
+      properties:
+        enabled:
+          type: boolean
+          default: true
+        source:
+          type: string
+          description: "OSSA manifest path (e.g., 'spec.tools')"
+        custom:
+          type: string
+          description: "Custom markdown content"
+        title:
+          type: string
+          description: "Section header override"
+        append:
+          type: string
+          description: "Content to append after auto-generated"
+
+  validation:
+    required: []
+    customRules:
+      - name: "validate-output-path"
+        rule: "output_path must end with .md extension or be 'AGENTS.md'"
+      - name: "validate-nested-paths"
+        rule: "nested_files paths must be valid relative directories"
+      - name: "validate-cursor-integration"
+        rule: "If cursor_integration is true, extensions.cursor should also be enabled"
+
+  migration:
+    fromVersion: null
+    toVersion: "v1"
+    breakingChanges: []
+    migrationGuide: "https://openstandardagents.org/docs/extensions/agents-md"
+
+  cliCommands:
+    - name: "ossa agents-md generate"
+      description: "Generate AGENTS.md from manifest"
+      usage: "ossa agents-md generate --manifest .agents/my-agent/manifest.yaml"
+    - name: "ossa agents-md validate"
+      description: "Validate AGENTS.md against manifest"
+      usage: "ossa agents-md validate --agents-md AGENTS.md --manifest .agents/my-agent/manifest.yaml"
+    - name: "ossa agents-md sync"
+      description: "Sync AGENTS.md with manifest changes"
+      usage: "ossa agents-md sync --watch"

package/examples/extensions/drupal-v1.yml

@@ -2,7 +2,7 @@
 # Extension specification for Drupal LLM Platform deployment
 # Compatible with Drupal 10+ and llm-platform modules
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.9
 kind: ExtensionSchema
 metadata:
   name: drupal-extension

package/examples/extensions/kagent-v1.yml

@@ -2,7 +2,7 @@
 # Production-grade specification for Kubernetes-native agent deployment
 # Compatible with kagent.dev/v1alpha1 CRDs
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.9
 kind: ExtensionSchema
 metadata:
   name: kagent-extension

package/examples/getting-started/hello-world-complete.ossa.yaml

@@ -32,7 +32,7 @@
 #
 # ============================================================================
 
-apiVersion: ossa/v0.2
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:

package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml

@@ -36,7 +36,7 @@
 # ----------------------------------------------------------------------------
 # Coordinates the workflow, delegates tasks to worker agents, and aggregates results
 
-apiVersion: ossa/v0.2
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -154,7 +154,7 @@ spec:
 # Specialized agent for research tasks
 
 ---
-apiVersion: ossa/v0.2
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -221,7 +221,7 @@ spec:
 # Specialized agent for data analysis
 
 ---
-apiVersion: ossa/v0.2
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -282,7 +282,7 @@ spec:
 # Specialized agent for content creation
 
 ---
-apiVersion: ossa/v0.2
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:

package/examples/kagent/compliance-validator.ossa.yaml

@@ -2,7 +2,7 @@
 # Compliance Validator Agent
 # Domain: compliance.validation.continuous
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: compliance-validator

package/examples/kagent/cost-optimizer.ossa.yaml

@@ -2,7 +2,7 @@
 # Cost Optimizer Agent
 # Domain: infrastructure.cost.optimization
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: cost-optimizer

package/examples/kagent/documentation-agent.ossa.yaml

@@ -2,7 +2,7 @@
 # Documentation Agent
 # Domain: documentation.generation.automated
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: documentation-agent

package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml

@@ -2,6 +2,7 @@
 # Kubernetes Troubleshooter Agent with KAgent Bridge
 # Fully compatible with kagent.dev/v1alpha2
 
+apiVersion: ossa/v0.2.9
 ossaVersion: "1.0"
 
 agent:

package/examples/kagent/k8s-troubleshooter-v1.v0.2.2.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: k8s-troubleshooter

package/examples/kagent/k8s-troubleshooter.ossa.yaml

@@ -17,7 +17,7 @@
 # Domain: infrastructure.kubernetes.troubleshooting
 # ============================================================================
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   # Basic agent identification metadata

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

@@ -6,7 +6,7 @@
 # Last Updated: 2025-11-10
 # ============================================================================
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   # Core identity metadata for the security scanning agent

package/examples/langchain/chain-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "langchain-agent",

package/examples/langflow/workflow-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "workflow-orchestrator",

package/examples/langgraph/state-machine-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "state-machine-agent",

package/examples/llamaindex/rag-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "rag-query-agent",

package/examples/migration-guides/from-langchain-to-ossa.yaml

@@ -50,7 +50,7 @@
 # OSSA MANIFEST (After):
 # ----------------------------------------------------------------------------
 
-apiVersion: ossa/v0.2.2
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -117,7 +117,7 @@ spec:
 # ----------------------------------------------------------------------------
 
 ---
-apiVersion: ossa/v0.2.2
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -185,7 +185,7 @@ spec:
 # ----------------------------------------------------------------------------
 
 ---
-apiVersion: ossa/v0.2.2
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:
@@ -215,7 +215,7 @@ spec:
       endpoint: https://api.academic.com/search
 
 ---
-apiVersion: ossa/v0.2.2
+apiVersion: ossa/v0.2.9
 kind: Agent
 
 metadata:

package/examples/multi-agent/README.md

@@ -0,0 +1,74 @@
+# Multi-Agent Examples
+
+Examples demonstrating different multi-agent patterns using OSSA.
+
+## Patterns
+
+### 1. Sequential Pipeline (`sequential-pipeline.ossa.yaml`)
+
+**Pattern**: Chain of agents processing data sequentially
+
+```
+Input → Researcher → Analyzer → Writer → Output
+```
+
+**Use Cases**:
+- Research and report generation
+- Data processing pipelines
+- Content creation workflows
+
+### 2. Parallel Execution (`parallel-execution.ossa.yaml`)
+
+**Pattern**: Fan-out to multiple agents, then fan-in to aggregate
+
+```
+        ┌─ Agent A ─┐
+Input ──┼─ Agent B ─┼─→ Aggregator → Output
+        └─ Agent C ─┘
+```
+
+**Use Cases**:
+- Parallel data processing
+- Multiple perspective analysis
+- Distributed task execution
+
+### 3. Conditional Router (`conditional-router.ossa.yaml`)
+
+**Pattern**: Router analyzes input and routes to specialist
+
+```
+                ┌─ Code Specialist
+Input → Router ─┼─ Data Specialist
+                └─ General Assistant
+```
+
+**Use Cases**:
+- Question routing
+- Skill-based delegation
+- Dynamic agent selection
+
+## Running Examples
+
+```bash
+# Validate examples
+ossa validate examples/multi-agent/*.yaml
+
+# Run sequential pipeline
+ossa run examples/multi-agent/sequential-pipeline.ossa.yaml
+
+# Run parallel execution
+ossa run examples/multi-agent/parallel-execution.ossa.yaml
+
+# Run conditional router
+ossa run examples/multi-agent/conditional-router.ossa.yaml
+```
+
+## Implementation Notes
+
+These examples show the OSSA manifest structure. Actual multi-agent orchestration requires:
+- Runtime that supports tool calling
+- Agent registry/discovery mechanism
+- Communication protocol between agents
+- State management
+
+See [Agent Buildkit](https://github.com/blueflyio/agent-buildkit) for production multi-agent orchestration.