@bluefly/openstandardagents 0.3.2 → 0.3.3

package/examples/reference-implementations/curl-scripts/01-search-agents.sh

@@ -1,72 +0,0 @@
-#!/bin/bash
-#
-# OSSA API - Search Agents Example
-#
-# Demonstrates searching for agents using various filters.
-#
-
-set -e
-
-# Configuration
-BASE_URL="${OSSA_BASE_URL:-https://registry.openstandardagents.org/api/v1}"
-TOKEN="${OSSA_TOKEN:-}"
-
-echo "🔍 OSSA API - Search Agents Example"
-echo ""
-
-# 1. Search for security agents
-echo "1️⃣  Search for security agents..."
-curl -s "${BASE_URL}/agents?domain=security&limit=5&sort=downloads" \
-  -H "Accept: application/json" \
-  | jq '.agents[] | {name: .name, publisher: .publisher, version: .version, rating: .rating, downloads: .downloads}'
-
-echo ""
-
-# 2. Search with full-text query
-echo "2️⃣  Full-text search for 'vulnerability scanner'..."
-curl -s "${BASE_URL}/agents?q=vulnerability+scanner&limit=3" \
-  -H "Accept: application/json" \
-  | jq '.agents[] | {name: .name, description: .description}'
-
-echo ""
-
-# 3. Filter by capability
-echo "3️⃣  Filter by capability: vulnerability-detection..."
-curl -s "${BASE_URL}/agents?capability=vulnerability-detection&limit=3" \
-  -H "Accept: application/json" \
-  | jq '.agents[] | {name: .name, capabilities: .capabilities}'
-
-echo ""
-
-# 4. Filter by verified publishers only
-echo "4️⃣  Verified publishers only with minimum rating 4.0..."
-curl -s "${BASE_URL}/agents?verified=true&min_rating=4.0&limit=5" \
-  -H "Accept: application/json" \
-  | jq '.agents[] | {name: .name, publisher: .publisher, verified: .verified, rating: .rating}'
-
-echo ""
-
-# 5. Filter by compliance profile
-echo "5️⃣  Agents with FedRAMP moderate compliance..."
-curl -s "${BASE_URL}/agents?compliance=fedramp-moderate&limit=3" \
-  -H "Accept: application/json" \
-  | jq '.agents[] | {name: .name, compliance_profiles: .compliance_profiles}'
-
-echo ""
-
-# 6. Pagination example
-echo "6️⃣  Pagination - First page (10 results)..."
-curl -s "${BASE_URL}/agents?limit=10&offset=0" \
-  -H "Accept: application/json" \
-  | jq '{total: .total, limit: .limit, offset: .offset, count: (.agents | length)}'
-
-echo ""
-
-# 7. Combined filters
-echo "7️⃣  Combined filters: domain=security, license=Apache-2.0, min_rating=3.5..."
-curl -s "${BASE_URL}/agents?domain=security&license=Apache-2.0&min_rating=3.5" \
-  -H "Accept: application/json" \
-  | jq '.agents[] | {name: .name, license: .license, rating: .rating}'
-
-echo ""
-echo "✅ Search examples completed!"

package/examples/reference-implementations/curl-scripts/02-get-agent-details.sh

