lumiverse-spindle-types 0.4.17 → 0.4.18

package/package.json

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

package/src/api.ts

@@ -169,7 +169,8 @@ export interface ImageGenResultDTO {
 
 /**
  * Safe representation of a character exposed to extensions.
- * Omits raw extensions blob — only exposes user-facing fields.
+ * Omits the raw `extensions` blob — only exposes user-facing fields plus
+ * a small allowlist of structured extension state (e.g. `world_book_ids`).
  */
 export interface CharacterDTO {
   id: string;
@@ -186,6 +187,11 @@ export interface CharacterDTO {
   alternate_greetings: string[];
   creator: string;
   image_id: string | null;
+  /**
+   * IDs of world books attached directly to this character. The legacy
+   * single-id form is auto-migrated, so consumers can rely on the array.
+   */
+  world_book_ids: string[];
   created_at: number;
   updated_at: number;
 }
@@ -203,6 +209,8 @@ export interface CharacterCreateDTO {
   tags?: string[];
   alternate_greetings?: string[];
   creator?: string;
+  /** Optional initial world book attachments. */
+  world_book_ids?: string[];
 }
 
 export interface CharacterUpdateDTO {
@@ -218,6 +226,11 @@ export interface CharacterUpdateDTO {
   tags?: string[];
   alternate_greetings?: string[];
   creator?: string;
+  /**
+   * Replace the character's world book attachments. Pass an empty array to
+   * detach all books. Omit the field to leave attachments unchanged.
+   */
+  world_book_ids?: string[];
 }
 
 // ─── Chat DTOs ──────────────────────────────────────────────────────────
@@ -991,6 +1004,26 @@ export type WorkerToHost =
       chatId: string;
       messageId: string;
     }
+  | {
+      type: "chat_set_message_hidden";
+      requestId: string;
+      chatId: string;
+      messageId: string;
+      hidden: boolean;
+    }
+  | {
+      type: "chat_set_messages_hidden";
+      requestId: string;
+      chatId: string;
+      messageIds: string[];
+      hidden: boolean;
+    }
+  | {
+      type: "chat_is_message_hidden";
+      requestId: string;
+      chatId: string;
+      messageId: string;
+    }
   | {
       type: "events_track";
       requestId: string;

package/src/spindle-api.ts

@@ -252,6 +252,27 @@ export interface SpindleAPI {
       }
     ): Promise<void>;
     deleteMessage(chatId: string, messageId: string): Promise<void>;
+    /**
+     * Mark a single message as hidden or visible. Hidden messages are
+     * excluded from chat memory embeddings (vector retrieval) but, in the
+     * current build, are still included in chat history during prompt
+     * assembly. See `chat-mutation.md` for the full semantics.
+     *
+     * Requires the `chat_mutation` permission.
+     */
+    setMessageHidden(chatId: string, messageId: string, hidden: boolean): Promise<void>;
+    /**
+     * Bulk variant of {@link setMessageHidden}. Capped at 500 message IDs
+     * per call (matching the underlying service limit).
+     *
+     * Requires the `chat_mutation` permission.
+     */
+    setMessagesHidden(chatId: string, messageIds: string[], hidden: boolean): Promise<void>;
+    /**
+     * Read the hidden flag for a single message. Returns `false` for messages
+     * that have never had the flag set. Requires the `chat_mutation` permission.
+     */
+    isMessageHidden(chatId: string, messageId: string): Promise<boolean>;
   };
 
   /** Extension-level telemetry */