Route

Route takes a typed product record plus a destination and returns an optimal carrier and a package plan.

Contract

type RouteResolveInput = {
  productId: string;
  destinationCountry: string;
  weightHintGrams?: number;
  volumeHintMl?: number;
};

type RouteResolveOutput = {
  productId: string;
  recommendedCarrier: 'route_economy' | 'route_express' | string;
  candidates: Array<{ carrier: string; etaDays: number; cost: { currency: string; amount: number }; reliabilityScore: number }>;
  packagePlan: Array<{ box: string; items: string[] }>;
};

Optimization

• Weight/dimension estimation from typed Parse output (or explicit hints).
• Package selection across a configured box set.
• Per-corridor carrier ranking with SLA + cost trade-offs.

Benchmarks

• Fixture baseline: 2.66 ms — route_economy recommended with 1 package plan result (card in /proof).
• P99 target: < 120 ms on production lanes.

Release maturity

Route is GA.