@tangle-network/agent-knowledge 8.0.10 → 10.6.0

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { A as SourceRegistry, C as KnowledgeWriteParseResult, D as ResearchSourceVersion, E as ResearchClaimRecord, O as SourceAnchor, S as KnowledgeWriteBlock, T as ResearchClaimLedger, _ as KnowledgePolicy, a as KnowledgeBaseCandidate, b as KnowledgeSearchResult, c as KnowledgeEventType, d as KnowledgeGraphNode, f as KnowledgeId, g as KnowledgePageInvalidation, h as KnowledgePage, i as KNOWLEDGE_EVENT_TYPES, j as TrackedClaim, k as SourceRecord, l as KnowledgeGraph, m as KnowledgeLintFinding, n as DeepQuestion, o as KnowledgeClaim, p as KnowledgeIndex, r as DeepQuestionKind, s as KnowledgeEvent, t as ClaimRef, u as KnowledgeGraphEdge, v as KnowledgeRelation, w as ResearchClaimEvidence, x as KnowledgeUnit, y as KnowledgeRelease } from "./types-CTT16XnO.js";
-import { $ as RetrievalConfig, A as KnowledgeBenchmarkResponder, At as AgentMemoryScope, B as KnowledgeMemoryEvent, Bt as RetrievalHoldoutSessionState, C as KnowledgeBenchmarkArtifact, Ct as createInMemoryBenchmarkAdapter, D as KnowledgeBenchmarkEvaluation, Dt as AgentMemoryContext, E as KnowledgeBenchmarkDistribution, Et as AgentMemoryBranchIsolation, F as KnowledgeBenchmarkSplit, Ft as RetrievalHoldoutCallContext, G as MemoryAdapterBenchmarkCandidate, H as KnowledgeRetrievalBenchmarkCase, I as KnowledgeBenchmarkTaskKind, It as RetrievalHoldoutConfig, J as RunKnowledgeBenchmarkSuiteResult, K as MemoryAdapterBenchmarkRankingRow, L as KnowledgeClaimMatcher, Lt as RetrievalHoldoutEligibleItem, M as KnowledgeBenchmarkSliceSummary, Mt as AgentMemoryWriteInput, N as KnowledgeBenchmarkSource, Nt as AgentMemoryWriteResult, O as KnowledgeBenchmarkFamily, Ot as AgentMemoryHit, P as KnowledgeBenchmarkSpec, Pt as RetrievalHoldoutBypassReason, Q as PartitionRetrievalScenariosOptions, R as KnowledgeMemoryBenchmarkCase, Rt as RetrievalHoldoutEvent, S as KnowledgeAnswerBenchmarkTaskKind, St as acquireAgentMemoryRunLease, T as KnowledgeBenchmarkCaseBase, Tt as AgentMemoryAdapter, U as KnowledgeRetrievalBenchmarkQrel, V as KnowledgeMemoryFactMatcher, W as KnowledgeRetrievalBenchmarkQuery, X as RunMemoryAdapterBenchmarkResult, Y as RunMemoryAdapterBenchmarkOptions, Z as BuildRetrievalEvalDispatchOptions, _ as buildIndustryRagBenchmarkSmokeCases, _t as scoreRetrievalArtifact, a as runKnowledgeBenchmarkSuite, at as RetrievalGoldTarget, b as BuildRetrievalBenchmarkCasesFromQrelsOptions, bt as AgentMemoryRunLease, c as buildRetrievalBenchmarkCasesFromQrels, ct as RetrievalRecallJudgeOptions, d as summarizeKnowledgeBenchmarkCampaign, dt as RetrievedSourceSpan, et as RetrievalEvalArtifact, f as runMemoryAdapterBenchmark, ft as buildRetrievalEvalDispatch, g as buildIndustryMemoryBenchmarkSmokeCases, gt as retrievalRecallJudge, h as buildFirstPartyMemoryLifecycleBenchmarkCases, ht as retrievalConfigSurface, i as renderKnowledgeBenchmarkReportMarkdown, it as RetrievalEvalScenario, j as KnowledgeBenchmarkScenario, jt as AgentMemorySearchOptions, k as KnowledgeBenchmarkReport, kt as AgentMemoryKind, l as parseKnowledgeBenchmarkJsonl, lt as RetrievalScenarioPartitions, m as INDUSTRY_RAG_BENCHMARKS, mt as retrievalConfigFromSurface, n as buildKnowledgeBenchmarkScenarios, nt as RetrievalEvalRetrieverInput, o as scoreKnowledgeBenchmarkArtifact, ot as RetrievalMetricSummary, p as INDUSTRY_MEMORY_BENCHMARKS, pt as partitionRetrievalScenarios, q as RunKnowledgeBenchmarkSuiteOptions, r as knowledgeBenchmarkJudge, rt as RetrievalEvalRetrieverResult, s as scoreMemoryBenchmarkArtifact, st as RetrievalMetricWeights, t as isKnowledgeMemoryBenchmarkCase, tt as RetrievalEvalRetriever, u as parseKnowledgeBenchmarkQrels, ut as RetrievedKnowledgeHit, v as respondToIndustryMemoryBenchmarkSmokeCase, vt as AgentMemoryAcquireRunLease, w as KnowledgeBenchmarkCase, wt as createNoopMemoryBenchmarkAdapter, x as KnowledgeAnswerBenchmarkCase, xt as OwnedAgentMemoryRunLease, y as respondToIndustryRagBenchmarkSmokeCase, yt as AgentMemoryControllerMode, z as KnowledgeMemoryBenchmarkTaskKind, zt as RetrievalHoldoutResult } from "./index-DypNCZtP.js";
-import { $ as runAgentMemoryLearningExperiment, $t as jsonObjectCandidateCodec, A as AgentMemoryFinalPair, At as BuildAgentMemorySequencesFromBenchmarkCasesOptions, B as applySessionStickyRetrievalHoldout, Bt as AgentMemorySharingPolicy, C as runBoundedMemoryLifecycle, Ct as AgentMemorySequenceArtifact, D as AgentMemoryActivationDriver, Dt as AgentMemorySequenceStep, E as AgentMemoryActivation, Et as AgentMemorySequenceScenario, F as RunAgentMemoryImprovementResult, Ft as RunAgentMemoryLearningExperimentResult, G as toOffPolicyTrajectory, Gt as forkAgentMemoryBranchSnapshot, H as emitRetrievalHoldoutBypass, Ht as CreateAgentMemoryBranchOptions, I as RetrievalHoldoutOffPolicyOptions, It as AgentMemoryBranch, J as GraphitiToolNames, Jt as RunSerializedKnowledgeOptimizationOptions, K as GraphitiMcpClientLike, Kt as defaultGetMemoryContext, L as RetrievalHoldoutOffPolicyResult, Lt as AgentMemoryBranchLifetime, M as AgentMemoryPromotionDecision, Mt as RunAgentMemoryExperimentOptions, N as MemoryConfigScenario, Nt as RunAgentMemoryExperimentResult, O as AgentMemoryDimensionComparison, Ot as AgentMemoryTransferCellComparison, P as RunAgentMemoryImprovementOptions, Pt as RunAgentMemoryLearningExperimentOptions, Q as compareAgentMemoryLearning, Qt as jsonCandidateCodec, R as RetrievalHoldoutSessionSummary, Rt as AgentMemoryBranchSnapshot, S as resolveMemoryCleanupTimeoutMs, St as AgentMemorySequence, T as runAgentMemoryImprovement, Tt as AgentMemorySequenceProbeResult, U as resetRetrievalHoldoutRegistry, Ut as ForkAgentMemoryBranchSnapshotOptions, V as deterministicRng, Vt as AgentMemoryVisibility, W as retrievalHoldoutConfigHash, Wt as createAgentMemoryBranch, X as graphitiMemoryAdapterIdentity, Xt as SerializedCandidate, Y as createGraphitiMemoryAdapter, Yt as RunSerializedKnowledgeOptimizationResult, Z as runAgentMemoryExperiment, Zt as SerializedCandidateCodec, _ as AgentMemoryLifecycleTimeoutError, _t as AgentMemoryLearningArmOrder, a as AgentMemoryScopeSchema, at as AgentMemoryExecutionContext, b as createMemoryExecutionPool, bt as AgentMemoryLearningComparison, c as createNeo4jAgentMemoryAdapter, ct as AgentMemoryExecutionPaidCallInput, d as Mem0HostedMemoryAdapterOptions, dt as AgentMemoryExperimentCandidate, en as runSerializedKnowledgeOptimization, et as agentMemorySequenceJudge, f as Mem0MemoryAdapterOptions, ft as AgentMemoryExperimentCandidateRef, g as mem0MemoryAdapterIdentity, gt as AgentMemoryForgettingComparison, h as createMem0MemoryAdapter, ht as AgentMemoryExperimentRunLease, i as AgentMemoryKindSchema, it as AgentMemoryEvidenceRef, j as AgentMemoryImprovementRunLease, jt as CompareAgentMemoryLearningOptions, k as AgentMemoryFinalEvaluation, kt as AgentMemoryTransferStepSummary, l as Mem0ClientMode, lt as AgentMemoryExecutionPaidCallResult, m as Mem0OssMemoryAdapterOptions, mt as AgentMemoryExperimentRankingRow, n as memoryWriteResultToSourceRecord, nt as buildAgentMemorySequencesFromBenchmarkCases, o as AgentMemoryWriteInputSchema, ot as AgentMemoryExecutionCostMeter, p as Mem0OssClient, pt as AgentMemoryExperimentComparisonRef, q as GraphitiMemoryAdapterOptions, qt as renderMemoryContext, r as AgentMemoryHitSchema, rt as AgentMemoryAttemptEvent, s as Neo4jAgentMemoryAdapterOptions, st as AgentMemoryExecutionCostReceipt, t as memoryHitToSourceRecord, tn as scenarioContentFingerprint, tt as buildAgentMemorySequenceScenarios, u as Mem0HostedClient, ut as AgentMemoryExecutionStep, v as AgentMemoryLifecycleUnsafeError, vt as AgentMemoryLearningCandidateSummary, w as sleepForMemoryRecovery, wt as AgentMemorySequenceProbe, x as memoryRecoveryDelayMs, xt as AgentMemoryMode, y as DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, yt as AgentMemoryLearningCellComparison, z as applyRetrievalHoldout, zt as AgentMemoryJournalEntry } from "./index-Ij4giqqj.js";
+import { A as SourceAnchor, C as KnowledgeUnit, D as ResearchClaimLedger, E as ResearchClaimEvidence, M as SourceRegistry, N as TrackedClaim, O as ResearchClaimRecord, S as KnowledgeSearchResult, T as KnowledgeWriteParseResult, _ as KnowledgePolicy, a as KnowledgeBaseCandidate, b as KnowledgeRelationNode, c as KnowledgeEventType, d as KnowledgeGraphNode, f as KnowledgeId, g as KnowledgePageInvalidation, h as KnowledgePage, i as KNOWLEDGE_EVENT_TYPES, j as SourceRecord, k as ResearchSourceVersion, l as KnowledgeGraph, m as KnowledgeLintFinding, n as DeepQuestion, o as KnowledgeClaim, p as KnowledgeIndex, r as DeepQuestionKind, s as KnowledgeEvent, t as ClaimRef, u as KnowledgeGraphEdge, v as KnowledgeRelation, w as KnowledgeWriteBlock, x as KnowledgeRelease, y as KnowledgeRelationGraph } from "./types-m2QB86fF.js";
+import { $ as RetrievalConfig, A as KnowledgeBenchmarkResponder, At as AgentMemoryScope, B as KnowledgeMemoryEvent, Bt as RetrievalHoldoutSessionState, C as KnowledgeBenchmarkArtifact, Ct as createInMemoryBenchmarkAdapter, D as KnowledgeBenchmarkEvaluation, Dt as AgentMemoryContext, E as KnowledgeBenchmarkDistribution, Et as AgentMemoryBranchIsolation, F as KnowledgeBenchmarkSplit, Ft as RetrievalHoldoutCallContext, G as MemoryAdapterBenchmarkCandidate, H as KnowledgeRetrievalBenchmarkCase, I as KnowledgeBenchmarkTaskKind, It as RetrievalHoldoutConfig, J as RunKnowledgeBenchmarkSuiteResult, K as MemoryAdapterBenchmarkRankingRow, L as KnowledgeClaimMatcher, Lt as RetrievalHoldoutEligibleItem, M as KnowledgeBenchmarkSliceSummary, Mt as AgentMemoryWriteInput, N as KnowledgeBenchmarkSource, Nt as AgentMemoryWriteResult, O as KnowledgeBenchmarkFamily, Ot as AgentMemoryHit, P as KnowledgeBenchmarkSpec, Pt as RetrievalHoldoutBypassReason, Q as PartitionRetrievalScenariosOptions, R as KnowledgeMemoryBenchmarkCase, Rt as RetrievalHoldoutEvent, S as KnowledgeAnswerBenchmarkTaskKind, St as acquireAgentMemoryRunLease, T as KnowledgeBenchmarkCaseBase, Tt as AgentMemoryAdapter, U as KnowledgeRetrievalBenchmarkQrel, V as KnowledgeMemoryFactMatcher, W as KnowledgeRetrievalBenchmarkQuery, X as RunMemoryAdapterBenchmarkResult, Y as RunMemoryAdapterBenchmarkOptions, Z as BuildRetrievalEvalDispatchOptions, _ as buildIndustryRagBenchmarkSmokeCases, _t as scoreRetrievalArtifact, a as runKnowledgeBenchmarkSuite, at as RetrievalGoldTarget, b as BuildRetrievalBenchmarkCasesFromQrelsOptions, bt as AgentMemoryRunLease, c as buildRetrievalBenchmarkCasesFromQrels, ct as RetrievalRecallJudgeOptions, d as summarizeKnowledgeBenchmarkCampaign, dt as RetrievedSourceSpan, et as RetrievalEvalArtifact, f as runMemoryAdapterBenchmark, ft as buildRetrievalEvalDispatch, g as buildIndustryMemoryBenchmarkSmokeCases, gt as retrievalRecallJudge, h as buildFirstPartyMemoryLifecycleBenchmarkCases, ht as retrievalConfigSurface, i as renderKnowledgeBenchmarkReportMarkdown, it as RetrievalEvalScenario, j as KnowledgeBenchmarkScenario, jt as AgentMemorySearchOptions, k as KnowledgeBenchmarkReport, kt as AgentMemoryKind, l as parseKnowledgeBenchmarkJsonl, lt as RetrievalScenarioPartitions, m as INDUSTRY_RAG_BENCHMARKS, mt as retrievalConfigFromSurface, n as buildKnowledgeBenchmarkScenarios, nt as RetrievalEvalRetrieverInput, o as scoreKnowledgeBenchmarkArtifact, ot as RetrievalMetricSummary, p as INDUSTRY_MEMORY_BENCHMARKS, pt as partitionRetrievalScenarios, q as RunKnowledgeBenchmarkSuiteOptions, r as knowledgeBenchmarkJudge, rt as RetrievalEvalRetrieverResult, s as scoreMemoryBenchmarkArtifact, st as RetrievalMetricWeights, t as isKnowledgeMemoryBenchmarkCase, tt as RetrievalEvalRetriever, u as parseKnowledgeBenchmarkQrels, ut as RetrievedKnowledgeHit, v as respondToIndustryMemoryBenchmarkSmokeCase, vt as AgentMemoryAcquireRunLease, w as KnowledgeBenchmarkCase, wt as createNoopMemoryBenchmarkAdapter, x as KnowledgeAnswerBenchmarkCase, xt as OwnedAgentMemoryRunLease, y as respondToIndustryRagBenchmarkSmokeCase, yt as AgentMemoryControllerMode, z as KnowledgeMemoryBenchmarkTaskKind, zt as RetrievalHoldoutResult } from "./index-DZeFm-BP.js";
+import { $ as runAgentMemoryLearningExperiment, $t as jsonObjectCandidateCodec, A as AgentMemoryFinalPair, At as BuildAgentMemorySequencesFromBenchmarkCasesOptions, B as applySessionStickyRetrievalHoldout, Bt as AgentMemorySharingPolicy, C as runBoundedMemoryLifecycle, Ct as AgentMemorySequenceArtifact, D as AgentMemoryActivationDriver, Dt as AgentMemorySequenceStep, E as AgentMemoryActivation, Et as AgentMemorySequenceScenario, F as RunAgentMemoryImprovementResult, Ft as RunAgentMemoryLearningExperimentResult, G as toOffPolicyTrajectory, Gt as forkAgentMemoryBranchSnapshot, H as emitRetrievalHoldoutBypass, Ht as CreateAgentMemoryBranchOptions, I as RetrievalHoldoutOffPolicyOptions, It as AgentMemoryBranch, J as GraphitiToolNames, Jt as RunSerializedKnowledgeOptimizationOptions, K as GraphitiMcpClientLike, Kt as defaultGetMemoryContext, L as RetrievalHoldoutOffPolicyResult, Lt as AgentMemoryBranchLifetime, M as AgentMemoryPromotionDecision, Mt as RunAgentMemoryExperimentOptions, N as MemoryConfigScenario, Nt as RunAgentMemoryExperimentResult, O as AgentMemoryDimensionComparison, Ot as AgentMemoryTransferCellComparison, P as RunAgentMemoryImprovementOptions, Pt as RunAgentMemoryLearningExperimentOptions, Q as compareAgentMemoryLearning, Qt as jsonCandidateCodec, R as RetrievalHoldoutSessionSummary, Rt as AgentMemoryBranchSnapshot, S as resolveMemoryCleanupTimeoutMs, St as AgentMemorySequence, T as runAgentMemoryImprovement, Tt as AgentMemorySequenceProbeResult, U as resetRetrievalHoldoutRegistry, Ut as ForkAgentMemoryBranchSnapshotOptions, V as deterministicRng, Vt as AgentMemoryVisibility, W as retrievalHoldoutConfigHash, Wt as createAgentMemoryBranch, X as graphitiMemoryAdapterIdentity, Xt as SerializedCandidate, Y as createGraphitiMemoryAdapter, Yt as RunSerializedKnowledgeOptimizationResult, Z as runAgentMemoryExperiment, Zt as SerializedCandidateCodec, _ as AgentMemoryLifecycleTimeoutError, _t as AgentMemoryLearningArmOrder, a as AgentMemoryScopeSchema, at as AgentMemoryExecutionContext, b as createMemoryExecutionPool, bt as AgentMemoryLearningComparison, c as createNeo4jAgentMemoryAdapter, ct as AgentMemoryExecutionPaidCallInput, d as Mem0HostedMemoryAdapterOptions, dt as AgentMemoryExperimentCandidate, en as runSerializedKnowledgeOptimization, et as agentMemorySequenceJudge, f as Mem0MemoryAdapterOptions, ft as AgentMemoryExperimentCandidateRef, g as mem0MemoryAdapterIdentity, gt as AgentMemoryForgettingComparison, h as createMem0MemoryAdapter, ht as AgentMemoryExperimentRunLease, i as AgentMemoryKindSchema, it as AgentMemoryEvidenceRef, j as AgentMemoryImprovementRunLease, jt as CompareAgentMemoryLearningOptions, k as AgentMemoryFinalEvaluation, kt as AgentMemoryTransferStepSummary, l as Mem0ClientMode, lt as AgentMemoryExecutionPaidCallResult, m as Mem0OssMemoryAdapterOptions, mt as AgentMemoryExperimentRankingRow, n as memoryWriteResultToSourceRecord, nt as buildAgentMemorySequencesFromBenchmarkCases, o as AgentMemoryWriteInputSchema, ot as AgentMemoryExecutionCostMeter, p as Mem0OssClient, pt as AgentMemoryExperimentComparisonRef, q as GraphitiMemoryAdapterOptions, qt as renderMemoryContext, r as AgentMemoryHitSchema, rt as AgentMemoryAttemptEvent, s as Neo4jAgentMemoryAdapterOptions, st as AgentMemoryExecutionCostReceipt, t as memoryHitToSourceRecord, tn as scenarioContentFingerprint, tt as buildAgentMemorySequenceScenarios, u as Mem0HostedClient, ut as AgentMemoryExecutionStep, v as AgentMemoryLifecycleUnsafeError, vt as AgentMemoryLearningCandidateSummary, w as sleepForMemoryRecovery, wt as AgentMemorySequenceProbe, x as memoryRecoveryDelayMs, xt as AgentMemoryMode, y as DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, yt as AgentMemoryLearningCellComparison, z as applyRetrievalHoldout, zt as AgentMemoryJournalEntry } from "./index-eDsIXWyM.js";
 import { CornellLiiSelector, CornellLiiSourceOptions, FetchOpts, FragmentProvenance, IRS_DIMENSION_HINTS, IrsPublicationsSourceOptions, KnowledgeFragment, KnowledgeSource, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, POLITE_USER_AGENT, PoliteFetchOptions, PoliteFetchResult, StateSosEntity, StateSosSourceConfig, __resetHttpThrottle, createCornellLiiSource, createIrsPublicationsSource, createStateSosSource, extractLinks, firstMatch, htmlToText, innerHtmlById, looksLikeBlockPage, politeFetch } from "./sources/index.js";
