@bluefly/openstandardagents 0.2.8 → 0.2.9

package/examples/adk-integration/code-review-workflow.yml

@@ -1,7 +1,7 @@
 # Example: ADK Code Review Workflow with OSSA Agents
 # This demonstrates how OSSA agents work with ADK orchestration patterns
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Workflow
 metadata:
   name: code-review-workflow

package/examples/adk-integration/customer-support.yml

@@ -1,7 +1,7 @@
 # Example: ADK Customer Support System with OSSA Agents
 # Demonstrates Coordinator and Dispatcher patterns
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Workflow
 metadata:
   name: customer-support-system

package/examples/adk-integration/data-pipeline.yml

@@ -1,7 +1,7 @@
 # Example: ADK Data Processing Pipeline with OSSA Agents
 # Demonstrates LoopAgent and ConditionalAgent patterns
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Workflow
 metadata:
   name: data-processing-pipeline

package/examples/advanced/reasoning-agent.yaml

@@ -0,0 +1,136 @@
+# OSSA v0.2.9 - Reasoning Agent Example
+# Demonstrates: reasoning strategies, prompt templates, knowledge graph
+apiVersion: ossa/v0.2.9
+kind: Agent
+metadata:
+  name: research-analyst
+  version: 1.0.0
+  description: Research analyst with ReAct reasoning, knowledge graph, and versioned prompts
+  labels:
+    domain: research
+    capability: analysis
+    reasoning: react
+
+spec:
+  taxonomy:
+    domain: research
+    subdomain: analysis
+    capability: synthesis
+
+  role: |
+    You are a research analyst specializing in synthesizing complex information.
+    Use the ReAct reasoning pattern: Thought → Action → Observation.
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-20250514
+    parameters:
+      temperature: 0.3
+      max_tokens: 4096
+
+  # NEW: Reasoning configuration
+  reasoning:
+    strategy: react
+    max_steps: 15
+    trace_enabled: true
+    export_format: otel
+    self_reflection:
+      enabled: true
+      trigger: on_uncertainty
+      threshold: 0.6
+
+  # NEW: Prompt management with versioning
+  prompts:
+    system:
+      template: prompts/research-system-v2.md
+      version: "2.1.0"
+      variables:
+        domain: "market-research"
+        output_format: "structured-report"
+    few_shot_examples:
+      - input: "Analyze the competitive landscape for AI agents"
+        output: |
+          Thought: I need to identify key players, their offerings, and market positioning.
+          Action: search_knowledge_graph for entities with type=AIVendor
+          Observation: Found 12 major vendors including OpenAI, Anthropic, Google...
+      - input: "What are the emerging trends in agent frameworks?"
+        output: |
+          Thought: I should look for recent publications and framework releases.
+          Action: query_research_db for papers published > 2024-01
+          Observation: 47 relevant papers found, clustering around multi-agent and RAG...
+
+  # NEW: Knowledge graph integration
+  knowledge_graph:
+    enabled: true
+    provider: neo4j
+    connection:
+      endpoint: bolt://kg.internal:7687
+      database: research_graph
+      credentials_ref: KG_CREDENTIALS
+    schema:
+      entity_types:
+        - Company
+        - Product
+        - Technology
+        - Publication
+        - Person
+      relationship_types:
+        - COMPETES_WITH
+        - DEVELOPS
+        - PUBLISHES
+        - CITES
+        - EMPLOYS
+    sync:
+      mode: real_time
+      batch_size: 50
+      interval: 30s
+
+  tools:
+    - name: search_knowledge_graph
+      description: Query the knowledge graph for entity relationships
+      source:
+        type: mcp
+        uri: mcp://kg-service/query
+      input:
+        type: object
+        required: [query]
+        properties:
+          query:
+            type: string
+            description: Cypher query or natural language search
+
+    - name: query_research_db
+      description: Search research papers and publications
+      source:
+        type: mcp
+        uri: mcp://research-service/search
+
+  autonomy:
+    level: assisted
+    escalation:
+      enabled: true
+      triggers:
+        - low_confidence
+        - external_data_required
+
+  observability:
+    tracing:
+      enabled: true
+      provider: otel
+      sampling_rate: 1.0
+    metrics:
+      enabled: true
+      custom:
+        - name: reasoning_steps_total
+          type: counter
+          description: Total reasoning steps executed
+        - name: kg_queries_total
+          type: counter
+          description: Knowledge graph queries executed
+    logging:
+      level: debug
+
+  constraints:
+    max_tokens_per_turn: 8000
+    max_turns: 20
+    timeout_seconds: 300

package/examples/advanced/workflows/hybrid-model-strategy.yaml

@@ -1,7 +1,7 @@
 # Hybrid Model Strategy: Fast Local Planning + Premium Development
 # Demonstrates using fast Ollama models for planning agents and Claude for development
 
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Workflow
 metadata:
   name: hybrid-development-workflow

