@agentxm/extension-sources 0.28.4-bootstrap.0

package/dist/src/service.js

@@ -0,0 +1,109 @@
+/**
+ * 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 ServiceMap from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { parseRegistrySourcePatternParts } from "@agentxm/extension-model/unstable/extensions";
+import { printSourceParams } from "@agentxm/extension-model/unstable/sources/printer";
+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()("@agentxm/extension-sources/service/SourceHostProviders") {
+}
+// -----------------------------------------------------------------------------
+// Clone URL Building
+// -----------------------------------------------------------------------------
+/**
+ * Build a git clone URL from a source.
+ * Returns Some for git-based hosting sources, None for others.
+ *
+ * @internal
+ */
+export 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":
+        case "workspace":
+            return Option.none();
+    }
+};
+// -----------------------------------------------------------------------------
+// Origin Building
+// -----------------------------------------------------------------------------
+/**
+ * Get the canonical source string for display/comparison.
+ *
+ * @internal
+ */
+export 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;
+        case "workspace":
+            return printSourceParams(source);
+    }
+};
+// -----------------------------------------------------------------------------
+// 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);
+    }),
+    resolveNamed: (source, options) => Effect.gen(function* () {
+        const provider = yield* createRegistrySourceHostProviderFromHost(source);
+        const registrySource = { ...source, owner: Option.some(options.owner) };
+        return yield* provider.resolveNamed(registrySource, options);
+    }),
+    fetch: (source, ref) => Effect.flatMap(createRegistrySourceHostProviderFromHost(source), (provider) => provider.fetch(source, ref)),
+});
+//# sourceMappingURL=service.js.map

package/dist/src/url-fragment.d.ts

@@ -0,0 +1,5 @@
+import * as Option from "effect/Option";
+export declare const refFromFragment: (fragment: string) => Option.Option<string>;
+export declare const refFromUrlHash: (url: URL) => Option.Option<string>;
+export declare const stripUrlHash: (url: URL) => URL;
+//# sourceMappingURL=url-fragment.d.ts.map

package/dist/src/url-fragment.js

@@ -0,0 +1,19 @@
+import * as Option from "effect/Option";
+export const refFromFragment = (fragment) => {
+    const raw = fragment.startsWith("#") ? fragment.slice(1) : fragment;
+    if (raw.length === 0)
+        return Option.none();
+    try {
+        return Option.some(decodeURIComponent(raw));
+    }
+    catch {
+        return Option.some(raw);
+    }
+};
+export const refFromUrlHash = (url) => refFromFragment(url.hash);
+export const stripUrlHash = (url) => {
+    const clean = new URL(url.href);
+    clean.hash = "";
+    return clean;
+};
+//# sourceMappingURL=url-fragment.js.map

package/dist/src/workspace-catalog.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Workspace catalog port for source resolution.
+ *
+ * Source resolution interprets user input against workspace facts —
+ * configured source hosts, the desired extension graph, and the skill
+ * candidates visible on disk — without reaching into the workspace kernel.
+ * This service declares exactly those facts as data over the contract's
+ * source-host vocabulary; the composition root implements it from the
+ * workspace layer (see the application runtime's workspace-catalog Live).
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type * as Effect from "effect/Effect";
+import * as ServiceMap from "effect/Context";
+import type { ExtensionType } from "@agentxm/extension-model/unstable/extensions";
+import type { GitHostingSourceHost, RegistrySourceHost } from "@agentxm/extension-model/unstable/sources/types";
+import type { SuggestedAction } from "@agentxm/registry-protocol/unstable/suggested-action";
+import type { CarriedFailureCategory } from "./failure-category.js";
+/**
+ * A source host the workspace has configured: a git-hosting forge or a
+ * package registry, in the contract's source-host shape.
+ */
+export type ConfiguredSourceHost = GitHostingSourceHost | RegistrySourceHost;
+declare const WorkspaceCatalogUnavailable_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "WorkspaceCatalogUnavailable";
+} & Readonly<A>;
+/**
+ * The catalog implementation could not produce a workspace fact. The
+ * implementation owns the category and wording at construction; source
+ * resolution transports the failure — and keys fallback decisions on the
+ * category — without re-rendering it.
+ */
+export declare class WorkspaceCatalogUnavailable extends WorkspaceCatalogUnavailable_base<{
+    readonly category: CarriedFailureCategory;
+    readonly detail: string;
+    readonly suggestions?: ReadonlyArray<SuggestedAction>;
+    readonly cause?: unknown;
+}> {
+}
+/**
+ * The slice of one desired extension that source resolution consumes:
+ * enough to match a name to its configured source.
+ */
+export interface DesiredExtensionNodeView {
+    readonly type: ExtensionType;
+    readonly name: string;
+    readonly identity: string;
+    readonly source?: string | undefined;
+}
+export interface DesiredExtensionGraphView {
+    readonly complete: boolean;
+    readonly nodes: ReadonlyArray<DesiredExtensionNodeView>;
+}
+/**
+ * Skill-name candidates for glob expansion and name fallback: locked,
+ * configured, and on-disk skills, with on-disk locations already
+ * normalized to filesystem paths.
+ */
+export interface SkillCandidates {
+    readonly names: ReadonlyArray<string>;
+    readonly configuredSkills: Readonly<Record<string, {
+        readonly source?: string | undefined;
+    }>>;
+    readonly onDiskByName: ReadonlyMap<string, string>;
+}
+export interface WorkspaceCatalogService {
+    /** Absolute workspace root directory. */
+    readonly workspaceRoot: string;
+    readonly configuredSources: Effect.Effect<ReadonlyArray<ConfiguredSourceHost>, WorkspaceCatalogUnavailable>;
+    readonly registrySourceHosts: Effect.Effect<ReadonlyArray<RegistrySourceHost>, WorkspaceCatalogUnavailable>;
+    readonly desiredExtensionGraph: Effect.Effect<DesiredExtensionGraphView, WorkspaceCatalogUnavailable>;
+    readonly skillCandidates: Effect.Effect<SkillCandidates, WorkspaceCatalogUnavailable>;
+}
+declare const WorkspaceCatalog_base: ServiceMap.ServiceClass<WorkspaceCatalog, "@agentxm/extension-sources/workspace-catalog/WorkspaceCatalog", WorkspaceCatalogService>;
+export declare class WorkspaceCatalog extends WorkspaceCatalog_base {
+}
+export {};
+//# sourceMappingURL=workspace-catalog.d.ts.map

