@agentxm/extension-model 0.31.1 → 0.32.0

package/dist/src/unstable/hooks/manifest-schema.js

@@ -4,7 +4,7 @@
  * @experimental This API is unstable and may change without notice.
  */
 import * as Schema from "effect/Schema";
-import { CanonicalHookEventIdSchema, CanonicalHookToolIdSchema, HookBlockOutcomeSchema, HookModifyOperationSchema, } from "../agent-capabilities/index.js";
+import { CanonicalHookEventIdSchema, CanonicalHookToolIdSchema, HookBlockOutcomeSchema, HookModifyOperationSchema, } from "../agent-capabilities/schema.js";
 import { CommonManifestBaseFields, ExtensionNameSchema, NonPackManifestFields, } from "../extensions/common.js";
 export const HOOK_MANIFEST_FILENAME = "hook.json";
 export const HOOK_EXTENSION_DIR = "hooks";

package/dist/src/unstable/packs/manifest-schema.d.ts

@@ -18,7 +18,13 @@ export declare const PACK_MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/pack.sch
 export declare const PackManifestSchema: Schema.Struct<{
     readonly type: Schema.Literal<"pack">;
     readonly name: Schema.brand<Schema.NonEmptyString, "ExtensionName">;
-    readonly dependencies: Schema.$Record<Schema.String, Schema.brand<Schema.NonEmptyString, "VersionRange">>;
+    readonly dependencies: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.brand<Schema.NonEmptyString, "VersionRange">, Schema.Struct<{
+        readonly source: Schema.Struct<{
+            readonly type: Schema.Literal<"registry">;
+            readonly url: Schema.URLFromString;
+        }>;
+        readonly versionRange: Schema.brand<Schema.NonEmptyString, "VersionRange">;
+    }>]>>;
     readonly publish: Schema.optional<Schema.Struct<{
         readonly visibility: Schema.optional<Schema.Literals<readonly ["public", "private"]>>;
         readonly ignore: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;

package/dist/src/unstable/packs/manifest-schema.js

@@ -4,7 +4,7 @@
  * @experimental This API is unstable and may change without notice.
  */
 import * as Schema from "effect/Schema";
-import { CommonManifestBaseFields, ExtensionNameSchema, NonPackExtensionDependencyConstraintMapSchema, } from "../extensions/common.js";
+import { CommonManifestBaseFields, ExtensionNameSchema, PackMemberConstraintMapSchema, } from "../extensions/common.js";
 export const PACK_MANIFEST_FILENAME = "pack.json";
 export const PACK_MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/pack.schema.json";
 /**
@@ -23,8 +23,8 @@ export const PackManifestSchema = Schema.Struct({
     name: ExtensionNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "pack name is required" }), Schema.annotate({
         description: "Short name for this pack within its owner namespace. Combined with owner, forms the FQN @owner/packs/<name>.",
     })),
-    dependencies: NonPackExtensionDependencyConstraintMapSchema.pipe(Schema.annotateKey({ messageMissingKey: "pack dependencies are required" }), Schema.annotate({
-        description: "Install-time extension constraints. AXM resolves and installs a member version satisfying each range; `axm packs add` writes a `>=` lower bound rooted at the current resolved version, so members track their latest release without republishing the pack. Narrow a range by hand only to exclude a known-breaking member release, and note that a caret below 1.0 pins to the current patch or minor and goes stale on every later release. These constraints select installed extension versions, unlike companion-package recommendation ranges in `packages`, which are metadata only.",
+    dependencies: PackMemberConstraintMapSchema.pipe(Schema.annotateKey({ messageMissingKey: "pack dependencies are required" }), Schema.annotate({
+        description: "Install-time extension constraints. A range inherits the Pack's source; an object may name an explicit Registry URL and versionRange. AXM resolves and installs a member version satisfying each range; `axm packs add` writes a `>=` lower bound rooted at the current resolved version, so members track their latest release without republishing the pack. Narrow a range by hand only to exclude a known-breaking member release. These constraints select installed extension versions, unlike companion-package recommendation ranges in `packages`, which are metadata only.",
     })),
 }).annotate({
     identifier: "PackManifest",

package/dist/src/unstable/recommendations/agent-extensions.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Portable package metadata for recommending agent extensions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/** The Registry used by portable recommendations that omit an explicit source. */
+export declare const AGENTXM_REGISTRY_URL = "https://registry.agentxm.ai";
+export declare const AgentExtensionGitSourceSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"git">;
+    readonly url: Schema.URLFromString;
+    readonly path: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly revision: Schema.optionalKey<Schema.NonEmptyString>;
+}>;
+export declare const AgentExtensionRegistrySourceSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"registry">;
+    readonly url: Schema.URLFromString;
+}>;
+export declare const AgentExtensionPathSourceSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"path">;
+    readonly path: Schema.NonEmptyString;
+}>;
+export declare const AgentExtensionSourceSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"git">;
+    readonly url: Schema.URLFromString;
+    readonly path: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly revision: Schema.optionalKey<Schema.NonEmptyString>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"registry">;
+    readonly url: Schema.URLFromString;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"path">;
+    readonly path: Schema.NonEmptyString;
+}>]>;
+export type AgentExtensionSource = Schema.Schema.Type<typeof AgentExtensionSourceSchema>;
+export declare const AgentExtensionRecommendationSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly ref: Schema.String;
+    readonly source: Schema.optionalKey<Schema.Struct<{
+        readonly type: Schema.Literal<"registry">;
+        readonly url: Schema.URLFromString;
+    }>>;
+    readonly versionRange: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "VersionRange">>;
+}>, Schema.Struct<{
+    readonly ref: Schema.String;
+    readonly source: Schema.Struct<{
+        readonly type: Schema.Literal<"git">;
+        readonly url: Schema.URLFromString;
+        readonly path: Schema.optionalKey<Schema.NonEmptyString>;
+        readonly revision: Schema.optionalKey<Schema.NonEmptyString>;
+    }>;
+    readonly versionRange: Schema.optionalKey<Schema.Never>;
+}>, Schema.Struct<{
+    readonly ref: Schema.String;
+    readonly source: Schema.Struct<{
+        readonly type: Schema.Literal<"path">;
+        readonly path: Schema.NonEmptyString;
+    }>;
+    readonly versionRange: Schema.optionalKey<Schema.Never>;
+}>]>;
+export type AgentExtensionRecommendation = Schema.Schema.Type<typeof AgentExtensionRecommendationSchema>;
+export declare const AgentExtensionsMetadataSchema: Schema.Struct<{
+    readonly $schema: Schema.optionalKey<Schema.String>;
+    readonly agentExtensions: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly ref: Schema.String;
+        readonly source: Schema.optionalKey<Schema.Struct<{
+            readonly type: Schema.Literal<"registry">;
+            readonly url: Schema.URLFromString;
+        }>>;
+        readonly versionRange: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "VersionRange">>;
+    }>, Schema.Struct<{
+        readonly ref: Schema.String;
+        readonly source: Schema.Struct<{
+            readonly type: Schema.Literal<"git">;
+            readonly url: Schema.URLFromString;
+            readonly path: Schema.optionalKey<Schema.NonEmptyString>;
+            readonly revision: Schema.optionalKey<Schema.NonEmptyString>;
+        }>;
+        readonly versionRange: Schema.optionalKey<Schema.Never>;
+    }>, Schema.Struct<{
+        readonly ref: Schema.String;
+        readonly source: Schema.Struct<{
+            readonly type: Schema.Literal<"path">;
+            readonly path: Schema.NonEmptyString;
+        }>;
+        readonly versionRange: Schema.optionalKey<Schema.Never>;
+    }>]>>;
+}>;
+export type AgentExtensionsMetadata = Schema.Schema.Type<typeof AgentExtensionsMetadataSchema>;
+//# sourceMappingURL=agent-extensions.d.ts.map

