agent-relay 2.0.37 → 2.1.1

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "2.0.37",
+  "version": "2.1.1",
   "description": "Lightweight SDK for agent-to-agent communication via Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -55,7 +55,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.37"
+    "@agent-relay/protocol": "2.1.1"
   },
   "engines": {
     "node": ">=18.0.0"

package/packages/spawner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/spawner",
-  "version": "2.0.37",
+  "version": "2.1.1",
   "description": "Agent spawning types and utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/state/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/state",
-  "version": "2.0.37",
+  "version": "2.1.1",
   "description": "Agent state persistence for non-hook CLIs (Codex, Gemini, etc.)",
   "type": "module",
   "main": "dist/index.js",

package/packages/storage/dist/adapter.d.ts

@@ -169,17 +169,17 @@ export declare function getStorageConfigFromEnv(): StorageConfig;
  * Configuration priority:
  * 1. Explicit config passed to function
  * 2. Environment variables (AGENT_RELAY_STORAGE_TYPE, AGENT_RELAY_STORAGE_PATH, AGENT_RELAY_STORAGE_URL)
- * 3. Default: SQLite at provided dbPath
+ * 3. Default: JSONL (no native dependencies)
  *
  * Fallback strategy:
- * - Prefer SQLite (or batched SQLite when requested)
- * - On SQLite failure, try JSONL append-only storage before dropping to in-memory
+ * - Default to JSONL (no native dependencies required)
+ * - SQLite available via --storage=sqlite flag (requires better-sqlite3 or Node 22+)
  * - If all durable adapters fail, keep daemon running via memory (non-persistent) with guidance
  *
  * Supported storage types:
- * - 'sqlite' (default): SQLite file-based storage
+ * - 'jsonl' (default): Append-only JSONL files (no native deps)
+ * - 'sqlite': SQLite file-based storage (requires better-sqlite3 or Node 22+)
  * - 'sqlite-batched': SQLite with buffered writes
- * - 'jsonl': Append-only JSONL files (durable fallback)
  * - 'none' or 'memory': In-memory storage (no persistence)
  * - 'postgres': PostgreSQL (requires AGENT_RELAY_STORAGE_URL) - future
  */

package/packages/storage/dist/adapter.js

@@ -133,17 +133,17 @@ export function getStorageConfigFromEnv() {
  * Configuration priority:
  * 1. Explicit config passed to function
  * 2. Environment variables (AGENT_RELAY_STORAGE_TYPE, AGENT_RELAY_STORAGE_PATH, AGENT_RELAY_STORAGE_URL)
- * 3. Default: SQLite at provided dbPath
+ * 3. Default: JSONL (no native dependencies)
  *
  * Fallback strategy:
- * - Prefer SQLite (or batched SQLite when requested)
- * - On SQLite failure, try JSONL append-only storage before dropping to in-memory
+ * - Default to JSONL (no native dependencies required)
+ * - SQLite available via --storage=sqlite flag (requires better-sqlite3 or Node 22+)
  * - If all durable adapters fail, keep daemon running via memory (non-persistent) with guidance
  *
  * Supported storage types:
- * - 'sqlite' (default): SQLite file-based storage
+ * - 'jsonl' (default): Append-only JSONL files (no native deps)
+ * - 'sqlite': SQLite file-based storage (requires better-sqlite3 or Node 22+)
  * - 'sqlite-batched': SQLite with buffered writes
- * - 'jsonl': Append-only JSONL files (durable fallback)
  * - 'none' or 'memory': In-memory storage (no persistence)
  * - 'postgres': PostgreSQL (requires AGENT_RELAY_STORAGE_URL) - future
  */
@@ -151,7 +151,7 @@ export async function createStorageAdapter(dbPath, config) {
     // Merge with env config, explicit config takes priority
     const envConfig = getStorageConfigFromEnv();
     const finalConfig = {
-        type: config?.type ?? envConfig.type ?? 'sqlite',
+        type: config?.type ?? envConfig.type ?? 'jsonl',
         path: config?.path ?? envConfig.path ?? dbPath,
         url: config?.url ?? envConfig.url,
     };
@@ -159,7 +159,7 @@ export async function createStorageAdapter(dbPath, config) {
     switch (storageType) {
         case 'none':
         case 'memory': {
-            console.log('[storage] Using in-memory storage (no persistence)');
+            console.error('[storage] Using in-memory storage (no persistence)');
             const adapter = new MemoryStorageAdapter();
             await adapter.init();
             return adapter;
@@ -175,7 +175,7 @@ export async function createStorageAdapter(dbPath, config) {
         case 'sqlite-batched':
         case 'batched': {
             try {
-                console.log('[storage] Using batched SQLite storage');
+                console.error('[storage] Using batched SQLite storage');
                 const { BatchedSqliteAdapter } = await import('./batched-sqlite-adapter.js');
                 const adapter = new BatchedSqliteAdapter({
                     dbPath: finalConfig.path,
@@ -215,7 +215,7 @@ export async function createStorageAdapter(dbPath, config) {
         case 'jsonl': {
             const { JsonlStorageAdapter } = await import('./jsonl-adapter.js');
             const baseDir = path.dirname(finalConfig.path);
-            console.log('[storage] Using JSONL storage');
+            console.error('[storage] Using JSONL storage');
             const adapter = new JsonlStorageAdapter({ baseDir });
             await adapter.init();
             return adapter;

package/packages/storage/dist/adapter.js.map

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

package/packages/storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/storage",
-  "version": "2.0.37",
+  "version": "2.1.1",
   "description": "Storage adapters and interfaces for Relay message/session persistence",
   "type": "module",
   "main": "dist/index.js",
@@ -56,7 +56,7 @@
     }
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.37"
+    "@agent-relay/protocol": "2.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/storage/src/adapter.ts

@@ -298,17 +298,17 @@ export function getStorageConfigFromEnv(): StorageConfig {
  * Configuration priority:
  * 1. Explicit config passed to function
  * 2. Environment variables (AGENT_RELAY_STORAGE_TYPE, AGENT_RELAY_STORAGE_PATH, AGENT_RELAY_STORAGE_URL)
- * 3. Default: SQLite at provided dbPath
+ * 3. Default: JSONL (no native dependencies)
  *
  * Fallback strategy:
- * - Prefer SQLite (or batched SQLite when requested)
- * - On SQLite failure, try JSONL append-only storage before dropping to in-memory
+ * - Default to JSONL (no native dependencies required)
+ * - SQLite available via --storage=sqlite flag (requires better-sqlite3 or Node 22+)
  * - If all durable adapters fail, keep daemon running via memory (non-persistent) with guidance
  *
  * Supported storage types:
- * - 'sqlite' (default): SQLite file-based storage
+ * - 'jsonl' (default): Append-only JSONL files (no native deps)
+ * - 'sqlite': SQLite file-based storage (requires better-sqlite3 or Node 22+)
  * - 'sqlite-batched': SQLite with buffered writes
- * - 'jsonl': Append-only JSONL files (durable fallback)
  * - 'none' or 'memory': In-memory storage (no persistence)
  * - 'postgres': PostgreSQL (requires AGENT_RELAY_STORAGE_URL) - future
  */
@@ -319,7 +319,7 @@ export async function createStorageAdapter(
   // Merge with env config, explicit config takes priority
   const envConfig = getStorageConfigFromEnv();
   const finalConfig: StorageConfig = {
-    type: config?.type ?? envConfig.type ?? 'sqlite',
+    type: config?.type ?? envConfig.type ?? 'jsonl',
     path: config?.path ?? envConfig.path ?? dbPath,
     url: config?.url ?? envConfig.url,
   };
@@ -329,7 +329,7 @@ export async function createStorageAdapter(
   switch (storageType) {
     case 'none':
     case 'memory': {
-      console.log('[storage] Using in-memory storage (no persistence)');
+      console.error('[storage] Using in-memory storage (no persistence)');
       const adapter = new MemoryStorageAdapter();
       await adapter.init();
       return adapter;
@@ -351,7 +351,7 @@ export async function createStorageAdapter(
     case 'sqlite-batched':
     case 'batched': {
       try {
-        console.log('[storage] Using batched SQLite storage');
+        console.error('[storage] Using batched SQLite storage');
         const { BatchedSqliteAdapter } = await import('./batched-sqlite-adapter.js');
         const adapter = new BatchedSqliteAdapter({
           dbPath: finalConfig.path!,
@@ -392,7 +392,7 @@ export async function createStorageAdapter(
     case 'jsonl': {
       const { JsonlStorageAdapter } = await import('./jsonl-adapter.js');
       const baseDir = path.dirname(finalConfig.path!);
-      console.log('[storage] Using JSONL storage');
+      console.error('[storage] Using JSONL storage');
       const adapter = new JsonlStorageAdapter({ baseDir });
       await adapter.init();
       return adapter;

package/packages/telemetry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/telemetry",
-  "version": "2.0.37",
+  "version": "2.1.1",
   "description": "Anonymous telemetry for Agent Relay usage analytics",
   "type": "module",
   "main": "dist/index.js",

package/packages/trajectory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/trajectory",
-  "version": "2.0.37",
+  "version": "2.1.1",
   "description": "Trajectory integration utilities (trail/PDERO) for Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/config": "2.0.37"
+    "@agent-relay/config": "2.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/user-directory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/user-directory",
-  "version": "2.0.37",
+  "version": "2.1.1",
   "description": "User directory service for agent-relay (per-user credential storage)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/resiliency": "2.0.37"
+    "@agent-relay/resiliency": "2.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/utils/dist/cjs/relay-pty-path.js

@@ -32,20 +32,42 @@ __export(relay_pty_path_exports, {
   findRelayPtyBinary: () => findRelayPtyBinary,
   getCachedRelayPtyPath: () => getCachedRelayPtyPath,
   getLastSearchPaths: () => getLastSearchPaths,
-  hasRelayPtyBinary: () => hasRelayPtyBinary
+  getSupportedPlatforms: () => getSupportedPlatforms,
+  hasRelayPtyBinary: () => hasRelayPtyBinary,
+  isPlatformSupported: () => isPlatformSupported
 });
 module.exports = __toCommonJS(relay_pty_path_exports);
 var import_node_fs = __toESM(require("node:fs"), 1);
 var import_node_os = __toESM(require("node:os"), 1);
 var import_node_path = __toESM(require("node:path"), 1);
+const SUPPORTED_PLATFORMS = {
+  darwin: {
+    arm64: "relay-pty-darwin-arm64",
+    x64: "relay-pty-darwin-x64"
+  },
+  linux: {
+    arm64: "relay-pty-linux-arm64",
+    x64: "relay-pty-linux-x64"
+  }
+};
 function getPlatformBinaryName() {
   const platform = import_node_os.default.platform();
   const arch = import_node_os.default.arch();
-  if (platform === "darwin" && arch === "arm64") return "relay-pty-darwin-arm64";
-  if (platform === "darwin" && arch === "x64") return "relay-pty-darwin-x64";
-  if (platform === "linux" && arch === "arm64") return "relay-pty-linux-arm64";
-  if (platform === "linux" && arch === "x64") return "relay-pty-linux-x64";
-  return null;
+  return SUPPORTED_PLATFORMS[platform]?.[arch] ?? null;
+}
+function isPlatformSupported() {
+  const platform = import_node_os.default.platform();
+  const arch = import_node_os.default.arch();
+  return SUPPORTED_PLATFORMS[platform]?.[arch] !== void 0;
+}
+function getSupportedPlatforms() {
+  const platforms = [];
+  for (const [os2, archs] of Object.entries(SUPPORTED_PLATFORMS)) {
+    for (const arch of Object.keys(archs)) {
+      platforms.push(`${os2}-${arch}`);
+    }
+  }
+  return platforms.join(", ");
 }
 let cachedBinaryPath;
 let cacheChecked = false;
@@ -55,70 +77,102 @@ function getLastSearchPaths() {
 }
 function findRelayPtyBinary(callerDirname) {
   const envOverride = process.env.RELAY_PTY_BINARY;
-  if (envOverride && import_node_fs.default.existsSync(envOverride)) {
+  if (envOverride && isExecutable(envOverride)) {
     lastSearchPaths = [envOverride];
     return envOverride;
   }
-  let packageRoot;
-  if (callerDirname.includes("node_modules/@agent-relay/")) {
-    packageRoot = import_node_path.default.join(callerDirname, "..", "..", "..", "..");
-  } else if (callerDirname.includes("node_modules/agent-relay")) {
-    packageRoot = import_node_path.default.join(callerDirname, "..", "..", "..");
-  } else {
-    packageRoot = import_node_path.default.join(callerDirname, "..", "..", "..");
-  }
-  let nodeModulesRoot = null;
-  const nodeModulesMatch = callerDirname.match(/^(.+?\/node_modules)\/@agent-relay\//);
-  if (nodeModulesMatch) {
-    nodeModulesRoot = nodeModulesMatch[1];
-  }
   const platformBinary = getPlatformBinaryName();
-  const candidates = [
-    // Primary: installed by postinstall from platform-specific binary
-    import_node_path.default.join(packageRoot, "bin", "relay-pty"),
-    // Development: local Rust build
-    import_node_path.default.join(packageRoot, "relay-pty", "target", "release", "relay-pty"),
-    import_node_path.default.join(packageRoot, "relay-pty", "target", "debug", "relay-pty"),
-    // Local build in cwd (for development)
-    import_node_path.default.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)
-    import_node_path.default.join(process.cwd(), "node_modules", "agent-relay", "bin", "relay-pty"),
-    // Global npm install (nvm) - root package
-    import_node_path.default.join(process.env.HOME || "", ".nvm", "versions", "node", process.version, "lib", "node_modules", "agent-relay", "bin", "relay-pty")
-  ];
-  if (nodeModulesRoot) {
-    candidates.push(import_node_path.default.join(nodeModulesRoot, "agent-relay", "bin", "relay-pty"));
+  const normalizedCaller = callerDirname.replace(/\\/g, "/");
+  const packageRoots = [];
+  const scopedMatch = normalizedCaller.match(/^(.+?\/node_modules)\/@agent-relay\//);
+  const directMatch = normalizedCaller.match(/^(.+?\/node_modules\/agent-relay)/);
+  if (scopedMatch) {
+    packageRoots.push(import_node_path.default.join(scopedMatch[1], "agent-relay"));
   }
-  if (process.env.HOME) {
-    candidates.push(import_node_path.default.join("/usr/local/lib/node_modules", "agent-relay", "bin", "relay-pty"));
-    candidates.push(import_node_path.default.join("/opt/homebrew/lib/node_modules", "agent-relay", "bin", "relay-pty"));
-    candidates.push(import_node_path.default.join(process.env.HOME, ".local", "share", "pnpm", "global", "node_modules", "agent-relay", "bin", "relay-pty"));
+  if (directMatch) {
+    packageRoots.push(directMatch[1]);
   }
-  if (platformBinary) {
-    candidates.push(import_node_path.default.join(packageRoot, "bin", platformBinary));
-    candidates.push(import_node_path.default.join(process.cwd(), "node_modules", "agent-relay", "bin", platformBinary));
-    candidates.push(import_node_path.default.join(process.env.HOME || "", ".nvm", "versions", "node", process.version, "lib", "node_modules", "agent-relay", "bin", platformBinary));
-    if (nodeModulesRoot) {
-      candidates.push(import_node_path.default.join(nodeModulesRoot, "agent-relay", "bin", platformBinary));
+  if (!normalizedCaller.includes("node_modules")) {
+    packageRoots.push(import_node_path.default.join(callerDirname, "..", "..", ".."));
+  }
+  const home = process.env.HOME || process.env.USERPROFILE || "";
+  if (home) {
+    const npxCacheBase = import_node_path.default.join(home, ".npm", "_npx");
+    if (import_node_fs.default.existsSync(npxCacheBase)) {
+      try {
+        const entries = import_node_fs.default.readdirSync(npxCacheBase);
+        for (const entry of entries) {
+          const npxPackage = import_node_path.default.join(npxCacheBase, entry, "node_modules", "agent-relay");
+          if (import_node_fs.default.existsSync(npxPackage)) {
+            packageRoots.push(npxPackage);
+          }
+        }
+      } catch {
+      }
     }
-    if (process.env.HOME) {
-      candidates.push(import_node_path.default.join("/usr/local/lib/node_modules", "agent-relay", "bin", platformBinary));
-      candidates.push(import_node_path.default.join("/opt/homebrew/lib/node_modules", "agent-relay", "bin", platformBinary));
-      candidates.push(import_node_path.default.join(process.env.HOME, ".local", "share", "pnpm", "global", "node_modules", "agent-relay", "bin", platformBinary));
+  }
+  packageRoots.push(import_node_path.default.join(process.cwd(), "node_modules", "agent-relay"));
+  if (home) {
+    packageRoots.push(
+      import_node_path.default.join(home, ".nvm", "versions", "node", process.version, "lib", "node_modules", "agent-relay")
+    );
+    packageRoots.push(
+      import_node_path.default.join(home, ".volta", "tools", "image", "packages", "agent-relay", "lib", "node_modules", "agent-relay")
+    );
+    packageRoots.push(
+      import_node_path.default.join(home, ".fnm", "node-versions", process.version, "installation", "lib", "node_modules", "agent-relay")
+    );
+    packageRoots.push(
+      import_node_path.default.join(home, "n", "lib", "node_modules", "agent-relay")
+    );
+    packageRoots.push(
+      import_node_path.default.join(home, ".asdf", "installs", "nodejs", process.version.replace("v", ""), "lib", "node_modules", "agent-relay")
+    );
+    packageRoots.push(
+      import_node_path.default.join(home, ".local", "share", "pnpm", "global", "node_modules", "agent-relay")
+    );
+    packageRoots.push(
+      import_node_path.default.join(home, ".config", "yarn", "global", "node_modules", "agent-relay")
+    );
+    packageRoots.push(
+      import_node_path.default.join(home, ".yarn", "global", "node_modules", "agent-relay")
+    );
+  }
+  packageRoots.push("/usr/local/lib/node_modules/agent-relay");
+  packageRoots.push("/opt/homebrew/lib/node_modules/agent-relay");
+  packageRoots.push("/usr/lib/node_modules/agent-relay");
+  const candidates = [];
+  for (const root of packageRoots) {
+    if (platformBinary) {
+      candidates.push(import_node_path.default.join(root, "bin", platformBinary));
     }
+    candidates.push(import_node_path.default.join(root, "bin", "relay-pty"));
+  }
+  const devRoot = normalizedCaller.includes("node_modules") ? null : import_node_path.default.join(callerDirname, "..", "..", "..");
+  if (devRoot) {
+    candidates.push(import_node_path.default.join(devRoot, "relay-pty", "target", "release", "relay-pty"));
+    candidates.push(import_node_path.default.join(devRoot, "relay-pty", "target", "debug", "relay-pty"));
   }
+  candidates.push(import_node_path.default.join(process.cwd(), "relay-pty", "target", "release", "relay-pty"));
+  candidates.push("/app/bin/relay-pty");
+  candidates.push("/usr/local/bin/relay-pty");
+  candidates.push("/usr/bin/relay-pty");
   lastSearchPaths = candidates;
   for (const candidate of candidates) {
-    if (import_node_fs.default.existsSync(candidate)) {
+    if (isExecutable(candidate)) {
       return candidate;
     }
   }
   return null;
 }
+function isExecutable(filePath) {
+  try {
+    import_node_fs.default.accessSync(filePath, import_node_fs.default.constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function hasRelayPtyBinary(callerDirname) {
   if (!cacheChecked) {
     cachedBinaryPath = findRelayPtyBinary(callerDirname);
@@ -139,5 +193,7 @@ function clearBinaryCache() {
   findRelayPtyBinary,
   getCachedRelayPtyPath,
   getLastSearchPaths,
-  hasRelayPtyBinary
+  getSupportedPlatforms,
+  hasRelayPtyBinary,
+  isPlatformSupported
 });

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

@@ -5,12 +5,22 @@
  * - 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)
+ * Supports all installation scenarios:
+ * - npx agent-relay (no postinstall, uses platform-specific binary)
+ * - npm install -g agent-relay (nvm, volta, fnm, n, asdf, Homebrew, system)
+ * - npm install agent-relay (local project)
+ * - pnpm/yarn global
+ * - Development (monorepo with Rust builds)
+ * - Docker containers
  */
+/**
+ * Check if the current platform is supported.
+ */
+export declare function isPlatformSupported(): boolean;
+/**
+ * Get a human-readable description of supported platforms.
+ */
+export declare function getSupportedPlatforms(): string;
 /**
  * Get the paths that were checked in the last binary search.
  * Useful for debugging when the binary is not found.
@@ -19,13 +29,8 @@ export declare function getLastSearchPaths(): string[];
 /**
  * Find the relay-pty binary.
  *
- * Search order:
- * 1. RELAY_PTY_BINARY environment variable (explicit override)
- * 2. bin/relay-pty in package root (installed by postinstall)
- * 3. relay-pty/target/release/relay-pty (local Rust build)
- * 4. /usr/local/bin/relay-pty (global install)
- * 5. In node_modules when installed as dependency
- * 6. Global npm installs (nvm) - both scoped and root packages
+ * Search order prioritizes platform-specific binaries FIRST because npx doesn't run postinstall.
+ * This ensures `npx agent-relay up` works without requiring global installation.
  *
  * @param callerDirname - The __dirname of the calling module (needed to resolve relative paths)
  * @returns Path to relay-pty binary, or null if not found

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

@@ -1 +1 @@
-{"version":3,"file":"relay-pty-path.d.ts","sourceRoot":"","sources":["../src/relay-pty-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA8BH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqGvE;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"}
+{"version":3,"file":"relay-pty-path.d.ts","sourceRoot":"","sources":["../src/relay-pty-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgCH;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAI7C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAQ9C;AASD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuJvE;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"}