@agentxm/client-core 0.1.6

package/dist/src/unstable/mcp-servers/manifest-schema.js

@@ -0,0 +1,38 @@
+/**
+ * MCP server manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { CommonManifestBaseFields, ExtensionNameSchema } from "../extensions/common.js";
+/**
+ * Filename for MCP server manifest files.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const MCP_SERVER_MANIFEST_FILENAME = "mcp-server.json";
+/**
+ * URL for the MCP server manifest JSON Schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const MCP_SERVER_MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/mcp-server.schema.json";
+/**
+ * Schema for MCP server manifest files (mcp-server.json).
+ *
+ * MCP servers provide Model Context Protocol endpoints that
+ * extend coding agent capabilities with external tools and resources.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const McpServerManifestSchema = Schema.Struct({
+    $schema: Schema.optional(Schema.String),
+    ...CommonManifestBaseFields,
+    type: Schema.Literal("mcp-server"),
+    name: ExtensionNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "MCP server name is required" })),
+}).annotate({
+    identifier: "McpServerManifest",
+    title: "MCP Server Manifest",
+    description: "Configuration file (mcp-server.json) that defines an MCP server extension.",
+});
+//# sourceMappingURL=manifest-schema.js.map

package/dist/src/unstable/mcp-servers/manifest-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.js","sourceRoot":"","sources":["../../../../src/unstable/mcp-servers/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAExF;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,iBAAiB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,+CAA+C,CAAC;AAE9F;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACvC,GAAG,wBAAwB;IAC3B,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;IAClC,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAC5B,MAAM,CAAC,WAAW,CAAC,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,CAAC,CACzE;CACF,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,mBAAmB;IAC/B,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE,4EAA4E;CAC1F,CAAC,CAAC"}

package/dist/src/unstable/mcp-servers/operations/install.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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 * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { CodingAgentRepository } from "../../agents/index.js";
+import { CliRenderer } from "../../cli-renderer/index.js";
+import { type AppError } from "../../app-error/index.js";
+import type { JobStepResult, Operation } from "../../workspace/plan.js";
+import { Workspace } 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;
+    readonly versionConstraint: Option.Option<string>;
+    /** When true, write to lockfile only (skip settings). Used for pack dependencies. */
+    readonly skipSettings: Option.Option<boolean>;
+    /** When true, enforce strict policy for MCP sync outcomes. */
+    readonly strictAgentSync?: Option.Option<boolean>;
+};
+/**
+ * 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 | Path.Path | Workspace | CliRenderer | CodingAgentRepository>;
+//# sourceMappingURL=install.d.ts.map

package/dist/src/unstable/mcp-servers/operations/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/mcp-servers/operations/install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIvE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEjE,OAAO,KAAK,EAAE,qBAAqB,EAAwB,MAAM,YAAY,CAAC;AAQ9E;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,qFAAqF;IACrF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;CACnD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,CAC/C,oBAAoB,EACpB,6BAA6B,CAC9B,CAAC;AAyRF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAC7B,EAAE,EAAE,yBAAyB,KAC1B,MAAM,CAAC,MAAM,CAChB,aAAa,EACb,QAAQ,EACR,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,qBAAqB,CA4CjF,CAAC"}

package/dist/src/unstable/mcp-servers/operations/install.js

@@ -0,0 +1,239 @@
+/**
+ * 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 * as Path from "effect/Path";
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { CodingAgentRepository } from "../../agents/index.js";
+import { CliRenderer } from "../../cli-renderer/index.js";
+import { computeIntegrity, isPathSafe } from "../../utils/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { validateExactResolvedVersion } from "../../lockfile/index.js";
+import { createRegistryClient, extractZip } from "../../registry/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { REGISTRY_EXTENSIONS_DIR } from "../../extensions/index.js";
+import { decodeExactSemverVersionSync } from "../../version-constraints/version-constraints.js";
+// -----------------------------------------------------------------------------
+// Lock entry builder
+// -----------------------------------------------------------------------------
+const buildLockEntry = (ref, now) => ({
+    type: "registry",
+    owner: ref.owner,
+    name: ref.name,
+    resolvedVersion: decodeExactSemverVersionSync(ref.version),
+    integrity: Option.getOrElse(ref.integrity, () => ""),
+    sourceName: "default",
+    installedAt: now,
+    updatedAt: now,
+});
+// -----------------------------------------------------------------------------
+// Registry install
+// -----------------------------------------------------------------------------
+const installFromRegistry = (ref) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const canonicalPath = path.join(ws.baseDir, REGISTRY_EXTENSIONS_DIR, ref.owner, "mcp-servers", ref.name);
+    if (!isPathSafe(ws.baseDir, canonicalPath)) {
+        return yield* makeAppError({
+            code: "INSTALL_MCP_SERVER_PATH_TRAVERSAL",
+            what: `Path traversal detected: ${canonicalPath}`,
+        });
+    }
+    // Empty integrity with existing canonical → skip fetch (synthetic refs from fork/publish)
+    const canonicalExists = yield* fs.exists(canonicalPath).pipe(Effect.mapError((e) => makeAppError({
+        code: "INSTALL_MCP_SERVER_PATH_CHECK_FAILED",
+        what: `Failed to check if canonical path exists: ${canonicalPath}`,
+        cause: e,
+    })));
+    const useExisting = Option.isNone(ref.integrity) && canonicalExists;
+    if (!useExisting) {
+        const locationStr = ref.source.location.protocol === "file:"
+            ? ref.source.location.pathname
+            : ref.source.location.href;
+        const client = yield* createRegistryClient(locationStr);
+        const { archive } = yield* client.getExtensionPackage({
+            owner: ref.owner,
+            type: "mcp-server",
+            name: ref.name,
+            version: Option.some(ref.version),
+        });
+        if (Option.isSome(ref.integrity)) {
+            const actualIntegrity = yield* computeIntegrity(archive);
+            if (actualIntegrity !== ref.integrity.value) {
+                return yield* makeAppError({
+                    code: "INSTALL_MCP_SERVER_INTEGRITY_MISMATCH",
+                    what: `Integrity mismatch for ${ref.name}@${ref.version}`,
+                    details: [`Expected ${ref.integrity.value}, got ${actualIntegrity}`],
+                });
+            }
+        }
+        const tmpDir = yield* fs.makeTempDirectory().pipe(Effect.mapError((e) => makeAppError({
+            code: "INSTALL_MCP_SERVER_TEMP_DIR_FAILED",
+            what: `Failed to create temporary directory for registry install`,
+            cause: e,
+        })));
+        yield* Effect.ensuring(Effect.gen(function* () {
+            yield* extractZip(archive, tmpDir);
+            // Remove existing canonical and copy fresh
+            yield* fs.remove(canonicalPath, { recursive: true }).pipe(Effect.ignore);
+            yield* fs.makeDirectory(canonicalPath, { recursive: true }).pipe(Effect.mapError((e) => makeAppError({
+                code: "INSTALL_MCP_SERVER_COPY_FAILED",
+                what: `Failed to create canonical directory: ${canonicalPath}`,
+                cause: e,
+            })));
+            // Copy extracted files to canonical
+            const entries = yield* fs.readDirectory(tmpDir).pipe(Effect.mapError((e) => makeAppError({
+                code: "INSTALL_MCP_SERVER_COPY_FAILED",
+                what: `Failed to read extracted directory`,
+                cause: e,
+            })));
+            yield* Effect.forEach(entries, (entry) => {
+                const src = path.join(tmpDir, entry);
+                const dest = path.join(canonicalPath, entry);
+                return fs.copy(src, dest).pipe(Effect.ignore);
+            }, { concurrency: "unbounded" });
+        }), fs.remove(tmpDir, { recursive: true }).pipe(Effect.ignore));
+    }
+    return canonicalPath;
+});
+const REQUIRED_AGENT_IDS = new Set([
+    "claude-code",
+    "opencode",
+    "github-copilot",
+    "cursor",
+    "gemini-cli",
+    "codex",
+]);
+const summarizeAgentSync = (outcomes) => {
+    const degraded = outcomes.some(({ outcome }) => outcome._tag === "failed" || outcome._tag === "fallback");
+    const details = outcomes.map(({ agentId, outcome }) => outcome._tag === "success"
+        ? `${agentId}:success`
+        : outcome._tag === "fallback"
+            ? `${agentId}:fallback:${outcome.fallbackFrom}`
+            : `${agentId}:${outcome._tag}`);
+    return {
+        status: degraded ? "degraded" : "green",
+        details,
+    };
+};
+const syncConfiguredAgentsOnInstall = (args) => Effect.gen(function* () {
+    const renderer = yield* CliRenderer;
+    const agentRepo = yield* CodingAgentRepository;
+    const unknownConfiguredAgentIds = yield* agentRepo.getUnknownConfiguredAgentIds();
+    if (args.strict && unknownConfiguredAgentIds.length > 0) {
+        const message = `Unknown configured agents in strict mode: ${unknownConfiguredAgentIds.join(", ")}`;
+        return yield* makeAppError({
+            code: "CODING_AGENT_UNKNOWN_CONFIGURED",
+            what: message,
+            details: unknownConfiguredAgentIds,
+        });
+    }
+    if (unknownConfiguredAgentIds.length > 0) {
+        yield* renderer.warn(`Skipping unknown configured agents: ${unknownConfiguredAgentIds.join(", ")}`);
+    }
+    const configuredAgents = yield* agentRepo.getConfiguredAgents();
+    const outcomes = yield* Effect.forEach(configuredAgents, (agent) => agent
+        .addMcpServer({
+        workspaceRoot: args.wsBaseDir,
+        serverName: args.serverName,
+        canonicalPath: args.canonicalPath,
+        owner: args.owner,
+        resolvedVersion: args.resolvedVersion,
+    })
+        .pipe(Effect.map((outcome) => ({ agentId: agent.id, outcome }))), { concurrency: "unbounded" });
+    const misconfigured = Array.filter(outcomes, ({ outcome }) => outcome._tag === "misconfigured");
+    if (misconfigured.length > 0) {
+        const details = misconfigured.map(({ agentId, outcome }) => outcome._tag === "misconfigured" ? `${agentId}: ${outcome.reason}` : `${agentId}: invalid`);
+        return yield* makeAppError({
+            code: "MCP_SERVER_AGENT_SYNC_MISCONFIGURED",
+            what: `MCP server ${args.serverName} could not be synced to configured agents`,
+            details,
+        });
+    }
+    const failed = Array.filter(outcomes, ({ outcome }) => outcome._tag === "failed");
+    if (args.strict && failed.length > 0) {
+        const details = failed.map(({ agentId, outcome }) => outcome._tag === "failed" ? `${agentId}: ${outcome.reason}` : `${agentId}: failed`);
+        return yield* makeAppError({
+            code: "MCP_SERVER_AGENT_SYNC_FAILED",
+            what: `MCP server ${args.serverName} sync failed in strict mode`,
+            details,
+        });
+    }
+    const strictDisabledFailures = Array.filter(outcomes, ({ agentId, outcome }) => (outcome._tag === "disabled" ||
+        (outcome._tag === "fallback" && outcome.fallbackFrom === "disabled")) &&
+        args.strict &&
+        REQUIRED_AGENT_IDS.has(agentId));
+    if (strictDisabledFailures.length > 0) {
+        const details = strictDisabledFailures.map(({ agentId, outcome }) => outcome._tag === "success" ? `${agentId}: disabled` : `${agentId}: ${outcome.reason}`);
+        return yield* makeAppError({
+            code: "MCP_SERVER_AGENT_SYNC_DISABLED_REQUIRED",
+            what: `MCP server ${args.serverName} sync disabled for required configured agents`,
+            details,
+        });
+    }
+    const warningOutcomes = Array.filter(outcomes, ({ outcome }) => outcome._tag === "unsupported" ||
+        outcome._tag === "disabled" ||
+        outcome._tag === "failed" ||
+        outcome._tag === "fallback");
+    if (warningOutcomes.length > 0) {
+        const warningMessage = warningOutcomes
+            .map(({ agentId, outcome }) => outcome._tag === "success"
+            ? `${agentId}:success`
+            : outcome._tag === "fallback"
+                ? `${agentId}:fallback(${outcome.fallbackFrom}):${outcome.reason}`
+                : `${agentId}:${outcome.reason}`)
+            .join(", ");
+        yield* renderer.warn(`MCP agent sync warnings for ${args.serverName}: ${warningMessage}`);
+    }
+    return summarizeAgentSync(outcomes);
+});
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Install-mcp-server operation handler.
+ *
+ * Registry-only: fetch archive, validate integrity, extract to canonical path,
+ * then update lockfile/settings.
+ */
+export const installMcpServer = (op) => Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const renderer = yield* CliRenderer;
+    const { ref } = op.args;
+    if (ref.refType !== "registry") {
+        return yield* makeAppError({
+            code: "INSTALL_MCP_SERVER_UNSUPPORTED_REF_TYPE",
+            what: `Unsupported ref type for MCP server install: ${ref.refType}`,
+        });
+    }
+    const strictAgentSync = Option.getOrElse(op.args.strictAgentSync ?? Option.none(), () => false);
+    const canonicalPath = yield* installFromRegistry(ref);
+    yield* validateExactResolvedVersion(`mcpServers.${ref.server.name}.resolvedVersion`, ref.version);
+    // Build lock entry and persist
+    const lockEntry = buildLockEntry(ref, new Date());
+    const writeEffect = Option.getOrElse(op.args.skipSettings, () => false)
+        ? ws.setMcpServerLock({ name: ref.server.name, lockEntry })
+        : ws.setMcpServer({ name: ref.server.name, lockEntry });
+    yield* writeEffect.pipe(Effect.catch((e) => renderer.warn(`MCP server update failed: ${String(e)}`)));
+    const agentSync = yield* syncConfiguredAgentsOnInstall({
+        wsBaseDir: ws.baseDir,
+        strict: strictAgentSync,
+        serverName: ref.server.name,
+        canonicalPath,
+        owner: ref.owner,
+        resolvedVersion: ref.version,
+    });
+    return {
+        result: "success",
+        message: `Installed ${ref.server.name} (canonical=success, agent-sync=${agentSync.status})`,
+    };
+});
+//# sourceMappingURL=install.js.map

