@tangle-network/agent-knowledge 17.1.10 → 19.0.0

package/dist/index.d.ts

@@ -9,29 +9,29 @@ import { ComparisonCost, DispatchContext, JudgeConfig, OptimizationMethod, Scena
 import { EvidenceRef } from "@tangle-network/agent-eval/analyst";
 import { LockOptions } from "proper-lockfile";
 //#region src/adapters.d.ts
-interface SourceAdapterInput {
+export interface SourceAdapterInput {
   uri: string;
   bytes?: Uint8Array;
   text?: string;
   metadata?: Record<string, unknown>;
 }
-interface SourceAdapterOutput {
+export interface SourceAdapterOutput {
   title?: string;
   mediaType?: string;
   text?: string;
   anchors?: SourceRecord['anchors'];
   metadata?: Record<string, unknown>;
 }
-interface SourceAdapter {
+export interface SourceAdapter {
   id: string;
   canLoad(input: SourceAdapterInput): boolean;
   load(input: SourceAdapterInput): Promise<SourceAdapterOutput> | SourceAdapterOutput;
 }
-declare const textSourceAdapter: SourceAdapter;
-declare function mediaTypeFor(uri: string): string;
+export declare const textSourceAdapter: SourceAdapter;
+export declare function mediaTypeFor(uri: string): string;
 //#endregion
 //#region src/eval-readiness.d.ts
-interface KnowledgeReadinessSpec {
+export interface KnowledgeReadinessSpec {
   id: string;
   description: string;
   query: string;
@@ -55,7 +55,7 @@ interface KnowledgeReadinessSpec {
  * source. Override any field to specialise (e.g. `freshness: 'daily'` for a
  * topic that must reflect today's regulatory state).
  */
-declare const READINESS_SPEC_DEFAULTS: {
+export declare const READINESS_SPEC_DEFAULTS: {
   readonly category: 'domain_specific';
   readonly acquisitionMode: 'search_web';
   readonly importance: 'high';
@@ -70,7 +70,7 @@ declare const READINESS_SPEC_DEFAULTS: {
  * sanely default (id, description, query, requiredFor) are required; everything
  * else is optional and pulls from `READINESS_SPEC_DEFAULTS`.
  */
-type DefineReadinessSpecInput = Pick<KnowledgeReadinessSpec, 'id' | 'description' | 'query' | 'requiredFor'> & Partial<Omit<KnowledgeReadinessSpec, 'id' | 'description' | 'query' | 'requiredFor'>>;
+export type DefineReadinessSpecInput = Pick<KnowledgeReadinessSpec, 'id' | 'description' | 'query' | 'requiredFor'> & Partial<Omit<KnowledgeReadinessSpec, 'id' | 'description' | 'query' | 'requiredFor'>>;
 /**
  * Builder that returns a fully-typed `KnowledgeReadinessSpec` from a slim input.
  *
@@ -101,8 +101,8 @@ type DefineReadinessSpecInput = Pick<KnowledgeReadinessSpec, 'id' | 'description
  *   minSources: 3,
  * })
  */
-declare function defineReadinessSpec(input: DefineReadinessSpecInput): KnowledgeReadinessSpec;
-interface BuildEvalKnowledgeBundleOptions {
+export declare function defineReadinessSpec(input: DefineReadinessSpecInput): KnowledgeReadinessSpec;
+export interface BuildEvalKnowledgeBundleOptions {
   taskId: string;
   index: KnowledgeIndex;
   specs: KnowledgeReadinessSpec[];
@@ -111,7 +111,7 @@ interface BuildEvalKnowledgeBundleOptions {
   metadata?: Record<string, unknown>;
   now?: Date;
 }
-interface EvalKnowledgeBundleBuildResult {
+export interface EvalKnowledgeBundleBuildResult {
   bundle: KnowledgeBundle;
   report: KnowledgeReadinessReport;
   requirements: KnowledgeRequirement[];
@@ -119,15 +119,15 @@ interface EvalKnowledgeBundleBuildResult {
   questions: UserQuestion[];
   acquisitionPlans: DataAcquisitionPlan[];
 }
-declare function buildEvalKnowledgeBundle(options: BuildEvalKnowledgeBundleOptions): EvalKnowledgeBundleBuildResult;
+export declare function buildEvalKnowledgeBundle(options: BuildEvalKnowledgeBundleOptions): EvalKnowledgeBundleBuildResult;
 //#endregion
 //#region src/sources.d.ts
-interface AddSourceOptions {
+export interface AddSourceOptions {
   copyIntoRaw?: boolean;
   adapters?: SourceAdapter[];
   now?: () => Date;
 }
-interface AddSourceTextInput {
+export interface AddSourceTextInput {
   uri: string;
   text: string;
   title?: string;
@@ -137,12 +137,12 @@ interface AddSourceTextInput {
   metadata?: Record<string, unknown>;
 }
 /** Copy and freeze an untrusted source proposal before any asynchronous work. */
-declare function snapshotSourceTextInput(input: AddSourceTextInput): AddSourceTextInput;
-declare function loadSourceRegistry(root: string): Promise<SourceRegistry>;
-declare function writeSourceRegistry(root: string, registry: SourceRegistry): Promise<void>;
-declare function addSourcePath(root: string, sourcePath: string, options?: AddSourceOptions): Promise<SourceRecord[]>;
-declare function addSourceText(root: string, input: AddSourceTextInput, options?: Pick<AddSourceOptions, 'adapters' | 'now'>): Promise<SourceRecord>;
-declare function sourceRegistryPath(root: string): string;
+export declare function snapshotSourceTextInput(input: AddSourceTextInput): AddSourceTextInput;
+export declare function loadSourceRegistry(root: string): Promise<SourceRegistry>;
+export declare function writeSourceRegistry(root: string, registry: SourceRegistry): Promise<void>;
+export declare function addSourcePath(root: string, sourcePath: string, options?: AddSourceOptions): Promise<SourceRecord[]>;
+export declare function addSourceText(root: string, input: AddSourceTextInput, options?: Pick<AddSourceOptions, 'adapters' | 'now'>): Promise<SourceRecord>;
+export declare function sourceRegistryPath(root: string): string;
 //#endregion
 //#region src/verified-research-loop.d.ts
 /**
@@ -150,7 +150,7 @@ declare function sourceRegistryPath(root: string): string;
  * targets these; the driver folds the unfilled remainder into the worker's next
  * prompt and runs its own gap-fill pass over them.
  */
-interface KnowledgeGap {
+export interface KnowledgeGap {
   /** Readiness-spec id this gap belongs to. */
   id: string;
   /** Human-readable description of what's missing. */
@@ -161,7 +161,7 @@ interface KnowledgeGap {
   blocking: boolean;
 }
 /** A new source the worker (or driver) discovered and wants to add to the KB. */
-type ResearchSourceProposal = AddSourceTextInput;
+export type ResearchSourceProposal = AddSourceTextInput;
 /**
  * What a research agent contributes in one round. Both the worker and (when
  * `driverResearches` is on) the driver produce this shape — the worker ADDS
@@ -171,7 +171,7 @@ type ResearchSourceProposal = AddSourceTextInput;
  * blocks). The loop only applies it AFTER the driver has verified the round's
  * sources, so a rejected source never reaches the curated pages.
  */
-interface ResearchContribution {
+export interface ResearchContribution {
   /** Immutable sources to register (the raw evidence). */
   sources?: ResearchSourceProposal[];
   /** Safe write-protocol text producing curated `knowledge/*.md` pages. */
@@ -190,7 +190,7 @@ interface ResearchContribution {
   metadata?: Record<string, unknown>;
 }
 /** Context handed to the worker each round. */
-interface WorkerResearchContext {
+export interface WorkerResearchContext {
   root: string;
   goal: string;
   round: number;
@@ -203,7 +203,7 @@ interface WorkerResearchContext {
   signal?: AbortSignal;
 }
 /** Context handed to the driver's verifier for one candidate source. */
-interface SourceVerificationContext {
+export interface SourceVerificationContext {
   root: string;
   goal: string;
   round: number;
@@ -214,12 +214,12 @@ interface SourceVerificationContext {
   signal?: AbortSignal;
 }
 /** A single rejected source plus the reason the driver gave. */
-interface RejectedSource {
+export interface RejectedSource {
   source: ResearchSourceProposal;
   reason: string;
 }
 /** Context handed to the driver's gap-fill pass (only when `driverResearches`). */
-interface DriverResearchContext {
+export interface DriverResearchContext {
   root: string;
   goal: string;
   round: number;
@@ -250,7 +250,7 @@ interface DriverResearchContext {
  * - `commitSources` — confirm exact source records are durable after verification;
  *   drivers with pending evidence must not count it before this callback.
  */
-interface ResearchDriver {
+export interface ResearchDriver {
   verifySource(source: ResearchSourceProposal, ctx: SourceVerificationContext): Promise<SourceVerdict> | SourceVerdict;
   research?(ctx: DriverResearchContext): Promise<ResearchContribution> | ResearchContribution;
   foldGaps?(gaps: KnowledgeGap[]): string;
@@ -259,15 +259,15 @@ interface ResearchDriver {
   commitSources?(sources: readonly SourceRecord[]): Promise<void> | void;
   checkpoint?(): Promise<void> | void;
 }
-type SourceVerdict = {
+export type SourceVerdict = {
   accept: true;
 } | {
   accept: false;
   reason: string;
 };
 /** The worker: primary research targeting the round's gaps. */
-type ResearchWorker = (ctx: WorkerResearchContext) => Promise<ResearchContribution> | ResearchContribution;
-interface VerifiedResearchLoopOptions {
+export type ResearchWorker = (ctx: WorkerResearchContext) => Promise<ResearchContribution> | ResearchContribution;
+export interface VerifiedResearchLoopOptions {
   root: string;
   goal: string;
   worker: ResearchWorker;
@@ -289,7 +289,7 @@ interface VerifiedResearchLoopOptions {
   signal?: AbortSignal;
   onRound?: (round: VerifiedResearchRound) => Promise<void> | void;
 }
-interface VerifiedResearchRound {
+export interface VerifiedResearchRound {
   round: number;
   /** Gaps reported at the START of the round (what the worker targeted). */
   gaps: KnowledgeGap[];
@@ -310,7 +310,7 @@ interface VerifiedResearchRound {
     driver?: string;
   };
 }
-interface VerifiedResearchLoopResult {
+export interface VerifiedResearchLoopResult {
   root: string;
   goal: string;
   rounds: number;
@@ -341,26 +341,26 @@ interface VerifiedResearchLoopResult {
  * `applyKnowledgeWriteBlocks`, `buildEvalKnowledgeBundle` (the readiness gate),
  * and `searchKnowledge` — and reinvents none of them.
  */
-declare function runVerifiedResearchLoop(options: VerifiedResearchLoopOptions): Promise<VerifiedResearchLoopResult>;
+export declare function runVerifiedResearchLoop(options: VerifiedResearchLoopOptions): Promise<VerifiedResearchLoopResult>;
 /**
  * Helper for verifiers: does the candidate source's text/title overlap any page
  * the readiness search returns for a gap query? A cheap relevance heuristic the
  * driver can compose into `verifySource` (real verifiers can do more).
  */
-declare function sourceMatchesGaps(source: ResearchSourceProposal, index: KnowledgeIndex, gaps: KnowledgeGap[]): KnowledgeSearchResult[];
+export declare function sourceMatchesGaps(source: ResearchSourceProposal, index: KnowledgeIndex, gaps: KnowledgeGap[]): KnowledgeSearchResult[];
 //#endregion
 //#region src/web-research-worker.d.ts
 /** One live web result, as the router's `/v1/search` returns it. */
-interface WebSearchHit {
+export interface WebSearchHit {
   title: string;
   url: string;
   snippet?: string;
 }
 /**
  * The two router capabilities the worker/driver need. Injectable so tests can
- * stub the network; the default talks to the live Tangle router over `fetch`.
+ * supply a client; the default uses the published TCloud SDK.
  */
-interface RouterClient {
+export interface RouterClient {
   /** Live web search — returns title/url/snippet hits. */
   search(query: string, opts?: {
     maxResults?: number;
@@ -380,15 +380,16 @@ interface RouterClient {
  * each call here is what surfaces that the two-agent loop spends more inference
  * than its "equal passes" budget implies.
  */
-interface RouterUsage {
+export interface RouterUsage {
   chatCalls: number;
   searchCalls: number;
   promptTokens: number;
   completionTokens: number;
+  /** Reported cost only. NaN once a successful response omits its cost receipt. */
   usd: number;
   wallMs: number;
 }
-interface TangleRouterOptions {
+export interface TangleRouterOptions {
   /** Router base URL. Defaults to `https://router.tangle.tools/v1`. */
   baseUrl?: string;
   /** Bearer key. Defaults to `process.env.TANGLE_API_KEY`. */
@@ -397,30 +398,20 @@ interface TangleRouterOptions {
   model?: string;
   /** Optional preferred search provider (exa | you | perplexity | …). */
   searchProvider?: string;
-  /**
-   * Retries on a TRANSIENT upstream status (502/503/504/429) with exponential
-   * backoff. Default 4. A 4xx that isn't 429, and a 401, are NOT retried — those
-   * are not transient. After the budget is exhausted the call still fails loud
-   * with the original `RouterError`, so the fail-closed contract holds; this only
-   * stops a single upstream-capacity blip from voiding a whole multi-topic run.
-   */
+  /** SDK retries for 429/502/503/504. Default 4. Kept for API compatibility. */
   maxRetries?: number;
-  /** Base backoff in ms (doubled each retry, ±25% jitter). Default 1500. */
+  /** Initial SDK retry backoff in ms. Default 1500. */
   retryBaseMs?: number;
   signal?: AbortSignal;
 }
-/** A small error so a failed router call fails loud rather than returning junk. */
-declare class RouterError extends Error {
+/** Compatibility error facade. HTTP execution and classification belong to TCloud. */
+export declare class RouterError extends Error {
   readonly status: number;
   constructor(status: number, message: string);
 }
-/**
- * Build a dependency-free Tangle router client over `fetch`. This is the same
- * wire surface the `tcloud` SDK + `tcloud mcp` use (`/v1/search` for web search,
- * `/v1/chat/completions` for chat) so it needs no CLI installed.
- */
-declare function createTangleRouterClient(options?: TangleRouterOptions): RouterClient;
-interface WebResearchWorkerOptions {
+/** Adapt Knowledge's public contract to the published SDK, without a second transport. */
+export declare function createTangleRouterClient(options?: TangleRouterOptions): RouterClient;
+export interface WebResearchWorkerOptions {
   /** Router client. Defaults to a live Tangle router client from env creds. */
   router?: RouterClient;
   router_options?: TangleRouterOptions;
@@ -442,8 +433,8 @@ interface WebResearchWorkerOptions {
  * contract: given the open gaps, it returns the sources it found plus a
  * `buildPages` that emits citing pages from the sources the driver accepted.
  */
-declare function createWebResearchWorker(options?: WebResearchWorkerOptions): ResearchWorker;
-interface VerifyingDriverOptions {
+export declare function createWebResearchWorker(options?: WebResearchWorkerOptions): ResearchWorker;
+export interface VerifyingDriverOptions {
   router?: RouterClient;
   router_options?: TangleRouterOptions;
   /**
@@ -463,7 +454,7 @@ interface VerifyingDriverOptions {
  * new candidates, so the verifier focuses on relevance + near-duplicate
  * judgement, not bookkeeping.
  */
-declare function createVerifyingResearchDriver(options?: VerifyingDriverOptions): ResearchDriver;
+export declare function createVerifyingResearchDriver(options?: VerifyingDriverOptions): ResearchDriver;
 //#endregion
 //#region src/adaptive-driver.d.ts
 /**
@@ -474,20 +465,20 @@ declare function createVerifyingResearchDriver(options?: VerifyingDriverOptions)
  * as the same source. Falls back to the lowercased raw string when the input is
  * not a parseable absolute URL (so non-http identifiers still dedup by equality).
  */
-declare function canonicalizeUrl(uri: string): string;
+export declare function canonicalizeUrl(uri: string): string;
 /**
  * A stable content key for a fetched page: the sha256 of its normalized text
  * (lowercased, punctuation/whitespace collapsed). Two pages whose readable body
  * is the same modulo formatting collide here, so the dedup stage rejects a
  * mirror/syndication of an already-accepted source even when the URL differs.
  */
-declare function contentKey(text: string): string;
+export declare function contentKey(text: string): string;
 /** Why the deterministic dedup stage rejected a candidate (for audit/notes). */
-type DedupReason = 'duplicate-url' | 'duplicate-content';
+export type DedupReason = 'duplicate-url' | 'duplicate-content';
 /** The cheap-triage classification of a unique survivor. */
-type TriageClass = 'keep' | 'drop' | 'ambiguous';
+export type TriageClass = 'keep' | 'drop' | 'ambiguous';
 /** One source's adaptive routing decision, for instrumentation and the doc. */
-interface AdaptiveDecision {
+export interface AdaptiveDecision {
   uri: string;
   /** The stage that decided this source: dedup | heuristic | llm. */
   stage: 'dedup' | 'heuristic' | 'llm';
@@ -497,7 +488,7 @@ interface AdaptiveDecision {
   reason?: string;
 }
 /** Running tally of where the adaptive driver spent its decisions. */
-interface AdaptiveStats {
+export interface AdaptiveStats {
   total: number;
   /** Rejected by deterministic dedup (URL or content). $0. */
   dedupRejected: number;
@@ -511,7 +502,7 @@ interface AdaptiveStats {
   llmAccepted: number;
   decisions: AdaptiveDecision[];
 }
-interface AdaptiveDriverOptions {
+export interface AdaptiveDriverOptions {
   /** Router client for the LLM escalation. Defaults to a live client from env. */
   router?: RouterClient;
   router_options?: TangleRouterOptions;
@@ -548,7 +539,7 @@ interface AdaptiveDriverOptions {
  * the residue the LLM is reserved for: on-topic-looking pages on unknown hosts
  * with a plausible body, which a host/title rule cannot adjudicate.
  */
-declare function triageSource(source: ResearchSourceProposal, options: {
+export declare function triageSource(source: ResearchSourceProposal, options: {
   authoritativeHosts: string[];
   spamPatterns: RegExp[];
   minBodyChars: number;
@@ -557,7 +548,7 @@ declare function triageSource(source: ResearchSourceProposal, options: {
   triage: TriageClass;
   reason: string;
 };
-interface AdaptiveResearchDriver {
+export interface AdaptiveResearchDriver {
   verifySource(source: ResearchSourceProposal, ctx: SourceVerificationContext): Promise<SourceVerdict>;
   /** Live tally of where decisions were spent — the cost/quality instrumentation. */
   stats(): AdaptiveStats;
@@ -572,7 +563,7 @@ interface AdaptiveResearchDriver {
  * content hashes it has ACCEPTED, plus those it sees in the verification
  * context's `acceptedThisRound` and the KB index. Use one driver per loop run.
  */
-declare function createAdaptiveResearchDriver(options?: AdaptiveDriverOptions): AdaptiveResearchDriver;
+export declare function createAdaptiveResearchDriver(options?: AdaptiveDriverOptions): AdaptiveResearchDriver;
 //#endregion
 //#region src/knowledge-state-scope.d.ts
 /** Authoritative local state included in a KB improvement candidate. */
@@ -582,15 +573,15 @@ interface KnowledgeStateScope {
   /** Include claim ledgers and research events. Excludes indexes, locks, and receipt artifacts. */
   researchState?: boolean;
 }
-declare function normalizeKnowledgeStateScope(scope?: KnowledgeStateScope): {
+export declare function normalizeKnowledgeStateScope(scope?: KnowledgeStateScope): {
   pagesDirectory: string;
   researchState: boolean;
 };
 //#endregion
 //#region src/rag-optimization.d.ts
-type RagOptimizationConfig = Record<string, AgentCandidateJsonValue>;
+export type RagOptimizationConfig = Record<string, AgentCandidateJsonValue>;
 type RagOptimizationBaseOptions = Omit<RunSerializedKnowledgeOptimizationOptions<RagOptimizationConfig, RagAnswerEvalScenario, RagAnswerEvalArtifact>, 'baseline' | 'method' | 'trainScenarios' | 'selectionScenarios' | 'finalScenarios' | 'dispatchCandidate' | 'judges' | 'codec' | 'scenarioFingerprint'>;
-interface RunRagOptimizationOptions extends RagOptimizationBaseOptions {
+export interface RunRagOptimizationOptions extends RagOptimizationBaseOptions {
   baseline: RagOptimizationConfig;
   method: OptimizationMethod<RagAnswerEvalScenario, RagAnswerEvalArtifact>;
   trainScenarios: readonly RagAnswerEvalScenario[];
@@ -605,7 +596,7 @@ interface RunRagOptimizationOptions extends RagOptimizationBaseOptions {
   }): Promise<RagAnswerEvalArtifact>;
   judges?: readonly JudgeConfig<RagAnswerEvalArtifact, RagAnswerEvalScenario>[];
 }
-interface RunRagOptimizationResult extends RunSerializedKnowledgeOptimizationResult<RagOptimizationConfig> {
+export interface RunRagOptimizationResult extends RunSerializedKnowledgeOptimizationResult<RagOptimizationConfig> {
   baselineConfig: RagOptimizationConfig;
   winnerConfig: RagOptimizationConfig;
   trainScenarios: readonly RagAnswerEvalScenario[];
@@ -613,11 +604,11 @@ interface RunRagOptimizationResult extends RunSerializedKnowledgeOptimizationRes
   finalScenarios: readonly RagAnswerEvalScenario[];
 }
 /** Optimizes retrieval and answer behavior together as one serialized RAG configuration. */
-declare function runRagOptimization(options: RunRagOptimizationOptions): Promise<RunRagOptimizationResult>;
+export 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";
+export declare const DEFAULT_PAGES_DIRECTORY = "knowledge";
 /**
  * Selects the root-relative directory that holds Markdown pages.
  *
@@ -625,7 +616,7 @@ declare const DEFAULT_PAGES_DIRECTORY = "knowledge";
  * 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 {
+export interface KnowledgePagesOptions {
   /** Root-relative directory that holds Markdown pages. Defaults to `knowledge`. */
   pagesDirectory?: string;
 }
@@ -637,10 +628,10 @@ interface KnowledgePagesOptions {
  * paths, drive letters, `..` or `.` segments, empty segments, control
  * characters, and the package-owned `.agent-knowledge` and `raw` trees.
  */
-declare function normalizePagesDirectory(value?: string): string;
+export declare function normalizePagesDirectory(value?: string): string;
 //#endregion
 //#region src/store.d.ts
-interface KnowledgeLayout {
+export interface KnowledgeLayout {
   root: string;
   knowledgeDir: string;
   rawSourcesDir: string;
@@ -649,7 +640,7 @@ interface KnowledgeLayout {
   logPath: string;
   cacheDir: string;
 }
-declare function layoutFor(root: string): KnowledgeLayout;
+export 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
@@ -658,7 +649,7 @@ declare function layoutFor(root: string): KnowledgeLayout;
  * Add new scaffold filenames here (and only here) to keep lint, validate, viz,
  * and the indexer consistent.
  */
-declare const SCAFFOLD_PAGE_BASENAMES: readonly string[];
+export 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`)
@@ -666,24 +657,24 @@ declare const SCAFFOLD_PAGE_BASENAMES: readonly string[];
  * `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[]>;
+export declare function isScaffoldPath(path: string): boolean;
+export declare function initKnowledgeBase(root: string): Promise<KnowledgeLayout>;
+export 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;
+export 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>;
+export declare function knowledgePageFromMarkdown(path: string, content: string, pagesDirectory?: string): KnowledgePage;
+export 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 {
+export type PageOrigin = 'here' | `inherited:${string}` | 'shared';
+export interface OriginatedPage {
   page: KnowledgePage;
   origin: PageOrigin;
 }
@@ -695,8 +686,8 @@ interface OriginatedPage {
  * 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 {
+export declare function originatedPages(pages: readonly KnowledgePage[], origin?: PageOrigin): OriginatedPage[];
+export interface RunLineageRecord {
   runId: string;
   parentRunId: string | null;
   createdAt: string;
@@ -709,12 +700,12 @@ interface RunLineageRecord {
  * that case `init` verifies that the existing authority agrees with the parent
  * requested by the caller before creating any store files.
  */
-interface RunLineageAuthority {
+export interface RunLineageAuthority {
   parentOf(runId: string): Promise<string | null>;
   record?(record: RunLineageRecord): Promise<void>;
 }
-declare const RUN_LINEAGE_BASENAME = "lineage.json";
-interface RunScopedStoresOptions extends KnowledgePagesOptions {
+export declare const RUN_LINEAGE_BASENAME = "lineage.json";
+export 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`. */
@@ -730,7 +721,7 @@ interface RunScopedStoresOptions extends KnowledgePagesOptions {
    * Cycles and invalid identities are always refused; long valid history is not corruption. */
   maxAncestors?: number;
 }
-interface RunScopedStores {
+export interface RunScopedStores {
   /** Create or open a run store and bind it to one exact parent identity. */
   init(runId: string, options?: {
     parentRunId?: string | null;
@@ -750,9 +741,9 @@ interface RunScopedStores {
    */
   loadChain(runId: string): Promise<OriginatedPage[]>;
 }
-declare function createRunScopedStores(options: RunScopedStoresOptions): RunScopedStores;
+export 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;
+export declare function createFileRunLineageAuthority(runStorePath: (runId: string) => string): RunLineageAuthority;
 //#endregion
 //#region src/citation-resolution.d.ts
 /**
@@ -762,24 +753,24 @@ declare function createFileRunLineageAuthority(runStorePath: (runId: string) =>
  * 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 {
+export interface KnowledgeCitationReference {
   readonly pageId: KnowledgeId;
   readonly origin?: PageOrigin;
 }
-interface KnowledgeCitationCandidate {
+export interface KnowledgeCitationCandidate {
   readonly pageId: KnowledgeId;
   readonly origin: PageOrigin;
   readonly page: KnowledgePage;
 }
-type KnowledgeCitationResolutionStatus = 'resolved' | 'missing' | 'ambiguous';
-interface KnowledgeCitationResolution {
+export type KnowledgeCitationResolutionStatus = 'resolved' | 'missing' | 'ambiguous';
+export interface KnowledgeCitationResolution {
   readonly reference: KnowledgeCitationReference;
   readonly status: KnowledgeCitationResolutionStatus;
   readonly candidates: readonly KnowledgeCitationCandidate[];
   readonly resolved?: KnowledgeCitationCandidate;
 }
-type KnowledgeCitationAuditIssueKind = 'self' | 'missing' | 'ambiguous';
-interface KnowledgeCitationAuditIssue {
+export type KnowledgeCitationAuditIssueKind = 'self' | 'missing' | 'ambiguous';
+export interface KnowledgeCitationAuditIssue {
   readonly kind: KnowledgeCitationAuditIssueKind;
   readonly sourcePageId: KnowledgeId;
   readonly sourcePath: string;
@@ -788,23 +779,23 @@ interface KnowledgeCitationAuditIssue {
   readonly reference: KnowledgeCitationReference;
   readonly candidates: readonly KnowledgeCitationCandidate[];
 }
-interface KnowledgeCitationAuditReport {
+export interface KnowledgeCitationAuditReport {
   readonly ok: boolean;
   readonly checkedPages: number;
   readonly checkedCitations: number;
   readonly issues: readonly KnowledgeCitationAuditIssue[];
 }
-interface AuditKnowledgeCitationsOptions {
+export 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 {
+export 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 {
+export declare class KnowledgeCitationAuditError extends Error {
   readonly report: KnowledgeCitationAuditReport;
   constructor(report: KnowledgeCitationAuditReport);
 }
@@ -817,32 +808,32 @@ declare class KnowledgeCitationAuditError extends Error {
  * tuple (null origin means unqualified). Always use the formatter to mint handles.
  * Legacy percent sequences are literal; old records are not silently reinterpreted.
  */
-declare function parseKnowledgeCitationReference(value: string): KnowledgeCitationReference;
+export declare function parseKnowledgeCitationReference(value: string): KnowledgeCitationReference;
 /** Serialize one reference into the canonical frontmatter representation. */
-declare function formatKnowledgeCitationReference(reference: KnowledgeCitationReference): string;
+export declare function formatKnowledgeCitationReference(reference: KnowledgeCitationReference): string;
 /** Resolve one reference against an already materialized visibility chain. */
-declare function resolveKnowledgeCitation(visiblePages: readonly OriginatedPage[], reference: KnowledgeCitationReference): KnowledgeCitationResolution;
+export 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[];
+export 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[];
+export 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;
+export 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;
+export 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>;
+export 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[]>;
+export 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[]>;
+export 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>;
+export 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>;
+export declare function assertCurrentRunCitationsResolved(stores: RunScopedStores, runId: string): Promise<KnowledgeCitationAuditReport>;
 //#endregion
 //#region src/rag-eval/near-duplicates.d.ts
 interface NearDuplicateDetectionOptions {
@@ -895,12 +886,12 @@ interface NearDuplicateReport {
  * 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;
+export declare function detectNearDuplicatePages(pages: readonly KnowledgePage[], options?: NearDuplicateDetectionOptions): NearDuplicateReport;
+export 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 {
+export interface KnowledgeDuplicateIntakePair {
   readonly candidatePageId: KnowledgeId;
   readonly candidatePath: string;
   readonly matchedPageId: KnowledgeId;
@@ -915,12 +906,12 @@ interface KnowledgeDuplicateIntakePair {
  * 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 {
+export declare class KnowledgeDuplicateIntakeError extends Error {
   readonly pairs: readonly KnowledgeDuplicateIntakePair[];
   readonly threshold: number;
   constructor(pairs: readonly KnowledgeDuplicateIntakePair[], threshold: number);
 }
-interface KnowledgeWriteIntakeOptions {
+export 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
@@ -944,15 +935,15 @@ interface KnowledgeWriteIntakeOptions {
  * Returns the resolved citation candidates in the order the candidates declare
  * them.
  */
-declare function assertKnowledgeWriteIntake(candidates: readonly KnowledgePage[], options: KnowledgeWriteIntakeOptions): readonly KnowledgeCitationCandidate[];
+export declare function assertKnowledgeWriteIntake(candidates: readonly KnowledgePage[], options: KnowledgeWriteIntakeOptions): readonly KnowledgeCitationCandidate[];
 //#endregion
 //#region src/proposals.d.ts
-interface ApplyWriteBlocksResult {
+export interface ApplyWriteBlocksResult {
   written: string[];
   warnings: string[];
 }
 /** Intake settings for a write, minus the pages the target root supplies itself. */
-type KnowledgeWriteIntakeRequest = Omit<KnowledgeWriteIntakeOptions, 'visiblePages'> & {
+export 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
@@ -960,7 +951,12 @@ type KnowledgeWriteIntakeRequest = Omit<KnowledgeWriteIntakeOptions, 'visiblePag
    */
   readonly inheritedPages?: readonly OriginatedPage[];
 };
-interface ApplyKnowledgeWriteBlocksOptions extends KnowledgePagesOptions {
+export interface ApplyKnowledgeWriteBlocksOptions extends KnowledgePagesOptions {
+  /** Host-provided identity, never inferred from authored page content. */
+  readonly actorId?: string;
+  readonly runId?: string;
+  /** Expected page identities by proposal path; null requires a new page. */
+  readonly expectedPageDigests?: Readonly<Record<string, Sha256Digest | null>>;
   /** Preserve terminal transactions under .agent-knowledge/history; no automatic deletion. */
   readonly retainHistory?: boolean;
   /**
@@ -977,21 +973,21 @@ interface ApplyKnowledgeWriteBlocksOptions extends KnowledgePagesOptions {
  * 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>;
+export declare function applyKnowledgeWriteBlocks(root: string, proposalText: string, options?: ApplyKnowledgeWriteBlocksOptions): Promise<ApplyWriteBlocksResult>;
+export declare function applyKnowledgeWriteBlocksFile(root: string, proposalPath: string, options?: ApplyKnowledgeWriteBlocksOptions): Promise<ApplyWriteBlocksResult>;
 //#endregion
 //#region src/validate.d.ts
-interface ValidateKnowledgeOptions {
+export interface ValidateKnowledgeOptions {
   strict?: boolean;
 }
-interface ValidateKnowledgeResult {
+export interface ValidateKnowledgeResult {
   ok: boolean;
   findings: KnowledgeLintFinding[];
 }
-declare function validateKnowledgeIndex(index: KnowledgeIndex, options?: ValidateKnowledgeOptions): ValidateKnowledgeResult;
+export declare function validateKnowledgeIndex(index: KnowledgeIndex, options?: ValidateKnowledgeOptions): ValidateKnowledgeResult;
 //#endregion
 //#region src/research-loop.d.ts
-interface KnowledgeResearchLoopContext {
+export interface KnowledgeResearchLoopContext {
   root: string;
   goal: string;
   iteration: number;
@@ -1002,7 +998,7 @@ interface KnowledgeResearchLoopContext {
   previousSteps: KnowledgeResearchLoopStep[];
   signal?: AbortSignal;
 }
-interface KnowledgeResearchLoopDecision {
+export interface KnowledgeResearchLoopDecision {
   /**
    * Free-form notes from the researcher. Keep this human-readable; products can
    * store it as the research transcript.
@@ -1029,7 +1025,7 @@ interface KnowledgeResearchLoopDecision {
   done?: boolean;
   metadata?: Record<string, unknown>;
 }
-interface KnowledgeResearchLoopStep {
+export interface KnowledgeResearchLoopStep {
   iteration: number;
   notes?: string;
   addedSources: SourceRecord[];
@@ -1041,7 +1037,7 @@ interface KnowledgeResearchLoopStep {
   done: boolean;
   metadata?: Record<string, unknown>;
 }
-interface RunKnowledgeResearchLoopOptions {
+export interface RunKnowledgeResearchLoopOptions {
   pagesDirectory?: string;
   root: string;
   goal: string;
@@ -1056,7 +1052,7 @@ interface RunKnowledgeResearchLoopOptions {
   step(context: KnowledgeResearchLoopContext): Promise<KnowledgeResearchLoopDecision> | KnowledgeResearchLoopDecision;
   onStep?: (step: KnowledgeResearchLoopStep) => Promise<void> | void;
 }
-interface KnowledgeResearchLoopResult {
+export interface KnowledgeResearchLoopResult {
   root: string;
   goal: string;
   iterations: number;
@@ -1067,10 +1063,10 @@ interface KnowledgeResearchLoopResult {
   readiness?: EvalKnowledgeBundleBuildResult;
   steps: KnowledgeResearchLoopStep[];
 }
-type KnowledgeControlLoopState = KnowledgeResearchLoopContext;
-type KnowledgeControlLoopAction = KnowledgeResearchLoopDecision;
-type KnowledgeControlLoopActionResult = KnowledgeResearchLoopStep;
-interface KnowledgeControlLoopAdapterOptions {
+export type KnowledgeControlLoopState = KnowledgeResearchLoopContext;
+export type KnowledgeControlLoopAction = KnowledgeResearchLoopDecision;
+export type KnowledgeControlLoopActionResult = KnowledgeResearchLoopStep;
+export interface KnowledgeControlLoopAdapterOptions {
   pagesDirectory?: string;
   root: string;
   goal: string;
@@ -1081,18 +1077,18 @@ interface KnowledgeControlLoopAdapterOptions {
   readiness?: Omit<BuildEvalKnowledgeBundleOptions, 'taskId' | 'index' | 'specs'>;
   sourceOptions?: Pick<AddSourceOptions, 'adapters' | 'now'>;
 }
-type KnowledgeControlLoopAdapter = Pick<ControlRuntimeConfig<KnowledgeControlLoopState, KnowledgeControlLoopAction, KnowledgeControlLoopActionResult, ControlEvalResult>, 'intent' | 'observe' | 'validate' | 'act' | 'shouldStop' | 'stopPolicies'>;
+export type KnowledgeControlLoopAdapter = Pick<ControlRuntimeConfig<KnowledgeControlLoopState, KnowledgeControlLoopAction, KnowledgeControlLoopActionResult, ControlEvalResult>, 'intent' | 'observe' | 'validate' | 'act' | 'shouldStop' | 'stopPolicies'>;
 /**
  * Adapter for running knowledge growth through `agent-eval`'s generic control
  * runtime. The caller still owns `decide`: that can be a proposer agent,
  * reviewer agent, deterministic policy, or a composition of all three.
  */
-declare function createKnowledgeControlLoopAdapter(options: KnowledgeControlLoopAdapterOptions): KnowledgeControlLoopAdapter;
-declare function runKnowledgeResearchLoop(options: RunKnowledgeResearchLoopOptions): Promise<KnowledgeResearchLoopResult>;
+export declare function createKnowledgeControlLoopAdapter(options: KnowledgeControlLoopAdapterOptions): KnowledgeControlLoopAdapter;
+export declare function runKnowledgeResearchLoop(options: RunKnowledgeResearchLoopOptions): Promise<KnowledgeResearchLoopResult>;
 //#endregion
 //#region src/retrieval-optimization.d.ts
 type RetrievalOptimizationBaseOptions = Omit<RunSerializedKnowledgeOptimizationOptions<RetrievalConfig, RetrievalEvalScenario, RetrievalEvalArtifact>, 'baseline' | 'method' | 'trainScenarios' | 'selectionScenarios' | 'finalScenarios' | 'dispatchCandidate' | 'judges' | 'codec' | 'scenarioFingerprint'>;
-interface RunRetrievalImprovementLoopOptions extends RetrievalOptimizationBaseOptions {
+export interface RunRetrievalImprovementLoopOptions extends RetrievalOptimizationBaseOptions {
   baseline: RetrievalConfig;
   trainScenarios: readonly RetrievalEvalScenario[];
   selectionScenarios: readonly RetrievalEvalScenario[];
@@ -1104,21 +1100,21 @@ interface RunRetrievalImprovementLoopOptions extends RetrievalOptimizationBaseOp
   judges?: readonly JudgeConfig<RetrievalEvalArtifact, RetrievalEvalScenario>[];
   metricWeights?: RetrievalMetricWeights;
 }
-interface RunRetrievalImprovementLoopResult extends RunSerializedKnowledgeOptimizationResult<RetrievalConfig> {
+export interface RunRetrievalImprovementLoopResult extends RunSerializedKnowledgeOptimizationResult<RetrievalConfig> {
   baselineConfig: RetrievalConfig;
   winnerConfig: RetrievalConfig;
   trainScenarios: readonly RetrievalEvalScenario[];
   selectionScenarios: readonly RetrievalEvalScenario[];
   finalScenarios: readonly RetrievalEvalScenario[];
 }
-declare function runRetrievalImprovementLoop(options: RunRetrievalImprovementLoopOptions): Promise<RunRetrievalImprovementLoopResult>;
+export declare function runRetrievalImprovementLoop(options: RunRetrievalImprovementLoopOptions): Promise<RunRetrievalImprovementLoopResult>;
 //#endregion
 //#region src/rag-improvement-loop.d.ts
-type RagKnowledgeImprovementPhase = 'rag-optimization' | 'retrieval-tuning' | 'gap-diagnosis' | 'knowledge-acquisition' | 'knowledge-update' | 'answer-quality' | 'promotion';
-type RagKnowledgeImprovementPhaseStatus = 'completed' | 'skipped' | 'failed';
-type RagGapKind = 'missing-source' | 'stale-source' | 'retrieval-miss' | 'retrieval-noise' | 'chunking-mismatch' | 'missing-multihop-evidence' | 'generator-unsupported-claim' | 'citation-mismatch' | 'incorrect-abstention' | 'unknown';
-type RagGapSeverity = 'info' | 'warning' | 'error' | 'critical';
-interface RagGapFinding {
+export type RagKnowledgeImprovementPhase = 'rag-optimization' | 'retrieval-tuning' | 'gap-diagnosis' | 'knowledge-acquisition' | 'knowledge-update' | 'answer-quality' | 'promotion';
+export type RagKnowledgeImprovementPhaseStatus = 'completed' | 'skipped' | 'failed';
+export type RagGapKind = 'missing-source' | 'stale-source' | 'retrieval-miss' | 'retrieval-noise' | 'chunking-mismatch' | 'missing-multihop-evidence' | 'generator-unsupported-claim' | 'citation-mismatch' | 'incorrect-abstention' | 'unknown';
+export type RagGapSeverity = 'info' | 'warning' | 'error' | 'critical';
+export interface RagGapFinding {
   id: string;
   kind: RagGapKind;
   severity: RagGapSeverity;
@@ -1126,7 +1122,7 @@ interface RagGapFinding {
   scenarioId?: string;
   evidence?: Record<string, AgentCandidateJsonValue>;
 }
-interface RagKnowledgeImprovementPhaseResult {
+export interface RagKnowledgeImprovementPhaseResult {
   phase: RagKnowledgeImprovementPhase;
   status: RagKnowledgeImprovementPhaseStatus;
   summary: string;
@@ -1134,40 +1130,40 @@ interface RagKnowledgeImprovementPhaseResult {
   finishedAt: string;
   metadata?: Record<string, AgentCandidateJsonValue>;
 }
-type RagOptimizationSelection = Pick<RunRagOptimizationResult, 'methodName' | 'baseline' | 'winner' | 'baselineConfig' | 'winnerConfig'>;
-type RetrievalOptimizationSelection = Pick<RunRetrievalImprovementLoopResult, 'methodName' | 'baseline' | 'winner' | 'baselineConfig' | 'winnerConfig'>;
-interface RagPhaseInputBase {
+export type RagOptimizationSelection = Pick<RunRagOptimizationResult, 'methodName' | 'baseline' | 'winner' | 'baselineConfig' | 'winnerConfig'>;
+export type RetrievalOptimizationSelection = Pick<RunRetrievalImprovementLoopResult, 'methodName' | 'baseline' | 'winner' | 'baselineConfig' | 'winnerConfig'>;
+export interface RagPhaseInputBase {
   goal: string;
   phases: readonly RagKnowledgeImprovementPhaseResult[];
   /** Selected candidate only. Adaptive update callbacks run before final scoring starts. */
   optimization?: RagOptimizationSelection;
   signal?: AbortSignal;
 }
-interface RagDiagnosisInput extends RagPhaseInputBase {
+export interface RagDiagnosisInput extends RagPhaseInputBase {
   retrieval?: RetrievalOptimizationSelection;
 }
-interface RagKnowledgeAcquisitionInput extends RagPhaseInputBase {
+export interface RagKnowledgeAcquisitionInput extends RagPhaseInputBase {
   retrieval?: RetrievalOptimizationSelection;
   findings: readonly RagGapFinding[];
 }
-interface RagKnowledgeUpdateInput extends RagPhaseInputBase {
+export interface RagKnowledgeUpdateInput extends RagPhaseInputBase {
   retrieval?: RetrievalOptimizationSelection;
   findings: readonly RagGapFinding[];
   acquisition?: KnowledgeResearchLoopDecision;
 }
-interface RagKnowledgeUpdateResult {
+export interface RagKnowledgeUpdateResult {
   applied: boolean;
   summary: string;
   research?: KnowledgeResearchLoopResult;
   metadata?: Record<string, AgentCandidateJsonValue>;
 }
-interface RagAnswerQualityInput extends RagPhaseInputBase {
+export interface RagAnswerQualityInput extends RagPhaseInputBase {
   retrieval?: RetrievalOptimizationSelection;
   findings: readonly RagGapFinding[];
   acquisition?: KnowledgeResearchLoopDecision;
   knowledgeUpdate?: RagKnowledgeUpdateResult;
 }
-interface RagAnswerQualityResult {
+export interface RagAnswerQualityResult {
   passed: boolean;
   metrics: Record<string, number>;
   finalScenarioIds: readonly string[];
@@ -1177,7 +1173,7 @@ interface RagAnswerQualityResult {
   findings?: readonly RagGapFinding[];
   metadata?: Record<string, AgentCandidateJsonValue>;
 }
-interface RagPromotionInput extends RagPhaseInputBase {
+export interface RagPromotionInput extends RagPhaseInputBase {
   retrieval?: RetrievalOptimizationSelection;
   /** Full final-case result available only to the terminal promotion decision. */
   optimizationComparison?: RunRagOptimizationResult['comparison'];
@@ -1188,16 +1184,16 @@ interface RagPromotionInput extends RagPhaseInputBase {
   knowledgeUpdate?: RagKnowledgeUpdateResult;
   answerQuality?: RagAnswerQualityResult;
 }
-interface RagPromotionResult {
+export interface RagPromotionResult {
   promoted: boolean;
   reason: string;
   metadata?: Record<string, AgentCandidateJsonValue>;
 }
-interface RagKnowledgeResearchOptions extends Omit<RunKnowledgeResearchLoopOptions, 'goal' | 'signal' | 'step'> {
+export interface RagKnowledgeResearchOptions extends Omit<RunKnowledgeResearchLoopOptions, 'goal' | 'signal' | 'step'> {
   goal?: string;
   step?: RunKnowledgeResearchLoopOptions['step'];
 }
-interface RunRagKnowledgeImprovementLoopOptions {
+export interface RunRagKnowledgeImprovementLoopOptions {
   goal: string;
   optimization?: RunRagOptimizationOptions;
   retrieval?: RunRetrievalImprovementLoopOptions;
@@ -1218,7 +1214,7 @@ interface RunRagKnowledgeImprovementLoopOptions {
   signal?: AbortSignal;
   now?: () => Date;
 }
-interface RunRagKnowledgeImprovementLoopResult {
+export interface RunRagKnowledgeImprovementLoopResult {
   goal: string;
   phases: readonly RagKnowledgeImprovementPhaseResult[];
   optimization?: RunRagOptimizationResult;
@@ -1230,7 +1226,7 @@ interface RunRagKnowledgeImprovementLoopResult {
   promotion?: RagPromotionResult;
 }
 type MaybePromise$1<T> = T | Promise<T>;
-declare function runRagKnowledgeImprovementLoop(options: RunRagKnowledgeImprovementLoopOptions): Promise<RunRagKnowledgeImprovementLoopResult>;
+export declare function runRagKnowledgeImprovementLoop(options: RunRagKnowledgeImprovementLoopOptions): Promise<RunRagKnowledgeImprovementLoopResult>;
 //#endregion
 //#region src/rag-eval/contracts.d.ts
 type RagEvalProvider = 'agent-knowledge' | 'ragas' | 'deepeval' | 'trulens' | 'ragchecker' | 'custom';
@@ -1382,34 +1378,34 @@ interface KnowledgeBaseQualityReport {
 type MaybePromise<T> = T | Promise<T>;
 //#endregion
 //#region src/rag-eval/calibration.d.ts
-declare function createRagAnswerQualityHook(options: RagAnswerQualityHookOptions): () => Promise<RagAnswerQualityResult>;
-declare function calibrateRagAnswerJudge(options: RagCalibrationOptions): Promise<RagCalibrationResult>;
+export declare function createRagAnswerQualityHook(options: RagAnswerQualityHookOptions): () => Promise<RagAnswerQualityResult>;
+export declare function calibrateRagAnswerJudge(options: RagCalibrationOptions): Promise<RagCalibrationResult>;
 //#endregion
 //#region src/rag-eval/knowledge-base.d.ts
-declare function scoreKnowledgeBaseIndex(index: KnowledgeIndex, options?: KnowledgeBaseQualityOptions): KnowledgeBaseQualityReport;
+export declare function scoreKnowledgeBaseIndex(index: KnowledgeIndex, options?: KnowledgeBaseQualityOptions): KnowledgeBaseQualityReport;
 //#endregion
 //#region src/rag-eval/providers.d.ts
-declare function normalizeExternalRagScores(scores: readonly ExternalRagEvalScore[]): Record<string, Record<RagEvalMetricKey, number>>;
-declare function toRagasEvaluationRows(cases: readonly RagAnswerEvalCase[]): {
+export declare function normalizeExternalRagScores(scores: readonly ExternalRagEvalScore[]): Record<string, Record<RagEvalMetricKey, number>>;
+export declare function toRagasEvaluationRows(cases: readonly RagAnswerEvalCase[]): {
   user_input: string;
   response: string;
   retrieved_contexts: string[];
   reference: string | undefined;
   reference_contexts: string[];
 }[];
-declare function toDeepEvalTestCases(cases: readonly RagAnswerEvalCase[]): {
+export declare function toDeepEvalTestCases(cases: readonly RagAnswerEvalCase[]): {
   input: string;
   actual_output: string;
   expected_output: string | undefined;
   retrieval_context: string[];
   context: string[];
 }[];
-declare function toTruLensRecords(cases: readonly RagAnswerEvalCase[]): {
+export declare function toTruLensRecords(cases: readonly RagAnswerEvalCase[]): {
   input: string;
   output: string;
   context: string;
 }[];
-declare function toRagCheckerRecords(cases: readonly RagAnswerEvalCase[]): {
+export declare function toRagCheckerRecords(cases: readonly RagAnswerEvalCase[]): {
   query_id: string;
   query: string;
   gt_answer: string | undefined;
@@ -1422,9 +1418,9 @@ declare function toRagCheckerRecords(cases: readonly RagAnswerEvalCase[]): {
 }[];
 //#endregion
 //#region src/rag-eval/scoring.d.ts
-declare function ragAnswerQualityJudge(options?: RagAnswerQualityJudgeOptions): JudgeConfig<RagAnswerEvalArtifact, RagAnswerEvalScenario>;
-declare function scoreRagAnswerArtifact(artifact: RagAnswerEvalArtifact, scenario: RagAnswerEvalScenario, options?: RagAnswerQualityJudgeOptions): RagAnswerMetricSummary;
-declare function diagnoseRagAnswerFailure(metrics: Record<RagEvalMetricKey, number>, scenario: RagAnswerEvalScenario, thresholds?: Partial<Record<RagEvalMetricKey, number>>): RagGapFinding[];
+export declare function ragAnswerQualityJudge(options?: RagAnswerQualityJudgeOptions): JudgeConfig<RagAnswerEvalArtifact, RagAnswerEvalScenario>;
+export declare function scoreRagAnswerArtifact(artifact: RagAnswerEvalArtifact, scenario: RagAnswerEvalScenario, options?: RagAnswerQualityJudgeOptions): RagAnswerMetricSummary;
+export declare function diagnoseRagAnswerFailure(metrics: Record<RagEvalMetricKey, number>, scenario: RagAnswerEvalScenario, thresholds?: Partial<Record<RagEvalMetricKey, number>>): RagGapFinding[];
 //#endregion
 //#region src/kb-improvement/contracts.d.ts
 type KnowledgeImprovementStatus = 'running' | 'candidate-ready' | 'promoted' | 'rejected' | 'blocked';
@@ -1526,7 +1522,7 @@ interface KnowledgeImprovementActivationPersistence {
   /** May run again after interruption; keep this deterministic and free of external side effects. */
   createResult(mutation: KnowledgeImprovementMutationReceipt): Promise<AgentImprovementActivationResult> | AgentImprovementActivationResult;
 }
-declare const KnowledgeImprovementRunStateSchema: z.ZodObject<{
+export declare const KnowledgeImprovementRunStateSchema: z.ZodObject<{
   stateScope: z.ZodOptional<z.ZodObject<{
     pagesDirectory: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
     researchState: z.ZodOptional<z.ZodBoolean>;
@@ -1567,7 +1563,7 @@ declare const KnowledgeImprovementRunStateSchema: z.ZodObject<{
   promotedCandidateId: z.ZodOptional<z.ZodString>;
   blockedReason: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
-declare const KnowledgeImprovementEvidenceSchema: z.ZodObject<{
+export declare const KnowledgeImprovementEvidenceSchema: z.ZodObject<{
   kind: z.ZodLiteral<"knowledge-improvement-evidence">;
   runId: z.ZodString;
   candidateId: z.ZodString;
@@ -1611,7 +1607,7 @@ declare const KnowledgeImprovementEvidenceSchema: z.ZodObject<{
 }, z.core.$strict>;
 type KnowledgeImprovementEvidence = z.infer<typeof KnowledgeImprovementEvidenceSchema>;
 /** Portable identity of one measured candidate. Paths and mutable run state are deliberately excluded. */
-declare const KnowledgeImprovementCandidateRefSchema: z.ZodObject<{
+export declare const KnowledgeImprovementCandidateRefSchema: z.ZodObject<{
   kind: z.ZodLiteral<"knowledge-improvement-candidate">;
   runId: z.ZodString;
   candidateId: z.ZodString;
@@ -1730,7 +1726,7 @@ interface KnowledgeImprovementOptions {
 //#endregion
 //#region src/kb-improvement/activation.d.ts
 /** Load the durable result for one exact activation without changing knowledge or run state. */
-declare function loadKnowledgeImprovementActivationResult(options: LoadKnowledgeImprovementActivationResultOptions): Promise<AgentImprovementActivationResult | null>;
+export declare function loadKnowledgeImprovementActivationResult(options: LoadKnowledgeImprovementActivationResultOptions): Promise<AgentImprovementActivationResult | null>;
 //#endregion
 //#region src/kb-improvement/optimization.d.ts
 type PolicyCandidateOptions = Omit<KnowledgeImprovementOptions, 'root' | 'goal' | 'implementationRef' | 'runId' | 'maxCandidates' | 'step' | 'knowledgeResearch' | 'updateKnowledge'>;
@@ -1767,7 +1763,7 @@ interface OptimizeKnowledgeBasePolicyResult<TPolicy extends AgentCandidateJsonVa
  * Optimizes a serialized KB-maintenance policy, then materializes the selected
  * policy in one isolated knowledge candidate. Activation remains explicit.
  */
-declare function optimizeKnowledgeBasePolicy<TPolicy extends AgentCandidateJsonValue, TScenario extends Scenario, TArtifact>(options: OptimizeKnowledgeBasePolicyOptions<TPolicy, TScenario, TArtifact>): Promise<OptimizeKnowledgeBasePolicyResult<TPolicy>>;
+export declare function optimizeKnowledgeBasePolicy<TPolicy extends AgentCandidateJsonValue, TScenario extends Scenario, TArtifact>(options: OptimizeKnowledgeBasePolicyOptions<TPolicy, TScenario, TArtifact>): Promise<OptimizeKnowledgeBasePolicyResult<TPolicy>>;
 type KnowledgePolicyDispatch<TPolicy extends AgentCandidateJsonValue, TScenario extends Scenario, TArtifact> = (input: {
   candidate: TPolicy;
   candidateSurface: string;
@@ -1777,7 +1773,7 @@ type KnowledgePolicyDispatch<TPolicy extends AgentCandidateJsonValue, TScenario
 }) => Promise<TArtifact>;
 //#endregion
 //#region src/kb-improvement/run.d.ts
-declare function improveKnowledgeBase(options: KnowledgeImprovementOptions): Promise<KnowledgeImprovementResult>;
+export declare function improveKnowledgeBase(options: KnowledgeImprovementOptions): Promise<KnowledgeImprovementResult>;
 //#endregion
 //#region src/kb-improvement/selected-candidate.d.ts
 declare const measuredSelectionReceiptSchema: z.ZodObject<{
@@ -1843,17 +1839,17 @@ interface ImproveSelectedKnowledgeCandidateResult extends KnowledgeImprovementRe
  * 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>;
+export 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;
-declare function loadKnowledgeImprovementState(root: string, runId: string): Promise<KnowledgeImprovementRunState | null>;
+export declare function knowledgeImprovementRunId(root: string, goal: string): string;
+export declare function knowledgeImprovementRunDir(root: string, runId: string): string;
+export declare function loadKnowledgeImprovementState(root: string, runId: string): Promise<KnowledgeImprovementRunState | null>;
 interface KnowledgeImprovementEvent extends Record<string, unknown> {
   at: string;
   type: string;
 }
-declare function loadKnowledgeImprovementEvents(root: string, runId: string): Promise<KnowledgeImprovementEvent[]>;
+export declare function loadKnowledgeImprovementEvents(root: string, runId: string): Promise<KnowledgeImprovementEvent[]>;
 //#endregion
 //#region src/file-transaction.d.ts
 declare const transactionSchema: z.ZodObject<{
@@ -1861,6 +1857,8 @@ declare const transactionSchema: z.ZodObject<{
   transactionId: z.ZodString;
   purpose: z.ZodString;
   recoveryOwner: z.ZodOptional<z.ZodString>;
+  actorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  runId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   pagesDirectory: z.ZodOptional<z.ZodString>;
   researchState: z.ZodOptional<z.ZodBoolean>;
   retainHistory: z.ZodOptional<z.ZodBoolean>;
@@ -1878,24 +1876,24 @@ type KnowledgeFileTransaction = z.infer<typeof transactionSchema>;
 //#endregion
 //#region src/kb-improvement/transition.d.ts
 /** Promote one previously measured candidate without rerunning research or evaluation. */
-declare function promoteKnowledgeCandidate(options: PromoteKnowledgeCandidateOptions): Promise<KnowledgeImprovementMutationResult>;
+export declare function promoteKnowledgeCandidate(options: PromoteKnowledgeCandidateOptions): Promise<KnowledgeImprovementMutationResult>;
 /** Restore the frozen baseline paired with one previously measured candidate. */
-declare function restoreKnowledgeCandidateBaseline(options: RestoreKnowledgeCandidateBaselineOptions): Promise<KnowledgeImprovementMutationResult>;
+export declare function restoreKnowledgeCandidateBaseline(options: RestoreKnowledgeCandidateBaselineOptions): Promise<KnowledgeImprovementMutationResult>;
 //#endregion
 //#region src/kb-improvement/workspace.d.ts
 /** Freeze the exact knowledge bytes and measured evidence a later approval may promote. */
-declare function knowledgeImprovementCandidateRef(result: Pick<KnowledgeImprovementResult, 'runId' | 'state' | 'candidate'>): KnowledgeImprovementCandidateRef;
+export declare function knowledgeImprovementCandidateRef(result: Pick<KnowledgeImprovementResult, 'runId' | 'state' | 'candidate'>): KnowledgeImprovementCandidateRef;
 /** Use both frozen sides of one measured comparison in isolated, integrity-checked copies. */
-declare function withKnowledgeImprovementComparison<T>(options: UseKnowledgeImprovementCandidateOptions, use: (comparison: ResolvedKnowledgeImprovementComparison) => Promise<T> | T): Promise<T>;
+export declare function withKnowledgeImprovementComparison<T>(options: UseKnowledgeImprovementCandidateOptions, use: (comparison: ResolvedKnowledgeImprovementComparison) => Promise<T> | T): Promise<T>;
 /** Use the frozen candidate side of one measured comparison. */
-declare function withKnowledgeImprovementCandidate<T>(options: UseKnowledgeImprovementCandidateOptions, use: (candidate: ResolvedKnowledgeImprovementCandidate) => Promise<T> | T): Promise<T>;
-declare function hashKnowledgeBase(root: string, scope?: KnowledgeStateScope): Promise<string>;
+export declare function withKnowledgeImprovementCandidate<T>(options: UseKnowledgeImprovementCandidateOptions, use: (candidate: ResolvedKnowledgeImprovementCandidate) => Promise<T> | T): Promise<T>;
+export declare function hashKnowledgeBase(root: string, scope?: KnowledgeStateScope): Promise<string>;
 //#endregion
 //#region src/agent-candidate.d.ts
 /** Convert a measured knowledge candidate into the shared review and execution identity. */
-declare function toAgentCandidateKnowledgeRef(candidate: KnowledgeImprovementCandidateRef): AgentCandidateKnowledgeRef;
+export declare function toAgentCandidateKnowledgeRef(candidate: KnowledgeImprovementCandidateRef): AgentCandidateKnowledgeRef;
 /** Recover agent-knowledge's candidate identity from the shared contract. */
-declare function fromAgentCandidateKnowledgeRef(candidate: AgentCandidateKnowledgeRef): KnowledgeImprovementCandidateRef;
+export declare function fromAgentCandidateKnowledgeRef(candidate: AgentCandidateKnowledgeRef): KnowledgeImprovementCandidateRef;
 //#endregion
 //#region src/changes.d.ts
 /**
@@ -1925,8 +1923,8 @@ declare function fromAgentCandidateKnowledgeRef(candidate: AgentCandidateKnowled
  *
  * @stable
  */
-type KnowledgeChangeKind = 'added' | 'removed' | 'modified';
-interface KnowledgeChange {
+export type KnowledgeChangeKind = 'added' | 'removed' | 'modified';
+export interface KnowledgeChange {
   /** Source-scoped id (matches `KnowledgeFragment.id`). */
   fragmentId: string;
   kind: KnowledgeChangeKind;
@@ -1954,7 +1952,7 @@ interface KnowledgeChange {
    */
   detectedAt: string;
 }
-interface DetectChangesResult {
+export interface DetectChangesResult {
   changes: KnowledgeChange[];
   /** Counts by kind — handy for dashboards. */
   summary: {
@@ -1965,7 +1963,7 @@ interface DetectChangesResult {
   /** Non-fatal diagnostics (duplicate ids, dropped unverifiable fragments). */
   warnings: string[];
 }
-interface DetectChangesOptions {
+export interface DetectChangesOptions {
   /**
    * When true (default), unverifiable fragments are dropped from both
    * sides before comparison. Set false ONLY when debugging block-page
@@ -1980,16 +1978,16 @@ interface DetectChangesOptions {
    */
   filterDimensions?: string[];
 }
-declare function detectChanges(prev: KnowledgeFragment[], next: KnowledgeFragment[], options?: DetectChangesOptions): DetectChangesResult;
+export declare function detectChanges(prev: KnowledgeFragment[], next: KnowledgeFragment[], options?: DetectChangesOptions): DetectChangesResult;
 //#endregion
 //#region src/chunking.d.ts
-interface ChunkingOptions {
+export interface ChunkingOptions {
   targetChars: number;
   maxChars: number;
   minChars: number;
   overlapChars: number;
 }
-interface KnowledgeChunk {
+export interface KnowledgeChunk {
   index: number;
   text: string;
   headingPath: string;
@@ -1997,17 +1995,17 @@ interface KnowledgeChunk {
   charEnd: number;
   oversized: boolean;
 }
-declare function chunkMarkdown(content: string, options?: Partial<ChunkingOptions>): KnowledgeChunk[];
-declare function stripFrontmatter(content: string): {
+export declare function chunkMarkdown(content: string, options?: Partial<ChunkingOptions>): KnowledgeChunk[];
+export 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. */
-declare function knowledgeCitationAuditFindings(report: KnowledgeCitationAuditReport): KnowledgeLintFinding[];
+export 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[]>;
+export declare function lintCurrentRunCitations(stores: RunScopedStores, runId: string): Promise<KnowledgeLintFinding[]>;
 //#endregion
 //#region src/claim-evidence.d.ts
 /**
@@ -2035,10 +2033,10 @@ declare function lintCurrentRunCitations(stores: RunScopedStores, runId: string)
  * Reporting a low rung in the vocabulary of a high one is the most expensive error available to a
  * knowledge system: it is indistinguishable from success and propagates as settled provenance.
  */
-type EvidenceRung = 1 | 2 | 3 | 4 | 5;
+export type EvidenceRung = 1 | 2 | 3 | 4 | 5;
 /** The rung at and above which a claim must be machine-checkable to be recorded at that rung. */
-declare const CHECKABLE_RUNG_THRESHOLD = 4;
-interface ClaimEvidence {
+export declare const CHECKABLE_RUNG_THRESHOLD = 4;
+export interface ClaimEvidence {
   rung: EvidenceRung;
   /**
    * A shell command that re-establishes the claim when run by a grader the author cannot edit,
@@ -2065,7 +2063,7 @@ interface ClaimEvidence {
  * all of them: `uncheckable`. `note` names which shape was refused and what to record instead, in
  * the same words the grader reports, so an author reads one message wherever the claim is stopped.
  */
-declare class UncheckableClaimError extends Error {
+export declare class UncheckableClaimError extends Error {
   /** The rung whose evidence rule the recorded claim failed. */
   readonly rung: EvidenceRung;
   /** The refused shape and the fix for it, in the grader's vocabulary. */
@@ -2086,7 +2084,7 @@ declare class UncheckableClaimError extends Error {
  * were never executed before their authors disappeared. The dynamic half of that last rule is
  * `verifyGradeableEvidence` below.
  */
-declare function assertGradeableEvidence(evidence: ClaimEvidence): ClaimEvidence;
+export declare function assertGradeableEvidence(evidence: ClaimEvidence): ClaimEvidence;
 /**
  * What a grader may conclude from re-executing a claim's check.
  *
@@ -2099,15 +2097,15 @@ declare function assertGradeableEvidence(evidence: ClaimEvidence): ClaimEvidence
  *                 deadline killed it — an environment verdict, never a claim verdict
  *   uncheckable   the recorded evidence cannot decide the claim at this rung
  */
-type ClaimVerdict = 'verified' | 'silent-check' | 'contradicted' | 'unrunnable' | 'uncheckable';
+export type ClaimVerdict = 'verified' | 'silent-check' | 'contradicted' | 'unrunnable' | 'uncheckable';
 /**
  * The exit status a deadline kill reports: `timeout(1)`'s status, and the one a bounded process
  * runner forces so a killed child that closes with 0 cannot read as a pass. A grader that has
  * only an exit status reports this one; a grader that knows it killed the process sets
  * `CheckExecution.timedOut` instead, which is unambiguous.
  */
-declare const DEADLINE_EXIT_CODE = 124;
-interface CheckExecution {
+export declare const DEADLINE_EXIT_CODE = 124;
+export interface CheckExecution {
   exitCode: number;
   stdout: string;
   stderr: string;
@@ -2130,7 +2128,7 @@ interface CheckExecution {
   outputTruncated?: boolean;
 }
 /** A verdict with the reason a grader may report to the claim's author. */
-interface ClaimGrade {
+export interface ClaimGrade {
   verdict: ClaimVerdict;
   /** Present when the verdict is a refusal the author can fix, absent otherwise. */
   note?: string;
@@ -2155,9 +2153,9 @@ interface ClaimGrade {
  *   - a check whose output says it never reached its input is `unrunnable` whatever its exit
  *     status, because a pipeline hides the failing stage's status behind its last stage.
  */
-declare function gradeFor(evidence: Pick<ClaimEvidence, 'rung' | 'check' | 'expect'>, execution: CheckExecution | null): ClaimGrade;
+export declare function gradeFor(evidence: Pick<ClaimEvidence, 'rung' | 'check' | 'expect'>, execution: CheckExecution | null): ClaimGrade;
 /** A claim and the observation a grader made of it, as one grading pass sees them. */
-interface GradeableClaim {
+export interface GradeableClaim {
   /** Stable identity a duplicate flag can point back to, such as the page or claim id. */
   id: string;
   /** The claim's own sentence. Two claims that share a check but say different things differ. */
@@ -2166,7 +2164,7 @@ interface GradeableClaim {
   execution: CheckExecution | null;
 }
 /** A grade with the claim it belongs to, in the order the claims were supplied. */
-interface GradedClaim extends ClaimGrade {
+export interface GradedClaim extends ClaimGrade {
   id: string;
 }
 /**
@@ -2178,7 +2176,7 @@ interface GradedClaim extends ClaimGrade {
  * claim with `duplicateOf`, leaving the verdict and the count untouched: the flag is for a reader
  * deciding how much evidence a run really produced.
  */
-declare function gradeClaims(claims: readonly GradeableClaim[]): GradedClaim[];
+export declare function gradeClaims(claims: readonly GradeableClaim[]): GradedClaim[];
 /**
  * The identity two claims must share to be one verification counted twice: the same command, the
  * same expectation, and the same sentence. A check shared across claims that say different things
@@ -2188,14 +2186,14 @@ declare function gradeClaims(claims: readonly GradeableClaim[]): GradedClaim[];
  * so an unkeyable claim is never flagged as a repeat of another unkeyable one. The key is JSON
  * rather than a joined string, so no separator can collide with text inside a check.
  */
-declare function claimCheckKey(claim: {
+export declare function claimCheckKey(claim: {
   check?: string;
   expect?: string;
   title?: string;
 }): string | undefined;
 /** The verdict alone, for graders that report a lattice member and not a reason. */
-declare function verdictFor(evidence: Pick<ClaimEvidence, 'rung' | 'check' | 'expect'>, execution: CheckExecution | null): ClaimVerdict;
-interface VerifyGradeableEvidenceOptions {
+export declare function verdictFor(evidence: Pick<ClaimEvidence, 'rung' | 'check' | 'expect'>, execution: CheckExecution | null): ClaimVerdict;
+export interface VerifyGradeableEvidenceOptions {
   /** Directory in which the later grader will execute the command. Required to avoid ambient cwd. */
   cwd: string;
   /** Exact environment visible to the command. Omitted variables are genuinely absent. */
@@ -2208,7 +2206,7 @@ interface VerifyGradeableEvidenceOptions {
   maxBufferBytes?: number;
   signal?: AbortSignal;
 }
-interface VerifiedGradeableEvidence {
+export interface VerifiedGradeableEvidence {
   evidence: ClaimEvidence;
   execution: CheckExecution;
   grade: ClaimGrade;
@@ -2227,7 +2225,7 @@ interface VerifiedGradeableEvidence {
  * it remain importable. Callers must apply their own sandbox and capability policy before passing
  * untrusted commands here.
  */
-declare function verifyGradeableEvidence(evidence: ClaimEvidence, options: VerifyGradeableEvidenceOptions): Promise<VerifiedGradeableEvidence>;
+export declare function verifyGradeableEvidence(evidence: ClaimEvidence, options: VerifyGradeableEvidenceOptions): Promise<VerifiedGradeableEvidence>;
 //#endregion
 //#region src/claim-grounding.d.ts
 /**
@@ -2235,12 +2233,12 @@ declare function verifyGradeableEvidence(evidence: ClaimEvidence, options: Verif
  * for. The worker sets `metadata[citedClaimKey] = '<the claim>'`; the
  * claim-grounding driver reads it and checks it against the fetched page text.
  */
-declare const citedClaimKey = "citedClaim";
+export declare const citedClaimKey = "citedClaim";
 /** Read the cited claim a proposal carries, if any. */
-declare function citedClaimOf(source: ResearchSourceProposal): string | undefined;
+export declare function citedClaimOf(source: ResearchSourceProposal): string | undefined;
 /** Attach a cited claim to a proposal (immutably returns a new proposal). */
-declare function withCitedClaim(source: ResearchSourceProposal, claim: string): ResearchSourceProposal;
-interface GroundingResult {
+export declare function withCitedClaim(source: ResearchSourceProposal, claim: string): ResearchSourceProposal;
+export interface GroundingResult {
   /** True when the claim is sufficiently present in the page text. */
   grounded: boolean;
   /** How the claim matched (or why it didn't). For audit/notes. */
@@ -2253,7 +2251,7 @@ interface GroundingResult {
   /** Content words present in the claim but NOT in the page text. */
   missingWords: string[];
 }
-interface GroundClaimOptions {
+export interface GroundClaimOptions {
   /**
    * Minimum fraction of the claim's content words that must appear in the page
    * text to count as a close paraphrase when there is no verbatim/normalized
@@ -2282,8 +2280,8 @@ interface GroundClaimOptions {
  * enough for the driver to give a precise rejection reason and for a test/doc to
  * audit WHY a claim grounded or didn't.
  */
-declare function groundClaimInText(claim: string, pageText: string, options?: GroundClaimOptions): GroundingResult;
-interface ClaimGroundingDriverOptions extends GroundClaimOptions {
+export declare function groundClaimInText(claim: string, pageText: string, options?: GroundClaimOptions): GroundingResult;
+export interface ClaimGroundingDriverOptions extends GroundClaimOptions {
   /**
    * Optional second verifier to compose AFTER grounding passes. When set, a
    * source must BOTH ground its claim AND pass this verifier (e.g. the LLM
@@ -2309,8 +2307,8 @@ interface ClaimGroundingDriverOptions extends GroundClaimOptions {
  * The returned function matches `ResearchDriver['verifySource']`, so it drops
  * straight into `runVerifiedResearchLoop` as `{ verifySource: createClaimGroundingVerifier(...) }`.
  */
-declare function createClaimGroundingVerifier(options?: ClaimGroundingDriverOptions): (source: ResearchSourceProposal, ctx: SourceVerificationContext) => Promise<SourceVerdict>;
-interface WorkerClaimDecorationOptions {
+export declare function createClaimGroundingVerifier(options?: ClaimGroundingDriverOptions): (source: ResearchSourceProposal, ctx: SourceVerificationContext) => Promise<SourceVerdict>;
+export interface WorkerClaimDecorationOptions {
   router?: RouterClient;
   router_options?: TangleRouterOptions;
   /** Max output tokens for the claim-extraction call. Default 1200 (glm floor). */
@@ -2329,7 +2327,7 @@ interface WorkerClaimDecorationOptions {
  * unchanged if the model returns nothing parseable (the verifier's
  * `onMissingClaim` policy then decides).
  */
-declare function createClaimDecorator(options?: WorkerClaimDecorationOptions): (source: ResearchSourceProposal, goal: string) => Promise<ResearchSourceProposal>;
+export declare function createClaimDecorator(options?: WorkerClaimDecorationOptions): (source: ResearchSourceProposal, goal: string) => Promise<ResearchSourceProposal>;
 //#endregion
 //#region src/claim-ledger.d.ts
 /**
@@ -2338,13 +2336,13 @@ declare function createClaimDecorator(options?: WorkerClaimDecorationOptions): (
  * sources rather than two claims with one each — which is the difference
  * between corroborated and unsupported.
  */
-declare function claimId(text: string): string;
+export declare function claimId(text: string): string;
 /** Stable identity for one extracted claim/source/contradiction observation. */
-declare function claimEvidenceId(claim: Pick<ResearchClaimEvidence, 'claimId' | 'sourceId' | 'sourceUri' | 'sourceContentHash' | 'contradictsClaimId'>): string;
+export declare function claimEvidenceId(claim: Pick<ResearchClaimEvidence, 'claimId' | 'sourceId' | 'sourceUri' | 'sourceContentHash' | 'contradictsClaimId'>): string;
 /** Canonical key for one exact registry-id + original-URI + hash source version. */
-declare function researchSourceVersionKey(source: Pick<ResearchSourceVersion, 'sourceId' | 'uri' | 'contentHash'>): string;
+export declare function researchSourceVersionKey(source: Pick<ResearchSourceVersion, 'sourceId' | 'uri' | 'contentHash'>): string;
 /** Case-, whitespace-, and stylistic-punctuation-insensitive claim identity form. */
-declare function normalizeClaimText(text: string): string;
+export declare function normalizeClaimText(text: string): string;
 /**
  * The canonical host a source uri counts as, which is what makes two sources
  * INDEPENDENT: corroboration is "distinct hosts", so this function is the rule
@@ -2353,9 +2351,9 @@ declare function normalizeClaimText(text: string): string;
  * consumer that counted raw uris would report two pages of one site as
  * independent confirmation.
  */
-declare function claimSourceHost(uri: string): string;
+export declare function claimSourceHost(uri: string): string;
 /** Stable identity for one deep question. */
-declare function deepQuestionId(kind: DeepQuestion['kind'], text: string): string;
+export declare function deepQuestionId(kind: DeepQuestion['kind'], text: string): string;
 /**
  * Refuse a claim record whose identity or source count disagrees with its evidence.
  *
@@ -2364,15 +2362,15 @@ declare function deepQuestionId(kind: DeepQuestion['kind'], text: string): strin
  * manufacture corroboration. Canonical ordering also makes equal records have
  * equal bytes regardless of which process assembled them.
  */
-declare function assertTrackedClaimIntegrity(claim: ResearchClaimRecord): void;
+export declare function assertTrackedClaimIntegrity(claim: ResearchClaimRecord): void;
 /** Refuse a deep question whose stable identity or set fields are malformed. */
-declare function assertDeepQuestionIntegrity(question: DeepQuestion): void;
+export declare function assertDeepQuestionIntegrity(question: DeepQuestion): void;
 /** Refuse an extracted observation whose identity or content is malformed. */
-declare function assertResearchClaimEvidenceIntegrity(evidence: ResearchClaimEvidence): void;
+export declare function assertResearchClaimEvidenceIntegrity(evidence: ResearchClaimEvidence): void;
 /** Refuse a ledger that is not one canonical, internally consistent record. */
-declare function assertResearchClaimLedgerIntegrity(ledger: ResearchClaimLedger): void;
+export declare function assertResearchClaimLedgerIntegrity(ledger: ResearchClaimLedger): void;
 /** A ledger with nothing in it yet. */
-declare function emptyClaimLedger(id: string, goal?: string): ResearchClaimLedger;
+export declare function emptyClaimLedger(id: string, goal?: string): ResearchClaimLedger;
 /**
  * Turn only evidence backed by a confirmed source registration into support.
  *
@@ -2380,14 +2378,14 @@ declare function emptyClaimLedger(id: string, goal?: string): ResearchClaimLedge
  * it twice is a no-op. Keeping it in the ledger algebra means a source-confirming
  * writer and an evidence-producing writer can arrive in either order.
  */
-declare function materializeRegisteredClaimEvidence(ledger: ResearchClaimLedger): ResearchClaimLedger;
+export declare function materializeRegisteredClaimEvidence(ledger: ResearchClaimLedger): ResearchClaimLedger;
 /**
  * Raised when two ledgers that accumulated evidence for DIFFERENT goals are
  * combined. Merging them would pool two questions' evidence into one
  * corroboration count, which reports a claim as independently confirmed when
  * nobody confirmed it — strictly worse than losing the ledger, so this refuses.
  */
-declare class ClaimLedgerGoalConflictError extends Error {
+export declare class ClaimLedgerGoalConflictError extends Error {
   readonly ledgerId: string;
   readonly existingGoal: string;
   readonly incomingGoal: string;
@@ -2402,7 +2400,7 @@ declare class ClaimLedgerGoalConflictError extends Error {
  * seeing a contradiction is enough for the claim to be contested, and no later
  * writer that simply did not see it may clear the flag.
  */
-declare function mergeTrackedClaims(base: ResearchClaimRecord, incoming: ResearchClaimRecord): ResearchClaimRecord;
+export declare function mergeTrackedClaims(base: ResearchClaimRecord, incoming: ResearchClaimRecord): ResearchClaimRecord;
 /**
  * Combine two ledgers for the same run.
  *
@@ -2412,7 +2410,7 @@ declare function mergeTrackedClaims(base: ResearchClaimRecord, incoming: Researc
  * is associative and idempotent — merge order cannot change the result and a
  * replayed merge is a no-op.
  */
-declare function mergeClaimLedgers(base: ResearchClaimLedger, incoming: ResearchClaimLedger): ResearchClaimLedger;
+export declare function mergeClaimLedgers(base: ResearchClaimLedger, incoming: ResearchClaimLedger): ResearchClaimLedger;
 /**
  * Make every contradiction edge symmetric and mark both ends contested.
  *
@@ -2429,7 +2427,7 @@ declare function mergeClaimLedgers(base: ResearchClaimLedger, incoming: Research
  * only closed pairs, so it cannot report a lone weak claim as settled merely
  * because its evidence named a claim that never arrived.
  */
-declare function linkClaimContradictions(ledger: ResearchClaimLedger): ResearchClaimLedger;
+export declare function linkClaimContradictions(ledger: ResearchClaimLedger): ResearchClaimLedger;
 //#endregion
 //#region src/collection-research-driver.d.ts
 /**
@@ -2437,17 +2435,17 @@ declare function linkClaimContradictions(ledger: ResearchClaimLedger): ResearchC
  * never researches, never steers beyond the loop's default open-gap list. The
  * worker is the only agent that thinks.
  */
-declare function createCollectionResearchDriver(): ResearchDriver;
+export declare function createCollectionResearchDriver(): ResearchDriver;
 //#endregion
 //#region src/discovery.d.ts
-interface DiscoveryTask {
+export interface DiscoveryTask {
   id: string;
   goal: string;
   query?: string;
   sourceHints?: string[];
   metadata?: Record<string, unknown>;
 }
-interface DiscoveryResult {
+export interface DiscoveryResult {
   taskId: string;
   summary: string;
   sourceUris?: string[];
@@ -2459,23 +2457,23 @@ interface DiscoveryResult {
   followUpTasks?: DiscoveryTask[];
   metadata?: Record<string, unknown>;
 }
-interface KnowledgeDiscoveryWorker {
+export interface KnowledgeDiscoveryWorker {
   run(task: DiscoveryTask, signal?: AbortSignal): Promise<DiscoveryResult> | DiscoveryResult;
 }
-interface KnowledgeDiscoveryDispatcher {
+export interface KnowledgeDiscoveryDispatcher {
   dispatch(tasks: DiscoveryTask[], options?: {
     concurrency?: number;
     signal?: AbortSignal;
   }): Promise<DiscoveryResult[]>;
 }
-type DiscoveryLoopStopReason = 'complete' | 'max-rounds' | 'max-tasks' | 'aborted';
-interface DiscoveryLoopRound {
+export type DiscoveryLoopStopReason = 'complete' | 'max-rounds' | 'max-tasks' | 'aborted';
+export interface DiscoveryLoopRound {
   round: number;
   tasks: DiscoveryTask[];
   results: DiscoveryResult[];
   queuedFollowUps: DiscoveryTask[];
 }
-interface DiscoveryLoopResult {
+export interface DiscoveryLoopResult {
   stopReason: DiscoveryLoopStopReason;
   tasksDispatched: number;
   results: DiscoveryResult[];
@@ -2485,7 +2483,7 @@ interface DiscoveryLoopResult {
   /** Structurally identical task identities ignored to prevent cycles. */
   duplicateTaskIds: string[];
 }
-interface RunDiscoveryLoopOptions {
+export interface RunDiscoveryLoopOptions {
   dispatcher: KnowledgeDiscoveryDispatcher;
   initialTasks: readonly DiscoveryTask[];
   /** Maximum follow-up depth including the initial dispatch. Default 3. */
@@ -2503,41 +2501,41 @@ interface RunDiscoveryLoopOptions {
  * The runner owns only bounded scheduling and accounting. Workers own search,
  * source verification, and domain-specific candidate shapes.
  */
-declare function runDiscoveryLoop(options: RunDiscoveryLoopOptions): Promise<DiscoveryLoopResult>;
-declare function createLocalDiscoveryDispatcher(worker: KnowledgeDiscoveryWorker): KnowledgeDiscoveryDispatcher;
+export declare function runDiscoveryLoop(options: RunDiscoveryLoopOptions): Promise<DiscoveryLoopResult>;
+export declare function createLocalDiscoveryDispatcher(worker: KnowledgeDiscoveryWorker): KnowledgeDiscoveryDispatcher;
 //#endregion
 //#region src/durable-fs.d.ts
-interface RegularFileSnapshot {
+export interface RegularFileSnapshot {
   bytes: Buffer;
   mode: number;
 }
-declare function writeFileDurable(path: string, data: string | Buffer, options?: {
+export declare function writeFileDurable(path: string, data: string | Buffer, options?: {
   encoding?: BufferEncoding;
   mode?: number;
 }): Promise<void>;
-declare function writeJsonDurable(path: string, value: unknown): Promise<void>;
-declare function writeFileDurableWithinRoot(root: string, relativePath: string, data: string | Buffer, options?: {
+export declare function writeJsonDurable(path: string, value: unknown): Promise<void>;
+export declare function writeFileDurableWithinRoot(root: string, relativePath: string, data: string | Buffer, options?: {
   encoding?: BufferEncoding;
   mode?: number;
 }): Promise<void>;
-declare function writeJsonDurableWithinRoot(root: string, relativePath: string, value: unknown): Promise<void>;
-declare function renameDurable(source: string, target: string): Promise<void>;
-declare function removeDurable(path: string): Promise<void>;
-declare function syncDirectory(path: string): Promise<void>;
+export declare function writeJsonDurableWithinRoot(root: string, relativePath: string, value: unknown): Promise<void>;
+export declare function renameDurable(source: string, target: string): Promise<void>;
+export declare function removeDurable(path: string): Promise<void>;
+export declare function syncDirectory(path: string): Promise<void>;
 /**
  * Keeps the target's parent directory open while the operation runs. On Linux,
  * `/proc/self/fd` anchors every lookup to that directory even if an ancestor is
  * renamed concurrently.
  */
-declare function withSafeDescendant<T>(root: string, relativePath: string, use: (path: string) => Promise<T> | T): Promise<T>;
-declare function withSafeDirectory<T>(root: string, relativePath: string, create: boolean, use: (path: string) => Promise<T> | T): Promise<T>;
-declare function readRegularFileNoFollow(path: string): Promise<RegularFileSnapshot>;
-declare function readRegularFileWithinRoot(root: string, relativePath: string): Promise<RegularFileSnapshot>;
-declare function listRegularFilesWithinRoot(root: string, relativeDirectory: string): Promise<Array<RegularFileSnapshot & {
+export declare function withSafeDescendant<T>(root: string, relativePath: string, use: (path: string) => Promise<T> | T): Promise<T>;
+export declare function withSafeDirectory<T>(root: string, relativePath: string, create: boolean, use: (path: string) => Promise<T> | T): Promise<T>;
+export declare function readRegularFileNoFollow(path: string): Promise<RegularFileSnapshot>;
+export declare function readRegularFileWithinRoot(root: string, relativePath: string): Promise<RegularFileSnapshot>;
+export declare function listRegularFilesWithinRoot(root: string, relativeDirectory: string): Promise<Array<RegularFileSnapshot & {
   path: string;
 }>>;
-declare function isMissingFile(error: unknown): boolean;
-declare function isKernelAnchoredPath(path: string): boolean;
+export declare function isMissingFile(error: unknown): boolean;
+export declare function isKernelAnchoredPath(path: string): boolean;
 /**
  * The path from `root` down to `candidate`, or undefined when `candidate` is not
  * strictly inside `root`.
@@ -2550,7 +2548,7 @@ declare function isKernelAnchoredPath(path: string): boolean;
  * and a caller that treats it as a descendant would hand its own root to
  * machinery that may remove the directory it is given.
  */
-declare function relativeWithinRoot(root: string, candidate: string): string | undefined;
+export declare function relativeWithinRoot(root: string, candidate: string): string | undefined;
 /**
  * The path from `root` down to `candidate`, with both sides canonicalized before
  * they are compared.
@@ -2570,7 +2568,7 @@ declare function relativeWithinRoot(root: string, candidate: string): string | u
  * canonicalized and the remaining segments are appended, so a directory that is
  * about to be created is measured against the same root as one that already is.
  */
-declare function canonicalRelativeWithinRoot(root: string, candidate: string): Promise<string | undefined>;
+export declare function canonicalRelativeWithinRoot(root: string, candidate: string): Promise<string | undefined>;
 /**
  * Whether two paths name the same location, with both sides canonicalized first.
  *
@@ -2579,15 +2577,15 @@ declare function canonicalRelativeWithinRoot(root: string, candidate: string): P
  * spellings. Comparing the resolved strings reports a mismatch that does not
  * exist.
  */
-declare function canonicalPathsEqual(left: string, right: string): Promise<boolean>;
+export declare function canonicalPathsEqual(left: string, right: string): Promise<boolean>;
 //#endregion
 //#region src/events.d.ts
-interface KnowledgeEventQuery {
+export interface KnowledgeEventQuery {
   type?: KnowledgeEventType;
   target?: string;
   limit?: number;
 }
-declare function createKnowledgeEvent(input: {
+export declare function createKnowledgeEvent(input: {
   type: KnowledgeEventType;
   actor?: string;
   target?: string;
@@ -2596,7 +2594,7 @@ declare function createKnowledgeEvent(input: {
 }): KnowledgeEvent;
 //#endregion
 //#region src/filesystem-search-provider.d.ts
-interface FileSystemSearchProviderOptions extends KnowledgePagesOptions {
+export 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. */
@@ -2609,7 +2607,7 @@ interface FileSystemSearchProviderOptions extends KnowledgePagesOptions {
    */
   refresh?: 'manual' | 'always';
 }
-interface FileSystemSearchOptions {
+export interface FileSystemSearchOptions {
   limit?: number;
   refresh?: boolean;
 }
@@ -2619,7 +2617,7 @@ interface FileSystemSearchOptions {
  * This is the simple backend for products that want deterministic search over
  * markdown knowledge files before adding embeddings, rerankers, or a vector DB.
  */
-declare class FileSystemSearchProvider {
+export declare class FileSystemSearchProvider {
   readonly root: string;
   /** Root-relative directory the provider indexes. */
   readonly pagesDirectory: string;
@@ -2634,7 +2632,7 @@ declare class FileSystemSearchProvider {
   asRetrievalEvalRetriever(): RetrievalEvalRetriever;
   invalidate(): void;
 }
-declare function createFileSystemSearchProvider(options: FileSystemSearchProviderOptions): FileSystemSearchProvider;
+export declare function createFileSystemSearchProvider(options: FileSystemSearchProviderOptions): FileSystemSearchProvider;
 //#endregion
 //#region src/freshness.d.ts
 /**
@@ -2666,24 +2664,24 @@ declare function createFileSystemSearchProvider(options: FileSystemSearchProvide
  *     PostgreSQL, SQLite, or another application-owned store.
  */
 /** Identity for one freshness record. */
-interface FreshnessKey {
+export interface FreshnessKey {
   workspaceId: string;
   sourceId: string;
 }
 /** TTL bound for staleness checks. */
-interface FreshnessTtl extends FreshnessKey {
+export interface FreshnessTtl extends FreshnessKey {
   /** Milliseconds; the record is stale when `Date.now() - last() > ttlMs`. */
   ttlMs: number;
   /** Injected clock for deterministic tests; defaults to system time. */
   now?: Date;
 }
 /** Mark argument. */
-interface FreshnessMark extends FreshnessKey {
+export interface FreshnessMark extends FreshnessKey {
   when: Date;
   /** Optional content hash captured at refresh time; aids debugging. */
   contentHash?: string;
 }
-interface KnowledgeFreshnessStore {
+export interface KnowledgeFreshnessStore {
   /** Last refresh time, or null if never refreshed. */
   last(key: FreshnessKey): Promise<Date | null>;
   /** Record a successful refresh. */
@@ -2693,13 +2691,13 @@ interface KnowledgeFreshnessStore {
   /** All records for a workspace. */
   list(workspaceId: string): Promise<FreshnessRecord[]>;
 }
-interface FreshnessRecord {
+export interface FreshnessRecord {
   workspaceId: string;
   sourceId: string;
   lastRefreshedAt: string;
   contentHash?: string;
 }
-interface FileSystemFreshnessStoreOptions {
+export interface FileSystemFreshnessStoreOptions {
   /**
    * Knowledge root. The store writes to `<root>/.agent-knowledge/freshness.json`,
    * mirroring the convention used by `sources.json`.
@@ -2714,7 +2712,7 @@ interface FileSystemFreshnessStoreOptions {
  * Writes share the package-wide filesystem lock, so multiple workers cannot
  * overwrite one another or run through an interrupted knowledge promotion.
  */
-declare function createFileSystemFreshnessStore(options: FileSystemFreshnessStoreOptions): KnowledgeFreshnessStore;
+export declare function createFileSystemFreshnessStore(options: FileSystemFreshnessStoreOptions): KnowledgeFreshnessStore;
 /**
  * Bridge an application-owned database adapter to `KnowledgeFreshnessStore`.
  * The adapter may use D1, PostgreSQL, SQLite, or another durable store.
@@ -2731,25 +2729,25 @@ declare function createFileSystemFreshnessStore(options: FileSystemFreshnessStor
  * );
  * ```
  */
-interface D1Adapter {
+export interface D1Adapter {
   get(workspaceId: string, sourceId: string): Promise<FreshnessRecord | null>;
   upsert(record: FreshnessRecord): Promise<void>;
   listByWorkspace(workspaceId: string): Promise<FreshnessRecord[]>;
 }
-declare function createD1FreshnessStoreStub(adapter: D1Adapter): KnowledgeFreshnessStore;
+export declare function createD1FreshnessStoreStub(adapter: D1Adapter): KnowledgeFreshnessStore;
 //#endregion
 //#region src/frontmatter.d.ts
-interface ParsedFrontmatter {
+export interface ParsedFrontmatter {
   frontmatter: Record<string, unknown>;
   body: string;
 }
-declare function parseFrontmatter(content: string): ParsedFrontmatter;
-declare function formatFrontmatter(frontmatter: Record<string, unknown>, body: string): string;
+export declare function parseFrontmatter(content: string): ParsedFrontmatter;
+export declare function formatFrontmatter(frontmatter: Record<string, unknown>, body: string): string;
 //#endregion
 //#region src/graph.d.ts
-type KnowledgePageRelationPredicate = 'wikilink' | 'citation' | 'shared-source' | 'contradicts';
+export type KnowledgePageRelationPredicate = 'wikilink' | 'citation' | 'shared-source' | 'contradicts';
 /** One labeled relation between two pages; `weight` counts the occurrences that produced it. */
-interface KnowledgePageRelation extends KnowledgeRelation {
+export interface KnowledgePageRelation extends KnowledgeRelation {
   predicate: KnowledgePageRelationPredicate;
   weight: number;
 }
@@ -2764,24 +2762,24 @@ interface KnowledgePageRelation extends KnowledgeRelation {
  * 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[];
+export 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;
+export declare function buildKnowledgeGraph(pages: KnowledgePage[]): KnowledgeGraph;
 //#endregion
 //#region src/ids.d.ts
-declare function sha256(text: string): string;
-declare function slugify(input: string): string;
-declare function stableId(prefix: string, content: string): string;
+export declare function sha256(text: string): string;
+export declare function slugify(input: string): string;
+export declare function stableId(prefix: string, content: string): string;
 /** Canonical registry id for exact text submitted at one original URI. */
-declare function textSourceId(uri: string, contentHash: string): string;
+export declare function textSourceId(uri: string, contentHash: string): string;
 //#endregion
 //#region src/indexer.d.ts
-declare function buildKnowledgeIndex(root: string, options?: KnowledgePagesOptions): Promise<KnowledgeIndex>;
+export declare function buildKnowledgeIndex(root: string, options?: KnowledgePagesOptions): Promise<KnowledgeIndex>;
 /**
  * Build the index from the knowledge tree and store it.
  *
@@ -2791,10 +2789,10 @@ declare function buildKnowledgeIndex(root: string, options?: KnowledgePagesOptio
  * 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, options?: KnowledgePagesOptions): Promise<KnowledgeIndex>;
+export declare function writeKnowledgeIndex(root: string, options?: KnowledgePagesOptions): Promise<KnowledgeIndex>;
 //#endregion
 //#region src/inspect.d.ts
-interface KnowledgeInspection {
+export interface KnowledgeInspection {
   pageCount: number;
   sourceCount: number;
   expiredSourceCount: number;
@@ -2811,7 +2809,7 @@ interface KnowledgeInspection {
   sourceFreshness: SourceFreshnessInspection[];
   findings: KnowledgeLintFinding[];
 }
-interface SourceFreshnessInspection {
+export interface SourceFreshnessInspection {
   id: string;
   title?: string;
   uri: string;
@@ -2819,10 +2817,10 @@ interface SourceFreshnessInspection {
   validUntil?: string;
   lastVerifiedAt?: string;
 }
-declare function inspectKnowledgeIndex(index: KnowledgeIndex, options?: {
+export declare function inspectKnowledgeIndex(index: KnowledgeIndex, options?: {
   now?: Date;
 }): KnowledgeInspection;
-interface KnowledgeExplanation {
+export interface KnowledgeExplanation {
   target: string;
   page?: KnowledgePage;
   sources: Array<{
@@ -2838,19 +2836,19 @@ interface KnowledgeExplanation {
     score: number;
   }>;
 }
-declare function explainKnowledgeTarget(index: KnowledgeIndex, target: string): KnowledgeExplanation;
+export 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 {
+export declare const CITES_INVALIDATED_FIELD = "citesInvalidated";
+export 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 {
+export 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. */
@@ -2864,7 +2862,7 @@ interface KnowledgeInvalidationPlan {
  * 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;
+export declare function planInvalidationPropagation(visiblePages: readonly OriginatedPage[]): KnowledgeInvalidationPlan;
 /**
  * Render one plan as a write-block proposal for `applyKnowledgeWriteBlocks`.
  *
@@ -2872,7 +2870,7 @@ declare function planInvalidationPropagation(visiblePages: readonly OriginatedPa
  * `formatFrontmatter`, so its frontmatter is written in that writer's
  * normalized form.
  */
-declare function formatKnowledgeInvalidationProposal(plan: KnowledgeInvalidationPlan): string;
+export declare function formatKnowledgeInvalidationProposal(plan: KnowledgeInvalidationPlan): string;
 //#endregion
 //#region src/investment-thesis-set.d.ts
 /**
@@ -2923,16 +2921,16 @@ declare function formatKnowledgeInvalidationProposal(plan: KnowledgeInvalidation
  * numbers / names.
  */
 /** A required answer component: satisfied when any synonym fragment is present. */
-interface ExpectedGroup {
+export interface ExpectedGroup {
   /** Human label for the component (for the doc / audit). */
   label: string;
   /** Case-insensitive substring fragments; any one present satisfies the group. */
   anyOf: string[];
 }
 /** Lens the fact belongs to — so a set can be checked for category coverage. */
-type MaterialFactLens = 'concentration' | 'leverage' | 'margin-trend' | 'liquidity' | 'capital-return' | 'governance' | 'off-balance-sheet' | 'regulatory';
+export type MaterialFactLens = 'concentration' | 'leverage' | 'margin-trend' | 'liquidity' | 'capital-return' | 'governance' | 'off-balance-sheet' | 'regulatory';
 /** One held-out material fact with a checkable expected answer + its provenance. */
-interface MaterialFact {
+export interface MaterialFact {
   /** Stable id, `ticker/fN`. */
   id: string;
   /** Which analyst lens this fact exercises. For coverage + the doc. */
@@ -2967,7 +2965,7 @@ interface MaterialFact {
   evidence: string;
 }
 /** A company + the cutoff a loop researches as-of + its held-out material facts. */
-interface CompanyEvalCase {
+export interface CompanyEvalCase {
   /** Ticker as of the cutoff. */
   ticker: string;
   /** Legal name as of the cutoff (what the loop is told to research). */
@@ -3003,33 +3001,33 @@ interface CompanyEvalCase {
  * drivers and with survivors. This set is honest about that and reports the lens
  * distribution so the bias is measurable, not hidden.
  */
-declare const investmentThesisSet: CompanyEvalCase[];
+export declare const investmentThesisSet: CompanyEvalCase[];
 /**
  * Grade ONE material fact against an investment thesis's full text. Returns
  * whether the thesis SURFACED it plus which expected groups were found. The
  * check is a deterministic case-insensitive substring scan — $0, model-free,
  * reproducible — so the eval never leaks into a model the loop could observe.
  */
-declare function gradeFactAgainstText(fact: MaterialFact, thesisText: string): {
+export declare function gradeFactAgainstText(fact: MaterialFact, thesisText: string): {
   surfaced: boolean;
   groupsFound: number;
   groupsTotal: number;
   foundLabels: string[];
 };
 /** Grade a whole company's thesis text: how many of its held-out facts it surfaces. */
-declare function gradeCompanyAgainstText(company: CompanyEvalCase, thesisText: string): {
+export declare function gradeCompanyAgainstText(company: CompanyEvalCase, thesisText: string): {
   surfaced: number;
   total: number;
   perFact: ReturnType<typeof gradeFactAgainstText>[];
 };
 /** Total held-out facts across the set (the denominator the doc reports). */
-declare function totalMaterialFacts(set?: CompanyEvalCase[]): number;
+export declare function totalMaterialFacts(set?: CompanyEvalCase[]): number;
 /** Count facts per lens across the set — used to report (and bound) curation bias. */
-declare function lensDistribution(set?: CompanyEvalCase[]): Record<MaterialFactLens, number>;
+export declare function lensDistribution(set?: CompanyEvalCase[]): Record<MaterialFactLens, number>;
 //#endregion
 //#region src/investment-thesis-task.d.ts
 /** The minimal brief a thesis run is given — the firewall boundary. */
-interface ThesisTaskInput {
+export interface ThesisTaskInput {
   /** Legal name as of the cutoff — what the loop researches. */
   company: string;
   /** Ticker as of the cutoff. */
@@ -3053,8 +3051,8 @@ interface ThesisTaskInput {
  * fetch and the loop runs multiple rounds — the depth-driving driver needs >1
  * round to steer, exactly as the ML-exam multi-round probe established.
  */
-declare function thesisReadinessSpecs(input: ThesisTaskInput): KnowledgeReadinessSpec[];
-interface ThesisRunOptions {
+export declare function thesisReadinessSpecs(input: ThesisTaskInput): KnowledgeReadinessSpec[];
+export interface ThesisRunOptions {
   /** The KB root the loop writes into. */
   root: string;
   /** Shared router client (web search + chat). Defaults to env creds. */
@@ -3069,7 +3067,7 @@ interface ThesisRunOptions {
   synthesisMaxTokens?: number;
   signal?: AbortSignal;
 }
-interface ThesisRunResult {
+export interface ThesisRunResult {
   loop: VerifiedResearchLoopResult;
   /** The synthesized thesis text. */
   thesis: string;
@@ -3082,7 +3080,7 @@ interface ThesisRunResult {
  * + the thesis text + the page path. The caller grades the KB with
  * `materialFactsSurfaced(root, checklist)` — the checklist is never passed here.
  */
-declare function runInvestmentThesisTask(input: ThesisTaskInput, options: ThesisRunOptions): Promise<ThesisRunResult>;
+export declare function runInvestmentThesisTask(input: ThesisTaskInput, options: ThesisRunOptions): Promise<ThesisRunResult>;
 //#endregion
 //#region src/kb-store.d.ts
 /**
@@ -3096,18 +3094,18 @@ declare function runInvestmentThesisTask(input: ThesisTaskInput, options: Thesis
  * `FileSystemKbStore`, anchored on the knowledge-base root, which is also the
  * directory `withKnowledgeMutation` locks: one file, one lock domain.
  */
-declare const KB_STORE_DIR = ".agent-knowledge";
-declare const KB_INDEX_PATH = ".agent-knowledge/index.json";
-declare const KB_EVENTS_PATH = ".agent-knowledge/events.json";
-declare const KB_CLAIM_LEDGER_DIR = ".agent-knowledge/claim-ledgers";
-declare function assertClaimLedgerId(id: string): string;
+export declare const KB_STORE_DIR = ".agent-knowledge";
+export declare const KB_INDEX_PATH = ".agent-knowledge/index.json";
+export declare const KB_EVENTS_PATH = ".agent-knowledge/events.json";
+export declare const KB_CLAIM_LEDGER_DIR = ".agent-knowledge/claim-ledgers";
+export declare function assertClaimLedgerId(id: string): string;
 /** A URI-only ledger cannot be upgraded without re-verifying its source bytes. */
-declare class ClaimLedgerMigrationRequiredError extends Error {
+export declare class ClaimLedgerMigrationRequiredError extends Error {
   readonly ledgerId: string;
   readonly foundSchemaVersion: number | 'unversioned';
   constructor(ledgerId: string, foundSchemaVersion: number | 'unversioned');
 }
-interface KbStore {
+export interface KbStore {
   putSource(source: SourceRecord): Promise<void>;
   getSource(id: string): Promise<SourceRecord | null>;
   listSources(): Promise<SourceRecord[]>;
@@ -3120,7 +3118,7 @@ interface KbStore {
   listEvents(query?: KnowledgeEventQuery): Promise<KnowledgeEvent[]>;
 }
 /** Optional durable capability for stores that retain per-run research belief. */
-interface ClaimLedgerStore {
+export interface ClaimLedgerStore {
   /**
    * Persist one research run's claim ledger — the corroboration counts,
    * contradiction edges, and open deep questions that make up its belief state.
@@ -3146,7 +3144,7 @@ interface ClaimLedgerStore {
    */
   mergeClaimLedger(id: string, merge: (current: ResearchClaimLedger | null) => ResearchClaimLedger): Promise<ResearchClaimLedger>;
 }
-declare class MemoryKbStore implements KbStore, ClaimLedgerStore {
+export declare class MemoryKbStore implements KbStore, ClaimLedgerStore {
   private readonly sources;
   private readonly pages;
   private readonly events;
@@ -3175,11 +3173,11 @@ declare class MemoryKbStore implements KbStore, ClaimLedgerStore {
  * `writeKnowledgeIndex`. The string constructor preserves the published direct
  * record-directory layout (`<directory>/index.json`).
  */
-interface FileSystemKbStoreOptions {
+export interface FileSystemKbStoreOptions {
   /** Knowledge-base root; records are stored under `<root>/.agent-knowledge/`. */
   root: string;
 }
-declare class FileSystemKbStore implements KbStore, ClaimLedgerStore {
+export declare class FileSystemKbStore implements KbStore, ClaimLedgerStore {
   private readonly root;
   private readonly indexPath;
   private readonly eventsPath;
@@ -3212,29 +3210,29 @@ declare class FileSystemKbStore implements KbStore, ClaimLedgerStore {
 }
 //#endregion
 //#region src/knowledge-visibility.d.ts
-declare const KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION: '2.0.0';
-declare const KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM: 'rfc8785-sha256';
+export declare const KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION: '2.0.0';
+export declare const KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM: 'rfc8785-sha256';
 /** Stable content identity for one exact knowledge page. */
-declare function knowledgePageDigest(page: KnowledgePage): Sha256Digest;
+export declare function knowledgePageDigest(page: KnowledgePage): Sha256Digest;
 /** Snapshot the exact ordered current/ancestor/shared page view. */
-declare function createKnowledgeVisibilitySnapshot(visiblePages: readonly OriginatedPage[]): KnowledgeVisibilitySnapshot;
+export declare function createKnowledgeVisibilitySnapshot(visiblePages: readonly OriginatedPage[]): KnowledgeVisibilitySnapshot;
 /**
  * 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;
+export declare function verifyKnowledgeVisibilitySnapshot(snapshot: KnowledgeVisibilitySnapshot): KnowledgeVisibilitySnapshot;
 /** Canonical bytes of a verified snapshot, for durable storage. */
-declare function encodeKnowledgeVisibilitySnapshot(snapshot: KnowledgeVisibilitySnapshot): Uint8Array;
+export declare function encodeKnowledgeVisibilitySnapshot(snapshot: KnowledgeVisibilitySnapshot): Uint8Array;
 /** Parse stored snapshot bytes and verify their schema and digest. */
-declare function decodeKnowledgeVisibilitySnapshot(bytes: Uint8Array): KnowledgeVisibilitySnapshot;
+export declare function decodeKnowledgeVisibilitySnapshot(bytes: Uint8Array): KnowledgeVisibilitySnapshot;
 /** Locator for snapshot bytes stored at `uri`. */
-declare function knowledgeVisibilityArtifactRef(input: {
+export declare function knowledgeVisibilityArtifactRef(input: {
   uri: string;
   bytes: Uint8Array;
 }): KnowledgeVisibilityArtifactRef;
 //#endregion
 //#region src/knowledge-use-receipts.d.ts
-interface KnowledgeVisibilitySnapshotEntry {
+export interface KnowledgeVisibilitySnapshotEntry {
   readonly position: number;
   readonly pageId: string;
   readonly origin: PageOrigin;
@@ -3244,14 +3242,14 @@ interface KnowledgeVisibilitySnapshotEntry {
   readonly invalidated: boolean;
 }
 /** Exact ordered page visibility presented to one retrieval operation. */
-interface KnowledgeVisibilitySnapshot {
+export interface KnowledgeVisibilitySnapshot {
   readonly schemaVersion: typeof KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION;
   readonly digestAlgorithm: typeof KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM;
   readonly snapshotDigest: Sha256Digest;
   readonly entries: readonly KnowledgeVisibilitySnapshotEntry[];
 }
 /** Content-addressed locator of the stored bytes of one visibility snapshot. */
-interface KnowledgeVisibilityArtifactRef {
+export interface KnowledgeVisibilityArtifactRef {
   readonly uri: string;
   /** Digest of the stored bytes, as `knowledgeVisibilityArtifactRef` computes it. */
   readonly digest: Sha256Digest;
@@ -3262,12 +3260,12 @@ interface KnowledgeVisibilityArtifactRef {
  * the artifact the reference names, or in another durable record the caller
  * keeps; the receipt carries only this reference.
  */
-interface KnowledgeVisibilityRef {
+export interface KnowledgeVisibilityRef {
   readonly snapshotDigest: Sha256Digest;
   readonly pageCount: number;
   readonly artifact?: KnowledgeVisibilityArtifactRef;
 }
-interface KnowledgeRetrieverIdentity {
+export interface KnowledgeRetrieverIdentity {
   /** Stable implementation name, for example `token-overlap-v1`. */
   readonly id: string;
   /** Published or application-defined implementation version. */
@@ -3275,10 +3273,10 @@ interface KnowledgeRetrieverIdentity {
   /** Exact identity of every retrieval setting not represented elsewhere. */
   readonly configDigest: Sha256Digest;
 }
-interface OriginatedKnowledgeSearchResult extends KnowledgeSearchResult {
+export interface OriginatedKnowledgeSearchResult extends KnowledgeSearchResult {
   readonly origin: PageOrigin;
 }
-interface KnowledgeRetrievalResultReceipt {
+export interface KnowledgeRetrievalResultReceipt {
   readonly rank: number;
   readonly pageId: string;
   readonly origin: PageOrigin;
@@ -3289,12 +3287,12 @@ interface KnowledgeRetrievalResultReceipt {
   readonly snippet: string;
   readonly reasons: readonly string[];
 }
-type KnowledgeReceiptAttributeValue = string | number | boolean | null;
+export 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 {
+export interface KnowledgeRetrievalReceipt {
   readonly schemaVersion: typeof KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION;
   readonly kind: 'knowledge-retrieval';
   readonly digestAlgorithm: typeof KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM;
@@ -3311,7 +3309,7 @@ interface KnowledgeRetrievalReceipt {
   readonly evidenceRefs: readonly EvidenceRef[];
   readonly attributes: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
 }
-interface CreateKnowledgeRetrievalReceiptInput {
+export interface CreateKnowledgeRetrievalReceiptInput {
   readonly runId: string;
   readonly actorId?: string;
   readonly profileDigest?: Sha256Digest;
@@ -3336,14 +3334,14 @@ interface CreateKnowledgeRetrievalReceiptInput {
  * 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';
+export type KnowledgeVisibilityArtifactLoader = (artifact: KnowledgeVisibilityArtifactRef) => Promise<Uint8Array | undefined> | Uint8Array | undefined;
+export 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 {
+export declare class KnowledgeVisibilityUnavailableError extends Error {
   readonly reason: KnowledgeVisibilityUnavailableReason;
   readonly snapshotDigest: Sha256Digest;
   readonly uri?: string;
@@ -3354,14 +3352,14 @@ declare class KnowledgeVisibilityUnavailableError extends Error {
     cause?: unknown;
   });
 }
-type KnowledgeUseRelation = 'supports' | 'contradicts' | 'extends' | 'rederives' | 'background';
-type KnowledgeConsumerKind = 'decision' | 'artifact' | 'experiment' | 'candidate' | 'message' | 'other';
-interface KnowledgeConsumerRef {
+export type KnowledgeUseRelation = 'supports' | 'contradicts' | 'extends' | 'rederives' | 'background';
+export type KnowledgeConsumerKind = 'decision' | 'artifact' | 'experiment' | 'candidate' | 'message' | 'other';
+export interface KnowledgeConsumerRef {
   readonly kind: KnowledgeConsumerKind;
   readonly uri: string;
   readonly digest?: Sha256Digest;
 }
-interface KnowledgeUsedResult {
+export interface KnowledgeUsedResult {
   readonly rank: number;
   readonly pageId: string;
   readonly origin: PageOrigin;
@@ -3372,7 +3370,7 @@ interface KnowledgeUsedResult {
  * Immutable proof that one retrieved page was selected for a downstream
  * decision, artifact, experiment, candidate, or message.
  */
-interface KnowledgeUseReceipt {
+export interface KnowledgeUseReceipt {
   readonly schemaVersion: typeof KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION;
   readonly kind: 'knowledge-use';
   readonly digestAlgorithm: typeof KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM;
@@ -3389,7 +3387,7 @@ interface KnowledgeUseReceipt {
   readonly evidenceRefs: readonly EvidenceRef[];
   readonly attributes: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
 }
-interface CreateKnowledgeUseReceiptInput {
+export interface CreateKnowledgeUseReceiptInput {
   readonly retrieval: KnowledgeRetrievalReceipt;
   /** Exact one-based rank from the retrieval receipt. */
   readonly selectedRank: number;
@@ -3405,7 +3403,7 @@ interface CreateKnowledgeUseReceiptInput {
  * `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';
+export type KnowledgeRetrievalDispositionRelation = 'irrelevant' | 'no-use';
 /**
  * Immutable proof that one retrieval led to no use.
  *
@@ -3413,7 +3411,7 @@ type KnowledgeRetrievalDispositionRelation = 'irrelevant' | 'no-use';
  * 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 {
+export interface KnowledgeRetrievalDisposition {
   readonly schemaVersion: typeof KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION;
   readonly kind: 'knowledge-retrieval-disposition';
   readonly digestAlgorithm: typeof KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM;
@@ -3429,7 +3427,7 @@ interface KnowledgeRetrievalDisposition {
   readonly evidenceRefs: readonly EvidenceRef[];
   readonly attributes: Readonly<Record<string, KnowledgeReceiptAttributeValue>>;
 }
-interface CreateKnowledgeRetrievalDispositionInput {
+export interface CreateKnowledgeRetrievalDispositionInput {
   readonly retrieval: KnowledgeRetrievalReceipt;
   readonly relation: KnowledgeRetrievalDispositionRelation;
   readonly consumer: KnowledgeConsumerRef;
@@ -3442,7 +3440,7 @@ interface CreateKnowledgeRetrievalDispositionInput {
  * 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;
+export declare function createKnowledgeRetrievalReceipt(input: CreateKnowledgeRetrievalReceiptInput): KnowledgeRetrievalReceipt;
 /**
  * Verify the receipt's schema, canonical digest, rank continuity, finite
  * scores, and well-formed visibility reference. This proves what the receipt
@@ -3450,28 +3448,28 @@ declare function createKnowledgeRetrievalReceipt(input: CreateKnowledgeRetrieval
  * Use `assertKnowledgeRetrievalMatchesVisibility` or
  * `assertKnowledgeRetrievalMatchesVisibilityArtifact` for that join.
  */
-declare function verifyKnowledgeRetrievalReceipt(receipt: KnowledgeRetrievalReceipt): KnowledgeRetrievalReceipt;
+export declare function verifyKnowledgeRetrievalReceipt(receipt: KnowledgeRetrievalReceipt): KnowledgeRetrievalReceipt;
 /**
  * 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;
+export 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>;
+export 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;
+export 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;
+export 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;
+export declare function createKnowledgeRetrievalDisposition(input: CreateKnowledgeRetrievalDispositionInput): KnowledgeRetrievalDisposition;
 /** Verify one disposition against the exact retrieval that authorized it. */
-declare function verifyKnowledgeRetrievalDisposition(disposition: KnowledgeRetrievalDisposition, retrieval: KnowledgeRetrievalReceipt): KnowledgeRetrievalDisposition;
+export declare function verifyKnowledgeRetrievalDisposition(disposition: KnowledgeRetrievalDisposition, retrieval: KnowledgeRetrievalReceipt): KnowledgeRetrievalDisposition;
 //#endregion
 //#region src/lexical-index.d.ts
 /**
@@ -3481,10 +3479,10 @@ declare function verifyKnowledgeRetrievalDisposition(disposition: KnowledgeRetri
  * frequency can be counted. Indexing and querying share this function, so the
  * two vocabularies cannot drift.
  */
-declare function tokenizeText(text: string): string[];
+export declare function tokenizeText(text: string): string[];
 /** The distinct query terms, in first-occurrence order. */
-declare function tokenizeQuery(query: string): string[];
-interface KnowledgeLexicalFieldBoosts {
+export declare function tokenizeQuery(query: string): string[];
+export 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. */
@@ -3492,12 +3490,12 @@ interface KnowledgeLexicalFieldBoosts {
   /** Multiplier for a term occurrence in the page body. Defaults to 1. */
   text?: number;
 }
-interface KnowledgeLexicalIndexOptions {
+export interface KnowledgeLexicalIndexOptions {
   /** Token stream of one text. Defaults to `tokenizeText`. */
   tokenize?: (text: string) => string[];
   fieldBoosts?: KnowledgeLexicalFieldBoosts;
 }
-interface KnowledgeLexicalPosting {
+export interface KnowledgeLexicalPosting {
   /** Position of the page in `KnowledgeLexicalIndex.pages`. */
   ordinal: number;
   /** Field-boosted term frequency in that page. */
@@ -3509,7 +3507,7 @@ interface KnowledgeLexicalPosting {
  * Ordinals are positions in `pages`. `documentLengths` are field-boosted token
  * counts, so length normalization and term frequency use one scale.
  */
-interface KnowledgeLexicalIndex {
+export interface KnowledgeLexicalIndex {
   readonly pages: readonly KnowledgePage[];
   readonly postings: ReadonlyMap<string, readonly KnowledgeLexicalPosting[]>;
   readonly documentLengths: readonly number[];
@@ -3518,24 +3516,24 @@ interface KnowledgeLexicalIndex {
   readonly tokenize: (text: string) => string[];
   readonly fieldBoosts: Readonly<Required<KnowledgeLexicalFieldBoosts>>;
 }
-interface Bm25Options {
+export 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 {
+export interface Bm25Hit {
   page: KnowledgePage;
   score: number;
 }
-declare function buildKnowledgeLexicalIndex(pages: readonly KnowledgePage[], options?: KnowledgeLexicalIndexOptions): KnowledgeLexicalIndex;
+export 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[];
+export declare function scoreBm25(index: KnowledgeLexicalIndex, tokens: readonly string[], options?: Bm25Options): Bm25Hit[];
 //#endregion
 //#region src/search.d.ts
 /**
@@ -3544,8 +3542,8 @@ declare function scoreBm25(index: KnowledgeLexicalIndex, tokens: readonly string
  * 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 {
+export declare const KNOWLEDGE_SEARCH_RETRIEVER_ID = "bm25-rrf-v1";
+export interface SearchKnowledgeOptions {
   /** Maximum results returned. Defaults to 10. */
   limit?: number;
   /** Match pages whose stable id is one of these values. */
@@ -3576,24 +3574,24 @@ interface SearchKnowledgeOptions {
  * through the citation resolver. Later writes should persist the returned value. 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 {
+export 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[];
+export declare function searchKnowledge(index: KnowledgeIndex, query: string, limit?: number): KnowledgeSearchHit[];
+export 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>;
+export declare function searchKnowledgePages(pages: readonly KnowledgePage[], query: string, limitOrOptions?: number | SearchKnowledgeOptions): KnowledgeSearchHit[];
+export 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 {
+export declare const DEFAULT_KNOWLEDGE_BRIEF_LIMIT = 5;
+export interface KnowledgeBriefOptions {
   /** Maximum pages in the brief. Defaults to 5. */
   limit?: number;
   /**
@@ -3614,7 +3612,7 @@ interface KnowledgeBriefOptions {
    */
   maxChars?: number;
 }
-interface KnowledgeBrief {
+export interface KnowledgeBrief {
   readonly question: string;
   /** Retriever id to declare in a receipt minted from `results`. */
   readonly retrieverId: typeof KNOWLEDGE_SEARCH_RETRIEVER_ID;
@@ -3638,10 +3636,10 @@ interface KnowledgeBrief {
  * 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;
+export declare function buildKnowledgeBrief(visiblePages: readonly OriginatedPage[], question: string, options?: KnowledgeBriefOptions): KnowledgeBrief;
 //#endregion
 //#region src/knowledge-tools.d.ts
-interface CreateKnowledgeToolsOptions {
+export interface CreateKnowledgeToolsOptions {
   readonly stores: RunScopedStores;
   /** The run whose store is written and whose chain is read. */
   readonly runId: string;
@@ -3667,14 +3665,14 @@ interface CreateKnowledgeToolsOptions {
  * The four tools an agent needs to use a knowledge store: search, read, record,
  * resolve.
  */
-declare function createKnowledgeTools(options: CreateKnowledgeToolsOptions): ToolDefinition[];
+export declare function createKnowledgeTools(options: CreateKnowledgeToolsOptions): ToolDefinition[];
 //#endregion
 //#region src/lint.d.ts
-declare function lintKnowledgeIndex(index: KnowledgeIndex): KnowledgeLintFinding[];
+export declare function lintKnowledgeIndex(index: KnowledgeIndex): KnowledgeLintFinding[];
 //#endregion
 //#region src/material-facts-metric.d.ts
 /** Per-fact grade plus the fact's id/lens, for the audit trail. */
-interface FactResult {
+export interface FactResult {
   id: string;
   lens: CompanyEvalCase['facts'][number]['lens'];
   surfaced: boolean;
@@ -3683,7 +3681,7 @@ interface FactResult {
   foundLabels: string[];
 }
 /** The metric's result for one company: the surfaced fraction + the per-fact trail. */
-interface MaterialFactsResult {
+export interface MaterialFactsResult {
   ticker: string;
   company: string;
   /** Held-out facts the KB surfaced + grounded. */
@@ -3702,14 +3700,14 @@ interface MaterialFactsResult {
  * in spirit to `kbText` in the research-quality A/B so both metrics read a KB the
  * same way.
  */
-declare function kbIndexToText(index: KnowledgeIndex): string;
+export declare function kbIndexToText(index: KnowledgeIndex): string;
 /**
  * Grade one company's KB against its held-out material-fact checklist, given the
  * KB's already-joined text. The pure core — no I/O — so calibration can score a
  * hand-written shallow/deep thesis string directly and the live path can score a
  * real KB. Returns the surfaced FRACTION plus the per-fact audit trail.
  */
-declare function materialFactsSurfacedInText(company: CompanyEvalCase, kbText: string): MaterialFactsResult;
+export declare function materialFactsSurfacedInText(company: CompanyEvalCase, kbText: string): MaterialFactsResult;
 /**
  * `materialFactsSurfaced(kb, checklist)` — the metric in its KB-reading form.
  *
@@ -3720,7 +3718,7 @@ declare function materialFactsSurfacedInText(company: CompanyEvalCase, kbText: s
  * The checklist is HELD OUT by construction: it lives in the test eval set, is
  * never passed to the loop, and is read only here, after the loop finished.
  */
-declare function materialFactsSurfaced(kb: string | KnowledgeIndex, checklist: CompanyEvalCase): Promise<MaterialFactsResult>;
+export declare function materialFactsSurfaced(kb: string | KnowledgeIndex, checklist: CompanyEvalCase): Promise<MaterialFactsResult>;
 //#endregion
 //#region src/mutation-lock.d.ts
 interface KnowledgeMutationLock {
@@ -3796,8 +3794,8 @@ interface KnowledgeMutationHold {
  * A caller that must decide between taking the lock and joining the one it is inside reads this
  * rather than guessing; taking a held lock from inside its own scope would block against itself.
  */
-declare function isKnowledgeMutationHeld(root: string): boolean;
-declare function withKnowledgeMutation<T>(root: string, mutate: (lock: KnowledgeMutationLock) => Promise<T> | T, options?: KnowledgeMutationOptions): Promise<T>;
+export declare function isKnowledgeMutationHeld(root: string): boolean;
+export declare function withKnowledgeMutation<T>(root: string, mutate: (lock: KnowledgeMutationLock) => Promise<T> | T, options?: KnowledgeMutationOptions): Promise<T>;
 /**
  * Run `body` inside this package's mutation scope for `root`, on a lock the caller already holds.
  *
@@ -3811,23 +3809,23 @@ declare function withKnowledgeMutation<T>(root: string, mutate: (lock: Knowledge
  * lock the caller does not actually hold is the one way to defeat the store's single-writer rule;
  * the hold is required, rather than assumed, so that is a statement the caller has to make.
  */
-declare function runInKnowledgeMutationScope<T>(root: string, hold: KnowledgeMutationHold, body: (lock: KnowledgeMutationLock) => Promise<T> | T, options?: KnowledgeMutationOptions): Promise<T>;
-declare function inspectPendingKnowledgeMutation(root: string): Promise<PendingKnowledgeMutation | null>;
-declare function recoverPendingKnowledgeMutation(root: string, options: RecoverPendingKnowledgeMutationOptions): Promise<void>;
-declare function withKnowledgeRead<T>(root: string, read: () => Promise<T> | T, options?: KnowledgeReadOptions): Promise<T>;
+export declare function runInKnowledgeMutationScope<T>(root: string, hold: KnowledgeMutationHold, body: (lock: KnowledgeMutationLock) => Promise<T> | T, options?: KnowledgeMutationOptions): Promise<T>;
+export declare function inspectPendingKnowledgeMutation(root: string): Promise<PendingKnowledgeMutation | null>;
+export declare function recoverPendingKnowledgeMutation(root: string, options: RecoverPendingKnowledgeMutationOptions): Promise<void>;
+export 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';
+export declare const KNOWLEDGE_PROMOTION_SCHEMA_VERSION: '1.0.0';
+export 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';
+export declare const KNOWLEDGE_PROMOTIONS_DIRECTORY = ".agent-knowledge/promotions";
+export type KnowledgePromotionErrorCode = 'unknown-page' | 'ambiguous-support' | 'id-conflict' | 'path-conflict';
 /** A promotion that cannot be performed exactly as asked. */
-declare class KnowledgePromotionError extends Error {
+export declare class KnowledgePromotionError extends Error {
   readonly code: KnowledgePromotionErrorCode;
   constructor(code: KnowledgePromotionErrorCode, message: string);
 }
-interface KnowledgePromotionEntry {
+export interface KnowledgePromotionEntry {
   readonly pageId: KnowledgeId;
   readonly path: string;
   /** Where the page was read from in the source run's chain. */
@@ -3837,7 +3835,7 @@ interface KnowledgePromotionEntry {
   readonly requested: boolean;
 }
 /** Immutable record of one promotion into a shared store. */
-interface KnowledgePromotionRecord {
+export interface KnowledgePromotionRecord {
   readonly schemaVersion: typeof KNOWLEDGE_PROMOTION_SCHEMA_VERSION;
   readonly kind: 'knowledge-promotion';
   readonly digestAlgorithm: typeof KNOWLEDGE_PROMOTION_DIGEST_ALGORITHM;
@@ -3849,7 +3847,7 @@ interface KnowledgePromotionRecord {
   /** Promoted pages first, then carried support, each group in path order. */
   readonly entries: readonly KnowledgePromotionEntry[];
 }
-interface PromoteRunScopedPagesOptions extends KnowledgePagesOptions {
+export 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. */
@@ -3871,12 +3869,12 @@ interface PromoteRunScopedPagesOptions extends KnowledgePagesOptions {
  * 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>;
+export 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>;
+export declare function loadKnowledgePromotionRecord(sharedRoot: string, recordDigest: Sha256Digest): Promise<KnowledgePromotionRecord | null>;
 //#endregion
 //#region src/propose-from-finding.d.ts
-interface KnowledgeProposal {
+export interface KnowledgeProposal {
   /**
    * Stable id derived from the finding so cross-run diffs share an
    * identity. Re-proposing the same finding produces the same id.
@@ -3907,7 +3905,7 @@ interface KnowledgeProposal {
     analyst_id: string;
   };
 }
-declare class KnowledgeProposalParseError extends Error {
+export declare class KnowledgeProposalParseError extends Error {
   readonly findingId: string;
   readonly subject: string;
   constructor(findingId: string, subject: string, message: string);
@@ -3924,21 +3922,21 @@ declare class KnowledgeProposalParseError extends Error {
  * list and filter out the `null`s; the orchestrator passes the
  * remaining proposals to the existing review / apply pipeline.
  */
-declare function proposeFromFinding(finding: AnalystFinding): KnowledgeProposal | null;
+export declare function proposeFromFinding(finding: AnalystFinding): KnowledgeProposal | null;
 /**
  * Plural convenience: filter + map across an entire findings batch
  * with one call. Parse errors collect into `errors[]`; the loop
  * decides per-error whether to abort or continue.
  */
-interface ProposeFromFindingsResult {
+export interface ProposeFromFindingsResult {
   proposals: KnowledgeProposal[];
   skipped: number;
   errors: KnowledgeProposalParseError[];
 }
-declare function proposeFromFindings(findings: ReadonlyArray<AnalystFinding>): ProposeFromFindingsResult;
+export declare function proposeFromFindings(findings: ReadonlyArray<AnalystFinding>): ProposeFromFindingsResult;
 //#endregion
 //#region src/readiness-check.d.ts
-interface EvaluateKnowledgeBaseReadinessOptions {
+export interface EvaluateKnowledgeBaseReadinessOptions {
   root: string;
   goal: string;
   readinessSpecs?: readonly KnowledgeReadinessSpec[];
@@ -3947,7 +3945,7 @@ interface EvaluateKnowledgeBaseReadinessOptions {
   strict?: ValidateKnowledgeOptions['strict'];
   kbQuality?: KnowledgeBaseQualityOptions;
 }
-interface KnowledgeBaseReadinessEvaluation {
+export interface KnowledgeBaseReadinessEvaluation {
   ready: boolean;
   summary: string;
   index: KnowledgeIndex;
@@ -3960,16 +3958,16 @@ interface KnowledgeBaseReadinessEvaluation {
     blocking_readiness: number;
   };
 }
-declare function evaluateKnowledgeBaseReadiness(options: EvaluateKnowledgeBaseReadinessOptions): Promise<KnowledgeBaseReadinessEvaluation>;
+export 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';
+export 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 {
+export declare class KnowledgeRelationGraphError extends Error {
   readonly code: KnowledgeRelationGraphErrorCode;
   constructor(code: KnowledgeRelationGraphErrorCode, message: string);
 }
-interface BuildKnowledgeRelationGraphInput {
+export interface BuildKnowledgeRelationGraphInput {
   /**
    * Declared node inventory. When present, every relation endpoint must name
    * one declared node; an undeclared endpoint is refused rather than added.
@@ -3982,21 +3980,21 @@ interface BuildKnowledgeRelationGraphInput {
  * `out` follows `sourceId -> targetId`, `in` follows `targetId -> sourceId`,
  * `both` follows a relation from either end.
  */
-type KnowledgeRelationDirection = 'out' | 'in' | 'both';
-interface KnowledgeRelationQuery {
+export type KnowledgeRelationDirection = 'out' | 'in' | 'both';
+export interface KnowledgeRelationQuery {
   /** Restrict to relations with this predicate. Every predicate when absent. */
   predicate?: string;
   direction: KnowledgeRelationDirection;
 }
-interface KnowledgeRelationWalkOptions extends KnowledgeRelationQuery {
+export interface KnowledgeRelationWalkOptions extends KnowledgeRelationQuery {
   /** Most relations between the start node and a reported node. Unbounded when absent. */
   maxDepth?: number;
 }
-interface KnowledgeRelationNeighbor {
+export interface KnowledgeRelationNeighbor {
   nodeId: KnowledgeId;
   relation: KnowledgeRelation;
 }
-interface KnowledgeRelationWalkStep {
+export interface KnowledgeRelationWalkStep {
   nodeId: KnowledgeId;
   /** Number of relations between the start node and this node. */
   depth: number;
@@ -4013,22 +4011,22 @@ interface KnowledgeRelationWalkStep {
  * Node and relation metadata must be finite, acyclic JSON so the graph
  * round-trips through `KnowledgeRelationGraphSchema` unchanged.
  */
-declare function buildKnowledgeRelationGraph(input: BuildKnowledgeRelationGraphInput): KnowledgeRelationGraph;
+export 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[];
+export 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[];
+export 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;
+export declare function isReachable(graph: KnowledgeRelationGraph, from: KnowledgeId, to: KnowledgeId, query: KnowledgeRelationQuery): boolean;
 //#endregion
 //#region src/release.d.ts
-interface KnowledgeReleaseReport {
+export interface KnowledgeReleaseReport {
   release: KnowledgeRelease;
   scorecard: ReleaseConfidenceScorecard;
   candidateRuns: RunRecord[];
@@ -4038,7 +4036,7 @@ interface KnowledgeReleaseReport {
  * Build a knowledge release report from candidate and baseline run records,
  * optional trace evidence, and an optional decision record.
  */
-interface KnowledgeReleaseInput {
+export interface KnowledgeReleaseInput {
   candidateId: string;
   baselineId?: string;
   candidateRuns: RunRecord[];
@@ -4057,11 +4055,11 @@ interface KnowledgeReleaseInput {
   createdAt?: string;
   minScore?: number;
 }
-declare function knowledgeReleaseReport(input: KnowledgeReleaseInput): KnowledgeReleaseReport;
+export declare function knowledgeReleaseReport(input: KnowledgeReleaseInput): KnowledgeReleaseReport;
 //#endregion
 //#region src/research-driving-driver.d.ts
 /** The driver's accumulated research state — the completion oracle reads this. */
-interface ResearchDrivingState {
+export interface ResearchDrivingState {
   /** Every extracted claim backed by a registered source, by id. */
   claims: TrackedClaim[];
   /** Every deep sub-question raised, by id. */
@@ -4077,7 +4075,7 @@ interface ResearchDrivingState {
   /** How many rounds the driver has folded steer for. */
   rounds: number;
 }
-interface ResearchDrivingDriverOptions {
+export interface ResearchDrivingDriverOptions {
   /** Router client for claim extraction + deep-question generation. */
   router?: RouterClient;
   router_options?: TangleRouterOptions;
@@ -4103,7 +4101,7 @@ interface ResearchDrivingDriverOptions {
  * Options for the durable driver: the same driver plus a store to keep its
  * belief state in.
  */
-interface PersistentResearchDrivingDriverOptions extends ResearchDrivingDriverOptions {
+export interface PersistentResearchDrivingDriverOptions extends ResearchDrivingDriverOptions {
   /** Where the claim ledger is read from and written to. */
   store: ClaimLedgerStore;
   /**
@@ -4114,7 +4112,7 @@ interface PersistentResearchDrivingDriverOptions extends ResearchDrivingDriverOp
   ledgerId: string;
 }
 /** What the driver folded into one round's worker prompt, surfaced for audit. */
-interface ResearchDrivingSteer {
+export interface ResearchDrivingSteer {
   round: number;
   deepQuestions: DeepQuestion[];
   /** Claims it demanded corroborating/refuting evidence for this round. */
@@ -4129,7 +4127,7 @@ interface ResearchDrivingSteer {
  * `runVerifiedResearchLoop`) PLUS a completion oracle and live state, mirroring
  * how `createAdaptiveResearchDriver` exposes `stats()`.
  */
-interface ResearchDrivingDriver extends ResearchDriver {
+export interface ResearchDrivingDriver extends ResearchDriver {
   /** Live snapshot of the claim ledger + deep questions. */
   researchState(): ResearchDrivingState;
   /**
@@ -4171,7 +4169,7 @@ interface ResearchDrivingDriver extends ResearchDriver {
  * process does — use `createPersistentResearchDrivingDriver` when the run must
  * survive a crash or resume.
  */
-declare function createResearchDrivingDriver(options?: ResearchDrivingDriverOptions): ResearchDrivingDriver;
+export declare function createResearchDrivingDriver(options?: ResearchDrivingDriverOptions): ResearchDrivingDriver;
 /**
  * The durable driver: same behaviour, plus its claim ledger is read from the
  * store at construction and written back after every claim and every round.
@@ -4181,10 +4179,10 @@ declare function createResearchDrivingDriver(options?: ResearchDrivingDriverOpti
  * loaded lazily would answer "nothing researched, not complete" for a run that
  * had already corroborated everything.
  */
-declare function createPersistentResearchDrivingDriver(options: PersistentResearchDrivingDriverOptions): Promise<ResearchDrivingDriver>;
+export declare function createPersistentResearchDrivingDriver(options: PersistentResearchDrivingDriverOptions): Promise<ResearchDrivingDriver>;
 //#endregion
 //#region src/schemas.d.ts
-declare const SourceAnchorSchema: z.ZodObject<{
+export declare const SourceAnchorSchema: z.ZodObject<{
   id: z.ZodString;
   sourceId: z.ZodString;
   label: z.ZodOptional<z.ZodString>;
@@ -4196,7 +4194,7 @@ declare const SourceAnchorSchema: z.ZodObject<{
   timestampMs: z.ZodOptional<z.ZodNumber>;
   metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
-declare const SourceRecordSchema: z.ZodObject<{
+export declare const SourceRecordSchema: z.ZodObject<{
   id: z.ZodString;
   uri: z.ZodString;
   title: z.ZodOptional<z.ZodString>;
@@ -4220,7 +4218,7 @@ declare const SourceRecordSchema: z.ZodObject<{
   metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   createdAt: z.ZodString;
 }, z.core.$strip>;
-declare const KnowledgePageInvalidationSchema: z.ZodObject<{
+export declare const KnowledgePageInvalidationSchema: z.ZodObject<{
   verdict: z.ZodLiteral<"contradicted">;
   observedAt: z.ZodISODateTime;
   reason: z.ZodString;
@@ -4228,7 +4226,7 @@ declare const KnowledgePageInvalidationSchema: z.ZodObject<{
   grader: z.ZodOptional<z.ZodString>;
   metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
-declare const KnowledgePageSchema: z.ZodObject<{
+export declare const KnowledgePageSchema: z.ZodObject<{
   id: z.ZodString;
   path: z.ZodString;
   title: z.ZodString;
@@ -4248,7 +4246,7 @@ declare const KnowledgePageSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   }, z.core.$strict>>;
 }, z.core.$strip>;
-declare const KnowledgeGraphNodeSchema: z.ZodObject<{
+export declare const KnowledgeGraphNodeSchema: z.ZodObject<{
   id: z.ZodString;
   title: z.ZodString;
   path: z.ZodString;
@@ -4257,26 +4255,26 @@ declare const KnowledgeGraphNodeSchema: z.ZodObject<{
   outDegree: z.ZodNumber;
   inDegree: z.ZodNumber;
 }, z.core.$strip>;
-declare const KnowledgeGraphEdgeSchema: z.ZodObject<{
+export declare const KnowledgeGraphEdgeSchema: z.ZodObject<{
   source: z.ZodString;
   target: z.ZodString;
   weight: z.ZodNumber;
   reasons: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
-declare const KnowledgeRelationSchema: z.ZodObject<{
+export 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<{
+export 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<{
+export declare const KnowledgeRelationGraphSchema: z.ZodObject<{
   nodes: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
     kind: z.ZodString;
@@ -4291,7 +4289,7 @@ declare const KnowledgeRelationGraphSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
-declare const KnowledgeIndexSchema: z.ZodObject<{
+export declare const KnowledgeIndexSchema: z.ZodObject<{
   root: z.ZodString;
   generatedAt: z.ZodString;
   sources: z.ZodArray<z.ZodObject<{
@@ -4356,7 +4354,7 @@ declare const KnowledgeIndexSchema: z.ZodObject<{
     }, z.core.$strip>>;
   }, z.core.$strip>;
 }, z.core.$strip>;
-declare const KnowledgeEventSchema: z.ZodObject<{
+export declare const KnowledgeEventSchema: z.ZodObject<{
   id: z.ZodString;
   type: z.ZodEnum<{
     "index.built": "index.built";
@@ -4373,7 +4371,7 @@ declare const KnowledgeEventSchema: z.ZodObject<{
   target: z.ZodOptional<z.ZodString>;
   metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
-declare const DeepQuestionSchema: z.ZodObject<{
+export declare const DeepQuestionSchema: z.ZodObject<{
   kind: z.ZodEnum<{
     comparative: "comparative";
     contradiction: "contradiction";
@@ -4386,7 +4384,7 @@ declare const DeepQuestionSchema: z.ZodObject<{
   addressed: z.ZodBoolean;
   raisedRound: z.ZodNumber;
 }, z.core.$strict>;
-declare const ResearchClaimRecordSchema: z.ZodObject<{
+export declare const ResearchClaimRecordSchema: z.ZodObject<{
   id: z.ZodString;
   text: z.ZodString;
   supportingHosts: z.ZodArray<z.ZodString>;
@@ -4395,12 +4393,12 @@ declare const ResearchClaimRecordSchema: z.ZodObject<{
   contested: z.ZodBoolean;
   firstSeenRound: z.ZodNumber;
 }, z.core.$strict>;
-declare const ResearchSourceVersionSchema: z.ZodObject<{
+export declare const ResearchSourceVersionSchema: z.ZodObject<{
   sourceId: z.ZodString;
   uri: z.ZodString;
   contentHash: z.ZodString;
 }, z.core.$strict>;
-declare const ResearchClaimEvidenceSchema: z.ZodObject<{
+export declare const ResearchClaimEvidenceSchema: z.ZodObject<{
   id: z.ZodString;
   claimId: z.ZodString;
   text: z.ZodString;
@@ -4410,7 +4408,7 @@ declare const ResearchClaimEvidenceSchema: z.ZodObject<{
   contradictsClaimId: z.ZodOptional<z.ZodString>;
   firstSeenRound: z.ZodNumber;
 }, z.core.$strict>;
-declare const ResearchClaimLedgerSchema: z.ZodObject<{
+export declare const ResearchClaimLedgerSchema: z.ZodObject<{
   schemaVersion: z.ZodLiteral<2>;
   id: z.ZodString;
   goal: z.ZodOptional<z.ZodString>;
@@ -4455,7 +4453,7 @@ declare const ResearchClaimLedgerSchema: z.ZodObject<{
     raisedRound: z.ZodNumber;
   }, z.core.$strict>>;
 }, z.core.$strict>;
-declare const KnowledgeBaseCandidateSchema: z.ZodObject<{
+export declare const KnowledgeBaseCandidateSchema: z.ZodObject<{
   id: z.ZodString;
   units: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
@@ -4498,13 +4496,13 @@ declare const KnowledgeBaseCandidateSchema: z.ZodObject<{
 }, z.core.$strip>;
 //#endregion
 //#region src/wikilinks.d.ts
-declare const WIKILINK_REGEX: RegExp;
-declare function extractWikilinks(content: string): string[];
-declare function normalizeLinkTarget(target: string): string;
+export declare const WIKILINK_REGEX: RegExp;
+export declare function extractWikilinks(content: string): string[];
+export declare function normalizeLinkTarget(target: string): string;
 //#endregion
 //#region src/write-protocol.d.ts
-declare function isSafeKnowledgePath(path: string, allowedPrefixes?: string[]): boolean;
-declare function parseKnowledgeWriteBlocks(text: string, allowedPrefixes?: string[]): KnowledgeWriteParseResult;
+export declare function isSafeKnowledgePath(path: string, allowedPrefixes?: string[]): boolean;
+export 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, 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, DEADLINE_EXIT_CODE, 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, GradeableClaim, GradedClaim, 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 KnowledgeMutationHold, 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, type KnowledgeStateScope, 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, canonicalPathsEqual, canonicalRelativeWithinRoot, canonicalizeUrl, chunkMarkdown, citedClaimKey, citedClaimOf, claimCheckKey, 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, gradeClaims, gradeCompanyAgainstText, gradeFactAgainstText, gradeFor, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, htmlToText, improveKnowledgeBase, improveSelectedKnowledgeCandidate, initKnowledgeBase, innerHtmlById, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, investmentThesisSet, isKernelAnchoredPath, isKnowledgeMemoryBenchmarkCase, isKnowledgeMutationHeld, 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, normalizeKnowledgeStateScope, normalizeLinkTarget, normalizePageText, normalizePagesDirectory, optimizeKnowledgeBasePolicy, originatedPages, parseFrontmatter, parseKnowledgeBenchmarkJsonl, parseKnowledgeBenchmarkQrels, parseKnowledgeCitationReference, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, planInvalidationPropagation, politeFetch, promoteKnowledgeCandidate, promoteRunScopedPages, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, relativeWithinRoot, removeDurable, renameDurable, renderKnowledgeBenchmarkReportMarkdown, renderMemoryContext, researchSourceVersionKey, resetRetrievalHoldoutRegistry, resolveKnowledgeCitation, resolveKnowledgeCitations, resolveMemoryCleanupTimeoutMs, resolveRunScopedCitation, resolveRunScopedCitations, respondToIndustryMemoryBenchmarkSmokeCase, respondToIndustryRagBenchmarkSmokeCase, restoreKnowledgeCandidateBaseline, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runAgentMemoryExperiment, runAgentMemoryImprovement, runAgentMemoryLearningExperiment, runBoundedMemoryLifecycle, runDiscoveryLoop, runInKnowledgeMutationScope, 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 };
+export { 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, type BuildAgentMemorySequencesFromBenchmarkCasesOptions, type BuildRetrievalBenchmarkCasesFromQrelsOptions, BuildRetrievalEvalDispatchOptions, ClaimRef, type CompareAgentMemoryLearningOptions, CornellLiiSelector, CornellLiiSourceOptions, CreateAgentMemoryBranchOptions, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, DeepQuestion, DeepQuestionKind, type ExternalRagEvalScore, FetchOpts, ForkAgentMemoryBranchSnapshotOptions, FragmentProvenance, GraphitiMcpClientLike, GraphitiMemoryAdapterOptions, GraphitiToolNames, INDUSTRY_MEMORY_BENCHMARKS, INDUSTRY_RAG_BENCHMARKS, IRS_DIMENSION_HINTS, type ImproveSelectedKnowledgeCandidateOptions, type ImproveSelectedKnowledgeCandidateResult, IrsPublicationsSourceOptions, KNOWLEDGE_EVENT_TYPES, type KnowledgeAnswerBenchmarkCase, type KnowledgeAnswerBenchmarkTaskKind, KnowledgeBaseCandidate, type KnowledgeBaseQualityOptions, type KnowledgeBaseQualityReport, 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, KnowledgeClaim, type KnowledgeClaimMatcher, type KnowledgeEvaluationPhase, KnowledgeEvent, KnowledgeEventType, KnowledgeFragment, KnowledgeGraph, KnowledgeGraphEdge, KnowledgeGraphNode, KnowledgeId, type KnowledgeImprovementActivationPersistence, type KnowledgeImprovementCandidateRecord, type KnowledgeImprovementCandidateRef, type KnowledgeImprovementEvaluationInput, type KnowledgeImprovementEvaluator, type KnowledgeImprovementEvent, type KnowledgeImprovementEvidence, type KnowledgeImprovementMetric, type KnowledgeImprovementMetricProvenance, type KnowledgeImprovementMutationReceipt, type KnowledgeImprovementMutationResult, type KnowledgeImprovementOptions, type KnowledgeImprovementRagOptimizationOptions, type KnowledgeImprovementRagOptimizationRunInput, type KnowledgeImprovementResult, type KnowledgeImprovementRetrievalOptions, type KnowledgeImprovementRunState, type KnowledgeImprovementStatus, type KnowledgeImprovementTarget, type KnowledgeImprovementUpdate, type KnowledgeImprovementUpdateInput, KnowledgeIndex, KnowledgeLintFinding, type KnowledgeMemoryBenchmarkCase, type KnowledgeMemoryBenchmarkTaskKind, type KnowledgeMemoryEvent, type KnowledgeMemoryFactMatcher, type KnowledgeMutationHold, type KnowledgeMutationLock, type KnowledgeMutationOptions, KnowledgePage, KnowledgePageInvalidation, KnowledgePolicy, type KnowledgePolicyDispatch, type KnowledgeReadOptions, KnowledgeRelation, KnowledgeRelationGraph, KnowledgeRelationNode, KnowledgeRelease, type KnowledgeRetrievalBenchmarkCase, type KnowledgeRetrievalBenchmarkQrel, type KnowledgeRetrievalBenchmarkQuery, KnowledgeSearchResult, KnowledgeSource, type KnowledgeStateScope, KnowledgeUnit, KnowledgeWriteBlock, KnowledgeWriteParseResult, type LoadKnowledgeImprovementActivationResultOptions, MAX_RESPONSE_BYTES, MIN_REQUEST_GAP_MS, type MeasuredKnowledgeSelectionReceipt, Mem0ClientMode, Mem0HostedClient, Mem0HostedMemoryAdapterOptions, Mem0MemoryAdapterOptions, Mem0OssClient, Mem0OssMemoryAdapterOptions, type MemoryAdapterBenchmarkCandidate, type MemoryAdapterBenchmarkRankingRow, type MemoryConfigScenario, type NearDuplicateDetectionOptions, type NearDuplicatePair, type NearDuplicateReport, Neo4jAgentMemoryAdapterOptions, type OptimizeKnowledgeBasePolicyOptions, type OptimizeKnowledgeBasePolicyResult, OwnedAgentMemoryRunLease, POLITE_USER_AGENT, PartitionRetrievalScenariosOptions, type PendingKnowledgeMutation, PoliteFetchOptions, PoliteFetchResult, type PromoteKnowledgeCandidateOptions, type RagAnswerEvalArtifact, type RagAnswerEvalCase, type RagAnswerEvalScenario, type RagAnswerMetricSummary, type RagAnswerQualityHookOptions, type RagAnswerQualityJudgeOptions, type RagCalibrationOptions, type RagCalibrationResult, type RagEvalCitation, type RagEvalClaim, type RagEvalContext, type RagEvalMetricKey, type RagEvalProvider, type RagEvalSlice, type RagRequiredContext, type RecoverPendingKnowledgeMutationOptions, ResearchClaimEvidence, ResearchClaimLedger, ResearchClaimRecord, ResearchSourceVersion, 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, RetrievalRecallJudgeOptions, RetrievalScenarioPartitions, RetrievedKnowledgeHit, RetrievedSourceSpan, type RunAgentMemoryExperimentOptions, type RunAgentMemoryExperimentResult, type RunAgentMemoryImprovementOptions, type RunAgentMemoryImprovementResult, type RunAgentMemoryLearningExperimentOptions, type RunAgentMemoryLearningExperimentResult, type RunKnowledgeBenchmarkSuiteOptions, type RunKnowledgeBenchmarkSuiteResult, type RunMemoryAdapterBenchmarkOptions, type RunMemoryAdapterBenchmarkResult, RunSerializedKnowledgeOptimizationOptions, RunSerializedKnowledgeOptimizationResult, SerializedCandidate, SerializedCandidateCodec, SourceAnchor, SourceRecord, SourceRegistry, StateSosEntity, StateSosSourceConfig, TrackedClaim, type UseKnowledgeImprovementCandidateOptions, __resetHttpThrottle, acquireAgentMemoryRunLease, agentMemorySequenceJudge, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, buildAgentMemorySequenceScenarios, buildAgentMemorySequencesFromBenchmarkCases, buildFirstPartyMemoryLifecycleBenchmarkCases, buildIndustryMemoryBenchmarkSmokeCases, buildIndustryRagBenchmarkSmokeCases, buildKnowledgeBenchmarkScenarios, buildRetrievalBenchmarkCasesFromQrels, buildRetrievalEvalDispatch, compareAgentMemoryLearning, createAgentMemoryBranch, createCornellLiiSource, createGraphitiMemoryAdapter, createInMemoryBenchmarkAdapter, createIrsPublicationsSource, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, createNoopMemoryBenchmarkAdapter, createStateSosSource, defaultGetMemoryContext, deterministicRng, emitRetrievalHoldoutBypass, extractLinks, firstMatch, forkAgentMemoryBranchSnapshot, graphitiMemoryAdapterIdentity, htmlToText, innerHtmlById, isKnowledgeMemoryBenchmarkCase, jsonCandidateCodec, jsonObjectCandidateCodec, knowledgeBenchmarkJudge, looksLikeBlockPage, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, parseKnowledgeBenchmarkJsonl, parseKnowledgeBenchmarkQrels, partitionRetrievalScenarios, politeFetch, renderKnowledgeBenchmarkReportMarkdown, renderMemoryContext, resetRetrievalHoldoutRegistry, resolveMemoryCleanupTimeoutMs, respondToIndustryMemoryBenchmarkSmokeCase, respondToIndustryRagBenchmarkSmokeCase, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runAgentMemoryExperiment, runAgentMemoryImprovement, runAgentMemoryLearningExperiment, runBoundedMemoryLifecycle, runKnowledgeBenchmarkSuite, runMemoryAdapterBenchmark, runSerializedKnowledgeOptimization, scenarioContentFingerprint, scoreKnowledgeBenchmarkArtifact, scoreMemoryBenchmarkArtifact, scoreRetrievalArtifact, sleepForMemoryRecovery, summarizeKnowledgeBenchmarkCampaign, toOffPolicyTrajectory };
 //# sourceMappingURL=index.d.ts.map