agent-config-detect 0.0.0

package/dist/cjs/platform/internal/testUtils.js

@@ -0,0 +1,79 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.withoutEnv = exports.withEnv = void 0;
+var _effect = require("effect");
+/**
+ * Test utilities for platform testing.
+ *
+ * @module
+ */
+
+/**
+ * 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)
+ * )
+ * ```
+ */
+const withEnv = (vars, effect) => {
+  const states = [];
+  return _effect.Effect.acquireUseRelease(
+  // Acquire: save original values and set new ones
+  _effect.Effect.sync(() => {
+    for (const [key, value] of Object.entries(vars)) {
+      states.push({
+        key,
+        originalValue: process.env[key]
+      });
+      if (value === undefined) {
+        delete process.env[key];
+      } else {
+        process.env[key] = value;
+      }
+    }
+  }),
+  // Use: run the effect
+  () => effect,
+  // Release: restore original values
+  () => _effect.Effect.sync(() => {
+    for (const {
+      key,
+      originalValue
+    } of states) {
+      if (originalValue === undefined) {
+        delete process.env[key];
+      } else {
+        process.env[key] = originalValue;
+      }
+    }
+  }));
+};
+/**
+ * Removes environment variables for the duration of an effect.
+ *
+ * @example
+ * ```ts
+ * const result = await Effect.runPromise(
+ *   withoutEnv(["XDG_CONFIG_HOME", "XDG_DATA_HOME"], myEffect)
+ * )
+ * ```
+ */
+exports.withEnv = withEnv;
+const withoutEnv = (keys, effect) => {
+  const vars = {};
+  for (const key of keys) {
+    vars[key] = undefined;
+  }
+  return withEnv(vars, effect);
+};
+exports.withoutEnv = withoutEnv;
+//# sourceMappingURL=testUtils.js.map

package/dist/cjs/platform/internal/testUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.js","names":["_effect","require","withEnv","vars","effect","states","Effect","acquireUseRelease","sync","key","value","Object","entries","push","originalValue","process","env","undefined","exports","withoutEnv","keys"],"sources":["../../../../src/platform/internal/testUtils.ts"],"sourcesContent":[null],"mappings":";;;;;;AAKA,IAAAA,OAAA,GAAAC,OAAA;AALA;;;;;;AAeA;;;;;;;;;;;;;AAaO,MAAMC,OAAO,GAAGA,CACrBC,IAAwC,EACxCC,MAA8B,KACJ;EAC1B,MAAMC,MAAM,GAAoB,EAAE;EAElC,OAAOC,cAAM,CAACC,iBAAiB;EAC7B;EACAD,cAAM,CAACE,IAAI,CAAC,MAAK;IACf,KAAK,MAAM,CAACC,GAAG,EAAEC,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACT,IAAI,CAAC,EAAE;MAC/CE,MAAM,CAACQ,IAAI,CAAC;QAAEJ,GAAG;QAAEK,aAAa,EAAEC,OAAO,CAACC,GAAG,CAACP,GAAG;MAAC,CAAE,CAAC;MACrD,IAAIC,KAAK,KAAKO,SAAS,EAAE;QACvB,OAAOF,OAAO,CAACC,GAAG,CAACP,GAAG,CAAC;MACzB,CAAC,MAAM;QACLM,OAAO,CAACC,GAAG,CAACP,GAAG,CAAC,GAAGC,KAAK;MAC1B;IACF;EACF,CAAC,CAAC;EACF;EACA,MAAMN,MAAM;EACZ;EACA,MACEE,cAAM,CAACE,IAAI,CAAC,MAAK;IACf,KAAK,MAAM;MAAEC,GAAG;MAAEK;IAAa,CAAE,IAAIT,MAAM,EAAE;MAC3C,IAAIS,aAAa,KAAKG,SAAS,EAAE;QAC/B,OAAOF,OAAO,CAACC,GAAG,CAACP,GAAG,CAAC;MACzB,CAAC,MAAM;QACLM,OAAO,CAACC,GAAG,CAACP,GAAG,CAAC,GAAGK,aAAa;MAClC;IACF;EACF,CAAC,CAAC,CACL;AACH,CAAC;AAED;;;;;;;;;;AAAAI,OAAA,CAAAhB,OAAA,GAAAA,OAAA;AAUO,MAAMiB,UAAU,GAAGA,CACxBC,IAA2B,EAC3BhB,MAA8B,KACJ;EAC1B,MAAMD,IAAI,GAA8B,EAAE;EAC1C,KAAK,MAAMM,GAAG,IAAIW,IAAI,EAAE;IACtBjB,IAAI,CAACM,GAAG,CAAC,GAAGQ,SAAS;EACvB;EACA,OAAOf,OAAO,CAACC,IAAI,EAAEC,MAAM,CAAC;AAC9B,CAAC;AAAAc,OAAA,CAAAC,UAAA,GAAAA,UAAA","ignoreList":[]}

