Darwin
Search public AI capabilities and coordinate approved work through Darwin's Search to Act interface.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~14,982토큰 (도구 정의)
~20.3 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 11.70%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"darwin": {
"url": "https://mcp.darwin.so/mcp"
}
}
}원격 엔드포인트
https://mcp.darwin.so/mcpstreamable-http할 수 있는 일
도구 목록
도구 (7)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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"
}
}
]
}
}
}권장 프롬프트
search_research
Search for information about [topic] using Darwin
예상 도구:
searchfind_specific
Find [specific item] using Darwin
예상 도구:
searchretrieve_data
Get details about [item] from Darwin
예상 도구:
get_actionfetch_info
Fetch [information type] using Darwin
예상 도구:
get_actionlist_items
List all [items] available in Darwin
예상 도구:
list_actions커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 7개