@tangle-network/agent-knowledge 19.0.1 → 19.1.0

package/dist/{inspect-C6YK7af7.js → inspect-CwIvMcno.js}

@@ -166,6 +166,38 @@ async function listRegularFilesWithinRoot(root, relativeDirectory) {
 	const normalized = normalizeRelativePath(relativeDirectory);
 	return withSafeDirectory(root, normalized, false, (directory) => listRegularFilesFromOpenDirectory(directory, normalized));
 }
+/** Metadata-only inventory, retaining the same directory anchoring and special-file refusal as reads. */
+async function listRegularFileMetadataWithinRoot(root, relativeDirectory) {
+	const normalized = normalizeRelativePath(relativeDirectory);
+	const walk = async (directory, relative) => {
+		const out = [];
+		const entries = await readdir(directory, { withFileTypes: true });
+		for (const entry of entries.filter((entry) => entry.isDirectory())) out.push(...await withSafeDirectory(directory, entry.name, false, (child) => walk(child, `${relative}/${entry.name}`)));
+		const files = entries.filter((entry) => !entry.isDirectory());
+		for (let start = 0; start < files.length; start += 64) {
+			const batch = await Promise.all(files.slice(start, start + 64).map(async (entry) => {
+				const path = `${relative}/${entry.name}`;
+				if (!entry.isFile()) throw new Error(`knowledge tree contains an unsupported filesystem entry: ${path}`);
+				const stat = await lstat(resolve(directory, entry.name), { bigint: true });
+				if (!stat.isFile()) throw new Error(`knowledge path is not a regular file: ${path}`);
+				return [{
+					path,
+					bytes: Number(stat.size),
+					generation: [
+						stat.dev,
+						stat.ino,
+						stat.size,
+						stat.mtimeNs,
+						stat.ctimeNs
+					].join(":")
+				}];
+			}));
+			out.push(...batch.flat());
+		}
+		return out.sort((left, right) => left.path.localeCompare(right.path));
+	};
+	return withSafeDirectory(root, normalized, false, (directory) => walk(directory, normalized));
+}
 function isMissingFile(error) {
 	return error?.code === "ENOENT";
 }
@@ -3862,6 +3894,18 @@ function originatedPages(pages, origin = "here") {
 	}));
 }
 const RUN_LINEAGE_BASENAME = "lineage.json";
+const toolViewLoaders = /* @__PURE__ */ new WeakMap();
+const toolViews = /* @__PURE__ */ new WeakSet();
+/** Only factory-owned immutable views are safe to reuse by object identity. */
+function isKnowledgeToolChain(chain) {
+	return toolViews.has(chain);
+}
+const MAX_CACHED_ROOTS = 8;
+const MAX_CACHED_SOURCE_BYTES = 67108864;
+/** Internal tool path. Custom stores retain their existing loadChain contract. */
+function loadKnowledgeToolChain(stores, runId) {
+	return toolViewLoaders.get(stores)?.(runId) ?? stores.loadChain(runId);
+}
 function createRunScopedStores(options) {
 	if (!options || typeof options !== "object") throw new TypeError("createRunScopedStores options are required");
 	if (typeof options.root !== "string" || options.root.trim().length === 0) throw new TypeError("createRunScopedStores root must be a non-empty string");
@@ -3889,7 +3933,7 @@ function createRunScopedStores(options) {
 			current = parent;
 		}
 	};
