@chrischall/mcp-utils 2.11.0 → 2.12.0

package/dist/concurrency/verify-after-write.d.ts

@@ -0,0 +1,84 @@
+/**
+ * "Accepted is not confirmed": after a write that acts on the physical world
+ * (unlock a door, arm an alarm, start a car, set a charge limit) the upstream's
+ * 2xx says only that the command was queued. The proof is a re-read that shows
+ * the new state — and the device takes seconds, sometimes a minute, to report.
+ *
+ * kiaaccess-mcp (`KiaClient.verifyCommand`, the reference: abort-aware sleep,
+ * progress, a `cancelled` flag) and simplisafe-mcp (the lock poll and the alarm
+ * re-read) each hand-rolled this loop (fleet-audit#1176). simplisafe's lock poll
+ * slept with a bare `setTimeout` and never consulted the caller's cancellation,
+ * and nothing bounded a hung re-read (fleet-audit#1117) — so the shared loop
+ * makes both bounds structural:
+ *
+ *  - **Deadline.** `timeoutMs` is a hard bound on the whole verification. Each
+ *    read is handed an `AbortSignal` that fires at the deadline (pass it to
+ *    `fetch`), and a wait that would end at or past the deadline is not started.
+ *  - **Cancellation.** The caller's signal — by default the running tool call's
+ *    ({@link currentCallSignal}) — ends a wait at once and is folded into the
+ *    read's signal, so a client that cancelled stops being polled for.
+ *  - **A failed re-read never throws.** The write already went out; reporting
+ *    the read's failure as the command's would invite a retry of a door that is
+ *    already open. It comes back as `outcome: 'read_failed'` with the `error`
+ *    and the last good `snapshot`, for the caller to report as unverified.
+ *
+ * Progress is reported before each re-read through {@link reportProgress} (a
+ * no-op unless the client sent a progress token); a failing reporter is ignored.
+ */
+/** Options for {@link verifyAfterWrite}. */
+export interface VerifyAfterWriteOptions<T> {
+    /** Read the current state. Pass `signal` on to the request so a hung read is bounded. */
+    read: (signal: AbortSignal) => Promise<T>;
+    /**
+     * Whether `snapshot` ends the wait — the requested state, OR a terminal one
+     * that will not change by waiting (simplisafe's `jammed`). Classify the final
+     * snapshot yourself; this only decides when to stop reading.
+     */
+    isSettled: (snapshot: T) => boolean;
+    /** Hard bound on the whole verification, in ms. */
+    timeoutMs: number;
+    /** Delay between re-reads. Default 2 000 ms. */
+    intervalMs?: number;
+    /** Delay before the FIRST read (a device that cannot have moved yet). Default 0. */
+    initialDelayMs?: number;
+    /**
+     * The caller's own cancellation. ALWAYS combined with the running tool call's
+     * ({@link currentCallSignal}) — whichever aborts first stops the loop.
+     */
+    signal?: AbortSignal;
+    /**
+     * Called before each re-read after the first. Defaults to {@link reportProgress}
+     * with "Waiting for the change to be confirmed (read N)". Errors are ignored.
+     */
+    onProgress?: (info: {
+        attempt: number;
+        elapsedMs: number;
+        timeoutMs: number;
+    }) => void | Promise<void>;
+}
+/** What {@link verifyAfterWrite} observed. */
+export interface VerifyAfterWriteResult<T> {
+    /**
+     * - `settled` — a read satisfied `isSettled`.
+     * - `timeout` — the deadline passed first.
+     * - `cancelled` — the caller's signal aborted.
+     * - `read_failed` — a read threw (not because of the deadline or the caller).
+     */
+    outcome: 'settled' | 'timeout' | 'cancelled' | 'read_failed';
+    /** `outcome === 'settled'`. */
+    settled: boolean;
+    /** The last snapshot successfully read, or `undefined` when none was. */
+    snapshot: T | undefined;
+    /** Reads that returned a snapshot. */
+    attempts: number;
+    /** Milliseconds from the call to the answer, including any initial delay and waits. */
+    elapsedMs: number;
+    /** The read's error, for `read_failed`. */
+    error?: unknown;
+}
+/**
+ * After a write, re-read until the observed state settles, the deadline passes,
+ * or the caller cancels — see the module notes for the bounds it guarantees.
+ */
+export declare function verifyAfterWrite<T>(opts: VerifyAfterWriteOptions<T>): Promise<VerifyAfterWriteResult<T>>;
+//# sourceMappingURL=verify-after-write.d.ts.map

