@agentxm/extension-model 0.31.1 → 0.32.1

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

@@ -0,0 +1,16 @@
+/**
+ * Identity archival vocabulary carried by resolved extension references.
+ *
+ * Archival blocks new publication while leaving historical releases
+ * resolvable. Publisher-management composites stay in
+ * `@agentxm/registry-protocol`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+export declare const ArchivalViewSchema: Schema.Struct<{
+    readonly archivedAt: Schema.decodeTo<Schema.DateTimeUtc, Schema.String, never, never>;
+    readonly reason: Schema.optional<Schema.String>;
+}>;
+export type ArchivalView = typeof ArchivalViewSchema.Type;
+//# sourceMappingURL=archival.d.ts.map

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

@@ -0,0 +1,19 @@
+/**
+ * Identity archival vocabulary carried by resolved extension references.
+ *
+ * Archival blocks new publication while leaving historical releases
+ * resolvable. Publisher-management composites stay in
+ * `@agentxm/registry-protocol`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { DateTimeUtcSchema } from "../date-time.js";
+export const ArchivalViewSchema = Schema.Struct({
+    archivedAt: DateTimeUtcSchema,
+    reason: Schema.optional(Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(500))),
+}).annotate({
+    identifier: "ArchivalView",
+    description: "Canonical authorization-safe extension archival state.",
+});
+//# sourceMappingURL=archival.js.map

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

@@ -6,6 +6,7 @@
 import * as Schema from "effect/Schema";
 import * as Option from "effect/Option";
 import { AgentIdSchema } from "../agent-capabilities/identity.js";
+import { type VersionRange } from "../version-constraints/version-constraints.js";
 /**
  * Author information for a manifest.
  *
@@ -85,6 +86,12 @@ export type ExtensionPlacement = "per-agent" | "workspace" | "container";
 export type StandardGoverns = "package-body" | "runtime-protocol" | "host-file";
 /** Workspace-level capability a type participates in. */
 export type WorkspaceCapabilityKey = "instructions";
