lumiverse-spindle-types 0.6.0 → 0.6.2

package/package.json

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

package/src/api.ts

@@ -1481,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;
@@ -2760,7 +2824,7 @@ export type WorkerToHost =
       keys: string[];
     }
   | { type: "cors_request"; requestId: string; url: string; options: RequestInitDTO }
-  | { type: "register_context_handler"; priority?: number }
+  | { type: "register_context_handler"; priority?: number; timeoutMs?: number }
   | {
       type: "context_handler_result";
       requestId: string;
@@ -2909,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/index.ts

@@ -97,6 +97,11 @@ export type {
   GlobalAddonDTO,
   GlobalAddonUpdateDTO,
   LumiaItemDTO,
+  LoomItemCategoryDTO,
+  LoomItemDTO,
+  LoomToolDTO,
+  LumiaDlcPackDTO,
+  LumiaDlcCatalogDTO,
   PersonaCreateDTO,
   PersonaUpdateDTO,
   ActivatedWorldInfoEntryDTO,

package/src/spindle-api.ts

@@ -50,6 +50,7 @@ import type {
   GlobalAddonDTO,
   GlobalAddonUpdateDTO,
   LumiaItemDTO,
+  LumiaDlcCatalogDTO,
   PersonaCreateDTO,
   PersonaUpdateDTO,
   ActivatedWorldInfoEntryDTO,
@@ -1196,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>;
@@ -1277,12 +1287,26 @@ export interface SpindleAPI {
   /** Make a CORS-proxied HTTP request */
   cors(url: string, options?: RequestInitDTO): Promise<unknown>;
 
-  /** Register a context handler for enriching generation context */
+  /**
+   * Register a context handler for enriching generation context, awaited
+   * before prompt assembly. The context carries `chatId`, `generationType`,
+   * `dryRun` (tokenize/preview assemblies) and `userId`, returning it with
+   * `cancelGeneration: true` stops the generation, and `opts.timeoutMs`
+   * overrides the default 10s wall-clock budget (clamped to 1s-120s).
+   */
   registerContextHandler(
     handler: (context: unknown) => Promise<unknown>,
-    priority?: number
+    priority?: number,
+    opts?: { timeoutMs?: number }
   ): void;
 
+  /**
+   * Host contract versions for feature detection, keyed by contract name.
+   * `preAssemblyGenerationContext >= 1`: generation contexts carry
+   * `dryRun`/`userId` and `cancelGeneration` is honored.
+   */
+  contracts?: Readonly<Record<string, number>>;
+
   /**
    * Register a macro interceptor (permission: `macro_interceptor`).
    *