@bluefly/openstandardagents 0.2.9 → 0.3.0

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

@@ -0,0 +1,177 @@
+# OSSA agents.md Extension - Advanced Example
+# Demonstrates advanced features including Cursor integration and custom sections
+
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: fullstack-dev-agent
+  version: 2.1.0
+  description: Full-stack development agent with Cursor IDE integration
+  labels:
+    domain: development
+    subdomain: fullstack
+    environment: production
+
+spec:
+  role: |
+    You are a full-stack development agent that assists with both frontend
+    and backend development tasks. You follow best practices, write clean code,
+    and ensure comprehensive test coverage.
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-5-20250929
+    temperature: 0.4
+    maxTokens: 8000
+
+  tools:
+    - type: mcp
+      name: filesystem
+      server: filesystem-mcp
+      namespace: default
+      capabilities:
+        - read_file
+        - write_file
+        - list_directory
+
+    - type: mcp
+      name: database
+      server: postgres-mcp
+      namespace: production
+      capabilities:
+        - query
+        - migrate
+
+    - type: http
+      name: api_client
+      endpoint: https://api.example.com
+      auth:
+        type: bearer
+        credentials: ${API_TOKEN}
+
+  autonomy:
+    level: autonomous
+    approval_required: false
+    allowed_actions:
+      - create_files
+      - modify_code
+      - run_tests
+      - commit_changes
+    blocked_actions:
+      - delete_database
+      - modify_production_config
+
+  constraints:
+    cost:
+      maxTokensPerDay: 1000000
+      maxTokensPerRequest: 8000
+      maxCostPerDay: 50.00
+      currency: USD
+    performance:
+      maxLatencySeconds: 15
+      maxConcurrentRequests: 5
+      timeoutSeconds: 120
+    resources:
+      cpu: "2"
+      memory: 4Gi
+
+  observability:
+    tracing:
+      enabled: true
+      exporter: otlp
+      endpoint: https://trace.example.com
+    metrics:
+      enabled: true
+      exporter: prometheus
+    logging:
+      level: info
+      format: json
+
+extensions:
+  agents_md:
+    enabled: true
+    generate: true
+    output_path: .github/AGENTS.md
+    sections:
+      dev_environment:
+        enabled: true
+        source: spec.tools
+        custom: |
+          ## Prerequisites
+          - Node.js 20+
+          - PostgreSQL 15+
+          - Docker for local development
+
+          ## Setup
+          1. Install dependencies: `npm install`
+          2. Copy environment: `cp .env.example .env`
+          3. Start services: `docker-compose up -d`
+          4. Run migrations: `npm run migrate`
+
+      testing:
+        enabled: true
+        source: spec.constraints
+        custom: |
+          ## Test Requirements
+          - Unit tests: `npm run test:unit`
+          - Integration tests: `npm run test:integration`
+          - E2E tests: `npm run test:e2e`
+          - Coverage threshold: 80%
+
+          ## Performance Benchmarks
+          - API response time: < 200ms (p95)
+          - Database queries: < 50ms (p95)
+          - Memory usage: < 512MB
+
+      pr_instructions:
+        enabled: true
+        title_format: "[{metadata.labels.domain}] {title}"
+        custom: |
+          ## PR Guidelines
+          - Title format: `[domain] Brief description`
+          - Include issue reference: `Fixes #123`
+          - Add screenshots for UI changes
+          - Update CHANGELOG.md
+
+          ## Review Checklist
+          - [ ] Tests added/updated
+          - [ ] Documentation updated
+          - [ ] No breaking changes (or documented)
+          - [ ] Performance impact assessed
+          - [ ] Security implications reviewed
+
+    sync:
+      on_manifest_change: true
+      include_comments: true
+    cursor_integration: true
+
+  cursor:
+    enabled: true
+    agent_type: composer
+    workspace_config:
+      rules_file: .cursorrules
+      agents_md_path: .github/AGENTS.md
+      context_files:
+        - README.md
+        - CONTRIBUTING.md
+        - .github/AGENTS.md
+        - docs/architecture.md
+      ignore_patterns:
+        - "node_modules/**"
+        - "dist/**"
+        - "*.log"
+    capabilities:
+      code_generation: true
+      code_review: true
+      refactoring: true
+      testing: true
+    model:
+      provider: anthropic
+      name: claude-sonnet-4-5-20250929
+
+  anthropic:
+    enabled: true
+    model: claude-sonnet-4-5-20250929
+    max_tokens: 8000
+    temperature: 0.4
+    streaming: true

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

