@moldea.ai/core 3.0.1 → 4.0.0

package/README.md

@@ -4,12 +4,12 @@
 
 Source-neutral, deterministic, content-safe interpretation of the `moldea` repository format.
 
-Version 3 accepts caller-supplied text and `@moldea.ai/repository` version 2 readers. It performs no filesystem, Git, or network access independently. Project validation returns content-free summaries, diagnostics, evidence, and metadata. Canonical document bodies are available only through an explicit path-scoped byte-range operation.
+Version 4 accepts caller-supplied text and `@moldea.ai/repository` version 2 readers. It performs no filesystem, Git, or network access independently. Project validation returns content-free summaries, diagnostics, evidence, agent assignments, and metadata. Canonical document bodies are available only through an explicit path-scoped byte-range operation.
 
 ## Install
 
 ```bash
-pnpm add @moldea.ai/core@3 @moldea.ai/repository@2
+pnpm add @moldea.ai/core@4 @moldea.ai/repository@2
 ```
 
 ## Public entry points
@@ -67,7 +67,9 @@ const result = await core.validateProject({ repository });
 
 `validateProject` returns validity, format version, source identity, summary counts and digests, diagnostics, and runtime evidence. It never returns manifest, project, context, decision, runtime-guidance, mirror, description, or instruction bodies.
 
-`inspectProjectPage` provides bounded content-free views named `metadata`, `diagnostics`, `evidence`, and `all`. Each page uses a semantic continuation cursor tied to the validation digest and view. `readCanonicalContentPage` is the only Core project operation that returns a body, and it requires an explicit canonical `/moldea/**` file path, byte offset, and byte bound. Returned chunks end at a complete UTF-8 scalar.
+`createProjectInspection` validates the snapshot once, prepares one immutable content-free record set, and returns synchronous bounded page reads for the `metadata`, `diagnostics`, `evidence`, and `all` views. The `metadata` and `all` views include one independently keyed `agent` record per canonical agent with exactly its `agentId` and manifest-declared `runtimeId`, distinct from asset metadata and adapter evidence. Each page uses a semantic continuation cursor tied to the complete inspection digest and view. Page reads perform no repository access, revalidation, sorting, digesting, or adapter execution.
+
+The prepared inspection retains only its content-free records, summary, source identity, deterministic resource accounting, and page indexes. It does not retain canonical document bodies. `readCanonicalContentPage` is the only Core project operation that returns a body, and it requires an explicit canonical `/moldea/**` file path, byte offset, and byte bound. Returned chunks end at a complete UTF-8 scalar.
 
 ## Per-agent runtime adapters
 
@@ -77,7 +79,9 @@ Adapter evidence and diagnostics are validated, normalized, deduplicated, sorted
 
 ## Resource and trust boundaries
 
-Core uses independent limits for distinct entries, total bytes, file bytes, manifest bytes, diagnostics, and evidence. The adapter-facing repository adds per-page entry and byte limits. Core executes no repository code, follows no symlink, receives no host path or source credential, and returns logical paths only.
+Core uses independent limits for distinct entries, total bytes read, per-file bytes, manifest bytes, logical retained bytes, diagnostics, and evidence. The default logical retained-memory ceiling is 512 MiB. Project inspection accounts for canonical validation state, transient read pages, and prepared content-free records before completing, and reports deterministic logical usage without exposing document bodies. The adapter-facing repository adds per-page entry and byte limits. Core executes no repository code, follows no symlink, receives no host path or source credential, and returns logical paths only.
+
+Every `RESOURCE_LIMIT_EXCEEDED` exception identifies the exceeded limit, its configured maximum, the observed or projected usage, and the stable `reduce-input-or-increase-limit` next action. Core refuses the operation before allocating retained state beyond the applicable ceiling.
 
 The release-5 calibration corpus drives these limits through the real CLI and PR Assurance across ordinary, 1,024-path, broad-relationship, Unicode, binary, diagnostic-heavy, and incomplete-provider cases. Repeated measurements establish ordinary cumulative headroom, while adversarial tests prove explicit bounded failure without treating a page, file, or operation limit as total repository capacity.
 

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

