deepspace 0.20.0 → 0.22.0

package/dist/index.d.ts

@@ -628,6 +628,7 @@ declare const MSG: {
     readonly CRON_PAUSE: "cron.pause";
     readonly CRON_RESUME: "cron.resume";
     readonly CRON_STATUS: "cron.status";
+    readonly CRON_ACK: "cron.ack";
     readonly JOB_ENQUEUE: "job.enqueue";
     readonly JOB_CANCEL: "job.cancel";
     readonly JOB_RETRY: "job.retry";
@@ -791,10 +792,13 @@ type ClientMessage = BaseMessage<typeof MSG.SUBSCRIBE, {
     props: Record<string, unknown>;
 }> | BaseMessage<typeof MSG.CANVAS_VIEWPORT, unknown> | BaseMessage<typeof MSG.CANVAS_UNDO, EmptyPayload> | BaseMessage<typeof MSG.CANVAS_REDO, EmptyPayload> | BaseMessage<typeof MSG.CRON_TRIGGER, {
     taskName: string;
+    requestId?: string;
 }> | BaseMessage<typeof MSG.CRON_PAUSE, {
     taskName: string;
+    requestId?: string;
 }> | BaseMessage<typeof MSG.CRON_RESUME, {
     taskName: string;
+    requestId?: string;
 }> | BaseMessage<typeof MSG.JOB_ENQUEUE, {
     requestId: string;
     type: string;
@@ -881,6 +885,16 @@ type ServerMessage = BaseMessage<typeof MSG.QUERY_RESULT, {
 }> | BaseMessage<typeof MSG.CRON_STATUS, {
     tasks: unknown;
     recentHistory: unknown;
+}> | BaseMessage<typeof MSG.CRON_ACK, {
+    requestId: string;
+    taskName: string;
+    ok: true;
+} | {
+    requestId: string;
+    taskName?: string;
+    ok: false;
+    reason: 'read_only' | 'unknown_task' | 'failed';
+    error?: string;
 }> | BaseMessage<typeof MSG.JOB_UPDATE, {
     kind: 'snapshot' | 'enqueued' | 'progress' | 'succeeded' | 'failed' | 'canceled' | 'retried';
     job?: unknown;
@@ -1021,22 +1035,25 @@ declare const clientBuild: {
         readonly type: "canvas.redo";
         readonly payload: EmptyPayload;
     };
-    cronTrigger: (taskName: string) => {
+    cronTrigger: (taskName: string, requestId?: string) => {
         readonly type: "cron.trigger";
         readonly payload: {
             readonly taskName: string;
+            readonly requestId: string | undefined;
         };
     };
-    cronPause: (taskName: string) => {
+    cronPause: (taskName: string, requestId?: string) => {
         readonly type: "cron.pause";
         readonly payload: {
             readonly taskName: string;
+            readonly requestId: string | undefined;
         };
     };
-    cronResume: (taskName: string) => {
+    cronResume: (taskName: string, requestId?: string) => {
         readonly type: "cron.resume";
         readonly payload: {
             readonly taskName: string;
+            readonly requestId: string | undefined;
         };
     };
     jobEnqueue: (requestId: string, type: string, payload?: unknown, maxAttempts?: number) => {
@@ -1234,6 +1251,24 @@ declare const serverBuild: {
             readonly recentHistory: unknown;
         };
     };
+    cronAckSuccess: (requestId: string, taskName: string) => {
+        readonly type: "cron.ack";
+        readonly payload: {
+            readonly requestId: string;
+            readonly taskName: string;
+            readonly ok: true;
+        };
+    };
+    cronAckFailure: (requestId: string, reason: "read_only" | "unknown_task" | "failed", error?: string, taskName?: string) => {
+        readonly type: "cron.ack";
+        readonly payload: {
+            readonly requestId: string;
+            readonly taskName: string | undefined;
+            readonly ok: false;
+            readonly reason: "read_only" | "unknown_task" | "failed";
+            readonly error: string | undefined;
+        };
+    };
     jobSnapshot: (jobs: unknown[]) => {
         readonly type: "job.update";
         readonly payload: {
@@ -2633,6 +2668,8 @@ declare function clearAuthToken(): void;
  * Primary: OAuth (GitHub, Google).
  * Secondary: Email/password sign-in (for test accounts created via CLI/API).
  * Styled with shadcn semantic tokens so it themes along with the host app.
+ * Hosts can brand the card via `title` / `description` / `logo` and re-tint
+ * the backdrop by defining `--ds-auth-backdrop` (defaults to black/55).
  */
 
 interface AuthOverlayProps {
@@ -2640,8 +2677,14 @@ interface AuthOverlayProps {
     onClose?: () => void;
     /** Which OAuth providers to show. Defaults to both. */
     providers?: Array<'github' | 'google'>;
+    /** Card heading. Defaults to "Sign in to DeepSpace". */
+    title?: string;
+    /** Line under the heading. Defaults to "Sync your data across devices". */
+    description?: string;
+    /** Optional brand mark rendered above the heading. Defaults to none (the current look). */
+    logo?: React__default.ReactNode;
 }
-declare function AuthOverlay({ onClose, providers, }?: AuthOverlayProps): React__default.ReactElement | null;
+declare function AuthOverlay({ onClose, providers, title, description, logo, }?: AuthOverlayProps): React__default.ReactElement | null;
 
 /** Conditional renderers, the route gate, and a display-name hook. */
 
@@ -3332,6 +3375,11 @@ declare function useCanvas(roomId: string): UseCanvasResult;
  *
  * @example
  * const { tasks, history, trigger, pause, resume } = useCronMonitor('cron')
+ *
+ * async function onRunNow() {
+ *   const receipt = await trigger('daily-digest')
+ *   if (!receipt.ok) toast(receipt.error ?? receipt.reason)
+ * }
  */
 interface CronTaskState {
     name: string;
@@ -3350,6 +3398,24 @@ interface CronHistoryEntry {
     durationMs: number;
     error?: string;
 }
+/**
+ * Outcome of a cron mutation (trigger / pause / resume). Failures are
+ * typed by origin: `read_only` and `not_connected` short-circuit locally
+ * without sending a frame; `unknown_task` and `failed` come back in the
+ * server's CRON_ACK receipt. Triggers execute synchronously in the DO
+ * before the receipt is sent, so an ok trigger result means the run
+ * completed — its execution record (duration, errors) arrives via
+ * `history`.
+ */
+type CronMutationResult = {
+    ok: true;
+    taskName: string;
+    requestId: string;
+} | {
+    ok: false;
+    reason: 'read_only' | 'not_connected' | 'unknown_task' | 'failed';
+    error?: string;
+};
 interface UseCronMonitorResult {
     /** Current task states */
     tasks: CronTaskState[];
@@ -3360,16 +3426,22 @@ interface UseCronMonitorResult {
     /**
      * Whether this connection can mutate cron state (trigger / pause /
      * resume). False for viewers and unauthenticated connections — the
-     * mutation callbacks below no-op and UIs should disable those
-     * controls. Reading tasks/history stays available either way.
+     * mutation callbacks below resolve `{ ok: false, reason: 'read_only' }`
+     * and UIs should disable those controls. Reading tasks/history stays
+     * available either way.
      */
     canWrite: boolean;
-    /** Manually trigger a task (no-op when canWrite is false) */
-    trigger: (taskName: string) => void;
-    /** Pause a task (no-op when canWrite is false) */
-    pause: (taskName: string) => void;
-    /** Resume a paused task (no-op when canWrite is false) */
-    resume: (taskName: string) => void;
+    /**
+     * Most recent ERROR frame from the room (e.g. a write rejected by a
+     * concurrent role change). Null until one arrives.
+     */
+    lastError: string | null;
+    /** Manually trigger a task; resolves once the run completes. */
+    trigger: (taskName: string) => Promise<CronMutationResult>;
+    /** Pause a task; resolves once the server applies it. */
+    pause: (taskName: string) => Promise<CronMutationResult>;
+    /** Resume a paused task; resolves once the server applies it. */
+    resume: (taskName: string) => Promise<CronMutationResult>;
 }
 declare function useCronMonitor(roomId: string): UseCronMonitorResult;
 
@@ -3526,22 +3598,49 @@ declare function toConnectionStatus(queryStatus: string): ConnectionStatus;
 interface R2UploadResult {
     success: boolean;
     key?: string;
+    /**
+     * `key` minus the scope prefix — the spelling that works with `list(prefix)`
+     * filters and `upload(..., { key })` upserts, which never see the prefix.
+     * Older servers omit it.
+     */
+    relativeKey?: string;
     url?: string;
     name?: string;
     error?: string;
 }
 interface R2FileInfo {
     key: string;
+    /** `key` minus the scope prefix (see {@link R2UploadResult.relativeKey}). Older servers omit it. */
+    relativeKey?: string;
     size: number;
     uploaded: string;
     url: string;
     originalName?: string;
     uploadedBy?: string;
 }
+/** One page of a listing: the entries plus the continuation state. */
+interface R2FileListPage {
+    files: R2FileInfo[];
+    /**
+     * Opaque continuation token — pass it back as `cursor` to fetch the next
+     * page. Present only while `truncated`; older servers never send one.
+     */
+    cursor?: string;
+    /** Whether entries exist past this page. */
+    truncated: boolean;
+}
 /** Told after each part lands, so a long upload can drive a progress bar. */
 type UploadProgress = (sent: number, total: number) => void;
 interface UploadOptions {
     onProgress?: UploadProgress;
+    /**
+     * Exact key for the file within the scope (slashes allowed), so
+     * `upload(file, 'report.csv', { key: 'showcase/report.csv' })` is found by
+     * `list('showcase')` and uploading to the same key again replaces the file.
+     * Without it the server generates a unique key per upload — a location no
+     * prefix you choose can address. `name` stays display metadata either way.
+     */
+    key?: string;
 }
 interface UseR2FilesReturn {
     /**
@@ -3561,7 +3660,7 @@ interface UseR2FilesReturn {
      * `MAX_BASE64_UPLOAD_BYTES` (~18.75 MiB decoded), not the full 25 MiB. Send a
      * Blob through `upload` for anything larger; it chunks.
      */
-    uploadBase64: (base64Data: string, name: string, mimeType?: string) => Promise<R2UploadResult>;
+    uploadBase64: (base64Data: string, name: string, mimeType?: string, options?: Pick<UploadOptions, 'key'>) => Promise<R2UploadResult>;
     /**
      * Delete a file. Accepts an R2FileInfo from `list()` or a raw key string.
      *
@@ -3576,8 +3675,37 @@ interface UseR2FilesReturn {
         success: boolean;
         error?: string;
     }>;
-    /** List files, optionally filtered by a sub-prefix within the scope. */
-    list: (prefix?: string) => Promise<R2FileInfo[]>;
+    /**
+     * List files, optionally filtered by a sub-prefix within the scope.
+     * `limit` caps how many entries come back; `cursor` continues from an
+     * earlier page (use `listPage` to obtain one).
+     *
+     * Throws on a failed response — "not authorized" is an error, not an
+     * empty account.
+     */
+    list: (prefix?: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }) => Promise<R2FileInfo[]>;
+    /**
+     * Like `list`, but returns the page envelope `list` flattens away:
+     * `truncated` says whether more entries exist, and `cursor` (present only
+     * while `truncated`) feeds the next call to fetch them.
+     *
+     * @example
+     * ```tsx
+     * let cursor: string | undefined
+     * do {
+     *   const page = await listPage('showcase', { cursor })
+     *   render(page.files)
+     *   cursor = page.cursor
+     * } while (cursor)
+     * ```
+     */
+    listPage: (prefix?: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }) => Promise<R2FileListPage>;
     /**
      * Download a file. Accepts an R2FileInfo from `list()` or a raw key string.
      * Uses an authenticated fetch and triggers a browser download via blob URL.
@@ -4235,6 +4363,64 @@ declare function usePlatformWS<S extends {
     status: ConnectionStatus;
 }>(options: PlatformWSOptions<S>): PlatformWSResult<S>;
 
+/**
+ * Platform API error normalization — the one chokepoint that turns the
+ * api-worker's error envelope into a render-safe + branch-safe shape.
+ *
+ * The platform emits errors as `{ error: <machine slug>, message?: <human>,
+ * ...details }` (e.g. 402 `{ error: 'insufficient_credits', message:
+ * 'Insufficient credits.', availableCredits, requiredCredits }`; some routes
+ * send the bare slug with no `message` at all, e.g. 409
+ * `{ error: 'owner_connect_not_ready' }`). Consumers must never show the slug
+ * to a person or make an agent parse the sentence — this module separates the
+ * two once, for the integration client, the billing hooks, and the CLI.
+ */
+/** One structured validation issue (Zod shape) from a `validation_failed` response. */
+interface ApiErrorIssue {
+    path?: string[];
+    message: string;
+    code?: string;
+}
+/** A platform error response, normalized. */
+interface NormalizedApiError {
+    /**
+     * Human-readable text, safe to render:
+     * `message ?? non-slug error ?? humanized(slug) ?? slug`.
+     */
+    error: string;
+    /** The machine slug (e.g. 'insufficient_credits') for branching — never render it. */
+    code?: string;
+    /** HTTP status of the response; 0 when no HTTP response arrived (transport failure). */
+    status: number;
+    /** Structured fields the server sent alongside the error (e.g. `availableCredits`). */
+    details?: Record<string, unknown>;
+    /** Zod issues accompanying a `validation_failed` response. */
+    issues?: ApiErrorIssue[];
+}
+/**
+ * The error the billing hooks (`useCheckout`, `useSubscription`) throw for a
+ * platform refusal. `message` is human text safe to render; branch on `code`:
+ *
+ *   try {
+ *     await subscribe('pro')
+ *   } catch (e) {
+ *     if (e instanceof PlatformApiError && e.code === 'owner_connect_not_ready') {
+ *       // owner hasn't finished payment onboarding
+ *     }
+ *   }
+ */
+declare class PlatformApiError extends Error {
+    /** The machine slug (e.g. 'owner_connect_not_ready'), when the server sent one. */
+    readonly code?: string;
+    /** HTTP status of the response; 0 when no HTTP response arrived. */
+    readonly status: number;
+    /** Structured fields the server sent alongside the error. */
+    readonly details?: Record<string, unknown>;
+    /** Zod issues accompanying a `validation_failed` response. */
+    readonly issues?: ApiErrorIssue[];
+    constructor(normalized: NormalizedApiError);
+}
+
 /**
  * Integration API client.
  *
@@ -4246,15 +4432,19 @@ declare function usePlatformWS<S extends {
  *   import { integration } from 'deepspace'
  *   const result = await integration.post('openai/chat-completion', { messages })
  */
+
 interface IntegrationResponse<T = unknown> {
     success: boolean;
     data?: T;
+    /** Human-readable error, safe to render directly. */
     error?: string;
-    issues?: Array<{
-        path?: string[];
-        message: string;
-        code?: string;
-    }>;
+    /** Machine slug (e.g. 'insufficient_credits') for branching — never render it. */
+    code?: string;
+    /** HTTP status of the failed response; 0 when no response arrived (timeout, abort, network). */
+    status?: number;
+    /** Structured fields the server sent alongside the error (e.g. `availableCredits`). */
+    details?: Record<string, unknown>;
+    issues?: ApiErrorIssue[];
 }
 interface RequestOptions {
     headers?: Record<string, string>;
@@ -4601,7 +4791,14 @@ interface UseSubscriptionReturn {
     cancelAtPeriodEnd: boolean;
     trialEndsAt: number | null;
     isLoading: boolean;
+    /** Human-readable text of the last load failure, safe to render. */
     error: string | null;
+    /**
+     * Machine slug of the last load failure (e.g. 'owner_connect_not_ready')
+     * for branching — never render it. Null when there is no error or the
+     * failure carried no slug (e.g. a network drop).
+     */
+    errorCode: string | null;
     /**
      * Returns true only when `tier === slug` AND the subscription is currently
      * entitled (status ∈ {active, trialing}). A `past_due` / `canceled` /
@@ -4697,7 +4894,14 @@ interface UseCheckoutOpts {
 interface UseCheckoutReturn {
     chargeOnce: (opts: ChargeOnceOpts) => Promise<ChargeOnceResult>;
     isLoading: boolean;
+    /** Human-readable text of the last failure, safe to render. */
     error: string | null;
+    /**
+     * Machine slug of the last failure (e.g. 'owner_connect_not_ready') for
+     * branching — never render it. Null when there is no error or the
+     * failure carried no slug (e.g. a network drop).
+     */
+    errorCode: string | null;
     purchases: Purchase[];
     /** True iff `opts.productId` was provided and a non-fully-refunded row matches. */
     owned: boolean;
@@ -4853,4 +5057,4 @@ declare const ACCOUNT_STORAGE_LIMIT_BYTES: {
 declare function storageLimitForTier(tier: string | null | undefined): number;
 declare function formatBytes(bytes: number): string;
 
-export { ACCOUNT_STORAGE_LIMIT_BYTES, APP_LOG_EVENT_KEYS, ASYNC_RESOURCE_DEFAULTS, type AdHocChargeOpts, type AiStreamAction, type AiStreamChunk, type AppLogEvent, type AppLogEventKey, type AppLogsResponse, type AppMigrationIdsValidation, type AsyncResourceDefaults, type AsyncResourceState, type AsyncResourceStatus, AuthGate, type AuthGateProps, AuthOverlay, Awareness, type AwarenessState, type AwarenessStates, type BaseMessage, type CanvasShapeClient, type Channel, type ChannelInvitation, type ChannelMember, type ChargeOnceOpts, type ChargeOnceResult, type ClientErrorKind, type ClientErrorReport, type ClientErrorReporterOptions, type ClientMessage, type CollectionSchema, type ConnectionAttachment, type ConnectionStatus, type ContentSegment, type ConversationObject, type CronHistoryEntry, type CronTaskState, DEEPSPACE_AGENT_PROFILES, DEEPSPACE_AI_DEFAULTS, DEEPSPACE_AI_MODELS, DEEPSPACE_MODEL_CATALOG_PROVENANCE, DEEPSPACE_THEME_PROPERTIES, DEFAULT_USER_COLORS, type DeepSpaceAIModel, type DeepSpaceAIModelId, type DeepSpaceAIProvider, type DeepSpaceAgentProfile, type DeepSpaceAgentProfileId, type DeepSpaceAgentSupport, DeepSpaceAuthProvider, type DeepSpaceThemeConfig, DeepSpaceThemeProvider, type DeepSpaceThemeProviderProps, type DeriveLoadStateInput, ENV, type Environment, type FileAttachment, type GroupedReaction, GuestBanner, type HandlerContext, type InboxEntry, type IntegrationResponse, type JobStatusView, type JobView, LOG_LEVELS, type LinkPreviewData, type LoadState, type LoadStateAuthInput, type LoadStateStatusInput, type LogLevel, MSG, MSG_AWARENESS, MSG_SYNC, MSG_SYNC_STEP1, MSG_SYNC_STEP2, MSG_SYNC_UPDATE, MSG_YJS_AWARENESS, MSG_YJS_SYNC, type MemberRecord, type Message, type MessageHandlers, type MessageRecord, type MsgType, type PagedResourceFetchArgs, type PagedResourcePage, type PagedResourceState, type PagedResourceStatus, type PlanInfo, PlatformContext, type PlatformContextValue, PlatformProvider, type PlatformWSOptions, type PlatformWSResult, type PresencePeerClient, PricingTable, type PricingTablePlan, type PricingTablePrice, type ProductChargeOpts, type ProtocolMessage, type Purchase, type Query, type R2FileInfo, type R2Scope, type R2UploadResult, ROLES, ROLE_ADMIN, ROLE_ANONYMOUS, ROLE_CONFIG, ROLE_DEFAULT, type Reaction, type ReactionRecord, type ReadCursorRecord, type ReadReceipt, type RecordData, RecordProvider, type RecordProviderProps, RecordRoomNotReadyError, RecordScope, type RequestOptions, type ResolvedDeepSpaceAgentModel, type Role, type RoomUser, SECURE_ROOM_BOUNDARIES_MIGRATION_ID, type ScopeEntry, ScopeRegistryProvider, type ServerMessage, SignedIn, SignedOut, type SubscribeOpts, type SubscribeResult, type SubscriptionState, type SubscriptionStatus, type SyncResult, type UseAsyncResourceOptions, type UseAuthProfileReadyOptions, type UseAuthStatusOptions, type UseCanvasResult, type UseCheckoutOpts, type UseCronMonitorResult, type UseJobsResult, type UsePagedResourceOptions, type UsePresenceRoomResult, type UseR2FilesReturn, type UseVoiceAgentOptions, type UseVoiceAgentResult, type UseYjsFieldResult, type UseYjsRoomResult, type UseYjsTextResult, type User, type UserCredits, type UserInfo, type UserKarma, type UserProfile, type ViewportClient, type VoiceStatus, type VoiceTranscriptEntry, WORKER_OWNED_NOT_FOUND_MIGRATION_ID, type WriteError, applyDeepSpaceTheme, applyUIThemeTokens, authClient, canAutoLoadPagedResource, clampPagedResourceItems, clearAuthToken, clearDeepSpaceTheme, clientBuild, createDecoder, createEncoder, decodeAiStreamChunk, deriveLoadState, detectEnvironment, dispatch, encode, encodeAwarenessMessage, encodeSyncStep1, encodeSyncStep2, encodeUpdate, formatBytes, formatFileSize, formatFullTimestamp, formatMessageTime, getApiUrl, getAuthToken, getAuthUrl, getConversationDisplayName, getConversationParticipantIds, getDeepSpaceAIModel, getEnvironmentConfig, getMessageType, getPagedResourceCooldownMs, getPlatformWorkerUrl, getThreadCounts, getUserColor, groupReactionsForMessage, handleAwarenessMessage, handleSyncMessage, hasContent, installClientErrorReporter, integration, isAsyncResourceSlow, isDMConversation, isDarkColor, isImageFile, isLocalDev, isProduction, listDeepSpaceAgentModels, parseMessageMetadata, parseSseLine, readThemeFromDOM, readVarUint, readVarUint8Array, reportClientError, resetEnvironmentCache, resolveDeepSpaceAgentModel, serverBuild, shouldGroupMessages, signIn, signOut, storageLimitForTier, toConnectionStatus, toUint8Array, useAsyncResource, useAuth, useAuthProfileReady, useAuthStatus, useAuthUser, useCanvas, useChannelMembers, useChannels, useCheckout, useCommunities, useConversation, useConversations, useCronMonitor, useDisplayName, useInbox, useIsDarkTheme, useJobs, useMessages, useMutations, usePagedResource, usePlatform, usePlatformWS, usePosts, usePresence, usePresenceRoom, useQuery, useR2Files, useReactions, useReadReceipts, useRecordContext, useSession, useSubscription, useUser, useUserLookup, useUsers, useVoiceAgent, useYjsField, useYjsRoom, useYjsText, validateAppMigrationIds, writeVarUint, writeVarUint8Array };
+export { ACCOUNT_STORAGE_LIMIT_BYTES, APP_LOG_EVENT_KEYS, ASYNC_RESOURCE_DEFAULTS, type AdHocChargeOpts, type AiStreamAction, type AiStreamChunk, type ApiErrorIssue, type AppLogEvent, type AppLogEventKey, type AppLogsResponse, type AppMigrationIdsValidation, type AsyncResourceDefaults, type AsyncResourceState, type AsyncResourceStatus, AuthGate, type AuthGateProps, AuthOverlay, Awareness, type AwarenessState, type AwarenessStates, type BaseMessage, type CanvasShapeClient, type Channel, type ChannelInvitation, type ChannelMember, type ChargeOnceOpts, type ChargeOnceResult, type ClientErrorKind, type ClientErrorReport, type ClientErrorReporterOptions, type ClientMessage, type CollectionSchema, type ConnectionAttachment, type ConnectionStatus, type ContentSegment, type ConversationObject, type CronHistoryEntry, type CronMutationResult, type CronTaskState, DEEPSPACE_AGENT_PROFILES, DEEPSPACE_AI_DEFAULTS, DEEPSPACE_AI_MODELS, DEEPSPACE_MODEL_CATALOG_PROVENANCE, DEEPSPACE_THEME_PROPERTIES, DEFAULT_USER_COLORS, type DeepSpaceAIModel, type DeepSpaceAIModelId, type DeepSpaceAIProvider, type DeepSpaceAgentProfile, type DeepSpaceAgentProfileId, type DeepSpaceAgentSupport, DeepSpaceAuthProvider, type DeepSpaceThemeConfig, DeepSpaceThemeProvider, type DeepSpaceThemeProviderProps, type DeriveLoadStateInput, ENV, type Environment, type FileAttachment, type GroupedReaction, GuestBanner, type HandlerContext, type InboxEntry, type IntegrationResponse, type JobStatusView, type JobView, LOG_LEVELS, type LinkPreviewData, type LoadState, type LoadStateAuthInput, type LoadStateStatusInput, type LogLevel, MSG, MSG_AWARENESS, MSG_SYNC, MSG_SYNC_STEP1, MSG_SYNC_STEP2, MSG_SYNC_UPDATE, MSG_YJS_AWARENESS, MSG_YJS_SYNC, type MemberRecord, type Message, type MessageHandlers, type MessageRecord, type MsgType, type NormalizedApiError, type PagedResourceFetchArgs, type PagedResourcePage, type PagedResourceState, type PagedResourceStatus, type PlanInfo, PlatformApiError, PlatformContext, type PlatformContextValue, PlatformProvider, type PlatformWSOptions, type PlatformWSResult, type PresencePeerClient, PricingTable, type PricingTablePlan, type PricingTablePrice, type ProductChargeOpts, type ProtocolMessage, type Purchase, type Query, type R2FileInfo, type R2FileListPage, type R2Scope, type R2UploadResult, ROLES, ROLE_ADMIN, ROLE_ANONYMOUS, ROLE_CONFIG, ROLE_DEFAULT, type Reaction, type ReactionRecord, type ReadCursorRecord, type ReadReceipt, type RecordData, RecordProvider, type RecordProviderProps, RecordRoomNotReadyError, RecordScope, type RequestOptions, type ResolvedDeepSpaceAgentModel, type Role, type RoomUser, SECURE_ROOM_BOUNDARIES_MIGRATION_ID, type ScopeEntry, ScopeRegistryProvider, type ServerMessage, SignedIn, SignedOut, type SubscribeOpts, type SubscribeResult, type SubscriptionState, type SubscriptionStatus, type SyncResult, type UseAsyncResourceOptions, type UseAuthProfileReadyOptions, type UseAuthStatusOptions, type UseCanvasResult, type UseCheckoutOpts, type UseCronMonitorResult, type UseJobsResult, type UsePagedResourceOptions, type UsePresenceRoomResult, type UseR2FilesReturn, type UseVoiceAgentOptions, type UseVoiceAgentResult, type UseYjsFieldResult, type UseYjsRoomResult, type UseYjsTextResult, type User, type UserCredits, type UserInfo, type UserKarma, type UserProfile, type ViewportClient, type VoiceStatus, type VoiceTranscriptEntry, WORKER_OWNED_NOT_FOUND_MIGRATION_ID, type WriteError, applyDeepSpaceTheme, applyUIThemeTokens, authClient, canAutoLoadPagedResource, clampPagedResourceItems, clearAuthToken, clearDeepSpaceTheme, clientBuild, createDecoder, createEncoder, decodeAiStreamChunk, deriveLoadState, detectEnvironment, dispatch, encode, encodeAwarenessMessage, encodeSyncStep1, encodeSyncStep2, encodeUpdate, formatBytes, formatFileSize, formatFullTimestamp, formatMessageTime, getApiUrl, getAuthToken, getAuthUrl, getConversationDisplayName, getConversationParticipantIds, getDeepSpaceAIModel, getEnvironmentConfig, getMessageType, getPagedResourceCooldownMs, getPlatformWorkerUrl, getThreadCounts, getUserColor, groupReactionsForMessage, handleAwarenessMessage, handleSyncMessage, hasContent, installClientErrorReporter, integration, isAsyncResourceSlow, isDMConversation, isDarkColor, isImageFile, isLocalDev, isProduction, listDeepSpaceAgentModels, parseMessageMetadata, parseSseLine, readThemeFromDOM, readVarUint, readVarUint8Array, reportClientError, resetEnvironmentCache, resolveDeepSpaceAgentModel, serverBuild, shouldGroupMessages, signIn, signOut, storageLimitForTier, toConnectionStatus, toUint8Array, useAsyncResource, useAuth, useAuthProfileReady, useAuthStatus, useAuthUser, useCanvas, useChannelMembers, useChannels, useCheckout, useCommunities, useConversation, useConversations, useCronMonitor, useDisplayName, useInbox, useIsDarkTheme, useJobs, useMessages, useMutations, usePagedResource, usePlatform, usePlatformWS, usePosts, usePresence, usePresenceRoom, useQuery, useR2Files, useReactions, useReadReceipts, useRecordContext, useSession, useSubscription, useUser, useUserLookup, useUsers, useVoiceAgent, useYjsField, useYjsRoom, useYjsText, validateAppMigrationIds, writeVarUint, writeVarUint8Array };