teamshare-bridge 0.22.8 → 0.22.10

package/dist/bridge/session-relay.js

@@ -8,6 +8,20 @@ const session_stream_1 = require("../lib/chat/session-stream");
 const BATCH_MS = 200;
 const TRANSCRIPT_LIMIT = 500;
 const SESSIONS_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare', 'sessions');
+/**
+ * How many ENDED sessions may be held while the socket is down, and for how
+ * long.
+ *
+ * `sessionEnd` deletes a session only when the socket is connected; offline it
+ * keeps it so `registerSocket` can deliver the end. There was no cap and no
+ * TTL, so a laptop lid closing for an afternoon retained every session that
+ * finished in it - up to `TRANSCRIPT_LIMIT` x `MAX_FRAME_CHARS` (~8 MB) each -
+* and if the agent was then removed from `config.json`, `registerSocket` would
+ * never run for that id again, making them unreachable AND unreclaimable. The
+ * daemon's RSS climbed until its own heartbeats started missing cadence.
+ */
+const MAX_RETAINED_ENDED = 20;
+const ENDED_TTL_MS = 10 * 60_000;
 function localPath(sessionId) {
     return (0, node_path_1.join)(SESSIONS_DIR, `${sessionId}.json`);
 }
@@ -149,13 +163,18 @@ class SessionRelay {
         }
         session.ended = true;
         session.pendingEndExit = exitCode;
+        session.endedAt = Date.now();
         this.agentCurrent.delete(session.agentId);
         const socket = this.sockets.get(session.agentId);
         if (socket?.connected) {
             this.sessions.delete(body.sessionId);
             socket.emit('session:end', { sessionId: body.sessionId, exitCode });
         }
-        // Offline: keep the ended session so registerSocket can deliver the end.
+        else {
+            // Offline: keep the ended session so registerSocket can deliver the end,
+            // but NEVER without a bound - see MAX_RETAINED_ENDED / ENDED_TTL_MS.
+            this.pruneEnded();
+        }
         this.persist(session, exitCode);
         return true;
     }
@@ -167,6 +186,26 @@ class SessionRelay {
         return this.sessions.get(sessionId)?.lines ?? [];
     }
     // ── Internals ────────────────────────────────────────────────────────
+    /**
+     * Drop ended sessions that are too old or beyond the cap, oldest first.
+     *
+     * Only ever touches sessions whose `ended` is true - a LIVE session is never
+     * pruned, however long it runs, because its transcript is what the console is
+     * currently rendering.
+     */
+    pruneEnded() {
+        const now = Date.now();
+        const ended = [...this.sessions.values()]
+            .filter((s) => s.ended)
+            .sort((a, b) => (a.endedAt ?? 0) - (b.endedAt ?? 0));
+        for (let index = 0; index < ended.length; index++) {
+            const session = ended[index];
+            const expired = now - (session.endedAt ?? now) > ENDED_TTL_MS;
+            const beyondCap = index >= MAX_RETAINED_ENDED;
+            if (expired || beyondCap)
+                this.sessions.delete(session.sessionId);
+        }
+    }
     flushSession(sessionId) {
         const session = this.sessions.get(sessionId);
         if (!session || session.ended)
@@ -196,9 +235,17 @@ class SessionRelay {
         }
     }
     persist(session, exitCode) {
+        // ASYNC, and without an indent (2026-10).
+        //
+        // This ran synchronously on the daemon's main thread inside the probe
+        // server's request handler, stringifying up to `TRANSCRIPT_LIMIT` x
+        // `MAX_FRAME_CHARS` (~8 MB) with `null, 2` - which roughly doubles the
+        // bytes again - then `writeFileSync`ing it. During that stall the
+        // 2-minute heartbeat, the 10s outbox drain and the 60s bridge-state push
+        // all missed their cadence. It is a diagnostic artifact, so a write lost
+        // to process exit is acceptable; a stalled daemon is not.
         try {
-            (0, node_fs_1.mkdirSync)(SESSIONS_DIR, { recursive: true });
-            (0, node_fs_1.writeFileSync)(localPath(session.sessionId), JSON.stringify({
+            const payload = JSON.stringify({
                 sessionId: session.sessionId,
                 agentId: session.agentId,
                 projectId: session.projectId ?? null,
@@ -209,10 +256,14 @@ class SessionRelay {
                 endedAt: session.ended ? new Date().toISOString() : null,
                 exitCode: exitCode ?? null,
                 lines: session.lines,
-            }, null, 2));
+            });
+            void node_fs_1.promises
+                .mkdir(SESSIONS_DIR, { recursive: true })
+                .then(() => node_fs_1.promises.writeFile(localPath(session.sessionId), payload))
+                .catch(() => undefined);
         }
         catch {
-            /* best-effort */
+            /* best-effort - a serialization failure must never break the relay */
         }
     }
 }