package/dist/src/unstable/mcp-servers/operations/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../../../src/unstable/mcp-servers/operations/install.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/mcp-servers/operations/publish.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Publish MCP server executor — reads an MCP server's manifest, builds a
+ * zip archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * Pipeline: validate manifest -> build archive -> compute integrity ->
+ * resolve registry provider -> publish version (idempotent).
+ *
+ * @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 { type AppError } from "../../app-error/index.js";
+import type { JobStepResult, Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Args for the publish-mcp-server operation.
+ */
+export type PublishMcpServerOperationArgs = {
+    /** Extension identity in `@owner/mcp-servers/name` FQN format. */
+    readonly name: string;
+    /** Named source to publish to (e.g. "local"). */
+    readonly registryName: string;
+};
+/**
+ * Publish an MCP server extension to a registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type PublishMcpServerOperation = Operation<"publish-mcp-server", PublishMcpServerOperationArgs>;
+/**
+ * Publish-mcp-server operation handler.
+ *
+ * 1. Read and validate `mcp-server.json` manifest
+ * 2. Build zip archive of extension directory
+ * 3. Compute SRI integrity hash
+ * 4. Resolve target registry provider by source name
+ * 5. Publish version (idempotent: same integrity = no-op, different integrity = error)
+ */
+export declare const publishMcpServer: (op: PublishMcpServerOperation) => Effect.Effect<JobStepResult, AppError, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/src/unstable/mcp-servers/operations/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/mcp-servers/operations/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAYxC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAMjE;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,CAC/C,oBAAoB,EACpB,6BAA6B,CAC9B,CAAC;AAMF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAC7B,EAAE,EAAE,yBAAyB,KAC1B,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CA6HrF,CAAC"}

package/dist/src/unstable/mcp-servers/operations/publish.js

@@ -0,0 +1,120 @@
+/**
+ * Publish MCP server executor — reads an MCP server's manifest, builds a
+ * zip archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * Pipeline: validate manifest -> build archive -> compute integrity ->
+ * resolve registry provider -> publish version (idempotent).
+ *
+ * @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 Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { REGISTRY_EXTENSIONS_DIR, parseFqn } from "../../extensions/index.js";
+import { MCP_SERVER_MANIFEST_FILENAME, McpServerManifestSchema, } from "../manifest-schema.js";
+import { createRegistryClient } from "../../registry/index.js";
+import { buildZipArchive, computeIntegrity } from "../../utils/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Publish-mcp-server operation handler.
+ *
+ * 1. Read and validate `mcp-server.json` manifest
+ * 2. Build zip archive of extension directory
+ * 3. Compute SRI integrity hash
+ * 4. Resolve target registry provider by source name
+ * 5. Publish version (idempotent: same integrity = no-op, different integrity = error)
+ */
+export const publishMcpServer = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    const fqn = yield* parseFqn(op.args.name);
+    // Locate the extension directory
+    const extensionDir = path.join(base, REGISTRY_EXTENSIONS_DIR, fqn.owner, "mcp-servers", fqn.name);
+    const extensionDirExists = yield* fs
+        .exists(extensionDir)
+        .pipe(Effect.orElseSucceed(() => false));
+    if (!extensionDirExists) {
+        return yield* makeAppError({
+            code: "PUBLISH_MCP_SERVER_NOT_FOUND",
+            what: `Managed extension not found: ${extensionDir}`,
+        });
+    }
+    // Read and validate manifest
+    const manifestPath = path.join(extensionDir, MCP_SERVER_MANIFEST_FILENAME);
+    const manifestContent = yield* fs.readFileString(manifestPath).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_MCP_SERVER_MANIFEST_READ_FAILED",
+        what: `Failed to read manifest: ${manifestPath}`,
+        cause: e,
+    })));
+    const manifestJson = yield* Effect.try({
+        try: () => {
+            const parsed = JSON.parse(manifestContent);
+            return parsed;
+        },
+        catch: (e) => makeAppError({
+            code: "PUBLISH_MCP_SERVER_MANIFEST_PARSE_FAILED",
+            what: `Invalid JSON in manifest: ${manifestPath}`,
+            cause: e,
+        }),
+    });
+    const manifest = yield* Schema.decodeUnknownEffect(McpServerManifestSchema)(manifestJson).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_MCP_SERVER_MANIFEST_SCHEMA_INVALID",
+        what: `Invalid manifest schema: ${manifestPath}`,
+        cause: e,
+    })));
+    // Build zip archive from extension directory
+    const archive = yield* buildZipArchive(extensionDir, "PUBLISH_MCP_SERVER_ARCHIVE_FAILED");
+    // Compute integrity
+    const integrity = yield* computeIntegrity(archive);
+    // Resolve target registry source
+    const registrySource = yield* ws.getConfiguredSourceByName(op.args.registryName).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_MCP_SERVER_REGISTRY_LOOKUP_FAILED",
+        what: `Failed to lookup registry source "${op.args.registryName}"`,
+        cause: e,
+    })));
+    if (Option.isNone(registrySource) || registrySource.value.type !== "registry") {
+        return yield* makeAppError({
+            code: "PUBLISH_MCP_SERVER_REGISTRY_NOT_FOUND",
+            what: `Registry source "${op.args.registryName}" not found or not a registry source`,
+        });
+    }
+    const client = yield* createRegistryClient(registrySource.value.location.href);
+    // Build version entry metadata
+    const versionEntry = {
+        version: manifest.version,
+        published: new Date().toISOString(),
+        integrity,
+        ...(manifest.compatiblePackages !== undefined && {
+            compatiblePackages: manifest.compatiblePackages,
+        }),
+    };
+    // Publish to registry (idempotent)
+    yield* client
+        .publishExtension({
+        owner: fqn.owner,
+        type: "mcp-server",
+        name: fqn.name,
+        version: manifest.version,
+        archive,
+        metadata: versionEntry,
+    })
+        .pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_MCP_SERVER_PUBLISH_FAILED",
+        what: "Failed to publish to registry",
+        details: [e.what],
+        cause: e,
+    })));
+    return {
+        result: "success",
+        message: `Published ${op.args.name}@${manifest.version}`,
+    };
+});
+//# sourceMappingURL=publish.js.map

