/**
 * Shared types for OpenLore install adapters.
 *
 * An adapter knows how to plan, apply, and uninstall OpenLore's footprint on
 * one specific agent surface. Adapters never write to disk directly when
 * `dryRun` is true; instead they return a list of `PlannedChange` entries that
 * the caller renders.
 */
import type { AgentName } from '../detect.js';
import type { PlatformCommandRuntime } from '../../../utils/platform-command.js';
export interface PlannedChange {
    /** Absolute path the change applies to. */
    path: string;
    /** What we'd do to that file. */
    kind: 'create' | 'update' | 'noop' | 'delete';
    /** Short human-readable summary (one line). */
    summary: string;
    /** Optional unified-diff-ish preview for `--dry-run`. */
    preview?: string;
}
/**
 * Which configuration scope an apply/uninstall targets (change:
 * unify-onboarding-entrypoint).
 *
 * `repo` is the per-project footprint OpenLore has always written. `user` is the
 * per-user footprint that makes EVERY future repository reach the MCP server
 * without another command — same managed, marker-identified entries, different
 * files. `ctx.root` is the target root for the scope: the project root for
 * `repo`, the user's home directory for `user`.
 */
export type InstallScope = 'repo' | 'user';
export interface ApplyContext {
    root: string;
    /** Configuration scope this apply targets. Absent = `repo` (the historical default). */
    scope?: InstallScope;
    /** Platform on which generated launch commands will execute. */
    platform: NodeJS.Platform;
    /** Trusted executable roots used when emitting Windows command wrappers. */
    platformCommandRuntime: PlatformCommandRuntime;
    /** Template content for the markdown instruction block. */
    instructionTemplate: string;
    dryRun: boolean;
    force: boolean;
    /**
     * Optional MCP tool preset (e.g. "memory", "navigation", "minimal"). When set,
     * adapters that register the MCP server wire `openlore mcp --preset <name>` so
     * the agent sees that curated surface instead of the full tool set. Undefined
     * = the server's default (all tools).
     */
    preset?: string;
}
export interface ApplyResult {
    changes: PlannedChange[];
    /** Warnings to surface to the user (e.g. hand-edited block, unsure-of-path TODO). */
    warnings: string[];
    /** If true, install should exit non-zero (hand-edit conflict without --force). */
    conflict: boolean;
}
export interface Adapter {
    name: AgentName;
    /**
     * Does this agent have a USER-scope configuration surface OpenLore can write?
     * When false (the default), bare `openlore install` wires it per-repo only and
     * says so — an adapter without a user scope degrades honestly, never fails.
     */
    supportsGlobal?: boolean;
    /**
     * Marker-based presence check for the USER scope, mirroring {@link isConnected}.
     * Only meaningful for an adapter with `supportsGlobal: true`.
     */
    isConnectedUserScope?(userRoot: string): Promise<boolean>;
    apply(ctx: ApplyContext): Promise<ApplyResult>;
    uninstall(ctx: ApplyContext): Promise<ApplyResult>;
    /**
     * Preset-insensitive presence check for `connect list`: is OpenLore's managed
     * footprint present for this agent under `root`? Checks for our marker (a
     * markdown block, or a managed JSON entry), NOT config equality — an agent
     * wired with a different preset or an older template still counts as connected.
     */
    isConnected(root: string): Promise<boolean>;
}
//# sourceMappingURL=types.d.ts.map