-	return {
+	const stores = {
 		storePath(runId) {
 			assertRunId(runId);
 			return storePath(runId);
@@ -3933,6 +3977,85 @@ function createRunScopedStores(options) {
 			return out;
 		}
 	};
+	const roots = /* @__PURE__ */ new Map();
+	let cachedBytes = 0;
+	let current;
+	const readRoot = async (root) => {
+		const loaded = await withKnowledgeRead(root, async () => {
+			let files;
+			try {
+				files = await listRegularFileMetadataWithinRoot(root, pagesDirectory);
+			} catch (error) {
+				if (!isMissingFile(error)) throw error;
+				files = [];
+			}
+			const generation = JSON.stringify(files.map((file) => [file.path, file.generation]));
+			const previous = roots.get(root);
+			if (previous?.generation === generation) return previous;
+			const pages = await loadKnowledgePages(root, { pagesDirectory });
+			return {
+				generation,
+				bytes: files.reduce((sum, file) => sum + file.bytes, 0),
+				pages: freezeView(pages)
+			};
+		});
+		const existing = roots.get(root);
+		if (existing?.generation === loaded.generation) return existing;
+		if (existing) {
+			roots.delete(root);
+			cachedBytes -= existing.bytes;
+		}
+		if (loaded.bytes <= MAX_CACHED_SOURCE_BYTES) {
+			while (roots.size >= MAX_CACHED_ROOTS || cachedBytes + loaded.bytes > MAX_CACHED_SOURCE_BYTES) {
+				const oldest = roots.keys().next().value;
+				if (oldest === void 0) break;
+				cachedBytes -= roots.get(oldest).bytes;
+				roots.delete(oldest);
+				current = void 0;
+			}
+			roots.set(root, loaded);
+			cachedBytes += loaded.bytes;
+		}
+		return loaded;
+	};
+	toolViewLoaders.set(stores, async (runId) => {
+		assertRunId(runId);
+		const scopes = [{
+			root: storePath(runId),
+			origin: "here"
+		}];
+		for (const ancestor of await resolveLineage(runId)) scopes.push({
+			root: storePath(ancestor),
+			origin: `inherited:${ancestor}`
+		});
+		if (options.sharedRoot) scopes.push({
+			root: options.sharedRoot,
+			origin: "shared"
+		});
+		const identities = scopes.map(({ root, origin }) => JSON.stringify([root, origin]));
+		const parts = [];
+		for (const scope of scopes) parts.push(await readRoot(scope.root));
+		if (current && identities.length === current.identities.length && identities.every((id, i) => id === current.identities[i] && parts[i] === current.parts[i])) return current.chain;
+		const chain = Object.freeze(parts.flatMap((part, i) => part.pages.map((page) => Object.freeze({
+			page,
+			origin: scopes[i].origin
+		}))));
+		toolViews.add(chain);
+		current = parts.length <= MAX_CACHED_ROOTS && parts.reduce((sum, part) => sum + part.bytes, 0) <= MAX_CACHED_SOURCE_BYTES ? {
+			identities,
+			parts,
+			chain
+		} : void 0;
+		return chain;
+	});
+	return stores;
+}
+function freezeView(value) {
+	if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
+		for (const child of Object.values(value)) freezeView(child);
+		Object.freeze(value);
+	}
+	return value;
 }
 /** File-backed authority used when the product has no separate run manifest. */
 function createFileRunLineageAuthority(runStorePath) {
@@ -4316,6 +4439,6 @@ function explainKnowledgeTarget(index, target) {
 	};
 }
 //#endregion
