@agentick/client-multiplexer 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Agentick Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,168 @@
+# @agentick/client-multiplexer
+
+Multi-tab connection multiplexer for Agentick client. Reduces server connections by sharing a single SSE connection across all browser tabs.
+
+## Installation
+
+```bash
+npm install @agentick/client-multiplexer
+# or
+pnpm add @agentick/client-multiplexer
+```
+
+## Quick Start
+
+```typescript
+import { createClient } from '@agentick/client';
+import { createSharedTransport } from '@agentick/client-multiplexer';
+
+// Create client with shared transport
+const client = createClient({
+  baseUrl: '/api',
+  transport: createSharedTransport({ baseUrl: '/api', token: 'your-token' }),
+});
+
+// Use exactly like a regular client
+const session = client.session('main');
+session.subscribe();
+session.onEvent((event) => console.log(event));
+
+const handle = session.send('Hello!');
+await handle.result;
+```
+
+## How It Works
+
+The multiplexer uses browser tab leader election to ensure only one tab maintains the actual server connection:
+
+1. **Leader Election**: Uses Web Locks API (instant, reliable) with BroadcastChannel fallback for older browsers
+2. **Connection Sharing**: Only the leader tab opens the SSE connection to the server
+3. **Message Forwarding**: Follower tabs send requests via BroadcastChannel to the leader
+4. **Event Broadcasting**: Leader broadcasts server events to all tabs
+5. **Automatic Failover**: When leader tab closes, a new leader is elected and re-establishes subscriptions
+
+## Features
+
+- **Resource Efficient**: Single server connection regardless of tab count
+- **Transparent**: Works with existing Agentick client code
+- **Automatic Failover**: Seamless recovery when leader tab closes
+- **Subscription Aggregation**: Leader maintains union of all tabs' subscriptions
+- **Per-Tab Filtering**: Each tab only receives events for its own sessions
+
+## API
+
+### createSharedTransport(config)
+
+Creates a shared transport instance. Supports both SSE and WebSocket transports.
+
+```typescript
+import { createSharedTransport, type SharedTransportConfig } from '@agentick/client-multiplexer';
+
+// SSE transport (default for http:// URLs)
+const sseTransport = createSharedTransport({
+  baseUrl: 'https://api.example.com',
+  token: 'your-auth-token',      // Optional
+  timeout: 30000,                 // Optional
+  withCredentials: true,          // Optional
+});
+
+// WebSocket transport (default for ws:// URLs)
+const wsTransport = createSharedTransport({
+  baseUrl: 'wss://api.example.com',
+  token: 'your-auth-token',
+  clientId: 'my-client',          // Optional
+  reconnect: {                    // Optional
+    enabled: true,
+    maxAttempts: 5,
+    delay: 1000,
+  },
+});
+
+// Explicit transport selection
+const explicitTransport = createSharedTransport({
+  baseUrl: 'https://api.example.com',
+  transport: 'websocket',         // Force WebSocket even with http:// URL
+});
+```
+
+### SharedTransport
+
+The transport implements `ClientTransport` from `@agentick/client` plus additional properties:
+
+```typescript
+// Check leadership status
+transport.isLeader;  // boolean
+
+// Get unique tab identifier
+transport.tabId;     // string
+
+// Listen for leadership changes
+transport.onLeadershipChange((isLeader) => {
+  console.log(isLeader ? 'This tab is now the leader' : 'Leadership transferred');
+});
+```
+
+### Accessing Transport from Client
+
+```typescript
+import { createClient, type ClientTransport } from '@agentick/client';
+import { createSharedTransport, type SharedTransport } from '@agentick/client-multiplexer';
+
+const client = createClient({
+  baseUrl: '/api',
+  transport: createSharedTransport({ baseUrl: '/api' }),
+});
+
+// Access the transport for leadership info
+const transport = client.getTransport() as SharedTransport | undefined;
+console.log('Is leader:', transport?.isLeader);
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                          Browser Tabs                                │
+├──────────────────┬──────────────────┬──────────────────────────────┤
+│     Tab 1        │     Tab 2        │     Tab 3                    │
+│  (Leader)        │  (Follower)      │  (Follower)                  │
+│                  │                  │                              │
+│ SharedTransport  │ SharedTransport  │ SharedTransport              │
+│      │           │      │           │      │                       │
+│      │           │      │           │      │                       │
+│  ┌───▼───┐       │  ┌───▼───┐       │  ┌───▼───┐                   │
+│  │ SSE   │       │  │Bridge │       │  │Bridge │                   │
+│  │ Conn  │       │  │  Only │       │  │  Only │                   │
+│  └───┬───┘       │  └───┬───┘       │  └───┬───┘                   │
+│      │           │      │           │      │                       │
+└──────┼───────────┴──────┼───────────┴──────┼───────────────────────┘
+       │                  │                  │
+       │    ◄─────────────┴──────────────────┘
+       │         BroadcastChannel
+       │
+       ▼
+   ┌───────┐
+   │Server │
+   └───────┘
+```
+
+## Failover
+
+When the leader tab closes:
+
+1. Other tabs detect leadership vacancy (via Web Locks or heartbeat timeout)
+2. New leader is elected (fastest tab to acquire lock)
+3. New leader broadcasts `leader:ready` message
+4. Follower tabs respond with their current subscriptions
+5. New leader aggregates subscriptions and re-subscribes on the server
+6. Events flow again to all tabs
+
+## Browser Support
+
+- **Web Locks API**: Chrome 69+, Firefox 96+, Safari 15.4+, Edge 79+
+- **BroadcastChannel**: All modern browsers
+- **Fallback**: Heartbeat-based election for browsers without Web Locks
+
+## License
+
+ISC

