v13

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-04-23163074.4 KB
Negotiation

Ask whether this agent can handle a task

Orchestrators use this to pick the best agent for a task before sending a real message/send. The agent returns a capability score (0–1) weighted across skill match, I/O compatibility, performance, load, and cost.

A score below the caller's min_score is interpreted as "decline" — the orchestrator should route the task elsewhere. This endpoint never actually performs the task; it's advisory.

post/agent/negotiation

Request body

task_summarystring required

One-sentence description of the work.

task_detailsstring

Longer context, audience, constraints.

input_mime_typesstring[]
output_mime_typesstring[]
max_latency_msinteger

Client's latency tolerance.

max_cost_amountstring

Client's cost tolerance (currency-agnostic; agreed per-agent).

required_toolsstring[]
forbidden_toolsstring[]
min_scorenumber

Decline threshold. Scores below this are treated as "no".

Response

Negotiation response

can_handleboolean required
scorenumber required
reasonsstring[]

Short bullet rationale for the score.

estimated_latency_msinteger
estimated_cost_amountstring