@@ -0,0 +1,74 @@
+# OSSA agents.md Extension - Basic Example
+# Demonstrates basic agents.md generation from OSSA manifest
+
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: code-review-agent
+  version: 1.0.0
+  description: AI agent for automated code review and quality checks
+  labels:
+    domain: development
+    capability: code-review
+
+spec:
+  role: |
+    You are a code review agent that analyzes pull requests for code quality,
+    best practices, and potential issues. You provide constructive feedback
+    and suggest improvements.
+
+  llm:
+    provider: openai
+    model: gpt-4
+    temperature: 0.3
+    maxTokens: 4000
+
+  tools:
+    - type: mcp
+      name: git_operations
+      server: git-mcp-server
+      namespace: default
+      capabilities:
+        - read_diff
+        - list_files
+        - get_file_content
+
+    - type: function
+      name: run_linter
+      config:
+        command: npm run lint
+
+  autonomy:
+    level: supervised
+    approval_required: true
+    allowed_actions:
+      - comment_on_pr
+      - request_changes
+      - approve_pr
+
+  constraints:
+    performance:
+      maxLatencySeconds: 30
+      timeoutSeconds: 60
+
+extensions:
+  agents_md:
+    enabled: true
+    generate: true
+    output_path: AGENTS.md
+    sections:
+      dev_environment:
+        enabled: true
+        source: spec.tools
+      testing:
+        enabled: true
+        custom: |
+          - Run linting: `npm run lint`
+          - Run tests: `npm test`
+          - Ensure all checks pass before requesting review
+      pr_instructions:
+        enabled: true
+        source: spec.autonomy
+    sync:
+      on_manifest_change: true
+      include_comments: true

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

@@ -0,0 +1,96 @@
+# OSSA agents.md Extension - Sync Example
+# Demonstrates automatic synchronization configuration
+
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: docs-agent
+  version: 1.0.0
+  description: Documentation maintenance agent with auto-sync
+  labels:
+    domain: documentation
+    capability: generation
+
+spec:
+  role: |
+    You are a documentation agent that maintains project documentation,
+    generates API docs, and keeps AGENTS.md synchronized with the manifest.
+
+  llm:
+    provider: openai
+    model: gpt-4o
+    temperature: 0.5
+    maxTokens: 4000
+
+  tools:
+    - type: mcp
+      name: markdown_tools
+      server: markdown-mcp
+      capabilities:
+        - parse_markdown
+        - generate_toc
+        - validate_links
+
+    - type: function
+      name: generate_api_docs
+      config:
+        tool: typedoc
+        output: docs/api
+
+  autonomy:
+    level: autonomous
+    approval_required: false
+    allowed_actions:
+      - update_documentation
+      - generate_diagrams
+      - fix_broken_links
+
+  constraints:
+    performance:
+      maxLatencySeconds: 20
+      timeoutSeconds: 45
+
+extensions:
+  agents_md:
+    enabled: true
+    generate: true
+    output_path: AGENTS.md
+    sections:
+      dev_environment:
+        enabled: true
+        custom: |
+          ## Documentation Tools
+          - Markdown editor (VS Code recommended)
+          - PlantUML for diagrams
+          - Vale for style checking
+
+          ## Commands
+          - Generate docs: `npm run docs:generate`
+          - Validate links: `npm run docs:validate`
+          - Preview: `npm run docs:serve`
+
+      testing:
+        enabled: true
+        custom: |
+          ## Documentation Quality Checks
+          - Run Vale linter: `vale docs/`
+          - Check broken links: `npm run docs:check-links`
+          - Validate examples: `npm run docs:test-examples`
+
+      pr_instructions:
+        enabled: true
+        custom: |
+          ## Documentation PR Requirements
+          - Update table of contents if adding new pages
+          - Run spell check: `npm run docs:spell-check`
+          - Ensure all code examples are tested
+          - Add screenshots for visual changes
+          - Update version in docs if needed
+
+    sync:
+      on_manifest_change: true
+      include_comments: true
+
+  # Example: Use with ossa agents-md sync command
+  # Command: ossa agents-md sync .agents/docs-agent/manifest.yaml --watch
+  # This will automatically regenerate AGENTS.md whenever the manifest changes

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

@@ -2,7 +2,7 @@
 # OpenAI agents.md repository-level agent guidance generation
 # See: https://agents.md | https://github.com/openai/agents.md
 
