@bluefly/openstandardagents 0.3.5 → 0.4.0

package/examples/swarm/pso-optimizer.ossa.json

@@ -0,0 +1,171 @@
+{
+  "apiVersion": "ossa/v0.3.6",
+  "kind": "Agent",
+  "metadata": {
+    "name": "infrastructure-optimizer-swarm",
+    "namespace": "optimization",
+    "version": "2.1.0",
+    "description": "Particle Swarm Optimization coordinator for infrastructure cost optimization across multi-cloud environments",
+    "labels": {
+      "domain": "infrastructure",
+      "subdomain": "cloud",
+      "optimization": "pso",
+      "swarm-type": "coordinator"
+    },
+    "taxonomy": {
+      "domain": "infrastructure",
+      "subdomain": "cloud",
+      "capability": "cost_optimization",
+      "concerns": ["cost", "performance", "reliability"]
+    },
+    "catalog": {
+      "published": true,
+      "catalog_id": "ossa-swarm-pso-optimizer-001",
+      "visibility": "internal",
+      "categories": ["infrastructure", "optimization", "finops"],
+      "tags": ["pso", "swarm-intelligence", "cost-optimization", "multi-cloud"],
+      "pricing": {
+        "model": "enterprise"
+      }
+    },
+    "decentralized_identity": {
+      "did": "did:ossa:swarm-pso-coordinator-abc123def456",
+      "public_key": "ed25519:pso-coordinator-key",
+      "reputation": {
+        "credit_score": 875,
+        "trust_network": [
+          "did:ossa:finops-authority",
+          "did:ossa:cloud-optimization-guild"
+        ]
+      }
+    },
+    "lifecycle_stages": {
+      "current_stage": "mature",
+      "birth": {
+        "timestamp": "2025-09-15T00:00:00Z",
+        "birth_type": "created"
+      },
+      "growth": {
+        "tasks_completed": 1245,
+        "skills_acquired": ["multi_cloud_optimization", "cost_prediction", "workload_migration"]
+      },
+      "career": {
+        "current_role": "swarm_coordinator"
+      }
+    },
+    "team_membership": {
+      "team_id": "infrastructure-optimization-swarm",
+      "role": "leader",
+      "responsibilities": [
+        "Coordinate particle agents in swarm",
+        "Manage optimization objectives",
+        "Report optimization results",
+        "Adapt swarm parameters dynamically"
+      ],
+      "joined_at": "2025-09-15T00:00:00Z"
+    }
+  },
+  "spec": {
+    "type": "orchestrator",
+    "description": "PSO-based swarm coordinator for distributed infrastructure optimization",
+    "capabilities": [
+      {
+        "name": "optimize_infrastructure",
+        "input_schema": {
+          "type": "object",
+          "properties": {
+            "optimization_goal": {
+              "type": "string",
+              "enum": ["minimize_cost", "maximize_performance", "balance_cost_performance"]
+            },
+            "constraints": {
+              "type": "object",
+              "properties": {
+                "max_budget": {"type": "number"},
+                "min_availability": {"type": "number"},
+                "latency_threshold_ms": {"type": "number"}
+              }
+            },
+            "search_space": {
+              "type": "object",
+              "description": "Cloud resources and configurations to optimize",
+              "additionalProperties": true
+            }
+          }
+        },
+        "output_schema": {
+          "type": "object",
+          "properties": {
+            "optimal_configuration": {"type": "object"},
+            "cost_savings": {"type": "number"},
+            "iterations": {"type": "integer"},
+            "convergence_metrics": {"type": "object"}
+          }
+        }
+      }
+    ],
+    "swarm": {
+      "algorithm": "particle_swarm_optimization",
+      "config": {
+        "num_particles": 50,
+        "max_iterations": 100,
+        "inertia_weight": 0.7,
+        "cognitive_coefficient": 1.5,
+        "social_coefficient": 1.5,
+        "velocity_clamp": 0.5,
+        "convergence_threshold": 0.001
+      },
+      "particle_agents": [
+        {
+          "agent_id": "particle-001",
+          "agent_did": "did:ossa:particle-aws-optimizer",
+          "specialization": "aws_cost_optimization"
+        },
+        {
+          "agent_id": "particle-002",
+          "agent_did": "did:ossa:particle-gcp-optimizer",
+          "specialization": "gcp_cost_optimization"
+        },
+        {
+          "agent_id": "particle-003",
+          "agent_did": "did:ossa:particle-azure-optimizer",
+          "specialization": "azure_cost_optimization"
+        }
+      ],
+      "fitness_function": {
+        "type": "weighted_multi_objective",
+        "weights": {
+          "cost_reduction": 0.6,
+          "performance_improvement": 0.3,
+          "availability": 0.1
+        }
+      },
+      "communication": {
+        "topology": "fully_connected",
+        "update_frequency": "per_iteration",
+        "message_bus": "nats://agent-mesh:4222"
+      }
+    },
+    "runtime": {
+      "model": "claude-sonnet-4-5",
+      "temperature": 0.3,
+      "max_tokens": 12000
+    },
+    "observability": {
+      "metrics": {
+        "enabled": true,
+        "export_interval": "30s",
+        "metrics": [
+          "swarm_convergence_rate",
+          "particle_velocity_distribution",
+          "best_fitness_over_time",
+          "cost_savings_achieved"
+        ]
+      },
+      "logging": {
+        "level": "info",
+        "structured": true
+      }
+    }
+  }
+}

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

