@agentxm/client-core 0.1.6

package/dist/src/unstable/source-resolution/providers/gitlab/scp.js

@@ -0,0 +1,32 @@
+import * as Effect from "effect/Effect";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { makeAppError } from "../../../app-error/index.js";
+import { GitLabSourceParamsSchema } from "../../../sources/types.js";
+import { CANONICAL_HOSTNAME } from "./url.js";
+/** Matches: git@{hostname}:owner/repo.git */
+const SCP_PATTERN = /^git@([^:]+):([^/]+)\/([^/]+?)(?:\.git)?$/;
+const decodeGitLabSourceParams = Schema.decodeUnknownResult(GitLabSourceParamsSchema);
+export const parseScp = (input, hostname = CANONICAL_HOSTNAME) => {
+    const match = input.match(SCP_PATTERN);
+    if (!match || !match[1] || !match[2] || !match[3] || match[1] !== hostname) {
+        return Effect.fail(makeAppError({
+            code: "SOURCE_PARSE_FAILED",
+            what: "Invalid GitLab SSH URL format",
+            details: [input],
+        }));
+    }
+    const decoded = decodeGitLabSourceParams({
+        type: "gitlab",
+        owner: match[2],
+        repo: match[3],
+    });
+    return Result.isSuccess(decoded)
+        ? Effect.succeed(decoded.success)
+        : Effect.fail(makeAppError({
+            code: "SOURCE_PARSE_FAILED",
+            what: "Invalid GitLab SSH URL format",
+            details: [input],
+        }));
+};
+//# sourceMappingURL=scp.js.map

package/dist/src/unstable/source-resolution/providers/gitlab/scp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scp.js","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/gitlab/scp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAA2B,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,6CAA6C;AAC7C,MAAM,WAAW,GAAG,2CAA2C,CAAC;AAChE,MAAM,wBAAwB,GAAG,MAAM,CAAC,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;AAEtF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,WAAmB,kBAAkB,EAAE,EAAE;IAC/E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC3E,OAAO,MAAM,CAAC,IAAI,CAChB,YAAY,CAAC;YACX,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,+BAA+B;YACrC,OAAO,EAAE,CAAC,KAAK,CAAC;SACjB,CAAC,CACH,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,wBAAwB,CAAC;QACvC,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACf,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;KACf,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;QAC9B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAoC,CAAC;QAC9D,CAAC,CAAC,MAAM,CAAC,IAAI,CACT,YAAY,CAAC;YACX,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,+BAA+B;YACrC,OAAO,EAAE,CAAC,KAAK,CAAC;SACjB,CAAC,CACH,CAAC;AACR,CAAC,CAAC"}

package/dist/src/unstable/source-resolution/providers/gitlab/shorthand.d.ts

@@ -0,0 +1,9 @@
+import * as Effect from "effect/Effect";
+export declare const parseShorthand: (input: string) => Effect.Effect<{
+    owner: string;
+    repo: string;
+    ref: import("effect/Option").Option<string>;
+    subPath: import("effect/Option").Option<string>;
+    type: "gitlab";
+}, import("../../../app-error/app-error.ts").AppError, never>;
+//# sourceMappingURL=shorthand.d.ts.map

package/dist/src/unstable/source-resolution/providers/gitlab/shorthand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shorthand.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/gitlab/shorthand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM;;;;;;6DAQxC,CAAC"}

package/dist/src/unstable/source-resolution/providers/gitlab/shorthand.js

@@ -0,0 +1,11 @@
+import * as Effect from "effect/Effect";
+import { parseProviderShorthand } from "../parse-provider-shorthand.js";
+export const parseShorthand = (input) => Effect.gen(function* () {
+    const body = input.slice("gitlab:".length);
+    const parts = yield* parseProviderShorthand(body, input);
+    return {
+        type: "gitlab",
+        ...parts,
+    };
+});
+//# sourceMappingURL=shorthand.js.map

package/dist/src/unstable/source-resolution/providers/gitlab/shorthand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shorthand.js","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/gitlab/shorthand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,EAAE,CAC9C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,GAAG,KAAK;KACoB,CAAC;AACjC,CAAC,CAAC,CAAC"}