package/dist/concurrency/verify-after-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-after-write.d.ts","sourceRoot":"","sources":["../../src/concurrency/verify-after-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,yFAAyF;IACzF,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C;;;;OAIG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC;IACpC,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxG;AAED,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC;;;;;OAKG;IACH,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;IAC7D,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC;IACxB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAgBD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CA2D9G"}

package/dist/concurrency/verify-after-write.js

@@ -0,0 +1,108 @@
+/**
+ * "Accepted is not confirmed": after a write that acts on the physical world
+ * (unlock a door, arm an alarm, start a car, set a charge limit) the upstream's
+ * 2xx says only that the command was queued. The proof is a re-read that shows
+ * the new state — and the device takes seconds, sometimes a minute, to report.
+ *
+ * kiaaccess-mcp (`KiaClient.verifyCommand`, the reference: abort-aware sleep,
+ * progress, a `cancelled` flag) and simplisafe-mcp (the lock poll and the alarm
+ * re-read) each hand-rolled this loop (fleet-audit#1176). simplisafe's lock poll
+ * slept with a bare `setTimeout` and never consulted the caller's cancellation,
+ * and nothing bounded a hung re-read (fleet-audit#1117) — so the shared loop
+ * makes both bounds structural:
+ *
+ *  - **Deadline.** `timeoutMs` is a hard bound on the whole verification. Each
+ *    read is handed an `AbortSignal` that fires at the deadline (pass it to
+ *    `fetch`), and a wait that would end at or past the deadline is not started.
+ *  - **Cancellation.** The caller's signal — by default the running tool call's
+ *    ({@link currentCallSignal}) — ends a wait at once and is folded into the
+ *    read's signal, so a client that cancelled stops being polled for.
+ *  - **A failed re-read never throws.** The write already went out; reporting
+ *    the read's failure as the command's would invite a retry of a door that is
+ *    already open. It comes back as `outcome: 'read_failed'` with the `error`
+ *    and the last good `snapshot`, for the caller to report as unverified.
+ *
+ * Progress is reported before each re-read through {@link reportProgress} (a
+ * no-op unless the client sent a progress token); a failing reporter is ignored.
+ */
+import { reportProgress, withAmbientCancellation } from '../cancel/index.js';
+/** Resolve after `ms`, or as soon as `signal` aborts. Never rejects. */
+function wait(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted)
+            return resolve();
+        const done = () => {
+            clearTimeout(timer);
+            signal.removeEventListener('abort', done);
+            resolve();
+        };
+        const timer = setTimeout(done, ms);
+        signal.addEventListener('abort', done, { once: true });
+    });
+}
+/**
+ * After a write, re-read until the observed state settles, the deadline passes,
+ * or the caller cancels — see the module notes for the bounds it guarantees.
+ */
+export async function verifyAfterWrite(opts) {
+    const { read, isSettled, timeoutMs } = opts;
+    const intervalMs = opts.intervalMs ?? 2_000;
+    // Combined, never either-or: a caller's own signal must not switch off the
+    // tool call's cancellation (or vice versa) — the convention every other call
+    // site in this package follows.
+    const caller = withAmbientCancellation(opts.signal);
+    const onProgress = opts.onProgress ??
+        ((p) => reportProgress(p.elapsedMs, p.timeoutMs, `Waiting for the change to be confirmed (read ${p.attempt})`));
+    const started = Date.now();
+    const deadline = new AbortController();
+    const timer = setTimeout(() => deadline.abort(new Error(`verification deadline of ${timeoutMs}ms passed`)), timeoutMs);
+    const signal = caller ? AbortSignal.any([deadline.signal, caller]) : deadline.signal;
+    let snapshot;
+    let attempts = 0;
+    const result = (outcome, error) => ({
+        outcome,
+        settled: outcome === 'settled',
+        snapshot,
+        attempts,
+        elapsedMs: Date.now() - started,
+        ...(outcome === 'read_failed' ? { error } : {}),
+    });
+    /** Why the loop must stop now, if it must. The caller wins a tie with the deadline. */
+    const stopped = () => caller?.aborted ? 'cancelled' : deadline.signal.aborted ? 'timeout' : null;
+    try {
+        if (opts.initialDelayMs !== undefined && opts.initialDelayMs > 0) {
+            if (Date.now() - started + opts.initialDelayMs >= timeoutMs)
+                return result(stopped() ?? 'timeout');
+            await wait(opts.initialDelayMs, signal);
+        }
+        for (;;) {
+            const halt = stopped();
+            if (halt)
+                return result(halt);
+            if (attempts > 0) {
+                try {
+                    await onProgress({ attempt: attempts + 1, elapsedMs: Date.now() - started, timeoutMs });
+                }
+                catch {
+                    /* a failed progress notification must never cost the verification */
+                }
+            }
+            try {
+                snapshot = await read(signal);
+            }
+            catch (err) {
+                return result(stopped() ?? 'read_failed', err);
+            }
+            attempts += 1;
+            if (isSettled(snapshot))
+                return result('settled');
+            if (Date.now() - started + intervalMs >= timeoutMs)
+                return result(stopped() ?? 'timeout');
+            await wait(intervalMs, signal);
+        }
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=verify-after-write.js.map

package/dist/concurrency/verify-after-write.js.map

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

package/dist/errors/index.d.ts

@@ -78,7 +78,8 @@ export declare function createHelpfulError(message: string, opts?: {
  * is surfaced to a client: `Bearer <token>` / `Authorization: Basic <…>` headers,
  * `Cookie:` / `Set-Cookie:` header values (cookie names stay visible), standalone
  * JWTs, well-known API-key shapes (OpenAI/Anthropic `sk-…`, GitHub `ghp_…`,
- * Slack `xox?-…`, Google `AIza…`, AWS `AKIA…`, `whsec_…`), secret-bearing
+ * Slack `xox?-…`, Google `AIza…`, AWS `AKIA…`, `whsec_…`), Google OAuth2
+ * access/refresh tokens (`ya29.…` / `1//…`, never mid-base64), secret-bearing
  * URL query params (`access_token`/`accessToken`, `api_key`, `token`, `key`,
  * `sig`, `password`, …) and long OAuth `code=` values, echoed form passwords,
  * `X-Api-Key`-style headers (also as JSON keys, like `"authorization"`), and quote-wrapped JSON secret values (`"refresh_token":"…"` /
@@ -112,6 +113,39 @@ export declare const ERROR_REDACTION_INPUT_MAX: number;
 export declare function truncateErrorMessage(text: string, max?: number): string;
 /** Extract a string message from any thrown value. */
 export declare function messageOf(err: unknown): string;
+/**
+ * Whether `err` DECLARES itself a timeout — the one predicate the fleet uses
+ * to decide "retry this row once" and "classify this row as `timeout`"
+ * (fleet-audit#1078: onehome-mcp's own `OneHomeRequestTimeoutError` was
+ * bucketed with "listing not found" because only fetchproxy's class counted).
+ *
+ * Duck-typed (no `instanceof`, so any package's class qualifies and this core
+ * module stays zero-dep). An error is a timeout when, on it or on a short
+ * `cause` chain (undici wraps socket errors in `TypeError('fetch failed')`):
+ *
+ *  - its `name` is `TimeoutError` or ENDS in `TimeoutError` — covers
+ *    `AbortSignal.timeout()`'s `DOMException`, mcp-utils' `RequestTimeoutError`,
+ *    `@fetchproxy/server`'s `FetchproxyTimeoutError`, and any consumer class
+ *    following the convention (e.g. `OneHomeRequestTimeoutError`);
+ *  - it carries the documented marker **`timedOut: true`** — the way to opt a
+ *    class in without renaming it (mcp-utils' `GraphqlTransportError` sets it);
+ *  - its `code` is `ETIMEDOUT` or one of undici's `UND_ERR_*_TIMEOUT` codes.
+ *
+ * NOT a timeout, deliberately:
+ *  - a caller CANCELLATION — a link named `AbortError`, because retrying
+ *    something the user cancelled is wrong (and a bare `AbortError` cannot
+ *    say whether a deadline caused it);
+ *  - a link with an explicit `timedOut: false` (it has declared otherwise).
+ *
+ * The chain is read outside-in and the FIRST link that declares anything
+ * (timeout or not) decides, so a timeout class that wraps its own timer's
+ * `AbortError` as `cause` is still a timeout, and an `AbortError` is never
+ * promoted by what it wraps. Plain links in between are skipped. Also NOT a
+ * timeout:
+ *  - an error that merely says "timed out" in its message — the message is
+ *    upstream-controlled text, not a declaration.
+ */
+export declare function isTimeoutError(err: unknown): boolean;
 /**
  * Prepend the tool name to an error's context and return an {@link McpToolError},
  * preserving any `hint` and chaining the original via `cause`. The message is

package/dist/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,qFAAqF;AACrF,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAMrE;CACF;AAED;;;GAGG;AACH,qBAAa,4BAA6B,SAAQ,YAAY;IAC5D,YAAY,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAShD;CACF;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,wEAAwE;IACxE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,YACE,IAAI,EAAE,MAAM,EACZ,iBAAiB,GAAE,MAAuC,EAC1D,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAY3B;CACF;AAED,uEAAuE;AACvE,qBAAa,cAAe,SAAQ,YAAY;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC,YAAY,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAMtD;CACF;AAED,kFAAkF;AAClF,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAO3C;CACF;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAE/C,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM;IAH1B,YACW,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EAQzB;CACF;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAE1F;AAwKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBlD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,QAAY,CAAC;AAEnD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAkC,GAAG,MAAM,CAMlG;AAED,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAG9C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,YAAY,CAM1E;AAED,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAK9E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}

package/dist/errors/index.js

@@ -160,6 +160,21 @@ const API_KEY_RE = new RegExp([
 ]
     .map((p) => `\\b${p}`)
     .join('|'), 'g');
+// Google OAuth2 tokens: access tokens (`ya29.…`) and refresh tokens (`1//…`).
+// Upstreamed from gogcli-mcp's local wrapper (fleet audit #1160). Neither
+// shape has a fixed length, so each takes its documented prefix plus 8+
+// token characters — real tokens run to 100+, while prose like `ya29.1` or
+// a `1//2` ratio stays visible.
+//
+// LEFT BOUNDARY: a real token is never WELDED to base64 text — it follows a
+// quote, whitespace, `=`, `:`, a bracket, or the start of the string — while
+// `1//` occurs by chance inside roughly a third of large standard-base64
+// blobs. So the token may not follow a standard-base64 character
+// (`[A-Za-z0-9+/]`). The class is exactly that alphabet and no wider: adding
+// `=` would lose the form-encoded `refresh_token=1//…` spelling, which the
+// query-param rule only catches after a `?`/`&`. The literal prefixes keep
+// match starts sparse, so the scan stays linear.
+const GOOGLE_OAUTH_TOKEN_RE = /(?<![A-Za-z0-9+/])(?:ya29\.|1\/\/)[A-Za-z0-9._-]{8,}/g;
 // Secret-bearing query params — the value after `=` up to `&`/`#`/quote/space/end.
 // Anchored on `?`/`&` so plain prose like `key=primary` (no URL context) never
 // matches; that constraint is what makes short names like `key`/`sig` safe.
@@ -270,7 +285,8 @@ function redactJsonCookie(quote) {
  * is surfaced to a client: `Bearer <token>` / `Authorization: Basic <…>` headers,
  * `Cookie:` / `Set-Cookie:` header values (cookie names stay visible), standalone
  * JWTs, well-known API-key shapes (OpenAI/Anthropic `sk-…`, GitHub `ghp_…`,
- * Slack `xox?-…`, Google `AIza…`, AWS `AKIA…`, `whsec_…`), secret-bearing
+ * Slack `xox?-…`, Google `AIza…`, AWS `AKIA…`, `whsec_…`), Google OAuth2
+ * access/refresh tokens (`ya29.…` / `1//…`, never mid-base64), secret-bearing
  * URL query params (`access_token`/`accessToken`, `api_key`, `token`, `key`,
  * `sig`, `password`, …) and long OAuth `code=` values, echoed form passwords,
  * `X-Api-Key`-style headers (also as JSON keys, like `"authorization"`), and quote-wrapped JSON secret values (`"refresh_token":"…"` /
@@ -288,6 +304,7 @@ export function redactSecrets(text) {
         .replace(SET_COOKIE_RE, '$1$2=[REDACTED]')
         .replace(COOKIE_HEADER_RE, (_m, prefix, pairs) => `${prefix}${pairs.replace(/=[^;,\s]*/g, '=[REDACTED]')}`)
         .replace(API_KEY_RE, '[REDACTED]')
+        .replace(GOOGLE_OAUTH_TOKEN_RE, '[REDACTED]')
         .replace(HEADER_SECRET_RE, '$1[REDACTED]')
         .replace(QUERY_SECRET_RE, '$1[REDACTED]')
         .replace(OAUTH_CODE_RE, '$1[REDACTED]')
@@ -333,6 +350,67 @@ export function messageOf(err) {
         return err.message;
     return String(err);
 }
+/**
+ * `code` values that name a socket/transport-level timeout: Node's
+ * `ETIMEDOUT` and undici's connect / headers / body deadlines.
+ */
+const TIMEOUT_ERROR_CODES = new Set([
+    'ETIMEDOUT',
+    'UND_ERR_CONNECT_TIMEOUT',
+    'UND_ERR_HEADERS_TIMEOUT',
+    'UND_ERR_BODY_TIMEOUT',
+]);
+/** How many `cause` links {@link isTimeoutError} follows (also bounds a cyclic chain). */
+const TIMEOUT_CAUSE_DEPTH = 4;
+/**
+ * Whether `err` DECLARES itself a timeout — the one predicate the fleet uses
+ * to decide "retry this row once" and "classify this row as `timeout`"
+ * (fleet-audit#1078: onehome-mcp's own `OneHomeRequestTimeoutError` was
+ * bucketed with "listing not found" because only fetchproxy's class counted).
+ *
+ * Duck-typed (no `instanceof`, so any package's class qualifies and this core
+ * module stays zero-dep). An error is a timeout when, on it or on a short
+ * `cause` chain (undici wraps socket errors in `TypeError('fetch failed')`):
+ *
+ *  - its `name` is `TimeoutError` or ENDS in `TimeoutError` — covers
+ *    `AbortSignal.timeout()`'s `DOMException`, mcp-utils' `RequestTimeoutError`,
+ *    `@fetchproxy/server`'s `FetchproxyTimeoutError`, and any consumer class
+ *    following the convention (e.g. `OneHomeRequestTimeoutError`);
+ *  - it carries the documented marker **`timedOut: true`** — the way to opt a
+ *    class in without renaming it (mcp-utils' `GraphqlTransportError` sets it);
+ *  - its `code` is `ETIMEDOUT` or one of undici's `UND_ERR_*_TIMEOUT` codes.
+ *
+ * NOT a timeout, deliberately:
+ *  - a caller CANCELLATION — a link named `AbortError`, because retrying
+ *    something the user cancelled is wrong (and a bare `AbortError` cannot
+ *    say whether a deadline caused it);
+ *  - a link with an explicit `timedOut: false` (it has declared otherwise).
+ *
+ * The chain is read outside-in and the FIRST link that declares anything
+ * (timeout or not) decides, so a timeout class that wraps its own timer's
+ * `AbortError` as `cause` is still a timeout, and an `AbortError` is never
+ * promoted by what it wraps. Plain links in between are skipped. Also NOT a
+ * timeout:
+ *  - an error that merely says "timed out" in its message — the message is
+ *    upstream-controlled text, not a declaration.
+ */
+export function isTimeoutError(err) {
+    let cur = err;
+    for (let depth = 0; depth < TIMEOUT_CAUSE_DEPTH && cur !== null && typeof cur === 'object'; depth++) {
+        const e = cur;
+        const name = typeof e.name === 'string' ? e.name : '';
+        // The OUTERMOST link that says anything decides: a wrapper's own
+        // declaration outranks whatever it wraps.
+        if (name === 'AbortError' || e.timedOut === false)
+            return false;
+        if (name.endsWith('TimeoutError') || e.timedOut === true)
+            return true;
+        if (typeof e.code === 'string' && TIMEOUT_ERROR_CODES.has(e.code))
+            return true;
+        cur = e.cause;
+    }
+    return false;
+}
 /**
  * Prepend the tool name to an error's context and return an {@link McpToolError},
  * preserving any `hint` and chaining the original via `cause`. The message is

package/dist/errors/index.js.map

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

package/dist/fetchproxy/fallback.d.ts

@@ -0,0 +1,130 @@
+import type { BridgeHealthcheckTransport } from './index.js';
+/** Which leg a consumer is pinned to: `direct`, `fetchproxy`, or `auto` (direct with fallback). */
+export type TransportMode = 'direct' | 'fetchproxy' | 'auto';
+/** Options for {@link readTransportMode}. */
+export interface ReadTransportModeOptions {
+    /** The mode when the variable is unset. Default `'auto'`. */
+    default?: TransportMode;
+    /** Env to read (tests). Default `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** Where the unknown-value warning goes. Default `console.error` (stderr — stdout is the MCP pipe). */
+    log?: (message: string) => void;
+}
+/**
+ * Read a `<PREFIX>_TRANSPORT` pin (`direct` / `fetchproxy` / `auto`),
+ * case-insensitively, through the hardened {@link readEnvVar} (so an
+ * unexpanded `${…}` placeholder reads as unset). An unknown value warns —
+ * naming the variable — and means the default, rather than failing the boot.
+ */
+export declare function readTransportMode(envVar: string, opts?: ReadTransportModeOptions): TransportMode;
+/**
+ * Which leg serves calls now, for {@link registerBridgeHealthcheckTool}'s
+ * `path` option (a type alias so it is assignable to `HealthcheckPath`).
+ * `blocked_by` names the edge vendor that forced the switch, when known.
+ */
+export type DirectFirstStatus = {
+    transport: 'direct' | 'fetchproxy';
+    mode: TransportMode;
+    blocked_by?: string;
+};
+/** Request counters for a {@link DirectFirstTransport}; a snapshot. */
+export interface DirectFirstStats {
+    /** Calls attempted on each leg (a walled call counts once on each). */
+    requests: {
+        direct: number;
+        fetchproxy: number;
+    };
+    /** Of those, how many threw. A wall counts as a direct failure. */
+    failures: {
+        direct: number;
+        fetchproxy: number;
+    };
+    /** Direct failures judged to be an edge block. */
+    edge_blocks: number;
+    /** Epoch ms of the switch to the bridge, or `null` while still direct. */
+    switched_at: number | null;
+}
+/** What a {@link DirectFirstTransport.run} call is told about its attempt. */
+export interface DirectFirstCallContext {
+    /** The leg this attempt rides. */
+    leg: 'direct' | 'fetchproxy';
+    /** The effective cancellation (caller's + ambient), to pass to `fetch`. */
+    signal: AbortSignal | undefined;
+}
+/** Options for {@link createDirectFirstTransport}. */
+export interface DirectFirstTransportOptions<D, B> {
+    /** The direct leg (e.g. a plain-`fetch` transport). */
+    direct: D;
+    /**
+     * Build the bridge leg. Called lazily — on the first wall in `auto`, on
+     * first use in `fetchproxy` — and at most once once it succeeds.
+     */
+    bridge: () => B;
+    /** Default `'auto'`. Typically `readTransportMode('<PREFIX>_TRANSPORT')`. */
+    mode?: TransportMode;
+    /** Log prefix for the switch notice, e.g. `'hemnet-mcp'`. */
+    serverName: string;
+    /** The site's host, named in the switch notice (`keep a <host> tab open`). */
+    hostLabel?: string;
+    /**
+     * Which direct failures mean "walled — use the bridge". Default: an edge
+     * block by the shared rule (an `EdgeBlockedError`, or a refusal page /
+     * `cf-mitigated` on the error).
+     */
+    shouldFallBack?: (err: unknown) => boolean;
+    /** Replaces the default stderr notice when the switch happens. */
+    onFallback?: (info: {
+        error: unknown;
+        vendor: string | null;
+    }) => void;
+    /**
+     * The bridge's healthcheck slice (`runProbe` + `status`). Default: the
+     * bridge's own `bridgeTransport()` when it has one, else the bridge itself
+     * when it has `runProbe` and `status`.
+     */
+    bridgeHealth?: (bridge: B) => BridgeHealthcheckTransport | undefined;
+    /** Where the default notice goes. Default `console.error`. */
+    log?: (message: string) => void;
+}
+/** The router {@link createDirectFirstTransport} returns. */
+export interface DirectFirstTransport<D, B> {
+    /** The configured mode. */
+    readonly mode: TransportMode;
+    /**
+     * Run one call on the leg currently in charge, falling back as described
+     * in the module docs. `call` may run twice (direct, then bridge) — it must
+     * not have side effects outside the request it makes.
+     */
+    run<R>(call: (leg: D | B, ctx: DirectFirstCallContext) => Promise<R>, opts?: {
+        signal?: AbortSignal;
+    }): Promise<R>;
+    /** Which leg the NEXT call rides, for the healthcheck's `path`. */
+    status(): DirectFirstStatus;
+    /**
+     * The bridge's healthcheck slice once a bridge exists (always available in
+     * `fetchproxy` mode); `undefined` while on direct.
+     */
+    bridgeTransport(): BridgeHealthcheckTransport | undefined;
+    /** A snapshot of the request counters. */
+    stats(): DirectFirstStats;
+}
+/**
+ * Build a direct-first transport router. See the module docs for the
+ * behaviour; the consumer keeps its own leg types and wraps its one call:
+ *
+ * @example
+ * const legs = createDirectFirstTransport({
+ *   direct: new DirectTransport(opts),
+ *   bridge: () => new HemnetFetchproxyTransport(opts),
+ *   mode: readTransportMode('HEMNET_TRANSPORT'),
+ *   serverName: 'hemnet-mcp',
+ *   hostLabel: 'www.hemnet.se',
+ * });
+ * const transport: HemnetTransport = {
+ *   graphql: (q, v) => legs.run((leg) => leg.graphql(q, v)),
+ *   status: () => legs.status(),
+ *   bridgeTransport: () => legs.bridgeTransport(),
+ * };
+ */
+export declare function createDirectFirstTransport<D, B = D>(opts: DirectFirstTransportOptions<D, B>): DirectFirstTransport<D, B>;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/fetchproxy/fallback.d.ts.map

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