@maka/maka-cli 5.91.0 → 5.92.0

package/bundle/typescript/src/commands/game/sideQuest/utilities/catalog.d.ts

@@ -18,11 +18,140 @@ import { ICatalogItem } from './catalog-data.js';
  * source.ts, so models can import it without pulling in a command.
  */
 export declare const ROLE_DOMAINS: Record<string, string[]>;
+/** A catalog and the version it claims, from wherever it came. */
+export interface ICatalogSource {
+    version: number;
+    items: ICatalogItem[];
+    origin: 'live' | 'cache' | 'seed';
+}
+/**
+ * A VERSION NUMBER, OR NOTHING.
+ *
+ * `Number(undefined)`, `Number('')` and `Number('1.26.0')` are all NaN,
+ * and every comparison against NaN is false -- so an unversioned payload
+ * silently loses to whatever it is compared with. That is the SAFE
+ * direction (the seed wins) but a silent one, so it is named here and
+ * logged at the call site rather than left to fall out of the operator.
+ */
+export declare function parseCatalogVersion(raw: unknown): number | undefined;
+/**
+ * Reads the cache file. Injectable into loadCatalog because the
+ * alternative is a test that reads the DEVELOPER'S home directory --
+ * and this repo has already lost an afternoon to a suite that went red
+ * because a real config file said `hints: false`. A test must not care
+ * what is on the machine running it.
+ */
+type CacheReader = () => {
+    version: unknown;
+    items: ICatalogItem[];
+} | undefined;
+/**
+ * RECORD WHAT THE NETWORK RETURNED -- separated from the fetch so the
+ * wiring is reachable without a socket.
+ *
+ * This is not a test hatch, it is the step refreshCatalog was doing
+ * inline, and pulling it out is what makes the ACTUAL BUG SITE
+ * testable: the defect was never in how the candidates compare, it was
+ * that loadCatalog returned the live list without ever comparing it.
+ * A suite that only exercises chooseCatalog proves the comparison and
+ * says nothing about whether anyone calls it -- restoring the original
+ * one-line bug left such a suite completely green.
+ *
+ * An unusable version scores 0: present, comparable, and last.
+ */
+export declare function applyLiveCatalog(items: ICatalogItem[], version: number | undefined): void;
 /** Fire-and-forget refresh from the site -- call once at session start;
  *  the promise resolves when the live list (or a fallback) is settled. */
 export declare function refreshCatalog(): Promise<void>;
