agent-relay 2.0.25 → 2.0.26

package/packages/state/package.json

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

package/packages/storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/storage",
-  "version": "2.0.25",
+  "version": "2.0.26",
   "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.25"
+    "@agent-relay/protocol": "2.0.26"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/telemetry/package.json

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

package/packages/user-directory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/user-directory",
-  "version": "2.0.25",
+  "version": "2.0.26",
   "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.25"
+    "@agent-relay/resiliency": "2.0.26"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/utils",
-  "version": "2.0.25",
+  "version": "2.0.26",
   "description": "Shared utilities for agent-relay: logging, name generation, command resolution, update checking",
   "type": "module",
   "main": "dist/index.js",

package/packages/wrapper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/wrapper",
-  "version": "2.0.25",
+  "version": "2.0.26",
   "description": "CLI agent wrappers for Agent Relay - tmux, pty integration",
   "type": "module",
   "main": "dist/index.js",
@@ -30,11 +30,11 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@agent-relay/api-types": "2.0.25",
-    "@agent-relay/protocol": "2.0.25",
-    "@agent-relay/config": "2.0.25",
-    "@agent-relay/continuity": "2.0.25",
-    "@agent-relay/resiliency": "2.0.25"
+    "@agent-relay/api-types": "2.0.26",
+    "@agent-relay/protocol": "2.0.26",
+    "@agent-relay/config": "2.0.26",
+    "@agent-relay/continuity": "2.0.26",
+    "@agent-relay/resiliency": "2.0.26"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/scripts/post-publish-verify/README.md

@@ -0,0 +1,80 @@
+# Post-Publish Verification
+
+Automated tests to verify the `agent-relay` npm package works correctly after publishing.
+
+## What It Tests
+
+1. **Global npm install** (`npm install -g agent-relay`)
+   - `--version` flag
+   - `-V` flag
+   - `version` command
+   - `--help` flag
+
+2. **npx execution** (`npx agent-relay`)
+   - Version commands
+   - Help output
+
+3. **Local project install** (`npm install agent-relay`)
+   - npx within project
+   - Direct bin execution (`./node_modules/.bin/agent-relay`)
+
+## Node.js Versions
+
+Tests run across all supported Node.js versions:
+- Node.js 18 (minimum supported)
+- Node.js 20 (LTS)
+- Node.js 22 (Current)
+
+## Usage
+
+### Local Testing (Docker)
+
+```bash
+# Test latest published version
+./scripts/post-publish-verify/run-verify.sh
+
+# Test specific version
+./scripts/post-publish-verify/run-verify.sh 2.0.25
+
+# Test in parallel (faster)
+./scripts/post-publish-verify/run-verify.sh latest --parallel
+
+# Test single Node.js version
+./scripts/post-publish-verify/run-verify.sh latest --node 20
+```
+
+### Docker Compose Directly
+
+```bash
+cd scripts/post-publish-verify
+
+# Test latest
+docker compose up --build
+
+# Test specific version
+PACKAGE_VERSION=2.0.25 docker compose up --build
+
+# Test single Node version
+docker compose up --build node20
+
+# Cleanup
+docker compose down --rmi local
+```
+
+### GitHub Actions
+
+The verification runs automatically after publishing via the `verify-publish.yml` workflow.
+
+You can also trigger it manually:
+1. Go to Actions tab
+2. Select "Verify Published Package"
+3. Click "Run workflow"
+4. Optionally specify a version to test
+
+## Files
+
+- `Dockerfile` - Multi-stage Dockerfile supporting different Node versions
+- `verify-install.sh` - Main verification script run inside containers
+- `docker-compose.yml` - Orchestrates tests across Node versions
+- `run-verify.sh` - Local runner script with nice output
+- `.github/workflows/verify-publish.yml` - GitHub Actions workflow

package/scripts/post-publish-verify/run-verify.sh

