lumiverse-spindle-types 0.6.21 → 0.6.22

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/dom.d.ts

@@ -1205,7 +1205,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,6 +9,8 @@ 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";

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.22",
   "type": "module",
   "types": "./dist/index.d.ts",
   "keywords": [