@agentxm/client-core 0.1.6

package/dist/src/unstable/source-resolution/providers/registry/host-provider.js

@@ -0,0 +1,321 @@
+/**
+ * Registry source host provider implementations.
+ *
+ * Thin adapters between SourceHostProvider contract and RegistryClient.
+ * Type mapping at the boundary keeps registry and source domains separated.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+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 { makeAppError } from "../../../app-error/index.js";
+import { decodeHandleSync } from "../../../extensions/handle.js";
+import { createRegistryClient, extractZip, resolveVersionEntry } from "../../../registry/index.js";
+import { computeIntegrity } from "../../../utils/index.js";
+import { decodeExtensionNameSync, installableExtensionTypes, isInstallableExtensionType, toAuthor, } from "../../../extensions/index.js";
+// -----------------------------------------------------------------------------
+// Type Mapping Helpers
+// -----------------------------------------------------------------------------
+/** Map FindOptions + owner to GetExtensionsByOwnerArgs (no pagination — fetch all). */
+const toSearchOptions = (owner, options) => ({
+    owner,
+    names: options.names,
+    types: options.type === "*" ? [] : [options.type],
+    limit: Option.none(),
+    offset: 0,
+});
+const toRegistrySearchOptions = (owner, options) => ({
+    owner,
+    names: options.names,
+    types: options.type === "*" ? [] : [options.type],
+    limit: Option.none(),
+    offset: 0,
+});
+const authorToMetadata = (author) => ({
+    name: author.name,
+    ...(Option.isSome(author.email) && { email: author.email.value }),
+    ...(Option.isSome(author.url) && { url: author.url.value }),
+});
+const getSupportedExtensionRefs = (entries, source) => Array.getSomes(entries.map((entry) => toExtensionRef(entry, source)));
+const manifestFromIndex = (index, versionConstraint) => {
+    const selectedVersion = resolveVersionEntry(index.versions, versionConstraint);
+    if (Option.isNone(selectedVersion))
+        return Option.none();
+    const version = selectedVersion.value;
+    return Option.some({
+        owner: index.owner,
+        type: index.type,
+        name: index.name,
+        description: Option.fromUndefinedOr(index.description),
+        repository: Option.fromUndefinedOr(index.repository),
+        license: Option.fromUndefinedOr(index.license),
+        authors: Option.match(Option.fromUndefinedOr(index.authors), {
+            onNone: () => [],
+            onSome: (authors) => authors.map((author) => toAuthor(author)),
+        }),
+        dependencies: version.dependencies ?? {},
+        version: version.version,
+        integrity: version.integrity,
+        compatiblePackages: version.compatiblePackages ?? [],
+    });
+};
+const findWithVersionConstraint = (client, source, owners, options) => Effect.forEach(owners, (owner) => Effect.gen(function* () {
+    const requestedTypes = options.type === "*" ? installableExtensionTypes : [options.type];
+    const requestedNames = options.names.length > 0 ? options.names : [];
+    if (requestedNames.length === 0) {
+        const result = yield* client.getExtensionsByScope(toRegistrySearchOptions(owner, options));
+        const resolved = yield* Effect.forEach(result.extensions, (entry) => client
+            .getExtensionIndex({
+            owner: entry.owner,
+            type: entry.type,
+            name: entry.name,
+        })
+            .pipe(Effect.map((indexOption) => Option.match(indexOption, {
+            onNone: () => Option.none(),
+            onSome: (index) => manifestFromIndex(index, options.versionConstraint),
+        }))), { concurrency: "unbounded" });
+        return getSupportedExtensionRefs(Array.getSomes(resolved), source);
+    }
+    const resolved = yield* Effect.forEach(requestedNames, (name) => Effect.forEach(requestedTypes, (type) => Effect.sync(() => {
+        try {
+            return decodeExtensionNameSync(name);
+        }
+        catch {
+            return undefined;
+        }
+    }).pipe(Effect.flatMap((decodedName) => decodedName === undefined
+        ? Effect.succeed(Option.none())
+        : client.getExtensionIndex({ owner, type, name: decodedName }).pipe(Effect.map((indexOption) => Option.match(indexOption, {
+            onNone: () => Option.none(),
+            onSome: (index) => manifestFromIndex(index, options.versionConstraint),
+        }))))), { concurrency: "unbounded" }), { concurrency: "unbounded" });
+    return resolved.flat().flatMap((entry) => Option.match(entry, {
+        onNone: () => [],
+        onSome: (manifest) => getSupportedExtensionRefs([manifest], source),
+    }));
+}), { concurrency: "unbounded" }).pipe(Effect.map((results) => results.flat()));
+/** Map RegistryExtensionManifest to ExtensionRef, stamped with the source. */
+const toExtensionRef = (entry, source) => {
+    if (!isInstallableExtensionType(entry.type)) {
+        return Option.none();
+    }
+    const repository = Option.getOrUndefined(entry.repository);
+    const license = Option.getOrUndefined(entry.license);
+    const authors = entry.authors.map((author) => authorToMetadata(author));
+    const dependencies = entry.dependencies;
+    const skillMetadata = {
+        ...(repository !== undefined && { repository }),
+        ...(license !== undefined && { license }),
+        ...(authors.length > 0 && { authors }),
+        ...(Object.keys(dependencies).length > 0 && { dependencies }),
+    };
+    const details = {
+        owner: entry.owner,
+        name: entry.name,
+        version: entry.version,
+        integrity: Option.fromUndefinedOr(entry.integrity || undefined),
+        compatiblePackages: entry.compatiblePackages,
+    };
+    switch (entry.type) {
+        case "skill":
+            return Option.some({
+                type: "skill",
+                refType: "registry",
+                skill: {
+                    name: entry.name,
+                    description: entry.description,
+                    metadata: Object.keys(skillMetadata).length > 0 ? Option.some(skillMetadata) : Option.none(),
+                },
+                source,
+                ...details,
+            });
+        case "mcp-server":
+            return Option.some({
+                type: "mcp-server",
+                refType: "registry",
+                server: { name: entry.name },
+                source,
+                ...details,
+            });
+        case "command":
+            return Option.some({
+                type: "command",
+                refType: "registry",
+                command: { name: entry.name },
+                source,
+                ...details,
+            });
+        case "subagent":
+            return Option.some({
+                type: "subagent",
+                refType: "registry",
+                subagent: { name: entry.name, description: entry.description },
+                source,
+                ...details,
+            });
+        case "pack": {
+            const skills = {};
+            const commands = {};
+            const mcpServers = {};
+            const subagents = {};
+            for (const [key, version] of Object.entries(dependencies)) {
+                if (key.includes("/skills/"))
+                    skills[key] = version;
+                else if (key.includes("/commands/"))
+                    commands[key] = version;
+                else if (key.includes("/mcp-servers/"))
+                    mcpServers[key] = version;
+                else if (key.includes("/subagents/"))
+                    subagents[key] = version;
+            }
+            return Option.some({
+                type: "pack",
+                refType: "registry",
+                pack: { name: entry.name, skills, commands, mcpServers, subagents },
+                source,
+                ...details,
+            });
+        }
+    }
+};
+/** Extract extension name from an ExtensionRef. */
+const refName = (ref) => {
+    switch (ref.type) {
+        case "skill":
+            return ref.skill.name;
+        case "command":
+            return ref.command.name;
+        case "mcp-server":
+            return ref.server.name;
+        case "pack":
+            return ref.pack.name;
+        case "subagent":
+            return ref.subagent.name;
+    }
+};
+/** Map ExtensionRef type to ExtensionType. */
+const refRegistryType = (ref) => ref.type;
+const fetchRegistryExtension = (client, ref) => Effect.gen(function* () {
+    if (ref.refType !== "registry") {
+        return yield* makeAppError({
+            code: "SOURCE_FETCH_FAILED",
+            what: "Ref missing registry details (owner, version, integrity)",
+        });
+    }
+    const { owner, version, integrity: expectedIntegrity } = ref;
+    const type = refRegistryType(ref);
+    const name = refName(ref);
+    const { archive: archiveBytes } = yield* client.getExtensionPackage({
+        owner,
+        type,
+        name,
+        version: Option.some(version),
+    });
+    if (Option.isSome(expectedIntegrity)) {
+        const actualIntegrity = yield* computeIntegrity(archiveBytes);
+        if (actualIntegrity !== expectedIntegrity.value) {
+            return yield* makeAppError({
+                code: "SOURCE_FETCH_FAILED",
+                what: `Integrity mismatch for ${type}:${name}@${version}`,
+                details: [`Expected ${expectedIntegrity.value}, got ${actualIntegrity}`],
+            });
+        }
+    }
+    const fs = yield* FileSystem.FileSystem;
+    const tmpDir = yield* Effect.acquireRelease(fs.makeTempDirectory().pipe(Effect.mapError((e) => makeAppError({
+        code: "SOURCE_FETCH_FAILED",
+        what: "Failed to create temp directory",
+        cause: e,
+    }))), (dir) => fs.remove(dir, { recursive: true }).pipe(Effect.ignore));
+    yield* extractZip(archiveBytes, tmpDir);
+    return { directory: tmpDir };
+});
+// -----------------------------------------------------------------------------
+// LocalRegistrySourceHostProvider
+// -----------------------------------------------------------------------------
+/**
+ * Creates a local registry source host provider backed by a RegistryClient.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const createLocalRegistrySourceHostProvider = (client) => ({
+    type: "registry",
+    match: (url) => Effect.succeed(url.protocol === "file:"),
+    find: (source, options) => Effect.gen(function* () {
+        const fsService = yield* FileSystem.FileSystem;
+        const pathService = yield* Path.Path;
+        const extensionsDir = pathService.join(source.location.pathname, "extensions");
+        const dirExists = yield* fsService
+            .exists(extensionsDir)
+            .pipe(Effect.orElseSucceed(() => false));
+        if (!dirExists)
+            return [];
+        const entries = yield* fsService
+            .readDirectory(extensionsDir)
+            .pipe(Effect.orElseSucceed(() => []));
+        const namespaces = Option.isSome(options.owner)
+            ? [options.owner.value]
+            : entries.filter((d) => d.startsWith("@")).map((entry) => decodeHandleSync(entry));
+        if (Option.isSome(options.versionConstraint)) {
+            return yield* findWithVersionConstraint(client, source, namespaces, options);
+        }
+        const results = yield* Effect.forEach(namespaces, (owner) => Effect.gen(function* () {
+            const result = yield* client.getExtensionsByScope(toRegistrySearchOptions(owner, options));
+            return getSupportedExtensionRefs(result.extensions, source);
+        }), { concurrency: "unbounded" });
+        return results.flat();
+    }),
+    fetch: (_source, ref) => fetchRegistryExtension(client, ref),
+    publishExtension: (owner, type, name, version, archive, metadata) => client.publishExtension({ owner, type, name, version, archive, metadata }),
+});
+// -----------------------------------------------------------------------------
+// RemoteRegistrySourceHostProvider
+// -----------------------------------------------------------------------------
+/**
+ * Creates a remote registry source host provider backed by a RegistryClient.
+ *
+ * All operations delegate to the underlying RemoteRegistryClient, which
+ * returns errors for all operations (remote not yet supported).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const createRemoteRegistrySourceHostProvider = (client) => ({
+    type: "registry",
+    match: (url) => Effect.succeed(url.protocol === "https:"),
+    find: (source, options) => Effect.gen(function* () {
+        const owner = Option.isSome(options.owner) ? options.owner.value : "*";
+        if (Option.isSome(options.versionConstraint) && owner !== "*") {
+            return yield* findWithVersionConstraint(client, source, [owner], options);
+        }
+        const searchOptions = owner === "*" ? toSearchOptions("*", options) : toRegistrySearchOptions(owner, options);
+        const result = yield* client.getExtensionsByScope(searchOptions);
+        return getSupportedExtensionRefs(result.extensions, source);
+    }),
+    fetch: (_source, ref) => fetchRegistryExtension(client, ref),
+    publishExtension: (owner, type, name, version, archive, metadata) => client.publishExtension({ owner, type, name, version, archive, metadata }),
+});
+// -----------------------------------------------------------------------------
+// Factory
+// -----------------------------------------------------------------------------
+/**
+ * Create a registry source host provider for a given RegistrySourceHost.
+ *
+ * Creates the appropriate RegistryClient internally based on the host's
+ * location protocol, then wraps it in the matching host provider.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const createRegistrySourceHostProviderFromHost = (host) => Effect.gen(function* () {
+    const location = host.location;
+    const locationStr = location.protocol === "file:" ? location.pathname : location.href;
+    const client = yield* createRegistryClient(locationStr);
+    if (location.protocol === "file:" || !location.protocol.startsWith("http")) {
+        return createLocalRegistrySourceHostProvider(client);
+    }
+    return createRemoteRegistrySourceHostProvider(client);
+});
+//# sourceMappingURL=host-provider.js.map

package/dist/src/unstable/source-resolution/providers/registry/host-provider.js.map

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

package/dist/src/unstable/source-resolution/resolve-source-pattern.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Multi-source pattern resolution: handles both single sources and glob patterns.
+ *
+ * Wraps `resolveSource` for single inputs and expands globs against all known
+ * skills (locked, configured, and on-disk) to resolve multiple sources.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import { type AppError } from "../app-error/index.js";
+import { Workspace } from "../workspace/index.js";
+import type { Source } from "../sources/index.js";
+/**
+ * Resolve a source pattern into one or more `Source` values.
+ *
+ * - Single input (name, path, URL, etc.) → delegates to `resolveSource`, returns single-element array
+ * - Glob pattern (e.g. `effect-*`) → expands against locked, configured, and on-disk skills
+ *
+ * For single name inputs, includes fallbacks to configured skills and on-disk discovery
+ * when the skill is not in the lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const resolveSourcePattern: (input: string) => Effect.Effect<ReadonlyArray<Source>, AppError, Workspace | FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=resolve-source-pattern.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-source-pattern.d.ts","sourceRoot":"","sources":["../../../../src/unstable/source-resolution/resolve-source-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAgGlD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAqCxF,CAAC"}

package/dist/src/unstable/source-resolution/resolve-source-pattern.js

@@ -0,0 +1,112 @@
+/**
+ * Multi-source pattern resolution: handles both single sources and glob patterns.
+ *
+ * Wraps `resolveSource` for single inputs and expands globs against all known
+ * skills (locked, configured, and on-disk) to resolve multiple sources.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+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 { getAgentById } from "../agents/index.js";
+import { makeAppError } from "../app-error/index.js";
+import { discoverSkillsInDir } from "./discover-skills.js";
+import { expandGlobs, isGlobPattern } from "../utils/index.js";
+import { Workspace } from "../workspace/index.js";
+import { resolveSource } from "./resolve-source.js";
+import { fileUrlToPath } from "../sources/index.js";
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+const sortNames = (names) => [...names].sort((a, b) => a.localeCompare(b));
+/** Build candidate skill names and on-disk locations from all available sources, excluding ignored. */
+const buildCandidates = Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const path = yield* Path.Path;
+    const base = ws.baseDir;
+    const installedSkills = yield* ws.getInstalledSkills();
+    const unmanagedSkills = yield* ws.getUnmanagedSkills();
+    const configuredSkills = yield* ws.getConfiguredSkills();
+    const configuredAgents = yield* ws.getConfiguredAgents();
+    const agentRoots = sortNames(Array.dedupe(Array.getSomes(Array.map(configuredAgents, (agentId) => Option.map(getAgentById(agentId), (agent) => path.join(base, agent.skills.dir))))));
+    const onDiskRefs = yield* Effect.forEach(agentRoots, (agentRoot) => discoverSkillsInDir(agentRoot, Option.none(), {
+        fullDepth: false,
+        includeInternal: false,
+    }).pipe(Effect.catch(() => Effect.succeed([]))), { concurrency: "unbounded" }).pipe(Effect.map(Array.flatten));
+    const refsSortedByLocation = [...onDiskRefs].sort((a, b) => a.location.localeCompare(b.location));
+    const onDiskByName = new Map();
+    for (const ref of refsSortedByLocation) {
+        if (!onDiskByName.has(ref.skill.name)) {
+            onDiskByName.set(ref.skill.name, fileUrlToPath(ref.location));
+        }
+    }
+    // Candidate set: installed + unmanaged (both exclude ignored names via classifier)
+    const names = sortNames(Array.dedupe([
+        ...Object.keys(installedSkills),
+        ...Object.keys(unmanagedSkills),
+        ...onDiskByName.keys(),
+    ]));
+    // Filter out ignored names from on-disk discoveries
+    const ignoredPatterns = yield* ws.getIgnoredSkillPatterns();
+    const filteredNames = ignoredPatterns.length > 0
+        ? names.filter((name) => !expandGlobs(ignoredPatterns, [name]).length)
+        : names;
+    return { names: filteredNames, configuredSkills, onDiskByName };
+});
+/** Resolve a single skill name with fallbacks: resolveSource → configured source → on-disk path. */
+const resolveNameWithFallback = (name, configuredSkills, onDiskByName) => resolveSource(name).pipe(Effect.catchTag("AppError", (error) => {
+    if (error.code !== "SOURCE_PARSE_FAILED") {
+        return Effect.fail(error);
+    }
+    const configuredEntry = configuredSkills[name];
+    if (configuredEntry !== undefined) {
+        return resolveSource(configuredEntry.source);
+    }
+    const diskPath = onDiskByName.get(name);
+    if (diskPath !== undefined) {
+        return Effect.succeed({ type: "local", path: diskPath });
+    }
+    return Effect.fail(error);
+}));
+// -----------------------------------------------------------------------------
+// Main
+// -----------------------------------------------------------------------------
+/**
+ * Resolve a source pattern into one or more `Source` values.
+ *
+ * - Single input (name, path, URL, etc.) → delegates to `resolveSource`, returns single-element array
+ * - Glob pattern (e.g. `effect-*`) → expands against locked, configured, and on-disk skills
+ *
+ * For single name inputs, includes fallbacks to configured skills and on-disk discovery
+ * when the skill is not in the lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const resolveSourcePattern = (input) => isGlobPattern(input)
+    ? Effect.gen(function* () {
+        const candidates = yield* buildCandidates;
+        const matchedNames = expandGlobs([input], candidates.names);
+        if (matchedNames.length === 0) {
+            return yield* makeAppError({
+                code: "NO_SKILLS_MATCHED",
+                what: "No skills matched the given pattern",
+                details: [`Pattern: ${input}`, `Available: ${candidates.names.join(", ")}`],
+                howToFix: "Check installed skill names with `axm skills list`.",
+            });
+        }
+        return yield* Effect.forEach(sortNames(matchedNames), (name) => resolveNameWithFallback(name, candidates.configuredSkills, candidates.onDiskByName), { concurrency: "unbounded" });
+    })
+    : resolveSource(input).pipe(Effect.catchTag("AppError", (error) => {
+        if (error.code !== "SOURCE_PARSE_FAILED") {
+            return Effect.fail(error);
+        }
+        return Effect.gen(function* () {
+            const candidates = yield* buildCandidates;
+            return yield* resolveNameWithFallback(input, candidates.configuredSkills, candidates.onDiskByName);
+        });
+    }), Effect.map((source) => [source]));
+//# sourceMappingURL=resolve-source-pattern.js.map

package/dist/src/unstable/source-resolution/resolve-source-pattern.js.map

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

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

@@ -0,0 +1,73 @@
+/**
+ * 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 type * as FileSystem from "effect/FileSystem";
+import type * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { type AppError } from "../app-error/index.js";
+import type { InputParseResult, ShorthandInput, Source } from "../sources/index.js";
+import { type Handle } from "../extensions/handle.js";
+import type { ExtensionName, ExtensionTypePlural } from "../extensions/index.js";
+import { Workspace } from "../workspace/index.js";
+/**
+ * Route a URL input by iterating configured sources and matching by
+ * hostname + provider parse. First successful match wins.
+ */
+export declare const routeUrlInput: (url: URL, input: string) => Effect.Effect<Source, AppError, Workspace>;
+/**
+ * Route an SCP address by iterating configured sources and matching by
+ * hostname + provider parse. First successful match wins.
+ */
+export declare const routeScpInput: (scp: {
+    readonly user: string;
+    readonly host: string;
+    readonly path: string;
+}, input: string) => Effect.Effect<Source, AppError, Workspace>;
+/**
+ * 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.
+ */
+export declare const resolveShorthandInputSource: (parseResult: InputParseResult<ShorthandInput>) => Effect.Effect<Source, AppError, Workspace>;
+/** Route NameInput: look up installed skill in lockfile, then configured skills. */
+export declare const routeNameInput: (name: string, input: string) => Effect.Effect<Source, AppError, FileSystem.FileSystem | Path.Path | Workspace>;
+/** Route RegistryPatternInput: find matching registry config and intersect with params. */
+export declare const routeRegistryInput: (pattern: {
+    readonly type: Option.Option<ExtensionTypePlural>;
+    readonly owner: Handle;
+    readonly name: Option.Option<ExtensionName>;
+}, input: string) => Effect.Effect<{
+    type: "registry";
+    location: URL;
+    owner: Option.Option<string & import("effect/Brand").Brand<"Handle">>;
+}, AppError, Workspace>;
+export declare const resolveSlashInputSource: (pattern: {
+    readonly first: string;
+    readonly second: string;
+    readonly third: Option.Option<string>;
+}, input: string) => Effect.Effect<Source, AppError, FileSystem.FileSystem | Path.Path | Workspace>;
+/**
+ * Resolve a source 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 `AppError`
+ */
+export declare const resolveSource: (input: string) => Effect.Effect<Source, AppError, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=resolve-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-source.d.ts","sourceRoot":"","sources":["../../../../src/unstable/source-resolution/resolve-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKpE,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EAEd,MAAM,EAGP,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAiB,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAUhG,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAkHlD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,GAAG,EAAE,OAAO,MAAM,+CA8CjD,CAAC;AA4CL;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,KAAK;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC5E,OAAO,MAAM,+CA6CX,CAAC;AAML;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GAAI,aAAa,gBAAgB,CAAC,cAAc,CAAC,+CAqCrF,CAAC;AAML,oFAAoF;AACpF,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,OAAO,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAuC5E,CAAC;AAEL,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,GAC7B,SAAS;IACP,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;CAC7C,EACD,OAAO,MAAM;;;;uBAqCX,CAAC;AAcL,eAAO,MAAM,uBAAuB,GAClC,SAAS;IACP,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACvC,EACD,OAAO,MAAM,mFAgFX,CAAC;AAML;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CA+C5E,CAAC"}