lumiverse-spindle-types 0.6.40 → 0.6.42

package/dist/api.d.ts

@@ -1612,6 +1612,22 @@ export interface RegexScriptListOptionsDTO {
     offset?: number;
     userId?: string;
 }
+export interface ActivationPatternsOptions {
+    presetId: string;
+    patterns: string[];
+    chatId?: string;
+    characterId?: string;
+    personaId?: string;
+    connectionId?: string;
+    userId?: string;
+}
+export interface ActivationPatternsResult {
+    patterns: Array<{
+        source: string;
+        resolved?: string;
+        error?: string;
+    }>;
+}
 export interface RegexScriptActiveOptionsDTO {
     target: RegexTargetDTO;
     characterId?: string;
@@ -2096,6 +2112,77 @@ export interface DryRunTokenCountDTO {
     tokenizer_id: string | null;
     tokenizer_name: string | null;
 }
+export interface ContextClipStatsDTO {
+    /** True when a context budget was resolved and the clip step ran. */
+    enabled: boolean;
+    /** Preset `contextSize` (→ `max_context_length`). 0 when unset. */
+    maxContext: number;
+    /** Reserved for the LLM response (`max_tokens`). */
+    maxResponseTokens: number;
+    /** Headroom for interceptors, deliberation inject, tokenizer variance. */
+    safetyMargin: number;
+    /** `maxContext - maxResponseTokens - safetyMargin`. */
+    inputBudget: number;
+    /** Tokens consumed by non-chat-history messages (system blocks, WI, prefill, …). */
+    fixedTokens: number;
+    /** `inputBudget - fixedTokens`. Can be negative when fixed overhead already exceeds budget. */
+    remainingHistoryBudget: number;
+    /** Chat-history tokens before clipping. */
+    chatHistoryTokensBefore: number;
+    /** Chat-history tokens after clipping. */
+    chatHistoryTokensAfter: number;
+    /** Number of chat-history messages excluded from the final assembly. */
+    messagesDropped: number;
+    /** Sum of tokens dropped (oldest messages). */
+    tokensDropped: number;
+    /** Display name of the tokenizer used, or "approximate" for the char/4 fallback. */
+    tokenizerUsed: string;
+    /** True when the budget computed to <= 0 (misconfigured preset); no clipping attempted. */
+    budgetInvalid?: boolean;
+    /** True when fixed prompt overhead alone is larger than the available input budget. */
+    fixedOverBudget?: boolean;
+    /** True when a context anchor set the first chat-history message the model may read. */
+    anchorActive?: boolean;
+    /** Exact tokens required by the anchored history tail. */
+    protectedHistoryTokens?: number;
+    /** Budget remaining after the anchored history tail. Negative means the anchor cannot fit. */
+    remainingBeforeAnchor?: number;
+    /** True when the anchored history tail cannot fit in the remaining history budget. */
+    anchorOverflow?: boolean;
+}
+export interface SavedBreakdownDTO {
+    entries: Array<{
+        name: string;
+        type: string;
+        tokens: number;
+        role?: string;
+        content?: string;
+        blockId?: string;
+        extensionId?: string;
+        extensionName?: string;
+        messageCount?: number;
+        firstMessageIndex?: number;
+    }>;
+    messages?: Array<{
+        role: string;
+        content: string;
+    }>;
+    totalTokens: number;
+    chatHistoryTokens?: number;
+    maxContext: number;
+    model: string;
+    provider: string;
+    parameters?: Record<string, unknown>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+        provider_raw?: Record<string, unknown>;
+    };
+    presetName?: string;
+    presetId?: string;
+    tokenizer_name?: string | null;
+}
 export interface DryRunResultDTO {
     messages: LlmMessageDTO[];
     breakdown: AssemblyBreakdownEntryDTO[];
@@ -2103,6 +2190,8 @@ export interface DryRunResultDTO {
     model: string;
     provider: string;
     tokenCount?: DryRunTokenCountDTO;
+    chatHistoryTokens?: number;
+    contextClipStats?: ContextClipStatsDTO;
     worldInfoStats?: ActivationStatsDTO;
     memoryStats?: MemoryStatsDTO;
 }
@@ -3244,7 +3333,7 @@ export interface ProviderManager {
         key: ProviderKeyDTO;
     }) => void): () => void;
 }
