@yolk-sdk/emulators 0.1.0-canary.96

package/dist/messages.mjs

@@ -0,0 +1,532 @@
+import { emulatorRouteKey } from "./route-evidence.mjs";
+import { ChunkCount, EmulatorErrorAfterChunksFault, EmulatorScriptedError, EmulatorStatusFault, EmulatorTruncateAfterChunksFault, approximateTokens, controlError, emulatorFaultFields, isJsonObject, jsonField, jsonResponse, makeEmulatorKernel, parseJson, readText, splitFragments, stringField, synthesizeValue } from "./emulator-kernel.mjs";
+import { Predicate, Result } from "effect";
+import * as Schema from "effect/Schema";
+//#region src/messages.ts
+/**
+* Anthropic Messages emulator core (internal; not a package export).
+*
+* One `POST /v1/messages` route with request parsing (`model`, `max_tokens`, `system`,
+* `messages`, `tools`, `tool_choice`, `thinking`, `stream`), Messages SSE framing in the order
+* the real API sends it (`message_start`, then per content block `content_block_start`, its
+* deltas, and `content_block_stop`, a `ping` after the first block starts, then `message_delta`
+* with the stop reason and usage, and `message_stop`), the non-streamed `message` JSON body,
+* scripted turns, and the `{ type: 'error', error: { type, message } }` envelope. Faults, the
+* request ledger, the `/_emulate/*` control plane, evidence tagging, and route binding come from
+* the shared kernel (`emulator-kernel.ts`).
+*
+* Content blocks: `thinking` (`thinking_delta` fragments, then one `signature_delta`) when the
+* request enables thinking, `text` (`text_delta`), and `tool_use` (`input_json_delta` fragments
+* of the tool input). Stop reasons: `end_turn`, `tool_use`, and `max_tokens` (the default answer
+* is cut when it would exceed the request's `max_tokens`; scripted turns name any reason).
+*
+* Requests authenticate with a non-empty `x-api-key` (native API) or `Authorization: Bearer`
+* (OAuth) credential; neither value is ever checked or stored. They must send a supported
+* `anthropic-version` (`2023-06-01`, the value the SDK providers send); a missing or other value
+* answers 400 `invalid_request_error`. `thinking` together with a forced `tool_choice` (`tool` or
+* `any`) answers 400 as well. Other API constraints (the OAuth `anthropic-beta` header for bearer
+* credentials, `budget_tokens` limits) are not enforced.
+*
+* Runtime-portable Web APIs only (`Request`, `Response`, `ReadableStream`, `TextEncoder`, `URL`);
+* no Node builtins and no SDK imports.
+*/
+/** An Anthropic wire error: `type` (for example `overloaded_error`) and a message. */
+const MessagesWireError = Schema.Struct({
+	type: Schema.NonEmptyString,
+	message: Schema.String
+});
+/**
+* Send `chunks` SSE events, then one `event: error` event (default `overloaded_error`) and close
+* without `message_stop`. Streamed responses only; it must come before `message_stop`.
+*/
+const MessagesErrorEventFault = Schema.Struct({
+	kind: Schema.Literal("error-event-after-chunks"),
+	chunks: ChunkCount,
+	error: Schema.optionalKey(MessagesWireError),
+	...emulatorFaultFields
+});
+/**
+* Wire faults: `status` (the body defaults to an Anthropic error envelope matching the status,
+* for example `rate_limit_error` for 429 and `overloaded_error` for 529), `error-after-chunks`
+* (a dropped connection), `truncate-after-chunks` (a clean close, for example before
+* `message_stop`), and `error-event-after-chunks` (a mid-stream `error` event).
+*/
+const MessagesFault = Schema.Union([
+	EmulatorStatusFault,
+	EmulatorErrorAfterChunksFault,
+	EmulatorTruncateAfterChunksFault,
+	MessagesErrorEventFault
+]);
+const TokenCount = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
+/** Usage for a scripted turn (sent in `message_start` and `message_delta`). */
+const MessagesScriptedUsage = Schema.Struct({
+	inputTokens: TokenCount,
+	outputTokens: TokenCount
+});
+/** One scripted `tool_use` block; its JSON input streams as these `input_json_delta` fragments. */
+const MessagesScriptedToolUse = Schema.Struct({
+	name: Schema.NonEmptyString,
+	inputFragments: Schema.Array(Schema.String),
+	id: Schema.optionalKey(Schema.NonEmptyString)
+});
+/**
+* A scripted message. Every field is exact (nothing is filled in) except: a block is sent only
+* when its field is present; `usage` omitted is synthesized and `null` drops `usage` from the
+* wire; `stopReason` omitted is `tool_use` with tool uses, else `end_turn`; `order` defaults to
+* `thinking-first` (`text-first` sends the thinking block after the text).
+*/
+const MessagesScriptedMessage = Schema.Struct({
+	thinking: Schema.optionalKey(Schema.Array(Schema.String)),
+	text: Schema.optionalKey(Schema.Array(Schema.String)),
+	toolUses: Schema.optionalKey(Schema.Array(MessagesScriptedToolUse)),
+	order: Schema.optionalKey(Schema.Literals(["thinking-first", "text-first"])),
+	usage: Schema.optionalKey(Schema.NullOr(MessagesScriptedUsage)),
+	stopReason: Schema.optionalKey(Schema.NonEmptyString)
+});
+/** A turn queued for the next Messages request. */
+const MessagesScriptedTurn = Schema.Union([EmulatorScriptedError, MessagesScriptedMessage]);
+const MessagesTool = Schema.Struct({
+	name: Schema.String,
+	type: Schema.optionalKey(Schema.String),
+	description: Schema.optionalKey(Schema.String),
+	input_schema: Schema.optionalKey(Schema.Json)
+});
+const MessagesRequest = Schema.Struct({
+	model: Schema.optionalKey(Schema.String),
+	max_tokens: Schema.optionalKey(Schema.Json),
+	system: Schema.optionalKey(Schema.Json),
+	messages: Schema.Array(Schema.Json),
+	tools: Schema.optionalKey(Schema.NullOr(Schema.Array(MessagesTool))),
+	tool_choice: Schema.optionalKey(Schema.Json),
+	thinking: Schema.optionalKey(Schema.Json),
+	stream: Schema.optionalKey(Schema.NullOr(Schema.Boolean))
+});
+const decodeMessagesRequest = Schema.decodeUnknownResult(MessagesRequest);
+const bearerPattern = /^bearer\s+\S+/i;
+/** `anthropic-version` values the emulator accepts; the SDK providers send `2023-06-01` by default. */
+const supportedAnthropicVersions = ["2023-06-01"];
+const defaultText = [
+	"Hello",
+	" from the",
+	" synthetic Anthropic emulator."
+];
+const defaultThinking = ["The user wants a short greeting.", " Reply briefly."];
+const syntheticSignature = "synthetic-thinking-signature";
+const thinkingRequested = (request) => {
+	const type = stringField(request.thinking, "type");
+	return type === "enabled" || type === "adaptive";
+};
+const forcedToolUse = (request) => {
+	const choice = stringField(request.tool_choice, "type");
+	return choice === "tool" || choice === "any";
+};
+const chosenTool = (request) => {
+	const tools = request.tools ?? [];
+	const choice = stringField(request.tool_choice, "type");
+	if (tools.length === 0 || choice === "none") return;
+	const forced = choice === "tool" ? stringField(request.tool_choice, "name") : void 0;
+	return tools.find((tool) => tool.name === forced) ?? tools[0];
+};
+/**
+* Cut the plan so its synthetic output fits `maxTokens` (about four characters per token):
+* thinking and text are cut mid-fragment, a tool call that does not fit is dropped, and the stop
+* reason becomes `max_tokens`.
+*/
+const fitToMaxTokens = (plan, maxTokens) => {
+	let budget = maxTokens * 4;
+	const blocks = [];
+	for (const block of plan.blocks) {
+		const size = block.fragments.join("").length;
+		if (size <= budget) {
+			blocks.push(block);
+			budget -= size;
+			continue;
+		}
+		if (block.type !== "tool_use" && budget > 0) {
+			const fragments = [];
+			for (const fragment of block.fragments) {
+				if (budget <= 0) break;
+				fragments.push(fragment.slice(0, budget));
+				budget -= Math.min(fragment.length, budget);
+			}
+			blocks.push({
+				type: block.type,
+				fragments
+			});
+		}
+		return {
+			blocks,
+			usage: plan.usage,
+			stopReason: "max_tokens"
+		};
+	}
+	return plan;
+};
+const defaultPlan = (request, seq, maxTokens) => {
+	const thinking = thinkingRequested(request) ? [{
+		type: "thinking",
+		fragments: defaultThinking
+	}] : [];
+	const tool = chosenTool(request);
+	if (tool === void 0) return fitToMaxTokens({
+		blocks: [...thinking, {
+			type: "text",
+			fragments: defaultText
+		}],
+		usage: void 0,
+		stopReason: "end_turn"
+	}, maxTokens);
+	const input = JSON.stringify(synthesizeValue(tool.input_schema ?? { type: "object" }, tool.name, 0));
+	return fitToMaxTokens({
+		blocks: [...thinking, {
+			type: "tool_use",
+			id: `toolu_synthetic_${seq}_0`,
+			name: tool.name,
+			fragments: ["", ...splitFragments(input, 3)]
+		}],
+		usage: void 0,
+		stopReason: "tool_use"
+	}, maxTokens);
+};
+const scriptedPlan = (turn, seq) => {
+	const thinking = turn.thinking === void 0 ? [] : [{
+		type: "thinking",
+		fragments: turn.thinking
+	}];
+	const text = turn.text === void 0 ? [] : [{
+		type: "text",
+		fragments: turn.text
+	}];
+	const toolUses = (turn.toolUses ?? []).map((call, index) => ({
+		type: "tool_use",
+		id: call.id ?? `toolu_synthetic_${seq}_${index}`,
+		name: call.name,
+		fragments: call.inputFragments
+	}));
+	return {
+		blocks: turn.order === "text-first" ? [
+			...text,
+			...thinking,
+			...toolUses
+		] : [
+			...thinking,
+			...text,
+			...toolUses
+		],
+		usage: turn.usage,
+		stopReason: turn.stopReason ?? (toolUses.length > 0 ? "tool_use" : "end_turn")
+	};
+};
+const planUsage = (plan, requestText) => {
+	if (plan.usage === null) return;
+	return plan.usage ?? {
+		inputTokens: approximateTokens(requestText),
+		outputTokens: approximateTokens(plan.blocks.flatMap((block) => block.fragments).join(""))
+	};
+};
+const wireUsage = (inputTokens, outputTokens) => ({
+	input_tokens: inputTokens,
+	cache_creation_input_tokens: 0,
+	cache_read_input_tokens: 0,
+	output_tokens: outputTokens
+});
+const sseEvent = (type, payload) => `event: ${type}\ndata: ${JSON.stringify({
+	type,
+	...payload
+})}\n\n`;
+const blockStart = (block) => {
+	switch (block.type) {
+		case "thinking": return {
+			type: "thinking",
+			thinking: "",
+			signature: ""
+		};
+		case "text": return {
+			type: "text",
+			text: ""
+		};
+		case "tool_use": return {
+			type: "tool_use",
+			id: block.id,
+			name: block.name,
+			input: {}
+		};
+	}
+};
+const blockDelta = (block, fragment) => {
+	switch (block.type) {
+		case "thinking": return {
+			type: "thinking_delta",
+			thinking: fragment
+		};
+		case "text": return {
+			type: "text_delta",
+			text: fragment
+		};
+		case "tool_use": return {
+			type: "input_json_delta",
+			partial_json: fragment
+		};
+	}
+};
+/** SSE events for a streamed message, one network chunk each, in the real API's order. */
+const streamEvents = (plan, identity, usage) => {
+	const message = {
+		id: identity.id,
+		type: "message",
+		role: "assistant",
+		model: identity.model,
+		content: [],
+		stop_reason: null,
+		stop_sequence: null
+	};
+	if (usage !== void 0) message.usage = wireUsage(usage.inputTokens, 1);
+	const events = [sseEvent("message_start", { message })];
+	const ping = sseEvent("ping", {});
+	plan.blocks.forEach((block, index) => {
+		events.push(sseEvent("content_block_start", {
+			index,
+			content_block: blockStart(block)
+		}));
+		if (index === 0) events.push(ping);
+		for (const fragment of block.fragments) events.push(sseEvent("content_block_delta", {
+			index,
+			delta: blockDelta(block, fragment)
+		}));
+		if (block.type === "thinking") events.push(sseEvent("content_block_delta", {
+			index,
+			delta: {
+				type: "signature_delta",
+				signature: syntheticSignature
+			}
+		}));
+		events.push(sseEvent("content_block_stop", { index }));
+	});
+	if (plan.blocks.length === 0) events.push(ping);
+	const messageDelta = { delta: {
+		stop_reason: plan.stopReason,
+		stop_sequence: null
+	} };
+	if (usage !== void 0) messageDelta.usage = wireUsage(usage.inputTokens, usage.outputTokens);
+	events.push(sseEvent("message_delta", messageDelta));
+	events.push(sseEvent("message_stop", {}));
+	return events;
+};
+/** The JSON value of a tool input; throws (answering an emulator 500) when it is not JSON. */
+const toolInput = (fragments) => {
+	const text = fragments.join("");
+	const parsed = text.trim().length === 0 ? {} : parseJson(text);
+	if (parsed === void 0) throw new Error("scripted tool input is not JSON");
+	return parsed;
+};
+/** The non-streamed `message` JSON body. */
+const messageBody = (plan, identity, usage) => {
+	const content = plan.blocks.map((block) => {
+		switch (block.type) {
+			case "thinking": return {
+				type: "thinking",
+				thinking: block.fragments.join(""),
+				signature: syntheticSignature
+			};
+			case "text": return {
+				type: "text",
+				text: block.fragments.join("")
+			};
+			case "tool_use": return {
+				type: "tool_use",
+				id: block.id,
+				name: block.name,
+				input: toolInput(block.fragments)
+			};
+		}
+	});
+	const body = {
+		id: identity.id,
+		type: "message",
+		role: "assistant",
+		model: identity.model,
+		content,
+		stop_reason: plan.stopReason,
+		stop_sequence: null
+	};
+	if (usage !== void 0) body.usage = wireUsage(usage.inputTokens, usage.outputTokens);
+	return body;
+};
+/** The Anthropic error envelope. */
+const messagesErrorEnvelope = (error) => ({
+	type: "error",
+	error: {
+		type: error.type,
+		message: error.message
+	}
+});
+const errorTypeForStatus = (status) => {
+	switch (status) {
+		case 400: return "invalid_request_error";
+		case 401: return "authentication_error";
+		case 402: return "billing_error";
+		case 403: return "permission_error";
+		case 404: return "not_found_error";
+		case 413: return "request_too_large";
+		case 429: return "rate_limit_error";
+		case 529: return "overloaded_error";
+		default: return "api_error";
+	}
+};
+const defaultFaultMessage = (status) => {
+	switch (status) {
+		case 429: return "Synthetic rate limit: too many requests.";
+		case 529: return "Synthetic: overloaded.";
+		default: return `Synthetic upstream error (${status}).`;
+	}
+};
+const defaultFaultBody = (status) => messagesErrorEnvelope({
+	type: errorTypeForStatus(status),
+	message: defaultFaultMessage(status)
+});
+const defaultErrorEvent = {
+	type: "overloaded_error",
+	message: "Synthetic: overloaded."
+};
+const credentialHeaderOf = (request) => {
+	if ((request.headers.get("x-api-key") ?? "").trim().length > 0) return "x-api-key";
+	return bearerPattern.test(request.headers.get("authorization") ?? "") ? "authorization" : void 0;
+};
+const isPositiveInteger = (value) => Predicate.isNumber(value) && Number.isSafeInteger(value) && value > 0;
+/**
+* Create a Messages emulator from its config. Each call has independent ledger, fault, and
+* script state.
+*
+* Precedence per request: authentication, a supported `anthropic-version`, JSON and request
+* validation (including a positive integer `max_tokens`, and no `thinking` with a forced
+* `tool_choice`), then the first matching fault if it is a `status` fault, then the next
+* scripted turn, then model validation and defaults; a first matching body fault then shapes the
+* body. Only the first matching fault (in insertion order) applies. Credential headers are never
+* recorded, and credential values are never checked or stored.
+*/
+const makeMessagesEmulator = (config) => {
+	const knownModels = [...config.knownModels];
+	const errorResponse = (status, error) => jsonResponse(status, messagesErrorEnvelope(error));
+	const invalidRequest = (message) => errorResponse(400, {
+		type: "invalid_request_error",
+		message
+	});
+	const kernel = makeEmulatorKernel({
+		routes: config.routes,
+		faultSchema: MessagesFault,
+		turnSchema: MessagesScriptedTurn,
+		newEntry: (base) => ({
+			...base,
+			toolNames: []
+		}),
+		snapshotEntry: (entry) => ({
+			...entry,
+			toolNames: [...entry.toolNames]
+		}),
+		unknownRoute: () => errorResponse(404, {
+			type: "not_found_error",
+			message: "Synthetic: no emulated route."
+		}),
+		stateFields: () => ({ knownModels }),
+		inputInvalid: config.inputInvalid
+	});
+	const messages = async (request, entry, path) => {
+		const credentialHeader = credentialHeaderOf(request);
+		if (credentialHeader === void 0) {
+			entry.status = 401;
+			return errorResponse(401, {
+				type: "authentication_error",
+				message: "Synthetic: an x-api-key header or a bearer credential is required."
+			});
+		}
+		entry.credentialHeader = credentialHeader;
+		const version = request.headers.get("anthropic-version");
+		const beta = request.headers.get("anthropic-beta");
+		if (version !== null) entry.anthropicVersion = version;
+		if (beta !== null) entry.anthropicBeta = beta;
+		if (version === null || !supportedAnthropicVersions.includes(version)) {
+			entry.status = 400;
+			return invalidRequest(version === null ? "Synthetic: the anthropic-version header is required." : "Synthetic: the anthropic-version header value is not supported.");
+		}
+		const text = await readText(request);
+		const json = text === void 0 ? void 0 : parseJson(text);
+		if (text === void 0 || json === void 0) {
+			entry.status = 400;
+			return invalidRequest("Synthetic: the request body is not valid JSON.");
+		}
+		entry.body = json;
+		const decoded = decodeMessagesRequest(json);
+		if (Result.isFailure(decoded) || !isJsonObject(json)) {
+			entry.status = 400;
+			return invalidRequest("Synthetic: the request body is not a Messages request.");
+		}
+		const body = decoded.success;
+		const seq = entry.seq;
+		if (body.model !== void 0) entry.model = body.model;
+		entry.stream = body.stream === true;
+		entry.toolNames = (body.tools ?? []).map((tool) => tool.name);
+		if (Predicate.isNumber(body.max_tokens)) entry.maxTokens = body.max_tokens;
+		if (body.thinking !== void 0) entry.thinking = body.thinking;
+		if (body.tool_choice !== void 0) entry.toolChoice = body.tool_choice;
+		const maxTokens = jsonField(json, "max_tokens");
+		if (!isPositiveInteger(maxTokens)) {
+			entry.status = 400;
+			return invalidRequest("Synthetic: max_tokens must be a positive integer.");
+		}
+		if (thinkingRequested(body) && forcedToolUse(body)) {
+			entry.status = 400;
+			return invalidRequest("Synthetic: thinking may not be enabled when tool_choice forces tool use.");
+		}
+		const fault = kernel.takeFault(path, body.model);
+		if (fault !== void 0 && fault.fault.kind === "status") return kernel.respondWithStatusFault(entry, fault, fault.fault, defaultFaultBody);
+		const errorEventFault = fault !== void 0 && fault.fault.kind === "error-event-after-chunks" ? {
+			state: fault,
+			fault: fault.fault
+		} : void 0;
+		const cannotApply = (problem) => {
+			entry.faultError = problem;
+			entry.status = 500;
+			return controlError(500, `emulator fault cannot apply: ${problem}`);
+		};
+		const turn = kernel.nextTurn();
+		if (turn !== void 0 && "error" in turn) {
+			entry.scripted = "error";
+			if (errorEventFault !== void 0) return cannotApply("error-event-after-chunks cannot apply to a scripted error");
+			return kernel.respondWithScriptedError(entry, turn.error, fault);
+		}
+		if (turn === void 0 && (body.model === void 0 || !knownModels.includes(body.model))) {
+			entry.status = 404;
+			return errorResponse(404, {
+				type: "not_found_error",
+				message: "Synthetic placeholder: the requested model was not found."
+			});
+		}
+		if (turn !== void 0) entry.scripted = "message";
+		const plan = turn === void 0 ? defaultPlan(body, seq, maxTokens) : scriptedPlan(turn, seq);
+		const identity = {
+			id: `msg_synthetic_${seq}`,
+			model: body.model ?? "unknown"
+		};
+		const usage = planUsage(plan, text);
+		if (body.stream !== true) {
+			if (errorEventFault !== void 0) return cannotApply("error-event-after-chunks cannot apply to a non-streamed response");
+			return kernel.respondWithBody(entry, 200, { "content-type": "application/json" }, [JSON.stringify(messageBody(plan, identity, usage))], fault);
+		}
+		const events = streamEvents(plan, identity, usage);
+		const headers = {
+			"content-type": "text/event-stream",
+			"cache-control": "no-cache"
+		};
+		if (errorEventFault === void 0) return kernel.respondWithBody(entry, 200, headers, events, fault);
+		const after = errorEventFault.fault.chunks;
+		if (after >= events.length) return cannotApply(`error-event-after-chunks after ${after} chunk(s) cannot apply to a response with ${events.length} chunk(s)`);
+		const response = kernel.respondWithBody(entry, 200, headers, [...events.slice(0, after), sseEvent("error", { error: { ...errorEventFault.fault.error ?? defaultErrorEvent } })], void 0);
+		kernel.consumeFault(errorEventFault.state, entry);
+		return response;
+	};
+	return kernel.serve(new Map([[emulatorRouteKey("POST", config.path), messages]]));
+};
+//#endregion
+export { MessagesErrorEventFault, MessagesFault, MessagesScriptedMessage, MessagesScriptedToolUse, MessagesScriptedTurn, MessagesScriptedUsage, MessagesWireError, makeMessagesEmulator, messagesErrorEnvelope };
+
+//# sourceMappingURL=messages.mjs.map