package/examples/agent-manifests/critics/critic-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: code-quality-critic

package/examples/agent-manifests/governors/governor-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: policy-compliance-governor

package/examples/agent-manifests/integrators/integrator-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: multi-system-integrator

package/examples/agent-manifests/judges/judge-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: decision-arbitration-judge

package/examples/agent-manifests/monitors/monitor-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: system-performance-monitor

package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml

@@ -20,7 +20,7 @@
 # ============================================================================
 
 # OSSA manifest version - defines the schema and features available
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 
 # Kind declares this as an Agent manifest (vs. Bridge, Tool, etc.)
 kind: Agent

package/examples/agent-manifests/sample-compliant-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8-alpha.1
+apiVersion: ossa/v0.2.9-alpha.1
 kind: Agent
 metadata:
   name: financial-data-processor

package/examples/agent-manifests/workers/worker-agent.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: data-processing-worker

package/examples/agents-md/code-agent.ossa.json

@@ -0,0 +1,100 @@
+{
+  "apiVersion": "ossa/v0.2.9",
+  "kind": "Agent",
+  "metadata": {
+    "name": "code-assistant",
+    "version": "1.0.0",
+    "description": "AI coding agent with agents.md repository guidance",
+    "labels": {
+      "domain": "development",
+      "framework": "agents-md"
+    }
+  },
+  "spec": {
+    "role": "You are an expert software developer. Follow the project's coding standards and conventions. Write clean, maintainable code with proper tests.",
+    "llm": {
+      "provider": "openai",
+      "model": "gpt-4o",
+      "temperature": 0.2
+    },
+    "tools": [
+      {
+        "type": "mcp",
+        "name": "filesystem",
+        "server": "filesystem",
+        "capabilities": [
+          { "name": "read_file" },
+          { "name": "write_file" },
+          { "name": "list_directory" }
+        ]
+      },
+      {
+        "type": "mcp",
+        "name": "git",
+        "server": "git",
+        "capabilities": [
+          { "name": "status" },
+          { "name": "diff" },
+          { "name": "commit" }
+        ]
+      }
+    ],
+    "constraints": {
+      "performance": {
+        "maxLatencySeconds": 30,
+        "timeoutSeconds": 120
+      }
+    },
+    "autonomy": {
+      "level": "supervised",
+      "approval_required": true,
+      "allowed_actions": ["read", "write", "test"],
+      "blocked_actions": ["deploy", "delete"]
+    }
+  },
+  "extensions": {
+    "agents_md": {
+      "enabled": true,
+      "generate": true,
+      "output_path": "AGENTS.md",
+      "sections": {
+        "dev_environment": {
+          "enabled": true,
+          "source": "spec.tools",
+          "append": "- Use `pnpm` for package management\n- Run `pnpm dev` to start development server"
+        },
+        "testing": {
+          "enabled": true,
+          "custom": "Run `pnpm test` before committing.\nEnsure all tests pass and coverage is maintained.\nUse Jest for unit tests and Playwright for E2E."
+        },
+        "pr_instructions": {
+          "enabled": true,
+          "source": "spec.autonomy",
+          "custom": "- Use conventional commits format\n- Include tests for new features\n- Update documentation as needed\n- Request review from at least one team member"
+        },
+        "code_style": {
+          "enabled": true,
+          "custom": "- TypeScript strict mode enabled\n- ESLint + Prettier for formatting\n- Prefer functional programming patterns\n- Use descriptive variable names"
+        }
+      },
+      "sync": {
+        "on_manifest_change": true,
+        "include_comments": true
+      },
+      "mapping": {
+        "tools_to_dev_environment": true,
+        "constraints_to_testing": true,
+        "autonomy_to_pr_instructions": true
+      },
+      "cursor_integration": true
+    },
+    "cursor": {
+      "enabled": true,
+      "agent_type": "composer",
+      "workspace_config": {
+        "context_files": ["src/**/*.ts", "tests/**/*.ts"],
+        "ignore_patterns": ["node_modules/**", "dist/**"]
+      }
+    }
+  }
+}

package/examples/agents-md/monorepo-agent.ossa.yaml

