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

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

@@ -70,6 +70,26 @@ export const idlFactory = ({ IDL }) => {
     'driverPosition' : IDL.Opt(Geo),
   });
   const RideAnswer = IDL.Variant({ 'ok' : RideView, 'err' : ProtocolError });
+  const RouteLine = IDL.Record({ 'ride' : IDL.Text, 'toPickup' : IDL.Text });
+  const RouteAnswer = IDL.Variant({ 'ok' : RouteLine, 'err' : ProtocolError });
+  const RouteTaskView = IDL.Record({
+    'untilNs' : IDL.Nat64,
+    'destination' : Geo,
+    'requestId' : IDL.Text,
+    'from' : Geo,
+    '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({
+    'Ok' : IDL.Vec(RouteTaskView),
+    'Err' : SimulatorError,
+  });
   const Event = IDL.Record({
     'atNs' : IDL.Nat64,
     'kind' : IDL.Text,
@@ -82,6 +102,7 @@ export const idlFactory = ({ IDL }) => {
     'liveDrivers' : IDL.Nat64,
     'events' : IDL.Vec(Event),
     'drivers' : IDL.Nat64,
+    'router' : IDL.Opt(IDL.Principal),
     'rides' : IDL.Nat64,
   });
   const HttpRequest = IDL.Record({
@@ -128,17 +149,12 @@ export const idlFactory = ({ IDL }) => {
     'riderName' : IDL.Text,
     'rider' : IDL.Principal,
   });
+  const SetRouterArgs = IDL.Record({ 'router' : IDL.Opt(IDL.Principal) });
+  const Result_1 = IDL.Variant({ 'Ok' : IDL.Null, 'Err' : SimulatorError });
   const SpeedUpArgs = IDL.Record({
     'requestId' : IDL.Text,
     'factor' : IDL.Nat8,
   });
-  const SimulatorError = IDL.Variant({
-    'RemoteCanisterError' : IDL.Text,
-    'NotFound' : IDL.Null,
-    'NotAuthorized' : IDL.Text,
-    'InvalidData' : IDL.Text,
-  });
-  const Result = IDL.Variant({ 'Ok' : IDL.Null, 'Err' : SimulatorError });
   const SpawnArgs = IDL.Record({ 'center' : Geo, 'count' : IDL.Opt(IDL.Nat8) });
   const SpawnResult = IDL.Record({
     'problems' : IDL.Vec(IDL.Text),
@@ -146,19 +162,32 @@ export const idlFactory = ({ IDL }) => {
     'registered' : IDL.Nat32,
     'validUntilNs' : IDL.Nat64,
   });
-  const Result_1 = IDL.Variant({ 'Ok' : SpawnResult, 'Err' : SimulatorError });
+  const Result_2 = IDL.Variant({ 'Ok' : SpawnResult, 'Err' : SimulatorError });
+  const SimRouteResult = IDL.Record({
+    'requestId' : IDL.Text,
+    'rideMeters' : IDL.Nat32,
+    'rideSec' : IDL.Nat32,
+    'routeLine' : IDL.Opt(RouteLine),
+    'driverKey' : IDL.Text,
+    'toPickupSec' : IDL.Nat32,
+    'toPickupMeters' : IDL.Nat32,
+  });
   return IDL.Service({
     'cancelRide' : IDL.Func([RideRef], [ProtocolAnswer], []),
     'getLicence' : IDL.Func([RideRef], [LicenceAnswer], ['query']),
     'getRide' : IDL.Func([RideRef], [RideAnswer], ['query']),
+    'getRideRoute' : IDL.Func([RideRef], [RouteAnswer], ['query']),
+    'getRouteTasks' : IDL.Func([], [Result], ['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], []),
-    'setSpeedUp' : IDL.Func([SpeedUpArgs], [Result], []),
-    'spawnDrivers' : IDL.Func([SpawnArgs], [Result_1], []),
+    'setRouter' : IDL.Func([SetRouterArgs], [Result_1], []),
+    'setSpeedUp' : IDL.Func([SpeedUpArgs], [Result_1], []),
+    'spawnDrivers' : IDL.Func([SpawnArgs], [Result_2], []),
+    'submitRoute' : IDL.Func([SimRouteResult], [Result_1], []),
   });
 };
 export const init = ({ IDL }) => {

package/declarations/worker/worker.did

@@ -28,19 +28,22 @@ type TigiWorker =
    /// from there. Blocks act at once (WO-2); ratings go into offers and orders (P-12).
    applyCoreChanges: (batch: CoreChanges) -> (Result);
    /// ZO-13, ZO-14, ZO-17.
-   chooseOffer: (ref: OfferRef) -> (Result_8);
+   chooseOffer: (ref: OfferRef) -> (Result_9);
    clearLogs: () -> ();
    /// ZO-15 (otherOfferChosen after an acceptance in another worker), ZO-18 (riderGaveUp).
    closeRequest: (args: CloseRequestArgs) -> (Result_2);
    /// The coordinator only: the settings it computes for every worker.
-   configure: (args: ConfigureArgs) -> (Result_7);
+   configure: (args: ConfigureArgs) -> (Result_8);
    /// ZO-6.
    declineQuote: (decline: QuoteDecline) -> ();
    /// What this worker holds of the core's network state.
    getCoreCopyStatus: () -> (CoreCopyStatus) query;
    /// The flow's numbers (scripts, the coordinator's front).
-   getFlowStatus: () -> (Result_6) query;
+   getFlowStatus: () -> (Result_7) query;
    getLogs: () -> (text) query;
+   /// ZO-21 (2026-10-24, route line): the route line of one offer, for the rider of the
+   /// request only (the package asks after a tap on the offer).
+   getOfferRoute: (ref: OfferRef) -> (Result_6) query;
    /// The load this worker counts per geohash prefix of the given length (1–6): the
    /// coordinator picks from it what to give another worker on a split (KO-5).
    getPrefixCounts: (length: nat) -> (Result_5) query;
@@ -89,6 +92,11 @@ type TestLoadArgs =
    cells: vec PrefixCount;
    reportLevel: opt nat;
  };
+type RouteLine = 
+ record {
+   ride: text;
+   toPickup: text;
+ };
 type RiderRating = 
  record {
    driverKey: DriverKey;
@@ -111,21 +119,26 @@ type RideStatus =
    driverArrived;
    inProgress;
  };
-type Result_8 = 
+type Result_9 = 
  variant {
    err: Error;
    ok: ChooseOutcome;
  };
-type Result_7 = 
+type Result_8 = 
  variant {
    err: Error;
    ok: WorkerConfig;
  };
-type Result_6 = 
+type Result_7 = 
  variant {
    err: Error;
    ok: FlowStatus;
  };
+type Result_6 = 
+ variant {
+   err: Error;
+   ok: RouteLine;
+ };
 type Result_5 = 
  variant {
    err: Error;
@@ -217,11 +230,13 @@ type QuoteDecline =
 type Quote = 
  record {
    driverKey: DriverKey;
+   driverPosition: opt Geo;
    etaToPickupSec: nat32;
    price: Money;
    requestId: RequestId;
    rideMeters: nat32;
    rideSec: nat32;
+   routeLine: opt RouteLine;
    toPickupMeters: nat32;
    validUntilNs: nat64;
  };
@@ -262,6 +277,7 @@ type OfferView =
    card: DriverCard;
    driverCanister: principal;
    driverKey: DriverKey;
+   driverPosition: opt Geo;
    driverRating: opt nat16;
    etaToPickupSec: nat32;
    pinGeohash: text;
@@ -335,6 +351,7 @@ type FlowStatus =
    openRequests: nat;
    outboxPending: nat;
    rides: nat;
+   usagePending: opt nat;
  };
 type ErrorDetails = 
  variant {

package/declarations/worker/worker.did.d.ts

@@ -85,6 +85,7 @@ export type ErrorDetails = { 'InterCanisterConnectionError' : null } |
   { 'ReturnsNull' : null };
 export interface FlowStatus {
   'helloDone' : boolean,
+  'usagePending' : [] | [bigint],
   'activeRides' : bigint,
   'knownDriverCanisters' : bigint,
   'liveDrivers' : bigint,
@@ -141,6 +142,7 @@ export interface OfferView {
   'driverCanister' : Principal,
   'price' : Money,
   'etaToPickupSec' : number,
+  'driverPosition' : [] | [Geo],
   'toPickupMeters' : number,
   'validUntilNs' : bigint,
 }
@@ -165,9 +167,11 @@ export interface Quote {
   'requestId' : RequestId,
   'rideMeters' : number,
   'rideSec' : number,
+  'routeLine' : [] | [RouteLine],
   'driverKey' : DriverKey,
   'price' : Money,
   'etaToPickupSec' : number,
+  'driverPosition' : [] | [Geo],
   'toPickupMeters' : number,
   'validUntilNs' : bigint,
 }
@@ -232,11 +236,13 @@ export type Result_4 = { 'ok' : WorkerStatus } |
   { 'err' : Error };
 export type Result_5 = { 'ok' : Array<PrefixCount> } |
   { 'err' : Error };
-export type Result_6 = { 'ok' : FlowStatus } |
+export type Result_6 = { 'ok' : RouteLine } |
   { 'err' : Error };
-export type Result_7 = { 'ok' : WorkerConfig } |
+export type Result_7 = { 'ok' : FlowStatus } |
   { 'err' : Error };
-export type Result_8 = { 'ok' : ChooseOutcome } |
+export type Result_8 = { 'ok' : WorkerConfig } |
+  { 'err' : Error };
+export type Result_9 = { 'ok' : ChooseOutcome } |
   { 'err' : Error };
 export type RideStatus = { 'completed' : { 'price' : Money } } |
   { 'cancelledByRider' : null } |
@@ -255,6 +261,7 @@ export interface RiderRating {
   'stars' : number,
   'driverKey' : DriverKey,
 }
+export interface RouteLine { 'ride' : string, 'toPickup' : string }
 export interface TestLoadArgs {
   'reportLevel' : [] | [bigint],
   'cells' : Array<PrefixCount>,
@@ -273,7 +280,7 @@ export interface TigiWorker {
   /**
    * / ZO-13, ZO-14, ZO-17.
    */
-  'chooseOffer' : ActorMethod<[OfferRef], Result_8>,
+  'chooseOffer' : ActorMethod<[OfferRef], Result_9>,
   'clearLogs' : ActorMethod<[], undefined>,
   /**
    * / ZO-15 (otherOfferChosen after an acceptance in another worker), ZO-18 (riderGaveUp).
@@ -282,7 +289,7 @@ export interface TigiWorker {
   /**
    * / The coordinator only: the settings it computes for every worker.
    */
-  'configure' : ActorMethod<[ConfigureArgs], Result_7>,
+  'configure' : ActorMethod<[ConfigureArgs], Result_8>,
   /**
    * / ZO-6.
    */
@@ -294,8 +301,13 @@ export interface TigiWorker {
   /**
    * / The flow's numbers (scripts, the coordinator's front).
    */
-  'getFlowStatus' : ActorMethod<[], Result_6>,
+  'getFlowStatus' : ActorMethod<[], Result_7>,
   'getLogs' : ActorMethod<[], string>,
+  /**
+   * / ZO-21 (2026-10-24, route line): the route line of one offer, for the rider of the
+   * / request only (the package asks after a tap on the offer).
+   */
+  'getOfferRoute' : ActorMethod<[OfferRef], Result_6>,
   /**
    * / The load this worker counts per geohash prefix of the given length (1–6): the
    * / coordinator picks from it what to give another worker on a split (KO-5).

package/declarations/worker/worker.did.js

@@ -92,7 +92,7 @@ export const idlFactory = ({ IDL }) => {
     'ordered' : IDL.Record({ 'answerByNs' : IDL.Nat64 }),
     'driverNotFree' : IDL.Null,
   });
-  const Result_8 = IDL.Variant({ 'ok' : ChooseOutcome, 'err' : Error });
+  const Result_9 = IDL.Variant({ 'ok' : ChooseOutcome, 'err' : Error });
   const CloseReason = IDL.Variant({
     'offerRejected' : IDL.Null,
     'otherOfferChosen' : IDL.Null,
@@ -124,7 +124,7 @@ export const idlFactory = ({ IDL }) => {
     'load' : LoadThresholds,
     'lowCyclesBelow' : IDL.Nat,
   });
-  const Result_7 = IDL.Variant({ 'ok' : WorkerConfig, 'err' : Error });
+  const Result_8 = IDL.Variant({ 'ok' : WorkerConfig, 'err' : Error });
   const QuoteDecline = IDL.Record({
     'requestId' : RequestId,
     'driverKey' : DriverKey,
@@ -140,6 +140,7 @@ export const idlFactory = ({ IDL }) => {
   });
   const FlowStatus = IDL.Record({
     'helloDone' : IDL.Bool,
+    'usagePending' : IDL.Opt(IDL.Nat),
     'activeRides' : IDL.Nat,
     'knownDriverCanisters' : IDL.Nat,
     'liveDrivers' : IDL.Nat,
@@ -149,7 +150,9 @@ export const idlFactory = ({ IDL }) => {
     'rides' : IDL.Nat,
     'openRequests' : IDL.Nat,
   });
-  const Result_6 = IDL.Variant({ 'ok' : FlowStatus, 'err' : Error });
+  const Result_7 = IDL.Variant({ 'ok' : FlowStatus, 'err' : Error });
+  const RouteLine = IDL.Record({ 'ride' : IDL.Text, 'toPickup' : IDL.Text });
+  const Result_6 = IDL.Variant({ 'ok' : RouteLine, 'err' : Error });
   const PrefixCount = IDL.Record({ 'load' : IDL.Nat, 'prefix' : IDL.Text });
   const Result_5 = IDL.Variant({ 'ok' : IDL.Vec(PrefixCount), 'err' : Error });
   const RequestRef = IDL.Record({ 'requestId' : RequestId });
@@ -168,6 +171,7 @@ export const idlFactory = ({ IDL }) => {
     'hasLicencePhoto' : IDL.Bool,
   });
   const Money = IDL.Record({ 'currency' : IDL.Text, 'amount' : IDL.Nat64 });
+  const Geo = IDL.Record({ 'lat' : IDL.Float64, 'lng' : IDL.Float64 });
   const OfferView = IDL.Record({
     'rideMeters' : IDL.Nat32,
     'driverRating' : IDL.Opt(IDL.Nat16),
@@ -180,6 +184,7 @@ export const idlFactory = ({ IDL }) => {
     'driverCanister' : IDL.Principal,
     'price' : Money,
     'etaToPickupSec' : IDL.Nat32,
+    'driverPosition' : IDL.Opt(Geo),
     'toPickupMeters' : IDL.Nat32,
     'validUntilNs' : IDL.Nat64,
   });
@@ -241,7 +246,6 @@ export const idlFactory = ({ IDL }) => {
   });
   const Result_4 = IDL.Variant({ 'ok' : WorkerStatus, 'err' : Error });
   const Result_3 = IDL.Variant({ 'ok' : IDL.Nat, 'err' : Error });
-  const Geo = IDL.Record({ 'lat' : IDL.Float64, 'lng' : IDL.Float64 });
   const HasSimulatedDriversArgs = IDL.Record({ 'center' : Geo });
   const TestLoadArgs = IDL.Record({
     'reportLevel' : IDL.Opt(IDL.Nat),
@@ -290,23 +294,26 @@ export const idlFactory = ({ IDL }) => {
     'requestId' : RequestId,
     'rideMeters' : IDL.Nat32,
     'rideSec' : IDL.Nat32,
+    'routeLine' : IDL.Opt(RouteLine),
     'driverKey' : DriverKey,
     'price' : Money,
     'etaToPickupSec' : IDL.Nat32,
+    'driverPosition' : IDL.Opt(Geo),
     'toPickupMeters' : IDL.Nat32,
     'validUntilNs' : IDL.Nat64,
   });
   const TigiWorker = IDL.Service({
     'answerOrder' : IDL.Func([OrderAnswer], [ProtocolResult], []),
     'applyCoreChanges' : IDL.Func([CoreChanges], [Result], []),
-    'chooseOffer' : IDL.Func([OfferRef], [Result_8], []),
+    'chooseOffer' : IDL.Func([OfferRef], [Result_9], []),
     'clearLogs' : IDL.Func([], [], []),
     'closeRequest' : IDL.Func([CloseRequestArgs], [Result_2], []),
-    'configure' : IDL.Func([ConfigureArgs], [Result_7], []),
+    'configure' : IDL.Func([ConfigureArgs], [Result_8], []),
     'declineQuote' : IDL.Func([QuoteDecline], [], []),
     'getCoreCopyStatus' : IDL.Func([], [CoreCopyStatus], ['query']),
-    'getFlowStatus' : IDL.Func([], [Result_6], ['query']),
+    'getFlowStatus' : IDL.Func([], [Result_7], ['query']),
     'getLogs' : IDL.Func([], [IDL.Text], ['query']),
+    'getOfferRoute' : IDL.Func([OfferRef], [Result_6], ['query']),
     'getPrefixCounts' : IDL.Func([IDL.Nat], [Result_5], ['query']),
     'getRequest' : IDL.Func([RequestRef], [Result_1], ['query']),
     'getStatus' : IDL.Func([], [Result_4], ['query']),

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"}

package/dist/actors/profiles-actor.js

@@ -1,23 +1,14 @@
 // The rider's account and history in the core (core.md C-2, C-3, C-8; U-20, U-21). The core
 // is found through the coordinator (sharding.md): the consumer gives the coordinator's id.
-import { errorKeyOf, executeAsyncUnsafe } from "../group/canister-actor.js";
+import { canisterError, errorKeyOf, executeAsyncUnsafe } from "../group/canister-actor.js";
 import { TigiGroup } from "../group/group.js";
-import { decodeToken, encodeToken, moneyOf, msOf } from "../mappers.js";
+import { decodeToken, encodeToken, historyEntryOf, rateOutcomeOf, rideOfRideRef } from "../mappers.js";
 /** KU-1: a page of the rider's history. */
 export const RIDES_PAGE = 20;
 const NS_PER_MS_INT = 1000000n;
 function profileOf(profile) {
     return { name: profile.name, createdMs: Number(profile.createdAtNs / NS_PER_MS_INT), updatedMs: Number(profile.updatedAtNs / NS_PER_MS_INT) };
 }
-function entryOf(entry) {
-    return {
-        rideRef: encodeToken({ c: entry.driverCanister.toText(), k: entry.driverKey, r: entry.requestId }),
-        requestId: entry.requestId,
-        end: Object.keys(entry.end)[0],
-        endedAtMs: msOf(entry.endedAtNs),
-        price: entry.price[0] === undefined ? undefined : moneyOf(entry.price[0]),
-    };
-}
 export class ProfilesActor {
     group;
     constructor(coordinatorId, identity, options = {}) {
@@ -76,8 +67,51 @@ export class ProfilesActor {
         const beforeIndex = cursor === undefined ? [] : [BigInt(decodeToken(cursor).b)];
         const page = await executeAsyncUnsafe(async () => (await this.group.coreAsync()).getMyRides({ beforeIndex: beforeIndex, limit: BigInt(limit) }));
         return {
-            rides: page.rides.map(entryOf),
+            rides: page.rides.map(historyEntryOf),
             nextCursor: page.nextBeforeIndex[0] === undefined ? undefined : encodeToken({ b: page.nextBeforeIndex[0].toString() }),
         };
     }
+    /**
+     * 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
+     */
+    async getMyRideAsyncUnsafe(rideRef) {
+        const ride = rideOfRideRef(rideRef);
+        try {
+            return historyEntryOf(await executeAsyncUnsafe(async () => (await this.group.coreAsync()).getMyRide({ requestId: ride.requestId })));
+        }
+        catch (err) {
+            if (errorKeyOf(err) === "NotFound")
+                return undefined;
+            throw err;
+        }
+    }
+    /**
+     * 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
+     */
+    async ratePastRideAsyncUnsafe(rideRef, stars) {
+        const ride = rideOfRideRef(rideRef);
+        if (!Number.isInteger(stars) || stars < 1 || stars > 5)
+            throw canisterError("InvalidData", "stars: 1 to 5");
+        try {
+            const answer = await executeAsyncUnsafe(async () => (await this.group.coreAsync()).rateMyRide({ requestId: ride.requestId, stars }));
+            return rateOutcomeOf(answer) ?? "notRatable";
+        }
+        catch (err) {
+            const outcome = rateOutcomeOf({ errorKey: errorKeyOf(err) });
+            if (outcome !== undefined)
+                return outcome;
+            throw err;
+        }
+    }
 }

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

@@ -2,7 +2,7 @@ import type { Identity } from "@icp-sdk/core/agent";
 import { type GroupOptions } from "../group/canister-actor.js";
 import { TigiGroup } from "../group/group.js";
 import { type Geo } from "../geo.js";
-import type { ChatPlace, ChooseOutcome, LicenceView, RequestSnapshot, RideView } from "../interfaces.js";
+import type { ChatPlace, ChooseOutcome, LicenceView, RequestSnapshot, RideView, RouteLineView } from "../interfaces.js";
 /** U-29: the rider's radius, and the radius after `WIDEN_AFTER_MS` without offers. */
 export declare const SEARCH_RADIUS_METERS = 3000;
 export declare const WIDE_RADIUS_METERS = 6000;
@@ -159,6 +159,26 @@ export declare class RideRequest {
      * @throws Error with message `CriticalCanisterError` — the worker could not be reached
      */
     chooseOfferAsyncUnsafe(offerId: string): Promise<ChooseOutcome>;
+    /**
+     * ZO-21 (2026-10-24, route line): the driver's route of one offer, to draw when the rider
+     * taps it — from the driver's exact position to the pickup, then the ride (P-17). One
+     * query per tap: the lines are not in the polled snapshot.
+     * @returns undefined when the offer has no line: an older driver canister or worker, a
+     *   line the network dropped (too big, not valid), the offer past its time or gone, or its
+     *   worker upgraded since (the line lives in the worker's heap only, WO-22)
+     * @throws Error with message `CanisterError` — `NotAuthorized` (not your request), `NotFound` (an offer this request does not hold), `InvalidToken`
+     * @throws Error with message `CriticalCanisterError` — the worker could not be reached
+     */
+    getOfferRouteAsyncUnsafe(offerId: string): Promise<RouteLineView | undefined>;
+    /**
+     * K-13 (2026-10-24, route line): the line of the accepted ride, while it is active — read
+     * once (it does not change), not in `getRideAsyncUnsafe`, which is polled (P-19).
+     * @returns undefined when the ride has no line (the quote had none), has ended, or the
+     *   driver canister is older than the line (no `getRideRoute`)
+     * @throws Error with message `CanisterError` — `NOT_ACCEPTED` (no driver accepted yet), `notAuthorized` (not the rider of the ride)
+     * @throws Error with message `CriticalCanisterError` — the driver canister does not answer
+     */
+    getRideRouteAsyncUnsafe(): Promise<RouteLineView | undefined>;
     /**
      * K-5, U-42: "Szukaj ponownie" after "Kierowca anulował kurs" — a NEW request with the
      * same pickup, destination and rider name (a new `requestId`; the old request ended with

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

@@ -1 +1 @@
-{"version":3,"file":"rides-actor.d.ts","sourceRoot":"","sources":["../../src/actors/rides-actor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rides-actor.d.ts","sourceRoot":"","sources":["../../src/actors/rides-actor.ts"],"names":[],"mappings":"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"}

package/dist/actors/rides-actor.js

@@ -6,12 +6,12 @@
 // driver canister: a request is a `RideRequest`, an offer an `offerId`.
 import { Principal } from "@icp-sdk/core/principal";
 import { idlFactory as driverIdl } from "../../declarations/tigi-driver/tigi-driver.did.js";
-import { canisterError, errorKeyOf, executeAsyncUnsafe, executeProtocolAsyncUnsafe, MAINNET_HOST, rawActorAsync, transportAsync } from "../group/canister-actor.js";
+import { canisterError, errorKeyOf, executeAsyncUnsafe, executeProtocolAsyncUnsafe, isMethodMissingError, MAINNET_HOST, rawActorAsync, transportAsync } from "../group/canister-actor.js";
 import { TigiGroup } from "../group/group.js";
 import { geohashesByWorker } from "../group/prefixes.js";
 import { cellsWithin, isValidGeo } from "../geo.js";
 import { driverChatPlaceAsyncUnsafe } from "../chat.js";
-import { cardOf, closeReasonOf, decodeToken, driverOfOfferId, encodeToken, mergedPhase, mergeOffers, moneyOf, msOf, offerIdOf, offerOf, phaseOf, placeOffers, rideStatusOf } from "../mappers.js";
+import { cardOf, closeReasonOf, decodeToken, driverOfOfferId, encodeToken, mergedPhase, mergeOffers, moneyOf, msOf, offerIdOf, offerOf, phaseOf, placeOffers, rideOfRideRef, rideStatusOf, routeLineOf } from "../mappers.js";
 /** U-29: the rider's radius, and the radius after `WIDEN_AFTER_MS` without offers. */
 export const SEARCH_RADIUS_METERS = 3_000;
 export const WIDE_RADIUS_METERS = 6_000;
@@ -110,10 +110,8 @@ export class RidesActor {
      * @throws Error with message `CriticalCanisterError` — the driver canister does not answer ("brak połączenia z kierowcą")
      */
     async getPastRideAsyncUnsafe(rideRef) {
-        const ref = decodeToken(rideRef);
-        if (typeof ref.c !== "string" || typeof ref.k !== "string" || typeof ref.r !== "string")
-            throw canisterError("InvalidToken", "not a ride of this package");
-        return getRideOfAsyncUnsafe(this.identity, this.options, { canister: ref.c, driverKey: ref.k }, ref.r);
+        const ref = rideOfRideRef(rideRef);
+        return getRideOfAsyncUnsafe(this.identity, this.options, { canister: ref.canister, driverKey: ref.driverKey }, ref.requestId);
     }
     async riderNameAsyncUnsafe() {
         try {
@@ -328,6 +326,48 @@ export class RideRequest {
             this.choosing = false;
         }
     }
+    /**
+     * ZO-21 (2026-10-24, route line): the driver's route of one offer, to draw when the rider
+     * taps it — from the driver's exact position to the pickup, then the ride (P-17). One
+     * query per tap: the lines are not in the polled snapshot.
+     * @returns undefined when the offer has no line: an older driver canister or worker, a
+     *   line the network dropped (too big, not valid), the offer past its time or gone, or its
+     *   worker upgraded since (the line lives in the worker's heap only, WO-22)
+     * @throws Error with message `CanisterError` — `NotAuthorized` (not your request), `NotFound` (an offer this request does not hold), `InvalidToken`
+     * @throws Error with message `CriticalCanisterError` — the worker could not be reached
+     */
+    async getOfferRouteAsyncUnsafe(offerId) {
+        try {
+            const line = await this.onOfferAsyncUnsafe(offerId, (actor, ref) => actor.getOfferRoute(ref));
+            return routeLineOf(line);
+        }
+        catch (err) {
+            // A held offer without a line; an older worker without the method.
+            if ((errorKeyOf(err) === "NotFound" && this.offerWorkers.has(offerId)) || isMethodMissingError(err))
+                return undefined;
+            throw err;
+        }
+    }
+    /**
+     * K-13 (2026-10-24, route line): the line of the accepted ride, while it is active — read
+     * once (it does not change), not in `getRideAsyncUnsafe`, which is polled (P-19).
+     * @returns undefined when the ride has no line (the quote had none), has ended, or the
+     *   driver canister is older than the line (no `getRideRoute`)
+     * @throws Error with message `CanisterError` — `NOT_ACCEPTED` (no driver accepted yet), `notAuthorized` (not the rider of the ride)
+     * @throws Error with message `CriticalCanisterError` — the driver canister does not answer
+     */
+    async getRideRouteAsyncUnsafe() {
+        const accepted = await this.acceptedAsyncUnsafe();
+        try {
+            const line = await executeProtocolAsyncUnsafe(async () => (await this.driverAsync(accepted.canister)).getRideRoute({ requestId: this.state.requestId, driverKey: accepted.driverKey }));
+            return routeLineOf(line);
+        }
+        catch (err) {
+            if (errorKeyOf(err) === "notFound" || isMethodMissingError(err))
+                return undefined;
+            throw err;
+        }
+    }
     /**
      * K-5, U-42: "Szukaj ponownie" after "Kierowca anulował kurs" — a NEW request with the
      * same pickup, destination and rider name (a new `requestId`; the old request ended with

package/dist/geo.d.ts

@@ -7,6 +7,11 @@ export declare function isValidGeo(geo: Geo): boolean;
 export declare function encodeGeohash(geo: Geo, precision: number): string;
 /** The centre of the cell of a geohash; undefined for a character outside the alphabet. */
 export declare function decodeGeohashCenter(geohash: string): Geo | undefined;
+/**
+ * P-17: the points of a Google encoded polyline (precision 6 by default); undefined for a
+ * text that is not one or a point off the map.
+ */
+export declare function decodePolyline(text: string, precision?: number): Geo[] | undefined;
 /** Great-circle distance (haversine). */
 export declare function distanceMeters(a: Geo, b: Geo): number;
 /**

package/dist/geo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geo.d.ts","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,GAAG;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACf;AAID,eAAO,MAAM,mBAAmB,UAAY,CAAC;AAO7C,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAE5C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAyCjE;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CA2BpE;AAMD,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAMrD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAkCvE"}
+{"version":3,"file":"geo.d.ts","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,GAAG;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACf;AAID,eAAO,MAAM,mBAAmB,UAAY,CAAC;AAO7C,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAE5C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAyCjE;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CA2BpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,GAAG,EAAE,GAAG,SAAS,CAmC7E;AAMD,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAMrD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAkCvE"}