axm.sh 0.1.6

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

@@ -0,0 +1,323 @@
+/**
+ * Skill install command workflow actions.
+ *
+ * Implements `InstallExtensionCommandWorkflowActions` for the skill install
+ * command. The live layer captures all required services at construction time
+ * so action methods satisfy the `R = never` contract.
+ *
+ * @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 Result from "effect/Result";
+import * as Schema from "effect/Schema";
+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 Terminal from "effect/Terminal";
+import { nonInteractiveFlag } from "@agentxm/client-core/unstable/cli-flags";
+import { makeAppError } from "@agentxm/client-core/unstable/app-error";
+import { parseInputPattern } from "@agentxm/client-core/unstable/sources";
+import { SourceHostProviders } from "@agentxm/client-core/unstable/source-resolution";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+import { SkillManager } from "@agentxm/client-core/unstable/skills";
+import { buildInstallOperation } from "@agentxm/client-core/unstable/extensions";
+import { formatPackageDisplay, PackageUrlPartsSchema, } from "@agentxm/client-core/unstable/packaging";
+import { resolveSkillInstallSource, } from "./resolve-skill-install-source.js";
+import { determineSkillsToInstall } from "./select-skills.js";
+// -----------------------------------------------------------------------------
+// Helpers (pure, no service dependencies)
+// -----------------------------------------------------------------------------
+const isAppErrorCheck = (error) => typeof error === "object" &&
+    error !== null &&
+    "_tag" in error &&
+    error._tag === "AppError" &&
+    "what" in error &&
+    "code" in error;
+const summarizeDiscoverError = (error) => {
+    if (isAppErrorCheck(error)) {
+        return `${error.what} (${error.code})`;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+};
+const isRemoteReadNotImplemented = (error) => isAppErrorCheck(error) &&
+    (error.code === "REGISTRY_REMOTE_NOT_SUPPORTED" ||
+        (error.code.startsWith("REGISTRY_REMOTE_") && error.code.endsWith("_NOT_IMPLEMENTED")));
+const discoverHowToFix = (source, error) => {
+    if (source.type === "registry") {
+        if (isRemoteReadNotImplemented(error)) {
+            return "Remote registry discovery is not yet supported for HTTP(S) sources. Use a file:// registry source, or install from github:owner/repo.";
+        }
+        return "Verify the configured registry is reachable and contains the requested owner/skill.";
+    }
+    if (source.type === "local") {
+        return "Verify the source path contains directories with SKILL.md files.";
+    }
+    return "Verify the source is reachable and contains valid skill directories.";
+};
+const noSkillsFoundHowToFix = (source) => {
+    if (source.type === "registry") {
+        return "Verify the owner and skill name exist in the configured registry.";
+    }
+    if (source.type === "local") {
+        return "Verify the source path contains directories with SKILL.md files.";
+    }
+    return "Verify the source contains skill directories with SKILL.md files.";
+};
+const formatRegistryProbe = (probe) => {
+    switch (probe.outcome) {
+        case "matched":
+            return `${probe.location}: matched`;
+        case "not-found":
+            return `${probe.location}: no match`;
+        case "error":
+            return Option.match(probe.reason, {
+                onNone: () => `${probe.location}: error`,
+                onSome: (reason) => `${probe.location}: ${reason}`,
+            });
+    }
+};
+const decodePackageUrlParts = Schema.decodeUnknownResult(Schema.toType(PackageUrlPartsSchema));
+/**
+ * Extract compatible packages from a skill ref.
+ *
+ * Registry refs have a typed `compatiblePackages` field.
+ * Local/git-hosted refs may carry them in the generic `metadata` bag.
+ *
+ * @internal Exported for testing only.
+ */
+export const getCompatiblePackages = (ref) => {
+    if (ref.refType === "registry") {
+        return ref.compatiblePackages ?? [];
+    }
+    // For non-registry refs, check the generic metadata bag
+    return Option.match(ref.skill.metadata, {
+        onNone: () => [],
+        onSome: (m) => {
+            const raw = m["compatiblePackages"];
+            if (!globalThis.Array.isArray(raw))
+                return [];
+            // Validate each entry individually — skip invalid ones rather than failing the whole array
+            return raw.flatMap((entry) => {
+                const decoded = decodePackageUrlParts(entry);
+                return Result.isSuccess(decoded) ? [decoded.success] : [];
+            });
+        },
+    });
+};
+/**
+ * Build the "Compatible packages" plan section from skill refs.
+ * Returns undefined when no skill has compatible packages.
+ *
+ * @internal Exported for testing only.
+ */
+export const buildCompatiblePackagesSection = (refs) => {
+    const allPackages = refs.flatMap((ref) => getCompatiblePackages(ref));
+    if (allPackages.length === 0)
+        return undefined;
+    // Deduplicate by formatted string
+    const seen = new Set();
+    const items = [];
+    for (const pkg of allPackages) {
+        const formatted = formatPackageDisplay(pkg);
+        if (!seen.has(formatted)) {
+            seen.add(formatted);
+            items.push(formatted);
+        }
+    }
+    return { title: "Compatible packages", items };
+};
+const extractRequestedSkills = (argSkills, parsedSource) => argSkills.length > 0
+    ? argSkills
+    : parsedSource.pattern.pattern === "name-input"
+        ? [parsedSource.pattern.name]
+        : parsedSource.pattern.pattern === "registry-pattern-input"
+            ? Option.isSome(parsedSource.pattern.name)
+                ? [parsedSource.pattern.name.value]
+                : []
+            : [];
+const extractRequestedOwner = (parsedSource, source) => parsedSource.pattern.pattern === "registry-pattern-input"
+    ? Option.some(parsedSource.pattern.owner)
+    : source.type === "registry"
+        ? source.owner
+        : Option.none();
+export class InstallSkillCommandWorkflowActions extends ServiceMap.Service()("InstallSkillCommandWorkflowActions") {
+}
+// -----------------------------------------------------------------------------
+// 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 InstallSkillCommandWorkflowActionsLive = Layer.effect(InstallSkillCommandWorkflowActions, Effect.gen(function* () {
+    const sources = yield* SourceHostProviders;
+    const renderer = yield* CliRenderer;
+    const skillMgr = yield* SkillManager;
+    const ws = yield* Workspace;
+    const pathSvc = yield* Path.Path;
+    const fsSvc = yield* FileSystem.FileSystem;
+    const terminal = yield* Terminal.Terminal;
+    const nonInteractive = yield* nonInteractiveFlag;
+    // Build a service layer providing all services needed by inner effects
+    // (resolveSkillInstallSource, determineSkillsToInstall, etc.)
+    const envLayer = Layer.mergeAll(Layer.succeed(SourceHostProviders, sources), Layer.succeed(CliRenderer, renderer), Layer.succeed(Workspace, ws), Layer.succeed(Path.Path, pathSvc), Layer.succeed(FileSystem.FileSystem, fsSvc), Layer.succeed(Terminal.Terminal, terminal), Layer.succeed(nonInteractiveFlag, nonInteractive));
+    // Provide all captured services so workflow methods close over their
+    // dependencies while PromptCancelled still propagates to the runtime.
+    const provide = (effect) => Effect.provide(effect, envLayer);
+    // PromptCancelled from prompts propagates through the workflow
+    // to the run() handler. The provide() helper narrows E to AppError for the interface.
+    const parseArgs = (args) => provide(Effect.gen(function* () {
+        yield* renderer.info(`axm skills install (${ws.scope})`);
+        const parsed = yield* renderer.withSpinner("Parsing source...", () => Effect.gen(function* () {
+            const parsedSourceOption = parseInputPattern(args.source.trim());
+            if (Option.isNone(parsedSourceOption)) {
+                return yield* makeAppError({
+                    code: "INVALID_SOURCE",
+                    what: "Invalid source: Unable to parse source",
+                    details: [`Provided: ${args.source || "(empty)"}`],
+                    howToFix: "Valid formats: local path, github:owner/repo, gitlab:owner/repo, or https://example.com",
+                });
+            }
+            const parsedSource = parsedSourceOption.value;
+            const versionConstraint = parsedSource.pattern.pattern === "registry-pattern-input"
+                ? parsedSource.pattern.versionConstraint
+                : Option.none();
+            const resolutionProbes = [];
+            const source = yield* resolveSkillInstallSource(parsedSource, {
+                onRegistryProbe: (probe) => {
+                    resolutionProbes.push(probe);
+                },
+            });
+            const requestedSkills = extractRequestedSkills(args.skills, parsedSource);
+            const requestedOwner = extractRequestedOwner(parsedSource, source);
+            return {
+                source,
+                versionConstraint,
+                requestedSkills,
+                requestedOwner,
+                resolutionProbes,
+            };
+        }), {
+            successMessage: ({ source }) => `Source: ${sources.origin(source)} (${source.type})`,
+        });
+        const { source, versionConstraint, requestedSkills, requestedOwner, resolutionProbes } = parsed;
+        if (resolutionProbes.length > 0) {
+            yield* renderer.message(`Resolution: ${resolutionProbes.map((probe) => formatRegistryProbe(probe)).join("; ")}`);
+        }
+        return {
+            source,
+            versionConstraint,
+            requestedSkills,
+            requestedOwner,
+            all: args.all,
+        };
+    }));
+    const resolveSourceRequests = (parsed) => Effect.succeed([
+        {
+            source: parsed.source,
+            requestedSkills: parsed.requestedSkills,
+            requestedOwner: parsed.requestedOwner,
+            versionConstraint: parsed.versionConstraint,
+        },
+    ]);
+    const discoverRefs = (reqs) => provide(Effect.scoped(Effect.gen(function* () {
+        const req = reqs[0];
+        if (req === undefined) {
+            return yield* makeAppError({
+                code: "DISCOVER_FAILED",
+                what: "No source request to discover from",
+            });
+        }
+        return yield* renderer.withSpinner("Discovering skills...", () => sources
+            .find(req.source, {
+            names: req.requestedSkills,
+            type: "skill",
+            owner: req.requestedOwner,
+            versionConstraint: req.versionConstraint,
+        })
+            .pipe(Effect.map(Array.filter((ref) => ref.type === "skill")), Effect.mapError((error) => {
+            const reason = summarizeDiscoverError(error);
+            return makeAppError({
+                code: "DISCOVER_FAILED",
+                what: "Failed to discover skills from source",
+                details: [`Source: ${sources.origin(req.source)}`, `Reason: ${reason}`],
+                howToFix: discoverHowToFix(req.source, error),
+                cause: error,
+            });
+        }), Effect.flatMap((discoveredSkills) => !Array.isReadonlyArrayEmpty(discoveredSkills)
+            ? Effect.succeed(discoveredSkills)
+            : Effect.fail(makeAppError({
+                code: "NO_SKILLS_FOUND",
+                what: "No skills found in source",
+                details: [`Source: ${sources.origin(req.source)}`],
+                howToFix: noSkillsFoundHowToFix(req.source),
+            })))), {
+            successMessage: (discoveredSkills) => `Found ${discoveredSkills.length} skill(s)`,
+        });
+    })));
+    const finalizeIntent = (parsed, discoveredRefs) => provide(Effect.gen(function* () {
+        // Select skills
+        const [firstDiscoveredRef, ...remainingDiscoveredRefs] = discoveredRefs;
+        if (firstDiscoveredRef === undefined) {
+            return yield* makeAppError({
+                code: "NO_SKILLS_FOUND",
+                what: "No skills found in source",
+            });
+        }
+        const nonEmptyDiscoveredRefs = [
+            firstDiscoveredRef,
+            ...remainingDiscoveredRefs,
+        ];
+        const selectedSkills = yield* determineSkillsToInstall(nonEmptyDiscoveredRefs, {
+            requestedSkills: parsed.requestedSkills,
+            all: parsed.all,
+        });
+        if (Array.isReadonlyArrayEmpty(selectedSkills)) {
+            yield* renderer.warn("No skills selected.");
+            yield* renderer.success("Nothing to install.");
+            return { skillsToInstall: [] };
+        }
+        return {
+            skillsToInstall: selectedSkills.map((ref) => ({
+                ref,
+                versionConstraint: ref.refType === "registry"
+                    ? parsed.versionConstraint
+                    : Option.none(),
+            })),
+        };
+    }));
+    const buildPlan = (intent) => {
+        const compatSection = buildCompatiblePackagesSection(intent.skillsToInstall.map((entry) => entry.ref));
+        const sections = compatSection !== undefined ? [compatSection] : undefined;
+        return Effect.succeed({
+            _tag: "Plan",
+            name: "Install skill(s)",
+            description: Option.none(),
+            jobs: [
+                {
+                    concurrency: 1,
+                    steps: intent.skillsToInstall.map((entry) => buildInstallOperation(skillMgr, {
+                        ref: entry.ref,
+                        versionConstraint: entry.versionConstraint,
+                    })),
+                },
+            ],
+            ...(sections !== undefined && { sections }),
+        });
+    };
+    return {
+        parseArgs,
+        resolveSourceRequests,
+        discoverRefs,
+        finalizeIntent,
+        buildPlan,
+    };
+}));
+//# sourceMappingURL=command-actions.js.map

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

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

