@agentxm/client-core 0.5.1 → 0.5.3

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

@@ -9,7 +9,7 @@ import * as Result from "effect/Result";
 import { AGENT_IDS } from "../agents/types.js";
 import { HANDLE_PATTERN_SOURCE, HandleSchema } from "./handle.js";
 import { PackageUrlSchema } from "../packaging/package-url.js";
-import { ExactSemverVersionSchema, VersionConstraintSchema, } from "../version-constraints/version-constraints.js";
+import { VersionSchema, VersionRangeSchema } from "../version-constraints/version-constraints.js";
 /**
  * Author information for a manifest.
  *
@@ -22,7 +22,7 @@ export const AuthorSchema = Schema.Struct({
 }).annotate({
     identifier: "Author",
     title: "Author",
-    description: "Author details: name, email, and URL.",
+    description: "A person credited as a creator or maintainer of this extension.",
 });
 /** Convert schema-decoded author shape into runtime/domain Author. */
 export const toAuthor = (author) => ({
@@ -97,7 +97,7 @@ export const extensionTypeSentenceLabels = {
     subagent: "subagent",
     file: "file",
     rule: "rule",
-    pack: "extension pack",
+    pack: "pack",
 };
 export const extensionTypePluralSentenceLabels = {
     skills: "skills",
@@ -106,19 +106,34 @@ export const extensionTypePluralSentenceLabels = {
     subagents: "subagents",
     files: "files",
     rules: "rules",
-    packs: "extension packs",
+    packs: "packs",
 };
 const EXTENSION_TYPE_PLURAL_PATTERN_SOURCE = extensionTypePluralSegments.join("|");
+/**
+ * Plural extension-type segments that may appear as dependency keys —
+ * everything except `packs`. Packs cannot depend on other packs.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const nonPackExtensionTypePluralSegments = [
+    "skills",
+    "commands",
+    "mcp-servers",
+    "subagents",
+    "files",
+    "rules",
+];
+const NON_PACK_EXTENSION_TYPE_PLURAL_PATTERN_SOURCE = nonPackExtensionTypePluralSegments.join("|");
 const EXTENSION_NAME_MAX_LENGTH = 64;
 const EXTENSION_NAME_PATTERN_SOURCE = "[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?";
 const EXTENSION_NAME_BRAND = "ExtensionName";
-const invalidExtensionName = (value) => `Expected extension name to be max ${EXTENSION_NAME_MAX_LENGTH} characters, use lowercase letters, numbers, and hyphens only, and not start or end with a hyphen, got: ${value}`;
-const makeExtensionNameSchema = () => Schema.String.pipe(Schema.check(Schema.makeFilter((value) => EXTENSION_NAME_PATTERN.test(value) ? undefined : invalidExtensionName(value))), Schema.annotate({
+const INVALID_EXTENSION_NAME_MESSAGE = `Expected a valid extension name: max ${EXTENSION_NAME_MAX_LENGTH} characters, lowercase letters, numbers, and hyphens only, and not starting or ending with a hyphen (e.g., my-skill)`;
+const makeExtensionNameSchema = () => Schema.NonEmptyString.pipe(Schema.check(Schema.isPattern(EXTENSION_NAME_PATTERN, { message: INVALID_EXTENSION_NAME_MESSAGE })), Schema.annotate({
     identifier: "ExtensionName",
     title: "Extension Name",
     description: "The name of an extension — lowercase letters, numbers, and hyphens (e.g. my-skill).",
     examples: ["my-skill", "code-review", "prettier"],
-    message: "Expected a valid extension name (lowercase letters, numbers, and hyphens, e.g., my-skill)",
+    message: INVALID_EXTENSION_NAME_MESSAGE,
 }), Schema.brand(EXTENSION_NAME_BRAND));
 /**
  * Fully qualified name regex: `@<handle>/<type>/<name>` where handle and name
@@ -127,6 +142,23 @@ const makeExtensionNameSchema = () => Schema.String.pipe(Schema.check(Schema.mak
  * @experimental This API is unstable and may change without notice.
  */
 export const FQN_PATTERN = new RegExp(`^(${HANDLE_PATTERN_SOURCE})\\/(${EXTENSION_TYPE_PLURAL_PATTERN_SOURCE})\\/(${EXTENSION_NAME_PATTERN_SOURCE})$`);
+/**
+ * Fully qualified name regex restricted to non-pack extension types. Matches
+ * `@<handle>/<type>/<name>` where `<type>` is any plural extension type other
+ * than `packs`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const NON_PACK_FQN_PATTERN = new RegExp(`^(${HANDLE_PATTERN_SOURCE})\\/(${NON_PACK_EXTENSION_TYPE_PLURAL_PATTERN_SOURCE})\\/(${EXTENSION_NAME_PATTERN_SOURCE})$`);
+/**
+ * Fully qualified name regex restricted to the pack extension type. Matches
+ * `@<handle>/packs/<name>`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const PACK_FQN_PATTERN = new RegExp(`^(${HANDLE_PATTERN_SOURCE})\\/packs\\/(${EXTENSION_NAME_PATTERN_SOURCE})$`);
+const EXTENSION_SPEC_PATTERN = new RegExp(`^(${HANDLE_PATTERN_SOURCE})\\/(${EXTENSION_TYPE_PLURAL_PATTERN_SOURCE})\\/(${EXTENSION_NAME_PATTERN_SOURCE})(?:@.+)?$`);
+const PACK_SPEC_PATTERN = new RegExp(`^(${HANDLE_PATTERN_SOURCE})\\/packs\\/(${EXTENSION_NAME_PATTERN_SOURCE})(?:@.+)?$`);
 /**
  * Canonical extension short name regex.
  */
@@ -161,22 +193,22 @@ export const ExtensionTypePluralSchema = Schema.Literals(extensionTypePluralSegm
  *
  * @experimental This API is unstable and may change without notice.
  */
-export const FullyQualifiedNamePartsSchema = Schema.Struct({
+export const ExtensionFqnPartsSchema = Schema.Struct({
     owner: HandleSchema,
     type: ExtensionTypeSchema,
     name: ExtensionNameSchema,
 }).annotate({
-    identifier: "FullyQualifiedNameParts",
-    title: "Fully Qualified Name Parts",
+    identifier: "ExtensionFqnParts",
+    title: "Extension FQN Parts",
     description: "The parts of a full extension identifier like @my-org/skills/code-review.",
 });
-const decodeFullyQualifiedNameParts = Schema.decodeUnknownResult(FullyQualifiedNamePartsSchema);
+const decodeExtensionFqnParts = Schema.decodeUnknownResult(ExtensionFqnPartsSchema);
 /**
  * Parse a fully qualified name string into validated structured parts.
  *
  * @experimental This API is unstable and may change without notice.
  */
-export const parseFullyQualifiedNameParts = (input) => {
+export const parseExtensionFqnParts = (input) => {
     const parts = input.split("/");
     if (parts.length !== 3) {
         return undefined;
@@ -189,70 +221,147 @@ export const parseFullyQualifiedNameParts = (input) => {
         return undefined;
     }
     const type = toExtensionType(typeSegment);
-    const result = decodeFullyQualifiedNameParts({ owner, type, name });
+    const result = decodeExtensionFqnParts({ owner, type, name });
     return Result.isSuccess(result) ? result.success : undefined;
 };
 /**
- * Parse a fully qualified ref string (with optional version constraint) into parts.
+ * 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 parseFullyQualifiedRefParts = (input) => {
+export const parseExtensionSpecParts = (input) => {
     const lastSlash = input.lastIndexOf("/");
     const constraintAt = lastSlash > 0 ? input.indexOf("@", lastSlash + 1) : -1;
     const fqnPart = constraintAt > 0 ? input.slice(0, constraintAt) : input;
-    return parseFullyQualifiedNameParts(fqnPart);
+    return parseExtensionFqnParts(fqnPart);
 };
+const INVALID_EXTENSION_FQN_MESSAGE = "Expected fully qualified name in @handle/(skills|commands|mcp-servers|subagents|files|rules|packs)/name form";
 /**
- * Fully qualified name string schema validated through the composed parts schema.
+ * Fully qualified name string schema validated against the composed handle,
+ * type, and name patterns. Annotated so JSON Schema generation surfaces a
+ * `pattern` and a top-level `ExtensionFqn` definition that `Schema.Record`
+ * keys can reference via `propertyNames`.
  *
  * @experimental This API is unstable and may change without notice.
  */
-export const FullyQualifiedNameSchema = Schema.String.pipe(Schema.check(Schema.makeFilter((value) => {
-    return parseFullyQualifiedNameParts(value) === undefined
-        ? `Expected fully qualified name in @handle/(skills|commands|mcp-servers|subagents|files|rules|packs)/name form, got: ${value}`
-        : undefined;
-})));
+export const ExtensionFqnSchema = Schema.String.pipe(Schema.check(Schema.isPattern(FQN_PATTERN, { message: INVALID_EXTENSION_FQN_MESSAGE })), Schema.annotate({
+    identifier: "ExtensionFqn",
+    title: "Extension FQN",
+    description: "Canonical extension identifier in @owner/<type>s/<name> form.",
+    examples: ["@acme/skills/code-review", "@my-org/commands/format"],
+    message: INVALID_EXTENSION_FQN_MESSAGE,
+}));
+const INVALID_NON_PACK_EXTENSION_FQN_MESSAGE = "Expected fully qualified name in @handle/(skills|commands|mcp-servers|subagents|files|rules)/name form (packs are not allowed)";
 /**
- * Fully qualified extension reference with optional version constraint.
+ * Fully qualified name string schema restricted to non-pack extension types.
+ * Used wherever pack-typed FQNs are not permitted, like the keys of a pack
+ * manifest's `dependencies` map.
  *
- * Accepts `@owner/type/name` or `@owner/type/name@constraint` where
- * the FQN portion validates through FullyQualifiedNameSchema and the
- * optional constraint validates as a semver VersionConstraint.
+ * @experimental This API is unstable and may change without notice.
+ */
+export const NonPackExtensionFqnSchema = Schema.String.pipe(Schema.check(Schema.isPattern(NON_PACK_FQN_PATTERN, { message: INVALID_NON_PACK_EXTENSION_FQN_MESSAGE })), Schema.annotate({
+    identifier: "NonPackExtensionFqn",
+    title: "Non-Pack Extension FQN",
+    description: "Extension identifier restricted to non-pack types (skills, commands, mcp-servers, subagents, files, rules).",
+    examples: ["@acme/skills/code-review", "@my-org/commands/format"],
+    message: INVALID_NON_PACK_EXTENSION_FQN_MESSAGE,
+}));
+const INVALID_PACK_FQN_MESSAGE = "Expected fully qualified pack name in @handle/packs/name form";
+/**
+ * Fully qualified name string schema restricted to the pack extension type.
+ * Used wherever only pack-typed FQNs are permitted, like the items of a
+ * non-pack manifest's `recommendedPacks` list.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const PackFqnSchema = Schema.String.pipe(Schema.check(Schema.isPattern(PACK_FQN_PATTERN, { message: INVALID_PACK_FQN_MESSAGE })), Schema.annotate({
+    identifier: "PackFqn",
+    title: "Pack FQN",
+    description: "Pack identifier in @owner/packs/<name> form.",
+    examples: ["@acme/packs/typescript", "@my-org/packs/web"],
+    message: INVALID_PACK_FQN_MESSAGE,
+}));
+/**
+ * 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 const FullyQualifiedRefSchema = Schema.String.pipe(Schema.check(Schema.makeFilter((value) => {
+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 (parseFullyQualifiedNameParts(fqnPart) === undefined) {
-        return `Expected fully qualified ref in @handle/type/name[@constraint] form, got: ${value}`;
+    if (parseExtensionFqnParts(fqnPart) === 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(VersionConstraintSchema)(constraintPart);
+        const constraintResult = Schema.decodeUnknownResult(VersionRangeSchema)(constraintPart);
         if (Result.isFailure(constraintResult)) {
             return `Expected valid version constraint after @, got: ${constraintPart}`;
         }
     }
     return undefined;
+})), Schema.check(Schema.isPattern(EXTENSION_SPEC_PATTERN, {
+    message: "Expected extension spec in @handle/type/name[@constraint] form",
 })), Schema.annotate({
-    identifier: "FullyQualifiedRef",
-    title: "Fully Qualified Extension Reference",
-    description: "An extension reference like @owner/skills/name or @owner/skills/name@^1.0.0.",
+    identifier: "ExtensionSpec",
+    title: "Extension Spec",
+    description: "Extension reference with an optional version constraint suffix.",
     examples: ["@acme/skills/code-review", "@acme/skills/code-review@^1.0.0"],
-}), Schema.brand("FullyQualifiedRef"));
+}), Schema.brand("ExtensionSpec"));
+/**
+ * Pack spec — fully qualified pack name with an optional version constraint
+ * suffix. Accepts `@owner/packs/name` or `@owner/packs/name@constraint` where
+ * the FQN portion validates through PackFqnSchema and the optional constraint
+ * validates as a semver VersionRange.
+ *
+ * @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)) {
+        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;
+})), Schema.check(Schema.isPattern(PACK_SPEC_PATTERN, {
+    message: "Expected pack spec in @handle/packs/name[@constraint] form",
+})), Schema.annotate({
+    identifier: "PackSpec",
+    title: "Pack Spec",
+    description: "Pack reference with an optional version constraint suffix.",
+    examples: ["@acme/packs/typescript", "@acme/packs/typescript@^1.0.0"],
+}), Schema.brand("PackSpec"));
 /**
  * Map of fully-qualified extension names to semver constraints.
  *
  * @experimental This API is unstable and may change without notice.
  */
-export const ExtensionDependencyConstraintMapSchema = Schema.Record(FullyQualifiedNameSchema, VersionConstraintSchema);
+export const ExtensionDependencyConstraintMapSchema = Schema.Record(ExtensionFqnSchema, VersionRangeSchema);
+/**
+ * Map of non-pack fully-qualified extension names to semver constraints.
+ * Used for pack manifest `dependencies`, which cannot include other packs.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const NonPackExtensionDependencyConstraintMapSchema = Schema.Record(NonPackExtensionFqnSchema, VersionRangeSchema).annotate({
+    description: "Map of fully-qualified non-pack extension names to version ranges. Packs cannot depend on other packs.",
+});
 /**
  * Common base fields shared across manifest types.
  * Type-specific manifests provide their own `type` and `name` fields explicitly.
@@ -261,15 +370,48 @@ export const ExtensionDependencyConstraintMapSchema = Schema.Record(FullyQualifi
  */
 export const CommonManifestBaseFields = {
     owner: HandleSchema.pipe(Schema.annotateKey({ messageMissingKey: "owner is required" })),
-    version: ExactSemverVersionSchema.pipe(Schema.annotateKey({ messageMissingKey: "version is required" })),
-    description: Schema.optional(Schema.String),
-    keywords: Schema.optional(Schema.Array(Schema.String)),
-    repository: Schema.optional(Schema.String),
-    homepage: Schema.optional(Schema.String),
-    license: Schema.optional(Schema.String),
-    bugs: Schema.optional(Schema.String),
+    version: VersionSchema.pipe(Schema.annotateKey({ messageMissingKey: "version is required" })),
+    description: Schema.optional(Schema.String.annotate({
+        description: "Short, registry-facing summary of this extension shown in listings and search results.",
+    })),
+    keywords: Schema.optional(Schema.Array(Schema.NonEmptyString).annotate({
+        examples: [["lint", "typescript", "review"]],
+    })),
+    repository: Schema.optional(Schema.String.annotate({
+        examples: ["https://github.com/acme/code-review"],
+        format: "uri",
+    })),
+    homepage: Schema.optional(Schema.String.annotate({
+        examples: ["https://acme.dev/code-review"],
+        format: "uri",
+    })),
+    license: Schema.optional(Schema.NonEmptyString.annotate({
+        examples: ["MIT", "Apache-2.0"],
+    })),
+    bugs: Schema.optional(Schema.String.annotate({
+        examples: ["https://github.com/acme/code-review/issues"],
+        format: "uri",
+    })),
     authors: Schema.optional(Schema.Array(AuthorSchema)),
-    compatiblePackages: Schema.optional(Schema.Array(PackageUrlSchema)),
+    companionPackages: Schema.optional(Schema.Array(PackageUrlSchema).pipe(Schema.annotate({
+        description: "External ecosystem packages this extension is designed to work with (e.g. the npm or PyPI package an MCP server wraps), identified by Package URL (purl).",
+    }))),
+};
+/**
+ * Fields shared across non-pack extension manifests (skills, commands,
+ * MCP servers, subagents). These describe how an extension relates to
+ * packs.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const NonPackManifestFields = {
+    recommendedPacks: Schema.optional(Schema.Array(PackSpecSchema).pipe(Schema.annotate({
+        description: "Packs this extension is designed to work alongside. Each entry is a pack spec, optionally pinned to a version range.",
+    }))),
+    standalone: Schema.optional(Schema.Boolean.pipe(Schema.annotate({
+        description: "Set to false to indicate this extension only makes sense when installed alongside one of its recommendedPacks.",
+        default: true,
+    }))),
 };
 /**
  * Agent identifier enumeration for supported coding agents.

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

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

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

@@ -5,28 +5,56 @@
  *
  * @experimental This API is unstable and may change without notice.
  */
-import * as Effect from "effect/Effect";
-import { type FullyQualifiedNameParts } from "./common.js";
+import * as Result from "effect/Result";
+import { type AppError } from "../app-error/index.js";
+import { type ExtensionFqnParts } from "./common.js";
+declare const FqnInvalidError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FqnInvalidError";
+} & Readonly<A>;
+/**
+ * Failure produced when an FQN string does not match the canonical
+ * `@owner/type-plural/name` shape.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class FqnInvalidError extends FqnInvalidError_base<{
+    readonly input: string;
+}> {
+}
 /**
  * Parse a 3-segment FQN string into its parts.
  *
+ * Pure synchronous validation — yield the Result in `Effect.gen` to bridge
+ * failures into the surrounding error channel, or pattern-match on it directly
+ * for synchronous callers.
+ *
  * @experimental This API is unstable and may change without notice.
  */
-export declare const parseFqn: (input: string) => Effect.Effect<{
-    readonly type: "command" | "skill" | "mcp-server" | "subagent" | "file" | "rule" | "pack";
-    readonly name: string & import("effect/Brand").Brand<"ExtensionName">;
-    readonly owner: string & import("effect/Brand").Brand<"Handle">;
-}, import("../app-error/app-error.ts").AppError, never>;
+export declare const parseFqn: (input: string) => Result.Result<ExtensionFqnParts, FqnInvalidError>;
 /**
- * Parse a 3-segment FQN string into its parts. Throws on invalid input.
+ * Translate a `FqnInvalidError` into a CLI-facing `AppError` with the canonical
+ * format breadcrumb. Use at user-input boundaries (CLI handlers, publish
+ * operations) where the parse failure is a user error.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const fqnInvalidErrorToAppError: (error: FqnInvalidError) => AppError;
+/**
+ * Parse a schema-validated FQN, throwing as a defect on failure.
+ *
+ * Use only at call sites where the input has already been validated against
+ * an FQN schema (e.g., manifest dependency keys, lockfile resolved maps).
+ * A failure here is an invariant violation, not a user error — inside
+ * `Effect.gen`, the synchronous throw surfaces as `Cause.Die`.
  *
  * @experimental This API is unstable and may change without notice.
  */
-export declare const parseFqnOrThrow: (input: string) => FullyQualifiedNameParts;
+export declare const parseFqnOrThrow: (input: string) => ExtensionFqnParts;
 /**
  * Format a parsed FQN back into a string.
  *
  * @experimental This API is unstable and may change without notice.
  */
-export declare const formatFqn: (fqn: FullyQualifiedNameParts) => string;
+export declare const formatFqn: (fqn: ExtensionFqnParts) => string;
+export {};
 //# sourceMappingURL=fqn.d.ts.map

package/dist/src/unstable/extensions/fqn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fqn.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/fqn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM;;;;uDAiBlC,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,uBAQ/C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,uBAAuB,KAAG,MACM,CAAC"}
+{"version":3,"file":"fqn.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/fqn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAiD,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;;;;AAEpG;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;CAAG;AAEL;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,eAAe,CAKxF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,OAAO,eAAe,KAAG,QAW/D,CAAC;AAEL;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,iBACU,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,iBAAiB,KAAG,MACY,CAAC"}

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

@@ -5,42 +5,61 @@
  *
  * @experimental This API is unstable and may change without notice.
  */
-import * as Effect from "effect/Effect";
+import * as Data from "effect/Data";
+import * as Result from "effect/Result";
 import { makeAppError } from "../app-error/index.js";
-import { parseFullyQualifiedNameParts, toExtensionTypePlural, } from "./common.js";
+import { parseExtensionFqnParts, toExtensionTypePlural } from "./common.js";
+/**
+ * Failure produced when an FQN string does not match the canonical
+ * `@owner/type-plural/name` shape.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class FqnInvalidError extends Data.TaggedError("FqnInvalidError") {
+}
 /**
  * Parse a 3-segment FQN string into its parts.
  *
+ * Pure synchronous validation — yield the Result in `Effect.gen` to bridge
+ * failures into the surrounding error channel, or pattern-match on it directly
+ * for synchronous callers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseFqn = (input) => {
+    const parsed = parseExtensionFqnParts(input);
+    return parsed === undefined
+        ? Result.fail(new FqnInvalidError({ input }))
+        : Result.succeed(parsed);
+};
+/**
+ * Translate a `FqnInvalidError` into a CLI-facing `AppError` with the canonical
+ * format breadcrumb. Use at user-input boundaries (CLI handlers, publish
+ * operations) where the parse failure is a user error.
+ *
  * @experimental This API is unstable and may change without notice.
  */
-export const parseFqn = (input) => Effect.gen(function* () {
-    const parsed = parseFullyQualifiedNameParts(input);
-    if (parsed === undefined) {
-        return yield* makeAppError({
-            code: "validation",
-            message: `Invalid fully qualified name: ${input}`,
-            breadcrumbs: [
-                {
-                    task: "Recover",
-                    description: "Use the 3-segment format: @handle/(skills|commands|mcp-servers|subagents|files|rules|packs)/name",
-                },
-            ],
-        });
-    }
-    return parsed;
+export const fqnInvalidErrorToAppError = (error) => makeAppError({
+    code: "validation",
+    message: `Invalid fully qualified name: ${error.input}`,
+    breadcrumbs: [
+        {
+            description: "Use the 3-segment format: @handle/(skills|commands|mcp-servers|subagents|files|rules|packs)/name",
+        },
+    ],
+    cause: error,
 });
 /**
- * Parse a 3-segment FQN string into its parts. Throws on invalid input.
+ * Parse a schema-validated FQN, throwing as a defect on failure.
+ *
+ * Use only at call sites where the input has already been validated against
+ * an FQN schema (e.g., manifest dependency keys, lockfile resolved maps).
+ * A failure here is an invariant violation, not a user error — inside
+ * `Effect.gen`, the synchronous throw surfaces as `Cause.Die`.
  *
  * @experimental This API is unstable and may change without notice.
  */
-export const parseFqnOrThrow = (input) => {
-    const parsed = parseFullyQualifiedNameParts(input);
-    if (parsed === undefined) {
-        throw new Error(`Invalid fully qualified name: ${input}. Expected format: @handle/(skills|commands|mcp-servers|subagents|files|rules|packs)/name`);
-    }
-    return parsed;
-};
+export const parseFqnOrThrow = (input) => Result.getOrThrowWith(parseFqn(input), (error) => error);
 /**
  * Format a parsed FQN back into a string.
  *

package/dist/src/unstable/extensions/fqn.js.map

@@ -1 +1 @@
-{"version":3,"file":"fqn.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/fqn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,GAEtB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE,CACxC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,iCAAiC,KAAK,EAAE;YACjD,WAAW,EAAE;gBACX;oBACE,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,kGAAkG;iBACrG;aACF;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAa,EAA2B,EAAE;IACxE,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,iCAAiC,KAAK,2FAA2F,CAClI,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAA4B,EAAU,EAAE,CAChE,GAAG,GAAG,CAAC,KAAK,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"fqn.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/fqn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAA0B,MAAM,aAAa,CAAC;AAEpG;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAErE;CAAG;AAEL;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAqD,EAAE;IAC3F,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAsB,EAAY,EAAE,CAC5E,YAAY,CAAC;IACX,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,iCAAiC,KAAK,CAAC,KAAK,EAAE;IACvD,WAAW,EAAE;QACX;YACE,WAAW,EACT,kGAAkG;SACrG;KACF;IACD,KAAK,EAAE,KAAK;CACb,CAAC,CAAC;AAEL;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAa,EAAqB,EAAE,CAClE,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAsB,EAAU,EAAE,CAC1D,GAAG,GAAG,CAAC,KAAK,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC"}

package/dist/src/unstable/extensions/frontmatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAkCD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,iBAWtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAexC,CAAC"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAkCD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,iBAWtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAcxC,CAAC"}

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

@@ -65,7 +65,6 @@ export const parseFrontmatterEffect = (content) => Effect.try({
         message: "YAML frontmatter could not be parsed",
         breadcrumbs: [
             {
-                task: "Recover",
                 description: "Ensure the frontmatter block contains valid YAML between --- delimiters.",
             },
         ],

package/dist/src/unstable/extensions/frontmatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AAcpE,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC;;;GAGG;AACH,MAAM,yBAAyB,GAAG,CAChC,OAAe,EACuC,EAAE;IACxD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,qBAAqB,EAAE,EAAE,YAAY,CAAC,CAAC;IACjF,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,GAAG,CAAC,GAAG,qBAAqB,CAAC,MAAM,CAAC;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAE7E,OAAO;QACL,SAAS,EAAE,YAAY,GAAG,CAAC;QAC3B,SAAS;KACV,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAqB,EAAE;IACzE,MAAM,UAAU,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,MAAM,WAAW,GAAY,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAEjD,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,SAAS,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAe,EAC6B,EAAE,CAC9C,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC;IACxC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,YAAY,CAAC;QACX,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,sCAAsC;QAC/C,WAAW,EAAE;YACX;gBACE,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,0EAA0E;aACxF;SACF;QACD,KAAK,EAAE,KAAK;KACb,CAAC;CACL,CAAC,CAAC"}
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AAcpE,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC;;;GAGG;AACH,MAAM,yBAAyB,GAAG,CAChC,OAAe,EACuC,EAAE;IACxD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,qBAAqB,EAAE,EAAE,YAAY,CAAC,CAAC;IACjF,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,GAAG,CAAC,GAAG,qBAAqB,CAAC,MAAM,CAAC;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAE7E,OAAO;QACL,SAAS,EAAE,YAAY,GAAG,CAAC;QAC3B,SAAS;KACV,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAqB,EAAE;IACzE,MAAM,UAAU,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,MAAM,WAAW,GAAY,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAEjD,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,SAAS,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAe,EAC6B,EAAE,CAC9C,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC;IACxC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,YAAY,CAAC;QACX,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,sCAAsC;QAC/C,WAAW,EAAE;YACX;gBACE,WAAW,EAAE,0EAA0E;aACxF;SACF;QACD,KAAK,EAAE,KAAK;KACb,CAAC;CACL,CAAC,CAAC"}

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

@@ -4,18 +4,18 @@
  * @experimental All exports from this module are unstable and may change without notice.
  * @packageDocumentation
  */
-export { AgentIdSchema, AuthorSchema, CommonManifestBaseFields, EXTENSION_NAME_PATTERN, ExtensionNameSchema, ExtensionTypePluralSchema, ExtensionDependencyConstraintMapSchema, ExtensionTypeSchema, FQN_PATTERN, FullyQualifiedNamePartsSchema, FullyQualifiedNameSchema, FullyQualifiedRefSchema, parseFullyQualifiedRefParts, decodeExtensionNameSync, extensionTypeFromPlural, extensionTypeLabels, extensionTypePluralSegments, extensionTypePluralLabels, extensionTypePluralSentenceLabels, extensionTypeSentenceLabels, extensionTypeToPlural, extensionTypes, isExtensionType, isExtensionTypePlural, parseFullyQualifiedNameParts, toExtensionType, toExtensionTypePlural, toAuthor, type Author, type ExtensionName, type ExtensionDependencyConstraintMap, type FullyQualifiedNameParts, type ExtensionType, type ExtensionTypePlural, type FullyQualifiedName, type FullyQualifiedRef, } from "./common.js";
+export { AgentIdSchema, AuthorSchema, CommonManifestBaseFields, EXTENSION_NAME_PATTERN, ExtensionNameSchema, ExtensionTypePluralSchema, ExtensionDependencyConstraintMapSchema, ExtensionTypeSchema, FQN_PATTERN, ExtensionFqnPartsSchema, ExtensionFqnSchema, ExtensionSpecSchema, NON_PACK_FQN_PATTERN, NonPackExtensionDependencyConstraintMapSchema, NonPackExtensionFqnSchema, NonPackManifestFields, nonPackExtensionTypePluralSegments, PACK_FQN_PATTERN, PackFqnSchema, PackSpecSchema, parseExtensionSpecParts, decodeExtensionNameSync, extensionTypeFromPlural, extensionTypeLabels, extensionTypePluralSegments, extensionTypePluralLabels, extensionTypePluralSentenceLabels, extensionTypeSentenceLabels, extensionTypeToPlural, extensionTypes, isExtensionType, isExtensionTypePlural, parseExtensionFqnParts, toExtensionType, toExtensionTypePlural, toAuthor, type Author, type ExtensionName, type ExtensionDependencyConstraintMap, type ExtensionFqnParts, type ExtensionType, type ExtensionTypePlural, type ExtensionFqn, type ExtensionSpec, type NonPackExtensionDependencyConstraintMap, type NonPackExtensionFqn, type NonPackExtensionTypePlural, type PackFqn, type PackSpec, } from "./common.js";
 export { RegistrySourcePatternPartsSchema, RegistrySourcePatternSchema, RegistrySourceRefPartsSchema, RegistrySourceRefSchema, formatRegistrySourcePatternParts, formatRegistrySourceRef, parseRegistrySourcePatternParts, parseRegistrySourceRef, type RegistrySourcePatternParts, type RegistrySourceRefParts, } from "./registry-source.js";
 export { installableExtensionTypes, installableExtensionTypePluralSegments, InstallableExtensionTypeSchema, InstallableExtensionTypePluralSchema, isInstallableExtensionType, isInstallableExtensionTypePlural, toInstallableExtensionType, toInstallableExtensionTypePlural, type InstallableExtensionType, type InstallableExtensionTypePlural, } from "./installable-types.js";
 export { HANDLE_PATTERN, HANDLE_PATTERN_SOURCE, HandleSchema, SLUG_PATTERN, SLUG_PATTERN_SOURCE, SlugSchema, decodeHandleSync, decodeSlugSync, handleFromSlug, normalizeHandle, normalizeSlug, slugFromHandle, type Handle, type Slug, } from "./handle.js";
-export { formatFqn, parseFqn, parseFqnOrThrow } from "./fqn.js";
+export { formatFqn, parseFqn, parseFqnOrThrow, FqnInvalidError, fqnInvalidErrorToAppError, } from "./fqn.js";
 export { EXTERNAL_EXTENSIONS_DIR, REGISTRY_EXTENSIONS_DIR } from "./constants.js";
 export { UNIVERSAL_SKILLS_DIR, UNIVERSAL_SKILLS_DIR_SEGMENT, isUniversalSkillsDir, isUniversalSkillsRelativeDir, resolveUniversalDirPresence, } from "./universal-skills-dir.js";
-export type { ExtensionRefBase, SkillExtensionRefBase, CommandExtensionRefBase, McpServerExtensionRefBase, ExtensionPackRefBase, GitHostedRefDetails, RegistryRefDetails, LocalRefDetails, } from "./ref-base.js";
+export type { ExtensionRefBase, SkillExtensionRefBase, CommandExtensionRefBase, McpServerExtensionRefBase, PackRefBase, GitHostedRefDetails, RegistryRefDetails, LocalRefDetails, } from "./ref-base.js";
 export type { ExtensionRef } from "./refs.js";
 export { sanitizeName, copyExtensionDirectory, validatePathSafety } from "./utils.js";
 export { readAndDecodeManifest } from "./reconciliation-utils.js";
-export { type InstallOperationArgs, type MaterializeOperationArgs, type UninstallOperationArgs, type UninstallRetentionPolicy, buildInstallOperation, buildMaterializeOperation, buildUninstallOperation, formatPackageUrlParts, targetFromRef, toLabel, toLabelWithCompatibility, } from "./operations.js";
+export { type InstallOperationArgs, type MaterializeOperationArgs, type UninstallOperationArgs, type UninstallRetentionPolicy, buildInstallOperation, buildMaterializeOperation, buildUninstallOperation, formatPackageUrlParts, targetFromRef, toLabel, toLabelWithCompanions, } from "./operations.js";
 export { configuredCommandsToDiskRefs, configuredMcpServersToDiskRefs, configuredPacksToDiskRefs, configuredSkillsToDiskRefs, configuredSubagentsToDiskRefs, } from "./materializable-from-disk.js";
 export { RenderedFilePathSchema, RenderedFilesMapSchema, SourceHashSchema, computeSourceHash, type RenderedFilePath, type RenderedFilesMap, type SourceHash, } from "./rendered-files.js";
 export { parseFrontmatterEffect, parseFrontmatterSync, type FrontmatterResult, } from "./frontmatter.js";