@agentxm/client-core 0.1.6

package/dist/src/unstable/utils/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../../src/unstable/utils/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,uHAAuH;AACvH,MAAM,OAAO,GAAG,CAAC,IAAY,EAAsB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAExE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAwC,EAAE,CAC9E,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAE3D,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAyB,EAAE,CACtF,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC;AAE/C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,KAAK,GAA2B,MAAM,CAAC,IAAI,CACtD,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,SAAS,CAC9E,CAAC;AAEF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,MAAM,GAAG,GAAY,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;AAE9D,iFAAiF;AACjF,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC7C,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,EAAE;SAC3B,MAAM,CAAC,aAAa,CAAC;SACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,YAAY;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,EAAE;SAC9B,MAAM,CAAC,gBAAgB,CAAC;SACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnD,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,QAAwD,EACxD,QAAgB,EAChB,OAAe,EACf,YAAgC,EACxB,EAAE;IACV,IAAI,QAAQ,KAAK,OAAO,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QACvD,OAAO,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAwD,EAAE,EAAE,CAC5F,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IACf,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC;IAC3F,OAAO,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;AAC1E,CAAC,CAAC,CAAC;AAEL,+EAA+E;AAC/E,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACvC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjG,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE;SACtB,cAAc,CAAC,eAAe,CAAC;SAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC"}

package/dist/src/unstable/utils/fs-helpers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared filesystem helpers for skill operations.
+ *
+ * @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";
+/**
+ * Remove a directory if it exists, ignoring errors.
+ */
+export declare const removeIfExists: (fsService: FileSystem.FileSystem, dirPath: string) => Effect.Effect<void, never, never>;
+/**
+ * Remove a skill from ALL known canonical locations.
+ *
+ * Ensures clean removal regardless of where the skill was installed:
+ * 1. `.axm/extensions/external/skills/<name>/` (non-registry canonical)
+ * 2. `.axm/extensions/@* /skills/<name>/` (registry canonical, any owner)
+ */
+export declare const removeFromAllCanonicalLocations: (fsService: FileSystem.FileSystem, base: string, sanitizedName: string, pathService: Path.Path) => Effect.Effect<void, never, never>;
+/**
+ * Strip the `file://` protocol prefix from a location string.
+ */
+export declare const stripFileProtocol: (location: string) => string;
+//# sourceMappingURL=fs-helpers.d.ts.map

package/dist/src/unstable/utils/fs-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-helpers.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/fs-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,WAAW,UAAU,CAAC,UAAU,EAAE,SAAS,MAAM,sCAM7E,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,GAC1C,WAAW,UAAU,CAAC,UAAU,EAChC,MAAM,MAAM,EACZ,eAAe,MAAM,EACrB,aAAa,IAAI,CAAC,IAAI,sCA8BpB,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,MAA4C,CAAC"}

package/dist/src/unstable/utils/fs-helpers.js

