gopherhole_openclaw_a2a 0.3.14 → 0.4.0

package/src/gateway-client.ts

@@ -1,328 +0,0 @@
-/**
- * Gateway WebSocket Client
- * Sends messages to the Clawdbot gateway via its WebSocket protocol
- * 
- * chat.send is non-blocking - it returns a runId immediately and
- * streams the response via chat events. We accumulate deltas and
- * resolve when we get state: "final".
- */
-
-import WebSocket from 'ws';
-import { v4 as uuidv4 } from 'uuid';
-import { readFileSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-
-interface PendingRequest {
-  resolve: (result: unknown) => void;
-  reject: (error: Error) => void;
-  timeout: NodeJS.Timeout;
-}
-
-interface PendingChat {
-  resolve: (result: { text: string }) => void;
-  reject: (error: Error) => void;
-  timeout: NodeJS.Timeout;
-  latestText: string;  // Each delta is the full message so far, not incremental
-}
-
-let ws: WebSocket | null = null;
-let pendingRequests: Map<string, PendingRequest> = new Map();
-let pendingChats: Map<string, PendingChat> = new Map(); // keyed by runId
-let connected = false;
-let handshakeComplete = false;
-
-function getGatewayToken(): string | null {
-  try {
-    const configPath = join(homedir(), '.clawdbot', 'clawdbot.json');
-    const config = JSON.parse(readFileSync(configPath, 'utf8'));
-    return config?.gateway?.auth?.token ?? null;
-  } catch {
-    return null;
-  }
-}
-
-export async function connectToGateway(port = 18789): Promise<void> {
-  if (ws && connected && handshakeComplete) return;
-
-  const token = getGatewayToken();
-
-  return new Promise((resolve, reject) => {
-    ws = new WebSocket(`ws://127.0.0.1:${port}`);
-
-    const timeout = setTimeout(() => {
-      ws?.terminate();
-      reject(new Error('Gateway connection timeout'));
-    }, 10000);
-
-    ws.on('open', () => {
-      console.log('[a2a] Connected to gateway WebSocket, sending handshake...');
-      connected = true;
-      
-      // Send connect handshake
-      const connectId = uuidv4();
-      
-      const connectFrame = {
-        type: 'req',
-        id: connectId,
-        method: 'connect',
-        params: {
-          minProtocol: 3,
-          maxProtocol: 3,
-          client: {
-            id: 'gateway-client',
-            displayName: 'A2A Channel Plugin',
-            version: '0.3.4',
-            platform: process.platform,
-            mode: 'backend',
-          },
-          caps: [],
-          auth: token ? { token } : undefined,
-          role: 'operator',
-          scopes: ['operator.admin'],
-        },
-      };
-      
-      pendingRequests.set(connectId, {
-        resolve: () => {
-          clearTimeout(timeout);
-          handshakeComplete = true;
-          console.log('[a2a] Gateway handshake complete');
-          resolve();
-        },
-        reject: (err) => {
-          clearTimeout(timeout);
-          reject(err);
-        },
-        timeout: setTimeout(() => {
-          pendingRequests.delete(connectId);
-          reject(new Error('Gateway handshake timeout'));
-        }, 5000),
-      });
-      
-      ws!.send(JSON.stringify(connectFrame));
-    });
-
-    ws.on('message', (data) => {
-      try {
-        const msg = JSON.parse(data.toString());
-        
-        // Log all non-tick messages for debugging
-        if (msg.type !== 'tick') {
-          console.log(`[a2a] Gateway msg: type=${msg.type}, event=${msg.event ?? 'n/a'}, id=${msg.id ?? 'n/a'}`);
-        }
-        
-        // Handle response frames (for RPC calls)
-        if (msg.type === 'res' && msg.id && pendingRequests.has(msg.id)) {
-          const pending = pendingRequests.get(msg.id)!;
-          clearTimeout(pending.timeout);
-          pendingRequests.delete(msg.id);
-          
-          if (msg.error) {
-            pending.reject(new Error(msg.error.message || 'RPC error'));
-          } else {
-            // Protocol uses 'payload' not 'result'
-            pending.resolve(msg.payload);
-          }
-          return;
-        }
-        
-        // Handle chat events (streaming responses)
-        if (msg.type === 'event' && msg.event === 'chat') {
-          handleChatEvent(msg.payload);
-          return;
-        }
-        
-        // Handle tick frames (keepalive)
-        if (msg.type === 'tick') {
-          // Could respond with tick ack if needed
-        }
-      } catch (err) {
-        console.error('[a2a] Failed to parse gateway message:', err);
-      }
-    });
-
-    ws.on('close', () => {
-      connected = false;
-      handshakeComplete = false;
-      ws = null;
-      console.log('[a2a] Disconnected from gateway WebSocket');
-      
-      // Reject all pending chats
-      for (const [runId, pending] of pendingChats) {
-        clearTimeout(pending.timeout);
-        pending.reject(new Error('Gateway connection closed'));
-      }
-      pendingChats.clear();
-    });
-
-    ws.on('error', (err) => {
-      clearTimeout(timeout);
-      console.error('[a2a] Gateway WebSocket error:', err.message);
-      reject(err);
-    });
-  });
-}
-
-function extractTextContent(content: unknown): string {
-  if (typeof content === 'string') {
-    return content;
-  }
-  if (Array.isArray(content)) {
-    // Content blocks array: [{ type: 'text', text: '...' }, ...]
-    return content
-      .filter((block: unknown) => 
-        typeof block === 'object' && block !== null && 
-        (block as Record<string, unknown>).type === 'text'
-      )
-      .map((block: unknown) => (block as { text?: string }).text ?? '')
-      .join('');
-  }
-  if (typeof content === 'object' && content !== null) {
-    // Single content block or unknown structure
-    const obj = content as Record<string, unknown>;
-    if (obj.text && typeof obj.text === 'string') {
-      return obj.text;
-    }
-  }
-  return '';
-}
-
-function handleChatEvent(payload: {
-  runId: string;
-  sessionKey: string;
-  seq: number;
-  state: 'delta' | 'final' | 'aborted' | 'error';
-  message?: { role?: string; content?: unknown };
-  errorMessage?: string;
-}): void {
-  const pending = pendingChats.get(payload.runId);
-  if (!pending) {
-    // Not a chat we're tracking
-    return;
-  }
-
-  // Detailed logging for debugging relay issues
-  console.log(`[a2a] Chat event: runId=${payload.runId}, state=${payload.state}, seq=${payload.seq}, role=${payload.message?.role}`);
-  
-  if (payload.state === 'delta' || payload.state === 'final') {
-    console.log(`[a2a] Chat content (${payload.state}): ${JSON.stringify(payload.message?.content)?.slice(0, 300)}`);
-  }
-
-  if (payload.state === 'delta') {
-    // Each delta contains the full message so far, not incremental
-    if (payload.message?.role === 'assistant' && payload.message?.content) {
-      const text = extractTextContent(payload.message.content);
-      if (text) {
-        pending.latestText = text;
-        console.log(`[a2a] Updated latestText (delta): "${text.slice(0, 100)}..." (len=${text.length})`);
-      }
-    } else {
-      console.log(`[a2a] Skipping delta - role=${payload.message?.role}, hasContent=${!!payload.message?.content}`);
-    }
-  } else if (payload.state === 'final') {
-    // Final message - resolve with latest text
-    clearTimeout(pending.timeout);
-    pendingChats.delete(payload.runId);
-    
-    // Use final content if available, otherwise use latest delta
-    if (payload.message?.role === 'assistant' && payload.message?.content) {
-      const text = extractTextContent(payload.message.content);
-      if (text) {
-        pending.latestText = text;
-        console.log(`[a2a] Updated latestText (final): "${text.slice(0, 100)}..." (len=${text.length})`);
-      }
-    }
-    
-    console.log(`[a2a] Chat complete - resolving with: "${pending.latestText.slice(0, 150)}..." (total ${pending.latestText.length} chars)`);
-    pending.resolve({ text: pending.latestText });
-  } else if (payload.state === 'error' || payload.state === 'aborted') {
-    clearTimeout(pending.timeout);
-    pendingChats.delete(payload.runId);
-    console.error(`[a2a] Chat ${payload.state}: ${payload.errorMessage}`);
-    pending.reject(new Error(payload.errorMessage || `Chat ${payload.state}`));
-  }
-}
-
-export async function callGateway(method: string, params: Record<string, unknown>, timeoutMs = 300000): Promise<unknown> {
-  if (!ws || !connected || !handshakeComplete) {
-    await connectToGateway();
-  }
-
-  const id = uuidv4();
-
-  return new Promise((resolve, reject) => {
-    const timeout = setTimeout(() => {
-      pendingRequests.delete(id);
-      reject(new Error('Gateway request timeout'));
-    }, timeoutMs);
-
-    pendingRequests.set(id, { resolve, reject, timeout });
-
-    const frame = {
-      type: 'req',
-      id,
-      method,
-      params,
-    };
-    
-    ws!.send(JSON.stringify(frame));
-  });
-}
-
-/**
- * Send a chat message and wait for the full response.
- * chat.send is non-blocking - returns runId immediately, response streams via events.
- */
-export async function sendChatMessage(
-  sessionKey: string, 
-  message: string,
-  timeoutMs = 300000
-): Promise<{ text: string }> {
-  if (!ws || !connected || !handshakeComplete) {
-    await connectToGateway();
-  }
-
-  const idempotencyKey = uuidv4();
-
-  // First, send the chat.send request
-  console.log(`[a2a] Sending chat.send: sessionKey=${sessionKey}, idempotencyKey=${idempotencyKey}`);
-  
-  const result = await callGateway('chat.send', {
-    sessionKey,
-    message,
-    idempotencyKey,
-  }) as { runId: string; status: string } | undefined;
-
-  console.log(`[a2a] chat.send raw result:`, JSON.stringify(result));
-
-  if (!result.runId) {
-    throw new Error('chat.send did not return a runId');
-  }
-
-  // Now wait for chat events to complete
-  return new Promise((resolve, reject) => {
-    const timeout = setTimeout(() => {
-      pendingChats.delete(result.runId);
-      reject(new Error('Chat response timeout'));
-    }, timeoutMs);
-
-    pendingChats.set(result.runId, {
-      resolve,
-      reject,
-      timeout,
-      latestText: '',
-    });
-  });
-}
-
-export function disconnectFromGateway(): void {
-  if (ws) {
-    ws.close();
-    ws = null;
-    connected = false;
-    handshakeComplete = false;
-  }
-  pendingChats.clear();
-  pendingRequests.clear();
-}

package/src/logger.ts

@@ -1,118 +0,0 @@
-/**
- * A2A Plugin Logger
- * Writes to both console and a dedicated log file for dashboard viewing
- */
-
-import { appendFileSync, mkdirSync, existsSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-
-const LOG_DIR = join(homedir(), '.clawdbot', 'logs');
-const A2A_LOG_FILE = join(LOG_DIR, 'a2a.log');
-
-// Ensure log directory exists
-try {
-  if (!existsSync(LOG_DIR)) {
-    mkdirSync(LOG_DIR, { recursive: true });
-  }
-} catch {
-  // Ignore if we can't create the directory
-}
-
-export interface A2ALogEntry {
-  timestamp: string;
-  level: 'info' | 'warn' | 'error' | 'debug';
-  event: string;
-  taskId?: string;
-  from?: string;
-  to?: string;
-  message?: string;
-  data?: Record<string, unknown>;
-}
-
-function writeLog(entry: A2ALogEntry): void {
-  const line = JSON.stringify(entry) + '\n';
-  
-  // Console output (colored)
-  const prefix = `[a2a:${entry.event}]`;
-  const msg = entry.message || '';
-  
-  switch (entry.level) {
-    case 'error':
-      console.error(prefix, msg, entry.data || '');
-      break;
-    case 'warn':
-      console.warn(prefix, msg, entry.data || '');
-      break;
-    default:
-      console.log(prefix, msg, entry.data || '');
-  }
-  
-  // File output (JSON lines)
-  try {
-    appendFileSync(A2A_LOG_FILE, line);
-  } catch {
-    // Ignore file write errors
-  }
-}
-
-export const a2aLog = {
-  info(event: string, message: string, data?: Record<string, unknown>): void {
-    writeLog({ timestamp: new Date().toISOString(), level: 'info', event, message, data });
-  },
-  
-  warn(event: string, message: string, data?: Record<string, unknown>): void {
-    writeLog({ timestamp: new Date().toISOString(), level: 'warn', event, message, data });
-  },
-  
-  error(event: string, message: string, data?: Record<string, unknown>): void {
-    writeLog({ timestamp: new Date().toISOString(), level: 'error', event, message, data });
-  },
-  
-  // Structured event logging for dashboard
-  messageReceived(from: string, taskId: string | undefined, text: string): void {
-    writeLog({
-      timestamp: new Date().toISOString(),
-      level: 'info',
-      event: 'message_received',
-      from,
-      taskId,
-      message: text.slice(0, 200),
-      data: { textLength: text.length },
-    });
-  },
-  
-  messageProcessing(taskId: string | undefined, sessionKey: string): void {
-    writeLog({
-      timestamp: new Date().toISOString(),
-      level: 'info',
-      event: 'message_processing',
-      taskId,
-      data: { sessionKey },
-    });
-  },
-  
-  responseCaptured(taskId: string | undefined, text: string): void {
-    writeLog({
-      timestamp: new Date().toISOString(),
-      level: 'info',
-      event: 'response_captured',
-      taskId,
-      message: text.slice(0, 200),
-      data: { textLength: text.length },
-    });
-  },
-  
-  responseSent(taskId: string, to: string, success: boolean): void {
-    writeLog({
-      timestamp: new Date().toISOString(),
-      level: success ? 'info' : 'error',
-      event: 'response_sent',
-      taskId,
-      to,
-      data: { success },
-    });
-  },
-};
-
-export const A2A_LOG_FILE_PATH = A2A_LOG_FILE;

package/src/types.ts

@@ -1,75 +0,0 @@
-/**
- * A2A Protocol Types
- * Compatible with @gopherhole/sdk
- */
-
-export interface A2AMessage {
-  type: 'message' | 'response' | 'chunk' | 'status';
-  taskId: string;
-  contextId?: string;
-  from?: string;
-  content?: {
-    parts: Array<{ kind: string; text?: string; data?: unknown; mimeType?: string }>;
-  };
-  status?: 'working' | 'completed' | 'failed' | 'canceled';
-  error?: string;
-}
-
-export interface A2ASkill {
-  id: string;
-  name: string;
-  description?: string;
-  tags?: string[];
-  examples?: string[];
-  inputModes?: string[];
-  outputModes?: string[];
-}
-
-export interface A2AAgentCard {
-  name: string;
-  description?: string;
-  url?: string;
-  version?: string;
-  skills?: A2ASkill[];
-}
-
-export interface A2AResponse {
-  text: string;
-  status: string;
-  from?: string;
-}
-
-/**
- * A2A Channel Config (flat structure)
- * 
- * Example:
- * {
- *   "channels": {
- *     "a2a": {
- *       "enabled": true,
- *       "bridgeUrl": "wss://hub.gopherhole.ai/ws",
- *       "apiKey": "gph_your_api_key"
- *     }
- *   }
- * }
- */
-export interface A2AChannelConfig {
-  enabled?: boolean;
-  bridgeUrl?: string;           // WebSocket URL (default: wss://hub.gopherhole.ai/ws)
-  apiKey?: string;              // GopherHole API key (gph_...)
-  agentId?: string;             // Our agent ID (default: "openclaw")
-  agentName?: string;           // Display name for agent card
-  agentCard?: A2AAgentCard;     // Custom agent card (overrides defaults)
-  reconnectIntervalMs?: number; // Reconnect delay (default: 5000)
-  requestTimeoutMs?: number;    // Request timeout (default: 180000)
-}
-
-export interface ResolvedA2AAccount {
-  accountId: string;
-  name: string;
-  enabled: boolean;
-  configured: boolean;
-  agentId: string;
-  bridgeUrl: string | null;
-  config: A2AChannelConfig;
-}

package/test-image.mjs

@@ -1,29 +0,0 @@
-import { GopherHole } from '@gopherhole/sdk';
-import { readFileSync } from 'fs';
-
-const gph = new GopherHole({
-  apiKey: 'gph_a3ed7c3f30e5415e9dc92b72c1c05b78',
-  hubUrl: 'wss://gopherhole.ai/ws',
-});
-
-await gph.connect();
-console.log('Connected, sending image...');
-
-const imagePath = '/Users/brettwaterson/.marketclaw/images/1771822365256-A3kAAzoE.jpg';
-const imageData = readFileSync(imagePath).toString('base64');
-console.log('Image size:', imageData.length, 'chars');
-
-const task = await gph.send('agent-70153299', {
-  role: 'agent',
-  parts: [
-    { kind: 'text', text: 'What do you see in this image? Please describe it.' },
-    { kind: 'data', mimeType: 'image/jpeg', data: imageData },
-  ],
-});
-
-console.log('Task created:', task.id);
-
-const completed = await gph.waitForTask(task.id, { maxWaitMs: 60000 });
-console.log('Response:', completed.artifacts?.[0]?.parts?.[0]?.text || JSON.stringify(completed));
-
-gph.disconnect();

package/test-image2.mjs

@@ -1,37 +0,0 @@
-import { GopherHole } from '@gopherhole/sdk';
-import { readFileSync } from 'fs';
-
-const gph = new GopherHole({
-  apiKey: 'gph_a3ed7c3f30e5415e9dc92b72c1c05b78',
-  hubUrl: 'wss://gopherhole.ai/ws',
-});
-
-await gph.connect();
-console.log('Connected as:', gph.id);
-
-const imagePath = '/Users/brettwaterson/.marketclaw/images/1771822365256-A3kAAzoE.jpg';
-const imageData = readFileSync(imagePath).toString('base64');
-console.log('Image size:', imageData.length, 'chars (base64)');
-
-const payload = {
-  role: 'agent',
-  parts: [
-    { kind: 'text', text: 'Describe this image please.' },
-    { kind: 'data', mimeType: 'image/jpeg', data: imageData },
-  ],
-};
-
-console.log('Sending payload with', payload.parts.length, 'parts');
-console.log('Part 0:', { kind: payload.parts[0].kind, hasText: !!payload.parts[0].text });
-console.log('Part 1:', { kind: payload.parts[1].kind, mimeType: payload.parts[1].mimeType, dataLen: payload.parts[1].data?.length });
-
-const task = await gph.send('agent-70153299', payload);
-console.log('Task:', task.id, 'Status:', task.status?.state);
-
-const completed = await gph.waitForTask(task.id, { maxWaitMs: 60000 });
-console.log('Final status:', completed.status?.state);
-
-const response = completed.artifacts?.[0]?.parts?.[0]?.text;
-console.log('Response:', response?.slice(0, 300) || 'No text in response');
-
-gph.disconnect();

package/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "declaration": true,
-    "outDir": "dist",
-    "rootDir": ".",
-    "strict": false,
-    "noImplicitAny": false,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["index.ts", "src/**/*.ts"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts"]
-}

package/vitest.config.ts

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