lumiverse-spindle-types 0.6.36 → 0.6.38

package/dist/api.d.ts

@@ -3,6 +3,14 @@ import type { SpindleHostDescriptorV1 } from "./host.js";
 import type { CouncilMemberContext } from "./council.js";
 import type { ChatLinkAttachDTO, CortexQueryDTO, MemoryCortexConfigDTO, MemoryEntityStatusUpdateDTO, MemoryEntityUpsertDTO, MemoryRelationUpsertDTO, VaultCreateDTO } from "./memories.js";
 export type LlmMessagePartDTO = {
+    type: "video";
+    data: string;
+    mime_type: string;
+    cache_control?: Record<string, unknown>;
+} | {
+    type: "desktop_capture";
+    asset_id: string;
+} | {
     type: "text";
     text: string;
     cache_control?: Record<string, unknown>;
@@ -87,32 +95,61 @@ export interface InterceptorMatchDTO {
     generationTypes?: InterceptorGenerationType[];
     /** Terminal callbacks are never invoked for dry runs. */
     isDryRun?: boolean;
+    /**
+     * Filter on this extension's own preset metadata namespace, the same value
+     * the callback receives as `InterceptorContextDTO.presetMetadata`
+     * (`preset.metadata[<manifest identifier>]` of the generation's preset).
+     * Another extension's or Loom's metadata is never visible to the filter.
+     */
     presetField?: {
+        /**
+         * Object keys walked from the namespace; an empty path tests the namespace
+         * itself. A missing key, an array, or a non-object along the way reads as
+         * `undefined`, as does a generation without a preset.
+         */
         path: string[];
+        /** `true` requires a value at `path` (`null` counts as a value); `false` requires none. */
         exists?: boolean;
+        /** The value at `path` must be `Object.is`-equal to one of these scalars. */
         oneOf?: InterceptorMatchScalar[];
+        /** The value at `path` must not be `Object.is`-equal to any of these scalars. */
         notIn?: InterceptorMatchScalar[];
     };
 }
 export interface InterceptorRegistrationMatchOptions {
     match?: InterceptorMatchDTO;
+    /** Stop generation on failure instead of continuing with the previous prompt. */
+    required?: boolean;
 }
 export interface InterceptorRegistrationOptions {
     priority?: number;
     match?: InterceptorMatchDTO;
+    required?: boolean;
 }
 /**
  * Host-owned, immutable context for one bound interceptor callback.
  * `signal` is local to the worker invocation and is never serialized.
  */
 export interface InterceptorContextDTO {
+    /** Host-selected execution document, pinned for this generation. Absent when no main frontend is connected. */
+    readonly frontendSessionId?: string;
     readonly userId: string;
     readonly chatId: string;
     readonly generationId: string;
     readonly generationType: InterceptorGenerationType;
     readonly isDryRun: boolean;
+    /**
+     * Preset that prompt assembly resolved for this generation, after request,
+     * profile, and binding resolution. `null` when the generation has no preset
+     * or skips assembly (an explicit `messages` request).
+     */
     readonly presetId: string | null;
-    /** Deep clone of only this extension's own preset metadata namespace. */
+    /**
+     * Deep clone of only this extension's own preset metadata namespace:
+     * `preset.metadata[<manifest identifier>]` of the preset in `presetId`, the
+     * key the preset editor's extension helper writes. `undefined` when that key
+     * is absent or there is no preset. Mutating it does not change the preset.
+     */
     readonly presetMetadata: unknown;
     readonly personaId: string | null;
     readonly characterId: string | null;
@@ -278,6 +315,10 @@ export interface MacroInterceptorCtxDTO {
     readonly commit: boolean;
     readonly phase: MacroInterceptorPhase;
     readonly sourceHint?: string;
+    /** Present when this extension is the opted-in evaluator for the complete source. */
+    readonly sourceOwner?: {
+        readonly extensionIdentifier: string;
+    };
     /**
      * User ID that initiated the macro resolution (when available). Relevant
      * for operator-scoped extensions that need to route work through other
@@ -763,6 +804,43 @@ export type ImageGenCharacterLoraSelectionDTO = {
     lora: ImageGenLoraEntryDTO;
     base_tags?: string;
 };
+/** Saved native image prompt preset. Legacy entries without a kind are Main Presets. */
+export interface ImageGenPromptPresetDTO {
+    id: string;
+    name: string;
+    mode: "custom" | "parsed_custom";
+    prompt: string;
+    negativePrompt?: string;
+    parserConnectionId?: string | null;
+    parserModel?: string;
+    parserParameters?: Record<string, unknown>;
+    kind?: "main" | "character" | "persona" | "captioning";
+}
+/** Read-only snapshot; discovery does not reconcile or change saved selections. */
+export interface ImageGenPromptPresetsResultDTO {
+    activeId: string | null;
+    activeConnectionId: string | null;
+    /** Main Presets only, including legacy presets without a kind. */
+    presets: ImageGenPromptPresetDTO[];
+}
+/** Request-local ComfyUI mapped field values; unmapped node fields are ignored. */
+export interface ImageGenComfyUIFieldValuesDTO extends Record<string, unknown> {
+    /** Custom field values keyed by `<nodeId>:<fieldName>`. */
+    custom?: Record<string, unknown>;
+    /**
+     * Primitive overrides keyed by `<nodeId>:<fieldName>`. Prompt and source-image
+     * injection take precedence. Mapped seed values of -1 are randomized per run.
+     */
+    node_fields?: Record<string, string | number | boolean>;
+}
+/** Opt-in validation helper for native provider parameters and saved ComfyUI controls. */
+export interface ImageGenNativeParametersDTO extends Record<string, unknown> {
+    /** Select a saved workflow for this request without changing the active workflow. */
+    workflow_id?: string;
+    /** Alias for workflow_id. */
+    workflowId?: string;
+    comfyui_field_values?: ImageGenComfyUIFieldValuesDTO;
+}
 /**
  * Input for `spindle.imageGen.generateNative()`.
  *
@@ -773,10 +851,19 @@ export type ImageGenCharacterLoraSelectionDTO = {
 export interface ImageGenNativeRequestDTO {
     /** Chat used for prompt/macro context and native generation lifecycle. */
     chat_id: string;
+    /** Request-local connection override; does not change the user's active connection. */
+    connection_id?: string;
+    /** Persisted image owned by the user. ComfyUI workflows must map init_image. */
+    source_image_id?: string;
+    /** Video output selection requires a ComfyUI connection. Omit for legacy selection. */
+    output_media_type?: "image" | "video";
+    /** Select the ComfyUI output node for this request. */
+    output_node_id?: string;
     /** Inline prompt. Optional when native settings/preset supply one. */
     prompt?: string;
     negativePrompt?: string;
     promptMode?: "scene" | "custom" | "parsed_custom";
+    /** Use this preset's mode/parser configuration; a missing explicit preset is rejected. */
     promptPresetId?: string | null;
     /** Skip parser/scene rewriting and use the resolved prompt directly. */
     skipParse?: boolean;
@@ -792,16 +879,35 @@ export interface ImageGenNativeRequestDTO {
     extraBaseTags?: string;
     /** Scale applied to the complete assembled LoRA stack. */
     loraStrengthScale?: number;
-    /** Provider parameters merged over the active native connection defaults. */
+    /**
+     * Provider parameters merged over the active native connection defaults.
+     * Use `satisfies ImageGenNativeParametersDTO` for opt-in ComfyUI validation.
+     */
     parameters?: Record<string, unknown>;
     /** Omit the base64 payload while retaining persisted IDs/URL. */
     includeDataUrl?: boolean;
+    /** Caller-chosen ID used to correlate progress and cancel an in-flight native job. */
     clientJobId?: string;
     promptGenerationTimeoutSeconds?: number;
     generationTimeoutSeconds?: number;
     /** For operator-scoped extensions. */
     userId?: string;
 }
+/**
+ * Additional native image controls supported by QuickGen-capable hosts.
+ * Compose with WorkerToHost explicitly so existing exhaustive handlers remain valid.
+ * Both messages require image_gen permission and account scope.
+ */
+export type ImageGenNativeControlWorkerMessage = {
+    type: "image_gen_prompt_presets";
+    requestId: string;
+    userId?: string;
+} | {
+    type: "image_gen_cancel_native";
+    requestId: string;
+    jobId: string;
+    userId?: string;
+};
 /** Result from `spindle.imageGen.generateNative()`. */
 export interface ImageGenNativeResultDTO {
     generated: boolean;
@@ -812,6 +918,10 @@ export interface ImageGenNativeResultDTO {
     imageDataUrl?: string;
     imageId?: string;
     imageUrl?: string;
+    mediaType?: "image" | "video";
+    mimeType?: string;
+    /** Authenticated media URL; imageId/imageUrl remain available for compatibility. */
+    mediaUrl?: string;
     jobId?: string;
 }
 /** Result from `spindle.imageGen.generate()` */
@@ -3134,7 +3244,7 @@ export interface ProviderManager {
         key: ProviderKeyDTO;
     }) => void): () => void;
 }
-export type WorkerToHost = {
+export type WorkerToHost = import("./desktop-capture.js").DesktopCaptureWorkerMessage | {
     type: "subscribe_event";
     event: string;
 } | {
@@ -3161,6 +3271,7 @@ export type WorkerToHost = {
     registrationId: string;
     priority?: number;
     match?: InterceptorMatchDTO;
+    required?: boolean;
 } | {
     type: "unregister_interceptor";
     registrationId: string;
@@ -3507,13 +3618,16 @@ export type WorkerToHost = {
     type: "register_context_handler";
     priority?: number;
     timeoutMs?: number;
+    required?: boolean;
 } | {
     type: "context_handler_result";
     requestId: string;
     context: unknown;
+    error?: string;
 } | {
     type: "register_macro_interceptor";
     priority?: number;
+    handlesOwnedSources?: boolean;
 } | {
     type: "macro_interceptor_result";
     requestId: string;
@@ -3541,6 +3655,20 @@ export type WorkerToHost = {
     type: "frontend_message";
     payload: unknown;
     userId?: string;
+    frontendSessionId?: string;
+} | {
+    type: "runtime_state_read";
+    requestId: string;
+    chatId: string;
+    characterId: string;
+    userId?: string;
+} | {
+    type: "runtime_state_write";
+    requestId: string;
+    chatId: string;
+    command: import("./runtime-state.js").RuntimeStateCommandDTO;
+    userId?: string;
+    mutationId?: string;
 } | {
     type: "user_storage_read";
     requestId: string;
@@ -4695,6 +4823,10 @@ export type HostToWorker = {
     type: "context_handler_request";
     requestId: string;
     context: unknown;
+} | {
+    type: "context_handler_abort";
+    requestId: string;
+    reason: string;
 } | {
     type: "macro_interceptor_request";
     requestId: string;
@@ -4757,6 +4889,7 @@ export type HostToWorker = {
     type: "frontend_message";
     payload: unknown;
     userId: string;
+    frontendSessionId?: string;
 } | {
     type: "frontend_process_lifecycle";
     event: FrontendProcessLifecycleEventDTO;

package/dist/desktop-capture.d.ts

@@ -0,0 +1,100 @@
+export type DesktopCaptureKind = "image" | "video";
+export interface DesktopCaptureDevice {
+    id: string;
+    name: string;
+    platform: "linux" | "macos" | "windows";
+    capabilities: {
+        image: boolean;
+        video: boolean;
+        replay: boolean;
+    };
+    expiresAt: number;
+}
+export type DesktopCaptureRequest = {
+    deviceId: string;
+    connectionId: string;
+    purpose: string;
+    userId?: string;
+} & ({
+    kind: "image";
+} | {
+    kind: "video";
+    mode: "record" | "replay";
+    durationSeconds: number;
+});
+export interface CapturedMediaRef {
+    assetId: string;
+    kind: DesktopCaptureKind;
+    mimeType: string;
+    width: number;
+    height: number;
+    durationSeconds?: number;
+    connectionId: string;
+    expiresAt: number;
+}
+export interface SpindleDesktopAPI {
+    capture: {
+        listDevices(options?: {
+            userId?: string;
+        }): Promise<DesktopCaptureDevice[]>;
+        request(input: DesktopCaptureRequest): Promise<CapturedMediaRef>;
+        release(assetId: string, options?: {
+            userId?: string;
+        }): Promise<void>;
+    };
+}
+export type DesktopCaptureWorkerMessage = {
+    type: "desktop_capture_devices";
+    requestId: string;
+    userId?: string;
+} | {
+    type: "desktop_capture_request";
+    requestId: string;
+    input: DesktopCaptureRequest;
+} | {
+    type: "desktop_capture_release";
+    requestId: string;
+    assetId: string;
+    userId?: string;
+};
+export interface DesktopCaptureDestination {
+    connectionId: string;
+    revision: string;
+    provider: string;
+    model: string;
+    endpointOrigin: string;
+}
+export type DesktopCaptureCommand = {
+    type: "capture";
+    requestId: string;
+    extension: {
+        id: string;
+        identifier: string;
+        name: string;
+    };
+    purpose: string;
+    kind: DesktopCaptureKind;
+    mode?: "record" | "replay";
+    durationSeconds?: number;
+    destination: Omit<DesktopCaptureDestination, "revision">;
+    maxBytes: number;
+    maxPixels: number;
+    expiresAt: number;
+} | {
+    type: "cancel";
+    requestId: string;
+};
+export type DesktopCaptureReply = {
+    requestId: string;
+    outcome: "approved";
+    media: {
+        mimeType: string;
+        data: string;
+        width: number;
+        height: number;
+        durationSeconds?: number;
+    };
+} | {
+    requestId: string;
+    outcome: "denied" | "cancelled" | "unsupported" | "failed";
+};

package/dist/desktop-capture.js

@@ -0,0 +1 @@
+export {};

package/dist/dom.d.ts

@@ -734,6 +734,8 @@ export interface SpindleDisplayContext {
 }
 export interface SpindleDisplayResolveResult {
     content: string;
+    /** Opaque local state carried from resolveBody to applyScripts with this content, including cache hits. */
+    processingState?: string;
     touchedVars?: string[];
     cacheable?: boolean;
 }
@@ -752,6 +754,8 @@ export interface SpindleDisplayTemplatesArgs {
 }
 export interface SpindleDisplayScriptsArgs {
     content: string;
+    /** The processingState returned by resolveBody for this content. Never sent to the backend. */
+    processingState?: string;
     scripts: unknown[];
     context: SpindleDisplayContext;
     resolvedFindPatterns?: Record<string, string>;
@@ -765,6 +769,10 @@ export interface SpindleDisplayScriptsArgs {
  * not ready for the chat, throws, or returns `null`.
  */
 export interface SpindleDisplayResolver {
+    /** Skip automatic formatting repairs in owned chat message bodies. Defaults to false; HTML sanitization still applies. */
+    skipFormattingHealing?: boolean;
+    /** Opt into finalization when no display scripts are active. Defaults to false. */
+    finalizeWithoutScripts?: boolean;
     ready(chatId: string): boolean;
     resolveBody(args: SpindleDisplayBodyArgs): Promise<SpindleDisplayResolveResult | null>;
     resolveTemplates(args: SpindleDisplayTemplatesArgs): Promise<SpindleDisplayTemplatesResult | null>;
@@ -1025,6 +1033,8 @@ export interface SpindleRecentChatsPage<TRow = SpindleRecentChat> {
 }
 /** Context object provided to frontend extension modules */
 export interface SpindleFrontendContext {
+    /** Per-document routing identity, available with frontend-session-origin-v1. */
+    readonly frontendSessionId?: string;
     /** Immutable host compatibility descriptor for this extension runtime. */
     readonly host: SpindleHostDescriptorV1 & {
         readonly surfaces?: SpindleHostSurfaceAPI;
@@ -1035,7 +1045,7 @@ export interface SpindleFrontendContext {
     readonly theme: SpindleThemeAuthoringAPI;
     dom: SpindleDOMHelper;
     events: {
-        on(event: string, handler: (payload: unknown) => void): () => void;
+        on(event: string, handler: (payload: unknown, metadata?: import("./runtime-state.js").RuntimeEventMetadataDTO) => void): () => void;
         emit(event: string, payload: unknown): void;
     };
     ui: {

package/dist/events.d.ts

@@ -11,6 +11,7 @@ export declare enum SpindleEvent {
  */
 export declare enum CoreEventType {
     CONNECTED = "CONNECTED",
+    FRONTEND_SESSION_CLOSED = "FRONTEND_SESSION_CLOSED",
     CHAT_CHANGED = "CHAT_CHANGED",
     CHAT_SWITCHED = "CHAT_SWITCHED",
     CHAT_FORKED = "CHAT_FORKED",

package/dist/events.js

@@ -13,6 +13,7 @@ export var SpindleEvent;
 export var CoreEventType;
 (function (CoreEventType) {
     CoreEventType["CONNECTED"] = "CONNECTED";
+    CoreEventType["FRONTEND_SESSION_CLOSED"] = "FRONTEND_SESSION_CLOSED";
     CoreEventType["CHAT_CHANGED"] = "CHAT_CHANGED";
     CoreEventType["CHAT_SWITCHED"] = "CHAT_SWITCHED";
     CoreEventType["CHAT_FORKED"] = "CHAT_FORKED";

package/dist/index.d.ts

@@ -5,13 +5,15 @@ export { SPINDLE_HOST_CAPABILITIES, SPINDLE_COMPATIBILITY_ERROR_CODE, } from "./
 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";
 export type { SpindlePermission as SpindlePermissionType } from "./permissions.js";
+export type { DesktopCaptureKind, DesktopCaptureDevice, DesktopCaptureRequest, CapturedMediaRef, SpindleDesktopAPI, DesktopCaptureWorkerMessage, DesktopCaptureDestination, DesktopCaptureCommand, DesktopCaptureReply, } from "./desktop-capture.js";
 export { ALL_PERMISSIONS, isValidPermission } from "./permissions.js";
 export type { SpindleCapability as SpindleCapabilityType } from "./capabilities.js";
 export { ALL_CAPABILITIES, isValidCapability } from "./capabilities.js";
 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, 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, 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 { 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, 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/permissions.d.ts

@@ -37,6 +37,6 @@
  * - "mcp_servers"                  — inspect/connect user MCP servers and invoke advertised tools
  * - "mcp_servers.create"           — add MCP server profiles for a user
  */
-export type SpindlePermission = "generation" | "interceptor" | "tools" | "cors_proxy" | "context_handler" | "ephemeral_storage" | "chat_mutation" | "event_tracking" | "ui_panels" | "app_manipulation" | "oauth" | "characters" | "chats" | "presets" | "world_books" | "regex_scripts" | "regex_scripts_unrestricted" | "databanks" | "memories" | "media" | "personas" | "push_notification" | "image_gen" | "images" | "generation_parameters" | "macro_interceptor" | "web_search" | "unsafe_eval" | "final_response" | "providers.embedding.register" | "providers.tts.register" | "providers.stt.register" | "providers.sidecar.register" | "mcp_servers" | "mcp_servers.create";
+export type SpindlePermission = "screen_capture" | "screen_recording" | "generation" | "interceptor" | "tools" | "cors_proxy" | "context_handler" | "ephemeral_storage" | "chat_mutation" | "event_tracking" | "ui_panels" | "app_manipulation" | "oauth" | "characters" | "chats" | "presets" | "world_books" | "regex_scripts" | "regex_scripts_unrestricted" | "databanks" | "memories" | "media" | "personas" | "push_notification" | "image_gen" | "images" | "generation_parameters" | "macro_interceptor" | "web_search" | "unsafe_eval" | "final_response" | "providers.embedding.register" | "providers.tts.register" | "providers.stt.register" | "providers.sidecar.register" | "mcp_servers" | "mcp_servers.create";
 export declare const ALL_PERMISSIONS: readonly SpindlePermission[];
 export declare function isValidPermission(p: string): p is SpindlePermission;

package/dist/permissions.js

@@ -1,4 +1,6 @@
 export const ALL_PERMISSIONS = [
+    "screen_capture",
+    "screen_recording",
     "generation",
     "interceptor",
     "tools",

package/dist/runtime-state.d.ts

@@ -0,0 +1,99 @@
+import type { CharacterDTO, ChatDTO, PersonaDTO, WorldBookEntryDTO } from "./api.js";
+export interface RuntimeStateRevisionDTO {
+    epoch: string;
+    sequence: number;
+}
+export interface RuntimeEventMetadataDTO {
+    stateRevision?: RuntimeStateRevisionDTO;
+    runtimeMutationId?: string;
+}
+export type RuntimeCharacterDTO = Omit<CharacterDTO, "extensions">;
+export type RuntimeChatDTO = Omit<ChatDTO, "character_id"> & {
+    character_id: string | null;
+};
+export interface RuntimeMessageDTO {
+    id: string;
+    content: string;
+    role: "user" | "assistant" | "system";
+    name: string;
+    index_in_chat: number;
+    created_at: number;
+    send_date: number;
+    extra: {
+        greeting_index?: unknown;
+    };
+}
+export interface RuntimeStateSnapshotDTO {
+    revision: RuntimeStateRevisionDTO;
+    chat: RuntimeChatDTO;
+    character: RuntimeCharacterDTO;
+    persona: PersonaDTO | null;
+    messages: RuntimeMessageDTO[];
+    lore: WorldBookEntryDTO[];
+    globalVariables: unknown;
+}
+export type RuntimeStateCommandDTO = {
+    kind: "chat.metadata";
+    key: string;
+    value: unknown;
+} | {
+    kind: "chat.variables";
+    values: Record<string, string | null>;
+} | {
+    kind: "message.edit";
+    id: string;
+    content: string;
+} | {
+    kind: "message.delete";
+    id: string;
+} | {
+    kind: "message.create";
+    id: string;
+    content: string;
+    role: "user" | "assistant" | "system";
+} | {
+    kind: "character.update";
+    id: string;
+    patch: {
+        name?: string;
+        description?: string;
+        first_mes?: string;
+    };
+} | {
+    kind: "persona.update";
+    id: string;
+    patch: {
+        name?: string;
+        description?: string;
+    };
+} | {
+    kind: "lore.create";
+    bookId: string;
+    patch: Record<string, unknown>;
+} | {
+    kind: "lore.update";
+    id: string;
+    patch: Record<string, unknown>;
+} | {
+    kind: "lore.delete";
+    id: string;
+};
+export interface RuntimeStateAcknowledgementDTO {
+    revision: RuntimeStateRevisionDTO;
+    value: unknown;
+    patch: {
+        chat?: RuntimeChatDTO;
+        character?: RuntimeCharacterDTO;
+        persona?: PersonaDTO;
+        message?: RuntimeMessageDTO;
+        deletedMessageId?: string;
+        loreEntry?: WorldBookEntryDTO;
+        deletedLoreId?: string;
+    };
+}
+export interface SpindleRuntimeStateAPI {
+    /** Requires characters, chats, chat_mutation, personas, and world_books permissions. */
+    read(chatId: string, characterId: string, userId?: string): Promise<RuntimeStateSnapshotDTO>;
+    /** Mutation IDs correlate events with acknowledgements; they do not provide idempotency. */
+    write(chatId: string, command: RuntimeStateCommandDTO, userId?: string, mutationId?: string): Promise<RuntimeStateAcknowledgementDTO>;
+}

package/dist/runtime-state.js

@@ -0,0 +1 @@
+export {};

package/dist/spindle-api.d.ts

@@ -1,8 +1,9 @@
 import type { SpindleManifest } from "./manifest.js";
 import type { SpindleHostDescriptorV1 } from "./host.js";
+import type { SpindleDesktopAPI } from "./desktop-capture.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, 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, 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 { 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. */
@@ -132,6 +133,7 @@ export interface SpindleConnectionsAPI {
 }
 /** The global `spindle` object available in backend extension workers */
 export interface SpindleAPI {
+    readonly desktop: SpindleDesktopAPI;
     /** Immutable host compatibility descriptor for this extension runtime. */
     readonly host: SpindleHostDescriptorV1;
     /**
@@ -697,6 +699,19 @@ export interface SpindleAPI {
          * connection-level generation semantics remain unchanged.
          */
         generateNative(input: ImageGenNativeRequestDTO): Promise<ImageGenNativeResultDTO>;
+        /**
+         * Read Main Presets and active preset/connection IDs without changing settings.
+         * Requires image_gen permission and account scope. Optional because older
+         * hosts do not implement it; feature-detect before calling.
+         */
+        getPromptPresets?(userId?: string): Promise<ImageGenPromptPresetsResultDTO>;
+        /**
+         * Cancel an in-flight native job owned by this extension and account.
+         * Returns false when no matching job exists. Requires image_gen permission;
+         * feature-detect on older hosts. Supply clientJobId when starting the job to
+         * know its ID before generateNative resolves.
+         */
+        cancelNative?(jobId: string, userId?: string): Promise<boolean>;
         /**
          * Generate through a provider that supports WebSocket preview images and
          * status updates (currently SwarmUI and ComfyUI). The terminal `done`
@@ -1340,9 +1355,12 @@ export interface SpindleAPI {
      * `dryRun` (tokenize/preview assemblies) and `userId`, returning it with
      * `cancelGeneration: true` stops the generation, and `opts.timeoutMs`
      * overrides the default 10s wall-clock budget (clamped to 1s-120s).
+     * Hosts with required-context-handlers-v1 supply cancellation and honor
+     * `required: true` by stopping generation on handler failure or timeout.
      */
-    registerContextHandler(handler: (context: unknown) => Promise<unknown>, priority?: number, opts?: {
+    registerContextHandler(handler: (context: unknown, signal?: AbortSignal) => Promise<unknown>, priority?: number, opts?: {
         timeoutMs?: number;
+        required?: boolean;
     }): void;
     /**
      * Host contract versions for feature detection, keyed by contract name.
@@ -1371,11 +1389,18 @@ export interface SpindleAPI {
      * Each invocation runs inside a 10-second wall-clock budget on the host.
      * On timeout or thrown error the chain logs the failure and forwards the
      * previous template to the next handler — macro evaluation itself never
-     * aborts. A second registration from the same extension replaces the
+     * aborts in the normal chain. Owned-source evaluation instead rejects on failure.
+     * A second registration from the same extension replaces the
      * previous handler.
      *
      * @param handler  Returns the transformed template, or `void` to pass through.
      * @param priority Lower values run first. Default `100`.
+     * @param opts Opt into exclusive evaluation of macro-bearing regex templates owned
+     * by this extension. The handler receives the unmodified source with `sourceOwner`
+     * set and must return a result, which is used verbatim without native evaluation.
+     * Plain templates skip dispatch. Stored messages on characters with this extension
+     * namespace's `display_owner: true` also stay verbatim for its display pipeline.
+     * Other templates retain normal chain behavior.
      *
      * @example
      * ```ts
@@ -1385,7 +1410,9 @@ export interface SpindleAPI {
      * }, 100)
      * ```
      */
-    registerMacroInterceptor(handler: (ctx: MacroInterceptorCtxDTO) => Promise<MacroInterceptorResultDTO>, priority?: number): void;
+    registerMacroInterceptor(handler: (ctx: MacroInterceptorCtxDTO) => Promise<MacroInterceptorResultDTO>, priority?: number, opts?: {
+        handlesOwnedSources?: boolean;
+    }): void;
     /**
      * Register a world info interceptor (permission: `generation`).
      *
@@ -1467,10 +1494,16 @@ export interface SpindleAPI {
      *                 other API call site that surfaced one) to route the reply
      *                 only to that user. User-scoped extensions always deliver
      *                 to their installer regardless of this argument.
+     * @param options A document target requires frontend-session-routing-v1 and
+     *                never falls back to broadcasting when disconnected.
      */
-    sendToFrontend(payload: unknown, userId?: string): void;
+    sendToFrontend(payload: unknown, userId?: string, options?: {
+        frontendSessionId?: string;
+    }): void;
     /** Receive messages from the frontend module (userId is the sender) */
-    onFrontendMessage(handler: (payload: unknown, userId: string) => void): () => void;
+    onFrontendMessage(handler: (payload: unknown, userId: string, frontendSessionId?: string) => void): () => void;
+    /** Versioned snapshots and command acknowledgements; requires runtime-state-v1. */
+    runtimeState: import("./runtime-state.js").SpindleRuntimeStateAPI;
     /**
      * Backend-owned lifecycle controller for tracked frontend processes.
      *

package/package.json

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