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

package/declarations/core/core.did.js

@@ -46,6 +46,22 @@ export const idlFactory = ({ IDL }) => {
   const Result_3 = IDL.Variant({ 'ok' : RolloutView, 'err' : Error });
   const PrincipalArgs = IDL.Record({ 'principal' : IDL.Principal });
   const Result_2 = IDL.Variant({ 'ok' : IDL.Bool, 'err' : Error });
+  const ChatShare = IDL.Record({ 'cycles' : IDL.Nat, 'roomId' : IDL.Text });
+  const ChatSharesArgs = IDL.Record({
+    'day' : IDL.Nat64,
+    'shares' : IDL.Vec(ChatShare),
+    'batchId' : IDL.Nat64,
+  });
+  const ChatSharesAck = IDL.Record({
+    'added' : IDL.Nat,
+    'unknownCycles' : IDL.Nat,
+    'applied' : IDL.Bool,
+    'exemptCycles' : IDL.Nat,
+    'exempt' : IDL.Nat,
+    'addedCycles' : IDL.Nat,
+    'unknown' : IDL.Nat,
+  });
+  const Result_32 = IDL.Variant({ 'ok' : ChatSharesAck, 'err' : Error });
   const CanisterArgs = IDL.Record({ 'canister' : IDL.Principal });
   const DriverCanisterKind = IDL.Variant({
     'own' : IDL.Null,
@@ -61,7 +77,7 @@ export const idlFactory = ({ IDL }) => {
     'installedAtNs' : IDL.Opt(IDL.Int),
     'leaseUntilNs' : IDL.Opt(IDL.Int),
   });
-  const Result_20 = IDL.Variant({ 'ok' : DriverCanister, 'err' : Error });
+  const Result_6 = IDL.Variant({ 'ok' : DriverCanister, 'err' : Error });
   const BlockDriverArgs = IDL.Record({
     'driverKey' : IDL.Opt(IDL.Text),
     'canister' : IDL.Principal,
@@ -87,9 +103,9 @@ export const idlFactory = ({ IDL }) => {
     'size' : IDL.Nat,
     'committedAtNs' : IDL.Int,
   });
-  const Result_29 = IDL.Variant({ 'ok' : WasmInfo, 'err' : Error });
-  const Result_28 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
-  const Result_27 = IDL.Variant({
+  const Result_31 = IDL.Variant({ 'ok' : WasmInfo, 'err' : Error });
+  const Result_30 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
+  const Result_29 = IDL.Variant({
     'ok' : IDL.Vec(IDL.Principal),
     'err' : Error,
   });
@@ -105,7 +121,7 @@ export const idlFactory = ({ IDL }) => {
     'pendingSinceNs' : IDL.Opt(IDL.Int),
     'rooms' : IDL.Nat,
   });
-  const Result_26 = IDL.Variant({ 'ok' : ChatRoomsStatus, 'err' : Error });
+  const Result_28 = IDL.Variant({ 'ok' : ChatRoomsStatus, 'err' : Error });
   const DriverCanisterStatus = IDL.Record({
     'moduleHash' : IDL.Opt(IDL.Vec(IDL.Nat8)),
     'blocked' : IDL.Bool,
@@ -129,6 +145,12 @@ export const idlFactory = ({ IDL }) => {
     'multiplierPermille' : IDL.Nat,
     'rates' : FeeRates,
   });
+  const ChatShareView = IDL.Record({
+    'pending' : IDL.Nat,
+    'inBill' : IDL.Nat,
+    'paidTotal' : IDL.Nat,
+    'lastDay' : IDL.Opt(IDL.Nat),
+  });
   const FeeRecord = IDL.Record({
     'day' : IDL.Nat,
     'paidAtNs' : IDL.Int,
@@ -137,14 +159,30 @@ export const idlFactory = ({ IDL }) => {
   const DriverFeeAccountView = IDL.Record({
     'pending' : FeeUsage,
     'bill' : IDL.Opt(FeeBill),
+    'chat' : IDL.Opt(ChatShareView),
     '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 Result_27 = IDL.Variant({ 'ok' : DriverFeeAccountView, 'err' : Error });
+  const FeeBillAnswer = IDL.Record({
+    'day' : IDL.Nat,
+    'settled' : IDL.Bool,
+    'chat' : IDL.Opt(IDL.Nat),
+    'usage' : FeeUsage,
+    'amount' : IDL.Nat,
+    'multiplierPermille' : IDL.Nat,
+    'rates' : FeeRates,
+  });
+  const Result_26 = IDL.Variant({ 'ok' : FeeBillAnswer, 'err' : Error });
+  const DriverRatingArgs = IDL.Record({
+    'driverKey' : IDL.Text,
+    'canister' : IDL.Principal,
+  });
+  const Rating = IDL.Record({ 'sum' : IDL.Nat, 'count' : IDL.Nat });
+  const Result_22 = IDL.Variant({ 'ok' : IDL.Opt(Rating), 'err' : Error });
+  const Result_25 = IDL.Variant({ 'ok' : IDL.Opt(RolloutView), 'err' : Error });
   const FactoryStatus = IDL.Record({
     'simulator' : IDL.Opt(IDL.Principal),
     'mode' : Mode,
@@ -156,7 +194,7 @@ export const idlFactory = ({ IDL }) => {
     'driverWasm' : IDL.Opt(WasmInfo),
     'registered' : IDL.Nat,
   });
-  const Result_22 = IDL.Variant({ 'ok' : FactoryStatus, 'err' : Error });
+  const Result_24 = IDL.Variant({ 'ok' : FactoryStatus, 'err' : Error });
   const FeeStatus = IDL.Record({
     'multiplier' : IDL.Opt(
       IDL.Record({ 'day' : IDL.Nat, 'permille' : IDL.Nat })
@@ -164,50 +202,62 @@ export const idlFactory = ({ IDL }) => {
     'today' : IDL.Nat,
     'toForward' : IDL.Nat,
     'forwardedTotal' : IDL.Nat,
+    'chat' : IDL.Opt(
+      IDL.Record({
+        'lastBatchId' : IDL.Opt(IDL.Nat64),
+        'addedTotal' : IDL.Nat,
+        'absorbedTotal' : 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 Result_23 = IDL.Variant({ 'ok' : FeeStatus, 'err' : Error });
   const Profile = IDL.Record({
     'updatedAtNs' : IDL.Int,
     'name' : IDL.Text,
     'createdAtNs' : IDL.Int,
   });
   const Result_4 = IDL.Variant({ 'ok' : Profile, 'err' : Error });
-  const Rating = IDL.Record({ 'sum' : IDL.Nat, 'count' : IDL.Nat });
-  const Result_19 = IDL.Variant({ 'ok' : IDL.Opt(Rating), 'err' : Error });
-  const RidesPageArgs = IDL.Record({
-    'beforeIndex' : IDL.Opt(IDL.Nat),
-    'limit' : IDL.Nat,
-  });
+  const RequestIdArgs = IDL.Record({ 'requestId' : IDL.Text });
   const RideEnd = IDL.Variant({
     'completed' : IDL.Null,
     'cancelledByRider' : IDL.Null,
     'cancelledByDriver' : IDL.Null,
   });
+  const Geo = IDL.Record({ 'lat' : IDL.Float64, 'lng' : IDL.Float64 });
   const Money = IDL.Record({ 'currency' : IDL.Text, 'amount' : IDL.Nat64 });
-  const RideEntry = IDL.Record({
+  const RideView = IDL.Record({
     'end' : RideEnd,
+    'destination' : IDL.Opt(Geo),
     'requestId' : IDL.Text,
     'endedAtNs' : IDL.Nat64,
+    'ratable' : IDL.Opt(IDL.Bool),
+    'pickup' : IDL.Opt(Geo),
     'driverKey' : IDL.Text,
     'driverCanister' : IDL.Principal,
     'price' : IDL.Opt(Money),
     'rider' : IDL.Principal,
+    'myRating' : IDL.Opt(IDL.Nat8),
+  });
+  const Result_21 = IDL.Variant({ 'ok' : RideView, 'err' : Error });
+  const RidesPageArgs = IDL.Record({
+    'beforeIndex' : IDL.Opt(IDL.Nat),
+    'limit' : IDL.Nat,
   });
   const RidesPage = IDL.Record({
     'nextBeforeIndex' : IDL.Opt(IDL.Nat),
-    'rides' : IDL.Vec(RideEntry),
+    'rides' : IDL.Vec(RideView),
   });
-  const Result_18 = IDL.Variant({ 'ok' : RidesPage, 'err' : Error });
+  const Result_20 = 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_17 = IDL.Variant({
+  const Result_19 = IDL.Variant({
     'ok' : IDL.Vec(ProfileEntry),
     'err' : Error,
   });
@@ -221,8 +271,8 @@ export const idlFactory = ({ IDL }) => {
     'knownWorkers' : IDL.Vec(IDL.Principal),
     'coordinator' : IDL.Opt(IDL.Principal),
   });
-  const Result_16 = IDL.Variant({ 'ok' : Wiring, 'err' : Error });
-  const Result_15 = IDL.Variant({
+  const Result_18 = IDL.Variant({ 'ok' : Wiring, 'err' : Error });
+  const Result_17 = IDL.Variant({
     'ok' : IDL.Record({
       'subjects' : IDL.Nat,
       'headSeq' : IDL.Nat64,
@@ -253,10 +303,21 @@ export const idlFactory = ({ IDL }) => {
     'entries' : IDL.Vec(DriverUsage),
     'batchId' : IDL.Nat64,
   });
+  const RideEntryIn = IDL.Record({
+    'end' : RideEnd,
+    'destination' : IDL.Opt(Geo),
+    'requestId' : IDL.Text,
+    'endedAtNs' : IDL.Nat64,
+    'pickup' : IDL.Opt(Geo),
+    'driverKey' : IDL.Text,
+    'driverCanister' : IDL.Principal,
+    'price' : IDL.Opt(Money),
+    'rider' : IDL.Principal,
+  });
   const RideBatch = IDL.Record({
     'ratings' : IDL.Vec(RatingEntry),
     'usage' : IDL.Opt(UsageBatch),
-    'rides' : IDL.Vec(RideEntry),
+    'rides' : IDL.Vec(RideEntryIn),
   });
   const RideBatchResult = IDL.Record({
     'duplicates' : IDL.Nat,
@@ -264,7 +325,7 @@ export const idlFactory = ({ IDL }) => {
     'rejected' : IDL.Nat,
     'ratingsCounted' : IDL.Nat,
   });
-  const Result_14 = IDL.Variant({ 'ok' : RideBatchResult, 'err' : Error });
+  const Result_16 = IDL.Variant({ 'ok' : RideBatchResult, 'err' : Error });
   const ClaimCode = IDL.Record({
     'expiresAtNs' : IDL.Int,
     'code' : IDL.Text,
@@ -285,7 +346,7 @@ export const idlFactory = ({ IDL }) => {
     'busy' : IDL.Record({ 'untilNs' : IDL.Int }),
     'leased' : LeasedCanister,
   });
-  const Result_13 = IDL.Variant({ 'ok' : LeaseAnswer, 'err' : Error });
+  const Result_15 = IDL.Variant({ 'ok' : LeaseAnswer, 'err' : Error });
   const PageArgs = IDL.Record({ 'offset' : IDL.Nat, 'limit' : IDL.Nat });
   const BlockTarget = IDL.Variant({
     'driverCanister' : IDL.Principal,
@@ -301,13 +362,13 @@ export const idlFactory = ({ IDL }) => {
     'target' : BlockTarget,
     'reason' : IDL.Text,
   });
-  const Result_12 = IDL.Variant({ 'ok' : IDL.Vec(Block), 'err' : Error });
+  const Result_14 = IDL.Variant({ 'ok' : IDL.Vec(Block), 'err' : Error });
   const DriverCanistersPage = IDL.Record({
     'total' : IDL.Nat,
     'canisters' : IDL.Vec(DriverCanister),
   });
-  const Result_11 = IDL.Variant({ 'ok' : DriverCanistersPage, 'err' : Error });
-  const Result_10 = IDL.Variant({
+  const Result_13 = IDL.Variant({ 'ok' : DriverCanistersPage, 'err' : Error });
+  const Result_12 = IDL.Variant({
     'ok' : IDL.Vec(DriverFeeAccountView),
     'err' : Error,
   });
@@ -319,21 +380,35 @@ export const idlFactory = ({ IDL }) => {
     'roomId' : IDL.Text,
     'synced' : IDL.Bool,
   });
-  const Result_9 = IDL.Variant({
+  const Result_11 = IDL.Variant({
     'ok' : IDL.Vec(DriverRoomView),
     'err' : Error,
   });
-  const Result_8 = IDL.Variant({ 'ok' : ClaimCode, 'err' : Error });
+  const Result_10 = 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 Result_9 = IDL.Variant({ 'ok' : FeePaid, 'err' : Error });
+  const RateRideArgs = IDL.Record({
+    'requestId' : IDL.Text,
+    'stars' : IDL.Nat8,
+  });
+  const RateRideOutcome = IDL.Variant({
+    'notRatable' : IDL.Text,
+    'rated' : IDL.Null,
+    'alreadyRated' : IDL.Null,
+  });
+  const Result_8 = IDL.Variant({ 'ok' : RateRideOutcome, 'err' : Error });
+  const Result_7 = IDL.Variant({ 'ok' : ChatConfig, 'err' : Error });
   const ClaimTtlArgs = IDL.Record({ 'seconds' : IDL.Nat });
   const Result = IDL.Variant({ 'ok' : IDL.Nat, 'err' : Error });
+  const DemoAutomatArgs = IDL.Record({
+    'canister' : IDL.Principal,
+    'automat' : IDL.Principal,
+  });
   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) });
@@ -352,53 +427,58 @@ export const idlFactory = ({ IDL }) => {
   const TigiCore = IDL.Service({
     'abortDriverRollout' : IDL.Func([], [Result_3], []),
     'addAdmin' : IDL.Func([PrincipalArgs], [Result_2], []),
-    'addPoolCanister' : IDL.Func([CanisterArgs], [Result_20], []),
+    'addChatShares' : IDL.Func([ChatSharesArgs], [Result_32], []),
+    'addPoolCanister' : IDL.Func([CanisterArgs], [Result_6], []),
     'blockDriver' : IDL.Func([BlockDriverArgs], [Result_2], []),
     'blockRider' : IDL.Func([BlockRiderArgs], [Result_2], []),
-    'claimDriverCanister' : IDL.Func([ClaimArgs], [Result_20], []),
+    'claimDriverCanister' : IDL.Func([ClaimArgs], [Result_6], []),
     'clearLogs' : IDL.Func([], [], []),
-    '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']),
+    'commitDriverWasm' : IDL.Func([WasmCommitArgs], [Result_31], []),
+    'createLocalPoolCanister' : IDL.Func([], [Result_6], []),
+    'createMyDriverCanister' : IDL.Func([], [Result_6], []),
+    'ensureSimulator' : IDL.Func([], [Result_30], []),
+    'extendDemoLease' : IDL.Func([], [Result_6], []),
+    'getAdmins' : IDL.Func([], [Result_29], ['query']),
     'getChatConfig' : IDL.Func([], [IDL.Opt(ChatConfig)], ['query']),
-    'getChatRoomsStatus' : IDL.Func([], [Result_26], ['query']),
+    'getChatRoomsStatus' : IDL.Func([], [Result_28], ['query']),
     'getDriverCanisterStatus' : IDL.Func(
         [CanisterArgs],
         [DriverCanisterStatus],
         ['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']),
+    'getDriverFeeAccount' : IDL.Func([CanisterArgs], [Result_27], ['query']),
+    'getDriverFeeBill' : IDL.Func([], [Result_26], []),
+    'getDriverRating' : IDL.Func([DriverRatingArgs], [Result_22], ['query']),
+    'getDriverRollout' : IDL.Func([], [Result_25], ['query']),
+    'getFactoryStatus' : IDL.Func([], [Result_24], ['query']),
+    'getFeeStatus' : IDL.Func([], [Result_23], ['query']),
     'getLogs' : IDL.Func([], [IDL.Text], ['query']),
-    'getMyDriverCanister' : IDL.Func([], [Result_20], ['query']),
+    'getMyDriverCanister' : IDL.Func([], [Result_6], ['query']),
     'getMyProfile' : IDL.Func([], [Result_4], ['query']),
-    'getMyRating' : IDL.Func([], [Result_19], ['query']),
-    'getMyRides' : IDL.Func([RidesPageArgs], [Result_18], ['query']),
-    'getProfiles' : IDL.Func([ProfilesArgs], [Result_17], ['query']),
+    'getMyRating' : IDL.Func([], [Result_22], ['query']),
+    'getMyRide' : IDL.Func([RequestIdArgs], [Result_21], ['query']),
+    'getMyRides' : IDL.Func([RidesPageArgs], [Result_20], ['query']),
+    'getProfiles' : IDL.Func([ProfilesArgs], [Result_19], ['query']),
     'getReleasedDriverWasms' : IDL.Func([], [IDL.Vec(ReleasedWasm)], ['query']),
     'getSimulator' : IDL.Func([], [IDL.Opt(IDL.Principal)], ['query']),
-    'getWiring' : IDL.Func([], [Result_16], ['query']),
-    'getWorkerOutbox' : IDL.Func([], [Result_15], ['query']),
+    'getWiring' : IDL.Func([], [Result_18], ['query']),
+    'getWorkerOutbox' : IDL.Func([], [Result_17], ['query']),
     'helloFromWorker' : IDL.Func([], [Result_2], []),
-    'ingestRideBatch' : IDL.Func([RideBatch], [Result_14], []),
+    'ingestRideBatch' : IDL.Func([RideBatch], [Result_16], []),
     'isUser' : IDL.Func([IDL.Principal], [IDL.Bool], ['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], []),
+    'leaseDemoDriverCanister' : IDL.Func([], [Result_15], []),
+    'listBlocks' : IDL.Func([PageArgs], [Result_14], ['query']),
+    'listDriverCanisters' : IDL.Func([PageArgs], [Result_13], ['query']),
+    'listDriverFeeAccounts' : IDL.Func([PageArgs], [Result_12], ['query']),
+    'listDriverRooms' : IDL.Func([PageArgs], [Result_11], ['query']),
+    'newClaimCode' : IDL.Func([], [Result_10], []),
+    'payDriverFee' : IDL.Func([FeePayArgs], [Result_9], []),
+    'rateMyRide' : IDL.Func([RateRideArgs], [Result_8], []),
     'removeAdmin' : IDL.Func([PrincipalArgs], [Result_2], []),
     'resumeDriverRollout' : IDL.Func([], [Result_3], []),
-    'setChatConfig' : IDL.Func([ChatConfig], [Result_6], []),
+    'setChatConfig' : IDL.Func([ChatConfig], [Result_7], []),
     'setClaimCodeTtl' : IDL.Func([ClaimTtlArgs], [Result], []),
+    'setDemoDriverAutomat' : IDL.Func([DemoAutomatArgs], [Result_6], []),
     'setFeeRates' : IDL.Func([FeeRates], [Result_5], []),
     'setLoggingEnabled' : IDL.Func([IDL.Bool], [Result_2], []),
     'setLowCyclesBelow' : IDL.Func([IDL.Nat], [Result_2], []),

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

@@ -206,9 +206,10 @@ type RequestClosed = record {
   driverKey : text;
   reason : CloseReason;
 };
-type Result = variant { Ok : vec RouteTaskView; Err : SimulatorError };
-type Result_1 = variant { Ok; Err : SimulatorError };
-type Result_2 = variant { Ok : SpawnResult; Err : SimulatorError };
+type Result = variant { Ok : opt SpawnPlace; Err : SimulatorError };
+type Result_1 = variant { Ok : vec RouteTaskView; Err : SimulatorError };
+type Result_2 = variant { Ok; Err : SimulatorError };
+type Result_3 = variant { Ok : SpawnResult; Err : SimulatorError };
 // `variant { ok : RideView; err : ProtocolError }`.
 type RideAnswer = variant { ok : RideView; err : ProtocolError };
 type RideOrder = record {
@@ -296,6 +297,8 @@ type SpawnArgs = record {
   // None = 12.
   count : opt nat8;
 };
+// S-N15: the centre of the last `spawnDrivers` and its time.
+type SpawnPlace = record { center : Geo; atNs : nat64 };
 type SpawnResult = record {
   // Why some were not registered.
   problems : vec text;
@@ -312,12 +315,16 @@ type SpeedUpArgs = record {
 service : (InitArgs) -> {
   // S-14 (KK-33): the rider cancels before `inProgress`, once.
   cancelRide : (RideRef) -> (ProtocolAnswer);
+  // S-N15: where testers last asked for drivers — the router moves the automat driver
+  // canister near it (TIGI-DRIVER-MODES). None until the first search after an install or
+  // an upgrade.
+  getLastSpawn : () -> (Result) query;
   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;
+  // S-N13: the quote requests that wait for a route (at most 10 s each), the oldest first.
+  getRouteTasks : () -> (Result_1) query;
   getStatus : () -> (SimulatorStatus) query;
   http_request : (HttpRequest) -> (HttpResponse) query;
   protocolVersion : () -> (nat32) query;
@@ -330,13 +337,13 @@ service : (InitArgs) -> {
   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);
+  setRouter : (SetRouterArgs) -> (Result_2);
   // S-15: ×10 for one request (`requestId`), not the whole canister.
-  setSpeedUp : (SpeedUpArgs) -> (Result_1);
+  setSpeedUp : (SpeedUpArgs) -> (Result_2);
   // 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_2);
+  spawnDrivers : (SpawnArgs) -> (Result_3);
   // 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);
+  submitRoute : (SimRouteResult) -> (Result_2);
 }

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

@@ -288,11 +288,13 @@ export interface RequestClosed {
   'driverKey' : string,
   'reason' : CloseReason,
 }
-export type Result = { 'Ok' : Array<RouteTaskView> } |
+export type Result = { 'Ok' : [] | [SpawnPlace] } |
   { 'Err' : SimulatorError };
-export type Result_1 = { 'Ok' : null } |
+export type Result_1 = { 'Ok' : Array<RouteTaskView> } |
   { 'Err' : SimulatorError };
-export type Result_2 = { 'Ok' : SpawnResult } |
+export type Result_2 = { 'Ok' : null } |
+  { 'Err' : SimulatorError };
+export type Result_3 = { 'Ok' : SpawnResult } |
   { 'Err' : SimulatorError };
 /**
  * `variant { ok : RideView; err : ProtocolError }`.
@@ -409,6 +411,10 @@ export interface SpawnArgs {
    */
   'count' : [] | [number],
 }
+/**
+ * S-N15: the centre of the last `spawnDrivers` and its time.
+ */
+export interface SpawnPlace { 'center' : Geo, 'atNs' : bigint }
 export interface SpawnResult {
   /**
    * Why some were not registered.
@@ -433,6 +439,12 @@ export interface _SERVICE {
    * S-14 (KK-33): the rider cancels before `inProgress`, once.
    */
   'cancelRide' : ActorMethod<[RideRef], ProtocolAnswer>,
+  /**
+   * S-N15: where testers last asked for drivers — the router moves the automat driver
+   * canister near it (TIGI-DRIVER-MODES). None until the first search after an install or
+   * an upgrade.
+   */
+  'getLastSpawn' : ActorMethod<[], Result>,
   'getLicence' : ActorMethod<[RideRef], LicenceAnswer>,
   'getRide' : ActorMethod<[RideRef], RideAnswer>,
   /**
@@ -440,9 +452,9 @@ export interface _SERVICE {
    */
   'getRideRoute' : ActorMethod<[RideRef], RouteAnswer>,
   /**
-   * S-N13: the quote requests that wait for a route (at most 5 s each), the oldest first.
+   * S-N13: the quote requests that wait for a route (at most 10 s each), the oldest first.
    */
-  'getRouteTasks' : ActorMethod<[], Result>,
+  'getRouteTasks' : ActorMethod<[], Result_1>,
   'getStatus' : ActorMethod<[], SimulatorStatus>,
   'http_request' : ActorMethod<[HttpRequest], HttpResponse>,
   'protocolVersion' : ActorMethod<[], number>,
@@ -463,21 +475,21 @@ export interface _SERVICE {
    * 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>,
+  'setRouter' : ActorMethod<[SetRouterArgs], Result_2>,
   /**
    * S-15: ×10 for one request (`requestId`), not the whole canister.
    */
-  'setSpeedUp' : ActorMethod<[SpeedUpArgs], Result_1>,
+  'setSpeedUp' : ActorMethod<[SpeedUpArgs], Result_2>,
   /**
    * 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_2>,
+  'spawnDrivers' : ActorMethod<[SpawnArgs], Result_3>,
   /**
    * 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>,
+  'submitRoute' : ActorMethod<[SimRouteResult], Result_2>,
 }
 export declare const idlFactory: IDL.InterfaceFactory;
 export declare const init: (args: { IDL: typeof IDL }) => IDL.Type[];

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

@@ -28,6 +28,18 @@ export const idlFactory = ({ IDL }) => {
     'ok' : IDL.Null,
     'err' : ProtocolError,
   });
+  const Geo = IDL.Record({ 'lat' : IDL.Float64, 'lng' : IDL.Float64 });
+  const SpawnPlace = IDL.Record({ 'center' : Geo, 'atNs' : IDL.Nat64 });
+  const SimulatorError = IDL.Variant({
+    'RemoteCanisterError' : IDL.Text,
+    'NotFound' : IDL.Null,
+    'NotAuthorized' : IDL.Text,
+    'InvalidData' : IDL.Text,
+  });
+  const Result = IDL.Variant({
+    'Ok' : IDL.Opt(SpawnPlace),
+    'Err' : SimulatorError,
+  });
   const Licence = IDL.Record({
     'mimeType' : IDL.Text,
     'image' : IDL.Vec(IDL.Nat8),
@@ -59,7 +71,6 @@ export const idlFactory = ({ IDL }) => {
     'carPhotoCount' : IDL.Nat8,
     'hasLicencePhoto' : IDL.Bool,
   });
-  const Geo = IDL.Record({ 'lat' : IDL.Float64, 'lng' : IDL.Float64 });
   const RideView = IDL.Record({
     'status' : RideStatus,
     'requestId' : IDL.Text,
@@ -80,13 +91,7 @@ export const idlFactory = ({ IDL }) => {
     '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({
+  const Result_1 = IDL.Variant({
     'Ok' : IDL.Vec(RouteTaskView),
     'Err' : SimulatorError,
   });
@@ -150,7 +155,7 @@ export const idlFactory = ({ IDL }) => {
     'rider' : IDL.Principal,
   });
   const SetRouterArgs = IDL.Record({ 'router' : IDL.Opt(IDL.Principal) });
-  const Result_1 = IDL.Variant({ 'Ok' : IDL.Null, 'Err' : SimulatorError });
+  const Result_2 = IDL.Variant({ 'Ok' : IDL.Null, 'Err' : SimulatorError });
   const SpeedUpArgs = IDL.Record({
     'requestId' : IDL.Text,
     'factor' : IDL.Nat8,
@@ -162,7 +167,7 @@ export const idlFactory = ({ IDL }) => {
     'registered' : IDL.Nat32,
     'validUntilNs' : IDL.Nat64,
   });
-  const Result_2 = IDL.Variant({ 'Ok' : SpawnResult, 'Err' : SimulatorError });
+  const Result_3 = IDL.Variant({ 'Ok' : SpawnResult, 'Err' : SimulatorError });
   const SimRouteResult = IDL.Record({
     'requestId' : IDL.Text,
     'rideMeters' : IDL.Nat32,
@@ -174,20 +179,21 @@ export const idlFactory = ({ IDL }) => {
   });
   return IDL.Service({
     'cancelRide' : IDL.Func([RideRef], [ProtocolAnswer], []),
+    'getLastSpawn' : IDL.Func([], [Result], ['query']),
     'getLicence' : IDL.Func([RideRef], [LicenceAnswer], ['query']),
     'getRide' : IDL.Func([RideRef], [RideAnswer], ['query']),
     'getRideRoute' : IDL.Func([RideRef], [RouteAnswer], ['query']),
-    'getRouteTasks' : IDL.Func([], [Result], ['query']),
+    'getRouteTasks' : IDL.Func([], [Result_1], ['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], []),
-    'setRouter' : IDL.Func([SetRouterArgs], [Result_1], []),
-    'setSpeedUp' : IDL.Func([SpeedUpArgs], [Result_1], []),
-    'spawnDrivers' : IDL.Func([SpawnArgs], [Result_2], []),
-    'submitRoute' : IDL.Func([SimRouteResult], [Result_1], []),
+    'setRouter' : IDL.Func([SetRouterArgs], [Result_2], []),
+    'setSpeedUp' : IDL.Func([SpeedUpArgs], [Result_2], []),
+    'spawnDrivers' : IDL.Func([SpawnArgs], [Result_3], []),
+    'submitRoute' : IDL.Func([SimRouteResult], [Result_2], []),
   });
 };
 export const init = ({ IDL }) => {

package/dist/actors/profiles-actor.d.ts

@@ -1,6 +1,6 @@
 import type { Identity } from "@icp-sdk/core/agent";
 import { type GroupOptions } from "../group/canister-actor.js";
-import type { MyRatingView, Profile, RideHistoryPage } from "../interfaces.js";
+import type { MyRatingView, Profile, RateRideOutcome, RideHistoryEntry, RideHistoryPage } from "../interfaces.js";
 /** KU-1: a page of the rider's history. */
 export declare const RIDES_PAGE = 20;
 export declare class ProfilesActor {
@@ -37,5 +37,24 @@ export declare class ProfilesActor {
      * @throws Error with message `CriticalCanisterError` — the core could not be reached
      */
     getMyRidesAsyncUnsafe(cursor?: string, limit?: number): Promise<RideHistoryPage>;
+    /**
+     * C-8, KU-4 (0.5.0): one line of the rider's history by its `rideRef` — for the details
+     * screen after a reload (Skąd, Dokąd) and to show the stars after a rating.
+     * @returns undefined while the ride is not in the core yet (K-9, KU-2: up to a minute)
+     * @throws Error with message `CanisterError` — `NotAuthorized` (anonymous, another rider's ride), `InvalidToken`
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    getMyRideAsyncUnsafe(rideRef: string): Promise<RideHistoryEntry | undefined>;
+    /**
+     * KU-5 (0.5.0, core C-23): the rider rates the driver of a past ride, 1–5 stars, no
+     * comment (U-33). Only a completed ride, within 24 h of its end, once — a rating given
+     * live after the ride (`RideRequest.rateDriverAsyncUnsafe`) counts as the one. Show the
+     * stars only when `RideHistoryEntry.ratable`.
+     * @returns `ok` | `alreadyRated` | `notRatable` | `notAuthorized` (see `RateRideOutcome`)
+     * @throws Error with message `CanisterError` — `InvalidData` (stars outside 1–5), `InvalidToken`
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (20, shared with the profile)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    ratePastRideAsyncUnsafe(rideRef: string, stars: number): Promise<RateRideOutcome>;
 }
 //# sourceMappingURL=profiles-actor.d.ts.map

package/dist/actors/profiles-actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiles-actor.d.ts","sourceRoot":"","sources":["../../src/actors/profiles-actor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/F,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAA6B,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG1G,2CAA2C;AAC3C,eAAO,MAAM,UAAU,KAAK,CAAC;AAkB7B,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAEtB,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB;IAIjF;;;;;;OAMG;IACU,uBAAuB,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IASpE;;;;;OAKG;IACU,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE;;;;;;OAMG;IACU,sBAAsB,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAUxE;;;;;;OAMG;IACU,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;CAS5G"}
+{"version":3,"file":"profiles-actor.d.ts","sourceRoot":"","sources":["../../src/actors/profiles-actor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAiD,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE9G,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGlH,2CAA2C;AAC3C,eAAO,MAAM,UAAU,KAAK,CAAC;AAQ7B,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAEtB,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB;IAIjF;;;;;;OAMG;IACU,uBAAuB,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IASpE;;;;;OAKG;IACU,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE;;;;;;OAMG;IACU,sBAAsB,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAUxE;;;;;;OAMG;IACU,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAUzG;;;;;;OAMG;IACU,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAUzF;;;;;;;;;OASG;IACU,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAajG"}