+/** Authority families an extension may be installed from. */
+export declare const extensionSourceFamilies: readonly ["git", "registry", "path", "workspace"];
+export type ExtensionSourceFamily = (typeof extensionSourceFamilies)[number];
+type ExtensionInstallability = {
+    readonly [Family in ExtensionSourceFamily]: boolean;
+};
 /**
  * One extension type's naming and capability-axis row. Every CONDITIONAL
  * parity obligation is a predicate over the five axis columns.
@@ -95,10 +102,12 @@ interface ExtensionTypeRow {
     readonly pluralLabel: string;
     readonly sentenceLabel: string;
     readonly pluralSentenceLabel: string;
+    readonly sourceDirectory: "src" | null;
     readonly distribution: ExtensionDistribution;
     readonly placement: ExtensionPlacement;
     readonly governs: StandardGoverns | null;
     readonly installInputs: boolean;
+    readonly installableFrom: ExtensionInstallability;
     readonly workspaceCapability: WorkspaceCapabilityKey | null;
 }
 /**
@@ -118,10 +127,17 @@ export declare const EXTENSION_TYPE_TABLE: {
         readonly pluralLabel: "Skills";
         readonly sentenceLabel: "skill";
         readonly pluralSentenceLabel: "skills";
+        readonly sourceDirectory: "src";
         readonly distribution: "registry";
         readonly placement: "per-agent";
         readonly governs: "package-body";
         readonly installInputs: false;
+        readonly installableFrom: {
+            readonly git: true;
+            readonly registry: true;
+            readonly path: true;
+            readonly workspace: true;
+        };
         readonly workspaceCapability: null;
     };
     readonly "mcp-server": {
@@ -130,10 +146,17 @@ export declare const EXTENSION_TYPE_TABLE: {
         readonly pluralLabel: "MCP Servers";
         readonly sentenceLabel: "MCP server";
         readonly pluralSentenceLabel: "MCP servers";
+        readonly sourceDirectory: null;
         readonly distribution: "registry";
         readonly placement: "per-agent";
         readonly governs: "runtime-protocol";
         readonly installInputs: true;
+        readonly installableFrom: {
+            readonly git: true;
+            readonly registry: true;
+            readonly path: true;
+            readonly workspace: true;
+        };
         readonly workspaceCapability: null;
     };
     readonly subagent: {
@@ -142,10 +165,17 @@ export declare const EXTENSION_TYPE_TABLE: {
         readonly pluralLabel: "Subagents";
         readonly sentenceLabel: "subagent";
         readonly pluralSentenceLabel: "subagents";
+        readonly sourceDirectory: "src";
         readonly distribution: "registry";
         readonly placement: "per-agent";
         readonly governs: null;
         readonly installInputs: false;
+        readonly installableFrom: {
+            readonly git: true;
+            readonly registry: true;
+            readonly path: true;
+            readonly workspace: true;
+        };
         readonly workspaceCapability: null;
     };
     readonly rule: {
@@ -154,10 +184,17 @@ export declare const EXTENSION_TYPE_TABLE: {
         readonly pluralLabel: "Rules";
         readonly sentenceLabel: "rule";
         readonly pluralSentenceLabel: "rules";
+        readonly sourceDirectory: "src";
         readonly distribution: "registry";
         readonly placement: "workspace";
         readonly governs: "host-file";
         readonly installInputs: false;
+        readonly installableFrom: {
+            readonly git: true;
+            readonly registry: true;
+            readonly path: true;
+            readonly workspace: true;
+        };
         readonly workspaceCapability: "instructions";
     };
     readonly hook: {
@@ -166,10 +203,17 @@ export declare const EXTENSION_TYPE_TABLE: {
         readonly pluralLabel: "Hooks";
         readonly sentenceLabel: "hook";
         readonly pluralSentenceLabel: "hooks";
+        readonly sourceDirectory: "src";
         readonly distribution: "registry";
         readonly placement: "per-agent";
         readonly governs: null;
         readonly installInputs: false;
+        readonly installableFrom: {
+            readonly git: true;
+            readonly registry: true;
+            readonly path: true;
+            readonly workspace: true;
+        };
         readonly workspaceCapability: null;
     };
     readonly knowledge: {
@@ -178,10 +222,17 @@ export declare const EXTENSION_TYPE_TABLE: {
         readonly pluralLabel: "Knowledge";
         readonly sentenceLabel: "knowledge bundle";
         readonly pluralSentenceLabel: "knowledge bundles";
+        readonly sourceDirectory: "src";
         readonly distribution: "registry";
         readonly placement: "workspace";
         readonly governs: "package-body";
         readonly installInputs: false;
+        readonly installableFrom: {
+            readonly git: true;
+            readonly registry: true;
+            readonly path: true;
+            readonly workspace: true;
+        };
         readonly workspaceCapability: null;
     };
     readonly pack: {
@@ -190,10 +241,17 @@ export declare const EXTENSION_TYPE_TABLE: {
         readonly pluralLabel: "Packs";
         readonly sentenceLabel: "pack";
         readonly pluralSentenceLabel: "packs";
+        readonly sourceDirectory: null;
         readonly distribution: "registry";
         readonly placement: "container";
         readonly governs: null;
         readonly installInputs: false;
+        readonly installableFrom: {
+            readonly git: true;
+            readonly registry: true;
+            readonly path: true;
+            readonly workspace: true;
+        };
         readonly workspaceCapability: null;
     };
 };
@@ -239,6 +297,10 @@ export type ContainerType = TypesWhere<"placement", "container">;
 export type RegistryType = PerAgentType | WorkspaceType;
 /** Extension types whose installs accept user-provided inputs. */
 export type InputType = TypesWhere<"installInputs", true>;
