@agentxm/client-core 0.1.6

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

@@ -0,0 +1,179 @@
+/**
+ * SourceHostProviders Effect service.
+ *
+ * Provides a unified interface for discovering and fetching extensions
+ * across all source types, plus clone URL and source display building.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import * as Path from "effect/Path";
+import * as ServiceMap from "effect/ServiceMap";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import { parseRegistrySourcePatternParts } from "../extensions/index.js";
+import { Workspace } from "../workspace/index.js";
+import { createGitSourceHostProvider } from "./providers/git.js";
+import { createGitHostingSourceHostProvider } from "./providers/git-hosting.js";
+import { createLocalSourceHostProvider } from "./providers/local.js";
+import { createRegistrySourceHostProviderFromHost } from "./providers/registry/host-provider.js";
+import { buildCloneUrlForSource } from "./providers/git-hosting.js";
+/**
+ * Effect service tag for source host providers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class SourceHostProviders extends ServiceMap.Service()("axm.sh/SourceHostProviders") {
+}
+// -----------------------------------------------------------------------------
+// Clone URL Building
+// -----------------------------------------------------------------------------
+/**
+ * Build a git clone URL from a source.
+ * Returns Some for git-based hosting sources, None for others.
+ */
+const buildCloneUrlFromSource = (source) => {
+    switch (source.type) {
+        case "github":
+        case "gitlab":
+        case "bitbucket":
+        case "azurerepos":
+            return Option.some(buildCloneUrlForSource(source));
+        case "git":
+        case "registry":
+        case "local":
+            return Option.none();
+    }
+};
+// -----------------------------------------------------------------------------
+// Origin Building
+// -----------------------------------------------------------------------------
+/**
+ * Get the canonical source string for display/comparison.
+ */
+const getOriginFromSource = (source) => {
+    switch (source.type) {
+        case "github":
+        case "gitlab":
+        case "bitbucket":
+            return `${source.url.origin}/${source.owner}/${source.repo}`;
+        case "azurerepos":
+            return `${source.url.origin}/${source.organization}/${source.project}/_git/${source.repo}`;
+        case "local":
+            return source.path;
+        case "git":
+            return source.url.href;
+        case "registry":
+            return source.location.href;
+    }
+};
+// -----------------------------------------------------------------------------
+// Registry Meta-Provider
+// -----------------------------------------------------------------------------
+/**
+ * Creates a registry meta-provider that delegates find/fetch to the
+ * resolved registry host encoded in the provided `RegistrySource`.
+ *
+ * @internal
+ */
+export const createRegistryMetaProvider = () => ({
+    type: "registry",
+    find: (source, options) => Effect.gen(function* () {
+        // Determine owner from explicit option, or infer from @owner/name.
+        const owner = Option.isSome(options.owner)
+            ? options.owner
+            : Option.isSome(source.owner)
+                ? source.owner
+                : options.names.length > 0
+                    ? Option.fromUndefinedOr((() => {
+                        const requestedName = options.names.find((name) => name.startsWith("@"));
+                        return requestedName === undefined
+                            ? undefined
+                            : parseRegistrySourcePatternParts(requestedName)?.owner;
+                    })())
+                    : Option.none();
+        const provider = yield* createRegistrySourceHostProviderFromHost(source);
+        const registrySource = { ...source, owner };
+        return yield* provider.find(registrySource, options);
+    }),
+    fetch: (source, ref) => Effect.flatMap(createRegistrySourceHostProviderFromHost(source), (provider) => provider.fetch(source, ref)),
+});
+// -----------------------------------------------------------------------------
+// Layer
+// -----------------------------------------------------------------------------
+/**
+ * Live layer for SourceHostProviders.
+ *
+ * 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 SourceHostProvidersLive = Layer.effect(SourceHostProviders, Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const ambientHttpClient = yield* Effect.serviceOption(HttpClient.HttpClient);
+    const localProvider = createLocalSourceHostProvider();
+    const gitProvider = createGitSourceHostProvider();
+    const registryMetaProvider = createRegistryMetaProvider();
+    // Captured layer for providing to provider operations
+    const baseDepLayer = Layer.mergeAll(Layer.succeed(FileSystem.FileSystem, fs), Layer.succeed(Path.Path, path), Layer.succeed(Workspace, ws));
+    const depLayer = Option.match(ambientHttpClient, {
+        onNone: () => baseDepLayer,
+        onSome: (client) => Layer.merge(baseDepLayer, Layer.succeed(HttpClient.HttpClient, client)),
+    });
+    const findGitHosting = (source, options) => {
+        const provider = createGitHostingSourceHostProvider(source);
+        return provider.find(source, options).pipe(Effect.provide(depLayer));
+    };
+    const fetchGitHosting = (source, ref) => {
+        const provider = createGitHostingSourceHostProvider(source);
+        return provider.fetch(source, ref).pipe(Effect.provide(depLayer));
+    };
+    const findImpl = (source, options) => {
+        switch (source.type) {
+            case "github":
+            case "gitlab":
+            case "bitbucket":
+            case "azurerepos":
+                return findGitHosting(source, options);
+            case "local":
+                return localProvider.find(source, options).pipe(Effect.provide(depLayer));
+            case "git":
+                return gitProvider.find(source, options).pipe(Effect.provide(depLayer));
+            case "registry":
+                return registryMetaProvider.find(source, options).pipe(Effect.provide(depLayer));
+        }
+    };
+    const fetchImpl = (source, ref) => {
+        switch (source.type) {
+            case "github":
+            case "gitlab":
+            case "bitbucket":
+            case "azurerepos":
+                return fetchGitHosting(source, ref);
+            case "local":
+                return localProvider.fetch(source, ref).pipe(Effect.provide(depLayer));
+            case "git":
+                return gitProvider.fetch(source, ref).pipe(Effect.provide(depLayer));
+            case "registry":
+                return registryMetaProvider.fetch(source, ref).pipe(Effect.provide(depLayer));
+        }
+    };
+    const service = {
+        find: (source, options) => findImpl(source, options).pipe(Effect.withSpan("SourceHostProviders.find")),
+        fetch: (ref) => {
+            const source = ref.source;
+            return fetchImpl(source, ref).pipe(Effect.withSpan("SourceHostProviders.fetch"));
+        },
+        cloneUrl: buildCloneUrlFromSource,
+        origin: getOriginFromSource,
+    };
+    return service;
+}));
+//# sourceMappingURL=service.js.map

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

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

package/dist/src/unstable/sources/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Source parsing and identification module for @agentxm/client-core.
+ *
+ * Source providers and parsing utilities. Extension ref types live in
+ * the extensions module (`extensions/refs.ts`, `extensions/ref-base.ts`)
+ * — import them from `@agentxm/client-core/unstable/extensions`.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+export type { RefType, SourceType } from "./types.js";
+export { RefTypeSchema, SourceTypeSchema, SourceSegmentSchema, SourceRefSchema, SourceSubPathSchema, GitHostedSourceParamPartsSchema, AzureReposSourceParamPartsSchema, GitHubSourceParamsSchema, GitLabSourceParamsSchema, BitbucketSourceParamsSchema, AzureReposSourceParamsSchema, } from "./types.js";
+export type { GitHostedSourceParamParts, AzureReposSourceParamParts } from "./types.js";
+export type { AzureReposSourceHost, BitbucketSourceHost, ConfiguredSourceHost, GitHostingSourceHost, GitHubSourceHost, GitLabSourceHost, GitSourceHost, LocalSourceHost, RegistrySourceHost, SelfDescribingSourceHost, SourceHost, AzureReposSourceParams, BitbucketSourceParams, GitHubSourceParams, GitHostingSourceParams, GitLabSourceParams, GitSourceParams, LocalSourceParams, RegistrySourceParams, SourceParams, GitBasedSource, GitHostingSource, AzureReposSource, BitbucketSource, GitHubSource, GitLabSource, GitSource, LocalSource, RegistrySource, Source, } from "./types.js";
+export { fileUrlToPath } from "./utils.js";
+export type { ExtensionFiles, FindOptions, SourceHostProvider } from "./provider.js";
+export { parseInputPattern } from "./parser.js";
+export type { InputPattern, InputParseResult, ShorthandInput } from "./parser.js";
+export { lockEntryToSourceParams, printSourceParams } from "./printer.js";
+export { sourceToLockEntry, type SourceToLockEntryInput } from "./source-to-lock-entry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/sources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/sources/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,+BAA+B,EAC/B,gCAAgC,EAChC,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAGxF,YAAY,EAEV,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,UAAU,EAEV,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EAEZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,cAAc,EACd,MAAM,GACP,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlF,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG1E,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/unstable/sources/index.js

@@ -0,0 +1,20 @@
+/**
+ * Source parsing and identification module for @agentxm/client-core.
+ *
+ * Source providers and parsing utilities. Extension ref types live in
+ * the extensions module (`extensions/refs.ts`, `extensions/ref-base.ts`)
+ * — import them from `@agentxm/client-core/unstable/extensions`.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { RefTypeSchema, SourceTypeSchema, SourceSegmentSchema, SourceRefSchema, SourceSubPathSchema, GitHostedSourceParamPartsSchema, AzureReposSourceParamPartsSchema, GitHubSourceParamsSchema, GitLabSourceParamsSchema, BitbucketSourceParamsSchema, AzureReposSourceParamsSchema, } from "./types.js";
+// Type guards and utilities
+export { fileUrlToPath } from "./utils.js";
+// Input pattern classifier
+export { parseInputPattern } from "./parser.js";
+// Printer
+export { lockEntryToSourceParams, printSourceParams } from "./printer.js";
+// Source-to-lock-entry mapping
+export { sourceToLockEntry } from "./source-to-lock-entry.js";
+//# sourceMappingURL=index.js.map

package/dist/src/unstable/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/sources/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,+BAA+B,EAC/B,gCAAgC,EAChC,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAwCpB,4BAA4B;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3C,2BAA2B;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,UAAU;AACV,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE1E,+BAA+B;AAC/B,OAAO,EAAE,iBAAiB,EAA+B,MAAM,2BAA2B,CAAC"}

package/dist/src/unstable/sources/parser.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Input pattern classification for source strings.
+ *
+ * Classifies raw input strings into typed `InputPattern` variants
+ * (URL, SCP, shorthand, file path, etc.) for downstream routing
+ * by `resolveSource`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import type { VersionConstraint } from "../version-constraints/version-constraints.js";
+import type { ExtensionName, ExtensionTypePlural, Handle } from "../extensions/index.js";
+/** A simple name with no `/`, `@`, or URL scheme. */
+type NameInput = {
+    readonly pattern: "name-input";
+    readonly name: string;
+};
+/** A namespaced registry source: `@owner/(skills|commands|mcp-servers|packs)/name`. */
+type RegistryPatternInput = {
+    readonly pattern: "registry-pattern-input";
+    readonly type: Option.Option<ExtensionTypePlural>;
+    readonly owner: Handle;
+    readonly name: Option.Option<ExtensionName>;
+    readonly versionConstraint: Option.Option<VersionConstraint>;
+};
+/** A valid URL (validated via `Schema.URL`). */
+type UrlInput = {
+    readonly pattern: "url-input";
+    readonly url: URL;
+};
+/** An SCP-style git address: `user@host:path` (e.g. `git@github.com:owner/repo.git`). */
+type GitScpAddress = {
+    readonly pattern: "git-scp-address";
+    readonly user: string;
+    readonly host: string;
+    readonly path: string;
+};
+/** An `owner/repo` style pattern containing `/` (not a URL or file path). */
+type SlashPattern = {
+    readonly pattern: "slash-pattern";
+    readonly first: string;
+    readonly second: string;
+    readonly third: Option.Option<string>;
+};
+/** A local filesystem path matching `LOCAL_PATH_PATTERN`. */
+type FilePathPattern = {
+    readonly pattern: "file-path-pattern";
+    readonly path: string;
+};
+/** A shorthand prefixed input: `<prefix>:...` where prefix is a known source provider. */
+export type ShorthandInput = {
+    readonly pattern: "shorthand-input";
+    readonly prefix: string;
+    readonly remainingInput: string;
+};
+/** A glob pattern containing `*` wildcards (e.g. `effect-*`). */
+type GlobInput = {
+    readonly pattern: "glob-input";
+    readonly value: string;
+};
+/** Discriminated union of all input patterns recognized by the parser. */
+export type InputPattern = NameInput | RegistryPatternInput | UrlInput | GitScpAddress | SlashPattern | FilePathPattern | ShorthandInput | GlobInput;
+/** Parse result with the classified pattern and original input. */
+export type InputParseResult<T = InputPattern> = {
+    readonly pattern: T;
+    readonly originalInput: string;
+};
+/**
+ * Classify an input string into an InputPattern.
+ *
+ * Pure function — no effects, no trimming. Returns `None` for empty/whitespace-only input.
+ */
+export declare const parseInputPattern: (input: string) => Option.Option<InputParseResult>;
+export {};
+//# sourceMappingURL=parser.d.ts.map

