@axiom-lattice/cli-a2a 0.1.1

package/__tests__/opencode-executor.test.ts

@@ -0,0 +1,159 @@
+/**
+ * Tests for OpenCode A2A Executor.
+ *
+ * These are unit tests that mock the OpenCode SDK.
+ * Integration tests require a running opencode server.
+ */
+
+import { OpenCodeExecutor } from '../src/executors/opencode/executor';
+import type { AgentConfig } from '../src/config/types';
+import { resolveDefaults } from '../src/config/defaults';
+
+function createMockConfig(overrides?: Partial<AgentConfig>): Required<AgentConfig> {
+  const base: Partial<AgentConfig> = {
+    provider: 'opencode',
+    agentCard: {
+      name: 'Test Agent',
+      description: 'Test agent for unit tests',
+    },
+    opencode: {
+      baseUrl: 'http://localhost:4096',
+      projectDirectory: '/tmp/test-workspace',
+      model: 'anthropic/claude-sonnet-4',
+      agent: 'code-assistant',
+    },
+    session: {
+      ttl: 3_600_000,
+      cleanupInterval: 300_000,
+      reuseByContext: true,
+      titlePrefix: 'A2A Test',
+    },
+    features: {
+      autoApprovePermissions: true,
+      autoAnswerQuestions: true,
+      streamArtifactChunks: false,
+      enablePollingFallback: true,
+    },
+    timeouts: {
+      prompt: 300_000,
+      pollingInterval: 1_000,
+      healthCheck: 30_000,
+    },
+    logging: {
+      level: 'info',
+    },
+    server: {
+      port: 3000,
+      hostname: '0.0.0.0',
+      advertiseHost: 'localhost',
+      advertiseProtocol: 'http',
+    },
+    ...overrides,
+  };
+  return resolveDefaults(base);
+}
+
+describe('OpenCodeExecutor', () => {
+  it('should create an executor with valid config', () => {
+    const config = createMockConfig();
+    const executor = new OpenCodeExecutor(config);
+    expect(executor).toBeDefined();
+  });
+
+  it('should have initialize method', () => {
+    const config = createMockConfig();
+    const executor = new OpenCodeExecutor(config);
+    expect(typeof executor.initialize).toBe('function');
+  });
+
+  it('should have shutdown method', () => {
+    const config = createMockConfig();
+    const executor = new OpenCodeExecutor(config);
+    expect(typeof executor.shutdown).toBe('function');
+  });
+
+  it('should have execute method', () => {
+    const config = createMockConfig();
+    const executor = new OpenCodeExecutor(config);
+    expect(typeof executor.execute).toBe('function');
+  });
+
+  it('should have cancelTask method', () => {
+    const config = createMockConfig();
+    const executor = new OpenCodeExecutor(config);
+    expect(typeof executor.cancelTask).toBe('function');
+  });
+
+  it('should not be initialized until initialize is called', () => {
+    const config = createMockConfig();
+    const executor = new OpenCodeExecutor(config);
+    // @ts-expect-error testing private field
+    expect(executor.initialized).toBe(false);
+  });
+
+  it('should handle config with empty model', () => {
+    const config = createMockConfig({
+      opencode: { model: '' },
+    });
+    const executor = new OpenCodeExecutor(config);
+    expect(executor).toBeDefined();
+  });
+
+  it('should handle config with system prompt', () => {
+    const config = createMockConfig({
+      opencode: {
+        systemPrompt: 'You are a helpful assistant.',
+        systemPromptMode: 'replace',
+      },
+    });
+    const executor = new OpenCodeExecutor(config);
+    expect(executor).toBeDefined();
+  });
+
+  it('should cleanup on shutdown', async () => {
+    const config = createMockConfig();
+    const executor = new OpenCodeExecutor(config);
+    await executor.shutdown();
+    // @ts-expect-error testing private field
+    expect(executor.initialized).toBe(false);
+    // @ts-expect-error testing private field
+    expect(executor.client).toBeNull();
+  });
+
+  it('should allow double initialization without error', async () => {
+    const config = createMockConfig({
+      features: {
+        autoApprovePermissions: false,
+        autoAnswerQuestions: false,
+      },
+    });
+    const executor = new OpenCodeExecutor(config);
+
+    // First call will fail because no server, but should set initialized=false
+    try { await executor.initialize(); } catch { /* no server */ }
+    // Second call should be safe
+    try { await executor.initialize(); } catch { /* no server */ }
+  });
+});
+
+describe('Config resolution', () => {
+  it('should resolve defaults when no config file provided', () => {
+    const { resolveConfig } = require('../src/config/loader');
+    const config = resolveConfig(undefined);
+    expect(config.provider).toBe('opencode');
+    expect(config.agentCard.name).toBeDefined();
+    expect(config.server?.port).toBeDefined();
+  });
+
+  it('should merge CLI overrides into defaults', () => {
+    const { resolveConfig } = require('../src/config/loader');
+    const config = resolveConfig(undefined, {
+      provider: 'opencode',
+      server: { port: 8080 },
+      agentCard: { name: 'Custom Agent', description: 'Custom desc' },
+    });
+    expect(config.provider).toBe('opencode');
+    expect(config.server?.port).toBe(8080);
+    expect(config.agentCard.name).toBe('Custom Agent');
+  });
+});

package/agents/opencode-example/config.json

