/**
 * Install MCP server executor — orchestrates the per-server installation pipeline.
 *
 * Registry-only install: fetch archive, extract to canonical path, update lockfile/settings.
 * Simpler than skills — no agent symlinks.
 *
 * @experimental This API is unstable and may change without notice.
 */
import * as FileSystem from "effect/FileSystem";
import type * as HttpClient from "effect/unstable/http/HttpClient";
import * as Path from "effect/Path";
import * as Effect from "effect/Effect";
import * as Option from "effect/Option";
import { CodingAgentRepository } from "../../agents/index.js";
import type { ConfigurableAgentId } from "../../agent-capabilities/index.js";
import { type AppError } from "../../app-error/index.js";
import type { JobStepResult, Operation } from "../../plan/plan.js";
import { WorkspaceMutations } from "../../workspace/service-interface.js";
import type { McpServerExtensionRef } from "../refs.js";
/**
 * Args for the install-mcp-server operation.
 */
export type InstallMcpServerOperationArgs = {
    readonly ref: McpServerExtensionRef;
    readonly force: boolean;
    /** Explicitly permit a workspace-authored relocation during reconciliation. */
    readonly allowWorkspaceSourceTransition?: boolean;
    readonly versionRange: Option.Option<string>;
    /** When true, write to lockfile only (skip settings). Used for pack dependencies. */
    readonly skipSettings: Option.Option<boolean>;
    /** Materialize only; the enclosing authored-package transaction owns state writes. */
    readonly skipStateWrites?: boolean;
    /** When true, enforce strict policy for MCP sync outcomes. */
    readonly strictAgentSync?: Option.Option<boolean>;
    /** Resolved MCP input values from `--env KEY=VALUE` flags. */
    readonly env?: Option.Option<Readonly<Record<string, string>>>;
    /** Restrict this server to a reviewed subset of configured agents. */
    readonly agents?: ReadonlyArray<ConfigurableAgentId>;
};
/**
 * Add an MCP server to the workspace.
 *
 * @experimental This API is unstable and may change without notice.
 */
export type InstallMcpServerOperation = Operation<"install-mcp-server", InstallMcpServerOperationArgs>;
/**
 * Install-mcp-server operation handler.
 *
 * Registry-only: fetch archive, validate integrity, extract to canonical path,
 * then update lockfile/settings.
 */
export declare const installMcpServer: (op: InstallMcpServerOperation) => Effect.Effect<JobStepResult, AppError, FileSystem.FileSystem | HttpClient.HttpClient | Path.Path | WorkspaceMutations | CodingAgentRepository>;
//# sourceMappingURL=install.d.ts.map