package/dist/src/unstable/sources/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/unstable/sources/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAUzF,qDAAqD;AACrD,KAAK,SAAS,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,uFAAuF;AACvF,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,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;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;CAC9D,CAAC;AAEF,gDAAgD;AAChD,KAAK,QAAQ,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC;AAErE,yFAAyF;AACzF,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,6EAA6E;AAC7E,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,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,CAAC;AAEF,6DAA6D;AAC7D,KAAK,eAAe,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,0FAA0F;AAC1F,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,iEAAiE;AACjE,KAAK,SAAS,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,0EAA0E;AAC1E,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,oBAAoB,GACpB,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,eAAe,GACf,cAAc,GACd,SAAS,CAAC;AAEd,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,YAAY,IAAI;IAC/C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAWF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAgG/E,CAAC"}

package/dist/src/unstable/sources/parser.js

@@ -0,0 +1,108 @@
+/**
+ * Input pattern classification for source strings.
+ *
+ * Classifies raw input strings into typed `InputPattern` variants
+ * (URL, SCP, shorthand, file path, etc.) for downstream routing
+ * by `resolveSource`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import { parseRegistrySourcePatternParts } from "../extensions/registry-source.js";
+/** Matches: ./path, ../path, /path, ~/path, ~\path, or Windows paths like C:\path */
+const LOCAL_PATH_PATTERN = /^(?:\.\.?\/|\/|~\/|~\\|[A-Za-z]:[\\/])/;
+/** SCP-style: `user@host:path` — no `://` scheme. */
+const SCP_PATTERN = /^([^@]+)@([^:]+):(.+)$/;
+/** Known shorthand prefixes. */
+const SHORTHAND_PREFIXES = new Set(["github", "gitlab", "bitbucket"]);
+/** Simple name: alphanumeric with hyphens, no leading/trailing hyphen. */
+const NAME_PATTERN = /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/;
+/**
+ * Classify an input string into an InputPattern.
+ *
+ * Pure function — no effects, no trimming. Returns `None` for empty/whitespace-only input.
+ */
+export const parseInputPattern = (input) => {
+    const wrap = (pattern) => ({ pattern, originalInput: input });
+    // 1. SCP-style git address (user@host:path) — must check before URL
+    const scpMatch = input.match(SCP_PATTERN);
+    if (scpMatch && scpMatch[1] && scpMatch[2] && scpMatch[3]) {
+        return Option.some(wrap({
+            pattern: "git-scp-address",
+            user: scpMatch[1],
+            host: scpMatch[2],
+            path: scpMatch[3],
+        }));
+    }
+    // 2. Shorthand prefix (github:..., gitlab:..., etc.) — must check before URL
+    const colonIndex = input.indexOf(":");
+    if (colonIndex > 0 && SHORTHAND_PREFIXES.has(input.slice(0, colonIndex))) {
+        return Option.some(wrap({
+            pattern: "shorthand-input",
+            prefix: input.slice(0, colonIndex),
+            remainingInput: input.slice(colonIndex + 1),
+        }));
+    }
+    // 3. File path — must check before URL (e.g. `C:/path` is a valid URL with scheme `c:`)
+    if (LOCAL_PATH_PATTERN.test(input)) {
+        return Option.some(wrap({ pattern: "file-path-pattern", path: input }));
+    }
+    // 4. URL
+    try {
+        const url = new URL(input);
+        if (url.protocol === "file:") {
+            return Option.some(wrap({ pattern: "file-path-pattern", path: url.pathname }));
+        }
+        return Option.some(wrap({ pattern: "url-input", url }));
+    }
+    catch {
+        // Not a URL
+    }
+    // 5. Registry source:
+    //    - @owner
+    //    - @owner/{type}
+    //    - @owner/{type}/{name}@constraint
+    if (input.startsWith("@")) {
+        const parsed = parseRegistrySourcePatternParts(input);
+        if (parsed !== undefined) {
+            return Option.some(wrap({
+                pattern: "registry-pattern-input",
+                type: Option.fromUndefinedOr(parsed.type),
+                owner: parsed.owner,
+                name: Option.fromUndefinedOr(parsed.name),
+                versionConstraint: Option.fromUndefinedOr(parsed.versionConstraint),
+            }));
+        }
+    }
+    // 6. Slash pattern (exactly two valid-name segments: `owner/repo`)
+    //    3+ segment slash inputs (e.g., `owner/repo/path`) are unsupported here.
+    //    Use the full URL or a shorthand like `github:owner/repo --path subdir` instead.
+    if (input.includes("/")) {
+        const segments = input.split("/");
+        if (segments.length === 2 && segments.every((s) => NAME_PATTERN.test(s))) {
+            const first = segments.at(0);
+            const second = segments.at(1);
+            if (first === undefined || second === undefined) {
+                return Option.none();
+            }
+            return Option.some(wrap({
+                pattern: "slash-pattern",
+                first,
+                second,
+                third: Option.none(),
+            }));
+        }
+        return Option.none();
+    }
+    // 7. Glob pattern (contains `*` wildcard)
+    if (input.includes("*")) {
+        return Option.some(wrap({ pattern: "glob-input", value: input }));
+    }
+    // 8. Simple name (alphanumeric with hyphens, no leading/trailing hyphen)
+    if (NAME_PATTERN.test(input)) {
+        return Option.some(wrap({ pattern: "name-input", name: input }));
+    }
+    return Option.none();
+};
+//# sourceMappingURL=parser.js.map