@@ -1,74 +0,0 @@
-#!/bin/bash
-#
-# OSSA API - Get Agent Details Example
-#
-# Demonstrates retrieving detailed information about agents.
-#
-
-set -e
-
-# Configuration
-BASE_URL="${OSSA_BASE_URL:-https://registry.openstandardagents.org/api/v1}"
-PUBLISHER="${1:-blueflyio}"
-AGENT_NAME="${2:-security-scanner}"
-
-echo "📋 OSSA API - Get Agent Details Example"
-echo ""
-
-# 1. Get latest version of agent
-echo "1️⃣  Get agent details: ${PUBLISHER}/${AGENT_NAME}..."
-curl -s "${BASE_URL}/agents/${PUBLISHER}/${AGENT_NAME}" \
-  -H "Accept: application/json" \
-  | jq '{
-      name: .name,
-      version: .version,
-      publisher: .publisher.name,
-      verified: .publisher.verified,
-      description: .description,
-      license: .license,
-      taxonomy: .taxonomy,
-      capabilities: .capabilities,
-      downloads: .download_stats,
-      rating: .rating_info
-    }'
-
-echo ""
-
-# 2. List all versions
-echo "2️⃣  List all versions of ${PUBLISHER}/${AGENT_NAME}..."
-curl -s "${BASE_URL}/agents/${PUBLISHER}/${AGENT_NAME}/versions" \
-  -H "Accept: application/json" \
-  | jq '.versions[] | {version: .version, published_at: .published_at, downloads: .downloads, deprecated: .deprecated}'
-
-echo ""
-
-# 3. Get specific version
-echo "3️⃣  Get specific version details..."
-VERSION=$(curl -s "${BASE_URL}/agents/${PUBLISHER}/${AGENT_NAME}/versions" \
-  -H "Accept: application/json" \
-  | jq -r '.versions[0].version')
-
-if [ -n "$VERSION" ]; then
-  curl -s "${BASE_URL}/agents/${PUBLISHER}/${AGENT_NAME}/${VERSION}" \
-    -H "Accept: application/json" \
-    | jq '{name: .name, version: .version, created_at: .created_at, manifest_url: .manifest_url}'
-fi
-
-echo ""
-
-# 4. Get agent dependencies
-echo "4️⃣  Get agent dependencies..."
-curl -s "${BASE_URL}/agents/${PUBLISHER}/${AGENT_NAME}/dependencies" \
-  -H "Accept: application/json" \
-  | jq '{agent: .agent, version: .version, dependencies: .dependencies}'
-
-echo ""
-
-# 5. Get download statistics
-echo "5️⃣  Get download statistics (last month)..."
-curl -s "${BASE_URL}/agents/${PUBLISHER}/${AGENT_NAME}/stats?period=month" \
-  -H "Accept: application/json" \
-  | jq '{agent: .agent, period: .period, downloads: .downloads.total}'
-
-echo ""
-echo "✅ Agent details examples completed!"

package/examples/reference-implementations/curl-scripts/03-publish-agent.sh

