@agntn/registries 0.3.0 → 0.3.1

package/dist/ai.d.mts

@@ -1,7 +1,7 @@
-import { i as Package, l as Version, n as Dependency, r as Maintainer } from "./_chunks/types.mjs";
-import "./_chunks/registry.mjs";
-import "./types.mjs";
+import { d as Package, g as Version, l as Dependency, u as Maintainer } from "./_chunks/registry.mjs";
 import "./_chunks/index.mjs";
+import "./_chunks/index2.mjs";
+import "./_chunks/index3.mjs";
 import * as ai from "ai";
 
 //#region src/ai.d.ts
@@ -21,7 +21,7 @@ declare const packageTool: ai.Tool<{
   operation: "bulk-packages";
   purls: string[];
   concurrency?: number | undefined;
-}, Package | Version[] | Dependency[] | Maintainer[] | {
+}, Version[] | Dependency[] | Maintainer[] | Package | {
   [k: string]: Package;
 }>;
 //#endregion

package/dist/ai.mjs

@@ -1,5 +1,4 @@
 import "./_chunks/registry.mjs";
-import "./_chunks/purl.mjs";
 import "./_chunks/registries.mjs";
 import { a as fetchVersionsFromPURL, i as fetchPackageFromPURL, n as fetchDependenciesFromPURL, r as fetchMaintainersFromPURL, t as bulkFetchPackages } from "./_chunks/helpers.mjs";
 import { tool } from "ai";

package/dist/ai.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai.mjs","names":[],"sources":["../src/ai.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport {\n  bulkFetchPackages,\n  fetchDependenciesFromPURL,\n  fetchMaintainersFromPURL,\n  fetchPackageFromPURL,\n  fetchVersionsFromPURL,\n} from \"./helpers.ts\";\nimport \"./registries/index.ts\";\n\nexport const packageTool = tool({\n  description:\n    \"Query package metadata from npm, PyPI, crates.io, RubyGems, Packagist, and Arch Linux using PURLs. Supports package info, versions, dependencies, maintainers, and bulk package metadata lookups.\",\n  inputSchema: z.discriminatedUnion(\"operation\", [\n    z.object({\n      operation: z.literal(\"package\"),\n      purl: z.string().describe(\"Package PURL, for example pkg:npm/lodash or pkg:cargo/serde\"),\n    }),\n    z.object({\n      operation: z.literal(\"versions\"),\n      purl: z.string().describe(\"Package PURL, for example pkg:npm/lodash or pkg:cargo/serde\"),\n    }),\n    z.object({\n      operation: z.literal(\"dependencies\"),\n      purl: z\n        .string()\n        .describe(\"Package PURL including a version, for example pkg:pypi/flask@3.1.1\"),\n    }),\n    z.object({\n      operation: z.literal(\"maintainers\"),\n      purl: z\n        .string()\n        .describe(\"Package PURL, for example pkg:gem/rails or pkg:composer/laravel/framework\"),\n    }),\n    z.object({\n      operation: z.literal(\"bulk-packages\"),\n      purls: z.array(z.string()).min(1).max(50).describe(\"List of package PURLs to fetch in bulk.\"),\n      concurrency: z\n        .number()\n        .int()\n        .min(1)\n        .max(50)\n        .optional()\n        .describe(\"Maximum concurrent lookups. Defaults to 15.\"),\n    }),\n  ]),\n  execute: async (input, { abortSignal }) => {\n    switch (input.operation) {\n      case \"package\":\n        return fetchPackageFromPURL(input.purl, abortSignal);\n      case \"versions\":\n        return fetchVersionsFromPURL(input.purl, abortSignal);\n      case \"dependencies\":\n        return fetchDependenciesFromPURL(input.purl, abortSignal);\n      case \"maintainers\":\n        return fetchMaintainersFromPURL(input.purl, abortSignal);\n      case \"bulk-packages\": {\n        const results = await bulkFetchPackages(input.purls, {\n          concurrency: input.concurrency,\n          signal: abortSignal,\n        });\n        return Object.fromEntries(results);\n      }\n    }\n  },\n});\n"],"mappings":";;;;;;AAWA,MAAa,cAAc,KAAK;CAC9B,aACE;CACF,aAAa,EAAE,mBAAmB,aAAa;EAC7C,EAAE,OAAO;GACP,WAAW,EAAE,QAAQ,UAAU;GAC/B,MAAM,EAAE,QAAQ,CAAC,SAAS,8DAAA;GAC3B,CAAC;EACF,EAAE,OAAO;GACP,WAAW,EAAE,QAAQ,WAAW;GAChC,MAAM,EAAE,QAAQ,CAAC,SAAS,8DAAA;GAC3B,CAAC;EACF,EAAE,OAAO;GACP,WAAW,EAAE,QAAQ,eAAe;GACpC,MAAM,EACH,QAAQ,CACR,SAAS,qEAAA;GACb,CAAC;EACF,EAAE,OAAO;GACP,WAAW,EAAE,QAAQ,cAAc;GACnC,MAAM,EACH,QAAQ,CACR,SAAS,4EAAA;GACb,CAAC;EACF,EAAE,OAAO;GACP,WAAW,EAAE,QAAQ,gBAAgB;GACrC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,0CAA0C;GAC7F,aAAa,EACV,QAAQ,CACR,KAAK,CACL,IAAI,EAAE,CACN,IAAI,GAAG,CACP,UAAU,CACV,SAAS,8CAAA;GACb,CAAA;EACF,CAAC;CACF,SAAS,OAAO,OAAO,EAAE,kBAAkB;AACzC,UAAQ,MAAM,WAAd;GACE,KAAK,UACH,QAAO,qBAAqB,MAAM,MAAM,YAAY;GACtD,KAAK,WACH,QAAO,sBAAsB,MAAM,MAAM,YAAY;GACvD,KAAK,eACH,QAAO,0BAA0B,MAAM,MAAM,YAAY;GAC3D,KAAK,cACH,QAAO,yBAAyB,MAAM,MAAM,YAAY;GAC1D,KAAK,iBAAiB;IACpB,MAAM,UAAU,MAAM,kBAAkB,MAAM,OAAO;KACnD,aAAa,MAAM;KACnB,QAAQ;KACT,CAAC;AACF,WAAO,OAAO,YAAY,QAAQ;;;;CAIzC,CAAC"}
+{"version":3,"file":"ai.mjs","names":[],"sources":["../src/ai.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport {\n  bulkFetchPackages,\n  fetchDependenciesFromPURL,\n  fetchMaintainersFromPURL,\n  fetchPackageFromPURL,\n  fetchVersionsFromPURL,\n} from \"./helpers.ts\";\nimport \"./registries/index.ts\";\n\nexport const packageTool = tool({\n  description:\n    \"Query package metadata from npm, PyPI, crates.io, RubyGems, Packagist, and Arch Linux using PURLs. Supports package info, versions, dependencies, maintainers, and bulk package metadata lookups.\",\n  inputSchema: z.discriminatedUnion(\"operation\", [\n    z.object({\n      operation: z.literal(\"package\"),\n      purl: z.string().describe(\"Package PURL, for example pkg:npm/lodash or pkg:cargo/serde\"),\n    }),\n    z.object({\n      operation: z.literal(\"versions\"),\n      purl: z.string().describe(\"Package PURL, for example pkg:npm/lodash or pkg:cargo/serde\"),\n    }),\n    z.object({\n      operation: z.literal(\"dependencies\"),\n      purl: z\n        .string()\n        .describe(\"Package PURL including a version, for example pkg:pypi/flask@3.1.1\"),\n    }),\n    z.object({\n      operation: z.literal(\"maintainers\"),\n      purl: z\n        .string()\n        .describe(\"Package PURL, for example pkg:gem/rails or pkg:composer/laravel/framework\"),\n    }),\n    z.object({\n      operation: z.literal(\"bulk-packages\"),\n      purls: z.array(z.string()).min(1).max(50).describe(\"List of package PURLs to fetch in bulk.\"),\n      concurrency: z\n        .number()\n        .int()\n        .min(1)\n        .max(50)\n        .optional()\n        .describe(\"Maximum concurrent lookups. Defaults to 15.\"),\n    }),\n  ]),\n  execute: async (input, { abortSignal }) => {\n    switch (input.operation) {\n      case \"package\":\n        return fetchPackageFromPURL(input.purl, abortSignal);\n      case \"versions\":\n        return fetchVersionsFromPURL(input.purl, abortSignal);\n      case \"dependencies\":\n        return fetchDependenciesFromPURL(input.purl, abortSignal);\n      case \"maintainers\":\n        return fetchMaintainersFromPURL(input.purl, abortSignal);\n      case \"bulk-packages\": {\n        const results = await bulkFetchPackages(input.purls, {\n          concurrency: input.concurrency,\n          signal: abortSignal,\n        });\n        return Object.fromEntries(results);\n      }\n    }\n  },\n});\n"],"mappings":";;;;;AAWA,MAAa,cAAc,KAAK;CAC9B,aACE;CACF,aAAa,EAAE,mBAAmB,aAAa;EAC7C,EAAE,OAAO;GACP,WAAW,EAAE,QAAQ,UAAU;GAC/B,MAAM,EAAE,QAAQ,CAAC,SAAS,8DAAA;GAC3B,CAAC;EACF,EAAE,OAAO;GACP,WAAW,EAAE,QAAQ,WAAW;GAChC,MAAM,EAAE,QAAQ,CAAC,SAAS,8DAAA;GAC3B,CAAC;EACF,EAAE,OAAO;GACP,WAAW,EAAE,QAAQ,eAAe;GACpC,MAAM,EACH,QAAQ,CACR,SAAS,qEAAA;GACb,CAAC;EACF,EAAE,OAAO;GACP,WAAW,EAAE,QAAQ,cAAc;GACnC,MAAM,EACH,QAAQ,CACR,SAAS,4EAAA;GACb,CAAC;EACF,EAAE,OAAO;GACP,WAAW,EAAE,QAAQ,gBAAgB;GACrC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,0CAA0C;GAC7F,aAAa,EACV,QAAQ,CACR,KAAK,CACL,IAAI,EAAE,CACN,IAAI,GAAG,CACP,UAAU,CACV,SAAS,8CAAA;GACb,CAAA;EACF,CAAC;CACF,SAAS,OAAO,OAAO,EAAE,kBAAkB;AACzC,UAAQ,MAAM,WAAd;GACE,KAAK,UACH,QAAO,qBAAqB,MAAM,MAAM,YAAY;GACtD,KAAK,WACH,QAAO,sBAAsB,MAAM,MAAM,YAAY;GACvD,KAAK,eACH,QAAO,0BAA0B,MAAM,MAAM,YAAY;GAC3D,KAAK,cACH,QAAO,yBAAyB,MAAM,MAAM,YAAY;GAC1D,KAAK,iBAAiB;IACpB,MAAM,UAAU,MAAM,kBAAkB,MAAM,OAAO;KACnD,aAAa,MAAM;KACnB,QAAQ;KACT,CAAC;AACF,WAAO,OAAO,YAAY,QAAQ;;;;CAIzC,CAAC"}

