lumiverse-spindle-types 0.6.10 → 0.6.12

package/package.json

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

package/src/api.ts

@@ -1522,7 +1522,7 @@ export type WorldBookEntryUpdateDTO = WorldBookEntryCreateDTO;
 export type RegexPlacementDTO = "user_input" | "ai_output" | "world_info" | "reasoning";
 export type RegexScopeDTO = "global" | "character" | "chat";
 export type RegexTargetDTO = "prompt" | "response" | "display";
-export type RegexMacroModeDTO = "none" | "raw" | "escaped" | "after";
+export type RegexMacroModeDTO = "none" | "find" | "raw" | "escaped" | "after";
 
 export interface RegexScriptDTO {
   id: string;
@@ -1607,6 +1607,7 @@ export interface WorldInfoInterceptorEntryDTO {
   readonly keysecondary: readonly string[];
   readonly position: number;
   readonly depth: number;
+  readonly role: string | null;
   readonly priority: number;
   readonly probability: number;
   readonly use_probability: boolean;
@@ -1614,6 +1615,9 @@ export interface WorldInfoInterceptorEntryDTO {
   readonly automation_id: string | null;
   readonly selective: boolean;
   readonly selective_logic: number;
+  readonly group_name: string;
+  readonly group_override: boolean;
+  readonly group_weight: number;
   readonly match_whole_words: boolean;
   readonly case_sensitive: boolean;
   readonly use_regex: boolean;
@@ -1624,6 +1628,11 @@ export interface WorldInfoInterceptorEntryDTO {
   readonly exclude_greeting: boolean;
   readonly scan_depth: number | null;
   readonly order_value: number;
+  readonly sticky: number;
+  readonly cooldown: number;
+  readonly delay: number;
+  /** Latest prompt-local chat placement supplied by an earlier handler. */
+  readonly placement?: WorldInfoInterceptorPlacementDTO;
   /** Attachment scope that contributed the entry's book to this chat. */
   readonly book_source?: WorldBookSourceDTO;
 }
@@ -1660,6 +1669,24 @@ export interface WorldInfoActivationOverridesDTO {
   readonly disableRecursion?: true;
 }
 
+export type WorldInfoInterceptorRoleDTO = "system" | "user" | "assistant";
+
+/**
+ * Prompt-local placement relative to the selected chat history, including its
+ * greeting when present.
+ *
+ * Selected placements use the host's world-info insertion order. Each inserted
+ * entry becomes part of the history sequence used to place the next entry. The
+ * host does not persist these values to the world book.
+ */
+export interface WorldInfoInterceptorPlacementDTO {
+  readonly type: "chat_depth";
+  readonly role: WorldInfoInterceptorRoleDTO;
+  /** Non-negative integer passed to the selected direction's depth rule. */
+  readonly depth: number;
+  readonly direction: "from_start" | "from_end";
+}
+
 /**
  * Context passed to a `registerWorldInfoInterceptor` handler. Fires inside
  * `assemblePrompt` immediately before `activateWorldInfo` runs, so any
@@ -1691,6 +1718,11 @@ export interface WorldInfoInterceptorMutationDTO {
    * `content` (or the stored entry content when `content` is omitted).
    */
   readonly selectionContent?: string;
+  /**
+   * Overrides this entry's chat-history placement for the current prompt.
+   * Omit it to retain the stored native position, depth, and role.
+   */
+  readonly placement?: WorldInfoInterceptorPlacementDTO;
 }
 
 /**

package/src/dom.ts

@@ -858,6 +858,13 @@ export interface SpindleDisplayResolverRegistry {
   registerResolver(resolver: SpindleDisplayResolver): () => void;
   /** Ask the host to invalidate cached display resolutions whose dependencies (a `<scope>:<name>` set) changed. */
   invalidate(touchedVars: string[]): void;
+  /** Update the active chat's transient expression display without a backend round trip. */
+  setExpression(expression: {
+    chatId: string;
+    characterId: string;
+    label: string;
+    imageId: string;
+  }): void;
 }
 
 /** Context object provided to frontend extension modules */

package/src/index.ts

@@ -115,6 +115,8 @@ export type {
   WorldInfoInterceptorMessageDTO,
   WorldInfoActivationSettingsDTO,
   WorldInfoActivationOverridesDTO,
+  WorldInfoInterceptorRoleDTO,
+  WorldInfoInterceptorPlacementDTO,
   WorldInfoInterceptorCtxDTO,
   WorldInfoInterceptorMutationDTO,
   WorldInfoInterceptorResultDTO,

package/src/spindle-api.ts

@@ -1358,6 +1358,8 @@ export interface SpindleAPI {
    * `preAssemblyGenerationContext >= 1`: generation contexts carry
    * `dryRun`/`userId` and `cancelGeneration` is honored.
    * `worldInfoActivationCapture >= 1`: world info activation capture is supported.
+   * `worldInfoRuntimePlacement >= 1`: world info mutations accept prompt-local
+   * chat-depth placement.
    */
   contracts?: Readonly<Record<string, number>>;
 

package/test/interceptor-consumer.ts

@@ -130,7 +130,22 @@ declare const spindle: SpindleAPI;
 spindle.registerWorldInfoInterceptor(async (worldInfoContext) => {
   const globalScanDepth: number | null =
     worldInfoContext.activationSettings.globalScanDepth;
+  const role: string | null | undefined = worldInfoContext.entries[0]?.role;
+  const priorPlacement = worldInfoContext.entries[0]?.placement;
   void globalScanDepth;
+  void role;
+  void priorPlacement;
+  return {
+    mutated: [{
+      id: "entry-id",
+      placement: {
+        type: "chat_depth",
+        role: "system",
+        depth: 2,
+        direction: "from_start",
+      },
+    }],
+  };
 });
 spindle.registerMessageContentProcessor(async (messageContext) => {
   const isUser: boolean = messageContext.isUser;