@agent-relay/utils 2.0.11 → 2.0.12

package/dist/index.d.ts

@@ -6,4 +6,5 @@ export * from './git-remote.js';
 export * from './update-checker.js';
 export * from './error-tracking.js';
 export * from './model-mapping.js';
+export * from './relay-pty-path.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -6,4 +6,5 @@ export * from './git-remote.js';
 export * from './update-checker.js';
 export * from './error-tracking.js';
 export * from './model-mapping.js';
+export * from './relay-pty-path.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/relay-pty-path.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared utility for finding the relay-pty binary path.
+ *
+ * This is used by both:
+ * - packages/bridge/src/spawner.ts (AgentSpawner)
+ * - packages/wrapper/src/relay-pty-orchestrator.ts (RelayPtyOrchestrator)
+ *
+ * The search order handles multiple installation scenarios:
+ * 1. Development (local Rust build)
+ * 2. Local npm install (node_modules/agent-relay)
+ * 3. Global npm install via nvm
+ * 4. System-wide installs (/usr/local/bin)
+ */
+/**
+ * Find the relay-pty binary.
+ *
+ * Search order:
+ * 1. bin/relay-pty in package root (installed by postinstall)
+ * 2. relay-pty/target/release/relay-pty (local Rust build)
+ * 3. /usr/local/bin/relay-pty (global install)
+ * 4. In node_modules when installed as dependency
+ * 5. Global npm installs (nvm) - both scoped and root packages
+ *
+ * @param callerDirname - The __dirname of the calling module (needed to resolve relative paths)
+ * @returns Path to relay-pty binary, or null if not found
+ */
+export declare function findRelayPtyBinary(callerDirname: string): string | null;
+/**
+ * Check if relay-pty binary is available (cached).
+ * Returns true if the binary exists, false otherwise.
+ *
+ * @param callerDirname - The __dirname of the calling module
+ */
+export declare function hasRelayPtyBinary(callerDirname: string): boolean;
+/**
+ * Get the cached relay-pty binary path.
+ * Must call hasRelayPtyBinary() or findRelayPtyBinary() first.
+ */
+export declare function getCachedRelayPtyPath(): string | null | undefined;
+/**
+ * Clear the cached binary path (for testing).
+ */
+export declare function clearBinaryCache(): void;
+//# sourceMappingURL=relay-pty-path.d.ts.map

package/dist/relay-pty-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-pty-path.d.ts","sourceRoot":"","sources":["../src/relay-pty-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwEvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAMhE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAEjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/relay-pty-path.js

