@rulvar/testing 1.12.0 → 1.13.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { a as FAKE_MODEL, c as FakeAdapterOptions, d as FakeToolCallsValue, f as FakeWireErrorValue, i as createTestEngine, l as FakeCall, m as fakeWireError, n as TestEngine, o as FAKE_MODEL_REF, p as fakeToolCalls, r as TestRunHandle, s as FakeAdapter, t as CreateTestEngineOptions, u as FakeResponder } from "./test-engine-2Md1gvT4.js";
+import { a as FAKE_MODEL, c as FakeAdapterOptions, d as FakeToolCallsValue, f as FakeWireErrorValue, i as createTestEngine, l as FakeCall, m as fakeWireError, n as TestEngine, o as FAKE_MODEL_REF, p as fakeToolCalls, r as TestRunHandle, s as FakeAdapter, t as CreateTestEngineOptions, u as FakeResponder } from "./test-engine-DAXwdoOQ.js";
 import { AgentProfile, ChatEvent, ChatRequest, InvocationRole, JournalEntry, JournalStore, ModelCaps, ModelSpec, ProviderAdapter, ResumePreview, RunOutcome, WireError, Workflow, createEngine } from "@rulvar/core";
 
 //#region src/replay-strict.d.ts

package/dist/index.js

@@ -7,7 +7,10 @@ import { createHash } from "node:crypto";
 * FakeAdapter (M1-T14): a REAL ProviderAdapter that resolves calls from
 * declared patterns instead of the network, behind the same seam as live
 * adapters, so unit tests run through the full engine: journal, scheduler,
-* budget layers, and event stream. Calls cost zero USD.
+* budget layers, and event stream. Calls cost zero USD. Honors the
+* caller's AbortSignal exactly like a live adapter: an abort ends the
+* stream promptly with no terminal event, so cancellation, deadline, and
+* budget tests observe the same journal shapes as production adapters.
 */
 /** Scripts a tool-calling turn from a responder. */
 function fakeToolCalls(...calls) {
@@ -49,6 +52,38 @@ const FAKE_CAPS = {
 		outputUsdPerMTok: 0
 	}
 };
