lumiverse-spindle-types 0.4.39 → 0.4.41

package/package.json

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

package/src/api.ts

@@ -585,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;
@@ -1522,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/dom.ts

@@ -77,6 +77,9 @@ export interface SpindleFloatWidgetOptions {
   /** Strip default container chrome (border, background, shadow, border-radius).
    *  The extension fully owns the visual presentation. */
   chromeless?: boolean;
+  /** When true, the widget is created in fullscreen mode anchored to the
+   *  viewport origin (0,0) and sized to fill the entire viewport. */
+  fullscreen?: boolean;
 }
 
 export interface SpindleFloatWidgetHandle {
@@ -86,6 +89,12 @@ export interface SpindleFloatWidgetHandle {
   getPosition(): { x: number; y: number };
   setVisible(visible: boolean): void;
   isVisible(): boolean;
+  /** Toggle fullscreen mode. When enabled the host resizes the widget to
+   *  fill the viewport and anchors it at (0,0). Disabling restores the
+   *  previous size and position. */
+  setFullscreen(fullscreen: boolean): void;
+  /** Returns true when the widget is currently in fullscreen mode. */
+  isFullscreen(): boolean;
   destroy(): void;
   onDragEnd(handler: (pos: { x: number; y: number }) => void): () => void;
 }

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>;