@agentxm/client-core 0.1.6

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

@@ -0,0 +1,116 @@
+/**
+ * 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 * 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 { parseFqnOrThrow } from "../../extensions/index.js";
+import { EXTENSION_PACK_MANIFEST_FILENAME, ExtensionPackManifestSchema, } from "../manifest-schema.js";
+import { computeExtensionPackPaths } from "../paths.js";
+import { hashContent } from "./hash-content.js";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * 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 const addToExtensionPack = (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, additions, manifestHash } = op.args;
+    // 1. Short-circuit if nothing to add
+    if (Object.keys(additions).length === 0) {
+        return { result: "success", message: "Nothing to add" };
+    }
+    // 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 additions
+    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 currentSkills = { ...(manifest["skills"] ?? {}) };
+    const currentCommands = { ...(manifest["commands"] ?? {}) };
+    const currentMcpServers = { ...(manifest["mcp-servers"] ?? {}) };
+    for (const [fqn, version] of Object.entries(additions)) {
+        const parsed = parseFqnOrThrow(fqn);
+        switch (parsed.type) {
+            case "skill":
+                currentSkills[fqn] = version;
+                break;
+            case "command":
+                currentCommands[fqn] = version;
+                break;
+            case "mcp-server":
+                currentMcpServers[fqn] = version;
+                break;
+            case "pack":
+                currentSkills[fqn] = version;
+                break;
+        }
+    }
+    const updatedManifest = {
+        ...manifest,
+        owner: manifest.owner,
+        type: manifest.type,
+        name: manifest.name,
+        version: manifest.version,
+        skills: currentSkills,
+        commands: currentCommands,
+        "mcp-servers": currentMcpServers,
+    };
+    // 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: `Added ${Object.keys(additions).length} extension(s) to extension pack`,
+    };
+});
+//# sourceMappingURL=add-to-pack.js.map

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

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

package/dist/src/unstable/packs/operations/hash-content.d.ts

@@ -0,0 +1,2 @@
+export declare const hashContent: (content: string) => string;
+//# sourceMappingURL=hash-content.d.ts.map

package/dist/src/unstable/packs/operations/hash-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-content.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/packs/operations/hash-content.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,WACgB,CAAC"}

package/dist/src/unstable/packs/operations/hash-content.js

@@ -0,0 +1,3 @@
+import * as crypto from "node:crypto";
+export const hashContent = (content) => crypto.createHash("sha256").update(content).digest("hex");
+//# sourceMappingURL=hash-content.js.map

package/dist/src/unstable/packs/operations/hash-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-content.js","sourceRoot":"","sources":["../../../../../src/unstable/packs/operations/hash-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,EAAE,CAC7C,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC"}

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

@@ -0,0 +1,62 @@
+/**
+ * Install extension pack operation handler.
+ *
+ * Fetches the extension pack archive, extracts to the managed location, and
+ * writes extension pack metadata to settings and lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { Option } from "effect/Option";
+import type { Handle } from "../../extensions/handle.js";
+import { type ResolvedExtensionMap } from "../../lockfile/index.js";
+import type { ExactSemverVersion } from "../../version-constraints/version-constraints.js";
+import type { ExtensionPackRef } from "../refs.js";
+import { SourceHostProviders } from "../../source-resolution/index.js";
+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 install extension pack operation.
+ */
+export interface InstallExtensionPackOperationArgs {
+    /** Pack name (e.g., "my-pack") */
+    readonly packName: string;
+    /** Pack owner (e.g., "@acme") */
+    readonly owner: Handle;
+    /** Exact resolved version */
+    readonly resolvedVersion: ExactSemverVersion;
+    /** SRI integrity string */
+    readonly integrity: string;
+    /** Registry source name */
+    readonly sourceName: string;
+    /** Resolved skill FQNs to exact versions */
+    readonly resolvedSkills: ResolvedExtensionMap;
+    /** Resolved command FQNs to exact versions */
+    readonly resolvedCommands: ResolvedExtensionMap;
+    /** Resolved MCP server FQNs to exact versions */
+    readonly resolvedMcpServers: ResolvedExtensionMap;
+    /** Resolved subagent FQNs to exact versions */
+    readonly resolvedSubagents: ResolvedExtensionMap;
+    /** Version constraint from the original source (e.g. "^2.0.0"). Preserved in settings. */
+    readonly versionConstraint: Option<string>;
+    /** Pack extension ref for fetching the archive. */
+    readonly ref: ExtensionPackRef;
+}
+/**
+ * Add an extension pack to the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type InstallExtensionPackOperation = Operation<"install-pack", InstallExtensionPackOperationArgs>;
+/**
+ * Install extension pack operation handler.
+ *
+ * Fetches the extension pack archive via sources.fetch(), extracts to the managed
+ * extension pack location (.axm/extensions/@owner/packs/pack-name/), then records
+ * the extension pack in settings and lockfile.
+ */
+export declare const installExtensionPack: OperationHandler<InstallExtensionPackOperation, Workspace | CliRenderer | SourceHostProviders | FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/packs/operations/install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,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;AAQjE;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;IAC7C,2BAA2B;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,iDAAiD;IACjD,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAClD,+CAA+C;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;IACjD,0FAA0F;IAC1F,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG,SAAS,CACnD,cAAc,EACd,iCAAiC,CAClC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,CACjD,6BAA6B,EAC7B,SAAS,GAAG,WAAW,GAAG,mBAAmB,GAAG,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CA8FhF,CAAC"}

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