@@ -0,0 +1,127 @@
+/**
+ * Shared utility for finding the relay-pty binary path.
+ *
+ * This is used by both:
+ * - packages/bridge/src/spawner.ts (AgentSpawner)
+ * - packages/wrapper/src/relay-pty-orchestrator.ts (RelayPtyOrchestrator)
+ *
+ * The search order handles multiple installation scenarios:
+ * 1. Development (local Rust build)
+ * 2. Local npm install (node_modules/agent-relay)
+ * 3. Global npm install via nvm
+ * 4. System-wide installs (/usr/local/bin)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/** Cached result of relay-pty binary check */
+let cachedBinaryPath;
+let cacheChecked = false;
+/**
+ * Find the relay-pty binary.
+ *
+ * Search order:
+ * 1. bin/relay-pty in package root (installed by postinstall)
+ * 2. relay-pty/target/release/relay-pty (local Rust build)
+ * 3. /usr/local/bin/relay-pty (global install)
+ * 4. In node_modules when installed as dependency
+ * 5. Global npm installs (nvm) - both scoped and root packages
+ *
+ * @param callerDirname - The __dirname of the calling module (needed to resolve relative paths)
+ * @returns Path to relay-pty binary, or null if not found
+ */
+export function findRelayPtyBinary(callerDirname) {
+    // Determine the agent-relay package root
+    // This code runs from either:
+    // - packages/{package}/dist/ (development/workspace)
+    // - node_modules/@agent-relay/{package}/dist/ (npm install)
+    //
+    // We need to find the agent-relay package root where bin/relay-pty lives
+    let packageRoot;
+    // Check if we're inside node_modules/@agent-relay/*/
+    if (callerDirname.includes('node_modules/@agent-relay/')) {
+        // Go from node_modules/@agent-relay/{package}/dist/ to agent-relay/
+        // dist/ -> {package}/ -> @agent-relay/ -> node_modules/ -> agent-relay/
+        packageRoot = path.join(callerDirname, '..', '..', '..', '..');
+    }
+    else if (callerDirname.includes('node_modules/agent-relay')) {
+        // Direct dependency: node_modules/agent-relay/packages/{package}/dist/
+        // dist/ -> {package}/ -> packages/ -> agent-relay/
+        packageRoot = path.join(callerDirname, '..', '..', '..');
+    }
+    else {
+        // Development: packages/{package}/dist/ -> packages/ -> project root
+        packageRoot = path.join(callerDirname, '..', '..', '..');
+    }
+    // Find the node_modules root for global installs
+    // When running from node_modules/@agent-relay/dashboard/node_modules/@agent-relay/wrapper/dist/
+    // we need to look for agent-relay at node_modules/agent-relay
+    // Use non-greedy match (.+?) to get the FIRST node_modules, not the last
+    let nodeModulesRoot = null;
+    const nodeModulesMatch = callerDirname.match(/^(.+?\/node_modules)\/@agent-relay\//);
+    if (nodeModulesMatch) {
+        nodeModulesRoot = nodeModulesMatch[1];
+    }
+    const candidates = [
+        // Primary: installed by postinstall from platform-specific binary
+        path.join(packageRoot, 'bin', 'relay-pty'),
+        // Development: local Rust build
+        path.join(packageRoot, 'relay-pty', 'target', 'release', 'relay-pty'),
+        path.join(packageRoot, 'relay-pty', 'target', 'debug', 'relay-pty'),
+        // Local build in cwd (for development)
+        path.join(process.cwd(), 'relay-pty', 'target', 'release', 'relay-pty'),
+        // Docker container (CI tests)
+        '/app/bin/relay-pty',
+        // Installed globally
+        '/usr/local/bin/relay-pty',
+        // In node_modules (when installed as local dependency)
+        path.join(process.cwd(), 'node_modules', 'agent-relay', 'bin', 'relay-pty'),
+        // Global npm install (nvm) - root package
+        path.join(process.env.HOME || '', '.nvm', 'versions', 'node', process.version, 'lib', 'node_modules', 'agent-relay', 'bin', 'relay-pty'),
+    ];
+    // Add candidate for root agent-relay package when running from scoped @agent-relay/* packages
+    if (nodeModulesRoot) {
+        candidates.push(path.join(nodeModulesRoot, 'agent-relay', 'bin', 'relay-pty'));
+    }
+    // Try common global npm paths
+    if (process.env.HOME) {
+        // Homebrew npm (macOS)
+        candidates.push(path.join('/usr/local/lib/node_modules', 'agent-relay', 'bin', 'relay-pty'));
+        candidates.push(path.join('/opt/homebrew/lib/node_modules', 'agent-relay', 'bin', 'relay-pty'));
+        // pnpm global
+        candidates.push(path.join(process.env.HOME, '.local', 'share', 'pnpm', 'global', 'node_modules', 'agent-relay', 'bin', 'relay-pty'));
+    }
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Check if relay-pty binary is available (cached).
+ * Returns true if the binary exists, false otherwise.
+ *
+ * @param callerDirname - The __dirname of the calling module
+ */
+export function hasRelayPtyBinary(callerDirname) {
+    if (!cacheChecked) {
+        cachedBinaryPath = findRelayPtyBinary(callerDirname);
+        cacheChecked = true;
+    }
+    return cachedBinaryPath !== null;
+}
+/**
+ * Get the cached relay-pty binary path.
+ * Must call hasRelayPtyBinary() or findRelayPtyBinary() first.
+ */
+export function getCachedRelayPtyPath() {
+    return cachedBinaryPath;
+}
+/**
+ * Clear the cached binary path (for testing).
+ */
+export function clearBinaryCache() {
+    cachedBinaryPath = undefined;
+    cacheChecked = false;
+}
+//# sourceMappingURL=relay-pty-path.js.map

package/dist/relay-pty-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-pty-path.js","sourceRoot":"","sources":["../src/relay-pty-path.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/utils",
-  "version": "2.0.11",
+  "version": "2.0.12",
   "description": "Shared utilities for agent-relay: logging, name generation, command resolution, update checking",
   "type": "module",
   "main": "dist/index.js",
@@ -49,6 +49,11 @@
       "types": "./dist/model-mapping.d.ts",
       "import": "./dist/model-mapping.js",
       "default": "./dist/model-mapping.js"
+    },
+    "./relay-pty-path": {
+      "types": "./dist/relay-pty-path.d.ts",
+      "import": "./dist/relay-pty-path.js",
+      "default": "./dist/relay-pty-path.js"
     }
   },
   "files": [