package/examples/templates/ossa-compliance.yaml

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

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

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

package/examples/v0.3.6/full-featured-v0.3.6.ossa.yaml

@@ -0,0 +1,304 @@
+apiVersion: ossa/v0.3.6
+kind: Agent
+metadata:
+  name: gitlab-mr-reviewer-pro
+  version: 1.0.0
+  description: "Enterprise-grade MR reviewer with token efficiency, composite identity, and knowledge graph"
+  efficiency_tier: economy  # Aggressive optimization
+
+  # Agent Catalog Metadata (v0.3.6+)
+  catalog:
+    published: true
+    catalog_id: gitlab-mr-reviewer-pro
+    visibility: internal
+    categories:
+      - code-quality
+      - security
+      - gitlab
+      - code-review
+    tags:
+      - gitlab-duo
+      - token-efficiency
+      - knowledge-graph
+      - composite-identity
+      - enterprise
+    icon_url: https://example.com/icons/mr-reviewer.svg
+    documentation_url: https://docs.example.com/mr-reviewer
+    pricing:
+      model: enterprise
+      subscription_monthly: 499
+    ratings:
+      average: 4.8
+      count: 127
+
+  labels:
+    cost-tier: economy
+    security-level: high
+    compliance: sox-gdpr
+    environment: production
+
+spec:
+  role: "Expert code reviewer with deep codebase understanding, security focus, and 95% cost efficiency"
+
+  # Composite Identity (GitLab Duo v0.3.6+)
+  identity:
+    provider: gitlab
+
+    composite:
+      enabled: true
+      merge_strategy: restrictive
+
+      primary_identity:
+        username: mr-review-bot
+        email: mr-review-bot@company.com
+        roles:
+          - developer
+
+      secondary_identity:
+        user_id: $GITLAB_USER_ID
+        username: $GITLAB_USERNAME
+        email: user@example.com
+
+      permissions:
+        read:
+          - repositories
+          - merge_requests
+          - pipelines
+        write:
+          - merge_request_comments
+        execute:
+          - code_analysis
+          - security_scan
+
+    authentication:
+      method: oauth2
+      scopes:
+        - api
+        - read_repository
+        - write_repository
+      auto_refresh: true
+
+    token_source:
+      env_var: GITLAB_COMPOSITE_TOKEN
+
+  llm:
+    provider: anthropic
+    model: claude-opus-4
+    temperature: 0.2
+    max_tokens: 8192
+
+  # Token Efficiency (v0.3.6+) - 95% savings
+  token_efficiency:
+    enabled: true
+
+    # Context Management: 70% savings
+    context_management:
+      strategy: adaptive
+      pruning:
+        enabled: true
+        threshold: 0.3
+        max_tokens: 50000
+        preserve_recent: 10
+      summarization:
+        enabled: true
+        model: haiku
+        compression_ratio: 0.2
+        trigger_threshold: 100000
+      caching:
+        enabled: true
+        ttl: 600
+        strategy: hybrid
+
+    # Prompt Caching: 90% savings
+    prompt_caching:
+      enabled: true
+      provider: anthropic
+      strategy: hybrid
+      cache_breakpoints:
+        - system_prompt
+        - knowledge_base
+        - recent_history
+        - tools
+      min_tokens: 1024
+      ttl: 300
+      estimated_savings: 90
+
+    # Token Budgets: Hard limits
+    token_budget:
+      enabled: true
+      input_limit: 150000
+      output_limit: 8192
+      total_limit: 160000
+      enforcement: adaptive
+      overflow_behavior: summarize
+
+    # Tool Output Limits
+    tool_output_limits:
+      enabled: true
+      max_tokens_per_tool: 10000
+      max_total_tokens: 100000
+      truncation_strategy: smart
+      large_output_handling: summarize
+
+    # Streaming for reduced latency
+    streaming:
+      enabled: true
+      chunk_size: 512
+
+    # Knowledge Graph: 98% savings
+    knowledge_graph:
+      enabled: true
+      max_context_tokens: 15000
+      indexing_strategy: selective
+
+    # Checkpoint Compression
+    checkpoint_compression:
+      enabled: true
+      strategy: delta
+      compression_ratio: 0.15
+
+    # Estimated Savings
+    estimated_savings:
+      percentage: 95
+      baseline_cost: 15
+      optimized_cost: 0.75
+
+  # Knowledge Sources with Compliance Enforcement
+  knowledge_sources:
+    - name: codebase-graph
+      provider: custom
+      config:
+        type: knowledge_graph
+        mcp_server: gitlab-kg
+
+  mandatory_knowledge_sources:
+    - source_id: react-best-practices
+      enforcement_level: query
+      triggers:
+        - "**/*.tsx"
+        - "**/*.jsx"
+    - source_id: typescript-standards
+      enforcement_level: validate
+      triggers:
+        - "**/*.ts"
+        - "**/*.tsx"
+    - source_id: security-patterns
+      enforcement_level: block
+      triggers:
+        - "**/*auth*.ts"
+        - "**/*security*.ts"
+
+  # MCP Extensions
+  extensions:
+    mcp:
+      servers:
+        - name: gitlab-kg
+          transport: http
+          oauth2:
+            enabled: true
+            registration_endpoint: https://gitlab.com/oauth/applications
+            scopes:
+              - api
+              - read_repository
+
+      tools:
+        - name: query_codebase
+          description: "Semantic code search"
+          server: gitlab-kg
+
+        - name: get_relationships
+          description: "Code relationships"
+          server: gitlab-kg
+
+        - name: security_scan
+          description: "Security vulnerability scan"
+          server: gitlab-kg
+
+  tools:
+    - type: mcp
+      name: gitlab-mr-tools
+      description: "GitLab MR operations"
+
+    - type: function
+      name: static-analysis
+      description: "ESLint, TypeScript, Prettier checks"
+
+    - type: function
+      name: security-scan
+      description: "SAST, dependency vulnerabilities"
+
+  autonomy:
+    level: assisted
+    approval_required:
+      - merge_request_approval
+      - code_modification
+    allowed_actions:
+      - add_comment
+      - request_changes
+      - run_analysis
+    blocked_actions:
+      - approve_mr
+      - merge_mr
+      - modify_code
+
+  observability:
+    enabled: true
+    tracing:
+      enabled: true
+      provider: opentelemetry
+      sampling_rate: 1
+    metrics:
+      track_tokens: true
+      track_cost: true
+      track_latency: true
+      track_quality: true
+    logging:
+      level: info
+      structured: true
+
+  safety:
+    sandboxing:
+      enabled: true
+      mode: strict
+    content_filtering:
+      enabled: true
+      blocklist:
+        - credentials
+        - api-keys
+        - passwords
+    rate_limiting:
+      enabled: true
+      requests_per_minute: 30
+
+  # Runtime Configuration
+  runtime:
+    max_turns: 20
+    checkpoint_interval: 5
+    environments:
+      production:
+        max_turns: 15
+        timeout: 300
+      staging:
+        max_turns: 20
+        timeout: 600
+
+  # Completion Signals
+  completion:
+    enabled: true
+    default_signal: complete
+    signals:
+      - signal: complete
+        description: "Review completed successfully"
+      - signal: blocked
+        description: "Security issues found"
+      - signal: escalate
+        description: "Complex issues require human review"
+
+  # Checkpointing
+  checkpointing:
+    enabled: true
+    strategy: interval
+    storage:
+      backend: agent-brain
+      location: redis://checkpoint-store:6379
+      retention: 7d