package/dist/cache/index.d.mts

@@ -1,23 +1,3 @@
-import "../_chunks/types.mjs";
-import { o as Client, t as Registry } from "../_chunks/registry.mjs";
-import { CachedRegistry } from "./cached-registry.mjs";
-import { getCacheDir } from "./paths.mjs";
-import { clearStorage, computeIntegrity, configureStorage, disposeStorage, getEcosystemStorage, getStorage } from "./storage.mjs";
-import { DEFAULT_TTL, EntryType, Lockfile, LockfileEntry, cacheKey, getFreshEntry, isFresh, pruneStale, readLockfile, removeEntry, setEntry, writeLockfile } from "./lockfile.mjs";
-import { Storage } from "unstorage";
-
-//#region src/cache/index.d.ts
-/** Options for creating a cached registry. */
-interface CreateCachedOptions {
-  /** Custom base URL for the registry API. */
-  baseURL?: string;
-  /** Custom HTTP client. */
-  client?: Client;
-  /** Custom unstorage instance. Overrides the globally configured storage. */
-  storage?: Storage;
-}
-/** Create a registry instance with caching + lockfile tracking. */
-declare function createCached(ecosystem: string, options?: CreateCachedOptions): Registry;
-//#endregion
-export { CachedRegistry, CreateCachedOptions, DEFAULT_TTL, type EntryType, type Lockfile, type LockfileEntry, cacheKey, clearStorage, computeIntegrity, configureStorage, createCached, disposeStorage, getCacheDir, getEcosystemStorage, getFreshEntry, getStorage, isFresh, pruneStale, readLockfile, removeEntry, setEntry, writeLockfile };
-//# sourceMappingURL=index.d.mts.map
+import "../_chunks/registry.mjs";
+import { S as getCacheDir, _ as computeIntegrity, a as Lockfile, b as getEcosystemStorage, c as getFreshEntry, d as readLockfile, f as removeEntry, g as clearStorage, h as CachedRegistry, i as EntryType, l as isFresh, m as writeLockfile, n as createCached, o as LockfileEntry, p as setEntry, r as DEFAULT_TTL, s as cacheKey, t as CreateCachedOptions, u as pruneStale, v as configureStorage, x as getStorage, y as disposeStorage } from "../_chunks/index3.mjs";
+export { CachedRegistry, CreateCachedOptions, DEFAULT_TTL, EntryType, Lockfile, LockfileEntry, cacheKey, clearStorage, computeIntegrity, configureStorage, createCached, disposeStorage, getCacheDir, getEcosystemStorage, getFreshEntry, getStorage, isFresh, pruneStale, readLockfile, removeEntry, setEntry, writeLockfile };