package/dist/messages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.mjs","names":[],"sources":["../src/messages.ts"],"sourcesContent":["/**\n * Anthropic Messages emulator core (internal; not a package export).\n *\n * One `POST /v1/messages` route with request parsing (`model`, `max_tokens`, `system`,\n * `messages`, `tools`, `tool_choice`, `thinking`, `stream`), Messages SSE framing in the order\n * the real API sends it (`message_start`, then per content block `content_block_start`, its\n * deltas, and `content_block_stop`, a `ping` after the first block starts, then `message_delta`\n * with the stop reason and usage, and `message_stop`), the non-streamed `message` JSON body,\n * scripted turns, and the `{ type: 'error', error: { type, message } }` envelope. Faults, the\n * request ledger, the `/_emulate/*` control plane, evidence tagging, and route binding come from\n * the shared kernel (`emulator-kernel.ts`).\n *\n * Content blocks: `thinking` (`thinking_delta` fragments, then one `signature_delta`) when the\n * request enables thinking, `text` (`text_delta`), and `tool_use` (`input_json_delta` fragments\n * of the tool input). Stop reasons: `end_turn`, `tool_use`, and `max_tokens` (the default answer\n * is cut when it would exceed the request's `max_tokens`; scripted turns name any reason).\n *\n * Requests authenticate with a non-empty `x-api-key` (native API) or `Authorization: Bearer`\n * (OAuth) credential; neither value is ever checked or stored. They must send a supported\n * `anthropic-version` (`2023-06-01`, the value the SDK providers send); a missing or other value\n * answers 400 `invalid_request_error`. `thinking` together with a forced `tool_choice` (`tool` or\n * `any`) answers 400 as well. Other API constraints (the OAuth `anthropic-beta` header for bearer\n * credentials, `budget_tokens` limits) are not enforced.\n *\n * Runtime-portable Web APIs only (`Request`, `Response`, `ReadableStream`, `TextEncoder`, `URL`);\n * no Node builtins and no SDK imports.\n */\nimport { Predicate, Result } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport {\n  approximateTokens,\n  ChunkCount,\n  controlError,\n  EmulatorErrorAfterChunksFault,\n  emulatorFaultFields,\n  EmulatorScriptedError,\n  EmulatorStatusFault,\n  EmulatorTruncateAfterChunksFault,\n  isJsonObject,\n  jsonField,\n  jsonResponse,\n  makeEmulatorKernel,\n  parseJson,\n  readText,\n  splitFragments,\n  stringField,\n  synthesizeValue,\n  type EmulatorApi,\n  type KernelLedgerEntry\n} from './emulator-kernel.ts'\nimport {\n  emulatorRouteKey,\n  type EmulatorEvidence,\n  type EmulatorRouteEvidence\n} from './route-evidence.ts'\n\n/** An Anthropic wire error: `type` (for example `overloaded_error`) and a message. */\nexport const MessagesWireError = Schema.Struct({\n  type: Schema.NonEmptyString,\n  message: Schema.String\n})\n\nexport type MessagesWireError = typeof MessagesWireError.Type\n\n/**\n * Send `chunks` SSE events, then one `event: error` event (default `overloaded_error`) and close\n * without `message_stop`. Streamed responses only; it must come before `message_stop`.\n */\nexport const MessagesErrorEventFault = Schema.Struct({\n  kind: Schema.Literal('error-event-after-chunks'),\n  chunks: ChunkCount,\n  error: Schema.optionalKey(MessagesWireError),\n  ...emulatorFaultFields\n})\n\n/**\n * Wire faults: `status` (the body defaults to an Anthropic error envelope matching the status,\n * for example `rate_limit_error` for 429 and `overloaded_error` for 529), `error-after-chunks`\n * (a dropped connection), `truncate-after-chunks` (a clean close, for example before\n * `message_stop`), and `error-event-after-chunks` (a mid-stream `error` event).\n */\nexport const MessagesFault = Schema.Union([\n  EmulatorStatusFault,\n  EmulatorErrorAfterChunksFault,\n  EmulatorTruncateAfterChunksFault,\n  MessagesErrorEventFault\n])\n\nexport type MessagesFault = typeof MessagesFault.Type\n\nexport type MessagesFaultKind = MessagesFault['kind']\n\nconst TokenCount = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0))\n\n/** Usage for a scripted turn (sent in `message_start` and `message_delta`). */\nexport const MessagesScriptedUsage = Schema.Struct({\n  inputTokens: TokenCount,\n  outputTokens: TokenCount\n})\n\nexport type MessagesScriptedUsage = typeof MessagesScriptedUsage.Type\n\n/** One scripted `tool_use` block; its JSON input streams as these `input_json_delta` fragments. */\nexport const MessagesScriptedToolUse = Schema.Struct({\n  name: Schema.NonEmptyString,\n  inputFragments: Schema.Array(Schema.String),\n  id: Schema.optionalKey(Schema.NonEmptyString)\n})\n\nexport type MessagesScriptedToolUse = typeof MessagesScriptedToolUse.Type\n\n/**\n * A scripted message. Every field is exact (nothing is filled in) except: a block is sent only\n * when its field is present; `usage` omitted is synthesized and `null` drops `usage` from the\n * wire; `stopReason` omitted is `tool_use` with tool uses, else `end_turn`; `order` defaults to\n * `thinking-first` (`text-first` sends the thinking block after the text).\n */\nexport const MessagesScriptedMessage = Schema.Struct({\n  thinking: Schema.optionalKey(Schema.Array(Schema.String)),\n  text: Schema.optionalKey(Schema.Array(Schema.String)),\n  toolUses: Schema.optionalKey(Schema.Array(MessagesScriptedToolUse)),\n  order: Schema.optionalKey(Schema.Literals(['thinking-first', 'text-first'])),\n  usage: Schema.optionalKey(Schema.NullOr(MessagesScriptedUsage)),\n  stopReason: Schema.optionalKey(Schema.NonEmptyString)\n})\n\nexport type MessagesScriptedMessage = typeof MessagesScriptedMessage.Type\n\n/** A turn queued for the next Messages request. */\nexport const MessagesScriptedTurn = Schema.Union([EmulatorScriptedError, MessagesScriptedMessage])\n\nexport type MessagesScriptedTurn = typeof MessagesScriptedTurn.Type\n\nexport type MessagesLedgerEntry = {\n  /** 1-based arrival order since the last ledger clear or reset. */\n  readonly seq: number\n  readonly method: string\n  readonly path: string\n  /** Parsed JSON request body, when it was valid JSON. */\n  readonly body?: Schema.Json\n  readonly model?: string\n  readonly stream?: boolean\n  /** The request's `max_tokens`, when it is a number (non-positive or fractional answers 400). */\n  readonly maxTokens?: number\n  readonly thinking?: Schema.Json\n  readonly toolChoice?: Schema.Json\n  readonly toolNames: ReadonlyArray<string>\n  /** Which header carried the credential (the value is never recorded). */\n  readonly credentialHeader?: 'x-api-key' | 'authorization'\n  readonly anthropicVersion?: string\n  readonly anthropicBeta?: string\n  /** Kind of the fault that shaped the response. */\n  readonly fault?: MessagesFaultKind\n  /** Why a matching fault could not take effect (the response was a 500 emulator error). */\n  readonly faultError?: string\n  /**\n   * Set when the emulator could not build the planned response; the request was answered with a\n   * 500 emulator error (still evidence-tagged) and no fault was used up.\n   */\n  readonly responseError?: string\n  /** Set when a scripted turn answered the request. */\n  readonly scripted?: 'message' | 'error'\n  /** Evidence of the matched route; `unknown-route` for requests that failed closed. */\n  readonly evidence: EmulatorEvidence | 'unknown-route'\n  readonly status: number\n  /** Body chunks handed to the transport so far (each produced when pulled). */\n  readonly bodyChunks: number\n}\n\nexport type MessagesEmulator = EmulatorApi<MessagesScriptedTurn, MessagesFault, MessagesLedgerEntry>\n\nexport type MessagesEmulatorConfig = {\n  /** The Messages path, for example `/v1/messages`. */\n  readonly path: string\n  /** Route evidence manifest; must list exactly the Messages route. */\n  readonly routes: ReadonlyArray<EmulatorRouteEvidence>\n  readonly knownModels: ReadonlyArray<string>\n  /** Builds the error thrown by the JS API (`faults.add`, `script.enqueue`) for invalid input. */\n  readonly inputInvalid: (input: 'fault' | 'turn', reason: string) => Error\n}\n\nconst MessagesTool = Schema.Struct({\n  name: Schema.String,\n  type: Schema.optionalKey(Schema.String),\n  description: Schema.optionalKey(Schema.String),\n  input_schema: Schema.optionalKey(Schema.Json)\n})\n\nconst MessagesRequest = Schema.Struct({\n  model: Schema.optionalKey(Schema.String),\n  max_tokens: Schema.optionalKey(Schema.Json),\n  system: Schema.optionalKey(Schema.Json),\n  messages: Schema.Array(Schema.Json),\n  tools: Schema.optionalKey(Schema.NullOr(Schema.Array(MessagesTool))),\n  tool_choice: Schema.optionalKey(Schema.Json),\n  thinking: Schema.optionalKey(Schema.Json),\n  stream: Schema.optionalKey(Schema.NullOr(Schema.Boolean))\n})\n\ntype MessagesRequest = typeof MessagesRequest.Type\n\nconst decodeMessagesRequest = Schema.decodeUnknownResult(MessagesRequest)\n\n// A non-empty bearer credential. The value is never checked or stored.\nconst bearerPattern = /^bearer\\s+\\S+/i\n\n/** `anthropic-version` values the emulator accepts; the SDK providers send `2023-06-01` by default. */\nconst supportedAnthropicVersions: ReadonlyArray<string> = ['2023-06-01']\n\nconst defaultText = ['Hello', ' from the', ' synthetic Anthropic emulator.']\n\nconst defaultThinking = ['The user wants a short greeting.', ' Reply briefly.']\n\n// Opaque placeholder for the thinking-block signature the real API sends.\nconst syntheticSignature = 'synthetic-thinking-signature'\n\ntype BlockPlan =\n  | { readonly type: 'thinking'; readonly fragments: ReadonlyArray<string> }\n  | { readonly type: 'text'; readonly fragments: ReadonlyArray<string> }\n  | {\n      readonly type: 'tool_use'\n      readonly id: string\n      readonly name: string\n      readonly fragments: ReadonlyArray<string>\n    }\n\ntype MessagePlan = {\n  readonly blocks: ReadonlyArray<BlockPlan>\n  /** `null`: never send usage; `undefined`: synthesize. */\n  readonly usage: MessagesScriptedUsage | null | undefined\n  readonly stopReason: string\n}\n\nconst thinkingRequested = (request: MessagesRequest): boolean => {\n  const type = stringField(request.thinking, 'type')\n\n  return type === 'enabled' || type === 'adaptive'\n}\n\n// The real API rejects extended thinking when `tool_choice` forces tool use.\nconst forcedToolUse = (request: MessagesRequest): boolean => {\n  const choice = stringField(request.tool_choice, 'type')\n\n  return choice === 'tool' || choice === 'any'\n}\n\nconst chosenTool = (request: MessagesRequest) => {\n  const tools = request.tools ?? []\n  const choice = stringField(request.tool_choice, 'type')\n\n  if (tools.length === 0 || choice === 'none') {\n    return undefined\n  }\n\n  const forced = choice === 'tool' ? stringField(request.tool_choice, 'name') : undefined\n\n  return tools.find(tool => tool.name === forced) ?? tools[0]\n}\n\n/**\n * Cut the plan so its synthetic output fits `maxTokens` (about four characters per token):\n * thinking and text are cut mid-fragment, a tool call that does not fit is dropped, and the stop\n * reason becomes `max_tokens`.\n */\nconst fitToMaxTokens = (plan: MessagePlan, maxTokens: number): MessagePlan => {\n  let budget = maxTokens * 4\n  const blocks: Array<BlockPlan> = []\n\n  for (const block of plan.blocks) {\n    const size = block.fragments.join('').length\n\n    if (size <= budget) {\n      blocks.push(block)\n      budget -= size\n\n      continue\n    }\n\n    if (block.type !== 'tool_use' && budget > 0) {\n      const fragments: Array<string> = []\n\n      for (const fragment of block.fragments) {\n        if (budget <= 0) break\n\n        fragments.push(fragment.slice(0, budget))\n        budget -= Math.min(fragment.length, budget)\n      }\n\n      blocks.push({ type: block.type, fragments })\n    }\n\n    return { blocks, usage: plan.usage, stopReason: 'max_tokens' }\n  }\n\n  return plan\n}\n\nconst defaultPlan = (request: MessagesRequest, seq: number, maxTokens: number): MessagePlan => {\n  const thinking: ReadonlyArray<BlockPlan> = thinkingRequested(request)\n    ? [{ type: 'thinking', fragments: defaultThinking }]\n    : []\n\n  const tool = chosenTool(request)\n\n  if (tool === undefined) {\n    return fitToMaxTokens(\n      {\n        blocks: [...thinking, { type: 'text', fragments: defaultText }],\n        usage: undefined,\n        stopReason: 'end_turn'\n      },\n      maxTokens\n    )\n  }\n\n  const input = JSON.stringify(\n    synthesizeValue(tool.input_schema ?? { type: 'object' }, tool.name, 0)\n  )\n\n  return fitToMaxTokens(\n    {\n      blocks: [\n        ...thinking,\n        {\n          type: 'tool_use',\n          id: `toolu_synthetic_${seq}_0`,\n          name: tool.name,\n          // Emulator choice (unverified): open the input with an empty `partial_json` fragment.\n          fragments: ['', ...splitFragments(input, 3)]\n        }\n      ],\n      usage: undefined,\n      stopReason: 'tool_use'\n    },\n    maxTokens\n  )\n}\n\nconst scriptedPlan = (turn: MessagesScriptedMessage, seq: number): MessagePlan => {\n  const thinking: ReadonlyArray<BlockPlan> =\n    turn.thinking === undefined ? [] : [{ type: 'thinking', fragments: turn.thinking }]\n\n  const text: ReadonlyArray<BlockPlan> =\n    turn.text === undefined ? [] : [{ type: 'text', fragments: turn.text }]\n\n  const toolUses = (turn.toolUses ?? []).map((call, index): BlockPlan => ({\n    type: 'tool_use',\n    id: call.id ?? `toolu_synthetic_${seq}_${index}`,\n    name: call.name,\n    fragments: call.inputFragments\n  }))\n\n  return {\n    blocks:\n      turn.order === 'text-first'\n        ? [...text, ...thinking, ...toolUses]\n        : [...thinking, ...text, ...toolUses],\n    usage: turn.usage,\n    stopReason: turn.stopReason ?? (toolUses.length > 0 ? 'tool_use' : 'end_turn')\n  }\n}\n\ntype PlanUsage = { readonly inputTokens: number; readonly outputTokens: number } | undefined\n\nconst planUsage = (plan: MessagePlan, requestText: string): PlanUsage => {\n  if (plan.usage === null) {\n    return undefined\n  }\n\n  return (\n    plan.usage ?? {\n      inputTokens: approximateTokens(requestText),\n      outputTokens: approximateTokens(plan.blocks.flatMap(block => block.fragments).join(''))\n    }\n  )\n}\n\ntype ResponseIdentity = { readonly id: string; readonly model: string }\n\n// Wire shapes of the Messages responses the emulator sends.\ntype WireUsage = {\n  readonly input_tokens: number\n  readonly cache_creation_input_tokens: number\n  readonly cache_read_input_tokens: number\n  readonly output_tokens: number\n}\n\ntype WireMessage = {\n  readonly id: string\n  readonly type: 'message'\n  readonly role: 'assistant'\n  readonly model: string\n  readonly content: ReadonlyArray<Schema.JsonObject>\n  readonly stop_reason: string | null\n  readonly stop_sequence: null\n  usage?: WireUsage\n}\n\ntype WireMessageDelta = {\n  readonly delta: { readonly stop_reason: string; readonly stop_sequence: null }\n  usage?: WireUsage\n}\n\nconst wireUsage = (inputTokens: number, outputTokens: number): WireUsage => ({\n  input_tokens: inputTokens,\n  cache_creation_input_tokens: 0,\n  cache_read_input_tokens: 0,\n  output_tokens: outputTokens\n})\n\nconst sseEvent = (type: string, payload: Schema.JsonObject): string =>\n  `event: ${type}\\ndata: ${JSON.stringify({ type, ...payload })}\\n\\n`\n\nconst blockStart = (block: BlockPlan): Schema.JsonObject => {\n  switch (block.type) {\n    case 'thinking':\n      return { type: 'thinking', thinking: '', signature: '' }\n    case 'text':\n      return { type: 'text', text: '' }\n    case 'tool_use':\n      return { type: 'tool_use', id: block.id, name: block.name, input: {} }\n  }\n}\n\nconst blockDelta = (block: BlockPlan, fragment: string): Schema.JsonObject => {\n  switch (block.type) {\n    case 'thinking':\n      return { type: 'thinking_delta', thinking: fragment }\n    case 'text':\n      return { type: 'text_delta', text: fragment }\n    case 'tool_use':\n      return { type: 'input_json_delta', partial_json: fragment }\n  }\n}\n\n/** SSE events for a streamed message, one network chunk each, in the real API's order. */\nconst streamEvents = (\n  plan: MessagePlan,\n  identity: ResponseIdentity,\n  usage: PlanUsage\n): ReadonlyArray<string> => {\n  const message: WireMessage = {\n    id: identity.id,\n    type: 'message',\n    role: 'assistant',\n    model: identity.model,\n    content: [],\n    stop_reason: null,\n    stop_sequence: null\n  }\n\n  if (usage !== undefined) {\n    message.usage = wireUsage(usage.inputTokens, 1)\n  }\n\n  const events: Array<string> = [sseEvent('message_start', { message })]\n  const ping = sseEvent('ping', {})\n\n  plan.blocks.forEach((block, index) => {\n    events.push(sseEvent('content_block_start', { index, content_block: blockStart(block) }))\n\n    if (index === 0) {\n      events.push(ping)\n    }\n\n    for (const fragment of block.fragments) {\n      events.push(sseEvent('content_block_delta', { index, delta: blockDelta(block, fragment) }))\n    }\n\n    if (block.type === 'thinking') {\n      events.push(\n        sseEvent('content_block_delta', {\n          index,\n          delta: { type: 'signature_delta', signature: syntheticSignature }\n        })\n      )\n    }\n\n    events.push(sseEvent('content_block_stop', { index }))\n  })\n\n  if (plan.blocks.length === 0) {\n    events.push(ping)\n  }\n\n  const messageDelta: WireMessageDelta = {\n    delta: { stop_reason: plan.stopReason, stop_sequence: null }\n  }\n\n  // Same usage shape as the committed fixtures: input and cache counts alongside the cumulative\n  // `output_tokens`. Unverified until a live recording confirms it.\n  if (usage !== undefined) {\n    messageDelta.usage = wireUsage(usage.inputTokens, usage.outputTokens)\n  }\n\n  events.push(sseEvent('message_delta', messageDelta))\n  events.push(sseEvent('message_stop', {}))\n\n  return events\n}\n\n/** The JSON value of a tool input; throws (answering an emulator 500) when it is not JSON. */\nconst toolInput = (fragments: ReadonlyArray<string>): Schema.Json => {\n  const text = fragments.join('')\n  const parsed = text.trim().length === 0 ? {} : parseJson(text)\n\n  if (parsed === undefined) {\n    throw new Error('scripted tool input is not JSON')\n  }\n\n  return parsed\n}\n\n/** The non-streamed `message` JSON body. */\nconst messageBody = (\n  plan: MessagePlan,\n  identity: ResponseIdentity,\n  usage: PlanUsage\n): WireMessage => {\n  const content = plan.blocks.map((block): Schema.JsonObject => {\n    switch (block.type) {\n      case 'thinking':\n        return {\n          type: 'thinking',\n          thinking: block.fragments.join(''),\n          signature: syntheticSignature\n        }\n      case 'text':\n        return { type: 'text', text: block.fragments.join('') }\n      case 'tool_use':\n        return {\n          type: 'tool_use',\n          id: block.id,\n          name: block.name,\n          input: toolInput(block.fragments)\n        }\n    }\n  })\n\n  const body: WireMessage = {\n    id: identity.id,\n    type: 'message',\n    role: 'assistant',\n    model: identity.model,\n    content,\n    stop_reason: plan.stopReason,\n    stop_sequence: null\n  }\n\n  if (usage !== undefined) {\n    body.usage = wireUsage(usage.inputTokens, usage.outputTokens)\n  }\n\n  return body\n}\n\n/** The Anthropic error envelope. */\nexport const messagesErrorEnvelope = (error: MessagesWireError): Schema.JsonObject => ({\n  type: 'error',\n  error: { type: error.type, message: error.message }\n})\n\nconst errorTypeForStatus = (status: number): string => {\n  switch (status) {\n    case 400:\n      return 'invalid_request_error'\n    case 401:\n      return 'authentication_error'\n    case 402:\n      return 'billing_error'\n    case 403:\n      return 'permission_error'\n    case 404:\n      return 'not_found_error'\n    case 413:\n      return 'request_too_large'\n    case 429:\n      return 'rate_limit_error'\n    case 529:\n      return 'overloaded_error'\n    default:\n      return 'api_error'\n  }\n}\n\nconst defaultFaultMessage = (status: number): string => {\n  switch (status) {\n    case 429:\n      return 'Synthetic rate limit: too many requests.'\n    case 529:\n      return 'Synthetic: overloaded.'\n    default:\n      return `Synthetic upstream error (${status}).`\n  }\n}\n\nconst defaultFaultBody = (status: number): Schema.Json =>\n  messagesErrorEnvelope({ type: errorTypeForStatus(status), message: defaultFaultMessage(status) })\n\nconst defaultErrorEvent: MessagesWireError = {\n  type: 'overloaded_error',\n  message: 'Synthetic: overloaded.'\n}\n\ntype MutableLedgerEntry = KernelLedgerEntry<MessagesFaultKind> & {\n  body?: Schema.Json\n  model?: string\n  stream?: boolean\n  maxTokens?: number\n  thinking?: Schema.Json\n  toolChoice?: Schema.Json\n  toolNames: ReadonlyArray<string>\n  credentialHeader?: 'x-api-key' | 'authorization'\n  anthropicVersion?: string\n  anthropicBeta?: string\n  scripted?: 'message' | 'error'\n}\n\nconst credentialHeaderOf = (request: Request): 'x-api-key' | 'authorization' | undefined => {\n  if ((request.headers.get('x-api-key') ?? '').trim().length > 0) {\n    return 'x-api-key'\n  }\n\n  return bearerPattern.test(request.headers.get('authorization') ?? '')\n    ? 'authorization'\n    : undefined\n}\n\nconst isPositiveInteger = (value: Schema.Json | undefined): value is number =>\n  Predicate.isNumber(value) && Number.isSafeInteger(value) && value > 0\n\n/**\n * Create a Messages emulator from its config. Each call has independent ledger, fault, and\n * script state.\n *\n * Precedence per request: authentication, a supported `anthropic-version`, JSON and request\n * validation (including a positive integer `max_tokens`, and no `thinking` with a forced\n * `tool_choice`), then the first matching fault if it is a `status` fault, then the next\n * scripted turn, then model validation and defaults; a first matching body fault then shapes the\n * body. Only the first matching fault (in insertion order) applies. Credential headers are never\n * recorded, and credential values are never checked or stored.\n */\nexport const makeMessagesEmulator = (config: MessagesEmulatorConfig): MessagesEmulator => {\n  const knownModels = [...config.knownModels]\n\n  const errorResponse = (status: number, error: MessagesWireError): Response =>\n    jsonResponse(status, messagesErrorEnvelope(error))\n\n  const invalidRequest = (message: string): Response =>\n    errorResponse(400, { type: 'invalid_request_error', message })\n\n  const kernel = makeEmulatorKernel({\n    routes: config.routes,\n    faultSchema: MessagesFault,\n    turnSchema: MessagesScriptedTurn,\n    newEntry: (base): MutableLedgerEntry => ({ ...base, toolNames: [] }),\n    snapshotEntry: (entry): MessagesLedgerEntry => ({ ...entry, toolNames: [...entry.toolNames] }),\n    unknownRoute: () =>\n      errorResponse(404, { type: 'not_found_error', message: 'Synthetic: no emulated route.' }),\n    stateFields: () => ({ knownModels }),\n    inputInvalid: config.inputInvalid\n  })\n\n  const messages = async (\n    request: Request,\n    entry: MutableLedgerEntry,\n    path: string\n  ): Promise<Response> => {\n    const credentialHeader = credentialHeaderOf(request)\n\n    if (credentialHeader === undefined) {\n      entry.status = 401\n\n      return errorResponse(401, {\n        type: 'authentication_error',\n        message: 'Synthetic: an x-api-key header or a bearer credential is required.'\n      })\n    }\n\n    entry.credentialHeader = credentialHeader\n\n    const version = request.headers.get('anthropic-version')\n    const beta = request.headers.get('anthropic-beta')\n\n    if (version !== null) entry.anthropicVersion = version\n\n    if (beta !== null) entry.anthropicBeta = beta\n\n    if (version === null || !supportedAnthropicVersions.includes(version)) {\n      entry.status = 400\n\n      return invalidRequest(\n        version === null\n          ? 'Synthetic: the anthropic-version header is required.'\n          : 'Synthetic: the anthropic-version header value is not supported.'\n      )\n    }\n\n    const text = await readText(request)\n    const json = text === undefined ? undefined : parseJson(text)\n\n    if (text === undefined || json === undefined) {\n      entry.status = 400\n\n      return invalidRequest('Synthetic: the request body is not valid JSON.')\n    }\n\n    entry.body = json\n\n    const decoded = decodeMessagesRequest(json)\n\n    if (Result.isFailure(decoded) || !isJsonObject(json)) {\n      entry.status = 400\n\n      return invalidRequest('Synthetic: the request body is not a Messages request.')\n    }\n\n    const body = decoded.success\n    const seq = entry.seq\n\n    if (body.model !== undefined) entry.model = body.model\n\n    entry.stream = body.stream === true\n    entry.toolNames = (body.tools ?? []).map(tool => tool.name)\n\n    if (Predicate.isNumber(body.max_tokens)) entry.maxTokens = body.max_tokens\n\n    if (body.thinking !== undefined) entry.thinking = body.thinking\n\n    if (body.tool_choice !== undefined) entry.toolChoice = body.tool_choice\n\n    const maxTokens = jsonField(json, 'max_tokens')\n\n    if (!isPositiveInteger(maxTokens)) {\n      entry.status = 400\n\n      return invalidRequest('Synthetic: max_tokens must be a positive integer.')\n    }\n\n    if (thinkingRequested(body) && forcedToolUse(body)) {\n      entry.status = 400\n\n      return invalidRequest(\n        'Synthetic: thinking may not be enabled when tool_choice forces tool use.'\n      )\n    }\n\n    const fault = kernel.takeFault(path, body.model)\n\n    if (fault !== undefined && fault.fault.kind === 'status') {\n      return kernel.respondWithStatusFault(entry, fault, fault.fault, defaultFaultBody)\n    }\n\n    const errorEventFault =\n      fault !== undefined && fault.fault.kind === 'error-event-after-chunks'\n        ? { state: fault, fault: fault.fault }\n        : undefined\n\n    const cannotApply = (problem: string): Response => {\n      entry.faultError = problem\n      entry.status = 500\n\n      return controlError(500, `emulator fault cannot apply: ${problem}`)\n    }\n\n    // A scripted turn is used up when its request arrives. Header and status validation at\n    // `script.enqueue` time means its response can always be built.\n    const turn = kernel.nextTurn()\n\n    if (turn !== undefined && 'error' in turn) {\n      entry.scripted = 'error'\n\n      if (errorEventFault !== undefined) {\n        return cannotApply('error-event-after-chunks cannot apply to a scripted error')\n      }\n\n      return kernel.respondWithScriptedError(entry, turn.error, fault)\n    }\n\n    if (turn === undefined && (body.model === undefined || !knownModels.includes(body.model))) {\n      entry.status = 404\n\n      return errorResponse(404, {\n        type: 'not_found_error',\n        message: 'Synthetic placeholder: the requested model was not found.'\n      })\n    }\n\n    if (turn !== undefined) entry.scripted = 'message'\n\n    const plan = turn === undefined ? defaultPlan(body, seq, maxTokens) : scriptedPlan(turn, seq)\n    const identity = { id: `msg_synthetic_${seq}`, model: body.model ?? 'unknown' }\n    const usage = planUsage(plan, text)\n\n    if (body.stream !== true) {\n      if (errorEventFault !== undefined) {\n        return cannotApply('error-event-after-chunks cannot apply to a non-streamed response')\n      }\n\n      return kernel.respondWithBody(\n        entry,\n        200,\n        { 'content-type': 'application/json' },\n        [JSON.stringify(messageBody(plan, identity, usage))],\n        fault\n      )\n    }\n\n    const events = streamEvents(plan, identity, usage)\n    const headers = { 'content-type': 'text/event-stream', 'cache-control': 'no-cache' }\n\n    if (errorEventFault === undefined) {\n      return kernel.respondWithBody(entry, 200, headers, events, fault)\n    }\n\n    const after = errorEventFault.fault.chunks\n\n    // The error must arrive before `message_stop`, or a client rightly ignores it.\n    if (after >= events.length) {\n      return cannotApply(\n        `error-event-after-chunks after ${after} chunk(s) cannot apply to a response with ${events.length} chunk(s)`\n      )\n    }\n\n    const response = kernel.respondWithBody(\n      entry,\n      200,\n      headers,\n      [\n        ...events.slice(0, after),\n        sseEvent('error', { error: { ...(errorEventFault.fault.error ?? defaultErrorEvent) } })\n      ],\n      undefined\n    )\n\n    kernel.consumeFault(errorEventFault.state, entry)\n\n    return response\n  }\n\n  // Every manifest route maps to its own handler; construction throws `EmulatorRouteUnmapped`\n  // when a manifest route has no handler (or a handler has no manifest route).\n  return kernel.serve(new Map([[emulatorRouteKey('POST', config.path), messages]]))\n}\n"],"mappings":"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"}

