@agentxm/extension-model 0.34.0 → 0.36.0

package/dist/src/unstable/sources/types.d.ts

@@ -29,7 +29,7 @@ export type SourceType = Schema.Schema.Type<typeof SourceTypeSchema>;
 /**
  * Ref type discriminator for extension ref hosting categories.
  *
- * - `"git-hosted"` - Git-based sources (GitHub, GitLab, Bitbucket, AzureRepos, Git)
+ * - `"git-hosted"` - Git-based sources, including the built-in forges
  * - `"registry"` - Package registry source
  * - `"local"` - Local filesystem path source
  * - `"workspace"` - Intrinsic managed workspace package
@@ -43,60 +43,9 @@ export declare const RefTypeSchema: Schema.Literals<readonly ["git-hosted", "reg
  * @experimental This API is unstable and may change without notice.
  */
 export type RefType = Schema.Schema.Type<typeof RefTypeSchema>;
-export declare const SourceSegmentSchema: Schema.NonEmptyString;
 export declare const SourceRefSchema: Schema.NonEmptyString;
 export declare const SourceNamespaceSchema: Schema.NonEmptyString;
 export declare const SourceSubPathSchema: Schema.NonEmptyString;
-export declare const GitHostedSourceParamPartsSchema: Schema.Struct<{
-    sourceName: Schema.optional<Schema.String>;
-    owner: Schema.NonEmptyString;
-    repo: Schema.NonEmptyString;
-    ref: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-    subPath: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-}>;
-export type GitHostedSourceParamParts = Schema.Schema.Type<typeof GitHostedSourceParamPartsSchema>;
-export declare const AzureReposSourceParamPartsSchema: Schema.Struct<{
-    sourceName: Schema.optional<Schema.String>;
-    organization: Schema.NonEmptyString;
-    project: Schema.NonEmptyString;
-    repo: Schema.NonEmptyString;
-    ref: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-    subPath: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-}>;
-export type AzureReposSourceParamParts = Schema.Schema.Type<typeof AzureReposSourceParamPartsSchema>;
-export declare const GitHubSourceParamsSchema: Schema.Struct<{
-    readonly sourceName: Schema.optional<Schema.String>;
-    readonly owner: Schema.NonEmptyString;
-    readonly repo: Schema.NonEmptyString;
-    readonly ref: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-    readonly subPath: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-    readonly type: Schema.Literal<"github">;
-}>;
-export declare const GitLabSourceParamsSchema: Schema.Struct<{
-    readonly sourceName: Schema.optional<Schema.String>;
-    readonly owner: Schema.NonEmptyString;
-    readonly repo: Schema.NonEmptyString;
-    readonly ref: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-    readonly subPath: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-    readonly type: Schema.Literal<"gitlab">;
-}>;
-export declare const BitbucketSourceParamsSchema: Schema.Struct<{
-    readonly sourceName: Schema.optional<Schema.String>;
-    readonly owner: Schema.NonEmptyString;
-    readonly repo: Schema.NonEmptyString;
-    readonly ref: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-    readonly subPath: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-    readonly type: Schema.Literal<"bitbucket">;
-}>;
-export declare const AzureReposSourceParamsSchema: Schema.Struct<{
-    readonly sourceName: Schema.optional<Schema.String>;
-    readonly organization: Schema.NonEmptyString;
-    readonly project: Schema.NonEmptyString;
-    readonly repo: Schema.NonEmptyString;
-    readonly ref: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-    readonly subPath: Schema.OptionFromOptionalKey<Schema.NonEmptyString>;
-    readonly type: Schema.Literal<"azurerepos">;
-}>;
 /** @experimental */
 /** Self-describing — the git URL lives in SourceParams. @experimental */
 export interface GitSourceHost {
@@ -126,47 +75,6 @@ export interface WorkspaceSourceHost {
 /** @experimental */
 export type SourceHost = GitSourceHost | RegistrySourceHost | LocalSourceHost | InlineSourceHost | WorkspaceSourceHost;
 /** @experimental */
-export interface GitHubSourceParams {
-    readonly type: "github";
-    readonly sourceName?: string | undefined;
-    readonly owner: string;
-    readonly repo: string;
-    readonly ref: Option.Option<string>;
-    readonly subPath: Option.Option<string>;
-    readonly cloneUrl?: Option.Option<string>;
-}
-/** @experimental */
-export interface GitLabSourceParams {
-    readonly type: "gitlab";
-    readonly sourceName?: string | undefined;
-    readonly owner: string;
-    readonly repo: string;
-    readonly ref: Option.Option<string>;
-    readonly subPath: Option.Option<string>;
-    readonly cloneUrl?: Option.Option<string>;
-}
-/** @experimental */
-export interface BitbucketSourceParams {
-    readonly type: "bitbucket";
-    readonly sourceName?: string | undefined;
-    readonly owner: string;
-    readonly repo: string;
-    readonly ref: Option.Option<string>;
-    readonly subPath: Option.Option<string>;
-    readonly cloneUrl?: Option.Option<string>;
-}
-/** @experimental */
-export interface AzureReposSourceParams {
-    readonly type: "azurerepos";
-    readonly sourceName?: string | undefined;
-    readonly organization: string;
-    readonly project: string;
-    readonly repo: string;
-    readonly ref: Option.Option<string>;
-    readonly subPath: Option.Option<string>;
-    readonly cloneUrl?: Option.Option<string>;
-}
-/** @experimental */
 export interface GitSourceParams {
     readonly type: "git";
     readonly url: URL;

package/dist/src/unstable/sources/types.js

@@ -36,7 +36,7 @@ export const SourceTypeSchema = Schema.Literals([
 /**
  * Ref type discriminator for extension ref hosting categories.
  *
- * - `"git-hosted"` - Git-based sources (GitHub, GitLab, Bitbucket, AzureRepos, Git)
+ * - `"git-hosted"` - Git-based sources, including the built-in forges
  * - `"registry"` - Package registry source
  * - `"local"` - Local filesystem path source
  * - `"workspace"` - Intrinsic managed workspace package
@@ -53,13 +53,7 @@ export const RefTypeSchema = Schema.Literals([
     title: "Ref Type",
     description: "Ref type category: git-hosted, registry, local, or workspace.",
 });
-const noSlashSegmentMessage = "Expected non-empty segment without '/' characters";
 const noTraversalSegmentMessage = "Expected subpath without '..' traversal segments";
-export const SourceSegmentSchema = Schema.NonEmptyString.pipe(Schema.check(Schema.makeFilter((value) => (value.includes("/") ? noSlashSegmentMessage : undefined)))).annotate({
-    identifier: "SourceSegment",
-    title: "Source Segment",
-    description: "A non-empty path segment without slash characters, used for owner/repo identifiers.",
-});
 export const SourceRefSchema = Schema.NonEmptyString;
 export const SourceNamespaceSchema = Schema.NonEmptyString.pipe(Schema.check(Schema.makeFilter((value) => value.split("/").some((segment) => segment.length === 0 || segment === "..")
     ? "Expected non-empty namespace path segments without '..' traversal"
@@ -75,45 +69,4 @@ export const SourceSubPathSchema = Schema.NonEmptyString.pipe(Schema.check(Schem
     title: "Source Subpath",
     description: "A non-empty repository subpath without empty or '..' traversal segments.",
 });
-const GitHostedSourceParamFields = {
-    sourceName: Schema.optional(Schema.String),
-    owner: SourceNamespaceSchema,
-    repo: SourceSegmentSchema,
-    ref: Schema.OptionFromOptionalKey(SourceRefSchema),
-    subPath: Schema.OptionFromOptionalKey(SourceSubPathSchema),
-};
-export const GitHostedSourceParamPartsSchema = Schema.Struct(GitHostedSourceParamFields).annotate({
-    identifier: "GitHostedSourceParamParts",
-    title: "Git Hosted Source Params",
-    description: "Parameters for a git-hosted source: owner, repo, optional ref and sub-path.",
-});
-const AzureReposSourceParamFields = {
-    sourceName: Schema.optional(Schema.String),
-    organization: SourceSegmentSchema,
-    project: SourceSegmentSchema,
-    repo: SourceSegmentSchema,
-    ref: Schema.OptionFromOptionalKey(SourceRefSchema),
-    subPath: Schema.OptionFromOptionalKey(SourceSubPathSchema),
-};
-export const AzureReposSourceParamPartsSchema = Schema.Struct(AzureReposSourceParamFields).annotate({
-    identifier: "AzureReposSourceParamParts",
-    title: "Azure Repos Source Params",
-    description: "Parameters for an Azure Repos source: organization, project, repo, optional ref and sub-path.",
-});
-export const GitHubSourceParamsSchema = Schema.Struct({
-    type: Schema.Literal("github"),
-    ...GitHostedSourceParamFields,
-});
-export const GitLabSourceParamsSchema = Schema.Struct({
-    type: Schema.Literal("gitlab"),
-    ...GitHostedSourceParamFields,
-});
-export const BitbucketSourceParamsSchema = Schema.Struct({
-    type: Schema.Literal("bitbucket"),
-    ...GitHostedSourceParamFields,
-});
-export const AzureReposSourceParamsSchema = Schema.Struct({
-    type: Schema.Literal("azurerepos"),
-    ...AzureReposSourceParamFields,
-});
 //# sourceMappingURL=types.js.map

package/dist/src/unstable/version-constraints/version-constraints.d.ts

@@ -39,12 +39,9 @@ export declare const decodeVersionSync: (input: unknown, options?: import("effec
  */
 export declare const decodeVersionRangeSync: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"VersionRange">;
 /**
- * Extract a version range suffix from a source string.
- *
- * Handles both namespaced (`@handle/name@^1.0.0`) and non-namespaced (`name@^1.0.0`) names.
- * Returns `Option.none()` when no version suffix is present.
+ * Decode a value as a semver version range, or none when it is not one.
  */
-export declare const parseVersionRange: (sourceString: string) => Option.Option<VersionRange>;
+export declare const decodeVersionRangeOption: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => Option.Option<string & import("effect/Brand").Brand<"VersionRange">>;
 /**
  * Check whether a string is a valid semver version range.
  */
@@ -57,15 +54,16 @@ export declare const intersectVersionConstraints: (constraints: ReadonlyArray<st
  */
 export declare const hasMinorOrMajorVersionBump: (previousVersion: string, currentVersion: string) => boolean;
 /**
- * Check whether a version satisfies a semver version range.
+ * Whether a version is one the range admits: the one predicate every
+ * selection and every satisfaction check applies, so a range admits the same
+ * versions wherever it is asked. It follows semver exactly, so `*` and an
+ * absent range admit every stable version and no prerelease; a prerelease is
+ * admitted only by a range that names its version tuple.
  */
 export declare const versionSatisfiesRange: (version: Version, range: VersionRange) => boolean;
 /**
- * Select the maximum version that satisfies the range, independent of input
- * order.
- *
- * - `Option.none()` range or `"*"` matches any version.
- * - Invalid ranges match nothing.
+ * Select the highest version the range admits, independent of input order.
+ * An absent range admits what `*` admits; an invalid range admits nothing.
  */
 export declare const resolveVersionInRange: <T extends VersionEntryLike>(versions: ReadonlyArray<T>, range: Option.Option<string>) => Option.Option<T>;
 //# sourceMappingURL=version-constraints.d.ts.map

package/dist/src/unstable/version-constraints/version-constraints.js

@@ -46,36 +46,9 @@ export const decodeVersionSync = Schema.decodeUnknownSync(VersionSchema);
 export const decodeVersionRangeSync = Schema.decodeUnknownSync(VersionRangeSchema);
 const parseSemverVersion = (version) => semver.parse(version);
 /**
- * Extract a version range suffix from a source string.
- *
- * Handles both namespaced (`@handle/name@^1.0.0`) and non-namespaced (`name@^1.0.0`) names.
- * Returns `Option.none()` when no version suffix is present.
+ * Decode a value as a semver version range, or none when it is not one.
  */
-export const parseVersionRange = (sourceString) => {
-    const decodeRange = (value) => {
-        try {
-            return Option.some(decodeVersionRangeSync(value));
-        }
-        catch {
-            return Option.none();
-        }
-    };
-    // For namespaced packages (@handle/name@range), find the @ after the handle
-    if (sourceString.startsWith("@")) {
-        const slashIndex = sourceString.indexOf("/");
-        if (slashIndex === -1)
-            return Option.none();
-        const afterHandle = sourceString.indexOf("@", slashIndex + 1);
-        if (afterHandle === -1)
-            return Option.none();
-        return decodeRange(sourceString.slice(afterHandle + 1));
-    }
-    // For non-namespaced packages (name@range)
-    const atIndex = sourceString.indexOf("@");
-    if (atIndex === -1)
-        return Option.none();
-    return decodeRange(sourceString.slice(atIndex + 1));
-};
+export const decodeVersionRangeOption = Schema.decodeUnknownOption(VersionRangeSchema);
 /**
  * Check whether a string is a valid semver version range.
  */
@@ -159,29 +132,27 @@ export const hasMinorOrMajorVersionBump = (previousVersion, currentVersion) => {
     return current.major > previous.major || current.minor > previous.minor;
 };
 /**
- * Check whether a version satisfies a semver version range.
+ * Whether a version is one the range admits: the one predicate every
+ * selection and every satisfaction check applies, so a range admits the same
+ * versions wherever it is asked. It follows semver exactly, so `*` and an
+ * absent range admit every stable version and no prerelease; a prerelease is
+ * admitted only by a range that names its version tuple.
  */
 export const versionSatisfiesRange = (version, range) => semver.satisfies(version, range);
+/** The range an absent constraint stands for: every stable version. */
+const UNCONSTRAINED_RANGE = "*";
 /**
- * Select the maximum version that satisfies the range, independent of input
- * order.
- *
- * - `Option.none()` range or `"*"` matches any version.
- * - Invalid ranges match nothing.
+ * Select the highest version the range admits, independent of input order.
+ * An absent range admits what `*` admits; an invalid range admits nothing.
  */
 export const resolveVersionInRange = (versions, range) => {
-    const rangeStr = Option.getOrElse(range, () => "*");
-    // Wildcard means no range filtering
-    const isWildcard = rangeStr === "*";
-    // Validate the range early
-    if (!isWildcard && !isValidVersionRange(rangeStr)) {
+    const decoded = decodeVersionRangeOption(Option.getOrElse(range, () => UNCONSTRAINED_RANGE));
+    if (Option.isNone(decoded))
         return Option.none();
-    }
     let selected;
     for (const version of versions) {
-        if (!isWildcard && !semver.satisfies(version.version, rangeStr)) {
+        if (!versionSatisfiesRange(version.version, decoded.value))
             continue;
-        }
         if (selected === undefined || semver.compareBuild(version.version, selected.version) > 0) {
             selected = version;
         }

package/package.json

@@ -11,14 +11,14 @@
   },
   "description": "Shared AgentXM extension model: identities, manifests, version constraints, and agent capabilities. Unstable and unsupported — use the axm.sh CLI.",
   "devDependencies": {
-    "@agentxm/specification-metadata": "0.34.0",
+    "@agentxm/specification-metadata": "0.36.0",
     "@effect/vitest": "4.0.0-rc.117",
     "@fast-check/vitest": "^0.5.0",
     "@types/semver": "^7.7.1",
     "@types/spdx-expression-parse": "4.0.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "vitest": "^5.0.0"
+    "vitest": "^5.0.1"
   },
   "engines": {
     "node": ">=24.19.0"
@@ -305,5 +305,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.34.0"
+  "version": "0.36.0"
 }