@ragable/sdk 0.7.8 → 0.7.10

package/dist/index.d.mts

@@ -981,10 +981,53 @@ type StreamPart = {
     type: "error";
     error: unknown;
 };
-interface Message {
-    role: "system" | "user" | "assistant";
-    content: string;
+/** Plain text segment inside a multimodal user message. */
+interface TextPart {
+    type: "text";
+    text: string;
 }
+/**
+ * Image segment inside a multimodal user message. Mirrors Vercel AI SDK's
+ * `ImagePart` shape — the discriminator is `"image"` and the data field is
+ * `image` (not `image_url`). The SDK converts to the OpenAI `image_url`
+ * wire format internally.
+ */
+interface ImagePart {
+    type: "image";
+    /**
+     * Accepted forms:
+     *  - HTTP(S) URL string (`"https://…"`) — passed through; the provider fetches it.
+     *  - Data URL string (`"data:image/png;base64,…"`) — passed through.
+     *  - Raw base64 string (no `data:` prefix) — `mediaType` then required.
+     *  - `Uint8Array` / `ArrayBuffer` — base64-encoded; `mediaType` required.
+     *  - `URL` instance — `href` is passed through.
+     */
+    image: string | Uint8Array | ArrayBuffer | URL;
+    /** IANA media type, e.g. `"image/png"`. Required when `image` is binary or a raw base64 string. */
+    mediaType?: string;
+    /** OpenAI-compatible detail hint; forwarded as `image_url.detail`. */
+    detail?: "auto" | "low" | "high";
+}
+/**
+ * Content for a user message — either a plain string (back-compat with the
+ * original text-only shape) or an array of text/image parts.
+ */
+type UserContent = string | Array<TextPart | ImagePart>;
+/**
+ * Chat message. `user` messages may carry multimodal content; `system` and
+ * `assistant` are text-only (vision models consume images on user turns,
+ * and image *output* isn't supported here).
+ */
+type Message = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: UserContent;
+} | {
+    role: "assistant";
+    content: string;
+};
 /**
  * OpenAI/Fireworks SSE chunk shape, only the fields we actually consume.
  * Kept as a local type so we don't depend on backend internals.
@@ -1794,6 +1837,99 @@ declare class RagableBrowserStorageClient {
     constructor(options: RagableBrowserClientOptions, fetchImpl: typeof fetch);
     from(bucketId: string): BrowserStorageBucketClient;
 }
+interface MailSendParams {
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    /** Plain-text body. At least one of `bodyText` / `bodyHtml` is required. */
+    bodyText?: string;
+    /** HTML body. If both are set, sent as multipart/alternative. */
+    bodyHtml?: string;
+    /** RFC 822 Message-ID of the message you're replying to (enables threading). */
+    inReplyToMessageId?: string;
+    /** Existing References header value, chained with In-Reply-To. */
+    referencesHeader?: string;
+}
+interface MailSendResult {
+    sentMailMessageId: string;
+    gmailMessageId: string;
+    gmailThreadId: string;
+    fromAddress: string;
+}
+interface MailSearchParams {
+    /** Gmail search syntax, e.g. `from:alice is:unread newer_than:7d`. */
+    query?: string;
+    /** 1–50; default 20. */
+    maxResults?: number;
+    pageToken?: string;
+    labelIds?: string[];
+}
+interface MailMessagePreview {
+    id: string;
+    threadId: string;
+    snippet: string;
+    labelIds: string[];
+}
+interface MailMessageDetail {
+    id: string;
+    threadId: string;
+    receivedAt: number;
+    fromAddress: string;
+    fromName: string | null;
+    to: string[];
+    cc: string[];
+    subject: string;
+    snippet: string;
+    bodyText: string | null;
+    bodyHtml: string | null;
+    messageIdHeader: string | null;
+    referencesHeader: string | null;
+    labelIds: string[];
+}
+/**
+ * Send and read email through the Gmail account linked to this Ragable
+ * website (via the IDE Infrastructure → Integrations tab).
+ *
+ * All requests require a Bearer token — either an end-user JWT from this
+ * website's auth group (call `client.auth.signIn(...)` first) or the
+ * data-admin key (server-side use).
+ *
+ * The website MUST have:
+ *   1. A Gmail account linked under Integrations
+ *   2. An auth group linked under Auth
+ *
+ * Otherwise calls return a 412 with a clear error message.
+ */
+declare class RagableBrowserMailClient {
+    private readonly options;
+    private readonly auth;
+    private readonly fetchImpl;
+    constructor(options: RagableBrowserClientOptions, auth: RagableAuth | null);
+    private requireWebsiteId;
+    private pathTo;
+    /**
+     * Get the Bearer token used to authenticate the call:
+     *  1. End-user access token (preferred when an auth group is configured
+     *     and the user has signed in)
+     *  2. `dataStaticKey` from createBrowserClient options
+     *  3. Caller-supplied `getAccessToken()`
+     *
+     * If none is available, throws — server-side use should pass the
+     * data-admin key as `dataStaticKey`.
+     */
+    private getBearerToken;
+    private request;
+    /** Send an email from this website's linked Gmail account. */
+    send(params: MailSendParams): Promise<MailSendResult>;
+    /** Search messages with Gmail query syntax. */
+    search(params?: MailSearchParams): Promise<{
+        messages: MailMessagePreview[];
+        nextPageToken: string | null;
+    }>;
+    /** Fetch a single message in full (headers + decoded text/html body). */
+    getMessage(messageId: string): Promise<MailMessageDetail>;
+}
 interface AgentConversationMessage {
     role: "user" | "assistant";
     content: string;
@@ -1933,6 +2069,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     readonly database: RagableBrowserDatabaseClient<Database>;
     readonly db: RagableBrowserDatabaseClient<Database>;
     readonly storage: RagableBrowserStorageClient;
+    readonly mail: RagableBrowserMailClient;
     readonly transport: Transport;
     private readonly _ragableAuth;
     constructor(options: RagableBrowserClientOptions);
@@ -1955,6 +2092,45 @@ declare function parseSseDataLine(line: string): SseJsonEvent | null;
  */
 declare function readSseStream(body: ReadableStream<Uint8Array>): AsyncGenerator<SseJsonEvent, void, undefined>;
 
+/**
+ * Convert SDK-shape multimodal content to the OpenAI/Fireworks `image_url`
+ * wire format the Ragable inference proxy expects. Keeps the public SDK
+ * types Vercel-AI-SDK-shaped (`{ type: "image", image: ... }`) while the
+ * over-the-wire shape stays OpenAI canonical.
+ */
+
+/** OpenAI/Fireworks image content part — what flows on the wire. */
+interface WireImagePart {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "auto" | "low" | "high";
+    };
+}
+type WireTextPart = {
+    type: "text";
+    text: string;
+};
+type WireContentPart = WireTextPart | WireImagePart;
+type WireUserContent = string | WireContentPart[];
+/**
+ * Convert a single `UserContent` value to wire shape. Strings pass through
+ * unchanged so existing callers keep producing byte-identical request bodies.
+ */
+declare function toWireUserContent(content: UserContent): WireUserContent;
+/**
+ * Resolve an `ImagePart.image` value into a URL string suitable for
+ * `image_url.url`. URLs pass through; binary and raw base64 are wrapped
+ * into a data URL.
+ */
+declare function imagePartToUrl(part: ImagePart): string;
+/**
+ * Cross-runtime `Uint8Array → base64`. `btoa(String.fromCharCode(...bytes))`
+ * trips the JS call-stack limit on large payloads, so we chunk the binary
+ * string. Works in browser, Node 18+, Edge, and Bun.
+ */
+declare function bytesToBase64(bytes: Uint8Array): string;
+
 /**
  * Best-effort parser for incomplete JSON streamed token-by-token from an LLM.
  *
@@ -1973,4 +2149,4 @@ declare function tryParsePartialJson(text: string): unknown | undefined;
 
 declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 
-export { type AgentChatMessage, type AgentChatParams, type AgentChatStreamDonePayload, type AgentChatStreamHandlers, type AgentChatStreamResult, type AgentChatStreamUiHandlers, type AgentChatUiAssistantMessage, type AgentChatUiSegment, type AgentChatUiStreamResult, type AgentConversation, type AgentConversationMessage, type AgentConversationSubscription, type AgentPublicChatParams, type AgentStreamAgentInfoEvent, type AgentStreamEvent, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type AuthSignUpCredentials, type AuthUpdateUserAttributes, type AuthUserMetadata, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, BrowserStorageBucketClient, type BrowserStorageBulkDeleteResult, type BrowserStorageDownloadResult, type BrowserStorageItem, type BrowserStorageListResult, type BrowserStorageSignedUrlResult, type BrowserStorageUploadResult, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FinishReason, type GenerateObjectResult, type GenerateTextResult, type HttpMethod, type Json, type JsonSchema, LocalStorageAdapter, MemoryStorageAdapter, type Message, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAiClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, RagableBrowserStorageClient, type RagableDatabase, RagableError, RagableNetworkError, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type SseJsonEvent, type StreamObjectParams, type StreamObjectResult, type StreamPart, type StreamTextParams, type StreamTextResult, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, type TokenUsage, type ToolCallRecord, Transport, type TransportOptions, type TransportRequest, type WhereInput, type WhereOperatorObject, asPostgrestResponse, assertPostgrestSuccess, bindFetch, buildInferenceRequestBody, buildResponseFormat, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagableBrowserClient, createStreamResultFromParts, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatSdkError, generateIdempotencyKey, isIncompleteAgentStreamError, mapAgentEvent, mapFireworksChunk, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, streamObjectFromContext, toRagableResult, tryParsePartialJson, unwrapPostgrest, wrapStreamTextAsObject };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatStreamDonePayload, type AgentChatStreamHandlers, type AgentChatStreamResult, type AgentChatStreamUiHandlers, type AgentChatUiAssistantMessage, type AgentChatUiSegment, type AgentChatUiStreamResult, type AgentConversation, type AgentConversationMessage, type AgentConversationSubscription, type AgentPublicChatParams, type AgentStreamAgentInfoEvent, type AgentStreamEvent, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type AuthSignUpCredentials, type AuthUpdateUserAttributes, type AuthUserMetadata, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, BrowserStorageBucketClient, type BrowserStorageBulkDeleteResult, type BrowserStorageDownloadResult, type BrowserStorageItem, type BrowserStorageListResult, type BrowserStorageSignedUrlResult, type BrowserStorageUploadResult, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FinishReason, type GenerateObjectResult, type GenerateTextResult, type HttpMethod, type ImagePart, type Json, type JsonSchema, LocalStorageAdapter, type MailMessageDetail, type MailMessagePreview, type MailSearchParams, type MailSendParams, type MailSendResult, MemoryStorageAdapter, type Message, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAiClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, RagableBrowserMailClient, RagableBrowserStorageClient, type RagableDatabase, RagableError, RagableNetworkError, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type SseJsonEvent, type StreamObjectParams, type StreamObjectResult, type StreamPart, type StreamTextParams, type StreamTextResult, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, type TextPart, type TokenUsage, type ToolCallRecord, Transport, type TransportOptions, type TransportRequest, type UserContent, type WhereInput, type WhereOperatorObject, type WireContentPart, type WireImagePart, type WireTextPart, type WireUserContent, asPostgrestResponse, assertPostgrestSuccess, bindFetch, buildInferenceRequestBody, buildResponseFormat, bytesToBase64, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagableBrowserClient, createStreamResultFromParts, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatSdkError, generateIdempotencyKey, imagePartToUrl, isIncompleteAgentStreamError, mapAgentEvent, mapFireworksChunk, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, streamObjectFromContext, toRagableResult, toWireUserContent, tryParsePartialJson, unwrapPostgrest, wrapStreamTextAsObject };

package/dist/index.d.ts

@@ -981,10 +981,53 @@ type StreamPart = {
     type: "error";
     error: unknown;
 };
-interface Message {
-    role: "system" | "user" | "assistant";
-    content: string;
+/** Plain text segment inside a multimodal user message. */
+interface TextPart {
+    type: "text";
+    text: string;
 }