+/** Extension types installable from one source family. */
+export type InstallableFrom<Family extends ExtensionSourceFamily> = {
+    [Type in ExtensionType]: ExtensionTypeRows[Type]["installableFrom"][Family] extends true ? Type : never;
+}[ExtensionType];
 /** Extension types whose governing standard covers the package body. */
 export type BodyGovernedType = TypesWhere<"governs", "package-body">;
 /**
@@ -258,6 +320,45 @@ export declare const WORKSPACE_EXTENSION_TYPES: ReadonlyArray<WorkspaceType>;
 export declare const CONTAINER_EXTENSION_TYPES: ReadonlyArray<ContainerType>;
 export declare const REGISTRY_EXTENSION_TYPES: ReadonlyArray<RegistryType>;
 export declare const INPUT_EXTENSION_TYPES: ReadonlyArray<InputType>;
+/** Installability policy, total over every extension type and source family. */
+export declare const INSTALLABLE_FROM_BY_TYPE: Record<"skill" | "mcp-server" | "subagent" | "rule" | "hook" | "knowledge" | "pack", {
+    readonly git: true;
+    readonly registry: true;
+    readonly path: true;
+    readonly workspace: true;
+} | {
+    readonly git: true;
+    readonly registry: true;
+    readonly path: true;
+    readonly workspace: true;
+} | {
+    readonly git: true;
+    readonly registry: true;
+    readonly path: true;
+    readonly workspace: true;
+} | {
+    readonly git: true;
+    readonly registry: true;
+    readonly path: true;
+    readonly workspace: true;
+} | {
+    readonly git: true;
+    readonly registry: true;
+    readonly path: true;
+    readonly workspace: true;
+} | {
+    readonly git: true;
+    readonly registry: true;
+    readonly path: true;
+    readonly workspace: true;
+} | {
+    readonly git: true;
+    readonly registry: true;
+    readonly path: true;
+    readonly workspace: true;
+}>;
+export declare const extensionTypesInstallableFrom: <Family extends ExtensionSourceFamily>(family: Family) => ReadonlyArray<InstallableFrom<Family>>;
+export declare const isInstallableFrom: <Family extends ExtensionSourceFamily>(type: ExtensionType, family: Family) => type is InstallableFrom<Family>;
 export declare const BODY_GOVERNED_EXTENSION_TYPES: ReadonlyArray<BodyGovernedType>;
 export declare const SPEC_TRACKED_EXTENSION_TYPES: ReadonlyArray<SpecTrackedType>;
 export declare const WORKSPACE_CAPABILITY_EXTENSION_TYPES: ReadonlyArray<WorkspaceCapabilityType>;
@@ -434,6 +535,53 @@ export declare const NonPackExtensionDependencyConstraintMapSchema: Schema.$Reco
  * @experimental This API is unstable and may change without notice.
  */
 export type NonPackExtensionDependencyConstraintMap = Schema.Schema.Type<typeof NonPackExtensionDependencyConstraintMapSchema>;