package/dist/cache/index.mjs

@@ -1,12 +1,5 @@
-import { n as create } from "../_chunks/registry.mjs";
-import { getCacheDir } from "./paths.mjs";
-import { clearStorage, computeIntegrity, configureStorage, disposeStorage, getEcosystemStorage, getStorage } from "./storage.mjs";
-import { DEFAULT_TTL, cacheKey, getFreshEntry, isFresh, pruneStale, readLockfile, removeEntry, setEntry, writeLockfile } from "./lockfile.mjs";
-import { CachedRegistry } from "./cached-registry.mjs";
-/** Create a registry instance with caching + lockfile tracking. */
-function createCached(ecosystem, options) {
-	return new CachedRegistry(create(ecosystem, options?.baseURL, options?.client), options?.storage);
-}
+import "../_chunks/registry.mjs";
+import { a as pruneStale, c as setEntry, d as computeIntegrity, f as configureStorage, g as getCacheDir, h as getStorage, i as isFresh, l as writeLockfile, m as getEcosystemStorage, n as cacheKey, o as readLockfile, p as disposeStorage, r as getFreshEntry, s as removeEntry, t as DEFAULT_TTL, u as clearStorage } from "../_chunks/lockfile.mjs";
+import { t as CachedRegistry } from "../_chunks/cached-registry.mjs";
+import { t as createCached } from "../_chunks/cache.mjs";
 export { CachedRegistry, DEFAULT_TTL, cacheKey, clearStorage, computeIntegrity, configureStorage, createCached, disposeStorage, getCacheDir, getEcosystemStorage, getFreshEntry, getStorage, isFresh, pruneStale, readLockfile, removeEntry, setEntry, writeLockfile };
-
-//# sourceMappingURL=index.mjs.map

package/dist/cli.mjs

@@ -1,17 +1,19 @@
 #!/usr/bin/env node
+import { t as version } from "./_chunks/version.mjs";
 import { defineCommand, runMain } from "citty";
-runMain(defineCommand({
+await runMain(defineCommand({
 	meta: {
 		name: "registries",
-		version: "0.1.0",
+		version,
 		description: "Universal package registry client — query npm, PyPI, crates.io, RubyGems, Packagist with a single PURL-native API."
 	},
 	subCommands: {
-		info: () => import("./commands/info.mjs").then((m) => m.default),
-		versions: () => import("./commands/versions.mjs").then((m) => m.default),
-		deps: () => import("./commands/deps.mjs").then((m) => m.default),
-		maintainers: () => import("./commands/maintainers.mjs").then((m) => m.default),
-		cache: () => import("./commands/cache.mjs").then((m) => m.default)
+		info: () => import("./_chunks/info.mjs").then((m) => m.default),
+		versions: () => import("./_chunks/versions.mjs").then((m) => m.default),
+		deps: () => import("./_chunks/deps.mjs").then((m) => m.default),
+		maintainers: () => import("./_chunks/maintainers.mjs").then((m) => m.default),
+		cache: () => import("./_chunks/cache2.mjs").then((m) => m.default),
+		mcp: () => import("./_chunks/mcp.mjs").then((m) => m.default)
 	}
 }));
 export {};

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { defineCommand, runMain } from \"citty\";\n\nconst main = defineCommand({\n  meta: {\n    name: \"registries\",\n    version: \"0.1.0\",\n    description:\n      \"Universal package registry client — query npm, PyPI, crates.io, RubyGems, Packagist with a single PURL-native API.\",\n  },\n  subCommands: {\n    info: () => import(\"./commands/info.ts\").then((m) => m.default),\n    versions: () => import(\"./commands/versions.ts\").then((m) => m.default),\n    deps: () => import(\"./commands/deps.ts\").then((m) => m.default),\n    maintainers: () => import(\"./commands/maintainers.ts\").then((m) => m.default),\n    cache: () => import(\"./commands/cache.ts\").then((m) => m.default),\n  },\n});\n\nrunMain(main);\n"],"mappings":";;AAmBA,QAhBa,cAAc;CACzB,MAAM;EACJ,MAAM;EACN,SAAS;EACT,aACE;EACH;CACD,aAAa;EACX,YAAY,OAAO,uBAAsB,MAAM,MAAM,EAAE,QAAQ;EAC/D,gBAAgB,OAAO,2BAA0B,MAAM,MAAM,EAAE,QAAQ;EACvE,YAAY,OAAO,uBAAsB,MAAM,MAAM,EAAE,QAAQ;EAC/D,mBAAmB,OAAO,8BAA6B,MAAM,MAAM,EAAE,QAAQ;EAC7E,aAAa,OAAO,wBAAuB,MAAM,MAAM,EAAE,QAAA;;CAE5D,CAAC,CAEW"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { defineCommand, runMain } from \"citty\";\nimport { version } from \"./version.ts\";\n\nconst main = defineCommand({\n  meta: {\n    name: \"registries\",\n    version,\n    description:\n      \"Universal package registry client — query npm, PyPI, crates.io, RubyGems, Packagist with a single PURL-native API.\",\n  },\n  subCommands: {\n    info: () => import(\"./commands/info.ts\").then((m) => m.default),\n    versions: () => import(\"./commands/versions.ts\").then((m) => m.default),\n    deps: () => import(\"./commands/deps.ts\").then((m) => m.default),\n    maintainers: () => import(\"./commands/maintainers.ts\").then((m) => m.default),\n    cache: () => import(\"./commands/cache.ts\").then((m) => m.default),\n    mcp: () => import(\"./commands/mcp.ts\").then((m) => m.default),\n  },\n});\n\nawait runMain(main);\n"],"mappings":";;;AAqBA,MAAM,QAjBO,cAAc;CACzB,MAAM;EACJ,MAAM;EACN;EACA,aACE;EACH;CACD,aAAa;EACX,YAAY,OAAO,sBAAsB,MAAM,MAAM,EAAE,QAAQ;EAC/D,gBAAgB,OAAO,0BAA0B,MAAM,MAAM,EAAE,QAAQ;EACvE,YAAY,OAAO,sBAAsB,MAAM,MAAM,EAAE,QAAQ;EAC/D,mBAAmB,OAAO,6BAA6B,MAAM,MAAM,EAAE,QAAQ;EAC7E,aAAa,OAAO,wBAAuB,MAAM,MAAM,EAAE,QAAQ;EACjE,WAAW,OAAO,qBAAqB,MAAM,MAAM,EAAE,QAAA;;CAExD,CAAC,CAEiB"}

