@agentuity/react 1.0.1 → 1.0.2

package/dist/webrtc.js

@@ -0,0 +1,301 @@
+import { useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { WebRTCManager, buildUrl, } from '@agentuity/frontend';
+import { AgentuityContext } from './context';
+/**
+ * React hook for WebRTC peer-to-peer audio/video/data calls.
+ *
+ * Supports multi-peer mesh networking, screen sharing, recording, and stats.
+ *
+ * @example
+ * ```tsx
+ * function VideoCall({ roomId }: { roomId: string }) {
+ *   const {
+ *     localVideoRef,
+ *     state,
+ *     remotePeerIds,
+ *     remoteStreams,
+ *     hangup,
+ *     muteAudio,
+ *     isAudioMuted,
+ *     startScreenShare,
+ *   } = useWebRTCCall({
+ *     roomId,
+ *     signalUrl: '/call/signal',
+ *     callbacks: {
+ *       onStateChange: (from, to, reason) => console.log(`${from} → ${to}`, reason),
+ *       onRemoteStream: (peerId, stream) => console.log(`Got stream from ${peerId}`),
+ *     },
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <video ref={localVideoRef} autoPlay muted playsInline />
+ *       {remotePeerIds.map((peerId) => (
+ *         <RemoteVideo key={peerId} stream={remoteStreams.get(peerId)} />
+ *       ))}
+ *       <p>State: {state}</p>
+ *       <button onClick={() => muteAudio(!isAudioMuted)}>
+ *         {isAudioMuted ? 'Unmute' : 'Mute'}
+ *       </button>
+ *       <button onClick={hangup}>Hang Up</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useWebRTCCall(options) {
+    const context = useContext(AgentuityContext);
+    const managerRef = useRef(null);
+    const localVideoRef = useRef(null);
+    const [state, setState] = useState('idle');
+    const [error, setError] = useState(null);
+    const [peerId, setPeerId] = useState(null);
+    const [remotePeerIds, setRemotePeerIds] = useState([]);
+    const [remoteStreams, setRemoteStreams] = useState(new Map());
+    const [isAudioMuted, setIsAudioMuted] = useState(false);
+    const [isVideoMuted, setIsVideoMuted] = useState(false);
+    const [isScreenSharing, setIsScreenSharing] = useState(false);
+    const userCallbacksRef = useRef(options.callbacks);
+    userCallbacksRef.current = options.callbacks;
+    const signalUrl = useMemo(() => {
+        if (options.signalUrl.startsWith('ws://') || options.signalUrl.startsWith('wss://')) {
+            return options.signalUrl;
+        }
+        const base = context?.baseUrl ?? window.location.origin;
+        const wsBase = base.replace(/^http(s?):/, 'ws$1:');
+        return buildUrl(wsBase, options.signalUrl);
+    }, [context?.baseUrl, options.signalUrl]);
+    const managerOptions = useMemo(() => {
+        return {
+            signalUrl,
+            roomId: options.roomId,
+            polite: options.polite,
+            iceServers: options.iceServers,
+            media: options.media,
+            dataChannels: options.dataChannels,
+            autoReconnect: options.autoReconnect,
+            maxReconnectAttempts: options.maxReconnectAttempts,
+            connectionTimeout: options.connectionTimeout,
+            iceGatheringTimeout: options.iceGatheringTimeout,
+            callbacks: {
+                onStateChange: (from, to, reason) => {
+                    setState(to);
+                    if (managerRef.current) {
+                        const managerState = managerRef.current.getState();
+                        setPeerId(managerState.peerId);
+                        setRemotePeerIds(managerState.remotePeerIds);
+                        setIsScreenSharing(managerState.isScreenSharing);
+                    }
+                    userCallbacksRef.current?.onStateChange?.(from, to, reason);
+                },
+                onConnect: () => {
+                    userCallbacksRef.current?.onConnect?.();
+                },
+                onDisconnect: (reason) => {
+                    userCallbacksRef.current?.onDisconnect?.(reason);
+                },
+                onLocalStream: (stream) => {
+                    if (localVideoRef.current) {
+                        localVideoRef.current.srcObject = stream;
+                    }
+                    userCallbacksRef.current?.onLocalStream?.(stream);
+                },
+                onRemoteStream: (remotePeerId, stream) => {
+                    setRemoteStreams((prev) => {
+                        const next = new Map(prev);
+                        next.set(remotePeerId, stream);
+                        return next;
+                    });
+                    userCallbacksRef.current?.onRemoteStream?.(remotePeerId, stream);
+                },
+                onTrackAdded: (remotePeerId, track, stream) => {
+                    userCallbacksRef.current?.onTrackAdded?.(remotePeerId, track, stream);
+                },
+                onTrackRemoved: (remotePeerId, track) => {
+                    userCallbacksRef.current?.onTrackRemoved?.(remotePeerId, track);
+                },
+                onPeerJoined: (id) => {
+                    setRemotePeerIds((prev) => (prev.includes(id) ? prev : [...prev, id]));
+                    userCallbacksRef.current?.onPeerJoined?.(id);
+                },
+                onPeerLeft: (id) => {
+                    setRemotePeerIds((prev) => prev.filter((p) => p !== id));
+                    setRemoteStreams((prev) => {
+                        const next = new Map(prev);
+                        next.delete(id);
+                        return next;
+                    });
+                    userCallbacksRef.current?.onPeerLeft?.(id);
+                },
+                onNegotiationStart: (remotePeerId) => {
+                    userCallbacksRef.current?.onNegotiationStart?.(remotePeerId);
+                },
+                onNegotiationComplete: (remotePeerId) => {
+                    userCallbacksRef.current?.onNegotiationComplete?.(remotePeerId);
+                },
+                onIceCandidate: (remotePeerId, candidate) => {
+                    userCallbacksRef.current?.onIceCandidate?.(remotePeerId, candidate);
+                },
+                onIceStateChange: (remotePeerId, iceState) => {
+                    userCallbacksRef.current?.onIceStateChange?.(remotePeerId, iceState);
+                },
+                onError: (err, currentState) => {
+                    setError(err);
+                    userCallbacksRef.current?.onError?.(err, currentState);
+                },
+                onDataChannelOpen: (remotePeerId, label) => {
+                    userCallbacksRef.current?.onDataChannelOpen?.(remotePeerId, label);
+                },
+                onDataChannelClose: (remotePeerId, label) => {
+                    userCallbacksRef.current?.onDataChannelClose?.(remotePeerId, label);
+                },
+                onDataChannelMessage: (remotePeerId, label, data) => {
+                    userCallbacksRef.current?.onDataChannelMessage?.(remotePeerId, label, data);
+                },
+                onDataChannelError: (remotePeerId, label, err) => {
+                    userCallbacksRef.current?.onDataChannelError?.(remotePeerId, label, err);
+                },
+                onScreenShareStart: () => {
+                    setIsScreenSharing(true);
+                    userCallbacksRef.current?.onScreenShareStart?.();
+                },
+                onScreenShareStop: () => {
+                    setIsScreenSharing(false);
+                    userCallbacksRef.current?.onScreenShareStop?.();
+                },
+                onReconnecting: (attempt) => {
+                    userCallbacksRef.current?.onReconnecting?.(attempt);
+                },
+                onReconnected: () => {
+                    userCallbacksRef.current?.onReconnected?.();
+                },
+                onReconnectFailed: () => {
+                    userCallbacksRef.current?.onReconnectFailed?.();
+                },
+            },
+        };
+    }, [
+        signalUrl,
+        options.roomId,
+        options.polite,
+        options.iceServers,
+        options.media,
+        options.dataChannels,
+        options.autoReconnect,
+        options.maxReconnectAttempts,
+        options.connectionTimeout,
+        options.iceGatheringTimeout,
+    ]);
+    useEffect(() => {
+        const manager = new WebRTCManager(managerOptions);
+        managerRef.current = manager;
+        if (options.autoConnect !== false) {
+            manager.connect();
+        }
+        return () => {
+            manager.dispose();
+            managerRef.current = null;
+        };
+    }, [managerOptions, options.autoConnect]);
+    const connect = useCallback(() => {
+        managerRef.current?.connect();
+    }, []);
+    const hangup = useCallback(() => {
+        managerRef.current?.hangup();
+        setRemotePeerIds([]);
+        setRemoteStreams(new Map());
+    }, []);
+    const muteAudio = useCallback((muted) => {
+        managerRef.current?.muteAudio(muted);
+        setIsAudioMuted(muted);
+    }, []);
+    const muteVideo = useCallback((muted) => {
+        managerRef.current?.muteVideo(muted);
+        setIsVideoMuted(muted);
+    }, []);
+    const startScreenShare = useCallback(async (opts) => {
+        await managerRef.current?.startScreenShare(opts);
+    }, []);
+    const stopScreenShare = useCallback(async () => {
+        await managerRef.current?.stopScreenShare();
+    }, []);
+    const createDataChannel = useCallback((config) => {
+        return managerRef.current?.createDataChannel(config) ?? new Map();
+    }, []);
+    const getDataChannelLabels = useCallback(() => {
+        return managerRef.current?.getDataChannelLabels() ?? [];
+    }, []);
+    const getDataChannelState = useCallback((remotePeerId, label) => {
+        return managerRef.current?.getDataChannelState(remotePeerId, label) ?? null;
+    }, []);
+    const sendString = useCallback((label, data) => {
+        return managerRef.current?.sendString(label, data) ?? false;
+    }, []);
+    const sendStringTo = useCallback((remotePeerId, label, data) => {
+        return managerRef.current?.sendStringTo(remotePeerId, label, data) ?? false;
+    }, []);
+    const sendBinary = useCallback((label, data) => {
+        return managerRef.current?.sendBinary(label, data) ?? false;
+    }, []);
+    const sendBinaryTo = useCallback((remotePeerId, label, data) => {
+        return managerRef.current?.sendBinaryTo(remotePeerId, label, data) ?? false;
+    }, []);
+    const sendJSON = useCallback((label, data) => {
+        return managerRef.current?.sendJSON(label, data) ?? false;
+    }, []);
+    const sendJSONTo = useCallback((remotePeerId, label, data) => {
+        return managerRef.current?.sendJSONTo(remotePeerId, label, data) ?? false;
+    }, []);
+    const closeDataChannel = useCallback((label) => {
+        return managerRef.current?.closeDataChannel(label) ?? false;
+    }, []);
+    const getQualitySummary = useCallback(async (remotePeerId) => {
+        return managerRef.current?.getQualitySummary(remotePeerId) ?? null;
+    }, []);
+    const getAllQualitySummaries = useCallback(async () => {
+        return managerRef.current?.getAllQualitySummaries() ?? new Map();
+    }, []);
+    const startRecording = useCallback((streamId, opts) => {
+        return managerRef.current?.startRecording(streamId, opts) ?? null;
+    }, []);
+    const isRecordingFn = useCallback((streamId) => {
+        return managerRef.current?.isRecording(streamId) ?? false;
+    }, []);
+    const stopAllRecordings = useCallback(async () => {
+        return managerRef.current?.stopAllRecordings() ?? new Map();
+    }, []);
+    return {
+        localVideoRef,
+        state,
+        error,
+        peerId,
+        remotePeerIds,
+        remoteStreams,
+        isAudioMuted,
+        isVideoMuted,
+        isDataOnly: options.media === false,
+        isScreenSharing,
+        connect,
+        hangup,
+        muteAudio,
+        muteVideo,
+        startScreenShare,
+        stopScreenShare,
+        createDataChannel,
+        getDataChannelLabels,
+        getDataChannelState,
+        sendString,
+        sendStringTo,
+        sendBinary,
+        sendBinaryTo,
+        sendJSON,
+        sendJSONTo,
+        closeDataChannel,
+        getQualitySummary,
+        getAllQualitySummaries,
+        startRecording,
+        isRecording: isRecordingFn,
+        stopAllRecordings,
+    };
+}
+//# sourceMappingURL=webrtc.js.map

package/dist/webrtc.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/react",
-	"version": "1.0.1",
+	"version": "1.0.2",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -34,12 +34,12 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "1.0.1",
-		"@agentuity/frontend": "1.0.1"
+		"@agentuity/core": "1.0.2",
+		"@agentuity/frontend": "1.0.2"
 	},
 	"devDependencies": {
-		"@agentuity/schema": "1.0.1",
-		"@agentuity/test-utils": "1.0.1",
+		"@agentuity/schema": "1.0.2",
+		"@agentuity/test-utils": "1.0.2",
 		"@types/bun": "latest",
 		"bun-types": "latest",
 		"typescript": "^5.9.0"

package/src/eventstream.ts

@@ -49,6 +49,9 @@ export interface EventStreamOptions {
  * the SSERouteRegistry generated from your routes.
  *
  * @template TRoute - SSE route key from SSERouteRegistry (e.g., '/events', '/notifications')
+ * @template TOutput - Optional type override for SSE event data. When provided, this type
+ *   is used instead of the inferred type from the route registry. This is useful for SSE
+ *   routes where outputSchema is `never` in the generated types.
  *
  * @example Simple SSE connection
  * ```typescript
@@ -63,14 +66,29 @@ export interface EventStreamOptions {
  *   query: new URLSearchParams({ userId: '123' })
  * });
  * ```
+ *
+ * @example SSE with custom output type (when registry has outputSchema: never)
+ * ```typescript
+ * interface StreamMessage {
+ *   type: 'token' | 'complete';
+ *   content?: string;
+ * }
+ *
+ * const { isConnected, data } = useEventStream<'/api/search', StreamMessage>('/api/search');
+ *
+ * // data is typed as StreamMessage | undefined
+ * if (data?.type === 'token') {
+ *   console.log(data.content);
+ * }
+ * ```
  */
-export function useEventStream<TRoute extends SSERouteKey>(
+export function useEventStream<TRoute extends SSERouteKey, TOutput = SSERouteOutput<TRoute>>(
 	route: TRoute,
 	options?: EventStreamOptions
 ): {
 	isConnected: boolean;
 	close: () => void;
-	data?: SSERouteOutput<TRoute>;
+	data?: TOutput;
 	error: Error | null;
 	isError: boolean;
 	reset: () => void;
@@ -82,23 +100,28 @@ export function useEventStream<TRoute extends SSERouteKey>(
 		throw new Error('useEventStream must be used within a AgentuityProvider');
 	}
 
-	const managerRef = useRef<EventStreamManager<SSERouteOutput<TRoute>> | null>(null);
+	const managerRef = useRef<EventStreamManager<TOutput> | null>(null);
 
-	const [data, setData] = useState<SSERouteOutput<TRoute>>();
+	const [data, setData] = useState<TOutput>();
 	const [error, setError] = useState<Error | null>(null);
 	const [isError, setIsError] = useState(false);
 	const [isConnected, setIsConnected] = useState(false);
 	const [readyState, setReadyState] = useState<number>(2); // EventSource.CLOSED = 2
 
 	// Build EventStream URL
+	// Track both query object and its string representation to detect mutations.
+	// URLSearchParams can be mutated in-place without changing object identity,
+	// so we compare the string value to trigger recomputation when params change.
+	const queryString = options?.query?.toString();
 	const esUrl = useMemo(
 		() => buildUrl(context.baseUrl!, route as string, options?.subpath, options?.query),
-		[context.baseUrl, route, options?.subpath, options?.query?.toString()]
+		// biome-ignore lint/correctness/useExhaustiveDependencies: queryString tracks URLSearchParams mutations that options?.query reference wouldn't catch
+		[context.baseUrl, route, options?.subpath, options?.query, queryString]
 	);
 
 	// Initialize manager and connect
 	useEffect(() => {
-		const manager = new EventStreamManager<SSERouteOutput<TRoute>>({
+		const manager = new EventStreamManager<TOutput>({
 			url: esUrl,
 			callbacks: {
 				onConnect: () => {

package/src/index.ts

@@ -29,6 +29,13 @@ export {
 	type SSERouteOutput,
 	type EventStreamOptions,
 } from './eventstream';
+export {
+	useWebRTCCall,
+	type UseWebRTCCallOptions,
+	type UseWebRTCCallResult,
+	type WebRTCConnectionState,
+	type WebRTCClientCallbacks,
+} from './webrtc';
 export {
 	useAPI,
 	type RouteKey,
@@ -82,6 +89,13 @@ export {
 	type EventStreamCallbacks,
 	type EventStreamManagerOptions,
 	type EventStreamManagerState,
+	WebRTCManager,
+	UserMediaSource,
+	DisplayMediaSource,
+	CustomStreamSource,
+	type WebRTCManagerOptions,
+	type WebRTCManagerState,
+	type WebRTCDisconnectReason,
 	// Client type exports (createClient is exported from ./client.ts)
 	type Client,
 	type ClientOptions,