package/dist/broadcast-bridge.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Broadcast Bridge
+ *
+ * Handles inter-tab communication via BroadcastChannel.
+ * Used for forwarding requests from followers to leader and events back.
+ */
+import type { TransportEventData } from "@agentick/client";
+import type { SendInput, ChannelEvent, ToolConfirmationResponse } from "@agentick/client";
+export type BridgeMessage = {
+    type: "leader:collecting_subscriptions";
+    tabId: string;
+} | {
+    type: "leader:transport_ready";
+    tabId: string;
+} | {
+    type: "ping:leader";
+    tabId: string;
+} | {
+    type: "pong:leader";
+    tabId: string;
+} | {
+    type: "subscriptions:announce";
+    tabId: string;
+    sessions: string[];
+    channels: string[];
+} | {
+    type: "request:send";
+    requestId: string;
+    tabId: string;
+    sessionId: string;
+    input: SendInput;
+} | {
+    type: "request:subscribe";
+    requestId: string;
+    tabId: string;
+    sessionId: string;
+} | {
+    type: "request:unsubscribe";
+    requestId: string;
+    tabId: string;
+    sessionId: string;
+} | {
+    type: "request:abort";
+    requestId: string;
+    tabId: string;
+    sessionId: string;
+    reason?: string;
+} | {
+    type: "request:close";
+    requestId: string;
+    tabId: string;
+    sessionId: string;
+} | {
+    type: "request:toolResult";
+    requestId: string;
+    tabId: string;
+    sessionId: string;
+    toolUseId: string;
+    result: ToolConfirmationResponse;
+} | {
+    type: "request:channelSubscribe";
+    requestId: string;
+    tabId: string;
+    sessionId: string;
+    channel: string;
+} | {
+    type: "request:channelPublish";
+    requestId: string;
+    tabId: string;
+    sessionId: string;
+    channel: string;
+    event: ChannelEvent;
+} | {
+    type: "response";
+    requestId: string;
+    ok: true;
+    result?: unknown;
+} | {
+    type: "response";
+    requestId: string;
+    ok: false;
+    error: string;
+} | {
+    type: "event";
+    event: TransportEventData;
+} | {
+    type: "stream:event";
+    requestId: string;
+    event: TransportEventData;
+} | {
+    type: "stream:end";
+    requestId: string;
+} | {
+    type: "stream:error";
+    requestId: string;
+    error: string;
+};
+export type MessageHandler = (message: BridgeMessage) => void;
+export interface BroadcastBridge {
+    readonly tabId: string;
+    /** Send a message to all tabs */
+    broadcast(message: BridgeMessage): void;
+    /** Register handler for incoming messages */
+    onMessage(handler: MessageHandler): () => void;
+    /**
+     * Collect responses from all tabs within a timeout.
+     * Useful for gathering subscription announcements during failover.
+     */
+    collectResponses<T extends BridgeMessage>(messageType: T["type"], timeout: number): Promise<T[]>;
+    /** Close the bridge */
+    close(): void;
+}
+export declare function createBroadcastBridge(channelName: string, tabId: string): BroadcastBridge;
+export declare function generateRequestId(tabId: string): string;
+//# sourceMappingURL=broadcast-bridge.d.ts.map

