@copilotkit/aimock 1.42.0 → 1.43.0

package/dist/ws-live.js

@@ -0,0 +1,400 @@
+import { flattenHeaders, isLiveResponse, resolveResponse, resolveStrictMode, strictNoMatchLogLine, strictNoMatchMessage, strictOverrideField, wouldProxyMiss } from "./helpers.js";
+import { normalizeLiveFixture, validateLiveClientEvent } from "./live-fixture.js";
+import { matchFixtureDiagnostic } from "./router.js";
+import { resolveUpstreamUrl } from "./url.js";
+import { applyProviderAuth } from "./provider-auth.js";
+import { DEFAULT_MAX_PROXY_BUFFER_BYTES, DEFAULT_MAX_PROXY_BUFFER_FRAMES, clampTimeout } from "./recorder.js";
+import { LiveRecorderError, createLiveRecorder } from "./live-recorder.js";
+import { connectUpstreamWebSocket } from "./ws-upstream.js";
+import { createLiveReplay } from "./live-replay.js";
+import { performance } from "node:perf_hooks";
+
+//#region src/ws-live.ts
+function object(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+/** Node otherwise turns an overflowing delay into a one-millisecond timeout. */
+function scheduleLiveTimeout(callback, timeoutMs) {
+	const started = performance.now();
+	const onTimeout = () => {
+		const remaining = timeoutMs - (performance.now() - started);
+		if (remaining > 0) timer = setTimeout(onTimeout, Math.min(remaining, 2147483647));
+		else callback();
+	};
+	let timer = setTimeout(onTimeout, Math.min(timeoutMs, 2147483647));
+	return () => clearTimeout(timer);
+}
+/** Diagnostic copies never retain executable members or mutate replay operands. */
+function liveJournalSnapshot(entry, secretValues) {
+	const secrets = secretValues.filter((secret) => secret.length > 0);
+	if (!secrets.length) return entry;
+	const containsSecret = (value) => secrets.some((secret) => value.includes(secret));
+	const marker = containsSecret("[REDACTED]") ? "" : "[REDACTED]";
+	const redact = (value) => containsSecret(value) ? marker : value;
+	const ancestors = /* @__PURE__ */ new Set();
+	const copy = (value) => {
+		if (typeof value === "string") return redact(value);
+		if (typeof value === "function" || typeof value === "symbol") return void 0;
+		if (value === null || typeof value !== "object") return value;
+		if (ancestors.has(value)) return void 0;
+		ancestors.add(value);
+		try {
+			if (Array.isArray(value)) return value.map(copy);
+			if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) return void 0;
+			return Object.fromEntries(Object.entries(Object.getOwnPropertyDescriptors(value)).filter(([, descriptor]) => descriptor.enumerable && "value" in descriptor).map(([key, descriptor]) => [redact(key), copy(descriptor.value)]));
+		} finally {
+			ancestors.delete(value);
+		}
+	};
+	return {
+		...entry,
+		headers: copy(entry.headers),
+		body: copy(entry.body),
+		response: {
+			...entry.response,
+			fixture: copy(entry.response.fixture)
+		}
+	};
+}
+/** Owns a single transport, replay cursor and every cancellation deadline. */
+function handleLiveSession(ws, fixtures, journal, options) {
+	const { defaults, limits, testId } = options;
+	const normalizeRecordTimeout = (value) => Math.min(Number.MAX_SAFE_INTEGER, Math.ceil(clampTimeout(value, 3e4)));
+	const upstreamTimeoutMs = normalizeRecordTimeout(defaults.record?.upstreamTimeoutMs);
+	const bodyTimeoutMs = normalizeRecordTimeout(defaults.record?.bodyTimeoutMs);
+	const controller = new AbortController();
+	let state = "awaiting-start";
+	let mode;
+	let starting = false;
+	const pending = [];
+	let pendingBytes = 0;
+	const maxPendingBytes = Math.min(limits.maxBufferedBytes, defaults.record?.maxProxyBufferBytes ?? DEFAULT_MAX_PROXY_BUFFER_BYTES);
+	const maxPendingFrames = defaults.record?.maxProxyBufferFrames ?? DEFAULT_MAX_PROXY_BUFFER_FRAMES;
+	let upstream;
+	let recorder;
+	let recordingSecrets = [];
+	let terminalReceived = false;
+	let captureStarted;
+	let recordingJournaled = false;
+	let upstreamIdle;
+	let replay;
+	const deadline = scheduleLiveTimeout(() => fail("timeout", "Live session duration exceeded"), limits.maxDurationMs);
+	const startup = scheduleLiveTimeout(() => fail("timeout", "Live startup deadline exceeded"), defaults.record ? upstreamTimeoutMs : limits.idleTimeoutMs);
+	function recordJournal(category) {
+		if (recordingJournaled || !recorder) return;
+		recordingJournaled = true;
+		journal.add(liveJournalSnapshot({
+			method: "WS",
+			path: "/v1/live/sessions",
+			headers: { "x-test-id": testId },
+			body: {
+				model: "gpt-live-1",
+				messages: []
+			},
+			response: {
+				status: category ? 502 : 200,
+				fixture: null,
+				source: "proxy",
+				...strictOverrideField(defaults.strict, options.headers),
+				...category ? { error: category } : {}
+			}
+		}, [...limits.secretValues, ...recordingSecrets]));
+	}
+	function cleanup() {
+		if (state === "closed") return;
+		state = "closed";
+		deadline();
+		startup();
+		upstreamIdle?.();
+		recordJournal("incomplete-capture");
+		recorder?.abort();
+		upstream?.destroy();
+		pending.length = 0;
+		pendingBytes = 0;
+		replay?.close();
+		controller.abort();
+		ws.removeListener("message", receive);
+		ws.removeListener("close", cleanup);
+		ws.removeListener("error", cleanup);
+		options.onDispose();
+	}
+	function dispose() {
+		if (state === "closed") return;
+		ws.close(1001, "Live session disposed");
+		cleanup();
+	}
+	function fail(category, message) {
+		if (state === "closed" || state === "closing") return;
+		state = "closing";
+		recorder?.abort(category);
+		recordJournal(category);
+		ws.send(JSON.stringify({
+			type: "aimock.error",
+			error: {
+				category,
+				message
+			}
+		}));
+		ws.close(category === "resource-limit" ? 1009 : 1008, "Live session failed");
+		cleanup();
+	}
+	function receive(data) {
+		if (state === "closed" || state === "closing") return;
+		let event;
+		try {
+			event = validateLiveClientEvent(JSON.parse(data), limits);
+		} catch {
+			fail("invalid-client", "Invalid Live client command");
+			return;
+		}
+		if (starting) {
+			if (event.type === "session.start") {
+				fail("invalid-client", "Live session has already started");
+				return;
+			}
+			const bytes = Buffer.byteLength(data);
+			if (bytes > maxPendingBytes - pendingBytes || pending.length >= maxPendingFrames) {
+				fail("resource-limit", "Live startup input queue exceeded");
+				return;
+			}
+			pendingBytes += bytes;
+			pending.push(event);
+			return;
+		}
+		accept(event);
+	}
+	function recordingError(error) {
+		fail(error instanceof LiveRecorderError ? error.category : error instanceof Error && error.message === "WebSocket write limit exceeded" ? "resource-limit" : "upstream-connect", "Live recording failed");
+	}
+	function touchUpstream() {
+		upstreamIdle?.();
+		upstreamIdle = scheduleLiveTimeout(() => fail("timeout", "Live upstream idle deadline exceeded"), bodyTimeoutMs);
+	}
+	function forward(event) {
+		if (!upstream || !recorder || terminalReceived) return;
+		try {
+			const raw = JSON.stringify(event);
+			const now = performance.now();
+			captureStarted ??= now;
+			recorder.acceptClient(raw, Math.floor(now - captureStarted));
+			upstream.sendAsync(raw, controller.signal).catch(recordingError);
+		} catch (error) {
+			recordingError(error);
+		}
+	}
+	async function startRecording(first) {
+		const record = defaults.record;
+		if (!record?.providers.openai) {
+			fail("fixture-mismatch", "No matching Live fixture");
+			return;
+		}
+		starting = true;
+		try {
+			const base = new URL(record.providers.openai);
+			if (base.username || base.password || base.search || base.hash) throw new Error("Invalid URL");
+			base.pathname = base.pathname.replace(/\/v1\/?$/, "/");
+			const target = resolveUpstreamUrl(base.href, "/v1/live/sessions");
+			const headers = {};
+			const incoming = options.headers.authorization;
+			const credential = incoming?.match(/^\s*(?:Bearer|Key)\s+(.+)$/i)?.[1].trim();
+			if (incoming && !options.localApiKeys?.includes(credential ?? "")) headers.Authorization = incoming;
+			applyProviderAuth(headers, target, "openai", record.providerKeys?.openai);
+			const selected = headers.Authorization?.replace(/^\s*(?:Bearer|Key)\s+/i, "").trim();
+			recordingSecrets = [...selected ? [selected] : [], ...options.localApiKeys ?? []];
+			recorder = createLiveRecorder({
+				record,
+				fixtures,
+				logger: defaults.logger,
+				testId,
+				live: limits,
+				secretValues: recordingSecrets,
+				provenance: {
+					host: target.host,
+					path: "/v1/live/sessions",
+					observedAt: (/* @__PURE__ */ new Date()).toISOString(),
+					referenceVersion: "gpt-live-1-observed-v3",
+					sanitationVersion: 1
+				}
+			});
+			upstream = await connectUpstreamWebSocket(target, headers, limits, controller.signal, upstreamTimeoutMs);
+			if (controller.signal.aborted) {
+				upstream.destroy();
+				return;
+			}
+			upstream.on("activity", touchUpstream);
+			upstream.on("message", (raw) => {
+				if (controller.signal.aborted) return;
+				touchUpstream();
+				try {
+					recorder.acceptServer(raw, captureStarted === void 0 ? 0 : Math.floor(performance.now() - captureStarted));
+					const output = JSON.parse(raw);
+					if (!output || typeof output !== "object" || !("type" in output)) throw new Error("Invalid event");
+					if (output.type === "session.started") {
+						startup();
+						starting = false;
+						state = "active";
+						const queued = pending.splice(0);
+						pendingBytes = 0;
+						for (const event of queued) {
+							if (controller.signal.aborted) break;
+							accept(event);
+						}
+					}
+					const terminal = output.type === "session.closed";
+					if (terminal) terminalReceived = true;
+					ws.sendAsync(raw, controller.signal).then(() => {
+						if (!terminal || controller.signal.aborted) return;
+						const result = recorder.finish();
+						if (result.kind === "failed") {
+							fail(result.category, "Live capture export failed");
+							return;
+						}
+						recordJournal();
+						ws.close(1e3, "Live session complete");
+						cleanup();
+					}, recordingError);
+				} catch (error) {
+					recordingError(error);
+				}
+			});
+			upstream.on("error", () => fail("upstream-connect", "Live upstream connection failed"));
+			upstream.on("close", (code) => {
+				if (!terminalReceived) fail(code === 1009 ? "resource-limit" : "incomplete-capture", "Live upstream closed before completion");
+			});
+			touchUpstream();
+			forward(first);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : "";
+			if (/HTTP 401/.test(message)) fail("upstream-auth", "Live upstream authentication refused");
+			else if (/HTTP (403|404|429)/.test(message)) fail("upstream-access", "Live upstream access refused");
+			else recordingError(error);
+		}
+	}
+	function startReplay(fixture, request, first, raw) {
+		if (state === "closed" || state === "closing") return;
+		try {
+			if (!isLiveResponse(raw)) throw new Error("not a Live fixture");
+			const response = normalizeLiveFixture(raw, limits);
+			replay = createLiveReplay(response.live, {
+				limits,
+				signal: controller.signal,
+				timing: response.liveTiming ?? "recorded",
+				replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed,
+				fail,
+				send: async (output) => {
+					await ws.sendAsync(JSON.stringify(output), controller.signal);
+					if (output.type === "session.closed" && !controller.signal.aborted) {
+						ws.close(1e3, "Live session complete");
+						cleanup();
+					}
+				}
+			});
+		} catch {
+			fail("protocol-divergence", "Invalid Live replay configuration");
+			return;
+		}
+		journal.add(liveJournalSnapshot({
+			method: "WS",
+			path: "/v1/live/sessions",
+			headers: {
+				...flattenHeaders(options.headers),
+				"x-test-id": testId
+			},
+			body: request,
+			response: {
+				status: 200,
+				fixture
+			}
+		}, limits.secretValues), fixture);
+		startup();
+		starting = false;
+		state = "active";
+		replay.accept(first);
+		const queued = pending.splice(0);
+		pendingBytes = 0;
+		for (const event of queued) {
+			if (controller.signal.aborted) break;
+			accept(event);
+		}
+	}
+	function accept(event) {
+		if (state === "closed" || state === "closing") return;
+		if (state === "awaiting-start") {
+			const session = object(event.session);
+			const format = object(object(session?.audio)?.format);
+			const delegation = object(session?.delegation);
+			if (event.type !== "session.start" || session?.model !== "gpt-live-1" || format?.type !== "audio/pcm" || format.rate !== 24e3 || delegation?.type !== "client" && delegation?.type !== "responses") {
+				fail("invalid-client", "Live requires session.start with explicit model, PCM24 audio and delegation");
+				return;
+			}
+			mode = delegation.type === "client" ? "client" : "managed";
+			const request = {
+				model: session.model,
+				messages: [],
+				_endpointType: "openai-live",
+				session: structuredClone(session)
+			};
+			let fixture;
+			let skippedBySequenceOrTurn;
+			try {
+				({fixture, skippedBySequenceOrTurn} = matchFixtureDiagnostic(fixtures, request, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform));
+			} catch {
+				fail("protocol-divergence", "Live fixture selection failed");
+				return;
+			}
+			if (!fixture) {
+				const strict = resolveStrictMode(defaults.strict, options.headers);
+				if (strict) {
+					const message = strictNoMatchMessage(skippedBySequenceOrTurn);
+					defaults.logger.error(strictNoMatchLogLine("WS", "/v1/live/sessions", skippedBySequenceOrTurn));
+					journal.add(liveJournalSnapshot({
+						method: "WS",
+						path: "/v1/live/sessions",
+						headers: { "x-test-id": testId },
+						body: {
+							model: request.model,
+							messages: []
+						},
+						response: {
+							status: 503,
+							fixture: null,
+							...strictOverrideField(defaults.strict, options.headers)
+						}
+					}, limits.secretValues));
+					fail("fixture-mismatch", message);
+				} else if (wouldProxyMiss(strict, defaults.record, "openai")) startRecording(event);
+				else fail("fixture-mismatch", "No matching Live fixture");
+				return;
+			}
+			journal.incrementFixtureMatchCount(fixture, fixtures, testId);
+			if (typeof fixture.response === "function") {
+				starting = true;
+				const selected = fixture;
+				resolveResponse(selected, request).then((response) => startReplay(selected, request, event, response), () => fail("protocol-divergence", "Live response factory failed"));
+			} else startReplay(fixture, request, event, fixture.response);
+			return;
+		} else if (event.type === "session.start") {
+			fail("invalid-client", "Live session has already started");
+			return;
+		}
+		if (event.type === "session.update") {
+			const patch = object(event.session);
+			const delegation = object(patch?.delegation);
+			const backend = object(delegation?.responses);
+			if (mode !== "managed" || !patch || !delegation || !backend || Object.keys(patch).some((key) => key !== "delegation") || Object.keys(delegation).some((key) => key !== "type" && key !== "responses") || delegation.type !== void 0 && delegation.type !== "responses" || Object.keys(backend).some((key) => key !== "instructions") || !Object.hasOwn(backend, "instructions")) {
+				fail("invalid-client", "Only managed backend instructions can be updated");
+				return;
+			}
+		}
+		if (upstream) forward(event);
+		else replay?.accept(event);
+	}
+	ws.on("message", receive);
+	ws.on("close", cleanup);
+	ws.on("error", cleanup);
+	return dispose;
+}
+
+//#endregion
+export { handleLiveSession };
+//# sourceMappingURL=ws-live.js.map