package/dist/cjs/platform/internal/windows.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.roamingAppDataDir = exports.localAppDataDir = exports.dataDir = exports.configDir = exports.cacheDir = void 0;
+var _effect = require("effect");
+var _errors = require("../../errors.js");
+/**
+ * Windows-specific path resolution.
+ *
+ * @module
+ */
+
+/**
+ * Returns the user's config directory on Windows.
+ *
+ * Returns `%APPDATA%` which is typically `C:\Users\<user>\AppData\Roaming`.
+ */
+const configDir = exports.configDir = /*#__PURE__*/_effect.Effect.suspend(() => {
+  const appdata = process.env.APPDATA;
+  if (!appdata) {
+    return _effect.Effect.fail(new _errors.EnvVarError({
+      cause: new Error("APPDATA environment variable not set")
+    }));
+  }
+  return _effect.Effect.succeed(appdata);
+});
+/**
+ * Returns the user's data directory on Windows.
+ *
+ * Returns `%LOCALAPPDATA%` which is typically `C:\Users\<user>\AppData\Local`.
+ */
+const dataDir = exports.dataDir = /*#__PURE__*/_effect.Effect.suspend(() => {
+  const localAppData = process.env.LOCALAPPDATA;
+  if (!localAppData) {
+    return _effect.Effect.fail(new _errors.EnvVarError({
+      cause: new Error("LOCALAPPDATA environment variable not set")
+    }));
+  }
+  return _effect.Effect.succeed(localAppData);
+});
+/**
+ * Returns the roaming app data directory on Windows.
+ *
+ * This is `%APPDATA%`, used for settings that should roam with the user.
+ */
+const roamingAppDataDir = exports.roamingAppDataDir = configDir;
+/**
+ * Returns the local app data directory on Windows.
+ *
+ * This is `%LOCALAPPDATA%`, used for data that should stay on the local machine.
+ */
+const localAppDataDir = exports.localAppDataDir = dataDir;
+/**
+ * Returns the cache directory on Windows.
+ *
+ * On Windows, we use the local app data directory.
+ */
+const cacheDir = exports.cacheDir = dataDir;
+//# sourceMappingURL=windows.js.map

package/dist/cjs/platform/internal/windows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.js","names":["_effect","require","_errors","configDir","exports","Effect","suspend","appdata","process","env","APPDATA","fail","EnvVarError","cause","Error","succeed","dataDir","localAppData","LOCALAPPDATA","roamingAppDataDir","localAppDataDir","cacheDir"],"sources":["../../../../src/platform/internal/windows.ts"],"sourcesContent":[null],"mappings":";;;;;;AAKA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AANA;;;;;;AAQA;;;;;AAKO,MAAME,SAAS,GAAAC,OAAA,CAAAD,SAAA,gBAAyCE,cAAM,CAACC,OAAO,CAAC,MAAK;EACjF,MAAMC,OAAO,GAAGC,OAAO,CAACC,GAAG,CAACC,OAAO;EACnC,IAAI,CAACH,OAAO,EAAE;IACZ,OAAOF,cAAM,CAACM,IAAI,CAChB,IAAIC,mBAAW,CAAC;MAAEC,KAAK,EAAE,IAAIC,KAAK,CAAC,sCAAsC;IAAC,CAAE,CAAC,CAC9E;EACH;EACA,OAAOT,cAAM,CAACU,OAAO,CAACR,OAAO,CAAC;AAChC,CAAC,CAAC;AAEF;;;;;AAKO,MAAMS,OAAO,GAAAZ,OAAA,CAAAY,OAAA,gBAAyCX,cAAM,CAACC,OAAO,CAAC,MAAK;EAC/E,MAAMW,YAAY,GAAGT,OAAO,CAACC,GAAG,CAACS,YAAY;EAC7C,IAAI,CAACD,YAAY,EAAE;IACjB,OAAOZ,cAAM,CAACM,IAAI,CAChB,IAAIC,mBAAW,CAAC;MAAEC,KAAK,EAAE,IAAIC,KAAK,CAAC,2CAA2C;IAAC,CAAE,CAAC,CACnF;EACH;EACA,OAAOT,cAAM,CAACU,OAAO,CAACE,YAAY,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;AAKO,MAAME,iBAAiB,GAAAf,OAAA,CAAAe,iBAAA,GAAyChB,SAAS;AAEhF;;;;;AAKO,MAAMiB,eAAe,GAAAhB,OAAA,CAAAgB,eAAA,GAAyCJ,OAAO;AAE5E;;;;;AAKO,MAAMK,QAAQ,GAAAjB,OAAA,CAAAiB,QAAA,GAAyCL,OAAO","ignoreList":[]}

package/dist/cjs/types/ConfigResource.js

