@superblocksteam/clark 2.0.0-SNAPSHOT.a1e14d6b7a1bcd87

package/dist/mcp/docs-mcp.js

@@ -0,0 +1,95 @@
+/**
+ * Shared docs MCP helper for both Dashboard Clark and Editor Clark.
+ *
+ * Connects to the Superblocks docs MCP server, discovers tools via the
+ * MCP protocol, and returns them as an AI SDK ToolSet. Handles caching
+ * to avoid reconnecting on every request.
+ */
+import { jsonSchema } from "ai";
+import { extractMcpTextContent } from "./extract-mcp-text-content.js";
+import { MCPClient } from "./mcp-client.js";
+/** Superblocks docs MCP server URL. */
+export const DOCS_MCP_URL = "https://docs.superblocks.com/mcp";
+/**
+ * Module-level cache so the remote HTTP roundtrip (connect → tools/list)
+ * only happens once instead of on every request.
+ * A pending connect Promise prevents concurrent requests from racing.
+ */
+let docsMcpClientCache = null;
+let connectPromise = null;
+/**
+ * Returns the cached docs MCP client instance, creating one if needed.
+ * The client is shared so both getDocsMcpTools() and direct adapter
+ * usage (Editor Clark) can reuse the same connection.
+ */
+function getDocsMcpClient(logger) {
+    if (!docsMcpClientCache) {
+        docsMcpClientCache = new MCPClient(DOCS_MCP_URL, logger);
+        connectPromise = null;
+    }
+    return docsMcpClientCache;
+}
+/**
+ * Ensures the docs MCP client is connected. Returns the pending
+ * connect promise so concurrent callers await the same connection.
+ */
+async function ensureDocsMcpConnected(logger) {
+    const client = getDocsMcpClient(logger);
+    if (!client.isConnected()) {
+        if (!connectPromise) {
+            connectPromise = client.connect().then(() => {
+                connectPromise = null;
+            }, (err) => {
+                connectPromise = null;
+                throw err;
+            });
+        }
+        await connectPromise;
+    }
+    return client;
+}
+/**
+ * Returns docs MCP tools as an AI SDK ToolSet when the feature flag is
+ * enabled. Tools are dynamically discovered from the MCP server via the
+ * MCP protocol (`tools/list` + `tools/call`).
+ *
+ * Returns an empty ToolSet when disabled or on error.
+ *
+ * Used by Dashboard Clark. Editor Clark uses MCPClient + McpToolAdapter
+ * directly for richer tool registration (categories, permissions, etc.).
+ */
+export async function getDocsMcpTools(enabled, logger) {
+    if (!enabled) {
+        return {};
+    }
+    try {
+        const client = await ensureDocsMcpConnected(logger);
+        const toolSet = {};
+        for (const def of client.getToolDefinitions()) {
+            toolSet[def.name] = {
+                description: def.description ?? def.name,
+                inputSchema: jsonSchema(def.inputSchema ?? { type: "object", properties: {} }),
+                execute: async (rawInput) => {
+                    const args = rawInput != null && typeof rawInput === "object"
+                        ? rawInput
+                        : {};
+                    const content = await client.callTool(def.name, args);
+                    const text = extractMcpTextContent(content);
+                    if (text)
+                        return { content: text };
+                    return content != null
+                        ? { content: JSON.stringify(content) }
+                        : { content: "No results found." };
+                },
+            };
+        }
+        return toolSet;
+    }
+    catch (error) {
+        logger.warn(`[Docs MCP] Failed to initialize: ${String(error)}`);
+        docsMcpClientCache = null;
+        connectPromise = null;
+        return {};
+    }
+}
+//# sourceMappingURL=docs-mcp.js.map

package/dist/mcp/docs-mcp.js.map

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

package/dist/mcp/extract-mcp-text-content.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extracts text content from an MCP tool response.
+ *
+ * MCP servers return content as arrays of typed parts (e.g. `[{ type: "text", text: "..." }]`),
+ * sometimes wrapped in `{ content: [...] }`. This helper normalises both shapes and joins
+ * all text parts with double newlines.
+ *
+ * Returns `undefined` when the input contains no text content.
+ */
+export declare function extractMcpTextContent(output: unknown): string | undefined;
+//# sourceMappingURL=extract-mcp-text-content.d.ts.map

