lumiverse-spindle-types 0.6.21 → 0.6.23

package/dist/api.d.ts

@@ -2973,6 +2973,12 @@ export type WorkerToHost = {
 } | {
     type: "unsubscribe_event";
     event: string;
+} | {
+    type: "register_frontend_runtime_capability";
+    capability: import("./frontend-capabilities.js").SpindleFrontendRuntimeCapability;
+} | {
+    type: "unregister_frontend_runtime_capability";
+    capability: import("./frontend-capabilities.js").SpindleFrontendRuntimeCapability;
 } | {
     type: "register_macro";
     definition: MacroDefinitionDTO;

package/dist/components.d.ts

@@ -568,10 +568,15 @@ export type SpindleCloseButtonHandle = SpindleMountedComponent<SpindleCloseButto
  * ```
  */
 /** Handle returned by {@link SpindleComponentsHelper.mountHostSurface}. */
+export type SpindleHostSurfaceJsonValue = null | boolean | number | string | readonly SpindleHostSurfaceJsonValue[] | {
+    readonly [key: string]: SpindleHostSurfaceJsonValue;
+};
+export type SpindleHostSurfaceProps = Record<string, SpindleHostSurfaceJsonValue>;
+export type SpindleHostSurfaceEventHandler = (payload: SpindleHostSurfaceJsonValue) => void;
 export interface SpindleHostSurfaceHandle {
-    update(props?: Record<string, unknown>): void;
+    update(props: SpindleHostSurfaceProps): void;
     destroy(): void;
-    on(event: string, handler: (payload: unknown) => void): () => void;
+    on(event: string, handler: SpindleHostSurfaceEventHandler): () => void;
 }
 export interface SpindleComponentsHelper {
     mountTextInput(target: SpindleComponentTarget, options?: SpindleTextInputOptions): SpindleTextInputHandle;
@@ -592,5 +597,5 @@ export interface SpindleComponentsHelper {
     mountCloseButton(target: SpindleComponentTarget, options?: SpindleCloseButtonOptions): SpindleCloseButtonHandle;
     mountLoomBlockEditor(target: SpindleComponentTarget, options: SpindleLoomBlockEditorOptions): SpindleLoomBlockEditorHandle;
     /** Mount a host-owned named surface into extension-owned DOM. */
-    mountHostSurface(target: SpindleComponentTarget, surfaceId: string, props?: Record<string, unknown>): SpindleHostSurfaceHandle;
+    mountHostSurface(target: SpindleComponentTarget, surfaceId: string, props?: SpindleHostSurfaceProps): SpindleHostSurfaceHandle;
 }

package/dist/dom.d.ts

@@ -772,14 +772,17 @@ export interface SpindleDisplayResolverRegistry {
     }): void;
 }
 export interface SpindleSettingsAPI {
-    get(key: string): Promise<unknown> | unknown;
-    set(key: string, value: unknown): Promise<void> | void;
-    remove(key: string): Promise<void> | void;
-    watch(key: string, listener: (value: unknown) => void): () => void;
-    core: {
-        get(key: string): Promise<unknown> | unknown;
-        watch(key: string, listener: (value: unknown) => void): () => void;
-        list(): Promise<readonly string[]> | readonly string[];
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    watch<T>(key: string, listener: (value: T | undefined) => void): () => void;
+    readonly core: {
+        get<T>(key: string): T | undefined;
+        watch<T>(key: string, listener: (value: T) => void): () => void;
+        list(): Array<{
+            key: string;
+            permission: string | null;
+        }>;
         isReady(): boolean;
     };
 }
@@ -787,38 +790,39 @@ export interface SpindleSettingsTabSection {
     readonly key: string;
     readonly titleKey: string;
     readonly titleFallback: string;
-    readonly keywords?: readonly string[];
+    readonly keywords: readonly string[];
 }
 export interface SpindleSettingsTabOptions {
-    /** Unique tab identifier. A shared tab id may belong to core or to another extension. */
-    id: string;
-    /** Tab title shown in settings navigation. */
-    title: string;
+    /** A shared tab id may belong to core or to another extension. */
+    readonly id: string;
+    /** Metadata is ignored when a core tab owns this id. */
+    readonly title?: string;
     /** Short label for compact layouts. */
-    shortName?: string;
+    readonly shortName?: string;
     /** Inline SVG string for the tab icon. */
-    iconSvg?: string;
+    readonly iconSvg?: string;
     /** Description for search and command palette. */
-    description?: string;
+    readonly description?: string;
     /** Keywords for search indexing. */
-    keywords?: readonly string[];
+    readonly keywords?: readonly string[];
     /** Sub-sections within the settings tab for search indexing and navigation. */
-    sections?: readonly SpindleSettingsTabSection[];
+    readonly sections?: readonly SpindleSettingsTabSection[];
     /**
      * Relative tab position: 'top', 'bottom', 'after-display', 'before-chat',
      * 'after-<tabId>', 'before-<tabId>', or any specific tab identifier.
      */
-    position?: 'top' | 'bottom' | `after-${string}` | `before-${string}` | string;
+    readonly position?: string;
     /** Body order among registrants sharing a tab. Defaults to 100. */
-    order?: number;
-    /** Optional render callback for mounting tab content into root. */
-    render?: (root: HTMLElement) => void | (() => void);
+    readonly order?: number;
 }
 export interface SpindleSettingsTabHandle {
-    readonly id: string;
+    readonly registrationId: string;
+    readonly tabId: string;
     readonly root: HTMLElement;
-    update(options?: Partial<SpindleSettingsTabOptions>): void;
+    setTitle(title: string): void;
+    activate(): void;
     destroy(): void;
+    onActivate(callback: () => void): () => void;
 }
 export interface SpindleStateSelectors {
     get<T = unknown>(selector: string): T;
@@ -837,16 +841,39 @@ export interface SpindleGeometryAPI {
     layoutElementRect(element: Element): DOMRect;
     createResizeController(element: Element, listener: (rect: DOMRect) => void): SpindleResizeController;
 }
+export type SpindleHostSurfaceKind = "drawer_tab" | "settings_tab" | "command" | "route" | "modal" | "input_bar_action" | "ext_command";
+export interface SpindleHostSurfaceRef {
+    kind: SpindleHostSurfaceKind;
+    id: string;
+}
+export type SpindleHostActionJsonValue = null | boolean | number | string | SpindleHostActionJsonValue[] | {
+    [key: string]: SpindleHostActionJsonValue;
+};
+export type SpindleHostActionParams = Record<string, SpindleHostActionJsonValue>;
 export interface SpindleHostSurfaceInfo {
+    kind: SpindleHostSurfaceKind;
     id: string;
-    title?: string;
-    capabilities?: readonly string[];
+    label: string;
+    description?: string;
+    keywords?: string[];
+    iconName?: string;
+    iconSvg?: string;
+    scope?: "global" | "chat" | "chat-idle" | "landing" | "character";
+    role?: "admin" | "owner";
+    owner?: string;
+    invocable?: boolean;
+}
+export interface SpindleHostSurfaceTarget {
+    kind: string;
+    id: string;
+    parentId?: string;
 }
+export type SpindleHostSurfaceTargetHandler = (target: SpindleHostSurfaceTarget) => void;
 export interface SpindleHostSurfaceAPI {
-    list(): readonly SpindleHostSurfaceInfo[] | Promise<readonly SpindleHostSurfaceInfo[]>;
-    subscribe(listener: (surfaces: readonly SpindleHostSurfaceInfo[]) => void): () => void;
-    invoke(surfaceId: string, method: string, params?: unknown): Promise<unknown>;
-    registerDeepLinkTarget(target: string, handler: (params: Record<string, string>) => void): () => void;
+    list(kinds?: readonly SpindleHostSurfaceKind[]): SpindleHostSurfaceInfo[];
+    subscribe(listener: (surfaces: SpindleHostSurfaceInfo[]) => void): () => void;
+    invoke(ref: SpindleHostSurfaceRef, params?: SpindleHostActionParams): void | Promise<void>;
+    registerDeepLinkTarget(kind: string, id: string, handler: SpindleHostSurfaceTargetHandler): () => void;
 }
 export interface SpindleComponentOverrideOptions {
     componentId: string;
@@ -1205,7 +1232,7 @@ export interface SpindleFrontendContext {
     };
     /** Take over display-time content resolution in the browser. */
     display?: SpindleDisplayResolverRegistry;
-    manifest: import("./manifest").SpindleManifest;
+    manifest: import("./manifest.js").SpindleManifest;
     settings?: SpindleSettingsAPI;
     registerComponentOverride?(options: SpindleComponentOverrideOptions): SpindleComponentOverrideHandle;
     registerDomDecorator?(options: SpindleDomDecoratorOptions): SpindleDomDecoratorHandle;

package/dist/extension-info.d.ts

@@ -1,4 +1,5 @@
 import type { SpindlePermission } from "./permissions.js";
+import type { SpindleFrontendRuntimeCapability } from "./frontend-capabilities.js";
 /** Extension info as returned by the backend API */
 export interface ExtensionInfo {
     id: string;
@@ -16,6 +17,8 @@ export interface ExtensionInfo {
     updated_at: number;
     has_frontend: boolean;
     has_backend: boolean;
+    /** Capabilities declared by the currently running backend worker. */
+    frontend_runtime_capabilities?: SpindleFrontendRuntimeCapability[];
     status: "running" | "stopped" | "error";
     metadata: Record<string, unknown>;
 }

package/dist/frontend-capabilities.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Backend-declared capabilities that require the host to coordinate frontend
+ * extension startup before rendering dependent UI.
+ */
+export declare const ALL_FRONTEND_RUNTIME_CAPABILITIES: readonly ["message_tag_interceptor"];
+export type SpindleFrontendRuntimeCapability = (typeof ALL_FRONTEND_RUNTIME_CAPABILITIES)[number];
+export declare function isValidFrontendRuntimeCapability(capability: string): capability is SpindleFrontendRuntimeCapability;

package/dist/frontend-capabilities.js

@@ -0,0 +1,10 @@
+/**
+ * Backend-declared capabilities that require the host to coordinate frontend
+ * extension startup before rendering dependent UI.
+ */
+export const ALL_FRONTEND_RUNTIME_CAPABILITIES = [
+    "message_tag_interceptor",
+];
+export function isValidFrontendRuntimeCapability(capability) {
+    return ALL_FRONTEND_RUNTIME_CAPABILITIES.includes(capability);
+}

package/dist/host.js

@@ -9,6 +9,7 @@ export const SPINDLE_HOST_CAPABILITIES = Object.freeze({
     "connection-dispatch-resolution-v1": 1,
     "text-editor-close-v1": 1,
     "frontend-extensibility-v2": 1,
+    "frontend-runtime-capabilities-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

@@ -9,11 +9,13 @@ 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 { 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, 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, 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, SpindleHostSurfaceInfo, SpindleHostSurfaceAPI, SpindleComponentOverrideOptions, SpindleComponentOverrideHandle, SpindleDomDecoratorOptions, SpindleDomDecoratorHandle, SpindleMessageActionOptions, SpindleMessageActionHandle, SpindleFrontendWorldBooksAPI, SpindleFrontendTokensAPI, SpindleFrontendConnectionsAPI, SpindleFrontendChatsAPI, SpindleFrontendMessagesAPI, SpindleRecentChatsQuery, SpindleRecentChat, SpindleGroupedRecentChat, SpindleRecentChatsPage, SpindleFrontendModule, 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";
-export type { SpindleMountedComponent, SpindleComponentTarget, SpindleConnectionKind, SpindleConnectionRef, SpindleTextInputOptions, SpindleTextInputHandle, SpindleTextAreaOptions, SpindleTextAreaHandle, SpindleNumericInputOptions, SpindleNumericInputHandle, SpindleNumberStepperOptions, SpindleNumberStepperHandle, SpindleRangeSliderFormat, SpindleRangeSliderOptions, SpindleRangeSliderHandle, SpindleCheckboxOptions, SpindleCheckboxHandle, SpindleSwitchOptions, SpindleSwitchHandle, SpindleSelectOption, SpindleSelectOptionLeading, SpindleSelectOptionsBase, SpindleSelectOptions, SpindleSelectHandle, SpindleMultiSelectOptions, SpindleMultiSelectHandle, SpindleModelComboboxOptions, SpindleModelComboboxHandle, SpindleFolderDropdownOptions, SpindleFolderDropdownHandle, SpindleBadgeColor, SpindleBadgeOptions, SpindleBadgeHandle, SpindleSpinnerOptions, SpindleSpinnerHandle, SpindleCollapsibleSectionOptions, SpindleCollapsibleSectionHandle, SpindlePaginationOptions, SpindlePaginationHandle, SpindleCloseButtonOptions, SpindleCloseButtonHandle, SpindleLoomBlockEditorValue, SpindleLoomBlockEditorOptions, SpindleLoomBlockEditorHandle, SpindleComponentsHelper, SpindleHostSurfaceHandle, } from "./components.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, 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";
+export type { SpindleMountedComponent, SpindleComponentTarget, SpindleConnectionKind, SpindleConnectionRef, SpindleTextInputOptions, SpindleTextInputHandle, SpindleTextAreaOptions, SpindleTextAreaHandle, SpindleNumericInputOptions, SpindleNumericInputHandle, SpindleNumberStepperOptions, SpindleNumberStepperHandle, SpindleRangeSliderFormat, SpindleRangeSliderOptions, SpindleRangeSliderHandle, SpindleCheckboxOptions, SpindleCheckboxHandle, SpindleSwitchOptions, SpindleSwitchHandle, SpindleSelectOption, SpindleSelectOptionLeading, SpindleSelectOptionsBase, SpindleSelectOptions, SpindleSelectHandle, SpindleMultiSelectOptions, SpindleMultiSelectHandle, SpindleModelComboboxOptions, SpindleModelComboboxHandle, SpindleFolderDropdownOptions, SpindleFolderDropdownHandle, SpindleBadgeColor, SpindleBadgeOptions, SpindleBadgeHandle, SpindleSpinnerOptions, SpindleSpinnerHandle, SpindleCollapsibleSectionOptions, SpindleCollapsibleSectionHandle, SpindlePaginationOptions, SpindlePaginationHandle, SpindleCloseButtonOptions, SpindleCloseButtonHandle, SpindleLoomBlockEditorValue, SpindleLoomBlockEditorOptions, SpindleLoomBlockEditorHandle, SpindleComponentsHelper, SpindleHostSurfaceJsonValue, SpindleHostSurfaceProps, SpindleHostSurfaceEventHandler, SpindleHostSurfaceHandle, } from "./components.js";
 export type { ExtensionInfo } from "./extension-info.js";
 export type { EntityTypeDTO, EntityStatusDTO, MentionRoleDTO, RelationTypeDTO, RelationStatusDTO, EmotionalTagDTO, NarrativeFlagDTO, ContradictionFlagDTO, FactExtractionStatusDTO, EntityConfidenceDTO, SalienceSourceDTO, ChatLinkTypeDTO, SalienceBreakdownDTO, MemoryEntityDTO, MemoryEntityUpsertDTO, MemoryEntityStatusUpdateDTO, MemoryMentionDTO, MemoryRelationDTO, MemoryRelationUpsertDTO, StatusChangeDTO, MemorySalienceDTO, MemoryConsolidationDTO, CortexQueryDTO, CortexMemoryComponentsDTO, CortexMemoryDTO, EntitySnapshotRelationshipDTO, EntitySnapshotDTO, RelationEdgeDTO, CortexStatsDTO, CortexResultDTO, VaultDTO, VaultChunkDTO, VaultEntityDTO, VaultRelationDTO, VaultCreateDTO, VaultWithContentsDTO, VaultReindexResultDTO, ChatLinkDTO, ChatLinkAttachDTO, VaultCortexDataDTO, InterlinkCortexDataDTO, LinkedCortexResultDTO, MemoryCortexConfigDTO, CortexUsageStatsDTO, CortexIngestionTimingsDTO, CortexIngestionStatusDTO, CortexIngestionTelemetryDTO, ChatChunkDTO, ChatMemoryWarmupResultDTO, } from "./memories.js";
 export type { SpindleAPI, SpindleGenerateAPI, SpindleConnectionsAPI, SpindlePromptRegex, FrontendProcessHandle, BackendProcessHandle, SpindleBackendProcessContext, SpindleBackendProcessModule, SpindleEmbeddingDriver, SpindleTtsEngine, SpindleSttEngine, SpindleSidecarEndpoint, } from "./spindle-api.js";

package/dist/index.js

@@ -4,5 +4,6 @@ export { SPINDLE_THEME_AUTHORING_HOST_CAPABILITIES } from "./theme.js";
 export { ALL_PERMISSIONS, isValidPermission } from "./permissions.js";
 export { ALL_CAPABILITIES, isValidCapability } from "./capabilities.js";
 export { SpindleEvent, CoreEventType } from "./events.js";
+export { ALL_FRONTEND_RUNTIME_CAPABILITIES, isValidFrontendRuntimeCapability, } from "./frontend-capabilities.js";
 export { PERMISSION_DENIED_PREFIX } from "./api.js";
 export { SIDECAR_DEFAULTS, COUNCIL_SIDECAR_DEFAULTS, COUNCIL_TOOLS_DEFAULTS, COUNCIL_SETTINGS_DEFAULTS, } from "./council.js";

package/dist/manifest.d.ts

@@ -49,8 +49,8 @@ export interface SpindleStorageSeedFile {
     /** If true, fail install/import/update when source path is missing */
     required?: boolean;
 }
-export type SpindlePermission = import("./permissions").SpindlePermission;
-export type SpindleCapability = import("./capabilities").SpindleCapability;
+export type SpindlePermission = import("./permissions.js").SpindlePermission;
+export type SpindleCapability = import("./capabilities.js").SpindleCapability;
 /** Regex for validating extension identifiers */
 export declare const IDENTIFIER_PATTERN: RegExp;
 export declare function validateIdentifier(id: string): boolean;

package/dist/spindle-api.d.ts

@@ -134,6 +134,14 @@ export interface SpindleConnectionsAPI {
 export interface SpindleAPI {
     /** Immutable host compatibility descriptor for this extension runtime. */
     readonly host: SpindleHostDescriptorV1;
+    /**
+     * Declare frontend behavior that the host must account for before dependent
+     * UI is revealed. The returned disposer removes the declaration. Repeated
+     * declarations of the same capability are reference-counted by the worker.
+     */
+    frontendCapabilities: {
+        declare(capability: import("./frontend-capabilities.js").SpindleFrontendRuntimeCapability): () => void;
+    };
     /**
      * Subscribe to permission grant/revoke changes for this extension only.
      * This is delivered directly by the worker host and does not subscribe to

package/package.json

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