agent-config-detect 0.0.0

package/dist/esm/types/Scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scope.js","names":["Data","Schema","Global","TaggedClass","Project","Custom","Scope","Union","TaggedStruct","path","String","global","project","custom"],"sources":["../../../src/types/Scope.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;AAQA,SAASA,IAAI,EAAEC,MAAM,QAAQ,QAAQ;AAErC;;;AAGA,OAAM,MAAOC,MAAO,sBAAQF,IAAI,CAACG,WAAW,CAAC,QAAQ,CAAK;AAE1D;;;AAGA,OAAM,MAAOC,OAAQ,sBAAQJ,IAAI,CAACG,WAAW,CAAC,SAAS,CAErD;AAEF;;;AAGA,OAAM,MAAOE,MAAO,sBAAQL,IAAI,CAACG,WAAW,CAAC,QAAQ,CAEnD;AAOF;;;AAGA,OAAO,MAAMG,KAAK,gBAAyBL,MAAM,CAACM,KAAK,cACrDN,MAAM,CAACO,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,eACjCP,MAAM,CAACO,YAAY,CAAC,SAAS,EAAE;EAAEC,IAAI,EAAER,MAAM,CAACS;AAAM,CAAE,CAAC,eACvDT,MAAM,CAACO,YAAY,CAAC,QAAQ,EAAE;EAAEC,IAAI,EAAER,MAAM,CAACS;AAAM,CAAE,CAAC,CAC/B;AAEzB;;;AAGA,OAAO,MAAMC,MAAM,GAAGA,CAAA,KAAa,IAAIT,MAAM,EAAE;AAE/C;;;AAGA,OAAO,MAAMU,OAAO,GAAIH,IAAY,IAAY,IAAIL,OAAO,CAAC;EAAEK;AAAI,CAAE,CAAC;AAErE;;;AAGA,OAAO,MAAMI,MAAM,GAAIJ,IAAY,IAAY,IAAIJ,MAAM,CAAC;EAAEI;AAAI,CAAE,CAAC","ignoreList":[]}

package/dist/esm/types/index.js

@@ -0,0 +1,17 @@
+/**
+ * Core type definitions for harness path resolution.
+ *
+ * @module
+ */
+// Re-export all types
+export * from "./ConfigResource.js";
+export * from "./DirectoryResource.js";
+export * from "./DirectoryStructure.js";
+export * from "./EnvValue.js";
+export * from "./FileFormat.js";
+export * from "./HarnessKind.js";
+export * from "./InstallationStatus.js";
+export * from "./PathType.js";
+export * from "./ResourceKind.js";
+export * from "./Scope.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/types/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAMA;AACA,cAAc,qBAAqB;AACnC,cAAc,wBAAwB;AACtC,cAAc,yBAAyB;AACvC,cAAc,eAAe;AAC7B,cAAc,iBAAiB;AAC/B,cAAc,kBAAkB;AAChC,cAAc,yBAAyB;AACvC,cAAc,eAAe;AAC7B,cAAc,mBAAmB;AACjC,cAAc,YAAY","ignoreList":[]}

package/errors/package.json

@@ -0,0 +1,6 @@
+{
+  "main": "../dist/cjs/errors.js",
+  "module": "../dist/esm/errors.js",
+  "types": "../dist/dts/errors.d.ts",
+  "sideEffects": []
+}

package/package.json