@@ -0,0 +1,45 @@
+/**
+ * Shared filesystem helpers for skill operations.
+ *
+ * @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 { EXTERNAL_EXTENSIONS_DIR, REGISTRY_EXTENSIONS_DIR } from "../extensions/constants.js";
+/**
+ * Remove a directory if it exists, ignoring errors.
+ */
+export const removeIfExists = (fsService, dirPath) => fsService.exists(dirPath).pipe(Effect.catch(() => Effect.succeed(false)), Effect.flatMap((exists) => exists ? fsService.remove(dirPath, { recursive: true }).pipe(Effect.ignore) : Effect.void));
+/**
+ * Remove a skill from ALL known canonical locations.
+ *
+ * Ensures clean removal regardless of where the skill was installed:
+ * 1. `.axm/extensions/external/skills/<name>/` (non-registry canonical)
+ * 2. `.axm/extensions/@* /skills/<name>/` (registry canonical, any owner)
+ */
+export const removeFromAllCanonicalLocations = (fsService, base, sanitizedName, pathService) => Effect.gen(function* () {
+    // Remove from non-registry canonical location
+    yield* removeIfExists(fsService, pathService.join(base, EXTERNAL_EXTENSIONS_DIR, "skills", sanitizedName));
+    // Remove from any registry canonical location
+    const extensionsDir = pathService.join(base, REGISTRY_EXTENSIONS_DIR);
+    const extensionsDirExists = yield* fsService
+        .exists(extensionsDir)
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    if (extensionsDirExists) {
+        const scopeDirs = yield* fsService
+            .readDirectory(extensionsDir)
+            .pipe(Effect.catch(() => Effect.succeed([])));
+        yield* Effect.forEach(scopeDirs, (scopeDir) => {
+            if (!scopeDir.startsWith("@"))
+                return Effect.void;
+            const skillPath = pathService.join(extensionsDir, scopeDir, "skills", sanitizedName);
+            return removeIfExists(fsService, skillPath);
+        }, { concurrency: "unbounded" });
+    }
+});
+/**
+ * Strip the `file://` protocol prefix from a location string.
+ */
+export const stripFileProtocol = (location) => location.replace(/^file:\/\//, "");
+//# sourceMappingURL=fs-helpers.js.map

package/dist/src/unstable/utils/fs-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-helpers.js","sourceRoot":"","sources":["../../../../src/unstable/utils/fs-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE9F;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAgC,EAAE,OAAe,EAAE,EAAE,CAClF,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EACzC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CACxB,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAC1F,CACF,CAAC;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAC7C,SAAgC,EAChC,IAAY,EACZ,aAAqB,EACrB,WAAsB,EACtB,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,8CAA8C;IAC9C,KAAK,CAAC,CAAC,cAAc,CACnB,SAAS,EACT,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,aAAa,CAAC,CACzE,CAAC;IAEF,8CAA8C;IAC9C,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IACtE,MAAM,mBAAmB,GAAG,KAAK,CAAC,CAAC,SAAS;SACzC,MAAM,CAAC,aAAa,CAAC;SACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnD,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,SAAS;aAC/B,aAAa,CAAC,aAAa,CAAC;aAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAwB,EAAE,CAAC,CAAC,CAAC,CAAC;QAEvE,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACnB,SAAS,EACT,CAAC,QAAQ,EAAE,EAAE;YACX,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC;YAClD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;YACrF,OAAO,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9C,CAAC,EACD,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEL;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC"}

package/dist/src/unstable/utils/glob.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Glob expansion for extension names.
+ *
+ * Expands `*` wildcards against a list of names. Only `*` is supported
+ * as a wildcard — all other characters are treated as literals.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Expand a glob pattern against a list of names.
+ *
+ * Only `*` wildcards are supported. All other characters (including `?`, `[`, `]`)
+ * are treated as literals. Matching is case-sensitive.
+ *
+ * @param pattern - The pattern to match (may contain `*`)
+ * @param names - Available names to match against
+ * @returns Matching names in their original order
+ */
+export declare const expandGlob: (pattern: string, names: ReadonlyArray<string>) => ReadonlyArray<string>;
+/**
+ * Expand multiple glob patterns against a list of skill names.
+ *
+ * Returns the union of all matches, deduplicated, preserving the original
+ * order of `names`.
+ *
+ * @param patterns - Patterns to match (may contain `*`)
+ * @param names - Available names to match against
+ * @returns Matching names in their original order, deduplicated
+ */
+export declare const expandGlobs: (patterns: ReadonlyArray<string>, names: ReadonlyArray<string>) => ReadonlyArray<string>;
+/**
+ * Returns true when an input should be treated as a glob pattern.
+ */
+export declare const isGlobPattern: (input: string) => boolean;
+//# sourceMappingURL=glob.d.ts.map

package/dist/src/unstable/utils/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,EACf,OAAO,aAAa,CAAC,MAAM,CAAC,KAC3B,aAAa,CAAC,MAAM,CAKtB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GACtB,UAAU,aAAa,CAAC,MAAM,CAAC,EAC/B,OAAO,aAAa,CAAC,MAAM,CAAC,KAC3B,aAAa,CAAC,MAAM,CAQtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,OAA8B,CAAC"}

package/dist/src/unstable/utils/glob.js

@@ -0,0 +1,48 @@
+/**
+ * Glob expansion for extension names.
+ *
+ * Expands `*` wildcards against a list of names. Only `*` is supported
+ * as a wildcard — all other characters are treated as literals.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Expand a glob pattern against a list of names.
+ *
+ * Only `*` wildcards are supported. All other characters (including `?`, `[`, `]`)
+ * are treated as literals. Matching is case-sensitive.
+ *
+ * @param pattern - The pattern to match (may contain `*`)
+ * @param names - Available names to match against
+ * @returns Matching names in their original order
+ */
+export const expandGlob = (pattern, names) => {
+    const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+    const regexSource = `^${escaped.replace(/\*/g, ".*")}$`;
+    const regex = new RegExp(regexSource);
+    return names.filter((name) => regex.test(name));
+};
+/**
+ * Expand multiple glob patterns against a list of skill names.
+ *
+ * Returns the union of all matches, deduplicated, preserving the original
+ * order of `names`.
+ *
+ * @param patterns - Patterns to match (may contain `*`)
+ * @param names - Available names to match against
+ * @returns Matching names in their original order, deduplicated
+ */
+export const expandGlobs = (patterns, names) => {
+    const matched = new Set();
+    for (const pattern of patterns) {
+        for (const name of expandGlob(pattern, names)) {
+            matched.add(name);
+        }
+    }
+    return names.filter((n) => matched.has(n));
+};
+/**
+ * Returns true when an input should be treated as a glob pattern.
+ */
+export const isGlobPattern = (input) => input.includes("*");
+//# sourceMappingURL=glob.js.map

package/dist/src/unstable/utils/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../../../src/unstable/utils/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAAe,EACf,KAA4B,EACL,EAAE;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,QAA+B,EAC/B,KAA4B,EACL,EAAE;IACzB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC"}

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

@@ -0,0 +1,10 @@
+export { buildZipArchive } from "./build-zip-archive.js";
+export { removeIfExists, removeFromAllCanonicalLocations, stripFileProtocol, } from "./fs-helpers.js";
+export { computeIntegrity } from "./integrity.js";
+export { isPathSafe } from "./path-safety.js";
+export { resolveParentSymlinks } from "./resolve-parent-symlinks.js";
+export { createSymlink, type SymlinkResult } from "./create-symlink.js";
+export { envOption, envWithDefault, isContainer, isRoot, isSSH, isWSL, resolveAxmDataDir, resolveAxmDataDirPure, } from "./environment.js";
+export { expandGlob, expandGlobs, isGlobPattern } from "./glob.js";
+export { isLoopbackAddress } from "./network.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,cAAc,EACd,+BAA+B,EAC/B,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EACL,SAAS,EACT,cAAc,EACd,WAAW,EACX,MAAM,EACN,KAAK,EACL,KAAK,EACL,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,10 @@
+export { buildZipArchive } from "./build-zip-archive.js";
+export { removeIfExists, removeFromAllCanonicalLocations, stripFileProtocol, } from "./fs-helpers.js";
+export { computeIntegrity } from "./integrity.js";
+export { isPathSafe } from "./path-safety.js";
+export { resolveParentSymlinks } from "./resolve-parent-symlinks.js";
+export { createSymlink } from "./create-symlink.js";
+export { envOption, envWithDefault, isContainer, isRoot, isSSH, isWSL, resolveAxmDataDir, resolveAxmDataDirPure, } from "./environment.js";
+export { expandGlob, expandGlobs, isGlobPattern } from "./glob.js";
+export { isLoopbackAddress } from "./network.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,cAAc,EACd,+BAA+B,EAC/B,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAsB,MAAM,qBAAqB,CAAC;AACxE,OAAO,EACL,SAAS,EACT,cAAc,EACd,WAAW,EACX,MAAM,EACN,KAAK,EACL,KAAK,EACL,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/unstable/utils/integrity.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SHA-512 integrity utility.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+/** Compute SHA-512 integrity in `sha512-<base64>` SRI format. */
+export declare const computeIntegrity: (data: Uint8Array) => Effect.Effect<string>;
+//# sourceMappingURL=integrity.d.ts.map

package/dist/src/unstable/utils/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/integrity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,GAAI,MAAM,UAAU,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAIpE,CAAC"}

package/dist/src/unstable/utils/integrity.js

@@ -0,0 +1,13 @@
+/**
+ * SHA-512 integrity utility.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { createHash } from "node:crypto";
+/** Compute SHA-512 integrity in `sha512-<base64>` SRI format. */
+export const computeIntegrity = (data) => Effect.sync(() => {
+    const base64 = createHash("sha512").update(data).digest("base64");
+    return `sha512-${base64}`;
+});
+//# sourceMappingURL=integrity.js.map

package/dist/src/unstable/utils/integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.js","sourceRoot":"","sources":["../../../../src/unstable/utils/integrity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,iEAAiE;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAgB,EAAyB,EAAE,CAC1E,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IACf,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClE,OAAO,UAAU,MAAM,EAAE,CAAC;AAC5B,CAAC,CAAC,CAAC"}

package/dist/src/unstable/utils/network.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true if the hostname represents a loopback address.
+ * Covers localhost, IPv4 loopback (127.0.0.1), and IPv6 loopback (::1).
+ */
+export declare const isLoopbackAddress: (hostname: string) => boolean;
+//# sourceMappingURL=network.d.ts.map

package/dist/src/unstable/utils/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/network.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,OACuB,CAAC"}

package/dist/src/unstable/utils/network.js

@@ -0,0 +1,6 @@
+/**
+ * Returns true if the hostname represents a loopback address.
+ * Covers localhost, IPv4 loopback (127.0.0.1), and IPv6 loopback (::1).
+ */
+export const isLoopbackAddress = (hostname) => hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1";
+//# sourceMappingURL=network.js.map

package/dist/src/unstable/utils/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../../src/unstable/utils/network.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAW,EAAE,CAC7D,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,KAAK,CAAC"}

package/dist/src/unstable/utils/path-safety.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Validates that a resolved target path stays within a base directory.
+ * Uses path separator boundary check to prevent prefix false positives.
+ */
+export declare function isPathSafe(base: string, target: string): boolean;
+//# sourceMappingURL=path-safety.d.ts.map

package/dist/src/unstable/utils/path-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-safety.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/path-safety.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAShE"}

package/dist/src/unstable/utils/path-safety.js

@@ -0,0 +1,16 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import * as Effect from "effect/Effect";
+import * as Path from "effect/Path";
+/**
+ * Validates that a resolved target path stays within a base directory.
+ * Uses path separator boundary check to prevent prefix false positives.
+ */
+export function isPathSafe(base, target) {
+    return Effect.runSync(Effect.gen(function* () {
+        const path = yield* Path.Path;
+        const resolvedBase = path.resolve(base);
+        const resolvedTarget = path.resolve(target);
+        return resolvedTarget === resolvedBase || resolvedTarget.startsWith(resolvedBase + path.sep);
+    }).pipe(Effect.provide(NodeServices.layer)));
+}
+//# sourceMappingURL=path-safety.js.map

package/dist/src/unstable/utils/path-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-safety.js","sourceRoot":"","sources":["../../../../src/unstable/utils/path-safety.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAc;IACrD,OAAO,MAAM,CAAC,OAAO,CACnB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,cAAc,KAAK,YAAY,IAAI,cAAc,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAC5C,CAAC;AACJ,CAAC"}

package/dist/src/unstable/utils/resolve-parent-symlinks.d.ts

@@ -0,0 +1,13 @@
+import type { PlatformError } from "effect/PlatformError";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+/**
+ * Resolves the parent directory of a path through symlinks while
+ * preserving the final path component (basename).
+ *
+ * Needed for computing correct relative symlink paths when parent
+ * directories may themselves be symlinks.
+ */
+export declare const resolveParentSymlinks: (filePath: string) => Effect.Effect<string, PlatformError, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=resolve-parent-symlinks.d.ts.map

package/dist/src/unstable/utils/resolve-parent-symlinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-parent-symlinks.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/resolve-parent-symlinks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAQrE,CAAC"}

package/dist/src/unstable/utils/resolve-parent-symlinks.js

@@ -0,0 +1,19 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+/**
+ * Resolves the parent directory of a path through symlinks while
+ * preserving the final path component (basename).
+ *
+ * Needed for computing correct relative symlink paths when parent
+ * directories may themselves be symlinks.
+ */
+export const resolveParentSymlinks = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const p = yield* Path.Path;
+    const parent = p.dirname(filePath);
+    const basename = p.basename(filePath);
+    const resolvedParent = yield* fs.realPath(parent);
+    return p.join(resolvedParent, basename);
+});
+//# sourceMappingURL=resolve-parent-symlinks.js.map

