@tangle-network/agent-knowledge 15.0.3 → 17.0.0

package/dist/{inspect-DMZXOQYl.js → inspect-Dn7xCZLn.js}

@@ -400,6 +400,7 @@ const transactionSchema = z.object({
 	recoveryOwner: z.string().min(1).max(256).optional(),
 	pagesDirectory: pagesDirectorySchema.optional(),
 	researchState: z.boolean().optional(),
+	retainHistory: z.boolean().optional(),
 	createdAt: z.string().min(1),
 	entries: z.array(transactionEntrySchema).min(1)
 }).strict();
@@ -457,6 +458,7 @@ async function prepareKnowledgeFileTransaction(input) {
 				...input.recoveryOwner ? { recoveryOwner: input.recoveryOwner } : {},
 				...pagesDirectory === void 0 ? {} : { pagesDirectory },
 				...input.researchState === void 0 ? {} : { researchState: input.researchState },
+				...input.retainHistory === void 0 ? {} : { retainHistory: input.retainHistory },
 				createdAt: (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString(),
 				entries: changed.map((item) => item.entry)
 			});
@@ -492,6 +494,7 @@ async function commitKnowledgeFileMutations(input) {
 		purpose: input.purpose,
 		mutations: input.mutations,
 		...input.researchState === void 0 ? {} : { researchState: input.researchState },
+		...input.retainHistory === void 0 ? {} : { retainHistory: input.retainHistory },
 		...input.pagesDirectory === void 0 ? {} : { pagesDirectory: input.pagesDirectory },
 		now: input.now
 	});
