@agentxm/client-core 0.1.6

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

@@ -0,0 +1 @@
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,eAAO,MAAM,mBAAmB,uCAAuC,CAAC;AACxE,eAAO,MAAM,qBAAqB,wCAA4B,CAAC;AAE/D,eAAO,MAAM,YAAY,QAAyC,CAAC;AACnE,eAAO,MAAM,cAAc,QAA2C,CAAC;AAEvE,eAAO,MAAM,UAAU,qCActB,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC;AAEzD,eAAO,MAAM,YAAY,uCAcxB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC,CAAC;AAE7D,eAAO,MAAM,gBAAgB,wHAAyC,CAAC;AACvE,eAAO,MAAM,cAAc,sHAAuC,CAAC;AAEnE,eAAO,MAAM,cAAc,GAAI,MAAM,IAAI,KAAG,MAAsC,CAAC;AAEnF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,IAAuC,CAAC;AAExF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,IAAiD,CAAC;AAE/F,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MACF,CAAC"}

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

@@ -0,0 +1,30 @@
+import * as Schema from "effect/Schema";
+export const SLUG_PATTERN_SOURCE = "[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?";
+export const HANDLE_PATTERN_SOURCE = `@${SLUG_PATTERN_SOURCE}`;
+export const SLUG_PATTERN = new RegExp(`^${SLUG_PATTERN_SOURCE}$`);
+export const HANDLE_PATTERN = new RegExp(`^${HANDLE_PATTERN_SOURCE}$`);
+export const SlugSchema = Schema.String.pipe(Schema.check(Schema.isPattern(SLUG_PATTERN, {
+    message: "Expected a valid slug (lowercase alphanumeric, hyphens, and underscores)",
+})), Schema.annotate({
+    identifier: "Slug",
+    title: "Slug",
+    description: "A short name using lowercase letters, numbers, hyphens, and underscores.",
+    examples: ["my-org", "user_name"],
+    message: "Expected a valid slug (e.g., my-org)",
+}), Schema.brand("Slug"));
+export const HandleSchema = Schema.String.pipe(Schema.check(Schema.isPattern(HANDLE_PATTERN, {
+    message: "Expected a valid handle starting with @ (e.g., @my-org)",
+})), Schema.annotate({
+    identifier: "Handle",
+    title: "Handle",
+    description: "A unique username or organization name starting with @, like @my-org.",
+    examples: ["@my-org", "@username"],
+    message: "Expected a valid handle (e.g., @my-org)",
+}), Schema.brand("Handle"));
+export const decodeHandleSync = Schema.decodeUnknownSync(HandleSchema);
+export const decodeSlugSync = Schema.decodeUnknownSync(SlugSchema);
+export const handleFromSlug = (slug) => decodeHandleSync(`@${slug}`);
+export const slugFromHandle = (handle) => decodeSlugSync(handle.slice(1));
+export const normalizeSlug = (slug) => decodeSlugSync(slug.trim().toLowerCase());
+export const normalizeHandle = (handle) => decodeHandleSync(handle.trim().toLowerCase());
+//# sourceMappingURL=handle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AACxE,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAE/D,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,IAAI,mBAAmB,GAAG,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,IAAI,qBAAqB,GAAG,CAAC,CAAC;AAEvE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC1C,MAAM,CAAC,KAAK,CACV,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE;IAC7B,OAAO,EAAE,0EAA0E;CACpF,CAAC,CACH,EACD,MAAM,CAAC,QAAQ,CAAC;IACd,UAAU,EAAE,MAAM;IAClB,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,0EAA0E;IACvF,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;IACjC,OAAO,EAAE,sCAAsC;CAChD,CAAC,EACF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CACrB,CAAC;AAIF,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC5C,MAAM,CAAC,KAAK,CACV,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE;IAC/B,OAAO,EAAE,yDAAyD;CACnE,CAAC,CACH,EACD,MAAM,CAAC,QAAQ,CAAC;IACd,UAAU,EAAE,QAAQ;IACpB,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,uEAAuE;IACpF,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;IAClC,OAAO,EAAE,yCAAyC;CACnD,CAAC,EACF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CACvB,CAAC;AAIF,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAU,EAAU,EAAE,CAAC,gBAAgB,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAQ,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAQ,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAE/F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAU,EAAE,CACxD,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Extension schemas, types, and shared utilities for @agentxm/client-core.
+ *
+ * @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 { 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 { EXTERNAL_EXTENSIONS_DIR, REGISTRY_EXTENSIONS_DIR } from "./constants.js";
+export type { ExtensionRefBase, SkillExtensionRefBase, CommandExtensionRefBase, McpServerExtensionRefBase, ExtensionPackRefBase, 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 UninstallOperationArgs, type UninstallRetentionPolicy, buildInstallOperation, buildUninstallOperation, formatPackageUrlParts, targetFromRef, toLabel, toLabelWithCompatibility, } from "./operations.js";
+export { ManagedMarkerSchema, generateMarker, isManagedByAxm, stripMarker, type ManagedMarker, } from "./managed-marker.js";
+export { RenderedFilePathSchema, RenderedFilesMapSchema, SourceHashSchema, computeSourceHash, type RenderedFilePath, type RenderedFilesMap, type SourceHash, } from "./rendered-files.js";
+export { detectConflict, type ConflictDetectionResult } from "./conflict-detection.js";
+export { parseFrontmatterEffect, parseFrontmatterSync, type FrontmatterResult, } from "./frontmatter.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,sCAAsC,EACtC,mBAAmB,EACnB,WAAW,EACX,6BAA6B,EAC7B,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,yBAAyB,EACzB,iCAAiC,EACjC,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,4BAA4B,EAC5B,eAAe,EACf,qBAAqB,EACrB,QAAQ,EACR,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,gCAAgC,EACrC,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACvB,gCAAgC,EAChC,uBAAuB,EACvB,+BAA+B,EAC/B,sBAAsB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,yBAAyB,EACzB,sCAAsC,EACtC,8BAA8B,EAC9B,oCAAoC,EACpC,0BAA0B,EAC1B,gCAAgC,EAChC,0BAA0B,EAC1B,gCAAgC,EAChC,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,GACpC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,KAAK,MAAM,EACX,KAAK,IAAI,GACV,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhE,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAGlF,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,aAAa,EACb,OAAO,EACP,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,WAAW,EACX,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGvF,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * Extension schemas, types, and shared utilities for @agentxm/client-core.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Common schemas and types
+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, } from "./common.js";
+export { RegistrySourcePatternPartsSchema, RegistrySourcePatternSchema, RegistrySourceRefPartsSchema, RegistrySourceRefSchema, formatRegistrySourcePatternParts, formatRegistrySourceRef, parseRegistrySourcePatternParts, parseRegistrySourceRef, } from "./registry-source.js";
+export { installableExtensionTypes, installableExtensionTypePluralSegments, InstallableExtensionTypeSchema, InstallableExtensionTypePluralSchema, isInstallableExtensionType, isInstallableExtensionTypePlural, toInstallableExtensionType, toInstallableExtensionTypePlural, } from "./installable-types.js";
+export { HANDLE_PATTERN, HANDLE_PATTERN_SOURCE, HandleSchema, SLUG_PATTERN, SLUG_PATTERN_SOURCE, SlugSchema, decodeHandleSync, decodeSlugSync, handleFromSlug, normalizeHandle, normalizeSlug, slugFromHandle, } from "./handle.js";
+// FQN parsing
+export { formatFqn, parseFqn, parseFqnOrThrow } from "./fqn.js";
+// Constants
+export { EXTERNAL_EXTENSIONS_DIR, REGISTRY_EXTENSIONS_DIR } from "./constants.js";
+// Shared utilities
+export { sanitizeName, copyExtensionDirectory, validatePathSafety } from "./utils.js";
+// Reconciliation utilities
+export { readAndDecodeManifest } from "./reconciliation-utils.js";
+// Extension operations
+export { buildInstallOperation, buildUninstallOperation, formatPackageUrlParts, targetFromRef, toLabel, toLabelWithCompatibility, } from "./operations.js";
+// Managed markers
+export { ManagedMarkerSchema, generateMarker, isManagedByAxm, stripMarker, } from "./managed-marker.js";
+// Rendered files tracking
+export { RenderedFilePathSchema, RenderedFilesMapSchema, SourceHashSchema, computeSourceHash, } from "./rendered-files.js";
+// Conflict detection
+export { detectConflict } from "./conflict-detection.js";
+// Frontmatter parsing
+export { parseFrontmatterEffect, parseFrontmatterSync, } from "./frontmatter.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2BAA2B;AAC3B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,sCAAsC,EACtC,mBAAmB,EACnB,WAAW,EACX,6BAA6B,EAC7B,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,yBAAyB,EACzB,iCAAiC,EACjC,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,4BAA4B,EAC5B,eAAe,EACf,qBAAqB,EACrB,QAAQ,GAST,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACvB,gCAAgC,EAChC,uBAAuB,EACvB,+BAA+B,EAC/B,sBAAsB,GAGvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,yBAAyB,EACzB,sCAAsC,EACtC,8BAA8B,EAC9B,oCAAoC,EACpC,0BAA0B,EAC1B,gCAAgC,EAChC,0BAA0B,EAC1B,gCAAgC,GAGjC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,GAGf,MAAM,aAAa,CAAC;AAErB,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhE,YAAY;AACZ,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAiBlF,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEtF,2BAA2B;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,uBAAuB;AACvB,OAAO,EAIL,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,aAAa,EACb,OAAO,EACP,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,kBAAkB;AAClB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,WAAW,GAEZ,MAAM,qBAAqB,CAAC;AAE7B,0BAA0B;AAC1B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,GAIlB,MAAM,qBAAqB,CAAC;AAE7B,qBAAqB;AACrB,OAAO,EAAE,cAAc,EAAgC,MAAM,yBAAyB,CAAC;AAEvF,sBAAsB;AACtB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GAErB,MAAM,kBAAkB,CAAC"}

