@axm.sh/cli 0.0.1

package/dist/src/sources/registry-guard.js

@@ -0,0 +1,52 @@
+/**
+ * Registry guard - ensures at least one registry source is configured.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Path from "@effect/platform/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { TextInput } from "../tui/index.js";
+import { Workspace } from "../workspace/index.js";
+import { RegistryNotConfiguredError } from "./provider.js";
+/**
+ * Ensure at least one registry source is configured.
+ *
+ * - If already configured: no-op
+ * - If NOT configured:
+ *   - Interactive mode: prompt for local registry path, persist via addConfiguredSource
+ *   - Non-interactive mode: fail with RegistryNotConfiguredError
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const registryGuard = Effect.gen(function* () {
+    const workspace = yield* Workspace;
+    const registrySources = yield* workspace.getConfiguredRegistrySources(Option.none());
+    // Already configured - no-op
+    if (registrySources.length > 0)
+        return;
+    // Not configured in non-interactive mode - fail
+    if (workspace.nonInteractive) {
+        return yield* new RegistryNotConfiguredError({
+            message: `No registry source configured. Add one to .axm/settings.json:\n\n{\n  "sources": [\n    { "name": "local", "type": "registry", "url": "/path/to/registry" }\n  ]\n}`,
+        });
+    }
+    // Interactive mode - prompt for path
+    const textInput = yield* TextInput;
+    const path = yield* textInput.prompt({
+        message: "No registry configured. Enter a local registry path:",
+    });
+    // Normalize path (expand ~, resolve relative)
+    const pathService = yield* Path.Path;
+    const normalizedPath = path.startsWith("~")
+        ? pathService.resolve(process.env["HOME"] ?? "~", path.slice(2))
+        : pathService.resolve(path);
+    // Persist to settings
+    yield* workspace.addConfiguredSource({
+        name: "local",
+        type: "registry",
+        url: new URL(`file://${normalizedPath}`),
+    });
+});
+//# sourceMappingURL=registry-guard.js.map

package/dist/src/sources/registry-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-guard.js","sourceRoot":"","sources":["../../../src/sources/registry-guard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IACnC,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAErF,6BAA6B;IAC7B,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAEvC,gDAAgD;IAChD,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,CAAC,IAAI,0BAA0B,CAAC;YAC3C,OAAO,EAAE,qKAAqK;SAC/K,CAAC,CAAC;IACL,CAAC;IAED,qCAAqC;IACrC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IACnC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;QACnC,OAAO,EAAE,sDAAsD;KAChE,CAAC,CAAC;IAEH,8CAA8C;IAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACrC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACzC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,sBAAsB;IACtB,KAAK,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC;QACnC,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,IAAI,GAAG,CAAC,UAAU,cAAc,EAAE,CAAC;KACzC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/sources/resolve-source.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Source resolution: classifies input via parseInputPattern, then routes
+ * each pattern type to the appropriate resolution logic.
+ *
+ * For URL and SCP patterns, resolution iterates configured sources and
+ * matches by hostname + provider parse. For other patterns, resolution
+ * handles them directly.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import { ParseError } from "./errors.js";
+import type { Source } from "./types.js";
+import { Workspace } from "../workspace/index.js";
+/**
+ * Resolve a source input string into a fully resolved Source.
+ *
+ * Classifies the input via `parseInputPattern`, then routes each pattern
+ * type to the appropriate resolution logic. For URL and SCP patterns,
+ * resolution iterates configured sources and matches by hostname + provider
+ * parse. For other patterns, resolution handles them directly.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @param input - The source string to resolve
+ * @returns Effect containing a resolved Source or ParseError
+ */
+export declare const resolveSource: (input: string) => Effect.Effect<Source, ParseError, Workspace>;
+//# sourceMappingURL=resolve-source.d.ts.map

package/dist/src/sources/resolve-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-source.d.ts","sourceRoot":"","sources":["../../../src/sources/resolve-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,OAAO,KAAK,EAAE,MAAM,EAA2B,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AA+TlD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CA6BrF,CAAC"}

