@bluefly/openstandardagents 0.3.1 → 0.3.3

package/examples/reference-implementations/curl-scripts/05-discovery.sh

@@ -1,98 +0,0 @@
-#!/bin/bash
-#
-# OSSA API - Discovery Example
-#
-# Demonstrates agent discovery by taxonomy, capabilities, and compliance.
-#
-
-set -e
-
-# Configuration
-BASE_URL="${OSSA_BASE_URL:-https://registry.openstandardagents.org/api/v1}"
-
-echo "🔎 OSSA API - Discovery Example"
-echo ""
-
-# 1. List taxonomies
-echo "1️⃣  List available taxonomies..."
-curl -s "${BASE_URL}/specification/taxonomies" \
-  -H "Accept: application/json" \
-  | jq '.taxonomies[] | {domain: .domain, subdomains: (.subdomains | keys)}'
-
-echo ""
-
-# 2. List capabilities
-echo "2️⃣  List capabilities in security domain..."
-curl -s "${BASE_URL}/specification/capabilities?domain=security" \
-  -H "Accept: application/json" \
-  | jq '.capabilities[] | {name: .name, description: .description, domain: .domain}'
-
-echo ""
-
-# 3. Get capability details
-echo "3️⃣  Get capability details: vulnerability-detection..."
-curl -s "${BASE_URL}/specification/capabilities/vulnerability-detection" \
-  -H "Accept: application/json" \
-  | jq '{name: .name, description: .description, example_agents: .example_agents}'
-
-echo ""
-
-# 4. List compliance profiles
-echo "4️⃣  List compliance profiles..."
-curl -s "${BASE_URL}/specification/compliance" \
-  -H "Accept: application/json" \
-  | jq '.profiles[] | {id: .id, name: .name, agent_count: .agent_count}'
-
-echo ""
-
-# 5. Discover agents by taxonomy
-echo "5️⃣  Discover agents: domain=security, subdomain=vulnerability..."
-curl -s "${BASE_URL}/agents/discover/taxonomy?domain=security&subdomain=vulnerability" \
-  -H "Accept: application/json" \
-  | jq '{taxonomy: .taxonomy, total: .total, agents: .agents[] | {publisher: .publisher, name: .name, rating: .rating}}'
-
-echo ""
-
-# 6. Discover by compliance
-echo "6️⃣  Discover agents with FedRAMP and HIPAA compliance..."
-curl -s "${BASE_URL}/agents/discover/compliance?profiles=fedramp-moderate,hipaa" \
-  -H "Accept: application/json" \
-  | jq '{
-      compliance_profiles: .compliance_profiles,
-      total: .total,
-      agents: .agents[] | {name: .name, compliance_profiles: .compliance_profiles}
-    }'
-
-echo ""
-
-# 7. Get recommendations
-echo "7️⃣  Get agent recommendations..."
-RECOMMENDATION_REQUEST=$(cat <<'EOF'
-{
-  "use_case": "I need to scan my web application for security vulnerabilities",
-  "requirements": {
-    "compliance": ["fedramp-moderate"],
-    "budget": "$100/month",
-    "performance": "high"
-  },
-  "preferences": {
-    "verified_only": true,
-    "min_rating": 4.0
-  }
-}
-EOF
-)
-
-curl -s "${BASE_URL}/agents/recommend" \
-  -H "Content-Type: application/json" \
-  -H "Accept: application/json" \
-  -d "${RECOMMENDATION_REQUEST}" \
-  | jq '.recommendations[] | {
-      agent: .agent,
-      score: .score,
-      reasoning: .reasoning,
-      compliance_match: .compliance_match
-    }'
-
-echo ""
-echo "✅ Discovery examples completed!"

package/schemas/agent.json