package/dist/src/unstable/extensions/installable-types.d.ts

@@ -0,0 +1,13 @@
+import * as Schema from "effect/Schema";
+import type { ExtensionType } from "./common.js";
+export declare const installableExtensionTypes: readonly ["skill", "command", "mcp-server", "subagent", "pack"];
+export type InstallableExtensionType = (typeof installableExtensionTypes)[number];
+export declare const isInstallableExtensionType: (value: ExtensionType) => value is InstallableExtensionType;
+export declare const installableExtensionTypePluralSegments: readonly ["skills", "commands", "mcp-servers", "subagents", "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", "command", "mcp-server", "subagent", "pack"]>;
+export declare const InstallableExtensionTypePluralSchema: Schema.Literals<readonly ["skills", "commands", "mcp-servers", "subagents", "packs"]>;
+//# sourceMappingURL=installable-types.d.ts.map

package/dist/src/unstable/extensions/installable-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installable-types.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/installable-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AAEtE,eAAO,MAAM,yBAAyB,iEAMW,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIlF,eAAO,MAAM,0BAA0B,GACrC,OAAO,aAAa,KACnB,KAAK,IAAI,wBAAkE,CAAC;AAE/E,eAAO,MAAM,sCAAsC,sEAMI,CAAC;AAExD,MAAM,MAAM,8BAA8B,GACxC,CAAC,OAAO,sCAAsC,CAAC,CAAC,MAAM,CAAC,CAAC;AAI1D,eAAO,MAAM,gCAAgC,GAC3C,OAAO,MAAM,GAAG,SAAS,KACxB,KAAK,IAAI,8BACyD,CAAC;AAwBtE,eAAO,MAAM,0BAA0B,GACrC,SAAS,8BAA8B,KACtC,wBAAuE,CAAC;AAE3E,eAAO,MAAM,gCAAgC,GAC3C,MAAM,wBAAwB,KAC7B,8BAAwE,CAAC;AAE5E,eAAO,MAAM,8BAA8B,kFAIzC,CAAC;AAEH,eAAO,MAAM,oCAAoC,uFAO/C,CAAC"}

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