package/dist/src/sources/resolve-source.js

@@ -0,0 +1,270 @@
+/**
+ * Source resolution: classifies input via parseInputPattern, then routes
+ * each pattern type to the appropriate resolution logic.
+ *
+ * For URL and SCP patterns, resolution iterates configured sources and
+ * matches by hostname + provider parse. For other patterns, resolution
+ * handles them directly.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Match from "effect/Match";
+import * as Option from "effect/Option";
+import * as azurerepos from "./azurerepos/index.js";
+import * as bitbucket from "./bitbucket/index.js";
+import { ParseError } from "./errors.js";
+import * as github from "./github/index.js";
+import * as gitlab from "./gitlab/index.js";
+import { parseLocalPath } from "./local/index.js";
+import { parseInputPattern } from "./parser.js";
+import { Workspace } from "../workspace/index.js";
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+/** Source types that require a matching config from workspace. */
+const GIT_HOSTING_TYPES = new Set(["github", "gitlab", "bitbucket", "azurerepos"]);
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+/** Get configured sources from workspace, mapping errors to ParseError. */
+const getConfiguredSources = (input) => Effect.gen(function* () {
+    const ws = yield* Workspace;
+    return yield* ws
+        .getConfiguredSources()
+        .pipe(Effect.mapError((e) => new ParseError({ message: `Failed to get configured sources: ${e._tag}`, input })));
+});
+/** Get the relative path of an installed skill from its lockfile entry. */
+const getInstalledSkillPath = (name, entry) => {
+    if (entry.type === "registry") {
+        return `.axm/extensions/${entry.scope}/skills/${name}`;
+    }
+    return `.agents/skills/${name}`;
+};
+/** Parse shorthand input using the provider for the given source type. */
+const parseShorthandForSource = (sourceType, input) => {
+    switch (sourceType) {
+        case "github":
+            return github.parseShorthand(input);
+        case "gitlab":
+            return gitlab.parseShorthand(input);
+        case "bitbucket":
+            return bitbucket.parseShorthand(input);
+        default:
+            return Effect.fail(new ParseError({
+                message: `Source type "${sourceType}" does not support shorthand syntax`,
+                input,
+            }));
+    }
+};
+// -----------------------------------------------------------------------------
+// URL routing
+// -----------------------------------------------------------------------------
+/**
+ * Route a URL input by iterating configured sources and matching by
+ * hostname + provider parse. First successful match wins.
+ */
+const routeUrlInput = (url, input) => Effect.gen(function* () {
+    // Opaque URLs (empty hostname, e.g. "ghe:owner/repo") may be config-name shorthands
+    if (!url.hostname) {
+        return yield* routeOpaqueUrl(url, input);
+    }
+    const sources = yield* getConfiguredSources(input);
+    const noMatch = new ParseError({
+        message: `No configured source matches URL "${url.href}"`,
+        input,
+    });
+    const tryParseUrl = (configUrl, config, parse) => configUrl.hostname !== url.hostname
+        ? Effect.fail(noMatch)
+        : Effect.map(parse(url, configUrl.hostname), (si) => ({ ...si, ...config }));
+    const tryMatch = Match.type().pipe(Match.when({ type: "github" }, (c) => tryParseUrl(c.url, c, github.parseUrl)), Match.when({ type: "gitlab" }, (c) => tryParseUrl(c.url, c, gitlab.parseUrl)), Match.when({ type: "bitbucket" }, (c) => tryParseUrl(c.url, c, bitbucket.parseUrl)), Match.when({ type: "azurerepos" }, (c) => tryParseUrl(c.url, c, azurerepos.parseUrl)), Match.when({ type: "registry" }, () => Effect.fail(noMatch)), Match.exhaustive);
+    const attempts = Array.map(sources, tryMatch);
+    if (Array.isEmptyReadonlyArray(attempts)) {
+        return yield* noMatch;
+    }
+    return yield* Effect.firstSuccessOf(attempts).pipe(Effect.mapError(() => new ParseError({
+        message: `No configured source matches URL "${url.href}"`,
+        input,
+    })));
+});
+/**
+ * Handle opaque URLs (no hostname, e.g. "ghe:owner/repo") by checking if
+ * the scheme matches a config name for a git hosting source type.
+ */
+const routeOpaqueUrl = (url, input) => Effect.gen(function* () {
+    const colonIndex = input.indexOf(":");
+    if (colonIndex <= 0) {
+        return yield* new ParseError({ message: "Unable to parse source", input });
+    }
+    const prefix = input.slice(0, colonIndex);
+    const sources = yield* getConfiguredSources(input);
+    // Check if the scheme matches a config name
+    const matchedConfig = sources.find((s) => s.name === prefix);
+    if (matchedConfig && GIT_HOSTING_TYPES.has(matchedConfig.type)) {
+        const remainder = input.slice(colonIndex + 1);
+        const reparsed = `${matchedConfig.type}:${remainder}`;
+        const parsedInput = yield* parseShorthandForSource(matchedConfig.type, reparsed);
+        return { ...parsedInput, ...matchedConfig };
+    }
+    // Not a config name — fail
+    return yield* new ParseError({
+        message: `No configured source matches URL "${url.href}"`,
+        input,
+    });
+});
+// -----------------------------------------------------------------------------
+// SCP routing
+// -----------------------------------------------------------------------------
+/**
+ * Route an SCP address by iterating configured sources and matching by
+ * hostname + provider parse. First successful match wins.
+ */
+const routeScpInput = (scp, input) => Effect.gen(function* () {
+    const sources = yield* getConfiguredSources(input);
+    const scpInput = `${scp.user}@${scp.host}:${scp.path}`;
+    const noMatch = new ParseError({
+        message: `No configured source matches SCP address "${scpInput}"`,
+        input,
+    });
+    const tryParseScp = (scpHostname, config, parse) => scp.host !== scpHostname
+        ? Effect.fail(noMatch)
+        : Effect.map(parse(scpInput, scp.host), (si) => ({ ...si, ...config }));
+    const tryMatch = Match.type().pipe(Match.when({ type: "github" }, (c) => tryParseScp(c.url.hostname, c, github.parseScp)), Match.when({ type: "gitlab" }, (c) => tryParseScp(c.url.hostname, c, gitlab.parseScp)), Match.when({ type: "bitbucket" }, (c) => tryParseScp(c.url.hostname, c, bitbucket.parseScp)), Match.when({ type: "azurerepos" }, (c) => tryParseScp(`ssh.${c.url.hostname}`, c, azurerepos.parseScp)), Match.when({ type: "registry" }, () => Effect.fail(noMatch)), Match.exhaustive);
+    const attempts = Array.map(sources, tryMatch);
+    if (Array.isEmptyReadonlyArray(attempts)) {
+        return yield* noMatch;
+    }
+    return yield* Effect.firstSuccessOf(attempts).pipe(Effect.mapError(() => new ParseError({
+        message: `No configured source matches SCP address "${scpInput}"`,
+        input,
+    })));
+});
+// -----------------------------------------------------------------------------
+// Shorthand routing
+// -----------------------------------------------------------------------------
+/**
+ * Route shorthand input (github:owner/repo, ghe:owner/repo, etc.).
+ *
+ * Known source-type prefixes dispatch directly to the provider's shorthand
+ * parser. Config-name prefixes look up the config and parse using its source
+ * type's shorthand parser.
+ */
+const routeShorthandInput = (prefix, shorthandInput, input) => Effect.gen(function* () {
+    const sources = yield* getConfiguredSources(input);
+    // Known source-type prefix → dispatch directly, select first config of that type
+    const isKnownType = prefix === "github" || prefix === "gitlab" || prefix === "bitbucket";
+    if (isKnownType) {
+        const parsedInput = yield* parseShorthandForSource(prefix, shorthandInput);
+        const config = sources.find((s) => s.type === prefix);
+        if (!config) {
+            return yield* new ParseError({
+                message: `No source config found for source type "${prefix}". Add a source config via settings.`,
+                input,
+            });
+        }
+        return { ...parsedInput, ...config };
+    }
+    // Config-name prefix → find config, parse with its source type parser
+    const matchedConfig = sources.find((s) => s.name === prefix);
+    if (!matchedConfig || !GIT_HOSTING_TYPES.has(matchedConfig.type)) {
+        return yield* new ParseError({
+            message: `Unknown shorthand prefix: "${prefix}"`,
+            input,
+        });
+    }
+    const remainder = shorthandInput.slice(prefix.length + 1);
+    const reparsed = `${matchedConfig.type}:${remainder}`;
+    const parsedInput = yield* parseShorthandForSource(matchedConfig.type, reparsed);
+    return { ...parsedInput, ...matchedConfig };
+});
+// -----------------------------------------------------------------------------
+// Simple pattern routing
+// -----------------------------------------------------------------------------
+/** Route NameInput: look up installed skill in lockfile and resolve to local path. */
+const routeNameInput = (name, input) => Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const skills = yield* ws
+        .getLockedSkills()
+        .pipe(Effect.mapError((e) => new ParseError({ message: `Failed to read lockfile: ${e._tag}`, input })));
+    if (!(name in skills)) {
+        return yield* new ParseError({
+            message: `Unknown skill "${name}". Check installed skills with \`axm skills list\`.`,
+            input,
+        });
+    }
+    return (yield* parseLocalPath(getInstalledSkillPath(name, skills[name])));
+});
+/** Route FilePathPattern: parse as local source. */
+const routeFilePathInput = (path) => Effect.map(parseLocalPath(path), (source) => source);
+/** Route RegistryPatternInput: construct registry source from parsed scope and name. */
+const routeRegistryInput = (pattern) => Effect.succeed({ type: "registry", scope: pattern.scope, name: pattern.name });
+/**
+ * Route SlashPattern (owner/repo): iterate git-hosting configs that support
+ * shorthand, try each provider in config order. First success wins.
+ */
+const routeSlashInput = (pattern, input) => Effect.gen(function* () {
+    const sources = yield* getConfiguredSources(input);
+    const shorthandTypes = ["github", "gitlab", "bitbucket"];
+    const shorthandBody = `${pattern.owner}/${pattern.repo}`;
+    const attempts = Array.filterMap(sources, (config) => {
+        const sourceType = shorthandTypes.find((t) => t === config.type);
+        if (!sourceType)
+            return Option.none();
+        return Option.some(Effect.map(parseShorthandForSource(sourceType, `${sourceType}:${shorthandBody}`), (si) => ({ ...si, ...config })));
+    });
+    if (Array.isEmptyReadonlyArray(attempts)) {
+        return yield* new ParseError({
+            message: `Ambiguous pattern '${pattern.owner}/${pattern.repo}' — no git hosting sources configured`,
+            input,
+        });
+    }
+    return yield* Effect.firstSuccessOf(attempts).pipe(Effect.mapError(() => new ParseError({
+        message: `Ambiguous pattern '${pattern.owner}/${pattern.repo}' — use github:${pattern.owner}/${pattern.repo}, gitlab:${pattern.owner}/${pattern.repo}, or bitbucket:${pattern.owner}/${pattern.repo}`,
+        input,
+    })));
+});
+// -----------------------------------------------------------------------------
+// Main resolver
+// -----------------------------------------------------------------------------
+/**
+ * Resolve a source input string into a fully resolved Source.
+ *
+ * Classifies the input via `parseInputPattern`, then routes each pattern
+ * type to the appropriate resolution logic. For URL and SCP patterns,
+ * resolution iterates configured sources and matches by hostname + provider
+ * parse. For other patterns, resolution handles them directly.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @param input - The source string to resolve
+ * @returns Effect containing a resolved Source or ParseError
+ */
+export const resolveSource = (input) => Effect.gen(function* () {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        return yield* new ParseError({ message: "Source string cannot be empty", input });
+    }
+    const patternOpt = parseInputPattern(trimmed);
+    if (Option.isNone(patternOpt)) {
+        return yield* new ParseError({ message: "Unable to parse source", input });
+    }
+    const pattern = patternOpt.value;
+    switch (pattern._tag) {
+        case "UrlInput":
+            return yield* routeUrlInput(pattern.url, trimmed);
+        case "GitScpAddress":
+            return yield* routeScpInput(pattern, trimmed);
+        case "ShorthandInput":
+            return yield* routeShorthandInput(pattern.prefix, pattern.input, trimmed);
+        case "NameInput":
+            return yield* routeNameInput(pattern.name, trimmed);
+        case "FilePathPattern":
+            return yield* routeFilePathInput(pattern.path);
+        case "RegistryPatternInput":
+            return yield* routeRegistryInput(pattern);
+        case "SlashPattern":
+            return yield* routeSlashInput(pattern, trimmed);
+    }
+});
+//# sourceMappingURL=resolve-source.js.map

