lumiverse-spindle-types 0.6.31 → 0.6.33

package/dist/api.d.ts

@@ -205,6 +205,8 @@ export interface MacroDefinitionDTO {
 export interface MacroInvocationContextDTO {
     /** False when the host is performing a dry / non-committing resolve. */
     commit: boolean;
+    /** Host-trusted chat id for this invocation when a chat-scoped macro environment exists. */
+    chatId?: string;
     [key: string]: unknown;
 }
 export interface MacroResolveOptionsDTO {
@@ -1480,6 +1482,12 @@ export interface RegexScriptDTO {
     sort_order: number;
     description: string;
     folder: string;
+    /**
+     * Preset this row is bound to for the host's delete cascade, or null when
+     * unbound. Host-authored: set at creation through `preset_id`, never re-pointed
+     * by an update, so treat it as read-only here.
+     */
+    readonly preset_id?: string | null;
     /** Host-validated version badge for this Spindle-owned folder, or null when unversioned/unfiled. */
     readonly folder_version?: string | null;
     metadata: Record<string, unknown>;
@@ -1525,10 +1533,29 @@ export interface RegexScriptCreateDTO {
      * to clear an existing label.
      */
     folder_version?: string | null;
+    /**
+     * Bind the created script to one of the calling user's presets. Create-only:
+     * the host validates the id against that user's presets and rejects unknown,
+     * foreign, or malformed ids instead of storing an orphan link, and `update`
+     * never re-points or clears the binding.
+     *
+     * The link is a lifecycle binding: deleting the preset deletes the script with
+     * it, and preset activation does not change the script's `disabled` state, so
+     * the extension keeps control of its own rule's enablement. `null` and an empty
+     * string leave the script unbound.
+     */
+    preset_id?: string | null;
     metadata?: Record<string, unknown>;
     script_id?: string;
 }
-export type RegexScriptUpdateDTO = Partial<RegexScriptCreateDTO>;
+/**
+ * Every `RegexScriptCreateDTO` field is optional on update, except `preset_id`.
+ * The preset link is create-only: the host strips it from extension input, so it
+ * is excluded from the update DTO instead of accepting a field that would be
+ * ignored. Deleting and recreating the script is how an owner moves it to
+ * another preset.
+ */
+export type RegexScriptUpdateDTO = Partial<Omit<RegexScriptCreateDTO, "preset_id">>;
 /**
  * One world info entry exposed to a `registerWorldInfoInterceptor` handler.
  * Subset of `WorldBookEntryDTO` covering the fields the interceptor needs to
@@ -1571,6 +1598,8 @@ export interface WorldInfoInterceptorEntryDTO {
     readonly delay: number;
     /** Latest prompt-local chat placement supplied by an earlier handler. */
     readonly placement?: WorldInfoInterceptorPlacementDTO;
+    /** Active output-order request from an earlier handler; omission means selection order. */
+    readonly outputOrder?: "selection" | "insertion";
     /** Attachment scope that contributed the entry's book to this chat. */
     readonly book_source?: WorldBookSourceDTO;
 }
@@ -1636,8 +1665,8 @@ export interface WorldInfoInterceptorCtxDTO {
     readonly activationSettings: WorldInfoActivationSettingsDTO;
 }
 /**
- * Per-entry content overrides emitted by a `registerWorldInfoInterceptor`
- * handler. Both values are prompt-local and never persist to the world book.
+ * Per-entry overrides emitted by a `registerWorldInfoInterceptor` handler.
+ * Overrides are prompt-local and never persist to the world book.
  */
 export interface WorldInfoInterceptorMutationDTO {
     readonly id: string;
@@ -1654,6 +1683,18 @@ export interface WorldInfoInterceptorMutationDTO {
      * Omit it to retain the stored native position, depth, and role.
      */
     readonly placement?: WorldInfoInterceptorPlacementDTO;
+    /**
+     * "insertion" orders selected entries by order_value ascending, reversing
+     * equal-order ties relative to selection order, as chat-depth placement does.
+     * Entries requested by the same extension exchange only their own output
+     * slots; other entries and other extensions' groups retain their slots.
+     * This runs after selection and budget filtering and applies to native
+     * position buckets and named outlets. Explicit chat-depth placement takes
+     * precedence and keeps its existing ordering.
+     * "selection" clears an earlier request; omission leaves it unchanged.
+     * The last valid request for an entry determines its extension group.
+     */
+    readonly outputOrder?: "selection" | "insertion";
 }
 /**
  * Return value of a `registerWorldInfoInterceptor` handler. Each list is

package/dist/spindle-api.d.ts

@@ -1349,6 +1349,9 @@ export interface SpindleAPI {
      * `preAssemblyGenerationContext >= 1`: generation contexts carry
      * `dryRun`/`userId` and `cancelGeneration` is honored.
      * `worldInfoActivationCapture >= 1`: world info activation capture is supported.
+     * `worldInfoOutputOrdering >= 1`: world info mutations accept prompt-local
+     * `outputOrder`, applied after selection without changing budget priority.
+     *
      * `worldInfoRuntimePlacement >= 1`: world info mutations accept prompt-local
      * chat-depth placement.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.6.31",
+  "version": "0.6.33",
   "type": "module",
   "types": "./dist/index.d.ts",
   "keywords": [