fishjam-cloud · fj-cloud-infra · May 13, 2026
diff --git a/api/room-manager b/api/room-manager
diff --git a/packages/js-server-sdk b/packages/js-server-sdk
diff --git a/packages/python-server-sdk b/packages/python-server-sdk
diff --git a/packages/web-client-sdk b/packages/web-client-sdk
diff --git a/static/api/protobuf/server_notifications.proto b/static/api/protobuf/server_notifications.proto
@@ -233,6 +233,21 @@ message ServerMessage {
     string streamer_id = 2;
   }
 
+  // Carries multiple notifications in a single wire frame.
+  //
+  // Constraints (documented, not schema-enforced):
+  //   - Each element's `content` MUST be a notification variant — never
+  //     Authenticated, AuthRequest, SubscribeRequest, or SubscribeResponse.
+  //   - NotificationBatch MUST NOT be nested inside another NotificationBatch.
+  //     The schema technically permits this, but senders must not emit
+  //     recursive batches and receivers may treat them as a protocol violation.
+  //   - Notifications are delivered in array order; consumers must process
+  //     them in order.
+  //   - Sent only for webhooks, for peers that .
+  message NotificationBatch {
+    repeated ServerMessage notifications = 1;
+  }
+
   reserved 12;
 
   oneof content {
@@ -273,6 +288,9 @@ message ServerMessage {
     StreamerConnected streamer_connected = 26;
     StreamerDisconnected streamer_disconnected = 27;
 
+    // Batch
+    NotificationBatch notification_batch = 33;
+
     // Deprecated
 
     StreamConnected stream_connected = 22 [deprecated = true];

diff --git a/versioned_docs/version-0.27.0/_common/agents/definition.mdx b/versioned_docs/version-0.27.0/_common/agents/definition.mdx
@@ -0,0 +1,6 @@
+## What is an Agent?
+
+An agent is a piece of software that allows your backend server to participate in a Fishjam room, similar to how the Fishjam client SDKs allow your client-side application to participate in a Fishjam room.
+They can be used to implement features such as real-time audio transcription, real-time content moderation, conversations with AI agents and more.
+
+You can simply think of an agent as a peer running within your backend application.
diff --git a/versioned_docs/version-0.27.0/_common/agents/remember-to-disconnect.mdx b/versioned_docs/version-0.27.0/_common/agents/remember-to-disconnect.mdx
@@ -0,0 +1,3 @@
+:::danger Remember to disconnect your agents!
+It's important to disconnect agents, because **every connected agent generates usage** just as a normal peer.
+:::
diff --git a/versioned_docs/version-0.27.0/_common/agents/subscriptions.mdx b/versioned_docs/version-0.27.0/_common/agents/subscriptions.mdx
@@ -0,0 +1,4 @@
+By default, agents **won't** receive peers' audio streams.
+This is by design and aims to prevent unnecessary resource usage by the agents.
+
+For an agent to start receiving a peer's audio, the peer must be **created** with the **subscribe** option set.
diff --git a/versioned_docs/version-0.27.0/api/_category_.json b/versioned_docs/version-0.27.0/api/_category_.json
@@ -0,0 +1,12 @@
+{
+  "label": "API",
+  "position": 7,
+  "link": {
+    "type": "generated-index",
+    "description": "API documentation for Client and Server SDKs.",
+    "slug": "/api"
+  },
+  "customProps": {
+    "id": "generated-api"
+  }
+}
diff --git a/versioned_docs/version-0.27.0/api/mobile/enumerations/Variant.md b/versioned_docs/version-0.27.0/api/mobile/enumerations/Variant.md
@@ -0,0 +1,43 @@
+# Enumeration: Variant
+
+Defined in: packages/ts-client/dist/index.d.mts:51
+
+## Enumeration Members
+
+### UNRECOGNIZED
+
+> **UNRECOGNIZED**: `-1`
+
+Defined in: packages/ts-client/dist/index.d.mts:56
+
+***
+
+### VARIANT\_HIGH
+
+> **VARIANT\_HIGH**: `3`
+
+Defined in: packages/ts-client/dist/index.d.mts:55
+
+***
+
+### VARIANT\_LOW
+
+> **VARIANT\_LOW**: `1`
+
+Defined in: packages/ts-client/dist/index.d.mts:53
+
+***
+
+### VARIANT\_MEDIUM
+
+> **VARIANT\_MEDIUM**: `2`
+
+Defined in: packages/ts-client/dist/index.d.mts:54
+
+***
+
+### VARIANT\_UNSPECIFIED
+
+> **VARIANT\_UNSPECIFIED**: `0`
+
+Defined in: packages/ts-client/dist/index.d.mts:52
diff --git a/versioned_docs/version-0.27.0/api/mobile/functions/FishjamProvider.md b/versioned_docs/version-0.27.0/api/mobile/functions/FishjamProvider.md
@@ -0,0 +1,15 @@
+# Function: FishjamProvider()
+
+> **FishjamProvider**(`props`): `FunctionComponentElement`\<`FishjamProviderProps`\>
+
+Defined in: [packages/mobile-client/src/index.ts:118](https://github.com/fishjam-cloud/web-client-sdk/blob/30f99e0d93a92f6cdd572bab746cc8ce0c853a22/packages/mobile-client/src/index.ts#L118)
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `props` | [`FishjamProviderProps`](../type-aliases/FishjamProviderProps.md) |
+
+## Returns
+
+`FunctionComponentElement`\<`FishjamProviderProps`\>
diff --git a/versioned_docs/version-0.27.0/api/mobile/functions/RTCPIPView.md b/versioned_docs/version-0.27.0/api/mobile/functions/RTCPIPView.md
@@ -0,0 +1,15 @@
+# Function: RTCPIPView()
+
+> **RTCPIPView**(`__namedParameters`): `Element`
+
+Defined in: [packages/mobile-client/src/overrides/RTCView.tsx:31](https://github.com/fishjam-cloud/web-client-sdk/blob/30f99e0d93a92f6cdd572bab746cc8ce0c853a22/packages/mobile-client/src/overrides/RTCView.tsx#L31)
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `__namedParameters` | [`RTCPIPViewProps`](../type-aliases/RTCPIPViewProps.md) |
+
+## Returns
+
+`Element`
diff --git a/versioned_docs/version-0.27.0/api/mobile/functions/RTCView.md b/versioned_docs/version-0.27.0/api/mobile/functions/RTCView.md
@@ -0,0 +1,15 @@
+# Function: RTCView()
+
+> **RTCView**(`__namedParameters`): `Element`
+
+Defined in: [packages/mobile-client/src/overrides/RTCView.tsx:26](https://github.com/fishjam-cloud/web-client-sdk/blob/30f99e0d93a92f6cdd572bab746cc8ce0c853a22/packages/mobile-client/src/overrides/RTCView.tsx#L26)
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `__namedParameters` | [`RTCVideoViewProps`](../type-aliases/RTCVideoViewProps.md) |
+
+## Returns
+
+`Element`
diff --git a/versioned_docs/version-0.27.0/api/mobile/functions/useCallKit.md b/versioned_docs/version-0.27.0/api/mobile/functions/useCallKit.md
@@ -0,0 +1,9 @@
+# Function: useCallKit()
+
+> **useCallKit**(): `object`
+
+Defined in: [packages/mobile-client/src/overrides/hooks.ts:100](https://github.com/fishjam-cloud/web-client-sdk/blob/30f99e0d93a92f6cdd572bab746cc8ce0c853a22/packages/mobile-client/src/overrides/hooks.ts#L100)
+
+## Returns
+
+`object`
diff --git a/versioned_docs/version-0.27.0/api/mobile/functions/useCallKitEvent.md b/versioned_docs/version-0.27.0/api/mobile/functions/useCallKitEvent.md
@@ -0,0 +1,22 @@
+# Function: useCallKitEvent()
+
+> **useCallKitEvent**\<`T`\>(`action`, `callback`): `void`
+
+Defined in: [packages/mobile-client/src/overrides/hooks.ts:109](https://github.com/fishjam-cloud/web-client-sdk/blob/30f99e0d93a92f6cdd572bab746cc8ce0c853a22/packages/mobile-client/src/overrides/hooks.ts#L109)
+
+## Type Parameters
+
+| Type Parameter |
+| ------ |
+| `T` *extends* keyof `CallKitAction` |
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `action` | `T` |
+| `callback` | (`event`) => `void` |
+
+## Returns
+
+`void`
diff --git a/versioned_docs/version-0.27.0/api/mobile/functions/useCallKitService.md b/versioned_docs/version-0.27.0/api/mobile/functions/useCallKitService.md
@@ -0,0 +1,15 @@
+# Function: useCallKitService()
+
+> **useCallKitService**(`config`): `void`
+
+Defined in: [packages/mobile-client/src/overrides/hooks.ts:105](https://github.com/fishjam-cloud/web-client-sdk/blob/30f99e0d93a92f6cdd572bab746cc8ce0c853a22/packages/mobile-client/src/overrides/hooks.ts#L105)
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `config` | `CallKitConfig` |
+
+## Returns
+
+`void`
diff --git a/versioned_docs/version-0.27.0/api/mobile/functions/useCamera.md b/versioned_docs/version-0.27.0/api/mobile/functions/useCamera.md
@@ -0,0 +1,118 @@
+# Function: useCamera()
+
+> **useCamera**(): `object`
+
+Defined in: [packages/mobile-client/src/overrides/hooks.ts:28](https://github.com/fishjam-cloud/web-client-sdk/blob/30f99e0d93a92f6cdd572bab746cc8ce0c853a22/packages/mobile-client/src/overrides/hooks.ts#L28)
+
+## Returns
+
+### ~~activeCamera~~
+
+> **activeCamera**: `null` \| [`DeviceItem`](../type-aliases/DeviceItem.md)
+
+#### Deprecated
+
+Use `currentCamera` and `isCameraOn` instead
+Indicates which camera is now turned on and streaming
+
+### cameraDeviceError
+
+> **cameraDeviceError**: `null` \| [`DeviceError`](../type-aliases/DeviceError.md)
+
+Possible error thrown while setting up the camera
+
+### cameraDevices
+
+> **cameraDevices**: [`DeviceItem`](../type-aliases/DeviceItem.md)[]
+
+List of available camera devices
+
+### cameraStream
+
+> **cameraStream**: `null` \| `MediaStream`
+
+### currentCamera
+
+> **currentCamera**: `null` \| `MediaDeviceInfo`
+
+Indicates which camera is now selected
+
+### currentCameraMiddleware
+
+> **currentCameraMiddleware**: [`TrackMiddleware`](../type-aliases/TrackMiddleware.md)
+
+The currently set camera middleware function
+
+### isCameraOn
+
+> **isCameraOn**: `boolean`
+
+Indicates whether the camera is streaming video
+
+### selectCamera()
+
+> **selectCamera**: (`deviceId`) => `Promise`\<`undefined` \| [`DeviceError`](../type-aliases/DeviceError.md)\>
+
+Selects the camera device
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `deviceId` | `string` |
+
+#### Returns
+
+`Promise`\<`undefined` \| [`DeviceError`](../type-aliases/DeviceError.md)\>
+
+### setCameraTrackMiddleware()
+
+> **setCameraTrackMiddleware**: (`middleware`) => `Promise`\<`void`\>
+
+Sets the camera middleware
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `middleware` | [`TrackMiddleware`](../type-aliases/TrackMiddleware.md) |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+### startCamera()
+
+> **startCamera**: (`deviceId?`) => `Promise`\<\[`MediaStreamTrack`, `null`\] \| \[`null`, [`DeviceError`](../type-aliases/DeviceError.md)\]\>
+
+Starts the camera
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `deviceId?` | `null` \| `string` |
+
+#### Returns
+
+`Promise`\<\[`MediaStreamTrack`, `null`\] \| \[`null`, [`DeviceError`](../type-aliases/DeviceError.md)\]\>
+
+### stopCamera()
+
+> **stopCamera**: () => `void`
+
+Stops the camera
+
+#### Returns
+
+`void`
+
+### toggleCamera()
+
+> **toggleCamera**: () => `Promise`\<`undefined` \| [`DeviceError`](../type-aliases/DeviceError.md)\>
+
+Toggles current camera on/off
+
+#### Returns
+
+`Promise`\<`undefined` \| [`DeviceError`](../type-aliases/DeviceError.md)\>
diff --git a/versioned_docs/version-0.27.0/api/mobile/functions/useCameraPermissions.md b/versioned_docs/version-0.27.0/api/mobile/functions/useCameraPermissions.md
@@ -0,0 +1,28 @@
+# Function: useCameraPermissions()
+
+> **useCameraPermissions**(): \[() => `Promise`\<[`PermissionStatus`](../type-aliases/PermissionStatus.md)\>, () => `Promise`\<[`PermissionStatus`](../type-aliases/PermissionStatus.md)\>\]
+
+Defined in: [packages/mobile-client/src/hooks/usePermissions.ts:47](https://github.com/fishjam-cloud/web-client-sdk/blob/30f99e0d93a92f6cdd572bab746cc8ce0c853a22/packages/mobile-client/src/hooks/usePermissions.ts#L47)
+
+Hook for querying and requesting camera permission on the device.
+
+## Returns
+
+\[() => `Promise`\<[`PermissionStatus`](../type-aliases/PermissionStatus.md)\>, () => `Promise`\<[`PermissionStatus`](../type-aliases/PermissionStatus.md)\>\]
+
+A tuple of `[query, request]`:
+- `query` – checks the current camera permission status without prompting the user.
+- `request` – triggers the native permission dialog and returns the resulting status.
+
+## Example
+
+```tsx
+import { useCameraPermissions } from "@fishjam-cloud/react-native-client";
+// ---cut---
+const [queryCameraPermission, requestCameraPermission] = useCameraPermissions();
+
+const status = await queryCameraPermission();
+if (status !== 'granted') {
+  await requestCameraPermission();
+}
+```
+37 −0		.github/workflows/integration-tests.yaml
+3 −1		.github/workflows/release.yaml
+1 −1		examples/multimodal/package.json
+2 −2		examples/multimodal/src/service/multimodal.ts
+1 −1		examples/room-manager/package.json
+1 −1		examples/selective-subscription/backend/package.json
+1 −1		examples/selective-subscription/frontend/package.json
+1 −1		examples/selective-subscription/package.json
+1 −1		examples/transcription/package.json
+1 −1		package.json
+1 −1		packages/fishjam-openapi/package.json
+155 −9		packages/fishjam-openapi/src/generated/api.ts
+1 −1		packages/fishjam-openapi/src/generated/base.ts
+1 −1		packages/fishjam-openapi/src/generated/common.ts
+1 −1		packages/fishjam-openapi/src/generated/configuration.ts
+1 −1		packages/fishjam-openapi/src/generated/index.ts
+1 −1		packages/fishjam-proto/package.json
+5 −3		packages/js-server-sdk/package.json
+1 −2		packages/js-server-sdk/src/agent.ts
+17 −0		packages/js-server-sdk/src/client.ts
+26 −1		packages/js-server-sdk/src/index.ts
+163 −0		packages/js-server-sdk/src/notifications.ts
+18 −1		packages/js-server-sdk/src/types.ts
+5 −67		packages/js-server-sdk/src/ws_notifier.ts
+213 −0		packages/js-server-sdk/tests/client.test.ts
+76 −0		packages/js-server-sdk/tests/notifications.test.ts
+2 −3		packages/js-server-sdk/tsconfig.json
+5 −1		typedoc.json
+682 −3		yarn.lock
+37 −18		.github/workflows/ci.yml
+13 −0		AGENTS.md
+1 −0		CLAUDE.md
+1 −1		examples/multimodal/pyproject.toml
+1 −1		examples/poet_chat/pyproject.toml
+1 −1		examples/selective_subscription/pyproject.toml
+1 −1		examples/transcription/pyproject.toml
+1 −0		fishjam/_openapi_client/api/moq/__init__.py
+177 −0		fishjam/_openapi_client/api/moq/create_moq_token.py
+4 −0		fishjam/_openapi_client/models/__init__.py
+61 −0		fishjam/_openapi_client/models/moq_token.py
+76 −0		fishjam/_openapi_client/models/moq_token_config.py
+29 −0		fishjam/api/_fishjam_client.py
+8 −0		fishjam/events/__init__.py
+12 −6		fishjam/events/allowed_notifications.py
+1 −1		pyproject.toml
+2 −3		tests/agent/test_agent.py
+33 −0		tests/conftest.py
+38 −9		tests/support/asyncio_utils.py
+72 −0		tests/test_allowed_notifications.py
+43 −29		tests/test_notifier.py
+30 −8		tests/test_room_api.py
+350 −2		uv.lock
+1 −1		.github/workflows/tests.yaml
+2 −0		e2e-tests/livestream-client/config.ts
+4 −1		e2e-tests/livestream-client/src/App.tsx
+6 −0		e2e-tests/react-client/config.ts
+4 −3		e2e-tests/react-client/scenarios/utils.ts
+14 −1		e2e-tests/webrtc-client/config.ts
+2 −2		e2e-tests/webrtc-client/scenarios/utils.ts
+2 −1		examples/mobile-client/fishjam-chat/.env.example
+6 −2		examples/mobile-client/fishjam-chat/README.md
+4 −2		examples/mobile-client/fishjam-chat/app/livestream/screen-sharing.tsx
+4 −2		examples/mobile-client/fishjam-chat/app/livestream/streamer.tsx
+4 −2		examples/mobile-client/fishjam-chat/app/livestream/viewer.tsx
+4 −2		examples/mobile-client/fishjam-chat/app/room/preview.tsx
+1 −1		package.json
+3 −3		packages/mobile-client/package.json
+1 −1		packages/react-client/package.json
+8 −8		packages/react-client/src/FishjamProvider.tsx
+15 −0		packages/react-client/src/hooks/internal/useCurrentCallback.ts
+14 −16		packages/react-client/src/hooks/internal/useScreenshareManager.ts
+57 −65		packages/react-client/src/hooks/internal/useTrackManager.ts
+6 −2		packages/react-client/src/hooks/useDataChannel.ts
+9 −1		packages/react-client/src/hooks/useLocalVAD.ts
+13 −1		packages/react-client/src/hooks/usePeers.ts
+10 −10		packages/react-client/src/hooks/useSandbox.ts
+24 −39		packages/react-client/src/hooks/useVAD.ts
+67 −0		packages/react-client/src/tests/useCurrentCallback.spec.ts
+7 −0		packages/react-client/src/utils/errors.ts
+1 −1		packages/ts-client/package.json
+1 −1		packages/webrtc-client/package.json
+28 −3		packages/webrtc-client/src/ConnectionManager.ts
+29 −28		packages/webrtc-client/src/webRTCEndpoint.ts
+115 −0		packages/webrtc-client/tests/addTransceiversIfNeeded.test.ts
+27 −32		packages/webrtc-client/tests/events/connectedEvent.test.ts
+28 −26		packages/webrtc-client/tests/events/encodingSwitchedEvent.test.ts
+6 −6		packages/webrtc-client/tests/events/endpointAddedEvent.test.ts
+26 −27		packages/webrtc-client/tests/events/endpointRemovedEvent.test.ts
+9 −8		packages/webrtc-client/tests/events/endpointUpdatedEvent.test.ts
+128 −0		packages/webrtc-client/tests/events/serializedMediaEvents.test.ts
+64 −64		packages/webrtc-client/tests/events/trackAddedEvent.test.ts
+21 −22		packages/webrtc-client/tests/events/trackRemovedEvent.test.ts
+29 −31		packages/webrtc-client/tests/events/trackUpdatedEvent.test.ts
+23 −20		packages/webrtc-client/tests/events/vadNotificationEvent.test.ts
+13 −22		packages/webrtc-client/tests/methods/addTrackMethod.test.ts
+4 −4		packages/webrtc-client/tests/methods/getLocalTrackAudioLevelMethod.test.ts
+6 −8		packages/webrtc-client/tests/utils.ts
+6 −6		yarn.lock