@faiber/faiber-session 0.24.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,355 +2,412 @@ import { ServiceApi, type Identifier, type RequestOptions } from "@faiber/sdk-co
2
2
  import type * as T from "./operations.types.js";
3
3
  export declare class SessionOperations extends ServiceApi {
4
4
  /**
5
- * Performs the status route operation for the router capability.
5
+ * Read public liveness and hard-coded service version; no database readiness probe.
6
6
  * Calls `GET /` through the shared IDP-aware Faiber client.
7
7
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
8
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
9
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
8
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
9
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: No local permission requirement; production auth context middleware still runs.
10
10
  */
11
- routerStatusRouteGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RouterStatusRouteGetResponse, unknown, {}>>;
11
+ routerStatusRouteGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("@faiber/sdk-core").ServiceHealthResponse, unknown, {}, any>>;
12
12
  /**
13
- * Performs the show operation for the branding capability.
13
+ * Read flattened branding with nullable title/icon and locale map. Requires a non-nil user and config:read.
14
14
  * Calls `GET /api/v1/config/branding` through the shared IDP-aware Faiber client.
15
15
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
16
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
17
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: config:read.
16
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
17
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; config:read.
18
18
  */
19
- brandingShowGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.BrandingShowGetResponse, unknown, {}>>;
19
+ brandingShowGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("@faiber/sdk-core").ApiEnvelope<import("./branding.types.js").SessionBranding>, unknown, {}, any>>;
20
20
  /**
21
- * Performs the update operation for the branding capability.
21
+ * Replace branding; omitted fields reset to defaults. Locale keys normalize lowercase, titles trim (500 characters max), at most 30 locales; icon URL derives from uploaded key. Invalid/unuploaded keys return422.
22
22
  * Calls `PUT /api/v1/config/branding` through the shared IDP-aware Faiber client.
23
23
  * @param data Typed JSON request body.
24
24
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
25
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
26
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: config:update.
25
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
26
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; config:update.
27
27
  */
28
- brandingUpdatePut(data: T.BrandingUpdatePutInput, options?: RequestOptions<T.BrandingUpdatePutInput>): Promise<import("axios").AxiosResponse<T.BrandingUpdatePutResponse, T.BrandingUpdatePutInput, {}>>;
28
+ brandingUpdatePut(data: T.BrandingUpdatePutInput, options?: RequestOptions<T.BrandingUpdatePutInput>): Promise<import("axios").AxiosResponse<import("@faiber/sdk-core").ApiEnvelope<import("./branding.types.js").SessionBranding>, import("./branding.types.js").SessionBrandingInput, {}, any>>;
29
29
  /**
30
- * Performs the upload operation for the branding capability.
30
+ * Upload FormData with file as its first field. PNG/JPEG/WebP signature and MIME must match; nonempty image at most8MiB. Returns asset_key and URL; malformed, oversized and unsupported files return400/413/415.
31
31
  * Calls `POST /api/v1/config/branding/assets` through the shared IDP-aware Faiber client.
32
32
  * @param data Typed multipart form.
33
33
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
34
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
35
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: config:update.
34
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
35
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; config:update.
36
36
  */
37
- brandingUploadPost(data: T.BrandingUploadPostInput, options?: RequestOptions<T.BrandingUploadPostInput>): Promise<import("axios").AxiosResponse<T.BrandingUploadPostResponse, FormData, {}>>;
37
+ brandingUploadPost(data: T.BrandingUploadPostInput, options?: RequestOptions<T.BrandingUploadPostInput>): Promise<import("axios").AxiosResponse<import("./reviewed-wire.js").SessionBrandingUploadResponse, FormData, {}, any>>;
38
38
  /**
39
- * Performs the livekit config show operation for the configuration capability.
39
+ * Read LiveKit/recording/AI settings with secret-presence booleans; secrets are never returned.
40
40
  * Calls `GET /api/v1/config/livekit` through the shared IDP-aware Faiber client.
41
41
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
42
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
43
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: config:read.
42
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
43
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; config:read.
44
44
  */
45
- configurationLivekitConfigShowGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ConfigurationLivekitConfigShowGetResponse, unknown, {}>>;
45
+ configurationLivekitConfigShowGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.ConfigurationLivekitConfigShowGetResponse, unknown, {}, any>>;
46
46
  /**
47
- * Performs the livekit config update operation for the configuration capability.
47
+ * Replace LiveKit settings. Missing/null/blank secret fields preserve existing secrets; omitted audio_processing_enabled becomes false, audio_language defaults auto. Model refs may clear with null. Invalid URLs, language, schedules and model configuration return422.
48
48
  * Calls `PUT /api/v1/config/livekit` through the shared IDP-aware Faiber client.
49
49
  * @param data Typed JSON request body.
50
50
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
51
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
52
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: config:update.
51
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
52
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; config:update.
53
53
  */
54
- configurationLivekitConfigUpdatePut(data: T.ConfigurationLivekitConfigUpdatePutInput, options?: RequestOptions<T.ConfigurationLivekitConfigUpdatePutInput>): Promise<import("axios").AxiosResponse<T.ConfigurationLivekitConfigUpdatePutResponse, T.ConfigurationLivekitConfigUpdatePutInput, {}>>;
54
+ configurationLivekitConfigUpdatePut(data: T.ConfigurationLivekitConfigUpdatePutInput, options?: RequestOptions<T.ConfigurationLivekitConfigUpdatePutInput>): Promise<import("axios").AxiosResponse<T.ConfigurationLivekitConfigUpdatePutResponse, T.ConfigurationLivekitConfigUpdatePutInput, {}, any>>;
55
55
  /**
56
- * Performs the integration docs show operation for the integration capability.
56
+ * Read browser integration steps and code snippets with the configured public LiveKit websocket URL.
57
57
  * Calls `GET /api/v1/integration/docs` through the shared IDP-aware Faiber client.
58
58
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
59
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
60
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: integration:read.
59
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
60
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; integration:read.
61
61
  */
62
- integrationIntegrationDocsShowGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.IntegrationIntegrationDocsShowGetResponse, unknown, {}>>;
62
+ integrationIntegrationDocsShowGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.IntegrationIntegrationDocsShowGetResponse, unknown, {}, any>>;
63
63
  /**
64
- * Performs the flow integration show operation for the integration capability.
65
- * Calls `GET /api/v1/integration/flow` through the shared IDP-aware Faiber client.
66
- * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
67
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
68
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
69
- */
70
- integrationFlowIntegrationShowGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.IntegrationFlowIntegrationShowGetResponse, unknown, {}>>;
71
- /**
72
- * Performs the tool schema operation for the assistant tools capability.
64
+ * Read the two stable assistant tool schemas (session_list and session_detail). This route has no local permission gate.
73
65
  * Calls `GET /api/v1/integrations/chat/tool-schema` through the shared IDP-aware Faiber client.
74
66
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
75
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
76
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
67
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
68
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: No local permission requirement; production auth context middleware still runs.
77
69
  */
78
- assistantToolsToolSchemaGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.AssistantToolsToolSchemaGetResponse, unknown, {}>>;
70
+ assistantToolsToolSchemaGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./reviewed-wire.js").SessionToolSchemaResponse, unknown, {}, any>>;
79
71
  /**
80
- * Performs the list user sessions operation for the assistant tools capability.
72
+ * List the specified user participant rooms by newest activity. q searches room name; limit defaults20 and clamps1..100. Latest analysis is restricted to that user and transcript truncates to1200 characters.
81
73
  * Calls `GET /api/v1/integrations/chat/users/{user_id}/sessions` through the shared IDP-aware Faiber client.
82
74
  * @param userId Backend path identifier `user_id`.
83
75
  * @param params Typed query parameters; omitted members retain backend defaults.
84
76
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
85
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
86
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
77
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
78
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Own user plus assistant_session:read_own OR room_recording:read_own OR room:read_recordings; OR assistant_session:read_all/room_recording:read_all. * and session:* accepted.
87
79
  */
88
- assistantToolsListUserSessionsGet(userId: Identifier, params?: T.AssistantToolsListUserSessionsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.AssistantToolsListUserSessionsGetResponse, unknown, {}>>;
80
+ assistantToolsListUserSessionsGet(userId: Identifier, params?: T.AssistantToolsListUserSessionsGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./reviewed-wire.js").SessionAssistantListResponse, unknown, {}, any>>;
89
81
  /**
90
- * Performs the user session detail operation for the assistant tools capability.
82
+ * Read one room only if the specified user is a participant; missing membership/room returns404. Own access filters analyses to that user; read_all includes all room analyses. DRM manifest and model analysis remain provider-owned JSON.
91
83
  * Calls `GET /api/v1/integrations/chat/users/{user_id}/sessions/{room_id}` through the shared IDP-aware Faiber client.
92
84
  * @param userId Backend path identifier `user_id`.
93
85
  * @param roomId Backend path identifier `room_id`.
94
86
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
95
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
96
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
87
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
88
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Own user plus assistant_session:read_own OR room_recording:read_own OR room:read_recordings; OR assistant_session:read_all/room_recording:read_all. * and session:* accepted.
97
89
  */
98
- assistantToolsUserSessionDetailGet(userId: Identifier, roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.AssistantToolsUserSessionDetailGetResponse, unknown, {}>>;
90
+ assistantToolsUserSessionDetailGet(userId: Identifier, roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./reviewed-wire.js").SessionAssistantDetailResponse, unknown, {}, any>>;
99
91
  /**
100
- * Performs the performance context operation for the integration capability.
101
- * Calls `POST /api/v1/integrations/lms/performance-context` through the shared IDP-aware Faiber client.
102
- * @param data Typed JSON request body.
92
+ * Read trusted LMS notification state. Header x-infera-lms-token must match LMS_SERVICE_TOKEN (403 on mismatch,503 if missing/provider unavailable). This read can persist learning start and an outbox event; LiveKit probe timeout is5s.
93
+ * Calls `GET /api/v1/integrations/lms/rooms/{id}/notification-state` through the shared IDP-aware Faiber client.
94
+ * @param id Backend path identifier `id`.
103
95
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
104
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
105
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
96
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
97
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Trusted server-only x-infera-lms-token matching LMS_SERVICE_TOKEN.
106
98
  */
107
- integrationPerformanceContextPost(data: T.IntegrationPerformanceContextPostInput, options?: RequestOptions<T.IntegrationPerformanceContextPostInput>): Promise<import("axios").AxiosResponse<T.IntegrationPerformanceContextPostResponse, T.IntegrationPerformanceContextPostInput, {}>>;
99
+ notificationStateSnapshotGet(id: string, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("@faiber/sdk-core").ApiEnvelope<import("./contracts.types.js").SessionNotificationState>, unknown, {}, any>>;
108
100
  /**
109
- * Performs the public show operation for the branding capability.
101
+ * Read public flattened branding and nullable runtime-validated feedback_task_origin. This origin cannot be saved through branding.
110
102
  * Calls `GET /api/v1/public/branding` through the shared IDP-aware Faiber client.
111
103
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
112
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
113
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
104
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
105
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: No local permission requirement; production auth context middleware still runs.
114
106
  */
115
- brandingPublicShowGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.BrandingPublicShowGetResponse, unknown, {}>>;
107
+ brandingPublicShowGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("@faiber/sdk-core").ApiEnvelope<import("./branding.types.js").SessionPublicBranding>, unknown, {}, any>>;
116
108
  /**
117
- * Performs the asset operation for the branding capability.
109
+ * Read public raw branding image bytes with immutable cache headers. Invalid/missing UUID.extension key returns404; this is not a JSON envelope.
118
110
  * Calls `GET /api/v1/public/branding/assets/{key}` through the shared IDP-aware Faiber client.
119
111
  * @param key Backend path identifier `key`.
120
112
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
121
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
122
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
113
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
114
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: No local permission requirement; production auth context middleware still runs.
123
115
  */
124
- brandingAssetGet(key: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.BrandingAssetGetResponse, unknown, {}>>;
116
+ brandingAssetGet(key: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./reviewed-wire.js").SessionBrandingAssetBytes, unknown, {}, any>>;
125
117
  /**
126
- * Performs the recordings index operation for the recording capability.
118
+ * Page recording queue with page_number/page_size (default1/10, page>=1 and size1..100), escaped literal search and exact status filter. Returns recordings and meta; sorted by started_at descending.
127
119
  * Calls `GET /api/v1/recordings` through the shared IDP-aware Faiber client.
128
120
  * @param params Typed query parameters; omitted members retain backend defaults.
129
121
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
130
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
131
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room_recording:read.
122
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
123
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room_recording:read; aliases room_recording:read_all, room:read_recordings.
132
124
  */
133
- recordingRecordingsIndexGet(params?: T.RecordingRecordingsIndexGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RecordingRecordingsIndexGetResponse, unknown, {}>>;
125
+ recordingRecordingsIndexGet(params?: T.RecordingRecordingsIndexGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RecordingRecordingsIndexGetResponse, unknown, {}, any>>;
134
126
  /**
135
- * Performs the recording manifest operation for the recording capability.
127
+ * Read typed recording tracks and analyses; missing recording returns404. Own read requires current room-client membership; global/admin scopes are accepted. Analysis remains model-owned JSON.
136
128
  * Calls `GET /api/v1/recordings/{recording_id}/manifest` through the shared IDP-aware Faiber client.
137
129
  * @param recordingId Backend path identifier `recording_id`.
138
130
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
139
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
140
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room_recording:read.
131
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
132
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room_recording:read; aliases room_recording:read_all, room_recording:read_own, room:read_recordings.
141
133
  */
142
- recordingRecordingManifestGet(recordingId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RecordingRecordingManifestGetResponse, unknown, {}>>;
134
+ recordingRecordingManifestGet(recordingId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RecordingRecordingManifestGetResponse, unknown, {}, any>>;
143
135
  /**
144
- * Performs the recording schedule operation for the recording capability.
136
+ * Schedule ready/scheduled/failed recording processing; raw_capturing/processing/archived/deleting or raced transitions return409. process_at is timezone-free ISO datetime. Omitted/null optional audio fields preserve current values.
145
137
  * Calls `POST /api/v1/recordings/{recording_id}/schedule` through the shared IDP-aware Faiber client.
146
138
  * @param recordingId Backend path identifier `recording_id`.
147
139
  * @param data Typed JSON request body.
148
140
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
149
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
150
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room_recording:process.
141
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
142
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room_recording:process.
151
143
  */
152
- recordingRecordingSchedulePost(recordingId: Identifier, data: T.RecordingRecordingSchedulePostInput, options?: RequestOptions<T.RecordingRecordingSchedulePostInput>): Promise<import("axios").AxiosResponse<T.RecordingRecordingSchedulePostResponse, T.RecordingRecordingSchedulePostInput, {}>>;
144
+ recordingRecordingSchedulePost(recordingId: Identifier, data: T.RecordingRecordingSchedulePostInput, options?: RequestOptions<T.RecordingRecordingSchedulePostInput>): Promise<import("axios").AxiosResponse<T.RecordingRecordingSchedulePostResponse, T.RecordingRecordingSchedulePostInput, {}, any>>;
153
145
  /**
154
- * Performs the audio models operation for the recording capability.
146
+ * Read normalized Agentic audio model catalog using configured financial owner or current config user; missing owner/upstream failure returns502.
155
147
  * Calls `GET /api/v1/recordings/audio-models` through the shared IDP-aware Faiber client.
156
148
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
157
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
158
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: config:read.
149
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
150
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; config:read.
159
151
  */
160
- recordingAudioModelsGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RecordingAudioModelsGetResponse, unknown, {}>>;
152
+ recordingAudioModelsGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RecordingAudioModelsGetResponse, unknown, {}, any>>;
161
153
  /**
162
- * Performs the room state respond operation for the room state capability.
154
+ * Respond as a current participant to question/task/game state. Staff cannot answer questions/tasks. values are required; evidence_images defaults empty. Failed task validation returns200 with validated:false, without persisting completion. Accepted replies may advance the active cohort and emit rewards.
163
155
  * Calls `POST /api/v1/room_states/{room_state_id}/respond` through the shared IDP-aware Faiber client.
164
156
  * @param roomStateId Backend path identifier `room_state_id`.
165
157
  * @param data Typed JSON request body.
166
158
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
167
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
168
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room_state:respond.
159
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
160
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room_state:respond; aliases room:read_own.
169
161
  */
170
- roomStateRoomStateRespondPost(roomStateId: Identifier, data: T.RoomStateRoomStateRespondPostInput, options?: RequestOptions<T.RoomStateRoomStateRespondPostInput>): Promise<import("axios").AxiosResponse<T.RoomStateRoomStateRespondPostResponse, T.RoomStateRoomStateRespondPostInput, {}>>;
162
+ roomStateRoomStateRespondPost(roomStateId: Identifier, data: T.RoomStateRoomStateRespondPostInput, options?: RequestOptions<T.RoomStateRoomStateRespondPostInput>): Promise<import("axios").AxiosResponse<T.RoomStateRoomStateRespondPostResponse, T.RoomStateRoomStateRespondPostInput, {}, any>>;
171
163
  /**
172
- * Performs the rooms index operation for the room capability.
164
+ * List rooms with page_number/page_size (default1/10; supply positive values), custom_only and normalized Persian/literal search. Returns data.rooms without pagination metadata. status is numeric; current_state uses Rust enum variant casing.
173
165
  * Calls `GET /api/v1/rooms` through the shared IDP-aware Faiber client.
174
166
  * @param params Typed query parameters; omitted members retain backend defaults.
175
167
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
176
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
177
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:read.
168
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
169
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:read; aliases room:read_all, room:read_own.
178
170
  */
179
- roomRoomsIndexGet(params?: T.RoomRoomsIndexGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsIndexGetResponse, unknown, {}>>;
171
+ roomRoomsIndexGet(params?: T.RoomRoomsIndexGetQuery, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsIndexGetResponse, unknown, {}, any>>;
180
172
  /**
181
- * Performs the rooms create operation for the room capability.
173
+ * Create a room with required name/capacity/starts_at; starts_at is timezone-free ISO datetime. Room-state names use PascalCase (ChargeLow), numeric room status defaults1. Composition rooms materialize DRM state later. Returns200 data.room.
182
174
  * Calls `POST /api/v1/rooms` through the shared IDP-aware Faiber client.
183
175
  * @param data Typed JSON request body.
184
176
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
185
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
186
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:create.
177
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
178
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:create; aliases room:read, room:read_own.
187
179
  */
188
- roomRoomsCreatePost(data: T.RoomRoomsCreatePostInput, options?: RequestOptions<T.RoomRoomsCreatePostInput>): Promise<import("axios").AxiosResponse<T.RoomRoomsCreatePostResponse, T.RoomRoomsCreatePostInput, {}>>;
180
+ roomRoomsCreatePost(data: T.RoomRoomsCreatePostInput, options?: RequestOptions<T.RoomRoomsCreatePostInput>): Promise<import("axios").AxiosResponse<T.RoomRoomsCreatePostResponse, T.RoomRoomsCreatePostInput, {}, any>>;
189
181
  /**
190
- * Performs the rooms delete operation for the room capability.
182
+ * Delete room and dependent records; returns200 data.room snapshot of the deleted room, not a generic deleted boolean. Missing room returns404; started-room media cleanup is best effort.
191
183
  * Calls `DELETE /api/v1/rooms/{room_id}` through the shared IDP-aware Faiber client.
192
184
  * @param roomId Backend path identifier `room_id`.
193
185
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
194
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
195
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:delete.
186
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
187
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:delete.
196
188
  */
197
- roomRoomsDeleteDelete(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsDeleteDeleteResponse, unknown, {}>>;
189
+ roomRoomsDeleteDelete(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsDeleteDeleteResponse, unknown, {}, any>>;
198
190
  /**
199
- * Performs the rooms show operation for the room capability.
191
+ * Read room detail with nullable timestamps/current_state and numeric status. Requires preview access or own room membership; missing room returns404.
200
192
  * Calls `GET /api/v1/rooms/{room_id}` through the shared IDP-aware Faiber client.
201
193
  * @param roomId Backend path identifier `room_id`.
202
194
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
203
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
204
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:read.
195
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
196
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:read; aliases room:read_all, room:read_own.
205
197
  */
206
- roomRoomsShowGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsShowGetResponse, unknown, {}>>;
198
+ roomRoomsShowGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsShowGetResponse, unknown, {}, any>>;
207
199
  /**
208
- * Performs the rooms update operation for the room capability.
200
+ * Partially update a room via PUT or PATCH (same handler). Omitted/null optional fields preserve values; users/states arrays synchronize membership/states. Before start, timing/state edits reset lifecycle; after start progress is retained. Missing room currently returns500.
209
201
  * Calls `PATCH /api/v1/rooms/{room_id}` through the shared IDP-aware Faiber client.
210
202
  * @param roomId Backend path identifier `room_id`.
211
203
  * @param data Typed JSON request body.
212
204
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
213
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
214
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:update.
205
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
206
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:update.
215
207
  */
216
- roomRoomsUpdatePatch(roomId: Identifier, data: T.RoomRoomsUpdatePatchInput, options?: RequestOptions<T.RoomRoomsUpdatePatchInput>): Promise<import("axios").AxiosResponse<T.RoomRoomsUpdatePatchResponse, T.RoomRoomsUpdatePatchInput, {}>>;
208
+ roomRoomsUpdatePatch(roomId: Identifier, data: T.RoomRoomsUpdatePatchInput, options?: RequestOptions<T.RoomRoomsUpdatePatchInput>): Promise<import("axios").AxiosResponse<T.RoomRoomsUpdatePatchResponse, T.RoomRoomsUpdatePatchInput, {}, any>>;
217
209
  /**
218
- * Performs the rooms update operation for the room capability.
210
+ * Partially update a room via PUT or PATCH (same handler). Omitted/null optional fields preserve values; users/states arrays synchronize membership/states. Before start, timing/state edits reset lifecycle; after start progress is retained. Missing room currently returns500.
219
211
  * Calls `PUT /api/v1/rooms/{room_id}` through the shared IDP-aware Faiber client.
220
212
  * @param roomId Backend path identifier `room_id`.
221
213
  * @param data Typed JSON request body.
222
214
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
223
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
224
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:update.
215
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
216
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:update.
225
217
  */
226
- roomRoomsUpdatePut(roomId: Identifier, data: T.RoomRoomsUpdatePutInput, options?: RequestOptions<T.RoomRoomsUpdatePutInput>): Promise<import("axios").AxiosResponse<T.RoomRoomsUpdatePutResponse, T.RoomRoomsUpdatePutInput, {}>>;
218
+ roomRoomsUpdatePut(roomId: Identifier, data: T.RoomRoomsUpdatePutInput, options?: RequestOptions<T.RoomRoomsUpdatePutInput>): Promise<import("axios").AxiosResponse<T.RoomRoomsUpdatePutResponse, T.RoomRoomsUpdatePutInput, {}, any>>;
227
219
  /**
228
- * Performs the rooms end operation for the room capability.
220
+ * End current room; requires teacher/admin/manager role or current LMS teacher in addition to permission. Returns200 {status,message} without data; absent room returns404.
229
221
  * Calls `POST /api/v1/rooms/{room_id}/end` through the shared IDP-aware Faiber client.
230
222
  * @param roomId Backend path identifier `room_id`.
231
223
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
232
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
233
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:end.
224
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
225
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:end.
234
226
  */
235
- roomRoomsEndPost(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsEndPostResponseData, unknown, {}>>;
227
+ roomRoomsEndPost(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsEndPostResponseData, unknown, {}, any>>;
236
228
  /**
237
- * Performs the interact operation for the asset economy capability.
229
+ * Queue a server-authorized interaction for an unmuted participant in an active room. Reuse event_id only for identical interaction/content; changed or pending retries return409. content max4096 encoded bytes; disabled interactions return422. Asset receipt returns unchanged.
238
230
  * Calls `POST /api/v1/rooms/{room_id}/interactions` through the shared IDP-aware Faiber client.
239
231
  * @param roomId Backend path identifier `room_id`.
240
232
  * @param data Typed JSON request body.
241
233
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
242
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
243
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:read_own.
234
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
235
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:read_own; aliases room:read.
244
236
  */
245
- assetEconomyInteractPost(roomId: Identifier, data: T.AssetEconomyInteractPostInput, options?: RequestOptions<T.AssetEconomyInteractPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").RoomInteractionResponse, import("./types.js").RoomInteractionInput, {}>>;
237
+ assetEconomyInteractPost(roomId: Identifier, data: T.AssetEconomyInteractPostInput, options?: RequestOptions<T.AssetEconomyInteractPostInput>): Promise<import("axios").AxiosResponse<import("./types.js").RoomInteractionResponse, import("./types.js").RoomInteractionInput, {}, any>>;
246
238
  /**
247
- * Performs the rooms interactive start operation for the room capability.
239
+ * Start interactive state for a current room participant after asset checks; no request body. Returns200 {status,message} without data; missing room/client returns404.
248
240
  * Calls `POST /api/v1/rooms/{room_id}/interactive/start` through the shared IDP-aware Faiber client.
249
241
  * @param roomId Backend path identifier `room_id`.
250
242
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
251
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
252
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:start_interactive.
243
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
244
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:start_interactive; aliases room:read_own.
253
245
  */
254
- roomRoomsInteractiveStartPost(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsInteractiveStartPostResponseData, unknown, {}>>;
246
+ roomRoomsInteractiveStartPost(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsInteractiveStartPostResponseData, unknown, {}, any>>;
255
247
  /**
256
- * Performs the rooms join operation for the room capability.
248
+ * Issue fresh LiveKit participant token after preview/participant checks and asset admission. Ended room returns empty token. chat_model_ref/chat_assistant_id/realtime are omitted when unavailable; membership and provider grants are enforced server-side.
257
249
  * Calls `GET /api/v1/rooms/{room_id}/join` through the shared IDP-aware Faiber client.
258
250
  * @param roomId Backend path identifier `room_id`.
259
251
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
260
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
261
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:read_livekit_token.
252
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
253
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:read_livekit_token; aliases room:read, room:read_all, room:read_own.
262
254
  */
263
- roomRoomsJoinGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsJoinGetResponse, unknown, {}>>;
255
+ roomRoomsJoinGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsJoinGetResponse, unknown, {}, any>>;
264
256
  /**
265
- * Performs the rooms leaderboard operation for the room capability.
257
+ * Read active seconds, earned coins and asset names per participant; this handler has no extra room-membership check beyond declared permission.
266
258
  * Calls `GET /api/v1/rooms/{room_id}/leaderboard` through the shared IDP-aware Faiber client.
267
259
  * @param roomId Backend path identifier `room_id`.
268
260
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
269
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
270
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:read_own.
261
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
262
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:read_own; aliases room:read, room:read_all.
271
263
  */
272
- roomRoomsLeaderboardGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsLeaderboardGetResponse, unknown, {}>>;
264
+ roomRoomsLeaderboardGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsLeaderboardGetResponse, unknown, {}, any>>;
273
265
  /**
274
- * Performs the rooms livekit token operation for the room capability.
266
+ * Issue LiveKit preview/participant token after preview/membership checks; ended room returns409 and missing room returns404.
275
267
  * Calls `GET /api/v1/rooms/{room_id}/livekit-token` through the shared IDP-aware Faiber client.
276
268
  * @param roomId Backend path identifier `room_id`.
277
269
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
278
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
279
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:read_livekit_token.
270
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
271
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:read_livekit_token; aliases room:read, room:read_all, room:read_own, room_recording:read, room_recording:read_all, room_recording:read_own.
280
272
  */
281
- roomRoomsLivekitTokenGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsLivekitTokenGetResponse, unknown, {}>>;
273
+ roomRoomsLivekitTokenGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsLivekitTokenGetResponse, unknown, {}, any>>;
282
274
  /**
283
- * Performs the rooms self moderation operation for the room capability.
275
+ * Read current participant mute status; expired mute becomes null. Authenticated user and existing participant are required; absent participant returns404.
284
276
  * Calls `GET /api/v1/rooms/{room_id}/moderation` through the shared IDP-aware Faiber client.
285
277
  * @param roomId Backend path identifier `room_id`.
286
278
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
287
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
288
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:read_own.
279
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
280
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:read_own; aliases room:read, room:read_all.
289
281
  */
290
- roomRoomsSelfModerationGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsSelfModerationGetResponse, unknown, {}>>;
282
+ roomRoomsSelfModerationGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsSelfModerationGetResponse, unknown, {}, any>>;
291
283
  /**
292
- * Performs the rooms participant mute operation for the room capability.
284
+ * Mute/unmute a student as teacher/admin/manager or current LMS teacher. Self mute returns400, staff targets403, unverifiable LMS staff503. Returns nullable muted_until.
293
285
  * Calls `PUT /api/v1/rooms/{room_id}/participants/{profile_id}/mute` through the shared IDP-aware Faiber client.
294
286
  * @param roomId Backend path identifier `room_id`.
295
287
  * @param profileId Backend path identifier `profile_id`.
296
288
  * @param data Typed JSON request body.
297
289
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
298
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
299
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:end.
290
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
291
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:end; aliases room:update, room:read, room:read_own.
300
292
  */
301
- roomRoomsParticipantMutePut(roomId: Identifier, profileId: Identifier, data: T.RoomRoomsParticipantMutePutInput, options?: RequestOptions<T.RoomRoomsParticipantMutePutInput>): Promise<import("axios").AxiosResponse<T.RoomRoomsParticipantMutePutResponse, T.RoomRoomsParticipantMutePutInput, {}>>;
293
+ roomRoomsParticipantMutePut(roomId: Identifier, profileId: Identifier, data: T.RoomRoomsParticipantMutePutInput, options?: RequestOptions<T.RoomRoomsParticipantMutePutInput>): Promise<import("axios").AxiosResponse<T.RoomRoomsParticipantMutePutResponse, T.RoomRoomsParticipantMutePutInput, {}, any>>;
302
294
  /**
303
- * Performs the rooms playback show operation for the room capability.
295
+ * Read full playback room/states after preview and readiness checks. Classroom session IDs can resolve through LMS. Unready/untimed composition returns409; timestamps include nullable available_until.
304
296
  * Calls `GET /api/v1/rooms/{room_id}/playback` through the shared IDP-aware Faiber client.
305
297
  * @param roomId Backend path identifier `room_id`.
306
298
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
307
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
308
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:read_playback.
299
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
300
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:read_playback; aliases room:read, room:read_all, room:read_own, room_recording:read, room_recording:read_all, room_recording:read_own.
309
301
  */
310
- roomRoomsPlaybackShowGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsPlaybackShowGetResponse, unknown, {}>>;
302
+ roomRoomsPlaybackShowGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsPlaybackShowGetResponse, unknown, {}, any>>;
311
303
  /**
312
- * Performs the rooms presence events operation for the room capability.
304
+ * Read joined/left activity-log events for an authorized previewer or participant, sorted by timestamp then ID. Output timestamps are UTC; missing room returns404.
313
305
  * Calls `GET /api/v1/rooms/{room_id}/presence-events` through the shared IDP-aware Faiber client.
314
306
  * @param roomId Backend path identifier `room_id`.
315
307
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
316
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
317
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:read or room:read_all or room:read_own plus room preview/participation access.
308
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
309
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:read; aliases room:read_all, room:read_own.
318
310
  */
319
- roomRoomsPresenceEventsGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SessionPresenceResponse, unknown, {}>>;
311
+ roomRoomsPresenceEventsGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SessionPresenceResponse, unknown, {}, any>>;
320
312
  /**
321
- * Performs the rooms recordings operation for the room capability.
313
+ * Read recording list and analyses after recording permission and current membership/global/admin checks; presigned URLs are returned, with model-produced analysis JSON.
322
314
  * Calls `GET /api/v1/rooms/{room_id}/recordings` through the shared IDP-aware Faiber client.
323
315
  * @param roomId Backend path identifier `room_id`.
324
316
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
325
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
326
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room_recording:read.
317
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
318
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room_recording:read; aliases room_recording:read_all, room_recording:read_own, room:read_recordings.
327
319
  */
328
- roomRoomsRecordingsGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsRecordingsGetResponse, unknown, {}>>;
320
+ roomRoomsRecordingsGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsRecordingsGetResponse, unknown, {}, any>>;
329
321
  /**
330
- * Performs the rooms stop operation for the room capability.
322
+ * Stop room using its registered GET route and return200 data.room. This operation mutates state; missing room returns404.
331
323
  * Calls `GET /api/v1/rooms/{room_id}/stop` through the shared IDP-aware Faiber client.
332
324
  * @param roomId Backend path identifier `room_id`.
333
325
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
334
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
335
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:stop.
326
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
327
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:stop.
336
328
  */
337
- roomRoomsStopGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsStopGetResponse, unknown, {}>>;
329
+ roomRoomsStopGet(roomId: Identifier, options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsStopGetResponse, unknown, {}, any>>;
338
330
  /**
339
- * Performs the rooms analytics operation for the room capability.
331
+ * Read ongoing sessions, today sessions and distinct ongoing/today connected users from repository activity and room records.
340
332
  * Calls `GET /api/v1/rooms/analytics` through the shared IDP-aware Faiber client.
341
333
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
342
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
343
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: room:read_analytics.
334
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
335
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: IDP Bearer token or secure cookie via shared FaiberClient; room:read_analytics.
344
336
  */
345
- roomRoomsAnalyticsGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsAnalyticsGetResponse, unknown, {}>>;
337
+ roomRoomsAnalyticsGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<T.RoomRoomsAnalyticsGetResponse, unknown, {}, any>>;
346
338
  /**
347
- * Performs the livekit webhook operation for the room capability.
339
+ * Receive signed LiveKit webhook raw bytes; preserve the signed body exactly and supply Authorization. Invalid/missing signature returns401. Success returns200 {status,message} without data; this is server-to-server transport.
348
340
  * Calls `POST /api/v1/rooms/livekit/webhook` through the shared IDP-aware Faiber client.
349
341
  * @param data Typed binary byte stream.
350
342
  * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
351
- * @returns The complete Axios response, including the typed service envelope, status, and headers.
352
- * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: session-derived or public bootstrap route.
343
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
344
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: LiveKit webhook Authorization signature; preserve exact body bytes.
345
+ */
346
+ roomLivekitWebhookPost(data: T.RoomLivekitWebhookPostInput, options?: RequestOptions<T.RoomLivekitWebhookPostInput>): Promise<import("axios").AxiosResponse<T.RoomLivekitWebhookPostResponseData, T.RoomLivekitWebhookPostInput, {}, any>>;
347
+ /**
348
+ * Read native observation policy with current IDP Bearer authority session:summary_access:manage; cookie-only and spoofed actor headers are insufficient. Binding is source-owned; this is not an MCP session.
349
+ * Calls `GET /api/v1/summary-access` through the shared IDP-aware Faiber client.
350
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
351
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
352
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Current IDP Bearer authority session:summary_access:manage; source binding and downstream collector checks.
353
+ */
354
+ nativeSummaryAccessStatus(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("@faiber/sdk-core").NativeSummaryAccessResponse, unknown, {}, any>>;
355
+ /**
356
+ * Save native observation policy with optimistic expected_revision (stale409), required reason max1024 Unicode characters, and current collector session:summary:read validation when enabling. After503 reload current state before retrying; mutation may have committed.
357
+ * Calls `PUT /api/v1/summary-access` through the shared IDP-aware Faiber client.
358
+ * @param data Typed JSON request body.
359
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
360
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
361
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Current IDP Bearer authority session:summary_access:manage; source binding and downstream collector checks.
362
+ */
363
+ saveNativeSummaryAccessPolicy(data: T.NativeAccessUpdatePolicyPutInput, options?: RequestOptions<T.NativeAccessUpdatePolicyPutInput>): Promise<import("axios").AxiosResponse<import("@faiber/sdk-core").NativeSummaryAccessResponse, import("@faiber/sdk-core").NativeSummaryPolicyUpdate, {}, any>>;
364
+ /**
365
+ * Revoke one native summary object with required reason max1024 Unicode characters. Revocation survives policy disable/re-enable. Reload current state after503 because mutation can commit before status reconciliation fails.
366
+ * Calls `POST /api/v1/summary-access/revocations` through the shared IDP-aware Faiber client.
367
+ * @param data Typed JSON request body.
368
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
369
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
370
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Current IDP Bearer authority session:summary_access:manage; source binding and downstream collector checks.
371
+ */
372
+ revokeNativeSummaryObject(data: T.NativeAccessRevokePostInput, options?: RequestOptions<T.NativeAccessRevokePostInput>): Promise<import("axios").AxiosResponse<import("@faiber/sdk-core").NativeSummaryAccessResponse, import("@faiber/sdk-core").NativeSummaryAccessRevoke, {}, any>>;
373
+ /**
374
+ * Restore a native summary object using JSON DELETE body with required reason max1024 Unicode characters. Reload after503; restored status can lag reconciliation.
375
+ * Calls `DELETE /api/v1/summary-access/revocations/{object}` through the shared IDP-aware Faiber client.
376
+ * @param object Backend path identifier `object`.
377
+ * @param data Typed JSON request body.
378
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
379
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
380
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Current IDP Bearer authority session:summary_access:manage; source binding and downstream collector checks.
381
+ */
382
+ restoreNativeSummaryObject(object: Identifier, data: T.NativeAccessRestoreDeleteInput, options?: RequestOptions<T.NativeAccessRestoreDeleteInput>): Promise<import("axios").AxiosResponse<import("@faiber/sdk-core").NativeSummaryAccessResponse, import("@faiber/sdk-core").NativeSummaryAccessRestore, {}, any>>;
383
+ /**
384
+ * Forward opaque peer bytes through Session actor extraction to chat/asset/profile/drm/lms; explicit HTTP method and separate query. Body max2MiB (413); missing configured Chat/DRM/LMS or upstream failure502; unknown peer404. Chat room grants enforce membership and filter collections; DRM path-based read grants do not prove room membership. Response headers are allowlisted; SDK buffers upstream streams.
385
+ * Calls `ANY /api/v1/view/{service}/{*path}` through the shared IDP-aware Faiber client.
386
+ * @param service Backend path identifier `service`.
387
+ * @param path Backend path identifier `*path`.
388
+ * @param method HTTP method accepted by the mounted ANY handler; CONNECT requires an explicit tunnel-capable Axios adapter. The SDK never sends an ANY verb.
389
+ * @param data Typed JSON request body.
390
+ * @param params Typed query parameters; omitted members retain backend defaults.
391
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
392
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
393
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: Extracted IDP actor; Session room/peer authorization plus target-service current authorization.
394
+ */
395
+ routerProxyViewServiceAny(service: "chat" | "asset" | "profile" | "drm" | "lms", path: string, method: import("@faiber/sdk-core").HttpRequestMethod, data: T.RouterProxyViewServiceAnyInput, params?: T.RouterProxyViewServiceAnyQuery, options?: RequestOptions<T.RouterProxyViewServiceAnyInput>): Promise<import("axios").AxiosResponse<import("./contracts.types.js").SessionPeerProxyResponse, import("./contracts.types.js").SessionPeerProxyBody, {}, any>>;
396
+ /**
397
+ * Read public liveness and hard-coded service version; no database readiness probe.
398
+ * Calls `GET /health` through the shared IDP-aware Faiber client.
399
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
400
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
401
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: No local permission requirement; production auth context middleware still runs.
402
+ */
403
+ routerStatusRouteGetHealth(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("@faiber/sdk-core").ServiceHealthResponse, unknown, {}, any>>;
404
+ /**
405
+ * Read Flow integration queue/events from the pinned infera-flow-sdk model; mounted at root /integration/flow.
406
+ * Calls `GET /integration/flow` through the shared IDP-aware Faiber client.
407
+ * @param options Axios headers, timeout, cancellation signal, credentials, adapter, and other request options.
408
+ * @returns The complete Axios response, including the typed handler payload, status, and headers.
409
+ * @throws AxiosError for authentication, permission, validation, not-found, conflict, or transport failures; required permission: No local permission requirement; production auth context middleware still runs.
353
410
  */
354
- roomLivekitWebhookPost(data: T.RoomLivekitWebhookPostInput, options?: RequestOptions<T.RoomLivekitWebhookPostInput>): Promise<import("axios").AxiosResponse<T.RoomLivekitWebhookPostResponseData, T.RoomLivekitWebhookPostInput, {}>>;
411
+ integrationFlowIntegrationShowGet(options?: RequestOptions): Promise<import("axios").AxiosResponse<import("./reviewed-wire.js").SessionFlowIntegrationResponse, unknown, {}, any>>;
355
412
  }
356
413
  //# sourceMappingURL=operations.d.ts.map