@juspay/neurolink 11.12.0 → 11.13.1

package/dist/lib/proxy/proxyAnalysis.js

@@ -1,901 +0,0 @@
-import { createReadStream } from "node:fs";
-import { lstat, readdir, realpath, stat } from "node:fs/promises";
-import { homedir } from "node:os";
-import { createInterface } from "node:readline";
-import { isAbsolute, join, relative, resolve, sep } from "node:path";
-import { ACCOUNT_COOLING_REASONS, PROXY_ACCOUNT_TYPES, PROXY_ACCOUNT_ROUTING_MODES, PROXY_ACCOUNT_ROUTING_REASONS, PROXY_ACCOUNT_ROUTING_STRATEGIES, } from "./routingEvidence.js";
-const LIFECYCLE_FILE_PATTERN = /^proxy-lifecycle-\d{4}-\d{2}-\d{2}\.jsonl$/;
-const REQUEST_FILE_PATTERN = /^proxy-\d{4}-\d{2}-\d{2}\.jsonl$/;
-const ATTEMPT_FILE_PATTERN = /^proxy-attempts-\d{4}-\d{2}-\d{2}\.jsonl$/;
-const DEBUG_FILE_PATTERN = /^proxy-debug-\d{4}-\d{2}-\d{2}\.jsonl$/;
-const ARTIFACT_STAT_CONCURRENCY = 64;
-const LIFECYCLE_EVENTS = new Set([
-    "request_accepted",
-    "response_headers",
-    "response_first_chunk",
-    "request_terminal",
-]);
-const ROUTING_STRATEGIES = new Set(PROXY_ACCOUNT_ROUTING_STRATEGIES);
-const ROUTING_MODES = new Set(PROXY_ACCOUNT_ROUTING_MODES);
-const ROUTING_REASONS = new Set(PROXY_ACCOUNT_ROUTING_REASONS);
-const ROUTING_ACCOUNT_TYPES = new Set(PROXY_ACCOUNT_TYPES);
-const COOLING_REASONS = new Set(ACCOUNT_COOLING_REASONS);
-const QUOTA_FRESHNESS_VALUES = new Set([
-    "unknown",
-    "fresh",
-    "stale_known",
-    "refresh_due",
-]);
-const QUOTA_REFRESH_REASONS = new Set([
-    "startup_unknown",
-    "handoff_prewarm",
-    "ambiguous_snapshot",
-    "manual",
-]);
-const QUOTA_SATURATION_KINDS = new Set(["none", "soft", "hard"]);
-const MAX_RETAINED_ROUTING_RECORDS = 200;
-const MAX_ROUTING_RECORDS_BEFORE_COMPACTION = MAX_RETAINED_ROUTING_RECORDS * 2;
-function isContainedPath(root, candidate) {
-    const candidateRelative = relative(root, candidate);
-    return (candidateRelative.length > 0 &&
-        !isAbsolute(candidateRelative) &&
-        candidateRelative !== ".." &&
-        !candidateRelative.startsWith(`..${sep}`));
-}
-async function inspectBodyArtifact(artifactPath, canonicalBodiesRoot) {
-    if (!canonicalBodiesRoot) {
-        return "missing";
-    }
-    try {
-        const canonicalArtifactPath = await realpath(artifactPath);
-        if (!isContainedPath(canonicalBodiesRoot, canonicalArtifactPath)) {
-            return "invalid";
-        }
-        return (await stat(canonicalArtifactPath)).isFile() ? "present" : "missing";
-    }
-    catch {
-        return "missing";
-    }
-}
-function increment(counter, key) {
-    counter[key] = (counter[key] ?? 0) + 1;
-}
-function finiteNumber(value) {
-    return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-function stringValue(value) {
-    return typeof value === "string" && value.length > 0 ? value : null;
-}
-function isNullableString(value) {
-    return value === null || (typeof value === "string" && value.length > 0);
-}
-function isNullableFiniteNumber(value) {
-    return value === null || finiteNumber(value) !== null;
-}
-function routingCandidateValue(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        return null;
-    }
-    const candidate = value;
-    const requiredBooleanFields = [
-        "configuredPrimary",
-        "usable",
-        "saturated",
-        "quotaObserved",
-        "coolingActive",
-    ];
-    const requiredNullableNumberFields = [
-        "quotaLastUpdated",
-        "quotaAgeMs",
-        "coolingUntil",
-        "sessionUsed",
-        "sessionResetAt",
-        "sessionResetBucket",
-        "weeklyUsed",
-        "weeklyResetAt",
-    ];
-    const requiredNullableStringFields = [
-        "unifiedStatus",
-        "overageStatus",
-        "sessionStatus",
-        "weeklyStatus",
-    ];
-    const optionalNullableStringFields = [
-        "fallbackStatus",
-        "upgradePaths",
-        "scopedModel",
-        "scopedStatus",
-    ];
-    const optionalNullableNumberFields = ["scopedUsed", "scopedResetAt"];
-    if (!stringValue(candidate.account) ||
-        typeof candidate.accountType !== "string" ||
-        !ROUTING_ACCOUNT_TYPES.has(candidate.accountType) ||
-        !Number.isInteger(candidate.sourceIndex) ||
-        candidate.sourceIndex < 0 ||
-        !Number.isInteger(candidate.rank) ||
-        candidate.rank < 0 ||
-        requiredBooleanFields.some((field) => typeof candidate[field] !== "boolean") ||
-        requiredNullableNumberFields.some((field) => !isNullableFiniteNumber(candidate[field])) ||
-        requiredNullableStringFields.some((field) => !isNullableString(candidate[field])) ||
-        optionalNullableStringFields.some((field) => field in candidate &&
-            candidate[field] !== undefined &&
-            !isNullableString(candidate[field])) ||
-        ("quotaStale" in candidate &&
-            candidate.quotaStale !== undefined &&
-            typeof candidate.quotaStale !== "boolean") ||
-        ("overageEligible" in candidate &&
-            candidate.overageEligible !== undefined &&
-            typeof candidate.overageEligible !== "boolean") ||
-        ("quotaFreshness" in candidate &&
-            candidate.quotaFreshness !== undefined &&
-            (typeof candidate.quotaFreshness !== "string" ||
-                !QUOTA_FRESHNESS_VALUES.has(candidate.quotaFreshness))) ||
-        ("refreshNeeded" in candidate &&
-            candidate.refreshNeeded !== undefined &&
-            typeof candidate.refreshNeeded !== "boolean") ||
-        ("refreshInFlight" in candidate &&
-            candidate.refreshInFlight !== undefined &&
-            typeof candidate.refreshInFlight !== "boolean") ||
-        ("refreshReason" in candidate &&
-            candidate.refreshReason !== undefined &&
-            candidate.refreshReason !== null &&
-            (typeof candidate.refreshReason !== "string" ||
-                !QUOTA_REFRESH_REASONS.has(candidate.refreshReason))) ||
-        [
-            "lastRefreshAttemptAt",
-            "lastRefreshSuccessAt",
-            "nextRefreshEligibleAt",
-            ...optionalNullableNumberFields,
-        ].some((field) => field in candidate &&
-            candidate[field] !== undefined &&
-            !isNullableFiniteNumber(candidate[field])) ||
-        ("saturationKind" in candidate &&
-            candidate.saturationKind !== undefined &&
-            (typeof candidate.saturationKind !== "string" ||
-                !QUOTA_SATURATION_KINDS.has(candidate.saturationKind))) ||
-        ("softLimitOverrideReason" in candidate &&
-            candidate.softLimitOverrideReason !== undefined &&
-            candidate.softLimitOverrideReason !== null &&
-            candidate.softLimitOverrideReason !== "overage" &&
-            candidate.softLimitOverrideReason !== "weekly_expiry") ||
-        !(candidate.coolingReason === null ||
-            (typeof candidate.coolingReason === "string" &&
-                COOLING_REASONS.has(candidate.coolingReason)))) {
-        return null;
-    }
-    return {
-        account: candidate.account,
-        accountType: candidate.accountType,
-        sourceIndex: candidate.sourceIndex,
-        rank: candidate.rank,
-        configuredPrimary: candidate.configuredPrimary,
-        usable: candidate.usable,
-        saturated: candidate.saturated,
-        quotaObserved: candidate.quotaObserved,
-        quotaStale: candidate.quotaStale === true,
-        quotaFreshness: candidate.quotaFreshness,
-        refreshNeeded: candidate.refreshNeeded,
-        refreshReason: candidate.refreshReason,
-        refreshInFlight: candidate.refreshInFlight,
-        lastRefreshAttemptAt: candidate.lastRefreshAttemptAt,
-        lastRefreshSuccessAt: candidate.lastRefreshSuccessAt,
-        nextRefreshEligibleAt: candidate.nextRefreshEligibleAt,
-        saturationKind: candidate.saturationKind,
-        softLimitOverrideReason: candidate.softLimitOverrideReason,
-        quotaLastUpdated: candidate.quotaLastUpdated,
-        quotaAgeMs: candidate.quotaAgeMs,
-        coolingActive: candidate.coolingActive,
-        coolingReason: candidate.coolingReason,
-        coolingUntil: candidate.coolingUntil,
-        unifiedStatus: candidate.unifiedStatus,
-        fallbackStatus: candidate.fallbackStatus,
-        upgradePaths: candidate.upgradePaths,
-        overageEligible: candidate.overageEligible,
-        overageStatus: candidate.overageStatus,
-        sessionStatus: candidate.sessionStatus,
-        sessionUsed: candidate.sessionUsed,
-        sessionResetAt: candidate.sessionResetAt,
-        sessionResetBucket: candidate.sessionResetBucket,
-        weeklyStatus: candidate.weeklyStatus,
-        weeklyUsed: candidate.weeklyUsed,
-        weeklyResetAt: candidate.weeklyResetAt,
-        scopedModel: candidate.scopedModel,
-        scopedStatus: candidate.scopedStatus,
-        scopedUsed: candidate.scopedUsed,
-        scopedResetAt: candidate.scopedResetAt,
-    };
-}
-function routingDecisionValue(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        return null;
-    }
-    const decision = value;
-    const candidates = Array.isArray(decision.candidates)
-        ? decision.candidates.map(routingCandidateValue)
-        : [];
-    if (decision.schemaVersion !== 1 ||
-        !stringValue(decision.evaluatedAt) ||
-        !Number.isFinite(Date.parse(String(decision.evaluatedAt))) ||
-        typeof decision.strategy !== "string" ||
-        !ROUTING_STRATEGIES.has(decision.strategy) ||
-        typeof decision.mode !== "string" ||
-        !ROUTING_MODES.has(decision.mode) ||
-        typeof decision.selectionReason !== "string" ||
-        !ROUTING_REASONS.has(decision.selectionReason) ||
-        typeof decision.quotaRoutingEnabled !== "boolean" ||
-        typeof decision.quotaInputsUsed !== "boolean" ||
-        finiteNumber(decision.sessionSoftLimit) === null ||
-        decision.sessionSoftLimit <= 0 ||
-        decision.sessionSoftLimit > 1 ||
-        !Number.isInteger(decision.sessionResetToleranceMs) ||
-        decision.sessionResetToleranceMs <= 0 ||
-        !isNullableString(decision.configuredPrimaryAccount) ||
-        typeof decision.configuredPrimaryMatched !== "boolean" ||
-        !Number.isInteger(decision.rotationOffset) ||
-        decision.rotationOffset < 0 ||
-        !stringValue(decision.initialAccount) ||
-        candidates.length === 0 ||
-        candidates.some((candidate) => candidate === null)) {
-        return null;
-    }
-    return {
-        schemaVersion: 1,
-        evaluatedAt: decision.evaluatedAt,
-        strategy: decision.strategy,
-        mode: decision.mode,
-        selectionReason: decision.selectionReason,
-        quotaRoutingEnabled: decision.quotaRoutingEnabled,
-        quotaInputsUsed: decision.quotaInputsUsed,
-        sessionSoftLimit: decision.sessionSoftLimit,
-        sessionResetToleranceMs: decision.sessionResetToleranceMs,
-        configuredPrimaryAccount: decision.configuredPrimaryAccount,
-        configuredPrimaryMatched: decision.configuredPrimaryMatched,
-        rotationOffset: decision.rotationOffset,
-        initialAccount: decision.initialAccount,
-        candidates: candidates,
-    };
-}
-function percentile(sorted, fraction) {
-    if (sorted.length === 0) {
-        return null;
-    }
-    const index = Math.max(0, Math.ceil(sorted.length * fraction) - 1);
-    return Number(sorted[index].toFixed(3));
-}
-function summarizeLatency(values) {
-    const sorted = values.filter(Number.isFinite).sort((a, b) => a - b);
-    return {
-        count: sorted.length,
-        p50: percentile(sorted, 0.5),
-        p95: percentile(sorted, 0.95),
-        p99: percentile(sorted, 0.99),
-        max: sorted.length ? Number(sorted[sorted.length - 1].toFixed(3)) : null,
-    };
-}
-function parseSince(value, nowMs) {
-    const relative = /^(\d+(?:\.\d+)?)(m|h|d|w)$/i.exec(value.trim());
-    if (relative) {
-        const amount = Number(relative[1]);
-        const unitMs = {
-            m: 60_000,
-            h: 3_600_000,
-            d: 86_400_000,
-            w: 604_800_000,
-        };
-        return nowMs - amount * unitMs[relative[2].toLowerCase()];
-    }
-    const parsed = Date.parse(value);
-    if (!Number.isFinite(parsed)) {
-        throw new Error(`Invalid --since value "${value}". Use an ISO timestamp or a duration such as 6h, 1d, or 1w.`);
-    }
-    return parsed;
-}
-function parseUntil(value, nowMs) {
-    let parsed;
-    try {
-        parsed = parseSince(value, nowMs);
-    }
-    catch {
-        throw new Error(`Invalid --until value "${value}". Use an ISO timestamp or a duration such as 6h, 1d, or 1w.`);
-    }
-    if (parsed > nowMs) {
-        throw new Error(`Invalid --until value "${value}". It must not be later than the analysis start time.`);
-    }
-    return parsed;
-}
-async function readJsonLines(filePath, onRecord, onMalformed) {
-    let linesRead = 0;
-    const lines = createInterface({
-        input: createReadStream(filePath, { encoding: "utf8" }),
-        crlfDelay: Infinity,
-    });
-    for await (const line of lines) {
-        if (!line.trim()) {
-            continue;
-        }
-        linesRead += 1;
-        try {
-            const parsed = JSON.parse(line);
-            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-                onMalformed();
-                continue;
-            }
-            onRecord(parsed);
-        }
-        catch {
-            onMalformed();
-        }
-    }
-    return linesRead;
-}
-function accountEntry(accounts, account, accountType) {
-    const key = `${accountType}:${account}`;
-    const existing = accounts.get(key);
-    if (existing) {
-        return existing;
-    }
-    const created = {
-        account,
-        accountType,
-        attempts: 0,
-        attemptErrors: 0,
-        finalRequests: 0,
-        finalErrors: 0,
-        transientRateLimits: 0,
-        quotaRateLimits: 0,
-        unclassifiedRateLimits: 0,
-    };
-    accounts.set(key, created);
-    return created;
-}
-function summarizeFinalRequests(finalRequests, terminalStreamErrors, attemptsByRequest, accounts) {
-    let success = 0;
-    let errors = 0;
-    let finalRateLimits = 0;
-    let recoveredAfterRetry = 0;
-    let requestsWithUsage = 0;
-    let requestsWithCacheRead = 0;
-    let cacheReadTokens = 0;
-    let cacheCreationTokens = 0;
-    let inputTokens = 0;
-    const finalRequestLatency = [];
-    const singleAttemptDelta = [];
-    const errorTypes = {};
-    const errorCodes = {};
-    for (const [requestId, request] of finalRequests) {
-        const failed = request.status >= 400 || terminalStreamErrors.has(requestId);
-        if (failed) {
-            errors += 1;
-        }
-        else {
-            success += 1;
-        }
-        finalRateLimits += request.status === 429 ? 1 : 0;
-        const accountStats = accountEntry(accounts, request.account, request.accountType);
-        accountStats.finalRequests += 1;
-        accountStats.finalErrors += failed ? 1 : 0;
-        if (failed) {
-            increment(errorTypes, terminalStreamErrors.has(requestId)
-                ? "stream_error"
-                : (request.errorType ?? `http_${request.status}`));
-            if (request.errorCode) {
-                increment(errorCodes, request.errorCode);
-            }
-        }
-        if (request.durationMs !== null && request.durationMs >= 0) {
-            finalRequestLatency.push(request.durationMs);
-        }
-        const requestAttempts = attemptsByRequest.get(requestId);
-        recoveredAfterRetry += !failed && requestAttempts?.hadError ? 1 : 0;
-        if (requestAttempts?.count === 1 &&
-            requestAttempts.durationCount === 1 &&
-            request.durationMs !== null &&
-            Number.isFinite(requestAttempts.totalDurationMs)) {
-            singleAttemptDelta.push(request.durationMs - requestAttempts.totalDurationMs);
-        }
-        if (request.inputTokens !== null ||
-            request.cacheReadTokens !== null ||
-            request.cacheCreationTokens !== null) {
-            requestsWithUsage += 1;
-            inputTokens += request.inputTokens ?? 0;
-            cacheReadTokens += request.cacheReadTokens ?? 0;
-            cacheCreationTokens += request.cacheCreationTokens ?? 0;
-            requestsWithCacheRead += (request.cacheReadTokens ?? 0) > 0 ? 1 : 0;
-        }
-    }
-    return {
-        requestTotals: {
-            completed: finalRequests.size,
-            success,
-            errors,
-            finalRateLimits,
-            recoveredAfterRetry,
-            errorTypes,
-            errorCodes,
-        },
-        cache: {
-            requestsWithUsage,
-            requestsWithCacheRead,
-            cacheReadTokens,
-            cacheCreationTokens,
-            inputTokens,
-            requestHitRate: requestsWithUsage > 0
-                ? Number((requestsWithCacheRead / requestsWithUsage).toFixed(4))
-                : null,
-        },
-        finalRequestLatency,
-        singleAttemptDelta,
-    };
-}
-function summarizeRouting(finalRequests) {
-    const modes = {};
-    const selectionReasons = {};
-    const initialAccounts = {};
-    const retainedRecords = [];
-    let totalRecords = 0;
-    let finalAccountChanges = 0;
-    let finalOutsideCandidateSet = 0;
-    for (const [requestId, request] of finalRequests) {
-        const decision = request.routingDecision;
-        if (!decision) {
-            continue;
-        }
-        increment(modes, decision.mode);
-        increment(selectionReasons, decision.selectionReason);
-        increment(initialAccounts, decision.initialAccount);
-        const finalCandidate = decision.candidates.some((candidate) => candidate.account === request.account &&
-            candidate.accountType === request.accountType);
-        if (!finalCandidate) {
-            finalOutsideCandidateSet += 1;
-        }
-        else if (decision.initialAccount !== request.account) {
-            finalAccountChanges += 1;
-        }
-        totalRecords += 1;
-        retainedRecords.push({
-            record: {
-                requestId,
-                timestamp: request.timestamp,
-                responseStatus: request.status,
-                finalAccount: request.account,
-                finalAccountType: request.accountType,
-                decision,
-            },
-            timestampMs: Date.parse(request.timestamp),
-            sequence: totalRecords,
-        });
-        if (retainedRecords.length > MAX_ROUTING_RECORDS_BEFORE_COMPACTION) {
-            retainedRecords.sort((left, right) => left.timestampMs - right.timestampMs ||
-                left.sequence - right.sequence);
-            retainedRecords.splice(0, retainedRecords.length - MAX_RETAINED_ROUTING_RECORDS);
-        }
-    }
-    retainedRecords.sort((left, right) => left.timestampMs - right.timestampMs || left.sequence - right.sequence);
-    const records = retainedRecords
-        .slice(-MAX_RETAINED_ROUTING_RECORDS)
-        .map(({ record }) => record);
-    return {
-        modes,
-        selectionReasons,
-        initialAccounts,
-        finalAccountChanges,
-        finalOutsideCandidateSet,
-        totalRecords,
-        records,
-    };
-}
-async function discoverLogFiles(logsDir) {
-    const entries = await readdir(logsDir, { withFileTypes: true }).catch((error) => {
-        throw new Error(`Unable to read proxy logs at ${logsDir}: ${error.message}`);
-    });
-    const matching = (pattern) => entries
-        .filter((entry) => entry.isFile() && pattern.test(entry.name))
-        .map((entry) => join(logsDir, entry.name))
-        .sort();
-    return {
-        lifecycleFiles: matching(LIFECYCLE_FILE_PATTERN),
-        requestFiles: matching(REQUEST_FILE_PATTERN),
-        attemptFiles: matching(ATTEMPT_FILE_PATTERN),
-        debugFiles: matching(DEBUG_FILE_PATTERN),
-    };
-}
-/** Analyze local proxy logs without reading request or response body artifacts. */
-export async function analyzeProxyLogs(options) {
-    const nowMs = options?.nowMs ?? Date.now();
-    const sinceMs = parseSince(options?.since ?? "24h", nowMs);
-    const untilMs = options?.until ? parseUntil(options.until, nowMs) : nowMs;
-    if (untilMs < sinceMs) {
-        throw new Error(`Invalid analysis window: --until must not be earlier than --since.`);
-    }
-    const logsDir = resolve(options?.logsDir ?? join(homedir(), ".neurolink", "logs"));
-    const { lifecycleFiles, requestFiles, attemptFiles, debugFiles } = await discoverLogFiles(logsDir);
-    const observedRanges = {
-        lifecycle: { from: null, to: null },
-        requests: { from: null, to: null },
-        attempts: { from: null, to: null },
-        debug: { from: null, to: null },
-    };
-    const observeTimestamp = (stream, record) => {
-        const timestamp = Date.parse(String(record.timestamp ?? ""));
-        if (!Number.isFinite(timestamp)) {
-            return null;
-        }
-        const range = observedRanges[stream];
-        range.from =
-            range.from === null ? timestamp : Math.min(range.from, timestamp);
-        range.to = range.to === null ? timestamp : Math.max(range.to, timestamp);
-        return timestamp;
-    };
-    let linesRead = 0;
-    let malformedLines = 0;
-    let unsupportedLifecycleLines = 0;
-    const accepted = new Set();
-    const headers = new Set();
-    const firstChunks = new Set();
-    const terminal = new Set();
-    const terminalOutcomes = {};
-    const lifecycleErrorTypes = {};
-    const lifecycleErrorCodes = {};
-    const headersLatency = [];
-    const firstChunkLatency = [];
-    const terminalLatency = [];
-    const sequences = new Map();
-    for (const filePath of lifecycleFiles) {
-        linesRead += await readJsonLines(filePath, (record) => {
-            const timestamp = observeTimestamp("lifecycle", record);
-            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
-                return;
-            }
-            const event = stringValue(record.event);
-            const requestId = stringValue(record.requestId);
-            if (record.schemaVersion !== 1 ||
-                !event ||
-                !LIFECYCLE_EVENTS.has(event) ||
-                !requestId) {
-                unsupportedLifecycleLines += 1;
-                return;
-            }
-            const processId = stringValue(record.processInstanceId);
-            const sequence = finiteNumber(record.sequence);
-            if (processId && sequence !== null && Number.isInteger(sequence)) {
-                const values = sequences.get(processId) ?? [];
-                values.push(sequence);
-                sequences.set(processId, values);
-            }
-            const elapsed = finiteNumber(record.elapsedMs);
-            if (event === "request_accepted") {
-                accepted.add(requestId);
-            }
-            else if (event === "response_headers") {
-                headers.add(requestId);
-                if (elapsed !== null && elapsed >= 0) {
-                    headersLatency.push(elapsed);
-                }
-            }
-            else if (event === "response_first_chunk") {
-                firstChunks.add(requestId);
-                if (elapsed !== null && elapsed >= 0) {
-                    firstChunkLatency.push(elapsed);
-                }
-            }
-            else {
-                terminal.add(requestId);
-                if (elapsed !== null && elapsed >= 0) {
-                    terminalLatency.push(elapsed);
-                }
-                increment(terminalOutcomes, stringValue(record.terminalOutcome) ?? "unknown");
-                const errorType = stringValue(record.errorType);
-                const errorCode = stringValue(record.errorCode);
-                if (errorType) {
-                    increment(lifecycleErrorTypes, errorType);
-                }
-                if (errorCode) {
-                    increment(lifecycleErrorCodes, errorCode);
-                }
-            }
-        }, () => {
-            malformedLines += 1;
-        });
-    }
-    let lifecycleSequenceGaps = 0;
-    let lifecycleSequenceDuplicates = 0;
-    for (const values of sequences.values()) {
-        values.sort((a, b) => a - b);
-        for (let index = 1; index < values.length; index += 1) {
-            const difference = values[index] - values[index - 1];
-            if (difference === 0) {
-                lifecycleSequenceDuplicates += 1;
-            }
-            else if (difference > 1) {
-                lifecycleSequenceGaps += difference - 1;
-            }
-        }
-    }
-    const accounts = new Map();
-    const attemptsByRequest = new Map();
-    const attemptLatency = [];
-    let totalAttempts = 0;
-    let totalAttemptErrors = 0;
-    const attemptErrorTypes = {};
-    const attemptErrorCodes = {};
-    const attemptTransportScopes = {};
-    let attemptRateLimits = 0;
-    let transientRateLimits = 0;
-    let quotaRateLimits = 0;
-    let unclassifiedRateLimits = 0;
-    for (const filePath of attemptFiles) {
-        linesRead += await readJsonLines(filePath, (record) => {
-            const timestamp = observeTimestamp("attempts", record);
-            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
-                return;
-            }
-            const requestId = stringValue(record.requestId);
-            const status = finiteNumber(record.responseStatus);
-            const duration = finiteNumber(record.attemptDurationMs);
-            if (!requestId || status === null) {
-                return;
-            }
-            const account = stringValue(record.account) ?? "unknown";
-            const accountType = stringValue(record.accountType) ?? "unknown";
-            const accountStats = accountEntry(accounts, account, accountType);
-            totalAttempts += 1;
-            accountStats.attempts += 1;
-            const hadError = status >= 400 || !!stringValue(record.errorType);
-            if (hadError) {
-                totalAttemptErrors += 1;
-                accountStats.attemptErrors += 1;
-                increment(attemptErrorTypes, stringValue(record.errorType) ?? `http_${status}`);
-                const errorCode = stringValue(record.errorCode);
-                if (errorCode) {
-                    increment(attemptErrorCodes, errorCode);
-                }
-            }
-            const transportScope = stringValue(record.transportScope);
-            if (transportScope) {
-                increment(attemptTransportScopes, transportScope);
-            }
-            const requestAttempts = attemptsByRequest.get(requestId) ?? {
-                count: 0,
-                hadError: false,
-                totalDurationMs: 0,
-                durationCount: 0,
-            };
-            requestAttempts.count += 1;
-            requestAttempts.hadError = requestAttempts.hadError || hadError;
-            if (duration !== null && duration >= 0) {
-                requestAttempts.totalDurationMs += duration;
-                requestAttempts.durationCount += 1;
-                attemptLatency.push(duration);
-            }
-            attemptsByRequest.set(requestId, requestAttempts);
-            if (status === 429) {
-                attemptRateLimits += 1;
-                if (record.rateLimitKind === "transient") {
-                    transientRateLimits += 1;
-                    accountStats.transientRateLimits += 1;
-                }
-                else if (record.rateLimitKind === "quota") {
-                    quotaRateLimits += 1;
-                    accountStats.quotaRateLimits += 1;
-                }
-                else {
-                    unclassifiedRateLimits += 1;
-                    accountStats.unclassifiedRateLimits += 1;
-                }
-            }
-        }, () => {
-            malformedLines += 1;
-        });
-    }
-    const finalRequests = new Map();
-    const terminalStreamErrors = new Set();
-    let validRoutingDecisions = 0;
-    let invalidRoutingDecisions = 0;
-    let absentRoutingDecisions = 0;
-    for (const filePath of requestFiles) {
-        linesRead += await readJsonLines(filePath, (record) => {
-            const timestamp = observeTimestamp("requests", record);
-            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
-                return;
-            }
-            const requestId = stringValue(record.requestId);
-            if (!requestId) {
-                return;
-            }
-            if (finiteNumber(record.terminalStatus) !== null) {
-                terminalStreamErrors.add(requestId);
-                return;
-            }
-            const status = finiteNumber(record.responseStatus);
-            if (status === null || !stringValue(record.method)) {
-                return;
-            }
-            const hasRoutingDecision = Object.prototype.hasOwnProperty.call(record, "routingDecision");
-            const routingDecision = hasRoutingDecision
-                ? routingDecisionValue(record.routingDecision)
-                : null;
-            if (routingDecision) {
-                validRoutingDecisions += 1;
-            }
-            else if (hasRoutingDecision) {
-                invalidRoutingDecisions += 1;
-            }
-            else {
-                absentRoutingDecisions += 1;
-            }
-            finalRequests.set(requestId, {
-                timestamp: new Date(timestamp).toISOString(),
-                status,
-                durationMs: finiteNumber(record.responseTimeMs),
-                account: stringValue(record.account) ?? "unknown",
-                accountType: stringValue(record.accountType) ?? "unknown",
-                inputTokens: finiteNumber(record.inputTokens),
-                cacheReadTokens: finiteNumber(record.cacheReadTokens),
-                cacheCreationTokens: finiteNumber(record.cacheCreationTokens),
-                errorType: stringValue(record.errorType),
-                errorCode: stringValue(record.errorCode),
-                routingDecision,
-            });
-        }, () => {
-            malformedLines += 1;
-        });
-    }
-    let capturesIndexed = 0;
-    let truncatedCaptures = 0;
-    let writeFailures = 0;
-    let invalidPaths = 0;
-    const referencedArtifacts = new Set();
-    const bodiesRoot = resolve(logsDir, "bodies");
-    for (const filePath of debugFiles) {
-        linesRead += await readJsonLines(filePath, (record) => {
-            const timestamp = observeTimestamp("debug", record);
-            if (timestamp === null || timestamp < sinceMs || timestamp > untilMs) {
-                return;
-            }
-            if (record.type !== "body_capture") {
-                return;
-            }
-            capturesIndexed += 1;
-            truncatedCaptures += record.bodyTruncated === true ? 1 : 0;
-            writeFailures += record.bodyWriteFailed === true ? 1 : 0;
-            const bodyPath = stringValue(record.bodyPath);
-            if (!bodyPath) {
-                return;
-            }
-            if (bodyPath.includes("\0") || bodyPath.split(/[\\/]/).includes("..")) {
-                invalidPaths += 1;
-                return;
-            }
-            const resolvedBodyPath = resolve(logsDir, bodyPath);
-            if (!isContainedPath(bodiesRoot, resolvedBodyPath)) {
-                invalidPaths += 1;
-                return;
-            }
-            referencedArtifacts.add(resolvedBodyPath);
-        }, () => {
-            malformedLines += 1;
-        });
-    }
-    const artifactPaths = [...referencedArtifacts];
-    let canonicalBodiesRoot = null;
-    let bodiesRootUnsafe = false;
-    try {
-        const bodiesRootStat = await lstat(bodiesRoot);
-        if (bodiesRootStat.isDirectory() && !bodiesRootStat.isSymbolicLink()) {
-            canonicalBodiesRoot = await realpath(bodiesRoot);
-        }
-        else {
-            bodiesRootUnsafe = true;
-        }
-    }
-    catch {
-        // A missing body directory means every lexically valid reference is absent.
-    }
-    let artifactsPresent = 0;
-    let artifactsMissing = 0;
-    for (let offset = 0; offset < artifactPaths.length; offset += ARTIFACT_STAT_CONCURRENCY) {
-        const presence = await Promise.all(artifactPaths
-            .slice(offset, offset + ARTIFACT_STAT_CONCURRENCY)
-            .map((artifactPath) => bodiesRootUnsafe
-            ? Promise.resolve("invalid")
-            : inspectBodyArtifact(artifactPath, canonicalBodiesRoot)));
-        artifactsPresent += presence.filter((value) => value === "present").length;
-        artifactsMissing += presence.filter((value) => value === "missing").length;
-        invalidPaths += presence.filter((value) => value === "invalid").length;
-    }
-    const artifactsReferenced = artifactsPresent + artifactsMissing;
-    const finalSummary = summarizeFinalRequests(finalRequests, terminalStreamErrors, attemptsByRequest, accounts);
-    const routingSummary = summarizeRouting(finalRequests);
-    const streamComplete = (stream) => {
-        const range = observedRanges[stream];
-        return range.from !== null && range.from <= sinceMs;
-    };
-    return {
-        generatedAt: new Date(nowMs).toISOString(),
-        since: new Date(sinceMs).toISOString(),
-        until: new Date(untilMs).toISOString(),
-        logsDir,
-        files: {
-            lifecycle: lifecycleFiles.length,
-            requests: requestFiles.length,
-            attempts: attemptFiles.length,
-            debug: debugFiles.length,
-        },
-        coverage: {
-            lifecycle: accepted.size + headers.size + firstChunks.size + terminal.size > 0,
-            finalRequests: finalRequests.size > 0 || terminalStreamErrors.size > 0,
-            attempts: totalAttempts > 0,
-            attemptLatency: attemptLatency.length > 0,
-            cacheUsage: finalSummary.cache.requestsWithUsage > 0,
-            routingDecisions: routingSummary.totalRecords > 0,
-            comparableRequestAttempts: streamComplete("requests") && streamComplete("attempts"),
-        },
-        dataQuality: {
-            linesRead,
-            malformedLines,
-            unsupportedLifecycleLines,
-            lifecycleSequenceGaps,
-            lifecycleSequenceDuplicates,
-            streams: Object.fromEntries(Object.entries(observedRanges).map(([stream, range]) => [
-                stream,
-                {
-                    observedFrom: range.from === null ? null : new Date(range.from).toISOString(),
-                    observedTo: range.to === null ? null : new Date(range.to).toISOString(),
-                    startsAtOrBeforeRequestedWindow: range.from !== null && range.from <= sinceMs,
-                    completeWindow: range.from !== null && range.from <= sinceMs,
-                },
-            ])),
-            bodyArtifacts: {
-                capturesIndexed,
-                artifactsReferenced,
-                artifactsPresent,
-                artifactsMissing,
-                invalidPaths,
-                writeFailures,
-                truncatedCaptures,
-            },
-            routingDecisions: {
-                valid: validRoutingDecisions,
-                invalid: invalidRoutingDecisions,
-                absent: absentRoutingDecisions,
-            },
-        },
-        lifecycle: {
-            accepted: accepted.size,
-            headers: headers.size,
-            firstChunks: firstChunks.size,
-            terminal: terminal.size,
-            unsettled: [...accepted].filter((requestId) => !terminal.has(requestId))
-                .length,
-            terminalOutcomes,
-            errorTypes: lifecycleErrorTypes,
-            errorCodes: lifecycleErrorCodes,
-        },
-        requests: finalSummary.requestTotals,
-        attempts: {
-            total: totalAttempts,
-            errors: totalAttemptErrors,
-            errorTypes: attemptErrorTypes,
-            errorCodes: attemptErrorCodes,
-            transportScopes: attemptTransportScopes,
-        },
-        rateLimits: {
-            attemptRateLimits,
-            transient: transientRateLimits,
-            quota: quotaRateLimits,
-            unclassified: unclassifiedRateLimits,
-        },
-        latencyMs: {
-            headers: summarizeLatency(headersLatency),
-            firstChunk: summarizeLatency(firstChunkLatency),
-            terminal: summarizeLatency(terminalLatency),
-            finalRequest: summarizeLatency(finalSummary.finalRequestLatency),
-            attempt: summarizeLatency(attemptLatency),
-            singleAttemptDelta: summarizeLatency(finalSummary.singleAttemptDelta),
-        },
-        cache: finalSummary.cache,
-        routing: routingSummary,
-        accounts: [...accounts.values()].sort((left, right) => right.attempts - left.attempts),
-    };
-}
-//# sourceMappingURL=proxyAnalysis.js.map