+/**
+ * An explicit Registry source for one Pack member.
+ *
+ * Pack manifests intentionally carry the Registry URL rather than a configured
+ * source name so the declaration remains self-describing when shared.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const PackMemberRegistrySourceSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"registry">;
+    readonly url: Schema.URLFromString;
+}>;
+/** @experimental This API is unstable and may change without notice. */
+export type PackMemberRegistrySource = Schema.Schema.Type<typeof PackMemberRegistrySourceSchema>;
+/**
+ * A Pack member constraint either inherits the Pack's source or names an
+ * explicit Registry source. Other locator families are deliberately absent.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const PackMemberConstraintSchema: 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">;
+}>]>;
+/** @experimental This API is unstable and may change without notice. */
+export type PackMemberConstraint = Schema.Schema.Type<typeof PackMemberConstraintSchema>;
+/** The semver range carried by either Pack member declaration form. */
+export declare const packMemberVersionRange: (constraint: PackMemberConstraint) => VersionRange;
+/** The explicit Registry locator, when the member does not inherit the Pack source. */
+export declare const packMemberRegistrySource: (constraint: PackMemberConstraint) => PackMemberRegistrySource | undefined;
+/**
+ * Map of non-Pack extension identities to source-aware Pack member constraints.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const PackMemberConstraintMapSchema: 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">;
+}>]>>;
+/** @experimental This API is unstable and may change without notice. */
+export type PackMemberConstraintMap = Schema.Schema.Type<typeof PackMemberConstraintMapSchema>;
 /**
  * Publish-time packaging options.
  *

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

@@ -12,7 +12,7 @@ import { HANDLE_PATTERN_SOURCE, HandleSchema } from "./handle.js";
 import { parseLicenseExpression } from "./license.js";
 import { CompanionPackageSchema } from "../package-urls/index.js";
 import { ExtensionMetadataSchema } from "./manifest-metadata.js";
-import { VersionSchema, VersionRangeSchema } from "../version-constraints/version-constraints.js";
+import { VersionSchema, VersionRangeSchema, } from "../version-constraints/version-constraints.js";
 /**
  * Author information for a manifest.
  *
@@ -112,6 +112,8 @@ export const LicenseSchema = Schema.String.annotate({
 }).check(Schema.makeFilter((value) => Result.isSuccess(parseLicenseExpression(value))
     ? true
     : "Expected a valid SPDX license expression or UNLICENSED"));
+/** Authority families an extension may be installed from. */
+export const extensionSourceFamilies = ["git", "registry", "path", "workspace"];
 /**
  * Single source of truth for extension type naming. Row order is the canonical
  * display order. Every other type-naming export in this module derives from
@@ -129,10 +131,12 @@ export const EXTENSION_TYPE_TABLE = {
         pluralLabel: "Skills",
         sentenceLabel: "skill",
         pluralSentenceLabel: "skills",
+        sourceDirectory: "src",
         distribution: "registry",
         placement: "per-agent",
         governs: "package-body",
         installInputs: false,
+        installableFrom: { git: true, registry: true, path: true, workspace: true },
         workspaceCapability: null,
     },
     "mcp-server": {
@@ -141,10 +145,12 @@ export const EXTENSION_TYPE_TABLE = {
         pluralLabel: "MCP Servers",
         sentenceLabel: "MCP server",
         pluralSentenceLabel: "MCP servers",
+        sourceDirectory: null,
         distribution: "registry",
         placement: "per-agent",
         governs: "runtime-protocol",
         installInputs: true,
+        installableFrom: { git: true, registry: true, path: true, workspace: true },
         workspaceCapability: null,
     },
     subagent: {
@@ -153,10 +159,12 @@ export const EXTENSION_TYPE_TABLE = {
         pluralLabel: "Subagents",
         sentenceLabel: "subagent",
         pluralSentenceLabel: "subagents",
+        sourceDirectory: "src",
         distribution: "registry",
         placement: "per-agent",
         governs: null,
         installInputs: false,
+        installableFrom: { git: true, registry: true, path: true, workspace: true },
         workspaceCapability: null,
     },
     rule: {
@@ -165,10 +173,12 @@ export const EXTENSION_TYPE_TABLE = {
         pluralLabel: "Rules",
         sentenceLabel: "rule",
         pluralSentenceLabel: "rules",
+        sourceDirectory: "src",
         distribution: "registry",
         placement: "workspace",
         governs: "host-file",
         installInputs: false,
+        installableFrom: { git: true, registry: true, path: true, workspace: true },
         workspaceCapability: "instructions",
     },
     hook: {
@@ -177,10 +187,12 @@ export const EXTENSION_TYPE_TABLE = {
         pluralLabel: "Hooks",
         sentenceLabel: "hook",
         pluralSentenceLabel: "hooks",
+        sourceDirectory: "src",
         distribution: "registry",
         placement: "per-agent",
         governs: null,
         installInputs: false,
+        installableFrom: { git: true, registry: true, path: true, workspace: true },
         workspaceCapability: null,
     },
     knowledge: {
@@ -189,10 +201,12 @@ export const EXTENSION_TYPE_TABLE = {
         pluralLabel: "Knowledge",
         sentenceLabel: "knowledge bundle",
         pluralSentenceLabel: "knowledge bundles",
+        sourceDirectory: "src",
         distribution: "registry",
         placement: "workspace",
         governs: "package-body",
         installInputs: false,
+        installableFrom: { git: true, registry: true, path: true, workspace: true },
         workspaceCapability: null,
     },
     pack: {
@@ -201,10 +215,12 @@ export const EXTENSION_TYPE_TABLE = {
         pluralLabel: "Packs",
         sentenceLabel: "pack",
         pluralSentenceLabel: "packs",
+        sourceDirectory: null,
         distribution: "registry",
         placement: "container",
         governs: null,
         installInputs: false,
+        installableFrom: { git: true, registry: true, path: true, workspace: true },
         workspaceCapability: null,
     },
 };
@@ -237,6 +253,10 @@ export const WORKSPACE_EXTENSION_TYPES = extensionTypes.filter((type) => EXTENSI
 export const CONTAINER_EXTENSION_TYPES = extensionTypes.filter((type) => EXTENSION_TYPE_TABLE[type].placement === "container");
 export const REGISTRY_EXTENSION_TYPES = extensionTypes.filter((type) => EXTENSION_TYPE_TABLE[type].placement !== "container");
 export const INPUT_EXTENSION_TYPES = extensionTypes.filter((type) => EXTENSION_TYPE_TABLE[type].installInputs);
+/** Installability policy, total over every extension type and source family. */
+export const INSTALLABLE_FROM_BY_TYPE = EffectRecord.map(EXTENSION_TYPE_TABLE, (row) => row.installableFrom);
+export const extensionTypesInstallableFrom = (family) => extensionTypes.filter((type) => INSTALLABLE_FROM_BY_TYPE[type][family]);
+export const isInstallableFrom = (type, family) => INSTALLABLE_FROM_BY_TYPE[type][family];
 export const BODY_GOVERNED_EXTENSION_TYPES = extensionTypes.filter((type) => EXTENSION_TYPE_TABLE[type].governs === "package-body");
 export const SPEC_TRACKED_EXTENSION_TYPES = extensionTypes.filter((type) => EXTENSION_TYPE_TABLE[type].governs !== null);
 export const WORKSPACE_CAPABILITY_EXTENSION_TYPES = extensionTypes.filter((type) => EXTENSION_TYPE_TABLE[type].workspaceCapability !== null);
