@copilotkit/aimock 1.45.1 → 1.46.0

package/dist/response/errors.js

@@ -0,0 +1,224 @@
+import { errorProfiles } from "./profiles.js";
+
+//#region src/response/errors.ts
+function buildOpenAIError(input, details) {
+	if (input === "service-validation") {
+		if (!details) throw new TypeError("Missing service validation error details");
+		return { error: {
+			message: details.message,
+			type: errorProfiles.openai.validationType
+		} };
+	}
+	if (input === "openrouter-error") {
+		if (!details || typeof details.code !== "number") throw new TypeError("Missing OpenRouter numeric error details");
+		return { error: {
+			code: details.code,
+			message: details.message,
+			...details.metadata !== void 0 && { metadata: details.metadata }
+		} };
+	}
+	return {
+		message: input.message,
+		type: input.type,
+		...input.includeParam === true ? { param: input.param ?? null } : {},
+		code: input.code
+	};
+}
+/** Native purpose templates preserve field presence and insertion order. No status or I/O. */
+function renderError(wire, purpose, details) {
+	if (wire === "ollama-embed") return { body: JSON.stringify({ error: details.message }) };
+	const profile = errorProfiles[wire];
+	if (wire === "interactions" && (purpose === "validation" || purpose === "strict-miss" || purpose === "fixture-miss" || purpose === "fixture" || purpose === "misbehavior" || purpose === "unknown-response")) return { body: JSON.stringify({ error: {
+		code: details.code ?? "INVALID_ARGUMENT",
+		message: details.message
+	} }) };
+	switch (purpose) {
+		case "authentication":
+			if (wire === "messages") return { body: JSON.stringify({
+				type: "error",
+				error: {
+					type: "authentication_error",
+					message: details.message
+				}
+			}) };
+			if (wire === "gemini") return { body: JSON.stringify({ error: {
+				code: 401,
+				message: details.message,
+				status: "UNAUTHENTICATED"
+			} }) };
+			return renderError(wire, "legacy-auth", details);
+		case "legacy-auth": return { body: JSON.stringify({ error: {
+			message: details.message,
+			type: "authentication_error",
+			code: "invalid_api_key"
+		} }) };
+		case "stream-failure": return { body: JSON.stringify({ error: { message: details.message } }) };
+		case "route-failure": return { body: JSON.stringify({ error: {
+			message: details.message,
+			type: details.type
+		} }) };
+		case "invalid-misbehavior-header":
+			if (wire === "ollama") return { body: JSON.stringify({ error: details.message }) };
+			if (wire === "cohere") return { body: JSON.stringify({ message: details.message }) };
+			if (wire === "interactions") return { body: JSON.stringify({ error: {
+				code: details.code,
+				message: details.message
+			} }) };
+			if (wire === "gemini") return { body: JSON.stringify({ error: {
+				code: 400,
+				message: details.message,
+				status: "INVALID_ARGUMENT"
+			} }) };
+			if (wire === "messages") return { body: JSON.stringify({
+				type: "error",
+				error: {
+					type: profile.validationType,
+					code: details.code,
+					message: details.message
+				}
+			}) };
+			if (wire === "bedrock" || wire === "bedrock-converse") return { body: JSON.stringify({
+				__type: "ValidationException",
+				message: details.message
+			}) };
+			return { body: JSON.stringify({ error: {
+				message: details.message,
+				type: profile.validationType,
+				code: details.code
+			} }) };
+		case "validation":
+		case "strict-miss":
+		case "fixture-miss":
+			if (wire === "gemini") return { body: JSON.stringify({ error: {
+				message: details.message,
+				code: details.bodyCode,
+				status: details.status
+			} }) };
+			if (wire === "openai") return { body: JSON.stringify({ error: buildOpenAIError({
+				...details,
+				type: details.type ?? profile.validationType
+			}) }) };
+			return { body: JSON.stringify({ error: {
+				message: details.message,
+				type: details.type ?? profile.validationType
+			} }) };
+		case "thinking": return { body: JSON.stringify({
+			type: "error",
+			error: {
+				type: details.type ?? profile.validationType,
+				message: details.message
+			},
+			...wire === "messages" && details.requestId !== void 0 ? { request_id: details.requestId } : {}
+		}) };
+		case "fixture":
+			if (wire === "gemini") return { body: JSON.stringify({ error: {
+				code: details.bodyCode,
+				message: details.message,
+				status: details.status
+			} }) };
+			if (wire === "openai") return { body: JSON.stringify({ error: {
+				message: details.message,
+				type: details.type ?? profile.fixtureType,
+				param: details.param ?? null,
+				code: details.code ?? null
+			} }) };
+			return { body: JSON.stringify({
+				type: "error",
+				error: {
+					type: details.type ?? profile.fixtureType,
+					message: details.message
+				}
+			}) };
+		case "tool-argument":
+			if (wire === "ollama") return { body: JSON.stringify({
+				error: details.message,
+				code: details.code
+			}) };
+			if (wire === "interactions") return { body: JSON.stringify({ error: {
+				code: details.code,
+				message: details.message
+			} }) };
+			if (wire === "gemini") return { body: JSON.stringify({ error: {
+				code: 500,
+				message: details.message,
+				status: "INTERNAL",
+				details: details.googleDetails
+			} }) };
+			if (wire === "bedrock" || wire === "bedrock-converse") return { body: JSON.stringify({
+				__type: details.type ?? errorProfiles.bedrock.toolArgumentType,
+				message: details.message,
+				reason: details.code
+			}) };
+			if (wire === "messages") return { body: JSON.stringify({
+				type: "error",
+				error: {
+					type: details.type ?? profile.fixtureType,
+					code: details.code,
+					message: details.message
+				}
+			}) };
+			return { body: JSON.stringify({ error: {
+				message: details.message,
+				type: details.type ?? profile.fixtureType,
+				code: details.code
+			} }) };
+		case "misbehavior":
+			if (wire === "openai") return { body: JSON.stringify({ error: buildOpenAIError(details) }) };
+			if (wire === "gemini") return { body: JSON.stringify({ error: {
+				code: details.bodyCode,
+				message: details.message,
+				status: details.status
+			} }) };
+			if (wire === "cohere") return { body: JSON.stringify({
+				message: details.message,
+				code: details.code
+			}) };
+			if (wire === "ollama") return { body: JSON.stringify({ error: `${details.code}: ${details.message}` }) };
+			if (wire === "bedrock-converse") return {
+				body: JSON.stringify({
+					__type: details.type,
+					message: details.message,
+					code: details.code
+				}),
+				headers: details.type === void 0 || details.type === null ? void 0 : { "x-amzn-errortype": details.type }
+			};
+			if (wire === "bedrock") return {
+				body: JSON.stringify({
+					__type: details.type,
+					code: details.code,
+					message: details.message
+				}),
+				headers: details.type === void 0 || details.type === null ? void 0 : { "x-amzn-errortype": details.type }
+			};
+			return { body: JSON.stringify({
+				type: "error",
+				error: {
+					type: details.type,
+					code: details.code,
+					message: details.message
+				}
+			}) };
+		case "unknown-response":
+			if (wire === "gemini") return { body: JSON.stringify({ error: {
+				message: details.message,
+				code: details.bodyCode,
+				status: details.status
+			} }) };
+			if (wire === "openai") return { body: JSON.stringify({ error: buildOpenAIError({
+				...details,
+				type: details.type ?? "server_error"
+			}) }) };
+			return { body: JSON.stringify({ error: {
+				message: details.message,
+				type: details.type ?? "server_error"
+			} }) };
+		case "transport-failure": return { body: JSON.stringify({ error: {
+			message: details.message,
+			type: details.type ?? "proxy_error"
+		} }) };
+	}
+}
+
+//#endregion
+export { buildOpenAIError, renderError };
+//# sourceMappingURL=errors.js.map