package/dist/mcp/extract-mcp-text-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-mcp-text-content.d.ts","sourceRoot":"","sources":["../../src/mcp/extract-mcp-text-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CA6BzE"}

package/dist/mcp/extract-mcp-text-content.js

@@ -0,0 +1,37 @@
+/**
+ * Extracts text content from an MCP tool response.
+ *
+ * MCP servers return content as arrays of typed parts (e.g. `[{ type: "text", text: "..." }]`),
+ * sometimes wrapped in `{ content: [...] }`. This helper normalises both shapes and joins
+ * all text parts with double newlines.
+ *
+ * Returns `undefined` when the input contains no text content.
+ */
+export function extractMcpTextContent(output) {
+    const content = Array.isArray(output)
+        ? output
+        : output &&
+            typeof output === "object" &&
+            "content" in output &&
+            Array.isArray(output.content)
+            ? output.content
+            : undefined;
+    if (!content) {
+        return undefined;
+    }
+    const text = content
+        .map((part) => {
+        if (!part || typeof part !== "object") {
+            return "";
+        }
+        const typedPart = part;
+        if (typedPart.type !== "text" || typeof typedPart.text !== "string") {
+            return "";
+        }
+        return typedPart.text.trim();
+    })
+        .filter((part) => part.length > 0)
+        .join("\n\n");
+    return text.length > 0 ? text : undefined;
+}
+//# sourceMappingURL=extract-mcp-text-content.js.map

package/dist/mcp/extract-mcp-text-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-mcp-text-content.js","sourceRoot":"","sources":["../../src/mcp/extract-mcp-text-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACnC,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM;YACJ,OAAO,MAAM,KAAK,QAAQ;YAC1B,SAAS,IAAI,MAAM;YACnB,KAAK,CAAC,OAAO,CAAE,MAAgC,CAAC,OAAO,CAAC;YAC1D,CAAC,CAAE,MAAiC,CAAC,OAAO;YAC5C,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,SAAS,GAAG,IAA0C,CAAC;QAC7D,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpE,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,5 @@
+export { MCPClient } from "./mcp-client.js";
+export { DOCS_MCP_URL, getDocsMcpTools } from "./docs-mcp.js";
+export { extractMcpTextContent } from "./extract-mcp-text-content.js";
+export type { McpLogger } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,4 @@
+export { MCPClient } from "./mcp-client.js";
+export { DOCS_MCP_URL, getDocsMcpTools } from "./docs-mcp.js";
+export { extractMcpTextContent } from "./extract-mcp-text-content.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/mcp/mcp-client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Generic MCP client for JSON-RPC over HTTP with SSE support.
+ *
+ * Handles communication with any MCP server via the Streamable HTTP
+ * transport. Used by both Editor Clark and Dashboard Clark for
+ * connecting to MCP servers (docs, Playwright, etc.).
+ */
+import type { McpLogger, McpToolDefinition, McpClientInterface } from "./types.js";
+/**
+ * MCP client that communicates via JSON-RPC over HTTP with SSE support.
+ *
+ * Connects to an MCP server, discovers available tools via `tools/list`,
+ * and delegates tool execution via `tools/call`.
+ */
+export declare class MCPClient implements McpClientInterface {
+    private readonly serverUrl;
+    private readonly logger;
+    private nextId;
+    private connected;
+    private tools;
+    constructor(serverUrl: string, logger: McpLogger);
+    /**
+     * Connects to the MCP server and discovers available tools.
+     */
+    connect(): Promise<void>;
+    /**
+     * Calls a tool on the MCP server.
+     *
+     * @returns The MCP content array from the tool response.
+     */
+    callTool(toolName: string, args: unknown): Promise<unknown>;
+    /**
+     * Checks if the client is connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Disconnects from the MCP server.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Gets available tool names.
+     */
+    getAvailableTools(): string[];
+    /**
+     * Gets full tool definitions including schemas.
+     */
+    getToolDefinitions(): McpToolDefinition[];
+    private listTools;
+    private sendRequest;
+    private parseSSEResponse;
+}
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/mcp/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,SAAS,EAGT,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAKpB;;;;;GAKG;AACH,qBAAa,SAAU,YAAW,kBAAkB;IAMhD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAA6C;gBAGvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS;IAGpC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BjE;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAI7B;;OAEG;IACH,kBAAkB,IAAI,iBAAiB,EAAE;YAI3B,SAAS;YAKT,WAAW;IAyDzB,OAAO,CAAC,gBAAgB;CAmBzB"}

