@moldea.ai/core 2.0.2 → 2.1.0

package/dist/index.js

@@ -745,7 +745,7 @@ var invalidAdapter = (adapterId) => {
 		operation: "create-core"
 	});
 };
-var isRecord$3 = (value) => {
+var isRecord$4 = (value) => {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 };
 var isStableId = (value) => {
@@ -760,7 +760,7 @@ var isStableId = (value) => {
 */
 var normalizeLimits = (candidate) => {
 	if (candidate === void 0) return DEFAULT_CORE_RESOURCE_LIMITS;
-	if (!isRecord$3(candidate)) throw new CoreConfigurationException({
+	if (!isRecord$4(candidate)) throw new CoreConfigurationException({
 		code: "INVALID_RESOURCE_LIMIT",
 		operation: "create-core"
 	});
@@ -790,7 +790,7 @@ var normalizeLimits = (candidate) => {
 * - INVALID_ADAPTER_DEFINITION: A runtime adapter definition is invalid.
 */
 var normalizeAdapter = (candidate) => {
-	if (!isRecord$3(candidate)) return invalidAdapter();
+	if (!isRecord$4(candidate)) return invalidAdapter();
 	const id = candidate["id"];
 	if (typeof id !== "string" || !isStableId(id) || WINDOWS_RESERVED_ID_PATTERN.test(id)) return invalidAdapter();
 	if (id === "custom") throw new CoreConfigurationException({
@@ -849,7 +849,7 @@ var normalizeAdapters = (candidate) => {
 * - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.
 */
 var normalizeCoreOptions = (options) => {
-	if (options !== void 0 && !isRecord$3(options)) return invalidAdapter();
+	if (options !== void 0 && !isRecord$4(options)) return invalidAdapter();
 	return freezeRecursively({
 		adapters: normalizeAdapters(options?.["adapters"]),
 		limits: normalizeLimits(options?.["limits"])
@@ -909,7 +909,7 @@ var decoder = new TextDecoder("utf-8", {
 	fatal: true,
 	ignoreBOM: true
 });
-var isRecord$2 = (value) => {
+var isRecord$3 = (value) => {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 };
 /**
@@ -982,7 +982,7 @@ var collectNulDiagnostics = (value, path, diagnostics) => {
 		offset += 1;
 	}
 };
-var invalidArgument$1 = (operation) => {
+var invalidArgument$2 = (operation) => {
 	throw new CoreOperationException({
 		code: "INVALID_ARGUMENT",
 		operation
@@ -1017,10 +1017,10 @@ var invalidResult = (diagnostics) => {
 * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
 */
 var readInput = (input, limits, operation, limit, diagnostics) => {
-	if (!isRecord$2(input)) return invalidArgument$1(operation);
+	if (!isRecord$3(input)) return invalidArgument$2(operation);
 	const pathCandidate = input["path"];
 	const content = input["content"];
-	if (typeof pathCandidate !== "string" || typeof content !== "string" && !(content instanceof Uint8Array)) return invalidArgument$1(operation);
+	if (typeof pathCandidate !== "string" || typeof content !== "string" && !(content instanceof Uint8Array)) return invalidArgument$2(operation);
 	const path = parseRepositoryPath(pathCandidate);
 	if (typeof content === "string") {
 		const byteLength = measureScalarUtf8ByteLength(content, limits[limit]);
@@ -1409,7 +1409,7 @@ var parseDecisionDocument = async (input, options, operation = "parse-decision")
 };
 //#endregion
 //#region src/manifest-validation/index.ts
-var childPointer$1 = (pointer, key) => {
+var childPointer$2 = (pointer, key) => {
 	return `${pointer}/${escapeJsonPointerSegment(key)}`;
 };
 var addInvalidValue = (context, pointer, range, reason, entity = null) => {
@@ -1439,7 +1439,7 @@ var readMapping = (node, pointer, allowedProperties, context, entity = null) =>
 				code: "MOLDEA_MANIFEST_PROPERTY_UNKNOWN",
 				entity,
 				path: context.path,
-				pointer: childPointer$1(pointer, key),
+				pointer: childPointer$2(pointer, key),
 				range: entry.key.range
 			});
 			continue;
@@ -1500,7 +1500,7 @@ var readReference = (node, pointer, context, entity = null) => {
 			details: { reason: pathEntry === void 0 ? "missing" : "type" },
 			entity,
 			path: context.path,
-			pointer: childPointer$1(pointer, "path"),
+			pointer: childPointer$2(pointer, "path"),
 			range: pathEntry?.value.range ?? null
 		});
 		return null;
@@ -1511,7 +1511,7 @@ var readReference = (node, pointer, context, entity = null) => {
 			code: "MOLDEA_PATH_INVALID",
 			entity,
 			path: context.path,
-			pointer: childPointer$1(pointer, "path"),
+			pointer: childPointer$2(pointer, "path"),
 			range: pathEntry.value.range
 		});
 		return null;
@@ -1523,7 +1523,7 @@ var readReference = (node, pointer, context, entity = null) => {
 			code: "MOLDEA_SYMBOL_INVALID",
 			entity,
 			path: context.path,
-			pointer: childPointer$1(pointer, "symbol"),
+			pointer: childPointer$2(pointer, "symbol"),
 			range: symbolEntry.value.range
 		});
 		return null;
@@ -1533,7 +1533,7 @@ var readReference = (node, pointer, context, entity = null) => {
 			code: "MOLDEA_SYMBOL_FORBIDDEN",
 			entity,
 			path: context.path,
-			pointer: childPointer$1(pointer, "symbol"),
+			pointer: childPointer$2(pointer, "symbol"),
 			range: symbolEntry.value.range
 		});
 		return null;
@@ -1551,7 +1551,7 @@ var readReferenceList = (node, pointer, context, entity = null) => {
 	const references = [];
 	const seen = /* @__PURE__ */ new Set();
 	node.items.forEach((item, index) => {
-		const reference = readReference(item, childPointer$1(pointer, String(index)), context, entity);
+		const reference = readReference(item, childPointer$2(pointer, String(index)), context, entity);
 		if (reference === null) return;
 		const key = `${reference.path}\0${reference.symbol ?? ""}`;
 		if (seen.has(key)) {
@@ -1559,7 +1559,7 @@ var readReferenceList = (node, pointer, context, entity = null) => {
 				code: "MOLDEA_PATH_DUPLICATE",
 				entity,
 				path: context.path,
-				pointer: childPointer$1(pointer, String(index)),
+				pointer: childPointer$2(pointer, String(index)),
 				range: item.range
 			});
 			return;
@@ -1577,7 +1577,7 @@ var readAffectedBy = (node, pointer, context, entity = null) => {
 	const values = [];
 	const seen = /* @__PURE__ */ new Set();
 	node.items.forEach((item, index) => {
-		const itemPointer = childPointer$1(pointer, String(index));
+		const itemPointer = childPointer$2(pointer, String(index));
 		if (item.kind !== "scalar" || typeof item.value !== "string") {
 			addInvalidValue(context, itemPointer, item.range, "string-required", entity);
 			return;
@@ -1620,8 +1620,8 @@ var readRelationship = (node, pointer, context) => {
 		range: node.range
 	});
 	return {
-		...bindingsEntry === void 0 ? {} : { bindings: readReferenceList(bindingsEntry.value, childPointer$1(pointer, "bindings"), context) },
-		...affectedByEntry === void 0 ? {} : { affectedBy: readAffectedBy(affectedByEntry.value, childPointer$1(pointer, "affectedBy"), context) }
+		...bindingsEntry === void 0 ? {} : { bindings: readReferenceList(bindingsEntry.value, childPointer$2(pointer, "bindings"), context) },
+		...affectedByEntry === void 0 ? {} : { affectedBy: readAffectedBy(affectedByEntry.value, childPointer$2(pointer, "affectedBy"), context) }
 	};
 };
 var readRelationshipRecord = (node, pointer, kind, context) => {
@@ -1634,12 +1634,12 @@ var readRelationshipRecord = (node, pointer, kind, context) => {
 			context.diagnostics.add({
 				code: kind === "context" ? "MOLDEA_CONTEXT_PATH_INVALID" : "MOLDEA_DECISION_FILENAME_INVALID",
 				path: context.path,
-				pointer: childPointer$1(pointer, key),
+				pointer: childPointer$2(pointer, key),
 				range: entry.key.range
 			});
 			continue;
 		}
-		const relationship = readRelationship(entry.value, childPointer$1(pointer, key), context);
+		const relationship = readRelationship(entry.value, childPointer$2(pointer, key), context);
 		if (relationship !== null) normalized.push([key, relationship]);
 	}
 	return createNullPrototypeRecord(normalized);
@@ -1652,7 +1652,7 @@ var readPathList = (node, pointer, kind, context, entity) => {
 	const paths = [];
 	const seen = /* @__PURE__ */ new Set();
 	node.items.forEach((item, index) => {
-		const itemPointer = childPointer$1(pointer, String(index));
+		const itemPointer = childPointer$2(pointer, String(index));
 		if (item.kind !== "scalar" || typeof item.value !== "string") {
 			addInvalidValue(context, itemPointer, item.range, "string-required", entity);
 			return;
@@ -1705,7 +1705,7 @@ var readRuntime = (node, pointer, context, agentId) => {
 			code: "MOLDEA_RUNTIME_ID_INVALID",
 			entity,
 			path: context.path,
-			pointer: childPointer$1(pointer, "id"),
+			pointer: childPointer$2(pointer, "id"),
 			range: idEntry?.value.range ?? null
 		});
 		return null;
@@ -1715,14 +1715,14 @@ var readRuntime = (node, pointer, context, agentId) => {
 		code: "MOLDEA_RUNTIME_ID_INVALID",
 		entity,
 		path: context.path,
-		pointer: childPointer$1(pointer, "id"),
+		pointer: childPointer$2(pointer, "id"),
 		range: idEntry.value.range
 	});
 	else context.runtimeLocations.push({
 		adapterId: id,
 		agentId,
 		path: context.path,
-		pointer: childPointer$1(pointer, "id"),
+		pointer: childPointer$2(pointer, "id"),
 		range: idEntry.value.range
 	});
 	const guidanceEntry = entries.get("guidance");
@@ -1736,7 +1736,7 @@ var readRuntime = (node, pointer, context, agentId) => {
 				details: { reason: "runtime-guidance" },
 				entity,
 				path: context.path,
-				pointer: childPointer$1(pointer, "guidance"),
+				pointer: childPointer$2(pointer, "guidance"),
 				range: guidanceEntry.value.range
 			});
 		} else context.diagnostics.add({
@@ -1744,7 +1744,7 @@ var readRuntime = (node, pointer, context, agentId) => {
 			details: { reason: "runtime-guidance" },
 			entity,
 			path: context.path,
-			pointer: childPointer$1(pointer, "guidance"),
+			pointer: childPointer$2(pointer, "guidance"),
 			range: guidanceEntry.value.range
 		});
 	}
@@ -1766,13 +1766,13 @@ var readVariables = (node, pointer, context, agentId) => {
 			code: "MOLDEA_VARIABLE_ID_INVALID",
 			entity,
 			path: context.path,
-			pointer: childPointer$1(pointer, variableId),
+			pointer: childPointer$2(pointer, variableId),
 			range: entry.key.range
 		});
-		const variablePointer = childPointer$1(pointer, variableId);
+		const variablePointer = childPointer$2(pointer, variableId);
 		const variableEntries = readMapping(entry.value, variablePointer, /* @__PURE__ */ new Set(["description"]), context, entity);
 		if (variableEntries === null) continue;
-		const description = readString(variableEntries.get("description"), childPointer$1(variablePointer, "description"), context, {
+		const description = readString(variableEntries.get("description"), childPointer$2(variablePointer, "description"), context, {
 			entity,
 			required: true
 		});
@@ -1792,7 +1792,7 @@ var readBindings = (node, pointer, context, agentId, declaredVariables) => {
 	if (entries === null) return null;
 	const referenceProperty = (key) => {
 		const entry = entries.get(key);
-		return entry === void 0 ? null : readReference(entry.value, childPointer$1(pointer, key), context, entity);
+		return entry === void 0 ? null : readReference(entry.value, childPointer$2(pointer, key), context, entity);
 	};
 	const inputSchema = referenceProperty("inputSchema");
 	const instructionLoader = referenceProperty("instructionLoader");
@@ -1801,7 +1801,7 @@ var readBindings = (node, pointer, context, agentId, declaredVariables) => {
 	const providersEntry = entries.get("variableProviders");
 	let variableProviders = null;
 	if (providersEntry !== void 0) {
-		const providers = readMapping(providersEntry.value, childPointer$1(pointer, "variableProviders"), null, context, entity);
+		const providers = readMapping(providersEntry.value, childPointer$2(pointer, "variableProviders"), null, context, entity);
 		if (providers !== null) {
 			const normalized = [];
 			for (const [variableId, providerEntry] of [...providers].sort(([left], [right]) => compareExactStrings(left, right))) {
@@ -1809,7 +1809,7 @@ var readBindings = (node, pointer, context, agentId, declaredVariables) => {
 					agentId,
 					variableId
 				};
-				const providerPointer = childPointer$1(childPointer$1(pointer, "variableProviders"), variableId);
+				const providerPointer = childPointer$2(childPointer$2(pointer, "variableProviders"), variableId);
 				if (!isVariableId(variableId)) context.diagnostics.add({
 					code: "MOLDEA_VARIABLE_ID_INVALID",
 					entity: variableEntity,
@@ -1860,7 +1860,7 @@ var readCapability$1 = (node, pointer, context, agentId, capabilityId, kind) =>
 		"registration"
 	]), context, entity);
 	if (entries === null) return null;
-	const name = readString(entries.get("name"), childPointer$1(pointer, "name"), context, {
+	const name = readString(entries.get("name"), childPointer$2(pointer, "name"), context, {
 		entity,
 		required: true,
 		singleLine: true
@@ -1871,13 +1871,13 @@ var readCapability$1 = (node, pointer, context, agentId, capabilityId, kind) =>
 		code: "MOLDEA_CAPABILITY_DESCRIPTION_MISSING",
 		entity,
 		path: context.path,
-		pointer: childPointer$1(pointer, "description")
+		pointer: childPointer$2(pointer, "description")
 	});
 	else if (descriptionEntry.value.kind !== "scalar" || typeof descriptionEntry.value.value !== "string" || !isCapabilityDescription(descriptionEntry.value.value)) context.diagnostics.add({
 		code: "MOLDEA_CAPABILITY_DESCRIPTION_INVALID",
 		entity,
 		path: context.path,
-		pointer: childPointer$1(pointer, "description"),
+		pointer: childPointer$2(pointer, "description"),
 		range: descriptionEntry.value.range
 	});
 	else description = descriptionEntry.value.value;
@@ -1887,18 +1887,18 @@ var readCapability$1 = (node, pointer, context, agentId, capabilityId, kind) =>
 		code: kind === "tool" ? "MOLDEA_TOOL_IMPLEMENTATION_MISSING" : "MOLDEA_SKILL_IMPLEMENTATION_MISSING",
 		entity,
 		path: context.path,
-		pointer: childPointer$1(pointer, "implementation")
+		pointer: childPointer$2(pointer, "implementation")
 	});
-	else implementation = readReference(implementationEntry.value, childPointer$1(pointer, "implementation"), context, entity);
+	else implementation = readReference(implementationEntry.value, childPointer$2(pointer, "implementation"), context, entity);
 	const optionalReference = (key) => {
 		const entry = entries.get(key);
-		return entry === void 0 ? null : readReference(entry.value, childPointer$1(pointer, key), context, entity);
+		return entry === void 0 ? null : readReference(entry.value, childPointer$2(pointer, key), context, entity);
 	};
 	const registration = optionalReference("registration");
 	const inputSchema = kind === "tool" ? optionalReference("inputSchema") : null;
 	const outputSchema = kind === "tool" ? optionalReference("outputSchema") : null;
 	const affectedByEntry = entries.get("affectedBy");
-	const affectedBy = affectedByEntry === void 0 ? null : readAffectedBy(affectedByEntry.value, childPointer$1(pointer, "affectedBy"), context, entity);
+	const affectedBy = affectedByEntry === void 0 ? null : readAffectedBy(affectedByEntry.value, childPointer$2(pointer, "affectedBy"), context, entity);
 	if (name === null || description === null || implementation === null) return null;
 	return {
 		name,
@@ -1920,7 +1920,7 @@ var readCapabilities = (node, pointer, context, agentId, kind) => {
 			capabilityId,
 			capabilityKind: kind
 		};
-		const capabilityPointer = childPointer$1(pointer, capabilityId);
+		const capabilityPointer = childPointer$2(pointer, capabilityId);
 		validateStableId(capabilityId, entry.key.range, capabilityPointer, context, entity);
 		const capability = readCapability$1(entry.value, capabilityPointer, context, agentId, capabilityId, kind);
 		if (capability !== null) normalized.push([capabilityId, capability]);
@@ -1933,7 +1933,7 @@ var readUnresolved = (node, pointer, context, agentId) => {
 	const normalized = [];
 	for (const [requirementId, entry] of [...entries].sort(([left], [right]) => compareExactStrings(left, right))) {
 		const entity = agentId === void 0 ? null : { agentId };
-		const requirementPointer = childPointer$1(pointer, requirementId);
+		const requirementPointer = childPointer$2(pointer, requirementId);
 		validateStableId(requirementId, entry.key.range, requirementPointer, context, entity);
 		const requirementEntries = readMapping(entry.value, requirementPointer, /* @__PURE__ */ new Set([
 			"category",
@@ -1944,7 +1944,7 @@ var readUnresolved = (node, pointer, context, agentId) => {
 			"resolution"
 		]), context, entity);
 		if (requirementEntries === null) continue;
-		const category = readString(requirementEntries.get("category"), childPointer$1(requirementPointer, "category"), context, {
+		const category = readString(requirementEntries.get("category"), childPointer$2(requirementPointer, "category"), context, {
 			...entity === null ? {} : { entity },
 			required: true
 		});
@@ -1952,24 +1952,24 @@ var readUnresolved = (node, pointer, context, agentId) => {
 			code: "MOLDEA_ID_INVALID",
 			entity,
 			path: context.path,
-			pointer: childPointer$1(requirementPointer, "category"),
+			pointer: childPointer$2(requirementPointer, "category"),
 			range: requirementEntries.get("category")?.value.range ?? null
 		});
 		const effectEntry = requirementEntries.get("effect");
 		let effect = null;
 		if (effectEntry?.value.kind === "scalar" && (effectEntry.value.value === "blocking" || effectEntry.value.value === "warning" || effectEntry.value.value === "informational")) effect = effectEntry.value.value;
-		else addInvalidValue(context, childPointer$1(requirementPointer, "effect"), effectEntry?.value.range ?? null, effectEntry === void 0 ? "required" : "enum", entity);
-		const description = readString(requirementEntries.get("description"), childPointer$1(requirementPointer, "description"), context, {
+		else addInvalidValue(context, childPointer$2(requirementPointer, "effect"), effectEntry?.value.range ?? null, effectEntry === void 0 ? "required" : "enum", entity);
+		const description = readString(requirementEntries.get("description"), childPointer$2(requirementPointer, "description"), context, {
 			...entity === null ? {} : { entity },
 			required: true
 		});
-		const resolution = readString(requirementEntries.get("resolution"), childPointer$1(requirementPointer, "resolution"), context, {
+		const resolution = readString(requirementEntries.get("resolution"), childPointer$2(requirementPointer, "resolution"), context, {
 			...entity === null ? {} : { entity },
 			required: true
 		});
 		const relatedEntry = requirementEntries.get("related");
-		const related = relatedEntry === void 0 ? null : readReferenceList(relatedEntry.value, childPointer$1(requirementPointer, "related"), context, entity);
-		const reference = readString(requirementEntries.get("reference"), childPointer$1(requirementPointer, "reference"), context, {
+		const related = relatedEntry === void 0 ? null : readReferenceList(relatedEntry.value, childPointer$2(requirementPointer, "related"), context, entity);
+		const reference = readString(requirementEntries.get("reference"), childPointer$2(requirementPointer, "reference"), context, {
 			...entity === null ? {} : { entity },
 			singleLine: true
 		});
@@ -2014,7 +2014,7 @@ var validateAgentOwnedIdUniqueness = (node, pointer, context, agentId) => {
 				code: "MOLDEA_ID_DUPLICATE",
 				entity: { agentId },
 				path: context.path,
-				pointer: childPointer$1(childPointer$1(pointer, property), entry.key.value),
+				pointer: childPointer$2(childPointer$2(pointer, property), entry.key.value),
 				range: entry.key.range
 			});
 			seen.add(entry.key.value);
@@ -2039,27 +2039,27 @@ var readAgent = (node, pointer, context, agentId) => {
 	validateAgentOwnedIdUniqueness(node, pointer, context, agentId);
 	const runtimeEntry = entries.get("runtime");
 	let runtime = null;
-	if (runtimeEntry === void 0) addInvalidValue(context, childPointer$1(pointer, "runtime"), null, "required", entity);
-	else runtime = readRuntime(runtimeEntry.value, childPointer$1(pointer, "runtime"), context, agentId);
+	if (runtimeEntry === void 0) addInvalidValue(context, childPointer$2(pointer, "runtime"), null, "required", entity);
+	else runtime = readRuntime(runtimeEntry.value, childPointer$2(pointer, "runtime"), context, agentId);
 	const variablesEntry = entries.get("variables");
-	const variables = variablesEntry === void 0 ? null : readVariables(variablesEntry.value, childPointer$1(pointer, "variables"), context, agentId);
+	const variables = variablesEntry === void 0 ? null : readVariables(variablesEntry.value, childPointer$2(pointer, "variables"), context, agentId);
 	const declaredVariables = new Set(Object.keys(variables ?? {}));
 	const bindingsEntry = entries.get("bindings");
-	const bindings = bindingsEntry === void 0 ? null : readBindings(bindingsEntry.value, childPointer$1(pointer, "bindings"), context, agentId, declaredVariables);
+	const bindings = bindingsEntry === void 0 ? null : readBindings(bindingsEntry.value, childPointer$2(pointer, "bindings"), context, agentId, declaredVariables);
 	const contextEntry = entries.get("context");
-	const contextPaths = contextEntry === void 0 ? null : readPathList(contextEntry.value, childPointer$1(pointer, "context"), "context", context, entity);
+	const contextPaths = contextEntry === void 0 ? null : readPathList(contextEntry.value, childPointer$2(pointer, "context"), "context", context, entity);
 	const decisionsEntry = entries.get("decisions");
-	const decisions = decisionsEntry === void 0 ? null : readPathList(decisionsEntry.value, childPointer$1(pointer, "decisions"), "decision", context, entity);
+	const decisions = decisionsEntry === void 0 ? null : readPathList(decisionsEntry.value, childPointer$2(pointer, "decisions"), "decision", context, entity);
 	const toolsEntry = entries.get("tools");
-	const tools = toolsEntry === void 0 ? null : readCapabilities(toolsEntry.value, childPointer$1(pointer, "tools"), context, agentId, "tool");
+	const tools = toolsEntry === void 0 ? null : readCapabilities(toolsEntry.value, childPointer$2(pointer, "tools"), context, agentId, "tool");
 	const skillsEntry = entries.get("skills");
-	const skills = skillsEntry === void 0 ? null : readCapabilities(skillsEntry.value, childPointer$1(pointer, "skills"), context, agentId, "skill");
+	const skills = skillsEntry === void 0 ? null : readCapabilities(skillsEntry.value, childPointer$2(pointer, "skills"), context, agentId, "skill");
 	const affectedByEntry = entries.get("affectedBy");
-	const affectedBy = affectedByEntry === void 0 ? null : readAffectedBy(affectedByEntry.value, childPointer$1(pointer, "affectedBy"), context, entity);
+	const affectedBy = affectedByEntry === void 0 ? null : readAffectedBy(affectedByEntry.value, childPointer$2(pointer, "affectedBy"), context, entity);
 	const mirrorsEntry = entries.get("mirrors");
-	const mirrors = mirrorsEntry === void 0 ? null : readPathList(mirrorsEntry.value, childPointer$1(pointer, "mirrors"), "mirror", context, entity);
+	const mirrors = mirrorsEntry === void 0 ? null : readPathList(mirrorsEntry.value, childPointer$2(pointer, "mirrors"), "mirror", context, entity);
 	const unresolvedEntry = entries.get("unresolved");
-	const unresolved = unresolvedEntry === void 0 ? null : readUnresolved(unresolvedEntry.value, childPointer$1(pointer, "unresolved"), context, agentId);
+	const unresolved = unresolvedEntry === void 0 ? null : readUnresolved(unresolvedEntry.value, childPointer$2(pointer, "unresolved"), context, agentId);
 	if (runtime === null) return null;
 	return {
 		runtime,
@@ -2079,7 +2079,7 @@ var readAgents = (node, pointer, context) => {
 	if (entries === null) return null;
 	const normalized = [];
 	for (const [agentId, entry] of [...entries].sort(([left], [right]) => compareExactStrings(left, right))) {
-		const agentPointer = childPointer$1(pointer, agentId);
+		const agentPointer = childPointer$2(pointer, agentId);
 		validateStableId(agentId, entry.key.range, agentPointer, context, { agentId });
 		const agent = readAgent(entry.value, agentPointer, context, agentId);
 		if (agent !== null) normalized.push([agentId, agent]);
@@ -2230,8 +2230,8 @@ var inspectManifestDocument = async (input, options, operation = "parse-manifest
 * - INVALID_ARGUMENT: The Core operation received an invalid argument.
 * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
 */
-var parseManifestDocument = async (input, options) => {
-	const inspection = await inspectManifestDocument(input, options);
+var parseManifestDocument = async (input, options, operation = "parse-manifest") => {
+	const inspection = await inspectManifestDocument(input, options, operation);
 	return freezeRecursively({
 		asset: inspection.asset,
 		diagnostics: inspection.diagnostics,
@@ -2333,7 +2333,7 @@ var DIAGNOSTIC_KEYS = /* @__PURE__ */ new Set([
 ]);
 var ADAPTER_RESULT_KEYS = /* @__PURE__ */ new Set(["evidence", "diagnostics"]);
 var ADAPTER_CODE_PATTERN = /^[A-Z][A-Z0-9_]*$/u;
-var isRecord$1 = (candidate) => {
+var isRecord$2 = (candidate) => {
 	return typeof candidate === "object" && candidate !== null && !Array.isArray(candidate);
 };
 var invalidAdapterResult = (adapterId) => {
@@ -2365,7 +2365,7 @@ var isSafeString = (candidate) => {
 	return typeof candidate === "string" && isUnicodeScalarText(candidate) && !candidate.includes("\0");
 };
 var normalizeDetails = (candidate, adapterId) => {
-	if (!isRecord$1(candidate)) return invalidAdapterResult(adapterId);
+	if (!isRecord$2(candidate)) return invalidAdapterResult(adapterId);
 	const entries = [];
 	for (const key of Reflect.ownKeys(candidate)) {
 		if (typeof key !== "string" || !isUnicodeScalarText(key) || key.includes("\0")) return invalidAdapterResult(adapterId);
@@ -2378,7 +2378,7 @@ var normalizeDetails = (candidate, adapterId) => {
 	return normalizeDiagnosticDetails(createNullPrototypeRecord(entries));
 };
 var normalizePosition = (candidate, adapterId) => {
-	if (!isRecord$1(candidate) || !hasOnlyKeys(candidate, POSITION_KEYS) || !Number.isSafeInteger(candidate["line"]) || !Number.isSafeInteger(candidate["column"]) || !Number.isSafeInteger(candidate["offset"]) || candidate["line"] < 1 || candidate["column"] < 1 || candidate["offset"] < 0) return invalidAdapterResult(adapterId);
+	if (!isRecord$2(candidate) || !hasOnlyKeys(candidate, POSITION_KEYS) || !Number.isSafeInteger(candidate["line"]) || !Number.isSafeInteger(candidate["column"]) || !Number.isSafeInteger(candidate["offset"]) || candidate["line"] < 1 || candidate["column"] < 1 || candidate["offset"] < 0) return invalidAdapterResult(adapterId);
 	return freezeRecursively({
 		column: candidate["column"],
 		line: candidate["line"],
@@ -2387,7 +2387,7 @@ var normalizePosition = (candidate, adapterId) => {
 };
 var normalizeRange = (candidate, adapterId) => {
 	if (candidate === null) return null;
-	if (!isRecord$1(candidate) || !hasOnlyKeys(candidate, RANGE_KEYS)) return invalidAdapterResult(adapterId);
+	if (!isRecord$2(candidate) || !hasOnlyKeys(candidate, RANGE_KEYS)) return invalidAdapterResult(adapterId);
 	const start = normalizePosition(candidate["start"], adapterId);
 	const end = normalizePosition(candidate["end"], adapterId);
 	if (!(end.line > start.line || end.line === start.line && end.column >= start.column) || end.offset < start.offset) return invalidAdapterResult(adapterId);
@@ -2405,7 +2405,7 @@ var readCapability = (agent, capabilityKind, capabilityId) => {
 };
 var normalizeEntity = (candidate, context) => {
 	if (candidate === null) return null;
-	if (!isRecord$1(candidate) || !hasOnlyKeys(candidate, DIAGNOSTIC_ENTITY_KEYS)) return invalidAdapterResult(context.adapterId);
+	if (!isRecord$2(candidate) || !hasOnlyKeys(candidate, DIAGNOSTIC_ENTITY_KEYS)) return invalidAdapterResult(context.adapterId);
 	const entity = {};
 	for (const key of DIAGNOSTIC_ENTITY_KEYS) {
 		const candidateValue = candidate[key];
@@ -2427,7 +2427,7 @@ var normalizeEntity = (candidate, context) => {
 	return normalizeDiagnosticEntity(entity);
 };
 var normalizeReference = (candidate, adapterId) => {
-	if (!isRecord$1(candidate) || !hasOnlyKeys(candidate, REFERENCE_KEYS)) return invalidAdapterResult(adapterId);
+	if (!isRecord$2(candidate) || !hasOnlyKeys(candidate, REFERENCE_KEYS)) return invalidAdapterResult(adapterId);
 	const pathCandidate = candidate["path"];
 	const symbolCandidate = candidate["symbol"];
 	if (typeof pathCandidate !== "string" || !isRepositoryPath(pathCandidate)) return invalidAdapterResult(adapterId);
@@ -2450,7 +2450,7 @@ var normalizeReferences = (candidate, adapterId) => {
 	return freezeRecursively(sortRepositoryReferences(references));
 };
 var normalizeEvidence = (candidate, context) => {
-	if (!isRecord$1(candidate) || !hasOnlyKeys(candidate, EVIDENCE_KEYS)) return invalidAdapterResult(context.adapterId);
+	if (!isRecord$2(candidate) || !hasOnlyKeys(candidate, EVIDENCE_KEYS)) return invalidAdapterResult(context.adapterId);
 	const source = candidate["source"];
 	const kind = candidate["kind"];
 	const agentId = candidate["agentId"];
@@ -2484,7 +2484,7 @@ var validateEvidenceReferences = async (evidence, context) => {
 	}
 };
 var normalizeDiagnostic = (candidate, context) => {
-	if (!isRecord$1(candidate) || !hasOnlyKeys(candidate, DIAGNOSTIC_KEYS)) return invalidAdapterResult(context.adapterId);
+	if (!isRecord$2(candidate) || !hasOnlyKeys(candidate, DIAGNOSTIC_KEYS)) return invalidAdapterResult(context.adapterId);
 	const source = candidate["source"];
 	const code = candidate["code"];
 	const message = candidate["message"];
@@ -2556,7 +2556,7 @@ var validateRuntimeAdapterResult = async (candidate, context, outputCounts) => {
 	let evidence;
 	let validationState;
 	try {
-		if (!isRecord$1(candidate) || !hasOnlyKeys(candidate, ADAPTER_RESULT_KEYS)) return invalidAdapterResult(context.adapterId);
+		if (!isRecord$2(candidate) || !hasOnlyKeys(candidate, ADAPTER_RESULT_KEYS)) return invalidAdapterResult(context.adapterId);
 		const evidenceValue = candidate["evidence"];
 		const diagnosticsValue = candidate["diagnostics"];
 		if (!Array.isArray(evidenceValue) || !Array.isArray(diagnosticsValue)) return invalidAdapterResult(context.adapterId);
@@ -4118,7 +4118,7 @@ var createProjectIndex = (input) => {
 };
 //#endregion
 //#region src/repository-reference-validation/index.ts
-var childPointer = (pointer, segment) => {
+var childPointer$1 = (pointer, segment) => {
 	return `${pointer}/${escapeJsonPointerSegment(segment)}`;
 };
 var compareNullableStrings = (left, right) => {
@@ -4134,7 +4134,7 @@ var addReferenceCandidates = (candidates, references, pointer, entity) => {
 		entity,
 		kind: "reference",
 		path: reference.path,
-		pointer: childPointer(pointer, String(index))
+		pointer: childPointer$1(pointer, String(index))
 	});
 };
 /** Adds sorted exact impact paths while retaining skipped glob indexes. */
@@ -4145,26 +4145,26 @@ var addImpactCandidates = (candidates, affectedBy, pointer, entity) => {
 			entity,
 			kind: "impact",
 			path: parseRepositoryPath(pattern),
-			pointer: childPointer(pointer, String(index))
+			pointer: childPointer$1(pointer, String(index))
 		});
 	}
 };
 /** Adds repository-backed declarations owned by one context or decision relationship. */
 var addRelationshipCandidates = (candidates, relationship, pointer, entity) => {
-	addReferenceCandidates(candidates, relationship.bindings, childPointer(pointer, "bindings"), entity);
-	addImpactCandidates(candidates, relationship.affectedBy, childPointer(pointer, "affectedBy"), entity);
+	addReferenceCandidates(candidates, relationship.bindings, childPointer$1(pointer, "bindings"), entity);
+	addImpactCandidates(candidates, relationship.affectedBy, childPointer$1(pointer, "affectedBy"), entity);
 };
 /** Adds related repository references from sorted unresolved requirements. */
 var addUnresolvedCandidates = (candidates, requirements, pointer, entity) => {
 	for (const requirementId of Object.keys(requirements ?? {}).sort(compareExactStrings)) {
 		const requirement = requirements?.[requirementId];
 		if (requirement === void 0) continue;
-		addReferenceCandidates(candidates, requirement.related, childPointer(childPointer(pointer, requirementId), "related"), entity);
+		addReferenceCandidates(candidates, requirement.related, childPointer$1(childPointer$1(pointer, requirementId), "related"), entity);
 	}
 };
 /** Adds one capability's implementation, optional bindings, and exact impact paths. */
 var addCapabilityCandidates = (candidates, capability, capabilityKind, capabilityId, agentId, collectionPointer, additionalReferences = []) => {
-	const capabilityPointer = childPointer(collectionPointer, capabilityId);
+	const capabilityPointer = childPointer$1(collectionPointer, capabilityId);
 	const capabilityEntity = {
 		agentId,
 		capabilityId,
@@ -4174,21 +4174,21 @@ var addCapabilityCandidates = (candidates, capability, capabilityKind, capabilit
 		entity: capabilityEntity,
 		kind: `${capabilityKind}-implementation`,
 		path: capability.implementation.path,
-		pointer: childPointer(capabilityPointer, "implementation")
+		pointer: childPointer$1(capabilityPointer, "implementation")
 	});
 	for (const [property, reference] of [["registration", capability.registration], ...additionalReferences]) if (reference !== void 0) candidates.push({
 		entity: capabilityEntity,
 		kind: "reference",
 		path: reference.path,
-		pointer: childPointer(capabilityPointer, property)
+		pointer: childPointer$1(capabilityPointer, property)
 	});
-	addImpactCandidates(candidates, capability.affectedBy, childPointer(capabilityPointer, "affectedBy"), capabilityEntity);
+	addImpactCandidates(candidates, capability.affectedBy, childPointer$1(capabilityPointer, "affectedBy"), capabilityEntity);
 };
 /** Adds all repository-backed declarations owned by one normalized agent. */
 var addAgentCandidates = (candidates, agentId, agent) => {
 	const pointer = `/agents/${escapeJsonPointerSegment(agentId)}`;
 	const entity = { agentId };
-	const bindingsPointer = childPointer(pointer, "bindings");
+	const bindingsPointer = childPointer$1(pointer, "bindings");
 	const bindings = agent.bindings;
 	for (const property of [
 		"runtimeAgent",
@@ -4201,7 +4201,7 @@ var addAgentCandidates = (candidates, agentId, agent) => {
 			entity,
 			kind: "reference",
 			path: reference.path,
-			pointer: childPointer(bindingsPointer, property)
+			pointer: childPointer$1(bindingsPointer, property)
 		});
 	}
 	for (const variableId of Object.keys(bindings?.variableProviders ?? {}).sort(compareExactStrings)) {
@@ -4213,21 +4213,21 @@ var addAgentCandidates = (candidates, agentId, agent) => {
 			},
 			kind: "reference",
 			path: reference.path,
-			pointer: childPointer(childPointer(bindingsPointer, "variableProviders"), variableId)
+			pointer: childPointer$1(childPointer$1(bindingsPointer, "variableProviders"), variableId)
 		});
 	}
-	addImpactCandidates(candidates, agent.affectedBy, childPointer(pointer, "affectedBy"), entity);
-	const toolsPointer = childPointer(pointer, "tools");
+	addImpactCandidates(candidates, agent.affectedBy, childPointer$1(pointer, "affectedBy"), entity);
+	const toolsPointer = childPointer$1(pointer, "tools");
 	for (const capabilityId of Object.keys(agent.tools ?? {}).sort(compareExactStrings)) {
 		const capability = agent.tools?.[capabilityId];
 		if (capability !== void 0) addCapabilityCandidates(candidates, capability, "tool", capabilityId, agentId, toolsPointer, [["inputSchema", capability.inputSchema], ["outputSchema", capability.outputSchema]]);
 	}
-	const skillsPointer = childPointer(pointer, "skills");
+	const skillsPointer = childPointer$1(pointer, "skills");
 	for (const capabilityId of Object.keys(agent.skills ?? {}).sort(compareExactStrings)) {
 		const capability = agent.skills?.[capabilityId];
 		if (capability !== void 0) addCapabilityCandidates(candidates, capability, "skill", capabilityId, agentId, skillsPointer);
 	}
-	addUnresolvedCandidates(candidates, agent.unresolved, childPointer(pointer, "unresolved"), entity);
+	addUnresolvedCandidates(candidates, agent.unresolved, childPointer$1(pointer, "unresolved"), entity);
 };
 /** Collects every repository-backed manifest declaration in deterministic pointer order. */
 var collectCandidates = (manifest) => {
@@ -4237,7 +4237,7 @@ var collectCandidates = (manifest) => {
 		for (const referencedPath of Object.keys(relationships ?? {}).sort(compareExactStrings)) {
 			const relationship = relationships?.[referencedPath];
 			if (relationship === void 0) continue;
-			const pointer = childPointer(`/${property}`, referencedPath);
+			const pointer = childPointer$1(`/${property}`, referencedPath);
 			const decisionId = property === "decisions" ? parseDecisionIdFromPath(parseRepositoryPath(referencedPath)) : null;
 			addRelationshipCandidates(candidates, relationship, pointer, decisionId === null ? null : { decisionId });
 		}
@@ -4494,34 +4494,34 @@ var inspectUniversalProject = async (context, options) => {
 };
 //#endregion
 //#region src/project-inspection/index.ts
-var isRecord = (candidate) => {
+var isRecord$1 = (candidate) => {
 	return typeof candidate === "object" && candidate !== null && !Array.isArray(candidate);
 };
-var invalidArgument = () => {
+var invalidArgument$1 = () => {
 	throw new CoreOperationException({
 		code: "INVALID_ARGUMENT",
 		operation: "inspect-project"
 	});
 };
 var isRepositoryReader = (candidate) => {
-	return isRecord(candidate) && typeof candidate["getEntry"] === "function" && typeof candidate["listEntries"] === "function" && typeof candidate["readFile"] === "function";
+	return isRecord$1(candidate) && typeof candidate["getEntry"] === "function" && typeof candidate["listEntries"] === "function" && typeof candidate["readFile"] === "function";
 };
 var isAbortSignal = (candidate) => {
-	return isRecord(candidate) && typeof candidate["aborted"] === "boolean" && typeof candidate["addEventListener"] === "function" && typeof candidate["removeEventListener"] === "function";
+	return isRecord$1(candidate) && typeof candidate["aborted"] === "boolean" && typeof candidate["addEventListener"] === "function" && typeof candidate["removeEventListener"] === "function";
 };
 var validateInput = (candidate) => {
 	try {
-		if (!isRecord(candidate)) return invalidArgument();
+		if (!isRecord$1(candidate)) return invalidArgument$1();
 		const repository = candidate["repository"];
 		const signal = candidate["signal"];
-		if (!isRepositoryReader(repository) || signal !== void 0 && !isAbortSignal(signal)) return invalidArgument();
+		if (!isRepositoryReader(repository) || signal !== void 0 && !isAbortSignal(signal)) return invalidArgument$1();
 		return {
 			repository,
 			...signal === void 0 ? {} : { signal }
 		};
 	} catch (error) {
 		if (error instanceof CoreOperationException) throw error;
-		return invalidArgument();
+		return invalidArgument$1();
 	}
 };
 /**
@@ -4577,6 +4577,391 @@ var inspectProject = async (input, options) => {
 	});
 };
 //#endregion
+//#region src/scope-matching/validations.ts
+var isRecord = (value) => {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+/** Throws the stable invalid-argument failure for malformed scope input. */
+var invalidArgument = () => {
+	throw new CoreOperationException({
+		code: "INVALID_ARGUMENT",
+		operation: "match-manifest-scope"
+	});
+};
+/** Throws the stable resource failure for an exhausted scope-input budget. */
+var resourceLimitExceeded = (limit) => {
+	throw new CoreOperationException({
+		code: "RESOURCE_LIMIT_EXCEEDED",
+		limit,
+		operation: "match-manifest-scope"
+	});
+};
+/** Measures scalar UTF-8 bytes without allocating an encoded copy. */
+var measureUtf8ByteLength = (value) => {
+	let byteLength = 0;
+	for (const scalar of value) {
+		const codePoint = scalar.codePointAt(0) ?? 0;
+		byteLength += codePoint <= 127 ? 1 : codePoint <= 2047 ? 2 : codePoint <= 65535 ? 3 : 4;
+	}
+	return byteLength;
+};
+/**
+* Validates and snapshots one public manifest-scope input.
+* @param input The untrusted manifest document and changed logical paths.
+* @param limits The immutable Core resource limits.
+* @returns The detached manifest input and sorted unique repository paths.
+* @throws
+* - INVALID_REPOSITORY_PATH: A changed repository path is invalid.
+* - INVALID_ARGUMENT: The scope operation received an invalid argument.
+* - RESOURCE_LIMIT_EXCEEDED: The changed-path count or byte budget was exceeded.
+*/
+var normalizeManifestScopeInput = (input, limits) => {
+	if (!isRecord(input)) return invalidArgument();
+	const manifest = input["manifest"];
+	const pathCandidates = input["paths"];
+	if (!isRecord(manifest) || !Array.isArray(pathCandidates)) return invalidArgument();
+	if (pathCandidates.length > limits.maxEntries) return resourceLimitExceeded("maxEntries");
+	const uniquePaths = /* @__PURE__ */ new Set();
+	let totalBytes = 0;
+	for (const [index, candidate] of pathCandidates.entries()) {
+		if (typeof candidate !== "string") return invalidArgument();
+		const path = parseRepositoryPath(candidate);
+		totalBytes += measureUtf8ByteLength(path) + (index === 0 ? 0 : 1);
+		if (totalBytes > limits.maxTotalBytesRead) return resourceLimitExceeded("maxTotalBytesRead");
+		uniquePaths.add(path);
+	}
+	return {
+		manifest,
+		paths: [...uniquePaths].sort(compareExactStrings)
+	};
+};
+//#endregion
+//#region src/scope-matching/matching.ts
+var childPointer = (pointer, segment) => {
+	return `${pointer}/${escapeJsonPointerSegment(segment)}`;
+};
+var createOwner = (kind, id, agentId = null) => ({
+	agentId,
+	id,
+	kind
+});
+var compareOwners = (left, right) => {
+	return compareExactStrings(left.kind, right.kind) || compareExactStrings(left.agentId ?? "", right.agentId ?? "") || compareExactStrings(left.id, right.id);
+};
+var getDeclarationValue = (declaration) => {
+	return declaration.kind === "exact" ? declaration.path : declaration.pattern;
+};
+var compareDeclarations = (left, right) => {
+	return compareOwners(left.owner, right.owner) || compareExactStrings(left.field, right.field) || compareExactStrings(getDeclarationValue(left.declaration), getDeclarationValue(right.declaration)) || compareExactStrings(left.pointer, right.pointer);
+};
+/** Adds one exact repository relationship to the normalized declaration collection. */
+var addExactDeclaration = (declarations, owner, field, pointer, reference) => {
+	declarations.push({
+		declaration: typeof reference === "string" ? {
+			kind: "exact",
+			path: reference,
+			symbol: null
+		} : {
+			kind: "exact",
+			path: reference.path,
+			symbol: reference.symbol ?? null
+		},
+		field,
+		owner,
+		pointer
+	});
+};
+/** Adds sorted repository references while preserving normalized declaration pointers. */
+var addReferenceDeclarations = (declarations, references, owner, field, pointer) => {
+	for (const [index, reference] of (references ?? []).entries()) addExactDeclaration(declarations, owner, field, childPointer(pointer, String(index)), reference);
+};
+/** Adds exact and simple-glob impact relationships in normalized array order. */
+var addAffectedByDeclarations = (declarations, affectedBy, owner, pointer) => {
+	for (const [index, pattern] of (affectedBy ?? []).entries()) declarations.push({
+		declaration: pattern.includes("*") ? {
+			kind: "glob",
+			pattern
+		} : {
+			kind: "exact",
+			path: pattern,
+			symbol: null
+		},
+		field: "affectedBy",
+		owner,
+		pointer: childPointer(pointer, String(index))
+	});
+};
+/** Adds project-level or agent-level unresolved requirement references. */
+var addUnresolvedDeclarations = (declarations, requirements, pointer, agentId) => {
+	for (const requirementId of Object.keys(requirements ?? {}).sort(compareExactStrings)) {
+		const requirement = requirements?.[requirementId];
+		if (requirement === void 0) continue;
+		const owner = createOwner("unresolved", requirementId, agentId);
+		addReferenceDeclarations(declarations, requirement.related, owner, "related", childPointer(childPointer(pointer, requirementId), "related"));
+	}
+};
+/** Adds exact and impact declarations owned by one tool or skill capability. */
+var addCapabilityDeclarations = (declarations, capabilityId, capability, agentId, pointer) => {
+	const owner = createOwner(capability.kind, capabilityId, agentId);
+	addExactDeclaration(declarations, owner, "implementation", childPointer(pointer, "implementation"), capability.value.implementation);
+	if (capability.value.registration !== void 0) addExactDeclaration(declarations, owner, "registration", childPointer(pointer, "registration"), capability.value.registration);
+	if (capability.kind === "tool") for (const field of ["inputSchema", "outputSchema"]) {
+		const reference = capability.value[field];
+		if (reference !== void 0) addExactDeclaration(declarations, owner, field, childPointer(pointer, field), reference);
+	}
+	addAffectedByDeclarations(declarations, capability.value.affectedBy, owner, childPointer(pointer, "affectedBy"));
+};
+/** Adds all exact and impact relationships owned by one registered agent. */
+var addAgentDeclarations = (declarations, agentId, agent) => {
+	const pointer = childPointer("/agents", agentId);
+	const owner = createOwner("agent", agentId, agentId);
+	const bindingsPointer = childPointer(pointer, "bindings");
+	for (const field of [
+		"runtimeAgent",
+		"inputSchema",
+		"outputSchema",
+		"instructionLoader"
+	]) {
+		const reference = agent.bindings?.[field];
+		if (reference !== void 0) addExactDeclaration(declarations, owner, field, childPointer(bindingsPointer, field), reference);
+	}
+	for (const variableId of Object.keys(agent.bindings?.variableProviders ?? {}).sort(compareExactStrings)) {
+		const reference = agent.bindings?.variableProviders?.[variableId];
+		if (reference !== void 0) addExactDeclaration(declarations, owner, "variableProvider", childPointer(childPointer(bindingsPointer, "variableProviders"), variableId), reference);
+	}
+	addAffectedByDeclarations(declarations, agent.affectedBy, owner, childPointer(pointer, "affectedBy"));
+	for (const capabilityId of Object.keys(agent.tools ?? {}).sort(compareExactStrings)) {
+		const tool = agent.tools?.[capabilityId];
+		if (tool !== void 0) addCapabilityDeclarations(declarations, capabilityId, {
+			kind: "tool",
+			value: tool
+		}, agentId, childPointer(childPointer(pointer, "tools"), capabilityId));
+	}
+	for (const capabilityId of Object.keys(agent.skills ?? {}).sort(compareExactStrings)) {
+		const skill = agent.skills?.[capabilityId];
+		if (skill !== void 0) addCapabilityDeclarations(declarations, capabilityId, {
+			kind: "skill",
+			value: skill
+		}, agentId, childPointer(childPointer(pointer, "skills"), capabilityId));
+	}
+	for (const [index, mirror] of (agent.mirrors ?? []).entries()) addExactDeclaration(declarations, owner, "mirrors", childPointer(childPointer(pointer, "mirrors"), String(index)), mirror);
+	addUnresolvedDeclarations(declarations, agent.unresolved, childPointer(pointer, "unresolved"), agentId);
+};
+/** Collects every version 1 declaration that can establish changed-path relevance. */
+var collectDeclarations = (manifest) => {
+	const declarations = [];
+	for (const kind of ["context", "decision"]) {
+		const relationships = kind === "context" ? manifest.context : manifest.decisions;
+		for (const ownerId of Object.keys(relationships ?? {}).sort(compareExactStrings)) {
+			const relationship = relationships?.[ownerId];
+			if (relationship === void 0) continue;
+			const owner = createOwner(kind, ownerId);
+			const pointer = childPointer(kind === "context" ? "/context" : "/decisions", ownerId);
+			addReferenceDeclarations(declarations, relationship.bindings, owner, "bindings", childPointer(pointer, "bindings"));
+			addAffectedByDeclarations(declarations, relationship.affectedBy, owner, childPointer(pointer, "affectedBy"));
+		}
+	}
+	addUnresolvedDeclarations(declarations, manifest.unresolved, "/unresolved", null);
+	for (const agentId of Object.keys(manifest.agents ?? {}).sort(compareExactStrings)) {
+		const agent = manifest.agents?.[agentId];
+		if (agent !== void 0) addAgentDeclarations(declarations, agentId, agent);
+	}
+	return declarations.sort(compareDeclarations);
+};
+/** Tests a single-segment wildcard without regular-expression interpretation. */
+var matchesSegment = (pattern, value) => {
+	let patternIndex = 0;
+	let valueIndex = 0;
+	let starIndex = -1;
+	let starValueIndex = -1;
+	while (valueIndex < value.length) {
+		if (pattern[patternIndex] === value[valueIndex]) {
+			patternIndex += 1;
+			valueIndex += 1;
+			continue;
+		}
+		if (pattern[patternIndex] === "*") {
+			starIndex = patternIndex;
+			starValueIndex = valueIndex;
+			patternIndex += 1;
+			continue;
+		}
+		if (starIndex === -1) return false;
+		patternIndex = starIndex + 1;
+		starValueIndex += 1;
+		valueIndex = starValueIndex;
+	}
+	while (pattern[patternIndex] === "*") patternIndex += 1;
+	return patternIndex === pattern.length;
+};
+/** Matches validated simple-glob segments with zero-or-more-segment globstars. */
+var matchesGlob = (patternSegments, path) => {
+	const pathSegments = path.slice(1).split("/");
+	let reachable = new Uint8Array(pathSegments.length + 1);
+	reachable[0] = 1;
+	for (const patternSegment of patternSegments) {
+		const next = new Uint8Array(pathSegments.length + 1);
+		if (patternSegment === "**") {
+			let canReach = false;
+			for (let index = 0; index < reachable.length; index += 1) {
+				canReach ||= reachable[index] === 1;
+				next[index] = canReach ? 1 : 0;
+			}
+		} else for (let index = 0; index < pathSegments.length; index += 1) if (reachable[index] === 1 && matchesSegment(patternSegment, pathSegments[index] ?? "")) next[index + 1] = 1;
+		reachable = next;
+	}
+	return reachable[pathSegments.length] === 1;
+};
+/** Builds exact and first-segment glob indexes once for one parsed manifest. */
+var compileManifestScope = (manifest, limits) => {
+	const declarations = collectDeclarations(manifest);
+	if (declarations.length > limits.maxEntries) throw new CoreOperationException({
+		code: "RESOURCE_LIMIT_EXCEEDED",
+		limit: "maxEntries",
+		operation: "match-manifest-scope"
+	});
+	const exact = /* @__PURE__ */ new Map();
+	const globalGlobs = [];
+	const globsByFirstSegment = /* @__PURE__ */ new Map();
+	for (const declaration of declarations) {
+		if (declaration.declaration.kind === "exact") {
+			const existing = exact.get(declaration.declaration.path) ?? [];
+			existing.push(declaration);
+			exact.set(declaration.declaration.path, existing);
+			continue;
+		}
+		const segments = declaration.declaration.pattern.slice(1).split("/");
+		const compiled = {
+			declaration,
+			segments
+		};
+		const firstSegment = segments[0] ?? "";
+		if (firstSegment === "**" || firstSegment.includes("*")) globalGlobs.push(compiled);
+		else {
+			const existing = globsByFirstSegment.get(firstSegment) ?? [];
+			existing.push(compiled);
+			globsByFirstSegment.set(firstSegment, existing);
+		}
+	}
+	return {
+		declarations,
+		exact,
+		globalGlobs,
+		globsByFirstSegment
+	};
+};
+var compareMatches = (left, right) => {
+	return compareOwners(left.owner, right.owner) || compareExactStrings(left.field, right.field) || compareExactStrings(getDeclarationValue(left.declaration), getDeclarationValue(right.declaration)) || compareExactStrings(left.inputPath, right.inputPath) || compareExactStrings(left.pointer, right.pointer);
+};
+var createMatch = (inputPath, relationship) => ({
+	declaration: relationship.declaration,
+	field: relationship.field,
+	inputPath,
+	owner: relationship.owner,
+	pointer: relationship.pointer
+});
+/** Adds one match without ever allocating beyond the operation entry budget. */
+var addMatch = (matches, inputPath, relationship, limits) => {
+	if (matches.length >= limits.maxEntries) throw new CoreOperationException({
+		code: "RESOURCE_LIMIT_EXCEEDED",
+		limit: "maxEntries",
+		operation: "match-manifest-scope"
+	});
+	matches.push(createMatch(inputPath, relationship));
+};
+/** Appends matches from one precompiled glob bucket without copying the bucket. */
+var addGlobMatches = (matches, inputPath, declarations, limits) => {
+	for (const compiled of declarations) if (matchesGlob(compiled.segments, inputPath)) addMatch(matches, inputPath, compiled.declaration, limits);
+};
+/** Creates the canonical digest of the sorted unique changed-path set. */
+var calculateManifestScopeInputDigest = async (paths) => {
+	const value = paths.join("\0");
+	return calculateNormalizedTextDigest({
+		scalarLength: countUnicodeScalars$1(value),
+		utf8ByteLength: measureUtf8ByteLength(value),
+		value
+	});
+};
+/**
+* Matches normalized changed paths against one valid version 1 manifest.
+* @param manifest The parsed and validated manifest value.
+* @param paths Sorted unique repository-logical changed paths.
+* @param limits The immutable Core operation limits.
+* @returns Frozen content-free matches and stable aggregate counts.
+* @throws
+* - RESOURCE_LIMIT_EXCEEDED: The declaration or match count exceeded `maxEntries`.
+*/
+var matchParsedManifestScope = (manifest, paths, limits) => {
+	const compiled = compileManifestScope(manifest, limits);
+	const matches = [];
+	const matchedOwners = /* @__PURE__ */ new Set();
+	const matchedPaths = /* @__PURE__ */ new Set();
+	for (const path of paths) {
+		const firstSegment = path.slice(1).split("/", 1)[0] ?? "";
+		const exactDeclarations = compiled.exact.get(path) ?? [];
+		for (const relationship of exactDeclarations) addMatch(matches, path, relationship, limits);
+		addGlobMatches(matches, path, compiled.globalGlobs, limits);
+		addGlobMatches(matches, path, compiled.globsByFirstSegment.get(firstSegment) ?? [], limits);
+	}
+	matches.sort(compareMatches);
+	for (const match of matches) {
+		matchedOwners.add(`${match.owner.kind}\0${match.owner.agentId ?? ""}\0${match.owner.id}`);
+		matchedPaths.add(match.inputPath);
+	}
+	return freezeRecursively({
+		counts: {
+			declarations: compiled.declarations.length,
+			inputPaths: paths.length,
+			matchedOwners: matchedOwners.size,
+			matchedPaths: matchedPaths.size,
+			matches: matches.length
+		},
+		matches
+	});
+};
+//#endregion
+//#region src/scope-matching/scope.ts
+/**
+* Parses a manifest and matches its repository relationships against changed logical paths.
+* @param input The canonical manifest document and untrusted changed-path collection.
+* @param options The immutable Core operation options.
+* @returns A promise resolving to frozen content-free scope metadata and matches.
+* @throws
+* - INVALID_REPOSITORY_PATH: The manifest path or a changed repository path is invalid.
+* - INVALID_ARGUMENT: The scope operation received an invalid argument.
+* - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.
+*/
+var matchManifestScope = async (input, options) => {
+	const normalized = normalizeManifestScopeInput(input, options.limits);
+	const inputDigest = await calculateManifestScopeInputDigest(normalized.paths);
+	const parsed = await parseManifestDocument(normalized.manifest, options, "match-manifest-scope");
+	if (!parsed.valid || parsed.asset === null || parsed.manifest === null) return freezeRecursively({
+		counts: {
+			declarations: 0,
+			inputPaths: normalized.paths.length,
+			matchedOwners: 0,
+			matchedPaths: 0,
+			matches: 0
+		},
+		diagnostics: parsed.diagnostics,
+		inputDigest,
+		manifestDigest: null,
+		matches: [],
+		relevant: false,
+		valid: false
+	});
+	const matched = matchParsedManifestScope(parsed.manifest, normalized.paths, options.limits);
+	return freezeRecursively({
+		counts: matched.counts,
+		diagnostics: [],
+		inputDigest,
+		manifestDigest: parsed.asset.digest,
+		matches: matched.matches,
+		relevant: matched.matches.length > 0,
+		valid: true
+	});
+};
+//#endregion
 //#region src/core/index.ts
 /**
 * Creates one immutable Core instance from detached configuration snapshots.
@@ -4595,6 +4980,7 @@ var createCore = (options) => {
 			return calculateContentDigest(input, createCoreOperationOptionsSnapshot(snapshot).limits);
 		},
 		inspectProject: (input) => inspectProject(input, createCoreOperationOptionsSnapshot(snapshot)),
+		matchManifestScope: (input) => matchManifestScope(input, createCoreOperationOptionsSnapshot(snapshot)),
 		normalizeText: (input) => {
 			return normalizeTextDocument(input, createCoreOperationOptionsSnapshot(snapshot).limits, "normalize-text");
 		},