@anycast/agent 0.1.0

package/README.md

@@ -0,0 +1,143 @@
+# @anycast/agent
+
+TypeScript SDK for [Anycast Agents](https://agents.anycast.com) P2P connectivity.
+
+Connect agents to the Anycast network for peer-to-peer communication with relay fallback, powered by the global Anycast edge infrastructure.
+
+## Installation
+
+```bash
+npm install @anycast/agent
+# or
+pnpm add @anycast/agent
+```
+
+## Quick Start
+
+```typescript
+import { AnycastAgent } from '@anycast/agent';
+
+const agent = new AnycastAgent({
+  rendezvousUrl: 'wss://agents.anycast.com/rendezvous',
+  token: 'agt_your_token_here',
+});
+
+agent.on('connect', ({ agentId }) => {
+  console.log(`Connected as ${agentId}`);
+});
+
+agent.on('peer', (peerId, status) => {
+  console.log(`Peer ${peerId} is ${status}`);
+});
+
+agent.on('error', (err) => {
+  console.error(`Error: ${err.message} (${err.code})`);
+});
+
+await agent.connect();
+
+// Request a connection to another agent
+const sessionId = agent.requestConnection('target-agent-id');
+
+// Handle incoming WebRTC signals
+agent.on('signal', (sessionId, fromAgentId, signal) => {
+  // Forward to your WebRTC implementation
+});
+
+// Send WebRTC signals
+agent.sendSignal(sessionId, 'target-agent-id', {
+  type: 'offer',
+  data: JSON.stringify(sdpOffer),
+});
+
+// Disconnect when done
+await agent.disconnect();
+```
+
+## API Reference
+
+### `new AnycastAgent(options)`
+
+Create a new agent instance.
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `rendezvousUrl` | `string` | required | WebSocket URL of the rendezvous server |
+| `token` | `string` | required | Agent auth token from the Anycast portal |
+| `machineId` | `string` | auto-generated | Unique machine identifier |
+| `publicKey` | `string` | auto-generated | Public key for E2E encryption |
+| `version` | `string` | — | Agent version string |
+| `reconnect` | `boolean` | `true` | Auto-reconnect on disconnect |
+| `reconnectInterval` | `number` | `3000` | Base reconnect interval (ms) |
+| `timeout` | `number` | `30000` | Connection timeout (ms) |
+| `heartbeatInterval` | `number` | `25000` | Heartbeat interval (ms) |
+
+### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `agentId` | `string \| null` | Assigned agent ID (set after connect) |
+| `tenantId` | `string \| null` | Tenant ID (set after connect) |
+| `connected` | `boolean` | Whether the agent is connected |
+| `connectionState` | `ConnectionState` | Current connection state |
+
+### Methods
+
+#### `connect(): Promise<void>`
+Connect to the rendezvous server. Resolves when registered.
+
+#### `disconnect(): Promise<void>`
+Disconnect from the server.
+
+#### `requestConnection(targetAgentId: string): string`
+Request a P2P connection to another agent. Returns a session ID.
+
+#### `sendSignal(sessionId, targetAgentId, signal)`
+Send a WebRTC signal (offer/answer/ICE candidate) via the rendezvous server.
+
+#### `disconnectSession(sessionId: string)`
+Close a specific session.
+
+### Events
+
+| Event | Payload | Description |
+|-------|---------|-------------|
+| `connect` | `{ agentId, tenantId, name }` | Connected and registered |
+| `disconnect` | `reason: string` | Disconnected |
+| `reconnecting` | `attempt: number` | Attempting reconnection |
+| `peer` | `agentId, status` | Peer came online/offline |
+| `connect_incoming` | `sessionId, fromAgentId, fromAgentName` | Incoming connection request |
+| `connect_accepted` | `sessionId, agentId, publicKey` | Connection accepted by peer |
+| `connect_rejected` | `sessionId, reason` | Connection rejected |
+| `signal` | `sessionId, fromAgentId, signal` | WebRTC signal from peer |
+| `relay_assigned` | `sessionId, host, port, token` | Relay server assigned |
+| `error` | `AnycastError` | Error occurred |
+| `stateChange` | `ConnectionState` | Connection state changed |
+
+### ConnectionState
+
+```typescript
+enum ConnectionState {
+  DISCONNECTED = 'DISCONNECTED',
+  CONNECTING = 'CONNECTING',
+  CONNECTED = 'CONNECTED',
+  RECONNECTING = 'RECONNECTING',
+}
+```
+
+### AnycastError
+
+```typescript
+class AnycastError extends Error {
+  code: string;    // Error code (e.g., 'AUTH_FAILED', 'TIMEOUT')
+  fatal: boolean;  // If true, reconnection won't help
+}
+```
+
+## Auto-Reconnection
+
+By default, the agent automatically reconnects with exponential backoff (3s, 6s, 12s, ..., max 30s). Disable with `reconnect: false`.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,135 @@
+import EventEmitter from 'eventemitter3';
+
+/**
+ * Agent SDK types — mirrors the rendezvous server protocol.
+ */
+interface AnycastAgentOptions {
+    /** WebSocket URL of the rendezvous server (e.g., wss://agents.anycast.com/rendezvous) */
+    rendezvousUrl: string;
+    /** Agent auth token from the Anycast portal */
+    token: string;
+    /** Unique machine identifier (auto-generated if not provided) */
+    machineId?: string;
+    /** Public key for end-to-end encryption */
+    publicKey?: string;
+    /** Agent version string */
+    version?: string;
+    /** Auto-reconnect on disconnect (default: true) */
+    reconnect?: boolean;
+    /** Reconnect interval in ms (default: 3000) */
+    reconnectInterval?: number;
+    /** Connection timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Heartbeat interval in ms (default: 25000) */
+    heartbeatInterval?: number;
+}
+declare enum ConnectionState {
+    DISCONNECTED = "DISCONNECTED",
+    CONNECTING = "CONNECTING",
+    CONNECTED = "CONNECTED",
+    RECONNECTING = "RECONNECTING"
+}
+interface AnycastAgentEvents {
+    connect: (info: {
+        agentId: string;
+        tenantId: string;
+        name: string;
+    }) => void;
+    disconnect: (reason: string) => void;
+    reconnecting: (attempt: number) => void;
+    message: (fromAgentId: string, data: string) => void;
+    peer: (agentId: string, status: 'online' | 'offline') => void;
+    'connect_incoming': (sessionId: string, fromAgentId: string, fromAgentName: string) => void;
+    'connect_accepted': (sessionId: string, agentId: string, publicKey: string) => void;
+    'connect_rejected': (sessionId: string, reason: string) => void;
+    signal: (sessionId: string, fromAgentId: string, signal: {
+        type: string;
+        data: string;
+    }) => void;
+    'relay_assigned': (sessionId: string, relayHost: string, relayPort: number, relayToken: string) => void;
+    error: (error: AnycastError) => void;
+    stateChange: (state: ConnectionState) => void;
+}
+declare class AnycastError extends Error {
+    code: string;
+    fatal: boolean;
+    constructor(message: string, code: string, fatal?: boolean);
+}
+
+/**
+ * AnycastAgent — connects to the Anycast Agents rendezvous server
+ * for P2P connectivity, signaling, and relay fallback.
+ *
+ * @example
+ * ```typescript
+ * const agent = new AnycastAgent({
+ *   rendezvousUrl: 'wss://agents.anycast.com/rendezvous',
+ *   token: 'agt_...',
+ * });
+ *
+ * agent.on('connect', ({ agentId }) => {
+ *   console.log(`Connected as ${agentId}`);
+ * });
+ *
+ * agent.on('peer', (peerId, status) => {
+ *   console.log(`Peer ${peerId} is ${status}`);
+ * });
+ *
+ * await agent.connect();
+ * ```
+ */
+declare class AnycastAgent extends EventEmitter<AnycastAgentEvents> {
+    private ws;
+    private state;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private intentionalClose;
+    /** Agent ID assigned by the server after registration */
+    agentId: string | null;
+    /** Tenant ID from the server */
+    tenantId: string | null;
+    /** Agent name from the server */
+    agentName: string | null;
+    private readonly opts;
+    constructor(options: AnycastAgentOptions);
+    /** Current connection state */
+    get connectionState(): ConnectionState;
+    /** Whether the agent is connected */
+    get connected(): boolean;
+    /**
+     * Connect to the rendezvous server.
+     * Resolves when registered, rejects on timeout or fatal error.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the rendezvous server.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Request a connection to a peer agent.
+     * @returns The session ID for this connection
+     */
+    requestConnection(targetAgentId: string): string;
+    /**
+     * Send a WebRTC signal to a peer via the rendezvous server.
+     */
+    sendSignal(sessionId: string, targetAgentId: string, signal: {
+        type: 'offer' | 'answer' | 'ice';
+        data: string;
+    }): void;
+    /**
+     * Disconnect a session.
+     */
+    disconnectSession(sessionId: string): void;
+    private handleMessage;
+    private send;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private scheduleReconnect;
+    private cleanup;
+    private setState;
+    private assertConnected;
+}
+
+export { AnycastAgent, type AnycastAgentEvents, type AnycastAgentOptions, AnycastError, ConnectionState };

package/dist/index.d.ts

@@ -0,0 +1,135 @@
+import EventEmitter from 'eventemitter3';
+
+/**
+ * Agent SDK types — mirrors the rendezvous server protocol.
+ */
+interface AnycastAgentOptions {
+    /** WebSocket URL of the rendezvous server (e.g., wss://agents.anycast.com/rendezvous) */
+    rendezvousUrl: string;
+    /** Agent auth token from the Anycast portal */
+    token: string;
+    /** Unique machine identifier (auto-generated if not provided) */
+    machineId?: string;
+    /** Public key for end-to-end encryption */
+    publicKey?: string;
+    /** Agent version string */
+    version?: string;
+    /** Auto-reconnect on disconnect (default: true) */
+    reconnect?: boolean;
+    /** Reconnect interval in ms (default: 3000) */
+    reconnectInterval?: number;
+    /** Connection timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Heartbeat interval in ms (default: 25000) */
+    heartbeatInterval?: number;
+}
+declare enum ConnectionState {
+    DISCONNECTED = "DISCONNECTED",
+    CONNECTING = "CONNECTING",
+    CONNECTED = "CONNECTED",
+    RECONNECTING = "RECONNECTING"
+}
+interface AnycastAgentEvents {
+    connect: (info: {
+        agentId: string;
+        tenantId: string;
+        name: string;
+    }) => void;
+    disconnect: (reason: string) => void;
+    reconnecting: (attempt: number) => void;
+    message: (fromAgentId: string, data: string) => void;
+    peer: (agentId: string, status: 'online' | 'offline') => void;
+    'connect_incoming': (sessionId: string, fromAgentId: string, fromAgentName: string) => void;
+    'connect_accepted': (sessionId: string, agentId: string, publicKey: string) => void;
+    'connect_rejected': (sessionId: string, reason: string) => void;
+    signal: (sessionId: string, fromAgentId: string, signal: {
+        type: string;
+        data: string;
+    }) => void;
+    'relay_assigned': (sessionId: string, relayHost: string, relayPort: number, relayToken: string) => void;
+    error: (error: AnycastError) => void;
+    stateChange: (state: ConnectionState) => void;
+}
+declare class AnycastError extends Error {
+    code: string;
+    fatal: boolean;
+    constructor(message: string, code: string, fatal?: boolean);
+}
+
+/**
+ * AnycastAgent — connects to the Anycast Agents rendezvous server
+ * for P2P connectivity, signaling, and relay fallback.
+ *
+ * @example
+ * ```typescript
+ * const agent = new AnycastAgent({
+ *   rendezvousUrl: 'wss://agents.anycast.com/rendezvous',
+ *   token: 'agt_...',
+ * });
+ *
+ * agent.on('connect', ({ agentId }) => {
+ *   console.log(`Connected as ${agentId}`);
+ * });
+ *
+ * agent.on('peer', (peerId, status) => {
+ *   console.log(`Peer ${peerId} is ${status}`);
+ * });
+ *
+ * await agent.connect();
+ * ```
+ */
+declare class AnycastAgent extends EventEmitter<AnycastAgentEvents> {
+    private ws;
+    private state;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private intentionalClose;
+    /** Agent ID assigned by the server after registration */
+    agentId: string | null;
+    /** Tenant ID from the server */
+    tenantId: string | null;
+    /** Agent name from the server */
+    agentName: string | null;
+    private readonly opts;
+    constructor(options: AnycastAgentOptions);
+    /** Current connection state */
+    get connectionState(): ConnectionState;
+    /** Whether the agent is connected */
+    get connected(): boolean;
+    /**
+     * Connect to the rendezvous server.
+     * Resolves when registered, rejects on timeout or fatal error.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the rendezvous server.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Request a connection to a peer agent.
+     * @returns The session ID for this connection
+     */
+    requestConnection(targetAgentId: string): string;
+    /**
+     * Send a WebRTC signal to a peer via the rendezvous server.
+     */
+    sendSignal(sessionId: string, targetAgentId: string, signal: {
+        type: 'offer' | 'answer' | 'ice';
+        data: string;
+    }): void;
+    /**
+     * Disconnect a session.
+     */
+    disconnectSession(sessionId: string): void;
+    private handleMessage;
+    private send;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private scheduleReconnect;
+    private cleanup;
+    private setState;
+    private assertConnected;
+}
+
+export { AnycastAgent, type AnycastAgentEvents, type AnycastAgentOptions, AnycastError, ConnectionState };

package/dist/index.js

@@ -0,0 +1,303 @@
+'use strict';
+
+var WebSocket = require('ws');
+var EventEmitter = require('eventemitter3');
+var crypto = require('crypto');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var WebSocket__default = /*#__PURE__*/_interopDefault(WebSocket);
+var EventEmitter__default = /*#__PURE__*/_interopDefault(EventEmitter);
+
+// src/agent.ts
+
+// src/types.ts
+var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
+  ConnectionState2["DISCONNECTED"] = "DISCONNECTED";
+  ConnectionState2["CONNECTING"] = "CONNECTING";
+  ConnectionState2["CONNECTED"] = "CONNECTED";
+  ConnectionState2["RECONNECTING"] = "RECONNECTING";
+  return ConnectionState2;
+})(ConnectionState || {});
+var AnycastError = class extends Error {
+  constructor(message, code, fatal = false) {
+    super(message);
+    this.code = code;
+    this.fatal = fatal;
+    this.name = "AnycastError";
+  }
+};
+
+// src/agent.ts
+var DEFAULT_OPTIONS = {
+  reconnect: true,
+  reconnectInterval: 3e3,
+  timeout: 3e4,
+  heartbeatInterval: 25e3
+};
+var AnycastAgent = class extends EventEmitter__default.default {
+  constructor(options) {
+    super();
+    this.ws = null;
+    this.state = "DISCONNECTED" /* DISCONNECTED */;
+    this.heartbeatTimer = null;
+    this.reconnectTimer = null;
+    this.reconnectAttempt = 0;
+    this.intentionalClose = false;
+    /** Agent ID assigned by the server after registration */
+    this.agentId = null;
+    /** Tenant ID from the server */
+    this.tenantId = null;
+    /** Agent name from the server */
+    this.agentName = null;
+    this.opts = {
+      rendezvousUrl: options.rendezvousUrl,
+      token: options.token,
+      machineId: options.machineId || crypto.randomBytes(16).toString("hex"),
+      publicKey: options.publicKey || crypto.randomBytes(32).toString("base64"),
+      version: options.version,
+      reconnect: options.reconnect ?? DEFAULT_OPTIONS.reconnect,
+      reconnectInterval: options.reconnectInterval ?? DEFAULT_OPTIONS.reconnectInterval,
+      timeout: options.timeout ?? DEFAULT_OPTIONS.timeout,
+      heartbeatInterval: options.heartbeatInterval ?? DEFAULT_OPTIONS.heartbeatInterval
+    };
+  }
+  /** Current connection state */
+  get connectionState() {
+    return this.state;
+  }
+  /** Whether the agent is connected */
+  get connected() {
+    return this.state === "CONNECTED" /* CONNECTED */;
+  }
+  /**
+   * Connect to the rendezvous server.
+   * Resolves when registered, rejects on timeout or fatal error.
+   */
+  async connect() {
+    if (this.state === "CONNECTED" /* CONNECTED */ || this.state === "CONNECTING" /* CONNECTING */) {
+      return;
+    }
+    this.intentionalClose = false;
+    this.setState("CONNECTING" /* CONNECTING */);
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        this.cleanup();
+        const err = new AnycastError("Connection timeout", "TIMEOUT", false);
+        this.emit("error", err);
+        reject(err);
+      }, this.opts.timeout);
+      try {
+        this.ws = new WebSocket__default.default(this.opts.rendezvousUrl);
+      } catch (err) {
+        clearTimeout(timeout);
+        const error = new AnycastError(
+          `Failed to create WebSocket: ${err instanceof Error ? err.message : String(err)}`,
+          "CONNECTION_FAILED",
+          false
+        );
+        this.setState("DISCONNECTED" /* DISCONNECTED */);
+        reject(error);
+        return;
+      }
+      this.ws.on("open", () => {
+        this.send({
+          type: "register",
+          token: this.opts.token,
+          machineId: this.opts.machineId,
+          publicKey: this.opts.publicKey,
+          version: this.opts.version
+        });
+      });
+      this.ws.on("message", (data) => {
+        let msg;
+        try {
+          msg = JSON.parse(data.toString());
+        } catch {
+          return;
+        }
+        if (msg.type === "registered") {
+          clearTimeout(timeout);
+          this.agentId = msg.agentId;
+          this.tenantId = msg.tenantId;
+          this.agentName = msg.name;
+          this.reconnectAttempt = 0;
+          this.setState("CONNECTED" /* CONNECTED */);
+          this.startHeartbeat();
+          this.emit("connect", { agentId: msg.agentId, tenantId: msg.tenantId, name: msg.name });
+          resolve();
+          return;
+        }
+        if (msg.type === "error" && msg.fatal) {
+          clearTimeout(timeout);
+          const err = new AnycastError(msg.message, msg.code, true);
+          this.emit("error", err);
+          this.cleanup();
+          reject(err);
+          return;
+        }
+        this.handleMessage(msg);
+      });
+      this.ws.on("close", (code, reason) => {
+        clearTimeout(timeout);
+        this.stopHeartbeat();
+        const wasConnected = this.state === "CONNECTED" /* CONNECTED */;
+        this.setState("DISCONNECTED" /* DISCONNECTED */);
+        if (wasConnected) {
+          this.emit("disconnect", reason?.toString() || `Code ${code}`);
+        }
+        if (!this.intentionalClose && this.opts.reconnect) {
+          this.scheduleReconnect();
+        } else if (this.state !== "CONNECTED" /* CONNECTED */) {
+          reject(new AnycastError("Connection closed", "CLOSED", false));
+        }
+      });
+      this.ws.on("error", (err) => {
+        const error = new AnycastError(err.message, "WS_ERROR", false);
+        this.emit("error", error);
+      });
+    });
+  }
+  /**
+   * Disconnect from the rendezvous server.
+   */
+  async disconnect() {
+    this.intentionalClose = true;
+    this.cleanup();
+    this.agentId = null;
+    this.tenantId = null;
+    this.agentName = null;
+  }
+  /**
+   * Request a connection to a peer agent.
+   * @returns The session ID for this connection
+   */
+  requestConnection(targetAgentId) {
+    this.assertConnected();
+    const sessionId = crypto.randomBytes(16).toString("hex");
+    this.send({
+      type: "connect_request",
+      targetAgentId,
+      sessionId
+    });
+    return sessionId;
+  }
+  /**
+   * Send a WebRTC signal to a peer via the rendezvous server.
+   */
+  sendSignal(sessionId, targetAgentId, signal) {
+    this.assertConnected();
+    this.send({
+      type: "signal",
+      sessionId,
+      targetAgentId,
+      signal
+    });
+  }
+  /**
+   * Disconnect a session.
+   */
+  disconnectSession(sessionId) {
+    this.assertConnected();
+    this.send({ type: "disconnect", sessionId });
+  }
+  // ---------------------------------------------------------------------------
+  // Private
+  // ---------------------------------------------------------------------------
+  handleMessage(msg) {
+    switch (msg.type) {
+      case "heartbeat_ack":
+        break;
+      case "agent_status":
+        this.emit("peer", msg.agentId, msg.status);
+        break;
+      case "connect_incoming":
+        this.emit("connect_incoming", msg.sessionId, msg.fromAgentId, msg.fromAgentName);
+        break;
+      case "connect_accepted":
+        this.emit("connect_accepted", msg.sessionId, msg.agentId, msg.publicKey);
+        break;
+      case "connect_rejected":
+        this.emit("connect_rejected", msg.sessionId, msg.reason);
+        break;
+      case "signal_forward":
+        this.emit("signal", msg.sessionId, msg.fromAgentId, msg.signal);
+        break;
+      case "relay_assigned":
+        this.emit("relay_assigned", msg.sessionId, msg.relayHost, msg.relayPort, msg.relayToken);
+        break;
+      case "error":
+        this.emit("error", new AnycastError(msg.message, msg.code, msg.fatal || false));
+        if (msg.fatal) {
+          this.cleanup();
+        }
+        break;
+    }
+  }
+  send(msg) {
+    if (this.ws?.readyState === WebSocket__default.default.OPEN) {
+      this.ws.send(JSON.stringify(msg));
+    }
+  }
+  startHeartbeat() {
+    this.stopHeartbeat();
+    this.heartbeatTimer = setInterval(() => {
+      this.send({ type: "heartbeat" });
+    }, this.opts.heartbeatInterval);
+  }
+  stopHeartbeat() {
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
+  }
+  scheduleReconnect() {
+    if (this.reconnectTimer) return;
+    this.reconnectAttempt++;
+    const delay = Math.min(
+      this.opts.reconnectInterval * Math.pow(2, this.reconnectAttempt - 1),
+      3e4
+    );
+    this.setState("RECONNECTING" /* RECONNECTING */);
+    this.emit("reconnecting", this.reconnectAttempt);
+    this.reconnectTimer = setTimeout(async () => {
+      this.reconnectTimer = null;
+      try {
+        await this.connect();
+      } catch {
+      }
+    }, delay);
+  }
+  cleanup() {
+    this.stopHeartbeat();
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+    if (this.ws) {
+      this.ws.removeAllListeners();
+      if (this.ws.readyState === WebSocket__default.default.OPEN || this.ws.readyState === WebSocket__default.default.CONNECTING) {
+        this.ws.close(1e3, "Client disconnect");
+      }
+      this.ws = null;
+    }
+    this.setState("DISCONNECTED" /* DISCONNECTED */);
+  }
+  setState(state) {
+    if (this.state !== state) {
+      this.state = state;
+      this.emit("stateChange", state);
+    }
+  }
+  assertConnected() {
+    if (this.state !== "CONNECTED" /* CONNECTED */ || !this.ws) {
+      throw new AnycastError("Not connected", "NOT_CONNECTED", false);
+    }
+  }
+};
+
+exports.AnycastAgent = AnycastAgent;
+exports.AnycastError = AnycastError;
+exports.ConnectionState = ConnectionState;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/agent.ts"],"names":["ConnectionState","EventEmitter","randomBytes","WebSocket"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Agent SDK types — mirrors the rendezvous server protocol.\n */\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface AnycastAgentOptions {\n  /** WebSocket URL of the rendezvous server (e.g., wss://agents.anycast.com/rendezvous) */\n  rendezvousUrl: string;\n  /** Agent auth token from the Anycast portal */\n  token: string;\n  /** Unique machine identifier (auto-generated if not provided) */\n  machineId?: string;\n  /** Public key for end-to-end encryption */\n  publicKey?: string;\n  /** Agent version string */\n  version?: string;\n  /** Auto-reconnect on disconnect (default: true) */\n  reconnect?: boolean;\n  /** Reconnect interval in ms (default: 3000) */\n  reconnectInterval?: number;\n  /** Connection timeout in ms (default: 30000) */\n  timeout?: number;\n  /** Heartbeat interval in ms (default: 25000) */\n  heartbeatInterval?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Connection state\n// ---------------------------------------------------------------------------\n\nexport enum ConnectionState {\n  DISCONNECTED = 'DISCONNECTED',\n  CONNECTING = 'CONNECTING',\n  CONNECTED = 'CONNECTED',\n  RECONNECTING = 'RECONNECTING',\n}\n\n// ---------------------------------------------------------------------------\n// Client → Server messages\n// ---------------------------------------------------------------------------\n\nexport interface RegisterMessage {\n  type: 'register';\n  token: string;\n  machineId: string;\n  publicKey: string;\n  version?: string;\n  os?: string;\n  arch?: string;\n}\n\nexport interface HeartbeatMessage {\n  type: 'heartbeat';\n}\n\nexport interface ConnectRequestMessage {\n  type: 'connect_request';\n  targetAgentId: string;\n  sessionId: string;\n}\n\nexport interface SignalMessage {\n  type: 'signal';\n  sessionId: string;\n  targetAgentId: string;\n  signal: {\n    type: 'offer' | 'answer' | 'ice';\n    data: string;\n  };\n}\n\nexport interface DisconnectMessage {\n  type: 'disconnect';\n  sessionId: string;\n}\n\nexport type ClientMessage =\n  | RegisterMessage\n  | HeartbeatMessage\n  | ConnectRequestMessage\n  | SignalMessage\n  | DisconnectMessage;\n\n// ---------------------------------------------------------------------------\n// Server → Client messages\n// ---------------------------------------------------------------------------\n\nexport interface RegisteredMessage {\n  type: 'registered';\n  agentId: string;\n  tenantId: string;\n  name: string;\n}\n\nexport interface HeartbeatAckMessage {\n  type: 'heartbeat_ack';\n  timestamp: number;\n}\n\nexport interface ConnectIncomingMessage {\n  type: 'connect_incoming';\n  sessionId: string;\n  fromAgentId: string;\n  fromAgentName: string;\n}\n\nexport interface ConnectAcceptedMessage {\n  type: 'connect_accepted';\n  sessionId: string;\n  agentId: string;\n  agentName: string;\n  publicKey: string;\n}\n\nexport interface ConnectRejectedMessage {\n  type: 'connect_rejected';\n  sessionId: string;\n  reason: string;\n}\n\nexport interface SignalForwardMessage {\n  type: 'signal_forward';\n  sessionId: string;\n  fromAgentId: string;\n  signal: {\n    type: 'offer' | 'answer' | 'ice';\n    data: string;\n  };\n}\n\nexport interface RelayAssignedMessage {\n  type: 'relay_assigned';\n  sessionId: string;\n  relayHost: string;\n  relayPort: number;\n  relayToken: string;\n}\n\nexport interface AgentStatusMessage {\n  type: 'agent_status';\n  agentId: string;\n  status: 'online' | 'offline';\n}\n\nexport interface ErrorMessage {\n  type: 'error';\n  code: string;\n  message: string;\n  fatal?: boolean;\n}\n\nexport type ServerMessage =\n  | RegisteredMessage\n  | HeartbeatAckMessage\n  | ConnectIncomingMessage\n  | ConnectAcceptedMessage\n  | ConnectRejectedMessage\n  | SignalForwardMessage\n  | RelayAssignedMessage\n  | AgentStatusMessage\n  | ErrorMessage;\n\n// ---------------------------------------------------------------------------\n// Event map for typed event emitter\n// ---------------------------------------------------------------------------\n\nexport interface AnycastAgentEvents {\n  connect: (info: { agentId: string; tenantId: string; name: string }) => void;\n  disconnect: (reason: string) => void;\n  reconnecting: (attempt: number) => void;\n  message: (fromAgentId: string, data: string) => void;\n  peer: (agentId: string, status: 'online' | 'offline') => void;\n  'connect_incoming': (sessionId: string, fromAgentId: string, fromAgentName: string) => void;\n  'connect_accepted': (sessionId: string, agentId: string, publicKey: string) => void;\n  'connect_rejected': (sessionId: string, reason: string) => void;\n  signal: (sessionId: string, fromAgentId: string, signal: { type: string; data: string }) => void;\n  'relay_assigned': (sessionId: string, relayHost: string, relayPort: number, relayToken: string) => void;\n  error: (error: AnycastError) => void;\n  stateChange: (state: ConnectionState) => void;\n}\n\n// ---------------------------------------------------------------------------\n// Error\n// ---------------------------------------------------------------------------\n\nexport class AnycastError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public fatal: boolean = false\n  ) {\n    super(message);\n    this.name = 'AnycastError';\n  }\n}\n","import WebSocket from 'ws';\nimport EventEmitter from 'eventemitter3';\nimport { randomBytes } from 'crypto';\nimport {\n  type AnycastAgentOptions,\n  type AnycastAgentEvents,\n  type ServerMessage,\n  type ClientMessage,\n  ConnectionState,\n  AnycastError,\n} from './types.js';\n\nconst DEFAULT_OPTIONS = {\n  reconnect: true,\n  reconnectInterval: 3000,\n  timeout: 30000,\n  heartbeatInterval: 25000,\n};\n\n/**\n * AnycastAgent — connects to the Anycast Agents rendezvous server\n * for P2P connectivity, signaling, and relay fallback.\n *\n * @example\n * ```typescript\n * const agent = new AnycastAgent({\n *   rendezvousUrl: 'wss://agents.anycast.com/rendezvous',\n *   token: 'agt_...',\n * });\n *\n * agent.on('connect', ({ agentId }) => {\n *   console.log(`Connected as ${agentId}`);\n * });\n *\n * agent.on('peer', (peerId, status) => {\n *   console.log(`Peer ${peerId} is ${status}`);\n * });\n *\n * await agent.connect();\n * ```\n */\nexport class AnycastAgent extends EventEmitter<AnycastAgentEvents> {\n  private ws: WebSocket | null = null;\n  private state: ConnectionState = ConnectionState.DISCONNECTED;\n  private heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private reconnectAttempt = 0;\n  private intentionalClose = false;\n\n  /** Agent ID assigned by the server after registration */\n  public agentId: string | null = null;\n  /** Tenant ID from the server */\n  public tenantId: string | null = null;\n  /** Agent name from the server */\n  public agentName: string | null = null;\n\n  private readonly opts: Required<\n    Pick<AnycastAgentOptions, 'rendezvousUrl' | 'token' | 'machineId' | 'publicKey' | 'reconnect' | 'reconnectInterval' | 'timeout' | 'heartbeatInterval'>\n  > & Pick<AnycastAgentOptions, 'version'>;\n\n  constructor(options: AnycastAgentOptions) {\n    super();\n\n    this.opts = {\n      rendezvousUrl: options.rendezvousUrl,\n      token: options.token,\n      machineId: options.machineId || randomBytes(16).toString('hex'),\n      publicKey: options.publicKey || randomBytes(32).toString('base64'),\n      version: options.version,\n      reconnect: options.reconnect ?? DEFAULT_OPTIONS.reconnect,\n      reconnectInterval: options.reconnectInterval ?? DEFAULT_OPTIONS.reconnectInterval,\n      timeout: options.timeout ?? DEFAULT_OPTIONS.timeout,\n      heartbeatInterval: options.heartbeatInterval ?? DEFAULT_OPTIONS.heartbeatInterval,\n    };\n  }\n\n  /** Current connection state */\n  get connectionState(): ConnectionState {\n    return this.state;\n  }\n\n  /** Whether the agent is connected */\n  get connected(): boolean {\n    return this.state === ConnectionState.CONNECTED;\n  }\n\n  /**\n   * Connect to the rendezvous server.\n   * Resolves when registered, rejects on timeout or fatal error.\n   */\n  async connect(): Promise<void> {\n    if (this.state === ConnectionState.CONNECTED || this.state === ConnectionState.CONNECTING) {\n      return;\n    }\n\n    this.intentionalClose = false;\n    this.setState(ConnectionState.CONNECTING);\n\n    return new Promise<void>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        this.cleanup();\n        const err = new AnycastError('Connection timeout', 'TIMEOUT', false);\n        this.emit('error', err);\n        reject(err);\n      }, this.opts.timeout);\n\n      try {\n        this.ws = new WebSocket(this.opts.rendezvousUrl);\n      } catch (err) {\n        clearTimeout(timeout);\n        const error = new AnycastError(\n          `Failed to create WebSocket: ${err instanceof Error ? err.message : String(err)}`,\n          'CONNECTION_FAILED',\n          false\n        );\n        this.setState(ConnectionState.DISCONNECTED);\n        reject(error);\n        return;\n      }\n\n      this.ws.on('open', () => {\n        this.send({\n          type: 'register',\n          token: this.opts.token,\n          machineId: this.opts.machineId,\n          publicKey: this.opts.publicKey,\n          version: this.opts.version,\n        });\n      });\n\n      this.ws.on('message', (data: WebSocket.Data) => {\n        let msg: ServerMessage;\n        try {\n          msg = JSON.parse(data.toString());\n        } catch {\n          return;\n        }\n\n        if (msg.type === 'registered') {\n          clearTimeout(timeout);\n          this.agentId = msg.agentId;\n          this.tenantId = msg.tenantId;\n          this.agentName = msg.name;\n          this.reconnectAttempt = 0;\n          this.setState(ConnectionState.CONNECTED);\n          this.startHeartbeat();\n          this.emit('connect', { agentId: msg.agentId, tenantId: msg.tenantId, name: msg.name });\n          resolve();\n          return;\n        }\n\n        if (msg.type === 'error' && msg.fatal) {\n          clearTimeout(timeout);\n          const err = new AnycastError(msg.message, msg.code, true);\n          this.emit('error', err);\n          this.cleanup();\n          reject(err);\n          return;\n        }\n\n        // Route other messages after registration\n        this.handleMessage(msg);\n      });\n\n      this.ws.on('close', (code, reason) => {\n        clearTimeout(timeout);\n        this.stopHeartbeat();\n        const wasConnected = this.state === ConnectionState.CONNECTED;\n        this.setState(ConnectionState.DISCONNECTED);\n\n        if (wasConnected) {\n          this.emit('disconnect', reason?.toString() || `Code ${code}`);\n        }\n\n        if (!this.intentionalClose && this.opts.reconnect) {\n          this.scheduleReconnect();\n        } else if (this.state !== ConnectionState.CONNECTED) {\n          reject(new AnycastError('Connection closed', 'CLOSED', false));\n        }\n      });\n\n      this.ws.on('error', (err) => {\n        const error = new AnycastError(err.message, 'WS_ERROR', false);\n        this.emit('error', error);\n      });\n    });\n  }\n\n  /**\n   * Disconnect from the rendezvous server.\n   */\n  async disconnect(): Promise<void> {\n    this.intentionalClose = true;\n    this.cleanup();\n    this.agentId = null;\n    this.tenantId = null;\n    this.agentName = null;\n  }\n\n  /**\n   * Request a connection to a peer agent.\n   * @returns The session ID for this connection\n   */\n  requestConnection(targetAgentId: string): string {\n    this.assertConnected();\n    const sessionId = randomBytes(16).toString('hex');\n    this.send({\n      type: 'connect_request',\n      targetAgentId,\n      sessionId,\n    });\n    return sessionId;\n  }\n\n  /**\n   * Send a WebRTC signal to a peer via the rendezvous server.\n   */\n  sendSignal(\n    sessionId: string,\n    targetAgentId: string,\n    signal: { type: 'offer' | 'answer' | 'ice'; data: string }\n  ): void {\n    this.assertConnected();\n    this.send({\n      type: 'signal',\n      sessionId,\n      targetAgentId,\n      signal,\n    });\n  }\n\n  /**\n   * Disconnect a session.\n   */\n  disconnectSession(sessionId: string): void {\n    this.assertConnected();\n    this.send({ type: 'disconnect', sessionId });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private\n  // ---------------------------------------------------------------------------\n\n  private handleMessage(msg: ServerMessage): void {\n    switch (msg.type) {\n      case 'heartbeat_ack':\n        // No action needed\n        break;\n\n      case 'agent_status':\n        this.emit('peer', msg.agentId, msg.status);\n        break;\n\n      case 'connect_incoming':\n        this.emit('connect_incoming', msg.sessionId, msg.fromAgentId, msg.fromAgentName);\n        break;\n\n      case 'connect_accepted':\n        this.emit('connect_accepted', msg.sessionId, msg.agentId, msg.publicKey);\n        break;\n\n      case 'connect_rejected':\n        this.emit('connect_rejected', msg.sessionId, msg.reason);\n        break;\n\n      case 'signal_forward':\n        this.emit('signal', msg.sessionId, msg.fromAgentId, msg.signal);\n        break;\n\n      case 'relay_assigned':\n        this.emit('relay_assigned', msg.sessionId, msg.relayHost, msg.relayPort, msg.relayToken);\n        break;\n\n      case 'error':\n        this.emit('error', new AnycastError(msg.message, msg.code, msg.fatal || false));\n        if (msg.fatal) {\n          this.cleanup();\n        }\n        break;\n    }\n  }\n\n  private send(msg: ClientMessage): void {\n    if (this.ws?.readyState === WebSocket.OPEN) {\n      this.ws.send(JSON.stringify(msg));\n    }\n  }\n\n  private startHeartbeat(): void {\n    this.stopHeartbeat();\n    this.heartbeatTimer = setInterval(() => {\n      this.send({ type: 'heartbeat' });\n    }, this.opts.heartbeatInterval);\n  }\n\n  private stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = null;\n    }\n  }\n\n  private scheduleReconnect(): void {\n    if (this.reconnectTimer) return;\n\n    this.reconnectAttempt++;\n    // Exponential backoff: base * 2^attempt, capped at 30s\n    const delay = Math.min(\n      this.opts.reconnectInterval * Math.pow(2, this.reconnectAttempt - 1),\n      30000\n    );\n\n    this.setState(ConnectionState.RECONNECTING);\n    this.emit('reconnecting', this.reconnectAttempt);\n\n    this.reconnectTimer = setTimeout(async () => {\n      this.reconnectTimer = null;\n      try {\n        await this.connect();\n      } catch {\n        // connect() will schedule another reconnect if needed\n      }\n    }, delay);\n  }\n\n  private cleanup(): void {\n    this.stopHeartbeat();\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n    if (this.ws) {\n      this.ws.removeAllListeners();\n      if (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING) {\n        this.ws.close(1000, 'Client disconnect');\n      }\n      this.ws = null;\n    }\n    this.setState(ConnectionState.DISCONNECTED);\n  }\n\n  private setState(state: ConnectionState): void {\n    if (this.state !== state) {\n      this.state = state;\n      this.emit('stateChange', state);\n    }\n  }\n\n  private assertConnected(): void {\n    if (this.state !== ConnectionState.CONNECTED || !this.ws) {\n      throw new AnycastError('Not connected', 'NOT_CONNECTED', false);\n    }\n  }\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,294 @@
+import WebSocket from 'ws';
+import EventEmitter from 'eventemitter3';
+import { randomBytes } from 'crypto';
+
+// src/agent.ts
+
+// src/types.ts
+var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
+  ConnectionState2["DISCONNECTED"] = "DISCONNECTED";
+  ConnectionState2["CONNECTING"] = "CONNECTING";
+  ConnectionState2["CONNECTED"] = "CONNECTED";
+  ConnectionState2["RECONNECTING"] = "RECONNECTING";
+  return ConnectionState2;
+})(ConnectionState || {});
+var AnycastError = class extends Error {
+  constructor(message, code, fatal = false) {
+    super(message);
+    this.code = code;
+    this.fatal = fatal;
+    this.name = "AnycastError";
+  }
+};
+
+// src/agent.ts
+var DEFAULT_OPTIONS = {
+  reconnect: true,
+  reconnectInterval: 3e3,
+  timeout: 3e4,
+  heartbeatInterval: 25e3
+};
+var AnycastAgent = class extends EventEmitter {
+  constructor(options) {
+    super();
+    this.ws = null;
+    this.state = "DISCONNECTED" /* DISCONNECTED */;
+    this.heartbeatTimer = null;
+    this.reconnectTimer = null;
+    this.reconnectAttempt = 0;
+    this.intentionalClose = false;
+    /** Agent ID assigned by the server after registration */
+    this.agentId = null;
+    /** Tenant ID from the server */
+    this.tenantId = null;
+    /** Agent name from the server */
+    this.agentName = null;
+    this.opts = {
+      rendezvousUrl: options.rendezvousUrl,
+      token: options.token,
+      machineId: options.machineId || randomBytes(16).toString("hex"),
+      publicKey: options.publicKey || randomBytes(32).toString("base64"),
+      version: options.version,
+      reconnect: options.reconnect ?? DEFAULT_OPTIONS.reconnect,
+      reconnectInterval: options.reconnectInterval ?? DEFAULT_OPTIONS.reconnectInterval,
+      timeout: options.timeout ?? DEFAULT_OPTIONS.timeout,
+      heartbeatInterval: options.heartbeatInterval ?? DEFAULT_OPTIONS.heartbeatInterval
+    };
+  }
+  /** Current connection state */
+  get connectionState() {
+    return this.state;
+  }
+  /** Whether the agent is connected */
+  get connected() {
+    return this.state === "CONNECTED" /* CONNECTED */;
+  }
+  /**
+   * Connect to the rendezvous server.
+   * Resolves when registered, rejects on timeout or fatal error.
+   */
+  async connect() {
+    if (this.state === "CONNECTED" /* CONNECTED */ || this.state === "CONNECTING" /* CONNECTING */) {
+      return;
+    }
+    this.intentionalClose = false;
+    this.setState("CONNECTING" /* CONNECTING */);
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        this.cleanup();
+        const err = new AnycastError("Connection timeout", "TIMEOUT", false);
+        this.emit("error", err);
+        reject(err);
+      }, this.opts.timeout);
+      try {
+        this.ws = new WebSocket(this.opts.rendezvousUrl);
+      } catch (err) {
+        clearTimeout(timeout);
+        const error = new AnycastError(
+          `Failed to create WebSocket: ${err instanceof Error ? err.message : String(err)}`,
+          "CONNECTION_FAILED",
+          false
+        );
+        this.setState("DISCONNECTED" /* DISCONNECTED */);
+        reject(error);
+        return;
+      }
+      this.ws.on("open", () => {
+        this.send({
+          type: "register",
+          token: this.opts.token,
+          machineId: this.opts.machineId,
+          publicKey: this.opts.publicKey,
+          version: this.opts.version
+        });
+      });
+      this.ws.on("message", (data) => {
+        let msg;
+        try {
+          msg = JSON.parse(data.toString());
+        } catch {
+          return;
+        }
+        if (msg.type === "registered") {
+          clearTimeout(timeout);
+          this.agentId = msg.agentId;
+          this.tenantId = msg.tenantId;
+          this.agentName = msg.name;
+          this.reconnectAttempt = 0;
+          this.setState("CONNECTED" /* CONNECTED */);
+          this.startHeartbeat();
+          this.emit("connect", { agentId: msg.agentId, tenantId: msg.tenantId, name: msg.name });
+          resolve();
+          return;
+        }
+        if (msg.type === "error" && msg.fatal) {
+          clearTimeout(timeout);
+          const err = new AnycastError(msg.message, msg.code, true);
+          this.emit("error", err);
+          this.cleanup();
+          reject(err);
+          return;
+        }
+        this.handleMessage(msg);
+      });
+      this.ws.on("close", (code, reason) => {
+        clearTimeout(timeout);
+        this.stopHeartbeat();
+        const wasConnected = this.state === "CONNECTED" /* CONNECTED */;
+        this.setState("DISCONNECTED" /* DISCONNECTED */);
+        if (wasConnected) {
+          this.emit("disconnect", reason?.toString() || `Code ${code}`);
+        }
+        if (!this.intentionalClose && this.opts.reconnect) {
+          this.scheduleReconnect();
+        } else if (this.state !== "CONNECTED" /* CONNECTED */) {
+          reject(new AnycastError("Connection closed", "CLOSED", false));
+        }
+      });
+      this.ws.on("error", (err) => {
+        const error = new AnycastError(err.message, "WS_ERROR", false);
+        this.emit("error", error);
+      });
+    });
+  }
+  /**
+   * Disconnect from the rendezvous server.
+   */
+  async disconnect() {
+    this.intentionalClose = true;
+    this.cleanup();
+    this.agentId = null;
+    this.tenantId = null;
+    this.agentName = null;
+  }
+  /**
+   * Request a connection to a peer agent.
+   * @returns The session ID for this connection
+   */
+  requestConnection(targetAgentId) {
+    this.assertConnected();
+    const sessionId = randomBytes(16).toString("hex");
+    this.send({
+      type: "connect_request",
+      targetAgentId,
+      sessionId
+    });
+    return sessionId;
+  }
+  /**
+   * Send a WebRTC signal to a peer via the rendezvous server.
+   */
+  sendSignal(sessionId, targetAgentId, signal) {
+    this.assertConnected();
+    this.send({
+      type: "signal",
+      sessionId,
+      targetAgentId,
+      signal
+    });
+  }
+  /**
+   * Disconnect a session.
+   */
+  disconnectSession(sessionId) {
+    this.assertConnected();
+    this.send({ type: "disconnect", sessionId });
+  }
+  // ---------------------------------------------------------------------------
+  // Private
+  // ---------------------------------------------------------------------------
+  handleMessage(msg) {
+    switch (msg.type) {
+      case "heartbeat_ack":
+        break;
+      case "agent_status":
+        this.emit("peer", msg.agentId, msg.status);
+        break;
+      case "connect_incoming":
+        this.emit("connect_incoming", msg.sessionId, msg.fromAgentId, msg.fromAgentName);
+        break;
+      case "connect_accepted":
+        this.emit("connect_accepted", msg.sessionId, msg.agentId, msg.publicKey);
+        break;
+      case "connect_rejected":
+        this.emit("connect_rejected", msg.sessionId, msg.reason);
+        break;
+      case "signal_forward":
+        this.emit("signal", msg.sessionId, msg.fromAgentId, msg.signal);
+        break;
+      case "relay_assigned":
+        this.emit("relay_assigned", msg.sessionId, msg.relayHost, msg.relayPort, msg.relayToken);
+        break;
+      case "error":
+        this.emit("error", new AnycastError(msg.message, msg.code, msg.fatal || false));
+        if (msg.fatal) {
+          this.cleanup();
+        }
+        break;
+    }
+  }
+  send(msg) {
+    if (this.ws?.readyState === WebSocket.OPEN) {
+      this.ws.send(JSON.stringify(msg));
+    }
+  }
+  startHeartbeat() {
+    this.stopHeartbeat();
+    this.heartbeatTimer = setInterval(() => {
+      this.send({ type: "heartbeat" });
+    }, this.opts.heartbeatInterval);
+  }
+  stopHeartbeat() {
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
+  }
+  scheduleReconnect() {
+    if (this.reconnectTimer) return;
+    this.reconnectAttempt++;
+    const delay = Math.min(
+      this.opts.reconnectInterval * Math.pow(2, this.reconnectAttempt - 1),
+      3e4
+    );
+    this.setState("RECONNECTING" /* RECONNECTING */);
+    this.emit("reconnecting", this.reconnectAttempt);
+    this.reconnectTimer = setTimeout(async () => {
+      this.reconnectTimer = null;
+      try {
+        await this.connect();
+      } catch {
+      }
+    }, delay);
+  }
+  cleanup() {
+    this.stopHeartbeat();
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+    if (this.ws) {
+      this.ws.removeAllListeners();
+      if (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING) {
+        this.ws.close(1e3, "Client disconnect");
+      }
+      this.ws = null;
+    }
+    this.setState("DISCONNECTED" /* DISCONNECTED */);
+  }
+  setState(state) {
+    if (this.state !== state) {
+      this.state = state;
+      this.emit("stateChange", state);
+    }
+  }
+  assertConnected() {
+    if (this.state !== "CONNECTED" /* CONNECTED */ || !this.ws) {
+      throw new AnycastError("Not connected", "NOT_CONNECTED", false);
+    }
+  }
+};
+
+export { AnycastAgent, AnycastError, ConnectionState };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/agent.ts"],"names":["ConnectionState"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Agent SDK types — mirrors the rendezvous server protocol.\n */\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface AnycastAgentOptions {\n  /** WebSocket URL of the rendezvous server (e.g., wss://agents.anycast.com/rendezvous) */\n  rendezvousUrl: string;\n  /** Agent auth token from the Anycast portal */\n  token: string;\n  /** Unique machine identifier (auto-generated if not provided) */\n  machineId?: string;\n  /** Public key for end-to-end encryption */\n  publicKey?: string;\n  /** Agent version string */\n  version?: string;\n  /** Auto-reconnect on disconnect (default: true) */\n  reconnect?: boolean;\n  /** Reconnect interval in ms (default: 3000) */\n  reconnectInterval?: number;\n  /** Connection timeout in ms (default: 30000) */\n  timeout?: number;\n  /** Heartbeat interval in ms (default: 25000) */\n  heartbeatInterval?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Connection state\n// ---------------------------------------------------------------------------\n\nexport enum ConnectionState {\n  DISCONNECTED = 'DISCONNECTED',\n  CONNECTING = 'CONNECTING',\n  CONNECTED = 'CONNECTED',\n  RECONNECTING = 'RECONNECTING',\n}\n\n// ---------------------------------------------------------------------------\n// Client → Server messages\n// ---------------------------------------------------------------------------\n\nexport interface RegisterMessage {\n  type: 'register';\n  token: string;\n  machineId: string;\n  publicKey: string;\n  version?: string;\n  os?: string;\n  arch?: string;\n}\n\nexport interface HeartbeatMessage {\n  type: 'heartbeat';\n}\n\nexport interface ConnectRequestMessage {\n  type: 'connect_request';\n  targetAgentId: string;\n  sessionId: string;\n}\n\nexport interface SignalMessage {\n  type: 'signal';\n  sessionId: string;\n  targetAgentId: string;\n  signal: {\n    type: 'offer' | 'answer' | 'ice';\n    data: string;\n  };\n}\n\nexport interface DisconnectMessage {\n  type: 'disconnect';\n  sessionId: string;\n}\n\nexport type ClientMessage =\n  | RegisterMessage\n  | HeartbeatMessage\n  | ConnectRequestMessage\n  | SignalMessage\n  | DisconnectMessage;\n\n// ---------------------------------------------------------------------------\n// Server → Client messages\n// ---------------------------------------------------------------------------\n\nexport interface RegisteredMessage {\n  type: 'registered';\n  agentId: string;\n  tenantId: string;\n  name: string;\n}\n\nexport interface HeartbeatAckMessage {\n  type: 'heartbeat_ack';\n  timestamp: number;\n}\n\nexport interface ConnectIncomingMessage {\n  type: 'connect_incoming';\n  sessionId: string;\n  fromAgentId: string;\n  fromAgentName: string;\n}\n\nexport interface ConnectAcceptedMessage {\n  type: 'connect_accepted';\n  sessionId: string;\n  agentId: string;\n  agentName: string;\n  publicKey: string;\n}\n\nexport interface ConnectRejectedMessage {\n  type: 'connect_rejected';\n  sessionId: string;\n  reason: string;\n}\n\nexport interface SignalForwardMessage {\n  type: 'signal_forward';\n  sessionId: string;\n  fromAgentId: string;\n  signal: {\n    type: 'offer' | 'answer' | 'ice';\n    data: string;\n  };\n}\n\nexport interface RelayAssignedMessage {\n  type: 'relay_assigned';\n  sessionId: string;\n  relayHost: string;\n  relayPort: number;\n  relayToken: string;\n}\n\nexport interface AgentStatusMessage {\n  type: 'agent_status';\n  agentId: string;\n  status: 'online' | 'offline';\n}\n\nexport interface ErrorMessage {\n  type: 'error';\n  code: string;\n  message: string;\n  fatal?: boolean;\n}\n\nexport type ServerMessage =\n  | RegisteredMessage\n  | HeartbeatAckMessage\n  | ConnectIncomingMessage\n  | ConnectAcceptedMessage\n  | ConnectRejectedMessage\n  | SignalForwardMessage\n  | RelayAssignedMessage\n  | AgentStatusMessage\n  | ErrorMessage;\n\n// ---------------------------------------------------------------------------\n// Event map for typed event emitter\n// ---------------------------------------------------------------------------\n\nexport interface AnycastAgentEvents {\n  connect: (info: { agentId: string; tenantId: string; name: string }) => void;\n  disconnect: (reason: string) => void;\n  reconnecting: (attempt: number) => void;\n  message: (fromAgentId: string, data: string) => void;\n  peer: (agentId: string, status: 'online' | 'offline') => void;\n  'connect_incoming': (sessionId: string, fromAgentId: string, fromAgentName: string) => void;\n  'connect_accepted': (sessionId: string, agentId: string, publicKey: string) => void;\n  'connect_rejected': (sessionId: string, reason: string) => void;\n  signal: (sessionId: string, fromAgentId: string, signal: { type: string; data: string }) => void;\n  'relay_assigned': (sessionId: string, relayHost: string, relayPort: number, relayToken: string) => void;\n  error: (error: AnycastError) => void;\n  stateChange: (state: ConnectionState) => void;\n}\n\n// ---------------------------------------------------------------------------\n// Error\n// ---------------------------------------------------------------------------\n\nexport class AnycastError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public fatal: boolean = false\n  ) {\n    super(message);\n    this.name = 'AnycastError';\n  }\n}\n","import WebSocket from 'ws';\nimport EventEmitter from 'eventemitter3';\nimport { randomBytes } from 'crypto';\nimport {\n  type AnycastAgentOptions,\n  type AnycastAgentEvents,\n  type ServerMessage,\n  type ClientMessage,\n  ConnectionState,\n  AnycastError,\n} from './types.js';\n\nconst DEFAULT_OPTIONS = {\n  reconnect: true,\n  reconnectInterval: 3000,\n  timeout: 30000,\n  heartbeatInterval: 25000,\n};\n\n/**\n * AnycastAgent — connects to the Anycast Agents rendezvous server\n * for P2P connectivity, signaling, and relay fallback.\n *\n * @example\n * ```typescript\n * const agent = new AnycastAgent({\n *   rendezvousUrl: 'wss://agents.anycast.com/rendezvous',\n *   token: 'agt_...',\n * });\n *\n * agent.on('connect', ({ agentId }) => {\n *   console.log(`Connected as ${agentId}`);\n * });\n *\n * agent.on('peer', (peerId, status) => {\n *   console.log(`Peer ${peerId} is ${status}`);\n * });\n *\n * await agent.connect();\n * ```\n */\nexport class AnycastAgent extends EventEmitter<AnycastAgentEvents> {\n  private ws: WebSocket | null = null;\n  private state: ConnectionState = ConnectionState.DISCONNECTED;\n  private heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private reconnectAttempt = 0;\n  private intentionalClose = false;\n\n  /** Agent ID assigned by the server after registration */\n  public agentId: string | null = null;\n  /** Tenant ID from the server */\n  public tenantId: string | null = null;\n  /** Agent name from the server */\n  public agentName: string | null = null;\n\n  private readonly opts: Required<\n    Pick<AnycastAgentOptions, 'rendezvousUrl' | 'token' | 'machineId' | 'publicKey' | 'reconnect' | 'reconnectInterval' | 'timeout' | 'heartbeatInterval'>\n  > & Pick<AnycastAgentOptions, 'version'>;\n\n  constructor(options: AnycastAgentOptions) {\n    super();\n\n    this.opts = {\n      rendezvousUrl: options.rendezvousUrl,\n      token: options.token,\n      machineId: options.machineId || randomBytes(16).toString('hex'),\n      publicKey: options.publicKey || randomBytes(32).toString('base64'),\n      version: options.version,\n      reconnect: options.reconnect ?? DEFAULT_OPTIONS.reconnect,\n      reconnectInterval: options.reconnectInterval ?? DEFAULT_OPTIONS.reconnectInterval,\n      timeout: options.timeout ?? DEFAULT_OPTIONS.timeout,\n      heartbeatInterval: options.heartbeatInterval ?? DEFAULT_OPTIONS.heartbeatInterval,\n    };\n  }\n\n  /** Current connection state */\n  get connectionState(): ConnectionState {\n    return this.state;\n  }\n\n  /** Whether the agent is connected */\n  get connected(): boolean {\n    return this.state === ConnectionState.CONNECTED;\n  }\n\n  /**\n   * Connect to the rendezvous server.\n   * Resolves when registered, rejects on timeout or fatal error.\n   */\n  async connect(): Promise<void> {\n    if (this.state === ConnectionState.CONNECTED || this.state === ConnectionState.CONNECTING) {\n      return;\n    }\n\n    this.intentionalClose = false;\n    this.setState(ConnectionState.CONNECTING);\n\n    return new Promise<void>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        this.cleanup();\n        const err = new AnycastError('Connection timeout', 'TIMEOUT', false);\n        this.emit('error', err);\n        reject(err);\n      }, this.opts.timeout);\n\n      try {\n        this.ws = new WebSocket(this.opts.rendezvousUrl);\n      } catch (err) {\n        clearTimeout(timeout);\n        const error = new AnycastError(\n          `Failed to create WebSocket: ${err instanceof Error ? err.message : String(err)}`,\n          'CONNECTION_FAILED',\n          false\n        );\n        this.setState(ConnectionState.DISCONNECTED);\n        reject(error);\n        return;\n      }\n\n      this.ws.on('open', () => {\n        this.send({\n          type: 'register',\n          token: this.opts.token,\n          machineId: this.opts.machineId,\n          publicKey: this.opts.publicKey,\n          version: this.opts.version,\n        });\n      });\n\n      this.ws.on('message', (data: WebSocket.Data) => {\n        let msg: ServerMessage;\n        try {\n          msg = JSON.parse(data.toString());\n        } catch {\n          return;\n        }\n\n        if (msg.type === 'registered') {\n          clearTimeout(timeout);\n          this.agentId = msg.agentId;\n          this.tenantId = msg.tenantId;\n          this.agentName = msg.name;\n          this.reconnectAttempt = 0;\n          this.setState(ConnectionState.CONNECTED);\n          this.startHeartbeat();\n          this.emit('connect', { agentId: msg.agentId, tenantId: msg.tenantId, name: msg.name });\n          resolve();\n          return;\n        }\n\n        if (msg.type === 'error' && msg.fatal) {\n          clearTimeout(timeout);\n          const err = new AnycastError(msg.message, msg.code, true);\n          this.emit('error', err);\n          this.cleanup();\n          reject(err);\n          return;\n        }\n\n        // Route other messages after registration\n        this.handleMessage(msg);\n      });\n\n      this.ws.on('close', (code, reason) => {\n        clearTimeout(timeout);\n        this.stopHeartbeat();\n        const wasConnected = this.state === ConnectionState.CONNECTED;\n        this.setState(ConnectionState.DISCONNECTED);\n\n        if (wasConnected) {\n          this.emit('disconnect', reason?.toString() || `Code ${code}`);\n        }\n\n        if (!this.intentionalClose && this.opts.reconnect) {\n          this.scheduleReconnect();\n        } else if (this.state !== ConnectionState.CONNECTED) {\n          reject(new AnycastError('Connection closed', 'CLOSED', false));\n        }\n      });\n\n      this.ws.on('error', (err) => {\n        const error = new AnycastError(err.message, 'WS_ERROR', false);\n        this.emit('error', error);\n      });\n    });\n  }\n\n  /**\n   * Disconnect from the rendezvous server.\n   */\n  async disconnect(): Promise<void> {\n    this.intentionalClose = true;\n    this.cleanup();\n    this.agentId = null;\n    this.tenantId = null;\n    this.agentName = null;\n  }\n\n  /**\n   * Request a connection to a peer agent.\n   * @returns The session ID for this connection\n   */\n  requestConnection(targetAgentId: string): string {\n    this.assertConnected();\n    const sessionId = randomBytes(16).toString('hex');\n    this.send({\n      type: 'connect_request',\n      targetAgentId,\n      sessionId,\n    });\n    return sessionId;\n  }\n\n  /**\n   * Send a WebRTC signal to a peer via the rendezvous server.\n   */\n  sendSignal(\n    sessionId: string,\n    targetAgentId: string,\n    signal: { type: 'offer' | 'answer' | 'ice'; data: string }\n  ): void {\n    this.assertConnected();\n    this.send({\n      type: 'signal',\n      sessionId,\n      targetAgentId,\n      signal,\n    });\n  }\n\n  /**\n   * Disconnect a session.\n   */\n  disconnectSession(sessionId: string): void {\n    this.assertConnected();\n    this.send({ type: 'disconnect', sessionId });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private\n  // ---------------------------------------------------------------------------\n\n  private handleMessage(msg: ServerMessage): void {\n    switch (msg.type) {\n      case 'heartbeat_ack':\n        // No action needed\n        break;\n\n      case 'agent_status':\n        this.emit('peer', msg.agentId, msg.status);\n        break;\n\n      case 'connect_incoming':\n        this.emit('connect_incoming', msg.sessionId, msg.fromAgentId, msg.fromAgentName);\n        break;\n\n      case 'connect_accepted':\n        this.emit('connect_accepted', msg.sessionId, msg.agentId, msg.publicKey);\n        break;\n\n      case 'connect_rejected':\n        this.emit('connect_rejected', msg.sessionId, msg.reason);\n        break;\n\n      case 'signal_forward':\n        this.emit('signal', msg.sessionId, msg.fromAgentId, msg.signal);\n        break;\n\n      case 'relay_assigned':\n        this.emit('relay_assigned', msg.sessionId, msg.relayHost, msg.relayPort, msg.relayToken);\n        break;\n\n      case 'error':\n        this.emit('error', new AnycastError(msg.message, msg.code, msg.fatal || false));\n        if (msg.fatal) {\n          this.cleanup();\n        }\n        break;\n    }\n  }\n\n  private send(msg: ClientMessage): void {\n    if (this.ws?.readyState === WebSocket.OPEN) {\n      this.ws.send(JSON.stringify(msg));\n    }\n  }\n\n  private startHeartbeat(): void {\n    this.stopHeartbeat();\n    this.heartbeatTimer = setInterval(() => {\n      this.send({ type: 'heartbeat' });\n    }, this.opts.heartbeatInterval);\n  }\n\n  private stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = null;\n    }\n  }\n\n  private scheduleReconnect(): void {\n    if (this.reconnectTimer) return;\n\n    this.reconnectAttempt++;\n    // Exponential backoff: base * 2^attempt, capped at 30s\n    const delay = Math.min(\n      this.opts.reconnectInterval * Math.pow(2, this.reconnectAttempt - 1),\n      30000\n    );\n\n    this.setState(ConnectionState.RECONNECTING);\n    this.emit('reconnecting', this.reconnectAttempt);\n\n    this.reconnectTimer = setTimeout(async () => {\n      this.reconnectTimer = null;\n      try {\n        await this.connect();\n      } catch {\n        // connect() will schedule another reconnect if needed\n      }\n    }, delay);\n  }\n\n  private cleanup(): void {\n    this.stopHeartbeat();\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n    if (this.ws) {\n      this.ws.removeAllListeners();\n      if (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING) {\n        this.ws.close(1000, 'Client disconnect');\n      }\n      this.ws = null;\n    }\n    this.setState(ConnectionState.DISCONNECTED);\n  }\n\n  private setState(state: ConnectionState): void {\n    if (this.state !== state) {\n      this.state = state;\n      this.emit('stateChange', state);\n    }\n  }\n\n  private assertConnected(): void {\n    if (this.state !== ConnectionState.CONNECTED || !this.ws) {\n      throw new AnycastError('Not connected', 'NOT_CONNECTED', false);\n    }\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@anycast/agent",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Anycast Agents P2P connectivity",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "eventemitter3": "^5.0.1",
+    "ws": "^8.16.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/ws": "^8.5.10",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "anycast",
+    "p2p",
+    "agents",
+    "webrtc",
+    "relay",
+    "connectivity"
+  ],
+  "license": "MIT"
+}