@@ -0,0 +1,44 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.makeConfigResource = exports.ConfigResource = void 0;
+var _effect = require("effect");
+var _FileFormat = require("./FileFormat.js");
+/**
+ * A configuration file resource location.
+ *
+ * Represents a single configuration file that may contain
+ * multiple configuration entries, accessed via a key path.
+ *
+ * @module
+ */
+
+/**
+ * Config resource schema.
+ */
+const ConfigResource = exports.ConfigResource = /*#__PURE__*/_effect.Schema.Struct({
+  /** Path to the configuration file. */
+  file: _effect.Schema.String,
+  /** Whether the file currently exists on the filesystem. */
+  fileExists: _effect.Schema.Boolean,
+  /** JSON pointer path to the relevant section (e.g., `"/mcpServers"`). */
+  keyPath: _effect.Schema.String,
+  /** Format of the configuration file. */
+  format: _FileFormat.FileFormat,
+  /** Optional JSON Schema URL for validation. */
+  schemaUrl: /*#__PURE__*/_effect.Schema.OptionFromNullOr(_effect.Schema.String)
+});
+/**
+ * Creates a config resource.
+ */
+const makeConfigResource = (file, fileExists, keyPath, format, schemaUrl) => ({
+  file,
+  fileExists,
+  keyPath,
+  format,
+  schemaUrl: schemaUrl !== undefined ? _effect.Option.some(schemaUrl) : _effect.Option.none()
+});
+exports.makeConfigResource = makeConfigResource;
+//# sourceMappingURL=ConfigResource.js.map

package/dist/cjs/types/ConfigResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigResource.js","names":["_effect","require","_FileFormat","ConfigResource","exports","Schema","Struct","file","String","fileExists","Boolean","keyPath","format","FileFormat","schemaUrl","OptionFromNullOr","makeConfigResource","undefined","Option","some","none"],"sources":["../../../src/types/ConfigResource.ts"],"sourcesContent":[null],"mappings":";;;;;;AAQA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,WAAA,GAAAD,OAAA;AATA;;;;;;;;;AAWA;;;AAGO,MAAME,cAAc,GAAAC,OAAA,CAAAD,cAAA,gBAAGE,cAAM,CAACC,MAAM,CAAC;EAC1C;EACAC,IAAI,EAAEF,cAAM,CAACG,MAAM;EACnB;EACAC,UAAU,EAAEJ,cAAM,CAACK,OAAO;EAC1B;EACAC,OAAO,EAAEN,cAAM,CAACG,MAAM;EACtB;EACAI,MAAM,EAAEC,sBAAU;EAClB;EACAC,SAAS,eAAET,cAAM,CAACU,gBAAgB,CAACV,cAAM,CAACG,MAAM;CACjD,CAAC;AAOF;;;AAGO,MAAMQ,kBAAkB,GAAGA,CAChCT,IAAY,EACZE,UAAmB,EACnBE,OAAe,EACfC,MAAsB,EACtBE,SAAkB,MACE;EACpBP,IAAI;EACJE,UAAU;EACVE,OAAO;EACPC,MAAM;EACNE,SAAS,EAAEA,SAAS,KAAKG,SAAS,GAAGC,cAAM,CAACC,IAAI,CAACL,SAAS,CAAC,GAAGI,cAAM,CAACE,IAAI;CAC1E,CAAC;AAAAhB,OAAA,CAAAY,kBAAA,GAAAA,kBAAA","ignoreList":[]}

package/dist/cjs/types/DirectoryResource.js

@@ -0,0 +1,42 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.makeDirectoryResource = exports.DirectoryResource = void 0;
+var _effect = require("effect");
+var _DirectoryStructure = require("./DirectoryStructure.js");
+var _FileFormat = require("./FileFormat.js");
+/**
+ * A directory-based resource location.
+ *
+ * Represents a directory that contains multiple resource files,
+ * such as commands or skills directories.
+ *
+ * @module
+ */
+
+/**
+ * Directory resource schema.
+ */
+const DirectoryResource = exports.DirectoryResource = /*#__PURE__*/_effect.Schema.Struct({
+  /** Path to the directory. */
+  path: _effect.Schema.String,
+  /** Whether the directory currently exists on the filesystem. */
+  exists: _effect.Schema.Boolean,
+  /** How resources are organized within the directory. */
+  structure: _DirectoryStructure.DirectoryStructure,
+  /** Format of files within the directory. */
+  fileFormat: _FileFormat.FileFormat
+});
+/**
+ * Creates a directory resource.
+ */
+const makeDirectoryResource = (path, exists, structure, fileFormat) => ({
+  path,
+  exists,
+  structure,
+  fileFormat
+});
+exports.makeDirectoryResource = makeDirectoryResource;
+//# sourceMappingURL=DirectoryResource.js.map

