agent-relay 2.0.19 → 2.0.20

package/packages/cli-tester/dist/utils/socket-client.js

@@ -0,0 +1,153 @@
+/**
+ * Socket client for communicating with relay-pty Unix socket
+ * Used for programmatic message injection and status queries
+ */
+import { createConnection } from 'node:net';
+export class RelayPtyClient {
+    socket = null;
+    socketPath;
+    responseBuffer = '';
+    constructor(socketPath) {
+        this.socketPath = socketPath;
+    }
+    /**
+     * Connect to the relay-pty socket
+     */
+    async connect() {
+        return new Promise((resolve, reject) => {
+            this.socket = createConnection(this.socketPath, () => {
+                resolve();
+            });
+            this.socket.on('error', (err) => {
+                reject(new Error(`Failed to connect to ${this.socketPath}: ${err.message}`));
+            });
+            this.socket.on('data', (data) => {
+                this.responseBuffer += data.toString();
+            });
+        });
+    }
+    /**
+     * Send a request and wait for response
+     */
+    async sendRequest(request) {
+        if (!this.socket) {
+            throw new Error('Not connected. Call connect() first.');
+        }
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error('Request timed out'));
+            }, 10000);
+            // Clear buffer before sending
+            this.responseBuffer = '';
+            // Set up response handler
+            const checkResponse = () => {
+                const lines = this.responseBuffer.split('\n');
+                for (const line of lines) {
+                    if (line.trim()) {
+                        try {
+                            const response = JSON.parse(line);
+                            clearTimeout(timeout);
+                            resolve(response);
+                            return;
+                        }
+                        catch {
+                            // Not valid JSON yet, keep waiting
+                        }
+                    }
+                }
+                // Keep checking
+                setTimeout(checkResponse, 50);
+            };
+            // Send request
+            const requestStr = JSON.stringify(request) + '\n';
+            this.socket.write(requestStr, (err) => {
+                if (err) {
+                    clearTimeout(timeout);
+                    reject(err);
+                }
+                else {
+                    checkResponse();
+                }
+            });
+        });
+    }
+    /**
+     * Inject a message into the CLI
+     */
+    async inject(message) {
+        const request = {
+            type: 'inject',
+            id: `ts-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            from: message.from,
+            body: message.body,
+            priority: message.priority ?? 0,
+        };
+        return this.sendRequest(request);
+    }
+    /**
+     * Get current status of the CLI session
+     */
+    async getStatus() {
+        const request = { type: 'status' };
+        return this.sendRequest(request);
+    }
+    /**
+     * Wait for a specific message to be delivered
+     * Returns when the message reaches 'delivered' or 'failed' status
+     */
+    async waitForDelivered(messageId, timeoutMs = 30000) {
+        const startTime = Date.now();
+        return new Promise((resolve, reject) => {
+            const checkBuffer = () => {
+                if (Date.now() - startTime > timeoutMs) {
+                    reject(new Error(`Timeout waiting for message ${messageId} to be delivered`));
+                    return;
+                }
+                const lines = this.responseBuffer.split('\n');
+                for (const line of lines) {
+                    if (line.trim()) {
+                        try {
+                            const response = JSON.parse(line);
+                            if (response.type === 'inject_result' &&
+                                response.id === messageId &&
+                                (response.status === 'delivered' || response.status === 'failed')) {
+                                resolve(response);
+                                return;
+                            }
+                        }
+                        catch {
+                            // Not valid JSON, skip
+                        }
+                    }
+                }
+                // Keep checking
+                setTimeout(checkBuffer, 100);
+            };
+            checkBuffer();
+        });
+    }
+    /**
+     * Close the connection
+     */
+    close() {
+        if (this.socket) {
+            this.socket.destroy();
+            this.socket = null;
+        }
+    }
+}
+/**
+ * Helper to create a connected client
+ */
+export async function createClient(socketPath) {
+    const client = new RelayPtyClient(socketPath);
+    await client.connect();
+    return client;
+}
+/**
+ * Get socket path for a named session
+ */
+export function getSocketPath(sessionName) {
+    return `/tmp/relay-pty-${sessionName}.sock`;
+}
+//# sourceMappingURL=socket-client.js.map

package/packages/cli-tester/docker/entrypoint.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# CLI Tester Container Entrypoint
+# Simplified entrypoint for CLI authentication testing
+
+set -e
+
+# Ensure config directories exist with correct permissions
+mkdir -p ~/.claude ~/.codex ~/.gemini ~/.cursor ~/.config ~/.local/share/opencode 2>/dev/null || true
+
+echo "========================================"
+echo "  CLI Auth Tester Environment"
+echo "========================================"
+echo ""
+
+# Show available CLIs
+echo "Available CLI tools:"
+for cli in claude codex gemini opencode droid copilot; do
+    if command -v $cli &> /dev/null; then
+        version=$($cli --version 2>/dev/null | head -n1 || echo "installed")
+        echo "  ✓ $cli ($version)"
+    else
+        echo "  ✗ $cli (not installed)"
+    fi
+done
+# Cursor installs as 'agent'
+if command -v agent &> /dev/null; then
+    version=$(agent --version 2>/dev/null | head -n1 || echo "installed")
+    echo "  ✓ cursor/agent ($version)"
+else
+    echo "  ✗ cursor/agent (not installed)"
+fi
+echo ""
+
+# Show relay-pty status
+if command -v relay-pty &> /dev/null; then
+    echo "relay-pty: ✓ available"
+else
+    echo "relay-pty: ✗ not found"
+fi
+echo ""
+
+# Show usage
+echo "Quick Start:"
+echo "  test-cli.sh claude      # Test Claude CLI with relay-pty"
+echo "  test-cli.sh codex       # Test Codex CLI with relay-pty"
+echo "  verify-auth.sh claude   # Check if credentials exist"
+echo "  clear-auth.sh claude    # Clear credentials for fresh test"
+echo ""
+echo "For debugging:"
+echo "  DEBUG=1 test-cli.sh cursor  # Verbose output"
+echo ""
+
+# Execute the provided command or drop into shell
+if [ $# -gt 0 ]; then
+    exec "$@"
+else
+    exec /bin/bash
+fi

package/packages/cli-tester/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@agent-relay/cli-tester",
+  "version": "2.0.20",
+  "description": "Manual interactive testing for CLI authentication flows",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "start": "./scripts/start.sh",
+    "start:clean": "./scripts/start.sh --clean",
+    "start:daemon": "./scripts/start.sh --daemon",
+    "docker:build": "docker compose -f docker/docker-compose.yml build",
+    "docker:up": "docker compose -f docker/docker-compose.yml up",
+    "docker:up:daemon": "docker compose -f docker/docker-compose.yml --profile daemon up",
+    "docker:down": "docker compose -f docker/docker-compose.yml down",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "cli",
+    "testing",
+    "authentication",
+    "relay-pty"
+  ],
+  "author": "Agent Workforce",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  }
+}

package/packages/cli-tester/scripts/clear-auth.sh

@@ -0,0 +1,101 @@
+#!/bin/bash
+# Clear CLI credentials for fresh testing
+# Usage: ./clear-auth.sh <cli|all>
+# Example: ./clear-auth.sh claude
+#          ./clear-auth.sh all
+
+CLI=${1:-}
+
+if [ -z "$CLI" ]; then
+    echo "Usage: ./clear-auth.sh <cli|all>"
+    echo ""
+    echo "Options:"
+    echo "  claude   - Clear Claude credentials"
+    echo "  codex    - Clear Codex credentials"
+    echo "  gemini   - Clear Gemini credentials"
+    echo "  cursor   - Clear Cursor credentials"
+    echo "  opencode - Clear OpenCode credentials"
+    echo "  droid    - Clear Droid credentials"
+    echo "  copilot  - Clear GitHub Copilot credentials"
+    echo "  all      - Clear all credentials"
+    exit 1
+fi
+
+clear_cli() {
+    local cli=$1
+    local dir=""
+    local files=()
+
+    case $cli in
+        claude)
+            dir="$HOME/.claude"
+            files=(".credentials.json" "settings.json" "settings.local.json")
+            ;;
+        codex)
+            dir="$HOME/.codex"
+            files=("auth.json" "config.json" "config.toml")
+            ;;
+        gemini)
+            dir="$HOME/.gemini"
+            files=("credentials.json" "settings.json")
+            # Also check gcloud location
+            if [ -f "$HOME/.config/gcloud/application_default_credentials.json" ]; then
+                echo "  Removing: $HOME/.config/gcloud/application_default_credentials.json"
+                rm -f "$HOME/.config/gcloud/application_default_credentials.json"
+            fi
+            ;;
+        cursor|agent)
+            # Cursor CLI installs as 'agent', credentials in ~/.cursor/
+            dir="$HOME/.cursor"
+            files=("auth.json" "settings.json")
+            ;;
+        opencode)
+            dir="$HOME/.local/share/opencode"
+            files=("auth.json")
+            ;;
+        droid)
+            dir="$HOME/.droid"
+            files=("auth.json")
+            ;;
+        copilot)
+            # GitHub Copilot uses gh CLI auth - stored in ~/.config/gh/
+            dir="$HOME/.config/gh"
+            files=("hosts.yml" "config.yml")
+            ;;
+        *)
+            echo "Unknown CLI: $cli"
+            return 1
+            ;;
+    esac
+
+    echo "Clearing credentials for: $cli"
+
+    if [ -d "$dir" ]; then
+        for file in "${files[@]}"; do
+            if [ -f "$dir/$file" ]; then
+                echo "  Removing: $dir/$file"
+                rm -f "$dir/$file"
+            fi
+        done
+        echo "  ✓ Done"
+    else
+        echo "  (no config directory found)"
+    fi
+}
+
+echo "========================================"
+echo "  Clearing CLI Credentials"
+echo "========================================"
+echo ""
+
+if [ "$CLI" = "all" ]; then
+    for c in claude codex gemini cursor opencode droid copilot; do
+        clear_cli "$c"
+        echo ""
+    done
+else
+    clear_cli "$CLI"
+fi
+
+echo ""
+echo "Credentials cleared. Run test-cli.sh to test fresh authentication."

package/packages/cli-tester/scripts/inject-message.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# Send a message to a CLI via relay-pty socket
+# Usage: ./inject-message.sh <session-name> <message>
+# Example: ./inject-message.sh test-claude "What is 2+2?"
+
+NAME=${1:-test-claude}
+MESSAGE=${2:-"Test message from inject script"}
+SOCKET="/tmp/relay-pty-${NAME}.sock"
+
+if [ ! -S "$SOCKET" ]; then
+    echo "Error: Socket not found: $SOCKET"
+    echo ""
+    echo "Make sure relay-pty is running with --name ${NAME}"
+    echo "Run: test-cli.sh ${NAME#test-}"
+    exit 1
+fi
+
+# Generate unique message ID
+MSG_ID="manual-$(date +%s)-$RANDOM"
+
+echo "Sending message to $NAME..."
+echo "  Socket: $SOCKET"
+echo "  Message ID: $MSG_ID"
+echo "  Body: $MESSAGE"
+echo ""
+
+# Build JSON request
+REQUEST=$(cat <<EOF
+{"type":"inject","id":"$MSG_ID","from":"Tester","body":"$MESSAGE","priority":0}
+EOF
+)
+
+# Send request and read response
+# nc -U connects to Unix socket, -q 1 waits 1 second for response
+echo "$REQUEST" | nc -U "$SOCKET" -q 2 | while read -r line; do
+    if [ -n "$line" ]; then
+        echo "Response: $line" | jq '.' 2>/dev/null || echo "Response: $line"
+    fi
+done
+
+echo ""
+echo "Message sent. Check the CLI session to see if it was delivered."

package/packages/cli-tester/scripts/start.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+# Start the CLI tester Docker environment
+# Usage: ./start.sh [--clean] [--build] [--daemon]
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PACKAGE_DIR="$(dirname "$SCRIPT_DIR")"
+DOCKER_DIR="$PACKAGE_DIR/docker"
+
+# Parse arguments
+CLEAN=false
+BUILD=false
+WITH_DAEMON=false
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --clean)
+            CLEAN=true
+            shift
+            ;;
+        --build)
+            BUILD=true
+            shift
+            ;;
+        --daemon)
+            WITH_DAEMON=true
+            shift
+            ;;
+        *)
+            echo "Unknown option: $1"
+            echo "Usage: ./start.sh [--clean] [--build] [--daemon]"
+            echo "  --clean   Remove credential volumes before starting"
+            echo "  --build   Force rebuild of Docker image"
+            echo "  --daemon  Start with relay daemon for full integration testing"
+            exit 1
+            ;;
+    esac
+done
+
+cd "$DOCKER_DIR"
+
+# Clean volumes if requested
+if [ "$CLEAN" = true ]; then
+    echo "Removing credential volumes..."
+    docker compose down -v 2>/dev/null || true
+fi
+
+# Build compose args
+COMPOSE_ARGS=()
+if [ "$WITH_DAEMON" = true ]; then
+    COMPOSE_ARGS+=(--profile daemon)
+fi
+
+# Build if requested or if image doesn't exist
+if [ "$BUILD" = true ]; then
+    echo "Building Docker image..."
+    docker compose "${COMPOSE_ARGS[@]}" build
+fi
+
+# Start the container interactively
+echo ""
+if [ "$WITH_DAEMON" = true ]; then
+    echo "Starting CLI tester environment with daemon..."
+    echo "The daemon will be available at http://daemon:3377"
+else
+    echo "Starting CLI tester environment..."
+fi
+echo "Use Ctrl+D or 'exit' to leave the container."
+echo ""
+
+docker compose "${COMPOSE_ARGS[@]}" run --rm cli-tester

package/packages/cli-tester/scripts/test-cli.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# Test a specific CLI with relay-pty
+# Usage: ./test-cli.sh <cli> [extra-args...]
+# Example: ./test-cli.sh claude
+#          ./test-cli.sh codex --device-auth
+#          DEBUG=1 ./test-cli.sh cursor
+
+set -e
+
+CLI=${1:-claude}
+shift 2>/dev/null || true  # Shift to get extra args, ignore if no more args
+
+# Map CLI name to actual command (cursor installs as 'agent')
+CLI_CMD="$CLI"
+if [ "$CLI" = "cursor" ]; then
+    CLI_CMD="agent"
+fi
+
+NAME="test-${CLI}"
+SOCKET="/tmp/relay-pty-${NAME}.sock"
+
+# Remove stale socket if exists
+rm -f "$SOCKET"
+
+echo "========================================"
+echo "  Testing: $CLI"
+echo "========================================"
+echo ""
+echo "Session name: $NAME"
+echo "Socket path:  $SOCKET"
+echo ""
+echo "After authenticating, open another terminal and run:"
+echo "  verify-auth.sh $CLI"
+echo "  inject-message.sh $NAME 'Hello world'"
+echo ""
+echo "Press Ctrl+C to stop the session."
+echo "========================================"
+echo ""
+
+# Build relay-pty args
+RELAY_ARGS=(
+    --name "$NAME"
+    --socket "$SOCKET"
+    --idle-timeout 500
+)
+
+# Add debug output if DEBUG is set
+if [ -n "$DEBUG" ]; then
+    RELAY_ARGS+=(--json-output)
+    echo "[DEBUG] JSON output enabled - relay commands will be printed to stderr"
+    echo ""
+fi
+
+# Run relay-pty with the CLI
+# Pass through any extra arguments to the CLI
+exec relay-pty "${RELAY_ARGS[@]}" -- "$CLI_CMD" "$@"