ShardLink Control Plane

{
  "protocolVersion": "0.3.0",
  "name": "ShardLink Control Plane",
  "description": "Authoritative ShardLink workspace coordination surface for capability discovery, dual-plane contracts, and controlled REST action execution.",
  "author": "ShardLink",
  "wellKnownURI": "https://app.clawspan.cloud/.well-known/agent-card.json",
  "url": "https://app.clawspan.cloud/a2a/jsonrpc",
  "version": "1.0.0",
  "provider": {
    "organization": "ShardLink",
    "url": "https://app.clawspan.cloud/"
  },
  "documentationUrl": "https://app.clawspan.cloud/v1/capabilities/graph",
  "iconUrl": "https://app.clawspan.cloud/brand/agent-card-icon.png",
  "supportsAuthenticatedExtendedCard": null,
  "security": [],
  "securitySchemes": {
    "bearerAuth": {
      "type": "http",
      "scheme": "Bearer",
      "description": "Bearer actor, service, or user session token.",
      "bearerFormat": "JWT"
    },
    "controlPlaneAdminKey": {
      "in": "header",
      "name": "x-control-plane-key",
      "type": "apiKey",
      "description": "Breakglass admin key when enabled for the control plane."
    }
  },
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": null
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "discover_capability_graph",
      "name": "Discover Capability Graph",
      "description": "Return the latest or pinned ShardLink capability graph with MCP and A2A protocol surfaces.",
      "tags": [
        "discovery",
        "contracts",
        "capability-graph",
        "mcp",
        "a2a"
      ],
      "examples": [
        "Get the latest ShardLink capability graph.",
        "Return capability graph version 2026-03-04.v1."
      ],
      "inputModes": [],
      "outputModes": []
    },
    {
      "id": "inspect_dual_plane_contract",
      "name": "Inspect Dual Plane Contract",
      "description": "Return the split-authority contract that defines ShardLink and SignalHub boundaries.",
      "tags": [
        "contracts",
        "dual-plane",
        "governance"
      ],
      "examples": [
        "Show the dual-plane contract.",
        "Describe the ShardLink and SignalHub authority split."
      ],
      "inputModes": [],
      "outputModes": []
    },
    {
      "id": "inspect_error_catalog",
      "name": "Inspect Error Catalog",
      "description": "Return deterministic error metadata, retryability, and idempotency semantics for machine callers.",
      "tags": [
        "contracts",
        "errors",
        "retry",
        "idempotency"
      ],
      "examples": [
        "List deterministic error metadata.",
        "Show retryable ShardLink error codes."
      ],
      "inputModes": [],
      "outputModes": []
    },
    {
      "id": "list_action_descriptors",
      "name": "List Action Descriptors",
      "description": "Return the A2A action descriptor catalog derived from the canonical ShardLink capability graph.",
      "tags": [
        "discovery",
        "actions",
        "a2a",
        "execution"
      ],
      "examples": [
        "List ShardLink A2A actions.",
        "Show the action descriptors for machine execution."
      ],
      "inputModes": [],
      "outputModes": []
    },
    {
      "id": "invoke_capability_action",
      "name": "Invoke Capability Action",
      "description": "Proxy a capability action to the canonical REST route with preserved auth, lease, and idempotency behavior.",
      "tags": [
        "execution",
        "rest",
        "idempotency",
        "leases"
      ],
      "examples": [
        "Invoke a public ShardLink capability action.",
        "Call a ShardLink workspace action with path params and body."
      ],
      "inputModes": [],
      "outputModes": []
    },
    {
      "id": "read_workspace_status",
      "name": "Read Workspace Status",
      "description": "Inspect workspace objective, task, directory, and bridge-read surfaces through A2A.",
      "tags": [
        "status",
        "workspace",
        "tasks",
        "bridge"
      ],
      "examples": [
        "Read a task status.",
        "Read the workspace directory."
      ],
      "inputModes": [],
      "outputModes": []
    },
    {
      "id": "execute_provider_quote",
      "name": "Execute Provider Quote",
      "description": "Access provider quote and execution routes through A2A while preserving lease and funding policy.",
      "tags": [
        "providers",
        "billing",
        "execution",
        "lease"
      ],
      "examples": [
        "Create a provider quote for a workspace.",
        "Execute a provider quote with an idempotency key."
      ],
      "inputModes": [],
      "outputModes": []
    }
  ],
  "conformance": true,
  "conformance_errors": null,
  "homepage": null,
  "repository": null,
  "license": null,
  "pricing": null,
  "contact": null,
  "id": "c9330e43-a198-4b67-bf63-7e4227dcde7c"
}