package/dist/src/unstable/recommendations/agent-extensions.js

@@ -0,0 +1,79 @@
+/**
+ * Portable package metadata for recommending agent extensions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { ExtensionFqnSchema } from "../extensions/common.js";
+import { SourceRefSchema, SourceSubPathSchema } from "../sources/types.js";
+import { VersionRangeSchema } from "../version-constraints/version-constraints.js";
+/** The Registry used by portable recommendations that omit an explicit source. */
+export const AGENTXM_REGISTRY_URL = "https://registry.agentxm.ai";
+export const AgentExtensionGitSourceSchema = Schema.Struct({
+    type: Schema.Literal("git"),
+    url: Schema.URLFromString,
+    path: Schema.optionalKey(SourceSubPathSchema),
+    revision: Schema.optionalKey(SourceRefSchema),
+}).annotate({
+    identifier: "AgentExtensionGitSource",
+    title: "Git recommendation source",
+    description: "A self-describing Git locator for a recommended extension.",
+});
+export const AgentExtensionRegistrySourceSchema = Schema.Struct({
+    type: Schema.Literal("registry"),
+    url: Schema.URLFromString,
+}).annotate({
+    identifier: "AgentExtensionRegistrySource",
+    title: "Registry recommendation source",
+    description: "A self-describing Registry locator for a recommended extension.",
+});
+export const AgentExtensionPathSourceSchema = Schema.Struct({
+    type: Schema.Literal("path"),
+    path: Schema.NonEmptyString,
+}).annotate({
+    identifier: "AgentExtensionPathSource",
+    title: "Path recommendation source",
+    description: "A self-describing filesystem locator for a recommended extension.",
+});
+export const AgentExtensionSourceSchema = Schema.Union([
+    AgentExtensionGitSourceSchema,
+    AgentExtensionRegistrySourceSchema,
+    AgentExtensionPathSourceSchema,
+]).annotate({
+    identifier: "AgentExtensionSource",
+    title: "Agent extension recommendation source",
+    description: "A self-describing Git, Registry, or filesystem locator.",
+});
+const RegistryAgentExtensionRecommendationSchema = Schema.Struct({
+    ref: ExtensionFqnSchema,
+    source: Schema.optionalKey(AgentExtensionRegistrySourceSchema),
+    versionRange: Schema.optionalKey(VersionRangeSchema),
+});
+const GitAgentExtensionRecommendationSchema = Schema.Struct({
+    ref: ExtensionFqnSchema,
+    source: AgentExtensionGitSourceSchema,
+    versionRange: Schema.optionalKey(Schema.Never),
+});
+const PathAgentExtensionRecommendationSchema = Schema.Struct({
+    ref: ExtensionFqnSchema,
+    source: AgentExtensionPathSourceSchema,
+    versionRange: Schema.optionalKey(Schema.Never),
+});
+export const AgentExtensionRecommendationSchema = Schema.Union([
+    RegistryAgentExtensionRecommendationSchema,
+    GitAgentExtensionRecommendationSchema,
+    PathAgentExtensionRecommendationSchema,
+]).annotate({
+    identifier: "AgentExtensionRecommendation",
+    title: "Agent extension recommendation",
+    description: "A qualified extension reference with an optional self-describing source. Sourceless entries use the fixed AgentXM Registry; versionRange is valid only for Registry sources.",
+});
+export const AgentExtensionsMetadataSchema = Schema.Struct({
+    $schema: Schema.optionalKey(Schema.String),
+    agentExtensions: Schema.Array(AgentExtensionRecommendationSchema),
+}).annotate({
+    identifier: "AgentExtensionsMetadata",
+    title: "Agent Extensions Metadata",
+    description: "Version 1 of the portable package metadata contract for recommended agent extensions.",
+});
+//# sourceMappingURL=agent-extensions.js.map

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

