@agentxm/client-core 0.1.6

package/dist/src/unstable/packs/operations/remove-from-pack.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Remove-from-extension-pack operation — applies a precomputed manifest-remove 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 remove-from-extension-pack operation.
+ */
+export interface RemoveFromExtensionPackOperationArgs {
+    /** Pack name (without owner). */
+    readonly packName: string;
+    /** Pack owner (e.g., "@myorg"). */
+    readonly packOwner: Handle;
+    /** Precomputed manifest delta: extension names to remove. */
+    readonly removals: ReadonlyArray<string>;
+    /** Manifest content hash at plan time for stale-check. */
+    readonly manifestHash: string;
+}
+/**
+ * Remove extensions from an extension pack manifest.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type RemoveFromExtensionPackOperation = Operation<"remove-from-pack", RemoveFromExtensionPackOperationArgs>;
+/**
+ * Remove-from-extension-pack operation handler.
+ *
+ * 1. Short-circuit if removals list is empty (no-op)
+ * 2. Read current manifest and compute hash
+ * 3. Compare hash with args.manifestHash (stale check)
+ * 4. Apply removals to manifest
+ * 5. Write updated manifest
+ */
+export declare const removeFromExtensionPack: OperationHandler<RemoveFromExtensionPackOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=remove-from-pack.d.ts.map

package/dist/src/unstable/packs/operations/remove-from-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-from-pack.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/packs/operations/remove-from-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;AAYjE;;GAEG;AACH,MAAM,WAAW,oCAAoC;IACnD,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GAAG,SAAS,CACtD,kBAAkB,EAClB,oCAAoC,CACrC,CAAC;AAMF;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,CACpD,gCAAgC,EAChC,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAkG3C,CAAC"}

package/dist/src/unstable/packs/operations/remove-from-pack.js

@@ -0,0 +1,100 @@
+/**
+ * Remove-from-extension-pack operation — applies a precomputed manifest-remove 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 * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { EXTENSION_PACK_MANIFEST_FILENAME, ExtensionPackManifestSchema, } from "../manifest-schema.js";
+import { computeExtensionPackPaths } from "../paths.js";
+import { hashContent } from "./hash-content.js";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Remove-from-extension-pack operation handler.
+ *
+ * 1. Short-circuit if removals list is empty (no-op)
+ * 2. Read current manifest and compute hash
+ * 3. Compare hash with args.manifestHash (stale check)
+ * 4. Apply removals to manifest
+ * 5. Write updated manifest
+ */
+export const removeFromExtensionPack = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    const { packName, packOwner, removals, manifestHash } = op.args;
+    // 1. Short-circuit if nothing to remove
+    if (removals.length === 0) {
+        return { result: "success", message: "Nothing to remove" };
+    }
+    // 2. Read current manifest
+    const packDir = computeExtensionPackPaths(path.join, base, packOwner, packName);
+    const manifestPath = path.join(packDir.canonicalPath, EXTENSION_PACK_MANIFEST_FILENAME);
+    const manifestContent = yield* fs.readFileString(manifestPath).pipe(Effect.mapError((e) => makeAppError({
+        code: "PACK_NOT_FOUND",
+        what: `Extension pack manifest not found at ${manifestPath}`,
+        howToFix: "Ensure the extension pack exists on disk",
+        cause: e,
+    })));
+    // 3. Stale-check: compare content hash
+    const currentHash = hashContent(manifestContent);
+    if (currentHash !== manifestHash) {
+        return yield* makeAppError({
+            code: "PACK_MANIFEST_STALE",
+            what: `Extension pack manifest is stale — it was modified since the plan was created`,
+            howToFix: "Re-run the command to create a fresh plan",
+        });
+    }
+    // 4. Parse and apply removals
+    const json = yield* Effect.try({
+        try: () => {
+            const parsed = JSON.parse(manifestContent);
+            return parsed;
+        },
+        catch: (e) => makeAppError({
+            code: "PACK_MANIFEST_PARSE_FAILED",
+            what: `Failed to parse extension pack manifest: ${manifestPath}`,
+            cause: e,
+        }),
+    });
+    const manifest = yield* Schema.decodeUnknownEffect(ExtensionPackManifestSchema)(json).pipe(Effect.mapError((e) => makeAppError({
+        code: "PACK_MANIFEST_INVALID",
+        what: `Invalid extension pack manifest: ${manifestPath}`,
+        cause: e,
+    })));
+    const removalSet = new Set(removals);
+    const filterSection = (section) => Object.fromEntries(Object.entries(section ?? {}).filter(([name]) => !removalSet.has(name)));
+    const updatedSkills = filterSection(manifest["skills"]);
+    const updatedCommands = filterSection(manifest["commands"]);
+    const updatedMcpServers = filterSection(manifest["mcp-servers"]);
+    const updatedManifest = {
+        ...manifest,
+        owner: manifest.owner,
+        type: manifest.type,
+        name: manifest.name,
+        version: manifest.version,
+        skills: updatedSkills,
+        commands: updatedCommands,
+        "mcp-servers": updatedMcpServers,
+    };
+    // 5. Write updated manifest
+    yield* fs.writeFileString(manifestPath, JSON.stringify(updatedManifest, null, 2) + "\n").pipe(Effect.mapError((e) => makeAppError({
+        code: "PACK_WRITE_FAILED",
+        what: `Failed to write extension pack manifest: ${manifestPath}`,
+        cause: e,
+    })));
+    return {
+        result: "success",
+        message: `Removed ${removals.length} extension(s) from extension pack`,
+    };
+});
+//# sourceMappingURL=remove-from-pack.js.map

