@agentxm/client-core 0.9.0 → 0.10.1

package/dist/src/unstable/mcp-servers/registry-ref-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry-ref-builder.d.ts","sourceRoot":"","sources":["../../../../src/unstable/mcp-servers/registry-ref-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,EACb,MAAM,aAAa,EACnB,SAAS,OAAO,EAChB,QAAQ,cAAc,EACtB,mBAAmB,aAAa,CAAC,eAAe,CAAC,KAChD,oBAUD,CAAC"}
+{"version":3,"file":"registry-ref-builder.d.ts","sourceRoot":"","sources":["../../../../src/unstable/mcp-servers/registry-ref-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,EACb,MAAM,aAAa,EACnB,SAAS,OAAO,EAChB,QAAQ,cAAc,EACtB,UAAU,aAAa,CAAC,eAAe,CAAC,KACvC,oBAUD,CAAC"}

package/dist/src/unstable/mcp-servers/registry-ref-builder.js

@@ -1,5 +1,5 @@
 import * as Option from "effect/Option";
-export const buildRegistryMcpServerRef = (owner, name, version, source, companionPackages) => ({
+export const buildRegistryMcpServerRef = (owner, name, version, source, packages) => ({
     type: "mcp-server",
     refType: "registry",
     server: { name },
@@ -8,6 +8,6 @@ export const buildRegistryMcpServerRef = (owner, name, version, source, companio
     name,
     version,
     integrity: Option.none(),
-    companionPackages,
+    packages,
 });
 //# sourceMappingURL=registry-ref-builder.js.map

package/dist/src/unstable/mcp-servers/registry-ref-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry-ref-builder.js","sourceRoot":"","sources":["../../../../src/unstable/mcp-servers/registry-ref-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAOxC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,KAAa,EACb,IAAmB,EACnB,OAAgB,EAChB,MAAsB,EACtB,iBAAiD,EAC3B,EAAE,CAAC,CAAC;IAC1B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,EAAE,IAAI,EAAE;IAChB,MAAM;IACN,KAAK;IACL,IAAI;IACJ,OAAO;IACP,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;IACxB,iBAAiB;CAClB,CAAC,CAAC"}
+{"version":3,"file":"registry-ref-builder.js","sourceRoot":"","sources":["../../../../src/unstable/mcp-servers/registry-ref-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAOxC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,KAAa,EACb,IAAmB,EACnB,OAAgB,EAChB,MAAsB,EACtB,QAAwC,EAClB,EAAE,CAAC,CAAC;IAC1B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,EAAE,IAAI,EAAE;IAChB,MAAM;IACN,KAAK;IACL,IAAI;IACJ,OAAO;IACP,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;IACxB,QAAQ;CACT,CAAC,CAAC"}

package/dist/src/unstable/package-urls/companion-package.d.ts

@@ -0,0 +1,14 @@
+import * as Schema from "effect/Schema";
+export declare const CompanionPackageSchema: Schema.Struct<{
+    readonly purl: Schema.brand<Schema.NonEmptyString, "PackageIdentityPurl">;
+    readonly versionRange: Schema.optional<Schema.brand<Schema.decodeTo<Schema.toType<Schema.Struct<{
+        readonly raw: Schema.NonEmptyString;
+        readonly scheme: Schema.NonEmptyString;
+        readonly constraints: Schema.$Array<Schema.Struct<{
+            readonly comparator: Schema.Literals<readonly ["=", "!=", "<", "<=", ">", ">="]>;
+            readonly version: Schema.NonEmptyString;
+        }>>;
+    }>>, Schema.NonEmptyString, never, never>, "VersRange">>;
+}>;
+export type CompanionPackage = Schema.Schema.Type<typeof CompanionPackageSchema>;
+//# sourceMappingURL=companion-package.d.ts.map

package/dist/src/unstable/package-urls/companion-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-package.d.ts","sourceRoot":"","sources":["../../../../src/unstable/package-urls/companion-package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AA0CxC,eAAO,MAAM,sBAAsB;;;;;;;;;;EAQlC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/src/unstable/package-urls/companion-package.js

@@ -0,0 +1,41 @@
+import * as Schema from "effect/Schema";
+import { parsePurlIdentity } from "./internal.js";
+import { PackageIdentityPurlSchema } from "./package-identity-purl.js";
+import { splitVersAtScheme, VersRangeSchema } from "./vers-range.js";
+const CompanionPackageShapeSchema = Schema.Struct({
+    purl: PackageIdentityPurlSchema,
+    versionRange: Schema.optional(VersRangeSchema),
+}).annotate({
+    identifier: "CompanionPackageShape",
+    title: "Companion Package",
+    description: "A companion package purl identity with an optional VERS compatibility range.",
+});
+const validateCompanionPackage = (value) => {
+    if (value.versionRange === undefined) {
+        return undefined;
+    }
+    const parsed = parsePurlIdentity(value.purl);
+    if (typeof parsed === "string") {
+        return parsed;
+    }
+    let versionRangeScheme;
+    if (typeof value.versionRange === "string") {
+        const split = splitVersAtScheme(value.versionRange);
+        if (typeof split === "string") {
+            return split;
+        }
+        versionRangeScheme = split.scheme;
+    }
+    else {
+        versionRangeScheme = value.versionRange.scheme;
+    }
+    return parsed.type === versionRangeScheme
+        ? undefined
+        : `Companion package purl ecosystem '${parsed.type}' must match VERS scheme '${versionRangeScheme}'.`;
+};
+export const CompanionPackageSchema = CompanionPackageShapeSchema.pipe(Schema.check(Schema.makeFilter(validateCompanionPackage)), Schema.annotate({
+    identifier: "CompanionPackage",
+    title: "Companion Package",
+    description: "A companion package declaration. The purl is an identity-only Package URL; versionRange is an optional VERS expression whose scheme must match the purl ecosystem.",
+}));
+//# sourceMappingURL=companion-package.js.map

package/dist/src/unstable/package-urls/companion-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-package.js","sourceRoot":"","sources":["../../../../src/unstable/package-urls/companion-package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,yBAAyB;IAC/B,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC;CAC/C,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,uBAAuB;IACnC,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,8EAA8E;CAC5F,CAAC,CAAC;AAIH,MAAM,wBAAwB,GAAG,CAAC,KAA4B,EAAsB,EAAE;IACpF,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,kBAA0B,CAAC;IAC/B,IAAI,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,KAAK,kBAAkB;QACvC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,qCAAqC,MAAM,CAAC,IAAI,6BAA6B,kBAAkB,IAAI,CAAC;AAC1G,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC,IAAI,CACpE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC,EACzD,MAAM,CAAC,QAAQ,CAAC;IACd,UAAU,EAAE,kBAAkB;IAC9B,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EACT,oKAAoK;CACvK,CAAC,CACH,CAAC"}

package/dist/src/unstable/package-urls/companion-package.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=companion-package.spec.d.ts.map

package/dist/src/unstable/package-urls/companion-package.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-package.spec.d.ts","sourceRoot":"","sources":["../../../../src/unstable/package-urls/companion-package.spec.ts"],"names":[],"mappings":""}

package/dist/src/unstable/package-urls/companion-package.spec.js

@@ -0,0 +1,37 @@
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { describe, expect, it } from "vitest";
+import { CompanionPackageSchema } from "./companion-package.js";
+describe("CompanionPackageSchema", () => {
+    const decode = Schema.decodeUnknownResult(CompanionPackageSchema);
+    it("accepts an identity-only companion package", () => {
+        const result = decode({ purl: "pkg:npm/example" });
+        expect(Result.isSuccess(result)).toBe(true);
+        if (Result.isSuccess(result)) {
+            expect(result.success.purl).toBe("pkg:npm/example");
+            expect(result.success.versionRange).toBeUndefined();
+        }
+    });
+    it("accepts a matching purl ecosystem and VERS scheme", () => {
+        const result = decode({
+            purl: "pkg:npm/example",
+            versionRange: "vers:npm/>=1.0.0",
+        });
+        expect(Result.isSuccess(result)).toBe(true);
+        if (Result.isSuccess(result)) {
+            expect(result.success.versionRange?.scheme).toBe("npm");
+        }
+    });
+    it("rejects a mismatched purl ecosystem and VERS scheme", () => {
+        const result = decode({
+            purl: "pkg:pypi/example",
+            versionRange: "vers:npm/>=1.0.0",
+        });
+        expect(Result.isFailure(result)).toBe(true);
+        if (Result.isFailure(result)) {
+            expect(String(result.failure)).toContain("pypi");
+            expect(String(result.failure)).toContain("npm");
+        }
+    });
+});
+//# sourceMappingURL=companion-package.spec.js.map

package/dist/src/unstable/package-urls/companion-package.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-package.spec.js","sourceRoot":"","sources":["../../../../src/unstable/package-urls/companion-package.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;IAElE,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAEnD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;QACtD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM,CAAC;YACpB,IAAI,EAAE,iBAAiB;YACvB,YAAY,EAAE,kBAAkB;SACjC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,MAAM,GAAG,MAAM,CAAC;YACpB,IAAI,EAAE,kBAAkB;YACxB,YAAY,EAAE,kBAAkB;SACjC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/unstable/package-urls/index.d.ts

@@ -0,0 +1,4 @@
+export { CompanionPackageSchema, type CompanionPackage } from "./companion-package.js";
+export { PACKAGE_IDENTITY_PURL_DESCRIPTION, PackageIdentityPurlSchema, type PackageIdentityPurl, } from "./package-identity-purl.js";
+export { VersComparatorSchema, VersConstraintSchema, VersRangeSchema, parseVersRange, splitVersAtScheme, type VersComparator, type VersConstraint, type VersRange, } from "./vers-range.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/package-urls/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/package-urls/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EACL,iCAAiC,EACjC,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC"}

package/dist/src/unstable/package-urls/index.js

@@ -0,0 +1,4 @@
+export { CompanionPackageSchema } from "./companion-package.js";
+export { PACKAGE_IDENTITY_PURL_DESCRIPTION, PackageIdentityPurlSchema, } from "./package-identity-purl.js";
+export { VersComparatorSchema, VersConstraintSchema, VersRangeSchema, parseVersRange, splitVersAtScheme, } from "./vers-range.js";
+//# sourceMappingURL=index.js.map

package/dist/src/unstable/package-urls/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/package-urls/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAyB,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EACL,iCAAiC,EACjC,yBAAyB,GAE1B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,iBAAiB,GAIlB,MAAM,iBAAiB,CAAC"}

package/dist/src/unstable/package-urls/internal.d.ts

@@ -0,0 +1,6 @@
+export interface ParsedPurlIdentity {
+    readonly type: string;
+    readonly version: string | undefined;
+}
+export declare const parsePurlIdentity: (value: string) => ParsedPurlIdentity | string;
+//# sourceMappingURL=internal.d.ts.map

package/dist/src/unstable/package-urls/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../../src/unstable/package-urls/internal.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,kBAAkB,GAAG,MAUtE,CAAC"}

package/dist/src/unstable/package-urls/internal.js

@@ -0,0 +1,14 @@
+import { PackageURL } from "packageurl-js";
+export const parsePurlIdentity = (value) => {
+    try {
+        const parsed = PackageURL.fromString(value);
+        return {
+            type: parsed.type,
+            version: parsed.version ?? undefined,
+        };
+    }
+    catch {
+        return `Expected valid purl, got: ${value}`;
+    }
+};
+//# sourceMappingURL=internal.js.map

package/dist/src/unstable/package-urls/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../../../src/unstable/package-urls/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAO3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAA+B,EAAE;IAC9E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC5C,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,SAAS;SACrC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,6BAA6B,KAAK,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC,CAAC"}

package/dist/src/unstable/package-urls/package-identity-purl.d.ts

@@ -0,0 +1,5 @@
+import * as Schema from "effect/Schema";
+export declare const PACKAGE_IDENTITY_PURL_DESCRIPTION = "A Package URL (purl) identity for a companion package. Companion package purls are identities, not pins: omit the purl @version segment and put compatibility constraints in versionRange.";
+export declare const PackageIdentityPurlSchema: Schema.brand<Schema.NonEmptyString, "PackageIdentityPurl">;
+export type PackageIdentityPurl = Schema.Schema.Type<typeof PackageIdentityPurlSchema>;
+//# sourceMappingURL=package-identity-purl.d.ts.map

package/dist/src/unstable/package-urls/package-identity-purl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-identity-purl.d.ts","sourceRoot":"","sources":["../../../../src/unstable/package-urls/package-identity-purl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,eAAO,MAAM,iCAAiC,+LACgJ,CAAC;AAe/L,eAAO,MAAM,yBAAyB,4DAkBrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/src/unstable/package-urls/package-identity-purl.js

@@ -0,0 +1,26 @@
+import * as Schema from "effect/Schema";
+import { parsePurlIdentity } from "./internal.js";
+export const PACKAGE_IDENTITY_PURL_DESCRIPTION = "A Package URL (purl) identity for a companion package. Companion package purls are identities, not pins: omit the purl @version segment and put compatibility constraints in versionRange.";
+const PACKAGE_URL_PATTERN = /^[Pp][Kk][Gg]:[a-zA-Z][a-zA-Z0-9.+-]*\/.+$/;
+const validatePackageIdentityPurl = (value) => {
+    const parsed = parsePurlIdentity(value);
+    if (typeof parsed === "string") {
+        return `Expected valid companion package purl, got: ${value}`;
+    }
+    return parsed.version === undefined
+        ? undefined
+        : `Companion package purls are identities, not pins. Move ${value}'s version into versionRange.`;
+};
+export const PackageIdentityPurlSchema = Schema.NonEmptyString.pipe(Schema.check(Schema.isPattern(PACKAGE_URL_PATTERN, {
+    title: "Package Identity Purl",
+    description: PACKAGE_IDENTITY_PURL_DESCRIPTION,
+    examples: ["pkg:npm/react", "pkg:pypi/requests", "pkg:cargo/serde"],
+    message: "Expected a Package URL like pkg:npm/react",
+})), Schema.check(Schema.makeFilter(validatePackageIdentityPurl)), Schema.annotate({
+    identifier: "PackageIdentityPurl",
+    title: "Package Identity Purl",
+    description: PACKAGE_IDENTITY_PURL_DESCRIPTION,
+    examples: ["pkg:npm/react", "pkg:pypi/requests", "pkg:cargo/serde"],
+    message: "Companion package purls are identities, not pins. Use versionRange for versions.",
+}), Schema.brand("PackageIdentityPurl"));
+//# sourceMappingURL=package-identity-purl.js.map

package/dist/src/unstable/package-urls/package-identity-purl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-identity-purl.js","sourceRoot":"","sources":["../../../../src/unstable/package-urls/package-identity-purl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,CAAC,MAAM,iCAAiC,GAC5C,4LAA4L,CAAC;AAE/L,MAAM,mBAAmB,GAAG,4CAA4C,CAAC;AAEzE,MAAM,2BAA2B,GAAG,CAAC,KAAa,EAAsB,EAAE;IACxE,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,+CAA+C,KAAK,EAAE,CAAC;IAChE,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,KAAK,SAAS;QACjC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,0DAA0D,KAAK,+BAA+B,CAAC;AACrG,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CACjE,MAAM,CAAC,KAAK,CACV,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE;IACpC,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EAAE,iCAAiC;IAC9C,QAAQ,EAAE,CAAC,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,CAAC;IACnE,OAAO,EAAE,2CAA2C;CACrD,CAAC,CACH,EACD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAAC,EAC5D,MAAM,CAAC,QAAQ,CAAC;IACd,UAAU,EAAE,qBAAqB;IACjC,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EAAE,iCAAiC;IAC9C,QAAQ,EAAE,CAAC,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,CAAC;IACnE,OAAO,EAAE,kFAAkF;CAC5F,CAAC,EACF,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CACpC,CAAC"}

package/dist/src/unstable/package-urls/package-identity-purl.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=package-identity-purl.spec.d.ts.map

package/dist/src/unstable/package-urls/package-identity-purl.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-identity-purl.spec.d.ts","sourceRoot":"","sources":["../../../../src/unstable/package-urls/package-identity-purl.spec.ts"],"names":[],"mappings":""}

package/dist/src/unstable/package-urls/package-identity-purl.spec.js

@@ -0,0 +1,33 @@
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import * as SchemaAST from "effect/SchemaAST";
+import { describe, expect, it } from "vitest";
+import { PackageIdentityPurlSchema } from "./package-identity-purl.js";
+describe("PackageIdentityPurlSchema", () => {
+    const decode = Schema.decodeUnknownResult(PackageIdentityPurlSchema);
+    it("decodes a bare purl", () => {
+        const result = decode("pkg:npm/example");
+        expect(Result.isSuccess(result)).toBe(true);
+        if (Result.isSuccess(result)) {
+            expect(result.success).toBe("pkg:npm/example");
+        }
+    });
+    it("rejects a purl with an @version and points authors to versionRange", () => {
+        const result = decode("pkg:npm/example@1.2.3");
+        expect(Result.isFailure(result)).toBe(true);
+        if (Result.isFailure(result)) {
+            expect(String(result.failure)).toContain("Companion package purls are identities");
+            expect(String(result.failure)).toContain("versionRange");
+        }
+        const annotations = SchemaAST.resolve(PackageIdentityPurlSchema.ast);
+        expect(annotations?.["description"]).toContain("versionRange");
+    });
+    it("preserves namespace while rejecting only the version segment", () => {
+        const result = decode("pkg:npm/%40scope/example");
+        expect(Result.isSuccess(result)).toBe(true);
+        if (Result.isSuccess(result)) {
+            expect(result.success).toBe("pkg:npm/%40scope/example");
+        }
+    });
+});
+//# sourceMappingURL=package-identity-purl.spec.js.map

package/dist/src/unstable/package-urls/package-identity-purl.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-identity-purl.spec.js","sourceRoot":"","sources":["../../../../src/unstable/package-urls/package-identity-purl.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC;IAErE,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAEzC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,MAAM,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAE/C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,wCAAwC,CAAC,CAAC;YACnF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;QACrE,MAAM,CAAC,WAAW,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,MAAM,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAElD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/unstable/package-urls/vers-range.d.ts

@@ -0,0 +1,32 @@
+import * as Schema from "effect/Schema";
+export declare const VersComparatorSchema: Schema.Literals<readonly ["=", "!=", "<", "<=", ">", ">="]>;
+export type VersComparator = Schema.Schema.Type<typeof VersComparatorSchema>;
+export declare const VersConstraintSchema: Schema.Struct<{
+    readonly comparator: Schema.Literals<readonly ["=", "!=", "<", "<=", ">", ">="]>;
+    readonly version: Schema.NonEmptyString;
+}>;
+export type VersConstraint = Schema.Schema.Type<typeof VersConstraintSchema>;
+declare const VersRangeDecodedSchema: Schema.Struct<{
+    readonly raw: Schema.NonEmptyString;
+    readonly scheme: Schema.NonEmptyString;
+    readonly constraints: Schema.$Array<Schema.Struct<{
+        readonly comparator: Schema.Literals<readonly ["=", "!=", "<", "<=", ">", ">="]>;
+        readonly version: Schema.NonEmptyString;
+    }>>;
+}>;
+export declare const splitVersAtScheme: (value: string) => {
+    readonly scheme: string;
+    readonly constraintsText: string;
+} | string;
+export declare const parseVersRange: (value: string) => Schema.Schema.Type<typeof VersRangeDecodedSchema> | string;
+export declare const VersRangeSchema: Schema.brand<Schema.decodeTo<Schema.toType<Schema.Struct<{
+    readonly raw: Schema.NonEmptyString;
+    readonly scheme: Schema.NonEmptyString;
+    readonly constraints: Schema.$Array<Schema.Struct<{
+        readonly comparator: Schema.Literals<readonly ["=", "!=", "<", "<=", ">", ">="]>;
+        readonly version: Schema.NonEmptyString;
+    }>>;
+}>>, Schema.NonEmptyString, never, never>, "VersRange">;
+export type VersRange = Schema.Schema.Type<typeof VersRangeSchema>;
+export {};
+//# sourceMappingURL=vers-range.d.ts.map

package/dist/src/unstable/package-urls/vers-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vers-range.d.ts","sourceRoot":"","sources":["../../../../src/unstable/package-urls/vers-range.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAgDxC,eAAO,MAAM,oBAAoB,6DAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE7E,eAAO,MAAM,oBAAoB;;;EAO/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE7E,QAAA,MAAM,sBAAsB;;;;;;;EAQ1B,CAAC;AAgCH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,KACZ;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAAG,MAkBlE,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,sBAAsB,CAAC,GAAG,MAyCtD,CAAC;AASF,eAAO,MAAM,eAAe;;;;;;;uDAmB3B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/src/unstable/package-urls/vers-range.js

@@ -0,0 +1,164 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import * as SchemaIssue from "effect/SchemaIssue";
+import * as SchemaTransformation from "effect/SchemaTransformation";
+const VERS_PREFIX = "vers:";
+const SENTINEL_SCHEMES = [
+    "all",
+    "none",
+    "semver",
+    "generic",
+    "intdot",
+    "lexicographic",
+    "datetime",
+];
+const CONCRETE_ECOSYSTEM_SCHEMES = [
+    "apk",
+    "bazel",
+    "cargo",
+    "cocoapods",
+    "composer",
+    "conan",
+    "conda",
+    "cpan",
+    "cran",
+    "deb",
+    "docker",
+    "gem",
+    "golang",
+    "hackage",
+    "hex",
+    "huggingface",
+    "julia",
+    "jsr",
+    "luarocks",
+    "maven",
+    "mojo",
+    "npm",
+    "nuget",
+    "opam",
+    "pub",
+    "pypi",
+    "rpm",
+    "swift",
+    "zig",
+];
+export const VersComparatorSchema = Schema.Literals(["=", "!=", "<", "<=", ">", ">="]).annotate({
+    identifier: "VersComparator",
+    title: "VERS Comparator",
+    description: "A comparator inside an AgentXM-supported VERS constraint.",
+});
+export const VersConstraintSchema = Schema.Struct({
+    comparator: VersComparatorSchema,
+    version: Schema.NonEmptyString,
+}).annotate({
+    identifier: "VersConstraint",
+    title: "VERS Constraint",
+    description: "A parsed comparator and version from an AgentXM-supported VERS range.",
+});
+const VersRangeDecodedSchema = Schema.Struct({
+    raw: Schema.NonEmptyString,
+    scheme: Schema.NonEmptyString,
+    constraints: Schema.Array(VersConstraintSchema),
+}).annotate({
+    identifier: "VersRangeDecoded",
+    title: "VERS Range",
+    description: "A decoded VERS range with its raw value, ecosystem scheme, and constraints.",
+});
+const isSentinelScheme = (scheme) => SENTINEL_SCHEMES.some((candidate) => candidate === scheme);
+const isConcreteEcosystemScheme = (scheme) => CONCRETE_ECOSYSTEM_SCHEMES.some((candidate) => candidate === scheme);
+const parseComparator = (constraint) => {
+    if (constraint.startsWith(">="))
+        return ">=";
+    if (constraint.startsWith("<="))
+        return "<=";
+    if (constraint.startsWith("!="))
+        return "!=";
+    if (constraint.startsWith(">"))
+        return ">";
+    if (constraint.startsWith("<"))
+        return "<";
+    if (constraint.startsWith("="))
+        return "=";
+    return undefined;
+};
+const parseConstraint = (constraint) => {
+    const comparator = parseComparator(constraint);
+    if (comparator === undefined) {
+        return `Expected VERS constraint to start with one of =, !=, <, <=, >, or >=, got: ${constraint}`;
+    }
+    const version = constraint.slice(comparator.length);
+    if (version.length === 0) {
+        return `Expected VERS constraint version after ${comparator}`;
+    }
+    return { comparator, version };
+};
+export const splitVersAtScheme = (value) => {
+    if (!value.startsWith(VERS_PREFIX)) {
+        return "Expected VERS range to start with the vers: prefix.";
+    }
+    const withoutPrefix = value.slice(VERS_PREFIX.length);
+    const slashIndex = withoutPrefix.indexOf("/");
+    if (slashIndex <= 0) {
+        return "Expected VERS range to include a non-empty scheme before '/'.";
+    }
+    const scheme = withoutPrefix.slice(0, slashIndex);
+    const constraintsText = withoutPrefix.slice(slashIndex + 1);
+    if (constraintsText.length === 0) {
+        return "Expected VERS range to include at least one constraint after '/'.";
+    }
+    return { scheme, constraintsText };
+};
+export const parseVersRange = (value) => {
+    if (value.includes("%")) {
+        return "VERS percent-encoded values are not supported yet.";
+    }
+    const split = splitVersAtScheme(value);
+    if (typeof split === "string") {
+        return split;
+    }
+    if (isSentinelScheme(split.scheme)) {
+        return `VERS scheme '${split.scheme}' is a generic scheme; generic schemes are not accepted for companion packages.`;
+    }
+    if (!isConcreteEcosystemScheme(split.scheme)) {
+        return `VERS scheme '${split.scheme}' is not a known concrete package ecosystem.`;
+    }
+    if (split.constraintsText === "*") {
+        return 'omit versionRange to express "any version"; wildcard-only VERS ranges are not accepted.';
+    }
+    const constraints = [];
+    for (const constraintText of split.constraintsText.split("|")) {
+        if (constraintText.length === 0) {
+            return "Expected VERS range constraints to be non-empty.";
+        }
+        const constraint = parseConstraint(constraintText);
+        if (typeof constraint === "string") {
+            return constraint;
+        }
+        constraints.push(constraint);
+    }
+    return {
+        raw: value,
+        scheme: split.scheme,
+        constraints,
+    };
+};
+const parseVersRangeEffect = (value) => {
+    const result = parseVersRange(value);
+    return typeof result === "string"
+        ? Effect.fail(new SchemaIssue.Forbidden(Option.some(value), { message: result }))
+        : Effect.succeed(result);
+};
+export const VersRangeSchema = Schema.NonEmptyString.pipe(Schema.decodeTo(Schema.toType(VersRangeDecodedSchema), SchemaTransformation.transformOrFail({
+    decode: parseVersRangeEffect,
+    encode: (value) => Effect.succeed(value.raw),
+})), Schema.annotate({
+    identifier: "VersRange",
+    title: "VERS Range",
+    description: "A VERS version range like vers:npm/>=1.0.0|<2.0.0. Use a concrete package ecosystem scheme matching the companion purl type. Omit versionRange for any-version compatibility.",
+    message: "Expected a VERS range like vers:npm/>=1.0.0|<2.0.0",
+}), Schema.annotateEncoded({
+    examples: ["vers:npm/>=18.0.0|<19.0.0", "vers:pypi/>=2.31.0", "vers:cargo/>=1.0.0"],
+}), Schema.brand("VersRange"));
+//# sourceMappingURL=vers-range.js.map

package/dist/src/unstable/package-urls/vers-range.js.map

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

package/dist/src/unstable/package-urls/vers-range.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vers-range.spec.d.ts.map

package/dist/src/unstable/package-urls/vers-range.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vers-range.spec.d.ts","sourceRoot":"","sources":["../../../../src/unstable/package-urls/vers-range.spec.ts"],"names":[],"mappings":""}

package/dist/src/unstable/package-urls/vers-range.spec.js

@@ -0,0 +1,60 @@
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { describe, expect, it } from "vitest";
+import { VersRangeSchema } from "./vers-range.js";
+describe("VersRangeSchema", () => {
+    const decode = Schema.decodeUnknownResult(VersRangeSchema);
+    it("decodes a well-formed VERS range with scheme and constraints", () => {
+        const result = decode("vers:npm/>=1.0.0|<2.0.0");
+        expect(Result.isSuccess(result)).toBe(true);
+        if (Result.isSuccess(result)) {
+            expect(result.success.raw).toBe("vers:npm/>=1.0.0|<2.0.0");
+            expect(result.success.scheme).toBe("npm");
+            expect(result.success.constraints).toEqual([
+                { comparator: ">=", version: "1.0.0" },
+                { comparator: "<", version: "2.0.0" },
+            ]);
+        }
+    });
+    it("rejects an empty constraint list", () => {
+        const result = decode("vers:npm/");
+        expect(Result.isFailure(result)).toBe(true);
+    });
+    it("rejects a missing vers prefix", () => {
+        const result = decode(">=1.0.0|<2.0.0");
+        expect(Result.isFailure(result)).toBe(true);
+        if (Result.isFailure(result)) {
+            expect(String(result.failure)).toContain("vers:");
+        }
+    });
+    it("rejects sentinel schemes", () => {
+        const result = decode("vers:semver/>=1.0.0");
+        expect(Result.isFailure(result)).toBe(true);
+        if (Result.isFailure(result)) {
+            expect(String(result.failure)).toContain("semver");
+            expect(String(result.failure)).toContain("generic schemes");
+        }
+    });
+    it("accepts concrete ecosystem schemes", () => {
+        const result = decode("vers:pypi/>=1.0.0");
+        expect(Result.isSuccess(result)).toBe(true);
+        if (Result.isSuccess(result)) {
+            expect(result.success.scheme).toBe("pypi");
+        }
+    });
+    it("rejects wildcard-only ranges", () => {
+        const result = decode("vers:npm/*");
+        expect(Result.isFailure(result)).toBe(true);
+        if (Result.isFailure(result)) {
+            expect(String(result.failure)).toContain("omit versionRange");
+        }
+    });
+    it("rejects percent-encoded values", () => {
+        const result = decode("vers:npm/%3E%3D1.0.0");
+        expect(Result.isFailure(result)).toBe(true);
+        if (Result.isFailure(result)) {
+            expect(String(result.failure)).toContain("percent-encoded");
+        }
+    });
+});
+//# sourceMappingURL=vers-range.spec.js.map

package/dist/src/unstable/package-urls/vers-range.spec.js.map

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

package/dist/src/unstable/packaging/axm-package-meta.d.ts

@@ -4,6 +4,11 @@
  * @experimental This API is unstable and may change without notice.
  */
 import * as Schema from "effect/Schema";
+export declare const PackageExtensionDeclarationSchema: Schema.Struct<{
+    readonly ref: Schema.String;
+    readonly versionRange: Schema.optional<Schema.NullOr<Schema.brand<Schema.NonEmptyString, "VersionRange">>>;
+}>;
+export type PackageExtensionDeclaration = Schema.Schema.Type<typeof PackageExtensionDeclarationSchema>;
 /**
  * Schema for the axm package metadata file that library authors ship
  * to surface recommended axm extensions for their package.
@@ -12,7 +17,10 @@ import * as Schema from "effect/Schema";
  */
 export declare const AxmPackageMetaSchema: Schema.Struct<{
     readonly $schema: Schema.optional<Schema.String>;
-    readonly recommendedExtensions: Schema.$Array<Schema.brand<Schema.NonEmptyString, "ExtensionSpec">>;
+    readonly extensions: Schema.$Array<Schema.Struct<{
+        readonly ref: Schema.String;
+        readonly versionRange: Schema.optional<Schema.NullOr<Schema.brand<Schema.NonEmptyString, "VersionRange">>>;
+    }>>;
 }>;
 /**
  * Inferred type for AxmPackageMeta schema.

package/dist/src/unstable/packaging/axm-package-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"axm-package-meta.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/axm-package-meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;EAO/B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"axm-package-meta.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/axm-package-meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,eAAO,MAAM,iCAAiC;;;EAQ5C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC1D,OAAO,iCAAiC,CACzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;EAO/B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC"}