package/dist/src/root/skills/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/skills/install/command.d.ts.map

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

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

@@ -0,0 +1,46 @@
+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 { handleInstall } from "./handler.js";
+import { withRuntime, withWorkspace } from "../../../runtime.js";
+const installConfig = {
+    source: Argument.string("source").pipe(Argument.withDescription("Registry reference (@owner/skills/name), GitHub shorthand (owner/repo), local path, or URL"), Argument.optional),
+    scope: scopeFlag.pipe(Flag.withDescription("Install to project (default) or user-level configuration")),
+    skill: Flag.string("skill").pipe(Flag.withDescription("Cherry-pick specific skill(s) from a multi-skill source"), Flag.atLeast(0)),
+    all: Flag.boolean("all").pipe(Flag.withDescription("Install every skill found in the source without prompting")),
+    yes: yesFlag.pipe(Flag.withDescription("Skip confirmation after reviewing the install plan")),
+    force: forceFlag.pipe(Flag.withDescription("Reinstall even if the skill already exists")),
+    preview: previewFlag.pipe(Flag.withDescription("Show what would be installed without making changes")),
+};
+export const installCommand = Command.make("install", installConfig, ({ source, scope, skill, all, yes, force, preview }) => handleInstall({ source, skills: skill, all }, { yes, force, preview }).pipe(withWorkspace(scope), withRuntime("skills install"))).pipe(withArgvTracking(installConfig), Command.withDescription("Install configured skills, or install skills from a registry, GitHub, or local path"), Command.withExamples([
+    {
+        command: "axm skills install",
+        description: "Install all configured skills",
+    },
+    {
+        command: "axm skills install @acme/skills/code-review",
+        description: "Add a code review skill to your agents",
+    },
+    {
+        command: "axm skills install @acme/skills/code-review@^1.0.0",
+        description: "Pin to a specific version range",
+    },
+    {
+        command: "axm skills install owner/repo",
+        description: "Install from a GitHub repository",
+    },
+    {
+        command: "axm skills install ./path/to/skills",
+        description: "Install from a local directory during development",
+    },
+    {
+        command: "axm skills install owner/repo --all --yes",
+        description: "CI: install all skills without prompts",
+    },
+    {
+        command: "axm skills install @acme/skills/code-review --preview",
+        description: "See what would be installed before committing",
+    },
+]));
+//# sourceMappingURL=command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../../../src/root/skills/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,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,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,CACtB,4FAA4F,CAC7F,EACD,QAAQ,CAAC,QAAQ,CAClB;IACD,KAAK,EAAE,SAAS,CAAC,IAAI,CACnB,IAAI,CAAC,eAAe,CAAC,0DAA0D,CAAC,CACjF;IACD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAC9B,IAAI,CAAC,eAAe,CAAC,yDAAyD,CAAC,EAC/E,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAChB;IACD,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAC3B,IAAI,CAAC,eAAe,CAAC,2DAA2D,CAAC,CAClF;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,4CAA4C,CAAC,CAAC;IACzF,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,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CACrD,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CACzE,aAAa,CAAC,KAAK,CAAC,EACpB,WAAW,CAAC,gBAAgB,CAAC,CAC9B,CACJ,CAAC,IAAI,CACJ,gBAAgB,CAAC,aAAa,CAAC,EAC/B,OAAO,CAAC,eAAe,CACrB,qFAAqF,CACtF,EACD,OAAO,CAAC,YAAY,CAAC;IACnB;QACE,OAAO,EAAE,oBAAoB;QAC7B,WAAW,EAAE,+BAA+B;KAC7C;IACD;QACE,OAAO,EAAE,6CAA6C;QACtD,WAAW,EAAE,wCAAwC;KACtD;IACD;QACE,OAAO,EAAE,oDAAoD;QAC7D,WAAW,EAAE,iCAAiC;KAC/C;IACD;QACE,OAAO,EAAE,+BAA+B;QACxC,WAAW,EAAE,kCAAkC;KAChD;IACD;QACE,OAAO,EAAE,qCAAqC;QAC9C,WAAW,EAAE,mDAAmD;KACjE;IACD;QACE,OAAO,EAAE,2CAA2C;QACpD,WAAW,EAAE,wCAAwC;KACtD;IACD;QACE,OAAO,EAAE,uDAAuD;QAChE,WAAW,EAAE,+CAA+C;KAC7D;CACF,CAAC,CACH,CAAC"}

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

