@moldea.ai/core 5.0.1 → 7.0.0

package/dist/chunks/errors-BE4DS3Ak.js

@@ -0,0 +1,435 @@
+import { a as isCoreOperationErrorCode, i as isCoreOperation, n as CoreOperationException, r as isCoreConfigurationErrorCode, t as CoreConfigurationException } from "./exceptions-IXsorE8t.js";
+import { RepositoryPathException, RepositorySourceException, isRepositoryPath } from "@moldea.ai/repository";
+import { Buffer } from "node:buffer";
+//#region src/node-inspection/constants.ts
+var NODE_INSPECTION_LIFETIME_MS = 12e4;
+var NODE_INSPECTION_TERMINATION_GRACE_MS = 1e3;
+var NODE_INSPECTION_FILE_PAGE_BYTES = 65536;
+var NODE_INSPECTION_MESSAGE_BYTES = 1048576;
+var NODE_INSPECTION_STDIO_BYTES = 32768;
+var NODE_INSPECTION_TRANSPORT_BYTES = 4 * NODE_INSPECTION_MESSAGE_BYTES * 2 * 2 * 3;
+var NODE_INSPECTION_PROFILE = Object.freeze({
+	lifetimeMs: NODE_INSPECTION_LIFETIME_MS,
+	terminationGraceMs: NODE_INSPECTION_TERMINATION_GRACE_MS,
+	maxReaderRequests: 4,
+	maxFilePageBytes: NODE_INSPECTION_FILE_PAGE_BYTES,
+	maxMessageBytes: NODE_INSPECTION_MESSAGE_BYTES,
+	maxStdioBytes: NODE_INSPECTION_STDIO_BYTES,
+	transportBytes: NODE_INSPECTION_TRANSPORT_BYTES,
+	oldGenerationMiB: 512,
+	youngGenerationMiB: 24
+});
+//#endregion
+//#region src/node-inspection/protocol.ts
+/** Creates the safe failure for an untrusted or inconsistent private protocol record. */
+var createInspectionProcessFailure = (cause) => new CoreOperationException({
+	code: "INSPECTION_PROCESS_FAILED",
+	operation: "create-project-inspection",
+	...cause === void 0 ? {} : { cause }
+});
+var isRecord = (input) => input !== null && typeof input === "object" && !Array.isArray(input);
+var JSON_SHORT_ESCAPES = /* @__PURE__ */ new Set([
+	8,
+	9,
+	10,
+	12,
+	13
+]);
+var isInteger = (input) => typeof input === "number" && Number.isSafeInteger(input) && input >= 0;
+var hasKeys = (input, required, optional = []) => required.every((key) => Object.hasOwn(input, key)) && Object.keys(input).every((key) => required.includes(key) || optional.includes(key));
+var isSnapshot = (input) => isRecord(input) && hasKeys(input, ["id", "sourceKind"]) && typeof input["id"] === "string" && input["id"].length > 0 && typeof input["sourceKind"] === "string" && input["sourceKind"].length > 0;
+var isOptionalString = (input, key) => !Object.hasOwn(input, key) || typeof input[key] === "string";
+var isPageInput = (input) => isRecord(input) && hasKeys(input, ["maxItems", "view"], ["cursor"]) && isInteger(input["maxItems"]) && input["maxItems"] > 0 && [
+	"all",
+	"diagnostics",
+	"coverage",
+	"metadata"
+].includes(String(input["view"])) && isOptionalString(input, "cursor");
+var isLimits = (input) => isRecord(input) && hasKeys(input, [
+	"maxEntries",
+	"maxTotalBytesRead",
+	"maxFileBytes",
+	"maxManifestBytes",
+	"maxRetainedBytes",
+	"maxDiagnostics",
+	"maxCoverage",
+	"maxAcceptedWarnings"
+]) && Object.values(input).every((limit) => isInteger(limit) && limit > 0);
+var isCounts = (input) => isRecord(input) && hasKeys(input, [
+	"agents",
+	"context",
+	"decisions",
+	"mirrors",
+	"runtimes",
+	"unresolved",
+	"diagnostics",
+	"errors",
+	"warnings",
+	"acceptedWarnings",
+	"coverage",
+	"metadata"
+]) && Object.values(input).every(isInteger);
+var isSummary = (input) => input === null || isRecord(input) && hasKeys(input, [
+	"counts",
+	"manifestDigest",
+	"manifestPath",
+	"projectDigest",
+	"projectPath"
+]) && isRecord(input["counts"]) && hasKeys(input["counts"], [
+	"agents",
+	"context",
+	"decisions",
+	"mirrors",
+	"runtimes",
+	"unresolved"
+]) && Object.values(input["counts"]).every(isInteger) && typeof input["manifestDigest"] === "string" && typeof input["projectDigest"] === "string" && isRepositoryPath(input["manifestPath"]) && isRepositoryPath(input["projectPath"]);
+var isInspectionBase = (input) => isCounts(input["counts"]) && isRecord(input["coverageCounts"]) && hasKeys(input["coverageCounts"], [
+	"bindings",
+	"exportsPassed",
+	"exportsFailed",
+	"exportsNotChecked"
+]) && Object.values(input["coverageCounts"]).every(isInteger) && typeof input["valid"] === "boolean" && (input["formatVersion"] === null || input["formatVersion"] === 1) && typeof input["inspectionDigest"] === "string" && isSnapshot(input["source"]) && isSummary(input["summary"]);
+var INSPECTION_KEYS = [
+	"counts",
+	"coverageCounts",
+	"valid",
+	"formatVersion",
+	"inspectionDigest",
+	"source",
+	"summary"
+];
+var isMetadata = (input) => isRecord(input) && hasKeys(input, [
+	...INSPECTION_KEYS,
+	"resourceUsage",
+	"maxAnalysisHeapBytes"
+]) && isInspectionBase(input) && isInteger(input["maxAnalysisHeapBytes"]) && input["maxAnalysisHeapBytes"] > 0 && isRecord(input["resourceUsage"]) && hasKeys(input["resourceUsage"], [
+	"canonicalBytes",
+	"peakRetainedBytes",
+	"preparedBytes",
+	"retainedBytes",
+	"totalBytesRead"
+]) && Object.values(input["resourceUsage"]).every(isInteger);
+var isPage = (input) => isRecord(input) && hasKeys(input, [
+	...INSPECTION_KEYS,
+	"page",
+	"view"
+]) && isInspectionBase(input) && [
+	"all",
+	"diagnostics",
+	"coverage",
+	"metadata"
+].includes(String(input["view"])) && isRecord(input["page"]) && hasKeys(input["page"], [
+	"isComplete",
+	"records",
+	"nextCursor",
+	"totalItems"
+]) && typeof input["page"]["isComplete"] === "boolean" && isInteger(input["page"]["totalItems"]) && (input["page"]["nextCursor"] === null || typeof input["page"]["nextCursor"] === "string") && Array.isArray(input["page"]["records"]) && input["page"]["records"].every((record) => isRecord(record) && hasKeys(record, ["item", "nextCursor"]) && (record["nextCursor"] === null || typeof record["nextCursor"] === "string") && isRecord(record["item"]) && typeof record["item"]["kind"] === "string" && [
+	"agent",
+	"diagnostic",
+	"coverage",
+	"metadata"
+].includes(record["item"]["kind"]) && hasKeys(record["item"], ["kind", record["item"]["kind"]]) && isRecord(record["item"][record["item"]["kind"]]));
+var isRequest = (input) => {
+	if (!isRecord(input)) return false;
+	switch (input["method"]) {
+		case "getEntry": return hasKeys(input, ["method", "path"]) && isRepositoryPath(input["path"]);
+		case "listEntriesPage": return hasKeys(input, ["method", "maxEntries"], ["cursor", "prefix"]) && isInteger(input["maxEntries"]) && input["maxEntries"] > 0 && input["maxEntries"] <= 128 && isOptionalString(input, "cursor") && (!Object.hasOwn(input, "prefix") || isRepositoryPath(input["prefix"]));
+		case "readFilePage": return hasKeys(input, [
+			"method",
+			"path",
+			"maxBytes",
+			"offset"
+		]) && isRepositoryPath(input["path"]) && isInteger(input["offset"]) && isInteger(input["maxBytes"]) && input["maxBytes"] > 0 && input["maxBytes"] <= 65536;
+		default: return false;
+	}
+};
+/** Validates closed control envelopes and their typed operation payloads on both bridges. */
+var isMessage = (input) => {
+	if (!isRecord(input) || typeof input["attemptId"] !== "string" || !/^[a-f0-9]{32}$/.test(input["attemptId"])) return false;
+	const keys = ["attemptId", "kind"];
+	switch (input["kind"]) {
+		case "start": return hasKeys(input, [
+			...keys,
+			"snapshot",
+			"limits",
+			"deadline"
+		]) && isSnapshot(input["snapshot"]) && isLimits(input["limits"]) && isInteger(input["deadline"]);
+		case "ready": return hasKeys(input, [...keys, "maxAnalysisHeapBytes"]) && isInteger(input["maxAnalysisHeapBytes"]) && input["maxAnalysisHeapBytes"] > 0;
+		case "run":
+		case "dispose": return hasKeys(input, keys);
+		case "prepared": return hasKeys(input, [...keys, "inspection"]) && isMetadata(input["inspection"]);
+		case "read-page": return hasKeys(input, [
+			...keys,
+			"requestId",
+			"input"
+		]) && isInteger(input["requestId"]) && isPageInput(input["input"]);
+		case "page": return hasKeys(input, [
+			...keys,
+			"requestId",
+			"result"
+		]) && isInteger(input["requestId"]) && isPage(input["result"]);
+		case "reader-request": return hasKeys(input, [
+			...keys,
+			"requestId",
+			"request"
+		]) && isInteger(input["requestId"]) && isRequest(input["request"]);
+		case "reader-response": return hasKeys(input, [
+			...keys,
+			"requestId",
+			"result"
+		]) && isInteger(input["requestId"]);
+		case "reader-failure":
+		case "failure": return hasKeys(input, [
+			...keys,
+			"failure",
+			...input["kind"] === "reader-failure" ? ["requestId"] : []
+		]) && (input["kind"] !== "reader-failure" || isInteger(input["requestId"])) && isRecord(input["failure"]) && hasKeys(input["failure"], ["family", "options"]) && [
+			"configuration",
+			"operation",
+			"repository",
+			"path"
+		].includes(String(input["failure"]["family"])) && isRecord(input["failure"]["options"]);
+		default: return false;
+	}
+};
+/** Counts escaped JSON bytes without first allocating a serialized oversized message. */
+var countJsonBytes = (input, ancestors, depth) => {
+	if (depth > 64) throw createInspectionProcessFailure();
+	if (input === null) return 4;
+	if (typeof input === "boolean") return input ? 4 : 5;
+	if (typeof input === "number" && Number.isFinite(input)) return String(input).length;
+	if (typeof input === "string") {
+		let bytes = 2;
+		for (let index = 0; index < input.length; index++) {
+			const code = input.charCodeAt(index);
+			if (code === 34 || code === 92 || JSON_SHORT_ESCAPES.has(code)) bytes += 2;
+			else if (code < 32) bytes += 6;
+			else if (code < 128) bytes++;
+			else if (code < 2048) bytes += 2;
+			else if (code >= 55296 && code <= 56319 && index + 1 < input.length && input.charCodeAt(index + 1) >= 56320 && input.charCodeAt(index + 1) <= 57343) {
+				bytes += 4;
+				index++;
+			} else bytes += code >= 55296 && code <= 57343 ? 6 : 3;
+			if (bytes > 1048576) return bytes;
+		}
+		return bytes;
+	}
+	if (typeof input !== "object" || ancestors.has(input)) throw createInspectionProcessFailure();
+	ancestors.add(input);
+	let bytes = 2;
+	let count = 0;
+	if (Array.isArray(input)) for (const element of input) {
+		bytes += (count++ === 0 ? 0 : 1) + countJsonBytes(element, ancestors, depth + 1);
+		if (bytes > 1048576) break;
+	}
+	else for (const key in input) {
+		if (!Object.hasOwn(input, key)) continue;
+		bytes += (count++ === 0 ? 0 : 1) + countJsonBytes(key, ancestors, depth + 1) + 1 + countJsonBytes(input[key], ancestors, depth + 1);
+		if (bytes > 1048576) break;
+	}
+	ancestors.delete(input);
+	return bytes;
+};
+/**
+* Admits a complete bounded record before serialization; no record is truncated.
+* @returns One private JSON frame.
+* @throws
+* - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+* - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.
+*/
+var encodeInspectionMessage = (message) => {
+	const bytes = countJsonBytes(message, /* @__PURE__ */ new WeakSet(), 0);
+	if (bytes > 1048576) throw new CoreOperationException({
+		code: "RESOURCE_LIMIT_EXCEEDED",
+		limit: "maxInspectionMessageBytes",
+		limitMaximum: NODE_INSPECTION_MESSAGE_BYTES,
+		observedUsage: bytes,
+		nextAction: null,
+		operation: "create-project-inspection"
+	});
+	if (!isMessage(message)) throw createInspectionProcessFailure();
+	return JSON.stringify(message);
+};
+/**
+* Checks frame size before parsing and validates the closed message contract.
+* @returns A validated private message.
+* @throws
+* - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.
+*/
+var decodeInspectionMessage = (frame) => {
+	if (typeof frame !== "string" || Buffer.byteLength(frame) > 1048576) throw createInspectionProcessFailure();
+	let message;
+	try {
+		message = JSON.parse(frame);
+	} catch (cause) {
+		throw createInspectionProcessFailure(cause);
+	}
+	if (!isMessage(message)) throw createInspectionProcessFailure();
+	return message;
+};
+//#endregion
+//#region src/node-inspection/errors.ts
+/** Serializes only documented exception fields, excluding native messages, causes and stacks. */
+var serializeInspectionFailure = (error) => {
+	if (error instanceof CoreConfigurationException) return {
+		family: "configuration",
+		options: {
+			code: error.code,
+			operation: error.operation
+		}
+	};
+	if (error instanceof CoreOperationException) return {
+		family: "operation",
+		options: {
+			code: error.code,
+			operation: error.operation,
+			...error.agentId === null ? {} : { agentId: error.agentId },
+			...error.code !== "RESOURCE_LIMIT_EXCEEDED" ? {} : {
+				limit: error.limit,
+				limitMaximum: error.limitMaximum,
+				nextAction: error.nextAction,
+				observedUsage: error.observedUsage
+			}
+		}
+	};
+	if (error instanceof RepositoryPathException) return {
+		family: "path",
+		options: {}
+	};
+	if (error instanceof RepositorySourceException) return {
+		family: "repository",
+		options: {
+			code: error.code,
+			operation: error.operation,
+			path: error.path,
+			retryable: error.retryable,
+			...error.resource === null ? {} : { resource: error.resource }
+		}
+	};
+	return {
+		family: "operation",
+		options: {
+			code: "INSPECTION_PROCESS_FAILED",
+			operation: "create-project-inspection"
+		}
+	};
+};
+var REPOSITORY_CODES = [
+	"ENTRY_NOT_FOUND",
+	"ENTRY_NOT_FILE",
+	"ENTRY_NOT_DIRECTORY",
+	"INVALID_PAGE_REQUEST",
+	"ACCESS_DENIED",
+	"SOURCE_UNAVAILABLE",
+	"SNAPSHOT_CHANGED",
+	"PROVIDER_INCOMPLETE",
+	"INVALID_SOURCE_DATA",
+	"RESOURCE_LIMIT_EXCEEDED",
+	"ABORTED"
+];
+var REPOSITORY_OPERATIONS = [
+	"create-reader",
+	"create-comparison",
+	"get-entry",
+	"read-file-page",
+	"list-entries-page",
+	"list-changes-page"
+];
+var isNumber = (input) => typeof input === "number" && Number.isSafeInteger(input) && input >= 0;
+/**
+* Reconstructs a documented typed failure after checking its safe transport fields.
+* @returns A package exception without a remote native cause or stack.
+* @throws
+* - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.
+*/
+var deserializeInspectionFailure = (failure) => {
+	const options = failure.options;
+	const allowed = failure.family === "configuration" ? ["code", "operation"] : failure.family === "operation" ? [
+		"code",
+		"operation",
+		"agentId",
+		"limit",
+		"limitMaximum",
+		"nextAction",
+		"observedUsage"
+	] : failure.family === "repository" ? [
+		"code",
+		"operation",
+		"path",
+		"retryable",
+		"resource"
+	] : [];
+	if (Object.keys(options).some((key) => !allowed.includes(key)) || Object.hasOwn(options, "agentId") && typeof options["agentId"] !== "string") throw createInspectionProcessFailure();
+	if ((failure.family === "operation" || failure.family === "configuration") && !isCoreOperation(options["operation"])) throw createInspectionProcessFailure();
+	const scope = {
+		operation: isCoreOperation(options["operation"]) ? options["operation"] : "create-project-inspection",
+		...typeof options["agentId"] === "string" ? { agentId: options["agentId"] } : {}
+	};
+	if (failure.family === "path" && Object.keys(options).length === 0) return new RepositoryPathException();
+	if (failure.family === "configuration") {
+		const code = options["code"];
+		if (isCoreConfigurationErrorCode(code)) return new CoreConfigurationException({
+			...scope,
+			code
+		});
+	}
+	if (failure.family === "operation") {
+		const code = options["code"];
+		if (isCoreOperationErrorCode(code) && code !== "RESOURCE_LIMIT_EXCEEDED" && ![
+			"limit",
+			"limitMaximum",
+			"nextAction",
+			"observedUsage"
+		].some((key) => Object.hasOwn(options, key))) return new CoreOperationException({
+			...scope,
+			code
+		});
+		if (options["code"] === "RESOURCE_LIMIT_EXCEEDED" && isNumber(options["limitMaximum"]) && options["limitMaximum"] > 0) {
+			if (options["limit"] === "maxAnalysisHeapBytes" && options["nextAction"] === "review-inspection-capacity" && options["observedUsage"] === null) return new CoreOperationException({
+				...scope,
+				code: "RESOURCE_LIMIT_EXCEEDED",
+				limit: "maxAnalysisHeapBytes",
+				limitMaximum: options["limitMaximum"],
+				observedUsage: null,
+				nextAction: "review-inspection-capacity"
+			});
+			if ((options["limit"] === "maxInspectionMessageBytes" || options["limit"] === "maxReaderRequests") && options["nextAction"] === null && isNumber(options["observedUsage"])) return new CoreOperationException({
+				...scope,
+				code: "RESOURCE_LIMIT_EXCEEDED",
+				limit: options["limit"],
+				limitMaximum: options["limitMaximum"],
+				nextAction: null,
+				observedUsage: options["observedUsage"]
+			});
+			if (typeof options["limit"] === "string" && ![
+				"maxAnalysisHeapBytes",
+				"maxInspectionMessageBytes",
+				"maxReaderRequests"
+			].includes(options["limit"]) && options["nextAction"] === "reduce-input-or-increase-limit" && isNumber(options["observedUsage"])) return new CoreOperationException({
+				...scope,
+				code: "RESOURCE_LIMIT_EXCEEDED",
+				limit: options["limit"],
+				limitMaximum: options["limitMaximum"],
+				nextAction: "reduce-input-or-increase-limit",
+				observedUsage: options["observedUsage"]
+			});
+		}
+	}
+	if (failure.family === "repository") {
+		const code = REPOSITORY_CODES.find((candidate) => candidate === options["code"]);
+		const operation = REPOSITORY_OPERATIONS.find((candidate) => candidate === options["operation"]);
+		const resource = options["resource"];
+		if (code !== void 0 && operation !== void 0 && typeof options["retryable"] === "boolean" && (options["path"] === null || isRepositoryPath(options["path"])) && (resource === void 0 || resource !== null && typeof resource === "object" && Object.keys(resource).length === 3 && "dimension" in resource && typeof resource.dimension === "string" && "limit" in resource && isNumber(resource.limit) && "observed" in resource && isNumber(resource.observed))) return new RepositorySourceException({
+			code,
+			operation,
+			path: options["path"],
+			retryable: options["retryable"],
+			...resource === void 0 ? {} : { resource }
+		});
+	}
+	throw createInspectionProcessFailure();
+};
+//#endregion
+export { encodeInspectionMessage as a, NODE_INSPECTION_PROFILE as c, NODE_INSPECTION_TRANSPORT_BYTES as d, decodeInspectionMessage as i, NODE_INSPECTION_STDIO_BYTES as l, serializeInspectionFailure as n, NODE_INSPECTION_FILE_PAGE_BYTES as o, createInspectionProcessFailure as r, NODE_INSPECTION_LIFETIME_MS as s, deserializeInspectionFailure as t, NODE_INSPECTION_TERMINATION_GRACE_MS as u };
+
+//# sourceMappingURL=errors-BE4DS3Ak.js.map

