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

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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/tigi-sharded-package",
-    "version": "0.5.0",
+    "version": "0.5.1",
     "description": "The one package of the Tigi network group: takes the coordinator's id and hides the coordinator, the core and the workers — for a consumer the group is one canister; plus the rider's few driver-canister endpoints (U-14).",
     "homepage": "https://github.com/JSM-Tigi/tigi-sharded/tree/master/package#readme",
     "repository": {
@@ -59,11 +59,11 @@
     "tigiSharded": {
         "repo": "tigi-sharded",
         "repoUrl": "https://github.com/JSM-Tigi/tigi-sharded",
-        "commit": "45ef3143fba15b541f6a7eeb710791ba95716964"
+        "commit": "fefe2d99f4164fb2a2c96c58770e8e1f19676396"
     },
     "tigiDriverRust": {
         "repo": "tigi-driver-rust",
         "repoUrl": "https://github.com/JSM-Tigi/tigi-driver-rust",
-        "commit": "f7aca49c36c7eddeea623e69f10d15203100a67e"
+        "commit": "f0450d338cc446941c93753979ac63ac1ffc909b"
     }
 }