agent-relay 2.1.5 → 2.1.6

package/packages/sdk/dist/index.d.ts

@@ -24,10 +24,26 @@
  * const client = new RelayClient({ agentName: 'MyAgent' });
  * await client.connect();
  * ```
+ *
+ * ## Browser Usage (WebSocket)
+ *
+ * ```typescript
+ * import { BrowserRelayClient } from '@agent-relay/sdk';
+ *
+ * const client = new BrowserRelayClient({
+ *   agentName: 'BrowserAgent',
+ *   transport: { wsUrl: 'wss://relay.example.com/ws' },
+ * });
+ * await client.connect();
+ * ```
  */
-export { RelayClient, type ClientState, type ClientConfig, type SyncOptions, } from './client.js';
+export { RelayClient, type ClientState, type ClientConfig, type SyncOptions, type RequestOptions, type RequestResponse, type SpawnResult, } from './client.js';
+export { BrowserRelayClient, type BrowserClientState, type BrowserClientConfig, type BrowserRequestOptions, type BrowserRequestResponse, } from './browser-client.js';
+export { type Transport, type TransportConfig, type TransportEvents, type TransportState, type TransportFactory, SocketTransport, createSocketTransport, type SocketTransportConfig, WebSocketTransport, createWebSocketTransport, socketPathToWsUrl, type WebSocketTransportConfig, createAutoTransport, type AutoTransportOptions, detectEnvironment, type EnvironmentInfo, isBrowser, isNode, } from './transports/index.js';
 export { createRelay, createPair, type Relay, type RelayConfig, } from './standalone.js';
-export { PROTOCOL_VERSION, type MessageType, type PayloadKind, type Envelope, type EntityType, type SendPayload, type SendMeta, type SyncMeta, type DeliveryInfo, type AckPayload, type ErrorCode, type ErrorPayload, type SpeakOnTrigger, type ShadowConfig, type SpawnPayload, type SpawnResultPayload, type ReleasePayload, type ReleaseResultPayload, type ChannelMessagePayload, type ChannelJoinPayload, type ChannelLeavePayload, type MessageAttachment, type StatusResponsePayload, type InboxMessage, type MessagesResponsePayload, type AgentInfo, type HealthResponsePayload, type CrashRecord, type AlertRecord, type MetricsResponsePayload, type AgentMetrics, type ConsensusType, type VoteValue, type ProposalStatus, type CreateProposalOptions, type VoteOptions, } from './protocol/index.js';
+export { PROTOCOL_VERSION, type MessageType, type PayloadKind, type Envelope, type EntityType, type SendPayload, type SendMeta, type SyncMeta, type DeliveryInfo, type AckPayload, type ErrorCode, type ErrorPayload, type SpeakOnTrigger, type ShadowConfig, type SpawnPayload, type SpawnResultPayload, type ReleasePayload, type ReleaseResultPayload, type AgentReadyPayload, type ChannelMessagePayload, type ChannelJoinPayload, type ChannelLeavePayload, type MessageAttachment, type StatusResponsePayload, type InboxMessage, type MessagesResponsePayload, type AgentInfo, type HealthResponsePayload, type CrashRecord, type AlertRecord, type MetricsResponsePayload, type AgentMetrics, type ConsensusType, type VoteValue, type ProposalStatus, type CreateProposalOptions, type VoteOptions, } from './protocol/index.js';
 export { encodeFrame, encodeFrameLegacy, FrameParser, MAX_FRAME_BYTES, } from './protocol/index.js';
 export { getLogs, listLoggedAgents, type GetLogsOptions, type LogsResult, } from './logs.js';
+export { discoverSocket, discoverAgentName, detectCloudWorkspace, isCloudWorkspace, getCloudSocketPath, getCloudOutboxPath, getConnectionInfo, getCloudEnvironmentSummary, cloudApiRequest, getWorkspaceStatus, type DiscoveryResult, type CloudWorkspace, type CloudConnectionOptions, type CloudConnectionInfo, } from './discovery.js';
+export { RelayError, DaemonNotRunningError, AgentNotFoundError, TimeoutError, ConnectionError, ChannelNotFoundError, SpawnError, } from './errors.js';
 //# sourceMappingURL=index.d.ts.map

package/packages/sdk/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,UAAU,EACV,KAAK,KAAK,EACV,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,YAAY,EAEjB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAEzB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAEtB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EAEjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAErB,eAAe,EACf,qBAAqB,EACrB,KAAK,qBAAqB,EAE1B,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,wBAAwB,EAE7B,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,iBAAiB,EACjB,KAAK,eAAe,EACpB,SAAS,EACT,MAAM,GACP,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,UAAU,EACV,KAAK,KAAK,EACV,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,YAAY,EAEjB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAEzB,KAAK,iBAAiB,EAEtB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAEtB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EAEjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,EAC1B,eAAe,EACf,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,UAAU,GACX,MAAM,aAAa,CAAC"}

package/packages/sdk/dist/index.js

@@ -24,9 +24,31 @@
  * const client = new RelayClient({ agentName: 'MyAgent' });
  * await client.connect();
  * ```