package/dist/response/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/response/errors.ts"],"sourcesContent":["import { errorProfiles, type ErrorWire } from \"./profiles.js\";\n\nexport type ErrorPurpose =\n  | \"validation\"\n  | \"strict-miss\"\n  | \"fixture-miss\"\n  | \"thinking\"\n  | \"fixture\"\n  | \"tool-argument\"\n  | \"misbehavior\"\n  | \"unknown-response\"\n  | \"transport-failure\"\n  | \"route-failure\"\n  | \"stream-failure\"\n  | \"invalid-misbehavior-header\"\n  | \"authentication\"\n  | \"legacy-auth\";\n\nexport interface ErrorDetails {\n  message: string;\n  type?: string | null;\n  param?: string | null;\n  /** Explicitly retain the native OpenAI param slot; omitted preserves legacy templates. */\n  includeParam?: true;\n  /** Normalized correlation metadata explicitly supplied by native header-policy rejects. */\n  requestId?: string;\n  code?: string | null;\n  bodyCode?: number;\n  status?: string | null;\n  googleDetails?: {\n    \"@type\": string;\n    reason: string;\n    domain: string;\n    metadata: { code: string };\n  }[];\n}\n\ntype OpenAIInnerDetails = Pick<\n  ErrorDetails,\n  \"message\" | \"type\" | \"param\" | \"code\" | \"includeParam\"\n>;\ntype OpenAIInnerBody = {\n  message: string;\n  type?: string | null;\n  param?: string | null;\n  code?: string | null;\n};\ntype ServiceValidationBody = { error: { message: string; type: string } };\ntype OpenRouterErrorBody = {\n  error: { code: number; message: string; metadata?: Record<string, unknown> };\n};\n\n/** Common error owner; fixed native forms preserve caller signatures and ordering. */\nexport function buildOpenAIError(details: OpenAIInnerDetails): OpenAIInnerBody;\nexport function buildOpenAIError(\n  purpose: \"service-validation\",\n  details: { message: string },\n): ServiceValidationBody;\nexport function buildOpenAIError(\n  purpose: \"openrouter-error\",\n  details: { code: number; message: string; metadata?: Record<string, unknown> },\n): OpenRouterErrorBody;\nexport function buildOpenAIError(\n  input: OpenAIInnerDetails | \"service-validation\" | \"openrouter-error\",\n  details?: { message: string; code?: number; metadata?: Record<string, unknown> },\n): OpenAIInnerBody | ServiceValidationBody | OpenRouterErrorBody {\n  if (input === \"service-validation\") {\n    if (!details) throw new TypeError(\"Missing service validation error details\");\n    return {\n      error: { message: details.message, type: errorProfiles.openai.validationType },\n    };\n  }\n  if (input === \"openrouter-error\") {\n    if (!details || typeof details.code !== \"number\")\n      throw new TypeError(\"Missing OpenRouter numeric error details\");\n    return {\n      error: {\n        code: details.code,\n        message: details.message,\n        ...(details.metadata !== undefined && { metadata: details.metadata }),\n      },\n    };\n  }\n  return {\n    message: input.message,\n    type: input.type,\n    ...(input.includeParam === true ? { param: input.param ?? null } : {}),\n    code: input.code,\n  };\n}\n\n/** Native purpose templates preserve field presence and insertion order. No status or I/O. */\nexport function renderError(\n  wire: ErrorWire,\n  purpose: ErrorPurpose,\n  details: ErrorDetails,\n): { body: string; headers?: Record<string, string> } {\n  if (wire === \"ollama-embed\") {\n    return { body: JSON.stringify({ error: details.message }) };\n  }\n  const profile = errorProfiles[wire];\n  if (\n    wire === \"interactions\" &&\n    (purpose === \"validation\" ||\n      purpose === \"strict-miss\" ||\n      purpose === \"fixture-miss\" ||\n      purpose === \"fixture\" ||\n      purpose === \"misbehavior\" ||\n      purpose === \"unknown-response\")\n  ) {\n    return {\n      body: JSON.stringify({\n        error: { code: details.code ?? \"INVALID_ARGUMENT\", message: details.message },\n      }),\n    };\n  }\n  switch (purpose) {\n    case \"authentication\":\n      if (wire === \"messages\") {\n        return {\n          body: JSON.stringify({\n            type: \"error\",\n            error: { type: \"authentication_error\", message: details.message },\n          }),\n        };\n      }\n      if (wire === \"gemini\") {\n        return {\n          body: JSON.stringify({\n            error: { code: 401, message: details.message, status: \"UNAUTHENTICATED\" },\n          }),\n        };\n      }\n      return renderError(wire, \"legacy-auth\", details);\n    case \"legacy-auth\":\n      return {\n        body: JSON.stringify({\n          error: {\n            message: details.message,\n            type: \"authentication_error\",\n            code: \"invalid_api_key\",\n          },\n        }),\n      };\n    case \"stream-failure\":\n      return { body: JSON.stringify({ error: { message: details.message } }) };\n    case \"route-failure\":\n      return {\n        body: JSON.stringify({ error: { message: details.message, type: details.type } }),\n      };\n    case \"invalid-misbehavior-header\":\n      if (wire === \"ollama\") return { body: JSON.stringify({ error: details.message }) };\n      if (wire === \"cohere\") return { body: JSON.stringify({ message: details.message }) };\n      if (wire === \"interactions\") {\n        return {\n          body: JSON.stringify({ error: { code: details.code, message: details.message } }),\n        };\n      }\n      if (wire === \"gemini\") {\n        return {\n          body: JSON.stringify({\n            error: { code: 400, message: details.message, status: \"INVALID_ARGUMENT\" },\n          }),\n        };\n      }\n      if (wire === \"messages\") {\n        return {\n          body: JSON.stringify({\n            type: \"error\",\n            error: { type: profile.validationType, code: details.code, message: details.message },\n          }),\n        };\n      }\n      if (wire === \"bedrock\" || wire === \"bedrock-converse\") {\n        return {\n          body: JSON.stringify({ __type: \"ValidationException\", message: details.message }),\n        };\n      }\n      return {\n        body: JSON.stringify({\n          error: { message: details.message, type: profile.validationType, code: details.code },\n        }),\n      };\n    case \"validation\":\n    case \"strict-miss\":\n    case \"fixture-miss\":\n      if (wire === \"gemini\") {\n        return {\n          body: JSON.stringify({\n            error: { message: details.message, code: details.bodyCode, status: details.status },\n          }),\n        };\n      }\n      if (wire === \"openai\") {\n        return {\n          body: JSON.stringify({\n            error: buildOpenAIError({\n              ...details,\n              type: details.type ?? profile.validationType,\n            }),\n          }),\n        };\n      }\n      return {\n        body: JSON.stringify({\n          error: { message: details.message, type: details.type ?? profile.validationType },\n        }),\n      };\n    case \"thinking\":\n      return {\n        body: JSON.stringify({\n          type: \"error\",\n          error: { type: details.type ?? profile.validationType, message: details.message },\n          ...(wire === \"messages\" && details.requestId !== undefined\n            ? { request_id: details.requestId }\n            : {}),\n        }),\n      };\n    case \"fixture\":\n      if (wire === \"gemini\") {\n        return {\n          body: JSON.stringify({\n            error: { code: details.bodyCode, message: details.message, status: details.status },\n          }),\n        };\n      }\n      if (wire === \"openai\") {\n        return {\n          body: JSON.stringify({\n            error: {\n              message: details.message,\n              type: details.type ?? profile.fixtureType,\n              param: details.param ?? null,\n              code: details.code ?? null,\n            },\n          }),\n        };\n      }\n      return {\n        body: JSON.stringify({\n          type: \"error\",\n          error: { type: details.type ?? profile.fixtureType, message: details.message },\n        }),\n      };\n    case \"tool-argument\":\n      if (wire === \"ollama\") {\n        return { body: JSON.stringify({ error: details.message, code: details.code }) };\n      }\n      if (wire === \"interactions\") {\n        return {\n          body: JSON.stringify({ error: { code: details.code, message: details.message } }),\n        };\n      }\n      if (wire === \"gemini\") {\n        return {\n          body: JSON.stringify({\n            error: {\n              code: 500,\n              message: details.message,\n              status: \"INTERNAL\",\n              details: details.googleDetails,\n            },\n          }),\n        };\n      }\n      if (wire === \"bedrock\" || wire === \"bedrock-converse\") {\n        return {\n          body: JSON.stringify({\n            __type: details.type ?? errorProfiles.bedrock.toolArgumentType,\n            message: details.message,\n            reason: details.code,\n          }),\n        };\n      }\n      if (wire === \"messages\") {\n        return {\n          body: JSON.stringify({\n            type: \"error\",\n            error: {\n              type: details.type ?? profile.fixtureType,\n              code: details.code,\n              message: details.message,\n            },\n          }),\n        };\n      }\n      return {\n        body: JSON.stringify({\n          error: {\n            message: details.message,\n            type: details.type ?? profile.fixtureType,\n            code: details.code,\n          },\n        }),\n      };\n    case \"misbehavior\":\n      if (wire === \"openai\") {\n        return { body: JSON.stringify({ error: buildOpenAIError(details) }) };\n      }\n      if (wire === \"gemini\") {\n        return {\n          body: JSON.stringify({\n            error: { code: details.bodyCode, message: details.message, status: details.status },\n          }),\n        };\n      }\n      if (wire === \"cohere\") {\n        return { body: JSON.stringify({ message: details.message, code: details.code }) };\n      }\n      if (wire === \"ollama\") {\n        return { body: JSON.stringify({ error: `${details.code}: ${details.message}` }) };\n      }\n      if (wire === \"bedrock-converse\") {\n        return {\n          body: JSON.stringify({\n            __type: details.type,\n            message: details.message,\n            code: details.code,\n          }),\n          headers:\n            details.type === undefined || details.type === null\n              ? undefined\n              : { \"x-amzn-errortype\": details.type },\n        };\n      }\n      if (wire === \"bedrock\") {\n        return {\n          body: JSON.stringify({\n            __type: details.type,\n            code: details.code,\n            message: details.message,\n          }),\n          headers:\n            details.type === undefined || details.type === null\n              ? undefined\n              : { \"x-amzn-errortype\": details.type },\n        };\n      }\n      return {\n        body: JSON.stringify({\n          type: \"error\",\n          error: { type: details.type, code: details.code, message: details.message },\n        }),\n      };\n    case \"unknown-response\":\n      if (wire === \"gemini\") {\n        return {\n          body: JSON.stringify({\n            error: { message: details.message, code: details.bodyCode, status: details.status },\n          }),\n        };\n      }\n      if (wire === \"openai\") {\n        return {\n          body: JSON.stringify({\n            error: buildOpenAIError({ ...details, type: details.type ?? \"server_error\" }),\n          }),\n        };\n      }\n      return {\n        body: JSON.stringify({\n          error: { message: details.message, type: details.type ?? \"server_error\" },\n        }),\n      };\n    case \"transport-failure\":\n      return {\n        body: JSON.stringify({\n          error: { message: details.message, type: details.type ?? \"proxy_error\" },\n        }),\n      };\n  }\n}\n"],"mappings":"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"}

