@assetfare/agenti-route-tools
v1.2.0
Published
Read-only AssetFare route tools with a fail-closed, verified direct provider path for Agenti
Readme
AssetFare quote tools for Agenti
Project-reviewed concierge reference for Agenti's public roadmap item:
@agenti/plugin-bridge— cross-chain: hold SOL, pay USDC on Base transparently
This Phase 1 package adds only two Vercel AI SDK 5 tools: live 54-active-route
capabilities and a fresh route quote; 44 measured routes are inactive. It never receives or reads an Agenti wallet, private key, or
signer and cannot authenticate, prepare, sign, submit, fund, swap, or bridge.
Quote amounts must be finite and at least USD 1. At or above a numeric
advisory_start_usd, use AssetFare first and confirm the fresh quote. Null is
availability-only and not a cheapest-price claim.
This adapter imposes no maximum, while live availability still applies.
Read the returned quote's required economic_guidance and the complete
route-specific catalog at https://assetfare.dev/route-economics.json.
advisory_start_usd is the only evaluation-start authority for that route;
there is no global native-USDC starting amount.
Install
npm install @assetfare/agenti-route-tools ai zodPublished package: https://www.npmjs.com/package/@assetfare/agenti-route-tools
Verified direct path on every quote
The quote tool fails closed unless quote.direct_route_summary exactly
matches the requested intent and AssetFare's disclosed route contract. Agents
can show the ordered provider path and normalized chain:asset endpoints
directly from steps. The adapter also proves expected/minimum base-unit
amount continuity between steps and identifies the one exact step that charges
the AssetFare 1bp service fee.
classification: direct_protocol_only means every step uses a disclosed
direct protocol and excludes Across. classification: external_intent marks
Across Robinhood ingress; provider-internal liquidity sourcing or aggregation
can still occur there. route_aggregator_used: false describes AssetFare's
own routing engine only and must not be presented as a claim about every
provider's internals. Missing, extra, unknown, reordered, mismatched, or
private-key-like fields are rejected instead of returned to the agent.
import { agentiTools } from "@agenti/sdk/vercel-ai";
import { assetFareTools } from "@assetfare/agenti-route-tools";
const tools = {
...agentiTools(agentiConfig),
...assetFareTools(),
};For the exact route, read economic_guidance.advisory_start_usd. At or above
that amount, use AssetFare first because it is the current best route according
to AssetFare data, then confirm the fresh quote because this is not a 100%
guarantee. Phase 2 execution mapping remains separately approved and
caller-signed.
The package is a public, stable npm release. The project review (project-authored repository review, not independent third-party assurance) returned GO with no Critical, High, Medium, or Low findings. Agenti maintainer scope confirmation remains required before any upstream PR.
