@agentxm/client-core 0.1.6

package/dist/src/unstable/skills/manifest-schema.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Skill manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+export declare const MANIFEST_FILENAME = "skill.json";
+export declare const MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/skill.schema.json";
+/**
+ * Schema for skill manifest files (skill.json).
+ *
+ * Skills extend coding agent capabilities with reusable prompts
+ * and context that can be invoked on demand.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SkillManifestSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"skill">;
+    readonly name: Schema.brand<Schema.String, "ExtensionName">;
+    readonly agents: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly owner: Schema.brand<Schema.String, "Handle">;
+    readonly version: Schema.brand<Schema.String, "ExactSemverVersion">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly keywords: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly repository: Schema.optional<Schema.String>;
+    readonly homepage: Schema.optional<Schema.String>;
+    readonly license: Schema.optional<Schema.String>;
+    readonly bugs: Schema.optional<Schema.String>;
+    readonly authors: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly email: Schema.optional<Schema.String>;
+        readonly url: Schema.optional<Schema.String>;
+    }>>>;
+    readonly compatiblePackages: Schema.optional<Schema.$Array<Schema.decodeTo<Schema.toType<Schema.Struct<{
+        readonly type: Schema.brand<Schema.String, "PackageType">;
+        readonly namespace: Schema.optional<Schema.String>;
+        readonly name: Schema.String;
+        readonly version: Schema.optional<Schema.String>;
+    }>>, Schema.String, never, never>>>;
+    readonly $schema: Schema.optional<Schema.String>;
+}>;
+/**
+ * Inferred type for SkillManifest schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SkillManifest = Schema.Schema.Type<typeof SkillManifestSchema>;
+//# sourceMappingURL=manifest-schema.d.ts.map

package/dist/src/unstable/skills/manifest-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,eAAO,MAAM,mBAAmB,6CAA6C,CAAC;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAa9B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/src/unstable/skills/manifest-schema.js

@@ -0,0 +1,29 @@
+/**
+ * Skill manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { CommonManifestBaseFields, ExtensionNameSchema } from "../extensions/common.js";
+export const MANIFEST_FILENAME = "skill.json";
+export const MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/skill.schema.json";
+/**
+ * Schema for skill manifest files (skill.json).
+ *
+ * Skills extend coding agent capabilities with reusable prompts
+ * and context that can be invoked on demand.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SkillManifestSchema = Schema.Struct({
+    $schema: Schema.optional(Schema.String),
+    ...CommonManifestBaseFields,
+    type: Schema.Literal("skill"),
+    name: ExtensionNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "skill name is required" })),
+    agents: Schema.optional(Schema.Array(Schema.String)),
+}).annotate({
+    identifier: "SkillManifest",
+    title: "Skill Manifest",
+    description: "Configuration file (skill.json) that defines a skill — reusable prompts and context for coding agents.",
+});
+//# sourceMappingURL=manifest-schema.js.map

package/dist/src/unstable/skills/manifest-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.js","sourceRoot":"","sources":["../../../../src/unstable/skills/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAExF,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,0CAA0C,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACvC,GAAG,wBAAwB;IAC3B,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAC5B,MAAM,CAAC,WAAW,CAAC,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,CAAC,CACpE;IACD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACrD,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,eAAe;IAC3B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,wGAAwG;CAC3G,CAAC,CAAC"}

package/dist/src/unstable/skills/materialization.d.ts

@@ -0,0 +1,31 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import { type AppError } from "../app-error/index.js";
+import type { SourceHostProvidersService } from "../source-resolution/index.js";
+import type { SkillExtensionRef } from "./refs.js";
+export type ProvideFs = <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, FileSystem.FileSystem | Path.Path>>;
+export declare const materializeSkillCanonical: (args: {
+    readonly ref: SkillExtensionRef;
+    readonly sanitizedName: string;
+    readonly fs: FileSystem.FileSystem;
+    readonly pathService: Path.Path;
+    readonly baseDir: string;
+    readonly sources: SourceHostProvidersService;
+    readonly provide: ProvideFs;
+}) => Effect.Effect<string, AppError, never>;
+export declare const ensureSkillAgentArtifact: (args: {
+    readonly canonicalSkillSrcPath: string;
+    readonly targetDir: string;
+    readonly sanitizedName: string;
+    readonly pathService: Path.Path;
+    readonly baseDir: string;
+    readonly provide: ProvideFs;
+}) => Effect.Effect<void, never, never>;
+export declare const removeSkillAgentArtifact: (args: {
+    readonly fs: FileSystem.FileSystem;
+    readonly pathService: Path.Path;
+    readonly targetDir: string;
+    readonly sanitizedName: string;
+}) => Effect.Effect<void, never, never>;
+//# sourceMappingURL=materialization.d.ts.map

package/dist/src/unstable/skills/materialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialization.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/materialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AAGpE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAYnD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AA2KxE,eAAO,MAAM,yBAAyB,GAAI,MAAM;IAC9C,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,UAAU,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CA8BxC,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAC7C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B,sCAiBG,CAAC;AAEL,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAC7C,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,UAAU,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,sCAGyC,CAAC"}

package/dist/src/unstable/skills/materialization.js

@@ -0,0 +1,105 @@
+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 { makeAppError } from "../app-error/index.js";
+import { validatePathSafety } from "../extensions/index.js";
+import { copyExtensionDirectory } from "../extensions/utils.js";
+import { computeSkillPaths } from "./paths.js";
+import { computeIntegrity, createSymlink, isPathSafe, removeFromAllCanonicalLocations, stripFileProtocol, } from "../utils/index.js";
+import { createRegistryClient, extractZip } from "../registry/index.js";
+import { prependManagedMarkerToSkillMdWith } from "./managed-marker-ops.js";
+const preCleanAndCopy = (fs, pathService, baseDir, sanitizedName, sourcePath, copyTarget, provide) => Effect.gen(function* () {
+    yield* removeFromAllCanonicalLocations(fs, baseDir, sanitizedName, pathService);
+    yield* provide(copyExtensionDirectory(sourcePath, copyTarget).pipe(Effect.mapError((error) => makeAppError({
+        code: "INSTALL_SKILL_COPY_FAILED",
+        what: `Failed to copy skill files to ${copyTarget}`,
+        cause: error,
+    }))));
+});
+const materializeGitHosted = (ref, sanitizedName, fs, pathService, baseDir, provide) => Effect.gen(function* () {
+    const { skillSrcPath } = computeSkillPaths(pathService.join, baseDir, { refType: ref.refType }, sanitizedName);
+    yield* validatePathSafety(baseDir, skillSrcPath, "INSTALL_SKILL_PATH_TRAVERSAL");
+    const sourcePath = stripFileProtocol(ref.location);
+    yield* preCleanAndCopy(fs, pathService, baseDir, sanitizedName, sourcePath, skillSrcPath, provide);
+    yield* prependManagedMarkerToSkillMdWith(fs, pathService, skillSrcPath);
+    return skillSrcPath;
+});
+const materializeLocal = (ref, sanitizedName, fs, pathService, baseDir, provide) => Effect.gen(function* () {
+    const { skillSrcPath } = computeSkillPaths(pathService.join, baseDir, { refType: ref.refType }, sanitizedName);
+    yield* validatePathSafety(baseDir, skillSrcPath, "INSTALL_SKILL_PATH_TRAVERSAL");
+    const sourcePath = stripFileProtocol(ref.location);
+    const isSelfCopy = pathService.resolve(sourcePath) === pathService.resolve(skillSrcPath);
+    if (!isSelfCopy) {
+        yield* preCleanAndCopy(fs, pathService, baseDir, sanitizedName, sourcePath, skillSrcPath, provide);
+    }
+    return skillSrcPath;
+});
+const materializeRegistry = (ref, sanitizedName, fs, pathService, baseDir, provide) => Effect.gen(function* () {
+    const source = { refType: "registry", owner: ref.owner };
+    const { canonicalPath, skillSrcPath } = computeSkillPaths(pathService.join, baseDir, source, sanitizedName);
+    yield* validatePathSafety(baseDir, canonicalPath, "INSTALL_SKILL_PATH_TRAVERSAL");
+    const canonicalExists = yield* fs.exists(canonicalPath).pipe(Effect.mapError((error) => makeAppError({
+        code: "INSTALL_SKILL_PATH_CHECK_FAILED",
+        what: `Failed to check if canonical path exists: ${canonicalPath}`,
+        cause: error,
+    })));
+    const useExisting = Option.isNone(ref.integrity) && canonicalExists;
+    if (!useExisting) {
+        const locationStr = ref.source.location.protocol === "file:"
+            ? ref.source.location.pathname
+            : ref.source.location.href;
+        const client = yield* provide(createRegistryClient(locationStr));
+        const { archive } = yield* client.getExtensionPackage({
+            owner: ref.owner,
+            type: "skill",
+            name: ref.name,
+            version: Option.some(ref.version),
+        });
+        if (Option.isSome(ref.integrity)) {
+            const actualIntegrity = yield* computeIntegrity(archive);
+            if (actualIntegrity !== ref.integrity.value) {
+                return yield* makeAppError({
+                    code: "INSTALL_SKILL_INTEGRITY_MISMATCH",
+                    what: `Integrity mismatch for ${ref.name}@${ref.version}`,
+                    details: [`Expected ${ref.integrity.value}, got ${actualIntegrity}`],
+                });
+            }
+        }
+        const tmpDir = yield* fs.makeTempDirectory().pipe(Effect.mapError((error) => makeAppError({
+            code: "INSTALL_SKILL_TEMP_DIR_FAILED",
+            what: `Failed to create temporary directory for registry install`,
+            cause: error,
+        })));
+        yield* Effect.ensuring(Effect.gen(function* () {
+            yield* provide(extractZip(archive, tmpDir));
+            yield* preCleanAndCopy(fs, pathService, baseDir, sanitizedName, tmpDir, canonicalPath, provide);
+        }), fs.remove(tmpDir, { recursive: true }).pipe(Effect.ignore));
+    }
+    yield* prependManagedMarkerToSkillMdWith(fs, pathService, skillSrcPath);
+    return skillSrcPath;
+});
+export const materializeSkillCanonical = (args) => {
+    switch (args.ref.refType) {
+        case "git-hosted":
+            return materializeGitHosted(args.ref, args.sanitizedName, args.fs, args.pathService, args.baseDir, args.provide);
+        case "local":
+            return materializeLocal(args.ref, args.sanitizedName, args.fs, args.pathService, args.baseDir, args.provide);
+        case "registry":
+            return materializeRegistry(args.ref, args.sanitizedName, args.fs, args.pathService, args.baseDir, args.provide);
+    }
+};
+export const ensureSkillAgentArtifact = (args) => Effect.gen(function* () {
+    const agentSkillPath = args.pathService.join(args.targetDir, args.sanitizedName);
+    if (!isPathSafe(args.baseDir, agentSkillPath)) {
+        return;
+    }
+    yield* args.provide(createSymlink({
+        target: args.canonicalSkillSrcPath,
+        link: agentSkillPath,
+    }).pipe(Effect.catch(() => copyExtensionDirectory(args.canonicalSkillSrcPath, agentSkillPath).pipe(Effect.ignore))));
+});
+export const removeSkillAgentArtifact = (args) => args.fs
+    .remove(args.pathService.join(args.targetDir, args.sanitizedName), { recursive: true })
+    .pipe(Effect.catch(() => Effect.void));
+//# sourceMappingURL=materialization.js.map

package/dist/src/unstable/skills/materialization.js.map

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

package/dist/src/unstable/skills/operations/copy.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copy skill executor — copies source files to the managed extensions store
+ * and generates an `skill.json` manifest.
+ *
+ * Pipeline: parse target name → resolve source path → copy files →
+ * generate manifest.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import type { SkillExtensionRef } from "../refs.js";
+/**
+ * Args for the copy-skill operation.
+ *
+ * Copies source files to `.axm/extensions/@<owner>/skills/<name>/`
+ * and generates an `skill.json` manifest.
+ */
+export type CopySkillOperationArgs = {
+    /** The skill extension ref carrying source and location. */
+    readonly ref: SkillExtensionRef;
+    /** Target identity in `@owner/name` format. */
+    readonly targetName: string;
+};
+/**
+ * Copy a skill into a managed extension.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type CopySkillOperation = Operation<"copy-skill", CopySkillOperationArgs>;
+/**
+ * Copy-skill operation handler.
+ *
+ * 1. Parse target name (`@owner/name`)
+ * 2. Resolve source path from ref location
+ * 3. Copy files to `.axm/extensions/@<owner>/skills/<name>/`
+ * 4. Generate `skill.json` manifest with defaults
+ */
+export declare const copySkill: OperationHandler<CopySkillOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=copy.d.ts.map

