@agentxm/client-core 0.1.6

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

@@ -0,0 +1,123 @@
+/**
+ * Uninstall skill executor — orchestrates per-skill removal pipeline.
+ *
+ * Pipeline: sanitize name -> read lockfile -> remove agent symlinks (concurrent) ->
+ * remove canonical dir -> remove lockfile entry.
+ *
+ * @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 { removeFromAllCanonicalLocations } from "../../utils/index.js";
+import { sanitizeName } from "../../extensions/utils.js";
+import { existsInAnyCanonicalLocation } from "../disk-check.js";
+import { getSkillFqn, isReferencedByExtensionPack } from "../utils.js";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Uninstall-skill operation handler.
+ *
+ * Reads workspace paths from the Workspace service, then orchestrates:
+ * 1. Sanitize skill name for filesystem
+ * 2. Read lockfile to determine installed agents
+ * 3. Remove agent symlinks concurrently (skip missing)
+ * 4. Remove from all known canonical locations (full uninstall only)
+ * 5. Remove or update lockfile entry
+ */
+export const uninstallSkill = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    const sanitizedName = sanitizeName(op.args.skillName);
+    // Read lockfile entry for this skill via Workspace
+    const lockEntryOption = yield* ws.getLockedSkill(op.args.skillName).pipe(Effect.mapError((e) => makeAppError({
+        code: "UNINSTALL_SKILL_LOCKFILE_READ_FAILED",
+        what: `Failed to read lockfile: ${e.what}`,
+        cause: e,
+    })));
+    const lockEntry = Option.getOrUndefined(lockEntryOption);
+    // Determine if skill is installed anywhere (check all known locations)
+    const installedOnDisk = yield* existsInAnyCanonicalLocation(fs, path, base, op.args.skillName);
+    if (!lockEntry && !installedOnDisk) {
+        return { result: "success", message: "not installed" };
+    }
+    // Determine which agents to remove from
+    const lockAgents = lockEntry?.agents ?? [];
+    const agentFilter = op.args.agents;
+    const isPartialUninstall = agentFilter.length > 0;
+    const agentsToRemove = isPartialUninstall ? agentFilter : lockAgents;
+    // Remove agent symlinks/copies concurrently.
+    // 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(agentsToRemove, (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" });
+    // Handle partial vs full uninstall
+    if (isPartialUninstall && lockEntry) {
+        const remainingAgents = lockAgents.filter((a) => !agentFilter.includes(a));
+        if (remainingAgents.length > 0) {
+            // Update lockfile entry with remaining agents via Workspace.setSkill
+            yield* ws
+                .setSkill({
+                name: op.args.skillName,
+                lockEntry: { ...lockEntry, agents: remainingAgents },
+                versionConstraint: Option.none(),
+            })
+                .pipe(Effect.mapError((e) => makeAppError({
+                code: "UNINSTALL_SKILL_LOCKFILE_WRITE_FAILED",
+                what: `Failed to update lockfile: ${e.what}`,
+                cause: e,
+            })));
+            const agentList = [...agentsToRemove].join(", ");
+            return {
+                result: "success",
+                message: `Uninstalled ${op.args.skillName} from ${agentList}`,
+            };
+        }
+        // Fall through to full uninstall if no agents remain
+    }
+    // Check if a pack still references this skill
+    const lockedPacks = yield* ws
+        .getLockedExtensionPacks()
+        .pipe(Effect.catch(() => Effect.succeed({})));
+    const fqn = getSkillFqn(op.args.skillName, lockEntry);
+    const packOwned = fqn !== undefined && isReferencedByExtensionPack(fqn, lockedPacks);
+    if (packOwned) {
+        // Pack still references this skill — remove from settings only, keep lockfile + disk
+        yield* ws.removeSkillFromSettings(op.args.skillName).pipe(Effect.catch(() => Effect.void));
+        return {
+            result: "success",
+            message: `Uninstalled ${op.args.skillName}`,
+        };
+    }
+    // Full uninstall: remove from all known canonical locations
+    if (installedOnDisk) {
+        yield* removeFromAllCanonicalLocations(fs, base, sanitizedName, path);
+    }
+    // Remove from both settings and lockfile (swallow errors on full uninstall)
+    yield* ws.removeSkill(op.args.skillName).pipe(Effect.catch(() => Effect.void));
+    return {
+        result: "success",
+        message: `Uninstalled ${op.args.skillName}`,
+    };
+});
+//# sourceMappingURL=uninstall.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * Centralized skill path computation.
+ *
+ * Provides types and a pure function for computing skill directory paths
+ * based on source type (registry vs non-registry).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { Handle } from "../extensions/handle.js";
+/**
+ * Minimal structural discriminant for determining skill path layout.
+ *
+ * Registry refs carry an owner for the canonical path; all other ref types
+ * use the shared external extensions directory.
+ */
+export type SkillPathSource = {
+    readonly refType: "registry";
+    readonly owner: Handle;
+} | {
+    readonly refType: "git-hosted" | "local";
+};
+/**
+ * Computed paths for an installed skill directory.
+ *
+ * - `canonicalPath`: root of the installed skill
+ * - `skillSrcPath`: where actual skill source files live
+ *
+ * Non-registry: `canonicalPath === skillSrcPath` = `<base>/.axm/extensions/external/skills/<sanitized-name>`
+ * Registry: `canonicalPath` = `<base>/.axm/extensions/<owner>/skills/<sanitized-name>`,
+ *           `skillSrcPath` = `<canonicalPath>/src`
+ */
+export interface SkillDirPaths {
+    readonly canonicalPath: string;
+    readonly skillSrcPath: string;
+}
+/**
+ * Pure function to compute skill directory paths.
+ *
+ * @param join - Path join function (e.g., `path.join`)
+ * @param base - Workspace root (parent of `.axm`)
+ * @param source - Source type discriminant
+ * @param sanitizedName - Sanitized skill name for filesystem use
+ */
+export declare const computeSkillPaths: (join: (...paths: string[]) => string, base: string, source: SkillPathSource, sanitizedName: string) => SkillDirPaths;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAA;CAAE,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,EACpC,MAAM,MAAM,EACZ,QAAQ,eAAe,EACvB,eAAe,MAAM,KACpB,aAaF,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Centralized skill path computation.
+ *
+ * Provides types and a pure function for computing skill directory paths
+ * based on source type (registry vs non-registry).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import { EXTERNAL_EXTENSIONS_DIR, REGISTRY_EXTENSIONS_DIR } from "../extensions/index.js";
+/**
+ * Pure function to compute skill directory paths.
+ *
+ * @param join - Path join function (e.g., `path.join`)
+ * @param base - Workspace root (parent of `.axm`)
+ * @param source - Source type discriminant
+ * @param sanitizedName - Sanitized skill name for filesystem use
+ */
+export const computeSkillPaths = (join, base, source, sanitizedName) => {
+    if (source.refType === "registry") {
+        const canonicalPath = join(base, REGISTRY_EXTENSIONS_DIR, source.owner, "skills", sanitizedName);
+        return { canonicalPath, skillSrcPath: join(canonicalPath, "src") };
+    }
+    const canonicalPath = join(base, EXTERNAL_EXTENSIONS_DIR, "skills", sanitizedName);
+    return { canonicalPath, skillSrcPath: canonicalPath };
+};
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/unstable/skills/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AA4B1F;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAoC,EACpC,IAAY,EACZ,MAAuB,EACvB,aAAqB,EACN,EAAE;IACjB,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,aAAa,GAAG,IAAI,CACxB,IAAI,EACJ,uBAAuB,EACvB,MAAM,CAAC,KAAK,EACZ,QAAQ,EACR,aAAa,CACd,CAAC;QACF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IACrE,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IACnF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AACxD,CAAC,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { ReconciliationAdapter } from "../workspace/reconciliation-types.js";
+export declare const skillReconciliationAdapter: ReconciliationAdapter;
+export declare const assertSkillAdapterLoaded: (_adapter: typeof skillReconciliationAdapter) => void;
+//# sourceMappingURL=reconciliation-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-adapter.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/reconciliation-adapter.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,sCAAsC,CAAC;AAyB9C,eAAO,MAAM,0BAA0B,EAAE,qBA4GxC,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,UAAU,OAAO,0BAA0B,KAAG,IAEtF,CAAC"}