+ *
+ * ## Browser Usage (WebSocket)
+ *
+ * ```typescript
+ * import { BrowserRelayClient } from '@agent-relay/sdk';
+ *
+ * const client = new BrowserRelayClient({
+ *   agentName: 'BrowserAgent',
+ *   transport: { wsUrl: 'wss://relay.example.com/ws' },
+ * });
+ * await client.connect();
+ * ```
  */
-// Main client
+// Main client (Node.js, Unix sockets)
 export { RelayClient, } from './client.js';
+// Browser-compatible client (WebSocket)
+export { BrowserRelayClient, } from './browser-client.js';
+// Transport abstractions
+export { 
+// Socket transport (Node.js)
+SocketTransport, createSocketTransport, 
+// WebSocket transport (Browser + Node.js)
+WebSocketTransport, createWebSocketTransport, socketPathToWsUrl, 
+// Auto-detection
+createAutoTransport, detectEnvironment, isBrowser, isNode, } from './transports/index.js';
 // Standalone relay (in-process daemon for simple use cases)
 export { createRelay, createPair, } from './standalone.js';
 // Protocol types (re-export for convenience)
@@ -35,4 +57,8 @@ export { PROTOCOL_VERSION, } from './protocol/index.js';
 export { encodeFrame, encodeFrameLegacy, FrameParser, MAX_FRAME_BYTES, } from './protocol/index.js';
 // Log utilities (file-based, doesn't require connection)
 export { getLogs, listLoggedAgents, } from './logs.js';
+// Discovery (socket discovery, cloud workspace detection, agent identity)
+export { discoverSocket, discoverAgentName, detectCloudWorkspace, isCloudWorkspace, getCloudSocketPath, getCloudOutboxPath, getConnectionInfo, getCloudEnvironmentSummary, cloudApiRequest, getWorkspaceStatus, } from './discovery.js';
+// Error types
+export { RelayError, DaemonNotRunningError, AgentNotFoundError, TimeoutError, ConnectionError, ChannelNotFoundError, SpawnError, } from './errors.js';
 //# sourceMappingURL=index.js.map

package/packages/sdk/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,cAAc;AACd,OAAO,EACL,WAAW,GAIZ,MAAM,aAAa,CAAC;AAErB,4DAA4D;AAC5D,OAAO,EACL,WAAW,EACX,UAAU,GAGX,MAAM,iBAAiB,CAAC;AAEzB,6CAA6C;AAC7C,OAAO,EACL,gBAAgB,GAwCjB,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,yDAAyD;AACzD,OAAO,EACL,OAAO,EACP,gBAAgB,GAGjB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,sCAAsC;AACtC,OAAO,EACL,WAAW,GAOZ,MAAM,aAAa,CAAC;AAErB,wCAAwC;AACxC,OAAO,EACL,kBAAkB,GAKnB,MAAM,qBAAqB,CAAC;AAE7B,yBAAyB;AACzB,OAAO;AAOL,6BAA6B;AAC7B,eAAe,EACf,qBAAqB;AAErB,0CAA0C;AAC1C,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB;AAEjB,iBAAiB;AACjB,mBAAmB,EAEnB,iBAAiB,EAEjB,SAAS,EACT,MAAM,GACP,MAAM,uBAAuB,CAAC;AAE/B,4DAA4D;AAC5D,OAAO,EACL,WAAW,EACX,UAAU,GAGX,MAAM,iBAAiB,CAAC;AAEzB,6CAA6C;AAC7C,OAAO,EACL,gBAAgB,GA0CjB,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,yDAAyD;AACzD,OAAO,EACL,OAAO,EACP,gBAAgB,GAGjB,MAAM,WAAW,CAAC;AAEnB,0EAA0E;AAC1E,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,EAC1B,eAAe,EACf,kBAAkB,GAKnB,MAAM,gBAAgB,CAAC;AAExB,cAAc;AACd,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,UAAU,GACX,MAAM,aAAa,CAAC"}