@@ -0,0 +1,135 @@
+{
+  "name": "agent-config-detect",
+  "version": "0.0.0",
+  "description": "Agent config detection",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AtelyPham/agent-locate-ts.git",
+    "directory": "packages/agent-config-detect"
+  },
+  "sideEffects": [],
+  "dependencies": {
+    "@effect/platform": "latest",
+    "effect": "latest"
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/dts/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/dts/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/cjs/index.js"
+    },
+    "./errors": {
+      "types": "./dist/dts/errors.d.ts",
+      "import": "./dist/esm/errors.js",
+      "default": "./dist/cjs/errors.js"
+    },
+    "./platform/Platform": {
+      "types": "./dist/dts/platform/Platform.d.ts",
+      "import": "./dist/esm/platform/Platform.js",
+      "default": "./dist/cjs/platform/Platform.js"
+    },
+    "./platform/TestPlatform": {
+      "types": "./dist/dts/platform/TestPlatform.d.ts",
+      "import": "./dist/esm/platform/TestPlatform.js",
+      "default": "./dist/cjs/platform/TestPlatform.js"
+    },
+    "./types/ConfigResource": {
+      "types": "./dist/dts/types/ConfigResource.d.ts",
+      "import": "./dist/esm/types/ConfigResource.js",
+      "default": "./dist/cjs/types/ConfigResource.js"
+    },
+    "./types/DirectoryResource": {
+      "types": "./dist/dts/types/DirectoryResource.d.ts",
+      "import": "./dist/esm/types/DirectoryResource.js",
+      "default": "./dist/cjs/types/DirectoryResource.js"
+    },
+    "./types/DirectoryStructure": {
+      "types": "./dist/dts/types/DirectoryStructure.d.ts",
+      "import": "./dist/esm/types/DirectoryStructure.js",
+      "default": "./dist/cjs/types/DirectoryStructure.js"
+    },
+    "./types/EnvValue": {
+      "types": "./dist/dts/types/EnvValue.d.ts",
+      "import": "./dist/esm/types/EnvValue.js",
+      "default": "./dist/cjs/types/EnvValue.js"
+    },
+    "./types/FileFormat": {
+      "types": "./dist/dts/types/FileFormat.d.ts",
+      "import": "./dist/esm/types/FileFormat.js",
+      "default": "./dist/cjs/types/FileFormat.js"
+    },
+    "./types/HarnessKind": {
+      "types": "./dist/dts/types/HarnessKind.d.ts",
+      "import": "./dist/esm/types/HarnessKind.js",
+      "default": "./dist/cjs/types/HarnessKind.js"
+    },
+    "./types/InstallationStatus": {
+      "types": "./dist/dts/types/InstallationStatus.d.ts",
+      "import": "./dist/esm/types/InstallationStatus.js",
+      "default": "./dist/cjs/types/InstallationStatus.js"
+    },
+    "./types/PathType": {
+      "types": "./dist/dts/types/PathType.d.ts",
+      "import": "./dist/esm/types/PathType.js",
+      "default": "./dist/cjs/types/PathType.js"
+    },
+    "./types/ResourceKind": {
+      "types": "./dist/dts/types/ResourceKind.d.ts",
+      "import": "./dist/esm/types/ResourceKind.js",
+      "default": "./dist/cjs/types/ResourceKind.js"
+    },
+    "./types/Scope": {
+      "types": "./dist/dts/types/Scope.d.ts",
+      "import": "./dist/esm/types/Scope.js",
+      "default": "./dist/cjs/types/Scope.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "errors": [
+        "./dist/dts/errors.d.ts"
+      ],
+      "platform/Platform": [
+        "./dist/dts/platform/Platform.d.ts"
+      ],
+      "platform/TestPlatform": [
+        "./dist/dts/platform/TestPlatform.d.ts"
+      ],
+      "types/ConfigResource": [
+        "./dist/dts/types/ConfigResource.d.ts"
+      ],
+      "types/DirectoryResource": [
+        "./dist/dts/types/DirectoryResource.d.ts"
+      ],
+      "types/DirectoryStructure": [
+        "./dist/dts/types/DirectoryStructure.d.ts"
+      ],
+      "types/EnvValue": [
+        "./dist/dts/types/EnvValue.d.ts"
+      ],
+      "types/FileFormat": [
+        "./dist/dts/types/FileFormat.d.ts"
+      ],
+      "types/HarnessKind": [
+        "./dist/dts/types/HarnessKind.d.ts"
+      ],
+      "types/InstallationStatus": [
+        "./dist/dts/types/InstallationStatus.d.ts"
+      ],
+      "types/PathType": [
+        "./dist/dts/types/PathType.d.ts"
+      ],
+      "types/ResourceKind": [
+        "./dist/dts/types/ResourceKind.d.ts"
+      ],
+      "types/Scope": [
+        "./dist/dts/types/Scope.d.ts"
+      ]
+    }
+  }
+}

package/platform/Platform/package.json

@@ -0,0 +1,6 @@
+{
+  "main": "../../dist/cjs/platform/Platform.js",
+  "module": "../../dist/esm/platform/Platform.js",
+  "types": "../../dist/dts/platform/Platform.d.ts",
+  "sideEffects": []
+}

package/platform/TestPlatform/package.json

