cursor-composer-in-claude 0.7.3

package/dist/cli/usage.js

@@ -0,0 +1,177 @@
+import * as https from "node:https";
+export { TOKEN_FILE, readCachedToken, writeCachedToken, readKeychainToken, } from "../lib/token-cache.js";
+// ---------------------------------------------------------------------------
+// JWT helpers (no external dependencies)
+// ---------------------------------------------------------------------------
+export function decodeJwtPayload(token) {
+    try {
+        const parts = token.split(".");
+        if (parts.length < 2)
+            return {};
+        const padded = parts[1].replace(/-/g, "+").replace(/_/g, "/");
+        return JSON.parse(Buffer.from(padded, "base64").toString("utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+/** Extract the auth0 user sub from a Cursor access token (e.g. "auth0|user_01KK…"). */
+export function tokenSub(token) {
+    const p = decodeJwtPayload(token);
+    return typeof p.sub === "string" ? p.sub : undefined;
+}
+// ---------------------------------------------------------------------------
+// Cursor API
+// ---------------------------------------------------------------------------
+const API_BASE = "https://api2.cursor.sh";
+function apiGet(path, token) {
+    return new Promise((resolve, reject) => {
+        const opts = {
+            hostname: "api2.cursor.sh",
+            path,
+            method: "GET",
+            headers: { Authorization: `Bearer ${token}` },
+        };
+        const req = https.request(opts, (res) => {
+            let data = "";
+            res.on("data", (c) => (data += c));
+            res.on("end", () => {
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        });
+        req.on("error", reject);
+        req.setTimeout(8000, () => {
+            req.destroy(new Error("timeout"));
+        });
+        req.end();
+    });
+}
+export async function fetchAccountUsage(token) {
+    try {
+        const raw = (await apiGet("/auth/usage", token));
+        if (!raw || typeof raw !== "object")
+            return null;
+        const { startOfMonth, ...rest } = raw;
+        return {
+            startOfMonth: typeof startOfMonth === "string" ? startOfMonth : "",
+            models: rest,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Human-readable plan name + limits for display. */
+export function describePlan(profile) {
+    const { membershipType, subscriptionStatus, daysRemainingOnTrial } = profile;
+    switch (membershipType) {
+        case "free_trial": {
+            const days = daysRemainingOnTrial ?? 0;
+            return `Pro Trial (${days}d left) — unlimited fast requests`;
+        }
+        case "pro":
+        case "pro_plus":
+        case "ultra":
+            return `${membershipType === "pro" ? "Pro" : membershipType === "pro_plus" ? "Pro+" : "Ultra"} — extended limits`;
+        case "free":
+        case "hobby":
+            return "Hobby (free) — limited agent requests";
+        default:
+            return `${membershipType} · ${subscriptionStatus}`;
+    }
+}
+export async function fetchStripeProfile(token) {
+    try {
+        const raw = (await apiGet("/auth/full_stripe_profile", token));
+        if (!raw || typeof raw !== "object")
+            return null;
+        return {
+            membershipType: String(raw.membershipType ?? ""),
+            subscriptionStatus: String(raw.subscriptionStatus ?? ""),
+            daysRemainingOnTrial: typeof raw.daysRemainingOnTrial === "number"
+                ? raw.daysRemainingOnTrial
+                : null,
+            isTeamMember: Boolean(raw.isTeamMember),
+            isYearlyPlan: Boolean(raw.isYearlyPlan),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Summary helpers
+// ---------------------------------------------------------------------------
+// Human-readable labels for Cursor's internal model/pool keys.
+// Keys are actual identifiers from the agent binary (2026.03.20 build).
+const MODEL_LABELS = {
+    // ── Usage pool keys (what the /auth/usage API actually returns) ──
+    "gpt-4": "Fast Premium Requests", // main premium pool (all models)
+    // ── Claude Sonnet ──
+    "claude-sonnet-4-6": "Claude Sonnet 4.6",
+    "claude-sonnet-4-5-20250929-v1": "Claude Sonnet 4.5",
+    "claude-sonnet-4-20250514-v1": "Claude Sonnet 4",
+    // ── Claude Opus ──
+    "claude-opus-4-6-v1": "Claude Opus 4.6",
+    "claude-opus-4-5-20251101-v1": "Claude Opus 4.5",
+    "claude-opus-4-1-20250805-v1": "Claude Opus 4.1",
+    "claude-opus-4-20250514-v1": "Claude Opus 4",
+    // ── Claude Haiku ──
+    "claude-haiku-4-5-20251001-v1": "Claude Haiku 4.5",
+    "claude-3-5-haiku-20241022-v1": "Claude 3.5 Haiku",
+    // ── GPT / OpenAI ──
+    "gpt-5": "GPT-5",
+    "gpt-4o": "GPT-4o",
+    o1: "o1",
+    "o3-mini": "o3-mini",
+    // ── Cursor-native ──
+    "cursor-small": "Cursor Small (free)",
+};
+function modelLabel(key) {
+    return MODEL_LABELS[key] ?? key;
+}
+export function formatUsageSummary(usage) {
+    const lines = [];
+    const start = usage.startOfMonth
+        ? new Date(usage.startOfMonth).toLocaleDateString()
+        : "?";
+    lines.push(`     📅 Billing period from ${start}`);
+    const entries = Object.entries(usage.models);
+    if (entries.length === 0) {
+        lines.push(`     🔢 No requests this billing period`);
+        return lines;
+    }
+    // Sort: entries with limits first, then by usage descending
+    const sorted = entries.sort(([, a], [, b]) => {
+        if ((a.maxRequestUsage !== null) !== (b.maxRequestUsage !== null))
+            return a.maxRequestUsage !== null ? -1 : 1;
+        return b.numRequests - a.numRequests;
+    });
+    for (const [key, v] of sorted) {
+        const used = v.numRequests;
+        const max = v.maxRequestUsage;
+        const label = modelLabel(key);
+        if (max !== null && max > 0) {
+            const pct = Math.round((used / max) * 100);
+            const bar = makeBar(used, max, 12);
+            lines.push(`     🔢 ${label}: ${used}/${max} (${pct}%) [${bar}]`);
+        }
+        else if (used > 0) {
+            lines.push(`     🔢 ${label}: ${used} requests`);
+        }
+        else {
+            lines.push(`     🔢 ${label}: 0 requests (unlimited)`);
+        }
+    }
+    return lines;
+}
+function makeBar(used, max, width) {
+    const fill = Math.round((used / max) * width);
+    return "█".repeat(fill) + "░".repeat(width - fill);
+}
+//# sourceMappingURL=usage.js.map

package/dist/cli/usage.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export { parseArgs } from "./cli/args.js";

package/dist/cli.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadBridgeConfig } from "./lib/config.js";
+import { startBridgeServer, setupGracefulShutdown } from "./lib/server.js";
+import { parseArgs, printHelp } from "./cli/args.js";
+import { handleAccountsList, handleLogout } from "./cli/accounts.js";
+import { handleLogin } from "./cli/login.js";
+import { handleResetHwid } from "./cli/reset-hwid.js";
+// Re-export parseArgs so src/cli.test.ts can import it without a separate path
+export { parseArgs } from "./cli/args.js";
+// ---------------------------------------------------------------------------
+// Package metadata
+// ---------------------------------------------------------------------------
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const pkgPath = path.join(__dirname, "..", "package.json");
+const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        printHelp(pkg.version);
+        return;
+    }
+    if (args.login) {
+        await handleLogin(args.accountName, args.proxies);
+        return;
+    }
+    if (args.logout) {
+        await handleLogout(args.accountName);
+        return;
+    }
+    if (args.accountsList) {
+        await handleAccountsList();
+        return;
+    }
+    if (args.resetHwid) {
+        await handleResetHwid({ deepClean: args.deepClean, dryRun: args.dryRun });
+        return;
+    }
+    const config = loadBridgeConfig({ tailscale: args.tailscale });
+    const servers = startBridgeServer({ version: pkg.version, config });
+    setupGracefulShutdown(servers);
+}
+const realArgv1 = process.argv[1] ? fs.realpathSync(process.argv[1]) : "";
+const isMainModule = realArgv1 === fs.realpathSync(__filename);
+if (isMainModule) {
+    main().catch((err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`Error: ${msg}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,95 @@
+/**
+ * SDK for calling cursor-api-proxy from another project.
+ *
+ * When startProxy is true (default), the SDK will start the proxy in the
+ * background if it is not already reachable. Prerequisites: Cursor agent CLI
+ * must be installed and set up separately (see README).
+ */
+export type CursorProxyClientOptions = {
+    /** Proxy base URL (e.g. http://127.0.0.1:8765). Default: env CURSOR_PROXY_URL or http://127.0.0.1:8765 */
+    baseUrl?: string;
+    /** Optional API key; if the proxy is started with CURSOR_BRIDGE_API_KEY, pass it here. */
+    apiKey?: string;
+    /**
+     * When true (default), start the proxy in the background if it is not reachable.
+     * Only applies when using the default base URL. Set to false if you run the proxy yourself.
+     */
+    startProxy?: boolean;
+};
+/**
+ * Ensures the proxy is running at the given base URL. If the URL is the default
+ * and the proxy is not reachable, starts it in the background (Node.js only).
+ * Resolves when /health returns 200 or rejects on timeout.
+ */
+export declare function ensureProxyRunning(options?: {
+    baseUrl?: string;
+    timeoutMs?: number;
+}): Promise<string>;
+export declare function stopManagedProxy(options?: {
+    timeoutMs?: number;
+}): Promise<boolean>;
+/**
+ * Options suitable for the OpenAI SDK constructor.
+ * Use: new OpenAI(getOpenAIOptions())
+ * For auto-starting the proxy first, use getOpenAIOptionsAsync() and await it.
+ */
+export declare function getOpenAIOptions(options?: CursorProxyClientOptions): {
+    baseURL: string;
+    apiKey: string;
+};
+/**
+ * Like getOpenAIOptions but ensures the proxy is running first (starts it in the background if needed).
+ * Use: new OpenAI(await getOpenAIOptionsAsync())
+ */
+export declare function getOpenAIOptionsAsync(options?: CursorProxyClientOptions & {
+    timeoutMs?: number;
+}): Promise<{
+    baseURL: string;
+    apiKey: string;
+}>;
+/**
+ * Minimal client to call the proxy HTTP API.
+ * When startProxy is true (default), the proxy is started in the background on first request if not reachable.
+ */
+export declare function createCursorProxyClient(options?: CursorProxyClientOptions): {
+    /** Base URL of the proxy (no /v1 suffix) */
+    baseUrl: string;
+    /** Headers to send (Content-Type and optional Authorization) */
+    headers: Record<string, string>;
+    /** Get options for the OpenAI SDK constructor */
+    getOpenAIOptions: () => {
+        baseURL: string;
+        apiKey: string;
+    };
+    /**
+     * POST to a path (e.g. /v1/chat/completions). Body is JSON-serialized.
+     */
+    request<T = unknown>(path: string, body: unknown): Promise<{
+        data: T;
+        ok: boolean;
+        status: number;
+    }>;
+    /** OpenAI-style chat completions (non-streaming). */
+    chatCompletionsCreate(params: {
+        model?: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+        stream?: false;
+    }): Promise<{
+        choices?: Array<{
+            message?: {
+                content?: string;
+            };
+        }>;
+        error?: {
+            message?: string;
+        };
+    }>;
+    /**
+     * Use for streaming: returns a fetch Response so you can read the body stream.
+     * Ensures the proxy is running first when startProxy is true.
+     */
+    fetch(path: string, init?: RequestInit): Promise<Response>;
+};

package/dist/client.js

@@ -0,0 +1,316 @@
+/**
+ * SDK for calling cursor-api-proxy from another project.
+ *
+ * When startProxy is true (default), the SDK will start the proxy in the
+ * background if it is not already reachable. Prerequisites: Cursor agent CLI
+ * must be installed and set up separately (see README).
+ */
+const DEFAULT_BASE_URL = "http://127.0.0.1:8765";
+const HEALTH_PATH = "/health";
+const PROXY_START_TIMEOUT_MS = 15_000;
+const PROXY_POLL_MS = 200;
+const PROXY_STOP_TIMEOUT_MS = 5_000;
+const SHUTDOWN_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP", "SIGBREAK"];
+let _proxyProcess = null;
+let _managedProxyStartupPromise = null;
+let _managedProxyStartedBySdk = false;
+let _shutdownHandlersInstalled = false;
+let _signalCleanupInProgress = false;
+function killManagedProxySync() {
+    const child = _proxyProcess;
+    if (!child || !_managedProxyStartedBySdk)
+        return;
+    if (child.exitCode == null) {
+        try {
+            child.kill("SIGTERM");
+        }
+        catch { }
+    }
+    _proxyProcess = null;
+    _managedProxyStartedBySdk = false;
+    _managedProxyStartupPromise = null;
+}
+function installShutdownHandlers() {
+    if (_shutdownHandlersInstalled ||
+        typeof process === "undefined" ||
+        !process?.on) {
+        return;
+    }
+    _shutdownHandlersInstalled = true;
+    process.on("exit", () => {
+        killManagedProxySync();
+    });
+    const handleSignal = async (signal) => {
+        if (_signalCleanupInProgress) {
+            return;
+        }
+        _signalCleanupInProgress = true;
+        try {
+            await stopManagedProxy();
+        }
+        finally {
+            for (const value of SHUTDOWN_SIGNALS) {
+                process.removeListener(value, signalHandlers[value]);
+            }
+            _signalCleanupInProgress = false;
+            try {
+                process.kill(process.pid, signal);
+            }
+            catch {
+                process.exit(1);
+            }
+        }
+    };
+    const signalHandlers = {
+        SIGINT: () => {
+            void handleSignal("SIGINT");
+        },
+        SIGTERM: () => {
+            void handleSignal("SIGTERM");
+        },
+        SIGHUP: () => {
+            void handleSignal("SIGHUP");
+        },
+        SIGBREAK: () => {
+            void handleSignal("SIGBREAK");
+        },
+    };
+    for (const signal of SHUTDOWN_SIGNALS) {
+        process.on(signal, signalHandlers[signal]);
+    }
+}
+function isDefaultBaseUrl(baseUrl) {
+    const u = baseUrl.replace(/\/$/, "");
+    return u === DEFAULT_BASE_URL || u === "http://127.0.0.1:8765" || u === "http://localhost:8765";
+}
+async function pingHealth(baseUrl) {
+    const url = `${baseUrl.replace(/\/$/, "")}${HEALTH_PATH}`;
+    try {
+        const res = await fetch(url, { method: "GET" });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Ensures the proxy is running at the given base URL. If the URL is the default
+ * and the proxy is not reachable, starts it in the background (Node.js only).
+ * Resolves when /health returns 200 or rejects on timeout.
+ */
+export async function ensureProxyRunning(options = {}) {
+    const baseUrl = options.baseUrl ??
+        ((typeof process !== "undefined" && process.env?.CURSOR_PROXY_URL) ||
+            DEFAULT_BASE_URL);
+    const root = baseUrl.replace(/\/$/, "");
+    const timeoutMs = options.timeoutMs ?? PROXY_START_TIMEOUT_MS;
+    if (await pingHealth(root)) {
+        return root;
+    }
+    if (!isDefaultBaseUrl(root)) {
+        throw new Error(`cursor-api-proxy is not reachable at ${root}. Start it manually (e.g. npx cursor-api-proxy) or use the default URL for auto-start.`);
+    }
+    const isNode = typeof process !== "undefined" &&
+        process.versions?.node &&
+        typeof globalThis.fetch !== "undefined";
+    if (!isNode) {
+        throw new Error("cursor-api-proxy is not reachable. Start it manually (e.g. npx cursor-api-proxy). Auto-start is only available in Node.js.");
+    }
+    if (_managedProxyStartupPromise) {
+        return _managedProxyStartupPromise;
+    }
+    const startupPromise = (async () => {
+        const { spawn } = await import("node:child_process");
+        const pathMod = await import("node:path");
+        const path = pathMod.default;
+        const { fileURLToPath } = await import("node:url");
+        const clientDir = path.dirname(fileURLToPath(import.meta.url));
+        const cliPath = path.join(clientDir, "cli.js");
+        const child = spawn(process.execPath, [cliPath], {
+            stdio: "ignore",
+            detached: false,
+            cwd: process.cwd(),
+            env: process.env,
+        });
+        child.unref();
+        installShutdownHandlers();
+        _proxyProcess = child;
+        _managedProxyStartedBySdk = true;
+        let exitCode = null;
+        child.on("error", () => {
+            _proxyProcess = null;
+            _managedProxyStartedBySdk = false;
+        });
+        child.on("exit", (code) => {
+            exitCode = code ?? null;
+            _proxyProcess = null;
+            _managedProxyStartedBySdk = false;
+        });
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            await new Promise((r) => setTimeout(r, PROXY_POLL_MS));
+            if (await pingHealth(root)) {
+                return root;
+            }
+            if (exitCode != null) {
+                _proxyProcess = null;
+                _managedProxyStartedBySdk = false;
+                throw new Error(`cursor-api-proxy process exited with code ${exitCode} before becoming ready. Ensure Cursor CLI is installed (agent login).`);
+            }
+        }
+        if (_proxyProcess) {
+            _proxyProcess.kill();
+            _proxyProcess = null;
+        }
+        _managedProxyStartedBySdk = false;
+        throw new Error(`cursor-api-proxy did not become ready within ${timeoutMs}ms. Ensure Cursor CLI is installed (agent login).`);
+    })();
+    _managedProxyStartupPromise = startupPromise;
+    try {
+        return await startupPromise;
+    }
+    finally {
+        if (_managedProxyStartupPromise === startupPromise) {
+            _managedProxyStartupPromise = null;
+        }
+    }
+}
+export async function stopManagedProxy(options = {}) {
+    const child = _proxyProcess;
+    if (!child || !_managedProxyStartedBySdk) {
+        return false;
+    }
+    const timeoutMs = options.timeoutMs ?? PROXY_STOP_TIMEOUT_MS;
+    _managedProxyStartupPromise = null;
+    if (child.exitCode != null) {
+        _proxyProcess = null;
+        _managedProxyStartedBySdk = false;
+        return true;
+    }
+    const exitPromise = new Promise((resolve) => {
+        child.once("exit", () => resolve());
+        child.once("error", () => resolve());
+    });
+    child.kill("SIGTERM");
+    const exited = await Promise.race([
+        exitPromise.then(() => true),
+        new Promise((resolve) => {
+            setTimeout(() => resolve(false), timeoutMs);
+        }),
+    ]);
+    if (!exited && child.exitCode == null) {
+        child.kill("SIGKILL");
+        await exitPromise;
+    }
+    _proxyProcess = null;
+    _managedProxyStartedBySdk = false;
+    return true;
+}
+/**
+ * Options suitable for the OpenAI SDK constructor.
+ * Use: new OpenAI(getOpenAIOptions())
+ * For auto-starting the proxy first, use getOpenAIOptionsAsync() and await it.
+ */
+export function getOpenAIOptions(options = {}) {
+    const baseUrl = options.baseUrl ??
+        ((typeof process !== "undefined" && process.env?.CURSOR_PROXY_URL) ||
+            DEFAULT_BASE_URL);
+    const baseURL = baseUrl.endsWith("/v1") ? baseUrl : `${baseUrl.replace(/\/$/, "")}/v1`;
+    const apiKey = options.apiKey ??
+        ((typeof process !== "undefined" && process.env?.CURSOR_BRIDGE_API_KEY) ||
+            "unused");
+    return { baseURL, apiKey };
+}
+/**
+ * Like getOpenAIOptions but ensures the proxy is running first (starts it in the background if needed).
+ * Use: new OpenAI(await getOpenAIOptionsAsync())
+ */
+export async function getOpenAIOptionsAsync(options = {}) {
+    const startProxy = options.startProxy !== false;
+    const baseUrl = options.baseUrl ??
+        ((typeof process !== "undefined" && process.env?.CURSOR_PROXY_URL) ||
+            DEFAULT_BASE_URL);
+    const root = baseUrl.replace(/\/$/, "");
+    if (startProxy && isDefaultBaseUrl(root)) {
+        await ensureProxyRunning({ baseUrl: root, timeoutMs: options.timeoutMs });
+    }
+    return getOpenAIOptions(options);
+}
+/**
+ * Minimal client to call the proxy HTTP API.
+ * When startProxy is true (default), the proxy is started in the background on first request if not reachable.
+ */
+export function createCursorProxyClient(options = {}) {
+    const startProxy = options.startProxy !== false;
+    const baseUrl = options.baseUrl ??
+        ((typeof process !== "undefined" && process.env?.CURSOR_PROXY_URL) ||
+            DEFAULT_BASE_URL);
+    const root = baseUrl.replace(/\/$/, "");
+    const apiKeyRaw = options.apiKey ??
+        (typeof process !== "undefined" ? process.env?.CURSOR_BRIDGE_API_KEY : undefined);
+    const apiKey = typeof apiKeyRaw === "string" ? apiKeyRaw : undefined;
+    const headers = {
+        "Content-Type": "application/json",
+        ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),
+    };
+    async function ensureThenRequest(path, init) {
+        const url = path.startsWith("http")
+            ? path
+            : `${root}${path.startsWith("/") ? "" : "/"}${path}`;
+        if (startProxy && isDefaultBaseUrl(root)) {
+            await ensureProxyRunning({ baseUrl: root });
+        }
+        return fetch(url, init);
+    }
+    return {
+        /** Base URL of the proxy (no /v1 suffix) */
+        baseUrl: root,
+        /** Headers to send (Content-Type and optional Authorization) */
+        headers,
+        /** Get options for the OpenAI SDK constructor */
+        getOpenAIOptions: () => getOpenAIOptions({ baseUrl: root, apiKey: apiKey ?? "unused" }),
+        /**
+         * POST to a path (e.g. /v1/chat/completions). Body is JSON-serialized.
+         */
+        async request(path, body) {
+            const url = path.startsWith("http")
+                ? path
+                : `${root}${path.startsWith("/") ? "" : "/"}${path}`;
+            const res = await ensureThenRequest(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+            });
+            const data = (await res.json().catch(() => ({})));
+            return { data, ok: res.ok, status: res.status };
+        },
+        /** OpenAI-style chat completions (non-streaming). */
+        async chatCompletionsCreate(params) {
+            const { data, ok, status } = await this.request("/v1/chat/completions", {
+                model: params.model ?? "default",
+                messages: params.messages,
+                stream: false,
+            });
+            if (!ok) {
+                const err = data?.error?.message ?? JSON.stringify(data);
+                throw new Error(`cursor-api-proxy error (${status}): ${err}`);
+            }
+            return data;
+        },
+        /**
+         * Use for streaming: returns a fetch Response so you can read the body stream.
+         * Ensures the proxy is running first when startProxy is true.
+         */
+        async fetch(path, init = {}) {
+            const url = path.startsWith("http")
+                ? path
+                : `${root}${path.startsWith("/") ? "" : "/"}${path}`;
+            const merged = new Headers(init.headers);
+            merged.set("Content-Type", "application/json");
+            if (apiKey)
+                merged.set("Authorization", `Bearer ${apiKey}`);
+            return ensureThenRequest(url, { ...init, headers: merged });
+        },
+    };
+}
+//# sourceMappingURL=client.js.map