@chrischall/mcp-utils 0.1.0

package/dist/errors/index.js

@@ -0,0 +1,157 @@
+/**
+ * Shared MCP error classes, error wrapping, and bridge-error discrimination.
+ *
+ * Consolidates the `instanceof`-chains and remediation-message patterns found
+ * in `client.ts` / `auth.ts` across the fleet. Every error carries an optional
+ * `hint` — a "here's how to fix it" string the tool surface can show the user.
+ *
+ * The fetchproxy typed-error hierarchy (`Fetchproxy*Error`) is re-exported, not
+ * reimplemented; {@link classifyBridgeError} is a thin discriminator over it.
+ */
+// NOTE: the fetchproxy typed-error hierarchy (Fetchproxy*Error) and the
+// `classifyBridgeError` discriminator live in the `@chrischall/mcp-utils/fetchproxy`
+// subpath — NOT here. Keeping `@fetchproxy/server` (an optional peer dep) out of
+// this core module is what lets bearer-only MCPs import the core barrel without
+// installing fetchproxy.
+/** Default seconds to wait before retrying a tripped bot-wall (issue #90 tuning). */
+export const DEFAULT_BOT_WALL_RETRY_AFTER_S = 30;
+/** Default truncation budget for upstream error bodies surfaced to clients. */
+export const DEFAULT_ERROR_MESSAGE_MAX = 500;
+/**
+ * Base class for every tool-facing error. Carries an optional `hint` —
+ * actionable remediation text ("set ZOLA_REFRESH_TOKEN", "sign in at compass.com")
+ * the tool surface can present separately from the message.
+ */
+export class McpToolError extends Error {
+    /** Actionable remediation text, when one applies. */
+    hint;
+    constructor(message, opts) {
+        super(message, opts?.cause !== undefined ? { cause: opts.cause } : undefined);
+        this.name = 'McpToolError';
+        if (opts?.hint !== undefined)
+            this.hint = opts.hint;
+        // Restore the prototype chain for transpiled `extends Error`.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * The user's browser session isn't signed in to the upstream service. Distinct
+ * from a transient bot-wall — this is a stable "go authenticate" condition.
+ */
+export class SessionNotAuthenticatedError extends McpToolError {
+    constructor(service, signInHost) {
+        const name = service ?? 'the service';
+        const where = signInHost ? `Open ${signInHost} in your browser and sign in, then try again.` : 'Sign in in your browser, then try again.';
+        super(`Not signed in to ${name}. ${where} ` +
+            'Saved searches, saved homes, and other account data require a signed-in session.', { hint: where });
+        this.name = 'SessionNotAuthenticatedError';
+    }
+}
+/**
+ * Transient anti-bot interstitial (PerimeterX / DataDome CAPTCHA). The request
+ * was rate-limited, NOT a missing resource — back off and retry. Kept distinct
+ * from {@link SessionNotAuthenticatedError} so callers don't misclassify a
+ * retryable wall as a stale session (issue #90).
+ */
+export class BotWallError extends McpToolError {
+    /** Suggested seconds to wait before retrying the blocked request(s). */
+    retryAfterSeconds;
+    constructor(path, retryAfterSeconds = DEFAULT_BOT_WALL_RETRY_AFTER_S) {
+        const hint = `Back off and retry (suggested wait: ${retryAfterSeconds}s). If it persists, open the site in your browser, clear the CAPTCHA, then retry with a smaller batch.`;
+        super(`Served an anti-bot CAPTCHA wall for ${path} — the request was rate-limited, not a missing resource. ${hint}`, { hint });
+        this.name = 'BotWallError';
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/** Upstream returned HTTP 429 (or an equivalent rate-limit signal). */
+export class RateLimitError extends McpToolError {
+    /** Seconds the upstream asked us to wait, when it told us. */
+    retryAfterSeconds;
+    constructor(service, retryAfterSeconds) {
+        const wait = retryAfterSeconds !== undefined ? ` Retry after ${retryAfterSeconds}s.` : ' Back off and retry.';
+        super(`Rate limited by ${service}.${wait}`, { hint: wait.trim() });
+        this.name = 'RateLimitError';
+        if (retryAfterSeconds !== undefined)
+            this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/** Upstream is unreachable (5xx / transport failure) — not the caller's fault. */
+export class UnreachableError extends McpToolError {
+    /** Upstream HTTP status, when one was observed. */
+    status;
+    constructor(service, status) {
+        const suffix = status !== undefined ? ` (status ${status})` : '';
+        super(`${service} unreachable${suffix}. The service may be down — try again later.`, {
+            hint: 'The upstream service is temporarily unavailable; retry later.',
+        });
+        this.name = 'UnreachableError';
+        if (status !== undefined)
+            this.status = status;
+    }
+}
+/**
+ * A tool requires a different auth/operation mode than the server is running in
+ * (e.g. a Pro key-mode-only report invoked while in session mode).
+ */
+export class ModeMismatchError extends McpToolError {
+    currentMode;
+    requiredMode;
+    feature;
+    constructor(currentMode, requiredMode, feature) {
+        const hint = `Switch to ${requiredMode} mode to use ${feature}.`;
+        super(`${feature} requires ${requiredMode} mode but the server is running in ${currentMode} mode. ${hint}`, { hint });
+        this.currentMode = currentMode;
+        this.requiredMode = requiredMode;
+        this.feature = feature;
+        this.name = 'ModeMismatchError';
+    }
+}
+/** Factory for an {@link McpToolError} with a remediation hint. */
+export function createHelpfulError(message, opts) {
+    return new McpToolError(message, opts);
+}
+const BEARER_RE = /(bearer\s+)[A-Za-z0-9._~+/=-]{8,}/gi;
+// A JWT-shaped triple (header.payload.signature), each segment base64url-ish.
+const JWT_RE = /\b[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{8,}\b/g;
+/**
+ * Redact secrets that commonly leak into upstream error bodies before the text
+ * is surfaced to a client: `Bearer <token>` headers and standalone JWTs.
+ */
+function redactSecrets(text) {
+    return text.replace(BEARER_RE, '$1[REDACTED]').replace(JWT_RE, '[REDACTED]');
+}
+/**
+ * Redact secrets, then cap an (upstream) error string at `max` characters,
+ * appending a `… [truncated]` marker when clipped.
+ *
+ * Security: redaction runs BEFORE truncation so a token straddling the cut
+ * boundary can't survive in a half-form. Untrusted upstream bodies must always
+ * go through this before reaching a tool result.
+ */
+export function truncateErrorMessage(text, max = DEFAULT_ERROR_MESSAGE_MAX) {
+    const str = text === null || text === undefined ? '' : String(text);
+    const redacted = redactSecrets(str);
+    if (redacted.length <= max)
+        return redacted;
+    return `${redacted.slice(0, max)}… [truncated]`;
+}
+/** Extract a string message from any thrown value. */
+export function messageOf(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+/**
+ * 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
+ * run through {@link truncateErrorMessage} (redaction + truncation). Re-wrapping
+ * an already-prefixed error does not double-prefix.
+ */
+export function wrapToolError(toolName, err) {
+    const inner = messageOf(err);
+    const prefix = `[${toolName}]`;
+    const message = inner.includes(prefix) ? inner : `${prefix} ${inner}`;
+    const hint = err instanceof McpToolError ? err.hint : undefined;
+    return new McpToolError(truncateErrorMessage(message), { hint, cause: err });
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wEAAwE;AACxE,qFAAqF;AACrF,iFAAiF;AACjF,gFAAgF;AAChF,yBAAyB;AAEzB,qFAAqF;AACrF,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAEjD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,qDAAqD;IAC5C,IAAI,CAAU;IAEvB,YAAY,OAAe,EAAE,IAAyC;QACpE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACpD,8DAA8D;QAC9D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,4BAA6B,SAAQ,YAAY;IAC5D,YAAY,OAAgB,EAAE,UAAmB;QAC/C,MAAM,IAAI,GAAG,OAAO,IAAI,aAAa,CAAC;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,UAAU,+CAA+C,CAAC,CAAC,CAAC,0CAA0C,CAAC;QAC1I,KAAK,CACH,oBAAoB,IAAI,KAAK,KAAK,GAAG;YACnC,kFAAkF,EACpF,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,YAAY;IAC5C,wEAAwE;IAC/D,iBAAiB,CAAS;IAEnC,YAAY,IAAY,EAAE,oBAA4B,8BAA8B;QAClF,MAAM,IAAI,GAAG,uCAAuC,iBAAiB,wGAAwG,CAAC;QAC9K,KAAK,CACH,uCAAuC,IAAI,4DAA4D,IAAI,EAAE,EAC7G,EAAE,IAAI,EAAE,CACT,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,OAAO,cAAe,SAAQ,YAAY;IAC9C,8DAA8D;IACrD,iBAAiB,CAAU;IAEpC,YAAY,OAAe,EAAE,iBAA0B;QACrD,MAAM,IAAI,GACR,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,iBAAiB,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC;QACnG,KAAK,CAAC,mBAAmB,OAAO,IAAI,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,iBAAiB,KAAK,SAAS;YAAE,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAClF,CAAC;CACF;AAED,kFAAkF;AAClF,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD,mDAAmD;IAC1C,MAAM,CAAU;IAEzB,YAAY,OAAe,EAAE,MAAe;QAC1C,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,KAAK,CAAC,GAAG,OAAO,eAAe,MAAM,8CAA8C,EAAE;YACnF,IAAI,EAAE,+DAA+D;SACtE,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACjD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IAEtC;IACA;IACA;IAHX,YACW,WAAmB,EACnB,YAAoB,EACpB,OAAe;QAExB,MAAM,IAAI,GAAG,aAAa,YAAY,gBAAgB,OAAO,GAAG,CAAC;QACjE,KAAK,CACH,GAAG,OAAO,aAAa,YAAY,sCAAsC,WAAW,UAAU,IAAI,EAAE,EACpG,EAAE,IAAI,EAAE,CACT,CAAC;QARO,gBAAW,GAAX,WAAW,CAAQ;QACnB,iBAAY,GAAZ,YAAY,CAAQ;QACpB,YAAO,GAAP,OAAO,CAAQ;QAOxB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,IAAwB;IAC1E,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,SAAS,GAAG,qCAAqC,CAAC;AACxD,8EAA8E;AAC9E,MAAM,MAAM,GAAG,gEAAgE,CAAC;AAEhF;;;GAGG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,MAAc,yBAAyB;IACxF,MAAM,GAAG,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC;AAClD,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,GAAY;IAC1D,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,QAAQ,GAAG,CAAC;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;IACtE,MAAM,IAAI,GAAG,GAAG,YAAY,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,OAAO,IAAI,YAAY,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/fetchproxy/index.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Fetchproxy transport adapter — the Pattern-A glue shared by every
+ * fetchproxy-backed MCP (redfin/zillow/compass/homes/onehome/resy/opentable/…).
+ *
+ * `@fetchproxy/server` already owns HTTP proxying, session bootstrap, and the
+ * bot-wall / backoff / deadline / concurrency / retry primitives. This module
+ * does NOT reimplement any of that — it re-exports the primitives so MCPs have a
+ * single import site, and provides two thin factories:
+ *
+ *  - {@link createFetchproxyTransport} wraps a `FetchproxyServer` in the
+ *    `start` / `close` / `status` lifecycle every MCP's transport interface
+ *    expects, with optional debug-gated role logging.
+ *  - {@link createBootstrapOpts} assembles a multi-domain / capture-header /
+ *    storage-pointer declaration fragment of `FetchproxyServerOpts`, deriving
+ *    the required `capabilities` from the declared bootstrap so callers can't
+ *    forget to unlock the verb they declared.
+ *
+ * The adapter shape is identical across 12+ fetchproxy MCPs; collapsing it here
+ * keeps the per-row / concurrency / deadline helpers as re-exports rather than
+ * re-rolled code.
+ */
+import { FetchproxyServer, type FetchproxyServerOpts } from '@fetchproxy/server';
+export { FetchproxyServer, mapWithConcurrency, withDeadline, TokenBucket, classifyBotWall, retryOnceOnTimeout, FetchproxyProtocolError, FetchproxyHttpError, FetchproxyBridgeDownError, FetchproxyTimeoutError, classifyFetchError, backoffDelayMs, BRIDGE_CONCURRENCY, } from '@fetchproxy/server';
+export type { FetchproxyServerOpts, FetchResult, FetchResultError, HttpResponse, RequestOpts, BodylessRequestOpts, BridgeHealth, BridgeProbeResult, BridgeError, FetchErrorKind, BotWallResult, BotWallVendor, TokenBucketOptions, BackoffOptions, DeadlineOutcome, } from '@fetchproxy/server';
+/**
+ * The lifecycle surface every per-MCP fetchproxy transport interface exposes.
+ * `createFetchproxyTransport` returns this, typed as the caller's `T` so it can
+ * stand in for `RedfinTransport`, `ZillowTransport`, etc. without those
+ * interfaces depending on this package.
+ */
+export interface FetchproxyTransport {
+    /**
+     * Load identity (creating the 0600 keypair on first run) and prepare the
+     * bridge. Does NOT bind the port or dial — connection is lazy on first verb.
+     * When `debugEnvVar` is set and truthy, logs the landed role to stderr.
+     */
+    start(): Promise<void>;
+    /** Tear the bridge connection down. Safe to call before {@link start}. */
+    close(): Promise<void>;
+    /** Process-wide bridge freshness snapshot, for a healthcheck tool. */
+    status(): ReturnType<FetchproxyServer['bridgeHealth']>;
+    /** Bridge role; `null` until the first verb call / explicit connect. */
+    readonly role: FetchproxyServer['role'];
+    /**
+     * The wrapped `FetchproxyServer` — the verb surface (`request`/`get`/`post`/
+     * `getJson`/`getHtml`/`readCookies`/`captureRequestHeader`/…). Exposed so the
+     * caller's tool layer can issue requests without this package modelling every
+     * verb.
+     */
+    readonly server: FetchproxyServer;
+}
+/** Options for {@link createFetchproxyTransport}. */
+export type CreateFetchproxyTransportOptions = FetchproxyServerOpts & {
+    /**
+     * Env var name that gates stderr role/lifecycle logging (e.g. `REDFIN_DEBUG`).
+     * The value is read defensively — empty / `'null'` / `${...}` placeholders are
+     * treated as unset, so an unexpanded MCP-host env block never enables logging.
+     */
+    debugEnvVar?: string;
+    /** Env source for {@link debugEnvVar}. Defaults to `process.env`. */
+    env?: NodeJS.ProcessEnv;
+};
+/**
+ * Wrap a `FetchproxyServer` in the `start`/`close`/`status` lifecycle the
+ * per-MCP transport interface expects. The full `FetchproxyServerOpts` is
+ * forwarded verbatim (so `fetchTimeoutMs`, `keepAliveIntervalMs`, capture
+ * declarations, etc. all pass through); the only added knob is `debugEnvVar`.
+ *
+ * Returns the wrapper typed as the caller's `T` (defaulting to
+ * {@link FetchproxyTransport}) so it can satisfy a structurally-compatible
+ * per-MCP interface without that interface importing this package.
+ *
+ * @example
+ * const transport = createFetchproxyTransport<RedfinTransport>({
+ *   serverName: 'redfin-mcp', version, domains: ['redfin.com'],
+ *   debugEnvVar: 'REDFIN_DEBUG',
+ * });
+ */
+export declare function createFetchproxyTransport<T = FetchproxyTransport>(opts: CreateFetchproxyTransportOptions): T;
+/** Re-export the protocol declaration shapes so callers have one import site. */
+export type { Capability, CaptureHeaderDecl, IndexedDbScopeDecl, StoragePointerDecl, } from '@fetchproxy/protocol';
+import type { CaptureHeaderDecl, IndexedDbScopeDecl, StoragePointerDecl } from '@fetchproxy/protocol';
+/**
+ * The bootstrap declarations an MCP needs to extract auth from the user's
+ * signed-in tab. Each present, non-empty group unlocks the capability that
+ * gates the matching verb — `createBootstrapOpts` derives `capabilities` so the
+ * caller can't declare a capture without unlocking it (or vice-versa).
+ */
+export interface BootstrapDecls {
+    /** `read_cookies`: declared cookie names readable via `readCookies({ keys })`. */
+    cookieKeys?: string[];
+    /** `read_local_storage`: declared localStorage keys. */
+    localStorageKeys?: string[];
+    /** `read_session_storage`: declared sessionStorage keys. */
+    sessionStorageKeys?: string[];
+    /** JSON-pointer extractions over localStorage values (implies `read_local_storage`). */
+    localStoragePointers?: StoragePointerDecl[];
+    /** JSON-pointer extractions over sessionStorage values (implies `read_session_storage`). */
+    sessionStoragePointers?: StoragePointerDecl[];
+    /** `capture_request_header`: (urlPattern, headerName) pairs to snapshot. */
+    captureHeaders?: CaptureHeaderDecl[];
+    /** `read_indexed_db`: declared IndexedDB scopes. */
+    indexedDbScopes?: IndexedDbScopeDecl[];
+}
+/** Options for {@link createBootstrapOpts}. */
+export interface CreateBootstrapOptsArgs {
+    /**
+     * Trust-boundary hostname(s). A bare string is accepted for the common
+     * single-domain case; multi-domain MCPs pass an array (and must then specify
+     * `{ domain }` on each per-call request).
+     */
+    domains: string | string[];
+    /**
+     * Documentation hint for *where* the bootstrap reads from (e.g.
+     * `portal.onehome.com`). Recorded on the returned fragment as a comment-level
+     * concern only — the actual gating is per declaration. Must be a subdomain of
+     * (or equal to) one of `domains` if provided.
+     */
+    storageDomain?: string;
+    /** The capture/storage declarations to thread into capabilities + opts. */
+    bootstrap?: BootstrapDecls;
+}
+/**
+ * Assemble the multi-domain / bootstrap-declaration fragment of
+ * `FetchproxyServerOpts`. Spread the result into
+ * {@link createFetchproxyTransport} alongside `serverName` / `version`.
+ *
+ * The returned `capabilities` is derived from the declared bootstrap: each
+ * present declaration group adds exactly the capability that gates its verb
+ * (deduped). When no bootstrap declarations are given, `capabilities` is left
+ * unset so the server falls back to its default `['fetch']`.
+ *
+ * @example
+ * const opts = createBootstrapOpts({
+ *   domains: 'onehome.com',
+ *   storageDomain: 'portal.onehome.com',
+ *   bootstrap: { captureHeaders: [{ urlPattern: 'https://portal.onehome.com/graphql*', headerName: 'Authorization' }] },
+ * });
+ * createFetchproxyTransport({ ...opts, serverName: 'onehome-mcp', version });
+ */
+export declare function createBootstrapOpts(args: CreateBootstrapOptsArgs): Pick<FetchproxyServerOpts, 'domains' | 'capabilities' | 'cookieKeys' | 'localStorageKeys' | 'sessionStorageKeys' | 'localStoragePointers' | 'sessionStoragePointers' | 'captureHeaders' | 'indexedDbScopes'>;
+/** Discriminated classification of a tool-boundary error. */
+export interface BridgeErrorInfo {
+    type: 'bridge_down' | 'timeout' | 'http' | 'protocol' | 'unknown';
+    message: string;
+    hint?: string;
+}
+/**
+ * Thin discriminator over the `@fetchproxy/server` typed-error hierarchy. Folds
+ * the fetchproxy `classifyBridgeError` (which returns a bare kind string) into a
+ * `{ type, message, hint? }` envelope, mapping fetchproxy's `'other'` to
+ * `'unknown'` and lifting the per-class remediation `hint` where one exists. The
+ * surfaced message is redacted + truncated.
+ */
+export declare function classifyBridgeError(err: unknown): BridgeErrorInfo;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/fetchproxy/index.js

@@ -0,0 +1,197 @@
+/**
+ * Fetchproxy transport adapter — the Pattern-A glue shared by every
+ * fetchproxy-backed MCP (redfin/zillow/compass/homes/onehome/resy/opentable/…).
+ *
+ * `@fetchproxy/server` already owns HTTP proxying, session bootstrap, and the
+ * bot-wall / backoff / deadline / concurrency / retry primitives. This module
+ * does NOT reimplement any of that — it re-exports the primitives so MCPs have a
+ * single import site, and provides two thin factories:
+ *
+ *  - {@link createFetchproxyTransport} wraps a `FetchproxyServer` in the
+ *    `start` / `close` / `status` lifecycle every MCP's transport interface
+ *    expects, with optional debug-gated role logging.
+ *  - {@link createBootstrapOpts} assembles a multi-domain / capture-header /
+ *    storage-pointer declaration fragment of `FetchproxyServerOpts`, deriving
+ *    the required `capabilities` from the declared bootstrap so callers can't
+ *    forget to unlock the verb they declared.
+ *
+ * The adapter shape is identical across 12+ fetchproxy MCPs; collapsing it here
+ * keeps the per-row / concurrency / deadline helpers as re-exports rather than
+ * re-rolled code.
+ */
+import { FetchproxyServer, FetchproxyBridgeDownError, classifyBridgeError as classifyBridgeErrorKind, } from '@fetchproxy/server';
+import { truncateErrorMessage, messageOf } from '../errors/index.js';
+// ---------------------------------------------------------------------------
+// Re-exports — single import site for the bridge primitives (design: re-export,
+// never reimplement). MCPs import these from here instead of reaching into
+// `@fetchproxy/server` directly, so a version bump is absorbed in one place.
+// ---------------------------------------------------------------------------
+export { FetchproxyServer, mapWithConcurrency, withDeadline, TokenBucket, classifyBotWall, retryOnceOnTimeout, FetchproxyProtocolError, FetchproxyHttpError, FetchproxyBridgeDownError, FetchproxyTimeoutError, classifyFetchError, backoffDelayMs, BRIDGE_CONCURRENCY, } from '@fetchproxy/server';
+/**
+ * Matches a value that is *entirely* an unsubstituted shell-style placeholder
+ * (`${FOO}`). MCP hosts that forward an env block without expanding it leak
+ * these literals; treating them as unset is the canonical placeholder-leakage
+ * defense (mirrors `config.readEnvVar`).
+ */
+const PLACEHOLDER_RE = /^\$\{[^}]*\}$/;
+/**
+ * Defensive truthiness check for a debug/flag env var: trims, and treats the
+ * empty string, `'undefined'`, `'null'`, and unexpanded `${...}` placeholders
+ * as unset (falsey). Any other non-empty value enables the flag.
+ */
+function envFlagEnabled(key, env = process.env) {
+    const raw = env[key];
+    if (typeof raw !== 'string')
+        return false;
+    const trimmed = raw.trim();
+    return (trimmed.length > 0 &&
+        trimmed !== 'undefined' &&
+        trimmed !== 'null' &&
+        !PLACEHOLDER_RE.test(trimmed));
+}
+/**
+ * Wrap a `FetchproxyServer` in the `start`/`close`/`status` lifecycle the
+ * per-MCP transport interface expects. The full `FetchproxyServerOpts` is
+ * forwarded verbatim (so `fetchTimeoutMs`, `keepAliveIntervalMs`, capture
+ * declarations, etc. all pass through); the only added knob is `debugEnvVar`.
+ *
+ * Returns the wrapper typed as the caller's `T` (defaulting to
+ * {@link FetchproxyTransport}) so it can satisfy a structurally-compatible
+ * per-MCP interface without that interface importing this package.
+ *
+ * @example
+ * const transport = createFetchproxyTransport<RedfinTransport>({
+ *   serverName: 'redfin-mcp', version, domains: ['redfin.com'],
+ *   debugEnvVar: 'REDFIN_DEBUG',
+ * });
+ */
+export function createFetchproxyTransport(opts) {
+    const { debugEnvVar, env, ...serverOpts } = opts;
+    if (!serverOpts.serverName || serverOpts.serverName.trim().length === 0) {
+        throw new Error('createFetchproxyTransport: `serverName` is required.');
+    }
+    if (!Array.isArray(serverOpts.domains) || serverOpts.domains.length === 0) {
+        throw new Error('createFetchproxyTransport: at least one `domains` entry is required.');
+    }
+    const server = new FetchproxyServer(serverOpts);
+    const debug = debugEnvVar !== undefined && envFlagEnabled(debugEnvVar, env ?? process.env);
+    const transport = {
+        server,
+        get role() {
+            return server.role;
+        },
+        async start() {
+            await server.listen();
+            if (debug) {
+                // Stderr only — stdio MCP transports reserve stdout for JSON-RPC.
+                console.error(`[${serverOpts.serverName}:bridge] listening ` +
+                    `(role=${server.role ?? 'unknown'}, version=${serverOpts.version})`);
+            }
+        },
+        async close() {
+            await server.close();
+        },
+        status() {
+            return server.bridgeHealth();
+        },
+    };
+    return transport;
+}
+function nonEmpty(arr) {
+    return Array.isArray(arr) && arr.length > 0;
+}
+/**
+ * Assemble the multi-domain / bootstrap-declaration fragment of
+ * `FetchproxyServerOpts`. Spread the result into
+ * {@link createFetchproxyTransport} alongside `serverName` / `version`.
+ *
+ * The returned `capabilities` is derived from the declared bootstrap: each
+ * present declaration group adds exactly the capability that gates its verb
+ * (deduped). When no bootstrap declarations are given, `capabilities` is left
+ * unset so the server falls back to its default `['fetch']`.
+ *
+ * @example
+ * const opts = createBootstrapOpts({
+ *   domains: 'onehome.com',
+ *   storageDomain: 'portal.onehome.com',
+ *   bootstrap: { captureHeaders: [{ urlPattern: 'https://portal.onehome.com/graphql*', headerName: 'Authorization' }] },
+ * });
+ * createFetchproxyTransport({ ...opts, serverName: 'onehome-mcp', version });
+ */
+export function createBootstrapOpts(args) {
+    const domains = Array.isArray(args.domains) ? args.domains : [args.domains];
+    if (domains.length === 0 || domains.some((d) => !d || d.trim().length === 0)) {
+        throw new Error('createBootstrapOpts: at least one non-empty `domains` entry is required.');
+    }
+    if (args.storageDomain !== undefined) {
+        const host = args.storageDomain.trim();
+        const ok = domains.some((d) => host === d || host.endsWith(`.${d}`));
+        if (!ok) {
+            throw new Error(`createBootstrapOpts: storageDomain '${args.storageDomain}' is not within declared domains [${domains.join(', ')}].`);
+        }
+    }
+    const b = args.bootstrap ?? {};
+    const capabilities = new Set();
+    if (nonEmpty(b.cookieKeys))
+        capabilities.add('read_cookies');
+    if (nonEmpty(b.localStorageKeys) || nonEmpty(b.localStoragePointers)) {
+        capabilities.add('read_local_storage');
+    }
+    if (nonEmpty(b.sessionStorageKeys) || nonEmpty(b.sessionStoragePointers)) {
+        capabilities.add('read_session_storage');
+    }
+    if (nonEmpty(b.captureHeaders))
+        capabilities.add('capture_request_header');
+    if (nonEmpty(b.indexedDbScopes))
+        capabilities.add('read_indexed_db');
+    return {
+        domains,
+        ...(capabilities.size > 0 ? { capabilities: [...capabilities] } : {}),
+        ...(nonEmpty(b.cookieKeys) ? { cookieKeys: b.cookieKeys } : {}),
+        ...(nonEmpty(b.localStorageKeys) ? { localStorageKeys: b.localStorageKeys } : {}),
+        ...(nonEmpty(b.sessionStorageKeys) ? { sessionStorageKeys: b.sessionStorageKeys } : {}),
+        ...(nonEmpty(b.localStoragePointers) ? { localStoragePointers: b.localStoragePointers } : {}),
+        ...(nonEmpty(b.sessionStoragePointers) ? { sessionStoragePointers: b.sessionStoragePointers } : {}),
+        ...(nonEmpty(b.captureHeaders) ? { captureHeaders: b.captureHeaders } : {}),
+        ...(nonEmpty(b.indexedDbScopes) ? { indexedDbScopes: b.indexedDbScopes } : {}),
+    };
+}
+/**
+ * Thin discriminator over the `@fetchproxy/server` typed-error hierarchy. Folds
+ * the fetchproxy `classifyBridgeError` (which returns a bare kind string) into a
+ * `{ type, message, hint? }` envelope, mapping fetchproxy's `'other'` to
+ * `'unknown'` and lifting the per-class remediation `hint` where one exists. The
+ * surfaced message is redacted + truncated.
+ */
+export function classifyBridgeError(err) {
+    const kind = classifyBridgeErrorKind(err);
+    const message = truncateErrorMessage(messageOf(err));
+    switch (kind) {
+        case 'timeout':
+            return {
+                type: 'timeout',
+                message,
+                hint: 'The fetchproxy bridge timed out. Check the browser tab is open and responsive, then retry.',
+            };
+        case 'bridge_down': {
+            const hint = err instanceof FetchproxyBridgeDownError ? err.hint : undefined;
+            return {
+                type: 'bridge_down',
+                message,
+                hint: hint ?? 'The fetchproxy browser bridge is offline. Open a signed-in tab so the extension can relay the request.',
+            };
+        }
+        case 'http':
+            return { type: 'http', message };
+        case 'protocol':
+            return {
+                type: 'protocol',
+                message,
+                hint: 'The fetchproxy bridge could not relay the request (e.g. no signed-in tab or denied domain).',
+            };
+        case 'other':
+        default:
+            return { type: 'unknown', message };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/fetchproxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fetchproxy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,IAAI,uBAAuB,GAE/C,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAErE,8EAA8E;AAC9E,gFAAgF;AAChF,2EAA2E;AAC3E,6EAA6E;AAC7E,8EAA8E;AAC9E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAuB5B;;;;;GAKG;AACH,MAAM,cAAc,GAAG,eAAe,CAAC;AAEvC;;;;GAIG;AACH,SAAS,cAAc,CAAC,GAAW,EAAE,MAAyB,OAAO,CAAC,GAAG;IACvE,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,CACL,OAAO,CAAC,MAAM,GAAG,CAAC;QAClB,OAAO,KAAK,WAAW;QACvB,OAAO,KAAK,MAAM;QAClB,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAC9B,CAAC;AACJ,CAAC;AA0CD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAsC;IAEtC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;IAEjD,IAAI,CAAC,UAAU,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,WAAW,KAAK,SAAS,IAAI,cAAc,CAAC,WAAW,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAE3F,MAAM,SAAS,GAAwB;QACrC,MAAM;QACN,IAAI,IAAI;YACN,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,IAAI,KAAK,EAAE,CAAC;gBACV,kEAAkE;gBAClE,OAAO,CAAC,KAAK,CACX,IAAI,UAAU,CAAC,UAAU,qBAAqB;oBAC5C,SAAS,MAAM,CAAC,IAAI,IAAI,SAAS,aAAa,UAAU,CAAC,OAAO,GAAG,CACtE,CAAC;YACJ,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QACD,MAAM;YACJ,OAAO,MAAM,CAAC,YAAY,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;IAEF,OAAO,SAAc,CAAC;AACxB,CAAC;AA8DD,SAAS,QAAQ,CAAI,GAAoB;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA6B;IAa7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CACb,uCAAuC,IAAI,CAAC,aAAa,qCAAqC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACrH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAc,CAAC;IAE3C,IAAI,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;QAAE,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC7D,IAAI,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC;QACrE,YAAY,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACzE,YAAY,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC;QAAE,YAAY,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC3E,IAAI,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC;QAAE,YAAY,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAErE,OAAO;QACL,OAAO;QACP,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC;AACJ,CAAC;AAcD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,MAAM,IAAI,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAErD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO;gBACP,IAAI,EAAE,4FAA4F;aACnG,CAAC;QACJ,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,IAAI,GAAG,GAAG,YAAY,yBAAyB,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7E,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO;gBACP,IAAI,EAAE,IAAI,IAAI,wGAAwG;aACvH,CAAC;QACJ,CAAC;QACD,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACnC,KAAK,UAAU;YACb,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,OAAO;gBACP,IAAI,EAAE,6FAA6F;aACpG,CAAC;QACJ,KAAK,OAAO,CAAC;QACb;YACE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACxC,CAAC;AACH,CAAC"}