-import { AgentCandidateJsonValue, AgentCandidateKnowledgeRef, AgentImprovementActivation, AgentImprovementActivationResult, Sha256Digest } from "@tangle-network/agent-interface";
+import { AgentCandidateJsonValue, AgentCandidateKnowledgeRef, AgentImprovementActivation, AgentImprovementActivationResult, Sha256Digest, ToolDefinition } from "@tangle-network/agent-interface";
 import { AnalystFinding, AnalystSeverity, ControlEvalResult, ControlRuntimeConfig, DataAcquisitionPlan, DatasetScenario, GateDecision, KnowledgeAcquisitionMode, KnowledgeBundle, KnowledgeFreshness, KnowledgeImportance, KnowledgeReadinessReport, KnowledgeRequirement, KnowledgeRequirementCategory, KnowledgeSensitivity, ReleaseConfidenceScorecard, ReleaseTraceEvidence, RunRecord, UserQuestion } from "@tangle-network/agent-eval";
 import { z } from "zod";
 import { ComparisonCost, DispatchContext, JudgeConfig, OptimizationMethod, Scenario } from "@tangle-network/agent-eval/campaign";
@@ -600,13 +600,362 @@ interface RunRagOptimizationResult extends RunSerializedKnowledgeOptimizationRes
 /** Optimizes retrieval and answer behavior together as one serialized RAG configuration. */
 declare function runRagOptimization(options: RunRagOptimizationOptions): Promise<RunRagOptimizationResult>;
 //#endregion
+//#region src/pages-directory.d.ts
+/** Root-relative directory that holds Markdown pages when a caller names none. */
+declare const DEFAULT_PAGES_DIRECTORY = "knowledge";
+/**
+ * Selects the root-relative directory that holds Markdown pages.
+ *
+ * The same option drives the reader, the indexer, the search provider, the
+ * run-scoped chain, and the write protocol, so a store laid out as
+ * `kb/pages/<line>/` is read and written through one value.
+ */
+interface KnowledgePagesOptions {
+  /** Root-relative directory that holds Markdown pages. Defaults to `knowledge`. */
+  pagesDirectory?: string;
+}
+/**
+ * Validate a pages directory and return its canonical root-relative form.
+ *
+ * The result is a write allowlist prefix as well as a read location, so the
+ * check refuses every value that could reach outside the pages tree: absolute
+ * paths, drive letters, `..` or `.` segments, empty segments, control
+ * characters, and the package-owned `.agent-knowledge` and `raw` trees.
+ */
+declare function normalizePagesDirectory(value?: string): string;
+//#endregion
+//#region src/store.d.ts
+interface KnowledgeLayout {
+  root: string;
+  knowledgeDir: string;
+  rawSourcesDir: string;
+  sourceRegistryPath: string;
+  indexPath: string;
+  logPath: string;
+  cacheDir: string;
+}
+declare function layoutFor(root: string): KnowledgeLayout;
+/**
+ * Filenames that `initKnowledgeBase` writes as human-navigation scaffolding.
+ * These are excluded from the page index — they exist on disk so authors can
+ * curate their vault, but they are not searchable content.
+ *
+ * Add new scaffold filenames here (and only here) to keep lint, validate, viz,
+ * and the indexer consistent.
+ */
+declare const SCAFFOLD_PAGE_BASENAMES: readonly string[];
+/**
+ * True when a knowledge-relative path points at a scaffold file rather than
+ * authored content. Accepts both repo-relative paths (`knowledge/index.md`)
+ * and any nested `<dir>/index.md` or `<dir>/log.md` (for example
+ * `knowledge/concepts/index.md`) so subdirectory README-style scaffolds are
+ * also excluded.
+ */
+declare function isScaffoldPath(path: string): boolean;
+declare function initKnowledgeBase(root: string): Promise<KnowledgeLayout>;
+declare function loadKnowledgePages(root: string, options?: KnowledgePagesOptions): Promise<KnowledgePage[]>;
+/** True when a root-relative path names authored Markdown rather than scaffolding. */
+declare function isKnowledgePagePath(path: string): boolean;
+/**
+ * Build a page from the bytes of one Markdown file.
+ *
+ * The reader and every gate that inspects a page before it is written share
+ * this constructor, so what a gate judges is exactly what the store loads back.
+ */
+declare function knowledgePageFromMarkdown(path: string, content: string, pagesDirectory?: string): KnowledgePage;
+declare function writeJson(path: string, value: unknown): Promise<void>;
+//#endregion
+//#region src/run-scoped.d.ts
+/** Where a page in a chained read came from. */
+type PageOrigin = 'here' | `inherited:${string}` | 'shared';
+interface OriginatedPage {
+  page: KnowledgePage;
+  origin: PageOrigin;
+}
+/**
+ * Present plain pages as a visibility chain of one origin.
+ *
+ * A store read directly is the `here` origin of a chain with no ancestry, so
+ * the chain-shaped APIs — citation resolution, the write intake gate,
+ * invalidation propagation — take one page shape whether or not the caller
+ * runs run-scoped stores.
+ */
+declare function originatedPages(pages: readonly KnowledgePage[], origin?: PageOrigin): OriginatedPage[];
+interface RunLineageRecord {
+  runId: string;
+  parentRunId: string | null;
+  createdAt: string;
+}
+/**
+ * Durable authority for run ancestry.
+ *
+ * A product whose run manifest already owns lineage can supply an authority
+ * backed by that manifest. `record` is optional for read-only authorities; in
+ * that case `init` verifies that the existing authority agrees with the parent
+ * requested by the caller before creating any store files.
+ */
+interface RunLineageAuthority {
+  parentOf(runId: string): Promise<string | null>;
+  record?(record: RunLineageRecord): Promise<void>;
+}
+declare const RUN_LINEAGE_BASENAME = "lineage.json";
+interface RunScopedStoresOptions extends KnowledgePagesOptions {
+  /** The root under which per-run stores live. */
+  root: string;
+  /** Store path for a run; defaults to `<root>/<runId>/knowledge-base`. */
+  runStorePath?: (runId: string) => string;
+  /**
+   * The curated store every run may read but no run writes. Searched last and
+   * labeled `shared`.
+   */
+  sharedRoot?: string;
+  /** External owner for run ancestry. Defaults to a record inside each run store. */
+  lineageAuthority?: RunLineageAuthority;
+}
+interface RunScopedStores {
+  /** Create or open a run store and bind it to one exact parent identity. */
+  init(runId: string, options?: {
+    parentRunId?: string | null;
+  }): Promise<KnowledgeLayout>;
+  /**
+   * Where one run's store lives. A caller that must read a run's bytes rather
+   * than its parsed pages — promotion carries a page unchanged — needs the
+   * root the chain read hides.
+   */
+  storePath(runId: string): string;
+  /** The ancestor chain of a run, nearest first. */
+  lineage(runId: string): Promise<string[]>;
+  /**
+   * Every page visible to a run: current, ancestors, then shared. A repeated
+   * page id is retained at every origin so citation resolution can report the
+   * ambiguity instead of silently shadowing one page.
+   */
+  loadChain(runId: string): Promise<OriginatedPage[]>;
+}
+declare function createRunScopedStores(options: RunScopedStoresOptions): RunScopedStores;
+/** File-backed authority used when the product has no separate run manifest. */
+declare function createFileRunLineageAuthority(runStorePath: (runId: string) => string): RunLineageAuthority;
+//#endregion
+//#region src/citation-resolution.d.ts
+/**
+ * A citation into the knowledge visible to one run.
+ *
+ * An unqualified reference is accepted only when exactly one visible page has
+ * the requested id. Callers can qualify a reference by origin when a current,
+ * inherited, or shared page intentionally reuses the same stable id.
+ */
+interface KnowledgeCitationReference {
+  readonly pageId: KnowledgeId;
+  readonly origin?: PageOrigin;
+}
+interface KnowledgeCitationCandidate {
+  readonly pageId: KnowledgeId;
+  readonly origin: PageOrigin;
+  readonly page: KnowledgePage;
+}
+type KnowledgeCitationResolutionStatus = 'resolved' | 'missing' | 'ambiguous';
+interface KnowledgeCitationResolution {
+  readonly reference: KnowledgeCitationReference;
+  readonly status: KnowledgeCitationResolutionStatus;
+  readonly candidates: readonly KnowledgeCitationCandidate[];
+  readonly resolved?: KnowledgeCitationCandidate;
+}
+type KnowledgeCitationAuditIssueKind = 'self' | 'missing' | 'ambiguous';
+interface KnowledgeCitationAuditIssue {
+  readonly kind: KnowledgeCitationAuditIssueKind;
+  readonly sourcePageId: KnowledgeId;
+  readonly sourcePath: string;
+  readonly sourceOrigin: PageOrigin;
+  readonly persistedCitation: string;
+  readonly reference: KnowledgeCitationReference;
+  readonly candidates: readonly KnowledgeCitationCandidate[];
+}
+interface KnowledgeCitationAuditReport {
+  readonly ok: boolean;
+  readonly checkedPages: number;
+  readonly checkedCitations: number;
+  readonly issues: readonly KnowledgeCitationAuditIssue[];
+}
+interface AuditKnowledgeCitationsOptions {
+  /** Limit audited source pages to these origins. All visible origins are checked by default. */
+  readonly sourceOrigins?: readonly PageOrigin[];
+}
+/** A batch contains at least one citation that is missing or ambiguous. */
+declare class KnowledgeCitationResolutionError extends Error {
+  readonly resolutions: readonly KnowledgeCitationResolution[];
+  constructor(resolutions: readonly KnowledgeCitationResolution[]);
+}
+/** A persisted page contains a self, missing, or ambiguous citation. */
+declare class KnowledgeCitationAuditError extends Error {
+  readonly report: KnowledgeCitationAuditReport;
+  constructor(report: KnowledgeCitationAuditReport);
+}
+/**
+ * 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.
+ */
+declare function parseKnowledgeCitationReference(value: string): KnowledgeCitationReference;
+/** Serialize one reference into the canonical frontmatter representation. */
+declare function formatKnowledgeCitationReference(reference: KnowledgeCitationReference): string;
+/** Resolve one reference against an already materialized visibility chain. */
+declare function resolveKnowledgeCitation(visiblePages: readonly OriginatedPage[], reference: KnowledgeCitationReference): KnowledgeCitationResolution;
+/** Resolve a batch without discarding missing or ambiguous rows. */
+declare function resolveKnowledgeCitations(visiblePages: readonly OriginatedPage[], references: readonly KnowledgeCitationReference[]): readonly KnowledgeCitationResolution[];
+/**
+ * Resolve a batch and fail closed unless every reference names exactly one
+ * visible page. Returned candidates preserve the caller's reference order.
+ */
+declare function assertKnowledgeCitationsResolved(visiblePages: readonly OriginatedPage[], references: readonly KnowledgeCitationReference[]): readonly KnowledgeCitationCandidate[];
+/** Audit persisted `cites` relations against one immutable visibility snapshot. */
+declare function auditKnowledgeCitations(visiblePages: readonly OriginatedPage[], options?: AuditKnowledgeCitationsOptions): KnowledgeCitationAuditReport;
+/** Audit and fail closed when any persisted citation is unresolved. */
+declare function assertKnowledgeCitationAudit(report: KnowledgeCitationAuditReport): void;
+/** Resolve one citation using a run-scoped store's declared visibility chain. */
+declare function resolveRunScopedCitation(stores: RunScopedStores, runId: string, reference: KnowledgeCitationReference): Promise<KnowledgeCitationResolution>;
+/** Resolve citations using one chain read so every row sees the same snapshot. */
+declare function resolveRunScopedCitations(stores: RunScopedStores, runId: string, references: readonly KnowledgeCitationReference[]): Promise<readonly KnowledgeCitationResolution[]>;
+/** Resolve a run-scoped batch and fail closed on any missing or ambiguous id. */
+declare function assertRunScopedCitationsResolved(stores: RunScopedStores, runId: string, references: readonly KnowledgeCitationReference[]): Promise<readonly KnowledgeCitationCandidate[]>;
+/** Audit only pages authored in the current run against the full visible chain. */
+declare function auditCurrentRunCitations(stores: RunScopedStores, runId: string): Promise<KnowledgeCitationAuditReport>;
+/** Audit current-run citations and fail closed on every unresolved relation. */
+declare function assertCurrentRunCitationsResolved(stores: RunScopedStores, runId: string): Promise<KnowledgeCitationAuditReport>;
+//#endregion
+//#region src/rag-eval/near-duplicates.d.ts
+interface NearDuplicateDetectionOptions {
+  /** Jaccard similarity at or above which a pair is reported. Defaults to 0.82. */
+  threshold?: number;
+  /** Minimum normalized characters before a page participates. Defaults to 80. */
+  minCharacters?: number;
+  /** Word-shingle width. Defaults to 5. */
+  wordShingleSize?: number;
+  /** Character-shingle width used for text with too few words. Defaults to 16. */
+  characterShingleSize?: number;
+  /** Ignore a shingle occurring in more pages than this. Defaults to 64. */
+  maxDocumentFrequency?: number;
+  /** Stop adding candidate pairs after this many. Defaults to 250,000. */
+  maxCandidatePairs?: number;
+  /** Maximum duplicate pairs retained in the report. Defaults to 1,000. */
+  maxReportedPairs?: number;
+}
+interface NearDuplicatePair {
+  leftPageId: string;
+  leftPath: string;
+  rightPageId: string;
+  rightPath: string;
+  similarity: number;
+  intersectionSize: number;
+  unionSize: number;
+  exact: boolean;
+}
+interface NearDuplicateReport {
+  algorithm: 'deterministic-shingle-jaccard-v1';
+  threshold: number;
+  pageCount: number;
+  eligiblePageCount: number;
+  candidatePairCount: number;
+  comparedPairCount: number;
+  duplicatePairCount: number;
+  duplicatePageCount: number;
+  duplicatePageRate: number;
+  truncated: boolean;
+  pairs: NearDuplicatePair[];
+}
+/**
+ * Detect exact and near-duplicate pages without a model, embedding service, or clock.
+ *
+ * The detector uses word shingles when prose has enough tokens and Unicode
+ * character shingles otherwise. An inverted index proposes candidate pairs;
+ * high-document-frequency shingles are ignored so common boilerplate cannot
+ * make candidate generation quadratic. Exact normalized copies are always
+ * proposed before ordinary shingle candidates, even when every shingle is
+ * common. Every limit and sort order is explicit so the same corpus produces
+ * the same report on every run.
+ */
+declare function detectNearDuplicatePages(pages: readonly KnowledgePage[], options?: NearDuplicateDetectionOptions): NearDuplicateReport;
+declare function normalizePageText(value: string): string;
+//#endregion
+//#region src/write-intake.d.ts
+/** One candidate that duplicates visible knowledge without relating itself to it. */
+interface KnowledgeDuplicateIntakePair {
+  readonly candidatePageId: KnowledgeId;
+  readonly candidatePath: string;
+  readonly matchedPageId: KnowledgeId;
+  readonly matchedPath: string;
+  readonly similarity: number;
+  readonly exact: boolean;
+}
+/**
+ * A write duplicates visible knowledge and declares no relation to it.
+ *
+ * Every listed pair is cleared by one authoring action: cite the matched page,
+ * name it in `contradicts`, or give the candidate the matched page's id so the
+ * write is an update of it.
+ */
+declare class KnowledgeDuplicateIntakeError extends Error {
+  readonly pairs: readonly KnowledgeDuplicateIntakePair[];
+  readonly threshold: number;
+  constructor(pairs: readonly KnowledgeDuplicateIntakePair[], threshold: number);
+}
+interface KnowledgeWriteIntakeOptions {
+  /**
+   * The chain the write lands in, as `loadChain` reports it. Candidates replace
+   * the `here` entries at the same paths; an inherited or shared page at one of
+   * those paths stays visible, so a citation into it still reports its true
+   * ambiguity.
+   */
+  readonly visiblePages: readonly OriginatedPage[];
+  /** Near-duplicate detector settings. The detector's own defaults apply when absent. */
+  readonly nearDuplicates?: NearDuplicateDetectionOptions;
+  /** Refuse a citation that resolves to no visible page. Defaults to true. */
+  readonly citations?: boolean;
+}
+/**
+ * Refuse a write that duplicates visible knowledge or cites a page that exists
+ * nowhere.
+ *
+ * The candidates are part of the corpus both checks see, so a batch may cite a
+ * page it writes in the same call, and two candidates that duplicate each other
+ * are caught before either lands.
+ *
+ * Returns the resolved citation candidates in the order the candidates declare
+ * them.
+ */
+declare function assertKnowledgeWriteIntake(candidates: readonly KnowledgePage[], options: KnowledgeWriteIntakeOptions): readonly KnowledgeCitationCandidate[];
+//#endregion
 //#region src/proposals.d.ts
 interface ApplyWriteBlocksResult {
   written: string[];
   warnings: string[];
 }
