Skip to main content
Glama

Get assist request

get_assist
Read-onlyIdempotent

Read the caller-owned Assist request, revisions, quote and run evidence. Assist is release-gated and may be unavailable. A plan is not proof of execution.

Input Schema

NameRequiredDescriptionDefault
beforeNoUse conversation.nextBefore to read earlier turns; omit for the latest page.
assistIdYesExact assistId returned by Assist for the request to read.
assistTokenNoPrivate guest continuation token returned by Navigate.

Output Schema

NameRequiredDescriptionDefault
runYes
goalYes
quoteYes
statusYes
fundingYes
assistIdYes
messagesYes
createdAtYes
revisionsYes
updatedAtYes
assistTokenNo
conversationNo
previousRunsYes
latestRevisionIdYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / assistToken
      Added value: +{
      +  "description": "Private guest continuation token returned by Navigate.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
    • addedInput schema / properties / before
      Added value: +{
      +  "description": "Use conversation.nextBefore to read earlier turns; omit for the latest page.",
      +  "maxLength": 200,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedOutput schema / properties / conversation
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "eventCursor": {
      +      "type": "string"
      +    },
      +    "nextBefore": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "turns": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "attachments": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "mimeType": {
      +                  "maxLength": 100,
      +                  "type": "string"
      +                },
      +                "name": {
      +                  "maxLength": 200,
      +                  "minLength": 1,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "name",
      +                "mimeType"
      +              ],
      +              "type": "object"
      +            },
      +            "maxItems": 10,
      +            "type": "array"
      +          },
      +          "blocks": {
      +            "items": {
      +              "oneOf": [
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "text": {
      +                      "type": "string"
      +                    },
      +                    "type": {
      +                      "const": "text",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "type",
      +                    "text"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "agents": {
      +                      "items": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "agentId": {
      +                            "maxLength": 200,
      +                            "minLength": 1,
      +                            "type": "string"
      +                          },
      +                          "agentSlug": {
      +                            "anyOf": [
      +                              {
      +                                "maxLength": 200,
      +                                "minLength": 1,
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "avatarUrl": {
      +                            "anyOf": [
      +                              {
      +                                "format": "uri",
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "canAttemptThread": {
      +                            "type": "boolean"
      +                          },
      +                          "canStartThread": {
      +                            "type": "boolean"
      +                          },
      +                          "connectionMethods": {
      +                            "default": [],
      +                            "items": {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "documentationUrl": {
      +                                  "format": "uri",
      +                                  "type": "string"
      +                                },
      +                                "endpointStatus": {
      +                                  "enum": [
      +                                    "not_published",
      +                                    "verified"
      +                                  ],
      +                                  "type": "string"
      +                                },
      +                                "endpointUrl": {
      +                                  "anyOf": [
      +                                    {
      +                                      "format": "uri",
      +                                      "type": "string"
      +                                    },
      +                                    {
      +                                      "type": "null"
      +                                    }
      +                                  ]
      +                                },
      +                                "environment": {
      +                                  "enum": [
      +                                    "remote_client",
      +                                    "browser_session"
      +                                  ],
      +                                  "type": "string"
      +                                },
      +                                "protocol": {
      +                                  "enum": [
      +                                    "MCP",
      +                                    "A2A",
      +                                    "WEBMCP"
      +                                  ],
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "protocol",
      +                                "environment",
      +                                "endpointUrl",
      +                                "endpointStatus",
      +                                "documentationUrl"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            "maxItems": 3,
      +                            "type": "array"
      +                          },
      +                          "connectionPrompt": {
      +                            "maxLength": 60000,
      +                            "minLength": 1,
      +                            "type": "string"
      +                          },
      +                          "description": {
      +                            "anyOf": [
      +                              {
      +                                "maxLength": 8000,
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "executionGuidance": {
      +                            "anyOf": [
      +                              {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "credentialSummary": {
      +                                    "maxLength": 1000,
      +                                    "minLength": 1,
      +                                    "type": "string"
      +                                  },
      +                                  "credentialSummaryCode": {
      +                                    "maxLength": 200,
      +                                    "minLength": 1,
      +                                    "type": "string"
      +                                  },
      +                                  "primaryBlockerCode": {
      +                                    "anyOf": [
      +                                      {
      +                                        "enum": [
      +                                          "PROVIDER_ROUTE_UNSUPPORTED",
      +                                          "PROVIDER_SCHEMA_MISSING",
      +                                          "PROVIDER_AUTH_SCHEME_UNSPECIFIED",
      +                                          "PROVIDER_METADATA_INCOMPLETE",
      +                                          "DARWIN_ADAPTER_UNAVAILABLE",
      +                                          "DARWIN_ROUTE_NOT_APPROVED",
      +                                          "DARWIN_LOCAL_RUNTIME_UNAVAILABLE",
      +                                          "DARWIN_BROWSER_RUNTIME_UNAVAILABLE",
      +                                          "DARWIN_PAYMENT_RUNTIME_UNAVAILABLE"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      {
      +                                        "type": "null"
      +                                      }
      +                                    ]
      +                                  },
      +                                  "recordBlockers": {
      +                                    "items": {
      +                                      "additionalProperties": false,
      +                                      "properties": {
      +                                        "code": {
      +                                          "enum": [
      +                                            "PROVIDER_ROUTE_UNSUPPORTED",
      +                                            "PROVIDER_SCHEMA_MISSING",
      +                                            "PROVIDER_AUTH_SCHEME_UNSPECIFIED",
      +                                            "PROVIDER_METADATA_INCOMPLETE",
      +                                            "DARWIN_ADAPTER_UNAVAILABLE",
      +                                            "DARWIN_ROUTE_NOT_APPROVED",
      +                                            "DARWIN_LOCAL_RUNTIME_UNAVAILABLE",
      +                                            "DARWIN_BROWSER_RUNTIME_UNAVAILABLE",
      +                                            "DARWIN_PAYMENT_RUNTIME_UNAVAILABLE"
      +                                          ],
      +                                          "type": "string"
      +                                        },
      +                                        "owner": {
      +                                          "enum": [
      +                                            "PROVIDER",
      +                                            "DARWIN"
      +                                          ],
      +                                          "type": "string"
      +                                        }
      +                                      },
      +                                      "required": [
      +                                        "code",
      +                                        "owner"
      +                                      ],
      +                                      "type": "object"
      +                                    },
      +                                    "maxItems": 20,
      +                                    "type": "array"
      +                                  },
      +                                  "rendererVersion": {
      +                                    "const": "execution-guidance-v1",
      +                                    "type": "string"
      +                                  },
      +                                  "setupSummary": {
      +                                    "maxLength": 1000,
      +                                    "minLength": 1,
      +                                    "type": "string"
      +                                  },
      +                                  "setupSummaryCode": {
      +                                    "maxLength": 200,
      +                                    "minLength": 1,
      +                                    "type": "string"
      +                                  }
      +                                },
      +                                "required": [
      +                                  "credentialSummaryCode",
      +                                  "credentialSummary",
      +                                  "setupSummaryCode",
      +                                  "setupSummary",
      +                                  "recordBlockers",
      +                                  "primaryBlockerCode",
      +                                  "rendererVersion"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ],
      +                            "default": null
      +                          },
      +                          "executionRequirements": {
      +                            "anyOf": [
      +                              {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "browser": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "sessionKind": {
      +                                        "anyOf": [
      +                                          {
      +                                            "enum": [
      +                                              "ANONYMOUS",
      +                                              "PROVIDER_SESSION",
      +                                              "UNKNOWN"
      +                                            ],
      +                                            "type": "string"
      +                                          },
      +                                          {
      +                                            "type": "null"
      +                                          }
      +                                        ]
      +                                      },
      +                                      "state": {
      +                                        "enum": [
      +                                          "REQUIRED",
      +                                          "NOT_REQUIRED",
      +                                          "UNKNOWN",
      +                                          "NOT_APPLICABLE"
      +                                        ],
      +                                        "type": "string"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "state",
      +                                      "sessionKind"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "contractVersion": {
      +                                    "const": "1.0.0",
      +                                    "type": "string"
      +                                  },
      +                                  "derivation": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "completeness": {
      +                                        "enum": [
      +                                          "COMPLETE",
      +                                          "PARTIAL"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      "derivationKey": {
      +                                        "pattern": "^sha256:[a-f0-9]{64}$",
      +                                        "type": "string"
      +                                      },
      +                                      "normalizerVersion": {
      +                                        "const": "execution-requirements-v1",
      +                                        "type": "string"
      +                                      },
      +                                      "sourceReceiptDigest": {
      +                                        "anyOf": [
      +                                          {
      +                                            "maxLength": 200,
      +                                            "type": "string"
      +                                          },
      +                                          {
      +                                            "type": "null"
      +                                          }
      +                                        ]
      +                                      },
      +                                      "sourceRevision": {
      +                                        "maxLength": 240,
      +                                        "minLength": 1,
      +                                        "type": "string"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "normalizerVersion",
      +                                      "sourceRevision",
      +                                      "sourceReceiptDigest",
      +                                      "completeness",
      +                                      "derivationKey"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "operationCredentials": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "sensitiveInputNames": {
      +                                        "items": {
      +                                          "maxLength": 200,
      +                                          "minLength": 1,
      +                                          "type": "string"
      +                                        },
      +                                        "maxItems": 100,
      +                                        "type": "array"
      +                                      },
      +                                      "state": {
      +                                        "enum": [
      +                                          "REQUIRED",
      +                                          "NOT_REQUIRED",
      +                                          "UNKNOWN",
      +                                          "NOT_APPLICABLE"
      +                                        ],
      +                                        "type": "string"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "state",
      +                                      "sensitiveInputNames"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "payment": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "state": {
      +                                        "enum": [
      +                                          "REQUIRED",
      +                                          "NOT_REQUIRED",
      +                                          "UNKNOWN",
      +                                          "NOT_APPLICABLE"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      "termsDigest": {
      +                                        "anyOf": [
      +                                          {
      +                                            "maxLength": 200,
      +                                            "type": "string"
      +                                          },
      +                                          {
      +                                            "type": "null"
      +                                          }
      +                                        ]
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "state",
      +                                      "termsDigest"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "providerAuthentication": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "evidence": {
      +                                        "enum": [
      +                                          "PROVIDER_DECLARED",
      +                                          "PROVIDER_OBSERVED",
      +                                          "DERIVED_FROM_VERIFIED_RECEIPT",
      +                                          "UNKNOWN"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      "mechanisms": {
      +                                        "items": {
      +                                          "enum": [
      +                                            "BEARER",
      +                                            "API_KEY",
      +                                            "OAUTH2",
      +                                            "HTTP_BASIC",
      +                                            "MUTUAL_TLS",
      +                                            "SIGNED_REQUEST",
      +                                            "SESSION_COOKIE",
      +                                            "OPERATION_SECRET_INPUT",
      +                                            "UNSPECIFIED"
      +                                          ],
      +                                          "type": "string"
      +                                        },
      +                                        "maxItems": 20,
      +                                        "type": "array"
      +                                      },
      +                                      "placements": {
      +                                        "items": {
      +                                          "enum": [
      +                                            "HEADER",
      +                                            "QUERY",
      +                                            "COOKIE",
      +                                            "BODY",
      +                                            "TOOL_ARGUMENT",
      +                                            "ENVIRONMENT",
      +                                            "AUTH_CONTINUATION"
      +                                          ],
      +                                          "type": "string"
      +                                        },
      +                                        "maxItems": 20,
      +                                        "type": "array"
      +                                      },
      +                                      "scopes": {
      +                                        "items": {
      +                                          "maxLength": 200,
      +                                          "minLength": 1,
      +                                          "type": "string"
      +                                        },
      +                                        "maxItems": 100,
      +                                        "type": "array"
      +                                      },
      +                                      "state": {
      +                                        "enum": [
      +                                          "REQUIRED",
      +                                          "NOT_REQUIRED",
      +                                          "UNKNOWN",
      +                                          "NOT_APPLICABLE"
      +                                        ],
      +                                        "type": "string"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "state",
      +                                      "mechanisms",
      +                                      "placements",
      +                                      "scopes",
      +                                      "evidence"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "providerBlockers": {
      +                                    "items": {
      +                                      "additionalProperties": false,
      +                                      "properties": {
      +                                        "code": {
      +                                          "enum": [
      +                                            "PROVIDER_ROUTE_UNSUPPORTED",
      +                                            "PROVIDER_SCHEMA_MISSING",
      +                                            "PROVIDER_AUTH_SCHEME_UNSPECIFIED",
      +                                            "PROVIDER_METADATA_INCOMPLETE",
      +                                            "DARWIN_ADAPTER_UNAVAILABLE",
      +                                            "DARWIN_ROUTE_NOT_APPROVED",
      +                                            "DARWIN_LOCAL_RUNTIME_UNAVAILABLE",
      +                                            "DARWIN_BROWSER_RUNTIME_UNAVAILABLE",
      +                                            "DARWIN_PAYMENT_RUNTIME_UNAVAILABLE"
      +                                          ],
      +                                          "type": "string"
      +                                        },
      +                                        "owner": {
      +                                          "enum": [
      +                                            "PROVIDER",
      +                                            "DARWIN"
      +                                          ],
      +                                          "type": "string"
      +                                        }
      +                                      },
      +                                      "required": [
      +                                        "code",
      +                                        "owner"
      +                                      ],
      +                                      "type": "object"
      +                                    },
      +                                    "maxItems": 20,
      +                                    "type": "array"
      +                                  },
      +                                  "providerContract": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "inputSchema": {
      +                                        "enum": [
      +                                          "CONCRETE",
      +                                          "DIGEST_ONLY",
      +                                          "MISSING",
      +                                          "UNKNOWN"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      "outputSchema": {
      +                                        "enum": [
      +                                          "CONCRETE",
      +                                          "DIGEST_ONLY",
      +                                          "MISSING",
      +                                          "UNKNOWN"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      "route": {
      +                                        "enum": [
      +                                          "RESOLVED",
      +                                          "MISSING",
      +                                          "AMBIGUOUS",
      +                                          "UNSAFE",
      +                                          "UNSUPPORTED",
      +                                          "UNKNOWN"
      +                                        ],
      +                                        "type": "string"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "route",
      +                                      "inputSchema",
      +                                      "outputSchema"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "runtime": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "kind": {
      +                                        "enum": [
      +                                          "REMOTE_MCP",
      +                                          "LOCAL_STDIO",
      +                                          "A2A_JSONRPC",
      +                                          "HTTP_JSON",
      +                                          "OPENAPI_HTTP",
      +                                          "BOUNDED_FETCH",
      +                                          "BROWSER",
      +                                          "X402_PAYMENT",
      +                                          "COMMERCE",
      +                                          "UNSUPPORTED"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      "package": {
      +                                        "anyOf": [
      +                                          {
      +                                            "additionalProperties": false,
      +                                            "properties": {
      +                                              "ecosystem": {
      +                                                "maxLength": 40,
      +                                                "minLength": 1,
      +                                                "type": "string"
      +                                              },
      +                                              "identifier": {
      +                                                "maxLength": 500,
      +                                                "minLength": 1,
      +                                                "type": "string"
      +                                              },
      +                                              "runtimeProfile": {
      +                                                "maxLength": 120,
      +                                                "minLength": 1,
      +                                                "type": "string"
      +                                              },
      +                                              "version": {
      +                                                "maxLength": 200,
      +                                                "minLength": 1,
      +                                                "type": "string"
      +                                              }
      +                                            },
      +                                            "required": [
      +                                              "ecosystem",
      +                                              "identifier",
      +                                              "version",
      +                                              "runtimeProfile"
      +                                            ],
      +                                            "type": "object"
      +                                          },
      +                                          {
      +                                            "type": "null"
      +                                          }
      +                                        ]
      +                                      },
      +                                      "requiredEnvironmentNames": {
      +                                        "items": {
      +                                          "maxLength": 200,
      +                                          "minLength": 1,
      +                                          "type": "string"
      +                                        },
      +                                        "maxItems": 100,
      +                                        "type": "array"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "kind",
      +                                      "package",
      +                                      "requiredEnvironmentNames"
      +                                    ],
      +                                    "type": "object"
      +                                  }
      +                                },
      +                                "required": [
      +                                  "contractVersion",
      +                                  "providerAuthentication",
      +                                  "operationCredentials",
      +                                  "runtime",
      +                                  "payment",
      +                                  "browser",
      +                                  "providerContract",
      +                                  "providerBlockers",
      +                                  "derivation"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ],
      +                            "default": null
      +                          },
      +                          "imageUrl": {
      +                            "anyOf": [
      +                              {
      +                                "format": "uri",
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "inquiry": {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "description": {
      +                                "maxLength": 1200,
      +                                "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"
      +                              },
      +                              "fit": {
      +                                "enum": [
      +                                  "matches",
      +                                  "partial",
      +                                  "not_fit",
      +                                  "unknown"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              "question": {
      +                                "maxLength": 2000,
      +                                "minLength": 1,
      +                                "type": "string"
      +                              },
      +                              "reason": {
      +                                "maxLength": 250,
      +                                "type": "string"
      +                              },
      +                              "replies": {
      +                                "items": {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "at": {
      +                                      "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"
      +                                    },
      +                                    "messageId": {
      +                                      "maxLength": 200,
      +                                      "minLength": 1,
      +                                      "type": "string"
      +                                    },
      +                                    "text": {
      +                                      "maxLength": 8000,
      +                                      "minLength": 1,
      +                                      "type": "string"
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "messageId",
      +                                    "text",
      +                                    "at"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                "maxItems": 4,
      +                                "type": "array"
      +                              },
      +                              "status": {
      +                                "enum": [
      +                                  "contacting",
      +                                  "waiting",
      +                                  "following_up",
      +                                  "replied",
      +                                  "needs_input",
      +                                  "no_reply",
      +                                  "not_contacted",
      +                                  "outcome_unknown"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              "threadId": {
      +                                "maxLength": 200,
      +                                "minLength": 1,
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "status",
      +                              "question",
      +                              "replies"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          "name": {
      +                            "maxLength": 500,
      +                            "minLength": 1,
      +                            "type": "string"
      +                          },
      +                          "operationId": {
      +                            "maxLength": 200,
      +                            "minLength": 1,
      +                            "type": "string"
      +                          },
      +                          "operationRevision": {
      +                            "exclusiveMinimum": 0,
      +                            "maximum": 9007199254740991,
      +                            "type": "integer"
      +                          },
      +                          "providerCheck": {
      +                            "enum": [
      +                              "not_attempted",
      +                              "confirmed",
      +                              "unconfirmed",
      +                              "unavailable"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "providerFamilyRef": {
      +                            "anyOf": [
      +                              {
      +                                "pattern": "^provider-family:sha256:[a-f0-9]{64}$",
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ],
      +                            "default": null
      +                          },
      +                          "rank": {
      +                            "exclusiveMinimum": 0,
      +                            "maximum": 9007199254740991,
      +                            "type": "integer"
      +                          },
      +                          "readiness": {
      +                            "enum": [
      +                              "ready",
      +                              "authentication_required",
      +                              "recheck_required",
      +                              "unavailable"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "reasons": {
      +                            "items": {
      +                              "maxLength": 250,
      +                              "type": "string"
      +                            },
      +                            "maxItems": 3,
      +                            "type": "array"
      +                          },
      +                          "requiredSetup": {
      +                            "anyOf": [
      +                              {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "description": {
      +                                    "maxLength": 500,
      +                                    "minLength": 1,
      +                                    "type": "string"
      +                                  },
      +                                  "kind": {
      +                                    "enum": [
      +                                      "credential",
      +                                      "installation",
      +                                      "provider_configuration"
      +                                    ],
      +                                    "type": "string"
      +                                  },
      +                                  "suppliedBy": {
      +                                    "enum": [
      +                                      "user",
      +                                      "provider",
      +                                      "runtime"
      +                                    ],
      +                                    "type": "string"
      +                                  }
      +                                },
      +                                "required": [
      +                                  "kind",
      +                                  "suppliedBy",
      +                                  "description"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ],
      +                            "default": null
      +                          },
      +                          "selected": {
      +                            "type": "boolean"
      +                          },
      +                          "uncertainties": {
      +                            "items": {
      +                              "maxLength": 250,
      +                              "type": "string"
      +                            },
      +                            "maxItems": 3,
      +                            "type": "array"
      +                          }
      +                        },
      +                        "required": [
      +                          "agentId",
      +                          "agentSlug",
      +                          "operationId",
      +                          "operationRevision",
      +                          "providerFamilyRef",
      +                          "rank",
      +                          "selected",
      +                          "name",
      +                          "description",
      +                          "requiredSetup",
      +                          "executionRequirements",
      +                          "executionGuidance",
      +                          "readiness",
      +                          "canStartThread",
      +                          "reasons",
      +                          "uncertainties",
      +                          "providerCheck",
      +                          "connectionMethods",
      +                          "connectionPrompt"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "maxItems": 20,
      +                      "type": "array"
      +                    },
      +                    "role": {
      +                      "enum": [
      +                        "suggested",
      +                        "used"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "searchId": {
      +                      "type": "string"
      +                    },
      +                    "type": {
      +                      "const": "agents",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "type",
      +                    "searchId",
      +                    "agents",
      +                    "role"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "reason": {
      +                      "enum": [
      +                        "approval",
      +                        "connection",
      +                        "unavailable",
      +                        "limit",
      +                        "user_control",
      +                        "input"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "text": {
      +                      "type": "string"
      +                    },
      +                    "threadId": {
      +                      "type": "string"
      +                    },
      +                    "type": {
      +                      "const": "checkpoint",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "type",
      +                    "reason",
      +                    "text"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "presentation": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "budget": {
      +                          "anyOf": [
      +                            {
      +                              "maxLength": 500,
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "null"
      +                            }
      +                          ]
      +                        },
      +                        "outcome": {
      +                          "maxLength": 1200,
      +                          "minLength": 1,
      +                          "type": "string"
      +                        },
      +                        "steps": {
      +                          "items": {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "alternativeOperationIds": {
      +                                "items": {
      +                                  "type": "string"
      +                                },
      +                                "maxItems": 5,
      +                                "type": "array"
      +                              },
      +                              "description": {
      +                                "maxLength": 1200,
      +                                "minLength": 1,
      +                                "type": "string"
      +                              },
      +                              "operationIds": {
      +                                "items": {
      +                                  "type": "string"
      +                                },
      +                                "maxItems": 5,
      +                                "type": "array"
      +                              },
      +                              "title": {
      +                                "maxLength": 160,
      +                                "minLength": 1,
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "title",
      +                              "description",
      +                              "operationIds"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          "maxItems": 8,
      +                          "minItems": 1,
      +                          "type": "array"
      +                        },
      +                        "timeline": {
      +                          "anyOf": [
      +                            {
      +                              "maxLength": 500,
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "null"
      +                            }
      +                          ]
      +                        }
      +                      },
      +                      "required": [
      +                        "outcome",
      +                        "timeline",
      +                        "budget",
      +                        "steps"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "steps": {
      +                      "items": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "agentId": {
      +                            "maxLength": 200,
      +                            "minLength": 1,
      +                            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +                            "type": "string"
      +                          },
      +                          "dependsOn": {
      +                            "items": {
      +                              "maxLength": 200,
      +                              "minLength": 1,
      +                              "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +                              "type": "string"
      +                            },
      +                            "type": "array"
      +                          },
      +                          "objective": {
      +                            "type": "string"
      +                          },
      +                          "stepId": {
      +                            "maxLength": 200,
      +                            "minLength": 1,
      +                            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "stepId",
      +                          "objective",
      +                          "agentId",
      +                          "dependsOn"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "maxItems": 8,
      +                      "type": "array"
      +                    },
      +                    "type": {
      +                      "const": "plan",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "type",
      +                    "steps"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "actRequestId": {
      +                      "maxLength": 200,
      +                      "minLength": 1,
      +                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +                      "type": "string"
      +                    },
      +                    "actingAiId": {
      +                      "maxLength": 200,
      +                      "minLength": 1,
      +                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +                      "type": "string"
      +                    },
      +                    "agentId": {
      +                      "maxLength": 200,
      +                      "minLength": 1,
      +                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +                      "type": "string"
      +                    },
      +                    "control": {
      +                      "enum": [
      +                        "user",
      +                        "coordinator"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "operationId": {
      +                      "maxLength": 200,
      +                      "minLength": 1,
      +                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +                      "type": "string"
      +                    },
      +                    "status": {
      +                      "const": "thread_created",
      +                      "type": "string"
      +                    },
      +                    "threadId": {
      +                      "maxLength": 200,
      +                      "minLength": 1,
      +                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +                      "type": "string"
      +                    },
      +                    "type": {
      +                      "const": "handoff",
      +                      "type": "string"
      +                    },
      +                    "url": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "type",
      +                    "agentId",
      +                    "threadId"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "messageIds": {
      +                      "items": {
      +                        "maxLength": 200,
      +                        "minLength": 1,
      +                        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "partial": {
      +                      "type": "boolean"
      +                    },
      +                    "text": {
      +                      "type": "string"
      +                    },
      +                    "type": {
      +                      "const": "outcome",
      +                      "type": "string"
      +                    },
      +                    "verification": {
      +                      "enum": [
      +                        "provider_reported",
      +                        "criteria_checked"
      +                      ],
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "type",
      +                    "text",
      +                    "messageIds",
      +                    "verification",
      +                    "partial"
      +                  ],
      +                  "type": "object"
      +                }
      +              ]
      +            },
      +            "type": "array"
      +          },
      +          "clientMessageId": {
      +            "maxLength": 200,
      +            "minLength": 1,
      +            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +            "type": "string"
      +          },
      +          "contextSummary": {
      +            "items": {
      +              "maxLength": 8000,
      +              "type": "string"
      +            },
      +            "maxItems": 10,
      +            "type": "array"
      +          },
      +          "createdAt": {
      +            "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"
      +          },
      +          "message": {
      +            "type": "string"
      +          },
      +          "searchResult": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "contractVersion": {
      +                "const": "search-v3.0",
      +                "type": "string"
      +              },
      +              "previousResponseId": {
      +                "anyOf": [
      +                  {
      +                    "pattern": "^sresp_[a-f0-9-]{36}$",
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "response": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "agents": {
      +                    "items": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "agentId": {
      +                          "maxLength": 200,
      +                          "minLength": 1,
      +                          "type": "string"
      +                        },
      +                        "agentSlug": {
      +                          "anyOf": [
      +                            {
      +                              "maxLength": 200,
      +                              "minLength": 1,
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "null"
      +                            }
      +                          ]
      +                        },
      +                        "avatarUrl": {
      +                          "anyOf": [
      +                            {
      +                              "format": "uri",
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "null"
      +                            }
      +                          ]
      +                        },
      +                        "canAttemptThread": {
      +                          "type": "boolean"
      +                        },
      +                        "canStartThread": {
      +                          "type": "boolean"
      +                        },
      +                        "connectionMethods": {
      +                          "default": [],
      +                          "items": {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "documentationUrl": {
      +                                "format": "uri",
      +                                "type": "string"
      +                              },
      +                              "endpointStatus": {
      +                                "enum": [
      +                                  "not_published",
      +                                  "verified"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              "endpointUrl": {
      +                                "anyOf": [
      +                                  {
      +                                    "format": "uri",
      +                                    "type": "string"
      +                                  },
      +                                  {
      +                                    "type": "null"
      +                                  }
      +                                ]
      +                              },
      +                              "environment": {
      +                                "enum": [
      +                                  "remote_client",
      +                                  "browser_session"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              "protocol": {
      +                                "enum": [
      +                                  "MCP",
      +                                  "A2A",
      +                                  "WEBMCP"
      +                                ],
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "protocol",
      +                              "environment",
      +                              "endpointUrl",
      +                              "endpointStatus",
      +                              "documentationUrl"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          "maxItems": 3,
      +                          "type": "array"
      +                        },
      +                        "connectionPrompt": {
      +                          "maxLength": 60000,
      +                          "minLength": 1,
      +                          "type": "string"
      +                        },
      +                        "description": {
      +                          "anyOf": [
      +                            {
      +                              "maxLength": 8000,
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "null"
      +                            }
      +                          ]
      +                        },
      +                        "executionGuidance": {
      +                          "anyOf": [
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "credentialSummary": {
      +                                  "maxLength": 1000,
      +                                  "minLength": 1,
      +                                  "type": "string"
      +                                },
      +                                "credentialSummaryCode": {
      +                                  "maxLength": 200,
      +                                  "minLength": 1,
      +                                  "type": "string"
      +                                },
      +                                "primaryBlockerCode": {
      +                                  "anyOf": [
      +                                    {
      +                                      "enum": [
      +                                        "PROVIDER_ROUTE_UNSUPPORTED",
      +                                        "PROVIDER_SCHEMA_MISSING",
      +                                        "PROVIDER_AUTH_SCHEME_UNSPECIFIED",
      +                                        "PROVIDER_METADATA_INCOMPLETE",
      +                                        "DARWIN_ADAPTER_UNAVAILABLE",
      +                                        "DARWIN_ROUTE_NOT_APPROVED",
      +                                        "DARWIN_LOCAL_RUNTIME_UNAVAILABLE",
      +                                        "DARWIN_BROWSER_RUNTIME_UNAVAILABLE",
      +                                        "DARWIN_PAYMENT_RUNTIME_UNAVAILABLE"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    {
      +                                      "type": "null"
      +                                    }
      +                                  ]
      +                                },
      +                                "recordBlockers": {
      +                                  "items": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "code": {
      +                                        "enum": [
      +                                          "PROVIDER_ROUTE_UNSUPPORTED",
      +                                          "PROVIDER_SCHEMA_MISSING",
      +                                          "PROVIDER_AUTH_SCHEME_UNSPECIFIED",
      +                                          "PROVIDER_METADATA_INCOMPLETE",
      +                                          "DARWIN_ADAPTER_UNAVAILABLE",
      +                                          "DARWIN_ROUTE_NOT_APPROVED",
      +                                          "DARWIN_LOCAL_RUNTIME_UNAVAILABLE",
      +                                          "DARWIN_BROWSER_RUNTIME_UNAVAILABLE",
      +                                          "DARWIN_PAYMENT_RUNTIME_UNAVAILABLE"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      "owner": {
      +                                        "enum": [
      +                                          "PROVIDER",
      +                                          "DARWIN"
      +                                        ],
      +                                        "type": "string"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "code",
      +                                      "owner"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "maxItems": 20,
      +                                  "type": "array"
      +                                },
      +                                "rendererVersion": {
      +                                  "const": "execution-guidance-v1",
      +                                  "type": "string"
      +                                },
      +                                "setupSummary": {
      +                                  "maxLength": 1000,
      +                                  "minLength": 1,
      +                                  "type": "string"
      +                                },
      +                                "setupSummaryCode": {
      +                                  "maxLength": 200,
      +                                  "minLength": 1,
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "credentialSummaryCode",
      +                                "credentialSummary",
      +                                "setupSummaryCode",
      +                                "setupSummary",
      +                                "recordBlockers",
      +                                "primaryBlockerCode",
      +                                "rendererVersion"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "type": "null"
      +                            }
      +                          ],
      +                          "default": null
      +                        },
      +                        "executionRequirements": {
      +                          "anyOf": [
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "browser": {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "sessionKind": {
      +                                      "anyOf": [
      +                                        {
      +                                          "enum": [
      +                                            "ANONYMOUS",
      +                                            "PROVIDER_SESSION",
      +                                            "UNKNOWN"
      +                                          ],
      +                                          "type": "string"
      +                                        },
      +                                        {
      +                                          "type": "null"
      +                                        }
      +                                      ]
      +                                    },
      +                                    "state": {
      +                                      "enum": [
      +                                        "REQUIRED",
      +                                        "NOT_REQUIRED",
      +                                        "UNKNOWN",
      +                                        "NOT_APPLICABLE"
      +                                      ],
      +                                      "type": "string"
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "state",
      +                                    "sessionKind"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                "contractVersion": {
      +                                  "const": "1.0.0",
      +                                  "type": "string"
      +                                },
      +                                "derivation": {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "completeness": {
      +                                      "enum": [
      +                                        "COMPLETE",
      +                                        "PARTIAL"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "derivationKey": {
      +                                      "pattern": "^sha256:[a-f0-9]{64}$",
      +                                      "type": "string"
      +                                    },
      +                                    "normalizerVersion": {
      +                                      "const": "execution-requirements-v1",
      +                                      "type": "string"
      +                                    },
      +                                    "sourceReceiptDigest": {
      +                                      "anyOf": [
      +                                        {
      +                                          "maxLength": 200,
      +                                          "type": "string"
      +                                        },
      +                                        {
      +                                          "type": "null"
      +                                        }
      +                                      ]
      +                                    },
      +                                    "sourceRevision": {
      +                                      "maxLength": 240,
      +                                      "minLength": 1,
      +                                      "type": "string"
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "normalizerVersion",
      +                                    "sourceRevision",
      +                                    "sourceReceiptDigest",
      +                                    "completeness",
      +                                    "derivationKey"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                "operationCredentials": {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "sensitiveInputNames": {
      +                                      "items": {
      +                                        "maxLength": 200,
      +                                        "minLength": 1,
      +                                        "type": "string"
      +                                      },
      +                                      "maxItems": 100,
      +                                      "type": "array"
      +                                    },
      +                                    "state": {
      +                                      "enum": [
      +                                        "REQUIRED",
      +                                        "NOT_REQUIRED",
      +                                        "UNKNOWN",
      +                                        "NOT_APPLICABLE"
      +                                      ],
      +                                      "type": "string"
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "state",
      +                                    "sensitiveInputNames"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                "payment": {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "state": {
      +                                      "enum": [
      +                                        "REQUIRED",
      +                                        "NOT_REQUIRED",
      +                                        "UNKNOWN",
      +                                        "NOT_APPLICABLE"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "termsDigest": {
      +                                      "anyOf": [
      +                                        {
      +                                          "maxLength": 200,
      +                                          "type": "string"
      +                                        },
      +                                        {
      +                                          "type": "null"
      +                                        }
      +                                      ]
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "state",
      +                                    "termsDigest"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                "providerAuthentication": {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "evidence": {
      +                                      "enum": [
      +                                        "PROVIDER_DECLARED",
      +                                        "PROVIDER_OBSERVED",
      +                                        "DERIVED_FROM_VERIFIED_RECEIPT",
      +                                        "UNKNOWN"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "mechanisms": {
      +                                      "items": {
      +                                        "enum": [
      +                                          "BEARER",
      +                                          "API_KEY",
      +                                          "OAUTH2",
      +                                          "HTTP_BASIC",
      +                                          "MUTUAL_TLS",
      +                                          "SIGNED_REQUEST",
      +                                          "SESSION_COOKIE",
      +                                          "OPERATION_SECRET_INPUT",
      +                                          "UNSPECIFIED"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      "maxItems": 20,
      +                                      "type": "array"
      +                                    },
      +                                    "placements": {
      +                                      "items": {
      +                                        "enum": [
      +                                          "HEADER",
      +                                          "QUERY",
      +                                          "COOKIE",
      +                                          "BODY",
      +                                          "TOOL_ARGUMENT",
      +                                          "ENVIRONMENT",
      +                                          "AUTH_CONTINUATION"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      "maxItems": 20,
      +                                      "type": "array"
      +                                    },
      +                                    "scopes": {
      +                                      "items": {
      +                                        "maxLength": 200,
      +                                        "minLength": 1,
      +                                        "type": "string"
      +                                      },
      +                                      "maxItems": 100,
      +                                      "type": "array"
      +                                    },
      +                                    "state": {
      +                                      "enum": [
      +                                        "REQUIRED",
      +                                        "NOT_REQUIRED",
      +                                        "UNKNOWN",
      +                                        "NOT_APPLICABLE"
      +                                      ],
      +                                      "type": "string"
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "state",
      +                                    "mechanisms",
      +                                    "placements",
      +                                    "scopes",
      +                                    "evidence"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                "providerBlockers": {
      +                                  "items": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "code": {
      +                                        "enum": [
      +                                          "PROVIDER_ROUTE_UNSUPPORTED",
      +                                          "PROVIDER_SCHEMA_MISSING",
      +                                          "PROVIDER_AUTH_SCHEME_UNSPECIFIED",
      +                                          "PROVIDER_METADATA_INCOMPLETE",
      +                                          "DARWIN_ADAPTER_UNAVAILABLE",
      +                                          "DARWIN_ROUTE_NOT_APPROVED",
      +                                          "DARWIN_LOCAL_RUNTIME_UNAVAILABLE",
      +                                          "DARWIN_BROWSER_RUNTIME_UNAVAILABLE",
      +                                          "DARWIN_PAYMENT_RUNTIME_UNAVAILABLE"
      +                                        ],
      +                                        "type": "string"
      +                                      },
      +                                      "owner": {
      +                                        "enum": [
      +                                          "PROVIDER",
      +                                          "DARWIN"
      +                                        ],
      +                                        "type": "string"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "code",
      +                                      "owner"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "maxItems": 20,
      +                                  "type": "array"
      +                                },
      +                                "providerContract": {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "inputSchema": {
      +                                      "enum": [
      +                                        "CONCRETE",
      +                                        "DIGEST_ONLY",
      +                                        "MISSING",
      +                                        "UNKNOWN"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "outputSchema": {
      +                                      "enum": [
      +                                        "CONCRETE",
      +                                        "DIGEST_ONLY",
      +                                        "MISSING",
      +                                        "UNKNOWN"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "route": {
      +                                      "enum": [
      +                                        "RESOLVED",
      +                                        "MISSING",
      +                                        "AMBIGUOUS",
      +                                        "UNSAFE",
      +                                        "UNSUPPORTED",
      +                                        "UNKNOWN"
      +                                      ],
      +                                      "type": "string"
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "route",
      +                                    "inputSchema",
      +                                    "outputSchema"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                "runtime": {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "kind": {
      +                                      "enum": [
      +                                        "REMOTE_MCP",
      +                                        "LOCAL_STDIO",
      +                                        "A2A_JSONRPC",
      +                                        "HTTP_JSON",
      +                                        "OPENAPI_HTTP",
      +                                        "BOUNDED_FETCH",
      +                                        "BROWSER",
      +                                        "X402_PAYMENT",
      +                                        "COMMERCE",
      +                                        "UNSUPPORTED"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "package": {
      +                                      "anyOf": [
      +                                        {
      +                                          "additionalProperties": false,
      +                                          "properties": {
      +                                            "ecosystem": {
      +                                              "maxLength": 40,
      +                                              "minLength": 1,
      +                                              "type": "string"
      +                                            },
      +                                            "identifier": {
      +                                              "maxLength": 500,
      +                                              "minLength": 1,
      +                                              "type": "string"
      +                                            },
      +                                            "runtimeProfile": {
      +                                              "maxLength": 120,
      +                                              "minLength": 1,
      +                                              "type": "string"
      +                                            },
      +                                            "version": {
      +                                              "maxLength": 200,
      +                                              "minLength": 1,
      +                                              "type": "string"
      +                                            }
      +                                          },
      +                                          "required": [
      +                                            "ecosystem",
      +                                            "identifier",
      +                                            "version",
      +                                            "runtimeProfile"
      +                                          ],
      +                                          "type": "object"
      +                                        },
      +                                        {
      +                                          "type": "null"
      +                                        }
      +                                      ]
      +                                    },
      +                                    "requiredEnvironmentNames": {
      +                                      "items": {
      +                                        "maxLength": 200,
      +                                        "minLength": 1,
      +                                        "type": "string"
      +                                      },
      +                                      "maxItems": 100,
      +                                      "type": "array"
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "kind",
      +                                    "package",
      +                                    "requiredEnvironmentNames"
      +                                  ],
      +                                  "type": "object"
      +                                }
      +                              },
      +                              "required": [
      +                                "contractVersion",
      +                                "providerAuthentication",
      +                                "operationCredentials",
      +                                "runtime",
      +                                "payment",
      +                                "browser",
      +                                "providerContract",
      +                                "providerBlockers",
      +                                "derivation"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "type": "null"
      +                            }
      +                          ],
      +                          "default": null
      +                        },
      +                        "imageUrl": {
      +                          "anyOf": [
      +                            {
      +                              "format": "uri",
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "null"
      +                            }
      +                          ]
      +                        },
      +                        "inquiry": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "description": {
      +                              "maxLength": 1200,
      +                              "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"
      +                            },
      +                            "fit": {
      +                              "enum": [
      +                                "matches",
      +                                "partial",
      +                                "not_fit",
      +                                "unknown"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            "question": {
      +                              "maxLength": 2000,
      +                              "minLength": 1,
      +                              "type": "string"
      +                            },
      +                            "reason": {
      +                              "maxLength": 250,
      +                              "type": "string"
      +                            },
      +                            "replies": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "at": {
      +                                    "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"
      +                                  },
      +                                  "messageId": {
      +                                    "maxLength": 200,
      +                                    "minLength": 1,
      +                                    "type": "string"
      +                                  },
      +                                  "text": {
      +                                    "maxLength": 8000,
      +                                    "minLength": 1,
      +                                    "type": "string"
      +                                  }
      +                                },
      +                                "required": [
      +                                  "messageId",
      +                                  "text",
      +                                  "at"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "maxItems": 4,
      +                              "type": "array"
      +                            },
      +                            "status": {
      +                              "enum": [
      +                                "contacting",
      +                                "waiting",
      +                                "following_up",
      +                                "replied",
      +                                "needs_input",
      +                                "no_reply",
      +                                "not_contacted",
      +                                "outcome_unknown"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            "threadId": {
      +                              "maxLength": 200,
      +                              "minLength": 1,
      +                              "type": "string"
      +                            }
      +                          },
      +                          "required": [
      +                            "status",
      +                            "question",
      +                            "replies"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "name": {
      +                          "maxLength": 500,
      +                          "minLength": 1,
      +                          "type": "string"
      +                        },
      +                        "operationId": {
      +                          "maxLength": 200,
      +                          "minLength": 1,
      +                          "type": "string"
      +                        },
      +                        "operationRevision": {
      +                          "exclusiveMinimum": 0,
      +                          "maximum": 9007199254740991,
      +                          "type": "integer"
      +                        },
      +                        "providerCheck": {
      +                          "enum": [
      +                            "not_attempted",
      +                            "confirmed",
      +                            "unconfirmed",
      +                            "unavailable"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "providerFamilyRef": {
      +                          "anyOf": [
      +                            {
      +                              "pattern": "^provider-family:sha256:[a-f0-9]{64}$",
      +                              "type": "string"
      +                            },
      +                            {
      +                              "type": "null"
      +                            }
      +                          ],
      +                          "default": null
      +                        },
      +                        "rank": {
      +                          "exclusiveMinimum": 0,
      +                          "maximum": 9007199254740991,
      +                          "type": "integer"
      +                        },
      +                        "readiness": {
      +                          "enum": [
      +                            "ready",
      +                            "authentication_required",
      +                            "recheck_required",
      +                            "unavailable"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "reasons": {
      +                          "items": {
      +                            "maxLength": 250,
      +                            "type": "string"
      +                          },
      +                          "maxItems": 3,
      +                          "type": "array"
      +                        },
      +                        "requiredSetup": {
      +                          "anyOf": [
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "description": {
      +                                  "maxLength": 500,
      +                                  "minLength": 1,
      +                                  "type": "string"
      +                                },
      +                                "kind": {
      +                                  "enum": [
      +                                    "credential",
      +                                    "installation",
      +                                    "provider_configuration"
      +                                  ],
      +                                  "type": "string"
      +                                },
      +                                "suppliedBy": {
      +                                  "enum": [
      +                                    "user",
      +                                    "provider",
      +                                    "runtime"
      +                                  ],
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "kind",
      +                                "suppliedBy",
      +                                "description"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "type": "null"
      +                            }
      +                          ],
      +                          "default": null
      +                        },
      +                        "selected": {
      +                          "type": "boolean"
      +                        },
      +                        "uncertainties": {
      +                          "items": {
      +                            "maxLength": 250,
      +                            "type": "string"
      +                          },
      +                          "maxItems": 3,
      +                          "type": "array"
      +                        }
      +                      },
      +                      "required": [
      +                        "agentId",
      +                        "agentSlug",
      +                        "operationId",
      +                        "operationRevision",
      +                        "providerFamilyRef",
      +                        "rank",
      +                        "selected",
      +                        "name",
      +                        "description",
      +                        "requiredSetup",
      +                        "executionRequirements",
      +                        "executionGuidance",
      +                        "readiness",
      +                        "canStartThread",
      +                        "reasons",
      +                        "uncertainties",
      +                        "providerCheck",
      +                        "connectionMethods",
      +                        "connectionPrompt"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "maxItems": 20,
      +                    "type": "array"
      +                  },
      +                  "assessment": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "explanation": {
      +                        "maxLength": 2000,
      +                        "minLength": 1,
      +                        "type": "string"
      +                      },
      +                      "outcome": {
      +                        "enum": [
      +                          "strong",
      +                          "partial",
      +                          "clarify",
      +                          "no_match",
      +                          "unverified"
      +                        ],
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "outcome",
      +                      "explanation"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "noMatchReason": {
      +                    "anyOf": [
      +                      {
      +                        "maxLength": 500,
      +                        "minLength": 1,
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "overview": {
      +                    "anyOf": [
      +                      {
      +                        "maxLength": 32000,
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "plan": {
      +                    "anyOf": [
      +                      {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "steps": {
      +                            "items": {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "agentId": {
      +                                  "maxLength": 200,
      +                                  "minLength": 1,
      +                                  "type": "string"
      +                                },
      +                                "alternatives": {
      +                                  "items": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "agentId": {
      +                                        "maxLength": 200,
      +                                        "minLength": 1,
      +                                        "type": "string"
      +                                      },
      +                                      "operationId": {
      +                                        "maxLength": 200,
      +                                        "minLength": 1,
      +                                        "type": "string"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "agentId",
      +                                      "operationId"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "maxItems": 3,
      +                                  "type": "array"
      +                                },
      +                                "dependsOn": {
      +                                  "items": {
      +                                    "maxLength": 200,
      +                                    "minLength": 1,
      +                                    "type": "string"
      +                                  },
      +                                  "maxItems": 8,
      +                                  "type": "array"
      +                                },
      +                                "objective": {
      +                                  "maxLength": 250,
      +                                  "minLength": 1,
      +                                  "type": "string"
      +                                },
      +                                "operationId": {
      +                                  "maxLength": 200,
      +                                  "minLength": 1,
      +                                  "type": "string"
      +                                },
      +                                "stepId": {
      +                                  "maxLength": 200,
      +                                  "minLength": 1,
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "stepId",
      +                                "agentId",
      +                                "operationId",
      +                                "objective",
      +                                "dependsOn"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            "maxItems": 8,
      +                            "minItems": 1,
      +                            "type": "array"
      +                          }
      +                        },
      +                        "required": [
      +                          "steps"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "question": {
      +                    "anyOf": [
      +                      {
      +                        "maxLength": 500,
      +                        "minLength": 1,
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "relatedSearches": {
      +                    "default": [],
      +                    "items": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "query": {
      +                          "maxLength": 200,
      +                          "minLength": 1,
      +                          "type": "string"
      +                        },
      +                        "reason": {
      +                          "maxLength": 250,
      +                          "minLength": 1,
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "query",
      +                        "reason"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "maxItems": 3,
      +                    "type": "array"
      +                  }
      +                },
      +                "required": [
      +                  "agents",
      +                  "relatedSearches",
      +                  "question",
      +                  "noMatchReason"
      +                ],
      +                "type": "object"
      +              },
      +              "responseId": {
      +                "pattern": "^sresp_[a-f0-9-]{36}$",
      +                "type": "string"
      +              },
      +              "searchId": {
      +                "pattern": "^srch_[a-f0-9-]{36}$",
      +                "type": "string"
      +              },
      +              "searchToken": {
      +                "type": "string"
      +              },
      +              "status": {
      +                "enum": [
      +                  "completed",
      +                  "needs_input",
      +                  "no_match"
      +                ],
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "searchId",
      +              "responseId",
      +              "previousResponseId",
      +              "contractVersion",
      +              "status",
      +              "response"
      +            ],
      +            "type": "object"
      +          },
      +          "status": {
      +            "enum": [
      +              "queued",
      +              "running",
      +              "waiting",
      +              "completed",
      +              "failed",
      +              "cancelled"
      +            ],
      +            "type": "string"
      +          },
      +          "turnId": {
      +            "maxLength": 200,
      +            "minLength": 1,
      +            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
      +            "type": "string"
      +          },
      +          "updatedAt": {
      +            "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"
      +          }
      +        },
      +        "required": [
      +          "turnId",
      +          "clientMessageId",
      +          "message",
      +          "status",
      +          "blocks",
      +          "createdAt",
      +          "updatedAt"
      +        ],
      +        "type": "object"
      +      },
      +      "maxItems": 50,
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "turns",
      +    "nextBefore",
      +    "eventCursor"
      +  ],
      +  "type": "object"
      +}
  2. Changed1 schema field changed
    • addedInput schema / properties / assistId / description
      Added value: +"Exact assistId returned by Assist for the request to read."
  3. Added

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, yet the description adds real context the agent cannot get elsewhere: the feature is release-gated and may be unavailable, and a returned plan must not be treated as evidence of execution. Guest/private continuation access is left entirely to the schema.

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?

The core action and scope lead, and the two caveats are compressed into single clauses with no filler. The final fragment is terse to the point of being aphoristic, but it does carry a distinct warning rather than repeating structured data.

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 cover the safety profile; the description fills the remaining gaps on availability and result interpretation. Minor omission: it never says what 'revisions', 'quote' or 'run evidence' are in relation to the request or how they are returned.

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% and all three parameters carry their own explanatory text, including the nextBefore pagination hint, so the schema does the heavy lifting. The description adds no parameter-level meaning beyond what the schema already states, making the baseline 3 correct.

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

Purpose4/5

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

States a specific verb ('Read') and a well-scoped resource ('caller-owned Assist request, revisions, quote and run evidence'), so an agent knows exactly what comes back. It does not explicitly differentiate itself from near neighbors like get_act_request or get_thread, which keeps it short of a 5.

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

Usage Guidelines2/5

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

There is no statement of when to call this versus get_act_request, get_thread, or list_act_history; the only usage-like signal is the implicit need for an assistId. The caveat 'A plan is not proof of execution' hints at how to interpret results but gives no routing guidance.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources