agent-relay 2.0.29 → 2.0.32

package/packages/bridge/src/types.ts

@@ -0,0 +1,145 @@
+/**
+ * Bridge Types
+ * Types for multi-project orchestration
+ */
+
+export interface ProjectConfig {
+  /** Absolute path to project root */
+  path: string;
+  /** Project identifier (derived from path hash) */
+  id: string;
+  /** Socket path for this project's daemon */
+  socketPath: string;
+  /** Lead agent name (auto-generated from dirname if not specified) */
+  leadName: string;
+  /** CLI tool to use (default: claude) */
+  cli: string;
+}
+
+export interface BridgeConfig {
+  /** Projects to bridge */
+  projects: ProjectConfig[];
+  /** CLI override for all projects */
+  cliOverride?: string;
+}
+
+export interface LeadInfo {
+  /** Lead agent name */
+  name: string;
+  /** Project this lead manages */
+  projectId: string;
+  /** Whether lead is currently connected */
+  connected: boolean;
+}
+
+export interface SpawnRequest {
+  /** Worker agent name */
+  name: string;
+  /** CLI tool (e.g., 'claude', 'claude:opus', 'codex') */
+  cli: string;
+  /** Initial task to inject */
+  task: string;
+  /** Optional team name to organize agents under */
+  team?: string;
+  /** Working directory for the agent (defaults to detected workspace) */
+  cwd?: string;
+  /** Name of the agent requesting the spawn (for policy enforcement) */
+  spawnerName?: string;
+  /** Interactive mode - disables auto-accept of permission prompts (for auth setup flows) */
+  interactive?: boolean;
+  /** Shadow execution mode (subagent = no extra process) */
+  shadowMode?: 'subagent' | 'process';
+  /** Primary agent to shadow (if this agent is a shadow) */
+  shadowOf?: string;
+  /** Shadow agent profile to use (for subagent mode) */
+  shadowAgent?: string;
+  /** When to trigger the shadow (for subagent mode) */
+  shadowTriggers?: Array<'SESSION_END' | 'CODE_WRITTEN' | 'REVIEW_REQUEST' | 'EXPLICIT_ASK' | 'ALL_MESSAGES'>;
+  /** When the shadow should speak (default: ['EXPLICIT_ASK']) */
+  shadowSpeakOn?: Array<'SESSION_END' | 'CODE_WRITTEN' | 'REVIEW_REQUEST' | 'EXPLICIT_ASK' | 'ALL_MESSAGES'>;
+  /** User ID for per-user credential storage in shared workspaces */
+  userId?: string;
+  /** Include ACK/DONE workflow conventions in agent instructions (default: false) */
+  includeWorkflowConventions?: boolean;
+}
+
+/** Policy decision details */
+export interface PolicyDecision {
+  allowed: boolean;
+  reason: string;
+  policySource: 'repo' | 'local' | 'workspace' | 'default';
+}
+
+export interface SpawnResult {
+  success: boolean;
+  name: string;
+  /** PID of the spawned process (for pty-based workers) */
+  pid?: number;
+  error?: string;
+  /** Unique error ID for support lookup (e.g., ERR-1706012345-a7f3) */
+  errorId?: string;
+  /** Policy decision details if spawn was blocked by policy */
+  policyDecision?: PolicyDecision;
+}
+
+export interface WorkerInfo {
+  name: string;
+  cli: string;
+  task: string;
+  /** Optional team name this agent belongs to */
+  team?: string;
+  spawnedAt: number;
+  /** PID of the pty process */
+  pid?: number;
+}
+
+/** SpeakOn trigger types for shadow agents */
+export type SpeakOnTrigger = 'SESSION_END' | 'CODE_WRITTEN' | 'REVIEW_REQUEST' | 'EXPLICIT_ASK' | 'ALL_MESSAGES';
+
+/** Shadow role preset names */
+export type ShadowRolePreset = 'reviewer' | 'auditor' | 'active';
+
+/** Primary agent configuration for spawnWithShadow */
+export interface PrimaryAgentConfig {
+  /** Agent name */
+  name: string;
+  /** CLI command (default: 'claude') */
+  command?: string;
+  /** Initial task to send to the agent */
+  task?: string;
+  /** Team name to organize under */
+  team?: string;
+}
+
+/** Shadow agent configuration for spawnWithShadow */
+export interface ShadowAgentConfig {
+  /** Shadow agent name */
+  name: string;
+  /** CLI command (default: same as primary) */
+  command?: string;
+  /** Role preset (reviewer, auditor, active) or custom prompt */
+  role?: ShadowRolePreset | string;
+  /** Custom speakOn triggers (overrides role preset) */
+  speakOn?: SpeakOnTrigger[];
+  /** Custom prompt for the shadow agent */
+  prompt?: string;
+}
+
+/** Request for spawning a primary agent with its shadow */
+export interface SpawnWithShadowRequest {
+  /** Primary agent configuration */
+  primary: PrimaryAgentConfig;
+  /** Shadow agent configuration */
+  shadow: ShadowAgentConfig;
+}
+
+/** Result from spawnWithShadow */
+export interface SpawnWithShadowResult {
+  success: boolean;
+  /** Primary agent spawn result */
+  primary?: SpawnResult;
+  /** Shadow agent spawn result */
+  shadow?: SpawnResult;
+  /** Error message if overall operation failed */
+  error?: string;
+}

