@tangle-network/agent-knowledge 8.0.8 → 8.0.9

package/dist/index.d.ts

@@ -1,11 +1,12 @@
-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-CXZS0w00.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-CLNBGN_f.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-BPNsQVSx.js";
+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 { 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 } from "@tangle-network/agent-interface";
+import { AgentCandidateJsonValue, AgentCandidateKnowledgeRef, AgentImprovementActivation, AgentImprovementActivationResult, Sha256Digest } 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";
+import { EvidenceRef } from "@tangle-network/agent-eval/analyst";
 import { LockOptions } from "proper-lockfile";
 //#region src/adapters.d.ts
 interface SourceAdapterInput {
@@ -1449,6 +1450,72 @@ type KnowledgePolicyDispatch<TPolicy extends AgentCandidateJsonValue, TScenario
 //#region src/kb-improvement/run.d.ts
 declare function improveKnowledgeBase(options: KnowledgeImprovementOptions): Promise<KnowledgeImprovementResult>;
 //#endregion
+//#region src/kb-improvement/selected-candidate.d.ts
+declare const measuredSelectionReceiptSchema: z.ZodObject<{
+  kind: z.ZodLiteral<"measured-knowledge-change-selection-receipt">;
+  version: z.ZodLiteral<1>;
+  receiptHash: z.ZodString;
+  selectionDigest: z.ZodString;
+  sourceCandidate: z.ZodObject<{
+    kind: z.ZodLiteral<"knowledge-improvement-candidate">;
+    runId: z.ZodString;
+    candidateId: z.ZodString;
+    goalHash: z.ZodString;
+    baseHash: z.ZodString;
+    candidateHash: z.ZodString;
+    evidenceHash: z.ZodString;
+    promotionPlanHash: z.ZodString;
+  }, z.core.$strict>;
+  sourcePlanHash: z.ZodString;
+  selectedPaths: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+  derivedImplementationRef: z.ZodString;
+  runId: z.ZodString;
+  derivedCandidateId: z.ZodString;
+  derivedCandidateStatus: z.ZodString;
+  selectedCandidateHash: z.ZodString;
+  selectedPlanHash: z.ZodString;
+  selectedEvidenceHash: z.ZodString;
+  rationale: z.ZodOptional<z.ZodString>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+}, z.core.$strict>;
+type KnowledgeEvaluationPhase = Exclude<RagKnowledgeImprovementPhase, 'knowledge-acquisition' | 'knowledge-update'>;
+interface ImproveSelectedKnowledgeCandidateOptions extends Omit<KnowledgeImprovementOptions, 'root' | 'goal' | 'implementationRef' | 'runId' | 'step' | 'knowledgeResearch' | 'acquireKnowledge' | 'updateKnowledge' | 'enabledPhases' | 'requiredPhases'> {
+  root: string;
+  goal: string;
+  /** Identity of the helper, policy, or human procedure choosing the subset. */
+  implementationRef: string;
+  /** Previously measured whole candidate from which the subset is derived. */
+  sourceCandidate: KnowledgeImprovementCandidateRef;
+  /** Exact changed file paths to carry into the derived candidate. */
+  selectedPaths: readonly string[];
+  /** Optional explicit run identity. The default includes the selection digest. */
+  runId?: string;
+  /** Human-readable reason for selecting this subset. */
+  rationale?: string;
+  /** JSON-safe policy output retained in the selection receipt. */
+  selectionMetadata?: Record<string, AgentCandidateJsonValue>;
+  /** Evaluation-only phases. `knowledge-update` is inserted by this helper. */
+  enabledEvaluationPhases?: readonly KnowledgeEvaluationPhase[];
+  /** Evaluation-only phases that must complete. `knowledge-update` is always required. */
+  requiredEvaluationPhases?: readonly KnowledgeEvaluationPhase[];
+}
+type MeasuredKnowledgeSelectionReceipt = z.infer<typeof measuredSelectionReceiptSchema>;
+interface ImproveSelectedKnowledgeCandidateResult extends KnowledgeImprovementResult {
+  selection: MeasuredKnowledgeSelectionReceipt;
+}
+/**
+ * Derive a subset from an already measured candidate, then measure the subset as
+ * a new candidate before it can be promoted.
+ *
+ * Directly filtering an activation plan is unsafe: a whole candidate can pass
+ * while one page subset breaks links, removes supporting sources, or changes a
+ * readiness score. This helper instead applies the chosen changed paths to an
+ * isolated baseline, recomputes the index, runs the ordinary improvement
+ * evaluator, and returns the ordinary candidate reference. Promotion therefore
+ * remains one path and can never admit an unmeasured hybrid.
+ */
+declare function improveSelectedKnowledgeCandidate(options: ImproveSelectedKnowledgeCandidateOptions): Promise<ImproveSelectedKnowledgeCandidateResult>;
+//#endregion
 //#region src/kb-improvement/state.d.ts
 declare function knowledgeImprovementRunId(root: string, goal: string): string;
 declare function knowledgeImprovementRunDir(root: string, runId: string): string;
@@ -1604,6 +1671,191 @@ declare function stripFrontmatter(content: 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);
+}
+/**
+ * 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/citation-lint.d.ts
+/** Convert a chain-aware citation audit into the package lint vocabulary. */
+declare function knowledgeCitationAuditFindings(report: KnowledgeCitationAuditReport): KnowledgeLintFinding[];
+/** Lint only current-run pages against their complete declared visibility chain. */
+declare function lintCurrentRunCitations(stores: RunScopedStores, runId: string): Promise<KnowledgeLintFinding[]>;
+//#endregion
 //#region src/claim-evidence.d.ts
 /**
  * The evidence contract for claims that machines, not authors, get to grade.
@@ -2617,6 +2869,142 @@ declare class FileSystemKbStore implements KbStore, ClaimLedgerStore {
   private claimLedgerPath;
 }
 //#endregion
+//#region src/knowledge-use-receipts.d.ts
+declare const KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION: '1.0.0';
+declare const KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM: 'rfc8785-sha256';
+interface KnowledgeVisibilitySnapshotEntry {
+  readonly position: number;
+  readonly pageId: string;
+  readonly origin: PageOrigin;
+  readonly path: string;
+  readonly pageDigest: Sha256Digest;
+  readonly sourceIds: readonly string[];
+  readonly invalidated: boolean;
+}
+/** Exact ordered page visibility presented to one retrieval operation. */
+interface KnowledgeVisibilitySnapshot {
+  readonly schemaVersion: typeof KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION;
+  readonly digestAlgorithm: typeof KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM;
+  readonly snapshotDigest: Sha256Digest;
+  readonly entries: readonly KnowledgeVisibilitySnapshotEntry[];
+}
+interface KnowledgeRetrieverIdentity {
+  /** Stable implementation name, for example `token-overlap-v1`. */
+  readonly id: string;
+  /** Published or application-defined implementation version. */
+  readonly version: string;
+  /** Exact identity of every retrieval setting not represented elsewhere. */
+  readonly configDigest: Sha256Digest;
+}
+interface OriginatedKnowledgeSearchResult extends KnowledgeSearchResult {
+  readonly origin: PageOrigin;
+}
+interface KnowledgeRetrievalResultReceipt {
+  readonly rank: number;
+  readonly pageId: string;
+  readonly origin: PageOrigin;
+  readonly path: string;
+  readonly pageDigest: Sha256Digest;
+  readonly rrfScore: number;
+  readonly normalizedScore: number;
+  readonly snippet: string;
+  readonly reasons: readonly string[];
+}
+type KnowledgeReceiptAttributeValue = string | number | boolean | null;
+/**
+ * Immutable proof of what one actor could see and what its retriever returned.
+ * Final prose is not evidence that retrieval happened; this receipt is.
+ */
+interface KnowledgeRetrievalReceipt {
+  readonly schemaVersion: typeof KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION;
+  readonly kind: 'knowledge-retrieval';
+  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 query: string;
+  readonly retriever: KnowledgeRetrieverIdentity;
+  readonly visibility: KnowledgeVisibilitySnapshot;
+  readonly results: readonly KnowledgeRetrievalResultReceipt[];
+  readonly evidenceRefs: readonly EvidenceRef[];
+  readonly attributes: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
+}
+interface CreateKnowledgeRetrievalReceiptInput {
+  readonly runId: string;
+  readonly actorId?: string;
+  readonly profileDigest?: Sha256Digest;
+  readonly executionRef?: Sha256Digest;
+  readonly query: string;
+  readonly retriever: KnowledgeRetrieverIdentity;
+  readonly visiblePages: readonly OriginatedPage[];
+  readonly results: readonly OriginatedKnowledgeSearchResult[];
+  readonly evidenceRefs?: readonly EvidenceRef[];
+  readonly attributes?: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
+  readonly createdAt?: Date | string;
+}
+type KnowledgeUseRelation = 'supports' | 'contradicts' | 'extends' | 'rederives' | 'background';
+type KnowledgeConsumerKind = 'decision' | 'artifact' | 'experiment' | 'candidate' | 'message' | 'other';
+interface KnowledgeConsumerRef {
+  readonly kind: KnowledgeConsumerKind;
+  readonly uri: string;
+  readonly digest?: Sha256Digest;
+}
+interface KnowledgeUsedResult {
+  readonly rank: number;
+  readonly pageId: string;
+  readonly origin: PageOrigin;
+  readonly path: string;
+  readonly pageDigest: Sha256Digest;
+}
+/**
+ * Immutable proof that one retrieved page was selected for a downstream
+ * decision, artifact, experiment, candidate, or message.
+ */
+interface KnowledgeUseReceipt {
+  readonly schemaVersion: typeof KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION;
+  readonly kind: 'knowledge-use';
+  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 used: KnowledgeUsedResult;
+  readonly relation: KnowledgeUseRelation;
+  readonly consumer: KnowledgeConsumerRef;
+  readonly evidenceRefs: readonly EvidenceRef[];
+  readonly attributes: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
+}
+interface CreateKnowledgeUseReceiptInput {
+  readonly retrieval: KnowledgeRetrievalReceipt;
+  /** Exact one-based rank from the retrieval receipt. */
+  readonly selectedRank: number;
+  readonly relation: KnowledgeUseRelation;
+  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. */
+declare function createKnowledgeRetrievalReceipt(input: CreateKnowledgeRetrievalReceiptInput): KnowledgeRetrievalReceipt;
+/** Verify the receipt's schema, internal joins, and canonical digest. */
+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;
+/** 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;
+//#endregion
 //#region src/lint.d.ts
 declare function lintKnowledgeIndex(index: KnowledgeIndex): KnowledgeLintFinding[];
 //#endregion
@@ -2958,82 +3346,6 @@ declare function createResearchDrivingDriver(options?: ResearchDrivingDriverOpti
  */
 declare function createPersistentResearchDrivingDriver(options: PersistentResearchDrivingDriverOptions): Promise<ResearchDrivingDriver>;
 //#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;
-}
-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 — promotion into it is a deliberate
-   * act outside this module. Searched last, labeled `shared`.
-   */
-  sharedRoot?: string;
-}
-interface RunScopedStores {
-  /** Create (or open) a run's store, recording its parent at creation time. */
-  init(runId: string, options?: {
-    parentRunId?: string | null;
-  }): Promise<KnowledgeLayout>;
-  /** The ancestor chain of a run, nearest first, resolved from records written at init. */
-  lineage(runId: string): Promise<string[]>;
-  /**
-   * Every page visible to a run: its own, then each ancestor's, then the shared store's, each
-   * labeled with its origin. Later stores never shadow earlier ones — a reader sees both copies
-   * of a twice-recorded claim and the labels that distinguish them.
-   */
-  loadChain(runId: string): Promise<OriginatedPage[]>;
-}
-declare function createRunScopedStores(options: RunScopedStoresOptions): RunScopedStores;
-//#endregion
 //#region src/schemas.d.ts
 declare const SourceAnchorSchema: z.ZodObject<{
   id: z.ZodString;
@@ -3088,6 +3400,7 @@ declare const KnowledgePageSchema: z.ZodObject<{
   sourceIds: z.ZodArray<z.ZodString>;
   tags: z.ZodArray<z.ZodString>;
   outLinks: z.ZodArray<z.ZodString>;
+  cites: z.ZodOptional<z.ZodArray<z.ZodString>>;
   contradicts: z.ZodOptional<z.ZodArray<z.ZodString>>;
   invalidation: z.ZodOptional<z.ZodObject<{
     verdict: z.ZodLiteral<"contradicted">;
@@ -3149,6 +3462,7 @@ declare const KnowledgeIndexSchema: z.ZodObject<{
     sourceIds: z.ZodArray<z.ZodString>;
     tags: z.ZodArray<z.ZodString>;
     outLinks: z.ZodArray<z.ZodString>;
+    cites: z.ZodOptional<z.ZodArray<z.ZodString>>;
     contradicts: z.ZodOptional<z.ZodArray<z.ZodString>>;
     invalidation: z.ZodOptional<z.ZodObject<{
       verdict: z.ZodLiteral<"contradicted">;
@@ -3355,5 +3669,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, 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, 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, IrsPublicationsSourceOptions, KB_CLAIM_LEDGER_DIR, KB_EVENTS_PATH, KB_INDEX_PATH, KB_STORE_DIR, KNOWLEDGE_EVENT_TYPES, 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, KnowledgeClaim, type KnowledgeClaimMatcher, KnowledgeControlLoopAction, KnowledgeControlLoopActionResult, KnowledgeControlLoopAdapter, KnowledgeControlLoopAdapterOptions, KnowledgeControlLoopState, KnowledgeDiscoveryDispatcher, KnowledgeDiscoveryWorker, 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, KnowledgeRelation, KnowledgeRelease, KnowledgeReleaseInput, KnowledgeReleaseReport, KnowledgeResearchLoopContext, KnowledgeResearchLoopDecision, KnowledgeResearchLoopResult, KnowledgeResearchLoopStep, type KnowledgeRetrievalBenchmarkCase, type KnowledgeRetrievalBenchmarkQrel, type KnowledgeRetrievalBenchmarkQuery, KnowledgeSearchHit, KnowledgeSearchResult, KnowledgeSource, KnowledgeUnit, KnowledgeWriteBlock, KnowledgeWriteParseResult, type LoadKnowledgeImprovementActivationResultOptions, LoadKnowledgePagesOptions, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, MaterialFact, MaterialFactLens, MaterialFactsResult, Mem0ClientMode, Mem0HostedClient, Mem0HostedMemoryAdapterOptions, Mem0MemoryAdapterOptions, Mem0OssClient, Mem0OssMemoryAdapterOptions, type MemoryAdapterBenchmarkCandidate, type MemoryAdapterBenchmarkRankingRow, type MemoryConfigScenario, MemoryKbStore, type NearDuplicateDetectionOptions, type NearDuplicatePair, type NearDuplicateReport, Neo4jAgentMemoryAdapterOptions, type OptimizeKnowledgeBasePolicyOptions, type OptimizeKnowledgeBasePolicyResult, 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, 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, assertDeepQuestionIntegrity, assertGradeableEvidence, assertResearchClaimEvidenceIntegrity, assertResearchClaimLedgerIntegrity, assertTrackedClaimIntegrity, 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, createFileSystemFreshnessStore, createFileSystemSearchProvider, createGraphitiMemoryAdapter, createInMemoryBenchmarkAdapter, createIrsPublicationsSource, createKnowledgeControlLoopAdapter, createKnowledgeEvent, 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, fromAgentCandidateKnowledgeRef, gradeCompanyAgainstText, gradeFactAgainstText, gradeFor, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, htmlToText, improveKnowledgeBase, initKnowledgeBase, innerHtmlById, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, investmentThesisSet, isKernelAnchoredPath, isKnowledgeMemoryBenchmarkCase, isMissingFile, isSafeKnowledgePath, isScaffoldPath, jsonCandidateCodec, jsonObjectCandidateCodec, kbIndexToText, knowledgeBenchmarkJudge, knowledgeImprovementCandidateRef, knowledgeImprovementRunDir, knowledgeImprovementRunId, knowledgeReleaseReport, layoutFor, lensDistribution, linkClaimContradictions, 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, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, politeFetch, promoteKnowledgeCandidate, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, removeDurable, renameDurable, renderKnowledgeBenchmarkReportMarkdown, renderMemoryContext, researchSourceVersionKey, resetRetrievalHoldoutRegistry, resolveMemoryCleanupTimeoutMs, 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, 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, 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 };
 //# sourceMappingURL=index.d.ts.map