@creatornader/agent-bridge 0.2.0 → 0.3.1

package/schemas/agent-bridge-v2.capabilities.json

@@ -0,0 +1,1829 @@
+{
+  "protocolVersion": "2.1",
+  "currentProtocolVersion": "2.1",
+  "selectedProtocolVersion": "2.1",
+  "supportedProtocolVersions": [
+    "2.0",
+    "2.1"
+  ],
+  "scopeEnforcement": true,
+  "requestAuthority": false,
+  "rowIsolation": false,
+  "authorizationModel": "scoped-credential",
+  "surface": "http",
+  "provider": "gateway",
+  "operations": [
+    {
+      "id": "capabilities",
+      "summary": "Discover operations available on the current surface.",
+      "mcp": {
+        "name": "capabilities"
+      },
+      "http": {
+        "method": "GET",
+        "path": "/v2/capabilities"
+      },
+      "cli": {
+        "command": "capabilities",
+        "options": [],
+        "outputSchema": {
+          "type": "object",
+          "required": [
+            "protocolVersion",
+            "currentProtocolVersion",
+            "selectedProtocolVersion",
+            "supportedProtocolVersions",
+            "scopeEnforcement",
+            "requestAuthority",
+            "rowIsolation",
+            "authorizationModel",
+            "surface",
+            "provider",
+            "operations"
+          ],
+          "properties": {
+            "protocolVersion": {
+              "type": "string"
+            },
+            "currentProtocolVersion": {
+              "type": "string"
+            },
+            "selectedProtocolVersion": {
+              "type": "string"
+            },
+            "supportedProtocolVersions": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "scopeEnforcement": {
+              "type": "boolean"
+            },
+            "requestAuthority": {
+              "type": "boolean"
+            },
+            "rowIsolation": {
+              "type": "boolean"
+            },
+            "authorizationModel": {
+              "enum": [
+                "scoped-credential",
+                "credential-wide",
+                "process-identity",
+                "legacy-key"
+              ]
+            },
+            "surface": {
+              "enum": [
+                "mcp",
+                "http",
+                "cli"
+              ]
+            },
+            "provider": {
+              "enum": [
+                "local",
+                "gateway",
+                "legacy-supabase"
+              ]
+            },
+            "operations": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "id",
+                  "summary",
+                  "requiredScopes"
+                ],
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "summary": {
+                    "type": "string"
+                  },
+                  "requiredScopes": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "mcp": {},
+                  "http": {},
+                  "cli": {}
+                },
+                "additionalProperties": true
+              }
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "requiredScopes": []
+    },
+    {
+      "id": "status",
+      "summary": "Read gateway delivery diagnostics.",
+      "http": {
+        "method": "GET",
+        "path": "/v2/status"
+      },
+      "requiredScopes": [
+        "status:read"
+      ]
+    },
+    {
+      "id": "gateway_metrics",
+      "summary": "Read Prometheus gateway counters.",
+      "http": {
+        "method": "GET",
+        "path": "/metrics",
+        "responseContentType": "text/plain"
+      },
+      "requiredScopes": [
+        "gateway:metrics"
+      ]
+    },
+    {
+      "id": "publish_message",
+      "summary": "Create an immutable Agent Bridge v2 message.",
+      "mcp": {
+        "name": "send"
+      },
+      "http": {
+        "method": "POST",
+        "path": "/v2/messages",
+        "successStatus": 201
+      },
+      "cli": {
+        "command": "send",
+        "aliases": [
+          "post"
+        ],
+        "options": [
+          "source",
+          "project",
+          "type",
+          "kind",
+          "category",
+          "content",
+          "content-type",
+          "data",
+          "payload",
+          "payload-mime",
+          "payload-ref",
+          "payload-ciphertext",
+          "target",
+          "target-agent",
+          "target-agents",
+          "thread-id",
+          "reply-to-id",
+          "correlation-id",
+          "causation-id",
+          "priority",
+          "expires-at",
+          "idempotency-key",
+          "atrib-receipt-id",
+          "informed-by",
+          "metadata",
+          "delivery-mode",
+          "delivery-policy",
+          "delivery-max-attempts",
+          "retry-base-ms",
+          "retry-max-ms",
+          "retry-jitter",
+          "not-before",
+          "message-id"
+        ],
+        "outputSchema": {
+          "type": "object",
+          "required": [
+            "created",
+            "message"
+          ],
+          "properties": {
+            "created": {
+              "type": "boolean"
+            },
+            "message": {
+              "type": "object",
+              "required": [
+                "id",
+                "workspace",
+                "source",
+                "type",
+                "content",
+                "contentType",
+                "sequence",
+                "createdAt",
+                "targets",
+                "priority",
+                "deliveryPolicy"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "workspace": {
+                  "type": "string"
+                },
+                "project": {
+                  "type": "string"
+                },
+                "source": {
+                  "type": "string"
+                },
+                "type": {
+                  "type": "string"
+                },
+                "content": {
+                  "type": "string"
+                },
+                "contentType": {
+                  "type": "string"
+                },
+                "sequence": {
+                  "type": "string"
+                },
+                "createdAt": {
+                  "type": "string"
+                },
+                "data": {},
+                "targets": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "threadId": {
+                  "type": "string"
+                },
+                "replyToId": {
+                  "type": "string"
+                },
+                "correlationId": {
+                  "type": "string"
+                },
+                "causationId": {
+                  "type": "string"
+                },
+                "priority": {
+                  "enum": [
+                    "info",
+                    "high",
+                    "urgent"
+                  ]
+                },
+                "expiresAt": {
+                  "type": "string"
+                },
+                "idempotencyKey": {
+                  "type": "string"
+                },
+                "atribReceiptId": {
+                  "type": "string"
+                },
+                "informedBy": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "metadata": {},
+                "deliveryPolicy": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "required": [
+                        "mode"
+                      ],
+                      "properties": {
+                        "mode": {
+                          "type": "string",
+                          "const": "mailbox"
+                        }
+                      },
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "object",
+                      "required": [
+                        "mode",
+                        "maxAttempts",
+                        "retryBaseDelayMs",
+                        "retryMaxDelayMs",
+                        "retryJitterRatio"
+                      ],
+                      "properties": {
+                        "mode": {
+                          "type": "string",
+                          "const": "leased"
+                        },
+                        "maxAttempts": {
+                          "type": "number"
+                        },
+                        "retryBaseDelayMs": {
+                          "type": "number"
+                        },
+                        "retryMaxDelayMs": {
+                          "type": "number"
+                        },
+                        "retryJitterRatio": {
+                          "type": "number"
+                        },
+                        "notBefore": {
+                          "type": "string"
+                        }
+                      },
+                      "additionalProperties": false
+                    }
+                  ]
+                }
+              },
+              "additionalProperties": true
+            },
+            "disposition": {
+              "enum": [
+                "committed",
+                "queued"
+              ]
+            },
+            "authoritative": {
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "requiredScopes": [
+        "messages:write"
+      ]
+    },
+    {
+      "id": "history",
+      "summary": "Read visible messages after an opaque cursor.",
+      "mcp": {
+        "name": "history"
+      },
+      "http": {
+        "method": "GET",
+        "path": "/v2/history",
+        "queryAliases": {
+          "unacknowledgedBy": [
+            "unacked_by"
+          ]
+        }
+      },
+      "cli": {
+        "command": "history",
+        "aliases": [
+          "inbox",
+          "sent"
+        ],
+        "options": [
+          "cursor",
+          "limit",
+          "type",
+          "category",
+          "mailbox",
+          "receipt-state",
+          "source",
+          "project",
+          "since",
+          "unacked-by",
+          "thread-id",
+          "latest"
+        ],
+        "outputSchema": {
+          "type": "object",
+          "required": [
+            "messages"
+          ],
+          "properties": {
+            "messages": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "id",
+                  "workspace",
+                  "source",
+                  "type",
+                  "content",
+                  "contentType",
+                  "sequence",
+                  "createdAt",
+                  "targets",
+                  "priority",
+                  "deliveryPolicy"
+                ],
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "workspace": {
+                    "type": "string"
+                  },
+                  "project": {
+                    "type": "string"
+                  },
+                  "source": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "type": "string"
+                  },
+                  "content": {
+                    "type": "string"
+                  },
+                  "contentType": {
+                    "type": "string"
+                  },
+                  "sequence": {
+                    "type": "string"
+                  },
+                  "createdAt": {
+                    "type": "string"
+                  },
+                  "data": {},
+                  "targets": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "threadId": {
+                    "type": "string"
+                  },
+                  "replyToId": {
+                    "type": "string"
+                  },
+                  "correlationId": {
+                    "type": "string"
+                  },
+                  "causationId": {
+                    "type": "string"
+                  },
+                  "priority": {
+                    "enum": [
+                      "info",
+                      "high",
+                      "urgent"
+                    ]
+                  },
+                  "expiresAt": {
+                    "type": "string"
+                  },
+                  "idempotencyKey": {
+                    "type": "string"
+                  },
+                  "atribReceiptId": {
+                    "type": "string"
+                  },
+                  "informedBy": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "metadata": {},
+                  "deliveryPolicy": {
+                    "anyOf": [
+                      {
+                        "type": "object",
+                        "required": [
+                          "mode"
+                        ],
+                        "properties": {
+                          "mode": {
+                            "type": "string",
+                            "const": "mailbox"
+                          }
+                        },
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "required": [
+                          "mode",
+                          "maxAttempts",
+                          "retryBaseDelayMs",
+                          "retryMaxDelayMs",
+                          "retryJitterRatio"
+                        ],
+                        "properties": {
+                          "mode": {
+                            "type": "string",
+                            "const": "leased"
+                          },
+                          "maxAttempts": {
+                            "type": "number"
+                          },
+                          "retryBaseDelayMs": {
+                            "type": "number"
+                          },
+                          "retryMaxDelayMs": {
+                            "type": "number"
+                          },
+                          "retryJitterRatio": {
+                            "type": "number"
+                          },
+                          "notBefore": {
+                            "type": "string"
+                          }
+                        },
+                        "additionalProperties": false
+                      }
+                    ]
+                  }
+                },
+                "additionalProperties": true
+              }
+            },
+            "cursor": {
+              "type": "string"
+            },
+            "source": {
+              "enum": [
+                "remote",
+                "cache"
+              ]
+            },
+            "stale": {
+              "type": "boolean"
+            },
+            "degraded": {
+              "type": "boolean"
+            },
+            "acknowledgements": {
+              "enum": [
+                "authoritative",
+                "unknown"
+              ]
+            },
+            "lastSyncedAt": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": true
+        },
+        "variants": [
+          {
+            "command": "get",
+            "condition": {
+              "kind": "always"
+            },
+            "routesTo": "history",
+            "options": [
+              "cursor",
+              "limit",
+              "type",
+              "category",
+              "mailbox",
+              "receipt-state",
+              "source",
+              "project",
+              "since",
+              "unacked-by",
+              "thread-id",
+              "latest"
+            ],
+            "outputSchema": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "id",
+                  "source",
+                  "category",
+                  "content",
+                  "priority",
+                  "project",
+                  "metadata",
+                  "created_at"
+                ],
+                "properties": {
+                  "id": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "number"
+                      }
+                    ]
+                  },
+                  "source": {
+                    "type": "string"
+                  },
+                  "category": {
+                    "type": "string"
+                  },
+                  "content": {
+                    "type": "string"
+                  },
+                  "priority": {
+                    "enum": [
+                      "info",
+                      "high",
+                      "urgent"
+                    ]
+                  },
+                  "project": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "metadata": {},
+                  "created_at": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          }
+        ]
+      },
+      "requiredScopes": [
+        "messages:read"
+      ]
+    },
+    {
+      "id": "record_receipt",
+      "summary": "Record caller-bound inbox read receipts.",
+      "http": {
+        "method": "POST",
+        "path": "/v2/receipts"
+      },
+      "cli": {
+        "command": "acknowledge",
+        "aliases": [
+          "receipt"
+        ],
+        "options": [
+          "ids"
+        ],
+        "outputSchema": {
+          "type": "object",
+          "required": [
+            "acknowledged",
+            "agent"
+          ],
+          "properties": {
+            "acknowledged": {
+              "type": "number"
+            },
+            "agent": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": true
+        },
+        "variants": [
+          {
+            "command": "ack",
+            "condition": {
+              "kind": "option-present",
+              "option": "ids"
+            },
+            "routesTo": "record_receipt",
+            "options": [
+              "ids"
+            ],
+            "outputSchema": {
+              "type": "object",
+              "required": [
+                "acknowledged",
+                "agent"
+              ],
+              "properties": {
+                "acknowledged": {
+                  "type": "number"
+                },
+                "agent": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": true
+            }
+          }
+        ]
+      },
+      "requiredScopes": [
+        "receipts:write"
+      ]
+    },
+    {
+      "id": "claim_delivery",
+      "summary": "Atomically claim the next targeted delivery.",
+      "mcp": {
+        "name": "claim"
+      },
+      "http": {
+        "method": "POST",
+        "path": "/v2/deliveries/claim"
+      },
+      "cli": {
+        "command": "claim",
+        "options": [
+          "lease-ms",
+          "max-attempts"
+        ],
+        "outputSchema": {
+          "anyOf": [
+            {
+              "type": "object",
+              "required": [
+                "delivery",
+                "leaseToken"
+              ],
+              "properties": {
+                "delivery": {
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "messageId",
+                    "workspace",
+                    "recipient",
+                    "state",
+                    "attempt",
+                    "cycleAttempt",
+                    "requeueCount",
+                    "createdAt",
+                    "priorityRank",
+                    "availableAt",
+                    "lastAction"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "messageId": {
+                      "type": "string"
+                    },
+                    "workspace": {
+                      "type": "string"
+                    },
+                    "recipient": {
+                      "type": "string"
+                    },
+                    "state": {
+                      "enum": [
+                        "pending",
+                        "claimed",
+                        "acked",
+                        "retrying",
+                        "dead",
+                        "cancelled"
+                      ]
+                    },
+                    "attempt": {
+                      "type": "number"
+                    },
+                    "cycleAttempt": {
+                      "type": "number"
+                    },
+                    "requeueCount": {
+                      "type": "number"
+                    },
+                    "createdAt": {
+                      "type": "string"
+                    },
+                    "priorityRank": {
+                      "type": "number"
+                    },
+                    "availableAt": {
+                      "type": "string"
+                    },
+                    "leaseToken": {
+                      "type": "string"
+                    },
+                    "leaseOwner": {
+                      "type": "string"
+                    },
+                    "leaseExpiresAt": {
+                      "type": "string"
+                    },
+                    "lastError": {
+                      "type": "string"
+                    },
+                    "lastActor": {
+                      "type": "string"
+                    },
+                    "lastAction": {
+                      "enum": [
+                        "created",
+                        "claim",
+                        "ack",
+                        "nack_retry",
+                        "nack_dead",
+                        "lease_expired",
+                        "attempts_exhausted",
+                        "message_expired",
+                        "cancel",
+                        "requeue"
+                      ]
+                    }
+                  },
+                  "additionalProperties": true
+                },
+                "leaseToken": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": true
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "requiredScopes": [
+        "deliveries:claim"
+      ]
+    },
+    {
+      "id": "list_deliveries",
+      "summary": "List caller-visible deliveries.",
+      "mcp": {
+        "name": "list_deliveries"
+      },
+      "http": {
+        "method": "GET",
+        "path": "/v2/deliveries"
+      },
+      "cli": {
+        "command": "deliveries",
+        "aliases": [
+          "dead-letters"
+        ],
+        "options": [
+          "cursor",
+          "limit",
+          "role",
+          "message-id",
+          "recipient",
+          "state"
+        ],
+        "outputSchema": {
+          "type": "object",
+          "required": [
+            "deliveries"
+          ],
+          "properties": {
+            "deliveries": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "id",
+                  "messageId",
+                  "workspace",
+                  "recipient",
+                  "state",
+                  "attempt",
+                  "cycleAttempt",
+                  "requeueCount",
+                  "createdAt",
+                  "priorityRank",
+                  "availableAt",
+                  "lastAction"
+                ],
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "messageId": {
+                    "type": "string"
+                  },
+                  "workspace": {
+                    "type": "string"
+                  },
+                  "recipient": {
+                    "type": "string"
+                  },
+                  "state": {
+                    "enum": [
+                      "pending",
+                      "claimed",
+                      "acked",
+                      "retrying",
+                      "dead",
+                      "cancelled"
+                    ]
+                  },
+                  "attempt": {
+                    "type": "number"
+                  },
+                  "cycleAttempt": {
+                    "type": "number"
+                  },
+                  "requeueCount": {
+                    "type": "number"
+                  },
+                  "createdAt": {
+                    "type": "string"
+                  },
+                  "priorityRank": {
+                    "type": "number"
+                  },
+                  "availableAt": {
+                    "type": "string"
+                  },
+                  "leaseToken": {
+                    "type": "string"
+                  },
+                  "leaseOwner": {
+                    "type": "string"
+                  },
+                  "leaseExpiresAt": {
+                    "type": "string"
+                  },
+                  "lastError": {
+                    "type": "string"
+                  },
+                  "lastActor": {
+                    "type": "string"
+                  },
+                  "lastAction": {
+                    "enum": [
+                      "created",
+                      "claim",
+                      "ack",
+                      "nack_retry",
+                      "nack_dead",
+                      "lease_expired",
+                      "attempts_exhausted",
+                      "message_expired",
+                      "cancel",
+                      "requeue"
+                    ]
+                  }
+                },
+                "additionalProperties": true
+              }
+            },
+            "cursor": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "requiredScopes": [
+        "deliveries:read"
+      ]
+    },
+    {
+      "id": "list_delivery_events",
+      "summary": "List the append-only event history for a delivery.",
+      "mcp": {
+        "name": "list_delivery_events"
+      },
+      "http": {
+        "method": "GET",
+        "path": "/v2/deliveries/{deliveryId}/events"
+      },
+      "cli": {
+        "command": "delivery-events",
+        "options": [
+          "delivery-id",
+          "cursor",
+          "limit"
+        ],
+        "outputSchema": {
+          "type": "object",
+          "required": [
+            "events"
+          ],
+          "properties": {
+            "events": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "sequence",
+                  "deliveryId",
+                  "messageId",
+                  "workspace",
+                  "recipient",
+                  "toState",
+                  "attempt",
+                  "cycleAttempt",
+                  "requeueCount",
+                  "actor",
+                  "action",
+                  "createdAt"
+                ],
+                "properties": {
+                  "sequence": {
+                    "type": "string"
+                  },
+                  "deliveryId": {
+                    "type": "string"
+                  },
+                  "messageId": {
+                    "type": "string"
+                  },
+                  "workspace": {
+                    "type": "string"
+                  },
+                  "recipient": {
+                    "type": "string"
+                  },
+                  "fromState": {
+                    "enum": [
+                      "pending",
+                      "claimed",
+                      "acked",
+                      "retrying",
+                      "dead",
+                      "cancelled"
+                    ]
+                  },
+                  "toState": {
+                    "enum": [
+                      "pending",
+                      "claimed",
+                      "acked",
+                      "retrying",
+                      "dead",
+                      "cancelled"
+                    ]
+                  },
+                  "attempt": {
+                    "type": "number"
+                  },
+                  "cycleAttempt": {
+                    "type": "number"
+                  },
+                  "requeueCount": {
+                    "type": "number"
+                  },
+                  "leaseOwner": {
+                    "type": "string"
+                  },
+                  "error": {
+                    "type": "string"
+                  },
+                  "actor": {
+                    "type": "string"
+                  },
+                  "action": {
+                    "enum": [
+                      "created",
+                      "claim",
+                      "ack",
+                      "nack_retry",
+                      "nack_dead",
+                      "lease_expired",
+                      "attempts_exhausted",
+                      "message_expired",
+                      "cancel",
+                      "requeue"
+                    ]
+                  },
+                  "createdAt": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": true
+              }
+            },
+            "cursor": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "requiredScopes": [
+        "deliveries:read"
+      ]
+    },
+    {
+      "id": "cancel_delivery",
+      "summary": "Cancel a delivery as its publisher.",
+      "mcp": {
+        "name": "cancel_delivery"
+      },
+      "http": {
+        "method": "POST",
+        "path": "/v2/deliveries/{deliveryId}/cancel"
+      },
+      "cli": {
+        "command": "cancel",
+        "options": [
+          "delivery-id"
+        ],
+        "outputSchema": {
+          "anyOf": [
+            {
+              "type": "object",
+              "required": [
+                "id",
+                "messageId",
+                "workspace",
+                "recipient",
+                "state",
+                "attempt",
+                "cycleAttempt",
+                "requeueCount",
+                "createdAt",
+                "priorityRank",
+                "availableAt",
+                "lastAction"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "messageId": {
+                  "type": "string"
+                },
+                "workspace": {
+                  "type": "string"
+                },
+                "recipient": {
+                  "type": "string"
+                },
+                "state": {
+                  "enum": [
+                    "pending",
+                    "claimed",
+                    "acked",
+                    "retrying",
+                    "dead",
+                    "cancelled"
+                  ]
+                },
+                "attempt": {
+                  "type": "number"
+                },
+                "cycleAttempt": {
+                  "type": "number"
+                },
+                "requeueCount": {
+                  "type": "number"
+                },
+                "createdAt": {
+                  "type": "string"
+                },
+                "priorityRank": {
+                  "type": "number"
+                },
+                "availableAt": {
+                  "type": "string"
+                },
+                "leaseToken": {
+                  "type": "string"
+                },
+                "leaseOwner": {
+                  "type": "string"
+                },
+                "leaseExpiresAt": {
+                  "type": "string"
+                },
+                "lastError": {
+                  "type": "string"
+                },
+                "lastActor": {
+                  "type": "string"
+                },
+                "lastAction": {
+                  "enum": [
+                    "created",
+                    "claim",
+                    "ack",
+                    "nack_retry",
+                    "nack_dead",
+                    "lease_expired",
+                    "attempts_exhausted",
+                    "message_expired",
+                    "cancel",
+                    "requeue"
+                  ]
+                }
+              },
+              "additionalProperties": true
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "requiredScopes": [
+        "deliveries:manage"
+      ]
+    },
+    {
+      "id": "requeue_delivery",
+      "summary": "Requeue a delivery as its publisher.",
+      "mcp": {
+        "name": "requeue_delivery"
+      },
+      "http": {
+        "method": "POST",
+        "path": "/v2/deliveries/{deliveryId}/requeue"
+      },
+      "cli": {
+        "command": "requeue",
+        "options": [
+          "delivery-id"
+        ],
+        "outputSchema": {
+          "anyOf": [
+            {
+              "type": "object",
+              "required": [
+                "id",
+                "messageId",
+                "workspace",
+                "recipient",
+                "state",
+                "attempt",
+                "cycleAttempt",
+                "requeueCount",
+                "createdAt",
+                "priorityRank",
+                "availableAt",
+                "lastAction"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "messageId": {
+                  "type": "string"
+                },
+                "workspace": {
+                  "type": "string"
+                },
+                "recipient": {
+                  "type": "string"
+                },
+                "state": {
+                  "enum": [
+                    "pending",
+                    "claimed",
+                    "acked",
+                    "retrying",
+                    "dead",
+                    "cancelled"
+                  ]
+                },
+                "attempt": {
+                  "type": "number"
+                },
+                "cycleAttempt": {
+                  "type": "number"
+                },
+                "requeueCount": {
+                  "type": "number"
+                },
+                "createdAt": {
+                  "type": "string"
+                },
+                "priorityRank": {
+                  "type": "number"
+                },
+                "availableAt": {
+                  "type": "string"
+                },
+                "leaseToken": {
+                  "type": "string"
+                },
+                "leaseOwner": {
+                  "type": "string"
+                },
+                "leaseExpiresAt": {
+                  "type": "string"
+                },
+                "lastError": {
+                  "type": "string"
+                },
+                "lastActor": {
+                  "type": "string"
+                },
+                "lastAction": {
+                  "enum": [
+                    "created",
+                    "claim",
+                    "ack",
+                    "nack_retry",
+                    "nack_dead",
+                    "lease_expired",
+                    "attempts_exhausted",
+                    "message_expired",
+                    "cancel",
+                    "requeue"
+                  ]
+                }
+              },
+              "additionalProperties": true
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "requiredScopes": [
+        "deliveries:manage"
+      ]
+    },
+    {
+      "id": "extend_delivery",
+      "summary": "Extend a claimed delivery lease.",
+      "mcp": {
+        "name": "extend"
+      },
+      "http": {
+        "method": "POST",
+        "path": "/v2/deliveries/{deliveryId}/extend"
+      },
+      "cli": {
+        "command": "extend",
+        "options": [
+          "delivery-id",
+          "lease-token",
+          "lease-ms"
+        ],
+        "outputSchema": {
+          "anyOf": [
+            {
+              "type": "object",
+              "required": [
+                "id",
+                "messageId",
+                "workspace",
+                "recipient",
+                "state",
+                "attempt",
+                "cycleAttempt",
+                "requeueCount",
+                "createdAt",
+                "priorityRank",
+                "availableAt",
+                "lastAction"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "messageId": {
+                  "type": "string"
+                },
+                "workspace": {
+                  "type": "string"
+                },
+                "recipient": {
+                  "type": "string"
+                },
+                "state": {
+                  "enum": [
+                    "pending",
+                    "claimed",
+                    "acked",
+                    "retrying",
+                    "dead",
+                    "cancelled"
+                  ]
+                },
+                "attempt": {
+                  "type": "number"
+                },
+                "cycleAttempt": {
+                  "type": "number"
+                },
+                "requeueCount": {
+                  "type": "number"
+                },
+                "createdAt": {
+                  "type": "string"
+                },
+                "priorityRank": {
+                  "type": "number"
+                },
+                "availableAt": {
+                  "type": "string"
+                },
+                "leaseToken": {
+                  "type": "string"
+                },
+                "leaseOwner": {
+                  "type": "string"
+                },
+                "leaseExpiresAt": {
+                  "type": "string"
+                },
+                "lastError": {
+                  "type": "string"
+                },
+                "lastActor": {
+                  "type": "string"
+                },
+                "lastAction": {
+                  "enum": [
+                    "created",
+                    "claim",
+                    "ack",
+                    "nack_retry",
+                    "nack_dead",
+                    "lease_expired",
+                    "attempts_exhausted",
+                    "message_expired",
+                    "cancel",
+                    "requeue"
+                  ]
+                }
+              },
+              "additionalProperties": true
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "requiredScopes": [
+        "deliveries:settle"
+      ]
+    },
+    {
+      "id": "acknowledge_delivery",
+      "summary": "Settle a claimed delivery successfully.",
+      "mcp": {
+        "name": "acknowledge"
+      },
+      "http": {
+        "method": "POST",
+        "path": "/v2/deliveries/{deliveryId}/ack"
+      },
+      "cli": {
+        "command": "ack",
+        "options": [
+          "delivery-id",
+          "lease-token"
+        ],
+        "outputSchema": {
+          "anyOf": [
+            {
+              "type": "object",
+              "required": [
+                "id",
+                "messageId",
+                "workspace",
+                "recipient",
+                "state",
+                "attempt",
+                "cycleAttempt",
+                "requeueCount",
+                "createdAt",
+                "priorityRank",
+                "availableAt",
+                "lastAction"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "messageId": {
+                  "type": "string"
+                },
+                "workspace": {
+                  "type": "string"
+                },
+                "recipient": {
+                  "type": "string"
+                },
+                "state": {
+                  "enum": [
+                    "pending",
+                    "claimed",
+                    "acked",
+                    "retrying",
+                    "dead",
+                    "cancelled"
+                  ]
+                },
+                "attempt": {
+                  "type": "number"
+                },
+                "cycleAttempt": {
+                  "type": "number"
+                },
+                "requeueCount": {
+                  "type": "number"
+                },
+                "createdAt": {
+                  "type": "string"
+                },
+                "priorityRank": {
+                  "type": "number"
+                },
+                "availableAt": {
+                  "type": "string"
+                },
+                "leaseToken": {
+                  "type": "string"
+                },
+                "leaseOwner": {
+                  "type": "string"
+                },
+                "leaseExpiresAt": {
+                  "type": "string"
+                },
+                "lastError": {
+                  "type": "string"
+                },
+                "lastActor": {
+                  "type": "string"
+                },
+                "lastAction": {
+                  "enum": [
+                    "created",
+                    "claim",
+                    "ack",
+                    "nack_retry",
+                    "nack_dead",
+                    "lease_expired",
+                    "attempts_exhausted",
+                    "message_expired",
+                    "cancel",
+                    "requeue"
+                  ]
+                }
+              },
+              "additionalProperties": true
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "requiredScopes": [
+        "deliveries:settle"
+      ]
+    },
+    {
+      "id": "negative_acknowledge_delivery",
+      "summary": "Settle a claimed delivery for retry or dead letter.",
+      "mcp": {
+        "name": "negative_acknowledge"
+      },
+      "http": {
+        "method": "POST",
+        "path": "/v2/deliveries/{deliveryId}/nack"
+      },
+      "cli": {
+        "command": "nack",
+        "options": [
+          "delivery-id",
+          "lease-token",
+          "error",
+          "disposition",
+          "dead"
+        ],
+        "outputSchema": {
+          "anyOf": [
+            {
+              "type": "object",
+              "required": [
+                "id",
+                "messageId",
+                "workspace",
+                "recipient",
+                "state",
+                "attempt",
+                "cycleAttempt",
+                "requeueCount",
+                "createdAt",
+                "priorityRank",
+                "availableAt",
+                "lastAction"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "messageId": {
+                  "type": "string"
+                },
+                "workspace": {
+                  "type": "string"
+                },
+                "recipient": {
+                  "type": "string"
+                },
+                "state": {
+                  "enum": [
+                    "pending",
+                    "claimed",
+                    "acked",
+                    "retrying",
+                    "dead",
+                    "cancelled"
+                  ]
+                },
+                "attempt": {
+                  "type": "number"
+                },
+                "cycleAttempt": {
+                  "type": "number"
+                },
+                "requeueCount": {
+                  "type": "number"
+                },
+                "createdAt": {
+                  "type": "string"
+                },
+                "priorityRank": {
+                  "type": "number"
+                },
+                "availableAt": {
+                  "type": "string"
+                },
+                "leaseToken": {
+                  "type": "string"
+                },
+                "leaseOwner": {
+                  "type": "string"
+                },
+                "leaseExpiresAt": {
+                  "type": "string"
+                },
+                "lastError": {
+                  "type": "string"
+                },
+                "lastActor": {
+                  "type": "string"
+                },
+                "lastAction": {
+                  "enum": [
+                    "created",
+                    "claim",
+                    "ack",
+                    "nack_retry",
+                    "nack_dead",
+                    "lease_expired",
+                    "attempts_exhausted",
+                    "message_expired",
+                    "cancel",
+                    "requeue"
+                  ]
+                }
+              },
+              "additionalProperties": true
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "requiredScopes": [
+        "deliveries:settle"
+      ]
+    },
+    {
+      "id": "heartbeat",
+      "summary": "Publish a leased runtime presence record.",
+      "mcp": {
+        "name": "heartbeat"
+      },
+      "http": {
+        "method": "POST",
+        "path": "/v2/presence/heartbeat"
+      },
+      "cli": {
+        "command": "join",
+        "options": [
+          "lease-ms",
+          "runtime",
+          "capability"
+        ],
+        "outputSchema": {
+          "type": "object",
+          "required": [
+            "workspace",
+            "agent",
+            "instance",
+            "capabilities",
+            "leaseExpiresAt",
+            "lastSeenAt"
+          ],
+          "properties": {
+            "workspace": {
+              "type": "string"
+            },
+            "agent": {
+              "type": "string"
+            },
+            "instance": {
+              "type": "string"
+            },
+            "runtimeType": {
+              "type": "string"
+            },
+            "capabilities": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "leaseExpiresAt": {
+              "type": "string"
+            },
+            "lastSeenAt": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "requiredScopes": [
+        "presence:write"
+      ]
+    },
+    {
+      "id": "presence",
+      "summary": "List active agent runtime instances.",
+      "mcp": {
+        "name": "presence"
+      },
+      "http": {
+        "method": "GET",
+        "path": "/v2/presence"
+      },
+      "cli": {
+        "command": "presence",
+        "options": [],
+        "outputSchema": {
+          "type": "object",
+          "required": [
+            "agents"
+          ],
+          "properties": {
+            "agents": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "workspace",
+                  "agent",
+                  "instance",
+                  "capabilities",
+                  "leaseExpiresAt",
+                  "lastSeenAt"
+                ],
+                "properties": {
+                  "workspace": {
+                    "type": "string"
+                  },
+                  "agent": {
+                    "type": "string"
+                  },
+                  "instance": {
+                    "type": "string"
+                  },
+                  "runtimeType": {
+                    "type": "string"
+                  },
+                  "capabilities": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "leaseExpiresAt": {
+                    "type": "string"
+                  },
+                  "lastSeenAt": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": true
+              }
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "requiredScopes": [
+        "presence:read"
+      ]
+    }
+  ]
+}