package/packages/sdk/dist/transports/index.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Transport module for relay client communication.
+ * @agent-relay/sdk
+ *
+ * Provides transport abstraction and implementations:
+ * - SocketTransport: Unix/TCP sockets (Node.js only)
+ * - WebSocketTransport: WebSocket connections (Node.js and Browser)
+ *
+ * Auto-detection selects the appropriate transport based on environment.
+ */
+export type { Transport, TransportConfig, TransportEvents, TransportState, TransportFactory, } from './types.js';
+export { SocketTransport, createSocketTransport, type SocketTransportConfig, } from './socket-transport.js';
+export { WebSocketTransport, createWebSocketTransport, socketPathToWsUrl, type WebSocketTransportConfig, } from './websocket-transport.js';
+import type { Transport, TransportConfig } from './types.js';
+/**
+ * Environment detection result.
+ */
+export interface EnvironmentInfo {
+    /** Running in browser environment */
+    isBrowser: boolean;
+    /** Running in Node.js environment */
+    isNode: boolean;
+    /** WebSocket API is available */
+    hasWebSocket: boolean;
+    /** Unix sockets are available (Node.js only) */
+    hasUnixSockets: boolean;
+}
+/**
+ * Detect the current runtime environment.
+ */
+export declare function detectEnvironment(): EnvironmentInfo;
+/**
+ * Options for creating an auto-detected transport.
+ */
+export interface AutoTransportOptions extends TransportConfig {
+    /** Unix socket path (for Node.js socket transport) */
+    socketPath?: string;
+    /** WebSocket URL (for WebSocket transport) */
+    wsUrl?: string;
+    /** WebSocket host (used with port to construct URL) */
+    wsHost?: string;
+    /** WebSocket port (default: 3888) */
+    wsPort?: number;
+    /** WebSocket path (default: /ws) */
+    wsPath?: string;
+    /** Use secure WebSocket (wss://) */
+    wsSecure?: boolean;
+    /** Force a specific transport type */
+    forceTransport?: 'socket' | 'websocket';
+}
+/**
+ * Create a transport automatically based on environment and options.
+ *
+ * In browser environments, WebSocket transport is always used.
+ * In Node.js, Unix socket is preferred if socketPath is provided,
+ * otherwise WebSocket is used if wsUrl or wsHost is provided.
+ *
+ * @param options - Transport configuration options
+ * @returns Configured transport instance
+ *
+ * @example Browser usage
+ * ```typescript
+ * const transport = createAutoTransport({
+ *   wsUrl: 'wss://relay.example.com/ws'
+ * });
+ * ```
+ *
+ * @example Node.js with Unix socket
+ * ```typescript
+ * const transport = createAutoTransport({
+ *   socketPath: '/tmp/agent-relay.sock'
+ * });
+ * ```
+ *
+ * @example Node.js with WebSocket
+ * ```typescript
+ * const transport = createAutoTransport({
+ *   wsHost: 'localhost',
+ *   wsPort: 3888
+ * });
+ * ```
+ */
+export declare function createAutoTransport(options: AutoTransportOptions): Transport;
+/**
+ * Check if running in a browser environment.
+ */
+export declare function isBrowser(): boolean;
+/**
+ * Check if running in Node.js environment.
+ */
+export declare function isNode(): boolean;
+//# sourceMappingURL=index.d.ts.map

package/packages/sdk/dist/transports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transports/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,iCAAiC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,eAAe,CAcnD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,cAAc,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAoC5E;AAuBD;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC"}

package/packages/sdk/dist/transports/index.js

