Title51/100
Darwin
Name the specific action and subject instead of using a generic label such as ‘manage’ or ‘tool’.
Description87/100
Find agents for a task. Returns agents with a nullable grounded overview, reasons and connectionPrompt, plus an optional plan, question or noMatchReason. Refine using previousResponseId and context. Retain searchToken for anonymous follow-ups and Search-to-Act handoff. Search never executes work.
The description explains the capability, when to use it, and what to expect.
Inputs8/100
2 of 19 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
query
Not provided
Missing description. Explain what this value means and how to supply it.
previousResponseId
Not provided
Missing description. Explain what this value means and how to supply it.
forkSearchId
Copy a public Search conversation into a new owned search before refining it.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
agentCount
Not provided
Missing description. Explain what this value means and how to supply it.
maxResults
Not provided
Missing description. Explain what this value means and how to supply it.
budgetUsd
Maximum total task budget in US dollars, with at most two decimal places. This guides Search matching; it is not an API usage limit, provider price guarantee, or permission to spend.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
context › items › oneOf › 0 › type
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 0 › name
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 0 › mimeType
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 0 › data
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 1 › type
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 1 › text
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 2 › type
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 2 › amountMinor
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 2 › currency
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 3 › type
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 3 › at
Not provided
Missing description. Explain what this value means and how to supply it.
context › items › oneOf › 4 › type
Not provided
Missing description. Explain what this value means and how to supply it.
searchToken
Not provided
Missing description. Explain what this value means and how to supply it.
Annotations100/100
All four behavior hints are declared.
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}Output schema79/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"searchId",
"responseId",
"previousResponseId",
"contractVersion",
"status",
"response"
],
"properties": {
"status": {
"enum": [
"completed",
"needs_input",
"no_match"
],
"type": "string"
},
"response": {
"type": "object",
"required": [
"agents",
"relatedSearches",
"plan",
"question",
"noMatchReason"
],
"properties": {
"plan": {
"anyOf": [
{
"type": "object",
"required": [
"steps"
],
"properties": {
"steps": {
"type": "array",
"items": {
"type": "object",
"required": [
"stepId",
"agentId",
"capabilityId",
"objective",
"dependsOn"
],
"properties": {
"stepId": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"agentId": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"dependsOn": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 8
},
"objective": {
"type": "string",
"maxLength": 250,
"minLength": 1
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"required": [
"agentId",
"capabilityId"
],
"properties": {
"agentId": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"capabilityId": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 3
},
"capabilityId": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"agents": {
"type": "array",
"items": {
"type": "object",
"required": [
"agentId",
"agentSlug",
"capabilityId",
"capabilityRevision",
"rank",
"selected",
"name",
"description",
"requiredSetup",
"executionRequirements",
"executionGuidance",
"readiness",
"canStartThread",
"reasons",
"uncertainties",
"providerCheck",
"connectionMethods",
"connectionPrompt"
],
"properties": {
"name": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"rank": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"agentId": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"inquiry": {
"type": "object",
"required": [
"status",
"question",
"replies"
],
"properties": {
"fit": {
"enum": [
"matches",
"partial",
"not_fit",
"unknown"
],
"type": "string"
},
"reason": {
"type": "string",
"maxLength": 250
},
"status": {
"enum": [
"contacting",
"waiting",
"following_up",
"replied",
"needs_input",
"no_reply",
"not_contacted",
"outcome_unknown"
],
"type": "string"
},
"replies": {
"type": "array",
"items": {
"type": "object",
"required": [
"messageId",
"text",
"at"
],
"properties": {
"at": {
"type": "string",
"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))$"
},
"text": {
"type": "string",
"maxLength": 8000,
"minLength": 1
},
"messageId": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 4
},
"question": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"threadId": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"expiresAt": {
"type": "string",
"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))$"
},
"description": {
"type": "string",
"maxLength": 1200
}
},
"additionalProperties": false
},
"reasons": {
"type": "array",
"items": {
"type": "string",
"maxLength": 250
},
"maxItems": 3
},
"imageUrl": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"selected": {
"type": "boolean"
},
"agentSlug": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "null"
}
]
},
"readiness": {
"enum": [
"ready",
"authentication_required",
"recheck_required",
"unavailable"
],
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string",
"maxLength": 8000
},
{
"type": "null"
}
]
},
"capabilityId": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"providerCheck": {
"enum": [
"not_attempted",
"confirmed",
"unconfirmed",
"unavailable"
],
"type": "string"
},
"requiredSetup": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"suppliedBy",
"description"
],
"properties": {
"kind": {
"enum": [
"credential",
"installation",
"provider_configuration"
],
"type": "string"
},
"suppliedBy": {
"enum": [
"user",
"provider",
"runtime"
],
"type": "string"
},
"description": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"uncertainties": {
"type": "array",
"items": {
"type": "string",
"maxLength": 250
},
"maxItems": 3
},
"canStartThread": {
"type": "boolean"
},
"canAttemptThread": {
"type": "boolean"
},
"connectionPrompt": {
"type": "string",
"maxLength": 60000,
"minLength": 1
},
"connectionMethods": {
"type": "array",
"items": {
"type": "object",
"required": [
"protocol",
"environment",
"endpointUrl",
"endpointStatus",
"documentationUrl"
],
"properties": {
"protocol": {
"enum": [
"MCP",
"A2A",
"WEBMCP"
],
"type": "string"
},
"endpointUrl": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"environment": {
"enum": [
"remote_client",
"browser_session"
],
"type": "string"
},
"endpointStatus": {
"enum": [
"not_published",
"verified"
],
"type": "string"
},
"documentationUrl": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 3
},
"executionGuidance": {
"anyOf": [
{
"type": "object",
"required": [
"credentialSummaryCode",
"credentialSummary",
"setupSummaryCode",
"setupSummary",
"recordBlockers",
"primaryBlockerCode",
"rendererVersion"
],
"properties": {
"setupSummary": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"recordBlockers": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"owner"
],
"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"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"rendererVersion": {
"type": "string",
"const": "execution-guidance-v1"
},
"setupSummaryCode": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"credentialSummary": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"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"
}
]
},
"credentialSummaryCode": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"capabilityRevision": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"executionRequirements": {
"anyOf": [
{
"type": "object",
"required": [
"contractVersion",
"providerAuthentication",
"operationCredentials",
"runtime",
"payment",
"browser",
"providerContract",
"providerBlockers",
"derivation"
],
"properties": {
"browser": {
"type": "object",
"required": [
"state",
"sessionKind"
],
"properties": {
"state": {
"enum": [
"REQUIRED",
"NOT_REQUIRED",
"UNKNOWN",
"NOT_APPLICABLE"
],
"type": "string"
},
"sessionKind": {
"anyOf": [
{
"enum": [
"ANONYMOUS",
"PROVIDER_SESSION",
"UNKNOWN"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"payment": {
"type": "object",
"required": [
"state",
"termsDigest"
],
"properties": {
"state": {
"enum": [
"REQUIRED",
"NOT_REQUIRED",
"UNKNOWN",
"NOT_APPLICABLE"
],
"type": "string"
},
"termsDigest": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"runtime": {
"type": "object",
"required": [
"kind",
"package",
"requiredEnvironmentNames"
],
"properties": {
"kind": {
"enum": [
"REMOTE_MCP",
"LOCAL_STDIO",
"A2A_JSONRPC",
"HTTP_JSON",
"OPENAPI_HTTP",
"BOUNDED_FETCH",
"BROWSER",
"X402_PAYMENT",
"COMMERCE",
"UNSUPPORTED"
],
"type": "string"
},
"package": {
"anyOf": [
{
"type": "object",
"required": [
"ecosystem",
"identifier",
"version",
"runtimeProfile"
],
"properties": {
"version": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"ecosystem": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"identifier": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"runtimeProfile": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"requiredEnvironmentNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 100
}
},
"additionalProperties": false
},
"derivation": {
"type": "object",
"required": [
"normalizerVersion",
"sourceRevision",
"sourceReceiptDigest",
"completeness",
"derivationKey"
],
"properties": {
"completeness": {
"enum": [
"COMPLETE",
"PARTIAL"
],
"type": "string"
},
"derivationKey": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"sourceRevision": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"normalizerVersion": {
"type": "string",
"const": "execution-requirements-v1"
},
"sourceReceiptDigest": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"contractVersion": {
"type": "string",
"const": "1.0.0"
},
"providerBlockers": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"owner"
],
"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"
}
},
"additionalProperties": false
},
"maxItems": 20
},
"providerContract": {
"type": "object",
"required": [
"route",
"inputSchema",
"outputSchema"
],
"properties": {
"route": {
"enum": [
"RESOLVED",
"MISSING",
"AMBIGUOUS",
"UNSAFE",
"UNSUPPORTED",
"UNKNOWN"
],
"type": "string"
},
"inputSchema": {
"enum": [
"CONCRETE",
"DIGEST_ONLY",
"MISSING",
"UNKNOWN"
],
"type": "string"
},
"outputSchema": {
"enum": [
"CONCRETE",
"DIGEST_ONLY",
"MISSING",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"operationCredentials": {
"type": "object",
"required": [
"state",
"sensitiveInputNames"
],
"properties": {
"state": {
"enum": [
"REQUIRED",
"NOT_REQUIRED",
"UNKNOWN",
"NOT_APPLICABLE"
],
"type": "string"
},
"sensitiveInputNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 100
}
},
"additionalProperties": false
},
"providerAuthentication": {
"type": "object",
"required": [
"state",
"mechanisms",
"placements",
"scopes",
"evidence"
],
"properties": {
"state": {
"enum": [
"REQUIRED",
"NOT_REQUIRED",
"UNKNOWN",
"NOT_APPLICABLE"
],
"type": "string"
},
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 100
},
"evidence": {
"enum": [
"PROVIDER_DECLARED",
"PROVIDER_OBSERVED",
"DERIVED_FROM_VERIFIED_RECEIPT",
"UNKNOWN"
],
"type": "string"
},
"mechanisms": {
"type": "array",
"items": {
"enum": [
"BEARER",
"API_KEY",
"OAUTH2",
"HTTP_BASIC",
"MUTUAL_TLS",
"SIGNED_REQUEST",
"SESSION_COOKIE",
"OPERATION_SECRET_INPUT",
"UNSPECIFIED"
],
"type": "string"
},
"maxItems": 20
},
"placements": {
"type": "array",
"items": {
"enum": [
"HEADER",
"QUERY",
"COOKIE",
"BODY",
"TOOL_ARGUMENT",
"ENVIRONMENT",
"AUTH_CONTINUATION"
],
"type": "string"
},
"maxItems": 20
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
},
"maxItems": 20
},
"question": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"minLength": 1
},
{
"type": "null"
}
]
},
"assessment": {
"type": "object",
"required": [
"outcome",
"explanation"
],
"properties": {
"outcome": {
"enum": [
"strong",
"partial",
"clarify",
"no_match",
"unverified"
],
"type": "string"
},
"explanation": {
"type": "string",
"maxLength": 2000,
"minLength": 1
}
},
"additionalProperties": false
},
"noMatchReason": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"minLength": 1
},
{
"type": "null"
}
]
},
"relatedSearches": {
"type": "array",
"items": {
"type": "object",
"required": [
"query",
"reason"
],
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 250,
"minLength": 1
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 3
}
},
"additionalProperties": false
},
"searchId": {
"type": "string",
"pattern": "^srch_[a-f0-9-]{36}$"
},
"responseId": {
"type": "string",
"pattern": "^sresp_[a-f0-9-]{36}$"
},
"searchToken": {
"type": "string"
},
"contractVersion": {
"type": "string",
"const": "search-v3.0"
},
"previousResponseId": {
"anyOf": [
{
"type": "string",
"pattern": "^sresp_[a-f0-9-]{36}$"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}