@tangle-network/agent-knowledge 6.2.0 → 7.0.0

package/dist/index.js

@@ -1,8 +1,8 @@
-import { $ as SCAFFOLD_PAGE_BASENAMES, A as KnowledgePageSchema, At as withSafeDirectory, B as assertResearchClaimLedgerIntegrity, C as assertClaimLedgerId, Ct as listRegularFilesWithinRoot, D as KnowledgeGraphEdgeSchema, Dt as renameDurable, E as KnowledgeEventSchema, Et as removeDurable, F as SourceRecordSchema, Ft as mediaTypeFor, G as deepQuestionId, H as claimEvidenceId, I as KNOWLEDGE_EVENT_TYPES, It as textSourceAdapter, J as materializeRegisteredClaimEvidence, K as emptyClaimLedger, L as ClaimLedgerGoalConflictError, M as ResearchClaimLedgerSchema, Mt as writeFileDurableWithinRoot, N as ResearchClaimRecordSchema, Nt as writeJsonDurable, O as KnowledgeGraphNodeSchema, Ot as syncDirectory, P as SourceAnchorSchema, Pt as writeJsonDurableWithinRoot, Q as buildKnowledgeGraph, R as assertDeepQuestionIntegrity, S as MemoryKbStore, St as isMissingFile, T as KnowledgeBaseCandidateSchema, Tt as readRegularFileWithinRoot, U as claimId, V as assertTrackedClaimIntegrity, W as claimSourceHost, X as mergeTrackedClaims, Y as mergeClaimLedgers, Z as normalizeClaimText, _ as FileSystemKbStore, _t as finishKnowledgeFileTransaction, a as applyKnowledgeWriteBlocksFile, at as WIKILINK_REGEX, b as KB_INDEX_PATH, bt as rollbackKnowledgeFileTransaction, c as validateKnowledgeIndex, ct as formatFrontmatter, d as writeKnowledgeIndex, dt as inspectPendingKnowledgeMutation, et as initKnowledgeBase, f as addSourcePath, ft as recoverPendingKnowledgeMutation, g as writeSourceRegistry, gt as assertKnowledgeMutationPath, h as sourceRegistryPath, ht as applyKnowledgeFileTransaction, i as applyKnowledgeWriteBlocks, it as writeJson, j as ResearchClaimEvidenceSchema, jt as writeFileDurable, k as KnowledgeIndexSchema, kt as withSafeDescendant, l as lintKnowledgeIndex, lt as parseFrontmatter, m as loadSourceRegistry, mt as withKnowledgeRead, n as inspectKnowledgeIndex, nt as layoutFor, o as isSafeKnowledgePath, ot as extractWikilinks, p as addSourceText, pt as withKnowledgeMutation, q as linkClaimContradictions, r as stringMetadata, rt as loadKnowledgePages, s as parseKnowledgeWriteBlocks, st as normalizeLinkTarget, t as explainKnowledgeTarget, tt as isScaffoldPath, u as buildKnowledgeIndex, ut as acquireDurableFileLock, v as KB_CLAIM_LEDGER_DIR, vt as knowledgeFileTransactionPlanHash, w as DeepQuestionSchema, wt as readRegularFileNoFollow, x as KB_STORE_DIR, xt as isKernelAnchoredPath, y as KB_EVENTS_PATH, yt as prepareKnowledgeFileTransaction, z as assertResearchClaimEvidenceIntegrity } from "./inspect-LUMkas6A.js";
-import { n as slugify, r as stableId, t as sha256 } from "./ids-DRqPZ42_.js";
-import { A as assertImmutableRef, C as resetRetrievalHoldoutRegistry, D as jsonObjectCandidateCodec, E as jsonCandidateCodec, O as runSerializedKnowledgeOptimization, S as emitRetrievalHoldoutBypass, T as toOffPolicyTrajectory, _ as defaultGetMemoryContext, a as createNeo4jAgentMemoryAdapter, b as applySessionStickyRetrievalHoldout, c as runAgentMemoryImprovement, d as runAgentMemoryExperiment, f as agentMemorySequenceJudge, g as forkAgentMemoryBranchSnapshot, h as createAgentMemoryBranch, i as AgentMemoryWriteInputSchema, k as scenarioContentFingerprint, l as createGraphitiMemoryAdapter, m as buildAgentMemorySequencesFromBenchmarkCases, n as AgentMemoryKindSchema, o as createMem0MemoryAdapter, p as buildAgentMemorySequenceScenarios, r as AgentMemoryScopeSchema, s as mem0MemoryAdapterIdentity, t as AgentMemoryHitSchema, u as graphitiMemoryAdapterIdentity, v as renderMemoryContext, w as retrievalHoldoutConfigHash, x as deterministicRng, y as applyRetrievalHoldout } from "./memory-C6KPRhoU.js";
+import { $ as mergeTrackedClaims, A as KnowledgeGraphNodeSchema, At as removeDurable, B as ClaimLedgerGoalConflictError, Bt as textSourceAdapter, C as KB_STORE_DIR, Ct as prepareKnowledgeFileTransaction, D as KnowledgeBaseCandidateSchema, Dt as listRegularFilesWithinRoot, E as DeepQuestionSchema, Et as isMissingFile, F as ResearchClaimRecordSchema, Ft as writeFileDurable, G as claimEvidenceId, H as assertResearchClaimEvidenceIntegrity, I as ResearchSourceVersionSchema, It as writeFileDurableWithinRoot, J as deepQuestionId, K as claimId, L as SourceAnchorSchema, Lt as writeJsonDurable, M as KnowledgePageSchema, Mt as syncDirectory, N as ResearchClaimEvidenceSchema, Nt as withSafeDescendant, O as KnowledgeEventSchema, Ot as readRegularFileNoFollow, P as ResearchClaimLedgerSchema, Pt as withSafeDirectory, Q as mergeClaimLedgers, R as SourceRecordSchema, Rt as writeJsonDurableWithinRoot, S as KB_INDEX_PATH, St as knowledgeFileTransactionPlanHash, T as assertClaimLedgerId, Tt as isKernelAnchoredPath, U as assertResearchClaimLedgerIntegrity, V as assertDeepQuestionIntegrity, W as assertTrackedClaimIntegrity, X as linkClaimContradictions, Y as emptyClaimLedger, Z as materializeRegisteredClaimEvidence, _ as writeSourceRegistry, _t as withKnowledgeMutation, a as applyKnowledgeWriteBlocksFile, at as isScaffoldPath, b as KB_CLAIM_LEDGER_DIR, bt as assertKnowledgeMutationPath, c as validateKnowledgeIndex, ct as writeJson, d as writeKnowledgeIndex, dt as normalizeLinkTarget, et as normalizeClaimText, f as addSourcePath, ft as formatFrontmatter, g as sourceRegistryPath, gt as recoverPendingKnowledgeMutation, h as snapshotSourceTextInput, ht as inspectPendingKnowledgeMutation, i as applyKnowledgeWriteBlocks, it as initKnowledgeBase, j as KnowledgeIndexSchema, jt as renameDurable, k as KnowledgeGraphEdgeSchema, kt as readRegularFileWithinRoot, l as lintKnowledgeIndex, lt as WIKILINK_REGEX, m as loadSourceRegistry, mt as acquireDurableFileLock, n as inspectKnowledgeIndex, nt as buildKnowledgeGraph, o as isSafeKnowledgePath, ot as layoutFor, p as addSourceText, pt as parseFrontmatter, q as claimSourceHost, r as stringMetadata, rt as SCAFFOLD_PAGE_BASENAMES, s as parseKnowledgeWriteBlocks, st as loadKnowledgePages, t as explainKnowledgeTarget, tt as researchSourceVersionKey, u as buildKnowledgeIndex, ut as extractWikilinks, v as ClaimLedgerMigrationRequiredError, vt as withKnowledgeRead, w as MemoryKbStore, wt as rollbackKnowledgeFileTransaction, x as KB_EVENTS_PATH, xt as finishKnowledgeFileTransaction, y as FileSystemKbStore, yt as applyKnowledgeFileTransaction, z as KNOWLEDGE_EVENT_TYPES, zt as mediaTypeFor } from "./inspect-CJQGYuKa.js";
+import { i as textSourceId, n as slugify, r as stableId, t as sha256 } from "./ids-Bevz_pXV.js";
+import { A as assertImmutableRef, C as resetRetrievalHoldoutRegistry, D as jsonObjectCandidateCodec, E as jsonCandidateCodec, O as runSerializedKnowledgeOptimization, S as emitRetrievalHoldoutBypass, T as toOffPolicyTrajectory, _ as defaultGetMemoryContext, a as createNeo4jAgentMemoryAdapter, b as applySessionStickyRetrievalHoldout, c as runAgentMemoryImprovement, d as runAgentMemoryExperiment, f as agentMemorySequenceJudge, g as forkAgentMemoryBranchSnapshot, h as createAgentMemoryBranch, i as AgentMemoryWriteInputSchema, k as scenarioContentFingerprint, l as createGraphitiMemoryAdapter, m as buildAgentMemorySequencesFromBenchmarkCases, n as AgentMemoryKindSchema, o as createMem0MemoryAdapter, p as buildAgentMemorySequenceScenarios, r as AgentMemoryScopeSchema, s as mem0MemoryAdapterIdentity, t as AgentMemoryHitSchema, u as graphitiMemoryAdapterIdentity, v as renderMemoryContext, w as retrievalHoldoutConfigHash, x as deterministicRng, y as applyRetrievalHoldout } from "./memory-CIYRB_Q8.js";
 import { n as searchKnowledge, r as tokenizeQuery, t as reciprocalRankFusion } from "./search-CP0QtBJZ.js";