package/dist/index.d.mts

@@ -1,57 +1,5 @@
-import { a as ParsedPURL, c as URLBuilder, i as Package, l as Version, n as Dependency, o as RateLimiter, r as Maintainer, s as Scope, t as ClientOptions, u as VersionStatus } from "./_chunks/types.mjs";
-import { a as register, i as has, n as create, o as Client, r as ecosystems, s as defaultClient, t as Registry } from "./_chunks/registry.mjs";
+import { _ as VersionStatus, a as register, c as ClientOptions, d as Package, f as ParsedPURL, g as Version, h as URLBuilder, i as has, l as Dependency, m as Scope, n as create, o as Client, p as RateLimiter, r as ecosystems, s as defaultClient, t as Registry, u as Maintainer } from "./_chunks/registry.mjs";
 import { a as CargoRegistry, i as PyPIRegistry, n as PackagistRegistry, o as NpmRegistry, r as RubyGemsRegistry, t as AlpmRegistry } from "./_chunks/index.mjs";
-import { CachedRegistry } from "./cache/cached-registry.mjs";
-import { getCacheDir } from "./cache/paths.mjs";
-import { clearStorage, computeIntegrity, configureStorage, disposeStorage, getEcosystemStorage, getStorage } from "./cache/storage.mjs";
-import { DEFAULT_TTL, EntryType, Lockfile, LockfileEntry, cacheKey, getFreshEntry, isFresh, pruneStale, readLockfile, removeEntry, setEntry, writeLockfile } from "./cache/lockfile.mjs";
-import { CreateCachedOptions, createCached } from "./cache/index.mjs";
-import { a as RateLimitError, c as combineLicenses, d as createFromPURL, f as fullName, i as PkioError, l as normalizeLicense, n as InvalidPURLError, o as UnknownEcosystemError, p as parsePURL, r as NotFoundError, s as normalizeRepositoryURL, t as HTTPError, u as buildPURL } from "./_chunks/errors.mjs";
-
-//#region src/helpers.d.ts
-/** Fetch normalized package metadata from a PURL. */
-declare function fetchPackageFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Package>;
-/** Fetch all versions from a PURL. */
-declare function fetchVersionsFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Version[]>;
-/** Fetch dependencies for a specific version from a PURL. */
-declare function fetchDependenciesFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Dependency[]>;
-/** Fetch maintainers from a PURL. */
-declare function fetchMaintainersFromPURL(purl: string, signal?: AbortSignal, client?: Client): Promise<Maintainer[]>;
-/** Bulk fetch packages from multiple PURLs, with concurrency limit. */
-declare function bulkFetchPackages(purls: string[], options?: {
-  concurrency?: number;
-  signal?: AbortSignal;
-  client?: Client;
-}): Promise<Map<string, Package>>;
-/**
- * Select the best matching version from a list.
- *
- * Resolution order:
- * 1. Exact match for `requested` (non-yanked/deprecated/retracted)
- * 2. Exact match for `latest` (non-yanked/deprecated/retracted)
- * 3. Newest available version with no negative status (by publishedAt)
- *
- * Returns `null` when no usable version exists.
- */
-declare function selectVersion(versions: Version[], options?: {
-  requested?: string;
-  latest?: string;
-}): Version | null;
-/**
- * Resolve the best documentation URL for a package.
- *
- * Fallback chain:
- * 1. `package.documentation` (explicit docs URL from registry)
- * 2. `package.homepage` (project homepage)
- * 3. `urls.documentation()` (ecosystem default, e.g. docs.rs, rubydoc.info)
- */
-declare function resolveDocsUrl(pkg: Package, urls: URLBuilder, version?: string): string;
-/**
- * Resolve the best README URL for a package.
- *
- * Returns the ecosystem-specific URL where the package README can be fetched.
- */
-declare function resolveReadmeUrl(pkg: Package, urls: URLBuilder, version?: string): string;
-//#endregion
-export { AlpmRegistry, CachedRegistry, CargoRegistry, Client, type ClientOptions, type CreateCachedOptions, DEFAULT_TTL, type Dependency, type EntryType, HTTPError, InvalidPURLError, type Lockfile, type LockfileEntry, type Maintainer, NotFoundError, NpmRegistry, type Package, PackagistRegistry, type ParsedPURL, PkioError, PyPIRegistry, RateLimitError, type RateLimiter, Registry, RubyGemsRegistry, type Scope, type URLBuilder, UnknownEcosystemError, type Version, type VersionStatus, buildPURL, bulkFetchPackages, cacheKey, clearStorage, combineLicenses, computeIntegrity, configureStorage, create, createCached, createFromPURL, defaultClient, disposeStorage, ecosystems, fetchDependenciesFromPURL, fetchMaintainersFromPURL, fetchPackageFromPURL, fetchVersionsFromPURL, fullName, getCacheDir, getEcosystemStorage, getFreshEntry, getStorage, has, isFresh, normalizeLicense, normalizeRepositoryURL, parsePURL, pruneStale, readLockfile, register, removeEntry, resolveDocsUrl, resolveReadmeUrl, selectVersion, setEntry, writeLockfile };
-//# sourceMappingURL=index.d.mts.map
+import { _ as normalizeLicense, a as fetchVersionsFromPURL, b as fullName, c as selectVersion, d as NotFoundError, f as PkioError, g as combineLicenses, h as normalizeRepositoryURL, i as fetchPackageFromPURL, l as HTTPError, m as UnknownEcosystemError, n as fetchDependenciesFromPURL, o as resolveDocsUrl, p as RateLimitError, r as fetchMaintainersFromPURL, s as resolveReadmeUrl, t as bulkFetchPackages, u as InvalidPURLError, v as buildPURL, x as parsePURL, y as createFromPURL } from "./_chunks/index2.mjs";
+import { S as getCacheDir, _ as computeIntegrity, a as Lockfile, b as getEcosystemStorage, c as getFreshEntry, d as readLockfile, f as removeEntry, g as clearStorage, h as CachedRegistry, i as EntryType, l as isFresh, m as writeLockfile, n as createCached, o as LockfileEntry, p as setEntry, r as DEFAULT_TTL, s as cacheKey, t as CreateCachedOptions, u as pruneStale, v as configureStorage, x as getStorage, y as disposeStorage } from "./_chunks/index3.mjs";
+export { AlpmRegistry, CachedRegistry, CargoRegistry, Client, ClientOptions, CreateCachedOptions, DEFAULT_TTL, Dependency, EntryType, HTTPError, InvalidPURLError, Lockfile, LockfileEntry, Maintainer, NotFoundError, NpmRegistry, Package, PackagistRegistry, ParsedPURL, PkioError, PyPIRegistry, RateLimitError, RateLimiter, Registry, RubyGemsRegistry, Scope, URLBuilder, UnknownEcosystemError, Version, VersionStatus, buildPURL, bulkFetchPackages, cacheKey, clearStorage, combineLicenses, computeIntegrity, configureStorage, create, createCached, createFromPURL, defaultClient, disposeStorage, ecosystems, fetchDependenciesFromPURL, fetchMaintainersFromPURL, fetchPackageFromPURL, fetchVersionsFromPURL, fullName, getCacheDir, getEcosystemStorage, getFreshEntry, getStorage, has, isFresh, normalizeLicense, normalizeRepositoryURL, parsePURL, pruneStale, readLockfile, register, removeEntry, resolveDocsUrl, resolveReadmeUrl, selectVersion, setEntry, writeLockfile };

