agent-config-detect 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Tin Pham
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# Effect Monorepo Template - Domain Package

package/dist/cjs/errors.js

@@ -0,0 +1,105 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.YamlParseError = exports.UnsupportedScopeError = exports.UnsupportedPlatformError = exports.UnsupportedMcpConfigError = exports.NotFoundError = exports.MissingFieldError = exports.MissingEnvVarError = exports.IoError = exports.InvalidPathError = exports.EnvVarError = exports.BinaryDetectionError = void 0;
+var _effect = require("effect");
+/**
+ * Error types for harness operations.
+ *
+ * @module
+ */
+
+/**
+ * The requested harness was not found on this system.
+ */
+class NotFoundError extends /*#__PURE__*/_effect.Data.TaggedError("NotFoundError") {}
+/**
+ * The path is invalid or inaccessible.
+ */
+exports.NotFoundError = NotFoundError;
+class InvalidPathError extends /*#__PURE__*/_effect.Data.TaggedError("InvalidPathError") {
+  get message() {
+    return `invalid path: ${this.path}`;
+  }
+}
+/**
+ * An environment variable could not be read.
+ */
+exports.InvalidPathError = InvalidPathError;
+class EnvVarError extends /*#__PURE__*/_effect.Data.TaggedError("EnvVarError") {
+  get message() {
+    return `environment variable error: ${this.cause.message}`;
+  }
+}
+/**
+ * The current platform is not supported.
+ */
+exports.EnvVarError = EnvVarError;
+class UnsupportedPlatformError extends /*#__PURE__*/_effect.Data.TaggedError("UnsupportedPlatformError") {
+  get message() {
+    return "unsupported platform";
+  }
+}
+/**
+ * An I/O error occurred.
+ */
+exports.UnsupportedPlatformError = UnsupportedPlatformError;
+class IoError extends /*#__PURE__*/_effect.Data.TaggedError("IoError") {
+  get message() {
+    return `IO error: ${this.cause.message}`;
+  }
+}
+/**
+ * MCP server uses unsupported features for target harness.
+ */
+exports.IoError = IoError;
+class UnsupportedMcpConfigError extends /*#__PURE__*/_effect.Data.TaggedError("UnsupportedMcpConfigError") {
+  get message() {
+    return `unsupported MCP config for ${this.harness}: ${this.reason}`;
+  }
+}
+/**
+ * Binary detection failed due to system error.
+ */
+exports.UnsupportedMcpConfigError = UnsupportedMcpConfigError;
+class BinaryDetectionError extends /*#__PURE__*/_effect.Data.TaggedError("BinaryDetectionError") {}
+/**
+ * The requested scope is not supported by this harness.
+ */
+exports.BinaryDetectionError = BinaryDetectionError;
+class UnsupportedScopeError extends /*#__PURE__*/_effect.Data.TaggedError("UnsupportedScopeError") {
+  get message() {
+    return `${this.harness} does not support ${this.scope} scope`;
+  }
+}
+/**
+ * YAML parsing failed.
+ */
+exports.UnsupportedScopeError = UnsupportedScopeError;
+class YamlParseError extends /*#__PURE__*/_effect.Data.TaggedError("YamlParseError") {
+  get message() {
+    return `YAML parse error: ${this.cause.message}`;
+  }
+}
+/**
+ * A required field is missing from the input.
+ */
+exports.YamlParseError = YamlParseError;
+class MissingFieldError extends /*#__PURE__*/_effect.Data.TaggedError("MissingFieldError") {
+  get message() {
+    return `missing required field: ${this.field}`;
+  }
+}
+/**
+ * An environment variable referenced by EnvValue is not set.
+ */
+exports.MissingFieldError = MissingFieldError;
+class MissingEnvVarError extends /*#__PURE__*/_effect.Data.TaggedError("MissingEnvVarError") {
+  get message() {
+    return `missing environment variable: ${this.name}`;
+  }
+}
+exports.MissingEnvVarError = MissingEnvVarError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":["_effect","require","NotFoundError","Data","TaggedError","exports","InvalidPathError","message","path","EnvVarError","cause","UnsupportedPlatformError","IoError","UnsupportedMcpConfigError","harness","reason","BinaryDetectionError","UnsupportedScopeError","scope","YamlParseError","MissingFieldError","field","MissingEnvVarError","name"],"sources":["../../src/errors.ts"],"sourcesContent":[null],"mappings":";;;;;;AAKA,IAAAA,OAAA,GAAAC,OAAA;AALA;;;;;;AAOA;;;AAGM,MAAOC,aAAc,sBAAQC,YAAI,CAACC,WAAW,CAAC,eAAe,CAEjE;AAEF;;;AAAAC,OAAA,CAAAH,aAAA,GAAAA,aAAA;AAGM,MAAOI,gBAAiB,sBAAQH,YAAI,CAACC,WAAW,CAAC,kBAAkB,CAEvE;EACA,IAAIG,OAAOA,CAAA;IACT,OAAO,iBAAiB,IAAI,CAACC,IAAI,EAAE;EACrC;;AAGF;;;AAAAH,OAAA,CAAAC,gBAAA,GAAAA,gBAAA;AAGM,MAAOG,WAAY,sBAAQN,YAAI,CAACC,WAAW,CAAC,aAAa,CAE7D;EACA,IAAIG,OAAOA,CAAA;IACT,OAAO,+BAA+B,IAAI,CAACG,KAAK,CAACH,OAAO,EAAE;EAC5D;;AAGF;;;AAAAF,OAAA,CAAAI,WAAA,GAAAA,WAAA;AAGM,MAAOE,wBAAyB,sBAAQR,YAAI,CAACC,WAAW,CAAC,0BAA0B,CAAK;EAC5F,IAAIG,OAAOA,CAAA;IACT,OAAO,sBAAsB;EAC/B;;AAGF;;;AAAAF,OAAA,CAAAM,wBAAA,GAAAA,wBAAA;AAGM,MAAOC,OAAQ,sBAAQT,YAAI,CAACC,WAAW,CAAC,SAAS,CAErD;EACA,IAAIG,OAAOA,CAAA;IACT,OAAO,aAAa,IAAI,CAACG,KAAK,CAACH,OAAO,EAAE;EAC1C;;AAGF;;;AAAAF,OAAA,CAAAO,OAAA,GAAAA,OAAA;AAGM,MAAOC,yBAA0B,sBAAQV,YAAI,CAACC,WAAW,CAAC,2BAA2B,CAGzF;EACA,IAAIG,OAAOA,CAAA;IACT,OAAO,8BAA8B,IAAI,CAACO,OAAO,KAAK,IAAI,CAACC,MAAM,EAAE;EACrE;;AAGF;;;AAAAV,OAAA,CAAAQ,yBAAA,GAAAA,yBAAA;AAGM,MAAOG,oBAAqB,sBAAQb,YAAI,CAACC,WAAW,CAAC,sBAAsB,CAE/E;AAEF;;;AAAAC,OAAA,CAAAW,oBAAA,GAAAA,oBAAA;AAGM,MAAOC,qBAAsB,sBAAQd,YAAI,CAACC,WAAW,CAAC,uBAAuB,CAGjF;EACA,IAAIG,OAAOA,CAAA;IACT,OAAO,GAAG,IAAI,CAACO,OAAO,qBAAqB,IAAI,CAACI,KAAK,QAAQ;EAC/D;;AAGF;;;AAAAb,OAAA,CAAAY,qBAAA,GAAAA,qBAAA;AAGM,MAAOE,cAAe,sBAAQhB,YAAI,CAACC,WAAW,CAAC,gBAAgB,CAEnE;EACA,IAAIG,OAAOA,CAAA;IACT,OAAO,qBAAqB,IAAI,CAACG,KAAK,CAACH,OAAO,EAAE;EAClD;;AAGF;;;AAAAF,OAAA,CAAAc,cAAA,GAAAA,cAAA;AAGM,MAAOC,iBAAkB,sBAAQjB,YAAI,CAACC,WAAW,CAAC,mBAAmB,CAEzE;EACA,IAAIG,OAAOA,CAAA;IACT,OAAO,2BAA2B,IAAI,CAACc,KAAK,EAAE;EAChD;;AAGF;;;AAAAhB,OAAA,CAAAe,iBAAA,GAAAA,iBAAA;AAGM,MAAOE,kBAAmB,sBAAQnB,YAAI,CAACC,WAAW,CAAC,oBAAoB,CAE3E;EACA,IAAIG,OAAOA,CAAA;IACT,OAAO,iCAAiC,IAAI,CAACgB,IAAI,EAAE;EACrD","ignoreList":[]}

