lumiverse-spindle-types 0.4.12 → 0.4.14

package/package.json

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

package/src/api.ts

@@ -933,6 +933,11 @@ export type WorkerToHost =
   | { type: "vars_delete_global"; requestId: string; key: string; userId?: string }
   | { type: "vars_list_global"; requestId: string; userId?: string }
   | { type: "vars_has_global"; requestId: string; key: string; userId?: string }
+  | { type: "vars_get_chat"; requestId: string; chatId: string; key: string }
+  | { type: "vars_set_chat"; requestId: string; chatId: string; key: string; value: string }
+  | { type: "vars_delete_chat"; requestId: string; chatId: string; key: string }
+  | { type: "vars_list_chat"; requestId: string; chatId: string }
+  | { type: "vars_has_chat"; requestId: string; chatId: string; key: string }
   // ─── Characters (gated: "characters") ──────────────────────────────
   | { type: "characters_list"; requestId: string; limit?: number; offset?: number; userId?: string }
   | { type: "characters_get"; requestId: string; characterId: string; userId?: string }
@@ -983,7 +988,7 @@ export type WorkerToHost =
   // ─── Text Editor (free tier) ───────────────────────────────────────
   | { type: "text_editor_open"; requestId: string; title?: string; value?: string; placeholder?: string; userId?: string }
   // ─── Modal (free tier) ────────────────────────────────────────────
-  | { type: "modal_open"; requestId: string; title: string; items: SpindleModalItemDTO[]; width?: number; maxHeight?: number; persistent?: boolean; userId?: string }
+  | { type: "modal_open"; requestId: string; modalRequestId?: string; title: string; items: SpindleModalItemDTO[]; width?: number; maxHeight?: number; persistent?: boolean; userId?: string }
   | { type: "modal_close"; requestId: string; openRequestId: string; userId?: string }
   | { type: "confirm_open"; requestId: string; title: string; message: string; variant?: "info" | "warning" | "danger" | "success"; confirmLabel?: string; cancelLabel?: string; userId?: string }
   | { type: "input_prompt_open"; requestId: string; title: string; message?: string; placeholder?: string; defaultValue?: string; submitLabel?: string; cancelLabel?: string; multiline?: boolean; userId?: string }

package/src/spindle-api.ts

@@ -307,8 +307,9 @@ export interface SpindleAPI {
   };
 
   /**
-   * Local (chat-scoped) and global variable access (free tier — no permission needed).
-   * Uses the same storage as built-in {{getvar}}/{{setgvar}} macros.
+   * Local (transient), global (user-scoped), and chat (persisted) variable access
+   * (free tier — no permission needed).
+   * Uses the same storage as built-in {{getvar}}/{{setgvar}}/{{getchatvar}} macros.
    */
   variables: {
     local: {
@@ -325,6 +326,15 @@ export interface SpindleAPI {
       list(userId?: string): Promise<Record<string, string>>;
       has(key: string, userId?: string): Promise<boolean>;
     };
+    /** Chat-scoped persisted variables — stored in chat.metadata.chat_variables.
+     *  Persists across generations within the same chat. */
+    chat: {
+      get(chatId: string, key: string): Promise<string>;
+      set(chatId: string, key: string, value: string): Promise<void>;
+      delete(chatId: string, key: string): Promise<void>;
+      list(chatId: string): Promise<Record<string, string>>;
+      has(chatId: string, key: string): Promise<boolean>;
+    };
   };
 
   /**
@@ -724,6 +734,13 @@ export interface SpindleAPI {
        * Default: `false`.
        */
       persistent?: boolean;
+      /**
+       * Caller-provided request ID for the modal. When supplied, the host uses
+       * this value (instead of the internal correlation requestId) as the modal
+       * identity key, enabling programmatic close via `spindle.modal.close()`
+       * before the modal resolves.
+       */
+      modalRequestId?: string;
       /** For operator-scoped extensions only. */
       userId?: string;
     }): Promise<{