@@ -0,0 +1,6 @@
+{
+  "main": "../../dist/cjs/platform/TestPlatform.js",
+  "module": "../../dist/esm/platform/TestPlatform.js",
+  "types": "../../dist/dts/platform/TestPlatform.d.ts",
+  "sideEffects": []
+}

package/src/errors.ts

@@ -0,0 +1,135 @@
+/**
+ * Error types for harness operations.
+ *
+ * @module
+ */
+import { Data } from "effect"
+
+/**
+ * The requested harness was not found on this system.
+ */
+export class NotFoundError extends Data.TaggedError("NotFoundError")<{
+  readonly message: string
+}> {}
+
+/**
+ * The path is invalid or inaccessible.
+ */
+export class InvalidPathError extends Data.TaggedError("InvalidPathError")<{
+  readonly path: string
+}> {
+  get message() {
+    return `invalid path: ${this.path}`
+  }
+}
+
+/**
+ * An environment variable could not be read.
+ */
+export class EnvVarError extends Data.TaggedError("EnvVarError")<{
+  readonly cause: Error
+}> {
+  get message() {
+    return `environment variable error: ${this.cause.message}`
+  }
+}
+
+/**
+ * The current platform is not supported.
+ */
+export class UnsupportedPlatformError extends Data.TaggedError("UnsupportedPlatformError")<{}> {
+  get message() {
+    return "unsupported platform"
+  }
+}
+
+/**
+ * An I/O error occurred.
+ */
+export class IoError extends Data.TaggedError("IoError")<{
+  readonly cause: Error
+}> {
+  get message() {
+    return `IO error: ${this.cause.message}`
+  }
+}
+
+/**
+ * MCP server uses unsupported features for target harness.
+ */
+export class UnsupportedMcpConfigError extends Data.TaggedError("UnsupportedMcpConfigError")<{
+  readonly harness: string
+  readonly reason: string
+}> {
+  get message() {
+    return `unsupported MCP config for ${this.harness}: ${this.reason}`
+  }
+}
+
+/**
+ * Binary detection failed due to system error.
+ */
+export class BinaryDetectionError extends Data.TaggedError("BinaryDetectionError")<{
+  readonly message: string
+}> {}
+
+/**
+ * The requested scope is not supported by this harness.
+ */
+export class UnsupportedScopeError extends Data.TaggedError("UnsupportedScopeError")<{
+  readonly harness: string
+  readonly scope: string
+}> {
+  get message() {
+    return `${this.harness} does not support ${this.scope} scope`
+  }
+}
+
+/**
+ * YAML parsing failed.
+ */
+export class YamlParseError extends Data.TaggedError("YamlParseError")<{
+  readonly cause: Error
+}> {
+  get message() {
+    return `YAML parse error: ${this.cause.message}`
+  }
+}
+
+/**
+ * A required field is missing from the input.
+ */
+export class MissingFieldError extends Data.TaggedError("MissingFieldError")<{
+  readonly field: string
+}> {
+  get message() {
+    return `missing required field: ${this.field}`
+  }
+}
+
+/**
+ * An environment variable referenced by EnvValue is not set.
+ */
+export class MissingEnvVarError extends Data.TaggedError("MissingEnvVarError")<{
+  readonly name: string
+}> {
+  get message() {
+    return `missing environment variable: ${this.name}`
+  }
+}
+
+/**
+ * Union of all platform errors.
+ */
+export type PlatformError =
+  | NotFoundError
+  | InvalidPathError
+  | EnvVarError
+  | UnsupportedPlatformError
+  | IoError
+  | UnsupportedMcpConfigError
+  | BinaryDetectionError
+  | UnsupportedScopeError
+  | YamlParseError
+  | MissingFieldError
+  | MissingEnvVarError

package/src/index.ts

@@ -0,0 +1,27 @@
+/**
+ * Agent config detection library.
+ *
+ * Port of harness-locate Rust crate to TypeScript + Effect.
+ *
+ * @module
+ */
+
+// Types
+export * from "./types/index.js"
+
+// Errors
+export * from "./errors.js"
+
+// Platform
+export {
+  type OS,
+  Platform,
+  PlatformLive,
+  type PlatformService,
+  TestPlatform,
+  TestPlatformDarwin,
+  TestPlatformLinux,
+  TestPlatformWindows,
+  withEnv,
+  withoutEnv
+} from "./platform/index.js"