package/dist/src/unstable/skills/operations/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/skills/operations/copy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAGjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AASpD;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC;AAYjF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE,gBAAgB,CACtC,kBAAkB,EAClB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CA0E3C,CAAC"}

package/dist/src/unstable/skills/operations/copy.js

@@ -0,0 +1,92 @@
+/**
+ * Copy skill executor — copies source files to the managed extensions store
+ * and generates an `skill.json` manifest.
+ *
+ * Pipeline: parse target name → resolve source path → copy files →
+ * generate manifest.
+ *
+ * @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 { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { copyExtensionDirectory } from "../../extensions/utils.js";
+import { REGISTRY_EXTENSIONS_DIR, parseFqn } from "../../extensions/index.js";
+import { MANIFEST_FILENAME, MANIFEST_SCHEMA_URL } from "../manifest-schema.js";
+import { stripFileProtocol } from "../../utils/index.js";
+import { isManagedByAxm, stripMarker } from "../../extensions/managed-marker.js";
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+const DEFAULT_VERSION = "0.1.0";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Copy-skill operation handler.
+ *
+ * 1. Parse target name (`@owner/name`)
+ * 2. Resolve source path from ref location
+ * 3. Copy files to `.axm/extensions/@<owner>/skills/<name>/`
+ * 4. Generate `skill.json` manifest with defaults
+ */
+export const copySkill = (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.targetName);
+    // Target path in the managed extensions store
+    const targetDir = path.join(base, REGISTRY_EXTENSIONS_DIR, fqn.owner, "skills", fqn.name);
+    // Source path from the ref location (registry refs don't carry location)
+    const { ref } = op.args;
+    if (ref.refType !== "git-hosted" && ref.refType !== "local") {
+        return yield* makeAppError({
+            code: "COPY_SKILL_UNSUPPORTED_SOURCE",
+            what: `copy-skill does not support ${ref.source.type} sources`,
+        });
+    }
+    const sourcePath = stripFileProtocol(ref.location);
+    // Copy source files to src/ subdirectory (manifest stays at extension root)
+    yield* copyExtensionDirectory(sourcePath, path.join(targetDir, "src")).pipe(Effect.mapError((e) => makeAppError({
+        code: "COPY_SKILL_FAILED",
+        what: `Failed to copy skill files to ${targetDir}`,
+        cause: e,
+    })));
+    // Strip managed marker from copied SKILL.md (forked skills are user-owned)
+    const copiedSkillMdPath = path.join(targetDir, "src", "SKILL.md");
+    const skillMdExists = yield* fs
+        .exists(copiedSkillMdPath)
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    if (skillMdExists) {
+        const skillMdContent = yield* fs
+            .readFileString(copiedSkillMdPath)
+            .pipe(Effect.catch(() => Effect.succeed("")));
+        if (isManagedByAxm(skillMdContent)) {
+            yield* fs
+                .writeFileString(copiedSkillMdPath, stripMarker(skillMdContent))
+                .pipe(Effect.catch(() => Effect.void));
+        }
+    }
+    // Generate skill.json manifest
+    const manifest = {
+        $schema: MANIFEST_SCHEMA_URL,
+        owner: fqn.owner,
+        type: "skill",
+        name: fqn.name,
+        version: DEFAULT_VERSION,
+    };
+    const manifestPath = path.join(targetDir, MANIFEST_FILENAME);
+    yield* fs.writeFileString(manifestPath, JSON.stringify(manifest, null, 2) + "\n").pipe(Effect.mapError((e) => makeAppError({
+        code: "COPY_SKILL_MANIFEST_WRITE_FAILED",
+        what: `Failed to write manifest: ${manifestPath}`,
+        cause: e,
+    })));
+    return {
+        result: "success",
+        message: `Copied ${fqn.name} to ${op.args.targetName}`,
+    };
+});
+//# sourceMappingURL=copy.js.map