package/dist/src/unstable/packs/operations/remove-from-pack.js.map

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

package/dist/src/unstable/packs/operations/uninstall.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Uninstall extension pack operation handler.
+ *
+ * Removes extension pack directory from disk and extension pack entry from settings/lockfile.
+ * Skill removal is delegated to uninstall-skill operations in the plan.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { CliRenderer } from "../../cli-renderer/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 uninstall extension pack operation.
+ */
+export interface UninstallExtensionPackOperationArgs {
+    /** Pack name to uninstall */
+    readonly packName: string;
+}
+/**
+ * Remove an extension pack from the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type UninstallExtensionPackOperation = Operation<"uninstall-pack", UninstallExtensionPackOperationArgs>;
+/**
+ * Uninstall extension pack operation handler.
+ *
+ * 1. Look up extension pack in lockfile
+ * 2. Remove extension pack directory from disk
+ * 3. Remove extension extension pack from settings and lockfile
+ */
+export declare const uninstallExtensionPack: OperationHandler<UninstallExtensionPackOperation, FileSystem.FileSystem | Path.Path | Workspace | CliRenderer>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/src/unstable/packs/operations/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/packs/operations/uninstall.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAIpC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,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;AAUjE;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GAAG,SAAS,CACrD,gBAAgB,EAChB,mCAAmC,CACpC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,CACnD,+BAA+B,EAC/B,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,GAAG,WAAW,CA6F1D,CAAC"}

package/dist/src/unstable/packs/operations/uninstall.js

