@agentxm/client-core 0.1.6

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

@@ -0,0 +1,56 @@
+/**
+ * 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 { stripFileProtocol } from "../utils/index.js";
+// -----------------------------------------------------------------------------
+// Display Name
+// -----------------------------------------------------------------------------
+/**
+ * Returns the display name for a skill.
+ *
+ * Uses `skill.name` when present, falls back to `basename(location)`.
+ */
+/**
+ * Extract the last path segment from a location string.
+ */
+const basenamePure = (location) => {
+    const stripped = stripFileProtocol(location);
+    return stripped.split("/").pop() ?? stripped;
+};
+export const getSkillDisplayName = (ref) => ref.skill.name ||
+    (ref.refType === "git-hosted" || ref.refType === "local"
+        ? basenamePure(ref.location)
+        : ref.skill.name);
+// -----------------------------------------------------------------------------
+// Extension-pack-reference helpers
+// -----------------------------------------------------------------------------
+/**
+ * Derive the FQN (`@owner/skills/name`) for a skill lock entry, if it's a registry entry.
+ */
+export const getSkillFqn = (skillName, lockEntry) => {
+    if (lockEntry?.type === "registry" && lockEntry.owner && lockEntry.name) {
+        return `${lockEntry.owner}/skills/${lockEntry.name}`;
+    }
+    // For non-registry entries, the skill name itself may be a FQN (e.g., "@owner/skills/name")
+    return skillName.startsWith("@") ? skillName : 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 const isReferencedByExtensionPack = (skillFqn, lockedPacks) => Object.values(lockedPacks).some((pack) => skillFqn in pack.resolvedSkills);
+/**
+ * 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 const getReferencingExtensionPacks = (skillFqn, lockedPacks) => Object.entries(lockedPacks)
+    .filter(([, pack]) => skillFqn in pack.resolvedSkills)
+    .map(([name]) => name);
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/unstable/skills/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;GAIG;AACH;;GAEG;AACH,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAU,EAAE;IAChD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAsB,EAAU,EAAE,CACpE,GAAG,CAAC,KAAK,CAAC,IAAI;IACd,CAAC,GAAG,CAAC,OAAO,KAAK,YAAY,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO;QACtD,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC5B,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAEtB,gFAAgF;AAChF,mCAAmC;AACnC,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,SAAiB,EACjB,SAAsE,EAClD,EAAE;IACtB,IAAI,SAAS,EAAE,IAAI,KAAK,UAAU,IAAI,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACxE,OAAO,GAAG,SAAS,CAAC,KAAK,WAAW,SAAS,CAAC,IAAI,EAAE,CAAC;IACvD,CAAC;IACD,4FAA4F;IAC5F,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,QAAgB,EAChB,WAAkC,EACzB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC;AAEzF;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,QAAgB,EAChB,WAAkC,EACX,EAAE,CACzB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;KACxB,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC,cAAc,CAAC;KACrD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC"}

package/dist/src/unstable/source-resolution/discover-skills.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Skill discovery algorithm (3-phase: direct match, priority scan, recursive fallback).
+ *
+ * The `discoverSkillsInDir` function is used by source providers (local, git-hosting)
+ * to discover skills within a directory structure.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { Skill } from "../skills/types.js";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { type AppError } from "../app-error/index.js";
+/**
+ * A discovered skill — intermediate result from directory scanning.
+ *
+ * Does not carry source, version, or gitTreeSha — the caller (provider)
+ * enriches with those after discovery.
+ */
+export interface DiscoveredSkill {
+    readonly type: "skill";
+    readonly skill: Skill;
+    /** file:// URL to the skill directory */
+    readonly location: string;
+}
+/**
+ * Options controlling discovery behavior.
+ */
+export interface DiscoveryOptions {
+    /** Exhaustive recursive search even if root skill found */
+    readonly fullDepth: boolean;
+    /** Include skills with metadata.internal: true */
+    readonly includeInternal: boolean;
+}
+/**
+ * Derive the full Phase 2 priority directory list.
+ *
+ * Composition:
+ * 1. `.` (searchPath root) — always first, highest priority
+ * 2. Non-agent static dirs: skills/.curated, skills/.experimental, skills/.system
+ * 3. Agent dirs: unique `skills.dir` values from the AgentDescriptor registry
+ */
+export declare const getPriorityDirectories: () => ReadonlyArray<string>;
+/**
+ * Discover skills in a directory using a 3-phase algorithm:
+ *
+ * Phase 1 — Direct match: check if search root itself contains SKILL.md
+ * Phase 2 — Priority directory scan: scan well-known directories one level deep
+ * Phase 3 — Recursive fallback: bounded DFS when prior phases find nothing or fullDepth is true
+ *
+ * Skills are deduplicated by name (first-found wins). Internal skills are
+ * filtered unless opted in.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const discoverSkillsInDir: (basePath: string, subPath: Option.Option<string>, options: DiscoveryOptions) => Effect.Effect<ReadonlyArray<DiscoveredSkill>, AppError, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=discover-skills.d.ts.map

package/dist/src/unstable/source-resolution/discover-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-skills.d.ts","sourceRoot":"","sources":["../../../../src/unstable/source-resolution/discover-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAIpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AAGpE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAWD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAoBD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,QAAO,aAAa,CAAC,MAAM,CAG7D,CAAC;AAiJF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,EAChB,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAC9B,SAAS,gBAAgB,KACxB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CA2ExF,CAAC"}

package/dist/src/unstable/source-resolution/discover-skills.js

@@ -0,0 +1,218 @@
+/**
+ * Skill discovery algorithm (3-phase: direct match, priority scan, recursive fallback).
+ *
+ * The `discoverSkillsInDir` function is used by source providers (local, git-hosting)
+ * to discover skills within a directory structure.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { getAllAgents } from "../agents/index.js";
+import { parseManifests } from "./parse-manifests.js";
+import { parseSkillMd } from "../skills/skill-content.js";
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { makeAppError } from "../app-error/index.js";
+import { envOption } from "../utils/index.js";
+/**
+ * Build a DiscoveredSkill from a skill and its directory path.
+ */
+const makeDiscoveredSkill = (skill, fullPath) => ({
+    type: "skill",
+    skill,
+    location: `file://${fullPath}`,
+});
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+/**
+ * Exact filename for skill definition files.
+ */
+const SKILL_FILENAME = "SKILL.md";
+/**
+ * Non-agent static directories for Phase 2 priority scan.
+ */
+const STATIC_PRIORITY_DIRECTORIES = [
+    "skills/.curated",
+    "skills/.experimental",
+    "skills/.system",
+];
+/**
+ * Derive the full Phase 2 priority directory list.
+ *
+ * Composition:
+ * 1. `.` (searchPath root) — always first, highest priority
+ * 2. Non-agent static dirs: skills/.curated, skills/.experimental, skills/.system
+ * 3. Agent dirs: unique `skills.dir` values from the AgentDescriptor registry
+ */
+export const getPriorityDirectories = () => {
+    const agentDirs = Array.dedupe(Array.map(getAllAgents(), (agent) => agent.skills.dir));
+    return [".", ...STATIC_PRIORITY_DIRECTORIES, ...agentDirs];
+};
+/**
+ * Directories to skip during recursive Phase 3 scan.
+ */
+const SKIPPED_DIRECTORIES = new Set(["node_modules", ".git", "dist", "build", "__pycache__"]);
+/**
+ * Maximum recursion depth for Phase 3.
+ */
+const MAX_DEPTH = 5;
+// -----------------------------------------------------------------------------
+// Internal Skill Filtering
+// -----------------------------------------------------------------------------
+const isInternalSkill = (skill) => Option.match(skill.metadata, {
+    onNone: () => false,
+    onSome: (m) => m["internal"] === true,
+});
+const shouldIncludeSkill = (skill, options, installInternalSkills) => {
+    if (!isInternalSkill(skill))
+        return true;
+    const envVal = Option.getOrUndefined(installInternalSkills);
+    return options.includeInternal || envVal === "1" || envVal === "true";
+};
+// -----------------------------------------------------------------------------
+// Phase Helpers
+// -----------------------------------------------------------------------------
+/**
+ * Try to find and parse a SKILL.md in a given directory.
+ * Returns Option.some(Skill) if found and valid, Option.none() otherwise.
+ * All errors are silently swallowed.
+ */
+const tryParseSkillInDir = (dir) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const entries = yield* fs.readDirectory(dir).pipe(Effect.option);
+    if (Option.isNone(entries))
+        return Option.none();
+    if (!entries.value.includes(SKILL_FILENAME))
+        return Option.none();
+    const fullPath = path.join(dir, SKILL_FILENAME);
+    const content = yield* fs.readFileString(fullPath).pipe(Effect.option);
+    if (Option.isNone(content))
+        return Option.none();
+    return parseSkillMd(content.value);
+});
+/**
+ * Scan one level of children in a directory for skills.
+ * Each immediate subdirectory is checked for a SKILL.md.
+ */
+const scanDirectory = (dir, options, installInternalSkills) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const entries = yield* fs.readDirectory(dir).pipe(Effect.option);
+    if (Option.isNone(entries))
+        return [];
+    return yield* Effect.forEach(entries.value, (entry) => Effect.gen(function* () {
+        const fullPath = path.join(dir, entry);
+        const stat = yield* fs.stat(fullPath).pipe(Effect.option);
+        if (Option.isNone(stat) || stat.value.type !== "Directory")
+            return [];
+        const skill = yield* tryParseSkillInDir(fullPath);
+        if (Option.isNone(skill))
+            return [];
+        if (!shouldIncludeSkill(skill.value, options, installInternalSkills))
+            return [];
+        return [makeDiscoveredSkill(skill.value, fullPath)];
+    }), { concurrency: "unbounded" }).pipe(Effect.map((results) => Array.flatten(results)));
+});
+/**
+ * Recursive DFS scan with depth limit.
+ * Skips well-known non-skill directories.
+ */
+const recursiveScan = (dir, options, depth, installInternalSkills) => Effect.gen(function* () {
+    if (depth > MAX_DEPTH)
+        return [];
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const entries = yield* fs.readDirectory(dir).pipe(Effect.option);
+    if (Option.isNone(entries))
+        return [];
+    return yield* Effect.forEach(entries.value, (entry) => Effect.gen(function* () {
+        if (SKIPPED_DIRECTORIES.has(entry))
+            return [];
+        const fullPath = path.join(dir, entry);
+        const stat = yield* fs.stat(fullPath).pipe(Effect.option);
+        if (Option.isNone(stat) || stat.value.type !== "Directory")
+            return [];
+        // Try to parse a skill in this directory
+        const skill = yield* tryParseSkillInDir(fullPath);
+        const current = Option.isSome(skill) && shouldIncludeSkill(skill.value, options, installInternalSkills)
+            ? [makeDiscoveredSkill(skill.value, fullPath)]
+            : [];
+        // Recurse into subdirectories
+        const subResults = yield* recursiveScan(fullPath, options, depth + 1, installInternalSkills);
+        return [...current, ...subResults];
+    }), { concurrency: "unbounded" }).pipe(Effect.map((results) => Array.flatten(results)));
+});
+// -----------------------------------------------------------------------------
+// 3-Phase Discovery
+// -----------------------------------------------------------------------------
+/**
+ * Discover skills in a directory using a 3-phase algorithm:
+ *
+ * Phase 1 — Direct match: check if search root itself contains SKILL.md
+ * Phase 2 — Priority directory scan: scan well-known directories one level deep
+ * Phase 3 — Recursive fallback: bounded DFS when prior phases find nothing or fullDepth is true
+ *
+ * Skills are deduplicated by name (first-found wins). Internal skills are
+ * filtered unless opted in.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const discoverSkillsInDir = (basePath, subPath, options) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const installInternalSkills = yield* envOption("INSTALL_INTERNAL_SKILLS");
+    // Compute effective search root
+    const searchRoot = Option.match(subPath, {
+        onNone: () => basePath,
+        onSome: (p) => path.join(basePath, p),
+    });
+    // Verify the search root exists and is a directory
+    const stat = yield* fs.stat(searchRoot).pipe(Effect.mapError((error) => makeAppError({
+        code: "SKILLS_DISCOVERY_FAILED",
+        what: `Directory does not exist or is not accessible: ${searchRoot}`,
+        cause: error,
+    })));
+    if (stat.type !== "Directory") {
+        return yield* makeAppError({
+            code: "SKILLS_DISCOVERY_FAILED",
+            what: `Path is not a directory: ${searchRoot}`,
+        });
+    }
+    // ── Phase 1: Direct Match ──────────────────────────────────────────
+    const rootSkill = yield* tryParseSkillInDir(searchRoot);
+    const phase1Skills = Option.isSome(rootSkill) &&
+        shouldIncludeSkill(rootSkill.value, options, installInternalSkills)
+        ? [makeDiscoveredSkill(rootSkill.value, searchRoot)]
+        : [];
+    if (phase1Skills.length > 0 && !options.fullDepth) {
+        return phase1Skills;
+    }
+    // ── Phase 2: Priority Directory Scan ───────────────────────────────
+    // Collect manifest-declared directories to append to priority scan
+    const manifestDirs = yield* parseManifests(searchRoot);
+    // Build full list of directories to scan: derived priority dirs + manifest dirs
+    const priorityDirs = getPriorityDirectories();
+    const priorityFullDirs = priorityDirs.map((priorityDir) => priorityDir === "." ? searchRoot : path.join(searchRoot, priorityDir));
+    // Deduplicate manifest dirs against static priority dirs
+    const manifestDirsToAdd = manifestDirs.filter((d) => !priorityFullDirs.includes(d));
+    const allPriorityDirs = [...priorityFullDirs, ...manifestDirsToAdd];
+    const phase2Skills = yield* Effect.forEach(allPriorityDirs, (fullDir) => scanDirectory(fullDir, options, installInternalSkills), { concurrency: "unbounded" }).pipe(Effect.map((results) => Array.flatten(results)));
+    // ── Phase 3: Recursive Fallback ────────────────────────────────────
+    const shouldRunPhase3 = (phase1Skills.length === 0 && phase2Skills.length === 0) || options.fullDepth;
+    const phase3Skills = shouldRunPhase3
+        ? yield* recursiveScan(searchRoot, options, 0, installInternalSkills)
+        : [];
+    // Deduplicate by name (first-found wins across phases)
+    const seen = new Set();
+    return [...phase1Skills, ...phase2Skills, ...phase3Skills].filter(({ skill: { name } }) => {
+        if (seen.has(name))
+            return false;
+        seen.add(name);
+        return true;
+    });
+});
+//# sourceMappingURL=discover-skills.js.map

package/dist/src/unstable/source-resolution/discover-skills.js.map

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

package/dist/src/unstable/source-resolution/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Source resolution module.
+ *
+ * Provides source host providers, source resolution, skill discovery,
+ * and multi-source pattern resolution.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { discoverSkillsInDir, getPriorityDirectories, type DiscoveredSkill, type DiscoveryOptions, } from "./discover-skills.js";
+export { parseManifests } from "./parse-manifests.js";
+export { createGitSourceHostProvider } from "./providers/git.js";
+export { createAzureReposSourceHostProvider, createBitbucketSourceHostProvider, createGitHostingSourceHostProvider, createGitHubSourceHostProvider, createGitLabSourceHostProvider, } from "./providers/git-hosting.js";
+export { createLocalSourceHostProvider } from "./providers/local.js";
+export { createLocalRegistrySourceHostProvider, createRegistrySourceHostProviderFromHost, createRemoteRegistrySourceHostProvider, } from "./providers/registry/host-provider.js";
+export type { SourceHostProvidersService } from "./service.js";
+export { SourceHostProviders, SourceHostProvidersLive, createRegistryMetaProvider, } from "./service.js";
+export { resolveSource, resolveShorthandInputSource, resolveSlashInputSource, routeUrlInput, routeScpInput, routeNameInput, routeRegistryInput, } from "./resolve-source.js";
+export { resolveSourcePattern } from "./resolve-source-pattern.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/source-resolution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/source-resolution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EACL,kCAAkC,EAClC,iCAAiC,EACjC,kCAAkC,EAClC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,qCAAqC,EACrC,wCAAwC,EACxC,sCAAsC,GACvC,MAAM,uCAAuC,CAAC;AAG/C,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/src/unstable/source-resolution/index.js

@@ -0,0 +1,23 @@
+/**
+ * Source resolution module.
+ *
+ * Provides source host providers, source resolution, skill discovery,
+ * and multi-source pattern resolution.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Skill discovery
+export { discoverSkillsInDir, getPriorityDirectories, } from "./discover-skills.js";
+// Plugin manifest parsing
+export { parseManifests } from "./parse-manifests.js";
+// Provider implementations
+export { createGitSourceHostProvider } from "./providers/git.js";
+export { createAzureReposSourceHostProvider, createBitbucketSourceHostProvider, createGitHostingSourceHostProvider, createGitHubSourceHostProvider, createGitLabSourceHostProvider, } from "./providers/git-hosting.js";
+export { createLocalSourceHostProvider } from "./providers/local.js";
+export { createLocalRegistrySourceHostProvider, createRegistrySourceHostProviderFromHost, createRemoteRegistrySourceHostProvider, } from "./providers/registry/host-provider.js";
+export { SourceHostProviders, SourceHostProvidersLive, createRegistryMetaProvider, } from "./service.js";
+// Source resolver
+export { resolveSource, resolveShorthandInputSource, resolveSlashInputSource, routeUrlInput, routeScpInput, routeNameInput, routeRegistryInput, } from "./resolve-source.js";
+export { resolveSourcePattern } from "./resolve-source-pattern.js";
+//# sourceMappingURL=index.js.map

package/dist/src/unstable/source-resolution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/source-resolution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kBAAkB;AAClB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GAGvB,MAAM,sBAAsB,CAAC;AAE9B,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,2BAA2B;AAC3B,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EACL,kCAAkC,EAClC,iCAAiC,EACjC,kCAAkC,EAClC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,qCAAqC,EACrC,wCAAwC,EACxC,sCAAsC,GACvC,MAAM,uCAAuC,CAAC;AAI/C,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAEtB,kBAAkB;AAClB,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/src/unstable/source-resolution/parse-manifests.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Plugin manifest parsing for skill discovery.
+ *
+ * Parses .claude-plugin/marketplace.json and .claude-plugin/plugin.json
+ * to discover explicitly declared skill directories.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+/**
+ * Parse plugin manifests and return validated skill parent directories.
+ * All paths are validated to be within basePath.
+ * Errors are silently skipped (returns empty array on failure).
+ */
+export declare const parseManifests: (basePath: string) => Effect.Effect<ReadonlyArray<string>, never, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=parse-manifests.d.ts.map