package/dist/src/unstable/sources/parser.js.map

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

package/dist/src/unstable/sources/printer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Source printer for canonical shorthand strings and lock entry conversion.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { CommandLockEntry, McpServerLockEntry, SkillLockEntry } from "../lockfile/schema.js";
+import type { SourceParams } from "./types.js";
+type SourceLockEntry = SkillLockEntry | CommandLockEntry | McpServerLockEntry;
+/**
+ * Print source params as their canonical shorthand string.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const printSourceParams: (source: SourceParams) => string;
+/**
+ * Convert a skill lock entry back to a SourceParams.
+ * Inverse of sourceToLockEntry (lock entry optional fields -> Option).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const lockEntryToSourceParams: (entry: SourceLockEntry) => SourceParams;
+export {};
+//# sourceMappingURL=printer.d.ts.map

package/dist/src/unstable/sources/printer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"printer.d.ts","sourceRoot":"","sources":["../../../../src/unstable/sources/printer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAMlG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,KAAK,eAAe,GAAG,cAAc,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,YAAY,KAAG,MAkBxD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,eAAe,KAAG,YAiDhE,CAAC"}

package/dist/src/unstable/sources/printer.js

@@ -0,0 +1,93 @@
+/**
+ * Source printer for canonical shorthand strings and lock entry conversion.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import { print as azurereposPrint } from "../source-resolution/providers/azurerepos/index.js";
+import { print as bitbucketPrint } from "../source-resolution/providers/bitbucket/index.js";
+import { print as githubPrint } from "../source-resolution/providers/github/index.js";
+import { print as gitlabPrint } from "../source-resolution/providers/gitlab/index.js";
+import { print as localPrint } from "../source-resolution/providers/local-parser/index.js";
+/**
+ * Print source params as their canonical shorthand string.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const printSourceParams = (source) => {
+    switch (source.type) {
+        case "github":
+            return githubPrint(source);
+        case "gitlab":
+            return gitlabPrint(source);
+        case "bitbucket":
+            return bitbucketPrint(source);
+        case "azurerepos":
+            return azurereposPrint(source);
+        case "local":
+            return localPrint(source);
+        case "git":
+            return source.url.href;
+        case "registry": {
+            return "registry";
+        }
+    }
+};
+/**
+ * Convert a skill lock entry back to a SourceParams.
+ * Inverse of sourceToLockEntry (lock entry optional fields -> Option).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const lockEntryToSourceParams = (entry) => {
+    switch (entry.type) {
+        case "github":
+            return {
+                type: "github",
+                owner: entry.owner,
+                repo: entry.repo,
+                ref: Option.fromUndefinedOr(entry.ref),
+                subPath: Option.fromUndefinedOr(entry.path),
+            };
+        case "gitlab":
+            return {
+                type: "gitlab",
+                owner: entry.owner,
+                repo: entry.repo,
+                ref: Option.fromUndefinedOr(entry.ref),
+                subPath: Option.fromUndefinedOr(entry.path),
+            };
+        case "bitbucket":
+            return {
+                type: "bitbucket",
+                owner: entry.owner,
+                repo: entry.repo,
+                ref: Option.fromUndefinedOr(entry.ref),
+                subPath: Option.fromUndefinedOr(entry.path),
+            };
+        case "azurerepos":
+            return {
+                type: "azurerepos",
+                organization: entry.organization,
+                project: entry.project,
+                repo: entry.repo,
+                ref: Option.fromUndefinedOr(entry.ref),
+                subPath: Option.fromUndefinedOr(entry.path),
+            };
+        case "git":
+            return {
+                type: "git",
+                url: new URL(entry.url),
+                ref: Option.fromUndefinedOr(entry.ref),
+            };
+        case "local":
+            return { type: "local", path: entry.path };
+        case "registry":
+            return {
+                type: "registry",
+                owner: Option.none(),
+            };
+    }
+};
+//# sourceMappingURL=printer.js.map

package/dist/src/unstable/sources/printer.js.map

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

package/dist/src/unstable/sources/provider.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Source provider abstraction for unified extension discovery and fetching.
+ *
+ * Defines the `SourceHostProvider` interface that all source types implement,
+ * along with supporting types for search criteria, discovery results, and errors.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type * as Effect from "effect/Effect";
+import type * as Option from "effect/Option";
+import type { AppError } from "../app-error/index.js";
+import type { ExtensionType, Handle } from "../extensions/index.js";
+import type { ExtensionRef } from "../extensions/refs.js";
+import type { Source } from "./types.js";
+/**
+ * Search criteria passed to `find` -- independent of source identity.
+ *
+ * - `names`: extension names to match (empty = all)
+ * - `type`: findable extension type filter or `"*"` for all
+ * - `versionConstraint`: optional version constraint for registry-backed lookups
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface FindOptions {
+    readonly names: ReadonlyArray<string>;
+    readonly type: ExtensionType | "*";
+    /** Registry owner filter (e.g. "@acme"). */
+    readonly owner: Option.Option<Handle>;
+    readonly versionConstraint: Option.Option<string>;
+}
+/**
+ * Materialized extension files ready for installation.
+ *
+ * Returned by `fetch` after files have been prepared.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface ExtensionFiles {
+    /** Absolute path to directory containing extension files. */
+    readonly directory: string;
+}
+/**
+ * Source host provider that unifies how all source types are accessed.
+ *
+ * Each source type is implemented as a provider with `match`, `find` and `fetch`
+ * capabilities. The `R` parameter captures Effect requirements for the
+ * provider's operations.
+ *
+ * @typeParam S - The specific `Source` variant this provider handles.
+ * @typeParam R - Effect requirements for provider operations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SourceHostProvider<S extends Source = Source, R = never> {
+    /** Source type discriminator matching `S["type"]`. */
+    readonly type: S["type"];
+    /** Check if a URL belongs to this provider. */
+    readonly match: (url: URL) => Effect.Effect<boolean, AppError, R>;
+    /** Discover extensions at the given source matching the search criteria. */
+    readonly find: (source: S, options: FindOptions) => Effect.Effect<ReadonlyArray<ExtensionRef>, AppError, R>;
+    /** Fetch and materialize extension files for a discovered ref. */
+    readonly fetch: (source: S, ref: ExtensionRef) => Effect.Effect<ExtensionFiles, AppError, R>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/src/unstable/sources/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/unstable/sources/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMzC;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,GAAG,CAAC;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACnD;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,KAAK;IACtE,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAClE,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,CACb,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,WAAW,KACjB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC7D,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;CAC9F"}