package/dist/broadcast-bridge.d.ts.map

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

package/dist/broadcast-bridge.js

@@ -0,0 +1,59 @@
+/**
+ * Broadcast Bridge
+ *
+ * Handles inter-tab communication via BroadcastChannel.
+ * Used for forwarding requests from followers to leader and events back.
+ */
+export function createBroadcastBridge(channelName, tabId) {
+    const channel = new BroadcastChannel(`agentick:bridge:${channelName}`);
+    const handlers = new Set();
+    channel.onmessage = (event) => {
+        const message = event.data;
+        for (const handler of handlers) {
+            try {
+                handler(message);
+            }
+            catch (e) {
+                console.error("Error in bridge message handler:", e);
+            }
+        }
+    };
+    return {
+        get tabId() {
+            return tabId;
+        },
+        broadcast(message) {
+            channel.postMessage(message);
+        },
+        onMessage(handler) {
+            handlers.add(handler);
+            return () => handlers.delete(handler);
+        },
+        collectResponses(messageType, timeout) {
+            return new Promise((resolve) => {
+                const responses = [];
+                const cleanup = this.onMessage((msg) => {
+                    if (msg.type === messageType) {
+                        responses.push(msg);
+                    }
+                });
+                setTimeout(() => {
+                    cleanup();
+                    resolve(responses);
+                }, timeout);
+            });
+        },
+        close() {
+            channel.close();
+            handlers.clear();
+        },
+    };
+}
+// ============================================================================
+// Request Helper
+// ============================================================================
+let requestIdCounter = 0;
+export function generateRequestId(tabId) {
+    return `${tabId}-${++requestIdCounter}`;
+}
+//# sourceMappingURL=broadcast-bridge.js.map

