lumiverse-spindle-types 0.6.1 → 0.6.2

package/package.json

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

package/src/api.ts

@@ -2824,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;

package/src/spindle-api.ts

@@ -1287,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`).
    *