@@ -0,0 +1,15 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { InstallSkillCommandWorkflowActions } from "./command-actions.js";
+export interface InstallHandlerArgs {
+    readonly source: Option.Option<string>;
+    readonly skills: readonly string[];
+    readonly all: boolean;
+}
+export interface InstallSkillFlags {
+    readonly yes: boolean;
+    readonly force: boolean;
+    readonly preview: boolean;
+}
+export declare const handleInstall: (args: InstallHandlerArgs, flags: InstallSkillFlags) => Effect.Effect<void, import("@agentxm/client-core/unstable/app-error").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 | import("../../commands/install/command-actions.ts").InstallCommandCommandWorkflowActions | import("../../mcp-servers/install/command-actions.ts").InstallMcpServerCommandWorkflowActions | import("../../packs/install/command-actions.ts").InstallPackCommandWorkflowActions | InstallSkillCommandWorkflowActions | import("../../subagents/install/command-actions.ts").InstallSubagentCommandWorkflowActions)>;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../../src/root/skills/install/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,OAAO,EAAE,kCAAkC,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAuBD,eAAO,MAAM,aAAa,GAAI,MAAM,kBAAkB,EAAE,OAAO,iBAAiB,yhCAoB5E,CAAC"}

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

@@ -0,0 +1,39 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { makeAppError } from "@agentxm/client-core/unstable/app-error";
+import { runInstallCommandWorkflow } from "@agentxm/client-core/unstable/workflows";
+import { emitPlanResolutionResult } from "../../../json-output.js";
+import { handleWorkspaceInstall } from "../../install/workspace-install-handler.js";
+import { InstallSkillCommandWorkflowActions } from "./command-actions.js";
+const validateWorkspaceInstallArgs = (args) => Effect.gen(function* () {
+    if (args.all) {
+        return yield* makeAppError({
+            code: "SKILLS_INSTALL_ALL_REQUIRES_SOURCE",
+            what: "The --all flag requires a source for skills install",
+            howToFix: "Run `axm skills install <source> --all` or omit --all to install all configured skills.",
+        });
+    }
+    if (args.skills.length > 0) {
+        return yield* makeAppError({
+            code: "SKILLS_INSTALL_SELECTOR_REQUIRES_SOURCE",
+            what: "The --skill flag requires a source for skills install",
+            howToFix: "Run `axm skills install <source> --skill <name>` or omit --skill to install all configured skills.",
+        });
+    }
+});
+export const handleInstall = (args, flags) => Effect.gen(function* () {
+    if (Option.isNone(args.source)) {
+        yield* validateWorkspaceInstallArgs(args);
+        return yield* handleWorkspaceInstall({
+            command: "skills.install",
+            type: Option.some("skill"),
+            planName: "Install skill(s)",
+            planDescription: Option.some("Install configured skills"),
+            flags,
+        });
+    }
+    const actions = yield* InstallSkillCommandWorkflowActions;
+    const resolution = yield* runInstallCommandWorkflow({ source: args.source.value, skills: args.skills, all: args.all }, actions, flags);
+    yield* emitPlanResolutionResult("skills.install", resolution);
+});
+//# sourceMappingURL=handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../../src/root/skills/install/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,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,EAAE,kCAAkC,EAAE,MAAM,sBAAsB,CAAC;AAc1E,MAAM,4BAA4B,GAAG,CAAC,IAAwB,EAAE,EAAE,CAChE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,oCAAoC;YAC1C,IAAI,EAAE,qDAAqD;YAC3D,QAAQ,EACN,yFAAyF;SAC5F,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,yCAAyC;YAC/C,IAAI,EAAE,uDAAuD;YAC7D,QAAQ,EACN,oGAAoG;SACvG,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAwB,EAAE,KAAwB,EAAE,EAAE,CAClF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC,CAAC,sBAAsB,CAAC;YACnC,OAAO,EAAE,gBAAgB;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YAC1B,QAAQ,EAAE,kBAAkB;YAC5B,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC;YACzD,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,kCAAkC,CAAC;IAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,yBAAyB,CACjD,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EACjE,OAAO,EACP,KAAK,CACN,CAAC;IACF,KAAK,CAAC,CAAC,wBAAwB,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Intent type for the skill install command workflow.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type * as Option from "effect/Option";
+import type { SkillExtensionRef } from "@agentxm/client-core/unstable/skills";
+import type { VersionConstraint } from "@agentxm/client-core/unstable/version-constraints";
+/**
+ * Describes the resolved intent to install one or more skills.
+ *
+ * Produced by `finalizeSkillInstallIntent` after source resolution,
+ * discovery, and selection. Consumed by `buildSkillInstallPlan`.
+ */
+export type InstallSkillCommandIntent = {
+    readonly skillsToInstall: ReadonlyArray<{
+        readonly ref: SkillExtensionRef;
+        readonly versionConstraint: Option.Option<VersionConstraint>;
+    }>;
+};
+//# sourceMappingURL=intent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../../../src/root/skills/install/intent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC;QACtC,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;QAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;KAC9D,CAAC,CAAC;CACJ,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Intent type for the skill install command workflow.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export {};
+//# sourceMappingURL=intent.js.map

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

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