@@ -0,0 +1,129 @@
+/**
+ * Transport module for relay client communication.
+ * @agent-relay/sdk
+ *
+ * Provides transport abstraction and implementations:
+ * - SocketTransport: Unix/TCP sockets (Node.js only)
+ * - WebSocketTransport: WebSocket connections (Node.js and Browser)
+ *
+ * Auto-detection selects the appropriate transport based on environment.
+ */
+// Socket transport (Node.js)
+export { SocketTransport, createSocketTransport, } from './socket-transport.js';
+// WebSocket transport (Node.js and Browser)
+export { WebSocketTransport, createWebSocketTransport, socketPathToWsUrl, } from './websocket-transport.js';
+import { SocketTransport } from './socket-transport.js';
+import { WebSocketTransport, socketPathToWsUrl } from './websocket-transport.js';
+/**
+ * Detect the current runtime environment.
+ */
+export function detectEnvironment() {
+    const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
+    const isNode = typeof process !== 'undefined' &&
+        process.versions != null &&
+        process.versions.node != null;
+    const hasWebSocket = typeof WebSocket !== 'undefined' || isNode; // 'ws' can provide WebSocket in Node
+    const hasUnixSockets = isNode; // Only Node.js supports Unix sockets
+    return {
+        isBrowser,
+        isNode,
+        hasWebSocket,
+        hasUnixSockets,
+    };
+}
+/**
+ * Create a transport automatically based on environment and options.
+ *
+ * In browser environments, WebSocket transport is always used.
+ * In Node.js, Unix socket is preferred if socketPath is provided,
+ * otherwise WebSocket is used if wsUrl or wsHost is provided.
+ *
+ * @param options - Transport configuration options
+ * @returns Configured transport instance
+ *
+ * @example Browser usage
+ * ```typescript
+ * const transport = createAutoTransport({
+ *   wsUrl: 'wss://relay.example.com/ws'
+ * });
+ * ```
+ *
+ * @example Node.js with Unix socket
+ * ```typescript
+ * const transport = createAutoTransport({
+ *   socketPath: '/tmp/agent-relay.sock'
+ * });
+ * ```
+ *
+ * @example Node.js with WebSocket
+ * ```typescript
+ * const transport = createAutoTransport({
+ *   wsHost: 'localhost',
+ *   wsPort: 3888
+ * });
+ * ```
+ */
+export function createAutoTransport(options) {
+    const env = detectEnvironment();
+    const { forceTransport, ...config } = options;
+    // Forced transport type
+    if (forceTransport === 'websocket') {
+        return createWsTransportFromOptions(options);
+    }
+    if (forceTransport === 'socket') {
+        if (!options.socketPath) {
+            throw new Error('socketPath is required when forcing socket transport');
+        }
+        if (!env.hasUnixSockets) {
+            throw new Error('Unix sockets are not available in this environment');
+        }
+        return new SocketTransport({
+            socketPath: options.socketPath,
+            connectTimeout: config.connectTimeout,
+        });
+    }
+    // Auto-detect: Browser always uses WebSocket
+    if (env.isBrowser) {
+        return createWsTransportFromOptions(options);
+    }
+    // Node.js: prefer Unix socket if path is provided
+    if (env.isNode && options.socketPath) {
+        return new SocketTransport({
+            socketPath: options.socketPath,
+            connectTimeout: config.connectTimeout,
+        });
+    }
+    // Fall back to WebSocket
+    return createWsTransportFromOptions(options);
+}
+/**
+ * Create WebSocket transport from options.
+ */
+function createWsTransportFromOptions(options) {
+    let url = options.wsUrl;
+    if (!url) {
+        // Construct URL from components
+        const host = options.wsHost ?? 'localhost';
+        const port = options.wsPort ?? 3888;
+        const path = options.wsPath ?? '/ws';
+        const secure = options.wsSecure ?? false;
+        url = socketPathToWsUrl(host, port, path, secure);
+    }
+    return new WebSocketTransport({
+        url,
+        connectTimeout: options.connectTimeout,
+    });
+}
+/**
+ * Check if running in a browser environment.
+ */
+export function isBrowser() {
+    return detectEnvironment().isBrowser;
+}
+/**
+ * Check if running in Node.js environment.
+ */
+export function isNode() {
+    return detectEnvironment().isNode;
+}
+//# sourceMappingURL=index.js.map

package/packages/sdk/dist/transports/index.js.map

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

package/packages/sdk/dist/transports/socket-transport.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Unix/TCP Socket Transport for Node.js environments.
+ * @agent-relay/sdk
+ */
+import type { Transport, TransportConfig, TransportEvents, TransportState } from './types.js';
+export interface SocketTransportConfig extends TransportConfig {
+    /** Unix socket path or TCP host:port */
+    socketPath: string;
+}
+/**
+ * Socket-based transport for Unix sockets and TCP connections.
+ * This is the default transport for Node.js environments.
+ */
+export declare class SocketTransport implements Transport {
+    private socket?;
+    private config;
+    private events;
+    private _state;
+    constructor(config: SocketTransportConfig);
+    get state(): TransportState;
+    setEvents(events: TransportEvents): void;
+    connect(): Promise<void>;
+    disconnect(): void;
+    send(data: Uint8Array | Buffer): boolean;
+}
+/**
+ * Create a socket transport for Unix/TCP connections.
+ */
+export declare function createSocketTransport(socketPath: string, config?: TransportConfig): SocketTransport;
+//# sourceMappingURL=socket-transport.d.ts.map