package/dist/src/unstable/skills/operations/copy.js.map

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

package/dist/src/unstable/skills/operations/disable.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Disable skill executor — removes agent symlinks but preserves canonical files.
+ *
+ * Three paths:
+ * - Lock entry present: full disable (remove symlinks + clear lock agents + settings)
+ * - No lock entry, configured: settings-only toggle
+ * - No lock entry, implicit: promote to configured entry with enabled: false
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Disable a skill (remove files but keep settings/lockfile entry).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type DisableSkillOperation = Operation<"disable-skill", {
+    readonly skillName: string;
+}>;
+/**
+ * Disable-skill operation handler.
+ *
+ * Determines lifecycle via getInstalledSkills, then branches:
+ *
+ * Implicit skill → promote to configured entry with enabled: false
+ *   - If lock entry exists: also remove symlinks + clear lock agents
+ *   - If no lock entry: settings promotion only
+ *
+ * Configured skill with lock entry → full lock-backed disable
+ *   - Remove symlinks, clear lock agents, update settings
+ *
+ * Configured skill without lock entry → settings-only toggle
+ *
+ * Canonical files are preserved for later re-enablement.
+ */
+export declare const disableSkill: OperationHandler<DisableSkillOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=disable.d.ts.map

package/dist/src/unstable/skills/operations/disable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/skills/operations/disable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAKpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAgCjE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC,eAAe,EAAE;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAM/F;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,EAAE,gBAAgB,CACzC,qBAAqB,EACrB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CA+F3C,CAAC"}