-apiVersion: ossa/v0.2.9
+apiVersion: ossa/v0.3.0
 kind: ExtensionSchema
 metadata:
   name: agents-md-extension

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/v0.2.9
+apiVersion: ossa/v0.3.0
 kind: ExtensionSchema
 metadata:
   name: drupal-extension

package/examples/extensions/encryption-multi-provider.yaml

@@ -0,0 +1,120 @@
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: secure-agent
+  description: Agent with encrypted state storage across multiple providers
+spec:
+  model:
+    provider: openai
+    name: gpt-4
+  state:
+    storage:
+      provider: redis
+      config:
+        url: redis://localhost:6379
+        db: 0
+    encryption:
+      enabled: true
+      provider: aws-kms
+      config:
+        key_id: arn:aws:kms:us-east-1:123456789:key/abc-def-ghi
+        region: us-east-1
+      fields:
+        - conversation_history
+        - user_context
+        - api_credentials
+      rotation:
+        enabled: true
+        interval_days: 90
+        
+---
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: vault-encrypted-agent
+  description: Agent using HashiCorp Vault for encryption
+spec:
+  model:
+    provider: anthropic
+    name: claude-3-opus-20240229
+  state:
+    storage:
+      provider: postgres
+      config:
+        connection_string: ${DATABASE_URL}
+    encryption:
+      enabled: true
+      provider: vault
+      config:
+        address: https://vault.example.com
+        namespace: production
+        mount_path: transit
+        key_name: agent-encryption-key
+        auth:
+          method: kubernetes
+          role: agent-service
+      fields:
+        - "*"  # Encrypt all fields
+      
+---
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: gcp-kms-agent
+  description: Agent using Google Cloud KMS
+spec:
+  model:
+    provider: google
+    name: gemini-pro
+  state:
+    storage:
+      provider: firestore
+      config:
+        project_id: my-project
+        collection: agent-state
+    encryption:
+      enabled: true
+      provider: gcp-kms
+      config:
+        project_id: my-project
+        location: us-central1
+        key_ring: agent-keys
+        key_name: state-encryption
+        service_account_key: ${GCP_SA_KEY}
+      fields:
+        - sensitive_data
+        - pii_fields
+      
+---
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: azure-keyvault-agent
+  description: Agent using Azure Key Vault
+spec:
+  model:
+    provider: azure
+    name: gpt-4
+  state:
+    storage:
+      provider: cosmosdb
+      config:
+        endpoint: https://myaccount.documents.azure.com
+        database: agents
+        container: state
+    encryption:
+      enabled: true
+      provider: azure-keyvault
+      config:
+        vault_url: https://myvault.vault.azure.net
+        key_name: agent-encryption-key
+        tenant_id: ${AZURE_TENANT_ID}
+        client_id: ${AZURE_CLIENT_ID}
+        client_secret: ${AZURE_CLIENT_SECRET}
+      fields:
+        - conversation_history
+        - user_preferences
+      rotation:
+        enabled: true
+        interval_days: 30
+        notify_before_days: 7

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/v0.2.9
+apiVersion: ossa/v0.3.0
 kind: ExtensionSchema
 metadata:
   name: kagent-extension
@@ -130,7 +130,7 @@ spec:
                 enum: [compliance-engine, agent-tracer, external]
               retention:
                 type: string
-                pattern: "^\d+[years|months|days]$"
+                pattern: "^\\d+[years|months|days]$"
               description: "Audit logging configuration"
 
       meshIntegration:

package/examples/extensions/knowledge-sources.yaml

@@ -0,0 +1,59 @@
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: rag-agent
+  description: Agent with multiple knowledge source integrations
+spec:
+  model:
+    provider: openai
+    name: gpt-4
+  capabilities:
+    - semantic_search
+    - context_retrieval
+extensions:
+  knowledge_sources:
+    - name: airweave-docs
+      provider: airweave
+      config:
+        api_url: https://api.airweave.ai/v1
+        collection_id: technical-docs
+        embedding_model: text-embedding-3-large
+      auth:
+        type: bearer
+        token_env: AIRWEAVE_API_KEY
+      search:
+        default_strategy: hybrid
+        top_k: 10
+        min_score: 0.7
+        rerank: true
+    
+    - name: langchain-kb
+      provider: langchain
+      config:
+        retriever_type: multi_query
+        vectorstore: pinecone
+        index_name: knowledge-base
+        namespace: production
+        embedding_model: text-embedding-ada-002
+      auth:
+        type: api_key
+        key_env: PINECONE_API_KEY
+      search:
+        default_strategy: semantic
+        top_k: 5
+    
+    - name: llamaindex-corpus
+      provider: llamaindex
+      config:
+        api_url: https://llamaindex.example.com
+        index_name: main-corpus
+      auth:
+        type: bearer
+        token_env: LLAMAINDEX_TOKEN
+      search:
+        default_strategy: neural
+        top_k: 8
+        filters:
+          - field: category
+            operator: in
+            values: [technical, reference]

