@agentxm/client-core 0.1.6

package/dist/src/unstable/packs/expansion.js

@@ -0,0 +1,149 @@
+/**
+ * Extension pack expansion helpers for cross-type dependency expansion.
+ *
+ * - expandExtensionPackInstallRefs: Expands a pack ref into install refs (pack + dependencies)
+ * - expandExtensionPackUninstallTargets: Computes removable uninstall targets (pack + orphaned deps)
+ * - resolveSkillUninstallTargetsFromLockfile: Resolves skill names to targets via lockfile
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { makeAppError } from "../app-error/index.js";
+import { parseFullyQualifiedNameParts } from "../extensions/index.js";
+import { resolveExtensionPackDependencies } from "./dependency-resolution.js";
+// -----------------------------------------------------------------------------
+// expandExtensionPackInstallRefs
+// -----------------------------------------------------------------------------
+const nameFromFqn = (fqn) => {
+    return parseFullyQualifiedNameParts(fqn)?.name ?? fqn;
+};
+/**
+ * Expand an extension pack ref into its cross-type dependency refs.
+ *
+ * Returns the extension pack ref first, followed by dependency refs (skill, command,
+ * mcp-server) in declaration order. Only dependency types listed in
+ * `supportedDependencyTypes` are included.
+ *
+ * Dependency refs use the extension pack's registry source and empty integrity
+ * (integrity is resolved during materialization, not at expansion time).
+ */
+export const expandExtensionPackInstallRefs = (args) => Effect.gen(function* () {
+    const { pack, supportedDependencyTypes, sources } = args;
+    const resolved = yield* resolveExtensionPackDependencies(pack, sources);
+    const deps = resolved.dependencyRefs.filter((ref) => supportedDependencyTypes.includes(ref.type));
+    const packRef = pack;
+    return [packRef, ...deps];
+});
+/**
+ * Compute removable uninstall targets for an extension pack.
+ *
+ * Returns the extension pack target first, followed by orphaned dependency targets.
+ * Orphaned = extension pack dependency candidates minus:
+ *   - dependencies still referenced by remaining installed extension packs
+ *   - dependencies directly configured in settings
+ *
+ * Only dependency types listed in `supportedDependencyTypes` are considered.
+ */
+export const expandExtensionPackUninstallTargets = (args) => {
+    const { pack, supportedDependencyTypes, lockfile, settings } = args;
+    const packs = lockfile.packs ?? {};
+    const packEntry = packs[pack.name];
+    // If pack is not in lockfile, just return the pack target
+    if (!packEntry) {
+        return Effect.succeed([pack]);
+    }
+    // Collect all dependency FQNs from the pack being uninstalled
+    const candidateSkills = supportedDependencyTypes.includes("skill")
+        ? Object.keys(packEntry.resolvedSkills)
+        : [];
+    const candidateCommands = supportedDependencyTypes.includes("command")
+        ? Object.keys(packEntry.resolvedCommands)
+        : [];
+    const candidateMcpServers = supportedDependencyTypes.includes("mcp-server")
+        ? Object.keys(packEntry.resolvedMcpServers)
+        : [];
+    const candidateSubagents = supportedDependencyTypes.includes("subagent")
+        ? Object.keys(packEntry.resolvedSubagents)
+        : [];
+    // Collect dependencies still referenced by OTHER installed packs
+    const retainedByOtherPacks = new Set();
+    for (const [packName, entry] of Object.entries(packs)) {
+        if (packName === pack.name)
+            continue;
+        for (const fqn of Object.keys(entry.resolvedSkills)) {
+            retainedByOtherPacks.add(fqn);
+        }
+        for (const fqn of Object.keys(entry.resolvedCommands)) {
+            retainedByOtherPacks.add(fqn);
+        }
+        for (const fqn of Object.keys(entry.resolvedMcpServers)) {
+            retainedByOtherPacks.add(fqn);
+        }
+        for (const fqn of Object.keys(entry.resolvedSubagents)) {
+            retainedByOtherPacks.add(fqn);
+        }
+    }
+    // Collect directly-configured extensions from settings
+    const directlyConfigured = new Set();
+    for (const name of Object.keys(settings.skills)) {
+        directlyConfigured.add(name);
+    }
+    for (const name of Object.keys(settings.commands)) {
+        directlyConfigured.add(name);
+    }
+    for (const name of Object.keys(settings.mcpServers)) {
+        directlyConfigured.add(name);
+    }
+    for (const name of Object.keys(settings.subagents)) {
+        directlyConfigured.add(name);
+    }
+    // Filter to orphaned targets
+    const orphanedTargets = [];
+    for (const fqn of candidateSkills) {
+        const name = nameFromFqn(fqn);
+        if (!retainedByOtherPacks.has(fqn) && !directlyConfigured.has(name)) {
+            orphanedTargets.push({ type: "skill", name });
+        }
+    }
+    for (const fqn of candidateCommands) {
+        const name = nameFromFqn(fqn);
+        if (!retainedByOtherPacks.has(fqn) && !directlyConfigured.has(name)) {
+            orphanedTargets.push({ type: "command", name });
+        }
+    }
+    for (const fqn of candidateMcpServers) {
+        const name = nameFromFqn(fqn);
+        if (!retainedByOtherPacks.has(fqn) && !directlyConfigured.has(name)) {
+            orphanedTargets.push({ type: "mcp-server", name });
+        }
+    }
+    for (const fqn of candidateSubagents) {
+        const name = nameFromFqn(fqn);
+        if (!retainedByOtherPacks.has(fqn) && !directlyConfigured.has(name)) {
+            orphanedTargets.push({ type: "subagent", name });
+        }
+    }
+    return Effect.succeed([pack, ...orphanedTargets]);
+};
+// -----------------------------------------------------------------------------
+// resolveSkillUninstallTargetsFromLockfile
+// -----------------------------------------------------------------------------
+/**
+ * Resolve skill names to lockfile-backed uninstall targets.
+ *
+ * Fails with AppError if any skill name is not found in the lockfile.
+ */
+export const resolveSkillUninstallTargetsFromLockfile = (skills, lockfile) => Effect.forEach(skills, (entry) => {
+    if (!(entry.skillName in lockfile.skills)) {
+        return Effect.fail(makeAppError({
+            code: "SKILL_NOT_FOUND_IN_LOCKFILE",
+            what: `Skill "${entry.skillName}" is not installed`,
+            howToFix: "Check the skill name and try again",
+        }));
+    }
+    return Effect.succeed({
+        type: "skill",
+        name: entry.skillName,
+    });
+});
+//# sourceMappingURL=expansion.js.map