package/dist/cjs/index.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  Platform: true,
+  PlatformLive: true,
+  TestPlatform: true,
+  TestPlatformDarwin: true,
+  TestPlatformLinux: true,
+  TestPlatformWindows: true,
+  withEnv: true,
+  withoutEnv: true
+};
+Object.defineProperty(exports, "Platform", {
+  enumerable: true,
+  get: function () {
+    return _index2.Platform;
+  }
+});
+Object.defineProperty(exports, "PlatformLive", {
+  enumerable: true,
+  get: function () {
+    return _index2.PlatformLive;
+  }
+});
+Object.defineProperty(exports, "TestPlatform", {
+  enumerable: true,
+  get: function () {
+    return _index2.TestPlatform;
+  }
+});
+Object.defineProperty(exports, "TestPlatformDarwin", {
+  enumerable: true,
+  get: function () {
+    return _index2.TestPlatformDarwin;
+  }
+});
+Object.defineProperty(exports, "TestPlatformLinux", {
+  enumerable: true,
+  get: function () {
+    return _index2.TestPlatformLinux;
+  }
+});
+Object.defineProperty(exports, "TestPlatformWindows", {
+  enumerable: true,
+  get: function () {
+    return _index2.TestPlatformWindows;
+  }
+});
+Object.defineProperty(exports, "withEnv", {
+  enumerable: true,
+  get: function () {
+    return _index2.withEnv;
+  }
+});
+Object.defineProperty(exports, "withoutEnv", {
+  enumerable: true,
+  get: function () {
+    return _index2.withoutEnv;
+  }
+});
+var _index = require("./types/index.js");
+Object.keys(_index).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _index[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _index[key];
+    }
+  });
+});
+var _errors = require("./errors.js");
+Object.keys(_errors).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _errors[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _errors[key];
+    }
+  });
+});
+var _index2 = require("./platform/index.js");
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_index","require","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get","_errors","_index2"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,IAAAA,MAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,MAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAL,MAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAb,MAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AAGA,IAAAS,OAAA,GAAAb,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAW,OAAA,EAAAV,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAS,OAAA,CAAAT,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,OAAA,CAAAT,GAAA;IAAA;EAAA;AAAA;AAGA,IAAAU,OAAA,GAAAd,OAAA","ignoreList":[]}

