lumiverse-spindle-types 0.4.13 → 0.4.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.4.13",
+  "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 }

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>;
+    };
   };
 
   /**