@@ -0,0 +1,86 @@
+/**
+ * Uninstall extension pack operation handler.
+ *
+ * Removes extension pack directory from disk and extension pack entry from settings/lockfile.
+ * Skill removal is delegated to uninstall-skill operations in the plan.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { makeAppError } from "../../app-error/index.js";
+import { CliRenderer } from "../../cli-renderer/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { REGISTRY_EXTENSIONS_DIR } from "../../extensions/index.js";
+import { computeExtensionPackPaths } from "../paths.js";
+import { removeIfExists } from "../../utils/index.js";
+import { sanitizeName } from "../../extensions/utils.js";
+/**
+ * Uninstall extension pack operation handler.
+ *
+ * 1. Look up extension pack in lockfile
+ * 2. Remove extension pack directory from disk
+ * 3. Remove extension extension pack from settings and lockfile
+ */
+export const uninstallExtensionPack = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const renderer = yield* CliRenderer;
+    const base = ws.baseDir;
+    // Read pack lock entry
+    const lockedPackOpt = yield* ws.getLockedExtensionPack(op.args.packName).pipe(Effect.mapError((e) => makeAppError({
+        code: "UNINSTALL_PACK_LOCKFILE_READ_FAILED",
+        what: `Failed to read lockfile: ${e.what}`,
+        cause: e,
+    })));
+    if (Option.isNone(lockedPackOpt)) {
+        // Scan for orphaned pack folders on disk
+        const extensionsDir = path.join(base, REGISTRY_EXTENSIONS_DIR);
+        const extensionsDirExists = yield* fs
+            .exists(extensionsDir)
+            .pipe(Effect.catch(() => Effect.succeed(false)));
+        if (extensionsDirExists) {
+            const namespaceDirs = yield* fs
+                .readDirectory(extensionsDir)
+                .pipe(Effect.catch(() => Effect.succeed([])));
+            const sanitized = sanitizeName(op.args.packName);
+            const results = yield* Effect.forEach(namespaceDirs, (nsDir) => {
+                if (!nsDir.startsWith("@"))
+                    return Effect.succeed(false);
+                const packDir = path.join(extensionsDir, nsDir, "packs", sanitized);
+                return fs.exists(packDir).pipe(Effect.catch(() => Effect.succeed(false)), Effect.flatMap((exists) => {
+                    if (!exists)
+                        return Effect.succeed(false);
+                    return removeIfExists(fs, packDir).pipe(Effect.map(() => true));
+                }));
+            }, { concurrency: "unbounded" });
+            if (results.some((removed) => removed)) {
+                return {
+                    result: "success",
+                    message: "Removed extension pack directory from disk",
+                };
+            }
+        }
+        return { result: "success", message: "not installed" };
+    }
+    const lockedPack = lockedPackOpt.value;
+    // Remove extension pack directory from disk
+    const packDir = computeExtensionPackPaths(path.join, base, lockedPack.owner, lockedPack.name).canonicalPath;
+    yield* removeIfExists(fs, packDir);
+    // Remove extension extension pack from settings and lockfile
+    yield* ws
+        .removeExtensionPack(op.args.packName)
+        .pipe(Effect.catch((e) => renderer.warn(`Extension pack removal from settings failed: ${String(e)}`)));
+    return {
+        result: "success",
+        message: `Uninstalled extension pack ${op.args.packName}`,
+    };
+}).pipe(Effect.catch((error) => Effect.succeed({
+    result: "error",
+    message: `Failed to uninstall extension pack: ${error.what}`,
+    error,
+})));
+//# sourceMappingURL=uninstall.js.map

package/dist/src/unstable/packs/operations/uninstall.js.map

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

package/dist/src/unstable/packs/operations/unpack.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Unpack extension pack operation handler.
+ *
+ * Flattens an extension pack's resolved extensions into settings.json as direct entries,
+ * preserves existing direct entries, and removes the extension pack entry from settings
+ * and lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/index.js";
+/**
+ * Args for the unpack extension pack operation.
+ */
+export type UnpackExtensionPackOperationArgs = {
+    /** Pack FQN to unpack. */
+    readonly name: string;
+};
+/**
+ * Unpack an extension pack into direct settings entries.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type UnpackExtensionPackOperation = Operation<"unpack-pack", UnpackExtensionPackOperationArgs>;
+/**
+ * Unpack operation handler.
+ *
+ * 1. Look up extension pack in lockfile for resolved extensions
+ * 2. Read current settings to find existing direct skill entries
+ * 3. Add resolved skills as direct entries (skip existing)
+ * 4. Remove extension extension pack from settings and lockfile
+ */
+export declare const unpackExtensionPack: OperationHandler<UnpackExtensionPackOperation, Workspace>;
+//# sourceMappingURL=unpack.d.ts.map

package/dist/src/unstable/packs/operations/unpack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpack.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/packs/operations/unpack.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAOrD;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,SAAS,CAClD,aAAa,EACb,gCAAgC,CACjC,CAAC;AAMF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,CAAC,4BAA4B,EAAE,SAAS,CA4HtF,CAAC"}