@@ -0,0 +1,64 @@
+{
+  "provider": "opencode",
+  "agentCard": {
+    "name": "OpenCode A2A Agent",
+    "description": "An A2A agent powered by OpenCode — a multi-provider coding assistant.",
+    "version": "0.1.0",
+    "skills": [
+      {
+        "id": "code-generation",
+        "name": "Code Generation",
+        "description": "Generate, modify, and refactor code across multiple languages",
+        "tags": ["coding", "typescript", "python", "refactoring"]
+      },
+      {
+        "id": "file-operations",
+        "name": "File Operations",
+        "description": "Read, write, edit, and search files in the workspace",
+        "tags": ["filesystem", "search"]
+      },
+      {
+        "id": "shell-commands",
+        "name": "Shell Commands",
+        "description": "Execute shell commands in a sandboxed environment",
+        "tags": ["bash", "terminal"]
+      }
+    ]
+  },
+  "server": {
+    "port": 3000,
+    "hostname": "0.0.0.0",
+    "advertiseHost": "localhost",
+    "advertiseProtocol": "http"
+  },
+  "session": {
+    "titlePrefix": "A2A",
+    "reuseByContext": true,
+    "ttl": 3600000,
+    "cleanupInterval": 300000
+  },
+  "features": {
+    "autoApprovePermissions": true,
+    "autoAnswerQuestions": true,
+    "streamArtifactChunks": false,
+    "enablePollingFallback": true
+  },
+  "timeouts": {
+    "prompt": 600000,
+    "pollingInterval": 2000,
+    "healthCheck": 30000
+  },
+  "logging": {
+    "level": "info"
+  },
+  "opencode": {
+    "baseUrl": "http://localhost:4096",
+    "projectDirectory": "",
+    "model": "",
+    "agent": "",
+    "systemPrompt": "",
+    "systemPromptMode": "append",
+    "contextFile": "context.md",
+    "contextPrompt": ""
+  }
+}

package/dist/bridge-7ZUDKCZT.mjs