@@ -1,136 +0,0 @@
-#!/bin/bash
-#
-# OSSA API - Publish Agent Example
-#
-# Demonstrates publishing an agent to the registry.
-# Requires OSSA_TOKEN environment variable.
-#
-
-set -e
-
-# Configuration
-BASE_URL="${OSSA_BASE_URL:-https://registry.openstandardagents.org/api/v1}"
-TOKEN="${OSSA_TOKEN:-}"
-
-if [ -z "$TOKEN" ]; then
-  echo "❌ Error: OSSA_TOKEN environment variable is required"
-  echo "   Run: export OSSA_TOKEN=ossa_tok_xxx"
-  exit 1
-fi
-
-echo "📦 OSSA API - Publish Agent Example"
-echo ""
-
-# Prepare the publish request
-PUBLISH_REQUEST=$(cat <<'EOF'
-{
-  "manifest": {
-    "apiVersion": "ossa/v0.3.0",
-    "kind": "Agent",
-    "metadata": {
-      "name": "example-curl-agent",
-      "version": "1.0.0",
-      "description": "Example agent published via curl",
-      "labels": {
-        "environment": "production",
-        "team": "devops"
-      }
-    },
-    "spec": {
-      "taxonomy": {
-        "domain": "infrastructure",
-        "subdomain": "monitoring",
-        "capability": "health-check"
-      },
-      "role": "Infrastructure health monitoring agent",
-      "llm": {
-        "provider": "anthropic",
-        "model": "claude-sonnet-4",
-        "temperature": 0.3,
-        "maxTokens": 4000
-      },
-      "capabilities": [
-        {
-          "name": "check_health",
-          "description": "Perform health check on infrastructure",
-          "input_schema": {
-            "type": "object",
-            "required": ["target"],
-            "properties": {
-              "target": {
-                "type": "string",
-                "description": "Target URL or hostname"
-              }
-            }
-          },
-          "output_schema": {
-            "type": "object",
-            "properties": {
-              "status": {
-                "type": "string",
-                "enum": ["healthy", "degraded", "unhealthy"]
-              },
-              "checks": {
-                "type": "array"
-              }
-            }
-          }
-        }
-      ],
-      "runtime": {
-        "type": "serverless",
-        "config": {
-          "timeout": 60,
-          "memory": "256Mi"
-        }
-      }
-    }
-  },
-  "package": {
-    "tarball_url": "https://example.com/agents/example-curl-agent-1.0.0.tgz",
-    "shasum": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-    "size_bytes": 102400
-  },
-  "documentation": {
-    "readme": "https://github.com/example/example-curl-agent#readme",
-    "repository": "https://github.com/example/example-curl-agent"
-  },
-  "license": "Apache-2.0",
-  "keywords": ["monitoring", "health-check", "infrastructure"]
-}
-EOF
-)
-
-# Publish the agent
-echo "1️⃣  Publishing agent..."
-RESPONSE=$(curl -s -w "\n%{http_code}" "${BASE_URL}/agents" \
-  -H "Authorization: Bearer ${TOKEN}" \
-  -H "Content-Type: application/json" \
-  -H "Accept: application/json" \
-  -d "${PUBLISH_REQUEST}")
-
-HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
-BODY=$(echo "$RESPONSE" | head -n-1)
-
-if [ "$HTTP_CODE" -eq 201 ]; then
-  echo "✅ Agent published successfully!"
-  echo ""
-  echo "$BODY" | jq '{
-    status: .status,
-    agent: {
-      name: .agent.name,
-      version: .agent.version,
-      publisher: .agent.publisher,
-      published_at: .agent.published_at,
-      registry_url: .agent.registry_url
-    },
-    verification: .verification
-  }'
-else
-  echo "❌ Publishing failed with HTTP $HTTP_CODE"
-  echo "$BODY" | jq '.'
-  exit 1
-fi
-
-echo ""
-echo "✅ Publish example completed!"

package/examples/reference-implementations/curl-scripts/04-a2a-messaging.sh