package/dist/src/unstable/skills/reconciliation-adapter.js

@@ -0,0 +1,115 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import {} from "../extensions/common.js";
+import {} from "../extensions/handle.js";
+import { parseRegistrySourceRef } from "../extensions/registry-source.js";
+import { decodeVersionConstraintSync, } from "../version-constraints/version-constraints.js";
+import { decodeExtensionNameSync, readAndDecodeManifest } from "../extensions/index.js";
+import { SkillManifestSchema, MANIFEST_FILENAME } from "./manifest-schema.js";
+import { computeSkillPaths } from "./paths.js";
+const parseRegistrySkillSource = (source) => {
+    if (source === "registry") {
+        return Option.none();
+    }
+    const parsed = parseRegistrySourceRef(source);
+    if (parsed === undefined || parsed.type !== "skills") {
+        return Option.none();
+    }
+    return Option.some({
+        owner: parsed.owner,
+        name: parsed.name,
+        constraint: parsed.versionConstraint ?? decodeVersionConstraintSync("*"),
+    });
+};
+export const skillReconciliationAdapter = {
+    type: "skills",
+    scanDeclarations: (context) => {
+        const declarations = [];
+        const skills = context.settings.skills ?? {};
+        for (const [name, entry] of Object.entries(skills)) {
+            const source = entry.source;
+            const parsed = parseRegistrySkillSource(source);
+            declarations.push({
+                type: "skills",
+                owner: Option.match(parsed, {
+                    onNone: () => context.defaultProfile,
+                    onSome: (value) => value.owner,
+                }),
+                name: Option.match(parsed, {
+                    onNone: () => decodeExtensionNameSync(name),
+                    onSome: (value) => value.name,
+                }),
+                source,
+                declarationSourceOrConstraint: Option.match(parsed, {
+                    onNone: () => source,
+                    onSome: (value) => value.constraint,
+                }),
+                order: declarations.length,
+                origin: "settings",
+            });
+        }
+        return Effect.succeed({ declarations, warnings: [] });
+    },
+    checkDiskCompatibility: (declaration, context, env) => Effect.gen(function* () {
+        const parsed = parseRegistrySkillSource(declaration.source);
+        if (declaration.source !== "registry" && Option.isNone(parsed)) {
+            return {
+                _tag: "Unresolved",
+                declaration,
+                reason: "declaration-mismatch",
+            };
+        }
+        const owner = Option.match(parsed, {
+            onNone: () => declaration.owner,
+            onSome: (value) => value.owner,
+        });
+        const diskName = Option.match(parsed, {
+            onNone: () => declaration.name,
+            onSome: (value) => value.name,
+        });
+        const canonicalPath = computeSkillPaths(env.path.join, context.baseDir, { refType: "registry", owner }, diskName).canonicalPath;
+        const decodeSkillManifest = (json) => {
+            try {
+                return Schema.decodeUnknownSync(SkillManifestSchema)(json);
+            }
+            catch {
+                return null;
+            }
+        };
+        const result = yield* readAndDecodeManifest(declaration, canonicalPath, MANIFEST_FILENAME, decodeSkillManifest, "skill", env);
+        if (result._tag !== "ok")
+            return result;
+        const { manifest } = result;
+        if (manifest.owner !== owner || manifest.name !== diskName) {
+            return {
+                _tag: "Unresolved",
+                declaration,
+                reason: "declaration-mismatch",
+            };
+        }
+        const timestamp = context.now;
+        return {
+            _tag: "Compatible",
+            reconstructed: {
+                type: "skills",
+                name: declaration.name,
+                entry: {
+                    type: "registry",
+                    owner,
+                    name: diskName,
+                    resolvedVersion: manifest.version,
+                    integrity: "",
+                    sourceName: "default",
+                    agents: context.agents,
+                    installedAt: timestamp,
+                    updatedAt: timestamp,
+                },
+            },
+        };
+    }),
+};
+export const assertSkillAdapterLoaded = (_adapter) => {
+    void _adapter;
+};
+//# sourceMappingURL=reconciliation-adapter.js.map