package/dist/chunks/errors-BE4DS3Ak.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-BE4DS3Ak.js","names":[],"sources":["../../src/node-inspection/constants.ts","../../src/node-inspection/protocol.ts","../../src/node-inspection/errors.ts"],"sourcesContent":["// whole-attempt lifetime and bounded bridge ownership, independent of source file size\nexport const NODE_INSPECTION_LIFETIME_MS = 120_000;\nexport const NODE_INSPECTION_TERMINATION_GRACE_MS = 1_000;\nexport const NODE_INSPECTION_MAX_REQUESTS = 4;\nexport const NODE_INSPECTION_FILE_PAGE_BYTES = 65_536;\nexport const NODE_INSPECTION_MESSAGE_BYTES = 1_048_576;\nexport const NODE_INSPECTION_STDIO_BYTES = 32_768;\n\n// two UTF-16 bytes per serialized byte, two copies at each owner, for every RPC credit\nexport const NODE_INSPECTION_TRANSPORT_BYTES =\n  NODE_INSPECTION_MAX_REQUESTS * NODE_INSPECTION_MESSAGE_BYTES * 2 * 2 * 3;\n\n// fixed profile qualified in the constrained CLI and actual-worker lanes\nexport const NODE_INSPECTION_OLD_GENERATION_MIB = 512;\nexport const NODE_INSPECTION_YOUNG_GENERATION_MIB = 24;\n\n// immutable execution identity for consumers that authenticate prepared inspection state\nexport const NODE_INSPECTION_PROFILE = Object.freeze({\n  lifetimeMs: NODE_INSPECTION_LIFETIME_MS,\n  terminationGraceMs: NODE_INSPECTION_TERMINATION_GRACE_MS,\n  maxReaderRequests: NODE_INSPECTION_MAX_REQUESTS,\n  maxFilePageBytes: NODE_INSPECTION_FILE_PAGE_BYTES,\n  maxMessageBytes: NODE_INSPECTION_MESSAGE_BYTES,\n  maxStdioBytes: NODE_INSPECTION_STDIO_BYTES,\n  transportBytes: NODE_INSPECTION_TRANSPORT_BYTES,\n  oldGenerationMiB: NODE_INSPECTION_OLD_GENERATION_MIB,\n  youngGenerationMiB: NODE_INSPECTION_YOUNG_GENERATION_MIB,\n});\n","import { Buffer } from 'node:buffer';\n\nimport { isRepositoryPath } from '@moldea.ai/repository';\n\nimport type { ICoreResourceLimits } from '../contracts/index.js';\nimport { CoreOperationException } from '../exceptions/index.js';\n\nimport { NODE_INSPECTION_FILE_PAGE_BYTES, NODE_INSPECTION_MESSAGE_BYTES } from './constants.js';\nimport type { INodeInspectionMessage } from './types.js';\n\n/** Creates the safe failure for an untrusted or inconsistent private protocol record. */\nexport const createInspectionProcessFailure = (cause?: unknown): CoreOperationException =>\n  new CoreOperationException({\n    code: 'INSPECTION_PROCESS_FAILED',\n    operation: 'create-project-inspection',\n    ...(cause === undefined ? {} : { cause }),\n  });\n\nconst isRecord = (input: unknown): input is Record<string, unknown> =>\n  input !== null && typeof input === 'object' && !Array.isArray(input);\nconst JSON_SHORT_ESCAPES = new Set([8, 9, 10, 12, 13]);\nconst isInteger = (input: unknown): input is number =>\n  typeof input === 'number' && Number.isSafeInteger(input) && input >= 0;\nconst hasKeys = (\n  input: Record<string, unknown>,\n  required: string[],\n  optional: string[] = [],\n): boolean =>\n  required.every((key) => Object.hasOwn(input, key)) &&\n  Object.keys(input).every((key) => required.includes(key) || optional.includes(key));\nconst isSnapshot = (input: unknown): boolean =>\n  isRecord(input) &&\n  hasKeys(input, ['id', 'sourceKind']) &&\n  typeof input['id'] === 'string' &&\n  input['id'].length > 0 &&\n  typeof input['sourceKind'] === 'string' &&\n  input['sourceKind'].length > 0;\nconst isOptionalString = (input: Record<string, unknown>, key: string): boolean =>\n  !Object.hasOwn(input, key) || typeof input[key] === 'string';\nconst isPageInput = (input: unknown): boolean =>\n  isRecord(input) &&\n  hasKeys(input, ['maxItems', 'view'], ['cursor']) &&\n  isInteger(input['maxItems']) &&\n  input['maxItems'] > 0 &&\n  ['all', 'diagnostics', 'coverage', 'metadata'].includes(String(input['view'])) &&\n  isOptionalString(input, 'cursor');\nconst isLimits = (input: unknown): input is ICoreResourceLimits =>\n  isRecord(input) &&\n  hasKeys(input, [\n    'maxEntries',\n    'maxTotalBytesRead',\n    'maxFileBytes',\n    'maxManifestBytes',\n    'maxRetainedBytes',\n    'maxDiagnostics',\n    'maxCoverage',\n    'maxAcceptedWarnings',\n  ]) &&\n  Object.values(input).every((limit) => isInteger(limit) && limit > 0);\nconst isCounts = (input: unknown): boolean =>\n  isRecord(input) &&\n  hasKeys(input, [\n    'agents',\n    'context',\n    'decisions',\n    'mirrors',\n    'runtimes',\n    'unresolved',\n    'diagnostics',\n    'errors',\n    'warnings',\n    'acceptedWarnings',\n    'coverage',\n    'metadata',\n  ]) &&\n  Object.values(input).every(isInteger);\nconst isSummary = (input: unknown): boolean =>\n  input === null ||\n  (isRecord(input) &&\n    hasKeys(input, ['counts', 'manifestDigest', 'manifestPath', 'projectDigest', 'projectPath']) &&\n    isRecord(input['counts']) &&\n    hasKeys(input['counts'], [\n      'agents',\n      'context',\n      'decisions',\n      'mirrors',\n      'runtimes',\n      'unresolved',\n    ]) &&\n    Object.values(input['counts']).every(isInteger) &&\n    typeof input['manifestDigest'] === 'string' &&\n    typeof input['projectDigest'] === 'string' &&\n    isRepositoryPath(input['manifestPath']) &&\n    isRepositoryPath(input['projectPath']));\nconst isInspectionBase = (input: Record<string, unknown>): boolean =>\n  isCounts(input['counts']) &&\n  isRecord(input['coverageCounts']) &&\n  hasKeys(input['coverageCounts'], [\n    'bindings',\n    'exportsPassed',\n    'exportsFailed',\n    'exportsNotChecked',\n  ]) &&\n  Object.values(input['coverageCounts']).every(isInteger) &&\n  typeof input['valid'] === 'boolean' &&\n  (input['formatVersion'] === null || input['formatVersion'] === 1) &&\n  typeof input['inspectionDigest'] === 'string' &&\n  isSnapshot(input['source']) &&\n  isSummary(input['summary']);\nconst INSPECTION_KEYS = [\n  'counts',\n  'coverageCounts',\n  'valid',\n  'formatVersion',\n  'inspectionDigest',\n  'source',\n  'summary',\n];\nconst isMetadata = (input: unknown): boolean =>\n  isRecord(input) &&\n  hasKeys(input, [...INSPECTION_KEYS, 'resourceUsage', 'maxAnalysisHeapBytes']) &&\n  isInspectionBase(input) &&\n  isInteger(input['maxAnalysisHeapBytes']) &&\n  input['maxAnalysisHeapBytes'] > 0 &&\n  isRecord(input['resourceUsage']) &&\n  hasKeys(input['resourceUsage'], [\n    'canonicalBytes',\n    'peakRetainedBytes',\n    'preparedBytes',\n    'retainedBytes',\n    'totalBytesRead',\n  ]) &&\n  Object.values(input['resourceUsage']).every(isInteger);\nconst isPage = (input: unknown): boolean =>\n  isRecord(input) &&\n  hasKeys(input, [...INSPECTION_KEYS, 'page', 'view']) &&\n  isInspectionBase(input) &&\n  ['all', 'diagnostics', 'coverage', 'metadata'].includes(String(input['view'])) &&\n  isRecord(input['page']) &&\n  hasKeys(input['page'], ['isComplete', 'records', 'nextCursor', 'totalItems']) &&\n  typeof input['page']['isComplete'] === 'boolean' &&\n  isInteger(input['page']['totalItems']) &&\n  (input['page']['nextCursor'] === null || typeof input['page']['nextCursor'] === 'string') &&\n  Array.isArray(input['page']['records']) &&\n  input['page']['records'].every(\n    (record: unknown) =>\n      isRecord(record) &&\n      hasKeys(record, ['item', 'nextCursor']) &&\n      (record['nextCursor'] === null || typeof record['nextCursor'] === 'string') &&\n      isRecord(record['item']) &&\n      typeof record['item']['kind'] === 'string' &&\n      ['agent', 'diagnostic', 'coverage', 'metadata'].includes(record['item']['kind']) &&\n      hasKeys(record['item'], ['kind', record['item']['kind']]) &&\n      isRecord(record['item'][record['item']['kind']]),\n  );\nconst isRequest = (input: unknown): boolean => {\n  if (!isRecord(input)) return false;\n  switch (input['method']) {\n    case 'getEntry':\n      return hasKeys(input, ['method', 'path']) && isRepositoryPath(input['path']);\n    case 'listEntriesPage':\n      return (\n        hasKeys(input, ['method', 'maxEntries'], ['cursor', 'prefix']) &&\n        isInteger(input['maxEntries']) &&\n        input['maxEntries'] > 0 &&\n        input['maxEntries'] <= 128 &&\n        isOptionalString(input, 'cursor') &&\n        (!Object.hasOwn(input, 'prefix') || isRepositoryPath(input['prefix']))\n      );\n    case 'readFilePage':\n      return (\n        hasKeys(input, ['method', 'path', 'maxBytes', 'offset']) &&\n        isRepositoryPath(input['path']) &&\n        isInteger(input['offset']) &&\n        isInteger(input['maxBytes']) &&\n        input['maxBytes'] > 0 &&\n        input['maxBytes'] <= NODE_INSPECTION_FILE_PAGE_BYTES\n      );\n    default:\n      return false;\n  }\n};\n\n/** Validates closed control envelopes and their typed operation payloads on both bridges. */\nconst isMessage = (input: unknown): input is INodeInspectionMessage => {\n  if (\n    !isRecord(input) ||\n    typeof input['attemptId'] !== 'string' ||\n    !/^[a-f0-9]{32}$/.test(input['attemptId'])\n  )\n    return false;\n  const keys = ['attemptId', 'kind'];\n  switch (input['kind']) {\n    case 'start':\n      return (\n        hasKeys(input, [...keys, 'snapshot', 'limits', 'deadline']) &&\n        isSnapshot(input['snapshot']) &&\n        isLimits(input['limits']) &&\n        isInteger(input['deadline'])\n      );\n    case 'ready':\n      return (\n        hasKeys(input, [...keys, 'maxAnalysisHeapBytes']) &&\n        isInteger(input['maxAnalysisHeapBytes']) &&\n        input['maxAnalysisHeapBytes'] > 0\n      );\n    case 'run':\n    case 'dispose':\n      return hasKeys(input, keys);\n    case 'prepared':\n      return hasKeys(input, [...keys, 'inspection']) && isMetadata(input['inspection']);\n    case 'read-page':\n      return (\n        hasKeys(input, [...keys, 'requestId', 'input']) &&\n        isInteger(input['requestId']) &&\n        isPageInput(input['input'])\n      );\n    case 'page':\n      return (\n        hasKeys(input, [...keys, 'requestId', 'result']) &&\n        isInteger(input['requestId']) &&\n        isPage(input['result'])\n      );\n    case 'reader-request':\n      return (\n        hasKeys(input, [...keys, 'requestId', 'request']) &&\n        isInteger(input['requestId']) &&\n        isRequest(input['request'])\n      );\n    case 'reader-response':\n      return hasKeys(input, [...keys, 'requestId', 'result']) && isInteger(input['requestId']);\n    case 'reader-failure':\n    case 'failure':\n      return (\n        hasKeys(input, [\n          ...keys,\n          'failure',\n          ...(input['kind'] === 'reader-failure' ? ['requestId'] : []),\n        ]) &&\n        (input['kind'] !== 'reader-failure' || isInteger(input['requestId'])) &&\n        isRecord(input['failure']) &&\n        hasKeys(input['failure'], ['family', 'options']) &&\n        ['configuration', 'operation', 'repository', 'path'].includes(\n          String(input['failure']['family']),\n        ) &&\n        isRecord(input['failure']['options'])\n      );\n    default:\n      return false;\n  }\n};\n\n/** Counts escaped JSON bytes without first allocating a serialized oversized message. */\nconst countJsonBytes = (input: unknown, ancestors: WeakSet<object>, depth: number): number => {\n  if (depth > 64) throw createInspectionProcessFailure();\n  if (input === null) return 4;\n  if (typeof input === 'boolean') return input ? 4 : 5;\n  if (typeof input === 'number' && Number.isFinite(input)) return String(input).length;\n  if (typeof input === 'string') {\n    let bytes = 2;\n    for (let index = 0; index < input.length; index++) {\n      const code = input.charCodeAt(index);\n      if (code === 34 || code === 92 || JSON_SHORT_ESCAPES.has(code)) bytes += 2;\n      else if (code < 32) bytes += 6;\n      else if (code < 128) bytes++;\n      else if (code < 2048) bytes += 2;\n      else if (\n        code >= 0xd800 &&\n        code <= 0xdbff &&\n        index + 1 < input.length &&\n        input.charCodeAt(index + 1) >= 0xdc00 &&\n        input.charCodeAt(index + 1) <= 0xdfff\n      ) {\n        bytes += 4;\n        index++;\n      } else bytes += code >= 0xd800 && code <= 0xdfff ? 6 : 3;\n      if (bytes > NODE_INSPECTION_MESSAGE_BYTES) return bytes;\n    }\n    return bytes;\n  }\n  if (typeof input !== 'object' || ancestors.has(input)) throw createInspectionProcessFailure();\n  ancestors.add(input);\n  let bytes = 2;\n  let count = 0;\n  if (Array.isArray(input)) {\n    for (const element of input) {\n      bytes += (count++ === 0 ? 0 : 1) + countJsonBytes(element, ancestors, depth + 1);\n      if (bytes > NODE_INSPECTION_MESSAGE_BYTES) break;\n    }\n  } else {\n    for (const key in input) {\n      if (!Object.hasOwn(input, key)) continue;\n      bytes +=\n        (count++ === 0 ? 0 : 1) +\n        countJsonBytes(key, ancestors, depth + 1) +\n        1 +\n        countJsonBytes((input as Record<string, unknown>)[key], ancestors, depth + 1);\n      if (bytes > NODE_INSPECTION_MESSAGE_BYTES) break;\n    }\n  }\n  ancestors.delete(input);\n  return bytes;\n};\n\n/**\n * Admits a complete bounded record before serialization; no record is truncated.\n * @returns One private JSON frame.\n * @throws\n * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.\n * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.\n */\nexport const encodeInspectionMessage = (message: INodeInspectionMessage): string => {\n  const bytes = countJsonBytes(message, new WeakSet(), 0);\n  if (bytes > NODE_INSPECTION_MESSAGE_BYTES)\n    throw new CoreOperationException({\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n      limit: 'maxInspectionMessageBytes',\n      limitMaximum: NODE_INSPECTION_MESSAGE_BYTES,\n      observedUsage: bytes,\n      nextAction: null,\n      operation: 'create-project-inspection',\n    });\n  if (!isMessage(message)) throw createInspectionProcessFailure();\n  return JSON.stringify(message);\n};\n\n/**\n * Checks frame size before parsing and validates the closed message contract.\n * @returns A validated private message.\n * @throws\n * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.\n */\nexport const decodeInspectionMessage = (frame: unknown): INodeInspectionMessage => {\n  if (typeof frame !== 'string' || Buffer.byteLength(frame) > NODE_INSPECTION_MESSAGE_BYTES)\n    throw createInspectionProcessFailure();\n  let message: unknown;\n  try {\n    message = JSON.parse(frame);\n  } catch (cause) {\n    throw createInspectionProcessFailure(cause);\n  }\n  if (!isMessage(message)) throw createInspectionProcessFailure();\n  return message;\n};\n","import {\n  RepositoryPathException,\n  RepositorySourceException,\n  isRepositoryPath,\n  type IRepositoryOperation,\n  type IRepositorySourceErrorCode,\n} from '@moldea.ai/repository';\n\nimport {\n  CoreConfigurationException,\n  CoreOperationException,\n  isCoreConfigurationErrorCode,\n  isCoreOperation,\n  isCoreOperationErrorCode,\n} from '../exceptions/index.js';\n\nimport { createInspectionProcessFailure } from './protocol.js';\nimport type { INodeInspectionFailure } from './types.js';\n\n/** Serializes only documented exception fields, excluding native messages, causes and stacks. */\nexport const serializeInspectionFailure = (error: unknown): INodeInspectionFailure => {\n  if (error instanceof CoreConfigurationException)\n    return {\n      family: 'configuration',\n      options: {\n        code: error.code,\n        operation: error.operation,\n      },\n    };\n  if (error instanceof CoreOperationException)\n    return {\n      family: 'operation',\n      options: {\n        code: error.code,\n        operation: error.operation,\n        ...(error.agentId === null ? {} : { agentId: error.agentId }),\n        ...(error.code !== 'RESOURCE_LIMIT_EXCEEDED'\n          ? {}\n          : {\n              limit: error.limit,\n              limitMaximum: error.limitMaximum,\n              nextAction: error.nextAction,\n              observedUsage: error.observedUsage,\n            }),\n      },\n    };\n  if (error instanceof RepositoryPathException) return { family: 'path', options: {} };\n  if (error instanceof RepositorySourceException)\n    return {\n      family: 'repository',\n      options: {\n        code: error.code,\n        operation: error.operation,\n        path: error.path,\n        retryable: error.retryable,\n        ...(error.resource === null ? {} : { resource: error.resource }),\n      },\n    };\n  return {\n    family: 'operation',\n    options: {\n      code: 'INSPECTION_PROCESS_FAILED',\n      operation: 'create-project-inspection',\n    },\n  };\n};\nconst REPOSITORY_CODES: IRepositorySourceErrorCode[] = [\n  'ENTRY_NOT_FOUND',\n  'ENTRY_NOT_FILE',\n  'ENTRY_NOT_DIRECTORY',\n  'INVALID_PAGE_REQUEST',\n  'ACCESS_DENIED',\n  'SOURCE_UNAVAILABLE',\n  'SNAPSHOT_CHANGED',\n  'PROVIDER_INCOMPLETE',\n  'INVALID_SOURCE_DATA',\n  'RESOURCE_LIMIT_EXCEEDED',\n  'ABORTED',\n];\nconst REPOSITORY_OPERATIONS: IRepositoryOperation[] = [\n  'create-reader',\n  'create-comparison',\n  'get-entry',\n  'read-file-page',\n  'list-entries-page',\n  'list-changes-page',\n];\nconst isNumber = (input: unknown): input is number =>\n  typeof input === 'number' && Number.isSafeInteger(input) && input >= 0;\n\n/**\n * Reconstructs a documented typed failure after checking its safe transport fields.\n * @returns A package exception without a remote native cause or stack.\n * @throws\n * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.\n */\nexport const deserializeInspectionFailure = (failure: INodeInspectionFailure): Error => {\n  const options = failure.options;\n  const allowed =\n    failure.family === 'configuration'\n      ? ['code', 'operation']\n      : failure.family === 'operation'\n        ? ['code', 'operation', 'agentId', 'limit', 'limitMaximum', 'nextAction', 'observedUsage']\n        : failure.family === 'repository'\n          ? ['code', 'operation', 'path', 'retryable', 'resource']\n          : [];\n  if (\n    Object.keys(options).some((key) => !allowed.includes(key)) ||\n    (Object.hasOwn(options, 'agentId') && typeof options['agentId'] !== 'string')\n  )\n    throw createInspectionProcessFailure();\n  if (\n    (failure.family === 'operation' || failure.family === 'configuration') &&\n    !isCoreOperation(options['operation'])\n  )\n    throw createInspectionProcessFailure();\n  const scope = {\n    operation: isCoreOperation(options['operation'])\n      ? options['operation']\n      : ('create-project-inspection' as const),\n    ...(typeof options['agentId'] === 'string' ? { agentId: options['agentId'] } : {}),\n  };\n  if (failure.family === 'path' && Object.keys(options).length === 0)\n    return new RepositoryPathException();\n  if (failure.family === 'configuration') {\n    const code = options['code'];\n    if (isCoreConfigurationErrorCode(code))\n      return new CoreConfigurationException({ ...scope, code });\n  }\n  if (failure.family === 'operation') {\n    const code = options['code'];\n    if (\n      isCoreOperationErrorCode(code) &&\n      code !== 'RESOURCE_LIMIT_EXCEEDED' &&\n      !['limit', 'limitMaximum', 'nextAction', 'observedUsage'].some((key) =>\n        Object.hasOwn(options, key),\n      )\n    )\n      return new CoreOperationException({ ...scope, code });\n    if (\n      options['code'] === 'RESOURCE_LIMIT_EXCEEDED' &&\n      isNumber(options['limitMaximum']) &&\n      options['limitMaximum'] > 0\n    ) {\n      if (\n        options['limit'] === 'maxAnalysisHeapBytes' &&\n        options['nextAction'] === 'review-inspection-capacity' &&\n        options['observedUsage'] === null\n      )\n        return new CoreOperationException({\n          ...scope,\n          code: 'RESOURCE_LIMIT_EXCEEDED',\n          limit: 'maxAnalysisHeapBytes',\n          limitMaximum: options['limitMaximum'],\n          observedUsage: null,\n          nextAction: 'review-inspection-capacity',\n        });\n      if (\n        (options['limit'] === 'maxInspectionMessageBytes' ||\n          options['limit'] === 'maxReaderRequests') &&\n        options['nextAction'] === null &&\n        isNumber(options['observedUsage'])\n      )\n        return new CoreOperationException({\n          ...scope,\n          code: 'RESOURCE_LIMIT_EXCEEDED',\n          limit: options['limit'],\n          limitMaximum: options['limitMaximum'],\n          nextAction: null,\n          observedUsage: options['observedUsage'],\n        });\n      if (\n        typeof options['limit'] === 'string' &&\n        !['maxAnalysisHeapBytes', 'maxInspectionMessageBytes', 'maxReaderRequests'].includes(\n          options['limit'],\n        ) &&\n        options['nextAction'] === 'reduce-input-or-increase-limit' &&\n        isNumber(options['observedUsage'])\n      )\n        return new CoreOperationException({\n          ...scope,\n          code: 'RESOURCE_LIMIT_EXCEEDED',\n          limit: options['limit'],\n          limitMaximum: options['limitMaximum'],\n          nextAction: 'reduce-input-or-increase-limit',\n          observedUsage: options['observedUsage'],\n        });\n    }\n  }\n  if (failure.family === 'repository') {\n    const code = REPOSITORY_CODES.find((candidate) => candidate === options['code']);\n    const operation = REPOSITORY_OPERATIONS.find((candidate) => candidate === options['operation']);\n    const resource = options['resource'];\n    if (\n      code !== undefined &&\n      operation !== undefined &&\n      typeof options['retryable'] === 'boolean' &&\n      (options['path'] === null || isRepositoryPath(options['path'])) &&\n      (resource === undefined ||\n        (resource !== null &&\n          typeof resource === 'object' &&\n          Object.keys(resource).length === 3 &&\n          'dimension' in resource &&\n          typeof resource.dimension === 'string' &&\n          'limit' in resource &&\n          isNumber(resource.limit) &&\n          'observed' in resource &&\n          isNumber(resource.observed)))\n    ) {\n      return new RepositorySourceException({\n        code,\n        operation,\n        path: options['path'],\n        retryable: options['retryable'],\n        ...(resource === undefined\n          ? {}\n          : {\n              resource: resource as {\n                dimension: string;\n                limit: number;\n                observed: number;\n              },\n            }),\n      });\n    }\n  }\n  throw createInspectionProcessFailure();\n};\n"],"mappings":"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"}

