@agentxm/extension-model 0.34.0 → 0.36.0

package/dist/src/unstable/agent-capabilities/derive.js

@@ -5,7 +5,7 @@
  */
 import { PER_AGENT_EXTENSION_TYPES } from "../extensions/common.js";
 import { AGENTS } from "./catalog.js";
-import { CONFIGURABLE_AGENT_IDS } from "./identity.js";
+import { isConfigurableAgentId } from "./identity.js";
 import { LEAF_EXTENSION_TYPES } from "../extension-types/schema.js";
 import { SUPPORTED_AXM_SUPPORT, } from "./schema.js";
 import {} from "../extensions/common.js";
@@ -43,8 +43,6 @@ const capabilityForType = (agent, type) => {
         return agent.capabilities[type];
     return undefined;
 };
-const configurableAgentIds = new Set(CONFIGURABLE_AGENT_IDS);
-const isConfigurableAgentId = (id) => configurableAgentIds.has(id);
 const deriveAgentId = (agent) => {
     if (isConfigurableAgentId(agent.id))
         return agent.id;

package/dist/src/unstable/agent-capabilities/identity.d.ts

@@ -5,6 +5,8 @@ export declare const CONFIGURABLE_AGENT_IDS: readonly ["adal", "aider-desk", "am
 /** @experimental This API is unstable and may change without notice. */
 export type ConfigurableAgentId = (typeof CONFIGURABLE_AGENT_IDS)[number];
 /** @experimental This API is unstable and may change without notice. */
+export declare const isConfigurableAgentId: (id: string) => id is ConfigurableAgentId;
+/** @experimental This API is unstable and may change without notice. */
 export declare const HOSTED_AGENT_IDS: readonly ["chatgpt", "claude-ai", "cowork", "gemini-app"];
 /** @experimental This API is unstable and may change without notice. */
 export type HostedAgentId = (typeof HOSTED_AGENT_IDS)[number];

package/dist/src/unstable/agent-capabilities/identity.js

@@ -65,6 +65,9 @@ export const CONFIGURABLE_AGENT_IDS = [
     "zed",
     "zenflow",
 ];
+const configurableAgentIdSet = new Set(CONFIGURABLE_AGENT_IDS);
+/** @experimental This API is unstable and may change without notice. */
+export const isConfigurableAgentId = (id) => configurableAgentIdSet.has(id);
 /** @experimental This API is unstable and may change without notice. */
 export const HOSTED_AGENT_IDS = ["chatgpt", "claude-ai", "cowork", "gemini-app"];
 /** @experimental This API is unstable and may change without notice. */

package/dist/src/unstable/agent-capabilities/index.d.ts

@@ -11,6 +11,6 @@ export { STANDARDS } from "../extension-types/standards.js";
 export { CAPABILITY_VERIFICATION_BUDGET_DAYS, capabilityVerificationAgeReport, type AgentCapabilitySlot, type CapabilityVerificationAge, } from "./verification.js";
 export { agentCapabilityStatus, agentSupportsType, axmIntegrationStatus, canonicalCoverage, deriveAgentDescriptor, deriveSkillConvention, deriveHookPortability, getSupportedAgentsForExtension, getSupportedAgentsForExtensionType, getSupportedAgentsForExtensionTypes, getSupportedExtensionTypesForAgent, isCapabilitySupported, isLeafExtensionType, listCapabilities, installable, toNativeAgent, type AgentCapabilityStatus, type AxmIntegrationStatus, type CapabilityListing, type ExtensionCompatibilityInput, type HookDecisionKind, type HookDecisionRequirement, type HookInstallabilityVerdict, type HookInstallBinding, type HookPortabilityRequirement, type HookPortabilityVerdict, type NativeAgent, type NativeAgentCapabilities, } from "./derive.js";
 export { AGENTS, AGENTS_BY_ID, CONFIGURABLE_AGENTS_BY_ID, HOSTED_AGENTS_BY_ID } from "./catalog.js";
-export { AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENT_IDS, HOSTED_AGENT_IDS, type AgentId, type ConfigurableAgentId, type HostedAgentId, } from "./identity.js";
+export { AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENT_IDS, HOSTED_AGENT_IDS, isConfigurableAgentId, type AgentId, type ConfigurableAgentId, type HostedAgentId, } from "./identity.js";
 export { agentById } from "./lookup.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/agent-capabilities/index.js

@@ -11,6 +11,6 @@ export { STANDARDS } from "../extension-types/standards.js";
 export { CAPABILITY_VERIFICATION_BUDGET_DAYS, capabilityVerificationAgeReport, } from "./verification.js";
 export { agentCapabilityStatus, agentSupportsType, axmIntegrationStatus, canonicalCoverage, deriveAgentDescriptor, deriveSkillConvention, deriveHookPortability, getSupportedAgentsForExtension, getSupportedAgentsForExtensionType, getSupportedAgentsForExtensionTypes, getSupportedExtensionTypesForAgent, isCapabilitySupported, isLeafExtensionType, listCapabilities, installable, toNativeAgent, } from "./derive.js";
 export { AGENTS, AGENTS_BY_ID, CONFIGURABLE_AGENTS_BY_ID, HOSTED_AGENTS_BY_ID } from "./catalog.js";
-export { AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENT_IDS, HOSTED_AGENT_IDS, } from "./identity.js";
+export { AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENT_IDS, HOSTED_AGENT_IDS, isConfigurableAgentId, } from "./identity.js";
 export { agentById } from "./lookup.js";
 //# sourceMappingURL=index.js.map

package/dist/src/unstable/agents/registry.d.ts

@@ -6,28 +6,14 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-import { type AgentId, type AgentRegistry } from "./types.js";
+import type { AgentRegistry } from "./types.js";
 /**
- * Complete registry of all known AI coding agents.
+ * Derived descriptors for all known AI coding agents, including the synthetic universal target.
  *
  * Keys are agent IDs, values are full descriptor objects.
  * Paths are pre-expanded at module initialization.
  *
  * @experimental This API is unstable and may change without notice.
  */
-export declare const AGENTS: AgentRegistry;
-/**
- * Get all registered agent IDs.
- *
- * @returns Array of all agent identifiers
- *
- * @example
- * ```typescript
- * const ids = getAgentIds();
- * // ["adal", "amp", "antigravity", "augment", "claude-code", ...]
- * ```
- *
- * @experimental This API is unstable and may change without notice.
- */
-export declare const getAgentIds: () => ReadonlyArray<AgentId>;
+export declare const AGENT_DESCRIPTORS: AgentRegistry;
 //# sourceMappingURL=registry.d.ts.map

package/dist/src/unstable/agents/registry.js

@@ -10,7 +10,6 @@ import * as Record from "effect/Record";
 import { CONFIGURABLE_AGENTS_BY_ID } from "../agent-capabilities/catalog.js";
 import { deriveAgentDescriptor } from "../agent-capabilities/derive.js";
 import { UNIVERSAL_SKILLS_DIR } from "../extensions/universal-skills-dir.js";
-import { AGENT_IDS } from "./types.js";
 const UNIVERSAL_AGENT_DESCRIPTOR = {
     id: "universal",
     name: "Universal",
@@ -22,29 +21,15 @@ const UNIVERSAL_AGENT_DESCRIPTOR = {
     detection: { project: { markers: [] }, user: { markers: [] } },
 };
 /**
- * Complete registry of all known AI coding agents.
+ * Derived descriptors for all known AI coding agents, including the synthetic universal target.
  *
  * Keys are agent IDs, values are full descriptor objects.
  * Paths are pre-expanded at module initialization.
  *
  * @experimental This API is unstable and may change without notice.
  */
-export const AGENTS = {
+export const AGENT_DESCRIPTORS = {
     ...Record.map(CONFIGURABLE_AGENTS_BY_ID, deriveAgentDescriptor),
     universal: UNIVERSAL_AGENT_DESCRIPTOR,
 };
-/**
- * Get all registered agent IDs.
- *
- * @returns Array of all agent identifiers
- *
- * @example
- * ```typescript
- * const ids = getAgentIds();
- * // ["adal", "amp", "antigravity", "augment", "claude-code", ...]
- * ```
- *
- * @experimental This API is unstable and may change without notice.
- */
-export const getAgentIds = () => AGENT_IDS;
 //# sourceMappingURL=registry.js.map

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

@@ -74,12 +74,10 @@ export interface AgentDetectionDescriptor {
 }
 /** @experimental This API is unstable and may change without notice. */
 export { CONFIGURABLE_AGENT_IDS, type ConfigurableAgentId };
+/** Configurable agents plus the synthetic universal materialization target. @experimental */
+export declare const MATERIALIZATION_TARGET_IDS: readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow", "universal"];
 /** @experimental This API is unstable and may change without notice. */
-export declare const AGENT_IDS: readonly ["adal", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow", "universal"];
-/** @experimental This API is unstable and may change without notice. */
-export type AgentId = (typeof AGENT_IDS)[number];
-/** @experimental This API is unstable and may change without notice. */
-export declare const isConfigurableAgentId: (id: AgentId) => id is ConfigurableAgentId;
+export type MaterializationTargetId = (typeof MATERIALIZATION_TARGET_IDS)[number];
 /**
  * Configuration for an AI coding agent.
  *
@@ -87,7 +85,7 @@ export declare const isConfigurableAgentId: (id: AgentId) => id is ConfigurableA
  */
 export interface AgentDescriptor {
     /** Unique identifier (e.g., "claude-code") */
-    readonly id: AgentId;
+    readonly id: MaterializationTargetId;
     /** Human-readable display name (e.g., "Claude Code") */
     readonly name: string;
     /**
@@ -122,5 +120,5 @@ export interface AgentDescriptor {
  *
  * @experimental This API is unstable and may change without notice.
  */
-export type AgentRegistry = Record.ReadonlyRecord<AgentId, AgentDescriptor>;
+export type AgentRegistry = Record.ReadonlyRecord<MaterializationTargetId, AgentDescriptor>;
 //# sourceMappingURL=types.d.ts.map

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

@@ -10,8 +10,6 @@ import { CONFIGURABLE_AGENT_IDS, } from "../agent-capabilities/identity.js";
 // -----------------------------------------------------------------------------
 /** @experimental This API is unstable and may change without notice. */
 export { CONFIGURABLE_AGENT_IDS };
-/** @experimental This API is unstable and may change without notice. */
-export const AGENT_IDS = [...CONFIGURABLE_AGENT_IDS, "universal"];
-/** @experimental This API is unstable and may change without notice. */
-export const isConfigurableAgentId = (id) => id !== "universal";
+/** Configurable agents plus the synthetic universal materialization target. @experimental */
+export const MATERIALIZATION_TARGET_IDS = [...CONFIGURABLE_AGENT_IDS, "universal"];
 //# sourceMappingURL=types.js.map

package/dist/src/unstable/extensions/common.d.ts

@@ -427,6 +427,26 @@ export type ExtensionFqnParts = Schema.Schema.Type<typeof ExtensionFqnPartsSchem
  * @experimental This API is unstable and may change without notice.
  */
 export declare const parseExtensionFqnParts: (input: string) => ExtensionFqnParts | undefined;
+/**
+ * A reference split into the name it identifies and the constraint appended
+ * to it. The constraint is everything after the first `@` that follows the
+ * last `/`, because the owner segment also starts with `@`; a trailing `@`
+ * yields an empty constraint for the caller to reject.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SplitExtensionReference {
+    readonly name: string;
+    readonly constraint: string | undefined;
+}
+/**
+ * Split `@owner/<plural>/name[@constraint]` into its name and constraint.
+ * This is the one place the separator between a name and its constraint is
+ * decided.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const splitExtensionReference: (input: string) => SplitExtensionReference;
 /**
  * Parse an extension spec string (with optional version constraint) into parts.
  * Strips the version constraint suffix and returns the validated FQN parts.
@@ -477,14 +497,6 @@ export declare const PackFqnSchema: Schema.String;
  * @experimental This API is unstable and may change without notice.
  */
 export type PackFqn = Schema.Schema.Type<typeof PackFqnSchema>;
-/**
- * Extension spec — fully qualified extension name with an optional version
- * constraint suffix. Accepts `@owner/type/name` or `@owner/type/name@constraint`
- * where the FQN portion validates through ExtensionFqnSchema and the optional
- * constraint validates as a semver VersionRange.
- *
- * @experimental This API is unstable and may change without notice.
- */
 export declare const ExtensionSpecSchema: Schema.brand<Schema.NonEmptyString, "ExtensionSpec">;
 /**
  * Inferred type for ExtensionSpec schema.

package/dist/src/unstable/extensions/common.js

@@ -360,17 +360,26 @@ export const parseExtensionFqnParts = (input) => {
     return Result.isSuccess(result) ? result.success : undefined;
 };
 /**
- * Parse an extension spec string (with optional version constraint) into parts.
- * Strips the version constraint suffix and returns the validated FQN parts.
+ * Split `@owner/<plural>/name[@constraint]` into its name and constraint.
+ * This is the one place the separator between a name and its constraint is
+ * decided.
  *
  * @experimental This API is unstable and may change without notice.
  */
-export const parseExtensionSpecParts = (input) => {
+export const splitExtensionReference = (input) => {
     const lastSlash = input.lastIndexOf("/");
     const constraintAt = lastSlash > 0 ? input.indexOf("@", lastSlash + 1) : -1;
-    const fqnPart = constraintAt > 0 ? input.slice(0, constraintAt) : input;
-    return parseExtensionFqnParts(fqnPart);
+    return constraintAt > 0
+        ? { name: input.slice(0, constraintAt), constraint: input.slice(constraintAt + 1) }
+        : { name: input, constraint: undefined };
 };
+/**
+ * Parse an extension spec string (with optional version constraint) into parts.
+ * Strips the version constraint suffix and returns the validated FQN parts.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseExtensionSpecParts = (input) => parseExtensionFqnParts(splitExtensionReference(input).name);
 const INVALID_EXTENSION_FQN_MESSAGE = "Expected fully qualified name in @handle/(skills|mcps|subagents|rules|hooks|knowledge|packs)/name form";
 /**
  * Fully qualified name string schema validated against the composed handle,
@@ -425,24 +434,21 @@ export const PackFqnSchema = Schema.String.pipe(Schema.check(Schema.isPattern(PA
  *
  * @experimental This API is unstable and may change without notice.
  */
+/** The constraint issue of a split reference, or none when it has none or it is valid. */
+const constraintIssue = (constraint) => {
+    if (constraint === undefined)
+        return undefined;
+    const constraintResult = Schema.decodeUnknownResult(VersionRangeSchema)(constraint);
+    return Result.isFailure(constraintResult)
+        ? `Expected valid version constraint after @, got: ${constraint}`
+        : undefined;
+};
 export const ExtensionSpecSchema = Schema.NonEmptyString.pipe(Schema.check(Schema.makeFilter((value) => {
-    // Find the constraint separator: the @ after the last slash
-    const lastSlash = value.lastIndexOf("/");
-    const constraintAt = lastSlash > 0 ? value.indexOf("@", lastSlash + 1) : -1;
-    const fqnPart = constraintAt > 0 ? value.slice(0, constraintAt) : value;
-    const constraintPart = constraintAt > 0 ? value.slice(constraintAt + 1) : undefined;
-    // Validate FQN portion
-    if (parseExtensionFqnParts(fqnPart) === undefined) {
+    const { name, constraint } = splitExtensionReference(value);
+    if (parseExtensionFqnParts(name) === undefined) {
         return `Expected extension spec in @handle/type/name[@constraint] form, got: ${value}`;
     }
-    // Validate constraint portion if present
-    if (constraintPart !== undefined) {
-        const constraintResult = Schema.decodeUnknownResult(VersionRangeSchema)(constraintPart);
-        if (Result.isFailure(constraintResult)) {
-            return `Expected valid version constraint after @, got: ${constraintPart}`;
-        }
-    }
-    return undefined;
+    return constraintIssue(constraint);
 })), Schema.check(Schema.isPattern(EXTENSION_SPEC_PATTERN, {
     message: "Expected extension spec in @handle/type/name[@constraint] form",
 })), Schema.annotate({
@@ -460,20 +466,11 @@ export const ExtensionSpecSchema = Schema.NonEmptyString.pipe(Schema.check(Schem
  * @experimental This API is unstable and may change without notice.
  */
 export const PackSpecSchema = Schema.NonEmptyString.pipe(Schema.check(Schema.makeFilter((value) => {
-    const lastSlash = value.lastIndexOf("/");
-    const constraintAt = lastSlash > 0 ? value.indexOf("@", lastSlash + 1) : -1;
-    const fqnPart = constraintAt > 0 ? value.slice(0, constraintAt) : value;
-    const constraintPart = constraintAt > 0 ? value.slice(constraintAt + 1) : undefined;
-    if (!PACK_FQN_PATTERN.test(fqnPart)) {
+    const { name, constraint } = splitExtensionReference(value);
+    if (!PACK_FQN_PATTERN.test(name)) {
         return `Expected pack spec in @handle/packs/name[@constraint] form, got: ${value}`;
     }
-    if (constraintPart !== undefined) {
-        const constraintResult = Schema.decodeUnknownResult(VersionRangeSchema)(constraintPart);
-        if (Result.isFailure(constraintResult)) {
-            return `Expected valid version constraint after @, got: ${constraintPart}`;
-        }
-    }
-    return undefined;
+    return constraintIssue(constraint);
 })), Schema.check(Schema.isPattern(PACK_SPEC_PATTERN, {
     message: "Expected pack spec in @handle/packs/name[@constraint] form",
 })), Schema.annotate({

package/dist/src/unstable/extensions/deprecation.d.ts

@@ -9,6 +9,9 @@
  * @experimental This API is unstable and may change without notice.
  */
 import * as Schema from "effect/Schema";
+export declare const DeprecationReasons: readonly ["superseded", "obsolete", "unmaintained", "other"];
+export declare const DeprecationReasonSchema: Schema.Literals<readonly ["superseded", "obsolete", "unmaintained", "other"]>;
+export type DeprecationReason = typeof DeprecationReasonSchema.Type;
 export declare const DeprecationReplacementSchema: Schema.Union<readonly [Schema.Struct<{
     readonly status: Schema.Literal<"available">;
     readonly fqn: Schema.String;
@@ -18,7 +21,24 @@ export declare const DeprecationReplacementSchema: Schema.Union<readonly [Schema
 }>]>;
 export declare const DeprecationViewSchema: Schema.Union<readonly [Schema.Struct<{
     readonly deprecatedAt: Schema.decodeTo<Schema.DateTimeUtc, Schema.String, never, never>;
+    readonly reason: Schema.Literal<"superseded">;
+    readonly message: Schema.optional<Schema.String>;
+    readonly replacement: Schema.Union<readonly [Schema.Struct<{
+        readonly status: Schema.Literal<"available">;
+        readonly fqn: Schema.String;
+    }>, Schema.Struct<{
+        readonly status: Schema.Literal<"unavailable">;
+        readonly fqn: Schema.optional<Schema.String>;
+    }>]>;
+}>, Schema.Struct<{
+    readonly deprecatedAt: Schema.decodeTo<Schema.DateTimeUtc, Schema.String, never, never>;
+    readonly reason: Schema.Literal<"obsolete">;
     readonly message: Schema.String;
+    readonly replacement: Schema.optional<Schema.Never>;
+}>, Schema.Struct<{
+    readonly deprecatedAt: Schema.decodeTo<Schema.DateTimeUtc, Schema.String, never, never>;
+    readonly reason: Schema.Literal<"unmaintained">;
+    readonly message: Schema.optional<Schema.String>;
     readonly replacement: Schema.optional<Schema.Union<readonly [Schema.Struct<{
         readonly status: Schema.Literal<"available">;
         readonly fqn: Schema.String;
@@ -28,14 +48,15 @@ export declare const DeprecationViewSchema: Schema.Union<readonly [Schema.Struct
     }>]>>;
 }>, Schema.Struct<{
     readonly deprecatedAt: Schema.decodeTo<Schema.DateTimeUtc, Schema.String, never, never>;
-    readonly message: Schema.optional<Schema.String>;
-    readonly replacement: Schema.Union<readonly [Schema.Struct<{
+    readonly reason: Schema.Literal<"other">;
+    readonly message: Schema.String;
+    readonly replacement: Schema.optional<Schema.Union<readonly [Schema.Struct<{
         readonly status: Schema.Literal<"available">;
         readonly fqn: Schema.String;
     }>, Schema.Struct<{
         readonly status: Schema.Literal<"unavailable">;
         readonly fqn: Schema.optional<Schema.String>;
-    }>]>;
+    }>]>>;
 }>]>;
 export type DeprecationReplacement = typeof DeprecationReplacementSchema.Type;
 export type DeprecationView = typeof DeprecationViewSchema.Type;

package/dist/src/unstable/extensions/deprecation.js

@@ -13,7 +13,12 @@ import { DateTimeUtcSchema } from "../date-time.js";
 import { ExtensionFqnSchema } from "./common.js";
 const DeprecationMessageSchema = Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(500)).annotate({
     identifier: "DeprecationMessage",
-    description: "Concise publisher guidance for consumers of a deprecated extension.",
+    description: "Optional publisher notes for consumers of a deprecated extension.",
+});
+export const DeprecationReasons = ["superseded", "obsolete", "unmaintained", "other"];
+export const DeprecationReasonSchema = Schema.Literals(DeprecationReasons).annotate({
+    identifier: "DeprecationReason",
+    description: "The publisher's structured reason for deprecating an extension.",
 });
 export const DeprecationReplacementSchema = Schema.Union([
     Schema.Struct({
@@ -31,13 +36,27 @@ export const DeprecationReplacementSchema = Schema.Union([
 export const DeprecationViewSchema = Schema.Union([
     Schema.Struct({
         deprecatedAt: DateTimeUtcSchema,
+        reason: Schema.Literal("superseded"),
+        message: Schema.optional(DeprecationMessageSchema),
+        replacement: DeprecationReplacementSchema,
+    }),
+    Schema.Struct({
+        deprecatedAt: DateTimeUtcSchema,
+        reason: Schema.Literal("obsolete"),
         message: DeprecationMessageSchema,
-        replacement: Schema.optional(DeprecationReplacementSchema),
+        replacement: Schema.optional(Schema.Never),
     }),
     Schema.Struct({
         deprecatedAt: DateTimeUtcSchema,
+        reason: Schema.Literal("unmaintained"),
         message: Schema.optional(DeprecationMessageSchema),
-        replacement: DeprecationReplacementSchema,
+        replacement: Schema.optional(DeprecationReplacementSchema),
+    }),
+    Schema.Struct({
+        deprecatedAt: DateTimeUtcSchema,
+        reason: Schema.Literal("other"),
+        message: DeprecationMessageSchema,
+        replacement: Schema.optional(DeprecationReplacementSchema),
     }),
 ]).annotate({
     identifier: "DeprecationView",

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

@@ -3,7 +3,7 @@
  *
  * @experimental This API is unstable and may change without notice.
  */
-export { AgentIdSchema, type Author, AuthorSchema, CONTAINER_EXTENSION_TYPES, CommonManifestBaseFields, type ConfigurableAgentId, ConfigurableAgentIdSchema, type ContainerType, EXTENSION_NAME_PATTERN, INSTALLABLE_FROM_BY_TYPE, type ExtensionDependencyConstraintMap, ExtensionDependencyConstraintMapSchema, type ExtensionFqn, type ExtensionFqnParts, ExtensionFqnPartsSchema, ExtensionFqnSchema, type ExtensionName, ExtensionNameSchema, type ExtensionSpec, ExtensionSpecSchema, type ExtensionSourceFamily, type ExtensionType, type ExtensionTypePlural, ExtensionTypePluralSchema, ExtensionTypeSchema, type ExtensionVisibility, ExtensionVisibilitySchema, FQN_PATTERN, LicenseSchema, NON_PACK_FQN_PATTERN, type NonPackExtensionDependencyConstraintMap, NonPackExtensionDependencyConstraintMapSchema, type NonPackExtensionFqn, NonPackExtensionFqnSchema, type NonPackExtensionTypePlural, NonPackManifestFields, PACK_FQN_PATTERN, PER_AGENT_EXTENSION_TYPES, type PackFqn, PackFqnSchema, type PackMemberConstraint, PackMemberConstraintMapSchema, PackMemberConstraintSchema, type PackMemberConstraintMap, type PackMemberRegistrySource, PackMemberRegistrySourceSchema, packMemberRegistrySource, packMemberVersionRange, type PackSpec, PackSpecSchema, type PerAgentType, type PublishOptions, PublishOptionsSchema, type WorkspaceCapabilityType, decodeExtensionNameSync, extensionTypeFromPlural, extensionTypeLabels, extensionTypePluralLabels, extensionTypePluralSegments, extensionTypePluralSentenceLabels, extensionTypeSentenceLabels, extensionTypeToPlural, extensionTypes, extensionSourceFamilies, extensionTypesInstallableFrom, isInstallableFrom, isExtensionType, isExtensionTypePlural, nonPackExtensionTypePluralSegments, parseExtensionFqnParts, parseExtensionSpecParts, toAuthor, toExtensionType, toExtensionTypePlural, } from "./common.js";
+export { AgentIdSchema, type Author, AuthorSchema, CONTAINER_EXTENSION_TYPES, CommonManifestBaseFields, type ConfigurableAgentId, ConfigurableAgentIdSchema, type ContainerType, EXTENSION_NAME_PATTERN, INSTALLABLE_FROM_BY_TYPE, type ExtensionDependencyConstraintMap, ExtensionDependencyConstraintMapSchema, type ExtensionFqn, type ExtensionFqnParts, ExtensionFqnPartsSchema, ExtensionFqnSchema, type ExtensionName, ExtensionNameSchema, type ExtensionSpec, ExtensionSpecSchema, type ExtensionSourceFamily, type ExtensionType, type ExtensionTypePlural, ExtensionTypePluralSchema, ExtensionTypeSchema, type ExtensionVisibility, ExtensionVisibilitySchema, FQN_PATTERN, LicenseSchema, NON_PACK_FQN_PATTERN, type NonPackExtensionDependencyConstraintMap, NonPackExtensionDependencyConstraintMapSchema, type NonPackExtensionFqn, NonPackExtensionFqnSchema, type NonPackExtensionTypePlural, NonPackManifestFields, PACK_FQN_PATTERN, PER_AGENT_EXTENSION_TYPES, type PackFqn, PackFqnSchema, type PackMemberConstraint, PackMemberConstraintMapSchema, PackMemberConstraintSchema, type PackMemberConstraintMap, type PackMemberRegistrySource, PackMemberRegistrySourceSchema, packMemberRegistrySource, packMemberVersionRange, type PackSpec, PackSpecSchema, type PerAgentType, type PublishOptions, PublishOptionsSchema, type WorkspaceCapabilityType, decodeExtensionNameSync, extensionTypeFromPlural, extensionTypeLabels, extensionTypePluralLabels, extensionTypePluralSegments, extensionTypePluralSentenceLabels, extensionTypeSentenceLabels, extensionTypeToPlural, extensionTypes, extensionSourceFamilies, extensionTypesInstallableFrom, isInstallableFrom, isExtensionType, isExtensionTypePlural, nonPackExtensionTypePluralSegments, parseExtensionFqnParts, parseExtensionSpecParts, splitExtensionReference, type SplitExtensionReference, toAuthor, toExtensionType, toExtensionTypePlural, } from "./common.js";
 export { type ReleaseAgeExcludePattern, ReleaseAgeExcludePatternSchema, matchesReleaseAgeExcludePattern, } from "./fqn-pattern.js";
 export { FqnInvalidError, formatFqn, parseFqn, parseFqnOrThrow } from "./fqn.js";
 export { HANDLE_PATTERN, HANDLE_PATTERN_SOURCE, type Handle, HandleSchema, SLUG_PATTERN, SLUG_PATTERN_SOURCE, type Slug, SlugSchema, decodeHandleSync, decodeSlugSync, handleFromSlug, normalizeHandle, normalizeSlug, slugFromHandle, } from "./handle.js";

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

@@ -3,7 +3,7 @@
  *
  * @experimental This API is unstable and may change without notice.
  */
-export { AgentIdSchema, AuthorSchema, CONTAINER_EXTENSION_TYPES, CommonManifestBaseFields, ConfigurableAgentIdSchema, EXTENSION_NAME_PATTERN, INSTALLABLE_FROM_BY_TYPE, ExtensionDependencyConstraintMapSchema, ExtensionFqnPartsSchema, ExtensionFqnSchema, ExtensionNameSchema, ExtensionSpecSchema, ExtensionTypePluralSchema, ExtensionTypeSchema, ExtensionVisibilitySchema, FQN_PATTERN, LicenseSchema, NON_PACK_FQN_PATTERN, NonPackExtensionDependencyConstraintMapSchema, NonPackExtensionFqnSchema, NonPackManifestFields, PACK_FQN_PATTERN, PER_AGENT_EXTENSION_TYPES, PackFqnSchema, PackMemberConstraintMapSchema, PackMemberConstraintSchema, PackMemberRegistrySourceSchema, packMemberRegistrySource, packMemberVersionRange, PackSpecSchema, PublishOptionsSchema, decodeExtensionNameSync, extensionTypeFromPlural, extensionTypeLabels, extensionTypePluralLabels, extensionTypePluralSegments, extensionTypePluralSentenceLabels, extensionTypeSentenceLabels, extensionTypeToPlural, extensionTypes, extensionSourceFamilies, extensionTypesInstallableFrom, isInstallableFrom, isExtensionType, isExtensionTypePlural, nonPackExtensionTypePluralSegments, parseExtensionFqnParts, parseExtensionSpecParts, toAuthor, toExtensionType, toExtensionTypePlural, } from "./common.js";
+export { AgentIdSchema, AuthorSchema, CONTAINER_EXTENSION_TYPES, CommonManifestBaseFields, ConfigurableAgentIdSchema, EXTENSION_NAME_PATTERN, INSTALLABLE_FROM_BY_TYPE, ExtensionDependencyConstraintMapSchema, ExtensionFqnPartsSchema, ExtensionFqnSchema, ExtensionNameSchema, ExtensionSpecSchema, ExtensionTypePluralSchema, ExtensionTypeSchema, ExtensionVisibilitySchema, FQN_PATTERN, LicenseSchema, NON_PACK_FQN_PATTERN, NonPackExtensionDependencyConstraintMapSchema, NonPackExtensionFqnSchema, NonPackManifestFields, PACK_FQN_PATTERN, PER_AGENT_EXTENSION_TYPES, PackFqnSchema, PackMemberConstraintMapSchema, PackMemberConstraintSchema, PackMemberRegistrySourceSchema, packMemberRegistrySource, packMemberVersionRange, PackSpecSchema, PublishOptionsSchema, decodeExtensionNameSync, extensionTypeFromPlural, extensionTypeLabels, extensionTypePluralLabels, extensionTypePluralSegments, extensionTypePluralSentenceLabels, extensionTypeSentenceLabels, extensionTypeToPlural, extensionTypes, extensionSourceFamilies, extensionTypesInstallableFrom, isInstallableFrom, isExtensionType, isExtensionTypePlural, nonPackExtensionTypePluralSegments, parseExtensionFqnParts, parseExtensionSpecParts, splitExtensionReference, toAuthor, toExtensionType, toExtensionTypePlural, } from "./common.js";
 export { ReleaseAgeExcludePatternSchema, matchesReleaseAgeExcludePattern, } from "./fqn-pattern.js";
 export { FqnInvalidError, formatFqn, parseFqn, parseFqnOrThrow } from "./fqn.js";
 export { HANDLE_PATTERN, HANDLE_PATTERN_SOURCE, HandleSchema, SLUG_PATTERN, SLUG_PATTERN_SOURCE, SlugSchema, decodeHandleSync, decodeSlugSync, handleFromSlug, normalizeHandle, normalizeSlug, slugFromHandle, } from "./handle.js";

package/dist/src/unstable/extensions/name-patterns.d.ts

@@ -7,15 +7,17 @@
  * @experimental This API is unstable and may change without notice.
  */
 /**
- * Expand a glob pattern against a list of names.
+ * Match one extension name against a pattern.
  *
  * Only `*` wildcards are supported. All other characters (including `?`, `[`, `]`)
  * are treated as literals. Matching is case-sensitive.
  *
  * @param pattern - The pattern to match (may contain `*`)
- * @param names - Available names to match against
- * @returns Matching names in their original order
+ * @param name - The name to check
+ * @returns Whether the complete name matches
  */
+export declare const matchesPattern: (pattern: string, name: string) => boolean;
+/** Expand a glob pattern against names, preserving their original order. */
 export declare const expandGlob: (pattern: string, names: ReadonlyArray<string>) => ReadonlyArray<string>;
 /**
  * Expand multiple glob patterns against a list of extension names.

package/dist/src/unstable/extensions/name-patterns.js

@@ -7,48 +7,47 @@
  * @experimental This API is unstable and may change without notice.
  */
 /**
- * Expand a glob pattern against a list of names.
+ * Match one extension name against a pattern.
  *
  * Only `*` wildcards are supported. All other characters (including `?`, `[`, `]`)
  * are treated as literals. Matching is case-sensitive.
  *
  * @param pattern - The pattern to match (may contain `*`)
- * @param names - Available names to match against
- * @returns Matching names in their original order
+ * @param name - The name to check
+ * @returns Whether the complete name matches
  */
-export const expandGlob = (pattern, names) => {
-    const matches = (name) => {
-        let patternIndex = 0;
-        let nameIndex = 0;
-        let wildcardIndex = -1;
-        let wildcardNameIndex = 0;
-        while (nameIndex < name.length) {
-            const token = pattern[patternIndex];
-            if (token !== undefined && token !== "*" && token === name[nameIndex]) {
-                patternIndex += 1;
-                nameIndex += 1;
-            }
-            else if (token === "*") {
-                wildcardIndex = patternIndex;
-                wildcardNameIndex = nameIndex;
-                patternIndex += 1;
-            }
-            else if (wildcardIndex >= 0) {
-                patternIndex = wildcardIndex + 1;
-                wildcardNameIndex += 1;
-                nameIndex = wildcardNameIndex;
-            }
-            else {
-                return false;
-            }
+export const matchesPattern = (pattern, name) => {
+    let patternIndex = 0;
+    let nameIndex = 0;
+    let wildcardIndex = -1;
+    let wildcardNameIndex = 0;
+    while (nameIndex < name.length) {
+        const token = pattern[patternIndex];
+        if (token !== undefined && token !== "*" && token === name[nameIndex]) {
+            patternIndex += 1;
+            nameIndex += 1;
         }
-        while (pattern[patternIndex] === "*") {
+        else if (token === "*") {
+            wildcardIndex = patternIndex;
+            wildcardNameIndex = nameIndex;
             patternIndex += 1;
         }
-        return patternIndex === pattern.length;
-    };
-    return names.filter(matches);
+        else if (wildcardIndex >= 0) {
+            patternIndex = wildcardIndex + 1;
+            wildcardNameIndex += 1;
+            nameIndex = wildcardNameIndex;
+        }
+        else {
+            return false;
+        }
+    }
+    while (pattern[patternIndex] === "*") {
+        patternIndex += 1;
+    }
+    return patternIndex === pattern.length;
 };
+/** Expand a glob pattern against names, preserving their original order. */
+export const expandGlob = (pattern, names) => names.filter((name) => matchesPattern(pattern, name));
 /**
  * Expand multiple glob patterns against a list of extension names.
  *

package/dist/src/unstable/extensions/refs/extension-ref.d.ts

@@ -8,6 +8,7 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
+import type { ExtensionName } from "../common.js";
 import type { SkillExtensionRef } from "./skill.js";
 import type { McpServerExtensionRef } from "./mcp-server.js";
 import type { SubagentExtensionRef } from "./subagent.js";
@@ -17,4 +18,12 @@ import type { KnowledgeExtensionRef } from "./knowledge.js";
 import type { PackRef } from "./pack.js";
 /** @experimental */
 export type ExtensionRef = SkillExtensionRef | McpServerExtensionRef | SubagentExtensionRef | RuleExtensionRef | HookExtensionRef | KnowledgeExtensionRef | PackRef;
+/**
+ * The name an extension's own manifest gives it: the configured workspace
+ * name it occupies. A Registry ref's `name` is the package the Registry
+ * serves it under and may differ; Registry operations use that one.
+ *
+ * @experimental
+ */
+export declare const extensionRefName: (ref: ExtensionRef) => ExtensionName;
 //# sourceMappingURL=extension-ref.d.ts.map

package/dist/src/unstable/extensions/refs/extension-ref.js

@@ -8,5 +8,29 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-export {};
+/**
+ * The name an extension's own manifest gives it: the configured workspace
+ * name it occupies. A Registry ref's `name` is the package the Registry
+ * serves it under and may differ; Registry operations use that one.
+ *
+ * @experimental
+ */
+export const extensionRefName = (ref) => {
+    switch (ref.type) {
+        case "skill":
+            return ref.skill.name;
+        case "mcp-server":
+            return ref.server.name;
+        case "pack":
+            return ref.pack.name;
+        case "subagent":
+            return ref.subagent.name;
+        case "rule":
+            return ref.rule.name;
+        case "hook":
+            return ref.hook.name;
+        case "knowledge":
+            return ref.knowledge.name;
+    }
+};
 //# sourceMappingURL=extension-ref.js.map

package/dist/src/unstable/extensions/registry-source.d.ts

@@ -1,3 +1,4 @@
+import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
 export declare const RegistrySourcePatternPartsSchema: Schema.Struct<{
     readonly owner: Schema.brand<Schema.String, "Handle">;
@@ -6,8 +7,14 @@ export declare const RegistrySourcePatternPartsSchema: Schema.Struct<{
     readonly versionRange: Schema.optional<Schema.brand<Schema.NonEmptyString, "VersionRange">>;
 }>;
 export type RegistrySourcePatternParts = Schema.Schema.Type<typeof RegistrySourcePatternPartsSchema>;
+/**
+ * A Registry locator with the configured source it names, when it names one.
+ * An unqualified `@owner/...` locator names no source here: which configured
+ * Registry it binds to is a workspace decision, made beside the settings that
+ * hold the effective default Registry.
+ */
 export type SourceQualifiedRegistrySourcePatternParts = RegistrySourcePatternParts & {
-    readonly sourceName: string;
+    readonly sourceName: Option.Option<string>;
 };
 export declare const RegistrySourceRefPartsSchema: Schema.Struct<{
     readonly owner: Schema.brand<Schema.String, "Handle">;
@@ -17,7 +24,10 @@ export declare const RegistrySourceRefPartsSchema: Schema.Struct<{
 }>;
 export type RegistrySourceRefParts = Schema.Schema.Type<typeof RegistrySourceRefPartsSchema>;
 export declare const parseRegistrySourcePatternParts: (input: string) => RegistrySourcePatternParts | undefined;
-/** Parse a Registry locator, assigning unqualified input to the built-in agentxm source. */
+/**
+ * Parse a Registry locator, keeping the configured source name it spells
+ * (`<source>:@owner/...`) and leaving an unqualified locator unbound.
+ */
 export declare const parseSourceQualifiedRegistrySourcePatternParts: (input: string) => SourceQualifiedRegistrySourcePatternParts | undefined;
 export declare const parseRegistrySourceRef: (input: string) => RegistrySourceRefParts | undefined;
 export declare const formatRegistrySourcePatternParts: (value: RegistrySourcePatternParts) => string;