package/dist/response/finish.cjs

@@ -0,0 +1,39 @@
+
+//#region src/response/finish.ts
+/** Caller defaults stay with the wire; unknown native reasons pass through unchanged. */
+function mapAnthropicFinish(finishReason) {
+	if (finishReason === "stop") return "end_turn";
+	if (finishReason === "tool_calls") return "tool_use";
+	if (finishReason === "length") return "max_tokens";
+	return finishReason;
+}
+/** Responses status has its own table; caller defaults remain outside the mapper. */
+function mapResponsesFinish(finishReason) {
+	if (finishReason === "stop") return "completed";
+	if (finishReason === "tool_calls") return "completed";
+	if (finishReason === "length") return "incomplete";
+	if (finishReason === "content_filter") return "failed";
+	return finishReason;
+}
+/** Gemini and Vertex keep their distinct native finish reasons and caller defaults. */
+function mapGeminiFinish(finishReason) {
+	if (finishReason === "stop") return "STOP";
+	if (finishReason === "tool_calls") return "FUNCTION_CALL";
+	if (finishReason === "length") return "MAX_TOKENS";
+	if (finishReason === "content_filter") return "SAFETY";
+	return finishReason;
+}
+/** Cohere has its own native finish table; callers retain their falsy defaults. */
+function mapCohereFinish(finishReason) {
+	if (finishReason === "stop") return "COMPLETE";
+	if (finishReason === "tool_calls") return "TOOL_CALL";
+	if (finishReason === "length") return "MAX_TOKENS";
+	return finishReason;
+}
+
+//#endregion
+exports.mapAnthropicFinish = mapAnthropicFinish;
+exports.mapCohereFinish = mapCohereFinish;
+exports.mapGeminiFinish = mapGeminiFinish;
+exports.mapResponsesFinish = mapResponsesFinish;
+//# sourceMappingURL=finish.cjs.map

