Darwin

Send message

send_message

DestructiveIdempotent

Append one typed event to an authorized thread. Use message for ordinary text; action_request for one advertised capability; action_confirmation for the exact proposed external effect; approval_confirmation with decision allow or deny for one additional permission; completion_confirmation to accept a result without authorizing a new effect; or cancellation_request to ask the provider to cancel one operation. Exact request and operation IDs must come from get_thread. Plain text never grants authority, a cancellation request is not confirmed cancellation, and durable acceptance is not remote completion.

Input Schema

TableJSON Schema

Name	Required	Description
`thread`	Yes	Authorized thread identifier returned by start_thread, get_thread, or list_threads.
`attachments`	No	Optional Darwin asset references, allowed only with messageType message; never inline base64 or secrets.
`messageType`	Yes	Typed event mode. Supported values are message, action_request, action_confirmation, approval_confirmation, completion_confirmation, and cancellation_request.
`idempotencyKey`	No	Optional caller-generated retry key. Reuse it only for an unchanged retry after an unknown outcome.
`messageContent`	Yes	Content required by messageType: message uses non-empty text; action_request uses {capability, arguments, account?}; action_confirmation and completion_confirmation use {request}; approval_confirmation uses {request, decision} with decision allow or deny; cancellation_request uses {operation}. Exact request and operation IDs must come from get_thread. Never place credentials, payment details, or approval authority in text.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`cursor`	Yes
`status`	Yes
`thread`	Yes
`message`	Yes
`idempotencyKey`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 5, 2026

removedInput schema / properties / agent

Removed value: -{
-  "description": "Optional authorized Darwin AI. Omit to use the caller's active AI.",
-  "maxLength": 200,
-  "minLength": 1,
-  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-  "type": "string"
-}

Changed4 schema fields changedOct 1, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

removedInput schema / oneOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "agent": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "attachments": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "asset": {
-              "maxLength": 200,
-              "minLength": 1,
-              "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "image",
-                "audio",
-                "video",
-                "file"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "type",
-            "asset"
-          ],
-          "type": "object"
-        },
-        "maxItems": 19,
-        "type": "array"
-      },
-      "idempotencyKey": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "messageContent": {
-        "maxLength": 32000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "messageType": {
-        "const": "message",
-        "type": "string"
-      },
-      "thread": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "thread",
-      "messageType",
-      "messageContent"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "agent": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "idempotencyKey": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "messageContent": {
-        "additionalProperties": false,
-        "properties": {
-          "account": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "arguments": {
-            "additionalProperties": {
-              "$ref": "#/$defs/__schema0"
-            },
-            "propertyNames": {
-              "maxLength": 200,
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "capability": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "capability",
-          "arguments"
-        ],
-        "type": "object"
-      },
-      "messageType": {
-        "const": "action_request",
-        "type": "string"
-      },
-      "thread": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "thread",
-      "messageType",
-      "messageContent"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "agent": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "idempotencyKey": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "messageContent": {
-        "additionalProperties": false,
-        "properties": {
-          "request": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "request"
-        ],
-        "type": "object"
-      },
-      "messageType": {
-        "const": "action_confirmation",
-        "type": "string"
-      },
-      "thread": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "thread",
-      "messageType",
-      "messageContent"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "agent": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "idempotencyKey": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "messageContent": {
-        "additionalProperties": false,
-        "properties": {
-          "decision": {
-            "enum": [
-              "allow",
-              "deny"
-            ],
-            "type": "string"
-          },
-          "request": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "request",
-          "decision"
-        ],
-        "type": "object"
-      },
-      "messageType": {
-        "const": "approval_confirmation",
-        "type": "string"
-      },
-      "thread": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "thread",
-      "messageType",
-      "messageContent"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "agent": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "idempotencyKey": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "messageContent": {
-        "additionalProperties": false,
-        "properties": {
-          "request": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "request"
-        ],
-        "type": "object"
-      },
-      "messageType": {
-        "const": "completion_confirmation",
-        "type": "string"
-      },
-      "thread": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "thread",
-      "messageType",
-      "messageContent"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "agent": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "idempotencyKey": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      },
-      "messageContent": {
-        "additionalProperties": false,
-        "properties": {
-          "operation": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "operation"
-        ],
-        "type": "object"
-      },
-      "messageType": {
-        "const": "cancellation_request",
-        "type": "string"
-      },
-      "thread": {
-        "maxLength": 200,
-        "minLength": 1,
-        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "thread",
-      "messageType",
-      "messageContent"
-    ],
-    "type": "object"
-  }
-]

addedInput schema / properties

