agent-relay 3.1.4 → 3.1.6

package/packages/openclaw/src/setup.ts

@@ -1,4 +1,5 @@
 import { mkdir, writeFile, readFile, copyFile } from 'node:fs/promises';
+import { createConnection } from 'node:net';
 import { join, dirname } from 'node:path';
 import { existsSync } from 'node:fs';
 import { hostname } from 'node:os';
@@ -8,7 +9,21 @@ import { spawn as spawnProcess, execFileSync } from 'node:child_process';
 import { RelayCast } from '@relaycast/sdk';
 
 import { detectOpenClaw, saveGatewayConfig } from './config.js';
-import type { GatewayConfig } from './types.js';
+import { InboundGateway } from './gateway.js';
+import { DEFAULT_OPENCLAW_GATEWAY_PORT, type GatewayConfig } from './types.js';
+
+/**
+ * Safely traverse a nested object by dot-separated path.
+ * Returns undefined if any segment is missing.
+ */
+function extractNestedValue(obj: unknown, path: string): unknown {
+  let current: unknown = obj;
+  for (const key of path.split('.')) {
+    if (current == null || typeof current !== 'object') return undefined;
+    current = (current as Record<string, unknown>)[key];
+  }
+  return current;
+}
 
 /**
  * Resolve how to invoke mcporter. Prefers a global binary, falls back to npx.
@@ -28,6 +43,26 @@ function resolveMcporter(): { cmd: string; prefix: string[] } {
   }
 }
 
+/** Check if a port is already in use by attempting a TCP connection. */
+function isPortInUse(port: number): Promise<boolean> {
+  return new Promise((resolve) => {
+    const socket = createConnection({ port, host: '127.0.0.1' });
+    socket.setTimeout(2000);
+    socket.once('connect', () => {
+      socket.destroy();
+      resolve(true);
+    });
+    socket.once('timeout', () => {
+      socket.destroy();
+      resolve(false);
+    });
+    socket.once('error', () => {
+      socket.destroy();
+      resolve(false);
+    });
+  });
+}
+
 export interface SetupOptions {
   /** If provided, join this workspace. Otherwise create a new one. */
   apiKey?: string;
@@ -185,12 +220,29 @@ export async function setup(options: SetupOptions): Promise<SetupResult> {
     );
   }
 
+  // Extract gateway auth from openclaw.json (if available)
+  const openclawGatewayToken =
+    process.env.OPENCLAW_GATEWAY_TOKEN ??
+    (extractNestedValue(detection.config, 'gateway.auth.token') as string | undefined);
+  const openclawGatewayPortRaw =
+    process.env.OPENCLAW_GATEWAY_PORT ??
+    (extractNestedValue(detection.config, 'gateway.port') as number | string | undefined);
+  const openclawGatewayPort = openclawGatewayPortRaw ? Number(openclawGatewayPortRaw) : undefined;
+
+  if (!openclawGatewayToken) {
+    console.warn('[setup] No gateway token found in openclaw.json or OPENCLAW_GATEWAY_TOKEN env.');
+    console.warn('[setup] Inbound gateway may fail to pair. Set it manually:');
+    console.warn('[setup]   export OPENCLAW_GATEWAY_TOKEN=$(cat ~/.openclaw/openclaw.json | jq -r .gateway.auth.token)');
+  }
+
   // Save gateway config (.env)
   const gatewayConfig: GatewayConfig = {
     apiKey,
     clawName,
     baseUrl,
     channels,
+    openclawGatewayToken,
+    openclawGatewayPort: Number.isFinite(openclawGatewayPort) ? openclawGatewayPort : undefined,
   };
   await saveGatewayConfig(gatewayConfig);
 
@@ -281,18 +333,41 @@ export async function setup(options: SetupOptions): Promise<SetupResult> {
     }
   }
 
-  // Auto-start the inbound gateway in the background
+  // Auto-start the inbound gateway in the background, but only if one isn't
+  // already running. Re-running setup without this check spawns duplicates
+  // that fight over the control port.
   let gatewayStarted = false;
