@agentuity/react 1.0.0 → 1.0.2

package/AGENTS.md

@@ -2,109 +2,112 @@
 
 ## Package Overview
 
-React hooks and components for building Agentuity web applications. Provides type-safe hooks for calling agents and WebSocket communication.
+React hooks for building Agentuity web applications. Provides type-safe hooks for API calls, WebSocket, Server-Sent Events, and analytics.
 
 ## Commands
 
-- **Build**: `bun run build` (compiles for browser target)
-- **Typecheck**: `bun run typecheck` (runs TypeScript type checking)
-- **Clean**: `bun run clean` (removes dist/)
+- **Build**: `bun run build`
+- **Typecheck**: `bun run typecheck`
+- **Clean**: `bun run clean`
 
 ## Architecture
 
-- **Runtime**: Browser only (uses browser APIs like fetch, WebSocket)
-- **Build target**: Browser with ESNext
-- **Dependencies**: Requires `@agentuity/core` (workspace dependency)
+- **Runtime**: Browser only
+- **Dependencies**: `@agentuity/core`, `@agentuity/frontend`
 - **Peer dependencies**: React 18+ or 19+
 
 ## Structure
 
 ```text
 src/
-├── index.ts        # Main entry point
-├── context.tsx     # AgentuityProvider and AgentuityContext
-├── run.ts          # useAgent hook for HTTP calls
-├── websocket.ts    # useWebsocket hook for WebSocket
-├── types.ts        # Type definitions for agent registry
-├── url.ts          # URL building utilities
-└── env.ts          # Environment helpers
+├── index.ts        # Main exports (client-side)
+├── server.ts       # Server-side entry point (SSR, server components, API routes)
+├── context.tsx     # AgentuityProvider, useAgentuity, useAuth
+├── api.ts          # useAPI hook
+├── websocket.ts    # useWebsocket hook
+├── eventstream.ts  # useEventStream hook
+├── client.ts       # createClient, createAPIClient
+├── analytics.tsx   # useAnalytics, useTrackOnMount, withPageTracking
+└── memo.ts         # useJsonMemo
 ```
 
-## Code Style
+**Entry points:**
 
-- **React hooks** - Follow React hooks conventions
-- **TypeScript generics** - Heavy use of generics for type safety
-- **Functional components** - All components are functional
-- **Context API** - Use React Context for configuration
-- **Error boundaries** - Throw errors that can be caught by error boundaries
+- `@agentuity/react` - Client-side hooks (browser only)
+- `@agentuity/react/server` - Server-safe exports (SSR, server components)
 
-## Important Conventions
+## Code Conventions
 
 - **Provider required** - All hooks must be used within `AgentuityProvider`
-- **Type inference** - Agent types are inferred from generated types (AgentRegistry)
-- **Base URL** - Defaults to current origin if not provided
-- **WebSocket protocol** - Auto-converts http:// to ws:// and https:// to wss://
-- **Serialization** - Automatically handles JSON serialization/deserialization
+- **Type inference** - Types inferred from generated registries (RouteRegistry, etc.)
+- **SSR safe** - All hooks include SSR guards
 
 ## Hooks API
 
-### useAuth
+### useAPI (main HTTP hook)
 
 ```typescript
-const { isAuthenticated, authLoading, authHeader } = useAuth();
+// GET auto-executes, returns refetch()
+const { data, isLoading, error, refetch } = useAPI('GET /users');
+
+// POST/PUT/PATCH/DELETE manual via invoke()
+const { data, invoke } = useAPI('POST /users');
+await invoke({ name: 'Alice' });
 ```
 
-- Provides auth state for conditional rendering
-- `authHeader` is automatically injected into agent/API calls
-- Works with `@agentuity/auth`'s `AuthProvider`
+Returns: `{ data, error, isLoading, isSuccess, isError, isFetching, reset, refetch|invoke }`
 
-### useAgent
+### useWebsocket
 
 ```typescript
-const { data, run } = useAgent('agentName');
+const { isConnected, data, messages, send, close, clearMessages } = useWebsocket('/ws');
+send({ message: 'Hello' });
 ```
 
-- Returns last response in `data`
-- `run()` function for calling the agent
-- Supports custom headers, query params, subpaths
-- **Auth tokens auto-injected** when `AuthProvider` is in tree
+- `data` = latest message, `messages` = all messages
+- Auto-reconnection on connection loss
 
