@moldea.ai/core 5.0.0 → 6.0.0

package/dist/node.js

@@ -0,0 +1,325 @@
+import { n as CoreOperationException } from "./chunks/exceptions-lzD3buFw.js";
+import { F as freezeRecursively, n as normalizeCoreOptions } from "./chunks/options-CxCT3dZU.js";
+import { c as NODE_INSPECTION_PROFILE, d as NODE_INSPECTION_TRANSPORT_BYTES, i as decodeInspectionMessage, r as createInspectionProcessFailure, s as NODE_INSPECTION_LIFETIME_MS, t as deserializeInspectionFailure } from "./chunks/errors-BQI1DEqf.js";
+import { n as createInspectionSender, r as superviseInspectionChild, t as createInspectionEnvironment } from "./chunks/lifecycle-4EkWgEHm.js";
+import { t as executeRepositoryRpc } from "./chunks/repository-rpc-BWi6X1la.js";
+import { fork } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { fileURLToPath } from "node:url";
+//#region src/node-inspection/client.ts
+var isInspectionActive = false;
+/** Stores one completion without an unhandled rejection before its owner begins awaiting it. */
+var createCompletion = () => {
+	let resolve;
+	let reject;
+	const promise = new Promise((resolveResult, rejectResult) => {
+		resolve = resolveResult;
+		reject = rejectResult;
+	});
+	promise.catch(() => {});
+	return {
+		promise,
+		resolve,
+		reject
+	};
+};
+var aborted = (cause) => new CoreOperationException({
+	code: "ABORTED",
+	operation: "create-project-inspection",
+	...cause === void 0 ? {} : { cause }
+});
+/**
+* Prepares content-free inspection inside one supervised subprocess and one analysis worker.
+* The caller owns actual reader work and must dispose the returned handle before publishing success.
+* @returns An async paging handle after the worker reports its actual heap and prepares inspection.
+* @throws
+* - INVALID_ARGUMENT: The Core operation received an invalid argument.
+* - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.
+* - DUPLICATE_ADAPTER_ID: A runtime adapter ID is registered more than once.
+* - RESERVED_ADAPTER_ID: A reserved runtime adapter ID was supplied.
+* - INVALID_ADAPTER_DEFINITION: A runtime adapter definition is invalid.
+* - ABORTED: The Core operation was aborted.
+* - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+* - ADAPTER_EXECUTION_FAILED: A runtime adapter failed during inspection.
+* - 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.
+* - INVALID_REPOSITORY_PATH: The repository path is invalid.
+* - ENTRY_NOT_FOUND: The requested repository entry was not found.
+* - ENTRY_NOT_FILE: The requested repository entry is not a file.
+* - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.
+* - INVALID_PAGE_REQUEST: The repository page request is invalid.
+* - ACCESS_DENIED: Access to the repository source was denied.
+* - SOURCE_UNAVAILABLE: The repository source is unavailable.
+* - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+* - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
+* - INVALID_SOURCE_DATA: The repository source returned invalid data.
+* - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+* - ABORTED: The repository operation was aborted.
+*/
+var createNodeProjectInspection = async (input) => {
+	if (input === null || typeof input !== "object" || input.repository === null || typeof input.repository !== "object" || typeof input.repository.getEntry !== "function" || typeof input.repository.listEntriesPage !== "function" || typeof input.repository.readFilePage !== "function" || input.repository.snapshot === null || typeof input.repository.snapshot !== "object" || typeof input.repository.snapshot.id !== "string" || input.repository.snapshot.id.length === 0 || typeof input.repository.snapshot.sourceKind !== "string" || input.repository.snapshot.sourceKind.length === 0) throw new CoreOperationException({
+		code: "INVALID_ARGUMENT",
+		operation: "create-project-inspection"
+	});
+	let repository = input.repository;
+	const snapshot = {
+		id: repository.snapshot.id,
+		sourceKind: repository.snapshot.sourceKind
+	};
+	const signal = input.signal;
+	if (signal !== void 0 && (signal === null || typeof signal !== "object" || typeof signal.aborted !== "boolean" || typeof signal.addEventListener !== "function" || typeof signal.removeEventListener !== "function")) throw new CoreOperationException({
+		code: "INVALID_ARGUMENT",
+		operation: "create-project-inspection"
+	});
+	const { limits } = normalizeCoreOptions({ ...input.limits === void 0 ? {} : { limits: input.limits } });
+	if (!(input.adapterRegistryUrl instanceof URL) || input.adapterRegistryUrl.protocol !== "file:" || input.adapterRegistryUrl.search !== "" || input.adapterRegistryUrl.hash !== "" || input.deadline !== void 0 && (!Number.isSafeInteger(input.deadline) || input.deadline < 0)) throw new CoreOperationException({
+		code: "INVALID_ARGUMENT",
+		operation: "create-project-inspection"
+	});
+	if (signal?.aborted === true) throw aborted(signal.reason);
+	if (isInspectionActive) throw new CoreOperationException({
+		code: "INSPECTION_BUSY",
+		operation: "create-project-inspection"
+	});
+	if (limits.maxRetainedBytes <= 50331648) throw new CoreOperationException({
+		code: "RESOURCE_LIMIT_EXCEEDED",
+		operation: "create-project-inspection",
+		limit: "maxRetainedBytes",
+		limitMaximum: limits.maxRetainedBytes,
+		observedUsage: NODE_INSPECTION_TRANSPORT_BYTES,
+		nextAction: "reduce-input-or-increase-limit"
+	});
+	const deadline = Math.min(Date.now() + NODE_INSPECTION_LIFETIME_MS, input.deadline ?? Infinity);
+	if (deadline <= Date.now()) throw new CoreOperationException({
+		code: "INSPECTION_TIMEOUT",
+		operation: "create-project-inspection"
+	});
+	isInspectionActive = true;
+	const controller = new AbortController();
+	const attemptId = randomBytes(16).toString("hex");
+	const prepared = createCompletion();
+	let pendingPage;
+	let pageRequestId = 0;
+	let lastReaderRequestId = -1;
+	let hasAcknowledgedHeap = false;
+	let heapMaximum;
+	let hasPrepared = false;
+	let isClosing = false;
+	let failure;
+	let cleanupPromise;
+	const readerWork = /* @__PURE__ */ new Set();
+	const relayWork = /* @__PURE__ */ new Set();
+	const child = (() => {
+		try {
+			return fork(fileURLToPath(import.meta.resolve("#moldea-core-runner")), [], {
+				execPath: process.execPath,
+				execArgv: [],
+				env: createInspectionEnvironment(),
+				serialization: "advanced",
+				stdio: [
+					"ignore",
+					"ignore",
+					"pipe",
+					"ipc"
+				]
+			});
+		} catch (cause) {
+			isInspectionActive = false;
+			throw createInspectionProcessFailure(cause);
+		}
+	})();
+	const send = createInspectionSender((frame, callback) => {
+		if (!child.connected) throw createInspectionProcessFailure();
+		child.send(frame, callback);
+	});
+	const supervision = superviseInspectionChild(child, () => {
+		send({
+			attemptId,
+			kind: "dispose"
+		}).catch(() => {
+			child.kill("SIGKILL");
+		});
+	});
+	/** Keeps admission until child closure and every real reader promise has settled. */
+	const cleanup = () => {
+		cleanupPromise ??= (async () => {
+			isClosing = true;
+			controller.abort(failure?.cause);
+			supervision.terminate();
+			await supervision.closed;
+			await Promise.allSettled([...readerWork, ...relayWork]);
+			repository = void 0;
+			clearTimeout(timer);
+			if (failure === void 0 && Date.now() >= deadline) fail(new CoreOperationException({
+				code: "INSPECTION_TIMEOUT",
+				operation: "create-project-inspection"
+			}));
+			signal?.removeEventListener("abort", handleAbort);
+			child.removeAllListeners("message");
+			child.removeAllListeners("error");
+			child.stderr?.removeAllListeners("data");
+			isInspectionActive = false;
+		})();
+		return cleanupPromise;
+	};
+	const fail = (cause) => {
+		if (failure === void 0) failure = { cause: cause instanceof Error ? cause : createInspectionProcessFailure(cause) };
+		prepared.reject(failure.cause);
+		pendingPage?.reject(failure.cause);
+		cleanup();
+	};
+	const getFailureCause = () => failure?.cause;
+	const handleAbort = () => {
+		fail(aborted(signal?.reason));
+	};
+	const timer = setTimeout(() => {
+		fail(new CoreOperationException({
+			code: "INSPECTION_TIMEOUT",
+			operation: "create-project-inspection"
+		}));
+	}, Math.max(1, deadline - Date.now()));
+	signal?.addEventListener("abort", handleAbort, { once: true });
+	const isCallerAborted = () => signal?.aborted === true;
+	if (isCallerAborted()) handleAbort();
+	child.once("error", (cause) => {
+		fail(createInspectionProcessFailure(cause));
+	});
+	supervision.closed.then(() => {
+		if (!isClosing) fail(createInspectionProcessFailure());
+	});
+	let stderrBytes = 0;
+	child.stderr?.on("data", (chunk) => {
+		stderrBytes += chunk.byteLength;
+		if (stderrBytes > 32768) fail(createInspectionProcessFailure());
+	});
+	child.on("message", (frame) => {
+		if (isClosing) return;
+		try {
+			const message = decodeInspectionMessage(frame);
+			if (message.attemptId !== attemptId) throw createInspectionProcessFailure();
+			if (message.kind === "ready") {
+				if (hasAcknowledgedHeap) throw createInspectionProcessFailure();
+				heapMaximum = message.maxAnalysisHeapBytes;
+				hasAcknowledgedHeap = true;
+				send({
+					attemptId,
+					kind: "run"
+				}).catch(fail);
+			} else if (message.kind === "prepared") {
+				if (!hasAcknowledgedHeap || hasPrepared || message.inspection.maxAnalysisHeapBytes !== heapMaximum || message.inspection.source.id !== snapshot.id || message.inspection.source.sourceKind !== snapshot.sourceKind) throw createInspectionProcessFailure();
+				hasPrepared = true;
+				prepared.resolve(freezeRecursively(message.inspection));
+			} else if (message.kind === "reader-request") {
+				if (!hasAcknowledgedHeap || hasPrepared || message.requestId !== lastReaderRequestId + 1 || readerWork.size >= 4) throw createInspectionProcessFailure();
+				lastReaderRequestId = message.requestId;
+				if (repository === void 0) throw createInspectionProcessFailure();
+				const work = executeRepositoryRpc(repository, message.request, controller.signal);
+				readerWork.add(work);
+				const relay = (async () => {
+					try {
+						const result = await work;
+						readerWork.delete(work);
+						if (!isClosing) await send({
+							attemptId,
+							kind: "reader-response",
+							requestId: message.requestId,
+							result
+						});
+					} catch (cause) {
+						fail(cause);
+					} finally {
+						readerWork.delete(work);
+					}
+				})();
+				relayWork.add(relay);
+				relay.finally(() => relayWork.delete(relay));
+			} else if (message.kind === "page") {
+				if (!hasPrepared || pendingPage === void 0 || message.requestId !== pageRequestId) throw createInspectionProcessFailure();
+				const completion = pendingPage;
+				pendingPage = void 0;
+				completion.resolve(freezeRecursively(message.result));
+			} else if (message.kind === "failure") {
+				if (message.failure.options["nextAction"] === "review-inspection-capacity" && (heapMaximum === void 0 || message.failure.options["limitMaximum"] !== heapMaximum)) throw createInspectionProcessFailure();
+				fail(deserializeInspectionFailure(message.failure));
+			} else throw createInspectionProcessFailure();
+		} catch (cause) {
+			fail(cause);
+		}
+	});
+	try {
+		await send({
+			attemptId,
+			kind: "start",
+			registryUrl: input.adapterRegistryUrl.href,
+			snapshot,
+			limits,
+			deadline
+		});
+		const metadata = await prepared.promise;
+		if (Date.now() >= deadline) throw new CoreOperationException({
+			code: "INSPECTION_TIMEOUT",
+			operation: "create-project-inspection"
+		});
+		return Object.freeze({
+			...metadata,
+			readPage: async (pageInput) => {
+				if (failure !== void 0 || isClosing) throw failure?.cause ?? aborted();
+				if (pendingPage !== void 0 || pageInput === null || typeof pageInput !== "object" || Reflect.ownKeys(pageInput).some((key) => key !== "cursor" && key !== "maxItems" && key !== "view") || !Number.isSafeInteger(pageInput.maxItems) || pageInput.maxItems < 1 || pageInput.maxItems > limits.maxEntries || ![
+					"all",
+					"diagnostics",
+					"evidence",
+					"metadata"
+				].includes(pageInput.view) || pageInput.cursor !== void 0 && typeof pageInput.cursor !== "string") throw new CoreOperationException({
+					code: "INVALID_ARGUMENT",
+					operation: "create-project-inspection"
+				});
+				const completion = createCompletion();
+				pendingPage = completion;
+				pageRequestId++;
+				try {
+					if (Date.now() >= deadline) throw new CoreOperationException({
+						code: "INSPECTION_TIMEOUT",
+						operation: "create-project-inspection"
+					});
+					await send({
+						attemptId,
+						kind: "read-page",
+						requestId: pageRequestId,
+						input: {
+							maxItems: pageInput.maxItems,
+							view: pageInput.view,
+							...pageInput.cursor === void 0 ? {} : { cursor: pageInput.cursor }
+						}
+					});
+					const result = await completion.promise;
+					if (Date.now() >= deadline) throw new CoreOperationException({
+						code: "INSPECTION_TIMEOUT",
+						operation: "create-project-inspection"
+					});
+					return result;
+				} catch (cause) {
+					fail(cause);
+					await cleanup();
+					throw getFailureCause() ?? createInspectionProcessFailure(cause);
+				} finally {
+					if (pendingPage === completion) pendingPage = void 0;
+				}
+			},
+			dispose: async () => {
+				pendingPage?.reject(failure?.cause ?? aborted());
+				await cleanup();
+				const cause = getFailureCause();
+				if (cause !== void 0) throw cause;
+			}
+		});
+	} catch (cause) {
+		fail(cause);
+		await cleanup();
+		throw getFailureCause() ?? createInspectionProcessFailure(cause);
+	}
+};
+//#endregion
+export { NODE_INSPECTION_PROFILE, createNodeProjectInspection };
+
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","names":[],"sources":["../src/node-inspection/client.ts"],"sourcesContent":["import { fork } from 'node:child_process';\nimport { randomBytes } from 'node:crypto';\nimport { fileURLToPath } from 'node:url';\n\nimport { CoreOperationException } from '../exceptions/index.js';\nimport { freezeRecursively } from '../immutable/index.js';\nimport { normalizeCoreOptions } from '../options/index.js';\n\nimport {\n  NODE_INSPECTION_LIFETIME_MS,\n  NODE_INSPECTION_MAX_REQUESTS,\n  NODE_INSPECTION_STDIO_BYTES,\n  NODE_INSPECTION_TRANSPORT_BYTES,\n} from './constants.js';\nimport { deserializeInspectionFailure } from './errors.js';\nimport {\n  createInspectionEnvironment,\n  createInspectionSender,\n  superviseInspectionChild,\n} from './lifecycle.js';\nimport { createInspectionProcessFailure, decodeInspectionMessage } from './protocol.js';\nimport { executeRepositoryRpc } from './repository-rpc.js';\nimport type {\n  INodeInspectionMetadata,\n  INodeProjectInspection,\n  INodeProjectInspectionInput,\n} from './types.js';\nimport type { IProjectInspectionPageResult } from '../contracts/index.js';\n\nlet isInspectionActive = false;\n\n/** Stores one completion without an unhandled rejection before its owner begins awaiting it. */\nconst createCompletion = <T>(): {\n  promise: Promise<T>;\n  resolve: (result: T) => void;\n  reject: (cause: unknown) => void;\n} => {\n  let resolve!: (result: T) => void;\n  let reject!: (cause: unknown) => void;\n  const promise = new Promise<T>((resolveResult, rejectResult) => {\n    resolve = resolveResult;\n    reject = rejectResult;\n  });\n  void promise.catch(() => {});\n  return { promise, resolve, reject };\n};\n\nconst aborted = (cause?: unknown): CoreOperationException =>\n  new CoreOperationException({\n    code: 'ABORTED',\n    operation: 'create-project-inspection',\n    ...(cause === undefined ? {} : { cause }),\n  });\n\n/**\n * Prepares content-free inspection inside one supervised subprocess and one analysis worker.\n * The caller owns actual reader work and must dispose the returned handle before publishing success.\n * @returns An async paging handle after the worker reports its actual heap and prepares inspection.\n * @throws\n * - INVALID_ARGUMENT: The Core operation received an invalid argument.\n * - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.\n * - DUPLICATE_ADAPTER_ID: A runtime adapter ID is registered more than once.\n * - RESERVED_ADAPTER_ID: A reserved runtime adapter ID was supplied.\n * - INVALID_ADAPTER_DEFINITION: A runtime adapter definition is invalid.\n * - ABORTED: The Core operation was aborted.\n * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.\n * - ADAPTER_EXECUTION_FAILED: A runtime adapter failed during inspection.\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 * - INVALID_REPOSITORY_PATH: The repository path is invalid.\n * - ENTRY_NOT_FOUND: The requested repository entry was not found.\n * - ENTRY_NOT_FILE: The requested repository entry is not a file.\n * - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.\n * - INVALID_PAGE_REQUEST: The repository page request is invalid.\n * - ACCESS_DENIED: Access to the repository source was denied.\n * - SOURCE_UNAVAILABLE: The repository source is unavailable.\n * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.\n * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.\n * - INVALID_SOURCE_DATA: The repository source returned invalid data.\n * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.\n * - ABORTED: The repository operation was aborted.\n */\nexport const createNodeProjectInspection = async (\n  input: INodeProjectInspectionInput,\n): Promise<INodeProjectInspection> => {\n  if (\n    input === null ||\n    typeof input !== 'object' ||\n    input.repository === null ||\n    typeof input.repository !== 'object' ||\n    typeof input.repository.getEntry !== 'function' ||\n    typeof input.repository.listEntriesPage !== 'function' ||\n    typeof input.repository.readFilePage !== 'function' ||\n    input.repository.snapshot === null ||\n    typeof input.repository.snapshot !== 'object' ||\n    typeof input.repository.snapshot.id !== 'string' ||\n    input.repository.snapshot.id.length === 0 ||\n    typeof input.repository.snapshot.sourceKind !== 'string' ||\n    input.repository.snapshot.sourceKind.length === 0\n  ) {\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  }\n  let repository: INodeProjectInspectionInput['repository'] | undefined = input.repository;\n  const snapshot = { id: repository.snapshot.id, sourceKind: repository.snapshot.sourceKind };\n  const signal = input.signal;\n  if (\n    signal !== undefined &&\n    (signal === null ||\n      typeof signal !== 'object' ||\n      typeof signal.aborted !== 'boolean' ||\n      typeof signal.addEventListener !== 'function' ||\n      typeof signal.removeEventListener !== 'function')\n  ) {\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  }\n  const { limits } = normalizeCoreOptions({\n    ...(input.limits === undefined ? {} : { limits: input.limits }),\n  });\n  if (\n    !(input.adapterRegistryUrl instanceof URL) ||\n    input.adapterRegistryUrl.protocol !== 'file:' ||\n    input.adapterRegistryUrl.search !== '' ||\n    input.adapterRegistryUrl.hash !== '' ||\n    (input.deadline !== undefined && (!Number.isSafeInteger(input.deadline) || input.deadline < 0))\n  )\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  if (signal?.aborted === true) throw aborted(signal.reason);\n  if (isInspectionActive)\n    throw new CoreOperationException({\n      code: 'INSPECTION_BUSY',\n      operation: 'create-project-inspection',\n    });\n  if (limits.maxRetainedBytes <= NODE_INSPECTION_TRANSPORT_BYTES)\n    throw new CoreOperationException({\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n      operation: 'create-project-inspection',\n      limit: 'maxRetainedBytes',\n      limitMaximum: limits.maxRetainedBytes,\n      observedUsage: NODE_INSPECTION_TRANSPORT_BYTES,\n      nextAction: 'reduce-input-or-increase-limit',\n    });\n  const deadline = Math.min(Date.now() + NODE_INSPECTION_LIFETIME_MS, input.deadline ?? Infinity);\n  if (deadline <= Date.now())\n    throw new CoreOperationException({\n      code: 'INSPECTION_TIMEOUT',\n      operation: 'create-project-inspection',\n    });\n  isInspectionActive = true;\n  const controller = new AbortController();\n  const attemptId = randomBytes(16).toString('hex');\n  const prepared = createCompletion<INodeInspectionMetadata>();\n  let pendingPage: ReturnType<typeof createCompletion<IProjectInspectionPageResult>> | undefined;\n  let pageRequestId = 0;\n  let lastReaderRequestId = -1;\n  let hasAcknowledgedHeap = false;\n  let heapMaximum: number | undefined;\n  let hasPrepared = false;\n  let isClosing = false;\n  let failure: { cause: Error } | undefined;\n  let cleanupPromise: Promise<void> | undefined;\n  const readerWork = new Set<Promise<unknown>>();\n  const relayWork = new Set<Promise<void>>();\n  const child = (() => {\n    try {\n      return fork(fileURLToPath(import.meta.resolve('#moldea-core-runner')), [], {\n        execPath: process.execPath,\n        execArgv: [],\n        env: createInspectionEnvironment(),\n        serialization: 'advanced',\n        stdio: ['ignore', 'ignore', 'pipe', 'ipc'],\n      });\n    } catch (cause) {\n      isInspectionActive = false;\n      throw createInspectionProcessFailure(cause);\n    }\n  })();\n  const send = createInspectionSender((frame, callback) => {\n    if (!child.connected) throw createInspectionProcessFailure();\n    child.send(frame, callback);\n  });\n  const supervision = superviseInspectionChild(child, () => {\n    void send({ attemptId, kind: 'dispose' }).catch(() => {\n      child.kill('SIGKILL');\n    });\n  });\n\n  /** Keeps admission until child closure and every real reader promise has settled. */\n  const cleanup = (): Promise<void> => {\n    cleanupPromise ??= (async () => {\n      isClosing = true;\n      controller.abort(failure?.cause);\n      supervision.terminate();\n      await supervision.closed;\n      await Promise.allSettled([...readerWork, ...relayWork]);\n      repository = undefined;\n      clearTimeout(timer);\n      if (failure === undefined && Date.now() >= deadline) {\n        fail(\n          new CoreOperationException({\n            code: 'INSPECTION_TIMEOUT',\n            operation: 'create-project-inspection',\n          }),\n        );\n      }\n      signal?.removeEventListener('abort', handleAbort);\n      child.removeAllListeners('message');\n      child.removeAllListeners('error');\n      child.stderr?.removeAllListeners('data');\n      isInspectionActive = false;\n    })();\n    return cleanupPromise;\n  };\n  const fail = (cause: unknown): void => {\n    if (failure === undefined)\n      failure = { cause: cause instanceof Error ? cause : createInspectionProcessFailure(cause) };\n    prepared.reject(failure.cause);\n    pendingPage?.reject(failure.cause);\n    void cleanup();\n  };\n  const getFailureCause = (): Error | undefined => failure?.cause;\n  const handleAbort = (): void => {\n    fail(aborted(signal?.reason));\n  };\n  const timer = setTimeout(\n    () => {\n      fail(\n        new CoreOperationException({\n          code: 'INSPECTION_TIMEOUT',\n          operation: 'create-project-inspection',\n        }),\n      );\n    },\n    Math.max(1, deadline - Date.now()),\n  );\n  signal?.addEventListener('abort', handleAbort, { once: true });\n  // Re-read through a function because cancellation can change during listener registration.\n  const isCallerAborted = (): boolean => signal?.aborted === true;\n  if (isCallerAborted()) handleAbort();\n  child.once('error', (cause: unknown) => {\n    fail(createInspectionProcessFailure(cause));\n  });\n  void supervision.closed.then(() => {\n    if (!isClosing) fail(createInspectionProcessFailure());\n  });\n  let stderrBytes = 0;\n  child.stderr?.on('data', (chunk: Buffer) => {\n    stderrBytes += chunk.byteLength;\n    if (stderrBytes > NODE_INSPECTION_STDIO_BYTES) fail(createInspectionProcessFailure());\n  });\n  child.on('message', (frame: unknown) => {\n    if (isClosing) return;\n    try {\n      const message = decodeInspectionMessage(frame);\n      if (message.attemptId !== attemptId) throw createInspectionProcessFailure();\n      if (message.kind === 'ready') {\n        if (hasAcknowledgedHeap) throw createInspectionProcessFailure();\n        heapMaximum = message.maxAnalysisHeapBytes;\n        hasAcknowledgedHeap = true;\n        void send({ attemptId, kind: 'run' }).catch(fail);\n      } else if (message.kind === 'prepared') {\n        if (\n          !hasAcknowledgedHeap ||\n          hasPrepared ||\n          message.inspection.maxAnalysisHeapBytes !== heapMaximum ||\n          message.inspection.source.id !== snapshot.id ||\n          message.inspection.source.sourceKind !== snapshot.sourceKind\n        )\n          throw createInspectionProcessFailure();\n        hasPrepared = true;\n        prepared.resolve(freezeRecursively(message.inspection));\n      } else if (message.kind === 'reader-request') {\n        if (\n          !hasAcknowledgedHeap ||\n          hasPrepared ||\n          message.requestId !== lastReaderRequestId + 1 ||\n          readerWork.size >= NODE_INSPECTION_MAX_REQUESTS\n        )\n          throw createInspectionProcessFailure();\n        lastReaderRequestId = message.requestId;\n        if (repository === undefined) throw createInspectionProcessFailure();\n        const work = executeRepositoryRpc(repository, message.request, controller.signal);\n        readerWork.add(work);\n        const relay = (async () => {\n          try {\n            const result = await work;\n            readerWork.delete(work);\n            if (!isClosing)\n              await send({\n                attemptId,\n                kind: 'reader-response',\n                requestId: message.requestId,\n                result,\n              });\n          } catch (cause) {\n            fail(cause);\n          } finally {\n            readerWork.delete(work);\n          }\n        })();\n        relayWork.add(relay);\n        void relay.finally(() => relayWork.delete(relay));\n      } else if (message.kind === 'page') {\n        if (!hasPrepared || pendingPage === undefined || message.requestId !== pageRequestId)\n          throw createInspectionProcessFailure();\n        const completion = pendingPage;\n        pendingPage = undefined;\n        completion.resolve(freezeRecursively(message.result));\n      } else if (message.kind === 'failure') {\n        if (\n          message.failure.options['nextAction'] === 'review-inspection-capacity' &&\n          (heapMaximum === undefined || message.failure.options['limitMaximum'] !== heapMaximum)\n        )\n          throw createInspectionProcessFailure();\n        fail(deserializeInspectionFailure(message.failure));\n      } else throw createInspectionProcessFailure();\n    } catch (cause) {\n      fail(cause);\n    }\n  });\n  try {\n    await send({\n      attemptId,\n      kind: 'start',\n      registryUrl: input.adapterRegistryUrl.href,\n      snapshot,\n      limits,\n      deadline,\n    });\n    const metadata = await prepared.promise;\n    if (Date.now() >= deadline)\n      throw new CoreOperationException({\n        code: 'INSPECTION_TIMEOUT',\n        operation: 'create-project-inspection',\n      });\n    return Object.freeze({\n      ...metadata,\n      readPage: async (pageInput): Promise<IProjectInspectionPageResult> => {\n        if (failure !== undefined || isClosing) throw failure?.cause ?? aborted();\n        if (\n          pendingPage !== undefined ||\n          pageInput === null ||\n          typeof pageInput !== 'object' ||\n          Reflect.ownKeys(pageInput).some(\n            (key) => key !== 'cursor' && key !== 'maxItems' && key !== 'view',\n          ) ||\n          !Number.isSafeInteger(pageInput.maxItems) ||\n          pageInput.maxItems < 1 ||\n          pageInput.maxItems > limits.maxEntries ||\n          !['all', 'diagnostics', 'evidence', 'metadata'].includes(pageInput.view) ||\n          (pageInput.cursor !== undefined && typeof pageInput.cursor !== 'string')\n        )\n          throw new CoreOperationException({\n            code: 'INVALID_ARGUMENT',\n            operation: 'create-project-inspection',\n          });\n        const completion = createCompletion<IProjectInspectionPageResult>();\n        pendingPage = completion;\n        pageRequestId++;\n        try {\n          if (Date.now() >= deadline)\n            throw new CoreOperationException({\n              code: 'INSPECTION_TIMEOUT',\n              operation: 'create-project-inspection',\n            });\n          await send({\n            attemptId,\n            kind: 'read-page',\n            requestId: pageRequestId,\n            input: {\n              maxItems: pageInput.maxItems,\n              view: pageInput.view,\n              ...(pageInput.cursor === undefined ? {} : { cursor: pageInput.cursor }),\n            },\n          });\n          const result = await completion.promise;\n          if (Date.now() >= deadline)\n            throw new CoreOperationException({\n              code: 'INSPECTION_TIMEOUT',\n              operation: 'create-project-inspection',\n            });\n          return result;\n        } catch (cause) {\n          fail(cause);\n          await cleanup();\n          throw getFailureCause() ?? createInspectionProcessFailure(cause);\n        } finally {\n          if (pendingPage === completion) pendingPage = undefined;\n        }\n      },\n      dispose: async (): Promise<void> => {\n        pendingPage?.reject(failure?.cause ?? aborted());\n        await cleanup();\n        const cause = getFailureCause();\n        if (cause !== undefined) throw cause;\n      },\n    } satisfies INodeProjectInspection);\n  } catch (cause) {\n    fail(cause);\n    await cleanup();\n    throw getFailureCause() ?? createInspectionProcessFailure(cause);\n  }\n};\n"],"mappings":"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"}

package/dist/project-inspection/index.d.ts

@@ -1,5 +1,26 @@
 import type { IProjectInspection, IProjectInspectionInput } from '../contracts/index.js';
 import type { ICoreOptionsSnapshot } from '../options/index.js';
-/** Prepares one immutable content-free inspection for synchronous bounded page reads. */
+/**
+ * Prepares one immutable content-free inspection for synchronous bounded page reads.
+ * @param input The source-neutral reader and optional cancellation signal.
+ * @param options The immutable adapter registry and operation limits.
+ * @returns A promise resolving to the complete prepared inspection.
+ * @throws
+ * - INVALID_ARGUMENT: The Core operation received an invalid argument.
+ * - INVALID_REPOSITORY_PATH: The repository path is invalid.
+ * - ENTRY_NOT_FOUND: The requested repository entry was not found.
+ * - ENTRY_NOT_FILE: The requested repository entry is not a file.
+ * - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.
+ * - ACCESS_DENIED: Access to the repository source was denied.
+ * - SOURCE_UNAVAILABLE: The repository source is unavailable.
+ * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+ * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
+ * - INVALID_SOURCE_DATA: The repository source returned invalid data.
+ * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+ * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+ * - ABORTED: The repository operation was aborted.
+ * - ABORTED: The Core operation was aborted.
+ * - ADAPTER_EXECUTION_FAILED: A runtime adapter failed during inspection.
+ */
 export declare const createProjectInspection: (input: IProjectInspectionInput, options: ICoreOptionsSnapshot) => Promise<IProjectInspection>;
 //# sourceMappingURL=index.d.ts.map

package/dist/project-inspection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-inspection/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EAOxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAmchE,yFAAyF;AACzF,eAAO,MAAM,uBAAuB,GAClC,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,kBAAkB,CAiC5B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-inspection/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EAOxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAsdhE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,kBAAkB,CAkC5B,CAAC"}

package/dist/project-metadata/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAkB/B,gGAAgG;AAChG,eAAO,MAAM,sBAAsB,GACjC,SAAS,mBAAmB,KAC3B,gBAAgB,CAAC,oBAAoB,CAqCvC,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,GAAI,SAAS,mBAAmB,KAAG,yBAc5B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAkB/B,gGAAgG;AAChG,eAAO,MAAM,sBAAsB,GACjC,SAAS,mBAAmB,KAC3B,gBAAgB,CAAC,oBAAoB,CAqCvC,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,GAAI,SAAS,mBAAmB,KAAG,yBAiB5B,CAAC"}

package/dist/project-validation/index.d.ts

@@ -13,19 +13,43 @@ export interface IProjectValidationState {
  * @returns A promise resolving to the frozen all-or-nothing project inspection result.
  * @throws
  * - INVALID_ARGUMENT: The Core operation received an invalid argument.
- * - INVALID_REPOSITORY_PATH: A repository path is invalid.
- * - ENTRY_NOT_FOUND: A discovered file disappeared from the reader snapshot.
- * - ENTRY_NOT_FILE: A discovered file changed type during inspection.
- * - ENTRY_NOT_DIRECTORY: A discovered directory changed type during inspection.
+ * - INVALID_REPOSITORY_PATH: The repository path is invalid.
+ * - ENTRY_NOT_FOUND: The requested repository entry was not found.
+ * - ENTRY_NOT_FILE: The requested repository entry is not a file.
+ * - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.
  * - ACCESS_DENIED: Access to the repository source was denied.
  * - SOURCE_UNAVAILABLE: The repository source is unavailable.
- * - SNAPSHOT_CHANGED: The repository snapshot changed during inspection.
- * - INVALID_SOURCE_DATA: The repository reader returned invalid contract data.
- * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
- * - ABORTED: Project inspection or a repository operation was aborted.
- * - ADAPTER_EXECUTION_FAILED: A runtime adapter failed or returned an invalid result.
+ * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+ * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
+ * - INVALID_SOURCE_DATA: The repository source returned invalid data.
+ * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+ * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+ * - ABORTED: The repository operation was aborted.
+ * - ABORTED: The Core operation was aborted.
+ * - ADAPTER_EXECUTION_FAILED: A runtime adapter failed during inspection.
  */
 export declare const validateProjectState: (input: IProjectValidationInput, options: ICoreOptionsSnapshot) => Promise<IProjectValidationState>;
-/** Validates one project without returning canonical document bodies. */
+/**
+ * Validates one project without returning canonical document bodies.
+ * @param input The source-neutral reader and optional cancellation signal.
+ * @param options The immutable adapter registry and operation limits.
+ * @returns A promise resolving to the complete validation result.
+ * @throws
+ * - INVALID_ARGUMENT: The Core operation received an invalid argument.
+ * - INVALID_REPOSITORY_PATH: The repository path is invalid.
+ * - ENTRY_NOT_FOUND: The requested repository entry was not found.
+ * - ENTRY_NOT_FILE: The requested repository entry is not a file.
+ * - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.
+ * - ACCESS_DENIED: Access to the repository source was denied.
+ * - SOURCE_UNAVAILABLE: The repository source is unavailable.
+ * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.
+ * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.
+ * - INVALID_SOURCE_DATA: The repository source returned invalid data.
+ * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.
+ * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+ * - ABORTED: The repository operation was aborted.
+ * - ABORTED: The Core operation was aborted.
+ * - ADAPTER_EXECUTION_FAILED: A runtime adapter failed during inspection.
+ */
 export declare const validateProject: (input: IProjectValidationInput, options: ICoreOptionsSnapshot) => Promise<IProjectValidationResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/project-validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-validation/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAwEpG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,kCAAkC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,uBAAuB,CAkFjC,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,eAAe,GAC1B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,wBAAwB,CAAwD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-validation/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAwEpG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,kCAAkC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,uBAAuB,CAqFjC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,wBAAwB,CAAwD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moldea.ai/core",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "Source-neutral, deterministic interpretation and indexing of moldea repositories.",
   "homepage": "https://github.com/moldea-ai/packages/tree/main/projects/core#readme",
   "bugs": {
@@ -30,12 +30,20 @@
       "types": "./dist/format/index.d.ts",
       "import": "./dist/format.js"
     },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node.js"
+    },
     "./adapter": {
       "types": "./dist/adapter/index.d.ts",
       "import": "./dist/adapter.js"
     }
   },
   "main": "./dist/index.js",
