lumiverse-spindle-types 0.4.60 → 0.4.62

package/package.json

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

package/src/api.ts

@@ -44,6 +44,8 @@ export interface MacroDefinitionDTO {
   returnType?: "string" | "integer" | "number" | "boolean";
   args?: { name: string; description?: string; required?: boolean }[];
   handler: string; // serialized function body (executed in worker context)
+  /** Set true when the macro returns different output across calls with the same args (time, randomness, idle duration). The display-regex cache will not store resolutions that include this macro. */
+  volatile?: boolean;
 }
 
 /** Minimal shape exposed to extension macro handlers. Additional fields may be present. */
@@ -570,6 +572,14 @@ export interface ChatSwitchedPayloadDTO {
   chatId: string | null;
 }
 
+/** Payload for `CHAT_CHANGED` events. */
+export interface ChatChangedPayloadDTO {
+  /** The chat after the change. */
+  chat: { id: string; [key: string]: unknown };
+  /** Optional. Dot-paths of fields that differed between the prior and new chat (e.g. `metadata.macro_variables.local.foo`, `name`, `metadata.last_message_id`). Absent on events emitted by sources that don't compute the diff. */
+  changedFields?: string[];
+}
+
 // ─── World Book DTOs ─────────────────────────────────────────────────────
 
 /**

package/src/index.ts

@@ -36,6 +36,7 @@ export type {
    ChatDTO,
    ChatUpdateDTO,
    ChatSwitchedPayloadDTO,
+   ChatChangedPayloadDTO,
    WorldBookDTO,
   WorldBookCreateDTO,
   WorldBookUpdateDTO,

package/src/spindle-api.ts

@@ -73,6 +73,7 @@ import type {
   BackendProcessInfoDTO,
   BackendProcessLifecycleEventDTO,
   BackendProcessStopOptionsDTO,
+  ChatChangedPayloadDTO,
   GenerationStartedPayloadDTO,
   StreamTokenPayloadDTO,
   GenerationEndedPayloadDTO,
@@ -176,6 +177,8 @@ export interface SpindleAPI {
   on(event: "GENERATION_ENDED", handler: (payload: GenerationEndedPayloadDTO, userId?: string) => void): () => void;
   /** Subscribe to generation-stopped events (requires `generation` permission). The optional `userId` identifies which user triggered the event. */
   on(event: "GENERATION_STOPPED", handler: (payload: GenerationStoppedPayloadDTO, userId?: string) => void): () => void;
+  /** Subscribe to `CHAT_CHANGED` events. `changedFields` lists the dot-paths that differed when emitted by the standard `updateChat` path; absent on emits from other sources. */
+  on(event: "CHAT_CHANGED", handler: (payload: ChatChangedPayloadDTO, userId?: string) => void): () => void;
   /**
    * Subscribe to swipe lifecycle events. The payload's `action` discriminator
    * tells you whether a swipe was added, updated, deleted, or navigated, and
@@ -501,6 +504,8 @@ export interface SpindleAPI {
           text?: string | null;
           duration?: number | null;
         };
+        /** Internal-only escape hatch for extension/system rewrites that should not invalidate chat chunks. */
+        skipChunkRebuild?: boolean;
       }
     ): Promise<void>;
     deleteMessage(chatId: string, messageId: string): Promise<void>;