package/dist/src/unstable/packs/expansion.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * Extension pack feature module for @agentxm/client-core.
+ *
+ * Provides extension pack manifest schemas, extension ref types, lifecycle manager,
+ * path computation, expansion helpers, reconciliation adapter, and operations.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { EXTENSION_PACK_MANIFEST_FILENAME, ExtensionPackManifestSchema, type ExtensionPackManifest, } from "./manifest-schema.js";
+export type { RegistryExtensionPackRef, ExtensionPackRef } from "./refs.js";
+export { ExtensionPackManager, ExtensionPackManagerLive } from "./manager.js";
+export { computeExtensionPackPaths, type ExtensionPackDirPath } from "./paths.js";
+export { expandExtensionPackInstallRefs, expandExtensionPackUninstallTargets, resolveSkillUninstallTargetsFromLockfile, type UninstallSettingsContext, } from "./expansion.js";
+export { extensionPackReconciliationAdapter } from "./reconciliation-adapter.js";
+export type { InstallExtensionPackOperationArgs, InstallExtensionPackOperation, } from "./operations/install.js";
+export { installExtensionPack } from "./operations/install.js";
+export type { UninstallExtensionPackOperationArgs, UninstallExtensionPackOperation, } from "./operations/uninstall.js";
+export { uninstallExtensionPack } from "./operations/uninstall.js";
+export type { NewExtensionPackOperationArgs, NewExtensionPackOperation, } from "./operations/new-pack.js";
+export { newExtensionPack } from "./operations/new-pack.js";
+export type { AddToExtensionPackOperationArgs, AddToExtensionPackOperation, } from "./operations/add-to-pack.js";
+export { addToExtensionPack } from "./operations/add-to-pack.js";
+export type { RemoveFromExtensionPackOperationArgs, RemoveFromExtensionPackOperation, } from "./operations/remove-from-pack.js";
+export { removeFromExtensionPack } from "./operations/remove-from-pack.js";
+export type { PublishExtensionPackOperationArgs, PublishExtensionPackOperation, } from "./operations/publish.js";
+export { publishExtensionPack } from "./operations/publish.js";
+export type { UnpackExtensionPackOperationArgs, UnpackExtensionPackOperation, } from "./operations/unpack.js";
+export { unpackExtensionPack } from "./operations/unpack.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG5E,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAG9E,OAAO,EAAE,yBAAyB,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlF,OAAO,EACL,8BAA8B,EAC9B,mCAAmC,EACnC,wCAAwC,EACxC,KAAK,wBAAwB,GAC9B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAC;AAGjF,YAAY,EACV,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EACV,mCAAmC,EACnC,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EACV,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EACV,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,YAAY,EACV,oCAAoC,EACpC,gCAAgC,GACjC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,YAAY,EACV,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EACV,gCAAgC,EAChC,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * Extension pack feature module for @agentxm/client-core.
+ *
+ * Provides extension pack manifest schemas, extension ref types, lifecycle manager,
+ * path computation, expansion helpers, reconciliation adapter, and operations.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Manifest schemas
+export { EXTENSION_PACK_MANIFEST_FILENAME, ExtensionPackManifestSchema, } from "./manifest-schema.js";
+// Manager
+export { ExtensionPackManager, ExtensionPackManagerLive } from "./manager.js";
+// Paths
+export { computeExtensionPackPaths } from "./paths.js";
+// Expansion helpers
+export { expandExtensionPackInstallRefs, expandExtensionPackUninstallTargets, resolveSkillUninstallTargetsFromLockfile, } from "./expansion.js";
+// Reconciliation adapter
+export { extensionPackReconciliationAdapter } from "./reconciliation-adapter.js";
+export { installExtensionPack } from "./operations/install.js";
+export { uninstallExtensionPack } from "./operations/uninstall.js";
+export { newExtensionPack } from "./operations/new-pack.js";
+export { addToExtensionPack } from "./operations/add-to-pack.js";
+export { removeFromExtensionPack } from "./operations/remove-from-pack.js";
+export { publishExtensionPack } from "./operations/publish.js";
+export { unpackExtensionPack } from "./operations/unpack.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/packs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,mBAAmB;AACnB,OAAO,EACL,gCAAgC,EAChC,2BAA2B,GAE5B,MAAM,sBAAsB,CAAC;AAK9B,UAAU;AACV,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE9E,QAAQ;AACR,OAAO,EAAE,yBAAyB,EAA6B,MAAM,YAAY,CAAC;AAElF,oBAAoB;AACpB,OAAO,EACL,8BAA8B,EAC9B,mCAAmC,EACnC,wCAAwC,GAEzC,MAAM,gBAAgB,CAAC;AAExB,yBAAyB;AACzB,OAAO,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAC;AAOjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAK/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAKnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAKjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAK3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAK/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/unstable/packs/manager.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Extension pack manager service.
+ *
+ * Implements ExtensionManager<ExtensionPackRef>. Delegates to existing
+ * extension pack materialization functions and workspace service methods.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as ServiceMap from "effect/ServiceMap";
+import * as Layer from "effect/Layer";
+import type { RegistryExtensionPackRef } from "./refs.js";
+import { SourceHostProviders } from "../source-resolution/index.js";
+import type { ExtensionManager } from "../workspace/service-interface.js";
+import { Workspace } from "../workspace/service-interface.js";
+declare const ExtensionPackManager_base: ServiceMap.ServiceClass<ExtensionPackManager, "axm.sh/ExtensionPackManager", ExtensionManager<RegistryExtensionPackRef>>;
+export declare class ExtensionPackManager extends ExtensionPackManager_base {
+}
+export declare const ExtensionPackManagerLive: Layer.Layer<ExtensionPackManager, never, FileSystem.FileSystem | Path.Path | Workspace | SourceHostProviders>;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/src/unstable/packs/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packs/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,KAAK,EAAoB,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EACL,mBAAmB,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,mCAAmC,CAAC;AAC/F,OAAO,EAAE,SAAS,EAA6B,MAAM,mCAAmC,CAAC;;AAczF,qBAAa,oBAAqB,SAAQ,yBAGR;CAAG;AAyErC,eAAO,MAAM,wBAAwB,+GAqHpC,CAAC"}

