kcp_trace
Produce a decision trace for a task: every unit in the manifest annotated with the gate cascade it was evaluated through (audience, temporal, relevance, budget, context, etc.). Same inputs as kcp_plan; returns the canonical plan plus structured per-unit gate verdicts.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| env | No | Runtime environment for federation context selection (dev/test/staging/prod) | |
| role | No | Agent role for audience targeting (default: agent) | |
| task | Yes | The task to plan knowledge loading for | |
| as_of | No | ISO date for temporal evaluation (default: today, UTC) | |
| attest | No | Attestation provider the agent can present, matched against the manifest's trusted_providers | |
| budget | No | Spend ceiling for pay-per-request units | |
| follow | No | Follow eligible federation refs (default false) | |
| strict | No | Fail-closed: drop non-eligible units instead of listing them | |
| methods | No | Payment methods the agent can settle, e.g. ["free","x402"] (default: free only) | |
| currency | No | Budget currency (default USDC) | |
| manifest | Yes | Path, directory, or HTTPS URL of a knowledge.yaml | |
| max_depth | No | Federation hops to follow when follow=true (default 1) | |
| max_nodes | No | Cap on total manifests fetched across the walk (default 64) | |
| max_units | No | Cap on selected units (default 5) | |
| credentials | No | Credential kinds the agent holds, e.g. ["mtls","api_key"] — opens access-gated units | |
| context_budget | No | Token ceiling for what the plan loads into the caller's context window; over-budget units skipped with the arithmetic | |
| allow_private_hosts | No | Permit fetches to loopback/private/link-local hosts and http:// (default false — fail-closed) |