package/dist/response/finish.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.cjs","names":[],"sources":["../../src/response/finish.ts"],"sourcesContent":["/** Caller defaults stay with the wire; unknown native reasons pass through unchanged. */\nexport function mapAnthropicFinish(finishReason: string): string {\n  if (finishReason === \"stop\") return \"end_turn\";\n  if (finishReason === \"tool_calls\") return \"tool_use\";\n  if (finishReason === \"length\") return \"max_tokens\";\n  return finishReason;\n}\n\n/** Responses status has its own table; caller defaults remain outside the mapper. */\nexport function mapResponsesFinish(finishReason: string): string {\n  if (finishReason === \"stop\") return \"completed\";\n  if (finishReason === \"tool_calls\") return \"completed\";\n  if (finishReason === \"length\") return \"incomplete\";\n  if (finishReason === \"content_filter\") return \"failed\";\n  return finishReason;\n}\n\n/** Gemini and Vertex keep their distinct native finish reasons and caller defaults. */\nexport function mapGeminiFinish(finishReason: string): string {\n  if (finishReason === \"stop\") return \"STOP\";\n  if (finishReason === \"tool_calls\") return \"FUNCTION_CALL\";\n  if (finishReason === \"length\") return \"MAX_TOKENS\";\n  if (finishReason === \"content_filter\") return \"SAFETY\";\n  return finishReason;\n}\n\n/** Cohere has its own native finish table; callers retain their falsy defaults. */\nexport function mapCohereFinish(finishReason: string): string {\n  if (finishReason === \"stop\") return \"COMPLETE\";\n  if (finishReason === \"tool_calls\") return \"TOOL_CALL\";\n  if (finishReason === \"length\") return \"MAX_TOKENS\";\n  return finishReason;\n}\n"],"mappings":";;;AACA,SAAgB,mBAAmB,cAA8B;AAC/D,KAAI,iBAAiB,OAAQ,QAAO;AACpC,KAAI,iBAAiB,aAAc,QAAO;AAC1C,KAAI,iBAAiB,SAAU,QAAO;AACtC,QAAO;;;AAIT,SAAgB,mBAAmB,cAA8B;AAC/D,KAAI,iBAAiB,OAAQ,QAAO;AACpC,KAAI,iBAAiB,aAAc,QAAO;AAC1C,KAAI,iBAAiB,SAAU,QAAO;AACtC,KAAI,iBAAiB,iBAAkB,QAAO;AAC9C,QAAO;;;AAIT,SAAgB,gBAAgB,cAA8B;AAC5D,KAAI,iBAAiB,OAAQ,QAAO;AACpC,KAAI,iBAAiB,aAAc,QAAO;AAC1C,KAAI,iBAAiB,SAAU,QAAO;AACtC,KAAI,iBAAiB,iBAAkB,QAAO;AAC9C,QAAO;;;AAIT,SAAgB,gBAAgB,cAA8B;AAC5D,KAAI,iBAAiB,OAAQ,QAAO;AACpC,KAAI,iBAAiB,aAAc,QAAO;AAC1C,KAAI,iBAAiB,SAAU,QAAO;AACtC,QAAO"}

package/dist/response/finish.js

@@ -0,0 +1,35 @@
+//#region src/response/finish.ts
+/** Caller defaults stay with the wire; unknown native reasons pass through unchanged. */
+function mapAnthropicFinish(finishReason) {
+	if (finishReason === "stop") return "end_turn";
+	if (finishReason === "tool_calls") return "tool_use";
+	if (finishReason === "length") return "max_tokens";
+	return finishReason;
+}
+/** Responses status has its own table; caller defaults remain outside the mapper. */
+function mapResponsesFinish(finishReason) {
+	if (finishReason === "stop") return "completed";
+	if (finishReason === "tool_calls") return "completed";
+	if (finishReason === "length") return "incomplete";
+	if (finishReason === "content_filter") return "failed";
+	return finishReason;
+}
+/** Gemini and Vertex keep their distinct native finish reasons and caller defaults. */
+function mapGeminiFinish(finishReason) {
+	if (finishReason === "stop") return "STOP";
+	if (finishReason === "tool_calls") return "FUNCTION_CALL";
+	if (finishReason === "length") return "MAX_TOKENS";
+	if (finishReason === "content_filter") return "SAFETY";
+	return finishReason;
+}
+/** Cohere has its own native finish table; callers retain their falsy defaults. */
+function mapCohereFinish(finishReason) {
+	if (finishReason === "stop") return "COMPLETE";
+	if (finishReason === "tool_calls") return "TOOL_CALL";
+	if (finishReason === "length") return "MAX_TOKENS";
+	return finishReason;
+}
+
+//#endregion
+export { mapAnthropicFinish, mapCohereFinish, mapGeminiFinish, mapResponsesFinish };
+//# sourceMappingURL=finish.js.map