@@ -0,0 +1,78 @@
+/**
+ * Install extension pack operation handler.
+ *
+ * Fetches the extension pack archive, extracts to the managed location, and
+ * writes extension pack metadata to settings and lockfile.
+ *
+ * @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 { makeAppError } from "../../app-error/index.js";
+import { decodeExtensionNameSync } from "../../extensions/index.js";
+import { validateExactResolvedVersion, validateExactResolvedVersionMap, } from "../../lockfile/index.js";
+import { SourceHostProviders } from "../../source-resolution/index.js";
+import { CliRenderer } from "../../cli-renderer/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { copyExtensionDirectory } from "../../extensions/utils.js";
+import { computeExtensionPackPaths } from "../paths.js";
+/**
+ * Install extension pack operation handler.
+ *
+ * Fetches the extension pack archive via sources.fetch(), extracts to the managed
+ * extension pack location (.axm/extensions/@owner/packs/pack-name/), then records
+ * the extension pack in settings and lockfile.
+ */
+export const installExtensionPack = (op) => Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const renderer = yield* CliRenderer;
+    const sources = yield* SourceHostProviders;
+    const path = yield* Path.Path;
+    yield* validateExactResolvedVersion(`packs.${op.args.packName}.resolvedVersion`, op.args.resolvedVersion);
+    yield* validateExactResolvedVersionMap(`packs.${op.args.packName}.resolvedSkills`, op.args.resolvedSkills);
+    yield* validateExactResolvedVersionMap(`packs.${op.args.packName}.resolvedCommands`, op.args.resolvedCommands);
+    yield* validateExactResolvedVersionMap(`packs.${op.args.packName}.resolvedMcpServers`, op.args.resolvedMcpServers);
+    yield* validateExactResolvedVersionMap(`packs.${op.args.packName}.resolvedSubagents`, op.args.resolvedSubagents);
+    // Extract to managed location
+    const packDir = computeExtensionPackPaths(path.join, ws.baseDir, op.args.owner, op.args.packName).canonicalPath;
+    // Keep fetch scope alive through copy; fetched directories are released on scope close.
+    yield* Effect.scoped(Effect.gen(function* () {
+        const fetched = yield* sources.fetch(op.args.ref).pipe(Effect.mapError((error) => makeAppError({
+            code: "PACK_FETCH_FAILED",
+            what: `Failed to fetch extension pack archive: ${error.message}`,
+            cause: error,
+        })));
+        yield* copyExtensionDirectory(fetched.directory, packDir).pipe(Effect.mapError((e) => makeAppError({
+            code: "PACK_EXTRACT_FAILED",
+            what: `Failed to extract extension pack to ${packDir}`,
+            cause: e,
+        })));
+    }));
+    // Write lockfile + settings
+    yield* ws
+        .setExtensionPack({
+        owner: op.args.owner,
+        name: decodeExtensionNameSync(op.args.packName),
+        resolvedVersion: op.args.resolvedVersion,
+        integrity: op.args.integrity,
+        sourceName: op.args.sourceName,
+        installedAt: new Date(),
+        updatedAt: new Date(),
+        resolvedSkills: op.args.resolvedSkills,
+        resolvedCommands: op.args.resolvedCommands,
+        resolvedMcpServers: op.args.resolvedMcpServers,
+        resolvedSubagents: op.args.resolvedSubagents,
+        versionConstraint: op.args.versionConstraint,
+    })
+        .pipe(Effect.catch((e) => renderer.warn(`Extension pack metadata update failed: ${String(e)}`)));
+    return {
+        result: "success",
+        message: `Installed extension pack ${op.args.packName}`,
+    };
+}).pipe(Effect.catch((error) => Effect.succeed({
+    result: "error",
+    message: `Failed to install extension pack: ${error.what}`,
+    error,
+})));
+//# sourceMappingURL=install.js.map

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

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

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

