lumiverse-spindle-types 0.5.24 → 0.5.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.5.24",
+  "version": "0.5.26",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/api.ts

@@ -2944,6 +2944,8 @@ export type HostToWorker =
     }
   | {
       type: "permission_changed";
+      /** Extension identifier for the worker receiving this scoped change */
+      extensionId?: string;
       permission: string;
       granted: boolean;
       allGranted: string[];

package/src/dom.ts

@@ -810,6 +810,17 @@ export interface SpindleFrontendContext {
    * ```
    */
   getActiveChat(): { chatId: string | null; characterId: string | null };
+  /**
+   * Signal that the frontend is ready to receive any startup messages that
+   * were queued while the bundle was loading.
+   */
+  ready(): void;
+  /**
+   * Opt out of legacy auto-ready behavior. Call during setup() before it
+   * returns if initialization continues asynchronously and startup messages
+   * should remain queued until a later `ready()` call.
+   */
+  deferReady(): void;
   sendToBackend(payload: unknown): void;
   onBackendMessage(handler: (payload: unknown) => void): () => void;
   /** Structured lifecycle hooks for backend-spawned frontend processes. */

package/src/spindle-api.ts

@@ -224,6 +224,12 @@ export interface SpindlePromptRegex {
 
 /** The global `spindle` object available in backend extension workers */
 export interface SpindleAPI {
+  /**
+   * Subscribe to permission grant/revoke changes for this extension only.
+   * This is delivered directly by the worker host and does not subscribe to
+   * the global backend event bus.
+   */
+  on(event: "PERMISSION_CHANGED", handler: (payload: PermissionChangedDetail) => void): () => void;
   /** Subscribe to generation-started events (requires `generation` permission). The optional `userId` identifies which user triggered the event. */
   on(event: "GENERATION_STARTED", handler: (payload: GenerationStartedPayloadDTO, userId?: string) => void): () => void;
   /** Subscribe to streamed token events (requires `generation` permission). The optional `userId` identifies which user triggered the event. */