@agentxm/client-core 0.1.6

package/dist/src/unstable/packaging/hex.js

@@ -0,0 +1,225 @@
+/**
+ * Hex package detector and reader for package-compatibility discovery.
+ *
+ * Supports both Elixir (mix.exs) and Gleam (gleam.toml) projects.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { PackageURL } from "packageurl-js";
+import { AxmPackageMetaSchema } from "./axm-package-meta.js";
+import { PackageTypeSchema } from "./package-type.js";
+import { PackageUrlSchema } from "./package-url.js";
+const hexType = Schema.decodeUnknownSync(PackageTypeSchema)("hex");
+const decodePurl = Schema.decodeUnknownSync(PackageUrlSchema);
+const decodeAxmMeta = Schema.decodeUnknownResult(AxmPackageMetaSchema);
+/**
+ * Returns true if the specifier is an exact semver version (no range operators).
+ */
+const isExactVersion = (specifier) => /^\d+\.\d+\.\d+(?:[-+][a-zA-Z0-9._+-]*)?$/.test(specifier);
+/**
+ * Regex to detect :path or :git options which indicate non-registry deps.
+ */
+const PATH_OR_GIT_REGEX = /(?:path|git):\s*"/;
+/**
+ * Parse mix.exs content and extract dependency tuples from the deps function.
+ */
+const parseMixExs = (content, source) => {
+    const results = [];
+    // Extract the full dep tuples to check for path/git options
+    const fullTuples = new Map();
+    let fullMatch;
+    const fullRegex = /\{:(\w+)[^}]*\}/g;
+    while ((fullMatch = fullRegex.exec(content)) !== null) {
+        const name = fullMatch[1];
+        if (name !== undefined) {
+            fullTuples.set(name, fullMatch[0]);
+        }
+    }
+    // Now extract deps with version strings
+    let match;
+    const depRegex = /\{:(\w+),\s*"([^"]*)"/g;
+    while ((match = depRegex.exec(content)) !== null) {
+        const name = match[1];
+        const versionSpec = match[2];
+        if (name === undefined || versionSpec === undefined)
+            continue;
+        // Check if this dep has path: or git: options (skip if so)
+        const fullTuple = fullTuples.get(name);
+        if (fullTuple !== undefined && PATH_OR_GIT_REGEX.test(fullTuple))
+            continue;
+        const version = isExactVersion(versionSpec) ? versionSpec : undefined;
+        const purl = new PackageURL("hex", null, name, version ?? null, null, null);
+        const purlParts = decodePurl(purl.toString());
+        results.push({ purl: purlParts, type: hexType, source });
+    }
+    return results;
+};
+/**
+ * Parse a TOML-like section for dependencies.
+ * Handles simple `name = "version"` entries within a section block.
+ */
+const parseTomlDeps = (content, sectionName, source) => {
+    const results = [];
+    // Find the section
+    const sectionRegex = new RegExp(`\\[${sectionName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\]`);
+    const sectionMatch = sectionRegex.exec(content);
+    if (sectionMatch === null)
+        return [];
+    const sectionStart = sectionMatch.index + sectionMatch[0].length;
+    // Find the next section (or end of content)
+    const nextSectionMatch = /\n\[/.exec(content.slice(sectionStart));
+    const sectionEnd = nextSectionMatch !== null ? sectionStart + nextSectionMatch.index : content.length;
+    const sectionContent = content.slice(sectionStart, sectionEnd);
+    // Parse key = "value" entries
+    const entryRegex = /^(\w+)\s*=\s*"([^"]*)"/gm;
+    let match;
+    while ((match = entryRegex.exec(sectionContent)) !== null) {
+        const name = match[1];
+        const versionSpec = match[2];
+        if (name === undefined || versionSpec === undefined)
+            continue;
+        const version = isExactVersion(versionSpec) ? versionSpec : undefined;
+        const purl = new PackageURL("hex", null, name, version ?? null, null, null);
+        const purlParts = decodePurl(purl.toString());
+        results.push({ purl: purlParts, type: hexType, source });
+    }
+    return results;
+};
+/**
+ * Parse gleam.toml content and extract dependencies from [dependencies] and [dev-dependencies].
+ */
+const parseGleamToml = (content, source) => {
+    const deps = parseTomlDeps(content, "dependencies", source);
+    const devDeps = parseTomlDeps(content, "dev-dependencies", source);
+    return [...deps, ...devDeps];
+};
+/**
+ * Read a file as string, returning Option.none for NotFound and other errors.
+ */
+const readFileOptional = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    return content;
+});
+/**
+ * Parse JSON string, returning Option.none and logging a warning on failure.
+ */
+const parseJsonOptional = (content, context) => Effect.gen(function* () {
+    const result = yield* Effect.try({
+        try: () => JSON.parse(content),
+        catch: () => ({ _tag: "JsonParseError" }),
+    }).pipe(Effect.option);
+    if (Option.isNone(result)) {
+        yield* Effect.logWarning(`Malformed JSON in ${context}, skipping`);
+        return Option.none();
+    }
+    return Option.some(result.value);
+});
+/**
+ * Parse Erlang term format hex_metadata.config to extract the extra.axm field.
+ * This is a simplified parser that extracts the axm JSON from the extra field.
+ *
+ * Erlang binary strings use `<<"...">>` delimiters. The axm value is a JSON
+ * string embedded as an Erlang binary, potentially with escaped quotes inside.
+ */
+const parseHexMetadataExtra = (content) => {
+    // Look for <<"axm">> key followed by its value in <<"...">> format
+    // The value may contain escaped quotes within the Erlang binary string
+    const axmMatch = /<<"axm">>,\s*<<"((?:[^"\\]|\\.)*)">>/m.exec(content);
+    if (axmMatch?.[1] !== undefined) {
+        // Unescape any escaped quotes from the Erlang binary string encoding
+        const jsonStr = axmMatch[1].replace(/\\"/g, '"');
+        try {
+            const parsed = JSON.parse(jsonStr);
+            return parsed;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+};
+/**
+ * Hex package detector.
+ *
+ * Scans `mix.exs` and `gleam.toml` in the project directory and extracts
+ * dependencies from Elixir dependency tuples and Gleam TOML sections.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const hexDetector = {
+    type: hexType,
+    detect: Effect.fn("detect.hex")(function* (projectDir) {
+        const path = yield* Path.Path;
+        const results = [];
+        // Try mix.exs (Elixir)
+        const mixPath = path.join(projectDir, "mix.exs");
+        const mixContent = yield* readFileOptional(mixPath);
+        if (Option.isSome(mixContent)) {
+            const mixDeps = parseMixExs(mixContent.value, mixPath);
+            results.push(...mixDeps);
+        }
+        // Try gleam.toml (Gleam)
+        const gleamPath = path.join(projectDir, "gleam.toml");
+        const gleamContent = yield* readFileOptional(gleamPath);
+        if (Option.isSome(gleamContent)) {
+            const gleamDeps = parseGleamToml(gleamContent.value, gleamPath);
+            results.push(...gleamDeps);
+        }
+        return results;
+    }, Effect.annotateLogs({ detector: "hex" }), Effect.withSpan("detect.hex")),
+};
+/**
+ * Hex package reader.
+ *
+ * Reads `deps/<package-name>/axm.json` as the primary source, falling back to
+ * parsing `hex_metadata.config` for each detected Hex package.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const hexReader = {
+    type: hexType,
+    read: Effect.fn("read.hex")(function* (pkg) {
+        const path = yield* Path.Path;
+        // Derive project directory from the source manifest path
+        const projectDir = path.dirname(pkg.source);
+        const pkgName = pkg.purl.name;
+        // Try axm.json sidecar first
+        const axmJsonPath = path.join(projectDir, "deps", pkgName, "axm.json");
+        const axmContent = yield* readFileOptional(axmJsonPath);
+        if (Option.isSome(axmContent)) {
+            const parsed = yield* parseJsonOptional(axmContent.value, `${pkgName}/axm.json`);
+            if (Option.isSome(parsed)) {
+                const metaResult = decodeAxmMeta(parsed.value);
+                if (Result.isFailure(metaResult)) {
+                    yield* Effect.logWarning(`Invalid axm metadata in ${pkgName}/axm.json: schema validation failed`);
+                    return Option.none();
+                }
+                return Option.some(metaResult.success.recommendedExtensions);
+            }
+        }
+        // Fall back to hex_metadata.config
+        const hexMetaPath = path.join(projectDir, "deps", pkgName, "hex_metadata.config");
+        const hexMetaContent = yield* readFileOptional(hexMetaPath);
+        if (Option.isSome(hexMetaContent)) {
+            const axmData = parseHexMetadataExtra(hexMetaContent.value);
+            if (axmData !== undefined) {
+                const metaResult = decodeAxmMeta(axmData);
+                if (Result.isFailure(metaResult)) {
+                    yield* Effect.logWarning(`Invalid axm metadata in ${pkgName}/hex_metadata.config: schema validation failed`);
+                    return Option.none();
+                }
+                return Option.some(metaResult.success.recommendedExtensions);
+            }
+        }
+        return Option.none();
+    }, Effect.annotateLogs({ reader: "hex" }), Effect.withSpan("read.hex")),
+};
+//# sourceMappingURL=hex.js.map

package/dist/src/unstable/packaging/hex.js.map

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

package/dist/src/unstable/packaging/huggingface.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Hugging Face (ML models) package reader for package-compatibility discovery.
+ *
+ * Reads YAML frontmatter from model cards in the Hugging Face cache directory.
+ * No detector is provided for this ecosystem.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { PackageReader } from "./types.js";
+/**
+ * Hugging Face model reader.
+ *
+ * Reads YAML frontmatter from model cards in
+ * `~/.cache/huggingface/hub/models--<id>/` and extracts axm metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const huggingfaceReader: PackageReader;
+//# sourceMappingURL=huggingface.d.ts.map

package/dist/src/unstable/packaging/huggingface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"huggingface.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/huggingface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,YAAY,CAAC;AAqDjE;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAkE/B,CAAC"}

package/dist/src/unstable/packaging/huggingface.js

@@ -0,0 +1,123 @@
+/**
+ * Hugging Face (ML models) package reader for package-compatibility discovery.
+ *
+ * Reads YAML frontmatter from model cards in the Hugging Face cache directory.
+ * No detector is provided for this ecosystem.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Intentional escape hatch: node:os homedir() has no @effect/platform equivalent.
+import * as os from "node:os";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import YAML from "yaml";
+import { AxmPackageMetaSchema } from "./axm-package-meta.js";
+// eslint-disable-next-line no-restricted-properties -- Centralized env var access for packaging detectors
+const readEnv = (name) => process.env[name];
+import { PackageTypeSchema } from "./package-type.js";
+const huggingfaceType = Schema.decodeUnknownSync(PackageTypeSchema)("huggingface");
+const decodeAxmMeta = Schema.decodeUnknownResult(AxmPackageMetaSchema);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Read a file as string, returning Option.none for NotFound and other errors.
+ */
+const readFileOptional = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    return content;
+});
+/**
+ * Extract YAML frontmatter from a markdown file.
+ * Frontmatter is delimited by `---` at the start and end.
+ */
+const extractYamlFrontmatter = (content) => {
+    if (!content.startsWith("---"))
+        return undefined;
+    const endIdx = content.indexOf("\n---", 3);
+    if (endIdx === -1)
+        return undefined;
+    return content.slice(3, endIdx).trim();
+};
+/** Schema for extracting the axm field from model card frontmatter. */
+const ModelCardAxmSchema = Schema.Struct({
+    axm: Schema.optional(Schema.Unknown),
+});
+const decodeModelCardAxm = Schema.decodeUnknownResult(ModelCardAxmSchema);
+/**
+ * Resolve the Hugging Face cache directory.
+ * Checks HF_HOME, HUGGINGFACE_HUB_CACHE, then defaults to ~/.cache/huggingface/hub.
+ */
+const resolveHfCache = () => Effect.sync(() => readEnv("HUGGINGFACE_HUB_CACHE") ??
+    (readEnv("HF_HOME") ? `${readEnv("HF_HOME")}/hub` : `${os.homedir()}/.cache/huggingface/hub`));
+// ---------------------------------------------------------------------------
+// Reader
+// ---------------------------------------------------------------------------
+/**
+ * Hugging Face model reader.
+ *
+ * Reads YAML frontmatter from model cards in
+ * `~/.cache/huggingface/hub/models--<id>/` and extracts axm metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const huggingfaceReader = {
+    type: huggingfaceType,
+    read: Effect.fn("read.huggingface")(function* (pkg) {
+        const path = yield* Path.Path;
+        const hfCache = yield* resolveHfCache();
+        // Model IDs use -- as separator in the cache directory
+        // e.g., models--org--model-name for org/model-name
+        const namespace = pkg.purl.namespace;
+        const modelDirName = namespace
+            ? `models--${namespace}--${pkg.purl.name}`
+            : `models--${pkg.purl.name}`;
+        // Look for README.md in the snapshot directory
+        const modelDir = path.join(hfCache, modelDirName);
+        // Find the latest snapshot by reading the refs/main file
+        const refsMainPath = path.join(modelDir, "refs", "main");
+        const refContent = yield* readFileOptional(refsMainPath);
+        if (Option.isNone(refContent))
+            return Option.none();
+        const snapshotHash = refContent.value.trim();
+        if (snapshotHash === "")
+            return Option.none();
+        const readmePath = path.join(modelDir, "snapshots", snapshotHash, "README.md");
+        const readmeContent = yield* readFileOptional(readmePath);
+        if (Option.isNone(readmeContent))
+            return Option.none();
+        // Extract YAML frontmatter
+        const frontmatter = extractYamlFrontmatter(readmeContent.value);
+        if (frontmatter === undefined)
+            return Option.none();
+        // Parse YAML frontmatter
+        const parsed = yield* Effect.try({
+            try: () => YAML.parse(frontmatter),
+            catch: () => ({ _tag: "YamlParseError" }),
+        }).pipe(Effect.option);
+        if (Option.isNone(parsed)) {
+            yield* Effect.logWarning(`Malformed YAML frontmatter in ${pkg.purl.name} model card, skipping`);
+            return Option.none();
+        }
+        // Extract axm metadata
+        const containerResult = decodeModelCardAxm(parsed.value);
+        if (Result.isFailure(containerResult))
+            return Option.none();
+        const axmRaw = containerResult.success.axm;
+        if (axmRaw === undefined)
+            return Option.none();
+        const metaResult = decodeAxmMeta(axmRaw);
+        if (Result.isFailure(metaResult)) {
+            yield* Effect.logWarning(`Invalid axm metadata in ${pkg.purl.name}: schema validation failed`);
+            return Option.none();
+        }
+        return Option.some(metaResult.success.recommendedExtensions);
+    }, Effect.annotateLogs({ reader: "huggingface" }), Effect.withSpan("read.huggingface")),
+};
+//# sourceMappingURL=huggingface.js.map

package/dist/src/unstable/packaging/huggingface.js.map

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

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

@@ -0,0 +1,54 @@
+/**
+ * Packaging schemas for purl-based package identification.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { PackageTypeSchema, type PackageType } from "./package-type.js";
+export { formatPackageDisplay, PackageUrlPartsSchema, PackageUrlSchema, type PackageUrlParts, } from "./package-url.js";
+export type { DetectedPackage, PackageDetector, PackageReader } from "./types.js";
+export { detectPackages } from "./detect.js";
+export { readLocalRecommendations } from "./read.js";
+export { purlIdentityMatch, purlMatch } from "./purl-match.js";
+export { AxmPackageMetaSchema, type AxmPackageMeta } from "./axm-package-meta.js";
+import { npmDetector, npmReader } from "./npm.js";
+import { golangDetector, golangReader } from "./golang.js";
+import { pypiDetector, pypiReader } from "./pypi.js";
+import { cargoDetector, cargoReader } from "./cargo.js";
+import { gemDetector, gemReader } from "./gem.js";
+import { mavenDetector, mavenReader } from "./maven.js";
+import { nugetDetector, nugetReader } from "./nuget.js";
+import { composerDetector, composerReader } from "./composer.js";
+import { swiftDetector, swiftReader } from "./swift.js";
+import { hexDetector, hexReader } from "./hex.js";
+import { pubDetector, pubReader } from "./pub.js";
+import { dockerDetector, dockerReader } from "./docker.js";
+import { cocoapodsDetector, cocoapodsReader } from "./cocoapods.js";
+import { condaDetector, condaReader } from "./conda.js";
+import { conanDetector, conanReader } from "./conan.js";
+import { cranDetector, cranReader } from "./cran.js";
+import { huggingfaceReader } from "./huggingface.js";
+import { cpanDetector, cpanReader } from "./cpan.js";
+import { hackageDetector, hackageReader } from "./hackage.js";
+import { juliaDetector, juliaReader } from "./julia.js";
+import { luarocksDetector, luarocksReader } from "./luarocks.js";
+import { opamDetector, opamReader } from "./opam.js";
+import { bazelDetector, bazelReader } from "./bazel.js";
+import { zigDetector, zigReader } from "./zig.js";
+import { jsrDetector, denoReader } from "./jsr.js";
+import { mojoDetector, mojoReader } from "./mojo.js";
+import type { PackageDetector, PackageReader } from "./types.js";
+export { npmDetector, npmReader, golangDetector, golangReader, pypiDetector, pypiReader, cargoDetector, cargoReader, gemDetector, gemReader, mavenDetector, mavenReader, nugetDetector, nugetReader, composerDetector, composerReader, swiftDetector, swiftReader, hexDetector, hexReader, pubDetector, pubReader, dockerDetector, dockerReader, cocoapodsDetector, cocoapodsReader, condaDetector, condaReader, conanDetector, conanReader, cranDetector, cranReader, huggingfaceReader, cpanDetector, cpanReader, hackageDetector, hackageReader, juliaDetector, juliaReader, luarocksDetector, luarocksReader, opamDetector, opamReader, bazelDetector, bazelReader, zigDetector, zigReader, jsrDetector, denoReader, mojoDetector, mojoReader, };
+/**
+ * All registered package detectors.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const packageDetectors: ReadonlyArray<PackageDetector>;
+/**
+ * All registered package readers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const packageReaders: ReadonlyArray<PackageReader>;
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,130 @@
+/**
+ * Packaging schemas for purl-based package identification.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { PackageTypeSchema } from "./package-type.js";
+export { formatPackageDisplay, PackageUrlPartsSchema, PackageUrlSchema, } from "./package-url.js";
+export { detectPackages } from "./detect.js";
+export { readLocalRecommendations } from "./read.js";
+export { purlIdentityMatch, purlMatch } from "./purl-match.js";
+export { AxmPackageMetaSchema } from "./axm-package-meta.js";
+// Tier 1
+import { npmDetector, npmReader } from "./npm.js";
+import { golangDetector, golangReader } from "./golang.js";
+import { pypiDetector, pypiReader } from "./pypi.js";
+// Tier 2
+import { cargoDetector, cargoReader } from "./cargo.js";
+import { gemDetector, gemReader } from "./gem.js";
+import { mavenDetector, mavenReader } from "./maven.js";
+import { nugetDetector, nugetReader } from "./nuget.js";
+// Tier 3
+import { composerDetector, composerReader } from "./composer.js";
+import { swiftDetector, swiftReader } from "./swift.js";
+import { hexDetector, hexReader } from "./hex.js";
+import { pubDetector, pubReader } from "./pub.js";
+import { dockerDetector, dockerReader } from "./docker.js";
+import { cocoapodsDetector, cocoapodsReader } from "./cocoapods.js";
+import { condaDetector, condaReader } from "./conda.js";
+// Tier 4
+import { conanDetector, conanReader } from "./conan.js";
+import { cranDetector, cranReader } from "./cran.js";
+import { huggingfaceReader } from "./huggingface.js";
+import { cpanDetector, cpanReader } from "./cpan.js";
+import { hackageDetector, hackageReader } from "./hackage.js";
+import { juliaDetector, juliaReader } from "./julia.js";
+import { luarocksDetector, luarocksReader } from "./luarocks.js";
+import { opamDetector, opamReader } from "./opam.js";
+import { bazelDetector, bazelReader } from "./bazel.js";
+// Tier 5
+import { zigDetector, zigReader } from "./zig.js";
+import { jsrDetector, denoReader } from "./jsr.js";
+import { mojoDetector, mojoReader } from "./mojo.js";
+export { 
+// Tier 1
+npmDetector, npmReader, golangDetector, golangReader, pypiDetector, pypiReader, 
+// Tier 2
+cargoDetector, cargoReader, gemDetector, gemReader, mavenDetector, mavenReader, nugetDetector, nugetReader, 
+// Tier 3
+composerDetector, composerReader, swiftDetector, swiftReader, hexDetector, hexReader, pubDetector, pubReader, dockerDetector, dockerReader, cocoapodsDetector, cocoapodsReader, condaDetector, condaReader, 
+// Tier 4
+conanDetector, conanReader, cranDetector, cranReader, huggingfaceReader, cpanDetector, cpanReader, hackageDetector, hackageReader, juliaDetector, juliaReader, luarocksDetector, luarocksReader, opamDetector, opamReader, bazelDetector, bazelReader, 
+// Tier 5
+zigDetector, zigReader, jsrDetector, denoReader, mojoDetector, mojoReader, };
+/**
+ * All registered package detectors.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const packageDetectors = [
+    // Tier 1
+    npmDetector,
+    golangDetector,
+    pypiDetector,
+    // Tier 2
+    cargoDetector,
+    gemDetector,
+    mavenDetector,
+    nugetDetector,
+    // Tier 3
+    composerDetector,
+    swiftDetector,
+    hexDetector,
+    pubDetector,
+    dockerDetector,
+    cocoapodsDetector,
+    condaDetector,
+    // Tier 4
+    conanDetector,
+    cranDetector,
+    cpanDetector,
+    hackageDetector,
+    juliaDetector,
+    luarocksDetector,
+    opamDetector,
+    bazelDetector,
+    // Tier 5
+    zigDetector,
+    jsrDetector,
+    mojoDetector,
+];
+/**
+ * All registered package readers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const packageReaders = [
+    // Tier 1
+    npmReader,
+    golangReader,
+    pypiReader,
+    // Tier 2
+    cargoReader,
+    gemReader,
+    mavenReader,
+    nugetReader,
+    // Tier 3
+    composerReader,
+    swiftReader,
+    hexReader,
+    pubReader,
+    dockerReader,
+    cocoapodsReader,
+    condaReader,
+    // Tier 4
+    conanReader,
+    cranReader,
+    huggingfaceReader,
+    cpanReader,
+    hackageReader,
+    juliaReader,
+    luarocksReader,
+    opamReader,
+    bazelReader,
+    // Tier 5
+    zigReader,
+    denoReader,
+    mojoReader,
+];
+//# sourceMappingURL=index.js.map

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

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

package/dist/src/unstable/packaging/jsr.d.ts

@@ -0,0 +1,30 @@
+/**
+ * JSR package detector and Deno reader for package-compatibility discovery.
+ *
+ * Parses `deno.json`/`deno.jsonc` for `jsr:@scope/name` imports and reads
+ * axm metadata from Deno's module cache.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { PackageDetector, PackageReader } from "./types.js";
+/**
+ * JSR package detector.
+ *
+ * Scans `deno.json` and `deno.jsonc` in the project directory and extracts
+ * `jsr:@scope/name` imports, producing `pkg:generic/jsr/<scope>/<name>` purls.
+ * npm-prefixed imports are skipped.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const jsrDetector: PackageDetector;
+/**
+ * Deno package reader.
+ *
+ * Reads axm metadata from cached module metadata in Deno's module cache.
+ * Checks for an `"axm"` field in cached `deno.json` files.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const denoReader: PackageReader;
+//# sourceMappingURL=jsr.d.ts.map

package/dist/src/unstable/packaging/jsr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsr.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/jsr.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,OAAO,KAAK,EAAmB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgJlF;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,EAAE,eAuCzB,CAAC;AAwBF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,aAwExB,CAAC"}