package/dist/mcp/mcp-client.js

@@ -0,0 +1,164 @@
+/**
+ * Generic MCP client for JSON-RPC over HTTP with SSE support.
+ *
+ * Handles communication with any MCP server via the Streamable HTTP
+ * transport. Used by both Editor Clark and Dashboard Clark for
+ * connecting to MCP servers (docs, Playwright, etc.).
+ */
+/** Timeout for MCP requests (30 seconds). */
+const MCP_TIMEOUT_MS = 30_000;
+/**
+ * MCP client that communicates via JSON-RPC over HTTP with SSE support.
+ *
+ * Connects to an MCP server, discovers available tools via `tools/list`,
+ * and delegates tool execution via `tools/call`.
+ */
+export class MCPClient {
+    serverUrl;
+    logger;
+    nextId = 1;
+    connected = false;
+    tools = new Map();
+    constructor(serverUrl, logger) {
+        this.serverUrl = serverUrl;
+        this.logger = logger;
+    }
+    /**
+     * Connects to the MCP server and discovers available tools.
+     */
+    async connect() {
+        if (this.connected)
+            return;
+        try {
+            const toolList = await this.listTools();
+            this.tools.clear();
+            for (const tool of toolList) {
+                this.tools.set(tool.name, tool);
+            }
+            this.connected = true;
+            this.logger.info(`[MCP] Connected to ${this.serverUrl} with ${this.tools.size} tool(s)`);
+        }
+        catch (error) {
+            this.logger.error(`[MCP] Failed to connect to ${this.serverUrl}: ${String(error)}`);
+            throw new Error(`MCP connection failed: ${String(error)}`);
+        }
+    }
+    /**
+     * Calls a tool on the MCP server.
+     *
+     * @returns The MCP content array from the tool response.
+     */
+    async callTool(toolName, args) {
+        if (!this.connected) {
+            await this.connect();
+        }
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${toolName}`);
+        }
+        const result = await this.sendRequest("tools/call", {
+            name: toolName,
+            arguments: args,
+        });
+        const response = result;
+        if (response?.error) {
+            throw new Error(`Tool execution failed: ${response.error.message ?? "unknown error"}`);
+        }
+        return response?.content;
+    }
+    /**
+     * Checks if the client is connected.
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Disconnects from the MCP server.
+     */
+    async disconnect() {
+        if (!this.connected)
+            return;
+        this.connected = false;
+        this.tools.clear();
+    }
+    /**
+     * Gets available tool names.
+     */
+    getAvailableTools() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Gets full tool definitions including schemas.
+     */
+    getToolDefinitions() {
+        return Array.from(this.tools.values());
+    }
+    async listTools() {
+        const result = await this.sendRequest("tools/list", {});
+        return result?.tools ?? [];
+    }
+    async sendRequest(method, params) {
+        const request = {
+            jsonrpc: "2.0",
+            method,
+            params,
+            id: this.nextId++,
+        };
+        try {
+            const response = await fetch(this.serverUrl, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Accept: "application/json, text/event-stream",
+                },
+                body: JSON.stringify(request),
+                signal: AbortSignal.timeout(MCP_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const contentType = response.headers.get("content-type") ?? "";
+            if (contentType.includes("text/event-stream")) {
+                const text = await response.text();
+                return this.parseSSEResponse(text, request.id);
+            }
+            const data = (await response.json());
+            if (data.error)
+                throw new Error(data.error.message);
+            return data.result;
+        }
+        catch (error) {
+            const errorMsg = String(error);
+            if (errorMsg.includes("ECONNREFUSED") ||
+                errorMsg.includes("ECONNRESET")) {
+                this.connected = false;
+                throw new Error("MCP server connection lost. The server may have crashed.");
+            }
+            if (errorMsg.includes("AbortError") || errorMsg.includes("timeout")) {
+                throw new Error(`MCP request timed out: method ${method}`);
+            }
+            throw error;
+        }
+    }
+    parseSSEResponse(text, requestId) {
+        for (const line of text.split("\n")) {
+            if (line.startsWith("data: ")) {
+                try {
+                    const data = JSON.parse(line.substring(6));
+                    if (data.id === requestId || data.id === null) {
+                        if (data.error)
+                            throw new Error(data.error.message);
+                        return data.result;
+                    }
+                }
+                catch (e) {
+                    // Re-throw MCP errors; skip only JSON.parse SyntaxErrors
+                    if (!(e instanceof SyntaxError))
+                        throw e;
+                }
+            }
+        }
+        throw new Error(`No valid JSON-RPC response found in SSE stream for request ${requestId}`);
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/mcp/mcp-client.js.map

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

package/dist/mcp/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Shared MCP (Model Context Protocol) types.
+ *
+ * Used by both Editor Clark and Dashboard Clark for connecting
+ * to MCP servers (docs, Playwright, etc.).
+ */
+/**
+ * Minimal logger interface compatible with both pino (server)
+ * and the vite-plugin-file-sync Logger.
+ */
+export interface McpLogger {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+/**
+ * JSON-RPC request for MCP communication.
+ */
+export interface McpJsonRpcRequest {
+    jsonrpc: "2.0";
+    method: string;
+    params?: Record<string, unknown>;
+    id: number;
+}
+/**
+ * JSON-RPC response from MCP server.
+ */
+export interface McpJsonRpcResponse {
+    jsonrpc: "2.0";
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+    id: number | null;
+}
+/**
+ * MCP tool definition as returned by the MCP server via tools/list.
+ */
+export interface McpToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+/**
+ * Interface for MCP clients that can be used with the McpToolAdapter.
+ */
+export interface McpClientInterface {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getToolDefinitions(): McpToolDefinition[];
+    callTool(name: string, args: unknown): Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;IACvB,kBAAkB,IAAI,iBAAiB,EAAE,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD"}

package/dist/mcp/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared MCP (Model Context Protocol) types.
+ *
+ * Used by both Editor Clark and Dashboard Clark for connecting
+ * to MCP servers (docs, Playwright, etc.).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/snowflake-cortex-fetch.d.ts

@@ -0,0 +1,21 @@
+type UpstreamResponseInfo = {
+    /** Upstream request identifier from the response headers, when present. */
+    requestId: string | undefined;
+    status: number;
+    url: string;
+};
+type SnowflakeCortexFetchOptions = {
+    forwardCacheControl: boolean;
+    onPromptCachingRejected?: () => void;
+    /**
+     * Called once per upstream response with its request identifier — the
+     * handle needed to escalate stalled/failed requests to the provider.
+     * Fires for every upstream attempt, including the cache_control 400
+     * retry, so the last invocation always reflects the live inference.
+     */
+    onUpstreamResponse?: (info: UpstreamResponseInfo) => void;
+};
+export declare function createSnowflakeCortexFetch({ forwardCacheControl, onPromptCachingRejected, onUpstreamResponse, }: SnowflakeCortexFetchOptions): typeof fetch;
+export declare const snowflakeCortexFetch: typeof fetch;
+export {};
+//# sourceMappingURL=snowflake-cortex-fetch.d.ts.map

package/dist/snowflake-cortex-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snowflake-cortex-fetch.d.ts","sourceRoot":"","sources":["../src/snowflake-cortex-fetch.ts"],"names":[],"mappings":"AAUA,KAAK,oBAAoB,GAAG;IAC1B,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAsBF,KAAK,2BAA2B,GAAG;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,IAAI,CAAC;IACrC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC3D,CAAC;AAoVF,wBAAgB,0BAA0B,CAAC,EACzC,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,GACnB,EAAE,2BAA2B,GAAG,OAAO,KAAK,CAoE5C;AAED,eAAO,MAAM,oBAAoB,EAAE,OAAO,KAExC,CAAC"}