axm.sh 0.1.6

package/dist/src/root/commands/enable.js

@@ -0,0 +1,101 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Option from "effect/Option";
+import { Argument, Command, Flag } from "effect/unstable/cli";
+import * as Effect from "effect/Effect";
+import { makeAppError } from "@agentxm/client-core/unstable/app-error";
+import { CodingAgentRepository } from "@agentxm/client-core/unstable/agents";
+import { decodeExtensionNameSync, } from "@agentxm/client-core/unstable/extensions";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+import { enableCommand as runEnableCommand } from "@agentxm/client-core/unstable/commands";
+import { forceFlag, previewFlag, yesFlag } from "@agentxm/client-core/unstable/cli-flags";
+import { withArgvTracking } from "@agentxm/client-core/unstable/cli-runtime";
+import { previewOrApplyPlan } from "@agentxm/client-core/unstable/workspace";
+import { emitNoOpResult, emitPlanResolutionResult } from "../../json-output.js";
+import { withRuntime, withWorkspace } from "../../runtime.js";
+import { scopeFlag } from "../../cli-flags.js";
+import { toJobStepResult } from "./job-step-result.js";
+import { combinePlanSections, makeAgentSection } from "./preview-sections.js";
+export const handleEnableCommand = Effect.fn("EnableCommand.handle")(function* (args) {
+    const ws = yield* Workspace;
+    const renderer = yield* CliRenderer;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const agentRepo = yield* CodingAgentRepository;
+    yield* renderer.info("axm commands enable");
+    // Load installed commands (configured + implicit) -- taxonomy lifecycle view
+    const installedCommands = yield* ws.getInstalledCommands();
+    const entry = installedCommands[args.name];
+    // Validate: command is installed (ignored names are excluded from installed)
+    if (entry === undefined) {
+        return yield* makeAppError({
+            code: "COMMAND_NOT_FOUND",
+            what: `Command '${args.name}' is not installed`,
+            howToFix: "Run `axm commands list` to see available commands",
+        });
+    }
+    // Validate: command is currently disabled
+    if (entry.enabled) {
+        if (yield* emitNoOpResult("commands.enable", {
+            planName: "Enable command",
+            planDescription: `Enable ${args.name}`,
+            message: `Command '${args.name}' is already enabled`,
+        })) {
+            return;
+        }
+        yield* renderer.info(`Command '${args.name}' is already enabled`);
+        yield* renderer.success("Nothing to do.");
+        return;
+    }
+    const lockedEntry = yield* ws.getLockedCommand(args.name);
+    const configuredAgentIds = Option.isSome(lockedEntry) ? [] : yield* ws.getConfiguredAgents();
+    const planSections = Option.isSome(lockedEntry)
+        ? combinePlanSections(makeAgentSection("Would re-render to agents", lockedEntry.value.agents, "(no agents recorded)"))
+        : combinePlanSections(makeAgentSection("Would render to configured agents", configuredAgentIds, "(no agents configured)"));
+    // Build operation
+    const op = {
+        name: "enable-command",
+        args: { commandName: args.name },
+    };
+    // Build plan with inline run closure
+    const step = {
+        readiness: "ready",
+        label: args.name,
+        run: runEnableCommand(op).pipe(Effect.map(toJobStepResult), Effect.provideService(Workspace, ws), Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(Path.Path, path), Effect.provideService(CodingAgentRepository, agentRepo)),
+    };
+    const plan = {
+        _tag: "Plan",
+        name: "Enable command",
+        description: Option.some(`Enable ${args.name}`),
+        jobs: [{ concurrency: 1, steps: [step] }],
+        ...(planSections === undefined ? {} : { sections: planSections }),
+    };
+    const resolution = yield* previewOrApplyPlan(plan, {
+        yes: args.yes,
+        force: args.force,
+        preview: args.preview,
+    });
+    yield* emitPlanResolutionResult("commands.enable", resolution);
+    if (resolution._tag === "ExecutedPlan") {
+        yield* renderer.success("Done");
+    }
+});
+const enableConfig = {
+    name: Argument.string("name").pipe(Argument.withDescription("Name of the command to enable")),
+    scope: scopeFlag.pipe(Flag.withDescription("Enable in project (default) or user-level configuration")),
+    yes: yesFlag.pipe(Flag.withDescription("Enable without confirmation")),
+    force: forceFlag.pipe(Flag.withDescription("Enable even if the command has unresolved dependencies")),
+    preview: previewFlag.pipe(Flag.withDescription("Show what would change without enabling")),
+};
+export const enableCommand = Command.make("enable", enableConfig, ({ name, scope, yes, force, preview }) => handleEnableCommand({ name: decodeExtensionNameSync(name), yes, force, preview }).pipe(withWorkspace(scope), withRuntime("commands enable"))).pipe(withArgvTracking(enableConfig), Command.withDescription("Enable a previously disabled command"), Command.withExamples([
+    {
+        command: "axm commands enable my-cmd",
+        description: "Re-enable a command you previously disabled",
+    },
+    {
+        command: "axm commands enable my-cmd --preview",
+        description: "Preview the change before enabling",
+    },
+]));
+//# sourceMappingURL=enable.js.map