package/dist/src/unstable/skills/reconciliation-adapter.js.map

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

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

@@ -0,0 +1,20 @@
+/**
+ * Skill extension ref types.
+ *
+ * Concrete ref types for skill extensions, built on the shared
+ * ExtensionRefBase and ref detail interfaces.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { SkillExtensionRefBase, GitHostedRefDetails, RegistryRefDetails, LocalRefDetails } from "../extensions/ref-base.js";
+import type { GitBasedSource, RegistrySource, LocalSource } from "../sources/types.js";
+/** @experimental */
+export type GitHostedSkillRef = SkillExtensionRefBase<"git-hosted", GitBasedSource> & GitHostedRefDetails;
+/** @experimental */
+export type RegistrySkillRef = SkillExtensionRefBase<"registry", RegistrySource> & RegistryRefDetails;
+/** @experimental */
+export type LocalSkillRef = SkillExtensionRefBase<"local", LocalSource> & LocalRefDetails;
+/** @experimental */
+export type SkillExtensionRef = GitHostedSkillRef | RegistrySkillRef | LocalSkillRef;
+//# sourceMappingURL=refs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvF,oBAAoB;AACpB,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,YAAY,EAAE,cAAc,CAAC,GACjF,mBAAmB,CAAC;AACtB,oBAAoB;AACpB,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,UAAU,EAAE,cAAc,CAAC,GAC9E,kBAAkB,CAAC;AACrB,oBAAoB;AACpB,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,eAAe,CAAC;AAE1F,oBAAoB;AACpB,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,aAAa,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Skill extension ref types.
+ *
+ * Concrete ref types for skill extensions, built on the shared
+ * ExtensionRefBase and ref detail interfaces.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=refs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../../../src/unstable/skills/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/src/unstable/skills/registry-ref-builder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Helper for building registry skill refs from pack resolved maps.
+ *
+ * Used by the pack install handler to construct synthetic refs from typed parts + version
+ * entries in a pack's resolved extensions maps.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { Handle, ExtensionName } from "../extensions/index.js";
+import type { RegistrySkillRef } from "./refs.js";
+import type { RegistrySource } from "../sources/index.js";
+import type { ExactSemverVersion } from "../version-constraints/version-constraints.js";
+import type { PackageUrlParts } from "../packaging/package-url.js";
+/**
+ * Build a RegistrySkillRef from typed owner/name parts and version.
+ */
+export declare const buildRegistrySkillRef: (owner: Handle, name: ExtensionName, version: ExactSemverVersion, source: RegistrySource, compatiblePackages: ReadonlyArray<PackageUrlParts>) => RegistrySkillRef;
+//# sourceMappingURL=registry-ref-builder.d.ts.map