package/dist/cjs/types/DirectoryResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectoryResource.js","names":["_effect","require","_DirectoryStructure","_FileFormat","DirectoryResource","exports","Schema","Struct","path","String","exists","Boolean","structure","DirectoryStructure","fileFormat","FileFormat","makeDirectoryResource"],"sources":["../../../src/types/DirectoryResource.ts"],"sourcesContent":[null],"mappings":";;;;;;AAQA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,WAAA,GAAAF,OAAA;AAVA;;;;;;;;;AAYA;;;AAGO,MAAMG,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,gBAAGE,cAAM,CAACC,MAAM,CAAC;EAC7C;EACAC,IAAI,EAAEF,cAAM,CAACG,MAAM;EACnB;EACAC,MAAM,EAAEJ,cAAM,CAACK,OAAO;EACtB;EACAC,SAAS,EAAEC,sCAAkB;EAC7B;EACAC,UAAU,EAAEC;CACb,CAAC;AAOF;;;AAGO,MAAMC,qBAAqB,GAAGA,CACnCR,IAAY,EACZE,MAAe,EACfE,SAAiC,EACjCE,UAA0B,MACH;EACvBN,IAAI;EACJE,MAAM;EACNE,SAAS;EACTE;CACD,CAAC;AAAAT,OAAA,CAAAW,qBAAA,GAAAA,qBAAA","ignoreList":[]}

package/dist/cjs/types/DirectoryStructure.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.nested = exports.flat = exports.Nested = exports.Flat = exports.DirectoryStructure = void 0;
+var _effect = require("effect");
+/**
+ * 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
+ */
+
+/**
+ * Files directly in the directory.
+ *
+ * Example: `commands/foo.md`, `commands/bar.md`
+ */
+class Flat extends /*#__PURE__*/_effect.Data.TaggedClass("Flat") {}
+/**
+ * Subdirectory per resource with a fixed filename inside.
+ *
+ * Example: `skills/foo/SKILL.md`, `skills/bar/SKILL.md`
+ */
+exports.Flat = Flat;
+class Nested extends /*#__PURE__*/_effect.Data.TaggedClass("Nested") {}
+/**
+ * Directory structure schema for serialization.
+ */
+exports.Nested = Nested;
+const DirectoryStructure = exports.DirectoryStructure = /*#__PURE__*/_effect.Schema.Union(/*#__PURE__*/_effect.Schema.TaggedStruct("Flat", {
+  filePattern: _effect.Schema.String
+}), /*#__PURE__*/_effect.Schema.TaggedStruct("Nested", {
+  subdirPattern: _effect.Schema.String,
+  fileName: _effect.Schema.String
+}));
+/**
+ * Creates a flat directory structure.
+ */
+const flat = filePattern => new Flat({
+  filePattern
+});
+/**
+ * Creates a nested directory structure.
+ */
+exports.flat = flat;
+const nested = (subdirPattern, fileName) => new Nested({
+  subdirPattern,
+  fileName
+});
+exports.nested = nested;
+//# sourceMappingURL=DirectoryStructure.js.map

package/dist/cjs/types/DirectoryStructure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectoryStructure.js","names":["_effect","require","Flat","Data","TaggedClass","exports","Nested","DirectoryStructure","Schema","Union","TaggedStruct","filePattern","String","subdirPattern","fileName","flat","nested"],"sources":["../../../src/types/DirectoryStructure.ts"],"sourcesContent":[null],"mappings":";;;;;;AASA,IAAAA,OAAA,GAAAC,OAAA;AATA;;;;;;;;;;AAWA;;;;;AAKM,MAAOC,IAAK,sBAAQC,YAAI,CAACC,WAAW,CAAC,MAAM,CAG/C;AAEF;;;;;AAAAC,OAAA,CAAAH,IAAA,GAAAA,IAAA;AAKM,MAAOI,MAAO,sBAAQH,YAAI,CAACC,WAAW,CAAC,QAAQ,CAUnD;AAOF;;;AAAAC,OAAA,CAAAC,MAAA,GAAAA,MAAA;AAGO,MAAMC,kBAAkB,GAAAF,OAAA,CAAAE,kBAAA,gBAAsCC,cAAM,CAACC,KAAK,cAC/ED,cAAM,CAACE,YAAY,CAAC,MAAM,EAAE;EAAEC,WAAW,EAAEH,cAAM,CAACI;AAAM,CAAE,CAAC,eAC3DJ,cAAM,CAACE,YAAY,CAAC,QAAQ,EAAE;EAC5BG,aAAa,EAAEL,cAAM,CAACI,MAAM;EAC5BE,QAAQ,EAAEN,cAAM,CAACI;CAClB,CAAC,CACkC;AAEtC;;;AAGO,MAAMG,IAAI,GAAIJ,WAAmB,IAAyB,IAAIT,IAAI,CAAC;EAAES;AAAW,CAAE,CAAC;AAE1F;;;AAAAN,OAAA,CAAAU,IAAA,GAAAA,IAAA;AAGO,MAAMC,MAAM,GAAGA,CAACH,aAAqB,EAAEC,QAAgB,KAC5D,IAAIR,MAAM,CAAC;EAAEO,aAAa;EAAEC;AAAQ,CAAE,CAAC;AAAAT,OAAA,CAAAW,MAAA,GAAAA,MAAA","ignoreList":[]}

