@moldea.ai/core 6.0.0 → 7.0.1

package/dist/adapter-repository/index.d.ts

@@ -1,27 +0,0 @@
-import { type IRepositoryEntry, type IRepositoryOperationOptions, type IRepositoryPath } from '@moldea.ai/repository';
-import type { IRuntimeAdapterRepository } from '../adapter/index.js';
-/**
- * Reads one complete adapter source file through bounded repository pages.
- * @param repository The Core-created repository for the current adapter invocation.
- * @param path The exact source file path.
- * @param options Optional cancellation controls.
- * @returns A promise resolving to one detached complete source buffer.
- * @throws
- * - 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.
- * - 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.
- * - 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.
- * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
- */
-export declare const readRuntimeAdapterFile: (repository: IRuntimeAdapterRepository, path: IRepositoryPath, options?: IRepositoryOperationOptions) => Promise<Uint8Array>;
-/** Iterates one adapter-scoped descendant listing through bounded pages. */
-export declare const iterateRuntimeAdapterEntries: (repository: IRuntimeAdapterRepository, options?: IRepositoryOperationOptions & {
-    readonly prefix?: IRepositoryPath;
-}) => AsyncIterable<IRepositoryEntry>;
-//# sourceMappingURL=index.d.ts.map

package/dist/adapter-repository/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter-repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AA+BrE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,yBAAyB,EACrC,MAAM,eAAe,EACrB,UAAU,2BAA2B,KACpC,OAAO,CAAC,UAAU,CAyEpB,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,GACvC,YAAY,yBAAyB,EACrC,UAAU,2BAA2B,GAAG;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAA;CAAE,KAC5E,aAAa,CAAC,gBAAgB,CA6DhC,CAAC"}

package/dist/adapter-result-collection/collection.d.ts

@@ -1,13 +0,0 @@
-import type { IRuntimeAdapterContext } from '../adapter/index.js';
-import type { IRuntimeAdapterOutputCounts } from '../adapter-validation/index.js';
-import type { ICoreResourceLimits } from '../contracts/index.js';
-import type { IRuntimeAdapterOutputBudget, IRuntimeAdapterResultCollector } from './types.js';
-/** Creates the immutable admission view from Core's authoritative raw counters. */
-export declare const createRuntimeAdapterOutputBudget: (counts: IRuntimeAdapterOutputCounts, limits: ICoreResourceLimits) => IRuntimeAdapterOutputBudget;
-/**
- * Collects one adapter result without constructing records beyond its remaining allowance.
- * @param context The trusted invocation agent, raw output budget, and operation signal.
- * @returns Independent collectors and one final immutable adapter result.
- */
-export declare const createRuntimeAdapterResultCollector: (context: Pick<IRuntimeAdapterContext, "agent" | "outputBudget" | "signal">) => IRuntimeAdapterResultCollector;
-//# sourceMappingURL=collection.d.ts.map

package/dist/adapter-result-collection/collection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/adapter-result-collection/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAIjE,OAAO,KAAK,EACV,2BAA2B,EAE3B,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAEpB,mFAAmF;AACnF,eAAO,MAAM,gCAAgC,GAC3C,QAAQ,2BAA2B,EACnC,QAAQ,mBAAmB,KAC1B,2BAUC,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,GAC9C,SAAS,IAAI,CAAC,sBAAsB,EAAE,OAAO,GAAG,cAAc,GAAG,QAAQ,CAAC,KACzE,8BAkDF,CAAC"}

package/dist/adapter-result-collection/index.d.ts

@@ -1,3 +0,0 @@
-export type { IRuntimeAdapterOutputBudget, IRuntimeAdapterRecordCollector, IRuntimeAdapterResultCollector, } from './types.js';
-export { createRuntimeAdapterOutputBudget, createRuntimeAdapterResultCollector, } from './collection.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/adapter-result-collection/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter-result-collection/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gCAAgC,EAChC,mCAAmC,GACpC,MAAM,iBAAiB,CAAC"}