@@ -0,0 +1,180 @@
+# OSSA Agent Manifest with agents.md Extension
+# Demonstrates monorepo support with nested AGENTS.md files
+apiVersion: ossa/v0.2.9
+kind: Agent
+metadata:
+  name: monorepo-assistant
+  version: 1.0.0
+  description: Multi-package monorepo coding agent with nested agents.md support
+  labels:
+    domain: development
+    framework: agents-md
+    architecture: monorepo
+
+spec:
+  role: |
+    You are an expert developer working on a monorepo containing multiple packages.
+    Each package has its own conventions and testing requirements.
+    Always check the local AGENTS.md file in the current directory for package-specific guidance.
+
+  llm:
+    provider: anthropic
+    model: claude-3-5-sonnet-20241022
+    temperature: 0.1
+
+  tools:
+    - type: mcp
+      name: filesystem
+      server: filesystem
+      capabilities:
+        - name: read_file
+        - name: write_file
+        - name: search_files
+    - type: mcp
+      name: git
+      server: git
+      capabilities:
+        - name: status
+        - name: diff
+        - name: log
+    - type: http
+      name: npm-registry
+      endpoint: https://registry.npmjs.org
+      capabilities:
+        - name: search_packages
+
+  constraints:
+    cost:
+      maxTokensPerDay: 100000
+      maxTokensPerRequest: 8000
+    performance:
+      maxLatencySeconds: 60
+      timeoutSeconds: 180
+
+  autonomy:
+    level: autonomous
+    approval_required: false
+    allowed_actions:
+      - read
+      - write
+      - test
+      - lint
+      - format
+    blocked_actions:
+      - publish
+      - deploy
+      - delete_branch
+
+extensions:
+  agents_md:
+    enabled: true
+    generate: true
+    output_path: AGENTS.md
+
+    sections:
+      dev_environment:
+        enabled: true
+        title: "Development Environment"
+        custom: |
+          - This is a pnpm workspace monorepo
+          - Run `pnpm install` from root to install all dependencies
+          - Use `pnpm -F <package>` to run commands in specific packages
+          - Turborepo is used for task orchestration
+
+      testing:
+        enabled: true
+        title: "Testing Requirements"
+        custom: |
+          - Run `pnpm test` to execute all tests
+          - Run `pnpm -F <package> test` for package-specific tests
+          - Coverage threshold is 80% for all packages
+          - E2E tests are in `apps/web/e2e/`
+
+      pr_instructions:
+        enabled: true
+        title: "Pull Request Guidelines"
+        custom: |
+          - Use conventional commits: `feat:`, `fix:`, `chore:`, etc.
+          - PRs must pass CI checks before merge
+          - Changesets are required for publishable packages
+          - Run `pnpm changeset` to create a changeset
+
+      code_style:
+        enabled: true
+        custom: |
+          - TypeScript strict mode in all packages
+          - Biome for linting and formatting
+          - Run `pnpm lint` and `pnpm format` before committing
+
+      custom:
+        - title: "Package Structure"
+          content: |
+            - `apps/` - Application packages (web, api, cli)
+            - `packages/` - Shared library packages
+            - `tooling/` - Build and development tools
+
+    sync:
+      on_manifest_change: true
+      include_comments: true
+      watch: false
+
+    mapping:
+      tools_to_dev_environment: true
+      constraints_to_testing: true
+      autonomy_to_pr_instructions: true
+
+    # Nested AGENTS.md files for each package
+    nested_files:
+      - path: apps/web
+        inherit: true
+        sections:
+          dev_environment:
+            custom: |
+              - Next.js 14 application
+              - Run `pnpm -F web dev` to start dev server
+              - Uses App Router and Server Components
+          testing:
+            custom: |
+              - Playwright for E2E tests
+              - React Testing Library for component tests
+              - Run `pnpm -F web test:e2e` for E2E
+
+      - path: apps/api
+        inherit: true
+        sections:
+          dev_environment:
+            custom: |
+              - Hono API server
+              - Run `pnpm -F api dev` to start
+              - OpenAPI spec in `openapi.yaml`
+          testing:
+            custom: |
+              - Vitest for unit tests
+              - Integration tests require Docker
+              - Run `docker-compose up -d` first
+
+      - path: packages/ui
+        inherit: true
+        sections:
+          dev_environment:
+            custom: |
+              - Shared React component library
+              - Run `pnpm -F ui storybook` for component preview
+              - Uses Radix UI primitives
+          testing:
+            custom: |
+              - Storybook visual tests
+              - Run `pnpm -F ui test:visual`
+
+  cursor:
+    enabled: true
+    agent_type: composer
+    workspace_config:
+      context_files:
+        - "**/*.ts"
+        - "**/*.tsx"
+        - "**/package.json"
+      ignore_patterns:
+        - "**/node_modules/**"
+        - "**/dist/**"
+        - "**/.turbo/**"

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

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.8",
+  "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.8",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "autogen-assistant",

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: claude-code-reviewer

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: ossa-validator
@@ -48,7 +48,7 @@ spec:
             type: string
           target_version:
             type: string
-            default: "0.2.8"
+            default: "0.2.9"
         required: [source_path]
 
   tools:

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.8
+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/v0.2.8
+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.8",
+  "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.8",
+  "apiVersion": "ossa/v0.2.9",
   "kind": "Agent",
   "metadata": {
     "name": "code-review-agent",

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

@@ -37,7 +37,7 @@
 # ============================================================================
 
 # OSSA specification version - defines which features are available
-apiVersion: ossa/v0.2.8
+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/v0.2.8
+apiVersion: ossa/v0.2.9
 kind: Agent
 metadata:
   name: gitlab-ml-recommender