@tangle-network/agent-knowledge 19.0.1 → 19.1.0

package/dist/index.js

@@ -1,6 +1,6 @@
-import { $ as FileSystemKbStore, $t as assertResearchClaimEvidenceIntegrity, A as visibilityIndexOf, An as normalizePagesDirectory, At as WIKILINK_REGEX, B as gradeClaims, Bn as renameDurable, Bt as KnowledgePageSchema, C as nonEmpty$1, Cn as assertKnowledgeMutationPath, Ct as initKnowledgeBase, D as validateOrigin, Dn as prepareKnowledgeFileTransaction, Dt as layoutFor, E as validateKnowledgePage, En as knowledgeFileTransactionPlanHash, Et as knowledgePageFromMarkdown, F as CHECKABLE_RUNG_THRESHOLD, Fn as listRegularFilesWithinRoot, Ft as KnowledgeEventSchema, G as writeKnowledgeIndex, Gn as writeFileDurableWithinRoot, Gt as ResearchClaimLedgerSchema, H as verdictFor, Hn as withSafeDescendant, Ht as KnowledgeRelationNodeSchema, I as DEADLINE_EXIT_CODE, In as readRegularFileNoFollow, It as KnowledgeGraphEdgeSchema, J as loadSourceRegistry, Jn as mediaTypeFor, Jt as SourceAnchorSchema, K as addSourcePath, Kn as writeJsonDurable, Kt as ResearchClaimRecordSchema, L as UncheckableClaimError, Ln as readRegularFileWithinRoot, Lt as KnowledgeGraphNodeSchema, M as normalizePageText, Mn as canonicalRelativeWithinRoot, Mt as normalizeLinkTarget, N as validateKnowledgeIndex, Nn as isKernelAnchoredPath, Nt as DeepQuestionSchema, O as verifyKnowledgeVisibilitySnapshot, On as rollbackKnowledgeFileTransaction, Ot as loadKnowledgePages, P as lintKnowledgeIndex, Pn as isMissingFile, Pt as KnowledgeBaseCandidateSchema, Q as ClaimLedgerMigrationRequiredError, Qt as assertDeepQuestionIntegrity, R as assertGradeableEvidence, Rn as relativeWithinRoot, Rt as KnowledgeIndexSchema, S as knowledgeVisibilityArtifactRef, Sn as applyKnowledgeFileTransaction, St as SCAFFOLD_PAGE_BASENAMES, T as normalizeVisibilityRef, Tn as finishKnowledgeFileTransaction, Tt as isScaffoldPath, U as verifyGradeableEvidence, Un as withSafeDirectory, Ut as KnowledgeRelationSchema, V as gradeFor, Vn as syncDirectory, Vt as KnowledgeRelationGraphSchema, W as buildKnowledgeIndex, Wn as writeFileDurable, Wt as ResearchClaimEvidenceSchema, X as sourceRegistryPath, Xt as KNOWLEDGE_EVENT_TYPES, Y as snapshotSourceTextInput, Yn as textSourceAdapter, Yt as SourceRecordSchema, Z as writeSourceRegistry, Zt as ClaimLedgerGoalConflictError, _ as createKnowledgeVisibilitySnapshot, _n as isKnowledgeMutationHeld, _t as parseKnowledgeCitationReference, a as applyKnowledgeWriteBlocksFile, an as deepQuestionId, at as assertClaimLedgerId, b as encodeKnowledgeVisibilitySnapshot, bn as withKnowledgeMutation, bt as resolveRunScopedCitation, c as KnowledgeDuplicateIntakeError, cn as materializeRegisteredClaimEvidence, ct as KnowledgeCitationAuditError, d as createFileRunLineageAuthority, dn as normalizeClaimText, dt as assertKnowledgeCitationAudit, en as assertResearchClaimLedgerIntegrity, et as KB_CLAIM_LEDGER_DIR, f as createRunScopedStores, fn as researchSourceVersionKey, ft as assertKnowledgeCitationsResolved, g as assertSchemaVersion, gn as inspectPendingKnowledgeMutation, gt as formatKnowledgeCitationReference, h as KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, hn as acquireDurableFileLock, ht as auditKnowledgeCitations, i as applyKnowledgeWriteBlocks, in as claimSourceHost, it as MemoryKbStore, j as detectNearDuplicatePages, jn as canonicalPathsEqual, jt as extractWikilinks, k as visibilityIdentity, kn as DEFAULT_PAGES_DIRECTORY, kt as writeJson, l as assertKnowledgeWriteIntake, ln as mergeClaimLedgers, lt as KnowledgeCitationResolutionError, m as KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, mn as parseFrontmatter, mt as auditCurrentRunCitations, n as inspectKnowledgeIndex, nn as claimEvidenceId, nt as KB_INDEX_PATH, o as isSafeKnowledgePath, on as emptyClaimLedger, ot as buildKnowledgeGraph, p as originatedPages, pn as formatFrontmatter, pt as assertRunScopedCitationsResolved, q as addSourceText, qn as writeJsonDurableWithinRoot, qt as ResearchSourceVersionSchema, r as stringMetadata, rn as claimId, rt as KB_STORE_DIR, s as parseKnowledgeWriteBlocks, sn as linkClaimContradictions, st as knowledgePageRelations, t as explainKnowledgeTarget, tn as assertTrackedClaimIntegrity, tt as KB_EVENTS_PATH, u as RUN_LINEAGE_BASENAME, un as mergeTrackedClaims, ut as assertCurrentRunCitationsResolved, v as decodeKnowledgeVisibilitySnapshot, vn as recoverPendingKnowledgeMutation, vt as resolveKnowledgeCitation, w as normalizeVisibilityArtifact, wn as commitKnowledgeFileMutations, wt as isKnowledgePagePath, x as knowledgePageDigest, xn as withKnowledgeRead, xt as resolveRunScopedCitations, y as digest, yn as runInKnowledgeMutationScope, yt as resolveKnowledgeCitations, z as claimCheckKey, zn as removeDurable, zt as KnowledgePageInvalidationSchema } from "./inspect-C6YK7af7.js";
+import { $ as writeSourceRegistry, $t as ClaimLedgerGoalConflictError, A as verifyKnowledgeVisibilitySnapshot, An as rollbackKnowledgeFileTransaction, At as loadKnowledgePages, B as assertGradeableEvidence, Bn as relativeWithinRoot, Bt as KnowledgeIndexSchema, C as knowledgePageDigest, Cn as withKnowledgeRead, Ct as resolveRunScopedCitations, D as normalizeVisibilityRef, Dn as finishKnowledgeFileTransaction, Dt as isScaffoldPath, E as normalizeVisibilityArtifact, En as commitKnowledgeFileMutations, Et as isKnowledgePagePath, F as validateKnowledgeIndex, Fn as isKernelAnchoredPath, Ft as DeepQuestionSchema, G as verifyGradeableEvidence, Gn as withSafeDirectory, Gt as KnowledgeRelationSchema, H as gradeClaims, Hn as renameDurable, Ht as KnowledgePageSchema, I as lintKnowledgeIndex, In as isMissingFile, It as KnowledgeBaseCandidateSchema, J as addSourcePath, Jn as writeJsonDurable, Jt as ResearchClaimRecordSchema, K as buildKnowledgeIndex, Kn as writeFileDurable, Kt as ResearchClaimEvidenceSchema, L as CHECKABLE_RUNG_THRESHOLD, Ln as listRegularFilesWithinRoot, Lt as KnowledgeEventSchema, M as visibilityIndexOf, Mn as normalizePagesDirectory, Mt as WIKILINK_REGEX, N as detectNearDuplicatePages, Nn as canonicalPathsEqual, Nt as extractWikilinks, O as validateKnowledgePage, On as knowledgeFileTransactionPlanHash, Ot as knowledgePageFromMarkdown, P as normalizePageText, Pn as canonicalRelativeWithinRoot, Pt as normalizeLinkTarget, Q as sourceRegistryPath, Qt as KNOWLEDGE_EVENT_TYPES, R as DEADLINE_EXIT_CODE, Rn as readRegularFileNoFollow, Rt as KnowledgeGraphEdgeSchema, S as encodeKnowledgeVisibilitySnapshot, Sn as withKnowledgeMutation, St as resolveRunScopedCitation, T as nonEmpty$1, Tn as assertKnowledgeMutationPath, Tt as initKnowledgeBase, U as gradeFor, Un as syncDirectory, Ut as KnowledgeRelationGraphSchema, V as claimCheckKey, Vn as removeDurable, Vt as KnowledgePageInvalidationSchema, W as verdictFor, Wn as withSafeDescendant, Wt as KnowledgeRelationNodeSchema, X as loadSourceRegistry, Xn as mediaTypeFor, Xt as SourceAnchorSchema, Y as addSourceText, Yn as writeJsonDurableWithinRoot, Yt as ResearchSourceVersionSchema, Z as snapshotSourceTextInput, Zn as textSourceAdapter, Zt as SourceRecordSchema, _ as KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, _n as acquireDurableFileLock, _t as auditKnowledgeCitations, a as applyKnowledgeWriteBlocksFile, an as claimId, at as KB_STORE_DIR, b as decodeKnowledgeVisibilitySnapshot, bn as recoverPendingKnowledgeMutation, bt as resolveKnowledgeCitation, c as KnowledgeDuplicateIntakeError, cn as emptyClaimLedger, ct as buildKnowledgeGraph, d as createFileRunLineageAuthority, dn as mergeClaimLedgers, dt as KnowledgeCitationResolutionError, en as assertDeepQuestionIntegrity, et as ClaimLedgerMigrationRequiredError, f as createRunScopedStores, fn as mergeTrackedClaims, ft as assertCurrentRunCitationsResolved, g as KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, gn as parseFrontmatter, gt as auditCurrentRunCitations, h as originatedPages, hn as formatFrontmatter, ht as assertRunScopedCitationsResolved, i as applyKnowledgeWriteBlocks, in as claimEvidenceId, it as KB_INDEX_PATH, j as visibilityIdentity, jn as DEFAULT_PAGES_DIRECTORY, jt as writeJson, k as validateOrigin, kn as prepareKnowledgeFileTransaction, kt as layoutFor, l as assertKnowledgeWriteIntake, ln as linkClaimContradictions, lt as knowledgePageRelations, m as loadKnowledgeToolChain, mn as researchSourceVersionKey, mt as assertKnowledgeCitationsResolved, n as inspectKnowledgeIndex, nn as assertResearchClaimLedgerIntegrity, nt as KB_CLAIM_LEDGER_DIR, o as isSafeKnowledgePath, on as claimSourceHost, ot as MemoryKbStore, p as isKnowledgeToolChain, pn as normalizeClaimText, pt as assertKnowledgeCitationAudit, q as writeKnowledgeIndex, qn as writeFileDurableWithinRoot, qt as ResearchClaimLedgerSchema, r as stringMetadata, rn as assertTrackedClaimIntegrity, rt as KB_EVENTS_PATH, s as parseKnowledgeWriteBlocks, sn as deepQuestionId, st as assertClaimLedgerId, t as explainKnowledgeTarget, tn as assertResearchClaimEvidenceIntegrity, tt as FileSystemKbStore, u as RUN_LINEAGE_BASENAME, un as materializeRegisteredClaimEvidence, ut as KnowledgeCitationAuditError, v as assertSchemaVersion, vn as inspectPendingKnowledgeMutation, vt as formatKnowledgeCitationReference, w as knowledgeVisibilityArtifactRef, wn as applyKnowledgeFileTransaction, wt as SCAFFOLD_PAGE_BASENAMES, x as digest, xn as runInKnowledgeMutationScope, xt as resolveKnowledgeCitations, y as createKnowledgeVisibilitySnapshot, yn as isKnowledgeMutationHeld, yt as parseKnowledgeCitationReference, z as UncheckableClaimError, zn as readRegularFileWithinRoot, zt as KnowledgeGraphNodeSchema } from "./inspect-CwIvMcno.js";
 import { i as textSourceId, n as slugify, r as stableId, t as sha256 } from "./ids-Bevz_pXV.js";
