@tangle-network/agent-knowledge 17.0.2 → 17.1.0

package/dist/{inspect-DvPbG-kF.js → inspect-DrJnvx5Z.js}

@@ -1,5 +1,5 @@
 import { i as textSourceId, n as slugify, r as stableId, t as sha256 } from "./ids-Bevz_pXV.js";
-import { r as searchKnowledge } from "./search-Cw6eYfSd.js";
+import { r as searchKnowledge } from "./search-Cbyj2shJ.js";
 import { createHash, randomUUID } from "node:crypto";
 import { lstat, mkdir, mkdtemp, open, readFile, readdir, realpath, rename, rm } from "node:fs/promises";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
@@ -2027,15 +2027,29 @@ var KnowledgeCitationAuditError = class extends Error {
 		this.report = report;
 	}
 };
+const ENCODED_REFERENCE_PREFIX = "knowledge-ref:v1:";
 /**
 * Parse the persisted citation form.
 *
 * `page-id` is unqualified. `here::page-id`, `shared::page-id`, and
 * `inherited:<runId>::page-id` bind an intentional duplicate to one origin.
+* Ambiguous names use `knowledge-ref:v1:` plus a URI-encoded JSON [origin, pageId]
+* tuple (null origin means unqualified). Always use the formatter to mint handles.
+* Legacy percent sequences are literal; old records are not silently reinterpreted.
 */
 function parseKnowledgeCitationReference(value) {
 	if (typeof value !== "string" || value.trim().length === 0) throw new TypeError("persisted knowledge citation must be a non-empty string");
 	const normalized = value.trim();
+	if (normalized.startsWith(ENCODED_REFERENCE_PREFIX)) try {
+		const tuple = JSON.parse(decodeURIComponent(normalized.slice(17)));
+		if (!Array.isArray(tuple) || tuple.length !== 2) throw new TypeError("encoded citation must contain an origin/page tuple");
+		return normalizeReference({
+			pageId: tuple[1],
+			...tuple[0] === null ? {} : { origin: tuple[0] }
+		});
+	} catch (cause) {
+		throw new TypeError("invalid encoded knowledge citation", { cause });
+	}
 	const separator = normalized.indexOf("::");
 	if (separator < 0) return Object.freeze({ pageId: normalized });
 	const possibleOrigin = normalized.slice(0, separator);
@@ -2049,7 +2063,14 @@ function parseKnowledgeCitationReference(value) {
 /** Serialize one reference into the canonical frontmatter representation. */
 function formatKnowledgeCitationReference(reference) {
 	const normalized = normalizeReference(reference);
-	return normalized.origin === void 0 ? normalized.pageId : `${normalized.origin}::${normalized.pageId}`;
+	const legacy = normalized.origin === void 0 ? normalized.pageId : `${normalized.origin}::${normalized.pageId}`;
+	try {
+		const parsed = parseKnowledgeCitationReference(legacy);
+		if (parsed.pageId === normalized.pageId && parsed.origin === normalized.origin) return legacy;
+	} catch (error) {
+		if (!(error instanceof TypeError)) throw error;
+	}
+	return `${ENCODED_REFERENCE_PREFIX}${encodeURIComponent(JSON.stringify([normalized.origin ?? null, normalized.pageId]))}`;
 }
 /** Resolve one reference against an already materialized visibility chain. */
 function resolveKnowledgeCitation(visiblePages, reference) {
@@ -4053,4 +4074,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-DvPbG-kF.js.map
+//# sourceMappingURL=inspect-DrJnvx5Z.js.map