package/dist/src/root/skills/install/plan.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Skills-specific plan builder.
+ *
+ * Builds install operations from selected skill refs and diffs them against
+ * current lockfile state to produce a Plan with inline run closures.
+ *
+ * @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 type { PlannedJobStep } from "@agentxm/client-core/unstable/workspace";
+import type { VersionConstraint } from "@agentxm/client-core/unstable/version-constraints";
+import type { SkillExtensionRef } from "@agentxm/client-core/unstable/skills";
+import type { Source } from "@agentxm/client-core/unstable/sources";
+import { SourceHostProviders } from "@agentxm/client-core/unstable/source-resolution";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { CodingAgentRepository } from "@agentxm/client-core/unstable/agents";
+/**
+ * Args for building an install plan.
+ */
+export interface BuildSkillInstallPlanArgs {
+    readonly selectedSkills: ReadonlyArray<SkillExtensionRef>;
+    readonly source: Source;
+    readonly force: boolean;
+    readonly versionConstraint: Option.Option<VersionConstraint>;
+}
+/**
+ * Build a plan by computing install operations and comparing against lockfile state.
+ * Captures all service dependencies into step run closures.
+ */
+export declare const buildSkillInstallPlan: ({ selectedSkills, source, force, versionConstraint, }: BuildSkillInstallPlanArgs) => Effect.Effect<{
+    _tag: "Plan";
+    name: string;
+    description: Option.Option<string>;
+    jobs: {
+        concurrency: 1;
+        steps: PlannedJobStep[];
+    }[];
+}, import("packages/core/src/unstable/app-error/app-error.ts").AppError, CliRenderer | FileSystem.FileSystem | Path.Path | Workspace | CodingAgentRepository | SourceHostProviders>;
+//# sourceMappingURL=plan.d.ts.map

