lumiverse-spindle-types 0.5.31 → 0.6.1

package/package.json

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

package/src/api.ts

@@ -1086,6 +1086,8 @@ export interface PromptBlockDTO {
   isLocked: boolean;
   color: string | null;
   injectionTrigger: string[];
+  /** Optional character-tag filter. The block is included when the focused character matches. */
+  characterTagTrigger?: string[];
   group: string | null;
   /** Only meaningful when `marker === "category"`. Radio categories allow one enabled child; checkbox categories allow many. */
   categoryMode?: PromptBlockCategoryModeDTO;
@@ -1479,6 +1481,70 @@ export interface LumiaItemDTO {
   updated_at: number;
 }
 
+/** A Loom item category included in a Lumia DLC pack. */
+export type LoomItemCategoryDTO = "narrative_style" | "loom_utility" | "retrofit";
+
+/** A narrative style, utility, or retrofit included in a Lumia DLC pack. */
+export interface LoomItemDTO {
+  id: string;
+  pack_id: string;
+  name: string;
+  content: string;
+  category: LoomItemCategoryDTO;
+  author_name: string;
+  version: string;
+  sort_order: number;
+  created_at: number;
+  updated_at: number;
+}
+
+/** A tool included in a Lumia DLC pack. */
+export interface LoomToolDTO {
+  id: string;
+  pack_id: string;
+  tool_name: string;
+  display_name: string;
+  description: string;
+  prompt: string;
+  input_schema: Record<string, unknown>;
+  result_variable: string;
+  store_in_deliberation: boolean;
+  author_name: string;
+  version: string;
+  sort_order: number;
+  created_at: number;
+  updated_at: number;
+}
+
+/**
+ * Extension-safe metadata for a pack in the user's Lumia DLC catalog.
+ * Ownership and the arbitrary pack `extras` blob are intentionally omitted.
+ */
+export interface LumiaDlcPackDTO {
+  id: string;
+  name: string;
+  author: string;
+  cover_url: string | null;
+  version: string;
+  is_custom: boolean;
+  source_url: string | null;
+  created_at: number;
+  updated_at: number;
+}
+
+/**
+ * All Lumia DLC content currently available to one user. Item `pack_id`
+ * values refer to an entry in `packs`.
+ */
+export interface LumiaDlcCatalogDTO {
+  packs: LumiaDlcPackDTO[];
+  lumiaItems: LumiaItemDTO[];
+  narrativeStyles: LoomItemDTO[];
+  utilities: LoomItemDTO[];
+  retrofits: LoomItemDTO[];
+  tools: LoomToolDTO[];
+}
+
 export interface PersonaDTO {
   id: string;
   name: string;
@@ -1650,6 +1716,32 @@ export interface DryRunResultDTO {
   memoryStats?: MemoryStatsDTO;
 }
 
+// ─── Assembly-only DTOs ────────────────────────────────────────────────
+
+/**
+ * Assemble an extension-supplied Loom block graph against a real chat context
+ * without invoking the pre-generation context/interceptor pipeline or an LLM.
+ */
+export interface AssembleRequestDTO {
+  /** Native Loom prompt blocks to assemble. These replace the saved preset's block graph. */
+  blocks: PromptBlockDTO[];
+  /** Chat supplying history, character, world-info, and macro context. */
+  chatId: string;
+  connectionId?: string;
+  personaId?: string;
+  /** Defaults to `"normal"`. */
+  generationType?: string;
+  /** Per-block prompt-variable values, keyed by block id then variable name. */
+  promptVariables?: PromptVariableValuesDTO;
+  /** Cancel an in-flight assembly. Consumed in the extension worker and not cloned over RPC. */
+  signal?: AbortSignal;
+}
+
+export interface AssembleResultDTO {
+  messages: LlmMessageDTO[];
+  breakdown: AssemblyBreakdownEntryDTO[];
+}
+
 // ─── Chat Memory DTOs ──────────────────────────────────────────────────
 
 export interface ChatMemoryChunkDTO {
@@ -2546,6 +2638,12 @@ export type WorkerToHost =
       parameters?: Record<string, unknown>;
       breakdown?: InterceptorBreakdownEntryDTO[];
     }
+  | {
+      type: "assemble_prompt";
+      requestId: string;
+      input: Omit<AssembleRequestDTO, "signal">;
+      userId?: string;
+    }
   | { type: "register_tool"; tool: ToolRegistrationDTO }
   | { type: "unregister_tool"; name: string }
   | { type: "request_generation"; requestId: string; input: GenerationRequestDTO }
@@ -2875,6 +2973,8 @@ export type WorkerToHost =
   | { 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 }
+  // ─── Lumia DLC (free tier, read-only) ──────────────────────────────
+  | { type: "dlc_get_catalog"; requestId: string; userId?: string }
   // ─── Activated World Info (gated: "world_books") ───────────────────
   | { type: "world_books_get_activated"; requestId: string; chatId: string; userId?: string }
   // ─── Global World Books (gated: "world_books") ───────────────────────

package/src/dom.ts

@@ -1,4 +1,4 @@
-import type { RequestInitDTO } from "./api";
+import type { PromptBlockDTO, RequestInitDTO } from "./api";
 import type { SpindleComponentsHelper } from "./components";
 
 /** A chat-message DOM element paired with its stable message id. */
@@ -202,6 +202,65 @@ export interface SpindleCharacterEditorHelper {
   flush(): Promise<void>;
 }
 
+// ── Preset Editor Tab ──
+
+export interface SpindlePresetEditorTabOptions {
+  /** Unique tab identifier within the current extension. */
+  id: string;
+  /** Label shown in the Loom preset editor tab bar. */
+  title: string;
+}
+
+export interface SpindlePresetEditorTabHandle {
+  root: HTMLElement;
+  tabId: string;
+  setTitle(title: string): void;
+  activate(): void;
+  destroy(): void;
+  /** Register a callback fired when the active preset-editor tab switches to this tab. */
+  onActivate(handler: () => void): () => void;
+}
+
+/** Mutable, editor-native snapshot of the current Loom preset draft. */
+export interface SpindlePresetEditorDraft {
+  id: string;
+  name: string;
+  blocks: PromptBlockDTO[];
+  parameters: Record<string, unknown>;
+  prompts: Record<string, unknown>;
+  metadata: Record<string, unknown>;
+  createdAt: number;
+  updatedAt: number;
+}
+
+export interface SpindlePresetEditorState {
+  /** Whether a Loom preset editor instance is currently mounted. */
+  open: boolean;
+  /** Preset currently being edited, or `null` when none is selected. */
+  presetId: string | null;
+  /** Active built-in or extension tab id inside the preset editor. */
+  activeTabId: string | null;
+  /** Current draft. Callers receive a structured clone. */
+  preset: SpindlePresetEditorDraft | null;
+}
+
+export interface SpindlePresetEditorSaveOptions {
+  /** Persist immediately instead of using the host's debounced save path. */
+  immediate?: boolean;
+}
+
+export interface SpindlePresetEditorHelper {
+  getState(): SpindlePresetEditorState;
+  onChange(handler: (state: SpindlePresetEditorState) => void): () => void;
+  /** Atomically derive the next editor draft from the latest pending draft. */
+  updatePreset(
+    mutator: (preset: SpindlePresetEditorDraft) => SpindlePresetEditorDraft,
+    options?: SpindlePresetEditorSaveOptions,
+  ): void;
+  /** Immediately persist and await any pending draft changes. */
+  flush(): Promise<void>;
+}
+
 // ── Float Widget ──
 
 export interface SpindleFloatWidgetOptions {
@@ -764,6 +823,8 @@ export interface SpindleFrontendContext {
     registerDrawerTab(options: SpindleDrawerTabOptions): SpindleDrawerTabHandle;
     registerCharacterEditorTab(options: SpindleCharacterEditorTabOptions): SpindleCharacterEditorTabHandle;
     characterEditor: SpindleCharacterEditorHelper;
+    registerPresetEditorTab(options: SpindlePresetEditorTabOptions): SpindlePresetEditorTabHandle;
+    presetEditor: SpindlePresetEditorHelper;
     createFloatWidget(options?: SpindleFloatWidgetOptions): SpindleFloatWidgetHandle;
     requestDockPanel(options: SpindleDockPanelOptions): SpindleDockPanelHandle;
     mountApp(options?: SpindleAppMountOptions): SpindleAppMountHandle;

package/src/index.ts

@@ -97,6 +97,11 @@ export type {
   GlobalAddonDTO,
   GlobalAddonUpdateDTO,
   LumiaItemDTO,
+  LoomItemCategoryDTO,
+  LoomItemDTO,
+  LoomToolDTO,
+  LumiaDlcPackDTO,
+  LumiaDlcCatalogDTO,
   PersonaCreateDTO,
   PersonaUpdateDTO,
   ActivatedWorldInfoEntryDTO,
@@ -104,6 +109,8 @@ export type {
   WorldInfoActivatedEventDTO,
   DryRunRequestDTO,
   DryRunResultDTO,
+  AssembleRequestDTO,
+  AssembleResultDTO,
   AssemblyBreakdownEntryDTO,
   ActivationStatsDTO,
   MemoryStatsDTO,
@@ -215,6 +222,12 @@ export type {
   SpindleCharacterEditorState,
   SpindleCharacterEditorSaveOptions,
   SpindleCharacterEditorHelper,
+  SpindlePresetEditorTabOptions,
+  SpindlePresetEditorTabHandle,
+  SpindlePresetEditorDraft,
+  SpindlePresetEditorState,
+  SpindlePresetEditorSaveOptions,
+  SpindlePresetEditorHelper,
   SpindleFloatWidgetOptions,
   SpindleFloatWidgetHandle,
   SpindleDockEdge,

package/src/spindle-api.ts

@@ -50,11 +50,14 @@ import type {
   GlobalAddonDTO,
   GlobalAddonUpdateDTO,
   LumiaItemDTO,
+  LumiaDlcCatalogDTO,
   PersonaCreateDTO,
   PersonaUpdateDTO,
   ActivatedWorldInfoEntryDTO,
   DryRunRequestDTO,
   DryRunResultDTO,
+  AssembleRequestDTO,
+  AssembleResultDTO,
   ChatMemoryResultDTO,
   ImageGenRequestDTO,
   ImageGenResultDTO,
@@ -318,6 +321,13 @@ export interface SpindleAPI {
     priority?: number
   ): void;
 
+  /**
+   * Assemble an arbitrary Loom block graph against a chat without calling an
+   * LLM or re-entering the pre-generation context/interceptor pipeline.
+   * Requires the `generation` permission.
+   */
+  assemble(input: AssembleRequestDTO, userId?: string): Promise<AssembleResultDTO>;
+
   /**
    * Declare the chats whose `target:prompt` regex this extension applies itself; the 
    * host skips its own pass for them.
@@ -1187,6 +1197,15 @@ export interface SpindleAPI {
     getAvailableLumiaItems(options?: { userId?: string }): Promise<LumiaItemDTO[]>;
   };
 
+  /**
+   * Read-only Lumia DLC catalog (no permission declaration required).
+   * Includes pack metadata, Lumias, narrative styles, Loom utilities,
+   * retrofits, and Loom tools available to the effective user.
+   */
+  dlc: {
+    getCatalog(options?: { userId?: string }): Promise<LumiaDlcCatalogDTO>;
+  };
+
   personas: {
     list(options?: { limit?: number; offset?: number; userId?: string }): Promise<{ data: PersonaDTO[]; total: number }>;
     get(personaId: string, userId?: string): Promise<PersonaDTO | null>;