lumiverse-spindle-types 0.4.46 → 0.4.48

package/package.json

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

package/src/api.ts

@@ -179,6 +179,8 @@ export interface ToolRegistrationDTO {
   description: string;
   parameters: Record<string, unknown>; // JSON Schema
   council_eligible?: boolean;
+  /** Whether the tool is available for inline function calling during generation */
+  inline_available?: boolean;
 }
 
 /** Tool/function schema passed to LLM for inline function calling. */
@@ -1276,6 +1278,8 @@ export interface GenerationStartedPayloadDTO {
   characterId?: string;
   characterName?: string;
   breakdown?: AssemblyBreakdownEntryDTO[];
+  /** The type of generation: normal, continue, regenerate, swipe, or impersonate. */
+  generationType?: string;
 }
 
 /** Payload for `STREAM_TOKEN_RECEIVED` events. */
@@ -1300,6 +1304,8 @@ export interface GenerationEndedPayloadDTO {
   content?: string;
   /** Error message when the generation failed. */
   error?: string;
+  /** The type of generation: normal, continue, regenerate, swipe, or impersonate. */
+  generationType?: string;
 }
 
 /** Payload for `GENERATION_STOPPED` events (user-initiated stop). */

package/src/dom.ts

@@ -16,6 +16,15 @@ export interface SpindleDOMHelper {
     attrs?: Record<string, string>
   ): HTMLElementTagNameMap[K];
 
+  /**
+   * Create a host-managed sandboxed iframe for extension-owned HTML/CSS/JS.
+   *
+   * The host always applies `sandbox="allow-scripts"` without
+   * `allow-same-origin`, plus a strict child-document CSP and a narrow
+   * postMessage bridge. Use this instead of creating raw iframes.
+   */
+  createSandboxFrame(options: SpindleSandboxFrameOptions): SpindleSandboxFrameHandle;
+
   /** Query within this extension's own injected elements only */
   query(selector: string): Element | null;
 
@@ -161,6 +170,34 @@ export interface SpindleInputBarActionHandle {
   destroy(): void;
 }
 
+// ── Sandboxed Frame ──
+
+export interface SpindleSandboxFrameOptions {
+  /** HTML document or fragment rendered inside the sandboxed iframe. */
+  html: string;
+  /** Automatically resize the host iframe to fit the child content. Default: `true`. */
+  autoResize?: boolean;
+  /** Initial host iframe height in CSS pixels. Default: `minHeight` or `40`. */
+  initialHeight?: number;
+  /** Minimum host iframe height in CSS pixels. Default: `40`. */
+  minHeight?: number;
+  /** Maximum host iframe height in CSS pixels. Default: `4000`. */
+  maxHeight?: number;
+}
+
+export interface SpindleSandboxFrameHandle {
+  /** The sandboxed iframe element. Extensions may place and style it like any other element. */
+  element: HTMLIFrameElement;
+  /** Replace the child document contents. */
+  setContent(html: string): void;
+  /** Send a message payload into the child sandbox runtime. */
+  postMessage(payload: unknown): void;
+  /** Receive payloads sent from the child sandbox runtime. */
+  onMessage(handler: (payload: unknown) => void): () => void;
+  /** Destroy the sandbox and remove the iframe from the DOM. */
+  destroy(): void;
+}
+
 export interface SpindleUploadFile {
   name: string;
   mimeType: string;

package/src/index.ts

@@ -137,11 +137,13 @@ export type {
   SpindleDockPanelHandle,
   SpindleAppMountOptions,
   SpindleAppMountHandle,
-  SpindleInputBarActionOptions,
-  SpindleInputBarActionHandle,
-  SpindleContextMenuOptions,
-  SpindleContextMenuItemDef,
-  SpindleContextMenuResult,
+   SpindleInputBarActionOptions,
+   SpindleInputBarActionHandle,
+   SpindleSandboxFrameOptions,
+   SpindleSandboxFrameHandle,
+   SpindleContextMenuOptions,
+   SpindleContextMenuItemDef,
+   SpindleContextMenuResult,
   SpindleModalOptions,
   SpindleModalHandle,
    SpindleConfirmVariant,

package/src/tools.ts

@@ -13,6 +13,8 @@ export interface ToolRegistration {
   parameters: JSONSchema;
   /** Whether council members can invoke this tool (future) */
   council_eligible?: boolean;
+  /** Whether the tool is available for inline function calling during generation */
+  inline_available?: boolean;
   /** Auto-set by host — the owning extension identifier */
   extension_id: string;
 }