@listen-fire/engine 0.12.0-rc.7 → 0.12.0-rc.8

package/dist/public/limiter.js

@@ -1,7 +1,9 @@
 "use strict";
 // The limiter slot: a module's declared limits held across the calls it makes
 // (`limitRequest`, then `limited` around the call), the slot a host fills
-// (`installLimiter`), and the in-process limiter a host starts from.
+// (`installLimiter`), the in-process limiter a host starts from, and a
+// vendor's rate-limit wait read (`vendorWaitMs`) and turned into a throttle on
+// the caller's key (`throttleAfter`).
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

package/dist/public/testing.d.ts

@@ -2,3 +2,4 @@ export * from '../services/movement_engine/test_host';
 export * from '../services/run_host/contract';
 export * from '../services/browser/contract';
 export * from '../services/browser/fake_browser';
+export * from '../services/limiter/contract';

package/dist/public/testing.js

@@ -1,7 +1,8 @@
 "use strict";
 // For test files only: a ready test host, its fakes, the run host's contract
 // cases a store implementation must pass, and the browser slot's contract
-// cases with a scripted page to hold a module to them without a browser.
+// cases with a scripted page to hold a module to them without a browser, and
+// the limiter slot's contract cases a limiter implementation must pass.
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -21,3 +22,4 @@ __exportStar(require("../services/movement_engine/test_host"), exports);
 __exportStar(require("../services/run_host/contract"), exports);
 __exportStar(require("../services/browser/contract"), exports);
 __exportStar(require("../services/browser/fake_browser"), exports);
+__exportStar(require("../services/limiter/contract"), exports);

package/dist/services/limiter/limiter.d.ts

@@ -1,4 +1,5 @@
 import type { WireDeclaredLimitShape } from '@listen-fire/engine-contracts';
+export { vendorWaitMs } from '@listen-fire/module-runtime/vendor_wait';
 /** One limit a request is under, resolved to the bucket it counts in. */
 export interface LimitBucket {
     key: string;
@@ -64,6 +65,10 @@ export interface Held {
 export declare function acquireOrWait(limiter: Limiter, request: LimitRequest): Promise<Held>;
 /** Run `call` once `limiter` grants `request`; its permit released after. */
 export declare function limited<T>(limiter: Limiter, request: LimitRequest, call: () => Promise<T>): Promise<T>;
+/** A vendor's "wait `waitMs`" (`vendorWaitMs`, or the caller's default) as a
+ *  throttle on `caller`'s key: every call made as that caller, by any host
+ *  sharing `limiter`, is refused until then, and `acquireOrWait` waits it out. */
+export declare function throttleAfter(limiter: Limiter, caller: Caller, waitMs: number, now?: number): Promise<void>;
 /** The limiter filling the slot: the built-in until a host installs another. */
 export declare function limiterSlot(): Limiter;
 export declare function installLimiter(limiter: Limiter): void;

package/dist/services/limiter/limiter.js

@@ -12,15 +12,18 @@
 // a manifest. The built-in, `@lf/memory-limiter`, keeps them in this process
 // (`MemoryLimiter`); lf's Rust one is the same (crates/lf/src/limiter.rs).
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MemoryLimiter = exports.HOLD_MS = void 0;
+exports.MemoryLimiter = exports.HOLD_MS = exports.vendorWaitMs = void 0;
 exports.throttleKey = throttleKey;
 exports.durationMs = durationMs;
 exports.limitRequest = limitRequest;
 exports.acquireOrWait = acquireOrWait;
 exports.limited = limited;
+exports.throttleAfter = throttleAfter;
 exports.limiterSlot = limiterSlot;
 exports.installLimiter = installLimiter;
 const node_crypto_1 = require("node:crypto");
+var vendor_wait_1 = require("@listen-fire/module-runtime/vendor_wait");
+Object.defineProperty(exports, "vendorWaitMs", { enumerable: true, get: function () { return vendor_wait_1.vendorWaitMs; } });
 /** No call outlives a segment's wall clock (its default), so a permit its
  *  holder never released lapses then. */
 exports.HOLD_MS = 900_000;
@@ -101,6 +104,12 @@ async function limited(limiter, request, call) {
         await held.release();
     }
 }
+/** A vendor's "wait `waitMs`" (`vendorWaitMs`, or the caller's default) as a
+ *  throttle on `caller`'s key: every call made as that caller, by any host
+ *  sharing `limiter`, is refused until then, and `acquireOrWait` waits it out. */
+async function throttleAfter(limiter, caller, waitMs, now = Date.now()) {
+    await limiter.throttle({ key: throttleKey(caller), until: new Date(now + waitMs).toISOString() });
+}
 // ── The slot this process's calls ask ───────────────────────────────────────
 let slot;
 /** The limiter filling the slot: the built-in until a host installs another. */

package/dist/services/plugins/registry.js

@@ -473,6 +473,11 @@ const RENDER_SIGNATURE = {
             description: 'The page: "a4" (the default) or "letter".',
         },
         { name: 'margin', type: { kind: 'number' }, description: 'The margin on every side, in points (a whole number from 0 to 200). The default is 30.' },
+        {
+            name: 'name',
+            type: { kind: 'string' },
+            description: 'The file\'s name, as the system it is written to shows it: ".pdf" is added when it does not end with it. The default is "movement-artifact.pdf".',
+        },
     ],
     dataDependency: 'none',
     // Pure: it reads nothing, writes nowhere, asks no model and never parks.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@listen-fire/engine",
   "license": "Apache-2.0",
-  "version": "0.12.0-rc.7",
+  "version": "0.12.0-rc.8",
   "description": "The movement engine for this release's language and its host contract: the Rust engine's shim, the EngineHost families, the run host, the embed kit, and the adapter and model types they reach. Every shell (the hosted product, the `lf` command line, an embedder) runs the same engine. A run pinned to a release this one does not read is refused by name. Embedders reach it only through public/* (the exports map); the internals resolve only under the `movement-engine-internals` condition, which only test runners set",
   "engines": {
     "node": "22.20.0"
@@ -17,9 +17,9 @@
   "dependencies": {
     "safe-stable-stringify": "2.5.0",
     "zod": "4.1.12",
-    "@listen-fire/movement-lang": "^0.12.0-rc.7",
-    "@listen-fire/engine-contracts": "^0.12.0-rc.7",
-    "@listen-fire/module-runtime": "^0.12.0-rc.7"
+    "@listen-fire/movement-lang": "^0.12.0-rc.8",
+    "@listen-fire/engine-contracts": "^0.12.0-rc.8",
+    "@listen-fire/module-runtime": "^0.12.0-rc.8"
   },
   "devDependencies": {
     "@types/jest": "29.5.14",