package/dist/cjs/types/EnvValue.js

@@ -0,0 +1,199 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.tryToNative = exports.toNative = exports.resolve = exports.plain = exports.isPlain = exports.isEnvRef = exports.fromNative = exports.env = exports.Plain = exports.EnvValue = exports.EnvRef = void 0;
+var _effect = require("effect");
+var _errors = require("../errors.js");
+/**
+ * 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
+ */
+
+/**
+ * A plain string value.
+ */
+class Plain extends /*#__PURE__*/_effect.Data.TaggedClass("Plain") {}
+/**
+ * A reference to an environment variable.
+ */
+exports.Plain = Plain;
+class EnvRef extends /*#__PURE__*/_effect.Data.TaggedClass("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" }`
+ */
+exports.EnvRef = EnvRef;
+const EnvValue = exports.EnvValue = /*#__PURE__*/_effect.Schema.Union(/*#__PURE__*/_effect.Schema.transform(_effect.Schema.String, /*#__PURE__*/_effect.Schema.instanceOf(Plain), {
+  strict: true,
+  decode: value => new Plain({
+    value
+  }),
+  encode: plain => plain.value
+}), /*#__PURE__*/_effect.Schema.transform(/*#__PURE__*/_effect.Schema.Struct({
+  env: _effect.Schema.String
+}), /*#__PURE__*/_effect.Schema.instanceOf(EnvRef), {
+  strict: true,
+  decode: ({
+    env
+  }) => new EnvRef({
+    env
+  }),
+  encode: envRef => ({
+    env: envRef.env
+  })
+}));
+/**
+ * Creates a plain string value.
+ */
+const plain = value => new Plain({
+  value
+});
+/**
+ * Creates an environment variable reference.
+ */
+exports.plain = plain;
+const env = varName => new EnvRef({
+  env: varName
+});
+/**
+ * Returns `true` if this is a plain string value.
+ */
+exports.env = env;
+const isPlain = value => value._tag === "Plain";
+/**
+ * Returns `true` if this is an environment variable reference.
+ */
+exports.isPlain = isPlain;
+const isEnvRef = value => value._tag === "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)
+ */
+exports.isEnvRef = isEnvRef;
+const toNative = (value, kind) => {
+  if (value._tag === "Plain") {
+    return value.value;
+  }
+  switch (kind) {
+    case "ClaudeCode":
+    case "AmpCode":
+    case "CopilotCli":
+      return `\${${value.env}}`;
+    case "OpenCode":
+      return `{env:${value.env}}`;
+    case "Goose":
+      return process.env[value.env] ?? "";
+  }
+};
+/**
+ * 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.
+ */
+exports.toNative = toNative;
+const tryToNative = (value, kind) => {
+  if (value._tag === "Plain") {
+    return _effect.Effect.succeed(value.value);
+  }
+  switch (kind) {
+    case "ClaudeCode":
+    case "AmpCode":
+    case "CopilotCli":
+      return _effect.Effect.succeed(`\${${value.env}}`);
+    case "OpenCode":
+      return _effect.Effect.succeed(`{env:${value.env}}`);
+    case "Goose":
+      {
+        const envVal = process.env[value.env];
+        if (envVal === undefined) {
+          return _effect.Effect.fail(new _errors.MissingEnvVarError({
+            name: value.env
+          }));
+        }
+        return _effect.Effect.succeed(envVal);
+      }
+  }
+};
+/**
+ * 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`
+ */
+exports.tryToNative = tryToNative;
+const fromNative = (s, kind) => {
+  switch (kind) {
+    case "ClaudeCode":
+    case "AmpCode":
+    case "CopilotCli":
+      {
+        // Parse ${VAR} pattern
+        if (s.startsWith("${") && s.endsWith("}")) {
+          const varName = s.slice(2, -1);
+          return new EnvRef({
+            env: varName
+          });
+        }
+        return new Plain({
+          value: s
+        });
+      }
+    case "OpenCode":
+      {
+        // Parse {env:VAR} pattern
+        if (s.startsWith("{env:") && s.endsWith("}")) {
+          const varName = s.slice(5, -1);
+          return new EnvRef({
+            env: varName
+          });
+        }
+        return new Plain({
+          value: s
+        });
+      }
+    case "Goose":
+      // Goose doesn't use inline env var syntax; values are always plain
+      return new Plain({
+        value: s
+      });
+  }
+};
+/**
+ * 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
+ */
+exports.fromNative = fromNative;
+const resolve = value => {
+  if (value._tag === "Plain") {
+    return _effect.Option.some(value.value);
+  }
+  const envVal = process.env[value.env];
+  return envVal !== undefined ? _effect.Option.some(envVal) : _effect.Option.none();
+};
+exports.resolve = resolve;
+//# sourceMappingURL=EnvValue.js.map