package/dist/microsoft/api.d.mts

@@ -0,0 +1,47 @@
+import { EmulatorRouteEvidence } from "../route-evidence.mjs";
+import { MicrosoftEmulatorState } from "./state.mjs";
+import { MicrosoftApiEnv, RouteHandler, microsoftEmulatorBasePath } from "./graph.mjs";
+import { Hono } from "@emulators/core";
+
+//#region src/microsoft/api.d.ts
+type MicrosoftApiRoute = EmulatorRouteEvidence & {
+  /**
+   * Query parameters the route emulates; any other key answers 400 before the handler runs, so
+   * a rejected request never writes. Empty by default.
+   */
+  readonly queryKeys: ReadonlyArray<string>; /** `false` only for the copy monitor, a pre-authenticated capability URL. */
+  readonly auth: boolean;
+  readonly handler: RouteHandler;
+};
+/** The route table: evidence plus handler. `microsoftEmulatorRoutes` is its evidence part. */
+declare const microsoftApiRoutes: ReadonlyArray<MicrosoftApiRoute>;
+type MatchedRoute = {
+  readonly route: MicrosoftApiRoute; /** Decoded path parameters. */
+  readonly params: Readonly<Record<string, string>>;
+};
+/**
+ * The route answering `method` + raw (percent-encoded) `path` with its decoded parameters, or
+ * `undefined` (fail closed; also for a parameter that is not valid percent-encoding).
+ */
+declare const matchMicrosoftRoute: (method: string, path: string) => MatchedRoute | undefined;
+/** Header the wrapper sets on core requests: the ledger sequence number (for error ids). */
+declare const requestSeqHeader = "x-emulator-request-seq";
+/**
+ * The wrapper's fault decision for the core request of job `jobId` (its `emulatorJobHeader`),
+ * asked only once the route would answer successfully: `true` when a fault answers instead (it is
+ * used up, and the wrapper sends its answer), `false` when none applies.
+ */
+type MicrosoftFaultDecision = (jobId: string | null) => boolean;
+/**
+ * Register every route of the table on the core app, over the generation's state. Each handler
+ * re-matches the raw request path against the same table the wrapper ledgers (so parameters are
+ * decoded once, failing closed on invalid percent-encoding), checks the route's query allowlist
+ * and refuses `If-Match` (no fixture sends one) before the handler runs, then plans, faults, and
+ * commits (see `handle`). A handler that throws answers `handlerFailedResponse()` (nothing
+ * written), which the wrapper turns into its Graph error envelope 500 with `responseError` in the
+ * ledger.
+ */
+declare const registerMicrosoftApi: (app: Hono, state: MicrosoftEmulatorState, env: MicrosoftApiEnv, decideFault: MicrosoftFaultDecision) => void;
+//#endregion
+export { MatchedRoute, MicrosoftFaultDecision, matchMicrosoftRoute, microsoftApiRoutes, microsoftEmulatorBasePath, registerMicrosoftApi, requestSeqHeader };
+//# sourceMappingURL=api.d.mts.map

package/dist/microsoft/api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.mts","names":[],"sources":["../../src/microsoft/api.ts"],"mappings":";;;;;;KAgDK,iBAAA,GAAoB,qBAAA;EAOd;;;;EAAA,SAFA,SAAA,EAAW,aAAA,UAyDT;EAAA,SAvDF,IAAA;EAAA,SACA,OAAA,EAAS,YAAA;AAAA;AAsD4C;AAAA,cAAnD,kBAAA,EAAoB,aAAa,CAAC,iBAAA;AAAA,KAwInC,YAAA;EAAA,SACD,KAAA,EAAO,iBAAA,EAAA;EAAA,SAEP,MAAA,EAAQ,QAAA,CAAS,MAAA;AAAA;;;;;cAOf,mBAAA,GAAuB,MAAA,UAAgB,IAAA,aAAe,YAAY;;cAyBlE,gBAAA;;AAhCqB;AAOlC;;;KAgCY,sBAAA,IAA0B,KAAoB;;;;;AAhCqB;AAyB/E;;;;cAiIa,oBAAA,GACX,GAAA,EAAK,IAAA,EACL,KAAA,EAAO,sBAAA,EACP,GAAA,EAAK,eAAA,EACL,WAAA,EAAa,sBAAA"}