package/examples/v0.3.6/gitlab-duo-composite-identity.ossa.yaml

@@ -0,0 +1,119 @@
+apiVersion: ossa/v0.3.6
+kind: Agent
+metadata:
+  name: gitlab-deployment-agent
+  version: 1.0.0
+  description: "Deployment agent with GitLab Duo composite identity for attribution and security"
+  catalog:
+    published: true
+    visibility: internal
+    categories:
+      - devops
+      - deployment
+      - gitlab
+    tags:
+      - gitlab-duo
+      - composite-identity
+      - production-deployment
+    documentation_url: https://docs.example.com/deployment-agent
+
+spec:
+  role: "Production deployment orchestrator with human oversight and attribution"
+
+  # Composite Identity (GitLab Duo Agent Platform v0.3.6+)
+  # Merges service account (bot) + human user for security and attribution
+  identity:
+    provider: gitlab
+
+    # Composite Identity Configuration
+    composite:
+      enabled: true
+      merge_strategy: restrictive  # Intersection of permissions (most secure)
+
+      # Primary: Service account (bot)
+      primary_identity:
+        username: deploy-bot
+        email: deploy-bot@company.com
+        roles:
+          - deployer
+
+      # Secondary: Human operator (for attribution)
+      secondary_identity:
+        user_id: $GITLAB_USER_ID      # Injected by GitLab Duo
+        username: $GITLAB_USERNAME
+        email: user@example.com
+
+      # Explicit permission boundaries
+      permissions:
+        read:
+          - repositories
+          - deployments
+          - pipelines
+          - environments
+        write:
+          - deployments           # Service account can deploy
+          # Note: Cannot write to repositories (security)
+        execute:
+          - deploy-production     # Requires BOTH identities
+          - deploy-staging        # Service account only
+
+    # Authentication
+    authentication:
+      method: oauth2
+      scopes:
+        - api
+        - read_repository
+        - write_repository
+      auto_refresh: true
+
+    # Token source
+    token_source:
+      env_var: GITLAB_TOKEN       # Composite token from GitLab Duo
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4
+    temperature: 0.1              # Low temp for deterministic deployment
+
+  tools:
+    - type: kubernetes
+      name: k8s-deploy
+      description: "Kubernetes deployment operations"
+
+    - type: mcp
+      name: gitlab-api
+      description: "GitLab API access via MCP"
+
+    - type: function
+      name: pre-deploy-checks
+      description: "Validation before deployment"
+
+  autonomy:
+    level: assisted
+    approval_required:
+      - deploy-production        # Always require human approval for prod
+    allowed_actions:
+      - validate-deployment
+      - deploy-staging
+      - rollback
+    blocked_actions:
+      - force-push               # Never allowed
+      - delete-production        # Never allowed
+
+  observability:
+    enabled: true
+    tracing:
+      enabled: true
+      provider: opentelemetry
+    audit:
+      enabled: true
+      level: comprehensive       # Full audit trail for deployments
+      retention_days: 365
+
+  safety:
+    sandboxing:
+      enabled: true
+      mode: strict
+    rate_limiting:
+      enabled: true
+      requests_per_minute: 10