@rynfar/meridian 1.62.6 → 1.63.0

package/dist/proxy/session/crossProcessTurnCoordinator.d.ts

@@ -0,0 +1,40 @@
+export interface CrossProcessTurnCoordinatorOptions {
+    /** Maximum time an acquire may wait. Acquires always have a finite bound. */
+    acquireTimeoutMs?: number;
+    /** A lock with no fresh heartbeat for this long may be recovered. */
+    staleAfterMs?: number;
+    /** Defaults to one third of `staleAfterMs`. Must be shorter than it. */
+    heartbeatIntervalMs?: number;
+    /** Delay between attempts while another process owns the turn. */
+    retryDelayMs?: number;
+}
+export interface CrossProcessTurnLease {
+    readonly waitedMs: number;
+    /** Stop the heartbeat and release the lock if this lease still owns it. */
+    release(): Promise<void>;
+}
+export declare class CrossProcessTurnAcquireTimeoutError extends Error {
+    constructor(timeoutMs: number);
+}
+export declare class CrossProcessTurnOwnershipError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Serializes one logical turn key across processes using atomic filesystem
+ * directory operations. Lock errors never cause an unlocked turn to proceed.
+ */
+export declare class CrossProcessTurnCoordinator {
+    private readonly root;
+    private readonly acquireTimeoutMs;
+    private readonly staleAfterMs;
+    private readonly heartbeatIntervalMs;
+    private readonly retryDelayMs;
+    constructor(root: string, options?: CrossProcessTurnCoordinatorOptions);
+    acquire(key: string, signal?: AbortSignal): Promise<CrossProcessTurnLease>;
+    private tryAcquire;
+    private createLease;
+    private recover;
+    private releaseOwned;
+    private wait;
+}
+//# sourceMappingURL=crossProcessTurnCoordinator.d.ts.map

package/dist/proxy/session/crossProcessTurnCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossProcessTurnCoordinator.d.ts","sourceRoot":"","sources":["../../../src/proxy/session/crossProcessTurnCoordinator.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,kCAAkC;IACjD,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,2EAA2E;IAC3E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAkBD,qBAAa,mCAAoC,SAAQ,KAAK;gBAChD,SAAS,EAAE,MAAM;CAI9B;AAED,qBAAa,8BAA+B,SAAQ,KAAK;gBAC3C,OAAO,SAAqD;CAIzE;AAmRD;;;GAGG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;gBAEzB,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kCAAuC;IAwBpE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;YA2ClE,UAAU;IA2CxB,OAAO,CAAC,WAAW;YA0CL,OAAO;YA2CP,YAAY;IAgC1B,OAAO,CAAC,IAAI;CAsBb"}

package/dist/proxy/session/durableFileSystem.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Persist directory metadata where the runtime exposes a directory handle.
+ *
+ * Node on Windows does not support opening directories for fsync. Windows has
+ * no equivalent API here, so preserve the fsynced-file + atomic-rename order
+ * and skip only this unsupported metadata flush. On supported platforms every
+ * open, sync, and close error remains fail-closed.
+ */
+export declare function syncDirectoryDurably(path: string): Promise<void>;
+/** Synchronous form for the session store's synchronous lock protocol. */
+export declare function syncDirectoryDurablySync(path: string): void;
+/**
+ * Classify an atomic directory publication collision without masking a real
+ * Windows permission or filesystem error. Windows reports EPERM/EACCES rather
+ * than EEXIST when the destination directory is already present, so accept
+ * those codes only after proving that the destination currently exists.
+ */
+export declare function directoryRenameWasBlocked(error: unknown, destination: string): Promise<boolean>;
+/** Synchronous form for the session store's recovery-claim protocol. */
+export declare function directoryRenameWasBlockedSync(error: unknown, destination: string): boolean;
+//# sourceMappingURL=durableFileSystem.d.ts.map

package/dist/proxy/session/durableFileSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durableFileSystem.d.ts","sourceRoot":"","sources":["../../../src/proxy/session/durableFileSystem.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtE;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ3D;AAWD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wEAAwE;AACxE,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAa1F"}

package/dist/proxy/session/lineage.d.ts

@@ -50,6 +50,17 @@ export interface SessionState {
     passthroughToolCallIds?: string[];
     /** Last observed token usage for this session (from SDK message_start / message_delta events) */
     contextUsage?: TokenUsage;
+    /** Exact SDK transcript roots for cross-process lifecycle retention. */
+    currentTranscript?: {
+        sessionId: string;
+        configDir: string;
+        projectDir?: string;
+    };
+    previousTranscript?: {
+        sessionId: string;
+        configDir: string;
+        projectDir?: string;
+    };
 }
 /**
  * Associate SDK assistant events from the current upstream run with the single
@@ -58,6 +69,15 @@ export interface SessionState {
  * assistant UUID as the undo checkpoint for the consolidated client turn.
  */
 export declare function withClientAssistantUuid(existing: Array<string | null>, clientMessageCount: number, uuid: unknown): Array<string | null>;