package/dist/src/sources/resolve-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-source.js","sourceRoot":"","sources":["../../../src/sources/resolve-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,kEAAkE;AAClE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;AAE/F,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,2EAA2E;AAC3E,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAE,EAAE,CAC7C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC5B,OAAO,KAAK,CAAC,CAAC,EAAE;SACb,oBAAoB,EAAE;SACtB,IAAI,CACH,MAAM,CAAC,QAAQ,CACb,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,EAAE,OAAO,EAAE,qCAAqC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CACzF,CACF,CAAC;AACN,CAAC,CAAC,CAAC;AAEL,2EAA2E;AAC3E,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAAE,KAAqB,EAAU,EAAE;IAC5E,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,mBAAmB,KAAK,CAAC,KAAK,WAAW,IAAI,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,kBAAkB,IAAI,EAAE,CAAC;AAClC,CAAC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,uBAAuB,GAAG,CAC9B,UAAkB,EAClB,KAAa,EAC2B,EAAE;IAC1C,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC;YACE,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,UAAU,CAAC;gBACb,OAAO,EAAE,gBAAgB,UAAU,qCAAqC;gBACxE,KAAK;aACN,CAAC,CACH,CAAC;IACN,CAAC;AACH,CAAC,CAAC;AAEF,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAC,GAAQ,EAAE,KAAa,EAAE,EAAE,CAChD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,oFAAoF;IACpF,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;QAC7B,OAAO,EAAE,qCAAqC,GAAG,CAAC,IAAI,GAAG;QACzD,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,CAClB,SAAc,EACd,MAAoB,EACpB,KAA6E,EAC7E,EAAE,CACF,SAAS,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ;QACjC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,CAAW,CAAC,CAAC;IAE3F,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAgB,CAAC,IAAI,CAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAC7E,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAC7E,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,EACnF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,EACrF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAC5D,KAAK,CAAC,UAAU,CACjB,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAChD,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,CACH,IAAI,UAAU,CAAC;QACb,OAAO,EAAE,qCAAqC,GAAG,CAAC,IAAI,GAAG;QACzD,KAAK;KACN,CAAC,CACL,CACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,cAAc,GAAG,CAAC,GAAQ,EAAE,KAAa,EAAE,EAAE,CACjD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAEnD,4CAA4C;IAC5C,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAC7D,IAAI,aAAa,IAAI,iBAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,IAAkB,CAAC,EAAE,CAAC;QAC7E,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,GAAG,aAAa,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;QACtD,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,uBAAuB,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACjF,OAAO,EAAE,GAAG,WAAW,EAAE,GAAG,aAAa,EAAY,CAAC;IACxD,CAAC;IAED,2BAA2B;IAC3B,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC;QAC3B,OAAO,EAAE,qCAAqC,GAAG,CAAC,IAAI,GAAG;QACzD,KAAK;KACN,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,aAAa,GAAG,CACpB,GAA4E,EAC5E,KAAa,EACb,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;QAC7B,OAAO,EAAE,6CAA6C,QAAQ,GAAG;QACjE,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,CAClB,WAAmB,EACnB,MAAoB,EACpB,KAAkF,EAClF,EAAE,CACF,GAAG,CAAC,IAAI,KAAK,WAAW;QACtB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,CAAW,CAAC,CAAC;IAEtF,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAgB,CAAC,IAAI,CAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EACtF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EACtF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,EAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CACvC,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAC7D,EACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAC5D,KAAK,CAAC,UAAU,CACjB,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAChD,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,CACH,IAAI,UAAU,CAAC;QACb,OAAO,EAAE,6CAA6C,QAAQ,GAAG;QACjE,KAAK;KACN,CAAC,CACL,CACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAE,cAAsB,EAAE,KAAa,EAAE,EAAE,CACpF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAEnD,iFAAiF;IACjF,MAAM,WAAW,GAAG,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,CAAC;IACzF,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,uBAAuB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC;gBAC3B,OAAO,EAAE,2CAA2C,MAAM,sCAAsC;gBAChG,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,EAAY,CAAC;IACjD,CAAC;IAED,sEAAsE;IACtE,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAC7D,IAAI,CAAC,aAAa,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,IAAkB,CAAC,EAAE,CAAC;QAC/E,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC;YAC3B,OAAO,EAAE,8BAA8B,MAAM,GAAG;YAChD,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,GAAG,aAAa,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;IACtD,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,uBAAuB,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjF,OAAO,EAAE,GAAG,WAAW,EAAE,GAAG,aAAa,EAAY,CAAC;AACxD,CAAC,CAAC,CAAC;AAEL,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,sFAAsF;AACtF,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE,CACrD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE;SACrB,eAAe,EAAE;SACjB,IAAI,CACH,MAAM,CAAC,QAAQ,CACb,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,EAAE,OAAO,EAAE,4BAA4B,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAChF,CACF,CAAC;IACJ,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC;YAC3B,OAAO,EAAE,kBAAkB,IAAI,qDAAqD;YACpF,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAE,CAAC,CAAC,CAAW,CAAC;AACvF,CAAC,CAAC,CAAC;AAEL,oDAAoD;AACpD,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,EAAE,CAC1C,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAgB,CAAC,CAAC;AAEjE,wFAAwF;AACxF,MAAM,kBAAkB,GAAG,CAAC,OAA0D,EAAE,EAAE,CACxF,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAmB,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAE1F;;;GAGG;AACH,MAAM,eAAe,GAAG,CACtB,OAA0D,EAC1D,KAAa,EACb,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;IAClE,MAAM,aAAa,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAEzD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;QACnD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,IAAI,CAChB,MAAM,CAAC,GAAG,CACR,uBAAuB,CAAC,UAAU,EAAE,GAAG,UAAU,IAAI,aAAa,EAAE,CAAC,EACrE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,CAAW,CACzC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC;YAC3B,OAAO,EAAE,sBAAsB,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,uCAAuC;YACnG,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAChD,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,CACH,IAAI,UAAU,CAAC;QACb,OAAO,EAAE,sBAAsB,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,kBAAkB,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,YAAY,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,kBAAkB,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE;QACrM,KAAK;KACN,CAAC,CACL,CACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAgD,EAAE,CAC3F,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,EAAE,OAAO,EAAE,+BAA+B,EAAE,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC;IACjC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpD,KAAK,eAAe;YAClB,OAAO,KAAK,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,KAAK,gBAAgB;YACnB,OAAO,KAAK,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5E,KAAK,WAAW;YACd,OAAO,KAAK,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtD,KAAK,iBAAiB;YACpB,OAAO,KAAK,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,KAAK,sBAAsB;YACzB,OAAO,KAAK,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5C,KAAK,cAAc;YACjB,OAAO,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/src/sources/service.d.ts