package/dist/src/unstable/utils/resolve-parent-symlinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-parent-symlinks.js","sourceRoot":"","sources":["../../../../src/unstable/utils/resolve-parent-symlinks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,QAAgB,EACyD,EAAE,CAC3E,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3B,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC"}

package/dist/src/unstable/version-constraints/version-constraints.d.ts

@@ -0,0 +1,61 @@
+import * as Schema from "effect/Schema";
+import * as Option from "effect/Option";
+/**
+ * Minimal version entry shape used for constraint resolution.
+ * Compatible with the full VersionEntry from the registry module.
+ */
+export interface VersionEntryLike {
+    readonly version: ExactSemverVersion;
+}
+/**
+ * Schema for exact semver versions (no ranges).
+ */
+export declare const ExactSemverVersionSchema: Schema.brand<Schema.String, "ExactSemverVersion">;
+/**
+ * Inferred type for exact semver versions.
+ */
+export type ExactSemverVersion = Schema.Schema.Type<typeof ExactSemverVersionSchema>;
+/**
+ * Schema for semver version constraints, including exact versions and ranges.
+ */
+export declare const VersionConstraintSchema: Schema.brand<Schema.String, "VersionConstraint">;
+/**
+ * Inferred type for semver version constraints.
+ */
+export type VersionConstraint = Schema.Schema.Type<typeof VersionConstraintSchema>;
+/**
+ * Decode a value as an exact semver version.
+ */
+export declare const decodeExactSemverVersionSync: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"ExactSemverVersion">;
+/**
+ * Decode a value as a semver constraint.
+ */
+export declare const decodeVersionConstraintSync: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"VersionConstraint">;
+/**
+ * Extract a version constraint suffix from a source string.
+ *
+ * Handles both namespaced (`@handle/name@^1.0.0`) and non-namespaced (`name@^1.0.0`) names.
+ * Returns `Option.none()` when no version suffix is present.
+ */
+export declare const parseVersionConstraint: (sourceString: string) => Option.Option<VersionConstraint>;
+/**
+ * Check whether a string is a valid semver range.
+ */
+export declare const isValidConstraint: (constraint: string) => boolean;
+/**
+ * Check whether moving from `previousVersion` to `currentVersion` includes at
+ * least a minor version bump.
+ */
+export declare const hasMinorOrMajorVersionBump: (previousVersion: string, currentVersion: string) => boolean;
+/**
+ * Check whether a version satisfies a semver constraint.
+ */
+export declare const satisfiesConstraint: (version: ExactSemverVersion, constraint: VersionConstraint) => boolean;
+/**
+ * Select the first version (newest-first) that satisfies the constraint.
+ *
+ * - `Option.none()` constraint or `"*"` matches any version.
+ * - Invalid constraints match nothing.
+ */
+export declare const resolveVersionWithConstraint: (versions: ReadonlyArray<VersionEntryLike>, constraint: Option.Option<string>) => Option.Option<VersionEntryLike>;
+//# sourceMappingURL=version-constraints.d.ts.map