-/** The best catalog available right now: live > cached > baked-in. */
-export declare function loadCatalog(): ICatalogItem[];
+/**
+ * The best catalog available right now: live > cached > baked-in --
+ * except that a cache OLDER than the shipped seed is not "best", it is
+ * stale, and the seed wins.
+ *
+ * THIS USED TO BE `cache?.items ?? CATALOG_ITEMS`, which handed an
+ * upgraded client its old catalog until a refresh happened to succeed.
+ * Found while wiring the drone hull lookup: this machine was serving a
+ * v6 cache of 198 items with 9 drones while the binary shipped a v10
+ * seed of 274 with 70 -- so three merged chunks were invisible offline.
+ *
+ * IT MATTERS MORE NOW THAN IT DID. When the catalog only fed shop
+ * listings, a stale cache meant "you cannot buy the new thing yet".
+ * maxDroneBoxes now reads Body from here, so staleness reaches COMBAT
+ * MATH: a drone the cache has never heard of falls through to the
+ * price-based fallback and is a different toughness than the same drone
+ * on a fresh client.
+ *
+ * A cache NEWER than the seed still wins, which is the whole point of
+ * the server being the source of truth.
+ *
+ * THE GUARD ORIGINALLY COVERED THE WRONG HALF, and the half it missed
+ * is the one nearly every player is on. It read:
+ *
+ *     if (liveCatalog) return liveCatalog;        // <-- unweighed
+ *     ...then the version check, on the CACHE only
+ *
+ * so a FETCH SUCCEEDING was what defeated it. Measured 2026-08-31
+ * against the live endpoint: maka-cli.com served v6/198 rows while the
+ * shipped seed was v10/274. Online players got the 198 and offline
+ * players got the 274 -- being reachable was a DOWNGRADE, and the
+ * comment above about combat math was describing a live bug rather than
+ * a hypothetical: v6 carries 9 drones against v10's 70, so 61 drones
+ * missed catalogHullFor and took the price-based fallback for their
+ * condition monitor. Two clients, same drone, different toughness.
+ *
+ * The fix is to stop trusting ANY source's list because of where it
+ * came from, and weigh all three by the only thing that orders them.
+ */
+export declare function loadCatalog(readCacheFn?: CacheReader): ICatalogItem[];
+/**
+ * WHICH OF THE THREE WINS -- pure, and separated out because this is
+ * where the bug lived. A decision buried in early returns is one nobody
+ * can put a fixture in front of; a named function taking all three
+ * candidates can be asked every question directly.
+ *
+ * Highest version wins. On a TIE the fresher origin wins (live over
+ * cache over seed), because equal versions mean equal content and the
+ * live list is the one that just came from the source of truth.
+ *
+ * The seed is not a fallback here, it is a CANDIDATE -- it is the one
+ * list whose version is knowable with certainty, since it shipped in
+ * the same binary as this function.
+ */
+export declare function chooseCatalog(live?: ICatalogSource, cache?: ICatalogSource): ICatalogSource;
+/** Drop every memo -- the resolved winner and the hull index with it.
+ *  Exported for tests; production invalidates via refreshCatalog. */
+export declare function resetCatalogForTest(): void;
+/**
+ * A DRONE'S HULL, from the catalog's own stat line.
+ *
+ * The engine used to size a drone's condition monitor off its RATING --
+ * which the catalog assigns by PRICE -- so durability tracked cost.
+ * Canon sizes it off BODY (SR5 p.199; anthroforms get two more,
+ * Rigger 5.0 p.145), and Body lives only in the `stats` string. This
+ * reads it back out.
+ *
+ * STRICT MATCHING, DELIBERATELY, and this is the important difference
+ * from findCatalogItem below. That one is for a PLAYER typing a name and
+ * falls back through squashed spellings and word overlap, because
+ * "metalink" should find the Meta Link. Here a loose hit would hand a
+ * piece of generated street gear some unrelated row's Body and silently
+ * resize its hull. A mechanical lookup gets exact slug or exact name and
+ * nothing else; anything unrecognised falls through to the documented
+ * fallback in models/item.ts.
+ *
+ * INDEXED, because this is read from a getter that combat touches.
+ * loadCatalog() re-reads the cache FILE on every call until a refresh
+ * has memoised a live list, so calling it per hull check would put a
+ * synchronous read in the middle of a fight.
+ */
+export interface ICatalogHull {
+    body: number;
+    anthro: boolean;
+}
+/** Drop the memo -- called when the catalog itself is replaced. */
+export declare function resetCatalogHullIndex(): void;
+export declare function catalogHullFor(name: string): ICatalogHull | undefined;
 /** Fuzzy lookup for source.ts: exact slug, exact name, then loose
  *  word containment -- a single unambiguous hit or nothing. */
 export declare function findCatalogItem(request: string): ICatalogItem | undefined;
+export {};

package/bundle/typescript/src/commands/game/sideQuest/utilities/catalog.js

@@ -36,8 +36,33 @@ const HOSTNAME = DEV ? 'localhost' : 'www.maka-cli.com';
 const PORT = DEV ? Number(process.env.MAKA_DEV_PORT ?? 3000) : 443;
 const TIMEOUT_MS = 8000;
 const CACHE_PATH = path.join(os.homedir(), '.meteor', '.maka', 'side-quest-catalog.json');
-let liveCatalog;
+let liveSource;
+let resolved;
 let fetchAttempted = false;