@@ -0,0 +1,38 @@
+/**
+ * New extension pack operation — scaffolds a new extension pack directory with manifest,
+ * and registers in settings/lockfile.
+ *
+ * @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/handle.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 new extension pack operation.
+ */
+export interface NewExtensionPackOperationArgs {
+    /** Pack name (without owner). */
+    readonly name: string;
+    /** Profile (e.g., "@myorg"). */
+    readonly owner: Handle;
+}
+/**
+ * Scaffold a new extension pack in the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type NewExtensionPackOperation = Operation<"new-pack", NewExtensionPackOperationArgs>;
+/**
+ * New extension pack operation handler.
+ *
+ * 1. Compute extension pack directory path
+ * 2. Check if extension pack manifest already exists
+ * 3. Create extension pack directory
+ * 4. Write extension-pack.json manifest
+ * 5. Register in settings via ws.setExtensionPack
+ */
+export declare const newExtensionPack: OperationHandler<NewExtensionPackOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=new-pack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"new-pack.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/packs/operations/new-pack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAKpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAKzD,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;AAQjE;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,CAAC,UAAU,EAAE,6BAA6B,CAAC,CAAC;AAM7F;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBAAgB,CAC7C,yBAAyB,EACzB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CA4F3C,CAAC"}

package/dist/src/unstable/packs/operations/new-pack.js

