@agentxm/client-core 0.1.6

package/dist/src/unstable/commands/operations/publish.js

@@ -0,0 +1,120 @@
+/**
+ * Publish command executor — reads a command'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 Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import { REGISTRY_EXTENSIONS_DIR, parseFqn } from "../../extensions/index.js";
+import { COMMAND_MANIFEST_FILENAME, CommandManifestSchema, } 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-command operation handler.
+ *
+ * 1. Read and validate `command.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 publishCommand = (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, "commands", fqn.name);
+    const extensionDirExists = yield* fs
+        .exists(extensionDir)
+        .pipe(Effect.orElseSucceed(() => false));
+    if (!extensionDirExists) {
+        return yield* makeAppError({
+            code: "PUBLISH_COMMAND_NOT_FOUND",
+            what: `Managed extension not found: ${extensionDir}`,
+        });
+    }
+    // Read and validate manifest
+    const manifestPath = path.join(extensionDir, COMMAND_MANIFEST_FILENAME);
+    const manifestContent = yield* fs.readFileString(manifestPath).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_COMMAND_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_COMMAND_MANIFEST_PARSE_FAILED",
+            what: `Invalid JSON in manifest: ${manifestPath}`,
+            cause: e,
+        }),
+    });
+    const manifest = yield* Schema.decodeUnknownEffect(CommandManifestSchema)(manifestJson).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_COMMAND_MANIFEST_SCHEMA_INVALID",
+        what: `Invalid manifest schema: ${manifestPath}`,
+        cause: e,
+    })));
+    // Build zip archive from extension directory
+    const archive = yield* buildZipArchive(extensionDir, "PUBLISH_COMMAND_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_COMMAND_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_COMMAND_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: "command",
+        name: fqn.name,
+        version: manifest.version,
+        archive,
+        metadata: versionEntry,
+    })
+        .pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_COMMAND_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/commands/operations/publish.js.map

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

package/dist/src/unstable/commands/operations/shared-command-helpers.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Shared helpers for command operations (install, enable, uninstall).
+ *
+ * Extracts duplicated logic into reusable functions:
+ * - readCommandContent: COMMAND.md parsing + command.json reading
+ * - renderToAgents: agent rendering + result collection
+ * - checkInstalledOnDisk: scan disk for installed command files
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import { type CommandContentResult } from "../command-content.js";
+import type { CommandManifest } from "../manifest-schema.js";
+import type { LossyRenderingWarning } from "../rendering-warnings.js";
+import type { CommandSyncOutcome } from "../../agents/coding-agent.js";
+import { CodingAgentRepository } from "../../agents/index.js";
+/**
+ * Error code prefix for parameterizing error codes across callers.
+ */
+export type CommandErrorPrefix = "INSTALL_COMMAND" | "ENABLE_COMMAND";
+/**
+ * Result of reading command content from a canonical directory.
+ */
+export interface ReadCommandContentResult extends CommandContentResult {
+    readonly manifest: CommandManifest | undefined;
+}
+/**
+ * Read COMMAND.md and command.json from a canonical command directory.
+ *
+ * Parses COMMAND.md frontmatter and reads/validates command.json if present.
+ * The errorPrefix controls which error codes are used so callers retain
+ * distinct error identities.
+ */
+export declare const readCommandContent: (canonicalPath: string, errorPrefix: CommandErrorPrefix) => Effect.Effect<{
+    manifest: {
+        readonly name: string & import("effect/Brand").Brand<"ExtensionName">;
+        readonly version: string & import("effect/Brand").Brand<"ExactSemverVersion">;
+        readonly type: "command";
+        readonly owner: string & import("effect/Brand").Brand<"Handle">;
+        readonly description?: string | undefined;
+        readonly $schema?: string | undefined;
+        readonly agents?: readonly string[] | undefined;
+        readonly agentOverrides?: {
+            readonly [x: string]: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined;
+        readonly keywords?: readonly string[] | undefined;
+        readonly repository?: string | undefined;
+        readonly homepage?: string | undefined;
+        readonly license?: string | undefined;
+        readonly bugs?: string | undefined;
+        readonly authors?: readonly {
+            readonly name: string;
+            readonly email?: string | undefined;
+            readonly url?: string | undefined;
+        }[] | undefined;
+        readonly compatiblePackages?: readonly {
+            readonly name: string;
+            readonly type: string & import("effect/Brand").Brand<"PackageType">;
+            readonly namespace?: string | undefined;
+            readonly version?: string | undefined;
+        }[] | undefined;
+    } | undefined;
+    frontmatter: Option.Option<import("../command-content.js").CommandFrontmatter>;
+    body: string;
+}, import("../../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path>;
+/**
+ * Args for rendering a command to configured agents.
+ */
+export interface RenderToAgentsArgs {
+    readonly commandName: string;
+    readonly frontmatter: CommandContentResult["frontmatter"];
+    readonly body: string;
+    readonly manifest: CommandManifest | undefined;
+    /** Owner string for building an effective manifest when none exists. */
+    readonly owner: string;
+    readonly workspaceRoot: string;
+    readonly force: boolean;
+}
+/**
+ * Per-agent render outcome (success, skipped, unsupported, or conflict).
+ */
+export interface AgentRenderOutcome {
+    readonly agentId: string;
+    readonly outcome: CommandSyncOutcome;
+    readonly warnings: ReadonlyArray<LossyRenderingWarning>;
+}
+/**
+ * Aggregated result of rendering a command to all configured agents.
+ */
+export interface RenderToAgentsResult {
+    readonly outcomes: ReadonlyArray<AgentRenderOutcome>;
+    readonly successfulAgents: ReadonlyArray<string>;
+    readonly rawRenderedFiles: Record<string, Array<{
+        path: string;
+    }>>;
+}
+/**
+ * Render a command to all configured (and targeted) agents concurrently.
+ *
+ * Resolves agents from the repository, filters by manifest.agents if specified,
+ * selects per-agent renderers, and collects outcomes.
+ */
+export declare const renderToAgents: (args: RenderToAgentsArgs) => Effect.Effect<{
+    outcomes: ({
+        agentId: "adal" | "amp" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "crush" | "cursor" | "droid" | "gemini-cli" | "github-copilot" | "goose" | "iflow-cli" | "junie" | "kilo" | "kimi-cli" | "kiro-cli" | "kode" | "mcpjam" | "mistral-vibe" | "mux" | "neovate" | "openclaw" | "opencode" | "openhands" | "pi" | "pochi" | "qoder" | "qwen-code" | "replit" | "roo" | "trae" | "trae-cn" | "windsurf" | "zencoder";
+        outcome: CommandSyncOutcome;
+        warnings: readonly LossyRenderingWarning[];
+    } | {
+        agentId: "adal" | "amp" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "crush" | "cursor" | "droid" | "gemini-cli" | "github-copilot" | "goose" | "iflow-cli" | "junie" | "kilo" | "kimi-cli" | "kiro-cli" | "kode" | "mcpjam" | "mistral-vibe" | "mux" | "neovate" | "openclaw" | "opencode" | "openhands" | "pi" | "pochi" | "qoder" | "qwen-code" | "replit" | "roo" | "trae" | "trae-cn" | "windsurf" | "zencoder";
+        outcome: {
+            _tag: "unsupported";
+            reason: string;
+        };
+        warnings: readonly LossyRenderingWarning[];
+    })[];
+    successfulAgents: ("adal" | "amp" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "crush" | "cursor" | "droid" | "gemini-cli" | "github-copilot" | "goose" | "iflow-cli" | "junie" | "kilo" | "kimi-cli" | "kiro-cli" | "kode" | "mcpjam" | "mistral-vibe" | "mux" | "neovate" | "openclaw" | "opencode" | "openhands" | "pi" | "pochi" | "qoder" | "qwen-code" | "replit" | "roo" | "trae" | "trae-cn" | "windsurf" | "zencoder")[];
+    rawRenderedFiles: Record<string, {
+        path: string;
+    }[]>;
+}, import("../../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path | import("../../workspace/service-interface.ts").Workspace | CodingAgentRepository>;
+/**
+ * Check whether a command exists on disk in any known extension directory.
+ *
+ * Scans both registry extensions dirs (per-owner scope dirs under
+ * `.axm/extensions/`) and the external extensions dir.
+ */
+export declare const checkInstalledOnDisk: (fsService: FileSystem.FileSystem, pathService: Path.Path, baseDir: string, commandName: string) => Effect.Effect<boolean, never, never>;
+//# sourceMappingURL=shared-command-helpers.d.ts.map

package/dist/src/unstable/commands/operations/shared-command-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-command-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/commands/operations/shared-command-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAe,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAS9D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;CAChD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,eAAe,MAAM,EAAE,aAAa,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sFAyDrF,CAAC;AAML;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IAC/C,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACrD,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACpE;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,kBAAkB;;;;;;;;;;;;;;;cA0EE,MAAM;;yKAK3D,CAAC;AAML;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,WAAW,UAAU,CAAC,UAAU,EAChC,aAAa,IAAI,CAAC,IAAI,EACtB,SAAS,MAAM,EACf,aAAa,MAAM,yCAmCjB,CAAC"}

package/dist/src/unstable/commands/operations/shared-command-helpers.js

@@ -0,0 +1,172 @@
+/**
+ * Shared helpers for command operations (install, enable, uninstall).
+ *
+ * Extracts duplicated logic into reusable functions:
+ * - readCommandContent: COMMAND.md parsing + command.json reading
+ * - renderToAgents: agent rendering + result collection
+ * - checkInstalledOnDisk: scan disk for installed command files
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import { makeAppError } from "../../app-error/index.js";
+import { parseCommandMd } from "../command-content.js";
+import { COMMAND_MANIFEST_FILENAME, CommandManifestSchema } from "../manifest-schema.js";
+import { selectRenderer } from "../renderers/index.js";
+import { CodingAgentRepository } from "../../agents/index.js";
+import { REGISTRY_EXTENSIONS_DIR, EXTERNAL_EXTENSIONS_DIR } from "../../extensions/index.js";
+import { decodeExtensionNameSync, decodeHandleSync } from "../../extensions/index.js";
+import { decodeExactSemverVersionSync } from "../../version-constraints/version-constraints.js";
+/**
+ * Read COMMAND.md and command.json from a canonical command directory.
+ *
+ * Parses COMMAND.md frontmatter and reads/validates command.json if present.
+ * The errorPrefix controls which error codes are used so callers retain
+ * distinct error identities.
+ */
+export const readCommandContent = (canonicalPath, errorPrefix) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    // Read COMMAND.md
+    const commandMdPath = path.join(canonicalPath, "COMMAND.md");
+    const commandMdExists = yield* fs
+        .exists(commandMdPath)
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    let frontmatter;
+    if (commandMdExists) {
+        const content = yield* fs.readFileString(commandMdPath).pipe(Effect.mapError((e) => makeAppError({
+            code: `${errorPrefix}_READ_FAILED`,
+            what: `Failed to read COMMAND.md at ${commandMdPath}`,
+            cause: e,
+        })));
+        frontmatter = yield* parseCommandMd(content);
+    }
+    else {
+        frontmatter = { frontmatter: Option.none(), body: "" };
+    }
+    // Read command.json
+    const manifestPath = path.join(canonicalPath, COMMAND_MANIFEST_FILENAME);
+    const manifestExists = yield* fs
+        .exists(manifestPath)
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    let manifest;
+    if (manifestExists) {
+        const manifestContent = yield* fs.readFileString(manifestPath).pipe(Effect.mapError((e) => makeAppError({
+            code: `${errorPrefix}_READ_FAILED`,
+            what: `Failed to read ${COMMAND_MANIFEST_FILENAME} at ${manifestPath}`,
+            cause: e,
+        })));
+        manifest = yield* Effect.try({
+            try: () => Schema.decodeUnknownSync(CommandManifestSchema)(JSON.parse(manifestContent)),
+            catch: (error) => makeAppError({
+                code: `${errorPrefix}_MANIFEST_INVALID`,
+                what: `Invalid ${COMMAND_MANIFEST_FILENAME} at ${manifestPath}`,
+                details: [error instanceof Error ? error.message : String(error)],
+                cause: error,
+            }),
+        });
+    }
+    return { ...frontmatter, manifest };
+});
+/**
+ * Render a command to all configured (and targeted) agents concurrently.
+ *
+ * Resolves agents from the repository, filters by manifest.agents if specified,
+ * selects per-agent renderers, and collects outcomes.
+ */
+export const renderToAgents = (args) => Effect.gen(function* () {
+    const agentRepo = yield* CodingAgentRepository;
+    // Resolve agents
+    const configuredAgents = yield* agentRepo.getConfiguredAgents();
+    const targetAgents = args.manifest?.agents
+        ? configuredAgents.filter((agent) => args.manifest?.agents?.includes(agent.id))
+        : configuredAgents;
+    // Build effective manifest
+    const rendererFrontmatter = Option.getOrElse(args.frontmatter, () => ({}));
+    const effectiveManifest = args.manifest ?? {
+        type: "command",
+        name: decodeExtensionNameSync(args.commandName),
+        owner: decodeHandleSync(args.owner),
+        version: decodeExactSemverVersionSync("0.0.0"),
+    };
+    // Render to agents concurrently
+    const outcomes = yield* Effect.forEach(targetAgents, (agent) => {
+        const agentOverrides = args.manifest?.agentOverrides?.[agent.id];
+        const rendererFn = selectRenderer(agent.id);
+        const renderOutput = rendererFn({
+            frontmatter: rendererFrontmatter,
+            body: args.body,
+            agentId: agent.id,
+            commandName: args.commandName,
+            ...(agentOverrides !== undefined ? { agentOverrides } : {}),
+        });
+        return agent
+            .addCommand({
+            workspaceRoot: args.workspaceRoot,
+            scope: "project",
+            commandName: args.commandName,
+            frontmatter: args.frontmatter,
+            body: renderOutput.content,
+            manifest: effectiveManifest,
+            agentOverrides: Option.fromUndefinedOr(agentOverrides),
+            force: args.force,
+        })
+            .pipe(Effect.map((outcome) => ({
+            agentId: agent.id,
+            outcome,
+            warnings: renderOutput.warnings,
+        })), Effect.catch((err) => {
+            const emptyWarnings = [];
+            return Effect.succeed({
+                agentId: agent.id,
+                outcome: {
+                    _tag: "unsupported",
+                    reason: `Agent addCommand failed: ${err.what}`,
+                },
+                warnings: emptyWarnings,
+            });
+        }));
+    }, { concurrency: "unbounded" });
+    // Collect results
+    const successOutcomes = outcomes.flatMap((r) => r.outcome._tag === "success" ? [{ agentId: r.agentId, outcome: r.outcome }] : []);
+    const successfulAgents = successOutcomes.map((r) => r.agentId);
+    const rawRenderedFiles = Object.fromEntries(successOutcomes.map((r) => [r.agentId, [{ path: r.outcome.renderedFilePath }]]));
+    return { outcomes, successfulAgents, rawRenderedFiles };
+});
+// -----------------------------------------------------------------------------
+// checkInstalledOnDisk
+// -----------------------------------------------------------------------------
+/**
+ * Check whether a command exists on disk in any known extension directory.
+ *
+ * Scans both registry extensions dirs (per-owner scope dirs under
+ * `.axm/extensions/`) and the external extensions dir.
+ */
+export const checkInstalledOnDisk = (fsService, pathService, baseDir, commandName) => Effect.gen(function* () {
+    // Check registry extensions dirs
+    const extensionsDir = pathService.join(baseDir, REGISTRY_EXTENSIONS_DIR);
+    const extensionsDirExists = yield* fsService
+        .exists(extensionsDir)
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    if (extensionsDirExists) {
+        const scopeDirs = yield* fsService
+            .readDirectory(extensionsDir)
+            .pipe(Effect.catch(() => Effect.succeed([])));
+        const results = yield* Effect.forEach(scopeDirs, (scopeDir) => {
+            if (!scopeDir.startsWith("@"))
+                return Effect.succeed(false);
+            const cmdPath = pathService.join(extensionsDir, scopeDir, "commands", commandName);
+            return fsService.exists(cmdPath).pipe(Effect.catch(() => Effect.succeed(false)));
+        }, { concurrency: "unbounded" });
+        if (results.some((exists) => exists))
+            return true;
+    }
+    // Check external extensions dir
+    const externalPath = pathService.join(baseDir, EXTERNAL_EXTENSIONS_DIR, "commands", commandName);
+    return yield* fsService.exists(externalPath).pipe(Effect.catch(() => Effect.succeed(false)));
+});
+//# sourceMappingURL=shared-command-helpers.js.map

package/dist/src/unstable/commands/operations/shared-command-helpers.js.map

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

package/dist/src/unstable/commands/operations/uninstall.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Uninstall command executor — orchestrates per-command removal pipeline.
+ *
+ * Pipeline: read lockfile -> remove rendered files from agents -> remove
+ * canonical dir -> remove lockfile/settings entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { type AppError } from "../../app-error/index.js";
+import type { JobStepResult, Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { CodingAgentRepository } from "../../agents/index.js";
+/**
+ * Args for the uninstall-command operation.
+ */
+export interface UninstallCommandOperationArgs {
+    readonly commandName: string;
+}
+/**
+ * Remove a command from the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type UninstallCommandOperation = Operation<"uninstall-command", UninstallCommandOperationArgs>;
+/**
+ * Uninstall-command operation handler.
+ *
+ * 1. Read lockfile to determine if command is installed
+ * 2. Remove rendered files from agents (using renderedFiles from lockfile)
+ * 3. Remove canonical directory from disk (if exists)
+ * 4. Remove lockfile + settings entry
+ */
+export declare const uninstallCommand: (op: UninstallCommandOperation) => Effect.Effect<JobStepResult, AppError, FileSystem.FileSystem | Path.Path | Workspace | CodingAgentRepository>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/src/unstable/commands/operations/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/commands/operations/uninstall.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,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;AAEjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAO9D;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,CAC/C,mBAAmB,EACnB,6BAA6B,CAC9B,CAAC;AAMF;;;;;;;GAOG;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,qBAAqB,CAqFnE,CAAC"}

package/dist/src/unstable/commands/operations/uninstall.js

@@ -0,0 +1,108 @@
+/**
+ * Uninstall command executor — orchestrates per-command removal pipeline.
+ *
+ * Pipeline: read lockfile -> remove rendered files from agents -> remove
+ * canonical dir -> remove lockfile/settings entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { REGISTRY_EXTENSIONS_DIR, EXTERNAL_EXTENSIONS_DIR } from "../../extensions/index.js";
+import { CodingAgentRepository } from "../../agents/index.js";
+import { checkInstalledOnDisk } from "./shared-command-helpers.js";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Uninstall-command operation handler.
+ *
+ * 1. Read lockfile to determine if command is installed
+ * 2. Remove rendered files from agents (using renderedFiles from lockfile)
+ * 3. Remove canonical directory from disk (if exists)
+ * 4. Remove lockfile + settings entry
+ */
+export const uninstallCommand = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const agentRepo = yield* CodingAgentRepository;
+    const base = ws.baseDir;
+    const lockEntryOption = yield* ws.getLockedCommand(op.args.commandName).pipe(Effect.mapError((e) => makeAppError({
+        code: "UNINSTALL_COMMAND_LOCKFILE_READ_FAILED",
+        what: `Failed to read lockfile: ${e.what}`,
+        cause: e,
+    })));
+    const lockEntry = Option.getOrUndefined(lockEntryOption);
+    // Check if command exists on disk (scan registry extensions dir for any owner)
+    const installedOnDisk = yield* checkInstalledOnDisk(fs, path, base, op.args.commandName);
+    if (!lockEntry && !installedOnDisk) {
+        return { result: "success", message: "not installed" };
+    }
+    // --- Remove rendered files from agents ---
+    if (lockEntry?.renderedFiles) {
+        const renderedFiles = lockEntry.renderedFiles;
+        yield* Effect.forEach(Object.entries(renderedFiles), ([_agentId, files]) => Effect.forEach(files, (file) => fs.remove(file.path, { recursive: true }).pipe(Effect.catch(() => Effect.void)), { concurrency: "unbounded" }), { concurrency: "unbounded" });
+    }
+    else if (lockEntry?.agents && lockEntry.agents.length > 0) {
+        // Fallback: remove via agent removeCommand
+        const configuredAgents = yield* agentRepo.getConfiguredAgents();
+        yield* Effect.forEach(configuredAgents, (agent) => agent
+            .removeCommand({
+            workspaceRoot: base,
+            scope: "project",
+            commandName: op.args.commandName,
+        })
+            .pipe(Effect.catch(() => Effect.void)), { concurrency: "unbounded" });
+    }
+    // --- Remove canonical directory ---
+    if (lockEntry?.type === "registry") {
+        const canonicalPath = path.join(base, REGISTRY_EXTENSIONS_DIR, lockEntry.owner, "commands", lockEntry.name);
+        yield* fs.remove(canonicalPath, { recursive: true }).pipe(Effect.catch(() => Effect.void));
+    }
+    else if (installedOnDisk) {
+        // Remove from all known locations
+        yield* removeFromAllCommandLocations(fs, path, base, op.args.commandName);
+    }
+    // Remove from external extensions dir too
+    const externalPath = path.join(base, EXTERNAL_EXTENSIONS_DIR, "commands", op.args.commandName);
+    yield* fs.remove(externalPath, { recursive: true }).pipe(Effect.catch(() => Effect.void));
+    // Remove from settings + lockfile (swallow errors)
+    yield* ws.removeCommand(op.args.commandName).pipe(Effect.catch(() => Effect.void));
+    return {
+        result: "success",
+        message: `Uninstalled ${op.args.commandName}`,
+    };
+});
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+const removeFromAllCommandLocations = (fsService, pathService, base, commandName) => Effect.gen(function* () {
+    const extensionsDir = pathService.join(base, REGISTRY_EXTENSIONS_DIR);
+    const extensionsDirExists = yield* fsService
+        .exists(extensionsDir)
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    if (extensionsDirExists) {
+        const scopeDirs = yield* fsService
+            .readDirectory(extensionsDir)
+            .pipe(Effect.catch(() => Effect.succeed([])));
+        yield* Effect.forEach(scopeDirs, (scopeDir) => {
+            if (!scopeDir.startsWith("@"))
+                return Effect.void;
+            const cmdPath = pathService.join(extensionsDir, scopeDir, "commands", commandName);
+            return fsService
+                .remove(cmdPath, { recursive: true })
+                .pipe(Effect.catch(() => Effect.void));
+        }, { concurrency: "unbounded" });
+    }
+    // Also remove from external
+    const externalPath = pathService.join(base, EXTERNAL_EXTENSIONS_DIR, "commands", commandName);
+    yield* fsService
+        .remove(externalPath, { recursive: true })
+        .pipe(Effect.catch(() => Effect.void));
+});
+//# sourceMappingURL=uninstall.js.map

package/dist/src/unstable/commands/operations/uninstall.js.map

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

package/dist/src/unstable/commands/reconciliation-adapter.d.ts

@@ -0,0 +1,3 @@
+import type { ReconciliationAdapter } from "../workspace/reconciliation-types.js";
+export declare const commandReconciliationAdapter: ReconciliationAdapter;
+//# sourceMappingURL=reconciliation-adapter.d.ts.map

package/dist/src/unstable/commands/reconciliation-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-adapter.d.ts","sourceRoot":"","sources":["../../../../src/unstable/commands/reconciliation-adapter.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,sCAAsC,CAAC;AAyB9C,eAAO,MAAM,4BAA4B,EAAE,qBAoJ1C,CAAC"}