package/dist/ws-live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-live.js","names":[],"sources":["../src/ws-live.ts"],"sourcesContent":["import { performance } from \"node:perf_hooks\";\nimport type { IncomingHttpHeaders } from \"node:http\";\nimport {\n  flattenHeaders,\n  isLiveResponse,\n  resolveResponse,\n  resolveStrictMode,\n  strictNoMatchLogLine,\n  strictNoMatchMessage,\n  strictOverrideField,\n  wouldProxyMiss,\n} from \"./helpers.js\";\nimport { normalizeLiveFixture, validateLiveClientEvent } from \"./live-fixture.js\";\nimport { createLiveRecorder, LiveRecorderError } from \"./live-recorder.js\";\nimport { applyProviderAuth } from \"./provider-auth.js\";\nimport { connectUpstreamWebSocket } from \"./ws-upstream.js\";\nimport { resolveUpstreamUrl } from \"./url.js\";\nimport {\n  clampTimeout,\n  DEFAULT_MAX_PROXY_BUFFER_BYTES,\n  DEFAULT_MAX_PROXY_BUFFER_FRAMES,\n} from \"./recorder.js\";\nimport { createLiveReplay } from \"./live-replay.js\";\nimport type {\n  LiveFailureCategory,\n  LiveJson,\n  LiveMode,\n  LiveObject,\n  LiveOptions,\n} from \"./live-types.js\";\nimport type { Journal } from \"./journal.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  FixtureResponse,\n  HandlerDefaults,\n  JournalEntry,\n} from \"./types.js\";\nimport type { WebSocketConnection } from \"./ws-framing.js\";\n\nexport interface LiveSessionOptions {\n  defaults: HandlerDefaults;\n  limits: Required<LiveOptions>;\n  testId: string;\n  headers: IncomingHttpHeaders;\n  localApiKeys?: readonly string[];\n  onDispose: () => void;\n}\nfunction object(value: LiveJson | undefined): LiveObject | undefined {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value) ? value : undefined;\n}\n\n/** Node otherwise turns an overflowing delay into a one-millisecond timeout. */\nfunction scheduleLiveTimeout(callback: () => void, timeoutMs: number): () => void {\n  const started = performance.now();\n  const onTimeout = () => {\n    const remaining = timeoutMs - (performance.now() - started);\n    if (remaining > 0) timer = setTimeout(onTimeout, Math.min(remaining, 2_147_483_647));\n    else callback();\n  };\n  let timer = setTimeout(onTimeout, Math.min(timeoutMs, 2_147_483_647));\n  return () => clearTimeout(timer);\n}\n\n/** Diagnostic copies never retain executable members or mutate replay operands. */\nfunction liveJournalSnapshot(\n  entry: Omit<JournalEntry, \"id\" | \"timestamp\">,\n  secretValues: readonly string[],\n): Omit<JournalEntry, \"id\" | \"timestamp\"> {\n  const secrets = secretValues.filter((secret) => secret.length > 0);\n  if (!secrets.length) return entry;\n  const containsSecret = (value: string) => secrets.some((secret) => value.includes(secret));\n  // Whole-field redaction avoids creating another secret by joining substrings.\n  const marker = containsSecret(\"[REDACTED]\") ? \"\" : \"[REDACTED]\";\n  const redact = (value: string) => (containsSecret(value) ? marker : value);\n  const ancestors = new Set<object>();\n  const copy = (value: unknown): unknown => {\n    if (typeof value === \"string\") return redact(value);\n    if (typeof value === \"function\" || typeof value === \"symbol\") return undefined;\n    if (value === null || typeof value !== \"object\") return value;\n    if (ancestors.has(value)) return undefined;\n    ancestors.add(value);\n    try {\n      if (Array.isArray(value)) return value.map(copy);\n      // Diagnostics contain data only; omit getters and non-JSON objects.\n      if (\n        Object.getPrototypeOf(value) !== Object.prototype &&\n        Object.getPrototypeOf(value) !== null\n      )\n        return undefined;\n      return Object.fromEntries(\n        Object.entries(Object.getOwnPropertyDescriptors(value))\n          .filter(([, descriptor]) => descriptor.enumerable && \"value\" in descriptor)\n          .map(([key, descriptor]) => [redact(key), copy(descriptor.value)]),\n      );\n    } finally {\n      ancestors.delete(value);\n    }\n  };\n  // Preserve the journal schema; copied operands are diagnostics, never replay inputs.\n  return {\n    ...entry,\n    headers: copy(entry.headers) as JournalEntry[\"headers\"],\n    body: copy(entry.body) as JournalEntry[\"body\"],\n    response: { ...entry.response, fixture: copy(entry.response.fixture) as Fixture | null },\n  };\n}\n\n/** Owns a single transport, replay cursor and every cancellation deadline. */\nexport function handleLiveSession(\n  ws: WebSocketConnection,\n  fixtures: Fixture[],\n  journal: Journal,\n  options: LiveSessionOptions,\n): () => void {\n  const { defaults, limits, testId } = options;\n  // HTTP accepts positive finite milliseconds; the connector requires whole safe milliseconds.\n  const normalizeRecordTimeout = (value: number | undefined) =>\n    Math.min(Number.MAX_SAFE_INTEGER, Math.ceil(clampTimeout(value, 30_000)));\n  const upstreamTimeoutMs = normalizeRecordTimeout(defaults.record?.upstreamTimeoutMs);\n  const bodyTimeoutMs = normalizeRecordTimeout(defaults.record?.bodyTimeoutMs);\n  const controller = new AbortController();\n  let state: \"awaiting-start\" | \"active\" | \"closing\" | \"closed\" = \"awaiting-start\";\n  let mode: LiveMode | undefined;\n  let starting = false;\n  const pending: LiveObject[] = [];\n  let pendingBytes = 0;\n  const maxPendingBytes = Math.min(\n    limits.maxBufferedBytes,\n    defaults.record?.maxProxyBufferBytes ?? DEFAULT_MAX_PROXY_BUFFER_BYTES,\n  );\n  const maxPendingFrames = defaults.record?.maxProxyBufferFrames ?? DEFAULT_MAX_PROXY_BUFFER_FRAMES;\n  let upstream: WebSocketConnection | undefined;\n  let recorder: ReturnType<typeof createLiveRecorder> | undefined;\n  let recordingSecrets: string[] = [];\n  let terminalReceived = false;\n  let captureStarted: number | undefined;\n  let recordingJournaled = false;\n  let upstreamIdle: (() => void) | undefined;\n  let replay: ReturnType<typeof createLiveReplay> | undefined;\n  const deadline = scheduleLiveTimeout(\n    () => fail(\"timeout\", \"Live session duration exceeded\"),\n    limits.maxDurationMs,\n  );\n  const startup = scheduleLiveTimeout(\n    () => fail(\"timeout\", \"Live startup deadline exceeded\"),\n    defaults.record ? upstreamTimeoutMs : limits.idleTimeoutMs,\n  );\n\n  function recordJournal(category?: LiveFailureCategory) {\n    if (recordingJournaled || !recorder) return;\n    recordingJournaled = true;\n    journal.add(\n      liveJournalSnapshot(\n        {\n          method: \"WS\",\n          path: \"/v1/live/sessions\",\n          headers: { \"x-test-id\": testId },\n          body: { model: \"gpt-live-1\", messages: [] },\n          response: {\n            status: category ? 502 : 200,\n            fixture: null,\n            source: \"proxy\",\n            ...strictOverrideField(defaults.strict, options.headers),\n            ...(category ? { error: category } : {}),\n          },\n        },\n        [...limits.secretValues, ...recordingSecrets],\n      ),\n    );\n  }\n  function cleanup() {\n    if (state === \"closed\") return;\n    state = \"closed\";\n    deadline();\n    startup();\n    upstreamIdle?.();\n    recordJournal(\"incomplete-capture\");\n    recorder?.abort();\n    upstream?.destroy();\n    pending.length = 0;\n    pendingBytes = 0;\n    replay?.close();\n    controller.abort();\n    ws.removeListener(\"message\", receive);\n    ws.removeListener(\"close\", cleanup);\n    ws.removeListener(\"error\", cleanup);\n    options.onDispose();\n  }\n  function dispose() {\n    if (state === \"closed\") return;\n    ws.close(1001, \"Live session disposed\");\n    cleanup();\n  }\n  function fail(category: LiveFailureCategory, message: string) {\n    if (state === \"closed\" || state === \"closing\") return;\n    state = \"closing\";\n    recorder?.abort(category);\n    recordJournal(category);\n    // The safe diagnostic contains no caller payload, fixture data or credential.\n    ws.send(JSON.stringify({ type: \"aimock.error\", error: { category, message } }));\n    ws.close(category === \"resource-limit\" ? 1009 : 1008, \"Live session failed\");\n    cleanup();\n  }\n  function receive(data: string) {\n    if (state === \"closed\" || state === \"closing\") return;\n    let event: LiveObject;\n    try {\n      event = validateLiveClientEvent(JSON.parse(data), limits);\n    } catch {\n      fail(\"invalid-client\", \"Invalid Live client command\");\n      return;\n    }\n    if (starting) {\n      if (event.type === \"session.start\") {\n        fail(\"invalid-client\", \"Live session has already started\");\n        return;\n      }\n      const bytes = Buffer.byteLength(data);\n      if (bytes > maxPendingBytes - pendingBytes || pending.length >= maxPendingFrames) {\n        fail(\"resource-limit\", \"Live startup input queue exceeded\");\n        return;\n      }\n      pendingBytes += bytes;\n      pending.push(event);\n      return;\n    }\n    accept(event);\n  }\n  function recordingError(error: unknown) {\n    fail(\n      error instanceof LiveRecorderError\n        ? error.category\n        : error instanceof Error && error.message === \"WebSocket write limit exceeded\"\n          ? \"resource-limit\"\n          : \"upstream-connect\",\n      \"Live recording failed\",\n    );\n  }\n  function touchUpstream() {\n    upstreamIdle?.();\n    upstreamIdle = scheduleLiveTimeout(\n      () => fail(\"timeout\", \"Live upstream idle deadline exceeded\"),\n      bodyTimeoutMs,\n    );\n  }\n  function forward(event: LiveObject) {\n    if (!upstream || !recorder || terminalReceived) return;\n    try {\n      const raw = JSON.stringify(event);\n      const now = performance.now();\n      captureStarted ??= now;\n      recorder.acceptClient(raw, Math.floor(now - captureStarted));\n      void upstream.sendAsync(raw, controller.signal).catch(recordingError);\n    } catch (error) {\n      recordingError(error);\n    }\n  }\n  async function startRecording(first: LiveObject) {\n    const record = defaults.record;\n    if (!record?.providers.openai) {\n      fail(\"fixture-mismatch\", \"No matching Live fixture\");\n      return;\n    }\n    starting = true;\n    try {\n      const base = new URL(record.providers.openai);\n      if (base.username || base.password || base.search || base.hash)\n        throw new Error(\"Invalid URL\");\n      base.pathname = base.pathname.replace(/\\/v1\\/?$/, \"/\");\n      const target = resolveUpstreamUrl(base.href, \"/v1/live/sessions\");\n      const headers: Record<string, string> = {};\n      const incoming = options.headers.authorization;\n      const credential = incoming?.match(/^\\s*(?:Bearer|Key)\\s+(.+)$/i)?.[1].trim();\n      if (incoming && !options.localApiKeys?.includes(credential ?? \"\"))\n        headers.Authorization = incoming;\n      applyProviderAuth(headers, target, \"openai\", record.providerKeys?.openai);\n      const selected = headers.Authorization?.replace(/^\\s*(?:Bearer|Key)\\s+/i, \"\").trim();\n      recordingSecrets = [...(selected ? [selected] : []), ...(options.localApiKeys ?? [])];\n      recorder = createLiveRecorder({\n        record,\n        fixtures,\n        logger: defaults.logger,\n        testId,\n        live: limits,\n        secretValues: recordingSecrets,\n        provenance: {\n          host: target.host,\n          path: \"/v1/live/sessions\",\n          observedAt: new Date().toISOString(),\n          referenceVersion: \"gpt-live-1-observed-v3\",\n          sanitationVersion: 1,\n        },\n      });\n      upstream = await connectUpstreamWebSocket(\n        target,\n        headers,\n        limits,\n        controller.signal,\n        upstreamTimeoutMs,\n      );\n      if (controller.signal.aborted) {\n        upstream.destroy();\n        return;\n      }\n      upstream.on(\"activity\", touchUpstream);\n      upstream.on(\"message\", (raw: string) => {\n        if (controller.signal.aborted) return;\n        touchUpstream();\n        try {\n          // Capture at provider arrival, before downstream backpressure settles.\n          recorder!.acceptServer(\n            raw,\n            captureStarted === undefined ? 0 : Math.floor(performance.now() - captureStarted),\n          );\n          const output: unknown = JSON.parse(raw);\n          if (!output || typeof output !== \"object\" || !(\"type\" in output))\n            throw new Error(\"Invalid event\");\n          if (output.type === \"session.started\") {\n            startup();\n            starting = false;\n            state = \"active\";\n            const queued = pending.splice(0);\n            pendingBytes = 0;\n            for (const event of queued) {\n              if (controller.signal.aborted) break;\n              accept(event);\n            }\n          }\n          const terminal = output.type === \"session.closed\";\n          if (terminal) terminalReceived = true;\n          void ws.sendAsync(raw, controller.signal).then(() => {\n            if (!terminal || controller.signal.aborted) return;\n            const result = recorder!.finish();\n            if (result.kind === \"failed\") {\n              fail(result.category, \"Live capture export failed\");\n              return;\n            }\n            recordJournal();\n            ws.close(1000, \"Live session complete\");\n            cleanup();\n          }, recordingError);\n        } catch (error) {\n          recordingError(error);\n        }\n      });\n      upstream.on(\"error\", () => fail(\"upstream-connect\", \"Live upstream connection failed\"));\n      upstream.on(\"close\", (code: number) => {\n        if (!terminalReceived)\n          fail(\n            code === 1009 ? \"resource-limit\" : \"incomplete-capture\",\n            \"Live upstream closed before completion\",\n          );\n      });\n      touchUpstream();\n      // Only startup is forwarded until the provider acknowledges the session.\n      // The bounded queue retains commands that the caller pipelined meanwhile.\n      forward(first);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : \"\";\n      if (/HTTP 401/.test(message)) fail(\"upstream-auth\", \"Live upstream authentication refused\");\n      else if (/HTTP (403|404|429)/.test(message))\n        fail(\"upstream-access\", \"Live upstream access refused\");\n      else recordingError(error);\n    }\n  }\n  function startReplay(\n    fixture: Fixture,\n    request: ChatCompletionRequest,\n    first: LiveObject,\n    raw: FixtureResponse,\n  ) {\n    if (state === \"closed\" || state === \"closing\") return;\n    try {\n      if (!isLiveResponse(raw)) throw new Error(\"not a Live fixture\");\n      const response = normalizeLiveFixture(raw, limits);\n      replay = createLiveReplay(response.live, {\n        limits,\n        signal: controller.signal,\n        timing: response.liveTiming ?? \"recorded\",\n        replaySpeed: fixture.replaySpeed ?? defaults.replaySpeed,\n        fail,\n        send: async (output) => {\n          await ws.sendAsync(JSON.stringify(output), controller.signal);\n          if (output.type === \"session.closed\" && !controller.signal.aborted) {\n            ws.close(1000, \"Live session complete\");\n            cleanup();\n          }\n        },\n      });\n    } catch {\n      fail(\"protocol-divergence\", \"Invalid Live replay configuration\");\n      return;\n    }\n    journal.add(\n      liveJournalSnapshot(\n        {\n          method: \"WS\",\n          path: \"/v1/live/sessions\",\n          headers: { ...flattenHeaders(options.headers), \"x-test-id\": testId },\n          body: request,\n          response: { status: 200, fixture },\n        },\n        limits.secretValues,\n      ),\n      fixture,\n    );\n    startup();\n    starting = false;\n    state = \"active\";\n    replay.accept(first);\n    const queued = pending.splice(0);\n    pendingBytes = 0;\n    for (const event of queued) {\n      if (controller.signal.aborted) break;\n      accept(event);\n    }\n  }\n  function accept(event: LiveObject) {\n    if (state === \"closed\" || state === \"closing\") return;\n    if (state === \"awaiting-start\") {\n      const session = object(event.session);\n      const audio = object(session?.audio);\n      const format = object(audio?.format);\n      const delegation = object(session?.delegation);\n      if (\n        event.type !== \"session.start\" ||\n        session?.model !== \"gpt-live-1\" ||\n        format?.type !== \"audio/pcm\" ||\n        format.rate !== 24000 ||\n        (delegation?.type !== \"client\" && delegation?.type !== \"responses\")\n      ) {\n        fail(\n          \"invalid-client\",\n          \"Live requires session.start with explicit model, PCM24 audio and delegation\",\n        );\n        return;\n      }\n      mode = delegation.type === \"client\" ? \"client\" : \"managed\";\n      const request: ChatCompletionRequest = {\n        model: session.model,\n        messages: [],\n        _endpointType: \"openai-live\",\n        session: structuredClone(session),\n      };\n      let fixture: Fixture | null;\n      let skippedBySequenceOrTurn: number;\n      try {\n        ({ fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n          fixtures,\n          request,\n          journal.getFixtureMatchCountsForTest(testId),\n          defaults.requestTransform,\n        ));\n      } catch {\n        fail(\"protocol-divergence\", \"Live fixture selection failed\");\n        return;\n      }\n      if (!fixture) {\n        const strict = resolveStrictMode(defaults.strict, options.headers);\n        if (strict) {\n          const message = strictNoMatchMessage(skippedBySequenceOrTurn);\n          defaults.logger.error(\n            strictNoMatchLogLine(\"WS\", \"/v1/live/sessions\", skippedBySequenceOrTurn),\n          );\n          // A rejected startup is diagnostic only: retain test ownership, never\n          // caller authorization or session content, and do not create a recorder.\n          journal.add(\n            liveJournalSnapshot(\n              {\n                method: \"WS\",\n                path: \"/v1/live/sessions\",\n                headers: { \"x-test-id\": testId },\n                body: { model: request.model, messages: [] },\n                response: {\n                  status: 503,\n                  fixture: null,\n                  ...strictOverrideField(defaults.strict, options.headers),\n                },\n              },\n              limits.secretValues,\n            ),\n          );\n          fail(\"fixture-mismatch\", message);\n        } else if (wouldProxyMiss(strict, defaults.record, \"openai\")) {\n          void startRecording(event);\n        } else {\n          fail(\"fixture-mismatch\", \"No matching Live fixture\");\n        }\n        return;\n      }\n      journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n      if (typeof fixture.response === \"function\") {\n        starting = true;\n        const selected = fixture;\n        void resolveResponse(selected, request).then(\n          (response) => startReplay(selected, request, event, response),\n          () => fail(\"protocol-divergence\", \"Live response factory failed\"),\n        );\n      } else startReplay(fixture, request, event, fixture.response);\n      return;\n    } else if (event.type === \"session.start\") {\n      fail(\"invalid-client\", \"Live session has already started\");\n      return;\n    }\n    if (event.type === \"session.update\") {\n      const patch = object(event.session);\n      const delegation = object(patch?.delegation);\n      const backend = object(delegation?.responses);\n      if (\n        mode !== \"managed\" ||\n        !patch ||\n        !delegation ||\n        !backend ||\n        Object.keys(patch).some((key) => key !== \"delegation\") ||\n        Object.keys(delegation).some((key) => key !== \"type\" && key !== \"responses\") ||\n        (delegation.type !== undefined && delegation.type !== \"responses\") ||\n        Object.keys(backend).some((key) => key !== \"instructions\") ||\n        !Object.hasOwn(backend, \"instructions\")\n      ) {\n        fail(\"invalid-client\", \"Only managed backend instructions can be updated\");\n        return;\n      }\n    }\n    // Input acceptance is synchronous; output pressure never serializes duplex input.\n    if (upstream) forward(event);\n    else replay?.accept(event);\n  }\n  ws.on(\"message\", receive);\n  ws.on(\"close\", cleanup);\n  ws.on(\"error\", cleanup);\n  return dispose;\n}\n"],"mappings":"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"}