@@ -0,0 +1,70 @@
+/**
+ * SourceProviders Effect service.
+ *
+ * Provides a unified interface for discovering and fetching extensions
+ * across all source types. Handlers consume this via `yield* SourceProviders`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type * as Scope from "effect/Scope";
+import type { SettingsError } from "../settings/index.js";
+import { Workspace } from "../workspace/service.js";
+import type { ExtensionFiles, ExtensionRef, FindOptions, SourceProvider } from "./provider.js";
+import { SourceError } from "./provider.js";
+import type { RegistrySourceInput, Source } from "./types.js";
+/**
+ * Service interface for source providers.
+ *
+ * Dependencies (FileSystem, Path, Workspace) are resolved at layer creation —
+ * callers only see the service, not its implementation details.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SourceProvidersService {
+    /** Discover extensions matching the given source and search criteria. */
+    readonly resolveExtension: (source: Source, options: FindOptions) => Effect.Effect<ReadonlyArray<ExtensionRef>, SourceError | SettingsError, Scope.Scope>;
+    /** Fetch and materialize extension files for a discovered ref. */
+    readonly fetch: (ref: ExtensionRef) => Effect.Effect<ExtensionFiles, SourceError, Scope.Scope>;
+}
+declare const SourceProviders_base: Context.TagClass<SourceProviders, "@axm.sh/cli/SourceProviders", SourceProvidersService>;
+/**
+ * Effect service tag for source providers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class SourceProviders extends SourceProviders_base {
+}
+/**
+ * Creates a registry meta-provider that wraps N configured registries
+ * into a single `SourceProvider<RegistrySourceInput>`.
+ *
+ * Reads `workspace.getConfiguredRegistrySources()` lazily on each call — always
+ * reflects the current config (including sources added by the registry guard).
+ *
+ * Applies scope routing:
+ * 1. Collect registry sources whose `scopes` includes the target scope
+ * 2. If no scope-matched sources, collect catch-all sources (no `scopes` field)
+ * 3. Scope-matched and catch-all are mutually exclusive
+ * 4. 404 → fallthrough within the set; other errors → hard fail
+ *
+ * @internal
+ */
+export declare const createRegistryMetaProvider: () => SourceProvider<RegistrySourceInput, FileSystem.FileSystem | Path.Path | Workspace>;
+/**
+ * Live layer for SourceProviders.
+ *
+ * Constructs the provider registry with all source type providers.
+ * Captures FileSystem, Path, and Workspace at creation time so the
+ * service interface doesn't leak these dependencies.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SourceProvidersLive: Layer.Layer<SourceProviders, never, FileSystem.FileSystem | Path.Path | Workspace>;
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/src/sources/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/sources/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAU5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAM9D;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,EAAE,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,KACjB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,WAAW,GAAG,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1F,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CAChG;;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,oBAGlC;CAAG;AAMN;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B,QAAO,cAAc,CAC1D,mBAAmB,EACnB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CA6D7C,CAAC;AAMH;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,KAAK,CAC3C,eAAe,EACf,KAAK,EACL,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAqD9C,CAAC"}

package/dist/src/sources/service.js

@@ -0,0 +1,130 @@
+/**
+ * SourceProviders Effect service.
+ *
+ * Provides a unified interface for discovering and fetching extensions
+ * across all source types. Handlers consume this via `yield* SourceProviders`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import { Workspace } from "../workspace/service.js";
+import { SourceError } from "./provider.js";
+import { createAzureReposProvider, createBitbucketProvider, createGitHubProvider, createGitLabProvider, createGitProvider, createLocalProvider, createRegistryProvider, } from "./providers/index.js";
+/**
+ * Effect service tag for source providers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class SourceProviders extends Context.Tag("@axm.sh/cli/SourceProviders")() {
+}
+// -----------------------------------------------------------------------------
+// Registry Meta-Provider
+// -----------------------------------------------------------------------------
+/**
+ * Creates a registry meta-provider that wraps N configured registries
+ * into a single `SourceProvider<RegistrySourceInput>`.
+ *
+ * Reads `workspace.getConfiguredRegistrySources()` lazily on each call — always
+ * reflects the current config (including sources added by the registry guard).
+ *
+ * Applies scope routing:
+ * 1. Collect registry sources whose `scopes` includes the target scope
+ * 2. If no scope-matched sources, collect catch-all sources (no `scopes` field)
+ * 3. Scope-matched and catch-all are mutually exclusive
+ * 4. 404 → fallthrough within the set; other errors → hard fail
+ *
+ * @internal
+ */
+export const createRegistryMetaProvider = () => ({
+    type: "registry",
+    find: (_source, options) => Effect.gen(function* () {
+        const ws = yield* Workspace;
+        // Determine scope from source (e.g. @scope/name install) or from options names
+        const sourceScope = _source.scope
+            ? Option.some(_source.scope.startsWith("@") ? _source.scope : `@${_source.scope}`)
+            : Option.none();
+        const scope = Option.isSome(sourceScope)
+            ? sourceScope
+            : options.names.length > 0
+                ? Option.fromNullable(options.names.find((n) => n.startsWith("@"))?.split("/")[0] ?? null)
+                : Option.none();
+        const registrySources = yield* ws
+            .getConfiguredRegistrySources(scope)
+            .pipe(Effect.mapError((e) => new SourceError({ message: `Failed to get registry sources: ${e._tag}`, cause: e })));
+        if (registrySources.length === 0) {
+            return [];
+        }
+        // Try each registry source in order. 404 (empty results) → fallthrough.
+        // Sequential: early-exits on first non-404 error (can't use Effect.forEach)
+        const allRefs = [];
+        for (const regSource of registrySources) {
+            const provider = createRegistryProvider(regSource.url.href);
+            const result = yield* provider.find(_source, options).pipe(Effect.either);
+            if (result._tag === "Left") {
+                // Non-404 errors → hard fail
+                return yield* Effect.fail(result.left);
+            }
+            if (result.right.length > 0) {
+                allRefs.push(...result.right);
+            }
+        }
+        return allRefs;
+    }),
+    fetch: (_source, extension) => Effect.gen(function* () {
+        // The extension ref carries its location — determine the provider from that
+        const location = extension.location.replace("file://", "");
+        const provider = createRegistryProvider(location.startsWith("http") ? extension.location : location);
+        return yield* provider.fetch(_source, extension);
+    }),
+});
+// -----------------------------------------------------------------------------
+// Layer
+// -----------------------------------------------------------------------------
+/**
+ * Live layer for SourceProviders.
+ *
+ * Constructs the provider registry with all source type providers.
+ * Captures FileSystem, Path, and Workspace at creation time so the
+ * service interface doesn't leak these dependencies.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SourceProvidersLive = Layer.effect(SourceProviders, Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const githubProvider = createGitHubProvider();
+    const gitlabProvider = createGitLabProvider();
+    const bitbucketProvider = createBitbucketProvider();
+    const azurereposProvider = createAzureReposProvider();
+    const gitProvider = createGitProvider();
+    const localProvider = createLocalProvider();
+    const registryMetaProvider = createRegistryMetaProvider();
+    // Captured layer for providing to provider operations
+    const depLayer = Layer.mergeAll(Layer.succeed(FileSystem.FileSystem, fs), Layer.succeed(Path.Path, path), Layer.succeed(Workspace, ws));
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- dispatch table: each key maps to correct provider
+    const providers = {
+        github: githubProvider,
+        gitlab: gitlabProvider,
+        bitbucket: bitbucketProvider,
+        azurerepos: azurereposProvider,
+        git: gitProvider,
+        local: localProvider,
+        registry: registryMetaProvider,
+    };
+    return {
+        resolveExtension: (source, options) => providers[source.type]
+            .find(source, options)
+            .pipe(Effect.provide(depLayer)),
+        fetch: (ref) => providers[ref.source.type]
+            .fetch(ref.source, ref)
+            .pipe(Effect.provide(depLayer)),
+    };
+}));
+//# sourceMappingURL=service.js.map

package/dist/src/sources/service.js.map

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