package/dist/index.mjs

@@ -1,10 +1,7 @@
 import { a as register, c as HTTPError, d as PkioError, f as RateLimitError, i as has, l as InvalidPURLError, n as create, o as Client, p as UnknownEcosystemError, r as ecosystems, s as defaultClient, t as Registry, u as NotFoundError } from "./_chunks/registry.mjs";
-import { a as normalizeRepositoryURL, i as parsePURL, n as createFromPURL, o as combineLicenses, r as fullName, s as normalizeLicense, t as buildPURL } from "./_chunks/purl.mjs";
-import { a as CargoRegistry, i as PyPIRegistry, n as PackagistRegistry, o as NpmRegistry, r as RubyGemsRegistry, t as AlpmRegistry } from "./_chunks/registries.mjs";
+import { a as CargoRegistry, c as createFromPURL, d as normalizeRepositoryURL, f as combineLicenses, i as PyPIRegistry, l as fullName, n as PackagistRegistry, o as NpmRegistry, p as normalizeLicense, r as RubyGemsRegistry, s as buildPURL, t as AlpmRegistry, u as parsePURL } from "./_chunks/registries.mjs";
 import { a as fetchVersionsFromPURL, c as selectVersion, i as fetchPackageFromPURL, n as fetchDependenciesFromPURL, o as resolveDocsUrl, r as fetchMaintainersFromPURL, s as resolveReadmeUrl, t as bulkFetchPackages } from "./_chunks/helpers.mjs";
-import { getCacheDir } from "./cache/paths.mjs";
-import { clearStorage, computeIntegrity, configureStorage, disposeStorage, getEcosystemStorage, getStorage } from "./cache/storage.mjs";
-import { DEFAULT_TTL, cacheKey, getFreshEntry, isFresh, pruneStale, readLockfile, removeEntry, setEntry, writeLockfile } from "./cache/lockfile.mjs";
-import { CachedRegistry } from "./cache/cached-registry.mjs";
-import { createCached } from "./cache/index.mjs";
+import { a as pruneStale, c as setEntry, d as computeIntegrity, f as configureStorage, g as getCacheDir, h as getStorage, i as isFresh, l as writeLockfile, m as getEcosystemStorage, n as cacheKey, o as readLockfile, p as disposeStorage, r as getFreshEntry, s as removeEntry, t as DEFAULT_TTL, u as clearStorage } from "./_chunks/lockfile.mjs";
+import { t as CachedRegistry } from "./_chunks/cached-registry.mjs";
+import { t as createCached } from "./_chunks/cache.mjs";
 export { AlpmRegistry, CachedRegistry, CargoRegistry, Client, DEFAULT_TTL, HTTPError, InvalidPURLError, NotFoundError, NpmRegistry, PackagistRegistry, PkioError, PyPIRegistry, RateLimitError, Registry, RubyGemsRegistry, UnknownEcosystemError, buildPURL, bulkFetchPackages, cacheKey, clearStorage, combineLicenses, computeIntegrity, configureStorage, create, createCached, createFromPURL, defaultClient, disposeStorage, ecosystems, fetchDependenciesFromPURL, fetchMaintainersFromPURL, fetchPackageFromPURL, fetchVersionsFromPURL, fullName, getCacheDir, getEcosystemStorage, getFreshEntry, getStorage, has, isFresh, normalizeLicense, normalizeRepositoryURL, parsePURL, pruneStale, readLockfile, register, removeEntry, resolveDocsUrl, resolveReadmeUrl, selectVersion, setEntry, writeLockfile };

package/dist/mcp.d.mts

@@ -0,0 +1,7 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+
+//#region src/mcp.d.ts
+declare function createMcpServer(): Server;
+//#endregion
+export { createMcpServer };
+//# sourceMappingURL=mcp.d.mts.map

package/dist/mcp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.mts","names":[],"sources":["../src/mcp.ts"],"mappings":";;;iBAqJgB,eAAA,CAAA,GAAmB,MAAA"}

package/dist/mcp.mjs

