@cortexkit/antigravity-auth-core 1.1.0 → 2.0.1

package/dist/file-lock.js

@@ -0,0 +1,438 @@
+/**
+ * Renewable fenced file lock.
+ *
+ * The lock file at `${path}.${name}.lock` holds the JSON
+ * `{ ownerId, expiresAt }`. Acquiring it uses an exclusive `wx` write so
+ * concurrent processes race deterministically — only one wins.
+ *
+ * A contended, live lock (ownerId present, expiresAt > now) returns
+ * `null` immediately; no eviction is attempted and no destructive op
+ * touches the file. A contended, stale lock (no owner, expired, or
+ * malformed-but-old) opens an eviction protocol that uses an exclusive
+ * "evicting" marker directory at `${lockPath}.evicting/owner.json` as a
+ * fence: the file holds the in-progress evicter's ownerId. The marker
+ * is verified before every destructive seam (re-read, unlink,
+ * re-acquire) so a contender whose marker has been hijacked will see
+ * ownership has changed and back off without touching the winner's lock.
+ *
+ * The renewal timer is `setInterval(...).unref()`-ed so it does not
+ * keep the Node/Bun runtime alive. Default renewal interval is
+ * `max(1000, floor(ttlMs / 3))`.
+ */
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, rm, stat, unlink, writeFile, } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+const RENEW_MIN_INTERVAL_MS = 1_000;
+const MARKER_CLAIM_MAX_ATTEMPTS = 8;
+const MARKER_CLAIM_BACKOFF_MS = 25;
+/**
+ * Thrown by `assertOwned` when the lock file no longer carries our
+ * ownerId or has expired.
+ */
+export class FileLockOwnershipError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.name = 'FileLockOwnershipError';
+        this.details = details;
+    }
+}
+const MARKER_TTL_MS = 30_000;
+async function readLockPayload(path) {
+    try {
+        const text = await readFile(path, 'utf8');
+        const parsed = JSON.parse(text);
+        if (typeof parsed === 'object' &&
+            parsed !== null &&
+            typeof parsed.ownerId === 'string' &&
+            typeof parsed.expiresAt === 'number') {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+async function readMarkerPayload(path) {
+    try {
+        const text = await readFile(path, 'utf8');
+        const parsed = JSON.parse(text);
+        if (typeof parsed === 'object' &&
+            parsed !== null &&
+            typeof parsed.ownerId === 'string' &&
+            typeof parsed.pid === 'number' &&
+            typeof parsed.createdAt === 'number') {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Best-effort liveness check for a PID. Returns `true` when the process
+ * is alive or when the platform lacks a reliable probe (Windows), so
+ * the marker is only reclaimed when we have positive evidence of death.
+ */
+function isProcessAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ESRCH')
+            return false;
+        // EPERM (process exists but we cannot signal it) still counts as alive.
+        return true;
+    }
+}
+async function rmEvictingDir(evictingPath) {
+    await rm(evictingPath, { force: true }).catch(() => { });
+    await rm(dirname(evictingPath), { recursive: true, force: true }).catch(() => { });
+}
+async function sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function acquireFencedFileLock(options) {
+    const lockPath = `${options.path}.${options.name}.lock`;
+    const evictingDir = `${lockPath}.evicting`;
+    const evictingPath = join(evictingDir, 'owner.json');
+    const ownerId = randomUUID();
+    const now = options.now ?? Date.now;
+    const tryAcquire = async (expiresAt) => {
+        const payload = JSON.stringify({ ownerId, expiresAt });
+        try {
+            await mkdir(dirname(lockPath), { recursive: true });
+            await writeFile(lockPath, payload, {
+                flag: 'wx',
+                encoding: 'utf8',
+                mode: 0o600,
+            });
+            return buildLock(lockPath, evictingPath, ownerId, options, now);
+        }
+        catch (err) {
+            if (err.code === 'EEXIST') {
+                return null;
+            }
+            throw err;
+        }
+    };
+    // Outer loop: each iteration represents one full attempt to acquire
+    // (fresh OR after eviction). We may need to retry if the contender
+    // creates a new lock between our unlink and our re-acquire.
+    for (;;) {
+        const firstTry = await tryAcquire(now() + options.ttlMs);
+        if (firstTry)
+            return firstTry;
+        const observed = await readLockPayload(lockPath);
+        const lockStats = await stat(lockPath).catch(() => null);
+        if (!lockStats)
+            continue; // lock vanished between attempts
+        const currentTime = now();
+        const looksLive = observed !== null &&
+            typeof observed.ownerId === 'string' &&
+            observed.expiresAt > currentTime;
+        if (looksLive) {
+            return null;
+        }
+        // malformed fail-closed: only proceed when mtime proves staleness.
+        const looksValid = observed !== null;
+        if (!looksValid) {
+            const ageMs = currentTime - lockStats.mtimeMs;
+            if (ageMs < options.ttlMs)
+                return null;
+        }
+        // Past this point we have decided the lock is stale and we will
+        // attempt eviction.
+        await options.onStep?.('stale-marker-stat');
+        // Claim the exclusive evicting marker (bounded retries so a stuck
+        // contender cannot trap us in an infinite loop). Before each retry,
+        // inspect the existing marker: if its PID is dead or the marker is
+        // older than MARKER_TTL_MS, it is abandoned and we reclaim it.
+        let markerClaimed = false;
+        for (let attempt = 0; attempt < MARKER_CLAIM_MAX_ATTEMPTS; attempt++) {
+            try {
+                await mkdir(evictingDir, { recursive: true, mode: 0o700 });
+                await writeFile(evictingPath, JSON.stringify({
+                    ownerId,
+                    pid: process.pid,
+                    createdAt: now(),
+                }), {
+                    flag: 'wx',
+                    encoding: 'utf8',
+                    mode: 0o600,
+                });
+                markerClaimed = true;
+                break;
+            }
+            catch (err) {
+                if (err.code !== 'EEXIST')
+                    throw err;
+                // Existing marker — check whether it is reclaimed-able.
+                const existing = await readMarkerPayload(evictingPath);
+                if (existing) {
+                    const ageMs = now() - existing.createdAt;
+                    const deadPid = !isProcessAlive(existing.pid);
+                    if (deadPid || ageMs > MARKER_TTL_MS) {
+                        // Stale marker — recycle the directory and retry the claim.
+                        await rmEvictingDir(evictingPath);
+                        continue;
+                    }
+                }
+                await sleep(MARKER_CLAIM_BACKOFF_MS);
+            }
+        }
+        if (!markerClaimed) {
+            return null;
+        }
+        await options.onStep?.('stale-marker-claimed');
+        // First re-check boundary: confirm the marker is still ours AND
+        // the lock still looks stale (its real owner may have refreshed).
+        let markerPayload = await readMarkerPayload(evictingPath);
+        if (markerPayload?.ownerId !== ownerId)
+            continue;
+        const observedAgain = await readLockPayload(lockPath);
+        const refreshed = observedAgain !== null &&
+            observedAgain.ownerId !== ownerId &&
+            observedAgain.expiresAt > now();
+        if (refreshed) {
+            await rmEvictingDir(evictingPath);
+            return null;
+        }
+        await options.onStep?.('stale-lock-confirmed');
+        // Second re-check boundary: marker must still be ours before
+        // unlinking. If we lost ownership between the previous check and
+        // this one, the winner is now responsible for the lock file.
+        markerPayload = await readMarkerPayload(evictingPath);
+        if (markerPayload?.ownerId !== ownerId)
+            continue;
+        try {
+            await unlink(lockPath);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ENOENT') {
+                await rmEvictingDir(evictingPath);
+                continue;
+            }
+        }
+        await options.onStep?.('eviction-marker-acquired');
+        // Re-acquire while still holding the marker as the new lock's
+        // "we evicted this" witness. If another contender grabs between our
+        // unlink and our re-acquire, drop the marker and loop back.
+        const reentry = await tryAcquire(now() + options.ttlMs);
+        if (reentry) {
+            await rmEvictingDir(evictingPath);
+            return reentry;
+        }
+        await rmEvictingDir(evictingPath);
+    }
+}
+function buildLock(lockPath, evictingPath, ownerId, options, now) {
+    let renewTimer = null;
+    let inFlightRenew = null;
+    let released = false;
+    let lost = false;
+    let lostResolve = null;
+    let lostPromise = new Promise((resolve) => {
+        lostResolve = resolve;
+    });
+    const markLost = () => {
+        if (lost)
+            return;
+        lost = true;
+        if (renewTimer !== null) {
+            clearInterval(renewTimer);
+            renewTimer = null;
+        }
+        const resolve = lostResolve;
+        lostResolve = null;
+        resolve?.();
+    };
+    const setupRenew = () => {
+        if (options.renew === false)
+            return;
+        const interval = options.renewIntervalMs ??
+            Math.max(RENEW_MIN_INTERVAL_MS, Math.floor(options.ttlMs / 3));
+        const renew = async () => {
+            if (released || lost)
+                return;
+            try {
+                const observed = await readLockPayload(lockPath);
+                if (released || lost)
+                    return;
+                await options.onStep?.('renew-read');
+                if (released || lost)
+                    return;
+                // If the lock file is gone or carries a different ownerId, the
+                // lock has been taken over (e.g. owner B evicted and replaced
+                // the lock while this renewal was paused). Mark it lost so the
+                // next iteration stops renewing.
+                if (observed === null) {
+                    markLost();
+                    return;
+                }
+                if (observed.ownerId !== ownerId) {
+                    markLost();
+                    return;
+                }
+                if (observed.expiresAt > now()) {
+                    if (released || lost)
+                        return;
+                    // Rename cannot compare-and-swap ownership. Re-read after the
+                    // rename and mark this lock lost if another owner replaced it;
+                    // writers call assertOwned() before mutating shared state, so a
+                    // hijack in this seam is detected and stops future renewals.
+                    const tempPath = `${lockPath}.${ownerId}.tmp`;
+                    let shouldCommit = false;
+                    try {
+                        await writeFile(tempPath, JSON.stringify({
+                            ownerId,
+                            expiresAt: now() + options.ttlMs,
+                        }), { encoding: 'utf8', mode: 0o600 });
+                        if (released || lost) {
+                            await unlink(tempPath).catch(() => { });
+                            return;
+                        }
+                        const currentObserved = await readLockPayload(lockPath);
+                        if (released || lost) {
+                            await unlink(tempPath).catch(() => { });
+                            return;
+                        }
+                        if (!currentObserved || currentObserved.ownerId !== ownerId) {
+                            // Another owner slipped in — leave their content intact,
+                            // mark lost, drop our temp draft.
+                            markLost();
+                            await unlink(tempPath).catch(() => { });
+                            return;
+                        }
+                        shouldCommit = true;
+                        await rename(tempPath, lockPath);
+                        await options.onStep?.('renew-committed');
+                        if (released || lost)
+                            return;
+                        // Verify-after-commit: a replacement owner may have arrived
+                        // between the re-read above and the rename — our rename then
+                        // just overwrote their fresh lock — or may land a microsecond
+                        // after our rename. Re-read and, if the file no longer carries
+                        // our ownerId, mark lost and stop renewing so the double-owner
+                        // window collapses to this seam; the fresh owner's next
+                        // renewal/acquire attempt re-acquires.
+                        const committed = await readLockPayload(lockPath);
+                        if (released || lost)
+                            return;
+                        if (!committed || committed.ownerId !== ownerId) {
+                            markLost();
+                            return;
+                        }
+                    }
+                    catch {
+                        // Lost the race against a rename/evict — mark lost so the
+                        // next iteration stops renewing, and clean up any temp draft.
+                        markLost();
+                        if (!shouldCommit) {
+                            await unlink(tempPath).catch(() => { });
+                        }
+                    }
+                }
+            }
+            catch {
+                // best-effort renewal; nothing to do on failure
+            }
+        };
+        // The timer callback is small: it only schedules a renew if one is not
+        // already in flight and the lock has not been released. The renew
+        // Promise itself runs to completion; its in-flight state is tracked
+        // so release() can await it before unlinking.
+        const tick = () => {
+            if (released)
+                return;
+            if (inFlightRenew)
+                return;
+            inFlightRenew = renew().finally(() => {
+                inFlightRenew = null;
+            });
+        };
+        renewTimer = setInterval(tick, interval);
+        if (renewTimer &&
+            typeof renewTimer.unref === 'function') {
+            ;
+            renewTimer.unref();
+        }
+    };
+    const release = async () => {
+        if (released)
+            return;
+        released = true;
+        if (renewTimer !== null) {
+            clearInterval(renewTimer);
+            renewTimer = null;
+        }
+        const pendingRenew = inFlightRenew;
+        inFlightRenew = null;
+        if (pendingRenew) {
+            try {
+                await pendingRenew;
+            }
+            catch {
+                // renewal swallows its own errors; awaiting is just a fence
+            }
+        }
+        try {
+            const observed = await readLockPayload(lockPath);
+            if (!observed || observed.ownerId !== ownerId) {
+                // Not ours anymore — refuse to delete.
+                await rmEvictingDir(evictingPath).catch(() => { });
+                return;
+            }
+            try {
+                await unlink(lockPath);
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT')
+                    throw err;
+            }
+            await rmEvictingDir(evictingPath).catch(() => { });
+        }
+        finally {
+            markLost();
+            renewTimer = null;
+            inFlightRenew = null;
+            lostResolve = null;
+            lostPromise = null;
+        }
+    };
+    const assertOwned = async () => {
+        const observed = await readLockPayload(lockPath);
+        if (!observed || observed.ownerId !== ownerId) {
+            throw new FileLockOwnershipError(`file lock ${lockPath} is not owned by ${ownerId}`, {
+                path: lockPath,
+                expectedOwner: ownerId,
+                observedOwner: observed?.ownerId,
+                observedExpiresAt: observed?.expiresAt,
+            });
+        }
+        if (observed.expiresAt <= now()) {
+            throw new FileLockOwnershipError(`file lock ${lockPath} has expired`, {
+                path: lockPath,
+                expectedOwner: ownerId,
+                observedOwner: observed.ownerId,
+                observedExpiresAt: observed.expiresAt,
+            });
+        }
+    };
+    setupRenew();
+    return {
+        ownerId,
+        assertOwned,
+        release,
+        whenLost: () => lostPromise ?? Promise.resolve(),
+        hasLost: () => lost,
+    };
+}
+//# sourceMappingURL=file-lock.js.map

package/dist/file-lock.js.map

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

package/dist/fingerprint.d.ts

@@ -1,12 +1,12 @@
 /**
  * Device Fingerprint Generator for Rate Limit Mitigation
  *
- * Uses the agy CLI 1.1.5 content-request identity captured with mitmproxy:
+ * Uses the agy CLI 1.1.6 content-request identity captured with mitmproxy:
  * an Antigravity CLI User-Agent with explicit client, OS, architecture, and auth metadata.
  * The stored deviceId/sessionToken fields are
  * retained for account history, but content requests only send User-Agent.
  */
-export declare const AGY_CLI_VERSION = "1.1.5";
+export declare const AGY_CLI_VERSION = "1.1.6";
 export interface ClientMetadata {
     ideType: string;
     platform: string;
@@ -32,7 +32,7 @@ export interface FingerprintVersion {
 /** Maximum number of fingerprint versions to keep per account */
 export declare const MAX_FINGERPRINT_HISTORY = 5;
 export interface FingerprintHeaders {
-    "User-Agent": string;
+    'User-Agent': string;
 }
 export declare function buildAntigravityHarnessPlatformArch(platform?: NodeJS.Platform, arch?: NodeJS.Architecture): string;
 export declare function buildAntigravityHarnessUserAgent(version?: string, platform?: NodeJS.Platform, arch?: NodeJS.Architecture, authMethod?: string): string;
@@ -70,4 +70,10 @@ export declare function getSessionFingerprint(): Fingerprint;
  * Call this to get a fresh identity (e.g., after rate limiting).
  */
 export declare function regenerateSessionFingerprint(): Fingerprint;
+/**
+ * Clear the cached session fingerprint so the next `getSessionFingerprint`
+ * call generates a fresh one. Test-only escape hatch — production code should
+ * use `regenerateSessionFingerprint` to also return the new value.
+ */
+export declare function clearSessionFingerprint(): void;
 //# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,eAAe,UAAU,CAAC;AAGvC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AACD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;CAChD;AAED,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAiBD,wBAAgB,mCAAmC,CACjD,QAAQ,kBAAmB,EAC3B,IAAI,sBAAe,GAClB,MAAM,CAER;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,SAAkB,EACzB,QAAQ,kBAAmB,EAC3B,IAAI,sBAAe,EACnB,UAAU,SAAa,GACtB,MAAM,CAIR;AAED,wBAAgB,8CAA8C,CAAC,OAAO,SAAkB,GAAG,MAAM,CAEhG;AAMD,wBAAgB,sCAAsC,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/E;AAED,wBAAgB,uCAAuC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOnG;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAajD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,WAAW,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAQ1E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAQpG;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAKnD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,WAAW,CAG1D"}
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,eAAe,UAAU,CAAA;AAGtC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,cAAc,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;CAClB;AACD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,WAAW,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAA;CAC/C;AAED,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;CACrB;AAiBD,wBAAgB,mCAAmC,CACjD,QAAQ,kBAAmB,EAC3B,IAAI,sBAAe,GAClB,MAAM,CAER;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,SAAkB,EACzB,QAAQ,kBAAmB,EAC3B,IAAI,sBAAe,EACnB,UAAU,SAAa,GACtB,MAAM,CAIR;AAED,wBAAgB,8CAA8C,CAC5D,OAAO,SAAkB,GACxB,MAAM,CAER;AAQD,wBAAgB,sCAAsC,IAAI,MAAM,CAC9D,MAAM,EACN,MAAM,CACP,CAEA;AAED,wBAAgB,uCAAuC,CACrD,WAAW,EAAE,MAAM,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAajD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,WAAW,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAQ1E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,GAAG,IAAI,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAQ7B;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAKnD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,WAAW,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/fingerprint.js

@@ -1,33 +1,33 @@
 /**
  * Device Fingerprint Generator for Rate Limit Mitigation
  *
- * Uses the agy CLI 1.1.5 content-request identity captured with mitmproxy:
+ * Uses the agy CLI 1.1.6 content-request identity captured with mitmproxy:
  * an Antigravity CLI User-Agent with explicit client, OS, architecture, and auth metadata.
  * The stored deviceId/sessionToken fields are
  * retained for account history, but content requests only send User-Agent.
  */
-import * as crypto from "node:crypto";
-export const AGY_CLI_VERSION = "1.1.5";
-const ANTIGRAVITY_API_CLIENT = "antigravity-cli";
+import * as crypto from 'node:crypto';
+export const AGY_CLI_VERSION = '1.1.6';
+const ANTIGRAVITY_API_CLIENT = 'antigravity-cli';
 /** Maximum number of fingerprint versions to keep per account */
 export const MAX_FINGERPRINT_HISTORY = 5;
 function normalizeHarnessPlatform(platform = process.platform) {
-    return platform === "win32" ? "windows" : platform || "unknown";
+    return platform === 'win32' ? 'windows' : platform || 'unknown';
 }
 function normalizeHarnessArch(arch = process.arch) {
     switch (arch) {
-        case "x64":
-            return "amd64";
-        case "ia32":
-            return "386";
+        case 'x64':
+            return 'amd64';
+        case 'ia32':
+            return '386';
         default:
-            return arch || "unknown";
+            return arch || 'unknown';
     }
 }
 export function buildAntigravityHarnessPlatformArch(platform = process.platform, arch = process.arch) {
     return `${normalizeHarnessPlatform(platform)}/${normalizeHarnessArch(arch)}`;
 }
-export function buildAntigravityHarnessUserAgent(version = AGY_CLI_VERSION, platform = process.platform, arch = process.arch, authMethod = "consumer") {
+export function buildAntigravityHarnessUserAgent(version = AGY_CLI_VERSION, platform = process.platform, arch = process.arch, authMethod = 'consumer') {
     const osType = normalizeHarnessPlatform(platform);
     const normalizedArch = normalizeHarnessArch(arch);
     return `antigravity/cli/${version} (aidev_client; os_type=${osType}; arch=${normalizedArch}; auth_method=${authMethod})`;
@@ -36,24 +36,24 @@ export function buildAntigravityHarnessLoadCodeAssistUserAgent(version = AGY_CLI
     return buildAntigravityHarnessUserAgent(version);
 }
 function platformToMetadataPlatform(platform = process.platform) {
-    return platform === "win32" ? "WINDOWS" : "MACOS";
+    return platform === 'win32' ? 'WINDOWS' : 'MACOS';
 }
 export function buildAntigravityLoadCodeAssistMetadata() {
-    return { ideType: "ANTIGRAVITY" };
+    return { ideType: 'ANTIGRAVITY' };
 }
 export function buildAntigravityHarnessBootstrapHeaders(accessToken) {
     return {
-        "User-Agent": buildAntigravityHarnessLoadCodeAssistUserAgent(),
+        'User-Agent': buildAntigravityHarnessLoadCodeAssistUserAgent(),
         Authorization: `Bearer ${accessToken}`,
-        "Content-Type": "application/json",
-        "Accept-Encoding": "gzip",
+        'Content-Type': 'application/json',
+        'Accept-Encoding': 'gzip',
     };
 }
 function generateDeviceId() {
     return crypto.randomUUID();
 }
 function generateSessionToken() {
-    return crypto.randomBytes(16).toString("hex");
+    return crypto.randomBytes(16).toString('hex');
 }
 /**
  * Generate the per-account content-request fingerprint.
@@ -66,9 +66,9 @@ export function generateFingerprint() {
         userAgent: buildAntigravityHarnessUserAgent(),
         apiClient: ANTIGRAVITY_API_CLIENT,
         clientMetadata: {
-            ideType: "ANTIGRAVITY",
+            ideType: 'ANTIGRAVITY',
             platform: platformToMetadataPlatform(),
-            pluginType: "GEMINI",
+            pluginType: 'GEMINI',
         },
         createdAt: Date.now(),
     };
@@ -102,7 +102,7 @@ export function buildFingerprintHeaders(fingerprint) {
         return {};
     }
     return {
-        "User-Agent": fingerprint.userAgent,
+        'User-Agent': fingerprint.userAgent,
     };
 }
 /**
@@ -128,4 +128,12 @@ export function regenerateSessionFingerprint() {
     sessionFingerprint = generateFingerprint();
     return sessionFingerprint;
 }
+/**
+ * Clear the cached session fingerprint so the next `getSessionFingerprint`
+ * call generates a fresh one. Test-only escape hatch — production code should
+ * use `regenerateSessionFingerprint` to also return the new value.
+ */
+export function clearSessionFingerprint() {
+    sessionFingerprint = null;
+}
 //# sourceMappingURL=fingerprint.js.map

package/dist/fingerprint.js.map

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