-### useWebsocket
+### useEventStream (SSE)
 
 ```typescript
-const { connected, send, setHandler, close } = useWebsocket('/path');
+const { isConnected, data, close, error, isError, reset, readyState } = useEventStream('/events');
 ```
 
 - Auto-reconnection on connection loss
-- Message queuing when disconnected
-- Type-safe message handlers
-- **Auth tokens auto-injected** when `AuthProvider` is in tree
+- `data` = latest event (with JSON memoization)
 
-## Generated Types
+### useAuth
 
-This package expects a `AgentRegistry` type to be augmented by generated code:
+```typescript
+const { isAuthenticated, authHeader, setAuthHeader, authLoading } = useAuth();
+```
+
+### useAnalytics
+
+```typescript
+const { track, trackClick, identify } = useAnalytics();
+track('event_name', { prop: 'value' });
+```
+
+### Other Hooks
+
+- `useAgentuity()` - Access baseUrl
+- `useTrackOnMount(options)` - Track event on mount
+- `useJsonMemo(value)` - Deep equality memoization
+- `withPageTracking(Component, pageName)` - HOC for page tracking
+
+## Client Functions
 
 ```typescript
-// Generated by bundler
-export interface AgentRegistry {
-  'my-agent': {
-    inputSchema: z.ZodObject<...>;
-    outputSchema: z.ZodObject<...>;
-  };
-}
+const api = createAPIClient();
+await api.hello.post({ name: 'World' });
 ```
 
-## Testing
+## Generated Types
 
-- Test with React Testing Library
-- Mock fetch and WebSocket APIs
-- Test error boundaries
-- Test with and without provider
-- When running tests, prefer using a subagent (Task tool) to avoid context bloat from test output
+Route registries are augmented via `declare module '@agentuity/frontend'`. See `@agentuity/frontend` for registry interfaces.
 
-## Publishing Checklist
+## Publishing
 
-1. Run `bun run build` to compile for browser
-2. Verify `dist/` contains browser-compatible code (no Node.js APIs)
-3. Ensure peer dependencies are correctly specified
-4. Must publish **after** @agentuity/core
+1. Run `bun run build`
+2. Must publish **after** @agentuity/core and @agentuity/frontend

package/README.md

