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

package/declarations/core/core.did.d.ts

@@ -18,6 +18,25 @@ export type BlockTarget = { 'driverCanister' : Principal } |
   { 'driver' : { 'driverKey' : string, 'canister' : Principal } } |
   { 'rider' : Principal };
 export interface CanisterArgs { 'canister' : Principal }
+export interface ChatConfig {
+  'chatCoordinatorId' : Principal,
+  'projectId' : string,
+}
+export interface ChatRoomsStatus {
+  'failures' : bigint,
+  'pending' : bigint,
+  'lastError' : [] | [string],
+  'config' : [] | [ChatConfig],
+  'pendingSinceNs' : [] | [bigint],
+  'rooms' : bigint,
+}
+export interface ClaimArgs { 'code' : string, 'canister' : Principal }
+export interface ClaimCode {
+  'expiresAtNs' : bigint,
+  'code' : string,
+  'canister' : Principal,
+}
+export interface ClaimTtlArgs { 'seconds' : bigint }
 export interface DriverCanister {
   'moduleHash' : [] | [Uint8Array | number[]],
   'owner' : Principal,
@@ -39,6 +58,14 @@ export interface DriverCanistersPage {
   'total' : bigint,
   'canisters' : Array<DriverCanister>,
 }
+export interface DriverRoomView {
+  'recipient' : Principal,
+  'driverKey' : string,
+  'canister' : Principal,
+  'lastError' : [] | [string],
+  'roomId' : string,
+  'synced' : boolean,
+}
 export interface Error { 'details' : ErrorDetails, 'logsJson' : string }
 export type ErrorDetails = { 'InterCanisterConnectionError' : null } |
   { 'RemoteCanisterError' : string } |
@@ -64,7 +91,18 @@ export interface InitArgs {
   'coordinator' : [] | [Principal],
 }
 export type LeaseAnswer = { 'busy' : { 'untilNs' : bigint } } |
-  { 'leased' : DriverCanister };
+  { 'leased' : LeasedCanister };
+export interface LeasedCanister {
+  'moduleHash' : [] | [Uint8Array | number[]],
+  'owner' : Principal,
+  'blocked' : boolean,
+  'kind' : DriverCanisterKind,
+  'claim' : [] | [ClaimCode],
+  'createdAtNs' : bigint,
+  'canister' : Principal,
+  'installedAtNs' : [] | [bigint],
+  'leaseUntilNs' : [] | [bigint],
+}
 export type Mode = { 'localTest' : null } |
   { 'prod' : null } |
   { 'test' : null } |
@@ -79,6 +117,7 @@ export interface Profile {
 }
 export interface ProfileEntry { 'principal' : Principal, 'name' : string }
 export interface ProfilesArgs { 'principals' : Array<Principal> }
+export interface Rating { 'sum' : bigint, 'count' : bigint }
 export interface RatingEntry {
   'requestId' : string,
   'side' : RatingSide,
@@ -98,46 +137,56 @@ export type Result = { 'ok' : bigint } |
   { 'err' : Error };
 export type Result_1 = { 'ok' : Uint8Array | number[] } |
   { 'err' : Error };
-export type Result_10 = { 'ok' : Wiring } |
+export type Result_10 = { 'ok' : LeaseAnswer } |
   { 'err' : Error };
-export type Result_11 = { 'ok' : Array<ProfileEntry> } |
+export type Result_11 = { 'ok' : RideBatchResult } |
   { 'err' : Error };
-export type Result_12 = { 'ok' : RidesPage } |
+export type Result_12 = {
+    'ok' : {
+      'subjects' : bigint,
+      'headSeq' : bigint,
+      'lastError' : [] | [string],
+      'laggingWorkers' : bigint,
+    }
+  } |
+  { 'err' : Error };
+export type Result_13 = { 'ok' : Wiring } |
   { 'err' : Error };
-export type Result_13 = { 'ok' : DriverCanister } |
+export type Result_14 = { 'ok' : Array<ProfileEntry> } |
   { 'err' : Error };
-export type Result_14 = { 'ok' : FactoryStatus } |
+export type Result_15 = { 'ok' : RidesPage } |
   { 'err' : Error };
-export type Result_15 = { 'ok' : [] | [RolloutView] } |
+export type Result_16 = { 'ok' : [] | [Rating] } |
   { 'err' : Error };
-export type Result_16 = { 'ok' : Array<Principal> } |
+export type Result_17 = { 'ok' : DriverCanister } |
   { 'err' : Error };
-export type Result_17 = { 'ok' : Principal } |
+export type Result_18 = { 'ok' : FactoryStatus } |
   { 'err' : Error };
-export type Result_18 = { 'ok' : WasmInfo } |
+export type Result_19 = { 'ok' : [] | [RolloutView] } |
   { 'err' : Error };
 export type Result_2 = { 'ok' : boolean } |
   { 'err' : Error };
+export type Result_20 = { 'ok' : ChatRoomsStatus } |
+  { 'err' : Error };
+export type Result_21 = { 'ok' : Array<Principal> } |
+  { 'err' : Error };
+export type Result_22 = { 'ok' : Principal } |
+  { 'err' : Error };
+export type Result_23 = { 'ok' : WasmInfo } |
+  { 'err' : Error };
 export type Result_3 = { 'ok' : RolloutView } |
   { 'err' : Error };
 export type Result_4 = { 'ok' : Profile } |
   { 'err' : Error };
-export type Result_5 = { 'ok' : DriverCanistersPage } |
+export type Result_5 = { 'ok' : ChatConfig } |
   { 'err' : Error };
-export type Result_6 = { 'ok' : Array<Block> } |
+export type Result_6 = { 'ok' : ClaimCode } |
   { 'err' : Error };
-export type Result_7 = { 'ok' : LeaseAnswer } |
+export type Result_7 = { 'ok' : Array<DriverRoomView> } |
   { 'err' : Error };
-export type Result_8 = { 'ok' : RideBatchResult } |
+export type Result_8 = { 'ok' : DriverCanistersPage } |
   { 'err' : Error };
-export type Result_9 = {
-    'ok' : {
-      'subjects' : bigint,
-      'headSeq' : bigint,
-      'lastError' : [] | [string],
-      'laggingWorkers' : bigint,
-    }
-  } |
+export type Result_9 = { 'ok' : Array<Block> } |
   { 'err' : Error };
 export interface RideBatch {
   'ratings' : Array<RatingEntry>,
@@ -200,7 +249,7 @@ export interface TigiCore {
   /**
    * / Admins: a canister the core controls joins the demo pool (U-35).
    */
-  'addPoolCanister' : ActorMethod<[CanisterArgs], Result_13>,
+  'addPoolCanister' : ActorMethod<[CanisterArgs], Result_17>,
   /**
    * / Admins: a driver canister, or one driver in it (`driverKey`), is blocked; the workers
    * / drop it at once (WO-2).
@@ -210,49 +259,69 @@ export interface TigiCore {
    * / Admins: a rider is blocked (core.md, accepted 2026-10-22).
    */
   'blockRider' : ActorMethod<[BlockRiderArgs], Result_2>,
+  /**
+   * / F-20 (U-45): the caller — the driver signed in on the canister's own front — takes
+   * / over the demo canister with the code of the link. Single use, 15 min; every refusal
+   * / answers the same NotAuthorized. The room of the canister gets the caller (C-15).
+   */
+  'claimDriverCanister' : ActorMethod<[ClaimArgs], Result_17>,
   'clearLogs' : ActorMethod<[], undefined>,
   /**
    * / Admins: the chunks become THE module of their kind. A new driver wasm is released
    * / (F-11) and its hash goes to the workers.
    */
-  'commitDriverWasm' : ActorMethod<[WasmCommitArgs], Result_18>,
+  'commitDriverWasm' : ActorMethod<[WasmCommitArgs], Result_23>,
   /**
    * / Admins, localTest: an empty canister from the core's cycles joins the demo pool.
    */
-  'createLocalPoolCanister' : ActorMethod<[], Result_13>,
+  'createLocalPoolCanister' : ActorMethod<[], Result_17>,
   /**
    * / F-2 … F-4, F-10: the caller's own driver canister (localTest: from the core's cycles).
    */
-  'createMyDriverCanister' : ActorMethod<[], Result_13>,
+  'createMyDriverCanister' : ActorMethod<[], Result_17>,
   /**
    * / Admins: the simulator, created once (F-18).
    */
-  'ensureSimulator' : ActorMethod<[], Result_17>,
+  'ensureSimulator' : ActorMethod<[], Result_22>,
   /**
    * / F-8: 15 min more for the holder of a demo canister.
    */
-  'extendDemoLease' : ActorMethod<[], Result_13>,
-  'getAdmins' : ActorMethod<[], Result_16>,
+  'extendDemoLease' : ActorMethod<[], Result_17>,
+  'getAdmins' : ActorMethod<[], Result_21>,
+  /**
+   * / For the fronts (through the package): where the chat of this environment is. Null =
+   * / no chat here yet. The room of a driver is `ChatRoomFunctions.driverRoomId`.
+   */
+  'getChatConfig' : ActorMethod<[], [] | [ChatConfig]>,
+  /**
+   * / Admins: how far the driver rooms are (C-15).
+   */
+  'getChatRoomsStatus' : ActorMethod<[], Result_20>,
   /**
    * / WO-1, WO-2: what the core knows of a canister — for the workers and anybody.
    */
   'getDriverCanisterStatus' : ActorMethod<[CanisterArgs], DriverCanisterStatus>,
-  'getDriverRollout' : ActorMethod<[], Result_15>,
-  'getFactoryStatus' : ActorMethod<[], Result_14>,
+  'getDriverRollout' : ActorMethod<[], Result_19>,
+  'getFactoryStatus' : ActorMethod<[], Result_18>,
   'getLogs' : ActorMethod<[], string>,
   /**
    * / The caller's own canister, or the demo canister the caller holds now.
    */
-  'getMyDriverCanister' : ActorMethod<[], Result_13>,
+  'getMyDriverCanister' : ActorMethod<[], Result_17>,
   'getMyProfile' : ActorMethod<[], Result_4>,
+  /**
+   * / C-16, PF-4: the caller's own rating as a rider (sum and count of stars; null = no
+   * / rating yet). Ratings reach the core in the workers' batches, up to a minute late.
+   */
+  'getMyRating' : ActorMethod<[], Result_16>,
   /**
    * / C-8: the caller's rides, newest first.
    */
-  'getMyRides' : ActorMethod<[RidesPageArgs], Result_12>,
+  'getMyRides' : ActorMethod<[RidesPageArgs], Result_15>,
   /**
    * / C-3: the names of up to MAX_PROFILES_PER_CALL principals; unknown ones are left out.
    */
-  'getProfiles' : ActorMethod<[ProfilesArgs], Result_11>,
+  'getProfiles' : ActorMethod<[ProfilesArgs], Result_14>,
   /**
    * / F-11: the driver wasms released so far, oldest first.
    */
@@ -264,11 +333,11 @@ export interface TigiCore {
   /**
    * / Admins: the coordinator, the workers confirmed so far, the mode.
    */
-  'getWiring' : ActorMethod<[], Result_10>,
+  'getWiring' : ActorMethod<[], Result_13>,
   /**
    * / Admins: how far the outbox to the workers is (C-6, C-7).
    */
-  'getWorkerOutbox' : ActorMethod<[], Result_9>,
+  'getWorkerOutbox' : ActorMethod<[], Result_12>,
   /**
    * / Workers of the group: the core asks the coordinator once and remembers the worker,
    * / which then gets the network state through the outbox. A worker calls it once after
@@ -280,15 +349,42 @@ export interface TigiCore {
    * / Idempotent: a known requestId and a counted rating count once. Invalid entries are
    * / rejected and logged; the worker drops the whole batch after an ok.
    */
-  'ingestRideBatch' : ActorMethod<[RideBatch], Result_8>,
+  'ingestRideBatch' : ActorMethod<[RideBatch], Result_11>,
+  /**
+   * / C-14: the accounts gate of the chat (U-43). The chat core asks this group's
+   * / coordinator WHERE (`accountsCanisterFor` → this core) and asks here: true = an
+   * / account with a name exists for the principal and the rider is not blocked.
+   */
+  'isUser' : ActorMethod<[Principal], boolean>,
+  /**
+   * / F-5 … F-7: a demo canister for 15 min (outside prod). A fresh lease comes with a
+   * / one-time claim code (F-20, U-45).
+   */
+  'leaseDemoDriverCanister' : ActorMethod<[], Result_10>,
+  'listBlocks' : ActorMethod<[PageArgs], Result_9>,
+  'listDriverCanisters' : ActorMethod<[PageArgs], Result_8>,
   /**
-   * / F-5 … F-7: a demo canister for 15 min (outside prod).
+   * / Admins: the driver rooms as the core wants them, 100 a page at most.
    */
-  'leaseDemoDriverCanister' : ActorMethod<[], Result_7>,
-  'listBlocks' : ActorMethod<[PageArgs], Result_6>,
-  'listDriverCanisters' : ActorMethod<[PageArgs], Result_5>,
+  'listDriverRooms' : ActorMethod<[PageArgs], Result_7>,
+  /**
+   * / F-20: a fresh claim code for the caller's running demo lease; the old one stops
+   * / working.
+   */
+  'newClaimCode' : ActorMethod<[], Result_6>,
   'removeAdmin' : ActorMethod<[PrincipalArgs], Result_2>,
   'resumeDriverRollout' : ActorMethod<[], Result_3>,
+  /**
+   * / Admins: the chat of this environment — the chat group's coordinator and the project
+   * / (whose admin and accounts field are this group's coordinator). Every call sends every
+   * / driver room again (a new project, a chat group set up again).
+   */
+  'setChatConfig' : ActorMethod<[ChatConfig], Result_5>,
+  /**
+   * / Admins, localTest only: new claim codes live this long (the local check of an
+   * / expired code). Heap only: an upgrade brings back 15 min.
+   */
+  'setClaimCodeTtl' : ActorMethod<[ClaimTtlArgs], Result>,
   'setLoggingEnabled' : ActorMethod<[boolean], Result_2>,
   /**
    * / The coordinator only: the balance below which the core asks for cycles.

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_13 = IDL.Variant({ 'ok' : DriverCanister, 'err' : Error });
+  const Result_17 = 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,18 +87,31 @@ export const idlFactory = ({ IDL }) => {
     'size' : IDL.Nat,
     'committedAtNs' : IDL.Int,
   });
-  const Result_18 = IDL.Variant({ 'ok' : WasmInfo, 'err' : Error });
-  const Result_17 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
-  const Result_16 = IDL.Variant({
+  const Result_23 = IDL.Variant({ 'ok' : WasmInfo, 'err' : Error });
+  const Result_22 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
+  const Result_21 = IDL.Variant({
     'ok' : IDL.Vec(IDL.Principal),
     'err' : Error,
   });
+  const ChatConfig = IDL.Record({
+    'chatCoordinatorId' : IDL.Principal,
+    'projectId' : IDL.Text,
+  });
+  const ChatRoomsStatus = IDL.Record({
+    'failures' : IDL.Nat,
+    'pending' : IDL.Nat,
+    'lastError' : IDL.Opt(IDL.Text),
+    'config' : IDL.Opt(ChatConfig),
+    'pendingSinceNs' : IDL.Opt(IDL.Int),
+    'rooms' : IDL.Nat,
+  });
+  const Result_20 = 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_15 = IDL.Variant({ 'ok' : IDL.Opt(RolloutView), 'err' : Error });
+  const Result_19 = IDL.Variant({ 'ok' : IDL.Opt(RolloutView), 'err' : Error });
   const FactoryStatus = IDL.Record({
     'simulator' : IDL.Opt(IDL.Principal),
     'mode' : Mode,
@@ -106,13 +123,15 @@ export const idlFactory = ({ IDL }) => {
     'driverWasm' : IDL.Opt(WasmInfo),
     'registered' : IDL.Nat,
   });
-  const Result_14 = IDL.Variant({ 'ok' : FactoryStatus, 'err' : Error });
+  const Result_18 = IDL.Variant({ 'ok' : FactoryStatus, '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_16 = IDL.Variant({ 'ok' : IDL.Opt(Rating), 'err' : Error });
   const RidesPageArgs = IDL.Record({
     'beforeIndex' : IDL.Opt(IDL.Nat),
     'limit' : IDL.Nat,
@@ -136,13 +155,13 @@ export const idlFactory = ({ IDL }) => {
     'nextBeforeIndex' : IDL.Opt(IDL.Nat),
     'rides' : IDL.Vec(RideEntry),
   });
-  const Result_12 = IDL.Variant({ 'ok' : RidesPage, 'err' : Error });
+  const Result_15 = 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_11 = IDL.Variant({
+  const Result_14 = IDL.Variant({
     'ok' : IDL.Vec(ProfileEntry),
     'err' : Error,
   });
@@ -156,8 +175,8 @@ export const idlFactory = ({ IDL }) => {
     'knownWorkers' : IDL.Vec(IDL.Principal),
     'coordinator' : IDL.Opt(IDL.Principal),
   });
-  const Result_10 = IDL.Variant({ 'ok' : Wiring, 'err' : Error });
-  const Result_9 = IDL.Variant({
+  const Result_13 = IDL.Variant({ 'ok' : Wiring, 'err' : Error });
+  const Result_12 = IDL.Variant({
     'ok' : IDL.Record({
       'subjects' : IDL.Nat,
       'headSeq' : IDL.Nat64,
@@ -188,12 +207,28 @@ export const idlFactory = ({ IDL }) => {
     'rejected' : IDL.Nat,
     'ratingsCounted' : IDL.Nat,
   });
-  const Result_8 = IDL.Variant({ 'ok' : RideBatchResult, 'err' : Error });
+  const Result_11 = 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_7 = IDL.Variant({ 'ok' : LeaseAnswer, 'err' : Error });
+  const Result_10 = IDL.Variant({ 'ok' : LeaseAnswer, 'err' : Error });
   const PageArgs = IDL.Record({ 'offset' : IDL.Nat, 'limit' : IDL.Nat });
   const BlockTarget = IDL.Variant({
     'driverCanister' : IDL.Principal,
@@ -209,12 +244,28 @@ export const idlFactory = ({ IDL }) => {
     'target' : BlockTarget,
     'reason' : IDL.Text,
   });
-  const Result_6 = IDL.Variant({ 'ok' : IDL.Vec(Block), 'err' : Error });
+  const Result_9 = IDL.Variant({ 'ok' : IDL.Vec(Block), 'err' : Error });
   const DriverCanistersPage = IDL.Record({
     'total' : IDL.Nat,
     'canisters' : IDL.Vec(DriverCanister),
   });
-  const Result_5 = IDL.Variant({ 'ok' : DriverCanistersPage, 'err' : Error });
+  const Result_8 = IDL.Variant({ 'ok' : DriverCanistersPage, 'err' : Error });
+  const DriverRoomView = IDL.Record({
+    'recipient' : IDL.Principal,
+    'driverKey' : IDL.Text,
+    'canister' : IDL.Principal,
+    'lastError' : IDL.Opt(IDL.Text),
+    'roomId' : IDL.Text,
+    'synced' : IDL.Bool,
+  });
+  const Result_7 = IDL.Variant({
+    'ok' : IDL.Vec(DriverRoomView),
+    'err' : Error,
+  });
+  const Result_6 = IDL.Variant({ 'ok' : ClaimCode, 'err' : Error });
+  const Result_5 = IDL.Variant({ 'ok' : ChatConfig, 'err' : Error });
+  const ClaimTtlArgs = IDL.Record({ 'seconds' : IDL.Nat });
+  const Result = IDL.Variant({ 'ok' : IDL.Nat, 'err' : Error });
   const SetProfileArgs = IDL.Record({ 'name' : IDL.Text });
   const UnblockDriverArgs = IDL.Record({
     'driverKey' : IDL.Opt(IDL.Text),
@@ -227,43 +278,51 @@ 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_13], []),
+    'addPoolCanister' : IDL.Func([CanisterArgs], [Result_17], []),
     'blockDriver' : IDL.Func([BlockDriverArgs], [Result_2], []),
     'blockRider' : IDL.Func([BlockRiderArgs], [Result_2], []),
+    'claimDriverCanister' : IDL.Func([ClaimArgs], [Result_17], []),
     'clearLogs' : IDL.Func([], [], []),
-    'commitDriverWasm' : IDL.Func([WasmCommitArgs], [Result_18], []),
-    'createLocalPoolCanister' : IDL.Func([], [Result_13], []),
-    'createMyDriverCanister' : IDL.Func([], [Result_13], []),
-    'ensureSimulator' : IDL.Func([], [Result_17], []),
-    'extendDemoLease' : IDL.Func([], [Result_13], []),
-    'getAdmins' : IDL.Func([], [Result_16], ['query']),
+    'commitDriverWasm' : IDL.Func([WasmCommitArgs], [Result_23], []),
+    'createLocalPoolCanister' : IDL.Func([], [Result_17], []),
+    'createMyDriverCanister' : IDL.Func([], [Result_17], []),
+    'ensureSimulator' : IDL.Func([], [Result_22], []),
+    'extendDemoLease' : IDL.Func([], [Result_17], []),
+    'getAdmins' : IDL.Func([], [Result_21], ['query']),
+    'getChatConfig' : IDL.Func([], [IDL.Opt(ChatConfig)], ['query']),
+    'getChatRoomsStatus' : IDL.Func([], [Result_20], ['query']),
     'getDriverCanisterStatus' : IDL.Func(
         [CanisterArgs],
         [DriverCanisterStatus],
         ['query'],
       ),
-    'getDriverRollout' : IDL.Func([], [Result_15], ['query']),
-    'getFactoryStatus' : IDL.Func([], [Result_14], ['query']),
+    'getDriverRollout' : IDL.Func([], [Result_19], ['query']),
+    'getFactoryStatus' : IDL.Func([], [Result_18], ['query']),
     'getLogs' : IDL.Func([], [IDL.Text], ['query']),
-    'getMyDriverCanister' : IDL.Func([], [Result_13], ['query']),
+    'getMyDriverCanister' : IDL.Func([], [Result_17], ['query']),
     'getMyProfile' : IDL.Func([], [Result_4], ['query']),
-    'getMyRides' : IDL.Func([RidesPageArgs], [Result_12], ['query']),
-    'getProfiles' : IDL.Func([ProfilesArgs], [Result_11], ['query']),
+    'getMyRating' : IDL.Func([], [Result_16], ['query']),
+    'getMyRides' : IDL.Func([RidesPageArgs], [Result_15], ['query']),
+    'getProfiles' : IDL.Func([ProfilesArgs], [Result_14], ['query']),
     'getReleasedDriverWasms' : IDL.Func([], [IDL.Vec(ReleasedWasm)], ['query']),
     'getSimulator' : IDL.Func([], [IDL.Opt(IDL.Principal)], ['query']),
-    'getWiring' : IDL.Func([], [Result_10], ['query']),
-    'getWorkerOutbox' : IDL.Func([], [Result_9], ['query']),
+    'getWiring' : IDL.Func([], [Result_13], ['query']),
+    'getWorkerOutbox' : IDL.Func([], [Result_12], ['query']),
     'helloFromWorker' : IDL.Func([], [Result_2], []),
-    'ingestRideBatch' : IDL.Func([RideBatch], [Result_8], []),
-    'leaseDemoDriverCanister' : IDL.Func([], [Result_7], []),
-    'listBlocks' : IDL.Func([PageArgs], [Result_6], ['query']),
-    'listDriverCanisters' : IDL.Func([PageArgs], [Result_5], ['query']),
+    'ingestRideBatch' : IDL.Func([RideBatch], [Result_11], []),
+    'isUser' : IDL.Func([IDL.Principal], [IDL.Bool], ['query']),
+    'leaseDemoDriverCanister' : IDL.Func([], [Result_10], []),
+    'listBlocks' : IDL.Func([PageArgs], [Result_9], ['query']),
+    'listDriverCanisters' : IDL.Func([PageArgs], [Result_8], ['query']),
+    'listDriverRooms' : IDL.Func([PageArgs], [Result_7], ['query']),
+    'newClaimCode' : IDL.Func([], [Result_6], []),
     'removeAdmin' : IDL.Func([PrincipalArgs], [Result_2], []),
     'resumeDriverRollout' : IDL.Func([], [Result_3], []),
+    'setChatConfig' : IDL.Func([ChatConfig], [Result_5], []),
+    'setClaimCodeTtl' : IDL.Func([ClaimTtlArgs], [Result], []),
     'setLoggingEnabled' : IDL.Func([IDL.Bool], [Result_2], []),
     'setLowCyclesBelow' : IDL.Func([IDL.Nat], [Result_2], []),
     'setMyProfile' : IDL.Func([SetProfileArgs], [Result_4], []),

package/dist/actors/driver-canisters-actor.d.ts

@@ -0,0 +1,77 @@
+import type { Identity } from "@icp-sdk/core/agent";
+import type { ClaimCode as CandidClaimCode, DriverCanister as CandidDriverCanister } from "../../declarations/core/core.did.js";
+import { type GroupOptions } from "../group/canister-actor.js";
+import type { ClaimCodeView, DemoLeaseView, DriverCanisterView } from "../interfaces.js";
+/** The fragment key of a claim link: `https://<canister>.icp0.io/#claim=<code>`. */
+export declare const CLAIM_FRAGMENT_KEY = "claim";
+/** F-20a: a code is 32 characters of base64url; the core refuses more than this. */
+export declare const MAX_CLAIM_CODE_CHARS = 64;
+/**
+ * F-20: the link the rider's site shows after a lease ("Otwórz swój kanister"). The code
+ * rides in the fragment, which the browser never sends to a server.
+ * @param frontOrigin the origin of the driver canister's front; default `https://<canister>.icp0.io`
+ */
+export declare function claimLinkOf(canisterId: string, code: string, frontOrigin?: string): string;
+/**
+ * F-20: the claim code in a location hash (`#claim=<code>`, also among other `&` parts), or
+ * undefined. The driver's front clears the fragment after the claim.
+ */
+export declare function claimCodeOfHash(hash: string): string | undefined;
+/** @internal */
+export declare function driverCanisterOf(record: Pick<CandidDriverCanister, "canister" | "owner" | "kind" | "leaseUntilNs" | "blocked">): DriverCanisterView;
+/** @internal */
+export declare function claimCodeOf(claim: CandidClaimCode): ClaimCodeView;
+export declare class DriverCanistersActor {
+    private readonly group;
+    constructor(coordinatorId: string, identity: Identity, options?: GroupOptions);
+    /**
+     * F-5 … F-7, F-20a: a demo canister for 15 minutes, reinstalled with the caller as its
+     * owner — or the caller's lease already (no reinstall, no code: `newClaimCodeAsyncUnsafe`).
+     * @returns `leased` with `claim` after a fresh lease (undefined when the core could make
+     *          no code — ask `newClaimCodeAsyncUnsafe`); `busy` with the time the pool frees up
+     * @throws Error with message `CanisterError` — `NotAuthorized` (prod), `NotFound` (no pool),
+     *         `InvalidData` (no driver wasm), `RemoteCanisterError` (the install failed)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    leaseDemoAsyncUnsafe(): Promise<DemoLeaseView>;
+    /**
+     * F-8: 15 minutes more for the holder of the demo canister (at most 30 ahead), also after
+     * the end while nobody took it over. The owner stays (F-20f).
+     * @throws Error with message `CanisterError` — `NotFound` (no lease of the caller), `InvalidData` (being installed)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    extendDemoAsyncUnsafe(): Promise<DriverCanisterView>;
+    /**
+     * The caller's own driver canister, or the demo canister the caller holds now (as the
+     * lease holder — after a claim the canister's owner is the driver, `ownerPrincipal`).
+     * @returns undefined when the caller has none
+     * @throws Error with message `CanisterError` — `NotAuthorized` (anonymous)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    getMineAsyncUnsafe(): Promise<DriverCanisterView | undefined>;
+    /**
+     * F-20c: a new claim code for the caller's running demo lease ("Nowy link"); the code
+     * before it stops working. Good for 15 minutes, once.
+     * @throws Error with message `CanisterError` — `NotFound` (no running lease of the caller),
+     *         `InvalidData` (being installed), `RemoteCanisterError` (no randomness — try again)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    newClaimCodeAsyncUnsafe(): Promise<ClaimCodeView>;
+    /**
+     * F-20d, F-20e: the caller — the driver signed in on the canister's own front — takes
+     * over the demo canister with the code of the link. The canister's owner becomes the
+     * caller, and so does the recipient of its chat room; the lease stays with its holder.
+     * @returns the canister with the caller as `ownerPrincipal`
+     * @throws Error with message `CanisterError` — `NotAuthorized` (the code is wrong, expired,
+     *         used, or not for this canister — one answer for all), `InvalidData` (the canister
+     *         is busy — try again), `RemoteCanisterError` (the driver canister did not take it;
+     *         the code stays good)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    claimAsyncUnsafe(canisterId: string, code: string): Promise<DriverCanisterView>;
+}
+//# sourceMappingURL=driver-canisters-actor.d.ts.map

package/dist/actors/driver-canisters-actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-canisters-actor.d.ts","sourceRoot":"","sources":["../../src/actors/driver-canisters-actor.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,IAAI,eAAe,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChI,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/F,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGzF,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,MAAwC,GAAG,MAAM,CAE3H;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBhE;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC,GAAG,kBAAkB,CAUnJ;AAED,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,CAEjE;AAED,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAEtB,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB;IAIjF;;;;;;;;;OASG;IACU,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC;IAS3D;;;;;;OAMG;IACU,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAIjE;;;;;;OAMG;IACU,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAS1E;;;;;;;OAOG;IACU,uBAAuB,IAAI,OAAO,CAAC,aAAa,CAAC;IAI9D;;;;;;;;;;;OAWG;IACU,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAU/F"}