@@ -0,0 +1,271 @@
+import {
+  logger
+} from "./chunk-VZEH3EPJ.mjs";
+
+// src/bridge.ts
+import { connect } from "net";
+import { randomBytes } from "crypto";
+var log = logger.child("bridge");
+var SimpleWs = class {
+  constructor() {
+    this.socket = null;
+    this.buffer = Buffer.alloc(0);
+    this.handshaking = true;
+    this.httpBuffer = "";
+  }
+  connect(urlStr, apiKey) {
+    const url = new URL(urlStr);
+    const host = url.hostname;
+    const port = parseInt(url.port) || (url.protocol === "wss:" ? 443 : 80);
+    const path = url.pathname + url.search;
+    const key = randomBytes(16).toString("base64");
+    const req = connect({ host, port }, () => {
+      const headers = [
+        `GET ${path} HTTP/1.1`,
+        `Host: ${host}:${port}`,
+        "Upgrade: websocket",
+        "Connection: Upgrade",
+        `Sec-WebSocket-Key: ${key}`,
+        "Sec-WebSocket-Version: 13",
+        `x-api-key: ${apiKey}`,
+        "",
+        ""
+      ].join("\r\n");
+      if (this.socket) {
+        this.socket.write(headers);
+      }
+    });
+    this.socket = req;
+    req.on("data", (chunk) => {
+      this.buffer = Buffer.concat([this.buffer, chunk]);
+      if (this.handshaking) {
+        this.httpBuffer += chunk.toString();
+        const headerEnd = this.httpBuffer.indexOf("\r\n\r\n");
+        if (headerEnd === -1) return;
+        const header = this.httpBuffer.substring(0, headerEnd);
+        const statusLine = header.split("\r\n")[0] || "";
+        if (!statusLine.startsWith("HTTP/1.1 101")) {
+          const bodyStart = headerEnd + 4;
+          const bodyText = this.httpBuffer.substring(bodyStart).trim();
+          const errMsg = statusLine ? `WebSocket upgrade rejected: ${statusLine}` : "WebSocket upgrade failed: no status line";
+          this.onerror?.(new Error(errMsg + (bodyText ? ` (${bodyText.slice(0, 200)})` : "")));
+          this.socket?.destroy();
+          this.socket = null;
+          return;
+        }
+        this.handshaking = false;
+        const remaining = this.buffer.subarray(headerEnd + 4);
+        this.buffer = remaining;
+        this.httpBuffer = "";
+        if (this.onopen) this.onopen();
+        if (remaining.length === 0) return;
+      }
+      while (this.buffer.length >= 2) {
+        const opcode = this.buffer[0] & 15;
+        const masked = (this.buffer[1] & 128) !== 0;
+        let offset = 2;
+        let payloadLen = this.buffer[1] & 127;
+        if (payloadLen === 126) {
+          if (this.buffer.length < 4) break;
+          payloadLen = this.buffer.readUInt16BE(2);
+          offset = 4;
+        } else if (payloadLen === 127) {
+          if (this.buffer.length < 10) break;
+          const hi = this.buffer.readUInt32BE(2);
+          const lo = this.buffer.readUInt32BE(6);
+          payloadLen = hi * 4294967296 + lo;
+          offset = 10;
+        }
+        if (this.buffer.length < offset + payloadLen) break;
+        const payload = this.buffer.subarray(offset, offset + payloadLen);
+        this.buffer = this.buffer.subarray(offset + payloadLen);
+        if (masked) {
+          const mask = payload.subarray(0, 4);
+          const data = payload.subarray(4);
+          for (let i = 0; i < data.length; i++) {
+            data[i] ^= mask[i % 4];
+          }
+          if (opcode === 1) {
+            this.onmessage?.(data.toString());
+          }
+        } else {
+          if (opcode === 1) {
+            this.onmessage?.(payload.toString());
+          } else if (opcode === 8) {
+            this.onclose?.(1e3);
+            return;
+          } else if (opcode === 9) {
+            const pong = Buffer.from([138, 0]);
+            this.socket?.write(pong);
+          }
+        }
+      }
+    });
+    req.on("error", (err) => {
+      this.onerror?.(err);
+    });
+    req.on("close", () => {
+      this.onclose?.(1006);
+    });
+  }
+  send(data) {
+    if (!this.socket) return;
+    const payload = Buffer.from(data, "utf-8");
+    const len = payload.length;
+    const maskKey = randomBytes(4);
+    const masked = Buffer.alloc(len);
+    for (let i = 0; i < len; i++) {
+      masked[i] = payload[i] ^ maskKey[i % 4];
+    }
+    let header;
+    if (len < 126) {
+      header = Buffer.alloc(6);
+      header[0] = 129;
+      header[1] = 128 | len;
+      maskKey.copy(header, 2);
+    } else if (len < 65536) {
+      header = Buffer.alloc(8);
+      header[0] = 129;
+      header[1] = 128 | 126;
+      header.writeUInt16BE(len, 2);
+      maskKey.copy(header, 4);
+    } else {
+      header = Buffer.alloc(14);
+      header[0] = 129;
+      header[1] = 128 | 127;
+      header.writeUInt32BE(0, 2);
+      header.writeUInt32BE(len, 6);
+      maskKey.copy(header, 10);
+    }
+    this.socket.write(Buffer.concat([header, masked]));
+  }
+  close() {
+    if (!this.socket) return;
+    const frame = Buffer.from([136, 0]);
+    this.socket.write(frame);
+    this.socket.destroy();
+    this.socket = null;
+  }
+};
+var BridgeClient = class {
+  constructor(config) {
+    this.config = config;
+    this.ws = null;
+    this.running = false;
+    this.reconnectTimer = null;
+  }
+  /**
+   * Start the bridge — connect WebSocket and begin serving proxy requests.
+   * Returns a promise that resolves when connected. Reconnects on disconnect.
+   */
+  async start() {
+    this.running = true;
+    return new Promise((resolve, reject) => {
+      this.ws = new SimpleWs();
+      let firstConnect = true;
+      this.ws.onopen = () => {
+        log.info("Bridge connected");
+        this.ws.send(JSON.stringify({
+          type: "agent:register",
+          agentId: this.config.agentId,
+          agentCard: this.config.agentCard
+        }));
+      };
+      this.ws.onmessage = async (raw) => {
+        let msg;
+        try {
+          msg = JSON.parse(raw);
+        } catch {
+          return;
+        }
+        if (msg.type === "agent:registered") {
+          log.info("Agent registered via bridge", { agentId: this.config.agentId });
+          if (firstConnect) {
+            firstConnect = false;
+            resolve();
+          }
+          return;
+        }
+        if (msg.type === "http:request") {
+          this.handleHttpRequest(msg);
+        }
+      };
+      this.ws.onclose = () => {
+        log.warn("Bridge disconnected, reconnecting...");
+        if (this.running) {
+          this.reconnectTimer = setTimeout(
+            () => this.start().catch(() => {
+            }),
+            this.config.reconnectDelay ?? 5e3
+          );
+        }
+      };
+      this.ws.onerror = (err) => {
+        log.error("Bridge error", { error: err.message });
+        if (firstConnect) {
+          firstConnect = false;
+          reject(err);
+        }
+      };
+      log.info("Connecting bridge", { url: this.config.bridgeUrl });
+      this.ws.connect(this.config.bridgeUrl, this.config.apiKey);
+    });
+  }
+  /**
+   * Stop the bridge.
+   */
+  stop() {
+    this.running = false;
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+    this.ws?.close();
+    this.ws = null;
+    log.info("Bridge stopped");
+  }
+  // ── Internal ────────────────────────────────────────────────────────────
+  async handleHttpRequest(msg) {
+    const requestId = msg.requestId;
+    const method = msg.method ?? "GET";
+    const path = msg.path ?? "/";
+    const headers = msg.headers ?? {};
+    const body = msg.body ?? "";
+    const url = `${this.config.localBaseUrl}${path}`;
+    try {
+      const fetchHeaders = { ...headers };
+      const fetchOpts = {
+        method,
+        headers: fetchHeaders,
+        signal: AbortSignal.timeout(3e5)
+      };
+      if (body && method !== "GET") {
+        fetchOpts.body = body;
+      }
+      const resp = await fetch(url, fetchOpts);
+      const responseBody = await resp.text();
+      const responseHeaders = {};
+      resp.headers.forEach((value, key) => {
+        responseHeaders[key] = value;
+      });
+      this.ws?.send(JSON.stringify({
+        type: "http:response",
+        requestId,
+        status: resp.status,
+        headers: responseHeaders,
+        body: responseBody
+      }));
+    } catch (err) {
+      log.error("Proxy request failed", { url, error: err.message });
+      this.ws?.send(JSON.stringify({
+        type: "http:error",
+        requestId,
+        message: err.message
+      }));
+    }
+  }
+};
+export {
+  BridgeClient
+};
+//# sourceMappingURL=bridge-7ZUDKCZT.mjs.map