package/dist/src/unstable/skills/operations/disable.js

@@ -0,0 +1,131 @@
+/**
+ * Disable skill executor — removes agent symlinks but preserves canonical files.
+ *
+ * Three paths:
+ * - Lock entry present: full disable (remove symlinks + clear lock agents + settings)
+ * - No lock entry, configured: settings-only toggle
+ * - No lock entry, implicit: promote to configured entry with enabled: false
+ *
+ * @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 { getAgentById } from "../../agents/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { sanitizeName } from "../../extensions/utils.js";
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+/** Derive a source string from lock entry metadata for implicit skill promotion. */
+const deriveSourceString = (lockEntry) => {
+    switch (lockEntry.type) {
+        case "local":
+            return lockEntry.path;
+        case "registry":
+            return `${lockEntry.owner}/skills/${lockEntry.name}`;
+        case "github":
+            return `${lockEntry.owner}/${lockEntry.repo}`;
+        case "gitlab":
+            return `${lockEntry.owner}/${lockEntry.repo}`;
+        case "bitbucket":
+            return `${lockEntry.owner}/${lockEntry.repo}`;
+        case "azurerepos":
+            return `${lockEntry.organization}/${lockEntry.project}/${lockEntry.repo}`;
+        case "git":
+            return lockEntry.url;
+    }
+};
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Disable-skill operation handler.
+ *
+ * Determines lifecycle via getInstalledSkills, then branches:
+ *
+ * Implicit skill → promote to configured entry with enabled: false
+ *   - If lock entry exists: also remove symlinks + clear lock agents
+ *   - If no lock entry: settings promotion only
+ *
+ * Configured skill with lock entry → full lock-backed disable
+ *   - Remove symlinks, clear lock agents, update settings
+ *
+ * Configured skill without lock entry → settings-only toggle
+ *
+ * Canonical files are preserved for later re-enablement.
+ */
+export const disableSkill = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    // Read lifecycle to determine promotion needs
+    const installedSkills = yield* ws.getInstalledSkills();
+    const installed = installedSkills[op.args.skillName];
+    const isImplicit = installed !== undefined && installed.lifecycle === "implicit";
+    // Check for lock entry
+    const lockEntryOption = yield* ws.getLockedSkill(op.args.skillName).pipe(Effect.mapError((e) => makeAppError({
+        code: "DISABLE_SKILL_LOCKFILE_READ_FAILED",
+        what: `Failed to read lockfile: ${e.what}`,
+        cause: e,
+    })));
+    const hasLockEntry = Option.isSome(lockEntryOption);
+    // Lock-backed file operations (when lock entry exists)
+    if (hasLockEntry) {
+        const lockEntry = lockEntryOption.value;
+        const sanitizedName = sanitizeName(op.args.skillName);
+        const configuredAgents = yield* ws.getConfiguredAgents();
+        const lockAgents = lockEntry.agents;
+        const allAgents = [...new Set([...lockAgents, ...configuredAgents])];
+        // Remove agent symlinks/copies (concurrent) — files before state.
+        // When renderedFiles are tracked (copy-mode), prefer tracked paths;
+        // otherwise fall back to agent descriptor-based path resolution.
+        const renderedFiles = lockEntry.renderedFiles;
+        yield* Effect.forEach(allAgents, (agentId) => {
+            // Check renderedFiles for tracked copy-mode paths
+            const tracked = renderedFiles?.[agentId];
+            if (tracked !== undefined && tracked.length > 0) {
+                return Effect.forEach(tracked, (entry) => fs.remove(entry.path, { recursive: true }).pipe(Effect.catch(() => Effect.void)), { concurrency: "unbounded" });
+            }
+            // Fall back to agent descriptor-based path resolution
+            const maybeAgent = getAgentById(agentId);
+            if (Option.isNone(maybeAgent))
+                return Effect.void;
+            const agent = maybeAgent.value;
+            const agentSkillPath = path.join(base, agent.skills.dir, sanitizedName);
+            return fs
+                .remove(agentSkillPath, { recursive: true })
+                .pipe(Effect.catch(() => Effect.void));
+        }, { concurrency: "unbounded" });
+        // Clear lock agents — state updates after files
+        yield* ws.updateLockEntryAgents(op.args.skillName, []).pipe(Effect.catch(() => Effect.void));
+    }
+    // State mutation: implicit promotion or configured toggle
+    if (isImplicit) {
+        // Implicit promotion: derive source via deterministic fallback order
+        // 1. installed entry source  2. lock entry metadata  3. fail
+        const source = Option.getOrElse(installed.source, () => hasLockEntry ? deriveSourceString(lockEntryOption.value) : undefined);
+        if (source === undefined) {
+            return yield* makeAppError({
+                code: "DISABLE_SKILL_NO_SOURCE",
+                what: `Cannot determine source for implicit skill "${op.args.skillName}"`,
+                howToFix: "Provide a source when disabling this skill",
+            });
+        }
+        yield* ws.setSkillEntry(op.args.skillName, { source, enabled: false });
+    }
+    else {
+        // Configured skill — toggle enabled flag
+        yield* ws
+            .updateSkillEntry(op.args.skillName, (e) => ({ ...e, enabled: false }))
+            .pipe(Effect.catch(() => Effect.void));
+    }
+    return {
+        result: "success",
+        message: `Disabled ${op.args.skillName}`,
+    };
+});
+//# sourceMappingURL=disable.js.map