package/dist/response/finish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.js","names":[],"sources":["../../src/response/finish.ts"],"sourcesContent":["/** Caller defaults stay with the wire; unknown native reasons pass through unchanged. */\nexport function mapAnthropicFinish(finishReason: string): string {\n  if (finishReason === \"stop\") return \"end_turn\";\n  if (finishReason === \"tool_calls\") return \"tool_use\";\n  if (finishReason === \"length\") return \"max_tokens\";\n  return finishReason;\n}\n\n/** Responses status has its own table; caller defaults remain outside the mapper. */\nexport function mapResponsesFinish(finishReason: string): string {\n  if (finishReason === \"stop\") return \"completed\";\n  if (finishReason === \"tool_calls\") return \"completed\";\n  if (finishReason === \"length\") return \"incomplete\";\n  if (finishReason === \"content_filter\") return \"failed\";\n  return finishReason;\n}\n\n/** Gemini and Vertex keep their distinct native finish reasons and caller defaults. */\nexport function mapGeminiFinish(finishReason: string): string {\n  if (finishReason === \"stop\") return \"STOP\";\n  if (finishReason === \"tool_calls\") return \"FUNCTION_CALL\";\n  if (finishReason === \"length\") return \"MAX_TOKENS\";\n  if (finishReason === \"content_filter\") return \"SAFETY\";\n  return finishReason;\n}\n\n/** Cohere has its own native finish table; callers retain their falsy defaults. */\nexport function mapCohereFinish(finishReason: string): string {\n  if (finishReason === \"stop\") return \"COMPLETE\";\n  if (finishReason === \"tool_calls\") return \"TOOL_CALL\";\n  if (finishReason === \"length\") return \"MAX_TOKENS\";\n  return finishReason;\n}\n"],"mappings":";;AACA,SAAgB,mBAAmB,cAA8B;AAC/D,KAAI,iBAAiB,OAAQ,QAAO;AACpC,KAAI,iBAAiB,aAAc,QAAO;AAC1C,KAAI,iBAAiB,SAAU,QAAO;AACtC,QAAO;;;AAIT,SAAgB,mBAAmB,cAA8B;AAC/D,KAAI,iBAAiB,OAAQ,QAAO;AACpC,KAAI,iBAAiB,aAAc,QAAO;AAC1C,KAAI,iBAAiB,SAAU,QAAO;AACtC,KAAI,iBAAiB,iBAAkB,QAAO;AAC9C,QAAO;;;AAIT,SAAgB,gBAAgB,cAA8B;AAC5D,KAAI,iBAAiB,OAAQ,QAAO;AACpC,KAAI,iBAAiB,aAAc,QAAO;AAC1C,KAAI,iBAAiB,SAAU,QAAO;AACtC,KAAI,iBAAiB,iBAAkB,QAAO;AAC9C,QAAO;;;AAIT,SAAgB,gBAAgB,cAA8B;AAC5D,KAAI,iBAAiB,OAAQ,QAAO;AACpC,KAAI,iBAAiB,aAAc,QAAO;AAC1C,KAAI,iBAAiB,SAAU,QAAO;AACtC,QAAO"}

package/dist/response/policy.cjs

@@ -0,0 +1,126 @@
+
+//#region src/response/policy.ts
+/** Entry points choose whether a failed parse warns or becomes a CLI usage error. */
+function parsePolicyEntry(key, value) {
+	if (key === "requiredHeaders") {
+		const normalized = typeof value === "string" ? value.toLowerCase() : void 0;
+		if (normalized === "off" || normalized === "enforce") return {
+			ok: true,
+			key,
+			value: normalized
+		};
+		return {
+			ok: false,
+			reason: "expected \"off\" or \"enforce\"."
+		};
+	}
+	if (key === "authErrors" || key === "modelCatalog") {
+		const normalized = typeof value === "string" ? value.toLowerCase() : void 0;
+		if (normalized === "legacy" || normalized === "native") return {
+			ok: true,
+			key,
+			value: normalized
+		};
+		return {
+			ok: false,
+			reason: "expected \"legacy\" or \"native\"."
+		};
+	}
+	return {
+		ok: false,
+		reason: "unknown policy key."
+	};
+}
+/** Store one parsed entry without widening either key's value type. */
+function assignPolicyEntry(target, entry) {
+	if (entry.key === "requiredHeaders") target.requiredHeaders = entry.value;
+	else target[entry.key] = entry.value;
+}
+/** Parse each programmatic entry independently without changing the caller's object. */
+function parsePolicy(value, warn) {
+	const result = {};
+	if (value === void 0) return result;
+	if (value === null || typeof value !== "object" || Array.isArray(value)) {
+		warn("Ignoring policy: expected an object.");
+		return result;
+	}
+	for (const [key, entry] of Object.entries(value)) {
+		const parsed = parsePolicyEntry(key, entry);
+		if (parsed.ok) assignPolicyEntry(result, parsed);
+		else warn(`Ignoring policy.${key}: ${parsed.reason}`);
+	}
+	return result;
+}
+/** A bad header entry does not erase a prior valid entry or other policy keys. */
+function parsePolicyHeader(rawHeaders, warn) {
+	const result = {};
+	const header = rawHeaders?.["x-aimock-policy"];
+	if (header === void 0) return result;
+	const text = Array.isArray(header) ? header.join(",") : header;
+	for (const rawEntry of text.split(",")) {
+		const entry = rawEntry.trim();
+		const separator = entry.indexOf("=");
+		if (separator < 0) {
+			warn(`Ignoring policy entry ${JSON.stringify(entry)}: expected key=value.`);
+			continue;
+		}
+		const key = entry.slice(0, separator);
+		const parsed = parsePolicyEntry(key, entry.slice(separator + 1));
+		if (parsed.ok) assignPolicyEntry(result, parsed);
+		else warn(`Ignoring policy.${key}: ${parsed.reason}`);
+	}
+	return result;
+}
+/** Resolve from the direct-handler input, preserving the independent legacy strict bit. */
+function resolvePolicy(defaults, rawHeaders, warn = (message) => defaults.logger.warn(message)) {
+	const strict = resolveStrictMode(defaults.strict, rawHeaders);
+	const server = parsePolicy(defaults.policy, warn);
+	const request = parsePolicyHeader(rawHeaders, warn);
+	return Object.freeze({
+		strict,
+		requiredHeaders: request.requiredHeaders ?? server.requiredHeaders ?? "off",
+		authErrors: request.authErrors ?? server.authErrors ?? "legacy",
+		modelCatalog: request.modelCatalog ?? server.modelCatalog ?? "legacy"
+	});
+}
+/** Preserve the legacy request strict header grammar and server fallback. */
+function resolveStrictMode(serverDefault, rawHeaders) {
+	if (rawHeaders) {
+		const header = rawHeaders["x-aimock-strict"];
+		const rawVal = typeof header === "string" ? header : Array.isArray(header) ? header[0] : void 0;
+		if (typeof rawVal === "string") {
+			const val = rawVal.trim().toLowerCase();
+			if (val === "true" || val === "1") return true;
+			if (val === "false" || val === "0") return false;
+		}
+	}
+	return serverDefault ?? false;
+}
+/** Journal fields retain their existing omitted-versus-overridden shape. */
+function strictOverrideField(serverDefault, rawHeaders) {
+	const effective = resolveStrictMode(serverDefault, rawHeaders);
+	if (effective !== (serverDefault ?? false)) return { strictOverride: effective };
+	return {};
+}
+/** Named legacy decisions share one header read at the caller's existing site. */
+function resolveRequestDecisions(serverDefault, rawHeaders) {
+	const strict = resolveStrictMode(serverDefault, rawHeaders);
+	return Object.freeze({
+		strict,
+		fixtureMiss: strict,
+		upstream: !strict,
+		reasoningSuppression: strict,
+		thinkingRejection: strict,
+		mcpRecordingStrict: strict,
+		strictOverride: strict !== (serverDefault ?? false) ? strict : void 0
+	});
+}
+
+//#endregion
+exports.assignPolicyEntry = assignPolicyEntry;
+exports.parsePolicy = parsePolicy;
+exports.parsePolicyEntry = parsePolicyEntry;
+exports.resolvePolicy = resolvePolicy;
+exports.resolveRequestDecisions = resolveRequestDecisions;
+exports.strictOverrideField = strictOverrideField;
+//# sourceMappingURL=policy.cjs.map

