agent-config-detect 0.0.0

package/dist/dts/platform/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Platform-specific path resolution.
+ *
+ * This module provides the Platform service for resolving base configuration
+ * directories on each supported platform (macOS, Linux, Windows).
+ *
+ * @module
+ */
+import { Layer } from "effect";
+import { Platform } from "./Platform.js";
+export { withEnv, withoutEnv } from "./internal/testUtils.js";
+export { type OS, Platform, type PlatformService } from "./Platform.js";
+export { TestPlatform, TestPlatformDarwin, TestPlatformLinux, TestPlatformWindows } from "./TestPlatform.js";
+/**
+ * Live platform layer that uses the actual system paths.
+ *
+ * Uses runtime platform detection to select the appropriate implementation.
+ */
+export declare const PlatformLive: Layer.Layer<Platform>;
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/platform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAM9B,OAAO,EAAW,QAAQ,EAAwB,MAAM,eAAe,CAAA;AAGvE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AA+C5G;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAA+C,CAAA"}

package/dist/dts/platform/internal/common.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Common platform utilities.
+ *
+ * @module
+ */
+import { Effect } from "effect";
+import { NotFoundError } from "../../errors.js";
+/**
+ * Returns the user's home directory.
+ */
+export declare const homeDir: Effect.Effect<string, NotFoundError, never>;
+/**
+ * Joins path segments.
+ */
+export declare const joinPath: (...segments: Array<string>) => string;
+/**
+ * Checks if a path is absolute.
+ */
+export declare const isAbsolute: (p: string) => boolean;
+//# sourceMappingURL=common.d.ts.map

package/dist/dts/platform/internal/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/platform/internal/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,OAAO,6CAMG,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,GAAG,UAAU,KAAK,CAAC,MAAM,CAAC,KAAG,MAAgC,CAAA;AAEtF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,KAAG,OAA6B,CAAA"}

package/dist/dts/platform/internal/darwin.d.ts

@@ -0,0 +1,33 @@
+/**
+ * macOS-specific path resolution.
+ *
+ * @module
+ */
+import { Effect } from "effect";
+import type { PlatformError } from "../../errors.js";
+/**
+ * Returns the user's config directory on macOS.
+ *
+ * Most CLI tools use `~/.config/` following XDG conventions,
+ * though native macOS apps prefer `~/Library/Application Support/`.
+ */
+export declare const configDir: Effect.Effect<string, PlatformError>;
+/**
+ * Returns the user's data directory on macOS.
+ *
+ * Returns `~/Library/Application Support/` for native macOS conventions.
+ */
+export declare const dataDir: Effect.Effect<string, PlatformError>;
+/**
+ * Returns the Application Support directory on macOS.
+ *
+ * This is `~/Library/Application Support/`, used by native macOS applications.
+ */
+export declare const applicationSupportDir: Effect.Effect<string, PlatformError>;
+/**
+ * Returns the cache directory on macOS.
+ *
+ * On macOS, we use the data directory as there's no standard XDG cache.
+ */
+export declare const cacheDir: Effect.Effect<string, PlatformError>;
+//# sourceMappingURL=darwin.d.ts.map

package/dist/dts/platform/internal/darwin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"darwin.d.ts","sourceRoot":"","sources":["../../../../src/platform/internal/darwin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAGpD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAG1D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAGxD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAW,CAAA;AAElF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAW,CAAA"}

package/dist/dts/platform/internal/linux.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Linux-specific path resolution with XDG Base Directory support.
+ *
+ * @module
+ */
+import { Effect } from "effect";
+import type { PlatformError } from "../../errors.js";
+/**
+ * Returns the user's config directory on Linux.
+ *
+ * Respects `XDG_CONFIG_HOME` if set to an absolute path,
+ * otherwise defaults to `~/.config/`.
+ */
+export declare const configDir: Effect.Effect<string, PlatformError>;
+/**
+ * Returns the user's data directory on Linux.
+ *
+ * Respects `XDG_DATA_HOME` if set to an absolute path,
+ * otherwise defaults to `~/.local/share/`.
+ */
+export declare const dataDir: Effect.Effect<string, PlatformError>;
+/**
+ * Returns the user's cache directory on Linux.
+ *
+ * Respects `XDG_CACHE_HOME` if set to an absolute path,
+ * otherwise defaults to `~/.cache/`.
+ */
+export declare const cacheDir: Effect.Effect<string, PlatformError>;
+//# sourceMappingURL=linux.d.ts.map

