Protocol Route Planner prototype grant
A route planning model that recommends viable agentic-commerce routes for a given intent. This grant funds a planning model, not a transaction execution engine.
Summary
The Protocol Route Planner takes an agent's intent and surrounding context and recommends one or more viable routes across agentic-commerce protocols. It is a planning model. It does not execute transactions, take custody of funds, or stand in as a settlement layer. The output is a structured recommendation with explicit conditions, credential requirements, settlement options, and audit trail expectations that downstream systems can consume.
Why It Matters
Agents face a fragmented commerce landscape: ACP, UCP, AP2, x402, and merchant-native flows each carry their own credential and settlement assumptions. Without a shared planning model, every orchestrator re-implements the same decision logic, often inconsistently. A reference planner gives developers a clean separation between "what route should we use" and "how do we execute that route" and lets policy live in one place.
Inputs and Outputs
Inputs
- Agent intent (what is being purchased or transacted)
- KYA credential set for the agent and controller
- Merchant manifest reference
- Payment preference
- Jurisdiction context
- Risk policy
- Settlement preference
Outputs
- Recommended route, with rationale
- Required credentials for that route
- Unsupported conditions that block the route
- Available settlement options
- Audit trail requirements downstream systems must satisfy
Strategic Layer Mapping
This grant advances Layer 2: Protocol Routing in the Foundation's seven-layer agentic-commerce development program. It consumes Layer 1 (identity) and Layer 3 (merchant readiness) inputs and feeds Layer 5 (mission compliance reporting).
Strategic Gap Mapping
Closes Gap 2: Cross-Protocol Routing. Merchants and agents speak different commerce protocols. A shared planning model reduces integration cost on both sides and makes policy enforcement portable.
Suggested Deliverables
- Open-source planner library with a documented decision interface.
- Schema definitions for inputs and outputs.
- Reference rule sets covering at least two protocols, for example ACP and x402, plus a documented extension pattern.
- Reference fixtures for happy path, ambiguous path, and unsupported path scenarios.
- Documentation explaining why the planner is planning-only and how it composes with separate execution and settlement systems.
- An optional visualization that renders a planning decision and its branches.
MVP Expectations
- Given a structured input, the planner returns a deterministic structured output.
- At least two protocol rule sets are represented.
- Unsupported conditions are explicitly returned with reason codes, not silently dropped.
- The planner does not execute transactions, hold credentials, or take custody.
- Passing test suite and CLI invocation example.
- Published under an OSI-approved license with a permissive default.
Out of Scope for Initial Grant
- Transaction execution, settlement, or fund custody.
- Wallet, key, or credential storage.
- Hosted SaaS planner endpoints.
- Closed protocol-specific tooling without an extension point for others.
- Regulatory routing classifications or jurisdiction-specific legal advice.
Security and Privacy Expectations
- Planner outputs are deterministic given the same input, with versioned rule sets.
- No sensitive credential material is logged at default verbosity.
- Inputs are validated against the schema.
- A documented threat model that lists what the planner does and does not protect against.
- A responsible disclosure contact in the README.
Suggested Applicant Profile
This grant suits a team with experience in policy engines, payments routing, or protocol-agnostic SDK design. Familiarity with agentic-commerce protocols such as ACP, UCP, AP2, or x402 is helpful. Prior open-source delivery is a plus. The Foundation welcomes both engineering-led teams and research-led teams with a clear delivery partner.
Review Criteria
- Public-good output and permissive licensing.
- Determinism and clarity of the planning interface.
- Quality of the included rule sets.
- Extensibility for additional protocols.
- Quality of documentation and developer ergonomics.
- Maintenance plan and team track record.
How to Apply
Use the grant application form at /pages/apply.
Suggested project title: Protocol Route Planner
Grant category: Protocol Router Adapters (Layer 2)
Seven-layer mapping: Layer 2: Protocol Routing
Strategic gap: Gap 2: Cross-Protocol Routing