@lovrozagar/oat 0.7.4 → 0.7.6

package/dist/runtime/exchanges.js

@@ -0,0 +1,298 @@
+/**
+ * Persist every HTTP exchange under the run dir so a green run is still inspectable.
+ *
+ * Layout (next to `progress.tsv`):
+ *   exchanges.jsonl              one line per Exchange.seq, join key = requestId = TSV req_id
+ *   exchanges/<requestId>.json   full exchange (headers + described / spilled bodies)
+ *   blobs/<sha256>               content-addressed bytes (multipart, binary, oversized text)
+ *
+ * Redaction is on by default. This is oat's journal, not a HAR file.
+ */
+import { createHash } from "node:crypto";
+import { existsSync } from "node:fs";
+import { appendFile, mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { describeRequestBody } from "./client.js";
+import { sseEvents } from "./sse.js";
+export const INLINE_BODY_LIMIT = 256 * 1024;
+const REDACTED = "<redacted>";
+const REDACT_HEADER_NAMES = new Set(["authorization", "cookie", "set-cookie", "proxy-authorization", "x-ia-tester-key"]);
+const REDACT_JSON_KEYS = new Set([
+    "access_token",
+    "refresh_token",
+    "id_token",
+    "password",
+    "token",
+    "secret",
+    "api_key",
+]);
+export function resolveSaveExchanges(options) {
+    if (options.flag !== undefined)
+        return options.flag;
+    if (options.config !== undefined)
+        return options.config;
+    return options.profile !== "cheap";
+}
+export function isSecretHeaderName(name) {
+    const lower = name.toLowerCase();
+    if (REDACT_HEADER_NAMES.has(lower))
+        return true;
+    return /^x-.+-(key|secret)$/i.test(lower);
+}
+export function redactHeaders(headers) {
+    const out = {};
+    for (const [key, value] of Object.entries(headers)) {
+        out[key] = isSecretHeaderName(key) ? REDACTED : value;
+    }
+    return out;
+}
+export function redactJson(value) {
+    if (Array.isArray(value))
+        return value.map((item) => redactJson(item));
+    if (value === null || typeof value !== "object")
+        return value;
+    const out = {};
+    for (const [key, child] of Object.entries(value)) {
+        out[key] = REDACT_JSON_KEYS.has(key.toLowerCase()) ? REDACTED : redactJson(child);
+    }
+    return out;
+}
+export function sanitizeExchangeId(requestId) {
+    const cleaned = requestId
+        .trim()
+        .replace(/[^A-Za-z0-9._-]+/g, "_")
+        .replace(/^_+|_+$/g, "");
+    return cleaned === "" ? "id" : cleaned.slice(0, 180);
+}
+export function exchangeFileStem(requestId, seq, taken) {
+    const trimmed = requestId.trim();
+    const base = trimmed === "" ? `seq-${seq}` : sanitizeExchangeId(trimmed);
+    if (!taken.has(base))
+        return base;
+    const dup = `${base}-${seq}`;
+    if (!taken.has(dup))
+        return dup;
+    let n = 2;
+    while (taken.has(`${dup}-${n}`))
+        n += 1;
+    return `${dup}-${n}`;
+}
+export function primaryMediaType(mediaType, fallback) {
+    const named = mediaType
+        .split(";")
+        .map((part) => part.trim())
+        .find((part) => part.includes("/"));
+    return named === undefined || named === "" ? fallback : named;
+}
+export function isBinaryMediaType(mediaType) {
+    const type = primaryMediaType(mediaType, "").toLowerCase();
+    if (type.startsWith("image/") || type.startsWith("audio/") || type.startsWith("video/"))
+        return true;
+    if (type === "application/octet-stream" || type === "application/pdf" || type === "application/zip")
+        return true;
+    if (type === "application/vnd.ms-excel")
+        return true;
+    if (type.includes("spreadsheet") || type.includes("officedocument") || type.includes("opendocument"))
+        return true;
+    return false;
+}
+function sha256Hex(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+function utf8Bytes(text) {
+    return new TextEncoder().encode(text);
+}
+function headerOf(headers, name) {
+    const want = name.toLowerCase();
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === want && value.trim() !== "")
+            return value;
+    }
+    return undefined;
+}
+async function bytesOf(value) {
+    if (value instanceof Uint8Array)
+        return value;
+    if (typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer)
+        return new Uint8Array(value);
+    if (ArrayBuffer.isView(value))
+        return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+    if (typeof Blob !== "undefined" && value instanceof Blob)
+        return new Uint8Array(await value.arrayBuffer());
+    return undefined;
+}
+function isFormData(body) {
+    return typeof FormData !== "undefined" && body instanceof FormData;
+}
+function isURLSearchParams(body) {
+    return typeof URLSearchParams !== "undefined" && body instanceof URLSearchParams;
+}
+export function createExchangeJournal(dir) {
+    const taken = new Set();
+    const writtenBlobs = new Set();
+    let count = 0;
+    let ready;
+    const ensure = async () => {
+        if (ready === undefined) {
+            ready = Promise.all([
+                mkdir(join(dir, "exchanges"), { recursive: true }),
+                mkdir(join(dir, "blobs"), { recursive: true }),
+            ]).then(() => undefined);
+        }
+        await ready;
+    };
+    const putBlob = async (bytes) => {
+        const sha256 = sha256Hex(bytes);
+        if (!writtenBlobs.has(sha256)) {
+            const path = join(dir, "blobs", sha256);
+            if (!existsSync(path))
+                await writeFile(path, bytes);
+            writtenBlobs.add(sha256);
+        }
+        return { bytes: bytes.byteLength, sha256 };
+    };
+    const spillText = async (text, mediaType) => {
+        const bytes = utf8Bytes(text);
+        if (bytes.byteLength <= INLINE_BODY_LIMIT)
+            return text;
+        const blob = await putBlob(bytes);
+        return { ...blob, mediaType };
+    };
+    const persistJson = async (value, mediaType) => {
+        const redacted = redactJson(value);
+        const text = JSON.stringify(redacted);
+        if (utf8Bytes(text).byteLength <= INLINE_BODY_LIMIT)
+            return redacted;
+        const blob = await putBlob(utf8Bytes(text));
+        return { ...blob, mediaType };
+    };
+    const persistRequestBody = async (body) => {
+        if (body === undefined)
+            return undefined;
+        if (isFormData(body)) {
+            const parts = [];
+            for (const [field, value] of body.entries()) {
+                if (typeof value === "string") {
+                    parts.push({
+                        field,
+                        value: REDACT_JSON_KEYS.has(field.toLowerCase()) ? REDACTED : value,
+                    });
+                    continue;
+                }
+                const bytes = new Uint8Array(await value.arrayBuffer());
+                const blob = await putBlob(bytes);
+                parts.push({
+                    bytes: blob.bytes,
+                    field,
+                    filename: value.name,
+                    mediaType: value.type || "application/octet-stream",
+                    sha256: blob.sha256,
+                });
+            }
+            return { parts };
+        }
+        if (isURLSearchParams(body))
+            return redactJson(Object.fromEntries(body.entries()));
+        const raw = await bytesOf(body);
+        if (raw !== undefined) {
+            const blob = await putBlob(raw);
+            return { ...blob, mediaType: "application/octet-stream" };
+        }
+        if (typeof body === "string")
+            return spillText(body, "text/plain");
+        if (body !== null && typeof body === "object")
+            return persistJson(body, "application/json");
+        return describeRequestBody(body);
+    };
+    const persistResponseBody = async (exchange) => {
+        const mediaType = headerOf(exchange.responseHeaders, "content-type") ?? "";
+        const body = exchange.responseBody;
+        if (mediaType.toLowerCase().includes("text/event-stream") && typeof body === "string") {
+            const frames = sseEvents(body);
+            if (frames !== null) {
+                return frames.map((frame) => ({ data: redactJson(frame.data), event: frame.event }));
+            }
+            return spillText(body, primaryMediaType(mediaType, "text/event-stream"));
+        }
+        if (isBinaryMediaType(mediaType)) {
+            const bytes = typeof body === "string" ? utf8Bytes(body) : ((await bytesOf(body)) ?? utf8Bytes(JSON.stringify(body)));
+            const blob = await putBlob(bytes);
+            return { ...blob, mediaType: primaryMediaType(mediaType, "application/octet-stream") };
+        }
+        if (body === undefined)
+            return undefined;
+        if (typeof body === "string") {
+            const asFrames = sseEvents(body);
+            if (asFrames !== null) {
+                return asFrames.map((frame) => ({ data: redactJson(frame.data), event: frame.event }));
+            }
+            return spillText(body, primaryMediaType(mediaType, "text/plain"));
+        }
+        if (body !== null && typeof body === "object") {
+            return persistJson(body, primaryMediaType(mediaType, "application/json"));
+        }
+        return body;
+    };
+    return {
+        get count() {
+            return count;
+        },
+        get dir() {
+            return dir;
+        },
+        async record(exchange, meta = {}) {
+            await ensure();
+            const requestBody = await persistRequestBody(exchange.requestBody);
+            const responseBody = await persistResponseBody(exchange);
+            let stem = exchangeFileStem(exchange.requestId, exchange.seq, taken);
+            const exchangesDir = join(dir, "exchanges");
+            while (existsSync(join(exchangesDir, `${stem}.json`))) {
+                taken.add(stem);
+                stem = exchangeFileStem(exchange.requestId, exchange.seq, taken);
+            }
+            taken.add(stem);
+            const rel = `exchanges/${stem}.json`;
+            const file = {
+                at: exchange.at,
+                durationMs: exchange.durationMs,
+                ...(exchange.fixture === undefined ? {} : { fixture: exchange.fixture }),
+                method: exchange.method,
+                ...(exchange.operationId === undefined ? {} : { operationId: exchange.operationId }),
+                requestBody,
+                requestHeaders: redactHeaders(exchange.requestHeaders),
+                requestId: exchange.requestId,
+                responseBody,
+                responseHeaders: redactHeaders(exchange.responseHeaders),
+                seq: exchange.seq,
+                status: exchange.status,
+                url: exchange.url,
+            };
+            await writeFile(join(dir, rel), `${JSON.stringify(file, null, 2)}\n`);
+            const line = {
+                at: exchange.at,
+                durationMs: exchange.durationMs,
+                file: rel,
+                method: exchange.method,
+                requestBytes: exchange.requestBytes,
+                requestId: exchange.requestId,
+                responseBytes: exchange.responseBytes,
+                seq: exchange.seq,
+                status: exchange.status,
+                url: exchange.url,
+            };
+            if (exchange.operationId !== undefined)
+                line.operationId = exchange.operationId;
+            if (exchange.fixture !== undefined)
+                line.fixture = exchange.fixture;
+            if (meta.check !== undefined)
+                line.check = meta.check;
+            if (meta.entity !== undefined)
+                line.entity = meta.entity;
+            if (meta.phase !== undefined)
+                line.phase = meta.phase;
+            await appendFile(join(dir, "exchanges.jsonl"), `${JSON.stringify(line)}\n`);
+            count += 1;
+        },
+    };
+}
+//# sourceMappingURL=exchanges.js.map

