lumiverse-spindle-types 0.4.38 → 0.4.40

package/package.json

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

package/src/api.ts

@@ -373,8 +373,8 @@ export interface ImageGenResultDTO {
 
 /**
  * Safe representation of a character exposed to extensions.
- * Omits the raw `extensions` blob — only exposes user-facing fields plus
- * a small allowlist of structured extension state (e.g. `world_book_ids`).
+ * Includes the full `extensions` blob so extensions can read and write
+ * their own namespaced keys alongside the allowlisted `world_book_ids`.
  */
 export interface CharacterDTO {
   id: string;
@@ -396,6 +396,8 @@ export interface CharacterDTO {
    * single-id form is auto-migrated, so consumers can rely on the array.
    */
   world_book_ids: string[];
+  /** The raw extensions object. Extensions should namespace their keys. */
+  extensions: Record<string, any>;
   created_at: number;
   updated_at: number;
 }
@@ -415,6 +417,8 @@ export interface CharacterCreateDTO {
   creator?: string;
   /** Optional initial world book attachments. */
   world_book_ids?: string[];
+  /** Optional initial extension data. */
+  extensions?: Record<string, any>;
 }
 
 export interface CharacterUpdateDTO {
@@ -435,6 +439,12 @@ export interface CharacterUpdateDTO {
    * detach all books. Omit the field to leave attachments unchanged.
    */
   world_book_ids?: string[];
+  /**
+   * Shallow-merged into the character's existing extensions.
+   * Extension-provided keys overwrite existing ones; omitting a key leaves it
+   * untouched. Pass an empty object to make no changes, or omit entirely.
+   */
+  extensions?: Record<string, any>;
 }
 
 export interface CharacterAvatarUploadDTO {
@@ -575,6 +585,22 @@ export type WorldBookEntryUpdateDTO = WorldBookEntryCreateDTO;
  * Safe representation of a persona exposed to extensions.
  * Omits avatar_path (internal filesystem path) — use image_id for avatar access.
  */
+export interface LumiaItemDTO {
+  id: string;
+  pack_id: string;
+  name: string;
+  avatar_url: string | null;
+  author_name: string;
+  definition: string;
+  personality: string;
+  behavior: string;
+  gender_identity: 0 | 1 | 2 | 3; // 0=feminine, 1=masculine, 2=neutral, 3=any
+  version: string;
+  sort_order: number;
+  created_at: number;
+  updated_at: number;
+}
+
 export interface PersonaDTO {
   id: string;
   name: string;
@@ -1512,6 +1538,10 @@ export type WorkerToHost =
   | { type: "personas_delete"; requestId: string; personaId: string; userId?: string }
   | { type: "personas_switch"; requestId: string; personaId: string | null; userId?: string }
   | { type: "personas_get_world_book"; requestId: string; personaId: string; userId?: string }
+  // ─── Council (free tier, read-only) ──────────────────────────────
+  | { type: "council_get_settings"; requestId: string; userId?: string }
+  | { type: "council_get_members"; requestId: string; userId?: string }
+  | { type: "council_get_available_lumia_items"; requestId: string; userId?: string }
   // ─── Activated World Info (gated: "world_books") ───────────────────
   | { type: "world_books_get_activated"; requestId: string; chatId: string; userId?: string }
   // ─── Dry Run (gated: "generation") ────────────────────────────────

package/src/index.ts

@@ -42,6 +42,7 @@ export type {
   WorldBookEntryCreateDTO,
   WorldBookEntryUpdateDTO,
   PersonaDTO,
+  LumiaItemDTO,
   PersonaCreateDTO,
   PersonaUpdateDTO,
   ActivatedWorldInfoEntryDTO,

package/src/spindle-api.ts

@@ -1,4 +1,8 @@
 import type { SpindleManifest } from "./manifest";
+import type {
+  CouncilMemberContext,
+  CouncilSettings,
+} from "./council";
 import type {
   LlmMessageDTO,
   InterceptorResultDTO,
@@ -24,6 +28,7 @@ import type {
   WorldBookEntryCreateDTO,
   WorldBookEntryUpdateDTO,
   PersonaDTO,
+  LumiaItemDTO,
   PersonaCreateDTO,
   PersonaUpdateDTO,
   ActivatedWorldInfoEntryDTO,
@@ -631,6 +636,15 @@ export interface SpindleAPI {
    * For user-scoped extensions, userId is inferred from the extension owner.
    * For operator-scoped extensions, pass userId to scope to a specific user.
    */
+  council: {
+    /** Get the user's active council configuration (settings and members) */
+    getSettings(options?: { userId?: string }): Promise<CouncilSettings>;
+    /** Retrieve the current list of council members set up by the user with their full definitions */
+    getMembers(options?: { userId?: string }): Promise<CouncilMemberContext[]>;
+    /** Retrieve all Lumia items generally available to the user (e.g. from packs) */
+    getAvailableLumiaItems(options?: { userId?: string }): Promise<LumiaItemDTO[]>;
+  };
+
   personas: {
     list(options?: { limit?: number; offset?: number; userId?: string }): Promise<{ data: PersonaDTO[]; total: number }>;
     get(personaId: string, userId?: string): Promise<PersonaDTO | null>;