@@ -482,6 +502,51 @@ export const NonPackExtensionDependencyConstraintMapSchema = Schema.Record(Schem
     .annotate({
     description: "Map of fully-qualified non-pack extension names to version ranges. Packs cannot depend on other packs.",
 });
+/**
+ * An explicit Registry source for one Pack member.
+ *
+ * Pack manifests intentionally carry the Registry URL rather than a configured
+ * source name so the declaration remains self-describing when shared.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const PackMemberRegistrySourceSchema = Schema.Struct({
+    type: Schema.Literal("registry"),
+    url: Schema.URLFromString,
+}).annotate({
+    identifier: "PackMemberRegistrySource",
+    description: "A self-describing Registry locator for one Pack member.",
+});
+/**
+ * A Pack member constraint either inherits the Pack's source or names an
+ * explicit Registry source. Other locator families are deliberately absent.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const PackMemberConstraintSchema = Schema.Union([
+    VersionRangeSchema,
+    Schema.Struct({
+        source: PackMemberRegistrySourceSchema,
+        versionRange: VersionRangeSchema,
+    }).annotate({ identifier: "ExplicitRegistryPackMemberConstraint" }),
+]).annotate({
+    identifier: "PackMemberConstraint",
+    description: "A version range that inherits the Pack source, or an explicit Registry locator and range.",
+});
+/** The semver range carried by either Pack member declaration form. */
+export const packMemberVersionRange = (constraint) => typeof constraint === "string" ? constraint : constraint.versionRange;
+/** The explicit Registry locator, when the member does not inherit the Pack source. */
+export const packMemberRegistrySource = (constraint) => typeof constraint === "string" ? undefined : constraint.source;
+/**
+ * Map of non-Pack extension identities to source-aware Pack member constraints.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const PackMemberConstraintMapSchema = Schema.Record(Schema.String, PackMemberConstraintSchema)
+    .check(Schema.isPropertyNames(NonPackExtensionFqnSchema))
+    .annotate({
+    description: "Map of fully-qualified non-Pack extension names to inherited ranges or explicit Registry locators. Packs cannot depend on other Packs.",
+});
 /**
  * Publish-time packaging options.
  *

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, EXTENSION_ONLY_TYPES, type ExtensionDependencyConstraintMap, ExtensionDependencyConstraintMapSchema, type ExtensionFqn, type ExtensionFqnParts, ExtensionFqnPartsSchema, ExtensionFqnSchema, type ExtensionName, ExtensionNameSchema, type ExtensionSpec, ExtensionSpecSchema, 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 PackSpec, PackSpecSchema, type PerAgentType, type PublishOptions, PublishOptionsSchema, WORKSPACE_CAPABILITY_EXTENSION_TYPES, type WorkspaceCapabilityType, decodeExtensionNameSync, extensionTypeFromPlural, extensionTypeLabels, extensionTypePluralLabels, extensionTypePluralSegments, extensionTypePluralSentenceLabels, extensionTypeSentenceLabels, extensionTypeToPlural, extensionTypes, 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, EXTENSION_ONLY_TYPES, 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, WORKSPACE_CAPABILITY_EXTENSION_TYPES, 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 { 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, EXTENSION_ONLY_TYPES, 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, PackSpecSchema, PublishOptionsSchema, WORKSPACE_CAPABILITY_EXTENSION_TYPES, decodeExtensionNameSync, extensionTypeFromPlural, extensionTypeLabels, extensionTypePluralLabels, extensionTypePluralSegments, extensionTypePluralSentenceLabels, extensionTypeSentenceLabels, extensionTypeToPlural, extensionTypes, isExtensionType, isExtensionTypePlural, nonPackExtensionTypePluralSegments, parseExtensionFqnParts, parseExtensionSpecParts, toAuthor, toExtensionType, toExtensionTypePlural, } from "./common.js";
+export { AgentIdSchema, AuthorSchema, CONTAINER_EXTENSION_TYPES, CommonManifestBaseFields, ConfigurableAgentIdSchema, EXTENSION_NAME_PATTERN, EXTENSION_ONLY_TYPES, 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, WORKSPACE_CAPABILITY_EXTENSION_TYPES, decodeExtensionNameSync, extensionTypeFromPlural, extensionTypeLabels, extensionTypePluralLabels, extensionTypePluralSegments, extensionTypePluralSentenceLabels, extensionTypeSentenceLabels, extensionTypeToPlural, extensionTypes, extensionSourceFamilies, extensionTypesInstallableFrom, isInstallableFrom, isExtensionType, isExtensionTypePlural, nonPackExtensionTypePluralSegments, parseExtensionFqnParts, parseExtensionSpecParts, 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/installable-types.d.ts

@@ -1,12 +1,12 @@
 import * as Schema from "effect/Schema";
-export declare const installableExtensionTypes: readonly ("skill" | "mcp-server" | "subagent" | "rule" | "hook" | "knowledge" | "pack")[];
+export declare const installableExtensionTypes: import("./common.js").InstallableFrom<"git" | "workspace" | "registry" | "path">[];
 export type InstallableExtensionType = (typeof installableExtensionTypes)[number];
 export declare const isInstallableExtensionType: (value: string | undefined) => value is InstallableExtensionType;
-export declare const installableExtensionTypePluralSegments: readonly ("skills" | "mcps" | "subagents" | "rules" | "hooks" | "knowledge" | "packs")[];
+export declare const installableExtensionTypePluralSegments: ("skills" | "mcps" | "subagents" | "rules" | "hooks" | "knowledge" | "packs")[];
 export type InstallableExtensionTypePlural = (typeof installableExtensionTypePluralSegments)[number];
 export declare const isInstallableExtensionTypePlural: (value: string | undefined) => value is InstallableExtensionTypePlural;
 export declare const toInstallableExtensionType: (segment: InstallableExtensionTypePlural) => InstallableExtensionType;
 export declare const toInstallableExtensionTypePlural: (type: InstallableExtensionType) => InstallableExtensionTypePlural;
-export declare const InstallableExtensionTypeSchema: Schema.Literals<readonly ("skill" | "mcp-server" | "subagent" | "rule" | "hook" | "knowledge" | "pack")[]>;
-export declare const InstallableExtensionTypePluralSchema: Schema.Literals<readonly ("skills" | "mcps" | "subagents" | "rules" | "hooks" | "knowledge" | "packs")[]>;
+export declare const InstallableExtensionTypeSchema: Schema.Literals<import("./common.js").InstallableFrom<"git" | "workspace" | "registry" | "path">[]>;
+export declare const InstallableExtensionTypePluralSchema: Schema.Literals<("skills" | "mcps" | "subagents" | "rules" | "hooks" | "knowledge" | "packs")[]>;
 //# sourceMappingURL=installable-types.d.ts.map

package/dist/src/unstable/extensions/installable-types.js

@@ -1,9 +1,13 @@
 import * as Schema from "effect/Schema";
-import { extensionTypeFromPlural, extensionTypePluralSegments, extensionTypes, extensionTypeToPlural, isExtensionType, isExtensionTypePlural, } from "./common.js";
-export const installableExtensionTypes = extensionTypes;
-export const isInstallableExtensionType = (value) => isExtensionType(value);
-export const installableExtensionTypePluralSegments = extensionTypePluralSegments;
-export const isInstallableExtensionTypePlural = (value) => isExtensionTypePlural(value);
+import { extensionTypeFromPlural, extensionSourceFamilies, extensionTypesInstallableFrom, extensionTypeToPlural, } from "./common.js";
+export const installableExtensionTypes = extensionSourceFamilies
+    .flatMap((family) => extensionTypesInstallableFrom(family))
+    .filter((type, index, types) => types.indexOf(type) === index);
+const installableExtensionTypeSet = new Set(installableExtensionTypes);
+export const isInstallableExtensionType = (value) => value !== undefined && installableExtensionTypeSet.has(value);
+export const installableExtensionTypePluralSegments = installableExtensionTypes.map((type) => extensionTypeToPlural[type]);
+const installableExtensionTypePluralSet = new Set(installableExtensionTypePluralSegments);
+export const isInstallableExtensionTypePlural = (value) => value !== undefined && installableExtensionTypePluralSet.has(value);
 const installableExtensionTypeFromPlural = extensionTypeFromPlural;
 const installableExtensionTypeToPlural = extensionTypeToPlural;
 export const toInstallableExtensionType = (segment) => installableExtensionTypeFromPlural[segment];

package/dist/src/unstable/extensions/refs/pack.d.ts

@@ -6,12 +6,29 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-import type { PackRefBase, RegistryRefDetails, WorkspaceRefDetails } from "./ref-base.js";
-import type { RegistrySource, WorkspaceSource } from "../../sources/types.js";
+import type { GitHostedRefDetails, LocalRefDetails, PackRefBase, RegistryRefDetails, WorkspaceRefDetails } from "./ref-base.js";
+import type { GitBasedSource, LocalSource, RegistrySource, WorkspaceSource } from "../../sources/types.js";
+import type { HookExtensionRef } from "./hook.js";
+import type { KnowledgeExtensionRef } from "./knowledge.js";
+import type { McpServerExtensionRef } from "./mcp-server.js";
+import type { RuleExtensionRef } from "./rule.js";
+import type { SkillExtensionRef } from "./skill.js";
+import type { SubagentExtensionRef } from "./subagent.js";
+/** A non-Pack ref discovered from the same immutable source view. @experimental */
+export type SourceInheritedPackMemberRef = SkillExtensionRef | McpServerExtensionRef | SubagentExtensionRef | RuleExtensionRef | HookExtensionRef | KnowledgeExtensionRef;
+type SourceInheritedPackMembers = {
+    /** Runtime-only candidates discovered beside this Pack at the same accepted source view. */
+    readonly sourceMembers: ReadonlyArray<SourceInheritedPackMemberRef>;
+};
 /** @experimental */
 export type RegistryPackRef = PackRefBase<"registry", RegistrySource> & RegistryRefDetails;
 /** @experimental */
+export type GitHostedPackRef = PackRefBase<"git-hosted", GitBasedSource> & GitHostedRefDetails & SourceInheritedPackMembers;
+/** @experimental */
+export type LocalPackRef = PackRefBase<"local", LocalSource> & LocalRefDetails & SourceInheritedPackMembers;
+/** @experimental */
 export type WorkspacePackRef = PackRefBase<"workspace", WorkspaceSource> & WorkspaceRefDetails;
 /** @experimental */
-export type PackRef = RegistryPackRef | WorkspacePackRef;
+export type PackRef = RegistryPackRef | GitHostedPackRef | LocalPackRef | WorkspacePackRef;
+export {};
 //# sourceMappingURL=pack.d.ts.map

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

@@ -12,13 +12,14 @@ import type { ExtensionName, ExtensionType } from "../common.js";
 import type * as Option from "effect/Option";
 import type * as Record from "effect/Record";
 import type { RefType, Source } from "../../sources/types.js";
-import type { ExtensionDependencyConstraintMap } from "../common.js";
+import type { PackMemberConstraintMap } from "../common.js";
 import type { Version } from "../../version-constraints/version-constraints.js";
 import type { Handle } from "../handle.js";
 import type { PackageUrlParts } from "../../packaging/package-url.js";
 import type { WorkspaceScope } from "../../workspace-scope.js";
 import type { SourceHash } from "../../sources/source-hash.js";
 import type { DeprecationView } from "../deprecation.js";
+import type { ArchivalView } from "../archival.js";
 /** Ref details for git-hosted sources (GitHub, GitLab, Bitbucket, AzureRepos, Git). @experimental */
 export interface GitHostedRefDetails {
     /** Publisher identity declared by the resolved package manifest. */
@@ -54,6 +55,8 @@ export interface RegistryRefDetails {
     readonly packages: ReadonlyArray<PackageUrlParts>;
     /** Structured Registry lifecycle evidence captured at resolution time. */
     readonly deprecation?: DeprecationView;
+    /** Registry archival state captured at resolution time. */
+    readonly archival?: ArchivalView;
     /** Lifecycle notices that must be shown before an exact historical install. */
     readonly lifecycleWarnings?: ReadonlyArray<string>;
 }
@@ -117,9 +120,10 @@ export type SubagentExtensionRefBase<TRefType extends RefType, TSource extends S
 /** @experimental */
 export type PackRefBase<TRefType extends RefType, TSource extends Source> = ExtensionRefBase<"pack", TRefType, TSource> & {
     readonly owner: Handle;
+    readonly version: Version;
     readonly pack: {
         readonly name: ExtensionName;
-        readonly dependencies: ExtensionDependencyConstraintMap;
+        readonly dependencies: PackMemberConstraintMap;
     };
 };
 //# sourceMappingURL=ref-base.d.ts.map

package/dist/src/unstable/extensions/universal-skills-dir.d.ts

@@ -10,7 +10,7 @@
  * @packageDocumentation
  */
 /**
- * WorkspaceMutations-relative path of the universal skills directory.
+ * Workspace-relative path of the universal skills directory.
  */
 export declare const UNIVERSAL_SKILLS_DIR = ".agents/skills";
 /**
@@ -23,7 +23,7 @@ export declare const UNIVERSAL_SKILLS_DIR_SEGMENT: string;
 /**
  * Strips trailing path separators from a path string.
  */
-export declare const stripTrailingSeparators: (p: string) => string;
+export declare const stripTrailingSeparators: (path: string) => string;
 /**
  * Returns `true` when `dir` is the workspace-relative universal skills
  * directory path. Use for descriptor-level comparisons where paths are

package/dist/src/unstable/extensions/universal-skills-dir.js

@@ -10,7 +10,7 @@
  * @packageDocumentation
  */
 /**
- * WorkspaceMutations-relative path of the universal skills directory.
+ * Workspace-relative path of the universal skills directory.
  */
 export const UNIVERSAL_SKILLS_DIR = ".agents/skills";
 /**
@@ -23,7 +23,13 @@ export const UNIVERSAL_SKILLS_DIR_SEGMENT = UNIVERSAL_SKILLS_DIR.split("/")[0] ?
 /**
  * Strips trailing path separators from a path string.
  */
-export const stripTrailingSeparators = (p) => p.length > 1 ? p.replace(/[/\\]+$/, "") : p;
+export const stripTrailingSeparators = (path) => {
+    let end = path.length;
+    while (end > 1 && (path[end - 1] === "/" || path[end - 1] === "\\")) {
+        end -= 1;
+    }
+    return path.slice(0, end);
+};
 /**
  * Returns `true` when `dir` is the workspace-relative universal skills
  * directory path. Use for descriptor-level comparisons where paths are