package/dist/src/unstable/skills/operations/disable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable.js","sourceRoot":"","sources":["../../../../../src/unstable/skills/operations/disable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;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,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,oFAAoF;AACpF,MAAM,kBAAkB,GAAG,CAAC,SAAyB,EAAU,EAAE;IAC/D,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,IAAI,CAAC;QACxB,KAAK,UAAU;YACb,OAAO,GAAG,SAAS,CAAC,KAAK,WAAW,SAAS,CAAC,IAAI,EAAE,CAAC;QACvD,KAAK,QAAQ;YACX,OAAO,GAAG,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QAChD,KAAK,QAAQ;YACX,OAAO,GAAG,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QAChD,KAAK,WAAW;YACd,OAAO,GAAG,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QAChD,KAAK,YAAY;YACf,OAAO,GAAG,SAAS,CAAC,YAAY,IAAI,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QAC5E,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,GAAG,CAAC;IACzB,CAAC;AACH,CAAC,CAAC;AAaF,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,YAAY,GAGrB,CAAC,EAAE,EAAE,EAAE,CACT,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC5B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;IAExB,8CAA8C;IAC9C,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC;IACvD,MAAM,SAAS,GAAG,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,SAAS,KAAK,UAAU,CAAC;IAEjF,uBAAuB;IACvB,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CACtE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,oCAAoC;QAC1C,IAAI,EAAE,4BAA4B,CAAC,CAAC,IAAI,EAAE;QAC1C,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAEpD,uDAAuD;IACvD,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC;QACxC,MAAM,aAAa,GAAG,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC;QAEzD,MAAM,UAAU,GAAsB,SAAS,CAAC,MAAM,CAAC;QACvD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAErE,kEAAkE;QAClE,oEAAoE;QACpE,iEAAiE;QACjE,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9C,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACnB,SAAS,EACT,CAAC,OAAO,EAAE,EAAE;YACV,kDAAkD;YAClD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,OAAO,MAAM,CAAC,OAAO,CACnB,OAAO,EACP,CAAC,KAAK,EAAE,EAAE,CACR,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAClF,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;YACJ,CAAC;YAED,sDAAsD;YACtD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC;YAClD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;YAE/B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;YACxE,OAAO,EAAE;iBACN,MAAM,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;iBAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC,EACD,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;QAEF,gDAAgD;QAChD,KAAK,CAAC,CAAC,EAAE,CAAC,qBAAqB,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/F,CAAC;IAED,0DAA0D;IAC1D,IAAI,UAAU,EAAE,CAAC;QACf,qEAAqE;QACrE,6DAA6D;QAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CACrD,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CACrE,CAAC;QACF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;gBACzB,IAAI,EAAE,yBAAyB;gBAC/B,IAAI,EAAE,+CAA+C,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG;gBACzE,QAAQ,EAAE,4CAA4C;aACvD,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACN,yCAAyC;QACzC,KAAK,CAAC,CAAC,EAAE;aACN,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;aACtE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,YAAY,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE;KACjB,CAAC;AAC5B,CAAC,CAAC,CAAC"}