package/dist/src/root/skills/install/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../../src/root/skills/install/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAQ,cAAc,EAAiB,MAAM,yCAAyC,CAAC;AACnG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAI7E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;CAC9D;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,uDAKnC,yBAAyB;;;;;;;;mLAkFxB,CAAC"}

package/dist/src/root/skills/install/plan.js

@@ -0,0 +1,82 @@
+/**
+ * Skills-specific plan builder.
+ *
+ * Builds install operations from selected skill refs and diffs them against
+ * current lockfile state to produce a Plan with inline run closures.
+ *
+ * @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 { SourceHostProviders } from "@agentxm/client-core/unstable/source-resolution";
+import { Workspace } from "@agentxm/client-core/unstable/workspace";
+import { CliRenderer } from "@agentxm/client-core/unstable/cli-renderer";
+import { CodingAgentRepository } from "@agentxm/client-core/unstable/agents";
+import { installSkill } from "@agentxm/client-core/unstable/skills";
+/**
+ * Build a plan by computing install operations and comparing against lockfile state.
+ * Captures all service dependencies into step run closures.
+ */
+export const buildSkillInstallPlan = ({ selectedSkills, source, force, versionConstraint, }) => Effect.gen(function* () {
+    const workspace = yield* Workspace;
+    const sources = yield* SourceHostProviders;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const renderer = yield* CliRenderer;
+    const agentRepo = yield* CodingAgentRepository;
+    const lockedSkills = yield* workspace.getLockedSkills().pipe(Effect.catch((error) => {
+        if (error.code === "LOCKFILE_PARSE_FAILED" ||
+            error.code === "LOCKFILE_RESOLVED_VERSION_INVALID") {
+            return Effect.succeed({});
+        }
+        return Effect.fail(error);
+    }));
+    const steps = selectedSkills.map((ref) => {
+        const installed = Object.hasOwn(lockedSkills, ref.skill.name);
+        const op = {
+            name: "install-skill",
+            args: {
+                ref,
+                force,
+                versionConstraint: ref.refType === "registry" ? versionConstraint : Option.none(),
+                skipSettings: Option.none(),
+                strictUnknownAgents: Option.none(),
+                existingInstalledAt: Option.none(),
+                sourceName: Option.none(),
+            },
+        };
+        if (installed && !force) {
+            return {
+                readiness: "ready",
+                label: ref.skill.name,
+                run: Effect.succeed({
+                    result: "success",
+                    message: `${ref.skill.name} already installed`,
+                }),
+            };
+        }
+        // Capture services and provide them to the run closure
+        const runEffect = installSkill(op).pipe(Effect.map((result) => result.result === "error"
+            ? { result: "error", message: result.message, error: result.error }
+            : { result: "success", message: result.message }), Effect.provideService(Workspace, workspace), Effect.provideService(SourceHostProviders, sources), Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(Path.Path, path), Effect.provideService(CliRenderer, renderer), Effect.provideService(CodingAgentRepository, agentRepo));
+        return {
+            readiness: "ready",
+            label: ref.skill.name,
+            run: runEffect,
+        };
+    });
+    return {
+        _tag: "Plan",
+        name: "Install skill(s)",
+        description: Option.some(`Install skills from ${sources.origin(source)}`),
+        jobs: [
+            {
+                concurrency: 1,
+                steps,
+            },
+        ],
+    };
+});
+//# sourceMappingURL=plan.js.map