lumiverse-spindle-types 0.6.32 → 0.6.34

package/dist/api.d.ts

@@ -1598,6 +1598,8 @@ export interface WorldInfoInterceptorEntryDTO {
     readonly delay: number;
     /** Latest prompt-local chat placement supplied by an earlier handler. */
     readonly placement?: WorldInfoInterceptorPlacementDTO;
+    /** Active output-order request from an earlier handler; omission means selection order. */
+    readonly outputOrder?: "selection" | "insertion";
     /** Attachment scope that contributed the entry's book to this chat. */
     readonly book_source?: WorldBookSourceDTO;
 }
@@ -1663,8 +1665,8 @@ export interface WorldInfoInterceptorCtxDTO {
     readonly activationSettings: WorldInfoActivationSettingsDTO;
 }
 /**
- * Per-entry content overrides emitted by a `registerWorldInfoInterceptor`
- * handler. Both values are prompt-local and never persist to the world book.
+ * Per-entry overrides emitted by a `registerWorldInfoInterceptor` handler.
+ * Overrides are prompt-local and never persist to the world book.
  */
 export interface WorldInfoInterceptorMutationDTO {
     readonly id: string;
@@ -1681,6 +1683,18 @@ export interface WorldInfoInterceptorMutationDTO {
      * Omit it to retain the stored native position, depth, and role.
      */
     readonly placement?: WorldInfoInterceptorPlacementDTO;
+    /**
+     * "insertion" orders selected entries by order_value ascending, reversing
+     * equal-order ties relative to selection order, as chat-depth placement does.
+     * Entries requested by the same extension exchange only their own output
+     * slots; other entries and other extensions' groups retain their slots.
+     * This runs after selection and budget filtering and applies to native
+     * position buckets and named outlets. Explicit chat-depth placement takes
+     * precedence and keeps its existing ordering.
+     * "selection" clears an earlier request; omission leaves it unchanged.
+     * The last valid request for an entry determines its extension group.
+     */
+    readonly outputOrder?: "selection" | "insertion";
 }
 /**
  * Return value of a `registerWorldInfoInterceptor` handler. Each list is

package/dist/dom.d.ts

@@ -1278,8 +1278,26 @@ export type SpindleFrontendContextV2 = SpindleFrontendContext & {
 };
 /** Cleanup returned by a frontend extension setup hook. */
 export type SpindleFrontendTeardown = () => void | Promise<void>;
+/** Metadata for the single widget requested by a native desktop pop-out. */
+export interface SpindleFrontendWidgetTarget {
+    /** Zero-based position among this extension's visible floating widgets. */
+    index: number;
+    /** Host-provided display title for the native window. */
+    title: string;
+    /** Initial widget content width in logical pixels. */
+    width: number;
+    /** Initial widget content height in logical pixels. */
+    height: number;
+    /** Whether the extension requested a host window without title chrome. */
+    chromeless: boolean;
+}
 /** What a frontend extension module must export */
 export interface SpindleFrontendModule {
     setup(ctx: SpindleFrontendContext): void | SpindleFrontendTeardown | Promise<void | SpindleFrontendTeardown>;
     teardown?(): void | Promise<void>;
 }
+/** A lightweight native floating-widget frontend module. */
+export interface SpindleWidgetFrontendModule {
+    setupWidget(ctx: SpindleFrontendContext, target: SpindleFrontendWidgetTarget): void | SpindleFrontendTeardown | Promise<void | SpindleFrontendTeardown>;
+    teardown?(): void | Promise<void>;
+}

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export { ALL_FRONTEND_RUNTIME_CAPABILITIES, isValidFrontendRuntimeCapability, }
 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 { 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, 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 { 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";
 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";

package/dist/manifest.d.ts

@@ -27,6 +27,11 @@ export interface SpindleManifest {
     entry_backend?: string;
     /** Frontend entry point (default: "dist/frontend.js") */
     entry_frontend?: string;
+    /**
+     * Optional lightweight frontend entry used only by native desktop
+     * floating-widget windows. The module must export setupWidget().
+     */
+    entry_frontend_widget?: string;
     /** Minimum Lumiverse version required */
     minimum_lumiverse_version?: string;
     /** Files/directories to seed into extension storage on install/import/update */

package/dist/spindle-api.d.ts

@@ -1349,6 +1349,9 @@ export interface SpindleAPI {
      * `preAssemblyGenerationContext >= 1`: generation contexts carry
      * `dryRun`/`userId` and `cancelGeneration` is honored.
      * `worldInfoActivationCapture >= 1`: world info activation capture is supported.
+     * `worldInfoOutputOrdering >= 1`: world info mutations accept prompt-local
+     * `outputOrder`, applied after selection without changing budget priority.
+     *
      * `worldInfoRuntimePlacement >= 1`: world info mutations accept prompt-local
      * chat-depth placement.
      */

package/package.json

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