package/dist/response/policy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.cjs","names":[],"sources":["../../src/response/policy.ts"],"sourcesContent":["import type { IncomingHttpHeaders } from \"node:http\";\nimport type { AimockPolicy, HandlerDefaults } from \"../types.js\";\n\n/** Entry points choose whether a failed parse warns or becomes a CLI usage error. */\nexport function parsePolicyEntry(\n  key: string,\n  value: unknown,\n):\n  | { ok: true; key: \"requiredHeaders\"; value: \"off\" | \"enforce\" }\n  | { ok: true; key: \"authErrors\" | \"modelCatalog\"; value: \"legacy\" | \"native\" }\n  | { ok: false; reason: string } {\n  if (key === \"requiredHeaders\") {\n    const normalized = typeof value === \"string\" ? value.toLowerCase() : undefined;\n    if (normalized === \"off\" || normalized === \"enforce\") {\n      return { ok: true, key, value: normalized };\n    }\n    return { ok: false, reason: 'expected \"off\" or \"enforce\".' };\n  }\n  if (key === \"authErrors\" || key === \"modelCatalog\") {\n    const normalized = typeof value === \"string\" ? value.toLowerCase() : undefined;\n    if (normalized === \"legacy\" || normalized === \"native\") {\n      return { ok: true, key, value: normalized };\n    }\n    return { ok: false, reason: 'expected \"legacy\" or \"native\".' };\n  }\n  return { ok: false, reason: \"unknown policy key.\" };\n}\n\n/** Store one parsed entry without widening either key's value type. */\nexport function assignPolicyEntry(\n  target: AimockPolicy,\n  entry: Exclude<ReturnType<typeof parsePolicyEntry>, { ok: false }>,\n): void {\n  if (entry.key === \"requiredHeaders\") target.requiredHeaders = entry.value;\n  else target[entry.key] = entry.value;\n}\n\n/** Parse each programmatic entry independently without changing the caller's object. */\nexport function parsePolicy(value: unknown, warn: (message: string) => void): AimockPolicy {\n  const result: AimockPolicy = {};\n  if (value === undefined) return result;\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    warn(\"Ignoring policy: expected an object.\");\n    return result;\n  }\n  for (const [key, entry] of Object.entries(value)) {\n    const parsed = parsePolicyEntry(key, entry);\n    if (parsed.ok) assignPolicyEntry(result, parsed);\n    else warn(`Ignoring policy.${key}: ${parsed.reason}`);\n  }\n  return result;\n}\n\n/** A bad header entry does not erase a prior valid entry or other policy keys. */\nexport function parsePolicyHeader(\n  rawHeaders: IncomingHttpHeaders | undefined,\n  warn: (message: string) => void,\n): AimockPolicy {\n  const result: AimockPolicy = {};\n  const header = rawHeaders?.[\"x-aimock-policy\"];\n  if (header === undefined) return result;\n  const text = Array.isArray(header) ? header.join(\",\") : header;\n  for (const rawEntry of text.split(\",\")) {\n    const entry = rawEntry.trim();\n    const separator = entry.indexOf(\"=\");\n    if (separator < 0) {\n      warn(`Ignoring policy entry ${JSON.stringify(entry)}: expected key=value.`);\n      continue;\n    }\n    const key = entry.slice(0, separator);\n    const parsed = parsePolicyEntry(key, entry.slice(separator + 1));\n    if (parsed.ok) assignPolicyEntry(result, parsed);\n    else warn(`Ignoring policy.${key}: ${parsed.reason}`);\n  }\n  return result;\n}\n\n/** Resolve from the direct-handler input, preserving the independent legacy strict bit. */\nexport function resolvePolicy(\n  defaults: HandlerDefaults,\n  rawHeaders?: IncomingHttpHeaders,\n  warn: (message: string) => void = (message) => defaults.logger.warn(message),\n) {\n  const strict = resolveStrictMode(defaults.strict, rawHeaders);\n  const server = parsePolicy(defaults.policy, warn);\n  const request = parsePolicyHeader(rawHeaders, warn);\n  return Object.freeze({\n    strict,\n    requiredHeaders: request.requiredHeaders ?? server.requiredHeaders ?? \"off\",\n    authErrors: request.authErrors ?? server.authErrors ?? \"legacy\",\n    modelCatalog: request.modelCatalog ?? server.modelCatalog ?? \"legacy\",\n  });\n}\n\n/** Preserve the legacy request strict header grammar and server fallback. */\nexport function resolveStrictMode(\n  serverDefault: boolean | undefined,\n  rawHeaders?: IncomingHttpHeaders,\n): boolean {\n  if (rawHeaders) {\n    const header = rawHeaders[\"x-aimock-strict\"];\n    const rawVal =\n      typeof header === \"string\" ? header : Array.isArray(header) ? header[0] : undefined;\n    if (typeof rawVal === \"string\") {\n      const val = rawVal.trim().toLowerCase();\n      if (val === \"true\" || val === \"1\") return true;\n      if (val === \"false\" || val === \"0\") return false;\n    }\n  }\n  return serverDefault ?? false;\n}\n\n/** Journal fields retain their existing omitted-versus-overridden shape. */\nexport function strictOverrideField(\n  serverDefault: boolean | undefined,\n  rawHeaders?: IncomingHttpHeaders,\n): { strictOverride?: boolean } {\n  const effective = resolveStrictMode(serverDefault, rawHeaders);\n  if (effective !== (serverDefault ?? false)) {\n    return { strictOverride: effective };\n  }\n  return {};\n}\n\n/** Named legacy decisions share one header read at the caller's existing site. */\nexport function resolveRequestDecisions(\n  serverDefault: boolean | undefined,\n  rawHeaders?: IncomingHttpHeaders,\n) {\n  const strict = resolveStrictMode(serverDefault, rawHeaders);\n  return Object.freeze({\n    strict,\n    fixtureMiss: strict,\n    upstream: !strict,\n    reasoningSuppression: strict,\n    thinkingRejection: strict,\n    mcpRecordingStrict: strict,\n    strictOverride: strict !== (serverDefault ?? false) ? strict : undefined,\n  });\n}\n"],"mappings":"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"}