package/dist/adapter-result-collection/types.d.ts

@@ -1,31 +0,0 @@
-import type { IAdapterDiagnostic } from '../diagnostics/index.js';
-import type { IRuntimeAdapterEvidence, IRuntimeAdapterResult } from '../adapter/index.js';
-export interface IRuntimeAdapterOutputBudget {
-    readonly diagnostics: {
-        readonly maximum: number;
-        readonly remaining: number;
-    };
-    readonly evidence: {
-        readonly maximum: number;
-        readonly remaining: number;
-    };
-}
-export interface IRuntimeAdapterRecordCollector<TRecord> {
-    /**
-     * Admits one record before executing its factory.
-     * @param factory Constructs the record only after admission succeeds.
-     * @throws
-     * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
-     * - ABORTED: The Core operation was aborted.
-     */
-    add(factory: () => TRecord): void;
-    /** Checks admitted records without exposing or copying the result collection. */
-    some(predicate: (record: TRecord) => boolean): boolean;
-}
-export interface IRuntimeAdapterResultCollector {
-    readonly diagnostics: IRuntimeAdapterRecordCollector<IAdapterDiagnostic>;
-    readonly evidence: IRuntimeAdapterRecordCollector<IRuntimeAdapterEvidence>;
-    /** Returns the complete immutable result for Core's authoritative validation. */
-    finalize(): IRuntimeAdapterResult;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/adapter-result-collection/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapter-result-collection/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG1F,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAGD,MAAM,WAAW,8BAA8B,CAAC,OAAO;IACrD;;;;;;OAMG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IAClC,iFAAiF;IACjF,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC;CACxD;AAGD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,8BAA8B,CAAC,kBAAkB,CAAC,CAAC;IACzE,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC,uBAAuB,CAAC,CAAC;IAE3E,iFAAiF;IACjF,QAAQ,IAAI,qBAAqB,CAAC;CACnC"}

package/dist/adapter-retained-memory/index.d.ts

@@ -1,8 +0,0 @@
-import type { IRuntimeAdapterRepository } from '../adapter/index.js';
-type IRetainedByteReservation = (byteLength: number) => void;
-/** Registers the retained-memory reservation owned by one inspection session. */
-export declare const registerRuntimeAdapterRetainedByteReservation: (repository: IRuntimeAdapterRepository, reserve: IRetainedByteReservation) => void;
-/** Reserves a complete adapter-owned buffer when Core owns the repository session. */
-export declare const reserveRuntimeAdapterRetainedBytesIfTracked: (repository: IRuntimeAdapterRepository, byteLength: number) => void;
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/adapter-retained-memory/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter-retained-memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,KAAK,wBAAwB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAK7D,iFAAiF;AACjF,eAAO,MAAM,6CAA6C,GACxD,YAAY,yBAAyB,EACrC,SAAS,wBAAwB,KAChC,IAMF,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,2CAA2C,GACtD,YAAY,yBAAyB,EACrC,YAAY,MAAM,KACjB,IAMF,CAAC"}

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

@@ -1,43 +0,0 @@
-import type { IRuntimeAdapterEvidence, IRuntimeAdapterRepository } from '../adapter/index.js';
-import type { ICoreResourceLimits, IIndexedAgent, IMoldeaProjectIndex } from '../contracts/index.js';
-import type { IAdapterDiagnostic } from '../diagnostics/index.js';
-export interface IValidatedRuntimeAdapterResult {
-    readonly evidence: readonly IRuntimeAdapterEvidence[];
-    readonly diagnostics: readonly IAdapterDiagnostic[];
-}
-export interface IRuntimeAdapterOutputCounts {
-    diagnostics: number;
-    evidence: number;
-}
-interface IAdapterValidationContext {
-    readonly adapterId: string;
-    readonly agents: readonly IIndexedAgent[];
-    readonly project: IMoldeaProjectIndex;
-    readonly repository: IRuntimeAdapterRepository;
-    readonly limits: ICoreResourceLimits;
-    readonly signal?: AbortSignal;
-}
-/**
- * Deduplicates and sorts normalized evidence from every completed adapter.
- * @param candidates The normalized evidence items to combine.
- * @returns A frozen deterministic evidence collection.
- */
-export declare const normalizeRuntimeAdapterEvidence: (candidates: readonly IRuntimeAdapterEvidence[]) => readonly IRuntimeAdapterEvidence[];
-/**
- * Validates and normalizes one untrusted runtime adapter result.
- * @param candidate The result returned by the adapter implementation.
- * @param context The invoking adapter scope, project, reader, limits, and signal.
- * @returns A promise resolving to frozen deterministic evidence and diagnostics.
- * @throws
- * - INVALID_REPOSITORY_PATH: An adapter repository reference path 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 validation.
- * - INVALID_SOURCE_DATA: The repository reader returned invalid contract data.
- * - RESOURCE_LIMIT_EXCEEDED: A Core or repository resource limit was exceeded.
- * - ABORTED: Adapter validation or a repository operation was aborted.
- * - ADAPTER_EXECUTION_FAILED: The adapter result violates its public contract.
- */
-export declare const validateRuntimeAdapterResult: (candidate: unknown, context: IAdapterValidationContext, outputCounts: IRuntimeAdapterOutputCounts) => Promise<IValidatedRuntimeAdapterResult>;
-export {};
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter-validation/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,uBAAuB,EAEvB,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,KAAK,EACV,kBAAkB,EAMnB,MAAM,yBAAyB,CAAC;AA4FjC,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACrD;AAGD,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AA8nBD;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,GAC1C,YAAY,SAAS,uBAAuB,EAAE,KAC7C,SAAS,uBAAuB,EAQlC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,4BAA4B,GACvC,WAAW,OAAO,EAClB,SAAS,yBAAyB,EAClC,cAAc,2BAA2B,KACxC,OAAO,CAAC,8BAA8B,CA4DxC,CAAC"}

package/dist/adapter.js

@@ -1,116 +0,0 @@
-import { i as reserveRuntimeAdapterRetainedBytesIfTracked, n as createRuntimeAdapterResultCollector } from "./chunks/collection-CvbjjLf2.js";
-import { n as CoreOperationException } from "./chunks/exceptions-lzD3buFw.js";
-import { REPOSITORY_ROOT, RepositorySourceException, compareRepositoryPaths, parseRepositoryPath } from "@moldea.ai/repository";
-//#region src/adapter-repository/index.ts
-var invalidSourceData = (operation, path) => {
-	throw new RepositorySourceException({
-		code: "INVALID_SOURCE_DATA",
-		operation,
-		path,
-		retryable: false
-	});
-};
-var throwResourceLimitExceeded = (limit, limitMaximum, observedUsage) => {
-	throw new CoreOperationException({
-		code: "RESOURCE_LIMIT_EXCEEDED",
-		limit,
-		limitMaximum,
-		nextAction: "reduce-input-or-increase-limit",
-		observedUsage,
-		operation: "validate-project"
-	});
-};
-/**
-* Reads one complete adapter source file through bounded repository pages.
-* @param repository The Core-created repository for the current adapter invocation.
-* @param path The exact source file path.
-* @param options Optional cancellation controls.
-* @returns A promise resolving to one detached complete source buffer.
-* @throws
-* - 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.
-* - 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.
-* - 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.
-* - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
-*/
-var readRuntimeAdapterFile = async (repository, path, options) => {
-	const parsedPath = parseRepositoryPath(path);
-	const entry = await repository.getEntry(parsedPath, options);
-	if (entry === null) throw new RepositorySourceException({
-		code: "ENTRY_NOT_FOUND",
-		operation: "read-file-page",
-		path: parsedPath,
-		retryable: false
-	});
-	if (entry.type !== "file" || entry.byteLength === null) throw new RepositorySourceException({
-		code: "ENTRY_NOT_FILE",
-		operation: "read-file-page",
-		path: parsedPath,
-		retryable: false
-	});
-	if (entry.byteLength > repository.limits.maxFileBytes) return throwResourceLimitExceeded("maxFileBytes", repository.limits.maxFileBytes, entry.byteLength);
-	reserveRuntimeAdapterRetainedBytesIfTracked(repository, entry.byteLength);
-	const content = new Uint8Array(entry.byteLength);
-	let offset = 0;
-	let isFirstPage = true;
-	while (isFirstPage || offset < entry.byteLength) {
-		isFirstPage = false;
-		options?.signal?.throwIfAborted();
-		const page = await repository.readFilePage(parsedPath, {
-			maxBytes: Math.min(repository.limits.maxPageBytes, Math.max(1, entry.byteLength - offset)),
-			offset,
-			...options?.signal === void 0 ? {} : { signal: options.signal }
-		});
-		if (page.snapshot.id !== repository.snapshot.id || page.offset !== offset || page.totalBytes !== entry.byteLength || !(page.bytes instanceof Uint8Array) || page.bytes.byteLength > repository.limits.maxPageBytes || page.bytes.byteLength > content.byteLength - offset || page.bytes.byteLength === 0 && !page.isComplete) return invalidSourceData("read-file-page", parsedPath);
-		content.set(page.bytes, offset);
-		offset += page.bytes.byteLength;
-		if (page.isComplete) {
-			if (page.nextOffset !== null || offset !== content.byteLength) return invalidSourceData("read-file-page", parsedPath);
-			return content;
-		}
-		if (page.nextOffset !== offset) return invalidSourceData("read-file-page", parsedPath);
-	}
-	return invalidSourceData("read-file-page", parsedPath);
-};
-/** Iterates one adapter-scoped descendant listing through bounded pages. */
-var iterateRuntimeAdapterEntries = (repository, options) => {
-	const prefix = options?.prefix === void 0 ? REPOSITORY_ROOT : parseRepositoryPath(options.prefix);
-	return { async *[Symbol.asyncIterator]() {
-		let cursor;
-		let entryCount = 0;
-		let previousPath = null;
-		do {
-			options?.signal?.throwIfAborted();
-			const page = await repository.listEntriesPage({
-				...cursor === void 0 ? {} : { cursor },
-				maxEntries: repository.limits.maxPageEntries,
-				prefix,
-				...options?.signal === void 0 ? {} : { signal: options.signal }
-			});
-			if (page.snapshot.id !== repository.snapshot.id || page.entries.length > repository.limits.maxPageEntries || page.entries.length === 0 && !page.isComplete) return invalidSourceData("list-entries-page", prefix);
-			for (const entry of page.entries) {
-				if (previousPath !== null && compareRepositoryPaths(previousPath, entry.path) >= 0) return invalidSourceData("list-entries-page", entry.path);
-				entryCount += 1;
-				if (entryCount > repository.limits.maxEntries) return throwResourceLimitExceeded("maxEntries", repository.limits.maxEntries, entryCount);
-				previousPath = entry.path;
-				yield entry;
-			}
-			if (page.isComplete) {
-				if (page.nextCursor !== null) return invalidSourceData("list-entries-page", prefix);
-				return;
-			}
-			if (page.nextCursor === null || page.nextCursor === cursor) return invalidSourceData("list-entries-page", prefix);
-			cursor = page.nextCursor;
-		} while (true);
-	} };
-};
-//#endregion
-export { createRuntimeAdapterResultCollector, iterateRuntimeAdapterEntries, readRuntimeAdapterFile };
-
-//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","names":[],"sources":["../src/adapter-repository/index.ts"],"sourcesContent":["import {\n  REPOSITORY_ROOT,\n  RepositorySourceException,\n  compareRepositoryPaths,\n  parseRepositoryPath,\n  type IRepositoryEntry,\n  type IRepositoryOperationOptions,\n  type IRepositoryPath,\n} from '@moldea.ai/repository';\n\nimport type { IRuntimeAdapterRepository } from '../adapter/index.js';\nimport { reserveRuntimeAdapterRetainedBytesIfTracked } from '../adapter-retained-memory/index.js';\nimport { CoreOperationException } from '../exceptions/index.js';\n\nconst invalidSourceData = (\n  operation: 'list-entries-page' | 'read-file-page',\n  path: IRepositoryPath,\n): never => {\n  throw new RepositorySourceException({\n    code: 'INVALID_SOURCE_DATA',\n    operation,\n    path,\n    retryable: false,\n  });\n};\n\nconst throwResourceLimitExceeded = (\n  limit: 'maxEntries' | 'maxFileBytes' | 'maxTotalBytesRead',\n  limitMaximum: number,\n  observedUsage: number,\n): never => {\n  throw new CoreOperationException({\n    code: 'RESOURCE_LIMIT_EXCEEDED',\n    limit,\n    limitMaximum,\n    nextAction: 'reduce-input-or-increase-limit',\n    observedUsage,\n    operation: 'validate-project',\n  });\n};\n\n/**\n * Reads one complete adapter source file through bounded repository pages.\n * @param repository The Core-created repository for the current adapter invocation.\n * @param path The exact source file path.\n * @param options Optional cancellation controls.\n * @returns A promise resolving to one detached complete source buffer.\n * @throws\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 * - 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 * - 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 * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.\n */\nexport const readRuntimeAdapterFile = async (\n  repository: IRuntimeAdapterRepository,\n  path: IRepositoryPath,\n  options?: IRepositoryOperationOptions,\n): Promise<Uint8Array> => {\n  const parsedPath = parseRepositoryPath(path);\n  const entry = await repository.getEntry(parsedPath, options);\n\n  if (entry === null) {\n    throw new RepositorySourceException({\n      code: 'ENTRY_NOT_FOUND',\n      operation: 'read-file-page',\n      path: parsedPath,\n      retryable: false,\n    });\n  }\n\n  if (entry.type !== 'file' || entry.byteLength === null) {\n    throw new RepositorySourceException({\n      code: 'ENTRY_NOT_FILE',\n      operation: 'read-file-page',\n      path: parsedPath,\n      retryable: false,\n    });\n  }\n\n  if (entry.byteLength > repository.limits.maxFileBytes) {\n    return throwResourceLimitExceeded(\n      'maxFileBytes',\n      repository.limits.maxFileBytes,\n      entry.byteLength,\n    );\n  }\n\n  reserveRuntimeAdapterRetainedBytesIfTracked(repository, entry.byteLength);\n  const content = new Uint8Array(entry.byteLength);\n  let offset = 0;\n  let isFirstPage = true;\n\n  while (isFirstPage || offset < entry.byteLength) {\n    isFirstPage = false;\n    options?.signal?.throwIfAborted();\n    const page = await repository.readFilePage(parsedPath, {\n      maxBytes: Math.min(repository.limits.maxPageBytes, Math.max(1, entry.byteLength - offset)),\n      offset,\n      ...(options?.signal === undefined ? {} : { signal: options.signal }),\n    });\n\n    if (\n      page.snapshot.id !== repository.snapshot.id ||\n      page.offset !== offset ||\n      page.totalBytes !== entry.byteLength ||\n      !(page.bytes instanceof Uint8Array) ||\n      page.bytes.byteLength > repository.limits.maxPageBytes ||\n      page.bytes.byteLength > content.byteLength - offset ||\n      (page.bytes.byteLength === 0 && !page.isComplete)\n    ) {\n      return invalidSourceData('read-file-page', parsedPath);\n    }\n\n    content.set(page.bytes, offset);\n    offset += page.bytes.byteLength;\n\n    if (page.isComplete) {\n      if (page.nextOffset !== null || offset !== content.byteLength) {\n        return invalidSourceData('read-file-page', parsedPath);\n      }\n\n      return content;\n    }\n\n    if (page.nextOffset !== offset) {\n      return invalidSourceData('read-file-page', parsedPath);\n    }\n  }\n\n  return invalidSourceData('read-file-page', parsedPath);\n};\n\n/** Iterates one adapter-scoped descendant listing through bounded pages. */\nexport const iterateRuntimeAdapterEntries = (\n  repository: IRuntimeAdapterRepository,\n  options?: IRepositoryOperationOptions & { readonly prefix?: IRepositoryPath },\n): AsyncIterable<IRepositoryEntry> => {\n  const prefix =\n    options?.prefix === undefined ? REPOSITORY_ROOT : parseRepositoryPath(options.prefix);\n\n  return {\n    async *[Symbol.asyncIterator](): AsyncIterator<IRepositoryEntry> {\n      let cursor: string | undefined;\n      let entryCount = 0;\n      let previousPath: IRepositoryPath | null = null;\n\n      do {\n        options?.signal?.throwIfAborted();\n        const page = await repository.listEntriesPage({\n          ...(cursor === undefined ? {} : { cursor }),\n          maxEntries: repository.limits.maxPageEntries,\n          prefix,\n          ...(options?.signal === undefined ? {} : { signal: options.signal }),\n        });\n\n        if (\n          page.snapshot.id !== repository.snapshot.id ||\n          page.entries.length > repository.limits.maxPageEntries ||\n          (page.entries.length === 0 && !page.isComplete)\n        ) {\n          return invalidSourceData('list-entries-page', prefix);\n        }\n\n        for (const entry of page.entries) {\n          if (previousPath !== null && compareRepositoryPaths(previousPath, entry.path) >= 0) {\n            return invalidSourceData('list-entries-page', entry.path);\n          }\n\n          entryCount += 1;\n          if (entryCount > repository.limits.maxEntries) {\n            return throwResourceLimitExceeded(\n              'maxEntries',\n              repository.limits.maxEntries,\n              entryCount,\n            );\n          }\n\n          previousPath = entry.path;\n          yield entry;\n        }\n\n        if (page.isComplete) {\n          if (page.nextCursor !== null) {\n            return invalidSourceData('list-entries-page', prefix);\n          }\n\n          return;\n        }\n\n        if (page.nextCursor === null || page.nextCursor === cursor) {\n          return invalidSourceData('list-entries-page', prefix);\n        }\n\n        cursor = page.nextCursor;\n      } while (true);\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/chunks/collection-CvbjjLf2.js

@@ -1,73 +0,0 @@
-import { n as CoreOperationException } from "./exceptions-lzD3buFw.js";
-//#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/adapter-result-collection/collection.ts
-/** Creates the immutable admission view from Core's authoritative raw counters. */
-var createRuntimeAdapterOutputBudget = (counts, limits) => Object.freeze({
-	diagnostics: Object.freeze({
-		maximum: limits.maxDiagnostics,
-		remaining: limits.maxDiagnostics - counts.diagnostics
-	}),
-	evidence: Object.freeze({
-		maximum: limits.maxEvidence,
-		remaining: limits.maxEvidence - counts.evidence
-	})
-});
-/**
-* Collects one adapter result without constructing records beyond its remaining allowance.
-* @param context The trusted invocation agent, raw output budget, and operation signal.
-* @returns Independent collectors and one final immutable adapter result.
-*/
-var createRuntimeAdapterResultCollector = (context) => {
-	const diagnostics = [];
-	const evidence = [];
-	const createCollector = (kind, records) => {
-		const { maximum, remaining } = context.outputBudget[kind];
-		let admitted = 0;
-		return Object.freeze({
-			some: (predicate) => records.some(predicate),
-			add: (factory) => {
-				if (context.signal?.aborted) throw new CoreOperationException({
-					adapterId: context.agent.declaration.runtime.id,
-					cause: context.signal.reason,
-					code: "ABORTED",
-					operation: "validate-adapter"
-				});
-				if (admitted >= remaining) throw new CoreOperationException({
-					adapterId: context.agent.declaration.runtime.id,
-					code: "RESOURCE_LIMIT_EXCEEDED",
-					limit: kind === "diagnostics" ? "maxDiagnostics" : "maxEvidence",
-					limitMaximum: maximum,
-					nextAction: "reduce-input-or-increase-limit",
-					observedUsage: maximum - remaining + admitted + 1,
-					operation: "validate-adapter"
-				});
-				admitted += 1;
-				records.push(factory());
-			}
-		});
-	};
-	return Object.freeze({
-		diagnostics: createCollector("diagnostics", diagnostics),
-		evidence: createCollector("evidence", evidence),
-		finalize: () => Object.freeze({
-			diagnostics: Object.freeze(diagnostics),
-			evidence: Object.freeze(evidence)
-		})
-	});
-};
-//#endregion
-export { reserveRuntimeAdapterRetainedBytesIfTracked as i, createRuntimeAdapterResultCollector as n, registerRuntimeAdapterRetainedByteReservation as r, createRuntimeAdapterOutputBudget as t };
-
-//# sourceMappingURL=collection-CvbjjLf2.js.map

package/dist/chunks/collection-CvbjjLf2.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"collection-CvbjjLf2.js","names":[],"sources":["../../src/adapter-retained-memory/index.ts","../../src/adapter-result-collection/collection.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 type {\n  IRuntimeAdapterContext,\n  IRuntimeAdapterEvidence,\n  IRuntimeAdapterResult,\n} from '../adapter/index.js';\nimport type { IRuntimeAdapterOutputCounts } from '../adapter-validation/index.js';\nimport type { ICoreResourceLimits } from '../contracts/index.js';\nimport type { IAdapterDiagnostic } from '../diagnostics/index.js';\nimport { CoreOperationException } from '../exceptions/index.js';\n\nimport type {\n  IRuntimeAdapterOutputBudget,\n  IRuntimeAdapterRecordCollector,\n  IRuntimeAdapterResultCollector,\n} from './types.js';\n\n/** Creates the immutable admission view from Core's authoritative raw counters. */\nexport const createRuntimeAdapterOutputBudget = (\n  counts: IRuntimeAdapterOutputCounts,\n  limits: ICoreResourceLimits,\n): IRuntimeAdapterOutputBudget =>\n  Object.freeze({\n    diagnostics: Object.freeze({\n      maximum: limits.maxDiagnostics,\n      remaining: limits.maxDiagnostics - counts.diagnostics,\n    }),\n    evidence: Object.freeze({\n      maximum: limits.maxEvidence,\n      remaining: limits.maxEvidence - counts.evidence,\n    }),\n  });\n\n/**\n * Collects one adapter result without constructing records beyond its remaining allowance.\n * @param context The trusted invocation agent, raw output budget, and operation signal.\n * @returns Independent collectors and one final immutable adapter result.\n */\nexport const createRuntimeAdapterResultCollector = (\n  context: Pick<IRuntimeAdapterContext, 'agent' | 'outputBudget' | 'signal'>,\n): IRuntimeAdapterResultCollector => {\n  const diagnostics: IAdapterDiagnostic[] = [];\n  const evidence: IRuntimeAdapterEvidence[] = [];\n\n  const createCollector = <TRecord>(\n    kind: keyof IRuntimeAdapterOutputBudget,\n    records: TRecord[],\n  ): IRuntimeAdapterRecordCollector<TRecord> => {\n    const { maximum, remaining } = context.outputBudget[kind];\n    let admitted = 0;\n\n    return Object.freeze({\n      some: (predicate: (record: TRecord) => boolean): boolean => records.some(predicate),\n      add: (factory: () => TRecord): void => {\n        if (context.signal?.aborted) {\n          throw new CoreOperationException({\n            adapterId: context.agent.declaration.runtime.id,\n            cause: context.signal.reason,\n            code: 'ABORTED',\n            operation: 'validate-adapter',\n          });\n        }\n\n        if (admitted >= remaining) {\n          throw new CoreOperationException({\n            adapterId: context.agent.declaration.runtime.id,\n            code: 'RESOURCE_LIMIT_EXCEEDED',\n            limit: kind === 'diagnostics' ? 'maxDiagnostics' : 'maxEvidence',\n            limitMaximum: maximum,\n            nextAction: 'reduce-input-or-increase-limit',\n            observedUsage: maximum - remaining + admitted + 1,\n            operation: 'validate-adapter',\n          });\n        }\n\n        admitted += 1;\n        records.push(factory());\n      },\n    });\n  };\n\n  return Object.freeze({\n    diagnostics: createCollector('diagnostics', diagnostics),\n    evidence: createCollector('evidence', evidence),\n    finalize: (): IRuntimeAdapterResult =>\n      Object.freeze({\n        diagnostics: Object.freeze(diagnostics),\n        evidence: Object.freeze(evidence),\n      }),\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;;;;ACXA,IAAa,oCACX,QACA,WAEA,OAAO,OAAO;CACZ,aAAa,OAAO,OAAO;EACzB,SAAS,OAAO;EAChB,WAAW,OAAO,iBAAiB,OAAO;CAC5C,CAAC;CACD,UAAU,OAAO,OAAO;EACtB,SAAS,OAAO;EAChB,WAAW,OAAO,cAAc,OAAO;CACzC,CAAC;AACH,CAAC;;;;;;AAOH,IAAa,uCACX,YACmC;CACnC,MAAM,cAAoC,CAAC;CAC3C,MAAM,WAAsC,CAAC;CAE7C,MAAM,mBACJ,MACA,YAC4C;EAC5C,MAAM,EAAE,SAAS,cAAc,QAAQ,aAAa;EACpD,IAAI,WAAW;EAEf,OAAO,OAAO,OAAO;GACnB,OAAO,cAAqD,QAAQ,KAAK,SAAS;GAClF,MAAM,YAAiC;IACrC,IAAI,QAAQ,QAAQ,SAClB,MAAM,IAAI,uBAAuB;KAC/B,WAAW,QAAQ,MAAM,YAAY,QAAQ;KAC7C,OAAO,QAAQ,OAAO;KACtB,MAAM;KACN,WAAW;IACb,CAAC;IAGH,IAAI,YAAY,WACd,MAAM,IAAI,uBAAuB;KAC/B,WAAW,QAAQ,MAAM,YAAY,QAAQ;KAC7C,MAAM;KACN,OAAO,SAAS,gBAAgB,mBAAmB;KACnD,cAAc;KACd,YAAY;KACZ,eAAe,UAAU,YAAY,WAAW;KAChD,WAAW;IACb,CAAC;IAGH,YAAY;IACZ,QAAQ,KAAK,QAAQ,CAAC;GACxB;EACF,CAAC;CACH;CAEA,OAAO,OAAO,OAAO;EACnB,aAAa,gBAAgB,eAAe,WAAW;EACvD,UAAU,gBAAgB,YAAY,QAAQ;EAC9C,gBACE,OAAO,OAAO;GACZ,aAAa,OAAO,OAAO,WAAW;GACtC,UAAU,OAAO,OAAO,QAAQ;EAClC,CAAC;CACL,CAAC;AACH"}