package/dist/src/unstable/skills/registry-ref-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-ref-builder.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/registry-ref-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,MAAM,aAAa,EACnB,SAAS,kBAAkB,EAC3B,QAAQ,cAAc,EACtB,oBAAoB,aAAa,CAAC,eAAe,CAAC,KACjD,gBAUD,CAAC"}

package/dist/src/unstable/skills/registry-ref-builder.js

@@ -0,0 +1,24 @@
+/**
+ * Helper for building registry skill refs from pack resolved maps.
+ *
+ * Used by the pack install handler to construct synthetic refs from typed parts + version
+ * entries in a pack's resolved extensions maps.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Option from "effect/Option";
+/**
+ * Build a RegistrySkillRef from typed owner/name parts and version.
+ */
+export const buildRegistrySkillRef = (owner, name, version, source, compatiblePackages) => ({
+    type: "skill",
+    refType: "registry",
+    skill: { name, description: Option.none(), metadata: Option.none() },
+    source,
+    owner,
+    name,
+    version,
+    integrity: Option.none(),
+    compatiblePackages,
+});
+//# sourceMappingURL=registry-ref-builder.js.map

package/dist/src/unstable/skills/registry-ref-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-ref-builder.js","sourceRoot":"","sources":["../../../../src/unstable/skills/registry-ref-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAOxC;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,KAAa,EACb,IAAmB,EACnB,OAA2B,EAC3B,MAAsB,EACtB,kBAAkD,EAChC,EAAE,CAAC,CAAC;IACtB,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE;IACpE,MAAM;IACN,KAAK;IACL,IAAI;IACJ,OAAO;IACP,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;IACxB,kBAAkB;CACnB,CAAC,CAAC"}