package/dist/response/policy.js

@@ -0,0 +1,120 @@
+//#region src/response/policy.ts
+/** Entry points choose whether a failed parse warns or becomes a CLI usage error. */
+function parsePolicyEntry(key, value) {
+	if (key === "requiredHeaders") {
+		const normalized = typeof value === "string" ? value.toLowerCase() : void 0;
+		if (normalized === "off" || normalized === "enforce") return {
+			ok: true,
+			key,
+			value: normalized
+		};
+		return {
+			ok: false,
+			reason: "expected \"off\" or \"enforce\"."
+		};
+	}
+	if (key === "authErrors" || key === "modelCatalog") {
+		const normalized = typeof value === "string" ? value.toLowerCase() : void 0;
+		if (normalized === "legacy" || normalized === "native") return {
+			ok: true,
+			key,
+			value: normalized
+		};
+		return {
+			ok: false,
+			reason: "expected \"legacy\" or \"native\"."
+		};
+	}
+	return {
+		ok: false,
+		reason: "unknown policy key."
+	};
+}
+/** Store one parsed entry without widening either key's value type. */
+function assignPolicyEntry(target, entry) {
+	if (entry.key === "requiredHeaders") target.requiredHeaders = entry.value;
+	else target[entry.key] = entry.value;
+}
+/** Parse each programmatic entry independently without changing the caller's object. */
+function parsePolicy(value, warn) {
+	const result = {};
+	if (value === void 0) return result;
+	if (value === null || typeof value !== "object" || Array.isArray(value)) {
+		warn("Ignoring policy: expected an object.");
+		return result;
+	}
+	for (const [key, entry] of Object.entries(value)) {
+		const parsed = parsePolicyEntry(key, entry);
+		if (parsed.ok) assignPolicyEntry(result, parsed);
+		else warn(`Ignoring policy.${key}: ${parsed.reason}`);
+	}
+	return result;
+}
+/** A bad header entry does not erase a prior valid entry or other policy keys. */
+function parsePolicyHeader(rawHeaders, warn) {
+	const result = {};
+	const header = rawHeaders?.["x-aimock-policy"];
+	if (header === void 0) return result;
+	const text = Array.isArray(header) ? header.join(",") : header;
+	for (const rawEntry of text.split(",")) {
+		const entry = rawEntry.trim();
+		const separator = entry.indexOf("=");
+		if (separator < 0) {
+			warn(`Ignoring policy entry ${JSON.stringify(entry)}: expected key=value.`);
+			continue;
+		}
+		const key = entry.slice(0, separator);
+		const parsed = parsePolicyEntry(key, entry.slice(separator + 1));
+		if (parsed.ok) assignPolicyEntry(result, parsed);
+		else warn(`Ignoring policy.${key}: ${parsed.reason}`);
+	}
+	return result;
+}
+/** Resolve from the direct-handler input, preserving the independent legacy strict bit. */
+function resolvePolicy(defaults, rawHeaders, warn = (message) => defaults.logger.warn(message)) {
+	const strict = resolveStrictMode(defaults.strict, rawHeaders);
+	const server = parsePolicy(defaults.policy, warn);
+	const request = parsePolicyHeader(rawHeaders, warn);
+	return Object.freeze({
+		strict,
+		requiredHeaders: request.requiredHeaders ?? server.requiredHeaders ?? "off",
+		authErrors: request.authErrors ?? server.authErrors ?? "legacy",
+		modelCatalog: request.modelCatalog ?? server.modelCatalog ?? "legacy"
+	});
+}
+/** Preserve the legacy request strict header grammar and server fallback. */
+function resolveStrictMode(serverDefault, rawHeaders) {
+	if (rawHeaders) {
+		const header = rawHeaders["x-aimock-strict"];
+		const rawVal = typeof header === "string" ? header : Array.isArray(header) ? header[0] : void 0;
+		if (typeof rawVal === "string") {
+			const val = rawVal.trim().toLowerCase();
+			if (val === "true" || val === "1") return true;
+			if (val === "false" || val === "0") return false;
+		}
+	}
+	return serverDefault ?? false;
+}
+/** Journal fields retain their existing omitted-versus-overridden shape. */
+function strictOverrideField(serverDefault, rawHeaders) {
+	const effective = resolveStrictMode(serverDefault, rawHeaders);
+	if (effective !== (serverDefault ?? false)) return { strictOverride: effective };
+	return {};
+}
+/** Named legacy decisions share one header read at the caller's existing site. */
+function resolveRequestDecisions(serverDefault, rawHeaders) {
+	const strict = resolveStrictMode(serverDefault, rawHeaders);
+	return Object.freeze({
+		strict,
+		fixtureMiss: strict,
+		upstream: !strict,
+		reasoningSuppression: strict,
+		thinkingRejection: strict,
+		mcpRecordingStrict: strict,
+		strictOverride: strict !== (serverDefault ?? false) ? strict : void 0
+	});
+}
+
+//#endregion
+export { assignPolicyEntry, parsePolicy, parsePolicyEntry, resolvePolicy, resolveRequestDecisions, strictOverrideField };
+//# sourceMappingURL=policy.js.map

