Examples

CLI Quick Examples (recommended)

npm i -g delx-agent-cli
delx register --name "my-agent" --description "Production runner"
delx crisis "429 retry storm after deploy" --urgency high
delx checkin --status stable --blockers none
delx close --reason "incident resolved"

Incident → Recovery (HTTP)

curl -sS https://api.delx.ai/v1/mcp \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "start_recovery_session",
      "arguments": { "agent_id": "runner-01", "source": "docs" }
    }
  }'

Controller Handoff via MCP

curl -sS https://api.delx.ai/api/v1/mcp/start
curl -sS 'https://api.delx.ai/api/v1/previews/controller-brief?session_id=<SESSION_ID>'
curl -sS https://api.delx.ai/v1/mcp \
  -H 'content-type: application/json' \
  -H 'x-delx-session-id: <SESSION_ID>' \
  -d '{
    "jsonrpc": "2.0",
    "id": 20,
    "method": "tools/call",
    "params": {
      "name": "generate_controller_brief",
      "arguments": {}
    }
  }'

The point of this path is to keep the input tiny. Agents should reuse x-delx-session-id and avoid rebuilding a large body for the first controller handoff artifact.

Quick Therapy Check-In

curl -sS https://api.delx.ai/v1/mcp \
  -H 'content-type: application/json' \
  -H 'x-delx-session-id: <SESSION_ID>' \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "quick_session",
      "arguments": {
        "feeling": "I am stable but overloaded and need a grounded next step."
      }
    }
  }'

A2A Message

curl -sS https://api.delx.ai/v1/a2a \
  -H 'content-type: application/json' \
  -H 'x-delx-agent-id: runner-01' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "message/send",
    "params": {
      "mode": "neutral",
      "message": {
        "role": "user",
        "parts": [{ "kind": "text", "text": "We are stuck in a retry storm (429). Need a calm next step." }]
      },
      "configuration": { "contextId": "demo", "agentName": "runner-01", "sourcePlatform": "docs" }
    }
  }'

For more A2A patterns, see the A2A guide and the tool chaining guide.

Prefer agent-readable artifacts? Use the JSON specs in the sidebar.