/**
 * MCP server subject module: declared/resolved/actual payloads, scanner
 * composition (canonical-extensions + mcp-config(workspace) + mcp-config(agent)),
 * and projections via the shared helper.
 *
 * MCP servers carry a declared `enabled` flag in settings. Disabled servers
 * remain installed on disk and in the lockfile but are removed from agent
 * configs unless the target agent has a native enabled toggle.
 */
import * as Effect from "effect/Effect";
import * as Option from "effect/Option";
import type { AgentId } from "../../../agents/types.js";
import { type ExtensionName } from "../../../extensions/common.js";
import type { Lockfile, McpServerLockEntry } from "../../../lockfile/schema.js";
import type { McpServerEntry, Settings } from "../../../settings/schema.js";
import type { Diagnostics } from "../diagnostics.js";
import type { LockfileReadError, SettingsReadError } from "../errors.js";
import type { CanonicalExtensionOccurrence, McpConfigOccurrence } from "../scanners/types.js";
import type { ActivationState, ExtensionKey, InstallationOrigin, InstalledPackRef, Scope } from "../types.js";
export type McpServerDetectionOrigin = {
    readonly _tag: "canonical-axm-mcp-server";
} | {
    readonly _tag: "external-axm-mcp-server";
} | {
    readonly _tag: "workspace-mcp-config";
} | {
    readonly _tag: "agent-mcp-config";
    readonly agentId: AgentId;
};
export interface DeclaredMcpServer {
    readonly name: ExtensionName;
    readonly entry: McpServerEntry;
}
export type DeclaredMcpServers = ReadonlyArray<DeclaredMcpServer>;
export interface ResolvedMcpServer {
    readonly name: ExtensionName;
    readonly lockEntry: McpServerLockEntry;
}
export type ResolvedMcpServers = ReadonlyArray<ResolvedMcpServer>;
/**
 * One observable MCP server materialization. `configFile` is the absolute
 * path to the config file containing the server entry (workspace `.mcp.json`
 * or an agent-native MCP config). For canonical/external AXM occurrences,
 * `configFile` is null and `contentRoot` carries the package directory.
 */
export interface ActualMcpServer {
    readonly key: ExtensionKey<"mcp-server">;
    readonly origin: McpServerDetectionOrigin;
    readonly contentRoot: string | null;
    readonly packageRoot: string | null;
    readonly configFile: string | null;
    readonly config: Readonly<Record<string, unknown>> | null;
}
export type ActualMcpServers = ReadonlyArray<ActualMcpServer>;
export interface McpServerPackMember {
    readonly name: ExtensionName;
    readonly providingPack: InstalledPackRef;
}
export interface InstalledMcpServer {
    readonly key: ExtensionKey<"mcp-server">;
    readonly installationOrigin: InstallationOrigin<DeclaredMcpServer, McpServerPackMember>;
    readonly activation: ActivationState;
    readonly resolved: Option.Option<ResolvedMcpServer>;
    readonly actual: ReadonlyArray<ActualMcpServer>;
    readonly providingPacks: ReadonlyArray<InstalledPackRef>;
}
export interface UnmanagedMcpServer {
    readonly key: ExtensionKey<"mcp-server">;
    readonly actual: ActualMcpServer;
}
export interface McpServerScopedLoaders {
    readonly settings: Effect.Effect<Option.Option<Settings>, SettingsReadError>;
    readonly lockfile: Effect.Effect<Option.Option<Lockfile>, LockfileReadError>;
}
export interface McpServerScanners {
    readonly canonical: Effect.Effect<ReadonlyArray<CanonicalExtensionOccurrence>>;
    readonly mcpConfig: Effect.Effect<ReadonlyArray<McpConfigOccurrence>>;
}
export interface InstalledPackForMcpServers {
    readonly ref: InstalledPackRef;
    readonly mcpServers: ReadonlyArray<McpServerPackMember>;
}
export interface McpServerExtensionsApiDeps {
    readonly scope: Scope;
    readonly loaders: McpServerScopedLoaders;
    readonly scanners: McpServerScanners;
    readonly installedPacks: Effect.Effect<ReadonlyArray<InstalledPackForMcpServers>, SettingsReadError | LockfileReadError>;
    readonly diagnostics: Diagnostics;
}
export interface McpServerExtensionsApi {
    readonly declared: Effect.Effect<Option.Option<DeclaredMcpServers>, SettingsReadError>;
    readonly resolved: Effect.Effect<Option.Option<ResolvedMcpServers>, LockfileReadError>;
    readonly actual: Effect.Effect<ActualMcpServers>;
    readonly installed: Effect.Effect<ReadonlyArray<InstalledMcpServer>, SettingsReadError | LockfileReadError>;
    readonly byName: (name: string) => Effect.Effect<Option.Option<InstalledMcpServer>, SettingsReadError | LockfileReadError>;
    readonly declaredByName: (name: string) => Effect.Effect<Option.Option<DeclaredMcpServer>, SettingsReadError>;
    readonly active: Effect.Effect<ReadonlyArray<InstalledMcpServer>, SettingsReadError | LockfileReadError>;
    readonly unmanaged: Effect.Effect<ReadonlyArray<UnmanagedMcpServer>, SettingsReadError | LockfileReadError>;
}
/**
 * Build the MCP server subject API. Returns an `Effect` because the
 * projection cell is wrapped in `Effect.cached` so the four derived cells
 * share one in-flight execution per scope, mirroring `state.ts`.
 */
export declare const makeMcpServerExtensionsApi: (deps: McpServerExtensionsApiDeps) => Effect.Effect<McpServerExtensionsApi>;
//# sourceMappingURL=mcp-server.d.ts.map