@@ -1,523 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://api.llm.bluefly.io/schemas/agent.json",
-  "title": "OSSA Agent Schema",
-  "description": "JSON Schema for OSSA v0.3.0 Agent definitions supporting CRUD operations",
-  "type": "object",
-  "required": ["apiVersion", "kind", "metadata", "spec"],
-  "properties": {
-    "apiVersion": {
-      "type": "string",
-      "const": "ossa/v0.3.0",
-      "description": "OSSA specification version"
-    },
-    "kind": {
-      "type": "string",
-      "const": "Agent",
-      "description": "Resource type identifier"
-    },
-    "metadata": {
-      "$ref": "#/$defs/Metadata"
-    },
-    "spec": {
-      "$ref": "#/$defs/AgentSpec"
-    }
-  },
-  "$defs": {
-    "Metadata": {
-      "type": "object",
-      "required": ["name", "version"],
-      "properties": {
-        "name": {
-          "type": "string",
-          "pattern": "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$",
-          "minLength": 1,
-          "maxLength": 63,
-          "description": "Agent name in DNS label format"
-        },
-        "version": {
-          "type": "string",
-          "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9]+([.-][a-zA-Z0-9]+)*)?$",
-          "description": "Semantic version (e.g., 1.0.0, 2.1.3-beta)"
-        },
-        "description": {
-          "type": "string",
-          "description": "Human-readable description of the agent"
-        },
-        "labels": {
-          "type": "object",
-          "additionalProperties": {
-            "type": "string"
-          },
-          "description": "Key-value labels for categorization and filtering"
-        }
-      }
-    },
-    "AgentSpec": {
-      "type": "object",
-      "required": ["llm", "runtime", "capabilities"],
-      "properties": {
-        "llm": {
-          "$ref": "#/$defs/LLMConfig"
-        },
-        "execution_profile": {
-          "$ref": "#/$defs/ExecutionProfile"
-        },
-        "runtime": {
-          "$ref": "#/$defs/RuntimeConfig"
-        },
-        "capabilities": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/Capability"
-          },
-          "minItems": 1,
-          "description": "Agent capabilities and actions"
-        },
-        "functions": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/Function"
-          },
-          "description": "OpenAI-style function definitions"
-        },
-        "extensions": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/Extension"
-          },
-          "description": "External integrations and extensions"
-        },
-        "role": {
-          "type": "string",
-          "description": "Primary role of the agent"
-        },
-        "taxonomy": {
-          "$ref": "#/$defs/Taxonomy"
-        },
-        "tools": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/Tool"
-          },
-          "description": "MCP and other tool integrations"
-        },
-        "knowledge_graph": {
-          "$ref": "#/$defs/KnowledgeGraph"
-        }
-      }
-    },
-    "LLMConfig": {
-      "type": "object",
-      "required": ["provider", "model"],
-      "properties": {
-        "provider": {
-          "type": "string",
-          "description": "LLM provider (supports environment variable substitution)",
-          "examples": ["anthropic", "openai", "google", "mistral"]
-        },
-        "model": {
-          "type": "string",
-          "description": "Model identifier",
-          "examples": ["claude-sonnet-4", "gpt-4o", "gemini-2.0-flash"]
-        },
-        "profile": {
-          "type": "string",
-          "enum": ["fast", "balanced", "deep", "safe"],
-          "default": "balanced",
-          "description": "Execution profile for A2A compatibility"
-        },
-        "temperature": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 2,
-          "default": 0.1,
-          "description": "Sampling temperature for response generation"
-        },
-        "maxTokens": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 200000,
-          "default": 16000,
-          "description": "Maximum tokens in model response"
-        },
-        "topP": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "default": 0.9,
-          "description": "Nucleus sampling parameter"
-        },
-        "fallback_models": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/FallbackModel"
-          },
-          "description": "Fallback models for resilience"
-        },
-        "retry_config": {
-          "$ref": "#/$defs/RetryConfig"
-        }
-      }
-    },
-    "FallbackModel": {
-      "type": "object",
-      "required": ["provider", "model", "condition"],
-      "properties": {
-        "provider": {
-          "type": "string"
-        },
-        "model": {
-          "type": "string"
-        },
-        "condition": {
-          "type": "string",
-          "enum": ["on_error", "on_rate_limit", "on_timeout"],
-          "description": "Condition triggering fallback"
-        }
-      }
-    },
-    "RetryConfig": {
-      "type": "object",
-      "properties": {
-        "max_attempts": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 10,
-          "default": 3,
-          "description": "Maximum retry attempts"
-        },
-        "backoff_strategy": {
-          "type": "string",
-          "enum": ["linear", "exponential", "fibonacci"],
-          "default": "exponential",
-          "description": "Backoff strategy for retries"
-        }
-      }
-    },
-    "ExecutionProfile": {
-      "type": "object",
-      "properties": {
-        "default": {
-          "type": "string",
-          "enum": ["fast", "balanced", "deep", "safe"]
-        },
-        "profiles": {
-          "type": "object",
-          "additionalProperties": {
-            "$ref": "#/$defs/ProfileConfig"
-          }
-        }
-      }
-    },
-    "ProfileConfig": {
-      "type": "object",
-      "properties": {
-        "maxTokens": {
-          "type": "integer"
-        },
-        "temperature": {
-          "type": "number"
-        },
-        "reasoning_enabled": {
-          "type": "boolean"
-        },
-        "validation_required": {
-          "type": "boolean"
-        },
-        "audit_log": {
-          "type": "boolean"
-        },
-        "description": {
-          "type": "string"
-        }
-      }
-    },
-    "RuntimeConfig": {
-      "type": "object",
-      "required": ["type"],
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": ["unified", "kubernetes", "docker", "serverless", "local"],
-          "description": "Runtime environment type"
-        },
-        "supports": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "enum": ["google-a2a", "gitlab-duo", "ossa-mesh", "mcp", "local-execution"]
-          },
-          "description": "Supported runtime platforms"
-        },
-        "scheduling": {
-          "$ref": "#/$defs/SchedulingConfig"
-        },
-        "resource_limits": {
-          "$ref": "#/$defs/ResourceLimits"
-        }
-      }
-    },
-    "SchedulingConfig": {
-      "type": "object",
-      "properties": {
-        "strategy": {
-          "type": "string",
-          "enum": ["fair", "priority", "round-robin"],
-          "default": "fair"
-        },
-        "priority": {
-          "type": "string",
-          "enum": ["low", "normal", "high", "critical"],
-          "default": "normal"
-        },
-        "max_concurrent": {
-          "type": "integer",
-          "minimum": 1,
-          "default": 10,
-          "description": "Maximum concurrent executions"
-        },
-        "timeout_seconds": {
-          "type": "integer",
-          "minimum": 1,
-          "default": 300,
-          "description": "Execution timeout in seconds"
-        }
-      }
-    },
-    "ResourceLimits": {
-      "type": "object",
-      "properties": {
-        "memory_mb": {
-          "type": "integer",
-          "minimum": 128,
-          "default": 512,
-          "description": "Memory limit in megabytes"
-        },
-        "cpu_millicores": {
-          "type": "integer",
-          "minimum": 100,
-          "default": 500,
-          "description": "CPU limit in millicores"
-        }
-      }
-    },
-    "Capability": {
-      "type": "object",
-      "required": ["name", "type"],
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Capability identifier"
-        },
-        "type": {
-          "type": "string",
-          "enum": ["action", "query", "monitor", "transform"],
-          "description": "Capability type"
-        },
-        "runtime": {
-          "type": "string",
-          "enum": ["llm", "code", "hybrid"],
-          "description": "Runtime execution mode"
-        },
-        "description": {
-          "type": "string",
-          "description": "Human-readable description"
-        },
-        "input_schema": {
-          "type": "object",
-          "description": "JSON Schema for capability input validation"
-        }
-      }
-    },
-    "Function": {
-      "type": "object",
-      "required": ["name", "description", "parameters"],
-      "properties": {
-        "name": {
-          "type": "string",
-          "pattern": "^[a-z_][a-z0-9_]*$",
-          "description": "Function name (snake_case)"
-        },
-        "description": {
-          "type": "string",
-          "description": "Function description for LLM"
-        },
-        "parameters": {
-          "type": "object",
-          "description": "OpenAI-style function parameters (JSON Schema)"
-        },
-        "returns": {
-          "type": "object",
-          "description": "Return value schema"
-        }
-      }
-    },
-    "Extension": {
-      "type": "object",
-      "required": ["type", "name", "endpoint"],
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": ["http", "mcp", "grpc", "websocket"],
-          "description": "Extension protocol type"
-        },
-        "name": {
-          "type": "string",
-          "description": "Extension identifier"
-        },
-        "endpoint": {
-          "type": "string",
-          "format": "uri",
-          "description": "Extension endpoint URL"
-        },
-        "credentials_ref": {
-          "type": "string",
-          "description": "Reference to credentials in secrets manager"
-        }
-      }
-    },
-    "Taxonomy": {
-      "type": "object",
-      "properties": {
-        "domain": {
-          "type": "string",
-          "description": "Primary domain (e.g., security, development)"
-        },
-        "subdomain": {
-          "type": "string",
-          "description": "Subdomain specialization"
-        },
-        "capability": {
-          "type": "string",
-          "description": "Specific capability area"
-        }
-      }
-    },
-    "Tool": {
-      "type": "object",
-      "required": ["name", "source"],
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Tool identifier"
-        },
-        "description": {
-          "type": "string",
-          "description": "Tool description"
-        },
-        "source": {
-          "$ref": "#/$defs/ToolSource"
-        }
-      }
-    },
-    "ToolSource": {
-      "type": "object",
-      "required": ["type", "uri"],
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": ["mcp", "http", "grpc"],
-          "description": "Tool protocol type"
-        },
-        "uri": {
-          "type": "string",
-          "format": "uri",
-          "description": "Tool endpoint URI"
-        }
-      }
-    },
-    "KnowledgeGraph": {
-      "type": "object",
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false,
-          "description": "Enable knowledge graph integration"
-        },
-        "provider": {
-          "type": "string",
-          "enum": ["neo4j", "memgraph", "dgraph"],
-          "description": "Graph database provider"
-        },
-        "connection": {
-          "$ref": "#/$defs/GraphConnection"
-        }
-      }
-    },
-    "GraphConnection": {
-      "type": "object",
-      "properties": {
-        "endpoint": {
-          "type": "string",
-          "format": "uri",
-          "description": "Graph database endpoint"
-        },
-        "credentials_ref": {
-          "type": "string",
-          "description": "Reference to database credentials"
-        }
-      }
-    }
-  },
-  "examples": [
-    {
-      "apiVersion": "ossa/v0.3.0",
-      "kind": "Agent",
-      "metadata": {
-        "name": "security-scanner",
-        "version": "1.0.0",
-        "description": "Security vulnerability scanner for code repositories",
-        "labels": {
-          "domain": "security",
-          "capability": "scanning",
-          "runtime": "kubernetes"
-        }
-      },
-      "spec": {
-        "llm": {
-          "provider": "anthropic",
-          "model": "claude-sonnet-4",
-          "profile": "balanced",
-          "temperature": 0.1,
-          "maxTokens": 16000
-        },
-        "runtime": {
-          "type": "kubernetes",
-          "supports": ["ossa-mesh", "mcp"],
-          "scheduling": {
-            "strategy": "fair",
-            "priority": "normal",
-            "max_concurrent": 10,
-            "timeout_seconds": 300
-          },
-          "resource_limits": {
-            "memory_mb": 512,
-            "cpu_millicores": 500
-          }
-        },
-        "capabilities": [
-          {
-            "name": "security_scan",
-            "type": "action",
-            "runtime": "llm",
-            "description": "Run security analysis on code",
-            "input_schema": {
-              "type": "object",
-              "required": ["path"],
-              "properties": {
-                "path": {
-                  "type": "string"
-                },
-                "severity": {
-                  "type": "string",
-                  "enum": ["low", "medium", "high", "critical"]
-                }
-              }
-            }
-          }
-        ]
-      }
-    }
-  ]
-}