lumiverse-spindle-types 0.4.35 → 0.4.37

package/package.json

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

package/src/api.ts

@@ -9,6 +9,21 @@ export interface LlmMessageDTO {
   name?: string;
 }
 
+/**
+ * Optional metadata returned by an interceptor so Lumiverse can surface
+ * extension-injected prompt messages as first-class items in Prompt Breakdown.
+ *
+ * `messageIndex` points at the message inside the interceptor's returned
+ * `messages` array. The host resolves role/content/extension attribution from
+ * that message and from the installed extension manifest, so extensions only
+ * need to identify which injected messages should appear in the breakdown.
+ */
+export interface InterceptorBreakdownEntryDTO {
+  messageIndex: number;
+  /** Optional human label for this injected prompt block. */
+  name?: string;
+}
+
 /**
  * Return type for interceptor handlers.
  * Interceptors may return either a plain `LlmMessageDTO[]` (backwards-compatible)
@@ -18,6 +33,8 @@ export interface InterceptorResultDTO {
   messages: LlmMessageDTO[];
   /** Provider parameters merged into the outgoing LLM request. Requires `generation_parameters` permission. */
   parameters?: Record<string, unknown>;
+  /** Optional prompt-breakdown entries for injected messages. */
+  breakdown?: InterceptorBreakdownEntryDTO[];
 }
 
 export interface MacroDefinitionDTO {
@@ -522,6 +539,8 @@ export interface AssemblyBreakdownEntryDTO {
   firstMessageIndex?: number;
   preCountedTokens?: number;
   excludeFromTotal?: boolean;
+  extensionId?: string;
+  extensionName?: string;
 }
 
 export interface ActivationStatsDTO {
@@ -552,7 +571,14 @@ export interface MemoryStatsDTO {
 
 export interface DryRunTokenCountDTO {
   total_tokens: number;
-  breakdown: Array<{ name: string; type: string; tokens: number; role?: string }>;
+  breakdown: Array<{
+    name: string;
+    type: string;
+    tokens: number;
+    role?: string;
+    extensionId?: string;
+    extensionName?: string;
+  }>;
   tokenizer_id: string | null;
   tokenizer_name: string | null;
 }
@@ -868,6 +894,7 @@ export interface GenerationStartedPayloadDTO {
   targetMessageId?: string;
   characterId?: string;
   characterName?: string;
+  breakdown?: AssemblyBreakdownEntryDTO[];
 }
 
 /** Payload for `STREAM_TOKEN_RECEIVED` events. */
@@ -1108,7 +1135,13 @@ export type WorkerToHost =
   | { type: "unregister_macro"; name: string }
   | { type: "update_macro_value"; name: string; value: string }
   | { type: "register_interceptor"; priority?: number }
-  | { type: "intercept_result"; requestId: string; messages: LlmMessageDTO[]; parameters?: Record<string, unknown> }
+  | {
+      type: "intercept_result";
+      requestId: string;
+      messages: LlmMessageDTO[];
+      parameters?: Record<string, unknown>;
+      breakdown?: InterceptorBreakdownEntryDTO[];
+    }
   | { type: "register_tool"; tool: ToolRegistrationDTO }
   | { type: "unregister_tool"; name: string }
   | { type: "request_generation"; requestId: string; input: GenerationRequestDTO }

package/src/dom.ts

@@ -135,6 +135,7 @@ export interface SpindleAppMountHandle {
 export interface SpindleInputBarActionOptions {
   id: string;
   label: string;
+  subtitle?: string;
   iconSvg?: string;
   iconUrl?: string;
   enabled?: boolean;
@@ -143,6 +144,7 @@ export interface SpindleInputBarActionOptions {
 export interface SpindleInputBarActionHandle {
   actionId: string;
   setLabel(label: string): void;
+  setSubtitle(subtitle?: string): void;
   setEnabled(enabled: boolean): void;
   onClick(handler: () => void): () => void;
   destroy(): void;

package/src/index.ts

@@ -14,6 +14,7 @@ export { SpindleEvent, CoreEventType } from "./events";
 
 export type {
   LlmMessageDTO,
+  InterceptorBreakdownEntryDTO,
   InterceptorResultDTO,
   MacroDefinitionDTO,
   MacroInvocationContextDTO,

package/src/spindle-api.ts

@@ -116,7 +116,9 @@ export interface SpindleAPI {
    * The handler receives the assembled messages and a context object, and may
    * return either a plain `LlmMessageDTO[]` (backwards-compatible) or an
    * `InterceptorResultDTO` to also inject generation parameters into the
-   * outgoing LLM request.
+   * outgoing LLM request. `InterceptorResultDTO.breakdown` can be used to mark
+   * specific injected messages as Prompt Breakdown entries so dry-run/live UI
+   * and saved breakdowns can attribute them back to the extension.
    *
    * Returning `parameters` requires the `generation_parameters` permission.
    * Without it, returned parameters are silently stripped.