package/dist/cjs/types/EnvValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvValue.js","names":["_effect","require","_errors","Plain","Data","TaggedClass","exports","EnvRef","EnvValue","Schema","Union","transform","String","instanceOf","strict","decode","value","encode","plain","Struct","env","envRef","varName","isPlain","_tag","isEnvRef","toNative","kind","process","tryToNative","Effect","succeed","envVal","undefined","fail","MissingEnvVarError","name","fromNative","s","startsWith","endsWith","slice","resolve","Option","some","none"],"sources":["../../../src/types/EnvValue.ts"],"sourcesContent":[null],"mappings":";;;;;;AAWA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAZA;;;;;;;;;;;;AAeA;;;AAGM,MAAOE,KAAM,sBAAQC,YAAI,CAACC,WAAW,CAAC,OAAO,CAEjD;AAEF;;;AAAAC,OAAA,CAAAH,KAAA,GAAAA,KAAA;AAGM,MAAOI,MAAO,sBAAQH,YAAI,CAACC,WAAW,CAAC,QAAQ,CAEnD;AAOF;;;;;;AAAAC,OAAA,CAAAC,MAAA,GAAAA,MAAA;AAMO,MAAMC,QAAQ,GAAAF,OAAA,CAAAE,QAAA,gBAA+DC,cAAM,CAACC,KAAK,cAC9FD,cAAM,CAACE,SAAS,CACdF,cAAM,CAACG,MAAM,eACbH,cAAM,CAACI,UAAU,CAACV,KAAK,CAAC,EACxB;EACEW,MAAM,EAAE,IAAI;EACZC,MAAM,EAAGC,KAAK,IAAK,IAAIb,KAAK,CAAC;IAAEa;EAAK,CAAE,CAAC;EACvCC,MAAM,EAAGC,KAAK,IAAKA,KAAK,CAACF;CAC1B,CACF,eACDP,cAAM,CAACE,SAAS,cACdF,cAAM,CAACU,MAAM,CAAC;EAAEC,GAAG,EAAEX,cAAM,CAACG;AAAM,CAAE,CAAC,eACrCH,cAAM,CAACI,UAAU,CAACN,MAAM,CAAC,EACzB;EACEO,MAAM,EAAE,IAAI;EACZC,MAAM,EAAEA,CAAC;IAAEK;EAAG,CAAE,KAAK,IAAIb,MAAM,CAAC;IAAEa;EAAG,CAAE,CAAC;EACxCH,MAAM,EAAGI,MAAM,KAAM;IAAED,GAAG,EAAEC,MAAM,CAACD;EAAG,CAAE;CACzC,CACF,CACF;AAED;;;AAGO,MAAMF,KAAK,GAAIF,KAAa,IAAe,IAAIb,KAAK,CAAC;EAAEa;AAAK,CAAE,CAAC;AAEtE;;;AAAAV,OAAA,CAAAY,KAAA,GAAAA,KAAA;AAGO,MAAME,GAAG,GAAIE,OAAe,IAAe,IAAIf,MAAM,CAAC;EAAEa,GAAG,EAAEE;AAAO,CAAE,CAAC;AAE9E;;;AAAAhB,OAAA,CAAAc,GAAA,GAAAA,GAAA;AAGO,MAAMG,OAAO,GAAIP,KAAe,IAAqBA,KAAK,CAACQ,IAAI,KAAK,OAAO;AAElF;;;AAAAlB,OAAA,CAAAiB,OAAA,GAAAA,OAAA;AAGO,MAAME,QAAQ,GAAIT,KAAe,IAAsBA,KAAK,CAACQ,IAAI,KAAK,QAAQ;AAErF;;;;;;;;AAAAlB,OAAA,CAAAmB,QAAA,GAAAA,QAAA;AAQO,MAAMC,QAAQ,GAAGA,CAACV,KAAe,EAAEW,IAAiB,KAAY;EACrE,IAAIX,KAAK,CAACQ,IAAI,KAAK,OAAO,EAAE;IAC1B,OAAOR,KAAK,CAACA,KAAK;EACpB;EAEA,QAAQW,IAAI;IACV,KAAK,YAAY;IACjB,KAAK,SAAS;IACd,KAAK,YAAY;MACf,OAAO,MAAMX,KAAK,CAACI,GAAG,GAAG;IAC3B,KAAK,UAAU;MACb,OAAO,QAAQJ,KAAK,CAACI,GAAG,GAAG;IAC7B,KAAK,OAAO;MACV,OAAOQ,OAAO,CAACR,GAAG,CAACJ,KAAK,CAACI,GAAG,CAAC,IAAI,EAAE;EACvC;AACF,CAAC;AAED;;;;;;;;;;;AAAAd,OAAA,CAAAoB,QAAA,GAAAA,QAAA;AAWO,MAAMG,WAAW,GAAGA,CACzBb,KAAe,EACfW,IAAiB,KAC4B;EAC7C,IAAIX,KAAK,CAACQ,IAAI,KAAK,OAAO,EAAE;IAC1B,OAAOM,cAAM,CAACC,OAAO,CAACf,KAAK,CAACA,KAAK,CAAC;EACpC;EAEA,QAAQW,IAAI;IACV,KAAK,YAAY;IACjB,KAAK,SAAS;IACd,KAAK,YAAY;MACf,OAAOG,cAAM,CAACC,OAAO,CAAC,MAAMf,KAAK,CAACI,GAAG,GAAG,CAAC;IAC3C,KAAK,UAAU;MACb,OAAOU,cAAM,CAACC,OAAO,CAAC,QAAQf,KAAK,CAACI,GAAG,GAAG,CAAC;IAC7C,KAAK,OAAO;MAAE;QACZ,MAAMY,MAAM,GAAGJ,OAAO,CAACR,GAAG,CAACJ,KAAK,CAACI,GAAG,CAAC;QACrC,IAAIY,MAAM,KAAKC,SAAS,EAAE;UACxB,OAAOH,cAAM,CAACI,IAAI,CAAC,IAAIC,0BAAkB,CAAC;YAAEC,IAAI,EAAEpB,KAAK,CAACI;UAAG,CAAE,CAAC,CAAC;QACjE;QACA,OAAOU,cAAM,CAACC,OAAO,CAACC,MAAM,CAAC;MAC/B;EACF;AACF,CAAC;AAED;;;;;;;;AAAA1B,OAAA,CAAAuB,WAAA,GAAAA,WAAA;AAQO,MAAMQ,UAAU,GAAGA,CAACC,CAAS,EAAEX,IAAiB,KAAc;EACnE,QAAQA,IAAI;IACV,KAAK,YAAY;IACjB,KAAK,SAAS;IACd,KAAK,YAAY;MAAE;QACjB;QACA,IAAIW,CAAC,CAACC,UAAU,CAAC,IAAI,CAAC,IAAID,CAAC,CAACE,QAAQ,CAAC,GAAG,CAAC,EAAE;UACzC,MAAMlB,OAAO,GAAGgB,CAAC,CAACG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;UAC9B,OAAO,IAAIlC,MAAM,CAAC;YAAEa,GAAG,EAAEE;UAAO,CAAE,CAAC;QACrC;QACA,OAAO,IAAInB,KAAK,CAAC;UAAEa,KAAK,EAAEsB;QAAC,CAAE,CAAC;MAChC;IACA,KAAK,UAAU;MAAE;QACf;QACA,IAAIA,CAAC,CAACC,UAAU,CAAC,OAAO,CAAC,IAAID,CAAC,CAACE,QAAQ,CAAC,GAAG,CAAC,EAAE;UAC5C,MAAMlB,OAAO,GAAGgB,CAAC,CAACG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;UAC9B,OAAO,IAAIlC,MAAM,CAAC;YAAEa,GAAG,EAAEE;UAAO,CAAE,CAAC;QACrC;QACA,OAAO,IAAInB,KAAK,CAAC;UAAEa,KAAK,EAAEsB;QAAC,CAAE,CAAC;MAChC;IACA,KAAK,OAAO;MACV;MACA,OAAO,IAAInC,KAAK,CAAC;QAAEa,KAAK,EAAEsB;MAAC,CAAE,CAAC;EAClC;AACF,CAAC;AAED;;;;;;AAAAhC,OAAA,CAAA+B,UAAA,GAAAA,UAAA;AAMO,MAAMK,OAAO,GAAI1B,KAAe,IAA2B;EAChE,IAAIA,KAAK,CAACQ,IAAI,KAAK,OAAO,EAAE;IAC1B,OAAOmB,cAAM,CAACC,IAAI,CAAC5B,KAAK,CAACA,KAAK,CAAC;EACjC;EACA,MAAMgB,MAAM,GAAGJ,OAAO,CAACR,GAAG,CAACJ,KAAK,CAACI,GAAG,CAAC;EACrC,OAAOY,MAAM,KAAKC,SAAS,GAAGU,cAAM,CAACC,IAAI,CAACZ,MAAM,CAAC,GAAGW,cAAM,CAACE,IAAI,EAAE;AACnE,CAAC;AAAAvC,OAAA,CAAAoC,OAAA,GAAAA,OAAA","ignoreList":[]}

