@fouradata/mcp 0.2.11

package/dist/tools/browser.js

@@ -0,0 +1,316 @@
+import { request } from "undici";
+import { z } from "zod";
+import { getApiKey } from "../auth.js";
+import { assertPublicTarget, SsrfBlockedError } from "../safe-target.js";
+import { storePayload, THRESHOLD_BYTES } from "../resources.js";
+function extractContentTypeFromObject(headers) {
+    if (!headers || typeof headers !== "object")
+        return null;
+    for (const [k, v] of Object.entries(headers)) {
+        if (k.toLowerCase() === "content-type") {
+            const value = Array.isArray(v) ? v[0] : v;
+            if (typeof value === "string")
+                return value.split(";")[0]?.trim() ?? null;
+        }
+    }
+    return null;
+}
+function deriveCode(status, envelope) {
+    if (status === 400)
+        return "bad_request";
+    if (status === 401)
+        return "auth_failed";
+    if (status === 403)
+        return "forbidden";
+    if (status === 404)
+        return "not_found";
+    if (status === 429)
+        return "rate_limited";
+    if (status === 503) {
+        if (envelope.current)
+            return "at_capacity";
+        const err = typeof envelope.error === "string" ? envelope.error : "";
+        if (err.toLowerCase().includes("disabled"))
+            return "service_disabled";
+        return "service_unavailable";
+    }
+    if (status >= 500)
+        return "upstream_error";
+    if (status >= 400)
+        return "upstream_client_error";
+    return "upstream_unknown";
+}
+async function guardHandler(service, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+outputSchema, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+fn) {
+    try {
+        const result = await fn();
+        if (result?.structuredContent) {
+            const parsed = outputSchema.safeParse(result.structuredContent);
+            if (!parsed.success) {
+                const issues = parsed.error.issues.slice(0, 5).map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `FourA ${service} — upstream response failed schema: ${issues}` }],
+                    structuredContent: {
+                        service,
+                        code: "output_validation_failed",
+                        error: `Upstream response did not match the expected schema: ${issues}`,
+                    },
+                };
+            }
+        }
+        return result;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            isError: true,
+            content: [{ type: "text", text: `FourA ${service} — internal error: ${msg}` }],
+            structuredContent: {
+                service,
+                code: "output_validation_failed",
+                error: `Tool handler crashed before producing a response: ${msg}`,
+            },
+        };
+    }
+}
+const BROWSER_API_URL = (process.env.FOURA_API_BASE ?? "https://api.foura.ai/api") + "/browser/";
+const BrowserCookieInputSchema = z.object({
+    name: z.string(),
+    value: z.string(),
+    domain: z.string().optional(),
+});
+// Full CDP cookie object — captured from Chrome via Network.getAllCookies after navigation.
+// Permissive — Protocol.Network.Cookie has more fields than we model, and CDP versions vary.
+const CdpCookieSchema = z
+    .object({
+    name: z.string(),
+    value: z.string(),
+    domain: z.string().optional(),
+    path: z.string().optional(),
+    expires: z.number().optional(),
+    size: z.number().optional(),
+    httpOnly: z.boolean().optional(),
+    secure: z.boolean().optional(),
+    session: z.boolean().optional(),
+    sameSite: z.string().optional(),
+})
+    .catchall(z.unknown());
+const browserOutputShape = {
+    // Success — dwstack browser DwResponse (packages/browser/src/schema.ts:19-26)
+    status: z.number().int().optional().describe("HTTP status code from the target page. `0` indicates the navigation failed before any HTTP response (DNS / connection refused / timeout) — check the `error` field for the underlying reason."),
+    // CDP headers (Protocol.Network.Headers) are a Record but values can be
+    // string OR string[] in some CDP versions. Bug 11 fix — permissive.
+    headers: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("Response headers as a flat key-value object. Values are typically strings but may be arrays for repeated headers."),
+    // body: string | object in upstream (browser/src/schema.ts:25). Bug 7 fix.
+    body: z
+        .union([z.string(), z.record(z.string(), z.unknown())])
+        .optional()
+        .describe("Fully-rendered page content. String HTML when content-type is HTML; object when the page returned JSON and it was auto-parsed. Field is named `body`, not `data`. Omitted when offloaded."),
+    cookies: z.array(CdpCookieSchema).optional().describe("Full cookie objects collected after navigation (name, value, domain, path, expires, httpOnly, secure, session, sameSite, …)"),
+    userAgent: z.string().optional().describe("The User-Agent the browser session presented"),
+    // Offload path — MCP layer adds these when body >= 50KB AND offload_large=true
+    offloaded_resource_uri: z.string().optional().describe("foura-mcp://payload/<uuid>"),
+    size_bytes: z.number().int().optional().describe("Total offloaded body size in bytes"),
+    // Error path
+    error: z.string().optional().describe("Human-readable error message"),
+    service: z.enum(["single", "proxy", "browser", "api"]).optional(),
+    retryAfter: z.number().optional(),
+    current: z
+        .object({ concurrency: z.number().optional(), rpm: z.number().optional() })
+        .optional(),
+    limits: z
+        .object({ maxConcurrency: z.number().optional(), maxRpm: z.number().optional() })
+        .optional(),
+    code: z.string().optional().describe("Stable error code for retry classification. One of: ssrf_blocked, upstream_non_json, output_validation_failed, bad_request (400), auth_failed (401), forbidden (403), not_found (404), rate_limited (429), at_capacity (503), service_disabled (503), service_unavailable (503), upstream_error (>=500), upstream_client_error (other 4xx), upstream_unknown (defensive)."),
+};
+const browserInputShape = {
+    url: z.string().url().describe("Target URL to load in a full browser session. Public hosts only — private/reserved ranges (RFC 1918 + loopback + link-local + IPv6 ULA/loopback + *.local mDNS) are refused with code `ssrf_blocked`. Example: https://shop.example.com/product/123 or any single-page-app URL."),
+    headers: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe("Custom HTTP headers as a key-value object (NOT [name, value] tuples). Example: {\"Referer\": \"https://google.com/\"}"),
+    cookies: z
+        .array(BrowserCookieInputSchema)
+        .optional()
+        .describe("Cookies to set before navigation: [{ name, value, domain? }]"),
+    userAgent: z.string().optional().describe("Override the browser's User-Agent string"),
+    proxy: z
+        .string()
+        .optional()
+        .describe("Optional proxy. Three forms: (1) URL `http://user:pass@host:port` or `socks5://host:port`; " +
+        "(2) base36 ID from foura_proxy (e.g. `4DZ3VE`) — same pool exit IP; (3) omit → fixed container egress."),
+    timeout_ms: z
+        .number()
+        .int()
+        .min(0)
+        .max(120_000)
+        .optional()
+        .describe("Page load timeout in ms (default 30000, max 120000)"),
+    checkStatus: z
+        .number()
+        .int()
+        .optional()
+        .describe("Expected HTTP status code. If the page returns a different status → tool returns an error envelope with the actual status carried in the envelope. Example: 200 for product pages, or 404 to assert a soft-404 didn't leak through."),
+    checkText: z
+        .string()
+        .optional()
+        .describe("One-shot post-render validator — substring search on the rendered HTML AFTER navigation completes. NOT a waiter: does not poll, does not block until the substring appears. If the substring is missing, the tool returns an error envelope. Use to catch silent failures like a 200 response that captured a challenge page or empty SPA shell. Example: \"add to cart\" for product pages."),
+    // Bug 3 fix — opt-in offload, default false (inline).
+    offload_large: z
+        .boolean()
+        .optional()
+        .describe("If true, response bodies >= 50KB are written to disk and returned as a resource_link instead of inlined. Default false."),
+};
+export function registerBrowserTool(server) {
+    server.registerTool("foura_browser", {
+        title: "FourA — full browser navigation",
+        description: "Load a URL in a real browser session. JS runs, DOM renders, cookies come back. 2–10s. " +
+            "Use for SPAs, lazy-loaded content, or JS anti-bot challenges (Cloudflare Turnstile etc.). " +
+            "Prefer foura_single for static HTML; foura_proxy for static pages where your IP is blocked. " +
+            "To rotate the browser's exit IP: call foura_proxy first, pass its returned `proxy` ID into " +
+            "this tool's `proxy` field — the browser exits through that pool IP. Default (no `proxy`) " +
+            "is one fixed container egress. If the target is behind a tier-1 WAF challenge (Vercel / " +
+            "Cloudflare / Akamai), calling this tool directly will usually still capture the challenge " +
+            "page rather than the post-challenge content — the snapshot fires before the challenge's " +
+            "deferred reload completes. Correct chain: call foura_proxy first with maxTries:25-30 against " +
+            "the same URL → take the returned proxy base36 ID → pass it into this tool's `proxy` field. " +
+            "The browser then exits through the IP that already cleared the challenge for this target. " +
+            "No `unblocker` flag — browser navigation already sends real browser headers by default, so " +
+            "the flag would be redundant.",
+        inputSchema: browserInputShape,
+        outputSchema: browserOutputShape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, async (input) => guardHandler("browser", z.object(browserOutputShape), async () => {
+        try {
+            await assertPublicTarget(input.url);
+        }
+        catch (e) {
+            if (e instanceof SsrfBlockedError) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: e.message }],
+                    structuredContent: { service: "browser", code: "ssrf_blocked", error: e.message },
+                };
+            }
+            throw e;
+        }
+        const { offload_large, ...upstreamBody } = input;
+        const res = await request(BROWSER_API_URL, {
+            method: "POST",
+            headers: {
+                "X-API-Key": getApiKey(),
+                "Content-Type": "application/json",
+                "User-Agent": "foura-mcp/0.2.11 (browser)",
+            },
+            body: JSON.stringify(upstreamBody),
+        });
+        const text = await res.body.text();
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `FourA browser — non-JSON response (${res.statusCode}): ${text.slice(0, 200)}`,
+                    },
+                ],
+                structuredContent: {
+                    service: "browser",
+                    code: "upstream_non_json",
+                    status: res.statusCode,
+                    error: `Upstream returned non-JSON (${res.statusCode}): ${text.slice(0, 200)}`,
+                },
+            };
+        }
+        if (res.statusCode < 200 || res.statusCode >= 300) {
+            const e = parsed;
+            const errMsg = typeof e.error === "string" ? e.error : "Unknown";
+            const retryStr = typeof e.retryAfter === "number" ? ` · retry ${e.retryAfter}s` : "";
+            return {
+                isError: true,
+                content: [{ type: "text", text: `FourA browser error ${res.statusCode}: ${errMsg}${retryStr}` }],
+                structuredContent: {
+                    ...e,
+                    service: "browser",
+                    code: deriveCode(res.statusCode, e),
+                    status: typeof e.status === "number" ? e.status : res.statusCode,
+                },
+            };
+        }
+        const parsedObj = parsed;
+        // Bug 8 fix — browser request.ts also rejects with DwResponseError on
+        // page failure (timeout, navigation error, checkStatus mismatch).
+        // Service forwards as 200 + {error, ...} via dwRequestToExpressRes.
+        if (typeof parsedObj.error === "string" && parsedObj.error.length > 0) {
+            const innerStatus = typeof parsedObj.status === "number" ? parsedObj.status : 0;
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `FourA browser — page failure (status ${innerStatus}): ${parsedObj.error}`,
+                    },
+                ],
+                structuredContent: {
+                    ...parsedObj,
+                    service: "browser",
+                    code: innerStatus > 0
+                        ? deriveCode(innerStatus, parsedObj)
+                        : "upstream_error",
+                    status: innerStatus,
+                },
+            };
+        }
+        const body = parsedObj.body;
+        let bodyStr = null;
+        if (typeof body === "string")
+            bodyStr = body;
+        else if (body && typeof body === "object")
+            bodyStr = JSON.stringify(body);
+        const statusLabel = parsedObj.status ?? "?";
+        const shouldOffload = offload_large === true
+            && bodyStr
+            && Buffer.byteLength(bodyStr, "utf8") >= THRESHOLD_BYTES;
+        if (shouldOffload && bodyStr) {
+            const ct = extractContentTypeFromObject(parsedObj.headers) ?? "text/html";
+            const stored = await storePayload(bodyStr, ct, "rendered-page.html");
+            const sizeKb = (stored.size / 1024).toFixed(1);
+            return {
+                content: [
+                    { type: "text", text: `${statusLabel} · rendered ${sizeKb} KB offloaded` },
+                    { type: "resource_link", uri: stored.uri, name: stored.name, mimeType: stored.mimeType },
+                ],
+                structuredContent: {
+                    status: parsedObj.status,
+                    headers: parsedObj.headers,
+                    cookies: Array.isArray(parsedObj.cookies) ? parsedObj.cookies : undefined,
+                    userAgent: parsedObj.userAgent,
+                    offloaded_resource_uri: stored.uri,
+                    size_bytes: stored.size,
+                },
+            };
+        }
+        const sizeKb = bodyStr ? (Buffer.byteLength(bodyStr, "utf8") / 1024).toFixed(1) : "0";
+        return {
+            content: [{ type: "text", text: `${statusLabel} OK · ${sizeKb} KB rendered` }],
+            structuredContent: parsedObj,
+        };
+    }));
+}
+export const __test = { deriveCode, CdpCookieSchema, BrowserCookieInputSchema, browserInputShape, browserOutputShape };
+//# sourceMappingURL=browser.js.map