+/**
+* Races a responder promise against the caller's abort. On abort the
+* pending responder is detached: its eventual value is discarded and an
+* eventual rejection is swallowed (the caller cancelled; a late failure
+* of the abandoned work must not become an unhandled rejection). A
+* rejection that settles first propagates to the caller unchanged.
+*/
+async function raceAbort(pending, signal) {
+	if (signal === void 0) return {
+		aborted: false,
+		value: await pending
+	};
+	if (signal.aborted) {
+		pending.catch(() => void 0);
+		return { aborted: true };
+	}
+	let onAbort = () => void 0;
+	const abortPromise = new Promise((resolve) => {
+		onAbort = () => resolve({ aborted: true });
+		signal.addEventListener("abort", onAbort, { once: true });
+	});
+	try {
+		const raced = await Promise.race([pending.then((value) => ({
+			aborted: false,
+			value
+		})), abortPromise]);
+		if (raced.aborted) pending.catch(() => void 0);
+		return raced;
+	} finally {
+		signal.removeEventListener("abort", onAbort);
+	}
+}
 function lastUserText(req) {
 	for (let i = req.messages.length - 1; i >= 0; i -= 1) {
 		const msg = req.messages[i];
@@ -61,7 +96,10 @@ var FakeAdapter = class {
 	id = "fake";
 	agents;
 	mintId = createCanonicalIdMinter();
-	/** Every request this adapter served, in order. */
+	/**
+	* Every request this adapter served, in order. A request whose signal
+	* was already aborted on arrival was never served and is not recorded.
+	*/
 	calls = [];
 	constructor(options) {
 		this.agents = options.agents;
@@ -83,7 +121,9 @@ var FakeAdapter = class {
 		}
 		return fallback;
 	}
-	async *stream(req) {
+	async *stream(req, signal) {
+		const aborted = () => signal?.aborted === true;
+		if (aborted()) return;
 		const telemetry = req.providerOptions?.rulvar ?? {};
 		const call = {
 			prompt: lastUserText(req),
@@ -107,8 +147,13 @@ var FakeAdapter = class {
 		}
 		let value;
 		try {
-			value = typeof responder === "function" ? await responder(call) : responder;
+			if (typeof responder === "function") {
+				const raced = await raceAbort(Promise.resolve(responder(call)), signal);
+				if (raced.aborted) return;
+				value = raced.value;
+			} else value = responder;
 		} catch (thrown) {
+			if (aborted()) return;
 			yield {
 				type: "error",
 				error: {
@@ -120,14 +165,12 @@ var FakeAdapter = class {
 			};
 			return;
 		}
-		if (isFakeWireError(value)) {
-			yield {
-				type: "error",
-				error: value.error
-			};
-			return;
-		}
-		if (isFakeToolCalls(value)) {
+		const events = [];
+		if (isFakeWireError(value)) events.push({
+			type: "error",
+			error: value.error
+		});
+		else if (isFakeToolCalls(value)) {
 			const usage = {
 				inputTokens: Math.max(1, Math.ceil(call.prompt.length / 4)),
 				outputTokens: Math.max(1, value.calls.length * 8),
@@ -136,66 +179,70 @@ var FakeAdapter = class {
 			};
 			for (const toolCall of value.calls) {
 				const id = this.mintId();
-				yield {
+				events.push({
 					type: "tool-call-start",
 					id,
 					name: toolCall.name
-				};
-				yield {
+				});
+				events.push({
 					type: "tool-call-end",
 					id,
 					args: toolCall.args
-				};
+				});
 			}
-			yield {
+			events.push({
 				type: "finish",
 				finish: { reason: "tool-calls" },
 				usage
+			});
+		} else {
+			const text = typeof value === "string" ? value : JSON.stringify(value);
+			const usage = {
+				inputTokens: Math.max(1, Math.ceil(call.prompt.length / 4)),
+				outputTokens: Math.max(1, Math.ceil(text.length / 4)),
+				cacheReadTokens: 0,
+				cacheWriteTokens: 0
 			};
-			return;
-		}
-		const text = typeof value === "string" ? value : JSON.stringify(value);
-		const usage = {
-			inputTokens: Math.max(1, Math.ceil(call.prompt.length / 4)),
-			outputTokens: Math.max(1, Math.ceil(text.length / 4)),
-			cacheReadTokens: 0,
-			cacheWriteTokens: 0
-		};
-		const forcedName = typeof req.toolChoice === "object" ? req.toolChoice.name : void 0;
-		if (forcedName !== void 0) {
-			let args = value;
-			if (typeof value === "string") try {
-				args = JSON.parse(value);
-			} catch {
-				args = { text: value };
+			const forcedName = typeof req.toolChoice === "object" ? req.toolChoice.name : void 0;
+			if (forcedName !== void 0) {
+				let args = value;
+				if (typeof value === "string") try {
+					args = JSON.parse(value);
+				} catch {
+					args = { text: value };
+				}
+				const id = this.mintId();
+				events.push({
+					type: "tool-call-start",
+					id,
+					name: forcedName
+				});
+				events.push({
+					type: "tool-call-end",
+					id,
+					args
+				});
+				events.push({
+					type: "finish",
+					finish: { reason: "tool-calls" },
+					usage
+				});
+			} else {
+				events.push({
+					type: "text-delta",
+					text
+				});
+				events.push({
+					type: "finish",
+					finish: { reason: "stop" },
+					usage
+				});
 			}
-			const id = this.mintId();
-			yield {
-				type: "tool-call-start",
-				id,
-				name: forcedName
-			};
-			yield {
-				type: "tool-call-end",
-				id,
-				args
-			};
-			yield {
-				type: "finish",
-				finish: { reason: "tool-calls" },
-				usage
-			};
-			return;
 		}
-		yield {
-			type: "text-delta",
-			text
-		};
-		yield {
-			type: "finish",
-			finish: { reason: "stop" },
-			usage
-		};
+		for (const event of events) {
+			if (aborted()) return;
+			yield event;
+		}
 	}
 };
 //#endregion

package/dist/matchers.d.ts

@@ -1,4 +1,4 @@
-import { r as TestRunHandle } from "./test-engine-2Md1gvT4.js";
+import { r as TestRunHandle } from "./test-engine-DAXwdoOQ.js";
 
 //#region src/matchers.d.ts
 interface MatcherResult {

package/dist/{test-engine-2Md1gvT4.d.ts → test-engine-DAXwdoOQ.d.ts}

@@ -48,12 +48,15 @@ declare class FakeAdapter implements ProviderAdapter {
   readonly id = "fake";
   private readonly agents;
   private readonly mintId;
-  /** Every request this adapter served, in order. */
+  /**
+  * Every request this adapter served, in order. A request whose signal
+  * was already aborted on arrival was never served and is not recorded.
+  */
   readonly calls: FakeCall[];
   constructor(options: FakeAdapterOptions);
   caps(this: void): ModelCaps;
   private match;
-  stream(req: ChatRequest): AsyncIterable<ChatEvent>;
+  stream(req: ChatRequest, signal?: AbortSignal): AsyncIterable<ChatEvent>;
 }
 //#endregion
 //#region src/test-engine.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/testing",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Rulvar test harness: createTestEngine, FakeAdapter, VCR cassettes, replay-strict runs, matchers.",
   "type": "module",
   "license": "Apache-2.0",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@rulvar/core": "1.12.0"
+    "@rulvar/core": "1.13.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",