package/src/platform/Platform.ts

@@ -0,0 +1,64 @@
+/**
+ * Platform service interface for cross-platform path resolution.
+ *
+ * @module
+ */
+import type { Effect } from "effect"
+import { Context } from "effect"
+import type { PlatformError } from "../errors.js"
+
+/**
+ * Supported operating systems.
+ */
+export type OS = "darwin" | "linux" | "win32"
+
+/**
+ * Platform service interface.
+ *
+ * Provides platform-specific directory resolution.
+ */
+export interface PlatformService {
+  /**
+   * The current operating system.
+   */
+  readonly os: OS
+
+  /**
+   * Returns the user's home directory.
+   */
+  readonly homeDir: Effect.Effect<string, PlatformError>
+
+  /**
+   * Returns the user's config directory.
+   *
+   * Platform-specific behavior:
+   * - **macOS**: `~/.config/`
+   * - **Linux**: `$XDG_CONFIG_HOME` or `~/.config/`
+   * - **Windows**: `%APPDATA%`
+   */
+  readonly configDir: Effect.Effect<string, PlatformError>
+
+  /**
+   * Returns the user's data directory.
+   *
+   * Platform-specific behavior:
+   * - **macOS**: `~/Library/Application Support/`
+   * - **Linux**: `$XDG_DATA_HOME` or `~/.local/share/`
+   * - **Windows**: `%LOCALAPPDATA%`
+   */
+  readonly dataDir: Effect.Effect<string, PlatformError>
+
+  /**
+   * Returns the user's cache directory (Linux-specific, optional elsewhere).
+   *
+   * Platform-specific behavior:
+   * - **Linux**: `$XDG_CACHE_HOME` or `~/.cache/`
+   * - **macOS/Windows**: Same as dataDir
+   */
+  readonly cacheDir: Effect.Effect<string, PlatformError>
+}
+
+/**
+ * Platform service tag.
+ */
+export class Platform extends Context.Tag("Platform")<Platform, PlatformService>() {}

package/src/platform/TestPlatform.ts

@@ -0,0 +1,93 @@
+/**
+ * Test platform layer for mocking in tests.
+ *
+ * @module
+ */
+import { Effect, Layer } from "effect"
+import { type OS, Platform, type PlatformService } from "./Platform.js"
+
+/**
+ * Configuration for creating a test platform.
+ */
+export interface TestPlatformConfig {
+  /**
+   * The OS to simulate.
+   */
+  readonly os?: OS
+
+  /**
+   * The home directory path.
+   */
+  readonly home?: string
+
+  /**
+   * The config directory path.
+   */
+  readonly config?: string
+
+  /**
+   * The data directory path.
+   */
+  readonly data?: string
+
+  /**
+   * The cache directory path.
+   */
+  readonly cache?: string
+}
+
+/**
+ * Creates a test platform layer with the given configuration.
+ *
+ * Useful for testing platform-dependent code without relying on
+ * the actual filesystem or environment.
+ */
+export const TestPlatform = (config: TestPlatformConfig = {}): Layer.Layer<Platform> => {
+  const service: PlatformService = {
+    os: config.os ?? "darwin",
+    homeDir: Effect.succeed(config.home ?? "/home/testuser"),
+    configDir: Effect.succeed(config.config ?? "/home/testuser/.config"),
+    dataDir: Effect.succeed(config.data ?? "/home/testuser/.local/share"),
+    cacheDir: Effect.succeed(config.cache ?? "/home/testuser/.cache")
+  }
+
+  return Layer.succeed(Platform, service)
+}
+
+/**
+ * Creates a macOS test platform.
+ */
+export const TestPlatformDarwin = (home = "/Users/testuser"): Layer.Layer<Platform> =>
+  TestPlatform({
+    os: "darwin",
+    home,
+    config: `${home}/.config`,
+    data: `${home}/Library/Application Support`,
+    cache: `${home}/Library/Application Support`
+  })
+
+/**
+ * Creates a Linux test platform.
+ */
+export const TestPlatformLinux = (home = "/home/testuser"): Layer.Layer<Platform> =>
+  TestPlatform({
+    os: "linux",
+    home,
+    config: `${home}/.config`,
+    data: `${home}/.local/share`,
+    cache: `${home}/.cache`
+  })
+
+/**
+ * Creates a Windows test platform.
+ */
+export const TestPlatformWindows = (
+  home = "C:\\Users\\testuser"
+): Layer.Layer<Platform> =>
+  TestPlatform({
+    os: "win32",
+    home,
+    config: `${home}\\AppData\\Roaming`,
+    data: `${home}\\AppData\\Local`,
+    cache: `${home}\\AppData\\Local`
+  })