package/dist/src/unstable/mcp-servers/operations/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../../../src/unstable/mcp-servers/operations/publish.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/mcp-servers/operations/uninstall.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Uninstall MCP server executor — orchestrates per-server removal pipeline.
+ *
+ * Pipeline: read lockfile -> remove canonical dir -> remove lockfile/settings entry.
+ * Simpler than skills — no agent symlinks.
+ *
+ * @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 Option from "effect/Option";
+import { CodingAgentRepository } from "../../agents/index.js";
+import { CliRenderer } from "../../cli-renderer/index.js";
+import { type AppError } from "../../app-error/index.js";
+import type { JobStepResult, Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Args for the uninstall-mcp-server operation.
+ */
+export interface UninstallMcpServerOperationArgs {
+    readonly serverName: string;
+    /** When true, enforce strict policy for MCP sync outcomes. */
+    readonly strictAgentSync?: Option.Option<boolean>;
+}
+/**
+ * Remove an MCP server from the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type UninstallMcpServerOperation = Operation<"uninstall-mcp-server", UninstallMcpServerOperationArgs>;
+/**
+ * Uninstall-mcp-server operation handler.
+ *
+ * 1. Read lockfile to determine if server is installed
+ * 2. Remove canonical directory from disk (if exists)
+ * 3. Remove lockfile + settings entry
+ */
+export declare const uninstallMcpServer: (op: UninstallMcpServerOperation) => Effect.Effect<JobStepResult, AppError, FileSystem.FileSystem | Path.Path | Workspace | CliRenderer | CodingAgentRepository>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/src/unstable/mcp-servers/operations/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/mcp-servers/operations/uninstall.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAOjE;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,SAAS,CACjD,sBAAsB,EACtB,+BAA+B,CAChC,CAAC;AAqJF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,CAC/B,EAAE,EAAE,2BAA2B,KAC5B,MAAM,CAAC,MAAM,CAChB,aAAa,EACb,QAAQ,EACR,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,qBAAqB,CAuDjF,CAAC"}