package/examples/extensions/mcp-full-featured.yaml

@@ -0,0 +1,150 @@
+apiVersion: ossa/v0.3.0
+kind: Agent
+metadata:
+  name: mcp-powered-agent
+  description: Agent with full MCP capabilities - resources, prompts, and tools
+spec:
+  model:
+    provider: anthropic
+    name: claude-3-5-sonnet-20241022
+  capabilities:
+    - mcp_resources
+    - mcp_prompts
+    - mcp_tools
+extensions:
+  mcp:
+    servers:
+      - name: filesystem
+        command: npx
+        args: ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
+        resources:
+          - uri: file:///workspace/docs/**/*.md
+            name: documentation
+            description: Project documentation files
+            mimeType: text/markdown
+          - uri: file:///workspace/src/**/*.ts
+            name: source-code
+            description: TypeScript source files
+            mimeType: text/typescript
+        
+      - name: github
+        command: npx
+        args: ["-y", "@modelcontextprotocol/server-github"]
+        env:
+          GITHUB_TOKEN: ${GITHUB_TOKEN}
+        resources:
+          - uri: github://owner/repo/issues
+            name: github-issues
+            description: Repository issues
+          - uri: github://owner/repo/pulls
+            name: github-prs
+            description: Pull requests
+        tools:
+          - name: create_issue
+            description: Create a new GitHub issue
+            inputSchema:
+              type: object
+              properties:
+                title: { type: string }
+                body: { type: string }
+                labels: { type: array, items: { type: string } }
+          - name: create_pull_request
+            description: Create a new pull request
+        
+      - name: postgres
+        command: npx
+        args: ["-y", "@modelcontextprotocol/server-postgres"]
+        env:
+          DATABASE_URL: ${DATABASE_URL}
+        resources:
+          - uri: postgres://localhost/mydb/schema
+            name: database-schema
+            description: Database schema information
+        tools:
+          - name: query
+            description: Execute SQL query
+            inputSchema:
+              type: object
+              properties:
+                sql: { type: string }
+                params: { type: array }
+      
+      - name: brave-search
+        command: npx
+        args: ["-y", "@modelcontextprotocol/server-brave-search"]
+        env:
+          BRAVE_API_KEY: ${BRAVE_API_KEY}
+        tools:
+          - name: brave_web_search
+            description: Search the web using Brave
+            inputSchema:
+              type: object
+              properties:
+                query: { type: string }
+                count: { type: integer, default: 10 }
+    
+    prompts:
+      - name: code-review
+        description: Review code changes with context
+        arguments:
+          - name: file_path
+            description: Path to file being reviewed
+            required: true
+          - name: changes
+            description: Git diff of changes
+            required: true
+        template: |
+          Review the following code changes in {{ file_path }}:
+          
+          ```diff
+          {{ changes }}
+          ```
+          
+          Consider:
+          1. Code quality and best practices
+          2. Potential bugs or edge cases
+          3. Performance implications
+          4. Security concerns
+          5. Test coverage
+      
+      - name: bug-analysis
+        description: Analyze bug report with full context
+        arguments:
+          - name: issue_number
+            required: true
+          - name: error_logs
+            required: false
+        template: |
+          Analyze bug #{{ issue_number }}
+          
+          {% if error_logs %}
+          Error logs:
+          ```
+          {{ error_logs }}
+          ```
+          {% endif %}
+          
+          Steps:
+          1. Review related code from filesystem
+          2. Check recent commits from GitHub
+          3. Query database for relevant data
+          4. Search for similar issues
+      
+      - name: feature-implementation
+        description: Implement new feature with full context
+        arguments:
+          - name: feature_name
+            required: true
+          - name: requirements
+            required: true
+        template: |
+          Implement feature: {{ feature_name }}
+          
+          Requirements:
+          {{ requirements }}
+          
+          Use available resources:
+          - Read existing code patterns
+          - Check database schema
+          - Review similar implementations
+          - Create GitHub issue for tracking