@@ -580,6 +583,10 @@ async function finishKnowledgeFileTransaction(input) {
 	assertTransactionEntries(transaction);
 	await withTransactionRoot(input.root, input.transactionRoot, false, async (transactionRoot) => {
 		const activeName = activeTransactionDirectoryName(transaction.transactionId);
+		if (transaction.retainHistory === true && !(await activeTransactionDirectoryNames(transactionRoot)).includes(activeName) && await hasRetainedTransaction(input.root, transaction)) {
+			await syncDirectory(transactionRoot);
+			return;
+		}
 		await withTransactionDirectory(input.root, input.transactionRoot, transaction, async (transactionDir) => {
 			await assertActiveTransaction(transactionDir, transaction);
 			input.assertOwned?.();
@@ -592,13 +599,34 @@ async function finishKnowledgeFileTransaction(input) {
 				await assertKnowledgeFileTransactionTerminal(input.root, transaction, currentDirection);
 			});
 		});
-		await rm(join(transactionRoot, activeName), {
+		if (transaction.retainHistory === true) await withSafeDirectory(input.root, ".agent-knowledge/history", true, async (historyRoot) => {
+			await renameDurable(join(transactionRoot, activeName), join(historyRoot, transaction.transactionId));
+		});
+		else await rm(join(transactionRoot, activeName), {
 			recursive: true,
 			force: false
 		});
 		await syncDirectory(transactionRoot);
 	});
 }
+async function hasRetainedTransaction(root, transaction) {
+	try {
+		return await withSafeDirectory(root, `.agent-knowledge/history/${transaction.transactionId}`, false, async (historyDir) => {
+			await assertActiveTransaction(historyDir, transaction);
+			await readTransactionDirection(historyDir, transaction);
+			for (const entry of transaction.entries) for (const side of ["before", "after"]) {
+				const expected = side === "before" ? entry.beforeHash : entry.afterHash;
+				if (expected === null) continue;
+				if (hashBytes((await readRegularFileNoFollow(snapshotPath(historyDir, side, entry.index))).bytes) !== expected) throw new Error(`retained knowledge snapshot changed: ${entry.path}`);
+			}
+			await syncDirectory(historyDir);
+			return true;
+		});
+	} catch (error) {
+		if (isMissingFile(error)) return false;
+		throw error;
+	}
+}
 async function rollbackKnowledgeFileTransaction(input) {
 	await withTransactionDirectory(input.root, input.transactionRoot, input.transaction, async (transactionDir) => {
 		const transaction = transactionSchema.parse(input.transaction);
@@ -3594,12 +3622,12 @@ function originatedPages(pages, origin = "here") {
 	}));
 }
 const RUN_LINEAGE_BASENAME = "lineage.json";
-/** Ancestry beyond this bound is invalid durable state. */
-const MAX_LINEAGE_HOPS = 64;
 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");
 	if (options.runStorePath !== void 0 && typeof options.runStorePath !== "function") throw new TypeError("createRunScopedStores runStorePath must be a function when present");
+	const maxAncestors = options.maxAncestors;
+	if (maxAncestors !== void 0 && (!Number.isSafeInteger(maxAncestors) || maxAncestors < 0)) throw new TypeError("createRunScopedStores maxAncestors must be a non-negative safe integer");
 	if (options.lineageAuthority !== void 0) validateLineageAuthority(options.lineageAuthority);
 	const pagesDirectory = normalizePagesDirectory(options.pagesDirectory);
 	const storePath = options.runStorePath ?? ((runId) => join(options.root, runId, "knowledge-base"));
@@ -3610,16 +3638,16 @@ function createRunScopedStores(options) {
 		const chain = [];
 		const seen = /* @__PURE__ */ new Set([runId]);
 		let current = runId;
-		for (let hop = 0; hop <= MAX_LINEAGE_HOPS; hop += 1) {
+		for (;;) {
 			const parent = await authority.parentOf(current);
 			if (parent === null) return chain;
 			assertRunId(parent, `parent of '${current}'`);
 			if (seen.has(parent)) throw new Error(`run lineage cycle: ${parent} is its own ancestor (via ${runId})`);
+			if (maxAncestors !== void 0 && chain.length >= maxAncestors) throw new Error(`run lineage for '${runId}' exceeds caller maxAncestors=${maxAncestors}`);
 			seen.add(parent);
 			chain.push(parent);
 			current = parent;
 		}
-		throw new Error(`run lineage for '${runId}' exceeds ${MAX_LINEAGE_HOPS} ancestors`);
 	};
 	return {
 		storePath(runId) {
@@ -3930,6 +3958,7 @@ async function applyKnowledgeWriteBlocks(root, proposalText, options = {}) {
 				purpose,
 				mutations,
 				pagesDirectory,
+				retainHistory: options.retainHistory,
 				assertOwned: lock.assertOwned
 			});
 		}
@@ -4022,4 +4051,4 @@ function explainKnowledgeTarget(index, target) {
 //#endregion
 export { formatKnowledgeCitationReference as $, inspectPendingKnowledgeMutation as $t, addSourceText as A, writeJsonDurableWithinRoot as An, ResearchSourceVersionSchema as At, KB_STORE_DIR as B, claimId as Bt, gradeClaims as C, renameDurable as Cn, KnowledgePageSchema as Ct, buildKnowledgeIndex as D, writeFileDurable as Dn, ResearchClaimEvidenceSchema as Dt, verifyGradeableEvidence as E, withSafeDirectory as En, KnowledgeRelationSchema as Et, ClaimLedgerMigrationRequiredError as F, assertDeepQuestionIntegrity as Ft, KnowledgeCitationAuditError as G, materializeRegisteredClaimEvidence as Gt, assertClaimLedgerId as H, deepQuestionId as Ht, FileSystemKbStore as I, assertResearchClaimEvidenceIntegrity as It, assertKnowledgeCitationAudit as J, normalizeClaimText as Jt, KnowledgeCitationResolutionError as K, mergeClaimLedgers as Kt, KB_CLAIM_LEDGER_DIR as L, assertResearchClaimLedgerIntegrity as Lt, snapshotSourceTextInput as M, textSourceAdapter as Mn, SourceRecordSchema as Mt, sourceRegistryPath as N, KNOWLEDGE_EVENT_TYPES as Nt, writeKnowledgeIndex as O, writeFileDurableWithinRoot as On, ResearchClaimLedgerSchema as Ot, writeSourceRegistry as P, ClaimLedgerGoalConflictError as Pt, auditKnowledgeCitations as Q, acquireDurableFileLock as Qt, KB_EVENTS_PATH as R, assertTrackedClaimIntegrity as Rt, claimCheckKey as S, removeDurable as Sn, KnowledgePageInvalidationSchema as St, verdictFor as T, withSafeDescendant as Tn, KnowledgeRelationNodeSchema as Tt, buildKnowledgeGraph as U, emptyClaimLedger as Ut, MemoryKbStore as V, claimSourceHost as Vt, knowledgePageRelations as W, linkClaimContradictions as Wt, assertRunScopedCitationsResolved as X, formatFrontmatter as Xt, assertKnowledgeCitationsResolved as Y, researchSourceVersionKey as Yt, auditCurrentRunCitations as Z, parseFrontmatter as Zt, lintKnowledgeIndex as _, isMissingFile as _n, KnowledgeBaseCandidateSchema as _t, applyKnowledgeWriteBlocksFile as a, applyKnowledgeFileTransaction as an, SCAFFOLD_PAGE_BASENAMES as at, UncheckableClaimError as b, readRegularFileWithinRoot as bn, KnowledgeGraphNodeSchema as bt, KnowledgeDuplicateIntakeError as c, finishKnowledgeFileTransaction as cn, isScaffoldPath as ct, createFileRunLineageAuthority as d, rollbackKnowledgeFileTransaction as dn, loadKnowledgePages as dt, isKnowledgeMutationHeld as en, parseKnowledgeCitationReference as et, createRunScopedStores as f, DEFAULT_PAGES_DIRECTORY as fn, writeJson as ft, validateKnowledgeIndex as g, isKernelAnchoredPath as gn, DeepQuestionSchema as gt, normalizePageText as h, canonicalRelativeWithinRoot as hn, normalizeLinkTarget as ht, applyKnowledgeWriteBlocks as i, withKnowledgeRead as in, resolveRunScopedCitations as it, loadSourceRegistry as j, mediaTypeFor$1 as jn, SourceAnchorSchema as jt, addSourcePath as k, writeJsonDurable as kn, ResearchClaimRecordSchema as kt, assertKnowledgeWriteIntake as l, knowledgeFileTransactionPlanHash as ln, knowledgePageFromMarkdown as lt, detectNearDuplicatePages as m, canonicalPathsEqual as mn, extractWikilinks as mt, inspectKnowledgeIndex as n, runInKnowledgeMutationScope as nn, resolveKnowledgeCitations as nt, isSafeKnowledgePath as o, assertKnowledgeMutationPath as on, initKnowledgeBase as ot, originatedPages as p, normalizePagesDirectory as pn, WIKILINK_REGEX as pt, assertCurrentRunCitationsResolved as q, mergeTrackedClaims as qt, stringMetadata as r, withKnowledgeMutation as rn, resolveRunScopedCitation as rt, parseKnowledgeWriteBlocks as s, commitKnowledgeFileMutations as sn, isKnowledgePagePath as st, explainKnowledgeTarget as t, recoverPendingKnowledgeMutation as tn, resolveKnowledgeCitation as tt, RUN_LINEAGE_BASENAME as u, prepareKnowledgeFileTransaction as un, layoutFor as ut, CHECKABLE_RUNG_THRESHOLD as v, listRegularFilesWithinRoot as vn, KnowledgeEventSchema as vt, gradeFor as w, syncDirectory as wn, KnowledgeRelationGraphSchema as wt, assertGradeableEvidence as x, relativeWithinRoot as xn, KnowledgeIndexSchema as xt, DEADLINE_EXIT_CODE as y, readRegularFileNoFollow as yn, KnowledgeGraphEdgeSchema as yt, KB_INDEX_PATH as z, claimEvidenceId as zt };
 
-//# sourceMappingURL=inspect-DMZXOQYl.js.map
+//# sourceMappingURL=inspect-Dn7xCZLn.js.map