@tangle-network/agent-knowledge 22.0.16 → 23.0.0

package/dist/{inspect-rXk5_r3K.js → inspect-tl0P7I7w.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-aZdP2685.js";
+import { i as textSourceId, n as slugify, r as stableId, t as sha256 } from "./ids-C-Z2Uv4c.js";
+import { r as searchKnowledge } from "./search-BSGm7yxu.js";
 import { canonicalCandidateBytes, canonicalCandidateDigest, sha256Bytes, sha256DigestSchema } from "@tangle-network/agent-interface";
 import { contentHash } from "@tangle-network/agent-eval";
 import { z } from "zod";
@@ -10,7 +10,7 @@ import { basename, dirname, isAbsolute, join, relative, resolve } from "node:pat
 import { lockHolderVerdict, lockIdentity, readLockHolderIdentity } from "@tangle-network/agent-eval/lock-holder";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { hostname } from "node:os";
-//#region src/adapters.ts
+// src/adapters.ts
 const textSourceAdapter = {
 	id: "text",
 	canLoad: (input) => Boolean(input.text) || /\.(md|txt|json|csv)$/i.test(input.uri),
@@ -53,8 +53,7 @@ function anchorsForText(uri, text) {
 	});
 	return anchors;
 }
-//#endregion
-//#region src/durable-fs.ts
+// src/durable-fs.ts
 const DIRECTORY_FLAGS = constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW;
 const CREATE_FILE_FLAGS = constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW;
 const READ_FILE_FLAGS = constants.O_RDONLY | constants.O_NOFOLLOW;
@@ -378,8 +377,7 @@ function normalizeRelativePath(path) {
 	if (normalized.split("/").some((part) => part === "" || part === "." || part === "..")) throw new Error(`knowledge path contains an unsafe segment: ${path}`);
 	return normalized;
 }
-//#endregion
-//#region src/pages-directory.ts
+// src/pages-directory.ts
 /** Root-relative directory that holds Markdown pages when a caller names none. */
 const DEFAULT_PAGES_DIRECTORY = "knowledge";
 /**
@@ -401,8 +399,7 @@ function normalizePagesDirectory(value = DEFAULT_PAGES_DIRECTORY) {
 	if (segments[0] === ".agent-knowledge" || segments[0] === "raw") throw new Error(`pagesDirectory must not name the package-owned ${segments[0]} tree: ${value}`);
 	return normalized;
 }
-//#endregion
-//#region src/lock-holder.ts
+// src/lock-holder.ts
 const DEFAULT_STALE_MS = 9e5;
 /** The lease a caller's `staleMs` resolves to: the default, floored at 5 s. */
 function staleWindow(staleMs) {
@@ -574,8 +571,7 @@ async function takeOverDeadHolder(cacheDir, staleMs, held = STORE_LOCK) {
 		await release().catch(() => void 0);
 	}
 }
-//#endregion
-//#region src/bounded-file-io.ts
+// src/bounded-file-io.ts
 /** Keep filesystem descriptors bounded and drain a failed batch before its owner releases handles. */
 async function mapFileIo(values, operation) {
 	const results = [];
@@ -587,8 +583,7 @@ async function mapFileIo(values, operation) {
 	}
 	return results;
 }
-//#endregion
-//#region src/file-transaction.ts
+// src/file-transaction.ts
 const digestSchema = z.string().regex(/^[a-f0-9]{64}$/);
 const fileModeSchema = z.number().int().min(0).max(511);
 const DEFAULT_FILE_MODE = 420;
