@ragable/sdk 0.7.9 → 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.
@@ -2049,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.
  *
@@ -2067,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, 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 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.
@@ -2049,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.
  *
@@ -2067,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, 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 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.js

@@ -60,6 +60,7 @@ __export(index_exports, {
   bindFetch: () => bindFetch,
   buildInferenceRequestBody: () => buildInferenceRequestBody,
   buildResponseFormat: () => buildResponseFormat,
+  bytesToBase64: () => bytesToBase64,
   collectAssistantTextFromUiSegments: () => collectAssistantTextFromUiSegments,
   collectionRecordToRowWithMeta: () => collectionRecordToRowWithMeta,
   collectionRecordsToRowWithMeta: () => collectionRecordsToRowWithMeta,
@@ -75,6 +76,7 @@ __export(index_exports, {
   formatPostgrestError: () => formatPostgrestError,
   formatSdkError: () => formatSdkError,
   generateIdempotencyKey: () => generateIdempotencyKey,
+  imagePartToUrl: () => imagePartToUrl,
   isIncompleteAgentStreamError: () => isIncompleteAgentStreamError,
   mapAgentEvent: () => mapAgentEvent,
   mapFireworksChunk: () => mapFireworksChunk,
@@ -89,6 +91,7 @@ __export(index_exports, {
   runAgentChatStreamLenient: () => runAgentChatStreamLenient,
   streamObjectFromContext: () => streamObjectFromContext,
   toRagableResult: () => toRagableResult,
+  toWireUserContent: () => toWireUserContent,
   tryParsePartialJson: () => tryParsePartialJson,
   unwrapPostgrest: () => unwrapPostgrest,
   wrapStreamTextAsObject: () => wrapStreamTextAsObject
@@ -2428,6 +2431,95 @@ function stripTrailingCommas(text) {
   return text.replace(/,(\s*[}\]])/g, "$1").replace(/,\s*$/, "");
 }
 
+// src/content.ts
+var MAX_IMAGE_BYTES = 5 * 1024 * 1024;
+function toWireUserContent(content) {
+  if (typeof content === "string") return content;
+  const out = [];
+  for (const part of content) {
+    if (!part) continue;
+    if (part.type === "text") {
+      out.push(toWireTextPart(part));
+    } else if (part.type === "image") {
+      out.push(toWireImagePart(part));
+    }
+  }
+  return out;
+}
+function toWireTextPart(part) {
+  return { type: "text", text: part.text };
+}
+function toWireImagePart(part) {
+  const url = imagePartToUrl(part);
+  const detail = part.detail;
+  return {
+    type: "image_url",
+    image_url: detail ? { url, detail } : { url }
+  };
+}
+function imagePartToUrl(part) {
+  const img = part.image;
+  if (img instanceof URL) return img.href;
+  if (typeof img === "string") {
+    if (img.startsWith("http://") || img.startsWith("https://")) return img;
+    if (img.startsWith("data:")) return img;
+    const mediaType = requireMediaType(part, "raw base64 string");
+    assertBase64SizeOk(img);
+    return `data:${mediaType};base64,${img}`;
+  }
+  if (img instanceof Uint8Array || img instanceof ArrayBuffer) {
+    const bytes = img instanceof Uint8Array ? img : new Uint8Array(img);
+    assertBinarySizeOk(bytes);
+    const mediaType = requireMediaType(part, "binary image data");
+    const b64 = bytesToBase64(bytes);
+    return `data:${mediaType};base64,${b64}`;
+  }
+  throw new RagableError(
+    "ImagePart.image must be a string, URL, Uint8Array, or ArrayBuffer",
+    400,
+    { code: "SDK_INVALID_IMAGE_PART" }
+  );
+}
+function requireMediaType(part, what) {
+  const m = part.mediaType?.trim();
+  if (!m) {
+    throw new RagableError(
+      `ImagePart.mediaType is required for ${what} (e.g. "image/png")`,
+      400,
+      { code: "SDK_IMAGE_MEDIA_TYPE_REQUIRED" }
+    );
+  }
+  return m;
+}
+function assertBinarySizeOk(bytes) {
+  if (bytes.byteLength > MAX_IMAGE_BYTES) {
+    throw new RagableError(
+      `Image exceeds 5MB limit (${bytes.byteLength} bytes)`,
+      400,
+      { code: "SDK_IMAGE_TOO_LARGE" }
+    );
+  }
+}
+function assertBase64SizeOk(b64) {
+  const approxBytes = Math.floor(b64.length * 3 / 4);
+  if (approxBytes > MAX_IMAGE_BYTES) {
+    throw new RagableError(
+      `Image exceeds 5MB limit (~${approxBytes} bytes decoded)`,
+      400,
+      { code: "SDK_IMAGE_TOO_LARGE" }
+    );
+  }
+}
+function bytesToBase64(bytes) {
+  const CHUNK = 32768;
+  let binary = "";
+  for (let i = 0; i < bytes.length; i += CHUNK) {
+    const slice = bytes.subarray(i, i + CHUNK);
+    binary += String.fromCharCode(...slice);
+  }
+  return btoa(binary);
+}
+
 // src/stream-parts.ts
 function normalizeFinishReason(raw) {
   switch (raw) {
@@ -2640,7 +2732,9 @@ var ZERO_USAGE = {
 function buildInferenceRequestBody(params, responseFormat) {
   const body = {
     model: params.model,
-    messages: params.messages
+    messages: params.messages.map(
+      (m) => m.role === "user" ? { role: "user", content: toWireUserContent(m.content) } : m
+    )
   };
   if (params.system !== void 0) body.system = params.system;
   if (typeof params.temperature === "number")
@@ -4416,6 +4510,7 @@ function createClient(options) {
   bindFetch,
   buildInferenceRequestBody,
   buildResponseFormat,
+  bytesToBase64,
   collectAssistantTextFromUiSegments,
   collectionRecordToRowWithMeta,
   collectionRecordsToRowWithMeta,
@@ -4431,6 +4526,7 @@ function createClient(options) {
   formatPostgrestError,
   formatSdkError,
   generateIdempotencyKey,
+  imagePartToUrl,
   isIncompleteAgentStreamError,
   mapAgentEvent,
   mapFireworksChunk,
@@ -4445,6 +4541,7 @@ function createClient(options) {
   runAgentChatStreamLenient,
   streamObjectFromContext,
   toRagableResult,
+  toWireUserContent,
   tryParsePartialJson,
   unwrapPostgrest,
   wrapStreamTextAsObject