package/dist/src/unstable/source-resolution/providers/gitlab/url.d.ts

@@ -0,0 +1,10 @@
+import * as Effect from "effect/Effect";
+export declare const CANONICAL_HOSTNAME = "gitlab.com";
+export declare const parseUrl: (url: URL, hostname?: string) => Effect.Effect<never, import("../../../app-error/app-error.ts").AppError, never> | Effect.Effect<{
+    readonly type: "gitlab";
+    readonly owner: string;
+    readonly repo: string;
+    readonly ref: import("effect/Option").Option<string>;
+    readonly subPath: import("effect/Option").Option<string>;
+}, never, never>;
+//# sourceMappingURL=url.d.ts.map

package/dist/src/unstable/source-resolution/providers/gitlab/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/gitlab/url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAOxC,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAM/C,eAAO,MAAM,QAAQ,GAAI,KAAK,GAAG,EAAE,WAAU,MAA2B;;;;;;gBAoCvE,CAAC"}

package/dist/src/unstable/source-resolution/providers/gitlab/url.js

@@ -0,0 +1,41 @@
+import * as Effect from "effect/Effect";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { makeAppError } from "../../../app-error/index.js";
+import { GitLabSourceParamsSchema } from "../../../sources/types.js";
+export const CANONICAL_HOSTNAME = "gitlab.com";
+/** Matches: /owner/repo[/-/tree/ref/path] */
+const GITLAB_PATH_PATTERN = /^\/([^/]+)\/([^/]+?)(?:\.git)?(?:\/-\/tree\/([^/]+)(?:\/(.+))?)?$/;
+const decodeGitLabSourceParams = Schema.decodeUnknownResult(GitLabSourceParamsSchema);
+export const parseUrl = (url, hostname = CANONICAL_HOSTNAME) => {
+    if (url.hostname !== hostname) {
+        return Effect.fail(makeAppError({
+            code: "SOURCE_PARSE_FAILED",
+            what: "Invalid GitLab URL format",
+            details: [url.href],
+        }));
+    }
+    const match = url.pathname.match(GITLAB_PATH_PATTERN);
+    if (!match || !match[1] || !match[2]) {
+        return Effect.fail(makeAppError({
+            code: "SOURCE_PARSE_FAILED",
+            what: "Invalid GitLab URL format",
+            details: [url.href],
+        }));
+    }
+    const decoded = decodeGitLabSourceParams({
+        type: "gitlab",
+        owner: match[1],
+        repo: match[2],
+        ...(match[3] === undefined ? {} : { ref: match[3] }),
+        ...(match[4] === undefined ? {} : { subPath: match[4] }),
+    });
+    return Result.isSuccess(decoded)
+        ? Effect.succeed(decoded.success)
+        : Effect.fail(makeAppError({
+            code: "SOURCE_PARSE_FAILED",
+            what: "Invalid GitLab URL format",
+            details: [url.href],
+        }));
+};
+//# sourceMappingURL=url.js.map

package/dist/src/unstable/source-resolution/providers/gitlab/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/gitlab/url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAA2B,MAAM,2BAA2B,CAAC;AAE9F,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE/C,6CAA6C;AAC7C,MAAM,mBAAmB,GAAG,mEAAmE,CAAC;AAChG,MAAM,wBAAwB,GAAG,MAAM,CAAC,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;AAEtF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAQ,EAAE,WAAmB,kBAAkB,EAAE,EAAE;IAC1E,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,IAAI,CAChB,YAAY,CAAC;YACX,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;SACpB,CAAC,CACH,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,IAAI,CAChB,YAAY,CAAC;YACX,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;SACpB,CAAC,CACH,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,wBAAwB,CAAC;QACvC,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACf,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACd,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;QAC9B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAoC,CAAC;QAC9D,CAAC,CAAC,MAAM,CAAC,IAAI,CACT,YAAY,CAAC;YACX,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;SACpB,CAAC,CACH,CAAC;AACR,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Local source parsing.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { parseLocalPath } from "./parser.js";
+export { print } from "./print.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/local-parser/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Local source parsing.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { parseLocalPath } from "./parser.js";
+export { print } from "./print.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/local-parser/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/unstable/source-resolution/providers/local-parser/parser.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Local source parsers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import type { AppError } from "../../../app-error/index.js";
+import type { LocalSourceParams } from "../../../sources/types.js";
+/**
+ * Parse a local filesystem path.
+ */
+export declare const parseLocalPath: (input: string) => Effect.Effect<LocalSourceParams, AppError>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/src/unstable/source-resolution/providers/local-parser/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/local-parser/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAEvF,CAAC"}