+/**
+ * A VERSION NUMBER, OR NOTHING.
+ *
+ * `Number(undefined)`, `Number('')` and `Number('1.26.0')` are all NaN,
+ * and every comparison against NaN is false -- so an unversioned payload
+ * silently loses to whatever it is compared with. That is the SAFE
+ * direction (the seed wins) but a silent one, so it is named here and
+ * logged at the call site rather than left to fall out of the operator.
+ */
+export function parseCatalogVersion(raw) {
+    // AN ALLOW-LIST, because `Number()` is far too willing. Written first
+    // as `Number.isFinite(Number(raw))` and that was wrong in a way the
+    // test caught: Number(null), Number('') and Number([]) are all 0 --
+    // a real, comparable, LOWEST-possible version. The payload would then
+    // count as versioned, and refreshCatalog would overwrite a good cache
+    // with a worthless v0 list, which is precisely the poisoning this
+    // exists to stop.
+    if (typeof raw !== 'number' && typeof raw !== 'string')
+        return undefined;
+    if (typeof raw === 'string' && raw.trim() === '')
+        return undefined;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : undefined;
+}
 function readCache() {
     try {
         const parsed = JSON.parse(fs.readFileSync(CACHE_PATH, 'utf8'));
@@ -56,6 +81,25 @@ function writeCache(version, items) {
         Logger.getInstance().write(`catalog cache write failed: ${err}`);
     }
 }
+/**
+ * RECORD WHAT THE NETWORK RETURNED -- separated from the fetch so the
+ * wiring is reachable without a socket.
+ *
+ * This is not a test hatch, it is the step refreshCatalog was doing
+ * inline, and pulling it out is what makes the ACTUAL BUG SITE
+ * testable: the defect was never in how the candidates compare, it was
+ * that loadCatalog returned the live list without ever comparing it.
+ * A suite that only exercises chooseCatalog proves the comparison and
+ * says nothing about whether anyone calls it -- restoring the original
+ * one-line bug left such a suite completely green.
+ *
+ * An unusable version scores 0: present, comparable, and last.
+ */
+export function applyLiveCatalog(items, version) {
+    liveSource = { version: version ?? 0, items, origin: 'live' };
+    resolved = undefined;
+    resetCatalogHullIndex();
+}
 /** Fire-and-forget refresh from the site -- call once at session start;
  *  the promise resolves when the live list (or a fallback) is settled. */
 export async function refreshCatalog() {
@@ -77,30 +121,144 @@ export async function refreshCatalog() {
         });
         const parsed = JSON.parse(data);
         if (Array.isArray(parsed?.items) && parsed.items.length > 0) {
-            liveCatalog = parsed.items;
-            writeCache(Number(parsed.version ?? CATALOG_VERSION), liveCatalog);
-            logger.write(`Catalog: ${liveCatalog.length} items from maka-cli.com (v${parsed.version}).`);
+            const version = parseCatalogVersion(parsed.version);
+            if (version === undefined) {
+                // Loud, because it costs the server its authority for this
+                // session: an unversioned list cannot be shown to be newer, so
+                // the guard below hands the seed to the player instead.
+                logger.write(`Catalog: maka-cli.com sent ${parsed.items.length} items with NO usable version `
+                    + `(${JSON.stringify(parsed.version)}) -- it cannot be compared, so the baked-in v${CATALOG_VERSION} stands.`);
+            }
+            const fetched = parsed.items;
+            applyLiveCatalog(fetched, version);
+            if (version !== undefined)
+                writeCache(version, fetched);
+            // Say what is being SERVED, not merely what arrived. The old line
+            // reported the fetch count as though it were the answer, which is
+            // how a stale server looked like a healthy one in the log while
+            // the player was being handed the seed.
+            logger.write(`Catalog: ${fetched.length} items from maka-cli.com (v${parsed.version}); `
+                + `serving ${loadCatalog().length}.`);
             return;
         }
         throw new Error('empty catalog payload');
     }
     catch (err) {
+        // NO ASSIGNMENT HERE ANY MORE. This branch used to set the live
+        // list from the cache, which is the same unversioned trust the
+        // fetch path was guilty of. loadCatalog reads the cache itself and
+        // weighs it, so being offline is now just "no live source".
+        resolved = undefined;
+        resetCatalogHullIndex();
         const cache = readCache();
         if (cache) {
-            liveCatalog = cache.items;
-            logger.write(`Catalog: offline -- serving ${cache.items.length} cached items (v${cache.version}). (${err.message})`);
+            logger.write(`Catalog: offline -- cache holds ${cache.items.length} items (v${cache.version}); `
+                + `serving ${loadCatalog().length}. (${err.message})`);
         }
         else {
             logger.write(`Catalog: offline, no cache -- serving the ${CATALOG_ITEMS.length} baked-in items. (${err.message})`);
         }
     }
 }