-declare function applyKnowledgeWriteBlocks(root: string, proposalText: string): Promise<ApplyWriteBlocksResult>;
-declare function applyKnowledgeWriteBlocksFile(root: string, proposalPath: string): Promise<ApplyWriteBlocksResult>;
+/** Intake settings for a write, minus the pages the target root supplies itself. */
+type KnowledgeWriteIntakeRequest = Omit<KnowledgeWriteIntakeOptions, 'visiblePages'> & {
+  /**
+   * Pages visible to the write beyond the target root, such as the inherited
+   * and shared entries of a run-scoped chain. The target root's own pages are
+   * read under the same lock and are always part of the corpus.
+   */
+  readonly inheritedPages?: readonly OriginatedPage[];
+};
+interface ApplyKnowledgeWriteBlocksOptions extends KnowledgePagesOptions {
+  /**
+   * Refuse the write when a block duplicates visible knowledge without relating
+   * itself to it, or cites a page that exists nowhere. The whole proposal is
+   * refused, so a refused batch leaves no partial write behind.
+   */
+  intake?: KnowledgeWriteIntakeRequest;
+}
+/**
+ * Apply the FILE blocks of a proposal under the pages directory.
+ *
+ * A block whose path lies outside `<pagesDirectory>/` is refused by the parser
+ * and again by the file transaction, so one option value bounds the whole
+ * write.
+ */
+declare function applyKnowledgeWriteBlocks(root: string, proposalText: string, options?: ApplyKnowledgeWriteBlocksOptions): Promise<ApplyWriteBlocksResult>;
+declare function applyKnowledgeWriteBlocksFile(root: string, proposalPath: string, options?: ApplyKnowledgeWriteBlocksOptions): Promise<ApplyWriteBlocksResult>;
 //#endregion
 //#region src/validate.d.ts
 interface ValidateKnowledgeOptions {
@@ -858,60 +1207,6 @@ interface RunRagKnowledgeImprovementLoopResult {
 type MaybePromise$1<T> = T | Promise<T>;
 declare function runRagKnowledgeImprovementLoop(options: RunRagKnowledgeImprovementLoopOptions): Promise<RunRagKnowledgeImprovementLoopResult>;
 //#endregion
-//#region src/rag-eval/near-duplicates.d.ts
-interface NearDuplicateDetectionOptions {
-  /** Jaccard similarity at or above which a pair is reported. Defaults to 0.82. */
-  threshold?: number;
-  /** Minimum normalized characters before a page participates. Defaults to 80. */
-  minCharacters?: number;
-  /** Word-shingle width. Defaults to 5. */
-  wordShingleSize?: number;
-  /** Character-shingle width used for text with too few words. Defaults to 16. */
-  characterShingleSize?: number;
-  /** Ignore a shingle occurring in more pages than this. Defaults to 64. */
-  maxDocumentFrequency?: number;
-  /** Stop adding candidate pairs after this many. Defaults to 250,000. */
-  maxCandidatePairs?: number;
-  /** Maximum duplicate pairs retained in the report. Defaults to 1,000. */
-  maxReportedPairs?: number;
-}
-interface NearDuplicatePair {
-  leftPageId: string;
-  leftPath: string;
-  rightPageId: string;
-  rightPath: string;
-  similarity: number;
-  intersectionSize: number;
-  unionSize: number;
-  exact: boolean;
-}
-interface NearDuplicateReport {
-  algorithm: 'deterministic-shingle-jaccard-v1';
-  threshold: number;
-  pageCount: number;
-  eligiblePageCount: number;
-  candidatePairCount: number;
-  comparedPairCount: number;
-  duplicatePairCount: number;
-  duplicatePageCount: number;
-  duplicatePageRate: number;
-  truncated: boolean;
-  pairs: NearDuplicatePair[];
-}
-/**
- * Detect exact and near-duplicate pages without a model, embedding service, or clock.
- *
- * The detector uses word shingles when prose has enough tokens and Unicode
- * character shingles otherwise. An inverted index proposes candidate pairs;
- * high-document-frequency shingles are ignored so common boilerplate cannot
- * make candidate generation quadratic. Exact normalized copies are always
- * proposed before ordinary shingle candidates, even when every shingle is
- * common. Every limit and sort order is explicit so the same corpus produces
- * the same report on every run.
- */
-declare function detectNearDuplicatePages(pages: readonly KnowledgePage[], options?: NearDuplicateDetectionOptions): NearDuplicateReport;
-declare function normalizePageText(value: string): string;
-//#endregion
 //#region src/rag-eval/contracts.d.ts
 type RagEvalProvider = 'agent-knowledge' | 'ragas' | 'deepeval' | 'trulens' | 'ragchecker' | 'custom';
 type RagEvalMetricKey = 'context_precision' | 'context_recall' | 'context_relevance' | 'context_sufficiency' | 'faithfulness' | 'groundedness' | 'answer_relevance' | 'answer_correctness' | 'citation_support' | 'abstention' | 'unsupported_answer_rate';
@@ -1532,6 +1827,7 @@ declare const transactionSchema: z.ZodObject<{
   transactionId: z.ZodString;
   purpose: z.ZodString;
   recoveryOwner: z.ZodOptional<z.ZodString>;
+  pagesDirectory: z.ZodOptional<z.ZodString>;
   createdAt: z.ZodString;
   entries: z.ZodArray<z.ZodObject<{
     index: z.ZodNumber;
@@ -1658,197 +1954,18 @@ interface ChunkingOptions {
   overlapChars: number;
 }
 interface KnowledgeChunk {
-  index: number;
-  text: string;
-  headingPath: string;
-  charStart: number;
-  charEnd: number;
-  oversized: boolean;
-}
-declare function chunkMarkdown(content: string, options?: Partial<ChunkingOptions>): KnowledgeChunk[];
-declare function stripFrontmatter(content: string): {
-  body: string;
-  bodyOffset: number;
-};
-//#endregion
-//#region src/store.d.ts
-interface KnowledgeLayout {
-  root: string;
-  knowledgeDir: string;
-  rawSourcesDir: string;
-  sourceRegistryPath: string;
-  indexPath: string;
-  logPath: string;
-  cacheDir: string;
-}
-declare function layoutFor(root: string): KnowledgeLayout;
-/**
- * Filenames that `initKnowledgeBase` writes as human-navigation scaffolding.
- * These are excluded from the page index — they exist on disk so authors can
- * curate their vault, but they are not searchable content.
- *
- * Add new scaffold filenames here (and only here) to keep lint, validate, viz,
- * and the indexer consistent.
- */
-declare const SCAFFOLD_PAGE_BASENAMES: readonly string[];
-/**
- * True when a knowledge-relative path points at a scaffold file rather than
- * authored content. Accepts both repo-relative paths (`knowledge/index.md`)
- * and any nested `<dir>/index.md` or `<dir>/log.md` (for example
- * `knowledge/concepts/index.md`) so subdirectory README-style scaffolds are
- * also excluded.
- */
-declare function isScaffoldPath(path: string): boolean;
-declare function initKnowledgeBase(root: string): Promise<KnowledgeLayout>;
-interface LoadKnowledgePagesOptions {
-  /** Root-relative directory containing Markdown pages. Defaults to `knowledge`. */
-  pagesDirectory?: string;
-}
-declare function loadKnowledgePages(root: string, options?: LoadKnowledgePagesOptions): Promise<KnowledgePage[]>;
-declare function writeJson(path: string, value: unknown): Promise<void>;
-//#endregion
-//#region src/run-scoped.d.ts
-/** Where a page in a chained read came from. */
-type PageOrigin = 'here' | `inherited:${string}` | 'shared';
-interface OriginatedPage {
-  page: KnowledgePage;
-  origin: PageOrigin;
-}
-interface RunLineageRecord {
-  runId: string;
-  parentRunId: string | null;
-  createdAt: string;
-}
-/**
- * Durable authority for run ancestry.
- *
- * A product whose run manifest already owns lineage can supply an authority
- * backed by that manifest. `record` is optional for read-only authorities; in
- * that case `init` verifies that the existing authority agrees with the parent
- * requested by the caller before creating any store files.
- */
-interface RunLineageAuthority {
-  parentOf(runId: string): Promise<string | null>;
-  record?(record: RunLineageRecord): Promise<void>;
-}
-declare const RUN_LINEAGE_BASENAME = "lineage.json";
-interface RunScopedStoresOptions {
-  /** The root under which per-run stores live. */
-  root: string;
-  /** Store path for a run; defaults to `<root>/<runId>/knowledge-base`. */
-  runStorePath?: (runId: string) => string;
-  /**
-   * The curated store every run may read but no run writes. Searched last and
-   * labeled `shared`.
-   */
-  sharedRoot?: string;
-  /** External owner for run ancestry. Defaults to a record inside each run store. */
-  lineageAuthority?: RunLineageAuthority;
-}
-interface RunScopedStores {
-  /** Create or open a run store and bind it to one exact parent identity. */
-  init(runId: string, options?: {
-    parentRunId?: string | null;
-  }): Promise<KnowledgeLayout>;
-  /** The ancestor chain of a run, nearest first. */
-  lineage(runId: string): Promise<string[]>;
-  /**
-   * Every page visible to a run: current, ancestors, then shared. A repeated
-   * page id is retained at every origin so citation resolution can report the
-   * ambiguity instead of silently shadowing one page.
-   */
-  loadChain(runId: string): Promise<OriginatedPage[]>;
-}
-declare function createRunScopedStores(options: RunScopedStoresOptions): RunScopedStores;
-/** File-backed authority used when the product has no separate run manifest. */
-declare function createFileRunLineageAuthority(runStorePath: (runId: string) => string): RunLineageAuthority;
-//#endregion
-//#region src/citation-resolution.d.ts
-/**
- * A citation into the knowledge visible to one run.
- *
- * An unqualified reference is accepted only when exactly one visible page has
- * the requested id. Callers can qualify a reference by origin when a current,
- * inherited, or shared page intentionally reuses the same stable id.
- */
-interface KnowledgeCitationReference {
-  readonly pageId: KnowledgeId;
-  readonly origin?: PageOrigin;
-}
-interface KnowledgeCitationCandidate {
-  readonly pageId: KnowledgeId;
-  readonly origin: PageOrigin;
-  readonly page: KnowledgePage;
-}
-type KnowledgeCitationResolutionStatus = 'resolved' | 'missing' | 'ambiguous';
-interface KnowledgeCitationResolution {
-  readonly reference: KnowledgeCitationReference;
-  readonly status: KnowledgeCitationResolutionStatus;
-  readonly candidates: readonly KnowledgeCitationCandidate[];
-  readonly resolved?: KnowledgeCitationCandidate;
-}
-type KnowledgeCitationAuditIssueKind = 'self' | 'missing' | 'ambiguous';
-interface KnowledgeCitationAuditIssue {
-  readonly kind: KnowledgeCitationAuditIssueKind;
-  readonly sourcePageId: KnowledgeId;
-  readonly sourcePath: string;
-  readonly sourceOrigin: PageOrigin;
-  readonly persistedCitation: string;
-  readonly reference: KnowledgeCitationReference;
-  readonly candidates: readonly KnowledgeCitationCandidate[];
-}
-interface KnowledgeCitationAuditReport {
-  readonly ok: boolean;
-  readonly checkedPages: number;
-  readonly checkedCitations: number;
-  readonly issues: readonly KnowledgeCitationAuditIssue[];
-}
-interface AuditKnowledgeCitationsOptions {
-  /** Limit audited source pages to these origins. All visible origins are checked by default. */
-  readonly sourceOrigins?: readonly PageOrigin[];
-}
-/** A batch contains at least one citation that is missing or ambiguous. */
-declare class KnowledgeCitationResolutionError extends Error {
-  readonly resolutions: readonly KnowledgeCitationResolution[];
-  constructor(resolutions: readonly KnowledgeCitationResolution[]);
-}
-/** A persisted page contains a self, missing, or ambiguous citation. */
-declare class KnowledgeCitationAuditError extends Error {
-  readonly report: KnowledgeCitationAuditReport;
-  constructor(report: KnowledgeCitationAuditReport);
+  index: number;
+  text: string;
+  headingPath: string;
+  charStart: number;
+  charEnd: number;
+  oversized: boolean;
 }
-/**
- * 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.
- */
-declare function parseKnowledgeCitationReference(value: string): KnowledgeCitationReference;
-/** Serialize one reference into the canonical frontmatter representation. */
-declare function formatKnowledgeCitationReference(reference: KnowledgeCitationReference): string;
-/** Resolve one reference against an already materialized visibility chain. */
-declare function resolveKnowledgeCitation(visiblePages: readonly OriginatedPage[], reference: KnowledgeCitationReference): KnowledgeCitationResolution;
-/** Resolve a batch without discarding missing or ambiguous rows. */
-declare function resolveKnowledgeCitations(visiblePages: readonly OriginatedPage[], references: readonly KnowledgeCitationReference[]): readonly KnowledgeCitationResolution[];
-/**
- * Resolve a batch and fail closed unless every reference names exactly one
- * visible page. Returned candidates preserve the caller's reference order.
- */
-declare function assertKnowledgeCitationsResolved(visiblePages: readonly OriginatedPage[], references: readonly KnowledgeCitationReference[]): readonly KnowledgeCitationCandidate[];
-/** Audit persisted `cites` relations against one immutable visibility snapshot. */
-declare function auditKnowledgeCitations(visiblePages: readonly OriginatedPage[], options?: AuditKnowledgeCitationsOptions): KnowledgeCitationAuditReport;
-/** Audit and fail closed when any persisted citation is unresolved. */
-declare function assertKnowledgeCitationAudit(report: KnowledgeCitationAuditReport): void;
-/** Resolve one citation using a run-scoped store's declared visibility chain. */
-declare function resolveRunScopedCitation(stores: RunScopedStores, runId: string, reference: KnowledgeCitationReference): Promise<KnowledgeCitationResolution>;
-/** Resolve citations using one chain read so every row sees the same snapshot. */
-declare function resolveRunScopedCitations(stores: RunScopedStores, runId: string, references: readonly KnowledgeCitationReference[]): Promise<readonly KnowledgeCitationResolution[]>;
-/** Resolve a run-scoped batch and fail closed on any missing or ambiguous id. */
-declare function assertRunScopedCitationsResolved(stores: RunScopedStores, runId: string, references: readonly KnowledgeCitationReference[]): Promise<readonly KnowledgeCitationCandidate[]>;
-/** Audit only pages authored in the current run against the full visible chain. */
-declare function auditCurrentRunCitations(stores: RunScopedStores, runId: string): Promise<KnowledgeCitationAuditReport>;
-/** Audit current-run citations and fail closed on every unresolved relation. */
-declare function assertCurrentRunCitationsResolved(stores: RunScopedStores, runId: string): Promise<KnowledgeCitationAuditReport>;
+declare function chunkMarkdown(content: string, options?: Partial<ChunkingOptions>): KnowledgeChunk[];
+declare function stripFrontmatter(content: string): {
+  body: string;
+  bodyOffset: number;
+};
 //#endregion
 //#region src/citation-lint.d.ts
 /** Convert a chain-aware citation audit into the package lint vocabulary. */
@@ -2315,8 +2432,8 @@ declare function createKnowledgeEvent(input: {
 }): KnowledgeEvent;
 //#endregion
 //#region src/filesystem-search-provider.d.ts
-interface FileSystemSearchProviderOptions {
-  /** Knowledge-base root containing `knowledge/` and `.agent-knowledge/`. */
+interface FileSystemSearchProviderOptions extends KnowledgePagesOptions {
+  /** Knowledge-base root containing the pages directory and `.agent-knowledge/`. */
   root: string;
   /** Optional warm index, useful when the caller already built one. */
   index?: KnowledgeIndex;
@@ -2340,7 +2457,10 @@ interface FileSystemSearchOptions {
  */
 declare class FileSystemSearchProvider {
   readonly root: string;
+  /** Root-relative directory the provider indexes. */
+  readonly pagesDirectory: string;
   private index;
+  private lexicalIndex;
   private readonly defaultLimit;
   private readonly refreshMode;
   constructor(options: FileSystemSearchProviderOptions);
@@ -2463,6 +2583,30 @@ declare function parseFrontmatter(content: string): ParsedFrontmatter;
 declare function formatFrontmatter(frontmatter: Record<string, unknown>, body: string): string;
 //#endregion
 //#region src/graph.d.ts
+type KnowledgePageRelationPredicate = 'wikilink' | 'citation' | 'shared-source' | 'contradicts';
+/** One labeled relation between two pages; `weight` counts the occurrences that produced it. */
+interface KnowledgePageRelation extends KnowledgeRelation {
+  predicate: KnowledgePageRelationPredicate;
+  weight: number;
+}
+/**
+ * The labeled relations between pages, one per `(sourceId, targetId, predicate)`.
+ *
+ * `wikilink`, `citation`, and `contradicts` follow an authored link, `cites`
+ * entry, or `contradicts` entry to the one page it resolves to; a missing,
+ * ambiguous, or self-referencing target emits nothing. `shared-source` joins
+ * every pair of pages that registers a common source, in page order, weighted
+ * 0.5 per shared source id, with the shared ids in `metadata.sourceIds`. It is
+ * implicit, so it is listed after the authored relations and never counts
+ * toward a page's degree in `buildKnowledgeGraph`.
+ */
+declare function knowledgePageRelations(pages: KnowledgePage[]): KnowledgePageRelation[];
+/**
+ * The weighted page graph: `knowledgePageRelations` collapsed to one edge per
+ * ordered page pair, with the predicates merged into `reasons` and the weights
+ * summed. `contradicts` stays out of this projection; read it from the relation
+ * list. Node degrees count the authored `wikilink` and `citation` occurrences.
+ */
 declare function buildKnowledgeGraph(pages: KnowledgePage[]): KnowledgeGraph;
 //#endregion
 //#region src/ids.d.ts
@@ -2473,7 +2617,7 @@ declare function stableId(prefix: string, content: string): string;
 declare function textSourceId(uri: string, contentHash: string): string;
 //#endregion
 //#region src/indexer.d.ts
-declare function buildKnowledgeIndex(root: string): Promise<KnowledgeIndex>;
+declare function buildKnowledgeIndex(root: string, options?: KnowledgePagesOptions): Promise<KnowledgeIndex>;
 /**
  * Build the index from the knowledge tree and store it.
  *
@@ -2483,7 +2627,7 @@ declare function buildKnowledgeIndex(root: string): Promise<KnowledgeIndex>;
  * a store-based reader saw none of the indexer's work. One writer now, and it
  * validates through `KnowledgeIndexSchema` on the way out.
  */
-declare function writeKnowledgeIndex(root: string): Promise<KnowledgeIndex>;
+declare function writeKnowledgeIndex(root: string, options?: KnowledgePagesOptions): Promise<KnowledgeIndex>;
 //#endregion
 //#region src/inspect.d.ts
 interface KnowledgeInspection {
@@ -2532,6 +2676,40 @@ interface KnowledgeExplanation {
 }
 declare function explainKnowledgeTarget(index: KnowledgeIndex, target: string): KnowledgeExplanation;
 //#endregion
+//#region src/invalidation-propagation.d.ts
+/** Frontmatter field naming the cited pages whose evidence refuted them. */
+declare const CITES_INVALIDATED_FIELD = "citesInvalidated";
+interface KnowledgeInvalidationStamp {
+  readonly page: KnowledgePage;
+  /** The value the field must hold, sorted and deduplicated. Empty removes the field. */
+  readonly citesInvalidated: readonly KnowledgeId[];
+  /** The value the page holds now, in the order it is stored. */
+  readonly current: readonly KnowledgeId[];
+}
+interface KnowledgeInvalidationPlan {
+  /** Every visible page carrying an invalidation, sorted by id. */
+  readonly invalidatedPageIds: readonly KnowledgeId[];
+  /** Only the pages whose stamp differs from what they hold, in path order. */
+  readonly stamps: readonly KnowledgeInvalidationStamp[];
+}
+/**
+ * Plan the `citesInvalidated` stamp for every page authored in the target
+ * store.
+ *
+ * Citations resolve over the whole chain, so a page here may be stamped for
+ * citing a refuted inherited or shared page. Only `here` pages are stamped: a
+ * run does not write the stores it inherits or shares.
+ */
+declare function planInvalidationPropagation(visiblePages: readonly OriginatedPage[]): KnowledgeInvalidationPlan;
+/**
+ * Render one plan as a write-block proposal for `applyKnowledgeWriteBlocks`.
+ *
+ * Only the stamped field changes. The page is rendered through
+ * `formatFrontmatter`, so its frontmatter is written in that writer's
+ * normalized form.
+ */
+declare function formatKnowledgeInvalidationProposal(plan: KnowledgeInvalidationPlan): string;
+//#endregion
 //#region src/investment-thesis-set.d.ts
 /**
  * HELD-OUT INVESTMENT-RESEARCH EVAL SET.
@@ -2870,7 +3048,7 @@ declare class FileSystemKbStore implements KbStore, ClaimLedgerStore {
 }
 //#endregion
 //#region src/knowledge-use-receipts.d.ts
-declare const KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION: '1.0.0';
+declare const KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION: '2.0.0';
 declare const KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM: 'rfc8785-sha256';
 interface KnowledgeVisibilitySnapshotEntry {
   readonly position: number;
@@ -2888,6 +3066,23 @@ interface KnowledgeVisibilitySnapshot {
   readonly snapshotDigest: Sha256Digest;
   readonly entries: readonly KnowledgeVisibilitySnapshotEntry[];
 }
+/** Content-addressed locator of the stored bytes of one visibility snapshot. */
+interface KnowledgeVisibilityArtifactRef {
+  readonly uri: string;
+  /** Digest of the stored bytes, as `knowledgeVisibilityArtifactRef` computes it. */
+  readonly digest: Sha256Digest;
+  readonly byteLength: number;
+}
+/**
+ * Compact identity of one exact visibility snapshot. The snapshot bytes live in
+ * the artifact the reference names, or in another durable record the caller
+ * keeps; the receipt carries only this reference.
+ */
+interface KnowledgeVisibilityRef {
+  readonly snapshotDigest: Sha256Digest;
+  readonly pageCount: number;
+  readonly artifact?: KnowledgeVisibilityArtifactRef;
+}
 interface KnowledgeRetrieverIdentity {
   /** Stable implementation name, for example `token-overlap-v1`. */
   readonly id: string;
@@ -2927,7 +3122,7 @@ interface KnowledgeRetrievalReceipt {
   readonly executionRef?: Sha256Digest;
   readonly query: string;
   readonly retriever: KnowledgeRetrieverIdentity;
-  readonly visibility: KnowledgeVisibilitySnapshot;
+  readonly visibility: KnowledgeVisibilityRef;
   readonly results: readonly KnowledgeRetrievalResultReceipt[];
   readonly evidenceRefs: readonly EvidenceRef[];
   readonly attributes: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
@@ -2939,12 +3134,42 @@ interface CreateKnowledgeRetrievalReceiptInput {
   readonly executionRef?: Sha256Digest;
   readonly query: string;
   readonly retriever: KnowledgeRetrieverIdentity;
-  readonly visiblePages: readonly OriginatedPage[];
+  /**
+   * The snapshot the retriever searched, created once with
+   * `createKnowledgeVisibilitySnapshot` and reused for every retrieval over the
+   * same view. Results join against its entries; the receipt stores only its
+   * reference.
+   */
+  readonly visibility: KnowledgeVisibilitySnapshot;
+  /** Where the snapshot bytes are stored, when the caller has persisted them. */
+  readonly visibilityArtifact?: KnowledgeVisibilityArtifactRef;
   readonly results: readonly OriginatedKnowledgeSearchResult[];
   readonly evidenceRefs?: readonly EvidenceRef[];
   readonly attributes?: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
   readonly createdAt?: Date | string;
 }
+/**
+ * Returns the stored bytes of the artifact, or `undefined` when nothing is
+ * stored at its uri. A thrown error is reported as a load failure.
+ */
+type KnowledgeVisibilityArtifactLoader = (artifact: KnowledgeVisibilityArtifactRef) => Promise<Uint8Array | undefined> | Uint8Array | undefined;
+type KnowledgeVisibilityUnavailableReason = 'no-artifact-reference' | 'missing' | 'load-failed';
+/**
+ * The visibility snapshot a receipt references could not be obtained, so the
+ * result-to-visibility join cannot be proven. This is distinct from a snapshot
+ * that loads and fails to match.
+ */
+declare class KnowledgeVisibilityUnavailableError extends Error {
+  readonly reason: KnowledgeVisibilityUnavailableReason;
+  readonly snapshotDigest: Sha256Digest;
+  readonly uri?: string;
+  constructor(input: {
+    reason: KnowledgeVisibilityUnavailableReason;
+    snapshotDigest: Sha256Digest;
+    uri?: string;
+    cause?: unknown;
+  });
+}
 type KnowledgeUseRelation = 'supports' | 'contradicts' | 'extends' | 'rederives' | 'background';
 type KnowledgeConsumerKind = 'decision' | 'artifact' | 'experiment' | 'candidate' | 'message' | 'other';
 interface KnowledgeConsumerRef {
@@ -2990,20 +3215,291 @@ interface CreateKnowledgeUseReceiptInput {
   readonly attributes?: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
   readonly createdAt?: Date | string;
 }
+/**
+ * Why a retrieval influenced nothing.
+ *
+ * `irrelevant` means the returned pages did not bear on the question.
+ * `no-use` means they did bear on it and the consumer still used none of them.
+ */
+type KnowledgeRetrievalDispositionRelation = 'irrelevant' | 'no-use';
+/**
+ * Immutable proof that one retrieval led to no use.
+ *
+ * A use receipt requires a selected rank, so a retrieval that influenced
+ * nothing would otherwise leave no record at all, and "no evidence of use" and
+ * "evidence of no use" would look identical in the ledger.
+ */
+interface KnowledgeRetrievalDisposition {
+  readonly schemaVersion: typeof KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION;
+  readonly kind: 'knowledge-retrieval-disposition';
+  readonly digestAlgorithm: typeof KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM;
+  readonly receiptDigest: Sha256Digest;
+  readonly createdAt: string;
+  readonly runId: string;
+  readonly actorId?: string;
+  readonly profileDigest?: Sha256Digest;
+  readonly executionRef?: Sha256Digest;
+  readonly retrievalReceiptDigest: Sha256Digest;
+  readonly relation: KnowledgeRetrievalDispositionRelation;
+  readonly consumer: KnowledgeConsumerRef;
+  readonly evidenceRefs: readonly EvidenceRef[];
+  readonly attributes: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
+}
+interface CreateKnowledgeRetrievalDispositionInput {
+  readonly retrieval: KnowledgeRetrievalReceipt;
+  readonly relation: KnowledgeRetrievalDispositionRelation;
+  readonly consumer: KnowledgeConsumerRef;
+  readonly evidenceRefs?: readonly EvidenceRef[];
+  readonly attributes?: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
+  readonly createdAt?: Date | string;
+}
 /** Stable content identity for one exact knowledge page. */
 declare function knowledgePageDigest(page: KnowledgePage): Sha256Digest;
 /** Snapshot the exact ordered current/ancestor/shared page view. */
 declare function createKnowledgeVisibilitySnapshot(visiblePages: readonly OriginatedPage[]): KnowledgeVisibilitySnapshot;
-/** Create a retrieval receipt and refuse results that were not in the view. */
+/**
+ * Verify a snapshot's schema and canonical digest. The check runs once per
+ * snapshot object; later calls with the same object are free.
+ */
+declare function verifyKnowledgeVisibilitySnapshot(snapshot: KnowledgeVisibilitySnapshot): KnowledgeVisibilitySnapshot;
+/** Canonical bytes of a verified snapshot, for durable storage. */
+declare function encodeKnowledgeVisibilitySnapshot(snapshot: KnowledgeVisibilitySnapshot): Uint8Array;
+/** Parse stored snapshot bytes and verify their schema and digest. */
+declare function decodeKnowledgeVisibilitySnapshot(bytes: Uint8Array): KnowledgeVisibilitySnapshot;
+/** Locator for snapshot bytes stored at `uri`. */
+declare function knowledgeVisibilityArtifactRef(input: {
+  uri: string;
+  bytes: Uint8Array;
+}): KnowledgeVisibilityArtifactRef;
+/**
+ * Create a retrieval receipt over a precomputed snapshot. Every result must
+ * occur in the snapshot with the same page id and bytes; the receipt stores the
+ * snapshot's reference, not its entries.
+ */
 declare function createKnowledgeRetrievalReceipt(input: CreateKnowledgeRetrievalReceiptInput): KnowledgeRetrievalReceipt;
-/** Verify the receipt's schema, internal joins, and canonical digest. */
+/**
+ * Verify the receipt's schema, canonical digest, rank continuity, finite
+ * scores, and well-formed visibility reference. This proves what the receipt
+ * says; it does not prove that the results occur in the referenced snapshot.
+ * Use `assertKnowledgeRetrievalMatchesVisibility` or
+ * `assertKnowledgeRetrievalMatchesVisibilityArtifact` for that join.
+ */
 declare function verifyKnowledgeRetrievalReceipt(receipt: KnowledgeRetrievalReceipt): KnowledgeRetrievalReceipt;
-/** Prove that a receipt still describes the supplied visibility bytes. */
-declare function assertKnowledgeRetrievalMatchesVisibility(receipt: KnowledgeRetrievalReceipt, visiblePages: readonly OriginatedPage[]): void;
+/**
+ * Prove that the receipt references exactly this snapshot and that every
+ * returned result occurs in it with the same page id and bytes. Pass the
+ * snapshot itself, or the originated pages to snapshot them first.
+ */
+declare function assertKnowledgeRetrievalMatchesVisibility(receipt: KnowledgeRetrievalReceipt, visibility: KnowledgeVisibilitySnapshot | readonly OriginatedPage[]): void;
+/**
+ * Load the snapshot artifact the receipt references, prove the stored bytes
+ * match the reference, and prove every returned result occurs in the decoded
+ * snapshot. A snapshot that cannot be obtained raises
+ * `KnowledgeVisibilityUnavailableError`; it is never treated as empty.
+ */
+declare function assertKnowledgeRetrievalMatchesVisibilityArtifact(receipt: KnowledgeRetrievalReceipt, loadArtifact: KnowledgeVisibilityArtifactLoader): Promise<KnowledgeVisibilitySnapshot>;
 /** Create a downstream-use receipt for one exact ranked result. */
 declare function createKnowledgeUseReceipt(input: CreateKnowledgeUseReceiptInput): KnowledgeUseReceipt;
 /** Verify one use receipt against the exact retrieval that authorized it. */
 declare function verifyKnowledgeUseReceipt(receipt: KnowledgeUseReceipt, retrieval: KnowledgeRetrievalReceipt): KnowledgeUseReceipt;
+/** Record that one retrieval led to no use, with no rank to select. */
+declare function createKnowledgeRetrievalDisposition(input: CreateKnowledgeRetrievalDispositionInput): KnowledgeRetrievalDisposition;
+/** Verify one disposition against the exact retrieval that authorized it. */
+declare function verifyKnowledgeRetrievalDisposition(disposition: KnowledgeRetrievalDisposition, retrieval: KnowledgeRetrievalReceipt): KnowledgeRetrievalDisposition;
+//#endregion
+//#region src/lexical-index.d.ts
+/**
+ * The token stream of one text: lower-cased, split on whitespace and
+ * punctuation, single characters and stop words removed, and a CJK run
+ * expanded into its bigrams and characters. Repeats are kept so a term
+ * frequency can be counted. Indexing and querying share this function, so the
+ * two vocabularies cannot drift.
+ */
+declare function tokenizeText(text: string): string[];
+/** The distinct query terms, in first-occurrence order. */
+declare function tokenizeQuery(query: string): string[];
+interface KnowledgeLexicalFieldBoosts {
+  /** Multiplier for a term occurrence in the page title. Defaults to 3. */
+  title?: number;
+  /** Multiplier for a term occurrence in the page path without its extension. Defaults to 2. */
+  path?: number;
+  /** Multiplier for a term occurrence in the page body. Defaults to 1. */
+  text?: number;
+}
+interface KnowledgeLexicalIndexOptions {
+  /** Token stream of one text. Defaults to `tokenizeText`. */
+  tokenize?: (text: string) => string[];
+  fieldBoosts?: KnowledgeLexicalFieldBoosts;
+}
+interface KnowledgeLexicalPosting {
+  /** Position of the page in `KnowledgeLexicalIndex.pages`. */
+  ordinal: number;
+  /** Field-boosted term frequency in that page. */
+  tf: number;
+}
+/**
+ * Inverted index over a fixed page list.
+ *
+ * Ordinals are positions in `pages`. `documentLengths` are field-boosted token
+ * counts, so length normalization and term frequency use one scale.
+ */
+interface KnowledgeLexicalIndex {
+  readonly pages: readonly KnowledgePage[];
+  readonly postings: ReadonlyMap<string, readonly KnowledgeLexicalPosting[]>;
+  readonly documentLengths: readonly number[];
+  readonly averageDocumentLength: number;
+  readonly documentCount: number;
+  readonly tokenize: (text: string) => string[];
+  readonly fieldBoosts: Readonly<Required<KnowledgeLexicalFieldBoosts>>;
+}
+interface Bm25Options {
+  /** Term-frequency saturation. Defaults to 1.2. */
+  k1?: number;
+  /** Length-normalization strength in [0, 1]. Defaults to 0.75. */
+  b?: number;
+}
+interface Bm25Hit {
+  page: KnowledgePage;
+  score: number;
+}
+declare function buildKnowledgeLexicalIndex(pages: readonly KnowledgePage[], options?: KnowledgeLexicalIndexOptions): KnowledgeLexicalIndex;
+/**
+ * Okapi BM25 over the distinct query terms, with the Lucene inverse document
+ * frequency `ln(1 + (N - df + 0.5) / (df + 0.5))`, which is positive for every
+ * indexed term. Pages with no matching term are absent. The result is ordered
+ * by score, then by path, so it does not depend on page order.
+ */
+declare function scoreBm25(index: KnowledgeLexicalIndex, tokens: readonly string[], options?: Bm25Options): Bm25Hit[];
+//#endregion
+//#region src/search.d.ts
+/**
+ * Identity of the ranking `searchKnowledge` performs: BM25 over title, path,
+ * and body, exact-title and phrase matches ahead of bag-of-words matches, and
+ * reciprocal rank fusion with link and shared-source structure. Declare it as
+ * the retriever id of a retrieval receipt minted from these results.
+ */
+declare const KNOWLEDGE_SEARCH_RETRIEVER_ID = "bm25-rrf-v1";
+interface SearchKnowledgeOptions {
+  /** Maximum results returned. Defaults to 10. */
+  limit?: number;
+  /** Match pages whose stable id is one of these values. */
+  pageIds?: readonly KnowledgeId[];
+  /** Match pages carrying at least one of these tags. */
+  tags?: readonly string[];
+  /** Match the exact string stored in `frontmatter.kind`. */
+  kinds?: readonly string[];
+  /**
+   * Drop pages whose own evidence refuted them. Defaults to false: a caller
+   * that reads history needs them, and a silent change of what search returns
+   * is worse than an explicit option.
+   */
+  excludeInvalidated?: boolean;
+  /** Additional caller-owned filter, applied before either ranking stage. */
+  predicate?: (page: KnowledgePage) => boolean;
+  /**
+   * A lexical index built from exactly the searched pages, supplied by a caller
+   * that searches one page set repeatedly. When absent, one is built for this
+   * call.
+   */
+  lexicalIndex?: KnowledgeLexicalIndex;
+}
+/**
+ * A retrieval result with an explicit citation handle.
+ *
+ * `citationId` is exactly `page.id`; later writes should persist this value
+ * when they cite the page. Keeping it at the result's top level prevents tool
+ * renderers from accidentally hiding the only stable handle a model can copy.
+ */
+interface KnowledgeSearchHit extends KnowledgeSearchResult {
+  citationId: KnowledgeId;
+}
+declare function searchKnowledge(index: KnowledgeIndex, query: string, limit?: number): KnowledgeSearchHit[];
+declare function searchKnowledge(index: KnowledgeIndex, query: string, options?: SearchKnowledgeOptions): KnowledgeSearchHit[];
+/**
+ * Rank a page set that is not a built index, such as the chain a run can see.
+ *
+ * `searchKnowledge` is this function over `index.pages`, so both entry points
+ * rank identically and neither can drift from the other.
+ */
+declare function searchKnowledgePages(pages: readonly KnowledgePage[], query: string, limitOrOptions?: number | SearchKnowledgeOptions): KnowledgeSearchHit[];
+declare function reciprocalRankFusion(rankLists: string[][], k?: number): Map<string, number>;
+//#endregion
+//#region src/knowledge-brief.d.ts
+/** Pages in a brief when the caller names no limit. */
+declare const DEFAULT_KNOWLEDGE_BRIEF_LIMIT = 5;
+interface KnowledgeBriefOptions {
+  /** Maximum pages in the brief. Defaults to 5. */
+  limit?: number;
+  /**
+   * Drop pages whose own evidence refuted them. Defaults to true, the opposite
+   * of `searchKnowledge`: a brief is injected before a run's first token and
+   * offers every page it names with an id ready to cite, so a refuted page in
+   * it is an invitation to build on a dead claim.
+   */
+  excludeInvalidated?: boolean;
+  /** Match pages carrying at least one of these tags. */
+  tags?: readonly string[];
+  /** Match the exact string stored in `frontmatter.kind`. */
+  kinds?: readonly string[];
+  /**
+   * Bound on the rendered brief. A page whose line does not fit is left out of
+   * the whole brief, so `text`, `hits`, `citationIds`, and `results` always
+   * describe one identical set of pages.
+   */
+  maxChars?: number;
+}
+interface KnowledgeBrief {
+  readonly question: string;
+  /** Retriever id to declare in a receipt minted from `results`. */
+  readonly retrieverId: typeof KNOWLEDGE_SEARCH_RETRIEVER_ID;
+  /**
+   * Digest of the retrieval settings this brief used. Pass it as the
+   * `configDigest` of the receipt's retriever identity. The running package
+   * version is the caller's to declare, because a bundled build cannot read it.
+   */
+  readonly retrieverConfigDigest: Sha256Digest;
+  readonly hits: readonly KnowledgeSearchHit[];
+  /** The ids a write should persist in `cites`, in rank order. */
+  readonly citationIds: readonly KnowledgeId[];
+  /** Ranked results in the shape `createKnowledgeRetrievalReceipt` takes. */
+  readonly results: readonly OriginatedKnowledgeSearchResult[];
+  /** Deterministic Markdown: one `- [id] title — snippet` line per page, in rank order. */
+  readonly text: string;
+}
+/**
+ * Rank the knowledge one question can see and render it for injection.
+ *
+ * The same page set produces the same brief on every run: ranking, ordering,
+ * and rendering are deterministic, and no field carries a timestamp.
+ */
+declare function buildKnowledgeBrief(visiblePages: readonly OriginatedPage[], question: string, options?: KnowledgeBriefOptions): KnowledgeBrief;
+//#endregion
+//#region src/knowledge-tools.d.ts
+interface CreateKnowledgeToolsOptions {
+  readonly stores: RunScopedStores;
+  /** The run whose store is written and whose chain is read. */
+  readonly runId: string;
+  /**
+   * Version of this package the host is running. A bundled build cannot read
+   * its own manifest, and a receipt that guessed the version would be a
+   * receipt that lies about what ranked the results.
+   */
+  readonly retrieverVersion: string;
+  readonly actorId?: string;
+  readonly pagesDirectory?: string;
+  /** Intake settings for `knowledge_record`. Absent leaves the write ungated. */
+  readonly intake?: Omit<KnowledgeWriteIntakeRequest, 'inheritedPages'>;
+  /** Brief settings for `knowledge_search`, overridden per call by the tool input. */
+  readonly brief?: Omit<KnowledgeBriefOptions, 'limit'>;
+  /** Durable sink for every minted retrieval receipt. */
+  readonly recordRetrieval?: (receipt: KnowledgeRetrievalReceipt) => Promise<void> | void;
+  readonly now?: () => Date;
+}
+/**
+ * The four tools an agent needs to use a knowledge store: search, read, record,
+ * resolve.
+ */
+declare function createKnowledgeTools(options: CreateKnowledgeToolsOptions): ToolDefinition[];
 //#endregion
 //#region src/lint.d.ts
 declare function lintKnowledgeIndex(index: KnowledgeIndex): KnowledgeLintFinding[];
@@ -3103,6 +3599,65 @@ declare function inspectPendingKnowledgeMutation(root: string): Promise<PendingK
 declare function recoverPendingKnowledgeMutation(root: string, options: RecoverPendingKnowledgeMutationOptions): Promise<void>;
 declare function withKnowledgeRead<T>(root: string, read: () => Promise<T> | T, options?: KnowledgeReadOptions): Promise<T>;
 //#endregion
+//#region src/promotion.d.ts
+declare const KNOWLEDGE_PROMOTION_SCHEMA_VERSION: '1.0.0';
+declare const KNOWLEDGE_PROMOTION_DIGEST_ALGORITHM: 'rfc8785-sha256';
+/** Root-relative directory holding one JSON record per promotion. */
+declare const KNOWLEDGE_PROMOTIONS_DIRECTORY = ".agent-knowledge/promotions";
+type KnowledgePromotionErrorCode = 'unknown-page' | 'ambiguous-support' | 'id-conflict' | 'path-conflict';
+/** A promotion that cannot be performed exactly as asked. */
+declare class KnowledgePromotionError extends Error {
+  readonly code: KnowledgePromotionErrorCode;
+  constructor(code: KnowledgePromotionErrorCode, message: string);
+}
+interface KnowledgePromotionEntry {
+  readonly pageId: KnowledgeId;
+  readonly path: string;
+  /** Where the page was read from in the source run's chain. */
+  readonly sourceOrigin: PageOrigin;
+  readonly pageDigest: Sha256Digest;
+  /** False when the page travelled only because a promoted page cites it. */
+  readonly requested: boolean;
+}
+/** Immutable record of one promotion into a shared store. */
+interface KnowledgePromotionRecord {
+  readonly schemaVersion: typeof KNOWLEDGE_PROMOTION_SCHEMA_VERSION;
+  readonly kind: 'knowledge-promotion';
+  readonly digestAlgorithm: typeof KNOWLEDGE_PROMOTION_DIGEST_ALGORITHM;
+  readonly recordDigest: Sha256Digest;
+  readonly createdAt: string;
+  readonly runId: string;
+  readonly actor: string;
+  readonly reason: string;
+  /** Promoted pages first, then carried support, each group in path order. */
+  readonly entries: readonly KnowledgePromotionEntry[];
+}
+interface PromoteRunScopedPagesOptions extends KnowledgePagesOptions {
+  /** Stable ids of the pages this run authored and wants in shared scope. */
+  readonly pageIds: readonly KnowledgeId[];
+  /** The curated store every run reads and no run writes directly. */
+  readonly sharedRoot: string;
+  /** Who decided to promote. */
+  readonly actor: string;
+  /** Why this knowledge belongs in shared scope. */
+  readonly reason: string;
+  readonly now?: () => Date;
+}
+/**
+ * Promote pages a run authored into the shared store, with their cited support.
+ *
+ * Support keeps its own evidence fields exactly as written, so a promoted claim
+ * cannot inherit a confidence its support does not carry. Pages travel as the
+ * bytes their store holds.
+ *
+ * Re-running the same promotion is safe: unchanged pages produce no file
+ * mutation and the record is content-addressed, so it lands at the same path
+ * with the same bytes.
+ */
+declare function promoteRunScopedPages(stores: RunScopedStores, runId: string, options: PromoteRunScopedPagesOptions): Promise<KnowledgePromotionRecord>;
+/** Read one promotion record written by `promoteRunScopedPages`. */
+declare function loadKnowledgePromotionRecord(sharedRoot: string, recordDigest: Sha256Digest): Promise<KnowledgePromotionRecord | null>;
+//#endregion
 //#region src/propose-from-finding.d.ts
 interface KnowledgeProposal {
   /**
@@ -3190,6 +3745,71 @@ interface KnowledgeBaseReadinessEvaluation {
 }
 declare function evaluateKnowledgeBaseReadiness(options: EvaluateKnowledgeBaseReadinessOptions): Promise<KnowledgeBaseReadinessEvaluation>;
 //#endregion
+//#region src/relation-graph.d.ts
+type KnowledgeRelationGraphErrorCode = 'invalid-node' | 'duplicate-node' | 'invalid-relation' | 'duplicate-relation' | 'undeclared-endpoint' | 'unknown-node' | 'invalid-query';
+/** A relation graph input or query that cannot be honored exactly. */
+declare class KnowledgeRelationGraphError extends Error {
+  readonly code: KnowledgeRelationGraphErrorCode;
+  constructor(code: KnowledgeRelationGraphErrorCode, message: string);
+}
+interface BuildKnowledgeRelationGraphInput {
+  /**
+   * Declared node inventory. When present, every relation endpoint must name
+   * one declared node; an undeclared endpoint is refused rather than added.
+   * When absent, the graph carries edges only and `nodes` is empty.
+   */
+  nodes?: readonly KnowledgeRelationNode[];
+  relations: readonly KnowledgeRelation[];
+}
+/**
+ * `out` follows `sourceId -> targetId`, `in` follows `targetId -> sourceId`,
+ * `both` follows a relation from either end.
+ */
+type KnowledgeRelationDirection = 'out' | 'in' | 'both';
+interface KnowledgeRelationQuery {
+  /** Restrict to relations with this predicate. Every predicate when absent. */
+  predicate?: string;
+  direction: KnowledgeRelationDirection;
+}
+interface KnowledgeRelationWalkOptions extends KnowledgeRelationQuery {
+  /** Most relations between the start node and a reported node. Unbounded when absent. */
+  maxDepth?: number;
+}
+interface KnowledgeRelationNeighbor {
+  nodeId: KnowledgeId;
+  relation: KnowledgeRelation;
+}
+interface KnowledgeRelationWalkStep {
+  nodeId: KnowledgeId;
+  /** Number of relations between the start node and this node. */
+  depth: number;
+  /** The node the search came from when it first reached this node. */
+  from: KnowledgeId;
+  relation: KnowledgeRelation;
+}
+/**
+ * Build a labeled multi-edge graph from caller relations.
+ *
+ * The graph keeps one edge per `(sourceId, targetId, predicate)`, in first-seen
+ * order. A repeated triple is accepted only when its weight and metadata are
+ * identical in canonical JSON; any other repeat is a conflict and is refused.
+ * Node and relation metadata must be finite, acyclic JSON so the graph
+ * round-trips through `KnowledgeRelationGraphSchema` unchanged.
+ */
+declare function buildKnowledgeRelationGraph(input: BuildKnowledgeRelationGraphInput): KnowledgeRelationGraph;
+/** Relations touching `id`, each with the node at the other end, in graph order. */
+declare function neighbors(graph: KnowledgeRelationGraph, id: KnowledgeId, query: KnowledgeRelationQuery): KnowledgeRelationNeighbor[];
+/**
+ * Breadth-first traversal from `id` over matching relations. Each reachable
+ * node is reported once, at the depth where the search first reached it; the
+ * start node is never reported, so a cycle back to it adds no step.
+ */
+declare function walk(graph: KnowledgeRelationGraph, id: KnowledgeId, options: KnowledgeRelationWalkOptions): KnowledgeRelationWalkStep[];
+/**
+ * Whether `to` is `from` or lies on a path of matching relations out of `from`.
+ */
+declare function isReachable(graph: KnowledgeRelationGraph, from: KnowledgeId, to: KnowledgeId, query: KnowledgeRelationQuery): boolean;
+//#endregion
 //#region src/release.d.ts
 interface KnowledgeReleaseReport {
   release: KnowledgeRelease;
@@ -3426,6 +4046,34 @@ declare const KnowledgeGraphEdgeSchema: z.ZodObject<{
   weight: z.ZodNumber;
   reasons: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
+declare const KnowledgeRelationSchema: z.ZodObject<{
+  sourceId: z.ZodString;
+  targetId: z.ZodString;
+  predicate: z.ZodString;
+  weight: z.ZodOptional<z.ZodNumber>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const KnowledgeRelationNodeSchema: z.ZodObject<{
+  id: z.ZodString;
+  kind: z.ZodString;
+  label: z.ZodOptional<z.ZodString>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const KnowledgeRelationGraphSchema: z.ZodObject<{
+  nodes: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>>;
+  edges: z.ZodArray<z.ZodObject<{
+    sourceId: z.ZodString;
+    targetId: z.ZodString;
+    predicate: z.ZodString;
+    weight: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
 declare const KnowledgeIndexSchema: z.ZodObject<{
   root: z.ZodString;
   generatedAt: z.ZodString;
@@ -3632,34 +4280,6 @@ declare const KnowledgeBaseCandidateSchema: z.ZodObject<{
   metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 //#endregion
-//#region src/search.d.ts
-interface SearchKnowledgeOptions {
-  /** Maximum results returned. Defaults to 10. */
-  limit?: number;
-  /** Match pages whose stable id is one of these values. */
-  pageIds?: readonly KnowledgeId[];
-  /** Match pages carrying at least one of these tags. */
-  tags?: readonly string[];
-  /** Match the exact string stored in `frontmatter.kind`. */
-  kinds?: readonly string[];
-  /** Additional caller-owned filter, applied before either ranking stage. */
-  predicate?: (page: KnowledgePage) => boolean;
-}
-/**
- * A retrieval result with an explicit citation handle.
- *
- * `citationId` is exactly `page.id`; later writes should persist this value
- * when they cite the page. Keeping it at the result's top level prevents tool
- * renderers from accidentally hiding the only stable handle a model can copy.
- */
-interface KnowledgeSearchHit extends KnowledgeSearchResult {
-  citationId: KnowledgeId;
-}
-declare function searchKnowledge(index: KnowledgeIndex, query: string, limit?: number): KnowledgeSearchHit[];
-declare function searchKnowledge(index: KnowledgeIndex, query: string, options?: SearchKnowledgeOptions): KnowledgeSearchHit[];
-declare function tokenizeQuery(query: string): string[];
-declare function reciprocalRankFusion(rankLists: string[][], k?: number): Map<string, number>;
-//#endregion
 //#region src/wikilinks.d.ts
 declare const WIKILINK_REGEX: RegExp;
 declare function extractWikilinks(content: string): string[];
@@ -3669,5 +4289,5 @@ declare function normalizeLinkTarget(target: string): string;
 declare function isSafeKnowledgePath(path: string, allowedPrefixes?: string[]): boolean;
 declare function parseKnowledgeWriteBlocks(text: string, allowedPrefixes?: string[]): KnowledgeWriteParseResult;
 //#endregion
-export { AdaptiveDecision, AdaptiveDriverOptions, AdaptiveResearchDriver, AdaptiveStats, AddSourceOptions, AddSourceTextInput, AgentMemoryAcquireRunLease, type AgentMemoryActivation, type AgentMemoryActivationDriver, AgentMemoryAdapter, type AgentMemoryAttemptEvent, AgentMemoryBranch, AgentMemoryBranchIsolation, AgentMemoryBranchLifetime, AgentMemoryBranchSnapshot, AgentMemoryContext, AgentMemoryControllerMode, type AgentMemoryDimensionComparison, type AgentMemoryEvidenceRef, type AgentMemoryExecutionContext, type AgentMemoryExecutionCostMeter, type AgentMemoryExecutionCostReceipt, type AgentMemoryExecutionPaidCallInput, type AgentMemoryExecutionPaidCallResult, type AgentMemoryExecutionStep, type AgentMemoryExperimentCandidate, type AgentMemoryExperimentCandidateRef, type AgentMemoryExperimentComparisonRef, type AgentMemoryExperimentRankingRow, type AgentMemoryExperimentRunLease, type AgentMemoryFinalEvaluation, type AgentMemoryFinalPair, type AgentMemoryForgettingComparison, AgentMemoryHit, AgentMemoryHitSchema, type AgentMemoryImprovementRunLease, AgentMemoryJournalEntry, AgentMemoryKind, AgentMemoryKindSchema, type AgentMemoryLearningArmOrder, type AgentMemoryLearningCandidateSummary, type AgentMemoryLearningCellComparison, type AgentMemoryLearningComparison, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, type AgentMemoryMode, type AgentMemoryPromotionDecision, AgentMemoryRunLease, AgentMemoryScope, AgentMemoryScopeSchema, AgentMemorySearchOptions, type AgentMemorySequence, type AgentMemorySequenceArtifact, type AgentMemorySequenceProbe, type AgentMemorySequenceProbeResult, type AgentMemorySequenceScenario, type AgentMemorySequenceStep, AgentMemorySharingPolicy, type AgentMemoryTransferCellComparison, type AgentMemoryTransferStepSummary, AgentMemoryVisibility, AgentMemoryWriteInput, AgentMemoryWriteInputSchema, AgentMemoryWriteResult, ApplyWriteBlocksResult, AuditKnowledgeCitationsOptions, type BuildAgentMemorySequencesFromBenchmarkCasesOptions, BuildEvalKnowledgeBundleOptions, type BuildRetrievalBenchmarkCasesFromQrelsOptions, BuildRetrievalEvalDispatchOptions, CHECKABLE_RUNG_THRESHOLD, CheckExecution, ChunkingOptions, ClaimEvidence, ClaimGrade, ClaimGroundingDriverOptions, ClaimLedgerGoalConflictError, ClaimLedgerMigrationRequiredError, ClaimLedgerStore, ClaimRef, ClaimVerdict, CompanyEvalCase, type CompareAgentMemoryLearningOptions, CornellLiiSelector, CornellLiiSourceOptions, CreateAgentMemoryBranchOptions, CreateKnowledgeRetrievalReceiptInput, CreateKnowledgeUseReceiptInput, D1Adapter, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, DedupReason, DeepQuestion, DeepQuestionKind, DeepQuestionSchema, DefineReadinessSpecInput, DetectChangesOptions, DetectChangesResult, DiscoveryLoopResult, DiscoveryLoopRound, DiscoveryLoopStopReason, DiscoveryResult, DiscoveryTask, DriverResearchContext, EvalKnowledgeBundleBuildResult, EvaluateKnowledgeBaseReadinessOptions, EvidenceRung, ExpectedGroup, type ExternalRagEvalScore, FactResult, FetchOpts, FileSystemFreshnessStoreOptions, FileSystemKbStore, FileSystemKbStoreOptions, FileSystemSearchOptions, FileSystemSearchProvider, FileSystemSearchProviderOptions, ForkAgentMemoryBranchSnapshotOptions, FragmentProvenance, FreshnessKey, FreshnessMark, FreshnessRecord, FreshnessTtl, GraphitiMcpClientLike, GraphitiMemoryAdapterOptions, GraphitiToolNames, GroundClaimOptions, GroundingResult, INDUSTRY_MEMORY_BENCHMARKS, INDUSTRY_RAG_BENCHMARKS, IRS_DIMENSION_HINTS, type ImproveSelectedKnowledgeCandidateOptions, type ImproveSelectedKnowledgeCandidateResult, IrsPublicationsSourceOptions, KB_CLAIM_LEDGER_DIR, KB_EVENTS_PATH, KB_INDEX_PATH, KB_STORE_DIR, KNOWLEDGE_EVENT_TYPES, KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, KbStore, type KnowledgeAnswerBenchmarkCase, type KnowledgeAnswerBenchmarkTaskKind, KnowledgeBaseCandidate, KnowledgeBaseCandidateSchema, type KnowledgeBaseQualityOptions, type KnowledgeBaseQualityReport, KnowledgeBaseReadinessEvaluation, type KnowledgeBenchmarkArtifact, type KnowledgeBenchmarkCase, type KnowledgeBenchmarkCaseBase, type KnowledgeBenchmarkDistribution, type KnowledgeBenchmarkEvaluation, type KnowledgeBenchmarkFamily, type KnowledgeBenchmarkReport, type KnowledgeBenchmarkResponder, type KnowledgeBenchmarkScenario, type KnowledgeBenchmarkSliceSummary, type KnowledgeBenchmarkSource, type KnowledgeBenchmarkSpec, type KnowledgeBenchmarkSplit, type KnowledgeBenchmarkTaskKind, KnowledgeChange, KnowledgeChangeKind, KnowledgeChunk, KnowledgeCitationAuditError, KnowledgeCitationAuditIssue, KnowledgeCitationAuditIssueKind, KnowledgeCitationAuditReport, KnowledgeCitationCandidate, KnowledgeCitationReference, KnowledgeCitationResolution, KnowledgeCitationResolutionError, KnowledgeCitationResolutionStatus, KnowledgeClaim, type KnowledgeClaimMatcher, KnowledgeConsumerKind, KnowledgeConsumerRef, KnowledgeControlLoopAction, KnowledgeControlLoopActionResult, KnowledgeControlLoopAdapter, KnowledgeControlLoopAdapterOptions, KnowledgeControlLoopState, KnowledgeDiscoveryDispatcher, KnowledgeDiscoveryWorker, type KnowledgeEvaluationPhase, KnowledgeEvent, KnowledgeEventQuery, KnowledgeEventSchema, KnowledgeEventType, KnowledgeExplanation, KnowledgeFragment, KnowledgeFreshnessStore, KnowledgeGap, KnowledgeGraph, KnowledgeGraphEdge, KnowledgeGraphEdgeSchema, KnowledgeGraphNode, KnowledgeGraphNodeSchema, KnowledgeId, type KnowledgeImprovementActivationPersistence, type KnowledgeImprovementCandidateRecord, type KnowledgeImprovementCandidateRef, KnowledgeImprovementCandidateRefSchema, type KnowledgeImprovementEvaluationInput, type KnowledgeImprovementEvaluator, type KnowledgeImprovementEvent, type KnowledgeImprovementEvidence, KnowledgeImprovementEvidenceSchema, type KnowledgeImprovementMetric, type KnowledgeImprovementMetricProvenance, type KnowledgeImprovementMutationReceipt, type KnowledgeImprovementMutationResult, type KnowledgeImprovementOptions, type KnowledgeImprovementRagOptimizationOptions, type KnowledgeImprovementRagOptimizationRunInput, type KnowledgeImprovementResult, type KnowledgeImprovementRetrievalOptions, type KnowledgeImprovementRunState, KnowledgeImprovementRunStateSchema, type KnowledgeImprovementStatus, type KnowledgeImprovementTarget, type KnowledgeImprovementUpdate, type KnowledgeImprovementUpdateInput, KnowledgeIndex, KnowledgeIndexSchema, KnowledgeInspection, KnowledgeLayout, KnowledgeLintFinding, type KnowledgeMemoryBenchmarkCase, type KnowledgeMemoryBenchmarkTaskKind, type KnowledgeMemoryEvent, type KnowledgeMemoryFactMatcher, type KnowledgeMutationLock, type KnowledgeMutationOptions, KnowledgePage, KnowledgePageInvalidation, KnowledgePageInvalidationSchema, KnowledgePageSchema, KnowledgePolicy, type KnowledgePolicyDispatch, KnowledgeProposal, KnowledgeProposalParseError, type KnowledgeReadOptions, KnowledgeReadinessSpec, KnowledgeReceiptAttributeValue, KnowledgeRelation, KnowledgeRelease, KnowledgeReleaseInput, KnowledgeReleaseReport, KnowledgeResearchLoopContext, KnowledgeResearchLoopDecision, KnowledgeResearchLoopResult, KnowledgeResearchLoopStep, type KnowledgeRetrievalBenchmarkCase, type KnowledgeRetrievalBenchmarkQrel, type KnowledgeRetrievalBenchmarkQuery, KnowledgeRetrievalReceipt, KnowledgeRetrievalResultReceipt, KnowledgeRetrieverIdentity, KnowledgeSearchHit, KnowledgeSearchResult, KnowledgeSource, KnowledgeUnit, KnowledgeUseReceipt, KnowledgeUseRelation, KnowledgeUsedResult, KnowledgeVisibilitySnapshot, KnowledgeVisibilitySnapshotEntry, KnowledgeWriteBlock, KnowledgeWriteParseResult, type LoadKnowledgeImprovementActivationResultOptions, LoadKnowledgePagesOptions, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, MaterialFact, MaterialFactLens, MaterialFactsResult, type MeasuredKnowledgeSelectionReceipt, Mem0ClientMode, Mem0HostedClient, Mem0HostedMemoryAdapterOptions, Mem0MemoryAdapterOptions, Mem0OssClient, Mem0OssMemoryAdapterOptions, type MemoryAdapterBenchmarkCandidate, type MemoryAdapterBenchmarkRankingRow, type MemoryConfigScenario, MemoryKbStore, type NearDuplicateDetectionOptions, type NearDuplicatePair, type NearDuplicateReport, Neo4jAgentMemoryAdapterOptions, type OptimizeKnowledgeBasePolicyOptions, type OptimizeKnowledgeBasePolicyResult, OriginatedKnowledgeSearchResult, OriginatedPage, OwnedAgentMemoryRunLease, POLITE_USER_AGENT, PageOrigin, ParsedFrontmatter, PartitionRetrievalScenariosOptions, type PendingKnowledgeMutation, PersistentResearchDrivingDriverOptions, PoliteFetchOptions, PoliteFetchResult, type PromoteKnowledgeCandidateOptions, ProposeFromFindingsResult, READINESS_SPEC_DEFAULTS, RUN_LINEAGE_BASENAME, type RagAnswerEvalArtifact, type RagAnswerEvalCase, type RagAnswerEvalScenario, type RagAnswerMetricSummary, type RagAnswerQualityHookOptions, RagAnswerQualityInput, type RagAnswerQualityJudgeOptions, RagAnswerQualityResult, type RagCalibrationOptions, type RagCalibrationResult, RagDiagnosisInput, type RagEvalCitation, type RagEvalClaim, type RagEvalContext, type RagEvalMetricKey, type RagEvalProvider, type RagEvalSlice, RagGapFinding, RagGapKind, RagGapSeverity, RagKnowledgeAcquisitionInput, RagKnowledgeImprovementPhase, RagKnowledgeImprovementPhaseResult, RagKnowledgeImprovementPhaseStatus, RagKnowledgeResearchOptions, RagKnowledgeUpdateInput, RagKnowledgeUpdateResult, RagOptimizationConfig, RagOptimizationSelection, RagPhaseInputBase, RagPromotionInput, RagPromotionResult, type RagRequiredContext, type RecoverPendingKnowledgeMutationOptions, RegularFileSnapshot, RejectedSource, ResearchClaimEvidence, ResearchClaimEvidenceSchema, ResearchClaimLedger, ResearchClaimLedgerSchema, ResearchClaimRecord, ResearchClaimRecordSchema, ResearchContribution, ResearchDriver, ResearchDrivingDriver, ResearchDrivingDriverOptions, ResearchDrivingState, ResearchDrivingSteer, ResearchSourceProposal, ResearchSourceVersion, ResearchSourceVersionSchema, ResearchWorker, type ResolvedKnowledgeImprovementCandidate, type ResolvedKnowledgeImprovementComparison, type ResolvedKnowledgeImprovementComparisonSnapshot, type RestoreKnowledgeCandidateBaselineOptions, RetrievalConfig, RetrievalEvalArtifact, RetrievalEvalRetriever, RetrievalEvalRetrieverInput, RetrievalEvalRetrieverResult, RetrievalEvalScenario, RetrievalGoldTarget, RetrievalHoldoutBypassReason, RetrievalHoldoutCallContext, RetrievalHoldoutConfig, RetrievalHoldoutEligibleItem, RetrievalHoldoutEvent, RetrievalHoldoutOffPolicyOptions, RetrievalHoldoutOffPolicyResult, RetrievalHoldoutResult, RetrievalHoldoutSessionState, RetrievalHoldoutSessionSummary, RetrievalMetricSummary, RetrievalMetricWeights, RetrievalOptimizationSelection, RetrievalRecallJudgeOptions, RetrievalScenarioPartitions, RetrievedKnowledgeHit, RetrievedSourceSpan, RouterClient, RouterError, RouterUsage, type RunAgentMemoryExperimentOptions, type RunAgentMemoryExperimentResult, type RunAgentMemoryImprovementOptions, type RunAgentMemoryImprovementResult, type RunAgentMemoryLearningExperimentOptions, type RunAgentMemoryLearningExperimentResult, RunDiscoveryLoopOptions, type RunKnowledgeBenchmarkSuiteOptions, type RunKnowledgeBenchmarkSuiteResult, RunKnowledgeResearchLoopOptions, RunLineageAuthority, RunLineageRecord, type RunMemoryAdapterBenchmarkOptions, type RunMemoryAdapterBenchmarkResult, RunRagKnowledgeImprovementLoopOptions, RunRagKnowledgeImprovementLoopResult, RunRagOptimizationOptions, RunRagOptimizationResult, RunRetrievalImprovementLoopOptions, RunRetrievalImprovementLoopResult, RunScopedStores, RunScopedStoresOptions, RunSerializedKnowledgeOptimizationOptions, RunSerializedKnowledgeOptimizationResult, SCAFFOLD_PAGE_BASENAMES, SearchKnowledgeOptions, SerializedCandidate, SerializedCandidateCodec, SourceAdapter, SourceAdapterInput, SourceAdapterOutput, SourceAnchor, SourceAnchorSchema, SourceFreshnessInspection, SourceRecord, SourceRecordSchema, SourceRegistry, SourceVerdict, SourceVerificationContext, StateSosEntity, StateSosSourceConfig, TangleRouterOptions, ThesisRunOptions, ThesisRunResult, ThesisTaskInput, TrackedClaim, TriageClass, UncheckableClaimError, type UseKnowledgeImprovementCandidateOptions, ValidateKnowledgeOptions, ValidateKnowledgeResult, VerifiedGradeableEvidence, VerifiedResearchLoopOptions, VerifiedResearchLoopResult, VerifiedResearchRound, VerifyGradeableEvidenceOptions, VerifyingDriverOptions, WIKILINK_REGEX, WebResearchWorkerOptions, WebSearchHit, WorkerClaimDecorationOptions, WorkerResearchContext, __resetHttpThrottle, acquireAgentMemoryRunLease, addSourcePath, addSourceText, agentMemorySequenceJudge, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, assertClaimLedgerId, assertCurrentRunCitationsResolved, assertDeepQuestionIntegrity, assertGradeableEvidence, assertKnowledgeCitationAudit, assertKnowledgeCitationsResolved, assertKnowledgeRetrievalMatchesVisibility, assertResearchClaimEvidenceIntegrity, assertResearchClaimLedgerIntegrity, assertRunScopedCitationsResolved, assertTrackedClaimIntegrity, auditCurrentRunCitations, auditKnowledgeCitations, buildAgentMemorySequenceScenarios, buildAgentMemorySequencesFromBenchmarkCases, buildEvalKnowledgeBundle, buildFirstPartyMemoryLifecycleBenchmarkCases, buildIndustryMemoryBenchmarkSmokeCases, buildIndustryRagBenchmarkSmokeCases, buildKnowledgeBenchmarkScenarios, buildKnowledgeGraph, buildKnowledgeIndex, buildRetrievalBenchmarkCasesFromQrels, buildRetrievalEvalDispatch, calibrateRagAnswerJudge, canonicalizeUrl, chunkMarkdown, citedClaimKey, citedClaimOf, claimEvidenceId, claimId, claimSourceHost, compareAgentMemoryLearning, contentKey, createAdaptiveResearchDriver, createAgentMemoryBranch, createClaimDecorator, createClaimGroundingVerifier, createCollectionResearchDriver, createCornellLiiSource, createD1FreshnessStoreStub, createFileRunLineageAuthority, createFileSystemFreshnessStore, createFileSystemSearchProvider, createGraphitiMemoryAdapter, createInMemoryBenchmarkAdapter, createIrsPublicationsSource, createKnowledgeControlLoopAdapter, createKnowledgeEvent, createKnowledgeRetrievalReceipt, createKnowledgeUseReceipt, createKnowledgeVisibilitySnapshot, createLocalDiscoveryDispatcher, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, createNoopMemoryBenchmarkAdapter, createPersistentResearchDrivingDriver, createRagAnswerQualityHook, createResearchDrivingDriver, createRunScopedStores, createStateSosSource, createTangleRouterClient, createVerifyingResearchDriver, createWebResearchWorker, deepQuestionId, defaultGetMemoryContext, defineReadinessSpec, detectChanges, detectNearDuplicatePages, deterministicRng, diagnoseRagAnswerFailure, emitRetrievalHoldoutBypass, emptyClaimLedger, evaluateKnowledgeBaseReadiness, explainKnowledgeTarget, extractLinks, extractWikilinks, firstMatch, forkAgentMemoryBranchSnapshot, formatFrontmatter, formatKnowledgeCitationReference, fromAgentCandidateKnowledgeRef, gradeCompanyAgainstText, gradeFactAgainstText, gradeFor, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, htmlToText, improveKnowledgeBase, improveSelectedKnowledgeCandidate, initKnowledgeBase, innerHtmlById, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, investmentThesisSet, isKernelAnchoredPath, isKnowledgeMemoryBenchmarkCase, isMissingFile, isSafeKnowledgePath, isScaffoldPath, jsonCandidateCodec, jsonObjectCandidateCodec, kbIndexToText, knowledgeBenchmarkJudge, knowledgeCitationAuditFindings, knowledgeImprovementCandidateRef, knowledgeImprovementRunDir, knowledgeImprovementRunId, knowledgePageDigest, knowledgeReleaseReport, layoutFor, lensDistribution, linkClaimContradictions, lintCurrentRunCitations, lintKnowledgeIndex, listRegularFilesWithinRoot, loadKnowledgeImprovementActivationResult, loadKnowledgeImprovementEvents, loadKnowledgeImprovementState, loadKnowledgePages, loadSourceRegistry, looksLikeBlockPage, materialFactsSurfaced, materialFactsSurfacedInText, materializeRegisteredClaimEvidence, mediaTypeFor, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, mergeClaimLedgers, mergeTrackedClaims, normalizeClaimText, normalizeExternalRagScores, normalizeLinkTarget, normalizePageText, optimizeKnowledgeBasePolicy, parseFrontmatter, parseKnowledgeBenchmarkJsonl, parseKnowledgeBenchmarkQrels, parseKnowledgeCitationReference, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, politeFetch, promoteKnowledgeCandidate, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, removeDurable, renameDurable, renderKnowledgeBenchmarkReportMarkdown, renderMemoryContext, researchSourceVersionKey, resetRetrievalHoldoutRegistry, resolveKnowledgeCitation, resolveKnowledgeCitations, resolveMemoryCleanupTimeoutMs, resolveRunScopedCitation, resolveRunScopedCitations, respondToIndustryMemoryBenchmarkSmokeCase, respondToIndustryRagBenchmarkSmokeCase, restoreKnowledgeCandidateBaseline, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runAgentMemoryExperiment, runAgentMemoryImprovement, runAgentMemoryLearningExperiment, 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, verdictFor, verifyGradeableEvidence, verifyKnowledgeRetrievalReceipt, verifyKnowledgeUseReceipt, withCitedClaim, withKnowledgeImprovementCandidate, withKnowledgeImprovementComparison, withKnowledgeMutation, withKnowledgeRead, withSafeDescendant, withSafeDirectory, writeFileDurable, writeFileDurableWithinRoot, writeJson, writeJsonDurable, writeJsonDurableWithinRoot, writeKnowledgeIndex, writeSourceRegistry };
+export { AdaptiveDecision, AdaptiveDriverOptions, AdaptiveResearchDriver, AdaptiveStats, AddSourceOptions, AddSourceTextInput, AgentMemoryAcquireRunLease, type AgentMemoryActivation, type AgentMemoryActivationDriver, AgentMemoryAdapter, type AgentMemoryAttemptEvent, AgentMemoryBranch, AgentMemoryBranchIsolation, AgentMemoryBranchLifetime, AgentMemoryBranchSnapshot, AgentMemoryContext, AgentMemoryControllerMode, type AgentMemoryDimensionComparison, type AgentMemoryEvidenceRef, type AgentMemoryExecutionContext, type AgentMemoryExecutionCostMeter, type AgentMemoryExecutionCostReceipt, type AgentMemoryExecutionPaidCallInput, type AgentMemoryExecutionPaidCallResult, type AgentMemoryExecutionStep, type AgentMemoryExperimentCandidate, type AgentMemoryExperimentCandidateRef, type AgentMemoryExperimentComparisonRef, type AgentMemoryExperimentRankingRow, type AgentMemoryExperimentRunLease, type AgentMemoryFinalEvaluation, type AgentMemoryFinalPair, type AgentMemoryForgettingComparison, AgentMemoryHit, AgentMemoryHitSchema, type AgentMemoryImprovementRunLease, AgentMemoryJournalEntry, AgentMemoryKind, AgentMemoryKindSchema, type AgentMemoryLearningArmOrder, type AgentMemoryLearningCandidateSummary, type AgentMemoryLearningCellComparison, type AgentMemoryLearningComparison, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, type AgentMemoryMode, type AgentMemoryPromotionDecision, AgentMemoryRunLease, AgentMemoryScope, AgentMemoryScopeSchema, AgentMemorySearchOptions, type AgentMemorySequence, type AgentMemorySequenceArtifact, type AgentMemorySequenceProbe, type AgentMemorySequenceProbeResult, type AgentMemorySequenceScenario, type AgentMemorySequenceStep, AgentMemorySharingPolicy, type AgentMemoryTransferCellComparison, type AgentMemoryTransferStepSummary, AgentMemoryVisibility, AgentMemoryWriteInput, AgentMemoryWriteInputSchema, AgentMemoryWriteResult, ApplyKnowledgeWriteBlocksOptions, ApplyWriteBlocksResult, AuditKnowledgeCitationsOptions, Bm25Hit, Bm25Options, type BuildAgentMemorySequencesFromBenchmarkCasesOptions, BuildEvalKnowledgeBundleOptions, BuildKnowledgeRelationGraphInput, type BuildRetrievalBenchmarkCasesFromQrelsOptions, BuildRetrievalEvalDispatchOptions, CHECKABLE_RUNG_THRESHOLD, CITES_INVALIDATED_FIELD, CheckExecution, ChunkingOptions, ClaimEvidence, ClaimGrade, ClaimGroundingDriverOptions, ClaimLedgerGoalConflictError, ClaimLedgerMigrationRequiredError, ClaimLedgerStore, ClaimRef, ClaimVerdict, CompanyEvalCase, type CompareAgentMemoryLearningOptions, CornellLiiSelector, CornellLiiSourceOptions, CreateAgentMemoryBranchOptions, CreateKnowledgeRetrievalDispositionInput, CreateKnowledgeRetrievalReceiptInput, CreateKnowledgeToolsOptions, CreateKnowledgeUseReceiptInput, D1Adapter, DEFAULT_KNOWLEDGE_BRIEF_LIMIT, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, DEFAULT_PAGES_DIRECTORY, DedupReason, DeepQuestion, DeepQuestionKind, DeepQuestionSchema, DefineReadinessSpecInput, DetectChangesOptions, DetectChangesResult, DiscoveryLoopResult, DiscoveryLoopRound, DiscoveryLoopStopReason, DiscoveryResult, DiscoveryTask, DriverResearchContext, EvalKnowledgeBundleBuildResult, EvaluateKnowledgeBaseReadinessOptions, EvidenceRung, ExpectedGroup, type ExternalRagEvalScore, FactResult, FetchOpts, FileSystemFreshnessStoreOptions, FileSystemKbStore, FileSystemKbStoreOptions, FileSystemSearchOptions, FileSystemSearchProvider, FileSystemSearchProviderOptions, ForkAgentMemoryBranchSnapshotOptions, FragmentProvenance, FreshnessKey, FreshnessMark, FreshnessRecord, FreshnessTtl, GraphitiMcpClientLike, GraphitiMemoryAdapterOptions, GraphitiToolNames, GroundClaimOptions, GroundingResult, INDUSTRY_MEMORY_BENCHMARKS, INDUSTRY_RAG_BENCHMARKS, IRS_DIMENSION_HINTS, type ImproveSelectedKnowledgeCandidateOptions, type ImproveSelectedKnowledgeCandidateResult, IrsPublicationsSourceOptions, KB_CLAIM_LEDGER_DIR, KB_EVENTS_PATH, KB_INDEX_PATH, KB_STORE_DIR, KNOWLEDGE_EVENT_TYPES, KNOWLEDGE_PROMOTIONS_DIRECTORY, KNOWLEDGE_PROMOTION_DIGEST_ALGORITHM, KNOWLEDGE_PROMOTION_SCHEMA_VERSION, KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, KNOWLEDGE_SEARCH_RETRIEVER_ID, KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, KbStore, type KnowledgeAnswerBenchmarkCase, type KnowledgeAnswerBenchmarkTaskKind, KnowledgeBaseCandidate, KnowledgeBaseCandidateSchema, type KnowledgeBaseQualityOptions, type KnowledgeBaseQualityReport, KnowledgeBaseReadinessEvaluation, type KnowledgeBenchmarkArtifact, type KnowledgeBenchmarkCase, type KnowledgeBenchmarkCaseBase, type KnowledgeBenchmarkDistribution, type KnowledgeBenchmarkEvaluation, type KnowledgeBenchmarkFamily, type KnowledgeBenchmarkReport, type KnowledgeBenchmarkResponder, type KnowledgeBenchmarkScenario, type KnowledgeBenchmarkSliceSummary, type KnowledgeBenchmarkSource, type KnowledgeBenchmarkSpec, type KnowledgeBenchmarkSplit, type KnowledgeBenchmarkTaskKind, KnowledgeBrief, KnowledgeBriefOptions, KnowledgeChange, KnowledgeChangeKind, KnowledgeChunk, KnowledgeCitationAuditError, KnowledgeCitationAuditIssue, KnowledgeCitationAuditIssueKind, KnowledgeCitationAuditReport, KnowledgeCitationCandidate, KnowledgeCitationReference, KnowledgeCitationResolution, KnowledgeCitationResolutionError, KnowledgeCitationResolutionStatus, KnowledgeClaim, type KnowledgeClaimMatcher, KnowledgeConsumerKind, KnowledgeConsumerRef, KnowledgeControlLoopAction, KnowledgeControlLoopActionResult, KnowledgeControlLoopAdapter, KnowledgeControlLoopAdapterOptions, KnowledgeControlLoopState, KnowledgeDiscoveryDispatcher, KnowledgeDiscoveryWorker, KnowledgeDuplicateIntakeError, KnowledgeDuplicateIntakePair, type KnowledgeEvaluationPhase, KnowledgeEvent, KnowledgeEventQuery, KnowledgeEventSchema, KnowledgeEventType, KnowledgeExplanation, KnowledgeFragment, KnowledgeFreshnessStore, KnowledgeGap, KnowledgeGraph, KnowledgeGraphEdge, KnowledgeGraphEdgeSchema, KnowledgeGraphNode, KnowledgeGraphNodeSchema, KnowledgeId, type KnowledgeImprovementActivationPersistence, type KnowledgeImprovementCandidateRecord, type KnowledgeImprovementCandidateRef, KnowledgeImprovementCandidateRefSchema, type KnowledgeImprovementEvaluationInput, type KnowledgeImprovementEvaluator, type KnowledgeImprovementEvent, type KnowledgeImprovementEvidence, KnowledgeImprovementEvidenceSchema, type KnowledgeImprovementMetric, type KnowledgeImprovementMetricProvenance, type KnowledgeImprovementMutationReceipt, type KnowledgeImprovementMutationResult, type KnowledgeImprovementOptions, type KnowledgeImprovementRagOptimizationOptions, type KnowledgeImprovementRagOptimizationRunInput, type KnowledgeImprovementResult, type KnowledgeImprovementRetrievalOptions, type KnowledgeImprovementRunState, KnowledgeImprovementRunStateSchema, type KnowledgeImprovementStatus, type KnowledgeImprovementTarget, type KnowledgeImprovementUpdate, type KnowledgeImprovementUpdateInput, KnowledgeIndex, KnowledgeIndexSchema, KnowledgeInspection, KnowledgeInvalidationPlan, KnowledgeInvalidationStamp, KnowledgeLayout, KnowledgeLexicalFieldBoosts, KnowledgeLexicalIndex, KnowledgeLexicalIndexOptions, KnowledgeLexicalPosting, KnowledgeLintFinding, type KnowledgeMemoryBenchmarkCase, type KnowledgeMemoryBenchmarkTaskKind, type KnowledgeMemoryEvent, type KnowledgeMemoryFactMatcher, type KnowledgeMutationLock, type KnowledgeMutationOptions, KnowledgePage, KnowledgePageInvalidation, KnowledgePageInvalidationSchema, KnowledgePageRelation, KnowledgePageRelationPredicate, KnowledgePageSchema, KnowledgePagesOptions, KnowledgePolicy, type KnowledgePolicyDispatch, KnowledgePromotionEntry, KnowledgePromotionError, KnowledgePromotionErrorCode, KnowledgePromotionRecord, KnowledgeProposal, KnowledgeProposalParseError, type KnowledgeReadOptions, KnowledgeReadinessSpec, KnowledgeReceiptAttributeValue, KnowledgeRelation, KnowledgeRelationDirection, KnowledgeRelationGraph, KnowledgeRelationGraphError, KnowledgeRelationGraphErrorCode, KnowledgeRelationGraphSchema, KnowledgeRelationNeighbor, KnowledgeRelationNode, KnowledgeRelationNodeSchema, KnowledgeRelationQuery, KnowledgeRelationSchema, KnowledgeRelationWalkOptions, KnowledgeRelationWalkStep, KnowledgeRelease, KnowledgeReleaseInput, KnowledgeReleaseReport, KnowledgeResearchLoopContext, KnowledgeResearchLoopDecision, KnowledgeResearchLoopResult, KnowledgeResearchLoopStep, type KnowledgeRetrievalBenchmarkCase, type KnowledgeRetrievalBenchmarkQrel, type KnowledgeRetrievalBenchmarkQuery, KnowledgeRetrievalDisposition, KnowledgeRetrievalDispositionRelation, KnowledgeRetrievalReceipt, KnowledgeRetrievalResultReceipt, KnowledgeRetrieverIdentity, KnowledgeSearchHit, KnowledgeSearchResult, KnowledgeSource, KnowledgeUnit, KnowledgeUseReceipt, KnowledgeUseRelation, KnowledgeUsedResult, KnowledgeVisibilityArtifactLoader, KnowledgeVisibilityArtifactRef, KnowledgeVisibilityRef, KnowledgeVisibilitySnapshot, KnowledgeVisibilitySnapshotEntry, KnowledgeVisibilityUnavailableError, KnowledgeVisibilityUnavailableReason, KnowledgeWriteBlock, KnowledgeWriteIntakeOptions, KnowledgeWriteIntakeRequest, KnowledgeWriteParseResult, type LoadKnowledgeImprovementActivationResultOptions, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, MaterialFact, MaterialFactLens, MaterialFactsResult, type MeasuredKnowledgeSelectionReceipt, Mem0ClientMode, Mem0HostedClient, Mem0HostedMemoryAdapterOptions, Mem0MemoryAdapterOptions, Mem0OssClient, Mem0OssMemoryAdapterOptions, type MemoryAdapterBenchmarkCandidate, type MemoryAdapterBenchmarkRankingRow, type MemoryConfigScenario, MemoryKbStore, type NearDuplicateDetectionOptions, type NearDuplicatePair, type NearDuplicateReport, Neo4jAgentMemoryAdapterOptions, type OptimizeKnowledgeBasePolicyOptions, type OptimizeKnowledgeBasePolicyResult, OriginatedKnowledgeSearchResult, OriginatedPage, OwnedAgentMemoryRunLease, POLITE_USER_AGENT, PageOrigin, ParsedFrontmatter, PartitionRetrievalScenariosOptions, type PendingKnowledgeMutation, PersistentResearchDrivingDriverOptions, PoliteFetchOptions, PoliteFetchResult, type PromoteKnowledgeCandidateOptions, PromoteRunScopedPagesOptions, ProposeFromFindingsResult, READINESS_SPEC_DEFAULTS, RUN_LINEAGE_BASENAME, type RagAnswerEvalArtifact, type RagAnswerEvalCase, type RagAnswerEvalScenario, type RagAnswerMetricSummary, type RagAnswerQualityHookOptions, RagAnswerQualityInput, type RagAnswerQualityJudgeOptions, RagAnswerQualityResult, type RagCalibrationOptions, type RagCalibrationResult, RagDiagnosisInput, type RagEvalCitation, type RagEvalClaim, type RagEvalContext, type RagEvalMetricKey, type RagEvalProvider, type RagEvalSlice, RagGapFinding, RagGapKind, RagGapSeverity, RagKnowledgeAcquisitionInput, RagKnowledgeImprovementPhase, RagKnowledgeImprovementPhaseResult, RagKnowledgeImprovementPhaseStatus, RagKnowledgeResearchOptions, RagKnowledgeUpdateInput, RagKnowledgeUpdateResult, RagOptimizationConfig, RagOptimizationSelection, RagPhaseInputBase, RagPromotionInput, RagPromotionResult, type RagRequiredContext, type RecoverPendingKnowledgeMutationOptions, RegularFileSnapshot, RejectedSource, ResearchClaimEvidence, ResearchClaimEvidenceSchema, ResearchClaimLedger, ResearchClaimLedgerSchema, ResearchClaimRecord, ResearchClaimRecordSchema, ResearchContribution, ResearchDriver, ResearchDrivingDriver, ResearchDrivingDriverOptions, ResearchDrivingState, ResearchDrivingSteer, ResearchSourceProposal, ResearchSourceVersion, ResearchSourceVersionSchema, ResearchWorker, type ResolvedKnowledgeImprovementCandidate, type ResolvedKnowledgeImprovementComparison, type ResolvedKnowledgeImprovementComparisonSnapshot, type RestoreKnowledgeCandidateBaselineOptions, RetrievalConfig, RetrievalEvalArtifact, RetrievalEvalRetriever, RetrievalEvalRetrieverInput, RetrievalEvalRetrieverResult, RetrievalEvalScenario, RetrievalGoldTarget, RetrievalHoldoutBypassReason, RetrievalHoldoutCallContext, RetrievalHoldoutConfig, RetrievalHoldoutEligibleItem, RetrievalHoldoutEvent, RetrievalHoldoutOffPolicyOptions, RetrievalHoldoutOffPolicyResult, RetrievalHoldoutResult, RetrievalHoldoutSessionState, RetrievalHoldoutSessionSummary, RetrievalMetricSummary, RetrievalMetricWeights, RetrievalOptimizationSelection, RetrievalRecallJudgeOptions, RetrievalScenarioPartitions, RetrievedKnowledgeHit, RetrievedSourceSpan, RouterClient, RouterError, RouterUsage, type RunAgentMemoryExperimentOptions, type RunAgentMemoryExperimentResult, type RunAgentMemoryImprovementOptions, type RunAgentMemoryImprovementResult, type RunAgentMemoryLearningExperimentOptions, type RunAgentMemoryLearningExperimentResult, RunDiscoveryLoopOptions, type RunKnowledgeBenchmarkSuiteOptions, type RunKnowledgeBenchmarkSuiteResult, RunKnowledgeResearchLoopOptions, RunLineageAuthority, RunLineageRecord, type RunMemoryAdapterBenchmarkOptions, type RunMemoryAdapterBenchmarkResult, RunRagKnowledgeImprovementLoopOptions, RunRagKnowledgeImprovementLoopResult, RunRagOptimizationOptions, RunRagOptimizationResult, RunRetrievalImprovementLoopOptions, RunRetrievalImprovementLoopResult, RunScopedStores, RunScopedStoresOptions, RunSerializedKnowledgeOptimizationOptions, RunSerializedKnowledgeOptimizationResult, SCAFFOLD_PAGE_BASENAMES, SearchKnowledgeOptions, SerializedCandidate, SerializedCandidateCodec, SourceAdapter, SourceAdapterInput, SourceAdapterOutput, SourceAnchor, SourceAnchorSchema, SourceFreshnessInspection, SourceRecord, SourceRecordSchema, SourceRegistry, SourceVerdict, SourceVerificationContext, StateSosEntity, StateSosSourceConfig, TangleRouterOptions, ThesisRunOptions, ThesisRunResult, ThesisTaskInput, TrackedClaim, TriageClass, UncheckableClaimError, type UseKnowledgeImprovementCandidateOptions, ValidateKnowledgeOptions, ValidateKnowledgeResult, VerifiedGradeableEvidence, VerifiedResearchLoopOptions, VerifiedResearchLoopResult, VerifiedResearchRound, VerifyGradeableEvidenceOptions, VerifyingDriverOptions, WIKILINK_REGEX, WebResearchWorkerOptions, WebSearchHit, WorkerClaimDecorationOptions, WorkerResearchContext, __resetHttpThrottle, acquireAgentMemoryRunLease, addSourcePath, addSourceText, agentMemorySequenceJudge, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, assertClaimLedgerId, assertCurrentRunCitationsResolved, assertDeepQuestionIntegrity, assertGradeableEvidence, assertKnowledgeCitationAudit, assertKnowledgeCitationsResolved, assertKnowledgeRetrievalMatchesVisibility, assertKnowledgeRetrievalMatchesVisibilityArtifact, assertKnowledgeWriteIntake, assertResearchClaimEvidenceIntegrity, assertResearchClaimLedgerIntegrity, assertRunScopedCitationsResolved, assertTrackedClaimIntegrity, auditCurrentRunCitations, auditKnowledgeCitations, buildAgentMemorySequenceScenarios, buildAgentMemorySequencesFromBenchmarkCases, buildEvalKnowledgeBundle, buildFirstPartyMemoryLifecycleBenchmarkCases, buildIndustryMemoryBenchmarkSmokeCases, buildIndustryRagBenchmarkSmokeCases, buildKnowledgeBenchmarkScenarios, buildKnowledgeBrief, buildKnowledgeGraph, buildKnowledgeIndex, buildKnowledgeLexicalIndex, buildKnowledgeRelationGraph, buildRetrievalBenchmarkCasesFromQrels, buildRetrievalEvalDispatch, calibrateRagAnswerJudge, canonicalizeUrl, chunkMarkdown, citedClaimKey, citedClaimOf, claimEvidenceId, claimId, claimSourceHost, compareAgentMemoryLearning, contentKey, createAdaptiveResearchDriver, createAgentMemoryBranch, createClaimDecorator, createClaimGroundingVerifier, createCollectionResearchDriver, createCornellLiiSource, createD1FreshnessStoreStub, createFileRunLineageAuthority, createFileSystemFreshnessStore, createFileSystemSearchProvider, createGraphitiMemoryAdapter, createInMemoryBenchmarkAdapter, createIrsPublicationsSource, createKnowledgeControlLoopAdapter, createKnowledgeEvent, createKnowledgeRetrievalDisposition, createKnowledgeRetrievalReceipt, createKnowledgeTools, createKnowledgeUseReceipt, createKnowledgeVisibilitySnapshot, createLocalDiscoveryDispatcher, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, createNoopMemoryBenchmarkAdapter, createPersistentResearchDrivingDriver, createRagAnswerQualityHook, createResearchDrivingDriver, createRunScopedStores, createStateSosSource, createTangleRouterClient, createVerifyingResearchDriver, createWebResearchWorker, decodeKnowledgeVisibilitySnapshot, deepQuestionId, defaultGetMemoryContext, defineReadinessSpec, detectChanges, detectNearDuplicatePages, deterministicRng, diagnoseRagAnswerFailure, emitRetrievalHoldoutBypass, emptyClaimLedger, encodeKnowledgeVisibilitySnapshot, evaluateKnowledgeBaseReadiness, explainKnowledgeTarget, extractLinks, extractWikilinks, firstMatch, forkAgentMemoryBranchSnapshot, formatFrontmatter, formatKnowledgeCitationReference, formatKnowledgeInvalidationProposal, fromAgentCandidateKnowledgeRef, gradeCompanyAgainstText, gradeFactAgainstText, gradeFor, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, htmlToText, improveKnowledgeBase, improveSelectedKnowledgeCandidate, initKnowledgeBase, innerHtmlById, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, investmentThesisSet, isKernelAnchoredPath, isKnowledgeMemoryBenchmarkCase, isKnowledgePagePath, isMissingFile, isReachable, isSafeKnowledgePath, isScaffoldPath, jsonCandidateCodec, jsonObjectCandidateCodec, kbIndexToText, knowledgeBenchmarkJudge, knowledgeCitationAuditFindings, knowledgeImprovementCandidateRef, knowledgeImprovementRunDir, knowledgeImprovementRunId, knowledgePageDigest, knowledgePageFromMarkdown, knowledgePageRelations, knowledgeReleaseReport, knowledgeVisibilityArtifactRef, layoutFor, lensDistribution, linkClaimContradictions, lintCurrentRunCitations, lintKnowledgeIndex, listRegularFilesWithinRoot, loadKnowledgeImprovementActivationResult, loadKnowledgeImprovementEvents, loadKnowledgeImprovementState, loadKnowledgePages, loadKnowledgePromotionRecord, loadSourceRegistry, looksLikeBlockPage, materialFactsSurfaced, materialFactsSurfacedInText, materializeRegisteredClaimEvidence, mediaTypeFor, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, mergeClaimLedgers, mergeTrackedClaims, neighbors, normalizeClaimText, normalizeExternalRagScores, normalizeLinkTarget, normalizePageText, normalizePagesDirectory, optimizeKnowledgeBasePolicy, originatedPages, parseFrontmatter, parseKnowledgeBenchmarkJsonl, parseKnowledgeBenchmarkQrels, parseKnowledgeCitationReference, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, planInvalidationPropagation, politeFetch, promoteKnowledgeCandidate, promoteRunScopedPages, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, removeDurable, renameDurable, renderKnowledgeBenchmarkReportMarkdown, renderMemoryContext, researchSourceVersionKey, resetRetrievalHoldoutRegistry, resolveKnowledgeCitation, resolveKnowledgeCitations, resolveMemoryCleanupTimeoutMs, resolveRunScopedCitation, resolveRunScopedCitations, respondToIndustryMemoryBenchmarkSmokeCase, respondToIndustryRagBenchmarkSmokeCase, restoreKnowledgeCandidateBaseline, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runAgentMemoryExperiment, runAgentMemoryImprovement, runAgentMemoryLearningExperiment, runBoundedMemoryLifecycle, runDiscoveryLoop, runInvestmentThesisTask, runKnowledgeBenchmarkSuite, runKnowledgeResearchLoop, runMemoryAdapterBenchmark, runRagKnowledgeImprovementLoop, runRagOptimization, runRetrievalImprovementLoop, runSerializedKnowledgeOptimization, runVerifiedResearchLoop, scenarioContentFingerprint, scoreBm25, scoreKnowledgeBaseIndex, scoreKnowledgeBenchmarkArtifact, scoreMemoryBenchmarkArtifact, scoreRagAnswerArtifact, scoreRetrievalArtifact, searchKnowledge, searchKnowledgePages, sha256, sleepForMemoryRecovery, slugify, snapshotSourceTextInput, sourceMatchesGaps, sourceRegistryPath, stableId, stripFrontmatter, summarizeKnowledgeBenchmarkCampaign, syncDirectory, textSourceAdapter, textSourceId, thesisReadinessSpecs, toAgentCandidateKnowledgeRef, toDeepEvalTestCases, toOffPolicyTrajectory, toRagCheckerRecords, toRagasEvaluationRows, toTruLensRecords, tokenizeQuery, tokenizeText, totalMaterialFacts, triageSource, validateKnowledgeIndex, verdictFor, verifyGradeableEvidence, verifyKnowledgeRetrievalDisposition, verifyKnowledgeRetrievalReceipt, verifyKnowledgeUseReceipt, verifyKnowledgeVisibilitySnapshot, walk, withCitedClaim, withKnowledgeImprovementCandidate, withKnowledgeImprovementComparison, withKnowledgeMutation, withKnowledgeRead, withSafeDescendant, withSafeDirectory, writeFileDurable, writeFileDurableWithinRoot, writeJson, writeJsonDurable, writeJsonDurableWithinRoot, writeKnowledgeIndex, writeSourceRegistry };
 //# sourceMappingURL=index.d.ts.map