lumiverse-spindle-types 0.5.30 → 0.6.0

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-
-  "version": "0.5.30",
+  "version": "0.6.0",
   "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;
@@ -1650,6 +1652,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 +2574,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 }

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

@@ -104,6 +104,8 @@ export type {
   WorldInfoActivatedEventDTO,
   DryRunRequestDTO,
   DryRunResultDTO,
+  AssembleRequestDTO,
+  AssembleResultDTO,
   AssemblyBreakdownEntryDTO,
   ActivationStatsDTO,
   MemoryStatsDTO,
@@ -215,6 +217,12 @@ export type {
   SpindleCharacterEditorState,
   SpindleCharacterEditorSaveOptions,
   SpindleCharacterEditorHelper,
+  SpindlePresetEditorTabOptions,
+  SpindlePresetEditorTabHandle,
+  SpindlePresetEditorDraft,
+  SpindlePresetEditorState,
+  SpindlePresetEditorSaveOptions,
+  SpindlePresetEditorHelper,
   SpindleFloatWidgetOptions,
   SpindleFloatWidgetHandle,
   SpindleDockEdge,

package/src/spindle-api.ts

@@ -55,6 +55,8 @@ import type {
   ActivatedWorldInfoEntryDTO,
   DryRunRequestDTO,
   DryRunResultDTO,
+  AssembleRequestDTO,
+  AssembleResultDTO,
   ChatMemoryResultDTO,
   ImageGenRequestDTO,
   ImageGenResultDTO,
@@ -318,6 +320,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.
@@ -790,6 +799,11 @@ export interface SpindleAPI {
     uploadFromDataUrl(dataUrl: string, originalFilename?: string, userId?: string): Promise<ImageDTO>;
     uploadFromDataUrl(dataUrl: string, options?: ImageUploadFromDataUrlOptionsDTO): Promise<ImageDTO>;
     delete(imageId: string, userId?: string): Promise<boolean>;
+    /**
+     * Bulk delete: chunked DB deletes with file unlinks deferred to a background
+     * task, no per-image IMAGE_DELETED events. Returns the number of rows deleted.
+     */
+    deleteMany(imageIds: string[], options?: { userId?: string }): Promise<number>;
   };
 
   /**