package/dist/src/unstable/packs/manager.js

@@ -0,0 +1,132 @@
+/**
+ * Extension pack manager service.
+ *
+ * Implements ExtensionManager<ExtensionPackRef>. Delegates to existing
+ * extension pack materialization functions and workspace service methods.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as ServiceMap from "effect/ServiceMap";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import { makeAppError } from "../app-error/index.js";
+import { REGISTRY_EXTENSIONS_DIR } from "../extensions/index.js";
+import { SourceHostProviders, } from "../source-resolution/index.js";
+import { Workspace } from "../workspace/service-interface.js";
+import { copyExtensionDirectory } from "../extensions/utils.js";
+import { sanitizeName } from "../extensions/utils.js";
+import { computeExtensionPackPaths } from "./paths.js";
+import { removeIfExists } from "../utils/index.js";
+import { validateExactResolvedVersion } from "../lockfile/index.js";
+import { resolveExtensionPackDependencies } from "./dependency-resolution.js";
+import { decodeExactSemverVersionSync } from "../version-constraints/version-constraints.js";
+// -----------------------------------------------------------------------------
+// Service Tag
+// -----------------------------------------------------------------------------
+export class ExtensionPackManager extends ServiceMap.Service()("axm.sh/ExtensionPackManager") {
+}
+// Build pack SetExtensionPackArgs from a registry ref
+const buildSetExtensionPackArgs = (ref, versionConstraint, sources) => Effect.gen(function* () {
+    const resolved = yield* resolveExtensionPackDependencies(ref, sources);
+    return {
+        owner: ref.owner,
+        name: ref.pack.name,
+        resolvedVersion: decodeExactSemverVersionSync(ref.version),
+        integrity: Option.getOrElse(ref.integrity, () => ""),
+        sourceName: "default",
+        installedAt: new Date(),
+        updatedAt: new Date(),
+        resolvedSkills: resolved.resolvedSkills,
+        resolvedCommands: resolved.resolvedCommands,
+        resolvedMcpServers: resolved.resolvedMcpServers,
+        resolvedSubagents: resolved.resolvedSubagents,
+        versionConstraint,
+    };
+});
+const checkInstalledOnDisk = (fsService, pathService, baseDir, packName) => Effect.gen(function* () {
+    const extensionsDir = pathService.join(baseDir, REGISTRY_EXTENSIONS_DIR);
+    const extensionsDirExists = yield* fsService
+        .exists(extensionsDir)
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    if (!extensionsDirExists)
+        return false;
+    const candidateNames = [packName];
+    const sanitizedName = sanitizeName(packName);
+    if (sanitizedName !== packName) {
+        candidateNames.push(sanitizedName);
+    }
+    const scopeDirs = yield* fsService
+        .readDirectory(extensionsDir)
+        .pipe(Effect.catch(() => Effect.succeed([])));
+    const results = yield* Effect.forEach(scopeDirs, (scopeDir) => {
+        if (!scopeDir.startsWith("@"))
+            return Effect.succeed(false);
+        return Effect.forEach(candidateNames, (candidateName) => {
+            const packPath = pathService.join(extensionsDir, scopeDir, "packs", candidateName);
+            return fsService.exists(packPath).pipe(Effect.catch(() => Effect.succeed(false)));
+        }, { concurrency: "unbounded" }).pipe(Effect.map((candidates) => candidates.some((exists) => exists)));
+    }, { concurrency: "unbounded" });
+    return results.some((exists) => exists);
+});
+// -----------------------------------------------------------------------------
+// Live Layer
+// -----------------------------------------------------------------------------
+export const ExtensionPackManagerLive = Layer.effect(ExtensionPackManager, Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const sources = yield* SourceHostProviders;
+    const baseDir = ws.baseDir;
+    // Build a layer to provide FileSystem + Path to inner effects
+    const fsPathLayer = Layer.merge(Layer.succeed(FileSystem.FileSystem, fs), Layer.succeed(Path.Path, path));
+    const provide = (effect) => Effect.provide(effect, fsPathLayer);
+    const materializeInstall = Effect.fn("ExtensionPackManager.materializeInstall")(function* ({ ref }) {
+        yield* validateExactResolvedVersion(`packs.${ref.pack.name}.resolvedVersion`, ref.version);
+        const packDir = computeExtensionPackPaths(path.join, baseDir, ref.owner, ref.pack.name).canonicalPath;
+        yield* Effect.scoped(Effect.gen(function* () {
+            const fetched = yield* sources.fetch(ref).pipe(Effect.mapError((e) => makeAppError({
+                code: "PACK_FETCH_FAILED",
+                what: `Failed to fetch extension pack archive: ${e.message}`,
+                cause: e,
+            })));
+            yield* provide(copyExtensionDirectory(fetched.directory, packDir).pipe(Effect.mapError((e) => makeAppError({
+                code: "PACK_EXTRACT_FAILED",
+                what: `Failed to extract extension pack to ${packDir}`,
+                cause: e,
+            }))));
+        }));
+    });
+    const materializeUninstall = Effect.fn("ExtensionPackManager.materializeUninstall")(function* ({ target, }) {
+        const packDir = computeExtensionPackPaths(path.join, baseDir, target.owner, target.name).canonicalPath;
+        yield* removeIfExists(fs, packDir);
+    });
+    return {
+        type: "pack",
+        isInstalled: Effect.fn("ExtensionPackManager.isInstalled")(function* ({ target, }) {
+            const installedPacks = yield* ws.getInstalledPacks();
+            if (target.name in installedPacks) {
+                return true;
+            }
+            return yield* checkInstalledOnDisk(fs, path, baseDir, target.name);
+        }),
+        materializeInstall,
+        materializeUninstall,
+        upsertSettingsEntry: ({ ref, versionConstraint, }) => buildSetExtensionPackArgs(ref, versionConstraint, sources).pipe(Effect.flatMap((args) => ws.setExtensionPack(args)), Effect.withSpan("ExtensionPackManager.upsertSettingsEntry")),
+        removeSettingsEntry: ({ target }) => ws
+            .removeExtensionPackSettings(target.name)
+            .pipe(Effect.withSpan("ExtensionPackManager.removeSettingsEntry")),
+        // Pack lockfile entries are written by upsertSettingsEntry via buildSetExtensionPackArgs;
+        // this method satisfies the ExtensionManager interface but performs no additional work.
+        upsertLockfileEntry: ({ ref }) => {
+            void ref;
+            return Effect.void.pipe(Effect.withSpan("ExtensionPackManager.upsertLockfileEntry"));
+        },
+        removeLockfileEntry: ({ target }) => ws
+            .removeExtensionPackLock(target.name)
+            .pipe(Effect.withSpan("ExtensionPackManager.removeLockfileEntry")),
+    };
+}));
+//# sourceMappingURL=manager.js.map

package/dist/src/unstable/packs/manager.js.map

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

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

@@ -0,0 +1,52 @@
+/**
+ * Extension pack manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+export declare const EXTENSION_PACK_MANIFEST_FILENAME = "extension-pack.json";
+export declare const EXTENSION_PACK_MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/extension-pack.schema.json";
+/**
+ * Schema for pack manifest files (extension-pack.json).
+ *
+ * Extension packs bundle multiple extensions (skills, commands, MCP servers, subagents)
+ * for convenient distribution and installation. Each extension entry
+ * maps a fully qualified name to a semver version range.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const ExtensionPackManifestSchema: Schema.Struct<{
+    readonly type: Schema.Literal<"pack">;
+    readonly name: Schema.brand<Schema.String, "ExtensionName">;
+    readonly skills: Schema.optional<Schema.$Record<Schema.String, Schema.brand<Schema.String, "VersionConstraint">>>;
+    readonly commands: Schema.optional<Schema.$Record<Schema.String, Schema.brand<Schema.String, "VersionConstraint">>>;
+    readonly "mcp-servers": Schema.optional<Schema.$Record<Schema.String, Schema.brand<Schema.String, "VersionConstraint">>>;
+    readonly subagents: Schema.optional<Schema.$Record<Schema.String, Schema.brand<Schema.String, "VersionConstraint">>>;
+    readonly owner: Schema.brand<Schema.String, "Handle">;
+    readonly version: Schema.brand<Schema.String, "ExactSemverVersion">;
+    readonly description: Schema.optional<Schema.String>;
+    readonly keywords: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly repository: Schema.optional<Schema.String>;
+    readonly homepage: Schema.optional<Schema.String>;
+    readonly license: Schema.optional<Schema.String>;
+    readonly bugs: Schema.optional<Schema.String>;
+    readonly authors: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly email: Schema.optional<Schema.String>;
+        readonly url: Schema.optional<Schema.String>;
+    }>>>;
+    readonly compatiblePackages: Schema.optional<Schema.$Array<Schema.decodeTo<Schema.toType<Schema.Struct<{
+        readonly type: Schema.brand<Schema.String, "PackageType">;
+        readonly namespace: Schema.optional<Schema.String>;
+        readonly name: Schema.String;
+        readonly version: Schema.optional<Schema.String>;
+    }>>, Schema.String, never, never>>>;
+    readonly $schema: Schema.optional<Schema.String>;
+}>;
+/**
+ * Inferred type for ExtensionPackManifest schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ExtensionPackManifest = Schema.Schema.Type<typeof ExtensionPackManifestSchema>;
+//# sourceMappingURL=manifest-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packs/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAOxC,eAAO,MAAM,gCAAgC,wBAAwB,CAAC;AAEtE,eAAO,MAAM,kCAAkC,sDACM,CAAC;AAEtD;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBtC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * Extension pack manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { CommonManifestBaseFields, ExtensionDependencyConstraintMapSchema, ExtensionNameSchema, } from "../extensions/common.js";
+export const EXTENSION_PACK_MANIFEST_FILENAME = "extension-pack.json";
+export const EXTENSION_PACK_MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/extension-pack.schema.json";
+/**
+ * Schema for pack manifest files (extension-pack.json).
+ *
+ * Extension packs bundle multiple extensions (skills, commands, MCP servers, subagents)
+ * for convenient distribution and installation. Each extension entry
+ * maps a fully qualified name to a semver version range.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ExtensionPackManifestSchema = Schema.Struct({
+    $schema: Schema.optional(Schema.String),
+    ...CommonManifestBaseFields,
+    type: Schema.Literal("pack"),
+    name: ExtensionNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "extension pack name is required" })),
+    skills: Schema.optional(ExtensionDependencyConstraintMapSchema),
+    commands: Schema.optional(ExtensionDependencyConstraintMapSchema),
+    "mcp-servers": Schema.optional(ExtensionDependencyConstraintMapSchema),
+    subagents: Schema.optional(ExtensionDependencyConstraintMapSchema),
+}).annotate({
+    identifier: "ExtensionPackManifest",
+    title: "Extension Pack Manifest",
+    description: "Configuration file (extension-pack.json) that bundles multiple extensions into a single installable pack.",
+});
+//# sourceMappingURL=manifest-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.js","sourceRoot":"","sources":["../../../../src/unstable/packs/manifest-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EACL,wBAAwB,EACxB,sCAAsC,EACtC,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,CAAC,MAAM,gCAAgC,GAAG,qBAAqB,CAAC;AAEtE,MAAM,CAAC,MAAM,kCAAkC,GAC7C,mDAAmD,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACvC,GAAG,wBAAwB;IAC3B,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;IAC5B,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAC5B,MAAM,CAAC,WAAW,CAAC,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,CAAC,CAC7E;IACD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC/D,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACjE,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACtE,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CACnE,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,uBAAuB;IACnC,KAAK,EAAE,yBAAyB;IAChC,WAAW,EACT,2GAA2G;CAC9G,CAAC,CAAC"}

package/dist/src/unstable/packs/operations/add-to-pack.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Add-to-extension-pack operation — applies a precomputed manifest-add delta to an extension pack manifest.
+ *
+ * Validates manifest precondition (stale check) before writing.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { Handle } from "../../extensions/index.js";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Args for the add-to-extension-pack operation.
+ */
+export interface AddToExtensionPackOperationArgs {
+    /** Pack name (without owner). */
+    readonly packName: string;
+    /** Pack owner (e.g., "@myorg"). */
+    readonly packOwner: Handle;
+    /** Precomputed manifest delta: FQN -> version range entries to add. */
+    readonly additions: Readonly<Record<string, string>>;
+    /** Manifest content hash at plan time for stale-check. */
+    readonly manifestHash: string;
+}
+/**
+ * Add extensions to an extension pack manifest.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type AddToExtensionPackOperation = Operation<"add-to-pack", AddToExtensionPackOperationArgs>;
+/**
+ * Add-to-extension-pack operation handler.
+ *
+ * 1. Short-circuit if additions map is empty (no-op)
+ * 2. Read current manifest and compute hash
+ * 3. Compare hash with args.manifestHash (stale check)
+ * 4. Apply additions to manifest
+ * 5. Write updated manifest
+ */
+export declare const addToExtensionPack: OperationHandler<AddToExtensionPackOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=add-to-pack.d.ts.map

package/dist/src/unstable/packs/operations/add-to-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-to-pack.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/packs/operations/add-to-pack.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAIpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAajE;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,SAAS,CAAC,aAAa,EAAE,+BAA+B,CAAC,CAAC;AAMpG;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,CAC/C,2BAA2B,EAC3B,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAgH3C,CAAC"}