package/dist/cjs/platform/Platform.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Platform = void 0;
+var _effect = require("effect");
+/**
+ * Platform service tag.
+ */
+class Platform extends /*#__PURE__*/_effect.Context.Tag("Platform")() {}
+exports.Platform = Platform;
+//# sourceMappingURL=Platform.js.map

package/dist/cjs/platform/Platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Platform.js","names":["_effect","require","Platform","Context","Tag","exports"],"sources":["../../../src/platform/Platform.ts"],"sourcesContent":[null],"mappings":";;;;;;AAMA,IAAAA,OAAA,GAAAC,OAAA;AAsDA;;;AAGM,MAAOC,QAAS,sBAAQC,eAAO,CAACC,GAAG,CAAC,UAAU,CAAC,EAA6B;AAAAC,OAAA,CAAAH,QAAA,GAAAA,QAAA","ignoreList":[]}

package/dist/cjs/platform/TestPlatform.js

@@ -0,0 +1,65 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TestPlatformWindows = exports.TestPlatformLinux = exports.TestPlatformDarwin = exports.TestPlatform = void 0;
+var _effect = require("effect");
+var _Platform = require("./Platform.js");
+/**
+ * Test platform layer for mocking in tests.
+ *
+ * @module
+ */
+
+/**
+ * Creates a test platform layer with the given configuration.
+ *
+ * Useful for testing platform-dependent code without relying on
+ * the actual filesystem or environment.
+ */
+const TestPlatform = (config = {}) => {
+  const service = {
+    os: config.os ?? "darwin",
+    homeDir: _effect.Effect.succeed(config.home ?? "/home/testuser"),
+    configDir: _effect.Effect.succeed(config.config ?? "/home/testuser/.config"),
+    dataDir: _effect.Effect.succeed(config.data ?? "/home/testuser/.local/share"),
+    cacheDir: _effect.Effect.succeed(config.cache ?? "/home/testuser/.cache")
+  };
+  return _effect.Layer.succeed(_Platform.Platform, service);
+};
+/**
+ * Creates a macOS test platform.
+ */
+exports.TestPlatform = TestPlatform;
+const TestPlatformDarwin = (home = "/Users/testuser") => TestPlatform({
+  os: "darwin",
+  home,
+  config: `${home}/.config`,
+  data: `${home}/Library/Application Support`,
+  cache: `${home}/Library/Application Support`
+});
+/**
+ * Creates a Linux test platform.
+ */
+exports.TestPlatformDarwin = TestPlatformDarwin;
+const TestPlatformLinux = (home = "/home/testuser") => TestPlatform({
+  os: "linux",
+  home,
+  config: `${home}/.config`,
+  data: `${home}/.local/share`,
+  cache: `${home}/.cache`
+});
+/**
+ * Creates a Windows test platform.
+ */
+exports.TestPlatformLinux = TestPlatformLinux;
+const TestPlatformWindows = (home = "C:\\Users\\testuser") => TestPlatform({
+  os: "win32",
+  home,
+  config: `${home}\\AppData\\Roaming`,
+  data: `${home}\\AppData\\Local`,
+  cache: `${home}\\AppData\\Local`
+});
+exports.TestPlatformWindows = TestPlatformWindows;
+//# sourceMappingURL=TestPlatform.js.map

