@agentxm/client-core 0.1.6

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

@@ -0,0 +1,81 @@
+/**
+ * Shared extension utilities.
+ *
+ * Cross-cutting utilities used by multiple extension types.
+ * Promoted from skills-specific modules to avoid cross-feature dependencies.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+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 { isPathSafe } from "../utils/index.js";
+// -----------------------------------------------------------------------------
+// Name Sanitization
+// -----------------------------------------------------------------------------
+/**
+ * Sanitizes an extension name into a safe on-disk directory name.
+ *
+ * Transformation pipeline:
+ * 1. Convert to lowercase
+ * 2. Replace non-alphanumeric characters (except `.` and `_`) with hyphens
+ * 3. Strip leading and trailing dots and hyphens
+ * 4. Truncate to 255 characters
+ * 5. Fall back to `"unnamed-skill"` if empty
+ */
+export const sanitizeName = (name) => {
+    let result = name
+        .toLowerCase()
+        .replace(/[^a-z0-9._]+/g, "-")
+        .replace(/^[.-]+/, "")
+        .replace(/[.-]+$/, "");
+    result = result.slice(0, 255);
+    return result || "unnamed-skill";
+};
+// -----------------------------------------------------------------------------
+// Path Safety Validation
+// -----------------------------------------------------------------------------
+export const validatePathSafety = (baseDir, targetPath, code) => isPathSafe(baseDir, targetPath)
+    ? Effect.void
+    : makeAppError({
+        code,
+        what: `Path traversal detected: ${targetPath}`,
+    });
+// -----------------------------------------------------------------------------
+// Extension Directory Copy
+// -----------------------------------------------------------------------------
+const EXCLUDED_NAMES = new Set(["README.md", "metadata.json", ".git"]);
+const isExcluded = (name) => EXCLUDED_NAMES.has(name) || name.startsWith("_");
+const copyEntry = (src, dest, fs, path) => Effect.gen(function* () {
+    // Read through symlinks (stat follows symlinks by default)
+    const info = yield* fs.stat(src);
+    if (info.type === "Directory") {
+        yield* copyDir(src, dest, fs, path);
+    }
+    else {
+        // Copy file content — readFile follows symlinks, giving us dereferenced content
+        const content = yield* fs.readFile(src);
+        yield* fs.makeDirectory(path.dirname(dest), { recursive: true });
+        yield* fs.writeFile(dest, content);
+    }
+});
+const copyDir = (src, dest, fs, path) => Effect.gen(function* () {
+    yield* fs.makeDirectory(dest, { recursive: true });
+    const entries = yield* fs.readDirectory(src);
+    yield* Effect.forEach(entries.filter((name) => !isExcluded(name)), (name) => copyEntry(path.join(src, name), path.join(dest, name), fs, path), { concurrency: "unbounded" });
+});
+/**
+ * Recursively copies an extension directory from `src` to `dest`.
+ *
+ * Exclusions: README.md, metadata.json, `_`-prefixed entries, `.git`.
+ * Symlinks are dereferenced (file content is copied, not the link).
+ * Directory entries are copied concurrently.
+ */
+export const copyExtensionDirectory = (src, dest) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    yield* copyDir(src, dest, fs, path);
+});
+//# sourceMappingURL=utils.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Git operations module.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { getTreeSha, shallowClone } from "./operations.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/git/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Git operations module.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { getTreeSha, shallowClone } from "./operations.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/git/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/unstable/git/operations.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Git operations for cloning repositories at specific refs.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import { type AppError } from "../app-error/index.js";
+/**
+ * Shallow clone a git repository (depth 1, single branch).
+ * Significantly faster than a full clone for read-only use cases like skill discovery.
+ *
+ * @param url - Repository URL (HTTPS or SSH)
+ * @param destination - Local path to clone to
+ * @param ref - Optional git ref (branch or tag) to clone
+ * @returns Effect that resolves on success or fails with GitError
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const shallowClone: (url: string, destination: string, ref?: string) => Effect.Effect<string, AppError, never>;
+/**
+ * Get the git tree SHA for a path within a repository.
+ *
+ * The tree SHA is a hash of the directory's contents at the current commit.
+ * Unlike commit SHA, it is stable across rebases that don't change content.
+ *
+ * @param repoPath - Path to the git repository root
+ * @param subPath - Optional subpath within the repository (defaults to root ".")
+ * @returns Effect that resolves to the tree SHA, or fails if path is not in a git repo
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const getTreeSha: (repoPath: string, subPath?: string) => Effect.Effect<string, AppError, never>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/src/unstable/git/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../../src/unstable/git/operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AAiDpE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,aAAa,MAAM,EAAE,MAAM,MAAM,2CAU7B,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,EAAE,gBAAa,2CA2Bd,CAAC"}

package/dist/src/unstable/git/operations.js

@@ -0,0 +1,102 @@
+/**
+ * Git operations for cloning repositories at specific refs.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { simpleGit } from "simple-git";
+import { makeAppError } from "../app-error/index.js";
+// -----------------------------------------------------------------------------
+// Internal Helpers
+// -----------------------------------------------------------------------------
+/**
+ * Creates a simple-git instance with options that allow SSH passphrase prompts.
+ * Using 'inherit' for stdio enables interactive authentication.
+ */
+const createGit = (baseDir) => {
+    const options = {
+        baseDir: baseDir ?? process.cwd(),
+        binary: "git",
+        maxConcurrentProcesses: 1,
+        config: [],
+    };
+    return simpleGit(options);
+};
+const operationToCode = {
+    clone: "GIT_CLONE_FAILED",
+    "get-tree-sha": "GIT_GET_TREE_SHA_FAILED",
+};
+/**
+ * Maps unknown errors to AppError with appropriate context.
+ */
+const mapGitError = (operation, context) => (error) => {
+    const baseMessage = context ?? `Git ${operation} failed`;
+    const details = error instanceof Error ? [error.message] : [String(error)];
+    return makeAppError({
+        code: operationToCode[operation],
+        what: baseMessage,
+        details,
+        cause: error,
+    });
+};
+// -----------------------------------------------------------------------------
+// Git Operations
+// -----------------------------------------------------------------------------
+/**
+ * Shallow clone a git repository (depth 1, single branch).
+ * Significantly faster than a full clone for read-only use cases like skill discovery.
+ *
+ * @param url - Repository URL (HTTPS or SSH)
+ * @param destination - Local path to clone to
+ * @param ref - Optional git ref (branch or tag) to clone
+ * @returns Effect that resolves on success or fails with GitError
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const shallowClone = (url, destination, ref) => Effect.tryPromise({
+    try: () => createGit().clone(url, destination, [
+        "--depth",
+        "1",
+        "--single-branch",
+        ...(ref ? ["--branch", ref] : []),
+    ]),
+    catch: mapGitError("clone", `Failed to shallow clone ${url}`),
+}).pipe(Effect.withSpan("Git.shallowClone"));
+/**
+ * Get the git tree SHA for a path within a repository.
+ *
+ * The tree SHA is a hash of the directory's contents at the current commit.
+ * Unlike commit SHA, it is stable across rebases that don't change content.
+ *
+ * @param repoPath - Path to the git repository root
+ * @param subPath - Optional subpath within the repository (defaults to root ".")
+ * @returns Effect that resolves to the tree SHA, or fails if path is not in a git repo
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const getTreeSha = (repoPath, subPath = ".") => Effect.tryPromise({
+    try: async () => {
+        const git = createGit(repoPath);
+        // For root directory, use rev-parse HEAD^{tree}
+        if (subPath === "." || subPath === "") {
+            const result = await git.revparse(["HEAD^{tree}"]);
+            return result.trim();
+        }
+        // For subdirectories, use ls-tree to get the tree object SHA
+        // ls-tree returns: <mode> <type> <sha>\t<path>
+        const result = await git.raw(["ls-tree", "HEAD", subPath]);
+        const trimmed = result.trim();
+        if (!trimmed) {
+            throw new Error(`Path '${subPath}' not found in repository`);
+        }
+        // Parse the output: "040000 tree <sha>\t<path>" or "100644 blob <sha>\t<path>"
+        const parts = trimmed.split(/\s+/);
+        const sha = Option.getOrThrowWith(Array.get(parts, 2), () => new Error(`Unexpected ls-tree output: ${trimmed}`));
+        return sha;
+    },
+    catch: mapGitError("get-tree-sha", `Failed to get tree SHA for '${subPath}'`),
+}).pipe(Effect.withSpan("Git.getTreeSha"));
+//# sourceMappingURL=operations.js.map

package/dist/src/unstable/git/operations.js.map

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

package/dist/src/unstable/install-meta/install-meta.d.ts

@@ -0,0 +1,80 @@
+/**
+ * InstallMeta service — reads and writes `install-meta.json`.
+ *
+ * The metadata file lives at `~/.axm/install-meta.json` (Unix)
+ * or `%LOCALAPPDATA%\axm\install-meta.json` (Windows).
+ *
+ * @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 Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import * as ServiceMap from "effect/ServiceMap";
+/**
+ * Schema for `install-meta.json`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const InstallMetaDataSchema: Schema.Struct<{
+    readonly method: Schema.Literals<readonly ["script", "homebrew", "npm"]>;
+    readonly installedAt: Schema.String;
+}>;
+/**
+ * Type of the decoded `install-meta.json` data.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type InstallMetaData = typeof InstallMetaDataSchema.Type;
+export interface InstallMetaService {
+    /** Read `install-meta.json`. Returns `None` if file is missing or invalid. */
+    readonly read: () => Effect.Effect<Option.Option<InstallMetaData>>;
+    /** Write `install-meta.json` with the given method and timestamp. */
+    readonly write: (data: InstallMetaData) => Effect.Effect<void>;
+}
+declare const InstallMeta_base: ServiceMap.ServiceClass<InstallMeta, "@agentxm/client-core/InstallMeta", InstallMetaService>;
+/**
+ * Effect service tag for install metadata I/O.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class InstallMeta extends InstallMeta_base {
+}
+/**
+ * Read `install-meta.json` from the given directory.
+ * Returns `Option.none()` if the file is missing or contains invalid data.
+ *
+ * Exposed for testability.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const readInstallMeta: (dataDir: string) => Effect.Effect<Option.Option<{
+    readonly installedAt: string;
+    readonly method: "npm" | "script" | "homebrew";
+}>, never, FileSystem.FileSystem | Path.Path>;
+/**
+ * Write `install-meta.json` to the given directory.
+ * Creates the directory if it does not exist.
+ *
+ * Exposed for testability.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const writeInstallMeta: (dataDir: string, data: InstallMetaData) => Effect.Effect<void, never, FileSystem.FileSystem | Path.Path>;
+/**
+ * Live layer providing the `InstallMeta` service.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const InstallMetaLive: Layer.Layer<InstallMeta, never, FileSystem.FileSystem | Path.Path>;
+/**
+ * Create an `InstallMeta` layer for testing with a configurable data directory.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const InstallMetaTest: (dataDir: string) => Layer.Layer<InstallMeta, never, FileSystem.FileSystem | Path.Path>;
+export {};
+//# sourceMappingURL=install-meta.d.ts.map

package/dist/src/unstable/install-meta/install-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-meta.d.ts","sourceRoot":"","sources":["../../../../src/unstable/install-meta/install-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAShD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;EAWhC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAC;AAUhE,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;IACnE,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAChE;;AAED;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,gBAEhC;CAAG;AAkBJ;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM;;;6CAgB3C,CAAC;AAEL;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,MAAM,eAAe,kEAiBnE,CAAC;AAML;;;;GAIG;AACH,eAAO,MAAM,eAAe,oEAqB3B,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,uEAqB5C,CAAC"}

package/dist/src/unstable/install-meta/install-meta.js

@@ -0,0 +1,124 @@
+/**
+ * InstallMeta service — reads and writes `install-meta.json`.
+ *
+ * The metadata file lives at `~/.axm/install-meta.json` (Unix)
+ * or `%LOCALAPPDATA%\axm\install-meta.json` (Windows).
+ *
+ * @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 Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import * as ServiceMap from "effect/ServiceMap";
+import { InstallMethodLiteral } from "../install-method/install-method.js";
+import { resolveAxmDataDir } from "../utils/index.js";
+// -----------------------------------------------------------------------------
+// Schema
+// -----------------------------------------------------------------------------
+/**
+ * Schema for `install-meta.json`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const InstallMetaDataSchema = Schema.Struct({
+    method: InstallMethodLiteral.pipe(Schema.annotateKey({ messageMissingKey: "method is required" })),
+    installedAt: Schema.String.pipe(Schema.annotateKey({ messageMissingKey: "installedAt is required" })),
+}).annotate({
+    identifier: "InstallMetaData",
+    title: "Install Metadata",
+    description: "How and when axm was installed.",
+});
+const decodeInstallMetaDataFromJsonString = Schema.decodeUnknownEffect(Schema.fromJsonString(InstallMetaDataSchema));
+/**
+ * Effect service tag for install metadata I/O.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export class InstallMeta extends ServiceMap.Service()("@agentxm/client-core/InstallMeta") {
+}
+// -----------------------------------------------------------------------------
+// Data directory resolution
+// -----------------------------------------------------------------------------
+const resolveDataDir = (pathService) => resolveAxmDataDir(pathService.join);
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+const INSTALL_META_FILENAME = "install-meta.json";
+// -----------------------------------------------------------------------------
+// Core read/write logic
+// -----------------------------------------------------------------------------
+/**
+ * Read `install-meta.json` from the given directory.
+ * Returns `Option.none()` if the file is missing or contains invalid data.
+ *
+ * Exposed for testability.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const readInstallMeta = (dataDir) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const metaPath = path.join(dataDir, INSTALL_META_FILENAME);
+    const exists = yield* fs.exists(metaPath).pipe(Effect.catch(() => Effect.succeed(false)));
+    if (!exists)
+        return Option.none();
+    const content = yield* fs.readFileString(metaPath).pipe(Effect.option);
+    if (Option.isNone(content))
+        return Option.none();
+    const decoded = yield* decodeInstallMetaDataFromJsonString(content.value).pipe(Effect.option);
+    if (Option.isNone(decoded))
+        return Option.none();
+    return Option.some(decoded.value);
+});
+/**
+ * Write `install-meta.json` to the given directory.
+ * Creates the directory if it does not exist.
+ *
+ * Exposed for testability.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const writeInstallMeta = (dataDir, data) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const metaPath = path.join(dataDir, INSTALL_META_FILENAME);
+    yield* fs.makeDirectory(dataDir, { recursive: true }).pipe(Effect.tapError((e) => Effect.logWarning("Failed to write install metadata", { error: e })), Effect.catch(() => Effect.void));
+    const content = JSON.stringify({ method: data.method, installedAt: data.installedAt }, null, 2) + "\n";
+    yield* fs.writeFileString(metaPath, content).pipe(Effect.tapError((e) => Effect.logWarning("Failed to write install metadata", { error: e })), Effect.catch(() => Effect.void));
+});
+// -----------------------------------------------------------------------------
+// Live layer
+// -----------------------------------------------------------------------------
+/**
+ * Live layer providing the `InstallMeta` service.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const InstallMetaLive = Layer.effect(InstallMeta, Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const pathService = yield* Path.Path;
+    const dataDir = yield* resolveDataDir(pathService);
+    const read = () => readInstallMeta(dataDir).pipe(Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(Path.Path, pathService));
+    const write = (data) => writeInstallMeta(dataDir, data).pipe(Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(Path.Path, pathService));
+    return { read, write };
+}));
+// -----------------------------------------------------------------------------
+// Test layer factory
+// -----------------------------------------------------------------------------
+/**
+ * Create an `InstallMeta` layer for testing with a configurable data directory.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const InstallMetaTest = (dataDir) => Layer.effect(InstallMeta, Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const pathService = yield* Path.Path;
+    const read = () => readInstallMeta(dataDir).pipe(Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(Path.Path, pathService));
+    const write = (data) => writeInstallMeta(dataDir, data).pipe(Effect.provideService(FileSystem.FileSystem, fs), Effect.provideService(Path.Path, pathService));
+    return { read, write };
+}));
+//# sourceMappingURL=install-meta.js.map

package/dist/src/unstable/install-meta/install-meta.js.map

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

package/dist/src/unstable/install-method/install-method.d.ts

@@ -0,0 +1,84 @@
+/**
+ * InstallMethod service — detects how axm was installed.
+ *
+ * Provides a `detect()` method returning a tagged union (`Script | Homebrew | Npm | Unknown`)
+ * using a precedence chain of runtime signals.
+ *
+ * @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 Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import * as ServiceMap from "effect/ServiceMap";
+declare const Script_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Readonly<A> & {
+    readonly _tag: "Script";
+} & import("effect/Pipeable").Pipeable;
+/** Installed via the install script (~/.axm/bin/ or %LOCALAPPDATA%\axm\). */
+export declare class Script extends Script_base<{
+    readonly execPath: string;
+}> {
+}
+declare const Homebrew_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Readonly<A> & {
+    readonly _tag: "Homebrew";
+} & import("effect/Pipeable").Pipeable;
+/** Installed via Homebrew (/Cellar/ in realpath of execPath). */
+export declare class Homebrew extends Homebrew_base<{
+    readonly execPath: string;
+}> {
+}
+declare const Npm_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Readonly<A> & {
+    readonly _tag: "Npm";
+} & import("effect/Pipeable").Pipeable;
+/** Installed via npm/pnpm/yarn (node_modules in import URL). */
+export declare class Npm extends Npm_base<{
+    readonly importUrl: string;
+}> {
+}
+declare const Unknown_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Readonly<A> & {
+    readonly _tag: "Unknown";
+} & import("effect/Pipeable").Pipeable;
+/** Install method could not be determined. */
+export declare class Unknown extends Unknown_base<{}> {
+}
+/** Tagged union of all known install methods. */
+export type InstallMethodType = Script | Homebrew | Npm | Unknown;
+/** Literal schema for valid install method names. */
+export declare const InstallMethodLiteral: Schema.Literals<readonly ["script", "homebrew", "npm"]>;
+export interface InstallMethodService {
+    readonly detect: () => Effect.Effect<InstallMethodType>;
+}
+declare const InstallMethod_base: ServiceMap.ServiceClass<InstallMethod, "@agentxm/client-core/InstallMethod", InstallMethodService>;
+/**
+ * Effect service tag for install method detection.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class InstallMethod extends InstallMethod_base {
+}
+/**
+ * Runtime inputs that the detection logic needs.
+ * Abstracted for testability — production uses real values, tests inject fakes.
+ */
+export interface InstallMethodInputs {
+    readonly execPath: string;
+    readonly importMetaUrl: string;
+    readonly homeDir: string;
+    readonly platform: string;
+    readonly localAppData: Option.Option<string>;
+}
+/**
+ * Detect install method from the given inputs.
+ * Exposed for testability — the live layer calls this with real values.
+ */
+export declare const detectFromInputs: (inputs: InstallMethodInputs) => Effect.Effect<InstallMethodType, never, FileSystem.FileSystem | Path.Path>;
+export declare const InstallMethodLive: Layer.Layer<InstallMethod, never, FileSystem.FileSystem | Path.Path>;
+/**
+ * Create an InstallMethod layer for testing with configurable inputs.
+ */
+export declare const InstallMethodTest: (inputs: InstallMethodInputs) => Layer.Layer<InstallMethod, never, FileSystem.FileSystem | Path.Path>;
+export {};
+//# sourceMappingURL=install-method.d.ts.map

package/dist/src/unstable/install-method/install-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-method.d.ts","sourceRoot":"","sources":["../../../../src/unstable/install-method/install-method.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;;;;AAQhD,6EAA6E;AAC7E,qBAAa,MAAO,SAAQ,YAA2B;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;CAAG;;;;AAEL,iEAAiE;AACjE,qBAAa,QAAS,SAAQ,cAA6B;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;CAAG;;;;AAEL,gEAAgE;AAChE,qBAAa,GAAI,SAAQ,SAAwB;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;CAAG;;;;AAEL,8CAA8C;AAE9C,qBAAa,OAAQ,SAAQ,aAA4B,EAAE,CAAC;CAAG;AAE/D,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,GAAG,GAAG,OAAO,CAAC;AAMlE,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,yDAQ/B,CAAC;AAoBH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;CACzD;;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,kBAElC;CAAG;AAMJ;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CAC9C;AAyDD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,mBAAmB,+EAmCxD,CAAC;AAoBL,eAAO,MAAM,iBAAiB,sEAkC7B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,mBAAmB,yEAe1D,CAAC"}