package/packages/bridge/src/utils.test.ts

@@ -0,0 +1,98 @@
+/**
+ * Unit tests for Bridge Utilities
+ */
+
+import { describe, it, expect } from 'vitest';
+import { parseTarget, escapeForShell, escapeForTmux } from './utils.js';
+
+describe('Bridge Utils', () => {
+  describe('parseTarget', () => {
+    it('parses project:agent format', () => {
+      const result = parseTarget('auth:Alice');
+      expect(result).toEqual({
+        projectId: 'auth',
+        agentName: 'Alice',
+      });
+    });
+
+    it('parses wildcard project', () => {
+      const result = parseTarget('*:lead');
+      expect(result).toEqual({
+        projectId: '*',
+        agentName: 'lead',
+      });
+    });
+
+    it('parses wildcard agent', () => {
+      const result = parseTarget('frontend:*');
+      expect(result).toEqual({
+        projectId: 'frontend',
+        agentName: '*',
+      });
+    });
+
+    it('parses double wildcard', () => {
+      const result = parseTarget('*:*');
+      expect(result).toEqual({
+        projectId: '*',
+        agentName: '*',
+      });
+    });
+
+    it('returns null for invalid format (no colon)', () => {
+      const result = parseTarget('invalidformat');
+      expect(result).toBeNull();
+    });
+
+    it('returns null for too many colons', () => {
+      const result = parseTarget('a:b:c');
+      expect(result).toBeNull();
+    });
+  });
+
+  describe('escapeForShell', () => {
+    it('escapes backslashes', () => {
+      expect(escapeForShell('path\\to\\file')).toBe('path\\\\to\\\\file');
+    });
+
+    it('escapes double quotes', () => {
+      expect(escapeForShell('say "hello"')).toBe('say \\"hello\\"');
+    });
+
+    it('escapes dollar signs', () => {
+      expect(escapeForShell('$HOME/path')).toBe('\\$HOME/path');
+    });
+
+    it('escapes backticks', () => {
+      expect(escapeForShell('echo `date`')).toBe('echo \\`date\\`');
+    });
+
+    it('escapes exclamation marks', () => {
+      expect(escapeForShell('Hello!')).toBe('Hello\\!');
+    });
+
+    it('handles multiple special characters', () => {
+      expect(escapeForShell('$var "test" `cmd`')).toBe('\\$var \\"test\\" \\`cmd\\`');
+    });
+  });
+
+  describe('escapeForTmux', () => {
+    it('replaces newlines with spaces', () => {
+      expect(escapeForTmux('line1\nline2\nline3')).toBe('line1 line2 line3');
+    });
+
+    it('replaces carriage returns with spaces', () => {
+      expect(escapeForTmux('line1\r\nline2')).toBe('line1 line2');
+    });
+
+    it('escapes shell special characters', () => {
+      expect(escapeForTmux('$var')).toBe('\\$var');
+    });
+
+    it('handles complex input', () => {
+      const input = 'Hello\nWorld\r\n$test "quoted"';
+      const expected = 'Hello World \\$test \\"quoted\\"';
+      expect(escapeForTmux(input)).toBe(expected);
+    });
+  });
+});

package/packages/bridge/src/utils.ts

@@ -0,0 +1,67 @@
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import crypto from 'node:crypto';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import { getProjectPaths } from '@agent-relay/config/project-namespace';
+
+export const execAsync = promisify(exec);
+
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// Minimal generateId helper to avoid pulling wrapper
+export function generateId(): string {
+  return crypto.randomUUID();
+}
+
+export function resolvePath(p: string): string {
+  if (p.startsWith('~')) {
+    p = path.join(os.homedir(), p.slice(1));
+  }
+  return path.resolve(p);
+}
+
+export function getDefaultLeadName(projectPath: string): string {
+  const dirname = path.basename(projectPath);
+  return dirname.charAt(0).toUpperCase() + dirname.slice(1);
+}
+
+export function getProjectPathsSafe(projectPath: string) {
+  return getProjectPaths(projectPath);
+}
+
+export function fileExists(p: string): boolean {
+  try {
+    return fs.existsSync(p);
+  } catch {
+    return false;
+  }
+}
+
+export function parseTarget(target: string): { projectId: string; agentName: string } | null {
+  const parts = target.split(':');
+  if (parts.length !== 2) return null;
+  return { projectId: parts[0], agentName: parts[1] };
+}
+
+export function escapeForShell(str: string): string {
+  return str
+    .replace(/\\/g, '\\\\')
+    .replace(/"/g, '\\"')
+    .replace(/\$/g, '\\\$')
+    .replace(/`/g, '\\`')
+    .replace(/!/g, '\\!');
+}
+
+export function escapeForTmux(str: string): string {
+  return str
+    .replace(/[\r\n]+/g, ' ')
+    .replace(/\\/g, '\\\\')
+    .replace(/"/g, '\\"')
+    .replace(/\$/g, '\\\$')
+    .replace(/`/g, '\\`')
+    .replace(/!/g, '\\!');
+}

package/packages/bridge/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": [
+      "ES2022"
+    ],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "**/*.test.ts"
+  ]
+}

package/packages/bridge/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['src/**/*.test.ts'],
+  },
+});

package/packages/cli-tester/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,KAAK,OAAO,EACZ,KAAK,eAAe,GACrB,MAAM,6BAA6B,CAAC"}

package/packages/cli-tester/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,GAMd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GAGf,MAAM,6BAA6B,CAAC"}

package/packages/cli-tester/dist/utils/credential-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-check.d.ts","sourceRoot":"","sources":["../../src/utils/credential-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,cAAc,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAC;IACzB,yCAAyC;IACzC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAmBtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAkCrD;AAoGD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAqC9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBtF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAS9F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAStE"}

package/packages/cli-tester/dist/utils/credential-check.js.map

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

package/packages/cli-tester/dist/utils/socket-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-client.d.ts","sourceRoot":"","sources":["../../src/utils/socket-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,cAAc,CAAC;AAE/D,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAc;gBAExB,UAAU,EAAE,MAAM;IAI9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;OAEG;YACW,WAAW;IA6CzB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,cAAc,CAAC;IAY3B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;IAK1C;;;OAGG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,cAAc,CAAC;IAqC1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAI9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD"}

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

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

package/packages/cli-tester/docker/Dockerfile