package/dist/cjs/platform/TestPlatform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestPlatform.js","names":["_effect","require","_Platform","TestPlatform","config","service","os","homeDir","Effect","succeed","home","configDir","dataDir","data","cacheDir","cache","Layer","Platform","exports","TestPlatformDarwin","TestPlatformLinux","TestPlatformWindows"],"sources":["../../../src/platform/TestPlatform.ts"],"sourcesContent":[null],"mappings":";;;;;;AAKA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,SAAA,GAAAD,OAAA;AANA;;;;;;AAsCA;;;;;;AAMO,MAAME,YAAY,GAAGA,CAACC,MAAA,GAA6B,EAAE,KAA2B;EACrF,MAAMC,OAAO,GAAoB;IAC/BC,EAAE,EAAEF,MAAM,CAACE,EAAE,IAAI,QAAQ;IACzBC,OAAO,EAAEC,cAAM,CAACC,OAAO,CAACL,MAAM,CAACM,IAAI,IAAI,gBAAgB,CAAC;IACxDC,SAAS,EAAEH,cAAM,CAACC,OAAO,CAACL,MAAM,CAACA,MAAM,IAAI,wBAAwB,CAAC;IACpEQ,OAAO,EAAEJ,cAAM,CAACC,OAAO,CAACL,MAAM,CAACS,IAAI,IAAI,6BAA6B,CAAC;IACrEC,QAAQ,EAAEN,cAAM,CAACC,OAAO,CAACL,MAAM,CAACW,KAAK,IAAI,uBAAuB;GACjE;EAED,OAAOC,aAAK,CAACP,OAAO,CAACQ,kBAAQ,EAAEZ,OAAO,CAAC;AACzC,CAAC;AAED;;;AAAAa,OAAA,CAAAf,YAAA,GAAAA,YAAA;AAGO,MAAMgB,kBAAkB,GAAGA,CAACT,IAAI,GAAG,iBAAiB,KACzDP,YAAY,CAAC;EACXG,EAAE,EAAE,QAAQ;EACZI,IAAI;EACJN,MAAM,EAAE,GAAGM,IAAI,UAAU;EACzBG,IAAI,EAAE,GAAGH,IAAI,8BAA8B;EAC3CK,KAAK,EAAE,GAAGL,IAAI;CACf,CAAC;AAEJ;;;AAAAQ,OAAA,CAAAC,kBAAA,GAAAA,kBAAA;AAGO,MAAMC,iBAAiB,GAAGA,CAACV,IAAI,GAAG,gBAAgB,KACvDP,YAAY,CAAC;EACXG,EAAE,EAAE,OAAO;EACXI,IAAI;EACJN,MAAM,EAAE,GAAGM,IAAI,UAAU;EACzBG,IAAI,EAAE,GAAGH,IAAI,eAAe;EAC5BK,KAAK,EAAE,GAAGL,IAAI;CACf,CAAC;AAEJ;;;AAAAQ,OAAA,CAAAE,iBAAA,GAAAA,iBAAA;AAGO,MAAMC,mBAAmB,GAAGA,CACjCX,IAAI,GAAG,qBAAqB,KAE5BP,YAAY,CAAC;EACXG,EAAE,EAAE,OAAO;EACXI,IAAI;EACJN,MAAM,EAAE,GAAGM,IAAI,oBAAoB;EACnCG,IAAI,EAAE,GAAGH,IAAI,kBAAkB;EAC/BK,KAAK,EAAE,GAAGL,IAAI;CACf,CAAC;AAAAQ,OAAA,CAAAG,mBAAA,GAAAA,mBAAA","ignoreList":[]}