@@ -0,0 +1,46 @@
+import * as Schema from "effect/Schema";
+export const installableExtensionTypes = [
+    "skill",
+    "command",
+    "mcp-server",
+    "subagent",
+    "pack",
+];
+const installableExtensionTypeSet = new Set(installableExtensionTypes);
+export const isInstallableExtensionType = (value) => installableExtensionTypeSet.has(value);
+export const installableExtensionTypePluralSegments = [
+    "skills",
+    "commands",
+    "mcp-servers",
+    "subagents",
+    "packs",
+];
+const installableExtensionTypePluralSet = new Set(installableExtensionTypePluralSegments);
+export const isInstallableExtensionTypePlural = (value) => value !== undefined && installableExtensionTypePluralSet.has(value);
+const installableExtensionTypeFromPlural = {
+    skills: "skill",
+    commands: "command",
+    "mcp-servers": "mcp-server",
+    subagents: "subagent",
+    packs: "pack",
+};
+const installableExtensionTypeToPlural = {
+    skill: "skills",
+    command: "commands",
+    "mcp-server": "mcp-servers",
+    subagent: "subagents",
+    pack: "packs",
+};
+export const toInstallableExtensionType = (segment) => installableExtensionTypeFromPlural[segment];
+export const toInstallableExtensionTypePlural = (type) => installableExtensionTypeToPlural[type];
+export const InstallableExtensionTypeSchema = Schema.Literals(installableExtensionTypes).annotate({
+    identifier: "InstallableExtensionType",
+    title: "Installable Extension Type",
+    description: "Extension types supported by install-oriented CLI and registry flows.",
+});
+export const InstallableExtensionTypePluralSchema = Schema.Literals(installableExtensionTypePluralSegments).annotate({
+    identifier: "InstallableExtensionTypePlural",
+    title: "Installable Extension Type (Plural)",
+    description: "Plural extension type segments supported by install-oriented CLI and registry flows.",
+});
+//# sourceMappingURL=installable-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installable-types.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/installable-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,OAAO;IACP,SAAS;IACT,YAAY;IACZ,UAAU;IACV,MAAM;CACyC,CAAC;AAIlD,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAS,yBAAyB,CAAC,CAAC;AAE/E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,KAAoB,EACe,EAAE,CAAC,2BAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAE/E,MAAM,CAAC,MAAM,sCAAsC,GAAG;IACpD,QAAQ;IACR,UAAU;IACV,aAAa;IACb,WAAW;IACX,OAAO;CAC8C,CAAC;AAKxD,MAAM,iCAAiC,GAAG,IAAI,GAAG,CAAS,sCAAsC,CAAC,CAAC;AAElG,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,KAAyB,EACgB,EAAE,CAC3C,KAAK,KAAK,SAAS,IAAI,iCAAiC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAEtE,MAAM,kCAAkC,GAGpC;IACF,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,SAAS;IACnB,aAAa,EAAE,YAAY;IAC3B,SAAS,EAAE,UAAU;IACrB,KAAK,EAAE,MAAM;CACd,CAAC;AAEF,MAAM,gCAAgC,GAGlC;IACF,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,UAAU;IACnB,YAAY,EAAE,aAAa;IAC3B,QAAQ,EAAE,WAAW;IACrB,IAAI,EAAE,OAAO;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,OAAuC,EACb,EAAE,CAAC,kCAAkC,CAAC,OAAO,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,IAA8B,EACE,EAAE,CAAC,gCAAgC,CAAC,IAAI,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,QAAQ,CAAC;IAChG,UAAU,EAAE,0BAA0B;IACtC,KAAK,EAAE,4BAA4B;IACnC,WAAW,EAAE,uEAAuE;CACrF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oCAAoC,GAAG,MAAM,CAAC,QAAQ,CACjE,sCAAsC,CACvC,CAAC,QAAQ,CAAC;IACT,UAAU,EAAE,gCAAgC;IAC5C,KAAK,EAAE,qCAAqC;IAC5C,WAAW,EACT,sFAAsF;CACzF,CAAC,CAAC"}