package/dist/bridge/session-relay.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-relay.js","sourceRoot":"","sources":["../../src/bridge/session-relay.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-relay.js","sourceRoot":"","sources":["../../src/bridge/session-relay.ts"],"names":[],"mappings":"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"}

package/dist/bridge/upgrade-marker.d.ts

@@ -36,9 +36,31 @@ export interface UpgradeState {
     failures: number;
     lastFailureAt?: number;
     lastError?: string;
+    /**
+     * Version the recorded failures happened ON. Read with the installed version
+     * so history against a tree we no longer run cannot count toward MAX_FAILURES.
+     */
+    from?: string;
 }
+/**
+ * Failure history, IGNORED when it was recorded against a different installed
+ * version.
+ *
+ * A failure is a property of a tree, not of the machine: if `npm i -g` left the
+ * old version half-written and the daemon came back up on 0.22.6, then a
+ * counter written while 0.21.85 was installed says nothing about whether the
+ * next attempt against 0.22.6 will work. Counting it anyway let one old EBUSY
+ * incident permanently wedge self-updating until a human ran
+ * `auto-upgrade on` by hand - the exact "it silently stopped working" symptom.
+ */
+export declare function readUpgradeStateFor(installedVersion: string, path?: string): UpgradeState | null;
 export declare function readUpgradeState(path?: string): UpgradeState | null;
-/** Called by the helper after a failed install (before it rolls back). */
-export declare function recordUpgradeFailure(error?: string, path?: string): void;
+/**
+ * Called by the helper after a failed install (before it rolls back).
+ *
+ * `fromVersion` is stamped so `readUpgradeStateFor` can tell whether the
+ * failures still describe the tree we are running.
+ */
+export declare function recordUpgradeFailure(error?: string, fromVersion?: string, path?: string): void;
 /** Called on a successful upgrade and by `auto-upgrade on`. */
 export declare function resetUpgradeState(path?: string): void;

package/dist/bridge/upgrade-marker.js

@@ -6,6 +6,7 @@ exports.readUpgradeMarker = readUpgradeMarker;
 exports.clearUpgradeMarker = clearUpgradeMarker;
 exports.upgradeInProgress = upgradeInProgress;
 exports.appendDaemonLog = appendDaemonLog;
+exports.readUpgradeStateFor = readUpgradeStateFor;
 exports.readUpgradeState = readUpgradeState;
 exports.recordUpgradeFailure = recordUpgradeFailure;
 exports.resetUpgradeState = resetUpgradeState;
@@ -106,6 +107,27 @@ function appendDaemonLog(line) {
         /* best-effort */
     }
 }