package/dist/cjs/platform/index.js

@@ -0,0 +1,118 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Platform", {
+  enumerable: true,
+  get: function () {
+    return _Platform.Platform;
+  }
+});
+exports.PlatformLive = void 0;
+Object.defineProperty(exports, "TestPlatform", {
+  enumerable: true,
+  get: function () {
+    return _TestPlatform.TestPlatform;
+  }
+});
+Object.defineProperty(exports, "TestPlatformDarwin", {
+  enumerable: true,
+  get: function () {
+    return _TestPlatform.TestPlatformDarwin;
+  }
+});
+Object.defineProperty(exports, "TestPlatformLinux", {
+  enumerable: true,
+  get: function () {
+    return _TestPlatform.TestPlatformLinux;
+  }
+});
+Object.defineProperty(exports, "TestPlatformWindows", {
+  enumerable: true,
+  get: function () {
+    return _TestPlatform.TestPlatformWindows;
+  }
+});
+Object.defineProperty(exports, "withEnv", {
+  enumerable: true,
+  get: function () {
+    return _testUtils.withEnv;
+  }
+});
+Object.defineProperty(exports, "withoutEnv", {
+  enumerable: true,
+  get: function () {
+    return _testUtils.withoutEnv;
+  }
+});
+var _effect = require("effect");
+var _errors = require("../errors.js");
+var _common = require("./internal/common.js");
+var darwin = _interopRequireWildcard(require("./internal/darwin.js"));
+var linux = _interopRequireWildcard(require("./internal/linux.js"));
+var windows = _interopRequireWildcard(require("./internal/windows.js"));
+var _Platform = require("./Platform.js");
+var _testUtils = require("./internal/testUtils.js");
+var _TestPlatform = require("./TestPlatform.js");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * Platform-specific path resolution.
+ *
+ * This module provides the Platform service for resolving base configuration
+ * directories on each supported platform (macOS, Linux, Windows).
+ *
+ * @module
+ */
+
+// Re-export types and service
+
+/**
+ * Detects the current operating system.
+ */
+const detectOS = () => {
+  const platform = process.platform;
+  if (platform === "darwin" || platform === "linux" || platform === "win32") {
+    return platform;
+  }
+  throw new _errors.UnsupportedPlatformError();
+};
+/**
+ * Creates a platform service for the current OS.
+ */
+const createPlatformService = () => {
+  const os = detectOS();
+  switch (os) {
+    case "darwin":
+      return {
+        os,
+        homeDir: _common.homeDir,
+        configDir: darwin.configDir,
+        dataDir: darwin.dataDir,
+        cacheDir: darwin.cacheDir
+      };
+    case "linux":
+      return {
+        os,
+        homeDir: _common.homeDir,
+        configDir: linux.configDir,
+        dataDir: linux.dataDir,
+        cacheDir: linux.cacheDir
+      };
+    case "win32":
+      return {
+        os,
+        homeDir: _common.homeDir,
+        configDir: windows.configDir,
+        dataDir: windows.dataDir,
+        cacheDir: windows.cacheDir
+      };
+  }
+};
+/**
+ * Live platform layer that uses the actual system paths.
+ *
+ * Uses runtime platform detection to select the appropriate implementation.
+ */
+const PlatformLive = exports.PlatformLive = /*#__PURE__*/_effect.Layer.sync(_Platform.Platform, createPlatformService);
+//# sourceMappingURL=index.js.map