-  try {
-    const child = spawnProcess('npx', ['@agent-relay/openclaw', 'gateway'], {
-      stdio: 'ignore',
-      detached: true,
-      env: { ...process.env, RELAY_API_KEY: apiKey, RELAY_CLAW_NAME: clawName, RELAY_BASE_URL: baseUrl },
-    });
-    child.unref();
+  // Check the inbound gateway's control port (18790), NOT the OpenClaw
+  // gateway WS port (18789) — they are different processes.
+  const controlPort = Number(process.env.RELAYCAST_CONTROL_PORT) || InboundGateway.DEFAULT_CONTROL_PORT;
+  const gatewayAlreadyRunning = await isPortInUse(controlPort);
+  if (gatewayAlreadyRunning) {
+    console.log('[setup] Inbound gateway already running — skipping spawn.');
     gatewayStarted = true;
-  } catch {
-    // Non-fatal — user can start manually
+  } else {
+    try {
+      const gatewayEnv: Record<string, string> = {
+        ...process.env as Record<string, string>,
+        RELAY_API_KEY: apiKey,
+        RELAY_CLAW_NAME: clawName,
+        RELAY_BASE_URL: baseUrl,
+      };
+      if (openclawGatewayToken) {
+        gatewayEnv.OPENCLAW_GATEWAY_TOKEN = openclawGatewayToken;
+      }
+      if (openclawGatewayPort && Number.isFinite(openclawGatewayPort)) {
+        gatewayEnv.OPENCLAW_GATEWAY_PORT = String(openclawGatewayPort);
+      }
+      const child = spawnProcess('npx', ['@agent-relay/openclaw', 'gateway'], {
+        stdio: 'ignore',
+        detached: true,
+        env: gatewayEnv,
+      });
+      child.unref();
+      gatewayStarted = true;
+    } catch {
+      // Non-fatal — user can start manually
+    }
   }
 
   const parts = [

package/packages/openclaw/src/spawn/docker.ts

@@ -8,6 +8,7 @@ import { normalizeModelRef } from '../identity/model.js';
 import { buildIdentityTask } from '../identity/contract.js';
 import { buildAgentName } from '../identity/naming.js';
 import { convertCodexAuth } from '../auth/converter.js';
+import { DEFAULT_OPENCLAW_GATEWAY_PORT } from '../types.js';
 
 async function pathExists(targetPath: string): Promise<boolean> {
   try {
@@ -152,7 +153,7 @@ export class DockerSpawnProvider implements SpawnProvider {
     const modelRef = normalizeModelRef(options.model, preferredProvider);
     const workspaceId = options.workspaceId ?? `local-${Date.now().toString(36)}`;
     const agentName = buildAgentName(workspaceId, options.name);
-    const gatewayPort = 18789; // Internal to container — each container is isolated
+    const gatewayPort = DEFAULT_OPENCLAW_GATEWAY_PORT; // Internal to container — each container is isolated
     const identityTask = buildIdentityTask(agentName, workspaceId, modelRef);
     const channels = options.channels?.length ? options.channels : ['general'];
     const gatewayToken = randomUUID().replace(/-/g, '').slice(0, 32);

package/packages/openclaw/src/types.ts

@@ -1,3 +1,6 @@
+/** Default port for the local OpenClaw gateway WebSocket API. */
+export const DEFAULT_OPENCLAW_GATEWAY_PORT = 18789;
+
 export interface GatewayConfig {
   /** Relaycast workspace API key (rk_live_*). */
   apiKey: string;

package/packages/policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/policy",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "description": "Agent policy management with multi-level fallback (repo, local PRPM, cloud workspace)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/config": "3.1.4"
+    "@agent-relay/config": "3.1.6"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -81,7 +81,7 @@
     "typescript": "^5.7.3"
   },
   "dependencies": {
-    "@agent-relay/config": "3.1.4",
+    "@agent-relay/config": "3.1.6",
     "@relaycast/sdk": "^0.4.0",
     "yaml": "^2.7.0"
   }

package/packages/sdk-py/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agent-relay-sdk"
-version = "3.1.4"
+version = "3.1.6"
 description = "Python SDK for Agent Relay workflows"
 readme = "README.md"
 license = "Apache-2.0"

package/packages/telemetry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/telemetry",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "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": "3.1.4",
+  "version": "3.1.6",
   "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": "3.1.4"
+    "@agent-relay/config": "3.1.6"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/user-directory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/user-directory",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "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/utils": "3.1.4"
+    "@agent-relay/utils": "3.1.6"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/utils",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "description": "Shared utilities for agent-relay: logging, name generation, command resolution, update checking",
   "type": "module",
   "main": "dist/cjs/index.js",
@@ -112,7 +112,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@agent-relay/config": "3.1.4",
+    "@agent-relay/config": "3.1.6",
     "compare-versions": "^6.1.1"
   },
   "publishConfig": {