@@ -0,0 +1,127 @@
+#!/bin/bash
+# Post-publish verification runner
+#
+# Tests agent-relay npm package across multiple Node.js versions using Docker
+#
+# Usage:
+#   ./run-verify.sh                    # Test latest version
+#   ./run-verify.sh 2.0.25             # Test specific version
+#   ./run-verify.sh latest --parallel  # Run all versions in parallel
+#   ./run-verify.sh 2.0.25 --node 20   # Test specific Node.js version only
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+cd "$SCRIPT_DIR"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[PASS]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+log_error() { echo -e "${RED}[FAIL]${NC} $1"; }
+log_header() { echo -e "\n${BLUE}════════════════════════════════════════${NC}"; echo -e "${BLUE}  $1${NC}"; echo -e "${BLUE}════════════════════════════════════════${NC}\n"; }
+
+# Parse arguments
+PACKAGE_VERSION="${1:-latest}"
+PARALLEL=false
+SPECIFIC_NODE=""
+FAILED_VERSIONS=()
+
+shift || true
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --parallel|-p)
+            PARALLEL=true
+            shift
+            ;;
+        --node|-n)
+            SPECIFIC_NODE="$2"
+            shift 2
+            ;;
+        --help|-h)
+            echo "Usage: $0 [VERSION] [OPTIONS]"
+            echo ""
+            echo "Arguments:"
+            echo "  VERSION          Package version to test (default: latest)"
+            echo ""
+            echo "Options:"
+            echo "  --parallel, -p   Run all Node versions in parallel"
+            echo "  --node, -n VER   Test only specific Node.js version (18, 20, or 22)"
+            echo "  --help, -h       Show this help"
+            echo ""
+            echo "Examples:"
+            echo "  $0                     # Test latest across all Node versions"
+            echo "  $0 2.0.25              # Test version 2.0.25"
+            echo "  $0 latest --parallel   # Test in parallel"
+            echo "  $0 2.0.25 --node 20    # Test only Node 20"
+            exit 0
+            ;;
+        *)
+            log_error "Unknown option: $1"
+            exit 1
+            ;;
+    esac
+done
+
+log_header "Agent Relay Post-Publish Verification"
+log_info "Package version: $PACKAGE_VERSION"
+log_info "Parallel mode: $PARALLEL"
+if [ -n "$SPECIFIC_NODE" ]; then
+    log_info "Testing Node.js version: $SPECIFIC_NODE only"
+fi
+
+# Export for docker-compose
+export PACKAGE_VERSION
+
+# Determine which services to run
+if [ -n "$SPECIFIC_NODE" ]; then
+    SERVICES="node${SPECIFIC_NODE}"
+else
+    SERVICES="node18 node20 node22"
+fi
+
+# Build images
+log_info "Building Docker images..."
+docker compose build $SERVICES
+
+# Run tests
+if [ "$PARALLEL" = true ]; then
+    log_info "Running verification in parallel..."
+    docker compose up --abort-on-container-exit $SERVICES
+    EXIT_CODE=$?
+else
+    # Run sequentially to see output clearly
+    for service in $SERVICES; do
+        log_header "Testing $service"
+        if docker compose up --abort-on-container-exit "$service"; then
+            log_success "$service verification passed"
+        else
+            log_error "$service verification failed"
+            FAILED_VERSIONS+=("$service")
+        fi
+        # Clean up container
+        docker compose rm -f "$service" 2>/dev/null || true
+    done
+fi
+
+# Cleanup
+log_info "Cleaning up..."
+docker compose down --rmi local 2>/dev/null || true
+
+# Summary
+log_header "Verification Complete"
+log_info "Package version tested: $PACKAGE_VERSION"
+
+if [ ${#FAILED_VERSIONS[@]} -eq 0 ]; then
+    log_success "All Node.js versions passed verification!"
+    exit 0
+else
+    log_error "Failed versions: ${FAILED_VERSIONS[*]}"
+    exit 1
+fi

package/scripts/post-publish-verify/verify-install.sh

@@ -0,0 +1,249 @@
+#!/bin/bash
+# Post-publish verification script
+# Tests both global npm install and npx installation of agent-relay
+#
+# Environment variables:
+#   PACKAGE_VERSION: Version to install (default: latest)
+#   NODE_VERSION: Node version being tested (for logging)
+
+# Don't use set -e so we can collect all test results
+# set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[PASS]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+log_error() { echo -e "${RED}[FAIL]${NC} $1"; }
+log_header() { echo -e "\n${BLUE}========================================${NC}"; echo -e "${BLUE}$1${NC}"; echo -e "${BLUE}========================================${NC}"; }
+
+# Track test results
+TESTS_PASSED=0
+TESTS_FAILED=0
+
+record_pass() {
+    ((TESTS_PASSED++))
+    log_success "$1"
+}
+
+record_fail() {
+    ((TESTS_FAILED++))
+    log_error "$1"
+}
+
+# Get package specification
+PACKAGE_SPEC="agent-relay"
+if [ -n "$PACKAGE_VERSION" ] && [ "$PACKAGE_VERSION" != "latest" ]; then
+    PACKAGE_SPEC="agent-relay@${PACKAGE_VERSION}"
+fi
+
+log_header "Post-Publish Verification"
+log_info "Node.js version: $(node --version)"
+log_info "npm version: $(npm --version)"
+log_info "Package to test: $PACKAGE_SPEC"
+log_info "User: $(whoami)"
+log_info "Working directory: $(pwd)"
+log_info "PATH: $PATH"
+log_info "NPM prefix: $(npm config get prefix)"
+log_info "NPM bin location: $(npm config get prefix)/bin"
+
+# ============================================
+# Test 1: Global npm install
+# ============================================
+log_header "Test 1: Global npm install"
+
+# Ensure npm global bin is in PATH
+NPM_BIN="$(npm config get prefix)/bin"
+export PATH="$NPM_BIN:$PATH"
+log_info "Updated PATH to include: $NPM_BIN"
+
+# Clean any previous installation
+log_info "Cleaning previous global installation..."
+npm uninstall -g agent-relay 2>/dev/null || true
+
+# Install globally
+log_info "Installing ${PACKAGE_SPEC} globally..."
+npm install -g "$PACKAGE_SPEC"
+INSTALL_EXIT=$?
+log_info "npm install exit code: $INSTALL_EXIT"
+if [ $INSTALL_EXIT -eq 0 ]; then
+    record_pass "Global npm install succeeded"
+else
+    record_fail "Global npm install failed with exit code $INSTALL_EXIT"
+fi
+
+# Verify the binary exists
+log_info "Checking if agent-relay binary exists..."
+if [ -f "$NPM_BIN/agent-relay" ]; then
+    log_info "Binary found at: $NPM_BIN/agent-relay"
+    ls -la "$NPM_BIN/agent-relay"
+else
+    log_warn "Binary not found at expected location: $NPM_BIN/agent-relay"
+    log_info "Contents of $NPM_BIN:"
+    ls -la "$NPM_BIN" 2>/dev/null || echo "Directory does not exist"
+fi
+
+# Test --version flag
+log_info "Testing 'agent-relay --version'..."
+GLOBAL_VERSION=$(agent-relay --version 2>&1) || true
+if [ -n "$GLOBAL_VERSION" ]; then
+    log_info "Output: $GLOBAL_VERSION"
+    # Verify it contains a version number pattern
+    if echo "$GLOBAL_VERSION" | grep -qE '[0-9]+\.[0-9]+\.[0-9]+'; then
+        record_pass "Global install --version returns valid version: $GLOBAL_VERSION"
+    else
+        record_fail "Global install --version output doesn't contain version number"
+    fi
+else
+    record_fail "Global install --version returned empty output"
+fi
+
+# Test -V flag (short version flag)
+log_info "Testing 'agent-relay -V'..."
+GLOBAL_V=$(agent-relay -V 2>&1) || true
+if [ -n "$GLOBAL_V" ]; then
+    record_pass "Global install -V works: $GLOBAL_V"
+else
+    record_fail "Global install -V failed"
+fi
+
+# Test version command
+log_info "Testing 'agent-relay version'..."
+GLOBAL_VERSION_CMD=$(agent-relay version 2>&1) || true
+if echo "$GLOBAL_VERSION_CMD" | grep -qE '[0-9]+\.[0-9]+\.[0-9]+'; then
+    record_pass "Global install 'version' command works"
+else
+    record_fail "Global install 'version' command failed"
+fi
+
+# Test help command
+log_info "Testing 'agent-relay --help'..."
+GLOBAL_HELP=$(agent-relay --help 2>&1) || true
+if echo "$GLOBAL_HELP" | grep -q "agent-relay"; then
+    record_pass "Global install --help works"
+else
+    record_fail "Global install --help failed"
+fi
+
+# Cleanup global install
+log_info "Cleaning up global installation..."
+npm uninstall -g agent-relay 2>/dev/null || true
+
+# ============================================
+# Test 2: npx execution (without prior install)
+# ============================================
+log_header "Test 2: npx execution"
+
+# Clear npm cache to ensure fresh download
+log_info "Clearing npm cache for npx test..."
+npm cache clean --force 2>/dev/null || true
+
+# Test npx --version
+log_info "Testing 'npx ${PACKAGE_SPEC} --version'..."
+NPX_VERSION=$(npx -y "$PACKAGE_SPEC" --version 2>&1) || true
+if [ -n "$NPX_VERSION" ]; then
+    log_info "Output: $NPX_VERSION"
+    if echo "$NPX_VERSION" | grep -qE '[0-9]+\.[0-9]+\.[0-9]+'; then
+        record_pass "npx --version returns valid version: $NPX_VERSION"
+    else
+        record_fail "npx --version output doesn't contain version number"
+    fi
+else
+    record_fail "npx --version returned empty output"
+fi
+
+# Test npx help
+log_info "Testing 'npx ${PACKAGE_SPEC} --help'..."
+NPX_HELP=$(npx -y "$PACKAGE_SPEC" --help 2>&1) || true
+if echo "$NPX_HELP" | grep -q "agent-relay"; then
+    record_pass "npx --help works"
+else
+    record_fail "npx --help failed"
+fi
+
+# Test npx version command
+log_info "Testing 'npx ${PACKAGE_SPEC} version'..."
+NPX_VERSION_CMD=$(npx -y "$PACKAGE_SPEC" version 2>&1) || true
+if echo "$NPX_VERSION_CMD" | grep -qE '[0-9]+\.[0-9]+\.[0-9]+'; then
+    record_pass "npx 'version' command works"
+else
+    record_fail "npx 'version' command failed"
+fi
+
+# ============================================
+# Test 3: Local project install
+# ============================================
+log_header "Test 3: Local project install"
+
+# Create a test project
+TEST_PROJECT_DIR=$(mktemp -d)
+log_info "Created test project at: $TEST_PROJECT_DIR"
+cd "$TEST_PROJECT_DIR"
+
+# Initialize package.json
+log_info "Initializing package.json..."
+npm init -y > /dev/null 2>&1
+
+# Install as local dependency
+log_info "Installing ${PACKAGE_SPEC} locally..."
+if npm install "$PACKAGE_SPEC" 2>&1; then
+    record_pass "Local npm install succeeded"
+else
+    record_fail "Local npm install failed"
+fi
+
+# Test via npx (should use local version)
+log_info "Testing 'npx agent-relay --version' (local)..."
+LOCAL_VERSION=$(npx agent-relay --version 2>&1) || true
+if [ -n "$LOCAL_VERSION" ]; then
+    if echo "$LOCAL_VERSION" | grep -qE '[0-9]+\.[0-9]+\.[0-9]+'; then
+        record_pass "Local install via npx works: $LOCAL_VERSION"
+    else
+        record_fail "Local install via npx doesn't return version"
+    fi
+else
+    record_fail "Local install via npx failed"
+fi
+
+# Test via node_modules/.bin
+log_info "Testing './node_modules/.bin/agent-relay --version'..."
+if [ -x "./node_modules/.bin/agent-relay" ]; then
+    BIN_VERSION=$(./node_modules/.bin/agent-relay --version 2>&1) || true
+    if echo "$BIN_VERSION" | grep -qE '[0-9]+\.[0-9]+\.[0-9]+'; then
+        record_pass "Local bin executable works: $BIN_VERSION"
+    else
+        record_fail "Local bin executable doesn't return version"
+    fi
+else
+    record_fail "Local bin executable not found or not executable"
+fi
+
+# Cleanup test project
+log_info "Cleaning up test project..."
+cd /home/testuser
+rm -rf "$TEST_PROJECT_DIR"
+
+# ============================================
+# Summary
+# ============================================
+log_header "Verification Summary"
+echo ""
+log_info "Node.js: $(node --version)"
+log_info "Package: $PACKAGE_SPEC"
+echo ""
+echo -e "Tests passed: ${GREEN}${TESTS_PASSED}${NC}"
+echo -e "Tests failed: ${RED}${TESTS_FAILED}${NC}"
+echo ""
+
+if [ $TESTS_FAILED -eq 0 ]; then
+    log_success "All tests passed!"
+    exit 0
+else
+    log_error "Some tests failed!"
+    exit 1
+fi

package/packages/sdk/dist/protocol/framing.d.ts

@@ -1,80 +0,0 @@
-/**
- * Frame encoding/decoding for the Agent Relay protocol.
- * @agent-relay/sdk
- *
- * Wire format:
- * - 1 byte: format indicator (0 = JSON, 1 = MessagePack)
- * - 4 bytes: big-endian payload length
- * - N bytes: payload (JSON or MessagePack encoded)
- *
- * Legacy format (for backwards compatibility):
- * - 4 bytes: big-endian payload length
- * - N bytes: JSON payload
- */
-import type { Envelope } from './types.js';
-export declare const MAX_FRAME_BYTES: number;
-export declare const HEADER_SIZE = 5;
-export declare const LEGACY_HEADER_SIZE = 4;
-export type WireFormat = 'json' | 'msgpack';
-/**
- * Initialize MessagePack support.
- * Install @msgpack/msgpack to enable: npm install @msgpack/msgpack
- */
-export declare function initMessagePack(): Promise<boolean>;
-/**
- * Check if MessagePack is available.
- */
-export declare function hasMessagePack(): boolean;
-/**
- * Encode a message envelope into a framed buffer.
- *
- * @param envelope - The envelope to encode
- * @param format - Wire format to use (default: 'json')
- * @returns Framed buffer ready for socket write
- */
-export declare function encodeFrame(envelope: Envelope, format?: WireFormat): Buffer;
-/**
- * Encode a frame in legacy format (no format byte, JSON only).
- * Used for backwards compatibility with older clients.
- */
-export declare function encodeFrameLegacy(envelope: Envelope): Buffer;
-/**
- * Ring buffer-based frame parser for streaming data.
- */
-export declare class FrameParser {
-    private ring;
-    private head;
-    private tail;
-    private readonly capacity;
-    private readonly maxFrameBytes;
-    private format;
-    private legacyMode;
-    constructor(maxFrameBytes?: number);
-    /**
-     * Set the expected wire format for parsing.
-     */
-    setFormat(format: WireFormat): void;
-    /**
-     * Enable legacy mode (4-byte header, JSON only).
-     */
-    setLegacyMode(legacy: boolean): void;
-    /**
-     * Get current unread bytes in buffer.
-     */
-    get pendingBytes(): number;
-    /**
-     * Push data into the parser and extract complete frames.
-     *
-     * @param data - Incoming data buffer
-     * @returns Array of parsed envelope frames
-     */
-    push(data: Buffer): Envelope[];
-    private extractFrames;
-    private decodePayload;
-    private compact;
-    /**
-     * Reset parser state.
-     */
-    reset(): void;
-}
-//# sourceMappingURL=framing.d.ts.map