package/src/platform/index.ts

@@ -0,0 +1,72 @@
+/**
+ * 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 { UnsupportedPlatformError } from "../errors.js"
+import { homeDir } from "./internal/common.js"
+import * as darwin from "./internal/darwin.js"
+import * as linux from "./internal/linux.js"
+import * as windows from "./internal/windows.js"
+import { type OS, Platform, type PlatformService } from "./Platform.js"
+
+// Re-export types and service
+export { withEnv, withoutEnv } from "./internal/testUtils.js"
+export { type OS, Platform, type PlatformService } from "./Platform.js"
+export { TestPlatform, TestPlatformDarwin, TestPlatformLinux, TestPlatformWindows } from "./TestPlatform.js"
+
+/**
+ * Detects the current operating system.
+ */
+const detectOS = (): OS => {
+  const platform = process.platform
+  if (platform === "darwin" || platform === "linux" || platform === "win32") {
+    return platform
+  }
+  throw new UnsupportedPlatformError()
+}
+
+/**
+ * Creates a platform service for the current OS.
+ */
+const createPlatformService = (): PlatformService => {
+  const os = detectOS()
+
+  switch (os) {
+    case "darwin":
+      return {
+        os,
+        homeDir,
+        configDir: darwin.configDir,
+        dataDir: darwin.dataDir,
+        cacheDir: darwin.cacheDir
+      }
+    case "linux":
+      return {
+        os,
+        homeDir,
+        configDir: linux.configDir,
+        dataDir: linux.dataDir,
+        cacheDir: linux.cacheDir
+      }
+    case "win32":
+      return {
+        os,
+        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.
+ */
+export const PlatformLive: Layer.Layer<Platform> = Layer.sync(Platform, createPlatformService)

package/src/platform/internal/common.ts

@@ -0,0 +1,30 @@
+/**
+ * Common platform utilities.
+ *
+ * @module
+ */
+import { Effect } from "effect"
+import * as os from "node:os"
+import * as path from "node:path"
+import { NotFoundError } from "../../errors.js"
+
+/**
+ * Returns the user's home directory.
+ */
+export const homeDir = Effect.sync(() => {
+  const home = os.homedir()
+  if (!home) {
+    return Effect.fail(new NotFoundError({ message: "home directory" }))
+  }
+  return Effect.succeed(home)
+}).pipe(Effect.flatten)
+
+/**
+ * Joins path segments.
+ */
+export const joinPath = (...segments: Array<string>): string => path.join(...segments)
+
+/**
+ * Checks if a path is absolute.
+ */
+export const isAbsolute = (p: string): boolean => path.isAbsolute(p)

package/src/platform/internal/darwin.ts

@@ -0,0 +1,43 @@
+/**
+ * macOS-specific path resolution.
+ *
+ * @module
+ */
+import { Effect } from "effect"
+import type { PlatformError } from "../../errors.js"
+import { homeDir, joinPath } from "./common.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 const configDir: Effect.Effect<string, PlatformError> = Effect.map(
+  homeDir,
+  (home) => joinPath(home, ".config")
+)
+
+/**
+ * Returns the user's data directory on macOS.
+ *
+ * Returns `~/Library/Application Support/` for native macOS conventions.
+ */
+export const dataDir: Effect.Effect<string, PlatformError> = Effect.map(
+  homeDir,
+  (home) => joinPath(home, "Library", "Application Support")
+)
+
+/**
+ * Returns the Application Support directory on macOS.
+ *
+ * This is `~/Library/Application Support/`, used by native macOS applications.
+ */
+export const applicationSupportDir: Effect.Effect<string, PlatformError> = dataDir
+
+/**
+ * Returns the cache directory on macOS.
+ *
+ * On macOS, we use the data directory as there's no standard XDG cache.
+ */
+export const cacheDir: Effect.Effect<string, PlatformError> = dataDir