package/dist/src/workspace-catalog.js

@@ -0,0 +1,26 @@
+/**
+ * Workspace catalog port for source resolution.
+ *
+ * Source resolution interprets user input against workspace facts —
+ * configured source hosts, the desired extension graph, and the skill
+ * candidates visible on disk — without reaching into the workspace kernel.
+ * This service declares exactly those facts as data over the contract's
+ * source-host vocabulary; the composition root implements it from the
+ * workspace layer (see the application runtime's workspace-catalog Live).
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Data from "effect/Data";
+import * as ServiceMap from "effect/Context";
+/**
+ * The catalog implementation could not produce a workspace fact. The
+ * implementation owns the category and wording at construction; source
+ * resolution transports the failure — and keys fallback decisions on the
+ * category — without re-rendering it.
+ */
+export class WorkspaceCatalogUnavailable extends Data.TaggedError("WorkspaceCatalogUnavailable") {
+}
+export class WorkspaceCatalog extends ServiceMap.Service()("@agentxm/extension-sources/workspace-catalog/WorkspaceCatalog") {
+}
+//# sourceMappingURL=workspace-catalog.js.map

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@agentxm/extension-sources",
+  "version": "0.28.4-bootstrap.0",
+  "description": "AXM extension-source integration: source locator routing over the contract grammar, host providers for Registry, GitHub, GitLab, Bitbucket, Azure Repos, generic Git, and local paths, convention and manifest package discovery, identifier resolution, and shallow git acquisition for the axm CLI. Unstable and unsupported — use the axm.sh CLI.",
+  "type": "module",
+  "license": "FSL-1.1-MIT",
+  "homepage": "https://axm.sh",
+  "bugs": {
+    "url": "https://github.com/agentxm/axm/issues"
+  },
+  "author": "AgentXM <hello@agentxm.ai> (https://agentxm.ai)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentxm/axm.git",
+    "directory": "packages/extension-sources"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./live": {
+      "types": "./dist/src/live.d.ts",
+      "default": "./dist/src/live.js"
+    }
+  },
+  "files": [
+    "dist/src/",
+    "!**/*.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "nx": {
+    "includedScripts": []
+  },
+  "dependencies": {
+    "effect": "4.0.0-rc.112",
+    "semver": "^7.8.5",
+    "simple-git": "^3.36.0",
+    "@agentxm/extension-model": "^0.28.4-bootstrap.0",
+    "@agentxm/registry-client": "^0.28.4-bootstrap.0",
+    "@agentxm/registry-protocol": "^0.28.4-bootstrap.0"
+  },
+  "devDependencies": {
+    "@effect/platform-node": "4.0.0-rc.112",
+    "@effect/vitest": "4.0.0-rc.112",
+    "@types/semver": "^7.5.8",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "typescript": "npm:@typescript/typescript6@^6.0.2",
+    "vitest": "^4.1.10"
+  }
+}