@jsm-mit/tigi-sharded-package 0.16.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -219,7 +219,7 @@ npm run sync-declarations # after a change of a .did (`… protocol` for the pr
219
219
  ```
220
220
 
221
221
  The end-to-end suites run on the LOCAL replica only (`scripts/run-tests-local.sh`): a fresh
222
- group, local cycles, the driver and simulator wasms of `../../tigi-driver-rust` (built
222
+ group, local cycles, the driver and simulator wasms of `../../../tigi-driver/tigi-driver-rust` (built
223
223
  there, never changed). Logs and measurements go to `/tmp/claude-1000/tigi/`
224
224
  (`TEST_LOG_DIR`). The load test builds its group with its own coordinator
225
225
  (`tigi-sharded-coordinator-load`), so the shared local group stays; its settings are
@@ -229,7 +229,7 @@ environment variables (`scripts/load-local.ts`, `scripts/run-load-local.sh`).
229
229
 
230
230
  Human-run only: bump `version` in `package.json` by hand (do not commit it), then
231
231
  `npm run publish-public` on `master`. The script refuses unless this repo and
232
- `../../tigi-driver-rust` are both on a clean `master` equal to `origin/master`, the version is
232
+ `../../../tigi-driver/tigi-driver-rust` are both on a clean `master` equal to `origin/master`, the version is
233
233
  new on npm, the declarations match the current builds (core, worker, coordinator, protocol,
234
234
  simulator) and the smoke test passes on the LOCAL replica (`dfx start` first). It stamps
235
235
  `tigiSharded.commit` and `tigiDriverRust.commit` into `package.json`, publishes, then commits
@@ -48,7 +48,7 @@ type TigiCore =
48
48
  /// joins the next daily bill of the room's OWN driver canister as it is (the chat priced
49
49
  /// it; no multiplier). A pool canister's share and a room of no canister of the registry
50
50
  /// are absorbed (the coordinator keeps paying them). Once per `batchId`.
51
- addChatShares: (args: ChatSharesArgs) -> (Result_37);
51
+ addChatShares: (args: ChatSharesArgs) -> (Result_39);
52
52
  /// Admins: a canister the core controls joins the demo pool (U-35).
53
53
  addPoolCanister: (args: CanisterArgs) -> (Result_8);
54
54
  /// Admins: a driver canister, or one driver in it (`driverKey`), is blocked; the workers
@@ -62,23 +62,23 @@ type TigiCore =
62
62
  claimDriverCanister: (args: ClaimArgs) -> (Result_8);
63
63
  clearLogs: () -> ();
64
64
  /// Admins (F-24): the chunks become THE app; drivers' canisters take it at their "Aktualizuj".
65
- commitDriverApk: (args: ApkCommitArgs) -> (Result_36);
65
+ commitDriverApk: (args: ApkCommitArgs) -> (Result_38);
66
66
  /// Admins: the chunks become THE module of their kind. A new driver wasm is released
67
67
  /// (F-11) and its hash goes to the workers.
68
- commitDriverWasm: (args: WasmCommitArgs) -> (Result_35);
68
+ commitDriverWasm: (args: WasmCommitArgs) -> (Result_37);
69
69
  /// Admins, localTest: an empty canister from the core's cycles joins the demo pool.
70
70
  createLocalPoolCanister: () -> (Result_8);
71
71
  createMyDriverCanister: () -> (Result_8);
72
72
  /// Admins: the simulator, created once (F-18).
73
- ensureSimulator: () -> (Result_34);
73
+ ensureSimulator: () -> (Result_36);
74
74
  /// F-8: 15 min more for the holder of a demo canister.
75
75
  extendDemoLease: () -> (Result_8);
76
- getAdmins: () -> (Result_33) query;
76
+ getAdmins: () -> (Result_35) query;
77
77
  /// For the fronts (through the package): where the chat of this environment is. Null =
78
78
  /// no chat here yet. The room of a driver is `ChatRoomFunctions.driverRoomId`.
79
79
  getChatConfig: () -> (opt ChatConfig) query;
80
80
  /// Admins: how far the driver rooms are (C-15).
81
- getChatRoomsStatus: () -> (Result_32) query;
81
+ getChatRoomsStatus: () -> (Result_34) query;
82
82
  /// F-24 (public): the current app — what a driver canister compares its own with.
83
83
  getDriverApk: () -> (opt ApkInfo) query;
84
84
  /// F-24 (public): one chunk of the current app; a driver canister reads them in order.
@@ -87,44 +87,45 @@ type TigiCore =
87
87
  getDriverCanisterStatus: (args: CanisterArgs) ->
88
88
  (DriverCanisterStatus) query;
89
89
  /// Admins: the account of one driver canister (C-17 … C-20).
90
- getDriverFeeAccount: (args: CanisterArgs) -> (Result_31) query;
90
+ getDriverFeeAccount: (args: CanisterArgs) -> (Result_33) query;
91
91
  /// C-19: a driver canister of the registry asks for its bill — the events since its
92
92
  /// last settlement, priced on the fee's day. Called by the canister at its first
93
93
  /// "Przyjmuję zlecenia" of a day. A pool canister owes nothing (C-18).
94
- getDriverFeeBill: () -> (Result_30);
94
+ getDriverFeeBill: () -> (Result_32);
95
95
  /// Admins (stage 7): the aggregated rating of one driver (sum and count of stars; null =
96
96
  /// no rating yet) — the value the workers get through the outbox (C-6).
97
- getDriverRating: (args: DriverRatingArgs) -> (Result_26) query;
98
- getDriverRollout: () -> (Result_29) query;
99
- getFactoryStatus: () -> (Result_28) query;
97
+ getDriverRating: (args: DriverRatingArgs) -> (Result_27) query;
98
+ getDriverRollout: () -> (Result_31) query;
99
+ getFactoryStatus: () -> (Result_30) query;
100
100
  /// C-22: the rates, the day, the multiplier cached, the totals.
101
- getFeeStatus: () -> (Result_27) query;
101
+ getFeeStatus: () -> (Result_29) query;
102
102
  getLogs: () -> (text) query;
103
103
  getMapPlacesConfig: () -> (opt MapPlacesConfig) query;
104
104
  getMapRoutesConfig: () -> (opt MapRoutesConfig) query;
105
- /// The caller's own canister, or the demo canister the caller holds now.
106
- getMyDriverCanister: () -> (Result_8) query;
105
+ /// The caller's own canister, or the demo canister the caller holds now, or the canister
106
+ /// of the fleet the caller drives for (C-N12) — with the caller's place in the fleet.
107
+ getMyDriverCanister: () -> (Result_28) query;
107
108
  getMyProfile: () -> (Result_4) query;
108
109
  /// C-16, PF-4: the caller's own rating as a rider (sum and count of stars; null = no
109
110
  /// rating yet). Ratings reach the core in the workers' batches, up to a minute late.
110
- getMyRating: () -> (Result_26) query;
111
+ getMyRating: () -> (Result_27) query;
111
112
  /// C-8 (KU-4, stage 7): one line of the caller's history by its requestId — for the
112
113
  /// details screen after a reload and to show the rating after `rateMyRide`. Another
113
114
  /// rider's ride → `NotAuthorized`; not in the core (yet, K-9) → `NotFound`.
114
- getMyRide: (args: RequestIdArgs) -> (Result_25) query;
115
+ getMyRide: (args: RequestIdArgs) -> (Result_26) query;
115
116
  /// C-8: the caller's rides, newest first, with the places (KU-4) and whether the driver
116
117
  /// can still be rated (KU-5, C-23).
117
- getMyRides: (args: RidesPageArgs) -> (Result_24) query;
118
+ getMyRides: (args: RidesPageArgs) -> (Result_25) query;
118
119
  /// C-3: the names of up to MAX_PROFILES_PER_CALL principals; unknown ones are left out.
119
- getProfiles: (args: ProfilesArgs) -> (Result_23) query;
120
+ getProfiles: (args: ProfilesArgs) -> (Result_24) query;
120
121
  /// F-11: the driver wasms released so far, oldest first.
121
122
  getReleasedDriverWasms: () -> (vec ReleasedWasm) query;
122
123
  /// F-18: the simulator of this group; none in prod or before ensureSimulator.
123
124
  getSimulator: () -> (opt principal) query;
124
125
  /// Admins: the coordinator, the workers confirmed so far, the mode.
125
- getWiring: () -> (Result_22) query;
126
+ getWiring: () -> (Result_23) query;
126
127
  /// Admins: how far the outbox to the workers is (C-6, C-7).
127
- getWorkerOutbox: () -> (Result_21) query;
128
+ getWorkerOutbox: () -> (Result_22) query;
128
129
  /// Workers of the group: the core asks the coordinator once and remembers the worker,
129
130
  /// which then gets the network state through the outbox. A worker calls it once after
130
131
  /// its install. Answers true.
@@ -132,37 +133,41 @@ type TigiCore =
132
133
  /// Workers of the group: finished rides and ratings, at most MAX_RIDE_BATCH (C-4, C-5).
133
134
  /// Idempotent: a known requestId and a counted rating count once. Invalid entries are
134
135
  /// rejected and logged; the worker drops the whole batch after an ok.
135
- ingestRideBatch: (batch: RideBatch) -> (Result_20);
136
+ ingestRideBatch: (batch: RideBatch) -> (Result_21);
136
137
  /// C-14: the accounts gate of the chat (U-43). The chat core asks this group's
137
138
  /// coordinator WHERE (`accountsCanisterFor` → this core) and asks here: true = an
138
139
  /// account with a name exists for the principal and the rider is not blocked.
139
140
  isUser: ("principal": principal) -> (bool) query;
140
141
  /// F-5 … F-7: a demo canister for 15 min (outside prod). A fresh lease comes with a
141
142
  /// one-time claim code (F-20, U-45).
142
- leaseDemoDriverCanister: () -> (Result_19);
143
- listBlocks: (args: PageArgs) -> (Result_18) query;
144
- listDriverCanisters: (args: PageArgs) -> (Result_17) query;
143
+ leaseDemoDriverCanister: () -> (Result_20);
144
+ listBlocks: (args: PageArgs) -> (Result_19) query;
145
+ listDriverCanisters: (args: PageArgs) -> (Result_18) query;
145
146
  /// Admins: the accounts, 100 a page at most.
146
- listDriverFeeAccounts: (args: PageArgs) -> (Result_16) query;
147
+ listDriverFeeAccounts: (args: PageArgs) -> (Result_17) query;
147
148
  /// Admins: the driver rooms as the core wants them, 100 a page at most.
148
- listDriverRooms: (args: PageArgs) -> (Result_15) query;
149
+ listDriverRooms: (args: PageArgs) -> (Result_16) query;
149
150
  /// C-29, C-30: the map ticket of the calling driver (own or demo driver canister, not
150
151
  /// blocked), for an area and a bbox. The core asks the map coordinator WHERE (once, kept)
151
152
  /// and that ticket core for the ticket of the caller; a failed call forgets the place and is
152
153
  /// tried once more. A refusal of the map group comes back as `RemoteCanisterError` with
153
154
  /// its variant first ("Blocked: …").
154
- mapTicket: (args: MapTicketArgs) -> (Result_12);
155
+ mapTicket: (args: MapTicketArgs) -> (Result_13);
155
156
  /// F-20: a fresh claim code for the caller's running demo lease; the old one stops
156
157
  /// working.
157
- newClaimCode: () -> (Result_14);
158
+ newClaimCode: () -> (Result_15);
158
159
  /// C-20: the driver canister pays the bill of `day` with the cycles attached to this
159
160
  /// call. The core takes exactly the bill (the rest goes back), or nothing when less is
160
161
  /// attached (`FEE_SHORT`); a day paid already answers `accepted = 0`.
161
- payDriverFee: (args: FeePayArgs) -> (Result_13);
162
+ payDriverFee: (args: FeePayArgs) -> (Result_14);
162
163
  /// C-32, C-33: the map-places ticket of the calling rider (signed in, not blocked) for an
163
164
  /// area and a bbox — the search of Skąd / Dokąd while the copy of signed-out users does not
164
165
  /// serve. As `mapTicket` (C-29): WHERE from the coordinator (kept), then the ticket core.
165
- placesTicket: (args: MapTicketArgs) -> (Result_12);
166
+ placesTicket: (args: MapTicketArgs) -> (Result_13);
167
+ /// C-N11 (D-32): a driver canister reports a driver of its fleet — joined or active again,
168
+ /// suspended, removed. Idempotent; the canister repeats it until it gets an answer. The
169
+ /// driver's room follows (C-N13).
170
+ putFleetDriver: (args: PutFleetDriverArgs) -> (Result_12);
166
171
  /// F-2 … F-4, F-10: the caller's own driver canister (localTest: from the core's cycles).
167
172
  /// F-1 (user 2026-10-31): what a driver canister costs now and the caller's account to pay to.
168
173
  quoteMyDriverCanister: () -> (Result_11);
@@ -330,46 +335,56 @@ type Result_4 =
330
335
  err: Error;
331
336
  ok: Profile;
332
337
  };
333
- type Result_37 =
338
+ type Result_39 =
334
339
  variant {
335
340
  err: Error;
336
341
  ok: ChatSharesAck;
337
342
  };
338
- type Result_36 =
343
+ type Result_38 =
339
344
  variant {
340
345
  err: Error;
341
346
  ok: ApkInfo;
342
347
  };
343
- type Result_35 =
348
+ type Result_37 =
344
349
  variant {
345
350
  err: Error;
346
351
  ok: WasmInfo;
347
352
  };
348
- type Result_34 =
353
+ type Result_36 =
349
354
  variant {
350
355
  err: Error;
351
356
  ok: principal;
352
357
  };
353
- type Result_33 =
358
+ type Result_35 =
354
359
  variant {
355
360
  err: Error;
356
361
  ok: vec principal;
357
362
  };
358
- type Result_32 =
363
+ type Result_34 =
359
364
  variant {
360
365
  err: Error;
361
366
  ok: ChatRoomsStatus;
362
367
  };
363
- type Result_31 =
368
+ type Result_33 =
364
369
  variant {
365
370
  err: Error;
366
371
  ok: DriverFeeAccountView;
367
372
  };
368
- type Result_30 =
373
+ type Result_32 =
369
374
  variant {
370
375
  err: Error;
371
376
  ok: FeeBillAnswer;
372
377
  };
378
+ type Result_31 =
379
+ variant {
380
+ err: Error;
381
+ ok: opt RolloutView;
382
+ };
383
+ type Result_30 =
384
+ variant {
385
+ err: Error;
386
+ ok: FactoryStatus;
387
+ };
373
388
  type Result_3 =
374
389
  variant {
375
390
  err: Error;
@@ -378,44 +393,39 @@ type Result_3 =
378
393
  type Result_29 =
379
394
  variant {
380
395
  err: Error;
381
- ok: opt RolloutView;
396
+ ok: FeeStatus;
382
397
  };
383
398
  type Result_28 =
384
399
  variant {
385
400
  err: Error;
386
- ok: FactoryStatus;
401
+ ok: MyDriverCanister;
387
402
  };
388
403
  type Result_27 =
389
- variant {
390
- err: Error;
391
- ok: FeeStatus;
392
- };
393
- type Result_26 =
394
404
  variant {
395
405
  err: Error;
396
406
  ok: opt Rating;
397
407
  };
398
- type Result_25 =
408
+ type Result_26 =
399
409
  variant {
400
410
  err: Error;
401
411
  ok: RideView;
402
412
  };
403
- type Result_24 =
413
+ type Result_25 =
404
414
  variant {
405
415
  err: Error;
406
416
  ok: RidesPage;
407
417
  };
408
- type Result_23 =
418
+ type Result_24 =
409
419
  variant {
410
420
  err: Error;
411
421
  ok: vec ProfileEntry;
412
422
  };
413
- type Result_22 =
423
+ type Result_23 =
414
424
  variant {
415
425
  err: Error;
416
426
  ok: Wiring;
417
427
  };
418
- type Result_21 =
428
+ type Result_22 =
419
429
  variant {
420
430
  err: Error;
421
431
  ok:
@@ -426,11 +436,16 @@ type Result_21 =
426
436
  subjects: nat;
427
437
  };
428
438
  };
429
- type Result_20 =
439
+ type Result_21 =
430
440
  variant {
431
441
  err: Error;
432
442
  ok: RideBatchResult;
433
443
  };
444
+ type Result_20 =
445
+ variant {
446
+ err: Error;
447
+ ok: LeaseAnswer;
448
+ };
434
449
  type Result_2 =
435
450
  variant {
436
451
  err: Error;
@@ -439,42 +454,42 @@ type Result_2 =
439
454
  type Result_19 =
440
455
  variant {
441
456
  err: Error;
442
- ok: LeaseAnswer;
457
+ ok: vec Block;
443
458
  };
444
459
  type Result_18 =
445
460
  variant {
446
461
  err: Error;
447
- ok: vec Block;
462
+ ok: DriverCanistersPage;
448
463
  };
449
464
  type Result_17 =
450
465
  variant {
451
466
  err: Error;
452
- ok: DriverCanistersPage;
467
+ ok: vec DriverFeeAccountView;
453
468
  };
454
469
  type Result_16 =
455
470
  variant {
456
471
  err: Error;
457
- ok: vec DriverFeeAccountView;
472
+ ok: vec DriverRoomView;
458
473
  };
459
474
  type Result_15 =
460
475
  variant {
461
476
  err: Error;
462
- ok: vec DriverRoomView;
477
+ ok: ClaimCode;
463
478
  };
464
479
  type Result_14 =
465
480
  variant {
466
481
  err: Error;
467
- ok: ClaimCode;
482
+ ok: FeePaid;
468
483
  };
469
484
  type Result_13 =
470
485
  variant {
471
486
  err: Error;
472
- ok: FeePaid;
487
+ ok: MapTicket;
473
488
  };
474
489
  type Result_12 =
475
490
  variant {
476
491
  err: Error;
477
- ok: MapTicket;
492
+ ok: PutFleetDriverAck;
478
493
  };
479
494
  type Result_11 =
480
495
  variant {
@@ -533,6 +548,13 @@ type RateRideArgs =
533
548
  requestId: text;
534
549
  stars: nat8;
535
550
  };
551
+ type PutFleetDriverArgs =
552
+ record {
553
+ change: FleetDriverChange;
554
+ driver: principal;
555
+ driverKey: text;
556
+ };
557
+ type PutFleetDriverAck = record {drivers: nat;};
536
558
  type ProfilesArgs = record {principals: vec principal;};
537
559
  type ProfileEntry =
538
560
  record {
@@ -551,6 +573,18 @@ type PageArgs =
551
573
  limit: nat;
552
574
  offset: nat;
553
575
  };
576
+ type MyDriverCanister =
577
+ record {
578
+ blocked: bool;
579
+ canister: principal;
580
+ createdAtNs: int;
581
+ fleet: opt FleetMembership;
582
+ installedAtNs: opt int;
583
+ kind: DriverCanisterKind;
584
+ leaseUntilNs: opt int;
585
+ moduleHash: opt blob;
586
+ owner: principal;
587
+ };
554
588
  type Money =
555
589
  record {
556
590
  amount: nat64;
@@ -613,6 +647,29 @@ type Geo =
613
647
  lat: float64;
614
648
  lng: float64;
615
649
  };
650
+ type FleetRole =
651
+ variant {
652
+ boss;
653
+ driver;
654
+ };
655
+ type FleetMembership =
656
+ record {
657
+ driverKey: text;
658
+ drives: bool;
659
+ role: FleetRole;
660
+ state: FleetDriverState;
661
+ };
662
+ type FleetDriverState =
663
+ variant {
664
+ active;
665
+ suspended;
666
+ };
667
+ type FleetDriverChange =
668
+ variant {
669
+ active;
670
+ removed;
671
+ suspended;
672
+ };
616
673
  type FeeUsage =
617
674
  record {
618
675
  quoteRequests: nat;