Added value: +{
+  "agent": {
+    "description": "Optional authorized Darwin AI. Omit to use the caller's active AI.",
+    "maxLength": 200,
+    "minLength": 1,
+    "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+    "type": "string"
+  },
+  "attachments": {
+    "description": "Optional Darwin asset references, allowed only with messageType message; never inline base64 or secrets.",
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "asset": {
+          "maxLength": 200,
+          "minLength": 1,
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "image",
+            "audio",
+            "video",
+            "file"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "asset"
+      ],
+      "type": "object"
+    },
+    "maxItems": 19,
+    "type": "array"
+  },
+  "idempotencyKey": {
+    "description": "Optional caller-generated retry key. Reuse it only for an unchanged retry after an unknown outcome.",
+    "maxLength": 200,
+    "minLength": 1,
+    "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+    "type": "string"
+  },
+  "messageContent": {
+    "anyOf": [
+      {
+        "maxLength": 32000,
+        "minLength": 1,
+        "type": "string"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "account": {
+            "description": "Optional saved external-account reference. This is an opaque Darwin ID, never a token or secret.",
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          },
+          "arguments": {
+            "additionalProperties": {
+              "$ref": "#/$defs/__schema0"
+            },
+            "description": "Arguments for that capability, matching its advertised input schema. Never include credentials or payment details.",
+            "propertyNames": {
+              "maxLength": 200,
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "capability": {
+            "description": "Exact executable capability identifier returned by Search or get_thread.",
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "capability",
+          "arguments"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "request": {
+            "description": "Exact immutable request identifier returned by get_thread.",
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "request"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "decision": {
+            "description": "Approval decision: allow authorizes only the referenced request; deny rejects only that request. Neither value substitutes for another request type.",
+            "enum": [
+              "allow",
+              "deny"
+            ],
+            "type": "string"
+          },
+          "request": {
+            "description": "Exact immutable approval request identifier returned by get_thread.",
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "request",
+          "decision"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "operation": {
+            "description": "Exact operation identifier returned by get_thread whose cancellation should be requested.",
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "operation"
+        ],
+        "type": "object"
+      }
+    ],
+    "description": "Content required by messageType: message uses non-empty text; action_request uses {capability, arguments, account?}; action_confirmation and completion_confirmation use {request}; approval_confirmation uses {request, decision} with decision allow or deny; cancellation_request uses {operation}. Exact request and operation IDs must come from get_thread. Never place credentials, payment details, or approval authority in text."
+  },
+  "messageType": {
+    "description": "Typed event mode. Supported values are message, action_request, action_confirmation, approval_confirmation, completion_confirmation, and cancellation_request.",
+    "enum": [
+      "message",
+      "action_request",
+      "action_confirmation",
+      "approval_confirmation",
+      "completion_confirmation",
+      "cancellation_request"
+    ],
+    "type": "string"
+  },
+  "thread": {
+    "description": "Authorized thread identifier returned by start_thread, get_thread, or list_threads.",
+    "maxLength": 200,
+    "minLength": 1,
+    "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+    "type": "string"
+  }
+}

addedInput schema / required

Added value: +[
+  "thread",
+  "messageType",
+  "messageContent"
+]

Changed14 schema fields changedOct 1, 2026

removedInput schema / $defs / __schema1

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "number"
-    },
-    {
-      "type": "boolean"
-    },
-    {
-      "type": "null"
-    },
-    {
-      "items": {
-        "$ref": "#/$defs/__schema1"
-      },
-      "type": "array"
-    },
-    {
-      "additionalProperties": {
-        "$ref": "#/$defs/__schema1"
-      },
-      "propertyNames": {
-        "type": "string"
-      },
-      "type": "object"
-    }
-  ]
-}

removedInput schema / additionalProperties
```
Removed value: -false
```

addedInput schema / oneOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "agent": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "attachments": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "asset": {
+              "maxLength": 200,
+              "minLength": 1,
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+              "type": "string"
+            },
+            "type": {
+              "enum": [
+                "image",
+                "audio",
+                "video",
+                "file"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "asset"
+          ],
+          "type": "object"
+        },
+        "maxItems": 19,
+        "type": "array"
+      },
+      "idempotencyKey": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "messageContent": {
+        "maxLength": 32000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "messageType": {
+        "const": "message",
+        "type": "string"
+      },
+      "thread": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "thread",
+      "messageType",
+      "messageContent"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "agent": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "idempotencyKey": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "messageContent": {
+        "additionalProperties": false,
+        "properties": {
+          "account": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          },
+          "arguments": {
+            "additionalProperties": {
+              "$ref": "#/$defs/__schema0"
+            },
+            "propertyNames": {
+              "maxLength": 200,
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "capability": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "capability",
+          "arguments"
+        ],
+        "type": "object"
+      },
+      "messageType": {
+        "const": "action_request",
+        "type": "string"
+      },
+      "thread": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "thread",
+      "messageType",
+      "messageContent"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "agent": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "idempotencyKey": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "messageContent": {
+        "additionalProperties": false,
+        "properties": {
+          "request": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "request"
+        ],
+        "type": "object"
+      },
+      "messageType": {
+        "const": "action_confirmation",
+        "type": "string"
+      },
+      "thread": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "thread",
+      "messageType",
+      "messageContent"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "agent": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "idempotencyKey": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "messageContent": {
+        "additionalProperties": false,
+        "properties": {
+          "decision": {
+            "enum": [
+              "allow",
+              "deny"
+            ],
+            "type": "string"
+          },
+          "request": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "request",
+          "decision"
+        ],
+        "type": "object"
+      },
+      "messageType": {
+        "const": "approval_confirmation",
+        "type": "string"
+      },
+      "thread": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "thread",
+      "messageType",
+      "messageContent"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "agent": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "idempotencyKey": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "messageContent": {
+        "additionalProperties": false,
+        "properties": {
+          "request": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "request"
+        ],
+        "type": "object"
+      },
+      "messageType": {
+        "const": "completion_confirmation",
+        "type": "string"
+      },
+      "thread": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "thread",
+      "messageType",
+      "messageContent"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "agent": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "idempotencyKey": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      },
+      "messageContent": {
+        "additionalProperties": false,
+        "properties": {
+          "operation": {
+            "maxLength": 200,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "operation"
+        ],
+        "type": "object"
+      },
+      "messageType": {
+        "const": "cancellation_request",
+        "type": "string"
+      },
+      "thread": {
+        "maxLength": 200,
+        "minLength": 1,
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "thread",
+      "messageType",
+      "messageContent"
+    ],
+    "type": "object"
+  }
+]