@@ -0,0 +1,155 @@
+import "./_chunks/registry.mjs";
+import "./_chunks/registries.mjs";
+import "./_chunks/helpers.mjs";
+import { t as version } from "./_chunks/version.mjs";
+import { a as _Array_, i as Optional, n as Integer, r as _Object_, t as String$1 } from "./_chunks/libs/typebox.mjs";
+import { a as bulkPackagesOperation, c as maintainersOperation, i as MAX_PURL_LENGTH, l as packageOperation, n as MAX_BULK_CONCURRENCY, o as dependenciesOperation, r as MAX_BULK_PACKAGES, s as ecosystemsOperation, u as versionsOperation } from "./_chunks/tool-operations.mjs";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+const PURL = String$1({
+	minLength: 1,
+	maxLength: MAX_PURL_LENGTH,
+	description: "Package URL, for example pkg:npm/lodash or pkg:pypi/requests@2.32.3"
+});
+const PURLParams = _Object_({ purl: PURL }, { additionalProperties: false });
+const BulkPackagesParams = _Object_({
+	purls: _Array_(PURL, {
+		minItems: 1,
+		maxItems: MAX_BULK_PACKAGES
+	}),
+	concurrency: Optional(Integer({
+		minimum: 1,
+		maximum: MAX_BULK_CONCURRENCY
+	}))
+}, { additionalProperties: false });
+const EmptyParams = _Object_({}, { additionalProperties: false });
+const REMOTE_READ = {
+	readOnlyHint: true,
+	destructiveHint: false,
+	idempotentHint: false,
+	openWorldHint: true
+};
+const LOCAL_READ = {
+	readOnlyHint: true,
+	destructiveHint: false,
+	idempotentHint: true,
+	openWorldHint: false
+};
+function defineTool(tool) {
+	return tool;
+}
+const tools = [
+	defineTool({
+		name: "registries_package",
+		title: "Get package metadata",
+		description: "Fetch normalized metadata for one package URL.",
+		inputSchema: PURLParams,
+		annotations: REMOTE_READ,
+		execute: packageOperation
+	}),
+	defineTool({
+		name: "registries_versions",
+		title: "List package versions",
+		description: "List normalized versions for one package URL.",
+		inputSchema: PURLParams,
+		annotations: REMOTE_READ,
+		execute: versionsOperation
+	}),
+	defineTool({
+		name: "registries_dependencies",
+		title: "List package dependencies",
+		description: "List dependencies for a versioned package URL.",
+		inputSchema: PURLParams,
+		annotations: REMOTE_READ,
+		execute: dependenciesOperation
+	}),
+	defineTool({
+		name: "registries_maintainers",
+		title: "List package maintainers",
+		description: "List normalized maintainers for one package URL.",
+		inputSchema: PURLParams,
+		annotations: REMOTE_READ,
+		execute: maintainersOperation
+	}),
+	defineTool({
+		name: "registries_bulk_packages",
+		title: "Get package metadata in bulk",
+		description: "Fetch normalized package metadata for up to 50 package URLs.",
+		inputSchema: BulkPackagesParams,
+		annotations: REMOTE_READ,
+		execute: bulkPackagesOperation
+	}),
+	defineTool({
+		name: "registries_ecosystems",
+		title: "List registry ecosystems",
+		description: "List package ecosystems registered by this package.",
+		inputSchema: EmptyParams,
+		annotations: LOCAL_READ,
+		execute: ecosystemsOperation
+	})
+];
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+function sanitizeField(value) {
+	return Array.from(value).map((character) => {
+		const code = character.codePointAt(0) ?? 0;
+		return code <= 31 || code >= 127 && code <= 159 ? " " : character;
+	}).join("");
+}
+function errorResult(text) {
+	return {
+		content: [{
+			type: "text",
+			text: sanitizeField(text)
+		}],
+		isError: true
+	};
+}
+function toCallToolResult(result) {
+	return {
+		content: result.content,
+		...result.isError ? { isError: true } : {}
+	};
+}
+/**
+* SAFETY: TypeBox schemas conform to the JSON Schema object accepted by MCP.
+*
+* @param schema - TypeBox schema to expose through MCP.
+* @returns {Tool["inputSchema"]} The same schema under the MCP SDK type.
+*/
+function toMcpSchema(schema) {
+	return schema;
+}
+function createMcpServer() {
+	const toolsByName = new Map(tools.map((tool) => [tool.name, tool]));
+	const server = new Server({
+		name: "registries",
+		version
+	}, { capabilities: { tools: {} } });
+	server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: tools.map((tool) => ({
+		name: tool.name,
+		title: tool.title,
+		description: tool.description,
+		inputSchema: toMcpSchema(tool.inputSchema),
+		annotations: tool.annotations
+	})) }));
+	server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+		const tool = toolsByName.get(request.params.name);
+		if (!tool) return errorResult(`Unknown registries tool: ${request.params.name}`);
+		const args = request.params.arguments ?? {};
+		const { Value } = await import("typebox/value");
+		if (!Value.Check(tool.inputSchema, args)) return errorResult(`Invalid arguments for ${tool.name}`);
+		try {
+			/** SAFETY: Value.Check validated args against the selected tool's schema. */
+			const validatedArgs = args;
+			return toCallToolResult(await tool.execute(validatedArgs, extra.signal));
+		} catch (error) {
+			return errorResult(`${tool.name} failed: ${errorMessage(error)}`);
+		}
+	});
+	return server;
+}
+export { createMcpServer };
+
+//# sourceMappingURL=mcp.mjs.map

package/dist/mcp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.mjs","names":["Type.String","Type.Object","Type.Array","Type.Optional","Type.Integer"],"sources":["../src/mcp.ts"],"sourcesContent":["import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n  type CallToolResult,\n  type Tool,\n  type ToolAnnotations,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { Type, type Static, type TSchema } from \"typebox\";\nimport {\n  bulkPackagesOperation,\n  dependenciesOperation,\n  ecosystemsOperation,\n  maintainersOperation,\n  MAX_BULK_CONCURRENCY,\n  MAX_BULK_PACKAGES,\n  MAX_PURL_LENGTH,\n  packageOperation,\n  type ToolResult,\n  versionsOperation,\n} from \"./tool-operations.ts\";\nimport { version } from \"./version.ts\";\n\nconst PURL = Type.String({\n  minLength: 1,\n  maxLength: MAX_PURL_LENGTH,\n  description: \"Package URL, for example pkg:npm/lodash or pkg:pypi/requests@2.32.3\",\n});\n\nconst PURLParams = Type.Object({ purl: PURL }, { additionalProperties: false });\nconst BulkPackagesParams = Type.Object(\n  {\n    purls: Type.Array(PURL, { minItems: 1, maxItems: MAX_BULK_PACKAGES }),\n    concurrency: Type.Optional(Type.Integer({ minimum: 1, maximum: MAX_BULK_CONCURRENCY })),\n  },\n  { additionalProperties: false },\n);\nconst EmptyParams = Type.Object({}, { additionalProperties: false });\n\nconst REMOTE_READ: ToolAnnotations = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: false,\n  openWorldHint: true,\n};\nconst LOCAL_READ: ToolAnnotations = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: false,\n};\n\ninterface RegistryTool<S extends TSchema> {\n  readonly name: string;\n  readonly title: string;\n  readonly description: string;\n  readonly inputSchema: S;\n  readonly annotations: ToolAnnotations;\n  execute(params: Readonly<Static<S>>, signal?: AbortSignal): Promise<ToolResult<unknown>>;\n}\n\nfunction defineTool<S extends TSchema>(tool: Readonly<RegistryTool<S>>): RegistryTool<S> {\n  return tool;\n}\n\nconst tools = [\n  defineTool({\n    name: \"registries_package\",\n    title: \"Get package metadata\",\n    description: \"Fetch normalized metadata for one package URL.\",\n    inputSchema: PURLParams,\n    annotations: REMOTE_READ,\n    execute: packageOperation,\n  }),\n  defineTool({\n    name: \"registries_versions\",\n    title: \"List package versions\",\n    description: \"List normalized versions for one package URL.\",\n    inputSchema: PURLParams,\n    annotations: REMOTE_READ,\n    execute: versionsOperation,\n  }),\n  defineTool({\n    name: \"registries_dependencies\",\n    title: \"List package dependencies\",\n    description: \"List dependencies for a versioned package URL.\",\n    inputSchema: PURLParams,\n    annotations: REMOTE_READ,\n    execute: dependenciesOperation,\n  }),\n  defineTool({\n    name: \"registries_maintainers\",\n    title: \"List package maintainers\",\n    description: \"List normalized maintainers for one package URL.\",\n    inputSchema: PURLParams,\n    annotations: REMOTE_READ,\n    execute: maintainersOperation,\n  }),\n  defineTool({\n    name: \"registries_bulk_packages\",\n    title: \"Get package metadata in bulk\",\n    description: \"Fetch normalized package metadata for up to 50 package URLs.\",\n    inputSchema: BulkPackagesParams,\n    annotations: REMOTE_READ,\n    execute: bulkPackagesOperation,\n  }),\n  defineTool({\n    name: \"registries_ecosystems\",\n    title: \"List registry ecosystems\",\n    description: \"List package ecosystems registered by this package.\",\n    inputSchema: EmptyParams,\n    annotations: LOCAL_READ,\n    execute: ecosystemsOperation,\n  }),\n] as const;\n\ntype AnyRegistryTool = (typeof tools)[number];\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction sanitizeField(value: string): string {\n  return Array.from(value)\n    .map((character) => {\n      const code = character.codePointAt(0) ?? 0;\n      return code <= 31 || (code >= 127 && code <= 159) ? \" \" : character;\n    })\n    .join(\"\");\n}\n\nfunction errorResult(text: string): CallToolResult {\n  return { content: [{ type: \"text\", text: sanitizeField(text) }], isError: true };\n}\n\nfunction toCallToolResult(result: ToolResult<unknown>): CallToolResult {\n  return { content: result.content, ...(result.isError ? { isError: true } : {}) };\n}\n\n/**\n * SAFETY: TypeBox schemas conform to the JSON Schema object accepted by MCP.\n *\n * @param schema - TypeBox schema to expose through MCP.\n * @returns {Tool[\"inputSchema\"]} The same schema under the MCP SDK type.\n */\nfunction toMcpSchema(schema: TSchema): Tool[\"inputSchema\"] {\n  return schema as unknown as Tool[\"inputSchema\"];\n}\n\nexport function createMcpServer(): Server {\n  const toolsByName = new Map<string, AnyRegistryTool>(tools.map((tool) => [tool.name, tool]));\n  const server = new Server({ name: \"registries\", version }, { capabilities: { tools: {} } });\n\n  server.setRequestHandler(ListToolsRequestSchema, () => ({\n    tools: tools.map((tool): Tool => ({\n      name: tool.name,\n      title: tool.title,\n      description: tool.description,\n      inputSchema: toMcpSchema(tool.inputSchema),\n      annotations: tool.annotations,\n    })),\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {\n    const tool = toolsByName.get(request.params.name);\n    if (!tool) return errorResult(`Unknown registries tool: ${request.params.name}`);\n\n    const args = request.params.arguments ?? {};\n    const { Value } = await import(\"typebox/value\");\n    if (!Value.Check(tool.inputSchema, args)) {\n      return errorResult(`Invalid arguments for ${tool.name}`);\n    }\n\n    try {\n      /** SAFETY: Value.Check validated args against the selected tool's schema. */\n      const validatedArgs = args as never;\n      return toCallToolResult(await tool.execute(validatedArgs, extra.signal));\n    } catch (error) {\n      return errorResult(`${tool.name} failed: ${errorMessage(error)}`);\n    }\n  });\n\n  return server;\n}\n"],"mappings":"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"}