package/dist/src/unstable/source-resolution/providers/local-parser/parser.js

@@ -0,0 +1,14 @@
+/**
+ * Local source parsers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+/**
+ * Parse a local filesystem path.
+ */
+export const parseLocalPath = (input) => {
+    return Effect.succeed({ type: "local", path: input });
+};
+//# sourceMappingURL=parser.js.map

package/dist/src/unstable/source-resolution/providers/local-parser/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/local-parser/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAA8C,EAAE;IAC1F,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACjE,CAAC,CAAC"}

package/dist/src/unstable/source-resolution/providers/local-parser/print.d.ts

@@ -0,0 +1,3 @@
+import type { LocalSourceParams } from "../../../sources/types.js";
+export declare const print: (source: LocalSourceParams) => string;
+//# sourceMappingURL=print.d.ts.map

package/dist/src/unstable/source-resolution/providers/local-parser/print.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/local-parser/print.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,eAAO,MAAM,KAAK,GAAI,QAAQ,iBAAiB,WAAgB,CAAC"}

package/dist/src/unstable/source-resolution/providers/local-parser/print.js

@@ -0,0 +1,2 @@
+export const print = (source) => source.path;
+//# sourceMappingURL=print.js.map

package/dist/src/unstable/source-resolution/providers/local-parser/print.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/local-parser/print.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAyB,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Source provider for local filesystem paths.
+ *
+ * Wraps the existing `discoverSkillsInDir` logic into the `SourceHostProvider` interface.
+ *
+ * @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 type { SourceHostProvider, LocalSource } from "../../sources/index.js";
+/**
+ * Source host provider for local filesystem paths.
+ *
+ * Self-describing — no host config needed.
+ * `match` returns true for file:// URLs and absolute/relative paths.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const createLocalSourceHostProvider: () => SourceHostProvider<LocalSource, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=local.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/source-resolution/providers/local.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AASzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,QAAO,kBAAkB,CACjE,WAAW,EACX,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAqDjC,CAAC"}

package/dist/src/unstable/source-resolution/providers/local.js

@@ -0,0 +1,66 @@
+/**
+ * Source provider for local filesystem paths.
+ *
+ * Wraps the existing `discoverSkillsInDir` logic into the `SourceHostProvider` interface.
+ *
+ * @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 Option from "effect/Option";
+import { discoverSkillsInDir } from "../discover-skills.js";
+import { makeAppError } from "../../app-error/index.js";
+import { decodeExtensionNameSync } from "../../extensions/index.js";
+import { fileUrlToPath } from "../../sources/index.js";
+/**
+ * Source host provider for local filesystem paths.
+ *
+ * Self-describing — no host config needed.
+ * `match` returns true for file:// URLs and absolute/relative paths.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const createLocalSourceHostProvider = () => ({
+    type: "local",
+    match: (url) => Effect.succeed(url.protocol === "file:"),
+    find: (source, options) => Effect.gen(function* () {
+        const discovered = yield* discoverSkillsInDir(source.path, Option.none(), {
+            fullDepth: false,
+            includeInternal: false,
+        }).pipe(Effect.mapError((error) => makeAppError({
+            code: "SOURCE_FETCH_FAILED",
+            what: `Failed to discover skills`,
+            details: [error.message],
+            cause: error,
+        })));
+        // Map to ExtensionRef with LocalRefDetails
+        const mapped = Array.map(discovered, (d) => ({
+            type: "skill",
+            refType: "local",
+            skill: {
+                name: decodeExtensionNameSync(d.skill.name),
+                description: Option.some(d.skill.description),
+                metadata: d.skill.metadata,
+            },
+            source,
+            location: d.location,
+        }));
+        if (options.names.length === 0)
+            return mapped;
+        const nameSet = new Set(options.names);
+        return mapped.filter((r) => r.type === "skill" && nameSet.has(r.skill.name));
+    }),
+    fetch: (_source, ref) => {
+        if (ref.refType !== "local") {
+            return Effect.fail(makeAppError({
+                code: "SOURCE_FETCH_FAILED",
+                what: "Expected ref with location for local source, but none was provided",
+            }));
+        }
+        return Effect.succeed({
+            directory: fileUrlToPath(ref.location),
+        });
+    },
+});
+//# sourceMappingURL=local.js.map

package/dist/src/unstable/source-resolution/providers/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../../src/unstable/source-resolution/providers/local.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAqB,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAG3C,EAAE,CAAC,CAAC;IACJ,IAAI,EAAE,OAAO;IAEb,KAAK,EAAE,CAAC,GAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC;IAE7D,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CACxB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE;YACxE,SAAS,EAAE,KAAK;YAChB,eAAe,EAAE,KAAK;SACvB,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,YAAY,CAAC;YACX,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;YACxB,KAAK,EAAE,KAAK;SACb,CAAC,CACH,CACF,CAAC;QAEF,2CAA2C;QAC3C,MAAM,MAAM,GAAgC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxE,IAAI,EAAE,OAAgB;YACtB,OAAO,EAAE,OAAgB;YACzB,KAAK,EAAE;gBACL,IAAI,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC3C,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;gBAC7C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ;aAC3B;YACD,MAAM;YACN,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC,CAAC;QAEJ,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC;IAEJ,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACtB,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC,IAAI,CAChB,YAAY,CAAC;gBACX,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,oEAAoE;aAC3E,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC;YACpB,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/src/unstable/source-resolution/providers/parse-provider-shorthand.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared helper for parsing provider shorthand patterns.
+ *
+ * Parses the `owner/repo[/path][@ref]` portion (after stripping the prefix)
+ * into constituent parts.
+ *
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import type { AppError } from "../../app-error/index.js";
+import { type GitHostedSourceParamParts } from "../../sources/types.js";
+/**
+ * Parse the body of a provider shorthand (the part after the `prefix:` prefix).
+ *
+ * Returns `{ owner, repo, subPath?, ref? }` or fails with AppError.
+ */
+export declare const parseProviderShorthand: (input: string, original: string) => Effect.Effect<GitHostedSourceParamParts, AppError>;
+//# sourceMappingURL=parse-provider-shorthand.d.ts.map

