Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

perf(calls): speed up joining and add participant previews (#7037)

Eric Hayes7913f41cebec
diff --git a/.sqlx/query-28d68fb5674f3dfa0a2f8c48b8c749ba98587d9bdb14828621cd9d75673b1fc6.json b/.sqlx/query-28d68fb5674f3dfa0a2f8c48b8c749ba98587d9bdb14828621cd9d75673b1fc6.json
new file mode 100644
index 0000000000..7be6eb3ab1
--- /dev/null
+++ b/.sqlx/query-28d68fb5674f3dfa0a2f8c48b8c749ba98587d9bdb14828621cd9d75673b1fc6.json
@@ -0,0 +1,14 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "DELETE FROM call_meeting_preparations WHERE meeting_id = $1",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "28d68fb5674f3dfa0a2f8c48b8c749ba98587d9bdb14828621cd9d75673b1fc6"
+}
diff --git a/.sqlx/query-5dacfa998e0a0d84c746b4a835eeeb7edb2bd0d7743098ab2e5c49edc5490fb1.json b/.sqlx/query-5dacfa998e0a0d84c746b4a835eeeb7edb2bd0d7743098ab2e5c49edc5490fb1.json
new file mode 100644
index 0000000000..dd0b6ac2f1
--- /dev/null
+++ b/.sqlx/query-5dacfa998e0a0d84c746b4a835eeeb7edb2bd0d7743098ab2e5c49edc5490fb1.json
@@ -0,0 +1,15 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "DELETE FROM call_meeting_preparations WHERE id = $1 AND user_id = $2 AND meeting_id IS NULL",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Text"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "5dacfa998e0a0d84c746b4a835eeeb7edb2bd0d7743098ab2e5c49edc5490fb1"
+}
diff --git a/.sqlx/query-8b7fd5a02f4dd782410c9efc76eeebee62401de905bba1d79412132637fd8cff.json b/.sqlx/query-8b7fd5a02f4dd782410c9efc76eeebee62401de905bba1d79412132637fd8cff.json
new file mode 100644
index 0000000000..9580b19740
--- /dev/null
+++ b/.sqlx/query-8b7fd5a02f4dd782410c9efc76eeebee62401de905bba1d79412132637fd8cff.json
@@ -0,0 +1,15 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "UPDATE call_records SET egress_id = $2 WHERE id = $1",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Text"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "8b7fd5a02f4dd782410c9efc76eeebee62401de905bba1d79412132637fd8cff"
+}
diff --git a/.sqlx/query-97f79260c7e63a9f1056b2c914bc0abeaca221705a8ae2976e4a2709dbdb5370.json b/.sqlx/query-97f79260c7e63a9f1056b2c914bc0abeaca221705a8ae2976e4a2709dbdb5370.json
new file mode 100644
index 0000000000..d69c9b32fa
--- /dev/null
+++ b/.sqlx/query-97f79260c7e63a9f1056b2c914bc0abeaca221705a8ae2976e4a2709dbdb5370.json
@@ -0,0 +1,16 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "UPDATE call_meeting_preparations SET meeting_id = $3\n WHERE id = $1 AND user_id = $2 AND meeting_id IS NULL AND expires_at > now()\n AND EXISTS (SELECT 1 FROM call_meetings WHERE id = $3 AND user_id = $2 AND cancelled_at IS NULL)",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Text",
+ "Uuid"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "97f79260c7e63a9f1056b2c914bc0abeaca221705a8ae2976e4a2709dbdb5370"
+}
diff --git a/.sqlx/query-9ff055741dd781c508be9fd8d3f955156c5471feebe2210a4922afd700881ba2.json b/.sqlx/query-9ff055741dd781c508be9fd8d3f955156c5471feebe2210a4922afd700881ba2.json
new file mode 100644
index 0000000000..c66dfe85ad
--- /dev/null
+++ b/.sqlx/query-9ff055741dd781c508be9fd8d3f955156c5471feebe2210a4922afd700881ba2.json
@@ -0,0 +1,16 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "INSERT INTO call_meeting_preparations (id, user_id, expires_at) VALUES ($1, $2, $3)",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Text",
+ "Timestamptz"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "9ff055741dd781c508be9fd8d3f955156c5471feebe2210a4922afd700881ba2"
+}
diff --git a/.sqlx/query-a043b6596229f70fd5bf38f4e8d05c086b929a22d3831f5ea316161fbae27736.json b/.sqlx/query-a043b6596229f70fd5bf38f4e8d05c086b929a22d3831f5ea316161fbae27736.json
new file mode 100644
index 0000000000..28a67360ef
--- /dev/null
+++ b/.sqlx/query-a043b6596229f70fd5bf38f4e8d05c086b929a22d3831f5ea316161fbae27736.json
@@ -0,0 +1,12 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "DELETE FROM call_meeting_preparations WHERE expires_at <= now()",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": []
+ },
+ "nullable": []
+ },
+ "hash": "a043b6596229f70fd5bf38f4e8d05c086b929a22d3831f5ea316161fbae27736"
+}
diff --git a/.sqlx/query-a1a74408775d9c3bffc051811a8a13e2ea0113f4a3feda4cd7635ae7c69ce3c0.json b/.sqlx/query-a1a74408775d9c3bffc051811a8a13e2ea0113f4a3feda4cd7635ae7c69ce3c0.json
new file mode 100644
index 0000000000..ea91bf84c2
--- /dev/null
+++ b/.sqlx/query-a1a74408775d9c3bffc051811a8a13e2ea0113f4a3feda4cd7635ae7c69ce3c0.json
@@ -0,0 +1,28 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "SELECT id, expires_at FROM call_meeting_preparations WHERE meeting_id = $1 AND expires_at > now()",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "id",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 1,
+ "name": "expires_at",
+ "type_info": "Timestamptz"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Uuid"
+ ]
+ },
+ "nullable": [
+ false,
+ false
+ ]
+ },
+ "hash": "a1a74408775d9c3bffc051811a8a13e2ea0113f4a3feda4cd7635ae7c69ce3c0"
+}
diff --git a/apps/web/src/features/meetings/browser/meeting-runtime.ts b/apps/web/src/features/meetings/browser/meeting-runtime.ts
new file mode 100644
index 0000000000..ffbdc44b8b
--- /dev/null
+++ b/apps/web/src/features/meetings/browser/meeting-runtime.ts
@@ -0,0 +1,9 @@
+import { loadLivekit } from '@channel/Call/livekit-loader';
+
+/** Warm only code; no room, microphone, or meeting is created here. */
+export async function preloadMeetingRuntime(): Promise<void> {
+ await Promise.all([
+ loadLivekit(),
+ import('@channel/Call/LivekitJsCallController'),
+ ]);
+}
diff --git a/apps/web/src/features/meetings/context/meeting-session.ts b/apps/web/src/features/meetings/context/meeting-session.ts
index 7c9547c4fe..d95d5f5dbe 100644
--- a/apps/web/src/features/meetings/context/meeting-session.ts
+++ b/apps/web/src/features/meetings/context/meeting-session.ts
@@ -32,6 +32,8 @@ export type MeetingMediaPreferences = {
/** The session owns only the connection it joined, including late replies. */
export type MeetingSessionCapabilities = {
lifecycle: MeetingSessionLifecycle;
+ /** Fetch browser call code during setup, without creating or connecting a call. */
+ warmup?: () => Promise<void>;
shareToken: Accessor<string>;
isInCall: Accessor<boolean>;
activeCallId: Accessor<string | null>;
diff --git a/apps/web/src/features/meetings/context/new-meeting.ts b/apps/web/src/features/meetings/context/new-meeting.ts
index f7ef06eda8..99f15b99e8 100644
--- a/apps/web/src/features/meetings/context/new-meeting.ts
+++ b/apps/web/src/features/meetings/context/new-meeting.ts
@@ -2,9 +2,12 @@ import type { Accessor } from 'solid-js';
import type { MeetingInvitePerson } from './meeting-invite';
export type NewMeeting = { id: string; shareToken: string };
+export type MeetingPreparation = { id: string; expiresAt: string };
export type NewMeetingCapabilities = {
people: Accessor<MeetingInvitePerson[]>;
- create: () => Promise<NewMeeting>;
+ prepareRoom: () => Promise<MeetingPreparation>;
+ cancelRoom: (id: string) => Promise<unknown>;
+ create: (preparationId?: string) => Promise<NewMeeting>;
invite: (shareToken: string, userIds: string[]) => Promise<unknown>;
};
diff --git a/apps/web/src/features/meetings/meeting-route.tsx b/apps/web/src/features/meetings/meeting-route.tsx
index 30eb1db4fa..88d39a4264 100644
--- a/apps/web/src/features/meetings/meeting-route.tsx
+++ b/apps/web/src/features/meetings/meeting-route.tsx
@@ -8,12 +8,15 @@ import { useCallRecordQuery } from '@queries/call/call';
import {
leaveMeeting,
useJoinMeetingMutation,
+ useMeetingParticipantsQuery,
useMeetingQuery,
useUpdateMeetingMutation,
} from '@queries/call/meetings';
import { useLocation, useNavigate, useSearchParams } from '@solidjs/router';
import { Show } from 'solid-js';
import { browserMeetingMedia } from './browser/meeting-media';
+import { preloadMeetingRuntime } from './browser/meeting-runtime';
+import type { MeetingParticipantsState } from './components/meeting-participants';
import type { MeetingPageState } from './context/meeting-session';
import { useMeetingSessionLifecycle } from './context/meeting-session-lifecycle';
import { MeetingPage } from './views/meeting-page';
@@ -32,6 +35,21 @@ export function MeetingRouteContent(props: {
const author = useAuthor();
const userId = useUserId();
const meeting = useMeetingQuery(() => props.shareToken);
+ const participants = useMeetingParticipantsQuery(
+ () => props.shareToken,
+ userId,
+ () =>
+ meeting.isSuccess &&
+ (authenticated() === false ||
+ (authenticated() === true && Boolean(userId()))) &&
+ (meeting.data.channelId === null || authenticated() === true) &&
+ !call.isInCall()
+ );
+ const participantState = (): MeetingParticipantsState => {
+ if (participants.isError) return { kind: 'unavailable' };
+ if (!participants.isSuccess) return { kind: 'loading' };
+ return { kind: 'ready', participants: participants.data.participants };
+ };
const join = useJoinMeetingMutation();
const update = useUpdateMeetingMutation();
const record = useCallRecordQuery(() =>
@@ -64,6 +82,7 @@ export function MeetingRouteContent(props: {
return (
<MeetingPage
source={source}
+ participants={participantState()}
onCallStateChange={props.onCallStateChange}
onLeave={props.onLeave}
mediaAccess={browserMeetingMedia}
@@ -95,6 +114,7 @@ export function MeetingRouteContent(props: {
}}
session={{
lifecycle,
+ warmup: preloadMeetingRuntime,
shareToken: () => props.shareToken,
isInCall: call.isInCall,
activeCallId: call.activeCallId,
diff --git a/apps/web/src/features/meetings/new-meeting-route.tsx b/apps/web/src/features/meetings/new-meeting-route.tsx
index 2a4b050be4..e99338da74 100644
--- a/apps/web/src/features/meetings/new-meeting-route.tsx
+++ b/apps/web/src/features/meetings/new-meeting-route.tsx
@@ -7,7 +7,9 @@ import { readBackgroundImage } from '@core/media/read-background-image';
import { idToDisplayName } from '@core/user/util';
import { useCallRecordQuery } from '@queries/call/call';
import {
+ cancelMeetingPreparation,
leaveMeeting,
+ prepareMeeting,
useCreateMeetingMutation,
useInviteMeetingUsersMutation,
useJoinMeetingMutation,
@@ -16,8 +18,9 @@ import {
} from '@queries/call/meetings';
import { useNavigate } from '@solidjs/router';
import { Button } from '@ui';
-import { Show, Suspense } from 'solid-js';
+import { onCleanup, Show, Suspense } from 'solid-js';
import { browserMeetingMedia } from './browser/meeting-media';
+import { preloadMeetingRuntime } from './browser/meeting-runtime';
import type { MeetingPageState } from './context/meeting-session';
import { useMeetingSessionLifecycle } from './context/meeting-session-lifecycle';
import { createNewMeeting } from './primitives/new-meeting';
@@ -40,10 +43,23 @@ function NewMeetingSetup(props: {
const update = useUpdateMeetingMutation();
const draft = createNewMeeting({
people: people.people,
- create: () => create.mutateAsync({ title: 'Quick Call' }),
+ prepareRoom: prepareMeeting,
+ cancelRoom: cancelMeetingPreparation,
+ create: (preparationId) =>
+ create.mutateAsync({ title: 'Quick Call', preparationId }),
invite: (shareToken, userIds) =>
invite.mutateAsync({ shareToken, userIds }),
});
+ const onPageShow = (event: PageTransitionEvent) => {
+ // Back/forward cache restores the same component, whose old room was cancelled.
+ if (event.persisted) void draft.warmup();
+ };
+ window.addEventListener('pagehide', draft.cancel);
+ window.addEventListener('pageshow', onPageShow);
+ onCleanup(() => {
+ window.removeEventListener('pagehide', draft.cancel);
+ window.removeEventListener('pageshow', onPageShow);
+ });
const shareToken = () => draft.meeting()?.shareToken ?? '';
const meeting = useMeetingQuery(shareToken);
const record = useCallRecordQuery(() => call.activeCallId() ?? '');
@@ -111,6 +127,9 @@ function NewMeetingSetup(props: {
)}
session={{
lifecycle,
+ warmup: async () => {
+ await Promise.all([preloadMeetingRuntime(), draft.warmup()]);
+ },
shareToken,
prepare: draft.prepare,
isInCall: call.isInCall,
@@ -123,7 +142,9 @@ function NewMeetingSetup(props: {
useBrowserSession: true,
});
if (call.isInCall() && call.activeCallId() === credentials.callId) {
- await draft.ring();
+ // Invitations report failures in the call; they must not hold
+ // the host on the setup screen after LiveKit connects.
+ void draft.ring();
}
},
disconnect: call.meetingSession.disconnect,
diff --git a/apps/web/src/features/meetings/primitives/meeting-session.test.ts b/apps/web/src/features/meetings/primitives/meeting-session.test.ts
index 5703fb034d..f18c8018a1 100644
--- a/apps/web/src/features/meetings/primitives/meeting-session.test.ts
+++ b/apps/web/src/features/meetings/primitives/meeting-session.test.ts
@@ -1,6 +1,7 @@
// @vitest-environment jsdom
+import { Telemetry } from '@macro-inc/observability';
import { createRoot } from 'solid-js';
-import { describe, expect, it, vi } from 'vitest';
+import { afterEach, describe, expect, it, vi } from 'vitest';
import type {
MeetingCredentials,
MeetingSessionCapabilities,
@@ -20,6 +21,8 @@ const token: MeetingCredentials = {
};
const preferences = { microphoneEnabled: false, cameraEnabled: false };
+afterEach(() => vi.restoreAllMocks());
+
function setup(overrides: Partial<MeetingSessionCapabilities> = {}) {
let activeCallId: string | null = null;
const capabilities: MeetingSessionCapabilities = {
@@ -53,6 +56,72 @@ function setup(overrides: Partial<MeetingSessionCapabilities> = {}) {
}
describe('meeting session ownership', () => {
+ it('starts releasing credentials before waiting for the media disconnect', async () => {
+ let finish!: () => void;
+ const { session, capabilities, dispose } = setup({
+ disconnect: () =>
+ new Promise<void>((resolve) => {
+ finish = resolve;
+ }),
+ });
+ await session.join(undefined, preferences);
+ const leaving = session.leave();
+ expect(capabilities.release).toHaveBeenCalledExactlyOnceWith(
+ token.shareToken,
+ token.token
+ );
+ finish();
+ await leaving;
+ dispose();
+ });
+
+ it('traces connection phases and ends with the connected outcome', async () => {
+ const trace = Telemetry.span('test');
+ vi.spyOn(Telemetry, 'span').mockReturnValue(trace);
+ const phases = vi.spyOn(trace, 'span');
+ const attributes = vi.spyOn(trace, 'setAttr');
+ const end = vi.spyOn(trace, 'end');
+ const { session, dispose } = setup({ prepare: async () => {} });
+
+ await session.join(undefined, preferences);
+
+ expect(phases.mock.calls.map(([name]) => name)).toEqual([
+ 'meeting.join.previous_session',
+ 'meeting.join.create',
+ 'meeting.join.credentials',
+ 'meeting.join.connect',
+ ]);
+ expect(attributes).toHaveBeenCalledWith('call.id', token.callId);
+ expect(attributes).toHaveBeenCalledWith(
+ 'meeting.join.outcome',
+ 'connected'
+ );
+ expect(end).toHaveBeenCalledOnce();
+ dispose();
+ });
+
+ it('ends failed join traces without exporting provider credentials', async () => {
+ const trace = Telemetry.span('test');
+ vi.spyOn(Telemetry, 'span').mockReturnValue(trace);
+ const error = vi.spyOn(trace, 'error');
+ const attributes = vi.spyOn(trace, 'setAttr');
+ const end = vi.spyOn(trace, 'end');
+ vi.spyOn(console, 'error').mockImplementation(() => {});
+ const { session, dispose } = setup({
+ join: async () => {
+ throw new Error(`Provider failed with ${token.token}`);
+ },
+ });
+
+ await session.join(undefined, preferences);
+
+ expect(error).toHaveBeenCalledExactlyOnceWith('Meeting join failed');
+ expect(attributes).toHaveBeenCalledWith('meeting.join.outcome', 'failed');
+ expect(JSON.stringify(attributes.mock.calls)).not.toContain(token.token);
+ expect(end).toHaveBeenCalledOnce();
+ dispose();
+ });
+
it('prepares only when joining and retains the prepared invitation for release', async () => {
let shareToken = '';
let finishPrepare!: () => void;
diff --git a/apps/web/src/features/meetings/primitives/meeting-session.ts b/apps/web/src/features/meetings/primitives/meeting-session.ts
index db1f54fd92..c7d6f42f86 100644
--- a/apps/web/src/features/meetings/primitives/meeting-session.ts
+++ b/apps/web/src/features/meetings/primitives/meeting-session.ts
@@ -1,3 +1,4 @@
+import { Telemetry } from '@macro-inc/observability';
import { createSignal, onCleanup } from 'solid-js';
import type {
MeetingCredentials,
@@ -76,23 +77,40 @@ export function createMeetingSession(capabilities: MeetingSessionCapabilities) {
const previousSession = issuedSession;
issuedSession = undefined;
let issued: IssuedMeetingSession | undefined;
+ const joinTrace = Telemetry.span('meeting.join');
+ joinTrace.setAttr(
+ 'meeting.join.kind',
+ capabilities.prepare ? 'create' : 'join'
+ );
+ joinTrace.setAttr('meeting.join.guest', displayName !== undefined);
+ joinTrace.setAttr('meeting.join.microphone', preferences.microphoneEnabled);
+ joinTrace.setAttr('meeting.join.camera', preferences.cameraEnabled);
+ joinTrace.setAttr('meeting.join.outcome', 'cancelled');
try {
- await attemptLifecycle.previous;
- if (previousSession) await release(previousSession);
+ await joinTrace.span('meeting.join.previous_session', async () => {
+ await attemptLifecycle.previous;
+ if (previousSession) await release(previousSession);
+ });
if (disposed || attempt !== generation) return;
// A previous owner may still have been disconnecting when Join was
// clicked. Check the shared call state after its cleanup has finished.
if (capabilities.isInCall()) {
+ joinTrace.setAttr('meeting.join.outcome', 'already_in_call');
setError('Leave your current call before joining this one.');
return;
}
- if (capabilities.prepare) {
- await capabilities.prepare(controller.signal);
+ const prepare = capabilities.prepare;
+ if (prepare) {
+ await joinTrace.span('meeting.join.create', () =>
+ prepare(controller.signal)
+ );
if (disposed || attempt !== generation) return;
}
const shareToken = capabilities.shareToken();
issued = {
- credentials: await capabilities.join(displayName?.trim()),
+ credentials: await joinTrace.span('meeting.join.credentials', () =>
+ capabilities.join(displayName?.trim())
+ ),
shareToken,
};
if (disposed || attempt !== generation) {
@@ -100,14 +118,24 @@ export function createMeetingSession(capabilities: MeetingSessionCapabilities) {
return;
}
issuedSession = issued;
+ joinTrace.setAttr('call.id', issued.credentials.callId);
const localTracks = claimLocalTracks();
- await capabilities.connect(
- issued.credentials,
- localTracks ? { ...preferences, localTracks } : preferences
+ const credentials = issued.credentials;
+ await joinTrace.span('meeting.join.connect', () =>
+ capabilities.connect(
+ credentials,
+ localTracks ? { ...preferences, localTracks } : preferences
+ )
);
if (disposed || attempt !== generation) return;
setJoinedCallId(issued.credentials.callId);
+ joinTrace.setAttr('meeting.join.outcome', 'connected');
} catch (cause) {
+ // Provider errors may include credentials or a capability URL.
+ if (!disposed && attempt === generation) {
+ joinTrace.error('Meeting join failed');
+ joinTrace.setAttr('meeting.join.outcome', 'failed');
+ }
if (issued && issuedSession === issued) {
issuedSession = undefined;
try {
@@ -128,6 +156,7 @@ export function createMeetingSession(capabilities: MeetingSessionCapabilities) {
setError('Could not join the call. Check your connection and try again.');
console.error('Failed to join meeting', cause);
} finally {
+ joinTrace.end();
// Keep the signal abortable for connected actions such as retrying invites.
// A failed attempt has no session left that can own those actions.
if (
@@ -154,6 +183,9 @@ export function createMeetingSession(capabilities: MeetingSessionCapabilities) {
setJoinedCallId(undefined);
setHasLeft(true);
}
+ // Start the keepalive release before awaiting local RTC disconnection:
+ // navigation or tab closure must not strand server-side participation.
+ const releasing = session ? release(session) : undefined;
try {
// Cancellation must not wait for the token request it is cancelling.
// The shared lifecycle still retains that attempt independently.
@@ -168,7 +200,7 @@ export function createMeetingSession(capabilities: MeetingSessionCapabilities) {
console.error('Failed to disconnect meeting', cause);
} finally {
try {
- if (session) await release(session);
+ await releasing;
} finally {
cleanupLifecycle.complete();
}
diff --git a/apps/web/src/features/meetings/primitives/new-meeting.test.ts b/apps/web/src/features/meetings/primitives/new-meeting.test.ts
index 7b41b20b28..f7001fdc93 100644
--- a/apps/web/src/features/meetings/primitives/new-meeting.test.ts
+++ b/apps/web/src/features/meetings/primitives/new-meeting.test.ts
@@ -48,7 +48,19 @@ function setup(overrides: Partial<NewMeetingCapabilities> = {}) {
const invite = vi.fn(async () => {
events.push('ring');
});
- const draft = createNewMeeting({ people, create, invite, ...overrides });
+ const prepareRoom = vi.fn(async () => ({
+ id: 'prepared-room',
+ expiresAt: new Date(Date.now() + 300_000).toISOString(),
+ }));
+ const cancelRoom = vi.fn(async () => undefined);
+ const draft = createNewMeeting({
+ people,
+ create,
+ invite,
+ prepareRoom,
+ cancelRoom,
+ ...overrides,
+ });
const join = vi.fn(async () => {
events.push('join');
return credentials;
@@ -67,7 +79,7 @@ function setup(overrides: Partial<NewMeetingCapabilities> = {}) {
join,
connect: async () => {
await connect();
- await draft.ring();
+ void draft.ring();
},
disconnect: async () => {
setActiveCallId(null);
@@ -83,12 +95,91 @@ function setup(overrides: Partial<NewMeetingCapabilities> = {}) {
connect,
release,
events,
+ prepareRoom,
+ cancelRoom,
+ dispose,
setPeople,
};
});
}
describe('new meeting setup', () => {
+ it('can warm a restored setup without reusing its cancelled room', async () => {
+ const { draft, prepareRoom, cancelRoom } = setup();
+ await draft.warmup();
+ draft.cancel();
+ await draft.warmup();
+ expect(cancelRoom).toHaveBeenCalledOnce();
+ expect(prepareRoom).toHaveBeenCalledTimes(2);
+ });
+
+ it('prepares once without creating or inviting, then claims the room on Start', async () => {
+ const { draft, create, invite, prepareRoom, cancelRoom, dispose } = setup();
+ await Promise.all([draft.warmup(), draft.warmup()]);
+ expect(prepareRoom).toHaveBeenCalledOnce();
+ expect(create).not.toHaveBeenCalled();
+ expect(invite).not.toHaveBeenCalled();
+ await draft.prepare(new AbortController().signal);
+ expect(create).toHaveBeenCalledExactlyOnceWith('prepared-room');
+ dispose();
+ expect(cancelRoom).not.toHaveBeenCalled();
+ });
+
+ it('cancels an unused room including a preparation that finishes after disposal', async () => {
+ for (const late of [false, true]) {
+ let finish!: (room: { id: string; expiresAt: string }) => void;
+ const prepareRoom = () =>
+ new Promise<{ id: string; expiresAt: string }>((resolve) => {
+ finish = resolve;
+ });
+ const { draft, dispose, cancelRoom, create } = setup({ prepareRoom });
+ const warming = draft.warmup();
+ if (late) dispose();
+ finish({
+ id: 'unused',
+ expiresAt: new Date(Date.now() + 300_000).toISOString(),
+ });
+ await warming;
+ if (!late) dispose();
+ expect(cancelRoom).toHaveBeenCalledExactlyOnceWith('unused');
+ expect(create).not.toHaveBeenCalled();
+ }
+ });
+
+ it('falls back to ordinary creation when preparation fails or expires', async () => {
+ for (const failed of [false, true]) {
+ const { draft, create } = setup({
+ prepareRoom: async () => {
+ if (failed) throw new Error('offline');
+ return { id: 'expired', expiresAt: new Date(0).toISOString() };
+ },
+ });
+ await draft.warmup();
+ await draft.prepare(new AbortController().signal);
+ expect(create).toHaveBeenCalledExactlyOnceWith(undefined);
+ }
+ });
+
+ it('does not create a meeting when Start is cancelled during room preparation', async () => {
+ let finish!: (room: { id: string; expiresAt: string }) => void;
+ const { draft, create } = setup({
+ prepareRoom: () =>
+ new Promise((resolve) => {
+ finish = resolve;
+ }),
+ });
+ const warming = draft.warmup();
+ const attempt = new AbortController();
+ const starting = draft.prepare(attempt.signal);
+ attempt.abort();
+ finish({
+ id: 'unused',
+ expiresAt: new Date(Date.now() + 300_000).toISOString(),
+ });
+ await Promise.all([starting, warming]);
+ expect(create).not.toHaveBeenCalled();
+ });
+
it('keeps selection local until Start, then creates, connects and rings once', async () => {
const { draft, session, create, invite, events } = setup();
draft.select(new Set([alice.id, bob.id]));
@@ -106,6 +197,24 @@ describe('new meeting setup', () => {
expect(session.joinedCallId()).toBe(credentials.callId);
});
+ it('enters the connected call while invitations are still pending', async () => {
+ let finish!: () => void;
+ const invite = vi.fn(
+ () =>
+ new Promise<void>((resolve) => {
+ finish = resolve;
+ })
+ );
+ const { draft, session } = setup({ invite });
+ draft.select(new Set([alice.id]));
+ await session.join(undefined, preferences);
+ expect(session.joining()).toBe(false);
+ expect(session.joinedCallId()).toBe(credentials.callId);
+ expect(draft.inviting()).toBe(true);
+ finish();
+ await vi.waitFor(() => expect(draft.inviting()).toBe(false));
+ });
+
it('starts without invitees and reuses its meeting without ringing again on rejoin', async () => {
const { draft, session, create, invite } = setup();
await session.join(undefined, preferences);
diff --git a/apps/web/src/features/meetings/primitives/new-meeting.ts b/apps/web/src/features/meetings/primitives/new-meeting.ts
index bce084d460..3684a7f68f 100644
--- a/apps/web/src/features/meetings/primitives/new-meeting.ts
+++ b/apps/web/src/features/meetings/primitives/new-meeting.ts
@@ -1,12 +1,13 @@
-import { createSignal } from 'solid-js';
+import { createSignal, onCleanup } from 'solid-js';
import type {
+ MeetingPreparation,
NewMeeting,
NewMeetingCapabilities,
} from '../context/new-meeting';
const MAX_INVITEES = 50;
-/** Draft selection is local; only Start Call prepares a persistent meeting. */
+/** Setup reserves an empty room; only Start Call creates a meeting and invitations. */
export function createNewMeeting(capabilities: NewMeetingCapabilities) {
const [meeting, setMeeting] = createSignal<NewMeeting>();
const [selected, setSelected] = createSignal(new Set<string>());
@@ -16,6 +17,48 @@ export function createNewMeeting(capabilities: NewMeetingCapabilities) {
const sent = new Set<string>();
let recipients: string[] = [];
let attemptSignal: AbortSignal | undefined;
+ let reservation: MeetingPreparation | undefined;
+ let warming: Promise<void> | undefined;
+ let disposed = false;
+ let preparationGeneration = 0;
+
+ async function cancelRoom(id: string) {
+ try {
+ await capabilities.cancelRoom(id);
+ } catch {
+ // The server also expires unused rooms if the browser goes offline.
+ }
+ }
+
+ function cancel() {
+ preparationGeneration += 1;
+ if (reservation) void cancelRoom(reservation.id);
+ reservation = undefined;
+ warming = undefined;
+ }
+ onCleanup(() => {
+ disposed = true;
+ cancel();
+ });
+
+ function warmup(): Promise<void> {
+ if (disposed || meeting() || reservation) return Promise.resolve();
+ if (warming) return warming;
+ const generation = preparationGeneration;
+ warming = (async () => {
+ try {
+ const room = await capabilities.prepareRoom();
+ if (disposed || generation !== preparationGeneration)
+ await cancelRoom(room.id);
+ else reservation = room;
+ } catch {
+ // Starting still works through the normal room creation path.
+ } finally {
+ if (generation === preparationGeneration) warming = undefined;
+ }
+ })();
+ return warming;
+ }
function select(values: Set<string>) {
const eligible = new Set(capabilities.people().map((person) => person.id));
@@ -37,7 +80,18 @@ export function createNewMeeting(capabilities: NewMeetingCapabilities) {
);
setInviteError(undefined);
// A retry after a cancelled/failed join keeps the already-created link.
- if (!meeting()) setMeeting(await capabilities.create());
+ if (!meeting()) {
+ const generation = preparationGeneration;
+ await warming;
+ if (signal.aborted || disposed) return;
+ if (generation !== preparationGeneration)
+ throw new Error('Call setup closed');
+ const room = reservation;
+ const preparationId =
+ room && Date.parse(room.expiresAt) > Date.now() ? room.id : undefined;
+ setMeeting(await capabilities.create(preparationId));
+ reservation = undefined;
+ }
}
/** Invitation failure does not tear down a successfully connected call. */
@@ -69,6 +123,8 @@ export function createNewMeeting(capabilities: NewMeetingCapabilities) {
inviteError,
inviting,
prepare,
+ warmup,
+ cancel,
ring,
};
}
diff --git a/apps/web/src/features/meetings/views/meeting-page-auth.test.tsx b/apps/web/src/features/meetings/views/meeting-page-auth.test.tsx
index ce9d296fe2..14bd5a7d31 100644
--- a/apps/web/src/features/meetings/views/meeting-page-auth.test.tsx
+++ b/apps/web/src/features/meetings/views/meeting-page-auth.test.tsx
@@ -12,6 +12,7 @@ it('waits for confirmed membership before rendering setup or requesting devices'
const request = vi.fn(async () => {
throw new DOMException('Denied', 'NotAllowedError');
});
+ const warmup = vi.fn(async () => {});
const join = vi.fn(async () => {
throw new Error('Must not join automatically');
});
@@ -30,6 +31,7 @@ it('waits for confirmed membership before rendering setup or requesting devices'
mediaAccess={{ request }}
session={{
lifecycle: createMeetingSessionLifecycle(),
+ warmup,
shareToken: () => 'token',
isInCall: () => false,
activeCallId: () => null,
@@ -43,11 +45,14 @@ it('waits for confirmed membership before rendering setup or requesting devices'
));
expect(screen.queryByRole('textbox', { name: 'Your name' })).toBeNull();
expect(request).not.toHaveBeenCalled();
+ expect(warmup).not.toHaveBeenCalled();
setAuthenticated(false);
expect(request).not.toHaveBeenCalled();
+ expect(warmup).not.toHaveBeenCalled();
expect(screen.getByRole('button', { name: 'Sign in' })).toBeTruthy();
setAuthenticated(true);
await waitFor(() => expect(request).toHaveBeenCalled());
expect(screen.getByRole('button', { name: 'Join call' })).toBeTruthy();
expect(join).not.toHaveBeenCalled();
+ expect(warmup).toHaveBeenCalledOnce();
});
diff --git a/apps/web/src/features/meetings/views/meeting-page.tsx b/apps/web/src/features/meetings/views/meeting-page.tsx
index b9b2485af8..da0f8ebee1 100644
--- a/apps/web/src/features/meetings/views/meeting-page.tsx
+++ b/apps/web/src/features/meetings/views/meeting-page.tsx
@@ -75,6 +75,15 @@ export function MeetingPage(props: {
createEffect(on(inCall, (connected) => props.onCallStateChange?.(connected)));
+ async function warmup() {
+ try {
+ await props.session.warmup?.();
+ } catch (error) {
+ // The shared loader clears a failed import so Join can retry it.
+ console.warn('[meeting] call runtime preload failed', error);
+ }
+ }
+
createEffect(
on(
() =>
@@ -84,8 +93,10 @@ export function MeetingPage(props: {
!session.joining() &&
!leaving(),
(setup) => {
- if (setup) void media.prepare();
- else media.release();
+ if (setup) {
+ void media.prepare();
+ void warmup();
+ } else media.release();
}
)
);
diff --git a/apps/web/src/lib/queries/call/keys.ts b/apps/web/src/lib/queries/call/keys.ts
index d6193e4e98..ca2a9a26c9 100644
--- a/apps/web/src/lib/queries/call/keys.ts
+++ b/apps/web/src/lib/queries/call/keys.ts
@@ -14,6 +14,14 @@ export const callKeys = {
}),
{ _def: meeting }
),
+ meetingParticipants: (shareToken: string, viewerId: string | undefined) => ({
+ queryKey: [
+ ...meeting,
+ shareToken,
+ 'participants',
+ viewerId ?? 'guest',
+ ] as const,
+ }),
link: Object.assign(
(callId: string) => ({
queryKey: [...link, callId] as const,
diff --git a/apps/web/src/lib/queries/call/meetings.ts b/apps/web/src/lib/queries/call/meetings.ts
index b168ddfa36..e4f685c075 100644
--- a/apps/web/src/lib/queries/call/meetings.ts
+++ b/apps/web/src/lib/queries/call/meetings.ts
@@ -18,6 +18,29 @@ export function useMeetingQuery(shareToken: Accessor<string>) {
}));
}
+/** Poll only while setup is visible, with separate caches for guests and members. */
+export function useMeetingParticipantsQuery(
+ shareToken: Accessor<string>,
+ viewerId: Accessor<string | undefined>,
+ enabled: Accessor<boolean>
+) {
+ return useQuery(() => ({
+ queryKey: callKeys.meetingParticipants(shareToken(), viewerId()).queryKey,
+ queryFn: () =>
+ throwOnErr(() =>
+ callServiceClient.getMeetingParticipants(
+ shareToken(),
+ Boolean(viewerId())
+ )
+ ),
+ enabled: Boolean(shareToken()) && enabled(),
+ refetchInterval: 15_000,
+ staleTime: 0,
+ gcTime: 0,
+ retry: false,
+ }));
+}
+
export function useInviteMeetingUsersMutation() {
return useMutation(() => ({
gcTime: 0,
@@ -51,6 +74,14 @@ export function useCreateMeetingMutation() {
}));
}
+export function prepareMeeting() {
+ return throwOnErr(() => callServiceClient.prepareMeeting());
+}
+
+export function cancelMeetingPreparation(id: string) {
+ return throwOnErr(() => callServiceClient.cancelMeetingPreparation(id));
+}
+
export function useActiveMeetingsQuery(userId: Accessor<string | undefined>) {
return useQuery(() => ({
queryKey: [...callKeys.activeMeetings.queryKey, userId() ?? ''],
diff --git a/apps/web/src/lib/service-clients/service-call/client.test.ts b/apps/web/src/lib/service-clients/service-call/client.test.ts
index 51d0d6c247..fa61ecaefc 100644
--- a/apps/web/src/lib/service-clients/service-call/client.test.ts
+++ b/apps/web/src/lib/service-clients/service-call/client.test.ts
@@ -74,6 +74,7 @@ describe('meeting transport authorization', () => {
'https://gateway.example/dss/call/join/secret/leave',
{
method: 'POST',
+ keepalive: true,
credentials: 'omit',
headers: { Authorization: 'Bearer scoped-room-token' },
}
@@ -81,3 +82,19 @@ describe('meeting transport authorization', () => {
expect(requests.authenticated).not.toHaveBeenCalled();
});
});
+
+it('previews members through the authenticated endpoint without joining', async () => {
+ await callServiceClient.getMeetingParticipants('secret', true);
+ expect(requests.authenticated).toHaveBeenCalledWith(
+ 'https://gateway.example/dss/call/meetings/join/secret/participants'
+ );
+ expect(requests.public).not.toHaveBeenCalled();
+});
+it('previews guests without account credentials or a join request', async () => {
+ await callServiceClient.getMeetingParticipants('secret', false);
+ expect(requests.public).toHaveBeenCalledWith(
+ 'https://gateway.example/dss/call/join/secret/participants',
+ { credentials: 'omit' }
+ );
+ expect(requests.authenticated).not.toHaveBeenCalled();
+});
diff --git a/apps/web/src/lib/service-clients/service-call/client.ts b/apps/web/src/lib/service-clients/service-call/client.ts
index d3c41d37c3..6261856285 100644
--- a/apps/web/src/lib/service-clients/service-call/client.ts
+++ b/apps/web/src/lib/service-clients/service-call/client.ts
@@ -12,6 +12,7 @@ import type { EditCallRecordRequest } from '@service-storage/generated/schemas/e
import type { InviteMeetingUsersRequest } from '@service-storage/generated/schemas/inviteMeetingUsersRequest';
import type { LeaveCallResponse } from '@service-storage/generated/schemas/leaveCallResponse';
import type { Meeting as ApiMeeting } from '@service-storage/generated/schemas/meeting';
+import type { MeetingPreparation } from '@service-storage/generated/schemas/meetingPreparation';
import type { UpdateMeetingRequest } from '@service-storage/generated/schemas/updateMeetingRequest';
import type { UpdateSharePermissionRequestV2 } from '@service-storage/generated/schemas/updateSharePermissionRequestV2';
@@ -22,9 +23,25 @@ export type CallTokenResponse = Required<ApiCallTokenResponse>;
export type Meeting = Required<ApiMeeting>;
export type ActiveMeeting = Required<ApiActiveMeeting>;
+/** Display-only waiting-room data; no account identities or call contents. */
+export type MeetingParticipants = {
+ participants: { displayName: string; avatarUrl: string | null }[];
+};
+
const host: string = SERVER_HOSTS['document-storage-service'];
export const callServiceClient = {
+ prepareMeeting() {
+ return fetchWithToken<MeetingPreparation>(`${host}/call/meetings/prepare`, {
+ method: 'POST',
+ });
+ },
+ cancelMeetingPreparation(id: string) {
+ return fetchWithToken<Record<string, never>>(
+ `${host}/call/meetings/prepare/${encodeURIComponent(id)}`,
+ { method: 'DELETE', keepalive: true }
+ );
+ },
inviteMeetingUsers(shareToken: string, userIds: string[]) {
const body: InviteMeetingUsersRequest = { userIds };
return fetchWithToken<Record<string, never>>(
@@ -111,6 +128,15 @@ export const callServiceClient = {
);
},
+ getMeetingParticipants(shareToken: string, authenticated: boolean) {
+ const path = `/join/${encodeURIComponent(shareToken)}/participants`;
+ return authenticated
+ ? fetchWithToken<MeetingParticipants>(`${host}/call/meetings${path}`)
+ : safeFetch<MeetingParticipants>(`${host}/call${path}`, {
+ credentials: 'omit',
+ });
+ },
+
joinMeeting(shareToken: string) {
return fetchWithToken<CallTokenResponse>(
`${host}/call/meetings/join/${encodeURIComponent(shareToken)}`,
@@ -134,6 +160,7 @@ export const callServiceClient = {
`${host}/call/join/${encodeURIComponent(shareToken)}/leave`,
{
method: 'POST',
+ keepalive: true,
credentials: 'omit',
headers: { Authorization: `Bearer ${token}` },
}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/createMeetingRequest.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/createMeetingRequest.ts
index 81d301183e..af391946a5 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/createMeetingRequest.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/createMeetingRequest.ts
@@ -4,6 +4,7 @@
* document_storage_service
* OpenAPI spec version: 0.1.0
*/
+import type { CreateMeetingRequestPreparationId } from './createMeetingRequestPreparationId';
import type { CreateMeetingRequestScheduledEnd } from './createMeetingRequestScheduledEnd';
import type { CreateMeetingRequestScheduledStart } from './createMeetingRequestScheduledStart';
import type { CreateMeetingRequestTitle } from './createMeetingRequestTitle';
@@ -12,6 +13,8 @@ import type { CreateMeetingRequestTitle } from './createMeetingRequestTitle';
* Inputs for creating a meeting without starting its RTC room.
*/
export interface CreateMeetingRequest {
+ /** Optional unused room reserved by this actor on the setup screen. */
+ preparationId?: CreateMeetingRequestPreparationId;
/** Optional scheduled end. */
scheduledEnd?: CreateMeetingRequestScheduledEnd;
/** Optional scheduled start. */
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/createMeetingRequestPreparationId.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/createMeetingRequestPreparationId.ts
new file mode 100644
index 0000000000..2a170ab122
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/createMeetingRequestPreparationId.ts
@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * Optional unused room reserved by this actor on the setup screen.
+ */
+export type CreateMeetingRequestPreparationId = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
index 34d1eb1a98..add816443d 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
@@ -460,6 +460,7 @@ export * from './createMarkdownDocumentRequestProjectId';
export * from './createMarkdownDocumentResponse';
export * from './createMarkdownHandler200';
export * from './createMeetingRequest';
+export * from './createMeetingRequestPreparationId';
export * from './createMeetingRequestScheduledEnd';
export * from './createMeetingRequestScheduledStart';
export * from './createMeetingRequestTitle';
@@ -934,6 +935,10 @@ export * from './meeting';
export * from './meetingCallId';
export * from './meetingChannelId';
export * from './meetingInvitePermissions';
+export * from './meetingParticipant';
+export * from './meetingParticipantAvatarUrl';
+export * from './meetingParticipants';
+export * from './meetingPreparation';
export * from './meetingScheduledEnd';
export * from './meetingScheduledStart';
export * from './meetingsResponse';
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingParticipant.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingParticipant.ts
new file mode 100644
index 0000000000..7874c3e986
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingParticipant.ts
@@ -0,0 +1,17 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { MeetingParticipantAvatarUrl } from './meetingParticipantAvatarUrl';
+
+/**
+ * Minimal waiting-room display data, without account identities or call content.
+ */
+export interface MeetingParticipant {
+ /** Profile image, when available for a Macro member. */
+ avatarUrl?: MeetingParticipantAvatarUrl;
+ /** Name displayed in the waiting room. */
+ displayName: string;
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingParticipantAvatarUrl.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingParticipantAvatarUrl.ts
new file mode 100644
index 0000000000..c14d1a2358
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingParticipantAvatarUrl.ts
@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * Profile image, when available for a Macro member.
+ */
+export type MeetingParticipantAvatarUrl = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingParticipants.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingParticipants.ts
new file mode 100644
index 0000000000..ffb2666abf
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingParticipants.ts
@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { MeetingParticipant } from './meetingParticipant';
+
+/**
+ * People currently connected to a meeting's room.
+ */
+export interface MeetingParticipants {
+ /** Human attendees only; transcription agents are excluded. */
+ participants: MeetingParticipant[];
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingPreparation.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingPreparation.ts
new file mode 100644
index 0000000000..4dd01e7a54
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/meetingPreparation.ts
@@ -0,0 +1,16 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * An empty room reservation, not a started call or an invitation.
+ */
+export interface MeetingPreparation {
+ /** After this deadline Start falls back to ordinary room creation. */
+ expiresAt: string;
+ /** Also the reserved RTC room's UUID and prospective call ID. */
+ id: string;
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/zod.ts b/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
index f62da19b0d..14f63f64f7 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
@@ -1978,6 +1978,35 @@ export const meetingLeaveResponse = zod
})
.describe('Response for the leave\/end call operation.');
+/**
+ * @summary Read a standalone meeting preview without admitting a guest to the room.
+ */
+export const meetingGuestParticipantsParams = zod.object({
+ token: zod.string(),
+});
+
+export const meetingGuestParticipantsResponse = zod
+ .object({
+ participants: zod
+ .array(
+ zod
+ .object({
+ avatarUrl: zod
+ .string()
+ .nullish()
+ .describe('Profile image, when available for a Macro member.'),
+ displayName: zod
+ .string()
+ .describe('Name displayed in the waiting room.'),
+ })
+ .describe(
+ 'Minimal waiting-room display data, without account identities or call content.'
+ )
+ )
+ .describe('Human attendees only; transcription agents are excluded.'),
+ })
+ .describe("People currently connected to a meeting's room.");
+
/**
* @summary Handle `GET /call/meetings` through the call domain service.
*/
@@ -2028,6 +2057,12 @@ export const meetingListResponse = zod
*/
export const meetingCreateBody = zod
.object({
+ preparationId: zod
+ .uuid()
+ .nullish()
+ .describe(
+ 'Optional unused room reserved by this actor on the setup screen.'
+ ),
scheduledEnd: zod.iso
.datetime({})
.nullish()
@@ -2207,6 +2242,58 @@ export const meetingJoinResponse = zod
})
.describe('Response returned when creating or joining a call.');
+/**
+ * @summary Read the participant preview for an authenticated invitation holder.
+ */
+export const meetingParticipantsParams = zod.object({
+ token: zod.string(),
+});
+
+export const meetingParticipantsResponse = zod
+ .object({
+ participants: zod
+ .array(
+ zod
+ .object({
+ avatarUrl: zod
+ .string()
+ .nullish()
+ .describe('Profile image, when available for a Macro member.'),
+ displayName: zod
+ .string()
+ .describe('Name displayed in the waiting room.'),
+ })
+ .describe(
+ 'Minimal waiting-room display data, without account identities or call content.'
+ )
+ )
+ .describe('Human attendees only; transcription agents are excluded.'),
+ })
+ .describe("People currently connected to a meeting's room.");
+
+/**
+ * @summary Reserve a room while the authenticated caller configures a new call.
+ */
+export const meetingPrepareResponse = zod
+ .object({
+ expiresAt: zod.iso
+ .datetime({})
+ .describe(
+ 'After this deadline Start falls back to ordinary room creation.'
+ ),
+ id: zod
+ .uuid()
+ .describe("Also the reserved RTC room's UUID and prospective call ID."),
+ })
+ .describe('An empty room reservation, not a started call or an invitation.');
+
+/**
+ * @summary Cancel an unused room; the domain owns ownership and activation checks.
+ */
+export const meetingCancelPreparationParams = zod.object({
+ preparation_id: zod.uuid(),
+});
+
/**
* @summary Handle `DELETE /call/meetings/{meeting_id}` through the call domain service.
*/
diff --git a/apps/web/src/lib/service-clients/service-storage/openapi.json b/apps/web/src/lib/service-clients/service-storage/openapi.json
index 05380a2773..a42d94634c 100644
--- a/apps/web/src/lib/service-clients/service-storage/openapi.json
+++ b/apps/web/src/lib/service-clients/service-storage/openapi.json
@@ -1421,6 +1421,55 @@
}
}
},
+ "/call/join/{token}/participants": {
+ "get": {
+ "tags": ["call::inbound::axum_router::meetings"],
+ "summary": "Read a standalone meeting preview without admitting a guest to the room.",
+ "operationId": "meeting_guest_participants",
+ "parameters": [
+ {
+ "name": "token",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/MeetingParticipants"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/call/meetings": {
"get": {
"tags": ["call::inbound::axum_router::meetings"],
@@ -1816,6 +1865,107 @@
}
}
},
+ "/call/meetings/join/{token}/participants": {
+ "get": {
+ "tags": ["call::inbound::axum_router::meetings"],
+ "summary": "Read the participant preview for an authenticated invitation holder.",
+ "operationId": "meeting_participants",
+ "parameters": [
+ {
+ "name": "token",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/MeetingParticipants"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/call/meetings/prepare": {
+ "post": {
+ "tags": ["call::inbound::axum_router::meetings"],
+ "summary": "Reserve a room while the authenticated caller configures a new call.",
+ "operationId": "meeting_prepare",
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/MeetingPreparation"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/call/meetings/prepare/{preparation_id}": {
+ "delete": {
+ "tags": ["call::inbound::axum_router::meetings"],
+ "summary": "Cancel an unused room; the domain owns ownership and activation checks.",
+ "operationId": "meeting_cancel_preparation",
+ "parameters": [
+ {
+ "name": "preparation_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": ""
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/call/meetings/{meeting_id}": {
"delete": {
"tags": ["call::inbound::axum_router::meetings"],
@@ -20883,6 +21033,11 @@
"type": "object",
"description": "Inputs for creating a meeting without starting its RTC room.",
"properties": {
+ "preparationId": {
+ "type": ["string", "null"],
+ "format": "uuid",
+ "description": "Optional unused room reserved by this actor on the setup screen."
+ },
"scheduledEnd": {
"type": ["string", "null"],
"format": "date-time",
@@ -26272,6 +26427,52 @@
}
}
},
+ "MeetingParticipant": {
+ "type": "object",
+ "description": "Minimal waiting-room display data, without account identities or call content.",
+ "required": ["displayName"],
+ "properties": {
+ "avatarUrl": {
+ "type": ["string", "null"],
+ "description": "Profile image, when available for a Macro member."
+ },
+ "displayName": {
+ "type": "string",
+ "description": "Name displayed in the waiting room."
+ }
+ }
+ },
+ "MeetingParticipants": {
+ "type": "object",
+ "description": "People currently connected to a meeting's room.",
+ "required": ["participants"],
+ "properties": {
+ "participants": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/MeetingParticipant"
+ },
+ "description": "Human attendees only; transcription agents are excluded."
+ }
+ }
+ },
+ "MeetingPreparation": {
+ "type": "object",
+ "description": "An empty room reservation, not a started call or an invitation.",
+ "required": ["id", "expiresAt"],
+ "properties": {
+ "expiresAt": {
+ "type": "string",
+ "format": "date-time",
+ "description": "After this deadline Start falls back to ordinary room creation."
+ },
+ "id": {
+ "type": "string",
+ "format": "uuid",
+ "description": "Also the reserved RTC room's UUID and prospective call ID."
+ }
+ }
+ },
"MeetingToken": {
"type": "string",
"description": "A bearer capability that grants access only to a meeting's RTC room."
diff --git a/crates/ai_tools/src/tool_context.rs b/crates/ai_tools/src/tool_context.rs
index e2871538ae..0ea9b8db71 100644
--- a/crates/ai_tools/src/tool_context.rs
+++ b/crates/ai_tools/src/tool_context.rs
@@ -645,6 +645,9 @@ impl ConnectionService for NoOpConnectionService {
pub struct NoOpCallRtcClient;
impl CallRtcClient for NoOpCallRtcClient {
+ async fn prepare_room(&self, room_name: &str) -> anyhow::Result<()> {
+ self.create_room(room_name).await
+ }
async fn generate_guest_token(
&self,
_room_name: &str,
@@ -696,6 +699,13 @@ impl CallRtcClient for NoOpCallRtcClient {
Ok(())
}
+ async fn list_meeting_participants(
+ &self,
+ _room_name: &str,
+ ) -> anyhow::Result<Option<Vec<call::domain::meetings::MeetingRtcParticipant>>> {
+ Ok(None)
+ }
+
async fn list_participant_identities(
&self,
_room_name: &str,
diff --git a/crates/call/src/domain/meetings.rs b/crates/call/src/domain/meetings.rs
index addbf55051..d3f8960962 100644
--- a/crates/call/src/domain/meetings.rs
+++ b/crates/call/src/domain/meetings.rs
@@ -82,6 +82,8 @@ pub struct Meeting {
#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
#[serde(rename_all = "camelCase")]
pub struct CreateMeetingRequest {
+ /// Optional unused room reserved by this actor on the setup screen.
+ pub preparation_id: Option<Uuid>,
/// Optional display title.
pub title: Option<String>,
/// Optional scheduled start.
@@ -293,6 +295,7 @@ impl UpdateMeetingRequest {
}
let has_title = self.title.is_some();
let validated = CreateMeetingRequest {
+ preparation_id: None,
title: self.title,
scheduled_start: self.scheduled_start,
scheduled_end: self.scheduled_end,
@@ -306,3 +309,42 @@ impl UpdateMeetingRequest {
})
}
}
+
+/// An empty room reservation, not a started call or an invitation.
+#[derive(Debug, Clone, serde::Serialize)]
+#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub struct MeetingPreparation {
+ /// Also the reserved RTC room's UUID and prospective call ID.
+ pub id: Uuid,
+ /// After this deadline Start falls back to ordinary room creation.
+ pub expires_at: DateTime<Utc>,
+}
+
+/// Connected RTC participant facts; never expose identities in public previews.
+#[derive(Debug, Clone)]
+pub struct MeetingRtcParticipant {
+ /// RTC identity used to distinguish members, guests, and service agents.
+ pub identity: String,
+ /// Room display name, used for guests.
+ pub name: String,
+}
+
+/// Minimal waiting-room display data, without account identities or call content.
+#[derive(Debug, Clone, serde::Serialize)]
+#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub struct MeetingParticipant {
+ /// Name displayed in the waiting room.
+ pub display_name: String,
+ /// Profile image, when available for a Macro member.
+ pub avatar_url: Option<String>,
+}
+
+/// People currently connected to a meeting's room.
+#[derive(Debug, serde::Serialize)]
+#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
+pub struct MeetingParticipants {
+ /// Human attendees only; transcription agents are excluded.
+ pub participants: Vec<MeetingParticipant>,
+}
diff --git a/crates/call/src/domain/meetings/test.rs b/crates/call/src/domain/meetings/test.rs
index 659f500f30..4be7cfbacf 100644
--- a/crates/call/src/domain/meetings/test.rs
+++ b/crates/call/src/domain/meetings/test.rs
@@ -79,6 +79,7 @@ fn scheduled_meetings_require_ordered_complete_times() {
let start = Utc::now();
let end = start + chrono::Duration::hours(1);
let request = |scheduled_start, scheduled_end| CreateMeetingRequest {
+ preparation_id: None,
title: None,
scheduled_start,
scheduled_end,
diff --git a/crates/call/src/domain/ports.rs b/crates/call/src/domain/ports.rs
index a69779e69c..0ebadf17f8 100644
--- a/crates/call/src/domain/ports.rs
+++ b/crates/call/src/domain/ports.rs
@@ -24,7 +24,8 @@ use crate::domain::models::{
use super::meetings::{
ActiveMeeting, CreateMeetingRequest, GuestId, GuestJoinRequest, InviteMeetingUsersRequest,
- Meeting, MeetingInvitePermissions, MeetingToken, UpdateMeetingRequest,
+ Meeting, MeetingInvitePermissions, MeetingParticipants, MeetingPreparation,
+ MeetingRtcParticipant, MeetingToken, UpdateMeetingRequest,
};
use super::models::{
@@ -42,6 +43,31 @@ pub trait CallRepository: Send + Sync + 'static {
/// The error type returned by repository operations.
type Err: Into<anyhow::Error> + Send + Debug;
+ /// Persist an owner-bound room reservation and discard expired reservation metadata.
+ fn insert_meeting_preparation(
+ &self,
+ actor: &str,
+ preparation: &MeetingPreparation,
+ ) -> impl Future<Output = Result<(), CallError>> + Send;
+ /// Atomically bind a live, unused reservation owned by actor to their new meeting.
+ fn claim_meeting_preparation(
+ &self,
+ id: &Uuid,
+ actor: &str,
+ meeting_id: &Uuid,
+ ) -> impl Future<Output = Result<(), CallError>> + Send;
+ /// Delete only unused reservations owned by actor; a claimed room cannot be cancelled.
+ fn cancel_meeting_preparation(
+ &self,
+ id: &Uuid,
+ actor: &str,
+ ) -> impl Future<Output = Result<bool, CallError>> + Send;
+ /// Find a claimed, unexpired room that has never been activated as a call.
+ fn get_meeting_preparation(
+ &self,
+ meeting_id: &Uuid,
+ ) -> impl Future<Output = Result<Option<MeetingPreparation>, CallError>> + Send;
+
/// Persist a standalone invitation or reuse an invitation pinned to a channel call.
fn create_meeting(
&self,
@@ -246,6 +272,15 @@ pub trait CallRepository: Send + Sync + 'static {
egress_id: &str,
) -> impl Future<Output = Result<(), Self::Err>> + Send;
+ /// Attach a recording started asynchronously. Persists on the active call,
+ /// or its archived record if the call ended during startup. Returns whether
+ /// it was attached to an active call; otherwise the caller must stop egress.
+ fn attach_meeting_recording(
+ &self,
+ call_id: &Uuid,
+ egress_id: &str,
+ ) -> impl Future<Output = Result<bool, Self::Err>> + Send;
+
/// Load the canonical team-share facts (persisted creator, the creator's
/// team, current explicit grant, revision) the owner policy authorizes
/// against. Works for active and archived calls alike.
@@ -628,9 +663,18 @@ pub trait CallRtcClient: Send + Sync + 'static {
/// Create a new RTC room with the given name.
fn create_room(&self, room_name: &str) -> impl Future<Output = anyhow::Result<()>> + Send;
+ /// Reserve an empty room for setup, expiring automatically without participants.
+ fn prepare_room(&self, room_name: &str) -> impl Future<Output = anyhow::Result<()>> + Send;
+
/// Delete an RTC room.
fn delete_room(&self, room_name: &str) -> impl Future<Output = anyhow::Result<()>> + Send;
+ /// Read connected identities and names without joining the room.
+ fn list_meeting_participants(
+ &self,
+ room_name: &str,
+ ) -> impl Future<Output = anyhow::Result<Option<Vec<MeetingRtcParticipant>>>> + Send;
+
/// Generate an access token for a participant to join a room.
fn generate_token<'a>(
&self,
@@ -703,6 +747,17 @@ pub trait CallRtcClient: Send + Sync + 'static {
/// Service interface for call operations.
#[cfg_attr(test, mockall::automock)]
pub trait CallService: Send + Sync + 'static {
+ /// Reserve an empty room without creating a call, recording, or inviting anyone.
+ fn prepare_meeting<'a>(
+ &self,
+ actor: MacroUserIdStr<'a>,
+ ) -> impl Future<Output = Result<MeetingPreparation, CallError>> + Send;
+ /// Cancel only the actor's unused preparation; safe against concurrent activation.
+ fn cancel_meeting_preparation<'a>(
+ &self,
+ actor: MacroUserIdStr<'a>,
+ id: Uuid,
+ ) -> impl Future<Output = Result<(), CallError>> + Send;
/// Create an invitation without starting media.
fn create_meeting<'a>(
&self,
@@ -766,6 +821,13 @@ pub trait CallService: Send + Sync + 'static {
&self,
token: MeetingToken,
) -> impl Future<Output = Result<Meeting, CallError>> + Send;
+ /// Preview connected people using the invitation; channel links require sign-in.
+ fn get_meeting_participants<'a>(
+ &self,
+ token: MeetingToken,
+ actor: Option<MacroUserIdStr<'a>>,
+ ) -> impl Future<Output = Result<MeetingParticipants, CallError>> + Send;
+
/// Join using an authenticated Macro identity.
fn join_meeting<'a>(
&self,
diff --git a/crates/call/src/domain/service.rs b/crates/call/src/domain/service.rs
index d0b98a7451..3921c0bd3f 100644
--- a/crates/call/src/domain/service.rs
+++ b/crates/call/src/domain/service.rs
@@ -31,6 +31,7 @@ use notification::domain::ports::VoipPushSender;
use notification::domain::service::NotificationIngress;
use serde::{Deserialize, Serialize};
use std::collections::{HashMap, HashSet};
+use std::sync::Arc;
use subtle::ConstantTimeEq;
use uuid::Uuid;
@@ -47,7 +48,7 @@ use crate::domain::models::{
use super::meetings::{
ActiveMeeting, CreateMeetingRequest, GuestJoinRequest, InviteMeetingUsersRequest, Meeting,
- MeetingInvitePermissions, MeetingToken, UpdateMeetingRequest,
+ MeetingInvitePermissions, MeetingPreparation, MeetingToken, UpdateMeetingRequest,
};
use super::models::{
ActiveCallsResponse, AddParticipantError, ArchivedCall, Call, CallActiveResponse, CallError,
@@ -75,7 +76,7 @@ pub struct CallServiceImpl<
B: MacroEventBroker = NoopMacroEventBroker,
> {
repo: R,
- rtc_client: C,
+ rtc_client: Arc<C>,
connection_service: Cn,
entity_access_service: E,
notification_ingress: N,
@@ -112,7 +113,7 @@ impl<
) -> Self {
Self {
repo,
- rtc_client,
+ rtc_client: Arc::new(rtc_client),
connection_service,
entity_access_service,
notification_ingress,
@@ -573,6 +574,19 @@ impl<
B: MacroEventBroker + Clone,
> CallService for CallServiceImpl<R, C, Cn, E, N, S, Sm, V, Vr, B>
{
+ async fn prepare_meeting(
+ &self,
+ actor: MacroUserIdStr<'_>,
+ ) -> Result<MeetingPreparation, CallError> {
+ self.prepare_invitation_room(actor).await
+ }
+ async fn cancel_meeting_preparation(
+ &self,
+ actor: MacroUserIdStr<'_>,
+ id: Uuid,
+ ) -> Result<(), CallError> {
+ self.cancel_invitation_room(actor, id).await
+ }
async fn create_meeting(
&self,
actor: MacroUserIdStr<'_>,
@@ -648,6 +662,13 @@ impl<
async fn get_meeting(&self, token: MeetingToken) -> Result<Meeting, CallError> {
self.resolve_invitation(&token).await
}
+ async fn get_meeting_participants(
+ &self,
+ token: MeetingToken,
+ actor: Option<MacroUserIdStr<'_>>,
+ ) -> Result<super::meetings::MeetingParticipants, CallError> {
+ self.preview_invitation(token, actor).await
+ }
async fn join_meeting(
&self,
token: MeetingToken,
@@ -1133,6 +1154,13 @@ impl<
#[tracing::instrument(err, skip(self, body, auth_token))]
async fn process_webhook_event(&self, body: &str, auth_token: &str) -> Result<(), CallError> {
let event = self.rtc_client.receive_webhook(body, auth_token)?;
+ if matches!(event.event.as_str(), "egress_started" | "egress_ended") {
+ self.link_meeting_recording_webhook(
+ event.room_name.as_deref(),
+ event.egress_id.as_deref(),
+ )
+ .await?;
+ }
tracing::info!(
event_type = %event.event,
diff --git a/crates/call/src/domain/service/meetings.rs b/crates/call/src/domain/service/meetings.rs
index 79c4c1d284..a117f5c30c 100644
--- a/crates/call/src/domain/service/meetings.rs
+++ b/crates/call/src/domain/service/meetings.rs
@@ -5,6 +5,7 @@ use crate::domain::meetings::{
CreateMeetingRequest, GuestId, GuestJoinRequest, Meeting, MeetingToken,
};
use rootcause::compat::boxed_error::IntoBoxedError;
+use tracing::Instrument;
impl<
R: CallRepository + Clone,
@@ -19,6 +20,37 @@ impl<
B: MacroEventBroker + Clone,
> CallServiceImpl<R, C, Cn, E, N, S, Sm, V, Vr, B>
{
+ /// Webhooks can beat the startup API response, especially if a call ends
+ /// immediately. Correlate only standalone rooms whose UUID is their call ID.
+ #[tracing::instrument(err, skip_all)]
+ pub(super) async fn link_meeting_recording_webhook(
+ &self,
+ room_name: Option<&str>,
+ egress_id: Option<&str>,
+ ) -> Result<(), CallError> {
+ let (Some(room_name), Some(egress_id)) = (room_name, egress_id) else {
+ return Ok(());
+ };
+ let Ok(call_id) = Uuid::parse_str(room_name) else {
+ return Ok(());
+ };
+ let record = self
+ .repo
+ .get_call_record_by_call_id(&call_id)
+ .await
+ .map_err(|e| CallError::Internal(e.into()))?;
+ if let Some(record) = record
+ && record.channel_id.is_none()
+ && record.room_name == room_name
+ {
+ self.repo
+ .attach_meeting_recording(&call_id, egress_id)
+ .await
+ .map_err(|e| CallError::Internal(e.into()))?;
+ }
+ Ok(())
+ }
+
#[tracing::instrument(err, skip_all)]
pub(super) async fn email_invitation(
&self,
@@ -74,7 +106,8 @@ impl<
request: CreateMeetingRequest,
) -> Result<Meeting, CallError> {
let request = request.validate()?;
- self.repo
+ let meeting = self
+ .repo
.create_meeting(Meeting {
id: Uuid::now_v7(),
share_token: MeetingToken::generate(),
@@ -86,7 +119,62 @@ impl<
call_id: None,
user_id: actor.to_string(),
})
+ .await?;
+ if let Some(id) = request.preparation_id {
+ self.repo
+ .claim_meeting_preparation(&id, actor.as_ref(), &meeting.id)
+ .await?;
+ }
+ Ok(meeting)
+ }
+
+ #[tracing::instrument(err, skip_all)]
+ pub(super) async fn prepare_invitation_room(
+ &self,
+ actor: MacroUserIdStr<'_>,
+ ) -> Result<MeetingPreparation, CallError> {
+ let preparation = MeetingPreparation {
+ id: Uuid::now_v7(),
+ // Starts before the RTC request, so the server never advertises a
+ // longer lifetime than the provider's five-minute empty timeout.
+ expires_at: chrono::Utc::now() + chrono::Duration::minutes(5),
+ };
+ self.repo
+ .insert_meeting_preparation(actor.as_ref(), &preparation)
+ .await?;
+ if let Err(error) = self
+ .rtc_client
+ .prepare_room(&preparation.id.to_string())
.await
+ {
+ self.repo
+ .cancel_meeting_preparation(&preparation.id, actor.as_ref())
+ .await?;
+ return Err(CallError::Internal(error));
+ }
+ Ok(preparation)
+ }
+
+ #[tracing::instrument(err, skip_all)]
+ pub(super) async fn cancel_invitation_room(
+ &self,
+ actor: MacroUserIdStr<'_>,
+ id: Uuid,
+ ) -> Result<(), CallError> {
+ if self
+ .repo
+ .cancel_meeting_preparation(&id, actor.as_ref())
+ .await?
+ {
+ self.rtc_client
+ .delete_room(&id.to_string())
+ .await
+ .inspect_err(
+ |error| tracing::warn!(error=?error, "failed to delete unused meeting room"),
+ )
+ .ok();
+ }
+ Ok(())
}
#[tracing::instrument(err, skip_all)]
@@ -146,7 +234,71 @@ impl<
}
#[tracing::instrument(err, skip_all)]
- async fn prepare_meeting_call(&self, meeting: &Meeting) -> Result<Call, CallError> {
+ pub(super) async fn preview_invitation(
+ &self,
+ token: MeetingToken,
+ actor: Option<MacroUserIdStr<'_>>,
+ ) -> Result<crate::domain::meetings::MeetingParticipants, CallError> {
+ use crate::domain::meetings::{MeetingParticipant, MeetingParticipants};
+
+ let meeting = self.resolve_invitation(&token).await?;
+ if meeting.channel_id.is_some() && actor.is_none() {
+ return Err(CallError::Forbidden(
+ "Sign in to view this call".to_string(),
+ ));
+ }
+ let mut participants = Vec::new();
+ let Some(call_id) = meeting.call_id else {
+ return Ok(MeetingParticipants { participants });
+ };
+ let Some(call) = self
+ .repo
+ .get_call_by_id(&call_id)
+ .await
+ .map_err(|error| CallError::Internal(error.into()))?
+ else {
+ return Ok(MeetingParticipants { participants });
+ };
+ let connected = self
+ .rtc_client
+ .list_meeting_participants(&call.room_name)
+ .await
+ .map_err(CallError::Internal)?
+ .unwrap_or_default();
+ for participant in connected {
+ if let Ok(user) = MacroUserIdStr::parse_from_str(&participant.identity) {
+ let display_name = self
+ .repo
+ .get_user_display_name(user.copied())
+ .await
+ .map_err(|error| CallError::Internal(error.into()))?
+ .unwrap_or_else(|| "Macro user".to_string());
+ let avatar_url = self
+ .repo
+ .get_user_profile_picture(user)
+ .await
+ .map_err(|error| CallError::Internal(error.into()))?;
+ participants.push(MeetingParticipant {
+ display_name,
+ avatar_url,
+ });
+ } else if GuestId::parse_rtc_identity(&participant.identity).is_some() {
+ participants.push(MeetingParticipant {
+ display_name: if participant.name.trim().is_empty() {
+ "Guest".to_string()
+ } else {
+ participant.name
+ },
+ avatar_url: None,
+ });
+ }
+ }
+ participants.sort_by(|a, b| a.display_name.cmp(&b.display_name));
+ Ok(MeetingParticipants { participants })
+ }
+
+ #[tracing::instrument(err, skip_all)]
+ pub(super) async fn prepare_meeting_call(&self, meeting: &Meeting) -> Result<Call, CallError> {
if let Some(call_id) = meeting.call_id
&& let Some(call) = self
.repo
@@ -156,17 +308,22 @@ impl<
{
return Ok(call);
}
- let candidate_id = Uuid::now_v7();
+ let preparation = self.repo.get_meeting_preparation(&meeting.id).await?;
+ let candidate_id = preparation
+ .as_ref()
+ .map_or_else(Uuid::now_v7, |room| room.id);
let candidate_room = candidate_id.to_string();
- self.rtc_client
- .create_room(&candidate_room)
- .await
- .map_err(CallError::Internal)?;
+ if preparation.is_none() {
+ self.rtc_client
+ .create_room(&candidate_room)
+ .await
+ .map_err(CallError::Internal)?;
+ }
let allocated = self
.repo
.get_or_create_meeting_call(&meeting.id, &candidate_id)
.await;
- if !matches!(&allocated, Ok((_, true))) {
+ if !matches!(&allocated, Ok((_, true))) && preparation.is_none() {
self.rtc_client
.delete_room(&candidate_room)
.await
@@ -177,22 +334,6 @@ impl<
}
let (call, created) = allocated?;
if created {
- self.rtc_client.dispatch_transcription_agent(&call.room_name).await
- .inspect_err(|error| tracing::error!(error=?error, "failed to dispatch meeting transcription agent")).ok();
- if let Some(config) = &self.egress_s3_config {
- match self
- .rtc_client
- .start_room_composite_egress(&call.room_name, config)
- .await
- {
- Ok(egress_id) => self
- .repo
- .set_egress_id(&call.id, &egress_id)
- .await
- .map_err(|e| CallError::Internal(e.into()))?,
- Err(error) => tracing::error!(error=?error, "failed to record meeting"),
- }
- }
let created_by = MacroUserIdStr::parse_from_str(&call.created_by)
.map_err(|error| CallError::Internal(error.into()))?
.into_owned();
@@ -203,6 +344,21 @@ impl<
created_at: call.created_at,
recording_enabled: self.egress_s3_config.is_some(),
}));
+ // Token issuance needs a room, not a running recorder or agent.
+ // Only the allocation winner schedules these best-effort services.
+ let rtc = self.rtc_client.clone();
+ let repo = self.repo.clone();
+ let config = self.egress_s3_config.clone();
+ let room_name = call.room_name.clone();
+ let call_id = call.id;
+ tokio::spawn(async move {
+ let transcription = async {
+ rtc.dispatch_transcription_agent(&room_name).await
+ .inspect_err(|error| tracing::error!(error=?error, "failed to dispatch meeting transcription agent")).ok();
+ };
+ let recording = start_meeting_recording(&repo, rtc.as_ref(), call_id, &room_name, config.as_ref());
+ tokio::join!(transcription, recording);
+ }.instrument(tracing::info_span!("start_meeting_media", call_id = %call_id)));
}
Ok(call)
}
@@ -319,6 +475,11 @@ impl<
.remove_participant(&other.id, user_id.copied())
.await
.map_err(|e| CallError::Internal(e.into()))?;
+ // Archiving closes this room to future joins. Its whole-room teardown
+ // can then run independently without kicking a later rejoin.
+ if self.finish_empty_call(&other).await? {
+ return Ok(());
+ }
// Best-effort: a stale participation has no RTC session to end.
self.rtc_client
.remove_participant(&other.room_name, user_id)
@@ -327,7 +488,6 @@ impl<
tracing::warn!(error=?error, "failed to remove participant from previous call room")
})
.ok();
- self.finish_empty_call(&other).await?;
Ok(())
}
@@ -350,18 +510,24 @@ impl<
self.publish_archived_call_event(&archived, CallArchiveReason::LastParticipantLeft);
self.spawn_summarize_call(archived.call_id);
self.spawn_process_voices_for_call(archived.call_id);
- if let Some(egress_id) = &call.egress_id {
- self.rtc_client
- .stop_egress(egress_id)
- .await
- .inspect_err(|error| tracing::error!(error=?error, "failed to stop egress"))
- .ok();
- }
- self.rtc_client
- .delete_room(&call.room_name)
- .await
- .inspect_err(|error| tracing::error!(error=?error, "failed to delete RTC room"))
- .ok();
+ let rtc = self.rtc_client.clone();
+ let room_name = call.room_name.clone();
+ let egress_id = call.egress_id.clone();
+ tokio::spawn(
+ async move {
+ if let Some(egress_id) = egress_id {
+ rtc.stop_egress(&egress_id)
+ .await
+ .inspect_err(|error| tracing::error!(error=?error, "failed to stop egress"))
+ .ok();
+ }
+ rtc.delete_room(&room_name)
+ .await
+ .inspect_err(|error| tracing::error!(error=?error, "failed to delete RTC room"))
+ .ok();
+ }
+ .instrument(tracing::info_span!("finish_meeting_media", call_id = %call.id)),
+ );
self.send_call_event(
&archived.channel_id,
"call_ended",
@@ -407,25 +573,75 @@ impl<
return Err(CallError::Auth);
}
if let Some(guest_id) = GuestId::parse_rtc_identity(&verified.identity) {
+ self.repo.reconcile_guest(&call.id, guest_id, false).await?;
+ if self.finish_empty_call(&call).await? {
+ return Ok(LeaveCallResponse { call_ended: true });
+ }
self.rtc_client
.remove_guest(&room, guest_id)
.await
.map_err(CallError::Internal)?;
- self.repo.reconcile_guest(&call.id, guest_id, false).await?;
} else {
let identity =
MacroUserIdStr::parse_from_str(&verified.identity).map_err(|_| CallError::Auth)?;
- self.rtc_client
- .remove_participant(&room, identity.copied())
- .await
- .map_err(CallError::Internal)?;
self.repo
- .remove_participant(&call.id, identity)
+ .remove_participant(&call.id, identity.copied())
.await
.map_err(|e| CallError::Internal(e.into()))?;
+ if self.finish_empty_call(&call).await? {
+ return Ok(LeaveCallResponse { call_ended: true });
+ }
+ // Keep nonempty-room removal ordered with a later rejoin using
+ // this same identity; a detached remove could kick the new session.
+ self.rtc_client
+ .remove_participant(&room, identity)
+ .await
+ .map_err(CallError::Internal)?;
}
- Ok(LeaveCallResponse {
- call_ended: self.finish_empty_call(&call).await?,
- })
+ Ok(LeaveCallResponse { call_ended: false })
+ }
+}
+
+/// A late recorder must be attached before stopping so its completion webhook
+/// can find the archived record. Any failed attachment must also stop egress.
+#[tracing::instrument(skip_all, fields(%call_id))]
+pub(super) async fn start_meeting_recording<R: CallRepository, C: CallRtcClient>(
+ repo: &R,
+ rtc: &C,
+ call_id: Uuid,
+ room_name: &str,
+ config: Option<&EgressS3Config>,
+) {
+ let Some(config) = config else {
+ return;
+ };
+ let egress_id = match rtc.start_room_composite_egress(room_name, config).await {
+ Ok(id) => id,
+ Err(error) => {
+ tracing::error!(error=?error, "failed to record meeting");
+ return;
+ }
+ };
+ let active = match repo.attach_meeting_recording(&call_id, &egress_id).await {
+ Ok(true) => match repo.get_call_by_id(&call_id).await {
+ Ok(call) => call.is_some(),
+ Err(error) => {
+ tracing::error!(error=?error, "failed to confirm meeting is still active");
+ false
+ }
+ },
+ Ok(false) => false,
+ Err(error) => {
+ tracing::error!(error=?error, "failed to attach meeting recording");
+ false
+ }
+ };
+ if !active {
+ rtc.stop_egress(&egress_id)
+ .await
+ .inspect_err(
+ |error| tracing::error!(error=?error, "failed to stop late meeting recording"),
+ )
+ .ok();
}
}
diff --git a/crates/call/src/domain/service/test.rs b/crates/call/src/domain/service/test.rs
index b4c8ca0b68..965e66dd26 100644
--- a/crates/call/src/domain/service/test.rs
+++ b/crates/call/src/domain/service/test.rs
@@ -24,6 +24,8 @@ use uuid::Uuid;
mod active_meetings;
mod meeting_invites;
+mod meeting_participants;
+mod meeting_startup;
use crate::domain::meetings::GuestId;
use crate::domain::models::{
@@ -92,6 +94,9 @@ impl MockRtcClient {
}
impl CallRtcClient for MockRtcClient {
+ async fn prepare_room(&self, room_name: &str) -> anyhow::Result<()> {
+ self.create_room(room_name).await
+ }
async fn generate_guest_token(
&self,
room: &str,
@@ -171,6 +176,13 @@ impl CallRtcClient for MockRtcClient {
Ok(())
}
+ async fn list_meeting_participants(
+ &self,
+ _room_name: &str,
+ ) -> anyhow::Result<Option<Vec<crate::domain::meetings::MeetingRtcParticipant>>> {
+ Ok(None)
+ }
+
async fn list_participant_identities(
&self,
room_name: &str,
@@ -3905,9 +3917,7 @@ async fn last_guest_leaving_archives_call_and_stops_recording() {
room: Some(ARCHIVED_EVENT_ROOM_NAME.to_string()),
})
});
- rtc.expect_remove_guest()
- .times(1)
- .returning(|_, _| Box::pin(async { Ok(()) }));
+ rtc.expect_remove_guest().never();
rtc.expect_stop_egress().times(1).returning(|id| {
assert_eq!(id, "recording");
Box::pin(async { Ok(()) })
diff --git a/crates/call/src/domain/service/test/meeting_participants.rs b/crates/call/src/domain/service/test/meeting_participants.rs
new file mode 100644
index 0000000000..855c9e6e63
--- /dev/null
+++ b/crates/call/src/domain/service/test/meeting_participants.rs
@@ -0,0 +1,136 @@
+use super::*;
+use crate::domain::meetings::MeetingRtcParticipant;
+
+#[tokio::test]
+async fn meeting_preview_requires_a_valid_invitation() {
+ let mut repo = MockCallRepository::new();
+ repo.expect_get_meeting()
+ .times(1)
+ .returning(|_| Box::pin(async { Ok(None) }));
+ let service = build_webhook_service(
+ repo,
+ MockCallRtcClient::new(),
+ RecordingEventBroker::default(),
+ );
+ assert!(matches!(
+ service
+ .get_meeting_participants(invitation_for_test().share_token, None)
+ .await,
+ Err(CallError::NotFound(_))
+ ));
+}
+
+#[tokio::test]
+async fn meeting_preview_rejects_guests_for_channel_calls() {
+ let mut meeting = invitation_for_test();
+ meeting.channel_id = Some(Uuid::now_v7());
+ let token = meeting.share_token.clone();
+ let mut repo = MockCallRepository::new();
+ repo.expect_get_meeting()
+ .times(1)
+ .return_once(move |_| Box::pin(async move { Ok(Some(meeting)) }));
+ let service = build_webhook_service(
+ repo,
+ MockCallRtcClient::new(),
+ RecordingEventBroker::default(),
+ );
+ assert!(matches!(
+ service.get_meeting_participants(token, None).await,
+ Err(CallError::Forbidden(_))
+ ));
+}
+
+#[tokio::test]
+async fn meeting_preview_does_not_create_an_idle_call() {
+ let mut meeting = invitation_for_test();
+ meeting.call_id = None;
+ let token = meeting.share_token.clone();
+ let mut repo = MockCallRepository::new();
+ repo.expect_get_meeting()
+ .times(1)
+ .return_once(move |_| Box::pin(async move { Ok(Some(meeting)) }));
+ let service = build_webhook_service(
+ repo,
+ MockCallRtcClient::new(),
+ RecordingEventBroker::default(),
+ );
+ assert!(
+ service
+ .get_meeting_participants(token, None)
+ .await
+ .unwrap()
+ .participants
+ .is_empty()
+ );
+}
+
+#[tokio::test]
+async fn meeting_preview_only_exposes_connected_humans_display_data() {
+ for channel_link in [false, true] {
+ let mut meeting = invitation_for_test();
+ let call_id = Uuid::now_v7();
+ meeting.call_id = Some(call_id);
+ meeting.channel_id = channel_link.then(Uuid::now_v7);
+ let token = meeting.share_token.clone();
+ let mut repo = MockCallRepository::new();
+ repo.expect_get_meeting()
+ .times(1)
+ .return_once(move |_| Box::pin(async move { Ok(Some(meeting)) }));
+ repo.expect_get_call_by_id().times(1).return_once(move |_| {
+ Box::pin(async move {
+ Ok(Some(Call {
+ id: call_id,
+ channel_id: None,
+ room_name: "preview-room".to_string(),
+ created_by: "macro|[email protected]".to_string(),
+ created_at: Utc::now(),
+ egress_id: None,
+ }))
+ })
+ });
+ repo.expect_get_user_display_name()
+ .withf(|id| id.as_ref() == "macro|[email protected]")
+ .times(1)
+ .returning(|_| Box::pin(async { Ok(Some("Member Name".to_string())) }));
+ repo.expect_get_user_profile_picture()
+ .times(1)
+ .returning(|_| {
+ Box::pin(async { Ok(Some("https://example.com/avatar.png".to_string())) })
+ });
+ let mut rtc = MockCallRtcClient::new();
+ rtc.expect_list_meeting_participants()
+ .with(mockall::predicate::eq("preview-room"))
+ .times(1)
+ .returning(|_| {
+ Box::pin(async {
+ Ok(Some(vec![
+ MeetingRtcParticipant {
+ identity: "macro|[email protected]".to_string(),
+ name: String::new(),
+ },
+ MeetingRtcParticipant {
+ identity: GuestId::generate().to_string(),
+ name: "Guest Name".to_string(),
+ },
+ MeetingRtcParticipant {
+ identity: "transcription-agent".to_string(),
+ name: "Recorder".to_string(),
+ },
+ ]))
+ })
+ });
+ let service = build_webhook_service(repo, rtc, RecordingEventBroker::default());
+ let result = service
+ .get_meeting_participants(token, channel_link.then(|| user("[email protected]")))
+ .await
+ .unwrap();
+ let json = serde_json::to_value(&result).unwrap();
+ assert_eq!(
+ json,
+ json!({ "participants": [
+ { "displayName": "Guest Name", "avatarUrl": null },
+ { "displayName": "Member Name", "avatarUrl": "https://example.com/avatar.png" },
+ ] })
+ );
+ }
+}
diff --git a/crates/call/src/domain/service/test/meeting_startup.rs b/crates/call/src/domain/service/test/meeting_startup.rs
new file mode 100644
index 0000000000..08b5b7e867
--- /dev/null
+++ b/crates/call/src/domain/service/test/meeting_startup.rs
@@ -0,0 +1,391 @@
+use super::*;
+
+fn service(
+ repo: MockCallRepository,
+ rtc: MockCallRtcClient,
+) -> BaseWebhookCallService<StubConnectionService> {
+ CallServiceImpl::new(
+ repo,
+ rtc,
+ StubConnectionService,
+ NoOpEntityAccessService,
+ StubNotificationIngress,
+ StubRecordingStorage,
+ "wss://example.com",
+ )
+}
+
+#[tokio::test]
+async fn preparation_creates_only_a_room_and_removes_failed_reservations() {
+ for fails in [false, true] {
+ let mut repo = MockCallRepository::new();
+ repo.expect_insert_meeting_preparation()
+ .times(1)
+ .returning(|actor, preparation| {
+ assert_eq!(actor, user(ARCHIVED_EVENT_CREATOR).as_ref());
+ assert!(preparation.expires_at > Utc::now());
+ Box::pin(async { Ok(()) })
+ });
+ repo.expect_cancel_meeting_preparation()
+ .times(usize::from(fails))
+ .returning(|_, _| Box::pin(async { Ok(true) }));
+ repo.expect_create_meeting().never();
+ let mut rtc = MockCallRtcClient::new();
+ rtc.expect_prepare_room().times(1).returning(move |_| {
+ Box::pin(async move {
+ if fails {
+ Err(anyhow::anyhow!("RTC unavailable"))
+ } else {
+ Ok(())
+ }
+ })
+ });
+ rtc.expect_start_room_composite_egress().never();
+ rtc.expect_dispatch_transcription_agent().never();
+ assert_eq!(
+ service(repo, rtc)
+ .prepare_meeting(user(ARCHIVED_EVENT_CREATOR))
+ .await
+ .is_err(),
+ fails
+ );
+ }
+}
+
+#[tokio::test]
+async fn previous_nonempty_call_waits_for_identity_removal() {
+ let active = active_call_for_archived_event(ARCHIVED_EVENT_CREATOR, None);
+ let mut repo = MockCallRepository::new();
+ repo.expect_find_active_call_for_user()
+ .returning(|_| Box::pin(async { Ok(Some((ARCHIVED_EVENT_CALL_ID, None))) }));
+ repo.expect_get_call_by_id()
+ .return_once(move |_| Box::pin(async move { Ok(Some(active)) }));
+ repo.expect_remove_participant()
+ .times(1)
+ .returning(|_, _| Box::pin(async { Ok(()) }));
+ repo.expect_get_participant_count()
+ .returning(|_| Box::pin(async { Ok(1) }));
+ repo.expect_archive_call_if_empty().never();
+ let (release, blocked) = tokio::sync::oneshot::channel();
+ let mut rtc = MockCallRtcClient::new();
+ rtc.expect_remove_participant()
+ .times(1)
+ .return_once(move |_, _| {
+ Box::pin(async move {
+ blocked.await.unwrap();
+ Ok(())
+ })
+ });
+ rtc.expect_delete_room().never();
+ let service = service(repo, rtc);
+ let leaving = service.leave_other_active_call(user(ARCHIVED_EVENT_CREATOR), Uuid::now_v7());
+ tokio::pin!(leaving);
+ assert!(
+ tokio::time::timeout(Duration::from_millis(20), &mut leaving)
+ .await
+ .is_err()
+ );
+ release.send(()).unwrap();
+ leaving.await.unwrap();
+}
+
+#[tokio::test]
+async fn prepared_room_skips_external_creation_and_a_concurrent_join_does_not_delete_it() {
+ let mut meeting = invitation_for_test();
+ meeting.call_id = None;
+ let call = started_event_call(user(ARCHIVED_EVENT_CREATOR).as_ref());
+ let call_id = call.id;
+ let mut repo = MockCallRepository::new();
+ repo.expect_get_meeting_preparation()
+ .times(1)
+ .returning(move |_| {
+ Box::pin(async move {
+ Ok(Some(crate::domain::meetings::MeetingPreparation {
+ id: call_id,
+ expires_at: Utc::now() + chrono::Duration::minutes(5),
+ }))
+ })
+ });
+ repo.expect_get_or_create_meeting_call()
+ .times(1)
+ .return_once(move |_, candidate| {
+ assert_eq!(*candidate, call_id);
+ // Another first join has already won allocation of this same room.
+ Box::pin(async move { Ok((call, false)) })
+ });
+ let mut rtc = MockCallRtcClient::new();
+ rtc.expect_create_room().never();
+ rtc.expect_delete_room().never();
+ assert_eq!(
+ service(repo, rtc)
+ .prepare_meeting_call(&meeting)
+ .await
+ .unwrap()
+ .id,
+ call_id
+ );
+}
+
+#[tokio::test]
+async fn cancelling_an_unowned_or_claimed_preparation_never_deletes_media() {
+ for cancellable in [false, true] {
+ let id = Uuid::now_v7();
+ let mut repo = MockCallRepository::new();
+ repo.expect_cancel_meeting_preparation()
+ .times(1)
+ .return_once(move |room, actor| {
+ assert_eq!(*room, id);
+ assert_eq!(actor, user(ARCHIVED_EVENT_CREATOR).as_ref());
+ Box::pin(async move { Ok(cancellable) })
+ });
+ let mut rtc = MockCallRtcClient::new();
+ rtc.expect_delete_room()
+ .times(usize::from(cancellable))
+ .returning(|_| Box::pin(async { Ok(()) }));
+ service(repo, rtc)
+ .cancel_meeting_preparation(user(ARCHIVED_EVENT_CREATOR), id)
+ .await
+ .unwrap();
+ }
+}
+
+#[tokio::test]
+async fn previous_empty_call_cleanup_does_not_wait_for_media_teardown() {
+ let active = active_call_for_archived_event(ARCHIVED_EVENT_CREATOR, Some("recording"));
+ let mut archived = archived_call_for_event(ARCHIVED_EVENT_CREATOR, 1, true);
+ archived.channel_id = None;
+ let mut repo = MockCallRepository::new();
+ repo.expect_find_active_call_for_user()
+ .returning(|_| Box::pin(async { Ok(Some((ARCHIVED_EVENT_CALL_ID, None))) }));
+ repo.expect_get_call_by_id()
+ .return_once(move |_| Box::pin(async move { Ok(Some(active)) }));
+ repo.expect_remove_participant()
+ .times(1)
+ .returning(|_, _| Box::pin(async { Ok(()) }));
+ repo.expect_get_participant_count()
+ .returning(|_| Box::pin(async { Ok(0) }));
+ repo.expect_archive_call_if_empty()
+ .times(1)
+ .return_once(move |_| Box::pin(async move { Ok(Some(archived)) }));
+ let (release, blocked) = tokio::sync::oneshot::channel();
+ let (deleted, deletion) = tokio::sync::oneshot::channel();
+ let mut rtc = MockCallRtcClient::new();
+ rtc.expect_remove_participant().never();
+ rtc.expect_stop_egress().times(1).return_once(move |_| {
+ Box::pin(async move {
+ blocked.await.unwrap();
+ Ok(())
+ })
+ });
+ rtc.expect_delete_room().times(1).return_once(move |_| {
+ Box::pin(async move {
+ deleted.send(()).unwrap();
+ Ok(())
+ })
+ });
+ let service = service(repo, rtc);
+ tokio::time::timeout(
+ Duration::from_millis(200),
+ service.leave_other_active_call(user(ARCHIVED_EVENT_CREATOR), Uuid::now_v7()),
+ )
+ .await
+ .expect("archived media cleanup must not block a new join")
+ .unwrap();
+ release.send(()).unwrap();
+ tokio::time::timeout(Duration::from_secs(2), deletion)
+ .await
+ .unwrap()
+ .unwrap();
+}
+
+/// Blocking external media startup must not hold the call/credentials path.
+#[tokio::test]
+async fn meeting_allocation_does_not_wait_for_recording_or_transcription() {
+ let mut meeting = invitation_for_test();
+ meeting.call_id = None;
+ let call = started_event_call(user(ARCHIVED_EVENT_CREATOR).as_ref());
+ let call_id = call.id;
+ let mut repo = MockCallRepository::new();
+ repo.expect_get_meeting_preparation()
+ .returning(|_| Box::pin(async { Ok(None) }));
+ repo.expect_get_or_create_meeting_call()
+ .times(1)
+ .return_once(move |_, _| Box::pin(async move { Ok((call, true)) }));
+ let (release_agent, agent_wait) = tokio::sync::oneshot::channel();
+ let (release_recorder, recorder_wait) = tokio::sync::oneshot::channel();
+ let (attached, attachment) = tokio::sync::oneshot::channel();
+ let mut rtc = MockCallRtcClient::new();
+ rtc.expect_create_room()
+ .times(1)
+ .returning(|_| Box::pin(async { Ok(()) }));
+ rtc.expect_dispatch_transcription_agent()
+ .times(1)
+ .return_once(move |_| {
+ Box::pin(async move {
+ agent_wait.await.unwrap();
+ Ok(())
+ })
+ });
+ rtc.expect_start_room_composite_egress()
+ .times(1)
+ .return_once(move |_, _| {
+ Box::pin(async move {
+ recorder_wait.await.unwrap();
+ Ok("egress".to_string())
+ })
+ });
+ let mut background_repo = MockCallRepository::new();
+ background_repo
+ .expect_attach_meeting_recording()
+ .times(1)
+ .return_once(move |id, egress| {
+ assert_eq!(*id, call_id);
+ assert_eq!(egress, "egress");
+ Box::pin(async move { Ok(true) })
+ });
+ background_repo
+ .expect_get_call_by_id()
+ .times(1)
+ .return_once(move |_| {
+ Box::pin(async move {
+ attached.send(()).unwrap();
+ Ok(Some(started_event_call(
+ user(ARCHIVED_EVENT_CREATOR).as_ref(),
+ )))
+ })
+ });
+ let service: BaseWebhookCallService<StubConnectionService> = CallServiceImpl::new(
+ repo,
+ rtc,
+ StubConnectionService,
+ NoOpEntityAccessService,
+ StubNotificationIngress,
+ StubRecordingStorage,
+ "wss://example.com",
+ );
+ let service = service.with_egress(test_egress_config());
+ configure_repository_clone(&service.repo, background_repo);
+ let prepared = tokio::time::timeout(
+ Duration::from_millis(200),
+ service.prepare_meeting_call(&meeting),
+ )
+ .await
+ .expect("room allocation must not wait for media services")
+ .unwrap();
+ assert_eq!(prepared.id, call_id);
+ // The recording progresses even though transcription is still blocked.
+ release_recorder.send(()).unwrap();
+ tokio::time::timeout(Duration::from_secs(2), attachment)
+ .await
+ .unwrap()
+ .unwrap();
+ release_agent.send(()).unwrap();
+ tokio::task::yield_now().await;
+}
+
+#[tokio::test]
+async fn late_meeting_recording_is_attached_before_it_is_stopped() {
+ for attach_fails in [false, true] {
+ let mut repo = MockCallRepository::new();
+ let mut rtc = MockCallRtcClient::new();
+ let mut sequence = mockall::Sequence::new();
+ rtc.expect_start_room_composite_egress()
+ .times(1)
+ .in_sequence(&mut sequence)
+ .returning(|_, _| Box::pin(async { Ok("late-egress".to_string()) }));
+ repo.expect_attach_meeting_recording()
+ .times(1)
+ .in_sequence(&mut sequence)
+ .returning(move |_, _| {
+ Box::pin(async move {
+ if attach_fails {
+ Err(anyhow::anyhow!("database unavailable"))
+ } else {
+ Ok(false)
+ }
+ })
+ });
+ rtc.expect_stop_egress()
+ .with(mockall::predicate::eq("late-egress"))
+ .times(1)
+ .in_sequence(&mut sequence)
+ .returning(|_| Box::pin(async { Ok(()) }));
+ super::super::meetings::start_meeting_recording(
+ &repo,
+ &rtc,
+ Uuid::now_v7(),
+ "room",
+ Some(&test_egress_config()),
+ )
+ .await;
+ }
+}
+
+#[tokio::test]
+async fn meeting_recording_stops_if_call_ends_just_after_attachment() {
+ let mut repo = MockCallRepository::new();
+ let mut rtc = MockCallRtcClient::new();
+ rtc.expect_start_room_composite_egress()
+ .times(1)
+ .returning(|_, _| Box::pin(async { Ok("egress".to_string()) }));
+ repo.expect_attach_meeting_recording()
+ .times(1)
+ .returning(|_, _| Box::pin(async { Ok(true) }));
+ repo.expect_get_call_by_id()
+ .times(1)
+ .returning(|_| Box::pin(async { Ok(None) }));
+ rtc.expect_stop_egress()
+ .times(1)
+ .returning(|_| Box::pin(async { Ok(()) }));
+ super::super::meetings::start_meeting_recording(
+ &repo,
+ &rtc,
+ Uuid::now_v7(),
+ "room",
+ Some(&test_egress_config()),
+ )
+ .await;
+}
+
+fn test_egress_config() -> EgressS3Config {
+ EgressS3Config {
+ bucket: "test".into(),
+ region: "test".into(),
+ access_key: "test".into(),
+ secret: "test".into(),
+ }
+}
+
+#[tokio::test]
+async fn recording_webhook_can_link_before_the_startup_response() {
+ for correct_room in [false, true] {
+ let mut record = standalone_record(false);
+ let call_id = record.call_id;
+ let room_name = call_id.to_string();
+ record.room_name = if correct_room {
+ room_name.clone()
+ } else {
+ "different-room".to_string()
+ };
+ let mut repo = MockCallRepository::new();
+ repo.expect_get_call_record_by_call_id()
+ .times(1)
+ .return_once(move |_| Box::pin(async move { Ok(Some(record)) }));
+ repo.expect_attach_meeting_recording()
+ .times(usize::from(correct_room))
+ .returning(|_, _| Box::pin(async { Ok(false) }));
+ let service: BaseWebhookCallService<StubConnectionService> = CallServiceImpl::new(
+ repo,
+ MockCallRtcClient::new(),
+ StubConnectionService,
+ NoOpEntityAccessService,
+ StubNotificationIngress,
+ StubRecordingStorage,
+ "wss://example.com",
+ );
+ service
+ .link_meeting_recording_webhook(Some(&room_name), Some("early-webhook-egress"))
+ .await
+ .unwrap();
+ }
+}
diff --git a/crates/call/src/inbound/axum_router.rs b/crates/call/src/inbound/axum_router.rs
index 6ec1d7c9f9..56387e7cfc 100644
--- a/crates/call/src/inbound/axum_router.rs
+++ b/crates/call/src/inbound/axum_router.rs
@@ -116,6 +116,11 @@ where
T: Send + Sync,
{
Router::new()
+ .route("/meetings/prepare", post(meetings::prepare::<S, Svc, Auth>))
+ .route(
+ "/meetings/prepare/{preparation_id}",
+ axum::routing::delete(meetings::cancel_preparation::<S, Svc, Auth>),
+ )
.route(
"/meetings",
get(meetings::list::<S, Svc, Auth>).post(meetings::create::<S, Svc, Auth>),
@@ -133,6 +138,10 @@ where
"/meetings/join/{token}",
post(meetings::join::<S, Svc, Auth>),
)
+ .route(
+ "/meetings/join/{token}/participants",
+ get(meetings::participants::<S, Svc, Auth>),
+ )
.route(
"/meetings/invite/{token}",
post(meetings::invite::<S, Svc, Auth>)
@@ -214,6 +223,15 @@ where
R: rate_limit::RateLimitService + Clone + Send + Sync + 'static,
T: Send + Sync,
{
+ let preview = Router::new()
+ .route(
+ "/join/{token}/participants",
+ get(meetings::guest_participants::<S>),
+ )
+ .route_layer(axum::middleware::from_fn_with_state(
+ rate_limiter.clone(),
+ meetings::enforce_preview_rate_limit::<R>,
+ ));
Router::new()
.route(
"/join/{token}",
@@ -226,6 +244,7 @@ where
rate_limiter,
meetings::enforce_public_rate_limit::<R>,
))
+ .merge(preview)
.route("/webhook", post(webhook_handler::<S>))
.route("/ring-status/{call_id}", get(ring_status_handler::<S>))
.with_state(state)
diff --git a/crates/call/src/inbound/axum_router/meetings.rs b/crates/call/src/inbound/axum_router/meetings.rs
index e7914eb38d..bcd37d3235 100644
--- a/crates/call/src/inbound/axum_router/meetings.rs
+++ b/crates/call/src/inbound/axum_router/meetings.rs
@@ -143,6 +143,42 @@ pub async fn invite_users<
Ok(StatusCode::NO_CONTENT)
}
+/// Reserve a room while the authenticated caller configures a new call.
+#[utoipa::path(post, operation_id = "meeting_prepare", path = "/call/meetings/prepare",
+ responses((status = 200, body = crate::domain::meetings::MeetingPreparation), (status = 401, body = ErrorResponse)))]
+#[tracing::instrument(err, skip_all)]
+pub async fn prepare<S: CallService, Svc: EntityAccessService, Auth: MacroAuthorizationService>(
+ State(state): State<CallRouterState<S, Svc, Auth>>,
+ actor: MacroAuthorizationExtractor<Auth, UserOrInternal>,
+) -> Result<Json<crate::domain::meetings::MeetingPreparation>, CallError> {
+ Ok(Json(
+ state
+ .service
+ .prepare_meeting(actor.authorization.user.macro_user_id.clone())
+ .await?,
+ ))
+}
+
+/// Cancel an unused room; the domain owns ownership and activation checks.
+#[utoipa::path(delete, operation_id = "meeting_cancel_preparation", path = "/call/meetings/prepare/{preparation_id}",
+ params(("preparation_id" = Uuid, Path)), responses((status = 204), (status = 401, body = ErrorResponse)))]
+#[tracing::instrument(err, skip_all)]
+pub async fn cancel_preparation<
+ S: CallService,
+ Svc: EntityAccessService,
+ Auth: MacroAuthorizationService,
+>(
+ State(state): State<CallRouterState<S, Svc, Auth>>,
+ Path(id): Path<Uuid>,
+ actor: MacroAuthorizationExtractor<Auth, UserOrInternal>,
+) -> Result<StatusCode, CallError> {
+ state
+ .service
+ .cancel_meeting_preparation(actor.authorization.user.macro_user_id.clone(), id)
+ .await?;
+ Ok(StatusCode::NO_CONTENT)
+}
+
/// Handle `POST /call/meetings` through the call domain service.
#[utoipa::path(post, operation_id = "meeting_create", path = "/call/meetings",
request_body = CreateMeetingRequest,
@@ -331,3 +367,83 @@ pub async fn update<S: CallService, Svc: EntityAccessService, Auth: MacroAuthori
.await?,
))
}
+
+/// Read the participant preview for an authenticated invitation holder.
+#[utoipa::path(get, operation_id = "meeting_participants", path = "/call/meetings/join/{token}/participants",
+ params(("token" = String, Path)),
+ responses((status = 200, body = crate::domain::meetings::MeetingParticipants), (status = 404, body = ErrorResponse)))]
+#[tracing::instrument(err, skip_all)]
+pub async fn participants<
+ S: CallService,
+ Svc: EntityAccessService,
+ Auth: MacroAuthorizationService,
+>(
+ State(state): State<CallRouterState<S, Svc, Auth>>,
+ Path(token): Path<String>,
+ actor: MacroAuthorizationExtractor<Auth, UserOrInternal>,
+) -> Result<Json<crate::domain::meetings::MeetingParticipants>, CallError> {
+ Ok(Json(
+ state
+ .service
+ .get_meeting_participants(
+ MeetingToken::try_from(token)?,
+ Some(actor.authorization.user.macro_user_id.clone()),
+ )
+ .await?,
+ ))
+}
+
+/// Read a standalone meeting preview without admitting a guest to the room.
+#[utoipa::path(get, operation_id = "meeting_guest_participants", path = "/call/join/{token}/participants",
+ params(("token" = String, Path)),
+ responses((status = 200, body = crate::domain::meetings::MeetingParticipants), (status = 403, body = ErrorResponse), (status = 404, body = ErrorResponse)))]
+#[tracing::instrument(err, skip_all)]
+pub async fn guest_participants<S: CallService>(
+ State(state): State<WebhookRouterState<S>>,
+ Path(token): Path<String>,
+) -> Result<Json<crate::domain::meetings::MeetingParticipants>, CallError> {
+ Ok(Json(
+ state
+ .service
+ .get_meeting_participants(MeetingToken::try_from(token)?, None)
+ .await?,
+ ))
+}
+
+/// Separate polling budget so previews cannot exhaust the guest join budget.
+pub struct PerIpMeetingPreview(ClientIp);
+
+impl<S: Send + Sync> RateLimitExtractable<S> for PerIpMeetingPreview {
+ fn config() -> RateLimitConfig {
+ RateLimitConfig {
+ max_count: 600,
+ window: Duration::from_mins(60),
+ }
+ }
+ fn key(&self) -> RateLimitKey {
+ RateLimitKey::builder(&"per-ip-call-meeting-preview")
+ .append(&self.0.origin_ip())
+ .finish()
+ }
+}
+impl<S: Send + Sync> FromRequestParts<S> for PerIpMeetingPreview {
+ type Rejection = <ClientIp as FromRequestParts<S>>::Rejection;
+ async fn from_request_parts(
+ parts: &mut axum::http::request::Parts,
+ state: &S,
+ ) -> Result<Self, Self::Rejection> {
+ Ok(Self(parts.extract_with_state(state).await?))
+ }
+}
+
+/// Rate-limit polling independently of join and leave requests.
+pub async fn enforce_preview_rate_limit<R>(
+ _permit: RateLimitExtractor<PerIpMeetingPreview, R>,
+ req: axum::extract::Request,
+ next: axum::middleware::Next,
+) -> axum::response::Response
+where
+ R: RateLimitService + Clone + Send + Sync + 'static,
+{
+ next.run(req).await
+}
diff --git a/crates/call/src/inbound/axum_router/test.rs b/crates/call/src/inbound/axum_router/test.rs
index 57397a641a..03f183eedd 100644
--- a/crates/call/src/inbound/axum_router/test.rs
+++ b/crates/call/src/inbound/axum_router/test.rs
@@ -106,6 +106,7 @@ mod public_routes {
async fn malformed_tokens_are_rejected_without_touching_the_service() {
for (method, uri) in [
("GET", "/join/not-a-token"),
+ ("GET", "/join/not-a-token/participants"),
("POST", "/join/not-a-token"),
// Right length, wrong alphabet.
("GET", &format!("/join/{}", "g".repeat(64))[..]),
@@ -134,6 +135,7 @@ mod public_routes {
let valid_token = "a".repeat(64);
for (method, uri) in [
("GET", format!("/join/{valid_token}")),
+ ("GET", format!("/join/{valid_token}/participants")),
("POST", format!("/join/{valid_token}")),
("POST", format!("/join/{valid_token}/leave")),
] {
diff --git a/crates/call/src/outbound/livekit_rtc_client.rs b/crates/call/src/outbound/livekit_rtc_client.rs
index 936d831c4e..5a298f8234 100644
--- a/crates/call/src/outbound/livekit_rtc_client.rs
+++ b/crates/call/src/outbound/livekit_rtc_client.rs
@@ -124,6 +124,19 @@ fn build_room_composite_egress_request(
}
impl CallRtcClient for LivekitRtcClient {
+ #[tracing::instrument(err, skip(self))]
+ async fn prepare_room(&self, room_name: &str) -> anyhow::Result<()> {
+ self.room_client
+ .create_room(
+ room_name,
+ CreateRoomOptions {
+ empty_timeout: 300,
+ ..Default::default()
+ },
+ )
+ .await?;
+ Ok(())
+ }
#[tracing::instrument(err, skip(self))]
async fn create_room(&self, room_name: &str) -> anyhow::Result<()> {
self.room_client
@@ -269,15 +282,20 @@ impl CallRtcClient for LivekitRtcClient {
}
#[tracing::instrument(err, skip(self))]
- async fn list_participant_identities(
+ async fn list_meeting_participants(
&self,
room_name: &str,
- ) -> anyhow::Result<Option<Vec<String>>> {
+ ) -> anyhow::Result<Option<Vec<crate::domain::meetings::MeetingRtcParticipant>>> {
match self.room_client.list_participants(room_name).await {
Ok(participants) => Ok(Some(
participants
.into_iter()
- .map(|participant| participant.identity)
+ .map(
+ |participant| crate::domain::meetings::MeetingRtcParticipant {
+ identity: participant.identity,
+ name: participant.name,
+ },
+ )
.collect(),
)),
Err(error) if is_not_found(&error) => Ok(None),
@@ -285,6 +303,22 @@ impl CallRtcClient for LivekitRtcClient {
}
}
+ #[tracing::instrument(err, skip(self))]
+ async fn list_participant_identities(
+ &self,
+ room_name: &str,
+ ) -> anyhow::Result<Option<Vec<String>>> {
+ Ok(self
+ .list_meeting_participants(room_name)
+ .await?
+ .map(|participants| {
+ participants
+ .into_iter()
+ .map(|participant| participant.identity)
+ .collect()
+ }))
+ }
+
#[tracing::instrument(err, skip(self, s3_config))]
async fn start_room_composite_egress(
&self,
diff --git a/crates/call/src/outbound/pg_call_repo.rs b/crates/call/src/outbound/pg_call_repo.rs
index 3a55905a84..0cacd783b3 100644
--- a/crates/call/src/outbound/pg_call_repo.rs
+++ b/crates/call/src/outbound/pg_call_repo.rs
@@ -3,6 +3,7 @@
mod edit;
mod lifecycle;
mod meetings;
+mod preparations;
mod team_share;
#[cfg(test)]
@@ -25,7 +26,9 @@ use models_permissions::share_permission::team_share::TeamShareFacts;
use sqlx::PgPool;
use uuid::Uuid;
-use crate::domain::meetings::{GuestId, Meeting, MeetingToken, UpdateMeetingRequest};
+use crate::domain::meetings::{
+ GuestId, Meeting, MeetingPreparation, MeetingToken, UpdateMeetingRequest,
+};
use crate::domain::models::{
ActiveCallSummary, AddParticipantError, ArchivedCall, Call, CallError, CallParticipant,
CallRecord, CallRecordGuest, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData,
@@ -304,6 +307,31 @@ impl PgCallRepo {
impl CallRepository for PgCallRepo {
type Err = sqlx::Error;
+ async fn insert_meeting_preparation(
+ &self,
+ actor: &str,
+ preparation: &MeetingPreparation,
+ ) -> Result<(), CallError> {
+ self.persist_preparation(actor, preparation).await
+ }
+ async fn claim_meeting_preparation(
+ &self,
+ id: &Uuid,
+ actor: &str,
+ meeting_id: &Uuid,
+ ) -> Result<(), CallError> {
+ self.claim_preparation(id, actor, meeting_id).await
+ }
+ async fn cancel_meeting_preparation(&self, id: &Uuid, actor: &str) -> Result<bool, CallError> {
+ self.discard_preparation(id, actor).await
+ }
+ async fn get_meeting_preparation(
+ &self,
+ meeting_id: &Uuid,
+ ) -> Result<Option<MeetingPreparation>, CallError> {
+ self.fetch_preparation(meeting_id).await
+ }
+
async fn create_meeting(&self, meeting: Meeting) -> Result<Meeting, CallError> {
self.persist_meeting(meeting).await
}
@@ -877,6 +905,37 @@ impl CallRepository for PgCallRepo {
Ok(())
}
+ #[tracing::instrument(err, skip(self))]
+ async fn attach_meeting_recording(
+ &self,
+ call_id: &Uuid,
+ egress_id: &str,
+ ) -> Result<bool, Self::Err> {
+ // This UPDATE takes the same row lock as archival. If it wins, archival
+ // copies the egress ID. If archival wins, the second statement sees the
+ // committed archived record under READ COMMITTED.
+ let active = sqlx::query!(
+ r#"
+ UPDATE calls SET egress_id = $2 WHERE id = $1
+ "#,
+ call_id,
+ egress_id,
+ )
+ .execute(&self.pool)
+ .await?;
+ if active.rows_affected() > 0 {
+ return Ok(true);
+ }
+ sqlx::query!(
+ "UPDATE call_records SET egress_id = $2 WHERE id = $1",
+ call_id,
+ egress_id,
+ )
+ .execute(&self.pool)
+ .await?;
+ Ok(false)
+ }
+
#[tracing::instrument(err, skip(self))]
async fn get_team_share_facts(&self, call_id: &Uuid) -> Result<TeamShareFacts, CallError> {
team_share::get_team_share_facts(&self.pool, call_id).await
diff --git a/crates/call/src/outbound/pg_call_repo/meetings.rs b/crates/call/src/outbound/pg_call_repo/meetings.rs
index 83e0b4b551..a0e2e0e558 100644
--- a/crates/call/src/outbound/pg_call_repo/meetings.rs
+++ b/crates/call/src/outbound/pg_call_repo/meetings.rs
@@ -291,6 +291,12 @@ impl PgCallRepo {
)
.execute(tx.as_mut())
.await?;
+ sqlx::query!(
+ "DELETE FROM call_meeting_preparations WHERE meeting_id = $1",
+ meeting_id
+ )
+ .execute(tx.as_mut())
+ .await?;
tx.commit().await?;
Ok((
Call {
diff --git a/crates/call/src/outbound/pg_call_repo/meetings/test.rs b/crates/call/src/outbound/pg_call_repo/meetings/test.rs
index e7947e1f4e..995857ed0f 100644
--- a/crates/call/src/outbound/pg_call_repo/meetings/test.rs
+++ b/crates/call/src/outbound/pg_call_repo/meetings/test.rs
@@ -7,6 +7,121 @@ const OWNER: &str = "macro|[email protected]";
const PARTICIPANT_EMAIL: &str = "[email protected]";
const UNRELATED: &str = "macro|[email protected]";
+#[sqlx::test(
+ fixtures(path = "../../../../fixtures", scripts("call_repo")),
+ migrator = "MACRO_DB_MIGRATIONS"
+)]
+async fn room_preparations_are_owner_bound_and_consumed_once(pool: PgPool) {
+ let repo = repo(pool).await;
+ let meeting = repo.create_meeting(meeting()).await.unwrap();
+ let preparation = crate::domain::meetings::MeetingPreparation {
+ id: Uuid::now_v7(),
+ expires_at: Utc::now() + Duration::minutes(5),
+ };
+ repo.insert_meeting_preparation(OWNER, &preparation)
+ .await
+ .unwrap();
+ repo.claim_meeting_preparation(&preparation.id, UNRELATED, &meeting.id)
+ .await
+ .unwrap();
+ assert!(
+ repo.get_meeting_preparation(&meeting.id)
+ .await
+ .unwrap()
+ .is_none()
+ );
+ assert!(
+ !repo
+ .cancel_meeting_preparation(&preparation.id, UNRELATED)
+ .await
+ .unwrap()
+ );
+ repo.claim_meeting_preparation(&preparation.id, OWNER, &meeting.id)
+ .await
+ .unwrap();
+ assert_eq!(
+ repo.get_meeting_preparation(&meeting.id)
+ .await
+ .unwrap()
+ .unwrap()
+ .id,
+ preparation.id
+ );
+ assert!(
+ !repo
+ .cancel_meeting_preparation(&preparation.id, OWNER)
+ .await
+ .unwrap()
+ );
+ let (call, created) = repo
+ .get_or_create_meeting_call(&meeting.id, &preparation.id)
+ .await
+ .unwrap();
+ assert!(created);
+ assert_eq!(call.id, preparation.id);
+ assert!(
+ repo.get_meeting_preparation(&meeting.id)
+ .await
+ .unwrap()
+ .is_none()
+ );
+}
+
+#[sqlx::test(
+ fixtures(path = "../../../../fixtures", scripts("call_repo")),
+ migrator = "MACRO_DB_MIGRATIONS"
+)]
+async fn cancellation_racing_claim_never_deletes_a_claimed_room(pool: PgPool) {
+ let repo = repo(pool).await;
+ for _ in 0..10 {
+ let meeting = repo.create_meeting(meeting()).await.unwrap();
+ let preparation = crate::domain::meetings::MeetingPreparation {
+ id: Uuid::now_v7(),
+ expires_at: Utc::now() + Duration::minutes(5),
+ };
+ repo.insert_meeting_preparation(OWNER, &preparation)
+ .await
+ .unwrap();
+ let (claim, cancel) = tokio::join!(
+ repo.claim_meeting_preparation(&preparation.id, OWNER, &meeting.id),
+ repo.cancel_meeting_preparation(&preparation.id, OWNER),
+ );
+ claim.unwrap();
+ assert_eq!(
+ repo.get_meeting_preparation(&meeting.id)
+ .await
+ .unwrap()
+ .is_some(),
+ !cancel.unwrap()
+ );
+ }
+}
+
+#[sqlx::test(
+ fixtures(path = "../../../../fixtures", scripts("call_repo")),
+ migrator = "MACRO_DB_MIGRATIONS"
+)]
+async fn expired_preparation_is_not_claimed(pool: PgPool) {
+ let repo = repo(pool).await;
+ let meeting = repo.create_meeting(meeting()).await.unwrap();
+ let preparation = crate::domain::meetings::MeetingPreparation {
+ id: Uuid::now_v7(),
+ expires_at: Utc::now() - Duration::seconds(1),
+ };
+ repo.insert_meeting_preparation(OWNER, &preparation)
+ .await
+ .unwrap();
+ repo.claim_meeting_preparation(&preparation.id, OWNER, &meeting.id)
+ .await
+ .unwrap();
+ assert!(
+ repo.get_meeting_preparation(&meeting.id)
+ .await
+ .unwrap()
+ .is_none()
+ );
+}
+
async fn repo(pool: PgPool) -> PgCallRepo {
for user in [
MacroUserIdStr::parse_from_str(OWNER).unwrap(),
diff --git a/crates/call/src/outbound/pg_call_repo/preparations.rs b/crates/call/src/outbound/pg_call_repo/preparations.rs
new file mode 100644
index 0000000000..6db0930a23
--- /dev/null
+++ b/crates/call/src/outbound/pg_call_repo/preparations.rs
@@ -0,0 +1,63 @@
+use super::*;
+use crate::domain::meetings::MeetingPreparation;
+
+impl PgCallRepo {
+ pub(super) async fn persist_preparation(
+ &self,
+ actor: &str,
+ preparation: &MeetingPreparation,
+ ) -> Result<(), CallError> {
+ let mut tx = self.pool.begin().await?;
+ sqlx::query!("DELETE FROM call_meeting_preparations WHERE expires_at <= now()")
+ .execute(tx.as_mut())
+ .await?;
+ sqlx::query!(
+ "INSERT INTO call_meeting_preparations (id, user_id, expires_at) VALUES ($1, $2, $3)",
+ preparation.id,
+ actor,
+ preparation.expires_at
+ )
+ .execute(tx.as_mut())
+ .await?;
+ tx.commit().await?;
+ Ok(())
+ }
+
+ pub(super) async fn claim_preparation(
+ &self,
+ id: &Uuid,
+ actor: &str,
+ meeting_id: &Uuid,
+ ) -> Result<(), CallError> {
+ // UPDATE and cancellation's DELETE serialize on the same row. If
+ // cancellation won, or the room expired, the meeting simply starts cold.
+ sqlx::query!(
+ r#"UPDATE call_meeting_preparations SET meeting_id = $3
+ WHERE id = $1 AND user_id = $2 AND meeting_id IS NULL AND expires_at > now()
+ AND EXISTS (SELECT 1 FROM call_meetings WHERE id = $3 AND user_id = $2 AND cancelled_at IS NULL)"#,
+ id, actor, meeting_id
+ ).execute(&self.pool).await?;
+ Ok(())
+ }
+
+ pub(super) async fn discard_preparation(
+ &self,
+ id: &Uuid,
+ actor: &str,
+ ) -> Result<bool, CallError> {
+ Ok(sqlx::query!(
+ "DELETE FROM call_meeting_preparations WHERE id = $1 AND user_id = $2 AND meeting_id IS NULL",
+ id, actor
+ ).execute(&self.pool).await?.rows_affected() > 0)
+ }
+
+ pub(super) async fn fetch_preparation(
+ &self,
+ meeting_id: &Uuid,
+ ) -> Result<Option<MeetingPreparation>, CallError> {
+ Ok(sqlx::query_as!(MeetingPreparation,
+ "SELECT id, expires_at FROM call_meeting_preparations WHERE meeting_id = $1 AND expires_at > now()",
+ meeting_id
+ ).fetch_optional(&self.pool).await?)
+ }
+}
diff --git a/crates/call/src/outbound/pg_call_repo/test.rs b/crates/call/src/outbound/pg_call_repo/test.rs
index 2bda50d242..f2859b6ca8 100644
--- a/crates/call/src/outbound/pg_call_repo/test.rs
+++ b/crates/call/src/outbound/pg_call_repo/test.rs
@@ -3436,3 +3436,59 @@ async fn meeting_schedule_rejects_partial_or_reversed_ranges(
}
Ok(())
}
+
+#[sqlx::test(
+ fixtures(path = "../../../fixtures", scripts("call_repo")),
+ migrator = "MACRO_DB_MIGRATIONS"
+)]
+async fn attach_meeting_recording_survives_archival(pool: Pool<Postgres>) -> anyhow::Result<()> {
+ let repo = repo(pool);
+ assert!(
+ repo.attach_meeting_recording(&CALL1, "early-recording")
+ .await?
+ );
+ repo.archive_call(&CALL1).await?;
+ assert!(
+ repo.get_call_record_by_egress_id("early-recording")
+ .await?
+ .is_some()
+ );
+ assert!(
+ !repo
+ .attach_meeting_recording(&CALL1, "late-recording")
+ .await?
+ );
+ assert!(
+ repo.get_call_record_by_egress_id("late-recording")
+ .await?
+ .is_some()
+ );
+ assert!(
+ !repo
+ .attach_meeting_recording(&Uuid::now_v7(), "missing-recording")
+ .await?
+ );
+ Ok(())
+}
+
+#[sqlx::test(
+ fixtures(path = "../../../fixtures", scripts("call_repo")),
+ migrator = "MACRO_DB_MIGRATIONS"
+)]
+async fn attach_meeting_recording_racing_archival_keeps_the_recording(
+ pool: Pool<Postgres>,
+) -> anyhow::Result<()> {
+ let repo = repo(pool);
+ let (attachment, archival) = tokio::join!(
+ repo.attach_meeting_recording(&CALL1, "racing-recording"),
+ repo.archive_call(&CALL1),
+ );
+ attachment?;
+ archival?;
+ assert!(
+ repo.get_call_record_by_egress_id("racing-recording")
+ .await?
+ .is_some()
+ );
+ Ok(())
+}
diff --git a/crates/macro_db_client/migrations/20260930220335_call_meeting_preparations.sql b/crates/macro_db_client/migrations/20260930220335_call_meeting_preparations.sql
new file mode 100644
index 0000000000..c29528a956
--- /dev/null
+++ b/crates/macro_db_client/migrations/20260930220335_call_meeting_preparations.sql
@@ -0,0 +1,7 @@
+CREATE TABLE call_meeting_preparations (
+ id UUID PRIMARY KEY,
+ user_id TEXT NOT NULL REFERENCES "User"(id) ON DELETE CASCADE,
+ expires_at TIMESTAMPTZ NOT NULL,
+ meeting_id UUID UNIQUE REFERENCES call_meetings(id) ON DELETE CASCADE
+);
+CREATE INDEX call_meeting_preparations_expiry ON call_meeting_preparations(expires_at);
diff --git a/docs/AGENT_GUIDE/observability.md b/docs/AGENT_GUIDE/observability.md
index f14f721d91..a2db542683 100644
--- a/docs/AGENT_GUIDE/observability.md
+++ b/docs/AGENT_GUIDE/observability.md
@@ -65,8 +65,34 @@ trace context — timestamps + service are the only join for those.
inter-service client spans), so a trace tells you the route and latency but not why.
- Log lines from events outside spans (startup, pollers) have no trace_id; in-span events do
(structured metadata), so prefer erroring *handlers* as log entry points.
-- Frontend spans stop at the fetch: no spans for user interactions or the websocket-delivered
- results, so async flows (AI edits applying, message fan-out) have no trace at all.
+- Most frontend spans stop at the fetch: websocket-delivered results such as AI edits
+ applying and message fan-out remain untraced. Call joining now has a user-action
+ trace; see below.
+
+## Call joining
+
+Click **Start call** on `/app/meet/new` or **Join call** on a shared meeting's
+setup screen. Search Tempo for `{ name="meeting.join" }`. One browser trace
+covers an accepted button press through connection or failure:
+
+| Span | What it measures |
+| --- | --- |
+| `meeting.join.previous_session` | Waiting for previous session cleanup. |
+| `meeting.join.create` | Preparing the meeting link for a new call; absent for shared-link joins. |
+| `meeting.join.credentials` | Requesting join credentials, including backend room allocation. |
+| `meeting.join.connect` | Connecting the browser call session after receiving credentials. |
+
+The root records `meeting.join.kind` (`create` or `join`), guest status,
+microphone/camera preferences, `call.id` once credentials arrive, and
+`meeting.join.outcome` (`connected`, `failed`, `cancelled`, or `already_in_call`).
+It does not measure setup-page loading or completion of background media setup.
+Never add share tokens or RTC credentials to trace attributes or errors.
+
+The HTTP requests can have separate trace IDs across asynchronous mutation
+boundaries. Capture each request's `traceparent` as described above and inspect
+the backend trace as well. For the join request, compare `create_room`,
+`prepare_meeting_call`, and `join_invitation`; `start_meeting_media` runs in the
+background and must not be added to the time spent waiting for credentials.
## Agent sessions
diff --git a/docs/AGENT_GUIDE/surfaces.md b/docs/AGENT_GUIDE/surfaces.md
index 4693e06d94..89fedf254f 100644
--- a/docs/AGENT_GUIDE/surfaces.md
+++ b/docs/AGENT_GUIDE/surfaces.md
@@ -1202,7 +1202,20 @@ press `Join call`. Setup requests microphone permission and waits until that
prompt finishes before requesting the camera, then previews video locally;
sharing starts only after joining.
Permission denial leaves the affected device off and still allows joining.
+Shared-link setup shows the people currently connected, with avatars, names, and
+an attendee count. It refreshes every 15 seconds while setup is open; guests see
+this only for standalone links. Empty calls show `No one else is here yet`; a
+failed roster request leaves joining available. Transcription agents and past
+attendees are excluded.
+
The preview and full-width join button retain their size while joining.
+The call runtime preloads while setup is open. New-call setup also reserves an
+empty room, without starting a meeting, recording, or invitations. Leaving setup
+cancels that reservation; abandoned rooms expire after five minutes. Starting
+still works if preparation fails or expires.
+Entry waits for the room connection;
+teammate invitations continue afterward. For a newly started call, transcription
+and recording start in the background instead of delaying join credentials.
Copying the meeting URL is available after joining, in the in-call header.
The creator presses `Start call`; invitees press `Join call`. Loading the page or
@@ -1217,6 +1230,8 @@ for audio, video, device selection, screen sharing, and effects. `Leave call` re
to Macro. `Copy Meeting Url` is available during the call.
Rejoining from a new page waits for the prior page's pending leave cleanup before
requesting another connection, so a slow leave cannot disconnect the replacement.
+Leaving the last participant archives the session first and tears down its media
+in the background, so the next call does not wait for that room to be deleted.
It keeps its label and shows a checkmark for a few seconds after copying, then
restores the copy icon.
diff --git a/packages/sdk/generated/storage/index.ts b/packages/sdk/generated/storage/index.ts
index 825dc5c60b..9ecebaa6da 100644
--- a/packages/sdk/generated/storage/index.ts
+++ b/packages/sdk/generated/storage/index.ts
@@ -1,4 +1,4 @@
// This file is auto-generated by @hey-api/openapi-ts
export { type Options, Sdk } from './sdk.gen';
-export type { AccessLevel, ActiveCallsResponse, ActiveCallSummary, ActiveMeeting, ActiveMeetingsResponse, ActivityType, AddFavoriteData, AddFavoriteError, AddFavoriteErrors, AddFavoriteRequest, AddFavoriteResponse, AddFavoriteResponses, AddParticipantsData, AddParticipantsError, AddParticipantsErrors, AddParticipantsRequest, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerError, AddPinHandlerErrors, AddPinHandlerResponse, AddPinHandlerResponses, AddPinRequest, Agent, AgentActionId, AgentChannelScope, AgentMcpServer, AgentMcpServers, AgentPullRequestState, AgentSessionFilters, AgentSessionLifecycleEvent, Anchor, AnchorId, AnchorRequest, AnchorResponse, AnnotationIncrementalUpdate, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelContextMessage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelMessage, ApiChannelMessageKind, ApiChannelMessagesPage, ApiChannelParticipant, ApiChannelWithLatest, ApiCountedReaction, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiMessageAttachment, ApiMessageSender, ApiMessageSenderType, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, ApiResolvedChannelMessage, ApiThreadInfo, ApiThreadReply, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AssignInitiativeTasksData, AssignInitiativeTasksError, AssignInitiativeTasksErrors, AssignInitiativeTasksResponse, AssignInitiativeTasksResponses, AssignTasksRequest, AssignTasksResponse, AssignTasksResult, AssignTaskStatus, AttachmentChange, AttendeeResponseStatus, BasicDocument, BasicDocumentSubType, BomPart, Bot, BotChannel, BotChannelType, BotId, BotKind, BotOwner, BotOwnerProfile, BotSenderProfile, BotToken, BranchNameResponse, BTreeMap, BulkWakeupRequest, BulkWakeupResponse, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponse, BulkWakeupSyncServiceDocumentsResponses, CalendarAttendee, CalendarEvent, CalendarEventFilters, CalendarEventSourceContent, CalendarMentionEvent, CalendarMentionPreviewItem, CalendarMentionPreviewKind, CalendarMentionPreviewRequest, CalendarMentionPreviewRequestItem, CalendarMentionPreviewResponse, CalendarOccurrence, CalendarOccurrenceItem, CalendarOccurrenceResponse, CalendarSyncStatus, CallActiveResponse, CallFilters, CallRecord, CallRecordGuest, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData, CallRecordTranscriptSegment, CallStatus, CallTokenResponse, CallWebhookData, CallWebhookError, CallWebhookErrors, CallWebhookResponses, Channel, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelEventAttachment, ChannelFilters, ChannelJoinCodeResponse, ChannelLabel, ChannelLabelRule, ChannelLabelsList, ChannelMentionedMetadata, ChannelMessage, ChannelMessageAttachmentCreatedMetadata, ChannelMessageAttachmentRemovedMetadata, ChannelMessageDeletedMetadata, ChannelMessageFilters, ChannelMessagePatchedMetadata, ChannelMessagePostedMetadata, ChannelParticipant, ChannelParticipantAddedMetadata, ChannelParticipantRemovedMetadata, ChannelPreview, ChannelPreviewData, ChannelSender, ChannelSharePermission, ChannelThreadFilters, ChannelTopicEvent, ChannelType, ChannelUpdatedMetadata, ChannelWebhookRequest, ChannelWebhookResponse, ChannelWithParticipants, Chat, ChatFilters, CheckActiveCallData, CheckActiveCallError, CheckActiveCallErrors, CheckActiveCallResponse, CheckActiveCallResponses, ClaimedPairing, ClaimHarnessPairingData, ClaimHarnessPairingError, ClaimHarnessPairingErrors, ClaimHarnessPairingResponse, ClaimHarnessPairingResponses, ClaimPairingRequest, ClientOptions, CloudStorageItemType, CollabSurfaceResponse, CollabSurfaceTokenResponse, Comment, CommentThread, ConferenceProvider, CopyDocumentData, CopyDocumentError, CopyDocumentErrors, CopyDocumentQueryParams, CopyDocumentRequest, CopyDocumentResponse, CopyDocumentResponse2, CopyDocumentResponses, CountedReaction, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentRequest, CreateAgentResponse, CreateAgentResponses, CreateAnchorData, CreateAnchorError, CreateAnchorErrors, CreateAnchorResponse, CreateAnchorResponses, CreateBotRequest, CreateBulkDocumentResponse, CreateBulkDocumentResponseData, CreateChannelData, CreateChannelError, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelError, CreateChannelLabelErrors, CreateChannelLabelRequest, CreateChannelLabelResponse, CreateChannelLabelResponses, CreateChannelRequest, CreateChannelResponse, CreateChannelResponse2, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotError, CreateChannelScopedBotErrors, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse, CreateChannelScopedBotResponse2, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenError, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponse, CreateCollabSurfaceTokenResponses, CreateCommentData, CreateCommentError, CreateCommentErrors, CreateCommentRequest, CreateCommentResponse, CreateCommentResponse2, CreateCommentResponses, CreateCrmCommentData, CreateCrmCommentError, CreateCrmCommentErrors, CreateCrmCommentRequest, CreateCrmCommentResponse, CreateCrmCommentResponses, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateInitiativeData, CreateInitiativeError, CreateInitiativeErrors, CreateInitiativeRequest, CreateInitiativeResponse, CreateInitiativeResponses, CreateInstructionsDocumentResponse, CreateInstructionsHandlerData, CreateInstructionsHandlerError, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponse, CreateInstructionsHandlerResponses, CreateMarkdownDocumentRequest, CreateMarkdownDocumentResponse, CreateMarkdownHandlerData, CreateMarkdownHandlerError, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponse, CreateMarkdownHandlerResponses, CreateMeetingRequest, CreatePairingRequest, CreateProjectHandlerData, CreateProjectHandlerError, CreateProjectHandlerErrors, CreateProjectHandlerResponse, CreateProjectHandlerResponses, CreateProjectRequest, CreateProjectResponse, CreateReminderData, CreateReminderError, CreateReminderErrors, CreateReminderRequest, CreateReminderResponse, CreateReminderResponses, CreateSkillHandlerData, CreateSkillHandlerError, CreateSkillHandlerErrors, CreateSkillHandlerResponse, CreateSkillHandlerResponses, CreateSkillRequest, CreateSkillResponse, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmComment, CrmCommentEntityType, CrmCommentThread, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CrmThread, CustomSpeakerAssignment, DataType, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorInfo, DeleteAnchorResponse, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelError, DeleteChannelLabelErrors, DeleteChannelLabelResponse, DeleteChannelLabelResponses, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, DeleteCommentData, DeleteCommentError, DeleteCommentErrors, DeleteCommentRequest, DeleteCommentResponse, DeleteCommentResponse2, DeleteCommentResponses, DeleteCrmCommentData, DeleteCrmCommentError, DeleteCrmCommentErrors, DeleteCrmCommentResponse, DeleteCrmCommentResponses, DeleteCrmCommentResult, DeleteDocumentData, DeleteDocumentError, DeleteDocumentErrors, DeleteDocumentResponse, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionError, DeleteEntityMentionErrors, DeleteEntityMentionResponse, DeleteEntityMentionResponse2, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessError, DeleteHarnessErrors, DeleteHarnessResponse, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerError, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponse, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeError, DeleteInitiativeErrors, DeleteInitiativeResponse, DeleteInitiativeResponses, DeleteMessageData, DeleteMessageError, DeleteMessageErrors, DeleteMessageQuery, DeleteMessageResponse, DeleteMessageResponses, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteReminderData, DeleteReminderError, DeleteReminderErrors, DeleteReminderResponse, DeleteReminderResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, DeleteThreadInfo, DeleteUnthreadedAnchorRequest, DeleteUnthreadedAnchorResponse, DeleteUnthreadedPdfAnchorRequest, DeleteUserApiKeyData, DeleteUserApiKeyError, DeleteUserApiKeyErrors, DeleteUserApiKeyResponse, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationError, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponse, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerError, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookError, DeleteWebhookErrors, DeleteWebhookResponse, DeleteWebhookResponses, DescriptionDocumentId, DocumentBasic, DocumentContent, DocumentContentLocation, DocumentContentState, DocumentContentUploadedMetadata, DocumentCopiedMetadata, DocumentCreatedMetadata, DocumentDeletedMetadata, DocumentFilters, DocumentId, DocumentInteractionMetadata, DocumentMetadata, DocumentMetadataWithContent, DocumentPermissionsToken, DocumentPermissionsTokenRequest, DocumentPermissionsTokenResponse, DocumentPreview, DocumentPreviewData, DocumentPreviewDataSubType, DocumentPurgedMetadata, DocumentResponse, DocumentResponseMetadata, DocumentResponseMetadataWithContent, DocumentStorageServiceApiVersion, DocumentSubType, DocumentSyncContentUpdatedMetadata, DocumentSyncEditor, DocumentTeamShareResponse, DocumentTopicEvent, DocumentUpdatedMetadata, EditAnchorData, EditAnchorError, EditAnchorErrors, EditAnchorRequest, EditAnchorResponse, EditAnchorResponse2, EditAnchorResponses, EditCallRecordData, EditCallRecordError, EditCallRecordErrors, EditCallRecordRequest, EditCallRecordResponse, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptError, EditCallTranscriptErrors, EditCallTranscriptRequest, EditCallTranscriptResponse, EditCallTranscriptResponses, EditCommentData, EditCommentError, EditCommentErrors, EditCommentRequest, EditCommentResponse, EditCommentResponse2, EditCommentResponses, EditCrmCommentData, EditCrmCommentError, EditCrmCommentErrors, EditCrmCommentRequest, EditCrmCommentResponse, EditCrmCommentResponses, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EntityFilters, EntityMessageCreateData, EntityMessageCreateResponse, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponse, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponse, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponse, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponse, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponse, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponse, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponse, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponse, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponse, EntityMessageTypingResponses, EntityPermission, EntityPermissionResponse, EntityReference, EntityType, ErrorResponse, EventReminderOverride, EventReminders, EventStatus, EventTime, EventTransparency, EventType, EventVisibility, ExcludedDefaultView, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerError, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExcludeDefaultViewRequest, ExportDocumentData, ExportDocumentError, ExportDocumentErrors, ExportDocumentResponse, ExportDocumentResponse2, ExportDocumentResponses, Favorite, FavoriteEntityRef, FavoritesList, FileSystemNodeWithIds, FileType, FileTypeUpdate, FolderItem, ForeignEntity, ForeignEntityFilters, GenericErrorResponse, GenericResponse, GenericSuccessResponse, GetActiveCallsData, GetActiveCallsError, GetActiveCallsErrors, GetActiveCallsResponse, GetActiveCallsResponses, GetActivityData, GetActivityError, GetActivityErrors, GetActivityResponse, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesError, GetAttachmentReferencesErrors, GetAttachmentReferencesResponse, GetAttachmentReferencesResponse2, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewError, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewRequest, GetBatchCallRecordPreviewResponse, GetBatchCallRecordPreviewResponse2, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewError, GetBatchChannelPreviewErrors, GetBatchChannelPreviewRequest, GetBatchChannelPreviewResponse, GetBatchChannelPreviewResponse2, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerError, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponse, GetBatchPreviewHandlerResponses, GetBatchPreviewRequest, GetBatchPreviewResponse, GetBatchProjectPreviewData, GetBatchProjectPreviewError, GetBatchProjectPreviewErrors, GetBatchProjectPreviewRequest, GetBatchProjectPreviewResponse, GetBatchProjectPreviewResponse2, GetBatchProjectPreviewResponses, GetBotOwnerProfilesData, GetBotOwnerProfilesError, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponse, GetBotOwnerProfilesResponses, GetCallRecordData, GetCallRecordError, GetCallRecordErrors, GetCallRecordResponse, GetCallRecordResponses, GetChannelAttachmentsData, GetChannelAttachmentsError, GetChannelAttachmentsErrors, GetChannelAttachmentsResponse, GetChannelAttachmentsResponses, GetChannelData, GetChannelError, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkError, GetChannelJoinLinkErrors, GetChannelJoinLinkResponse, GetChannelJoinLinkResponses, GetChannelMessagesCatchUpData, GetChannelMessagesCatchUpError, GetChannelMessagesCatchUpErrors, GetChannelMessagesCatchUpResponse, GetChannelMessagesCatchUpResponses, GetChannelMessagesData, GetChannelMessagesError, GetChannelMessagesErrors, GetChannelMessagesResponse, GetChannelMessagesResponses, GetChannelParticipantsData, GetChannelParticipantsError, GetChannelParticipantsErrors, GetChannelParticipantsResponse, GetChannelParticipantsResponses, GetChannelResponse, GetChannelResponses, GetChannelsData, GetChannelsError, GetChannelsErrors, GetChannelsResponse, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceError, GetCollabSurfaceErrors, GetCollabSurfaceResponse, GetCollabSurfaceResponses, GetCompanyData, GetCompanyError, GetCompanyErrors, GetCompanyResponse, GetCompanyResponses, GetContactByEmailData, GetContactByEmailError, GetContactByEmailErrors, GetContactByEmailResponse, GetContactByEmailResponse2, GetContactByEmailResponses, GetContactData, GetContactError, GetContactErrors, GetContactResponse, GetContactResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsError, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponse, GetCrmTeamSettingsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, GetDocumentCommentsData, GetDocumentCommentsError, GetDocumentCommentsErrors, GetDocumentCommentsResponse, GetDocumentCommentsResponses, GetDocumentData, GetDocumentError, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsError, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponse, GetDocumentGithubPullRequestsResponses, GetDocumentKeyResponse, GetDocumentKeyResponseData, GetDocumentListHandlerData, GetDocumentListHandlerError, GetDocumentListHandlerErrors, GetDocumentListHandlerResponse, GetDocumentListHandlerResponses, GetDocumentListResult, GetDocumentLocationV3Data, GetDocumentLocationV3Error, GetDocumentLocationV3Errors, GetDocumentLocationV3Response, GetDocumentLocationV3Responses, GetDocumentPermissionsResponseDataV2, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenError, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponse, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Error, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Response, GetDocumentPermissionsV2Responses, GetDocumentProcessingResult, GetDocumentProcessingResultData, GetDocumentProcessingResultError, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponse, GetDocumentProcessingResultResponse2, GetDocumentProcessingResultResponses, GetDocumentResponse, GetDocumentResponse2, GetDocumentResponseData, GetDocumentResponses, GetDocumentSearchResponse, GetDocumentShortIdData, GetDocumentShortIdError, GetDocumentShortIdErrors, GetDocumentShortIdResponse, GetDocumentShortIdResponses, GetDocumentsResponse, GetDocumentTeamShareData, GetDocumentTeamShareError, GetDocumentTeamShareErrors, GetDocumentTeamShareResponse, GetDocumentTeamShareResponses, GetDocumentUserAccessLevelResponse, GetDocumentVersionData, GetDocumentVersionError, GetDocumentVersionErrors, GetDocumentVersionResponse, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerError, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponse, GetDocumentViewsHandlerResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponse, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceError, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponse, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityError, GetForeignEntityErrors, GetForeignEntityResponse, GetForeignEntityResponses, GetHarnessPairingData, GetHarnessPairingError, GetHarnessPairingErrors, GetHarnessPairingResponse, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerError, GetHistoryHandlerErrors, GetHistoryHandlerResponse, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeError, GetInitiativeErrors, GetInitiativeResponse, GetInitiativeResponses, GetInstructionsDocumentResponse, GetInstructionsHandlerData, GetInstructionsHandlerError, GetInstructionsHandlerErrors, GetInstructionsHandlerResponse, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupError, GetItemsSoupErrors, GetItemsSoupResponse, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerError, GetLocationHandlerErrors, GetLocationHandlerResponse, GetLocationHandlerResponses, GetMessageWithContextData, GetMessageWithContextError, GetMessageWithContextErrors, GetMessageWithContextResponse, GetMessageWithContextResponse2, GetMessageWithContextResponses, GetOrCreateAction, GetOrCreateCallData, GetOrCreateCallError, GetOrCreateCallErrors, GetOrCreateCallResponse, GetOrCreateCallResponses, GetOrCreateChannelResponse, GetOrCreateDmData, GetOrCreateDmError, GetOrCreateDmErrors, GetOrCreateDmRequest, GetOrCreateDmResponse, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateError, GetOrCreatePrivateErrors, GetOrCreatePrivateRequest, GetOrCreatePrivateResponse, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerError, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponse, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerError, GetPinsHandlerErrors, GetPinsHandlerResponse, GetPinsHandlerResponses, GetPinsResponse, GetProjectContentHandlerData, GetProjectContentHandlerError, GetProjectContentHandlerErrors, GetProjectContentHandlerResponse, GetProjectContentHandlerResponses, GetProjectContentResponse, GetProjectHandlerData, GetProjectHandlerError, GetProjectHandlerErrors, GetProjectHandlerResponse, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Error, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Response, GetProjectPermissionsV2Responses, GetProjectResponse, GetProjectResponseData, GetProjectsHandlerData, GetProjectsHandlerError, GetProjectsHandlerErrors, GetProjectsHandlerResponse, GetProjectsHandlerResponses, GetProjectsResponse, GetProjectUserAccessLevelData, GetProjectUserAccessLevelError, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponse, GetProjectUserAccessLevelResponses, GetReminderData, GetReminderError, GetReminderErrors, GetReminderResponse, GetReminderResponses, GetRingStatusData, GetRingStatusError, GetRingStatusErrors, GetRingStatusResponse, GetRingStatusResponses, GetSelfBotData, GetSelfBotError, GetSelfBotErrors, GetSelfBotResponse, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessError, GetSelfHarnessErrors, GetSelfHarnessResponse, GetSelfHarnessResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, GetThreadRepliesData, GetThreadRepliesError, GetThreadRepliesErrors, GetThreadRepliesResponse, GetThreadRepliesResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerError, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponse, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationError, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponse, GetUserDocumentViewLocationResponses, GetUserHistoryResponse, GetViewsHandlerData, GetViewsHandlerError, GetViewsHandlerErrors, GetViewsHandlerResponse, GetViewsHandlerResponses, GetWebhookData, GetWebhookError, GetWebhookErrors, GetWebhookResponse, GetWebhookResponses, GithubPullRequest, GithubPullRequestCheckRun, GithubPullRequestComment, GithubPullRequestsResponse, GroupedInitialParams, GroupedPageParams, GroupedSoupGroupPage, GroupedSoupInitialPage, GroupedSoupPage, GroupedSoupSort, GuestId, GuestJoinRequest, HandlerData, HandlerError, HandlerErrors, HandlerResponse, HandlerResponses, Harness, HarnessAgent, HarnessId, HarnessOwner, HarnessSession, HashMap, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, HighlightType, ImportedAuthor, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InitiativeDetail, InitiativeFilters, InitiativeId, InitiativeList, InitiativeSummary, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, InviteMeetingRequest, InviteMeetingUsersRequest, Item, ItemWithUserAccessLevel, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, LatestMessage, LeaveCallResponse, LeaveChannelData, LeaveChannelError, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallError, LeaveOrEndCallErrors, LeaveOrEndCallResponse, LeaveOrEndCallResponses, LinkShare, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListBotChannelsData, ListBotChannelsError, ListBotChannelsErrors, ListBotChannelsResponse, ListBotChannelsResponses, ListChannelLabelsData, ListChannelLabelsError, ListChannelLabelsErrors, ListChannelLabelsResponse, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsError, ListCompanyContactsErrors, ListCompanyContactsResponse, ListCompanyContactsResponses, ListCrmCommentsData, ListCrmCommentsError, ListCrmCommentsErrors, ListCrmCommentsResponse, ListCrmCommentsResponses, ListFavoritesData, ListFavoritesError, ListFavoritesErrors, ListFavoritesResponse, ListFavoritesResponses, ListHarnessAgentsData, ListHarnessAgentsError, ListHarnessAgentsErrors, ListHarnessAgentsResponse, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesError, ListHarnessesErrors, ListHarnessesResponse, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsError, ListHarnessSessionsErrors, ListHarnessSessionsResponse, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesError, ListInitiativesErrors, ListInitiativesResponse, ListInitiativesResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponse, ListOccurrencesResponses, ListRemindersData, ListRemindersError, ListRemindersErrors, ListRemindersResponse, ListRemindersResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponse, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysError, ListUserApiKeysErrors, ListUserApiKeysResponse, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksError, ListWebhooksErrors, ListWebhooksResponse, ListWebhooksResponse2, ListWebhooksResponses, LocationResponseData, LocationResponseV3, MacroUserIdStr, Meeting, MeetingCancelData, MeetingCancelError, MeetingCancelErrors, MeetingCancelResponse, MeetingCancelResponses, MeetingCreateData, MeetingCreateError, MeetingCreateErrors, MeetingCreateResponse, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinError, MeetingGuestJoinErrors, MeetingGuestJoinResponse, MeetingGuestJoinResponses, MeetingInviteData, MeetingInviteError, MeetingInviteErrors, MeetingInvitePermissions, MeetingInvitePermissionsData, MeetingInvitePermissionsError, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponse, MeetingInvitePermissionsResponses, MeetingInviteResponse, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersError, MeetingInviteUsersErrors, MeetingInviteUsersResponse, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinError, MeetingJoinErrors, MeetingJoinResponse, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveError, MeetingLeaveErrors, MeetingLeaveResponse, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveError, MeetingListActiveErrors, MeetingListActiveResponse, MeetingListActiveResponses, MeetingListData, MeetingListError, MeetingListErrors, MeetingListResponse, MeetingListResponses, MeetingLookupData, MeetingLookupError, MeetingLookupErrors, MeetingLookupResponse, MeetingLookupResponses, MeetingShareData, MeetingShareError, MeetingShareErrors, MeetingShareResponse, MeetingShareResponses, MeetingsResponse, MeetingToken, MeetingUpdateData, MeetingUpdateError, MeetingUpdateErrors, MeetingUpdateResponse, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponse, MentionPreviewsResponses, Mentions, Message, MessageAttachment, MessageChange, MessageCursor, MessageDirection, MessageEvent, MessageListItem, MessagePage, MessageParent, MessagePatch, MessageThread, MessageThreadPreview, MessageTimelineData, MessageTimelineQuery, MessageTimelineResponse, MessageTimelineResponses, NewAttachment, NewChannelAttachment, NewThreadAnchor, NotificationFilters, NotificationState, PairingDetails, Params, ParticipantRole, PatchBotRequest, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchMessageData, PatchMessageError, PatchMessageErrors, PatchMessageNotificationPolicy, PatchMessageRequest, PatchMessageResponse, PatchMessageResponses, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfAnchorRequest, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PdfPlaceableCommentAnchorRequest, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostChannelMessagesData, PostChannelMessagesError, PostChannelMessagesErrors, PostChannelMessagesResponse, PostChannelMessagesResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessage, PostMessageData, PostMessageError, PostMessageErrors, PostMessageNotificationPolicy, PostMessageRequest, PostMessageResponse, PostMessageResponse2, PostMessageResponses, PostReactionData, PostReactionError, PostReactionErrors, PostReactionRequest, PostReactionResponse, PostReactionResponses, PostSoupAstRequest, PostSoupRequest, PostTypingData, PostTypingError, PostTypingErrors, PostTypingRequest, PostTypingResponse, PostTypingResponses, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresignedUrl, PreviewSmartTagData, PreviewSmartTagError, PreviewSmartTagErrors, PreviewSmartTagResponse, PreviewSmartTagResponses, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyDefinition, PropertyFilter, PropertyInput, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, ReactionAction, ReactionInput, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, Reminder, ReminderFilters, ReminderSchedule, RemindersList, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotError, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponse, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityError, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsError, RemoveParticipantsErrors, RemoveParticipantsRequest, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerError, RemovePinHandlerErrors, RemovePinHandlerResponse, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelError, RenameChannelLabelErrors, RenameChannelLabelRequest, RenameChannelLabelResponse, RenameChannelLabelResponses, ReorderFavoritesData, ReorderFavoritesError, ReorderFavoritesErrors, ReorderFavoritesRequest, ReorderFavoritesResponses, ReorderPinRequest, ReorderPinsHandlerData, ReorderPinsHandlerError, ReorderPinsHandlerErrors, ReorderPinsHandlerResponse, ReorderPinsHandlerResponses, ReplaceCrmStagesRequest, RequestedHarnessScope, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, ResolveChannelMessageData, ResolveChannelMessageError, ResolveChannelMessageErrors, ResolveChannelMessageResponse, ResolveChannelMessageResponses, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RingStatus, RingStatusResponse, S3ObjectInfo, SaveBomPart, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SessionDeletedMetadata, SessionIdentity, SessionMentionedMetadata, SessionOpenedMetadata, SessionRenamedMetadata, SessionSettledMetadata, SessionStoppedMetadata, SetChannelLabelData, SetChannelLabelError, SetChannelLabelErrors, SetChannelLabelRequest, SetChannelLabelResponse, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureError, SetChannelPictureErrors, SetChannelPictureRequest, SetChannelPictureResponse, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenError, SetCompanyHiddenErrors, SetCompanyHiddenRequest, SetCompanyHiddenResponse, SetCompanyHiddenResponses, SetCompanyNameRequest, SetContactHiddenData, SetContactHiddenError, SetContactHiddenErrors, SetContactHiddenRequest, SetContactHiddenResponse, SetContactHiddenResponses, SetContactNameRequest, SetCrmCompanyNameData, SetCrmCompanyNameError, SetCrmCompanyNameErrors, SetCrmCompanyNameResponse, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameError, SetCrmContactNameErrors, SetCrmContactNameResponse, SetCrmContactNameResponses, SetDocumentTeamShareData, SetDocumentTeamShareError, SetDocumentTeamShareErrors, SetDocumentTeamShareRequest, SetDocumentTeamShareResponse, SetDocumentTeamShareResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetPropertyValue, SharedEmailFilter, SharePermissionV2, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SmartTagChannelMatch, SmartTagPreview, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordGuest, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmDomain, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupInitiativeSoupPropertiesField, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupReminderReference, SoupReminderSchedule, SoupReminderSoupPropertiesField, SoupThreadInfo, SoupThreadReply, StarterDocumentsResponse, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, TagFilterMode, TaskFilters, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, Thread, ThreadAnchor, ThreadOrigin, ThreadPatch, ThreadResponse, ThreadState, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TranscribeDictationData, TranscribeDictationError, TranscribeDictationErrors, TranscribeDictationResponse, TranscribeDictationResponses, TranscribeResponse, TranscriptSegmentRequest, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingAction, TypingInput, UnassignInitiativeTaskData, UnassignInitiativeTaskError, UnassignInitiativeTaskErrors, UnassignInitiativeTaskResponse, UnassignInitiativeTaskResponses, UnthreadedPdfUuidRequest, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmTeamSettingsRequest, UpdateInitiativeData, UpdateInitiativeError, UpdateInitiativeErrors, UpdateInitiativeRequest, UpdateInitiativeResponse, UpdateInitiativeResponses, UpdateMeetingRequest, UpdateOperation, UpdateReminderData, UpdateReminderError, UpdateReminderErrors, UpdateReminderRequest, UpdateReminderResponse, UpdateReminderResponses, UpdateSharePermissionRequestV2, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UpsertHistoryHandlerData, UpsertHistoryHandlerError, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponse, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationError, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationRequest, UpsertUserDocumentViewLocationResponse, UpsertUserDocumentViewLocationResponses, UserApiKeyId, UserApiKeyInfo, UserApiKeysList, UserDocumentsResponse, UserDocumentViewLocation, UserDocumentViewLocationResponse, UserPinsResponse, UserViewsResponse, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenError, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponse, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookError, ValidateWebhookErrors, ValidateWebhookResponse, ValidateWebhookResponse2, ValidateWebhookResponses, Vec, View, ViewPatch, ViewsResponse, WaitingForInputMetadata, Webhook, WebhookEvent, WebhookFilter, WebhookScope, WebhookStatus, WebhookValidationTestEvent, WithCallId, WithChannelId, WithDocumentId, WithProjectId } from './types.gen';
+export type { AccessLevel, ActiveCallsResponse, ActiveCallSummary, ActiveMeeting, ActiveMeetingsResponse, ActivityType, AddFavoriteData, AddFavoriteError, AddFavoriteErrors, AddFavoriteRequest, AddFavoriteResponse, AddFavoriteResponses, AddParticipantsData, AddParticipantsError, AddParticipantsErrors, AddParticipantsRequest, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerError, AddPinHandlerErrors, AddPinHandlerResponse, AddPinHandlerResponses, AddPinRequest, Agent, AgentActionId, AgentChannelScope, AgentMcpServer, AgentMcpServers, AgentPullRequestState, AgentSessionFilters, AgentSessionLifecycleEvent, Anchor, AnchorId, AnchorRequest, AnchorResponse, AnnotationIncrementalUpdate, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelContextMessage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelMessage, ApiChannelMessageKind, ApiChannelMessagesPage, ApiChannelParticipant, ApiChannelWithLatest, ApiCountedReaction, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiMessageAttachment, ApiMessageSender, ApiMessageSenderType, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, ApiResolvedChannelMessage, ApiThreadInfo, ApiThreadReply, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AssignInitiativeTasksData, AssignInitiativeTasksError, AssignInitiativeTasksErrors, AssignInitiativeTasksResponse, AssignInitiativeTasksResponses, AssignTasksRequest, AssignTasksResponse, AssignTasksResult, AssignTaskStatus, AttachmentChange, AttendeeResponseStatus, BasicDocument, BasicDocumentSubType, BomPart, Bot, BotChannel, BotChannelType, BotId, BotKind, BotOwner, BotOwnerProfile, BotSenderProfile, BotToken, BranchNameResponse, BTreeMap, BulkWakeupRequest, BulkWakeupResponse, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponse, BulkWakeupSyncServiceDocumentsResponses, CalendarAttendee, CalendarEvent, CalendarEventFilters, CalendarEventSourceContent, CalendarMentionEvent, CalendarMentionPreviewItem, CalendarMentionPreviewKind, CalendarMentionPreviewRequest, CalendarMentionPreviewRequestItem, CalendarMentionPreviewResponse, CalendarOccurrence, CalendarOccurrenceItem, CalendarOccurrenceResponse, CalendarSyncStatus, CallActiveResponse, CallFilters, CallRecord, CallRecordGuest, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData, CallRecordTranscriptSegment, CallStatus, CallTokenResponse, CallWebhookData, CallWebhookError, CallWebhookErrors, CallWebhookResponses, Channel, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelEventAttachment, ChannelFilters, ChannelJoinCodeResponse, ChannelLabel, ChannelLabelRule, ChannelLabelsList, ChannelMentionedMetadata, ChannelMessage, ChannelMessageAttachmentCreatedMetadata, ChannelMessageAttachmentRemovedMetadata, ChannelMessageDeletedMetadata, ChannelMessageFilters, ChannelMessagePatchedMetadata, ChannelMessagePostedMetadata, ChannelParticipant, ChannelParticipantAddedMetadata, ChannelParticipantRemovedMetadata, ChannelPreview, ChannelPreviewData, ChannelSender, ChannelSharePermission, ChannelThreadFilters, ChannelTopicEvent, ChannelType, ChannelUpdatedMetadata, ChannelWebhookRequest, ChannelWebhookResponse, ChannelWithParticipants, Chat, ChatFilters, CheckActiveCallData, CheckActiveCallError, CheckActiveCallErrors, CheckActiveCallResponse, CheckActiveCallResponses, ClaimedPairing, ClaimHarnessPairingData, ClaimHarnessPairingError, ClaimHarnessPairingErrors, ClaimHarnessPairingResponse, ClaimHarnessPairingResponses, ClaimPairingRequest, ClientOptions, CloudStorageItemType, CollabSurfaceResponse, CollabSurfaceTokenResponse, Comment, CommentThread, ConferenceProvider, CopyDocumentData, CopyDocumentError, CopyDocumentErrors, CopyDocumentQueryParams, CopyDocumentRequest, CopyDocumentResponse, CopyDocumentResponse2, CopyDocumentResponses, CountedReaction, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentRequest, CreateAgentResponse, CreateAgentResponses, CreateAnchorData, CreateAnchorError, CreateAnchorErrors, CreateAnchorResponse, CreateAnchorResponses, CreateBotRequest, CreateBulkDocumentResponse, CreateBulkDocumentResponseData, CreateChannelData, CreateChannelError, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelError, CreateChannelLabelErrors, CreateChannelLabelRequest, CreateChannelLabelResponse, CreateChannelLabelResponses, CreateChannelRequest, CreateChannelResponse, CreateChannelResponse2, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotError, CreateChannelScopedBotErrors, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse, CreateChannelScopedBotResponse2, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenError, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponse, CreateCollabSurfaceTokenResponses, CreateCommentData, CreateCommentError, CreateCommentErrors, CreateCommentRequest, CreateCommentResponse, CreateCommentResponse2, CreateCommentResponses, CreateCrmCommentData, CreateCrmCommentError, CreateCrmCommentErrors, CreateCrmCommentRequest, CreateCrmCommentResponse, CreateCrmCommentResponses, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateInitiativeData, CreateInitiativeError, CreateInitiativeErrors, CreateInitiativeRequest, CreateInitiativeResponse, CreateInitiativeResponses, CreateInstructionsDocumentResponse, CreateInstructionsHandlerData, CreateInstructionsHandlerError, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponse, CreateInstructionsHandlerResponses, CreateMarkdownDocumentRequest, CreateMarkdownDocumentResponse, CreateMarkdownHandlerData, CreateMarkdownHandlerError, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponse, CreateMarkdownHandlerResponses, CreateMeetingRequest, CreatePairingRequest, CreateProjectHandlerData, CreateProjectHandlerError, CreateProjectHandlerErrors, CreateProjectHandlerResponse, CreateProjectHandlerResponses, CreateProjectRequest, CreateProjectResponse, CreateReminderData, CreateReminderError, CreateReminderErrors, CreateReminderRequest, CreateReminderResponse, CreateReminderResponses, CreateSkillHandlerData, CreateSkillHandlerError, CreateSkillHandlerErrors, CreateSkillHandlerResponse, CreateSkillHandlerResponses, CreateSkillRequest, CreateSkillResponse, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmComment, CrmCommentEntityType, CrmCommentThread, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CrmThread, CustomSpeakerAssignment, DataType, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorInfo, DeleteAnchorResponse, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelError, DeleteChannelLabelErrors, DeleteChannelLabelResponse, DeleteChannelLabelResponses, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, DeleteCommentData, DeleteCommentError, DeleteCommentErrors, DeleteCommentRequest, DeleteCommentResponse, DeleteCommentResponse2, DeleteCommentResponses, DeleteCrmCommentData, DeleteCrmCommentError, DeleteCrmCommentErrors, DeleteCrmCommentResponse, DeleteCrmCommentResponses, DeleteCrmCommentResult, DeleteDocumentData, DeleteDocumentError, DeleteDocumentErrors, DeleteDocumentResponse, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionError, DeleteEntityMentionErrors, DeleteEntityMentionResponse, DeleteEntityMentionResponse2, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessError, DeleteHarnessErrors, DeleteHarnessResponse, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerError, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponse, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeError, DeleteInitiativeErrors, DeleteInitiativeResponse, DeleteInitiativeResponses, DeleteMessageData, DeleteMessageError, DeleteMessageErrors, DeleteMessageQuery, DeleteMessageResponse, DeleteMessageResponses, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteReminderData, DeleteReminderError, DeleteReminderErrors, DeleteReminderResponse, DeleteReminderResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, DeleteThreadInfo, DeleteUnthreadedAnchorRequest, DeleteUnthreadedAnchorResponse, DeleteUnthreadedPdfAnchorRequest, DeleteUserApiKeyData, DeleteUserApiKeyError, DeleteUserApiKeyErrors, DeleteUserApiKeyResponse, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationError, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponse, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerError, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookError, DeleteWebhookErrors, DeleteWebhookResponse, DeleteWebhookResponses, DescriptionDocumentId, DocumentBasic, DocumentContent, DocumentContentLocation, DocumentContentState, DocumentContentUploadedMetadata, DocumentCopiedMetadata, DocumentCreatedMetadata, DocumentDeletedMetadata, DocumentFilters, DocumentId, DocumentInteractionMetadata, DocumentMetadata, DocumentMetadataWithContent, DocumentPermissionsToken, DocumentPermissionsTokenRequest, DocumentPermissionsTokenResponse, DocumentPreview, DocumentPreviewData, DocumentPreviewDataSubType, DocumentPurgedMetadata, DocumentResponse, DocumentResponseMetadata, DocumentResponseMetadataWithContent, DocumentStorageServiceApiVersion, DocumentSubType, DocumentSyncContentUpdatedMetadata, DocumentSyncEditor, DocumentTeamShareResponse, DocumentTopicEvent, DocumentUpdatedMetadata, EditAnchorData, EditAnchorError, EditAnchorErrors, EditAnchorRequest, EditAnchorResponse, EditAnchorResponse2, EditAnchorResponses, EditCallRecordData, EditCallRecordError, EditCallRecordErrors, EditCallRecordRequest, EditCallRecordResponse, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptError, EditCallTranscriptErrors, EditCallTranscriptRequest, EditCallTranscriptResponse, EditCallTranscriptResponses, EditCommentData, EditCommentError, EditCommentErrors, EditCommentRequest, EditCommentResponse, EditCommentResponse2, EditCommentResponses, EditCrmCommentData, EditCrmCommentError, EditCrmCommentErrors, EditCrmCommentRequest, EditCrmCommentResponse, EditCrmCommentResponses, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EntityFilters, EntityMessageCreateData, EntityMessageCreateResponse, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponse, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponse, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponse, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponse, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponse, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponse, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponse, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponse, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponse, EntityMessageTypingResponses, EntityPermission, EntityPermissionResponse, EntityReference, EntityType, ErrorResponse, EventReminderOverride, EventReminders, EventStatus, EventTime, EventTransparency, EventType, EventVisibility, ExcludedDefaultView, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerError, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExcludeDefaultViewRequest, ExportDocumentData, ExportDocumentError, ExportDocumentErrors, ExportDocumentResponse, ExportDocumentResponse2, ExportDocumentResponses, Favorite, FavoriteEntityRef, FavoritesList, FileSystemNodeWithIds, FileType, FileTypeUpdate, FolderItem, ForeignEntity, ForeignEntityFilters, GenericErrorResponse, GenericResponse, GenericSuccessResponse, GetActiveCallsData, GetActiveCallsError, GetActiveCallsErrors, GetActiveCallsResponse, GetActiveCallsResponses, GetActivityData, GetActivityError, GetActivityErrors, GetActivityResponse, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesError, GetAttachmentReferencesErrors, GetAttachmentReferencesResponse, GetAttachmentReferencesResponse2, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewError, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewRequest, GetBatchCallRecordPreviewResponse, GetBatchCallRecordPreviewResponse2, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewError, GetBatchChannelPreviewErrors, GetBatchChannelPreviewRequest, GetBatchChannelPreviewResponse, GetBatchChannelPreviewResponse2, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerError, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponse, GetBatchPreviewHandlerResponses, GetBatchPreviewRequest, GetBatchPreviewResponse, GetBatchProjectPreviewData, GetBatchProjectPreviewError, GetBatchProjectPreviewErrors, GetBatchProjectPreviewRequest, GetBatchProjectPreviewResponse, GetBatchProjectPreviewResponse2, GetBatchProjectPreviewResponses, GetBotOwnerProfilesData, GetBotOwnerProfilesError, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponse, GetBotOwnerProfilesResponses, GetCallRecordData, GetCallRecordError, GetCallRecordErrors, GetCallRecordResponse, GetCallRecordResponses, GetChannelAttachmentsData, GetChannelAttachmentsError, GetChannelAttachmentsErrors, GetChannelAttachmentsResponse, GetChannelAttachmentsResponses, GetChannelData, GetChannelError, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkError, GetChannelJoinLinkErrors, GetChannelJoinLinkResponse, GetChannelJoinLinkResponses, GetChannelMessagesCatchUpData, GetChannelMessagesCatchUpError, GetChannelMessagesCatchUpErrors, GetChannelMessagesCatchUpResponse, GetChannelMessagesCatchUpResponses, GetChannelMessagesData, GetChannelMessagesError, GetChannelMessagesErrors, GetChannelMessagesResponse, GetChannelMessagesResponses, GetChannelParticipantsData, GetChannelParticipantsError, GetChannelParticipantsErrors, GetChannelParticipantsResponse, GetChannelParticipantsResponses, GetChannelResponse, GetChannelResponses, GetChannelsData, GetChannelsError, GetChannelsErrors, GetChannelsResponse, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceError, GetCollabSurfaceErrors, GetCollabSurfaceResponse, GetCollabSurfaceResponses, GetCompanyData, GetCompanyError, GetCompanyErrors, GetCompanyResponse, GetCompanyResponses, GetContactByEmailData, GetContactByEmailError, GetContactByEmailErrors, GetContactByEmailResponse, GetContactByEmailResponse2, GetContactByEmailResponses, GetContactData, GetContactError, GetContactErrors, GetContactResponse, GetContactResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsError, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponse, GetCrmTeamSettingsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, GetDocumentCommentsData, GetDocumentCommentsError, GetDocumentCommentsErrors, GetDocumentCommentsResponse, GetDocumentCommentsResponses, GetDocumentData, GetDocumentError, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsError, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponse, GetDocumentGithubPullRequestsResponses, GetDocumentKeyResponse, GetDocumentKeyResponseData, GetDocumentListHandlerData, GetDocumentListHandlerError, GetDocumentListHandlerErrors, GetDocumentListHandlerResponse, GetDocumentListHandlerResponses, GetDocumentListResult, GetDocumentLocationV3Data, GetDocumentLocationV3Error, GetDocumentLocationV3Errors, GetDocumentLocationV3Response, GetDocumentLocationV3Responses, GetDocumentPermissionsResponseDataV2, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenError, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponse, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Error, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Response, GetDocumentPermissionsV2Responses, GetDocumentProcessingResult, GetDocumentProcessingResultData, GetDocumentProcessingResultError, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponse, GetDocumentProcessingResultResponse2, GetDocumentProcessingResultResponses, GetDocumentResponse, GetDocumentResponse2, GetDocumentResponseData, GetDocumentResponses, GetDocumentSearchResponse, GetDocumentShortIdData, GetDocumentShortIdError, GetDocumentShortIdErrors, GetDocumentShortIdResponse, GetDocumentShortIdResponses, GetDocumentsResponse, GetDocumentTeamShareData, GetDocumentTeamShareError, GetDocumentTeamShareErrors, GetDocumentTeamShareResponse, GetDocumentTeamShareResponses, GetDocumentUserAccessLevelResponse, GetDocumentVersionData, GetDocumentVersionError, GetDocumentVersionErrors, GetDocumentVersionResponse, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerError, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponse, GetDocumentViewsHandlerResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponse, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceError, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponse, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityError, GetForeignEntityErrors, GetForeignEntityResponse, GetForeignEntityResponses, GetHarnessPairingData, GetHarnessPairingError, GetHarnessPairingErrors, GetHarnessPairingResponse, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerError, GetHistoryHandlerErrors, GetHistoryHandlerResponse, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeError, GetInitiativeErrors, GetInitiativeResponse, GetInitiativeResponses, GetInstructionsDocumentResponse, GetInstructionsHandlerData, GetInstructionsHandlerError, GetInstructionsHandlerErrors, GetInstructionsHandlerResponse, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupError, GetItemsSoupErrors, GetItemsSoupResponse, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerError, GetLocationHandlerErrors, GetLocationHandlerResponse, GetLocationHandlerResponses, GetMessageWithContextData, GetMessageWithContextError, GetMessageWithContextErrors, GetMessageWithContextResponse, GetMessageWithContextResponse2, GetMessageWithContextResponses, GetOrCreateAction, GetOrCreateCallData, GetOrCreateCallError, GetOrCreateCallErrors, GetOrCreateCallResponse, GetOrCreateCallResponses, GetOrCreateChannelResponse, GetOrCreateDmData, GetOrCreateDmError, GetOrCreateDmErrors, GetOrCreateDmRequest, GetOrCreateDmResponse, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateError, GetOrCreatePrivateErrors, GetOrCreatePrivateRequest, GetOrCreatePrivateResponse, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerError, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponse, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerError, GetPinsHandlerErrors, GetPinsHandlerResponse, GetPinsHandlerResponses, GetPinsResponse, GetProjectContentHandlerData, GetProjectContentHandlerError, GetProjectContentHandlerErrors, GetProjectContentHandlerResponse, GetProjectContentHandlerResponses, GetProjectContentResponse, GetProjectHandlerData, GetProjectHandlerError, GetProjectHandlerErrors, GetProjectHandlerResponse, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Error, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Response, GetProjectPermissionsV2Responses, GetProjectResponse, GetProjectResponseData, GetProjectsHandlerData, GetProjectsHandlerError, GetProjectsHandlerErrors, GetProjectsHandlerResponse, GetProjectsHandlerResponses, GetProjectsResponse, GetProjectUserAccessLevelData, GetProjectUserAccessLevelError, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponse, GetProjectUserAccessLevelResponses, GetReminderData, GetReminderError, GetReminderErrors, GetReminderResponse, GetReminderResponses, GetRingStatusData, GetRingStatusError, GetRingStatusErrors, GetRingStatusResponse, GetRingStatusResponses, GetSelfBotData, GetSelfBotError, GetSelfBotErrors, GetSelfBotResponse, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessError, GetSelfHarnessErrors, GetSelfHarnessResponse, GetSelfHarnessResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, GetThreadRepliesData, GetThreadRepliesError, GetThreadRepliesErrors, GetThreadRepliesResponse, GetThreadRepliesResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerError, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponse, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationError, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponse, GetUserDocumentViewLocationResponses, GetUserHistoryResponse, GetViewsHandlerData, GetViewsHandlerError, GetViewsHandlerErrors, GetViewsHandlerResponse, GetViewsHandlerResponses, GetWebhookData, GetWebhookError, GetWebhookErrors, GetWebhookResponse, GetWebhookResponses, GithubPullRequest, GithubPullRequestCheckRun, GithubPullRequestComment, GithubPullRequestsResponse, GroupedInitialParams, GroupedPageParams, GroupedSoupGroupPage, GroupedSoupInitialPage, GroupedSoupPage, GroupedSoupSort, GuestId, GuestJoinRequest, HandlerData, HandlerError, HandlerErrors, HandlerResponse, HandlerResponses, Harness, HarnessAgent, HarnessId, HarnessOwner, HarnessSession, HashMap, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, HighlightType, ImportedAuthor, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InitiativeDetail, InitiativeFilters, InitiativeId, InitiativeList, InitiativeSummary, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, InviteMeetingRequest, InviteMeetingUsersRequest, Item, ItemWithUserAccessLevel, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, LatestMessage, LeaveCallResponse, LeaveChannelData, LeaveChannelError, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallError, LeaveOrEndCallErrors, LeaveOrEndCallResponse, LeaveOrEndCallResponses, LinkShare, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListBotChannelsData, ListBotChannelsError, ListBotChannelsErrors, ListBotChannelsResponse, ListBotChannelsResponses, ListChannelLabelsData, ListChannelLabelsError, ListChannelLabelsErrors, ListChannelLabelsResponse, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsError, ListCompanyContactsErrors, ListCompanyContactsResponse, ListCompanyContactsResponses, ListCrmCommentsData, ListCrmCommentsError, ListCrmCommentsErrors, ListCrmCommentsResponse, ListCrmCommentsResponses, ListFavoritesData, ListFavoritesError, ListFavoritesErrors, ListFavoritesResponse, ListFavoritesResponses, ListHarnessAgentsData, ListHarnessAgentsError, ListHarnessAgentsErrors, ListHarnessAgentsResponse, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesError, ListHarnessesErrors, ListHarnessesResponse, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsError, ListHarnessSessionsErrors, ListHarnessSessionsResponse, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesError, ListInitiativesErrors, ListInitiativesResponse, ListInitiativesResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponse, ListOccurrencesResponses, ListRemindersData, ListRemindersError, ListRemindersErrors, ListRemindersResponse, ListRemindersResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponse, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysError, ListUserApiKeysErrors, ListUserApiKeysResponse, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksError, ListWebhooksErrors, ListWebhooksResponse, ListWebhooksResponse2, ListWebhooksResponses, LocationResponseData, LocationResponseV3, MacroUserIdStr, Meeting, MeetingCancelData, MeetingCancelError, MeetingCancelErrors, MeetingCancelPreparationData, MeetingCancelPreparationError, MeetingCancelPreparationErrors, MeetingCancelPreparationResponse, MeetingCancelPreparationResponses, MeetingCancelResponse, MeetingCancelResponses, MeetingCreateData, MeetingCreateError, MeetingCreateErrors, MeetingCreateResponse, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinError, MeetingGuestJoinErrors, MeetingGuestJoinResponse, MeetingGuestJoinResponses, MeetingGuestParticipantsData, MeetingGuestParticipantsError, MeetingGuestParticipantsErrors, MeetingGuestParticipantsResponse, MeetingGuestParticipantsResponses, MeetingInviteData, MeetingInviteError, MeetingInviteErrors, MeetingInvitePermissions, MeetingInvitePermissionsData, MeetingInvitePermissionsError, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponse, MeetingInvitePermissionsResponses, MeetingInviteResponse, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersError, MeetingInviteUsersErrors, MeetingInviteUsersResponse, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinError, MeetingJoinErrors, MeetingJoinResponse, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveError, MeetingLeaveErrors, MeetingLeaveResponse, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveError, MeetingListActiveErrors, MeetingListActiveResponse, MeetingListActiveResponses, MeetingListData, MeetingListError, MeetingListErrors, MeetingListResponse, MeetingListResponses, MeetingLookupData, MeetingLookupError, MeetingLookupErrors, MeetingLookupResponse, MeetingLookupResponses, MeetingParticipant, MeetingParticipants, MeetingParticipantsData, MeetingParticipantsError, MeetingParticipantsErrors, MeetingParticipantsResponse, MeetingParticipantsResponses, MeetingPreparation, MeetingPrepareData, MeetingPrepareError, MeetingPrepareErrors, MeetingPrepareResponse, MeetingPrepareResponses, MeetingShareData, MeetingShareError, MeetingShareErrors, MeetingShareResponse, MeetingShareResponses, MeetingsResponse, MeetingToken, MeetingUpdateData, MeetingUpdateError, MeetingUpdateErrors, MeetingUpdateResponse, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponse, MentionPreviewsResponses, Mentions, Message, MessageAttachment, MessageChange, MessageCursor, MessageDirection, MessageEvent, MessageListItem, MessagePage, MessageParent, MessagePatch, MessageThread, MessageThreadPreview, MessageTimelineData, MessageTimelineQuery, MessageTimelineResponse, MessageTimelineResponses, NewAttachment, NewChannelAttachment, NewThreadAnchor, NotificationFilters, NotificationState, PairingDetails, Params, ParticipantRole, PatchBotRequest, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchMessageData, PatchMessageError, PatchMessageErrors, PatchMessageNotificationPolicy, PatchMessageRequest, PatchMessageResponse, PatchMessageResponses, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfAnchorRequest, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PdfPlaceableCommentAnchorRequest, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostChannelMessagesData, PostChannelMessagesError, PostChannelMessagesErrors, PostChannelMessagesResponse, PostChannelMessagesResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessage, PostMessageData, PostMessageError, PostMessageErrors, PostMessageNotificationPolicy, PostMessageRequest, PostMessageResponse, PostMessageResponse2, PostMessageResponses, PostReactionData, PostReactionError, PostReactionErrors, PostReactionRequest, PostReactionResponse, PostReactionResponses, PostSoupAstRequest, PostSoupRequest, PostTypingData, PostTypingError, PostTypingErrors, PostTypingRequest, PostTypingResponse, PostTypingResponses, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresignedUrl, PreviewSmartTagData, PreviewSmartTagError, PreviewSmartTagErrors, PreviewSmartTagResponse, PreviewSmartTagResponses, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyDefinition, PropertyFilter, PropertyInput, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, ReactionAction, ReactionInput, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, Reminder, ReminderFilters, ReminderSchedule, RemindersList, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotError, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponse, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityError, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsError, RemoveParticipantsErrors, RemoveParticipantsRequest, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerError, RemovePinHandlerErrors, RemovePinHandlerResponse, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelError, RenameChannelLabelErrors, RenameChannelLabelRequest, RenameChannelLabelResponse, RenameChannelLabelResponses, ReorderFavoritesData, ReorderFavoritesError, ReorderFavoritesErrors, ReorderFavoritesRequest, ReorderFavoritesResponses, ReorderPinRequest, ReorderPinsHandlerData, ReorderPinsHandlerError, ReorderPinsHandlerErrors, ReorderPinsHandlerResponse, ReorderPinsHandlerResponses, ReplaceCrmStagesRequest, RequestedHarnessScope, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, ResolveChannelMessageData, ResolveChannelMessageError, ResolveChannelMessageErrors, ResolveChannelMessageResponse, ResolveChannelMessageResponses, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RingStatus, RingStatusResponse, S3ObjectInfo, SaveBomPart, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SessionDeletedMetadata, SessionIdentity, SessionMentionedMetadata, SessionOpenedMetadata, SessionRenamedMetadata, SessionSettledMetadata, SessionStoppedMetadata, SetChannelLabelData, SetChannelLabelError, SetChannelLabelErrors, SetChannelLabelRequest, SetChannelLabelResponse, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureError, SetChannelPictureErrors, SetChannelPictureRequest, SetChannelPictureResponse, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenError, SetCompanyHiddenErrors, SetCompanyHiddenRequest, SetCompanyHiddenResponse, SetCompanyHiddenResponses, SetCompanyNameRequest, SetContactHiddenData, SetContactHiddenError, SetContactHiddenErrors, SetContactHiddenRequest, SetContactHiddenResponse, SetContactHiddenResponses, SetContactNameRequest, SetCrmCompanyNameData, SetCrmCompanyNameError, SetCrmCompanyNameErrors, SetCrmCompanyNameResponse, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameError, SetCrmContactNameErrors, SetCrmContactNameResponse, SetCrmContactNameResponses, SetDocumentTeamShareData, SetDocumentTeamShareError, SetDocumentTeamShareErrors, SetDocumentTeamShareRequest, SetDocumentTeamShareResponse, SetDocumentTeamShareResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetPropertyValue, SharedEmailFilter, SharePermissionV2, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SmartTagChannelMatch, SmartTagPreview, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordGuest, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmDomain, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupInitiativeSoupPropertiesField, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupReminderReference, SoupReminderSchedule, SoupReminderSoupPropertiesField, SoupThreadInfo, SoupThreadReply, StarterDocumentsResponse, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, TagFilterMode, TaskFilters, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, Thread, ThreadAnchor, ThreadOrigin, ThreadPatch, ThreadResponse, ThreadState, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TranscribeDictationData, TranscribeDictationError, TranscribeDictationErrors, TranscribeDictationResponse, TranscribeDictationResponses, TranscribeResponse, TranscriptSegmentRequest, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingAction, TypingInput, UnassignInitiativeTaskData, UnassignInitiativeTaskError, UnassignInitiativeTaskErrors, UnassignInitiativeTaskResponse, UnassignInitiativeTaskResponses, UnthreadedPdfUuidRequest, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmTeamSettingsRequest, UpdateInitiativeData, UpdateInitiativeError, UpdateInitiativeErrors, UpdateInitiativeRequest, UpdateInitiativeResponse, UpdateInitiativeResponses, UpdateMeetingRequest, UpdateOperation, UpdateReminderData, UpdateReminderError, UpdateReminderErrors, UpdateReminderRequest, UpdateReminderResponse, UpdateReminderResponses, UpdateSharePermissionRequestV2, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UpsertHistoryHandlerData, UpsertHistoryHandlerError, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponse, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationError, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationRequest, UpsertUserDocumentViewLocationResponse, UpsertUserDocumentViewLocationResponses, UserApiKeyId, UserApiKeyInfo, UserApiKeysList, UserDocumentsResponse, UserDocumentViewLocation, UserDocumentViewLocationResponse, UserPinsResponse, UserViewsResponse, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenError, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponse, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookError, ValidateWebhookErrors, ValidateWebhookResponse, ValidateWebhookResponse2, ValidateWebhookResponses, Vec, View, ViewPatch, ViewsResponse, WaitingForInputMetadata, Webhook, WebhookEvent, WebhookFilter, WebhookScope, WebhookStatus, WebhookValidationTestEvent, WithCallId, WithChannelId, WithDocumentId, WithProjectId } from './types.gen';
diff --git a/packages/sdk/generated/storage/sdk.gen.ts b/packages/sdk/generated/storage/sdk.gen.ts
index 8c13849317..5c1ca64a98 100644
--- a/packages/sdk/generated/storage/sdk.gen.ts
+++ b/packages/sdk/generated/storage/sdk.gen.ts
@@ -2,7 +2,7 @@
import type { Client, ClientMeta, Options as Options2, RequestResult, ServerSentEventsResult, TDataShape } from './client';
import { client } from './client.gen';
-import type { AddFavoriteData, AddFavoriteErrors, AddFavoriteResponses, AddParticipantsData, AddParticipantsErrors, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerErrors, AddPinHandlerResponses, ApproveHarnessPairingData, ApproveHarnessPairingErrors, ApproveHarnessPairingResponses, AssignInitiativeTasksData, AssignInitiativeTasksErrors, AssignInitiativeTasksResponses, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponses, CallWebhookData, CallWebhookErrors, CallWebhookResponses, CheckActiveCallData, CheckActiveCallErrors, CheckActiveCallResponses, ClaimHarnessPairingData, ClaimHarnessPairingErrors, ClaimHarnessPairingResponses, CopyDocumentData, CopyDocumentErrors, CopyDocumentResponses, CreateAgentData, CreateAgentErrors, CreateAgentResponses, CreateAnchorData, CreateAnchorErrors, CreateAnchorResponses, CreateChannelData, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelErrors, CreateChannelLabelResponses, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotErrors, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponses, CreateCommentData, CreateCommentErrors, CreateCommentResponses, CreateCrmCommentData, CreateCrmCommentErrors, CreateCrmCommentResponses, CreateCrmCompanyData, CreateCrmCompanyErrors, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactErrors, CreateCrmContactResponses, CreateDocumentData, CreateDocumentErrors, CreateDocumentResponses, CreateEntityMentionData, CreateEntityMentionErrors, CreateEntityMentionResponses, CreateHarnessPairingData, CreateHarnessPairingErrors, CreateHarnessPairingResponses, CreateInitiativeData, CreateInitiativeErrors, CreateInitiativeResponses, CreateInstructionsHandlerData, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponses, CreateMarkdownHandlerData, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponses, CreateProjectHandlerData, CreateProjectHandlerErrors, CreateProjectHandlerResponses, CreateReminderData, CreateReminderErrors, CreateReminderResponses, CreateSkillHandlerData, CreateSkillHandlerErrors, CreateSkillHandlerResponses, CreateSnippetHandlerData, CreateSnippetHandlerErrors, CreateSnippetHandlerResponses, CreateTaskHandlerData, CreateTaskHandlerErrors, CreateTaskHandlerResponses, CreateUserApiKeyData, CreateUserApiKeyErrors, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerErrors, CreateViewHandlerResponses, CreateWebhookData, CreateWebhookErrors, CreateWebhookResponses, DeleteAnchorData, DeleteAnchorErrors, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordErrors, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelErrors, DeleteChannelLabelResponses, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponses, DeleteCommentData, DeleteCommentErrors, DeleteCommentResponses, DeleteCrmCommentData, DeleteCrmCommentErrors, DeleteCrmCommentResponses, DeleteDocumentData, DeleteDocumentErrors, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionErrors, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessErrors, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeErrors, DeleteInitiativeResponses, DeleteMessageData, DeleteMessageErrors, DeleteMessageResponses, DeleteProjectHandlerData, DeleteProjectHandlerErrors, DeleteProjectHandlerResponses, DeleteReminderData, DeleteReminderErrors, DeleteReminderResponses, DeleteSelfHarnessData, DeleteSelfHarnessErrors, DeleteSelfHarnessResponses, DeleteUserApiKeyData, DeleteUserApiKeyErrors, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookErrors, DeleteWebhookResponses, EditAnchorData, EditAnchorErrors, EditAnchorResponses, EditCallRecordData, EditCallRecordErrors, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptErrors, EditCallTranscriptResponses, EditCommentData, EditCommentErrors, EditCommentResponses, EditCrmCommentData, EditCrmCommentErrors, EditCrmCommentResponses, EditDocumentData, EditDocumentErrors, EditDocumentResponses, EditProjectV2Data, EditProjectV2Errors, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Errors, EditThreadV2Responses, EnsureCollabSurfaceData, EnsureCollabSurfaceErrors, EnsureCollabSurfaceResponses, EntityMessageCreateData, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponses, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExportDocumentData, ExportDocumentErrors, ExportDocumentResponses, GetActiveCallsData, GetActiveCallsErrors, GetActiveCallsResponses, GetActivityData, GetActivityErrors, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesErrors, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewErrors, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponses, GetBatchProjectPreviewData, GetBatchProjectPreviewErrors, GetBatchProjectPreviewResponses, GetBotOwnerProfilesData, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponses, GetCallRecordData, GetCallRecordErrors, GetCallRecordResponses, GetChannelAttachmentsData, GetChannelAttachmentsErrors, GetChannelAttachmentsResponses, GetChannelData, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkErrors, GetChannelJoinLinkResponses, GetChannelMessagesCatchUpData, GetChannelMessagesCatchUpErrors, GetChannelMessagesCatchUpResponses, GetChannelMessagesData, GetChannelMessagesErrors, GetChannelMessagesResponses, GetChannelParticipantsData, GetChannelParticipantsErrors, GetChannelParticipantsResponses, GetChannelResponses, GetChannelsData, GetChannelsErrors, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceErrors, GetCollabSurfaceResponses, GetCompanyData, GetCompanyErrors, GetCompanyResponses, GetContactByEmailData, GetContactByEmailErrors, GetContactByEmailResponses, GetContactData, GetContactErrors, GetContactResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponses, GetDocumentAnchorsData, GetDocumentAnchorsErrors, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameErrors, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponses, GetDocumentCommentsData, GetDocumentCommentsErrors, GetDocumentCommentsResponses, GetDocumentData, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponses, GetDocumentListHandlerData, GetDocumentListHandlerErrors, GetDocumentListHandlerResponses, GetDocumentLocationV3Data, GetDocumentLocationV3Errors, GetDocumentLocationV3Responses, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Responses, GetDocumentProcessingResultData, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponses, GetDocumentResponses, GetDocumentShortIdData, GetDocumentShortIdErrors, GetDocumentShortIdResponses, GetDocumentTeamShareData, GetDocumentTeamShareErrors, GetDocumentTeamShareResponses, GetDocumentVersionData, GetDocumentVersionErrors, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityErrors, GetForeignEntityResponses, GetHarnessPairingData, GetHarnessPairingErrors, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerErrors, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeErrors, GetInitiativeResponses, GetInstructionsHandlerData, GetInstructionsHandlerErrors, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupErrors, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerErrors, GetLocationHandlerResponses, GetMessageWithContextData, GetMessageWithContextErrors, GetMessageWithContextResponses, GetOrCreateCallData, GetOrCreateCallErrors, GetOrCreateCallResponses, GetOrCreateDmData, GetOrCreateDmErrors, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateErrors, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerErrors, GetPinsHandlerResponses, GetProjectContentHandlerData, GetProjectContentHandlerErrors, GetProjectContentHandlerResponses, GetProjectHandlerData, GetProjectHandlerErrors, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Responses, GetProjectsHandlerData, GetProjectsHandlerErrors, GetProjectsHandlerResponses, GetProjectUserAccessLevelData, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponses, GetReminderData, GetReminderErrors, GetReminderResponses, GetRingStatusData, GetRingStatusErrors, GetRingStatusResponses, GetSelfBotData, GetSelfBotErrors, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessErrors, GetSelfHarnessResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponses, GetThreadRepliesData, GetThreadRepliesErrors, GetThreadRepliesResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponses, GetViewsHandlerData, GetViewsHandlerErrors, GetViewsHandlerResponses, GetWebhookData, GetWebhookErrors, GetWebhookResponses, HandlerData, HandlerErrors, HandlerResponses, HealthHandlerData, HealthHandlerResponses, IngestTranscriptData, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsErrors, InitializeUserDocumentsResponses, InstallSyncData, InstallSyncErrors, JobProcessingResultHandlerData, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponses, JoinChannelByCodeData, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelErrors, JoinChannelResponses, LeaveChannelData, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallErrors, LeaveOrEndCallResponses, ListAgentsData, ListAgentsErrors, ListAgentsResponses, ListBotChannelsData, ListBotChannelsErrors, ListBotChannelsResponses, ListChannelLabelsData, ListChannelLabelsErrors, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsErrors, ListCompanyContactsResponses, ListCrmCommentsData, ListCrmCommentsErrors, ListCrmCommentsResponses, ListFavoritesData, ListFavoritesErrors, ListFavoritesResponses, ListHarnessAgentsData, ListHarnessAgentsErrors, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesErrors, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsErrors, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesErrors, ListInitiativesResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponses, ListRemindersData, ListRemindersErrors, ListRemindersResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysErrors, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksErrors, ListWebhooksResponses, MeetingCancelData, MeetingCancelErrors, MeetingCancelResponses, MeetingCreateData, MeetingCreateErrors, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinErrors, MeetingGuestJoinResponses, MeetingInviteData, MeetingInviteErrors, MeetingInvitePermissionsData, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponses, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersErrors, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinErrors, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveErrors, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveErrors, MeetingListActiveResponses, MeetingListData, MeetingListErrors, MeetingListResponses, MeetingLookupData, MeetingLookupErrors, MeetingLookupResponses, MeetingShareData, MeetingShareErrors, MeetingShareResponses, MeetingUpdateData, MeetingUpdateErrors, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponses, MessageTimelineData, MessageTimelineResponses, PatchChannelData, PatchChannelErrors, PatchChannelResponses, PatchMessageData, PatchMessageErrors, PatchMessageResponses, PatchViewHandlerData, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookErrors, PatchWebhookResponses, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponses, PostActivityData, PostActivityErrors, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookErrors, PostChannelBotWebhookResponses, PostChannelMessagesData, PostChannelMessagesErrors, PostChannelMessagesResponses, PostItemsSoupAstData, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupErrors, PostItemsSoupResponses, PostMessageData, PostMessageErrors, PostMessageResponses, PostReactionData, PostReactionErrors, PostReactionResponses, PostTypingData, PostTypingErrors, PostTypingResponses, PresaveDocumentHandlerData, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponses, PreviewSmartTagData, PreviewSmartTagErrors, PreviewSmartTagResponses, PutCrmTeamSettingsData, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesErrors, PutCrmTeamStagesResponses, RecentlyDeletedData, RecentlyDeletedErrors, RecentlyDeletedResponses, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsErrors, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerErrors, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelErrors, RenameChannelLabelResponses, ReorderFavoritesData, ReorderFavoritesErrors, ReorderFavoritesResponses, ReorderPinsHandlerData, ReorderPinsHandlerErrors, ReorderPinsHandlerResponses, ResetCrmTeamStagesData, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponses, ResolveChannelMessageData, ResolveChannelMessageErrors, ResolveChannelMessageResponses, RevertDeleteDocumentData, RevertDeleteDocumentErrors, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectErrors, RevertDeleteProjectResponses, SaveDocumentHandlerData, SaveDocumentHandlerErrors, SaveDocumentHandlerResponses, SetChannelLabelData, SetChannelLabelErrors, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureErrors, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenErrors, SetCompanyHiddenResponses, SetContactHiddenData, SetContactHiddenErrors, SetContactHiddenResponses, SetCrmCompanyNameData, SetCrmCompanyNameErrors, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameErrors, SetCrmContactNameResponses, SetDocumentTeamShareData, SetDocumentTeamShareErrors, SetDocumentTeamShareResponses, SetEmailSyncData, SetEmailSyncErrors, SetEmailSyncResponses, SimpleSaveData, SimpleSaveErrors, SimpleSaveResponses, StreamEventsData, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, ToggleShareWithTeamData, ToggleShareWithTeamErrors, ToggleShareWithTeamResponses, TranscribeDictationData, TranscribeDictationErrors, TranscribeDictationResponses, UnassignInitiativeTaskData, UnassignInitiativeTaskErrors, UnassignInitiativeTaskResponses, UpdateAgentData, UpdateAgentErrors, UpdateAgentResponses, UpdateInitiativeData, UpdateInitiativeErrors, UpdateInitiativeResponses, UpdateReminderData, UpdateReminderErrors, UpdateReminderResponses, UploadExtractFolderHandlerData, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponses, UploadFolderHandlerData, UploadFolderHandlerErrors, UploadFolderHandlerResponses, UpsertHistoryHandlerData, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationResponses, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookErrors, ValidateWebhookResponses } from './types.gen';
+import type { AddFavoriteData, AddFavoriteErrors, AddFavoriteResponses, AddParticipantsData, AddParticipantsErrors, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerErrors, AddPinHandlerResponses, ApproveHarnessPairingData, ApproveHarnessPairingErrors, ApproveHarnessPairingResponses, AssignInitiativeTasksData, AssignInitiativeTasksErrors, AssignInitiativeTasksResponses, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponses, CallWebhookData, CallWebhookErrors, CallWebhookResponses, CheckActiveCallData, CheckActiveCallErrors, CheckActiveCallResponses, ClaimHarnessPairingData, ClaimHarnessPairingErrors, ClaimHarnessPairingResponses, CopyDocumentData, CopyDocumentErrors, CopyDocumentResponses, CreateAgentData, CreateAgentErrors, CreateAgentResponses, CreateAnchorData, CreateAnchorErrors, CreateAnchorResponses, CreateChannelData, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelErrors, CreateChannelLabelResponses, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotErrors, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponses, CreateCommentData, CreateCommentErrors, CreateCommentResponses, CreateCrmCommentData, CreateCrmCommentErrors, CreateCrmCommentResponses, CreateCrmCompanyData, CreateCrmCompanyErrors, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactErrors, CreateCrmContactResponses, CreateDocumentData, CreateDocumentErrors, CreateDocumentResponses, CreateEntityMentionData, CreateEntityMentionErrors, CreateEntityMentionResponses, CreateHarnessPairingData, CreateHarnessPairingErrors, CreateHarnessPairingResponses, CreateInitiativeData, CreateInitiativeErrors, CreateInitiativeResponses, CreateInstructionsHandlerData, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponses, CreateMarkdownHandlerData, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponses, CreateProjectHandlerData, CreateProjectHandlerErrors, CreateProjectHandlerResponses, CreateReminderData, CreateReminderErrors, CreateReminderResponses, CreateSkillHandlerData, CreateSkillHandlerErrors, CreateSkillHandlerResponses, CreateSnippetHandlerData, CreateSnippetHandlerErrors, CreateSnippetHandlerResponses, CreateTaskHandlerData, CreateTaskHandlerErrors, CreateTaskHandlerResponses, CreateUserApiKeyData, CreateUserApiKeyErrors, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerErrors, CreateViewHandlerResponses, CreateWebhookData, CreateWebhookErrors, CreateWebhookResponses, DeleteAnchorData, DeleteAnchorErrors, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordErrors, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelErrors, DeleteChannelLabelResponses, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponses, DeleteCommentData, DeleteCommentErrors, DeleteCommentResponses, DeleteCrmCommentData, DeleteCrmCommentErrors, DeleteCrmCommentResponses, DeleteDocumentData, DeleteDocumentErrors, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionErrors, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessErrors, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeErrors, DeleteInitiativeResponses, DeleteMessageData, DeleteMessageErrors, DeleteMessageResponses, DeleteProjectHandlerData, DeleteProjectHandlerErrors, DeleteProjectHandlerResponses, DeleteReminderData, DeleteReminderErrors, DeleteReminderResponses, DeleteSelfHarnessData, DeleteSelfHarnessErrors, DeleteSelfHarnessResponses, DeleteUserApiKeyData, DeleteUserApiKeyErrors, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookErrors, DeleteWebhookResponses, EditAnchorData, EditAnchorErrors, EditAnchorResponses, EditCallRecordData, EditCallRecordErrors, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptErrors, EditCallTranscriptResponses, EditCommentData, EditCommentErrors, EditCommentResponses, EditCrmCommentData, EditCrmCommentErrors, EditCrmCommentResponses, EditDocumentData, EditDocumentErrors, EditDocumentResponses, EditProjectV2Data, EditProjectV2Errors, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Errors, EditThreadV2Responses, EnsureCollabSurfaceData, EnsureCollabSurfaceErrors, EnsureCollabSurfaceResponses, EntityMessageCreateData, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponses, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExportDocumentData, ExportDocumentErrors, ExportDocumentResponses, GetActiveCallsData, GetActiveCallsErrors, GetActiveCallsResponses, GetActivityData, GetActivityErrors, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesErrors, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewErrors, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponses, GetBatchProjectPreviewData, GetBatchProjectPreviewErrors, GetBatchProjectPreviewResponses, GetBotOwnerProfilesData, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponses, GetCallRecordData, GetCallRecordErrors, GetCallRecordResponses, GetChannelAttachmentsData, GetChannelAttachmentsErrors, GetChannelAttachmentsResponses, GetChannelData, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkErrors, GetChannelJoinLinkResponses, GetChannelMessagesCatchUpData, GetChannelMessagesCatchUpErrors, GetChannelMessagesCatchUpResponses, GetChannelMessagesData, GetChannelMessagesErrors, GetChannelMessagesResponses, GetChannelParticipantsData, GetChannelParticipantsErrors, GetChannelParticipantsResponses, GetChannelResponses, GetChannelsData, GetChannelsErrors, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceErrors, GetCollabSurfaceResponses, GetCompanyData, GetCompanyErrors, GetCompanyResponses, GetContactByEmailData, GetContactByEmailErrors, GetContactByEmailResponses, GetContactData, GetContactErrors, GetContactResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponses, GetDocumentAnchorsData, GetDocumentAnchorsErrors, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameErrors, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponses, GetDocumentCommentsData, GetDocumentCommentsErrors, GetDocumentCommentsResponses, GetDocumentData, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponses, GetDocumentListHandlerData, GetDocumentListHandlerErrors, GetDocumentListHandlerResponses, GetDocumentLocationV3Data, GetDocumentLocationV3Errors, GetDocumentLocationV3Responses, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Responses, GetDocumentProcessingResultData, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponses, GetDocumentResponses, GetDocumentShortIdData, GetDocumentShortIdErrors, GetDocumentShortIdResponses, GetDocumentTeamShareData, GetDocumentTeamShareErrors, GetDocumentTeamShareResponses, GetDocumentVersionData, GetDocumentVersionErrors, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityErrors, GetForeignEntityResponses, GetHarnessPairingData, GetHarnessPairingErrors, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerErrors, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeErrors, GetInitiativeResponses, GetInstructionsHandlerData, GetInstructionsHandlerErrors, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupErrors, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerErrors, GetLocationHandlerResponses, GetMessageWithContextData, GetMessageWithContextErrors, GetMessageWithContextResponses, GetOrCreateCallData, GetOrCreateCallErrors, GetOrCreateCallResponses, GetOrCreateDmData, GetOrCreateDmErrors, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateErrors, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerErrors, GetPinsHandlerResponses, GetProjectContentHandlerData, GetProjectContentHandlerErrors, GetProjectContentHandlerResponses, GetProjectHandlerData, GetProjectHandlerErrors, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Responses, GetProjectsHandlerData, GetProjectsHandlerErrors, GetProjectsHandlerResponses, GetProjectUserAccessLevelData, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponses, GetReminderData, GetReminderErrors, GetReminderResponses, GetRingStatusData, GetRingStatusErrors, GetRingStatusResponses, GetSelfBotData, GetSelfBotErrors, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessErrors, GetSelfHarnessResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponses, GetThreadRepliesData, GetThreadRepliesErrors, GetThreadRepliesResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponses, GetViewsHandlerData, GetViewsHandlerErrors, GetViewsHandlerResponses, GetWebhookData, GetWebhookErrors, GetWebhookResponses, HandlerData, HandlerErrors, HandlerResponses, HealthHandlerData, HealthHandlerResponses, IngestTranscriptData, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsErrors, InitializeUserDocumentsResponses, InstallSyncData, InstallSyncErrors, JobProcessingResultHandlerData, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponses, JoinChannelByCodeData, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelErrors, JoinChannelResponses, LeaveChannelData, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallErrors, LeaveOrEndCallResponses, ListAgentsData, ListAgentsErrors, ListAgentsResponses, ListBotChannelsData, ListBotChannelsErrors, ListBotChannelsResponses, ListChannelLabelsData, ListChannelLabelsErrors, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsErrors, ListCompanyContactsResponses, ListCrmCommentsData, ListCrmCommentsErrors, ListCrmCommentsResponses, ListFavoritesData, ListFavoritesErrors, ListFavoritesResponses, ListHarnessAgentsData, ListHarnessAgentsErrors, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesErrors, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsErrors, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesErrors, ListInitiativesResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponses, ListRemindersData, ListRemindersErrors, ListRemindersResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysErrors, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksErrors, ListWebhooksResponses, MeetingCancelData, MeetingCancelErrors, MeetingCancelPreparationData, MeetingCancelPreparationErrors, MeetingCancelPreparationResponses, MeetingCancelResponses, MeetingCreateData, MeetingCreateErrors, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinErrors, MeetingGuestJoinResponses, MeetingGuestParticipantsData, MeetingGuestParticipantsErrors, MeetingGuestParticipantsResponses, MeetingInviteData, MeetingInviteErrors, MeetingInvitePermissionsData, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponses, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersErrors, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinErrors, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveErrors, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveErrors, MeetingListActiveResponses, MeetingListData, MeetingListErrors, MeetingListResponses, MeetingLookupData, MeetingLookupErrors, MeetingLookupResponses, MeetingParticipantsData, MeetingParticipantsErrors, MeetingParticipantsResponses, MeetingPrepareData, MeetingPrepareErrors, MeetingPrepareResponses, MeetingShareData, MeetingShareErrors, MeetingShareResponses, MeetingUpdateData, MeetingUpdateErrors, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponses, MessageTimelineData, MessageTimelineResponses, PatchChannelData, PatchChannelErrors, PatchChannelResponses, PatchMessageData, PatchMessageErrors, PatchMessageResponses, PatchViewHandlerData, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookErrors, PatchWebhookResponses, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponses, PostActivityData, PostActivityErrors, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookErrors, PostChannelBotWebhookResponses, PostChannelMessagesData, PostChannelMessagesErrors, PostChannelMessagesResponses, PostItemsSoupAstData, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupErrors, PostItemsSoupResponses, PostMessageData, PostMessageErrors, PostMessageResponses, PostReactionData, PostReactionErrors, PostReactionResponses, PostTypingData, PostTypingErrors, PostTypingResponses, PresaveDocumentHandlerData, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponses, PreviewSmartTagData, PreviewSmartTagErrors, PreviewSmartTagResponses, PutCrmTeamSettingsData, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesErrors, PutCrmTeamStagesResponses, RecentlyDeletedData, RecentlyDeletedErrors, RecentlyDeletedResponses, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsErrors, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerErrors, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelErrors, RenameChannelLabelResponses, ReorderFavoritesData, ReorderFavoritesErrors, ReorderFavoritesResponses, ReorderPinsHandlerData, ReorderPinsHandlerErrors, ReorderPinsHandlerResponses, ResetCrmTeamStagesData, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponses, ResolveChannelMessageData, ResolveChannelMessageErrors, ResolveChannelMessageResponses, RevertDeleteDocumentData, RevertDeleteDocumentErrors, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectErrors, RevertDeleteProjectResponses, SaveDocumentHandlerData, SaveDocumentHandlerErrors, SaveDocumentHandlerResponses, SetChannelLabelData, SetChannelLabelErrors, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureErrors, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenErrors, SetCompanyHiddenResponses, SetContactHiddenData, SetContactHiddenErrors, SetContactHiddenResponses, SetCrmCompanyNameData, SetCrmCompanyNameErrors, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameErrors, SetCrmContactNameResponses, SetDocumentTeamShareData, SetDocumentTeamShareErrors, SetDocumentTeamShareResponses, SetEmailSyncData, SetEmailSyncErrors, SetEmailSyncResponses, SimpleSaveData, SimpleSaveErrors, SimpleSaveResponses, StreamEventsData, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, ToggleShareWithTeamData, ToggleShareWithTeamErrors, ToggleShareWithTeamResponses, TranscribeDictationData, TranscribeDictationErrors, TranscribeDictationResponses, UnassignInitiativeTaskData, UnassignInitiativeTaskErrors, UnassignInitiativeTaskResponses, UpdateAgentData, UpdateAgentErrors, UpdateAgentResponses, UpdateInitiativeData, UpdateInitiativeErrors, UpdateInitiativeResponses, UpdateReminderData, UpdateReminderErrors, UpdateReminderResponses, UploadExtractFolderHandlerData, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponses, UploadFolderHandlerData, UploadFolderHandlerErrors, UploadFolderHandlerResponses, UpsertHistoryHandlerData, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationResponses, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookErrors, ValidateWebhookResponses } from './types.gen';
export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
/**
@@ -292,6 +292,13 @@ export class Sdk extends HeyApiClient {
return (options.client ?? this.client).post<MeetingLeaveResponses, MeetingLeaveErrors, ThrowOnError>({ url: '/call/join/{token}/leave', ...options });
}
+ /**
+ * Read a standalone meeting preview without admitting a guest to the room.
+ */
+ public meetingGuestParticipants<ThrowOnError extends boolean = false>(options: Options<MeetingGuestParticipantsData, ThrowOnError>): RequestResult<MeetingGuestParticipantsResponses, MeetingGuestParticipantsErrors, ThrowOnError> {
+ return (options.client ?? this.client).get<MeetingGuestParticipantsResponses, MeetingGuestParticipantsErrors, ThrowOnError>({ url: '/call/join/{token}/participants', ...options });
+ }
+
/**
* Handle `GET /call/meetings` through the call domain service.
*/
@@ -362,6 +369,27 @@ export class Sdk extends HeyApiClient {
return (options.client ?? this.client).post<MeetingJoinResponses, MeetingJoinErrors, ThrowOnError>({ url: '/call/meetings/join/{token}', ...options });
}
+ /**
+ * Read the participant preview for an authenticated invitation holder.
+ */
+ public meetingParticipants<ThrowOnError extends boolean = false>(options: Options<MeetingParticipantsData, ThrowOnError>): RequestResult<MeetingParticipantsResponses, MeetingParticipantsErrors, ThrowOnError> {
+ return (options.client ?? this.client).get<MeetingParticipantsResponses, MeetingParticipantsErrors, ThrowOnError>({ url: '/call/meetings/join/{token}/participants', ...options });
+ }
+
+ /**
+ * Reserve a room while the authenticated caller configures a new call.
+ */
+ public meetingPrepare<ThrowOnError extends boolean = false>(options?: Options<MeetingPrepareData, ThrowOnError>): RequestResult<MeetingPrepareResponses, MeetingPrepareErrors, ThrowOnError> {
+ return (options?.client ?? this.client).post<MeetingPrepareResponses, MeetingPrepareErrors, ThrowOnError>({ url: '/call/meetings/prepare', ...options });
+ }
+
+ /**
+ * Cancel an unused room; the domain owns ownership and activation checks.
+ */
+ public meetingCancelPreparation<ThrowOnError extends boolean = false>(options: Options<MeetingCancelPreparationData, ThrowOnError>): RequestResult<MeetingCancelPreparationResponses, MeetingCancelPreparationErrors, ThrowOnError> {
+ return (options.client ?? this.client).delete<MeetingCancelPreparationResponses, MeetingCancelPreparationErrors, ThrowOnError>({ url: '/call/meetings/prepare/{preparation_id}', ...options });
+ }
+
/**
* Handle `DELETE /call/meetings/{meeting_id}` through the call domain service.
*/
diff --git a/packages/sdk/generated/storage/types.gen.ts b/packages/sdk/generated/storage/types.gen.ts
index 99945a4ee4..09d9aef19d 100644
--- a/packages/sdk/generated/storage/types.gen.ts
+++ b/packages/sdk/generated/storage/types.gen.ts
@@ -3751,6 +3751,10 @@ export type CreateMarkdownDocumentResponse = {
* Inputs for creating a meeting without starting its RTC room.
*/
export type CreateMeetingRequest = {
+ /**
+ * Optional unused room reserved by this actor on the setup screen.
+ */
+ preparationId?: string | null;
/**
* Optional scheduled end.
*/
@@ -7031,6 +7035,44 @@ export type MeetingInvitePermissions = {
canInvite: boolean;
};
+/**
+ * Minimal waiting-room display data, without account identities or call content.
+ */
+export type MeetingParticipant = {
+ /**
+ * Profile image, when available for a Macro member.
+ */
+ avatarUrl?: string | null;
+ /**
+ * Name displayed in the waiting room.
+ */
+ displayName: string;
+};
+
+/**
+ * People currently connected to a meeting's room.
+ */
+export type MeetingParticipants = {
+ /**
+ * Human attendees only; transcription agents are excluded.
+ */
+ participants: Array<MeetingParticipant>;
+};
+
+/**
+ * An empty room reservation, not a started call or an invitation.
+ */
+export type MeetingPreparation = {
+ /**
+ * After this deadline Start falls back to ordinary room creation.
+ */
+ expiresAt: string;
+ /**
+ * Also the reserved RTC room's UUID and prospective call ID.
+ */
+ id: string;
+};
+
/**
* A bearer capability that grants access only to a meeting's RTC room.
*/
@@ -11831,6 +11873,28 @@ export type MeetingLeaveResponses = {
export type MeetingLeaveResponse = MeetingLeaveResponses[keyof MeetingLeaveResponses];
+export type MeetingGuestParticipantsData = {
+ body?: never;
+ path: {
+ token: string;
+ };
+ query?: never;
+ url: '/call/join/{token}/participants';
+};
+
+export type MeetingGuestParticipantsErrors = {
+ 403: ErrorResponse;
+ 404: ErrorResponse;
+};
+
+export type MeetingGuestParticipantsError = MeetingGuestParticipantsErrors[keyof MeetingGuestParticipantsErrors];
+
+export type MeetingGuestParticipantsResponses = {
+ 200: MeetingParticipants;
+};
+
+export type MeetingGuestParticipantsResponse = MeetingGuestParticipantsResponses[keyof MeetingGuestParticipantsResponses];
+
export type MeetingListData = {
body?: never;
path?: never;
@@ -11986,6 +12050,67 @@ export type MeetingJoinResponses = {
export type MeetingJoinResponse = MeetingJoinResponses[keyof MeetingJoinResponses];
+export type MeetingParticipantsData = {
+ body?: never;
+ path: {
+ token: string;
+ };
+ query?: never;
+ url: '/call/meetings/join/{token}/participants';
+};
+
+export type MeetingParticipantsErrors = {
+ 404: ErrorResponse;
+};
+
+export type MeetingParticipantsError = MeetingParticipantsErrors[keyof MeetingParticipantsErrors];
+
+export type MeetingParticipantsResponses = {
+ 200: MeetingParticipants;
+};
+
+export type MeetingParticipantsResponse = MeetingParticipantsResponses[keyof MeetingParticipantsResponses];
+
+export type MeetingPrepareData = {
+ body?: never;
+ path?: never;
+ query?: never;
+ url: '/call/meetings/prepare';
+};
+
+export type MeetingPrepareErrors = {
+ 401: ErrorResponse;
+};
+
+export type MeetingPrepareError = MeetingPrepareErrors[keyof MeetingPrepareErrors];
+
+export type MeetingPrepareResponses = {
+ 200: MeetingPreparation;
+};
+
+export type MeetingPrepareResponse = MeetingPrepareResponses[keyof MeetingPrepareResponses];
+
+export type MeetingCancelPreparationData = {
+ body?: never;
+ path: {
+ preparation_id: string;
+ };
+ query?: never;
+ url: '/call/meetings/prepare/{preparation_id}';
+};
+
+export type MeetingCancelPreparationErrors = {
+ 401: ErrorResponse;
+};
+
+export type MeetingCancelPreparationError = MeetingCancelPreparationErrors[keyof MeetingCancelPreparationErrors];
+
+export type MeetingCancelPreparationResponses = {
+ 204: void;
+};
+
+export type MeetingCancelPreparationResponse = MeetingCancelPreparationResponses[keyof MeetingCancelPreparationResponses];
+
export type MeetingCancelData = {
body?: never;
path: {
diff --git a/packages/sdk/specs/storage.json b/packages/sdk/specs/storage.json
index 05380a2773..a42d94634c 100644
--- a/packages/sdk/specs/storage.json
+++ b/packages/sdk/specs/storage.json
@@ -1421,6 +1421,55 @@
}
}
},
+ "/call/join/{token}/participants": {
+ "get": {
+ "tags": ["call::inbound::axum_router::meetings"],
+ "summary": "Read a standalone meeting preview without admitting a guest to the room.",
+ "operationId": "meeting_guest_participants",
+ "parameters": [
+ {
+ "name": "token",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/MeetingParticipants"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/call/meetings": {
"get": {
"tags": ["call::inbound::axum_router::meetings"],
@@ -1816,6 +1865,107 @@
}
}
},
+ "/call/meetings/join/{token}/participants": {
+ "get": {
+ "tags": ["call::inbound::axum_router::meetings"],
+ "summary": "Read the participant preview for an authenticated invitation holder.",
+ "operationId": "meeting_participants",
+ "parameters": [
+ {
+ "name": "token",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/MeetingParticipants"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/call/meetings/prepare": {
+ "post": {
+ "tags": ["call::inbound::axum_router::meetings"],
+ "summary": "Reserve a room while the authenticated caller configures a new call.",
+ "operationId": "meeting_prepare",
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/MeetingPreparation"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/call/meetings/prepare/{preparation_id}": {
+ "delete": {
+ "tags": ["call::inbound::axum_router::meetings"],
+ "summary": "Cancel an unused room; the domain owns ownership and activation checks.",
+ "operationId": "meeting_cancel_preparation",
+ "parameters": [
+ {
+ "name": "preparation_id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": ""
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/call/meetings/{meeting_id}": {
"delete": {
"tags": ["call::inbound::axum_router::meetings"],
@@ -20883,6 +21033,11 @@
"type": "object",
"description": "Inputs for creating a meeting without starting its RTC room.",
"properties": {
+ "preparationId": {
+ "type": ["string", "null"],
+ "format": "uuid",
+ "description": "Optional unused room reserved by this actor on the setup screen."
+ },
"scheduledEnd": {
"type": ["string", "null"],
"format": "date-time",
@@ -26272,6 +26427,52 @@
}
}
},
+ "MeetingParticipant": {
+ "type": "object",
+ "description": "Minimal waiting-room display data, without account identities or call content.",
+ "required": ["displayName"],
+ "properties": {
+ "avatarUrl": {
+ "type": ["string", "null"],
+ "description": "Profile image, when available for a Macro member."
+ },
+ "displayName": {
+ "type": "string",
+ "description": "Name displayed in the waiting room."
+ }
+ }
+ },
+ "MeetingParticipants": {
+ "type": "object",
+ "description": "People currently connected to a meeting's room.",
+ "required": ["participants"],
+ "properties": {
+ "participants": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/MeetingParticipant"
+ },
+ "description": "Human attendees only; transcription agents are excluded."
+ }
+ }
+ },
+ "MeetingPreparation": {
+ "type": "object",
+ "description": "An empty room reservation, not a started call or an invitation.",
+ "required": ["id", "expiresAt"],
+ "properties": {
+ "expiresAt": {
+ "type": "string",
+ "format": "date-time",
+ "description": "After this deadline Start falls back to ordinary room creation."
+ },
+ "id": {
+ "type": "string",
+ "format": "uuid",
+ "description": "Also the reserved RTC room's UUID and prospective call ID."
+ }
+ }
+ },
"MeetingToken": {
"type": "string",
"description": "A bearer capability that grants access only to a meeting's RTC room."
diff --git a/packages/sdk/src/coverage/skipped.ts b/packages/sdk/src/coverage/skipped.ts
index 61a7b79e05..e2a8f2a59b 100644
--- a/packages/sdk/src/coverage/skipped.ts
+++ b/packages/sdk/src/coverage/skipped.ts
@@ -330,10 +330,15 @@ export const storageExcluded = [
'jobProcessingResultHandler',
'joinChannelByCode',
'leaveOrEndCall',
- // Joining and leaving live meetings are app session flows.
+ // Live meeting admission and participant previews are app session flows.
'meetingGuestJoin',
+ // Browser setup reserves an empty RTC room before creating a meeting.
+ 'meetingPrepare',
+ 'meetingCancelPreparation',
+ 'meetingGuestParticipants',
'meetingJoin',
'meetingLeave',
+ 'meetingParticipants',
'mentionPreviews',
'patchViewHandler',
'postChannelMessages',
diff --git a/services/document_storage_service/src/api/swagger.rs b/services/document_storage_service/src/api/swagger.rs
index 6fe5275b93..54e9961751 100644
--- a/services/document_storage_service/src/api/swagger.rs
+++ b/services/document_storage_service/src/api/swagger.rs
@@ -307,6 +307,8 @@ use utoipa::OpenApi;
// calls
call::inbound::axum_router::meetings::create,
+ call::inbound::axum_router::meetings::prepare,
+ call::inbound::axum_router::meetings::cancel_preparation,
call::inbound::axum_router::meetings::update,
call::inbound::axum_router::meetings::list,
call::inbound::axum_router::meetings::list_active,
@@ -317,6 +319,8 @@ use utoipa::OpenApi;
call::inbound::axum_router::meetings::invite_permissions,
call::inbound::axum_router::meetings::invite_users,
call::inbound::axum_router::meetings::lookup,
+ call::inbound::axum_router::meetings::participants,
+ call::inbound::axum_router::meetings::guest_participants,
call::inbound::axum_router::meetings::guest_join,
call::inbound::axum_router::meetings::leave,
call::inbound::axum_router::get_or_create_call_handler,