package/dist/registries/index.d.mts

@@ -1,4 +1,3 @@
-import "../_chunks/types.mjs";
 import "../_chunks/registry.mjs";
 import { a as CargoRegistry, i as PyPIRegistry, n as PackagistRegistry, o as NpmRegistry, r as RubyGemsRegistry, t as AlpmRegistry } from "../_chunks/index.mjs";
 export { AlpmRegistry, CargoRegistry, NpmRegistry, PackagistRegistry, PyPIRegistry, RubyGemsRegistry };

package/dist/registries/index.mjs

@@ -1,4 +1,3 @@
 import "../_chunks/registry.mjs";
-import "../_chunks/purl.mjs";
 import { a as CargoRegistry, i as PyPIRegistry, n as PackagistRegistry, o as NpmRegistry, r as RubyGemsRegistry, t as AlpmRegistry } from "../_chunks/registries.mjs";
 export { AlpmRegistry, CargoRegistry, NpmRegistry, PackagistRegistry, PyPIRegistry, RubyGemsRegistry };

package/dist/tool-operations.d.mts

@@ -0,0 +1,36 @@
+import { d as Package, g as Version, l as Dependency, o as Client, u as Maintainer } from "./_chunks/registry.mjs";
+import "./_chunks/index.mjs";
+import "./_chunks/index2.mjs";
+import "./_chunks/index3.mjs";
+
+//#region src/tool-operations.d.ts
+declare const MAX_PURL_LENGTH = 2048;
+declare const MAX_BULK_PACKAGES = 50;
+declare const DEFAULT_BULK_CONCURRENCY = 15;
+declare const MAX_BULK_CONCURRENCY = 50;
+interface ToolResult<T> {
+  content: Array<{
+    type: "text";
+    text: string;
+  }>;
+  details: T;
+  isError?: boolean;
+}
+interface PURLParams {
+  readonly purl: string;
+}
+interface BulkPackagesParams {
+  readonly purls: readonly string[];
+  readonly concurrency?: number;
+}
+declare function packageOperation(params: Readonly<PURLParams>, signal?: AbortSignal, client?: Client): Promise<ToolResult<Package>>;
+declare function versionsOperation(params: Readonly<PURLParams>, signal?: AbortSignal, client?: Client): Promise<ToolResult<Version[]>>;
+declare function dependenciesOperation(params: Readonly<PURLParams>, signal?: AbortSignal, client?: Client): Promise<ToolResult<Dependency[]>>;
+declare function maintainersOperation(params: Readonly<PURLParams>, signal?: AbortSignal, client?: Client): Promise<ToolResult<Maintainer[]>>;
+declare function bulkPackagesOperation(params: Readonly<BulkPackagesParams>, signal?: AbortSignal, client?: Client): Promise<ToolResult<Record<string, Package>>>;
+declare function ecosystemsOperation(): Promise<ToolResult<{
+  ecosystems: string[];
+}>>;
+//#endregion
+export { BulkPackagesParams, DEFAULT_BULK_CONCURRENCY, MAX_BULK_CONCURRENCY, MAX_BULK_PACKAGES, MAX_PURL_LENGTH, PURLParams, ToolResult, bulkPackagesOperation, dependenciesOperation, ecosystemsOperation, maintainersOperation, packageOperation, versionsOperation };
+//# sourceMappingURL=tool-operations.d.mts.map