package/dist/cjs/platform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_effect","require","_errors","_common","darwin","_interopRequireWildcard","linux","windows","_Platform","_testUtils","_TestPlatform","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","detectOS","platform","process","UnsupportedPlatformError","createPlatformService","os","homeDir","configDir","dataDir","cacheDir","PlatformLive","exports","Layer","sync","Platform"],"sources":["../../../src/platform/index.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.joinPath = exports.isAbsolute = exports.homeDir = void 0;
+var _effect = require("effect");
+var os = _interopRequireWildcard(require("node:os"));
+var path = _interopRequireWildcard(require("node:path"));
+var _errors = require("../../errors.js");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * Common platform utilities.
+ *
+ * @module
+ */
+
+/**
+ * Returns the user's home directory.
+ */
+const homeDir = exports.homeDir = /*#__PURE__*/_effect.Effect.sync(() => {
+  const home = os.homedir();
+  if (!home) {
+    return _effect.Effect.fail(new _errors.NotFoundError({
+      message: "home directory"
+    }));
+  }
+  return _effect.Effect.succeed(home);
+}).pipe(_effect.Effect.flatten);
+/**
+ * Joins path segments.
+ */
+const joinPath = (...segments) => path.join(...segments);
+/**
+ * Checks if a path is absolute.
+ */
+exports.joinPath = joinPath;
+const isAbsolute = p => path.isAbsolute(p);
+exports.isAbsolute = isAbsolute;
+//# sourceMappingURL=common.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","names":["_effect","require","os","_interopRequireWildcard","path","_errors","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","homeDir","exports","Effect","sync","home","homedir","fail","NotFoundError","message","succeed","pipe","flatten","joinPath","segments","join","isAbsolute","p"],"sources":["../../../../src/platform/internal/common.ts"],"sourcesContent":[null],"mappings":";;;;;;AAKA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,EAAA,GAAAC,uBAAA,CAAAF,OAAA;AACA,IAAAG,IAAA,GAAAD,uBAAA,CAAAF,OAAA;AACA,IAAAI,OAAA,GAAAJ,OAAA;AAA+C,SAAAE,wBAAAG,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAL,uBAAA,YAAAA,CAAAG,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAR/C;;;;;;AAUA;;;AAGO,MAAMkB,OAAO,GAAAC,OAAA,CAAAD,OAAA,gBAAGE,cAAM,CAACC,IAAI,CAAC,MAAK;EACtC,MAAMC,IAAI,GAAG3B,EAAE,CAAC4B,OAAO,EAAE;EACzB,IAAI,CAACD,IAAI,EAAE;IACT,OAAOF,cAAM,CAACI,IAAI,CAAC,IAAIC,qBAAa,CAAC;MAAEC,OAAO,EAAE;IAAgB,CAAE,CAAC,CAAC;EACtE;EACA,OAAON,cAAM,CAACO,OAAO,CAACL,IAAI,CAAC;AAC7B,CAAC,CAAC,CAACM,IAAI,CAACR,cAAM,CAACS,OAAO,CAAC;AAEvB;;;AAGO,MAAMC,QAAQ,GAAGA,CAAC,GAAGC,QAAuB,KAAalC,IAAI,CAACmC,IAAI,CAAC,GAAGD,QAAQ,CAAC;AAEtF;;;AAAAZ,OAAA,CAAAW,QAAA,GAAAA,QAAA;AAGO,MAAMG,UAAU,GAAIC,CAAS,IAAcrC,IAAI,CAACoC,UAAU,CAACC,CAAC,CAAC;AAAAf,OAAA,CAAAc,UAAA,GAAAA,UAAA","ignoreList":[]}

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

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.dataDir = exports.configDir = exports.cacheDir = exports.applicationSupportDir = void 0;
+var _effect = require("effect");
+var _common = require("./common.js");
+/**
+ * macOS-specific path resolution.
+ *
+ * @module
+ */
+
+/**
+ * Returns the user's config directory on macOS.
+ *
+ * Most CLI tools use `~/.config/` following XDG conventions,
+ * though native macOS apps prefer `~/Library/Application Support/`.
+ */
+const configDir = exports.configDir = /*#__PURE__*/_effect.Effect.map(_common.homeDir, home => (0, _common.joinPath)(home, ".config"));
+/**
+ * Returns the user's data directory on macOS.
+ *
+ * Returns `~/Library/Application Support/` for native macOS conventions.
+ */
+const dataDir = exports.dataDir = /*#__PURE__*/_effect.Effect.map(_common.homeDir, home => (0, _common.joinPath)(home, "Library", "Application Support"));
+/**
+ * Returns the Application Support directory on macOS.
+ *
+ * This is `~/Library/Application Support/`, used by native macOS applications.
+ */
+const applicationSupportDir = exports.applicationSupportDir = dataDir;
+/**
+ * Returns the cache directory on macOS.
+ *
+ * On macOS, we use the data directory as there's no standard XDG cache.
+ */
+const cacheDir = exports.cacheDir = dataDir;
+//# sourceMappingURL=darwin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"darwin.js","names":["_effect","require","_common","configDir","exports","Effect","map","homeDir","home","joinPath","dataDir","applicationSupportDir","cacheDir"],"sources":["../../../../src/platform/internal/darwin.ts"],"sourcesContent":[null],"mappings":";;;;;;AAKA,IAAAA,OAAA,GAAAC,OAAA;AAEA,IAAAC,OAAA,GAAAD,OAAA;AAPA;;;;;;AASA;;;;;;AAMO,MAAME,SAAS,GAAAC,OAAA,CAAAD,SAAA,gBAAyCE,cAAM,CAACC,GAAG,CACvEC,eAAO,EACNC,IAAI,IAAK,IAAAC,gBAAQ,EAACD,IAAI,EAAE,SAAS,CAAC,CACpC;AAED;;;;;AAKO,MAAME,OAAO,GAAAN,OAAA,CAAAM,OAAA,gBAAyCL,cAAM,CAACC,GAAG,CACrEC,eAAO,EACNC,IAAI,IAAK,IAAAC,gBAAQ,EAACD,IAAI,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAC3D;AAED;;;;;AAKO,MAAMG,qBAAqB,GAAAP,OAAA,CAAAO,qBAAA,GAAyCD,OAAO;AAElF;;;;;AAKO,MAAME,QAAQ,GAAAR,OAAA,CAAAQ,QAAA,GAAyCF,OAAO","ignoreList":[]}

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