-import { A as INDUSTRY_RAG_BENCHMARKS, B as memoryWriteResultToSourceRecord, F as respondToIndustryRagBenchmarkSmokeCase, G as retrievalRecallJudge, H as partitionRetrievalScenarios, I as isKnowledgeMemoryBenchmarkCase, K as scoreRetrievalArtifact, L as createInMemoryBenchmarkAdapter, M as buildIndustryMemoryBenchmarkSmokeCases, N as buildIndustryRagBenchmarkSmokeCases, P as respondToIndustryMemoryBenchmarkSmokeCase, R as createNoopMemoryBenchmarkAdapter, U as retrievalConfigFromSurface, V as buildRetrievalEvalDispatch, W as retrievalConfigSurface, _ as memoryRecoveryDelayMs, a as buildKnowledgeBenchmarkScenarios, b as runBoundedMemoryLifecycle, c as runKnowledgeBenchmarkSuite, d as summarizeKnowledgeBenchmarkCampaign, f as acquireAgentMemoryRunLease, g as createMemoryExecutionPool, h as DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, i as runMemoryAdapterBenchmark, j as buildFirstPartyMemoryLifecycleBenchmarkCases, k as INDUSTRY_MEMORY_BENCHMARKS, l as scoreKnowledgeBenchmarkArtifact, m as AgentMemoryLifecycleUnsafeError, n as parseKnowledgeBenchmarkJsonl, o as knowledgeBenchmarkJudge, p as AgentMemoryLifecycleTimeoutError, r as parseKnowledgeBenchmarkQrels, s as renderKnowledgeBenchmarkReportMarkdown, t as buildRetrievalBenchmarkCasesFromQrels, u as scoreMemoryBenchmarkArtifact, x as sleepForMemoryRecovery, y as resolveMemoryCleanupTimeoutMs, z as memoryHitToSourceRecord } from "./benchmarks-CmW6iORW.js";
+import { A as INDUSTRY_RAG_BENCHMARKS, B as memoryWriteResultToSourceRecord, F as respondToIndustryRagBenchmarkSmokeCase, G as retrievalRecallJudge, H as partitionRetrievalScenarios, I as isKnowledgeMemoryBenchmarkCase, K as scoreRetrievalArtifact, L as createInMemoryBenchmarkAdapter, M as buildIndustryMemoryBenchmarkSmokeCases, N as buildIndustryRagBenchmarkSmokeCases, P as respondToIndustryMemoryBenchmarkSmokeCase, R as createNoopMemoryBenchmarkAdapter, U as retrievalConfigFromSurface, V as buildRetrievalEvalDispatch, W as retrievalConfigSurface, _ as memoryRecoveryDelayMs, a as buildKnowledgeBenchmarkScenarios, b as runBoundedMemoryLifecycle, c as runKnowledgeBenchmarkSuite, d as summarizeKnowledgeBenchmarkCampaign, f as acquireAgentMemoryRunLease, g as createMemoryExecutionPool, h as DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, i as runMemoryAdapterBenchmark, j as buildFirstPartyMemoryLifecycleBenchmarkCases, k as INDUSTRY_MEMORY_BENCHMARKS, l as scoreKnowledgeBenchmarkArtifact, m as AgentMemoryLifecycleUnsafeError, n as parseKnowledgeBenchmarkJsonl, o as knowledgeBenchmarkJudge, p as AgentMemoryLifecycleTimeoutError, r as parseKnowledgeBenchmarkQrels, s as renderKnowledgeBenchmarkReportMarkdown, t as buildRetrievalBenchmarkCasesFromQrels, u as scoreMemoryBenchmarkArtifact, x as sleepForMemoryRecovery, y as resolveMemoryCleanupTimeoutMs, z as memoryHitToSourceRecord } from "./benchmarks-C8L7HJb4.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";
 import { createHash } from "node:crypto";
 import { cp, lstat, mkdir, mkdtemp, readFile, rm, stat } from "node:fs/promises";