package/dist/bridge-7ZUDKCZT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge.ts"],"sourcesContent":["/**\n * A2A Bridge Client — connects to the gateway's WebSocket bridge and\n * proxies HTTP requests from the gateway to the local A2A Express server.\n *\n * Enables agents behind NAT/firewall to receive A2A requests without\n * a public IP or SSH tunnel. The agent opens an outbound WebSocket (which\n * is almost never blocked), and the gateway pushes requests over it.\n */\n\nimport { connect } from 'node:net';\nimport { randomBytes } from 'node:crypto';\nimport { logger } from './logger.js';\n\nconst log = logger.child('bridge');\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\nexport interface BridgeConfig {\n  /** Gateway WebSocket URL (e.g. ws://gateway:8080/api/a2a/bridge) */\n  bridgeUrl: string;\n  /** API key for gateway auth (sent as x-api-key header during WebSocket upgrade) */\n  apiKey: string;\n  /** Agent ID to register as on the gateway */\n  agentId: string;\n  /** Full agent card object to advertise */\n  agentCard: Record<string, unknown>;\n  /** Local A2A server base URL to forward requests to */\n  localBaseUrl: string;\n  /** Reconnect delay in ms (default: 5000) */\n  reconnectDelay?: number;\n}\n\n// ─── Very lightweight WS client (no dependency) ─────────────────────────────\n// Uses Node.js built-in HTTP upgrade → WebSocket framing (RFC 6455 minimal).\n// Enough for JSON text frames. Avoids pulling in the ws library.\n\nclass SimpleWs {\n  private socket: ReturnType<typeof connect> | null = null;\n  private buffer = Buffer.alloc(0);\n  private handshaking = true;\n  private httpBuffer = '';\n\n  onopen?: () => void;\n  onmessage?: (data: string) => void;\n  onclose?: (code: number) => void;\n  onerror?: (err: Error) => void;\n\n  connect(urlStr: string, apiKey: string): void {\n    const url = new URL(urlStr);\n    const host = url.hostname;\n    const port = parseInt(url.port) || (url.protocol === 'wss:' ? 443 : 80);\n    const path = url.pathname + url.search;\n\n    const key = randomBytes(16).toString('base64');\n\n    const req = connect({ host, port }, () => {\n      // Send WebSocket upgrade handshake\n      const headers = [\n        `GET ${path} HTTP/1.1`,\n        `Host: ${host}:${port}`,\n        'Upgrade: websocket',\n        'Connection: Upgrade',\n        `Sec-WebSocket-Key: ${key}`,\n        'Sec-WebSocket-Version: 13',\n        `x-api-key: ${apiKey}`,\n        '',\n        '',\n      ].join('\\r\\n');\n\n      if (this.socket) {\n        this.socket.write(headers);\n      }\n    });\n\n    this.socket = req;\n\n    req.on('data', (chunk: Buffer) => {\n      this.buffer = Buffer.concat([this.buffer, chunk]);\n\n      // First, validate HTTP upgrade response\n      if (this.handshaking) {\n        this.httpBuffer += chunk.toString();\n        const headerEnd = this.httpBuffer.indexOf('\\r\\n\\r\\n');\n        if (headerEnd === -1) return; // not complete yet\n\n        const header = this.httpBuffer.substring(0, headerEnd);\n        const statusLine = header.split('\\r\\n')[0] || '';\n\n        if (!statusLine.startsWith('HTTP/1.1 101')) {\n          // Extract response body for diagnostics\n          const bodyStart = headerEnd + 4;\n          const bodyText = this.httpBuffer.substring(bodyStart).trim();\n          const errMsg = statusLine\n            ? `WebSocket upgrade rejected: ${statusLine}`\n            : 'WebSocket upgrade failed: no status line';\n          this.onerror?.(new Error(errMsg + (bodyText ? ` (${bodyText.slice(0, 200)})` : '')));\n          this.socket?.destroy();\n          this.socket = null;\n          return;\n        }\n\n        // Upgrade successful — discard HTTP header, keep any remaining data\n        this.handshaking = false;\n        const remaining = this.buffer.subarray(headerEnd + 4);\n        this.buffer = remaining;\n        this.httpBuffer = '';\n        if (this.onopen) this.onopen();\n\n        if (remaining.length === 0) return;\n        // Fall through to frame parsing below\n      }\n\n      // Parse WebSocket frames\n      while (this.buffer.length >= 2) {\n        const opcode = this.buffer[0] & 0x0f;\n        const masked = (this.buffer[1] & 0x80) !== 0;\n        let offset = 2;\n        let payloadLen = this.buffer[1] & 0x7f;\n\n        if (payloadLen === 126) {\n          if (this.buffer.length < 4) break;\n          payloadLen = this.buffer.readUInt16BE(2);\n          offset = 4;\n        } else if (payloadLen === 127) {\n          if (this.buffer.length < 10) break;\n          // readUInt32BE for high 32 bits (should be 0 for realistic payloads)\n          const hi = this.buffer.readUInt32BE(2);\n          const lo = this.buffer.readUInt32BE(6);\n          payloadLen = hi * 0x100000000 + lo;\n          offset = 10;\n        }\n\n        if (this.buffer.length < offset + payloadLen) break;\n\n        const payload = this.buffer.subarray(offset, offset + payloadLen);\n        this.buffer = this.buffer.subarray(offset + payloadLen);\n\n        if (masked) {\n          // Server→client frames shouldn't be masked per spec, but handle anyway\n          const mask = payload.subarray(0, 4);\n          const data = payload.subarray(4);\n          for (let i = 0; i < data.length; i++) {\n            data[i] ^= mask[i % 4];\n          }\n          if (opcode === 1) {\n            this.onmessage?.(data.toString());\n          }\n        } else {\n          if (opcode === 1) {\n            this.onmessage?.(payload.toString());\n          } else if (opcode === 8) {\n            this.onclose?.(1000);\n            return;\n          } else if (opcode === 9) {\n            // Ping — respond with pong\n            const pong = Buffer.from([0x8a, 0]);\n            this.socket?.write(pong);\n          }\n        }\n      }\n    });\n\n    req.on('error', (err: Error) => {\n      this.onerror?.(err);\n    });\n\n    req.on('close', () => {\n      this.onclose?.(1006);\n    });\n  }\n\n  send(data: string): void {\n    if (!this.socket) return;\n    const payload = Buffer.from(data, 'utf-8');\n    const len = payload.length;\n    const maskKey = randomBytes(4);\n\n    // RFC 6455: client MUST mask frames to server\n    const masked = Buffer.alloc(len);\n    for (let i = 0; i < len; i++) {\n      masked[i] = payload[i] ^ maskKey[i % 4];\n    }\n\n    let header: Buffer;\n    if (len < 126) {\n      header = Buffer.alloc(6);\n      header[0] = 0x81; // FIN + text opcode\n      header[1] = 0x80 | len; // MASK bit set + length\n      maskKey.copy(header, 2);\n    } else if (len < 65536) {\n      header = Buffer.alloc(8);\n      header[0] = 0x81;\n      header[1] = 0x80 | 126; // MASK + 126 marker\n      header.writeUInt16BE(len, 2);\n      maskKey.copy(header, 4);\n    } else {\n      header = Buffer.alloc(14);\n      header[0] = 0x81;\n      header[1] = 0x80 | 127; // MASK + 127 marker\n      header.writeUInt32BE(0, 2);\n      header.writeUInt32BE(len, 6);\n      maskKey.copy(header, 10);\n    }\n\n    this.socket.write(Buffer.concat([header, masked]));\n  }\n\n  close(): void {\n    if (!this.socket) return;\n    const frame = Buffer.from([0x88, 0x00]); // close frame\n    this.socket.write(frame);\n    this.socket.destroy();\n    this.socket = null;\n  }\n}\n\n// ─── Bridge Client ──────────────────────────────────────────────────────────\n\nexport class BridgeClient {\n  private ws: SimpleWs | null = null;\n  private running = false;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(private config: BridgeConfig) {}\n\n  /**\n   * Start the bridge — connect WebSocket and begin serving proxy requests.\n   * Returns a promise that resolves when connected. Reconnects on disconnect.\n   */\n  async start(): Promise<void> {\n    this.running = true;\n\n    return new Promise((resolve, reject) => {\n      this.ws = new SimpleWs();\n\n      let firstConnect = true;\n\n      this.ws.onopen = () => {\n        log.info('Bridge connected');\n        // Register with the gateway\n        this.ws!.send(JSON.stringify({\n          type: 'agent:register',\n          agentId: this.config.agentId,\n          agentCard: this.config.agentCard,\n        }));\n      };\n\n      this.ws.onmessage = async (raw: string) => {\n        let msg: Record<string, unknown>;\n        try {\n          msg = JSON.parse(raw);\n        } catch {\n          return;\n        }\n\n        if (msg.type === 'agent:registered') {\n          log.info('Agent registered via bridge', { agentId: this.config.agentId });\n          if (firstConnect) {\n            firstConnect = false;\n            resolve();\n          }\n          return;\n        }\n\n        if (msg.type === 'http:request') {\n          this.handleHttpRequest(msg);\n        }\n      };\n\n      this.ws.onclose = () => {\n        log.warn('Bridge disconnected, reconnecting...');\n        if (this.running) {\n          this.reconnectTimer = setTimeout(\n            () => this.start().catch(() => {}),\n            this.config.reconnectDelay ?? 5000,\n          );\n        }\n      };\n\n      this.ws.onerror = (err: Error) => {\n        log.error('Bridge error', { error: err.message });\n        if (firstConnect) {\n          firstConnect = false;\n          reject(err);\n        }\n      };\n\n      log.info('Connecting bridge', { url: this.config.bridgeUrl });\n      this.ws.connect(this.config.bridgeUrl, this.config.apiKey);\n    });\n  }\n\n  /**\n   * Stop the bridge.\n   */\n  stop(): void {\n    this.running = false;\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n    this.ws?.close();\n    this.ws = null;\n    log.info('Bridge stopped');\n  }\n\n  // ── Internal ────────────────────────────────────────────────────────────\n\n  private async handleHttpRequest(msg: Record<string, unknown>): Promise<void> {\n    const requestId = msg.requestId as string;\n    const method = (msg.method as string) ?? 'GET';\n    const path = (msg.path as string) ?? '/';\n    const headers = (msg.headers as Record<string, string>) ?? {};\n    const body = (msg.body as string) ?? '';\n\n    const url = `${this.config.localBaseUrl}${path}`;\n\n    try {\n      const fetchHeaders: Record<string, string> = { ...headers };\n      const fetchOpts: RequestInit = {\n        method,\n        headers: fetchHeaders,\n        signal: AbortSignal.timeout(300_000),\n      };\n\n      if (body && method !== 'GET') {\n        fetchOpts.body = body;\n      }\n\n      const resp = await fetch(url, fetchOpts);\n\n      const responseBody = await resp.text();\n\n      const responseHeaders: Record<string, string> = {};\n      resp.headers.forEach((value, key) => {\n        responseHeaders[key] = value;\n      });\n\n      this.ws?.send(JSON.stringify({\n        type: 'http:response',\n        requestId,\n        status: resp.status,\n        headers: responseHeaders,\n        body: responseBody,\n      }));\n    } catch (err) {\n      log.error('Proxy request failed', { url, error: (err as Error).message });\n      this.ws?.send(JSON.stringify({\n        type: 'http:error',\n        requestId,\n        message: (err as Error).message,\n      }));\n    }\n  }\n}\n"],"mappings":";;;;;AASA,SAAS,eAAe;AACxB,SAAS,mBAAmB;AAG5B,IAAM,MAAM,OAAO,MAAM,QAAQ;AAuBjC,IAAM,WAAN,MAAe;AAAA,EAAf;AACE,SAAQ,SAA4C;AACpD,SAAQ,SAAS,OAAO,MAAM,CAAC;AAC/B,SAAQ,cAAc;AACtB,SAAQ,aAAa;AAAA;AAAA,EAOrB,QAAQ,QAAgB,QAAsB;AAC5C,UAAM,MAAM,IAAI,IAAI,MAAM;AAC1B,UAAM,OAAO,IAAI;AACjB,UAAM,OAAO,SAAS,IAAI,IAAI,MAAM,IAAI,aAAa,SAAS,MAAM;AACpE,UAAM,OAAO,IAAI,WAAW,IAAI;AAEhC,UAAM,MAAM,YAAY,EAAE,EAAE,SAAS,QAAQ;AAE7C,UAAM,MAAM,QAAQ,EAAE,MAAM,KAAK,GAAG,MAAM;AAExC,YAAM,UAAU;AAAA,QACd,OAAO,IAAI;AAAA,QACX,SAAS,IAAI,IAAI,IAAI;AAAA,QACrB;AAAA,QACA;AAAA,QACA,sBAAsB,GAAG;AAAA,QACzB;AAAA,QACA,cAAc,MAAM;AAAA,QACpB;AAAA,QACA;AAAA,MACF,EAAE,KAAK,MAAM;AAEb,UAAI,KAAK,QAAQ;AACf,aAAK,OAAO,MAAM,OAAO;AAAA,MAC3B;AAAA,IACF,CAAC;AAED,SAAK,SAAS;AAEd,QAAI,GAAG,QAAQ,CAAC,UAAkB;AAChC,WAAK,SAAS,OAAO,OAAO,CAAC,KAAK,QAAQ,KAAK,CAAC;AAGhD,UAAI,KAAK,aAAa;AACpB,aAAK,cAAc,MAAM,SAAS;AAClC,cAAM,YAAY,KAAK,WAAW,QAAQ,UAAU;AACpD,YAAI,cAAc,GAAI;AAEtB,cAAM,SAAS,KAAK,WAAW,UAAU,GAAG,SAAS;AACrD,cAAM,aAAa,OAAO,MAAM,MAAM,EAAE,CAAC,KAAK;AAE9C,YAAI,CAAC,WAAW,WAAW,cAAc,GAAG;AAE1C,gBAAM,YAAY,YAAY;AAC9B,gBAAM,WAAW,KAAK,WAAW,UAAU,SAAS,EAAE,KAAK;AAC3D,gBAAM,SAAS,aACX,+BAA+B,UAAU,KACzC;AACJ,eAAK,UAAU,IAAI,MAAM,UAAU,WAAW,KAAK,SAAS,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC;AACnF,eAAK,QAAQ,QAAQ;AACrB,eAAK,SAAS;AACd;AAAA,QACF;AAGA,aAAK,cAAc;AACnB,cAAM,YAAY,KAAK,OAAO,SAAS,YAAY,CAAC;AACpD,aAAK,SAAS;AACd,aAAK,aAAa;AAClB,YAAI,KAAK,OAAQ,MAAK,OAAO;AAE7B,YAAI,UAAU,WAAW,EAAG;AAAA,MAE9B;AAGA,aAAO,KAAK,OAAO,UAAU,GAAG;AAC9B,cAAM,SAAS,KAAK,OAAO,CAAC,IAAI;AAChC,cAAM,UAAU,KAAK,OAAO,CAAC,IAAI,SAAU;AAC3C,YAAI,SAAS;AACb,YAAI,aAAa,KAAK,OAAO,CAAC,IAAI;AAElC,YAAI,eAAe,KAAK;AACtB,cAAI,KAAK,OAAO,SAAS,EAAG;AAC5B,uBAAa,KAAK,OAAO,aAAa,CAAC;AACvC,mBAAS;AAAA,QACX,WAAW,eAAe,KAAK;AAC7B,cAAI,KAAK,OAAO,SAAS,GAAI;AAE7B,gBAAM,KAAK,KAAK,OAAO,aAAa,CAAC;AACrC,gBAAM,KAAK,KAAK,OAAO,aAAa,CAAC;AACrC,uBAAa,KAAK,aAAc;AAChC,mBAAS;AAAA,QACX;AAEA,YAAI,KAAK,OAAO,SAAS,SAAS,WAAY;AAE9C,cAAM,UAAU,KAAK,OAAO,SAAS,QAAQ,SAAS,UAAU;AAChE,aAAK,SAAS,KAAK,OAAO,SAAS,SAAS,UAAU;AAEtD,YAAI,QAAQ;AAEV,gBAAM,OAAO,QAAQ,SAAS,GAAG,CAAC;AAClC,gBAAM,OAAO,QAAQ,SAAS,CAAC;AAC/B,mBAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,iBAAK,CAAC,KAAK,KAAK,IAAI,CAAC;AAAA,UACvB;AACA,cAAI,WAAW,GAAG;AAChB,iBAAK,YAAY,KAAK,SAAS,CAAC;AAAA,UAClC;AAAA,QACF,OAAO;AACL,cAAI,WAAW,GAAG;AAChB,iBAAK,YAAY,QAAQ,SAAS,CAAC;AAAA,UACrC,WAAW,WAAW,GAAG;AACvB,iBAAK,UAAU,GAAI;AACnB;AAAA,UACF,WAAW,WAAW,GAAG;AAEvB,kBAAM,OAAO,OAAO,KAAK,CAAC,KAAM,CAAC,CAAC;AAClC,iBAAK,QAAQ,MAAM,IAAI;AAAA,UACzB;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAED,QAAI,GAAG,SAAS,CAAC,QAAe;AAC9B,WAAK,UAAU,GAAG;AAAA,IACpB,CAAC;AAED,QAAI,GAAG,SAAS,MAAM;AACpB,WAAK,UAAU,IAAI;AAAA,IACrB,CAAC;AAAA,EACH;AAAA,EAEA,KAAK,MAAoB;AACvB,QAAI,CAAC,KAAK,OAAQ;AAClB,UAAM,UAAU,OAAO,KAAK,MAAM,OAAO;AACzC,UAAM,MAAM,QAAQ;AACpB,UAAM,UAAU,YAAY,CAAC;AAG7B,UAAM,SAAS,OAAO,MAAM,GAAG;AAC/B,aAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,aAAO,CAAC,IAAI,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC;AAAA,IACxC;AAEA,QAAI;AACJ,QAAI,MAAM,KAAK;AACb,eAAS,OAAO,MAAM,CAAC;AACvB,aAAO,CAAC,IAAI;AACZ,aAAO,CAAC,IAAI,MAAO;AACnB,cAAQ,KAAK,QAAQ,CAAC;AAAA,IACxB,WAAW,MAAM,OAAO;AACtB,eAAS,OAAO,MAAM,CAAC;AACvB,aAAO,CAAC,IAAI;AACZ,aAAO,CAAC,IAAI,MAAO;AACnB,aAAO,cAAc,KAAK,CAAC;AAC3B,cAAQ,KAAK,QAAQ,CAAC;AAAA,IACxB,OAAO;AACL,eAAS,OAAO,MAAM,EAAE;AACxB,aAAO,CAAC,IAAI;AACZ,aAAO,CAAC,IAAI,MAAO;AACnB,aAAO,cAAc,GAAG,CAAC;AACzB,aAAO,cAAc,KAAK,CAAC;AAC3B,cAAQ,KAAK,QAAQ,EAAE;AAAA,IACzB;AAEA,SAAK,OAAO,MAAM,OAAO,OAAO,CAAC,QAAQ,MAAM,CAAC,CAAC;AAAA,EACnD;AAAA,EAEA,QAAc;AACZ,QAAI,CAAC,KAAK,OAAQ;AAClB,UAAM,QAAQ,OAAO,KAAK,CAAC,KAAM,CAAI,CAAC;AACtC,SAAK,OAAO,MAAM,KAAK;AACvB,SAAK,OAAO,QAAQ;AACpB,SAAK,SAAS;AAAA,EAChB;AACF;AAIO,IAAM,eAAN,MAAmB;AAAA,EAKxB,YAAoB,QAAsB;AAAtB;AAJpB,SAAQ,KAAsB;AAC9B,SAAQ,UAAU;AAClB,SAAQ,iBAAuD;AAAA,EAEpB;AAAA;AAAA;AAAA;AAAA;AAAA,EAM3C,MAAM,QAAuB;AAC3B,SAAK,UAAU;AAEf,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,WAAK,KAAK,IAAI,SAAS;AAEvB,UAAI,eAAe;AAEnB,WAAK,GAAG,SAAS,MAAM;AACrB,YAAI,KAAK,kBAAkB;AAE3B,aAAK,GAAI,KAAK,KAAK,UAAU;AAAA,UAC3B,MAAM;AAAA,UACN,SAAS,KAAK,OAAO;AAAA,UACrB,WAAW,KAAK,OAAO;AAAA,QACzB,CAAC,CAAC;AAAA,MACJ;AAEA,WAAK,GAAG,YAAY,OAAO,QAAgB;AACzC,YAAI;AACJ,YAAI;AACF,gBAAM,KAAK,MAAM,GAAG;AAAA,QACtB,QAAQ;AACN;AAAA,QACF;AAEA,YAAI,IAAI,SAAS,oBAAoB;AACnC,cAAI,KAAK,+BAA+B,EAAE,SAAS,KAAK,OAAO,QAAQ,CAAC;AACxE,cAAI,cAAc;AAChB,2BAAe;AACf,oBAAQ;AAAA,UACV;AACA;AAAA,QACF;AAEA,YAAI,IAAI,SAAS,gBAAgB;AAC/B,eAAK,kBAAkB,GAAG;AAAA,QAC5B;AAAA,MACF;AAEA,WAAK,GAAG,UAAU,MAAM;AACtB,YAAI,KAAK,sCAAsC;AAC/C,YAAI,KAAK,SAAS;AAChB,eAAK,iBAAiB;AAAA,YACpB,MAAM,KAAK,MAAM,EAAE,MAAM,MAAM;AAAA,YAAC,CAAC;AAAA,YACjC,KAAK,OAAO,kBAAkB;AAAA,UAChC;AAAA,QACF;AAAA,MACF;AAEA,WAAK,GAAG,UAAU,CAAC,QAAe;AAChC,YAAI,MAAM,gBAAgB,EAAE,OAAO,IAAI,QAAQ,CAAC;AAChD,YAAI,cAAc;AAChB,yBAAe;AACf,iBAAO,GAAG;AAAA,QACZ;AAAA,MACF;AAEA,UAAI,KAAK,qBAAqB,EAAE,KAAK,KAAK,OAAO,UAAU,CAAC;AAC5D,WAAK,GAAG,QAAQ,KAAK,OAAO,WAAW,KAAK,OAAO,MAAM;AAAA,IAC3D,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,OAAa;AACX,SAAK,UAAU;AACf,QAAI,KAAK,gBAAgB;AACvB,mBAAa,KAAK,cAAc;AAChC,WAAK,iBAAiB;AAAA,IACxB;AACA,SAAK,IAAI,MAAM;AACf,SAAK,KAAK;AACV,QAAI,KAAK,gBAAgB;AAAA,EAC3B;AAAA;AAAA,EAIA,MAAc,kBAAkB,KAA6C;AAC3E,UAAM,YAAY,IAAI;AACtB,UAAM,SAAU,IAAI,UAAqB;AACzC,UAAM,OAAQ,IAAI,QAAmB;AACrC,UAAM,UAAW,IAAI,WAAsC,CAAC;AAC5D,UAAM,OAAQ,IAAI,QAAmB;AAErC,UAAM,MAAM,GAAG,KAAK,OAAO,YAAY,GAAG,IAAI;AAE9C,QAAI;AACF,YAAM,eAAuC,EAAE,GAAG,QAAQ;AAC1D,YAAM,YAAyB;AAAA,QAC7B;AAAA,QACA,SAAS;AAAA,QACT,QAAQ,YAAY,QAAQ,GAAO;AAAA,MACrC;AAEA,UAAI,QAAQ,WAAW,OAAO;AAC5B,kBAAU,OAAO;AAAA,MACnB;AAEA,YAAM,OAAO,MAAM,MAAM,KAAK,SAAS;AAEvC,YAAM,eAAe,MAAM,KAAK,KAAK;AAErC,YAAM,kBAA0C,CAAC;AACjD,WAAK,QAAQ,QAAQ,CAAC,OAAO,QAAQ;AACnC,wBAAgB,GAAG,IAAI;AAAA,MACzB,CAAC;AAED,WAAK,IAAI,KAAK,KAAK,UAAU;AAAA,QAC3B,MAAM;AAAA,QACN;AAAA,QACA,QAAQ,KAAK;AAAA,QACb,SAAS;AAAA,QACT,MAAM;AAAA,MACR,CAAC,CAAC;AAAA,IACJ,SAAS,KAAK;AACZ,UAAI,MAAM,wBAAwB,EAAE,KAAK,OAAQ,IAAc,QAAQ,CAAC;AACxE,WAAK,IAAI,KAAK,KAAK,UAAU;AAAA,QAC3B,MAAM;AAAA,QACN;AAAA,QACA,SAAU,IAAc;AAAA,MAC1B,CAAC,CAAC;AAAA,IACJ;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-35NFMGMS.mjs