-export { FileSystemKbStore as $, assertResearchClaimEvidenceIntegrity as $t, visibilityIndexOf as A, normalizePagesDirectory as An, WIKILINK_REGEX as At, gradeClaims as B, renameDurable as Bn, KnowledgePageSchema as Bt, nonEmpty as C, assertKnowledgeMutationPath as Cn, initKnowledgeBase as Ct, validateOrigin as D, prepareKnowledgeFileTransaction as Dn, layoutFor as Dt, validateKnowledgePage as E, knowledgeFileTransactionPlanHash as En, knowledgePageFromMarkdown as Et, CHECKABLE_RUNG_THRESHOLD as F, listRegularFilesWithinRoot as Fn, KnowledgeEventSchema as Ft, writeKnowledgeIndex as G, writeFileDurableWithinRoot as Gn, ResearchClaimLedgerSchema as Gt, verdictFor as H, withSafeDescendant as Hn, KnowledgeRelationNodeSchema as Ht, DEADLINE_EXIT_CODE as I, readRegularFileNoFollow as In, KnowledgeGraphEdgeSchema as It, loadSourceRegistry as J, mediaTypeFor$1 as Jn, SourceAnchorSchema as Jt, addSourcePath as K, writeJsonDurable as Kn, ResearchClaimRecordSchema as Kt, UncheckableClaimError as L, readRegularFileWithinRoot as Ln, KnowledgeGraphNodeSchema as Lt, normalizePageText as M, canonicalRelativeWithinRoot as Mn, normalizeLinkTarget as Mt, validateKnowledgeIndex as N, isKernelAnchoredPath as Nn, DeepQuestionSchema as Nt, verifyKnowledgeVisibilitySnapshot as O, rollbackKnowledgeFileTransaction as On, loadKnowledgePages as Ot, lintKnowledgeIndex as P, isMissingFile as Pn, KnowledgeBaseCandidateSchema as Pt, ClaimLedgerMigrationRequiredError as Q, assertDeepQuestionIntegrity as Qt, assertGradeableEvidence as R, relativeWithinRoot as Rn, KnowledgeIndexSchema as Rt, knowledgeVisibilityArtifactRef as S, applyKnowledgeFileTransaction as Sn, SCAFFOLD_PAGE_BASENAMES as St, normalizeVisibilityRef as T, finishKnowledgeFileTransaction as Tn, isScaffoldPath as Tt, verifyGradeableEvidence as U, withSafeDirectory as Un, KnowledgeRelationSchema as Ut, gradeFor as V, syncDirectory as Vn, KnowledgeRelationGraphSchema as Vt, buildKnowledgeIndex as W, writeFileDurable as Wn, ResearchClaimEvidenceSchema as Wt, sourceRegistryPath as X, KNOWLEDGE_EVENT_TYPES as Xt, snapshotSourceTextInput as Y, textSourceAdapter as Yn, SourceRecordSchema as Yt, writeSourceRegistry as Z, ClaimLedgerGoalConflictError as Zt, createKnowledgeVisibilitySnapshot as _, isKnowledgeMutationHeld as _n, parseKnowledgeCitationReference as _t, applyKnowledgeWriteBlocksFile as a, deepQuestionId as an, assertClaimLedgerId as at, encodeKnowledgeVisibilitySnapshot as b, withKnowledgeMutation as bn, resolveRunScopedCitation as bt, KnowledgeDuplicateIntakeError as c, materializeRegisteredClaimEvidence as cn, KnowledgeCitationAuditError as ct, createFileRunLineageAuthority as d, normalizeClaimText as dn, assertKnowledgeCitationAudit as dt, assertResearchClaimLedgerIntegrity as en, KB_CLAIM_LEDGER_DIR as et, createRunScopedStores as f, researchSourceVersionKey as fn, assertKnowledgeCitationsResolved as ft, assertSchemaVersion as g, inspectPendingKnowledgeMutation as gn, formatKnowledgeCitationReference as gt, KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION as h, acquireDurableFileLock as hn, auditKnowledgeCitations as ht, applyKnowledgeWriteBlocks as i, claimSourceHost as in, MemoryKbStore as it, detectNearDuplicatePages as j, canonicalPathsEqual as jn, extractWikilinks as jt, visibilityIdentity as k, DEFAULT_PAGES_DIRECTORY as kn, writeJson as kt, assertKnowledgeWriteIntake as l, mergeClaimLedgers as ln, KnowledgeCitationResolutionError as lt, KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM as m, parseFrontmatter as mn, auditCurrentRunCitations as mt, inspectKnowledgeIndex as n, claimEvidenceId as nn, KB_INDEX_PATH as nt, isSafeKnowledgePath as o, emptyClaimLedger as on, buildKnowledgeGraph as ot, originatedPages as p, formatFrontmatter as pn, assertRunScopedCitationsResolved as pt, addSourceText as q, writeJsonDurableWithinRoot as qn, ResearchSourceVersionSchema as qt, stringMetadata as r, claimId as rn, KB_STORE_DIR as rt, parseKnowledgeWriteBlocks as s, linkClaimContradictions as sn, knowledgePageRelations as st, explainKnowledgeTarget as t, assertTrackedClaimIntegrity as tn, KB_EVENTS_PATH as tt, RUN_LINEAGE_BASENAME as u, mergeTrackedClaims as un, assertCurrentRunCitationsResolved as ut, decodeKnowledgeVisibilitySnapshot as v, recoverPendingKnowledgeMutation as vn, resolveKnowledgeCitation as vt, normalizeVisibilityArtifact as w, commitKnowledgeFileMutations as wn, isKnowledgePagePath as wt, knowledgePageDigest as x, withKnowledgeRead as xn, resolveRunScopedCitations as xt, digest as y, runInKnowledgeMutationScope as yn, resolveKnowledgeCitations as yt, claimCheckKey as z, removeDurable as zn, KnowledgePageInvalidationSchema as zt };
+export { writeSourceRegistry as $, ClaimLedgerGoalConflictError as $t, verifyKnowledgeVisibilitySnapshot as A, rollbackKnowledgeFileTransaction as An, loadKnowledgePages as At, assertGradeableEvidence as B, relativeWithinRoot as Bn, KnowledgeIndexSchema as Bt, knowledgePageDigest as C, withKnowledgeRead as Cn, resolveRunScopedCitations as Ct, normalizeVisibilityRef as D, finishKnowledgeFileTransaction as Dn, isScaffoldPath as Dt, normalizeVisibilityArtifact as E, commitKnowledgeFileMutations as En, isKnowledgePagePath as Et, validateKnowledgeIndex as F, isKernelAnchoredPath as Fn, DeepQuestionSchema as Ft, verifyGradeableEvidence as G, withSafeDirectory as Gn, KnowledgeRelationSchema as Gt, gradeClaims as H, renameDurable as Hn, KnowledgePageSchema as Ht, lintKnowledgeIndex as I, isMissingFile as In, KnowledgeBaseCandidateSchema as It, addSourcePath as J, writeJsonDurable as Jn, ResearchClaimRecordSchema as Jt, buildKnowledgeIndex as K, writeFileDurable as Kn, ResearchClaimEvidenceSchema as Kt, CHECKABLE_RUNG_THRESHOLD as L, listRegularFilesWithinRoot as Ln, KnowledgeEventSchema as Lt, visibilityIndexOf as M, normalizePagesDirectory as Mn, WIKILINK_REGEX as Mt, detectNearDuplicatePages as N, canonicalPathsEqual as Nn, extractWikilinks as Nt, validateKnowledgePage as O, knowledgeFileTransactionPlanHash as On, knowledgePageFromMarkdown as Ot, normalizePageText as P, canonicalRelativeWithinRoot as Pn, normalizeLinkTarget as Pt, sourceRegistryPath as Q, KNOWLEDGE_EVENT_TYPES as Qt, DEADLINE_EXIT_CODE as R, readRegularFileNoFollow as Rn, KnowledgeGraphEdgeSchema as Rt, encodeKnowledgeVisibilitySnapshot as S, withKnowledgeMutation as Sn, resolveRunScopedCitation as St, nonEmpty as T, assertKnowledgeMutationPath as Tn, initKnowledgeBase as Tt, gradeFor as U, syncDirectory as Un, KnowledgeRelationGraphSchema as Ut, claimCheckKey as V, removeDurable as Vn, KnowledgePageInvalidationSchema as Vt, verdictFor as W, withSafeDescendant as Wn, KnowledgeRelationNodeSchema as Wt, loadSourceRegistry as X, mediaTypeFor$1 as Xn, SourceAnchorSchema as Xt, addSourceText as Y, writeJsonDurableWithinRoot as Yn, ResearchSourceVersionSchema as Yt, snapshotSourceTextInput as Z, textSourceAdapter as Zn, SourceRecordSchema as Zt, KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION as _, acquireDurableFileLock as _n, auditKnowledgeCitations as _t, applyKnowledgeWriteBlocksFile as a, claimId as an, KB_STORE_DIR as at, decodeKnowledgeVisibilitySnapshot as b, recoverPendingKnowledgeMutation as bn, resolveKnowledgeCitation as bt, KnowledgeDuplicateIntakeError as c, emptyClaimLedger as cn, buildKnowledgeGraph as ct, createFileRunLineageAuthority as d, mergeClaimLedgers as dn, KnowledgeCitationResolutionError as dt, assertDeepQuestionIntegrity as en, ClaimLedgerMigrationRequiredError as et, createRunScopedStores as f, mergeTrackedClaims as fn, assertCurrentRunCitationsResolved as ft, KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM as g, parseFrontmatter as gn, auditCurrentRunCitations as gt, originatedPages as h, formatFrontmatter as hn, assertRunScopedCitationsResolved as ht, applyKnowledgeWriteBlocks as i, claimEvidenceId as in, KB_INDEX_PATH as it, visibilityIdentity as j, DEFAULT_PAGES_DIRECTORY as jn, writeJson as jt, validateOrigin as k, prepareKnowledgeFileTransaction as kn, layoutFor as kt, assertKnowledgeWriteIntake as l, linkClaimContradictions as ln, knowledgePageRelations as lt, loadKnowledgeToolChain as m, researchSourceVersionKey as mn, assertKnowledgeCitationsResolved as mt, inspectKnowledgeIndex as n, assertResearchClaimLedgerIntegrity as nn, KB_CLAIM_LEDGER_DIR as nt, isSafeKnowledgePath as o, claimSourceHost as on, MemoryKbStore as ot, isKnowledgeToolChain as p, normalizeClaimText as pn, assertKnowledgeCitationAudit as pt, writeKnowledgeIndex as q, writeFileDurableWithinRoot as qn, ResearchClaimLedgerSchema as qt, stringMetadata as r, assertTrackedClaimIntegrity as rn, KB_EVENTS_PATH as rt, parseKnowledgeWriteBlocks as s, deepQuestionId as sn, assertClaimLedgerId as st, explainKnowledgeTarget as t, assertResearchClaimEvidenceIntegrity as tn, FileSystemKbStore as tt, RUN_LINEAGE_BASENAME as u, materializeRegisteredClaimEvidence as un, KnowledgeCitationAuditError as ut, assertSchemaVersion as v, inspectPendingKnowledgeMutation as vn, formatKnowledgeCitationReference as vt, knowledgeVisibilityArtifactRef as w, applyKnowledgeFileTransaction as wn, SCAFFOLD_PAGE_BASENAMES as wt, digest as x, runInKnowledgeMutationScope as xn, resolveKnowledgeCitations as xt, createKnowledgeVisibilitySnapshot as y, isKnowledgeMutationHeld as yn, parseKnowledgeCitationReference as yt, UncheckableClaimError as z, readRegularFileWithinRoot as zn, KnowledgeGraphNodeSchema as zt };
 
-//# sourceMappingURL=inspect-C6YK7af7.js.map
+//# sourceMappingURL=inspect-CwIvMcno.js.map