+/**
+ * Image segment inside a multimodal user message. Mirrors Vercel AI SDK's
+ * `ImagePart` shape — the discriminator is `"image"` and the data field is
+ * `image` (not `image_url`). The SDK converts to the OpenAI `image_url`
+ * wire format internally.
+ */
+interface ImagePart {
+    type: "image";
+    /**
+     * Accepted forms:
+     *  - HTTP(S) URL string (`"https://…"`) — passed through; the provider fetches it.
+     *  - Data URL string (`"data:image/png;base64,…"`) — passed through.
+     *  - Raw base64 string (no `data:` prefix) — `mediaType` then required.
+     *  - `Uint8Array` / `ArrayBuffer` — base64-encoded; `mediaType` required.
+     *  - `URL` instance — `href` is passed through.
+     */
+    image: string | Uint8Array | ArrayBuffer | URL;
+    /** IANA media type, e.g. `"image/png"`. Required when `image` is binary or a raw base64 string. */
+    mediaType?: string;
+    /** OpenAI-compatible detail hint; forwarded as `image_url.detail`. */
+    detail?: "auto" | "low" | "high";
+}
+/**
+ * Content for a user message — either a plain string (back-compat with the
+ * original text-only shape) or an array of text/image parts.
+ */
+type UserContent = string | Array<TextPart | ImagePart>;
+/**
+ * Chat message. `user` messages may carry multimodal content; `system` and
+ * `assistant` are text-only (vision models consume images on user turns,
+ * and image *output* isn't supported here).
+ */
+type Message = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: UserContent;
+} | {
+    role: "assistant";
+    content: string;
+};
 /**
  * OpenAI/Fireworks SSE chunk shape, only the fields we actually consume.
  * Kept as a local type so we don't depend on backend internals.
@@ -1794,6 +1837,99 @@ declare class RagableBrowserStorageClient {
     constructor(options: RagableBrowserClientOptions, fetchImpl: typeof fetch);
     from(bucketId: string): BrowserStorageBucketClient;
 }
+interface MailSendParams {
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    /** Plain-text body. At least one of `bodyText` / `bodyHtml` is required. */
+    bodyText?: string;
+    /** HTML body. If both are set, sent as multipart/alternative. */
+    bodyHtml?: string;
+    /** RFC 822 Message-ID of the message you're replying to (enables threading). */
+    inReplyToMessageId?: string;
+    /** Existing References header value, chained with In-Reply-To. */
+    referencesHeader?: string;
+}
+interface MailSendResult {
+    sentMailMessageId: string;
+    gmailMessageId: string;
+    gmailThreadId: string;
+    fromAddress: string;
+}
+interface MailSearchParams {
+    /** Gmail search syntax, e.g. `from:alice is:unread newer_than:7d`. */
+    query?: string;
+    /** 1–50; default 20. */
+    maxResults?: number;
+    pageToken?: string;
+    labelIds?: string[];
+}
+interface MailMessagePreview {
+    id: string;
+    threadId: string;
+    snippet: string;
+    labelIds: string[];
+}
+interface MailMessageDetail {
+    id: string;
+    threadId: string;
+    receivedAt: number;
+    fromAddress: string;
+    fromName: string | null;
+    to: string[];
+    cc: string[];
+    subject: string;
+    snippet: string;
+    bodyText: string | null;
+    bodyHtml: string | null;
+    messageIdHeader: string | null;
+    referencesHeader: string | null;
+    labelIds: string[];
+}
+/**
+ * Send and read email through the Gmail account linked to this Ragable
+ * website (via the IDE Infrastructure → Integrations tab).
+ *
+ * All requests require a Bearer token — either an end-user JWT from this
+ * website's auth group (call `client.auth.signIn(...)` first) or the
+ * data-admin key (server-side use).
+ *
+ * The website MUST have:
+ *   1. A Gmail account linked under Integrations
+ *   2. An auth group linked under Auth
+ *
+ * Otherwise calls return a 412 with a clear error message.
+ */
+declare class RagableBrowserMailClient {
+    private readonly options;
+    private readonly auth;
+    private readonly fetchImpl;
+    constructor(options: RagableBrowserClientOptions, auth: RagableAuth | null);
+    private requireWebsiteId;
+    private pathTo;
+    /**
+     * Get the Bearer token used to authenticate the call:
+     *  1. End-user access token (preferred when an auth group is configured
+     *     and the user has signed in)
+     *  2. `dataStaticKey` from createBrowserClient options
+     *  3. Caller-supplied `getAccessToken()`
+     *
+     * If none is available, throws — server-side use should pass the
+     * data-admin key as `dataStaticKey`.
+     */
+    private getBearerToken;
+    private request;
+    /** Send an email from this website's linked Gmail account. */
+    send(params: MailSendParams): Promise<MailSendResult>;
+    /** Search messages with Gmail query syntax. */
+    search(params?: MailSearchParams): Promise<{
+        messages: MailMessagePreview[];
+        nextPageToken: string | null;
+    }>;
+    /** Fetch a single message in full (headers + decoded text/html body). */
+    getMessage(messageId: string): Promise<MailMessageDetail>;
+}
 interface AgentConversationMessage {
     role: "user" | "assistant";
     content: string;
@@ -1933,6 +2069,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     readonly database: RagableBrowserDatabaseClient<Database>;
     readonly db: RagableBrowserDatabaseClient<Database>;
     readonly storage: RagableBrowserStorageClient;
+    readonly mail: RagableBrowserMailClient;
     readonly transport: Transport;
     private readonly _ragableAuth;
     constructor(options: RagableBrowserClientOptions);
@@ -1955,6 +2092,45 @@ declare function parseSseDataLine(line: string): SseJsonEvent | null;
  */
 declare function readSseStream(body: ReadableStream<Uint8Array>): AsyncGenerator<SseJsonEvent, void, undefined>;
 
+/**
+ * Convert SDK-shape multimodal content to the OpenAI/Fireworks `image_url`
+ * wire format the Ragable inference proxy expects. Keeps the public SDK
+ * types Vercel-AI-SDK-shaped (`{ type: "image", image: ... }`) while the
+ * over-the-wire shape stays OpenAI canonical.
+ */
+
+/** OpenAI/Fireworks image content part — what flows on the wire. */
+interface WireImagePart {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "auto" | "low" | "high";
+    };
+}
+type WireTextPart = {
+    type: "text";
+    text: string;
+};
+type WireContentPart = WireTextPart | WireImagePart;
+type WireUserContent = string | WireContentPart[];
+/**
+ * Convert a single `UserContent` value to wire shape. Strings pass through
+ * unchanged so existing callers keep producing byte-identical request bodies.
+ */
+declare function toWireUserContent(content: UserContent): WireUserContent;
+/**
+ * Resolve an `ImagePart.image` value into a URL string suitable for
+ * `image_url.url`. URLs pass through; binary and raw base64 are wrapped
+ * into a data URL.
+ */
+declare function imagePartToUrl(part: ImagePart): string;
+/**
+ * Cross-runtime `Uint8Array → base64`. `btoa(String.fromCharCode(...bytes))`
+ * trips the JS call-stack limit on large payloads, so we chunk the binary
+ * string. Works in browser, Node 18+, Edge, and Bun.
+ */
+declare function bytesToBase64(bytes: Uint8Array): string;
+
 /**
  * Best-effort parser for incomplete JSON streamed token-by-token from an LLM.
  *
@@ -1973,4 +2149,4 @@ declare function tryParsePartialJson(text: string): unknown | undefined;
 
 declare function createClient<Database extends RagableDatabase = DefaultRagableDatabase, AuthUser extends object = DefaultAuthUser>(options: RagableBrowserClientOptions): RagableBrowser<Database, AuthUser>;
 
-export { type AgentChatMessage, type AgentChatParams, type AgentChatStreamDonePayload, type AgentChatStreamHandlers, type AgentChatStreamResult, type AgentChatStreamUiHandlers, type AgentChatUiAssistantMessage, type AgentChatUiSegment, type AgentChatUiStreamResult, type AgentConversation, type AgentConversationMessage, type AgentConversationSubscription, type AgentPublicChatParams, type AgentStreamAgentInfoEvent, type AgentStreamEvent, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type AuthSignUpCredentials, type AuthUpdateUserAttributes, type AuthUserMetadata, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, BrowserStorageBucketClient, type BrowserStorageBulkDeleteResult, type BrowserStorageDownloadResult, type BrowserStorageItem, type BrowserStorageListResult, type BrowserStorageSignedUrlResult, type BrowserStorageUploadResult, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FinishReason, type GenerateObjectResult, type GenerateTextResult, type HttpMethod, type Json, type JsonSchema, LocalStorageAdapter, MemoryStorageAdapter, type Message, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAiClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, RagableBrowserStorageClient, type RagableDatabase, RagableError, RagableNetworkError, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type SseJsonEvent, type StreamObjectParams, type StreamObjectResult, type StreamPart, type StreamTextParams, type StreamTextResult, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, type TokenUsage, type ToolCallRecord, Transport, type TransportOptions, type TransportRequest, type WhereInput, type WhereOperatorObject, asPostgrestResponse, assertPostgrestSuccess, bindFetch, buildInferenceRequestBody, buildResponseFormat, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagableBrowserClient, createStreamResultFromParts, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatSdkError, generateIdempotencyKey, isIncompleteAgentStreamError, mapAgentEvent, mapFireworksChunk, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, streamObjectFromContext, toRagableResult, tryParsePartialJson, unwrapPostgrest, wrapStreamTextAsObject };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatStreamDonePayload, type AgentChatStreamHandlers, type AgentChatStreamResult, type AgentChatStreamUiHandlers, type AgentChatUiAssistantMessage, type AgentChatUiSegment, type AgentChatUiStreamResult, type AgentConversation, type AgentConversationMessage, type AgentConversationSubscription, type AgentPublicChatParams, type AgentStreamAgentInfoEvent, type AgentStreamEvent, AuthBroadcastChannel, type AuthBroadcastMessage, type AuthChangeEvent, type AuthOptions, type AuthSession, type AuthSignUpCredentials, type AuthUpdateUserAttributes, type AuthUserMetadata, type BrowserAuthSession, type BrowserAuthTokens, BrowserCollectionApi, type BrowserCollectionDefinition, type BrowserCollectionFactory, type BrowserCollectionFindParams, type BrowserCollectionRecord, type BrowserCollections, type BrowserDataAuthMode, type BrowserRealtimeNotification, type BrowserRealtimeStatus, type BrowserRealtimeSubscribeParams, type BrowserRealtimeSubscription, type BrowserSqlExecParams, type BrowserSqlExecResult, type BrowserSqlQueryParams, type BrowserSqlQueryResult, BrowserStorageBucketClient, type BrowserStorageBulkDeleteResult, type BrowserStorageDownloadResult, type BrowserStorageItem, type BrowserStorageListResult, type BrowserStorageSignedUrlResult, type BrowserStorageUploadResult, type CollectionReturnMode, type CollectionRowData, type CollectionRowWithMeta, type CollectionWhere, type ColumnName, type ColumnValue, CookieStorageAdapter, DEFAULT_RAGABLE_API_BASE, type DefaultAuthUser, type DefaultRagableDatabase, type FinishReason, type GenerateObjectResult, type GenerateTextResult, type HttpMethod, type ImagePart, type Json, type JsonSchema, LocalStorageAdapter, type MailMessageDetail, type MailMessagePreview, type MailSearchParams, type MailSendParams, type MailSendResult, MemoryStorageAdapter, type Message, type PostgRESTFetch, type PostgRESTFetchParams, PostgrestDeleteReturningBuilder, PostgrestDeleteRootBuilder, PostgrestInsertReturningBuilder, PostgrestInsertRootBuilder, PostgrestInsertSdkErrorReturning, PostgrestInsertSdkErrorRoot, type PostgrestResult, PostgrestSelectBuilder, PostgrestTableApi, PostgrestUpdateReturningBuilder, PostgrestUpdateRootBuilder, type PostgrestUpsertOptions, PostgrestUpsertReturningBuilder, PostgrestUpsertRootBuilder, RagableAbortError, RagableAuth, type RagableAuthConfig, RagableBrowser, RagableBrowserAgentsClient, RagableBrowserAiClient, RagableBrowserAuthClient, type RagableBrowserClientOptions, RagableBrowserDatabaseClient, RagableBrowserMailClient, RagableBrowserStorageClient, type RagableDatabase, RagableError, RagableNetworkError, type RagableResult, RagableSdkError, type RagableTableDefinition, type RagableTableNames, RagableTimeoutError, type RequestOptions, type RetryOptions, type RunAgentChatStreamOptions, type RunQuery, type SessionStorage, SessionStorageAdapter, type SseJsonEvent, type StreamObjectParams, type StreamObjectResult, type StreamPart, type StreamTextParams, type StreamTextResult, type SupabaseCompatSession, type TableInsertRow, type TableRow, type TableUpdatePatch, type Tables, type TablesInsert, type TablesUpdate, type TextPart, type TokenUsage, type ToolCallRecord, Transport, type TransportOptions, type TransportRequest, type UserContent, type WhereInput, type WhereOperatorObject, type WireContentPart, type WireImagePart, type WireTextPart, type WireUserContent, asPostgrestResponse, assertPostgrestSuccess, bindFetch, buildInferenceRequestBody, buildResponseFormat, bytesToBase64, collectAssistantTextFromUiSegments, collectionRecordToRowWithMeta, collectionRecordsToRowWithMeta, createBrowserClient, createClient, createRagableBrowserClient, createStreamResultFromParts, detectStorage, effectiveDataAuth, extractErrorMessage, finalizeAgentChatUiTurn, foldAgentStreamIntoUiSegments, formatPostgrestError, formatSdkError, generateIdempotencyKey, imagePartToUrl, isIncompleteAgentStreamError, mapAgentEvent, mapFireworksChunk, normalizeBrowserApiBase, parseAgentStreamAgentInfo, parseAgentStreamDone, parseSseDataLine, parseTransportResponse, readSseStream, runAgentChatStream, runAgentChatStreamForUi, runAgentChatStreamLenient, streamObjectFromContext, toRagableResult, toWireUserContent, tryParsePartialJson, unwrapPostgrest, wrapStreamTextAsObject };