+/**
+ * Reconcile rollback UUIDs with the session the SDK actually returned.
+ *
+ * A fork remaps every copied transcript UUID, so UUIDs inherited from the
+ * resumed session are invalid in the returned session. The one UUID observed
+ * for this request's new client-visible assistant remains valid and occupies
+ * its future client message slot.
+ */
+export declare function reconcileReturnedSessionUuids(existing: Array<string | null>, clientMessageCount: number, currentAssistantUuid: string | null, resumeSessionId: string | undefined, returnedSessionId: string | undefined): Array<string | null>;
 /**
  * Result of lineage verification — classifies the mutation and provides
  * the information needed to take the correct SDK action.

package/dist/proxy/session/lineage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lineage.d.ts","sourceRoot":"","sources":["../../../src/proxy/session/lineage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lineage.d.ts","sourceRoot":"","sources":["../../../src/proxy/session/lineage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,4EAA4E;AAC5E,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,2BAA2B,CAAC,EAAE,MAAM,CAAA;IACpC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,UAAW,SAAQ,mBAAmB;IACrD,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAA;CACnC;AAED;;6DAE6D;AAC7D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAG5E;AAED;0EAC0E;AAC1E,eAAO,MAAM,yBAAyB,IAAI,CAAA;AAE1C,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB;;qDAEiD;IACjD,WAAW,EAAE,MAAM,CAAA;IACnB;;kCAE8B;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB;;iDAE6C;IAC7C,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAAE,CAAA;IAC/B;;oDAEgD;IAChD,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACtC;6FACyF;IACzF,gCAAgC,CAAC,EAAE,MAAM,CAAA;IACzC,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;IACjC,iGAAiG;IACjG,YAAY,CAAC,EAAE,UAAU,CAAA;IACzB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACjF,kBAAkB,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACnF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,EAC9B,kBAAkB,EAAE,MAAM,EAC1B,IAAI,EAAE,OAAO,GACZ,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAOtB;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,EAC9B,kBAAkB,EAAE,MAAM,EAC1B,oBAAoB,EAAE,MAAM,GAAG,IAAI,EACnC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACpC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAKtB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAG,OAAO,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC1F;IAAE,IAAI,EAAE,MAAM,CAAC;IAAS,OAAO,EAAE,YAAY,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACxG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAK,MAAM,EAAE,uBAAuB,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAC9E;wEACoE;IACpE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,CAAA;AAElC,MAAM,MAAM,uBAAuB,GAC/B,cAAc,GACd,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,WAAW,GACX,qBAAqB,GACrB,wBAAwB,CAAA;AAI5B;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,GAAG,MAAM,CAI1F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,GAAG,MAAM,CAK3E;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;+EAC2E;IAC3E,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACtB;AAaD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC;AAC/C;;gFAEgF;AAChF,yBAAyB,CAAC,EAAE,MAAM,EAAE,GACnC,eAAe,CAwBjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAcnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,GAAG,MAAM,EAAE,CAG9F;AAcD,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,GAAG,MAAM,EAAE,EAAE,CAKrG;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,CAQ7F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,CA6B7F;AAyBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,GAC9C,aAAa,CAkKf"}

package/dist/proxy/session/processIncarnation.d.ts

@@ -0,0 +1,46 @@
+export declare const PROCESS_INCARNATION_VERSION = 1;
+export type ProcessStartIdKind = "linux-proc-start-ticks" | "darwin-ps-lstart" | "windows-start-ticks";
+/**
+ * OS-backed identity for one process incarnation.
+ *
+ * `hostId` identifies the machine (and Linux PID namespace), `bootId`
+ * identifies one boot of that machine, and `startId` distinguishes PID reuse
+ * within the boot. Raw machine IDs are hashed before they are persisted.
+ */
+export interface ProcessIncarnation {
+    version: typeof PROCESS_INCARNATION_VERSION;
+    pid: number;
+    hostId: string;
+    bootId: string;
+    startId: string;
+    startIdKind: ProcessStartIdKind;
+}
+export type ProcessIncarnationProbe = "alive" | "dead" | "indeterminate";
+export interface LocalBootIdentity {
+    hostId: string;
+    bootId: string;
+}
+export type ProcessStartObservation = {
+    status: "found";
+    startId: string;
+    startIdKind: ProcessStartIdKind;
+} | {
+    status: "missing";
+} | {
+    status: "indeterminate";
+};
+export declare function parseProcessIncarnation(value: unknown): ProcessIncarnation | undefined;
+export declare function parseProcessIncarnationJson(raw: string): ProcessIncarnation | undefined;
+/**
+ * Pure recovery decision. Only `dead` is permission to retire an owner's lock.
+ * Unknown hosts and every unavailable or malformed observation fail closed.
+ */
+export declare function evaluateProcessIncarnation(owner: ProcessIncarnation, localBoot: LocalBootIdentity | undefined, observedStart: ProcessStartObservation | undefined): ProcessIncarnationProbe;
+/** Parse field 22 (`starttime`) without assuming that comm contains no `)`. */
+export declare function parseLinuxProcStatStartId(raw: string, expectedPid: number): string | undefined;
+/** Capture metadata for a lock created by `pid` (normally the current process). */
+export declare function captureProcessIncarnation(pid?: number): ProcessIncarnation | undefined;
+/** Probe one stored owner. Recovery callers must act only on `dead`. */
+export declare function probeProcessIncarnation(owner: ProcessIncarnation): ProcessIncarnationProbe;
+export declare function processIncarnationIsDead(owner: ProcessIncarnation): boolean;
+//# sourceMappingURL=processIncarnation.d.ts.map

package/dist/proxy/session/processIncarnation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processIncarnation.d.ts","sourceRoot":"","sources":["../../../src/proxy/session/processIncarnation.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAE5C,MAAM,MAAM,kBAAkB,GAC1B,wBAAwB,GACxB,kBAAkB,GAClB,qBAAqB,CAAA;AAEzB;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,2BAA2B,CAAA;IAC3C,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,kBAAkB,CAAA;CAChC;AAED,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,MAAM,GAAG,eAAe,CAAA;AAExE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,kBAAkB,CAAA;CAAE,GACrE;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,eAAe,CAAA;CAAE,CAAA;AAkC/B,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAqBtF;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAMvF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,aAAa,EAAE,uBAAuB,GAAG,SAAS,GACjD,uBAAuB,CAsBzB;AA6HD,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ9F;AAsDD,mFAAmF;AACnF,wBAAgB,yBAAyB,CAAC,GAAG,SAAc,GAAG,kBAAkB,GAAG,SAAS,CAkB3F;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,uBAAuB,CAS1F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAE3E"}

package/dist/proxy/session/recoveryClaim.d.ts

@@ -0,0 +1,19 @@
+import { type ProcessIncarnation } from "./processIncarnation";
+export declare const RECOVERY_CLAIM_VERSION = 2;
+export interface RecoveryClaimOwner {
+    version: typeof RECOVERY_CLAIM_VERSION;
+    generation: string;
+    token: string;
+    pid: number;
+    hostname: string;
+    createdAt: number;
+    incarnation: ProcessIncarnation;
+}
+export declare function createRecoveryClaimOwner(generation: string): RecoveryClaimOwner;
+export declare function parseRecoveryClaimOwner(value: unknown): RecoveryClaimOwner | undefined;
+export declare function parseRecoveryClaimOwnerJson(raw: string): RecoveryClaimOwner | undefined;
+/** Only an authoritative OS incarnation mismatch proves that an owner is dead. */
+export declare function recoveryClaimOwnerIsDead(owner: RecoveryClaimOwner, probe?: (incarnation: ProcessIncarnation) => boolean): boolean;
+export declare function getRecoveryClaimPath(lockPath: string, generation: string): string;
+export declare function getRecoveryClaimTombstonePath(claimPath: string, claimToken: string): string;
+//# sourceMappingURL=recoveryClaim.d.ts.map

package/dist/proxy/session/recoveryClaim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recoveryClaim.d.ts","sourceRoot":"","sources":["../../../src/proxy/session/recoveryClaim.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAA;AAE7B,eAAO,MAAM,sBAAsB,IAAI,CAAA;AAEvC,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,sBAAsB,CAAA;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,kBAAkB,CAAA;CAChC;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAa/E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CA4BtF;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAMvF;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,kBAAkB,EACzB,KAAK,GAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,OAAkC,GAC7E,OAAO,CAET;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGjF;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAG3F"}

