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

package/declarations/core/core.did.js

@@ -61,7 +61,7 @@ export const idlFactory = ({ IDL }) => {
     'installedAtNs' : IDL.Opt(IDL.Int),
     'leaseUntilNs' : IDL.Opt(IDL.Int),
   });
-  const Result_16 = IDL.Variant({ 'ok' : DriverCanister, 'err' : Error });
+  const Result_20 = IDL.Variant({ 'ok' : DriverCanister, 'err' : Error });
   const BlockDriverArgs = IDL.Record({
     'driverKey' : IDL.Opt(IDL.Text),
     'canister' : IDL.Principal,
@@ -71,6 +71,10 @@ export const idlFactory = ({ IDL }) => {
     'rider' : IDL.Principal,
     'reason' : IDL.Text,
   });
+  const ClaimArgs = IDL.Record({
+    'code' : IDL.Text,
+    'canister' : IDL.Principal,
+  });
   const WasmKind = IDL.Variant({ 'simulator' : IDL.Null, 'driver' : IDL.Null });
   const WasmCommitArgs = IDL.Record({
     'sha256' : IDL.Vec(IDL.Nat8),
@@ -83,9 +87,9 @@ export const idlFactory = ({ IDL }) => {
     'size' : IDL.Nat,
     'committedAtNs' : IDL.Int,
   });
-  const Result_22 = IDL.Variant({ 'ok' : WasmInfo, 'err' : Error });
-  const Result_21 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
-  const Result_20 = IDL.Variant({
+  const Result_29 = IDL.Variant({ 'ok' : WasmInfo, 'err' : Error });
+  const Result_28 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
+  const Result_27 = IDL.Variant({
     'ok' : IDL.Vec(IDL.Principal),
     'err' : Error,
   });
@@ -101,13 +105,46 @@ export const idlFactory = ({ IDL }) => {
     'pendingSinceNs' : IDL.Opt(IDL.Int),
     'rooms' : IDL.Nat,
   });
-  const Result_19 = IDL.Variant({ 'ok' : ChatRoomsStatus, 'err' : Error });
+  const Result_26 = IDL.Variant({ 'ok' : ChatRoomsStatus, 'err' : Error });
   const DriverCanisterStatus = IDL.Record({
     'moduleHash' : IDL.Opt(IDL.Vec(IDL.Nat8)),
     'blocked' : IDL.Bool,
     'registered' : IDL.Bool,
   });
-  const Result_18 = IDL.Variant({ 'ok' : IDL.Opt(RolloutView), 'err' : Error });
+  const FeeUsage = IDL.Record({
+    'quoteRequests' : IDL.Nat,
+    'registrations' : IDL.Nat,
+    'rides' : IDL.Nat,
+  });
+  const FeeRates = IDL.Record({
+    'perRegistration' : IDL.Nat,
+    'perQuoteRequest' : IDL.Nat,
+    'perRide' : IDL.Nat,
+  });
+  const FeeBill = IDL.Record({
+    'day' : IDL.Nat,
+    'settled' : IDL.Bool,
+    'usage' : FeeUsage,
+    'amount' : IDL.Nat,
+    'multiplierPermille' : IDL.Nat,
+    'rates' : FeeRates,
+  });
+  const FeeRecord = IDL.Record({
+    'day' : IDL.Nat,
+    'paidAtNs' : IDL.Int,
+    'amount' : IDL.Nat,
+  });
+  const DriverFeeAccountView = IDL.Record({
+    'pending' : FeeUsage,
+    'bill' : IDL.Opt(FeeBill),
+    'lastSettledDay' : IDL.Opt(IDL.Nat),
+    'canister' : IDL.Principal,
+    'paidTotal' : IDL.Nat,
+    'lastFee' : IDL.Opt(FeeRecord),
+  });
+  const Result_25 = IDL.Variant({ 'ok' : DriverFeeAccountView, 'err' : Error });
+  const Result_24 = IDL.Variant({ 'ok' : FeeBill, 'err' : Error });
+  const Result_23 = IDL.Variant({ 'ok' : IDL.Opt(RolloutView), 'err' : Error });
   const FactoryStatus = IDL.Record({
     'simulator' : IDL.Opt(IDL.Principal),
     'mode' : Mode,
@@ -119,7 +156,20 @@ export const idlFactory = ({ IDL }) => {
     'driverWasm' : IDL.Opt(WasmInfo),
     'registered' : IDL.Nat,
   });
-  const Result_17 = IDL.Variant({ 'ok' : FactoryStatus, 'err' : Error });
+  const Result_22 = IDL.Variant({ 'ok' : FactoryStatus, 'err' : Error });
+  const FeeStatus = IDL.Record({
+    'multiplier' : IDL.Opt(
+      IDL.Record({ 'day' : IDL.Nat, 'permille' : IDL.Nat })
+    ),
+    'today' : IDL.Nat,
+    'toForward' : IDL.Nat,
+    'forwardedTotal' : IDL.Nat,
+    'lastForwardError' : IDL.Opt(IDL.Text),
+    'accounts' : IDL.Nat,
+    'paidTotal' : IDL.Nat,
+    'rates' : FeeRates,
+  });
+  const Result_21 = IDL.Variant({ 'ok' : FeeStatus, 'err' : Error });
   const Profile = IDL.Record({
     'updatedAtNs' : IDL.Int,
     'name' : IDL.Text,
@@ -127,7 +177,7 @@ export const idlFactory = ({ IDL }) => {
   });
   const Result_4 = IDL.Variant({ 'ok' : Profile, 'err' : Error });
   const Rating = IDL.Record({ 'sum' : IDL.Nat, 'count' : IDL.Nat });
-  const Result_15 = IDL.Variant({ 'ok' : IDL.Opt(Rating), 'err' : Error });
+  const Result_19 = IDL.Variant({ 'ok' : IDL.Opt(Rating), 'err' : Error });
   const RidesPageArgs = IDL.Record({
     'beforeIndex' : IDL.Opt(IDL.Nat),
     'limit' : IDL.Nat,
@@ -151,13 +201,13 @@ export const idlFactory = ({ IDL }) => {
     'nextBeforeIndex' : IDL.Opt(IDL.Nat),
     'rides' : IDL.Vec(RideEntry),
   });
-  const Result_14 = IDL.Variant({ 'ok' : RidesPage, 'err' : Error });
+  const Result_18 = IDL.Variant({ 'ok' : RidesPage, 'err' : Error });
   const ProfilesArgs = IDL.Record({ 'principals' : IDL.Vec(IDL.Principal) });
   const ProfileEntry = IDL.Record({
     'principal' : IDL.Principal,
     'name' : IDL.Text,
   });
-  const Result_13 = IDL.Variant({
+  const Result_17 = IDL.Variant({
     'ok' : IDL.Vec(ProfileEntry),
     'err' : Error,
   });
@@ -171,8 +221,8 @@ export const idlFactory = ({ IDL }) => {
     'knownWorkers' : IDL.Vec(IDL.Principal),
     'coordinator' : IDL.Opt(IDL.Principal),
   });
-  const Result_12 = IDL.Variant({ 'ok' : Wiring, 'err' : Error });
-  const Result_11 = IDL.Variant({
+  const Result_16 = IDL.Variant({ 'ok' : Wiring, 'err' : Error });
+  const Result_15 = IDL.Variant({
     'ok' : IDL.Record({
       'subjects' : IDL.Nat,
       'headSeq' : IDL.Nat64,
@@ -193,8 +243,19 @@ export const idlFactory = ({ IDL }) => {
     'driverCanister' : IDL.Principal,
     'rider' : IDL.Principal,
   });
+  const DriverUsage = IDL.Record({
+    'quoteRequests' : IDL.Nat,
+    'canister' : IDL.Principal,
+    'registrations' : IDL.Nat,
+    'rides' : IDL.Nat,
+  });
+  const UsageBatch = IDL.Record({
+    'entries' : IDL.Vec(DriverUsage),
+    'batchId' : IDL.Nat64,
+  });
   const RideBatch = IDL.Record({
     'ratings' : IDL.Vec(RatingEntry),
+    'usage' : IDL.Opt(UsageBatch),
     'rides' : IDL.Vec(RideEntry),
   });
   const RideBatchResult = IDL.Record({
@@ -203,12 +264,28 @@ export const idlFactory = ({ IDL }) => {
     'rejected' : IDL.Nat,
     'ratingsCounted' : IDL.Nat,
   });
-  const Result_10 = IDL.Variant({ 'ok' : RideBatchResult, 'err' : Error });
+  const Result_14 = IDL.Variant({ 'ok' : RideBatchResult, 'err' : Error });
+  const ClaimCode = IDL.Record({
+    'expiresAtNs' : IDL.Int,
+    'code' : IDL.Text,
+    'canister' : IDL.Principal,
+  });
+  const LeasedCanister = IDL.Record({
+    'moduleHash' : IDL.Opt(IDL.Vec(IDL.Nat8)),
+    'owner' : IDL.Principal,
+    'blocked' : IDL.Bool,
+    'kind' : DriverCanisterKind,
+    'claim' : IDL.Opt(ClaimCode),
+    'createdAtNs' : IDL.Int,
+    'canister' : IDL.Principal,
+    'installedAtNs' : IDL.Opt(IDL.Int),
+    'leaseUntilNs' : IDL.Opt(IDL.Int),
+  });
   const LeaseAnswer = IDL.Variant({
     'busy' : IDL.Record({ 'untilNs' : IDL.Int }),
-    'leased' : DriverCanister,
+    'leased' : LeasedCanister,
   });
-  const Result_9 = IDL.Variant({ 'ok' : LeaseAnswer, 'err' : Error });
+  const Result_13 = IDL.Variant({ 'ok' : LeaseAnswer, 'err' : Error });
   const PageArgs = IDL.Record({ 'offset' : IDL.Nat, 'limit' : IDL.Nat });
   const BlockTarget = IDL.Variant({
     'driverCanister' : IDL.Principal,
@@ -224,12 +301,16 @@ export const idlFactory = ({ IDL }) => {
     'target' : BlockTarget,
     'reason' : IDL.Text,
   });
-  const Result_8 = IDL.Variant({ 'ok' : IDL.Vec(Block), 'err' : Error });
+  const Result_12 = IDL.Variant({ 'ok' : IDL.Vec(Block), 'err' : Error });
   const DriverCanistersPage = IDL.Record({
     'total' : IDL.Nat,
     'canisters' : IDL.Vec(DriverCanister),
   });
-  const Result_7 = IDL.Variant({ 'ok' : DriverCanistersPage, 'err' : Error });
+  const Result_11 = IDL.Variant({ 'ok' : DriverCanistersPage, 'err' : Error });
+  const Result_10 = IDL.Variant({
+    'ok' : IDL.Vec(DriverFeeAccountView),
+    'err' : Error,
+  });
   const DriverRoomView = IDL.Record({
     'recipient' : IDL.Principal,
     'driverKey' : IDL.Text,
@@ -238,12 +319,25 @@ export const idlFactory = ({ IDL }) => {
     'roomId' : IDL.Text,
     'synced' : IDL.Bool,
   });
-  const Result_6 = IDL.Variant({
+  const Result_9 = IDL.Variant({
     'ok' : IDL.Vec(DriverRoomView),
     'err' : Error,
   });
-  const Result_5 = IDL.Variant({ 'ok' : ChatConfig, 'err' : Error });
+  const Result_8 = IDL.Variant({ 'ok' : ClaimCode, 'err' : Error });
+  const FeePayArgs = IDL.Record({ 'day' : IDL.Nat });
+  const FeePaid = IDL.Record({
+    'day' : IDL.Nat,
+    'accepted' : IDL.Nat,
+    'amount' : IDL.Nat,
+  });
+  const Result_7 = IDL.Variant({ 'ok' : FeePaid, 'err' : Error });
+  const Result_6 = IDL.Variant({ 'ok' : ChatConfig, 'err' : Error });
+  const ClaimTtlArgs = IDL.Record({ 'seconds' : IDL.Nat });
+  const Result = IDL.Variant({ 'ok' : IDL.Nat, 'err' : Error });
+  const Result_5 = IDL.Variant({ 'ok' : FeeRates, 'err' : Error });
   const SetProfileArgs = IDL.Record({ 'name' : IDL.Text });
+  const SimulatorRouterArgs = IDL.Record({ 'router' : IDL.Opt(IDL.Principal) });
+  const TestDayArgs = IDL.Record({ 'days' : IDL.Nat });
   const UnblockDriverArgs = IDL.Record({
     'driverKey' : IDL.Opt(IDL.Text),
     'canister' : IDL.Principal,
@@ -255,52 +349,62 @@ export const idlFactory = ({ IDL }) => {
     'bytes' : IDL.Vec(IDL.Nat8),
     'index' : IDL.Nat32,
   });
-  const Result = IDL.Variant({ 'ok' : IDL.Nat, 'err' : Error });
   const TigiCore = IDL.Service({
     'abortDriverRollout' : IDL.Func([], [Result_3], []),
     'addAdmin' : IDL.Func([PrincipalArgs], [Result_2], []),
-    'addPoolCanister' : IDL.Func([CanisterArgs], [Result_16], []),
+    'addPoolCanister' : IDL.Func([CanisterArgs], [Result_20], []),
     'blockDriver' : IDL.Func([BlockDriverArgs], [Result_2], []),
     'blockRider' : IDL.Func([BlockRiderArgs], [Result_2], []),
+    'claimDriverCanister' : IDL.Func([ClaimArgs], [Result_20], []),
     'clearLogs' : IDL.Func([], [], []),
-    'commitDriverWasm' : IDL.Func([WasmCommitArgs], [Result_22], []),
-    'createLocalPoolCanister' : IDL.Func([], [Result_16], []),
-    'createMyDriverCanister' : IDL.Func([], [Result_16], []),
-    'ensureSimulator' : IDL.Func([], [Result_21], []),
-    'extendDemoLease' : IDL.Func([], [Result_16], []),
-    'getAdmins' : IDL.Func([], [Result_20], ['query']),
+    'commitDriverWasm' : IDL.Func([WasmCommitArgs], [Result_29], []),
+    'createLocalPoolCanister' : IDL.Func([], [Result_20], []),
+    'createMyDriverCanister' : IDL.Func([], [Result_20], []),
+    'ensureSimulator' : IDL.Func([], [Result_28], []),
+    'extendDemoLease' : IDL.Func([], [Result_20], []),
+    'getAdmins' : IDL.Func([], [Result_27], ['query']),
     'getChatConfig' : IDL.Func([], [IDL.Opt(ChatConfig)], ['query']),
-    'getChatRoomsStatus' : IDL.Func([], [Result_19], ['query']),
+    'getChatRoomsStatus' : IDL.Func([], [Result_26], ['query']),
     'getDriverCanisterStatus' : IDL.Func(
         [CanisterArgs],
         [DriverCanisterStatus],
         ['query'],
       ),
-    'getDriverRollout' : IDL.Func([], [Result_18], ['query']),
-    'getFactoryStatus' : IDL.Func([], [Result_17], ['query']),
+    'getDriverFeeAccount' : IDL.Func([CanisterArgs], [Result_25], ['query']),
+    'getDriverFeeBill' : IDL.Func([], [Result_24], []),
+    'getDriverRollout' : IDL.Func([], [Result_23], ['query']),
+    'getFactoryStatus' : IDL.Func([], [Result_22], ['query']),
+    'getFeeStatus' : IDL.Func([], [Result_21], ['query']),
     'getLogs' : IDL.Func([], [IDL.Text], ['query']),
-    'getMyDriverCanister' : IDL.Func([], [Result_16], ['query']),
+    'getMyDriverCanister' : IDL.Func([], [Result_20], ['query']),
     'getMyProfile' : IDL.Func([], [Result_4], ['query']),
-    'getMyRating' : IDL.Func([], [Result_15], ['query']),
-    'getMyRides' : IDL.Func([RidesPageArgs], [Result_14], ['query']),
-    'getProfiles' : IDL.Func([ProfilesArgs], [Result_13], ['query']),
+    'getMyRating' : IDL.Func([], [Result_19], ['query']),
+    'getMyRides' : IDL.Func([RidesPageArgs], [Result_18], ['query']),
+    'getProfiles' : IDL.Func([ProfilesArgs], [Result_17], ['query']),
     'getReleasedDriverWasms' : IDL.Func([], [IDL.Vec(ReleasedWasm)], ['query']),
     'getSimulator' : IDL.Func([], [IDL.Opt(IDL.Principal)], ['query']),
-    'getWiring' : IDL.Func([], [Result_12], ['query']),
-    'getWorkerOutbox' : IDL.Func([], [Result_11], ['query']),
+    'getWiring' : IDL.Func([], [Result_16], ['query']),
+    'getWorkerOutbox' : IDL.Func([], [Result_15], ['query']),
     'helloFromWorker' : IDL.Func([], [Result_2], []),
-    'ingestRideBatch' : IDL.Func([RideBatch], [Result_10], []),
+    'ingestRideBatch' : IDL.Func([RideBatch], [Result_14], []),
     'isUser' : IDL.Func([IDL.Principal], [IDL.Bool], ['query']),
-    'leaseDemoDriverCanister' : IDL.Func([], [Result_9], []),
-    'listBlocks' : IDL.Func([PageArgs], [Result_8], ['query']),
-    'listDriverCanisters' : IDL.Func([PageArgs], [Result_7], ['query']),
-    'listDriverRooms' : IDL.Func([PageArgs], [Result_6], ['query']),
+    'leaseDemoDriverCanister' : IDL.Func([], [Result_13], []),
+    'listBlocks' : IDL.Func([PageArgs], [Result_12], ['query']),
+    'listDriverCanisters' : IDL.Func([PageArgs], [Result_11], ['query']),
+    'listDriverFeeAccounts' : IDL.Func([PageArgs], [Result_10], ['query']),
+    'listDriverRooms' : IDL.Func([PageArgs], [Result_9], ['query']),
+    'newClaimCode' : IDL.Func([], [Result_8], []),
+    'payDriverFee' : IDL.Func([FeePayArgs], [Result_7], []),
     'removeAdmin' : IDL.Func([PrincipalArgs], [Result_2], []),
     'resumeDriverRollout' : IDL.Func([], [Result_3], []),
-    'setChatConfig' : IDL.Func([ChatConfig], [Result_5], []),
+    'setChatConfig' : IDL.Func([ChatConfig], [Result_6], []),
+    'setClaimCodeTtl' : IDL.Func([ClaimTtlArgs], [Result], []),
+    'setFeeRates' : IDL.Func([FeeRates], [Result_5], []),
     'setLoggingEnabled' : IDL.Func([IDL.Bool], [Result_2], []),
     'setLowCyclesBelow' : IDL.Func([IDL.Nat], [Result_2], []),
     'setMyProfile' : IDL.Func([SetProfileArgs], [Result_4], []),
+    'setSimulatorRouter' : IDL.Func([SimulatorRouterArgs], [Result_2], []),
+    'setTestDayOffset' : IDL.Func([TestDayArgs], [Result], []),
     'startDriverRollout' : IDL.Func([], [Result_3], []),
     'unblockDriver' : IDL.Func([UnblockDriverArgs], [Result_2], []),
     'unblockRider' : IDL.Func([UnblockRiderArgs], [Result_2], []),

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[];