-export type WorkerToHost = import("./desktop-capture.js").DesktopCaptureWorkerMessage | {
+export type WorkerToHost = import("./file-transfers.js").FileTransferWorkerMessage | import("./desktop-capture.js").DesktopCaptureWorkerMessage | {
     type: "subscribe_event";
     event: string;
 } | {
@@ -4202,6 +4291,10 @@ export type WorkerToHost = import("./desktop-capture.js").DesktopCaptureWorkerMe
     requestId: string;
     scriptId: string;
     userId?: string;
+} | {
+    type: "regex_scripts_prepare_activation_patterns";
+    requestId: string;
+    options: ActivationPatternsOptions;
 } | {
     type: "regex_scripts_get_active";
     requestId: string;
@@ -4230,6 +4323,16 @@ export type WorkerToHost = import("./desktop-capture.js").DesktopCaptureWorkerMe
     requestId: string;
     input: DryRunRequestDTO;
     userId?: string;
+} | {
+    type: "generate_get_breakdown";
+    requestId: string;
+    messageId: string;
+    userId?: string;
+} | {
+    type: "images_read_binary";
+    requestId: string;
+    imageId: string;
+    userId?: string;
 } | {
     type: "chats_get_memories";
     requestId: string;

package/dist/dom.d.ts

@@ -1,4 +1,5 @@
 import type { SpindleSTTAPI } from "./speech-to-text.js";
+import type { SpindleFileDownloadAPI } from "./file-transfers.js";
 import type { ChatDTO, ChatMessageDTO, ChatUpdateDTO, ConnectionProfileDTO, LlmMessageDTO, PromptBlockDTO, PromptVariableValuesDTO, RequestInitDTO, TokenCountOptionsDTO, TokenCountResultDTO, WorldBookCreateDTO, WorldBookDTO, WorldBookEntryCreateDTO, WorldBookEntryDTO, WorldBookEntryUpdateDTO, WorldBookUpdateDTO } from "./api.js";
 import type { SpindleComponentsHelper } from "./components.js";
 import type { SpindleHostDescriptorV1, SpindleHostLocaleAPI } from "./host.js";
@@ -1042,6 +1043,8 @@ export interface SpindleRecentChatsPage<TRow = SpindleRecentChat> {
 }
 /** Context object provided to frontend extension modules */
 export interface SpindleFrontendContext {
+    /** Native downloads of completed backend files. Available with file-transfers-v1. */
+    readonly files: SpindleFileDownloadAPI;
     /** Host-managed STT. Feature-detect speech-to-text-v1; unavailable on older hosts. */
     readonly stt?: SpindleSTTAPI;
     /** Per-document routing identity, available with frontend-session-origin-v1. */

package/dist/file-transfers.d.ts

@@ -0,0 +1,157 @@
+/** Maximum bytes in a worker read/write chunk; process one chunk at a time. */
+export declare const SPINDLE_FILE_CHUNK_BYTES: number;
+/** Per-file and per-installation/user aggregate staged storage ceiling. */
+export declare const SPINDLE_FILE_MAX_BYTES: number;
+/** Default disk reservation for downloads, generated files, and ZIP output. */
+export declare const SPINDLE_FILE_DEFAULT_MAX_BYTES: number;
+/** Inactivity lifetime; active readers and archive inputs are pinned. */
+export declare const SPINDLE_FILE_TTL_MS: number;
+/** Maximum staged file count per installation/user and archive entry count. */
+export declare const SPINDLE_FILE_MAX_COUNT = 10000;
+/** Opaque host-owned file reference. Paths and complete archive bytes stay on the host. */
+export interface SpindleFileRef {
+    fileId: string;
+    fileName: string;
+    size: number;
+    mimeType: string;
+}
+/** A completed staged file or tus upload owned by this extension and user. */
+export type SpindleFileSource = {
+    fileId: string;
+} | {
+    uploadId: string;
+};
+export interface FileOperationOptions {
+    /** Required for operator-scoped extensions; inferred for user-scoped extensions. */
+    userId?: string;
+    /** Cancels the producer and cleans up partial output; rejects with AbortError. */
+    signal?: AbortSignal;
+}
+export interface FileFetchOptions extends FileOperationOptions {
+    headers?: Record<string, string>;
+    /** Default: download.bin. */
+    fileName?: string;
+    /** Maximum actual response bytes and disk reservation. Default: 5 GiB; maximum: 100 GiB. */
+    maxBytes?: number;
+    /** Default: 30 minutes; maximum: 1 hour. Includes body consumption. */
+    timeoutMs?: number;
+}
+export interface SpindleFileCreateInput {
+    fileName: string;
+    /** Exact final byte length. Specify size or maxBytes, never both. */
+    size?: number;
+    /** Output budget for unknown-length producers. Default: 5 GiB. */
+    maxBytes?: number;
+    mimeType?: string;
+    userId?: string;
+}
+export interface SpindleFileChunk {
+    data: Uint8Array;
+    offset: number;
+    /** Total file length, not the length of this chunk. */
+    size: number;
+    eof: boolean;
+}
+export interface SpindleArchiveEntry {
+    /** Safe relative ZIP file name. Directory records and duplicate names reject. */
+    name: string;
+    source: SpindleFileSource;
+    /** Skip compression for already compressed assets. */
+    store?: boolean;
+}
+export interface ArchiveCreateOptions extends FileOperationOptions {
+    /** Default: export.zip. */
+    fileName?: string;
+    /** Output budget. Default: 5 GiB; maximum: 100 GiB. */
+    maxBytes?: number;
+}
+export interface ArchiveExtractOptions extends FileOperationOptions {
+    /** Exact ZIP file names to extract. Omit for all files; an empty list extracts none. */
+    entries?: string[];
+    /** Total expansion limit and disk reservation. Default/maximum: 20 GiB. */
+    maxDecompressedBytes?: number;
+}
+export interface SpindleArchiveExtractedEntry {
+    /** Original relative entry name, including its archive directories. */
+    name: string;
+    file: SpindleFileRef;
+}
+/** Available with file-transfers-v1. All files are scoped to the installation, user, and worker lifetime. */
+export interface SpindleFilesAPI {
+    /** GET through the host to disk. Requires cors_proxy; rejects non-success HTTP statuses. */
+    fetch(url: string, options?: FileFetchOptions): Promise<SpindleFileRef>;
+    /** Reserve a byte budget and create an incomplete file for sequential writes. */
+    create(input: SpindleFileCreateInput): Promise<SpindleFileRef>;
+    /** Write 1–SPINDLE_FILE_CHUNK_BYTES bytes at the current offset. Returns the next offset. */
+    writeChunk(fileId: string, offset: number, data: Uint8Array, userId?: string): Promise<number>;
+    /** Verify the byte budget/exact size, release unused capacity, and make the file immutable. */
+    finish(fileId: string, userId?: string): Promise<SpindleFileRef>;
+    /** Read at most SPINDLE_FILE_CHUNK_BYTES from a completed file or upload. */
+    readChunk(source: SpindleFileSource, offset: number, userId?: string): Promise<SpindleFileChunk>;
+    /** Delete an idle file. Unknown/expired/foreign ids return false; active files reject. */
+    delete(fileId: string, userId?: string): Promise<boolean>;
+    /** Relative attachment URL requiring the owning user's session cookie. */
+    getDownloadUrl(fileId: string, userId?: string): Promise<string>;
+}
+/** Host-side ZIP/ZIP64 processing with bounded memory and disk-backed output. */
+export interface SpindleArchivesAPI {
+    create(entries: SpindleArchiveEntry[], options?: ArchiveCreateOptions): Promise<SpindleFileRef>;
+    /** Validate safe names, expansion, entry sizes, and CRC32; return staged file references. */
+    extract(source: SpindleFileSource, options?: ArchiveExtractOptions): Promise<SpindleArchiveExtractedEntry[]>;
+}
+export interface SpindleFileDownloadAPI {
+    /** Start a native browser/WebView attachment download without assembling a JavaScript Blob. */
+    download(fileId: string): void;
+}
+/** Signals stay in the worker; cancellation crosses the wire by operation id. */
+export type FileTransferWorkerMessage = {
+    type: "files_fetch";
+    requestId: string;
+    url: string;
+    options: Omit<FileFetchOptions, "signal">;
+} | {
+    type: "files_create";
+    requestId: string;
+    input: SpindleFileCreateInput;
+} | {
+    type: "files_write_chunk";
+    requestId: string;
+    fileId: string;
+    offset: number;
+    data: Uint8Array;
+    userId?: string;
+} | {
+    type: "files_finish";
+    requestId: string;
+    fileId: string;
+    userId?: string;
+} | {
+    type: "files_delete";
+    requestId: string;
+    fileId: string;
+    userId?: string;
+} | {
+    type: "files_download_url";
+    requestId: string;
+    fileId: string;
+    userId?: string;
+} | {
+    type: "files_read_chunk";
+    requestId: string;
+    source: SpindleFileSource;
+    offset: number;
+    userId?: string;
+} | {
+    type: "archives_create";
+    requestId: string;
+    entries: SpindleArchiveEntry[];
+    options: Omit<ArchiveCreateOptions, "signal">;
+} | {
+    type: "archives_extract";
+    requestId: string;
+    source: SpindleFileSource;
+    options: Omit<ArchiveExtractOptions, "signal">;
+} | {
+    type: "files_cancel";
+    operationId: string;
+};

package/dist/file-transfers.js

@@ -0,0 +1,10 @@
+/** Maximum bytes in a worker read/write chunk; process one chunk at a time. */
+export const SPINDLE_FILE_CHUNK_BYTES = 1024 * 1024;
+/** Per-file and per-installation/user aggregate staged storage ceiling. */
+export const SPINDLE_FILE_MAX_BYTES = 100 * 1024 ** 3;
+/** Default disk reservation for downloads, generated files, and ZIP output. */
+export const SPINDLE_FILE_DEFAULT_MAX_BYTES = 5 * 1024 ** 3;
+/** Inactivity lifetime; active readers and archive inputs are pinned. */
+export const SPINDLE_FILE_TTL_MS = 30 * 60 * 1000;
+/** Maximum staged file count per installation/user and archive entry count. */
+export const SPINDLE_FILE_MAX_COUNT = 10_000;

package/dist/host.js

@@ -11,6 +11,7 @@ export const SPINDLE_HOST_CAPABILITIES = Object.freeze({
     "frontend-extensibility-v2": 1,
     "frontend-runtime-capabilities-v1": 1,
     "mcp-servers-v1": 1,
+    "file-transfers-v1": 1,
 });
 /** Structured error code returned when host compatibility validation fails. */
 export const SPINDLE_COMPATIBILITY_ERROR_CODE = "SPINDLE_COMPATIBILITY_ERROR";

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export type { SpindleManifest, SpindlePermission, SpindleCapability, } from "./manifest.js";
 export { IDENTIFIER_PATTERN, validateIdentifier, } from "./manifest.js";
 export type { SpindleHostDescriptorV1, SpindleHostLocale, SpindleHostLocaleAPI, } from "./host.js";
+export type { SpindleFileRef, SpindleFileSource, FileOperationOptions, FileFetchOptions, SpindleFileCreateInput, SpindleFileChunk, SpindleArchiveEntry, ArchiveCreateOptions, ArchiveExtractOptions, SpindleArchiveExtractedEntry, SpindleFilesAPI, SpindleArchivesAPI, SpindleFileDownloadAPI, FileTransferWorkerMessage, } from "./file-transfers.js";
+export { SPINDLE_FILE_CHUNK_BYTES, SPINDLE_FILE_MAX_BYTES, SPINDLE_FILE_DEFAULT_MAX_BYTES, SPINDLE_FILE_TTL_MS, SPINDLE_FILE_MAX_COUNT, } from "./file-transfers.js";
 export { SPINDLE_HOST_CAPABILITIES, SPINDLE_COMPATIBILITY_ERROR_CODE, } from "./host.js";
 export type { SpindleThemeAsset, SpindleThemeAssetUploadOptions, SpindleThemeAssetUpdate, SpindleThemePackComponentDraft, SpindleThemePackDraft, SpindleThemePackImportResult, SpindleThemePackInstallOptions, SpindleThemePackInstallResult, SpindleThemeComponentCatalogEntry, SpindleThemeVariableCatalogEntry, SpindleThemeEditorTarget, SpindleThemeEditorOptions, SpindleThemeAuthoringAPI, } from "./theme.js";
 export { SPINDLE_THEME_AUTHORING_HOST_CAPABILITIES } from "./theme.js";
@@ -13,7 +15,7 @@ export { SpindleEvent, CoreEventType } from "./events.js";
 export type { RuntimeStateRevisionDTO, RuntimeEventMetadataDTO, RuntimeCharacterDTO, RuntimeChatDTO, RuntimeMessageDTO, RuntimeStateSnapshotDTO, RuntimeStateCommandDTO, RuntimeStateAcknowledgementDTO, SpindleRuntimeStateAPI, } from "./runtime-state.js";
 export type { SpindleFrontendRuntimeCapability } from "./frontend-capabilities.js";
 export { ALL_FRONTEND_RUNTIME_CAPABILITIES, isValidFrontendRuntimeCapability, } from "./frontend-capabilities.js";
-export type { LlmMessagePartDTO, LlmMessageDTO, LlmThinkingBlockDTO, SpindleUserRoleDTO, InterceptorGenerationType, InterceptorMatchScalar, InterceptorMatchDTO, InterceptorRegistrationMatchOptions, InterceptorRegistrationOptions, InterceptorContextDTO, InterceptorDisposer, InterceptorHandler, DeferredGuidanceDTO, InterceptorBreakdownEntryDTO, FinalResponseDTO, InterceptorResultDTO, MacroDefinitionDTO, MacroInvocationContextDTO, MacroResolveOptionsDTO, MacroResolveResultDTO, ToolRegistrationDTO, ToolSchemaDTO, ToolCallDTO, ToolDefinitionDTO, GenerationUsageDTO, GenerationResponseDTO, GenerationDispatchSourceDTO, ConnectionDispatchDescriptorDTO, GenerationRequestDTO, GenerationReasoningOverrideDTO, ReasoningEffortDTO, ReasoningSettingsDTO, ThinkingDisplayDTO, ConnectionReasoningBindingsDTO, ChatAppendGenerationOptionsDTO, ChatAppendMessageOptionsDTO, StreamChunkDTO, RequestInitDTO, ConnectionProfileDTO, PermissionDeniedDetail, PermissionChangedDetail, McpTransportTypeDTO, McpServerDTO, McpServerCreateDTO, McpToolDTO, McpServerStatusDTO, McpToolCallOptionsDTO, CharacterDTO, CharacterCreateDTO, CharacterAvatarUploadDTO, CharacterUpdateDTO, ChatDTO, ChatUpdateDTO, ChatSwitchedPayloadDTO, ChatChangedPayloadDTO, ChatForkedPayloadDTO, PromptVariableOptionDTO, PromptVariableDefDTO, PromptVariableTypeDTO, PromptVariableValueDTO, PromptVariableValuesDTO, PromptBlockRoleDTO, PromptBlockPositionDTO, PromptBlockCategoryModeDTO, PromptBlockPlacementDTO, PromptBlockPlacementBindingDTO, PromptBlockDTO, PromptBlockSnapshotDTO, PromptBlockCreateDTO, PromptBlockUpdateDTO, PromptBlockCategoryGroupDTO, HostResponseErrorDTO, UserPresetDTO, UserPresetCreateDTO, UserPresetUpdateDTO, WorldBookDTO, WorldBookCreateDTO, WorldBookUpdateDTO, WorldBookEntryDTO, WorldBookEntryCreateDTO, WorldBookEntryUpdateDTO, RegexPlacementDTO, RegexScopeDTO, RegexTargetDTO, RegexMacroModeDTO, RegexScriptDTO, RegexScriptCreateDTO, RegexScriptUpdateDTO, RegexScriptListOptionsDTO, RegexScriptActiveOptionsDTO, WorldInfoInterceptorEntryDTO, WorldInfoInterceptorMessageDTO, WorldInfoActivationSettingsDTO, WorldInfoActivationOverridesDTO, WorldInfoInterceptorRoleDTO, WorldInfoInterceptorPlacementDTO, WorldInfoInterceptorCtxDTO, WorldInfoInterceptorMutationDTO, WorldInfoInterceptorResultDTO, DatabankScopeDTO, DatabankDocumentStatusDTO, DatabankDTO, DatabankCreateDTO, DatabankUpdateDTO, DatabankDocumentDTO, DatabankDocumentCreateDTO, DatabankDocumentUpdateDTO, PersonaDTO, GlobalAddonDTO, GlobalAddonUpdateDTO, LumiaItemDTO, LoomItemCategoryDTO, LoomItemDTO, LoomToolDTO, LumiaDlcPackDTO, LumiaDlcCatalogDTO, PersonaCreateDTO, PersonaUpdateDTO, ActivatedWorldInfoEntryDTO, WorldBookSourceDTO, WorldInfoActivatedEventDTO, DryRunRequestDTO, DryRunResultDTO, AssembleRequestDTO, AssembleResultDTO, BoundPrefillAttachmentDTO, BoundAssembleRequestDTO, BoundAssemblySuccessDTO, BoundAssemblyFailureDTO, BoundAssemblyOutcomeDTO, QuietTrackedRequestDTO, QuietDispatchReceiptDTO, QuietTrackedResultDTO, AssemblyBreakdownEntryDTO, ActivationStatsDTO, MemoryStatsDTO, DryRunTokenCountDTO, ChatMemoryChunkDTO, ChatMemoryResultDTO, ImageGenConnectionDTO, ImageGenParameterSchemaDTO, ImageGenProviderDTO, ImageGenRequestDTO, ImageGenResultDTO, ImageGenLoraEntryDTO, ImageGenCharacterLoraSelectionDTO, ImageGenNativeRequestDTO, ImageGenNativeResultDTO, ImageGenPromptPresetDTO, ImageGenPromptPresetsResultDTO, ImageGenComfyUIFieldValuesDTO, ImageGenNativeParametersDTO, ImageGenNativeControlWorkerMessage, ImageGenStreamRequestDTO, ImageGenStreamStatusDTO, ImageGenStreamPreviewDTO, ImageGenStreamDoneDTO, ImageGenStreamEventDTO, ImageGetOptionsDTO, ImageDTO, ImageListOptionsDTO, ImageSpecificityDTO, ImageVideoCodecDTO, ImageUploadDTO, ImageUploadFromDataUrlOptionsDTO, MediaSourceDTO, MediaAudioFormatDTO, MediaVideoFormatDTO, MediaVideoCodecDTO, MediaAudioCodecDTO, MediaFitModeDTO, MediaTransformResultDTO, MediaConvertAudioRequestDTO, MediaConvertVideoRequestDTO, MediaTranscodeVideoRequestDTO, MediaRemoveAudioFromVideoRequestDTO, MediaAddAudioToVideoRequestDTO, MediaCreateVideoFromImageAndAudioRequestDTO, ThemeOverrideDTO, ThemeInfoDTO, ThemePaletteConfigDTO, ThemeVariablesConfigDTO, ColorExtractionResult, ColorRGB, ColorHSL, SpindleModalItemDTO, SpindleCommandDTO, SpindleCommandContextDTO, SpindleUIDrawerTabDTO, SpindleUISettingsTabDTO, FrontendProcessStateDTO, FrontendProcessExitReasonDTO, FrontendProcessSpawnOptionsDTO, FrontendProcessListOptionsDTO, FrontendProcessInfoDTO, FrontendProcessLifecycleEventDTO, FrontendProcessStopOptionsDTO, BackendProcessStateDTO, BackendProcessExitReasonDTO, BackendProcessSpawnOptionsDTO, BackendProcessListOptionsDTO, BackendProcessInfoDTO, BackendProcessLifecycleEventDTO, BackendProcessStopOptionsDTO, GenerationStartedPayloadDTO, StreamTokenPayloadDTO, GenerationEndedPayloadDTO, GenerationStoppedPayloadDTO, GenerationObserver, ChatMessageDTO, MessageSwipeAction, MessageSwipedPayloadDTO, SwipeEditedPayloadDTO, ToolInvocationPayloadDTO, TokenModelSourceDTO, TokenCountOptionsDTO, TokenCountResultDTO, SpindleUploadDTO, SharedRpcRequestContextDTO, SharedRpcEndpointPolicyDTO, MacroInterceptorPhase, MacroInterceptorCharacterEnvDTO, MacroInterceptorChatEnvDTO, MacroInterceptorEnvDTO, MacroInterceptorCtxDTO, MacroInterceptorResultDTO, MacroInterceptorRichResultDTO, MessageContentProcessorOrigin, MessageContentProcessorCtxDTO, MessageContentProcessorResultDTO, WebSearchProviderDTO, WebSearchSettingsDTO, WebSearchResultDTO, WebSearchDocumentDTO, WebSearchRequestDTO, WebSearchResponseDTO, WorkerToHost, HostToWorker, ProviderKind, ProviderDescriptor, ProviderBrokerSpec, ProviderKeyDTO, WorkerToHostProviderMessage, HostToWorkerProviderMessage, ProviderRuntimeMessage, BrokerRequest, BrokerResponse, ProviderManager, } from "./api.js";
+export type { LlmMessagePartDTO, LlmMessageDTO, LlmThinkingBlockDTO, SpindleUserRoleDTO, InterceptorGenerationType, InterceptorMatchScalar, InterceptorMatchDTO, InterceptorRegistrationMatchOptions, InterceptorRegistrationOptions, InterceptorContextDTO, InterceptorDisposer, InterceptorHandler, DeferredGuidanceDTO, InterceptorBreakdownEntryDTO, FinalResponseDTO, InterceptorResultDTO, MacroDefinitionDTO, MacroInvocationContextDTO, MacroResolveOptionsDTO, MacroResolveResultDTO, ToolRegistrationDTO, ToolSchemaDTO, ToolCallDTO, ToolDefinitionDTO, GenerationUsageDTO, GenerationResponseDTO, GenerationDispatchSourceDTO, ConnectionDispatchDescriptorDTO, GenerationRequestDTO, GenerationReasoningOverrideDTO, ReasoningEffortDTO, ReasoningSettingsDTO, ThinkingDisplayDTO, ConnectionReasoningBindingsDTO, ChatAppendGenerationOptionsDTO, ChatAppendMessageOptionsDTO, StreamChunkDTO, RequestInitDTO, ConnectionProfileDTO, PermissionDeniedDetail, PermissionChangedDetail, McpTransportTypeDTO, McpServerDTO, McpServerCreateDTO, McpToolDTO, McpServerStatusDTO, McpToolCallOptionsDTO, CharacterDTO, CharacterCreateDTO, CharacterAvatarUploadDTO, CharacterUpdateDTO, ChatDTO, ChatUpdateDTO, ChatSwitchedPayloadDTO, ChatChangedPayloadDTO, ChatForkedPayloadDTO, PromptVariableOptionDTO, PromptVariableDefDTO, PromptVariableTypeDTO, PromptVariableValueDTO, PromptVariableValuesDTO, PromptBlockRoleDTO, PromptBlockPositionDTO, PromptBlockCategoryModeDTO, PromptBlockPlacementDTO, PromptBlockPlacementBindingDTO, PromptBlockDTO, PromptBlockSnapshotDTO, PromptBlockCreateDTO, PromptBlockUpdateDTO, PromptBlockCategoryGroupDTO, HostResponseErrorDTO, UserPresetDTO, UserPresetCreateDTO, UserPresetUpdateDTO, WorldBookDTO, WorldBookCreateDTO, WorldBookUpdateDTO, WorldBookEntryDTO, WorldBookEntryCreateDTO, WorldBookEntryUpdateDTO, RegexPlacementDTO, RegexScopeDTO, RegexTargetDTO, RegexMacroModeDTO, RegexScriptDTO, RegexScriptCreateDTO, RegexScriptUpdateDTO, RegexScriptListOptionsDTO, RegexScriptActiveOptionsDTO, ActivationPatternsOptions, ActivationPatternsResult, WorldInfoInterceptorEntryDTO, WorldInfoInterceptorMessageDTO, WorldInfoActivationSettingsDTO, WorldInfoActivationOverridesDTO, WorldInfoInterceptorRoleDTO, WorldInfoInterceptorPlacementDTO, WorldInfoInterceptorCtxDTO, WorldInfoInterceptorMutationDTO, WorldInfoInterceptorResultDTO, DatabankScopeDTO, DatabankDocumentStatusDTO, DatabankDTO, DatabankCreateDTO, DatabankUpdateDTO, DatabankDocumentDTO, DatabankDocumentCreateDTO, DatabankDocumentUpdateDTO, PersonaDTO, GlobalAddonDTO, GlobalAddonUpdateDTO, LumiaItemDTO, LoomItemCategoryDTO, LoomItemDTO, LoomToolDTO, LumiaDlcPackDTO, LumiaDlcCatalogDTO, PersonaCreateDTO, PersonaUpdateDTO, ActivatedWorldInfoEntryDTO, WorldBookSourceDTO, WorldInfoActivatedEventDTO, DryRunRequestDTO, DryRunResultDTO, SavedBreakdownDTO, ContextClipStatsDTO, AssembleRequestDTO, AssembleResultDTO, BoundPrefillAttachmentDTO, BoundAssembleRequestDTO, BoundAssemblySuccessDTO, BoundAssemblyFailureDTO, BoundAssemblyOutcomeDTO, QuietTrackedRequestDTO, QuietDispatchReceiptDTO, QuietTrackedResultDTO, AssemblyBreakdownEntryDTO, ActivationStatsDTO, MemoryStatsDTO, DryRunTokenCountDTO, ChatMemoryChunkDTO, ChatMemoryResultDTO, ImageGenConnectionDTO, ImageGenParameterSchemaDTO, ImageGenProviderDTO, ImageGenRequestDTO, ImageGenResultDTO, ImageGenLoraEntryDTO, ImageGenCharacterLoraSelectionDTO, ImageGenNativeRequestDTO, ImageGenNativeResultDTO, ImageGenPromptPresetDTO, ImageGenPromptPresetsResultDTO, ImageGenComfyUIFieldValuesDTO, ImageGenNativeParametersDTO, ImageGenNativeControlWorkerMessage, ImageGenStreamRequestDTO, ImageGenStreamStatusDTO, ImageGenStreamPreviewDTO, ImageGenStreamDoneDTO, ImageGenStreamEventDTO, ImageGetOptionsDTO, ImageDTO, ImageListOptionsDTO, ImageSpecificityDTO, ImageVideoCodecDTO, ImageUploadDTO, ImageUploadFromDataUrlOptionsDTO, MediaSourceDTO, MediaAudioFormatDTO, MediaVideoFormatDTO, MediaVideoCodecDTO, MediaAudioCodecDTO, MediaFitModeDTO, MediaTransformResultDTO, MediaConvertAudioRequestDTO, MediaConvertVideoRequestDTO, MediaTranscodeVideoRequestDTO, MediaRemoveAudioFromVideoRequestDTO, MediaAddAudioToVideoRequestDTO, MediaCreateVideoFromImageAndAudioRequestDTO, ThemeOverrideDTO, ThemeInfoDTO, ThemePaletteConfigDTO, ThemeVariablesConfigDTO, ColorExtractionResult, ColorRGB, ColorHSL, SpindleModalItemDTO, SpindleCommandDTO, SpindleCommandContextDTO, SpindleUIDrawerTabDTO, SpindleUISettingsTabDTO, FrontendProcessStateDTO, FrontendProcessExitReasonDTO, FrontendProcessSpawnOptionsDTO, FrontendProcessListOptionsDTO, FrontendProcessInfoDTO, FrontendProcessLifecycleEventDTO, FrontendProcessStopOptionsDTO, BackendProcessStateDTO, BackendProcessExitReasonDTO, BackendProcessSpawnOptionsDTO, BackendProcessListOptionsDTO, BackendProcessInfoDTO, BackendProcessLifecycleEventDTO, BackendProcessStopOptionsDTO, GenerationStartedPayloadDTO, StreamTokenPayloadDTO, GenerationEndedPayloadDTO, GenerationStoppedPayloadDTO, GenerationObserver, ChatMessageDTO, MessageSwipeAction, MessageSwipedPayloadDTO, SwipeEditedPayloadDTO, ToolInvocationPayloadDTO, TokenModelSourceDTO, TokenCountOptionsDTO, TokenCountResultDTO, SpindleUploadDTO, SharedRpcRequestContextDTO, SharedRpcEndpointPolicyDTO, MacroInterceptorPhase, MacroInterceptorCharacterEnvDTO, MacroInterceptorChatEnvDTO, MacroInterceptorEnvDTO, MacroInterceptorCtxDTO, MacroInterceptorResultDTO, MacroInterceptorRichResultDTO, MessageContentProcessorOrigin, MessageContentProcessorCtxDTO, MessageContentProcessorResultDTO, WebSearchProviderDTO, WebSearchSettingsDTO, WebSearchResultDTO, WebSearchDocumentDTO, WebSearchRequestDTO, WebSearchResponseDTO, WorkerToHost, HostToWorker, ProviderKind, ProviderDescriptor, ProviderBrokerSpec, ProviderKeyDTO, WorkerToHostProviderMessage, HostToWorkerProviderMessage, ProviderRuntimeMessage, BrokerRequest, BrokerResponse, ProviderManager, } from "./api.js";
 export { PERMISSION_DENIED_PREFIX } from "./api.js";
 export type { ToolRegistration, JSONSchema } from "./tools.js";
 export type { SpindleMessageElement, SpindleTextEditorOptions, SpindleTextEditorResult, SpindleDOMHelper, SpindleMountPoint, SpindleUploadFile, SpindleMessageTagIntercept, SpindleMessageTagInterceptorOptions, SpindleMessageWidgetOptions, PermissionRequestOptions, SpindleFrontendContext, SpindleFrontendContextV2, SpindleSettingsAPI, SpindleSettingsTabOptions, SpindleSettingsTabSection, SpindleSettingsTabHandle, SpindleStateSelectors, SpindleResizeController, SpindleGeometryAPI, SpindleHostSurfaceKind, SpindleHostSurfaceRef, SpindleHostActionJsonValue, SpindleHostActionParams, SpindleHostSurfaceInfo, SpindleHostSurfaceTarget, SpindleHostSurfaceTargetHandler, SpindleHostSurfaceAPI, SpindleComponentOverrideOptions, SpindleComponentOverrideHandle, SpindleDomDecoratorOptions, SpindleDomDecoratorHandle, SpindleMessageActionOptions, SpindleMessageActionHandle, SpindleFrontendWorldBooksAPI, SpindleFrontendTokensAPI, SpindleFrontendConnectionsAPI, SpindleFrontendChatsAPI, SpindleFrontendMessagesAPI, SpindleRecentChatsQuery, SpindleRecentChat, SpindleGroupedRecentChat, SpindleRecentChatsPage, SpindleFrontendModule, SpindleFrontendWidgetTarget, SpindleWidgetFrontendModule, SpindleFrontendTeardown, SpindleGuideDefinition, SpindleDrawerTabOptions, SpindleDrawerTabHandle, SpindleCharacterEditorTabOptions, SpindleCharacterEditorTabHandle, SpindleCharacterEditorState, SpindleCharacterEditorSaveOptions, SpindleCharacterEditorHelper, SpindlePresetEditorTabOptions, SpindlePresetEditorTabHandle, SpindlePresetEditorToolbarItemOptions, SpindlePresetEditorToolbarItemHandle, SpindlePresetEditorDraft, SpindlePresetEditorState, SpindlePresetEditorSaveOptions, SpindlePresetEditorHelper, SpindlePresetEditorBuiltinTabId, SpindlePresetEditorExtensionState, SpindlePresetEditorScopedHelper, SpindleTouchScrollMode, SpindleFloatWidgetOptions, SpindleFloatWidgetHandle, SpindleDockEdge, SpindleDockPanelOptions, SpindleDockPanelHandle, SpindleAppMountOptions, SpindleAppMountHandle, SpindleInputBarActionOptions, SpindleInputBarActionHandle, SpindleSandboxFrameOptions, SpindleSandboxFrameHandle, SpindleSandboxMediaResource, SpindleSandboxAudioOptions, SpindleSandboxAudioHandle, SpindleSandboxAPI, SpindleContextMenuOptions, SpindleContextMenuItemDef, SpindleContextMenuResult, SpindleModalOptions, SpindleModalHandle, SpindleConfirmVariant, SpindleConfirmOptions, SpindleConfirmResult, SpindleUIDomActionEventType, SpindleUIKeyboardState, SpindleUIDrawerState, SpindleUISettingsState, SpindleUIDomActionDetail, SpindleUIDomActionBindingOptions, SpindleUIEventsHelper, SpindleFrontendProcessContext, SpindleFrontendProcessRegistry, SpindleDisplayResolver, SpindleDisplayResolverRegistry, SpindleDisplayContext, SpindleDisplayBodyArgs, SpindleDisplayTemplatesArgs, SpindleDisplayScriptsArgs, SpindleDisplayResolveResult, SpindleDisplayTemplatesResult, SpindleTabLocation, } from "./dom.js";

package/dist/index.js

@@ -1,4 +1,5 @@
 export { IDENTIFIER_PATTERN, validateIdentifier, } from "./manifest.js";
+export { SPINDLE_FILE_CHUNK_BYTES, SPINDLE_FILE_MAX_BYTES, SPINDLE_FILE_DEFAULT_MAX_BYTES, SPINDLE_FILE_TTL_MS, SPINDLE_FILE_MAX_COUNT, } from "./file-transfers.js";
 export { SPINDLE_HOST_CAPABILITIES, SPINDLE_COMPATIBILITY_ERROR_CODE, } from "./host.js";
 export { SPINDLE_THEME_AUTHORING_HOST_CAPABILITIES } from "./theme.js";
 export { ALL_PERMISSIONS, isValidPermission } from "./permissions.js";

package/dist/spindle-api.d.ts

@@ -1,9 +1,10 @@
 import type { SpindleManifest } from "./manifest.js";
 import type { SpindleHostDescriptorV1 } from "./host.js";
 import type { SpindleDesktopAPI } from "./desktop-capture.js";
+import type { SpindleFilesAPI, SpindleArchivesAPI } from "./file-transfers.js";
 import type { SpindleTextEditorOptions, SpindleTextEditorResult } from "./dom.js";
 import type { CouncilMemberContext, CouncilSettings } from "./council.js";
-import type { LlmMessageDTO, InterceptorDisposer, InterceptorHandler, InterceptorRegistrationMatchOptions, InterceptorRegistrationOptions, MacroDefinitionDTO, MacroResolveOptionsDTO, MacroResolveResultDTO, ToolRegistrationDTO, GenerationRequestDTO, ChatAppendMessageOptionsDTO, RequestInitDTO, ConnectionProfileDTO, ConnectionDispatchDescriptorDTO, PermissionDeniedDetail, PermissionChangedDetail, CharacterDTO, CharacterCreateDTO, CharacterAvatarUploadDTO, CharacterUpdateDTO, ChatDTO, ChatUpdateDTO, UserPresetDTO, UserPresetCreateDTO, UserPresetUpdateDTO, PromptBlockSnapshotDTO, PromptBlockCreateDTO, PromptBlockUpdateDTO, PromptBlockCategoryGroupDTO, WorldBookDTO, WorldBookCreateDTO, WorldBookUpdateDTO, WorldBookEntryDTO, WorldBookEntryCreateDTO, WorldBookEntryUpdateDTO, RegexScriptDTO, RegexScriptCreateDTO, RegexScriptUpdateDTO, RegexScriptListOptionsDTO, RegexScriptActiveOptionsDTO, DatabankDTO, DatabankCreateDTO, DatabankUpdateDTO, DatabankDocumentDTO, DatabankDocumentCreateDTO, DatabankDocumentUpdateDTO, PersonaDTO, GlobalAddonDTO, GlobalAddonUpdateDTO, LumiaItemDTO, LumiaDlcCatalogDTO, PersonaCreateDTO, PersonaUpdateDTO, ActivatedWorldInfoEntryDTO, DryRunRequestDTO, DryRunResultDTO, AssembleRequestDTO, AssembleResultDTO, BoundAssembleRequestDTO, BoundAssemblyOutcomeDTO, QuietTrackedRequestDTO, QuietTrackedResultDTO, BrokerRequest, BrokerResponse, ChatMemoryResultDTO, ProviderManager, ImageGenRequestDTO, ImageGenResultDTO, ImageGenNativeRequestDTO, ImageGenNativeResultDTO, ImageGenPromptPresetsResultDTO, ImageGenStreamRequestDTO, ImageGenStreamEventDTO, ImageGenConnectionDTO, ImageGenProviderDTO, ImageGetOptionsDTO, ImageDTO, ImageListOptionsDTO, ImageUploadDTO, ImageUploadFromDataUrlOptionsDTO, MediaConvertAudioRequestDTO, MediaConvertVideoRequestDTO, MediaTranscodeVideoRequestDTO, MediaRemoveAudioFromVideoRequestDTO, MediaAddAudioToVideoRequestDTO, MediaCreateVideoFromImageAndAudioRequestDTO, MediaTransformResultDTO, ThemeOverrideDTO, ThemeInfoDTO, ThemePaletteConfigDTO, ThemeVariablesConfigDTO, ColorExtractionResult, SpindleUserRoleDTO, SpindleModalItemDTO, SpindleCommandDTO, SpindleCommandContextDTO, SpindleUIDrawerTabDTO, SpindleUISettingsTabDTO, FrontendProcessSpawnOptionsDTO, FrontendProcessListOptionsDTO, FrontendProcessInfoDTO, FrontendProcessLifecycleEventDTO, FrontendProcessStopOptionsDTO, BackendProcessSpawnOptionsDTO, BackendProcessListOptionsDTO, BackendProcessInfoDTO, BackendProcessLifecycleEventDTO, BackendProcessStopOptionsDTO, ChatChangedPayloadDTO, ChatForkedPayloadDTO, ChatMessageDTO, GenerationStartedPayloadDTO, StreamTokenPayloadDTO, GenerationEndedPayloadDTO, GenerationStoppedPayloadDTO, GenerationObserver, MessageSwipedPayloadDTO, SwipeEditedPayloadDTO, ToolInvocationPayloadDTO, StreamChunkDTO, TokenCountOptionsDTO, TokenCountResultDTO, SpindleUploadDTO, MacroInterceptorCtxDTO, MacroInterceptorResultDTO, WorldInfoInterceptorCtxDTO, WorldInfoInterceptorResultDTO, MessageContentProcessorCtxDTO, MessageContentProcessorResultDTO, SharedRpcRequestContextDTO, SharedRpcEndpointPolicyDTO, WebSearchRequestDTO, WebSearchResponseDTO, WebSearchSettingsDTO, McpServerDTO, McpServerCreateDTO, McpServerStatusDTO, McpToolDTO, McpToolCallOptionsDTO } from "./api.js";
+import type { LlmMessageDTO, InterceptorDisposer, InterceptorHandler, InterceptorRegistrationMatchOptions, InterceptorRegistrationOptions, MacroDefinitionDTO, MacroResolveOptionsDTO, MacroResolveResultDTO, ToolRegistrationDTO, GenerationRequestDTO, ChatAppendMessageOptionsDTO, RequestInitDTO, ConnectionProfileDTO, ConnectionDispatchDescriptorDTO, PermissionDeniedDetail, PermissionChangedDetail, CharacterDTO, CharacterCreateDTO, CharacterAvatarUploadDTO, CharacterUpdateDTO, ChatDTO, ChatUpdateDTO, UserPresetDTO, UserPresetCreateDTO, UserPresetUpdateDTO, PromptBlockSnapshotDTO, PromptBlockCreateDTO, PromptBlockUpdateDTO, PromptBlockCategoryGroupDTO, WorldBookDTO, WorldBookCreateDTO, WorldBookUpdateDTO, WorldBookEntryDTO, WorldBookEntryCreateDTO, WorldBookEntryUpdateDTO, RegexScriptDTO, RegexScriptCreateDTO, RegexScriptUpdateDTO, RegexScriptListOptionsDTO, RegexScriptActiveOptionsDTO, ActivationPatternsOptions, ActivationPatternsResult, DatabankDTO, DatabankCreateDTO, DatabankUpdateDTO, DatabankDocumentDTO, DatabankDocumentCreateDTO, DatabankDocumentUpdateDTO, PersonaDTO, GlobalAddonDTO, GlobalAddonUpdateDTO, LumiaItemDTO, LumiaDlcCatalogDTO, PersonaCreateDTO, PersonaUpdateDTO, ActivatedWorldInfoEntryDTO, DryRunRequestDTO, DryRunResultDTO, SavedBreakdownDTO, AssembleRequestDTO, AssembleResultDTO, BoundAssembleRequestDTO, BoundAssemblyOutcomeDTO, QuietTrackedRequestDTO, QuietTrackedResultDTO, BrokerRequest, BrokerResponse, ChatMemoryResultDTO, ProviderManager, ImageGenRequestDTO, ImageGenResultDTO, ImageGenNativeRequestDTO, ImageGenNativeResultDTO, ImageGenPromptPresetsResultDTO, ImageGenStreamRequestDTO, ImageGenStreamEventDTO, ImageGenConnectionDTO, ImageGenProviderDTO, ImageGetOptionsDTO, ImageDTO, ImageListOptionsDTO, ImageUploadDTO, ImageUploadFromDataUrlOptionsDTO, MediaConvertAudioRequestDTO, MediaConvertVideoRequestDTO, MediaTranscodeVideoRequestDTO, MediaRemoveAudioFromVideoRequestDTO, MediaAddAudioToVideoRequestDTO, MediaCreateVideoFromImageAndAudioRequestDTO, MediaTransformResultDTO, ThemeOverrideDTO, ThemeInfoDTO, ThemePaletteConfigDTO, ThemeVariablesConfigDTO, ColorExtractionResult, SpindleUserRoleDTO, SpindleModalItemDTO, SpindleCommandDTO, SpindleCommandContextDTO, SpindleUIDrawerTabDTO, SpindleUISettingsTabDTO, FrontendProcessSpawnOptionsDTO, FrontendProcessListOptionsDTO, FrontendProcessInfoDTO, FrontendProcessLifecycleEventDTO, FrontendProcessStopOptionsDTO, BackendProcessSpawnOptionsDTO, BackendProcessListOptionsDTO, BackendProcessInfoDTO, BackendProcessLifecycleEventDTO, BackendProcessStopOptionsDTO, ChatChangedPayloadDTO, ChatForkedPayloadDTO, ChatMessageDTO, GenerationStartedPayloadDTO, StreamTokenPayloadDTO, GenerationEndedPayloadDTO, GenerationStoppedPayloadDTO, GenerationObserver, MessageSwipedPayloadDTO, SwipeEditedPayloadDTO, ToolInvocationPayloadDTO, StreamChunkDTO, TokenCountOptionsDTO, TokenCountResultDTO, SpindleUploadDTO, MacroInterceptorCtxDTO, MacroInterceptorResultDTO, WorldInfoInterceptorCtxDTO, WorldInfoInterceptorResultDTO, MessageContentProcessorCtxDTO, MessageContentProcessorResultDTO, SharedRpcRequestContextDTO, SharedRpcEndpointPolicyDTO, WebSearchRequestDTO, WebSearchResponseDTO, WebSearchSettingsDTO, McpServerDTO, McpServerCreateDTO, McpServerStatusDTO, McpToolDTO, McpToolCallOptionsDTO } from "./api.js";
 import type { ChatChunkDTO, ChatLinkAttachDTO, ChatLinkDTO, ChatMemoryWarmupResultDTO, CortexIngestionStatusDTO, CortexIngestionTelemetryDTO, CortexQueryDTO, CortexResultDTO, CortexUsageStatsDTO, LinkedCortexResultDTO, MemoryConsolidationDTO, MemoryCortexConfigDTO, MemoryEntityDTO, MemoryEntityStatusUpdateDTO, MemoryEntityUpsertDTO, MemoryRelationDTO, MemoryRelationUpsertDTO, MemorySalienceDTO, VaultChunkDTO, VaultCreateDTO, VaultDTO, VaultReindexResultDTO, VaultWithContentsDTO } from "./memories.js";
 export interface FrontendProcessHandle {
     /** Host-assigned process ID unique within the extension runtime. */
@@ -133,6 +134,10 @@ export interface SpindleConnectionsAPI {
 }
 /** The global `spindle` object available in backend extension workers */
 export interface SpindleAPI {
+    /** Disk-backed downloads and bounded reads/writes. Available with file-transfers-v1. */
+    readonly files: SpindleFilesAPI;
+    /** Streaming ZIP64 creation and validated disk-backed extraction. */
+    readonly archives: SpindleArchivesAPI;
     readonly desktop: SpindleDesktopAPI;
     /** Immutable host compatibility descriptor for this extension runtime. */
     readonly host: SpindleHostDescriptorV1;
@@ -341,6 +346,8 @@ export interface SpindleAPI {
         quietStream(input: GenerationRequestDTO): AsyncGenerator<StreamChunkDTO, void, void>;
         /** Run a dry-run prompt assembly without calling the LLM. */
         dryRun(input: DryRunRequestDTO, userId?: string): Promise<DryRunResultDTO>;
+        /** Read the saved prompt breakdown. Returns null when unavailable or inaccessible. Requires generation permission. */
+        getBreakdown(messageId: string, userId?: string): Promise<SavedBreakdownDTO | null>;
         /**
          * Observe an in-flight generation on a chat.
          *
@@ -753,6 +760,8 @@ export interface SpindleAPI {
      * For operator-scoped extensions, pass userId to scope to a specific user.
      */
     images: {
+        /** Read original stored bytes, up to 25 MiB. Rejects missing, inaccessible, or oversized assets. */
+        readBinary(imageId: string, userId?: string): Promise<Uint8Array>;
         list(options?: ImageListOptionsDTO): Promise<{
             data: ImageDTO[];
             total: number;
@@ -981,6 +990,8 @@ export interface SpindleAPI {
      * For operator-scoped extensions, pass userId to scope to a specific user.
      */
     regex_scripts: {
+        /** Resolve supported activation inputs from saved context. Values are escaped for literal regex matching. */
+        prepareActivationPatterns(options: ActivationPatternsOptions): Promise<ActivationPatternsResult>;
         list(options?: RegexScriptListOptionsDTO): Promise<{
             data: RegexScriptDTO[];
             total: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.6.40",
+  "version": "0.6.42",
   "type": "module",
   "types": "./dist/index.d.ts",
   "keywords": [