package/dist/runtime/exchanges.js.map

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

package/dist/runtime/network.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Network failures are not backend defects.
+ *
+ * `fetch` throwing is "the request never happened" — DNS, offline, reset, timeout — and must
+ * not look like a 4xx/5xx or an uncaught `TypeError: fetch failed`. Classify, retry the blip,
+ * then wait once for the link. If it does not come back, one finding names the kind and the
+ * rest of the run stands down.
+ */
+import { type NetworkInterfaceInfo } from "node:os";
+export type NetworkKind = "offline" | "dns" | "refused" | "reset" | "timeout" | "unreachable" | "unknown";
+export declare const DEFAULT_NETWORK_RETRIES = 4;
+export declare const DEFAULT_NETWORK_WAIT_MS = 60000;
+export declare const DEFAULT_NETWORK_PROBE_MS = 2000;
+export declare class NetworkError extends Error {
+    readonly code: "NETWORK";
+    readonly kind: NetworkKind;
+    readonly attempts: number;
+    readonly method: string;
+    readonly url: string;
+    constructor(options: {
+        kind: NetworkKind;
+        message: string;
+        attempts: number;
+        method: string;
+        url: string;
+        cause?: unknown;
+    });
+}
+export declare function isNetworkError(error: unknown): error is NetworkError;
+export declare function classifyNetworkError(error: unknown): NetworkKind | null;
+export declare function refineNetworkKind(kind: NetworkKind, read?: () => NodeJS.Dict<NetworkInterfaceInfo[]>): NetworkKind;
+export declare function hasUsableInterface(read?: () => NodeJS.Dict<NetworkInterfaceInfo[]>): boolean;
+export declare function describeNetworkKind(kind: NetworkKind): string;
+export declare function networkRetryWaitMs(attempt: number): number;
+export declare function describeNetworkFailure(error: NetworkError, waitedMs?: number): string;
+export interface NetworkWaitInfo {
+    kind: NetworkKind;
+    elapsedMs: number;
+    remainingMs: number;
+}
+export interface NetworkGate {
+    readonly exhausted: boolean;
+    readonly waitedMs: number;
+    readonly lastKind: NetworkKind | undefined;
+    awaitRecovery(error: NetworkError): Promise<boolean>;
+}
+export declare function createNetworkGate(options: {
+    waitBudgetMs?: number;
+    probeIntervalMs?: number;
+    probe: () => Promise<boolean>;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+    onWait?: (info: NetworkWaitInfo) => void;
+}): NetworkGate;
+export declare function probeOrigin(origin: string, options?: {
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    online?: () => boolean;
+}): Promise<boolean>;
+export interface NetworkFetchOptions {
+    retries?: number;
+    waitMs?: number;
+    requestTimeoutMs?: number;
+    probe?: () => Promise<boolean>;
+    sleep?: (ms: number) => Promise<void>;
+    onWait?: (info: NetworkWaitInfo) => void;
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+}
+/**
+ * `fetch` with the same classify / retry / wait policy Client uses, for spec load (no Exchange).
+ */
+export declare function fetchWithNetworkRetry(url: string, init?: RequestInit, options?: NetworkFetchOptions): Promise<Response>;
+//# sourceMappingURL=network.d.ts.map