package/dist/src/unstable/packs/operations/unpack.js

@@ -0,0 +1,125 @@
+/**
+ * Unpack extension pack operation handler.
+ *
+ * Flattens an extension pack's resolved extensions into settings.json as direct entries,
+ * preserves existing direct entries, and removes the extension pack entry from settings
+ * and lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/index.js";
+import { parseFqn } from "../../extensions/index.js";
+// -----------------------------------------------------------------------------
+// Operation Handler
+// -----------------------------------------------------------------------------
+/**
+ * Unpack operation handler.
+ *
+ * 1. Look up extension pack in lockfile for resolved extensions
+ * 2. Read current settings to find existing direct skill entries
+ * 3. Add resolved skills as direct entries (skip existing)
+ * 4. Remove extension extension pack from settings and lockfile
+ */
+export const unpackExtensionPack = (op) => Effect.gen(function* () {
+    const ws = yield* Workspace;
+    // Look up the extension pack in the lockfile
+    const lockedPack = yield* ws.getLockedExtensionPack(op.args.name);
+    if (Option.isNone(lockedPack)) {
+        return yield* makeAppError({
+            code: "PACK_NOT_INSTALLED",
+            what: `Extension pack "${op.args.name}" is not installed`,
+            howToFix: "Install the extension pack first with `axm packs install`.",
+        });
+    }
+    const entry = lockedPack.value;
+    if (entry.type !== "registry") {
+        return yield* makeAppError({
+            code: "PACK_UNPACK_UNSUPPORTED",
+            what: `Cannot unpack "${op.args.name}" — only registry extension packs can be unpacked`,
+        });
+    }
+    const now = new Date();
+    // Read current configured extensions to preserve existing direct entries
+    const currentSkills = yield* ws.getConfiguredSkills();
+    const currentCommands = yield* ws.getConfiguredCommands();
+    const currentMcpServers = yield* ws.getConfiguredMcpServers();
+    // Add resolved skills as direct entries (only if not already present)
+    // Use the short name from the FQN as the settings key since SkillsMapSchema
+    // validates keys against agentskills.io naming (no @ or / allowed).
+    // Integrity unknown for individual extensions unpacked from a pack
+    yield* Effect.forEach(Object.entries(entry.resolvedSkills), ([skillFqn, version]) => Effect.gen(function* () {
+        const parsed = yield* parseFqn(skillFqn);
+        if (parsed.name in currentSkills)
+            return; // preserve existing direct entry
+        yield* ws.setSkill({
+            name: parsed.name,
+            lockEntry: {
+                type: "registry",
+                owner: parsed.owner,
+                name: parsed.name,
+                resolvedVersion: version,
+                integrity: "",
+                sourceName: entry.sourceName,
+                agents: [],
+                installedAt: now,
+                updatedAt: now,
+            },
+            versionConstraint: Option.none(),
+        });
+    }), { concurrency: 1 });
+    // Add resolved commands as direct entries
+    yield* Effect.forEach(Object.entries(entry.resolvedCommands), ([commandFqn, version]) => Effect.gen(function* () {
+        const parsed = yield* parseFqn(commandFqn);
+        if (parsed.name in currentCommands)
+            return;
+        yield* ws.setCommand({
+            name: parsed.name,
+            lockEntry: {
+                type: "registry",
+                owner: parsed.owner,
+                name: parsed.name,
+                resolvedVersion: version,
+                // Integrity unknown for individual extensions unpacked from a pack
+                integrity: "",
+                sourceName: entry.sourceName,
+                agents: [],
+                installedAt: now,
+                updatedAt: now,
+            },
+        });
+    }), { concurrency: 1 });
+    // Add resolved MCP servers as direct entries
+    yield* Effect.forEach(Object.entries(entry.resolvedMcpServers), ([mcpServerFqn, version]) => Effect.gen(function* () {
+        const parsed = yield* parseFqn(mcpServerFqn);
+        if (parsed.name in currentMcpServers)
+            return;
+        yield* ws.setMcpServer({
+            name: parsed.name,
+            lockEntry: {
+                type: "registry",
+                owner: parsed.owner,
+                name: parsed.name,
+                resolvedVersion: version,
+                // Integrity unknown for individual extensions unpacked from a pack
+                integrity: "",
+                sourceName: entry.sourceName,
+                installedAt: now,
+                updatedAt: now,
+            },
+        });
+    }), { concurrency: 1 });
+    // Remove the extension pack entry from settings and lockfile
+    yield* ws.removeExtensionPack(op.args.name);
+    const skillCount = Object.keys(entry.resolvedSkills).length;
+    const commandCount = Object.keys(entry.resolvedCommands).length;
+    const mcpServerCount = Object.keys(entry.resolvedMcpServers).length;
+    const totalCount = skillCount + commandCount + mcpServerCount;
+    return {
+        result: "success",
+        message: `Unpacked ${op.args.name}: ${totalCount} extension(s) promoted to direct entries`,
+    };
+});
+//# sourceMappingURL=unpack.js.map