package/dist/response/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","names":[],"sources":["../../src/response/policy.ts"],"sourcesContent":["import type { IncomingHttpHeaders } from \"node:http\";\nimport type { AimockPolicy, HandlerDefaults } from \"../types.js\";\n\n/** Entry points choose whether a failed parse warns or becomes a CLI usage error. */\nexport function parsePolicyEntry(\n  key: string,\n  value: unknown,\n):\n  | { ok: true; key: \"requiredHeaders\"; value: \"off\" | \"enforce\" }\n  | { ok: true; key: \"authErrors\" | \"modelCatalog\"; value: \"legacy\" | \"native\" }\n  | { ok: false; reason: string } {\n  if (key === \"requiredHeaders\") {\n    const normalized = typeof value === \"string\" ? value.toLowerCase() : undefined;\n    if (normalized === \"off\" || normalized === \"enforce\") {\n      return { ok: true, key, value: normalized };\n    }\n    return { ok: false, reason: 'expected \"off\" or \"enforce\".' };\n  }\n  if (key === \"authErrors\" || key === \"modelCatalog\") {\n    const normalized = typeof value === \"string\" ? value.toLowerCase() : undefined;\n    if (normalized === \"legacy\" || normalized === \"native\") {\n      return { ok: true, key, value: normalized };\n    }\n    return { ok: false, reason: 'expected \"legacy\" or \"native\".' };\n  }\n  return { ok: false, reason: \"unknown policy key.\" };\n}\n\n/** Store one parsed entry without widening either key's value type. */\nexport function assignPolicyEntry(\n  target: AimockPolicy,\n  entry: Exclude<ReturnType<typeof parsePolicyEntry>, { ok: false }>,\n): void {\n  if (entry.key === \"requiredHeaders\") target.requiredHeaders = entry.value;\n  else target[entry.key] = entry.value;\n}\n\n/** Parse each programmatic entry independently without changing the caller's object. */\nexport function parsePolicy(value: unknown, warn: (message: string) => void): AimockPolicy {\n  const result: AimockPolicy = {};\n  if (value === undefined) return result;\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    warn(\"Ignoring policy: expected an object.\");\n    return result;\n  }\n  for (const [key, entry] of Object.entries(value)) {\n    const parsed = parsePolicyEntry(key, entry);\n    if (parsed.ok) assignPolicyEntry(result, parsed);\n    else warn(`Ignoring policy.${key}: ${parsed.reason}`);\n  }\n  return result;\n}\n\n/** A bad header entry does not erase a prior valid entry or other policy keys. */\nexport function parsePolicyHeader(\n  rawHeaders: IncomingHttpHeaders | undefined,\n  warn: (message: string) => void,\n): AimockPolicy {\n  const result: AimockPolicy = {};\n  const header = rawHeaders?.[\"x-aimock-policy\"];\n  if (header === undefined) return result;\n  const text = Array.isArray(header) ? header.join(\",\") : header;\n  for (const rawEntry of text.split(\",\")) {\n    const entry = rawEntry.trim();\n    const separator = entry.indexOf(\"=\");\n    if (separator < 0) {\n      warn(`Ignoring policy entry ${JSON.stringify(entry)}: expected key=value.`);\n      continue;\n    }\n    const key = entry.slice(0, separator);\n    const parsed = parsePolicyEntry(key, entry.slice(separator + 1));\n    if (parsed.ok) assignPolicyEntry(result, parsed);\n    else warn(`Ignoring policy.${key}: ${parsed.reason}`);\n  }\n  return result;\n}\n\n/** Resolve from the direct-handler input, preserving the independent legacy strict bit. */\nexport function resolvePolicy(\n  defaults: HandlerDefaults,\n  rawHeaders?: IncomingHttpHeaders,\n  warn: (message: string) => void = (message) => defaults.logger.warn(message),\n) {\n  const strict = resolveStrictMode(defaults.strict, rawHeaders);\n  const server = parsePolicy(defaults.policy, warn);\n  const request = parsePolicyHeader(rawHeaders, warn);\n  return Object.freeze({\n    strict,\n    requiredHeaders: request.requiredHeaders ?? server.requiredHeaders ?? \"off\",\n    authErrors: request.authErrors ?? server.authErrors ?? \"legacy\",\n    modelCatalog: request.modelCatalog ?? server.modelCatalog ?? \"legacy\",\n  });\n}\n\n/** Preserve the legacy request strict header grammar and server fallback. */\nexport function resolveStrictMode(\n  serverDefault: boolean | undefined,\n  rawHeaders?: IncomingHttpHeaders,\n): boolean {\n  if (rawHeaders) {\n    const header = rawHeaders[\"x-aimock-strict\"];\n    const rawVal =\n      typeof header === \"string\" ? header : Array.isArray(header) ? header[0] : undefined;\n    if (typeof rawVal === \"string\") {\n      const val = rawVal.trim().toLowerCase();\n      if (val === \"true\" || val === \"1\") return true;\n      if (val === \"false\" || val === \"0\") return false;\n    }\n  }\n  return serverDefault ?? false;\n}\n\n/** Journal fields retain their existing omitted-versus-overridden shape. */\nexport function strictOverrideField(\n  serverDefault: boolean | undefined,\n  rawHeaders?: IncomingHttpHeaders,\n): { strictOverride?: boolean } {\n  const effective = resolveStrictMode(serverDefault, rawHeaders);\n  if (effective !== (serverDefault ?? false)) {\n    return { strictOverride: effective };\n  }\n  return {};\n}\n\n/** Named legacy decisions share one header read at the caller's existing site. */\nexport function resolveRequestDecisions(\n  serverDefault: boolean | undefined,\n  rawHeaders?: IncomingHttpHeaders,\n) {\n  const strict = resolveStrictMode(serverDefault, rawHeaders);\n  return Object.freeze({\n    strict,\n    fixtureMiss: strict,\n    upstream: !strict,\n    reasoningSuppression: strict,\n    thinkingRejection: strict,\n    mcpRecordingStrict: strict,\n    strictOverride: strict !== (serverDefault ?? false) ? strict : undefined,\n  });\n}\n"],"mappings":"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"}