package/dist/src/unstable/skills/skill-content.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Skill content file module for SKILL.md parsing and frontmatter schemas.
+ *
+ * Defines the frontmatter schema for SKILL.md files and a parser that
+ * combines the shared frontmatter utility with skill-specific validation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import type { Skill } from "./types.js";
+/**
+ * Schema for SKILL.md frontmatter fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SkillFrontmatterSchema: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly description: Schema.String;
+    readonly metadata: Schema.optionalKey<Schema.Unknown>;
+}>;
+/**
+ * Parse a SKILL.md file's content and extract skill metadata from frontmatter.
+ *
+ * Returns `Option.some(Skill)` when the file has valid YAML frontmatter with
+ * non-empty `name` and `description` fields. Returns `Option.none()` for any
+ * invalid input: missing frontmatter, invalid YAML, or missing/empty required fields.
+ */
+export declare const parseSkillMd: (content: string) => Option.Option<Skill>;
+//# sourceMappingURL=skill-content.d.ts.map

package/dist/src/unstable/skills/skill-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/skill-content.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAUxC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;EAcjC,CAAC;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAoCjE,CAAC"}

package/dist/src/unstable/skills/skill-content.js

@@ -0,0 +1,69 @@
+/**
+ * Skill content file module for SKILL.md parsing and frontmatter schemas.
+ *
+ * Defines the frontmatter schema for SKILL.md files and a parser that
+ * combines the shared frontmatter utility with skill-specific validation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Option from "effect/Option";
+import * as Record from "effect/Record";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { parseFrontmatterSync } from "../extensions/frontmatter.js";
+const NonEmptyTrimmedStringSchema = Schema.String.pipe(Schema.check(Schema.makeFilter((input) => input.trim().length > 0 ? undefined : "Expected a non-empty string")));
+/**
+ * Schema for SKILL.md frontmatter fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SkillFrontmatterSchema = Schema.Struct({
+    name: NonEmptyTrimmedStringSchema.pipe(Schema.annotateKey({ messageMissingKey: "skill name is required in SKILL.md frontmatter" })),
+    description: NonEmptyTrimmedStringSchema.pipe(Schema.annotateKey({
+        messageMissingKey: "skill description is required in SKILL.md frontmatter",
+    })),
+    metadata: Schema.optionalKey(Schema.Unknown),
+}).annotate({
+    identifier: "SkillFrontmatter",
+    title: "Skill Frontmatter",
+    description: "Metadata at the top of a SKILL.md file — must include a name and description.",
+});
+const decodeMetadata = Schema.decodeUnknownResult(Schema.Record(Schema.String, Schema.Unknown));
+/**
+ * Parse a SKILL.md file's content and extract skill metadata from frontmatter.
+ *
+ * Returns `Option.some(Skill)` when the file has valid YAML frontmatter with
+ * non-empty `name` and `description` fields. Returns `Option.none()` for any
+ * invalid input: missing frontmatter, invalid YAML, or missing/empty required fields.
+ */
+export const parseSkillMd = (content) => {
+    try {
+        const parsed = parseFrontmatterSync(content);
+        if (parsed.frontmatter === undefined) {
+            return Option.none();
+        }
+        const frontmatter = Result.match(Schema.decodeUnknownResult(SkillFrontmatterSchema)(parsed.frontmatter), {
+            onFailure: () => undefined,
+            onSuccess: (validated) => validated,
+        });
+        if (frontmatter === undefined) {
+            return Option.none();
+        }
+        const metadata = frontmatter.metadata === undefined
+            ? Option.none()
+            : Result.match(decodeMetadata(frontmatter.metadata), {
+                onFailure: () => Option.none(),
+                onSuccess: (value) => Option.some(value),
+            });
+        return Option.some({
+            name: frontmatter.name,
+            description: frontmatter.description,
+            metadata,
+        });
+    }
+    catch {
+        // Invalid YAML or other parsing errors — silently skip
+        return Option.none();
+    }
+};
+//# sourceMappingURL=skill-content.js.map