+/**
+ * Failure history, IGNORED when it was recorded against a different installed
+ * version.
+ *
+ * A failure is a property of a tree, not of the machine: if `npm i -g` left the
+ * old version half-written and the daemon came back up on 0.22.6, then a
+ * counter written while 0.21.85 was installed says nothing about whether the
+ * next attempt against 0.22.6 will work. Counting it anyway let one old EBUSY
+ * incident permanently wedge self-updating until a human ran
+ * `auto-upgrade on` by hand - the exact "it silently stopped working" symptom.
+ */
+function readUpgradeStateFor(installedVersion, path = exports.UPGRADE_STATE_PATH) {
+    const state = readUpgradeState(path);
+    if (!state)
+        return null;
+    // A legacy record with no `from` predates this field. Keep counting it
+    // rather than silently resetting someone's backoff on upgrade.
+    if (state.from !== undefined && state.from !== installedVersion)
+        return null;
+    return state;
+}
 function readUpgradeState(path = exports.UPGRADE_STATE_PATH) {
     try {
         if (!(0, node_fs_1.existsSync)(path))
@@ -126,13 +148,19 @@ function writeUpgradeState(state, path = exports.UPGRADE_STATE_PATH) {
         /* best-effort */
     }
 }
-/** Called by the helper after a failed install (before it rolls back). */
-function recordUpgradeFailure(error, path = exports.UPGRADE_STATE_PATH) {
+/**
+ * Called by the helper after a failed install (before it rolls back).
+ *
+ * `fromVersion` is stamped so `readUpgradeStateFor` can tell whether the
+ * failures still describe the tree we are running.
+ */
+function recordUpgradeFailure(error, fromVersion, path = exports.UPGRADE_STATE_PATH) {
     const prev = readUpgradeState(path);
     writeUpgradeState({
         failures: (prev?.failures ?? 0) + 1,
         lastFailureAt: Date.now(),
         ...(error ? { lastError: error.slice(0, 500) } : {}),
+        ...(fromVersion ? { from: fromVersion } : {}),
     }, path);
 }
 /** Called on a successful upgrade and by `auto-upgrade on`. */

package/dist/bridge/upgrade-marker.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade-marker.js","sourceRoot":"","sources":["../../src/bridge/upgrade-marker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"upgrade-marker.js","sourceRoot":"","sources":["../../src/bridge/upgrade-marker.ts"],"names":[],"mappings":"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"}

package/dist/bridge/upgrade-preflight.d.ts

@@ -0,0 +1,49 @@
+export interface StagingPruneResult {
+    removed: string[];
+    /** Staging dirs that could not be removed (usually: still locked). */
+    kept: string[];
+}
+/**
+ * Abandoned npm staging directories for this package, WITHOUT removing them.
+ *
+ * `doctor` reports rather than repairs: a diagnostic that silently deletes
+ * directories is a diagnostic nobody trusts. The upgrade helper is the only
+ * caller of `pruneAbandonedStaging`, and it prints what it removed.
+ */
+export declare function abandonedStagingDirs(liveInstallDir: string, root?: string): string[];
+/**
+ * Remove abandoned npm staging directories for this package.
+ *
+ * Safe by construction: it only ever touches names matching STAGING_DIR_PATTERN
+ * inside the npm global `node_modules`, which by definition excludes the live
+ * install. A directory it cannot remove (still mapped by a dead-but-not-gone
+ * process, or a concurrent npm) is reported rather than forced - `rmSync`
+ * failing is information, not an error to swallow.
+ *
+ * `root` and `liveInstallDir` are parameters so the unit tests can point this
+ * at a temp directory instead of the real npm tree.
+ */
+export declare function pruneAbandonedStaging(liveInstallDir: string, root?: string): StagingPruneResult;
+export interface NativeHolder {
+    pid: number;
+    /** The native modules this process has mapped. */
+    modules: string[];
+}
+/**
+ * Processes referencing this install tree that have native modules mapped.
+ *
+ * `selfPid` is excluded: the upgrade helper runs FROM the install tree, so it
+ * would otherwise always report itself and turn a useful warning into noise.
+ */
+export declare function listNativeModuleHolders(installDir: string, selfPid?: number): NativeHolder[];
+export interface PreflightReport {
+    staging: StagingPruneResult;
+    holders: NativeHolder[];
+    /** One-line human summary for the daemon log / upgrade helper. */
+    summary: string[];
+}
+/**
+ * Run both checks. Always returns a report - never throws, because a preflight
+ * that cannot run must not be the reason an upgrade fails.
+ */
+export declare function preflightUpgrade(installDir: string, selfPid?: number): PreflightReport;

package/dist/bridge/upgrade-preflight.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.abandonedStagingDirs = abandonedStagingDirs;
+exports.pruneAbandonedStaging = pruneAbandonedStaging;
+exports.listNativeModuleHolders = listNativeModuleHolders;
+exports.preflightUpgrade = preflightUpgrade;
+/**
+ * Upgrade preflight (2026-10).
+ *
+ * Two questions the 2026-10-04 incident proved we could not answer, because
+ * both surfaced only as an opaque `npm error EBUSY` with no path back to a
+ * cause:
+ *
+ *  1. Is npm's abandoned staging tree still lying around holding a locked
+ *     native DLL? `npm i -g` stages into `<root>/node_modules/.teamshare-bridge-XXXXXX`
+ *     and only then copies over the live install. If a previous attempt died
+ *     mid-copy, that staging dir survives with `skia.win32-x64-msvc.node` still
+ *     mapped, and every later install trips over it. One such dir was found on
+ *     this machine, left by the failed attempts and never cleaned up.
+ *
+ *  2. Which OTHER processes have this install's native modules mapped? The
+ *     bridge maps four of them (sharp/libvips, @napi-rs/canvas, better-sqlite3,
+ *     keyring) and a mapped `.node` cannot be overwritten on Windows. The
+ *     upgrade stops daemons by process enumeration, so it normally clears them
+ *     - but that safety rests on an ASSUMPTION that nothing else from the
+ *     install tree maps those DLLs. The supervisor is deliberately never
+ *     stopped (`daemon-instance.ts`), which is only safe while it loads none.
+ *     If a future change makes it load pdfkit/sharp, every upgrade would
+ *     deadlock against itself, and this module is what would say so out loud
+ *     instead of leaving a bare EBUSY.
+ *
+ * Dependency-free apart from node builtins and `daemon-instance`, and it never
+ * throws: a preflight that cannot answer must not be the thing that breaks an
+ * upgrade.
+ */
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const daemon_instance_1 = require("./daemon-instance");
+/**
+ * npm's staging directories for this package. Deliberately exact: the live
+ * install is `<root>/node_modules/teamshare-bridge`, so a leading dot plus the
+ * `-XXXXXX` suffix cannot collide with it.
+ */
+const STAGING_DIR_PATTERN = /^\.teamshare-bridge-[A-Za-z0-9_-]+$/;
+/** Native modules whose Windows handles make a directory un-rewritable. */
+const NATIVE_MODULE_PATTERN = /(skia\.win32|libvips|sharp-win32|better_sqlite3|win32-x64\.node|keyring\.win32)/i;
+/** The npm global `node_modules` directory (parent of the live install). */
+function npmGlobalModulesDir(liveInstallDir) {
+    return (0, node_path_1.join)(liveInstallDir, '..');
+}
+/**
+ * Abandoned npm staging directories for this package, WITHOUT removing them.
+ *
+ * `doctor` reports rather than repairs: a diagnostic that silently deletes
+ * directories is a diagnostic nobody trusts. The upgrade helper is the only
+ * caller of `pruneAbandonedStaging`, and it prints what it removed.
+ */
+function abandonedStagingDirs(liveInstallDir, root = npmGlobalModulesDir(liveInstallDir)) {
+    try {
+        if (!(0, node_fs_1.existsSync)(root))
+            return [];
+        const live = (0, node_path_1.join)(root, 'teamshare-bridge');
+        return (0, node_fs_1.readdirSync)(root)
+            .filter((entry) => STAGING_DIR_PATTERN.test(entry))
+            .map((entry) => (0, node_path_1.join)(root, entry))
+            .filter((dir) => dir !== live && (0, node_fs_1.existsSync)(dir));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Remove abandoned npm staging directories for this package.
+ *
+ * Safe by construction: it only ever touches names matching STAGING_DIR_PATTERN
+ * inside the npm global `node_modules`, which by definition excludes the live
+ * install. A directory it cannot remove (still mapped by a dead-but-not-gone
+ * process, or a concurrent npm) is reported rather than forced - `rmSync`
+ * failing is information, not an error to swallow.
+ *
+ * `root` and `liveInstallDir` are parameters so the unit tests can point this
+ * at a temp directory instead of the real npm tree.
+ */
+function pruneAbandonedStaging(liveInstallDir, root = npmGlobalModulesDir(liveInstallDir)) {
+    const result = { removed: [], kept: [] };
+    for (const dir of abandonedStagingDirs(liveInstallDir, root)) {
+        try {
+            (0, node_fs_1.rmSync)(dir, { recursive: true, force: true });
+            result.removed.push(dir);
+        }
+        catch {
+            result.kept.push(dir);
+        }
+    }
+    return result;
+}
+/**
+ * Processes referencing this install tree that have native modules mapped.
+ *
+ * `selfPid` is excluded: the upgrade helper runs FROM the install tree, so it
+ * would otherwise always report itself and turn a useful warning into noise.
+ */
+function listNativeModuleHolders(installDir, selfPid = process.pid) {
+    const pids = (0, daemon_instance_1.listBridgeProcessPids)().filter((pid) => pid !== selfPid);
+    if (pids.length === 0)
+        return [];
+    const byPid = new Map(pids.map((pid) => [pid, readMappedNativeModules(pid)]));
+    const out = [];
+    for (const [pid, modules] of byPid) {
+        if (modules.length > 0)
+            out.push({ pid, modules });
+    }
+    return out;
+}
+/**
+ * Native modules mapped by one pid, by basename. Returns [] rather than
+ * throwing: enumerating another process's modules needs privileges we may not
+ * have, and "cannot tell" must never read as "clean".
+ */
+function readMappedNativeModules(pid) {
+    if (process.platform !== 'win32')
+        return [];
+    const res = (0, node_child_process_1.spawnSync)('powershell.exe', [
+        '-NoProfile',
+        '-NonInteractive',
+        '-Command',
+        `(Get-Process -Id ${pid} -ErrorAction SilentlyContinue).Modules | ` +
+            `ForEach-Object { $_.FileName }`,
+    ], { stdio: 'pipe', encoding: 'utf8', timeout: 10_000, windowsHide: true });
+    const out = res.stdout ?? '';
+    if (!out)
+        return [];
+    const found = new Set();
+    for (const line of out.split(/\r?\n/)) {
+        const file = line.trim();
+        if (!file)
+            continue;
+        const base = file.split(/[\\/]/).pop() ?? file;
+        if (NATIVE_MODULE_PATTERN.test(base))
+            found.add(base);
+    }
+    return [...found].sort();
+}
+/**
+ * Run both checks. Always returns a report - never throws, because a preflight
+ * that cannot run must not be the reason an upgrade fails.
+ */
+function preflightUpgrade(installDir, selfPid) {
+    const staging = pruneAbandonedStaging(installDir);
+    const holders = listNativeModuleHolders(installDir, selfPid);
+    const summary = [];
+    if (staging.removed.length > 0) {
+        summary.push(`removed ${staging.removed.length} abandoned npm staging dir(s) holding locked native modules`);
+    }
+    if (staging.kept.length > 0) {
+        summary.push(`${staging.kept.length} staging dir(s) could not be removed - if the install fails with EBUSY these are the cause`);
+    }
+    for (const holder of holders) {
+        summary.push(`pid ${holder.pid} has native modules mapped (${holder.modules.join(', ')}) - an npm i -g now would fail with EBUSY`);
+    }
+    return { staging, holders, summary };
+}
+//# sourceMappingURL=upgrade-preflight.js.map

package/dist/bridge/upgrade-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-preflight.js","sourceRoot":"","sources":["../../src/bridge/upgrade-preflight.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/board.js

@@ -125,7 +125,16 @@ async function cmdBoard(flags) {
         }
         finally {
             clearInterval(heartbeatTimer);
-            void api.releaseSessionClaims(sessionId).catch(() => { });
+            // Awaited (2026-10): an un-awaited fetch is aborted when the process
+            // exits, so a claim this session took could outlive it and leave the
+            // task `TASK_CLAIMED_BY` until the hub's lease expired. Failure is now
+            // logged - `.catch(() => {})` hid the only case that mattered.
+            try {
+                await api.releaseSessionClaims(sessionId);
+            }
+            catch (err) {
+                console.error(`[claims] releasing this session's task claims failed: ${err instanceof Error ? err.message : String(err)} - a claim may outlive this run (the hub's claim sweeper clears it within ~30 min)`);
+            }
             await (0, brief_1.reportStatus)(api, agentId, 'online', undefined, sessionId);
         }
     }

package/dist/cli/commands/board.js.map

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

package/dist/cli/commands/browse.js

@@ -3,11 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.cmdBrowse = cmdBrowse;
 const models_1 = require("../../lib/llm/models");
 const config_1 = require("../../lib/config");
-const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
 const cdp_1 = require("../../lib/browser/cdp");
 const launch_1 = require("../../lib/browser/launch");
 const session_1 = require("../../lib/browser/session");
+const profile_guard_1 = require("../../lib/browser/profile-guard");
 const browse_cdp_1 = require("../../lib/browser/browse-cdp");
 const browse_actions_1 = require("../../lib/browser/browse-actions");
 const browse_safety_1 = require("../../lib/browser/browse-safety");
@@ -73,7 +72,9 @@ async function cmdBrowse(flags) {
     // deliberately SEPARATE from the debug browser (DEBUG_CDP_PORT/DEBUG_PROFILE_DIR)
     // so closing a task's debug browser can never kill a run the human is watching
     // and answering questions in.
-    const port = parseInt(flags.get('port') ?? String(session_1.AUTO_ANSWER_CDP_PORT), 10);
+    // `--port` is forwarded from HUB tool params (`research.ts`), so range-check
+    // it: NaN/0/a privileged port would either fail silently or mis-target Chrome.
+    const port = (0, profile_guard_1.safeCdpPort)(parseInt(flags.get('port') ?? String(session_1.AUTO_ANSWER_CDP_PORT), 10), session_1.AUTO_ANSWER_CDP_PORT);
     const continuous = flags.has('continuous');
     const maxActions = continuous ? Number.MAX_SAFE_INTEGER : parseInt(flags.get('max-actions') ?? '50', 10);
     const intervalMs = parseInt(flags.get('interval') ?? '2000', 10);
@@ -158,9 +159,12 @@ async function cmdBrowse(flags) {
                 console.log(`[browse] Reusing the debug Chrome already on port ${port}`);
             }
             else {
-                const userDataDir = profileName
-                    ? (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare', 'chrome-profiles', profileName)
-                    : session_1.DEFAULT_BROWSER_PROFILE_DIR;
+                // `--profile` arrives from HUB tool params. It used to be joined
+                // straight onto the profiles root, and `path.join` normalises `..`, so
+                // `--profile ../../AppData/.../Chrome/User Data` launched a debugging
+                // Chrome on the human's real, logged-in profile. `safeProfileDir` keeps
+                // only the final segment, inside ~/.teamshare/chrome-profiles/.
+                const userDataDir = (0, profile_guard_1.safeProfileDir)(profileName) ?? session_1.DEFAULT_BROWSER_PROFILE_DIR;
                 const instance = await (0, launch_1.launchChrome)({ port, headless, userDataDir });
                 console.log(`[browse] Launched Chrome on port ${instance.port} (${headless ? 'headless' : 'visible'}) profile=${userDataDir}`);
             }