package/dist/src/unstable/extensions/managed-marker.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Managed marker utilities for extension-rendered files.
+ *
+ * A managed marker is a comment placed at the start of a file to indicate
+ * that axm owns and manages the file. This allows conflict detection to
+ * distinguish user-written files from axm-rendered files.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Branded string type for managed markers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ManagedMarkerSchema: Schema.brand<Schema.String, "ManagedMarker">;
+/**
+ * Branded ManagedMarker type.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ManagedMarker = Schema.Schema.Type<typeof ManagedMarkerSchema>;
+/**
+ * Generate a managed marker for a given extension type and file format.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const generateMarker: (extensionType: string, format: "markdown" | "toml" | "text") => ManagedMarker;
+/**
+ * Check whether content starts with a managed marker.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const isManagedByAxm: (content: string) => boolean;
+/**
+ * Remove the managed marker line from the beginning of content.
+ * Returns the original content unchanged if no marker is present.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const stripMarker: (content: string) => string;
+//# sourceMappingURL=managed-marker.d.ts.map

package/dist/src/unstable/extensions/managed-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-marker.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/managed-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,8CAAoD,CAAC;AAErF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAgB3E;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,eAAe,MAAM,EACrB,QAAQ,UAAU,GAAG,MAAM,GAAG,MAAM,KACnC,aAMF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,OAA+C,CAAC;AAEjG;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,MAS7C,CAAC"}

package/dist/src/unstable/extensions/managed-marker.js

@@ -0,0 +1,60 @@
+/**
+ * Managed marker utilities for extension-rendered files.
+ *
+ * A managed marker is a comment placed at the start of a file to indicate
+ * that axm owns and manages the file. This allows conflict detection to
+ * distinguish user-written files from axm-rendered files.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Branded string type for managed markers.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ManagedMarkerSchema = Schema.String.pipe(Schema.brand("ManagedMarker"));
+const decodeManagedMarker = Schema.decodeUnknownSync(ManagedMarkerSchema);
+const MARKDOWN_MARKER_PREFIX = `<!-- Managed by axm \u2014 see "axm `;
+const MARKDOWN_MARKER_SUFFIX = ` --help" -->`;
+const HASH_MARKER_PREFIX = `# Managed by axm \u2014 see "axm `;
+const HASH_MARKER_SUFFIX = ` --help"`;
+/**
+ * Regex matching managed markers at the start of content.
+ * Matches both markdown-style (`<!-- ... -->`) and hash-style (`# ...`) markers.
+ */
+const MANAGED_MARKER_PATTERN = /^(?:<!-- Managed by axm — see "axm [^"]+ --help" -->|# Managed by axm — see "axm [^"]+ --help")/;
+/**
+ * Generate a managed marker for a given extension type and file format.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const generateMarker = (extensionType, format) => {
+    const marker = format === "markdown"
+        ? `${MARKDOWN_MARKER_PREFIX}${extensionType}${MARKDOWN_MARKER_SUFFIX}`
+        : `${HASH_MARKER_PREFIX}${extensionType}${HASH_MARKER_SUFFIX}`;
+    return decodeManagedMarker(marker);
+};
+/**
+ * Check whether content starts with a managed marker.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const isManagedByAxm = (content) => MANAGED_MARKER_PATTERN.test(content);
+/**
+ * Remove the managed marker line from the beginning of content.
+ * Returns the original content unchanged if no marker is present.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const stripMarker = (content) => {
+    if (!isManagedByAxm(content)) {
+        return content;
+    }
+    const newlineIndex = content.indexOf("\n");
+    if (newlineIndex === -1) {
+        return "";
+    }
+    return content.slice(newlineIndex + 1);
+};
+//# sourceMappingURL=managed-marker.js.map

package/dist/src/unstable/extensions/managed-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-marker.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/managed-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;AASrF,MAAM,mBAAmB,GAAG,MAAM,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;AAE1E,MAAM,sBAAsB,GAAG,sCAAsC,CAAC;AACtE,MAAM,sBAAsB,GAAG,cAAc,CAAC;AAC9C,MAAM,kBAAkB,GAAG,mCAAmC,CAAC;AAC/D,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAEtC;;;GAGG;AACH,MAAM,sBAAsB,GAC1B,iGAAiG,CAAC;AAEpG;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,aAAqB,EACrB,MAAoC,EACrB,EAAE;IACjB,MAAM,MAAM,GACV,MAAM,KAAK,UAAU;QACnB,CAAC,CAAC,GAAG,sBAAsB,GAAG,aAAa,GAAG,sBAAsB,EAAE;QACtE,CAAC,CAAC,GAAG,kBAAkB,GAAG,aAAa,GAAG,kBAAkB,EAAE,CAAC;IACnE,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAW,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAEjG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAU,EAAE;IACrD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * Shared extension operation workflows — install and uninstall operation builders.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import type * as Option from "effect/Option";
+import type { AppError } from "../app-error/index.js";
+import type { PlannedJobStep } from "../workspace/plan.js";
+import type { ExtensionRef } from "./refs.js";
+import type { PackageUrlParts } from "../packaging/package-url.js";
+import type { ExtensionManager, ExtensionTarget, ExtensionTargetFor } from "../workspace/service-interface.js";
+/**
+ * Derive an ExtensionTarget from an ExtensionRef.
+ *
+ * Pack targets include owner; skill/command/mcp-server targets are name-only.
+ */
+export declare const targetFromRef: (ref: ExtensionRef) => ExtensionTarget;
+/**
+ * Produce a display label from an ExtensionTarget.
+ *
+ * Pack targets render as `owner/name`; others render as `name`.
+ */
+export declare const toLabel: (target: ExtensionTarget) => string;
+/**
+ * Produce a stable step identity key from an ExtensionTarget.
+ *
+ * This is internal plan identity, not display text.
+ */
+export declare const toStepKey: (target: ExtensionTarget) => string;
+/**
+ * Format a single PackageUrlParts as a compact display string.
+ *
+ * Examples: `pkg:npm/react`, `pkg:npm/@angular/core@18.0.0`
+ */
+export declare const formatPackageUrlParts: (parts: PackageUrlParts) => string;
+/**
+ * Build a display label with optional compatiblePackages suffix.
+ *
+ * When compatiblePackages is non-empty, appends them parenthesized:
+ *   `code-review (pkg:npm/react, pkg:npm/typescript)`
+ */
+export declare const toLabelWithCompatibility: (target: ExtensionTarget, compatiblePackages: ReadonlyArray<PackageUrlParts>) => string;
+/**
+ * Cross-cutting uninstall dependency-retention policy.
+ *
+ * Captured from workspace service at plan-build time and passed to
+ * runUninstallOperation. All methods have `R = never`.
+ */
+export interface UninstallRetentionPolicy {
+    readonly isRequiredByInstalledPack: (args: {
+        readonly target: ExtensionTarget;
+    }) => Effect.Effect<boolean, AppError, never>;
+    readonly markDependencyRetainedInLockfile: (args: {
+        readonly target: ExtensionTarget;
+    }) => Effect.Effect<void, AppError, never>;
+}
+export interface InstallOperationArgs<TRef extends ExtensionRef> {
+    readonly ref: TRef;
+    readonly versionConstraint: Option.Option<string>;
+    /** When true, skip writing to settings (e.g. pack dependency installs). */
+    readonly skipSettings?: boolean;
+}
+/**
+ * Build a PlannedJobStep for an install operation.
+ *
+ * The step captures the manager and args in its `run` closure so execution
+ * requires no runtime service resolution (`R = never`).
+ */
+export declare const buildInstallOperation: <TRef extends ExtensionRef>(manager: ExtensionManager<TRef>, args: InstallOperationArgs<TRef>) => PlannedJobStep;
+export interface UninstallOperationArgs<TRef extends ExtensionRef> {
+    readonly target: ExtensionTargetFor<TRef>;
+}
+/**
+ * Build a PlannedJobStep for an uninstall operation.
+ *
+ * The step captures the manager, retention policy, and target in its `run`
+ * closure so execution requires no runtime service resolution (`R = never`).
+ */
+export declare const buildUninstallOperation: <TRef extends ExtensionRef>(manager: ExtensionManager<TRef>, retentionPolicy: UninstallRetentionPolicy, args: UninstallOperationArgs<TRef>) => PlannedJobStep;
+//# sourceMappingURL=operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAM3C;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,YAAY,KAAG,eAajD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,eAAe,KAAG,MACuB,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,eAAe,KAAG,MAGf,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,eAAe,KAAG,MAI9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,eAAe,EACvB,oBAAoB,aAAa,CAAC,eAAe,CAAC,KACjD,MAKF,CAAC;AAMF;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,yBAAyB,EAAE,CAAC,IAAI,EAAE;QACzC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;KAClC,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9C,QAAQ,CAAC,gCAAgC,EAAE,CAAC,IAAI,EAAE;QAChD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;KAClC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;CAC5C;AAMD,MAAM,WAAW,oBAAoB,CAAC,IAAI,SAAS,YAAY;IAC7D,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAwBD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,IAAI,SAAS,YAAY,EAC7D,SAAS,gBAAgB,CAAC,IAAI,CAAC,EAC/B,MAAM,oBAAoB,CAAC,IAAI,CAAC,KAC/B,cAUF,CAAC;AAMF,MAAM,WAAW,sBAAsB,CAAC,IAAI,SAAS,YAAY;IAC/D,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;CAC3C;AAkDD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,IAAI,SAAS,YAAY,EAC/D,SAAS,gBAAgB,CAAC,IAAI,CAAC,EAC/B,iBAAiB,wBAAwB,EACzC,MAAM,sBAAsB,CAAC,IAAI,CAAC,KACjC,cAMF,CAAC"}

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