-/** The best catalog available right now: live > cached > baked-in. */
-export function loadCatalog() {
-    if (liveCatalog)
-        return liveCatalog;
-    const cache = readCache();
-    return cache?.items ?? CATALOG_ITEMS;
+/**
+ * The best catalog available right now: live > cached > baked-in --
+ * except that a cache OLDER than the shipped seed is not "best", it is
+ * stale, and the seed wins.
+ *
+ * THIS USED TO BE `cache?.items ?? CATALOG_ITEMS`, which handed an
+ * upgraded client its old catalog until a refresh happened to succeed.
+ * Found while wiring the drone hull lookup: this machine was serving a
+ * v6 cache of 198 items with 9 drones while the binary shipped a v10
+ * seed of 274 with 70 -- so three merged chunks were invisible offline.
+ *
+ * IT MATTERS MORE NOW THAN IT DID. When the catalog only fed shop
+ * listings, a stale cache meant "you cannot buy the new thing yet".
+ * maxDroneBoxes now reads Body from here, so staleness reaches COMBAT
+ * MATH: a drone the cache has never heard of falls through to the
+ * price-based fallback and is a different toughness than the same drone
+ * on a fresh client.
+ *
+ * A cache NEWER than the seed still wins, which is the whole point of
+ * the server being the source of truth.
+ *
+ * THE GUARD ORIGINALLY COVERED THE WRONG HALF, and the half it missed
+ * is the one nearly every player is on. It read:
+ *
+ *     if (liveCatalog) return liveCatalog;        // <-- unweighed
+ *     ...then the version check, on the CACHE only
+ *
+ * so a FETCH SUCCEEDING was what defeated it. Measured 2026-08-31
+ * against the live endpoint: maka-cli.com served v6/198 rows while the
+ * shipped seed was v10/274. Online players got the 198 and offline
+ * players got the 274 -- being reachable was a DOWNGRADE, and the
+ * comment above about combat math was describing a live bug rather than
+ * a hypothetical: v6 carries 9 drones against v10's 70, so 61 drones
+ * missed catalogHullFor and took the price-based fallback for their
+ * condition monitor. Two clients, same drone, different toughness.
+ *
+ * The fix is to stop trusting ANY source's list because of where it
+ * came from, and weigh all three by the only thing that orders them.
+ */
+export function loadCatalog(readCacheFn = readCache) {
+    if (resolved)
+        return resolved.items;
+    const cached = readCacheFn();
+    const cacheVersion = parseCatalogVersion(cached?.version);
+    resolved = chooseCatalog(liveSource, cached && cacheVersion !== undefined
+        ? { version: cacheVersion, items: cached.items, origin: 'cache' }
+        : undefined);
+    return resolved.items;
+}
+/**
+ * WHICH OF THE THREE WINS -- pure, and separated out because this is
+ * where the bug lived. A decision buried in early returns is one nobody
+ * can put a fixture in front of; a named function taking all three
+ * candidates can be asked every question directly.
+ *
+ * Highest version wins. On a TIE the fresher origin wins (live over
+ * cache over seed), because equal versions mean equal content and the
+ * live list is the one that just came from the source of truth.
+ *
+ * The seed is not a fallback here, it is a CANDIDATE -- it is the one
+ * list whose version is knowable with certainty, since it shipped in
+ * the same binary as this function.
+ */
+export function chooseCatalog(live, cache) {
+    let best = { version: CATALOG_VERSION, items: CATALOG_ITEMS, origin: 'seed' };
+    // Ascending freshness, with >= so a later candidate takes a tie.
+    for (const candidate of [cache, live]) {
+        if (candidate && candidate.items.length > 0 && candidate.version >= best.version) {
+            best = candidate;
+        }
+    }
+    return best;
+}
+/** Drop every memo -- the resolved winner and the hull index with it.
+ *  Exported for tests; production invalidates via refreshCatalog. */
+export function resetCatalogForTest() {
+    liveSource = undefined;
+    resolved = undefined;
+    fetchAttempted = false;
+    resetCatalogHullIndex();
+}
+let hullIndex;
+/** Drop the memo -- called when the catalog itself is replaced. */
+export function resetCatalogHullIndex() {
+    hullIndex = undefined;
+}
+export function catalogHullFor(name) {
+    if (!hullIndex) {
+        hullIndex = new Map();
+        for (const item of loadCatalog()) {
+            const bod = /Bod (\d+)/.exec(item.stats ?? '');
+            if (!bod)
+                continue;
+            const hull = { body: Number(bod[1]), anthro: /anthro:/.test(item.stats ?? '') };
+            hullIndex.set(item.slug.toLowerCase(), hull);
+            hullIndex.set(item.name.toLowerCase(), hull);
+        }
+    }
+    return hullIndex.get(name.trim().toLowerCase());
 }
 /** Fuzzy lookup for source.ts: exact slug, exact name, then loose
  *  word containment -- a single unambiguous hit or nothing. */

package/bundle/typescript/src/commands/game/sideQuest/utilities/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/catalog.ts"],"names":[],"mappings":"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"}

package/bundle/typescript/src/commands/game/sideQuest/utilities/cloud-saves.d.ts

@@ -4,7 +4,15 @@ export declare function authToken(): string | undefined;
  *  the token) -- the value runner saves BIND to (account-binding
  *  ruling). Never printed; never leaves the machine. */
 export declare function accountUserId(): string | undefined;