package/dist/tools/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/tools/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEhE,SAAS,4BAA4B,CAAC,OAAgB;IACpD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,cAAc,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,MAAc,EAAE,QAAiC;IACnE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,aAAa,CAAC;IACzC,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,aAAa,CAAC;IACzC,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,WAAW,CAAC;IACvC,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,WAAW,CAAC;IACvC,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,cAAc,CAAC;IAC1C,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,IAAI,QAAQ,CAAC,OAAO;YAAE,OAAO,aAAa,CAAC;QAC3C,MAAM,GAAG,GAAG,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,OAAO,kBAAkB,CAAC;QACtE,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,gBAAgB,CAAC;IAC3C,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,uBAAuB,CAAC;IAClD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,OAAuC;AACvC,8DAA8D;AAC9D,YAA8B;AAC9B,8DAA8D;AAC9D,EAAsB;IAGtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,IAAI,MAAM,EAAE,iBAAiB,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAChE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACvD,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,uCAAuC,MAAM,EAAE,EAAE,CAAC;oBAClG,iBAAiB,EAAE;wBACjB,OAAO;wBACP,IAAI,EAAE,0BAA0B;wBAChC,KAAK,EAAE,wDAAwD,MAAM,EAAE;qBACxE;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,sBAAsB,GAAG,EAAE,EAAE,CAAC;YAC9E,iBAAiB,EAAE;gBACjB,OAAO;gBACP,IAAI,EAAE,0BAA0B;gBAChC,KAAK,EAAE,qDAAqD,GAAG,EAAE;aAClE;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,eAAe,GACnB,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,0BAA0B,CAAC,GAAG,WAAW,CAAC;AAE3E,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,4FAA4F;AAC5F,6FAA6F;AAC7F,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC;KACD,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAEzB,MAAM,kBAAkB,GAAG;IACzB,8EAA8E;IAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+LAA+L,CAAC;IAC7O,wEAAwE;IACxE,oEAAoE;IACpE,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,mHAAmH,CAAC;IAChI,2EAA2E;IAC3E,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;SACtD,QAAQ,EAAE;SACV,QAAQ,CAAC,2LAA2L,CAAC;IACxM,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6HAA6H,CAAC;IACpL,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACzF,+EAA+E;IAC/E,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACpF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACtF,aAAa;IACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACrE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;SAC1E,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;SAChF,QAAQ,EAAE;IACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2WAA2W,CAAC;CAClZ,CAAC;AAEF,MAAM,iBAAiB,GAAG;IACxB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,iRAAiR,CAAC;IACjT,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,QAAQ,EAAE;SACV,QAAQ,CAAC,uHAAuH,CAAC;IACpI,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,wBAAwB,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACrF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6FAA6F;QAC7F,wGAAwG,CACzG;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,OAAO,CAAC;SACZ,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,qOAAqO,CAAC;IAClP,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8XAA8X,CAAC;IAC3Y,sDAAsD;IACtD,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,yHAAyH,CAAC;CACvI,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,wFAAwF;YACxF,4FAA4F;YAC5F,8FAA8F;YAC9F,6FAA6F;YAC7F,2FAA2F;YAC3F,0FAA0F;YAC1F,4FAA4F;YAC5F,0FAA0F;YAC1F,+FAA+F;YAC/F,6FAA6F;YAC7F,4FAA4F;YAC5F,6FAA6F;YAC7F,8BAA8B;QAChC,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,IAAI,EAAE;QAChF,IAAI,CAAC;YACH,MAAM,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,gBAAgB,EAAE,CAAC;gBAClC,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;oBAC5C,iBAAiB,EAAE,EAAE,OAAO,EAAE,SAAkB,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;iBAC3F,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;QAED,MAAM,EAAE,aAAa,EAAE,GAAG,YAAY,EAAE,GAAG,KAAK,CAAC;QAEjD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,eAAe,EAAE;YACzC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,WAAW,EAAE,SAAS,EAAE;gBACxB,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,4BAA4B;aAC3C;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;SACnC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sCAAsC,GAAG,CAAC,UAAU,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;qBACrF;iBACF;gBACD,iBAAiB,EAAE;oBACjB,OAAO,EAAE,SAAkB;oBAC3B,IAAI,EAAE,mBAAmB;oBACzB,MAAM,EAAE,GAAG,CAAC,UAAU;oBACtB,KAAK,EAAE,+BAA+B,GAAG,CAAC,UAAU,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;iBAC/E;aACF,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAClD,MAAM,CAAC,GAAG,MAAiC,CAAC;YAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACrF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,CAAC,UAAU,KAAK,MAAM,GAAG,QAAQ,EAAE,EAAE,CAAC;gBAChG,iBAAiB,EAAE;oBACjB,GAAG,CAAC;oBACJ,OAAO,EAAE,SAAkB;oBAC3B,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;oBACnC,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU;iBACjE;aACF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,MAOjB,CAAC;QAEF,sEAAsE;QACtE,kEAAkE;QAClE,oEAAoE;QACpE,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtE,MAAM,WAAW,GAAG,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAChF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,wCAAwC,WAAW,MAAM,SAAS,CAAC,KAAK,EAAE;qBACjF;iBACF;gBACD,iBAAiB,EAAE;oBACjB,GAAI,SAAqC;oBACzC,OAAO,EAAE,SAAkB;oBAC3B,IAAI,EAAE,WAAW,GAAG,CAAC;wBACnB,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,SAAoC,CAAC;wBAC/D,CAAC,CAAC,gBAAgB;oBACpB,MAAM,EAAE,WAAW;iBACpB;aACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;QAC5B,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,GAAG,IAAI,CAAC;aACxC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE1E,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC;QAE5C,MAAM,aAAa,GAAG,aAAa,KAAK,IAAI;eACvC,OAAO;eACP,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,eAAe,CAAC;QAE3D,IAAI,aAAa,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,4BAA4B,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC;YAC1E,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,EAAE,EAAE,oBAAoB,CAAC,CAAC;YACrE,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,eAAe,MAAM,eAAe,EAAE;oBAC1E,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;iBACzF;gBACD,iBAAiB,EAAE;oBACjB,MAAM,EAAE,SAAS,CAAC,MAAM;oBACxB,OAAO,EAAE,SAAS,CAAC,OAA8C;oBACjE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;oBACzE,SAAS,EAAE,SAAS,CAAC,SAAS;oBAC9B,sBAAsB,EAAE,MAAM,CAAC,GAAG;oBAClC,UAAU,EAAE,MAAM,CAAC,IAAI;iBACxB;aACF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACtF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,SAAS,MAAM,cAAc,EAAE,CAAC;YAC9E,iBAAiB,EAAE,SAAoC;SACxD,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,UAAU,EAAE,eAAe,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/tools/proxy.d.ts

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+declare function deriveCode(status: number, envelope: Record<string, unknown>): string;
+export declare function registerProxyTool(server: McpServer): void;
+export declare const __test: {
+    deriveCode: typeof deriveCode;
+    ProxyHeaderInfoSchema: z.ZodObject<{
+        result: z.ZodOptional<z.ZodObject<{
+            version: z.ZodOptional<z.ZodString>;
+            code: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+    ProxyInnerRequestSchema: z.ZodObject<{
+        method: z.ZodString;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>>>;
+        unblocker: z.ZodOptional<z.ZodBoolean>;
+        data: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        connect_timeout_ms: z.ZodOptional<z.ZodNumber>;
+        accept_timeout_ms: z.ZodOptional<z.ZodNumber>;
+        server_response_timeout_ms: z.ZodOptional<z.ZodNumber>;
+        dns_cache_timeout_sec: z.ZodOptional<z.ZodNumber>;
+        followRedirects: z.ZodOptional<z.ZodNumber>;
+        tryJsonData: z.ZodOptional<z.ZodBoolean>;
+        returnBuffer: z.ZodOptional<z.ZodBoolean>;
+        validate: z.ZodOptional<z.ZodObject<{
+            status: z.ZodOptional<z.ZodObject<{
+                accept: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                fail: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            }, z.core.$strip>>;
+            headers: z.ZodOptional<z.ZodObject<{
+                accept: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                fail: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>>;
+            data: z.ZodOptional<z.ZodObject<{
+                accept: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                fail: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    proxyInputShape: {
+        request: z.ZodObject<{
+            method: z.ZodString;
+            url: z.ZodString;
+            headers: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>>>;
+            unblocker: z.ZodOptional<z.ZodBoolean>;
+            data: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+            timeout_ms: z.ZodOptional<z.ZodNumber>;
+            connect_timeout_ms: z.ZodOptional<z.ZodNumber>;
+            accept_timeout_ms: z.ZodOptional<z.ZodNumber>;
+            server_response_timeout_ms: z.ZodOptional<z.ZodNumber>;
+            dns_cache_timeout_sec: z.ZodOptional<z.ZodNumber>;
+            followRedirects: z.ZodOptional<z.ZodNumber>;
+            tryJsonData: z.ZodOptional<z.ZodBoolean>;
+            returnBuffer: z.ZodOptional<z.ZodBoolean>;
+            validate: z.ZodOptional<z.ZodObject<{
+                status: z.ZodOptional<z.ZodObject<{
+                    accept: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                    fail: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                headers: z.ZodOptional<z.ZodObject<{
+                    accept: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    fail: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                }, z.core.$strip>>;
+                data: z.ZodOptional<z.ZodObject<{
+                    accept: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    fail: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        maxTries: z.ZodOptional<z.ZodNumber>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        ignoreProxies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        offload_large: z.ZodOptional<z.ZodBoolean>;
+    };
+    proxyOutputShape: {
+        status: z.ZodOptional<z.ZodNumber>;
+        headers: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+            result: z.ZodOptional<z.ZodObject<{
+                version: z.ZodOptional<z.ZodString>;
+                code: z.ZodOptional<z.ZodNumber>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>>, z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+        data: z.ZodOptional<z.ZodUnknown>;
+        total_time: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodNull]>>;
+        proxy: z.ZodOptional<z.ZodString>;
+        total: z.ZodOptional<z.ZodNumber>;
+        offloaded_resource_uri: z.ZodOptional<z.ZodString>;
+        size_bytes: z.ZodOptional<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+        service: z.ZodOptional<z.ZodEnum<{
+            single: "single";
+            proxy: "proxy";
+            browser: "browser";
+            api: "api";
+        }>>;
+        retryAfter: z.ZodOptional<z.ZodNumber>;
+        current: z.ZodOptional<z.ZodObject<{
+            concurrency: z.ZodOptional<z.ZodNumber>;
+            rpm: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        limits: z.ZodOptional<z.ZodObject<{
+            maxConcurrency: z.ZodOptional<z.ZodNumber>;
+            maxRpm: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        request: z.ZodOptional<z.ZodUnknown>;
+        code: z.ZodOptional<z.ZodString>;
+    };
+};
+export {};