package/dist/src/unstable/version-constraints/version-constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-constraints.d.ts","sourceRoot":"","sources":["../../../../src/unstable/version-constraints/version-constraints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,mDAepC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,uBAAuB,kDAenC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,4BAA4B,oIAAqD,CAAC;AAE/F;;GAEG;AACH,eAAO,MAAM,2BAA2B,mIAAoD,CAAC;AAI7F;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,cAAc,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAqB5F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,OACf,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GACrC,iBAAiB,MAAM,EACvB,gBAAgB,MAAM,KACrB,OAQF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,kBAAkB,EAC3B,YAAY,iBAAiB,KAC5B,OAAgD,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,aAAa,CAAC,gBAAgB,CAAC,EACzC,YAAY,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAChC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAmBhC,CAAC"}

package/dist/src/unstable/version-constraints/version-constraints.js

@@ -0,0 +1,112 @@
+import * as Schema from "effect/Schema";
+import * as Option from "effect/Option";
+import * as semver from "semver";
+/**
+ * Schema for exact semver versions (no ranges).
+ */
+export const ExactSemverVersionSchema = Schema.String.pipe(Schema.check(Schema.makeFilter((value) => {
+    const normalized = semver.valid(value);
+    return normalized === value ? undefined : `Expected exact semver version, got: ${value}`;
+})), Schema.annotate({
+    identifier: "ExactSemverVersion",
+    title: "Exact Semver Version",
+    description: "An exact version number like 1.0.0 (no ranges allowed).",
+    examples: ["1.0.0", "2.3.1", "0.1.0-beta.1"],
+    message: "Expected an exact semver version (e.g., 1.0.0)",
+}), Schema.brand("ExactSemverVersion"));
+/**
+ * Schema for semver version constraints, including exact versions and ranges.
+ */
+export const VersionConstraintSchema = Schema.String.pipe(Schema.check(Schema.makeFilter((value) => {
+    const normalized = semver.validRange(value);
+    return normalized !== null ? undefined : `Expected semver constraint, got: ${value}`;
+})), Schema.annotate({
+    identifier: "VersionConstraint",
+    title: "Version Constraint",
+    description: "A version requirement like ^1.0.0, ~2.3.0, or an exact version.",
+    examples: ["^1.0.0", "~2.3.0", ">=1.0.0 <3.0.0", "1.2.3"],
+    message: "Expected a valid semver constraint (e.g., ^1.0.0)",
+}), Schema.brand("VersionConstraint"));
+/**
+ * Decode a value as an exact semver version.
+ */
+export const decodeExactSemverVersionSync = Schema.decodeUnknownSync(ExactSemverVersionSchema);
+/**
+ * Decode a value as a semver constraint.
+ */
+export const decodeVersionConstraintSync = Schema.decodeUnknownSync(VersionConstraintSchema);
+const parseSemverVersion = (version) => semver.parse(version);
+/**
+ * Extract a version constraint suffix from a source string.
+ *
+ * Handles both namespaced (`@handle/name@^1.0.0`) and non-namespaced (`name@^1.0.0`) names.
+ * Returns `Option.none()` when no version suffix is present.
+ */
+export const parseVersionConstraint = (sourceString) => {
+    const decodeConstraint = (value) => {
+        try {
+            return Option.some(decodeVersionConstraintSync(value));
+        }
+        catch {
+            return Option.none();
+        }
+    };
+    // For namespaced packages (@handle/name@constraint), find the @ after the handle
+    if (sourceString.startsWith("@")) {
+        const slashIndex = sourceString.indexOf("/");
+        if (slashIndex === -1)
+            return Option.none();
+        const afterHandle = sourceString.indexOf("@", slashIndex + 1);
+        if (afterHandle === -1)
+            return Option.none();
+        return decodeConstraint(sourceString.slice(afterHandle + 1));
+    }
+    // For non-namespaced packages (name@constraint)
+    const atIndex = sourceString.indexOf("@");
+    if (atIndex === -1)
+        return Option.none();
+    return decodeConstraint(sourceString.slice(atIndex + 1));
+};
+/**
+ * Check whether a string is a valid semver range.
+ */
+export const isValidConstraint = (constraint) => semver.validRange(constraint) !== null;
+/**
+ * Check whether moving from `previousVersion` to `currentVersion` includes at
+ * least a minor version bump.
+ */
+export const hasMinorOrMajorVersionBump = (previousVersion, currentVersion) => {
+    const previous = parseSemverVersion(previousVersion);
+    const current = parseSemverVersion(currentVersion);
+    if (previous === null || current === null) {
+        return false;
+    }
+    return current.major > previous.major || current.minor > previous.minor;
+};
+/**
+ * Check whether a version satisfies a semver constraint.
+ */
+export const satisfiesConstraint = (version, constraint) => semver.satisfies(version, constraint);
+/**
+ * Select the first version (newest-first) that satisfies the constraint.
+ *
+ * - `Option.none()` constraint or `"*"` matches any version.
+ * - Invalid constraints match nothing.
+ */
+export const resolveVersionWithConstraint = (versions, constraint) => {
+    const constraintStr = Option.getOrElse(constraint, () => "*");
+    // Wildcard means no constraint filtering
+    const isWildcard = constraintStr === "*";
+    // Validate the constraint early
+    if (!isWildcard && !isValidConstraint(constraintStr)) {
+        return Option.none();
+    }
+    for (const version of versions) {
+        if (!isWildcard && !semver.satisfies(version.version, constraintStr)) {
+            continue;
+        }
+        return Option.some(version);
+    }
+    return Option.none();
+};
+//# sourceMappingURL=version-constraints.js.map

