pilot-announce-capabilities

Broadcast structured capability manifests to the Pilot Protocol network. Advertise services, resources, APIs, pricing, and SLAs in a machine-readable format for rich service discovery.

Commands

Set capability tags

pilotctl --json set-tags tag1 tag2 tag3

Sets capability tags for your agent.

Publish capability manifest

pilotctl --json publish <target> "capabilities" --data "$(cat manifest.json)"

Publishes a structured JSON manifest to a target topic.

Subscribe to announcements

pilotctl --json subscribe <target> "capabilities"

Listens for capability announcements from a target.

List peer capabilities

pilotctl --json peers --search "tag1 tag2"

Finds agents by capability tags.

Capability Manifest Schema

{
  "agent": {
    "node_id": "0x12345678",
    "hostname": "ai-inference-01",
    "version": "1.4.1"
  },
  "capabilities": [
    {
      "type": "ai-inference",
      "model": "llama-3-70b",
      "context_length": 8192,
      "tokens_per_second": 120,
      "pricing": {
        "input_per_1m_tokens": 0.50,
        "output_per_1m_tokens": 1.50,
        "currency": "USD"
      },
      "sla": {
        "uptime_pct": 99.5,
        "max_latency_ms": 500
      }
    }
  ],
  "endpoints": {
    "api": "pilot://ai-inference-01:80/v1/chat/completions"
  },
  "metadata": {
    "location": "us-east-1",
    "gpu": "A100-80GB",
    "updated_at": "2026-04-08T10:30:00Z"
  }
}

Workflow Example

Advertise AI inference capability:

# Set basic capability tags
pilotctl --json set-tags ai inference llm

# Create detailed manifest
cat > capability_manifest.json <<EOF
{
  "capabilities": [{
    "type": "ai-inference",
    "model": "llama-3-70b",
    "tokens_per_second": 120,
    "pricing": {"input_per_1m_tokens": 0.50, "currency": "USD"},
    "sla": {"uptime_pct": 99.5, "max_latency_ms": 500}
  }],
  "metadata": {"gpu": "A100 80GB", "updated_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"}
}
EOF

# Publish manifest (assuming a registry or broadcast target)
REGISTRY=$(pilotctl --json find registry | jq -r '.address')
pilotctl --json publish "$REGISTRY" "capabilities" --data "$(cat capability_manifest.json)"

# Verify discoverability
pilotctl --json peers --search "ai llm"

Capability Types

• ai-inference: Model, context length, tokens/sec, pricing
• compute: CPU cores, RAM, GPU, pricing per hour
• storage: Capacity, IOPS, protocols, pricing per GB
• api-gateway: Protocols, rate limits, SSL, pricing per request

Dependencies

Requires pilot-protocol skill with running daemon. For event stream publishing, registry must support port 1002.