package/dist/proxy/session/sdkProcessGate.d.ts

@@ -0,0 +1,19 @@
+import type { SpawnedProcess, SpawnOptions } from "@anthropic-ai/claude-agent-sdk";
+import { type ProcessIncarnation } from "./processIncarnation";
+export interface SdkProcessGate {
+    readonly executor: ProcessIncarnation;
+    /** False means a crashed proxy's lease must remain fail-closed forever. */
+    readonly recoverableAfterCrash: boolean;
+    readonly spawnClaudeCodeProcess: (options: SpawnOptions) => SpawnedProcess;
+    /** True only after the exact wrapper/CLI process has exited safely. */
+    closeAndJoin(timeoutMs?: number): Promise<boolean>;
+}
+/**
+ * Start a harmless gated wrapper and capture its exact incarnation before the
+ * SDK can execute Claude Code. POSIX wrappers `exec` the CLI in the same PID.
+ * Windows keeps a PowerShell parent for the complete CLI lifetime; crash
+ * recovery of that lease is deliberately disabled because Windows has no
+ * built-in, authoritative descendant-group incarnation.
+ */
+export declare function createSdkProcessGate(root: string, attachExecutor: (executor: ProcessIncarnation, recoverableAfterCrash: boolean) => Promise<void>, onStderr?: (data: string) => void): Promise<SdkProcessGate>;
+//# sourceMappingURL=sdkProcessGate.d.ts.map

package/dist/proxy/session/sdkProcessGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkProcessGate.d.ts","sourceRoot":"","sources":["../../../src/proxy/session/sdkProcessGate.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACb,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAA;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAA;IACvC,QAAQ,CAAC,sBAAsB,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,cAAc,CAAA;IAC1E,uEAAuE;IACvE,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACnD;AAuJD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/F,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,cAAc,CAAC,CAmGzB"}

package/dist/proxy/sessionLifecycle.d.ts

@@ -0,0 +1,105 @@
+import { type ProcessIncarnation } from "./session/processIncarnation";
+export interface TranscriptLocator {
+    sessionId: string;
+    /** The absolute CLAUDE_CONFIG_DIR which owns this transcript. */
+    configDir: string;
+    /** SDK project directory, passed as deleteSession(..., { dir }). */
+    projectDir?: string;
+    /** Opaque physical-ownership fence. Omitted only on legacy store locators. */
+    lifecycleGeneration?: string;
+}
+export type TranscriptResourceState = "prepared" | "live" | "retired" | "deleting" | "deleted";
+export type SessionDeleter = (locator: TranscriptLocator) => Promise<void>;
+export interface SessionLifecycleOptions {
+    /** Test seam. Production callers should use getSessionStoreDir(). */
+    storeDir?: string;
+    deleter?: SessionDeleter;
+    now?: () => number;
+    /** Maximum non-live ownership backlog (prepared/retired/deleting). */
+    maxPending?: number;
+    /** Hard ceiling across every non-deleted owned transcript. */
+    maxOwned?: number;
+    maxTombstones?: number;
+    maxDeletesPerRun?: number;
+    lockWaitMs?: number;
+    lockRetryMs?: number;
+    lockStaleMs?: number;
+    preparedGraceMs?: number;
+    deletingLeaseMs?: number;
+    /** Quarantine after retirement so old readers and rolling upgrades can drain. */
+    retiredGraceMs?: number;
+    retryBaseMs?: number;
+    retryMaxMs?: number;
+    deletionTimeoutMs?: number;
+    /** Refresh durable mapping pins before each destructive claim. */
+    pinProvider?: () => readonly TranscriptLocator[];
+    /** Bound one complete sweep, including all child deletions. */
+    runTimeoutMs?: number;
+}
+export interface ActiveTranscriptLease {
+    token: string;
+    resourceKeys: string[];
+}
+export interface ReconcileResult {
+    preparedRetired: number;
+    liveRetired: number;
+    resourcesPinned: number;
+    deletingRecovered: number;
+}
+export interface GcResult {
+    deleted: number;
+    notFound: number;
+    failed: number;
+    deferred: number;
+}
+export declare class SessionLifecycleError extends Error {
+}
+export declare class SessionLifecycleLockError extends SessionLifecycleError {
+}
+export declare class SessionLifecycleCorruptError extends SessionLifecycleError {
+}
+export declare class SessionLifecycleBacklogError extends SessionLifecycleError {
+}
+/** Stable ownership key. The separator prevents ambiguous concatenation. */
+export declare function getTranscriptResourceKey(locator: TranscriptLocator): string;
+/** Persist a cross-process writer lease before an SDK child can touch transcripts. */
+export declare function acquireActiveTranscriptLease(locators: readonly TranscriptLocator[], options?: SessionLifecycleOptions): Promise<ActiveTranscriptLease>;
+/** Arm a writer lease with the exact gated shell/CLI process incarnation. */
+export declare function attachActiveTranscriptExecutor(lease: ActiveTranscriptLease, executor: ProcessIncarnation, options?: SessionLifecycleOptions, executorRecoverable?: boolean): Promise<void>;
+/** Release only this exact writer lease after its child has been joined. */
+export declare function releaseActiveTranscriptLease(lease: ActiveTranscriptLease, options?: SessionLifecycleOptions): Promise<void>;
+/** Persist ownership before the SDK process which can create the transcript starts. */
+export declare function prepareFork(locator: TranscriptLocator, options?: SessionLifecycleOptions): Promise<TranscriptLocator>;
+/** Ensure a legacy/direct-resume locator is journaled without promoting a prepared target. */
+export declare function ensureTranscriptJournaled(locator: TranscriptLocator, options?: SessionLifecycleOptions): Promise<TranscriptLocator>;
+/** Register an existing SDK transcript as Meridian-owned without a fork intent. */
+export declare function registerLiveTranscript(locator: TranscriptLocator, options?: SessionLifecycleOptions): Promise<TranscriptLocator>;
+/** Mark a successfully spawned, Meridian-owned fork as live. */
+export declare function commitFork(locator: TranscriptLocator, options?: SessionLifecycleOptions): Promise<void>;
+/**
+ * Fence durable mapping publication against GC's final claim transaction.
+ * The callback must be synchronous and must perform the session-store CAS.
+ * A normal publisher must refer to an already journaled resource. This makes
+ * tombstone pruning safe: a delayed old publisher cannot recreate a locator
+ * that GC already deleted.
+ */
+export declare function publishPinnedTranscript<T extends boolean | string>(locator: TranscriptLocator, publish: () => T, options?: SessionLifecycleOptions): Promise<T>;
+/**
+ * Atomically attach a legacy mapping whose source predates lifecycle metadata.
+ * Missing-resource creation is allowed only inside the same lifecycle critical
+ * section as the exact session-store CAS, so there is no stale publish gap.
+ */
+export declare function attachPinnedTranscript<T extends boolean | string>(locator: TranscriptLocator, publish: () => T, options?: SessionLifecycleOptions): Promise<T>;
+/** Retire an intent when spawn fails. It remains tracked until SDK deletion succeeds. */
+export declare function abandonFork(locator: TranscriptLocator, options?: SessionLifecycleOptions): Promise<void>;
+/**
+ * Reconcile durable ownership with caller-provided current and previous pins.
+ * Pins are the retention authority. Callers should pass both generations.
+ */
+export declare function reconcile(pins: readonly TranscriptLocator[], options?: SessionLifecycleOptions): Promise<ReconcileResult>;
+/** Delete a bounded batch of unpinned retired transcripts through the supported SDK API. */
+export declare function runGc(pins: readonly TranscriptLocator[], options?: SessionLifecycleOptions): Promise<GcResult>;
+export declare function canonicalizeTranscriptLocator(locator: TranscriptLocator): TranscriptLocator;
+/** Resolve a real Node runtime even when Meridian itself is bundled under Bun. */
+export declare function getSessionGcNodeExecutable(): string;
+//# sourceMappingURL=sessionLifecycle.d.ts.map