@@ -0,0 +1,152 @@
+/**
+ * Shared extension operation workflows — install and uninstall operation builders.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+// -----------------------------------------------------------------------------
+// Target Helpers
+// -----------------------------------------------------------------------------
+/**
+ * Derive an ExtensionTarget from an ExtensionRef.
+ *
+ * Pack targets include owner; skill/command/mcp-server targets are name-only.
+ */
+export const targetFromRef = (ref) => {
+    switch (ref.type) {
+        case "skill":
+            return { type: "skill", name: ref.skill.name };
+        case "pack":
+            return { type: "pack", name: ref.pack.name, owner: ref.owner };
+        case "command":
+            return { type: "command", name: ref.command.name };
+        case "mcp-server":
+            return { type: "mcp-server", name: ref.server.name };
+        case "subagent":
+            return { type: "subagent", name: ref.subagent.name };
+    }
+};
+/**
+ * Produce a display label from an ExtensionTarget.
+ *
+ * Pack targets render as `owner/name`; others render as `name`.
+ */
+export const toLabel = (target) => target.type === "pack" ? `${target.owner}/${target.name}` : target.name;
+/**
+ * Produce a stable step identity key from an ExtensionTarget.
+ *
+ * This is internal plan identity, not display text.
+ */
+export const toStepKey = (target) => target.type === "pack"
+    ? `${target.type}:${target.owner}/${target.name}`
+    : `${target.type}:${target.name}`;
+/**
+ * Format a single PackageUrlParts as a compact display string.
+ *
+ * Examples: `pkg:npm/react`, `pkg:npm/@angular/core@18.0.0`
+ */
+export const formatPackageUrlParts = (parts) => {
+    const ns = parts.namespace !== undefined ? `${parts.namespace}/` : "";
+    const ver = parts.version !== undefined ? `@${parts.version}` : "";
+    return `pkg:${parts.type}/${ns}${parts.name}${ver}`;
+};
+/**
+ * Build a display label with optional compatiblePackages suffix.
+ *
+ * When compatiblePackages is non-empty, appends them parenthesized:
+ *   `code-review (pkg:npm/react, pkg:npm/typescript)`
+ */
+export const toLabelWithCompatibility = (target, compatiblePackages) => {
+    const base = toLabel(target);
+    if (compatiblePackages.length === 0)
+        return base;
+    const purls = compatiblePackages.map(formatPackageUrlParts).join(", ");
+    return `${base} (${purls})`;
+};
+/**
+ * Execute the canonical install sequence: materialize -> lockfile -> settings.
+ */
+const runInstallOperation = (manager, args) => Effect.gen(function* () {
+    yield* manager.materializeInstall({ ref: args.ref });
+    yield* manager.upsertLockfileEntry({ ref: args.ref });
+    if (!args.skipSettings) {
+        yield* manager.upsertSettingsEntry({
+            ref: args.ref,
+            versionConstraint: args.versionConstraint,
+        });
+    }
+    return {
+        result: "success",
+        message: "Applied install operation",
+    };
+});
+/**
+ * Build a PlannedJobStep for an install operation.
+ *
+ * The step captures the manager and args in its `run` closure so execution
+ * requires no runtime service resolution (`R = never`).
+ */
+export const buildInstallOperation = (manager, args) => {
+    const target = targetFromRef(args.ref);
+    const compatPkgs = args.ref.refType === "registry" ? args.ref.compatiblePackages : [];
+    return {
+        key: toStepKey(target),
+        label: toLabelWithCompatibility(target, compatPkgs),
+        readiness: "ready",
+        run: runInstallOperation(manager, args),
+    };
+};
+/**
+ * Execute the uninstall sequence with retention check.
+ *
+ * If the target is still required by an installed pack:
+ *   1. Remove settings entry
+ *   2. Mark dependency as retained in lockfile
+ *
+ * If not required:
+ *   1. Unmaterialize from disk
+ *   2. Remove lockfile entry
+ *   3. Remove settings entry
+ */
+const runUninstallOperation = (manager, retentionPolicy, args) => Effect.gen(function* () {
+    const isInstalled = yield* manager.isInstalled({ target: args.target });
+    if (!isInstalled) {
+        return {
+            result: "success",
+            message: "not installed",
+        };
+    }
+    const stillRequiredByPack = yield* retentionPolicy.isRequiredByInstalledPack({
+        target: args.target,
+    });
+    if (stillRequiredByPack) {
+        yield* manager.removeSettingsEntry({ target: args.target });
+        yield* retentionPolicy.markDependencyRetainedInLockfile({ target: args.target });
+        return {
+            result: "success",
+            message: "Kept on disk because dependency is still required by an installed pack",
+        };
+    }
+    yield* manager.materializeUninstall({ target: args.target });
+    yield* manager.removeLockfileEntry({ target: args.target });
+    yield* manager.removeSettingsEntry({ target: args.target });
+    return {
+        result: "success",
+        message: "Applied uninstall operation",
+    };
+});
+/**
+ * Build a PlannedJobStep for an uninstall operation.
+ *
+ * The step captures the manager, retention policy, and target in its `run`
+ * closure so execution requires no runtime service resolution (`R = never`).
+ */
+export const buildUninstallOperation = (manager, retentionPolicy, args) => {
+    return {
+        label: toLabel(args.target),
+        readiness: "ready",
+        run: runUninstallOperation(manager, retentionPolicy, args),
+    };
+};
+//# sourceMappingURL=operations.js.map

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

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