package/dist/src/unstable/packs/operations/unpack.js.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * Centralized extension pack path computation.
+ *
+ * Provides types and a pure function for computing extension pack directory paths.
+ * Extension packs are always registry-sourced, so there is no non-registry branch.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { Handle } from "../extensions/handle.js";
+/**
+ * Computed path for an installed extension pack directory.
+ *
+ * `canonicalPath` = `<base>/.axm/extensions/<owner>/packs/<name>/`
+ *
+ * No `src/` subdirectory for packs.
+ */
+export interface ExtensionPackDirPath {
+    readonly canonicalPath: string;
+}
+/**
+ * Pure function to compute extension pack directory path.
+ *
+ * @param join - Path join function (e.g., `path.join`)
+ * @param base - Workspace root (parent of `.axm`)
+ * @param owner - Extension pack owner (e.g., "@acme")
+ * @param name - Extension pack name for filesystem use
+ */
+export declare const computeExtensionPackPaths: (join: (...paths: string[]) => string, base: string, owner: Handle, name: string) => ExtensionPackDirPath;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packs/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,EACpC,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,MAAM,MAAM,KACX,oBAGF,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Centralized extension pack path computation.
+ *
+ * Provides types and a pure function for computing extension pack directory paths.
+ * Extension packs are always registry-sourced, so there is no non-registry branch.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import { REGISTRY_EXTENSIONS_DIR } from "../extensions/index.js";
+/**
+ * Pure function to compute extension pack directory path.
+ *
+ * @param join - Path join function (e.g., `path.join`)
+ * @param base - Workspace root (parent of `.axm`)
+ * @param owner - Extension pack owner (e.g., "@acme")
+ * @param name - Extension pack name for filesystem use
+ */
+export const computeExtensionPackPaths = (join, base, owner, name) => {
+    const canonicalPath = join(base, REGISTRY_EXTENSIONS_DIR, owner, "packs", name);
+    return { canonicalPath };
+};
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/unstable/packs/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAcjE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,IAAoC,EACpC,IAAY,EACZ,KAAa,EACb,IAAY,EACU,EAAE;IACxB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAChF,OAAO,EAAE,aAAa,EAAE,CAAC;AAC3B,CAAC,CAAC"}

package/dist/src/unstable/packs/reconciliation-adapter.d.ts

@@ -0,0 +1,3 @@
+import type { ReconciliationAdapter } from "../workspace/reconciliation-types.js";
+export declare const extensionPackReconciliationAdapter: ReconciliationAdapter;
+//# sourceMappingURL=reconciliation-adapter.d.ts.map

package/dist/src/unstable/packs/reconciliation-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-adapter.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packs/reconciliation-adapter.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAEV,qBAAqB,EAGtB,MAAM,sCAAsC,CAAC;AAiS9C,eAAO,MAAM,kCAAkC,EAAE,qBA+NhD,CAAC"}