@wootsup/yt-builder-mcp 1.11.0 → 2.0.0

package/dist/net/public-fetch.js

@@ -0,0 +1,143 @@
+import { redirectSafeFetch, RedirectBlockedError } from './redirect-safe-fetch.js';
+import { DEFAULT_EXCERPT_CHARS, DEFAULT_TIMEOUT_MS, countOccurrences, makeExcerpt, readBodyCapped, readCacheReport, readTitle, } from './public-page-report.js';
+export { DEFAULT_EXCERPT_CHARS, DEFAULT_TIMEOUT_MS, MAX_BODY_BYTES, MAX_EXCERPT_CHARS, makeExcerpt, readCacheReport, } from './public-page-report.js';
+function originOf(rawUrl) {
+    try {
+        const parsed = new URL(rawUrl);
+        return parsed.origin === 'null' ? null : parsed.origin;
+    }
+    catch {
+        return null;
+    }
+}
+export function checkSameSiteUrl(requestedUrl, configuredSiteUrl) {
+    const siteOrigin = originOf(configuredSiteUrl);
+    let parsed;
+    try {
+        parsed = new URL(requestedUrl);
+    }
+    catch {
+        return {
+            ok: false,
+            code: 'invalid_url',
+            siteOrigin,
+            message: `"${requestedUrl}" is not an absolute URL. Pass the full address including ` +
+                'scheme and host, exactly as `frontend_url` reports it.',
+        };
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        return {
+            ok: false,
+            code: 'unsupported_scheme',
+            siteOrigin,
+            message: `Only http and https addresses are fetched; "${parsed.protocol}" is refused.`,
+        };
+    }
+    if (parsed.username !== '' || parsed.password !== '') {
+        return {
+            ok: false,
+            code: 'credentials_in_url',
+            siteOrigin,
+            message: 'The address carries credentials (user:pass@host). A public page never needs ' +
+                'them, and an address in that shape reads as one host while addressing another.',
+        };
+    }
+    if (siteOrigin === null) {
+        return {
+            ok: false,
+            code: 'foreign_origin',
+            siteOrigin: null,
+            message: `This site's configured connection ("${configuredSiteUrl}") does not parse as a ` +
+                'URL, so no address can be proven to belong to it. Every address is refused ' +
+                'until the connection is fixed.',
+        };
+    }
+    if (parsed.origin !== siteOrigin) {
+        return {
+            ok: false,
+            code: 'foreign_origin',
+            siteOrigin,
+            message: `Refused: this tool only fetches addresses on the configured site (${siteOrigin}). ` +
+                `The address given is on ${parsed.origin}. Fetching an arbitrary address from ` +
+                'here would make this an open proxy, so the restriction is not overridable.',
+        };
+    }
+    return { ok: true, url: parsed, siteOrigin };
+}
+function anonymousHeaders() {
+    return {
+        accept: 'text/html,application/xhtml+xml',
+        'accept-language': '*',
+        'user-agent': 'yt-builder-mcp public-view check (anonymous)',
+    };
+}
+export async function fetchPublicPage(input) {
+    const check = checkSameSiteUrl(input.requestedUrl, input.configuredSiteUrl);
+    if (!check.ok) {
+        return { outcome: 'refused', code: check.code, message: check.message, siteOrigin: check.siteOrigin };
+    }
+    const doFetch = input.fetchImpl ?? redirectSafeFetch;
+    const timeoutMs = input.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timer = setTimeout(() => { controller.abort(); }, timeoutMs);
+    const startedAt = Date.now();
+    try {
+        const response = await doFetch(check.url.href, {
+            method: 'GET',
+            headers: anonymousHeaders(),
+            credentials: 'omit',
+            signal: controller.signal,
+        });
+        const { body, bytes, complete } = await readBodyCapped(response);
+        const elapsedMs = Date.now() - startedAt;
+        const expect = input.expect;
+        const occurrences = expect === undefined || expect === '' ? null : countOccurrences(body, expect);
+        const matchIndex = expect === undefined || expect === '' ? null : body.indexOf(expect);
+        return {
+            outcome: 'delivered',
+            siteOrigin: check.siteOrigin,
+            httpStatus: response.status,
+            ok: response.status >= 200 && response.status < 300,
+            contentType: response.headers.get('content-type'),
+            htmlBytes: bytes,
+            bodyComplete: complete,
+            title: readTitle(body),
+            excerpt: makeExcerpt(body, input.excerptChars ?? DEFAULT_EXCERPT_CHARS, matchIndex === -1 ? null : matchIndex),
+            expectFound: occurrences === null ? null : occurrences > 0,
+            expectOccurrences: occurrences,
+            cache: readCacheReport(response.headers),
+            elapsedMs,
+        };
+    }
+    catch (err) {
+        if (err instanceof RedirectBlockedError) {
+            return {
+                outcome: 'failed',
+                code: 'redirect_off_site',
+                siteOrigin: check.siteOrigin,
+                redirectTarget: err.to,
+                message: `The site answered a redirect to ${err.to}, which is not on ${check.siteOrigin}. ` +
+                    'It was NOT followed: following a redirect off the configured site is how an ' +
+                    'address gate gets bypassed. Fetch that address directly if it is genuinely yours.',
+            };
+        }
+        if (controller.signal.aborted) {
+            return {
+                outcome: 'failed',
+                code: 'timeout',
+                siteOrigin: check.siteOrigin,
+                message: `No answer within ${String(timeoutMs)} ms. The page may be slow to build, or unreachable from here.`,
+            };
+        }
+        return {
+            outcome: 'failed',
+            code: 'network_error',
+            siteOrigin: check.siteOrigin,
+            message: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=public-fetch.js.map

package/dist/net/public-fetch.js.map

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

package/dist/net/public-page-report.d.ts

@@ -0,0 +1,26 @@
+export declare const DEFAULT_EXCERPT_CHARS = 800;
+export declare const MAX_EXCERPT_CHARS = 4000;
+export declare const MAX_BODY_BYTES = 5000000;
+export declare const DEFAULT_TIMEOUT_MS = 15000;
+export type CacheVerdict = 'hit' | 'miss' | 'bypass' | 'unknown';
+export interface CacheReport {
+    readonly verdict: CacheVerdict;
+    readonly headers: Record<string, string>;
+    readonly note: string;
+}
+export declare function readCacheReport(headers: Headers): CacheReport;
+export interface ExcerptResult {
+    readonly text: string;
+    readonly from: 'match' | 'start';
+    readonly truncated: boolean;
+    readonly startIndex: number;
+}
+export declare function makeExcerpt(body: string, maxChars: number, matchIndex: number | null): ExcerptResult;
+export declare function countOccurrences(hay: string, needle: string): number;
+export declare function readTitle(body: string): string | null;
+export declare function readBodyCapped(response: Response): Promise<{
+    readonly body: string;
+    readonly bytes: number;
+    readonly complete: boolean;
+}>;
+//# sourceMappingURL=public-page-report.d.ts.map

package/dist/net/public-page-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-page-report.d.ts","sourceRoot":"","sources":["../../src/net/public-page-report.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAWzC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAUtC,eAAO,MAAM,cAAc,UAAY,CAAC;AAGxC,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAmBzC,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAkDD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAiD7D;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAEjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B;AAUD,wBAAgB,WAAW,CACvB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,IAAI,GAC1B,aAAa,CAWf;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUpE;AAGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMrD;AASD,wBAAsB,cAAc,CAChC,QAAQ,EAAE,QAAQ,GACnB,OAAO,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CA6BxF"}

package/dist/net/public-page-report.js

@@ -0,0 +1,145 @@
+export const DEFAULT_EXCERPT_CHARS = 800;
+export const MAX_EXCERPT_CHARS = 4000;
+export const MAX_BODY_BYTES = 5_000_000;
+export const DEFAULT_TIMEOUT_MS = 15_000;
+const CACHE_HEADERS = [
+    'age',
+    'cache-control',
+    'cdn-cache-control',
+    'cf-cache-status',
+    'x-cache',
+    'x-cache-status',
+    'x-litespeed-cache',
+    'x-proxy-cache',
+    'x-nginx-cache',
+    'x-fastcgi-cache',
+    'x-varnish',
+    'via',
+];
+const STATUS_HEADERS = [
+    'cf-cache-status',
+    'x-cache',
+    'x-cache-status',
+    'x-litespeed-cache',
+    'x-proxy-cache',
+    'x-nginx-cache',
+    'x-fastcgi-cache',
+];
+export function readCacheReport(headers) {
+    const present = {};
+    for (const name of CACHE_HEADERS) {
+        const value = headers.get(name);
+        if (value !== null && value !== '')
+            present[name] = value;
+    }
+    let verdict = 'unknown';
+    for (const name of STATUS_HEADERS) {
+        const value = present[name]?.toLowerCase();
+        if (value === undefined)
+            continue;
+        if (value.includes('hit')) {
+            verdict = 'hit';
+            break;
+        }
+        if (value.includes('bypass') || value.includes('dynamic')) {
+            verdict = 'bypass';
+            break;
+        }
+        if (value.includes('miss') || value.includes('expired')) {
+            verdict = 'miss';
+            break;
+        }
+    }
+    if (verdict === 'unknown') {
+        const age = Number.parseInt(present['age'] ?? '', 10);
+        if (Number.isFinite(age) && age > 0)
+            verdict = 'hit';
+    }
+    const control = (present['cache-control'] ?? '').toLowerCase();
+    const forbidsStoring = ['no-store', 'no-cache', 'private'].filter((d) => control.includes(d));
+    const note = verdict === 'unknown'
+        ? 'No cache-status header was sent. That is NOT proof the answer was uncached — '
+            + 'most origins and some proxies send nothing. Treat it as "cannot tell", and do '
+            + 'not spend a second fetch on it: a request-side Cache-Control: no-cache does not '
+            + 'make a CDN step aside, and a cache-busting query fetches a different URL than '
+            + 'the visitor asks for. To rule a cache out, purge it and fetch again.'
+            + (forbidsStoring.length > 0
+                ? ` This origin's own Cache-Control says ${forbidsStoring.join(', ')}, so it `
+                    + 'asks not to be stored — that is a request to intermediaries, not a report '
+                    + 'from one, and a cache ignoring it would look exactly like this.'
+                : '')
+        : verdict === 'hit'
+            ? 'A cache served this answer. It may predate the change being verified — purge '
+                + 'the page/CDN cache and fetch again before concluding anything.'
+            : verdict === 'miss'
+                ? 'A cache was consulted and did not have it, so this answer came from the origin.'
+                : 'A cache was in the path and deliberately skipped, so this came from the origin.';
+    return { verdict, headers: present, note };
+}
+export function makeExcerpt(body, maxChars, matchIndex) {
+    const cap = Math.max(1, Math.min(maxChars, MAX_EXCERPT_CHARS));
+    if (body.length <= cap) {
+        return { text: body, from: matchIndex === null ? 'start' : 'match', truncated: false, startIndex: 0 };
+    }
+    if (matchIndex === null) {
+        return { text: body.slice(0, cap), from: 'start', truncated: true, startIndex: 0 };
+    }
+    const half = Math.floor(cap / 2);
+    const start = Math.max(0, Math.min(matchIndex - half, body.length - cap));
+    return { text: body.slice(start, start + cap), from: 'match', truncated: true, startIndex: start };
+}
+export function countOccurrences(hay, needle) {
+    if (needle === '')
+        return 0;
+    let n = 0;
+    let from = 0;
+    for (;;) {
+        const i = hay.indexOf(needle, from);
+        if (i === -1)
+            return n;
+        n += 1;
+        from = i + needle.length;
+    }
+}
+export function readTitle(body) {
+    const m = /<title[^>]*>([\s\S]{0,300}?)<\/title>/i.exec(body);
+    const raw = m?.[1];
+    if (raw === undefined)
+        return null;
+    const text = raw.replace(/\s+/g, ' ').trim();
+    return text === '' ? null : text;
+}
+export async function readBodyCapped(response) {
+    const stream = response.body;
+    if (stream === null) {
+        const body = await response.text();
+        const bytes = Buffer.byteLength(body, 'utf-8');
+        return { body, bytes, complete: bytes <= MAX_BODY_BYTES };
+    }
+    const chunks = [];
+    let bytes = 0;
+    let complete = true;
+    const reader = stream.getReader();
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value === undefined)
+                continue;
+            if (bytes + value.byteLength > MAX_BODY_BYTES) {
+                chunks.push(value.subarray(0, MAX_BODY_BYTES - bytes));
+                bytes = MAX_BODY_BYTES;
+                complete = false;
+                break;
+            }
+            chunks.push(value);
+            bytes += value.byteLength;
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+    }
+    return { body: Buffer.concat(chunks).toString('utf-8'), bytes, complete };
+}
+//# sourceMappingURL=public-page-report.js.map

package/dist/net/public-page-report.js.map

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

package/dist/net/redirect-safe-fetch.d.ts

@@ -0,0 +1,14 @@
+export declare const MAX_HOPS = 3;
+export declare class RedirectBlockedError extends Error {
+    readonly from: string;
+    readonly to: string;
+    readonly status: number;
+    constructor(params: {
+        from: string;
+        to: string;
+        status: number;
+    });
+}
+export declare function createRedirectSafeFetch(impl?: typeof fetch): typeof fetch;
+export declare const redirectSafeFetch: typeof fetch;
+//# sourceMappingURL=redirect-safe-fetch.d.ts.map

package/dist/net/redirect-safe-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-safe-fetch.d.ts","sourceRoot":"","sources":["../../src/net/redirect-safe-fetch.ts"],"names":[],"mappings":"AA+DA,eAAO,MAAM,QAAQ,IAAI,CAAC;AAS1B,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAanE;AAwBD,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,GAAG,OAAO,KAAK,CAuDzE;AAMD,eAAO,MAAM,iBAAiB,EAAE,OAAO,KAAiC,CAAC"}

package/dist/net/redirect-safe-fetch.js

@@ -0,0 +1,61 @@
+export const MAX_HOPS = 3;
+export class RedirectBlockedError extends Error {
+    from;
+    to;
+    status;
+    constructor(params) {
+        super(`Diese Website leitet weiter: ${params.from} → ${params.to} (HTTP ${params.status}). ` +
+            'Der Zugangsschlüssel wurde NICHT gesendet, weil Browser und Node den ' +
+            'Authorization-Header bei einer Weiterleitung auf einen anderen Origin ' +
+            'verwerfen — deshalb meldet der Server "Authorization header is required", ' +
+            `obwohl der Schlüssel stimmt. Konfiguriere stattdessen genau: ${params.to}`);
+        this.name = 'RedirectBlockedError';
+        this.from = params.from;
+        this.to = params.to;
+        this.status = params.status;
+    }
+}
+function isSameOrigin(current, next) {
+    return current.protocol === next.protocol && current.host === next.host;
+}
+function isSchemeUpgrade(current, next) {
+    return current.protocol === 'http:' && next.protocol === 'https:' && current.host === next.host;
+}
+const REDIRECT_STATUS = new Set([301, 302, 303, 307, 308]);
+export function createRedirectSafeFetch(impl) {
+    const base = impl ?? ((input, init) => globalThis.fetch(input, init));
+    return async function redirectSafeFetch(input, init) {
+        let currentUrl = new URL(typeof input === 'string' ? input : input instanceof URL ? input.href : input.url);
+        let currentInit = { ...(init ?? {}), redirect: 'manual' };
+        for (let hop = 0; hop <= MAX_HOPS; hop++) {
+            const response = await base(currentUrl.href, currentInit);
+            if (!REDIRECT_STATUS.has(response.status)) {
+                return response;
+            }
+            const location = response.headers.get('location');
+            if (location === null || location === '') {
+                return response;
+            }
+            const next = new URL(location, currentUrl);
+            if (!isSameOrigin(currentUrl, next) && !isSchemeUpgrade(currentUrl, next)) {
+                throw new RedirectBlockedError({
+                    from: currentUrl.href,
+                    to: next.href,
+                    status: response.status,
+                });
+            }
+            const method = (currentInit.method ?? 'GET').toUpperCase();
+            if (response.status === 303 || ((response.status === 301 || response.status === 302) && method === 'POST')) {
+                currentInit = { ...currentInit, method: 'GET', body: undefined };
+            }
+            currentUrl = next;
+        }
+        throw new RedirectBlockedError({
+            from: currentUrl.href,
+            to: currentUrl.href,
+            status: 310,
+        });
+    };
+}
+export const redirectSafeFetch = createRedirectSafeFetch();
+//# sourceMappingURL=redirect-safe-fetch.js.map

package/dist/net/redirect-safe-fetch.js.map

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

package/dist/net/session-recovery-fetch.d.ts

@@ -0,0 +1,7 @@
+export declare const SESSION_NOT_FOUND_CODE = -32005;
+export interface SessionRecoveryOptions {
+    readonly inner?: typeof fetch;
+    readonly onRecovery?: (outcome: 'recovered' | 'handshake-failed' | 'retry-failed') => void;
+}
+export declare function createSessionRecoveryFetch(opts?: SessionRecoveryOptions): typeof fetch;
+//# sourceMappingURL=session-recovery-fetch.d.ts.map

package/dist/net/session-recovery-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-recovery-fetch.d.ts","sourceRoot":"","sources":["../../src/net/session-recovery-fetch.ts"],"names":[],"mappings":"AAwEA,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAuB7C,MAAM,WAAW,sBAAsB;IAInC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAM9B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,kBAAkB,GAAG,cAAc,KAAK,IAAI,CAAC;CAC9F;AAgFD,wBAAgB,0BAA0B,CAAC,IAAI,GAAE,sBAA2B,GAAG,OAAO,KAAK,CAkG1F"}

package/dist/net/session-recovery-fetch.js

@@ -0,0 +1,139 @@
+import { LATEST_PROTOCOL_VERSION } from '@modelcontextprotocol/sdk/types.js';
+import { PACKAGE_VERSION } from '../package-version.js';
+import { redirectSafeFetch } from './redirect-safe-fetch.js';
+export const SESSION_NOT_FOUND_CODE = -32005;
+const SESSION_NOT_FOUND_STATUS = 404;
+const SESSION_HEADER = 'mcp-session-id';
+const PROTOCOL_HEADER = 'mcp-protocol-version';
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function methodOfBody(body) {
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        return null;
+    }
+    if (!isRecord(parsed))
+        return null;
+    return typeof parsed.method === 'string' ? parsed.method : null;
+}
+function reportsSessionLoss(body) {
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        return false;
+    }
+    if (!isRecord(parsed))
+        return false;
+    const error = parsed.error;
+    return isRecord(error) && error.code === SESSION_NOT_FOUND_CODE;
+}
+function replayable(init) {
+    if (init === undefined)
+        return null;
+    const { body } = init;
+    if (typeof body !== 'string')
+        return null;
+    return { headers: new Headers(init.headers), body, method: methodOfBody(body) };
+}
+function urlOf(input) {
+    if (typeof input === 'string')
+        return input;
+    if (input instanceof URL)
+        return input.href;
+    return input.url;
+}
+function withSessionHeader(response, sessionId) {
+    const headers = new Headers(response.headers);
+    headers.set(SESSION_HEADER, sessionId);
+    const bodyless = response.status === 204 || response.status === 205;
+    return new Response(bodyless ? null : response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}
+export function createSessionRecoveryFetch(opts = {}) {
+    const inner = opts.inner ?? redirectSafeFetch;
+    const { onRecovery } = opts;
+    let sessionId = null;
+    let generation = 0;
+    let inFlight = null;
+    let handshakeCount = 0;
+    async function handshake(input, replay, signal) {
+        const headers = new Headers(replay.headers);
+        headers.delete(SESSION_HEADER);
+        headers.set('content-type', 'application/json');
+        headers.set('accept', 'application/json, text/event-stream');
+        handshakeCount += 1;
+        const body = JSON.stringify({
+            jsonrpc: '2.0',
+            id: `ytb-session-recovery-${handshakeCount}`,
+            method: 'initialize',
+            params: {
+                protocolVersion: replay.headers.get(PROTOCOL_HEADER) ?? LATEST_PROTOCOL_VERSION,
+                capabilities: {},
+                clientInfo: { name: '@wootsup/yt-builder-mcp', version: PACKAGE_VERSION },
+            },
+        });
+        const response = await inner(urlOf(input), {
+            method: 'POST',
+            headers,
+            body,
+            ...(signal !== null && signal !== undefined ? { signal } : {}),
+        });
+        await response.body?.cancel().catch(() => undefined);
+        if (!response.ok)
+            return null;
+        const fresh = response.headers.get(SESSION_HEADER);
+        if (fresh === null || fresh === '')
+            return null;
+        sessionId = fresh;
+        generation += 1;
+        return fresh;
+    }
+    async function freshSession(seenGeneration, input, replay, signal) {
+        if (generation > seenGeneration && sessionId !== null)
+            return sessionId;
+        const pending = inFlight
+            ?? (inFlight = handshake(input, replay, signal).finally(() => {
+                inFlight = null;
+            }));
+        return await pending;
+    }
+    return async function sessionRecoveryFetch(input, init) {
+        const seenGeneration = generation;
+        const response = await inner(input, init);
+        if (response.status !== SESSION_NOT_FOUND_STATUS)
+            return response;
+        const peeked = await response
+            .clone()
+            .text()
+            .catch(() => null);
+        if (peeked === null || !reportsSessionLoss(peeked))
+            return response;
+        const replay = replayable(init);
+        if (replay === null || replay.method === 'initialize')
+            return response;
+        const fresh = await freshSession(seenGeneration, input, replay, init?.signal);
+        if (fresh === null) {
+            onRecovery?.('handshake-failed');
+            return response;
+        }
+        const headers = new Headers(replay.headers);
+        headers.set(SESSION_HEADER, fresh);
+        const retried = await inner(input, { ...init, headers, body: replay.body });
+        if (!retried.ok) {
+            onRecovery?.('retry-failed');
+            return retried;
+        }
+        onRecovery?.('recovered');
+        return withSessionHeader(retried, fresh);
+    };
+}
+//# sourceMappingURL=session-recovery-fetch.js.map

package/dist/net/session-recovery-fetch.js.map

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