package/dist/chunks/{exceptions-HS9ofVy2.js → exceptions-IXsorE8t.js}

@@ -1,38 +1,41 @@
 import { Exception } from "error-message-utils";
-//#region src/adapter-retained-memory/index.ts
-var retainedByteReservations = /* @__PURE__ */ new WeakMap();
-/** Registers the retained-memory reservation owned by one inspection session. */
-var registerRuntimeAdapterRetainedByteReservation = (repository, reserve) => {
-	if (retainedByteReservations.has(repository)) throw new TypeError("The runtime adapter repository is already registered.");
-	retainedByteReservations.set(repository, reserve);
-};
-/** Reserves a complete adapter-owned buffer when Core owns the repository session. */
-var reserveRuntimeAdapterRetainedBytesIfTracked = (repository, byteLength) => {
-	const reserve = retainedByteReservations.get(repository);
-	if (reserve !== void 0) reserve(byteLength);
-};
-//#endregion
 //#region src/exceptions/index.ts
-var CONFIGURATION_ERROR_MESSAGES = {
-	DUPLICATE_ADAPTER_ID: "A runtime adapter ID is registered more than once.",
-	INVALID_ADAPTER_DEFINITION: "A runtime adapter definition is invalid.",
-	INVALID_RESOURCE_LIMIT: "A Core resource limit is invalid.",
-	RESERVED_ADAPTER_ID: "A reserved runtime adapter ID was supplied."
-};
+var CORE_OPERATIONS = [
+	"create-core",
+	"normalize-text",
+	"calculate-content-digest",
+	"parse-manifest",
+	"match-manifest-scope",
+	"parse-decision",
+	"create-project-inspection",
+	"read-canonical-content-page",
+	"validate-project"
+];
+var CONFIGURATION_ERROR_MESSAGES = { INVALID_RESOURCE_LIMIT: "A Core resource limit is invalid." };
 var OPERATION_ERROR_MESSAGES = {
 	ABORTED: "The Core operation was aborted.",
-	ADAPTER_EXECUTION_FAILED: "A runtime adapter failed during inspection.",
 	CONTENT_INVALID: "The canonical content is not valid UTF-8 text.",
 	INVALID_ARGUMENT: "The Core operation received an invalid argument.",
+	INSPECTION_BUSY: "Project inspection capacity is busy. Try again shortly.",
+	INSPECTION_TIMEOUT: "The isolated project inspection timed out.",
+	INSPECTION_PROCESS_FAILED: "The isolated project inspection failed.",
 	RESOURCE_LIMIT_EXCEEDED: "A Core resource limit was exceeded."
 };
 var OPERATION_ERROR_RETRYABILITY = {
 	ABORTED: true,
-	ADAPTER_EXECUTION_FAILED: false,
 	CONTENT_INVALID: false,
 	INVALID_ARGUMENT: false,
+	INSPECTION_BUSY: true,
+	INSPECTION_TIMEOUT: true,
+	INSPECTION_PROCESS_FAILED: false,
 	RESOURCE_LIMIT_EXCEEDED: false
 };