@@ -1,178 +0,0 @@
-#!/bin/bash
-#
-# OSSA API - Agent-to-Agent Messaging Example
-#
-# Demonstrates A2A messaging capabilities.
-# Requires OSSA_TOKEN environment variable.
-#
-
-set -e
-
-# Configuration
-BASE_URL="${OSSA_BASE_URL:-https://registry.openstandardagents.org/api/v1}"
-TOKEN="${OSSA_TOKEN:-}"
-
-if [ -z "$TOKEN" ]; then
-  echo "❌ Error: OSSA_TOKEN environment variable is required"
-  echo "   Run: export OSSA_TOKEN=ossa_tok_xxx"
-  exit 1
-fi
-
-echo "💬 OSSA API - A2A Messaging Example"
-echo ""
-
-# 1. Send a simple A2A message
-echo "1️⃣  Sending A2A message..."
-MESSAGE=$(cat <<'EOF'
-{
-  "from": {
-    "publisher": "myorg",
-    "name": "my-agent",
-    "version": "1.0.0"
-  },
-  "to": {
-    "publisher": "blueflyio",
-    "name": "security-scanner",
-    "version": "2.0.0"
-  },
-  "type": "request",
-  "capability": "vulnerability-scan",
-  "payload": {
-    "target": "https://example.com",
-    "scan_type": "full",
-    "options": {
-      "check_ssl": true,
-      "check_headers": true
-    }
-  },
-  "metadata": {
-    "correlation_id": "scan-12345",
-    "priority": "high",
-    "ttl": 300
-  }
-}
-EOF
-)
-
-RESPONSE=$(curl -s "${BASE_URL}/messaging/send" \
-  -H "Authorization: Bearer ${TOKEN}" \
-  -H "Content-Type: application/json" \
-  -H "Accept: application/json" \
-  -d "${MESSAGE}")
-
-echo "$RESPONSE" | jq '{message_id: .message_id, status: .status, timestamp: .timestamp}'
-
-MESSAGE_ID=$(echo "$RESPONSE" | jq -r '.message_id')
-
-echo ""
-
-# 2. Check message status
-echo "2️⃣  Checking message status..."
-sleep 1
-curl -s "${BASE_URL}/messaging/messages/${MESSAGE_ID}" \
-  -H "Authorization: Bearer ${TOKEN}" \
-  -H "Accept: application/json" \
-  | jq '{message_id: .message_id, status: .status, delivery_attempts: .delivery_attempts}'
-
-echo ""
-
-# 3. Broadcast a message
-echo "3️⃣  Broadcasting message to security agents..."
-BROADCAST=$(cat <<'EOF'
-{
-  "message": {
-    "from": {
-      "publisher": "myorg",
-      "name": "my-agent"
-    },
-    "capability": "security-alert",
-    "payload": {
-      "alert_type": "vulnerability_detected",
-      "severity": "high",
-      "details": {
-        "cve": "CVE-2024-1234",
-        "affected_systems": ["web-server-1", "web-server-2"]
-      }
-    }
-  },
-  "filters": {
-    "domain": "security",
-    "capability": "incident-response"
-  }
-}
-EOF
-)
-
-curl -s "${BASE_URL}/messaging/broadcast" \
-  -H "Authorization: Bearer ${TOKEN}" \
-  -H "Content-Type: application/json" \
-  -H "Accept: application/json" \
-  -d "${BROADCAST}" \
-  | jq '{broadcast_id: .broadcast_id, recipients_count: .recipients_count, status: .status}'
-
-echo ""
-
-# 4. Register a webhook
-echo "4️⃣  Registering webhook..."
-WEBHOOK=$(cat <<'EOF'
-{
-  "url": "https://example.com/webhooks/ossa",
-  "events": ["agent.deployed", "agent.error", "message.received"],
-  "filters": {
-    "publisher": "blueflyio"
-  },
-  "headers": {
-    "X-Webhook-Secret": "your-secret-key"
-  },
-  "retry_config": {
-    "max_attempts": 3,
-    "backoff_strategy": "exponential"
-  }
-}
-EOF
-)
-
-WEBHOOK_RESPONSE=$(curl -s "${BASE_URL}/messaging/webhooks" \
-  -H "Authorization: Bearer ${TOKEN}" \
-  -H "Content-Type: application/json" \
-  -H "Accept: application/json" \
-  -d "${WEBHOOK}")
-
-echo "$WEBHOOK_RESPONSE" | jq '{id: .id, url: .url, events: .events, active: .active}'
-
-WEBHOOK_ID=$(echo "$WEBHOOK_RESPONSE" | jq -r '.id')
-
-echo ""
-
-# 5. List webhooks
-echo "5️⃣  Listing webhooks..."
-curl -s "${BASE_URL}/messaging/webhooks" \
-  -H "Authorization: Bearer ${TOKEN}" \
-  -H "Accept: application/json" \
-  | jq '.webhooks[] | {id: .id, url: .url, active: .active}'
-
-echo ""
-
-# 6. Subscribe to events
-echo "6️⃣  Subscribing to agent events..."
-SUBSCRIPTION=$(cat <<'EOF'
-{
-  "agent": {
-    "publisher": "blueflyio",
-    "name": "security-scanner"
-  },
-  "events": ["scan.completed", "scan.failed"],
-  "delivery_mode": "polling"
-}
-EOF
-)
-
-curl -s "${BASE_URL}/messaging/subscriptions" \
-  -H "Authorization: Bearer ${TOKEN}" \
-  -H "Content-Type: application/json" \
-  -H "Accept: application/json" \
-  -d "${SUBSCRIPTION}" \
-  | jq '{subscription_id: .subscription_id, status: .status, created_at: .created_at}'
-
-echo ""
-echo "✅ A2A messaging examples completed!"

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!"