+  "imports": {
+    "#moldea-core-runner": "./dist/node-runner.js",
+    "#moldea-core-analysis-worker": "./dist/analysis-worker.js"
+  },
   "types": "./dist/index.d.ts",
   "dependencies": {
     "@moldea.ai/repository": "^2.0.0",

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

@@ -1 +0,0 @@
-{"version":3,"file":"exceptions-HS9ofVy2.js","names":[],"sources":["../../src/adapter-retained-memory/index.ts","../../src/exceptions/index.ts"],"sourcesContent":["import type { IRuntimeAdapterRepository } from '../adapter/index.js';\ntype IRetainedByteReservation = (byteLength: number) => void;\n\n// reservations belong to Core-created adapter repositories and remain private to the session\nconst retainedByteReservations = new WeakMap<IRuntimeAdapterRepository, IRetainedByteReservation>();\n\n/** Registers the retained-memory reservation owned by one inspection session. */\nexport const registerRuntimeAdapterRetainedByteReservation = (\n  repository: IRuntimeAdapterRepository,\n  reserve: IRetainedByteReservation,\n): void => {\n  if (retainedByteReservations.has(repository)) {\n    throw new TypeError('The runtime adapter repository is already registered.');\n  }\n\n  retainedByteReservations.set(repository, reserve);\n};\n\n/** Reserves a complete adapter-owned buffer when Core owns the repository session. */\nexport const reserveRuntimeAdapterRetainedBytesIfTracked = (\n  repository: IRuntimeAdapterRepository,\n  byteLength: number,\n): void => {\n  const reserve = retainedByteReservations.get(repository);\n\n  if (reserve !== undefined) {\n    reserve(byteLength);\n  }\n};\n","import { Exception } from 'error-message-utils';\n\n// stable configuration and operation failure codes\nexport type ICoreConfigurationErrorCode =\n  | 'DUPLICATE_ADAPTER_ID'\n  | 'RESERVED_ADAPTER_ID'\n  | 'INVALID_ADAPTER_DEFINITION'\n  | 'INVALID_RESOURCE_LIMIT';\n\nexport type ICoreOperationErrorCode =\n  | 'INVALID_ARGUMENT'\n  | 'ABORTED'\n  | 'RESOURCE_LIMIT_EXCEEDED'\n  | 'ADAPTER_EXECUTION_FAILED'\n  | 'CONTENT_INVALID';\n\nexport type ICoreOperation =\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  | 'validate-adapter';\n\n// safe construction options for exported Core exceptions\nexport interface ICoreConfigurationExceptionOptions {\n  readonly code: ICoreConfigurationErrorCode;\n  readonly operation: ICoreOperation;\n  readonly adapterId?: string;\n  readonly cause?: unknown;\n}\n\ninterface ICoreOperationExceptionOptionsBase {\n  readonly operation: ICoreOperation;\n  readonly adapterId?: string;\n  readonly agentId?: string;\n  readonly cause?: unknown;\n}\n\n// complete resource-refusal metadata required by Core 5\nexport type ICoreResourceLimitNextAction = 'reduce-input-or-increase-limit';\n\nexport type ICoreOperationExceptionOptions = ICoreOperationExceptionOptionsBase &\n  (\n    | {\n        readonly code: 'RESOURCE_LIMIT_EXCEEDED';\n        readonly limit: string;\n        readonly limitMaximum: number;\n        readonly nextAction: ICoreResourceLimitNextAction;\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  DUPLICATE_ADAPTER_ID: 'A runtime adapter ID is registered more than once.',\n  INVALID_ADAPTER_DEFINITION: 'A runtime adapter definition is invalid.',\n  INVALID_RESOURCE_LIMIT: 'A Core resource limit is invalid.',\n  RESERVED_ADAPTER_ID: 'A reserved runtime adapter ID was supplied.',\n} as const satisfies Readonly<Record<ICoreConfigurationErrorCode, string>>;\n\nconst OPERATION_ERROR_MESSAGES = {\n  ABORTED: 'The Core operation was aborted.',\n  ADAPTER_EXECUTION_FAILED: 'A runtime adapter failed during inspection.',\n  CONTENT_INVALID: 'The canonical content is not valid UTF-8 text.',\n  INVALID_ARGUMENT: 'The Core operation received an invalid argument.',\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  ADAPTER_EXECUTION_FAILED: false,\n  CONTENT_INVALID: false,\n  INVALID_ARGUMENT: false,\n  RESOURCE_LIMIT_EXCEEDED: false,\n} as const satisfies Readonly<Record<ICoreOperationErrorCode, boolean>>;\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  public readonly adapterId: string | null;\n\n  /** Creates a configuration exception with safe adapter 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    this.adapterId = options.adapterId ?? null;\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 adapterId: string | null;\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.adapterId = options.adapterId ?? null;\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":";;AAIA,IAAM,2CAA2B,IAAI,QAA6D;;AAGlG,IAAa,iDACX,YACA,YACS;CACT,IAAI,yBAAyB,IAAI,UAAU,GACzC,MAAM,IAAI,UAAU,uDAAuD;CAG7E,yBAAyB,IAAI,YAAY,OAAO;AAClD;;AAGA,IAAa,+CACX,YACA,eACS;CACT,MAAM,UAAU,yBAAyB,IAAI,UAAU;CAEvD,IAAI,YAAY,KAAA,GACd,QAAQ,UAAU;AAEtB;;;ACoCA,IAAM,+BAA+B;CACnC,sBAAsB;CACtB,4BAA4B;CAC5B,wBAAwB;CACxB,qBAAqB;AACvB;AAEA,IAAM,2BAA2B;CAC/B,SAAS;CACT,0BAA0B;CAC1B,iBAAiB;CACjB,kBAAkB;CAClB,yBAAyB;AAC3B;AAEA,IAAM,+BAA+B;CACnC,SAAS;CACT,0BAA0B;CAC1B,iBAAiB;CACjB,kBAAkB;CAClB,yBAAyB;AAC3B;AAEA,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;CAEA;;CAGA,YAAmB,SAA6C;EAC9D,MAAM,6BAA6B,QAAQ,OAAO,QAAQ,IAAI;EAC9D,KAAK,OAAO,QAAQ;EACpB,KAAK,OAAO;EACZ,KAAK,YAAY,QAAQ;EACzB,KAAK,YAAY,QAAQ,aAAa;EACtC,YAAY,MAAM,QAAQ,KAAK;CACjC;AACF;;AAGA,IAAa,yBAAb,cAA4C,UAAU;CACpD;CAEA;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,YAAY,QAAQ,aAAa;EACtC,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"}