package/dist/src/unstable/source-resolution/providers/parse-provider-shorthand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-provider-shorthand.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/source-resolution/providers/parse-provider-shorthand.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,wBAAwB,CAAC;AAOhC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,MAAM,EACb,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,QAAQ,CA2BhD,CAAC"}

package/dist/src/unstable/source-resolution/providers/parse-provider-shorthand.js

@@ -0,0 +1,46 @@
+/**
+ * Shared helper for parsing provider shorthand patterns.
+ *
+ * Parses the `owner/repo[/path][@ref]` portion (after stripping the prefix)
+ * into constituent parts.
+ *
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { makeAppError } from "../../app-error/index.js";
+import { GitHostedSourceParamPartsSchema, } from "../../sources/types.js";
+/** Matches: owner/repo[/path][@ref] */
+const PROVIDER_SHORTHAND_PATTERN = /^([^/@]+)\/([^/@]+)(?:\/([^@]+))?(?:@(.+))?$/;
+const decodeGitHostedSourceParamParts = Schema.decodeUnknownResult(GitHostedSourceParamPartsSchema);
+/**
+ * Parse the body of a provider shorthand (the part after the `prefix:` prefix).
+ *
+ * Returns `{ owner, repo, subPath?, ref? }` or fails with AppError.
+ */
+export const parseProviderShorthand = (input, original) => Effect.gen(function* () {
+    const match = input.match(PROVIDER_SHORTHAND_PATTERN);
+    if (!match || !match[1] || !match[2]) {
+        return yield* makeAppError({
+            code: "SOURCE_PARSE_FAILED",
+            what: "Invalid shorthand format",
+            details: [original],
+        });
+    }
+    const decoded = decodeGitHostedSourceParamParts({
+        owner: match[1],
+        repo: match[2],
+        ...(match[3] === undefined ? {} : { subPath: match[3] }),
+        ...(match[4] === undefined ? {} : { ref: match[4] }),
+    });
+    if (Result.isFailure(decoded)) {
+        return yield* makeAppError({
+            code: "SOURCE_PARSE_FAILED",
+            what: "Invalid shorthand format",
+            details: [original],
+        });
+    }
+    return decoded.success;
+});
+//# sourceMappingURL=parse-provider-shorthand.js.map

