lumiverse-spindle-types 0.5.19 → 0.5.21

package/package.json

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

package/src/api.ts

@@ -36,6 +36,24 @@ export interface LlmMessageDTO {
    * only on `role: 'assistant'` messages.
    */
   reasoning_content?: string;
+  /**
+   * True when this message is a chat-history turn (as opposed to a depth-injected 
+   * world-info/preset/author's-note block that was spliced into the chat-history 
+   * range). Set by the host only on the messages passed to the interceptor pipeline, 
+   * so an extension applying prompt-target regex inline can reproduce the host's depth
+   * frame exactly.
+   */
+  __isChatHistory?: boolean;
+  /**
+   * Id of the originating chat message, set only on chat-history turns. Lets 
+   * interceptors map back to the source message without matching on 
+   * (macro/regex-mutated) content. Stripped before the LLM payload. 
+   */
+  sourceMessageId?: string;
+  /**
+   * Source message's `index_in_chat`, paired with `sourceMessageId`. 
+   */
+  sourceIndexInChat?: number;
 }
 
 export type SpindleUserRoleDTO = "operator" | "admin" | "user";

package/src/index.ts

@@ -334,6 +334,7 @@ export type {
 
 export type {
   SpindleAPI,
+  SpindlePromptRegex,
   FrontendProcessHandle,
   BackendProcessHandle,
   SpindleBackendProcessContext,

package/src/spindle-api.ts

@@ -209,6 +209,19 @@ export type SpindleBackendProcessModule = {
   run?: (process: SpindleBackendProcessContext) => void | (() => void) | Promise<void | (() => void)>;
 };
 
+/**
+ * Lets an extension tell the host that it will apply `target:prompt` regex
+ * itself for a set of chats, so the host skips its own per-message prompt-regex
+ * pass for those chats.
+ */
+export interface SpindlePromptRegex {
+  /**
+   * Declare the chats this extension applies `target:prompt` regex for. Replaces
+   * the previously-declared set. Empty array clears ownership (host resumes its pass).
+   */
+  setOwnedChats(chatIds: string[]): void;
+}
+
 /** The global `spindle` object available in backend extension workers */
 export interface SpindleAPI {
   /** Subscribe to generation-started events (requires `generation` permission). The optional `userId` identifies which user triggered the event. */
@@ -289,6 +302,12 @@ export interface SpindleAPI {
     priority?: number
   ): void;
 
+  /**
+   * Declare the chats whose `target:prompt` regex this extension applies itself; the 
+   * host skips its own pass for them.
+   */
+  promptRegex: SpindlePromptRegex;
+
   /** Register an LLM tool */
   registerTool(tool: ToolRegistrationDTO): void;
   /** Unregister an LLM tool */