package/dist/proxy/sessionLifecycle.d.ts.map

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

package/dist/proxy/sessionStore.d.ts

@@ -10,8 +10,19 @@
  * Keys are either OpenCode session IDs or conversation fingerprints.
  */
 import type { TokenUsage } from "./session/lineage";
+export interface TranscriptLocator {
+    sessionId: string;
+    configDir: string;
+    projectDir?: string;
+    /** Opaque lifecycle ownership fence; absent only on legacy mappings. */
+    lifecycleGeneration?: string;
+}
 export interface StoredSession {
     claudeSessionId: string;
+    /** Monotonic per-entry revision retained for diagnostics and upgrades. */
+    revision?: number;
+    /** Unique publication token. Replaced on every durable mapping mutation. */
+    generationId?: string;
     createdAt: number;
     lastUsedAt: number;
     messageCount: number;
@@ -34,19 +45,54 @@ export interface StoredSession {
      *  Enables recovery when a lineage bug (e.g. false compaction) causes the
      *  original session to be abandoned and a new one started. */
     previousClaudeSessionId?: string;
+    /** Exact transcript location for the current Claude session. */
+    currentTranscript?: TranscriptLocator;
+    /** Transcript location retained when the session mapping is replaced. */
+    previousTranscript?: TranscriptLocator;
 }
+export type StoredSessionGeneration = string;
+/** Exact, key-bound durable generation used for compare-and-swap fencing. */
+export declare function getStoredSessionGeneration(session: StoredSession, key: string): StoredSessionGeneration;
+export declare function getMaxStoredSessionsLimit(): number;
 /** Set an explicit session store directory. Takes priority over env var.
- *  Pass null to clear. For testing only.
- *  @param opts.skipLocking — skip file locking (default true for test isolation) */
-export declare function setSessionStoreDir(dir: string | null, opts?: {
+ *  Pass null to clear. For testing only. The legacy options parameter remains
+ *  accepted for compatibility, but transactions are always locked. */
+export declare function setSessionStoreDir(dir: string | null, _opts?: {
     skipLocking?: boolean;
 }): void;
+/** Return the directory containing the cross-process session store. */
+export declare function getSessionStoreDir(): string;
+/** Read a strict, coherent snapshot for maintenance tasks such as session GC.
+ *  Unlike lookup helpers, malformed JSON and I/O errors are propagated. */
+export declare function readSessionStoreSnapshot(): Record<string, StoredSession>;
+/** Capture exact durable generations for one adapter session across profile keys. */
+export declare function readSessionStoreGenerationSnapshot(adapterSessionId: string, profileIds?: readonly string[]): Record<string, StoredSessionGeneration>;
+export type SharedSessionLookupResult = {
+    status: "found";
+    session: StoredSession;
+    generation?: StoredSessionGeneration;
+} | {
+    status: "missing";
+    existing?: StoredSession;
+    generation?: StoredSessionGeneration;
+} | {
+    status: "error";
+    error: Error;
+};
+/** Distinguish an authoritative absence from a transient/corrupt read. */
+export declare function lookupSharedSessionResult(key: string): SharedSessionLookupResult;
 export declare function lookupSharedSession(key: string): StoredSession | undefined;
+export declare function lookupSharedSessionByClaudeIdResult(claudeSessionId: string): SharedSessionLookupResult;
 export declare function lookupSharedSessionByClaudeId(claudeSessionId: string): StoredSession | undefined;
-export declare function storeSharedSession(key: string, claudeSessionId: string, messageCount?: number, lineageHash?: string, messageHashes?: string[], sdkMessageUuids?: Array<string | null>, contextUsage?: TokenUsage, messageBlockHashes?: string[][], passthroughToolCallAssistantUuid?: string | null, passthroughToolCallIds?: string[] | null): void;
-/** Remove a single session from the shared file store.
- *  Used when a session is detected as stale (e.g. expired upstream). */
-export declare function evictSharedSession(key: string): void;
+export declare function storeSharedSession(key: string, claudeSessionId: string, messageCount?: number, lineageHash?: string, messageHashes?: string[], sdkMessageUuids?: Array<string | null>, contextUsage?: TokenUsage, messageBlockHashes?: string[][], passthroughToolCallAssistantUuid?: string | null, passthroughToolCallIds?: string[] | null, currentTranscript?: TranscriptLocator, sourceTranscript?: TranscriptLocator, expectedGeneration?: StoredSessionGeneration | null): StoredSessionGeneration | false;
+/** Attach an exact transcript locator without changing lineage or SDK identity.
+ * The durable revision advances so concurrent readers cannot miss the mutation. */
+export declare function attachSharedTranscriptLocator(key: string, expectedClaudeSessionId: string, locator: TranscriptLocator, expectedGeneration?: StoredSessionGeneration): StoredSessionGeneration | false;
+/** Ensure a single session is absent from the shared file store.
+ *  Used when a session is detected as stale (e.g. expired upstream).
+ *  Absence is an idempotent success; false is reserved for a present mapping
+ *  whose exact expected generation no longer matches. */
+export declare function evictSharedSession(key: string, expectedGeneration?: StoredSessionGeneration): boolean;
 /** Look up recovery information for a session key.
  *  Returns the current and previous Claude session IDs, plus derived
  *  file paths and CLI commands for conversation recovery. */

package/dist/proxy/sessionStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../src/proxy/sessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAAE,CAAA;IAC/B,iFAAiF;IACjF,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACtC;oFACgF;IAChF,gCAAgC,CAAC,EAAE,MAAM,CAAA;IACzC,qEAAqE;IACrE,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;IACjC,wDAAwD;IACxD,YAAY,CAAC,EAAE,UAAU,CAAA;IACzB;;kEAE8D;IAC9D,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AA0DD;;oFAEoF;AACpF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAG7F;AA2ED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAO1E;AAED,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAYhG;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,EACtC,YAAY,CAAC,EAAE,UAAU,EACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAAE,EAC/B,gCAAgC,CAAC,EAAE,MAAM,GAAG,IAAI,EAChD,sBAAsB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GACvC,IAAI,CAqDN;AAED;wEACwE;AACxE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAkBpD;AAED;;6DAE6D;AAC7D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG;IAClD,eAAe,EAAE,MAAM,CAAA;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACrB,GAAG,SAAS,CAWZ;AAED;uEACuE;AACvE,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,eAAe,EAAE,MAAM,CAAA;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAC,CAUD;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../src/proxy/sessionStore.ts"],"names":[],"mappings":"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"}

package/dist/proxy/types.d.ts

@@ -57,8 +57,12 @@ export interface ProxyServer {
      * to drain in-flight requests before the HTTP server actually shuts down.
      */
     beginDrain?(): void;
+    /** Revoke durable writes and abort work that outlived the shutdown grace. */
+    forceAbortInFlight?(): void;
     /** Count of requests admitted past the draining gate that haven't finished yet. */
     getInFlightCount?(): number;
+    /** Run one fail-closed transcript maintenance sweep. */
+    sweepSessionGc?(): Promise<void>;
 }
 export declare const DEFAULT_PROXY_CONFIG: ProxyConfig;
 //# sourceMappingURL=types.d.ts.map

package/dist/proxy/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/proxy/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,kBAAkB,EAAE,MAAM,CAAA;IAC1B,MAAM,EAAE,OAAO,CAAA;IACf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAA;IAC1B,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,MAAM,EAAE,WAAW,CAAA;IACnB,mEAAmE;IACnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,GAAG,EAAE;QAAE,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAA;IAClF,uCAAuC;IACvC,MAAM,EAAE,WAAW,CAAA;IACnB,qEAAqE;IACrE,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B;;;;OAIG;IACH,UAAU,CAAC,IAAI,IAAI,CAAA;IACnB,mFAAmF;IACnF,gBAAgB,CAAC,IAAI,MAAM,CAAA;CAC5B;AAED,eAAO,MAAM,oBAAoB,EAAE,WAWlC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/proxy/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,kBAAkB,EAAE,MAAM,CAAA;IAC1B,MAAM,EAAE,OAAO,CAAA;IACf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAA;IAC1B,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,MAAM,EAAE,WAAW,CAAA;IACnB,mEAAmE;IACnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,GAAG,EAAE;QAAE,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAA;IAClF,uCAAuC;IACvC,MAAM,EAAE,WAAW,CAAA;IACnB,qEAAqE;IACrE,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B;;;;OAIG;IACH,UAAU,CAAC,IAAI,IAAI,CAAA;IACnB,6EAA6E;IAC7E,kBAAkB,CAAC,IAAI,IAAI,CAAA;IAC3B,mFAAmF;IACnF,gBAAgB,CAAC,IAAI,MAAM,CAAA;IAC3B,wDAAwD;IACxD,cAAc,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACjC;AAED,eAAO,MAAM,oBAAoB,EAAE,WAWlC,CAAA"}

package/dist/proxy/updateCheck.d.ts

@@ -0,0 +1,31 @@
+export interface UpdateCheckOptions {
+    /** Cache location. Overridable so tests never touch the real cache. */
+    cachePath?: string;
+    ttlMs?: number;
+    now?: () => number;
+    /** Injected in tests; the default hits the npm registry. */
+    fetchLatest?: () => Promise<string | undefined>;
+    /** Called when a check resolves a version we did not already have. */
+    onResolved?: (latest: string) => void;
+}
+/**
+ * Resolve the newest published version, preferring a fresh disk cache.
+ *
+ * Returns a stale cached value when the registry is unreachable — see the
+ * module header for why that beats returning nothing.
+ */
+export declare function checkForUpdate(options?: UpdateCheckOptions): Promise<string | undefined>;
+/** The last resolved published version, or undefined if not yet known. */
+export declare function getLatestVersion(): string | undefined;
+/**
+ * Begin checking for updates in the background.
+ *
+ * Callers do not await this — startup never waits on the registry. The
+ * returned promise settles after the first check purely so tests can act on a
+ * resolved value instead of polling. The interval is unref'd so it cannot keep
+ * a short-lived embedder's process alive.
+ */
+export declare function startUpdateCheck(options?: UpdateCheckOptions): Promise<void>;
+/** Stop the background refresh (shutdown, and between tests). */
+export declare function stopUpdateCheck(): void;
+//# sourceMappingURL=updateCheck.d.ts.map

package/dist/proxy/updateCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateCheck.d.ts","sourceRoot":"","sources":["../../src/proxy/updateCheck.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC/C,sEAAsE;IACtE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACtC;AAyCD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqBlG;AAOD,0EAA0E;AAC1E,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAehF;AAED,iEAAiE;AACjE,wBAAgB,eAAe,IAAI,IAAI,CAItC"}

package/dist/server.js

@@ -11,11 +11,11 @@ import {
   runObserveHook,
   runTransformHook,
   startProxyServer
-} from "./cli-wxk8xvd3.js";
+} from "./cli-hdyptm7z.js";
 import"./cli-m0p2bc8v.js";
 import"./cli-sry5aqdj.js";
-import"./cli-xmweegb1.js";
-import"./cli-d45dq9gf.js";
+import"./cli-8yp89fan.js";
+import"./cli-xfbhn15a.js";
 import"./cli-vj9cv18n.js";
 import"./cli-pc0mtjjv.js";
 import"./cli-khhjyk04.js";

package/dist/telemetry/profileBar.d.ts

@@ -27,7 +27,7 @@ export declare const themeCss = "\n  :root {\n    /* Cool-gray neutral palette.
  * pole. Scales cleanly from favicon to hero size.
  */
 export declare const meridianLogoSvg = "<svg class=\"mh-logo\" width=\"24\" height=\"24\" viewBox=\"0 0 64 64\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\" aria-hidden=\"true\">\n  <defs>\n    <linearGradient id=\"mhGrad\" x1=\"32\" y1=\"4\" x2=\"32\" y2=\"60\" gradientUnits=\"userSpaceOnUse\">\n      <stop stop-color=\"#58a6ff\"/>\n      <stop offset=\"1\" stop-color=\"#bc8cff\"/>\n    </linearGradient>\n  </defs>\n  <circle cx=\"32\" cy=\"32\" r=\"25\" stroke=\"url(#mhGrad)\" stroke-width=\"3.5\"/>\n  <ellipse cx=\"32\" cy=\"32\" rx=\"10.5\" ry=\"25\" stroke=\"url(#mhGrad)\" stroke-width=\"2.5\" opacity=\"0.8\"/>\n  <path d=\"M7 32h50\" stroke=\"url(#mhGrad)\" stroke-width=\"2\" opacity=\"0.4\"/>\n  <circle cx=\"32\" cy=\"7\" r=\"4.5\" fill=\"#58a6ff\"/>\n  <circle cx=\"32\" cy=\"57\" r=\"4.5\" fill=\"#bc8cff\"/>\n</svg>";
-export declare const profileBarCss = "\n  .meridian-header {\n    position: sticky; top: 0; z-index: 100;\n    display: flex; align-items: center; gap: 20px;\n    padding: 10px 24px;\n    background: rgba(13, 17, 23, 0.92);\n    backdrop-filter: blur(12px);\n    border-bottom: 1px solid var(--border, #30363d);\n  }\n  .meridian-header .mh-brand {\n    display: flex; align-items: center; gap: 10px;\n    text-decoration: none; color: var(--text, #e6edf3);\n  }\n  .meridian-header .mh-logo { display: block; }\n  .meridian-header .mh-name {\n    font-size: 15px; font-weight: 700; letter-spacing: 2px;\n    text-transform: uppercase;\n  }\n  .meridian-header .mh-nav { display: flex; align-items: center; gap: 2px; }\n  .meridian-header .mh-nav a {\n    color: var(--muted, #8b949e); text-decoration: none; font-size: 12px;\n    font-weight: 500; padding: 5px 10px; border-radius: 6px;\n    transition: color 0.15s, background 0.15s;\n  }\n  .meridian-header .mh-nav a:hover { color: var(--text, #e6edf3); background: var(--surface, #161b22); }\n  .meridian-header .mh-nav a.active { color: var(--accent, #58a6ff); background: var(--surface, #161b22); }\n  .meridian-header .mh-right {\n    margin-left: auto; display: flex; align-items: center; gap: 10px;\n  }\n  .meridian-header .mh-profile {\n    display: none; align-items: center; gap: 6px;\n    font-size: 11px; font-weight: 500; color: var(--text, #e6edf3);\n    padding: 3px 10px; border-radius: 20px;\n    background: var(--surface, #161b22); border: 1px solid var(--border, #30363d);\n    text-decoration: none; transition: border-color 0.15s;\n  }\n  .meridian-header .mh-profile:hover { border-color: var(--accent, #58a6ff); }\n  .meridian-header .mh-profile.visible { display: inline-flex; }\n  .meridian-header .mh-profile .mh-profile-type {\n    color: var(--muted, #8b949e); font-size: 10px;\n  }\n  .meridian-header .mh-status {\n    display: inline-flex; align-items: center; gap: 6px;\n    font-size: 11px; color: var(--muted, #8b949e); white-space: nowrap;\n  }\n  .meridian-header .mh-dot {\n    width: 8px; height: 8px; border-radius: 50%;\n    background: var(--muted, #8b949e); flex-shrink: 0;\n  }\n  .meridian-header .mh-dot.healthy { background: var(--green, #3fb950); box-shadow: 0 0 6px rgba(63,185,80,0.5); }\n  .meridian-header .mh-dot.degraded { background: var(--yellow, #d29922); }\n  .meridian-header .mh-dot.unhealthy { background: var(--red, #f85149); }\n  @media (max-width: 720px) {\n    .meridian-header { gap: 10px; padding: 10px 16px; flex-wrap: wrap; }\n    .meridian-header .mh-name { display: none; }\n    .meridian-header .mh-status .mh-status-text { display: none; }\n  }\n";
-export declare const profileBarHtml = "\n<header class=\"meridian-header\" id=\"meridianHeader\">\n  <a class=\"mh-brand\" href=\"/\">\n    <svg class=\"mh-logo\" width=\"24\" height=\"24\" viewBox=\"0 0 64 64\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\" aria-hidden=\"true\">\n  <defs>\n    <linearGradient id=\"mhGrad\" x1=\"32\" y1=\"4\" x2=\"32\" y2=\"60\" gradientUnits=\"userSpaceOnUse\">\n      <stop stop-color=\"#58a6ff\"/>\n      <stop offset=\"1\" stop-color=\"#bc8cff\"/>\n    </linearGradient>\n  </defs>\n  <circle cx=\"32\" cy=\"32\" r=\"25\" stroke=\"url(#mhGrad)\" stroke-width=\"3.5\"/>\n  <ellipse cx=\"32\" cy=\"32\" rx=\"10.5\" ry=\"25\" stroke=\"url(#mhGrad)\" stroke-width=\"2.5\" opacity=\"0.8\"/>\n  <path d=\"M7 32h50\" stroke=\"url(#mhGrad)\" stroke-width=\"2\" opacity=\"0.4\"/>\n  <circle cx=\"32\" cy=\"7\" r=\"4.5\" fill=\"#58a6ff\"/>\n  <circle cx=\"32\" cy=\"57\" r=\"4.5\" fill=\"#bc8cff\"/>\n</svg>\n    <span class=\"mh-name\">Meridian</span>\n  </a>\n  <nav class=\"mh-nav\">\n    <a href=\"/\" id=\"nav-home\">Home</a>\n    <a href=\"/telemetry\" id=\"nav-telemetry\">Telemetry</a>\n    <a href=\"/profiles\" id=\"nav-profiles\">Profiles</a>\n    <a href=\"/settings\" id=\"nav-settings\">Settings</a>\n    <a href=\"/plugins\" id=\"nav-plugins\">Plugins</a>\n  </nav>\n  <div class=\"mh-right\">\n    <a class=\"mh-profile\" id=\"mhProfile\" href=\"/\" title=\"Active profile \u2014 switch from the home page\"></a>\n    <span class=\"mh-status\" id=\"mhStatus\"><span class=\"mh-dot\" id=\"mhDot\"></span><span class=\"mh-status-text\" id=\"mhStatusText\"></span></span>\n  </div>\n</header>\n";
-export declare const profileBarJs = "\n(function() {\n  var profileChip = document.getElementById('mhProfile');\n  var statusDot = document.getElementById('mhDot');\n  var statusText = document.getElementById('mhStatusText');\n\n  // Highlight active nav link\n  var path = location.pathname;\n  var navLinks = document.querySelectorAll('.mh-nav a');\n  navLinks.forEach(function(a) {\n    if (a.getAttribute('href') === path || (path === '/telemetry' && a.id === 'nav-telemetry') || (path === '/' && a.id === 'nav-home')) {\n      a.classList.add('active');\n    }\n  });\n\n  function esc(s) { var d = document.createElement('div'); d.textContent = s; return d.innerHTML; }\n\n  function loadHeader() {\n    fetch('/health').then(function(r) { return r.json(); }).then(function(h) {\n      var st = h.status === 'healthy' ? 'healthy' : h.status === 'degraded' ? 'degraded' : 'unhealthy';\n      statusDot.className = 'mh-dot ' + st;\n      statusText.textContent = st === 'healthy' ? 'Operational' : st === 'degraded' ? 'Degraded' : 'Offline';\n    }).catch(function() {\n      statusDot.className = 'mh-dot unhealthy';\n      statusText.textContent = 'Offline';\n    });\n\n    fetch('/profiles/list').then(function(r) { return r.json(); }).then(function(data) {\n      var current = (data.profiles || []).find(function(p) { return p.isActive; });\n      if (!current) { profileChip.classList.remove('visible'); return; }\n      profileChip.innerHTML = esc(current.id) + ' <span class=\"mh-profile-type\">' + esc(current.type || '') + '</span>';\n      profileChip.classList.add('visible');\n    }).catch(function() {});\n  }\n\n  loadHeader();\n  setInterval(loadHeader, 10000);\n  // Pages call this after mutating state (e.g. switching the active profile)\n  // so the header chip updates immediately instead of on the next poll.\n  window.meridianHeaderRefresh = loadHeader;\n})();\n";
+export declare const profileBarCss = "\n  .meridian-header {\n    position: sticky; top: 0; z-index: 100;\n    display: flex; align-items: center; gap: 20px;\n    padding: 10px 24px;\n    background: rgba(13, 17, 23, 0.92);\n    backdrop-filter: blur(12px);\n    border-bottom: 1px solid var(--border, #30363d);\n  }\n  .meridian-header .mh-brand {\n    display: flex; align-items: center; gap: 10px;\n    text-decoration: none; color: var(--text, #e6edf3);\n  }\n  .meridian-header .mh-logo { display: block; }\n  .meridian-header .mh-name {\n    font-size: 15px; font-weight: 700; letter-spacing: 2px;\n    text-transform: uppercase;\n  }\n  .meridian-header .mh-nav { display: flex; align-items: center; gap: 2px; }\n  .meridian-header .mh-nav a {\n    color: var(--muted, #8b949e); text-decoration: none; font-size: 12px;\n    font-weight: 500; padding: 5px 10px; border-radius: 6px;\n    transition: color 0.15s, background 0.15s;\n  }\n  .meridian-header .mh-nav a:hover { color: var(--text, #e6edf3); background: var(--surface, #161b22); }\n  .meridian-header .mh-nav a.active { color: var(--accent, #58a6ff); background: var(--surface, #161b22); }\n  .meridian-header .mh-right {\n    margin-left: auto; display: flex; align-items: center; gap: 10px;\n  }\n  .meridian-header .mh-profile {\n    display: none; align-items: center; gap: 6px;\n    font-size: 11px; font-weight: 500; color: var(--text, #e6edf3);\n    padding: 3px 10px; border-radius: 20px;\n    background: var(--surface, #161b22); border: 1px solid var(--border, #30363d);\n    text-decoration: none; transition: border-color 0.15s;\n  }\n  .meridian-header .mh-profile:hover { border-color: var(--accent, #58a6ff); }\n  .meridian-header .mh-profile.visible { display: inline-flex; }\n  .meridian-header .mh-profile .mh-profile-type {\n    color: var(--muted, #8b949e); font-size: 10px;\n  }\n  /* Build chip \u2014 two mutually exclusive states, and the colour is not a\n     style choice: \"update available\" is a link to the releases page, so it\n     is blue (interactive); \"local/dev build\" is a meta annotation with no\n     href, so it is violet. Swapping them would break the DESIGN.md rule. */\n  .meridian-header .mh-build {\n    display: none; align-items: center; gap: 6px;\n    font-size: 11px; font-weight: 500; white-space: nowrap;\n    padding: 3px 10px; border-radius: 20px; text-decoration: none;\n    transition: background 0.15s;\n  }\n  .meridian-header .mh-build.visible { display: inline-flex; }\n  .meridian-header .mh-build.update {\n    color: var(--accent, #58a6ff);\n    background: rgba(88,166,255,0.12);\n    border: 1px solid rgba(88,166,255,0.35);\n  }\n  .meridian-header .mh-build.update:hover { background: rgba(88,166,255,0.18); }\n  .meridian-header .mh-build.provenance {\n    color: var(--accent2, #bc8cff);\n    background: rgba(188,140,255,0.12);\n    border: 1px solid rgba(188,140,255,0.35);\n    cursor: default;\n  }\n  .meridian-header .mh-status {\n    display: inline-flex; align-items: center; gap: 6px;\n    font-size: 11px; color: var(--muted, #8b949e); white-space: nowrap;\n  }\n  .meridian-header .mh-dot {\n    width: 8px; height: 8px; border-radius: 50%;\n    background: var(--muted, #8b949e); flex-shrink: 0;\n  }\n  .meridian-header .mh-dot.healthy { background: var(--green, #3fb950); box-shadow: 0 0 6px rgba(63,185,80,0.5); }\n  .meridian-header .mh-dot.degraded { background: var(--yellow, #d29922); }\n  .meridian-header .mh-dot.unhealthy { background: var(--red, #f85149); }\n  @media (max-width: 720px) {\n    .meridian-header { gap: 10px; padding: 10px 16px; flex-wrap: wrap; }\n    .meridian-header .mh-name { display: none; }\n    .meridian-header .mh-status .mh-status-text { display: none; }\n  }\n";
+export declare const profileBarHtml = "\n<header class=\"meridian-header\" id=\"meridianHeader\">\n  <a class=\"mh-brand\" href=\"/\">\n    <svg class=\"mh-logo\" width=\"24\" height=\"24\" viewBox=\"0 0 64 64\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\" aria-hidden=\"true\">\n  <defs>\n    <linearGradient id=\"mhGrad\" x1=\"32\" y1=\"4\" x2=\"32\" y2=\"60\" gradientUnits=\"userSpaceOnUse\">\n      <stop stop-color=\"#58a6ff\"/>\n      <stop offset=\"1\" stop-color=\"#bc8cff\"/>\n    </linearGradient>\n  </defs>\n  <circle cx=\"32\" cy=\"32\" r=\"25\" stroke=\"url(#mhGrad)\" stroke-width=\"3.5\"/>\n  <ellipse cx=\"32\" cy=\"32\" rx=\"10.5\" ry=\"25\" stroke=\"url(#mhGrad)\" stroke-width=\"2.5\" opacity=\"0.8\"/>\n  <path d=\"M7 32h50\" stroke=\"url(#mhGrad)\" stroke-width=\"2\" opacity=\"0.4\"/>\n  <circle cx=\"32\" cy=\"7\" r=\"4.5\" fill=\"#58a6ff\"/>\n  <circle cx=\"32\" cy=\"57\" r=\"4.5\" fill=\"#bc8cff\"/>\n</svg>\n    <span class=\"mh-name\">Meridian</span>\n  </a>\n  <nav class=\"mh-nav\">\n    <a href=\"/\" id=\"nav-home\">Home</a>\n    <a href=\"/telemetry\" id=\"nav-telemetry\">Telemetry</a>\n    <a href=\"/profiles\" id=\"nav-profiles\">Profiles</a>\n    <a href=\"/settings\" id=\"nav-settings\">Settings</a>\n    <a href=\"/plugins\" id=\"nav-plugins\">Plugins</a>\n  </nav>\n  <div class=\"mh-right\">\n    <a class=\"mh-build\" id=\"mhBuild\" target=\"_blank\" rel=\"noopener\"></a>\n    <a class=\"mh-profile\" id=\"mhProfile\" href=\"/\" title=\"Active profile \u2014 switch from the home page\"></a>\n    <span class=\"mh-status\" id=\"mhStatus\"><span class=\"mh-dot\" id=\"mhDot\"></span><span class=\"mh-status-text\" id=\"mhStatusText\"></span></span>\n  </div>\n</header>\n";
+export declare const profileBarJs = "\n(function() {\n  var profileChip = document.getElementById('mhProfile');\n  var buildChip = document.getElementById('mhBuild');\n  var statusDot = document.getElementById('mhDot');\n  var statusText = document.getElementById('mhStatusText');\n\n  // Highlight active nav link\n  var path = location.pathname;\n  var navLinks = document.querySelectorAll('.mh-nav a');\n  navLinks.forEach(function(a) {\n    if (a.getAttribute('href') === path || (path === '/telemetry' && a.id === 'nav-telemetry') || (path === '/' && a.id === 'nav-home')) {\n      a.classList.add('active');\n    }\n  });\n\n  function esc(s) { var d = document.createElement('div'); d.textContent = s; return d.innerHTML; }\n\n  // Build provenance chip. Hidden entirely for a current npm install, which\n  // is the case that needs no comment.\n  function renderBuild(build) {\n    if (!buildChip) return;\n    if (!build) { buildChip.className = 'mh-build'; return; }\n    if (build.source !== 'npm') {\n      buildChip.textContent = (build.source === 'dev' ? 'dev build' : 'local build') + (build.dirty ? ' *' : '');\n      buildChip.removeAttribute('href');\n      buildChip.title = 'Not an npm release \u2014 the reported version ' + build.version +\n        ' is the tree\\'s last release, not proof of what is running' +\n        (build.branch ? '\\nbranch: ' + build.branch : '') +\n        (build.sha ? '\\ncommit: ' + build.sha.slice(0, 8) : '') +\n        (build.dirty ? '\\nuncommitted changes present' : '');\n      buildChip.className = 'mh-build provenance visible';\n      return;\n    }\n    if (build.updateAvailable) {\n      buildChip.textContent = build.latest + ' available';\n      buildChip.href = 'https://github.com/rynfar/meridian/releases';\n      buildChip.title = 'Running ' + build.version + ' \u2014 update with:\\nnpm install -g @rynfar/meridian@latest';\n      buildChip.className = 'mh-build update visible';\n      return;\n    }\n    buildChip.className = 'mh-build';\n  }\n\n  function loadHeader() {\n    fetch('/health').then(function(r) { return r.json(); }).then(function(h) {\n      var st = h.status === 'healthy' ? 'healthy' : h.status === 'degraded' ? 'degraded' : 'unhealthy';\n      statusDot.className = 'mh-dot ' + st;\n      statusText.textContent = st === 'healthy' ? 'Operational' : st === 'degraded' ? 'Degraded' : 'Offline';\n      renderBuild(h.build);\n    }).catch(function() {\n      statusDot.className = 'mh-dot unhealthy';\n      statusText.textContent = 'Offline';\n    });\n\n    fetch('/profiles/list').then(function(r) { return r.json(); }).then(function(data) {\n      var current = (data.profiles || []).find(function(p) { return p.isActive; });\n      if (!current) { profileChip.classList.remove('visible'); return; }\n      profileChip.innerHTML = esc(current.id) + ' <span class=\"mh-profile-type\">' + esc(current.type || '') + '</span>';\n      profileChip.classList.add('visible');\n    }).catch(function() {});\n  }\n\n  loadHeader();\n  setInterval(loadHeader, 10000);\n  // Pages call this after mutating state (e.g. switching the active profile)\n  // so the header chip updates immediately instead of on the next poll.\n  window.meridianHeaderRefresh = loadHeader;\n})();\n";
 //# sourceMappingURL=profileBar.d.ts.map

package/dist/telemetry/profileBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profileBar.d.ts","sourceRoot":"","sources":["../../src/telemetry/profileBar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,6gDAwCpB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,syBAYrB,CAAA;AAEP,eAAO,MAAM,aAAa,glFAyDzB,CAAA;AAED,eAAO,MAAM,cAAc,ukDAkB1B,CAAA;AAED,eAAO,MAAM,YAAY,k0DAyCxB,CAAA"}
+{"version":3,"file":"profileBar.d.ts","sourceRoot":"","sources":["../../src/telemetry/profileBar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,6gDAwCpB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,syBAYrB,CAAA;AAEP,eAAO,MAAM,aAAa,ioHAgFzB,CAAA;AAED,eAAO,MAAM,cAAc,ypDAmB1B,CAAA;AAED,eAAO,MAAM,YAAY,4pGAqExB,CAAA"}