package/dist/dts/platform/internal/linux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux.d.ts","sourceRoot":"","sources":["../../../../src/platform/internal/linux.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAmBpD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAMzD,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAMvD,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAMxD,CAAA"}

package/dist/dts/platform/internal/testUtils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Test utilities for platform testing.
+ *
+ * @module
+ */
+import { Effect } from "effect";
+/**
+ * Runs an effect with mocked environment variables.
+ *
+ * The original environment is restored after the effect completes,
+ * regardless of success or failure.
+ *
+ * @example
+ * ```ts
+ * const result = await Effect.runPromise(
+ *   withEnv({ XDG_CONFIG_HOME: "/custom/config" }, myEffect)
+ * )
+ * ```
+ */
+export declare const withEnv: <A, E, R>(vars: Record<string, string | undefined>, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/**
+ * Removes environment variables for the duration of an effect.
+ *
+ * @example
+ * ```ts
+ * const result = await Effect.runPromise(
+ *   withoutEnv(["XDG_CONFIG_HOME", "XDG_DATA_HOME"], myEffect)
+ * )
+ * ```
+ */
+export declare const withoutEnv: <A, E, R>(keys: ReadonlyArray<string>, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+//# sourceMappingURL=testUtils.d.ts.map

package/dist/dts/platform/internal/testUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.d.ts","sourceRoot":"","sources":["../../../../src/platform/internal/testUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAU/B;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAC7B,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACxC,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CA6BvB,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAChC,MAAM,aAAa,CAAC,MAAM,CAAC,EAC3B,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAMvB,CAAA"}

package/dist/dts/platform/internal/windows.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Windows-specific path resolution.
+ *
+ * @module
+ */
+import { Effect } from "effect";
+import { type PlatformError } from "../../errors.js";
+/**
+ * Returns the user's config directory on Windows.
+ *
+ * Returns `%APPDATA%` which is typically `C:\Users\<user>\AppData\Roaming`.
+ */
+export declare const configDir: Effect.Effect<string, PlatformError>;
+/**
+ * Returns the user's data directory on Windows.
+ *
+ * Returns `%LOCALAPPDATA%` which is typically `C:\Users\<user>\AppData\Local`.
+ */
+export declare const dataDir: Effect.Effect<string, PlatformError>;
+/**
+ * Returns the roaming app data directory on Windows.
+ *
+ * This is `%APPDATA%`, used for settings that should roam with the user.
+ */
+export declare const roamingAppDataDir: Effect.Effect<string, PlatformError>;
+/**
+ * Returns the local app data directory on Windows.
+ *
+ * This is `%LOCALAPPDATA%`, used for data that should stay on the local machine.
+ */
+export declare const localAppDataDir: Effect.Effect<string, PlatformError>;
+/**
+ * Returns the cache directory on Windows.
+ *
+ * On Windows, we use the local app data directory.
+ */
+export declare const cacheDir: Effect.Effect<string, PlatformError>;
+//# sourceMappingURL=windows.d.ts.map

package/dist/dts/platform/internal/windows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../../../../src/platform/internal/windows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAQzD,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAQvD,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAa,CAAA;AAEhF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAW,CAAA;AAE5E;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAW,CAAA"}

package/dist/dts/types/ConfigResource.d.ts

@@ -0,0 +1,34 @@
+/**
+ * A configuration file resource location.
+ *
+ * Represents a single configuration file that may contain
+ * multiple configuration entries, accessed via a key path.
+ *
+ * @module
+ */
+import { Schema } from "effect";
+import { type FileFormat as FileFormatType } from "./FileFormat.js";
+/**
+ * Config resource schema.
+ */
+export declare const ConfigResource: Schema.Struct<{
+    /** Path to the configuration file. */
+    file: typeof Schema.String;
+    /** Whether the file currently exists on the filesystem. */
+    fileExists: typeof Schema.Boolean;
+    /** JSON pointer path to the relevant section (e.g., `"/mcpServers"`). */
+    keyPath: typeof Schema.String;
+    /** Format of the configuration file. */
+    format: Schema.Literal<["Json", "Jsonc", "Yaml", "Markdown", "MarkdownWithFrontmatter"]>;
+    /** Optional JSON Schema URL for validation. */
+    schemaUrl: Schema.OptionFromNullOr<typeof Schema.String>;
+}>;
+/**
+ * Config resource type.
+ */
+export type ConfigResource = typeof ConfigResource.Type;
+/**
+ * Creates a config resource.
+ */
+export declare const makeConfigResource: (file: string, fileExists: boolean, keyPath: string, format: FileFormatType, schemaUrl?: string) => ConfigResource;
+//# sourceMappingURL=ConfigResource.d.ts.map

package/dist/dts/types/ConfigResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigResource.d.ts","sourceRoot":"","sources":["../../../src/types/ConfigResource.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAc,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE/E;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB,sCAAsC;;IAEtC,2DAA2D;;IAE3D,yEAAyE;;IAEzE,wCAAwC;;IAExC,+CAA+C;;EAE/C,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,MAAM,EACZ,YAAY,OAAO,EACnB,SAAS,MAAM,EACf,QAAQ,cAAc,EACtB,YAAY,MAAM,KACjB,cAMD,CAAA"}

package/dist/dts/types/DirectoryResource.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A directory-based resource location.
+ *
+ * Represents a directory that contains multiple resource files,
+ * such as commands or skills directories.
+ *
+ * @module
+ */
+import { Schema } from "effect";
+import { DirectoryStructure, type DirectoryStructure as DirectoryStructureType } from "./DirectoryStructure.js";
+import { type FileFormat as FileFormatType } from "./FileFormat.js";
+/**
+ * Directory resource schema.
+ */
+export declare const DirectoryResource: Schema.Struct<{
+    /** Path to the directory. */
+    path: typeof Schema.String;
+    /** Whether the directory currently exists on the filesystem. */
+    exists: typeof Schema.Boolean;
+    /** How resources are organized within the directory. */
+    structure: Schema.Schema<DirectoryStructure, DirectoryStructure, never>;
+    /** Format of files within the directory. */
+    fileFormat: Schema.Literal<["Json", "Jsonc", "Yaml", "Markdown", "MarkdownWithFrontmatter"]>;
+}>;
+/**
+ * Directory resource type.
+ */
+export type DirectoryResource = typeof DirectoryResource.Type;
+/**
+ * Creates a directory resource.
+ */
+export declare const makeDirectoryResource: (path: string, exists: boolean, structure: DirectoryStructureType, fileFormat: FileFormatType) => DirectoryResource;
+//# sourceMappingURL=DirectoryResource.d.ts.map

package/dist/dts/types/DirectoryResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectoryResource.d.ts","sourceRoot":"","sources":["../../../src/types/DirectoryResource.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAC/G,OAAO,EAAc,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE/E;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,6BAA6B;;IAE7B,gEAAgE;;IAEhE,wDAAwD;;IAExD,4CAA4C;;EAE5C,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAE7D;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,QAAQ,OAAO,EACf,WAAW,sBAAsB,EACjC,YAAY,cAAc,KACzB,iBAKD,CAAA"}

package/dist/dts/types/DirectoryStructure.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Directory layout structure for resource directories.
+ *
+ * Harnesses organize their resources in different ways:
+ * - Flat: Files directly in the directory (e.g., `commands/foo.md`)
+ * - Nested: Subdirectory per resource (e.g., `skills/foo/SKILL.md`)
+ *
+ * @module
+ */
+import { Schema } from "effect";
+declare const Flat_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => Readonly<A> & {
+    readonly _tag: "Flat";
+};
+/**
+ * Files directly in the directory.
+ *
+ * Example: `commands/foo.md`, `commands/bar.md`
+ */
+export declare class Flat extends Flat_base<{
+    /** Glob pattern for matching files (e.g., `"*.md"`). */
+    readonly filePattern: string;
+}> {
+}
+declare const Nested_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => Readonly<A> & {
+    readonly _tag: "Nested";
+};
+/**
+ * Subdirectory per resource with a fixed filename inside.
+ *
+ * Example: `skills/foo/SKILL.md`, `skills/bar/SKILL.md`
+ */
+export declare class Nested extends Nested_base<{
+    /** Pattern for subdirectory names (e.g., `"*"`). */
+    readonly subdirPattern: string;
+    /**
+     * Fixed filename or marker directory within each subdirectory.
+     *
+     * Can be a file (e.g., `"SKILL.md"`) or a marker directory
+     * (e.g., `".claude-plugin"` for plugin detection).
+     */
+    readonly fileName: string;
+}> {
+}
+/**
+ * Directory structure type - union of all variants.
+ */
+export type DirectoryStructure = Flat | Nested;
+/**
+ * Directory structure schema for serialization.
+ */
+export declare const DirectoryStructure: Schema.Schema<DirectoryStructure>;
+/**
+ * Creates a flat directory structure.
+ */
+export declare const flat: (filePattern: string) => DirectoryStructure;
+/**
+ * Creates a nested directory structure.
+ */
+export declare const nested: (subdirPattern: string, fileName: string) => DirectoryStructure;
+export {};
+//# sourceMappingURL=DirectoryStructure.d.ts.map

package/dist/dts/types/DirectoryStructure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectoryStructure.d.ts","sourceRoot":"","sources":["../../../src/types/DirectoryStructure.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAA;;;;AAErC;;;;GAIG;AACH,qBAAa,IAAK,SAAQ,UAAyB;IACjD,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,MAAO,SAAQ,YAA2B;IACrD,oDAAoD;IACpD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAC;CAAG;AAEL;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,MAAM,CAAA;AAE9C;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAM3B,CAAA;AAEtC;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,aAAa,MAAM,KAAG,kBAA+C,CAAA;AAE1F;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,eAAe,MAAM,EAAE,UAAU,MAAM,KAAG,kBACxB,CAAA"}

package/dist/dts/types/EnvValue.d.ts

@@ -0,0 +1,102 @@
+/**
+ * A value that may be a plain string or a reference to an environment variable.
+ *
+ * This type handles the different syntax each harness uses for environment
+ * variable references:
+ * - Claude Code: `${VAR}`
+ * - OpenCode: `{env:VAR}`
+ * - Goose: Uses `env_keys` array, values resolved at runtime
+ *
+ * @module
+ */
+import { Effect, Option, Schema } from "effect";
+import { MissingEnvVarError } from "../errors.js";
+import type { HarnessKind } from "./HarnessKind.js";
+declare const Plain_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => Readonly<A> & {
+    readonly _tag: "Plain";
+};
+/**
+ * A plain string value.
+ */
+export declare class Plain extends Plain_base<{
+    readonly value: string;
+}> {
+}
+declare const EnvRef_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => Readonly<A> & {
+    readonly _tag: "EnvRef";
+};
+/**
+ * A reference to an environment variable.
+ */
+export declare class EnvRef extends EnvRef_base<{
+    readonly env: string;
+}> {
+}
+/**
+ * EnvValue type - union of all variants.
+ */
+export type EnvValue = Plain | EnvRef;
+/**
+ * EnvValue schema for JSON serialization.
+ * Uses untagged representation:
+ * - Plain string: `"hello"` deserializes to `Plain("hello")`
+ * - Object with env key: `{"env": "VAR"}` deserializes to `EnvRef { env: "VAR" }`
+ */
+export declare const EnvValue: Schema.Schema<EnvValue, string | {
+    readonly env: string;
+}>;
+/**
+ * Creates a plain string value.
+ */
+export declare const plain: (value: string) => EnvValue;
+/**
+ * Creates an environment variable reference.
+ */
+export declare const env: (varName: string) => EnvValue;
+/**
+ * Returns `true` if this is a plain string value.
+ */
+export declare const isPlain: (value: EnvValue) => value is Plain;
+/**
+ * Returns `true` if this is an environment variable reference.
+ */
+export declare const isEnvRef: (value: EnvValue) => value is EnvRef;
+/**
+ * Converts to the harness-specific native string format.
+ *
+ * - For `Plain`: Returns the string as-is
+ * - For `EnvRef` with Claude Code/AmpCode/CopilotCli: Returns `${VAR}`
+ * - For `EnvRef` with OpenCode: Returns `{env:VAR}`
+ * - For `EnvRef` with Goose: Resolves the env var immediately (returns empty string if not set)
+ */
+export declare const toNative: (value: EnvValue, kind: HarnessKind) => string;
+/**
+ * Fallible version of `toNative` that returns an error when an environment
+ * variable reference cannot be resolved.
+ *
+ * For Goose harness, this validates that the referenced environment variable
+ * is actually set, returning an error if not.
+ *
+ * For other harnesses that use template syntax (Claude Code, OpenCode, AmpCode),
+ * this behaves identically to `toNative` since the variable is not resolved
+ * at conversion time.
+ */
+export declare const tryToNative: (value: EnvValue, kind: HarnessKind) => Effect.Effect<string, MissingEnvVarError>;
+/**
+ * Parses a harness-specific native string format into an `EnvValue`.
+ *
+ * - For Claude Code/AmpCode/CopilotCli: Parses `${VAR}` pattern
+ * - For OpenCode: Parses `{env:VAR}` pattern
+ * - For Goose: Always returns `Plain` (Goose doesn't use inline syntax)
+ * - If no pattern matches, returns `Plain`
+ */
+export declare const fromNative: (s: string, kind: HarnessKind) => EnvValue;
+/**
+ * Resolves the value, looking up environment variables if needed.
+ *
+ * - For `Plain`: Returns `Some(value)`
+ * - For `EnvRef`: Returns `Some(value)` if the env var is set, `None` otherwise
+ */
+export declare const resolve: (value: EnvValue) => Option.Option<string>;
+export {};
+//# sourceMappingURL=EnvValue.d.ts.map

package/dist/dts/types/EnvValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvValue.d.ts","sourceRoot":"","sources":["../../../src/types/EnvValue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAQ,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;;;;AAEnD;;GAEG;AACH,qBAAa,KAAM,SAAQ,WAA0B;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAC;CAAG;;;;AAEL;;GAEG;AACH,qBAAa,MAAO,SAAQ,YAA2B;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB,CAAC;CAAG;AAEL;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;AAErC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAmB/E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,KAAG,QAAgC,CAAA;AAEtE;;GAEG;AACH,eAAO,MAAM,GAAG,GAAI,SAAS,MAAM,KAAG,QAAwC,CAAA;AAE9E;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,QAAQ,KAAG,KAAK,IAAI,KAA+B,CAAA;AAElF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,QAAQ,KAAG,KAAK,IAAI,MAAiC,CAAA;AAErF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,QAAQ,EAAE,MAAM,WAAW,KAAG,MAe7D,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,QAAQ,EACf,MAAM,WAAW,KAChB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAoB1C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,EAAE,MAAM,WAAW,KAAG,QAwBzD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,QAAQ,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAM7D,CAAA"}

package/dist/dts/types/FileFormat.d.ts

@@ -0,0 +1,22 @@
+/**
+ * File formats used by harness configuration files.
+ *
+ * Different harnesses use different formats for their configuration,
+ * commands, and other resources.
+ *
+ * @module
+ */
+import { Schema } from "effect";
+/**
+ * File format schema.
+ */
+export declare const FileFormat: Schema.Literal<["Json", "Jsonc", "Yaml", "Markdown", "MarkdownWithFrontmatter"]>;
+/**
+ * File format type.
+ */
+export type FileFormat = typeof FileFormat.Type;
+/**
+ * All supported file formats.
+ */
+export declare const FileFormatAll: readonly ["Json", "Jsonc", "Yaml", "Markdown", "MarkdownWithFrontmatter"];
+//# sourceMappingURL=FileFormat.d.ts.map

package/dist/dts/types/FileFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileFormat.d.ts","sourceRoot":"","sources":["../../../src/types/FileFormat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;GAEG;AACH,eAAO,MAAM,UAAU,kFAMtB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,aAAa,2EAMoB,CAAA"}

package/dist/dts/types/HarnessKind.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Supported AI coding harnesses.
+ *
+ * This module provides the HarnessKind type representing the different
+ * AI coding assistants whose configuration paths can be discovered.
+ *
+ * @module
+ */
+import { Schema } from "effect";
+import type { ResourceKind } from "./ResourceKind.js";
+/**
+ * Harness kind schema - represents the different AI coding assistants.
+ */
+export declare const HarnessKind: Schema.Literal<["ClaudeCode", "OpenCode", "Goose", "AmpCode", "CopilotCli"]>;
+/**
+ * Harness kind type.
+ */
+export type HarnessKind = typeof HarnessKind.Type;
+/**
+ * All supported harness kinds.
+ */
+export declare const HarnessKindAll: readonly ["ClaudeCode", "OpenCode", "Goose", "AmpCode", "CopilotCli"];
+/**
+ * Returns the display name of this harness kind.
+ */
+export declare const asStr: (kind: HarnessKind) => string;
+/**
+ * Returns the known CLI binary names for this harness.
+ *
+ * These are the executable names that indicate the harness is installed
+ * and available in PATH.
+ */
+export declare const binaryNames: (kind: HarnessKind) => ReadonlyArray<string>;
+/**
+ * Returns the expected directory name(s) for a resource kind.
+ *
+ * Different harnesses use different naming conventions:
+ * - OpenCode uses singular names (`skill`, `command`)
+ * - Other harnesses use plural names (`skills`, `commands`)
+ *
+ * Returns `undefined` if the harness doesn't support that resource type.
+ * When multiple names are returned, index 0 is the canonical name.
+ */
+export declare const directoryNames: (kind: HarnessKind, resource: ResourceKind) => ReadonlyArray<string> | undefined;
+//# sourceMappingURL=HarnessKind.d.ts.map

package/dist/dts/types/HarnessKind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HarnessKind.d.ts","sourceRoot":"","sources":["../../../src/types/HarnessKind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;GAEG;AACH,eAAO,MAAM,WAAW,8EAMvB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,cAAc,uEAMoB,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,WAAW,KAAG,MAazC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,WAAW,KAAG,aAAa,CAAC,MAAM,CAanE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,WAAW,EACjB,UAAU,YAAY,KACrB,aAAa,CAAC,MAAM,CAAC,GAAG,SA2D1B,CAAA"}

package/dist/dts/types/InstallationStatus.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Installation status of a harness on the current system.
+ *
+ * Represents the different states a harness can be in, from not installed
+ * to fully configured with both binary and configuration present.
+ *
+ * @module
+ */
+import { Option, Schema } from "effect";
+declare const NotInstalled_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => Readonly<A> & {
+    readonly _tag: "NotInstalled";
+};
+/**
+ * Harness is not installed (no binary or config found).
+ */
+export declare class NotInstalled extends NotInstalled_base<{}> {
+}
+declare const ConfigOnly_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => Readonly<A> & {
+    readonly _tag: "ConfigOnly";
+};
+/**
+ * Only configuration directory exists (no binary in PATH).
+ */
+export declare class ConfigOnly extends ConfigOnly_base<{
+    readonly configPath: string;
+}> {
+}
+declare const BinaryOnly_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => Readonly<A> & {
+    readonly _tag: "BinaryOnly";
+};
+/**
+ * Only the binary exists in PATH (no configuration found).
+ */
+export declare class BinaryOnly extends BinaryOnly_base<{
+    readonly binaryPath: string;
+}> {
+}
+declare const FullyInstalled_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => Readonly<A> & {
+    readonly _tag: "FullyInstalled";
+};
+/**
+ * Fully installed with both binary and configuration.
+ */
+export declare class FullyInstalled extends FullyInstalled_base<{
+    readonly binaryPath: string;
+    readonly configPath: string;
+}> {
+}
+/**
+ * Installation status type - union of all status variants.
+ */
+export type InstallationStatus = NotInstalled | ConfigOnly | BinaryOnly | FullyInstalled;
+/**
+ * Installation status schema for serialization.
+ */
+export declare const InstallationStatus: Schema.Schema<InstallationStatus>;
+/**
+ * Returns `true` if the harness CLI can be invoked.
+ *
+ * A harness is runnable if its binary is available in PATH,
+ * regardless of whether configuration exists.
+ */
+export declare const isRunnable: (status: InstallationStatus) => boolean;
+/**
+ * Returns the binary path if available.
+ */
+export declare const binaryPath: (status: InstallationStatus) => Option.Option<string>;
+/**
+ * Returns the config path if available.
+ */
+export declare const configPath: (status: InstallationStatus) => Option.Option<string>;
+/**
+ * Creates a NotInstalled status.
+ */
+export declare const notInstalled: () => InstallationStatus;
+/**
+ * Creates a ConfigOnly status.
+ */
+export declare const configOnly: (configPath: string) => InstallationStatus;
+/**
+ * Creates a BinaryOnly status.
+ */
+export declare const binaryOnly: (binaryPath: string) => InstallationStatus;
+/**
+ * Creates a FullyInstalled status.
+ */
+export declare const fullyInstalled: (binaryPath: string, configPath: string) => InstallationStatus;
+export {};
+//# sourceMappingURL=InstallationStatus.d.ts.map

package/dist/dts/types/InstallationStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstallationStatus.d.ts","sourceRoot":"","sources":["../../../src/types/InstallationStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAQ,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;;;;AAE7C;;GAEG;AACH,qBAAa,YAAa,SAAQ,kBAAiC,EAAE,CAAC;CAAG;;;;AAEzE;;GAEG;AACH,qBAAa,UAAW,SAAQ,gBAA+B;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,CAAC;CAAG;;;;AAEL;;GAEG;AACH,qBAAa,UAAW,SAAQ,gBAA+B;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,CAAC;CAAG;;;;AAEL;;GAEG;AACH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,CAAC;CAAG;AAEL;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,CAAA;AAExF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAQ3B,CAAA;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,kBAAkB,KAAG,OAQvD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,kBAAkB,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAS3E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,kBAAkB,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAS3E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,kBAAwC,CAAA;AAExE;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,YAAY,MAAM,KAAG,kBAAoD,CAAA;AAEpG;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,YAAY,MAAM,KAAG,kBAAoD,CAAA;AAEpG;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,MAAM,EAAE,YAAY,MAAM,KAAG,kBACxB,CAAA"}

package/dist/dts/types/PathType.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Types of paths a harness may provide.
+ *
+ * Each harness can have different configuration directories
+ * for different purposes.
+ *
+ * @module
+ */
+import { Schema } from "effect";
+/**
+ * Path type schema.
+ */
+export declare const PathType: Schema.Literal<["Config", "Skills", "Commands", "Mcp", "Rules"]>;
+/**
+ * Path type.
+ */
+export type PathType = typeof PathType.Type;
+/**
+ * All supported path types.
+ */
+export declare const PathTypeAll: readonly ["Config", "Skills", "Commands", "Mcp", "Rules"];
+//# sourceMappingURL=PathType.d.ts.map

package/dist/dts/types/PathType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathType.d.ts","sourceRoot":"","sources":["../../../src/types/PathType.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;GAEG;AACH,eAAO,MAAM,QAAQ,kEAAiE,CAAA;AAEtF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C;;GAEG;AACH,eAAO,MAAM,WAAW,2DAA8F,CAAA"}