@@ -1056,8 +1051,7 @@ function sameBytes(left, right) {
 function fileMatches(file, hash, mode) {
 	return (file ? hashBytes(file.bytes) : null) === hash && file?.mode === mode;
 }
-//#endregion
-//#region src/mutation-lock.ts
+// src/mutation-lock.ts
 const DEFAULT_READ_WAIT_MS = 25;
 const MAX_POLL_MS = 250;
 function sleep(ms) {
@@ -1608,8 +1602,7 @@ async function hasActiveMutationLock(root, options) {
 function isOdd(value) {
 	return value % 2 === 1;
 }
-//#endregion
-//#region src/frontmatter.ts
+// src/frontmatter.ts
 function parseFrontmatter(content) {
 	const normalized = content.replace(/\r\n/g, "\n");
 	if (!normalized.startsWith("---\n")) return {
@@ -1702,8 +1695,7 @@ function unquote(value) {
 	if ((first === "\"" || first === "'") && value.endsWith(first)) return value.slice(1, -1);
 	return value;
 }
-//#endregion
-//#region src/claim-ledger.ts
+// src/claim-ledger.ts
 /**
 * The algebra of a research claim ledger: claim identity, and how two ledgers
 * that accumulated evidence for the same goal combine into one.
@@ -2087,8 +2079,7 @@ function assertSortedUnique(label, values) {
 function sameStrings(left, right) {
 	return left.length === right.length && left.every((value, index) => value === right[index]);
 }
-//#endregion
-//#region src/types.ts
+// src/types.ts
 /**
 * The event vocabulary, as a value so the runtime schema is DERIVED from it
 * rather than restated. A restated copy in `schemas.ts` drifted: it omitted
@@ -2106,8 +2097,7 @@ const KNOWLEDGE_EVENT_TYPES = [
 	"release.promoted",
 	"release.rejected"
 ];
-//#endregion
-//#region src/schemas.ts
+// src/schemas.ts
 const SourceAnchorSchema = z.object({
 	id: z.string().min(1),
 	sourceId: z.string().min(1),
@@ -2296,8 +2286,7 @@ const KnowledgeBaseCandidateSchema = z.object({
 	updatePolicy: z.string().optional(),
 	metadata: z.record(z.string(), z.unknown()).optional()
 });
-//#endregion
-//#region src/wikilinks.ts
+// src/wikilinks.ts
 const WIKILINK_REGEX = /\[\[([^\]|]+?)(?:\|[^\]]+?)?\]\]/g;
 function extractWikilinks(content) {
 	const links = [];
@@ -2313,8 +2302,7 @@ function extractWikilinks(content) {
 function normalizeLinkTarget(target) {
 	return target.trim().replace(/\.md$/i, "").toLowerCase().replace(/\s+/g, "-");
 }
-//#endregion
-//#region src/store.ts
+// src/store.ts
 function layoutFor(root) {
 	return {
 		root,
@@ -2458,8 +2446,7 @@ function idListField(value) {
 function firstHeading(body) {
 	return /^#\s+(.+)$/m.exec(body)?.[1]?.trim();
 }
-//#endregion
-//#region src/citation-resolution.ts
+// src/citation-resolution.ts
 /** A batch contains at least one citation that is missing or ambiguous. */
 var KnowledgeCitationResolutionError = class extends Error {
 	resolutions;
@@ -2631,8 +2618,7 @@ function isPageOrigin(value) {
 	if (value === "here" || value === "shared") return true;
 	return typeof value === "string" && value.startsWith("inherited:") && value.slice(10).trim().length > 0;
 }
-//#endregion
-//#region src/graph.ts
+// src/graph.ts
 /**
 * The labeled relations between pages, one per `(sourceId, targetId, predicate)`.
 *
@@ -2766,8 +2752,7 @@ function citedPageId(persisted) {
 		return persisted;
 	}
 }
-//#endregion
-//#region src/event-store.ts
+// src/event-store.ts
 /** Durable immutable event payloads with bounded, hash-partitioned metadata buckets. */
 const stateSchema = z.object({
 	version: z.literal(1),
@@ -3009,8 +2994,7 @@ function parseBucket(prefix, bytes, sequence) {
 	}
 	return bucket;
 }
-//#endregion
-//#region src/kb-store.ts
+// src/kb-store.ts
 /**
 * Where a filesystem knowledge base keeps its machine-written records, relative
 * to the knowledge-base root.
@@ -3309,8 +3293,7 @@ function isRecord(value) {
 function clone(value) {
 	return value == null ? value : JSON.parse(JSON.stringify(value));
 }
-//#endregion
-//#region src/sources.ts
+// src/sources.ts
 const sourceRegistrySchema = z.object({
 	generatedAt: z.string().min(1),
 	sources: z.array(SourceRecordSchema.passthrough())
@@ -3530,8 +3513,7 @@ function textPreview(fileName, bytes) {
 	if (!mediaType.startsWith("text/") && mediaType !== "application/json") return void 0;
 	return bytes.toString("utf8").slice(0, 2e5);
 }
-//#endregion
-//#region src/indexer.ts
+// src/indexer.ts
 async function buildKnowledgeIndex(root, options = {}) {
 	return withKnowledgeRead(root, () => buildKnowledgeIndexUnlocked(root, options));
 }
@@ -3561,8 +3543,7 @@ async function writeKnowledgeIndex(root, options = {}) {
 		return index;
 	});
 }
-//#endregion
-//#region src/claim-evidence.ts
+// src/claim-evidence.ts
 /** The rung at and above which a claim must be machine-checkable to be recorded at that rung. */
 const CHECKABLE_RUNG_THRESHOLD = 4;
 /**
@@ -3913,8 +3894,7 @@ async function runCheckProcess(args, options) {
 		...result.outputTruncated ? { outputTruncated: true } : {}
 	};
 }
-//#endregion
-//#region src/lint.ts
+// src/lint.ts
 const ABSOLUTE_PATH_TOKEN = /(?:^|[\s"'=(])(?:\/(?!dev\/null\b)[^\s"'();]+|[A-Za-z]:\\[^\s"'();]+)/m;
 function lintKnowledgeIndex(index) {
 	const findings = [];
@@ -4127,8 +4107,7 @@ function extractSourceRefs(text) {
 	}
 	return refs;
 }
-//#endregion
-//#region src/validate.ts
+// src/validate.ts
 function validateKnowledgeIndex(index, options = {}) {
 	return prepareKnowledgeValidation(index).validate(options);
 }
@@ -4162,8 +4141,7 @@ function prepareKnowledgeValidation(index) {
 		}
 	};
 }
-//#endregion
-//#region src/rag-eval/near-duplicates.ts
+// src/rag-eval/near-duplicates.ts
 /**
 * Detect exact and near-duplicate pages without a model, embedding service, or clock.
 *
@@ -4324,8 +4302,7 @@ function nonNegativeInteger(value, name) {
 function round(value) {
 	return Math.round(value * 1e6) / 1e6;
 }
-//#endregion
-//#region src/knowledge-visibility.ts
+// src/knowledge-visibility.ts
 const KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION = "2.0.0";
 const KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM = "rfc8785-sha256";
 /** Stable content identity for one exact knowledge page. */
@@ -4567,8 +4544,7 @@ function nonEmpty(value, label) {
 	if (typeof value !== "string" || value.trim().length === 0) throw new TypeError(`${label} must be a non-empty string`);
 	return value.trim();
 }
-//#endregion
-//#region src/run-scoped.ts
+// src/run-scoped.ts
 /**
 * Run-scoped knowledge stores with lineage-chain reads.
 *
@@ -4870,8 +4846,7 @@ function assertRunId(value, label = "runId") {
 function renderParent(parentRunId) {
 	return parentRunId === null ? "none" : `'${parentRunId}'`;
 }
-//#endregion
-//#region src/write-intake.ts
+// src/write-intake.ts
 /**
 * Write-time intake gate.
 *
@@ -4959,8 +4934,7 @@ function declaresRelation(page, targetId) {
 	for (const persisted of page.cites ?? []) if (parseKnowledgeCitationReference(persisted).pageId === targetId) return true;
 	return (page.contradicts ?? []).includes(targetId);
 }
-//#endregion
-//#region src/write-protocol.ts
+// src/write-protocol.ts
 const OPENER_LINE = /^---\s*FILE:\s*(.+?)\s*---\s*$/i;
 const CLOSER_LINE = /^---\s*END\s+FILE\s*---\s*$/i;
 const FENCE_LINE = /^\s{0,3}(```+|~~~+)/;
@@ -5035,8 +5009,7 @@ function parseKnowledgeWriteBlocks(text, allowedPrefixes = ["knowledge/"]) {
 		warnings
 	};
 }
-//#endregion
-//#region src/proposals.ts
+// src/proposals.ts
 /**
 * Apply the FILE blocks of a proposal under the pages directory.
 *
@@ -5107,8 +5080,7 @@ async function applyKnowledgeWriteBlocks(root, proposalText, options = {}) {
 async function applyKnowledgeWriteBlocksFile(root, proposalPath, options = {}) {
 	return applyKnowledgeWriteBlocks(root, await readFile(proposalPath, "utf8"), options);
 }
-//#endregion
-//#region src/metadata.ts
+// src/metadata.ts
 /**
 * Read a string value from an optional metadata bag, returning `undefined`
 * when the key is absent or holds a non-string value. Shared by the readiness
@@ -5121,8 +5093,7 @@ function stringMetadata(metadata, key) {
 	const value = metadata?.[key];
 	return typeof value === "string" ? value : void 0;
 }
-//#endregion
-//#region src/inspect.ts
+// src/inspect.ts
 function inspectKnowledgeIndex(index, options = {}) {
 	const now = options.now ?? /* @__PURE__ */ new Date();
 	const findings = lintKnowledgeIndex(index);
@@ -5184,7 +5155,6 @@ function explainKnowledgeTarget(index, target) {
 		related
 	};
 }
-//#endregion
 export { loadSourceRegistry as $, writeFileDurableWithinRoot as $n, KNOWLEDGE_EVENT_TYPES as $t, validateKnowledgePage as A, finishKnowledgeFileTransaction as An, isScaffoldPath as At, CHECKABLE_RUNG_THRESHOLD as B, canonicalRelativeWithinRoot as Bn, KnowledgeEventSchema as Bt, immutablePageDigest as C, runInKnowledgeMutationScope as Cn, resolveKnowledgeCitation as Ct, normalizeVisibilityArtifact as D, applyKnowledgeFileTransaction as Dn, SCAFFOLD_PAGE_BASENAMES as Dt, nonEmpty as E, withKnowledgeRead as En, resolveRunScopedCitations as Et, detectNearDuplicatePages as F, recordLockOwner as Fn, WIKILINK_REGEX as Ft, gradeClaims as G, readRegularFileWithinRoot as Gn, KnowledgePageSchema as Gt, UncheckableClaimError as H, isMissingFile as Hn, KnowledgeGraphNodeSchema as Ht, normalizePageText as I, takeOverDeadHolder as In, extractWikilinks as It, verifyGradeableEvidence as J, renameDurable as Jn, ResearchClaimLedgerSchema as Jt, gradeFor as K, relativeWithinRoot as Kn, KnowledgeRelationSchema as Kt, prepareKnowledgeValidation as L, DEFAULT_PAGES_DIRECTORY as Ln, normalizeLinkTarget as Lt, verifyKnowledgeVisibilitySnapshot as M, prepareKnowledgeFileTransaction as Mn, layoutFor as Mt, visibilityIdentity as N, rollbackKnowledgeFileTransaction as Nn, loadKnowledgePages as Nt, normalizeVisibilityRef as O, assertKnowledgeMutationPath as On, initKnowledgeBase as Ot, visibilityIndexOf as P, RUN_LEASE as Pn, writeJson as Pt, addSourceText as Q, writeFileDurable as Qn, SourceRecordSchema as Qt, validateKnowledgeIndex as R, normalizePagesDirectory as Rn, DeepQuestionSchema as Rt, encodeKnowledgeVisibilitySnapshot as S, recoverPendingKnowledgeMutation as Sn, parseKnowledgeCitationReference as St, knowledgeVisibilityArtifactRef as T, withKnowledgeMutationLabel as Tn, resolveRunScopedCitation as Tt, assertGradeableEvidence as U, listRegularFilesWithinRoot as Un, KnowledgeIndexSchema as Ut, DEADLINE_EXIT_CODE as V, isKernelAnchoredPath as Vn, KnowledgeGraphEdgeSchema as Vt, claimCheckKey as W, readRegularFileNoFollow as Wn, KnowledgePageInvalidationSchema as Wt, writeKnowledgeIndex as X, withSafeDescendant as Xn, ResearchSourceVersionSchema as Xt, buildKnowledgeIndex as Y, syncDirectory as Yn, ResearchClaimRecordSchema as Yt, addSourcePath as Z, withSafeDirectory as Zn, SourceAnchorSchema as Zt, KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION as _, parseFrontmatter as _n, assertKnowledgeCitationsResolved as _t, applyKnowledgeWriteBlocksFile as a, claimEvidenceId as an, KB_CLAIM_LEDGER_DIR as at, decodeKnowledgeVisibilitySnapshot as b, isKnowledgeMutationHeld as bn, auditKnowledgeCitations as bt, KnowledgeDuplicateIntakeError as c, deepQuestionId as cn, KB_STORE_DIR as ct, createFileRunLineageAuthority as d, materializeRegisteredClaimEvidence as dn, buildKnowledgeGraph as dt, ClaimLedgerGoalConflictError as en, writeJsonDurable as er, snapshotSourceTextInput as et, createRunScopedStores as f, mergeClaimLedgers as fn, knowledgePageRelations as ft, KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM as g, formatFrontmatter as gn, assertKnowledgeCitationAudit as gt, originatedPages as h, researchSourceVersionKey as hn, assertCurrentRunCitationsResolved as ht, applyKnowledgeWriteBlocks as i, assertTrackedClaimIntegrity as in, FileSystemKbStore as it, validateOrigin as j, knowledgeFileTransactionPlanHash as jn, knowledgePageFromMarkdown as jt, snapshotImmutableVisibility as k, commitKnowledgeFileMutations as kn, isKnowledgePagePath as kt, assertKnowledgeWriteIntake as l, emptyClaimLedger as ln, MemoryKbStore as lt, loadKnowledgeToolChain as m, normalizeClaimText as mn, KnowledgeCitationResolutionError as mt, inspectKnowledgeIndex as n, assertResearchClaimEvidenceIntegrity as nn, mediaTypeFor$1 as nr, writeSourceRegistry as nt, isSafeKnowledgePath as o, claimId as on, KB_EVENTS_PATH as ot, isKnowledgeToolChain as p, mergeTrackedClaims as pn, KnowledgeCitationAuditError as pt, verdictFor as q, removeDurable as qn, ResearchClaimEvidenceSchema as qt, stringMetadata as r, assertResearchClaimLedgerIntegrity as rn, textSourceAdapter as rr, ClaimLedgerMigrationRequiredError as rt, parseKnowledgeWriteBlocks as s, claimSourceHost as sn, KB_INDEX_PATH as st, explainKnowledgeTarget as t, assertDeepQuestionIntegrity as tn, writeJsonDurableWithinRoot as tr, sourceRegistryPath as tt, RUN_LINEAGE_BASENAME as u, linkClaimContradictions as un, assertClaimLedgerId as ut, assertSchemaVersion as v, acquireDurableFileLock as vn, assertRunScopedCitationsResolved as vt, knowledgePageDigest as w, withKnowledgeMutation as wn, resolveKnowledgeCitations as wt, digest as x, measureKnowledgeMutation as xn, formatKnowledgeCitationReference as xt, createKnowledgeVisibilitySnapshot as y, inspectPendingKnowledgeMutation as yn, auditCurrentRunCitations as yt, lintKnowledgeIndex as z, canonicalPathsEqual as zn, KnowledgeBaseCandidateSchema as zt };
 
-//# sourceMappingURL=inspect-rXk5_r3K.js.map
+//# sourceMappingURL=inspect-tl0P7I7w.js.map