package/dist/src/unstable/source-resolution/providers/parse-provider-shorthand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-provider-shorthand.js","sourceRoot":"","sources":["../../../../../src/unstable/source-resolution/providers/parse-provider-shorthand.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EACL,+BAA+B,GAEhC,MAAM,wBAAwB,CAAC;AAEhC,uCAAuC;AACvC,MAAM,0BAA0B,GAAG,8CAA8C,CAAC;AAElF,MAAM,+BAA+B,GAAG,MAAM,CAAC,mBAAmB,CAAC,+BAA+B,CAAC,CAAC;AAEpG;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,KAAa,EACb,QAAgB,EACoC,EAAE,CACtD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,CAAC,QAAQ,CAAC;SACpB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,+BAA+B,CAAC;QAC9C,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACf,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACd,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,CAAC,QAAQ,CAAC;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC;AACzB,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * 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 Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import { type AppError } from "../../../app-error/index.js";
+import { type Handle } from "../../../extensions/handle.js";
+import type { RegistryClient } from "../../../registry/index.js";
+import { type ExtensionName, type ExtensionType } from "../../../extensions/index.js";
+import type { SourceHostProvider, RegistrySource, RegistrySourceHost } from "../../../sources/index.js";
+import type { VersionEntry } from "../../../registry/index.js";
+import type { ExactSemverVersion } from "../../../version-constraints/version-constraints.js";
+type RegistrySourceHostProviderWithPublish<R = never> = SourceHostProvider<RegistrySource, R> & {
+    readonly publishExtension: (owner: Handle, type: ExtensionType, name: ExtensionName, version: ExactSemverVersion, archive: Uint8Array, metadata: VersionEntry) => Effect.Effect<void, AppError, R>;
+};
+/**
+ * Creates a local registry source host provider backed by a RegistryClient.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const createLocalRegistrySourceHostProvider: (client: RegistryClient) => RegistrySourceHostProviderWithPublish<FileSystem.FileSystem | Path.Path | Scope.Scope>;
+/**
+ * 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 declare const createRemoteRegistrySourceHostProvider: (client: RegistryClient) => RegistrySourceHostProviderWithPublish<FileSystem.FileSystem | Path.Path | Scope.Scope>;
+/**
+ * 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 declare const createRegistrySourceHostProviderFromHost: (host: RegistrySourceHost) => Effect.Effect<RegistrySourceHostProviderWithPublish<FileSystem.FileSystem | Path.Path | Scope.Scope>, never, FileSystem.FileSystem | Path.Path>;
+export {};
+//# sourceMappingURL=host-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-provider.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/source-resolution/providers/registry/host-provider.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;AAExC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAGV,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AAE9F,KAAK,qCAAqC,CAAC,CAAC,GAAG,KAAK,IAAI,kBAAkB,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG;IAC9F,QAAQ,CAAC,gBAAgB,EAAE,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,YAAY,KACnB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;CACvC,CAAC;AAoTF;;;;GAIG;AACH,eAAO,MAAM,qCAAqC,GAChD,QAAQ,cAAc,KACrB,qCAAqC,CAAC,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAkDtF,CAAC;AAMH;;;;;;;GAOG;AACH,eAAO,MAAM,sCAAsC,GACjD,QAAQ,cAAc,KACrB,qCAAqC,CAAC,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CA2BtF,CAAC;AAMH;;;;;;;GAOG;AACH,eAAO,MAAM,wCAAwC,GAAI,MAAM,kBAAkB,oJAW7E,CAAC"}