package/dist/src/unstable/skills/skill-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content.js","sourceRoot":"","sources":["../../../../src/unstable/skills/skill-content.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGpE,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACpD,MAAM,CAAC,KAAK,CACV,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1B,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,6BAA6B,CACpE,CACF,CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,2BAA2B,CAAC,IAAI,CACpC,MAAM,CAAC,WAAW,CAAC,EAAE,iBAAiB,EAAE,gDAAgD,EAAE,CAAC,CAC5F;IACD,WAAW,EAAE,2BAA2B,CAAC,IAAI,CAC3C,MAAM,CAAC,WAAW,CAAC;QACjB,iBAAiB,EAAE,uDAAuD;KAC3E,CAAC,CACH;IACD,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC;CAC7C,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,kBAAkB;IAC9B,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,+EAA+E;CAC7F,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAEhG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAwB,EAAE;IACpE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAE7C,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAC9B,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EACtE;YACE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS;YAC1B,SAAS,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS;SACpC,CACF,CAAC;QACF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,QAAQ,GACZ,WAAW,CAAC,QAAQ,KAAK,SAAS;YAChC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;YACf,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;gBACjD,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;gBAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aACzC,CAAC,CAAC;QAET,OAAO,MAAM,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;QACvD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Core domain types for skills management.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import * as Record from "effect/Record";
+/**
+ * Represents a discovered skill.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface Skill {
+    /** Unique name of the skill */
+    readonly name: string;
+    /** Description of the skill */
+    readonly description: string;
+    /** Optional metadata from SKILL.md frontmatter */
+    readonly metadata: Option.Option<Record.ReadonlyRecord<string, unknown>>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1E"}

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

@@ -0,0 +1,9 @@
+/**
+ * Core domain types for skills management.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import * as Record from "effect/Record";
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/unstable/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * Post-discovery skill utilities.
+ *
+ * Display name resolution, filtering by name, and name sanitization
+ * for discovered skills. Consumed by the install handler and UI layer.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { ExtensionPacksLockMap } from "../lockfile/index.js";
+import type { SkillExtensionRef } from "./refs.js";
+export declare const getSkillDisplayName: (ref: SkillExtensionRef) => string;
+/**
+ * Derive the FQN (`@owner/skills/name`) for a skill lock entry, if it's a registry entry.
+ */
+export declare const getSkillFqn: (skillName: string, lockEntry: {
+    type: string;
+    owner?: string;
+    name?: string;
+} | undefined) => string | undefined;
+/**
+ * Check if a skill is referenced by any extension pack's `resolvedSkills`.
+ *
+ * Pure function — scans all extension pack lock entries for the given FQN.
+ */
+export declare const isReferencedByExtensionPack: (skillFqn: string, lockedPacks: ExtensionPacksLockMap) => boolean;
+/**
+ * Return the names of extension packs that reference a skill by its FQN.
+ *
+ * Superset of `isReferencedByExtensionPack` — returns extension pack names instead of a boolean.
+ */
+export declare const getReferencingExtensionPacks: (skillFqn: string, lockedPacks: ExtensionPacksLockMap) => ReadonlyArray<string>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAoBnD,eAAO,MAAM,mBAAmB,GAAI,KAAK,iBAAiB,KAAG,MAIxC,CAAC;AAMtB;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,WAAW;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,KACrE,MAAM,GAAG,SAMX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,UAAU,MAAM,EAChB,aAAa,qBAAqB,KACjC,OAAqF,CAAC;AAEzF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,MAAM,EAChB,aAAa,qBAAqB,KACjC,aAAa,CAAC,MAAM,CAGG,CAAC"}