package/packages/sdk/dist/transports/socket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-transport.d.ts","sourceRoot":"","sources":["../../src/transports/socket-transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9F,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAkC;gBAEpC,MAAM,EAAE,qBAAqB;IAOzC,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIxC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CxB,UAAU,IAAI,IAAI;IAWlB,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;CAczC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,eAAe,CAEnG"}

package/packages/sdk/dist/transports/socket-transport.js

@@ -0,0 +1,94 @@
+/**
+ * Unix/TCP Socket Transport for Node.js environments.
+ * @agent-relay/sdk
+ */
+import net from 'node:net';
+/**
+ * Socket-based transport for Unix sockets and TCP connections.
+ * This is the default transport for Node.js environments.
+ */
+export class SocketTransport {
+    socket;
+    config;
+    events = {};
+    _state = 'disconnected';
+    constructor(config) {
+        this.config = {
+            connectTimeout: 5000,
+            ...config,
+        };
+    }
+    get state() {
+        return this._state;
+    }
+    setEvents(events) {
+        this.events = events;
+    }
+    connect() {
+        if (this._state !== 'disconnected') {
+            return Promise.resolve();
+        }
+        return new Promise((resolve, reject) => {
+            this._state = 'connecting';
+            const timeout = setTimeout(() => {
+                if (this._state === 'connecting') {
+                    this.socket?.destroy();
+                    this._state = 'disconnected';
+                    reject(new Error('Connection timeout'));
+                }
+            }, this.config.connectTimeout);
+            this.socket = net.createConnection(this.config.socketPath, () => {
+                clearTimeout(timeout);
+                this._state = 'connected';
+                this.events.onConnect?.();
+                resolve();
+            });
+            this.socket.on('data', (data) => {
+                // Convert Buffer to Uint8Array for consistent interface
+                this.events.onData?.(new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
+            });
+            this.socket.on('close', () => {
+                this._state = 'disconnected';
+                this.events.onClose?.();
+            });
+            this.socket.on('error', (err) => {
+                clearTimeout(timeout);
+                if (this._state === 'connecting') {
+                    this._state = 'disconnected';
+                    reject(err);
+                }
+                this.events.onError?.(err);
+            });
+        });
+    }
+    disconnect() {
+        if (!this.socket || this._state === 'disconnected') {
+            return;
+        }
+        this._state = 'closing';
+        this.socket.end();
+        this.socket = undefined;
+        this._state = 'disconnected';
+    }
+    send(data) {
+        if (!this.socket || this._state !== 'connected') {
+            return false;
+        }
+        try {
+            // Ensure we're sending a Buffer
+            const buffer = data instanceof Buffer ? data : Buffer.from(data);
+            this.socket.write(buffer);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Create a socket transport for Unix/TCP connections.
+ */
+export function createSocketTransport(socketPath, config) {
+    return new SocketTransport({ socketPath, ...config });
+}
+//# sourceMappingURL=socket-transport.js.map

package/packages/sdk/dist/transports/socket-transport.js.map

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

package/packages/sdk/dist/transports/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Transport abstraction for relay client communication.
+ * @agent-relay/sdk
+ *
+ * Defines the interface for different transport implementations:
+ * - SocketTransport: Unix/TCP sockets (Node.js)
+ * - WebSocketTransport: WebSocket connections (Node.js and Browser)
+ */
+/**
+ * Transport connection state.
+ */
+export type TransportState = 'disconnected' | 'connecting' | 'connected' | 'closing';
+/**
+ * Transport event handlers.
+ */
+export interface TransportEvents {
+    /** Called when transport connects successfully */
+    onConnect?: () => void;
+    /** Called when transport receives data */
+    onData?: (data: Uint8Array) => void;
+    /** Called when transport disconnects */
+    onClose?: () => void;
+    /** Called when transport encounters an error */
+    onError?: (error: Error) => void;
+}
+/**
+ * Transport configuration options.
+ */
+export interface TransportConfig {
+    /** Connection timeout in milliseconds */
+    connectTimeout?: number;
+}
+/**
+ * Transport interface for relay client communication.
+ *
+ * Implementations must handle:
+ * - Connection lifecycle (connect, disconnect)
+ * - Binary data transmission
+ * - Event callbacks for state changes
+ */
+export interface Transport {
+    /** Current connection state */
+    readonly state: TransportState;
+    /**
+     * Connect to the relay endpoint.
+     * @throws Error if connection fails
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the relay.
+     */
+    disconnect(): void;
+    /**
+     * Send binary data to the relay.
+     * @param data - Data to send (Buffer or Uint8Array)
+     * @returns true if data was queued for sending
+     */
+    send(data: Uint8Array | Buffer): boolean;
+    /**
+     * Set event handlers.
+     * @param events - Event handler callbacks
+     */
+    setEvents(events: TransportEvents): void;
+}
+/**
+ * Transport factory function type.
+ */
+export type TransportFactory = (config?: TransportConfig) => Transport;
+//# sourceMappingURL=types.d.ts.map

package/packages/sdk/dist/transports/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transports/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IAEzC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,CAAC,EAAE,eAAe,KAAK,SAAS,CAAC"}

package/packages/sdk/dist/transports/types.js

@@ -0,0 +1,10 @@
+/**
+ * Transport abstraction for relay client communication.
+ * @agent-relay/sdk
+ *
+ * Defines the interface for different transport implementations:
+ * - SocketTransport: Unix/TCP sockets (Node.js)
+ * - WebSocketTransport: WebSocket connections (Node.js and Browser)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/sdk/dist/transports/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transports/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/packages/sdk/dist/transports/websocket-transport.d.ts

@@ -0,0 +1,55 @@
+/**
+ * WebSocket Transport for browser and Node.js environments.
+ * @agent-relay/sdk
+ *
+ * Uses native WebSocket in browsers and 'ws' package in Node.js.
+ * The transport expects the daemon to have a WebSocket endpoint (e.g., /ws).
+ */
+import type { Transport, TransportConfig, TransportEvents, TransportState } from './types.js';
+export interface WebSocketTransportConfig extends TransportConfig {
+    /** WebSocket URL (e.g., ws://localhost:3888/ws) */
+    url: string;
+    /** Protocols to use in WebSocket handshake */
+    protocols?: string | string[];
+}
+/**
+ * WebSocket-based transport for browser and Node.js.
+ *
+ * In browsers, uses native WebSocket.
+ * In Node.js, requires 'ws' package (optional dependency).
+ */
+export declare class WebSocketTransport implements Transport {
+    private ws?;
+    private config;
+    private events;
+    private _state;
+    private WebSocketImpl?;
+    constructor(config: WebSocketTransportConfig);
+    get state(): TransportState;
+    setEvents(events: TransportEvents): void;
+    /**
+     * Get WebSocket implementation (native or 'ws' package).
+     */
+    private getWebSocketImpl;
+    connect(): Promise<void>;
+    disconnect(): void;
+    send(data: Uint8Array | Buffer): boolean;
+}
+/**
+ * Create a WebSocket transport.
+ *
+ * @param url - WebSocket URL (e.g., ws://localhost:3888/ws)
+ * @param config - Additional configuration options
+ */
+export declare function createWebSocketTransport(url: string, config?: Omit<WebSocketTransportConfig, 'url'>): WebSocketTransport;
+/**
+ * Convert a socket path to WebSocket URL.
+ * Useful when daemon provides both Unix socket and WebSocket endpoints.
+ *
+ * @param host - Host address (default: localhost)
+ * @param port - Port number (default: 3888)
+ * @param path - WebSocket path (default: /ws)
+ * @param secure - Use wss:// instead of ws:// (default: false)
+ */
+export declare function socketPathToWsUrl(host?: string, port?: number, path?: string, secure?: boolean): string;
+//# sourceMappingURL=websocket-transport.d.ts.map

package/packages/sdk/dist/transports/websocket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.d.ts","sourceRoot":"","sources":["../../src/transports/websocket-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9F,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/B;AAiCD;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,EAAE,CAAC,CAAgB;IAC3B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,aAAa,CAAC,CAAuB;gBAEjC,MAAM,EAAE,wBAAwB;IAO5C,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIxC;;OAEG;YACW,gBAAgB;IA+BxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqE9B,UAAU,IAAI,IAAI;IAWlB,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;CAsBzC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,KAAK,CAAC,GAC7C,kBAAkB,CAEpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,SAAc,EAClB,IAAI,SAAO,EACX,IAAI,SAAQ,EACZ,MAAM,UAAQ,GACb,MAAM,CAGR"}