/** Deterministic Knowledge discovery table reconciliation. */
import * as Effect from "effect/Effect";
import * as FileSystem from "effect/FileSystem";
import * as Option from "effect/Option";
import * as Path from "effect/Path";
import { type AppError } from "../app-error/index.js";
import type { ResolvedKnowledgeDiscoveryConfig } from "./discovery-config.js";
export declare const KNOWLEDGE_REGION_OWNER = "@agentxm/knowledge/discovery";
export interface KnowledgeDiscoveryBundle {
    readonly owner: string;
    readonly name: string;
    readonly sourceDir: string;
    readonly description?: string;
}
export interface KnowledgeDiscoveryArtifact {
    readonly path: string;
    readonly change: "created" | "updated" | "removed" | "unchanged";
    readonly mechanism?: "symlink" | "copy";
}
export interface KnowledgeDiscoveryResult {
    readonly changed: boolean;
    readonly artifacts: ReadonlyArray<KnowledgeDiscoveryArtifact>;
    readonly observedRegion: Option.Option<string>;
}
export declare const renderKnowledgeBaseTable: (args: {
    readonly bundles: ReadonlyArray<KnowledgeDiscoveryBundle>;
    readonly instructionsPath: string;
    readonly path: Path.Path;
}) => string;
export declare const observedKnowledgeContributors: (content: string) => ReadonlyArray<string>;
export declare const reconcileKnowledgeDiscovery: (args: {
    readonly scopeRoot: string;
    readonly config: ResolvedKnowledgeDiscoveryConfig;
    readonly bundles: ReadonlyArray<KnowledgeDiscoveryBundle>;
    readonly instructionsPath: string;
    readonly instructionManagementEnabled?: boolean;
    readonly preserveInstructionsSource?: boolean;
    readonly dryRun?: boolean;
    readonly symlinkSupported?: boolean;
}) => Effect.Effect<KnowledgeDiscoveryResult, AppError, FileSystem.FileSystem | Path.Path>;
//# sourceMappingURL=discovery.d.ts.map