package/dist/tool-operations.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-operations.d.mts","names":[],"sources":["../src/tool-operations.ts"],"mappings":";;;;;;cAca,eAAA;AAAA,cACA,iBAAA;AAAA,cACA,wBAAA;AAAA,cACA,oBAAA;AAAA,UAEI,UAAA;EACf,OAAA,EAAS,KAAA;IAAQ,IAAA;IAAc,IAAA;EAAA;EAC/B,OAAA,EAAS,CAAA;EACT,OAAA;AAAA;AAAA,UAGe,UAAA;EAAA,SACN,IAAA;AAAA;AAAA,UAGM,kBAAA;EAAA,SACN,KAAA;EAAA,SACA,WAAA;AAAA;AAAA,iBA8CW,gBAAA,CACpB,MAAA,EAAQ,QAAA,CAAS,UAAA,GACjB,MAAA,GAAS,WAAA,EACT,MAAA,GAAS,MAAA,GACR,OAAA,CAAQ,UAAA,CAAW,OAAA;AAAA,iBAKA,iBAAA,CACpB,MAAA,EAAQ,QAAA,CAAS,UAAA,GACjB,MAAA,GAAS,WAAA,EACT,MAAA,GAAS,MAAA,GAAM,OAAA,CAAA,UAAA,CAAA,OAAA;AAAA,iBAMK,qBAAA,CACpB,MAAA,EAAQ,QAAA,CAAS,UAAA,GACjB,MAAA,GAAS,WAAA,EACT,MAAA,GAAS,MAAA,GAAM,OAAA,CAAA,UAAA,CAAA,UAAA;AAAA,iBAMK,oBAAA,CACpB,MAAA,EAAQ,QAAA,CAAS,UAAA,GACjB,MAAA,GAAS,WAAA,EACT,MAAA,GAAS,MAAA,GAAM,OAAA,CAAA,UAAA,CAAA,UAAA;AAAA,iBAMK,qBAAA,CACpB,MAAA,EAAQ,QAAA,CAAS,kBAAA,GACjB,MAAA,GAAS,WAAA,EACT,MAAA,GAAS,MAAA,GACR,OAAA,CAAQ,UAAA,CAAW,MAAA,SAAe,OAAA;AAAA,iBAUf,mBAAA,CAAA,GAAuB,OAAA,CAAQ,UAAA;EAAa,UAAA;AAAA"}

package/dist/tool-operations.mjs

@@ -0,0 +1,5 @@
+import "./_chunks/registry.mjs";
+import "./_chunks/registries.mjs";
+import "./_chunks/helpers.mjs";
+import { a as bulkPackagesOperation, c as maintainersOperation, i as MAX_PURL_LENGTH, l as packageOperation, n as MAX_BULK_CONCURRENCY, o as dependenciesOperation, r as MAX_BULK_PACKAGES, s as ecosystemsOperation, t as DEFAULT_BULK_CONCURRENCY, u as versionsOperation } from "./_chunks/tool-operations.mjs";
+export { DEFAULT_BULK_CONCURRENCY, MAX_BULK_CONCURRENCY, MAX_BULK_PACKAGES, MAX_PURL_LENGTH, bulkPackagesOperation, dependenciesOperation, ecosystemsOperation, maintainersOperation, packageOperation, versionsOperation };

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@agntn/registries",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Universal package registry client. Query npm, PyPI, crates.io, RubyGems, Packagist and more with a single PURL-native API.",
   "keywords": [
     "crates",
+    "mcp",
     "metadata",
     "npm",
     "package-registry",
     "packagist",
+    "pi-extension",
     "purl",
     "pypi",
     "rubygems",
@@ -25,14 +27,17 @@
     "registries": "./dist/cli.mjs"
   },
   "files": [
-    "dist"
+    "dist",
+    "packages/pi/extensions",
+    "packages/omp/extensions"
   ],
   "type": "module",
   "sideEffects": [
     "./src/index.ts",
     "./src/registries/index.ts",
     "./dist/index.mjs",
-    "./dist/registries/index.mjs"
+    "./dist/registries/index.mjs",
+    "./dist/_chunks/*.mjs"
   ],
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
@@ -45,6 +50,10 @@
       "types": "./dist/ai.d.mts",
       "import": "./dist/ai.mjs"
     },
+    "./mcp": {
+      "types": "./dist/mcp.d.mts",
+      "import": "./dist/mcp.mjs"
+    },
     "./registries": {
       "types": "./dist/registries/index.d.mts",
       "import": "./dist/registries/index.mjs"
@@ -58,27 +67,42 @@
     "access": "public"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "citty": "^0.2.1",
     "consola": "^3.4.2",
     "ofetch": "^1.5.1",
+    "typebox": "^1.3.25",
     "unstorage": "^1.17.4"
   },
   "devDependencies": {
+    "@agntn/ox": "^0.1.0",
+    "@earendil-works/pi-coding-agent": "0.84.2",
+    "@oh-my-pi/omptype": "18.0.0",
+    "@oh-my-pi/pi-coding-agent": "18.0.0",
     "@types/node": "^25.3.0",
     "ai": "^6.0.116",
     "changelogen": "^0.6.2",
     "obuild": "^0.4.31",
-    "oxfmt": "^0.36.0",
-    "oxlint": "^1.51.0",
+    "oxfmt": "^0.65.0",
+    "oxlint": "^1.80.0",
+    "oxlint-tsgolint": "^7.0.2001",
     "typescript": "^5.8.3",
     "vitest": "^4.0.0",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.84.2",
+    "@oh-my-pi/pi-coding-agent": ">=18.0.0",
     "ai": "^6.0.116",
     "zod": "^4.3.6"
   },
   "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@oh-my-pi/pi-coding-agent": {
+      "optional": true
+    },
     "ai": {
       "optional": true
     },
@@ -89,14 +113,36 @@
   "engines": {
     "node": ">=22.6.0"
   },
+  "mcpServers": {
+    "registries": {
+      "command": "node",
+      "args": [
+        "dist/cli.mjs",
+        "mcp"
+      ]
+    }
+  },
+  "omp": {
+    "extensions": [
+      "./packages/omp/extensions/registries.ts"
+    ]
+  },
+  "pi": {
+    "extensions": [
+      "./packages/pi/extensions/registries.ts"
+    ]
+  },
   "scripts": {
     "build": "obuild",
     "dev:prepare": "obuild --stub",
-    "fmt": "oxlint . --fix && oxfmt .",
-    "lint": "oxlint . && oxfmt --check .",
-    "typecheck": "tsc --noEmit",
+    "fmt": "pnpm lint:fix",
+    "lint": "pnpm build && oxlint . && oxfmt --check .",
+    "lint:fix": "oxlint . --fix && oxfmt .",
+    "typecheck": "tsc --noEmit && tsc -p test/tsconfig.json --noEmit && pnpm build && tsc -p tsconfig.extensions.json --noEmit",
     "test": "vitest",
     "test:run": "vitest run",
-    "release": "pnpm test:run && pnpm build && changelogen --release --push"
+    "release": "pnpm test:run && pnpm build && changelogen --release --push",
+    "docs": "pnpm --dir docs dev",
+    "docs:build": "pnpm --dir docs build"
   }
 }