package/dist/src/unstable/source-resolution/parse-manifests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-manifests.d.ts","sourceRoot":"","sources":["../../../../src/unstable/source-resolution/parse-manifests.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AA+LxC;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAO5E,CAAC"}

package/dist/src/unstable/source-resolution/parse-manifests.js

@@ -0,0 +1,168 @@
+/**
+ * Plugin manifest parsing for skill discovery.
+ *
+ * Parses .claude-plugin/marketplace.json and .claude-plugin/plugin.json
+ * to discover explicitly declared skill directories.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+// -----------------------------------------------------------------------------
+// Path Validation
+// -----------------------------------------------------------------------------
+const RelativeManifestPathSchema = Schema.String.pipe(Schema.check(Schema.makeFilter((input) => {
+    if (!input.startsWith("./"))
+        return "Expected a relative manifest path starting with ./";
+    if (input.includes(".."))
+        return "Manifest paths must not contain .. segments";
+    return undefined;
+})));
+const decodeRelativeManifestPath = Schema.decodeUnknownResult(RelativeManifestPathSchema);
+/**
+ * Validate a raw skill path from a manifest.
+ * Must start with `./`, must not contain `..`, and must resolve within basePath.
+ * Returns the parent directory of the skill path on success.
+ */
+const validatePath = (rawPath, basePath, path) => {
+    if (Result.isFailure(decodeRelativeManifestPath(rawPath)))
+        return Option.none();
+    // Resolve and check within basePath
+    const resolved = path.resolve(basePath, rawPath);
+    const normalizedBase = path.resolve(basePath);
+    if (!resolved.startsWith(normalizedBase + path.sep) && resolved !== normalizedBase) {
+        return Option.none();
+    }
+    // Return parent directory of the skill path
+    return Option.some(path.dirname(resolved));
+};
+// -----------------------------------------------------------------------------
+// Manifest Parsers
+// -----------------------------------------------------------------------------
+const MarketplacePlugin = Schema.Struct({
+    source: Schema.optional(Schema.Unknown),
+    skills: Schema.optional(Schema.Array(Schema.String)),
+});
+const MarketplaceManifest = Schema.Struct({
+    metadata: Schema.optional(Schema.Struct({ pluginRoot: Schema.optional(Schema.String) })),
+    plugins: Schema.Array(MarketplacePlugin),
+});
+const PluginManifest = Schema.Struct({
+    skills: Schema.Array(Schema.String),
+});
+/**
+ * Read a file and parse as JSON, returning None on any failure.
+ */
+const readDecodedJsonFile = (filePath, schema) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    if (Option.isNone(content))
+        return Option.none();
+    const decode = Schema.decodeUnknownSync(Schema.fromJsonString(schema));
+    return yield* Effect.sync(() => {
+        try {
+            return Option.some(decode(content.value));
+        }
+        catch {
+            return Option.none();
+        }
+    });
+});
+/**
+ * Validate a directory path from a manifest (not a skill path — no dirname).
+ * Must start with `./`, must not contain `..`, and must resolve within basePath.
+ * Returns the resolved directory path on success.
+ */
+const validateDirPath = (rawPath, basePath, path) => {
+    if (Result.isFailure(decodeRelativeManifestPath(rawPath)))
+        return Option.none();
+    const resolved = path.resolve(basePath, rawPath);
+    const normalizedBase = path.resolve(basePath);
+    if (!resolved.startsWith(normalizedBase + path.sep) && resolved !== normalizedBase) {
+        return Option.none();
+    }
+    return Option.some(resolved);
+};
+/**
+ * Resolve a plugin's base directory from its source field and pluginRoot.
+ * - string source: must start with `./`, resolve relative to basePath + pluginRoot
+ * - omitted source: resolve to basePath + pluginRoot (or basePath if no pluginRoot)
+ * - object source: skip (remote plugin)
+ */
+const resolvePluginBase = (source, basePath, pluginRoot, path) => {
+    const rootBase = pluginRoot ? path.resolve(basePath, pluginRoot) : path.resolve(basePath);
+    // Object source → skip plugin
+    if (typeof source === "object" && source !== null)
+        return Option.none();
+    if (typeof source === "string") {
+        return validateDirPath(source, rootBase, path);
+    }
+    // Omitted source → root-level plugin
+    return Option.some(rootBase);
+};
+/**
+ * Parse .claude-plugin/marketplace.json and return validated skill parent directories.
+ *
+ * Supports metadata.pluginRoot, per-plugin source (string/omitted/object),
+ * per-plugin skills array, and conventional {pluginBase}/skills/ directory.
+ */
+const parseMarketplaceJson = (basePath) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const manifestPath = path.join(basePath, ".claude-plugin", "marketplace.json");
+    const data = yield* readDecodedJsonFile(manifestPath, MarketplaceManifest);
+    if (Option.isNone(data))
+        return [];
+    const pluginRoot = data.value.metadata?.pluginRoot;
+    if (pluginRoot !== undefined && Result.isFailure(decodeRelativeManifestPath(pluginRoot))) {
+        return [];
+    }
+    return data.value.plugins.flatMap((plugin) => {
+        const pluginBase = resolvePluginBase(plugin.source, basePath, pluginRoot, path);
+        if (Option.isNone(pluginBase))
+            return [];
+        // Conventional {pluginBase}/skills/ always added
+        const conventional = [path.join(pluginBase.value, "skills")];
+        // Explicit skill paths transformed via dirname
+        const explicit = (plugin.skills ?? []).flatMap((skillPath) => {
+            const validated = validatePath(skillPath, pluginBase.value, path);
+            return Option.isSome(validated) ? [validated.value] : [];
+        });
+        return [...conventional, ...explicit];
+    });
+});
+/**
+ * Parse .claude-plugin/plugin.json and return validated skill parent directories.
+ *
+ * Expected shape: { skills: string[] }
+ */
+const parsePluginJson = (basePath) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const manifestPath = path.join(basePath, ".claude-plugin", "plugin.json");
+    const data = yield* readDecodedJsonFile(manifestPath, PluginManifest);
+    if (Option.isNone(data))
+        return [];
+    const validatedPaths = [];
+    for (const skillPath of data.value.skills) {
+        const validated = validatePath(skillPath, basePath, path);
+        if (Option.isSome(validated)) {
+            validatedPaths.push(validated.value);
+        }
+    }
+    return validatedPaths;
+});
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Parse plugin manifests and return validated skill parent directories.
+ * All paths are validated to be within basePath.
+ * Errors are silently skipped (returns empty array on failure).
+ */
+export const parseManifests = (basePath) => Effect.gen(function* () {
+    const [marketplaceDirs, pluginDirs] = yield* Effect.all([parseMarketplaceJson(basePath), parsePluginJson(basePath)], { concurrency: "unbounded" });
+    return Array.dedupe([...marketplaceDirs, ...pluginDirs]);
+});
+//# sourceMappingURL=parse-manifests.js.map

package/dist/src/unstable/source-resolution/parse-manifests.js.map

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

package/dist/src/unstable/source-resolution/providers/azurerepos/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Azure Repos source parsing.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { checkAzureReposRepoExists } from "./repo-exists.js";
+export { print } from "./print.js";
+export { parseUrl } from "./url.js";
+export { parseScp } from "./scp.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/source-resolution/providers/azurerepos/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/azurerepos/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/unstable/source-resolution/providers/azurerepos/index.js

@@ -0,0 +1,11 @@
+/**
+ * Azure Repos source parsing.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { checkAzureReposRepoExists } from "./repo-exists.js";
+export { print } from "./print.js";
+export { parseUrl } from "./url.js";
+export { parseScp } from "./scp.js";
+//# sourceMappingURL=index.js.map