@@ -5105,7 +5105,8 @@ async function runVerifiedResearchLoop(options) {
 		const accepted = [];
 		const rejectedWorkerSources = [];
 		const existingUris = new Set(index.sources.flatMap((source) => typeof source.metadata?.originalUri === "string" ? [source.metadata.originalUri] : []));
-		for (const source of workerContribution.sources ?? []) {
+		for (const proposedSource of workerContribution.sources ?? []) {
+			const source = snapshotSourceTextInput(proposedSource);
 			if (isDuplicate(source, existingUris, accepted)) {
 				rejectedWorkerSources.push({
 					source,
@@ -5235,14 +5236,17 @@ function isDuplicate(source, existingUris, accepted) {
 }
 async function registerSources(options, sources) {
 	const records = [];
-	for (const source of sources) records.push(await addSourceText(options.root, source, options.sourceOptions));
+	for (const candidate of sources) {
+		const source = snapshotSourceTextInput(candidate);
+		records.push(await addSourceText(options.root, source, options.sourceOptions));
+	}
 	return records;
 }
 async function confirmRegisteredSources(driver, sources) {
 	if (!driver.commitSources) return;
-	const originalUris = sources.flatMap((source) => typeof source.metadata?.originalUri === "string" ? [source.metadata.originalUri] : []);
-	if (originalUris.length === 0) return;
-	await driver.commitSources([...new Set(originalUris)].sort());
+	const textSources = sources.filter((source) => typeof source.metadata?.originalUri === "string");
+	if (textSources.length === 0) return;
+	await driver.commitSources(textSources);
 }
 /**
 * Apply a contribution's curated pages. Static `proposalText` plus a
@@ -5842,7 +5846,7 @@ function buildDriver(options, persistence, restored) {
 	const deterministicFallback = options.deterministicFallback ?? true;
 	const claims = new Map((restored?.claims ?? []).map((claim) => [claim.id, fromRecord(claim)]));
 	const claimEvidence = new Map((restored?.claimEvidence ?? []).map((evidence) => [evidence.id, evidence]));
-	const registeredSourceUris = new Set(restored?.registeredSourceUris ?? []);
+	const registeredSources = new Map((restored?.registeredSources ?? []).map((source) => [source.sourceId, source]));
 	const questions = new Map((restored?.questions ?? []).map((question) => [question.id, question]));
 	let rounds = restored?.rounds ?? 0;
 	let preparedRounds = Math.max(rounds, restored?.preparedRounds ?? rounds);
@@ -5854,13 +5858,14 @@ function buildDriver(options, persistence, restored) {
 	}
 	function toLedger() {
 		return {
+			schemaVersion: 2,
 			id: persistence?.ledgerId ?? "in-memory",
 			...goal === void 0 ? {} : { goal },
 			updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
 			rounds,
 			...preparedRounds > rounds ? { preparedRounds } : {},
 			claimEvidence: [...claimEvidence.values()].sort((left, right) => left.id.localeCompare(right.id)),
-			registeredSourceUris: [...registeredSourceUris].sort(),
+			registeredSources: [...registeredSources.values()].sort((left, right) => left.sourceId.localeCompare(right.sourceId)),
 			claims: [...claims.values()].map((claim) => ({
 				...claim,
 				supportingHosts: [...new Set(claim.supportingHosts)].sort(),
@@ -5894,8 +5899,8 @@ function buildDriver(options, persistence, restored) {
 		for (const claim of merged.claims) claims.set(claim.id, fromRecord(claim));
 		claimEvidence.clear();
 		for (const evidence of merged.claimEvidence) claimEvidence.set(evidence.id, evidence);
-		registeredSourceUris.clear();
-		for (const sourceUri of merged.registeredSourceUris) registeredSourceUris.add(sourceUri);
+		registeredSources.clear();
+		for (const source of merged.registeredSources) registeredSources.set(source.sourceId, source);
 		questions.clear();
 		for (const question of merged.questions) questions.set(question.id, question);
 		rounds = Math.max(rounds, merged.rounds);
@@ -5947,19 +5952,23 @@ function buildDriver(options, persistence, restored) {
 		return tracked;
 	}
 	/** Persist an extraction observation without treating its source as registered. */
-	function recordEvidence(extracted, sourceUri, round) {
+	function recordEvidence(extracted, sourceVersion, round) {
 		const text = extracted.text.trim();
 		const observedClaimId = claimId(text);
 		const contradictsClaimId = extracted.contradictsExistingId === observedClaimId ? void 0 : extracted.contradictsExistingId;
 		const evidence = {
 			id: claimEvidenceId({
 				claimId: observedClaimId,
-				sourceUri,
+				sourceId: sourceVersion.sourceId,
+				sourceUri: sourceVersion.uri,
+				sourceContentHash: sourceVersion.contentHash,
 				contradictsClaimId
 			}),
 			claimId: observedClaimId,
 			text,
-			sourceUri,
+			sourceId: sourceVersion.sourceId,
+			sourceUri: sourceVersion.uri,
+			sourceContentHash: sourceVersion.contentHash,
 			...contradictsClaimId === void 0 ? {} : { contradictsClaimId },
 			firstSeenRound: round
 		};
@@ -5975,9 +5984,9 @@ function buildDriver(options, persistence, restored) {
 		claimEvidence.set(merged.id, merged);
 		return merged;
 	}
-	/** Materialize evidence for newly confirmed source URIs into live claims. */
-	function materializeEvidenceFor(sourceUris) {
-		const evidence = [...claimEvidence.values()].filter((item) => sourceUris.has(item.sourceUri));
+	/** Materialize evidence for newly confirmed exact source versions into live claims. */
+	function materializeEvidenceFor(sourceVersions) {
+		const evidence = [...claimEvidence.values()].filter((item) => sourceVersions.has(sourceVersionKeyOfEvidence(item)));
 		const texts = [];
 		for (const item of evidence) {
 			recordClaim({
@@ -5992,13 +6001,20 @@ function buildDriver(options, persistence, restored) {
 		}
 		return texts;
 	}
-	async function commitSources(sourceUris) {
+	async function commitSources(sources) {
+		const versions = sources.map(sourceVersionOfRecord);
+		const nextRegistered = new Map(registeredSources);
 		const newlyRegistered = /* @__PURE__ */ new Set();
-		for (const sourceUri of sourceUris) {
-			if (registeredSourceUris.has(sourceUri)) continue;
-			registeredSourceUris.add(sourceUri);
-			newlyRegistered.add(sourceUri);
+		for (const version of versions) {
+			const key = researchSourceVersionKey(version);
+			const existing = nextRegistered.get(version.sourceId);
+			if (existing && researchSourceVersionKey(existing) !== key) throw new Error(`registered source '${version.sourceId}' has conflicting immutable content`);
+			if (existing) continue;
+			nextRegistered.set(version.sourceId, version);
+			newlyRegistered.add(key);
 		}
+		registeredSources.clear();
+		for (const [sourceId, version] of nextRegistered) registeredSources.set(sourceId, version);
 		if (newlyRegistered.size > 0) markAddressed(materializeEvidenceFor(newlyRegistered));
 		await persist();
 	}
@@ -6071,17 +6087,25 @@ function buildDriver(options, persistence, restored) {
 		* because such a source cannot drive the research and pollutes the KB.
 		*/
 		async verifySource(source, ctx) {
-			bindGoal(ctx.goal);
-			const extracted = await extractClaims(source, ctx);
+			const sourceSnapshot = snapshotSourceTextInput(source);
+			const goalSnapshot = ctx.goal;
+			const roundSnapshot = ctx.round;
+			const sourceVersion = sourceVersionOfProposal(sourceSnapshot);
+			bindGoal(goalSnapshot);
+			const extracted = await extractClaims(sourceSnapshot, goalSnapshot);
 			if (extracted.length === 0) return {
 				accept: false,
 				reason: "no extractable claim: source yields nothing to drive the research deeper"
 			};
-			for (const claim of extracted) recordEvidence(claim, source.uri, ctx.round);
+			for (const claim of extracted) recordEvidence(claim, sourceVersion, roundSnapshot);
 			if (!persistence) {
-				registeredSourceUris.add(source.uri);
-				markAddressed(materializeEvidenceFor(/* @__PURE__ */ new Set([source.uri])));
-			} else if (registeredSourceUris.has(source.uri)) markAddressed(materializeEvidenceFor(/* @__PURE__ */ new Set([source.uri])));
+				const key = researchSourceVersionKey(sourceVersion);
+				registeredSources.set(sourceVersion.sourceId, sourceVersion);
+				markAddressed(materializeEvidenceFor(/* @__PURE__ */ new Set([key])));
+			} else {
+				const registered = registeredSources.get(sourceVersion.sourceId);
+				if (registered && researchSourceVersionKey(registered) === researchSourceVersionKey(sourceVersion)) markAddressed(materializeEvidenceFor(/* @__PURE__ */ new Set([researchSourceVersionKey(sourceVersion)])));
+			}
 			await persist();
 			return { accept: true };
 		},
@@ -6126,8 +6150,8 @@ function buildDriver(options, persistence, restored) {
 		commitSources,
 		toLedger
 	};
-	async function extractClaims(source, ctx) {
-		const fromLlm = await extractClaimsWithLlm(source, ctx, claimsForExtraction());
+	async function extractClaims(source, goal) {
+		const fromLlm = await extractClaimsWithLlm(source, goal, claimsForExtraction());
 		if (fromLlm.length > 0) return fromLlm.slice(0, maxClaimsPerSource);
 		if (deterministicFallback) return deterministicClaims(source).slice(0, maxClaimsPerSource);
 		return [];
@@ -6148,7 +6172,7 @@ function buildDriver(options, persistence, restored) {
 		}
 		return [...known.values()];
 	}
-	async function extractClaimsWithLlm(source, ctx, ledger) {
+	async function extractClaimsWithLlm(source, goal, ledger) {
 		let router;
 		try {
 			router = resolveRouter();
@@ -6159,7 +6183,7 @@ function buildDriver(options, persistence, restored) {
 		const ledgerLines = ledger.slice(0, 20).map((claim) => `- [${claim.id}] ${claim.text}`).join("\n");
 		const system = `You extract the KEY factual claims a researcher would cite a page for, and flag CONTRADICTIONS with claims already on the ledger. A claim is one concrete, checkable assertion using the page's own terms and numbers. Return ONLY a JSON array; each item is {"claim": string, "contradicts": string|null} where contradicts is the bracketed [id] of a ledger claim this page DIRECTLY contradicts, else null. Return at most ${maxClaimsPerSource} claims. No prose.`;
 		const user = [
-			`Research goal: ${ctx.goal}`,
+			`Research goal: ${goal}`,
 			`Page title: ${source.title ?? "(none)"}`,
 			ledgerLines ? `Claims already on the ledger:\n${ledgerLines}` : "Ledger is empty.",
 			`Page excerpt:\n${excerpt}`,
@@ -6217,6 +6241,33 @@ function buildDriver(options, persistence, restored) {
 		return out.sort((a, b) => priority[a.kind] - priority[b.kind]);
 	}
 }
+function sourceVersionOfProposal(source) {
+	const contentHash = sha256(source.text);
+	return {
+		sourceId: textSourceId(source.uri, contentHash),
+		uri: source.uri,
+		contentHash
+	};
+}
+function sourceVersionOfRecord(source) {
+	const originalUri = source.metadata?.originalUri;
+	if (typeof originalUri !== "string" || originalUri.length === 0) throw new Error(`registered source '${source.id}' has no originalUri`);
+	if (!/^[a-f0-9]{64}$/.test(source.contentHash)) throw new Error(`registered source '${source.id}' contentHash is not a SHA-256 digest`);
+	const expectedSourceId = textSourceId(originalUri, source.contentHash);
+	if (source.id !== expectedSourceId) throw new Error(`registered source '${source.id}' does not match URI-and-content identity '${expectedSourceId}'`);
+	return {
+		sourceId: source.id,
+		uri: originalUri,
+		contentHash: source.contentHash
+	};
+}
+function sourceVersionKeyOfEvidence(evidence) {
+	return researchSourceVersionKey({
+		sourceId: evidence.sourceId,
+		uri: evidence.sourceUri,
+		contentHash: evidence.sourceContentHash
+	});
+}
 function makeQuestion(kind, text, claimIds, raisedRound) {
 	return {
 		kind,
@@ -6371,6 +6422,6 @@ function buildSteerText(gaps, deepQuestions, invalidationTargets, minIndependent
 	return lines.join("\n");
 }
 //#endregion
-export { AgentMemoryHitSchema, AgentMemoryKindSchema, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, AgentMemoryScopeSchema, AgentMemoryWriteInputSchema, ClaimLedgerGoalConflictError, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, 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, KnowledgeBaseCandidateSchema, KnowledgeEventSchema, KnowledgeGraphEdgeSchema, KnowledgeGraphNodeSchema, KnowledgeImprovementCandidateRefSchema, KnowledgeImprovementEvidenceSchema, KnowledgeImprovementRunStateSchema, KnowledgeIndexSchema, KnowledgePageSchema, KnowledgeProposalParseError, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, MemoryKbStore, POLITE_USER_AGENT, READINESS_SPEC_DEFAULTS, ResearchClaimEvidenceSchema, ResearchClaimLedgerSchema, ResearchClaimRecordSchema, RouterError, SCAFFOLD_PAGE_BASENAMES, SourceAnchorSchema, SourceRecordSchema, WIKILINK_REGEX, __resetHttpThrottle, acquireAgentMemoryRunLease, addSourcePath, addSourceText, agentMemorySequenceJudge, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, assertClaimLedgerId, assertDeepQuestionIntegrity, assertResearchClaimEvidenceIntegrity, assertResearchClaimLedgerIntegrity, assertTrackedClaimIntegrity, buildAgentMemorySequenceScenarios, buildAgentMemorySequencesFromBenchmarkCases, buildEvalKnowledgeBundle, buildFirstPartyMemoryLifecycleBenchmarkCases, buildIndustryMemoryBenchmarkSmokeCases, buildIndustryRagBenchmarkSmokeCases, buildKnowledgeBenchmarkScenarios, buildKnowledgeGraph, buildKnowledgeIndex, buildRetrievalBenchmarkCasesFromQrels, buildRetrievalEvalDispatch, calibrateRagAnswerJudge, canonicalizeUrl, chunkMarkdown, citedClaimKey, citedClaimOf, claimEvidenceId, claimId, claimSourceHost, contentKey, createAdaptiveResearchDriver, createAgentMemoryBranch, createClaimDecorator, createClaimGroundingVerifier, createCollectionResearchDriver, createCornellLiiSource, createD1FreshnessStoreStub, createFileSystemFreshnessStore, createFileSystemSearchProvider, createGraphitiMemoryAdapter, createInMemoryBenchmarkAdapter, createIrsPublicationsSource, createKnowledgeControlLoopAdapter, createKnowledgeEvent, createLocalDiscoveryDispatcher, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, createNoopMemoryBenchmarkAdapter, createPersistentResearchDrivingDriver, createRagAnswerQualityHook, createResearchDrivingDriver, createStateSosSource, createTangleRouterClient, createVerifyingResearchDriver, createWebResearchWorker, deepQuestionId, defaultGetMemoryContext, defineReadinessSpec, detectChanges, deterministicRng, diagnoseRagAnswerFailure, emitRetrievalHoldoutBypass, emptyClaimLedger, evaluateKnowledgeBaseReadiness, explainKnowledgeTarget, extractLinks, extractWikilinks, firstMatch, forkAgentMemoryBranchSnapshot, formatFrontmatter, fromAgentCandidateKnowledgeRef, gradeCompanyAgainstText, gradeFactAgainstText, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, htmlToText, improveKnowledgeBase, initKnowledgeBase, innerHtmlById, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, investmentThesisSet, isKernelAnchoredPath, isKnowledgeMemoryBenchmarkCase, isMissingFile, isSafeKnowledgePath, isScaffoldPath, jsonCandidateCodec, jsonObjectCandidateCodec, kbIndexToText, knowledgeBenchmarkJudge, knowledgeImprovementCandidateRef, knowledgeImprovementRunDir, knowledgeImprovementRunId, knowledgeReleaseReport, layoutFor, lensDistribution, linkClaimContradictions, lintKnowledgeIndex, listRegularFilesWithinRoot, loadKnowledgeImprovementActivationResult, loadKnowledgeImprovementEvents, loadKnowledgeImprovementState, loadKnowledgePages, loadSourceRegistry, looksLikeBlockPage, materialFactsSurfaced, materialFactsSurfacedInText, materializeRegisteredClaimEvidence, mediaTypeFor, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, mergeClaimLedgers, mergeTrackedClaims, normalizeClaimText, normalizeExternalRagScores, normalizeLinkTarget, optimizeKnowledgeBasePolicy, parseFrontmatter, parseKnowledgeBenchmarkJsonl, parseKnowledgeBenchmarkQrels, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, politeFetch, promoteKnowledgeCandidate, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, removeDurable, renameDurable, renderKnowledgeBenchmarkReportMarkdown, renderMemoryContext, resetRetrievalHoldoutRegistry, resolveMemoryCleanupTimeoutMs, respondToIndustryMemoryBenchmarkSmokeCase, respondToIndustryRagBenchmarkSmokeCase, restoreKnowledgeCandidateBaseline, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runAgentMemoryExperiment, runAgentMemoryImprovement, runBoundedMemoryLifecycle, runDiscoveryLoop, runInvestmentThesisTask, runKnowledgeBenchmarkSuite, runKnowledgeResearchLoop, runMemoryAdapterBenchmark, runRagKnowledgeImprovementLoop, runRagOptimization, runRetrievalImprovementLoop, runSerializedKnowledgeOptimization, runVerifiedResearchLoop, scenarioContentFingerprint, scoreKnowledgeBaseIndex, scoreKnowledgeBenchmarkArtifact, scoreMemoryBenchmarkArtifact, scoreRagAnswerArtifact, scoreRetrievalArtifact, searchKnowledge, sha256, sleepForMemoryRecovery, slugify, sourceMatchesGaps, sourceRegistryPath, stableId, stripFrontmatter, summarizeKnowledgeBenchmarkCampaign, syncDirectory, textSourceAdapter, thesisReadinessSpecs, toAgentCandidateKnowledgeRef, toDeepEvalTestCases, toOffPolicyTrajectory, toRagCheckerRecords, toRagasEvaluationRows, toTruLensRecords, tokenizeQuery, totalMaterialFacts, triageSource, validateKnowledgeIndex, withCitedClaim, withKnowledgeImprovementCandidate, withKnowledgeImprovementComparison, withSafeDescendant, withSafeDirectory, writeFileDurable, writeFileDurableWithinRoot, writeJson, writeJsonDurable, writeJsonDurableWithinRoot, writeKnowledgeIndex, writeSourceRegistry };
+export { AgentMemoryHitSchema, AgentMemoryKindSchema, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, AgentMemoryScopeSchema, AgentMemoryWriteInputSchema, ClaimLedgerGoalConflictError, ClaimLedgerMigrationRequiredError, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, 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, KnowledgeBaseCandidateSchema, KnowledgeEventSchema, KnowledgeGraphEdgeSchema, KnowledgeGraphNodeSchema, KnowledgeImprovementCandidateRefSchema, KnowledgeImprovementEvidenceSchema, KnowledgeImprovementRunStateSchema, KnowledgeIndexSchema, KnowledgePageSchema, KnowledgeProposalParseError, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, MemoryKbStore, POLITE_USER_AGENT, READINESS_SPEC_DEFAULTS, ResearchClaimEvidenceSchema, ResearchClaimLedgerSchema, ResearchClaimRecordSchema, ResearchSourceVersionSchema, RouterError, SCAFFOLD_PAGE_BASENAMES, SourceAnchorSchema, SourceRecordSchema, WIKILINK_REGEX, __resetHttpThrottle, acquireAgentMemoryRunLease, addSourcePath, addSourceText, agentMemorySequenceJudge, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, assertClaimLedgerId, assertDeepQuestionIntegrity, assertResearchClaimEvidenceIntegrity, assertResearchClaimLedgerIntegrity, assertTrackedClaimIntegrity, buildAgentMemorySequenceScenarios, buildAgentMemorySequencesFromBenchmarkCases, buildEvalKnowledgeBundle, buildFirstPartyMemoryLifecycleBenchmarkCases, buildIndustryMemoryBenchmarkSmokeCases, buildIndustryRagBenchmarkSmokeCases, buildKnowledgeBenchmarkScenarios, buildKnowledgeGraph, buildKnowledgeIndex, buildRetrievalBenchmarkCasesFromQrels, buildRetrievalEvalDispatch, calibrateRagAnswerJudge, canonicalizeUrl, chunkMarkdown, citedClaimKey, citedClaimOf, claimEvidenceId, claimId, claimSourceHost, contentKey, createAdaptiveResearchDriver, createAgentMemoryBranch, createClaimDecorator, createClaimGroundingVerifier, createCollectionResearchDriver, createCornellLiiSource, createD1FreshnessStoreStub, createFileSystemFreshnessStore, createFileSystemSearchProvider, createGraphitiMemoryAdapter, createInMemoryBenchmarkAdapter, createIrsPublicationsSource, createKnowledgeControlLoopAdapter, createKnowledgeEvent, createLocalDiscoveryDispatcher, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, createNoopMemoryBenchmarkAdapter, createPersistentResearchDrivingDriver, createRagAnswerQualityHook, createResearchDrivingDriver, createStateSosSource, createTangleRouterClient, createVerifyingResearchDriver, createWebResearchWorker, deepQuestionId, defaultGetMemoryContext, defineReadinessSpec, detectChanges, deterministicRng, diagnoseRagAnswerFailure, emitRetrievalHoldoutBypass, emptyClaimLedger, evaluateKnowledgeBaseReadiness, explainKnowledgeTarget, extractLinks, extractWikilinks, firstMatch, forkAgentMemoryBranchSnapshot, formatFrontmatter, fromAgentCandidateKnowledgeRef, gradeCompanyAgainstText, gradeFactAgainstText, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, htmlToText, improveKnowledgeBase, initKnowledgeBase, innerHtmlById, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, investmentThesisSet, isKernelAnchoredPath, isKnowledgeMemoryBenchmarkCase, isMissingFile, isSafeKnowledgePath, isScaffoldPath, jsonCandidateCodec, jsonObjectCandidateCodec, kbIndexToText, knowledgeBenchmarkJudge, knowledgeImprovementCandidateRef, knowledgeImprovementRunDir, knowledgeImprovementRunId, knowledgeReleaseReport, layoutFor, lensDistribution, linkClaimContradictions, lintKnowledgeIndex, listRegularFilesWithinRoot, loadKnowledgeImprovementActivationResult, loadKnowledgeImprovementEvents, loadKnowledgeImprovementState, loadKnowledgePages, loadSourceRegistry, looksLikeBlockPage, materialFactsSurfaced, materialFactsSurfacedInText, materializeRegisteredClaimEvidence, mediaTypeFor, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, mergeClaimLedgers, mergeTrackedClaims, normalizeClaimText, normalizeExternalRagScores, normalizeLinkTarget, optimizeKnowledgeBasePolicy, parseFrontmatter, parseKnowledgeBenchmarkJsonl, parseKnowledgeBenchmarkQrels, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, politeFetch, promoteKnowledgeCandidate, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, removeDurable, renameDurable, renderKnowledgeBenchmarkReportMarkdown, renderMemoryContext, researchSourceVersionKey, resetRetrievalHoldoutRegistry, resolveMemoryCleanupTimeoutMs, respondToIndustryMemoryBenchmarkSmokeCase, respondToIndustryRagBenchmarkSmokeCase, restoreKnowledgeCandidateBaseline, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runAgentMemoryExperiment, runAgentMemoryImprovement, runBoundedMemoryLifecycle, runDiscoveryLoop, runInvestmentThesisTask, runKnowledgeBenchmarkSuite, runKnowledgeResearchLoop, runMemoryAdapterBenchmark, runRagKnowledgeImprovementLoop, runRagOptimization, runRetrievalImprovementLoop, runSerializedKnowledgeOptimization, runVerifiedResearchLoop, scenarioContentFingerprint, scoreKnowledgeBaseIndex, scoreKnowledgeBenchmarkArtifact, scoreMemoryBenchmarkArtifact, scoreRagAnswerArtifact, scoreRetrievalArtifact, searchKnowledge, sha256, sleepForMemoryRecovery, slugify, snapshotSourceTextInput, sourceMatchesGaps, sourceRegistryPath, stableId, stripFrontmatter, summarizeKnowledgeBenchmarkCampaign, syncDirectory, textSourceAdapter, textSourceId, thesisReadinessSpecs, toAgentCandidateKnowledgeRef, toDeepEvalTestCases, toOffPolicyTrajectory, toRagCheckerRecords, toRagasEvaluationRows, toTruLensRecords, tokenizeQuery, totalMaterialFacts, triageSource, validateKnowledgeIndex, withCitedClaim, withKnowledgeImprovementCandidate, withKnowledgeImprovementComparison, withSafeDescendant, withSafeDirectory, writeFileDurable, writeFileDurableWithinRoot, writeJson, writeJsonDurable, writeJsonDurableWithinRoot, writeKnowledgeIndex, writeSourceRegistry };
 
 //# sourceMappingURL=index.js.map