@@ -0,0 +1,69 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.dataDir = exports.configDir = exports.cacheDir = void 0;
+var _effect = require("effect");
+var _common = require("./common.js");
+/**
+ * Linux-specific path resolution with XDG Base Directory support.
+ *
+ * @module
+ */
+
+/**
+ * Gets an XDG path if the environment variable is set and valid.
+ *
+ * Returns None if:
+ * - The environment variable is not set
+ * - The value is empty
+ * - The path is not absolute
+ */
+const xdgPathIfValid = varName => {
+  const value = process.env[varName];
+  if (value && value.length > 0 && (0, _common.isAbsolute)(value)) {
+    return _effect.Option.some(value);
+  }
+  return _effect.Option.none();
+};
+/**
+ * Returns the user's config directory on Linux.
+ *
+ * Respects `XDG_CONFIG_HOME` if set to an absolute path,
+ * otherwise defaults to `~/.config/`.
+ */
+const configDir = exports.configDir = /*#__PURE__*/_effect.Effect.suspend(() => {
+  const xdgPath = xdgPathIfValid("XDG_CONFIG_HOME");
+  if (_effect.Option.isSome(xdgPath)) {
+    return _effect.Effect.succeed(xdgPath.value);
+  }
+  return _effect.Effect.map(_common.homeDir, home => (0, _common.joinPath)(home, ".config"));
+});
+/**
+ * Returns the user's data directory on Linux.
+ *
+ * Respects `XDG_DATA_HOME` if set to an absolute path,
+ * otherwise defaults to `~/.local/share/`.
+ */
+const dataDir = exports.dataDir = /*#__PURE__*/_effect.Effect.suspend(() => {
+  const xdgPath = xdgPathIfValid("XDG_DATA_HOME");
+  if (_effect.Option.isSome(xdgPath)) {
+    return _effect.Effect.succeed(xdgPath.value);
+  }
+  return _effect.Effect.map(_common.homeDir, home => (0, _common.joinPath)(home, ".local", "share"));
+});
+/**
+ * Returns the user's cache directory on Linux.
+ *
+ * Respects `XDG_CACHE_HOME` if set to an absolute path,
+ * otherwise defaults to `~/.cache/`.
+ */
+const cacheDir = exports.cacheDir = /*#__PURE__*/_effect.Effect.suspend(() => {
+  const xdgPath = xdgPathIfValid("XDG_CACHE_HOME");
+  if (_effect.Option.isSome(xdgPath)) {
+    return _effect.Effect.succeed(xdgPath.value);
+  }
+  return _effect.Effect.map(_common.homeDir, home => (0, _common.joinPath)(home, ".cache"));
+});
+//# sourceMappingURL=linux.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linux.js","names":["_effect","require","_common","xdgPathIfValid","varName","value","process","env","length","isAbsolute","Option","some","none","configDir","exports","Effect","suspend","xdgPath","isSome","succeed","map","homeDir","home","joinPath","dataDir","cacheDir"],"sources":["../../../../src/platform/internal/linux.ts"],"sourcesContent":[null],"mappings":";;;;;;AAKA,IAAAA,OAAA,GAAAC,OAAA;AAEA,IAAAC,OAAA,GAAAD,OAAA;AAPA;;;;;;AASA;;;;;;;;AAQA,MAAME,cAAc,GAAIC,OAAe,IAA2B;EAChE,MAAMC,KAAK,GAAGC,OAAO,CAACC,GAAG,CAACH,OAAO,CAAC;EAClC,IAAIC,KAAK,IAAIA,KAAK,CAACG,MAAM,GAAG,CAAC,IAAI,IAAAC,kBAAU,EAACJ,KAAK,CAAC,EAAE;IAClD,OAAOK,cAAM,CAACC,IAAI,CAACN,KAAK,CAAC;EAC3B;EACA,OAAOK,cAAM,CAACE,IAAI,EAAE;AACtB,CAAC;AAED;;;;;;AAMO,MAAMC,SAAS,GAAAC,OAAA,CAAAD,SAAA,gBAAyCE,cAAM,CAACC,OAAO,CAAC,MAAK;EACjF,MAAMC,OAAO,GAAGd,cAAc,CAAC,iBAAiB,CAAC;EACjD,IAAIO,cAAM,CAACQ,MAAM,CAACD,OAAO,CAAC,EAAE;IAC1B,OAAOF,cAAM,CAACI,OAAO,CAACF,OAAO,CAACZ,KAAK,CAAC;EACtC;EACA,OAAOU,cAAM,CAACK,GAAG,CAACC,eAAO,EAAGC,IAAI,IAAK,IAAAC,gBAAQ,EAACD,IAAI,EAAE,SAAS,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF;;;;;;AAMO,MAAME,OAAO,GAAAV,OAAA,CAAAU,OAAA,gBAAyCT,cAAM,CAACC,OAAO,CAAC,MAAK;EAC/E,MAAMC,OAAO,GAAGd,cAAc,CAAC,eAAe,CAAC;EAC/C,IAAIO,cAAM,CAACQ,MAAM,CAACD,OAAO,CAAC,EAAE;IAC1B,OAAOF,cAAM,CAACI,OAAO,CAACF,OAAO,CAACZ,KAAK,CAAC;EACtC;EACA,OAAOU,cAAM,CAACK,GAAG,CAACC,eAAO,EAAGC,IAAI,IAAK,IAAAC,gBAAQ,EAACD,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC,CAAC;AAEF;;;;;;AAMO,MAAMG,QAAQ,GAAAX,OAAA,CAAAW,QAAA,gBAAyCV,cAAM,CAACC,OAAO,CAAC,MAAK;EAChF,MAAMC,OAAO,GAAGd,cAAc,CAAC,gBAAgB,CAAC;EAChD,IAAIO,cAAM,CAACQ,MAAM,CAACD,OAAO,CAAC,EAAE;IAC1B,OAAOF,cAAM,CAACI,OAAO,CAACF,OAAO,CAACZ,KAAK,CAAC;EACtC;EACA,OAAOU,cAAM,CAACK,GAAG,CAACC,eAAO,EAAGC,IAAI,IAAK,IAAAC,gBAAQ,EAACD,IAAI,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC,CAAC","ignoreList":[]}