@@ -0,0 +1,61 @@
+# CLI Auth Tester - Manual interactive testing environment
+# Based on relay-workspace which has all CLIs pre-installed
+#
+# Build the base image first if needed:
+#   docker build -f deploy/workspace/Dockerfile.local -t relay-workspace:local .
+
+ARG BASE_IMAGE=relay-workspace:local
+FROM ${BASE_IMAGE}
+
+# Switch to root for setup
+USER root
+
+# Install additional debugging tools
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    netcat-openbsd \
+    jq \
+    less \
+    vim \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create app directory for scripts
+RUN mkdir -p /app/scripts /app/src && chown -R workspace:workspace /app
+
+# Pre-create CLI config directories with correct ownership
+# These will be overlaid by volumes but the ownership will persist
+RUN mkdir -p /home/workspace/.claude \
+             /home/workspace/.codex \
+             /home/workspace/.gemini \
+             /home/workspace/.cursor \
+             /home/workspace/.config \
+             /home/workspace/.local/share/opencode \
+    && chown -R workspace:workspace /home/workspace/.claude \
+                                    /home/workspace/.codex \
+                                    /home/workspace/.gemini \
+                                    /home/workspace/.cursor \
+                                    /home/workspace/.config \
+                                    /home/workspace/.local
+
+# Copy scripts and source
+COPY --chown=workspace:workspace scripts/ /app/scripts/
+COPY --chown=workspace:workspace src/ /app/src/
+
+# Make scripts executable
+RUN chmod +x /app/scripts/*.sh
+
+# Add scripts to PATH
+ENV PATH="/app/scripts:${PATH}"
+
+# Custom entrypoint that skips cloud-specific setup
+COPY --chown=workspace:workspace docker/entrypoint.sh /app/entrypoint.sh
+RUN chmod +x /app/entrypoint.sh
+
+# Switch back to workspace user
+USER workspace
+
+# Set working directory
+WORKDIR /home/workspace
+
+# Use our simpler entrypoint
+ENTRYPOINT ["/app/entrypoint.sh"]
+CMD ["/bin/bash"]

package/packages/cli-tester/docker/docker-compose.yml

@@ -0,0 +1,71 @@
+services:
+  cli-tester:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+      args:
+        BASE_IMAGE: ${BASE_IMAGE:-relay-workspace:local}
+    stdin_open: true  # Keep stdin open for interactive use (-i)
+    tty: true         # Allocate TTY for CLI tools (-t)
+    ports:
+      - "1455:1455"   # Codex OAuth callback port
+    volumes:
+      # Persist credentials between runs (named volumes)
+      - cli-config:/home/workspace/.config
+      - claude-credentials:/home/workspace/.claude
+      - codex-credentials:/home/workspace/.codex
+      - gemini-credentials:/home/workspace/.gemini
+      - cursor-credentials:/home/workspace/.cursor
+      - opencode-credentials:/home/workspace/.local/share/opencode
+      # Mount scripts for easy editing during development
+      - ../scripts:/app/scripts:ro
+      # Shared volume for daemon communication
+      - relay-data:/tmp/relay-data
+    environment:
+      - TERM=xterm-256color
+      # Disable auto-updates for deterministic testing
+      - DISABLE_AUTOUPDATER=1
+      - CODEX_CHECK_FOR_UPDATES=false
+      - CODEX_DISABLE_AUTOUPDATE=1
+      # Daemon URL (when running with daemon profile)
+      - RELAY_DAEMON_URL=http://daemon:3377
+    depends_on:
+      daemon:
+        condition: service_healthy
+        required: false  # Make daemon optional
+
+  # Optional daemon service for full integration testing
+  # Run with: docker compose --profile daemon up
+  daemon:
+    image: node:20-slim
+    profiles: [daemon]
+    working_dir: /app
+    volumes:
+      # Mount built daemon package
+      - ../../daemon/dist:/app/dist:ro
+      - ../../daemon/package.json:/app/package.json:ro
+      - ../../daemon/node_modules:/app/node_modules:ro
+      # Shared data directory
+      - relay-data:/tmp/relay-data
+    environment:
+      - RELAY_PORT=3377
+      - RELAY_DATA_DIR=/tmp/relay-data
+      - DEBUG=${DEBUG:-}
+    ports:
+      - "3377:3377"
+    command: ["node", "dist/server.js"]
+    healthcheck:
+      test: ["CMD", "curl", "-sf", "http://localhost:3377/health", "||", "exit", "1"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+
+volumes:
+  cli-config:
+  claude-credentials:
+  codex-credentials:
+  gemini-credentials:
+  cursor-credentials:
+  opencode-credentials:
+  relay-data:

package/packages/cli-tester/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/cli-tester",
-  "version": "2.0.29",
+  "version": "2.0.32",
   "description": "Manual interactive testing for CLI authentication flows",
   "type": "module",
   "main": "dist/index.js",

package/packages/cli-tester/src/index.ts

@@ -0,0 +1,40 @@
+/**
+ * CLI Auth Tester - Manual interactive testing for CLI authentication flows
+ *
+ * This package provides utilities for testing CLI authentication in a Docker container.
+ * Primary use case is debugging auth issues with various CLI tools (Claude, Codex, Gemini, etc.)
+ *
+ * @example
+ * ```bash
+ * # Start the test environment
+ * npm run cli-tester:start
+ *
+ * # Inside container, test a CLI
+ * ./scripts/test-cli.sh claude
+ *
+ * # Verify credentials
+ * ./scripts/verify-auth.sh claude
+ * ```
+ */
+
+export {
+  RelayPtyClient,
+  createClient,
+  getSocketPath,
+  type InjectRequest,
+  type InjectResponse,
+  type StatusRequest,
+  type StatusResponse,
+  type RelayPtyResponse,
+} from './utils/socket-client.js';
+
+export {
+  checkCredentials,
+  clearCredentials,
+  checkAllCredentials,
+  clearAllCredentials,
+  getCredentialPath,
+  getConfigPaths,
+  type CLIType,
+  type CredentialCheck,
+} from './utils/credential-check.js';