package/dist/src/root/commands/enable.js.map

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

package/dist/src/root/commands/install/command-actions.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Command install workflow actions service.
+ *
+ * Implements InstallExtensionCommandWorkflowActions for commands.
+ * Commands are registry-only, similar to packs.
+ * The live layer captures all required services at construction time
+ * so action methods satisfy the `R = never` contract.
+ *
+ * TODO: (#54) This file shares nearly identical structure with
+ * skills/install/command-actions.ts, mcp-servers/install/command-actions.ts,
+ * and skills/uninstall/command-actions.ts (layer construction, provide helper,
+ * parseArgs, plan building). Consider a generic factory parameterized by
+ * extension type.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as ServiceMap from "effect/ServiceMap";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { ExtensionName, Handle } from "@agentxm/client-core/unstable/extensions";
+import type { VersionConstraint } from "@agentxm/client-core/unstable/version-constraints";
+import type { RegistrySource } from "@agentxm/client-core/unstable/sources";
+import { SourceHostProviders } from "@agentxm/client-core/unstable/source-resolution";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+import { CommandManager, type CommandExtensionRef } from "@agentxm/client-core/unstable/commands";
+import type { InstallExtensionCommandWorkflowActions } from "@agentxm/client-core/unstable/workflows";
+import type { InstallCommandCommandIntent } from "./intent.js";
+export interface InstallCommandHandlerArgs {
+    readonly source: string;
+    /** Auto-accept confirmation prompts. */
+    readonly yes: boolean;
+    /** Override constraints that would cause failure. */
+    readonly force: boolean;
+    /** Display plan without applying. */
+    readonly preview: boolean;
+}
+export interface ParsedCommandInstallArgs {
+    readonly owner: Handle;
+    readonly commandName: ExtensionName;
+    readonly versionConstraint: Option.Option<VersionConstraint>;
+    readonly resolvedInput: string;
+    readonly force: boolean;
+}
+export interface CommandInstallSourceRequest {
+    readonly source: RegistrySource;
+    readonly owner: Handle;
+    readonly commandName: ExtensionName;
+    readonly versionConstraint: Option.Option<VersionConstraint>;
+}
+declare const InstallCommandCommandWorkflowActions_base: ServiceMap.ServiceClass<InstallCommandCommandWorkflowActions, "axm.sh/InstallCommandCommandWorkflowActions", InstallExtensionCommandWorkflowActions<InstallCommandHandlerArgs, ParsedCommandInstallArgs, CommandInstallSourceRequest, CommandExtensionRef, InstallCommandCommandIntent>>;
+export declare class InstallCommandCommandWorkflowActions extends InstallCommandCommandWorkflowActions_base {
+}
+/**
+ * Constructs the actions by resolving all services at layer-build time.
+ * Each action method closes over the captured services so `R = never`.
+ */
+export declare const InstallCommandCommandWorkflowActionsLive: Layer.Layer<InstallCommandCommandWorkflowActions, never, FileSystem.FileSystem | Path.Path | Workspace | SourceHostProviders | CommandManager>;
+export {};
+//# sourceMappingURL=command-actions.d.ts.map

package/dist/src/root/commands/install/command-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-actions.d.ts","sourceRoot":"","sources":["../../../../../src/root/commands/install/command-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAEL,mBAAmB,EACpB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EACL,cAAc,EAEd,KAAK,mBAAmB,EACzB,MAAM,wCAAwC,CAAC;AAGhD,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,yCAAyC,CAAC;AACtG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAQ/D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAMD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC7D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAMD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;CAC9D;;AAMD,qBAAa,oCAAqC,SAAQ,yCASR;CAAG;AAMrD;;;GAGG;AACH,eAAO,MAAM,wCAAwC,gJAuOpD,CAAC"}

package/dist/src/root/commands/install/command-actions.js

@@ -0,0 +1,211 @@
+/**
+ * Command install workflow actions service.
+ *
+ * Implements InstallExtensionCommandWorkflowActions for commands.
+ * Commands are registry-only, similar to packs.
+ * The live layer captures all required services at construction time
+ * so action methods satisfy the `R = never` contract.
+ *
+ * TODO: (#54) This file shares nearly identical structure with
+ * skills/install/command-actions.ts, mcp-servers/install/command-actions.ts,
+ * and skills/uninstall/command-actions.ts (layer construction, provide helper,
+ * parseArgs, plan building). Consider a generic factory parameterized by
+ * extension type.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as ServiceMap from "effect/ServiceMap";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Result from "effect/Result";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { makeAppError } from "@agentxm/client-core/unstable/app-error";
+import { resolveSource, SourceHostProviders, } from "@agentxm/client-core/unstable/source-resolution";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+import { CommandManager, selectRenderer, } from "@agentxm/client-core/unstable/commands";
+import { buildInstallOperation } from "@agentxm/client-core/unstable/extensions";
+import { parseRegistryInstallTarget } from "../../shared/registry-install-target.js";
+import { combinePlanSections, makeAgentSection, makeGroupedSection } from "../preview-sections.js";
+// -----------------------------------------------------------------------------
+// Service Tag
+// -----------------------------------------------------------------------------
+export class InstallCommandCommandWorkflowActions extends ServiceMap.Service()("axm.sh/InstallCommandCommandWorkflowActions") {
+}
+// -----------------------------------------------------------------------------
+// Live Layer
+// -----------------------------------------------------------------------------
+/**
+ * Constructs the actions by resolving all services at layer-build time.
+ * Each action method closes over the captured services so `R = never`.
+ */
+export const InstallCommandCommandWorkflowActionsLive = Layer.effect(InstallCommandCommandWorkflowActions, Effect.gen(function* () {
+    const sources = yield* SourceHostProviders;
+    const ws = yield* Workspace;
+    const commandMgr = yield* CommandManager;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    // Build a service layer to provide to inner effects that still require
+    // services via the Effect context (e.g. resolveSource).
+    const envLayer = Layer.mergeAll(Layer.succeed(SourceHostProviders, sources), Layer.succeed(Workspace, ws), Layer.succeed(FileSystem.FileSystem, fs), Layer.succeed(Path.Path, path));
+    const provide = (effect) => Effect.provide(effect, envLayer);
+    const parseArgs = (args) => Effect.gen(function* () {
+        const trimmed = args.source.trim();
+        const parsed = parseRegistryInstallTarget(trimmed, {
+            expectedType: "command",
+            allowBareName: true,
+        });
+        if (Result.isSuccess(parsed)) {
+            if (parsed.success.kind === "registry") {
+                return {
+                    owner: parsed.success.owner,
+                    commandName: parsed.success.name,
+                    versionConstraint: Option.fromUndefinedOr(parsed.success.versionConstraint),
+                    resolvedInput: trimmed,
+                    force: false,
+                };
+            }
+            const owner = yield* ws.getConfiguredProfile();
+            return {
+                owner,
+                commandName: parsed.success.name,
+                versionConstraint: Option.none(),
+                resolvedInput: `${owner}/commands/${parsed.success.name}`,
+                force: false,
+            };
+        }
+        switch (parsed.failure.kind) {
+            case "wrong-type":
+                return yield* makeAppError({
+                    code: "COMMAND_SOURCE_INVALID_FORMAT",
+                    what: "Command source must include /commands/ segment",
+                    details: [`Provided: ${trimmed}`],
+                    howToFix: "Use @owner/commands/command-name format.",
+                });
+            case "missing-name":
+                return yield* makeAppError({
+                    code: "COMMAND_SOURCE_MISSING_NAME",
+                    what: "Command source must include a command name",
+                    details: [`Provided: ${trimmed}`],
+                    howToFix: "Use @owner/commands/command-name format.",
+                });
+            default:
+                return yield* makeAppError({
+                    code: "COMMAND_SOURCE_NOT_REGISTRY",
+                    what: "Commands can only be installed from a registry",
+                    details: [`Provided: ${trimmed}`],
+                    howToFix: "Use @owner/commands/command-name or just command-name.",
+                });
+        }
+    });
+    const resolveSourceRequests = (parsed) => provide(Effect.gen(function* () {
+        const source = yield* resolveSource(parsed.resolvedInput).pipe(Effect.mapError((error) => makeAppError({
+            code: "INVALID_SOURCE",
+            what: `Invalid source: ${error.message}`,
+            details: [`Provided: ${parsed.resolvedInput}`],
+            howToFix: "Use @owner/commands/command-name or just command-name.",
+            cause: error,
+        })));
+        if (source.type !== "registry") {
+            return yield* makeAppError({
+                code: "COMMAND_SOURCE_NOT_REGISTRY",
+                what: "Commands can only be installed from a registry",
+                details: [`Provided source type: ${source.type}`],
+                howToFix: "Use a registry source: @owner/commands/command-name",
+            });
+        }
+        return [
+            {
+                source,
+                owner: parsed.owner,
+                commandName: parsed.commandName,
+                versionConstraint: parsed.versionConstraint,
+            },
+        ];
+    }));
+    const discoverRefs = (reqs) => Effect.scoped(Effect.gen(function* () {
+        const allRefs = yield* Effect.forEach(reqs, (req) => sources
+            .find(req.source, {
+            names: [req.commandName],
+            type: "command",
+            owner: Option.some(req.owner),
+            versionConstraint: req.versionConstraint,
+        })
+            .pipe(Effect.mapError((error) => makeAppError({
+            code: "COMMAND_FETCH_FAILED",
+            what: "Failed to fetch command from registry",
+            details: [`Command: ${req.owner}/commands/${req.commandName}`],
+            howToFix: "Verify the command name and registry configuration.",
+            cause: error,
+        }))), { concurrency: "unbounded" });
+        return allRefs.flat().filter((ref) => ref.type === "command");
+    }));
+    const finalizeIntent = (parsed, refs) => Effect.gen(function* () {
+        if (refs.length === 0) {
+            return yield* makeAppError({
+                code: "COMMAND_NOT_FOUND",
+                what: `Command "${parsed.commandName}" not found in registry`,
+                howToFix: "Verify the command name and check available commands.",
+            });
+        }
+        const [ref] = refs;
+        if (ref === undefined) {
+            return yield* makeAppError({
+                code: "COMMAND_NOT_FOUND",
+                what: `Command "${parsed.commandName}" not found in registry`,
+                howToFix: "Verify the command name and check available commands.",
+            });
+        }
+        return {
+            ref,
+            versionConstraint: parsed.versionConstraint,
+            force: parsed.force,
+        };
+    });
+    const buildPlan = (intent) => Effect.gen(function* () {
+        const configuredAgents = yield* ws.getConfiguredAgents();
+        const warningsByAgent = {};
+        for (const agentId of configuredAgents) {
+            const rendererFn = selectRenderer(agentId);
+            const output = rendererFn({
+                frontmatter: {},
+                body: "",
+                agentId,
+                commandName: intent.ref.command.name,
+            });
+            const warnings = output.warnings
+                .filter((warning) => warning.feature && warning.message)
+                .map((warning) => `${warning.feature} - ${warning.message}`);
+            if (warnings.length > 0) {
+                warningsByAgent[agentId] = warnings;
+            }
+        }
+        const sections = combinePlanSections(makeAgentSection("Target agents", configuredAgents, "No agents configured. No files would be rendered."), makeGroupedSection("Potential rendering warnings", warningsByAgent));
+        return {
+            _tag: "Plan",
+            name: "Install command",
+            description: Option.some(`Install command ${intent.ref.command.name}`),
+            jobs: [
+                {
+                    concurrency: 1,
+                    steps: [
+                        buildInstallOperation(commandMgr, {
+                            ref: intent.ref,
+                            versionConstraint: intent.versionConstraint,
+                        }),
+                    ],
+                },
+            ],
+            ...(sections === undefined ? {} : { sections }),
+        };
+    });
+    return {
+        parseArgs,
+        resolveSourceRequests,
+        discoverRefs,
+        finalizeIntent,
+        buildPlan,
+    };
+}));
+//# sourceMappingURL=command-actions.js.map

package/dist/src/root/commands/install/command-actions.js.map

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

package/dist/src/root/commands/install/command.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "effect/unstable/cli";
+export declare const installCommand: Command.Command<"install", Record<string, unknown>, {}, never, "effect/unstable/cli/GlobalFlag/axm-non-interactive" | "effect/unstable/cli/GlobalFlag/axm-json" | "effect/unstable/cli/GlobalFlag/axm-quiet" | "effect/unstable/cli/GlobalFlag/axm-verbose" | "effect/unstable/cli/GlobalFlag/axm-debug">;
+//# sourceMappingURL=command.d.ts.map

package/dist/src/root/commands/install/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../src/root/commands/install/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,OAAO,EAAQ,MAAM,qBAAqB,CAAC;AAuB9D,eAAO,MAAM,cAAc,2SA6B1B,CAAC"}

package/dist/src/root/commands/install/command.js

@@ -0,0 +1,32 @@
+import { Argument, Command, Flag } from "effect/unstable/cli";
+import { forceFlag, previewFlag, yesFlag } from "@agentxm/client-core/unstable/cli-flags";
+import { withArgvTracking } from "@agentxm/client-core/unstable/cli-runtime";
+import { scopeFlag } from "../../../cli-flags.js";
+import { handleInstallCommand } from "./handler.js";
+import { withRuntime, withWorkspace } from "../../../runtime.js";
+const installConfig = {
+    source: Argument.string("source").pipe(Argument.withDescription("Registry command reference (@owner/commands/name or bare name)"), Argument.optional),
+    scope: scopeFlag.pipe(Flag.withDescription("Install to project (default) or user-level configuration")),
+    yes: yesFlag.pipe(Flag.withDescription("Skip confirmation after reviewing the install plan")),
+    force: forceFlag.pipe(Flag.withDescription("Reinstall even if the command already exists")),
+    preview: previewFlag.pipe(Flag.withDescription("Show what would be installed without making changes")),
+};
+export const installCommand = Command.make("install", installConfig, ({ source, scope, yes, force, preview }) => handleInstallCommand({ source, yes, force, preview }).pipe(withWorkspace(scope), withRuntime("commands install"))).pipe(withArgvTracking(installConfig), Command.withDescription("Install configured commands, or install a command from a registry"), Command.withExamples([
+    {
+        command: "axm commands install",
+        description: "Install all configured commands",
+    },
+    {
+        command: "axm commands install @acme/commands/my-cmd",
+        description: "Add a command from the registry",
+    },
+    {
+        command: "axm commands install my-cmd",
+        description: "Install using your default owner",
+    },
+    {
+        command: "axm commands install @acme/commands/my-cmd --preview",
+        description: "See what would be installed first",
+    },
+]));
+//# sourceMappingURL=command.js.map

package/dist/src/root/commands/install/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../../../src/root/commands/install/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,aAAa,GAAG;IACpB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CACpC,QAAQ,CAAC,eAAe,CAAC,gEAAgE,CAAC,EAC1F,QAAQ,CAAC,QAAQ,CAClB;IACD,KAAK,EAAE,SAAS,CAAC,IAAI,CACnB,IAAI,CAAC,eAAe,CAAC,0DAA0D,CAAC,CACjF;IACD,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,oDAAoD,CAAC,CAAC;IAC7F,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,8CAA8C,CAAC,CAAC;IAC3F,OAAO,EAAE,WAAW,CAAC,IAAI,CACvB,IAAI,CAAC,eAAe,CAAC,qDAAqD,CAAC,CAC5E;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CACxC,SAAS,EACT,aAAa,EACb,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CACzC,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CACxD,aAAa,CAAC,KAAK,CAAC,EACpB,WAAW,CAAC,kBAAkB,CAAC,CAChC,CACJ,CAAC,IAAI,CACJ,gBAAgB,CAAC,aAAa,CAAC,EAC/B,OAAO,CAAC,eAAe,CAAC,mEAAmE,CAAC,EAC5F,OAAO,CAAC,YAAY,CAAC;IACnB;QACE,OAAO,EAAE,sBAAsB;QAC/B,WAAW,EAAE,iCAAiC;KAC/C;IACD;QACE,OAAO,EAAE,4CAA4C;QACrD,WAAW,EAAE,iCAAiC;KAC/C;IACD;QACE,OAAO,EAAE,6BAA6B;QACtC,WAAW,EAAE,kCAAkC;KAChD;IACD;QACE,OAAO,EAAE,sDAAsD;QAC/D,WAAW,EAAE,mCAAmC;KACjD;CACF,CAAC,CACH,CAAC"}

package/dist/src/root/commands/install/handler.d.ts

@@ -0,0 +1,11 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { InstallCommandCommandWorkflowActions } from "./command-actions.js";
+export interface CommandInstallHandlerArgs {
+    readonly source: Option.Option<string>;
+    readonly yes: boolean;
+    readonly force: boolean;
+    readonly preview: boolean;
+}
+export declare const handleInstallCommand: (args: CommandInstallHandlerArgs) => Effect.Effect<void, import("packages/core/src/unstable/app-error/app-error.ts").AppError | import("packages/core/src/unstable/cli-prompt/prompt-cancelled.ts").PromptCancelled, import("packages/core/src/unstable/cli-renderer/cli-renderer.ts").CliRenderer | import("packages/core/src/unstable/cli-flags/verbosity.ts").Verbosity | "effect/unstable/cli/GlobalFlag/axm-non-interactive" | (import("effect/Scope").Scope | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("packages/core/src/unstable/workspace/service-interface.ts").Workspace | import("packages/core/src/unstable/source-resolution/service.ts").SourceHostProviders | InstallCommandCommandWorkflowActions | import("../../mcp-servers/install/command-actions.ts").InstallMcpServerCommandWorkflowActions | import("../../packs/install/command-actions.ts").InstallPackCommandWorkflowActions | import("../../skills/install/command-actions.ts").InstallSkillCommandWorkflowActions | import("../../subagents/install/command-actions.ts").InstallSubagentCommandWorkflowActions)>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/src/root/commands/install/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../../src/root/commands/install/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,EACL,oCAAoC,EAErC,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,oBAAoB,mkCA0B/B,CAAC"}

package/dist/src/root/commands/install/handler.js

@@ -0,0 +1,31 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { runInstallCommandWorkflow } from "@agentxm/client-core/unstable/workflows";
+import { emitPlanResolutionResult } from "../../../json-output.js";
+import { handleWorkspaceInstall } from "../../install/workspace-install-handler.js";
+import { InstallCommandCommandWorkflowActions, } from "./command-actions.js";
+export const handleInstallCommand = Effect.fn("InstallCommand.handle")(function* (args) {
+    if (Option.isNone(args.source)) {
+        return yield* handleWorkspaceInstall({
+            command: "commands.install",
+            type: Option.some("command"),
+            planName: "Install command(s)",
+            planDescription: Option.some("Install configured commands"),
+            flags: args,
+        });
+    }
+    const actions = yield* InstallCommandCommandWorkflowActions;
+    const sourceArgs = {
+        source: args.source.value,
+        yes: args.yes,
+        force: args.force,
+        preview: args.preview,
+    };
+    const resolution = yield* runInstallCommandWorkflow(sourceArgs, actions, {
+        yes: args.yes,
+        force: args.force,
+        preview: args.preview,
+    });
+    yield* emitPlanResolutionResult("commands.install", resolution);
+});
+//# sourceMappingURL=handler.js.map

package/dist/src/root/commands/install/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../../src/root/commands/install/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAEpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EACL,oCAAoC,GAErC,MAAM,sBAAsB,CAAC;AAS9B,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,CAAC,QAAQ,CAAC,EAC9E,IAA+B;IAE/B,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,CAAC,sBAAsB,CAAC;YACnC,OAAO,EAAE,kBAAkB;YAC3B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;YAC5B,QAAQ,EAAE,oBAAoB;YAC9B,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC;YAC3D,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,oCAAoC,CAAC;IAC5D,MAAM,UAAU,GAA8B;QAC5C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;QACzB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,yBAAyB,CAAC,UAAU,EAAE,OAAO,EAAE;QACvE,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IACH,KAAK,CAAC,CAAC,wBAAwB,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC"}

package/dist/src/root/commands/install/intent.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Install command intent type.
+ *
+ * Immutable intent payload for the `axm commands install` workflow.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type * as Option from "effect/Option";
+import type { CommandExtensionRef } from "@agentxm/client-core/unstable/commands";
+import type { VersionConstraint } from "@agentxm/client-core/unstable/version-constraints";
+/**
+ * Intent for installing a command extension.
+ */
+export interface InstallCommandCommandIntent {
+    readonly ref: CommandExtensionRef;
+    readonly versionConstraint: Option.Option<VersionConstraint>;
+    readonly force: boolean;
+}
+//# sourceMappingURL=intent.d.ts.map

package/dist/src/root/commands/install/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../../../src/root/commands/install/intent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB"}

package/dist/src/root/commands/install/intent.js

@@ -0,0 +1,9 @@
+/**
+ * Install command intent type.
+ *
+ * Immutable intent payload for the `axm commands install` workflow.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export {};
+//# sourceMappingURL=intent.js.map

package/dist/src/root/commands/install/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../../../../src/root/commands/install/intent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/src/root/commands/job-step-result.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared helper for converting operation results to plan job step results.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { AppError } from "@agentxm/client-core/unstable/app-error";
+import type { JobStepResult } from "@agentxm/client-core/unstable/workspace";
+/**
+ * Maps an operation result to a {@link JobStepResult} discriminated union.
+ *
+ * Operation functions return `{ result: string; message: string; error?: AppError }`.
+ * Plan steps expect `JobStepResult` which is either
+ * `{ result: "success"; message: string }` or
+ * `{ result: "error"; message: string; error: AppError }`.
+ */
+export declare const toJobStepResult: (result: {
+    readonly result: "success" | "error";
+    readonly message: string;
+    readonly error?: AppError;
+}) => JobStepResult;
+//# sourceMappingURL=job-step-result.d.ts.map

package/dist/src/root/commands/job-step-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-step-result.d.ts","sourceRoot":"","sources":["../../../../src/root/commands/job-step-result.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAE7E;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;CAC3B,KAAG,aAGgD,CAAC"}

package/dist/src/root/commands/job-step-result.js

@@ -0,0 +1,17 @@
+/**
+ * Shared helper for converting operation results to plan job step results.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Maps an operation result to a {@link JobStepResult} discriminated union.
+ *
+ * Operation functions return `{ result: string; message: string; error?: AppError }`.
+ * Plan steps expect `JobStepResult` which is either
+ * `{ result: "success"; message: string }` or
+ * `{ result: "error"; message: string; error: AppError }`.
+ */
+export const toJobStepResult = (result) => result.result === "error" && result.error != null
+    ? { result: "error", message: result.message, error: result.error }
+    : { result: "success", message: result.message };
+//# sourceMappingURL=job-step-result.js.map

package/dist/src/root/commands/job-step-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-step-result.js","sourceRoot":"","sources":["../../../../src/root/commands/job-step-result.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAI/B,EAAiB,EAAE,CAClB,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI;IAC/C,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;IACnE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC"}

package/dist/src/root/commands/list.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "effect/unstable/cli";
+import * as Effect from "effect/Effect";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+export declare const handleListCommands: () => Effect.Effect<void, import("packages/core/src/unstable/app-error/app-error.ts").AppError, CliRenderer | Workspace>;
+export declare const listCommand: Command.Command<"list", Record<string, unknown>, {}, never, "effect/unstable/cli/GlobalFlag/axm-non-interactive" | "effect/unstable/cli/GlobalFlag/axm-json" | "effect/unstable/cli/GlobalFlag/axm-quiet" | "effect/unstable/cli/GlobalFlag/axm-verbose" | "effect/unstable/cli/GlobalFlag/axm-debug">;
+//# sourceMappingURL=list.d.ts.map

package/dist/src/root/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/root/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,WAAW,EAAkB,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiCpE,eAAO,MAAM,kBAAkB,0HA8B7B,CAAC;AAQH,eAAO,MAAM,WAAW,wSAavB,CAAC"}