@@ -0,0 +1,99 @@
+/**
+ * New extension pack operation — scaffolds a new extension pack directory with manifest,
+ * and registers in settings/lockfile.
+ *
+ * @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 { decodeExtensionNameSync, formatFqn } from "../../extensions/index.js";
+import { EXTENSION_PACK_MANIFEST_FILENAME, EXTENSION_PACK_MANIFEST_SCHEMA_URL, } from "../manifest-schema.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { computeExtensionPackPaths } from "../paths.js";
+import { decodeExactSemverVersionSync } from "../../version-constraints/version-constraints.js";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * New extension pack operation handler.
+ *
+ * 1. Compute extension pack directory path
+ * 2. Check if extension pack manifest already exists
+ * 3. Create extension pack directory
+ * 4. Write extension-pack.json manifest
+ * 5. Register in settings via ws.setExtensionPack
+ */
+export const newExtensionPack = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    const initialVersion = decodeExactSemverVersionSync("0.0.1");
+    const { name, owner } = op.args;
+    const extensionName = decodeExtensionNameSync(name);
+    const fqn = formatFqn({ owner, type: "pack", name: extensionName });
+    // 1. Compute extension pack directory path
+    const packDir = computeExtensionPackPaths(path.join, base, owner, name);
+    const manifestPath = path.join(packDir.canonicalPath, EXTENSION_PACK_MANIFEST_FILENAME);
+    // 2. Check if extension pack manifest already exists
+    const exists = yield* fs.exists(manifestPath).pipe(Effect.mapError((e) => makeAppError({
+        code: "PACK_CHECK_FAILED",
+        what: `Failed to check if extension pack exists: ${manifestPath}`,
+        cause: e,
+    })));
+    if (exists) {
+        return yield* makeAppError({
+            code: "PACK_ALREADY_EXISTS",
+            what: `Extension pack '${fqn}' already exists at ${packDir.canonicalPath}`,
+            howToFix: "Choose a different name or remove the existing extension pack first",
+        });
+    }
+    // 3. Create extension pack directory
+    yield* fs.makeDirectory(packDir.canonicalPath, { recursive: true }).pipe(Effect.mapError((e) => makeAppError({
+        code: "PACK_CREATE_FAILED",
+        what: `Failed to create extension pack directory: ${packDir.canonicalPath}`,
+        cause: e,
+    })));
+    // 4. Write manifest
+    const manifest = {
+        $schema: EXTENSION_PACK_MANIFEST_SCHEMA_URL,
+        owner,
+        type: "pack",
+        name: extensionName,
+        version: initialVersion,
+        skills: {},
+        commands: {},
+        "mcp-servers": {},
+    };
+    yield* fs.writeFileString(manifestPath, JSON.stringify(manifest, null, 2) + "\n").pipe(Effect.mapError((e) => makeAppError({
+        code: "PACK_CREATE_FAILED",
+        what: `Failed to write extension pack manifest: ${manifestPath}`,
+        cause: e,
+    })));
+    // 5. Register in settings (best-effort: directory/manifest already on disk)
+    const now = new Date();
+    yield* ws
+        .setExtensionPack({
+        owner,
+        name: extensionName,
+        resolvedVersion: initialVersion,
+        integrity: "",
+        sourceName: "",
+        installedAt: now,
+        updatedAt: now,
+        resolvedSkills: {},
+        resolvedCommands: {},
+        resolvedMcpServers: {},
+        resolvedSubagents: {},
+        versionConstraint: Option.none(),
+    })
+        .pipe(Effect.ignore);
+    return {
+        result: "success",
+        message: `Created extension pack ${fqn}`,
+    };
+});
+//# sourceMappingURL=new-pack.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * Publish extension pack executor -- reads a managed extension pack's manifest, builds a zip
+ * archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * Pipeline: validate manifest -> build archive -> compute integrity ->
+ * resolve registry provider -> publish version (idempotent).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+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 publish-pack operation.
+ */
+export interface PublishExtensionPackOperationArgs {
+    /** Extension identity in `@owner/name` format. */
+    readonly name: string;
+    /** Named source to publish to (e.g., "local"). */
+    readonly registryName: string;
+}
+/**
+ * Publish an extension pack to a registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type PublishExtensionPackOperation = Operation<"publish-pack", PublishExtensionPackOperationArgs>;
+/**
+ * Publish extension pack operation handler.
+ *
+ * 1. Read and validate `extension-pack.json` manifest
+ * 2. Build zip archive of extension pack directory
+ * 3. Compute SRI integrity hash
+ * 4. Resolve target registry provider by source name
+ * 5. Publish version (idempotent: same integrity = no-op, different integrity = error)
+ */
+export declare const publishExtensionPack: OperationHandler<PublishExtensionPackOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=publish.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/packs/operations/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAcpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAOjE;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG,SAAS,CACnD,cAAc,EACd,iCAAiC,CAClC,CAAC;AAMF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,CACjD,6BAA6B,EAC7B,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAsI3C,CAAC"}

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

