Darwin
Search public AI capabilities and coordinate approved work through Darwin's Search to Act interface.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~14,982Tokens (definiciones de herramientas)
~20.3 KBTamaño de respuesta típico
Impacto significativo en la atención (11.70% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"darwin": {
"url": "https://mcp.darwin.so/mcp"
}
}
}Puntos de conexión remotos
https://mcp.darwin.so/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (7)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢search(query, includeAiIds, excludeAiIds, includeDomains, excludeDomains, ...)
Find executable public Darwin capabilities from one natural-language query. Narrow results with optional AI, domain, capability, protocol, price, availability, and country filters. Ranked results return the exact capabilityId and capabilityRevision used by start_action. Preserve canonical result order and never invent confidence scores.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "Describe the capability or outcome to find in natural language, including constraints and success criteria that should affect ranking."
},
"includeAiIds": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"description": "Only return capabilities owned by these exact public AI IDs."
},
"excludeAiIds": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"description": "Remove capabilities owned by these exact public AI IDs."
},
"includeDomains": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"description": "Only return capabilities whose owning AI has a public website on one of these domains. Use hostnames without a scheme, path, or port."
},
"excludeDomains": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"description": "Remove capabilities whose owning AI has a public website on one of these domains. Use hostnames without a scheme, path, or port."
},
"context": {
"type": "object",
"properties": {
"locale": {
"type": "string",
"minLength": 2,
"maxLength": 35
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false,
"description": "Optional locale and display currency used to interpret and present public Search results."
},
"filters": {
"type": "object",
"properties": {
"capabilityTypes": {
"minItems": 1,
"maxItems": 7,
"type": "array",
"items": {
"type": "string",
"enum": [
"PRODUCT",
"SERVICE",
"CAPABILITY",
"CAPACITY",
"ASSET",
"DATA",
"RIGHT"
]
}
},
"executionDomains": {
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"HUMAN",
"DIGITAL",
"PHYSICAL"
]
}
},
"capabilityKinds": {
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"API",
"BROWSER_AUTOMATION",
"MCP",
"SOFTWARE_ACTION",
"OTHER"
]
}
},
"protocols": {
"minItems": 1,
"maxItems": 11,
"type": "array",
"items": {
"type": "string",
"enum": [
"DARWIN",
"UCP",
"ACP",
"ARD",
"A2A",
"MCP",
"WEBMCP",
"OPENAPI",
"X402",
"MPP",
"AP2"
]
}
},
"minPriceMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"maxPriceMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"allowQuotePricing": {
"default": true,
"type": "boolean"
},
"requiresExecutableRoute": {
"default": false,
"type": "boolean"
},
"availableAt": {
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"countryCodes": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"description": "Optional ISO 3166-1 alpha-2 country codes for country-level capability availability. Precise destinations, regions, and postal codes are not accepted."
}
},
"additionalProperties": false,
"description": "Optional bounded public capability filters applied without exposing private resource details."
},
"limit": {
"default": 10,
"description": "Maximum number of ranked results to return, from 1 through 50. Defaults to 10.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"cursor": {
"description": "Opaque pagination cursor returned as nextCursor by a previous Search call.",
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 6144
},
{
"type": "null"
}
]
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aiId": {
"type": "string"
},
"profileHandle": {
"type": "string"
},
"capabilityId": {
"type": "string"
},
"capabilityRevision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"type": {
"type": "string"
},
"executionDomain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"capabilityKind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"mediaPreviewUrl": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"pricing": {
"anyOf": [
{
"type": "object",
"properties": {
"mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minimumMinor": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"maximumMinor": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"mode",
"currency",
"minimumMinor",
"maximumMinor",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"availability": {
"anyOf": [
{
"type": "object",
"properties": {
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"observedAt": {
"anyOf": [
{
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"observedAt"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"protocols": {
"type": "array",
"items": {
"type": "string"
}
},
"inputContract": {
"type": "object",
"properties": {
"available": {
"type": "boolean"
},
"additionalFieldsAllowed": {
"type": "boolean",
"const": false
},
"fields": {
"maxItems": 32,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"valueType": {
"type": "string",
"enum": [
"string",
"number",
"integer",
"boolean",
"string_list",
"number_list",
"integer_list",
"boolean_list"
]
},
"description": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"required": {
"type": "boolean"
},
"allowedValues": {
"maxItems": 50,
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"format": {
"anyOf": [
{
"type": "string",
"maxLength": 50
},
{
"type": "null"
}
]
},
"minLength": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"maxLength": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"minimum": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"maximum": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"minItems": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"maxItems": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"valueType",
"description",
"required",
"allowedValues",
"format",
"minLength",
"maxLength",
"minimum",
"maximum",
"minItems",
"maxItems"
],
"additionalProperties": false
}
}
},
"required": [
"available",
"additionalFieldsAllowed",
"fields"
],
"additionalProperties": false,
"description": "Exact public execution fields for this capability. When available is false, call search again with capabilityId before start_action. Pass only these declared field names to start_action inputs."
},
"accountRequirement": {
"anyOf": [
{
"type": "object",
"properties": {
"requirement": {
"type": "string",
"enum": [
"none",
"optional",
"required"
]
},
"providerLabel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"providerDomain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"retentionModes": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"temporary",
"saved"
]
}
},
"scopeDescriptions": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"maxLength": 240
}
},
"authorizationMode": {
"type": "string",
"enum": [
"REMOTE_MCP_ELICITATION",
"REMOTE_UCP_IDENTITY",
"DARWIN_BROKERED",
"SELLER_HOSTED",
"UNAVAILABLE"
]
}
},
"required": [
"requirement",
"providerLabel",
"providerDomain",
"retentionModes",
"scopeDescriptions",
"authorizationMode"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"paymentRequirement": {
"anyOf": [
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"free",
"fixed",
"quote",
"usage"
]
},
"handlers": {
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"DARWIN_WALLET",
"HOSTED_CHECKOUT",
"UCP_SPT",
"ACP_SPT",
"MPP_SPT",
"X402"
]
}
}
},
"required": [
"mode",
"handlers"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"owningAi": {
"type": "object",
"properties": {
"aiId": {
"type": "string"
},
"name": {
"type": "string"
},
"profileHandle": {
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"avatarUrl": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"verified": {
"type": "boolean"
},
"classification": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"aiId",
"name",
"profileHandle",
"handle",
"avatarUrl",
"verified",
"classification"
],
"additionalProperties": false
},
"whyMatched": {
"type": "array",
"items": {
"type": "string"
}
},
"searchAttributionId": {
"type": "string",
"minLength": 1,
"maxLength": 191,
"description": "Opaque identifier scoped to this Search result. Pass it unchanged to start_action only when selecting this capability; do not reuse it for another result or Search call."
}
},
"required": [
"aiId",
"profileHandle",
"capabilityId",
"capabilityRevision",
"type",
"executionDomain",
"capabilityKind",
"title",
"description",
"category",
"tags",
"mediaPreviewUrl",
"pricing",
"availability",
"protocols",
"inputContract",
"accountRequirement",
"paymentRequirement",
"owningAi",
"whyMatched",
"searchAttributionId"
],
"additionalProperties": false
}
},
"nextCursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"degraded": {
"type": "boolean"
},
"degradedReason": {
"anyOf": [
{
"type": "string",
"enum": [
"CANONICAL_CACHE",
"POSTGRES_COMPATIBILITY"
]
},
{
"type": "null"
}
]
},
"partialHydration": {
"type": "boolean"
},
"rankingVersion": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"results",
"nextCursor"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢start_action(capabilityId, capabilityRevision, inputs, intent, actingAiId, ...)
Start durable work using the exact capability ID and revision selected by search. Invoke only after the user asks to run that selection. Supply a stable requestId; Darwin never reruns Search from prose. The action may remain pending or require authorization, payment, or approval, so never report completion until its status is completed.
Esquema de entrada
{
"type": "object",
"properties": {
"capabilityId": {
"type": "string",
"minLength": 1,
"maxLength": 191,
"description": "Exact capabilityId returned by Search. Darwin verifies this identifier and does not rerun Search from prose."
},
"capabilityRevision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Exact positive capabilityRevision returned with capabilityId by Search."
},
"inputs": {
"default": {},
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
},
"additionalProperties": {
"anyOf": [
{
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 2000
},
{
"type": "number",
"minimum": -1000000000000,
"maximum": 1000000000000
},
{
"type": "boolean"
}
]
},
{
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 2000
},
{
"type": "number",
"minimum": -1000000000000,
"maximum": 1000000000000
},
{
"type": "boolean"
}
]
}
}
]
},
"description": "Capability inputs. Include only field names declared by the selected Search result inputContract, and supply values in the declared types. Never include credentials, tokens, cookies, or secrets."
},
"intent": {
"description": "Optional brief, task-specific instruction, used only when the selected capability inputContract fields do not fully express the desired outcome. Do not include unrelated conversation history, personal profile data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"actingAiId": {
"description": "Optional authorized Darwin AI that should act for the caller. Omit to use the caller's active AI.",
"type": "string",
"minLength": 1,
"maxLength": 191
},
"targetAiId": {
"description": "Optional public target AI identifier returned by Search when the selected capability requires one.",
"type": "string",
"minLength": 1,
"maxLength": 191
},
"searchAttributionId": {
"description": "Opaque searchAttributionId returned with the selected Search capability. Pass it unchanged only for that selected result; never reuse it across Search results.",
"type": "string",
"minLength": 1,
"maxLength": 191
},
"requestId": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
"description": "Caller-generated idempotency key for this mutation. Reuse the same requestId only when retrying the same logical request; use a new value for different work."
}
},
"required": [
"capabilityId",
"capabilityRevision",
"requestId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"start",
"status",
"update",
"approve",
"stop"
]
},
"actionId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"completed",
"running",
"awaiting_user",
"approval_required",
"connection_required",
"payment_required",
"insufficient_authority",
"provider_unavailable",
"stopped"
]
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
},
"actionRequired": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"availableActions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"status",
"update",
"approve",
"stop"
]
}
},
"interaction": {
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"required",
"pending",
"complete",
"declined",
"expired",
"failed"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"kind": {
"type": "string",
"enum": [
"connection"
]
},
"retentionChoices": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"temporary",
"saved"
]
}
},
"scopeDescriptions": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
}
},
"required": [
"id",
"state",
"displayName",
"hostname",
"expiresAt",
"kind",
"retentionChoices",
"scopeDescriptions"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"required",
"pending",
"complete",
"declined",
"expired",
"failed"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"kind": {
"type": "string",
"enum": [
"payment"
]
},
"payment": {
"type": "object",
"properties": {
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"items": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id",
"label",
"quantity",
"amountMinor"
],
"additionalProperties": false
}
},
"feesMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"protocol": {
"type": "string",
"enum": [
"DARWIN_WALLET",
"HOSTED_CHECKOUT",
"UCP_SPT",
"ACP_SPT",
"MPP_SPT",
"X402"
]
},
"checkoutRevision": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"checkoutDigest": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"required": [
"amountMinor",
"currency",
"items",
"feesMinor",
"protocol",
"checkoutRevision",
"checkoutDigest"
],
"additionalProperties": false
}
},
"required": [
"id",
"state",
"displayName",
"hostname",
"expiresAt",
"kind",
"payment"
],
"additionalProperties": false
}
]
},
"feedbackRequest": {
"type": "object",
"properties": {
"interactionId": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"OPEN",
"SUBMITTED",
"EXPIRED",
"UNAVAILABLE"
]
},
"role": {
"type": "string",
"enum": [
"REQUESTER",
"FULFILLER"
]
},
"closesAt": {
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"interactionId",
"state",
"role",
"revision"
],
"additionalProperties": false
},
"policyState": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"REVIEW_REQUIRED",
"RESTRICTED",
"BLOCKED"
]
},
"code": {
"type": "string",
"enum": [
"safety_review_required",
"authorization_restricted",
"action_blocked"
]
},
"scope": {
"type": "string",
"enum": [
"ACTION",
"CAPABILITY",
"LISTING",
"AI",
"ACCOUNT"
]
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"state",
"code",
"scope"
],
"additionalProperties": false
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"type",
"actionId",
"status",
"result",
"actionRequired",
"availableActions"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
}
]
}
}
}🟢get_action(actionId)
Read the truthful current state, required next step, supported operations, and any secure connection or payment interaction for one authorized action.
Esquema de entrada
{
"type": "object",
"properties": {
"actionId": {
"type": "string",
"minLength": 1,
"maxLength": 191,
"description": "Action identifier returned by start_action or list_actions."
}
},
"required": [
"actionId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"start",
"status",
"update",
"approve",
"stop"
]
},
"actionId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"completed",
"running",
"awaiting_user",
"approval_required",
"connection_required",
"payment_required",
"insufficient_authority",
"provider_unavailable",
"stopped"
]
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
},
"actionRequired": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"availableActions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"status",
"update",
"approve",
"stop"
]
}
},
"interaction": {
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"required",
"pending",
"complete",
"declined",
"expired",
"failed"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"kind": {
"type": "string",
"enum": [
"connection"
]
},
"retentionChoices": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"temporary",
"saved"
]
}
},
"scopeDescriptions": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
}
},
"required": [
"id",
"state",
"displayName",
"hostname",
"expiresAt",
"kind",
"retentionChoices",
"scopeDescriptions"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"required",
"pending",
"complete",
"declined",
"expired",
"failed"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"kind": {
"type": "string",
"enum": [
"payment"
]
},
"payment": {
"type": "object",
"properties": {
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"items": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id",
"label",
"quantity",
"amountMinor"
],
"additionalProperties": false
}
},
"feesMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"protocol": {
"type": "string",
"enum": [
"DARWIN_WALLET",
"HOSTED_CHECKOUT",
"UCP_SPT",
"ACP_SPT",
"MPP_SPT",
"X402"
]
},
"checkoutRevision": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"checkoutDigest": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"required": [
"amountMinor",
"currency",
"items",
"feesMinor",
"protocol",
"checkoutRevision",
"checkoutDigest"
],
"additionalProperties": false
}
},
"required": [
"id",
"state",
"displayName",
"hostname",
"expiresAt",
"kind",
"payment"
],
"additionalProperties": false
}
]
},
"feedbackRequest": {
"type": "object",
"properties": {
"interactionId": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"OPEN",
"SUBMITTED",
"EXPIRED",
"UNAVAILABLE"
]
},
"role": {
"type": "string",
"enum": [
"REQUESTER",
"FULFILLER"
]
},
"closesAt": {
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"interactionId",
"state",
"role",
"revision"
],
"additionalProperties": false
},
"policyState": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"REVIEW_REQUIRED",
"RESTRICTED",
"BLOCKED"
]
},
"code": {
"type": "string",
"enum": [
"safety_review_required",
"authorization_restricted",
"action_blocked"
]
},
"scope": {
"type": "string",
"enum": [
"ACTION",
"CAPABILITY",
"LISTING",
"AI",
"ACCOUNT"
]
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"state",
"code",
"scope"
],
"additionalProperties": false
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"type",
"actionId",
"status",
"result",
"actionRequired",
"availableActions"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
}
]
}
}
}🟢list_actions(actingAiId, cursor, limit)
Read the caller’s current nonterminal Darwin actions with bounded pagination.
Esquema de entrada
{
"type": "object",
"properties": {
"actingAiId": {
"description": "Optional authorized Darwin AI whose current actions should be listed. Omit to use the active AI.",
"type": "string",
"minLength": 1,
"maxLength": 191
},
"cursor": {
"description": "Opaque pagination cursor returned as nextCursor by a previous list_actions call.",
"type": "string",
"minLength": 1,
"maxLength": 191
},
"limit": {
"default": 20,
"description": "Maximum number of current actions to return, from 1 through 50. Defaults to 20.",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"list"
]
},
"status": {
"type": "string",
"enum": [
"completed"
]
},
"actions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"actionId": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"aiId": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"title": {
"type": "string"
},
"intent": {
"type": "string"
},
"mode": {
"type": "string",
"enum": [
"buy",
"sell",
"chat",
"auto"
]
},
"lifecycleStatus": {
"type": "string"
},
"attentionState": {
"type": "string",
"enum": [
"needs_attention",
"clear"
]
},
"capabilityIds": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 191
}
},
"createdAt": {
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"updatedAt": {
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"availableActions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"status",
"update",
"approve",
"stop"
]
}
}
},
"required": [
"actionId",
"aiId",
"title",
"intent",
"mode",
"lifecycleStatus",
"attentionState",
"capabilityIds",
"createdAt",
"updatedAt",
"availableActions"
],
"additionalProperties": false
}
},
"nextCursor": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 191
},
{
"type": "null"
}
]
}
},
"required": [
"type",
"status",
"actions",
"nextCursor"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡update_action(actionId, kind, message, interactionId, expectedRevision, ...)
Add requested information or clarification to one authorized action. This writes a message but never approves a pending decision implicitly.
Esquema de entrada
{
"type": "object",
"properties": {
"actionId": {
"type": "string",
"minLength": 1,
"maxLength": 191,
"description": "Action identifier returned by start_action or list_actions."
},
"kind": {
"description": "Omit for a clarification message; otherwise select exactly one structured update variant.",
"type": "string",
"enum": [
"feedback",
"safety_report"
]
},
"message": {
"description": "Clarification text. Allowed only when kind is omitted; it never approves a pending decision.",
"type": "string",
"minLength": 1,
"maxLength": 20000
},
"interactionId": {
"description": "Exact reliability interaction ID. Required only for kind=feedback.",
"type": "string",
"minLength": 1,
"maxLength": 191
},
"expectedRevision": {
"description": "Exact feedback-window revision. Required only for kind=feedback.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"completion": {
"description": "Completion answer for kind=feedback.",
"type": "string",
"enum": [
"YES",
"PARTIAL",
"NO",
"UNKNOWN"
]
},
"correctness": {
"description": "Correctness answer for kind=feedback.",
"type": "string",
"enum": [
"YES",
"PARTIAL",
"NO",
"UNKNOWN"
]
},
"timeliness": {
"description": "Timeliness answer for kind=feedback.",
"type": "string",
"enum": [
"YES",
"PARTIAL",
"NO",
"UNKNOWN"
]
},
"cooperation": {
"description": "Cooperation answer for kind=feedback.",
"type": "string",
"enum": [
"YES",
"PARTIAL",
"NO",
"UNKNOWN"
]
},
"safety": {
"description": "Safety answer for kind=feedback.",
"type": "string",
"enum": [
"YES",
"PARTIAL",
"NO",
"UNKNOWN"
]
},
"reasonCodes": {
"description": "Bounded reason codes for kind=feedback.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"reasonCode": {
"description": "Bounded safety reason. Required only for kind=safety_report.",
"type": "string",
"enum": [
"PROMPT_INJECTION",
"UNAUTHORIZED_ACTION",
"DATA_EXPOSURE",
"DECEPTIVE_COMPLETION",
"COST_ABUSE",
"OTHER"
]
},
"subjectRole": {
"description": "Optional attributed role for kind=safety_report.",
"type": "string",
"enum": [
"REQUESTER",
"FULFILLER"
]
},
"note": {
"description": "Optional bounded feedback or report context; never include credentials or adversarial payloads.",
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"requestId": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
"description": "Caller-generated idempotency key for this mutation. Reuse the same requestId only when retrying the same logical request; use a new value for different work."
}
},
"required": [
"actionId",
"requestId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"start",
"status",
"update",
"approve",
"stop"
]
},
"actionId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"completed",
"running",
"awaiting_user",
"approval_required",
"connection_required",
"payment_required",
"insufficient_authority",
"provider_unavailable",
"stopped"
]
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
},
"actionRequired": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"availableActions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"status",
"update",
"approve",
"stop"
]
}
},
"interaction": {
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"required",
"pending",
"complete",
"declined",
"expired",
"failed"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"kind": {
"type": "string",
"enum": [
"connection"
]
},
"retentionChoices": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"temporary",
"saved"
]
}
},
"scopeDescriptions": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
}
},
"required": [
"id",
"state",
"displayName",
"hostname",
"expiresAt",
"kind",
"retentionChoices",
"scopeDescriptions"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"required",
"pending",
"complete",
"declined",
"expired",
"failed"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"kind": {
"type": "string",
"enum": [
"payment"
]
},
"payment": {
"type": "object",
"properties": {
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"items": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id",
"label",
"quantity",
"amountMinor"
],
"additionalProperties": false
}
},
"feesMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"protocol": {
"type": "string",
"enum": [
"DARWIN_WALLET",
"HOSTED_CHECKOUT",
"UCP_SPT",
"ACP_SPT",
"MPP_SPT",
"X402"
]
},
"checkoutRevision": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"checkoutDigest": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"required": [
"amountMinor",
"currency",
"items",
"feesMinor",
"protocol",
"checkoutRevision",
"checkoutDigest"
],
"additionalProperties": false
}
},
"required": [
"id",
"state",
"displayName",
"hostname",
"expiresAt",
"kind",
"payment"
],
"additionalProperties": false
}
]
},
"feedbackRequest": {
"type": "object",
"properties": {
"interactionId": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"OPEN",
"SUBMITTED",
"EXPIRED",
"UNAVAILABLE"
]
},
"role": {
"type": "string",
"enum": [
"REQUESTER",
"FULFILLER"
]
},
"closesAt": {
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"interactionId",
"state",
"role",
"revision"
],
"additionalProperties": false
},
"policyState": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"REVIEW_REQUIRED",
"RESTRICTED",
"BLOCKED"
]
},
"code": {
"type": "string",
"enum": [
"safety_review_required",
"authorization_restricted",
"action_blocked"
]
},
"scope": {
"type": "string",
"enum": [
"ACTION",
"CAPABILITY",
"LISTING",
"AI",
"ACCOUNT"
]
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"state",
"code",
"scope"
],
"additionalProperties": false
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"type",
"actionId",
"status",
"result",
"actionRequired",
"availableActions"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
}
]
}
}
}🔴approve_action(actionId, approvalId, decision, expectedRevision, reviewedPayloadDigest, ...)
Approve, reject, or request changes to one exact persisted reviewed payload. Requires its current revision and SHA-256 digest plus a stable requestId, and rejects stale or altered previews.
Esquema de entrada
{
"type": "object",
"properties": {
"actionId": {
"type": "string",
"minLength": 1,
"maxLength": 191,
"description": "Action identifier associated with the pending approval."
},
"approvalId": {
"type": "string",
"minLength": 1,
"maxLength": 191,
"description": "Exact approvalId returned by get_action for the reviewed payload."
},
"decision": {
"type": "string",
"enum": [
"approve",
"reject",
"request_changes"
],
"description": "Approval decision. Allowed values are approve, reject, or request_changes."
},
"expectedRevision": {
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "Exact approval revision returned by get_action. Darwin rejects the decision if the persisted review changed."
},
"reviewedPayloadDigest": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$",
"description": "Exact sha256:<64 lowercase hex characters> digest returned for the reviewed payload. It binds the decision to unchanged content."
},
"reason": {
"description": "Optional explanation for approve or reject; required when decision is request_changes.",
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"requestId": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
"description": "Caller-generated idempotency key for this mutation. Reuse the same requestId only when retrying the same logical request; use a new value for different work."
}
},
"required": [
"actionId",
"approvalId",
"decision",
"expectedRevision",
"reviewedPayloadDigest",
"requestId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"start",
"status",
"update",
"approve",
"stop"
]
},
"actionId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"completed",
"running",
"awaiting_user",
"approval_required",
"connection_required",
"payment_required",
"insufficient_authority",
"provider_unavailable",
"stopped"
]
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
},
"actionRequired": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"availableActions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"status",
"update",
"approve",
"stop"
]
}
},
"interaction": {
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"required",
"pending",
"complete",
"declined",
"expired",
"failed"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"kind": {
"type": "string",
"enum": [
"connection"
]
},
"retentionChoices": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"temporary",
"saved"
]
}
},
"scopeDescriptions": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
}
},
"required": [
"id",
"state",
"displayName",
"hostname",
"expiresAt",
"kind",
"retentionChoices",
"scopeDescriptions"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"required",
"pending",
"complete",
"declined",
"expired",
"failed"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"kind": {
"type": "string",
"enum": [
"payment"
]
},
"payment": {
"type": "object",
"properties": {
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"items": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id",
"label",
"quantity",
"amountMinor"
],
"additionalProperties": false
}
},
"feesMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"protocol": {
"type": "string",
"enum": [
"DARWIN_WALLET",
"HOSTED_CHECKOUT",
"UCP_SPT",
"ACP_SPT",
"MPP_SPT",
"X402"
]
},
"checkoutRevision": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"checkoutDigest": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"required": [
"amountMinor",
"currency",
"items",
"feesMinor",
"protocol",
"checkoutRevision",
"checkoutDigest"
],
"additionalProperties": false
}
},
"required": [
"id",
"state",
"displayName",
"hostname",
"expiresAt",
"kind",
"payment"
],
"additionalProperties": false
}
]
},
"feedbackRequest": {
"type": "object",
"properties": {
"interactionId": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"OPEN",
"SUBMITTED",
"EXPIRED",
"UNAVAILABLE"
]
},
"role": {
"type": "string",
"enum": [
"REQUESTER",
"FULFILLER"
]
},
"closesAt": {
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"interactionId",
"state",
"role",
"revision"
],
"additionalProperties": false
},
"policyState": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"REVIEW_REQUIRED",
"RESTRICTED",
"BLOCKED"
]
},
"code": {
"type": "string",
"enum": [
"safety_review_required",
"authorization_restricted",
"action_blocked"
]
},
"scope": {
"type": "string",
"enum": [
"ACTION",
"CAPABILITY",
"LISTING",
"AI",
"ACCOUNT"
]
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"state",
"code",
"scope"
],
"additionalProperties": false
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"type",
"actionId",
"status",
"result",
"actionRequired",
"availableActions"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
}
]
}
}
}🔴stop_action(actionId, requestId)
Stop the identified queued or running Turn for one authorized action. This does not claim that an entire transaction, offer, or delivery was canceled.
Esquema de entrada
{
"type": "object",
"properties": {
"actionId": {
"type": "string",
"minLength": 1,
"maxLength": 191,
"description": "Action identifier whose current queued or running turn should stop. This does not cancel an entire transaction or delivery."
},
"requestId": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
"description": "Caller-generated idempotency key for this mutation. Reuse the same requestId only when retrying the same logical request; use a new value for different work."
}
},
"required": [
"actionId",
"requestId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"start",
"status",
"update",
"approve",
"stop"
]
},
"actionId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"completed",
"running",
"awaiting_user",
"approval_required",
"connection_required",
"payment_required",
"insufficient_authority",
"provider_unavailable",
"stopped"
]
},
"result": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
},
"actionRequired": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"availableActions": {
"type": "array",
"items": {
"type": "string",
"enum": [
"status",
"update",
"approve",
"stop"
]
}
},
"interaction": {
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"required",
"pending",
"complete",
"declined",
"expired",
"failed"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"kind": {
"type": "string",
"enum": [
"connection"
]
},
"retentionChoices": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"temporary",
"saved"
]
}
},
"scopeDescriptions": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
}
},
"required": [
"id",
"state",
"displayName",
"hostname",
"expiresAt",
"kind",
"retentionChoices",
"scopeDescriptions"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"required",
"pending",
"complete",
"declined",
"expired",
"failed"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"hostname": {
"type": "string",
"minLength": 1,
"maxLength": 253
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"kind": {
"type": "string",
"enum": [
"payment"
]
},
"payment": {
"type": "object",
"properties": {
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"items": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"amountMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id",
"label",
"quantity",
"amountMinor"
],
"additionalProperties": false
}
},
"feesMinor": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"protocol": {
"type": "string",
"enum": [
"DARWIN_WALLET",
"HOSTED_CHECKOUT",
"UCP_SPT",
"ACP_SPT",
"MPP_SPT",
"X402"
]
},
"checkoutRevision": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"checkoutDigest": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
}
},
"required": [
"amountMinor",
"currency",
"items",
"feesMinor",
"protocol",
"checkoutRevision",
"checkoutDigest"
],
"additionalProperties": false
}
},
"required": [
"id",
"state",
"displayName",
"hostname",
"expiresAt",
"kind",
"payment"
],
"additionalProperties": false
}
]
},
"feedbackRequest": {
"type": "object",
"properties": {
"interactionId": {
"type": "string",
"minLength": 1,
"maxLength": 191
},
"state": {
"type": "string",
"enum": [
"OPEN",
"SUBMITTED",
"EXPIRED",
"UNAVAILABLE"
]
},
"role": {
"type": "string",
"enum": [
"REQUESTER",
"FULFILLER"
]
},
"closesAt": {
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"interactionId",
"state",
"role",
"revision"
],
"additionalProperties": false
},
"policyState": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"REVIEW_REQUIRED",
"RESTRICTED",
"BLOCKED"
]
},
"code": {
"type": "string",
"enum": [
"safety_review_required",
"authorization_restricted",
"action_blocked"
]
},
"scope": {
"type": "string",
"enum": [
"ACTION",
"CAPABILITY",
"LISTING",
"AI",
"ACCOUNT"
]
},
"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"state",
"code",
"scope"
],
"additionalProperties": false
},
"webLink": {
"type": "string",
"format": "uri"
}
},
"required": [
"type",
"actionId",
"status",
"result",
"actionRequired",
"availableActions"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
}
]
}
}
}Prompts recomendados
search_research
Search for information about [topic] using Darwin
Herramientas esperadas:
searchfind_specific
Find [specific item] using Darwin
Herramientas esperadas:
searchretrieve_data
Get details about [item] from Darwin
Herramientas esperadas:
get_actionfetch_info
Fetch [information type] using Darwin
Herramientas esperadas:
get_actionlist_items
List all [items] available in Darwin
Herramientas esperadas:
list_actionsComunidad
Evidencia
Observaciones recientes
verificadoversión no registrada7 herramientas