package/dist/src/unstable/skills/operations/enable.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Enable skill executor — re-creates agent symlinks for a previously disabled skill.
+ *
+ * Two paths:
+ * - Lock entry present: full enable (symlinks + lock agents + settings)
+ * - No lock entry: settings-only toggle (configured skill with no lock backing)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Enable a previously disabled skill (re-install files and update state).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type EnableSkillOperation = Operation<"enable-skill", {
+    readonly skillName: string;
+}>;
+/**
+ * Enable-skill operation handler.
+ *
+ * Lock-backed path:
+ * 1. Read configured agents, lock entry
+ * 2. Compute canonical path via getSkillDir (uses lockfile)
+ * 3. Verify canonical directory exists
+ * 4. Create agent symlinks (concurrent)
+ * 5. Update lock agents
+ * 6. Update settings entry to set enabled: true
+ *
+ * Settings-only path (no lock entry):
+ * 1. Update settings entry to set enabled: true
+ */
+export declare const enableSkill: OperationHandler<EnableSkillOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=enable.d.ts.map

package/dist/src/unstable/skills/operations/enable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/skills/operations/enable.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAMpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAOjE;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,cAAc,EAAE;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAM7F;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,EAAE,gBAAgB,CACxC,oBAAoB,EACpB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAqE3C,CAAC"}