removedInput schema / properties

Removed value: -{
-  "actingAiId": {
-    "maxLength": 200,
-    "minLength": 1,
-    "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-    "type": "string"
-  },
-  "clientMessageId": {
-    "maxLength": 200,
-    "minLength": 1,
-    "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-    "type": "string"
-  },
-  "event": {
-    "oneOf": [
-      {
-        "additionalProperties": false,
-        "properties": {
-          "parts": {
-            "items": {
-              "oneOf": [
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "text": {
-                      "maxLength": 32000,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": {
-                      "const": "text",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "text"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "assetId": {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-                      "type": "string"
-                    },
-                    "type": {
-                      "const": "image",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "assetId"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "assetId": {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-                      "type": "string"
-                    },
-                    "type": {
-                      "const": "audio",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "assetId"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "assetId": {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-                      "type": "string"
-                    },
-                    "type": {
-                      "const": "video",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "assetId"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "assetId": {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-                      "type": "string"
-                    },
-                    "type": {
-                      "const": "file",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "assetId"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "maxItems": 20,
-            "minItems": 1,
-            "type": "array"
-          },
-          "type": {
-            "const": "message",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "parts"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "accountId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "arguments": {
-            "additionalProperties": {
-              "$ref": "#/$defs/__schema0"
-            },
-            "propertyNames": {
-              "maxLength": 200,
-              "type": "string"
-            },
-            "type": "object"
-          },
-          "capabilityId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "action_request",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "capabilityId",
-          "arguments"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "requestDigest": {
-            "pattern": "^[a-f0-9]{64}$",
-            "type": "string"
-          },
-          "requestId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "requestRevision": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "type": {
-            "const": "action_confirmation",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "requestId",
-          "requestDigest",
-          "requestRevision"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "expiresAt": {
-            "format": "date-time",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
-            "type": "string"
-          },
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "reason": {
-            "maxLength": 2000,
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": {
-            "const": "approval_request",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "operationId",
-          "reason",
-          "expiresAt"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "decision": {
-            "enum": [
-              "allow",
-              "deny"
-            ],
-            "type": "string"
-          },
-          "requestDigest": {
-            "pattern": "^[a-f0-9]{64}$",
-            "type": "string"
-          },
-          "requestId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "requestRevision": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "type": {
-            "const": "approval_confirmation",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "requestId",
-          "requestDigest",
-          "requestRevision",
-          "decision"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "requestId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "approval_expired",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "requestId",
-          "operationId"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "paymentRequestId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "payment_expired",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "paymentRequestId",
-          "operationId"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "accountId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "authType": {
-            "maxLength": 100,
-            "minLength": 1,
-            "pattern": "^[a-z][a-z0-9_]*(?:\\.[a-z][a-z0-9_]*)*$",
-            "type": "string"
-          },
-          "authenticationRequestId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "resource": {
-            "format": "uri",
-            "maxLength": 2000,
-            "type": "string"
-          },
-          "scopes": {
-            "items": {
-              "maxLength": 200,
-              "minLength": 1,
-              "type": "string"
-            },
-            "maxItems": 50,
-            "type": "array"
-          },
-          "targetAiId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "authentication_request",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "authenticationRequestId",
-          "operationId",
-          "targetAiId",
-          "authType",
-          "resource",
-          "scopes"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "accountId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "expiresAt": {
-            "format": "date-time",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
-            "type": "string"
-          },
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "scopes": {
-            "items": {
-              "maxLength": 200,
-              "type": "string"
-            },
-            "maxItems": 50,
-            "type": "array"
-          },
-          "targetAiId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "authentication_required",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "operationId",
-          "targetAiId",
-          "scopes"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "accountId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "requestId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "authentication_confirmation",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "requestId",
-          "operationId",
-          "accountId"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "acceptedMethods": {
-            "items": {
-              "enum": [
-                "card",
-                "bank",
-                "hosted_checkout",
-                "darwin_wallet",
-                "mpp",
-                "x402",
-                "ucp",
-                "acp"
-              ],
-              "type": "string"
-            },
-            "maxItems": 8,
-            "minItems": 1,
-            "type": "array"
-          },
-          "amountMinor": {
-            "pattern": "^[1-9][0-9]{0,17}$",
-            "type": "string"
-          },
-          "currency": {
-            "pattern": "^[A-Z]{3}$",
-            "type": "string"
-          },
-          "expiresAt": {
-            "format": "date-time",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
-            "type": "string"
-          },
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "payeeId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "payeeName": {
-            "maxLength": 200,
-            "minLength": 1,
-            "type": "string"
-          },
-          "paymentRequestId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "payment_request",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "paymentRequestId",
-          "operationId",
-          "amountMinor",
-          "currency",
-          "payeeId",
-          "payeeName",
-          "expiresAt",
-          "acceptedMethods"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "paymentRequestId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "receiptId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "payment_confirmation",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "paymentRequestId",
-          "receiptId",
-          "operationId"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "disputeAmountMinor": {
-            "pattern": "^[1-9][0-9]{0,17}$",
-            "type": "string"
-          },
-          "disputeStatus": {
-            "enum": [
-              "warning_needs_response",
-              "warning_under_review",
-              "warning_closed",
-              "needs_response",
-              "under_review",
-              "won",
-              "lost"
-            ],
-            "type": "string"
-          },
-          "failedRefundAmountMinor": {
-            "pattern": "^[1-9][0-9]{0,17}$",
-            "type": "string"
-          },
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "paymentRequestId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "pendingRefundAmountMinor": {
-            "pattern": "^[1-9][0-9]{0,17}$",
-            "type": "string"
-          },
-          "refundAmountMinor": {
-            "pattern": "^(0|[1-9][0-9]{0,17})$",
-            "type": "string"
-          },
-          "status": {
-            "enum": [
-              "pending",
-              "failed",
-              "voided",
-              "partially_refunded",
-              "reversal_pending",
-              "reversal_failed",
-              "disputed",
-              "refunded"
-            ],
-            "type": "string"
-          },
-          "type": {
-            "const": "payment_status",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "paymentRequestId",
-          "operationId",
-          "status"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "data": {
-            "$ref": "#/$defs/__schema1"
-          },
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "parts": {
-            "items": {
-              "oneOf": [
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "text": {
-                      "maxLength": 32000,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "type": {
-                      "const": "text",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "text"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "assetId": {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-                      "type": "string"
-                    },
-                    "type": {
-                      "const": "image",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "assetId"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "assetId": {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-                      "type": "string"
-                    },
-                    "type": {
-                      "const": "audio",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "assetId"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "assetId": {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-                      "type": "string"
-                    },
-                    "type": {
-                      "const": "video",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "assetId"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "assetId": {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-                      "type": "string"
-                    },
-                    "type": {
-                      "const": "file",
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "assetId"
-                  ],
-                  "type": "object"
-                }
-              ]
-            },
-            "maxItems": 20,
-            "type": "array"
-          },
-          "type": {
-            "const": "result",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "operationId",
-          "parts"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "completion_request",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "operationId"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "requestDigest": {
-            "pattern": "^[a-f0-9]{64}$",
-            "type": "string"
-          },
-          "requestId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "requestRevision": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "type": {
-            "const": "completion_confirmation",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "requestId",
-          "requestDigest",
-          "requestRevision"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "cancellation_request",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "operationId"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "action_withdrawn",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "operationId"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "providerReceiptId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "type": {
-            "const": "cancellation_confirmation",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "operationId",
-          "providerReceiptId"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "messageId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "status": {
-            "enum": [
-              "accepted",
-              "delivered",
-              "failed",
-              "unknown"
-            ],
-            "type": "string"
-          },
-          "type": {
-            "const": "delivery_status",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "messageId",
-          "status"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "status": {
-            "enum": [
-              "queued",
-              "running",
-              "waiting",
-              "reconciling"
-            ],
-            "type": "string"
-          },
-          "type": {
-            "const": "status",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "operationId",
-          "status"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "operationId": {
-            "maxLength": 200,
-            "minLength": 1,
-            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-            "type": "string"
-          },
-          "retryable": {
-            "type": "boolean"
-          },
-          "type": {
-            "const": "error",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "code",
-          "retryable"
-        ],
-        "type": "object"
-      }
-    ]
-  },
-  "expectedRevision": {
-    "maximum": 9007199254740991,
-    "minimum": 0,
-    "type": "integer"
-  },
-  "threadId": {
-    "maxLength": 200,
-    "minLength": 1,
-    "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-    "type": "string"
-  }
-}

removedInput schema / required

Removed value: -[
-  "actingAiId",
-  "threadId",
-  "clientMessageId",
-  "expectedRevision",
-  "event"
-]

removedOutput schema / properties / accepted

Removed value: -{
-  "const": true,
-  "type": "boolean"
-}

removedOutput schema / properties / delivery

Removed value: -{
-  "const": "accepted",
-  "type": "string"
-}

removedOutput schema / properties / eventId

Removed value: -{
-  "maxLength": 200,
-  "minLength": 1,
-  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
-  "type": "string"
-}

addedOutput schema / properties / idempotencyKey

Added value: +{
+  "maxLength": 200,
+  "minLength": 1,
+  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+  "type": "string"
+}

addedOutput schema / properties / message

Added value: +{
+  "maxLength": 200,
+  "minLength": 1,
+  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+  "type": "string"
+}

removedOutput schema / properties / revision

Removed value: -{
-  "maximum": 9007199254740991,
-  "minimum": 0,
-  "type": "integer"
-}

addedOutput schema / properties / status

Added value: +{
+  "const": "accepted",
+  "type": "string"
+}

addedOutput schema / properties / thread

Added value: +{
+  "maxLength": 200,
+  "minLength": 1,
+  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
+  "type": "string"
+}

changedOutput schema / required

Previous value: -[
-  "accepted",
-  "eventId",
-  "revision",
-  "cursor",
-  "delivery"
-]New value: +[
+  "thread",
+  "message",
+  "status",
+  "cursor",
+  "idempotencyKey"
+]

AddedSep 29, 2026

TDQS

A4.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, idempotentHint=true, and openWorldHint=true, so the safety profile is covered by structured data. The description earns credit for non-obvious semantics the annotations cannot express: 'Plain text never grants authority, a cancellation request is not confirmed cancellation, and durable acceptance is not remote completion.' It does not, however, restate authorization requirements or retry semantics beyond what the idempotencyKey schema field already says.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the core action and prerequisite (IDs from get_thread) before the long mode enumeration, and every clause maps to a real decision the caller must make. The middle sentence is dense but not padded; slightly tighter formatting of the six modes would help.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values need no explanation, and annotations carry the destructive/idempotent profile. The description covers the modes, the authorized-thread constraint, ID provenance, and the authority caveats, leaving only minor gaps such as error/failure behavior after an ambiguous outcome.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents thread, messageType, messageContent shapes, attachments, and idempotencyKey provenance. The description's mode-to-payload mapping largely restates what the enum and the messageContent description already provide, so baseline 3 is correct.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource ('Append one typed event to an authorized thread') and immediately differentiates the six event modes it can produce. An agent can distinguish this from archive_thread, start_thread, and get_thread without opening the schema, since the description pins it to appending events on an existing authorized thread.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit per-mode routing: 'Use message for ordinary text; action_request for one advertised capability; action_confirmation for the exact proposed external effect...'. It also names the prerequisite source for the required IDs ('must come from get_thread'), which is a concrete when-to-use dependency rather than an inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Darwin tools Inspect

Try in Browser

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?