@@ -0,0 +1,133 @@
+/**
+ * Publish extension pack executor -- reads a managed extension pack's manifest, builds a zip
+ * archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * Pipeline: validate manifest -> build archive -> compute integrity ->
+ * resolve registry provider -> publish version (idempotent).
+ *
+ * @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 * as Schema from "effect/Schema";
+import { parseFqn } from "../../extensions/index.js";
+import { ExtensionPackManifestSchema, EXTENSION_PACK_MANIFEST_FILENAME, } from "../manifest-schema.js";
+import { createRegistryClient } from "../../registry/index.js";
+import { buildZipArchive, computeIntegrity } from "../../utils/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { computeExtensionPackPaths } from "../paths.js";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Publish extension pack operation handler.
+ *
+ * 1. Read and validate `extension-pack.json` manifest
+ * 2. Build zip archive of extension pack directory
+ * 3. Compute SRI integrity hash
+ * 4. Resolve target registry provider by source name
+ * 5. Publish version (idempotent: same integrity = no-op, different integrity = error)
+ */
+export const publishExtensionPack = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    const fqn = yield* parseFqn(op.args.name);
+    // Locate the managed pack directory
+    const packDir = computeExtensionPackPaths(path.join, base, fqn.owner, fqn.name).canonicalPath;
+    const packDirExists = yield* fs.exists(packDir).pipe(Effect.orElseSucceed(() => false));
+    if (!packDirExists) {
+        return yield* makeAppError({
+            code: "PUBLISH_PACK_NOT_FOUND",
+            what: `Managed extension pack not found: ${packDir}`,
+        });
+    }
+    // Read and validate manifest
+    const manifestPath = path.join(packDir, EXTENSION_PACK_MANIFEST_FILENAME);
+    const manifestContent = yield* fs.readFileString(manifestPath).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_PACK_MANIFEST_READ_FAILED",
+        what: `Failed to read manifest: ${manifestPath}`,
+        cause: e,
+    })));
+    const manifestJson = yield* Effect.try({
+        try: () => {
+            const parsed = JSON.parse(manifestContent);
+            return parsed;
+        },
+        catch: (e) => makeAppError({
+            code: "PUBLISH_PACK_MANIFEST_PARSE_FAILED",
+            what: `Invalid JSON in manifest: ${manifestPath}`,
+            cause: e,
+        }),
+    });
+    const manifest = yield* Schema.decodeUnknownEffect(ExtensionPackManifestSchema)(manifestJson).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_PACK_MANIFEST_SCHEMA_INVALID",
+        what: `Invalid manifest schema: ${manifestPath}`,
+        cause: e,
+    })));
+    // Build zip archive from pack directory
+    const archive = yield* buildZipArchive(packDir, "PUBLISH_PACK_ARCHIVE_FAILED");
+    // Compute integrity
+    const integrity = yield* computeIntegrity(archive);
+    // Resolve target registry source
+    const registrySource = yield* ws.getConfiguredSourceByName(op.args.registryName).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_PACK_REGISTRY_LOOKUP_FAILED",
+        what: `Failed to lookup registry source "${op.args.registryName}"`,
+        cause: e,
+    })));
+    if (Option.isNone(registrySource) || registrySource.value.type !== "registry") {
+        return yield* makeAppError({
+            code: "PUBLISH_PACK_REGISTRY_NOT_FOUND",
+            what: `Registry source "${op.args.registryName}" not found or not a registry source`,
+        });
+    }
+    const client = yield* createRegistryClient(registrySource.value.location.href);
+    // Collect manifest dependencies (keys are already 3-segment FQNs)
+    const dependencies = {};
+    const addDependencies = (candidates) => {
+        if (candidates === undefined) {
+            return;
+        }
+        for (const fqn of Object.keys(candidates)) {
+            const constraint = candidates[fqn];
+            if (constraint !== undefined) {
+                dependencies[fqn] = constraint;
+            }
+        }
+    };
+    addDependencies(manifest.skills);
+    addDependencies(manifest.commands);
+    addDependencies(manifest["mcp-servers"]);
+    // Build version entry metadata
+    const versionEntry = {
+        version: manifest.version,
+        published: new Date().toISOString(),
+        integrity,
+        ...(Object.keys(dependencies).length > 0 && { dependencies }),
+    };
+    // Publish to registry (idempotent)
+    yield* client
+        .publishExtension({
+        owner: fqn.owner,
+        type: "pack",
+        name: fqn.name,
+        version: manifest.version,
+        archive,
+        metadata: versionEntry,
+    })
+        .pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_PACK_PUBLISH_FAILED",
+        what: "Failed to publish to registry",
+        details: [e.what],
+        cause: e,
+    })));
+    return {
+        result: "success",
+        message: `Published ${op.args.name}@${manifest.version}`,
+    };
+});
+//# sourceMappingURL=publish.js.map

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

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