-import { A as runSerializedKnowledgeOptimization, C as deterministicRng, D as toOffPolicyTrajectory, E as retrievalHoldoutConfigHash, M as assertImmutableRef, O as jsonCandidateCodec, S as applySessionStickyRetrievalHoldout, T as resetRetrievalHoldoutRegistry, _ as createAgentMemoryBranch, a as createNeo4jAgentMemoryAdapter, b as renderMemoryContext, c as runAgentMemoryImprovement, d as compareAgentMemoryLearning, f as runAgentMemoryLearningExperiment, g as buildAgentMemorySequencesFromBenchmarkCases, h as buildAgentMemorySequenceScenarios, i as AgentMemoryWriteInputSchema, j as scenarioContentFingerprint, k as jsonObjectCandidateCodec, l as createGraphitiMemoryAdapter, m as agentMemorySequenceJudge, n as AgentMemoryKindSchema, o as createMem0MemoryAdapter, p as runAgentMemoryExperiment, r as AgentMemoryScopeSchema, s as mem0MemoryAdapterIdentity, t as AgentMemoryHitSchema, u as graphitiMemoryAdapterIdentity, v as forkAgentMemoryBranchSnapshot, w as emitRetrievalHoldoutBypass, x as applyRetrievalHoldout, y as defaultGetMemoryContext } from "./memory-BYWNir2t.js";
+import { A as retrievalHoldoutConfigHash, C as defaultGetMemoryContext, D as deterministicRng, E as applySessionStickyRetrievalHoldout, F as scenarioContentFingerprint, I as assertImmutableRef, M as jsonCandidateCodec, N as jsonObjectCandidateCodec, O as emitRetrievalHoldoutBypass, P as runSerializedKnowledgeOptimization, S as forkAgentMemoryBranchSnapshot, T as applyRetrievalHoldout, _ as runAgentMemoryExperiment, a as runAgentMemoryImprovement, b as buildAgentMemorySequencesFromBenchmarkCases, c as hindsightMemoryBankId, d as AgentMemoryScopeSchema, f as AgentMemoryWriteInputSchema, g as runAgentMemoryLearningExperiment, h as compareAgentMemoryLearning, i as mem0MemoryAdapterIdentity, j as toOffPolicyTrajectory, k as resetRetrievalHoldoutRegistry, l as AgentMemoryHitSchema, m as graphitiMemoryAdapterIdentity, n as createNeo4jAgentMemoryAdapter, o as HindsightOperationUnknownError, p as createGraphitiMemoryAdapter, r as createMem0MemoryAdapter, s as createHindsightMemoryAdapter, t as createPlayMemoryTools, u as AgentMemoryKindSchema, v as agentMemorySequenceJudge, w as renderMemoryContext, x as createAgentMemoryBranch, y as buildAgentMemorySequenceScenarios } from "./memory-PlYkyv8x.js";
 import { C as sleepForMemoryRecovery, F as buildIndustryRagBenchmarkSmokeCases, G as buildRetrievalEvalDispatch, H as createNoopMemoryBenchmarkAdapter, I as respondToIndustryMemoryBenchmarkSmokeCase, J as retrievalConfigSurface, K as partitionRetrievalScenarios, L as respondToIndustryRagBenchmarkSmokeCase, M as INDUSTRY_RAG_BENCHMARKS, N as buildFirstPartyMemoryLifecycleBenchmarkCases, P as buildIndustryMemoryBenchmarkSmokeCases, R as isKnowledgeMemoryBenchmarkCase, S as runBoundedMemoryLifecycle, U as memoryHitToSourceRecord, V as createInMemoryBenchmarkAdapter, W as memoryWriteResultToSourceRecord, X as scoreRetrievalArtifact, Y as retrievalRecallJudge, Z as mean, a as buildKnowledgeBenchmarkScenarios, b as memoryRecoveryDelayMs, c as runKnowledgeBenchmarkSuite, d as summarizeKnowledgeBenchmarkCampaign, f as acquireAgentMemoryRunLease, h as DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, i as runMemoryAdapterBenchmark, j as INDUSTRY_MEMORY_BENCHMARKS, l as scoreKnowledgeBenchmarkArtifact, m as AgentMemoryLifecycleUnsafeError, n as parseKnowledgeBenchmarkJsonl, o as knowledgeBenchmarkJudge, p as AgentMemoryLifecycleTimeoutError, q as retrievalConfigFromSurface, r as parseKnowledgeBenchmarkQrels, s as renderKnowledgeBenchmarkReportMarkdown, t as buildRetrievalBenchmarkCasesFromQrels, u as scoreMemoryBenchmarkArtifact, x as resolveMemoryCleanupTimeoutMs, y as createMemoryExecutionPool } from "./benchmarks-B3kU-Yxz.js";
 import { a as buildKnowledgeLexicalIndex, c as tokenizeText, i as searchKnowledgePages, n as reciprocalRankFusion, o as scoreBm25, r as searchKnowledge, s as tokenizeQuery, t as KNOWLEDGE_SEARCH_RETRIEVER_ID } from "./search-Cbyj2shJ.js";
 import { IRS_DIMENSION_HINTS, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, POLITE_USER_AGENT, __resetHttpThrottle, createCornellLiiSource, createIrsPublicationsSource, createStateSosSource, extractLinks, firstMatch, htmlToText, innerHtmlById, looksLikeBlockPage, politeFetch } from "./sources/index.js";