package/dist/ws-realtime.cjs

@@ -1,9 +1,9 @@
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_constants = require('./constants.cjs');
 const require_helpers = require('./helpers.cjs');
-require('./journal.cjs');
-const require_router = require('./router.cjs');
 const require_sse_writer = require('./sse-writer.cjs');
+const require_router = require('./router.cjs');
+require('./journal.cjs');
 const require_interruption = require('./interruption.cjs');
 let node_crypto = require("node:crypto");
 
@@ -301,10 +301,54 @@ function buildErrorRealtimeEvent(ws, message, isBeta, type = "invalid_request_er
 		}
 	}, isBeta);
 }
+/**
+* OpenAI's Realtime *Beta* shape ("OpenAI-Beta: realtime=v1") no longer serves.
+* Per aimock's deprecation policy (https://aimock.copilotkit.dev/deprecation-policy/)
+* a removed upstream surface is mocked as REMOVED: a client that negotiates it
+* gets the sunset rejection the real API returns, so the removal surfaces in the
+* caller's tests instead of in production.
+*
+* Wire behaviour observed firsthand against wss://api.openai.com/v1/realtime on
+* 2026-09-15 (authenticated, `OpenAI-Beta: realtime=v1`, GA control run in the
+* same session still returned session.created):
+*
+*   HTTP/1.1 101 Switching Protocols          <- the upgrade SUCCEEDS
+*   TEXT  {"type":"error","event_id":"event_…","error":{"type":"invalid_request_error",
+*          "code":"beta_api_shape_disabled","message":"The Realtime Beta API is no
+*          longer supported. Please use /v1/realtime for the GA API.","param":null,
+*          "event_id":null}}
+*   CLOSE code=4000 reason="invalid_request_error.beta_api_shape_disabled"
+*
+* No session.created is sent. Every value below is copied from that capture —
+* none of it is inferred.
+*/
+const BETA_SUNSET_ERROR_CODE = "beta_api_shape_disabled";
+const BETA_SUNSET_MESSAGE = "The Realtime Beta API is no longer supported. Please use /v1/realtime for the GA API.";
+const BETA_SUNSET_CLOSE_CODE = 4e3;
+const BETA_SUNSET_CLOSE_REASON = `invalid_request_error.${BETA_SUNSET_ERROR_CODE}`;
+function rejectRetiredBetaShape(ws, logger) {
+	logger.warn(`WS /v1/realtime rejected the retired Realtime Beta shape (OpenAI-Beta: realtime=v1) — ${BETA_SUNSET_MESSAGE}`);
+	ws.send(JSON.stringify({
+		type: "error",
+		event_id: realtimeId("event"),
+		error: {
+			type: "invalid_request_error",
+			code: BETA_SUNSET_ERROR_CODE,
+			message: BETA_SUNSET_MESSAGE,
+			param: null,
+			event_id: null
+		}
+	}));
+	ws.close(BETA_SUNSET_CLOSE_CODE, BETA_SUNSET_CLOSE_REASON);
+}
 function handleWebSocketRealtime(ws, fixtures, journal, defaults) {
 	const { logger } = defaults;
 	const sessionId = realtimeId("sess");
 	const isBeta = defaults.upgradeHeaders?.["openai-beta"] ? String(defaults.upgradeHeaders["openai-beta"]).includes("realtime=v1") : false;
+	if (isBeta) {
+		rejectRetiredBetaShape(ws, logger);
+		return;
+	}
 	const session = {
 		model: defaults.model,
 		modalities: ["text"],