package/dist/runtime/network.d.ts.map

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

package/dist/runtime/network.js

@@ -0,0 +1,270 @@
+/**
+ * Network failures are not backend defects.
+ *
+ * `fetch` throwing is "the request never happened" — DNS, offline, reset, timeout — and must
+ * not look like a 4xx/5xx or an uncaught `TypeError: fetch failed`. Classify, retry the blip,
+ * then wait once for the link. If it does not come back, one finding names the kind and the
+ * rest of the run stands down.
+ */
+import { networkInterfaces } from "node:os";
+import { sleep } from "./poll.js";
+export const DEFAULT_NETWORK_RETRIES = 4;
+export const DEFAULT_NETWORK_WAIT_MS = 60_000;
+export const DEFAULT_NETWORK_PROBE_MS = 2_000;
+export class NetworkError extends Error {
+    code = "NETWORK";
+    kind;
+    attempts;
+    method;
+    url;
+    constructor(options) {
+        super(options.message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "NetworkError";
+        this.attempts = options.attempts;
+        this.kind = options.kind;
+        this.method = options.method;
+        this.url = options.url;
+    }
+}
+export function isNetworkError(error) {
+    return error instanceof NetworkError;
+}
+const DNS = new Set(["ENOTFOUND", "EAI_AGAIN", "EAI_FAIL", "EAI_NODATA", "EAI_NONAME"]);
+const REFUSED = new Set(["ECONNREFUSED"]);
+const RESET = new Set(["ECONNRESET", "EPIPE", "UND_ERR_SOCKET", "UND_ERR_DESTROYED"]);
+const TIMEOUT = new Set([
+    "ETIMEDOUT",
+    "UND_ERR_CONNECT_TIMEOUT",
+    "UND_ERR_HEADERS_TIMEOUT",
+    "UND_ERR_BODY_TIMEOUT",
+    "TimeoutError",
+    "AbortError",
+]);
+const UNREACHABLE = new Set(["ENETUNREACH", "ENETDOWN", "EHOSTUNREACH", "EHOSTDOWN"]);
+const OFFLINE = new Set(["ENONET", "ERR_NETWORK_CHANGED", "ERR_INTERNET_DISCONNECTED"]);
+const NOT_NETWORK = /CERT|UNABLE_TO_VERIFY|ERR_TLS|ERR_SSL|ERR_INVALID_URL|ERR_INVALID_ARG/;
+export function classifyNetworkError(error) {
+    const tokens = errorTokens(error);
+    if (tokens.some((token) => NOT_NETWORK.test(token)))
+        return null;
+    const hit = (set) => tokens.some((token) => set.has(token));
+    if (hit(OFFLINE))
+        return "offline";
+    if (hit(UNREACHABLE))
+        return "unreachable";
+    if (hit(DNS))
+        return "dns";
+    if (hit(REFUSED))
+        return "refused";
+    if (hit(RESET))
+        return "reset";
+    if (hit(TIMEOUT))
+        return "timeout";
+    const text = tokens.join(" ");
+    if (/fetch failed|networkerror|failed to fetch|socket hang up|getaddrinfo/i.test(text))
+        return "unknown";
+    return null;
+}
+export function refineNetworkKind(kind, read = networkInterfaces) {
+    if (kind === "offline")
+        return kind;
+    return hasUsableInterface(read) ? kind : "offline";
+}
+export function hasUsableInterface(read = networkInterfaces) {
+    for (const list of Object.values(read())) {
+        for (const info of list ?? []) {
+            if (!info.internal && info.address !== "")
+                return true;
+        }
+    }
+    return false;
+}
+export function describeNetworkKind(kind) {
+    switch (kind) {
+        case "offline":
+            return "this machine has no usable network interface";
+        case "dns":
+            return "DNS could not resolve the host";
+        case "refused":
+            return "the host refused the connection";
+        case "reset":
+            return "the connection was reset";
+        case "timeout":
+            return "the connection timed out";
+        case "unreachable":
+            return "no route to the host";
+        case "unknown":
+            return "the request never reached the server";
+    }
+}
+export function networkRetryWaitMs(attempt) {
+    return Math.min(4_000, 250 * 2 ** Math.max(0, attempt));
+}
+export function describeNetworkFailure(error, waitedMs = 0) {
+    const wait = waitedMs > 0 ? ` and ${Math.round(waitedMs / 1000)}s waiting for the link` : "";
+    return (`${error.method} ${error.url} failed (${error.kind}: ${describeNetworkKind(error.kind)}) ` +
+        `after ${error.attempts} attempt(s)${wait}. This is not a backend status.`);
+}
+function errorTokens(error) {
+    const tokens = [];
+    const seen = new Set();
+    let current = error;
+    while (current !== null && typeof current === "object" && !seen.has(current)) {
+        seen.add(current);
+        const rec = current;
+        if (typeof rec.code === "string" && rec.code !== "")
+            tokens.push(rec.code);
+        if (typeof rec.name === "string" && rec.name !== "")
+            tokens.push(rec.name);
+        if (typeof rec.message === "string" && rec.message !== "")
+            tokens.push(rec.message);
+        current = rec.cause;
+    }
+    if (typeof error === "string")
+        tokens.push(error);
+    return tokens;
+}
+export function createNetworkGate(options) {
+    const waitBudgetMs = Math.max(0, options.waitBudgetMs ?? DEFAULT_NETWORK_WAIT_MS);
+    const probeIntervalMs = Math.max(50, options.probeIntervalMs ?? DEFAULT_NETWORK_PROBE_MS);
+    const pause = options.sleep ?? sleep;
+    const now = options.now ?? Date.now;
+    let exhausted = false;
+    let waitedMs = 0;
+    let lastKind;
+    let inflight;
+    const waitOnce = async (error) => {
+        lastKind = error.kind;
+        if (waitBudgetMs === 0) {
+            exhausted = true;
+            return false;
+        }
+        const began = now();
+        const deadline = began + waitBudgetMs;
+        options.onWait?.({ elapsedMs: 0, kind: error.kind, remainingMs: waitBudgetMs });
+        while (now() < deadline) {
+            const remaining = deadline - now();
+            await pause(Math.min(probeIntervalMs, Math.max(0, remaining)));
+            waitedMs = now() - began;
+            options.onWait?.({
+                elapsedMs: waitedMs,
+                kind: error.kind,
+                remainingMs: Math.max(0, deadline - now()),
+            });
+            if (await options.probe())
+                return true;
+        }
+        waitedMs = Math.max(waitedMs, now() - began);
+        exhausted = true;
+        return false;
+    };
+    return {
+        get exhausted() {
+            return exhausted;
+        },
+        get lastKind() {
+            return lastKind;
+        },
+        get waitedMs() {
+            return waitedMs;
+        },
+        awaitRecovery(error) {
+            if (exhausted)
+                return Promise.resolve(false);
+            if (inflight !== undefined)
+                return inflight;
+            inflight = waitOnce(error).finally(() => {
+                inflight = undefined;
+            });
+            return inflight;
+        },
+    };
+}
+export async function probeOrigin(origin, options = {}) {
+    const online = options.online ?? hasUsableInterface;
+    if (!online())
+        return false;
+    const timeoutMs = options.timeoutMs ?? 2_000;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    let url;
+    try {
+        url = new URL(origin);
+    }
+    catch {
+        return false;
+    }
+    try {
+        const response = await fetchImpl(url.origin, {
+            method: "HEAD",
+            redirect: "manual",
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        return response.status > 0;
+    }
+    catch (error) {
+        return classifyNetworkError(error) === null;
+    }
+}
+/**
+ * `fetch` with the same classify / retry / wait policy Client uses, for spec load (no Exchange).
+ */
+export async function fetchWithNetworkRetry(url, init = {}, options = {}) {
+    const retries = Math.max(0, options.retries ?? DEFAULT_NETWORK_RETRIES);
+    const pause = options.sleep ?? sleep;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const method = (init.method ?? "GET").toUpperCase();
+    let last;
+    const once = async (attempt) => {
+        try {
+            const initWithTimeout = options.requestTimeoutMs === undefined
+                ? init
+                : { ...init, signal: AbortSignal.timeout(options.requestTimeoutMs) };
+            return await fetchImpl(url, initWithTimeout);
+        }
+        catch (error) {
+            const raw = classifyNetworkError(error);
+            if (raw === null)
+                throw error;
+            const kind = refineNetworkKind(raw);
+            throw new NetworkError({
+                attempts: attempt + 1,
+                cause: error,
+                kind,
+                message: `${method} ${url} failed (${kind}: ${describeNetworkKind(kind)})`,
+                method,
+                url,
+            });
+        }
+    };
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            return await once(attempt);
+        }
+        catch (error) {
+            if (!isNetworkError(error))
+                throw error;
+            last = error;
+            if (attempt < retries)
+                await pause(networkRetryWaitMs(attempt));
+        }
+    }
+    const gate = createNetworkGate({
+        probe: options.probe ?? (() => probeOrigin(url, { fetchImpl })),
+        sleep: pause,
+        waitBudgetMs: options.waitMs ?? DEFAULT_NETWORK_WAIT_MS,
+        ...(options.now === undefined ? {} : { now: options.now }),
+        ...(options.onWait === undefined ? {} : { onWait: options.onWait }),
+    });
+    const failed = last;
+    if (await gate.awaitRecovery(failed))
+        return once(retries + 1);
+    throw new NetworkError({
+        attempts: failed.attempts,
+        cause: failed,
+        kind: failed.kind,
+        message: describeNetworkFailure(failed, gate.waitedMs),
+        method: failed.method,
+        url: failed.url,
+    });
+}
+//# sourceMappingURL=network.js.map