+/** Checks a transported operation against the authoritative Core operation set. */
+var isCoreOperation = (input) => CORE_OPERATIONS.some((operation) => operation === input);
+/** Checks a transported configuration code against the authoritative message registry. */
+var isCoreConfigurationErrorCode = (input) => typeof input === "string" && Object.hasOwn(CONFIGURATION_ERROR_MESSAGES, input);
+/** Checks a transported operation code against the authoritative message registry. */
+var isCoreOperationErrorCode = (input) => typeof input === "string" && Object.hasOwn(OPERATION_ERROR_MESSAGES, input);
 var attachCause = (exception, cause) => {
 	if (cause === void 0) return;
 	Object.defineProperty(exception, "cause", {
@@ -46,14 +49,12 @@ var attachCause = (exception, cause) => {
 var CoreConfigurationException = class extends Exception {
 	code;
 	operation;
-	adapterId;
-	/** Creates a configuration exception with safe adapter metadata. */
+	/** Creates a configuration exception with safe operation metadata. */
 	constructor(options) {
 		super(CONFIGURATION_ERROR_MESSAGES[options.code], options.code);
 		this.code = options.code;
 		this.name = "CoreConfigurationException";
 		this.operation = options.operation;
-		this.adapterId = options.adapterId ?? null;
 		attachCause(this, options.cause);
 	}
 };
@@ -62,7 +63,6 @@ var CoreOperationException = class extends Exception {
 	code;
 	operation;
 	retryable;
-	adapterId;
 	agentId;
 	limit;
 	limitMaximum;
@@ -75,7 +75,6 @@ var CoreOperationException = class extends Exception {
 		this.name = "CoreOperationException";
 		this.operation = options.operation;
 		this.retryable = OPERATION_ERROR_RETRYABILITY[options.code];
-		this.adapterId = options.adapterId ?? null;
 		this.agentId = options.agentId ?? null;
 		this.limit = options.limit ?? null;
 		this.limitMaximum = options.limitMaximum ?? null;
@@ -85,6 +84,6 @@ var CoreOperationException = class extends Exception {
 	}
 };
 //#endregion
-export { reserveRuntimeAdapterRetainedBytesIfTracked as i, CoreOperationException as n, registerRuntimeAdapterRetainedByteReservation as r, CoreConfigurationException as t };
+export { isCoreOperationErrorCode as a, isCoreOperation as i, CoreOperationException as n, isCoreConfigurationErrorCode as r, CoreConfigurationException as t };
 
-//# sourceMappingURL=exceptions-HS9ofVy2.js.map
+//# sourceMappingURL=exceptions-IXsorE8t.js.map

package/dist/chunks/exceptions-IXsorE8t.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions-IXsorE8t.js","names":[],"sources":["../../src/exceptions/index.ts"],"sourcesContent":["import { Exception } from 'error-message-utils';\n\n// stable configuration and operation failure codes\nexport type ICoreConfigurationErrorCode = 'INVALID_RESOURCE_LIMIT';\n\nexport type ICoreOperationErrorCode =\n  | 'INVALID_ARGUMENT'\n  | 'ABORTED'\n  | 'RESOURCE_LIMIT_EXCEEDED'\n  | 'INSPECTION_BUSY'\n  | 'INSPECTION_TIMEOUT'\n  | 'INSPECTION_PROCESS_FAILED'\n  | 'CONTENT_INVALID';\n\nconst CORE_OPERATIONS = [\n  'create-core',\n  'normalize-text',\n  'calculate-content-digest',\n  'parse-manifest',\n  'match-manifest-scope',\n  'parse-decision',\n  'create-project-inspection',\n  'read-canonical-content-page',\n  'validate-project',\n] as const;\n\nexport type ICoreOperation = (typeof CORE_OPERATIONS)[number];\n\n// safe construction options for exported Core exceptions\nexport interface ICoreConfigurationExceptionOptions {\n  readonly code: ICoreConfigurationErrorCode;\n  readonly operation: ICoreOperation;\n  readonly cause?: unknown;\n}\n\ninterface ICoreOperationExceptionOptionsBase {\n  readonly operation: ICoreOperation;\n  readonly agentId?: string;\n  readonly cause?: unknown;\n}\n\n// logical budget refusals and verified isolated-worker heap exhaustion\nexport type ICoreResourceLimitNextAction =\n  'reduce-input-or-increase-limit' | 'review-inspection-capacity';\n\nexport type ICoreOperationExceptionOptions = ICoreOperationExceptionOptionsBase &\n  (\n    | {\n        readonly code: 'RESOURCE_LIMIT_EXCEEDED';\n        readonly limit: string;\n        readonly limitMaximum: number;\n        readonly nextAction: 'reduce-input-or-increase-limit';\n        readonly observedUsage: number;\n      }\n    | {\n        readonly code: 'RESOURCE_LIMIT_EXCEEDED';\n        readonly limit: 'maxAnalysisHeapBytes';\n        readonly limitMaximum: number;\n        readonly nextAction: 'review-inspection-capacity';\n        readonly observedUsage: null;\n      }\n    | {\n        readonly code: 'RESOURCE_LIMIT_EXCEEDED';\n        readonly limit: 'maxInspectionMessageBytes' | 'maxReaderRequests';\n        readonly limitMaximum: number;\n        readonly nextAction: null;\n        readonly observedUsage: number;\n      }\n    | {\n        readonly code: Exclude<ICoreOperationErrorCode, 'RESOURCE_LIMIT_EXCEEDED'>;\n        readonly limit?: never;\n        readonly limitMaximum?: never;\n        readonly nextAction?: never;\n        readonly observedUsage?: never;\n      }\n  );\n\nconst CONFIGURATION_ERROR_MESSAGES = {\n  INVALID_RESOURCE_LIMIT: 'A Core resource limit is invalid.',\n} as const satisfies Readonly<Record<ICoreConfigurationErrorCode, string>>;\n\nconst OPERATION_ERROR_MESSAGES = {\n  ABORTED: 'The Core operation was aborted.',\n  CONTENT_INVALID: 'The canonical content is not valid UTF-8 text.',\n  INVALID_ARGUMENT: 'The Core operation received an invalid argument.',\n  INSPECTION_BUSY: 'Project inspection capacity is busy. Try again shortly.',\n  INSPECTION_TIMEOUT: 'The isolated project inspection timed out.',\n  INSPECTION_PROCESS_FAILED: 'The isolated project inspection failed.',\n  RESOURCE_LIMIT_EXCEEDED: 'A Core resource limit was exceeded.',\n} as const satisfies Readonly<Record<ICoreOperationErrorCode, string>>;\n\nconst OPERATION_ERROR_RETRYABILITY = {\n  ABORTED: true,\n  CONTENT_INVALID: false,\n  INVALID_ARGUMENT: false,\n  INSPECTION_BUSY: true,\n  INSPECTION_TIMEOUT: true,\n  INSPECTION_PROCESS_FAILED: false,\n  RESOURCE_LIMIT_EXCEEDED: false,\n} as const satisfies Readonly<Record<ICoreOperationErrorCode, boolean>>;\n\n/** Checks a transported operation against the authoritative Core operation set. */\nexport const isCoreOperation = (input: unknown): input is ICoreOperation =>\n  CORE_OPERATIONS.some((operation) => operation === input);\n\n/** Checks a transported configuration code against the authoritative message registry. */\nexport const isCoreConfigurationErrorCode = (\n  input: unknown,\n): input is ICoreConfigurationErrorCode =>\n  typeof input === 'string' && Object.hasOwn(CONFIGURATION_ERROR_MESSAGES, input);\n\n/** Checks a transported operation code against the authoritative message registry. */\nexport const isCoreOperationErrorCode = (input: unknown): input is ICoreOperationErrorCode =>\n  typeof input === 'string' && Object.hasOwn(OPERATION_ERROR_MESSAGES, input);\n\nconst attachCause = (exception: Error, cause: unknown): void => {\n  if (cause === undefined) {\n    return;\n  }\n\n  Object.defineProperty(exception, 'cause', {\n    configurable: true,\n    enumerable: false,\n    value: cause,\n    writable: false,\n  });\n};\n\n/** Represents invalid immutable Core configuration. */\nexport class CoreConfigurationException extends Exception {\n  public override readonly code: ICoreConfigurationErrorCode;\n\n  public readonly operation: ICoreOperation;\n\n  /** Creates a configuration exception with safe operation metadata. */\n  public constructor(options: ICoreConfigurationExceptionOptions) {\n    super(CONFIGURATION_ERROR_MESSAGES[options.code], options.code);\n    this.code = options.code;\n    this.name = 'CoreConfigurationException';\n    this.operation = options.operation;\n    attachCause(this, options.cause);\n  }\n}\n\n/** Represents an operational failure that prevented Core from completing. */\nexport class CoreOperationException extends Exception {\n  public override readonly code: ICoreOperationErrorCode;\n\n  public readonly operation: ICoreOperation;\n\n  public readonly retryable: boolean;\n\n  public readonly agentId: string | null;\n\n  public readonly limit: string | null;\n\n  public readonly limitMaximum: number | null;\n\n  public readonly nextAction: ICoreResourceLimitNextAction | null;\n\n  public readonly observedUsage: number | null;\n\n  /** Creates an operation exception with derived retry and safe scope metadata. */\n  public constructor(options: ICoreOperationExceptionOptions) {\n    super(OPERATION_ERROR_MESSAGES[options.code], options.code);\n    this.code = options.code;\n    this.name = 'CoreOperationException';\n    this.operation = options.operation;\n    this.retryable = OPERATION_ERROR_RETRYABILITY[options.code];\n    this.agentId = options.agentId ?? null;\n    this.limit = options.limit ?? null;\n    this.limitMaximum = options.limitMaximum ?? null;\n    this.nextAction = options.nextAction ?? null;\n    this.observedUsage = options.observedUsage ?? null;\n    attachCause(this, options.cause);\n  }\n}\n"],"mappings":";;AAcA,IAAM,kBAAkB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAqDA,IAAM,+BAA+B,EACnC,wBAAwB,oCAC1B;AAEA,IAAM,2BAA2B;CAC/B,SAAS;CACT,iBAAiB;CACjB,kBAAkB;CAClB,iBAAiB;CACjB,oBAAoB;CACpB,2BAA2B;CAC3B,yBAAyB;AAC3B;AAEA,IAAM,+BAA+B;CACnC,SAAS;CACT,iBAAiB;CACjB,kBAAkB;CAClB,iBAAiB;CACjB,oBAAoB;CACpB,2BAA2B;CAC3B,yBAAyB;AAC3B;;AAGA,IAAa,mBAAmB,UAC9B,gBAAgB,MAAM,cAAc,cAAc,KAAK;;AAGzD,IAAa,gCACX,UAEA,OAAO,UAAU,YAAY,OAAO,OAAO,8BAA8B,KAAK;;AAGhF,IAAa,4BAA4B,UACvC,OAAO,UAAU,YAAY,OAAO,OAAO,0BAA0B,KAAK;AAE5E,IAAM,eAAe,WAAkB,UAAyB;CAC9D,IAAI,UAAU,KAAA,GACZ;CAGF,OAAO,eAAe,WAAW,SAAS;EACxC,cAAc;EACd,YAAY;EACZ,OAAO;EACP,UAAU;CACZ,CAAC;AACH;;AAGA,IAAa,6BAAb,cAAgD,UAAU;CACxD;CAEA;;CAGA,YAAmB,SAA6C;EAC9D,MAAM,6BAA6B,QAAQ,OAAO,QAAQ,IAAI;EAC9D,KAAK,OAAO,QAAQ;EACpB,KAAK,OAAO;EACZ,KAAK,YAAY,QAAQ;EACzB,YAAY,MAAM,QAAQ,KAAK;CACjC;AACF;;AAGA,IAAa,yBAAb,cAA4C,UAAU;CACpD;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;;CAGA,YAAmB,SAAyC;EAC1D,MAAM,yBAAyB,QAAQ,OAAO,QAAQ,IAAI;EAC1D,KAAK,OAAO,QAAQ;EACpB,KAAK,OAAO;EACZ,KAAK,YAAY,QAAQ;EACzB,KAAK,YAAY,6BAA6B,QAAQ;EACtD,KAAK,UAAU,QAAQ,WAAW;EAClC,KAAK,QAAQ,QAAQ,SAAS;EAC9B,KAAK,eAAe,QAAQ,gBAAgB;EAC5C,KAAK,aAAa,QAAQ,cAAc;EACxC,KAAK,gBAAgB,QAAQ,iBAAiB;EAC9C,YAAY,MAAM,QAAQ,KAAK;CACjC;AACF"}