-export type CloudResult = 'ok' | 'unauthorized' | 'offline';
+/**
+ * `stale` is the server's monotonic guard answering 409: the stored save
+ * is NEWER than the one we pushed (§8). Distinct from 'offline' because
+ * the two demand opposite responses -- an outage means retry, a stale
+ * means STOP pushing and let a human reconcile at the next launch.
+ * Folding it into 'offline' would make this client retry forever against
+ * a server that is right to refuse it.
+ */
+export type CloudResult = 'ok' | 'unauthorized' | 'offline' | 'stale';
 export interface ICloudSummary {
     slug: string;
     playerName: string;
@@ -60,3 +68,133 @@ export declare function reconcile(local: {
 } | undefined, cloud: {
     savedAt: string;
 } | undefined): ReconcileVerdict;
+/**
+ * THE COALESCING SINGLE-FLIGHT PUSH QUEUE (server-only storage, PR1).
+ *
+ * A bound runner's save lives on the server; a beat writes the SPILL
+ * synchronously (persistence.spillPathFor) and then enqueues here. Two
+ * properties, and both are about not lying to the player:
+ *
+ * SINGLE-FLIGHT: one request in the air at a time. Overlapping pushes
+ * arrive out of order, and last-writer-wins on an out-of-order pair
+ * means a later beat can be overwritten by an earlier one that happened
+ * to land second -- silently, and only visible as lost progress.
+ *
+ * COALESCING: the queue holds exactly ONE pending save, the newest.
+ * Intermediate snapshots are obsolete the moment a newer one exists, so
+ * a slow link must not build a backlog it then has to replay. Play
+ * generates beats faster than a bad connection drains them; a FIFO here
+ * would guarantee the queue never empties.
+ *
+ * The spill is what makes both safe: nothing is dropped, because
+ * whatever is not confirmed is still on disk.
+ */
+/**
+ * How a queued save reaches the server. A PARAMETER rather than a hard
+ * call to pushSave, because the queue's job is ORDERING and the
+ * transport is not part of it -- and because an ES module's exports are
+ * read-only, so a test cannot substitute pushSave any other way. The
+ * seam follows the shape this codebase already uses for narrow
+ * dependencies (IEphemeralHost, attachInputHistory's `render`).
+ */
+export type PushFn = (saveFilePath: string, save: ISaveFileV1) => Promise<CloudResult>;
+/** Test seam: the queue is module state, and a suite that ran two cases
+ *  against one dirty queue would be testing the previous test. */
+export declare function _resetPushQueue(): void;
+/**
+ * Enqueue a bound save. Returns immediately -- requestSave's contract is
+ * synchronous (game.ts) and the spill has already been written by the
+ * time this is called, so nothing here is allowed to block a beat.
+ */
+export declare function enqueueBoundPush(saveFilePath: string, save: ISaveFileV1, spillPath?: string, push?: PushFn): void;
+/**
+ * Drain to completion -- the QUIT SEAL and the job-accept handoff.
+ *
+ * These are the two places where "eventually" is not good enough: quit
+ * ends the process (nothing later will retry), and accepting a job hands
+ * this character to a shared run that loads it from the SERVER, so an
+ * unpushed beat is a stale snapshot the whole table then plays against.
+ * That race exists today and this is what closes it.
+ *
+ * Resolves true when the server has the newest save. False means the
+ * spill stands and the next launch will carry it.
+ */
+export declare function flushPushQueue(): Promise<boolean>;
+/** True while a bound save has not reached the server. */
+export declare function hasPendingPush(): boolean;
+/**
+ * Remove a spill whose contents the server has confirmed. Guarded on
+ * savedAt: a spill rewritten by a newer beat between the push and the
+ * confirmation is NOT the file we just uploaded, and deleting it would
+ * throw away the only copy of that beat.
+ */
+export declare function clearSpill(spillPath: string, confirmedSavedAt: string): void;
+/**
+ * Write the spill, SYNCHRONOUSLY, and never throw.
+ *
+ * requestSave's signature is synchronous and that is load-bearing: it is
+ * called from `process.on('exit')`, where nothing asynchronous can run
+ * at all. For a bound runner the spill write IS the durability
+ * guarantee at that moment -- the push is best-effort and the process is
+ * already leaving.
+ *
+ * SWALLOWS ITS ERRORS ON PURPOSE, and this is the one place where that
+ * is right rather than lazy: a full disk or a permissions fault during
+ * the exit hook must not turn a clean quit into a crash on the way out.
+ * The player would lose the beat either way; throwing loses the exit
+ * too, and prints a stack trace over their last screen.
+ */
+export declare function writeSpill(spillPath: string, save: ISaveFileV1): boolean;
+/**
+ * ONE SESSION PER RUNNER, ACROSS MACHINES (§8).
+ *
+ * The local `.lock` already stops two terminals on one box. It cannot
+ * see another machine, and without this a second laptop playing the same
+ * bound runner is two sessions pushing to one slot -- last-push-wins,
+ * with the loser's evening silently gone.
+ *
+ * TRANSITIONAL TOLERANCE, and it is deliberately loud in the code so it
+ * gets removed: the server half of this contract does not exist yet
+ * (rollout step 1 ships it; this is step 2). A 404 therefore means
+ * "this server does not know about leases", NOT "the lease is free" --
+ * and the honest reading of an unimplemented guard is to proceed
+ * without it, exactly as this client did before the guard existed.
+ *
+ * REMOVE THIS BRANCH once the server contract is deployed everywhere.
+ * Left in place it would mask a genuinely missing endpoint forever,
+ * which is the same shape as the compat branch that hid the review
+ * queue's blindness for a day.
+ */
+export type LeaseResult = {
+    ok: true;
+    ttlMs?: number;
+} | {
+    ok: false;
+    reason: 'held';
+    heldBy?: string;
+    since?: string;
+} | {
+    ok: false;
+    reason: 'offline' | 'unauthorized' | 'unsupported';
+};
+export declare const acquireLease: (slug: string, sessionId: string) => Promise<LeaseResult>;
+export declare const releaseLease: (slug: string, sessionId: string) => Promise<LeaseResult>;
+/**
+ * Whether a lease failure should STOP the boot.
+ *
+ * ONLY a held lease does. Offline, unauthorized and unsupported all mean
+ * "we could not ask", and refusing to play because the lock server was
+ * unreachable would turn every outage into a lockout -- which is the
+ * opposite of ruling 2 (an outage degrades to the spill, it does not end
+ * the session). A HELD lease is the one case where we know the answer
+ * and the answer is no.
+ */
+export declare function leaseRefusesBoot(result: LeaseResult): boolean;
+/**
+ * Keep the lease alive while playing. Renewal FAILURES ARE TOLERATED:
+ * a dropped renew during an outage must not kill a live session -- the
+ * server's TTL expires it on its own, and a crash is exactly what the
+ * TTL is for.
+ */
+export declare function startLeaseRenewal(slug: string, sessionId: string, everyMs?: number): void;
+export declare function stopLeaseRenewal(): void;