package/dist/broadcast-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast-bridge.js","sourceRoot":"","sources":["../src/broadcast-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoFH,MAAM,UAAU,qBAAqB,CAAC,WAAmB,EAAE,KAAa;IACtE,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,mBAAmB,WAAW,EAAE,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,OAAO,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAqB,CAAC;QAC5C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,OAAO,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,CAAC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,KAAK;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QAED,SAAS,CAAC,OAAsB;YAC9B,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAED,SAAS,CAAC,OAAuB;YAC/B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QAED,gBAAgB,CACd,WAAsB,EACtB,OAAe;YAEf,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,MAAM,SAAS,GAAQ,EAAE,CAAC;gBAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;oBACrC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;wBAC7B,SAAS,CAAC,IAAI,CAAC,GAAQ,CAAC,CAAC;oBAC3B,CAAC;gBACH,CAAC,CAAC,CAAC;gBAEH,UAAU,CAAC,GAAG,EAAE;oBACd,OAAO,EAAE,CAAC;oBACV,OAAO,CAAC,SAAS,CAAC,CAAC;gBACrB,CAAC,EAAE,OAAO,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK;YACH,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,IAAI,gBAAgB,GAAG,CAAC,CAAC;AAEzB,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,GAAG,KAAK,IAAI,EAAE,gBAAgB,EAAE,CAAC;AAC1C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @agentick/client-multiplexer
+ *
+ * Multi-tab connection multiplexer for Agentick client.
+ *
+ * Reduces server connections by electing a leader tab that maintains
+ * the SSE connection while other tabs communicate via BroadcastChannel.
+ *
+ * Features:
+ * - Leader election using Web Locks API (instant, reliable)
+ * - BroadcastChannel fallback for older browsers
+ * - Automatic failover when leader tab closes
+ * - Per-tab subscription filtering (each tab only receives its events)
+ * - Subscription aggregation (leader subscribes to union of all tabs' sessions)
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@agentick/client';
+ * import { createSharedTransport } from '@agentick/client-multiplexer';
+ *
+ * // Create client with shared transport
+ * const client = createClient({
+ *   baseUrl: '/api',
+ *   transport: createSharedTransport({ baseUrl: '/api', token: 'your-token' }),
+ * });
+ *
+ * // Use exactly like a regular client
+ * const session = client.session('main');
+ * session.subscribe(); // Subscribe to events
+ * session.onEvent((event) => console.log(event));
+ *
+ * // Send a message
+ * const handle = session.send('Hello!');
+ * await handle.result;
+ *
+ * // Check leadership status (optional, for debugging/UI)
+ * const transport = client.getTransport() as SharedTransport | undefined;
+ * console.log('Is leader:', transport?.isLeader);
+ * ```
+ */
+export { SharedTransport, createSharedTransport, type SharedTransportConfig, } from "./shared-transport.js";
+export { createLeaderElector, type LeaderElector } from "./leader-elector.js";
+export { createBroadcastBridge, type BroadcastBridge, type BridgeMessage, } from "./broadcast-bridge.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * @agentick/client-multiplexer
+ *
+ * Multi-tab connection multiplexer for Agentick client.
+ *
+ * Reduces server connections by electing a leader tab that maintains
+ * the SSE connection while other tabs communicate via BroadcastChannel.
+ *
+ * Features:
+ * - Leader election using Web Locks API (instant, reliable)
+ * - BroadcastChannel fallback for older browsers
+ * - Automatic failover when leader tab closes
+ * - Per-tab subscription filtering (each tab only receives its events)
+ * - Subscription aggregation (leader subscribes to union of all tabs' sessions)
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@agentick/client';
+ * import { createSharedTransport } from '@agentick/client-multiplexer';
+ *
+ * // Create client with shared transport
+ * const client = createClient({
+ *   baseUrl: '/api',
+ *   transport: createSharedTransport({ baseUrl: '/api', token: 'your-token' }),
+ * });
+ *
+ * // Use exactly like a regular client
+ * const session = client.session('main');
+ * session.subscribe(); // Subscribe to events
+ * session.onEvent((event) => console.log(event));
+ *
+ * // Send a message
+ * const handle = session.send('Hello!');
+ * await handle.result;
+ *
+ * // Check leadership status (optional, for debugging/UI)
+ * const transport = client.getTransport() as SharedTransport | undefined;
+ * console.log('Is leader:', transport?.isLeader);
+ * ```
+ */
+export { SharedTransport, createSharedTransport, } from "./shared-transport.js";
+export { createLeaderElector } from "./leader-elector.js";
+export { createBroadcastBridge, } from "./broadcast-bridge.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAsB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,qBAAqB,GAGtB,MAAM,uBAAuB,CAAC"}

package/dist/leader-elector.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Leader Elector
+ *
+ * Uses Web Locks API for instant, reliable leader election across browser tabs.
+ * Falls back to BroadcastChannel-based election if Web Locks unavailable.
+ */
+export interface LeaderElector {
+    readonly isLeader: boolean;
+    readonly tabId: string;
+    awaitLeadership(): Promise<void>;
+    resign(): void;
+    onLeadershipChange(callback: (isLeader: boolean) => void): () => void;
+}
+/**
+ * Create a leader elector for the given channel name.
+ * Uses Web Locks API (instant) with BroadcastChannel fallback.
+ */
+export declare function createLeaderElector(channelName: string): LeaderElector;
+//# sourceMappingURL=leader-elector.d.ts.map

package/dist/leader-elector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leader-elector.d.ts","sourceRoot":"","sources":["../src/leader-elector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,IAAI,CAAC;IACf,kBAAkB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACvE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAqNtE"}