@@ -1 +1 @@
-{"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;AAyBrE,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,GACjC,YAAY,yBAAyB,EACrC,MAAM,eAAe,EACrB,UAAU,2BAA2B,KACpC,OAAO,CAAC,UAAU,CAoEpB,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,CAyDhC,CAAC"}
+{"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;AA8BrE,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,GACjC,YAAY,yBAAyB,EACrC,MAAM,eAAe,EACrB,UAAU,2BAA2B,KACpC,OAAO,CAAC,UAAU,CAwEpB,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-validation/index.d.ts.map

@@ -1 +1 @@
-{"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,EAInB,MAAM,yBAAyB,CAAC;AA8DjC,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;AA6cD;;;;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"}
+{"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,EAInB,MAAM,yBAAyB,CAAC;AA8DjC,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;AAgdD;;;;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,4 +1,4 @@
-import { n as CoreOperationException } from "./chunks/exceptions-DWsZTpqs.js";
+import { n as CoreOperationException } from "./chunks/exceptions-C_KfCIjE.js";
 import { REPOSITORY_ROOT, RepositorySourceException, compareRepositoryPaths, parseRepositoryPath } from "@moldea.ai/repository";
 //#region src/adapter-repository/index.ts
 var invalidSourceData = (operation, path) => {
@@ -9,10 +9,13 @@ var invalidSourceData = (operation, path) => {
 		retryable: false
 	});
 };
-var throwResourceLimitExceeded = (limit) => {
+var throwResourceLimitExceeded = (limit, limitMaximum, observedUsage) => {
 	throw new CoreOperationException({
 		code: "RESOURCE_LIMIT_EXCEEDED",
 		limit,
+		limitMaximum,
+		nextAction: "reduce-input-or-increase-limit",
+		observedUsage,
 		operation: "validate-project"
 	});
 };
@@ -32,7 +35,7 @@ var readRuntimeAdapterFile = async (repository, path, options) => {
 		path: parsedPath,
 		retryable: false
 	});
-	if (entry.byteLength > repository.limits.maxFileBytes) return throwResourceLimitExceeded("maxFileBytes");
+	if (entry.byteLength > repository.limits.maxFileBytes) return throwResourceLimitExceeded("maxFileBytes", repository.limits.maxFileBytes, entry.byteLength);
 	const content = new Uint8Array(entry.byteLength);
 	let offset = 0;
 	let isFirstPage = true;
@@ -74,7 +77,7 @@ var iterateRuntimeAdapterEntries = (repository, options) => {
 			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");
+				if (entryCount > repository.limits.maxEntries) return throwResourceLimitExceeded("maxEntries", repository.limits.maxEntries, entryCount);
 				previousPath = entry.path;
 				yield entry;
 			}

package/dist/adapter.js.map

@@ -1 +1 @@
-{"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 { 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): never => {\n  throw new CoreOperationException({\n    code: 'RESOURCE_LIMIT_EXCEEDED',\n    limit,\n    operation: 'validate-project',\n  });\n};\n\n/** Reads one complete adapter source file through bounded repository pages. */\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('maxFileBytes');\n  }\n\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('maxEntries');\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":";;;AAaA,IAAM,qBACJ,WACA,SACU;CACV,MAAM,IAAI,0BAA0B;EAClC,MAAM;EACN;EACA;EACA,WAAW;CACb,CAAC;AACH;AAEA,IAAM,8BACJ,UACU;CACV,MAAM,IAAI,uBAAuB;EAC/B,MAAM;EACN;EACA,WAAW;CACb,CAAC;AACH;;AAGA,IAAa,yBAAyB,OACpC,YACA,MACA,YACwB;CACxB,MAAM,aAAa,oBAAoB,IAAI;CAC3C,MAAM,QAAQ,MAAM,WAAW,SAAS,YAAY,OAAO;CAE3D,IAAI,UAAU,MACZ,MAAM,IAAI,0BAA0B;EAClC,MAAM;EACN,WAAW;EACX,MAAM;EACN,WAAW;CACb,CAAC;CAGH,IAAI,MAAM,SAAS,UAAU,MAAM,eAAe,MAChD,MAAM,IAAI,0BAA0B;EAClC,MAAM;EACN,WAAW;EACX,MAAM;EACN,WAAW;CACb,CAAC;CAGH,IAAI,MAAM,aAAa,WAAW,OAAO,cACvC,OAAO,2BAA2B,cAAc;CAGlD,MAAM,UAAU,IAAI,WAAW,MAAM,UAAU;CAC/C,IAAI,SAAS;CACb,IAAI,cAAc;CAElB,OAAO,eAAe,SAAS,MAAM,YAAY;EAC/C,cAAc;EACd,SAAS,QAAQ,eAAe;EAChC,MAAM,OAAO,MAAM,WAAW,aAAa,YAAY;GACrD,UAAU,KAAK,IAAI,WAAW,OAAO,cAAc,KAAK,IAAI,GAAG,MAAM,aAAa,MAAM,CAAC;GACzF;GACA,GAAI,SAAS,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO;EACpE,CAAC;EAED,IACE,KAAK,SAAS,OAAO,WAAW,SAAS,MACzC,KAAK,WAAW,UAChB,KAAK,eAAe,MAAM,cAC1B,EAAE,KAAK,iBAAiB,eACxB,KAAK,MAAM,aAAa,WAAW,OAAO,gBAC1C,KAAK,MAAM,aAAa,QAAQ,aAAa,UAC5C,KAAK,MAAM,eAAe,KAAK,CAAC,KAAK,YAEtC,OAAO,kBAAkB,kBAAkB,UAAU;EAGvD,QAAQ,IAAI,KAAK,OAAO,MAAM;EAC9B,UAAU,KAAK,MAAM;EAErB,IAAI,KAAK,YAAY;GACnB,IAAI,KAAK,eAAe,QAAQ,WAAW,QAAQ,YACjD,OAAO,kBAAkB,kBAAkB,UAAU;GAGvD,OAAO;EACT;EAEA,IAAI,KAAK,eAAe,QACtB,OAAO,kBAAkB,kBAAkB,UAAU;CAEzD;CAEA,OAAO,kBAAkB,kBAAkB,UAAU;AACvD;;AAGA,IAAa,gCACX,YACA,YACoC;CACpC,MAAM,SACJ,SAAS,WAAW,KAAA,IAAY,kBAAkB,oBAAoB,QAAQ,MAAM;CAEtF,OAAO,EACL,QAAQ,OAAO,iBAAkD;EAC/D,IAAI;EACJ,IAAI,aAAa;EACjB,IAAI,eAAuC;EAE3C,GAAG;GACD,SAAS,QAAQ,eAAe;GAChC,MAAM,OAAO,MAAM,WAAW,gBAAgB;IAC5C,GAAI,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO;IACzC,YAAY,WAAW,OAAO;IAC9B;IACA,GAAI,SAAS,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO;GACpE,CAAC;GAED,IACE,KAAK,SAAS,OAAO,WAAW,SAAS,MACzC,KAAK,QAAQ,SAAS,WAAW,OAAO,kBACvC,KAAK,QAAQ,WAAW,KAAK,CAAC,KAAK,YAEpC,OAAO,kBAAkB,qBAAqB,MAAM;GAGtD,KAAK,MAAM,SAAS,KAAK,SAAS;IAChC,IAAI,iBAAiB,QAAQ,uBAAuB,cAAc,MAAM,IAAI,KAAK,GAC/E,OAAO,kBAAkB,qBAAqB,MAAM,IAAI;IAG1D,cAAc;IACd,IAAI,aAAa,WAAW,OAAO,YACjC,OAAO,2BAA2B,YAAY;IAGhD,eAAe,MAAM;IACrB,MAAM;GACR;GAEA,IAAI,KAAK,YAAY;IACnB,IAAI,KAAK,eAAe,MACtB,OAAO,kBAAkB,qBAAqB,MAAM;IAGtD;GACF;GAEA,IAAI,KAAK,eAAe,QAAQ,KAAK,eAAe,QAClD,OAAO,kBAAkB,qBAAqB,MAAM;GAGtD,SAAS,KAAK;EAChB,SAAS;CACX,EACF;AACF"}
+{"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 { 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/** Reads one complete adapter source file through bounded repository pages. */\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  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/canonical-content-page/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/canonical-content-page/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAoHhE,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,GACnC,OAAO,0BAA0B,EACjC,SAAS,oBAAoB,KAC5B,OAAO,CAAC,2BAA2B,CAwGrC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/canonical-content-page/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAoHhE,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,GACnC,OAAO,0BAA0B,EACjC,SAAS,oBAAoB,KAC5B,OAAO,CAAC,2BAA2B,CA2GrC,CAAC"}

package/dist/chunks/{exceptions-DWsZTpqs.js → exceptions-C_KfCIjE.js}

@@ -52,6 +52,9 @@ var CoreOperationException = class extends Exception {
 	adapterId;
 	agentId;
 	limit;
+	limitMaximum;
+	nextAction;
+	observedUsage;
 	/** Creates an operation exception with derived retry and safe scope metadata. */
 	constructor(options) {
 		super(OPERATION_ERROR_MESSAGES[options.code], options.code);
@@ -62,10 +65,13 @@ var CoreOperationException = class extends Exception {
 		this.adapterId = options.adapterId ?? null;
 		this.agentId = options.agentId ?? null;
 		this.limit = options.limit ?? null;
+		this.limitMaximum = options.limitMaximum ?? null;
+		this.nextAction = options.nextAction ?? null;
+		this.observedUsage = options.observedUsage ?? null;
 		attachCause(this, options.cause);
 	}
 };
 //#endregion
 export { CoreOperationException as n, CoreConfigurationException as t };
 
-//# sourceMappingURL=exceptions-DWsZTpqs.js.map
+//# sourceMappingURL=exceptions-C_KfCIjE.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions-C_KfCIjE.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 =\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 4\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":";;AAgEA,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"}

package/dist/constants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAGnE,eAAO,MAAM,8BAA8B,4KAYhC,CAAC;AAGZ,eAAO,MAAM,oCAAoC,EAAE,SAAS,wBAAwB,EAChE,CAAC;AAGrB,eAAO,MAAM,4BAA4B,EAAE,mBAOzC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAGnE,eAAO,MAAM,8BAA8B,4KAYhC,CAAC;AAGZ,eAAO,MAAM,oCAAoC,EAAE,SAAS,wBAAwB,EAChE,CAAC;AAGrB,eAAO,MAAM,4BAA4B,EAAE,mBAQzC,CAAC"}

package/dist/contracts/index.d.ts

@@ -8,6 +8,7 @@ export interface ICoreResourceLimits {
     readonly maxTotalBytesRead: number;
     readonly maxFileBytes: number;
     readonly maxManifestBytes: number;
+    readonly maxRetainedBytes: number;
     readonly maxDiagnostics: number;
     readonly maxEvidence: number;
 }
@@ -66,13 +67,21 @@ export interface IProjectMetadataItem {
     readonly path: IRepositoryPath;
     readonly scalarLength: number | null;
 }
+export interface IProjectAgentAssignmentItem {
+    readonly agentId: string;
+    readonly runtimeId: string;
+}
 export type IProjectInspectionView = 'all' | 'diagnostics' | 'evidence' | 'metadata';
-export interface IProjectInspectionPageInput extends IProjectValidationInput {
+export type IProjectInspectionInput = IProjectValidationInput;
+export interface IProjectInspectionPageInput {
     readonly cursor?: string;
     readonly maxItems: number;
     readonly view: IProjectInspectionView;
 }
 export type IProjectInspectionItem = {
+    readonly agent: IProjectAgentAssignmentItem;
+    readonly kind: 'agent';
+} | {
     readonly diagnostic: IDiagnostic;
     readonly kind: 'diagnostic';
 } | {
@@ -120,6 +129,30 @@ export interface IProjectInspectionCounts extends IProjectSummaryCounts {
     readonly evidence: number;
     readonly metadata: number;
 }
+export interface IProjectInspectionResourceUsage {
+    readonly canonicalBytes: number;
+    readonly peakRetainedBytes: number;
+    readonly preparedBytes: number;
+    readonly retainedBytes: number;
+    readonly totalBytesRead: number;
+}
+export interface IProjectInspection {
+    readonly counts: IProjectInspectionCounts;
+    readonly formatVersion: IRepositoryFormatVersion | null;
+    readonly inspectionDigest: string;
+    readonly resourceUsage: IProjectInspectionResourceUsage;
+    readonly source: IRepositorySnapshot;
+    readonly summary: IProjectValidationSummary | null;
+    readonly valid: boolean;
+    /**
+     * Reads one bounded page from the already prepared content-free record set.
+     * @param input The view, page size, and optional cursor.
+     * @returns One immutable page without repository reads or project revalidation.
+     * @throws
+     * - INVALID_ARGUMENT: The Core operation received an invalid argument.
+     */
+    readPage(input: IProjectInspectionPageInput): IProjectInspectionPageResult;
+}
 export interface IProjectInspectionPageResult {
     readonly counts: IProjectInspectionCounts;
     readonly formatVersion: IRepositoryFormatVersion | null;
@@ -252,9 +285,9 @@ export interface ICore {
      */
     parseDecision(input: ITextDocumentInput): Promise<IDecisionParseResult>;
     /**
-     * Returns one bounded content-free view over a validated project snapshot.
-     * @param input The reader, view, page size, optional cursor, and cancellation signal.
-     * @returns A promise resolving to one immutable metadata, diagnostic, or evidence page.
+     * Prepares one bounded content-free inspection over a validated project snapshot.
+     * @param input The reader and optional shared cancellation signal.
+     * @returns A promise resolving to an immutable inspection with synchronous page reads.
      * @throws
      * - INVALID_ARGUMENT: The Core operation received an invalid argument.
      * - INVALID_REPOSITORY_PATH: A repository path is invalid.
@@ -269,7 +302,7 @@ export interface ICore {
      * - ABORTED: Project inspection or a repository operation was aborted.
      * - ADAPTER_EXECUTION_FAILED: A runtime adapter failed or returned an invalid result.
      */
-    inspectProjectPage(input: IProjectInspectionPageInput): Promise<IProjectInspectionPageResult>;
+    createProjectInspection(input: IProjectInspectionInput): Promise<IProjectInspection>;
     /**
      * Reads one explicit canonical file range without materializing the complete file.
      * @param input The reader, canonical path, byte range, and optional cancellation signal.

package/dist/contracts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"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"}

package/dist/diagnostic-utilities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diagnostic-utilities/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA0GrF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACzC,QAAQ,IAAI,SAAS,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAYD,+FAA+F;AAC/F,eAAO,MAAM,iCAAiC,GAC5C,QAAQ,mBAAmB,KAC1B,mBAWF,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,gCAAgC,GAC3C,QAAQ,mBAAmB,EAC3B,QAAQ,MAAM,EACd,WAAW,cAAc,EACzB,sBAAiB,EACjB,YAAY,MAAM,KACjB,MAkBF,CAAC;AAUF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,KAC9E,kBASF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,iBAAiB,GAAG,IAAI,GAAG,SAAS,KAC3C,iBAAiB,GAAG,IAWtB,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,GAAI,SAAS,kBAAkB,KAAG,MAMxE,CAAC;AAgGF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,oBAAoB,KAAG,eAiBlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,SAAS,WAAW,EAAE,KACjC,SAAS,WAAW,EActB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GACxC,QAAQ,mBAAmB,EAC3B,WAAW,cAAc,KACxB,wBA4BF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,KAAG,MAExD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diagnostic-utilities/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA0GrF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACzC,QAAQ,IAAI,SAAS,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAYD,+FAA+F;AAC/F,eAAO,MAAM,iCAAiC,GAC5C,QAAQ,mBAAmB,KAC1B,mBAWF,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,gCAAgC,GAC3C,QAAQ,mBAAmB,EAC3B,QAAQ,MAAM,EACd,WAAW,cAAc,EACzB,sBAAiB,EACjB,YAAY,MAAM,KACjB,MAqBF,CAAC;AAUF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,KAC9E,kBASF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,iBAAiB,GAAG,IAAI,GAAG,SAAS,KAC3C,iBAAiB,GAAG,IAWtB,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,GAAI,SAAS,kBAAkB,KAAG,MAMxE,CAAC;AAgGF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,oBAAoB,KAAG,eAiBlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,SAAS,WAAW,EAAE,KACjC,SAAS,WAAW,EActB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GACxC,QAAQ,mBAAmB,EAC3B,WAAW,cAAc,KACxB,wBA4BF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,KAAG,MAExD,CAAC"}

package/dist/exceptions/index.d.ts

@@ -1,21 +1,33 @@
 import { Exception } from 'error-message-utils';
 export type ICoreConfigurationErrorCode = 'DUPLICATE_ADAPTER_ID' | 'RESERVED_ADAPTER_ID' | 'INVALID_ADAPTER_DEFINITION' | 'INVALID_RESOURCE_LIMIT';
 export type ICoreOperationErrorCode = 'INVALID_ARGUMENT' | 'ABORTED' | 'RESOURCE_LIMIT_EXCEEDED' | 'ADAPTER_EXECUTION_FAILED' | 'CONTENT_INVALID';
-export type ICoreOperation = 'create-core' | 'normalize-text' | 'calculate-content-digest' | 'parse-manifest' | 'match-manifest-scope' | 'parse-decision' | 'inspect-project-page' | 'read-canonical-content-page' | 'validate-project' | 'validate-adapter';
+export type ICoreOperation = 'create-core' | 'normalize-text' | 'calculate-content-digest' | 'parse-manifest' | 'match-manifest-scope' | 'parse-decision' | 'create-project-inspection' | 'read-canonical-content-page' | 'validate-project' | 'validate-adapter';
 export interface ICoreConfigurationExceptionOptions {
     readonly code: ICoreConfigurationErrorCode;
     readonly operation: ICoreOperation;
     readonly adapterId?: string;
     readonly cause?: unknown;
 }
-export interface ICoreOperationExceptionOptions {
-    readonly code: ICoreOperationErrorCode;
+interface ICoreOperationExceptionOptionsBase {
     readonly operation: ICoreOperation;
     readonly adapterId?: string;
     readonly agentId?: string;
-    readonly limit?: string;
     readonly cause?: unknown;
 }
+export type ICoreResourceLimitNextAction = 'reduce-input-or-increase-limit';
+export type ICoreOperationExceptionOptions = ICoreOperationExceptionOptionsBase & ({
+    readonly code: 'RESOURCE_LIMIT_EXCEEDED';
+    readonly limit: string;
+    readonly limitMaximum: number;
+    readonly nextAction: ICoreResourceLimitNextAction;
+    readonly observedUsage: number;
+} | {
+    readonly code: Exclude<ICoreOperationErrorCode, 'RESOURCE_LIMIT_EXCEEDED'>;
+    readonly limit?: never;
+    readonly limitMaximum?: never;
+    readonly nextAction?: never;
+    readonly observedUsage?: never;
+});
 /** Represents invalid immutable Core configuration. */
 export declare class CoreConfigurationException extends Exception {
     readonly code: ICoreConfigurationErrorCode;
@@ -32,7 +44,11 @@ export declare class CoreOperationException extends Exception {
     readonly adapterId: string | null;
     readonly agentId: string | null;
     readonly limit: string | null;
+    readonly limitMaximum: number | null;
+    readonly nextAction: ICoreResourceLimitNextAction | null;
+    readonly observedUsage: number | null;
     /** Creates an operation exception with derived retry and safe scope metadata. */
     constructor(options: ICoreOperationExceptionOptions);
 }
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/exceptions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,MAAM,MAAM,2BAA2B,GACnC,sBAAsB,GACtB,qBAAqB,GACrB,4BAA4B,GAC5B,wBAAwB,CAAC;AAE7B,MAAM,MAAM,uBAAuB,GAC/B,kBAAkB,GAClB,SAAS,GACT,yBAAyB,GACzB,0BAA0B,GAC1B,iBAAiB,CAAC;AAEtB,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,gBAAgB,GAChB,0BAA0B,GAC1B,gBAAgB,GAChB,sBAAsB,GACtB,gBAAgB,GAChB,sBAAsB,GACtB,6BAA6B,GAC7B,kBAAkB,GAClB,kBAAkB,CAAC;AAGvB,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAsCD,uDAAuD;AACvD,qBAAa,0BAA2B,SAAQ,SAAS;IACvD,SAAyB,IAAI,EAAE,2BAA2B,CAAC;IAE3D,SAAgB,SAAS,EAAE,cAAc,CAAC;IAE1C,SAAgB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzC,oEAAoE;gBACjD,OAAO,EAAE,kCAAkC;CAQ/D;AAED,6EAA6E;AAC7E,qBAAa,sBAAuB,SAAQ,SAAS;IACnD,SAAyB,IAAI,EAAE,uBAAuB,CAAC;IAEvD,SAAgB,SAAS,EAAE,cAAc,CAAC;IAE1C,SAAgB,SAAS,EAAE,OAAO,CAAC;IAEnC,SAAgB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzC,SAAgB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC,SAAgB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,iFAAiF;gBAC9D,OAAO,EAAE,8BAA8B;CAW3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,MAAM,MAAM,2BAA2B,GACnC,sBAAsB,GACtB,qBAAqB,GACrB,4BAA4B,GAC5B,wBAAwB,CAAC;AAE7B,MAAM,MAAM,uBAAuB,GAC/B,kBAAkB,GAClB,SAAS,GACT,yBAAyB,GACzB,0BAA0B,GAC1B,iBAAiB,CAAC;AAEtB,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,gBAAgB,GAChB,0BAA0B,GAC1B,gBAAgB,GAChB,sBAAsB,GACtB,gBAAgB,GAChB,2BAA2B,GAC3B,6BAA6B,GAC7B,kBAAkB,GAClB,kBAAkB,CAAC;AAGvB,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAGD,MAAM,MAAM,4BAA4B,GAAG,gCAAgC,CAAC;AAE5E,MAAM,MAAM,8BAA8B,GAAG,kCAAkC,GAC7E,CACI;IACE,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,uBAAuB,EAAE,yBAAyB,CAAC,CAAC;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;CAChC,CACJ,CAAC;AAsCJ,uDAAuD;AACvD,qBAAa,0BAA2B,SAAQ,SAAS;IACvD,SAAyB,IAAI,EAAE,2BAA2B,CAAC;IAE3D,SAAgB,SAAS,EAAE,cAAc,CAAC;IAE1C,SAAgB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzC,oEAAoE;gBACjD,OAAO,EAAE,kCAAkC;CAQ/D;AAED,6EAA6E;AAC7E,qBAAa,sBAAuB,SAAQ,SAAS;IACnD,SAAyB,IAAI,EAAE,uBAAuB,CAAC;IAEvD,SAAgB,SAAS,EAAE,cAAc,CAAC;IAE1C,SAAgB,SAAS,EAAE,OAAO,CAAC;IAEnC,SAAgB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzC,SAAgB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC,SAAgB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,SAAgB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C,SAAgB,UAAU,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAEhE,SAAgB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7C,iFAAiF;gBAC9D,OAAO,EAAE,8BAA8B;CAc3D"}

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 export type { IRuntimeAdapterEvidence, IRuntimeAdapterEvidenceKind } from './adapter/index.js';
 export { DEFAULT_CORE_RESOURCE_LIMITS, SUPPORTED_REPOSITORY_FORMAT_VERSIONS, } from './constants/index.js';
-export type { IContentDigest, IContentDigestResult, ICanonicalContentPageInput, ICanonicalContentPageResult, ICore, ICoreOptions, ICoreResourceLimits, IDecisionParseResult, IManifestParseResult, INormalizedText, IProjectMetadataItem, IProjectMetadataKind, IProjectInspectionItem, IProjectInspectionCounts, IProjectInspectionPage, IProjectInspectionPageInput, IProjectInspectionPageRecord, IProjectInspectionPageResult, IProjectInspectionView, IProjectSummaryCounts, IProjectValidationInput, IProjectValidationResult, IProjectValidationSummary, ITextDocumentContent, ITextDocumentInput, ITextNormalizationResult, } from './contracts/index.js';
+export type { IContentDigest, IContentDigestResult, ICanonicalContentPageInput, ICanonicalContentPageResult, ICore, ICoreOptions, ICoreResourceLimits, IDecisionParseResult, IManifestParseResult, INormalizedText, IProjectMetadataItem, IProjectMetadataKind, IProjectAgentAssignmentItem, IProjectInspection, IProjectInspectionItem, IProjectInspectionCounts, IProjectInspectionInput, IProjectInspectionPage, IProjectInspectionPageInput, IProjectInspectionPageRecord, IProjectInspectionPageResult, IProjectInspectionResourceUsage, IProjectInspectionView, IProjectSummaryCounts, IProjectValidationInput, IProjectValidationResult, IProjectValidationSummary, ITextDocumentContent, ITextDocumentInput, ITextNormalizationResult, } from './contracts/index.js';
 export type { IExactManifestScopeDeclaration, IGlobManifestScopeDeclaration, IManifestScopeCounts, IManifestScopeDeclaration, IManifestScopeInput, IManifestScopeMatch, IManifestScopeOwner, IManifestScopeOwnerKind, IManifestScopeRelationshipField, IManifestScopeResult, } from './scope-matching/index.js';
 export { createCore } from './core/index.js';
 export type { IAdapterDiagnostic, ICoreDiagnostic, ICoreDiagnosticCode, IDiagnostic, IDiagnosticDetails, IDiagnosticEntity, ISourcePosition, ISourceRange, } from './diagnostics/index.js';
-export type { ICoreConfigurationErrorCode, ICoreConfigurationExceptionOptions, ICoreOperation, ICoreOperationErrorCode, ICoreOperationExceptionOptions, } from './exceptions/index.js';
+export type { ICoreConfigurationErrorCode, ICoreConfigurationExceptionOptions, ICoreOperation, ICoreOperationErrorCode, ICoreOperationExceptionOptions, ICoreResourceLimitNextAction, } from './exceptions/index.js';
 export { CoreConfigurationException, CoreOperationException } from './exceptions/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAG/F,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,GACrC,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,YAAY,GACb,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,2BAA2B,EAC3B,kCAAkC,EAClC,cAAc,EACd,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAG/F,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,GACrC,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,YAAY,GACb,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,2BAA2B,EAC3B,kCAAkC,EAClC,cAAc,EACd,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}