package/dist/src/unstable/extensions/reconciliation-utils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared reconciliation utilities for disk compatibility checks.
+ *
+ * Extracts the common pattern used by skills and packs reconciliation adapters
+ * for checking disk existence, reading manifests, and decoding them.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import type { AdapterEnvironment, ReconciliationDeclaration } from "../workspace/reconciliation-types.js";
+/**
+ * Check that a canonical path exists on disk, read a manifest file,
+ * parse its JSON, and decode it with the provided function.
+ *
+ * Returns an Unresolved DeclarationResolution when the path is missing,
+ * the manifest is empty, JSON parsing fails, or decoding fails.
+ * Returns the decoded manifest on success.
+ */
+export declare const readAndDecodeManifest: <A>(declaration: ReconciliationDeclaration, canonicalPath: string, manifestFilename: string, decode: (json: unknown) => A | null, extensionLabel: string, env: AdapterEnvironment) => Effect.Effect<{
+    _tag: "Unresolved";
+    declaration: ReconciliationDeclaration;
+    reason: "missing";
+    manifest?: never;
+    canonicalPath?: never;
+} | {
+    _tag: "Unresolved";
+    declaration: ReconciliationDeclaration;
+    reason: "invalid";
+    manifest?: never;
+    canonicalPath?: never;
+} | {
+    _tag: "ok";
+    manifest: A & ({} | undefined);
+    canonicalPath: string;
+    declaration?: never;
+    reason?: never;
+}, import("../app-error/app-error.ts").AppError, never>;
+//# sourceMappingURL=reconciliation-utils.d.ts.map

package/dist/src/unstable/extensions/reconciliation-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-utils.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/reconciliation-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EAE1B,MAAM,sCAAsC,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,EACrC,aAAa,yBAAyB,EACtC,eAAe,MAAM,EACrB,kBAAkB,MAAM,EACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,GAAG,IAAI,EACnC,gBAAgB,MAAM,EACtB,KAAK,kBAAkB;;;;;;;;;;;;;;;;;;uDAkDrB,CAAC"}