package/dist/src/unstable/version-constraints/version-constraints.js.map

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

package/dist/src/unstable/version-resolution/version-resolution.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Version resolution logic for CLI self-upgrade.
+ *
+ * Fetches the latest CLI version from GitHub Releases, strips the `cli-v`
+ * prefix, and compares it against the local version using semver.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+/** Default GitHub repository for CLI releases. */
+export declare const DEFAULT_GITHUB_REPO = "agentxm/axm";
+/**
+ * Result of resolving the latest CLI version from GitHub Releases.
+ */
+export interface VersionResolutionResult {
+    /** The remote version string (semver, no prefix). */
+    readonly remoteVersion: string;
+    /** The local version string that was compared against. */
+    readonly localVersion: string;
+    /** Whether the local version is older than the remote version. */
+    readonly isStale: boolean;
+}
+/**
+ * Resolve the latest CLI version from GitHub Releases and compare it against
+ * the local version.
+ *
+ * @param httpClient - HTTP client for GitHub API requests
+ * @param localVersion - current CLI version (e.g. from `__AXM_VERSION__` or `package.json`)
+ * @param repo - GitHub `owner/repo` (defaults to `agentxm/axm`; callers may
+ *   read `AXM_INSTALL_GITHUB_REPO` from `Config` at the boundary)
+ */
+export declare const resolveLatestVersion: (httpClient: HttpClient.HttpClient, localVersion: string, repo?: string) => Effect.Effect<{
+    remoteVersion: string;
+    localVersion: string;
+    isStale: boolean;
+}, import("../app-error/app-error.ts").AppError, never>;
+//# sourceMappingURL=version-resolution.d.ts.map

package/dist/src/unstable/version-resolution/version-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-resolution.d.ts","sourceRoot":"","sources":["../../../../src/unstable/version-resolution/version-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,UAAU,MAAM,iCAAiC,CAAC;AAW9D,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAMjD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AA6JD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,UAAU,CAAC,UAAU,EACjC,cAAc,MAAM,EACpB,OAAM,MAA4B;;;;uDAMhC,CAAC"}