package/dist/cjs/types/FileFormat.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FileFormatAll = exports.FileFormat = void 0;
+var _effect = require("effect");
+/**
+ * File formats used by harness configuration files.
+ *
+ * Different harnesses use different formats for their configuration,
+ * commands, and other resources.
+ *
+ * @module
+ */
+
+/**
+ * File format schema.
+ */
+const FileFormat = exports.FileFormat = /*#__PURE__*/_effect.Schema.Literal("Json", "Jsonc", "Yaml", "Markdown", "MarkdownWithFrontmatter");
+/**
+ * All supported file formats.
+ */
+const FileFormatAll = exports.FileFormatAll = ["Json", "Jsonc", "Yaml", "Markdown", "MarkdownWithFrontmatter"];
+//# sourceMappingURL=FileFormat.js.map

package/dist/cjs/types/FileFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileFormat.js","names":["_effect","require","FileFormat","exports","Schema","Literal","FileFormatAll"],"sources":["../../../src/types/FileFormat.ts"],"sourcesContent":[null],"mappings":";;;;;;AAQA,IAAAA,OAAA,GAAAC,OAAA;AARA;;;;;;;;;AAUA;;;AAGO,MAAMC,UAAU,GAAAC,OAAA,CAAAD,UAAA,gBAAGE,cAAM,CAACC,OAAO,CACtC,MAAM,EACN,OAAO,EACP,MAAM,EACN,UAAU,EACV,yBAAyB,CAC1B;AAOD;;;AAGO,MAAMC,aAAa,GAAAH,OAAA,CAAAG,aAAA,GAAG,CAC3B,MAAM,EACN,OAAO,EACP,MAAM,EACN,UAAU,EACV,yBAAyB,CACmB","ignoreList":[]}

