lumiverse-spindle-types 0.3.9 → 0.4.1

package/package.json

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

package/src/api.ts

@@ -617,10 +617,54 @@ export interface ThemeInfoDTO {
   radiusScale: number;
   /** Font size multiplier (1.0 = default) */
   fontScale: number;
+  /** Full UI zoom multiplier (1.0 = default, affects all elements via CSS zoom) */
+  uiScale: number;
   /** Whether the theme dynamically adapts to the active character's avatar */
   characterAware: boolean;
 }
 
+/**
+ * Input config for `spindle.theme.generateVariables()`.
+ *
+ * Mirrors the inputs that Lumiverse's theme engine uses to produce the full
+ * set of ~80+ CSS variables. Extensions can use the result as a complete,
+ * coherent override set for `spindle.theme.apply()`.
+ */
+export interface ThemeVariablesConfigDTO {
+  /** Primary accent color in HSL. */
+  accent: { h: number; s: number; l: number };
+  /** Resolved color mode. */
+  mode: "dark" | "light";
+  /** Enable glassmorphic backdrop-filter tokens (default: `true`). */
+  enableGlass?: boolean;
+  /** Border radius multiplier (default: `1`). */
+  radiusScale?: number;
+  /** Font size multiplier (default: `1`). */
+  fontScale?: number;
+  /** Full UI zoom multiplier (default: `1`). */
+  uiScale?: number;
+  /** Optional base color overrides. Each value is a CSS color string. */
+  baseColors?: {
+    primary?: string;
+    secondary?: string;
+    background?: string;
+    text?: string;
+    danger?: string;
+    success?: string;
+    warning?: string;
+    /** Dialogue / speech color override. */
+    speech?: string;
+    /** Italic / thoughts color override. */
+    thoughts?: string;
+  };
+  /** Status color overrides (danger, success, warning). */
+  statusColors?: {
+    danger?: string;
+    success?: string;
+    warning?: string;
+  };
+}
+
 // ─── Modal content items (used by backend-initiated modals) ─────────────
 
 /**
@@ -931,6 +975,8 @@ export type WorkerToHost =
   | { type: "theme_get_current"; requestId: string; userId?: string }
   // ─── Color Extraction (gated: "app_manipulation") ─────────────────────
   | { type: "color_extract"; requestId: string; imageId: string; userId?: string }
+  // ─── Theme Variable Generation (gated: "app_manipulation") ────────────
+  | { type: "theme_generate_variables"; requestId: string; config: ThemeVariablesConfigDTO }
   // ─── Commands (free tier) ──────────────────────────────────────────────
   | { type: "commands_register"; commands: SpindleCommandDTO[] }
   | { type: "commands_unregister"; commandIds: string[] };

package/src/council.ts

@@ -59,6 +59,10 @@ export interface CouncilToolsSettings {
   allowUserControl: boolean;
   /** Word limit per tool response (0 = unlimited). */
   maxWordsPerTool: number;
+  /** When true, council tools are NOT re-executed on regenerations and swipes.
+   *  Instead, the last successful council results (cached in chat metadata) are
+   *  reused. Tools still fire for fresh sends, continues, impersonations, etc. */
+  retainResultsForRegens?: boolean;
   /**
    * @deprecated Sidecar config is now stored as a top-level `sidecarSettings`
    * user setting. This field is read as a fallback for backwards compatibility.
@@ -94,6 +98,18 @@ export interface CouncilExecutionResult {
   totalDurationMs: number;
 }
 
+/** Cached council results persisted in `chat.metadata.last_council_results`.
+ *  Used when `retainResultsForRegens` is enabled to skip re-execution on
+ *  regenerations and swipes. */
+export interface CachedCouncilResult {
+  results: CouncilToolResult[];
+  deliberationBlock: string;
+  /** Named result variables extracted from tool definitions with `resultVariable`. */
+  namedResults: Record<string, string>;
+  /** Unix epoch ms when this cache was written. */
+  cachedAt: number;
+}
+
 // ---- Tool Definition ----
 
 export type CouncilToolCategory =
@@ -146,6 +162,7 @@ export const COUNCIL_TOOLS_DEFAULTS: CouncilToolsSettings = {
   includeWorldInfo: true,
   allowUserControl: false,
   maxWordsPerTool: 250,
+  retainResultsForRegens: false,
 };
 
 export const COUNCIL_SETTINGS_DEFAULTS: CouncilSettings = {

package/src/index.ts

@@ -53,6 +53,7 @@ export type {
   ImageGenResultDTO,
   ThemeOverrideDTO,
   ThemeInfoDTO,
+  ThemeVariablesConfigDTO,
   ColorExtractionResult,
   ColorRGB,
   ColorHSL,
@@ -108,6 +109,7 @@ export type {
   CouncilSettings,
   CouncilToolResult,
   CouncilExecutionResult,
+  CachedCouncilResult,
   CouncilToolCategory,
   CouncilToolDefinition,
 } from "./council";

package/src/spindle-api.ts

@@ -32,6 +32,7 @@ import type {
   ImageGenProviderDTO,
   ThemeOverrideDTO,
   ThemeInfoDTO,
+  ThemeVariablesConfigDTO,
   ColorExtractionResult,
   SpindleModalItemDTO,
   SpindleCommandDTO,
@@ -635,6 +636,27 @@ export interface SpindleAPI {
      * @param imageId - ID of an image in the images table
      */
     extractColors(imageId: string, userId?: string): Promise<ColorExtractionResult>;
+    /**
+     * Generate the full set of Lumiverse CSS variables from a theme config.
+     *
+     * Returns a `Record<string, string>` containing every CSS variable the
+     * theme engine would produce — primary accent variants, backgrounds,
+     * borders, text, glass tokens, shadows, radii, prose tokens, and more
+     * (~80+ variables). The result can be passed directly to `apply()` for a
+     * complete, coherent theme override.
+     *
+     * @example
+     * ```ts
+     * // Extract palette from an image, then generate + apply a full theme
+     * const palette = await spindle.theme.extractColors(imageId)
+     * const vars = await spindle.theme.generateVariables({
+     *   accent: palette.dominantHsl,
+     *   mode: 'dark',
+     * })
+     * await spindle.theme.apply({ variables: vars })
+     * ```
+     */
+    generateVariables(config: ThemeVariablesConfigDTO): Promise<Record<string, string>>;
   };
 
   /**