@@ -5969,12 +5969,11 @@ const DEFAULT_KNOWLEDGE_BRIEF_LIMIT = 5;
 * and rendering are deterministic, and no field carries a timestamp.
 */
 function buildKnowledgeBrief(visiblePages, question, options = {}) {
+	return prepareKnowledgeBrief(visiblePages)(question, options);
+}
+/** Internal prepared view, shared by tools only while their immutable page view is current. */
+function prepareKnowledgeBrief(visiblePages) {
 	if (!Array.isArray(visiblePages)) throw new TypeError("knowledge brief requires the visible pages");
-	if (typeof question !== "string" || question.trim().length === 0) throw new TypeError("knowledge brief question must be a non-empty string");
-	const limit = options.limit ?? 5;
-	const excludeInvalidated = options.excludeInvalidated ?? true;
-	const maxChars = options.maxChars;
-	if (maxChars !== void 0 && (!Number.isInteger(maxChars) || maxChars < 0)) throw new Error(`knowledge brief maxChars must be a non-negative integer, got ${maxChars}`);
 	const byId = /* @__PURE__ */ new Map();
 	for (const entry of visiblePages) {
 		const matches = byId.get(entry.page.id) ?? [];
@@ -6004,52 +6003,61 @@ function buildKnowledgeBrief(visiblePages, question, options = {}) {
 		originals.set(page, entry);
 		return page;
 	});
-	const ranked = searchKnowledgePages(pages, question, {
-		limit,
-		excludeInvalidated,
-		...options.tags === void 0 ? {} : { tags: options.tags },
-		...options.kinds === void 0 ? {} : { kinds: options.kinds }
-	}).map((hit) => {
-		const entry = originals.get(hit.page);
-		const candidates = byId.get(entry.page.id);
-		const reference = {
-			pageId: entry.page.id,
-			...candidates.length === 1 && formatKnowledgeCitationReference({ pageId: entry.page.id }) === entry.page.id ? {} : { origin: entry.origin }
-		};
-		assertKnowledgeCitationsResolved(candidates, [reference]);
-		return {
-			...hit,
-			page: entry.page,
-			origin: entry.origin,
-			citationId: formatKnowledgeCitationReference(reference)
-		};
-	});
-	const hits = [];
-	const lines = [];
-	let length = 0;
-	for (const hit of ranked) {
-		const line = briefLine(hit);
-		const next = length === 0 ? line.length : length + 1 + line.length;
-		if (maxChars !== void 0 && next > maxChars) break;
-		hits.push(hit);
-		lines.push(line);
-		length = next;
-	}
-	return Object.freeze({
-		question: question.trim(),
-		retrieverId: KNOWLEDGE_SEARCH_RETRIEVER_ID,
-		retrieverConfigDigest: canonicalCandidateDigest({
+	const lexicalIndex = buildKnowledgeLexicalIndex(pages);
+	return (question, options = {}) => {
+		if (typeof question !== "string" || question.trim().length === 0) throw new TypeError("knowledge brief question must be a non-empty string");
+		const limit = options.limit ?? 5;
+		const excludeInvalidated = options.excludeInvalidated ?? true;
+		const maxChars = options.maxChars;
+		if (maxChars !== void 0 && (!Number.isInteger(maxChars) || maxChars < 0)) throw new Error(`knowledge brief maxChars must be a non-negative integer, got ${maxChars}`);
+		const ranked = searchKnowledgePages(pages, question, {
+			lexicalIndex,
 			limit,
 			excludeInvalidated,
-			tags: options.tags === void 0 ? null : [...options.tags],
-			kinds: options.kinds === void 0 ? null : [...options.kinds],
-			maxChars: maxChars ?? null
-		}),
-		hits: Object.freeze(hits),
-		citationIds: Object.freeze(hits.map((hit) => hit.citationId)),
-		results: Object.freeze(hits.map((hit) => Object.freeze(hit))),
-		text: lines.join("\n")
-	});
+			...options.tags === void 0 ? {} : { tags: options.tags },
+			...options.kinds === void 0 ? {} : { kinds: options.kinds }
+		}).map((hit) => {
+			const entry = originals.get(hit.page);
+			const candidates = byId.get(entry.page.id);
+			const reference = {
+				pageId: entry.page.id,
+				...candidates.length === 1 && formatKnowledgeCitationReference({ pageId: entry.page.id }) === entry.page.id ? {} : { origin: entry.origin }
+			};
+			assertKnowledgeCitationsResolved(candidates, [reference]);
+			return {
+				...hit,
+				page: entry.page,
+				origin: entry.origin,
+				citationId: formatKnowledgeCitationReference(reference)
+			};
+		});
+		const hits = [];
+		const lines = [];
+		let length = 0;
+		for (const hit of ranked) {
+			const line = briefLine(hit);
+			const next = length === 0 ? line.length : length + 1 + line.length;
+			if (maxChars !== void 0 && next > maxChars) break;
+			hits.push(hit);
+			lines.push(line);
+			length = next;
+		}
+		return Object.freeze({
+			question: question.trim(),
+			retrieverId: KNOWLEDGE_SEARCH_RETRIEVER_ID,
+			retrieverConfigDigest: canonicalCandidateDigest({
+				limit,
+				excludeInvalidated,
+				tags: options.tags === void 0 ? null : [...options.tags],
+				kinds: options.kinds === void 0 ? null : [...options.kinds],
+				maxChars: maxChars ?? null
+			}),
+			hits: Object.freeze(hits),
+			citationIds: Object.freeze(hits.map((hit) => hit.citationId)),
+			results: Object.freeze(hits.map((hit) => Object.freeze(hit))),
+			text: lines.join("\n")
+		});
+	};
 }
 function briefLine(hit) {
 	const snippet = hit.snippet.replace(/\s+/g, " ").trim();
@@ -6515,6 +6523,20 @@ function isoTimestamp(value, label) {
 * Every search mints a retrieval receipt. Configured receipt capture also
 * persists the exact visibility snapshot before delivering the receipt.
 */
+const preparedViews = /* @__PURE__ */ new WeakMap();
+function prepareView(chain) {
+	const reusable = isKnowledgeToolChain(chain);
+	const previous = reusable ? preparedViews.get(chain) : void 0;
+	if (previous) return previous;
+	const visibility = createKnowledgeVisibilitySnapshot(chain);
+	const prepared = {
+		brief: prepareKnowledgeBrief(chain),
+		visibility,
+		bytes: encodeKnowledgeVisibilitySnapshot(visibility)
+	};
+	if (reusable) preparedViews.set(chain, prepared);
+	return prepared;
+}
 const searchInput = z.object({
 	question: z.string().min(1),
 	limit: z.int().min(1).max(50).optional(),
@@ -6541,16 +6563,16 @@ function createKnowledgeTools(options) {
 	const pagesDirectory = normalizePagesDirectory(options.pagesDirectory);
 	return [
 		tool("knowledge_search", "Search visible knowledge with unambiguous citation handles. Optionally include refuted history or filter tags and kinds.", searchInput, async (input) => {
-			const chain = await stores.loadChain(runId);
-			const brief = buildKnowledgeBrief(chain, input.question, {
+			const prepared = prepareView(await loadKnowledgeToolChain(stores, runId));
+			const brief = prepared.brief(input.question, {
 				...options.brief,
 				...input.limit === void 0 ? {} : { limit: input.limit },
 				...input.excludeInvalidated === void 0 ? {} : { excludeInvalidated: input.excludeInvalidated },
 				...input.tags === void 0 ? {} : { tags: input.tags },
 				...input.kinds === void 0 ? {} : { kinds: input.kinds }
 			});
-			const visibility = createKnowledgeVisibilitySnapshot(chain);
-			const visibilityArtifact = options.recordRetrieval ? await persistVisibility(stores.storePath(runId), visibility) : void 0;
+			const visibility = prepared.visibility;
+			const visibilityArtifact = options.recordRetrieval ? await persistVisibility(stores.storePath(runId), visibility, prepared.bytes) : void 0;
 			const receipt = createKnowledgeRetrievalReceipt({
 				runId,
 				...options.actorId === void 0 ? {} : { actorId: options.actorId },
@@ -6574,7 +6596,7 @@ function createKnowledgeTools(options) {
 			};
 		}),
 		tool("knowledge_read", "Read one page by its id, optionally qualified with here::, shared:: or inherited:<runId>::.", readInput, async (input) => {
-			const resolution = resolveKnowledgeCitation(await stores.loadChain(runId), parseKnowledgeCitationReference(input.pageId));
+			const resolution = resolveKnowledgeCitation(await loadKnowledgeToolChain(stores, runId), parseKnowledgeCitationReference(input.pageId));
 			return {
 				status: resolution.status,
 				page: resolution.resolved === void 0 ? null : {
@@ -6608,7 +6630,7 @@ function createKnowledgeTools(options) {
 				} }
 			});
 		}),
-		tool("knowledge_resolve", "Resolve page ids against everything this run can see, without hiding an ambiguity.", resolveInput, async (input) => ({ resolutions: (await resolveRunScopedCitations(stores, runId, input.references.map((reference) => parseKnowledgeCitationReference(reference)))).map((resolution) => ({
+		tool("knowledge_resolve", "Resolve page ids against everything this run can see, without hiding an ambiguity.", resolveInput, async (input) => ({ resolutions: resolveKnowledgeCitations(await loadKnowledgeToolChain(stores, runId), input.references.map((reference) => parseKnowledgeCitationReference(reference))).map((resolution) => ({
 			pageId: resolution.reference.pageId,
 			...resolution.reference.origin === void 0 ? {} : { origin: resolution.reference.origin },
 			status: resolution.status,
@@ -6634,17 +6656,19 @@ function tool(name, description, inputSchema, handler) {
 	};
 }
 /** Snapshot artifacts are immutable evidence, separate from authoritative KB state. */
-async function persistVisibility(root, snapshot) {
-	const bytes = encodeKnowledgeVisibilitySnapshot(snapshot);
+async function persistVisibility(root, snapshot, bytes) {
 	const path = `.agent-knowledge/retrieval-visibility/${snapshot.snapshotDigest.replace("sha256:", "")}.json`;
-	await withKnowledgeMutation(root, async () => {
+	const matches = async () => {
 		try {
-			const existing = await readRegularFileWithinRoot(root, path);
-			if (!Buffer.from(existing.bytes).equals(Buffer.from(bytes))) throw new Error("stored knowledge visibility artifact does not match its content identity");
+			if (!(await readRegularFileWithinRoot(root, path)).bytes.equals(bytes)) throw new Error("stored knowledge visibility artifact does not match its content identity");
+			return true;
 		} catch (error) {
 			if (!isMissingFile(error)) throw error;
-			await writeFileDurableWithinRoot(root, path, Buffer.from(bytes));
+			return false;
 		}
+	};
+	if (!await matches()) await withKnowledgeMutation(root, async () => {
+		if (!await matches()) await writeFileDurableWithinRoot(root, path, Buffer.from(bytes));
 	});
 	return knowledgeVisibilityArtifactRef({
 		uri: pathToFileURL(join(root, path)).href,
@@ -7074,6 +7098,186 @@ function humanize(slug) {
 	return slug.split("-").filter(Boolean).map((w) => w[0]?.toUpperCase() + w.slice(1)).join(" ") || slug;
 }
 //#endregion
+//#region src/qmd-search-provider.ts
+const indexedDocument = z.object({
+	filepath: z.string(),
+	collectionName: z.string(),
+	body: z.string()
+});
+const searchResults = z.array(z.object({
+	filepath: z.string(),
+	score: z.number().finite()
+}));
+const querySchema = z.object({
+	query: z.string().trim().min(1).max(16e3),
+	limit: z.number().int().min(1).max(50).default(5)
+}).strict();
+const readSchema = z.object({
+	sourceId: z.string().min(1),
+	fromLine: z.number().int().min(1).default(1),
+	maxLines: z.number().int().min(1).max(200).default(80)
+}).strict();
+/**
+* A fixed source snapshot, not an authorization decision. The trusted host supplies
+* one authorized corpus; agents cannot select a collection, bank, or arbitrary path.
+* QMD's index is derived: its bytes must agree with the authoritative source hash.
+*/
+function createQmdSearchProvider(options) {
+	const { client } = options;
+	const scopeId = z.string().trim().min(1).parse(options.scopeId);
+	const revision = z.string().trim().min(1).parse(options.revision);
+	const collection = z.string().regex(/^[a-zA-Z0-9_-]+$/).parse(options.collection);
+	const mode = z.enum(["lexical", "vector"]).parse(options.mode ?? "lexical");
+	const indexedAt = options.indexedAt === void 0 ? null : z.iso.datetime({ offset: true }).parse(options.indexedAt);
+	if (mode === "vector" && !client.searchVector) throw new Error("QMD vector search is unavailable");
+	const byId = /* @__PURE__ */ new Map();
+	const byPath = /* @__PURE__ */ new Map();
+	for (const entry of options.documents) {
+		const source = SourceRecordSchema.parse(structuredClone(entry.source));
+		if (!/^[a-f0-9]{64}$/.test(source.contentHash)) throw new TypeError("QMD sources require an exact SHA-256 contentHash");
+		if (source.text !== void 0 && sha256(source.text) !== source.contentHash) throw new Error("QMD source text does not match its contentHash");
+		const prefix = `qmd://${collection}/`;
+		const path = entry.qmdPath.slice(prefix.length);
+		if (!entry.qmdPath.startsWith(prefix) || !path || path.split("/").some((part) => !part || part === "." || part === ".." || /[\\?#%]/.test(part) || [...part].some((char) => char.charCodeAt(0) < 32))) throw new TypeError("QMD document path must be within the bound collection");
+		if (byId.has(source.id) || byPath.has(entry.qmdPath)) throw new Error("QMD snapshot contains duplicate source ids or paths");
+		const document = {
+			qmdPath: entry.qmdPath,
+			source
+		};
+		byId.set(source.id, document);
+		byPath.set(entry.qmdPath, document);
+	}
+	const snapshotDigest = canonicalCandidateDigest({
+		scopeId,
+		revision,
+		collection,
+		documents: [...byPath.values()].map(({ qmdPath, source }) => ({
+			qmdPath,
+			id: source.id,
+			uri: source.uri,
+			contentHash: source.contentHash
+		})).sort((a, b) => a.qmdPath < b.qmdPath ? -1 : a.qmdPath > b.qmdPath ? 1 : 0)
+	});
+	const identity = Object.freeze({
+		scopeId,
+		revision,
+		snapshotDigest,
+		indexedAt,
+		mode,
+		documentCount: byId.size
+	});
+	const verifiedRead = async (document) => {
+		const parsed = indexedDocument.safeParse(await client.get(document.qmdPath, { includeBody: true }));
+		if (!parsed.success) throw new Error("QMD snapshot document is unavailable or malformed; rebuild the scoped index");
+		const indexed = parsed.data;
+		if (indexed.filepath !== document.qmdPath || indexed.collectionName !== collection) throw new Error("QMD returned a document outside the bound snapshot");
+		if (sha256(indexed.body) !== document.source.contentHash) throw new Error("QMD index is stale for this source revision; rebuild the scoped index");
+		return {
+			qmdPath: document.qmdPath,
+			source: {
+				...structuredClone(document.source),
+				text: indexed.body
+			}
+		};
+	};
+	return {
+		...identity,
+		/** Call once at admission; ordinary reads still verify their returned bytes. */
+		async verifySnapshot() {
+			for (const document of byPath.values()) await verifiedRead(document);
+			return {
+				...identity,
+				verifiedDocumentCount: byPath.size,
+				checkedAt: (/* @__PURE__ */ new Date()).toISOString()
+			};
+		},
+		async search(query, searchOptions = {}) {
+			const request = querySchema.parse({
+				query,
+				...searchOptions
+			});
+			const search = mode === "vector" ? client.searchVector : client.searchLex;
+			const results = searchResults.parse(await search.call(client, request.query, {
+				collection,
+				limit: request.limit
+			}));
+			const seen = /* @__PURE__ */ new Set();
+			for (const hit of results) {
+				if (!byPath.has(hit.filepath)) throw new Error("QMD returned a search result outside the bound snapshot");
+				if (seen.has(hit.filepath)) throw new Error("QMD returned duplicate search results");
+				seen.add(hit.filepath);
+			}
+			const hits = await Promise.all(results.slice(0, request.limit).map(async (hit) => ({
+				...await verifiedRead(byPath.get(hit.filepath)),
+				score: hit.score
+			})));
+			return {
+				...identity,
+				hits
+			};
+		},
+		async read(sourceId) {
+			const document = byId.get(sourceId);
+			if (!document) throw new Error("Source is not in the bound QMD snapshot");
+			return {
+				...identity,
+				document: await verifiedRead(document)
+			};
+		}
+	};
+}
+/** Same source-checked functions used by a human reader and exact-profile tool grants. */
+function createQmdKnowledgeTools(options) {
+	const prefix = options.namePrefix ?? "";
+	if (!/^[a-zA-Z0-9_]*$/.test(prefix)) throw new TypeError("Invalid QMD tool name prefix");
+	return [{
+		name: `${prefix}qmd_search`,
+		description: "Search this bound source snapshot. Results carry original source ids, URIs and hashes; use qmd_read for full source lines.",
+		inputSchema: querySchema,
+		inputSchemaJson: z.toJSONSchema(querySchema),
+		async handler(input) {
+			const request = querySchema.parse(input);
+			const result = await options.provider.search(request.query, { limit: request.limit });
+			return {
+				...result,
+				hits: result.hits.map(({ source, ...hit }) => {
+					const { text, ...reference } = source;
+					return {
+						...hit,
+						source: reference,
+						excerpt: text?.slice(0, 2e3),
+						excerptTruncated: (text?.length ?? 0) > 2e3
+					};
+				})
+			};
+		}
+	}, {
+		name: `${prefix}qmd_read`,
+		description: "Read exact source lines by a source id returned from this snapshot. Other play sources are unavailable.",
+		inputSchema: readSchema,
+		inputSchemaJson: z.toJSONSchema(readSchema),
+		async handler(input) {
+			const request = readSchema.parse(input);
+			const result = await options.provider.read(request.sourceId);
+			const { text = "", ...source } = result.document.source;
+			const lines = text.split("\n");
+			const selected = lines.slice(request.fromLine - 1, request.fromLine - 1 + request.maxLines);
+			const rendered = selected.map((line, index) => `${request.fromLine + index}: ${line}`).join("\n");
+			return {
+				...result,
+				document: {
+					...result.document,
+					source,
+					text: rendered.slice(0, 32e3),
+					fromLine: request.fromLine,
+					totalLines: lines.length,
+					truncated: rendered.length > 32e3 || request.fromLine - 1 + selected.length < lines.length
+				}
+			};
+		}
+	}];
+}
+//#endregion
 //#region src/readiness-check.ts
 async function evaluateKnowledgeBaseReadiness(options) {
 	const index = await buildKnowledgeIndex(options.root);
@@ -8041,6 +8245,6 @@ function buildSteerText(gaps, deepQuestions, invalidationTargets, minIndependent
 	return lines.join("\n");
 }
 //#endregion
-export { AgentMemoryHitSchema, AgentMemoryKindSchema, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, AgentMemoryScopeSchema, AgentMemoryWriteInputSchema, CHECKABLE_RUNG_THRESHOLD, CITES_INVALIDATED_FIELD, ClaimLedgerGoalConflictError, ClaimLedgerMigrationRequiredError, DEADLINE_EXIT_CODE, DEFAULT_KNOWLEDGE_BRIEF_LIMIT, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, DEFAULT_PAGES_DIRECTORY, DeepQuestionSchema, FileSystemKbStore, FileSystemSearchProvider, INDUSTRY_MEMORY_BENCHMARKS, INDUSTRY_RAG_BENCHMARKS, IRS_DIMENSION_HINTS, KB_CLAIM_LEDGER_DIR, KB_EVENTS_PATH, KB_INDEX_PATH, KB_STORE_DIR, KNOWLEDGE_EVENT_TYPES, KNOWLEDGE_PROMOTIONS_DIRECTORY, KNOWLEDGE_PROMOTION_DIGEST_ALGORITHM, KNOWLEDGE_PROMOTION_SCHEMA_VERSION, KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, KNOWLEDGE_SEARCH_RETRIEVER_ID, KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, KnowledgeBaseCandidateSchema, KnowledgeCitationAuditError, KnowledgeCitationResolutionError, KnowledgeDuplicateIntakeError, KnowledgeEventSchema, KnowledgeGraphEdgeSchema, KnowledgeGraphNodeSchema, KnowledgeImprovementCandidateRefSchema, KnowledgeImprovementEvidenceSchema, KnowledgeImprovementRunStateSchema, KnowledgeIndexSchema, KnowledgePageInvalidationSchema, KnowledgePageSchema, KnowledgePromotionError, KnowledgeProposalParseError, KnowledgeRelationGraphError, KnowledgeRelationGraphSchema, KnowledgeRelationNodeSchema, KnowledgeRelationSchema, KnowledgeVisibilityUnavailableError, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, MemoryKbStore, POLITE_USER_AGENT, READINESS_SPEC_DEFAULTS, RUN_LINEAGE_BASENAME, ResearchClaimEvidenceSchema, ResearchClaimLedgerSchema, ResearchClaimRecordSchema, ResearchSourceVersionSchema, RouterError, SCAFFOLD_PAGE_BASENAMES, SourceAnchorSchema, SourceRecordSchema, UncheckableClaimError, WIKILINK_REGEX, __resetHttpThrottle, acquireAgentMemoryRunLease, addSourcePath, addSourceText, agentMemorySequenceJudge, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, assertClaimLedgerId, assertCurrentRunCitationsResolved, assertDeepQuestionIntegrity, assertGradeableEvidence, assertKnowledgeCitationAudit, assertKnowledgeCitationsResolved, assertKnowledgeRetrievalMatchesVisibility, assertKnowledgeRetrievalMatchesVisibilityArtifact, assertKnowledgeWriteIntake, assertResearchClaimEvidenceIntegrity, assertResearchClaimLedgerIntegrity, assertRunScopedCitationsResolved, assertTrackedClaimIntegrity, auditCurrentRunCitations, auditKnowledgeCitations, buildAgentMemorySequenceScenarios, buildAgentMemorySequencesFromBenchmarkCases, buildEvalKnowledgeBundle, buildFirstPartyMemoryLifecycleBenchmarkCases, buildIndustryMemoryBenchmarkSmokeCases, buildIndustryRagBenchmarkSmokeCases, buildKnowledgeBenchmarkScenarios, buildKnowledgeBrief, buildKnowledgeGraph, buildKnowledgeIndex, buildKnowledgeLexicalIndex, buildKnowledgeRelationGraph, buildRetrievalBenchmarkCasesFromQrels, buildRetrievalEvalDispatch, calibrateRagAnswerJudge, canonicalPathsEqual, canonicalRelativeWithinRoot, canonicalizeUrl, chunkMarkdown, citedClaimKey, citedClaimOf, claimCheckKey, claimEvidenceId, claimId, claimSourceHost, compareAgentMemoryLearning, contentKey, createAdaptiveResearchDriver, createAgentMemoryBranch, createClaimDecorator, createClaimGroundingVerifier, createCollectionResearchDriver, createCornellLiiSource, createD1FreshnessStoreStub, createFileRunLineageAuthority, createFileSystemFreshnessStore, createFileSystemSearchProvider, createGraphitiMemoryAdapter, createInMemoryBenchmarkAdapter, createIrsPublicationsSource, createKnowledgeControlLoopAdapter, createKnowledgeEvent, createKnowledgeRetrievalDisposition, createKnowledgeRetrievalReceipt, createKnowledgeTools, createKnowledgeUseReceipt, createKnowledgeVisibilitySnapshot, createLocalDiscoveryDispatcher, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, createNoopMemoryBenchmarkAdapter, createPersistentResearchDrivingDriver, createRagAnswerQualityHook, createResearchDrivingDriver, createRunScopedStores, createStateSosSource, createTangleRouterClient, createVerifyingResearchDriver, createWebResearchWorker, decodeKnowledgeVisibilitySnapshot, deepQuestionId, defaultGetMemoryContext, defineReadinessSpec, detectChanges, detectNearDuplicatePages, deterministicRng, diagnoseRagAnswerFailure, emitRetrievalHoldoutBypass, emptyClaimLedger, encodeKnowledgeVisibilitySnapshot, evaluateKnowledgeBaseReadiness, explainKnowledgeTarget, extractLinks, extractWikilinks, firstMatch, forkAgentMemoryBranchSnapshot, formatFrontmatter, formatKnowledgeCitationReference, formatKnowledgeInvalidationProposal, fromAgentCandidateKnowledgeRef, gradeClaims, gradeCompanyAgainstText, gradeFactAgainstText, gradeFor, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, htmlToText, improveKnowledgeBase, improveSelectedKnowledgeCandidate, initKnowledgeBase, innerHtmlById, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, investmentThesisSet, isKernelAnchoredPath, isKnowledgeMemoryBenchmarkCase, isKnowledgeMutationHeld, isKnowledgePagePath, isMissingFile, isReachable, isSafeKnowledgePath, isScaffoldPath, jsonCandidateCodec, jsonObjectCandidateCodec, kbIndexToText, knowledgeBenchmarkJudge, knowledgeCitationAuditFindings, knowledgeImprovementCandidateRef, knowledgeImprovementRunDir, knowledgeImprovementRunId, knowledgePageDigest, knowledgePageFromMarkdown, knowledgePageRelations, knowledgeReleaseReport, knowledgeVisibilityArtifactRef, layoutFor, lensDistribution, linkClaimContradictions, lintCurrentRunCitations, lintKnowledgeIndex, listRegularFilesWithinRoot, loadKnowledgeImprovementActivationResult, loadKnowledgeImprovementEvents, loadKnowledgeImprovementState, loadKnowledgePages, loadKnowledgePromotionRecord, loadSourceRegistry, looksLikeBlockPage, materialFactsSurfaced, materialFactsSurfacedInText, materializeRegisteredClaimEvidence, mediaTypeFor, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, mergeClaimLedgers, mergeTrackedClaims, neighbors, normalizeClaimText, normalizeExternalRagScores, normalizeKnowledgeStateScope, normalizeLinkTarget, normalizePageText, normalizePagesDirectory, optimizeKnowledgeBasePolicy, originatedPages, parseFrontmatter, parseKnowledgeBenchmarkJsonl, parseKnowledgeBenchmarkQrels, parseKnowledgeCitationReference, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, planInvalidationPropagation, politeFetch, promoteKnowledgeCandidate, promoteRunScopedPages, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, relativeWithinRoot, removeDurable, renameDurable, renderKnowledgeBenchmarkReportMarkdown, renderMemoryContext, researchSourceVersionKey, resetRetrievalHoldoutRegistry, resolveKnowledgeCitation, resolveKnowledgeCitations, resolveMemoryCleanupTimeoutMs, resolveRunScopedCitation, resolveRunScopedCitations, respondToIndustryMemoryBenchmarkSmokeCase, respondToIndustryRagBenchmarkSmokeCase, restoreKnowledgeCandidateBaseline, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runAgentMemoryExperiment, runAgentMemoryImprovement, runAgentMemoryLearningExperiment, runBoundedMemoryLifecycle, runDiscoveryLoop, runInKnowledgeMutationScope, runInvestmentThesisTask, runKnowledgeBenchmarkSuite, runKnowledgeResearchLoop, runMemoryAdapterBenchmark, runRagKnowledgeImprovementLoop, runRagOptimization, runRetrievalImprovementLoop, runSerializedKnowledgeOptimization, runVerifiedResearchLoop, scenarioContentFingerprint, scoreBm25, scoreKnowledgeBaseIndex, scoreKnowledgeBenchmarkArtifact, scoreMemoryBenchmarkArtifact, scoreRagAnswerArtifact, scoreRetrievalArtifact, searchKnowledge, searchKnowledgePages, sha256, sleepForMemoryRecovery, slugify, snapshotSourceTextInput, sourceMatchesGaps, sourceRegistryPath, stableId, stripFrontmatter, summarizeKnowledgeBenchmarkCampaign, syncDirectory, textSourceAdapter, textSourceId, thesisReadinessSpecs, toAgentCandidateKnowledgeRef, toDeepEvalTestCases, toOffPolicyTrajectory, toRagCheckerRecords, toRagasEvaluationRows, toTruLensRecords, tokenizeQuery, tokenizeText, totalMaterialFacts, triageSource, validateKnowledgeIndex, verdictFor, verifyGradeableEvidence, verifyKnowledgeRetrievalDisposition, verifyKnowledgeRetrievalReceipt, verifyKnowledgeUseReceipt, verifyKnowledgeVisibilitySnapshot, walk, withCitedClaim, withKnowledgeImprovementCandidate, withKnowledgeImprovementComparison, withKnowledgeMutation, withKnowledgeRead, withSafeDescendant, withSafeDirectory, writeFileDurable, writeFileDurableWithinRoot, writeJson, writeJsonDurable, writeJsonDurableWithinRoot, writeKnowledgeIndex, writeSourceRegistry };
+export { AgentMemoryHitSchema, AgentMemoryKindSchema, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, AgentMemoryScopeSchema, AgentMemoryWriteInputSchema, CHECKABLE_RUNG_THRESHOLD, CITES_INVALIDATED_FIELD, ClaimLedgerGoalConflictError, ClaimLedgerMigrationRequiredError, DEADLINE_EXIT_CODE, DEFAULT_KNOWLEDGE_BRIEF_LIMIT, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, DEFAULT_PAGES_DIRECTORY, DeepQuestionSchema, FileSystemKbStore, FileSystemSearchProvider, HindsightOperationUnknownError, INDUSTRY_MEMORY_BENCHMARKS, INDUSTRY_RAG_BENCHMARKS, IRS_DIMENSION_HINTS, KB_CLAIM_LEDGER_DIR, KB_EVENTS_PATH, KB_INDEX_PATH, KB_STORE_DIR, KNOWLEDGE_EVENT_TYPES, KNOWLEDGE_PROMOTIONS_DIRECTORY, KNOWLEDGE_PROMOTION_DIGEST_ALGORITHM, KNOWLEDGE_PROMOTION_SCHEMA_VERSION, KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, KNOWLEDGE_SEARCH_RETRIEVER_ID, KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, KnowledgeBaseCandidateSchema, KnowledgeCitationAuditError, KnowledgeCitationResolutionError, KnowledgeDuplicateIntakeError, KnowledgeEventSchema, KnowledgeGraphEdgeSchema, KnowledgeGraphNodeSchema, KnowledgeImprovementCandidateRefSchema, KnowledgeImprovementEvidenceSchema, KnowledgeImprovementRunStateSchema, KnowledgeIndexSchema, KnowledgePageInvalidationSchema, KnowledgePageSchema, KnowledgePromotionError, KnowledgeProposalParseError, KnowledgeRelationGraphError, KnowledgeRelationGraphSchema, KnowledgeRelationNodeSchema, KnowledgeRelationSchema, KnowledgeVisibilityUnavailableError, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, MemoryKbStore, POLITE_USER_AGENT, READINESS_SPEC_DEFAULTS, RUN_LINEAGE_BASENAME, ResearchClaimEvidenceSchema, ResearchClaimLedgerSchema, ResearchClaimRecordSchema, ResearchSourceVersionSchema, RouterError, SCAFFOLD_PAGE_BASENAMES, SourceAnchorSchema, SourceRecordSchema, UncheckableClaimError, WIKILINK_REGEX, __resetHttpThrottle, acquireAgentMemoryRunLease, addSourcePath, addSourceText, agentMemorySequenceJudge, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, assertClaimLedgerId, assertCurrentRunCitationsResolved, assertDeepQuestionIntegrity, assertGradeableEvidence, assertKnowledgeCitationAudit, assertKnowledgeCitationsResolved, assertKnowledgeRetrievalMatchesVisibility, assertKnowledgeRetrievalMatchesVisibilityArtifact, assertKnowledgeWriteIntake, assertResearchClaimEvidenceIntegrity, assertResearchClaimLedgerIntegrity, assertRunScopedCitationsResolved, assertTrackedClaimIntegrity, auditCurrentRunCitations, auditKnowledgeCitations, buildAgentMemorySequenceScenarios, buildAgentMemorySequencesFromBenchmarkCases, buildEvalKnowledgeBundle, buildFirstPartyMemoryLifecycleBenchmarkCases, buildIndustryMemoryBenchmarkSmokeCases, buildIndustryRagBenchmarkSmokeCases, buildKnowledgeBenchmarkScenarios, buildKnowledgeBrief, buildKnowledgeGraph, buildKnowledgeIndex, buildKnowledgeLexicalIndex, buildKnowledgeRelationGraph, buildRetrievalBenchmarkCasesFromQrels, buildRetrievalEvalDispatch, calibrateRagAnswerJudge, canonicalPathsEqual, canonicalRelativeWithinRoot, canonicalizeUrl, chunkMarkdown, citedClaimKey, citedClaimOf, claimCheckKey, claimEvidenceId, claimId, claimSourceHost, compareAgentMemoryLearning, contentKey, createAdaptiveResearchDriver, createAgentMemoryBranch, createClaimDecorator, createClaimGroundingVerifier, createCollectionResearchDriver, createCornellLiiSource, createD1FreshnessStoreStub, createFileRunLineageAuthority, createFileSystemFreshnessStore, createFileSystemSearchProvider, createGraphitiMemoryAdapter, createHindsightMemoryAdapter, createInMemoryBenchmarkAdapter, createIrsPublicationsSource, createKnowledgeControlLoopAdapter, createKnowledgeEvent, createKnowledgeRetrievalDisposition, createKnowledgeRetrievalReceipt, createKnowledgeTools, createKnowledgeUseReceipt, createKnowledgeVisibilitySnapshot, createLocalDiscoveryDispatcher, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, createNoopMemoryBenchmarkAdapter, createPersistentResearchDrivingDriver, createPlayMemoryTools, createQmdKnowledgeTools, createQmdSearchProvider, createRagAnswerQualityHook, createResearchDrivingDriver, createRunScopedStores, createStateSosSource, createTangleRouterClient, createVerifyingResearchDriver, createWebResearchWorker, decodeKnowledgeVisibilitySnapshot, deepQuestionId, defaultGetMemoryContext, defineReadinessSpec, detectChanges, detectNearDuplicatePages, deterministicRng, diagnoseRagAnswerFailure, emitRetrievalHoldoutBypass, emptyClaimLedger, encodeKnowledgeVisibilitySnapshot, evaluateKnowledgeBaseReadiness, explainKnowledgeTarget, extractLinks, extractWikilinks, firstMatch, forkAgentMemoryBranchSnapshot, formatFrontmatter, formatKnowledgeCitationReference, formatKnowledgeInvalidationProposal, fromAgentCandidateKnowledgeRef, gradeClaims, gradeCompanyAgainstText, gradeFactAgainstText, gradeFor, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, hindsightMemoryBankId, htmlToText, improveKnowledgeBase, improveSelectedKnowledgeCandidate, initKnowledgeBase, innerHtmlById, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, investmentThesisSet, isKernelAnchoredPath, isKnowledgeMemoryBenchmarkCase, isKnowledgeMutationHeld, isKnowledgePagePath, isMissingFile, isReachable, isSafeKnowledgePath, isScaffoldPath, jsonCandidateCodec, jsonObjectCandidateCodec, kbIndexToText, knowledgeBenchmarkJudge, knowledgeCitationAuditFindings, knowledgeImprovementCandidateRef, knowledgeImprovementRunDir, knowledgeImprovementRunId, knowledgePageDigest, knowledgePageFromMarkdown, knowledgePageRelations, knowledgeReleaseReport, knowledgeVisibilityArtifactRef, layoutFor, lensDistribution, linkClaimContradictions, lintCurrentRunCitations, lintKnowledgeIndex, listRegularFilesWithinRoot, loadKnowledgeImprovementActivationResult, loadKnowledgeImprovementEvents, loadKnowledgeImprovementState, loadKnowledgePages, loadKnowledgePromotionRecord, loadSourceRegistry, looksLikeBlockPage, materialFactsSurfaced, materialFactsSurfacedInText, materializeRegisteredClaimEvidence, mediaTypeFor, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, mergeClaimLedgers, mergeTrackedClaims, neighbors, normalizeClaimText, normalizeExternalRagScores, normalizeKnowledgeStateScope, normalizeLinkTarget, normalizePageText, normalizePagesDirectory, optimizeKnowledgeBasePolicy, originatedPages, parseFrontmatter, parseKnowledgeBenchmarkJsonl, parseKnowledgeBenchmarkQrels, parseKnowledgeCitationReference, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, planInvalidationPropagation, politeFetch, promoteKnowledgeCandidate, promoteRunScopedPages, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, relativeWithinRoot, removeDurable, renameDurable, renderKnowledgeBenchmarkReportMarkdown, renderMemoryContext, researchSourceVersionKey, resetRetrievalHoldoutRegistry, resolveKnowledgeCitation, resolveKnowledgeCitations, resolveMemoryCleanupTimeoutMs, resolveRunScopedCitation, resolveRunScopedCitations, respondToIndustryMemoryBenchmarkSmokeCase, respondToIndustryRagBenchmarkSmokeCase, restoreKnowledgeCandidateBaseline, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runAgentMemoryExperiment, runAgentMemoryImprovement, runAgentMemoryLearningExperiment, runBoundedMemoryLifecycle, runDiscoveryLoop, runInKnowledgeMutationScope, runInvestmentThesisTask, runKnowledgeBenchmarkSuite, runKnowledgeResearchLoop, runMemoryAdapterBenchmark, runRagKnowledgeImprovementLoop, runRagOptimization, runRetrievalImprovementLoop, runSerializedKnowledgeOptimization, runVerifiedResearchLoop, scenarioContentFingerprint, scoreBm25, scoreKnowledgeBaseIndex, scoreKnowledgeBenchmarkArtifact, scoreMemoryBenchmarkArtifact, scoreRagAnswerArtifact, scoreRetrievalArtifact, searchKnowledge, searchKnowledgePages, sha256, sleepForMemoryRecovery, slugify, snapshotSourceTextInput, sourceMatchesGaps, sourceRegistryPath, stableId, stripFrontmatter, summarizeKnowledgeBenchmarkCampaign, syncDirectory, textSourceAdapter, textSourceId, thesisReadinessSpecs, toAgentCandidateKnowledgeRef, toDeepEvalTestCases, toOffPolicyTrajectory, toRagCheckerRecords, toRagasEvaluationRows, toTruLensRecords, tokenizeQuery, tokenizeText, totalMaterialFacts, triageSource, validateKnowledgeIndex, verdictFor, verifyGradeableEvidence, verifyKnowledgeRetrievalDisposition, verifyKnowledgeRetrievalReceipt, verifyKnowledgeUseReceipt, verifyKnowledgeVisibilitySnapshot, walk, withCitedClaim, withKnowledgeImprovementCandidate, withKnowledgeImprovementComparison, withKnowledgeMutation, withKnowledgeRead, withSafeDescendant, withSafeDirectory, writeFileDurable, writeFileDurableWithinRoot, writeJson, writeJsonDurable, writeJsonDurableWithinRoot, writeKnowledgeIndex, writeSourceRegistry };
 
 //# sourceMappingURL=index.js.map