/**
 * Shared MCP sync helpers for coding-agent service implementations.
 *
 * @experimental This API is unstable and may change without notice.
 */
import * as FileSystem from "effect/FileSystem";
import * as Path from "effect/Path";
import * as Effect from "effect/Effect";
import * as ChildProcessSpawner from "effect/unstable/process/ChildProcessSpawner";
import { type AppError } from "../app-error/index.js";
import type { AddMcpServerArgs, McpServerSyncOutcome, RemoveMcpServerArgs } from "./coding-agent.js";
import type { McpServerEntry } from "../settings/index.js";
export interface CliInvocation {
    readonly command: string;
    readonly args: ReadonlyArray<string>;
    readonly timeoutMs: number;
    readonly cwd: string;
}
export interface CliInvocationResult {
    readonly exitCode: number;
    readonly stdout: string;
    readonly stderr: string;
}
type NodePlatform = NodeJS.Platform;
export declare const runCliInvocation: (invocation: CliInvocation) => Effect.Effect<CliInvocationResult, AppError, ChildProcessSpawner.ChildProcessSpawner>;
export interface MixedStrategyConfig {
    readonly configPath: string;
    readonly cliAdd: ReadonlyArray<string>;
    readonly cliRemove: ReadonlyArray<string>;
    readonly supportedPlatforms?: ReadonlyArray<NodePlatform>;
    readonly addIdempotentPatterns?: ReadonlyArray<RegExp>;
    readonly removeIdempotentPatterns?: ReadonlyArray<RegExp>;
    readonly timeoutMs?: number;
}
export interface SyncInlineMcpServerArgs {
    readonly workspaceRoot: string;
    readonly serverName: string;
    readonly entry: McpServerEntry;
    readonly scope?: "project" | "user";
}
export interface PruneManagedMcpServersArgs {
    readonly workspaceRoot: string;
    readonly declaredServerNames: ReadonlySet<string>;
    readonly scope?: "project" | "user";
    /** Inspect and report stale targets without changing agent configuration. */
    readonly dryRun?: boolean;
}
export declare const syncInlineMcpServerToAgents: (agentIds: ReadonlyArray<string>, args: SyncInlineMcpServerArgs) => Effect.Effect<ReadonlyArray<McpServerSyncOutcome>, AppError, FileSystem.FileSystem | Path.Path>;
export declare const syncInlineMcpServerToAgent: (agentId: string, args: SyncInlineMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
export declare const pruneManagedMcpServersForAgent: (agentId: string, args: PruneManagedMcpServersArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
export declare const addMcpServerMixed: (strategy: MixedStrategyConfig, args: AddMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path | ChildProcessSpawner.ChildProcessSpawner>;
export declare const removeMcpServerMixed: (strategy: MixedStrategyConfig, args: RemoveMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path | ChildProcessSpawner.ChildProcessSpawner>;
export declare const addMcpServerConfigOnly: (configPathTemplate: string, args: AddMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
export declare const removeMcpServerConfigOnly: (configPathTemplate: string, args: RemoveMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
export interface ConfigFirstStrategy {
    readonly configPath: string;
    readonly verifyCommand?: ReadonlyArray<string>;
    readonly supportedPlatforms?: ReadonlyArray<NodePlatform>;
    readonly timeoutMs?: number;
}
export declare const addMcpServerConfigFirst: (strategy: ConfigFirstStrategy, args: AddMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path | ChildProcessSpawner.ChildProcessSpawner>;
export declare const removeMcpServerConfigFirst: (strategy: ConfigFirstStrategy, args: RemoveMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path | ChildProcessSpawner.ChildProcessSpawner>;
export declare const addMcpServerFromManifest: (agentId: string, args: AddMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
export declare const removeMcpServerFromManifest: (agentId: string, args: RemoveMcpServerArgs) => Effect.Effect<McpServerSyncOutcome, AppError, FileSystem.FileSystem | Path.Path>;
export {};
//# sourceMappingURL=mcp-sync.d.ts.map