@agentxm/client-core 0.1.6

package/dist/src/unstable/packaging/swift.js

@@ -0,0 +1,165 @@
+/**
+ * Swift package detector and reader for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { AxmPackageMetaSchema } from "./axm-package-meta.js";
+import { PackageTypeSchema } from "./package-type.js";
+import { PackageUrlPartsSchema } from "./package-url.js";
+const swiftType = Schema.decodeUnknownSync(PackageTypeSchema)("swift");
+const makePackageUrlParts = Schema.decodeUnknownSync(PackageUrlPartsSchema);
+const decodeAxmMeta = Schema.decodeUnknownResult(AxmPackageMetaSchema);
+/**
+ * Regex to match `exact: "version"` in a package declaration.
+ */
+const EXACT_VERSION_REGEX = /exact:\s*"([^"]+)"/;
+/**
+ * Parse a Swift package URL into namespace and name parts.
+ * URL format: https://github.com/Owner/RepoName.git
+ * namespace = host/org, name = repo (without .git)
+ */
+const parseSwiftUrl = (url) => {
+    try {
+        const parsed = new URL(url);
+        const pathParts = parsed.pathname.split("/").filter((p) => p.length > 0);
+        if (pathParts.length < 2)
+            return undefined;
+        const host = parsed.hostname;
+        // All segments except the last form the org path
+        const orgParts = pathParts.slice(0, -1);
+        const rawName = pathParts[pathParts.length - 1];
+        if (rawName === undefined)
+            return undefined;
+        // Strip .git suffix
+        const name = rawName.endsWith(".git") ? rawName.slice(0, -4) : rawName;
+        const namespace = `${host}/${orgParts.join("/")}`;
+        return { namespace, name };
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Extract the version requirement from a package declaration line/context.
+ * Returns the exact version if specified, undefined otherwise (ranges are versionless).
+ */
+const extractVersion = (packageContext) => {
+    const exactMatch = EXACT_VERSION_REGEX.exec(packageContext);
+    if (exactMatch?.[1] !== undefined)
+        return exactMatch[1];
+    return undefined;
+};
+/**
+ * Build PackageUrlParts directly for swift packages.
+ * packageurl-js v2 requires a version for swift type purls, but we need
+ * versionless purls for range dependencies. We construct parts directly
+ * through the PackageUrlPartsSchema to bypass purl-string validation.
+ */
+const buildSwiftPurlParts = (namespace, name, version) => makePackageUrlParts(version !== undefined
+    ? { type: "swift", namespace, name, version }
+    : { type: "swift", namespace, name });
+/**
+ * Parse Package.swift content and extract dependencies using regex.
+ * Since running `swift package dump-package` requires the Swift CLI,
+ * we use simple regex to extract `.package(url: "...")` dependencies.
+ */
+const parsePackageSwift = (content, source) => {
+    const results = [];
+    // Find all .package(url: "...") declarations
+    // We search for the entire package(...) block to extract version info too
+    const packageBlockRegex = /\.package\([^)]*url:\s*"([^"]+)"[^)]*\)/g;
+    let match;
+    while ((match = packageBlockRegex.exec(content)) !== null) {
+        const url = match[1];
+        if (url === undefined)
+            continue;
+        const parsed = parseSwiftUrl(url);
+        if (parsed === undefined)
+            continue;
+        // Extract version from the full match context
+        const version = extractVersion(match[0]);
+        const purlParts = buildSwiftPurlParts(parsed.namespace, parsed.name, version);
+        results.push({ purl: purlParts, type: swiftType, source });
+    }
+    return results;
+};
+/**
+ * Read a file as string, returning Option.none for NotFound and other errors.
+ */
+const readFileOptional = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    return content;
+});
+/**
+ * Parse JSON string, returning Option.none and logging a warning on failure.
+ */
+const parseJsonOptional = (content, context) => Effect.gen(function* () {
+    const result = yield* Effect.try({
+        try: () => JSON.parse(content),
+        catch: () => ({ _tag: "JsonParseError" }),
+    }).pipe(Effect.option);
+    if (Option.isNone(result)) {
+        yield* Effect.logWarning(`Malformed JSON in ${context}, skipping`);
+        return Option.none();
+    }
+    return Option.some(result.value);
+});
+/**
+ * Swift package detector.
+ *
+ * Scans `Package.swift` in the project directory and extracts `.package(url: ...)`
+ * dependencies using regex pattern matching.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const swiftDetector = {
+    type: swiftType,
+    detect: Effect.fn("detect.swift")(function* (projectDir) {
+        const path = yield* Path.Path;
+        const manifestPath = path.join(projectDir, "Package.swift");
+        const content = yield* readFileOptional(manifestPath);
+        if (Option.isNone(content))
+            return [];
+        const deps = parsePackageSwift(content.value, manifestPath);
+        return deps;
+    }, Effect.annotateLogs({ detector: "swift" }), Effect.withSpan("detect.swift")),
+};
+/**
+ * Swift package reader.
+ *
+ * Reads `.build/checkouts/<package-name>/axm.json` for each detected SwiftPM
+ * package and extracts recommendation metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const swiftReader = {
+    type: swiftType,
+    read: Effect.fn("read.swift")(function* (pkg) {
+        const path = yield* Path.Path;
+        // Derive project directory from the source manifest path
+        const projectDir = path.dirname(pkg.source);
+        const axmJsonPath = path.join(projectDir, ".build", "checkouts", pkg.purl.name, "axm.json");
+        const content = yield* readFileOptional(axmJsonPath);
+        if (Option.isNone(content))
+            return Option.none();
+        const parsed = yield* parseJsonOptional(content.value, `${pkg.purl.name}/axm.json`);
+        if (Option.isNone(parsed))
+            return Option.none();
+        // Validate axm metadata structure
+        const metaResult = decodeAxmMeta(parsed.value);
+        if (Result.isFailure(metaResult)) {
+            yield* Effect.logWarning(`Invalid axm metadata in ${pkg.purl.name}: schema validation failed`);
+            return Option.none();
+        }
+        return Option.some(metaResult.success.recommendedExtensions);
+    }, Effect.annotateLogs({ reader: "swift" }), Effect.withSpan("read.swift")),
+};
+//# sourceMappingURL=swift.js.map

package/dist/src/unstable/packaging/swift.js.map

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

package/dist/src/unstable/packaging/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Detector and reader interfaces for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type * as Effect from "effect/Effect";
+import type * as Option from "effect/Option";
+import type * as FileSystem from "effect/FileSystem";
+import type * as Path from "effect/Path";
+import type { FullyQualifiedRef } from "../extensions/common.js";
+import type { PackageType } from "./package-type.js";
+import type { PackageUrlParts } from "./package-url.js";
+/**
+ * A package detected in a project directory.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface DetectedPackage {
+    readonly purl: PackageUrlParts;
+    readonly type: PackageType;
+    /** File that produced this purl (for diagnostics). */
+    readonly source: string;
+}
+/**
+ * Scans a project directory for packages of a specific type.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface PackageDetector {
+    readonly type: PackageType;
+    readonly detect: (projectDir: string) => Effect.Effect<ReadonlyArray<DetectedPackage>, never, FileSystem.FileSystem | Path.Path>;
+}
+/**
+ * Reads local recommendation data from a detected package.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface PackageReader {
+    readonly type: PackageType;
+    readonly read: (pkg: DetectedPackage) => Effect.Effect<Option.Option<ReadonlyArray<FullyQualifiedRef>>, never, FileSystem.FileSystem | Path.Path>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/unstable/packaging/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,CACf,UAAU,EAAE,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;CAC9F;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,CACb,GAAG,EAAE,eAAe,KACjB,MAAM,CAAC,MAAM,CAChB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,EAC/C,KAAK,EACL,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAClC,CAAC;CACH"}

package/dist/src/unstable/packaging/types.js

@@ -0,0 +1,8 @@
+/**
+ * Detector and reader interfaces for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/unstable/packaging/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/unstable/packaging/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/src/unstable/packaging/zig.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Zig package detector and reader for package-compatibility discovery.
+ *
+ * Parses `build.zig.zon` for URL-based dependencies and reads axm metadata
+ * from the Zig package cache at `~/.cache/zig/`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { PackageDetector, PackageReader } from "./types.js";
+/**
+ * Zig package detector.
+ *
+ * Scans `build.zig.zon` in the project directory and extracts dependency
+ * names from the `.dependencies` field, producing `pkg:generic/zig/<name>` purls.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const zigDetector: PackageDetector;
+/**
+ * Zig package reader.
+ *
+ * Reads `axm.json` sidecar files from `~/.cache/zig/p/<hash>/` for each
+ * detected Zig package and extracts recommendation metadata.
+ *
+ * Since Zig uses content-addressed hashes for packages rather than named
+ * directories, the reader does a best-effort scan of the cache.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const zigReader: PackageReader;
+//# sourceMappingURL=zig.d.ts.map

package/dist/src/unstable/packaging/zig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zig.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/zig.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,KAAK,EAAmB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwFlF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,eAoCzB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,EAAE,aA0CvB,CAAC"}

package/dist/src/unstable/packaging/zig.js

@@ -0,0 +1,176 @@
+/**
+ * Zig package detector and reader for package-compatibility discovery.
+ *
+ * Parses `build.zig.zon` for URL-based dependencies and reads axm metadata
+ * from the Zig package cache at `~/.cache/zig/`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Intentional escape hatch: node:os homedir() has no @effect/platform equivalent.
+import * as os from "node:os";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { PackageURL } from "packageurl-js";
+import { AxmPackageMetaSchema } from "./axm-package-meta.js";
+import { PackageTypeSchema } from "./package-type.js";
+import { PackageUrlSchema } from "./package-url.js";
+const zigType = Schema.decodeUnknownSync(PackageTypeSchema)("generic");
+const decodePurl = Schema.decodeUnknownSync(PackageUrlSchema);
+const decodeAxmMeta = Schema.decodeUnknownResult(AxmPackageMetaSchema);
+/**
+ * Read a file as string, returning Option.none for NotFound and other errors.
+ */
+const readFileOptional = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    return content;
+});
+/**
+ * Parse JSON string, returning Option.none and logging a warning on failure.
+ */
+const parseJsonOptional = (content, context) => Effect.gen(function* () {
+    const result = yield* Effect.try({
+        try: () => JSON.parse(content),
+        catch: () => ({ _tag: "JsonParseError" }),
+    }).pipe(Effect.option);
+    if (Option.isNone(result)) {
+        yield* Effect.logWarning(`Malformed JSON in ${context}, skipping`);
+        return Option.none();
+    }
+    return Option.some(result.value);
+});
+/**
+ * Extract dependency names from build.zig.zon content.
+ *
+ * Zon uses a struct-like syntax:
+ * ```
+ * .dependencies = .{
+ *     .zap = .{ .url = "...", .hash = "..." },
+ *     .mach = .{ .url = "...", .hash = "..." },
+ * },
+ * ```
+ *
+ * We extract the dependency names (keys) using regex.
+ */
+const parseZonDependencies = (content) => {
+    // Find the start of the .dependencies block
+    const startIdx = content.indexOf(".dependencies");
+    if (startIdx === -1)
+        return [];
+    // Find the opening .{ after .dependencies =
+    const openBrace = content.indexOf(".{", startIdx);
+    if (openBrace === -1)
+        return [];
+    // Track brace depth to find the matching closing }
+    let depth = 0;
+    let endIdx = openBrace;
+    for (let i = openBrace; i < content.length; i++) {
+        if (content[i] === "{")
+            depth++;
+        if (content[i] === "}") {
+            depth--;
+            if (depth === 0) {
+                endIdx = i;
+                break;
+            }
+        }
+    }
+    const depsBlock = content.slice(openBrace, endIdx + 1);
+    const names = [];
+    // Match dependency names: .name = .{ ... }
+    // Also support quoted names: .@"name-with-dashes" = .{ ... }
+    const depPattern = /\.(?:@"([^"]+)"|([a-zA-Z_][a-zA-Z0-9_]*))\s*=\s*\.?\{/g;
+    let match = depPattern.exec(depsBlock);
+    while (match !== null) {
+        const name = match[1] ?? match[2];
+        if (name !== undefined) {
+            names.push(name);
+        }
+        match = depPattern.exec(depsBlock);
+    }
+    return names;
+};
+/**
+ * Zig package detector.
+ *
+ * Scans `build.zig.zon` in the project directory and extracts dependency
+ * names from the `.dependencies` field, producing `pkg:generic/zig/<name>` purls.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const zigDetector = {
+    type: zigType,
+    detect: Effect.fn("detect.zig")(function* (projectDir) {
+        const path = yield* Path.Path;
+        const manifestPath = path.join(projectDir, "build.zig.zon");
+        const content = yield* readFileOptional(manifestPath);
+        if (Option.isNone(content))
+            return [];
+        const names = parseZonDependencies(content.value);
+        if (names.length === 0) {
+            // Check if the file looks like it should have dependencies but we couldn't parse
+            if (content.value.includes(".dependencies") &&
+                !content.value.includes(".dependencies = .{")) {
+                yield* Effect.logWarning("Malformed build.zig.zon: could not parse .dependencies, skipping");
+            }
+            return [];
+        }
+        const results = [];
+        for (const name of names) {
+            const purl = new PackageURL("generic", "zig", name, null, null, null);
+            const purlParts = decodePurl(purl.toString());
+            results.push({ purl: purlParts, type: zigType, source: manifestPath });
+        }
+        return results;
+    }, Effect.annotateLogs({ detector: "zig" }), Effect.withSpan("detect.zig")),
+};
+/**
+ * Zig package reader.
+ *
+ * Reads `axm.json` sidecar files from `~/.cache/zig/p/<hash>/` for each
+ * detected Zig package and extracts recommendation metadata.
+ *
+ * Since Zig uses content-addressed hashes for packages rather than named
+ * directories, the reader does a best-effort scan of the cache.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const zigReader = {
+    type: zigType,
+    read: Effect.fn("read.zig")(function* (pkg) {
+        const path = yield* Path.Path;
+        const fs = yield* FileSystem.FileSystem;
+        const cacheDir = path.join(os.homedir(), ".cache", "zig", "p");
+        // Check if cache directory exists
+        const cacheDirExists = yield* fs.exists(cacheDir).pipe(Effect.option);
+        if (Option.isNone(cacheDirExists) || !cacheDirExists.value)
+            return Option.none();
+        // Scan cache directory entries for axm.json
+        const entries = yield* fs.readDirectory(cacheDir).pipe(Effect.option);
+        if (Option.isNone(entries))
+            return Option.none();
+        // Check each cache entry for axm.json with matching package name
+        for (const entry of entries.value) {
+            const axmJsonPath = path.join(cacheDir, entry, "axm.json");
+            const content = yield* readFileOptional(axmJsonPath);
+            if (Option.isNone(content))
+                continue;
+            const parsed = yield* parseJsonOptional(content.value, `${pkg.purl.name}/axm.json`);
+            if (Option.isNone(parsed))
+                continue;
+            const metaResult = decodeAxmMeta(parsed.value);
+            if (Result.isFailure(metaResult)) {
+                yield* Effect.logWarning(`Invalid axm metadata in zig cache for ${pkg.purl.name}: schema validation failed`);
+                continue;
+            }
+            return Option.some(metaResult.success.recommendedExtensions);
+        }
+        return Option.none();
+    }, Effect.annotateLogs({ reader: "zig" }), Effect.withSpan("read.zig")),
+};
+//# sourceMappingURL=zig.js.map

package/dist/src/unstable/packaging/zig.js.map

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

package/dist/src/unstable/packs/dependency-resolution.d.ts

@@ -0,0 +1,15 @@
+import * as Effect from "effect/Effect";
+import type { ExtensionRef } from "../extensions/index.js";
+import type { ResolvedExtensionMap } from "../lockfile/index.js";
+import type { SourceHostProvidersService } from "../source-resolution/index.js";
+import { type AppError } from "../app-error/index.js";
+import type { ExtensionPackRef } from "./refs.js";
+export interface ResolvedExtensionPackDependencies {
+    readonly resolvedSkills: ResolvedExtensionMap;
+    readonly resolvedCommands: ResolvedExtensionMap;
+    readonly resolvedMcpServers: ResolvedExtensionMap;
+    readonly resolvedSubagents: ResolvedExtensionMap;
+    readonly dependencyRefs: ReadonlyArray<ExtensionRef>;
+}
+export declare const resolveExtensionPackDependencies: (pack: ExtensionPackRef, sources: SourceHostProvidersService) => Effect.Effect<ResolvedExtensionPackDependencies, AppError>;
+//# sourceMappingURL=dependency-resolution.d.ts.map

package/dist/src/unstable/packs/dependency-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolution.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packs/dependency-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAwC,MAAM,wBAAwB,CAAC;AAEjG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAmBlD,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAClD,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;IACjD,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;CACtD;AAqGD,eAAO,MAAM,gCAAgC,GAC3C,MAAM,gBAAgB,EACtB,SAAS,0BAA0B,KAClC,MAAM,CAAC,MAAM,CAAC,iCAAiC,EAAE,QAAQ,CAkExD,CAAC"}

package/dist/src/unstable/packs/dependency-resolution.js

@@ -0,0 +1,77 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { parseFqnOrThrow, formatFqn } from "../extensions/index.js";
+import { makeAppError } from "../app-error/index.js";
+import { buildRegistrySkillRef } from "../skills/registry-ref-builder.js";
+import { buildRegistryCommandRef } from "../commands/registry-ref-builder.js";
+import { buildRegistryMcpServerRef } from "../mcp-servers/registry-ref-builder.js";
+import { buildRegistrySubagentRef } from "../subagents/registry-ref-builder.js";
+import { decodeExactSemverVersionSync, } from "../version-constraints/version-constraints.js";
+const resolveDependencyType = (expectedType, parsedType) => {
+    if (parsedType === expectedType) {
+        return Effect.void;
+    }
+    return Effect.fail(makeAppError({
+        code: "PACK_DEPENDENCY_RESOLUTION_FAILED",
+        what: `Extension pack dependency type mismatch for expected ${expectedType}`,
+        details: [`Expected ${expectedType}, received ${parsedType}`],
+    }));
+};
+const registrySourceForDependency = (pack, owner) => {
+    if (pack.source.type !== "registry") {
+        return Effect.fail(makeAppError({
+            code: "PACK_DEPENDENCY_RESOLUTION_FAILED",
+            what: `Cannot resolve extension pack dependencies from non-registry source`,
+        }));
+    }
+    return Effect.succeed({
+        ...pack.source,
+        owner: Option.some(owner),
+    });
+};
+const resolveDependencyRef = (pack, expectedType, fqn, constraint, sources) => Effect.gen(function* () {
+    const parsed = parseFqnOrThrow(fqn);
+    yield* resolveDependencyType(expectedType, parsed.type);
+    const source = yield* registrySourceForDependency(pack, parsed.owner);
+    const matches = yield* Effect.scoped(sources.find(source, {
+        names: [parsed.name],
+        type: expectedType,
+        owner: Option.some(parsed.owner),
+        versionConstraint: Option.some(constraint),
+    }));
+    const matchingRef = matches.find((candidate) => candidate.type === expectedType &&
+        candidate.refType === "registry" &&
+        candidate.owner === parsed.owner &&
+        candidate.name === parsed.name);
+    if (matchingRef === undefined) {
+        return yield* makeAppError({
+            code: "PACK_DEPENDENCY_RESOLUTION_FAILED",
+            what: `Unable to resolve extension pack dependency ${fqn}@${constraint}`,
+        });
+    }
+    return { ...parsed, ref: matchingRef, source };
+});
+const toResolvedMap = (dependencies) => Object.fromEntries(dependencies.map((dependency) => [
+    formatFqn(dependency),
+    decodeExactSemverVersionSync(dependency.ref.version),
+]));
+const resolveDependencyGroup = (pack, dependencies, expectedType, sources) => Effect.forEach(Object.entries(dependencies), ([fqn, constraint]) => resolveDependencyRef(pack, expectedType, fqn, constraint, sources), { concurrency: "unbounded" });
+export const resolveExtensionPackDependencies = (pack, sources) => Effect.gen(function* () {
+    const resolvedSkills = yield* resolveDependencyGroup(pack, pack.pack.skills, "skill", sources);
+    const resolvedCommands = yield* resolveDependencyGroup(pack, pack.pack.commands, "command", sources);
+    const resolvedMcpServers = yield* resolveDependencyGroup(pack, pack.pack.mcpServers, "mcp-server", sources);
+    const resolvedSubagents = yield* resolveDependencyGroup(pack, pack.pack.subagents, "subagent", sources);
+    return {
+        resolvedSkills: toResolvedMap(resolvedSkills),
+        resolvedCommands: toResolvedMap(resolvedCommands),
+        resolvedMcpServers: toResolvedMap(resolvedMcpServers),
+        resolvedSubagents: toResolvedMap(resolvedSubagents),
+        dependencyRefs: [
+            ...resolvedSkills.map((dependency) => buildRegistrySkillRef(dependency.owner, dependency.name, dependency.ref.version, dependency.source, dependency.ref.compatiblePackages)),
+            ...resolvedCommands.map((dependency) => buildRegistryCommandRef(dependency.owner, dependency.name, dependency.ref.version, dependency.source, dependency.ref.compatiblePackages)),
+            ...resolvedMcpServers.map((dependency) => buildRegistryMcpServerRef(dependency.owner, dependency.name, dependency.ref.version, dependency.source, dependency.ref.compatiblePackages)),
+            ...resolvedSubagents.map((dependency) => buildRegistrySubagentRef(dependency.owner, dependency.name, dependency.ref.version, dependency.source, dependency.ref.compatiblePackages)),
+        ],
+    };
+});
+//# sourceMappingURL=dependency-resolution.js.map

package/dist/src/unstable/packs/dependency-resolution.js.map

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

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

@@ -0,0 +1,64 @@
+/**
+ * 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 { type AppError } from "../app-error/index.js";
+import { type ExtensionType } from "../extensions/index.js";
+import type { ExtensionRef } from "../extensions/index.js";
+import type { ExtensionPackRef } from "./refs.js";
+import type { ExtensionTarget, PackExtensionTarget, SkillExtensionTarget } from "../workspace/service-interface.js";
+import type { Lockfile } from "../lockfile/index.js";
+import type { SourceHostProvidersService } from "../source-resolution/index.js";
+/**
+ * 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 declare const expandExtensionPackInstallRefs: (args: {
+    readonly pack: ExtensionPackRef;
+    readonly supportedDependencyTypes: ReadonlyArray<ExtensionType>;
+    readonly sources: SourceHostProvidersService;
+}) => Effect.Effect<ReadonlyArray<ExtensionRef>, AppError>;
+/** Settings shape needed for directly-configured extension checks. */
+export interface UninstallSettingsContext {
+    readonly skills: Readonly<Record<string, string>>;
+    readonly commands: Readonly<Record<string, string>>;
+    readonly mcpServers: Readonly<Record<string, string>>;
+    readonly subagents: Readonly<Record<string, string>>;
+}
+/**
+ * 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 declare const expandExtensionPackUninstallTargets: (args: {
+    readonly pack: PackExtensionTarget;
+    readonly supportedDependencyTypes: ReadonlyArray<ExtensionType>;
+    readonly lockfile: Lockfile;
+    readonly settings: UninstallSettingsContext;
+}) => Effect.Effect<ReadonlyArray<ExtensionTarget>, AppError>;
+/**
+ * Resolve skill names to lockfile-backed uninstall targets.
+ *
+ * Fails with AppError if any skill name is not found in the lockfile.
+ */
+export declare const resolveSkillUninstallTargetsFromLockfile: (skills: ReadonlyArray<{
+    readonly skillName: string;
+}>, lockfile: Lockfile) => Effect.Effect<ReadonlyArray<SkillExtensionTarget>, AppError>;
+//# sourceMappingURL=expansion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expansion.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packs/expansion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAgC,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAWhF;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,GAAI,MAAM;IACnD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,wBAAwB,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAChE,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;CAC9C,KAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,QAAQ,CAWnD,CAAC;AAML,sEAAsE;AACtE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,mCAAmC,GAAI,MAAM;IACxD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,wBAAwB,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAChE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C,KAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,QAAQ,CAyFzD,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,wCAAwC,GACnD,QAAQ,aAAa,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EACrD,UAAU,QAAQ,KACjB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE,QAAQ,CAe1D,CAAC"}