@@ -0,0 +1,27 @@
+// src/executors/index.ts
+import { TaskState } from "@a2a-js/sdk";
+import { v4 } from "uuid";
+var registry = /* @__PURE__ */ new Map();
+function registerExecutor(provider, factory) {
+  registry.set(provider, factory);
+}
+function getExecutor(provider) {
+  return registry.get(provider);
+}
+function createExecutor(config) {
+  const factory = registry.get(config.provider);
+  if (!factory) {
+    const available = Array.from(registry.keys()).join(", ");
+    throw new Error(`Unknown provider: ${config.provider}. Available: ${available}`);
+  }
+  return factory(config);
+}
+
+export {
+  registerExecutor,
+  getExecutor,
+  createExecutor,
+  TaskState,
+  v4
+};
+//# sourceMappingURL=chunk-35NFMGMS.mjs.map

package/dist/chunk-35NFMGMS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/executors/index.ts"],"sourcesContent":["/**\n * Executor types and common interfaces for CLI A2A providers.\n *\n * Each provider (OpenCode, Codex, Claude) implements its own executor\n * conforming to the A2AExecutor interface which extends the SDK's\n * AgentExecutor with lifecycle methods (initialize, shutdown).\n */\n\nimport type { AgentExecutor } from '@a2a-js/sdk/server';\n\n/**\n * Extended executor interface with lifecycle methods.\n *\n * The base AgentExecutor from @a2a-js/sdk only defines execute() and\n * cancelTask(). We add initialize() for server setup and shutdown()\n * for graceful cleanup.\n */\nexport interface A2AExecutor extends AgentExecutor {\n  initialize(): Promise<void>;\n  shutdown(): Promise<void>;\n}\n\nexport type { AgentExecutor, RequestContext, ExecutionEventBus } from '@a2a-js/sdk/server';\nexport { TaskState } from '@a2a-js/sdk';\nexport { v4 as uuidv4 } from 'uuid';\n\nimport type { AgentConfig, ProviderType } from '../config/types.js';\n\n/**\n * Factory function type: given resolved config, produce an executor.\n */\nexport type ExecutorFactory = (config: Required<AgentConfig>) => A2AExecutor;\n\n/**\n * Map provider type to executor factory.\n */\nconst registry = new Map<ProviderType, ExecutorFactory>();\n\nexport function registerExecutor(provider: ProviderType, factory: ExecutorFactory): void {\n  registry.set(provider, factory);\n}\n\nexport function getExecutor(provider: ProviderType): ExecutorFactory | undefined {\n  return registry.get(provider);\n}\n\nexport function createExecutor(config: Required<AgentConfig>): A2AExecutor {\n  const factory = registry.get(config.provider);\n  if (!factory) {\n    const available = Array.from(registry.keys()).join(', ');\n    throw new Error(`Unknown provider: ${config.provider}. Available: ${available}`);\n  }\n  return factory(config);\n}\n"],"mappings":";AAuBA,SAAS,iBAAiB;AAC1B,SAAe,UAAc;AAY7B,IAAM,WAAW,oBAAI,IAAmC;AAEjD,SAAS,iBAAiB,UAAwB,SAAgC;AACvF,WAAS,IAAI,UAAU,OAAO;AAChC;AAEO,SAAS,YAAY,UAAqD;AAC/E,SAAO,SAAS,IAAI,QAAQ;AAC9B;AAEO,SAAS,eAAe,QAA4C;AACzE,QAAM,UAAU,SAAS,IAAI,OAAO,QAAQ;AAC5C,MAAI,CAAC,SAAS;AACZ,UAAM,YAAY,MAAM,KAAK,SAAS,KAAK,CAAC,EAAE,KAAK,IAAI;AACvD,UAAM,IAAI,MAAM,qBAAqB,OAAO,QAAQ,gBAAgB,SAAS,EAAE;AAAA,EACjF;AACA,SAAO,QAAQ,MAAM;AACvB;","names":[]}