@agenthippo-ai/agenthippo 0.1.0

package/out/utils/agentEnvFile.js

@@ -0,0 +1,131 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) AgentHippo.ai. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GATEWAY_SECRET_ENV_KEYS = void 0;
+exports.getAgentHomeEnvFilePath = getAgentHomeEnvFilePath;
+exports.parseEnvContent = parseEnvContent;
+exports.readAgentHomeEnvFile = readAgentHomeEnvFile;
+exports.mergeEnvIntoProcessEnv = mergeEnvIntoProcessEnv;
+exports.mergeAgentHomeEnvIntoProcessEnv = mergeAgentHomeEnvIntoProcessEnv;
+exports.buildGatewayChildProcessEnv = buildGatewayChildProcessEnv;
+exports.readGatewayChildProcessEnv = readGatewayChildProcessEnv;
+const fs_1 = require("fs");
+const paths_1 = require("./paths");
+/**
+ * Default path for user-level secrets and engine env vars (~/.agent-hippo/.env).
+ */
+function getAgentHomeEnvFilePath() {
+    return (0, paths_1.getAgentidePath)('.env');
+}
+/**
+ * Parse .env file content into key-value pairs.
+ *
+ * Supports KEY=value, quoted values, # comments, and empty lines.
+ */
+/* eslint-disable local/code-no-unexternalized-strings -- .env parsing tokens are not user-facing. */
+function parseEnvContent(content) {
+    const result = {};
+    const lines = content.split(/\r?\n/);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        const eqIndex = trimmed.indexOf('=');
+        if (eqIndex === -1) {
+            continue;
+        }
+        const key = trimmed.slice(0, eqIndex).trim();
+        let value = trimmed.slice(eqIndex + 1).trim();
+        const isDoubleQuoted = value.length >= 2 && value.startsWith('"') && value.endsWith('"');
+        const isSingleQuoted = value.length >= 2 && value.startsWith("'") && value.endsWith("'");
+        if (isDoubleQuoted || isSingleQuoted) {
+            value = value.slice(1, -1);
+        }
+        if (isDoubleQuoted) {
+            value = value
+                .replace(/\\n/g, '\n')
+                .replace(/\\r/g, '\r')
+                .replace(/\\t/g, '\t')
+                .replace(/\\\\/g, '\\');
+        }
+        if (key) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/* eslint-enable local/code-no-unexternalized-strings */
+/**
+ * Read and parse the AgentHippo home .env file. Missing file returns {}.
+ */
+async function readAgentHomeEnvFile(envFilePath = getAgentHomeEnvFilePath()) {
+    try {
+        const content = await fs_1.promises.readFile(envFilePath, 'utf-8');
+        return parseEnvContent(content);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Merge env vars into process.env without overwriting keys already set in the shell.
+ */
+function mergeEnvIntoProcessEnv(fromFile, target = process.env) {
+    const applied = [];
+    const skipped = [];
+    for (const [key, value] of Object.entries(fromFile)) {
+        if (!key) {
+            continue;
+        }
+        if (Object.prototype.hasOwnProperty.call(target, key)) {
+            skipped.push(key);
+            continue;
+        }
+        target[key] = value;
+        applied.push(key);
+    }
+    return { applied, skipped };
+}
+/**
+ * Load ~/.agent-hippo/.env into the extension host process.env (merge only).
+ * Lets custom engines read apiKeyEnvVar values without per-engine IDE allowlists.
+ */
+async function mergeAgentHomeEnvIntoProcessEnv(envFilePath = getAgentHomeEnvFilePath()) {
+    const parsed = await readAgentHomeEnvFile(envFilePath);
+    const result = mergeEnvIntoProcessEnv(parsed);
+    return { ...result, envFilePath };
+}
+/**
+ * Managed gateway secret keys. The IDE owns these in ~/.agent-hippo/.env, so the file is the
+ * source of truth: a fresh file value must win over the stale snapshot cached in process.env at
+ * activation (otherwise rotating Slack apps keeps the gateway authenticating as the old app).
+ */
+exports.GATEWAY_SECRET_ENV_KEYS = ['SLACK_BOT_TOKEN', 'SLACK_APP_TOKEN', 'OPENCLAW_GATEWAY_TOKEN'];
+/**
+ * Build env for gateway child processes. Fills keys from ~/.agent-hippo/.env when the
+ * extension host has them unset or empty (GUI apps often lack shell-exported secrets).
+ *
+ * For `overlayKeys` (managed gateway secrets), a non-empty file value always wins over the
+ * cached process.env value so token rotations take effect on the next gateway (re)start.
+ */
+function buildGatewayChildProcessEnv(base, fromFile, overlayKeys = exports.GATEWAY_SECRET_ENV_KEYS) {
+    const env = { ...base };
+    const overlay = new Set(overlayKeys);
+    for (const [key, value] of Object.entries(fromFile)) {
+        if (!key || !value.trim()) {
+            continue;
+        }
+        const existing = env[key];
+        if (overlay.has(key) || existing === undefined || existing === '') {
+            env[key] = value;
+        }
+    }
+    return env;
+}
+async function readGatewayChildProcessEnv(envFilePath = getAgentHomeEnvFilePath()) {
+    const fromFile = await readAgentHomeEnvFile(envFilePath);
+    return buildGatewayChildProcessEnv(process.env, fromFile);
+}

package/out/utils/binary.js

@@ -0,0 +1,175 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Binary Finder Utilities
+ *
+ *  Shared utilities for finding binaries on PATH with caching.
+ *  Cost: ~50-100ms for shell commands, cached for 60 seconds.
+ *
+ *  Used by:
+ *  - Gateway lifecycle manager (Agent Anywhere)
+ *--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findBinary = findBinary;
+exports.findBinaryCached = findBinaryCached;
+exports.getCommonBinaryPaths = getCommonBinaryPaths;
+exports.clearBinaryCache = clearBinaryCache;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const fs_1 = require("fs");
+const fsSync = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+const IS_WINDOWS = process.platform === 'win32';
+/** Default cache TTL for binary paths (avoid repeated `which` calls) */
+const DEFAULT_CACHE_TTL_MS = 60_000;
+/** Binary path cache */
+const binaryCache = new Map();
+/**
+ * Find a binary on PATH (cross-platform).
+ * Uses `which` on Unix and `where` on Windows.
+ *
+ * @param name - Binary name to find
+ * @param timeout - Execution timeout in ms (default: 5000)
+ * @returns Path to the binary or undefined if not found
+ */
+async function findBinary(name, timeout = 5_000) {
+    try {
+        const cmd = IS_WINDOWS ? `where ${name}` : `which ${name}`;
+        const { stdout } = await execAsync(cmd, { timeout });
+        const result = stdout.trim().split('\n')[0];
+        return result || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Find a binary with caching to avoid repeated `which`/`where` calls.
+ *
+ * @param name - Binary name to find
+ * @param commonPaths - Additional paths to check if not found on PATH
+ * @param cacheTtlMs - Cache TTL in milliseconds (default: 60000)
+ * @returns Path to the binary or undefined if not found
+ */
+async function findBinaryCached(name, commonPaths = [], cacheTtlMs = DEFAULT_CACHE_TTL_MS) {
+    const now = Date.now();
+    const cached = binaryCache.get(name);
+    // Return cached value if still valid
+    if (cached && now - cached.timestamp < cacheTtlMs) {
+        return cached.path;
+    }
+    // Try to find on PATH first
+    let binaryPath = await findBinary(name);
+    // If not on PATH, check common install locations
+    if (!binaryPath) {
+        for (const candidate of commonPaths) {
+            try {
+                await fs_1.promises.access(candidate, IS_WINDOWS ? fsSync.constants.F_OK : fsSync.constants.X_OK);
+                binaryPath = candidate;
+                break;
+            }
+            catch {
+                // Not found at this path
+            }
+        }
+    }
+    // Update cache (even if undefined, to avoid repeated failed lookups)
+    binaryCache.set(name, { path: binaryPath, timestamp: now });
+    return binaryPath;
+}
+/**
+ * Get common install paths for a binary based on platform.
+ *
+ * @param name - Binary name
+ * @returns Array of common paths to check
+ */
+function getCommonBinaryPaths(name) {
+    const home = os.homedir();
+    const bin = IS_WINDOWS ? `${name}.cmd` : name;
+    if (IS_WINDOWS) {
+        const localAppData = process.env.LOCALAPPDATA || path.join(home, 'AppData', 'Local');
+        return [
+            path.join(localAppData, 'AgentHippo', 'bin', bin), // Agent Anywhere managed wrapper
+            path.join(home, 'AppData', 'Local', 'Programs', name, `${name}.exe`), // zip bundle installer default
+            path.join(home, 'AppData', 'Roaming', 'npm', bin), // npm global (Windows)
+            path.join(home, 'AppData', 'Local', 'pnpm', bin), // pnpm global (Windows)
+            path.join(home, '.npm-global', bin), // npm global custom prefix
+        ];
+    }
+    const paths = [
+        path.join(home, '.local', 'bin', name), // Agent Anywhere managed wrapper
+        path.join(home, 'Library', 'pnpm', name), // pnpm global (macOS)
+        path.join(home, '.local', 'share', 'pnpm', name), // pnpm global (Linux)
+        path.join(home, '.npm-global', 'bin', name), // npm global custom
+        '/opt/homebrew/bin/' + name, // Homebrew (Apple Silicon)
+        '/usr/local/bin/' + name, // Homebrew (Intel) / manual
+        '/usr/bin/' + name, // System install
+    ];
+    // VS Code's extension host often lacks nvm/fnm on PATH; scan common Node version managers.
+    const nvmDir = process.env.NVM_DIR || path.join(home, '.nvm');
+    const nvmVersionsDir = path.join(nvmDir, 'versions', 'node');
+    if (fsSync.existsSync(nvmVersionsDir)) {
+        try {
+            const versions = fsSync
+                .readdirSync(nvmVersionsDir, { withFileTypes: true })
+                .filter((d) => d.isDirectory())
+                .map((d) => d.name)
+                .sort()
+                .reverse();
+            for (const version of versions) {
+                paths.push(path.join(nvmVersionsDir, version, 'bin', name));
+            }
+        }
+        catch {
+            // ignore nvm directory read errors
+        }
+    }
+    return paths;
+}
+/**
+ * Clear the binary cache (useful for testing or after install).
+ *
+ * @param name - Optional binary name to clear; if omitted, clears all
+ */
+function clearBinaryCache(name) {
+    if (name) {
+        binaryCache.delete(name);
+    }
+    else {
+        binaryCache.clear();
+    }
+}

package/out/utils/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Shared Utilities Index
+ *
+ *  Re-exports all shared utilities for convenient imports.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prependPathDir = exports.getNodeBinaryCandidates = exports.resolveNodeBinary = exports.clearBinaryCache = exports.getCommonBinaryPaths = exports.findBinaryCached = exports.findBinary = exports.probePort = exports.DIRS = exports.PID_FILES = exports.getAnalyticsScriptsDir = exports.getAgentidePath = exports.getAgentideHome = exports.checkPidFileWithCleanup = exports.removePidFile = exports.writePidFile = exports.readPidFile = exports.isPidFileProcessRunning = exports.isProcessRunningAsync = exports.isProcessRunning = void 0;
+// PID file utilities (fast process status checks)
+var pid_1 = require("./pid");
+Object.defineProperty(exports, "isProcessRunning", { enumerable: true, get: function () { return pid_1.isProcessRunning; } });
+Object.defineProperty(exports, "isProcessRunningAsync", { enumerable: true, get: function () { return pid_1.isProcessRunningAsync; } });
+Object.defineProperty(exports, "isPidFileProcessRunning", { enumerable: true, get: function () { return pid_1.isPidFileProcessRunning; } });
+Object.defineProperty(exports, "readPidFile", { enumerable: true, get: function () { return pid_1.readPidFile; } });
+Object.defineProperty(exports, "writePidFile", { enumerable: true, get: function () { return pid_1.writePidFile; } });
+Object.defineProperty(exports, "removePidFile", { enumerable: true, get: function () { return pid_1.removePidFile; } });
+Object.defineProperty(exports, "checkPidFileWithCleanup", { enumerable: true, get: function () { return pid_1.checkPidFileWithCleanup; } });
+// Path utilities (consistent directory structure)
+var paths_1 = require("./paths");
+Object.defineProperty(exports, "getAgentideHome", { enumerable: true, get: function () { return paths_1.getAgentideHome; } });
+Object.defineProperty(exports, "getAgentidePath", { enumerable: true, get: function () { return paths_1.getAgentidePath; } });
+Object.defineProperty(exports, "getAnalyticsScriptsDir", { enumerable: true, get: function () { return paths_1.getAnalyticsScriptsDir; } });
+Object.defineProperty(exports, "PID_FILES", { enumerable: true, get: function () { return paths_1.PID_FILES; } });
+Object.defineProperty(exports, "DIRS", { enumerable: true, get: function () { return paths_1.DIRS; } });
+// Network utilities (port probing)
+var network_1 = require("./network");
+Object.defineProperty(exports, "probePort", { enumerable: true, get: function () { return network_1.probePort; } });
+// Binary utilities (finding binaries with caching)
+var binary_1 = require("./binary");
+Object.defineProperty(exports, "findBinary", { enumerable: true, get: function () { return binary_1.findBinary; } });
+Object.defineProperty(exports, "findBinaryCached", { enumerable: true, get: function () { return binary_1.findBinaryCached; } });
+Object.defineProperty(exports, "getCommonBinaryPaths", { enumerable: true, get: function () { return binary_1.getCommonBinaryPaths; } });
+Object.defineProperty(exports, "clearBinaryCache", { enumerable: true, get: function () { return binary_1.clearBinaryCache; } });
+var resolveNodeBinary_1 = require("./resolveNodeBinary");
+Object.defineProperty(exports, "resolveNodeBinary", { enumerable: true, get: function () { return resolveNodeBinary_1.resolveNodeBinary; } });
+Object.defineProperty(exports, "getNodeBinaryCandidates", { enumerable: true, get: function () { return resolveNodeBinary_1.getNodeBinaryCandidates; } });
+Object.defineProperty(exports, "prependPathDir", { enumerable: true, get: function () { return resolveNodeBinary_1.prependPathDir; } });

package/out/utils/network.js

@@ -0,0 +1,74 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Network Utilities
+ *
+ *  Shared utilities for network operations like port probing.
+ *  Cost: ~50-100ms for connection attempts vs shell commands.
+ *
+ *  Used by:
+ *  - Gateway lifecycle manager (Agent Anywhere)
+ *--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.probePort = probePort;
+const net = __importStar(require("net"));
+/**
+ * Check if a port is in use (service is likely running there).
+ * Uses a TCP socket connection attempt with timeout.
+ *
+ * @param port - Port number to check
+ * @param host - Host to check (default: 127.0.0.1)
+ * @param timeout - Connection timeout in ms (default: 2000)
+ * @returns true if port is open (service is listening)
+ */
+function probePort(port, host = '127.0.0.1', timeout = 2_000) {
+    return new Promise((resolve) => {
+        const socket = new net.Socket();
+        socket.setTimeout(timeout);
+        socket.once('connect', () => {
+            socket.destroy();
+            resolve(true);
+        });
+        socket.once('timeout', () => {
+            socket.destroy();
+            resolve(false);
+        });
+        socket.once('error', () => {
+            socket.destroy();
+            resolve(false);
+        });
+        socket.connect(port, host);
+    });
+}

package/out/utils/pathSafety.js

@@ -0,0 +1,60 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) AgentHippo.ai. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPathUnderRoot = isPathUnderRoot;
+exports.isPathUnderAnyRoot = isPathUnderAnyRoot;
+const path = __importStar(require("path"));
+/**
+ * True when {@link candidate} resolves to {@link root} or a path under it (no `..` escape).
+ */
+function isPathUnderRoot(root, candidate) {
+    try {
+        const parentNorm = path.resolve(root);
+        const candidateNorm = path.resolve(candidate);
+        const rel = path.relative(parentNorm, candidateNorm);
+        return rel === '' || (!rel.startsWith('..') && !path.isAbsolute(rel));
+    }
+    catch {
+        return false;
+    }
+}
+/** True when {@link candidate} is under at least one of {@link roots}. */
+function isPathUnderAnyRoot(roots, candidate) {
+    const normalized = path.resolve(candidate);
+    return roots.some(root => isPathUnderRoot(root, normalized));
+}

package/out/utils/paths.js

@@ -0,0 +1,116 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Shared Path Utilities
+ *
+ *  Common path resolution for AgentIDE services.
+ *  All services should use these helpers to ensure consistent directory structure.
+ *--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DIRS = exports.PID_FILES = void 0;
+exports.getAgentideHome = getAgentideHome;
+exports.getAgentidePath = getAgentidePath;
+exports.getAnalyticsScriptsDir = getAnalyticsScriptsDir;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const branding_1 = require("../branding");
+/**
+ * Get the AgentIDE home directory (~/.agent-hippo or similar based on branding).
+ */
+function getAgentideHome() {
+    const envOverride = process.env.AGENT_HOME_DIR
+        || process.env.AGENTHIPPO_HOME;
+    if (envOverride?.trim()) {
+        return envOverride.trim();
+    }
+    return path.join(os.homedir(), branding_1.AGENTIDE_DIR_NAME);
+}
+/**
+ * Get a path within the AgentIDE home directory.
+ * @param segments - Path segments relative to the home directory
+ */
+function getAgentidePath(...segments) {
+    return path.join(getAgentideHome(), ...segments);
+}
+/**
+ * Common PID file paths for AgentIDE services.
+ */
+exports.PID_FILES = {
+    /** Gateway PID file */
+    gateway: () => getAgentidePath('gateway.pid'),
+    /** LiteLLM PID file */
+    litellm: () => getAgentidePath('litellm.pid'),
+    /** OTEL Collector PID file */
+    otelcol: () => getAgentidePath('analytics', 'otelcol.pid'),
+};
+/**
+ * Common directory paths for AgentIDE services.
+ */
+exports.DIRS = {
+    /** Analytics directory */
+    analytics: () => getAgentidePath('analytics'),
+    /** Credentials directory */
+    credentials: () => getAgentidePath('credentials'),
+    /** Sessions directory */
+    sessions: () => getAgentidePath('sessions'),
+};
+/**
+ * Get the analytics scripts directory from the extension path.
+ * Tries bundled location (out/scripts/analytics) first, then dev location (scripts/analytics).
+ * Returns the bundled path by default (callers should verify existence).
+ */
+function getAnalyticsScriptsDir(extensionPath) {
+    const fs = require('fs');
+    const bundledPath = path.join(extensionPath, 'out', 'scripts', 'analytics');
+    const devPath = path.join(extensionPath, 'scripts', 'analytics');
+    // Check bundled location first (production)
+    try {
+        fs.accessSync(bundledPath);
+        return bundledPath;
+    }
+    catch {
+        // Not in bundled location
+    }
+    // Check dev location
+    try {
+        fs.accessSync(devPath);
+        return devPath;
+    }
+    catch {
+        // Not in dev location
+    }
+    // Default to bundled path (scripts may not be installed yet)
+    return bundledPath;
+}