package/dist/cjs/types/HarnessKind.js

@@ -0,0 +1,130 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.directoryNames = exports.binaryNames = exports.asStr = exports.HarnessKindAll = exports.HarnessKind = void 0;
+var _effect = require("effect");
+/**
+ * Supported AI coding harnesses.
+ *
+ * This module provides the HarnessKind type representing the different
+ * AI coding assistants whose configuration paths can be discovered.
+ *
+ * @module
+ */
+
+/**
+ * Harness kind schema - represents the different AI coding assistants.
+ */
+const HarnessKind = exports.HarnessKind = /*#__PURE__*/_effect.Schema.Literal("ClaudeCode", "OpenCode", "Goose", "AmpCode", "CopilotCli");
+/**
+ * All supported harness kinds.
+ */
+const HarnessKindAll = exports.HarnessKindAll = ["ClaudeCode", "OpenCode", "Goose", "AmpCode", "CopilotCli"];
+/**
+ * Returns the display name of this harness kind.
+ */
+const asStr = kind => {
+  switch (kind) {
+    case "ClaudeCode":
+      return "Claude Code";
+    case "OpenCode":
+      return "OpenCode";
+    case "Goose":
+      return "Goose";
+    case "AmpCode":
+      return "AMP Code";
+    case "CopilotCli":
+      return "Copilot CLI";
+  }
+};
+/**
+ * Returns the known CLI binary names for this harness.
+ *
+ * These are the executable names that indicate the harness is installed
+ * and available in PATH.
+ */
+exports.asStr = asStr;
+const binaryNames = kind => {
+  switch (kind) {
+    case "ClaudeCode":
+      return ["claude"];
+    case "OpenCode":
+      return ["opencode"];
+    case "Goose":
+      return ["goose"];
+    case "AmpCode":
+      return ["amp"];
+    case "CopilotCli":
+      return ["copilot"];
+  }
+};
+/**
+ * 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.
+ */
+exports.binaryNames = binaryNames;
+const directoryNames = (kind, resource) => {
+  switch (kind) {
+    case "OpenCode":
+      switch (resource) {
+        case "Skills":
+          return ["skill"];
+        case "Commands":
+          return ["command"];
+        case "Agents":
+          return ["agent"];
+        case "Plugins":
+          return ["plugin"];
+      }
+      break;
+    case "ClaudeCode":
+      switch (resource) {
+        case "Skills":
+          return ["skills"];
+        case "Commands":
+          return ["commands"];
+        case "Agents":
+          return ["agents"];
+        case "Plugins":
+          return ["plugins"];
+      }
+      break;
+    case "Goose":
+      switch (resource) {
+        case "Skills":
+          return ["skills"];
+        default:
+          return undefined;
+      }
+    case "AmpCode":
+      switch (resource) {
+        case "Skills":
+          return ["skills"];
+        case "Commands":
+          return ["commands"];
+        default:
+          return undefined;
+      }
+    case "CopilotCli":
+      switch (resource) {
+        case "Skills":
+          return ["skills"];
+        case "Agents":
+          return ["agents"];
+        default:
+          return undefined;
+      }
+    default:
+      return undefined;
+  }
+};
+exports.directoryNames = directoryNames;
+//# sourceMappingURL=HarnessKind.js.map