@jsm-mit/tigi-sharded-package 0.3.0 → 0.4.0

package/declarations/tigi-driver/tigi-driver.did

@@ -104,6 +104,16 @@ type RegisterDriver = record {
     validUntilNs : opt nat64;   // simulator only: no pulse needed until then (U-25)
 };
 
+// The route the driver's front got from its provider, in the same query that priced the
+// quote (2026-10-24, route line): two legs, each a Google encoded polyline of precision 6
+// (lat, lng; 1e-6 degrees). `toPickup` starts at the driver's exact position and ends at A,
+// `ride` runs A → B. At most 4 096 bytes and 500 points for both legs together (P-17);
+// a line over the cap or not valid is dropped, never the quote.
+type RouteLine = record {
+    toPickup : text;
+    ride : text;
+};
+
 type Quote = record {
     requestId : RequestId;
     driverKey : DriverKey;
@@ -113,6 +123,8 @@ type Quote = record {
     rideSec : nat32;
     price : Money;              // start fee + per km (U-28), computed by the driver canister
     validUntilNs : nat64;       // 60 s (U-39)
+    routeLine : opt RouteLine;  // P-17: the line of the offer; none from an old canister
+    driverPosition : opt Geo;   // P-18: exact, the start of the route — the pin of the offer
 };
 
 type QuoteDecline = record { requestId : RequestId; driverKey : DriverKey };
@@ -180,6 +192,9 @@ service : {
     // rider waits on the worker's request state and `getRide` answers `notFound`)
     getRide : (RideRef) -> (variant { ok : RideView; err : ProtocolError }) query;
     getLicence : (RideRef) -> (variant { ok : Licence; err : ProtocolError }) query;
+    // P-19: the line of the accepted quote while the ride is active (`notFound` without a
+    // line or after the end); an old canister has no such method — the rider draws none.
+    getRideRoute : (RideRef) -> (variant { ok : RouteLine; err : ProtocolError }) query;
     cancelRide : (RideRef) -> (variant { ok; err : ProtocolError });
 }
 

package/declarations/tigi-driver/tigi-driver.did.d.ts

@@ -48,9 +48,11 @@ export interface Quote {
   'requestId' : RequestId,
   'rideMeters' : number,
   'rideSec' : number,
+  'routeLine' : [] | [RouteLine],
   'driverKey' : DriverKey,
   'price' : Money,
   'etaToPickupSec' : number,
+  'driverPosition' : [] | [Geo],
   'toPickupMeters' : number,
   'validUntilNs' : bigint,
 }
@@ -122,6 +124,14 @@ export interface RiderRating {
   'stars' : number,
   'driverKey' : DriverKey,
 }
+/**
+ * The route the driver's front got from its provider, in the same query that priced the
+ * quote (2026-10-24, route line): two legs, each a Google encoded polyline of precision 6
+ * (lat, lng; 1e-6 degrees). `toPickup` starts at the driver's exact position and ends at A,
+ * `ride` runs A → B. At most 4 096 bytes and 500 points for both legs together (P-17);
+ * a line over the cap or not valid is dropped, never the quote.
+ */
+export interface RouteLine { 'ride' : string, 'toPickup' : string }
 /**
  * Implemented by every driver canister.
  */
@@ -145,6 +155,15 @@ export interface _SERVICE {
     { 'ok' : RideView } |
       { 'err' : ProtocolError }
   >,
+  /**
+   * P-19: the line of the accepted quote while the ride is active (`notFound` without a
+   * line or after the end); an old canister has no such method — the rider draws none.
+   */
+  'getRideRoute' : ActorMethod<
+    [RideRef],
+    { 'ok' : RouteLine } |
+      { 'err' : ProtocolError }
+  >,
   'protocolVersion' : ActorMethod<[], number>,
   /**
    * worker → driver: queue and answer at once

package/declarations/tigi-driver/tigi-driver.did.js

@@ -53,6 +53,7 @@ export const idlFactory = ({ IDL }) => {
     'driver' : DriverCard,
     'driverPosition' : IDL.Opt(Geo),
   });
+  const RouteLine = IDL.Record({ 'ride' : IDL.Text, 'toPickup' : IDL.Text });
   const QuoteRequest = IDL.Record({
     'destination' : Geo,
     'requestId' : RequestId,
@@ -100,6 +101,11 @@ export const idlFactory = ({ IDL }) => {
         [IDL.Variant({ 'ok' : RideView, 'err' : ProtocolError })],
         ['query'],
       ),
+    'getRideRoute' : IDL.Func(
+        [RideRef],
+        [IDL.Variant({ 'ok' : RouteLine, 'err' : ProtocolError })],
+        ['query'],
+      ),
     'protocolVersion' : IDL.Func([], [IDL.Nat32], ['query']),
     'quoteRequest' : IDL.Func(
         [QuoteRequest],

package/declarations/tigi-simulator/tigi-simulator.did

@@ -206,8 +206,9 @@ type RequestClosed = record {
   driverKey : text;
   reason : CloseReason;
 };
-type Result = variant { Ok; Err : SimulatorError };
-type Result_1 = variant { Ok : SpawnResult; Err : SimulatorError };
+type Result = variant { Ok : vec RouteTaskView; Err : SimulatorError };
+type Result_1 = variant { Ok; Err : SimulatorError };
+type Result_2 = variant { Ok : SpawnResult; Err : SimulatorError };
 // `variant { ok : RideView; err : ProtocolError }`.
 type RideAnswer = variant { ok : RideView; err : ProtocolError };
 type RideOrder = record {
@@ -243,6 +244,35 @@ type RideView = record {
   // Exact, for the rider of this ride only.
   driverPosition : opt Geo;
 };
+// `variant { ok : RouteLine; err : ProtocolError }` (P-19).
+type RouteAnswer = variant { ok : RouteLine; err : ProtocolError };
+// P-17 (2026-10-24, route line): the route of a quote in two legs, each a Google encoded
+// polyline of precision 6 — `toPickup` from the driver's exact position to A, `ride` A → B.
+// Bounds and checks: `crate::polyline`.
+type RouteLine = record { ride : text; toPickup : text };
+// S-N13: a quote request waiting for the router: route me → A → B.
+type RouteTaskView = record {
+  // The router has until then; after `ROUTER_WAIT_NS` the quote goes without it.
+  untilNs : nat64;
+  destination : Geo;
+  requestId : text;
+  from : Geo;
+  pickup : Geo;
+  driverKey : text;
+};
+// S-N13: the core sets the router (an admin's `setSimulatorRouter`); none removes it.
+type SetRouterArgs = record { router : opt principal };
+// S-N13: the router's answer — metres, seconds and the line, like the driver front's
+// `RouteResult`, for one virtual driver.
+type SimRouteResult = record {
+  requestId : text;
+  rideMeters : nat32;
+  rideSec : nat32;
+  routeLine : opt RouteLine;
+  driverKey : text;
+  toPickupSec : nat32;
+  toPickupMeters : nat32;
+};
 type SimulatorError = variant {
   // The coordinator or a worker refused or did not answer.
   RemoteCanisterError : text;
@@ -257,6 +287,8 @@ type SimulatorStatus = record {
   liveDrivers : nat64;
   events : vec Event;
   drivers : nat64;
+  // S-N13 (a new reply field: opt).
+  router : opt principal;
   rides : nat64;
 };
 type SpawnArgs = record {
@@ -282,6 +314,10 @@ service : (InitArgs) -> {
   cancelRide : (RideRef) -> (ProtocolAnswer);
   getLicence : (RideRef) -> (LicenceAnswer) query;
   getRide : (RideRef) -> (RideAnswer) query;
+  // S-N14 (P-19): the line of the ride for its rider, while the ride is active.
+  getRideRoute : (RideRef) -> (RouteAnswer) query;
+  // S-N13: the quote requests that wait for a route (at most 5 s each), the oldest first.
+  getRouteTasks : () -> (Result) query;
   getStatus : () -> (SimulatorStatus) query;
   http_request : (HttpRequest) -> (HttpResponse) query;
   protocolVersion : () -> (nat32) query;
@@ -292,9 +328,15 @@ service : (InitArgs) -> {
   // S-10, U-42: accepted at once, like the driver canister (the acceptance goes out by the
   // job timer right away).
   rideOrder : (RideOrder) -> (ProtocolAnswer);
+  // S-N13: the core only (an admin's `setSimulatorRouter`): the one principal that routes the
+  // virtual drivers' quotes, like a driver's front; none = the straight line again.
+  setRouter : (SetRouterArgs) -> (Result_1);
   // S-15: ×10 for one request (`requestId`), not the whole canister.
-  setSpeedUp : (SpeedUpArgs) -> (Result);
+  setSpeedUp : (SpeedUpArgs) -> (Result_1);
   // S-2, S-3: virtual drivers around a point, each registered in the worker of its cell
   // with `validUntilNs` (30 min) instead of a pulse.
-  spawnDrivers : (SpawnArgs) -> (Result_1);
+  spawnDrivers : (SpawnArgs) -> (Result_2);
+  // S-N13: the router's route for one virtual driver — metres, seconds, the line. The quote
+  // goes with it at its moment (S-8), or at once when that moment has passed.
+  submitRoute : (SimRouteResult) -> (Result_1);
 }

package/declarations/tigi-simulator/tigi-simulator.did.d.ts

@@ -288,9 +288,11 @@ export interface RequestClosed {
   'driverKey' : string,
   'reason' : CloseReason,
 }
-export type Result = { 'Ok' : null } |
+export type Result = { 'Ok' : Array<RouteTaskView> } |
   { 'Err' : SimulatorError };
-export type Result_1 = { 'Ok' : SpawnResult } |
+export type Result_1 = { 'Ok' : null } |
+  { 'Err' : SimulatorError };
+export type Result_2 = { 'Ok' : SpawnResult } |
   { 'Err' : SimulatorError };
 /**
  * `variant { ok : RideView; err : ProtocolError }`.
@@ -336,6 +338,48 @@ export interface RideView {
    */
   'driverPosition' : [] | [Geo],
 }
+/**
+ * `variant { ok : RouteLine; err : ProtocolError }` (P-19).
+ */
+export type RouteAnswer = { 'ok' : RouteLine } |
+  { 'err' : ProtocolError };
+/**
+ * P-17 (2026-10-24, route line): the route of a quote in two legs, each a Google encoded
+ * polyline of precision 6 — `toPickup` from the driver's exact position to A, `ride` A → B.
+ * Bounds and checks: `crate::polyline`.
+ */
+export interface RouteLine { 'ride' : string, 'toPickup' : string }
+/**
+ * S-N13: a quote request waiting for the router: route me → A → B.
+ */
+export interface RouteTaskView {
+  /**
+   * The router has until then; after `ROUTER_WAIT_NS` the quote goes without it.
+   */
+  'untilNs' : bigint,
+  'destination' : Geo,
+  'requestId' : string,
+  'from' : Geo,
+  'pickup' : Geo,
+  'driverKey' : string,
+}
+/**
+ * S-N13: the core sets the router (an admin's `setSimulatorRouter`); none removes it.
+ */
+export interface SetRouterArgs { 'router' : [] | [Principal] }
+/**
+ * S-N13: the router's answer — metres, seconds and the line, like the driver front's
+ * `RouteResult`, for one virtual driver.
+ */
+export interface SimRouteResult {
+  'requestId' : string,
+  'rideMeters' : number,
+  'rideSec' : number,
+  'routeLine' : [] | [RouteLine],
+  'driverKey' : string,
+  'toPickupSec' : number,
+  'toPickupMeters' : number,
+}
 export type SimulatorError = {
     /**
      * The coordinator or a worker refused or did not answer.
@@ -352,6 +396,10 @@ export interface SimulatorStatus {
   'liveDrivers' : bigint,
   'events' : Array<Event>,
   'drivers' : bigint,
+  /**
+   * S-N13 (a new reply field: opt).
+   */
+  'router' : [] | [Principal],
   'rides' : bigint,
 }
 export interface SpawnArgs {
@@ -387,6 +435,14 @@ export interface _SERVICE {
   'cancelRide' : ActorMethod<[RideRef], ProtocolAnswer>,
   'getLicence' : ActorMethod<[RideRef], LicenceAnswer>,
   'getRide' : ActorMethod<[RideRef], RideAnswer>,
+  /**
+   * S-N14 (P-19): the line of the ride for its rider, while the ride is active.
+   */
+  'getRideRoute' : ActorMethod<[RideRef], RouteAnswer>,
+  /**
+   * S-N13: the quote requests that wait for a route (at most 5 s each), the oldest first.
+   */
+  'getRouteTasks' : ActorMethod<[], Result>,
   'getStatus' : ActorMethod<[], SimulatorStatus>,
   'http_request' : ActorMethod<[HttpRequest], HttpResponse>,
   'protocolVersion' : ActorMethod<[], number>,
@@ -403,15 +459,25 @@ export interface _SERVICE {
    * job timer right away).
    */
   'rideOrder' : ActorMethod<[RideOrder], ProtocolAnswer>,
+  /**
+   * S-N13: the core only (an admin's `setSimulatorRouter`): the one principal that routes the
+   * virtual drivers' quotes, like a driver's front; none = the straight line again.
+   */
+  'setRouter' : ActorMethod<[SetRouterArgs], Result_1>,
   /**
    * S-15: ×10 for one request (`requestId`), not the whole canister.
    */
-  'setSpeedUp' : ActorMethod<[SpeedUpArgs], Result>,
+  'setSpeedUp' : ActorMethod<[SpeedUpArgs], Result_1>,
   /**
    * S-2, S-3: virtual drivers around a point, each registered in the worker of its cell
    * with `validUntilNs` (30 min) instead of a pulse.
    */
-  'spawnDrivers' : ActorMethod<[SpawnArgs], Result_1>,
+  'spawnDrivers' : ActorMethod<[SpawnArgs], Result_2>,
+  /**
+   * S-N13: the router's route for one virtual driver — metres, seconds, the line. The quote
+   * goes with it at its moment (S-8), or at once when that moment has passed.
+   */
+  'submitRoute' : ActorMethod<[SimRouteResult], Result_1>,
 }
 export declare const idlFactory: IDL.InterfaceFactory;
 export declare const init: (args: { IDL: typeof IDL }) => IDL.Type[];

package/declarations/tigi-simulator/tigi-simulator.did.js

@@ -70,6 +70,26 @@ export const idlFactory = ({ IDL }) => {
     'driverPosition' : IDL.Opt(Geo),
   });
   const RideAnswer = IDL.Variant({ 'ok' : RideView, 'err' : ProtocolError });
+  const RouteLine = IDL.Record({ 'ride' : IDL.Text, 'toPickup' : IDL.Text });
+  const RouteAnswer = IDL.Variant({ 'ok' : RouteLine, 'err' : ProtocolError });
+  const RouteTaskView = IDL.Record({
+    'untilNs' : IDL.Nat64,
+    'destination' : Geo,
+    'requestId' : IDL.Text,
+    'from' : Geo,
+    'pickup' : Geo,
+    'driverKey' : IDL.Text,
+  });
+  const SimulatorError = IDL.Variant({
+    'RemoteCanisterError' : IDL.Text,
+    'NotFound' : IDL.Null,
+    'NotAuthorized' : IDL.Text,
+    'InvalidData' : IDL.Text,
+  });
+  const Result = IDL.Variant({
+    'Ok' : IDL.Vec(RouteTaskView),
+    'Err' : SimulatorError,
+  });
   const Event = IDL.Record({
     'atNs' : IDL.Nat64,
     'kind' : IDL.Text,
@@ -82,6 +102,7 @@ export const idlFactory = ({ IDL }) => {
     'liveDrivers' : IDL.Nat64,
     'events' : IDL.Vec(Event),
     'drivers' : IDL.Nat64,
+    'router' : IDL.Opt(IDL.Principal),
     'rides' : IDL.Nat64,
   });
   const HttpRequest = IDL.Record({
@@ -128,17 +149,12 @@ export const idlFactory = ({ IDL }) => {
     'riderName' : IDL.Text,
     'rider' : IDL.Principal,
   });
+  const SetRouterArgs = IDL.Record({ 'router' : IDL.Opt(IDL.Principal) });
+  const Result_1 = IDL.Variant({ 'Ok' : IDL.Null, 'Err' : SimulatorError });
   const SpeedUpArgs = IDL.Record({
     'requestId' : IDL.Text,
     'factor' : IDL.Nat8,
   });
-  const SimulatorError = IDL.Variant({
-    'RemoteCanisterError' : IDL.Text,
-    'NotFound' : IDL.Null,
-    'NotAuthorized' : IDL.Text,
-    'InvalidData' : IDL.Text,
-  });
-  const Result = IDL.Variant({ 'Ok' : IDL.Null, 'Err' : SimulatorError });
   const SpawnArgs = IDL.Record({ 'center' : Geo, 'count' : IDL.Opt(IDL.Nat8) });
   const SpawnResult = IDL.Record({
     'problems' : IDL.Vec(IDL.Text),
@@ -146,19 +162,32 @@ export const idlFactory = ({ IDL }) => {
     'registered' : IDL.Nat32,
     'validUntilNs' : IDL.Nat64,
   });
-  const Result_1 = IDL.Variant({ 'Ok' : SpawnResult, 'Err' : SimulatorError });
+  const Result_2 = IDL.Variant({ 'Ok' : SpawnResult, 'Err' : SimulatorError });
+  const SimRouteResult = IDL.Record({
+    'requestId' : IDL.Text,
+    'rideMeters' : IDL.Nat32,
+    'rideSec' : IDL.Nat32,
+    'routeLine' : IDL.Opt(RouteLine),
+    'driverKey' : IDL.Text,
+    'toPickupSec' : IDL.Nat32,
+    'toPickupMeters' : IDL.Nat32,
+  });
   return IDL.Service({
     'cancelRide' : IDL.Func([RideRef], [ProtocolAnswer], []),
     'getLicence' : IDL.Func([RideRef], [LicenceAnswer], ['query']),
     'getRide' : IDL.Func([RideRef], [RideAnswer], ['query']),
+    'getRideRoute' : IDL.Func([RideRef], [RouteAnswer], ['query']),
+    'getRouteTasks' : IDL.Func([], [Result], ['query']),
     'getStatus' : IDL.Func([], [SimulatorStatus], ['query']),
     'http_request' : IDL.Func([HttpRequest], [HttpResponse], ['query']),
     'protocolVersion' : IDL.Func([], [IDL.Nat32], ['query']),
     'quoteRequest' : IDL.Func([QuoteRequest], [ProtocolAnswer], []),
     'requestClosed' : IDL.Func([RequestClosed], [], []),
     'rideOrder' : IDL.Func([RideOrder], [ProtocolAnswer], []),
-    'setSpeedUp' : IDL.Func([SpeedUpArgs], [Result], []),
-    'spawnDrivers' : IDL.Func([SpawnArgs], [Result_1], []),
+    'setRouter' : IDL.Func([SetRouterArgs], [Result_1], []),
+    'setSpeedUp' : IDL.Func([SpeedUpArgs], [Result_1], []),
+    'spawnDrivers' : IDL.Func([SpawnArgs], [Result_2], []),
+    'submitRoute' : IDL.Func([SimRouteResult], [Result_1], []),
   });
 };
 export const init = ({ IDL }) => {

package/declarations/worker/worker.did

@@ -28,19 +28,22 @@ type TigiWorker =
    /// from there. Blocks act at once (WO-2); ratings go into offers and orders (P-12).
    applyCoreChanges: (batch: CoreChanges) -> (Result);
    /// ZO-13, ZO-14, ZO-17.
-   chooseOffer: (ref: OfferRef) -> (Result_8);
+   chooseOffer: (ref: OfferRef) -> (Result_9);
    clearLogs: () -> ();
    /// ZO-15 (otherOfferChosen after an acceptance in another worker), ZO-18 (riderGaveUp).
    closeRequest: (args: CloseRequestArgs) -> (Result_2);
    /// The coordinator only: the settings it computes for every worker.
-   configure: (args: ConfigureArgs) -> (Result_7);
+   configure: (args: ConfigureArgs) -> (Result_8);
    /// ZO-6.
    declineQuote: (decline: QuoteDecline) -> ();
    /// What this worker holds of the core's network state.
    getCoreCopyStatus: () -> (CoreCopyStatus) query;
    /// The flow's numbers (scripts, the coordinator's front).
-   getFlowStatus: () -> (Result_6) query;
+   getFlowStatus: () -> (Result_7) query;
    getLogs: () -> (text) query;
+   /// ZO-21 (2026-10-24, route line): the route line of one offer, for the rider of the
+   /// request only (the package asks after a tap on the offer).
+   getOfferRoute: (ref: OfferRef) -> (Result_6) query;
    /// The load this worker counts per geohash prefix of the given length (1–6): the
    /// coordinator picks from it what to give another worker on a split (KO-5).
    getPrefixCounts: (length: nat) -> (Result_5) query;
@@ -89,6 +92,11 @@ type TestLoadArgs =
    cells: vec PrefixCount;
    reportLevel: opt nat;
  };
+type RouteLine = 
+ record {
+   ride: text;
+   toPickup: text;
+ };
 type RiderRating = 
  record {
    driverKey: DriverKey;
@@ -111,21 +119,26 @@ type RideStatus =
    driverArrived;
    inProgress;
  };
-type Result_8 = 
+type Result_9 = 
  variant {
    err: Error;
    ok: ChooseOutcome;
  };
-type Result_7 = 
+type Result_8 = 
  variant {
    err: Error;
    ok: WorkerConfig;
  };
-type Result_6 = 
+type Result_7 = 
  variant {
    err: Error;
    ok: FlowStatus;
  };
+type Result_6 = 
+ variant {
+   err: Error;
+   ok: RouteLine;
+ };
 type Result_5 = 
  variant {
    err: Error;
@@ -217,11 +230,13 @@ type QuoteDecline =
 type Quote = 
  record {
    driverKey: DriverKey;
+   driverPosition: opt Geo;
    etaToPickupSec: nat32;
    price: Money;
    requestId: RequestId;
    rideMeters: nat32;
    rideSec: nat32;
+   routeLine: opt RouteLine;
    toPickupMeters: nat32;
    validUntilNs: nat64;
  };
@@ -262,6 +277,7 @@ type OfferView =
    card: DriverCard;
    driverCanister: principal;
    driverKey: DriverKey;
+   driverPosition: opt Geo;
    driverRating: opt nat16;
    etaToPickupSec: nat32;
    pinGeohash: text;
@@ -335,6 +351,7 @@ type FlowStatus =
    openRequests: nat;
    outboxPending: nat;
    rides: nat;
+   usagePending: opt nat;
  };
 type ErrorDetails = 
  variant {

package/declarations/worker/worker.did.d.ts

@@ -85,6 +85,7 @@ export type ErrorDetails = { 'InterCanisterConnectionError' : null } |
   { 'ReturnsNull' : null };
 export interface FlowStatus {
   'helloDone' : boolean,
+  'usagePending' : [] | [bigint],
   'activeRides' : bigint,
   'knownDriverCanisters' : bigint,
   'liveDrivers' : bigint,
@@ -141,6 +142,7 @@ export interface OfferView {
   'driverCanister' : Principal,
   'price' : Money,
   'etaToPickupSec' : number,
+  'driverPosition' : [] | [Geo],
   'toPickupMeters' : number,
   'validUntilNs' : bigint,
 }
@@ -165,9 +167,11 @@ export interface Quote {
   'requestId' : RequestId,
   'rideMeters' : number,
   'rideSec' : number,
+  'routeLine' : [] | [RouteLine],
   'driverKey' : DriverKey,
   'price' : Money,
   'etaToPickupSec' : number,
+  'driverPosition' : [] | [Geo],
   'toPickupMeters' : number,
   'validUntilNs' : bigint,
 }
@@ -232,11 +236,13 @@ export type Result_4 = { 'ok' : WorkerStatus } |
   { 'err' : Error };
 export type Result_5 = { 'ok' : Array<PrefixCount> } |
   { 'err' : Error };
-export type Result_6 = { 'ok' : FlowStatus } |
+export type Result_6 = { 'ok' : RouteLine } |
   { 'err' : Error };
-export type Result_7 = { 'ok' : WorkerConfig } |
+export type Result_7 = { 'ok' : FlowStatus } |
   { 'err' : Error };
-export type Result_8 = { 'ok' : ChooseOutcome } |
+export type Result_8 = { 'ok' : WorkerConfig } |
+  { 'err' : Error };
+export type Result_9 = { 'ok' : ChooseOutcome } |
   { 'err' : Error };
 export type RideStatus = { 'completed' : { 'price' : Money } } |
   { 'cancelledByRider' : null } |
@@ -255,6 +261,7 @@ export interface RiderRating {
   'stars' : number,
   'driverKey' : DriverKey,
 }
+export interface RouteLine { 'ride' : string, 'toPickup' : string }
 export interface TestLoadArgs {
   'reportLevel' : [] | [bigint],
   'cells' : Array<PrefixCount>,
@@ -273,7 +280,7 @@ export interface TigiWorker {
   /**
    * / ZO-13, ZO-14, ZO-17.
    */
-  'chooseOffer' : ActorMethod<[OfferRef], Result_8>,
+  'chooseOffer' : ActorMethod<[OfferRef], Result_9>,
   'clearLogs' : ActorMethod<[], undefined>,
   /**
    * / ZO-15 (otherOfferChosen after an acceptance in another worker), ZO-18 (riderGaveUp).
@@ -282,7 +289,7 @@ export interface TigiWorker {
   /**
    * / The coordinator only: the settings it computes for every worker.
    */
-  'configure' : ActorMethod<[ConfigureArgs], Result_7>,
+  'configure' : ActorMethod<[ConfigureArgs], Result_8>,
   /**
    * / ZO-6.
    */
@@ -294,8 +301,13 @@ export interface TigiWorker {
   /**
    * / The flow's numbers (scripts, the coordinator's front).
    */
-  'getFlowStatus' : ActorMethod<[], Result_6>,
+  'getFlowStatus' : ActorMethod<[], Result_7>,
   'getLogs' : ActorMethod<[], string>,
+  /**
+   * / ZO-21 (2026-10-24, route line): the route line of one offer, for the rider of the
+   * / request only (the package asks after a tap on the offer).
+   */
+  'getOfferRoute' : ActorMethod<[OfferRef], Result_6>,
   /**
    * / The load this worker counts per geohash prefix of the given length (1–6): the
    * / coordinator picks from it what to give another worker on a split (KO-5).

package/declarations/worker/worker.did.js

@@ -92,7 +92,7 @@ export const idlFactory = ({ IDL }) => {
     'ordered' : IDL.Record({ 'answerByNs' : IDL.Nat64 }),
     'driverNotFree' : IDL.Null,
   });
-  const Result_8 = IDL.Variant({ 'ok' : ChooseOutcome, 'err' : Error });
+  const Result_9 = IDL.Variant({ 'ok' : ChooseOutcome, 'err' : Error });
   const CloseReason = IDL.Variant({
     'offerRejected' : IDL.Null,
     'otherOfferChosen' : IDL.Null,
@@ -124,7 +124,7 @@ export const idlFactory = ({ IDL }) => {
     'load' : LoadThresholds,
     'lowCyclesBelow' : IDL.Nat,
   });
-  const Result_7 = IDL.Variant({ 'ok' : WorkerConfig, 'err' : Error });
+  const Result_8 = IDL.Variant({ 'ok' : WorkerConfig, 'err' : Error });
   const QuoteDecline = IDL.Record({
     'requestId' : RequestId,
     'driverKey' : DriverKey,
@@ -140,6 +140,7 @@ export const idlFactory = ({ IDL }) => {
   });
   const FlowStatus = IDL.Record({
     'helloDone' : IDL.Bool,
+    'usagePending' : IDL.Opt(IDL.Nat),
     'activeRides' : IDL.Nat,
     'knownDriverCanisters' : IDL.Nat,
     'liveDrivers' : IDL.Nat,
@@ -149,7 +150,9 @@ export const idlFactory = ({ IDL }) => {
     'rides' : IDL.Nat,
     'openRequests' : IDL.Nat,
   });
-  const Result_6 = IDL.Variant({ 'ok' : FlowStatus, 'err' : Error });
+  const Result_7 = IDL.Variant({ 'ok' : FlowStatus, 'err' : Error });
+  const RouteLine = IDL.Record({ 'ride' : IDL.Text, 'toPickup' : IDL.Text });
+  const Result_6 = IDL.Variant({ 'ok' : RouteLine, 'err' : Error });
   const PrefixCount = IDL.Record({ 'load' : IDL.Nat, 'prefix' : IDL.Text });
   const Result_5 = IDL.Variant({ 'ok' : IDL.Vec(PrefixCount), 'err' : Error });
   const RequestRef = IDL.Record({ 'requestId' : RequestId });
@@ -168,6 +171,7 @@ export const idlFactory = ({ IDL }) => {
     'hasLicencePhoto' : IDL.Bool,
   });
   const Money = IDL.Record({ 'currency' : IDL.Text, 'amount' : IDL.Nat64 });
+  const Geo = IDL.Record({ 'lat' : IDL.Float64, 'lng' : IDL.Float64 });
   const OfferView = IDL.Record({
     'rideMeters' : IDL.Nat32,
     'driverRating' : IDL.Opt(IDL.Nat16),
@@ -180,6 +184,7 @@ export const idlFactory = ({ IDL }) => {
     'driverCanister' : IDL.Principal,
     'price' : Money,
     'etaToPickupSec' : IDL.Nat32,
+    'driverPosition' : IDL.Opt(Geo),
     'toPickupMeters' : IDL.Nat32,
     'validUntilNs' : IDL.Nat64,
   });
@@ -241,7 +246,6 @@ export const idlFactory = ({ IDL }) => {
   });
   const Result_4 = IDL.Variant({ 'ok' : WorkerStatus, 'err' : Error });
   const Result_3 = IDL.Variant({ 'ok' : IDL.Nat, 'err' : Error });
-  const Geo = IDL.Record({ 'lat' : IDL.Float64, 'lng' : IDL.Float64 });
   const HasSimulatedDriversArgs = IDL.Record({ 'center' : Geo });
   const TestLoadArgs = IDL.Record({
     'reportLevel' : IDL.Opt(IDL.Nat),
@@ -290,23 +294,26 @@ export const idlFactory = ({ IDL }) => {
     'requestId' : RequestId,
     'rideMeters' : IDL.Nat32,
     'rideSec' : IDL.Nat32,
+    'routeLine' : IDL.Opt(RouteLine),
     'driverKey' : DriverKey,
     'price' : Money,
     'etaToPickupSec' : IDL.Nat32,
+    'driverPosition' : IDL.Opt(Geo),
     'toPickupMeters' : IDL.Nat32,
     'validUntilNs' : IDL.Nat64,
   });
   const TigiWorker = IDL.Service({
     'answerOrder' : IDL.Func([OrderAnswer], [ProtocolResult], []),
     'applyCoreChanges' : IDL.Func([CoreChanges], [Result], []),
-    'chooseOffer' : IDL.Func([OfferRef], [Result_8], []),
+    'chooseOffer' : IDL.Func([OfferRef], [Result_9], []),
     'clearLogs' : IDL.Func([], [], []),
     'closeRequest' : IDL.Func([CloseRequestArgs], [Result_2], []),
-    'configure' : IDL.Func([ConfigureArgs], [Result_7], []),
+    'configure' : IDL.Func([ConfigureArgs], [Result_8], []),
     'declineQuote' : IDL.Func([QuoteDecline], [], []),
     'getCoreCopyStatus' : IDL.Func([], [CoreCopyStatus], ['query']),
-    'getFlowStatus' : IDL.Func([], [Result_6], ['query']),
+    'getFlowStatus' : IDL.Func([], [Result_7], ['query']),
     'getLogs' : IDL.Func([], [IDL.Text], ['query']),
+    'getOfferRoute' : IDL.Func([OfferRef], [Result_6], ['query']),
     'getPrefixCounts' : IDL.Func([IDL.Nat], [Result_5], ['query']),
     'getRequest' : IDL.Func([RequestRef], [Result_1], ['query']),
     'getStatus' : IDL.Func([], [Result_4], ['query']),