@@ -92,6 +92,58 @@ function ChatComponent() {
 }
 ```
 
+### 4. WebRTC Communication
+
+For peer-to-peer video/audio calls and data channels:
+
+```tsx
+import { useWebRTCCall } from '@agentuity/react';
+
+function VideoChat() {
+	const {
+		state,
+		localVideoRef,
+		remoteStreams,
+		remotePeerIds,
+		connect,
+		hangup,
+		muteAudio,
+		muteVideo,
+		sendJSON,
+		isAudioMuted,
+		isVideoMuted,
+	} = useWebRTCCall({
+		roomId: 'my-room',
+		signalUrl: '/api/webrtc/signal',
+		media: { video: true, audio: true },
+		dataChannels: [{ label: 'chat' }],
+	});
+
+	return (
+		<div>
+			<div>Status: {state}</div>
+			<video ref={localVideoRef} autoPlay muted playsInline />
+			{remotePeerIds.map((peerId) => (
+				<video
+					key={peerId}
+					ref={(el) => el && (el.srcObject = remoteStreams.get(peerId) || null)}
+					autoPlay
+					playsInline
+				/>
+			))}
+			<button onClick={connect}>Join</button>
+			<button onClick={hangup}>Leave</button>
+			<button onClick={() => muteAudio(!isAudioMuted)}>
+				{isAudioMuted ? 'Unmute' : 'Mute'}
+			</button>
+			<button onClick={() => sendJSON('chat', { text: 'Hello!' })}>Send</button>
+		</div>
+	);
+}
+```
+
+For detailed architecture, see [docs/webrtc-architecture.md](../../docs/webrtc-architecture.md).
+
 ## API Reference
 
 ### AgentuityProvider

package/dist/eventstream.d.ts

@@ -34,6 +34,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
@@ -48,11 +51,26 @@ 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 declare function useEventStream<TRoute extends SSERouteKey>(route: TRoute, options?: EventStreamOptions): {
+export declare 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;

package/dist/eventstream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eventstream.d.ts","sourceRoot":"","sources":["../src/eventstream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAIN,KAAK,gBAAgB,EACrB,MAAM,qBAAqB,CAAC;AAG7B;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,MAAM,SAAS,WAAW,IAAI,MAAM,SAAS,MAAM,gBAAgB,GAC3F,gBAAgB,CAAC,MAAM,CAAC,SAAS;IAAE,YAAY,EAAE,MAAM,OAAO,CAAA;CAAE,GAC/D,OAAO,SAAS,SAAS,GAAG,KAAK,GAChC,IAAI,GACJ,WAAW,CAAC,OAAO,CAAC,GACrB,IAAI,GACL,IAAI,CAAC;AAER;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,MAAM,SAAS,WAAW,EACxD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC1B;IACF,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACnB,CAwFA"}
+{"version":3,"file":"eventstream.d.ts","sourceRoot":"","sources":["../src/eventstream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAIN,KAAK,gBAAgB,EACrB,MAAM,qBAAqB,CAAC;AAG7B;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,MAAM,SAAS,WAAW,IAAI,MAAM,SAAS,MAAM,gBAAgB,GAC3F,gBAAgB,CAAC,MAAM,CAAC,SAAS;IAAE,YAAY,EAAE,MAAM,OAAO,CAAA;CAAE,GAC/D,OAAO,SAAS,SAAS,GAAG,KAAK,GAChC,IAAI,GACJ,WAAW,CAAC,OAAO,CAAC,GACrB,IAAI,GACL,IAAI,CAAC;AAER;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,cAAc,CAAC,MAAM,SAAS,WAAW,EAAE,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,EAC1F,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC1B;IACF,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACnB,CA6FA"}

package/dist/eventstream.js

@@ -8,6 +8,9 @@ import { AgentuityContext } from './context';
  * 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
@@ -22,6 +25,21 @@ import { AgentuityContext } from './context';
  *   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(route, options) {
     const context = useContext(AgentuityContext);
@@ -35,7 +53,13 @@ export function useEventStream(route, options) {
     const [isConnected, setIsConnected] = useState(false);
     const [readyState, setReadyState] = useState(2); // EventSource.CLOSED = 2
     // Build EventStream URL
-    const esUrl = useMemo(() => buildUrl(context.baseUrl, route, options?.subpath, options?.query), [context.baseUrl, route, options?.subpath, options?.query?.toString()]);
+    // 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, options?.subpath, options?.query), 
+    // 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({

package/dist/eventstream.js.map

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

package/dist/index.d.ts

@@ -2,9 +2,10 @@ export { AgentuityContext, AgentuityProvider, useAgentuity, useAuth, type Contex
 export { createClient, createAPIClient, setGlobalBaseUrl, getGlobalBaseUrl, setGlobalAuthHeader, getGlobalAuthHeader, } from './client';
 export { useWebsocket, type WebSocketRouteKey, type WebSocketRouteInput, type WebSocketRouteOutput, type WebsocketOptions, } from './websocket';
 export { useEventStream, type SSERouteKey, type SSERouteOutput, type EventStreamOptions, } from './eventstream';
+export { useWebRTCCall, type UseWebRTCCallOptions, type UseWebRTCCallResult, type WebRTCConnectionState, type WebRTCClientCallbacks, } from './webrtc';
 export { useAPI, type RouteKey, type ExtractMethod, type RouteIsStream, type RouteInput, type RouteOutput, type RoutePathParams, type UseAPIOptions, type UseAPIResult, type InvokeOptions, } from './api';
 export { useJsonMemo } from './memo';
 export { useAnalytics, useTrackOnMount, withPageTracking, type UseAnalyticsResult, type TrackOnMountOptions, } from './analytics.js';
 export type { RouteRegistry, WebSocketRouteRegistry, SSERouteRegistry, RPCRouteRegistry, } from '@agentuity/frontend';
-export { buildUrl, defaultBaseUrl, deserializeData, createReconnectManager, jsonEqual, getProcessEnv, WebSocketManager, EventStreamManager, type ReconnectOptions, type ReconnectManager, type WebSocketMessageHandler, type WebSocketCallbacks, type WebSocketManagerOptions, type WebSocketManagerState, type EventStreamMessageHandler, type EventStreamCallbacks, type EventStreamManagerOptions, type EventStreamManagerState, type Client, type ClientOptions, type RouteEndpoint, type WebSocketClient, type EventStreamClient, type StreamClient, type EventHandler, } from '@agentuity/frontend';
+export { buildUrl, defaultBaseUrl, deserializeData, createReconnectManager, jsonEqual, getProcessEnv, WebSocketManager, EventStreamManager, type ReconnectOptions, type ReconnectManager, type WebSocketMessageHandler, type WebSocketCallbacks, type WebSocketManagerOptions, type WebSocketManagerState, type EventStreamMessageHandler, type EventStreamCallbacks, type EventStreamManagerOptions, type EventStreamManagerState, WebRTCManager, UserMediaSource, DisplayMediaSource, CustomStreamSource, type WebRTCManagerOptions, type WebRTCManagerState, type WebRTCDisconnectReason, type Client, type ClientOptions, type RouteEndpoint, type WebSocketClient, type EventStreamClient, type StreamClient, type EventHandler, } from '@agentuity/frontend';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,MAAM,EACN,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,GAClB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGrC,OAAO,EACN,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACxB,MAAM,gBAAgB,CAAC;AAKxB,YAAY,EACX,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACN,QAAQ,EACR,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAE5B,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,GACjB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,MAAM,EACN,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,GAClB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGrC,OAAO,EACN,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACxB,MAAM,gBAAgB,CAAC;AAKxB,YAAY,EACX,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACN,QAAQ,EACR,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAE3B,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -2,10 +2,11 @@ export { AgentuityContext, AgentuityProvider, useAgentuity, useAuth, } from './c
 export { createClient, createAPIClient, setGlobalBaseUrl, getGlobalBaseUrl, setGlobalAuthHeader, getGlobalAuthHeader, } from './client';
 export { useWebsocket, } from './websocket';
 export { useEventStream, } from './eventstream';
+export { useWebRTCCall, } from './webrtc';
 export { useAPI, } from './api';
 export { useJsonMemo } from './memo';
 // Analytics
 export { useAnalytics, useTrackOnMount, withPageTracking, } from './analytics.js';
 // Re-export web utilities for convenience (excluding registry types which come from ./types)
-export { buildUrl, defaultBaseUrl, deserializeData, createReconnectManager, jsonEqual, getProcessEnv, WebSocketManager, EventStreamManager, } from '@agentuity/frontend';
+export { buildUrl, defaultBaseUrl, deserializeData, createReconnectManager, jsonEqual, getProcessEnv, WebSocketManager, EventStreamManager, WebRTCManager, UserMediaSource, DisplayMediaSource, CustomStreamSource, } from '@agentuity/frontend';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,OAAO,GAKP,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,YAAY,GAKZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,cAAc,GAId,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,MAAM,GAUN,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,YAAY;AACZ,OAAO,EACN,YAAY,EACZ,eAAe,EACf,gBAAgB,GAGhB,MAAM,gBAAgB,CAAC;AAYxB,6FAA6F;AAC7F,OAAO,EACN,QAAQ,EACR,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAmBlB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,OAAO,GAKP,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,YAAY,GAKZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,cAAc,GAId,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,aAAa,GAKb,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,MAAM,GAUN,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,YAAY;AACZ,OAAO,EACN,YAAY,EACZ,eAAe,EACf,gBAAgB,GAGhB,MAAM,gBAAgB,CAAC;AAYxB,6FAA6F;AAC7F,OAAO,EACN,QAAQ,EACR,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAWlB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GAYlB,MAAM,qBAAqB,CAAC"}

package/dist/webrtc.d.ts

@@ -0,0 +1,164 @@
+import { type WebRTCClientCallbacks, type TrackSource } from '@agentuity/frontend';
+import type { WebRTCConnectionState, DataChannelConfig, DataChannelState, ConnectionQualitySummary, RecordingHandle, RecordingOptions } from '@agentuity/core';
+export type { WebRTCClientCallbacks, DataChannelConfig, DataChannelState, ConnectionQualitySummary, };
+export type { WebRTCConnectionState };
+/**
+ * Options for useWebRTCCall hook
+ */
+export interface UseWebRTCCallOptions {
+    /** Room ID to join */
+    roomId: string;
+    /** WebSocket signaling URL (e.g., '/call/signal' or full URL) */
+    signalUrl: string;
+    /** Whether this peer is "polite" in perfect negotiation */
+    polite?: boolean;
+    /** ICE servers configuration */
+    iceServers?: RTCIceServer[];
+    /**
+     * Media source configuration.
+     * - `false`: Data-only mode (no media)
+     * - `MediaStreamConstraints`: Use getUserMedia with these constraints
+     * - `TrackSource`: Use a custom track source
+     * Default: { video: true, audio: true }
+     */
+    media?: MediaStreamConstraints | TrackSource | false;
+    /**
+     * Data channels to create when connection is established.
+     * Only the offerer (late joiner) creates channels; the answerer receives them.
+     */
+    dataChannels?: DataChannelConfig[];
+    /**
+     * Whether to auto-reconnect on WebSocket/ICE failures (default: true)
+     */
+    autoReconnect?: boolean;
+    /**
+     * Maximum reconnection attempts before giving up (default: 5)
+     */
+    maxReconnectAttempts?: number;
+    /**
+     * Connection timeout in ms for connecting/negotiating (default: 30000)
+     */
+    connectionTimeout?: number;
+    /**
+     * ICE gathering timeout in ms (default: 10000)
+     */
+    iceGatheringTimeout?: number;
+    /** Whether to auto-connect on mount (default: true) */
+    autoConnect?: boolean;
+    /**
+     * Optional callbacks for WebRTC events.
+     * These are called in addition to the hook's internal state management.
+     */
+    callbacks?: Partial<WebRTCClientCallbacks>;
+}
+/**
+ * Return type for useWebRTCCall hook
+ */
+export interface UseWebRTCCallResult {
+    /** Ref to attach to local video element */
+    localVideoRef: React.RefObject<HTMLVideoElement | null>;
+    /** Current connection state */
+    state: WebRTCConnectionState;
+    /** Current error if any */
+    error: Error | null;
+    /** Local peer ID assigned by server */
+    peerId: string | null;
+    /** Remote peer IDs */
+    remotePeerIds: string[];
+    /** Remote streams keyed by peer ID */
+    remoteStreams: Map<string, MediaStream>;
+    /** Whether audio is muted */
+    isAudioMuted: boolean;
+    /** Whether video is muted */
+    isVideoMuted: boolean;
+    /** Whether this is a data-only connection (no media) */
+    isDataOnly: boolean;
+    /** Whether screen sharing is active */
+    isScreenSharing: boolean;
+    /** Manually start the connection (if autoConnect is false) */
+    connect: () => void;
+    /** End the call */
+    hangup: () => void;
+    /** Mute or unmute audio */
+    muteAudio: (muted: boolean) => void;
+    /** Mute or unmute video */
+    muteVideo: (muted: boolean) => void;
+    /** Start screen sharing */
+    startScreenShare: (options?: DisplayMediaStreamOptions) => Promise<void>;
+    /** Stop screen sharing */
+    stopScreenShare: () => Promise<void>;
+    /** Create a new data channel to all peers */
+    createDataChannel: (config: DataChannelConfig) => Map<string, RTCDataChannel>;
+    /** Get all open data channel labels */
+    getDataChannelLabels: () => string[];
+    /** Get the state of a data channel for a specific peer */
+    getDataChannelState: (peerId: string, label: string) => DataChannelState | null;
+    /** Send a string message to all peers */
+    sendString: (label: string, data: string) => boolean;
+    /** Send a string message to a specific peer */
+    sendStringTo: (peerId: string, label: string, data: string) => boolean;
+    /** Send binary data to all peers */
+    sendBinary: (label: string, data: ArrayBuffer | Uint8Array) => boolean;
+    /** Send binary data to a specific peer */
+    sendBinaryTo: (peerId: string, label: string, data: ArrayBuffer | Uint8Array) => boolean;
+    /** Send JSON data to all peers */
+    sendJSON: (label: string, data: unknown) => boolean;
+    /** Send JSON data to a specific peer */
+    sendJSONTo: (peerId: string, label: string, data: unknown) => boolean;
+    /** Close a specific data channel on all peers */
+    closeDataChannel: (label: string) => boolean;
+    /** Get quality summary for a peer */
+    getQualitySummary: (peerId: string) => Promise<ConnectionQualitySummary | null>;
+    /** Get quality summaries for all peers */
+    getAllQualitySummaries: () => Promise<Map<string, ConnectionQualitySummary>>;
+    /** Start recording a stream */
+    startRecording: (streamId: string, options?: RecordingOptions) => RecordingHandle | null;
+    /** Check if a stream is being recorded */
+    isRecording: (streamId: string) => boolean;
+    /** Stop all recordings */
+    stopAllRecordings: () => Promise<Map<string, Blob>>;
+}
+/**
+ * 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 declare function useWebRTCCall(options: UseWebRTCCallOptions): UseWebRTCCallResult;
+//# sourceMappingURL=webrtc.d.ts.map

package/dist/webrtc.d.ts.map

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