@@ -38,12 +38,13 @@ type GitScpAddress = {
     readonly host: string;
     readonly path: string;
 };
-/** An `owner/repo[/path]` style pattern containing `/` (not a URL or file path). */
+/** An `owner/repo[//path][@ref]` style pattern containing `/` (not a URL or file path). */
 type SlashPattern = {
     readonly pattern: "slash-pattern";
     readonly first: string;
     readonly second: string;
     readonly third: Option.Option<string>;
+    readonly ref: Option.Option<string>;
 };
 /** A local filesystem path matching `LOCAL_PATH_PATTERN`. */
 type FilePathPattern = {

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

@@ -17,7 +17,7 @@ const LOCAL_PATH_PATTERN = /^(?:\.\.?\/|\/|~\/|~\\|[A-Za-z]:[\\/])/;
 /** SCP-style: `user@host:path` — no `://` scheme. */
 const SCP_PATTERN = /^([^@]+)@([^:]+):(.+)$/;
 /** Known shorthand prefixes. */
-const SHORTHAND_PREFIXES = new Set(["github", "gitlab", "bitbucket"]);
+const SHORTHAND_PREFIXES = new Set(["github", "gitlab", "bitbucket", "azurerepos"]);
 /** Simple name: alphanumeric with hyphens, no leading/trailing hyphen. */
 const NAME_PATTERN = /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/;
 /**
@@ -88,23 +88,33 @@ export const parseInputPattern = (input) => {
     catch {
         // Not a URL
     }
-    // 7. Slash pattern (`owner/repo` or `owner/repo/path`)
+    // 7. Slash pattern (`owner/repo[//path][@ref]`)
     if (input.includes("/")) {
-        const segments = input.split("/");
+        const refIndex = input.lastIndexOf("@");
+        const hasRef = refIndex > 0 && refIndex < input.length - 1;
+        const coordinate = hasRef ? input.slice(0, refIndex) : input;
+        const ref = hasRef ? input.slice(refIndex + 1) : undefined;
+        const subPathIndex = coordinate.indexOf("//");
+        const repositoryCoordinate = subPathIndex < 0 ? coordinate : coordinate.slice(0, subPathIndex);
+        const subPath = subPathIndex < 0 ? undefined : coordinate.slice(subPathIndex + 2);
+        const segments = repositoryCoordinate.split("/");
         const first = segments.at(0);
         const second = segments.at(1);
         if (first !== undefined &&
             second !== undefined &&
-            segments.length >= 2 &&
+            segments.length === 2 &&
             NAME_PATTERN.test(first) &&
             NAME_PATTERN.test(second) &&
-            segments.slice(2).every((s) => s.length > 0 && s !== "..")) {
-            const remaining = segments.slice(2).join("/");
+            (ref === undefined || (ref.length > 0 && !ref.includes("/"))) &&
+            (subPath === undefined ||
+                (subPath.length > 0 &&
+                    subPath.split("/").every((segment) => segment.length > 0 && segment !== "..")))) {
             return Option.some(wrap({
                 pattern: "slash-pattern",
                 first,
                 second,
-                third: remaining.length === 0 ? Option.none() : Option.some(remaining),
+                third: Option.fromUndefinedOr(subPath),
+                ref: Option.fromUndefinedOr(ref),
             }));
         }
         return Option.none();

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

@@ -6,7 +6,7 @@
  */
 import * as Option from "effect/Option";
 import { formatFqn } from "../extensions/fqn.js";
-import { printAzureReposSource, printBitbucketSource, printGitHubSource, printGitLabSource, printLocalSource, } from "./forge-grammar.js";
+import { printLocalSource } from "./forge-grammar.js";
 /**
  * Print source params as their canonical shorthand string.
  *
@@ -14,17 +14,40 @@ import { printAzureReposSource, printBitbucketSource, printGitHubSource, printGi
  */
 export const printSourceParams = (source) => {
     switch (source.type) {
-        case "github":
-            return printGitHubSource(source, source.sourceName ?? ("name" in source ? String(source.name) : "github"));
-        case "gitlab":
-            return printGitLabSource(source, source.sourceName ?? ("name" in source ? String(source.name) : "gitlab"));
-        case "bitbucket":
-            return printBitbucketSource(source, source.sourceName ?? ("name" in source ? String(source.name) : "bitbucket"));
-        case "azurerepos":
-            return printAzureReposSource(source, source.sourceName ?? ("name" in source ? String(source.name) : "azurerepos"));
         case "local":
             return printLocalSource(source);
         case "git": {
+            const repositorySegments = source.url.pathname
+                .split("/")
+                .filter((segment) => segment.length > 0);
+            if (source.url.hostname === "dev.azure.com" &&
+                repositorySegments.length === 4 &&
+                repositorySegments[2] === "_git") {
+                let shorthand = `azurerepos:${repositorySegments[0]}/${repositorySegments[1]}/${repositorySegments[3]}`;
+                if (Option.isSome(source.subPath))
+                    shorthand += `//${source.subPath.value}`;
+                if (Option.isSome(source.ref))
+                    shorthand += `@${source.ref.value}`;
+                return shorthand;
+            }
+            const lastSegment = repositorySegments.at(-1);
+            const repo = lastSegment?.endsWith(".git") ? lastSegment.slice(0, -4) : lastSegment;
+            const sourcePrefix = source.url.hostname === "github.com"
+                ? "github"
+                : source.url.hostname === "gitlab.com"
+                    ? "gitlab"
+                    : source.url.hostname === "bitbucket.org"
+                        ? "bitbucket"
+                        : undefined;
+            if (sourcePrefix !== undefined && repo !== undefined && repositorySegments.length >= 2) {
+                const owner = repositorySegments.slice(0, -1).join("/");
+                let shorthand = `${sourcePrefix}:${owner}/${repo}`;
+                if (Option.isSome(source.subPath))
+                    shorthand += `//${source.subPath.value}`;
+                if (Option.isSome(source.ref))
+                    shorthand += `@${source.ref.value}`;
+                return shorthand;
+            }
             const url = new URL(source.url.href);
             url.hash = Option.getOrElse(source.ref, () => "");
             return url.href;

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

@@ -11,10 +11,6 @@ import type { Handle } from "../extensions/handle.js";
 /**
  * Source type discriminator for extension origins.
  *
- * - `"github"` - GitHub repository source
- * - `"gitlab"` - GitLab repository source
- * - `"bitbucket"` - Bitbucket repository source
- * - `"azurerepos"` - Azure Repos repository source
  * - `"git"` - Generic git repository source
  * - `"registry"` - Package registry source
  * - `"local"` - Local filesystem path source
@@ -23,7 +19,7 @@ import type { Handle } from "../extensions/handle.js";
  *
  * @experimental
  */
-export declare const SourceTypeSchema: Schema.Literals<readonly ["github", "gitlab", "bitbucket", "azurerepos", "git", "registry", "local", "inline", "workspace"]>;
+export declare const SourceTypeSchema: Schema.Literals<readonly ["git", "registry", "local", "inline", "workspace"]>;
 /**
  * Inferred type for SourceTypeSchema.
  *
@@ -102,29 +98,6 @@ export declare const AzureReposSourceParamsSchema: Schema.Struct<{
     readonly type: Schema.Literal<"azurerepos">;
 }>;
 /** @experimental */
-export interface GitHubSourceHost {
-    readonly type: "github";
-    readonly name: string;
-    readonly url: URL;
-}
-/** @experimental */
-export interface GitLabSourceHost {
-    readonly type: "gitlab";
-    readonly name: string;
-    readonly url: URL;
-}
-/** @experimental */
-export interface BitbucketSourceHost {
-    readonly type: "bitbucket";
-    readonly name: string;
-    readonly url: URL;
-}
-/** @experimental */
-export interface AzureReposSourceHost {
-    readonly type: "azurerepos";
-    readonly name: string;
-    readonly url: URL;
-}
 /** Self-describing — the git URL lives in SourceParams. @experimental */
 export interface GitSourceHost {
     readonly type: "git";
@@ -151,7 +124,7 @@ export interface WorkspaceSourceHost {
     readonly type: "workspace";
 }
 /** @experimental */
-export type SourceHost = GitHubSourceHost | GitLabSourceHost | BitbucketSourceHost | AzureReposSourceHost | GitSourceHost | RegistrySourceHost | LocalSourceHost | InlineSourceHost | WorkspaceSourceHost;
+export type SourceHost = GitSourceHost | RegistrySourceHost | LocalSourceHost | InlineSourceHost | WorkspaceSourceHost;
 /** @experimental */
 export interface GitHubSourceParams {
     readonly type: "github";
@@ -198,6 +171,7 @@ export interface GitSourceParams {
     readonly type: "git";
     readonly url: URL;
     readonly ref: Option.Option<string>;
+    readonly subPath: Option.Option<string>;
 }
 /** @experimental */
 export interface RegistrySourceParams {
@@ -226,15 +200,7 @@ export interface WorkspaceSourceParams {
     readonly name: ExtensionName;
 }
 /** @experimental */
-export type SourceParams = GitHubSourceParams | GitLabSourceParams | BitbucketSourceParams | AzureReposSourceParams | GitSourceParams | RegistrySourceParams | LocalSourceParams | InlineSourceParams | WorkspaceSourceParams;
-/** @experimental */
-export type GitHubSource = GitHubSourceHost & GitHubSourceParams;
-/** @experimental */
-export type GitLabSource = GitLabSourceHost & GitLabSourceParams;
-/** @experimental */
-export type BitbucketSource = BitbucketSourceHost & BitbucketSourceParams;
-/** @experimental */
-export type AzureReposSource = AzureReposSourceHost & AzureReposSourceParams;
+export type SourceParams = GitSourceParams | RegistrySourceParams | LocalSourceParams | InlineSourceParams | WorkspaceSourceParams;
 /** @experimental */
 export type InlineSource = InlineSourceHost & InlineSourceParams;
 /** @experimental */
@@ -246,17 +212,11 @@ export type LocalSource = LocalSourceHost & LocalSourceParams;
 /** @experimental */
 export type WorkspaceSource = WorkspaceSourceHost & WorkspaceSourceParams;
 /** @experimental */
-export type Source = GitHubSource | GitLabSource | BitbucketSource | AzureReposSource | GitSource | RegistrySource | LocalSource | WorkspaceSource;
-/** Git hosting providers that require a configured URL. @experimental */
-export type GitHostingSourceHost = GitHubSourceHost | GitLabSourceHost | BitbucketSourceHost | AzureReposSourceHost;
-/** @experimental */
-export type GitHostingSourceParams = GitHubSourceParams | GitLabSourceParams | BitbucketSourceParams | AzureReposSourceParams;
-/** @experimental */
-export type GitHostingSource = GitHubSource | GitLabSource | BitbucketSource | AzureReposSource;
-/** All git-based sources (hosting providers + generic git). @experimental */
-export type GitBasedSource = GitHostingSource | GitSource;
+export type Source = GitSource | RegistrySource | LocalSource | WorkspaceSource;
+/** All git-based sources. Hosted-provider syntax expands to this source. @experimental */
+export type GitBasedSource = GitSource;
 /** Sources that require host configuration from settings. @experimental */
-export type ConfiguredSourceHost = GitHostingSourceHost | RegistrySourceHost;
+export type ConfiguredSourceHost = RegistrySourceHost;
 /** Sources that are self-describing (no settings config needed). @experimental */
 export type SelfDescribingSourceHost = GitSourceHost | LocalSourceHost;
 //# sourceMappingURL=types.d.ts.map

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

@@ -11,10 +11,6 @@ import * as Schema from "effect/Schema";
 /**
  * Source type discriminator for extension origins.
  *
- * - `"github"` - GitHub repository source
- * - `"gitlab"` - GitLab repository source
- * - `"bitbucket"` - Bitbucket repository source
- * - `"azurerepos"` - Azure Repos repository source
  * - `"git"` - Generic git repository source
  * - `"registry"` - Package registry source
  * - `"local"` - Local filesystem path source
@@ -24,10 +20,6 @@ import * as Schema from "effect/Schema";
  * @experimental
  */
 export const SourceTypeSchema = Schema.Literals([
-    "github",
-    "gitlab",
-    "bitbucket",
-    "azurerepos",
     "git",
     "registry",
     "local",
@@ -36,7 +28,7 @@ export const SourceTypeSchema = Schema.Literals([
 ]).annotate({
     identifier: "SourceType",
     title: "Source Type",
-    description: "Source type discriminator: github, gitlab, bitbucket, azurerepos, git, registry, local, inline, or workspace.",
+    description: "Source type discriminator: git, registry, local, inline, or workspace.",
 });
 // -----------------------------------------------------------------------------
 // Ref Type Schema

package/dist/src/unstable/workspace-scope.d.ts

@@ -1,5 +1,5 @@
 /**
- * WorkspaceMutations scope helpers for CLI flags and workspace options.
+ * Workspace scope helpers for CLI flags and workspace options.
  *
  * `project` uses the project root; `user` uses `~/.axm/workspace/`.
  *

package/dist/src/unstable/workspace-scope.js

@@ -1,5 +1,5 @@
 /**
- * WorkspaceMutations scope helpers for CLI flags and workspace options.
+ * Workspace scope helpers for CLI flags and workspace options.
  *
  * `project` uses the project root; `user` uses `~/.axm/workspace/`.
  *

package/package.json

@@ -11,7 +11,7 @@
   },
   "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.31.1",
+    "@agentxm/specification-metadata": "0.32.0",
     "@effect/vitest": "4.0.0-rc.115",
     "@fast-check/vitest": "^0.5.0",
     "@types/semver": "^7.7.1",
@@ -40,6 +40,10 @@
       "types": "./dist/src/unstable/agent-capabilities/identity.d.ts",
       "default": "./dist/src/unstable/agent-capabilities/identity.js"
     },
+    "./unstable/agent-capabilities/schema": {
+      "types": "./dist/src/unstable/agent-capabilities/schema.d.ts",
+      "default": "./dist/src/unstable/agent-capabilities/schema.js"
+    },
     "./unstable/agents/registry": {
       "types": "./dist/src/unstable/agents/registry.d.ts",
       "default": "./dist/src/unstable/agents/registry.js"
@@ -84,6 +88,10 @@
       "types": "./dist/src/unstable/extensions/common.d.ts",
       "default": "./dist/src/unstable/extensions/common.js"
     },
+    "./unstable/extensions/archival": {
+      "types": "./dist/src/unstable/extensions/archival.d.ts",
+      "default": "./dist/src/unstable/extensions/archival.js"
+    },
     "./unstable/extensions/deprecation": {
       "types": "./dist/src/unstable/extensions/deprecation.d.ts",
       "default": "./dist/src/unstable/extensions/deprecation.js"
@@ -208,9 +216,9 @@
       "types": "./dist/src/unstable/path-types.d.ts",
       "default": "./dist/src/unstable/path-types.js"
     },
-    "./unstable/release-channel": {
-      "types": "./dist/src/unstable/release-channel.d.ts",
-      "default": "./dist/src/unstable/release-channel.js"
+    "./unstable/recommendations/agent-extensions": {
+      "types": "./dist/src/unstable/recommendations/agent-extensions.d.ts",
+      "default": "./dist/src/unstable/recommendations/agent-extensions.js"
     },
     "./unstable/rules/manifest-schema": {
       "types": "./dist/src/unstable/rules/manifest-schema.d.ts",
@@ -297,5 +305,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.31.1"
+  "version": "0.32.0"
 }