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.

feat(email): add a dedicated Reminders view with collection-owned clocks (#7381)

gbirman8cf742c0085c
diff --git a/.sqlx/query-058c3089c19e7ff2ad58f186a7705d5844847eb9550a9a87dc3edc0742412e81.json b/.sqlx/query-058c3089c19e7ff2ad58f186a7705d5844847eb9550a9a87dc3edc0742412e81.json
new file mode 100644
index 0000000000..1712c1783f
--- /dev/null
+++ b/.sqlx/query-058c3089c19e7ff2ad58f186a7705d5844847eb9550a9a87dc3edc0742412e81.json
@@ -0,0 +1,12 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "INSERT INTO macro_user (id, username, email, stripe_customer_id) VALUES ('d1000000-0000-0000-0000-000000000002', 'delegate', '[email protected]', 'collection_delegate')",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": []
+ },
+ "nullable": []
+ },
+ "hash": "058c3089c19e7ff2ad58f186a7705d5844847eb9550a9a87dc3edc0742412e81"
+}
diff --git a/.sqlx/query-2904efc7f48bf49b74296cc94439d08e856d9fc1d6ca8a045f5cf6c07dda5777.json b/.sqlx/query-2904efc7f48bf49b74296cc94439d08e856d9fc1d6ca8a045f5cf6c07dda5777.json
new file mode 100644
index 0000000000..1691612116
--- /dev/null
+++ b/.sqlx/query-2904efc7f48bf49b74296cc94439d08e856d9fc1d6ca8a045f5cf6c07dda5777.json
@@ -0,0 +1,14 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "UPDATE reminder SET timezone = 'not/a/zone' WHERE id = $1",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "2904efc7f48bf49b74296cc94439d08e856d9fc1d6ca8a045f5cf6c07dda5777"
+}
diff --git a/.sqlx/query-3d90daaf6657fce4944f9100e4dfafc4f27772e0688bac0b3165692422846d7e.json b/.sqlx/query-3d90daaf6657fce4944f9100e4dfafc4f27772e0688bac0b3165692422846d7e.json
new file mode 100644
index 0000000000..befb5520dc
--- /dev/null
+++ b/.sqlx/query-3d90daaf6657fce4944f9100e4dfafc4f27772e0688bac0b3165692422846d7e.json
@@ -0,0 +1,15 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "INSERT INTO entity_access (entity_id, entity_type, source_id, source_type, access_level) VALUES ($1, 'email_thread', $2, 'user', 'view')",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Text"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "3d90daaf6657fce4944f9100e4dfafc4f27772e0688bac0b3165692422846d7e"
+}
diff --git a/.sqlx/query-415513ad29c49b81ef3e9ad7c54637d2a6b70515bdf30c1fe1c3bc89bf39928f.json b/.sqlx/query-415513ad29c49b81ef3e9ad7c54637d2a6b70515bdf30c1fe1c3bc89bf39928f.json
new file mode 100644
index 0000000000..63d1e47006
--- /dev/null
+++ b/.sqlx/query-415513ad29c49b81ef3e9ad7c54637d2a6b70515bdf30c1fe1c3bc89bf39928f.json
@@ -0,0 +1,12 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "INSERT INTO \"User\" (id, email, macro_user_id) VALUES ('macro|[email protected]', '[email protected]', 'd2000000-0000-0000-0000-000000000002')",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": []
+ },
+ "nullable": []
+ },
+ "hash": "415513ad29c49b81ef3e9ad7c54637d2a6b70515bdf30c1fe1c3bc89bf39928f"
+}
diff --git a/.sqlx/query-5ea86d0df1cb75de68942e815b3eb8a1283ebafacc6f01db4d4a0fbb602b92b5.json b/.sqlx/query-5ea86d0df1cb75de68942e815b3eb8a1283ebafacc6f01db4d4a0fbb602b92b5.json
new file mode 100644
index 0000000000..9b897d7944
--- /dev/null
+++ b/.sqlx/query-5ea86d0df1cb75de68942e815b3eb8a1283ebafacc6f01db4d4a0fbb602b92b5.json
@@ -0,0 +1,15 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "INSERT INTO \"User\" (id,email,macro_user_id) VALUES ($1,$1,$2)",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Text",
+ "Uuid"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "5ea86d0df1cb75de68942e815b3eb8a1283ebafacc6f01db4d4a0fbb602b92b5"
+}
diff --git a/.sqlx/query-892bc28b71266d791c42b239b76acfc6667400f846e3dd698af89058ecb186e9.json b/.sqlx/query-892bc28b71266d791c42b239b76acfc6667400f846e3dd698af89058ecb186e9.json
new file mode 100644
index 0000000000..09bc946401
--- /dev/null
+++ b/.sqlx/query-892bc28b71266d791c42b239b76acfc6667400f846e3dd698af89058ecb186e9.json
@@ -0,0 +1,15 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "DELETE FROM entity_access WHERE entity_id = $1 AND source_id = $2",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Text"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "892bc28b71266d791c42b239b76acfc6667400f846e3dd698af89058ecb186e9"
+}
diff --git a/.sqlx/query-9544219cb43b9a2c43beaf828822639bb4cab3893c4fc70157ea7b66477877b7.json b/.sqlx/query-9544219cb43b9a2c43beaf828822639bb4cab3893c4fc70157ea7b66477877b7.json
new file mode 100644
index 0000000000..52d5822db5
--- /dev/null
+++ b/.sqlx/query-9544219cb43b9a2c43beaf828822639bb4cab3893c4fc70157ea7b66477877b7.json
@@ -0,0 +1,18 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "INSERT INTO reminder_email_followup (reminder_id, user_id, thread_id, link_id, state, payload) VALUES ($1, $2, $3, $4, 'pending', $5)",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Text",
+ "Uuid",
+ "Uuid",
+ "Jsonb"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "9544219cb43b9a2c43beaf828822639bb4cab3893c4fc70157ea7b66477877b7"
+}
diff --git a/.sqlx/query-a1bf781fdf9e640eb93e9565e2eba9632610d0a9b4a1e70a022db9c05c4cdf72.json b/.sqlx/query-a1bf781fdf9e640eb93e9565e2eba9632610d0a9b4a1e70a022db9c05c4cdf72.json
new file mode 100644
index 0000000000..25d35ec37a
--- /dev/null
+++ b/.sqlx/query-a1bf781fdf9e640eb93e9565e2eba9632610d0a9b4a1e70a022db9c05c4cdf72.json
@@ -0,0 +1,12 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "INSERT INTO \"User\" (id, email, macro_user_id) VALUES ('macro|[email protected]', '[email protected]', 'd1000000-0000-0000-0000-000000000002')",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": []
+ },
+ "nullable": []
+ },
+ "hash": "a1bf781fdf9e640eb93e9565e2eba9632610d0a9b4a1e70a022db9c05c4cdf72"
+}
diff --git a/.sqlx/query-bd8536537fe4ddb1624f3b2465bd4a614f69b41c4e3e4d0c06d198208c1f1ac6.json b/.sqlx/query-bd8536537fe4ddb1624f3b2465bd4a614f69b41c4e3e4d0c06d198208c1f1ac6.json
new file mode 100644
index 0000000000..396b01c652
--- /dev/null
+++ b/.sqlx/query-bd8536537fe4ddb1624f3b2465bd4a614f69b41c4e3e4d0c06d198208c1f1ac6.json
@@ -0,0 +1,12 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "INSERT INTO macro_user (id, username, email, stripe_customer_id) VALUES ('d2000000-0000-0000-0000-000000000002', 'shared-viewer', '[email protected]', 'collection_shared')",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": []
+ },
+ "nullable": []
+ },
+ "hash": "bd8536537fe4ddb1624f3b2465bd4a614f69b41c4e3e4d0c06d198208c1f1ac6"
+}
diff --git a/.sqlx/query-c1ea8a70ac8688b0432215f1b415477a9769c4d19dff5dd9b8a5cad4edce1124.json b/.sqlx/query-c1ea8a70ac8688b0432215f1b415477a9769c4d19dff5dd9b8a5cad4edce1124.json
new file mode 100644
index 0000000000..46c2e8c57a
--- /dev/null
+++ b/.sqlx/query-c1ea8a70ac8688b0432215f1b415477a9769c4d19dff5dd9b8a5cad4edce1124.json
@@ -0,0 +1,39 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "\n WITH eligible AS MATERIALIZED (\n SELECT r.id, r.description, r.entity_type, r.entity_id,\n r.remind_at, r.cron, r.timezone, r.next_run_at, r.enabled,\n r.completed_at, r.created_at, r.updated_at, f.payload AS followup,\n (f.reminder_id IS NOT NULL) AS has_followup\n FROM reminder r\n LEFT JOIN reminder_email_followup f ON f.reminder_id = r.id AND f.user_id = $1\n WHERE r.user_id = $1 AND r.entity_type = 'email_thread' AND r.entity_id IS NOT NULL\n AND ($2::uuid[] IS NULL OR r.entity_id = ANY($2))\n AND CASE WHEN f.reminder_id IS NOT NULL THEN\n f.state IN ('archiving', 'pending', 'returning')\n OR (f.state = 'returned' AND r.completed_at IS NULL)\n ELSE\n (r.enabled AND (r.completed_at IS NULL OR r.cron IS NOT NULL))\n OR (r.cron IS NULL AND r.completed_at IS NULL AND r.next_run_at <= $3)\n END\n ), grouped AS (\n SELECT entity_id, MIN(next_run_at) AS next_run_at\n FROM eligible GROUP BY entity_id\n ), candidates AS (\n SELECT entity_id, next_run_at FROM grouped\n WHERE $4::timestamptz IS NULL OR (next_run_at, entity_id) > ($4, $5)\n ORDER BY next_run_at, entity_id LIMIT $6\n )\n SELECT c.entity_id AS \"thread_id!\", c.next_run_at AS \"next_run_at!\",\n jsonb_agg(to_jsonb(r) ORDER BY r.next_run_at, r.created_at, r.id) AS \"reminders!\"\n FROM candidates c JOIN eligible r ON r.entity_id = c.entity_id\n GROUP BY c.entity_id, c.next_run_at\n ORDER BY c.next_run_at, c.entity_id\n ",
+ "describe": {
+ "columns": [
+ {
+ "ordinal": 0,
+ "name": "thread_id!",
+ "type_info": "Uuid"
+ },
+ {
+ "ordinal": 1,
+ "name": "next_run_at!",
+ "type_info": "Timestamptz"
+ },
+ {
+ "ordinal": 2,
+ "name": "reminders!",
+ "type_info": "Jsonb"
+ }
+ ],
+ "parameters": {
+ "Left": [
+ "Text",
+ "UuidArray",
+ "Timestamptz",
+ "Timestamptz",
+ "Uuid",
+ "Int8"
+ ]
+ },
+ "nullable": [
+ true,
+ null,
+ null
+ ]
+ },
+ "hash": "c1ea8a70ac8688b0432215f1b415477a9769c4d19dff5dd9b8a5cad4edce1124"
+}
diff --git a/.sqlx/query-eb0b6e62c6e97efbf5101d16350f2fee54a2547f36db951992e5896ef96481a3.json b/.sqlx/query-eb0b6e62c6e97efbf5101d16350f2fee54a2547f36db951992e5896ef96481a3.json
new file mode 100644
index 0000000000..9e25d849b7
--- /dev/null
+++ b/.sqlx/query-eb0b6e62c6e97efbf5101d16350f2fee54a2547f36db951992e5896ef96481a3.json
@@ -0,0 +1,15 @@
+{
+ "db_name": "PostgreSQL",
+ "query": "INSERT INTO macro_user (id, username, email, stripe_customer_id) VALUES ($1,$2,$2,$2)",
+ "describe": {
+ "columns": [],
+ "parameters": {
+ "Left": [
+ "Uuid",
+ "Text"
+ ]
+ },
+ "nullable": []
+ },
+ "hash": "eb0b6e62c6e97efbf5101d16350f2fee54a2547f36db951992e5896ef96481a3"
+}
diff --git a/apps/web/src/components/app/mobile/PillTabs.tsx b/apps/web/src/components/app/mobile/PillTabs.tsx
index 6850a3f839..a9f5c44096 100644
--- a/apps/web/src/components/app/mobile/PillTabs.tsx
+++ b/apps/web/src/components/app/mobile/PillTabs.tsx
@@ -161,6 +161,7 @@ function snapInsets(content: HTMLElement) {
function ScrollablePillTabs<T extends string>(props: PillTabsProps<T>) {
const [stripRef, setStripRef] = createSignal<HTMLDivElement>();
const [contentRef, setContentRef] = createSignal<HTMLDivElement>();
+ const stripSize = createElementSize(stripRef);
// Horizontal panning, driven manually from the content row's pointer
// events: the strip is pointer-events:none (so its shadow halo passes
@@ -291,10 +292,12 @@ function ScrollablePillTabs<T extends string>(props: PillTabsProps<T>) {
() =>
[
props.value,
+ stripSize.width,
props.items.map((item) => item.value).join('\u0000'),
] as const,
() => {
- queueMicrotask(() => {
+ if (!stripSize.width) return;
+ const frame = requestAnimationFrame(() => {
const strip = stripRef();
const active = strip?.querySelector<HTMLElement>('[data-checked]');
if (!strip || !active) return;
@@ -309,14 +312,15 @@ function ScrollablePillTabs<T extends string>(props: PillTabsProps<T>) {
const itemRight = itemLeft + itemRect.width;
const viewRight = strip.scrollLeft + strip.clientWidth;
if (itemLeft - minLeft < strip.scrollLeft) {
- strip.scrollTo({ left: itemLeft - minLeft, behavior: 'smooth' });
+ strip.scrollTo({ left: itemLeft - minLeft, behavior: 'instant' });
} else if (itemRight + padRight > viewRight) {
strip.scrollTo({
left: itemRight + padRight - strip.clientWidth,
- behavior: 'smooth',
+ behavior: 'instant',
});
}
});
+ onCleanup(() => cancelAnimationFrame(frame));
}
)
);
diff --git a/apps/web/src/components/list/use-list-interactions.test.ts b/apps/web/src/components/list/use-list-interactions.test.ts
index c3fb6779fc..a91ec9f104 100644
--- a/apps/web/src/components/list/use-list-interactions.test.ts
+++ b/apps/web/src/components/list/use-list-interactions.test.ts
@@ -76,3 +76,50 @@ it('keeps H on entities available for reminders and consumes it on headers', ()
}
});
});
+
+it('lets focused native actions own Enter while preserving ordinary and programmatic list activation', () => {
+ createRoot((dispose) => {
+ try {
+ const activate = vi.fn();
+ const list = createListController({
+ items: () => [{ id: 'email' }],
+ getKey: (row) => row.id,
+ onActivate: activate,
+ });
+ useListInteractions({
+ controller: list,
+ scopeId: 'email',
+ scrollHandle: () => undefined,
+ activation: {
+ shouldHandleKeyEvent: (event) =>
+ !(
+ event?.target instanceof Element &&
+ event.target.closest('button[data-reminder-action]')
+ ),
+ },
+ });
+ list.focus.set('email');
+ const button = document.createElement('button');
+ button.setAttribute('data-reminder-action', '');
+ const event = new KeyboardEvent('keydown', { key: 'Enter' });
+ Object.defineProperty(event, 'target', { value: button });
+ for (const key of ['enter', 'shift+enter']) {
+ const hotkey = vi
+ .mocked(registerHotkey)
+ .mock.calls.find(([options]) => options.hotkey === key)![0];
+ expect(hotkey.keyDownHandler(event)).toBe(false);
+ expect(activate).not.toHaveBeenCalled();
+ }
+ const primary = vi
+ .mocked(registerHotkey)
+ .mock.calls.find(([options]) => options.hotkey === 'enter')![0];
+ expect(
+ primary.keyDownHandler(new KeyboardEvent('keydown', { key: 'Enter' }))
+ ).toBe(true);
+ expect(primary.keyDownHandler()).toBe(true);
+ expect(activate).toHaveBeenCalledTimes(2);
+ } finally {
+ dispose();
+ }
+ });
+});
diff --git a/apps/web/src/components/list/use-list-interactions.ts b/apps/web/src/components/list/use-list-interactions.ts
index daa57ea1e1..613848af86 100644
--- a/apps/web/src/components/list/use-list-interactions.ts
+++ b/apps/web/src/components/list/use-list-interactions.ts
@@ -59,6 +59,8 @@ export type ListInteractionNavigationEvent<TItem> =
export type ListInteractionActivationIntent = 'primary' | 'alternate';
export type ListInteractionActivation<TMetadata> = {
+ /** Let a native control own its key event before document capture consumes it. */
+ shouldHandleKeyEvent?: (event: KeyboardEvent | undefined) => boolean;
createMetadata?: (intent: ListInteractionActivationIntent) => TMetadata;
alternateDescription?: string;
};
@@ -359,7 +361,10 @@ export function useListInteractions<TItem, TMetadata = unknown>(
scopeId: options.scopeId,
description: 'Open item',
condition: canOpen,
- keyDownHandler: () => open('primary'),
+ keyDownHandler: (event) =>
+ options.activation?.shouldHandleKeyEvent?.(event) === false
+ ? false
+ : open('primary'),
}).withGroup(group);
registerHotkey({
@@ -369,7 +374,10 @@ export function useListInteractions<TItem, TMetadata = unknown>(
options.activation?.alternateDescription ?? 'Open item alternatively',
condition: canOpen,
hide: true,
- keyDownHandler: () => open('alternate'),
+ keyDownHandler: (event) =>
+ options.activation?.shouldHandleKeyEvent?.(event) === false
+ ? false
+ : open('alternate'),
}).withGroup(group);
const canToggleSelection = () => {
diff --git a/apps/web/src/components/view-shell/use-view-tab-hotkeys.test.ts b/apps/web/src/components/view-shell/use-view-tab-hotkeys.test.ts
new file mode 100644
index 0000000000..f36cd8a209
--- /dev/null
+++ b/apps/web/src/components/view-shell/use-view-tab-hotkeys.test.ts
@@ -0,0 +1,36 @@
+import { registerHotkey } from '@core/hotkey/hotkeys';
+import { createRoot } from 'solid-js';
+import { expect, it, vi } from 'vitest';
+import { useViewTabHotkeys } from './use-view-tab-hotkeys';
+
+vi.mock('@core/hotkey/hotkeys', () => ({
+ registerHotkey: vi.fn(() => ({ withGroup: vi.fn() })),
+ createHotkeyGroup: () => ({ dispose: vi.fn() }),
+}));
+
+it('leaves guarded native Tab events alone while retaining programmatic and numbered view navigation', () => {
+ createRoot((dispose) => {
+ const move = vi.fn();
+ const nativeEvent = new KeyboardEvent('keydown', { key: 'Tab' });
+ useViewTabHotkeys({
+ scopeId: 'email',
+ ids: () => ['all', 'reminders'],
+ activeId: () => 'all',
+ setActiveId: move,
+ shouldHandleSequentialKeyEvent: (event) => event !== nativeEvent,
+ });
+ const handler = (key: string) =>
+ vi
+ .mocked(registerHotkey)
+ .mock.calls.find(([options]) => options.hotkey === key)![0]
+ .keyDownHandler!;
+ expect(handler('tab')(nativeEvent)).toBe(false);
+ expect(handler('shift+tab')(nativeEvent)).toBe(false);
+ expect(move).not.toHaveBeenCalled();
+ expect(handler('tab')()).toBe(true);
+ expect(move).toHaveBeenLastCalledWith('reminders');
+ expect(handler('1')(nativeEvent)).toBe(true);
+ expect(move).toHaveBeenLastCalledWith('all');
+ dispose();
+ });
+});
diff --git a/apps/web/src/components/view-shell/use-view-tab-hotkeys.ts b/apps/web/src/components/view-shell/use-view-tab-hotkeys.ts
index af9dc40992..1705751fae 100644
--- a/apps/web/src/components/view-shell/use-view-tab-hotkeys.ts
+++ b/apps/web/src/components/view-shell/use-view-tab-hotkeys.ts
@@ -8,6 +8,9 @@ export type UseViewTabHotkeysOptions<TTab extends string> = {
activeId: () => TTab;
setActiveId: (id: TTab) => void;
enabled?: () => boolean;
+ shouldHandleSequentialKeyEvent?: (
+ event: KeyboardEvent | undefined
+ ) => boolean;
};
/** Registers numeric and sequential navigation for a view's tabs. */
@@ -60,7 +63,10 @@ export function useViewTabHotkeys<TTab extends string>(
scopeId: options.scopeId,
description: 'Next tab',
condition: () => isEnabled() && options.ids().length > 1,
- keyDownHandler: () => move(1),
+ keyDownHandler: (event) =>
+ options.shouldHandleSequentialKeyEvent?.(event) === false
+ ? false
+ : move(1),
}).withGroup(group);
registerHotkey({
@@ -69,7 +75,10 @@ export function useViewTabHotkeys<TTab extends string>(
scopeId: options.scopeId,
description: 'Previous tab',
condition: () => isEnabled() && options.ids().length > 1,
- keyDownHandler: () => move(-1),
+ keyDownHandler: (event) =>
+ options.shouldHandleSequentialKeyEvent?.(event) === false
+ ? false
+ : move(-1),
}).withGroup(group);
onCleanup(() => group.dispose());
diff --git a/apps/web/src/features/email-view/components/EmailEmptyState.tsx b/apps/web/src/features/email-view/components/EmailEmptyState.tsx
index 081e9b8b67..9871dc14dc 100644
--- a/apps/web/src/features/email-view/components/EmailEmptyState.tsx
+++ b/apps/web/src/features/email-view/components/EmailEmptyState.tsx
@@ -36,6 +36,10 @@ function tabCopy(tab: EmailTab): { title: string; description: string } {
title: 'No scheduled email',
description: 'Email you schedule to send later will appear here.',
}))
+ .with('reminders', () => ({
+ title: 'No email reminders',
+ description: 'Use Remind me on an email to return to it later.',
+ }))
.with('calendar', () => ({
title: 'No calendar email',
description: 'Invitations and event updates will appear here.',
@@ -61,7 +65,9 @@ export function EmailEmptyState() {
const startAddInbox = useAddInboxFlow();
// Scheduled has no search or filters; text typed on another tab stays behind.
const searchText = () =>
- state.tab === 'scheduled' ? '' : state.search.trim();
+ state.tab === 'scheduled' || state.tab === 'reminders'
+ ? ''
+ : state.search.trim();
const noInboxesSelected = () => state.inboxIds?.length === 0;
const hasActiveFilters = () =>
Object.values(state.facets).some((optionIds) => optionIds.length > 0);
diff --git a/apps/web/src/features/email-view/components/EmailHeader.tsx b/apps/web/src/features/email-view/components/EmailHeader.tsx
index 9572f6fc44..312cbc78e2 100644
--- a/apps/web/src/features/email-view/components/EmailHeader.tsx
+++ b/apps/web/src/features/email-view/components/EmailHeader.tsx
@@ -75,7 +75,7 @@ export function EmailHeader(props: EmailHeaderProps) {
enabled: panel.isPanelActive,
search: {
description: 'Search email',
- condition: () => state.tab !== 'scheduled',
+ condition: () => state.tab !== 'scheduled' && state.tab !== 'reminders',
run: () => {
searchInput?.focus();
searchInput?.select();
@@ -112,19 +112,21 @@ export function EmailHeader(props: EmailHeaderProps) {
<Show when={state.tab !== 'scheduled'}>
<div class="flex min-w-0 items-center justify-between gap-3">
- <SearchBar
- ref={(element) => {
- searchInput = element;
- searchTarget(element);
- }}
- label="Search email"
- value={state.search}
- hotkey="cmd+f"
- onValueChange={(search) => setState('search', search)}
- onEscape={props.onSearchEscape}
- placeholder="Search email"
- class="max-w-md flex-1"
- />
+ <Show when={state.tab !== 'reminders'}>
+ <SearchBar
+ ref={(element) => {
+ searchInput = element;
+ searchTarget(element);
+ }}
+ label="Search email"
+ value={state.search}
+ hotkey="cmd+f"
+ onValueChange={(search) => setState('search', search)}
+ onEscape={props.onSearchEscape}
+ placeholder="Search email"
+ class="max-w-md flex-1"
+ />
+ </Show>
<EmailControls
filterOpen={filterOpen()}
onFilterOpenChange={setFilterOpen}
diff --git a/apps/web/src/features/email-view/components/EmailList.tsx b/apps/web/src/features/email-view/components/EmailList.tsx
index 8b02f5d542..a2ca5fddb3 100644
--- a/apps/web/src/features/email-view/components/EmailList.tsx
+++ b/apps/web/src/features/email-view/components/EmailList.tsx
@@ -6,6 +6,7 @@ import {
toEntityActionListState,
useEntityActionHotkeys,
} from '@app/features/next-soup/actions';
+import { EmailRowSchedule } from '@app/features/reminders/views/email-row-schedule';
import {
createSoupEntityActions,
MaybeSoupEntityActionDrawerManager,
@@ -102,7 +103,7 @@ export function EmailList(props: EmailListProps) {
metadata,
}: ListActivation<EmailDataSourceItem, EmailListActivationMetadata>) {
if (item.kind === 'load-more') {
- if (!item.isLoading) void source.loadMore();
+ if (!item.isLoading) void source.loadMore().catch(() => {});
return;
}
@@ -236,7 +237,8 @@ export function EmailList(props: EmailListProps) {
navigation: {
onNavigate: (event) => {
if (event.kind !== 'move' || event.direction !== 1) return;
- if (source.isLoadingMore() || !source.hasMore()) return;
+ if (source.isLoadingMore() || source.error() || !source.hasMore())
+ return;
const distanceFromEnd = event.result
? list.items.count() - event.result.index - 1
@@ -244,10 +246,15 @@ export function EmailList(props: EmailListProps) {
if (distanceFromEnd > 3) return;
- void source.loadMore();
+ void source.loadMore().catch(() => {});
},
},
activation: {
+ shouldHandleKeyEvent: (event) =>
+ !(
+ event?.target instanceof Element &&
+ event.target.closest('button[data-reminder-action]')
+ ),
createMetadata: (intent) => ({ newSplit: intent === 'alternate' }),
alternateDescription: 'Open in new split',
},
@@ -347,10 +354,13 @@ export function EmailList(props: EmailListProps) {
restoredScroll = true;
}
+ const hasEmailRows = () => rows().some((row) => row.kind === 'entity');
+
function showsEmptyViewport() {
return (
forceEmptyState() ||
- (!source.isLoading() && (Boolean(source.error()) || rows().length === 0))
+ (!source.isLoading() &&
+ ((Boolean(source.error()) && !hasEmailRows()) || rows().length === 0))
);
}
@@ -406,12 +416,12 @@ export function EmailList(props: EmailListProps) {
const handle = virtualizer();
if (!handle) return;
- if (!source.hasMore()) return;
+ if (!source.hasMore() || source.error()) return;
const distance =
handle.scrollSize - handle.scrollOffset - handle.viewportSize;
if (distance < 300 && !source.isLoadingMore()) {
- void source.loadMore();
+ void source.loadMore().catch(() => {});
}
}
@@ -471,7 +481,9 @@ export function EmailList(props: EmailListProps) {
</div>
</Match>
- <Match when={!forceEmptyState() && source.error()}>
+ <Match
+ when={!forceEmptyState() && source.error() && !hasEmailRows()}
+ >
<div
ref={setEmptyViewport}
class="flex min-h-0 flex-1 flex-col items-center justify-center gap-3 overflow-y-auto text-sm text-ink-muted touch:pt-(--mobile-content-inset-top) touch:pb-(--mobile-content-inset-bottom)"
@@ -565,6 +577,19 @@ export function EmailList(props: EmailListProps) {
<div role="gridcell">
<ListEntity
entity={entityRow().entity}
+ scheduleStatus={
+ <Show
+ when={source.reminderForThread?.(
+ entityRow().entity.id
+ )}
+ >
+ {(reminder) => (
+ <EmailRowSchedule
+ reminder={reminder()}
+ />
+ )}
+ </Show>
+ }
leadingAction={
<Show when={!isTouchDevice()}>
<EmailStarAction
@@ -699,7 +724,7 @@ export function EmailList(props: EmailListProps) {
</Show>
{loadMore().isLoading
? 'Loading...'
- : 'Load More'}
+ : (loadMore().label ?? 'Load More')}
</Button>
</div>
</div>
diff --git a/apps/web/src/features/email-view/components/EmailSidebar.tsx b/apps/web/src/features/email-view/components/EmailSidebar.tsx
index f55ef7546a..c275fc14f4 100644
--- a/apps/web/src/features/email-view/components/EmailSidebar.tsx
+++ b/apps/web/src/features/email-view/components/EmailSidebar.tsx
@@ -1,8 +1,11 @@
import { useViewTabHotkeys, ViewSidebar } from '@app/components/view-shell';
import { SidebarCreateButton } from '@app/components/view-shell/SidebarCreateButton';
+import { useFeatureFlag } from '@app/lib/analytics/posthog';
import { useSplitLayout } from '@components/app/split-layout/layout';
import { useSplitPanelOrThrow } from '@components/app/split-layout/layoutUtils';
+import { enableReminders } from '@core/constant/featureFlags';
import { isTouchDevice } from '@core/mobile/isTouchDevice';
+import BellIcon from '@phosphor/bell-simple.svg';
import CalendarBlankIcon from '@phosphor/calendar-blank.svg';
import ClockIcon from '@phosphor/clock.svg';
import EnvelopeIcon from '@phosphor/envelope.svg';
@@ -30,6 +33,7 @@ const TAB_ICONS: Record<EmailTab, Component<{ class?: string }>> = {
favorites: StarIcon,
sent: PaperPlaneTiltIcon,
scheduled: ClockIcon,
+ reminders: BellIcon,
calendar: CalendarBlankIcon,
drafts: FileIcon,
shared: UsersThreeIcon,
@@ -56,6 +60,8 @@ function Tab(props: { item: EmailTabItem; onNavigate?: () => void }) {
}
export function EmailNavigation(props: { onNavigate?: () => void }) {
+ const { state } = useEmailView();
+ const reminders = useFeatureFlag(enableReminders);
return (
<ViewSidebar.Nav aria-label="Email tabs">
<div
@@ -66,7 +72,14 @@ export function EmailNavigation(props: { onNavigate?: () => void }) {
{(item) => <Tab item={item} onNavigate={props.onNavigate} />}
</For>
</div>
- <For each={EMAIL_TABS.slice(2)}>
+ <For
+ each={EMAIL_TABS.slice(2).filter(
+ (tab) =>
+ tab.id !== 'reminders' ||
+ reminders().enabled ||
+ (reminders().loading && state.tab === 'reminders')
+ )}
+ >
{(item) => <Tab item={item} onNavigate={props.onNavigate} />}
</For>
</ViewSidebar.Nav>
@@ -74,6 +87,7 @@ export function EmailNavigation(props: { onNavigate?: () => void }) {
}
export function EmailSidebar() {
+ const reminders = useFeatureFlag(enableReminders);
const panel = useSplitPanelOrThrow();
const { openWithSplit } = useSplitLayout();
const {
@@ -87,9 +101,20 @@ export function EmailSidebar() {
useViewTabHotkeys({
scopeId: panel.splitHotkeyScope,
enabled: panel.isPanelActive,
- ids: () => EMAIL_TAB_IDS,
+ ids: () =>
+ EMAIL_TAB_IDS.filter(
+ (id) =>
+ id !== 'reminders' ||
+ reminders().enabled ||
+ (reminders().loading && state.tab === 'reminders')
+ ),
activeId: () => state.tab,
setActiveId: setTab,
+ shouldHandleSequentialKeyEvent: (event) =>
+ !(
+ event?.target instanceof Element &&
+ event.target.closest('[role="grid"][aria-label="Email"]')
+ ),
});
return (
diff --git a/apps/web/src/features/email-view/constants.ts b/apps/web/src/features/email-view/constants.ts
index 7e8214cf13..a04846f5e0 100644
--- a/apps/web/src/features/email-view/constants.ts
+++ b/apps/web/src/features/email-view/constants.ts
@@ -11,6 +11,7 @@ export const EMAIL_TABS: EmailTabItem[] = [
{ id: 'favorites', label: 'Favorites' },
{ id: 'sent', label: 'Sent' },
{ id: 'scheduled', label: 'Scheduled' },
+ { id: 'reminders', label: 'Reminders' },
{ id: 'calendar', label: 'Calendar' },
{ id: 'drafts', label: 'Drafts' },
{ id: 'shared', label: 'Shared' },
diff --git a/apps/web/src/features/email-view/email-route.ts b/apps/web/src/features/email-view/email-route.ts
index 096eebb6b6..38781dd50b 100644
--- a/apps/web/src/features/email-view/email-route.ts
+++ b/apps/web/src/features/email-view/email-route.ts
@@ -11,6 +11,7 @@ export const emailTabSearch = {
'favorites',
'sent',
'scheduled',
+ 'reminders',
'calendar',
'drafts',
'shared',
diff --git a/apps/web/src/features/email-view/email-view-context.test.tsx b/apps/web/src/features/email-view/email-view-context.test.tsx
index 93118456c7..511f20e84d 100644
--- a/apps/web/src/features/email-view/email-view-context.test.tsx
+++ b/apps/web/src/features/email-view/email-view-context.test.tsx
@@ -11,8 +11,13 @@ const mocks = vi.hoisted(() => ({
navigate: vi.fn(),
useRouteParams: vi.fn(),
useEmailLinksQuery: vi.fn(),
+ reminders: (): boolean => true,
+ tab: (): string => 'important',
}));
+vi.mock('@app/lib/analytics/posthog', () => ({
+ useFeatureFlag: () => () => ({ enabled: mocks.reminders() }),
+}));
vi.mock('@app/components/list', () => ({
createListController: () => ({}),
listOwnedSlotName: (name: string) => name,
@@ -31,7 +36,13 @@ vi.mock('@app/lib/persistence', () => ({
vi.mock('@app/lib/split-router', () => ({
useNavigate: () => mocks.navigate,
useRouteParams: () => mocks.useRouteParams(),
- createSearchParams: () => [{ tab: 'important' }],
+ createSearchParams: () => [
+ {
+ get tab() {
+ return mocks.tab();
+ },
+ },
+ ],
}));
vi.mock('@components/app/createPreviewSelectionGuard', () => ({
createPreviewSelectionGuard: () =>
@@ -67,6 +78,8 @@ vi.mock('./email-route', () => ({
afterEach(() => {
cleanup();
vi.clearAllMocks();
+ mocks.reminders = () => true;
+ mocks.tab = () => 'important';
});
function mount() {
@@ -126,3 +139,26 @@ describe('email view inbox reconciliation', () => {
expect(mocks.navigate).toHaveBeenCalledOnce();
});
});
+
+it('clears persisted text search when entering and leaving Email Reminders', () => {
+ const { view } = mount();
+ view.setState('search', 'prior inbox search');
+ view.setTab('reminders');
+ expect(view.state.search).toBe('');
+ view.setState('search', 'stale restored search');
+ view.setTab('all');
+ expect(view.state.search).toBe('');
+});
+
+it('normalizes restored and route-driven Reminders when the rollout is disabled', () => {
+ const [flag, setFlag] = createStore({ enabled: true });
+ mocks.reminders = () => flag.enabled;
+ mocks.tab = () => 'reminders';
+ const { view } = mount();
+ expect(view.state.tab).toBe('reminders');
+ setFlag('enabled', false);
+ expect(view.state.tab).toBe('important');
+ expect(view.state.search).toBe('');
+ view.setTab('reminders');
+ expect(view.state.tab).toBe('important');
+});
diff --git a/apps/web/src/features/email-view/email-view-context.tsx b/apps/web/src/features/email-view/email-view-context.tsx
index 6f4ef80e87..c771dbde80 100644
--- a/apps/web/src/features/email-view/email-view-context.tsx
+++ b/apps/web/src/features/email-view/email-view-context.tsx
@@ -9,6 +9,7 @@ import { setSidebarSectionCollapsed } from '@app/components/view-shell';
import { useMobileSearchText } from '@app/features/command/mobile/use-mobile-search-text';
import { normalizeFacetSelection } from '@app/features/soup';
import { registerListNavigationSource } from '@app/features/soup/collection/list-navigation-source';
+import { useFeatureFlag } from '@app/lib/analytics/posthog';
import { makePersistedState } from '@app/lib/persistence';
import {
createSearchParams,
@@ -20,6 +21,7 @@ import {
useSplitPanelOrThrow,
withSplitPanelOwner,
} from '@components/app/split-layout/layoutUtils';
+import { enableReminders } from '@core/constant/featureFlags';
import { createAssertedContextProvider } from '@core/context/createContext';
import { useUserId } from '@core/context/user';
import { isTouchDevice } from '@core/mobile/isTouchDevice';
@@ -122,10 +124,15 @@ export const [EmailViewProvider, useEmailView] = createAssertedContextProvider<
const tagSets = useTagSets();
const tagSetsReady = useTagSetsReady();
const initial = props.initialState ?? {};
+ const reminders = useFeatureFlag(enableReminders);
+ const availableTab = (tab: EmailTab) =>
+ tab === 'reminders' && !reminders().enabled && !reminders().loading
+ ? DEFAULT_EMAIL_TAB
+ : tab;
const [persistedState, setState] = makePersistedState(
createStore<EmailViewState>({
- tab: initial.tab ?? DEFAULT_EMAIL_TAB,
+ tab: availableTab(initial.tab ?? DEFAULT_EMAIL_TAB),
search: initial.search ?? '',
inboxIds: normalizeInboxSelection(initial.inboxIds),
facets: normalizeFacetSelection(initial.facets),
@@ -153,11 +160,13 @@ export const [EmailViewProvider, useEmailView] = createAssertedContextProvider<
createEffect(
on(
- () => tabSearch.tab,
+ () => availableTab(tabSearch.tab),
(tab) => {
if (state.tab === tab) return;
setState(
produce((draft) => {
+ if (draft.tab === 'reminders' || tab === 'reminders')
+ draft.search = '';
draft.tab = tab;
draft.facets = {};
})
@@ -166,6 +175,16 @@ export const [EmailViewProvider, useEmailView] = createAssertedContextProvider<
)
);
+ createEffect(() => {
+ if (
+ state.tab === 'reminders' &&
+ !reminders().enabled &&
+ !reminders().loading
+ ) {
+ setState({ tab: DEFAULT_EMAIL_TAB, search: '', facets: {} });
+ }
+ });
+
const source = withSplitPanelOwner(listOwnedSlotName('data-source'), () =>
useEmailDataSource(state, { tagSets, tagSetsReady })
);
@@ -307,13 +326,15 @@ export const [EmailViewProvider, useEmailView] = createAssertedContextProvider<
// A tab is a fresh slice of the mailbox: filters chosen for one tab (Done
// on Signal, say) would silently narrow the next, so they reset with it.
- const setTab = (tab: EmailTab) => {
+ const setTab = (requestedTab: EmailTab) => {
+ const tab = availableTab(requestedTab);
if (state.tab === tab) {
closeThread();
return;
}
setState(
produce((draft) => {
+ if (draft.tab === 'reminders' || tab === 'reminders') draft.search = '';
draft.tab = tab;
draft.facets = {};
})
diff --git a/apps/web/src/features/email-view/email-view.tsx b/apps/web/src/features/email-view/email-view.tsx
index 1f4a081909..c5d9c4f260 100644
--- a/apps/web/src/features/email-view/email-view.tsx
+++ b/apps/web/src/features/email-view/email-view.tsx
@@ -1,11 +1,13 @@
import { ViewBreadcrumbs, ViewShell } from '@app/components/view-shell';
import { ViewTour } from '@app/features/tours/ViewTour';
+import { useFeatureFlag } from '@app/lib/analytics/posthog';
import { SplitRouter } from '@app/lib/split-router';
import { type PillTabItem, PillTabs } from '@components/app/mobile/PillTabs';
import { SplitHeaderLeft } from '@components/app/split-layout/components/SplitHeader';
import { useSplitPanelOrThrow } from '@components/app/split-layout/layoutUtils';
import { SplitPanel } from '@components/app/split-panel';
import { StaticMarkdownContext } from '@core/component/LexicalMarkdown/component/core/StaticMarkdown';
+import { enableReminders } from '@core/constant/featureFlags';
import { isTouchDevice } from '@core/mobile/isTouchDevice';
import { ListEntityMetadataQueryProvider } from '@entity';
import SpinnerIcon from '@phosphor/spinner.svg';
@@ -99,6 +101,7 @@ const MOBILE_EMAIL_TABS: PillTabItem<EmailTab>[] = EMAIL_TABS.map((tab) => ({
}));
function EmailMobileLayout(props: ParentProps) {
+ const reminders = useFeatureFlag(enableReminders);
const { state, setTab } = useEmailView();
return (
@@ -110,7 +113,12 @@ function EmailMobileLayout(props: ParentProps) {
class="-ml-(--mobile-chrome-gutter) w-[100cqw] max-w-none flex-none"
contentClass="px-(--mobile-chrome-gutter)"
leading={<EmailFilterDrawer />}
- items={MOBILE_EMAIL_TABS}
+ items={MOBILE_EMAIL_TABS.filter(
+ (tab) =>
+ tab.value !== 'reminders' ||
+ reminders().enabled ||
+ (reminders().loading && state.tab === 'reminders')
+ )}
value={state.tab}
onChange={setTab}
/>
diff --git a/apps/web/src/features/email-view/persistence.ts b/apps/web/src/features/email-view/persistence.ts
index a4fc84fe58..5ec947559e 100644
--- a/apps/web/src/features/email-view/persistence.ts
+++ b/apps/web/src/features/email-view/persistence.ts
@@ -28,6 +28,7 @@ const emailTabSchema = z
'favorites',
'sent',
'scheduled',
+ 'reminders',
'calendar',
'drafts',
'shared',
diff --git a/apps/web/src/features/email-view/queries/email-query.ts b/apps/web/src/features/email-view/queries/email-query.ts
index f35f0de19c..cee5c3a0cf 100644
--- a/apps/web/src/features/email-view/queries/email-query.ts
+++ b/apps/web/src/features/email-view/queries/email-query.ts
@@ -35,7 +35,7 @@ export const emailViewForTab = (tab: EmailTab): string =>
// Soup source on drafts so its query shape remains valid while disabled.
.with('scheduled', () => 'drafts')
.with('sent', () => 'sent')
- .with('favorites', 'calendar', 'shared', 'all', () => 'all')
+ .with('favorites', 'calendar', 'shared', 'all', 'reminders', () => 'all')
.exhaustive();
const anyThread = (): TargetExpr => clause.not(clause.eq('threadId', NIL_UUID));
@@ -77,7 +77,15 @@ function tabClause(context: EmailQueryContext): TargetExpr {
.with('shared', () => clause.eq('emailShared', 'only'))
// Sent and Drafts are scoped entirely by `emailView`; the server's sent
// view already covers every linked inbox, so no sender filter is needed.
- .with('drafts', 'scheduled', 'sent', 'favorites', 'all', anyThread)
+ .with(
+ 'drafts',
+ 'scheduled',
+ 'sent',
+ 'favorites',
+ 'all',
+ 'reminders',
+ anyThread
+ )
.exhaustive()
);
}
diff --git a/apps/web/src/features/email-view/queries/email-search.ts b/apps/web/src/features/email-view/queries/email-search.ts
index 90437c35a8..5ded41501a 100644
--- a/apps/web/src/features/email-view/queries/email-search.ts
+++ b/apps/web/src/features/email-view/queries/email-search.ts
@@ -37,7 +37,15 @@ function tabFilters(tab: EmailTab): EmailFilters {
shared: 'exclude' as const,
}))
.with('shared', () => ({ shared: 'only' as const }))
- .with('favorites', 'drafts', 'scheduled', 'sent', 'all', () => ({}))
+ .with(
+ 'favorites',
+ 'drafts',
+ 'scheduled',
+ 'reminders',
+ 'sent',
+ 'all',
+ () => ({})
+ )
.exhaustive();
}
diff --git a/apps/web/src/features/email-view/queries/use-email-query.test.ts b/apps/web/src/features/email-view/queries/use-email-query.test.ts
index 7ec8976cd1..3f10ff31b1 100644
--- a/apps/web/src/features/email-view/queries/use-email-query.test.ts
+++ b/apps/web/src/features/email-view/queries/use-email-query.test.ts
@@ -115,6 +115,7 @@ function mount(search = '') {
setRetainedEntities(rows);
});
const [loading, setLoading] = createSignal(false);
+ const [paused, setPaused] = createSignal(false);
const [placeholder, setPlaceholder] = createSignal(false);
const [fetching, setFetching] = createSignal(false);
const [tagSetsReady, setTagSetsReady] = createSignal(true);
@@ -182,11 +183,13 @@ function mount(search = '') {
);
const query: SoupAstItemsQuery = {
get data() {
- if (loading()) throw new Error('Read pending query data');
+ if (loading() || paused()) throw new Error('Read pending query data');
+ if (state.tab === 'scheduled' || state.tab === 'reminders')
+ throw new Error('Read disabled native email query');
return { entities: entities(), groups: undefined };
},
get isPending() {
- return loading();
+ return loading() || paused();
},
get isLoading() {
return loading();
@@ -247,6 +250,7 @@ function mount(search = '') {
setRetainedEntities,
setRetentionLoading,
setLoading,
+ setPaused,
setPlaceholder,
setFetching,
setTagSetsReady,
@@ -340,6 +344,30 @@ describe('Email list query transitions', () => {
expect(ids(source)).toEqual(['noise']);
});
+ it('does not read disabled native data on the Reminders tab', () => {
+ const { source, setState } = mount();
+ expect(() => setState('tab', 'reminders')).not.toThrow();
+ expect(ids(source)).toEqual([]);
+ expect(vi.mocked(useSoupAstItemsQuery).mock.calls[0][1]?.().enabled).toBe(
+ false
+ );
+ setState('tab', 'noise');
+ expect(ids(source)).toEqual(['noise']);
+ });
+
+ it('does not suspend on pending native data while its fetch is paused', () => {
+ const { source, setPaused, setEntities, query } = mount();
+ expect(() => setPaused(true)).not.toThrow();
+ expect(query.isLoading).toBe(false);
+ expect(source.isLoading()).toBe(true);
+ expect(ids(source)).toEqual([]);
+ batch(() => {
+ setEntities([email('resumed')]);
+ setPaused(false);
+ });
+ expect(ids(source)).toEqual(['resumed']);
+ });
+
it('does not show Noise rows under other tabs while their cache reads are pending', () => {
const { source, setState, setEntities, setLoading } = mount();
expect(ids(source)).toEqual(['noise']);
@@ -649,3 +677,16 @@ describe('Email list query transitions', () => {
expect(source.hasMore()).toBe(false);
});
});
+
+vi.mock('./use-reminder-email-source', () => ({
+ useReminderEmailSource: () => ({
+ items: () => [],
+ isLoading: () => false,
+ isFetching: () => false,
+ error: () => undefined,
+ hasMore: () => false,
+ isLoadingMore: () => false,
+ loadMore: async () => {},
+ refresh: async () => {},
+ }),
+}));
diff --git a/apps/web/src/features/email-view/queries/use-email-query.ts b/apps/web/src/features/email-view/queries/use-email-query.ts
index 0d94c89655..14de2554cb 100644
--- a/apps/web/src/features/email-view/queries/use-email-query.ts
+++ b/apps/web/src/features/email-view/queries/use-email-query.ts
@@ -1,4 +1,5 @@
import type { ListDataSource } from '@app/components/list';
+import type { EmailRowReminder } from '@app/features/reminders/core/email-row-reminder';
import {
buildFlatSoupRows,
buildGroupedSoupRows,
@@ -33,11 +34,14 @@ import { buildEmailQuery, type EmailQueryContext } from './email-query';
import { groupEmailEntitiesByDate } from './email-results';
import { buildEmailSearchRequest } from './email-search';
import { emailAdmissionBatches, mergeEmailAdmission } from './read-admission';
+import { useReminderEmailSource } from './use-reminder-email-source';
import { useScheduledEmailSource } from './use-scheduled-email-source';
export type EmailDataSourceItem = SoupRow<WithNotification<EntityData>>;
-export type EmailDataSource = ListDataSource<EmailDataSourceItem>;
+export type EmailDataSource = ListDataSource<EmailDataSourceItem> & {
+ reminderForThread?: (threadId: string) => EmailRowReminder | undefined;
+};
export type EmailDataSourceInput = Pick<
EmailViewState,
@@ -72,6 +76,7 @@ function emailMatchesTab(
'favorites',
'sent',
'scheduled',
+ 'reminders',
'calendar',
'all',
() => true
@@ -96,6 +101,8 @@ export function useEmailDataSource(
const notificationSource = useGlobalNotificationSource();
const userId = useUserId();
const scheduled = useScheduledEmailSource(state);
+ const reminders = useReminderEmailSource(state, options);
+ const showsReminders = () => state.tab === 'reminders';
const showsScheduled = () => state.tab === 'scheduled';
const showsFavorites = () => state.tab === 'favorites';
// Uses GraphQL favorites with enable-graphql-soup, REST otherwise. Guard
@@ -134,7 +141,8 @@ export function useEmailDataSource(
!showsFavorites() || favoriteThreadIds() !== undefined;
const filtersReady = () =>
tagsReady() && (!state.search.trim() || searchFavoritesReady());
- const sourceEnabled = () => tagsReady() && state.tab !== 'scheduled';
+ const sourceEnabled = () =>
+ tagsReady() && state.tab !== 'scheduled' && state.tab !== 'reminders';
const searchContext = (): EmailQueryContext => ({
...queryContext(),
...(showsFavorites() ? { favoriteThreadIds: favoriteThreadIds() } : {}),
@@ -143,7 +151,7 @@ export function useEmailDataSource(
enabled: sourceEnabled(),
}));
const isListPending = () =>
- !filtersReady() || query.isLoading || query.isPlaceholderData;
+ !filtersReady() || query.isPending || query.isPlaceholderData;
const selectEmails = (entities: EntityData[]): EmailEntity[] => {
const context = queryContext();
@@ -173,8 +181,10 @@ export function useEmailDataSource(
});
const rawEntities = createMemo<EntityData[]>(() => {
- // Disabled searches can retain placeholder data for the previous facets.
- if (!filtersReady()) return [];
+ // Scheduled/Reminders disable native discovery. Reading its pending data
+ // would suspend the whole split even though that query is not fetching.
+ // Disabled searches can also retain previous-facet placeholder data.
+ if (!sourceEnabled() || !filtersReady()) return [];
if (!search.isSearching()) {
// Previous-tab/inbox rows are not valid results for the new query.
@@ -381,14 +391,28 @@ export function useEmailDataSource(
};
return {
- items: () => (showsScheduled() ? scheduled.items() : items()),
- isLoading: () => (showsScheduled() ? scheduled.isLoading() : isLoading()),
+ reminderForThread: (threadId) =>
+ showsReminders() ? reminders.reminderForThread?.(threadId) : undefined,
+ items: () =>
+ showsReminders()
+ ? reminders.items()
+ : showsScheduled()
+ ? scheduled.items()
+ : items(),
+ isLoading: () =>
+ showsReminders()
+ ? reminders.isLoading()
+ : showsScheduled()
+ ? scheduled.isLoading()
+ : isLoading(),
isFetching: () => {
+ if (showsReminders()) return reminders.isFetching();
if (showsScheduled()) return scheduled.isFetching();
if (search.isSettling()) return true;
return usesServiceSearch() ? search.isFetching() : query.isFetching;
},
error: () => {
+ if (showsReminders()) return reminders.error();
if (showsScheduled()) return scheduled.error();
return (
(search.isSearching() && showsFavorites()
@@ -401,9 +425,17 @@ export function useEmailDataSource(
undefined
);
},
- hasMore: () => !showsScheduled() && hasMore(),
- isLoadingMore: () => !showsScheduled() && isLoadingMore(),
+ hasMore: () =>
+ showsReminders() ? reminders.hasMore() : !showsScheduled() && hasMore(),
+ isLoadingMore: () =>
+ showsReminders()
+ ? reminders.isLoadingMore()
+ : !showsScheduled() && isLoadingMore(),
loadMore: async () => {
+ if (showsReminders()) {
+ await reminders.loadMore();
+ return;
+ }
if (showsScheduled()) return;
if (usesServiceSearch()) {
await search.fetchNextPage();
@@ -412,6 +444,10 @@ export function useEmailDataSource(
await query.fetchNextPage();
},
refresh: async () => {
+ if (showsReminders()) {
+ await reminders.refresh();
+ return;
+ }
if (showsScheduled()) {
await scheduled.refresh();
return;
diff --git a/apps/web/src/features/email-view/queries/use-reminder-email-source.test.ts b/apps/web/src/features/email-view/queries/use-reminder-email-source.test.ts
new file mode 100644
index 0000000000..abac689183
--- /dev/null
+++ b/apps/web/src/features/email-view/queries/use-reminder-email-source.test.ts
@@ -0,0 +1,379 @@
+import type { EmailEntity } from '@entity';
+import type { EmailReminderSummary } from '@service-storage/generated/schemas/emailReminderSummary';
+import { createRoot } from 'solid-js';
+import { createStore } from 'solid-js/store';
+import { afterEach, expect, it, vi } from 'vitest';
+import type { EmailViewState } from '../types';
+import { useEmailDetailListNavigation } from '../use-email-detail-list-navigation';
+import { useReminderEmailSource } from './use-reminder-email-source';
+
+const mocks = vi.hoisted(() => ({
+ collection: vi.fn(),
+ hydration: vi.fn(),
+ view: vi.fn(),
+ open: vi.fn(),
+ failure: vi.fn(),
+ flag: vi.fn(),
+}));
+vi.mock('../email-view-context', () => ({ useEmailView: mocks.view }));
+vi.mock('@core/component/Toast/Toast', () => ({
+ toast: { failure: mocks.failure },
+}));
+vi.mock(
+ '@app/components/list',
+ async () => await import('@app/components/list/use-list-detail-navigation')
+);
+vi.mock('@app/features/soup', async () => ({
+ ...(await import('@app/features/soup/filters')),
+ ...(await import('@app/features/soup/collection/rows')),
+ ...(await import('@app/features/soup/collection/row-store')),
+}));
+vi.mock('@entity', async () => await import('@entity/types/entity'));
+vi.mock('@app/lib/analytics/posthog', () => ({
+ useFeatureFlag: () => mocks.flag,
+}));
+vi.mock('@components/app/GlobalAppState', () => ({
+ useGlobalNotificationSource: () => ({ notificationsByEntity: () => ({}) }),
+}));
+vi.mock('@core/context/user', () => ({ useUserId: () => () => 'alice' }));
+vi.mock('@queries/reminders/email-collection', () => ({
+ useEmailReminderCollection: mocks.collection,
+}));
+vi.mock('@queries/soup/items', () => ({
+ useSoupAstItemsQuery: mocks.hydration,
+}));
+let dispose: (() => void) | undefined;
+afterEach(() => {
+ dispose?.();
+ vi.clearAllMocks();
+});
+function mount() {
+ return createRoot((cleanup) => {
+ dispose = cleanup;
+ const [state, setState] = createStore<EmailViewState>({
+ tab: 'reminders',
+ search: 'persisted text',
+ inboxIds: ['selected-inbox'],
+ facets: {},
+ collapsedSidebarSectionIds: [],
+ });
+ const [collection, setCollection] = createStore({
+ isPending: false,
+ isLoading: false,
+ isFetching: false,
+ isFetchingNextPage: false,
+ hasNextPage: true,
+ error: null as Error | null,
+ data: {
+ pages: [
+ { items: [] as EmailReminderSummary[], nextCursor: 'continue' },
+ ],
+ },
+ fetchNextPage: vi.fn(async () => {}),
+ refetch: vi.fn(async () => {}),
+ });
+ const [hydration, setHydration] = createStore({
+ isPending: false,
+ isPlaceholderData: false,
+ isFetching: false,
+ data: { entities: [] as EmailEntity[] } as
+ | { entities: EmailEntity[] }
+ | undefined,
+ error: null as Error | null,
+ refresh: vi.fn(async () => {}),
+ });
+ const [laterHydration, setLaterHydration] = createStore({
+ isPending: true,
+ isPlaceholderData: false,
+ isFetching: true,
+ data: undefined as { entities: EmailEntity[] } | undefined,
+ error: null as Error | null,
+ refresh: vi.fn(async () => {}),
+ });
+ mocks.collection.mockReturnValue(collection);
+ mocks.hydration
+ .mockReturnValueOnce(hydration)
+ .mockReturnValue(laterHydration);
+ const [flag, setFlag] = createStore({ enabled: true, loading: false });
+ mocks.flag.mockImplementation(() => flag);
+ const source = useReminderEmailSource(state, {
+ tagSets: () => [],
+ tagSetsReady: () => true,
+ });
+ mocks.view.mockReturnValue({ source, openThread: mocks.open });
+ const navigation = useEmailDetailListNavigation(() => 'first');
+ return {
+ source,
+ setFlag,
+ navigation,
+ setState,
+ collection,
+ setCollection,
+ setHydration,
+ laterHydration,
+ setLaterHydration,
+ };
+ });
+}
+function email(id: string): EmailEntity {
+ return {
+ type: 'email',
+ id,
+ name: id,
+ ownerId: 'alice',
+ linkId: 'selected-inbox',
+ isRead: false,
+ isDraft: false,
+ isImportant: true,
+ done: false,
+ };
+}
+
+function item(
+ threadId: string,
+ count = 1,
+ reminderId = `${threadId}-reminder`
+): EmailReminderSummary {
+ return {
+ threadId,
+ count,
+ nearest: {
+ reminder: {
+ id: reminderId,
+ entityId: threadId,
+ entityType: 'email_thread',
+ description: 'Follow up',
+ enabled: true,
+ nextRunAt: '2026-10-05T12:00:00Z',
+ createdAt: '2026-10-01T12:00:00Z',
+ updatedAt: '2026-10-01T12:00:00Z',
+ schedule: { type: 'once', remindAt: '2026-10-05T12:00:00Z' },
+ },
+ },
+ };
+}
+
+it('uses collection clock metadata only for hydrated rows and clears it outside the tab', () => {
+ const { source, setCollection, setHydration, setState } = mount();
+ setCollection('data', 'pages', [
+ { items: [item('first', 2), item('revoked')], nextCursor: '' },
+ ]);
+ setHydration('data', 'entities', [email('first')]);
+ expect(source.reminderForThread?.('first')).toMatchObject({
+ count: 2,
+ nearest: { id: 'first-reminder' },
+ });
+ expect(source.reminderForThread?.('revoked')).toBeUndefined();
+ setCollection('data', 'pages', [
+ { items: [item('first', 1, 'replacement')], nextCursor: '' },
+ ]);
+ expect(source.reminderForThread?.('first')).toMatchObject({
+ count: 1,
+ nearest: { id: 'replacement' },
+ });
+ setState('tab', 'all');
+ expect(source.reminderForThread?.('first')).toBeUndefined();
+});
+
+it('follows an empty budget-limited continuation without reporting an empty collection', async () => {
+ const { source, collection } = mount();
+ expect(source.items().map((row) => row.kind)).toEqual(['load-more']);
+ expect(source.hasMore()).toBe(true);
+ await source.loadMore();
+ expect(collection.fetchNextPage).toHaveBeenCalledOnce();
+ const options = mocks.collection.mock.calls[0][0]();
+ expect(options.filters).not.toHaveProperty('search');
+ expect(options.filters.inboxIds).toEqual(['selected-inbox']);
+});
+
+it('intersects authorized IDs with native hydration and restores schedule order', () => {
+ const { source, setCollection, setHydration } = mount();
+ setCollection('data', 'pages', [
+ {
+ items: [item('older'), item('newer'), item('revoked')],
+ nextCursor: 'continue',
+ },
+ ]);
+ setHydration('data', 'entities', [
+ email('newer'),
+ email('older'),
+ email('unrelated'),
+ ]);
+ expect(
+ source
+ .items()
+ .flatMap((row) => (row.kind === 'entity' ? [row.entity.id] : []))
+ ).toEqual(['older', 'newer']);
+ setCollection('error', new Error('Background failed'));
+ expect(source.error()).toBeUndefined();
+ expect(source.items().filter((row) => row.kind === 'entity')).toHaveLength(2);
+});
+
+it('surfaces initial hydration failures for retry without fabricating preview rows', () => {
+ const { source, setCollection, setHydration } = mount();
+ setCollection('data', 'pages', [
+ { items: [item('email')], nextCursor: 'continue' },
+ ]);
+ setHydration({ data: undefined, error: new Error('Retry hydration') });
+ expect(source.error()).toEqual(new Error('Retry hydration'));
+ expect(source.items().filter((row) => row.kind === 'entity')).toEqual([]);
+});
+vi.mock('@notifications', async () => await import('@notifications/types'));
+vi.mock('@service-storage/websocket', () => ({
+ storageWS: { reconnectIfDisconnected: vi.fn() },
+ createWebSocketJob: vi.fn(),
+}));
+vi.mock('@service-connection/websocket', () => ({
+ ws: { addEventListener: vi.fn(), send: vi.fn() },
+ state: () => 'closed',
+ createConnectionBlockWebsocketEffect: vi.fn(),
+ createConnectionWebsocketEffect: vi.fn(),
+}));
+
+it('shares the in-flight final-page wait until native hydration publishes the next email', async () => {
+ const {
+ source,
+ navigation,
+ collection,
+ setCollection,
+ setHydration,
+ setLaterHydration,
+ } = mount();
+ setCollection('data', 'pages', [
+ { items: [item('first')], nextCursor: 'last' },
+ ]);
+ setHydration('data', { entities: [email('first')] });
+ let release!: () => void;
+ collection.fetchNextPage.mockImplementationOnce(
+ () =>
+ new Promise<void>((resolve) => {
+ release = () => {
+ setCollection({
+ hasNextPage: false,
+ isFetchingNextPage: false,
+ data: {
+ pages: [
+ { items: [item('first')], nextCursor: 'last' },
+ { items: [item('last')], nextCursor: '' },
+ ],
+ },
+ });
+ resolve();
+ };
+ })
+ );
+ const first = source.loadMore();
+ const nextEmail = navigation.afterReminderSaved?.();
+ const concurrent = source.loadMore();
+ expect(concurrent).toBe(first);
+ let settled = false;
+ void first.then(() => {
+ settled = true;
+ });
+ await Promise.resolve();
+ release();
+ await Promise.resolve();
+ await Promise.resolve();
+ expect(settled).toBe(false);
+ expect(mocks.open).not.toHaveBeenCalled();
+ expect(source.isLoadingMore()).toBe(true);
+ expect(source.hasMore()).toBe(true);
+ expect(source.items().filter((row) => row.kind === 'entity')).toHaveLength(1);
+ setLaterHydration({
+ isPending: false,
+ isFetching: false,
+ data: { entities: [email('last')] },
+ });
+ await first;
+ await nextEmail;
+ expect(mocks.open).toHaveBeenCalledWith({ id: 'last', fallbackName: 'last' });
+ expect(
+ source
+ .items()
+ .flatMap((row) => (row.kind === 'entity' ? [row.entity.id] : []))
+ ).toEqual(['first', 'last']);
+ expect(source.hasMore()).toBe(false);
+ expect(collection.fetchNextPage).toHaveBeenCalledOnce();
+});
+
+it('retains earlier rows and retries failed final-page hydration without fetching past it', async () => {
+ const {
+ source,
+ collection,
+ setCollection,
+ setHydration,
+ laterHydration,
+ setLaterHydration,
+ } = mount();
+ setCollection({
+ hasNextPage: false,
+ data: {
+ pages: [
+ { items: [item('first')], nextCursor: 'last' },
+ { items: [item('last')], nextCursor: '' },
+ ],
+ },
+ });
+ setHydration('data', { entities: [email('first')] });
+ setLaterHydration({
+ isPending: false,
+ isFetching: false,
+ error: new Error('Native page failed'),
+ });
+ expect(source.error()).toEqual(new Error('Native page failed'));
+ expect(source.items().map((row) => row.kind)).toEqual([
+ 'entity',
+ 'load-more',
+ ]);
+ expect(source.hasMore()).toBe(true);
+ laterHydration.refresh.mockImplementationOnce(async () => {
+ setLaterHydration({ error: null, data: { entities: [email('last')] } });
+ });
+ await source.loadMore();
+ expect(laterHydration.refresh).toHaveBeenCalledOnce();
+ expect(collection.fetchNextPage).not.toHaveBeenCalled();
+ expect(source.error()).toBeUndefined();
+ expect(source.items().map((row) => row.kind)).toEqual(['entity', 'entity']);
+ setLaterHydration('error', new Error('Background failure with cached rows'));
+ expect(source.error()).toBeUndefined();
+});
+
+it('rejects a pending navigation wait when the selected inbox changes', async () => {
+ const { source, setCollection, setState, setHydration } = mount();
+ setCollection('data', 'pages', [
+ { items: [item('first')], nextCursor: 'next' },
+ ]);
+ setHydration({ isPending: true, data: undefined });
+ const pending = source.loadMore();
+ await Promise.resolve();
+ setState('inboxIds', ['another-inbox']);
+ await expect(pending).rejects.toThrow('Email view changed');
+});
+
+it('reconciles live non-read facets and refills while keeping read admission stable', async () => {
+ const { source, collection, setCollection, setState, setHydration } = mount();
+ setState('facets', { done: ['not-done'], read: ['unread'] });
+ setCollection('data', 'pages', [
+ { items: [item('first')], nextCursor: 'next' },
+ ]);
+ setHydration('data', { entities: [email('first')] });
+ expect(source.items().filter((row) => row.kind === 'entity')).toHaveLength(1);
+ setHydration('data', { entities: [{ ...email('first'), isRead: true }] });
+ expect(source.items().filter((row) => row.kind === 'entity')).toHaveLength(1);
+ collection.refetch.mockClear();
+ setHydration('data', { entities: [{ ...email('first'), done: true }] });
+ expect(source.items().filter((row) => row.kind === 'entity')).toHaveLength(0);
+ await Promise.resolve();
+ expect(collection.refetch).toHaveBeenCalledOnce();
+});
+
+it('keeps a restored Reminders view loading until the feature flag resolves', () => {
+ const { source, setFlag } = mount();
+ const options = mocks.collection.mock.calls[0][0];
+ setFlag({ enabled: false, loading: true });
+ expect(source.isLoading()).toBe(true);
+ expect(options().enabled).toBe(false);
+ setFlag({ enabled: true, loading: false });
+ expect(source.isLoading()).toBe(false);
+ expect(options().enabled).toBe(true);
+});
diff --git a/apps/web/src/features/email-view/queries/use-reminder-email-source.ts b/apps/web/src/features/email-view/queries/use-reminder-email-source.ts
new file mode 100644
index 0000000000..7347083a2c
--- /dev/null
+++ b/apps/web/src/features/email-view/queries/use-reminder-email-source.ts
@@ -0,0 +1,304 @@
+import type { EmailRowReminder } from '@app/features/reminders/core/email-row-reminder';
+import {
+ buildFlatSoupRows,
+ createSoupLoadMoreRow,
+ createSoupRowStore,
+ createTagFacetContext,
+ tagFacetReady,
+ testFacets,
+} from '@app/features/soup';
+import { withEntityNotifications } from '@app/features/soup/entity-notifications';
+import { useFeatureFlag } from '@app/lib/analytics/posthog';
+import { useGlobalNotificationSource } from '@components/app/GlobalAppState';
+import { enableReminders } from '@core/constant/featureFlags';
+import { useUserId } from '@core/context/user';
+import { type EmailEntity, isEmailEntity } from '@entity';
+import { queryReadyGate } from '@queries/gate';
+import { collectionReminderEntity } from '@queries/reminders/collection';
+import { useEmailReminderCollection } from '@queries/reminders/email-collection';
+import { useSoupAstItemsQuery } from '@queries/soup/items';
+import type { ListEmailRemindersParams } from '@service-storage/generated/schemas/listEmailRemindersParams';
+import {
+ createComputed,
+ createEffect,
+ createMemo,
+ createRoot,
+ createSignal,
+ indexArray,
+ onCleanup,
+ untrack,
+} from 'solid-js';
+import { EMAIL_FACETS } from '../filters/email-facets';
+import { buildEmailQuery } from './email-query';
+import type {
+ EmailDataSource,
+ EmailDataSourceInput,
+ EmailDataSourceItem,
+ UseEmailDataSourceOptions,
+} from './use-email-query';
+
+/** Original email rows in reminder order, with membership and facets owned by the server. */
+export function useReminderEmailSource(
+ state: EmailDataSourceInput,
+ options: UseEmailDataSourceOptions
+): EmailDataSource {
+ const userId = useUserId();
+ const enabled = useFeatureFlag(enableReminders);
+ const notificationSource = useGlobalNotificationSource();
+ const tagContext = createMemo(() => createTagFacetContext(options.tagSets()));
+ const ready = () => tagFacetReady(state.facets, options.tagSetsReady());
+ const active = () =>
+ state.tab === 'reminders' && enabled().enabled && ready();
+ const filters = createMemo(
+ (): ListEmailRemindersParams => ({
+ inboxIds: state.inboxIds,
+ noInboxes: state.inboxIds?.length === 0,
+ done:
+ state.facets.done?.length === 1
+ ? state.facets.done[0] === 'done'
+ : undefined,
+ read:
+ state.facets.read?.length === 1
+ ? state.facets.read[0] === 'read'
+ : undefined,
+ calendar: state.facets.calendar?.includes('has-calendar-invite'),
+ tags: (state.facets.tags ?? [])
+ .flatMap((id) => {
+ const property = tagContext().tagPropertyDefinitionByOptionId.get(id);
+ return property ? [`${property}:${id}`] : [];
+ })
+ .sort(),
+ attachments: (state.facets.attachments ?? [])
+ .map((id) => id.replace('attachment-', ''))
+ .sort(),
+ })
+ );
+ const collection = useEmailReminderCollection(() => ({
+ userId: userId(),
+ enabled: active(),
+ filters: filters(),
+ }));
+ const pages = createMemo(() =>
+ queryReadyGate(collection) ? collection.data.pages : []
+ );
+ const hydration = indexArray(pages, (page) => {
+ const ids = () => page().items.map((item) => item.threadId);
+ return useSoupAstItemsQuery(
+ () =>
+ buildEmailQuery(
+ {
+ tab: 'reminders',
+ inboxIds: state.inboxIds,
+ facets: state.facets,
+ facetContext: tagContext(),
+ },
+ ids()
+ ),
+ () => ({ enabled: active() && ids().length > 0, keepPreviousData: false })
+ );
+ });
+ const scope = createMemo(() =>
+ JSON.stringify([userId(), active(), filters()])
+ );
+ const [disposed, setDisposed] = createSignal(false);
+ onCleanup(() => setDisposed(true));
+ const usable = (query: ReturnType<typeof useSoupAstItemsQuery>) =>
+ queryReadyGate(query) && !query.isPlaceholderData;
+ const pending = () =>
+ hydration().some(
+ (query, index) =>
+ pages()[index].items.length > 0 && !usable(query) && !query.error
+ );
+ const failed = () =>
+ hydration().filter(
+ (query, index) =>
+ pages()[index].items.length > 0 && !usable(query) && query.error
+ );
+ const matches = (email: EmailEntity) =>
+ testFacets(
+ { ...state.facets, read: [] },
+ EMAIL_FACETS,
+ email,
+ tagContext()
+ );
+ const entities = createMemo(() => {
+ const byId = new Map(
+ hydration().flatMap((query) =>
+ usable(query)
+ ? query
+ .data!.entities.filter(isEmailEntity)
+ .filter(matches)
+ .map((entity) => [entity.id, entity] as const)
+ : []
+ )
+ );
+ const seen = new Set<string>();
+ return pages().flatMap((page) =>
+ page.items.flatMap((item) => {
+ const email = byId.get(item.threadId);
+ if (!email || seen.has(email.id)) return [];
+ seen.add(email.id);
+ return [withEntityNotifications(email, notificationSource)];
+ })
+ );
+ });
+ const reminders = createMemo<Map<string, EmailRowReminder>>(() => {
+ if (!active()) return new Map();
+ const visibleIds = new Set(entities().map((email) => email.id));
+ return new Map(
+ pages().flatMap((page) =>
+ page.items
+ .filter((item) => visibleIds.has(item.threadId))
+ .map(
+ (item) =>
+ [
+ item.threadId,
+ {
+ nearest: collectionReminderEntity(item.nearest),
+ count: item.count,
+ },
+ ] as const
+ )
+ )
+ );
+ });
+ const [loadingMore, setLoadingMore] = createSignal(false);
+ const [loadError, setLoadError] = createSignal<Error>();
+ const error = () =>
+ failed()[0]?.error ??
+ loadError() ??
+ (entities().length === 0 ? (collection.error ?? undefined) : undefined);
+ const hasMore = () =>
+ Boolean(
+ collection.hasNextPage || loadingMore() || pending() || failed().length
+ );
+ const built = createMemo((): EmailDataSourceItem[] => {
+ const rows: EmailDataSourceItem[] = buildFlatSoupRows(entities());
+ // A sparse page or an unhydrated final page still has reachable work.
+ if (hasMore())
+ rows.push(
+ createSoupLoadMoreRow({
+ scopeId: 'email:reminders',
+ label: error() ? 'Couldn’t load more email. Try again' : 'Load More',
+ isLoading:
+ loadingMore() || collection.isFetchingNextPage || pending(),
+ })
+ );
+ return rows;
+ });
+ const items = createSoupRowStore(built);
+
+ // Every caller waits for the same operation, including native row publication.
+ // Returning a resolved no-op while a fetch is pending makes detail navigation
+ // spin its hasMore loop and can starve the network task itself.
+ let inFlight: Promise<void> | undefined;
+ const waitForHydration = (requestScope: string) =>
+ new Promise<void>((resolve, reject) => {
+ createRoot((dispose) => {
+ createComputed(() => {
+ if (disposed() || scope() !== requestScope) {
+ dispose();
+ reject(new Error('Email view changed while loading'));
+ } else if (!collection.isFetchingNextPage && !pending()) {
+ items();
+ dispose();
+ resolve();
+ }
+ });
+ });
+ });
+ const loadMore = (): Promise<void> => {
+ if (inFlight) return inFlight;
+ const requestScope = scope();
+ setLoadingMore(true);
+ setLoadError(undefined);
+ inFlight = Promise.resolve()
+ .then(async () => {
+ const retries = failed();
+ if (retries.length) {
+ await Promise.all(retries.map((query) => query.refresh()));
+ } else if (
+ !pending() &&
+ collection.hasNextPage &&
+ !collection.isFetchingNextPage
+ ) {
+ const result = await collection.fetchNextPage();
+ if (result?.error) setLoadError(result.error);
+ }
+ await waitForHydration(requestScope);
+ })
+ .catch((cause) => {
+ if (scope() !== requestScope || disposed()) throw cause;
+ setLoadError(
+ cause instanceof Error ? cause : new Error('Email couldn’t be loaded')
+ );
+ })
+ .finally(() => {
+ inFlight = undefined;
+ setLoadingMore(false);
+ });
+ return inFlight;
+ };
+
+ // Optimistic archive/tag changes must remove stale membership immediately.
+ // Refill from the authoritative collection once per changed membership, not
+ // from an unfiltered native page. Read changes intentionally retain admission.
+ let reconciled = '';
+ createEffect(() => {
+ const currentScope = scope();
+ // An intermediate fetch is not evidence that a mismatch disappeared.
+ // Retain the reconciliation signature while any admitted page refreshes.
+ if (
+ hydration().some(
+ (query, index) =>
+ pages()[index].items.length > 0 &&
+ (!usable(query) || query.isFetching)
+ )
+ )
+ return;
+ const missing = hydration().flatMap((query, index) => {
+ if (!usable(query) || query.isFetching) return [];
+ const ids = new Set(
+ query
+ .data!.entities.filter(isEmailEntity)
+ .filter(matches)
+ .map((email) => email.id)
+ );
+ return pages()
+ [index].items.filter((item) => !ids.has(item.threadId))
+ .map((item) => item.threadId);
+ });
+ const signature = JSON.stringify([currentScope, missing]);
+ if (signature === reconciled) return;
+ reconciled = signature;
+ if (missing.length && active()) untrack(() => void collection.refetch());
+ });
+ createEffect(() => {
+ scope();
+ setLoadError(undefined);
+ });
+
+ return {
+ reminderForThread: (threadId) => reminders().get(threadId),
+ items,
+ isLoading: () =>
+ (state.tab === 'reminders' && enabled().loading) ||
+ !ready() ||
+ collection.isLoading ||
+ (entities().length === 0 && pending()),
+ isFetching: () =>
+ collection.isFetching || hydration().some((query) => query.isFetching),
+ error,
+ hasMore,
+ isLoadingMore: () =>
+ loadingMore() || collection.isFetchingNextPage || pending(),
+ loadMore,
+ refresh: async () => {
+ setLoadError(undefined);
+ await Promise.all([
+ collection.refetch(),
+ ...hydration().map((query) => query.refresh()),
+ ]);
+ },
+ };
+}
diff --git a/apps/web/src/features/email-view/types.ts b/apps/web/src/features/email-view/types.ts
index 63d41f918f..285fa4ce17 100644
--- a/apps/web/src/features/email-view/types.ts
+++ b/apps/web/src/features/email-view/types.ts
@@ -10,6 +10,7 @@ export type EmailTab =
| 'favorites'
| 'sent'
| 'scheduled'
+ | 'reminders'
| 'calendar'
| 'drafts'
| 'shared'
diff --git a/apps/web/src/features/entity/composed/ListEntity.tsx b/apps/web/src/features/entity/composed/ListEntity.tsx
index fa2560bb10..793a9ada00 100644
--- a/apps/web/src/features/entity/composed/ListEntity.tsx
+++ b/apps/web/src/features/entity/composed/ListEntity.tsx
@@ -73,6 +73,8 @@ export {
interface ListEntityProps extends BaseListEntityProps {
showUnrollNotifications?: boolean;
+ /** Collection-owned schedule metadata for the original entity row. */
+ scheduleStatus?: JSX.Element;
}
export function MaybeEntityRow(props: {
@@ -102,14 +104,17 @@ export function ListEntity(props: ListEntityProps) {
const rowActions = children(() => props.actions);
const leadingAction = children(() => props.leadingAction);
const scheduleStatus = children(() => (
- <Show when={isReminderEntity(props.entity) && props.entity}>
- {(entity) => (
- <ReminderRowSchedule
- entity={entity()}
- onToggleDone={props.onToggleReminderDone}
- />
- )}
- </Show>
+ <>
+ {props.scheduleStatus}
+ <Show when={isReminderEntity(props.entity) && props.entity}>
+ {(entity) => (
+ <ReminderRowSchedule
+ entity={entity()}
+ onToggleDone={props.onToggleReminderDone}
+ />
+ )}
+ </Show>
+ </>
));
const unread = () => unreadFilterFn(props.entity);
diff --git a/apps/web/src/features/next-soup/actions/make-mark-done-action.test.ts b/apps/web/src/features/next-soup/actions/make-mark-done-action.test.ts
index ecccda1779..731ec5df79 100644
--- a/apps/web/src/features/next-soup/actions/make-mark-done-action.test.ts
+++ b/apps/web/src/features/next-soup/actions/make-mark-done-action.test.ts
@@ -583,3 +583,8 @@ describe('makeMarkDoneAction', () => {
dispose();
});
});
+
+it('keeps original Email Reminders rows eligible for the email archive action', async () => {
+ const { canExecuteMarkDoneOnView } = await import('./make-mark-done-action');
+ expect(canExecuteMarkDoneOnView('mail', 'reminders')).toBe(true);
+});
diff --git a/apps/web/src/features/next-soup/actions/make-mark-done-action.ts b/apps/web/src/features/next-soup/actions/make-mark-done-action.ts
index e91d0d43a7..6785925268 100644
--- a/apps/web/src/features/next-soup/actions/make-mark-done-action.ts
+++ b/apps/web/src/features/next-soup/actions/make-mark-done-action.ts
@@ -36,6 +36,8 @@ const VALID_MARK_DONE_LIST_VIEWS: `${ListView}-${string}`[] = [
'home-reminders',
'mail-important',
'mail-all',
+ // These are original email rows; Done remains email archive, not reminder completion.
+ 'mail-reminders',
'mail-noise',
'mail-favorites',
// Calendar lists invite threads from the "all" email view, so done rows
diff --git a/apps/web/src/features/reminders/ReminderEditorSplit.lifecycle.test.tsx b/apps/web/src/features/reminders/ReminderEditorSplit.lifecycle.test.tsx
index df6c852b70..a48c172b3e 100644
--- a/apps/web/src/features/reminders/ReminderEditorSplit.lifecycle.test.tsx
+++ b/apps/web/src/features/reminders/ReminderEditorSplit.lifecycle.test.tsx
@@ -106,3 +106,31 @@ it('keeps a same-reminder draft but resets controller state for cached A-to-B na
expect((nextTitle as HTMLInputElement).value).toBe('Reminder B');
expect(state.mutationInstances).toBe(2);
});
+
+vi.mock('./views/email-reminder-details', () => ({
+ EmailReminderDetails: () => {
+ throw new Error(
+ 'Mailbox-only lookup must not run for a known generic reminder'
+ );
+ },
+}));
+
+it('opens a known generic Shared email reminder without mailbox follow-up access', () => {
+ const shared = {
+ ...reminder('shared-generic', 'Private shared reminder'),
+ entityType: 'email_thread',
+ entityId: 'shared-thread',
+ } as Reminder;
+ state.queryFor = () => shared;
+ const view = render(() => (
+ <ReminderDetails
+ reminderId="shared-generic"
+ isEmailFollowup={false}
+ onClose={() => {}}
+ />
+ ));
+ expect(
+ (view.getByPlaceholderText('Reminder description') as HTMLInputElement)
+ .value
+ ).toBe('Private shared reminder');
+});
diff --git a/apps/web/src/features/reminders/ReminderEditorSplit.tsx b/apps/web/src/features/reminders/ReminderEditorSplit.tsx
index 63863853a6..175ca28c24 100644
--- a/apps/web/src/features/reminders/ReminderEditorSplit.tsx
+++ b/apps/web/src/features/reminders/ReminderEditorSplit.tsx
@@ -331,6 +331,7 @@ function EmailDetailsGate(props: {
return (
<Show
when={
+ props.isEmailFollowup !== false &&
props.reminder.entityType === 'email_thread'
? props.reminder.entityId
: undefined
diff --git a/apps/web/src/features/reminders/core/email-row-reminder.ts b/apps/web/src/features/reminders/core/email-row-reminder.ts
new file mode 100644
index 0000000000..ed4b5613d4
--- /dev/null
+++ b/apps/web/src/features/reminders/core/email-row-reminder.ts
@@ -0,0 +1,3 @@
+import type { ReminderEntity } from '@entity';
+
+export type EmailRowReminder = { nearest: ReminderEntity; count: number };
diff --git a/apps/web/src/features/reminders/core/row-schedule.test.ts b/apps/web/src/features/reminders/core/row-schedule.test.ts
index 9d2a2f1697..15a07584c2 100644
--- a/apps/web/src/features/reminders/core/row-schedule.test.ts
+++ b/apps/web/src/features/reminders/core/row-schedule.test.ts
@@ -1,6 +1,10 @@
import type { ReminderEntity } from '@entity';
import { describe, expect, it } from 'vitest';
-import { reminderScheduleLabel, reminderScheduleState } from './row-schedule';
+import {
+ emailReminderScheduleLabel,
+ reminderScheduleLabel,
+ reminderScheduleState,
+} from './row-schedule';
const now = Date.parse('2026-10-01T12:00:00Z');
const reminder: ReminderEntity = {
@@ -108,3 +112,36 @@ it('omits the zone for a local schedule and retains a different year', () => {
expect(label).toContain('2027');
expect(label).not.toContain('UTC');
});
+
+describe('email workflow clock labels', () => {
+ it.each([
+ ['archiving', 'Scheduling return:', true],
+ ['pending', 'Returning:', true],
+ ['returning', 'Returning to inbox:', false],
+ ['returned', 'Returned:', false],
+ ] as const)(
+ 'labels %s honestly even while disabled',
+ (state, prefix, conditional) => {
+ const label = emailReminderScheduleLabel(
+ {
+ ...reminder,
+ enabled: false,
+ emailFollowup: {
+ state,
+ condition: 'if_no_reply',
+ linkId: 'link',
+ threadId: 'thread',
+ revision: 'revision',
+ reminderId: reminder.id,
+ remindAt: '2026-10-02T13:00:00Z',
+ },
+ },
+ now,
+ 'UTC'
+ );
+ expect(label.startsWith(prefix)).toBe(true);
+ expect(label.includes('if no reply')).toBe(conditional);
+ expect(label).not.toContain('Paused');
+ }
+ );
+});
diff --git a/apps/web/src/features/reminders/core/row-schedule.ts b/apps/web/src/features/reminders/core/row-schedule.ts
index f3946d505c..278e91397d 100644
--- a/apps/web/src/features/reminders/core/row-schedule.ts
+++ b/apps/web/src/features/reminders/core/row-schedule.ts
@@ -66,3 +66,32 @@ export function reminderScheduleLabel(
.filter(Boolean)
.join(' · ');
}
+
+/** Workflow progress is independent of its generic reminder's enabled flag. */
+export function emailReminderScheduleLabel(
+ reminder: ReminderEntity,
+ now: number,
+ viewerTimezone = Intl.DateTimeFormat().resolvedOptions().timeZone
+): string {
+ const followup = reminder.emailFollowup;
+ if (!followup) return reminderScheduleLabel(reminder, now, viewerTimezone);
+ const instant = formatReminderOccurrence(
+ reminder.nextRunAt,
+ viewerTimezone,
+ viewerTimezone
+ );
+ if (!instant) return 'Schedule unavailable';
+ const status = {
+ archiving: 'Scheduling return',
+ pending:
+ new Date(reminder.nextRunAt).getTime() <= now ? 'Due' : 'Returning',
+ returning: 'Returning to inbox',
+ returned: 'Returned',
+ cancelled: 'Cancelled',
+ removed: 'Removed',
+ }[followup.state];
+ const conditional =
+ followup.condition === 'if_no_reply' &&
+ (followup.state === 'pending' || followup.state === 'archiving');
+ return `${status}: ${instant}${conditional ? ' if no reply' : ''}`;
+}
diff --git a/apps/web/src/features/reminders/views/email-row-schedule.test.tsx b/apps/web/src/features/reminders/views/email-row-schedule.test.tsx
new file mode 100644
index 0000000000..84033394d2
--- /dev/null
+++ b/apps/web/src/features/reminders/views/email-row-schedule.test.tsx
@@ -0,0 +1,134 @@
+import type { ReminderEntity } from '@entity';
+import {
+ cleanup,
+ fireEvent,
+ render,
+ screen,
+ waitFor,
+} from '@solidjs/testing-library';
+import { createSignal, type JSX, type ParentProps, Show } from 'solid-js';
+import { Portal } from 'solid-js/web';
+import { afterEach, expect, it, vi } from 'vitest';
+import { EmailRowSchedule } from './email-row-schedule';
+
+vi.mock('@ui', async (importOriginal) => {
+ const { cn } = await importOriginal<typeof import('@ui')>();
+ const Container = (props: ParentProps) => <>{props.children}</>;
+ return {
+ cn,
+ Button: (
+ props: JSX.ButtonHTMLAttributes<HTMLButtonElement> & { label?: string }
+ ) => <button {...props} aria-label={props['aria-label'] ?? props.label} />,
+ Tooltip: Container,
+ Dialog: (props: ParentProps<{ open: boolean }>) => (
+ <Portal>{props.open && props.children}</Portal>
+ ),
+ ActionDialogShell: Object.assign(Container, {
+ Header: Container,
+ Title: Container,
+ }),
+ };
+});
+vi.mock('../ReminderEditorSplit', () => ({
+ ReminderDetails: (props: {
+ reminderId: string;
+ isEmailFollowup: boolean;
+ onClose: () => void;
+ }) => (
+ <Show when={props.reminderId} keyed>
+ {(id) => (
+ <div data-editor-id={id} data-editor-email={props.isEmailFollowup}>
+ <input aria-label="Unsaved note" value={id} />
+ <button onClick={props.onClose}>Cancel</button>
+ </div>
+ )}
+ </Show>
+ ),
+}));
+vi.mock('../primitives/reminder-clock', () => ({
+ useReminderClock: () => () => Date.parse('2026-10-01T12:00:00Z'),
+}));
+afterEach(cleanup);
+
+it('keeps the email row and its completion independent from the clock editor', async () => {
+ const openThread = vi.fn();
+ const rowKey = vi.fn();
+ const nearest: ReminderEntity = {
+ type: 'reminder',
+ id: 'r',
+ name: 'Reply',
+ description: 'Reply',
+ ownerId: 'owner',
+ enabled: true,
+ scheduleType: 'once',
+ nextRunAt: '2026-10-02T12:00:00Z',
+ };
+ render(() => (
+ <div onClick={openThread} onKeyDown={rowKey}>
+ <EmailRowSchedule reminder={{ nearest, count: 3 }} />
+ </div>
+ ));
+ const clock = screen.getByRole('button', {
+ name: /Remind me:.*2 more reminders/,
+ });
+ expect(clock.tagName).toBe('BUTTON');
+ expect(screen.queryByRole('button', { name: /Mark.*done/ })).toBeNull();
+ fireEvent.keyDown(clock, { key: 'Enter' });
+ expect(rowKey).not.toHaveBeenCalled();
+ fireEvent.pointerDown(clock);
+ fireEvent.click(clock);
+ expect(openThread).not.toHaveBeenCalled();
+ fireEvent.click(screen.getByRole('button', { name: 'Cancel' }));
+ await waitFor(() =>
+ expect(screen.queryByRole('button', { name: 'Cancel' })).toBeNull()
+ );
+ expect(openThread).not.toHaveBeenCalled();
+});
+
+it('pins the editing target and unsaved draft through same-ID and nearest A-to-B summary refreshes', () => {
+ const first: ReminderEntity = {
+ type: 'reminder',
+ id: 'A',
+ name: 'A',
+ description: 'A',
+ ownerId: 'owner',
+ enabled: true,
+ scheduleType: 'once',
+ nextRunAt: '2026-10-02T12:00:00Z',
+ };
+ const [nearest, setNearest] = createSignal(first);
+ render(() => (
+ <EmailRowSchedule reminder={{ nearest: nearest(), count: 2 }} />
+ ));
+ fireEvent.click(screen.getByRole('button', { name: /Remind me:/ }));
+ const note = screen.getByRole('textbox', {
+ name: 'Unsaved note',
+ }) as HTMLInputElement;
+ fireEvent.input(note, { target: { value: 'Keep my draft' } });
+ setNearest({ ...first, nextRunAt: '2026-10-03T12:00:00Z' });
+ expect(screen.getByRole('textbox', { name: 'Unsaved note' })).toBe(note);
+ expect(note.value).toBe('Keep my draft');
+ setNearest({
+ ...first,
+ id: 'B',
+ emailFollowup: {
+ state: 'pending',
+ condition: 'if_no_reply',
+ threadId: 'thread',
+ reminderId: 'B',
+ revision: 'revision',
+ linkId: 'inbox',
+ remindAt: '2026-10-02T12:00:00Z',
+ },
+ });
+ expect(document.querySelector('[data-editor-id="A"]')).toBeTruthy();
+ expect(document.querySelector('[data-editor-id="B"]')).toBeNull();
+ expect(document.querySelector('[data-editor-email="false"]')).toBeTruthy();
+ expect(screen.getByRole('textbox', { name: 'Unsaved note' })).toBe(note);
+ expect(note.value).toBe('Keep my draft');
+ fireEvent.click(screen.getByRole('button', { name: 'Cancel' }));
+ fireEvent.click(screen.getByRole('button', { name: /Returning:/ }));
+ expect(
+ document.querySelector('[data-editor-id="B"][data-editor-email="true"]')
+ ).toBeTruthy();
+});
diff --git a/apps/web/src/features/reminders/views/email-row-schedule.tsx b/apps/web/src/features/reminders/views/email-row-schedule.tsx
new file mode 100644
index 0000000000..1561dd54a4
--- /dev/null
+++ b/apps/web/src/features/reminders/views/email-row-schedule.tsx
@@ -0,0 +1,86 @@
+import { ActionDialogShell, Dialog } from '@ui';
+import { createSignal, Show, Suspense } from 'solid-js';
+import { ReminderScheduleIndicator } from '../components/reminder-schedule-indicator';
+import type { EmailRowReminder } from '../core/email-row-reminder';
+import { emailReminderScheduleLabel } from '../core/row-schedule';
+import { useReminderClock } from '../primitives/reminder-clock';
+import { ReminderDetails } from '../ReminderEditorSplit';
+
+/** The email check remains owned by email. This control edits only its reminder. */
+export function EmailRowSchedule(props: { reminder: EmailRowReminder }) {
+ const now = useReminderClock();
+ const [open, setOpen] = createSignal(false);
+ // Collection polling may choose another nearest reminder while this editor is open.
+ // The activation, not live row metadata, owns this editor session's identity.
+ const [target, setTarget] = createSignal<{
+ id: string;
+ emailFollowup: boolean;
+ }>();
+ let opener: HTMLElement | undefined;
+ const label = () => {
+ const reminder = props.reminder.nearest;
+ const schedule = emailReminderScheduleLabel(reminder, now());
+ return `${schedule}${props.reminder.count > 1 ? ` · ${props.reminder.count - 1} more reminders` : ''}`;
+ };
+ return (
+ <span
+ class="contents"
+ onClick={(e) => e.stopPropagation()}
+ onPointerDown={(e) => e.stopPropagation()}
+ onPointerUp={(e) => e.stopPropagation()}
+ onMouseDown={(e) => e.stopPropagation()}
+ onKeyDown={(e) => {
+ if (e.key === 'Enter' || e.key === ' ') e.stopPropagation();
+ }}
+ >
+ <ReminderScheduleIndicator
+ label={label()}
+ onEdit={() => {
+ opener =
+ document.activeElement instanceof HTMLElement
+ ? document.activeElement
+ : undefined;
+ setTarget({
+ id: props.reminder.nearest.id,
+ emailFollowup: !!props.reminder.nearest.emailFollowup,
+ });
+ setOpen(true);
+ }}
+ />
+ <Show when={props.reminder.count > 1}>
+ <span class="text-xs text-ink-extra-muted" aria-hidden="true">
+ +{props.reminder.count - 1}
+ </span>
+ </Show>
+ <Dialog
+ open={open()}
+ onOpenChange={setOpen}
+ onCloseAutoFocus={(event) => {
+ if (opener?.isConnected) {
+ event.preventDefault();
+ opener.focus();
+ }
+ }}
+ position="center"
+ class="w-[calc(100vw-2rem)] max-w-110"
+ >
+ <ActionDialogShell>
+ <ActionDialogShell.Header class="px-6 pt-5">
+ <ActionDialogShell.Title>Reminder</ActionDialogShell.Title>
+ </ActionDialogShell.Header>
+ <Show when={open() && target()}>
+ {(selected) => (
+ <Suspense fallback={<p role="status">Loading reminder…</p>}>
+ <ReminderDetails
+ reminderId={selected().id}
+ isEmailFollowup={selected().emailFollowup}
+ onClose={() => setOpen(false)}
+ />
+ </Suspense>
+ )}
+ </Show>
+ </ActionDialogShell>
+ </Dialog>
+ </span>
+ );
+}
diff --git a/apps/web/src/lib/queries/email/integration.test.ts b/apps/web/src/lib/queries/email/integration.test.ts
index bb883ddf32..25eaf3cd06 100644
--- a/apps/web/src/lib/queries/email/integration.test.ts
+++ b/apps/web/src/lib/queries/email/integration.test.ts
@@ -7,6 +7,7 @@ const mocks = vi.hoisted(() => ({
archive: vi.fn(),
mutation: vi.fn(),
refresh: vi.fn(),
+ reminders: vi.fn(),
revalidations: vi.fn(() => [] as unknown[]),
}));
vi.mock('@core/constant/featureFlags', () => ({
@@ -20,6 +21,9 @@ vi.mock('@service-storage/client', () => ({ storageServiceClient: {} }));
vi.mock('@service-storage/graphql-soup', () => ({
getGraphqlSoupClient: () => ({ mutation: mocks.mutation }),
}));
+vi.mock('../reminders/email-collection', () => ({
+ invalidateEmailReminderCollection: mocks.reminders,
+}));
vi.mock('../soup/graphql/active-queries', () => ({
refreshActiveGraphqlSoupQueries: mocks.refresh,
getActiveGraphqlSoupRevalidations: mocks.revalidations,
@@ -78,8 +82,10 @@ describe('GraphQL email archive writes', () => {
);
expect(mocks.archive).not.toHaveBeenCalled();
expect(mocks.refresh).not.toHaveBeenCalled();
+ expect(mocks.reminders).not.toHaveBeenCalled();
finish();
await expect(result).resolves.toBe('committed');
+ expect(mocks.reminders).toHaveBeenCalledOnce();
expect(mocks.refresh).toHaveBeenCalledExactlyOnceWith({
target: { kind: 'email-archive', threadId: 'thread' },
});
@@ -138,6 +144,7 @@ describe('GraphQL email archive writes', () => {
}))
);
expect(mocks.refresh).not.toHaveBeenCalled();
+ expect(mocks.reminders).not.toHaveBeenCalled();
});
it.each([
@@ -159,6 +166,7 @@ describe('GraphQL email archive writes', () => {
archiveEmailThread({ id: 'thread', value: true })
).rejects.toThrow();
expect(mocks.refresh).not.toHaveBeenCalled();
+ expect(mocks.reminders).not.toHaveBeenCalled();
expect(mocks.archive).not.toHaveBeenCalled();
}
);
@@ -177,6 +185,7 @@ describe('GraphQL email archive writes', () => {
);
expect(mocks.mutation).not.toHaveBeenCalled();
expect(mocks.refresh).not.toHaveBeenCalled();
+ expect(mocks.reminders).toHaveBeenCalledOnce();
}
);
diff --git a/apps/web/src/lib/queries/email/integration.ts b/apps/web/src/lib/queries/email/integration.ts
index 59dc40cc65..1cc3f9a676 100644
--- a/apps/web/src/lib/queries/email/integration.ts
+++ b/apps/web/src/lib/queries/email/integration.ts
@@ -7,6 +7,7 @@ import { emailClient } from '@service-email/client';
import { storageServiceClient } from '@service-storage/client';
import { setGraphqlEmailThreadArchived } from '@service-storage/graphql-email-archive-state';
import { getGraphqlSoupClient } from '@service-storage/graphql-soup';
+import { invalidateEmailReminderCollection } from '../reminders/email-collection';
import {
getActiveGraphqlSoupRevalidations,
refreshActiveGraphqlSoupQueries,
@@ -36,10 +37,12 @@ export async function archiveEmailThread(
await refreshActiveGraphqlSoupQueries({
target: { kind: 'email-archive', threadId: id },
});
+ void invalidateEmailReminderCollection();
}
return disposition;
}
await throwOnErr(() => emailClient.flagArchived(...args));
+ void invalidateEmailReminderCollection();
return 'committed';
}
export const unscheduleEmailMessage = (
diff --git a/apps/web/src/lib/queries/reminders/email-collection.test.ts b/apps/web/src/lib/queries/reminders/email-collection.test.ts
new file mode 100644
index 0000000000..1f0087553d
--- /dev/null
+++ b/apps/web/src/lib/queries/reminders/email-collection.test.ts
@@ -0,0 +1,39 @@
+import { QueryObserver } from '@tanstack/solid-query';
+import { afterEach, expect, it, vi } from 'vitest';
+import { queryClient } from '../client';
+import { invalidateEmailReminderReads } from './email-collection';
+import { reminderKeys } from './keys';
+import { invalidateRemindersById } from './reminders';
+
+afterEach(() => {
+ queryClient.removeQueries({ queryKey: reminderKeys.emailCollection._def });
+});
+
+it.each(['followup', 'completion'] as const)(
+ 'refetches the collection and its clock metadata after %s changes',
+ async (mutation) => {
+ const readers = [reminderKeys.emailCollection('owner', {}).queryKey].map(
+ (queryKey) => {
+ const queryFn = vi.fn(async () => []);
+ queryClient.setQueryData(queryKey, []);
+ const observer = new QueryObserver(queryClient, {
+ queryKey,
+ queryFn,
+ staleTime: Infinity,
+ });
+ return { queryFn, stop: observer.subscribe(() => {}) };
+ }
+ );
+ try {
+ if (mutation === 'followup') await invalidateEmailReminderReads();
+ else invalidateRemindersById(['completed-reminder']);
+ await vi.waitFor(() =>
+ readers.forEach(({ queryFn }) =>
+ expect(queryFn).toHaveBeenCalledTimes(1)
+ )
+ );
+ } finally {
+ readers.forEach(({ stop }) => stop());
+ }
+ }
+);
diff --git a/apps/web/src/lib/queries/reminders/email-collection.ts b/apps/web/src/lib/queries/reminders/email-collection.ts
new file mode 100644
index 0000000000..89f5e0dead
--- /dev/null
+++ b/apps/web/src/lib/queries/reminders/email-collection.ts
@@ -0,0 +1,47 @@
+import { throwOnErr } from '@core/util/result';
+import { storageServiceClient } from '@service-storage/client';
+import type { EmailReminderPage } from '@service-storage/generated/schemas/emailReminderPage';
+import type { ListEmailRemindersParams } from '@service-storage/generated/schemas/listEmailRemindersParams';
+import { useInfiniteQuery } from '@tanstack/solid-query';
+import type { Accessor } from 'solid-js';
+import { queryClient } from '../client';
+import { reminderKeys } from './keys';
+
+export function useEmailReminderCollection(
+ options: Accessor<{
+ userId: string | undefined;
+ enabled: boolean;
+ filters: ListEmailRemindersParams;
+ }>
+) {
+ return useInfiniteQuery(() => {
+ const { userId, enabled, filters } = options();
+ return {
+ queryKey: reminderKeys.emailCollection(userId, filters).queryKey,
+ enabled: !!userId && enabled,
+ initialPageParam: undefined as string | undefined,
+ queryFn: ({ pageParam }: { pageParam: string | undefined }) =>
+ throwOnErr(() =>
+ storageServiceClient.reminders.listEmailReminders({
+ ...filters,
+ cursor: pageParam,
+ limit: 100,
+ })
+ ),
+ getNextPageParam: (page: EmailReminderPage) =>
+ page.nextCursor ?? undefined,
+ refetchInterval: 30_000,
+ throwOnError: false,
+ };
+ });
+}
+
+/** Refill facet-filtered pages after email mutations commit. */
+export function invalidateEmailReminderCollection() {
+ return queryClient.invalidateQueries({
+ queryKey: reminderKeys.emailCollection._def,
+ });
+}
+
+/** Reminder mutations refresh collection membership and its row clocks together. */
+export const invalidateEmailReminderReads = invalidateEmailReminderCollection;
diff --git a/apps/web/src/lib/queries/reminders/email-followup.ts b/apps/web/src/lib/queries/reminders/email-followup.ts
index d3facd4686..4bf91e6858 100644
--- a/apps/web/src/lib/queries/reminders/email-followup.ts
+++ b/apps/web/src/lib/queries/reminders/email-followup.ts
@@ -13,6 +13,7 @@ import { fetchGraphqlEmailThread } from '../email/graphql/thread';
import { emailKeys } from '../email/keys';
import { refetchSoupEntity } from '../soup/cache';
import { refreshActiveGraphqlSoupQueries } from '../soup/graphql/active-queries';
+import { invalidateEmailReminderReads } from './email-collection';
import { reminderKeys } from './keys';
export function useEmailFollowupQuery(threadId: Accessor<string>) {
@@ -44,6 +45,7 @@ export async function executeEmailFollowup(
}
try {
await Promise.all([
+ invalidateEmailReminderReads(),
refetchSoupEntity(threadId, 'emailThread'),
refetchSoupEntity(result.reminderId, 'reminder'),
queryClient.invalidateQueries({
diff --git a/apps/web/src/lib/queries/reminders/keys.ts b/apps/web/src/lib/queries/reminders/keys.ts
index 2b77b5f543..5fd7697c26 100644
--- a/apps/web/src/lib/queries/reminders/keys.ts
+++ b/apps/web/src/lib/queries/reminders/keys.ts
@@ -1,4 +1,5 @@
import { createQueryKeys } from '@lukemorales/query-key-factory';
+import type { ListEmailRemindersParams } from '@service-storage/generated/schemas/listEmailRemindersParams';
import type { ListRemindersParams } from '@service-storage/generated/schemas/listRemindersParams';
export const reminderKeys = createQueryKeys('reminders', {
@@ -10,6 +11,10 @@ export const reminderKeys = createQueryKeys('reminders', {
/** A single reminder by id. */
detail: (id: string) => [id],
email: (threadId: string) => [threadId],
+ emailCollection: (
+ userId: string | undefined,
+ filters: ListEmailRemindersParams
+ ) => [userId, filters],
collection: (userId: string | undefined, completed?: boolean) => [
userId,
{ completed },
diff --git a/apps/web/src/lib/queries/reminders/reminders.ts b/apps/web/src/lib/queries/reminders/reminders.ts
index 4fccda0036..7916d17fae 100644
--- a/apps/web/src/lib/queries/reminders/reminders.ts
+++ b/apps/web/src/lib/queries/reminders/reminders.ts
@@ -11,6 +11,7 @@ import { useMutation, useQuery } from '@tanstack/solid-query';
import { queryClient } from '../client';
import { type MutationCallbacks, withCallbacks } from '../utils';
import { updateReminderCollection } from './collection';
+import { invalidateEmailReminderReads } from './email-collection';
import { reminderKeys } from './keys';
/** The entity types a reminder can be attached to, as the API names them. */
@@ -120,6 +121,7 @@ export function invalidateRemindersById(
if (ids.length === 0) return;
// A mirror completion also changes its email workflow. Invalidate once per
// batch so a just-opened composer cannot reuse a five-minute-old revision.
+ void invalidateEmailReminderReads();
void queryClient.invalidateQueries({ queryKey: reminderKeys.email._def });
const refetchType = refetch ? undefined : ('none' as const);
for (const query of queryClient.getQueryCache().findAll({
@@ -151,6 +153,7 @@ export function invalidateRemindersById(
/** Invalidate every reminder list, plus one detail when the id is known. */
function invalidateReminders(id?: string) {
+ void invalidateEmailReminderReads();
void queryClient.invalidateQueries({ queryKey: reminderKeys.email._def });
void queryClient.invalidateQueries({
queryKey: reminderKeys.collection._def,
diff --git a/apps/web/src/lib/service-clients/service-storage/client.ts b/apps/web/src/lib/service-clients/service-storage/client.ts
index e7f486cbc6..c015bbb5b9 100644
--- a/apps/web/src/lib/service-clients/service-storage/client.ts
+++ b/apps/web/src/lib/service-clients/service-storage/client.ts
@@ -92,6 +92,7 @@ import type { DocumentTeamShareResponse } from './generated/schemas/documentTeam
import type { EditAnchorResponse } from './generated/schemas/editAnchorResponse';
import type { EmailFollowup } from './generated/schemas/emailFollowup';
import type { EmailFollowupCommand } from './generated/schemas/emailFollowupCommand';
+import type { EmailReminderPage } from './generated/schemas/emailReminderPage';
import type { ExportDocumentResponse } from './generated/schemas/exportDocumentResponse';
import type { Favorite } from './generated/schemas/favorite';
import type { FavoritesList } from './generated/schemas/favoritesList';
@@ -122,6 +123,7 @@ import type { ImportPage } from './generated/schemas/importPage';
import type { ImportProgress } from './generated/schemas/importProgress';
import type { Item } from './generated/schemas/item';
import type { JobId } from './generated/schemas/jobId';
+import type { ListEmailRemindersParams } from './generated/schemas/listEmailRemindersParams';
import type { ListFavoritesParams } from './generated/schemas/listFavoritesParams';
import type { ListOccurrencesParams } from './generated/schemas/listOccurrencesParams';
import type { ListReminderCollectionParams } from './generated/schemas/listReminderCollectionParams';
@@ -2504,6 +2506,20 @@ export const storageServiceClient = {
},
},
reminders: {
+ async listEmailReminders(params: ListEmailRemindersParams) {
+ const query = new URLSearchParams();
+ for (const [key, value] of Object.entries(params)) {
+ if (Array.isArray(value)) {
+ for (const item of value) query.append(key, item);
+ } else if (value !== undefined && value !== null) {
+ query.set(key, String(value));
+ }
+ }
+ return await dssFetch<EmailReminderPage>(
+ `/reminders/email/collection?${query}`,
+ { method: 'GET' }
+ );
+ },
async listCollection(params: ListReminderCollectionParams) {
const query = new URLSearchParams();
if (params.completed !== undefined)
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/emailReminderPage.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/emailReminderPage.ts
new file mode 100644
index 0000000000..78d1a51d1d
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/emailReminderPage.ts
@@ -0,0 +1,19 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+import type { EmailReminderPageNextCursor } from './emailReminderPageNextCursor';
+import type { EmailReminderSummary } from './emailReminderSummary';
+
+/**
+ * A page of original-email identities and private reminder metadata.
+ */
+export interface EmailReminderPage {
+ /** Coalesced rows in nearest-occurrence order. */
+ items: EmailReminderSummary[];
+ /** Progress through all examined candidates, absent at exhaustion. */
+ nextCursor?: EmailReminderPageNextCursor;
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/emailReminderPageNextCursor.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/emailReminderPageNextCursor.ts
new file mode 100644
index 0000000000..48187ae807
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/emailReminderPageNextCursor.ts
@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+/**
+ * Progress through all examined candidates, absent at exhaustion.
+ */
+export type EmailReminderPageNextCursor = string | null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/emailReminderSummary.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/emailReminderSummary.ts
new file mode 100644
index 0000000000..3c40e79e3c
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/emailReminderSummary.ts
@@ -0,0 +1,22 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { ReminderCollectionRow } from './reminderCollectionRow';
+
+/**
+ * One original thread, coalescing all of its current reminder work.
+ */
+export interface EmailReminderSummary {
+ /**
+ * Number of eligible reminders attached to this thread.
+ * @minimum 0
+ */
+ count: number;
+ /** Nearest eligible occurrence and its owning editor capability. */
+ nearest: ReminderCollectionRow;
+ /** Original email identity, never a mirror reminder identity. */
+ threadId: string;
+}
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 9fd1fb8d53..1056dd3a13 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
@@ -756,6 +756,9 @@ export * from './emailFollowupCommandOneOfType';
export * from './emailFollowupResponse';
export * from './emailFollowupResponseFollowup';
export * from './emailReminderCondition';
+export * from './emailReminderPage';
+export * from './emailReminderPageNextCursor';
+export * from './emailReminderSummary';
export * from './emptyResponse';
export * from './ensureCollabSurfaceRequest';
export * from './ensureCollabSurfaceRequestParentEntityType';
@@ -1018,6 +1021,7 @@ export * from './latestMessageLatestMessage';
export * from './latestMessageLatestNonThreadMessage';
export * from './leaveCallResponse';
export * from './linkShare';
+export * from './listEmailRemindersParams';
export * from './listedDatabase';
export * from './listFavoritesEntityTypeItem';
export * from './listFavoritesParams';
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/listEmailRemindersParams.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/listEmailRemindersParams.ts
new file mode 100644
index 0000000000..5e09fb256d
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/listEmailRemindersParams.ts
@@ -0,0 +1,47 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+
+export type ListEmailRemindersParams = {
+ /**
+ * Selected inboxes; omission selects all accessible inboxes.
+ */
+ inboxIds?: string[] | null;
+ /**
+ * Explicitly empty inbox selection.
+ */
+ noInboxes?: boolean | null;
+ /**
+ * Email archive filter, independent of reminder completion.
+ */
+ done?: boolean | null;
+ /**
+ * Email read status.
+ */
+ read?: boolean | null;
+ /**
+ * Restrict to calendar mail.
+ */
+ calendar?: boolean | null;
+ /**
+ * Repeated property-definition:select-option UUID pairs.
+ */
+ tags?: string[] | null;
+ /**
+ * Repeated attachment categories: pdf, image, document.
+ */
+ attachments?: string[] | null;
+ /**
+ * Continuation from the previous page.
+ */
+ cursor?: string | null;
+ /**
+ * Maximum rows (1–100).
+ * @minimum 1
+ * @maximum 100
+ */
+ limit?: number | null;
+};
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 d5b03b1d61..e0e6698dba 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
@@ -41023,6 +41023,254 @@ export const listReminderCollectionResponse = zod
'One continuous collection, including completed recurring reminders that still fire.'
);
+/**
+ * @summary List original email threads with caller-private reminder work.
+ */
+export const listEmailRemindersQueryLimitMax = 100;
+
+export const listEmailRemindersQueryParams = zod.object({
+ inboxIds: zod
+ .array(zod.uuid())
+ .nullish()
+ .describe('Selected inboxes; omission selects all accessible inboxes.'),
+ noInboxes: zod
+ .boolean()
+ .nullish()
+ .describe('Explicitly empty inbox selection.'),
+ done: zod
+ .boolean()
+ .nullish()
+ .describe('Email archive filter, independent of reminder completion.'),
+ read: zod.boolean().nullish().describe('Email read status.'),
+ calendar: zod.boolean().nullish().describe('Restrict to calendar mail.'),
+ tags: zod
+ .array(zod.string())
+ .nullish()
+ .describe('Repeated property-definition:select-option UUID pairs.'),
+ attachments: zod
+ .array(zod.string())
+ .nullish()
+ .describe('Repeated attachment categories: pdf, image, document.'),
+ cursor: zod
+ .string()
+ .nullish()
+ .describe('Continuation from the previous page.'),
+ limit: zod
+ .number()
+ .min(1)
+ .max(listEmailRemindersQueryLimitMax)
+ .nullish()
+ .describe('Maximum rows (1–100).'),
+});
+
+export const listEmailRemindersResponseItemsItemCountMin = 0;
+
+export const listEmailRemindersResponse = zod
+ .object({
+ items: zod
+ .array(
+ zod
+ .object({
+ count: zod
+ .number()
+ .min(listEmailRemindersResponseItemsItemCountMin)
+ .describe(
+ 'Number of eligible reminders attached to this thread.'
+ ),
+ nearest: zod
+ .object({
+ emailFollowup: zod
+ .union([
+ zod.null(),
+ zod
+ .object({
+ condition: zod
+ .enum(['if_no_reply', 'regardless'])
+ .describe(
+ 'When an email follow-up should return the conversation.'
+ ),
+ linkId: zod
+ .uuid()
+ .describe('Canonical owned\/delegated inbox.'),
+ remindAt: zod.iso
+ .datetime({})
+ .describe('Confirmed schedule.'),
+ reminderId: zod
+ .uuid()
+ .describe(
+ 'Its ordinary reminder, used by the existing alert\/management surfaces.'
+ ),
+ revision: zod
+ .uuid()
+ .describe(
+ 'Last accepted operation; edits\/removal compare this to prevent stale undo.'
+ ),
+ state: zod
+ .enum([
+ 'archiving',
+ 'pending',
+ 'returning',
+ 'returned',
+ 'cancelled',
+ 'removed',
+ ])
+ .describe('Durable progress of an email operation.'),
+ threadId: zod.uuid().describe('Conversation identity.'),
+ })
+ .describe(
+ 'Public status shown on email and in the Reminders editor.'
+ ),
+ ])
+ .optional(),
+ reference: zod
+ .union([
+ zod.null(),
+ zod
+ .object({
+ fileType: zod
+ .string()
+ .nullish()
+ .describe(
+ "The referenced document's file type, e.g. `md` or `pdf`."
+ ),
+ subType: zod
+ .string()
+ .nullish()
+ .describe(
+ "The referenced document's sub type, e.g. `task` or `snippet`."
+ ),
+ })
+ .describe(
+ "Display details of the entity a reminder is about, resolved alongside the\nreminder itself.\n\nA reminder has no block of its own — it opens, and is iconed as, whatever it\nreferences. Which block that is depends on the referenced document's file\ntype, so resolving it client-side would mean a second fetch per row against\na synchronous icon path. Reading it here keeps Soup to one round trip.\n\nOnly documents populate these; every other entity type is identified by its\n[`EntityType`] alone."
+ ),
+ ])
+ .optional(),
+ reminder: zod
+ .object({
+ completedAt: zod.iso
+ .datetime({})
+ .nullish()
+ .describe(
+ 'Set once the owner marks the reminder as dealt with. Firing does not\nset it — a delivered reminder is waiting on its owner, not finished.'
+ ),
+ createdAt: zod.iso
+ .datetime({})
+ .describe('When the reminder was created.'),
+ description: zod
+ .string()
+ .describe('What to remind the user about.'),
+ enabled: zod
+ .boolean()
+ .describe(
+ 'When false, the dispatcher skips this reminder.'
+ ),
+ entityId: zod
+ .string()
+ .nullish()
+ .describe(
+ 'Id of the associated entity, when the reminder is attached to one.'
+ ),
+ entityType: zod
+ .union([
+ zod.null(),
+ zod
+ .enum([
+ 'user',
+ 'chat',
+ 'channel',
+ 'channel_message',
+ 'document',
+ 'project',
+ 'email_thread',
+ 'calendar_event',
+ 'team',
+ 'call',
+ 'foreign_entity',
+ 'static_file',
+ 'crm_company',
+ 'crm_contact',
+ 'reminder',
+ 'skill',
+ 'agent_session',
+ 'scheduled_action',
+ 'initiative',
+ 'database',
+ 'database_row',
+ ])
+ .describe('The type of an entity in Macro'),
+ ])
+ .optional()
+ .describe(
+ 'Type of the associated entity, when the reminder is attached to one.'
+ ),
+ id: zod.uuid().describe('Reminder id.'),
+ nextRunAt: zod.iso
+ .datetime({})
+ .describe(
+ 'The next firing, derived from `schedule` on write.'
+ ),
+ schedule: zod
+ .union([
+ zod
+ .object({
+ remindAt: zod.iso
+ .datetime({})
+ .describe('The instant to fire at.'),
+ type: zod.enum(['once']),
+ })
+ .describe('Fires once, at a fixed instant.'),
+ zod
+ .object({
+ cron: zod
+ .string()
+ .describe(
+ 'Cron expression, either the conventional 5-field\n`min hour dom mon dow` or the 6-\/7-field\n`sec min hour dom mon dow [year]`. A 5-field expression is stored\nnormalized to 6 fields with a zero seconds field, so `0 9 \* \* \*` and\n`0 0 9 \* \* \*` are the same schedule and both read back as the latter.'
+ ),
+ timezone: zod
+ .string()
+ .describe(
+ 'The timezone the cron expression is evaluated in.'
+ ),
+ type: zod.enum(['recurring']),
+ })
+ .describe(
+ 'Fires repeatedly, on a cron schedule evaluated in `timezone`.'
+ ),
+ ])
+ .describe('When a reminder fires.'),
+ updatedAt: zod.iso
+ .datetime({})
+ .describe('When the reminder was last modified.'),
+ })
+ .describe(
+ 'A reminder belonging to a user.\n\n`user_id` is deliberately absent: a reminder is only ever read by its owner,\nso the field would be redundant on the wire.'
+ ),
+ })
+ .describe(
+ 'A native reminder row with its source and workflow capabilities resolved in bulk.'
+ ),
+ threadId: zod
+ .uuid()
+ .describe(
+ 'Original email identity, never a mirror reminder identity.'
+ ),
+ })
+ .describe(
+ 'One original thread, coalescing all of its current reminder work.'
+ )
+ )
+ .describe('Coalesced rows in nearest-occurrence order.'),
+ nextCursor: zod
+ .string()
+ .nullish()
+ .describe(
+ 'Progress through all examined candidates, absent at exhaustion.'
+ ),
+ })
+ .describe(
+ 'A page of original-email identities and private reminder metadata.'
+ );
+
/**
* @summary Read an email follow-up and reconcile inbound reply cancellation.
*/
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 e305bcafff..acbad01896 100644
--- a/apps/web/src/lib/service-clients/service-storage/openapi.json
+++ b/apps/web/src/lib/service-clients/service-storage/openapi.json
@@ -14240,6 +14240,151 @@
}
}
},
+ "/reminders/email/collection": {
+ "get": {
+ "tags": ["reminders"],
+ "summary": "List original email threads with caller-private reminder work.",
+ "operationId": "list_email_reminders",
+ "parameters": [
+ {
+ "name": "inboxIds",
+ "in": "query",
+ "description": "Selected inboxes; omission selects all accessible inboxes.",
+ "required": false,
+ "schema": {
+ "type": ["array", "null"],
+ "items": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ },
+ {
+ "name": "noInboxes",
+ "in": "query",
+ "description": "Explicitly empty inbox selection.",
+ "required": false,
+ "schema": {
+ "type": ["boolean", "null"]
+ }
+ },
+ {
+ "name": "done",
+ "in": "query",
+ "description": "Email archive filter, independent of reminder completion.",
+ "required": false,
+ "schema": {
+ "type": ["boolean", "null"]
+ }
+ },
+ {
+ "name": "read",
+ "in": "query",
+ "description": "Email read status.",
+ "required": false,
+ "schema": {
+ "type": ["boolean", "null"]
+ }
+ },
+ {
+ "name": "calendar",
+ "in": "query",
+ "description": "Restrict to calendar mail.",
+ "required": false,
+ "schema": {
+ "type": ["boolean", "null"]
+ }
+ },
+ {
+ "name": "tags",
+ "in": "query",
+ "description": "Repeated property-definition:select-option UUID pairs.",
+ "required": false,
+ "schema": {
+ "type": ["array", "null"],
+ "items": {
+ "type": "string"
+ }
+ }
+ },
+ {
+ "name": "attachments",
+ "in": "query",
+ "description": "Repeated attachment categories: pdf, image, document.",
+ "required": false,
+ "schema": {
+ "type": ["array", "null"],
+ "items": {
+ "type": "string"
+ }
+ }
+ },
+ {
+ "name": "cursor",
+ "in": "query",
+ "description": "Continuation from the previous page.",
+ "required": false,
+ "schema": {
+ "type": ["string", "null"]
+ }
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "description": "Maximum rows (1–100).",
+ "required": false,
+ "schema": {
+ "type": ["integer", "null"],
+ "format": "int32",
+ "maximum": 100,
+ "minimum": 1
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/EmailReminderPage"
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/reminders/email/{thread_id}": {
"get": {
"tags": ["reminders"],
@@ -24316,6 +24461,46 @@
"description": "When an email follow-up should return the conversation.",
"enum": ["if_no_reply", "regardless"]
},
+ "EmailReminderPage": {
+ "type": "object",
+ "description": "A page of original-email identities and private reminder metadata.",
+ "required": ["items"],
+ "properties": {
+ "items": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EmailReminderSummary"
+ },
+ "description": "Coalesced rows in nearest-occurrence order."
+ },
+ "nextCursor": {
+ "type": ["string", "null"],
+ "description": "Progress through all examined candidates, absent at exhaustion."
+ }
+ }
+ },
+ "EmailReminderSummary": {
+ "type": "object",
+ "description": "One original thread, coalescing all of its current reminder work.",
+ "required": ["threadId", "nearest", "count"],
+ "properties": {
+ "count": {
+ "type": "integer",
+ "format": "int32",
+ "description": "Number of eligible reminders attached to this thread.",
+ "minimum": 0
+ },
+ "nearest": {
+ "$ref": "#/components/schemas/ReminderCollectionRow",
+ "description": "Nearest eligible occurrence and its owning editor capability."
+ },
+ "threadId": {
+ "type": "string",
+ "format": "uuid",
+ "description": "Original email identity, never a mirror reminder identity."
+ }
+ }
+ },
"EmptyResponse": {
"type": "object",
"description": "Empty response is required due to custom fetch forcing `response.json()`"
diff --git a/crates/email/src/domain/followup.rs b/crates/email/src/domain/followup.rs
index 536d9e53c8..98f0f63e40 100644
--- a/crates/email/src/domain/followup.rs
+++ b/crates/email/src/domain/followup.rs
@@ -75,6 +75,19 @@ impl FollowupThread {
/// Email facts and mutations exposed to the reminder domain.
pub trait EmailFollowupMailbox: Send + Sync + 'static {
+ /// Resolve a bounded set of candidate threads using email-owned access and filters.
+ /// Missing and inaccessible threads are omitted, including revoked shares.
+ fn reminder_threads(
+ &self,
+ user: MacroUserIdStr<'static>,
+ receipts: Vec<
+ entity_access::domain::models::EntityAccessReceipt<
+ entity_access::domain::models::ViewAccessLevel,
+ >,
+ >,
+ filters: &ReminderThreadFilter,
+ ) -> impl Future<Output = Result<Vec<Uuid>, EmailErr>> + Send;
+
/// Resolve owned/delegated access and inspect this conversation.
fn followup_thread(
&self,
@@ -95,6 +108,23 @@ pub trait EmailFollowupMailbox: Send + Sync + 'static {
) -> impl Future<Output = Result<(), EmailErr>> + Send;
}
+/// Email facets applied before the reminder collection's public page boundary.
+#[derive(Debug, Clone, Default)]
+pub struct ReminderThreadFilter {
+ /// None selects every accessible inbox; an empty selection matches nothing.
+ pub inbox_ids: Option<Vec<Uuid>>,
+ /// Explicit email archive filter, independent of reminder completion.
+ pub done: Option<bool>,
+ /// Explicit email read filter.
+ pub read: Option<bool>,
+ /// Restrict to threads with calendar attachments.
+ pub calendar: bool,
+ /// Tag select options, ORed together like the ordinary email facet.
+ pub tags: Vec<(Uuid, Uuid)>,
+ /// Attachment categories, ORed together.
+ pub attachments: Vec<ReminderAttachmentKind>,
+}
+
/// Persistence capabilities specific to the email side of follow-ups.
pub trait EmailFollowupRepo: Send + Sync + 'static {
/// Load message identity/classification facts for an authorized thread.
@@ -123,3 +153,41 @@ pub trait EmailFollowupRepo: Send + Sync + 'static {
#[cfg(test)]
mod test;
+
+/// The existing email attachment facets.
+#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]
+pub enum ReminderAttachmentKind {
+ /// PDF files.
+ Pdf,
+ /// Supported image formats.
+ Image,
+ /// Office documents, text and CSV.
+ Document,
+}
+
+impl ReminderAttachmentKind {
+ /// Match the same MIME prefixes as the ordinary Email view.
+ pub fn matches(self, mime: &str) -> bool {
+ let prefixes: &[&str] = match self {
+ Self::Pdf => &["application/pdf"],
+ Self::Image => &[
+ "image/png",
+ "image/jpeg",
+ "image/gif",
+ "image/webp",
+ "image/svg+xml",
+ ],
+ Self::Document => &[
+ "application/msword",
+ "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+ "application/vnd.ms-excel",
+ "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+ "application/vnd.ms-powerpoint",
+ "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+ "text/plain",
+ "text/csv",
+ ],
+ };
+ prefixes.iter().any(|prefix| mime.starts_with(prefix))
+ }
+}
diff --git a/crates/email/src/domain/service/followup.rs b/crates/email/src/domain/service/followup.rs
index c246abac9a..dd11bcf4cd 100644
--- a/crates/email/src/domain/service/followup.rs
+++ b/crates/email/src/domain/service/followup.rs
@@ -3,7 +3,7 @@ use macro_user_id::user_id::MacroUserIdStr;
use uuid::Uuid;
use crate::domain::{
- followup::{EmailFollowupMailbox, EmailFollowupRepo, FollowupThread},
+ followup::{EmailFollowupMailbox, EmailFollowupRepo, FollowupThread, ReminderThreadFilter},
models::{EmailErr, label::system_labels},
ports::{EmailMessageEnqueuer, EmailRepo},
};
@@ -22,6 +22,115 @@ where
B: MacroEventBroker,
anyhow::Error: From<T::Err> + From<E::Err>,
{
+ async fn reminder_threads(
+ &self,
+ user: MacroUserIdStr<'static>,
+ receipts: Vec<
+ entity_access::domain::models::EntityAccessReceipt<
+ entity_access::domain::models::ViewAccessLevel,
+ >,
+ >,
+ filters: &ReminderThreadFilter,
+ ) -> Result<Vec<Uuid>, EmailErr> {
+ use crate::domain::models::{PreviewCursorQuery, PreviewView, PreviewViewStandardLabel};
+ use filter_ast::Expr;
+ use item_filters::ast::email::EmailLiteral;
+ use models_pagination::{Query, SimpleSortMethod};
+ use std::sync::Arc;
+
+ let thread_ids: Vec<Uuid> = receipts
+ .iter()
+ .map(|receipt| receipt.entity().entity_id.parse::<Uuid>())
+ .collect::<Result<_, _>>()
+ .map_err(|error| EmailErr::RepoErr(error.into()))?;
+ if thread_ids.is_empty() || filters.inbox_ids.as_ref().is_some_and(Vec::is_empty) {
+ return Ok(Vec::new());
+ }
+ let links = self
+ .email_repo
+ .inboxes_for_macro_id(user.clone())
+ .await
+ .map_err(|e| EmailErr::RepoErr(anyhow::Error::from(e)))?;
+ let mut expression = thread_ids
+ .iter()
+ .map(|id| Expr::Literal(EmailLiteral::ThreadId(*id)))
+ .reduce(Expr::or)
+ .expect("nonempty candidate IDs");
+ if let Some(ids) = &filters.inbox_ids {
+ let selected = ids
+ .iter()
+ .map(|id| Expr::Literal(EmailLiteral::Owner(*id)))
+ .reduce(Expr::or)
+ .expect("nonempty inbox selection");
+ expression = Expr::and(expression, selected);
+ }
+ for literal in [
+ filters.done.map(|done| EmailLiteral::InboxVisible(!done)),
+ filters.read.map(EmailLiteral::Read),
+ filters.calendar.then_some(EmailLiteral::CalendarOnly(true)),
+ ]
+ .into_iter()
+ .flatten()
+ {
+ expression = Expr::and(expression, Expr::Literal(literal));
+ }
+ if let Some(tags) = filters
+ .tags
+ .iter()
+ .map(|(property, option)| {
+ use item_filters::ast::properties::{
+ PropertiesLiteral, PropertyEntityType, PropertyMatchValue,
+ };
+ Expr::Literal(EmailLiteral::Property(PropertiesLiteral {
+ property_definition_id: *property,
+ entity_type: Some(PropertyEntityType::Thread),
+ value: PropertyMatchValue::SelectOption(*option),
+ }))
+ })
+ .reduce(Expr::or)
+ {
+ expression = Expr::and(expression, tags);
+ }
+ let previews = self
+ .email_repo
+ .previews_for_view_cursor(
+ PreviewCursorQuery {
+ view: PreviewView::StandardLabel(PreviewViewStandardLabel::All),
+ link_ids: links.into_iter().map(|link| link.id).collect(),
+ limit: thread_ids.len() as u32,
+ query: Query::new(
+ None,
+ SimpleSortMethod::UpdatedAt,
+ Some(Arc::new(expression)),
+ ),
+ team_id: None,
+ },
+ user,
+ )
+ .await
+ .map_err(|e| EmailErr::RepoErr(anyhow::Error::from(e)))?;
+ let ids: Vec<_> = previews.into_iter().map(|thread| thread.id).collect();
+ if filters.attachments.is_empty() {
+ return Ok(ids);
+ }
+ let attachments = self
+ .email_repo
+ .attachments_by_thread_ids(&ids)
+ .await
+ .map_err(|error| EmailErr::RepoErr(anyhow::Error::from(error)))?;
+ let matching: std::collections::HashSet<_> = attachments
+ .into_iter()
+ .filter(|attachment| {
+ attachment
+ .mime_type
+ .as_deref()
+ .is_some_and(|mime| filters.attachments.iter().any(|kind| kind.matches(mime)))
+ })
+ .map(|attachment| attachment.thread_id)
+ .collect();
+ Ok(ids.into_iter().filter(|id| matching.contains(id)).collect())
+ }
+
async fn followup_thread(
&self,
user: MacroUserIdStr<'static>,
diff --git a/crates/email/src/outbound/email_pg_repo/test.rs b/crates/email/src/outbound/email_pg_repo/test.rs
index bc5e2aabc8..e821521f73 100644
--- a/crates/email/src/outbound/email_pg_repo/test.rs
+++ b/crates/email/src/outbound/email_pg_repo/test.rs
@@ -9,6 +9,7 @@ mod message;
mod preview;
mod project;
mod project_scope_dynamic_query;
+mod reminder_collection;
mod scheduled;
mod settings;
mod signal_flag;
diff --git a/crates/email/src/outbound/email_pg_repo/test/reminder_collection.rs b/crates/email/src/outbound/email_pg_repo/test/reminder_collection.rs
new file mode 100644
index 0000000000..c3a15bfa70
--- /dev/null
+++ b/crates/email/src/outbound/email_pg_repo/test/reminder_collection.rs
@@ -0,0 +1,196 @@
+use super::thread_unread::service;
+use super::*;
+use crate::domain::followup::{EmailFollowupMailbox, ReminderAttachmentKind, ReminderThreadFilter};
+use entity_access::{
+ domain::{
+ models::{EntityAccessReceipt, ViewAccessLevel},
+ ports::EntityAccessService,
+ service::EntityAccessServiceImpl,
+ },
+ outbound::PgAccessRepository,
+};
+
+async fn receipts(
+ pool: &Pool<Postgres>,
+ user: &MacroUserIdStr<'_>,
+ ids: &[Uuid],
+) -> Vec<EntityAccessReceipt<ViewAccessLevel>> {
+ EntityAccessServiceImpl::new(PgAccessRepository::new(pool.clone()))
+ .generate_email_thread_view_access_receipts(
+ user,
+ None,
+ &ids.iter().map(ToString::to_string).collect::<Vec<_>>(),
+ )
+ .await
+ .into_values()
+ .filter_map(Result::ok)
+ .collect()
+}
+
+#[sqlx::test(
+ migrator = "MACRO_DB_MIGRATIONS",
+ fixtures(
+ path = "../../../../fixtures",
+ scripts(
+ "email_dynamic_query",
+ "email_dynamic_query_multi_inbox",
+ "email_dynamic_query_calendar",
+ "email_dynamic_query_properties"
+ )
+ )
+)]
+async fn reminder_collection_applies_current_inbox_and_all_email_facets(
+ pool: Pool<Postgres>,
+) -> anyhow::Result<()> {
+ let mailbox = service(pool.clone());
+ let user = MacroUserIdStr::try_from_email("[email protected]")?;
+ let first = uuid::uuid!("20000001-0000-0000-0000-000000000001");
+ let second = uuid::uuid!("20000201-0000-0000-0000-000000000201");
+ let pdf = uuid::uuid!("20000005-0000-0000-0000-000000000005");
+ let ids = [first, second, pdf];
+ let cases = [
+ (
+ ReminderThreadFilter {
+ inbox_ids: Some(vec![uuid::uuid!("dddddddd-dddd-dddd-dddd-dddddddddddd")]),
+ ..Default::default()
+ },
+ vec![second],
+ ),
+ (
+ ReminderThreadFilter {
+ inbox_ids: Some(vec![]),
+ ..Default::default()
+ },
+ vec![],
+ ),
+ (
+ ReminderThreadFilter {
+ done: Some(true),
+ read: Some(true),
+ ..Default::default()
+ },
+ vec![second],
+ ),
+ (
+ ReminderThreadFilter {
+ calendar: true,
+ ..Default::default()
+ },
+ vec![first, pdf],
+ ),
+ (
+ ReminderThreadFilter {
+ tags: vec![(
+ uuid::uuid!("bb111111-1111-1111-1111-111111111111"),
+ uuid::uuid!("0bb11111-1111-1111-1111-111111111111"),
+ )],
+ ..Default::default()
+ },
+ vec![first],
+ ),
+ (
+ ReminderThreadFilter {
+ attachments: vec![ReminderAttachmentKind::Pdf],
+ ..Default::default()
+ },
+ vec![pdf],
+ ),
+ (
+ ReminderThreadFilter {
+ attachments: vec![ReminderAttachmentKind::Image],
+ ..Default::default()
+ },
+ vec![],
+ ),
+ ];
+ for (filters, mut expected) in cases {
+ let mut actual = mailbox
+ .reminder_threads(user.clone(), receipts(&pool, &user, &ids).await, &filters)
+ .await?;
+ actual.sort();
+ expected.sort();
+ assert_eq!(actual, expected, "filters: {filters:?}");
+ }
+ Ok(())
+}
+
+#[sqlx::test(
+ migrator = "MACRO_DB_MIGRATIONS",
+ fixtures(
+ path = "../../../../fixtures",
+ scripts("email_dynamic_query", "email_dynamic_query_multi_inbox")
+ )
+)]
+async fn reminder_collection_rechecks_delegation_after_receipt_minting(
+ pool: Pool<Postgres>,
+) -> anyhow::Result<()> {
+ let thread = uuid::uuid!("20000201-0000-0000-0000-000000000201");
+ let link = uuid::uuid!("dddddddd-dddd-dddd-dddd-dddddddddddd");
+ sqlx::query!(r#"INSERT INTO macro_user (id, username, email, stripe_customer_id) VALUES ('d1000000-0000-0000-0000-000000000002', 'delegate', '[email protected]', 'collection_delegate')"#).execute(&pool).await?;
+ sqlx::query!(r#"INSERT INTO "User" (id, email, macro_user_id) VALUES ('macro|[email protected]', '[email protected]', 'd1000000-0000-0000-0000-000000000002')"#).execute(&pool).await?;
+ sqlx::query!("INSERT INTO macro_user_links (primary_macro_id, child_macro_id, link_id) VALUES ('macro|[email protected]', 'macro|[email protected]', $1)", link).execute(&pool).await?;
+ let user = MacroUserIdStr::try_from_email("[email protected]")?;
+ let mailbox = service(pool.clone());
+ let filters = ReminderThreadFilter {
+ inbox_ids: Some(vec![link]),
+ ..Default::default()
+ };
+ let before = receipts(&pool, &user, &[thread]).await;
+ assert_eq!(before.len(), 1);
+ assert_eq!(
+ mailbox
+ .reminder_threads(user.clone(), before, &filters)
+ .await?,
+ vec![thread]
+ );
+ let stale = receipts(&pool, &user, &[thread]).await;
+ sqlx::query!(
+ "DELETE FROM macro_user_links WHERE primary_macro_id = $1",
+ user.as_ref()
+ )
+ .execute(&pool)
+ .await?;
+ assert!(
+ mailbox
+ .reminder_threads(user.clone(), stale, &filters)
+ .await?
+ .is_empty()
+ );
+ assert!(receipts(&pool, &user, &[thread]).await.is_empty());
+ Ok(())
+}
+
+#[sqlx::test(
+ migrator = "MACRO_DB_MIGRATIONS",
+ fixtures(path = "../../../../fixtures", scripts("email_dynamic_query"))
+)]
+async fn reminder_collection_excludes_shared_rows_outside_mail_inboxes(
+ pool: Pool<Postgres>,
+) -> anyhow::Result<()> {
+ let thread = uuid::uuid!("20000001-0000-0000-0000-000000000001");
+ let user = MacroUserIdStr::try_from_email("[email protected]")?;
+ sqlx::query!(r#"INSERT INTO macro_user (id, username, email, stripe_customer_id) VALUES ('d2000000-0000-0000-0000-000000000002', 'shared-viewer', '[email protected]', 'collection_shared')"#).execute(&pool).await?;
+ sqlx::query!(r#"INSERT INTO "User" (id, email, macro_user_id) VALUES ('macro|[email protected]', '[email protected]', 'd2000000-0000-0000-0000-000000000002')"#).execute(&pool).await?;
+ sqlx::query!("INSERT INTO entity_access (entity_id, entity_type, source_id, source_type, access_level) VALUES ($1, 'email_thread', $2, 'user', 'view')", thread, user.as_ref()).execute(&pool).await?;
+ let mailbox = service(pool.clone());
+ assert_eq!(receipts(&pool, &user, &[thread]).await.len(), 1);
+ assert!(
+ mailbox
+ .reminder_threads(
+ user.clone(),
+ receipts(&pool, &user, &[thread]).await,
+ &ReminderThreadFilter::default()
+ )
+ .await?
+ .is_empty()
+ );
+ sqlx::query!(
+ "DELETE FROM entity_access WHERE entity_id = $1 AND source_id = $2",
+ thread,
+ user.as_ref()
+ )
+ .execute(&pool)
+ .await?;
+ assert!(receipts(&pool, &user, &[thread]).await.is_empty());
+ Ok(())
+}
diff --git a/crates/reminders/src/domain.rs b/crates/reminders/src/domain.rs
index a67551be85..e01a7b4535 100644
--- a/crates/reminders/src/domain.rs
+++ b/crates/reminders/src/domain.rs
@@ -2,6 +2,8 @@
#[cfg(feature = "ports")]
pub mod collection;
+#[cfg(feature = "ports")]
+pub mod email_collection;
pub mod models;
#[cfg(feature = "ports")]
pub mod ports;
diff --git a/crates/reminders/src/domain/email_collection.rs b/crates/reminders/src/domain/email_collection.rs
new file mode 100644
index 0000000000..aecebd98c5
--- /dev/null
+++ b/crates/reminders/src/domain/email_collection.rs
@@ -0,0 +1,103 @@
+//! Private reminder metadata for original email rows.
+
+pub mod service;
+
+use chrono::{DateTime, Utc};
+use serde::{Deserialize, Serialize};
+use uuid::Uuid;
+
+use super::{collection::ReminderCollectionRow, models::InvalidCursor};
+
+/// One original thread, coalescing all of its current reminder work.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub struct EmailReminderSummary {
+ /// Original email identity, never a mirror reminder identity.
+ pub thread_id: Uuid,
+ /// Nearest eligible occurrence and its owning editor capability.
+ pub nearest: ReminderCollectionRow,
+ /// Number of eligible reminders attached to this thread.
+ pub count: u32,
+}
+
+/// Stable thread position, independent of the email's activity ordering.
+#[derive(Debug, Clone, Copy)]
+pub struct EmailReminderCursor {
+ /// Fixed clock shared by every page in a collection traversal.
+ pub as_of: DateTime<Utc>,
+ /// Nearest occurrence at the time this candidate was examined.
+ pub next_run_at: DateTime<Utc>,
+ /// Identity breaks ties between equal occurrences.
+ pub thread_id: Uuid,
+}
+
+impl EmailReminderCursor {
+ /// Encode without exposing private reminder descriptions.
+ pub fn encode(self) -> String {
+ format!(
+ "{}.{}.{}",
+ self.as_of.timestamp_micros(),
+ self.next_run_at.timestamp_micros(),
+ self.thread_id
+ )
+ }
+
+ /// Reject invalid cursors instead of restarting a page.
+ pub fn decode(value: &str) -> Result<Self, InvalidCursor> {
+ let (as_of, remaining) = value.split_once('.').ok_or(InvalidCursor)?;
+ let (time, id) = remaining.split_once('.').ok_or(InvalidCursor)?;
+ Ok(Self {
+ as_of: as_of
+ .parse()
+ .ok()
+ .and_then(DateTime::from_timestamp_micros)
+ .ok_or(InvalidCursor)?,
+ next_run_at: time
+ .parse()
+ .ok()
+ .and_then(DateTime::from_timestamp_micros)
+ .ok_or(InvalidCursor)?,
+ thread_id: id.parse().map_err(|_| InvalidCursor)?,
+ })
+ }
+}
+
+/// Email-owned filters and reminder-owned pagination for one collection request.
+#[derive(Debug, Clone, Default)]
+pub struct EmailReminderQuery {
+ /// Email filters evaluated by the owning read service.
+ pub filters: email::domain::followup::ReminderThreadFilter,
+ /// Opaque cursor also binds the request to its filter scope.
+ pub cursor: Option<String>,
+ /// Domain clamps this to the supported page size.
+ pub limit: Option<u32>,
+}
+
+/// Caller identity is reused across authorization and email reads for a page.
+pub struct EmailReminderViewer {
+ /// Authenticated private reminder owner.
+ pub user_id: macro_user_id::user_id::MacroUserIdStr<'static>,
+ /// Organization context used to mint email view receipts.
+ pub org_id: Option<i64>,
+}
+
+/// Candidate progress is retained even if every reminder on a thread is malformed.
+#[derive(Debug)]
+pub struct EmailReminderCandidate {
+ /// Storage position, including unreadable candidates.
+ pub cursor: EmailReminderCursor,
+ /// Only successfully decoded, current reminders.
+ pub summary: Option<EmailReminderSummary>,
+}
+
+/// A page of original-email identities and private reminder metadata.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub struct EmailReminderPage {
+ /// Coalesced rows in nearest-occurrence order.
+ pub items: Vec<EmailReminderSummary>,
+ /// Progress through all examined candidates, absent at exhaustion.
+ pub next_cursor: Option<String>,
+}
diff --git a/crates/reminders/src/domain/email_collection/service.rs b/crates/reminders/src/domain/email_collection/service.rs
new file mode 100644
index 0000000000..ca4436de3b
--- /dev/null
+++ b/crates/reminders/src/domain/email_collection/service.rs
@@ -0,0 +1,155 @@
+//! Scan private reminder candidates and authorize before producing public pages.
+use std::collections::HashSet;
+
+use email::domain::followup::{EmailFollowupMailbox, ReminderThreadFilter};
+use entity_access::domain::{models::AccessError, ports::EntityAccessService};
+use uuid::Uuid;
+
+use super::*;
+use crate::domain::{
+ models::ReminderError,
+ ports::{Clock, RemindersRepo},
+};
+
+const BATCH_SIZE: u32 = 100;
+const MAX_BATCHES: usize = 5;
+
+fn internal(error: impl std::error::Error + Send + Sync + 'static) -> ReminderError {
+ ReminderError::Internal(rootcause::Report::new(error).into_dynamic())
+}
+
+fn scope(filters: &ReminderThreadFilter) -> String {
+ let inboxes = filters
+ .inbox_ids
+ .as_ref()
+ .map(|ids| {
+ let mut ids = ids.clone();
+ ids.sort_unstable();
+ ids.dedup();
+ ids.into_iter()
+ .map(|id| id.to_string())
+ .collect::<Vec<_>>()
+ .join(",")
+ })
+ .unwrap_or_else(|| "all".into());
+ let mut tags = filters.tags.clone();
+ tags.sort_unstable();
+ tags.dedup();
+ let mut attachments = filters.attachments.clone();
+ attachments.sort_unstable();
+ attachments.dedup();
+ format!(
+ "{inboxes}:{:?}:{:?}:{}:{tags:?}:{attachments:?}",
+ filters.done, filters.read, filters.calendar
+ )
+}
+
+async fn eligible<E: EmailFollowupMailbox, A: EntityAccessService>(
+ mailbox: &E,
+ access: &A,
+ viewer: &EmailReminderViewer,
+ candidates: &[EmailReminderCandidate],
+ filters: &ReminderThreadFilter,
+) -> Result<HashSet<Uuid>, ReminderError> {
+ let ids: Vec<_> = candidates
+ .iter()
+ .filter(|candidate| candidate.summary.is_some())
+ .map(|candidate| candidate.cursor.thread_id.to_string())
+ .collect();
+ if ids.is_empty() {
+ return Ok(HashSet::new());
+ }
+ let mut results = access
+ .generate_email_thread_view_access_receipts(&viewer.user_id, viewer.org_id, &ids)
+ .await;
+ let mut receipts = Vec::new();
+ for id in ids {
+ match results.remove(&id) {
+ Some(Ok(receipt)) => receipts.push(receipt),
+ Some(Err(
+ AccessError::Unauthorized
+ | AccessError::UnauthorizedWithMessage(_)
+ | AccessError::NotFound(_),
+ )) => {}
+ Some(Err(error)) => return Err(internal(error)),
+ None => {
+ return Err(ReminderError::Internal(
+ rootcause::report!("missing batch email access result").into_dynamic(),
+ ));
+ }
+ }
+ }
+ if receipts.is_empty() {
+ return Ok(HashSet::new());
+ }
+ let ids = mailbox
+ .reminder_threads(viewer.user_id.clone(), receipts, filters)
+ .await
+ .map_err(internal)?;
+ Ok(ids.into_iter().collect())
+}
+
+/// Fill a page under a bounded scan budget. Sparse pages retain a continuation.
+pub async fn list<R: RemindersRepo, E: EmailFollowupMailbox, A: EntityAccessService, C: Clock>(
+ repo: &R,
+ mailbox: &E,
+ access: &A,
+ clock: &C,
+ viewer: EmailReminderViewer,
+ query: EmailReminderQuery,
+) -> Result<EmailReminderPage, ReminderError> {
+ let filter_scope = scope(&query.filters);
+ let mut cursor = query
+ .cursor
+ .as_deref()
+ .map(|value| {
+ let (position, cursor_scope) = value.split_once('|').ok_or(InvalidCursor)?;
+ if cursor_scope != filter_scope {
+ return Err(InvalidCursor);
+ }
+ EmailReminderCursor::decode(position)
+ })
+ .transpose()?;
+ let as_of = cursor
+ .map(|cursor| cursor.as_of)
+ .unwrap_or_else(|| clock.now());
+ let limit = query.limit.unwrap_or(BATCH_SIZE).clamp(1, BATCH_SIZE) as usize;
+ let mut items = Vec::with_capacity(limit);
+ let mut exhausted = false;
+ for _ in 0..MAX_BATCHES {
+ let candidates = repo
+ .email_candidates(&viewer.user_id, None, cursor, as_of, BATCH_SIZE)
+ .await
+ .map_err(internal)?;
+ let short_batch = candidates.len() < BATCH_SIZE as usize;
+ let allowed = eligible(mailbox, access, &viewer, &candidates, &query.filters).await?;
+ for candidate in candidates {
+ if allowed.contains(&candidate.cursor.thread_id) && candidate.summary.is_some() {
+ // This candidate belongs to the next page. Never move past it.
+ if items.len() == limit {
+ return Ok(EmailReminderPage {
+ items,
+ next_cursor: cursor.map(|c| format!("{}|{filter_scope}", c.encode())),
+ });
+ }
+ if let Some(summary) = candidate.summary {
+ items.push(summary);
+ }
+ }
+ cursor = Some(candidate.cursor);
+ }
+ if short_batch {
+ exhausted = true;
+ break;
+ }
+ if items.len() == limit {
+ break;
+ }
+ }
+ Ok(EmailReminderPage {
+ items,
+ next_cursor: (!exhausted)
+ .then(|| cursor.map(|c| format!("{}|{filter_scope}", c.encode())))
+ .flatten(),
+ })
+}
diff --git a/crates/reminders/src/domain/email_followup/reminder_service.rs b/crates/reminders/src/domain/email_followup/reminder_service.rs
index 76f44e8e2c..f734e72b8b 100644
--- a/crates/reminders/src/domain/email_followup/reminder_service.rs
+++ b/crates/reminders/src/domain/email_followup/reminder_service.rs
@@ -12,19 +12,61 @@ use uuid::Uuid;
/// Application-facing service, composing generic reminders and email behavior.
#[derive(Clone)]
-pub struct EmailRemindersService<S, R, E, C> {
+pub struct EmailRemindersService<
+ S,
+ R,
+ E,
+ C,
+ A = entity_access::domain::ports::NoOpEntityAccessService,
+> {
generic: S,
email: EmailFollowupService<R, E, C>,
+ access: A,
}
impl<S, R, E, C> EmailRemindersService<S, R, E, C> {
/// Wire one shared email workflow into CRUD and dispatch.
pub fn new(generic: S, email: EmailFollowupService<R, E, C>) -> Self {
- Self { generic, email }
+ Self {
+ generic,
+ email,
+ access: entity_access::domain::ports::NoOpEntityAccessService,
+ }
+ }
+}
+impl<S, R, E, C, A> EmailRemindersService<S, R, E, C, A> {
+ /// Supply the caller-aware access service used by collection and summary reads.
+ pub fn with_entity_access<B>(self, access: B) -> EmailRemindersService<S, R, E, C, B> {
+ EmailRemindersService {
+ generic: self.generic,
+ email: self.email,
+ access,
+ }
}
}
-impl<S: RemindersService, R: EmailFollowupRepo, E: EmailFollowupMailbox, C: Clock> RemindersService
- for EmailRemindersService<S, R, E, C>
+impl<
+ S: RemindersService,
+ R: EmailFollowupRepo,
+ E: EmailFollowupMailbox,
+ C: Clock,
+ A: entity_access::domain::ports::EntityAccessService,
+> RemindersService for EmailRemindersService<S, R, E, C, A>
{
+ async fn list_email_reminders(
+ &self,
+ viewer: crate::domain::email_collection::EmailReminderViewer,
+ query: crate::domain::email_collection::EmailReminderQuery,
+ ) -> Result<crate::domain::email_collection::EmailReminderPage, ReminderError> {
+ crate::domain::email_collection::service::list(
+ &self.email.repo,
+ &self.email.mailbox,
+ &self.access,
+ &self.email.clock,
+ viewer,
+ query,
+ )
+ .await
+ }
+
async fn list_collection(
&self,
user: &MacroUserIdStr<'_>,
diff --git a/crates/reminders/src/domain/ports.rs b/crates/reminders/src/domain/ports.rs
index d3e3c61aa2..12f236e86b 100644
--- a/crates/reminders/src/domain/ports.rs
+++ b/crates/reminders/src/domain/ports.rs
@@ -39,6 +39,19 @@ pub trait RemindersRepo: Send + Sync + 'static {
/// The error type returned by repository operations.
type Err: std::error::Error + Send + Sync + 'static;
+ /// Coalesce private eligible email reminders before keyset pagination.
+ /// `thread_ids` optionally restricts candidates; None discovers the collection.
+ fn email_candidates(
+ &self,
+ user: &MacroUserIdStr<'_>,
+ thread_ids: Option<&[Uuid]>,
+ cursor: Option<super::email_collection::EmailReminderCursor>,
+ as_of: DateTime<Utc>,
+ limit: u32,
+ ) -> impl Future<
+ Output = Result<Vec<super::email_collection::EmailReminderCandidate>, Self::Err>,
+ > + Send;
+
/// Read private native rows in actionable-first order, with filters and cursor applied before the limit.
fn list_collection(
&self,
@@ -306,6 +319,20 @@ pub trait ReminderDispatch: Send + Sync + 'static {
/// Inbound service port: the reminders API used by drivers (HTTP).
pub trait RemindersService: Send + Sync + 'static {
+ /// Original email identities with current private reminder work.
+ fn list_email_reminders(
+ &self,
+ _viewer: super::email_collection::EmailReminderViewer,
+ _query: super::email_collection::EmailReminderQuery,
+ ) -> impl Future<Output = Result<super::email_collection::EmailReminderPage, ReminderError>> + Send
+ {
+ async {
+ Err(ReminderError::BadRequest(
+ "Email reminders are unavailable".into(),
+ ))
+ }
+ }
+
/// Paginate the caller's private Reminders collection with native source metadata.
fn list_collection(
&self,
diff --git a/crates/reminders/src/domain/service/test.rs b/crates/reminders/src/domain/service/test.rs
index 5d2a7e26a9..272c9611e6 100644
--- a/crates/reminders/src/domain/service/test.rs
+++ b/crates/reminders/src/domain/service/test.rs
@@ -202,6 +202,16 @@ fn sort_key(reminder: &Reminder) -> (DateTime<Utc>, DateTime<Utc>, Uuid) {
}
impl RemindersRepo for FakeRemindersRepo {
+ async fn email_candidates(
+ &self,
+ _user: &MacroUserIdStr<'_>,
+ _ids: Option<&[Uuid]>,
+ _cursor: Option<crate::domain::email_collection::EmailReminderCursor>,
+ _as_of: DateTime<Utc>,
+ _limit: u32,
+ ) -> Result<Vec<crate::domain::email_collection::EmailReminderCandidate>, Self::Err> {
+ unreachable!("generic reminder tests do not read email collections")
+ }
async fn list_collection(
&self,
user: &MacroUserIdStr<'_>,
diff --git a/crates/reminders/src/inbound/axum_router.rs b/crates/reminders/src/inbound/axum_router.rs
index a564bacaea..3b7a1acc69 100644
--- a/crates/reminders/src/inbound/axum_router.rs
+++ b/crates/reminders/src/inbound/axum_router.rs
@@ -1,5 +1,7 @@
//! Axum router for reminders endpoints.
+pub mod email_collection;
+
#[cfg(test)]
mod test;
@@ -99,6 +101,10 @@ where
T: Send + Sync + 'static,
{
Router::new()
+ .route(
+ "/email/collection",
+ get(email_collection::list_email_reminders_handler::<S, Eas, Auth>),
+ )
.route(
"/email/{thread_id}",
get(get_email_followup_handler::<S, Eas, Auth>)
diff --git a/crates/reminders/src/inbound/axum_router/email_collection.rs b/crates/reminders/src/inbound/axum_router/email_collection.rs
new file mode 100644
index 0000000000..b562a40d34
--- /dev/null
+++ b/crates/reminders/src/inbound/axum_router/email_collection.rs
@@ -0,0 +1,116 @@
+//! Authenticated read adapters for original-email reminder surfaces.
+use super::*;
+use crate::domain::email_collection::{EmailReminderPage, EmailReminderQuery, EmailReminderViewer};
+use email::domain::followup::ReminderThreadFilter;
+
+/// Email facets and cursor. Repeated inbox IDs select those inboxes only.
+#[derive(Debug, Default, Deserialize, utoipa::IntoParams)]
+#[serde(rename_all = "camelCase")]
+pub struct EmailReminderParams {
+ /// Selected inboxes; omission selects all accessible inboxes.
+ pub inbox_ids: Option<Vec<Uuid>>,
+ /// Explicitly empty inbox selection.
+ pub no_inboxes: Option<bool>,
+ /// Email archive filter, independent of reminder completion.
+ pub done: Option<bool>,
+ /// Email read status.
+ pub read: Option<bool>,
+ /// Restrict to calendar mail.
+ pub calendar: Option<bool>,
+ /// Repeated property-definition:select-option UUID pairs.
+ pub tags: Option<Vec<String>>,
+ /// Repeated attachment categories: pdf, image, document.
+ pub attachments: Option<Vec<String>>,
+ /// Continuation from the previous page.
+ pub cursor: Option<String>,
+ /// Maximum rows (1–100).
+ #[param(minimum = 1, maximum = 100)]
+ pub limit: Option<u32>,
+}
+
+fn viewer<Auth: MacroAuthorizationService>(
+ user: MacroAuthorizationExtractor<Auth, UserOrInternal>,
+) -> EmailReminderViewer {
+ EmailReminderViewer {
+ user_id: user.authorization.user.macro_user_id.clone(),
+ org_id: user
+ .authorization
+ .user
+ .user_context
+ .organization_id
+ .map(i64::from),
+ }
+}
+
+/// List original email threads with caller-private reminder work.
+#[utoipa::path(get, tag = "reminders", operation_id = "list_email_reminders",
+ path = "/reminders/email/collection", params(EmailReminderParams),
+ responses((status = 200, body = EmailReminderPage), (status = 400, body = ErrorResponse),
+ (status = 401, body = ErrorResponse), (status = 500, body = ErrorResponse)))]
+#[tracing::instrument(err, skip_all)]
+pub async fn list_email_reminders_handler<
+ S: RemindersService,
+ Eas: EntityAccessService,
+ Auth: MacroAuthorizationService,
+>(
+ State(state): State<RemindersRouterState<S, Eas, Auth>>,
+ user: MacroAuthorizationExtractor<Auth, UserOrInternal>,
+ Query(params): Query<EmailReminderParams>,
+) -> Result<Json<EmailReminderPage>, ReminderError> {
+ let tags = params
+ .tags
+ .unwrap_or_default()
+ .into_iter()
+ .map(|pair| {
+ let (property, option) = pair
+ .split_once(':')
+ .ok_or_else(|| ReminderError::BadRequest("Invalid tag filter".into()))?;
+ Ok((
+ property
+ .parse()
+ .map_err(|_| ReminderError::BadRequest("Invalid tag property".into()))?,
+ option
+ .parse()
+ .map_err(|_| ReminderError::BadRequest("Invalid tag option".into()))?,
+ ))
+ })
+ .collect::<Result<Vec<_>, ReminderError>>()?;
+ let attachments = params
+ .attachments
+ .unwrap_or_default()
+ .into_iter()
+ .map(|kind| {
+ use email::domain::followup::ReminderAttachmentKind;
+ match kind.as_str() {
+ "pdf" => Ok(ReminderAttachmentKind::Pdf),
+ "image" => Ok(ReminderAttachmentKind::Image),
+ "document" => Ok(ReminderAttachmentKind::Document),
+ _ => Err(ReminderError::BadRequest(
+ "Invalid attachment category".into(),
+ )),
+ }
+ })
+ .collect::<Result<Vec<_>, _>>()?;
+ let query = EmailReminderQuery {
+ filters: ReminderThreadFilter {
+ inbox_ids: if params.no_inboxes == Some(true) {
+ Some(Vec::new())
+ } else {
+ params.inbox_ids
+ },
+ done: params.done,
+ read: params.read,
+ calendar: params.calendar.unwrap_or(false),
+ tags,
+ attachments,
+ },
+ cursor: params.cursor,
+ limit: params.limit,
+ };
+ Ok(Json(
+ state
+ .service
+ .list_email_reminders(viewer(user), query)
+ .await?,
+ ))
+}
diff --git a/crates/reminders/src/inbound/axum_router/test.rs b/crates/reminders/src/inbound/axum_router/test.rs
index 213b09392e..133fbaef35 100644
--- a/crates/reminders/src/inbound/axum_router/test.rs
+++ b/crates/reminders/src/inbound/axum_router/test.rs
@@ -22,6 +22,9 @@ use uuid::Uuid;
use super::*;
use crate::domain::models::{ReminderCursor, ReminderForSoup, ReminderPage, SoupReminderQuery};
+#[cfg(feature = "postgres")]
+mod email_collection;
+
const USER_ID: &str = "macro|[email protected]";
const VALID_JWT: &str = "valid";
/// The one entity the fake access service grants view access to.
@@ -70,6 +73,7 @@ impl MacroAuthorizationService for FakeAuthorizationService {
#[derive(Clone, Default)]
struct FakeEntityAccessService {
receipts_minted: Arc<Mutex<Vec<(String, EntityType)>>>,
+ allowed_emails: Option<Arc<Mutex<std::collections::HashSet<Uuid>>>>,
/// Error returned for anything other than [`ACCESSIBLE_DOC`]. `None` means
/// [`AccessError::Unauthorized`], which is the common case.
denial: Option<fn() -> AccessError>,
@@ -119,7 +123,13 @@ impl EntityAccessService for FakeEntityAccessService {
.expect("mint log poisoned")
.push((entity_id.to_string(), entity_type));
- if entity_id != ACCESSIBLE_DOC {
+ let allowed_email = entity_type == EntityType::EmailThread
+ && self.allowed_emails.as_ref().is_some_and(|ids| {
+ entity_id
+ .parse()
+ .is_ok_and(|id| ids.lock().unwrap().contains(&id))
+ });
+ if entity_id != ACCESSIBLE_DOC && !allowed_email {
return Err(self.denial.map_or(AccessError::Unauthorized, |make| make()));
}
diff --git a/crates/reminders/src/inbound/axum_router/test/email_collection.rs b/crates/reminders/src/inbound/axum_router/test/email_collection.rs
new file mode 100644
index 0000000000..5aed52704a
--- /dev/null
+++ b/crates/reminders/src/inbound/axum_router/test/email_collection.rs
@@ -0,0 +1,334 @@
+//! Exercise scan/fill against real grouped reminder storage and explicit access decisions.
+use super::*;
+use crate::{
+ domain::{
+ email_collection::{EmailReminderQuery, EmailReminderViewer, service},
+ models::NewReminder,
+ ports::{Clock, RemindersRepo},
+ },
+ outbound::pg_reminders_repo::PgRemindersRepo,
+};
+use email::domain::{
+ followup::{EmailFollowupMailbox, FollowupThread, ReminderThreadFilter},
+ models::EmailErr,
+};
+use entity_access::domain::models::ViewAccessLevel;
+use macro_db_migrator::MACRO_DB_MIGRATIONS;
+use sqlx::PgPool;
+use std::collections::HashSet;
+
+#[derive(Clone, Default)]
+struct Mailbox {
+ rejected: HashSet<Uuid>,
+ fail: bool,
+}
+impl EmailFollowupMailbox for Mailbox {
+ async fn reminder_threads(
+ &self,
+ _: MacroUserIdStr<'static>,
+ receipts: Vec<EntityAccessReceipt<ViewAccessLevel>>,
+ _: &ReminderThreadFilter,
+ ) -> Result<Vec<Uuid>, EmailErr> {
+ if self.fail {
+ return Err(EmailErr::RepoErr(
+ std::io::Error::other("temporary hydration failure").into(),
+ ));
+ }
+ // Deliberately reverse email hydration order; the collection must retain schedule order.
+ Ok(receipts
+ .into_iter()
+ .rev()
+ .map(|r| r.entity().entity_id.parse().unwrap())
+ .filter(|id| !self.rejected.contains(id))
+ .collect())
+ }
+ async fn followup_thread(
+ &self,
+ _: MacroUserIdStr<'static>,
+ _: Uuid,
+ ) -> Result<Option<FollowupThread>, EmailErr> {
+ unreachable!()
+ }
+ async fn set_followup_inbox(
+ &self,
+ _: MacroUserIdStr<'static>,
+ _: Uuid,
+ _: Uuid,
+ _: bool,
+ _: Option<DateTime<Utc>>,
+ ) -> Result<(), EmailErr> {
+ unreachable!()
+ }
+}
+struct FixedClock;
+impl Clock for FixedClock {
+ fn now(&self) -> DateTime<Utc> {
+ instant(1, 12)
+ }
+}
+fn viewer() -> EmailReminderViewer {
+ EmailReminderViewer {
+ user_id: MacroUserIdStr::parse_from_str(USER_ID).unwrap(),
+ org_id: None,
+ }
+}
+fn query(cursor: Option<String>, limit: u32) -> EmailReminderQuery {
+ EmailReminderQuery {
+ filters: ReminderThreadFilter::default(),
+ cursor,
+ limit: Some(limit),
+ }
+}
+async fn setup(
+ pool: PgPool,
+ count: usize,
+) -> (PgRemindersRepo, FakeEntityAccessService, Vec<Uuid>) {
+ let macro_id = Uuid::now_v7();
+ sqlx::query!(
+ r#"INSERT INTO macro_user (id, username, email, stripe_customer_id) VALUES ($1,$2,$2,$2)"#,
+ macro_id,
+ USER_ID
+ )
+ .execute(&pool)
+ .await
+ .unwrap();
+ sqlx::query!(
+ r#"INSERT INTO "User" (id,email,macro_user_id) VALUES ($1,$1,$2)"#,
+ USER_ID,
+ macro_id
+ )
+ .execute(&pool)
+ .await
+ .unwrap();
+ let repo = PgRemindersRepo::new(pool);
+ let ids: Vec<_> = (0..count)
+ .map(|i| Uuid::from_u128(i as u128 + 100))
+ .collect();
+ for (i, id) in ids.iter().enumerate() {
+ let when = instant(2, 12) + chrono::Duration::seconds(i as i64);
+ repo.create_reminder(
+ &viewer().user_id,
+ &NewReminder {
+ description: format!("private {i}"),
+ entity: Some(EntityType::EmailThread.with_entity_string(id.to_string())),
+ schedule: ReminderSchedule::Once { remind_at: when },
+ next_run_at: when,
+ },
+ )
+ .await
+ .unwrap();
+ }
+ let access = FakeEntityAccessService {
+ allowed_emails: Some(Arc::new(Mutex::new(ids.iter().copied().collect()))),
+ ..Default::default()
+ };
+ (repo, access, ids)
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn scan_fills_past_long_denied_and_filtered_prefix_without_reordering(pool: PgPool) {
+ let (repo, access, ids) = setup(pool, 260).await;
+ for id in &ids[..125] {
+ access
+ .allowed_emails
+ .as_ref()
+ .unwrap()
+ .lock()
+ .unwrap()
+ .remove(id);
+ }
+ let mailbox = Mailbox {
+ rejected: ids[125..230].iter().copied().collect(),
+ fail: false,
+ };
+ let page = service::list(
+ &repo,
+ &mailbox,
+ &access,
+ &FixedClock,
+ viewer(),
+ query(None, 15),
+ )
+ .await
+ .unwrap();
+ assert_eq!(
+ page.items.iter().map(|i| i.thread_id).collect::<Vec<_>>(),
+ ids[230..245]
+ );
+ let next = service::list(
+ &repo,
+ &mailbox,
+ &access,
+ &FixedClock,
+ viewer(),
+ query(page.next_cursor, 15),
+ )
+ .await
+ .unwrap();
+ assert_eq!(
+ next.items.iter().map(|i| i.thread_id).collect::<Vec<_>>(),
+ ids[245..]
+ );
+ assert!(next.next_cursor.is_none());
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn scan_budget_returns_empty_advancing_continuation_and_reauthorizes(pool: PgPool) {
+ let (repo, access, ids) = setup(pool, 507).await;
+ access
+ .allowed_emails
+ .as_ref()
+ .unwrap()
+ .lock()
+ .unwrap()
+ .retain(|id| ids[500..].contains(id));
+ let page = service::list(
+ &repo,
+ &Mailbox::default(),
+ &access,
+ &FixedClock,
+ viewer(),
+ query(None, 100),
+ )
+ .await
+ .unwrap();
+ assert!(page.items.is_empty());
+ let cursor = page.next_cursor.unwrap();
+ assert_eq!(access.minted().len(), 500, "request scan work is bounded");
+ access
+ .allowed_emails
+ .as_ref()
+ .unwrap()
+ .lock()
+ .unwrap()
+ .remove(&ids[500]);
+ let page = service::list(
+ &repo,
+ &Mailbox::default(),
+ &access,
+ &FixedClock,
+ viewer(),
+ query(Some(cursor.clone()), 100),
+ )
+ .await
+ .unwrap();
+ assert_eq!(
+ page.items.iter().map(|i| i.thread_id).collect::<Vec<_>>(),
+ ids[501..]
+ );
+ assert!(page.next_cursor.is_none());
+ let mut changed = query(Some(cursor), 100);
+ changed.filters.inbox_ids = Some(vec![Uuid::from_u128(9)]);
+ assert!(matches!(
+ service::list(
+ &repo,
+ &Mailbox::default(),
+ &access,
+ &FixedClock,
+ viewer(),
+ changed
+ )
+ .await,
+ Err(ReminderError::BadRequest(_))
+ ));
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn scan_mid_batch_and_exact_boundary_never_skip_overflow(pool: PgPool) {
+ let (repo, access, ids) = setup(pool, 203).await;
+ let mut cursor = None;
+ let mut seen = Vec::new();
+ for _ in 0..5 {
+ let page = service::list(
+ &repo,
+ &Mailbox::default(),
+ &access,
+ &FixedClock,
+ viewer(),
+ query(cursor, 50),
+ )
+ .await
+ .unwrap();
+ seen.extend(page.items.into_iter().map(|i| i.thread_id));
+ cursor = page.next_cursor;
+ if cursor.is_none() {
+ break;
+ }
+ }
+ assert_eq!(seen, ids);
+ assert!(cursor.is_none());
+ let first = service::list(
+ &repo,
+ &Mailbox::default(),
+ &access,
+ &FixedClock,
+ viewer(),
+ query(None, 100),
+ )
+ .await
+ .unwrap();
+ let second = service::list(
+ &repo,
+ &Mailbox::default(),
+ &access,
+ &FixedClock,
+ viewer(),
+ query(first.next_cursor, 100),
+ )
+ .await
+ .unwrap();
+ assert_eq!(second.items[0].thread_id, ids[100]);
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn scan_fails_retryably_on_access_or_hydration_failure(pool: PgPool) {
+ let (repo, mut access, ids) = setup(pool, 3).await;
+ let error = service::list(
+ &repo,
+ &Mailbox {
+ fail: true,
+ ..Default::default()
+ },
+ &access,
+ &FixedClock,
+ viewer(),
+ query(None, 100),
+ )
+ .await;
+ assert!(matches!(error, Err(ReminderError::Internal(_))));
+ access
+ .allowed_emails
+ .as_ref()
+ .unwrap()
+ .lock()
+ .unwrap()
+ .remove(&ids[1]);
+ access.denial = Some(|| AccessError::internal("temporary authorization outage"));
+ assert!(matches!(
+ service::list(
+ &repo,
+ &Mailbox::default(),
+ &access,
+ &FixedClock,
+ viewer(),
+ query(None, 100)
+ )
+ .await,
+ Err(ReminderError::Internal(_))
+ ));
+ access.denial = None;
+ let page = service::list(
+ &repo,
+ &Mailbox::default(),
+ &access,
+ &FixedClock,
+ viewer(),
+ query(None, 100),
+ )
+ .await
+ .unwrap();
+ assert_eq!(
+ page.items.iter().map(|i| i.thread_id).collect::<Vec<_>>(),
+ vec![ids[0], ids[2]]
+ );
+}
diff --git a/crates/reminders/src/outbound/pg_reminders_repo.rs b/crates/reminders/src/outbound/pg_reminders_repo.rs
index 59e0330f5c..ed6371d31c 100644
--- a/crates/reminders/src/outbound/pg_reminders_repo.rs
+++ b/crates/reminders/src/outbound/pg_reminders_repo.rs
@@ -1,6 +1,7 @@
//! PostgreSQL implementation of the [`RemindersRepo`] port.
mod collection;
+mod email_collection;
mod email_followup;
#[cfg(test)]
mod test;
@@ -97,6 +98,7 @@ pub enum RemindersRepoErr {
/// A `reminder` row, before the schedule columns are folded into a
/// [`ReminderSchedule`].
+#[derive(serde::Deserialize)]
struct ReminderRow {
id: Uuid,
description: String,
@@ -249,6 +251,17 @@ fn schedule_columns(
}
impl RemindersRepo for PgRemindersRepo {
+ async fn email_candidates(
+ &self,
+ user: &MacroUserIdStr<'_>,
+ thread_ids: Option<&[Uuid]>,
+ cursor: Option<crate::domain::email_collection::EmailReminderCursor>,
+ as_of: DateTime<Utc>,
+ limit: u32,
+ ) -> Result<Vec<crate::domain::email_collection::EmailReminderCandidate>, Self::Err> {
+ self.read_email_candidates(user, thread_ids, cursor, as_of, limit)
+ .await
+ }
async fn list_collection(
&self,
user: &MacroUserIdStr<'_>,
diff --git a/crates/reminders/src/outbound/pg_reminders_repo/email_collection.rs b/crates/reminders/src/outbound/pg_reminders_repo/email_collection.rs
new file mode 100644
index 0000000000..d2ad6fc307
--- /dev/null
+++ b/crates/reminders/src/outbound/pg_reminders_repo/email_collection.rs
@@ -0,0 +1,127 @@
+use chrono::{DateTime, Utc};
+use macro_user_id::user_id::MacroUserIdStr;
+use serde::Deserialize;
+use uuid::Uuid;
+
+use super::{PgRemindersRepo, ReminderRow, RemindersRepoErr};
+use crate::domain::{
+ collection::ReminderCollectionRow,
+ email_collection::{EmailReminderCandidate, EmailReminderCursor, EmailReminderSummary},
+ email_followup::FollowupRecord,
+};
+
+#[derive(Deserialize)]
+struct StoredEmailReminder {
+ #[serde(flatten)]
+ reminder: ReminderRow,
+ followup: Option<serde_json::Value>,
+ has_followup: bool,
+}
+
+impl PgRemindersRepo {
+ pub(super) async fn read_email_candidates(
+ &self,
+ user: &MacroUserIdStr<'_>,
+ thread_ids: Option<&[Uuid]>,
+ cursor: Option<EmailReminderCursor>,
+ as_of: DateTime<Utc>,
+ limit: u32,
+ ) -> Result<Vec<EmailReminderCandidate>, RemindersRepoErr> {
+ let rows = sqlx::query!(
+ r#"
+ WITH eligible AS MATERIALIZED (
+ SELECT r.id, r.description, r.entity_type, r.entity_id,
+ r.remind_at, r.cron, r.timezone, r.next_run_at, r.enabled,
+ r.completed_at, r.created_at, r.updated_at, f.payload AS followup,
+ (f.reminder_id IS NOT NULL) AS has_followup
+ FROM reminder r
+ LEFT JOIN reminder_email_followup f ON f.reminder_id = r.id AND f.user_id = $1
+ WHERE r.user_id = $1 AND r.entity_type = 'email_thread' AND r.entity_id IS NOT NULL
+ AND ($2::uuid[] IS NULL OR r.entity_id = ANY($2))
+ AND CASE WHEN f.reminder_id IS NOT NULL THEN
+ f.state IN ('archiving', 'pending', 'returning')
+ OR (f.state = 'returned' AND r.completed_at IS NULL)
+ ELSE
+ (r.enabled AND (r.completed_at IS NULL OR r.cron IS NOT NULL))
+ OR (r.cron IS NULL AND r.completed_at IS NULL AND r.next_run_at <= $3)
+ END
+ ), grouped AS (
+ SELECT entity_id, MIN(next_run_at) AS next_run_at
+ FROM eligible GROUP BY entity_id
+ ), candidates AS (
+ SELECT entity_id, next_run_at FROM grouped
+ WHERE $4::timestamptz IS NULL OR (next_run_at, entity_id) > ($4, $5)
+ ORDER BY next_run_at, entity_id LIMIT $6
+ )
+ SELECT c.entity_id AS "thread_id!", c.next_run_at AS "next_run_at!",
+ jsonb_agg(to_jsonb(r) ORDER BY r.next_run_at, r.created_at, r.id) AS "reminders!"
+ FROM candidates c JOIN eligible r ON r.entity_id = c.entity_id
+ GROUP BY c.entity_id, c.next_run_at
+ ORDER BY c.next_run_at, c.entity_id
+ "#,
+ user.as_ref(),
+ thread_ids,
+ as_of,
+ cursor.map(|c| c.next_run_at),
+ cursor.map(|c| c.thread_id),
+ i64::from(limit),
+ )
+ .fetch_all(&self.pool)
+ .await?;
+ Ok(rows
+ .into_iter()
+ .map(|row| {
+ let mut decoded = Vec::new();
+ if let Some(values) = row.reminders.as_array() {
+ for value in values {
+ let item = (|| {
+ let stored: StoredEmailReminder =
+ serde_json::from_value(value.clone()).ok()?;
+ let followup = match (stored.has_followup, stored.followup) {
+ (true, Some(payload)) => {
+ let record: FollowupRecord =
+ serde_json::from_value(payload).ok()?;
+ if record.user_id.as_ref() != user.as_ref()
+ || record.followup.thread_id != row.thread_id
+ || record.followup.reminder_id != stored.reminder.id
+ {
+ return None;
+ }
+ Some(record.followup)
+ }
+ (true, None) => return None,
+ (false, _) => None,
+ };
+ Some(ReminderCollectionRow {
+ reminder: stored.reminder.into_reminder().ok()?,
+ reference: None,
+ email_followup: followup,
+ })
+ })();
+ if let Some(item) = item {
+ decoded.push(item);
+ } else {
+ tracing::warn!("skipping malformed email reminder projection");
+ }
+ }
+ }
+ let count = decoded.len() as u32;
+ EmailReminderCandidate {
+ cursor: EmailReminderCursor {
+ as_of,
+ next_run_at: row.next_run_at,
+ thread_id: row.thread_id,
+ },
+ summary: decoded
+ .into_iter()
+ .next()
+ .map(|nearest| EmailReminderSummary {
+ thread_id: row.thread_id,
+ nearest,
+ count,
+ }),
+ }
+ })
+ .collect())
+ }
+}
diff --git a/crates/reminders/src/outbound/pg_reminders_repo/email_followup/test.rs b/crates/reminders/src/outbound/pg_reminders_repo/email_followup/test.rs
index 1d7c49dc2d..e9639509e4 100644
--- a/crates/reminders/src/outbound/pg_reminders_repo/email_followup/test.rs
+++ b/crates/reminders/src/outbound/pg_reminders_repo/email_followup/test.rs
@@ -95,6 +95,18 @@ struct Mail {
reply_on_archive: Option<DateTime<Utc>>,
}
impl EmailFollowupMailbox for Mailbox {
+ async fn reminder_threads(
+ &self,
+ _user: MacroUserIdStr<'static>,
+ _receipts: Vec<
+ entity_access::domain::models::EntityAccessReceipt<
+ entity_access::domain::models::ViewAccessLevel,
+ >,
+ >,
+ _filters: &email::domain::followup::ReminderThreadFilter,
+ ) -> Result<Vec<Uuid>, EmailErr> {
+ unreachable!("lifecycle tests do not read email collections")
+ }
async fn followup_thread(
&self,
actor: MacroUserIdStr<'static>,
diff --git a/crates/reminders/src/outbound/pg_reminders_repo/test.rs b/crates/reminders/src/outbound/pg_reminders_repo/test.rs
index 230dab501a..55392b4444 100644
--- a/crates/reminders/src/outbound/pg_reminders_repo/test.rs
+++ b/crates/reminders/src/outbound/pg_reminders_repo/test.rs
@@ -1,5 +1,6 @@
use chrono::{Duration, TimeZone};
mod collection;
+mod email_collection;
use chrono_tz::America::New_York;
use macro_db_migrator::MACRO_DB_MIGRATIONS;
use macro_user_id::user_id::MacroUserIdStr;
diff --git a/crates/reminders/src/outbound/pg_reminders_repo/test/email_collection.rs b/crates/reminders/src/outbound/pg_reminders_repo/test/email_collection.rs
new file mode 100644
index 0000000000..ad76ffe6d8
--- /dev/null
+++ b/crates/reminders/src/outbound/pg_reminders_repo/test/email_collection.rs
@@ -0,0 +1,306 @@
+use super::*;
+use crate::domain::email_followup::{
+ EmailFollowup, EmailFollowupRepo, EmailReminderCondition, FollowupRecord, FollowupState,
+};
+use email::domain::followup::ReplyBaseline;
+
+async fn attached(
+ repo: &PgRemindersRepo,
+ owner: &str,
+ thread: Uuid,
+ time: DateTime<Utc>,
+) -> Reminder {
+ let mut new = new_reminder("email work", once_at(time));
+ new.entity = Some(EntityType::EmailThread.with_entity_string(thread.to_string()));
+ repo.create_reminder(&user(owner), &new).await.unwrap()
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn email_candidates_dedupe_before_pagination_and_keep_private(pool: PgPool) {
+ insert_user(&pool, USER_A).await;
+ insert_user(&pool, USER_B).await;
+ let repo = PgRemindersRepo::new(pool);
+ let now = at(2026, 10, 2, 12);
+ let thread = macro_uuid::generate_uuid_v7();
+ let nearest = attached(&repo, USER_A, thread, now).await;
+ for i in 0..105 {
+ attached(&repo, USER_A, thread, now + Duration::seconds(i + 1)).await;
+ }
+ attached(&repo, USER_B, thread, now - Duration::hours(1)).await;
+ for i in 0..105 {
+ attached(
+ &repo,
+ USER_A,
+ macro_uuid::generate_uuid_v7(),
+ now + Duration::days(1) + Duration::seconds(i),
+ )
+ .await;
+ }
+ let first = repo
+ .email_candidates(&user(USER_A), None, None, now, 100)
+ .await
+ .unwrap();
+ assert_eq!(first.len(), 100);
+ let summary = first[0].summary.as_ref().unwrap();
+ assert_eq!(summary.thread_id, thread);
+ assert_eq!(summary.count, 106);
+ assert_eq!(summary.nearest.reminder.id, nearest.id);
+ let second = repo
+ .email_candidates(
+ &user(USER_A),
+ None,
+ Some(first.last().unwrap().cursor),
+ now,
+ 100,
+ )
+ .await
+ .unwrap();
+ assert_eq!(second.len(), 6);
+ let ids: std::collections::HashSet<_> = first
+ .iter()
+ .chain(second.iter())
+ .map(|row| row.cursor.thread_id)
+ .collect();
+ assert_eq!(ids.len(), 106);
+ let batch = repo
+ .email_candidates(&user(USER_B), Some(&[thread]), None, now, 100)
+ .await
+ .unwrap();
+ assert_eq!(batch.len(), 1);
+ assert_eq!(batch[0].summary.as_ref().unwrap().count, 1);
+ assert!(
+ repo.email_candidates(&user(USER_A), Some(&[]), None, now, 100)
+ .await
+ .unwrap()
+ .is_empty()
+ );
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn email_candidates_generic_completion_and_disabled_state(pool: PgPool) {
+ insert_user(&pool, USER_A).await;
+ let repo = PgRemindersRepo::new(pool);
+ let now = at(2026, 10, 2, 12);
+ let thread = macro_uuid::generate_uuid_v7();
+ let future = attached(&repo, USER_A, thread, now + Duration::days(1)).await;
+ repo.update_reminder(
+ &user(USER_A),
+ future.id,
+ &ReminderUpdate {
+ enabled: Some(false),
+ ..Default::default()
+ },
+ )
+ .await
+ .unwrap();
+ assert!(
+ repo.email_candidates(&user(USER_A), None, None, now, 100)
+ .await
+ .unwrap()
+ .is_empty()
+ );
+ let due = attached(&repo, USER_A, thread, now - Duration::hours(1)).await;
+ repo.update_reminder(
+ &user(USER_A),
+ due.id,
+ &ReminderUpdate {
+ enabled: Some(false),
+ ..Default::default()
+ },
+ )
+ .await
+ .unwrap();
+ assert_eq!(
+ repo.email_candidates(&user(USER_A), None, None, now, 100)
+ .await
+ .unwrap()[0]
+ .summary
+ .as_ref()
+ .unwrap()
+ .nearest
+ .reminder
+ .id,
+ due.id
+ );
+ repo.update_reminder(
+ &user(USER_A),
+ due.id,
+ &ReminderUpdate {
+ completed: Some(true),
+ ..Default::default()
+ },
+ )
+ .await
+ .unwrap();
+ let mut repeating = new_reminder("recurring", recurring());
+ repeating.entity = Some(EntityType::EmailThread.with_entity_string(thread.to_string()));
+ repeating.next_run_at = now + Duration::days(1);
+ let repeating = repo
+ .create_reminder(&user(USER_A), &repeating)
+ .await
+ .unwrap();
+ repo.update_reminder(
+ &user(USER_A),
+ repeating.id,
+ &ReminderUpdate {
+ completed: Some(true),
+ ..Default::default()
+ },
+ )
+ .await
+ .unwrap();
+ let summary = repo
+ .email_candidates(&user(USER_A), None, None, now, 100)
+ .await
+ .unwrap()
+ .remove(0)
+ .summary
+ .unwrap();
+ assert_eq!(summary.count, 1);
+ assert_eq!(summary.nearest.reminder.id, repeating.id);
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn email_candidates_workflow_membership_is_not_archive_status(pool: PgPool) {
+ insert_user(&pool, USER_A).await;
+ let repo = PgRemindersRepo::new(pool);
+ let now = at(2026, 10, 2, 12);
+ for state in [
+ FollowupState::Archiving,
+ FollowupState::Pending,
+ FollowupState::Returning,
+ FollowupState::Returned,
+ FollowupState::Cancelled,
+ FollowupState::Removed,
+ ] {
+ let thread = macro_uuid::generate_uuid_v7();
+ let reminder = attached(&repo, USER_A, thread, now + Duration::hours(1)).await;
+ let record = FollowupRecord {
+ followup: EmailFollowup {
+ reminder_id: reminder.id,
+ thread_id: thread,
+ link_id: macro_uuid::generate_uuid_v7(),
+ condition: EmailReminderCondition::IfNoReply,
+ remind_at: reminder.next_run_at,
+ revision: macro_uuid::generate_uuid_v7(),
+ state,
+ },
+ user_id: user(USER_A).into_owned(),
+ baseline: ReplyBaseline {
+ captured_at: now,
+ message_ids: vec![],
+ },
+ original_inbox_visible: true,
+ original_returned_at: None,
+ restore_original: false,
+ restore_inbox_visible: true,
+ cancel_on_restore: false,
+ };
+ repo.save_followup(&record, None, None).await.unwrap();
+ let rows = repo
+ .email_candidates(&user(USER_A), Some(&[thread]), None, now, 100)
+ .await
+ .unwrap();
+ assert_eq!(
+ !rows.is_empty(),
+ state.active() || state == FollowupState::Returned,
+ "{state:?}"
+ );
+ if state == FollowupState::Returned {
+ repo.update_reminder(
+ &user(USER_A),
+ reminder.id,
+ &ReminderUpdate {
+ completed: Some(true),
+ ..Default::default()
+ },
+ )
+ .await
+ .unwrap();
+ assert!(
+ repo.email_candidates(&user(USER_A), Some(&[thread]), None, now, 100)
+ .await
+ .unwrap()
+ .is_empty()
+ );
+ }
+ }
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn email_candidates_skip_malformed_schedule_without_losing_group_or_cursor(pool: PgPool) {
+ insert_user(&pool, USER_A).await;
+ let repo = PgRemindersRepo::new(pool.clone());
+ let now = at(2026, 10, 2, 12);
+ let thread = macro_uuid::generate_uuid_v7();
+ let mut malformed = new_reminder("bad zone", recurring());
+ malformed.entity = Some(EntityType::EmailThread.with_entity_string(thread.to_string()));
+ let bad = repo
+ .create_reminder(&user(USER_A), &malformed)
+ .await
+ .unwrap();
+ sqlx::query!(
+ "UPDATE reminder SET timezone = 'not/a/zone' WHERE id = $1",
+ bad.id
+ )
+ .execute(&pool)
+ .await
+ .unwrap();
+ let valid = attached(&repo, USER_A, thread, now).await;
+ let first = repo
+ .email_candidates(&user(USER_A), None, None, now, 1)
+ .await
+ .unwrap();
+ assert_eq!(
+ first[0].summary.as_ref().unwrap().nearest.reminder.id,
+ valid.id
+ );
+ assert_eq!(first[0].summary.as_ref().unwrap().count, 1);
+ repo.delete_reminder(&user(USER_A), valid.id).await.unwrap();
+ let later_thread = macro_uuid::generate_uuid_v7();
+ attached(&repo, USER_A, later_thread, now + Duration::days(1)).await;
+ let malformed_page = repo
+ .email_candidates(&user(USER_A), None, None, now, 1)
+ .await
+ .unwrap();
+ assert!(malformed_page[0].summary.is_none());
+ let later = repo
+ .email_candidates(&user(USER_A), None, Some(malformed_page[0].cursor), now, 1)
+ .await
+ .unwrap();
+ assert_eq!(later[0].cursor.thread_id, later_thread);
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn email_candidates_never_downgrade_malformed_workflows_to_generic(pool: PgPool) {
+ insert_user(&pool, USER_A).await;
+ let repo = PgRemindersRepo::new(pool.clone());
+ let now = at(2026, 10, 2, 12);
+ for payload in [
+ serde_json::Value::Null,
+ serde_json::json!({"invalid": true}),
+ ] {
+ let thread = macro_uuid::generate_uuid_v7();
+ let mirror = attached(&repo, USER_A, thread, now).await;
+ sqlx::query!(
+ "INSERT INTO reminder_email_followup (reminder_id, user_id, thread_id, link_id, state, payload) VALUES ($1, $2, $3, $4, 'pending', $5)",
+ mirror.id, USER_A, thread, macro_uuid::generate_uuid_v7(), payload
+ ).execute(&pool).await.unwrap();
+ let rows = repo
+ .email_candidates(&user(USER_A), Some(&[thread]), None, now, 1)
+ .await
+ .unwrap();
+ assert_eq!(rows.len(), 1);
+ assert!(rows[0].summary.is_none());
+ assert_eq!(rows[0].cursor.thread_id, thread);
+ let generic = attached(&repo, USER_A, thread, now + Duration::hours(1)).await;
+ let rows = repo
+ .email_candidates(&user(USER_A), Some(&[thread]), None, now, 1)
+ .await
+ .unwrap();
+ let summary = rows[0].summary.as_ref().unwrap();
+ assert_eq!(summary.count, 1);
+ assert_eq!(summary.nearest.reminder.id, generic.id);
+ assert!(summary.nearest.email_followup.is_none());
+ }
+}
diff --git a/docs/AGENT_GUIDE/reminders.md b/docs/AGENT_GUIDE/reminders.md
index f4e95815fc..c2ff472be8 100644
--- a/docs/AGENT_GUIDE/reminders.md
+++ b/docs/AGENT_GUIDE/reminders.md
@@ -129,3 +129,42 @@ ID. Unlike generic creation, retrying the same email request cannot duplicate
it. For failure verification, intercept that endpoint and verify the time and
condition remain, no client archive request is sent, and no navigation occurs
before the server confirms the operation.
+
+## Email → Reminders
+
+With reminders enabled, **Reminders** appears beside **Scheduled** in Email's
+sidebar and mobile view selector. Scheduled still lists outgoing send-later
+messages. Email Reminders lists the original conversations with pending reminder
+work in the selected inboxes, ordered by nearest reminder occurrence. Multiple
+reminders on one conversation produce one email row; **+N** beside its clock
+indicates additional reminders. Opening the row opens its original conversation.
+
+Email archive status does not determine reminder membership. A snoozed email is
+already archived and remains here while its follow-up is pending; returned
+follow-ups remain until their reminder occurrence is dealt with. Cancelled or
+removed follow-ups disappear. Read, Done, Calendar, Tags and attachment filters
+apply to the original conversation before pagination. Text search is unavailable
+in this view; entering or leaving clears its saved text search. Back/forward and
+reload retain the Email tab and selected inbox scope.
+
+Clocks in this dedicated tab use the private reminder metadata returned with
+its collection pages; native email hydration supplies the original row content.
+Other Email and Soup views do not add reminder clocks or batch summary requests.
+The email check still archives/unarchives the email independently of its clock. Click, tap or keyboard-activate the clock to open the
+existing reminder editor; Cancel returns focus to that clock when it still exists.
+Returned and in-progress workflow labels describe their current state rather than
+claiming a new future firing.
+
+For verification, use more than 100 reminders, a long prefix excluded by the
+selected inbox/filter, several reminders on one email, and caller/account isolation. A sparse page can still have a
+**Load more** continuation. Follow it rather than treating that page as the end.
+A final page stays loading until its original email rows hydrate. If that page
+fails, earlier rows remain with **Couldn’t load more email. Try again**; retry
+loads the failed page without skipping ahead. In Email, Tab from the grid moves
+through native row controls; Enter on a clock opens its editor without opening
+the email. An open editor keeps the reminder selected at activation even if a
+collection refresh chooses a different nearest reminder.
+
+Check create/edit/remove/undo, reply cancellation, and due return across the Email
+Reminders list without reloading the app. Confirm ordinary Email and Soup views
+issue no reminder collection or summary requests.
diff --git a/packages/sdk/generated/storage/index.ts b/packages/sdk/generated/storage/index.ts
index 6b3d85345f..4aeef181e6 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, AnchorResponse, AnnotationIncrementalUpdate, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelParticipant, ApiChannelWithLatest, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, ApplyDatabaseOpsData, ApplyDatabaseOpsError, ApplyDatabaseOpsErrors, ApplyDatabaseOpsResponse, ApplyDatabaseOpsResponses, ApplyOpsRequest, ApplyOpsResponse, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AssignInitiativeTasksData, AssignInitiativeTasksError, AssignInitiativeTasksErrors, AssignInitiativeTasksResponse, AssignInitiativeTasksResponses, AssignTasksRequest, AssignTasksResponse, AssignTasksResult, AssignTaskStatus, AttachmentChange, AttendeeResponseStatus, Awareness, AwarenessRelay, 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, CancelSlackImportData, CancelSlackImportErrors, CancelSlackImportResponse, CancelSlackImportResponses, CardPosition, CastVerdict, CellValue, CellWrite, Channel, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelFilters, ChannelJoinCodeResponse, ChannelLabel, ChannelLabelRule, ChannelLabelsList, ChannelMessage, 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, Column, ColumnCast, ColumnChange, ColumnChangeKind, ColumnConfig, ColumnConversion, ColumnConversionRequest, ColumnDetail, ColumnKind, ColumnResult, CommandFailure, CommandRejectedMetadata, CommittedChange, CompleteSlackImportUploadsData, CompleteSlackImportUploadsErrors, CompleteSlackImportUploadsResponse, CompleteSlackImportUploadsResponses, CompleteUploads, ConferenceProvider, Conjunction, ConversationId, ConversationKind, ConversationMetadata, ConversationProgress, ConversationSeal, ConversationStatus, ConvertDatabaseColumnData, ConvertDatabaseColumnError, ConvertDatabaseColumnErrors, ConvertDatabaseColumnResponse, ConvertDatabaseColumnResponses, ConvertedCell, 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, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateDatabaseData, CreateDatabaseError, CreateDatabaseErrors, CreateDatabaseRequest, CreateDatabaseResponse, CreateDatabaseResponses, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateImport, 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, CreateSlackImportData, CreateSlackImportErrors, CreateSlackImportResponse, CreateSlackImportResponses, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateToken, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CustomSpeakerAssignment, Database, DatabaseDetail, DatabaseOp, DatabaseView, DataType, DateOperator, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorResponse, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelError, DeleteChannelLabelErrors, DeleteChannelLabelResponse, DeleteChannelLabelResponses, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, 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, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteReminderData, DeleteReminderError, DeleteReminderErrors, DeleteReminderResponse, DeleteReminderResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, 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, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmailFollowup, EmailFollowupCommand, EmailFollowupResponse, EmailReminderCondition, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EnsureStarterHandlerData, EnsureStarterHandlerErrors, EnsureStarterHandlerResponse, EnsureStarterHandlerResponses, EntityFilters, EntityKind, 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, EntityRef, 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, FilterCondition, FilterGroup, FilterNode, FilterTest, FinalizeSlackImportData, FinalizeSlackImportErrors, FinalizeSlackImportResponse, FinalizeSlackImportResponses, FolderItem, FollowupState, 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, 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, GetDatabaseData, GetDatabaseError, GetDatabaseErrors, GetDatabasePermissionsData, GetDatabasePermissionsError, GetDatabasePermissionsErrors, GetDatabasePermissionsResponse, GetDatabasePermissionsResponses, GetDatabaseQueryData, GetDatabaseQueryError, GetDatabaseQueryErrors, GetDatabaseQueryResponse, GetDatabaseQueryResponses, GetDatabaseResponse, GetDatabaseResponses, GetDatabaseRowHistoryData, GetDatabaseRowHistoryError, GetDatabaseRowHistoryErrors, GetDatabaseRowHistoryResponse, GetDatabaseRowHistoryResponses, GetDatabaseTableChangesData, GetDatabaseTableChangesError, GetDatabaseTableChangesErrors, GetDatabaseTableChangesResponse, GetDatabaseTableChangesResponses, GetDatabaseViewPositionsData, GetDatabaseViewPositionsError, GetDatabaseViewPositionsErrors, GetDatabaseViewPositionsResponse, GetDatabaseViewPositionsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, 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, GetEmailFollowupData, GetEmailFollowupError, GetEmailFollowupErrors, GetEmailFollowupResponse, GetEmailFollowupResponses, 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, 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, GetSlackImportData, GetSlackImportErrors, GetSlackImportResponse, GetSlackImportResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, 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, ImportCounters, ImportDatabaseTableData, ImportDatabaseTableError, ImportDatabaseTableErrors, ImportDatabaseTableResponse, ImportDatabaseTableResponses, ImportedAuthor, ImportError, ImportLimits, ImportPage, ImportProgress, ImportTable, ImportWarning, InferColumnTypeOutcome, InferColumnTypeRequest, InferDatabaseColumnTypeData, InferDatabaseColumnTypeError, InferDatabaseColumnTypeErrors, InferDatabaseColumnTypeResponse, InferDatabaseColumnTypeResponses, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InitialPropertyValue, InitiativeDetail, InitiativeFilters, InitiativeId, InitiativeList, InitiativeSummary, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, InviteMeetingRequest, InviteMeetingUsersRequest, Item, ItemWithUserAccessLevel, JobId, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JobStatus, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, KeySegment, Lane, LaneKey, 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, ListDatabaseColumnCastsData, ListDatabaseColumnCastsError, ListDatabaseColumnCastsErrors, ListDatabaseColumnCastsResponse, ListDatabaseColumnCastsResponses, ListDatabasesData, ListDatabasesError, ListDatabasesErrors, ListDatabasesResponse, ListDatabasesResponses, ListedDatabase, 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, ListReminderCollectionData, ListReminderCollectionError, ListReminderCollectionErrors, ListReminderCollectionResponse, ListReminderCollectionResponses, ListRemindersData, ListRemindersError, ListRemindersErrors, ListRemindersResponse, ListRemindersResponses, ListSlackImportsData, ListSlackImportsResponse, ListSlackImportsResponses, 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, Message, MessageAttachment, MessageAttachmentCreatedMetadata, MessageAttachmentRemovedMetadata, MessageChange, MessageCursor, MessageDeletedMetadata, MessageDirection, MessageEvent, MessageEventAttachment, MessageListItem, MessageMentionedMetadata, MessagePage, MessageParent, MessagePatch, MessagePatchedMetadata, MessagePostedMetadata, MessageThread, MessageThreadPreview, MessageTimelineData, MessageTimelineQuery, MessageTimelineResponse, MessageTimelineResponses, MessageTopicEvent, NewAttachment, NewColumn, NewOption, NewThreadAnchor, NewView, NotificationFilters, NotificationState, NumberOperator, OpRefusalResponse, OpResult, OptionRef, PairingDetails, Params, ParticipantRole, PatchBotRequest, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchMessageNotificationPolicy, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessage, PostMessageNotificationPolicy, PostSoupAstRequest, PostSoupRequest, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresenceOperator, PresignedUrl, PreviewSmartTagData, PreviewSmartTagError, PreviewSmartTagErrors, PreviewSmartTagResponse, PreviewSmartTagResponses, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyDefinition, PropertyDefinitionWithOptions, PropertyFilter, PropertyInput, PropertyOption, PropertyOptionValue, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, QueryDefinition, ReactionInput, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, RegisterSlackImportUploadsData, RegisterSlackImportUploadsErrors, RegisterSlackImportUploadsResponse, RegisterSlackImportUploadsResponses, RegisterUploads, Reminder, ReminderCollectionPage, ReminderCollectionRow, ReminderFilters, ReminderReference, 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, RequestedLayout, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RingStatus, RingStatusResponse, RowChange, RowChangeKind, RowChanges, RowHistoryEntry, RowHistoryResponse, RowsChange, RowsResult, S3ObjectInfo, SaveBomPart, SaveDatabaseQueryData, SaveDatabaseQueryError, SaveDatabaseQueryErrors, SaveDatabaseQueryResponse, SaveDatabaseQueryResponses, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SavedQuery, SaveQueryRequest, SearchContactsData, SearchContactsError, SearchContactsErrors, SearchContactsResponse, SearchContactsResponse2, SearchContactsResponses, SearchState, 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, SetEmailFollowupData, SetEmailFollowupError, SetEmailFollowupErrors, SetEmailFollowupResponse, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetOperator, SetPropertyValue, Sha256Digest, ShareDatabaseAwarenessData, ShareDatabaseAwarenessError, ShareDatabaseAwarenessErrors, ShareDatabaseAwarenessResponse, ShareDatabaseAwarenessResponses, SharedEmailFilter, SharePermissionV2, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SkippedCell, SlackCompleteRequest, SlackCreateRequest, SlackRegisterRequest, SlackTimestamp, SlackUserId, SmartTagChannelMatch, SmartTagPreview, SortDirection, SortKey, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordGuest, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmDomain, SoupDatabaseRowSoupPropertiesField, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupInitiativeSoupPropertiesField, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupReminderReference, SoupReminderSchedule, SoupReminderSoupPropertiesField, SoupThreadInfo, SoupThreadReply, SourceBinding, SourceId, SourceIdentity, StarterDatabase, StarterDocumentsResponse, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, Table, TableChange, TableChanged, TableChanges, TableDetail, TableResult, TableVersion, TagFilterMode, TakenId, TaskFilters, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, TextOperator, ThreadAnchor, ThreadOrigin, ThreadPatch, ThreadState, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TouchedColumn, TouchedRow, TranscribeDictationData, TranscribeDictationError, TranscribeDictationErrors, TranscribeDictationResponse, TranscribeDictationResponses, TranscribeResponse, TranscriptSegmentRequest, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingInput, UnassignInitiativeTaskData, UnassignInitiativeTaskError, UnassignInitiativeTaskErrors, UnassignInitiativeTaskResponse, UnassignInitiativeTaskResponses, UndoChangeResponse, UndoDatabaseChangeData, UndoDatabaseChangeError, UndoDatabaseChangeErrors, UndoDatabaseChangeResponse, UndoDatabaseChangeResponses, UndoOutcome, UndoRefusal, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmTeamSettingsRequest, UpdateDatabasePermissionsData, UpdateDatabasePermissionsError, UpdateDatabasePermissionsErrors, UpdateDatabasePermissionsResponse, UpdateDatabasePermissionsResponses, UpdateInitiativeData, UpdateInitiativeError, UpdateInitiativeErrors, UpdateInitiativeRequest, UpdateInitiativeResponse, UpdateInitiativeResponses, UpdateMeetingRequest, UpdateOperation, UpdateReminderData, UpdateReminderError, UpdateReminderErrors, UpdateReminderRequest, UpdateReminderResponse, UpdateReminderResponses, UpdateSharePermissionRequestV2, UploadDescriptor, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UploadGrant, UploadId, 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, VersionedTable, View, ViewChange, ViewColumn, ViewLayout, ViewPatch, ViewPosition, ViewPositionsResponse, ViewQuery, ViewResult, 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, AnchorResponse, AnnotationIncrementalUpdate, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelParticipant, ApiChannelWithLatest, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, ApplyDatabaseOpsData, ApplyDatabaseOpsError, ApplyDatabaseOpsErrors, ApplyDatabaseOpsResponse, ApplyDatabaseOpsResponses, ApplyOpsRequest, ApplyOpsResponse, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AssignInitiativeTasksData, AssignInitiativeTasksError, AssignInitiativeTasksErrors, AssignInitiativeTasksResponse, AssignInitiativeTasksResponses, AssignTasksRequest, AssignTasksResponse, AssignTasksResult, AssignTaskStatus, AttachmentChange, AttendeeResponseStatus, Awareness, AwarenessRelay, 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, CancelSlackImportData, CancelSlackImportErrors, CancelSlackImportResponse, CancelSlackImportResponses, CardPosition, CastVerdict, CellValue, CellWrite, Channel, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelFilters, ChannelJoinCodeResponse, ChannelLabel, ChannelLabelRule, ChannelLabelsList, ChannelMessage, 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, Column, ColumnCast, ColumnChange, ColumnChangeKind, ColumnConfig, ColumnConversion, ColumnConversionRequest, ColumnDetail, ColumnKind, ColumnResult, CommandFailure, CommandRejectedMetadata, CommittedChange, CompleteSlackImportUploadsData, CompleteSlackImportUploadsErrors, CompleteSlackImportUploadsResponse, CompleteSlackImportUploadsResponses, CompleteUploads, ConferenceProvider, Conjunction, ConversationId, ConversationKind, ConversationMetadata, ConversationProgress, ConversationSeal, ConversationStatus, ConvertDatabaseColumnData, ConvertDatabaseColumnError, ConvertDatabaseColumnErrors, ConvertDatabaseColumnResponse, ConvertDatabaseColumnResponses, ConvertedCell, 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, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateDatabaseData, CreateDatabaseError, CreateDatabaseErrors, CreateDatabaseRequest, CreateDatabaseResponse, CreateDatabaseResponses, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateImport, 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, CreateSlackImportData, CreateSlackImportErrors, CreateSlackImportResponse, CreateSlackImportResponses, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateToken, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CustomSpeakerAssignment, Database, DatabaseDetail, DatabaseOp, DatabaseView, DataType, DateOperator, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorResponse, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelError, DeleteChannelLabelErrors, DeleteChannelLabelResponse, DeleteChannelLabelResponses, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, 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, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteReminderData, DeleteReminderError, DeleteReminderErrors, DeleteReminderResponse, DeleteReminderResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, 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, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmailFollowup, EmailFollowupCommand, EmailFollowupResponse, EmailReminderCondition, EmailReminderPage, EmailReminderSummary, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EnsureStarterHandlerData, EnsureStarterHandlerErrors, EnsureStarterHandlerResponse, EnsureStarterHandlerResponses, EntityFilters, EntityKind, 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, EntityRef, 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, FilterCondition, FilterGroup, FilterNode, FilterTest, FinalizeSlackImportData, FinalizeSlackImportErrors, FinalizeSlackImportResponse, FinalizeSlackImportResponses, FolderItem, FollowupState, 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, 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, GetDatabaseData, GetDatabaseError, GetDatabaseErrors, GetDatabasePermissionsData, GetDatabasePermissionsError, GetDatabasePermissionsErrors, GetDatabasePermissionsResponse, GetDatabasePermissionsResponses, GetDatabaseQueryData, GetDatabaseQueryError, GetDatabaseQueryErrors, GetDatabaseQueryResponse, GetDatabaseQueryResponses, GetDatabaseResponse, GetDatabaseResponses, GetDatabaseRowHistoryData, GetDatabaseRowHistoryError, GetDatabaseRowHistoryErrors, GetDatabaseRowHistoryResponse, GetDatabaseRowHistoryResponses, GetDatabaseTableChangesData, GetDatabaseTableChangesError, GetDatabaseTableChangesErrors, GetDatabaseTableChangesResponse, GetDatabaseTableChangesResponses, GetDatabaseViewPositionsData, GetDatabaseViewPositionsError, GetDatabaseViewPositionsErrors, GetDatabaseViewPositionsResponse, GetDatabaseViewPositionsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, 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, GetEmailFollowupData, GetEmailFollowupError, GetEmailFollowupErrors, GetEmailFollowupResponse, GetEmailFollowupResponses, 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, 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, GetSlackImportData, GetSlackImportErrors, GetSlackImportResponse, GetSlackImportResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, 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, ImportCounters, ImportDatabaseTableData, ImportDatabaseTableError, ImportDatabaseTableErrors, ImportDatabaseTableResponse, ImportDatabaseTableResponses, ImportedAuthor, ImportError, ImportLimits, ImportPage, ImportProgress, ImportTable, ImportWarning, InferColumnTypeOutcome, InferColumnTypeRequest, InferDatabaseColumnTypeData, InferDatabaseColumnTypeError, InferDatabaseColumnTypeErrors, InferDatabaseColumnTypeResponse, InferDatabaseColumnTypeResponses, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InitialPropertyValue, InitiativeDetail, InitiativeFilters, InitiativeId, InitiativeList, InitiativeSummary, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, InviteMeetingRequest, InviteMeetingUsersRequest, Item, ItemWithUserAccessLevel, JobId, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JobStatus, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, KeySegment, Lane, LaneKey, 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, ListDatabaseColumnCastsData, ListDatabaseColumnCastsError, ListDatabaseColumnCastsErrors, ListDatabaseColumnCastsResponse, ListDatabaseColumnCastsResponses, ListDatabasesData, ListDatabasesError, ListDatabasesErrors, ListDatabasesResponse, ListDatabasesResponses, ListedDatabase, ListEmailRemindersData, ListEmailRemindersError, ListEmailRemindersErrors, ListEmailRemindersResponse, ListEmailRemindersResponses, 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, ListReminderCollectionData, ListReminderCollectionError, ListReminderCollectionErrors, ListReminderCollectionResponse, ListReminderCollectionResponses, ListRemindersData, ListRemindersError, ListRemindersErrors, ListRemindersResponse, ListRemindersResponses, ListSlackImportsData, ListSlackImportsResponse, ListSlackImportsResponses, 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, Message, MessageAttachment, MessageAttachmentCreatedMetadata, MessageAttachmentRemovedMetadata, MessageChange, MessageCursor, MessageDeletedMetadata, MessageDirection, MessageEvent, MessageEventAttachment, MessageListItem, MessageMentionedMetadata, MessagePage, MessageParent, MessagePatch, MessagePatchedMetadata, MessagePostedMetadata, MessageThread, MessageThreadPreview, MessageTimelineData, MessageTimelineQuery, MessageTimelineResponse, MessageTimelineResponses, MessageTopicEvent, NewAttachment, NewColumn, NewOption, NewThreadAnchor, NewView, NotificationFilters, NotificationState, NumberOperator, OpRefusalResponse, OpResult, OptionRef, PairingDetails, Params, ParticipantRole, PatchBotRequest, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchMessageNotificationPolicy, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessage, PostMessageNotificationPolicy, PostSoupAstRequest, PostSoupRequest, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresenceOperator, PresignedUrl, PreviewSmartTagData, PreviewSmartTagError, PreviewSmartTagErrors, PreviewSmartTagResponse, PreviewSmartTagResponses, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyDefinition, PropertyDefinitionWithOptions, PropertyFilter, PropertyInput, PropertyOption, PropertyOptionValue, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, QueryDefinition, ReactionInput, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, RegisterSlackImportUploadsData, RegisterSlackImportUploadsErrors, RegisterSlackImportUploadsResponse, RegisterSlackImportUploadsResponses, RegisterUploads, Reminder, ReminderCollectionPage, ReminderCollectionRow, ReminderFilters, ReminderReference, 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, RequestedLayout, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RingStatus, RingStatusResponse, RowChange, RowChangeKind, RowChanges, RowHistoryEntry, RowHistoryResponse, RowsChange, RowsResult, S3ObjectInfo, SaveBomPart, SaveDatabaseQueryData, SaveDatabaseQueryError, SaveDatabaseQueryErrors, SaveDatabaseQueryResponse, SaveDatabaseQueryResponses, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SavedQuery, SaveQueryRequest, SearchContactsData, SearchContactsError, SearchContactsErrors, SearchContactsResponse, SearchContactsResponse2, SearchContactsResponses, SearchState, 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, SetEmailFollowupData, SetEmailFollowupError, SetEmailFollowupErrors, SetEmailFollowupResponse, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetOperator, SetPropertyValue, Sha256Digest, ShareDatabaseAwarenessData, ShareDatabaseAwarenessError, ShareDatabaseAwarenessErrors, ShareDatabaseAwarenessResponse, ShareDatabaseAwarenessResponses, SharedEmailFilter, SharePermissionV2, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SkippedCell, SlackCompleteRequest, SlackCreateRequest, SlackRegisterRequest, SlackTimestamp, SlackUserId, SmartTagChannelMatch, SmartTagPreview, SortDirection, SortKey, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordGuest, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmDomain, SoupDatabaseRowSoupPropertiesField, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupInitiativeSoupPropertiesField, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupReminderReference, SoupReminderSchedule, SoupReminderSoupPropertiesField, SoupThreadInfo, SoupThreadReply, SourceBinding, SourceId, SourceIdentity, StarterDatabase, StarterDocumentsResponse, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, Table, TableChange, TableChanged, TableChanges, TableDetail, TableResult, TableVersion, TagFilterMode, TakenId, TaskFilters, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, TextOperator, ThreadAnchor, ThreadOrigin, ThreadPatch, ThreadState, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TouchedColumn, TouchedRow, TranscribeDictationData, TranscribeDictationError, TranscribeDictationErrors, TranscribeDictationResponse, TranscribeDictationResponses, TranscribeResponse, TranscriptSegmentRequest, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingInput, UnassignInitiativeTaskData, UnassignInitiativeTaskError, UnassignInitiativeTaskErrors, UnassignInitiativeTaskResponse, UnassignInitiativeTaskResponses, UndoChangeResponse, UndoDatabaseChangeData, UndoDatabaseChangeError, UndoDatabaseChangeErrors, UndoDatabaseChangeResponse, UndoDatabaseChangeResponses, UndoOutcome, UndoRefusal, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmTeamSettingsRequest, UpdateDatabasePermissionsData, UpdateDatabasePermissionsError, UpdateDatabasePermissionsErrors, UpdateDatabasePermissionsResponse, UpdateDatabasePermissionsResponses, UpdateInitiativeData, UpdateInitiativeError, UpdateInitiativeErrors, UpdateInitiativeRequest, UpdateInitiativeResponse, UpdateInitiativeResponses, UpdateMeetingRequest, UpdateOperation, UpdateReminderData, UpdateReminderError, UpdateReminderErrors, UpdateReminderRequest, UpdateReminderResponse, UpdateReminderResponses, UpdateSharePermissionRequestV2, UploadDescriptor, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UploadGrant, UploadId, 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, VersionedTable, View, ViewChange, ViewColumn, ViewLayout, ViewPatch, ViewPosition, ViewPositionsResponse, ViewQuery, ViewResult, 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 60d86429b9..6aace00cff 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, ApplyDatabaseOpsData, ApplyDatabaseOpsErrors, ApplyDatabaseOpsResponses, ApproveHarnessPairingData, ApproveHarnessPairingErrors, ApproveHarnessPairingResponses, AssignInitiativeTasksData, AssignInitiativeTasksErrors, AssignInitiativeTasksResponses, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponses, CallWebhookData, CallWebhookErrors, CallWebhookResponses, CancelSlackImportData, CancelSlackImportErrors, CancelSlackImportResponses, CheckActiveCallData, CheckActiveCallErrors, CheckActiveCallResponses, ClaimHarnessPairingData, ClaimHarnessPairingErrors, ClaimHarnessPairingResponses, CompleteSlackImportUploadsData, CompleteSlackImportUploadsErrors, CompleteSlackImportUploadsResponses, ConvertDatabaseColumnData, ConvertDatabaseColumnErrors, ConvertDatabaseColumnResponses, CopyDocumentData, CopyDocumentErrors, CopyDocumentResponses, CreateAgentData, CreateAgentErrors, CreateAgentResponses, CreateAnchorData, CreateAnchorErrors, CreateAnchorResponses, CreateChannelData, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelErrors, CreateChannelLabelResponses, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotErrors, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponses, CreateCrmCompanyData, CreateCrmCompanyErrors, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactErrors, CreateCrmContactResponses, CreateDatabaseData, CreateDatabaseErrors, CreateDatabaseResponses, 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, CreateSlackImportData, CreateSlackImportErrors, CreateSlackImportResponses, 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, DeleteDocumentData, DeleteDocumentErrors, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionErrors, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessErrors, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeErrors, DeleteInitiativeResponses, 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, EditDocumentData, EditDocumentErrors, EditDocumentResponses, EditProjectV2Data, EditProjectV2Errors, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Errors, EditThreadV2Responses, EnsureCollabSurfaceData, EnsureCollabSurfaceErrors, EnsureCollabSurfaceResponses, EnsureStarterHandlerData, EnsureStarterHandlerErrors, EnsureStarterHandlerResponses, 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, FinalizeSlackImportData, FinalizeSlackImportErrors, FinalizeSlackImportResponses, 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, GetChannelParticipantsData, GetChannelParticipantsErrors, GetChannelParticipantsResponses, GetChannelResponses, GetChannelsData, GetChannelsErrors, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceErrors, GetCollabSurfaceResponses, GetCompanyData, GetCompanyErrors, GetCompanyResponses, GetContactByEmailData, GetContactByEmailErrors, GetContactByEmailResponses, GetContactData, GetContactErrors, GetContactResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponses, GetDatabaseData, GetDatabaseErrors, GetDatabasePermissionsData, GetDatabasePermissionsErrors, GetDatabasePermissionsResponses, GetDatabaseQueryData, GetDatabaseQueryErrors, GetDatabaseQueryResponses, GetDatabaseResponses, GetDatabaseRowHistoryData, GetDatabaseRowHistoryErrors, GetDatabaseRowHistoryResponses, GetDatabaseTableChangesData, GetDatabaseTableChangesErrors, GetDatabaseTableChangesResponses, GetDatabaseViewPositionsData, GetDatabaseViewPositionsErrors, GetDatabaseViewPositionsResponses, GetDocumentAnchorsData, GetDocumentAnchorsErrors, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameErrors, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponses, 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, GetEmailFollowupData, GetEmailFollowupErrors, GetEmailFollowupResponses, 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, 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, GetSlackImportData, GetSlackImportErrors, GetSlackImportResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponses, GetViewsHandlerData, GetViewsHandlerErrors, GetViewsHandlerResponses, GetWebhookData, GetWebhookErrors, GetWebhookResponses, HandlerData, HandlerErrors, HandlerResponses, HealthHandlerData, HealthHandlerResponses, ImportDatabaseTableData, ImportDatabaseTableErrors, ImportDatabaseTableResponses, InferDatabaseColumnTypeData, InferDatabaseColumnTypeErrors, InferDatabaseColumnTypeResponses, 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, ListDatabaseColumnCastsData, ListDatabaseColumnCastsErrors, ListDatabaseColumnCastsResponses, ListDatabasesData, ListDatabasesErrors, ListDatabasesResponses, ListFavoritesData, ListFavoritesErrors, ListFavoritesResponses, ListHarnessAgentsData, ListHarnessAgentsErrors, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesErrors, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsErrors, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesErrors, ListInitiativesResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponses, ListReminderCollectionData, ListReminderCollectionErrors, ListReminderCollectionResponses, ListRemindersData, ListRemindersErrors, ListRemindersResponses, ListSlackImportsData, ListSlackImportsResponses, 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, PatchViewHandlerData, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookErrors, PatchWebhookResponses, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponses, PostActivityData, PostActivityErrors, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookErrors, PostChannelBotWebhookResponses, PostItemsSoupAstData, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupErrors, PostItemsSoupResponses, PresaveDocumentHandlerData, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponses, PreviewSmartTagData, PreviewSmartTagErrors, PreviewSmartTagResponses, PutCrmTeamSettingsData, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesErrors, PutCrmTeamStagesResponses, RecentlyDeletedData, RecentlyDeletedErrors, RecentlyDeletedResponses, RegisterSlackImportUploadsData, RegisterSlackImportUploadsErrors, RegisterSlackImportUploadsResponses, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsErrors, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerErrors, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelErrors, RenameChannelLabelResponses, ReorderFavoritesData, ReorderFavoritesErrors, ReorderFavoritesResponses, ReorderPinsHandlerData, ReorderPinsHandlerErrors, ReorderPinsHandlerResponses, ResetCrmTeamStagesData, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponses, RevertDeleteDocumentData, RevertDeleteDocumentErrors, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectErrors, RevertDeleteProjectResponses, SaveDatabaseQueryData, SaveDatabaseQueryErrors, SaveDatabaseQueryResponses, SaveDocumentHandlerData, SaveDocumentHandlerErrors, SaveDocumentHandlerResponses, SearchContactsData, SearchContactsErrors, SearchContactsResponses, SetChannelLabelData, SetChannelLabelErrors, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureErrors, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenErrors, SetCompanyHiddenResponses, SetContactHiddenData, SetContactHiddenErrors, SetContactHiddenResponses, SetCrmCompanyNameData, SetCrmCompanyNameErrors, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameErrors, SetCrmContactNameResponses, SetDocumentTeamShareData, SetDocumentTeamShareErrors, SetDocumentTeamShareResponses, SetEmailFollowupData, SetEmailFollowupErrors, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncErrors, SetEmailSyncResponses, ShareDatabaseAwarenessData, ShareDatabaseAwarenessErrors, ShareDatabaseAwarenessResponses, SimpleSaveData, SimpleSaveErrors, SimpleSaveResponses, StreamEventsData, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, ToggleShareWithTeamData, ToggleShareWithTeamErrors, ToggleShareWithTeamResponses, TranscribeDictationData, TranscribeDictationErrors, TranscribeDictationResponses, UnassignInitiativeTaskData, UnassignInitiativeTaskErrors, UnassignInitiativeTaskResponses, UndoDatabaseChangeData, UndoDatabaseChangeErrors, UndoDatabaseChangeResponses, UpdateAgentData, UpdateAgentErrors, UpdateAgentResponses, UpdateDatabasePermissionsData, UpdateDatabasePermissionsErrors, UpdateDatabasePermissionsResponses, 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, ApplyDatabaseOpsData, ApplyDatabaseOpsErrors, ApplyDatabaseOpsResponses, ApproveHarnessPairingData, ApproveHarnessPairingErrors, ApproveHarnessPairingResponses, AssignInitiativeTasksData, AssignInitiativeTasksErrors, AssignInitiativeTasksResponses, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponses, CallWebhookData, CallWebhookErrors, CallWebhookResponses, CancelSlackImportData, CancelSlackImportErrors, CancelSlackImportResponses, CheckActiveCallData, CheckActiveCallErrors, CheckActiveCallResponses, ClaimHarnessPairingData, ClaimHarnessPairingErrors, ClaimHarnessPairingResponses, CompleteSlackImportUploadsData, CompleteSlackImportUploadsErrors, CompleteSlackImportUploadsResponses, ConvertDatabaseColumnData, ConvertDatabaseColumnErrors, ConvertDatabaseColumnResponses, CopyDocumentData, CopyDocumentErrors, CopyDocumentResponses, CreateAgentData, CreateAgentErrors, CreateAgentResponses, CreateAnchorData, CreateAnchorErrors, CreateAnchorResponses, CreateChannelData, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelErrors, CreateChannelLabelResponses, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotErrors, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponses, CreateCrmCompanyData, CreateCrmCompanyErrors, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactErrors, CreateCrmContactResponses, CreateDatabaseData, CreateDatabaseErrors, CreateDatabaseResponses, 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, CreateSlackImportData, CreateSlackImportErrors, CreateSlackImportResponses, 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, DeleteDocumentData, DeleteDocumentErrors, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionErrors, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessErrors, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeErrors, DeleteInitiativeResponses, 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, EditDocumentData, EditDocumentErrors, EditDocumentResponses, EditProjectV2Data, EditProjectV2Errors, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Errors, EditThreadV2Responses, EnsureCollabSurfaceData, EnsureCollabSurfaceErrors, EnsureCollabSurfaceResponses, EnsureStarterHandlerData, EnsureStarterHandlerErrors, EnsureStarterHandlerResponses, 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, FinalizeSlackImportData, FinalizeSlackImportErrors, FinalizeSlackImportResponses, 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, GetChannelParticipantsData, GetChannelParticipantsErrors, GetChannelParticipantsResponses, GetChannelResponses, GetChannelsData, GetChannelsErrors, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceErrors, GetCollabSurfaceResponses, GetCompanyData, GetCompanyErrors, GetCompanyResponses, GetContactByEmailData, GetContactByEmailErrors, GetContactByEmailResponses, GetContactData, GetContactErrors, GetContactResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponses, GetDatabaseData, GetDatabaseErrors, GetDatabasePermissionsData, GetDatabasePermissionsErrors, GetDatabasePermissionsResponses, GetDatabaseQueryData, GetDatabaseQueryErrors, GetDatabaseQueryResponses, GetDatabaseResponses, GetDatabaseRowHistoryData, GetDatabaseRowHistoryErrors, GetDatabaseRowHistoryResponses, GetDatabaseTableChangesData, GetDatabaseTableChangesErrors, GetDatabaseTableChangesResponses, GetDatabaseViewPositionsData, GetDatabaseViewPositionsErrors, GetDatabaseViewPositionsResponses, GetDocumentAnchorsData, GetDocumentAnchorsErrors, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameErrors, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponses, 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, GetEmailFollowupData, GetEmailFollowupErrors, GetEmailFollowupResponses, 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, 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, GetSlackImportData, GetSlackImportErrors, GetSlackImportResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponses, GetViewsHandlerData, GetViewsHandlerErrors, GetViewsHandlerResponses, GetWebhookData, GetWebhookErrors, GetWebhookResponses, HandlerData, HandlerErrors, HandlerResponses, HealthHandlerData, HealthHandlerResponses, ImportDatabaseTableData, ImportDatabaseTableErrors, ImportDatabaseTableResponses, InferDatabaseColumnTypeData, InferDatabaseColumnTypeErrors, InferDatabaseColumnTypeResponses, 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, ListDatabaseColumnCastsData, ListDatabaseColumnCastsErrors, ListDatabaseColumnCastsResponses, ListDatabasesData, ListDatabasesErrors, ListDatabasesResponses, ListEmailRemindersData, ListEmailRemindersErrors, ListEmailRemindersResponses, ListFavoritesData, ListFavoritesErrors, ListFavoritesResponses, ListHarnessAgentsData, ListHarnessAgentsErrors, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesErrors, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsErrors, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesErrors, ListInitiativesResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponses, ListReminderCollectionData, ListReminderCollectionErrors, ListReminderCollectionResponses, ListRemindersData, ListRemindersErrors, ListRemindersResponses, ListSlackImportsData, ListSlackImportsResponses, 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, PatchViewHandlerData, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookErrors, PatchWebhookResponses, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponses, PostActivityData, PostActivityErrors, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookErrors, PostChannelBotWebhookResponses, PostItemsSoupAstData, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupErrors, PostItemsSoupResponses, PresaveDocumentHandlerData, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponses, PreviewSmartTagData, PreviewSmartTagErrors, PreviewSmartTagResponses, PutCrmTeamSettingsData, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesErrors, PutCrmTeamStagesResponses, RecentlyDeletedData, RecentlyDeletedErrors, RecentlyDeletedResponses, RegisterSlackImportUploadsData, RegisterSlackImportUploadsErrors, RegisterSlackImportUploadsResponses, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsErrors, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerErrors, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelErrors, RenameChannelLabelResponses, ReorderFavoritesData, ReorderFavoritesErrors, ReorderFavoritesResponses, ReorderPinsHandlerData, ReorderPinsHandlerErrors, ReorderPinsHandlerResponses, ResetCrmTeamStagesData, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponses, RevertDeleteDocumentData, RevertDeleteDocumentErrors, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectErrors, RevertDeleteProjectResponses, SaveDatabaseQueryData, SaveDatabaseQueryErrors, SaveDatabaseQueryResponses, SaveDocumentHandlerData, SaveDocumentHandlerErrors, SaveDocumentHandlerResponses, SearchContactsData, SearchContactsErrors, SearchContactsResponses, SetChannelLabelData, SetChannelLabelErrors, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureErrors, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenErrors, SetCompanyHiddenResponses, SetContactHiddenData, SetContactHiddenErrors, SetContactHiddenResponses, SetCrmCompanyNameData, SetCrmCompanyNameErrors, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameErrors, SetCrmContactNameResponses, SetDocumentTeamShareData, SetDocumentTeamShareErrors, SetDocumentTeamShareResponses, SetEmailFollowupData, SetEmailFollowupErrors, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncErrors, SetEmailSyncResponses, ShareDatabaseAwarenessData, ShareDatabaseAwarenessErrors, ShareDatabaseAwarenessResponses, SimpleSaveData, SimpleSaveErrors, SimpleSaveResponses, StreamEventsData, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, ToggleShareWithTeamData, ToggleShareWithTeamErrors, ToggleShareWithTeamResponses, TranscribeDictationData, TranscribeDictationErrors, TranscribeDictationResponses, UnassignInitiativeTaskData, UnassignInitiativeTaskErrors, UnassignInitiativeTaskResponses, UndoDatabaseChangeData, UndoDatabaseChangeErrors, UndoDatabaseChangeResponses, UpdateAgentData, UpdateAgentErrors, UpdateAgentResponses, UpdateDatabasePermissionsData, UpdateDatabasePermissionsErrors, UpdateDatabasePermissionsResponses, 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> & {
/**
@@ -2368,6 +2368,13 @@ export class Sdk extends HeyApiClient {
return (options?.client ?? this.client).get<ListReminderCollectionResponses, ListReminderCollectionErrors, ThrowOnError>({ url: '/reminders/collection', ...options });
}
+ /**
+ * List original email threads with caller-private reminder work.
+ */
+ public listEmailReminders<ThrowOnError extends boolean = false>(options?: Options<ListEmailRemindersData, ThrowOnError>): RequestResult<ListEmailRemindersResponses, ListEmailRemindersErrors, ThrowOnError> {
+ return (options?.client ?? this.client).get<ListEmailRemindersResponses, ListEmailRemindersErrors, ThrowOnError>({ url: '/reminders/email/collection', ...options });
+ }
+
/**
* Read an email follow-up and reconcile inbound reply cancellation.
*/
diff --git a/packages/sdk/generated/storage/types.gen.ts b/packages/sdk/generated/storage/types.gen.ts
index fff76329be..cffab9d450 100644
--- a/packages/sdk/generated/storage/types.gen.ts
+++ b/packages/sdk/generated/storage/types.gen.ts
@@ -5592,6 +5592,38 @@ export type EmailFollowupResponse = {
*/
export type EmailReminderCondition = 'if_no_reply' | 'regardless';
+/**
+ * A page of original-email identities and private reminder metadata.
+ */
+export type EmailReminderPage = {
+ /**
+ * Coalesced rows in nearest-occurrence order.
+ */
+ items: Array<EmailReminderSummary>;
+ /**
+ * Progress through all examined candidates, absent at exhaustion.
+ */
+ nextCursor?: string | null;
+};
+
+/**
+ * One original thread, coalescing all of its current reminder work.
+ */
+export type EmailReminderSummary = {
+ /**
+ * Number of eligible reminders attached to this thread.
+ */
+ count: number;
+ /**
+ * Nearest eligible occurrence and its owning editor capability.
+ */
+ nearest: ReminderCollectionRow;
+ /**
+ * Original email identity, never a mirror reminder identity.
+ */
+ threadId: string;
+};
+
/**
* Empty response is required due to custom fetch forcing `response.json()`
*/
@@ -19035,6 +19067,64 @@ export type ListReminderCollectionResponses = {
export type ListReminderCollectionResponse = ListReminderCollectionResponses[keyof ListReminderCollectionResponses];
+export type ListEmailRemindersData = {
+ body?: never;
+ path?: never;
+ query?: {
+ /**
+ * Selected inboxes; omission selects all accessible inboxes.
+ */
+ inboxIds?: Array<string> | null;
+ /**
+ * Explicitly empty inbox selection.
+ */
+ noInboxes?: boolean | null;
+ /**
+ * Email archive filter, independent of reminder completion.
+ */
+ done?: boolean | null;
+ /**
+ * Email read status.
+ */
+ read?: boolean | null;
+ /**
+ * Restrict to calendar mail.
+ */
+ calendar?: boolean | null;
+ /**
+ * Repeated property-definition:select-option UUID pairs.
+ */
+ tags?: Array<string> | null;
+ /**
+ * Repeated attachment categories: pdf, image, document.
+ */
+ attachments?: Array<string> | null;
+ /**
+ * Continuation from the previous page.
+ */
+ cursor?: string | null;
+ /**
+ * Maximum rows (1–100).
+ */
+ limit?: number | null;
+ };
+ url: '/reminders/email/collection';
+};
+
+export type ListEmailRemindersErrors = {
+ 400: ErrorResponse;
+ 401: ErrorResponse;
+ 500: ErrorResponse;
+};
+
+export type ListEmailRemindersError = ListEmailRemindersErrors[keyof ListEmailRemindersErrors];
+
+export type ListEmailRemindersResponses = {
+ 200: EmailReminderPage;
+};
+
+export type ListEmailRemindersResponse = ListEmailRemindersResponses[keyof ListEmailRemindersResponses];
+
export type GetEmailFollowupData = {
body?: never;
path: {
diff --git a/packages/sdk/specs/storage.json b/packages/sdk/specs/storage.json
index e305bcafff..acbad01896 100644
--- a/packages/sdk/specs/storage.json
+++ b/packages/sdk/specs/storage.json
@@ -14240,6 +14240,151 @@
}
}
},
+ "/reminders/email/collection": {
+ "get": {
+ "tags": ["reminders"],
+ "summary": "List original email threads with caller-private reminder work.",
+ "operationId": "list_email_reminders",
+ "parameters": [
+ {
+ "name": "inboxIds",
+ "in": "query",
+ "description": "Selected inboxes; omission selects all accessible inboxes.",
+ "required": false,
+ "schema": {
+ "type": ["array", "null"],
+ "items": {
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ },
+ {
+ "name": "noInboxes",
+ "in": "query",
+ "description": "Explicitly empty inbox selection.",
+ "required": false,
+ "schema": {
+ "type": ["boolean", "null"]
+ }
+ },
+ {
+ "name": "done",
+ "in": "query",
+ "description": "Email archive filter, independent of reminder completion.",
+ "required": false,
+ "schema": {
+ "type": ["boolean", "null"]
+ }
+ },
+ {
+ "name": "read",
+ "in": "query",
+ "description": "Email read status.",
+ "required": false,
+ "schema": {
+ "type": ["boolean", "null"]
+ }
+ },
+ {
+ "name": "calendar",
+ "in": "query",
+ "description": "Restrict to calendar mail.",
+ "required": false,
+ "schema": {
+ "type": ["boolean", "null"]
+ }
+ },
+ {
+ "name": "tags",
+ "in": "query",
+ "description": "Repeated property-definition:select-option UUID pairs.",
+ "required": false,
+ "schema": {
+ "type": ["array", "null"],
+ "items": {
+ "type": "string"
+ }
+ }
+ },
+ {
+ "name": "attachments",
+ "in": "query",
+ "description": "Repeated attachment categories: pdf, image, document.",
+ "required": false,
+ "schema": {
+ "type": ["array", "null"],
+ "items": {
+ "type": "string"
+ }
+ }
+ },
+ {
+ "name": "cursor",
+ "in": "query",
+ "description": "Continuation from the previous page.",
+ "required": false,
+ "schema": {
+ "type": ["string", "null"]
+ }
+ },
+ {
+ "name": "limit",
+ "in": "query",
+ "description": "Maximum rows (1–100).",
+ "required": false,
+ "schema": {
+ "type": ["integer", "null"],
+ "format": "int32",
+ "maximum": 100,
+ "minimum": 1
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/EmailReminderPage"
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/ErrorResponse"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/reminders/email/{thread_id}": {
"get": {
"tags": ["reminders"],
@@ -24316,6 +24461,46 @@
"description": "When an email follow-up should return the conversation.",
"enum": ["if_no_reply", "regardless"]
},
+ "EmailReminderPage": {
+ "type": "object",
+ "description": "A page of original-email identities and private reminder metadata.",
+ "required": ["items"],
+ "properties": {
+ "items": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EmailReminderSummary"
+ },
+ "description": "Coalesced rows in nearest-occurrence order."
+ },
+ "nextCursor": {
+ "type": ["string", "null"],
+ "description": "Progress through all examined candidates, absent at exhaustion."
+ }
+ }
+ },
+ "EmailReminderSummary": {
+ "type": "object",
+ "description": "One original thread, coalescing all of its current reminder work.",
+ "required": ["threadId", "nearest", "count"],
+ "properties": {
+ "count": {
+ "type": "integer",
+ "format": "int32",
+ "description": "Number of eligible reminders attached to this thread.",
+ "minimum": 0
+ },
+ "nearest": {
+ "$ref": "#/components/schemas/ReminderCollectionRow",
+ "description": "Nearest eligible occurrence and its owning editor capability."
+ },
+ "threadId": {
+ "type": "string",
+ "format": "uuid",
+ "description": "Original email identity, never a mirror reminder identity."
+ }
+ }
+ },
"EmptyResponse": {
"type": "object",
"description": "Empty response is required due to custom fetch forcing `response.json()`"
diff --git a/packages/sdk/src/coverage/skipped.ts b/packages/sdk/src/coverage/skipped.ts
index 7c27c782ce..5a6eed5180 100644
--- a/packages/sdk/src/coverage/skipped.ts
+++ b/packages/sdk/src/coverage/skipped.ts
@@ -380,6 +380,7 @@ export const storageBacklog = [
// Email follow-ups are available through the generated client, like reminders.
'getEmailFollowup',
'setEmailFollowup',
+ 'listEmailReminders',
'approveHarnessPairing',
'assignInitiativeTasks',
'claimHarnessPairing',
diff --git a/services/document_storage_service/src/api/context.rs b/services/document_storage_service/src/api/context.rs
index 62e87712b2..d2e73a4096 100644
--- a/services/document_storage_service/src/api/context.rs
+++ b/services/document_storage_service/src/api/context.rs
@@ -615,6 +615,7 @@ pub(crate) type RemindersServiceType =
PgRemindersRepo,
DssEmailService,
reminders::domain::ports::SystemClock,
+ EntityAccessService,
>;
/// Type alias for the reminders router state.
diff --git a/services/document_storage_service/src/api/swagger.rs b/services/document_storage_service/src/api/swagger.rs
index 96b1e0e90e..576860d9b6 100644
--- a/services/document_storage_service/src/api/swagger.rs
+++ b/services/document_storage_service/src/api/swagger.rs
@@ -436,6 +436,7 @@ use utoipa::OpenApi;
reminders::inbound::axum_router::set_email_followup_handler,
reminders::inbound::axum_router::list_reminders_handler,
reminders::inbound::axum_router::list_reminder_collection_handler,
+ reminders::inbound::axum_router::email_collection::list_email_reminders_handler,
reminders::inbound::axum_router::create_reminder_handler,
reminders::inbound::axum_router::get_reminder_handler,
reminders::inbound::axum_router::update_reminder_handler,
diff --git a/services/document_storage_service/src/main.rs b/services/document_storage_service/src/main.rs
index 3364fa08a3..27b690c991 100644
--- a/services/document_storage_service/src/main.rs
+++ b/services/document_storage_service/src/main.rs
@@ -1329,7 +1329,8 @@ async fn run() -> anyhow::Result<()> {
reminders::domain::email_followup::reminder_service::EmailRemindersService::new(
RemindersServiceImpl::new(PgRemindersRepo::new(db.clone())),
email_followups.clone(),
- );
+ )
+ .with_entity_access((*entity_access_service).clone());
let document_creator = documents_hex::domain::create::DocumentCreator::new(
document_service.clone(),