Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
feat(agent_session): make agent sessions a first-class Soup entity (backend) (#6299)
Wolf Mermelsteinb85b3fe8c364
diff --git a/.github/workspace-dep-closures.json b/.github/workspace-dep-closures.jsonindex 27fd56f716..e12a8b0816 100644--- a/.github/workspace-dep-closures.json+++ b/.github/workspace-dep-closures.json@@ -1939,6 +1939,7 @@"crates/authentication_service_client","crates/bot_id","crates/bot_token",+ "crates/bots","crates/broadcast","crates/call","crates/channel_sender",diff --git a/.sqlx/query-7101ea0a8cc97511d2c071783abcc6d0e841215c5ebddc2e3bc8b98ac203e47c.json b/.sqlx/query-7101ea0a8cc97511d2c071783abcc6d0e841215c5ebddc2e3bc8b98ac203e47c.jsonnew file mode 100644index 0000000000..a2336c3044--- /dev/null+++ b/.sqlx/query-7101ea0a8cc97511d2c071783abcc6d0e841215c5ebddc2e3bc8b98ac203e47c.json@@ -0,0 +1,71 @@+{+ "db_name": "PostgreSQL",+ "query": "\n WITH viewer_source_ids AS (\n SELECT cp.channel_id::text AS source_id\n FROM comms_channel_participants cp\n WHERE cp.user_id = $2 AND cp.left_at IS NULL\n UNION ALL\n SELECT t.team_id::text FROM team_user t WHERE t.user_id = $2\n UNION ALL\n SELECT $2\n )\n SELECT\n s.id,\n s.name,\n s.owner_id,\n s.bot_id,\n s.status,\n s.status_event_name,\n s.created_at,\n s.modified_at,\n EXISTS (\n SELECT 1 FROM entity_access ea\n WHERE ea.entity_id = s.id\n AND ea.entity_type = 'agent_session'\n AND ea.source_id IN (SELECT source_id FROM viewer_source_ids)\n ) AS \"has_access!\"\n FROM agent_session s\n WHERE s.id = ANY($1)\n ",+ "describe": {+ "columns": [+ {+ "ordinal": 0,+ "name": "id",+ "type_info": "Uuid"+ },+ {+ "ordinal": 1,+ "name": "name",+ "type_info": "Text"+ },+ {+ "ordinal": 2,+ "name": "owner_id",+ "type_info": "Text"+ },+ {+ "ordinal": 3,+ "name": "bot_id",+ "type_info": "Uuid"+ },+ {+ "ordinal": 4,+ "name": "status",+ "type_info": "Text"+ },+ {+ "ordinal": 5,+ "name": "status_event_name",+ "type_info": "Text"+ },+ {+ "ordinal": 6,+ "name": "created_at",+ "type_info": "Timestamptz"+ },+ {+ "ordinal": 7,+ "name": "modified_at",+ "type_info": "Timestamptz"+ },+ {+ "ordinal": 8,+ "name": "has_access!",+ "type_info": "Bool"+ }+ ],+ "parameters": {+ "Left": [+ "UuidArray",+ "Text"+ ]+ },+ "nullable": [+ false,+ false,+ false,+ false,+ false,+ true,+ false,+ false,+ null+ ]+ },+ "hash": "7101ea0a8cc97511d2c071783abcc6d0e841215c5ebddc2e3bc8b98ac203e47c"+}diff --git a/.sqlx/query-93ebdea020082753856fc694739ab7bc3d2ca398ac4d4fdb8d79e2b7e01def85.json b/.sqlx/query-93ebdea020082753856fc694739ab7bc3d2ca398ac4d4fdb8d79e2b7e01def85.jsonnew file mode 100644index 0000000000..33cf31677b--- /dev/null+++ b/.sqlx/query-93ebdea020082753856fc694739ab7bc3d2ca398ac4d4fdb8d79e2b7e01def85.json@@ -0,0 +1,16 @@+{+ "db_name": "PostgreSQL",+ "query": "\n INSERT INTO \"UserHistory\" (\"userId\", \"itemId\", \"itemType\", \"createdAt\", \"updatedAt\")\n VALUES ($1, $2, $3, NOW(), NOW())\n ON CONFLICT (\"userId\", \"itemId\", \"itemType\") DO UPDATE\n SET \"updatedAt\" = NOW()\n ",+ "describe": {+ "columns": [],+ "parameters": {+ "Left": [+ "Text",+ "Text",+ "Text"+ ]+ },+ "nullable": []+ },+ "hash": "93ebdea020082753856fc694739ab7bc3d2ca398ac4d4fdb8d79e2b7e01def85"+}diff --git a/.sqlx/query-cb3ae1a75cee34cedf4791143f9e34b97b5b8593933790ef8544147b4ae4a55d.json b/.sqlx/query-cb3ae1a75cee34cedf4791143f9e34b97b5b8593933790ef8544147b4ae4a55d.jsonnew file mode 100644index 0000000000..5cb15dfd42--- /dev/null+++ b/.sqlx/query-cb3ae1a75cee34cedf4791143f9e34b97b5b8593933790ef8544147b4ae4a55d.json@@ -0,0 +1,15 @@+{+ "db_name": "PostgreSQL",+ "query": "DELETE FROM \"UserHistory\" WHERE \"itemId\" = $1 AND \"itemType\" = $2",+ "describe": {+ "columns": [],+ "parameters": {+ "Left": [+ "Text",+ "Text"+ ]+ },+ "nullable": []+ },+ "hash": "cb3ae1a75cee34cedf4791143f9e34b97b5b8593933790ef8544147b4ae4a55d"+}diff --git a/Cargo.lock b/Cargo.lockindex ae5608450b..79464fa288 100644--- a/Cargo.lock+++ b/Cargo.lock@@ -3762,6 +3762,7 @@ dependencies = ["apollo-compiler","async-graphql","axum",+ "bots","chrono","email","entity_access",diff --git a/apps/web/src/features/email-thread/thread-completion-adapter.tsx b/apps/web/src/features/email-thread/thread-completion-adapter.tsxindex d4a9b8f8e6..7b6878c7e4 100644--- a/apps/web/src/features/email-thread/thread-completion-adapter.tsx+++ b/apps/web/src/features/email-thread/thread-completion-adapter.tsx@@ -26,7 +26,10 @@ import {invalidateAllSoup,refetchSoupEntity,} from '@queries/soup/cache';-import { mapApiSoupItemToEntity } from '@queries/soup/transform-utils';+import {+ isDisplayableSoupItem,+ mapApiSoupItemToEntity,+} from '@queries/soup/transform-utils';import type { Accessor } from 'solid-js';import type {@@ -187,6 +190,7 @@ export function createThreadCompletionAdapter(const entity =selectedRow?.original ??(cachedItem &&+ isDisplayableSoupItem(cachedItem) &&cachedItem.tag !== 'channelThread' &&cachedItem.tag !== 'calendarEvent'? mapApiSoupItemToEntity(cachedItem)@@ -295,6 +299,7 @@ export function createThreadCompletionAdapter();} else if (cachedItem &&+ isDisplayableSoupItem(cachedItem) &&cachedItem.tag !== 'channelThread' &&cachedItem.tag !== 'calendarEvent') {diff --git a/apps/web/src/features/next-soup/filters/query-filters.ts b/apps/web/src/features/next-soup/filters/query-filters.tsindex 3fe3543b2f..953a7d2cdf 100644--- a/apps/web/src/features/next-soup/filters/query-filters.ts+++ b/apps/web/src/features/next-soup/filters/query-filters.ts@@ -166,6 +166,10 @@ export function filterSoupItemByRequestBody({ tag: 'reminder' },({ data }) => !isIdFilteredOut(body.reminder_filters?.ids, data.id))+ .with(+ { tag: 'agentSession' },+ ({ data }) => !isIdFilteredOut(body.agent_session_filters?.ids, data.id)+ ).exhaustive();}diff --git a/apps/web/src/features/next-soup/soup-view/soup-view-context.tsx b/apps/web/src/features/next-soup/soup-view/soup-view-context.tsxindex d1c86e544b..5ff02a3a76 100644--- a/apps/web/src/features/next-soup/soup-view/soup-view-context.tsx+++ b/apps/web/src/features/next-soup/soup-view/soup-view-context.tsx@@ -83,7 +83,10 @@ import type {import type { SoupParams } from '@queries/soup/items';import { useSoupAstItemsQuery } from '@queries/soup/items';import { soupKeys } from '@queries/soup/keys';-import { mapApiSoupItemToEntity } from '@queries/soup/transform-utils';+import {+ isDisplayableSoupItem,+ mapApiSoupItemToEntity,+} from '@queries/soup/transform-utils';import { useIsTeamAdmin } from '@queries/team/teams';import type { SoupApiItem } from '@service-storage/generated/schemas';import { makePersisted } from '@solid-primitives/storage';@@ -976,6 +979,7 @@ export const SoupViewContextProvider: FlowComponent<const membershipFilter = config().itemMembershipFilter;if (membershipFilter && !membershipFilter(item)) return false;+ if (!isDisplayableSoupItem(item)) return false;const entity = mapApiSoupItemToEntity(item) as SoupEntity;return (soup.predicates.test(entity, getFilterContext()) &&diff --git a/apps/web/src/lib/queries/soup/normalized-cache/operations.ts b/apps/web/src/lib/queries/soup/normalized-cache/operations.tsindex 13e8489b5b..e44624ed21 100644--- a/apps/web/src/lib/queries/soup/normalized-cache/operations.ts+++ b/apps/web/src/lib/queries/soup/normalized-cache/operations.ts@@ -898,6 +898,10 @@ export function buildSingleEntityFilter(...base,reminder_filters: { ids: [entityId] },}))+ .with('agentSession', () => ({+ ...base,+ agent_session_filters: { ids: [entityId] },+ })).exhaustive();}diff --git a/apps/web/src/lib/queries/soup/transform-utils.ts b/apps/web/src/lib/queries/soup/transform-utils.tsindex beaf951879..50819d7d1f 100644--- a/apps/web/src/lib/queries/soup/transform-utils.ts+++ b/apps/web/src/lib/queries/soup/transform-utils.ts@@ -63,7 +63,15 @@ type InnerSearchResult =| ProjectSearchResult| CallRecordSearchResult;-type DisplayableSoupItem = SoupPage['items'][number];+/**+ * Soup items the frontend knows how to render. Agent sessions are opt-in on+ * the backend and have no entity mapping here yet, so they are excluded until+ * the frontend grows an `AgentSessionEntity`.+ */+type DisplayableSoupItem = Exclude<+ SoupPage['items'][number],+ { tag: 'agentSession' }+>;type SoupDocument = Extract<DisplayableSoupItem, { tag: 'document' }>['data'];type SoupEntity =@@ -647,7 +655,7 @@ const resolveDocumentEntityName = (export const isDisplayableSoupItem = (item: SoupPage['items'][number]-): item is DisplayableSoupItem => Boolean(item);+): item is DisplayableSoupItem => Boolean(item) && item.tag !== 'agentSession';/*** The email soup query encodes "no sort timestamp" — e.g. a never-viewed threaddiff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/client.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/client.tsindex 7c5170abf7..f36f0e1c3b 100644--- a/apps/web/src/lib/service-clients/service-agent-harness/generated/client.ts+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/client.ts@@ -15,6 +15,8 @@ import type {EditQueuedActionRequest,LoadAgentModelsRequest,LoadAgentModelsResponse,+ PreviewAgentSessionsRequest,+ PreviewAgentSessionsResponse,RenameAgentSessionRequest,SandboxSizeBody,} from './schemas';@@ -301,6 +303,76 @@ export const createAgentSession = async (} as createAgentSessionResponse;};+/**+ * No per-id access extractor: a chip has to render for a session the caller+cannot open, so access is answered per id in the body rather than+enforced on the request. The caller learns the fields a chip shows for+sessions they may view, and only existence for the rest.+ * @summary Preview a batch of agent sessions for rendering chips.+ */+export type previewAgentSessionsResponse200 = {+ data: PreviewAgentSessionsResponse;+ status: 200;+};++export type previewAgentSessionsResponse400 = {+ data: string;+ status: 400;+};++export type previewAgentSessionsResponse401 = {+ data: string;+ status: 401;+};++export type previewAgentSessionsResponse500 = {+ data: string;+ status: 500;+};++export type previewAgentSessionsResponseSuccess =+ previewAgentSessionsResponse200 & {+ headers: Headers;+ };+export type previewAgentSessionsResponseError = (+ | previewAgentSessionsResponse400+ | previewAgentSessionsResponse401+ | previewAgentSessionsResponse500+) & {+ headers: Headers;+};++export type previewAgentSessionsResponse =+ | previewAgentSessionsResponseSuccess+ | previewAgentSessionsResponseError;++export const getPreviewAgentSessionsUrl = () => {+ return `/agent-sessions/preview`;+};++export const previewAgentSessions = async (+ previewAgentSessionsRequest: PreviewAgentSessionsRequest,+ options?: RequestInit+): Promise<previewAgentSessionsResponse> => {+ const res = await fetch(getPreviewAgentSessionsUrl(), {+ ...options,+ method: 'POST',+ headers: { 'Content-Type': 'application/json', ...options?.headers },+ body: JSON.stringify(previewAgentSessionsRequest),+ });++ const body = [204, 205, 304].includes(res.status) ? null : await res.text();++ const data: previewAgentSessionsResponse['data'] = body+ ? JSON.parse(body)+ : {};+ return {+ data,+ status: res.status,+ headers: res.headers,+ } as previewAgentSessionsResponse;+};+/*** @summary Get an agent session by id.*/diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewData.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewData.tsnew file mode 100644index 0000000000..605d46dbcb--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewData.ts@@ -0,0 +1,29 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */+import type { SessionStatusDto } from './sessionStatusDto';++/**+ * The fields a chip renders for a session the caller may view.++Clients deserialize this, so both derives are used.+ */+export interface AgentSessionPreviewData {+ /** The bot running the agent. */+ botId: string;+ /** When the session was created. */+ createdAt: string;+ /** The session id. */+ id: string;+ /** When the session was last modified. */+ modifiedAt: string;+ /** User-facing session name. */+ name: string;+ /** The user who owns the session. */+ ownerId: string;+ /** The session's last known status. */+ status: SessionStatusDto;+}diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDto.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDto.tsnew file mode 100644index 0000000000..74e728dbbf--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDto.ts@@ -0,0 +1,23 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */+import type { AgentSessionPreviewDtoOneOf } from './agentSessionPreviewDtoOneOf';+import type { AgentSessionPreviewDtoOneOfFour } from './agentSessionPreviewDtoOneOfFour';+import type { AgentSessionPreviewDtoOneOfSeven } from './agentSessionPreviewDtoOneOfSeven';++/**+ * What one requested id resolved to, on the wire.++Tagged the same way the chat and document preview endpoints tag theirs+(`type` in `access` / `no_access` / `does_not_exist`), so a client that+renders those chips can render this one with the same branch.++Clients deserialize this, so both derives are used.+ */+export type AgentSessionPreviewDto =+ | AgentSessionPreviewDtoOneOf+ | AgentSessionPreviewDtoOneOfFour+ | AgentSessionPreviewDtoOneOfSeven;diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOf.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOf.tsnew file mode 100644index 0000000000..ea51de2a10--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOf.ts@@ -0,0 +1,14 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */+import type { AgentSessionPreviewData } from './agentSessionPreviewData';+import type { AgentSessionPreviewDtoOneOfAllOf } from './agentSessionPreviewDtoOneOfAllOf';++/**+ * The caller may view the session.+ */+export type AgentSessionPreviewDtoOneOf = AgentSessionPreviewData &+ AgentSessionPreviewDtoOneOfAllOf;diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfAllOf.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfAllOf.tsnew file mode 100644index 0000000000..2486626c9f--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfAllOf.ts@@ -0,0 +1,11 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */+import type { AgentSessionPreviewDtoOneOfAllOfType } from './agentSessionPreviewDtoOneOfAllOfType';++export type AgentSessionPreviewDtoOneOfAllOf = {+ type: AgentSessionPreviewDtoOneOfAllOfType;+};diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfAllOfType.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfAllOfType.tsnew file mode 100644index 0000000000..f9cc506685--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfAllOfType.ts@@ -0,0 +1,14 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */++export type AgentSessionPreviewDtoOneOfAllOfType =+ (typeof AgentSessionPreviewDtoOneOfAllOfType)[keyof typeof AgentSessionPreviewDtoOneOfAllOfType];++// eslint-disable-next-line @typescript-eslint/no-redeclare+export const AgentSessionPreviewDtoOneOfAllOfType = {+ access: 'access',+} as const;diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfFour.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfFour.tsnew file mode 100644index 0000000000..886531b9d4--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfFour.ts@@ -0,0 +1,15 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */++import type { AgentSessionPreviewDtoOneOfFourAllOf } from './agentSessionPreviewDtoOneOfFourAllOf';+import type { WithAgentSessionId } from './withAgentSessionId';++/**+ * The session exists but the caller holds no grant on it.+ */+export type AgentSessionPreviewDtoOneOfFour = WithAgentSessionId &+ AgentSessionPreviewDtoOneOfFourAllOf;diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfFourAllOf.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfFourAllOf.tsnew file mode 100644index 0000000000..8d62b92ffe--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfFourAllOf.ts@@ -0,0 +1,11 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */+import type { AgentSessionPreviewDtoOneOfFourAllOfType } from './agentSessionPreviewDtoOneOfFourAllOfType';++export type AgentSessionPreviewDtoOneOfFourAllOf = {+ type: AgentSessionPreviewDtoOneOfFourAllOfType;+};diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfFourAllOfType.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfFourAllOfType.tsnew file mode 100644index 0000000000..4603591830--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfFourAllOfType.ts@@ -0,0 +1,14 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */++export type AgentSessionPreviewDtoOneOfFourAllOfType =+ (typeof AgentSessionPreviewDtoOneOfFourAllOfType)[keyof typeof AgentSessionPreviewDtoOneOfFourAllOfType];++// eslint-disable-next-line @typescript-eslint/no-redeclare+export const AgentSessionPreviewDtoOneOfFourAllOfType = {+ no_access: 'no_access',+} as const;diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfSeven.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfSeven.tsnew file mode 100644index 0000000000..99a90ec0bc--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfSeven.ts@@ -0,0 +1,15 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */++import type { AgentSessionPreviewDtoOneOfSevenAllOf } from './agentSessionPreviewDtoOneOfSevenAllOf';+import type { WithAgentSessionId } from './withAgentSessionId';++/**+ * No session with this id exists.+ */+export type AgentSessionPreviewDtoOneOfSeven = WithAgentSessionId &+ AgentSessionPreviewDtoOneOfSevenAllOf;diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfSevenAllOf.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfSevenAllOf.tsnew file mode 100644index 0000000000..0b62dcd0fa--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfSevenAllOf.ts@@ -0,0 +1,11 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */+import type { AgentSessionPreviewDtoOneOfSevenAllOfType } from './agentSessionPreviewDtoOneOfSevenAllOfType';++export type AgentSessionPreviewDtoOneOfSevenAllOf = {+ type: AgentSessionPreviewDtoOneOfSevenAllOfType;+};diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfSevenAllOfType.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfSevenAllOfType.tsnew file mode 100644index 0000000000..90b2fb71d8--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/agentSessionPreviewDtoOneOfSevenAllOfType.ts@@ -0,0 +1,14 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */++export type AgentSessionPreviewDtoOneOfSevenAllOfType =+ (typeof AgentSessionPreviewDtoOneOfSevenAllOfType)[keyof typeof AgentSessionPreviewDtoOneOfSevenAllOfType];++// eslint-disable-next-line @typescript-eslint/no-redeclare+export const AgentSessionPreviewDtoOneOfSevenAllOfType = {+ does_not_exist: 'does_not_exist',+} as const;diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/index.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/index.tsindex 292789fc77..bb8c26478f 100644--- a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/index.ts+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/index.ts@@ -31,6 +31,17 @@ export * from './agentSessionLogEntryDto';export * from './agentSessionLogEntryDtoAllOf';export * from './agentSessionLogEntryDtoAllOfUserId';export * from './agentSessionLogResponse';+export * from './agentSessionPreviewData';+export * from './agentSessionPreviewDto';+export * from './agentSessionPreviewDtoOneOf';+export * from './agentSessionPreviewDtoOneOfAllOf';+export * from './agentSessionPreviewDtoOneOfAllOfType';+export * from './agentSessionPreviewDtoOneOfFour';+export * from './agentSessionPreviewDtoOneOfFourAllOf';+export * from './agentSessionPreviewDtoOneOfFourAllOfType';+export * from './agentSessionPreviewDtoOneOfSeven';+export * from './agentSessionPreviewDtoOneOfSevenAllOf';+export * from './agentSessionPreviewDtoOneOfSevenAllOfType';export * from './agentSessionQueueResponse';export * from './agentSessionResponse';export * from './agentSessionResponseAcpSessionId';@@ -79,6 +90,8 @@ export * from './logDirectionDto';export * from './logFrameDto';export * from './logFrameDtoContent';export * from './modelHarnessDto';+export * from './previewAgentSessionsRequest';+export * from './previewAgentSessionsResponse';export * from './queuedActionDto';export * from './queuedActionDtoActorUserId';export * from './queuedActionDtoPrompt';@@ -94,3 +107,4 @@ export * from './sessionStatusDtoOneOfFiveKind';export * from './sessionStatusDtoOneOfKind';export * from './sessionStatusDtoOneOfThree';export * from './sessionStatusDtoOneOfThreeKind';+export * from './withAgentSessionId';diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/previewAgentSessionsRequest.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/previewAgentSessionsRequest.tsnew file mode 100644index 0000000000..36c1b7f310--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/previewAgentSessionsRequest.ts@@ -0,0 +1,18 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */++/**+ * Request body for `POST /agent-sessions/preview`.++Clients serialize this, so both derives are used.+ */+export interface PreviewAgentSessionsRequest {+ /** The sessions to preview. Duplicates are collapsed server-side; at most+[`MAX_PREVIEW_SESSION_IDS`](crate::domain::model::MAX_PREVIEW_SESSION_IDS)+distinct ids per request. */+ sessionIds: string[];+}diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/previewAgentSessionsResponse.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/previewAgentSessionsResponse.tsnew file mode 100644index 0000000000..8dc54c3972--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/previewAgentSessionsResponse.ts@@ -0,0 +1,18 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */+import type { AgentSessionPreviewDto } from './agentSessionPreviewDto';++/**+ * Response body for `POST /agent-sessions/preview`: one entry per distinct+requested id, in no particular order.++Clients deserialize this, so both derives are used.+ */+export interface PreviewAgentSessionsResponse {+ /** What the caller may see of each requested session. */+ previews: AgentSessionPreviewDto[];+}diff --git a/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/withAgentSessionId.ts b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/withAgentSessionId.tsnew file mode 100644index 0000000000..1182c47981--- /dev/null+++ b/apps/web/src/lib/service-clients/service-agent-harness/generated/schemas/withAgentSessionId.ts@@ -0,0 +1,16 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * agent_harness_service+ * OpenAPI spec version: 0.1.0+ */++/**+ * Just a session id, for the preview variants that carry nothing else.++Clients deserialize this, so both derives are used.+ */+export interface WithAgentSessionId {+ /** The session id. */+ id: string;+}diff --git a/apps/web/src/lib/service-clients/service-agent-harness/openapi.json b/apps/web/src/lib/service-clients/service-agent-harness/openapi.jsonindex 9f079d8c48..6a2ae69114 100644--- a/apps/web/src/lib/service-clients/service-agent-harness/openapi.json+++ b/apps/web/src/lib/service-clients/service-agent-harness/openapi.json@@ -228,6 +228,66 @@}}},+ "/agent-sessions/preview": {+ "post": {+ "tags": ["agent-sessions"],+ "summary": "Preview a batch of agent sessions for rendering chips.",+ "description": "No per-id access extractor: a chip has to render for a session the caller\ncannot open, so access is answered per id in the body rather than\nenforced on the request. The caller learns the fields a chip shows for\nsessions they may view, and only existence for the rest.",+ "operationId": "preview_agent_sessions",+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PreviewAgentSessionsRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "description": "",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PreviewAgentSessionsResponse"+ }+ }+ }+ },+ "400": {+ "description": "more than the maximum number of session ids",+ "content": {+ "text/plain": {+ "schema": {+ "type": "string"+ }+ }+ }+ },+ "401": {+ "description": "",+ "content": {+ "text/plain": {+ "schema": {+ "type": "string"+ }+ }+ }+ },+ "500": {+ "description": "",+ "content": {+ "text/plain": {+ "schema": {+ "type": "string"+ }+ }+ }+ }+ }+ }+ },"/agent-sessions/{session_id}": {"get": {"tags": ["agent-sessions"],@@ -1054,6 +1114,115 @@}}},+ "AgentSessionPreviewData": {+ "type": "object",+ "description": "The fields a chip renders for a session the caller may view.\n\nClients deserialize this, so both derives are used.",+ "required": [+ "id",+ "name",+ "ownerId",+ "botId",+ "status",+ "createdAt",+ "modifiedAt"+ ],+ "properties": {+ "botId": {+ "type": "string",+ "format": "uuid",+ "description": "The bot running the agent."+ },+ "createdAt": {+ "type": "string",+ "format": "date-time",+ "description": "When the session was created."+ },+ "id": {+ "type": "string",+ "format": "uuid",+ "description": "The session id."+ },+ "modifiedAt": {+ "type": "string",+ "format": "date-time",+ "description": "When the session was last modified."+ },+ "name": {+ "type": "string",+ "description": "User-facing session name."+ },+ "ownerId": {+ "type": "string",+ "description": "The user who owns the session."+ },+ "status": {+ "$ref": "#/components/schemas/SessionStatusDto",+ "description": "The session's last known status."+ }+ }+ },+ "AgentSessionPreviewDto": {+ "oneOf": [+ {+ "allOf": [+ {+ "$ref": "#/components/schemas/AgentSessionPreviewData",+ "description": "The caller may view the session."+ },+ {+ "type": "object",+ "required": ["type"],+ "properties": {+ "type": {+ "type": "string",+ "enum": ["access"]+ }+ }+ }+ ],+ "description": "The caller may view the session."+ },+ {+ "allOf": [+ {+ "$ref": "#/components/schemas/WithAgentSessionId",+ "description": "The session exists but the caller holds no grant on it."+ },+ {+ "type": "object",+ "required": ["type"],+ "properties": {+ "type": {+ "type": "string",+ "enum": ["no_access"]+ }+ }+ }+ ],+ "description": "The session exists but the caller holds no grant on it."+ },+ {+ "allOf": [+ {+ "$ref": "#/components/schemas/WithAgentSessionId",+ "description": "No session with this id exists."+ },+ {+ "type": "object",+ "required": ["type"],+ "properties": {+ "type": {+ "type": "string",+ "enum": ["does_not_exist"]+ }+ }+ }+ ],+ "description": "No session with this id exists."+ }+ ],+ "description": "What one requested id resolved to, on the wire.\n\nTagged the same way the chat and document preview endpoints tag theirs\n(`type` in `access` / `no_access` / `does_not_exist`), so a client that\nrenders those chips can render this one with the same branch.\n\nClients deserialize this, so both derives are used."+ },"AgentSessionQueueResponse": {"type": "object","description": "Response body for a session's queue: everything waiting, oldest first.\n\nA wrapper rather than a bare array so that anything which is about the\nresponse rather than about an entry has somewhere to go later without\nbreaking every client.",@@ -1481,6 +1650,35 @@"description": "Harness names accepted by the model discovery endpoint.","enum": ["in-memory", "cursor", "macrod"]},+ "PreviewAgentSessionsRequest": {+ "type": "object",+ "description": "Request body for `POST /agent-sessions/preview`.\n\nClients serialize this, so both derives are used.",+ "required": ["sessionIds"],+ "properties": {+ "sessionIds": {+ "type": "array",+ "items": {+ "type": "string",+ "format": "uuid"+ },+ "description": "The sessions to preview. Duplicates are collapsed server-side; at most\n[`MAX_PREVIEW_SESSION_IDS`](crate::domain::model::MAX_PREVIEW_SESSION_IDS)\ndistinct ids per request."+ }+ }+ },+ "PreviewAgentSessionsResponse": {+ "type": "object",+ "description": "Response body for `POST /agent-sessions/preview`: one entry per distinct\nrequested id, in no particular order.\n\nClients deserialize this, so both derives are used.",+ "required": ["previews"],+ "properties": {+ "previews": {+ "type": "array",+ "items": {+ "$ref": "#/components/schemas/AgentSessionPreviewDto"+ },+ "description": "What the caller may see of each requested session."+ }+ }+ },"QueuedActionDto": {"type": "object","description": "One action waiting in a session's queue.\n\nClients deserialize this, so both derives are used.",@@ -1596,6 +1794,18 @@}],"description": "Transport representation of a session's status, mirroring\n[`SessionStatus`]."+ },+ "WithAgentSessionId": {+ "type": "object",+ "description": "Just a session id, for the preview variants that carry nothing else.\n\nClients deserialize this, so both derives are used.",+ "required": ["id"],+ "properties": {+ "id": {+ "type": "string",+ "format": "uuid",+ "description": "The session id."+ }+ }}},"securitySchemes": {diff --git a/apps/web/src/lib/service-clients/service-search/generated/models/agentSessionFilters.ts b/apps/web/src/lib/service-clients/service-search/generated/models/agentSessionFilters.tsnew file mode 100644index 0000000000..102511dd35--- /dev/null+++ b/apps/web/src/lib/service-clients/service-search/generated/models/agentSessionFilters.ts@@ -0,0 +1,21 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * search_service+ * OpenAPI spec version: 0.1.0+ */++/**+ * Filters for agent sessions.+ */+export interface AgentSessionFilters {+ /** Agent session ids to filter by. Empty to include all accessible sessions. */+ ids?: string[];+ /** Opt this query into agent sessions at all. Agent sessions are off by+default — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].+Asking for specific `ids` or `owners` also opts in. */+ include?: boolean;+ /** Filter by session owner. Examples: ['macro|[email protected]']. Empty to+include every owner. */+ owners?: string[];+}diff --git a/apps/web/src/lib/service-clients/service-search/generated/models/entityFilters.ts b/apps/web/src/lib/service-clients/service-search/generated/models/entityFilters.tsindex fa7aec3da2..94a7cf02e4 100644--- a/apps/web/src/lib/service-clients/service-search/generated/models/entityFilters.ts+++ b/apps/web/src/lib/service-clients/service-search/generated/models/entityFilters.ts@@ -4,6 +4,7 @@* search_service* OpenAPI spec version: 0.1.0*/+import type { AgentSessionFilters } from './agentSessionFilters';import type { CalendarEventFilters } from './calendarEventFilters';import type { CallFilters } from './callFilters';import type { ChannelFilters } from './channelFilters';@@ -22,6 +23,8 @@ import type { TagFilterMode } from './tagFilterMode';* a bundle of all of the filters for each entity type*/export interface EntityFilters {+ /** the bundled [AgentSessionFilters] */+ agent_session_filters?: AgentSessionFilters;/** the bundled [CalendarEventFilters] */calendar_event_filters?: CalendarEventFilters;/** the bundled [CallFilters] */diff --git a/apps/web/src/lib/service-clients/service-search/generated/models/index.ts b/apps/web/src/lib/service-clients/service-search/generated/models/index.tsindex 9816535d3d..96763bc8be 100644--- a/apps/web/src/lib/service-clients/service-search/generated/models/index.ts+++ b/apps/web/src/lib/service-clients/service-search/generated/models/index.ts@@ -5,6 +5,7 @@* OpenAPI spec version: 0.1.0*/+export * from './agentSessionFilters';export * from './calendarEventFilters';export * from './calendarEventFiltersEndsAfter';export * from './calendarEventFiltersStartsBefore';diff --git a/apps/web/src/lib/service-clients/service-search/openapi.json b/apps/web/src/lib/service-clients/service-search/openapi.jsonindex ff38d16210..815a639a14 100644--- a/apps/web/src/lib/service-clients/service-search/openapi.json+++ b/apps/web/src/lib/service-clients/service-search/openapi.json@@ -173,6 +173,30 @@},"components": {"schemas": {+ "AgentSessionFilters": {+ "type": "object",+ "description": "Filters for agent sessions.",+ "properties": {+ "ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Agent session ids to filter by. Empty to include all accessible sessions."+ },+ "include": {+ "type": "boolean",+ "description": "Opt this query into agent sessions at all. Agent sessions are off by\ndefault — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].\nAsking for specific `ids` or `owners` also opts in."+ },+ "owners": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Filter by session owner. Examples: ['macro|[email protected]']. Empty to\ninclude every owner."+ }+ }+ },"CalendarEventFilters": {"type": "object","description": "Filters for canonical calendar-event entities.",@@ -2022,6 +2046,10 @@"type": "object","description": "a bundle of all of the filters for each entity type","properties": {+ "agent_session_filters": {+ "$ref": "#/components/schemas/AgentSessionFilters",+ "description": "the bundled [AgentSessionFilters]"+ },"calendar_event_filters": {"$ref": "#/components/schemas/CalendarEventFilters","description": "the bundled [CalendarEventFilters]"diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/agentSessionFilters.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/agentSessionFilters.tsnew file mode 100644index 0000000000..a16c81c3c9--- /dev/null+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/agentSessionFilters.ts@@ -0,0 +1,21 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * document_storage_service+ * OpenAPI spec version: 0.1.0+ */++/**+ * Filters for agent sessions.+ */+export interface AgentSessionFilters {+ /** Agent session ids to filter by. Empty to include all accessible sessions. */+ ids?: string[];+ /** Opt this query into agent sessions at all. Agent sessions are off by+default — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].+Asking for specific `ids` or `owners` also opts in. */+ include?: boolean;+ /** Filter by session owner. Examples: ['macro|[email protected]']. Empty to+include every owner. */+ owners?: string[];+}diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/apiEntityFilterAst.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/apiEntityFilterAst.tsindex cf7eb60727..38209efbee 100644--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/apiEntityFilterAst.ts+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/apiEntityFilterAst.ts@@ -9,6 +9,10 @@* Wire-format entity filter AST accepted by soup AST endpoints.*/export interface ApiEntityFilterAst {+ /** Filters applied to agent sessions (wire key `asf`). Like reminders,+empty/omitted returns **no** agent sessions: they are opt-in, so the+caller must send `inc`, an id, or an owner to get any. */+ asf?: unknown;/** filters applied to canonical calendar events */calf?: unknown;/** the filters that should be applied to the call entity */diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/entityFilters.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/entityFilters.tsindex e8c83e97b7..5ae2cd1670 100644--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/entityFilters.ts+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/entityFilters.ts@@ -4,6 +4,7 @@* document_storage_service* OpenAPI spec version: 0.1.0*/+import type { AgentSessionFilters } from './agentSessionFilters';import type { CalendarEventFilters } from './calendarEventFilters';import type { CallFilters } from './callFilters';import type { ChannelFilters } from './channelFilters';@@ -22,6 +23,8 @@ import type { TagFilterMode } from './tagFilterMode';* a bundle of all of the filters for each entity type*/export interface EntityFilters {+ /** the bundled [AgentSessionFilters] */+ agent_session_filters?: AgentSessionFilters;/** the bundled [CalendarEventFilters] */calendar_event_filters?: CalendarEventFilters;/** the bundled [CallFilters] */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.tsindex f16aca98f2..a599354d25 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@@ -23,6 +23,7 @@ export * from './agentMcpServersOneOf';export * from './agentMcpServersOneOfScope';export * from './agentMcpServersOneOfThree';export * from './agentMcpServersOneOfThreeScope';+export * from './agentSessionFilters';export * from './agentSessionLifecycleEvent';export * from './agentSessionLifecycleEventOneOf';export * from './agentSessionLifecycleEventOneOfEventType';@@ -1080,6 +1081,11 @@ export * from './sharePermissionV2LinkShare';export * from './sharePermissionV2LinkShareAccessLevel';export * from './shortIdResponse';export * from './simpleMention';+export * from './soupAgentSessionSoupPropertiesField';+export * from './soupAgentSessionSoupPropertiesFieldAllOf';+export * from './soupAgentSessionSoupPropertiesFieldAllOfTwo';+export * from './soupAgentSessionSoupPropertiesFieldAllOfTwoThreadId';+export * from './soupAgentSessionSoupPropertiesFieldAllOfTwoViewedAt';export * from './soupApiItem';export * from './soupApiItemAllOf';export * from './soupApiItemAllOfNotifiedAt';@@ -1198,6 +1204,8 @@ export * from './soupItemOneOfThree';export * from './soupItemOneOfThreeTag';export * from './soupItemOneOfTwoone';export * from './soupItemOneOfTwooneTag';+export * from './soupItemOneOfTwothree';+export * from './soupItemOneOfTwothreeTag';export * from './soupLabel';export * from './soupLabelListVisibility';export * from './soupLabelType';diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesField.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesField.tsnew file mode 100644index 0000000000..3ec00616f3--- /dev/null+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesField.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 { SoupAgentSessionSoupPropertiesFieldAllOf } from './soupAgentSessionSoupPropertiesFieldAllOf';+import type { SoupAgentSessionSoupPropertiesFieldAllOfTwo } from './soupAgentSessionSoupPropertiesFieldAllOfTwo';++/**+ * An agent session as displayed in Soup.++Mirrors [`crate::chat::SoupChat`]: an agent session is the coding-agent+counterpart of a chat, so it carries the same identity, ownership, and+recency fields plus the session's last known status.+ */+export type SoupAgentSessionSoupPropertiesField =+ SoupAgentSessionSoupPropertiesFieldAllOf &+ SoupAgentSessionSoupPropertiesFieldAllOfTwo;diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOf.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOf.tsnew file mode 100644index 0000000000..5c0f728be4--- /dev/null+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOf.ts@@ -0,0 +1,15 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * document_storage_service+ * OpenAPI spec version: 0.1.0+ */+import type { SoupProperty } from './soupProperty';++/**+ * Property fields that can be flattened into property-bearing Soup items.+ */+export type SoupAgentSessionSoupPropertiesFieldAllOf = {+ /** Properties attached to the entity. */+ properties: SoupProperty[];+};diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOfTwo.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOfTwo.tsnew file mode 100644index 0000000000..a6425575b2--- /dev/null+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOfTwo.ts@@ -0,0 +1,33 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * document_storage_service+ * OpenAPI spec version: 0.1.0+ */+import type { SoupAgentSessionSoupPropertiesFieldAllOfTwoThreadId } from './soupAgentSessionSoupPropertiesFieldAllOfTwoThreadId';+import type { SoupAgentSessionSoupPropertiesFieldAllOfTwoViewedAt } from './soupAgentSessionSoupPropertiesFieldAllOfTwoViewedAt';++export type SoupAgentSessionSoupPropertiesFieldAllOfTwo = {+ /** The bot running this session */+ botId: string;+ /** The time the session was created */+ createdAt: string;+ /** The agent session uuid */+ id: string;+ /** The user-facing name of the session */+ name: string;+ /** Who the session belongs to */+ ownerId: string;+ /** The session's last known status.++`no_messages` until the first system event arrives, `disconnected` if+the connection dropped without a clean close, otherwise the wire name+of the most recent system event (for example `session/end`). */+ status: string;+ /** The channel thread the session was opened from, when any */+ threadId?: SoupAgentSessionSoupPropertiesFieldAllOfTwoThreadId;+ /** The time the session was last modified */+ updatedAt: string;+ /** The time the session was last viewed by the requesting user */+ viewedAt?: SoupAgentSessionSoupPropertiesFieldAllOfTwoViewedAt;+};diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOfTwoThreadId.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOfTwoThreadId.tsnew file mode 100644index 0000000000..9e470577d8--- /dev/null+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOfTwoThreadId.ts@@ -0,0 +1,11 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * document_storage_service+ * OpenAPI spec version: 0.1.0+ */++/**+ * The channel thread the session was opened from, when any+ */+export type SoupAgentSessionSoupPropertiesFieldAllOfTwoThreadId = string | null;diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOfTwoViewedAt.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOfTwoViewedAt.tsnew file mode 100644index 0000000000..07d3ab436c--- /dev/null+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupAgentSessionSoupPropertiesFieldAllOfTwoViewedAt.ts@@ -0,0 +1,11 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * document_storage_service+ * OpenAPI spec version: 0.1.0+ */++/**+ * The time the session was last viewed by the requesting user+ */+export type SoupAgentSessionSoupPropertiesFieldAllOfTwoViewedAt = string | null;diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupItem.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupItem.tsindex c4f308ef04..1dfab2271d 100644--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupItem.ts+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupItem.ts@@ -15,6 +15,7 @@ import type { SoupItemOneOfOnethree } from './soupItemOneOfOnethree';import type { SoupItemOneOfSeven } from './soupItemOneOfSeven';import type { SoupItemOneOfThree } from './soupItemOneOfThree';import type { SoupItemOneOfTwoone } from './soupItemOneOfTwoone';+import type { SoupItemOneOfTwothree } from './soupItemOneOfTwothree';/*** A single item in the Soup feed.@@ -30,4 +31,5 @@ export type SoupItem =| SoupItemOneOfOnefive| SoupItemOneOfOneseven| SoupItemOneOfOnenine- | SoupItemOneOfTwoone;+ | SoupItemOneOfTwoone+ | SoupItemOneOfTwothree;diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupItemOneOfTwothree.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupItemOneOfTwothree.tsnew file mode 100644index 0000000000..7f93f39791--- /dev/null+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupItemOneOfTwothree.ts@@ -0,0 +1,17 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * document_storage_service+ * OpenAPI spec version: 0.1.0+ */+import type { SoupAgentSessionSoupPropertiesField } from './soupAgentSessionSoupPropertiesField';+import type { SoupItemOneOfTwothreeTag } from './soupItemOneOfTwothreeTag';++/**+ * Agent session item.+ */+export type SoupItemOneOfTwothree = {+ /** Agent session item. */+ data: SoupAgentSessionSoupPropertiesField;+ tag: SoupItemOneOfTwothreeTag;+};diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupItemOneOfTwothreeTag.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupItemOneOfTwothreeTag.tsnew file mode 100644index 0000000000..2d96bdae62--- /dev/null+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/soupItemOneOfTwothreeTag.ts@@ -0,0 +1,14 @@+/**+ * Generated by orval v7.21.0 🍺+ * Do not edit manually.+ * document_storage_service+ * OpenAPI spec version: 0.1.0+ */++export type SoupItemOneOfTwothreeTag =+ (typeof SoupItemOneOfTwothreeTag)[keyof typeof SoupItemOneOfTwothreeTag];++// eslint-disable-next-line @typescript-eslint/no-redeclare+export const SoupItemOneOfTwothreeTag = {+ agentSession: 'agentSession',+} as const;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.tsindex cfadd3129a..5b60c58085 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@@ -12296,6 +12296,277 @@ export const getItemsSoupResponse = zodtag: zod.enum(['reminder']),}).describe('Reminder item.'),+ zod+ .object({+ data: zod+ .object({+ properties: zod+ .array(+ zod+ .object({+ definition: zod+ .object({+ created_at: zod.iso.datetime({}),+ data_type: zod+ .enum([+ 'BOOLEAN',+ 'DATE',+ 'NUMBER',+ 'STRING',+ 'SELECT_NUMBER',+ 'SELECT_STRING',+ 'TAG',+ 'ENTITY',+ 'LINK',+ ])+ .describe(+ 'Data type for property values, determining storage and validation.'+ ),+ display_name: zod.string(),+ id: zod.uuid(),+ is_metadata: zod+ .boolean()+ .describe(+ 'Flag to indicate if this is a system-generated metadata property.\nNot stored in database - computed at service layer.'+ ),+ is_multi_select: zod.boolean(),+ is_system: zod+ .boolean()+ .describe(+ 'Flag to indicate if this is a system property (stored in DB).'+ ),+ owner: zod+ .union([+ zod+ .object({+ scope: zod.enum(['user']),+ user_id: zod.string(),+ })+ .describe('User-scoped property.'),+ zod+ .object({+ scope: zod.enum(['team']),+ team_id: zod.uuid(),+ })+ .describe('Team-scoped property.'),+ zod+ .object({+ scope: zod.enum(['system']),+ })+ .describe(+ 'System-owned property (no user or team owner).'+ ),+ ])+ .describe(+ 'Defines who owns a property - user-scoped, team-scoped, or system.'+ ),+ specific_entity_type: zod+ .union([+ zod.null(),+ zod+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ])+ .describe(+ 'Type of entity that can be referenced by entity properties.'+ ),+ ])+ .optional(),+ updated_at: zod.iso.datetime({}),+ })+ .describe(+ 'Property definition model (service representation).'+ ),+ id: zod+ .uuid()+ .describe(+ 'Globally unique id of the assignment attaching this property to an entity.'+ ),+ value: zod+ .union([+ zod.null(),+ zod+ .union([+ zod+ .object({+ type: zod.enum(['Boolean']),+ value: zod+ .boolean()+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ })+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ zod+ .object({+ type: zod.enum(['Number']),+ value: zod+ .number()+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ })+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ zod+ .object({+ type: zod.enum(['String']),+ value: zod+ .string()+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ })+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ zod+ .object({+ type: zod.enum(['Date']),+ value: zod.iso+ .datetime({})+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ })+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ zod+ .object({+ type: zod.enum(['SelectOption']),+ value: zod+ .array(zod.uuid())+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ })+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['EntityReference']),+ value: zod+ .array(+ zod+ .object({+ entity_id: zod.string(),+ entity_type: zod+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ])+ .describe(+ 'Type of entity that can be referenced by entity properties.'+ ),+ specific_message_id: zod+ .uuid()+ .nullish()+ .describe(+ 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'+ ),+ })+ .describe(+ 'Entity reference for entity-type property values.'+ )+ )+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ })+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['Link']),+ value: zod+ .array(zod.string())+ .describe(+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'+ ),+ })+ .describe(+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'+ ),+ ])+ .describe(+ 'Property value (service representation).\n\nRepresents the actual value stored for an entity property.\nThis is serialized to\/from JSONB in the database.'+ ),+ ])+ .optional(),+ })+ .describe(+ 'A property attached to a Soup item.\n\nThis is a simplified representation that includes only the definition and value,\nomitting the entity property assignment metadata and options.'+ )+ )+ .describe('Properties attached to the entity.'),+ })+ .describe(+ 'Property fields that can be flattened into property-bearing Soup items.'+ )+ .and(+ zod.object({+ botId: zod.uuid().describe('The bot running this session'),+ createdAt: zod.iso+ .datetime({})+ .describe('The time the session was created'),+ id: zod.uuid().describe('The agent session uuid'),+ name: zod+ .string()+ .describe('The user-facing name of the session'),+ ownerId: zod+ .string()+ .describe('Who the session belongs to'),+ status: zod+ .string()+ .describe(+ "The session's last known status.\n\n`no_messages` until the first system event arrives, `disconnected` if\nthe connection dropped without a clean close, otherwise the wire name\nof the most recent system event (for example `session\/end`)."+ ),+ threadId: zod+ .uuid()+ .nullish()+ .describe(+ 'The channel thread the session was opened from, when any'+ ),+ updatedAt: zod.iso+ .datetime({})+ .describe('The time the session was last modified'),+ viewedAt: zod.iso+ .datetime({})+ .nullish()+ .describe(+ 'The time the session was last viewed by the requesting user'+ ),+ })+ )+ .describe(+ "An agent session as displayed in Soup.\n\nMirrors [`crate::chat::SoupChat`]: an agent session is the coding-agent\ncounterpart of a chat, so it carries the same identity, ownership, and\nrecency fields plus the session's last known status."+ ),+ tag: zod.enum(['agentSession']),+ })+ .describe('Agent session item.'),]).describe('A single item in the Soup feed.').and(@@ -12339,6 +12610,29 @@ export const postItemsSoupBodyLimitMin = 0;export const postItemsSoupBody = zod.object({+ agent_session_filters: zod+ .object({+ ids: zod+ .array(zod.string())+ .optional()+ .describe(+ 'Agent session ids to filter by. Empty to include all accessible sessions.'+ ),+ include: zod+ .boolean()+ .optional()+ .describe(+ 'Opt this query into agent sessions at all. Agent sessions are off by\ndefault — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].\nAsking for specific `ids` or `owners` also opts in.'+ ),+ owners: zod+ .array(zod.string())+ .optional()+ .describe(+ "Filter by session owner. Examples: ['macro|[email protected]']. Empty to\ninclude every owner."+ ),+ })+ .optional()+ .describe('Filters for agent sessions.'),calendar_event_filters: zod.object({attendees: zod@@ -15950,19 +16244,290 @@ export const postItemsSoupResponse = zod),]).describe(- 'How often a reminder fires, flattened for the wire.\n\nThe domain\'s [`ReminderSchedule`] is an internally-tagged enum carrying a\nvalidated cron type; Soup only needs enough to render \"once\" vs \"every\nweekday at 9am\", so the cron is exposed as a plain string.'+ 'How often a reminder fires, flattened for the wire.\n\nThe domain\'s [`ReminderSchedule`] is an internally-tagged enum carrying a\nvalidated cron type; Soup only needs enough to render \"once\" vs \"every\nweekday at 9am\", so the cron is exposed as a plain string.'+ ),+ updatedAt: zod.iso+ .datetime({})+ .describe('When the reminder was last modified.'),+ })+ )+ .describe(+ "A reminder as displayed in Soup.\n\nReminders are user-owned rather than shared, so unlike most Soup items they\ncarry no access metadata — the repository only ever returns the caller's own."+ ),+ tag: zod.enum(['reminder']),+ })+ .describe('Reminder item.'),+ zod+ .object({+ data: zod+ .object({+ properties: zod+ .array(+ zod+ .object({+ definition: zod+ .object({+ created_at: zod.iso.datetime({}),+ data_type: zod+ .enum([+ 'BOOLEAN',+ 'DATE',+ 'NUMBER',+ 'STRING',+ 'SELECT_NUMBER',+ 'SELECT_STRING',+ 'TAG',+ 'ENTITY',+ 'LINK',+ ])+ .describe(+ 'Data type for property values, determining storage and validation.'+ ),+ display_name: zod.string(),+ id: zod.uuid(),+ is_metadata: zod+ .boolean()+ .describe(+ 'Flag to indicate if this is a system-generated metadata property.\nNot stored in database - computed at service layer.'+ ),+ is_multi_select: zod.boolean(),+ is_system: zod+ .boolean()+ .describe(+ 'Flag to indicate if this is a system property (stored in DB).'+ ),+ owner: zod+ .union([+ zod+ .object({+ scope: zod.enum(['user']),+ user_id: zod.string(),+ })+ .describe('User-scoped property.'),+ zod+ .object({+ scope: zod.enum(['team']),+ team_id: zod.uuid(),+ })+ .describe('Team-scoped property.'),+ zod+ .object({+ scope: zod.enum(['system']),+ })+ .describe(+ 'System-owned property (no user or team owner).'+ ),+ ])+ .describe(+ 'Defines who owns a property - user-scoped, team-scoped, or system.'+ ),+ specific_entity_type: zod+ .union([+ zod.null(),+ zod+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ])+ .describe(+ 'Type of entity that can be referenced by entity properties.'+ ),+ ])+ .optional(),+ updated_at: zod.iso.datetime({}),+ })+ .describe(+ 'Property definition model (service representation).'+ ),+ id: zod+ .uuid()+ .describe(+ 'Globally unique id of the assignment attaching this property to an entity.'+ ),+ value: zod+ .union([+ zod.null(),+ zod+ .union([+ zod+ .object({+ type: zod.enum(['Boolean']),+ value: zod+ .boolean()+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ })+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ zod+ .object({+ type: zod.enum(['Number']),+ value: zod+ .number()+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ })+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ zod+ .object({+ type: zod.enum(['String']),+ value: zod+ .string()+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ })+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ zod+ .object({+ type: zod.enum(['Date']),+ value: zod.iso+ .datetime({})+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ })+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ zod+ .object({+ type: zod.enum(['SelectOption']),+ value: zod+ .array(zod.uuid())+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ })+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['EntityReference']),+ value: zod+ .array(+ zod+ .object({+ entity_id: zod.string(),+ entity_type: zod+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ])+ .describe(+ 'Type of entity that can be referenced by entity properties.'+ ),+ specific_message_id: zod+ .uuid()+ .nullish()+ .describe(+ 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'+ ),+ })+ .describe(+ 'Entity reference for entity-type property values.'+ )+ )+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ })+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['Link']),+ value: zod+ .array(zod.string())+ .describe(+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'+ ),+ })+ .describe(+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'+ ),+ ])+ .describe(+ 'Property value (service representation).\n\nRepresents the actual value stored for an entity property.\nThis is serialized to\/from JSONB in the database.'+ ),+ ])+ .optional(),+ })+ .describe(+ 'A property attached to a Soup item.\n\nThis is a simplified representation that includes only the definition and value,\nomitting the entity property assignment metadata and options.'+ )+ )+ .describe('Properties attached to the entity.'),+ })+ .describe(+ 'Property fields that can be flattened into property-bearing Soup items.'+ )+ .and(+ zod.object({+ botId: zod.uuid().describe('The bot running this session'),+ createdAt: zod.iso+ .datetime({})+ .describe('The time the session was created'),+ id: zod.uuid().describe('The agent session uuid'),+ name: zod+ .string()+ .describe('The user-facing name of the session'),+ ownerId: zod+ .string()+ .describe('Who the session belongs to'),+ status: zod+ .string()+ .describe(+ "The session's last known status.\n\n`no_messages` until the first system event arrives, `disconnected` if\nthe connection dropped without a clean close, otherwise the wire name\nof the most recent system event (for example `session\/end`)."+ ),+ threadId: zod+ .uuid()+ .nullish()+ .describe(+ 'The channel thread the session was opened from, when any'),updatedAt: zod.iso.datetime({})- .describe('When the reminder was last modified.'),+ .describe('The time the session was last modified'),+ viewedAt: zod.iso+ .datetime({})+ .nullish()+ .describe(+ 'The time the session was last viewed by the requesting user'+ ),})).describe(- "A reminder as displayed in Soup.\n\nReminders are user-owned rather than shared, so unlike most Soup items they\ncarry no access metadata — the repository only ever returns the caller's own."+ "An agent session as displayed in Soup.\n\nMirrors [`crate::chat::SoupChat`]: an agent session is the coding-agent\ncounterpart of a chat, so it carries the same identity, ownership, and\nrecency fields plus the session's last known status."),- tag: zod.enum(['reminder']),+ tag: zod.enum(['agentSession']),})- .describe('Reminder item.'),+ .describe('Agent session item.'),]).describe('A single item in the Soup feed.').and(@@ -16006,6 +16571,12 @@ export const postItemsSoupAstBodyLimitMin = 0;export const postItemsSoupAstBody = zod.object({+ asf: zod+ .unknown()+ .optional()+ .describe(+ 'Filters applied to agent sessions (wire key `asf`). Like reminders,\nempty\/omitted returns \*\*no\*\* agent sessions: they are opt-in, so the\ncaller must send `inc`, an id, or an owner to get any.'+ ),calf: zod.unknown().optional()@@ -18180,222 +18751,571 @@ export const postItemsSoupAstResponse = zodupdated_at: zod.iso.datetime({}),}).describe(- 'Property definition model (service representation).'+ 'Property definition model (service representation).'+ ),+ id: zod+ .uuid()+ .describe(+ 'Globally unique id of the assignment attaching this property to an entity.'+ ),+ value: zod+ .union([+ zod.null(),+ zod+ .union([+ zod+ .object({+ type: zod.enum(['Boolean']),+ value: zod+ .boolean()+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ })+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ zod+ .object({+ type: zod.enum(['Number']),+ value: zod+ .number()+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ })+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ zod+ .object({+ type: zod.enum(['String']),+ value: zod+ .string()+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ })+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ zod+ .object({+ type: zod.enum(['Date']),+ value: zod.iso+ .datetime({})+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ })+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ zod+ .object({+ type: zod.enum(['SelectOption']),+ value: zod+ .array(zod.uuid())+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ })+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['EntityReference']),+ value: zod+ .array(+ zod+ .object({+ entity_id: zod.string(),+ entity_type: zod+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ])+ .describe(+ 'Type of entity that can be referenced by entity properties.'+ ),+ specific_message_id: zod+ .uuid()+ .nullish()+ .describe(+ 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'+ ),+ })+ .describe(+ 'Entity reference for entity-type property values.'+ )+ )+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ })+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['Link']),+ value: zod+ .array(zod.string())+ .describe(+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'+ ),+ })+ .describe(+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'+ ),+ ])+ .describe(+ 'Property value (service representation).\n\nRepresents the actual value stored for an entity property.\nThis is serialized to\/from JSONB in the database.'+ ),+ ])+ .optional(),+ })+ .describe(+ 'A property attached to a Soup item.\n\nThis is a simplified representation that includes only the definition and value,\nomitting the entity property assignment metadata and options.'+ )+ )+ .describe('Properties attached to the entity.'),+ })+ .describe(+ 'Property fields that can be flattened into property-bearing Soup items.'+ ),+ icalUid: zod+ .string()+ .describe('RFC 5545 UID used for source reconciliation.'),+ id: zod.uuid().describe('Entity identifier.'),+ isReadOnly: zod+ .boolean()+ .describe(+ 'Whether the selected canonical source is read-only.'+ ),+ lastReminderFiredAt: zod.iso+ .datetime({})+ .nullish()+ .describe(+ "When this event's most recent reminder notification was delivered."+ ),+ location: zod+ .string()+ .nullish()+ .describe('Optional location label.'),+ organizerEmail: zod+ .string()+ .nullish()+ .describe('Organizer email.'),+ organizerName: zod+ .string()+ .nullish()+ .describe('Organizer display name.'),+ ownerId: zod.string().describe('Owning Macro user.'),+ status: zod.string().describe('Canonical status.'),+ time: zod+ .union([+ zod+ .object({+ endsAt: zod.iso+ .datetime({})+ .describe('Exclusive end.'),+ kind: zod.enum(['timed']),+ startsAt: zod.iso+ .datetime({})+ .describe('Inclusive start.'),+ timeZone: zod+ .string()+ .nullish()+ .describe('Original IANA time zone.'),+ })+ .describe('Absolute timed event.'),+ zod+ .object({+ endDate: zod.iso+ .date()+ .describe('Exclusive end date.'),+ kind: zod.enum(['allDay']),+ startDate: zod.iso+ .date()+ .describe('Inclusive start date.'),+ })+ .describe('All-day event with an exclusive end date.'),+ ])+ .describe(+ 'Timed or all-day calendar event span.\n\nFields are camelCased per variant rather than via `rename_all_fields`,\nwhich utoipa ignores — the generated OpenAPI schema would otherwise\nclaim snake_case fields the wire never carries.'+ ),+ title: zod.string().describe('Display title.'),+ transparency: zod+ .string()+ .describe('Availability transparency.'),+ updatedAt: zod.iso+ .datetime({})+ .describe('Entity update timestamp.'),+ visibility: zod.string().describe('Canonical visibility.'),+ })+ .describe('A canonical calendar event entity in Soup.'),+ tag: zod.enum(['calendarEvent']),+ })+ .describe('Calendar event item.'),+ zod+ .object({+ data: zod+ .object({+ properties: zod+ .array(+ zod+ .object({+ definition: zod+ .object({+ created_at: zod.iso.datetime({}),+ data_type: zod+ .enum([+ 'BOOLEAN',+ 'DATE',+ 'NUMBER',+ 'STRING',+ 'SELECT_NUMBER',+ 'SELECT_STRING',+ 'TAG',+ 'ENTITY',+ 'LINK',+ ])+ .describe(+ 'Data type for property values, determining storage and validation.'),- id: zod- .uuid()+ display_name: zod.string(),+ id: zod.uuid(),+ is_metadata: zod+ .boolean().describe(- 'Globally unique id of the assignment attaching this property to an entity.'+ 'Flag to indicate if this is a system-generated metadata property.\nNot stored in database - computed at service layer.'),- value: zod+ is_multi_select: zod.boolean(),+ is_system: zod+ .boolean()+ .describe(+ 'Flag to indicate if this is a system property (stored in DB).'+ ),+ owner: zod+ .union([+ zod+ .object({+ scope: zod.enum(['user']),+ user_id: zod.string(),+ })+ .describe('User-scoped property.'),+ zod+ .object({+ scope: zod.enum(['team']),+ team_id: zod.uuid(),+ })+ .describe('Team-scoped property.'),+ zod+ .object({+ scope: zod.enum(['system']),+ })+ .describe(+ 'System-owned property (no user or team owner).'+ ),+ ])+ .describe(+ 'Defines who owns a property - user-scoped, team-scoped, or system.'+ ),+ specific_entity_type: zod.union([zod.null(),zod- .union([- zod- .object({- type: zod.enum(['Boolean']),- value: zod- .boolean()- .describe(- 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'- ),- })+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ])+ .describe(+ 'Type of entity that can be referenced by entity properties.'+ ),+ ])+ .optional(),+ updated_at: zod.iso.datetime({}),+ })+ .describe(+ 'Property definition model (service representation).'+ ),+ id: zod+ .uuid()+ .describe(+ 'Globally unique id of the assignment attaching this property to an entity.'+ ),+ value: zod+ .union([+ zod.null(),+ zod+ .union([+ zod+ .object({+ type: zod.enum(['Boolean']),+ value: zod+ .boolean().describe('Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'),- zod- .object({- type: zod.enum(['Number']),- value: zod- .number()- .describe(- 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'- ),- })+ })+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ zod+ .object({+ type: zod.enum(['Number']),+ value: zod+ .number().describe('Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'),- zod- .object({- type: zod.enum(['String']),- value: zod- .string()- .describe(- 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'- ),- })+ })+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ zod+ .object({+ type: zod.enum(['String']),+ value: zod+ .string().describe('String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'),- zod- .object({- type: zod.enum(['Date']),- value: zod.iso- .datetime({})- .describe(- 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'- ),- })+ })+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ zod+ .object({+ type: zod.enum(['Date']),+ value: zod.iso+ .datetime({}).describe('Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'),- zod- .object({- type: zod.enum(['SelectOption']),- value: zod- .array(zod.uuid())- .describe(- 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'- ),- })+ })+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ zod+ .object({+ type: zod.enum(['SelectOption']),+ value: zod+ .array(zod.uuid()).describe('Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'),- zod- .object({- type: zod.enum(['EntityReference']),- value: zod- .array(- zod- .object({- entity_id: zod.string(),- entity_type: zod- .enum([- 'CALENDAR_EVENT',- 'CALL_RECORD',- 'CHANNEL',- 'CHAT',- 'COMPANY',- 'DOCUMENT',- 'PROJECT',- 'TASK',- 'THREAD',- 'USER',- ])- .describe(- 'Type of entity that can be referenced by entity properties.'- ),- specific_message_id: zod- .uuid()- .nullish()- .describe(- 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'- ),- })+ })+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['EntityReference']),+ value: zod+ .array(+ zod+ .object({+ entity_id: zod.string(),+ entity_type: zod+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ]).describe(- 'Entity reference for entity-type property values.'- )- )+ 'Type of entity that can be referenced by entity properties.'+ ),+ specific_message_id: zod+ .uuid()+ .nullish()+ .describe(+ 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'+ ),+ }).describe(- 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'- ),- })+ 'Entity reference for entity-type property values.'+ )+ ).describe('Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'),- zod- .object({- type: zod.enum(['Link']),- value: zod- .array(zod.string())- .describe(- 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'- ),- })+ })+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['Link']),+ value: zod+ .array(zod.string()).describe('Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'),- ])+ }).describe(- 'Property value (service representation).\n\nRepresents the actual value stored for an entity property.\nThis is serialized to\/from JSONB in the database.'+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'),])- .optional(),- })- .describe(- 'A property attached to a Soup item.\n\nThis is a simplified representation that includes only the definition and value,\nomitting the entity property assignment metadata and options.'- )+ .describe(+ 'Property value (service representation).\n\nRepresents the actual value stored for an entity property.\nThis is serialized to\/from JSONB in the database.'+ ),+ ])+ .optional(),+ })+ .describe(+ 'A property attached to a Soup item.\n\nThis is a simplified representation that includes only the definition and value,\nomitting the entity property assignment metadata and options.')- .describe('Properties attached to the entity.'),- })- .describe(- 'Property fields that can be flattened into property-bearing Soup items.'- ),- icalUid: zod+ )+ .describe('Properties attached to the entity.'),+ })+ .describe(+ 'Property fields that can be flattened into property-bearing Soup items.'+ )+ .and(+ zod.object({+ createdAt: zod.iso+ .datetime({})+ .describe('When the company was created.'),+ description: zod+ .string()+ .nullish()+ .describe(+ "Display description from the primary domain's directory entry."+ ),+ domains: zod+ .array(+ zod+ .object({+ companyId: zod+ .uuid()+ .describe(+ 'The id of the company the domain belongs to.'+ ),+ createdAt: zod.iso+ .datetime({})+ .describe('When the domain record was created.'),+ domain: zod+ .string()+ .describe(+ 'The domain (lowercased, e.g. \"acme.com\").'+ ),+ id: zod+ .uuid()+ .describe('The id of the domain record.'),+ })+ .describe(+ "A CRM domain as displayed in Soup. Mirrors the crm crate's\n[`CrmDomain`] with a stable wire shape that the FE can rely on."+ )+ )+ .describe(+ 'Domains associated with this company, ordered by creation time\nascending (primary first).'+ ),+ emailSync: zod+ .boolean()+ .describe(+ 'Whether email sync is enabled for this company.'+ ),+ hidden: zod+ .boolean()+ .describe(+ 'Whether the company is hidden from CRM listings. Soup filters\nthese out by default.'+ ),+ id: zod.uuid().describe('The id of the company.'),+ name: zod+ .string()+ .nullish()+ .describe(+ "Display name from the primary domain's directory entry, or\n`None` when unresolved."+ ),+ teamId: zod+ .uuid()+ .describe(+ 'The id of the team that owns this company record.'+ ),+ updatedAt: zod.iso+ .datetime({})+ .describe('When the company was last updated.'),+ viewedAt: zod.iso+ .datetime({})+ .nullish()+ .describe(+ 'When the requesting user last viewed this company, or `None` if\nnever viewed. Mirrors the `viewed_at` other soup entities carry.'+ ),+ })+ )+ .describe(+ 'A CRM company as displayed in Soup. Carries the core company\nfields plus display metadata resolved from `crm_domain_directory`\nagainst the primary (earliest-created) domain.'+ ),+ tag: zod.enum(['crmCompany']),+ })+ .describe('CRM company item.'),+ zod+ .object({+ data: zod+ .object({+ createdAt: zod.iso+ .datetime({})+ .describe('Timestamp when the record was created.'),+ foreignEntityId: zod+ .string()+ .describe('Identifier assigned by the external system.'),+ foreignEntitySource: zod.string()- .describe('RFC 5545 UID used for source reconciliation.'),- id: zod.uuid().describe('Entity identifier.'),- isReadOnly: zod- .boolean().describe(- 'Whether the selected canonical source is read-only.'+ 'Source system that owns the external identifier.'),- lastReminderFiredAt: zod.iso- .datetime({})- .nullish()+ id: zod+ .uuid().describe(- "When this event's most recent reminder notification was delivered."+ 'Internal primary key for this foreign entity record.'),- location: zod- .string()- .nullish()- .describe('Optional location label.'),- organizerEmail: zod- .string()- .nullish()- .describe('Organizer email.'),- organizerName: zod+ metadata: zod+ .object({})+ .describe('Arbitrary metadata stored with the mapping.'),+ storedForAuthEntity: zod.string()- .nullish()- .describe('Organizer display name.'),- ownerId: zod.string().describe('Owning Macro user.'),- status: zod.string().describe('Canonical status.'),- time: zod- .union([- zod- .object({- endsAt: zod.iso- .datetime({})- .describe('Exclusive end.'),- kind: zod.enum(['timed']),- startsAt: zod.iso- .datetime({})- .describe('Inclusive start.'),- timeZone: zod- .string()- .nullish()- .describe('Original IANA time zone.'),- })- .describe('Absolute timed event.'),- zod- .object({- endDate: zod.iso- .date()- .describe('Exclusive end date.'),- kind: zod.enum(['allDay']),- startDate: zod.iso- .date()- .describe('Inclusive start date.'),- })- .describe('All-day event with an exclusive end date.'),- ]).describe(- 'Timed or all-day calendar event span.\n\nFields are camelCased per variant rather than via `rename_all_fields`,\nwhich utoipa ignores — the generated OpenAPI schema would otherwise\nclaim snake_case fields the wire never carries.'+ 'Internal auth entity namespace this foreign entity is stored for.'),- title: zod.string().describe('Display title.'),- transparency: zod+ storedForId: zod.string()- .describe('Availability transparency.'),+ .describe(+ 'Internal entity identifier this foreign entity is stored for.'+ ),updatedAt: zod.iso.datetime({})- .describe('Entity update timestamp.'),- visibility: zod.string().describe('Canonical visibility.'),+ .describe('Timestamp when the record was last updated.'),})- .describe('A canonical calendar event entity in Soup.'),- tag: zod.enum(['calendarEvent']),+ .describe('A foreign entity record as displayed in Soup.'),+ tag: zod.enum(['foreignEntity']),})- .describe('Calendar event item.'),+ .describe('Foreign entity item.'),zod.object({data: zod@@ -18628,123 +19548,119 @@ export const postItemsSoupAstResponse = zod).and(zod.object({+ completedAt: zod.iso+ .datetime({})+ .nullish()+ .describe('Set once a one-shot reminder has fired.'),createdAt: zod.iso.datetime({})- .describe('When the company was created.'),+ .describe('When the reminder was created.'),description: zod.string()- .nullish().describe(- "Display description from the primary domain's directory entry."+ 'What to remind the user about. Doubles as the display name.'),- domains: zod- .array(+ enabled: zod+ .boolean()+ .describe(+ 'When false, the dispatcher skips this reminder.'+ ),+ id: zod.uuid().describe('The reminder id.'),+ nextRunAt: zod.iso+ .datetime({})+ .describe(+ 'The next firing. This is what Soup sorts reminders on.'+ ),+ referencedEntity: zod+ .union([+ zod.null(),+ zod+ .object({+ entityType: 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',+ ])+ .describe('The type of an entity in Macro')+ .describe("The referenced entity's type."),+ fileType: zod+ .string()+ .nullish()+ .describe(+ 'File type, when the reference is a document — `md`, `pdf`, and so on.'+ ),+ id: zod+ .string()+ .describe("The referenced entity's id."),+ subType: zod+ .string()+ .nullish()+ .describe(+ 'Sub type, when the reference is a task or snippet document.'+ ),+ })+ .describe(+ "The entity a reminder is about, resolved server-side.\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, and the client's icon path is synchronous, so this is resolved here\nrather than costing a fetch per row."+ ),+ ])+ .optional(),+ schedule: zod+ .union([zod.object({- companyId: zod- .uuid()+ 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(- 'The id of the company the domain belongs to.'+ 'Cron expression, normalized to the 6-field form.'),- createdAt: zod.iso- .datetime({})- .describe('When the domain record was created.'),- domain: zod+ timezone: zod.string().describe(- 'The domain (lowercased, e.g. \"acme.com\").'+ 'The timezone the cron expression is evaluated in.'),- id: zod- .uuid()- .describe('The id of the domain record.'),+ type: zod.enum(['recurring']),}).describe(- "A CRM domain as displayed in Soup. Mirrors the crm crate's\n[`CrmDomain`] with a stable wire shape that the FE can rely on."- )- )- .describe(- 'Domains associated with this company, ordered by creation time\nascending (primary first).'- ),- emailSync: zod- .boolean()- .describe(- 'Whether email sync is enabled for this company.'- ),- hidden: zod- .boolean()- .describe(- 'Whether the company is hidden from CRM listings. Soup filters\nthese out by default.'- ),- id: zod.uuid().describe('The id of the company.'),- name: zod- .string()- .nullish()- .describe(- "Display name from the primary domain's directory entry, or\n`None` when unresolved."- ),- teamId: zod- .uuid()+ 'Fires repeatedly, on a cron schedule evaluated in `timezone`.'+ ),+ ]).describe(- 'The id of the team that owns this company record.'+ 'How often a reminder fires, flattened for the wire.\n\nThe domain\'s [`ReminderSchedule`] is an internally-tagged enum carrying a\nvalidated cron type; Soup only needs enough to render \"once\" vs \"every\nweekday at 9am\", so the cron is exposed as a plain string.'),updatedAt: zod.iso.datetime({})- .describe('When the company was last updated.'),- viewedAt: zod.iso- .datetime({})- .nullish()- .describe(- 'When the requesting user last viewed this company, or `None` if\nnever viewed. Mirrors the `viewed_at` other soup entities carry.'- ),+ .describe('When the reminder was last modified.'),})).describe(- 'A CRM company as displayed in Soup. Carries the core company\nfields plus display metadata resolved from `crm_domain_directory`\nagainst the primary (earliest-created) domain.'+ "A reminder as displayed in Soup.\n\nReminders are user-owned rather than shared, so unlike most Soup items they\ncarry no access metadata — the repository only ever returns the caller's own."),- tag: zod.enum(['crmCompany']),- })- .describe('CRM company item.'),- zod- .object({- data: zod- .object({- createdAt: zod.iso- .datetime({})- .describe('Timestamp when the record was created.'),- foreignEntityId: zod- .string()- .describe('Identifier assigned by the external system.'),- foreignEntitySource: zod- .string()- .describe(- 'Source system that owns the external identifier.'- ),- id: zod- .uuid()- .describe(- 'Internal primary key for this foreign entity record.'- ),- metadata: zod- .object({})- .describe('Arbitrary metadata stored with the mapping.'),- storedForAuthEntity: zod- .string()- .describe(- 'Internal auth entity namespace this foreign entity is stored for.'- ),- storedForId: zod- .string()- .describe(- 'Internal entity identifier this foreign entity is stored for.'- ),- updatedAt: zod.iso- .datetime({})- .describe('Timestamp when the record was last updated.'),- })- .describe('A foreign entity record as displayed in Soup.'),- tag: zod.enum(['foreignEntity']),+ tag: zod.enum(['reminder']),})- .describe('Foreign entity item.'),+ .describe('Reminder item.'),zod.object({data: zod@@ -18977,119 +19893,45 @@ export const postItemsSoupAstResponse = zod).and(zod.object({- completedAt: zod.iso- .datetime({})- .nullish()- .describe('Set once a one-shot reminder has fired.'),+ botId: zod.uuid().describe('The bot running this session'),createdAt: zod.iso.datetime({})- .describe('When the reminder was created.'),- description: zod+ .describe('The time the session was created'),+ id: zod.uuid().describe('The agent session uuid'),+ name: zod+ .string()+ .describe('The user-facing name of the session'),+ ownerId: zod+ .string()+ .describe('Who the session belongs to'),+ status: zod.string().describe(- 'What to remind the user about. Doubles as the display name.'+ "The session's last known status.\n\n`no_messages` until the first system event arrives, `disconnected` if\nthe connection dropped without a clean close, otherwise the wire name\nof the most recent system event (for example `session\/end`)."),- enabled: zod- .boolean()+ threadId: zod+ .uuid()+ .nullish().describe(- 'When false, the dispatcher skips this reminder.'+ 'The channel thread the session was opened from, when any'),- id: zod.uuid().describe('The reminder id.'),- nextRunAt: zod.iso+ updatedAt: zod.iso.datetime({})+ .describe('The time the session was last modified'),+ viewedAt: zod.iso+ .datetime({})+ .nullish().describe(- 'The next firing. This is what Soup sorts reminders on.'- ),- referencedEntity: zod- .union([- zod.null(),- zod- .object({- entityType: 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',- ])- .describe('The type of an entity in Macro')- .describe("The referenced entity's type."),- fileType: zod- .string()- .nullish()- .describe(- 'File type, when the reference is a document — `md`, `pdf`, and so on.'- ),- id: zod- .string()- .describe("The referenced entity's id."),- subType: zod- .string()- .nullish()- .describe(- 'Sub type, when the reference is a task or snippet document.'- ),- })- .describe(- "The entity a reminder is about, resolved server-side.\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, and the client's icon path is synchronous, so this is resolved here\nrather than costing a fetch per row."- ),- ])- .optional(),- 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, normalized to the 6-field form.'- ),- 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(- 'How often a reminder fires, flattened for the wire.\n\nThe domain\'s [`ReminderSchedule`] is an internally-tagged enum carrying a\nvalidated cron type; Soup only needs enough to render \"once\" vs \"every\nweekday at 9am\", so the cron is exposed as a plain string.'+ 'The time the session was last viewed by the requesting user'),- updatedAt: zod.iso- .datetime({})- .describe('When the reminder was last modified.'),})).describe(- "A reminder as displayed in Soup.\n\nReminders are user-owned rather than shared, so unlike most Soup items they\ncarry no access metadata — the repository only ever returns the caller's own."+ "An agent session as displayed in Soup.\n\nMirrors [`crate::chat::SoupChat`]: an agent session is the coding-agent\ncounterpart of a chat, so it carries the same identity, ownership, and\nrecency fields plus the session's last known status."),- tag: zod.enum(['reminder']),+ tag: zod.enum(['agentSession']),})- .describe('Reminder item.'),+ .describe('Agent session item.'),]).describe('A single item in the Soup feed.').and(@@ -19137,6 +19979,12 @@ export const postItemsSoupAstGroupedBody = zod.union([zod.object({+ asf: zod+ .unknown()+ .optional()+ .describe(+ 'Filters applied to agent sessions (wire key `asf`). Like reminders,\nempty\/omitted returns \*\*no\*\* agent sessions: they are opt-in, so the\ncaller must send `inc`, an id, or an owner to get any.'+ ),calf: zod.unknown().optional()@@ -19299,6 +20147,12 @@ export const postItemsSoupAstGroupedBody = zod.describe('Initial grouped soup request.'),zod.object({+ asf: zod+ .unknown()+ .optional()+ .describe(+ 'Filters applied to agent sessions (wire key `asf`). Like reminders,\nempty\/omitted returns \*\*no\*\* agent sessions: they are opt-in, so the\ncaller must send `inc`, an id, or an owner to get any.'+ ),calf: zod.unknown().optional()@@ -22554,19 +23408,292 @@ export const postItemsSoupAstGroupedResponse = zod),]).describe(- 'How often a reminder fires, flattened for the wire.\n\nThe domain\'s [`ReminderSchedule`] is an internally-tagged enum carrying a\nvalidated cron type; Soup only needs enough to render \"once\" vs \"every\nweekday at 9am\", so the cron is exposed as a plain string.'+ 'How often a reminder fires, flattened for the wire.\n\nThe domain\'s [`ReminderSchedule`] is an internally-tagged enum carrying a\nvalidated cron type; Soup only needs enough to render \"once\" vs \"every\nweekday at 9am\", so the cron is exposed as a plain string.'+ ),+ updatedAt: zod.iso+ .datetime({})+ .describe('When the reminder was last modified.'),+ })+ )+ .describe(+ "A reminder as displayed in Soup.\n\nReminders are user-owned rather than shared, so unlike most Soup items they\ncarry no access metadata — the repository only ever returns the caller's own."+ ),+ tag: zod.enum(['reminder']),+ })+ .describe('Reminder item.'),+ zod+ .object({+ data: zod+ .object({+ properties: zod+ .array(+ zod+ .object({+ definition: zod+ .object({+ created_at: zod.iso.datetime({}),+ data_type: zod+ .enum([+ 'BOOLEAN',+ 'DATE',+ 'NUMBER',+ 'STRING',+ 'SELECT_NUMBER',+ 'SELECT_STRING',+ 'TAG',+ 'ENTITY',+ 'LINK',+ ])+ .describe(+ 'Data type for property values, determining storage and validation.'+ ),+ display_name: zod.string(),+ id: zod.uuid(),+ is_metadata: zod+ .boolean()+ .describe(+ 'Flag to indicate if this is a system-generated metadata property.\nNot stored in database - computed at service layer.'+ ),+ is_multi_select: zod.boolean(),+ is_system: zod+ .boolean()+ .describe(+ 'Flag to indicate if this is a system property (stored in DB).'+ ),+ owner: zod+ .union([+ zod+ .object({+ scope: zod.enum(['user']),+ user_id: zod.string(),+ })+ .describe('User-scoped property.'),+ zod+ .object({+ scope: zod.enum(['team']),+ team_id: zod.uuid(),+ })+ .describe('Team-scoped property.'),+ zod+ .object({+ scope: zod.enum(['system']),+ })+ .describe(+ 'System-owned property (no user or team owner).'+ ),+ ])+ .describe(+ 'Defines who owns a property - user-scoped, team-scoped, or system.'+ ),+ specific_entity_type: zod+ .union([+ zod.null(),+ zod+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ])+ .describe(+ 'Type of entity that can be referenced by entity properties.'+ ),+ ])+ .optional(),+ updated_at: zod.iso.datetime({}),+ })+ .describe(+ 'Property definition model (service representation).'+ ),+ id: zod+ .uuid()+ .describe(+ 'Globally unique id of the assignment attaching this property to an entity.'+ ),+ value: zod+ .union([+ zod.null(),+ zod+ .union([+ zod+ .object({+ type: zod.enum(['Boolean']),+ value: zod+ .boolean()+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ })+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ zod+ .object({+ type: zod.enum(['Number']),+ value: zod+ .number()+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ })+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ zod+ .object({+ type: zod.enum(['String']),+ value: zod+ .string()+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ })+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ zod+ .object({+ type: zod.enum(['Date']),+ value: zod.iso+ .datetime({})+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ })+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ zod+ .object({+ type: zod.enum(['SelectOption']),+ value: zod+ .array(zod.uuid())+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ })+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['EntityReference']),+ value: zod+ .array(+ zod+ .object({+ entity_id: zod.string(),+ entity_type: zod+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ])+ .describe(+ 'Type of entity that can be referenced by entity properties.'+ ),+ specific_message_id: zod+ .uuid()+ .nullish()+ .describe(+ 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'+ ),+ })+ .describe(+ 'Entity reference for entity-type property values.'+ )+ )+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ })+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['Link']),+ value: zod+ .array(zod.string())+ .describe(+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'+ ),+ })+ .describe(+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'+ ),+ ])+ .describe(+ 'Property value (service representation).\n\nRepresents the actual value stored for an entity property.\nThis is serialized to\/from JSONB in the database.'+ ),+ ])+ .optional(),+ })+ .describe(+ 'A property attached to a Soup item.\n\nThis is a simplified representation that includes only the definition and value,\nomitting the entity property assignment metadata and options.'+ )+ )+ .describe('Properties attached to the entity.'),+ })+ .describe(+ 'Property fields that can be flattened into property-bearing Soup items.'+ )+ .and(+ zod.object({+ botId: zod+ .uuid()+ .describe('The bot running this session'),+ createdAt: zod.iso+ .datetime({})+ .describe('The time the session was created'),+ id: zod.uuid().describe('The agent session uuid'),+ name: zod+ .string()+ .describe('The user-facing name of the session'),+ ownerId: zod+ .string()+ .describe('Who the session belongs to'),+ status: zod+ .string()+ .describe(+ "The session's last known status.\n\n`no_messages` until the first system event arrives, `disconnected` if\nthe connection dropped without a clean close, otherwise the wire name\nof the most recent system event (for example `session\/end`)."+ ),+ threadId: zod+ .uuid()+ .nullish()+ .describe(+ 'The channel thread the session was opened from, when any'),updatedAt: zod.iso.datetime({})- .describe('When the reminder was last modified.'),+ .describe('The time the session was last modified'),+ viewedAt: zod.iso+ .datetime({})+ .nullish()+ .describe(+ 'The time the session was last viewed by the requesting user'+ ),})).describe(- "A reminder as displayed in Soup.\n\nReminders are user-owned rather than shared, so unlike most Soup items they\ncarry no access metadata — the repository only ever returns the caller's own."+ "An agent session as displayed in Soup.\n\nMirrors [`crate::chat::SoupChat`]: an agent session is the coding-agent\ncounterpart of a chat, so it carries the same identity, ownership, and\nrecency fields plus the session's last known status."),- tag: zod.enum(['reminder']),+ tag: zod.enum(['agentSession']),})- .describe('Reminder item.'),+ .describe('Agent session item.'),]).describe('A single item in the Soup feed.').and(@@ -24762,232 +25889,591 @@ export const postItemsSoupAstGroupedResponse = zodupdated_at: zod.iso.datetime({}),}).describe(- 'Property definition model (service representation).'+ 'Property definition model (service representation).'+ ),+ id: zod+ .uuid()+ .describe(+ 'Globally unique id of the assignment attaching this property to an entity.'+ ),+ value: zod+ .union([+ zod.null(),+ zod+ .union([+ zod+ .object({+ type: zod.enum(['Boolean']),+ value: zod+ .boolean()+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ })+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ zod+ .object({+ type: zod.enum(['Number']),+ value: zod+ .number()+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ })+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ zod+ .object({+ type: zod.enum(['String']),+ value: zod+ .string()+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ })+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ zod+ .object({+ type: zod.enum(['Date']),+ value: zod.iso+ .datetime({})+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ })+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ zod+ .object({+ type: zod.enum([+ 'SelectOption',+ ]),+ value: zod+ .array(zod.uuid())+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ })+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum([+ 'EntityReference',+ ]),+ value: zod+ .array(+ zod+ .object({+ entity_id: zod.string(),+ entity_type: zod+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ])+ .describe(+ 'Type of entity that can be referenced by entity properties.'+ ),+ specific_message_id: zod+ .uuid()+ .nullish()+ .describe(+ 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'+ ),+ })+ .describe(+ 'Entity reference for entity-type property values.'+ )+ )+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ })+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['Link']),+ value: zod+ .array(zod.string())+ .describe(+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'+ ),+ })+ .describe(+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'+ ),+ ])+ .describe(+ 'Property value (service representation).\n\nRepresents the actual value stored for an entity property.\nThis is serialized to\/from JSONB in the database.'+ ),+ ])+ .optional(),+ })+ .describe(+ 'A property attached to a Soup item.\n\nThis is a simplified representation that includes only the definition and value,\nomitting the entity property assignment metadata and options.'+ )+ )+ .describe('Properties attached to the entity.'),+ })+ .describe(+ 'Property fields that can be flattened into property-bearing Soup items.'+ ),+ icalUid: zod+ .string()+ .describe(+ 'RFC 5545 UID used for source reconciliation.'+ ),+ id: zod.uuid().describe('Entity identifier.'),+ isReadOnly: zod+ .boolean()+ .describe(+ 'Whether the selected canonical source is read-only.'+ ),+ lastReminderFiredAt: zod.iso+ .datetime({})+ .nullish()+ .describe(+ "When this event's most recent reminder notification was delivered."+ ),+ location: zod+ .string()+ .nullish()+ .describe('Optional location label.'),+ organizerEmail: zod+ .string()+ .nullish()+ .describe('Organizer email.'),+ organizerName: zod+ .string()+ .nullish()+ .describe('Organizer display name.'),+ ownerId: zod.string().describe('Owning Macro user.'),+ status: zod.string().describe('Canonical status.'),+ time: zod+ .union([+ zod+ .object({+ endsAt: zod.iso+ .datetime({})+ .describe('Exclusive end.'),+ kind: zod.enum(['timed']),+ startsAt: zod.iso+ .datetime({})+ .describe('Inclusive start.'),+ timeZone: zod+ .string()+ .nullish()+ .describe('Original IANA time zone.'),+ })+ .describe('Absolute timed event.'),+ zod+ .object({+ endDate: zod.iso+ .date()+ .describe('Exclusive end date.'),+ kind: zod.enum(['allDay']),+ startDate: zod.iso+ .date()+ .describe('Inclusive start date.'),+ })+ .describe(+ 'All-day event with an exclusive end date.'+ ),+ ])+ .describe(+ 'Timed or all-day calendar event span.\n\nFields are camelCased per variant rather than via `rename_all_fields`,\nwhich utoipa ignores — the generated OpenAPI schema would otherwise\nclaim snake_case fields the wire never carries.'+ ),+ title: zod.string().describe('Display title.'),+ transparency: zod+ .string()+ .describe('Availability transparency.'),+ updatedAt: zod.iso+ .datetime({})+ .describe('Entity update timestamp.'),+ visibility: zod+ .string()+ .describe('Canonical visibility.'),+ })+ .describe('A canonical calendar event entity in Soup.'),+ tag: zod.enum(['calendarEvent']),+ })+ .describe('Calendar event item.'),+ zod+ .object({+ data: zod+ .object({+ properties: zod+ .array(+ zod+ .object({+ definition: zod+ .object({+ created_at: zod.iso.datetime({}),+ data_type: zod+ .enum([+ 'BOOLEAN',+ 'DATE',+ 'NUMBER',+ 'STRING',+ 'SELECT_NUMBER',+ 'SELECT_STRING',+ 'TAG',+ 'ENTITY',+ 'LINK',+ ])+ .describe(+ 'Data type for property values, determining storage and validation.'),- id: zod- .uuid()+ display_name: zod.string(),+ id: zod.uuid(),+ is_metadata: zod+ .boolean().describe(- 'Globally unique id of the assignment attaching this property to an entity.'+ 'Flag to indicate if this is a system-generated metadata property.\nNot stored in database - computed at service layer.'),- value: zod+ is_multi_select: zod.boolean(),+ is_system: zod+ .boolean()+ .describe(+ 'Flag to indicate if this is a system property (stored in DB).'+ ),+ owner: zod+ .union([+ zod+ .object({+ scope: zod.enum(['user']),+ user_id: zod.string(),+ })+ .describe('User-scoped property.'),+ zod+ .object({+ scope: zod.enum(['team']),+ team_id: zod.uuid(),+ })+ .describe('Team-scoped property.'),+ zod+ .object({+ scope: zod.enum(['system']),+ })+ .describe(+ 'System-owned property (no user or team owner).'+ ),+ ])+ .describe(+ 'Defines who owns a property - user-scoped, team-scoped, or system.'+ ),+ specific_entity_type: zod.union([zod.null(),zod- .union([- zod- .object({- type: zod.enum(['Boolean']),- value: zod- .boolean()- .describe(- 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'- ),- })+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ])+ .describe(+ 'Type of entity that can be referenced by entity properties.'+ ),+ ])+ .optional(),+ updated_at: zod.iso.datetime({}),+ })+ .describe(+ 'Property definition model (service representation).'+ ),+ id: zod+ .uuid()+ .describe(+ 'Globally unique id of the assignment attaching this property to an entity.'+ ),+ value: zod+ .union([+ zod.null(),+ zod+ .union([+ zod+ .object({+ type: zod.enum(['Boolean']),+ value: zod+ .boolean().describe('Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'),- zod- .object({- type: zod.enum(['Number']),- value: zod- .number()- .describe(- 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'- ),- })+ })+ .describe(+ 'Boolean value\nSerializes as: {\"type\": \"Boolean\", \"value\": true}'+ ),+ zod+ .object({+ type: zod.enum(['Number']),+ value: zod+ .number().describe('Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'),- zod- .object({- type: zod.enum(['String']),- value: zod- .string()- .describe(- 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'- ),- })+ })+ .describe(+ 'Numeric value\nSerializes as: {\"type\": \"Number\", \"value\": 42.5}'+ ),+ zod+ .object({+ type: zod.enum(['String']),+ value: zod+ .string().describe('String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'),- zod- .object({- type: zod.enum(['Date']),- value: zod.iso- .datetime({})- .describe(- 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'- ),- })+ })+ .describe(+ 'String value\nSerializes as: {\"type\": \"String\", \"value\": \"text\"}'+ ),+ zod+ .object({+ type: zod.enum(['Date']),+ value: zod.iso+ .datetime({}).describe('Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'),- zod- .object({- type: zod.enum([- 'SelectOption',- ]),- value: zod- .array(zod.uuid())- .describe(- 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'- ),- })+ })+ .describe(+ 'Date\/timestamp value\nSerializes as: {\"type\": \"Date\", \"value\": \"2025-01-01T00:00:00Z\"}'+ ),+ zod+ .object({+ type: zod.enum(['SelectOption']),+ value: zod+ .array(zod.uuid()).describe('Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'),- zod- .object({- type: zod.enum([- 'EntityReference',- ]),- value: zod- .array(- zod- .object({- entity_id: zod.string(),- entity_type: zod- .enum([- 'CALENDAR_EVENT',- 'CALL_RECORD',- 'CHANNEL',- 'CHAT',- 'COMPANY',- 'DOCUMENT',- 'PROJECT',- 'TASK',- 'THREAD',- 'USER',- ])- .describe(- 'Type of entity that can be referenced by entity properties.'- ),- specific_message_id: zod- .uuid()- .nullish()- .describe(- 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'- ),- })+ })+ .describe(+ 'Select option(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"SelectOption\", \"value\": [\"uuid\"]} (length 0 or 1)\nMulti-select: {\"type\": \"SelectOption\", \"value\": [\"uuid1\", \"uuid2\", ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['EntityReference']),+ value: zod+ .array(+ zod+ .object({+ entity_id: zod.string(),+ entity_type: zod+ .enum([+ 'CALENDAR_EVENT',+ 'CALL_RECORD',+ 'CHANNEL',+ 'CHAT',+ 'COMPANY',+ 'DOCUMENT',+ 'PROJECT',+ 'TASK',+ 'THREAD',+ 'USER',+ ]).describe(- 'Entity reference for entity-type property values.'- )- )+ 'Type of entity that can be referenced by entity properties.'+ ),+ specific_message_id: zod+ .uuid()+ .nullish()+ .describe(+ 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'+ ),+ }).describe(- 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'- ),- })+ 'Entity reference for entity-type property values.'+ )+ ).describe('Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'),- zod- .object({- type: zod.enum(['Link']),- value: zod- .array(zod.string())- .describe(- 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'- ),- })+ })+ .describe(+ 'Entity reference(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"EntityReference\", \"value\": [{...}]} (length 0 or 1)\nMulti-select: {\"type\": \"EntityReference\", \"value\": [{...}, {...}, ...]} (length 0+)'+ ),+ zod+ .object({+ type: zod.enum(['Link']),+ value: zod+ .array(zod.string()).describe('Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'),- ])+ }).describe(- 'Property value (service representation).\n\nRepresents the actual value stored for an entity property.\nThis is serialized to\/from JSONB in the database.'+ 'Link value(s) - always an array (check is_multi_select to determine if single or multi)\nSingle-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\"]} (length 0 or 1)\nMulti-select: {\"type\": \"Link\", \"value\": [\"https:\/\/example.com\", \"https:\/\/other.com\"]} (length 0+)'),])- .optional(),- })- .describe(- 'A property attached to a Soup item.\n\nThis is a simplified representation that includes only the definition and value,\nomitting the entity property assignment metadata and options.'- )+ .describe(+ 'Property value (service representation).\n\nRepresents the actual value stored for an entity property.\nThis is serialized to\/from JSONB in the database.'+ ),+ ])+ .optional(),+ })+ .describe(+ 'A property attached to a Soup item.\n\nThis is a simplified representation that includes only the definition and value,\nomitting the entity property assignment metadata and options.')- .describe('Properties attached to the entity.'),- })+ )+ .describe('Properties attached to the entity.'),+ })+ .describe(+ 'Property fields that can be flattened into property-bearing Soup items.'+ )+ .and(+ zod.object({+ createdAt: zod.iso+ .datetime({})+ .describe('When the company was created.'),+ description: zod+ .string()+ .nullish()+ .describe(+ "Display description from the primary domain's directory entry."+ ),+ domains: zod+ .array(+ zod+ .object({+ companyId: zod+ .uuid()+ .describe(+ 'The id of the company the domain belongs to.'+ ),+ createdAt: zod.iso+ .datetime({})+ .describe(+ 'When the domain record was created.'+ ),+ domain: zod+ .string()+ .describe(+ 'The domain (lowercased, e.g. \"acme.com\").'+ ),+ id: zod+ .uuid()+ .describe('The id of the domain record.'),+ })+ .describe(+ "A CRM domain as displayed in Soup. Mirrors the crm crate's\n[`CrmDomain`] with a stable wire shape that the FE can rely on."+ )+ )+ .describe(+ 'Domains associated with this company, ordered by creation time\nascending (primary first).'+ ),+ emailSync: zod+ .boolean()+ .describe(+ 'Whether email sync is enabled for this company.'+ ),+ hidden: zod+ .boolean()+ .describe(+ 'Whether the company is hidden from CRM listings. Soup filters\nthese out by default.'+ ),+ id: zod.uuid().describe('The id of the company.'),+ name: zod+ .string()+ .nullish()+ .describe(+ "Display name from the primary domain's directory entry, or\n`None` when unresolved."+ ),+ teamId: zod+ .uuid()+ .describe(+ 'The id of the team that owns this company record.'+ ),+ updatedAt: zod.iso+ .datetime({})+ .describe('When the company was last updated.'),+ viewedAt: zod.iso+ .datetime({})+ .nullish()+ .describe(+ 'When the requesting user last viewed this company, or `None` if\nnever viewed. Mirrors the `viewed_at` other soup entities carry.'+ ),+ })+ )+ .describe(+ 'A CRM company as displayed in Soup. Carries the core company\nfields plus display metadata resolved from `crm_domain_directory`\nagainst the primary (earliest-created) domain.'+ ),+ tag: zod.enum(['crmCompany']),+ })+ .describe('CRM company item.'),+ zod+ .object({+ data: zod+ .object({+ createdAt: zod.iso+ .datetime({})+ .describe('Timestamp when the record was created.'),+ foreignEntityId: zod+ .string().describe(- 'Property fields that can be flattened into property-bearing Soup items.'+ 'Identifier assigned by the external system.'),- icalUid: zod+ foreignEntitySource: zod.string().describe(- 'RFC 5545 UID used for source reconciliation.'+ 'Source system that owns the external identifier.'),- id: zod.uuid().describe('Entity identifier.'),- isReadOnly: zod- .boolean()+ id: zod+ .uuid().describe(- 'Whether the selected canonical source is read-only.'+ 'Internal primary key for this foreign entity record.'),- lastReminderFiredAt: zod.iso- .datetime({})- .nullish()+ metadata: zod+ .object({}).describe(- "When this event's most recent reminder notification was delivered."+ 'Arbitrary metadata stored with the mapping.'),- location: zod- .string()- .nullish()- .describe('Optional location label.'),- organizerEmail: zod- .string()- .nullish()- .describe('Organizer email.'),- organizerName: zod+ storedForAuthEntity: zod.string()- .nullish()- .describe('Organizer display name.'),- ownerId: zod.string().describe('Owning Macro user.'),- status: zod.string().describe('Canonical status.'),- time: zod- .union([- zod- .object({- endsAt: zod.iso- .datetime({})- .describe('Exclusive end.'),- kind: zod.enum(['timed']),- startsAt: zod.iso- .datetime({})- .describe('Inclusive start.'),- timeZone: zod- .string()- .nullish()- .describe('Original IANA time zone.'),- })- .describe('Absolute timed event.'),- zod- .object({- endDate: zod.iso- .date()- .describe('Exclusive end date.'),- kind: zod.enum(['allDay']),- startDate: zod.iso- .date()- .describe('Inclusive start date.'),- })- .describe(- 'All-day event with an exclusive end date.'- ),- ]).describe(- 'Timed or all-day calendar event span.\n\nFields are camelCased per variant rather than via `rename_all_fields`,\nwhich utoipa ignores — the generated OpenAPI schema would otherwise\nclaim snake_case fields the wire never carries.'+ 'Internal auth entity namespace this foreign entity is stored for.'),- title: zod.string().describe('Display title.'),- transparency: zod+ storedForId: zod.string()- .describe('Availability transparency.'),+ .describe(+ 'Internal entity identifier this foreign entity is stored for.'+ ),updatedAt: zod.iso.datetime({})- .describe('Entity update timestamp.'),- visibility: zod- .string()- .describe('Canonical visibility.'),+ .describe(+ 'Timestamp when the record was last updated.'+ ),})- .describe('A canonical calendar event entity in Soup.'),- tag: zod.enum(['calendarEvent']),+ .describe(+ 'A foreign entity record as displayed in Soup.'+ ),+ tag: zod.enum(['foreignEntity']),})- .describe('Calendar event item.'),+ .describe('Foreign entity item.'),zod.object({data: zod@@ -25220,133 +26706,121 @@ export const postItemsSoupAstGroupedResponse = zod).and(zod.object({+ completedAt: zod.iso+ .datetime({})+ .nullish()+ .describe(+ 'Set once a one-shot reminder has fired.'+ ),createdAt: zod.iso.datetime({})- .describe('When the company was created.'),+ .describe('When the reminder was created.'),description: zod.string()- .nullish().describe(- "Display description from the primary domain's directory entry."+ 'What to remind the user about. Doubles as the display name.'),- domains: zod- .array(+ enabled: zod+ .boolean()+ .describe(+ 'When false, the dispatcher skips this reminder.'+ ),+ id: zod.uuid().describe('The reminder id.'),+ nextRunAt: zod.iso+ .datetime({})+ .describe(+ 'The next firing. This is what Soup sorts reminders on.'+ ),+ referencedEntity: zod+ .union([+ zod.null(),zod.object({- companyId: zod- .uuid()+ entityType: 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',+ ])+ .describe('The type of an entity in Macro')+ .describe("The referenced entity's type."),+ fileType: zod+ .string()+ .nullish().describe(- 'The id of the company the domain belongs to.'+ 'File type, when the reference is a document — `md`, `pdf`, and so on.'),- createdAt: zod.iso+ id: zod+ .string()+ .describe("The referenced entity's id."),+ subType: zod+ .string()+ .nullish()+ .describe(+ 'Sub type, when the reference is a task or snippet document.'+ ),+ })+ .describe(+ "The entity a reminder is about, resolved server-side.\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, and the client's icon path is synchronous, so this is resolved here\nrather than costing a fetch per row."+ ),+ ])+ .optional(),+ 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(- 'When the domain record was created.'+ 'Cron expression, normalized to the 6-field form.'),- domain: zod+ timezone: zod.string().describe(- 'The domain (lowercased, e.g. \"acme.com\").'+ 'The timezone the cron expression is evaluated in.'),- id: zod- .uuid()- .describe('The id of the domain record.'),+ type: zod.enum(['recurring']),}).describe(- "A CRM domain as displayed in Soup. Mirrors the crm crate's\n[`CrmDomain`] with a stable wire shape that the FE can rely on."- )- )- .describe(- 'Domains associated with this company, ordered by creation time\nascending (primary first).'- ),- emailSync: zod- .boolean()- .describe(- 'Whether email sync is enabled for this company.'- ),- hidden: zod- .boolean()- .describe(- 'Whether the company is hidden from CRM listings. Soup filters\nthese out by default.'- ),- id: zod.uuid().describe('The id of the company.'),- name: zod- .string()- .nullish()- .describe(- "Display name from the primary domain's directory entry, or\n`None` when unresolved."- ),- teamId: zod- .uuid()+ 'Fires repeatedly, on a cron schedule evaluated in `timezone`.'+ ),+ ]).describe(- 'The id of the team that owns this company record.'+ 'How often a reminder fires, flattened for the wire.\n\nThe domain\'s [`ReminderSchedule`] is an internally-tagged enum carrying a\nvalidated cron type; Soup only needs enough to render \"once\" vs \"every\nweekday at 9am\", so the cron is exposed as a plain string.'),updatedAt: zod.iso.datetime({})- .describe('When the company was last updated.'),- viewedAt: zod.iso- .datetime({})- .nullish()- .describe(- 'When the requesting user last viewed this company, or `None` if\nnever viewed. Mirrors the `viewed_at` other soup entities carry.'- ),+ .describe('When the reminder was last modified.'),})).describe(- 'A CRM company as displayed in Soup. Carries the core company\nfields plus display metadata resolved from `crm_domain_directory`\nagainst the primary (earliest-created) domain.'- ),- tag: zod.enum(['crmCompany']),- })- .describe('CRM company item.'),- zod- .object({- data: zod- .object({- createdAt: zod.iso- .datetime({})- .describe('Timestamp when the record was created.'),- foreignEntityId: zod- .string()- .describe(- 'Identifier assigned by the external system.'- ),- foreignEntitySource: zod- .string()- .describe(- 'Source system that owns the external identifier.'- ),- id: zod- .uuid()- .describe(- 'Internal primary key for this foreign entity record.'- ),- metadata: zod- .object({})- .describe(- 'Arbitrary metadata stored with the mapping.'- ),- storedForAuthEntity: zod- .string()- .describe(- 'Internal auth entity namespace this foreign entity is stored for.'- ),- storedForId: zod- .string()- .describe(- 'Internal entity identifier this foreign entity is stored for.'- ),- updatedAt: zod.iso- .datetime({})- .describe(- 'Timestamp when the record was last updated.'- ),- })- .describe(- 'A foreign entity record as displayed in Soup.'+ "A reminder as displayed in Soup.\n\nReminders are user-owned rather than shared, so unlike most Soup items they\ncarry no access metadata — the repository only ever returns the caller's own."),- tag: zod.enum(['foreignEntity']),+ tag: zod.enum(['reminder']),})- .describe('Foreign entity item.'),+ .describe('Reminder item.'),zod.object({data: zod@@ -25579,121 +27053,47 @@ export const postItemsSoupAstGroupedResponse = zod).and(zod.object({- completedAt: zod.iso- .datetime({})- .nullish()- .describe(- 'Set once a one-shot reminder has fired.'- ),+ botId: zod+ .uuid()+ .describe('The bot running this session'),createdAt: zod.iso.datetime({})- .describe('When the reminder was created.'),- description: zod+ .describe('The time the session was created'),+ id: zod.uuid().describe('The agent session uuid'),+ name: zod+ .string()+ .describe('The user-facing name of the session'),+ ownerId: zod+ .string()+ .describe('Who the session belongs to'),+ status: zod.string().describe(- 'What to remind the user about. Doubles as the display name.'+ "The session's last known status.\n\n`no_messages` until the first system event arrives, `disconnected` if\nthe connection dropped without a clean close, otherwise the wire name\nof the most recent system event (for example `session\/end`)."),- enabled: zod- .boolean()+ threadId: zod+ .uuid()+ .nullish().describe(- 'When false, the dispatcher skips this reminder.'+ 'The channel thread the session was opened from, when any'),- id: zod.uuid().describe('The reminder id.'),- nextRunAt: zod.iso+ updatedAt: zod.iso.datetime({})+ .describe('The time the session was last modified'),+ viewedAt: zod.iso+ .datetime({})+ .nullish().describe(- 'The next firing. This is what Soup sorts reminders on.'- ),- referencedEntity: zod- .union([- zod.null(),- zod- .object({- entityType: 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',- ])- .describe('The type of an entity in Macro')- .describe("The referenced entity's type."),- fileType: zod- .string()- .nullish()- .describe(- 'File type, when the reference is a document — `md`, `pdf`, and so on.'- ),- id: zod- .string()- .describe("The referenced entity's id."),- subType: zod- .string()- .nullish()- .describe(- 'Sub type, when the reference is a task or snippet document.'- ),- })- .describe(- "The entity a reminder is about, resolved server-side.\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, and the client's icon path is synchronous, so this is resolved here\nrather than costing a fetch per row."- ),- ])- .optional(),- 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, normalized to the 6-field form.'- ),- 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(- 'How often a reminder fires, flattened for the wire.\n\nThe domain\'s [`ReminderSchedule`] is an internally-tagged enum carrying a\nvalidated cron type; Soup only needs enough to render \"once\" vs \"every\nweekday at 9am\", so the cron is exposed as a plain string.'+ 'The time the session was last viewed by the requesting user'),- updatedAt: zod.iso- .datetime({})- .describe('When the reminder was last modified.'),})).describe(- "A reminder as displayed in Soup.\n\nReminders are user-owned rather than shared, so unlike most Soup items they\ncarry no access metadata — the repository only ever returns the caller's own."+ "An agent session as displayed in Soup.\n\nMirrors [`crate::chat::SoupChat`]: an agent session is the coding-agent\ncounterpart of a chat, so it carries the same identity, ownership, and\nrecency fields plus the session's last known status."),- tag: zod.enum(['reminder']),+ tag: zod.enum(['agentSession']),})- .describe('Reminder item.'),+ .describe('Agent session item.'),]).describe('A single item in the Soup feed.').and(diff --git a/apps/web/src/lib/service-clients/service-storage/graphql-soup.ts b/apps/web/src/lib/service-clients/service-storage/graphql-soup.tsindex f5fdb30d18..a198fe51fd 100644--- a/apps/web/src/lib/service-clients/service-storage/graphql-soup.ts+++ b/apps/web/src/lib/service-clients/service-storage/graphql-soup.ts@@ -1159,6 +1159,7 @@ export function mapGraphqlSoupItem(item: GraphqlSoupItem): SoupApiItem | null {const frecency = item.frecencyScore ?? 0;return match(item)+ .with({ __typename: 'GraphqlSoupAgentSession' }, () => null).with({ __typename: 'GraphqlSoupDocument' },(entity) =>diff --git a/apps/web/src/lib/service-clients/service-storage/graphql/generated/graphql.ts b/apps/web/src/lib/service-clients/service-storage/graphql/generated/graphql.tsindex 486e7480f9..511c7ccad0 100644--- a/apps/web/src/lib/service-clients/service-storage/graphql/generated/graphql.ts+++ b/apps/web/src/lib/service-clients/service-storage/graphql/generated/graphql.ts@@ -76,6 +76,39 @@ export type EntitySharePolicyInput = {linkShareAccessLevel?: GraphqlEntityAccessLevel | null | undefined;};+/** The two operands of a recursive `AgentSessionFilterExpr` binary expression. */+export type GraphqlAgentSessionBinaryExpr = {+ /** Left expression. */+ left: GraphqlAgentSessionExpr;+ /** Right expression. */+ right: GraphqlAgentSessionExpr;+};++/** A recursive `AgentSessionFilterExpr` filter expression. */+export type GraphqlAgentSessionExpr =+ { /** Both expressions must match. */+ and: GraphqlAgentSessionBinaryExpr; literal?: never; not?: never; or?: never; }+ | { and?: never; /** Match a literal. */+ literal: GraphqlAgentSessionLiteral; not?: never; or?: never; }+ | { and?: never; literal?: never; /** Negate an expression. */+ not: GraphqlAgentSessionExpr; or?: never; }+ | { and?: never; literal?: never; not?: never; /** Either expression may match. */+ or: GraphqlAgentSessionBinaryExpr; };++/** GraphQL input representing the agent session literal. */+export type GraphqlAgentSessionLiteral =+ { /** The id option. */+ id: string | number; include?: never; owner?: never; }+ | { id?: never; /**+ * Opt this query into agent sessions at all. Agent sessions are off by+ * default, so without this (or an `id`/`owner`) Soup omits them entirely.+ * Must be `true`; there is no literal for excluding agent sessions, that+ * is the default.+ */+ include: boolean; owner?: never; }+ | { id?: never; include?: never; /** The owner option. */+ owner: string; };+/** The two operands of a recursive `CalendarEventFilterExpr` binary expression. */export type GraphqlCalendarEventBinaryExpr = {/** Left expression. */@@ -487,6 +520,8 @@ export type GraphqlEntityAccessLevel =/** GraphQL input mirroring `item_filters::ast::EntityFilterAst`. */export type GraphqlEntityFilterAst = {+ /** The agent session filter to apply. */+ agentSessionFilter?: GraphqlAgentSessionExpr | null | undefined;/** The calendar event filter to apply. */calendarEventFilter?: GraphqlCalendarEventExpr | null | undefined;/** The call filter to apply. */@@ -947,6 +982,8 @@ export type GraphqlSortDirection =/** GraphQL representation of Soup entity types. */export type GraphqlSoupEntityType =+ /** AI coding agent session entity. */+ | 'AGENT_SESSION'/** Calendar event entity. */| 'CALENDAR_EVENT'/** Call entity. */@@ -1177,6 +1214,19 @@ export type EntityActivityQueryVariables = Exact<{export type EntityActivityQuery = { user: { id: string, soup: { items: Array<+ | { __typename: 'GraphqlSoupAgentSession', id: string, activity: Array<{ __typename: 'GraphqlActivityEvent', id: string, actorId: string, subjectId: string, entityType: GraphqlEntityType, entityId: string, occurredAt: string, action:+ | { __typename: 'GraphqlActivityCallStarted', callId: string }+ | { __typename: 'GraphqlActivityCreated' }+ | { __typename: 'GraphqlActivityDeleted' }+ | { __typename: 'GraphqlActivityEdited' }+ | { __typename: 'GraphqlActivityMessaged' }+ | { __typename: 'GraphqlActivityOpened' }+ | { __typename: 'GraphqlActivityParticipantAdded', participant: string }+ | { __typename: 'GraphqlActivityParticipantRemoved', participant: string }+ | { __typename: 'GraphqlActivityPropertyChanged', property: string, from: unknown, to: unknown }+ | { __typename: 'GraphqlActivitySent' }+ | { __typename: 'GraphqlActivityUnknownAction', tag: string, payload: unknown }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', id: string, activity: Array<{ __typename: 'GraphqlActivityEvent', id: string, actorId: string, subjectId: string, entityType: GraphqlEntityType, entityId: string, occurredAt: string, action:| { __typename: 'GraphqlActivityCallStarted', callId: string }| { __typename: 'GraphqlActivityCreated' }@@ -1322,6 +1372,20 @@ export type EntityActivityQuery = { user: { id: string, soup: { items: Array<}> }> } } };+type EntityActivityFields_GraphqlSoupAgentSession_Fragment = { __typename: 'GraphqlSoupAgentSession', id: string, activity: Array<{ __typename: 'GraphqlActivityEvent', id: string, actorId: string, subjectId: string, entityType: GraphqlEntityType, entityId: string, occurredAt: string, action:+ | { __typename: 'GraphqlActivityCallStarted', callId: string }+ | { __typename: 'GraphqlActivityCreated' }+ | { __typename: 'GraphqlActivityDeleted' }+ | { __typename: 'GraphqlActivityEdited' }+ | { __typename: 'GraphqlActivityMessaged' }+ | { __typename: 'GraphqlActivityOpened' }+ | { __typename: 'GraphqlActivityParticipantAdded', participant: string }+ | { __typename: 'GraphqlActivityParticipantRemoved', participant: string }+ | { __typename: 'GraphqlActivityPropertyChanged', property: string, from: unknown, to: unknown }+ | { __typename: 'GraphqlActivitySent' }+ | { __typename: 'GraphqlActivityUnknownAction', tag: string, payload: unknown }+ }> };+type EntityActivityFields_GraphqlSoupCalendarEvent_Fragment = { __typename: 'GraphqlSoupCalendarEvent', id: string, activity: Array<{ __typename: 'GraphqlActivityEvent', id: string, actorId: string, subjectId: string, entityType: GraphqlEntityType, entityId: string, occurredAt: string, action:| { __typename: 'GraphqlActivityCallStarted', callId: string }| { __typename: 'GraphqlActivityCreated' }@@ -1477,6 +1541,7 @@ type EntityActivityFields_GraphqlSoupReminder_Fragment = { __typename: 'GraphqlS}> };export type EntityActivityFieldsFragment =+ | EntityActivityFields_GraphqlSoupAgentSession_Fragment| EntityActivityFields_GraphqlSoupCalendarEvent_Fragment| EntityActivityFields_GraphqlSoupCall_Fragment| EntityActivityFields_GraphqlSoupChannel_Fragment@@ -1599,6 +1664,30 @@ type EntityMutationResultFields_GraphqlMutationError_Fragment = { __typename: 'Gtype EntityMutationResultFields_GraphqlMutationSuccess_Fragment = { __typename: 'GraphqlMutationSuccess', effects: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -1944,6 +2033,30 @@ export type EntityMutationPayloadFieldsFragment = { results: Array<| { __typename: 'GraphqlMutationSuccess', effects: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -2290,6 +2403,30 @@ export type RenameEntitiesMutation = { renameEntities: { results: Array<| { __typename: 'GraphqlMutationSuccess', effects: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -2636,6 +2773,30 @@ export type MoveEntitiesMutation = { moveEntities: { results: Array<| { __typename: 'GraphqlMutationSuccess', effects: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -2982,6 +3143,30 @@ export type UpdateEntitySharePoliciesMutation = { updateEntitySharePolicies: { r| { __typename: 'GraphqlMutationSuccess', effects: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -3328,6 +3513,30 @@ export type TrashEntitiesMutation = { trashEntities: { results: Array<| { __typename: 'GraphqlMutationSuccess', effects: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -3674,6 +3883,30 @@ export type RestoreEntitiesMutation = { restoreEntities: { results: Array<| { __typename: 'GraphqlMutationSuccess', effects: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -4020,6 +4253,30 @@ export type DeleteEntitiesPermanentlyMutation = { deleteEntitiesPermanently: { r| { __typename: 'GraphqlMutationSuccess', effects: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -4366,6 +4623,30 @@ export type DuplicateEntitiesMutation = { duplicateEntities: { results: Array<| { __typename: 'GraphqlMutationSuccess', effects: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -4713,6 +4994,30 @@ export type SetEntityFavoriteMutation = { setEntityFavorite:| { __typename: 'GraphqlMutationSuccess', effects: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -5055,6 +5360,15 @@ export type EntityPropertiesQueryVariables = Exact<{export type EntityPropertiesQuery = { user: { id: string, soup: { items: Array<+ | { __typename: 'GraphqlSoupAgentSession', id: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:+ | { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }+ | { __typename: 'GraphqlDatePropertyValue', dateValue: string }+ | { __typename: 'GraphqlEntityReferencePropertyValue', references: Array<{ entityId: string, entityType: GraphqlPropertyEntityType, specificMessageId: string | null }> }+ | { __typename: 'GraphqlLinkPropertyValue', urls: Array<string> }+ | { __typename: 'GraphqlNumberPropertyValue', numberValue: number }+ | { __typename: 'GraphqlSelectOptionPropertyValue', optionIds: Array<string> }+ | { __typename: 'GraphqlStringPropertyValue', stringValue: string }+ | null }> }| { __typename: 'GraphqlSoupCalendarEvent', id: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -5187,6 +5501,7 @@ export type GroupSoupMembershipQueryVariables = Exact<{export type GroupSoupMembershipQuery = { user: { id: string, groupSoup: { bins: Array<{ key: string, totalCount: number, nextCursor: string | null, items: Array<+ | { __typename: 'GraphqlSoupAgentSession', id: string }| { __typename: 'GraphqlSoupCalendarEvent', id: string }| { __typename: 'GraphqlSoupCall', id: string }| { __typename: 'GraphqlSoupChannel', id: string }@@ -5206,6 +5521,30 @@ export type GroupSoupQueryVariables = Exact<{export type GroupSoupQuery = { user: { id: string, groupSoup: { bins: Array<{ key: string, totalCount: number, nextCursor: string | null, items: Array<+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -5623,6 +5962,7 @@ export type ItemPreviewNameCacheWriteQueryVariables = Exact<{export type ItemPreviewNameCacheWriteQuery = { user: { id: string, soup: { items: Array<+ | { __typename: 'GraphqlSoupAgentSession', id: string, displayName: string | null }| { __typename: 'GraphqlSoupCalendarEvent', id: string, displayName: string | null }| { __typename: 'GraphqlSoupCall', id: string, displayName: string | null }| { __typename: 'GraphqlSoupChannel', id: string, displayName: string | null }@@ -5642,6 +5982,7 @@ export type ItemPreviewFileTypeCacheWriteQueryVariables = Exact<{export type ItemPreviewFileTypeCacheWriteQuery = { user: { id: string, soup: { items: Array<+ | { __typename: 'GraphqlSoupAgentSession', id: string }| { __typename: 'GraphqlSoupCalendarEvent', id: string }| { __typename: 'GraphqlSoupCall', id: string }| { __typename: 'GraphqlSoupChannel', id: string }@@ -5661,6 +6002,7 @@ export type ItemPreviewQueryVariables = Exact<{export type ItemPreviewQuery = { user: { id: string, soup: { items: Array<+ | { __typename: 'GraphqlSoupAgentSession', id: string, displayName: string | null }| { __typename: 'GraphqlSoupCalendarEvent', id: string, displayName: string | null }| { __typename: 'GraphqlSoupCall', customName: string | null, channelName: string | null, id: string, displayName: string | null }| { __typename: 'GraphqlSoupChannel', channelType: string, id: string, displayName: string | null, channelDisplayName: string | null }@@ -5684,6 +6026,7 @@ export type ItemPreviewsQueryVariables = Exact<{export type ItemPreviewsQuery = { user: { id: string, soup: { items: Array<+ | { __typename: 'GraphqlSoupAgentSession', id: string, displayName: string | null }| { __typename: 'GraphqlSoupCalendarEvent', id: string, displayName: string | null }| { __typename: 'GraphqlSoupCall', customName: string | null, channelName: string | null, id: string, displayName: string | null }| { __typename: 'GraphqlSoupChannel', channelType: string, id: string, displayName: string | null, channelDisplayName: string | null }@@ -5714,6 +6057,8 @@ export type ItemPreviewsQuery = { user: { id: string, soup: { items: Array<| { __typename: 'GraphqlSoupReminder', id: string, displayName: string | null }> } } };+type ItemPreviewDetailsFields_GraphqlSoupAgentSession_Fragment = { __typename: 'GraphqlSoupAgentSession', id: string, displayName: string | null };+type ItemPreviewDetailsFields_GraphqlSoupCalendarEvent_Fragment = { __typename: 'GraphqlSoupCalendarEvent', id: string, displayName: string | null };type ItemPreviewDetailsFields_GraphqlSoupCall_Fragment = { __typename: 'GraphqlSoupCall', customName: string | null, channelName: string | null, id: string, displayName: string | null };@@ -5754,6 +6099,7 @@ type ItemPreviewDetailsFields_GraphqlSoupProject_Fragment = { __typename: 'Graphtype ItemPreviewDetailsFields_GraphqlSoupReminder_Fragment = { __typename: 'GraphqlSoupReminder', id: string, displayName: string | null };export type ItemPreviewDetailsFieldsFragment =+ | ItemPreviewDetailsFields_GraphqlSoupAgentSession_Fragment| ItemPreviewDetailsFields_GraphqlSoupCalendarEvent_Fragment| ItemPreviewDetailsFields_GraphqlSoupCall_Fragment| ItemPreviewDetailsFields_GraphqlSoupChannel_Fragment@@ -5767,6 +6113,8 @@ export type ItemPreviewDetailsFieldsFragment =| ItemPreviewDetailsFields_GraphqlSoupReminder_Fragment;+type ItemPreviewFields_GraphqlSoupAgentSession_Fragment = { __typename: 'GraphqlSoupAgentSession', id: string, displayName: string | null };+type ItemPreviewFields_GraphqlSoupCalendarEvent_Fragment = { __typename: 'GraphqlSoupCalendarEvent', id: string, displayName: string | null };type ItemPreviewFields_GraphqlSoupCall_Fragment = { __typename: 'GraphqlSoupCall', customName: string | null, channelName: string | null, id: string, displayName: string | null };@@ -5794,6 +6142,7 @@ type ItemPreviewFields_GraphqlSoupProject_Fragment = { __typename: 'GraphqlSoupPtype ItemPreviewFields_GraphqlSoupReminder_Fragment = { __typename: 'GraphqlSoupReminder', id: string, displayName: string | null };export type ItemPreviewFieldsFragment =+ | ItemPreviewFields_GraphqlSoupAgentSession_Fragment| ItemPreviewFields_GraphqlSoupCalendarEvent_Fragment| ItemPreviewFields_GraphqlSoupCall_Fragment| ItemPreviewFields_GraphqlSoupChannel_Fragment@@ -5828,6 +6177,7 @@ export type SoupMembershipQueryVariables = Exact<{export type SoupMembershipQuery = { user: { id: string, soup: { items: Array<+ | { __typename: 'GraphqlSoupAgentSession', id: string }| { __typename: 'GraphqlSoupCalendarEvent', id: string }| { __typename: 'GraphqlSoupCall', id: string }| { __typename: 'GraphqlSoupChannel', id: string }@@ -5844,6 +6194,30 @@ export type SoupMembershipQuery = { user: { id: string, soup: { items: Array<type SoupPatchFields_GraphqlCacheDeletion_Fragment = { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string };type SoupPatchFields_SoupUpdated_Fragment = { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -6189,6 +6563,30 @@ export type SoupUpdatesSubscriptionVariables = Exact<{ [key: string]: never; }>;export type SoupUpdatesSubscription = { soupUpdates: Array<| { __typename: 'GraphqlCacheDeletion', graphqlTypeName: string, entityId: string }| { __typename: 'SoupUpdated', item:+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -6530,6 +6928,30 @@ export type SoupQueryVariables = Exact<{export type SoupQuery = { user: { id: string, soup: { nextCursor: string | null, items: Array<+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -6870,6 +7292,30 @@ export type SoupBackfillQueryVariables = Exact<{export type SoupBackfillQuery = { user: { id: string, soup: { nextCursor: string | null, items: Array<+ | { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -7209,6 +7655,31 @@ export type SoupBackfillQuery = { user: { id: string, soup: { nextCursor: string}> }> } } };+type SoupItemFields_GraphqlSoupAgentSession_Fragment = { __typename: 'GraphqlSoupAgentSession', cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> };+type SoupItemFields_GraphqlSoupCalendarEvent_Fragment = { __typename: 'GraphqlSoupCalendarEvent', time: unknown, conferenceUrl: string | null, isReadOnly: boolean, ownerId: string, createdAt: string, updatedAt: string, cacheProjection: string | null, frecencyScore: number | null, id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, calendarEventTitle: string, calendarEventStatus: string, properties: Array<{ id: string, propertyDefinitionId: string, displayName: string, dataType: GraphqlPropertyDataType, isMultiSelect: boolean, specificEntityType: GraphqlPropertyEntityType | null, isSystem: boolean, isMetadata: boolean, value:| { __typename: 'GraphqlBooleanPropertyValue', boolValue: boolean }| { __typename: 'GraphqlDatePropertyValue', dateValue: string }@@ -7553,6 +8024,7 @@ type SoupItemFields_GraphqlSoupReminder_Fragment = { __typename: 'GraphqlSoupRem}> };export type SoupItemFieldsFragment =+ | SoupItemFields_GraphqlSoupAgentSession_Fragment| SoupItemFields_GraphqlSoupCalendarEvent_Fragment| SoupItemFields_GraphqlSoupCall_Fragment| SoupItemFields_GraphqlSoupChannel_Fragment@@ -7566,6 +8038,31 @@ export type SoupItemFieldsFragment =| SoupItemFields_GraphqlSoupReminder_Fragment;+type SoupEntityCoreFields_GraphqlSoupAgentSession_Fragment = { id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> };+type SoupEntityCoreFields_GraphqlSoupCalendarEvent_Fragment = { id: string, entityType: GraphqlSoupEntityType, displayName: string | null, isFavorited: boolean, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:| { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }| { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }@@ -7842,6 +8339,7 @@ type SoupEntityCoreFields_GraphqlSoupReminder_Fragment = { id: string, entityTyp}> };export type SoupEntityCoreFieldsFragment =+ | SoupEntityCoreFields_GraphqlSoupAgentSession_Fragment| SoupEntityCoreFields_GraphqlSoupCalendarEvent_Fragment| SoupEntityCoreFields_GraphqlSoupCall_Fragment| SoupEntityCoreFields_GraphqlSoupChannel_Fragment@@ -7982,6 +8480,30 @@ export type SoupNotificationsQueryVariables = Exact<{export type SoupNotificationsQuery = { user: { id: string, soup: { nextCursor: string | null, items: Array<+ | { __typename: 'GraphqlSoupAgentSession', id: string, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> }| { __typename: 'GraphqlSoupCalendarEvent', id: string, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:| { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }| { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }@@ -8248,6 +8770,31 @@ export type SoupNotificationsQuery = { user: { id: string, soup: { nextCursor: s}> }> } } };+type SoupNotificationsEntityFields_GraphqlSoupAgentSession_Fragment = { __typename: 'GraphqlSoupAgentSession', id: string, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:+ | { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }+ | { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }+ | { __typename: 'GraphqlCallStartedMetadata', callStartedChannelName: string | null, callStartedSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelInviteMetadata', channelInviteInvitedBy: string, channelInviteChannelName: string, channelInviteMessageContent: string | null, channelInviteSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMentionMetadata', channelMentionMessageId: string, channelMentionMessageContent: string, channelMentionHasAttachments: boolean, channelMentionThreadId: string | null, channelMentionSenderDisplayName: string | null, channelMentionChannelType: GraphqlNotificationChannelType, channelMentionChannelName: string, channelMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelMessageSendMetadata', channelMessageSendSender: string | null, channelMessageSendSenderDisplayName: string | null, channelMessageSendMessageContent: string, channelMessageSendMessageId: string, channelMessageSendHasAttachments: boolean, channelMessageSendChannelType: GraphqlNotificationChannelType, channelMessageSendChannelName: string, channelMessageSendSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlChannelReplyMetadata', channelReplyThreadId: string, channelReplyMessageId: string, channelReplyUserId: string | null, channelReplySenderDisplayName: string | null, channelReplyMessageContent: string, channelReplyHasAttachments: boolean, channelReplyThreadParentSenderId: string | null, channelReplyChannelType: GraphqlNotificationChannelType, channelReplyChannelName: string, channelReplySenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlCommentedOnDocumentMetadata', commentedOnDocumentDocumentName: string, commentedOnDocumentOwner: string, commentedOnDocumentFileType: string | null, commentedOnDocumentSubType: GraphqlNotificationDocumentSubType | null, commentedOnDocumentCommentId: number, commentedOnDocumentThreadId: number, commentedOnDocumentText: string, commentedOnDocumentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlDocumentMentionMetadata', documentMentionDocumentName: string, documentMentionOwner: string, documentMentionFileType: string | null, documentMentionSubType: GraphqlNotificationDocumentSubType | null, documentMentionMessageId: string, documentMentionMessageContent: string, documentMentionHasAttachments: boolean, documentMentionThreadId: string | null, documentMentionSenderDisplayName: string | null, documentMentionChannelType: GraphqlNotificationChannelType, documentMentionChannelName: string, documentMentionSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlGithubPrCheckRunMetadata', githubPrCheckRunForeignEntityId: string, githubPrCheckRunGithubKey: string, githubPrCheckRunOwner: string, githubPrCheckRunRepo: string, githubPrCheckRunNumber: string, githubPrCheckRunUrl: string, githubPrCheckRunDisplayName: string, githubPrCheckRunTitle: string, githubPrCheckRunSenderGithubLogin: string | null, githubPrCheckRunSenderGithubUserId: string | null, githubPrCheckRunSenderGithubAvatarUrl: string | null, githubPrCheckRunCheckRunGithubId: string, githubPrCheckRunCheckName: string, githubPrCheckRunCheckStatus: string, githubPrCheckRunConclusion: string, githubPrCheckRunState: GraphqlGithubPrCheckRunState, githubPrCheckRunCheckUrl: string, githubPrCheckRunCompletedAt: string }+ | { __typename: 'GraphqlGithubPrCommentMetadata', githubPrCommentForeignEntityId: string, githubPrCommentGithubKey: string, githubPrCommentOwner: string, githubPrCommentRepo: string, githubPrCommentNumber: string, githubPrCommentUrl: string, githubPrCommentDisplayName: string, githubPrCommentTitle: string, githubPrCommentSenderGithubLogin: string | null, githubPrCommentSenderGithubUserId: string | null, githubPrCommentSenderGithubAvatarUrl: string | null, githubPrCommentCommentKind: GraphqlGithubPrCommentKind, githubPrCommentCommentGithubId: string | null, githubPrCommentCommentUrl: string | null, githubPrCommentCommentSnippet: string }+ | { __typename: 'GraphqlGithubPrMentionMetadata', githubPrMentionForeignEntityId: string, githubPrMentionGithubKey: string, githubPrMentionOwner: string, githubPrMentionRepo: string, githubPrMentionNumber: string, githubPrMentionUrl: string, githubPrMentionDisplayName: string, githubPrMentionTitle: string, githubPrMentionSenderGithubLogin: string | null, githubPrMentionSenderGithubUserId: string | null, githubPrMentionSenderGithubAvatarUrl: string | null, githubPrMentionLocation: GraphqlGithubPrMentionLocation, githubPrMentionCommentGithubId: string | null, githubPrMentionCommentUrl: string | null, githubPrMentionTextSnippet: string }+ | { __typename: 'GraphqlGithubPrReviewMetadata', githubPrReviewForeignEntityId: string, githubPrReviewGithubKey: string, githubPrReviewOwner: string, githubPrReviewRepo: string, githubPrReviewNumber: string, githubPrReviewUrl: string, githubPrReviewDisplayName: string, githubPrReviewTitle: string, githubPrReviewSenderGithubLogin: string | null, githubPrReviewSenderGithubUserId: string | null, githubPrReviewSenderGithubAvatarUrl: string | null, githubPrReviewReviewGithubId: string | null, githubPrReviewReviewUrl: string | null, githubPrReviewState: GraphqlGithubPrReviewState, githubPrReviewReviewSnippet: string | null }+ | { __typename: 'GraphqlGithubPrStatusChangedMetadata', githubPrStatusChangedForeignEntityId: string, githubPrStatusChangedGithubKey: string, githubPrStatusChangedOwner: string, githubPrStatusChangedRepo: string, githubPrStatusChangedNumber: string, githubPrStatusChangedUrl: string, githubPrStatusChangedDisplayName: string, githubPrStatusChangedTitle: string, githubPrStatusChangedSenderGithubLogin: string | null, githubPrStatusChangedSenderGithubUserId: string | null, githubPrStatusChangedSenderGithubAvatarUrl: string | null, githubPrStatusChangedStatus: GraphqlGithubPrEventStatus, githubPrStatusChangedAction: GraphqlGithubPrEventAction, githubPrStatusChangedPreviousStatus: GraphqlGithubPrEventStatus | null, githubPrStatusChangedHeadBranch: string | null, githubPrStatusChangedBaseBranch: string | null, githubPrStatusChangedMergedAt: string | null }+ | { __typename: 'GraphqlGithubReviewRequestedMetadata', githubReviewRequestedForeignEntityId: string, githubReviewRequestedGithubKey: string, githubReviewRequestedOwner: string, githubReviewRequestedRepo: string, githubReviewRequestedNumber: string, githubReviewRequestedUrl: string, githubReviewRequestedDisplayName: string, githubReviewRequestedTitle: string, githubReviewRequestedSenderGithubLogin: string | null, githubReviewRequestedSenderGithubUserId: string | null, githubReviewRequestedSenderGithubAvatarUrl: string | null, githubReviewRequestedRequestedReviewerGithubLogin: string | null, githubReviewRequestedRequestedReviewerGithubUserId: string | null }+ | { __typename: 'GraphqlInboxReauthRequiredMetadata', inboxReauthRequiredEmailAddress: string }+ | { __typename: 'GraphqlInviteToTeamMetadata', inviteToTeamTeamName: string, inviteToTeamTeamId: string, inviteToTeamTeamInviteId: string, inviteToTeamInvitedBy: string, inviteToTeamRole: string | null, inviteToTeamSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlMentionedInDocumentCommentMetadata', mentionedInDocumentCommentDocumentName: string, mentionedInDocumentCommentOwner: string, mentionedInDocumentCommentFileType: string | null, mentionedInDocumentCommentSubType: GraphqlNotificationDocumentSubType | null, mentionedInDocumentCommentMentionId: string, mentionedInDocumentCommentCommentId: number, mentionedInDocumentCommentThreadId: number, mentionedInDocumentCommentText: string, mentionedInDocumentCommentSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlNewEmailMetadata', newEmailSender: string | null, newEmailToEmail: string, newEmailThreadId: string, newEmailSubject: string, newEmailSnippet: string }+ | { __typename: 'GraphqlReminderMetadata', reminderReminderId: string, reminderDescription: string }+ | { __typename: 'GraphqlRepliedToDocumentCommentThreadMetadata', repliedToDocumentCommentThreadDocumentName: string, repliedToDocumentCommentThreadOwner: string, repliedToDocumentCommentThreadFileType: string | null, repliedToDocumentCommentThreadSubType: GraphqlNotificationDocumentSubType | null, repliedToDocumentCommentThreadCommentId: number, repliedToDocumentCommentThreadThreadId: number, repliedToDocumentCommentThreadText: string, repliedToDocumentCommentThreadSenderProfilePictureUrl: string | null }+ | { __typename: 'GraphqlTaskAssignedMetadata', taskAssignedTaskId: string, taskAssignedTaskName: string | null, taskAssignedSubType: GraphqlNotificationDocumentSubType | null, taskAssignedAssignedBy: string, taskAssignedSenderProfilePictureUrl: string | null }+ }> };+type SoupNotificationsEntityFields_GraphqlSoupCalendarEvent_Fragment = { __typename: 'GraphqlSoupCalendarEvent', id: string, notifications: Array<{ id: string, eventType: string, entityType: GraphqlSoupEntityType, entityId: string, sent: boolean, state: NotificationState, createdAt: string, viewedAt: string | null, updatedAt: string, senderId: string | null, metadata:| { __typename: 'GraphqlAiResponseMetadata', aiResponseSummary: string, aiResponseMessageId: string }| { __typename: 'GraphqlCalendarEventReminderMetadata', calendarEventReminderEventId: string, calendarEventReminderOccurrenceKey: string, calendarEventReminderTitle: string, calendarEventReminderStartsAt: string | null, calendarEventReminderEndsAt: string | null, calendarEventReminderStartDate: string | null, calendarEventReminderTimeZone: string | null, calendarEventReminderMinutesBefore: number }@@ -8524,6 +9071,7 @@ type SoupNotificationsEntityFields_GraphqlSoupReminder_Fragment = { __typename:}> };export type SoupNotificationsEntityFieldsFragment =+ | SoupNotificationsEntityFields_GraphqlSoupAgentSession_Fragment| SoupNotificationsEntityFields_GraphqlSoupCalendarEvent_Fragment| SoupNotificationsEntityFields_GraphqlSoupCall_Fragment| SoupNotificationsEntityFields_GraphqlSoupChannel_Fragmentdiff --git a/apps/web/src/lib/service-clients/service-storage/openapi.json b/apps/web/src/lib/service-clients/service-storage/openapi.jsonindex 357adc5241..0a9317c70b 100644--- a/apps/web/src/lib/service-clients/service-storage/openapi.json+++ b/apps/web/src/lib/service-clients/service-storage/openapi.json@@ -12982,6 +12982,30 @@],"description": "Which Pipedream MCP servers an agent's sessions are handed.\n\nOne value for the whole choice, so a selection can never travel without\nits scope or a scope without its selection. Serialized with a `scope` tag,\nwhich the generated TypeScript sees as a discriminated union."},+ "AgentSessionFilters": {+ "type": "object",+ "description": "Filters for agent sessions.",+ "properties": {+ "ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Agent session ids to filter by. Empty to include all accessible sessions."+ },+ "include": {+ "type": "boolean",+ "description": "Opt this query into agent sessions at all. Agent sessions are off by\ndefault — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].\nAsking for specific `ids` or `owners` also opts in."+ },+ "owners": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Filter by session owner. Examples: ['macro|[email protected]']. Empty to\ninclude every owner."+ }+ }+ },"AgentSessionLifecycleEvent": {"oneOf": [{@@ -14052,6 +14076,9 @@"type": "object","description": "Wire-format entity filter AST accepted by soup AST endpoints.","properties": {+ "asf": {+ "description": "Filters applied to agent sessions (wire key `asf`). Like reminders,\nempty/omitted returns **no** agent sessions: they are opt-in, so the\ncaller must send `inc`, an id, or an owner to get any."+ },"calf": {"description": "filters applied to canonical calendar events"},@@ -20145,6 +20172,10 @@"type": "object","description": "a bundle of all of the filters for each entity type","properties": {+ "agent_session_filters": {+ "$ref": "#/components/schemas/AgentSessionFilters",+ "description": "the bundled [AgentSessionFilters]"+ },"calendar_event_filters": {"$ref": "#/components/schemas/CalendarEventFilters","description": "the bundled [CalendarEventFilters]"@@ -24922,6 +24953,81 @@}}},+ "SoupAgentSession_SoupPropertiesField": {+ "allOf": [+ {+ "type": "object",+ "description": "Property fields that can be flattened into property-bearing Soup items.",+ "required": ["properties"],+ "properties": {+ "properties": {+ "type": "array",+ "items": {+ "$ref": "#/components/schemas/SoupProperty"+ },+ "description": "Properties attached to the entity."+ }+ }+ },+ {+ "type": "object",+ "required": [+ "id",+ "name",+ "ownerId",+ "botId",+ "status",+ "createdAt",+ "updatedAt"+ ],+ "properties": {+ "botId": {+ "type": "string",+ "format": "uuid",+ "description": "The bot running this session"+ },+ "createdAt": {+ "type": "string",+ "format": "date-time",+ "description": "The time the session was created"+ },+ "id": {+ "type": "string",+ "format": "uuid",+ "description": "The agent session uuid"+ },+ "name": {+ "type": "string",+ "description": "The user-facing name of the session"+ },+ "ownerId": {+ "type": "string",+ "description": "Who the session belongs to"+ },+ "status": {+ "type": "string",+ "description": "The session's last known status.\n\n`no_messages` until the first system event arrives, `disconnected` if\nthe connection dropped without a clean close, otherwise the wire name\nof the most recent system event (for example `session/end`)."+ },+ "threadId": {+ "type": ["string", "null"],+ "format": "uuid",+ "description": "The channel thread the session was opened from, when any"+ },+ "updatedAt": {+ "type": "string",+ "format": "date-time",+ "description": "The time the session was last modified"+ },+ "viewedAt": {+ "type": ["string", "null"],+ "format": "date-time",+ "description": "The time the session was last viewed by the requesting user"+ }+ }+ }+ ],+ "description": "An agent session as displayed in Soup.\n\nMirrors [`crate::chat::SoupChat`]: an agent session is the coding-agent\ncounterpart of a chat, so it carries the same identity, ownership, and\nrecency fields plus the session's last known status."+ },"SoupApiItem": {"allOf": [{@@ -26138,6 +26244,21 @@"enum": ["reminder"]}}+ },+ {+ "type": "object",+ "description": "Agent session item.",+ "required": ["data", "tag"],+ "properties": {+ "data": {+ "$ref": "#/components/schemas/SoupAgentSession_SoupPropertiesField",+ "description": "Agent session item."+ },+ "tag": {+ "type": "string",+ "enum": ["agentSession"]+ }+ }}],"description": "A single item in the Soup feed."diff --git a/crates/agent_harness/src/outbound/cursor/manager/test.rs b/crates/agent_harness/src/outbound/cursor/manager/test.rsindex 6c43e67f9b..68228cd1a1 100644--- a/crates/agent_harness/src/outbound/cursor/manager/test.rs+++ b/crates/agent_harness/src/outbound/cursor/manager/test.rs@@ -9,8 +9,8 @@ use agent_runtime_protocol::domain::schema::v0::{};use agent_session::domain::error::Result as SessionResult;use agent_session::domain::model::{- AgentSession, ChannelSession, CreateAgentSessionParams, DEFAULT_AGENT_SESSION_NAME,- SandboxSize, SessionBot, SessionStatus,+ AgentSession, AgentSessionPreview, ChannelSession, CreateAgentSessionParams,+ DEFAULT_AGENT_SESSION_NAME, SandboxSize, SessionBot, SessionStatus,};use bot_id::BotId;use cursor_api_key::cipher::CursorApiKey;@@ -64,6 +64,14 @@ impl AgentSessionRepo for StubSessions {unimplemented!("the manager never looks sessions up by egress token")}+ async fn preview(+ &self,+ _viewer: &MacroUserIdStr<'static>,+ _ids: &[AgentSessionId],+ ) -> SessionResult<Vec<AgentSessionPreview>> {+ unimplemented!("the manager never previews sessions")+ }+async fn get(&self, id: AgentSessionId) -> SessionResult<AgentSession> {Ok(AgentSession {id,diff --git a/crates/agent_harness/src/outbound/routing/test.rs b/crates/agent_harness/src/outbound/routing/test.rsindex bc73ad74f7..ce63b63d93 100644--- a/crates/agent_harness/src/outbound/routing/test.rs+++ b/crates/agent_harness/src/outbound/routing/test.rs@@ -4,8 +4,8 @@ use crate::testing::helpers::egress::test_egress;use agent_runtime_protocol::domain::schema::v0::{ToRuntimeMessage, ToServerMessage};use agent_session::domain::error::Result as SessionResult;use agent_session::domain::model::{- AgentSession, ChannelSession, CreateAgentSessionParams, DEFAULT_AGENT_SESSION_NAME,- SandboxSize, SessionBot, SessionStatus,+ AgentSession, AgentSessionPreview, ChannelSession, CreateAgentSessionParams,+ DEFAULT_AGENT_SESSION_NAME, SandboxSize, SessionBot, SessionStatus,};use bot_id::BotId;use macro_user_id::user_id::MacroUserIdStr;@@ -111,6 +111,14 @@ impl AgentSessionRepo for FixedBotSessions {unimplemented!("the router never looks sessions up by egress token")}+ async fn preview(+ &self,+ _viewer: &MacroUserIdStr<'static>,+ _ids: &[AgentSessionId],+ ) -> SessionResult<Vec<AgentSessionPreview>> {+ unimplemented!("the router never previews sessions")+ }+async fn get(&self, id: AgentSessionId) -> SessionResult<AgentSession> {Ok(AgentSession {id,diff --git a/crates/agent_session/src/domain/error.rs b/crates/agent_session/src/domain/error.rsindex a0a1d6e84f..7214c03667 100644--- a/crates/agent_session/src/domain/error.rs+++ b/crates/agent_session/src/domain/error.rs@@ -22,6 +22,8 @@ pub enum AgentSessionError {UnknownOwner,#[error("invalid agent session name: {0}")]InvalidName(&'static str),+ #[error("a preview request may name at most {0} sessions")]+ TooManyPreviewIds(usize),#[error("the caller may not control this agent session")]Forbidden,#[error("no queued action with this id; it may already have been dispatched")]diff --git a/crates/agent_session/src/domain/model.rs b/crates/agent_session/src/domain/model.rsindex 1a1c3d3e6d..45ead6e7a4 100644--- a/crates/agent_session/src/domain/model.rs+++ b/crates/agent_session/src/domain/model.rs@@ -138,7 +138,7 @@ pub const DEFAULT_AGENT_SESSION_NAME: &str = "Agent Session";/// Maximum number of Unicode scalar values in a session name.pub const MAX_AGENT_SESSION_NAME_CHARS: usize = 100;-#[derive(Debug, Clone, Default, strum::AsRefStr)]+#[derive(Debug, Clone, Default, PartialEq, Eq, strum::AsRefStr)]#[strum(serialize_all = "snake_case")]pub enum SessionStatus {/// No status updates received.@@ -408,6 +408,62 @@ pub enum ChannelSession {CreatedFromThread(AgentSession),}+/// Maximum number of session ids one preview request may ask about.+///+/// Bounds the work and the response per call; a mention menu never renders+/// anywhere near this many chips at once.+pub const MAX_PREVIEW_SESSION_IDS: usize = 100;++/// What one requested id resolved to in a batch preview.+///+/// Previews exist so a client can render a chip for a session it was handed a+/// reference to - a mention, a link - without first knowing whether it can+/// open it. Each id is therefore answered with one of three facts rather than+/// an error: the viewer can see it (with the fields a chip renders), the+/// session exists but the viewer holds no grant on it, or nothing by that id+/// exists at all. Only the first carries data, so a viewer without access+/// learns nothing beyond the session's existence - the same fact a `403`+/// from `GET /agent-sessions/{id}` already gives away.+#[derive(Debug, Clone, PartialEq, Eq)]+pub enum AgentSessionPreview {+ /// The viewer holds at least view access; here is what a chip needs.+ Access(AgentSessionPreviewData),+ /// The session exists, but the viewer holds no grant on it.+ NoAccess(AgentSessionId),+ /// No session with this id exists.+ DoesNotExist(AgentSessionId),+}++impl AgentSessionPreview {+ /// The id this preview answers for, whichever way it resolved.+ #[must_use]+ pub fn id(&self) -> AgentSessionId {+ match self {+ Self::Access(data) => data.id,+ Self::NoAccess(id) | Self::DoesNotExist(id) => *id,+ }+ }+}++/// The subset of an [`AgentSession`] a chip or mention renders.+#[derive(Debug, Clone, PartialEq, Eq)]+pub struct AgentSessionPreviewData {+ /// The session id.+ pub id: AgentSessionId,+ /// User-facing session name.+ pub name: String,+ /// The user who owns the session.+ pub owner_id: MacroUserIdStr<'static>,+ /// The bot running the agent, for its avatar.+ pub bot_id: BotId,+ /// The session's last known status, for a live status indicator.+ pub status: SessionStatus,+ /// When the session was created.+ pub created_at: DateTime<Utc>,+ /// When the session was last modified.+ pub modified_at: DateTime<Utc>,+}+/// Initialization selected by a matching successful load in the session machine./// Persistence must append the response and select this row in one fenced transaction.#[derive(Debug, Clone, Copy, PartialEq, Eq)]diff --git a/crates/agent_session/src/domain/ports.rs b/crates/agent_session/src/domain/ports.rsindex 7b8246d46c..843faf8585 100644--- a/crates/agent_session/src/domain/ports.rs+++ b/crates/agent_session/src/domain/ports.rs@@ -257,6 +257,20 @@ pub trait AgentSessionRepo: Send + Sync + 'static {/// Get an agent session by id.fn get(&self, id: AgentSessionId) -> impl Future<Output = Result<AgentSession>> + Send;+ /// Resolve each of `ids` to what `viewer` may see of it, for chips.+ ///+ /// One [`AgentSessionPreview`] per id in `ids`, in no particular order.+ /// Access is the session's own `entity_access` grants resolved against+ /// the viewer - as themselves, through the channels they are still in,+ /// and through their teams - the same predicate the read routes' access+ /// extractor applies, so a preview says `Access` exactly when+ /// `GET /agent-sessions/{id}` would answer.+ fn preview(+ &self,+ viewer: &MacroUserIdStr<'static>,+ ids: &[AgentSessionId],+ ) -> impl Future<Output = Result<Vec<AgentSessionPreview>>> + Send;+/// The session a sandbox's egress token stands for, if any still does.////// `egress_token_hash` is the SHA-256 hex of the token as presented, neverdiff --git a/crates/agent_session/src/domain/service.rs b/crates/agent_session/src/domain/service.rsindex 5cace53e36..37ae89e9b1 100644--- a/crates/agent_session/src/domain/service.rs+++ b/crates/agent_session/src/domain/service.rs@@ -50,10 +50,10 @@ use super::error::{AgentSessionError, Result};use super::lifecycle::session_identity;use super::model::SessionBot;use super::model::{- AgentSession, AgentSessionId, AgentSessionLog, AgentSessionRenamed, AuthorKind, ChannelSession,- ClaimOutcome, CreateAgentSessionParams, LogAppended, MAX_AGENT_SESSION_NAME_CHARS, Message,- MessageId, ReplicaId, SandboxSize, SessionClaim, SessionLog, SessionManagement,- StoredAgentSessionLog,+ AgentSession, AgentSessionId, AgentSessionLog, AgentSessionPreview, AgentSessionRenamed,+ AuthorKind, ChannelSession, ClaimOutcome, CreateAgentSessionParams, LogAppended,+ MAX_AGENT_SESSION_NAME_CHARS, MAX_PREVIEW_SESSION_IDS, Message, MessageId, ReplicaId,+ SandboxSize, SessionClaim, SessionLog, SessionManagement, StoredAgentSessionLog,};use super::ports::{AgentConnector, AgentSessionLifecyclePublisher, AgentSessionLogRepo, AgentSessionLogWriter,@@ -140,6 +140,17 @@ pub trait AgentSessionService: Send + Sync + 'static {/// Get a persisted agent session by id.fn get_session(&self, id: AgentSessionId) -> impl Future<Output = Result<AgentSession>> + Send;+ /// What `viewer` may see of each of `ids`, for rendering chips.+ ///+ /// Duplicate ids are collapsed, so the answer has one entry per distinct+ /// id. More than [`MAX_PREVIEW_SESSION_IDS`] distinct ids is+ /// [`AgentSessionError::TooManyPreviewIds`].+ fn preview_sessions(+ &self,+ viewer: &MacroUserIdStr<'static>,+ ids: Vec<AgentSessionId>,+ ) -> impl Future<Output = Result<Vec<AgentSessionPreview>>> + Send;+/// Rename a session after owner access has been verified.fn rename_session(&self,@@ -611,6 +622,27 @@ whereself.repo.get(id).await}+ async fn preview_sessions(+ &self,+ viewer: &MacroUserIdStr<'static>,+ ids: Vec<AgentSessionId>,+ ) -> Result<Vec<AgentSessionPreview>> {+ let ids: Vec<AgentSessionId> = ids+ .into_iter()+ .collect::<std::collections::HashSet<_>>()+ .into_iter()+ .collect();+ if ids.len() > MAX_PREVIEW_SESSION_IDS {+ return Err(AgentSessionError::TooManyPreviewIds(+ MAX_PREVIEW_SESSION_IDS,+ ));+ }+ if ids.is_empty() {+ return Ok(Vec::new());+ }+ self.repo.preview(viewer, &ids).await+ }+async fn find_for_channel(&self,thread_id: Option<Uuid>,@@ -1105,6 +1137,14 @@ whereself.repo.get(id).await}+ async fn preview(+ &self,+ viewer: &MacroUserIdStr<'static>,+ ids: &[AgentSessionId],+ ) -> Result<Vec<AgentSessionPreview>> {+ self.repo.preview(viewer, ids).await+ }+async fn find_by_egress_token_hash(&self,egress_token_hash: &str,diff --git a/crates/agent_session/src/domain/service/test.rs b/crates/agent_session/src/domain/service/test.rsindex 97e664d04b..53aa847828 100644--- a/crates/agent_session/src/domain/service/test.rs+++ b/crates/agent_session/src/domain/service/test.rs@@ -391,6 +391,14 @@ impl AgentSessionRepo for BlockingPromptLogs {self.repo.get(id).await}+ async fn preview(+ &self,+ viewer: &MacroUserIdStr<'static>,+ ids: &[AgentSessionId],+ ) -> Result<Vec<AgentSessionPreview>> {+ self.repo.preview(viewer, ids).await+ }+async fn session_bot(&self, id: BotId) -> Result<SessionBot> {self.repo.session_bot(id).await}diff --git a/crates/agent_session/src/inbound/axum_router.rs b/crates/agent_session/src/inbound/axum_router.rsindex f95920ba67..9efa00b26c 100644--- a/crates/agent_session/src/inbound/axum_router.rs+++ b/crates/agent_session/src/inbound/axum_router.rs@@ -45,8 +45,8 @@ use utoipa::ToSchema;use crate::domain::error::AgentSessionError;use crate::domain::model::{- AgentSession, AgentSessionId, ExternalSession, Message, SandboxSize, SessionBot, SessionStatus,- StoredAgentSessionLog,+ AgentSession, AgentSessionId, AgentSessionPreview, ExternalSession, Message, SandboxSize,+ SessionBot, SessionStatus, StoredAgentSessionLog,};use crate::domain::ports::{AgentSessionNotificationRecipient, BotDirectory, BotFacts, ControlDisposition, ControlEvent,@@ -172,6 +172,10 @@ whereS: Clone + Send + Sync + 'static,{Router::new()+ .route(+ "/preview",+ post(preview_agent_sessions_handler::<T, Access, Auth>),+ ).route("/{session_id}",get(get_agent_session_handler::<T, Access, Auth>),@@ -302,6 +306,9 @@ impl IntoResponse for AgentSessionApiError {Self::Domain(error @ AgentSessionError::ControlQueueFull(_)) => {(StatusCode::UNPROCESSABLE_ENTITY, error.to_string()).into_response()}+ Self::Domain(error @ AgentSessionError::TooManyPreviewIds(_)) => {+ (StatusCode::BAD_REQUEST, error.to_string()).into_response()+ }Self::Domain(error) => {if let AgentSessionError::InvalidName(message) = error {return (StatusCode::BAD_REQUEST, Json(message)).into_response();@@ -565,6 +572,146 @@ pub async fn get_agent_session_handler<Ok(Json(session.into()))}+/// Request body for `POST /agent-sessions/preview`.+///+/// Clients serialize this, so both derives are used.+#[derive(Debug, Serialize, Deserialize, ToSchema)]+#[serde(rename_all = "camelCase")]+pub struct PreviewAgentSessionsRequest {+ /// The sessions to preview. Duplicates are collapsed server-side; at most+ /// [`MAX_PREVIEW_SESSION_IDS`](crate::domain::model::MAX_PREVIEW_SESSION_IDS)+ /// distinct ids per request.+ pub session_ids: Vec<Uuid>,+}++/// Response body for `POST /agent-sessions/preview`: one entry per distinct+/// requested id, in no particular order.+///+/// Clients deserialize this, so both derives are used.+#[derive(Debug, Serialize, Deserialize, ToSchema)]+#[serde(rename_all = "camelCase")]+pub struct PreviewAgentSessionsResponse {+ /// What the caller may see of each requested session.+ pub previews: Vec<AgentSessionPreviewDto>,+}++/// What one requested id resolved to, on the wire.+///+/// Tagged the same way the chat and document preview endpoints tag theirs+/// (`type` in `access` / `no_access` / `does_not_exist`), so a client that+/// renders those chips can render this one with the same branch.+///+/// Clients deserialize this, so both derives are used.+#[derive(Debug, Serialize, Deserialize, ToSchema)]+#[serde(tag = "type", rename_all = "snake_case")]+pub enum AgentSessionPreviewDto {+ /// The caller may view the session.+ Access(AgentSessionPreviewData),+ /// The session exists but the caller holds no grant on it.+ NoAccess(WithAgentSessionId),+ /// No session with this id exists.+ DoesNotExist(WithAgentSessionId),+}++/// Just a session id, for the preview variants that carry nothing else.+///+/// Clients deserialize this, so both derives are used.+#[derive(Debug, Serialize, Deserialize, ToSchema)]+#[serde(rename_all = "camelCase")]+pub struct WithAgentSessionId {+ /// The session id.+ pub id: Uuid,+}++/// The fields a chip renders for a session the caller may view.+///+/// Clients deserialize this, so both derives are used.+#[derive(Debug, Serialize, Deserialize, ToSchema)]+#[serde(rename_all = "camelCase")]+pub struct AgentSessionPreviewData {+ /// The session id.+ pub id: Uuid,+ /// User-facing session name.+ pub name: String,+ /// The user who owns the session.+ pub owner_id: String,+ /// The bot running the agent.+ pub bot_id: Uuid,+ /// The session's last known status.+ pub status: SessionStatusDto,+ /// When the session was created.+ pub created_at: DateTime<Utc>,+ /// When the session was last modified.+ pub modified_at: DateTime<Utc>,+}++impl From<AgentSessionPreview> for AgentSessionPreviewDto {+ fn from(preview: AgentSessionPreview) -> Self {+ match preview {+ AgentSessionPreview::Access(data) => Self::Access(AgentSessionPreviewData {+ id: data.id.as_uuid(),+ name: data.name,+ owner_id: data.owner_id.to_string(),+ bot_id: data.bot_id.as_uuid(),+ status: data.status.into(),+ created_at: data.created_at,+ modified_at: data.modified_at,+ }),+ AgentSessionPreview::NoAccess(id) => {+ Self::NoAccess(WithAgentSessionId { id: id.as_uuid() })+ }+ AgentSessionPreview::DoesNotExist(id) => {+ Self::DoesNotExist(WithAgentSessionId { id: id.as_uuid() })+ }+ }+ }+}++#[utoipa::path(+ post,+ path = "/agent-sessions/preview",+ tag = "agent-sessions",+ operation_id = "preview_agent_sessions",+ request_body = PreviewAgentSessionsRequest,+ responses(+ (status = 200, body = PreviewAgentSessionsResponse),+ (status = 400, body = String, description = "more than the maximum number of session ids"),+ (status = 401, body = String),+ (status = 500, body = String),+ )+)]+/// Preview a batch of agent sessions for rendering chips.+///+/// No per-id access extractor: a chip has to render for a session the caller+/// cannot open, so access is answered per id in the body rather than+/// enforced on the request. The caller learns the fields a chip shows for+/// sessions they may view, and only existence for the rest.+#[tracing::instrument(skip_all, fields(actor = %caller.acting_entity()), err(Debug))]+pub async fn preview_agent_sessions_handler<+ T: AgentSessionService,+ Access: EntityAccessService,+ Auth: MacroAuthorizationService,+>(+ State(state): State<AgentSessionRouterState<T, Access, Auth>>,+ caller: MacroAuthorizationExtractor<Auth, ActingUser>,+ Json(request): Json<PreviewAgentSessionsRequest>,+) -> Result<Json<PreviewAgentSessionsResponse>, AgentSessionApiError> {+ let previews = state+ .service+ .preview_sessions(+ &caller.authorization.user.macro_user_id,+ request+ .session_ids+ .into_iter()+ .map(AgentSessionId::new_from_uuid)+ .collect(),+ )+ .await?;+ Ok(Json(PreviewAgentSessionsResponse {+ previews: previews.into_iter().map(Into::into).collect(),+ }))+}+#[utoipa::path(put,path = "/agent-sessions/{session_id}/name",diff --git a/crates/agent_session/src/outbound/postgres.rs b/crates/agent_session/src/outbound/postgres.rsindex efbe79c7a2..fe0868d2ca 100644--- a/crates/agent_session/src/outbound/postgres.rs+++ b/crates/agent_session/src/outbound/postgres.rs@@ -7,9 +7,10 @@ mod test;use crate::domain::error::{AgentSessionError, Result};use crate::domain::model::{- AgentMcpServers, AgentSession, AgentSessionId, AgentSessionLog, ChannelSession, ClaimOutcome,- CreateAgentSessionParams, ExternalSession, ManagerFence, Message, ReplicaAddress, ReplicaId,- SandboxSize, SessionBot, SessionClaim, SessionManager, SessionStatus, StoredAgentSessionLog,+ AgentMcpServers, AgentSession, AgentSessionId, AgentSessionLog, AgentSessionPreview,+ AgentSessionPreviewData, ChannelSession, ClaimOutcome, CreateAgentSessionParams,+ ExternalSession, ManagerFence, Message, ReplicaAddress, ReplicaId, SandboxSize, SessionBot,+ SessionClaim, SessionManager, SessionStatus, StoredAgentSessionLog,};use crate::domain::ports::{AgentSessionLogRepo, AgentSessionRepo, ExternalSessionRepo, REPLICA_STALE_AFTER,@@ -122,6 +123,32 @@ fn cursor_run_checkpoint(message: &Message) -> Option<String> {.map(str::to_owned)}+/// Record that `user_id` accessed the session in their history.+///+/// The `itemType` is the [`EntityType::AgentSession`] wire name, which is+/// also what `POST /history/agent_session/{id}` writes when the session is+/// opened later, so both paths land on the same row.+async fn upsert_user_history(+ tx: &mut sqlx::Transaction<'_, sqlx::Postgres>,+ user_id: &str,+ session_id: &Uuid,+) -> anyhow::Result<()> {+ sqlx::query!(+ r#"+ INSERT INTO "UserHistory" ("userId", "itemId", "itemType", "createdAt", "updatedAt")+ VALUES ($1, $2, $3, NOW(), NOW())+ ON CONFLICT ("userId", "itemId", "itemType") DO UPDATE+ SET "updatedAt" = NOW()+ "#,+ user_id,+ session_id.to_string(),+ EntityType::AgentSession.as_ref(),+ )+ .execute(tx.as_mut())+ .await?;+ Ok(())+}+struct AgentSessionRow {id: Uuid,name: String,@@ -315,6 +342,14 @@ impl AgentSessionRepo for PgAgentSessionRepo {.context("failed to grant the originating channel access to the agent session")?;}+ // Creating a session counts as viewing it, as it does for chats: the+ // row is what Soup's `viewed_at` and the frecency ranking read, so+ // without it a brand-new session would rank below everything the+ // owner has ever opened.+ upsert_user_history(&mut transaction, owner_id.as_ref(), &id.as_uuid())+ .await+ .context("failed to record the agent session in the owner's history")?;+transaction.commit().await@@ -351,6 +386,79 @@ impl AgentSessionRepo for PgAgentSessionRepo {Ok(row.try_into()?)}+ async fn preview(+ &self,+ viewer: &MacroUserIdStr<'static>,+ ids: &[AgentSessionId],+ ) -> Result<Vec<AgentSessionPreview>> {+ let uuids: Vec<Uuid> = ids.iter().map(AgentSessionId::as_uuid).collect();+ // The viewer's grant sources - themselves, the channels they are still+ // in, their teams - are the same three the Soup leg and the access+ // extractor resolve, so a preview agrees with what a read would do.+ let rows = sqlx::query!(+ r#"+ WITH viewer_source_ids AS (+ SELECT cp.channel_id::text AS source_id+ FROM comms_channel_participants cp+ WHERE cp.user_id = $2 AND cp.left_at IS NULL+ UNION ALL+ SELECT t.team_id::text FROM team_user t WHERE t.user_id = $2+ UNION ALL+ SELECT $2+ )+ SELECT+ s.id,+ s.name,+ s.owner_id,+ s.bot_id,+ s.status,+ s.status_event_name,+ s.created_at,+ s.modified_at,+ EXISTS (+ SELECT 1 FROM entity_access ea+ WHERE ea.entity_id = s.id+ AND ea.entity_type = 'agent_session'+ AND ea.source_id IN (SELECT source_id FROM viewer_source_ids)+ ) AS "has_access!"+ FROM agent_session s+ WHERE s.id = ANY($1)+ "#,+ &uuids,+ viewer.as_ref(),+ )+ .fetch_all(&self.pool)+ .await+ .context("failed to preview agent sessions")?;++ let mut found = std::collections::HashSet::with_capacity(rows.len());+ let mut previews = Vec::with_capacity(ids.len());+ for row in rows {+ let id = AgentSessionId::new_from_uuid(row.id);+ found.insert(id);+ if !row.has_access {+ previews.push(AgentSessionPreview::NoAccess(id));+ continue;+ }+ previews.push(AgentSessionPreview::Access(AgentSessionPreviewData {+ id,+ name: row.name,+ owner_id: MacroUserIdStr::try_from(row.owner_id)+ .context("agent session has an unparseable owner")?,+ bot_id: BotId::new_from_uuid(row.bot_id),+ status: parse_status(&row.status, row.status_event_name)?,+ created_at: row.created_at,+ modified_at: row.modified_at,+ }));+ }+ previews.extend(+ ids.iter()+ .filter(|id| !found.contains(id))+ .map(|id| AgentSessionPreview::DoesNotExist(*id)),+ );+ Ok(previews)+ }+async fn find_by_egress_token_hash(&self,egress_token_hash: &str,@@ -648,6 +756,17 @@ impl AgentSessionRepo for PgAgentSessionRepo {.await.context("failed to delete agent session entity access rows")?;+ // Same story for history: `"UserHistory"."itemId"` is polymorphic+ // text, so the session's rows in every viewer's history go here.+ sqlx::query!(+ r#"DELETE FROM "UserHistory" WHERE "itemId" = $1 AND "itemType" = $2"#,+ id.as_uuid().to_string(),+ EntityType::AgentSession.as_ref(),+ )+ .execute(&mut *transaction)+ .await+ .context("failed to delete agent session history rows")?;+// A session old enough to have owned a dedicated channel leaves it// behind: it holds the history that channel renders, and is not this// operation's to destroy.diff --git a/crates/agent_session/src/outbound/postgres/test.rs b/crates/agent_session/src/outbound/postgres/test.rsindex 140f9cc15c..cc61f56034 100644--- a/crates/agent_session/src/outbound/postgres/test.rs+++ b/crates/agent_session/src/outbound/postgres/test.rs@@ -807,6 +807,152 @@ async fn create_without_a_mention_grants_only_the_owner(pool: PgPool) {assert_eq!(grants[0].access_level, "owner");}+/// Creating a session records it in the owner's history under the+/// `agent_session` item type, the same row `POST /history/agent_session/{id}`+/// touches later, so Soup's `viewed_at` is set from the moment it exists.+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]+async fn create_records_the_session_in_the_owners_history(pool: PgPool) {+ let repo = PgAgentSessionRepo::new(pool.clone());+ let bot_id = create_test_bot(&pool).await;++ let params = new_session(bot_id, None, None);+ let id = params.id;+ create_session(&repo, params).await;++ let history = sqlx::query!(+ r#"+ SELECT "userId" AS user_id, "itemType" AS item_type+ FROM "UserHistory"+ WHERE "itemId" = $1+ "#,+ id.as_uuid().to_string(),+ )+ .fetch_all(&pool)+ .await+ .expect("read the session's history rows");++ assert_eq!(history.len(), 1);+ assert_eq!(history[0].user_id, OWNER);+ assert_eq!(history[0].item_type, "agent_session");+}++/// A preview answers every requested id one way or another: the owner sees+/// the session's fields, a channel member sees them through the channel's+/// grant, a stranger learns only that it exists, and an unknown id is+/// reported as such. Duplicates in the request are the caller's problem+/// (the service collapses them); the repo answers what it is asked.+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]+async fn preview_answers_per_id_by_the_viewers_grants(pool: PgPool) {+ let repo = PgAgentSessionRepo::new(pool.clone());+ let bot_id = create_test_bot(&pool).await;+ let (channel_id, thread_id, originating_message_id) =+ insert_originating_thread_fixture(&pool).await;++ let from_channel = create_session(+ &repo,+ new_session(bot_id, Some(thread_id), Some(originating_message_id)),+ )+ .await;+ let private = create_session(&repo, new_session(bot_id, None, None)).await;+ append_system_event(&repo, private.id, SystemEvent::AcpReady).await;+ let missing = AgentSessionId::new();++ let member = "macro|[email protected]";+ let stranger = "macro|[email protected]";+ sqlx::query!(+ "INSERT INTO comms_channel_participants (channel_id, user_id, role) VALUES ($1, $2, 'member')",+ channel_id,+ member,+ )+ .execute(&pool)+ .await+ .expect("add channel member");++ let ids = [from_channel.id, private.id, missing];++ let mut owner_view = repo+ .preview(&user_id(OWNER), &ids)+ .await+ .expect("owner preview");+ owner_view.sort_by_key(|preview| preview.id().as_uuid());+ let mut expected = vec![+ AgentSessionPreview::Access(AgentSessionPreviewData {+ id: from_channel.id,+ name: DEFAULT_AGENT_SESSION_NAME.to_string(),+ owner_id: user_id(OWNER),+ bot_id,+ status: SessionStatus::NoMessages,+ created_at: from_channel.created_at,+ modified_at: from_channel.modified_at,+ }),+ AgentSessionPreview::Access(AgentSessionPreviewData {+ id: private.id,+ name: DEFAULT_AGENT_SESSION_NAME.to_string(),+ owner_id: user_id(OWNER),+ bot_id,+ status: SessionStatus::Event(SystemEvent::AcpReady),+ created_at: private.created_at,+ // Bumped by the status event, so read back rather than assumed.+ modified_at: AgentSessionRepo::get(&repo, private.id)+ .await+ .expect("reload")+ .modified_at,+ }),+ AgentSessionPreview::DoesNotExist(missing),+ ];+ expected.sort_by_key(|preview| preview.id().as_uuid());+ assert_eq!(owner_view, expected);++ let member_view = repo+ .preview(&user_id(member), &ids)+ .await+ .expect("member preview");+ assert_eq!(member_view.len(), 3);+ assert!(matches!(+ member_view.iter().find(|p| p.id() == from_channel.id),+ Some(AgentSessionPreview::Access(_))+ ));+ assert_eq!(+ member_view.iter().find(|p| p.id() == private.id),+ Some(&AgentSessionPreview::NoAccess(private.id))+ );+ assert_eq!(+ member_view.iter().find(|p| p.id() == missing),+ Some(&AgentSessionPreview::DoesNotExist(missing))+ );++ let stranger_view = repo+ .preview(&user_id(stranger), &ids)+ .await+ .expect("stranger preview");+ assert_eq!(+ stranger_view.iter().find(|p| p.id() == from_channel.id),+ Some(&AgentSessionPreview::NoAccess(from_channel.id))+ );+ assert_eq!(+ stranger_view.iter().find(|p| p.id() == private.id),+ Some(&AgentSessionPreview::NoAccess(private.id))+ );++ // A member who has left the channel loses the channel's grant with it.+ sqlx::query!(+ "UPDATE comms_channel_participants SET left_at = NOW() WHERE channel_id = $1 AND user_id = $2",+ channel_id,+ member,+ )+ .execute(&pool)+ .await+ .expect("member leaves channel");+ let left_view = repo+ .preview(&user_id(member), &[from_channel.id])+ .await+ .expect("former member preview");+ assert_eq!(+ left_view,+ vec![AgentSessionPreview::NoAccess(from_channel.id)]+ );+}+/// `entity_access.entity_id` carries no foreign key, so deleting a session/// has to take its grants with it or they accumulate forever.#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]@@ -836,6 +982,20 @@ async fn delete_removes_the_session_grants(pool: PgPool) {.expect("count the session's grants");assert_eq!(remaining, 0);++ let remaining_history = sqlx::query_scalar!(+ r#"+ SELECT COUNT(*) AS "count!"+ FROM "UserHistory"+ WHERE "itemId" = $1 AND "itemType" = 'agent_session'+ "#,+ id.as_uuid().to_string(),+ )+ .fetch_one(&pool)+ .await+ .expect("count the session's history rows");++ assert_eq!(remaining_history, 0);}fn cursor_external(agent: &str) -> ExternalSession {diff --git a/crates/agent_session/src/testing.rs b/crates/agent_session/src/testing.rsindex 0f39dadd3c..9d09b70214 100644--- a/crates/agent_session/src/testing.rs+++ b/crates/agent_session/src/testing.rs@@ -7,10 +7,10 @@use crate::domain::error::{AgentSessionError, Result};use crate::domain::events::AgentSessionLifecycleEvent;use crate::domain::model::{- AgentMcpServers, AgentSession, AgentSessionId, AgentSessionLog, ChannelSession, ClaimOutcome,- CreateAgentSessionParams, DEFAULT_AGENT_SESSION_NAME, LogAppended, ManagerFence,- ReplicaAddress, ReplicaId, SandboxSize, SessionBot, SessionClaim, SessionManager,- SessionStatus, StoredAgentSessionLog,+ AgentMcpServers, AgentSession, AgentSessionId, AgentSessionLog, AgentSessionPreview,+ AgentSessionPreviewData, ChannelSession, ClaimOutcome, CreateAgentSessionParams,+ DEFAULT_AGENT_SESSION_NAME, LogAppended, ManagerFence, ReplicaAddress, ReplicaId, SandboxSize,+ SessionBot, SessionClaim, SessionManager, SessionStatus, StoredAgentSessionLog,};use crate::domain::ports::{AgentSessionLifecyclePublisher, AgentSessionLogRepo, AgentSessionRealtime, AgentSessionRepo,@@ -155,6 +155,35 @@ impl AgentSessionRepo for InMemoryAgentSessionRepo {Ok(session)}+ async fn preview(+ &self,+ viewer: &MacroUserIdStr<'static>,+ ids: &[AgentSessionId],+ ) -> Result<Vec<AgentSessionPreview>> {+ // No `entity_access` rows to consult here: the owner is the one grant+ // `create` always writes, so ownership stands in for access.+ let sessions = self+ .sessions+ .lock()+ .expect("in-memory session store is not poisoned");+ Ok(ids+ .iter()+ .map(|id| match sessions.get(id) {+ None => AgentSessionPreview::DoesNotExist(*id),+ Some(session) if session.owner_id != *viewer => AgentSessionPreview::NoAccess(*id),+ Some(session) => AgentSessionPreview::Access(AgentSessionPreviewData {+ id: *id,+ name: session.name.clone(),+ owner_id: session.owner_id.clone(),+ bot_id: session.bot_id,+ status: session.status.clone(),+ created_at: session.created_at,+ modified_at: session.modified_at,+ }),+ })+ .collect())+ }+async fn find_by_egress_token_hash(&self,egress_token_hash: &str,diff --git a/crates/bots/src/domain/models.rs b/crates/bots/src/domain/models.rsindex c9ed3d094d..e32f960689 100644--- a/crates/bots/src/domain/models.rs+++ b/crates/bots/src/domain/models.rs@@ -152,6 +152,17 @@ pub struct Bot {pub has_agent: bool,}+/// Minimal bot identity used when another domain presents a bot reference.+#[derive(Debug, Clone, PartialEq, Eq)]+pub struct BotProfile {+ /// Bot id.+ pub id: BotId,+ /// Display name.+ pub name: String,+ /// Optional avatar URL.+ pub avatar_url: Option<String>,+}+impl Bot {/// The [`Bot`] view of a first-party bot.///diff --git a/crates/bots/src/domain/ports.rs b/crates/bots/src/domain/ports.rsindex 72229fc61d..20d20e21a3 100644--- a/crates/bots/src/domain/ports.rs+++ b/crates/bots/src/domain/ports.rs@@ -1,15 +1,15 @@//! Bot ports.use super::models::{- Agent, AuthenticatedBot, Bot, BotChannel, BotChannelListCaller, BotId, BotOwner, BotToken,- BotTokenCandidate, CreateAgentRequest, CreateBotRequest, CreateBotTokenRequest,+ Agent, AuthenticatedBot, Bot, BotChannel, BotChannelListCaller, BotId, BotOwner, BotProfile,+ BotToken, BotTokenCandidate, CreateAgentRequest, CreateBotRequest, CreateBotTokenRequest,CreateBotTokenResponse, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse,HarnessId, HarnessOwner, PatchBotRequest, UpdateAgentRequest,};use bot_token::HashedBotToken;use entity_access::domain::models::{EntityAccessReceipt, MemberParticipantRole};use macro_user_id::user_id::MacroUserIdStr;-use std::future::Future;+use std::{collections::HashMap, future::Future};use uuid::Uuid;/// Bot repository.@@ -75,6 +75,14 @@ pub trait BotRepo: Send + Sync + 'static {fn get_bot(&self, bot_id: BotId)-> impl Future<Output = Result<Option<Bot>, Self::Err>> + Send;+ /// Get presentation profiles for the requested bots.+ ///+ /// Historical profiles remain available after a bot is soft-deleted.+ fn get_bot_profiles(+ &self,+ bot_ids: &[BotId],+ ) -> impl Future<Output = Result<HashMap<BotId, BotProfile>, Self::Err>> + Send;+/// Get an active persisted agent by bot id.fn get_agent(&self,diff --git a/crates/bots/src/outbound/pg_bots_repo.rs b/crates/bots/src/outbound/pg_bots_repo.rsindex b8359ac3ac..faeeaf4ff2 100644--- a/crates/bots/src/outbound/pg_bots_repo.rs+++ b/crates/bots/src/outbound/pg_bots_repo.rs@@ -6,9 +6,10 @@ mod tests;use crate::domain::{models::{Agent, AgentChannelScope, AgentMcpServer, AgentMcpServers, AuthenticatedBot, Bot,- BotChannel, BotChannelType, BotId, BotKind, BotOwner, BotToken, BotTokenCandidate,- CreateAgentRequest, CreateBotRequest, CreateBotTokenRequest, CreateChannelScopedBotRequest,- HarnessId, HarnessOwner, PatchBotRequest, UpdateAgentRequest,+ BotChannel, BotChannelType, BotId, BotKind, BotOwner, BotProfile, BotToken,+ BotTokenCandidate, CreateAgentRequest, CreateBotRequest, CreateBotTokenRequest,+ CreateChannelScopedBotRequest, HarnessId, HarnessOwner, PatchBotRequest,+ UpdateAgentRequest,},ports::BotRepo,};@@ -17,6 +18,7 @@ use bot_token::{HashedBotToken, hash_token};use chrono::{DateTime, Utc};use macro_user_id::user_id::MacroUserIdStr;use sqlx::PgPool;+use std::collections::HashMap;use uuid::Uuid;/// Postgres implementation of [`BotRepo`].@@ -852,6 +854,66 @@ impl BotRepo for PgBotsRepo {row.map(map_bot_row).transpose()}+ async fn get_bot_profiles(+ &self,+ bot_ids: &[BotId],+ ) -> Result<HashMap<BotId, BotProfile>, Self::Err> {+ if bot_ids.is_empty() {+ return Ok(HashMap::new());+ }++ let mut profiles = bot_ids+ .iter()+ .filter_map(|id| {+ bot_id::system_bot(*id).map(|bot| {+ (+ *id,+ BotProfile {+ id: *id,+ name: bot.name.to_owned(),+ avatar_url: None,+ },+ )+ })+ })+ .collect::<HashMap<_, _>>();+ let ids = bot_ids+ .iter()+ .filter(|id| !bot_id::is_system_bot(**id))+ .map(|id| id.as_uuid())+ .collect::<Vec<_>>();+ if ids.is_empty() {+ return Ok(profiles);+ }++ // Include soft-deleted bots so historical sessions retain their bot+ // identity and avatar.+ let rows = sqlx::query!(+ r#"+ SELECT id, name, avatar_url+ FROM bots+ WHERE id = ANY($1)+ "#,+ &ids,+ )+ .fetch_all(&self.pool)+ .await+ .context("failed to get bot profiles")?;++ profiles.extend(rows.into_iter().map(|row| {+ let id = BotId::new_from_uuid(row.id);+ (+ id,+ BotProfile {+ id,+ name: row.name,+ avatar_url: row.avatar_url,+ },+ )+ }));+ Ok(profiles)+ }+async fn get_agent(&self, bot_id: BotId) -> Result<Option<Agent>, Self::Err> {let row = sqlx::query_as!(AgentRow,diff --git a/crates/bots/src/outbound/pg_bots_repo/tests.rs b/crates/bots/src/outbound/pg_bots_repo/tests.rsindex 265edf9468..4cd4e75924 100644--- a/crates/bots/src/outbound/pg_bots_repo/tests.rs+++ b/crates/bots/src/outbound/pg_bots_repo/tests.rs@@ -409,6 +409,44 @@ async fn create_user_owned_bot_records_user_owner(pool: PgPool) -> anyhow::ResulOk(())}+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]+async fn bot_profiles_batch_persisted_system_deleted_and_missing_bots(+ pool: PgPool,+) -> anyhow::Result<()> {+ let service = service(&pool);+ let mut request = create_req("profile-batch");+ request.avatar_url = Some("https://static.example/profile-batch.png".to_string());+ let bot = service.create_bot(user_id(USER_OWNER), request).await?;+ let missing = BotId::new_from_uuid(Uuid::new_v4());+ let repo = PgBotsRepo::new(pool);++ let profiles = repo+ .get_bot_profiles(&[bot.id, bot_id::MACRO_NEW_BOT_ID, missing])+ .await?;+ let profile = profiles.get(&bot.id).expect("persisted bot profile");+ assert_eq!(profile.id, bot.id);+ assert_eq!(profile.name, bot.name);+ assert_eq!(profile.avatar_url, bot.avatar_url);+ assert_eq!(+ profiles+ .get(&bot_id::MACRO_NEW_BOT_ID)+ .expect("system bot profile")+ .name,+ bot_id::MACRO_NEW_NAME+ );+ assert!(!profiles.contains_key(&missing));++ service.delete_bot(user_id(USER_OWNER), bot.id).await?;+ assert!(repo.get_bot(bot.id).await?.is_none());+ assert!(+ repo.get_bot_profiles(&[bot.id])+ .await?+ .contains_key(&bot.id)+ );++ Ok(())+}+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]async fn created_agent_round_trips_every_agent_field(pool: PgPool) -> anyhow::Result<()> {let service = service(&pool);diff --git a/crates/client/cache-core/src/meta.rs b/crates/client/cache-core/src/meta.rsindex c6ba6d8b9a..50df02ddd0 100644--- a/crates/client/cache-core/src/meta.rs+++ b/crates/client/cache-core/src/meta.rs@@ -128,7 +128,8 @@ mod tests {assert!(entity.possible_types.contains(&"GraphqlSoupForeignEntity"));assert!(entity.possible_types.contains(&"GraphqlSoupCalendarEvent"));assert!(entity.possible_types.contains(&"GraphqlSoupReminder"));- assert_eq!(entity.possible_types.len(), 11);+ assert!(entity.possible_types.contains(&"GraphqlSoupAgentSession"));+ assert_eq!(entity.possible_types.len(), 12);assert!(type_matches("GraphqlSoupDocument", "GraphqlSoupEntity"));assert!(!type_matches("GraphqlSoupItem", "GraphqlSoupEntity"));}diff --git a/crates/complete_graph/Cargo.toml b/crates/complete_graph/Cargo.tomlindex 523e6bd265..ca4f53006c 100644--- a/crates/complete_graph/Cargo.toml+++ b/crates/complete_graph/Cargo.toml@@ -8,6 +8,7 @@ version = "0.1.0"anyhow = { workspace = true }async-graphql = { workspace = true, features = ["dataloader"] }axum = { workspace = true }+bots = { path = "../bots", default-features = false, features = ["ports"] }email = { path = "../email", default-features = false, features = ["axum","inbound",@@ -40,6 +41,7 @@ soup = { path = "../soup", default-features = false, features = ["ports"] }soup_realtime = { path = "../soup_realtime", default-features = false, features = ["ports",] }+tokio = { workspace = true }uuid = { workspace = true }workspace-hack = { version = "0.1", path = "../workspace-hack" }@@ -53,6 +55,5 @@ models_properties = { path = "../models_properties" }models_soup = { path = "../models_soup" }rootcause = { workspace = true }serde = { workspace = true }-tokio = { workspace = true }tracing = { workspace = true }uuid = { workspace = true }diff --git a/crates/complete_graph/src/edges.rs b/crates/complete_graph/src/edges.rsindex c4daeac999..237c286a2f 100644--- a/crates/complete_graph/src/edges.rs+++ b/crates/complete_graph/src/edges.rs@@ -1,6 +1,10 @@-use std::marker::PhantomData;+use std::{collections::HashMap, future::Future, marker::PhantomData, pin::Pin, sync::Arc};-use async_graphql::{Context, ID, Object};+use async_graphql::{Context, ID, Object, SimpleObject, dataloader::DataLoader};+use bots::domain::{+ models::{BotId, BotProfile},+ ports::BotRepo,+};use graphql_activity::{ActivityEdgeKey, GraphqlActivityEvent, SoupActivityEdgeReader, load_entity_activity,parse_activity_edge_limit,@@ -61,6 +65,7 @@ wheretype Notification = GraphqlNotification;type ActivityEvent = GraphqlActivityEvent;type EmailThreadEdges = SoupEmailThreadEdges<ER>;+ type AgentSessionEdges = SoupAgentSessionEdges;fn from_entity(entity: model_entity::Entity<'static>) -> Self {Self {@@ -87,6 +92,12 @@ where}}+ fn agent_session_edges(bot_id: Uuid) -> Self::AgentSessionEdges {+ SoupAgentSessionEdges {+ bot_id: BotId::new_from_uuid(bot_id),+ }+ }+async fn resolve_properties(&self,ctx: &Context<'_>,@@ -129,6 +140,99 @@ where}}+/// Bot fields presented through an agent-session edge.+#[derive(Clone, SimpleObject)]+pub struct GraphqlSessionBot {+ /// Stable global bot identity.+ id: ID,+ /// Bot display name.+ name: String,+ /// Optional bot avatar URL.+ avatar_url: Option<String>,+}++impl From<BotProfile> for GraphqlSessionBot {+ fn from(profile: BotProfile) -> Self {+ Self {+ id: ID(profile.id.to_string()),+ name: profile.name,+ avatar_url: profile.avatar_url,+ }+ }+}++/// Owned future returned by the erased bot-profile batch reader.+type BotProfileBatchFuture = Pin<+ Box<+ dyn Future<Output = Result<HashMap<BotId, BotProfile>, Arc<anyhow::Error>>>+ + Send+ + 'static,+ >,+>;++/// Type-erased batch reader kept in the concrete GraphQL DataLoader.+type BotProfileBatchReader = dyn Fn(Vec<BotId>) -> BotProfileBatchFuture + Send + Sync + 'static;++/// DataLoader implementation for bot profiles referenced by agent sessions.+pub struct AgentSessionBotLoader {+ /// Erased bots-domain repository call.+ load_batch: Arc<BotProfileBatchReader>,+}++impl async_graphql::dataloader::Loader<BotId> for AgentSessionBotLoader {+ type Value = BotProfile;+ type Error = Arc<anyhow::Error>;++ async fn load(&self, keys: &[BotId]) -> Result<HashMap<BotId, Self::Value>, Self::Error> {+ (self.load_batch)(keys.to_vec()).await+ }+}++/// Concrete request-scoped DataLoader for agent-session bot edges.+pub type AgentSessionBotDataLoader = DataLoader<AgentSessionBotLoader>;++/// Build a request-scoped DataLoader backed by the bots domain repository.+pub fn agent_session_bot_loader<R>(repo: R) -> AgentSessionBotDataLoader+where+ R: BotRepo + Clone,+{+ let load_batch = move |bot_ids: Vec<BotId>| {+ let repo = repo.clone();+ Box::pin(async move {+ repo.get_bot_profiles(&bot_ids)+ .await+ .map_err(|error| Arc::new(error.into()))+ }) as BotProfileBatchFuture+ };+ DataLoader::new(+ AgentSessionBotLoader {+ load_batch: Arc::new(load_batch),+ },+ tokio::spawn,+ )+}++/// Agent-session-specific fields composed from the bots domain.+#[derive(Clone)]+pub struct SoupAgentSessionEdges {+ /// Bot referenced by the session.+ bot_id: BotId,+}++/// Bot fields attached only to a Soup agent session.+#[Object]+impl SoupAgentSessionEdges {+ /// The bot running this session, when its profile still exists.+ async fn bot(&self, ctx: &Context<'_>) -> async_graphql::Result<Option<GraphqlSessionBot>> {+ let loader = ctx.data::<AgentSessionBotDataLoader>()?;+ let profile = loader+ .load_one(self.bot_id)+ .await+ .map_err(|error| async_graphql::Error::new(error.to_string()))?;+ Ok(profile.map(Into::into))+ }+}+/// Cross-domain fields attached to a property-bearing Soup entity.#[Object(name = "SoupEdges")]impl<NR, PR, ER, FR, AR, AcR> SoupEdges<NR, PR, ER, FR, AR, AcR>diff --git a/crates/complete_graph/src/lib.rs b/crates/complete_graph/src/lib.rsindex 6d3af693c3..d533c1b97a 100644--- a/crates/complete_graph/src/lib.rs+++ b/crates/complete_graph/src/lib.rs@@ -12,7 +12,10 @@ mod schema;#[cfg(test)]mod sdl_test;-pub use edges::{SoupEdges, SoupEmailThreadEdges};+pub use edges::{+ AgentSessionBotDataLoader, AgentSessionBotLoader, GraphqlSessionBot, SoupAgentSessionEdges,+ SoupEdges, SoupEmailThreadEdges, agent_session_bot_loader,+};pub use graphql_activity::{ActivityEdgeKey, ActivityEdgeLoad, ActivityFeedInput, ActivityFeedReader,ActivityOverviewInput, ActivityPortReader, ActivityReader, EntityActivityLoader,diff --git a/crates/complete_graph/src/sdl_test.rs b/crates/complete_graph/src/sdl_test.rsindex 04bcc97edf..7d6e6548c3 100644--- a/crates/complete_graph/src/sdl_test.rs+++ b/crates/complete_graph/src/sdl_test.rs@@ -57,6 +57,10 @@ fn soup_response_schema_exposes_frontend_fields() {"type GraphqlSoupEmailDraftAttachment {","type GraphqlSoupEmailForwardedAttachment {","type GraphqlSoupCall implements GraphqlSoupEntity {",+ "type GraphqlSoupAgentSession implements GraphqlSoupEntity {",+ "bot: GraphqlSessionBot",+ "type GraphqlSessionBot {",+ "avatarUrl: String","channelName: String","customName: String","status: String!",@@ -265,6 +269,7 @@ fn soup_interface_exposes_the_complete_shared_entity_contract() {"GraphqlSoupCrmCompany","GraphqlSoupForeignEntity","GraphqlSoupReminder",+ "GraphqlSoupAgentSession",] {let ExtendedType::Object(object) = schema.types.get(name).expect("Soup object exists")else {diff --git a/crates/frecency/src/outbound/postgres/dynamic_tests.rs b/crates/frecency/src/outbound/postgres/dynamic_tests.rsindex 38b50f6144..aa0ffe28bd 100644--- a/crates/frecency/src/outbound/postgres/dynamic_tests.rs+++ b/crates/frecency/src/outbound/postgres/dynamic_tests.rs@@ -966,6 +966,7 @@ async fn test_dynamic_filter_document_date_created_at_gt(pool: PgPool) {crm_company_filter: None,foreign_entity_filter: None,reminder_filter: None,+ agent_session_filter: None,properties_filter: None,};@@ -1062,6 +1063,7 @@ async fn test_dynamic_filter_document_date_created_at_lt(pool: PgPool) {crm_company_filter: None,foreign_entity_filter: None,reminder_filter: None,+ agent_session_filter: None,properties_filter: None,};@@ -1154,6 +1156,7 @@ async fn test_dynamic_filter_document_date_updated_at_gt(pool: PgPool) {crm_company_filter: None,foreign_entity_filter: None,reminder_filter: None,+ agent_session_filter: None,properties_filter: None,};@@ -1251,6 +1254,7 @@ async fn test_dynamic_filter_document_date_updated_at_lt(pool: PgPool) {crm_company_filter: None,foreign_entity_filter: None,reminder_filter: None,+ agent_session_filter: None,properties_filter: None,};diff --git a/crates/graphql_common/src/entity_type.rs b/crates/graphql_common/src/entity_type.rsindex 3a60a556bf..411801cbeb 100644--- a/crates/graphql_common/src/entity_type.rs+++ b/crates/graphql_common/src/entity_type.rs@@ -26,6 +26,8 @@ pub enum GraphqlSoupEntityType {CalendarEvent,/// Reminder entity.Reminder,+ /// AI coding agent session entity.+ AgentSession,}/// Canonical entity types accepted by cross-entity APIs.@@ -90,6 +92,7 @@ impl GraphqlSoupEntityType {EntityType::ForeignEntity => Self::ForeignEntity,EntityType::CalendarEvent => Self::CalendarEvent,EntityType::Reminder => Self::Reminder,+ EntityType::AgentSession => Self::AgentSession,_ => return None,})}@@ -108,6 +111,7 @@ impl GraphqlSoupEntityType {Self::ForeignEntity => EntityType::ForeignEntity,Self::CalendarEvent => EntityType::CalendarEvent,Self::Reminder => EntityType::Reminder,+ Self::AgentSession => EntityType::AgentSession,}}}diff --git a/crates/graphql_entity_mutation/src/mutations/test.rs b/crates/graphql_entity_mutation/src/mutations/test.rsindex 96dd1f4a2e..c6932c10e0 100644--- a/crates/graphql_entity_mutation/src/mutations/test.rs+++ b/crates/graphql_entity_mutation/src/mutations/test.rs@@ -26,11 +26,19 @@ struct TestEmailThreadEdges {available: bool,}+/// Minimal agent-session-specific edge object used by the isolated schema.+#[derive(Clone, SimpleObject)]+struct TestAgentSessionEdges {+ /// Keeps the GraphQL object non-empty.+ available: bool,+}+impl SoupEntityEdges for TestSoupEdges {type Property = String;type Notification = String;type ActivityEvent = String;type EmailThreadEdges = TestEmailThreadEdges;+ type AgentSessionEdges = TestAgentSessionEdges;fn from_entity(_entity: Entity<'static>) -> Self {Self { available: true }@@ -40,6 +48,10 @@ impl SoupEntityEdges for TestSoupEdges {TestEmailThreadEdges { available: true }}+ fn agent_session_edges(_bot_id: uuid::Uuid) -> Self::AgentSessionEdges {+ TestAgentSessionEdges { available: true }+ }+async fn resolve_properties(&self,_ctx: &Context<'_>,diff --git a/crates/graphql_favorite/src/mutations/test.rs b/crates/graphql_favorite/src/mutations/test.rsindex 5ffc55e6e6..97e5603ff3 100644--- a/crates/graphql_favorite/src/mutations/test.rs+++ b/crates/graphql_favorite/src/mutations/test.rs@@ -31,11 +31,18 @@ struct TestEmailEdges {available: bool,}+/// Minimal agent-session edge object needed by the Soup edge trait.+#[derive(Clone, SimpleObject)]+struct TestAgentSessionEdges {+ available: bool,+}+impl SoupEntityEdges for TestSoupEdges {type Property = String;type Notification = String;type ActivityEvent = String;type EmailThreadEdges = TestEmailEdges;+ type AgentSessionEdges = TestAgentSessionEdges;fn from_entity(_entity: Entity<'static>) -> Self {Self { available: true }@@ -45,6 +52,10 @@ impl SoupEntityEdges for TestSoupEdges {TestEmailEdges { available: true }}+ fn agent_session_edges(_bot_id: Uuid) -> Self::AgentSessionEdges {+ TestAgentSessionEdges { available: true }+ }+async fn resolve_properties(&self,_ctx: &Context<'_>,diff --git a/crates/graphql_soup/src/loaders.rs b/crates/graphql_soup/src/loaders.rsindex be69f1f3c1..4f75449ef9 100644--- a/crates/graphql_soup/src/loaders.rs+++ b/crates/graphql_soup/src/loaders.rs@@ -20,6 +20,7 @@ use item_filters::{SharedEmailFilter,ast::{EmailFilterAst, EntityFilterAst,+ agent_session::AgentSessionLiteral,calendar_event::CalendarEventLiteral,call::CallLiteral,channel::{ChannelLiteral, ChannelThreadLiteral},@@ -343,6 +344,7 @@ fn entity_filter_ast(entities: &[Entity<'static>]) -> Result<EntityFilterAst, Solet mut foreign_entities = Vec::new();let mut calendar_events = Vec::new();let mut reminders = Vec::new();+ let mut agent_sessions = Vec::new();for entity in entities {let id = Uuid::parse_str(entity.entity_id.as_ref()).map_err(|error| {@@ -367,12 +369,12 @@ fn entity_filter_ast(entities: &[Entity<'static>]) -> Result<EntityFilterAst, SoEntityType::ForeignEntity => foreign_entities.push(ForeignEntityLiteral::Id(id)),EntityType::CalendarEvent => calendar_events.push(CalendarEventLiteral::Id(id)),EntityType::Reminder => reminders.push(ReminderLiteral::Id(id)),+ EntityType::AgentSession => agent_sessions.push(AgentSessionLiteral::Id(id)),EntityType::User| EntityType::Team| EntityType::StaticFile| EntityType::CrmContact- | EntityType::Skill- | EntityType::AgentSession => {+ | EntityType::Skill => {return Err(rootcause::report!("entity type {} is not represented in Soup",entity.entity_type@@ -409,6 +411,7 @@ fn entity_filter_ast(entities: &[Entity<'static>]) -> Result<EntityFilterAst, SoForeignEntityLiteral::Id(nil),)),reminder_filter: Some(literal_tree(reminders, ReminderLiteral::Id(nil))),+ agent_session_filter: Some(literal_tree(agent_sessions, AgentSessionLiteral::Id(nil))),properties_filter: None,})}diff --git a/crates/graphql_soup/src/objects.rs b/crates/graphql_soup/src/objects.rsindex 6a45c289ce..9454c2f1b0 100644--- a/crates/graphql_soup/src/objects.rs+++ b/crates/graphql_soup/src/objects.rs@@ -11,6 +11,7 @@ use macro_user_id::user_id::MacroUserIdStr;use model_entity::Entity;use models_pagination::PaginatedOpaqueCursor;use models_soup::{+ agent_session::SoupAgentSession,calendar_event::SoupCalendarEvent,call_record::{SoupCallRecord, SoupCallRecordParticipant},chat::SoupChat,@@ -89,6 +90,12 @@ pub trait SoupEntityEdges: ObjectType + Clone + Send + Sync + 'static {/// Construct the email-thread-specific edge object.fn email_thread_edges(email_thread_id: Uuid) -> Self::EmailThreadEdges;+ /// Additional fields attached only to agent-session entities.+ type AgentSessionEdges: ObjectType + Clone + Send + Sync + 'static;++ /// Construct the agent-session-specific edge object.+ fn agent_session_edges(bot_id: Uuid) -> Self::AgentSessionEdges;+/// Resolve properties assigned to this entity.fn resolve_properties(&self,@@ -259,6 +266,7 @@ impl<E: SoupEntityEdges> GraphqlSoupEntity<E> {// Calendar events carry no frecency slot; scores never target them.Self::CalendarEvent(_) => {}Self::Reminder(entity) => entity.2 = score,+ Self::AgentSession(entity) => entity.2 = score,}self}@@ -276,7 +284,8 @@ impl<E: SoupEntityEdges> GraphqlSoupEntity<E> {| Self::CalendarEvent(_)| Self::CrmCompany(_)| Self::ForeignEntity(_)- | Self::Reminder(_) => {}+ | Self::Reminder(_)+ | Self::AgentSession(_) => {}}self}@@ -393,6 +402,8 @@ pub enum GraphqlSoupEntity<E: SoupEntityEdges> {ForeignEntity(GraphqlSoupForeignEntity<E>),/// Reminder entity.Reminder(GraphqlSoupReminder<E>),+ /// Agent session entity.+ AgentSession(GraphqlSoupAgentSession<E>),}impl<E> GraphqlSoupEntity<E>@@ -417,6 +428,7 @@ whereGraphqlSoupEntityType::ForeignEntity => GraphqlSoupForeignEntity::<E>::type_name(),GraphqlSoupEntityType::CalendarEvent => GraphqlSoupCalendarEvent::<E>::type_name(),GraphqlSoupEntityType::Reminder => GraphqlSoupReminder::<E>::type_name(),+ GraphqlSoupEntityType::AgentSession => GraphqlSoupAgentSession::<E>::type_name(),}.into_owned(),)@@ -522,6 +534,12 @@ where);Self::Reminder(GraphqlSoupReminder(item, edges, None))}+ SoupItem::AgentSession(item) => {+ let edges = E::from_entity(+ model_entity::EntityType::AgentSession.with_entity_string(item.id.to_string()),+ );+ Self::AgentSession(GraphqlSoupAgentSession(item, edges, None))+ }}}}@@ -886,6 +904,110 @@ where}}+/// GraphQL agent session entity.+pub struct GraphqlSoupAgentSession<E: SoupEntityEdges>(SoupAgentSession<()>, E, Option<f64>);++/// GraphQL representation of the soup agent session.+#[Object(name = "GraphqlSoupAgentSession")]+impl<E> GraphqlSoupAgentSession<E>+where+ E: SoupEntityEdges,+{+ /// The unique identifier.+ async fn id(&self) -> ID {+ ID(self.0.id.to_string())+ }++ /// Canonical entity kind.+ async fn entity_type(&self) -> GraphqlSoupEntityType {+ GraphqlSoupEntityType::AgentSession+ }++ /// Server-only projection facts are unavailable for agent sessions.+ async fn cache_projection(&self) -> Option<SoupCacheProjection> {+ None+ }++ /// User-visible display name.+ async fn display_name(&self) -> Option<String> {+ Some(self.0.name.clone())+ }++ /// Common agent session metadata.+ ///+ /// `parent` is absent: a session is reachable through the channel thread+ /// it was opened from, but it is not contained by it the way a chat is+ /// contained by its project.+ async fn metadata(&self) -> GraphqlEntityMetadata {+ GraphqlEntityMetadata {+ owner_id: Some(self.0.owner_id.as_ref().to_owned()),+ parent: None,+ created_at: Some(self.0.created_at.to_rfc3339()),+ updated_at: Some(self.0.updated_at.to_rfc3339()),+ viewed_at: self.0.viewed_at.map(|ts| ts.to_rfc3339()),+ deleted_at: None,+ }+ }++ /// The name.+ async fn name(&self) -> &str {+ &self.0.name+ }++ /// The identifier of the owner.+ async fn owner_id(&self) -> String {+ self.0.owner_id.as_ref().to_owned()+ }++ /// The bot running this session.+ async fn bot_id(&self) -> ID {+ ID(self.0.bot_id.to_string())+ }++ #[graphql(flatten)]+ /// Fields hydrated through the bot domain.+ async fn agent_session_edges(&self) -> E::AgentSessionEdges {+ E::agent_session_edges(self.0.bot_id)+ }++ /// The channel thread the session was opened from, when any.+ async fn thread_id(&self) -> Option<ID> {+ self.0.thread_id.map(|id| ID(id.to_string()))+ }++ /// The session's last known status: `no_messages`, `disconnected`, or the+ /// wire name of the most recent system event (for example `session/end`).+ async fn status(&self) -> &str {+ &self.0.status+ }++ /// The created timestamp in RFC 3339 format.+ async fn created_at(&self) -> String {+ self.0.created_at.to_rfc3339()+ }++ /// The updated timestamp in RFC 3339 format.+ async fn updated_at(&self) -> String {+ self.0.updated_at.to_rfc3339()+ }++ /// The viewed timestamp in RFC 3339 format.+ async fn viewed_at(&self) -> Option<String> {+ self.0.viewed_at.map(|ts| ts.to_rfc3339())+ }++ #[graphql(flatten)]+ /// The edges.+ async fn edges(&self) -> E {+ self.1.clone()+ }++ /// The viewer's frecency score for this entity, when loaded.+ async fn frecency_score(&self) -> Option<f64> {+ self.2+ }+}+/// GraphQL project entity.pub struct GraphqlSoupProject<E: SoupEntityEdges>(SoupProject<()>, E, Option<f64>);@@ -2223,6 +2345,7 @@ impl_common_interface_edges!(GraphqlSoupCrmCompany,GraphqlSoupForeignEntity,GraphqlSoupReminder,+ GraphqlSoupAgentSession,);/// Realtime Soup patch represented as exactly one update or cache deletion.diff --git a/crates/graphql_soup_filter_input/src/lib.rs b/crates/graphql_soup_filter_input/src/lib.rsindex 46ae5d4967..64939d62e9 100644--- a/crates/graphql_soup_filter_input/src/lib.rs+++ b/crates/graphql_soup_filter_input/src/lib.rs@@ -20,6 +20,7 @@ use item_filters::{CallStatus, SharedEmailFilter,ast::{CrmScope, EmailFilterAst, EntityFilterAst,+ agent_session::AgentSessionLiteral,calendar_event::CalendarEventLiteral,call::CallLiteral,channel::{ChannelLiteral, ChannelThreadLiteral, ChannelTypeFilter},@@ -346,6 +347,8 @@ pub struct GraphqlEntityFilterAst {foreign_entity_filter: Option<GraphqlForeignEntityExpr>,/// The reminder filter to apply.reminder_filter: Option<GraphqlReminderExpr>,+ /// The agent session filter to apply.+ agent_session_filter: Option<GraphqlAgentSessionExpr>,/// The properties filter to apply.properties_filter: Option<GraphqlFilterPropertiesExpr>,}@@ -378,6 +381,7 @@ impl GraphqlEntityFilterAst {crm_company_filter: optional_tree(self.crm_company_filter)?,foreign_entity_filter: optional_tree(self.foreign_entity_filter)?,reminder_filter: optional_tree(self.reminder_filter)?,+ agent_session_filter: optional_tree(self.agent_session_filter)?,properties_filter: optional_tree(self.properties_filter)?,})}@@ -502,6 +506,13 @@ filter_expr_input!(ReminderLiteral,"ReminderFilterExpr");+filter_expr_input!(+ GraphqlAgentSessionExpr,+ GraphqlAgentSessionBinaryExpr,+ GraphqlAgentSessionLiteral,+ AgentSessionLiteral,+ "AgentSessionFilterExpr"+);/// GraphQL input representing the email filter ast.#[cfg_attr(feature = "server", derive(async_graphql::InputObject))]#[derive(Serialize, Deserialize)]@@ -1100,6 +1111,41 @@ impl IntoFilterExpr<ReminderLiteral> for GraphqlReminderLiteral {}}+/// GraphQL input representing the agent session literal.+#[cfg_attr(feature = "server", derive(async_graphql::OneofObject))]+#[derive(Serialize, Deserialize)]+#[serde(rename_all = "camelCase")]+enum GraphqlAgentSessionLiteral {+ /// Opt this query into agent sessions at all. Agent sessions are off by+ /// default, so without this (or an `id`/`owner`) Soup omits them entirely.+ /// Must be `true`; there is no literal for excluding agent sessions, that+ /// is the default.+ Include(bool),+ /// The id option.+ Id(ID),+ /// The owner option.+ Owner(String),+}++impl IntoFilterExpr<AgentSessionLiteral> for GraphqlAgentSessionLiteral {+ /// Convert this value into the expr representation.+ fn into_expr(self) -> InputResult<Expr<AgentSessionLiteral>> {+ let literal = match self {+ // `include: false` is the default, not a literal — accepting it+ // would opt the query in, the opposite of what was asked.+ Self::Include(false) => {+ return Err(InputError::new(+ "agent session `include` must be true; omit the filter to exclude agent sessions",+ ));+ }+ Self::Include(true) => AgentSessionLiteral::Include,+ Self::Id(id) => AgentSessionLiteral::Id(parse_id(id, "id")?),+ Self::Owner(owner) => AgentSessionLiteral::Owner(parse_macro_user_id(owner, "owner")?),+ };+ Ok(Expr::val(literal))+ }+}+/// GraphQL input representing the crm company literal.#[cfg_attr(feature = "server", derive(async_graphql::OneofObject))]#[derive(Serialize, Deserialize)]diff --git a/crates/item_filter_index/src/lib.rs b/crates/item_filter_index/src/lib.rsindex b14eaa2985..3404e8f32e 100644--- a/crates/item_filter_index/src/lib.rs+++ b/crates/item_filter_index/src/lib.rs@@ -299,6 +299,10 @@ fn check_soup_flat(if ast.reminder_filter.is_some() {return Eligibility::Unsupported(UnsupportedReason::Partition("reminder"));}+ // Agent sessions are opt-in the same way.+ if ast.agent_session_filter.is_some() {+ return Eligibility::Unsupported(UnsupportedReason::Partition("agent_session"));+ }if !supported_expr(ast.document_filter.as_deref(), supported_document_literal)|| (supports_status_propertiesdiff --git a/crates/item_filter_index/src/test.rs b/crates/item_filter_index/src/test.rsindex b352077984..cbf9481eb6 100644--- a/crates/item_filter_index/src/test.rs+++ b/crates/item_filter_index/src/test.rs@@ -323,6 +323,15 @@ fn every_deferred_partition_must_be_proven_empty() {Eligibility::Unsupported(UnsupportedReason::Partition("reminder")));+ let mut ast = excluded_deferred_partitions();+ ast.agent_session_filter = Some(Arc::new(Expr::val(+ item_filters::ast::agent_session::AgentSessionLiteral::Include,+ )));+ assert_eq!(+ check_soup_flat_v1(&ast, request()),+ Eligibility::Unsupported(UnsupportedReason::Partition("agent_session"))+ );+let mut ast = excluded_deferred_partitions();ast.properties_filter = Some(Arc::new(Expr::val(PropertiesLiteral {property_definition_id: Uuid::nil(),diff --git a/crates/item_filters/src/ast.rs b/crates/item_filters/src/ast.rsindex 9a0203ecee..8d94fd9d6c 100644--- a/crates/item_filters/src/ast.rs+++ b/crates/item_filters/src/ast.rs@@ -2,10 +2,11 @@//! This is used to construct a strictly typed ast for the input filters, allowing consumers to have a logical represenation of the required operationsuse crate::{- CalendarEventFilters, CallFilters, ChannelFilters, ChannelThreadFilters, ChatFilters,- CrmCompanyFilters, DocumentFilters, EmailFilters, EntityFilters, ForeignEntityFilters,- ProjectFilters, PropertyFilter, ReminderFilters,+ AgentSessionFilters, CalendarEventFilters, CallFilters, ChannelFilters, ChannelThreadFilters,+ ChatFilters, CrmCompanyFilters, DocumentFilters, EmailFilters, EntityFilters,+ ForeignEntityFilters, ProjectFilters, PropertyFilter, ReminderFilters,ast::{+ agent_session::AgentSessionLiteral,calendar_event::CalendarEventLiteral,call::CallLiteral,channel::{ChannelLiteral, ChannelThreadLiteral, ChannelTypeFilter},@@ -25,6 +26,8 @@ use serde::{Deserialize, Serialize};use std::{marker::PhantomData, sync::Arc};use thiserror::Error;+/// contains the ast literal value for agent sessions+pub mod agent_session;/// contains the ast literal value for calendar eventspub mod calendar_event;/// contains the ast literal value for calls@@ -226,6 +229,10 @@ pub struct EntityFilterAst {#[serde(default, rename = "remf")]#[cfg_attr(feature = "schema", schema(value_type = serde_json::Value))]pub reminder_filter: LiteralTree<ReminderLiteral>,+ /// the filters that should be applied to agent sessions+ #[serde(default, rename = "asf")]+ #[cfg_attr(feature = "schema", schema(value_type = serde_json::Value))]+ pub agent_session_filter: LiteralTree<AgentSessionLiteral>,/// the filters that should be applied based on entity properties#[serde(default, rename = "propf")]#[cfg_attr(feature = "schema", schema(value_type = serde_json::Value))]@@ -277,6 +284,10 @@ impl EntityFilterAst {.map(Arc::new),reminder_filter: ReminderFilters::expand_ast(entity_filter.reminder_filters)?.map(Arc::new),+ agent_session_filter: AgentSessionFilters::expand_ast(+ entity_filter.agent_session_filters,+ )?+ .map(Arc::new),properties_filter: Vec::<PropertyFilter>::expand_ast(entity_filter.property_filters)?.map(Arc::new),}))@@ -315,6 +326,7 @@ impl EntityFilterAst {crm_company_filter: None,foreign_entity_filter: None,reminder_filter: None,+ agent_session_filter: None,properties_filter: None,}}@@ -349,6 +361,7 @@ impl IsEmpty for EntityFilterAst {crm_company_filter,foreign_entity_filter,reminder_filter,+ agent_session_filter,properties_filter,} = self;calendar_event_filter.is_none()@@ -362,6 +375,7 @@ impl IsEmpty for EntityFilterAst {&& crm_company_filter.is_none()&& foreign_entity_filter.is_none()&& reminder_filter.is_none()+ && agent_session_filter.is_none()&& properties_filter.is_none()}}diff --git a/crates/item_filters/src/ast/agent_session.rs b/crates/item_filters/src/ast/agent_session.rsnew file mode 100644index 0000000000..ffb5ad5583--- /dev/null+++ b/crates/item_filters/src/ast/agent_session.rs@@ -0,0 +1,53 @@+use filter_ast::{ExpandFrame, Expr, FoldTree, TryExpandNode};+use macro_user_id::{cowlike::CowLike, user_id::MacroUserIdStr};+use serde::{Deserialize, Serialize};+use uuid::Uuid;++use crate::{AgentSessionFilters, ast::ExpandErr};++/// The possible literal values in an agent session filter AST.+#[derive(Debug, Serialize, Deserialize, Clone)]+pub enum AgentSessionLiteral {+ /// Opt this query into agent sessions at all.+ ///+ /// Like reminders, agent sessions are **off by default** — a query that+ /// says nothing about them gets none, so adding them to Soup did not+ /// change what pre-existing Soup views return. Asking for specific ids+ /// or owners also counts as opting in.+ #[serde(rename = "inc")]+ Include,+ /// Filter by agent session id.+ #[serde(rename = "id")]+ Id(Uuid),+ /// Filter by the session's owner.+ #[serde(rename = "o")]+ Owner(MacroUserIdStr<'static>),+}++impl ExpandFrame<AgentSessionLiteral> for AgentSessionFilters {+ type Err = ExpandErr;++ fn expand_ast(+ filter_request: AgentSessionFilters,+ ) -> Result<Option<Expr<AgentSessionLiteral>>, Self::Err> {+ let AgentSessionFilters {+ include,+ ids,+ owners,+ } = filter_request;++ let include = include.then_some(Expr::val(AgentSessionLiteral::Include));++ let ids = ids+ .iter()+ .map(|s| Uuid::parse_str(s))+ .try_expand(|r| r.map(AgentSessionLiteral::Id), Expr::or)?;++ let owners = owners+ .iter()+ .map(|owner| MacroUserIdStr::parse_from_str(owner).map(CowLike::into_owned))+ .try_expand(|r| r.map(AgentSessionLiteral::Owner), Expr::or)?;++ Ok([include, ids, owners].into_iter().fold_with(Expr::and))+ }+}diff --git a/crates/item_filters/src/lib.rs b/crates/item_filters/src/lib.rsindex 54e5daa1e4..6e945d32e0 100644--- a/crates/item_filters/src/lib.rs+++ b/crates/item_filters/src/lib.rs@@ -465,6 +465,35 @@ impl IsEmpty for ReminderFilters {}}+/// Filters for agent sessions.+#[derive(Debug, Serialize, Deserialize, Default, PartialEq, Clone)]+#[cfg_attr(feature = "schema", derive(utoipa::ToSchema, schemars::JsonSchema))]+pub struct AgentSessionFilters {+ /// Opt this query into agent sessions at all. Agent sessions are off by+ /// default — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].+ /// Asking for specific `ids` or `owners` also opts in.+ #[serde(default, skip_serializing_if = "std::ops::Not::not")]+ pub include: bool,+ /// Agent session ids to filter by. Empty to include all accessible sessions.+ #[serde(default, skip_serializing_if = "Vec::is_empty")]+ pub ids: Vec<String>,+ /// Filter by session owner. Examples: ['macro|[email protected]']. Empty to+ /// include every owner.+ #[serde(default, skip_serializing_if = "Vec::is_empty")]+ pub owners: Vec<String>,+}++impl IsEmpty for AgentSessionFilters {+ fn is_empty(&self) -> bool {+ let AgentSessionFilters {+ include,+ ids,+ owners,+ } = self;+ !include && ids.is_empty() && owners.is_empty()+ }+}+/// Filters for foreign entity records.#[derive(Debug, Serialize, Deserialize, Default, PartialEq, Clone)]#[cfg_attr(feature = "schema", derive(utoipa::ToSchema, schemars::JsonSchema))]@@ -763,6 +792,9 @@ pub struct EntityFilters {/// the bundled [ReminderFilters]#[serde(default)]pub reminder_filters: ReminderFilters,+ /// the bundled [AgentSessionFilters]+ #[serde(default)]+ pub agent_session_filters: AgentSessionFilters,/// property-based filters applied across entity types#[serde(default, skip_serializing_if = "Vec::is_empty")]pub property_filters: Vec<PropertyFilter>,@@ -791,6 +823,7 @@ impl IsEmpty for EntityFilters {crm_company_filters,foreign_entity_filters,reminder_filters,+ agent_session_filters,property_filters,tag_option_ids,// Mode is a modifier on tag_option_ids, not a filter by itself.@@ -807,6 +840,7 @@ impl IsEmpty for EntityFilters {&& crm_company_filters.is_empty()&& foreign_entity_filters.is_empty()&& reminder_filters.is_empty()+ && agent_session_filters.is_empty()&& property_filters.iter().all(IsEmpty::is_empty)&& tag_option_ids.is_empty()}diff --git a/crates/models_soup/src/agent_session.rs b/crates/models_soup/src/agent_session.rsnew file mode 100644index 0000000000..48658dba54--- /dev/null+++ b/crates/models_soup/src/agent_session.rs@@ -0,0 +1,51 @@+use chrono::Utc;+use macro_user_id::user_id::MacroUserIdStr;+use serde::{Deserialize, Serialize};+use uuid::Uuid;++/// An agent session as displayed in Soup.+///+/// Mirrors [`crate::chat::SoupChat`]: an agent session is the coding-agent+/// counterpart of a chat, so it carries the same identity, ownership, and+/// recency fields plus the session's last known status.+#[derive(Serialize, Clone, Deserialize, Debug)]+#[serde(rename_all = "camelCase")]+#[cfg_attr(feature = "schema", derive(utoipa::ToSchema))]+pub struct SoupAgentSession<T = ()> {+ /// The agent session uuid+ pub id: Uuid,++ /// The user-facing name of the session+ pub name: String,++ /// Who the session belongs to+ #[cfg_attr(feature = "schema", schema(value_type = String))]+ pub owner_id: MacroUserIdStr<'static>,++ /// The bot running this session+ pub bot_id: Uuid,++ /// The channel thread the session was opened from, when any+ #[serde(skip_serializing_if = "Option::is_none")]+ pub thread_id: Option<Uuid>,++ /// The session's last known status.+ ///+ /// `no_messages` until the first system event arrives, `disconnected` if+ /// the connection dropped without a clean close, otherwise the wire name+ /// of the most recent system event (for example `session/end`).+ pub status: String,++ /// The time the session was created+ pub created_at: chrono::DateTime<Utc>,++ /// The time the session was last modified+ pub updated_at: chrono::DateTime<Utc>,++ /// The time the session was last viewed by the requesting user+ pub viewed_at: Option<chrono::DateTime<Utc>>,++ /// Extra fields passed from above+ #[serde(flatten)]+ pub extra: T,+}diff --git a/crates/models_soup/src/item.rs b/crates/models_soup/src/item.rsindex 94744dd78c..18c3fd7917 100644--- a/crates/models_soup/src/item.rs+++ b/crates/models_soup/src/item.rs@@ -1,3 +1,4 @@+use crate::agent_session::SoupAgentSession;use crate::calendar_event::SoupCalendarEvent;use crate::call_record::SoupCallRecord;use crate::crm_company::SoupCrmCompany;@@ -47,6 +48,8 @@ pub enum SoupItem<T = ()> {ForeignEntity(SoupForeignEntity),/// Reminder item.Reminder(SoupReminder<T>),+ /// Agent session item.+ AgentSession(SoupAgentSession<T>),}impl<T> SoupItem<T> {@@ -86,6 +89,9 @@ impl<T> SoupItem<T> {SoupItem::Reminder(reminder) => {EntityType::Reminder.with_entity_string(reminder.id.to_string())}+ SoupItem::AgentSession(session) => {+ EntityType::AgentSession.with_entity_string(session.id.to_string())+ }}}@@ -108,6 +114,7 @@ impl<T> SoupItem<T> {SoupItem::CrmCompany(company) => company.updated_at,SoupItem::ForeignEntity(foreign_entity) => foreign_entity.updated_at,SoupItem::Reminder(reminder) => reminder.updated_at,+ SoupItem::AgentSession(session) => session.updated_at,}}@@ -194,6 +201,14 @@ impl<T> SoupItem<T> {// for — the same way emails always use their precomputed sort_ts.// No other ordering means anything for a reminder.(SoupItem::Reminder(reminder), _) => reminder.next_run_at,+ (SoupItem::AgentSession(session), SimpleSortMethod::ViewedAt) => {+ session.viewed_at.unwrap_or_default()+ }+ (SoupItem::AgentSession(session), SimpleSortMethod::UpdatedAt) => session.updated_at,+ (SoupItem::AgentSession(session), SimpleSortMethod::CreatedAt) => session.created_at,+ (SoupItem::AgentSession(session), SimpleSortMethod::ViewedUpdated) => {+ session.viewed_at.unwrap_or(session.updated_at)+ }}}@@ -234,6 +249,8 @@ impl<T> SoupItem<T> {)),SoupItem::ForeignEntity(_) => None,SoupItem::Reminder(_) => None,+ // Agent sessions have no properties entity type yet.+ SoupItem::AgentSession(_) => None,}}@@ -462,6 +479,29 @@ impl<T> SoupItem<T> {updated_at,extra: f(extra),}),+ SoupItem::AgentSession(SoupAgentSession {+ id,+ name,+ owner_id,+ bot_id,+ thread_id,+ status,+ created_at,+ updated_at,+ viewed_at,+ extra,+ }) => SoupItem::AgentSession(SoupAgentSession {+ id,+ name,+ owner_id,+ bot_id,+ thread_id,+ status,+ created_at,+ updated_at,+ viewed_at,+ extra: f(extra),+ }),}}}@@ -482,6 +522,7 @@ impl<T> Identify for SoupItem<T> {SoupItem::CrmCompany(company) => company.id,SoupItem::ForeignEntity(foreign_entity) => foreign_entity.id,SoupItem::Reminder(reminder) => reminder.id,+ SoupItem::AgentSession(session) => session.id,}}}diff --git a/crates/models_soup/src/lib.rs b/crates/models_soup/src/lib.rsindex 8144590944..4ed26d75e9 100644--- a/crates/models_soup/src/lib.rs+++ b/crates/models_soup/src/lib.rs@@ -2,6 +2,8 @@#![deny(missing_docs)]+/// Agent session models for Soup responses.+pub mod agent_session;/// Calendar event models for Soup responses.pub mod calendar_event;/// Call record models for Soup responses.diff --git a/crates/skills/src/outbound/soup_skill_lister.rs b/crates/skills/src/outbound/soup_skill_lister.rsindex 44dad576f0..fdf6e2a87d 100644--- a/crates/skills/src/outbound/soup_skill_lister.rs+++ b/crates/skills/src/outbound/soup_skill_lister.rs@@ -69,6 +69,8 @@ fn skill_only_filter() -> EntityFilterAst {calendar_event_filter: Some(Arc::new(Expr::val(CalendarEventLiteral::Id(Uuid::nil())))),// Reminders are opt-in: leaving the filter empty excludes them.reminder_filter: None,+ // Agent sessions are opt-in as well.+ agent_session_filter: None,properties_filter: None,}}diff --git a/crates/soup/src/inbound/axum_router.rs b/crates/soup/src/inbound/axum_router.rsindex 44f4f2a6bf..0df398f7d0 100644--- a/crates/soup/src/inbound/axum_router.rs+++ b/crates/soup/src/inbound/axum_router.rs@@ -35,6 +35,7 @@ use item_filters::{EntityFilters,ast::{EntityFilterAst, ExpandErr, LiteralTree,+ agent_session::AgentSessionLiteral,calendar_event::CalendarEventLiteral,call::CallLiteral,channel::{ChannelLiteral, ChannelThreadLiteral},@@ -1236,6 +1237,12 @@ pub struct ApiEntityFilterAst {#[serde(default, rename = "remf")]#[schema(value_type = serde_json::Value)]pub reminder_filter: LiteralTree<ReminderLiteral>,+ /// Filters applied to agent sessions (wire key `asf`). Like reminders,+ /// empty/omitted returns **no** agent sessions: they are opt-in, so the+ /// caller must send `inc`, an id, or an owner to get any.+ #[serde(default, rename = "asf")]+ #[schema(value_type = serde_json::Value)]+ pub agent_session_filter: LiteralTree<AgentSessionLiteral>,/// the filters that should be applied based on entity properties#[serde(default, rename = "propf")]#[schema(value_type = serde_json::Value)]@@ -1337,6 +1344,7 @@ impl ApiEntityFilterAst {call_filter,crm_company_filter,reminder_filter,+ agent_session_filter,properties_filter,email_crm_domains,email_crm_addresses,@@ -1405,6 +1413,7 @@ impl ApiEntityFilterAst {crm_company_filter,foreign_entity_filter,reminder_filter,+ agent_session_filter,properties_filter,})}diff --git a/crates/soup/src/inbound/toolset/list_entities.rs b/crates/soup/src/inbound/toolset/list_entities.rsindex 1e59aa2603..ce0fa07be2 100644--- a/crates/soup/src/inbound/toolset/list_entities.rs+++ b/crates/soup/src/inbound/toolset/list_entities.rs@@ -311,6 +311,9 @@ impl EntityItem {SoupItem::Reminder(_) => {unreachable!("ListEntities tool does not surface Reminder rows")}+ SoupItem::AgentSession(_) => {+ unreachable!("ListEntities tool does not surface AgentSession rows")+ }SoupItem::ForeignEntity(foreign_entity) => EntityItem::ForeignEntity {id: foreign_entity.id,foreign_entity_id: foreign_entity.foreign_entity_id,@@ -360,7 +363,8 @@ fn any_item_has_tags(items: &[EnrichedSoupItem]) -> bool {| SoupItem::ChannelThread(_)| SoupItem::Call(_)| SoupItem::ForeignEntity(_)- | SoupItem::Reminder(_) => return false,+ | SoupItem::Reminder(_)+ | SoupItem::AgentSession(_) => return false,};properties.iter()@@ -563,6 +567,8 @@ impl ListEntities {// Reminders are opt-in in Soup, so leaving this unset is already// what keeps them out of the tool surface — no force-filter needed.reminder_filter: None,+ // Agent sessions are opt-in too; unset keeps them off the tool surface.+ agent_session_filter: None,properties_filter,};@@ -637,6 +643,7 @@ impl ListEntities {},// Same as CrmCompany — no ItemType::Reminder to toggle against.reminder_filter: ast.reminder_filter,+ agent_session_filter: ast.agent_session_filter,properties_filter: ast.properties_filter,}}diff --git a/crates/soup/src/outbound/pg_soup_repo.rs b/crates/soup/src/outbound/pg_soup_repo.rsindex 1c96d24119..404b962129 100644--- a/crates/soup/src/outbound/pg_soup_repo.rs+++ b/crates/soup/src/outbound/pg_soup_repo.rs@@ -19,6 +19,7 @@ use models_soup::{SoupProperty, item::SoupItem};use readonly_pool::ReadOnlyPool;use system_properties::SystemPropertyKey;+mod agent_session;mod calendar_event;mod candidate_gates;mod expanded;@@ -123,7 +124,16 @@ impl SoupRepo for PgSoupRepo {}};items.extend(- calendar_event::cursor_soup(&self.pool.0, calendar_req)+ calendar_event::cursor_soup(&self.pool.0, calendar_req.clone())+ .await?+ .into_iter()+ .map(|item| SoupProjectionHydration {+ item,+ document_server_facts: None,+ }),+ );+ items.extend(+ agent_session::cursor_soup(&self.pool.0, calendar_req).await?.into_iter().map(|item| SoupProjectionHydration {@@ -172,7 +182,8 @@ impl SoupRepo for PgSoupRepo {.await?}};- items.extend(calendar_event::cursor_soup(&self.pool.0, calendar_req).await?);+ items.extend(calendar_event::cursor_soup(&self.pool.0, calendar_req.clone()).await?);+ items.extend(agent_session::cursor_soup(&self.pool.0, calendar_req).await?);sort_and_truncate(&mut items, sort, limit);Ok(items)}@@ -201,7 +212,16 @@ impl SoupRepo for PgSoupRepo {).await?;items.extend(- calendar_event::by_ids(&self.pool.0, calendar_req)+ calendar_event::by_ids(&self.pool.0, calendar_req.clone())+ .await?+ .into_iter()+ .map(|item| SoupProjectionHydration {+ item,+ document_server_facts: None,+ }),+ );+ items.extend(+ agent_session::by_ids(&self.pool.0, calendar_req).await?.into_iter().map(|item| SoupProjectionHydration {@@ -220,7 +240,8 @@ impl SoupRepo for PgSoupRepo {let mut items =unexpanded::by_ids::unexpanded_soup_by_ids(&self.pool.0, req.user_id, req.entities).await?;- items.extend(calendar_event::by_ids(&self.pool.0, calendar_req).await?);+ items.extend(calendar_event::by_ids(&self.pool.0, calendar_req.clone()).await?);+ items.extend(agent_session::by_ids(&self.pool.0, calendar_req).await?);Ok(items)}@@ -371,7 +392,8 @@ pub(crate) async fn populate_properties(SoupItem::Channel(_)| SoupItem::ChannelThread(_)| SoupItem::ForeignEntity(_)- | SoupItem::Reminder(_) => None,+ | SoupItem::Reminder(_)+ | SoupItem::AgentSession(_) => None,}.map(|properties| properties.iter().cloned().map(SoupProperty::from).collect()).unwrap_or_default();diff --git a/crates/soup/src/outbound/pg_soup_repo/agent_session.rs b/crates/soup/src/outbound/pg_soup_repo/agent_session.rsnew file mode 100644index 0000000000..55d9de2f72--- /dev/null+++ b/crates/soup/src/outbound/pg_soup_repo/agent_session.rs@@ -0,0 +1,302 @@+//! Agent session leg of the PostgreSQL Soup repository.+//!+//! Agent sessions live in MacroDB and are authorized through `entity_access`+//! like chats, but they are **opt-in**: a query that says nothing about them+//! (no `agent_session_filter` in its AST) gets none. This mirrors reminders,+//! so adding sessions to Soup did not change what pre-existing views return.++use chrono::{DateTime, Utc};+use filter_ast::Expr;+use item_filters::ast::{+ agent_session::AgentSessionLiteral,+ properties::{PropertiesLiteral, properties_filter_matches_propertyless},+};+use macro_user_id::{cowlike::CowLike, user_id::MacroUserIdStr};+use model_entity::EntityType;+use models_pagination::{Query, SimpleSortMethod};+use models_soup::{agent_session::SoupAgentSession, item::SoupItem};+use sqlx::{FromRow, PgPool, Postgres, QueryBuilder};+use uuid::Uuid;++use crate::domain::models::{AdvancedSortParams, SimpleSortQuery, SimpleSortRequest};++#[cfg(test)]+mod test;++#[derive(FromRow)]+struct AgentSessionRow {+ id: Uuid,+ name: String,+ owner_id: String,+ bot_id: Uuid,+ thread_id: Option<Uuid>,+ status: String,+ status_event_name: Option<String>,+ created_at: DateTime<Utc>,+ modified_at: DateTime<Utc>,+ viewed_at: Option<DateTime<Utc>>,+}++struct CursorParts {+ sort: SimpleSortMethod,+ id: Option<Uuid>,+ timestamp: Option<DateTime<Utc>>,+ filter: Option<Expr<AgentSessionLiteral>>,+ property_filter: Option<Expr<PropertiesLiteral>>,+}++/// Whether the filter opts the query into agent sessions at all: an explicit+/// `Include`, or naming specific ids/owners. Fails closed on shapes that only+/// negate (`Not(Include)` is not an opt-in).+fn opted_in(expr: &Expr<AgentSessionLiteral>) -> bool {+ /// Outcome of walking an `AgentSessionLiteral` AST for the opt-in decision.+ #[derive(Default)]+ struct OptIn {+ include: bool,+ named: bool,+ }++ fn walk(expr: &Expr<AgentSessionLiteral>, out: &mut OptIn) {+ match expr {+ Expr::Literal(AgentSessionLiteral::Include) => out.include = true,+ Expr::Literal(AgentSessionLiteral::Id(_) | AgentSessionLiteral::Owner(_)) => {+ out.named = true+ }+ Expr::And(a, b) | Expr::Or(a, b) => {+ walk(a, out);+ walk(b, out);+ }+ Expr::Not(_) => {}+ }+ }+ let mut out = OptIn::default();+ walk(expr, &mut out);+ out.include || out.named+}++pub(super) async fn cursor_soup(+ db: &PgPool,+ req: SimpleSortRequest<'_>,+) -> Result<Vec<SoupItem<()>>, sqlx::Error> {+ let parts = cursor_parts(req.cursor);+ let Some(filter) = parts.filter.as_ref().filter(|filter| opted_in(filter)) else {+ return Ok(Vec::new());+ };+ // Agent sessions carry no properties, so a property constraint that a+ // property-less item can never satisfy removes the leg.+ if parts+ .property_filter+ .as_ref()+ .is_some_and(|filter| !properties_filter_matches_propertyless(filter))+ {+ return Ok(Vec::new());+ }++ let sort = sort_sql(parts.sort);+ let mut query = QueryBuilder::<Postgres>::new(SELECT_SQL);+ // `$1` is the requesting user for every clause in this query: the source+ // id CTE, the history join, and any `Owner` literal that binds it again.+ query.push_bind(req.user_id.as_ref().to_string());+ query.push(ACCESS_SQL);+ query.push(" AND (");+ push_filter(&mut query, filter);+ query.push(")");+ if let (Some(timestamp), Some(id)) = (parts.timestamp, parts.id) {+ query.push(format!(" AND ({sort}, s.id) < ("));+ query.push_bind(timestamp);+ query.push(", ");+ query.push_bind(id);+ query.push(")");+ }+ query.push(format!(" ORDER BY {sort} DESC, s.id DESC LIMIT "));+ query.push_bind(i64::from(req.limit));++ query+ .build_query_as::<AgentSessionRow>()+ .fetch_all(db)+ .await?+ .into_iter()+ .map(row_to_item)+ .collect()+}++pub(super) async fn by_ids(+ db: &PgPool,+ req: AdvancedSortParams<'_>,+) -> Result<Vec<SoupItem<()>>, sqlx::Error> {+ let ids = req+ .entities+ .iter()+ .filter(|entity| entity.entity_type == EntityType::AgentSession)+ .filter_map(|entity| entity.entity_id.parse::<Uuid>().ok())+ .collect::<Vec<_>>();+ if ids.is_empty() {+ return Ok(Vec::new());+ }++ let mut query = QueryBuilder::<Postgres>::new(SELECT_SQL);+ query.push_bind(req.user_id.as_ref().to_string());+ query.push(ACCESS_SQL);+ query.push(" AND s.id = ANY(");+ query.push_bind(ids);+ query.push(") ORDER BY s.modified_at DESC, s.id DESC");+ query+ .build_query_as::<AgentSessionRow>()+ .fetch_all(db)+ .await?+ .into_iter()+ .map(row_to_item)+ .collect()+}++fn cursor_parts(cursor: SimpleSortQuery) -> CursorParts {+ match cursor {+ // No AST means the query never mentioned agent sessions: opt-out.+ SimpleSortQuery::NoFilter(query) => parts_from_query(&query, None, None),+ SimpleSortQuery::FilterFrecency(query) => parts_from_query(&query, None, None),+ SimpleSortQuery::ItemsFilter(query) => {+ let ast = query.filter();+ parts_from_query(+ &query,+ ast.agent_session_filter.as_deref().cloned(),+ ast.properties_filter.as_deref().cloned(),+ )+ }+ SimpleSortQuery::ItemsAndFrecencyFilter(query) => {+ let ast = &query.filter().1;+ parts_from_query(+ &query,+ ast.agent_session_filter.as_deref().cloned(),+ ast.properties_filter.as_deref().cloned(),+ )+ }+ }+}++fn parts_from_query<F>(+ query: &Query<Uuid, SimpleSortMethod, F>,+ filter: Option<Expr<AgentSessionLiteral>>,+ property_filter: Option<Expr<PropertiesLiteral>>,+) -> CursorParts {+ let (id, timestamp) = query.vals();+ CursorParts {+ sort: *query.sort_method(),+ id: id.copied(),+ timestamp: timestamp.copied(),+ filter,+ property_filter,+ }+}++/// Selects the row shape and joins the requesting user's view history. Ends+/// right before the first bind so `$1` is the user id.+const SELECT_SQL: &str = r#"+ WITH user_source_ids AS (+ SELECT cp.channel_id::text AS source_id+ FROM comms_channel_participants cp+ WHERE cp.user_id = "#;++/// Continues [`SELECT_SQL`] after the user id bind: the remaining source-id+/// arms, the row projection, the history join, and the access predicate.+/// Every `$1` here refers back to that same bind.+const ACCESS_SQL: &str = r#" AND cp.left_at IS NULL+ UNION ALL+ SELECT t.team_id::text FROM team_user t WHERE t.user_id = $1+ UNION ALL+ SELECT $1+ )+ SELECT+ s.id,+ s.name,+ s.owner_id,+ s.bot_id,+ s.thread_id,+ s.status,+ s.status_event_name,+ s.created_at,+ s.modified_at,+ uh."updatedAt"::timestamptz AS viewed_at+ FROM agent_session s+ LEFT JOIN "UserHistory" uh+ ON uh."itemId" = s.id::text+ AND uh."itemType" = 'agent_session'+ AND uh."userId" = $1+ WHERE EXISTS (+ SELECT 1 FROM entity_access ea+ WHERE ea.entity_id = s.id+ AND ea.entity_type = 'agent_session'+ AND ea.source_id IN (SELECT source_id FROM user_source_ids)+ )"#;++fn sort_sql(sort: SimpleSortMethod) -> &'static str {+ match sort {+ SimpleSortMethod::CreatedAt => "s.created_at",+ SimpleSortMethod::UpdatedAt => "s.modified_at",+ SimpleSortMethod::ViewedAt => {+ r#"COALESCE(uh."updatedAt", '1970-01-01 00:00:00+00')::timestamptz"#+ }+ SimpleSortMethod::ViewedUpdated => {+ r#"COALESCE(uh."updatedAt", s.modified_at)::timestamptz"#+ }+ }+}++fn push_filter(builder: &mut QueryBuilder<'_, Postgres>, expression: &Expr<AgentSessionLiteral>) {+ match expression {+ Expr::And(left, right) => {+ builder.push("(");+ push_filter(builder, left);+ builder.push(" AND ");+ push_filter(builder, right);+ builder.push(")");+ }+ Expr::Or(left, right) => {+ builder.push("(");+ push_filter(builder, left);+ builder.push(" OR ");+ push_filter(builder, right);+ builder.push(")");+ }+ Expr::Not(inner) => {+ builder.push("NOT (");+ push_filter(builder, inner);+ builder.push(")");+ }+ // Include only opts the leg in; it constrains nothing.+ Expr::Literal(AgentSessionLiteral::Include) => {+ builder.push("TRUE");+ }+ Expr::Literal(AgentSessionLiteral::Id(id)) => {+ builder.push("s.id = ");+ builder.push_bind(*id);+ }+ Expr::Literal(AgentSessionLiteral::Owner(owner)) => {+ builder.push("s.owner_id = ");+ builder.push_bind(owner.as_ref().to_string());+ }+ }+}++fn row_to_item(row: AgentSessionRow) -> Result<SoupItem<()>, sqlx::Error> {+ let owner_id = MacroUserIdStr::parse_from_str(&row.owner_id)+ .map_err(super::type_err)?+ .into_owned();+ // Mirror `agent_session::domain::model::SessionStatus`'s wire shape: the+ // event name is the status once one has arrived.+ let status = match row.status.as_str() {+ "event" => row.status_event_name.unwrap_or(row.status),+ _ => row.status,+ };+ Ok(SoupItem::AgentSession(SoupAgentSession {+ id: row.id,+ name: row.name,+ owner_id,+ bot_id: row.bot_id,+ thread_id: row.thread_id,+ status,+ created_at: row.created_at,+ updated_at: row.modified_at,+ viewed_at: row.viewed_at,+ extra: (),+ }))+}diff --git a/crates/soup/src/outbound/pg_soup_repo/agent_session/test.rs b/crates/soup/src/outbound/pg_soup_repo/agent_session/test.rsnew file mode 100644index 0000000000..eb5d6e118d--- /dev/null+++ b/crates/soup/src/outbound/pg_soup_repo/agent_session/test.rs@@ -0,0 +1,320 @@+use super::*;+use item_filters::ast::EntityFilterAst;+use macro_db_migrator::MACRO_DB_MIGRATIONS;+use macro_user_id::user_id::MacroUserIdStr;+use std::sync::Arc;++const OWNER: &str = "macro|[email protected]";+const MEMBER: &str = "macro|[email protected]";+const STRANGER: &str = "macro|[email protected]";+const BOT_ID: Uuid = Uuid::from_u128(0xa9e7);+const CHANNEL_ID: Uuid = Uuid::from_u128(0xc05);++struct Fixture {+ /// Owned by `OWNER`, granted to `CHANNEL_ID` (where `MEMBER` participates).+ shared: Uuid,+ /// Owned by `OWNER` only.+ private: Uuid,+}++async fn seed(pool: &PgPool) -> anyhow::Result<Fixture> {+ for user in [OWNER, MEMBER, STRANGER] {+ let macro_user_id = Uuid::now_v7();+ sqlx::query!(+ "INSERT INTO macro_user (id, username, email, stripe_customer_id) VALUES ($1, $2, $2, $2)",+ macro_user_id,+ user,+ )+ .execute(pool)+ .await?;+ sqlx::query!(+ r#"INSERT INTO "User" ("id", "email", "macro_user_id") VALUES ($1, $1, $2)"#,+ user,+ macro_user_id,+ )+ .execute(pool)+ .await?;+ }+ sqlx::query!(+ r#"+ INSERT INTO comms_channels (id, name, channel_type, owner_id)+ VALUES ($1, 'agents', 'public', $2)+ "#,+ CHANNEL_ID,+ OWNER,+ )+ .execute(pool)+ .await?;+ sqlx::query!(+ r#"+ INSERT INTO comms_channel_participants (channel_id, user_id, role)+ VALUES ($1, $2, 'owner'), ($1, $3, 'member')+ "#,+ CHANNEL_ID,+ OWNER,+ MEMBER,+ )+ .execute(pool)+ .await?;++ let shared = Uuid::now_v7();+ let private = Uuid::now_v7();+ for (id, name, modified) in [+ (shared, "Shared session", "2026-01-02T00:00:00Z"),+ (private, "Private session", "2026-01-03T00:00:00Z"),+ ] {+ let modified: chrono::DateTime<chrono::Utc> = modified.parse()?;+ sqlx::query!(+ r#"+ INSERT INTO agent_session (+ id, owner_id, bot_id, model, harness, repo_url, workspace, name,+ status, status_event_name, created_at, modified_at+ )+ VALUES ($1, $2, $3, 'model', 'harness', NULL, '/workspace', $4,+ 'event', 'session/end', '2026-01-01 00:00:00+00', $5)+ "#,+ id,+ OWNER,+ BOT_ID,+ name,+ modified,+ )+ .execute(pool)+ .await?;+ sqlx::query!(+ r#"+ INSERT INTO entity_access (entity_id, entity_type, source_id, source_type, access_level)+ VALUES ($1, 'agent_session', $2, 'user', 'owner')+ "#,+ id,+ OWNER,+ )+ .execute(pool)+ .await?;+ }+ sqlx::query!(+ r#"+ INSERT INTO entity_access (entity_id, entity_type, source_id, source_type, access_level)+ VALUES ($1, 'agent_session', $2, 'channel', 'edit')+ "#,+ shared,+ CHANNEL_ID.to_string(),+ )+ .execute(pool)+ .await?;+ Ok(Fixture { shared, private })+}++fn request(+ user: &'static str,+ filter: Option<Expr<AgentSessionLiteral>>,+) -> SimpleSortRequest<'static> {+ let cursor = match filter {+ Some(filter) => SimpleSortQuery::ItemsFilter(Query::Sort(+ SimpleSortMethod::UpdatedAt,+ EntityFilterAst {+ agent_session_filter: Some(Arc::new(filter)),+ ..EntityFilterAst::default()+ },+ )),+ None => SimpleSortQuery::NoFilter(Query::Sort(SimpleSortMethod::UpdatedAt, ())),+ };+ SimpleSortRequest {+ limit: 10,+ cursor,+ user_id: MacroUserIdStr::parse_from_str(user).expect("valid user id"),+ }+}++fn ids(items: &[SoupItem<()>]) -> Vec<Uuid> {+ items+ .iter()+ .map(|item| match item {+ SoupItem::AgentSession(session) => session.id,+ other => panic!("unexpected soup item {other:?}"),+ })+ .collect()+}++#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]+async fn sessions_are_opt_in(pool: PgPool) -> anyhow::Result<()> {+ seed(&pool).await?;++ let no_filter = cursor_soup(&pool, request(OWNER, None)).await?;+ assert!(no_filter.is_empty(), "no AST must not surface sessions");++ let ast_without_sessions = SimpleSortRequest {+ limit: 10,+ cursor: SimpleSortQuery::ItemsFilter(Query::Sort(+ SimpleSortMethod::UpdatedAt,+ EntityFilterAst::default(),+ )),+ user_id: MacroUserIdStr::parse_from_str(OWNER)?,+ };+ assert!(+ cursor_soup(&pool, ast_without_sessions).await?.is_empty(),+ "an AST that never mentions sessions must not surface them"+ );+ Ok(())+}++#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]+async fn include_lists_accessible_sessions_newest_first(pool: PgPool) -> anyhow::Result<()> {+ let fixture = seed(&pool).await?;++ let owner_items = cursor_soup(+ &pool,+ request(OWNER, Some(Expr::val(AgentSessionLiteral::Include))),+ )+ .await?;+ assert_eq!(ids(&owner_items), vec![fixture.private, fixture.shared]);+ let SoupItem::AgentSession(private) = &owner_items[0] else {+ unreachable!()+ };+ assert_eq!(private.name, "Private session");+ assert_eq!(private.status, "session/end");+ assert_eq!(private.owner_id.as_ref(), OWNER);+ assert_eq!(private.bot_id, BOT_ID);++ let member_items = cursor_soup(+ &pool,+ request(MEMBER, Some(Expr::val(AgentSessionLiteral::Include))),+ )+ .await?;+ assert_eq!(+ ids(&member_items),+ vec![fixture.shared],+ "channel members see only the session shared into their channel"+ );++ let stranger_items = cursor_soup(+ &pool,+ request(STRANGER, Some(Expr::val(AgentSessionLiteral::Include))),+ )+ .await?;+ assert!(stranger_items.is_empty());+ Ok(())+}++#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]+async fn id_and_owner_literals_constrain_the_page(pool: PgPool) -> anyhow::Result<()> {+ let fixture = seed(&pool).await?;++ let by_id = cursor_soup(+ &pool,+ request(+ OWNER,+ Some(Expr::val(AgentSessionLiteral::Id(fixture.shared))),+ ),+ )+ .await?;+ assert_eq!(ids(&by_id), vec![fixture.shared]);++ let by_owner = cursor_soup(+ &pool,+ request(+ MEMBER,+ Some(Expr::val(AgentSessionLiteral::Owner(+ MacroUserIdStr::parse_from_str(OWNER)?.into_owned(),+ ))),+ ),+ )+ .await?;+ assert_eq!(ids(&by_owner), vec![fixture.shared]);++ let other_owner = cursor_soup(+ &pool,+ request(+ OWNER,+ Some(Expr::val(AgentSessionLiteral::Owner(+ MacroUserIdStr::parse_from_str(MEMBER)?.into_owned(),+ ))),+ ),+ )+ .await?;+ assert!(other_owner.is_empty());+ Ok(())+}++#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]+async fn cursor_pages_past_the_first_row(pool: PgPool) -> anyhow::Result<()> {+ let fixture = seed(&pool).await?;++ let first = cursor_soup(+ &pool,+ SimpleSortRequest {+ limit: 1,+ cursor: SimpleSortQuery::ItemsFilter(Query::Sort(+ SimpleSortMethod::UpdatedAt,+ EntityFilterAst {+ agent_session_filter: Some(Arc::new(Expr::val(AgentSessionLiteral::Include))),+ ..EntityFilterAst::default()+ },+ )),+ user_id: MacroUserIdStr::parse_from_str(OWNER)?,+ },+ )+ .await?;+ assert_eq!(ids(&first), vec![fixture.private]);++ let SoupItem::AgentSession(private) = &first[0] else {+ unreachable!()+ };+ let second = cursor_soup(+ &pool,+ SimpleSortRequest {+ limit: 1,+ cursor: SimpleSortQuery::ItemsFilter(Query::Cursor(+ models_pagination::CursorWithValAndFilter {+ id: private.id,+ limit: 1,+ val: models_pagination::CursorVal {+ sort_type: SimpleSortMethod::UpdatedAt,+ last_val: private.updated_at,+ },+ filter: EntityFilterAst {+ agent_session_filter: Some(Arc::new(Expr::val(+ AgentSessionLiteral::Include,+ ))),+ ..EntityFilterAst::default()+ },+ },+ )),+ user_id: MacroUserIdStr::parse_from_str(OWNER)?,+ },+ )+ .await?;+ assert_eq!(ids(&second), vec![fixture.shared]);+ Ok(())+}++#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]+async fn by_ids_respects_access(pool: PgPool) -> anyhow::Result<()> {+ let fixture = seed(&pool).await?;+ let entities = [+ EntityType::AgentSession.with_entity_string(fixture.shared.to_string()),+ EntityType::AgentSession.with_entity_string(fixture.private.to_string()),+ EntityType::Chat.with_entity_string(fixture.private.to_string()),+ ];++ let owner_items = by_ids(+ &pool,+ AdvancedSortParams {+ entities: &entities,+ user_id: MacroUserIdStr::parse_from_str(OWNER)?,+ },+ )+ .await?;+ assert_eq!(ids(&owner_items), vec![fixture.private, fixture.shared]);++ let member_items = by_ids(+ &pool,+ AdvancedSortParams {+ entities: &entities,+ user_id: MacroUserIdStr::parse_from_str(MEMBER)?,+ },+ )+ .await?;+ assert_eq!(ids(&member_items), vec![fixture.shared]);+ Ok(())+}diff --git a/crates/soup/src/outbound/pg_soup_repo/expanded/tests.rs b/crates/soup/src/outbound/pg_soup_repo/expanded/tests.rsindex acd0a8065a..81d79c8823 100644--- a/crates/soup/src/outbound/pg_soup_repo/expanded/tests.rs+++ b/crates/soup/src/outbound/pg_soup_repo/expanded/tests.rs@@ -5902,6 +5902,7 @@ fn mock_empty_ast() -> EntityFilterAst {crm_company_filter: None,foreign_entity_filter: None,reminder_filter: None,+ agent_session_filter: None,properties_filter: None,}}diff --git a/crates/soup_filter_projection/src/lib.rs b/crates/soup_filter_projection/src/lib.rsindex 1e6bb78012..f3f0066df1 100644--- a/crates/soup_filter_projection/src/lib.rs+++ b/crates/soup_filter_projection/src/lib.rs@@ -369,7 +369,8 @@ pub fn project_soup_item<T>(| SoupItem::CalendarEvent(_)| SoupItem::CrmCompany(_)| SoupItem::ForeignEntity(_)- | SoupItem::Reminder(_) => Ok(None),+ | SoupItem::Reminder(_)+ | SoupItem::AgentSession(_) => Ok(None),}}diff --git a/packages/sdk/generated/agent-harness/index.ts b/packages/sdk/generated/agent-harness/index.tsindex 59d545ba29..f90098c643 100644--- a/packages/sdk/generated/agent-harness/index.ts+++ b/packages/sdk/generated/agent-harness/index.ts@@ -1,4 +1,4 @@// This file is auto-generated by @hey-api/openapi-tsexport { type Options, Sdk } from './sdk.gen';-export type { AgentAction, AgentActionId, AgentModelDto, AgentModelsStatusDto, AgentPromptAction, AgentRespondElicitationAction, AgentSessionLogEntryDto, AgentSessionLogResponse, AgentSessionQueueResponse, AgentSessionResponse, AgentSetModelAction, BotId, ClientOptions, ControlAgentSessionData, ControlAgentSessionError, ControlAgentSessionErrors, ControlAgentSessionResponse, ControlAgentSessionResponses, ControlRequest, ControlResponse, ControlStatusDto, CreateAgentSessionData, CreateAgentSessionError, CreateAgentSessionErrors, CreateAgentSessionRequest, CreateAgentSessionResponse, CreateAgentSessionResponse2, CreateAgentSessionResponses, CreateSessionThread, DeleteAgentSessionData, DeleteAgentSessionError, DeleteAgentSessionErrors, DeleteAgentSessionResponses, EditQueuedActionData, EditQueuedActionError, EditQueuedActionErrors, EditQueuedActionRequest, EditQueuedActionResponse, EditQueuedActionResponses, ElicitationAnswer, ElicitationContentValue, ElicitationRequestId, ExternalSessionResponse, GetAgentSandboxSizeData, GetAgentSandboxSizeError, GetAgentSandboxSizeErrors, GetAgentSandboxSizeResponse, GetAgentSandboxSizeResponses, GetAgentSessionData, GetAgentSessionError, GetAgentSessionErrors, GetAgentSessionLogData, GetAgentSessionLogError, GetAgentSessionLogErrors, GetAgentSessionLogResponse, GetAgentSessionLogResponses, GetAgentSessionQueueData, GetAgentSessionQueueError, GetAgentSessionQueueErrors, GetAgentSessionQueueResponse, GetAgentSessionQueueResponses, GetAgentSessionResponse, GetAgentSessionResponses, LoadAgentModelsHandlerData, LoadAgentModelsHandlerErrors, LoadAgentModelsHandlerResponse, LoadAgentModelsHandlerResponses, LoadAgentModelsRequest, LoadAgentModelsResponse, LogDirectionDto, LogFrameDto, ModelHarnessDto, PutAgentSandboxSizeData, PutAgentSandboxSizeError, PutAgentSandboxSizeErrors, PutAgentSandboxSizeResponse, PutAgentSandboxSizeResponses, PutAgentSessionSandboxSizeData, PutAgentSessionSandboxSizeError, PutAgentSessionSandboxSizeErrors, PutAgentSessionSandboxSizeResponse, PutAgentSessionSandboxSizeResponses, QueuedActionDto, RemoveQueuedActionData, RemoveQueuedActionError, RemoveQueuedActionErrors, RemoveQueuedActionResponse, RemoveQueuedActionResponses, RenameAgentSessionData, RenameAgentSessionError, RenameAgentSessionErrors, RenameAgentSessionRequest, RenameAgentSessionResponse, RenameAgentSessionResponses, SandboxSize, SandboxSizeBody, SessionBot, SessionStatusDto } from './types.gen';+export type { AgentAction, AgentActionId, AgentModelDto, AgentModelsStatusDto, AgentPromptAction, AgentRespondElicitationAction, AgentSessionLogEntryDto, AgentSessionLogResponse, AgentSessionPreviewData, AgentSessionPreviewDto, AgentSessionQueueResponse, AgentSessionResponse, AgentSetModelAction, BotId, ClientOptions, ControlAgentSessionData, ControlAgentSessionError, ControlAgentSessionErrors, ControlAgentSessionResponse, ControlAgentSessionResponses, ControlRequest, ControlResponse, ControlStatusDto, CreateAgentSessionData, CreateAgentSessionError, CreateAgentSessionErrors, CreateAgentSessionRequest, CreateAgentSessionResponse, CreateAgentSessionResponse2, CreateAgentSessionResponses, CreateSessionThread, DeleteAgentSessionData, DeleteAgentSessionError, DeleteAgentSessionErrors, DeleteAgentSessionResponses, EditQueuedActionData, EditQueuedActionError, EditQueuedActionErrors, EditQueuedActionRequest, EditQueuedActionResponse, EditQueuedActionResponses, ElicitationAnswer, ElicitationContentValue, ElicitationRequestId, ExternalSessionResponse, GetAgentSandboxSizeData, GetAgentSandboxSizeError, GetAgentSandboxSizeErrors, GetAgentSandboxSizeResponse, GetAgentSandboxSizeResponses, GetAgentSessionData, GetAgentSessionError, GetAgentSessionErrors, GetAgentSessionLogData, GetAgentSessionLogError, GetAgentSessionLogErrors, GetAgentSessionLogResponse, GetAgentSessionLogResponses, GetAgentSessionQueueData, GetAgentSessionQueueError, GetAgentSessionQueueErrors, GetAgentSessionQueueResponse, GetAgentSessionQueueResponses, GetAgentSessionResponse, GetAgentSessionResponses, LoadAgentModelsHandlerData, LoadAgentModelsHandlerErrors, LoadAgentModelsHandlerResponse, LoadAgentModelsHandlerResponses, LoadAgentModelsRequest, LoadAgentModelsResponse, LogDirectionDto, LogFrameDto, ModelHarnessDto, PreviewAgentSessionsData, PreviewAgentSessionsError, PreviewAgentSessionsErrors, PreviewAgentSessionsRequest, PreviewAgentSessionsResponse, PreviewAgentSessionsResponse2, PreviewAgentSessionsResponses, PutAgentSandboxSizeData, PutAgentSandboxSizeError, PutAgentSandboxSizeErrors, PutAgentSandboxSizeResponse, PutAgentSandboxSizeResponses, PutAgentSessionSandboxSizeData, PutAgentSessionSandboxSizeError, PutAgentSessionSandboxSizeErrors, PutAgentSessionSandboxSizeResponse, PutAgentSessionSandboxSizeResponses, QueuedActionDto, RemoveQueuedActionData, RemoveQueuedActionError, RemoveQueuedActionErrors, RemoveQueuedActionResponse, RemoveQueuedActionResponses, RenameAgentSessionData, RenameAgentSessionError, RenameAgentSessionErrors, RenameAgentSessionRequest, RenameAgentSessionResponse, RenameAgentSessionResponses, SandboxSize, SandboxSizeBody, SessionBot, SessionStatusDto, WithAgentSessionId } from './types.gen';diff --git a/packages/sdk/generated/agent-harness/sdk.gen.ts b/packages/sdk/generated/agent-harness/sdk.gen.tsindex 80d76466e0..f3de384bb1 100644--- a/packages/sdk/generated/agent-harness/sdk.gen.ts+++ b/packages/sdk/generated/agent-harness/sdk.gen.ts@@ -2,7 +2,7 @@import type { Client, ClientMeta, Options as Options2, RequestResult, TDataShape } from './client';import { client } from './client.gen';-import type { ControlAgentSessionData, ControlAgentSessionErrors, ControlAgentSessionResponses, CreateAgentSessionData, CreateAgentSessionErrors, CreateAgentSessionResponses, DeleteAgentSessionData, DeleteAgentSessionErrors, DeleteAgentSessionResponses, EditQueuedActionData, EditQueuedActionErrors, EditQueuedActionResponses, GetAgentSandboxSizeData, GetAgentSandboxSizeErrors, GetAgentSandboxSizeResponses, GetAgentSessionData, GetAgentSessionErrors, GetAgentSessionLogData, GetAgentSessionLogErrors, GetAgentSessionLogResponses, GetAgentSessionQueueData, GetAgentSessionQueueErrors, GetAgentSessionQueueResponses, GetAgentSessionResponses, LoadAgentModelsHandlerData, LoadAgentModelsHandlerErrors, LoadAgentModelsHandlerResponses, PutAgentSandboxSizeData, PutAgentSandboxSizeErrors, PutAgentSandboxSizeResponses, PutAgentSessionSandboxSizeData, PutAgentSessionSandboxSizeErrors, PutAgentSessionSandboxSizeResponses, RemoveQueuedActionData, RemoveQueuedActionErrors, RemoveQueuedActionResponses, RenameAgentSessionData, RenameAgentSessionErrors, RenameAgentSessionResponses } from './types.gen';+import type { ControlAgentSessionData, ControlAgentSessionErrors, ControlAgentSessionResponses, CreateAgentSessionData, CreateAgentSessionErrors, CreateAgentSessionResponses, DeleteAgentSessionData, DeleteAgentSessionErrors, DeleteAgentSessionResponses, EditQueuedActionData, EditQueuedActionErrors, EditQueuedActionResponses, GetAgentSandboxSizeData, GetAgentSandboxSizeErrors, GetAgentSandboxSizeResponses, GetAgentSessionData, GetAgentSessionErrors, GetAgentSessionLogData, GetAgentSessionLogErrors, GetAgentSessionLogResponses, GetAgentSessionQueueData, GetAgentSessionQueueErrors, GetAgentSessionQueueResponses, GetAgentSessionResponses, LoadAgentModelsHandlerData, LoadAgentModelsHandlerErrors, LoadAgentModelsHandlerResponses, PreviewAgentSessionsData, PreviewAgentSessionsErrors, PreviewAgentSessionsResponses, PutAgentSandboxSizeData, PutAgentSandboxSizeErrors, PutAgentSandboxSizeResponses, PutAgentSessionSandboxSizeData, PutAgentSessionSandboxSizeErrors, PutAgentSessionSandboxSizeResponses, RemoveQueuedActionData, RemoveQueuedActionErrors, RemoveQueuedActionResponses, RenameAgentSessionData, RenameAgentSessionErrors, RenameAgentSessionResponses } from './types.gen';export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {/**@@ -113,6 +113,25 @@ export class Sdk extends HeyApiClient {});}+ /**+ * Preview a batch of agent sessions for rendering chips.+ *+ * No per-id access extractor: a chip has to render for a session the caller+ * cannot open, so access is answered per id in the body rather than+ * enforced on the request. The caller learns the fields a chip shows for+ * sessions they may view, and only existence for the rest.+ */+ public previewAgentSessions<ThrowOnError extends boolean = false>(options: Options<PreviewAgentSessionsData, ThrowOnError>): RequestResult<PreviewAgentSessionsResponses, PreviewAgentSessionsErrors, ThrowOnError> {+ return (options.client ?? this.client).post<PreviewAgentSessionsResponses, PreviewAgentSessionsErrors, ThrowOnError>({+ url: '/agent-sessions/preview',+ ...options,+ headers: {+ 'Content-Type': 'application/json',+ ...options.headers+ }+ });+ }+/*** Delete an agent session and its live resources.*/diff --git a/packages/sdk/generated/agent-harness/types.gen.ts b/packages/sdk/generated/agent-harness/types.gen.tsindex af38cf4f8c..a370a487bc 100644--- a/packages/sdk/generated/agent-harness/types.gen.ts+++ b/packages/sdk/generated/agent-harness/types.gen.ts@@ -144,6 +144,59 @@ export type AgentSessionLogResponse = {entries: Array<AgentSessionLogEntryDto>;};+/**+ * The fields a chip renders for a session the caller may view.+ *+ * Clients deserialize this, so both derives are used.+ */+export type AgentSessionPreviewData = {+ /**+ * The bot running the agent.+ */+ botId: string;+ /**+ * When the session was created.+ */+ createdAt: string;+ /**+ * The session id.+ */+ id: string;+ /**+ * When the session was last modified.+ */+ modifiedAt: string;+ /**+ * User-facing session name.+ */+ name: string;+ /**+ * The user who owns the session.+ */+ ownerId: string;+ /**+ * The session's last known status.+ */+ status: SessionStatusDto;+};++/**+ * What one requested id resolved to, on the wire.+ *+ * Tagged the same way the chat and document preview endpoints tag theirs+ * (`type` in `access` / `no_access` / `does_not_exist`), so a client that+ * renders those chips can render this one with the same branch.+ *+ * Clients deserialize this, so both derives are used.+ */+export type AgentSessionPreviewDto = (AgentSessionPreviewData & {+ type: 'access';+}) | (WithAgentSessionId & {+ type: 'no_access';+}) | (WithAgentSessionId & {+ type: 'does_not_exist';+});+/*** Response body for a session's queue: everything waiting, oldest first.*@@ -510,6 +563,33 @@ export type LogFrameDto = {*/export type ModelHarnessDto = 'in-memory' | 'cursor' | 'macrod';+/**+ * Request body for `POST /agent-sessions/preview`.+ *+ * Clients serialize this, so both derives are used.+ */+export type PreviewAgentSessionsRequest = {+ /**+ * The sessions to preview. Duplicates are collapsed server-side; at most+ * [`MAX_PREVIEW_SESSION_IDS`](crate::domain::model::MAX_PREVIEW_SESSION_IDS)+ * distinct ids per request.+ */+ sessionIds: Array<string>;+};++/**+ * Response body for `POST /agent-sessions/preview`: one entry per distinct+ * requested id, in no particular order.+ *+ * Clients deserialize this, so both derives are used.+ */+export type PreviewAgentSessionsResponse = {+ /**+ * What the caller may see of each requested session.+ */+ previews: Array<AgentSessionPreviewDto>;+};+/*** One action waiting in a session's queue.*@@ -602,6 +682,18 @@ export type SessionStatusDto = {kind: 'disconnected';};+/**+ * Just a session id, for the preview variants that carry nothing else.+ *+ * Clients deserialize this, so both derives are used.+ */+export type WithAgentSessionId = {+ /**+ * The session id.+ */+ id: string;+};+export type LoadAgentModelsHandlerData = {body: LoadAgentModelsRequest;path?: never;@@ -708,6 +800,30 @@ export type CreateAgentSessionResponses = {export type CreateAgentSessionResponse2 = CreateAgentSessionResponses[keyof CreateAgentSessionResponses];+export type PreviewAgentSessionsData = {+ body: PreviewAgentSessionsRequest;+ path?: never;+ query?: never;+ url: '/agent-sessions/preview';+};++export type PreviewAgentSessionsErrors = {+ /**+ * more than the maximum number of session ids+ */+ 400: string;+ 401: string;+ 500: string;+};++export type PreviewAgentSessionsError = PreviewAgentSessionsErrors[keyof PreviewAgentSessionsErrors];++export type PreviewAgentSessionsResponses = {+ 200: PreviewAgentSessionsResponse;+};++export type PreviewAgentSessionsResponse2 = PreviewAgentSessionsResponses[keyof PreviewAgentSessionsResponses];+export type DeleteAgentSessionData = {body?: never;path: {diff --git a/packages/sdk/generated/search/index.ts b/packages/sdk/generated/search/index.tsindex 05ae4dbea1..3626ce930f 100644--- a/packages/sdk/generated/search/index.ts+++ b/packages/sdk/generated/search/index.ts@@ -1,4 +1,4 @@// This file is auto-generated by @hey-api/openapi-tsexport { type Options, Sdk } from './sdk.gen';-export type { CalendarEventFilters, CalendarEventMetadata, CalendarEventOrganizer, CalendarEventSearchOccurrence, CalendarEventSearchResponseItem, CalendarEventSearchResponseItemWithMetadata, CalendarEventSearchResult, CalendarEventSearchTime, CallFilters, CallRecordMetadata, CallRecordSearchResponseItem, CallRecordSearchResponseItemWithMetadata, CallRecordSearchResult, CallStatus, ChannelFilters, ChannelMessageSearchResponseItem, ChannelMetadata, ChannelNameSearchResponseItem, ChannelSearchRequest, ChannelSearchResponse, ChannelSearchResponseItem, ChannelSearchResponseItemWithMetadata, ChannelSearchResult, ChannelSortTimestamp, ChannelThreadFilters, ChatFilters, ChatMessageSearchResult, ChatMetadata, ChatSearchRequest, ChatSearchResponse, ChatSearchResponseItem, ChatSearchResponseItemWithMetadata, ClientOptions, CrmCompanyFilters, CrmCompanySearchDomain, CrmCompanySearchResponseItem, DataType, DocumentFilters, DocumentMetadata, DocumentSearchRequest, DocumentSearchResponse, DocumentSearchResponseItem, DocumentSearchResponseItemWithMetadata, DocumentSearchResult, DocumentSubType, EmailFilters, EmailSearchParticipant, EmailSearchRequest, EmailSearchResponse, EmailSearchResponseItem, EmailSearchResponseItemWithMetadata, EmailSearchResult, EmptyResponse, EntityFilters, EntityReference, EntityType, ErrorResponse, FileType, ForeignEntityFilters, MatchType, NotificationFilters, NotificationState, ProjectFilters, ProjectMetadata, ProjectSearchMetadata, ProjectSearchRequest, ProjectSearchResponseItem, ProjectSearchResponseItemWithMetadata, ProjectSearchResult, PropertyDefinition, PropertyFilter, PropertyOwner, PropertyValue, ReminderFilters, SearchHighlight, SearchOn, SearchResponse, SharedEmailFilter, SimpleCalendarEventSearchResponseBaseItemHumanReadableTimestamp, SimpleCallRecordSearchResponseBaseItemHumanReadableTimestamp, SimpleChannelSearchReponseBaseItem, SimpleChannelSearchReponseBaseItemHumanReadableTimestamp, SimpleChannelSearchResponse, SimpleChatSearchResponse, SimpleChatSearchResponseBaseItem, SimpleChatSearchResponseBaseItemHumanReadableTimestamp, SimpleDocumentSearchResponse, SimpleDocumentSearchResponseBaseItem, SimpleDocumentSearchResponseBaseItemHumanReadableTimestamp, SimpleEmailSearchResponse, SimpleEmailSearchResponseBaseItem, SimpleEmailSearchResponseBaseItemHumanReadableTimestamp, SimpleProjectSearchResponse, SimpleProjectSearchResponseBaseItem, SimpleProjectSearchResponseBaseItemHumanReadableTimestamp, SimpleUnifiedSearchBaseResponse, SimpleUnifiedSearchData, SimpleUnifiedSearchError, SimpleUnifiedSearchErrors, SimpleUnifiedSearchResponse, SimpleUnifiedSearchResponseBaseItem, SimpleUnifiedSearchResponseBaseItemHumanReadableTimestamp, SimpleUnifiedSearchResponses, SoupProperty, TagFilterMode, TaskFilters, UnifiedSearchData, UnifiedSearchError, UnifiedSearchErrors, UnifiedSearchRequest, UnifiedSearchResponse, UnifiedSearchResponse2, UnifiedSearchResponseItem, UnifiedSearchResponses } from './types.gen';+export type { AgentSessionFilters, CalendarEventFilters, CalendarEventMetadata, CalendarEventOrganizer, CalendarEventSearchOccurrence, CalendarEventSearchResponseItem, CalendarEventSearchResponseItemWithMetadata, CalendarEventSearchResult, CalendarEventSearchTime, CallFilters, CallRecordMetadata, CallRecordSearchResponseItem, CallRecordSearchResponseItemWithMetadata, CallRecordSearchResult, CallStatus, ChannelFilters, ChannelMessageSearchResponseItem, ChannelMetadata, ChannelNameSearchResponseItem, ChannelSearchRequest, ChannelSearchResponse, ChannelSearchResponseItem, ChannelSearchResponseItemWithMetadata, ChannelSearchResult, ChannelSortTimestamp, ChannelThreadFilters, ChatFilters, ChatMessageSearchResult, ChatMetadata, ChatSearchRequest, ChatSearchResponse, ChatSearchResponseItem, ChatSearchResponseItemWithMetadata, ClientOptions, CrmCompanyFilters, CrmCompanySearchDomain, CrmCompanySearchResponseItem, DataType, DocumentFilters, DocumentMetadata, DocumentSearchRequest, DocumentSearchResponse, DocumentSearchResponseItem, DocumentSearchResponseItemWithMetadata, DocumentSearchResult, DocumentSubType, EmailFilters, EmailSearchParticipant, EmailSearchRequest, EmailSearchResponse, EmailSearchResponseItem, EmailSearchResponseItemWithMetadata, EmailSearchResult, EmptyResponse, EntityFilters, EntityReference, EntityType, ErrorResponse, FileType, ForeignEntityFilters, MatchType, NotificationFilters, NotificationState, ProjectFilters, ProjectMetadata, ProjectSearchMetadata, ProjectSearchRequest, ProjectSearchResponseItem, ProjectSearchResponseItemWithMetadata, ProjectSearchResult, PropertyDefinition, PropertyFilter, PropertyOwner, PropertyValue, ReminderFilters, SearchHighlight, SearchOn, SearchResponse, SharedEmailFilter, SimpleCalendarEventSearchResponseBaseItemHumanReadableTimestamp, SimpleCallRecordSearchResponseBaseItemHumanReadableTimestamp, SimpleChannelSearchReponseBaseItem, SimpleChannelSearchReponseBaseItemHumanReadableTimestamp, SimpleChannelSearchResponse, SimpleChatSearchResponse, SimpleChatSearchResponseBaseItem, SimpleChatSearchResponseBaseItemHumanReadableTimestamp, SimpleDocumentSearchResponse, SimpleDocumentSearchResponseBaseItem, SimpleDocumentSearchResponseBaseItemHumanReadableTimestamp, SimpleEmailSearchResponse, SimpleEmailSearchResponseBaseItem, SimpleEmailSearchResponseBaseItemHumanReadableTimestamp, SimpleProjectSearchResponse, SimpleProjectSearchResponseBaseItem, SimpleProjectSearchResponseBaseItemHumanReadableTimestamp, SimpleUnifiedSearchBaseResponse, SimpleUnifiedSearchData, SimpleUnifiedSearchError, SimpleUnifiedSearchErrors, SimpleUnifiedSearchResponse, SimpleUnifiedSearchResponseBaseItem, SimpleUnifiedSearchResponseBaseItemHumanReadableTimestamp, SimpleUnifiedSearchResponses, SoupProperty, TagFilterMode, TaskFilters, UnifiedSearchData, UnifiedSearchError, UnifiedSearchErrors, UnifiedSearchRequest, UnifiedSearchResponse, UnifiedSearchResponse2, UnifiedSearchResponseItem, UnifiedSearchResponses } from './types.gen';diff --git a/packages/sdk/generated/search/types.gen.ts b/packages/sdk/generated/search/types.gen.tsindex 7b080a2afd..5c7d474702 100644--- a/packages/sdk/generated/search/types.gen.ts+++ b/packages/sdk/generated/search/types.gen.ts@@ -4,6 +4,27 @@ export type ClientOptions = {baseUrl: `${string}://${string}` | (string & {});};+/**+ * Filters for agent sessions.+ */+export type AgentSessionFilters = {+ /**+ * Agent session ids to filter by. Empty to include all accessible sessions.+ */+ ids?: Array<string>;+ /**+ * Opt this query into agent sessions at all. Agent sessions are off by+ * default — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].+ * Asking for specific `ids` or `owners` also opts in.+ */+ include?: boolean;+ /**+ * Filter by session owner. Examples: ['macro|[email protected]']. Empty to+ * include every owner.+ */+ owners?: Array<string>;+};+/*** Filters for canonical calendar-event entities.*/@@ -1199,6 +1220,10 @@ export type EmptyResponse = {* a bundle of all of the filters for each entity type*/export type EntityFilters = {+ /**+ * the bundled [AgentSessionFilters]+ */+ agent_session_filters?: AgentSessionFilters;/*** the bundled [CalendarEventFilters]*/diff --git a/packages/sdk/generated/storage/index.ts b/packages/sdk/generated/storage/index.tsindex a3bd83d1a9..11a978e1d2 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-tsexport { type Options, Sdk } from './sdk.gen';-export type { AccessLevel, ActiveCallsResponse, ActiveCallSummary, ActivityType, AddFavoriteData, AddFavoriteError, AddFavoriteErrors, AddFavoriteRequest, AddFavoriteResponse, AddFavoriteResponses, AddParticipantsData, AddParticipantsError, AddParticipantsErrors, AddParticipantsRequest, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerError, AddPinHandlerErrors, AddPinHandlerResponse, AddPinHandlerResponses, AddPinRequest, Agent, AgentActionId, AgentChannelScope, AgentMcpServer, AgentMcpServers, AgentSessionLifecycleEvent, Anchor, AnchorId, AnchorRequest, AnchorResponse, AnnotationIncrementalUpdate, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelContextMessage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelMessage, ApiChannelMessageKind, ApiChannelMessagesPage, ApiChannelParticipant, ApiChannelWithLatest, ApiCountedReaction, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiMessageAttachment, ApiMessageSender, ApiMessageSenderType, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, ApiResolvedChannelMessage, ApiThreadInfo, ApiThreadReply, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AttendeeResponseStatus, BasicDocument, BasicDocumentSubType, BomPart, Bot, BotChannel, BotChannelType, BotId, BotKind, BotOwner, 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, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData, CallRecordTranscriptSegment, CallStatus, CallTokenResponse, CallWebhookData, CallWebhookError, CallWebhookErrors, CallWebhookResponses, Channel, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelEventAttachment, ChannelFilters, ChannelJoinCodeResponse, ChannelMentionedMetadata, ChannelMessage, ChannelMessageAttachmentCreatedMetadata, ChannelMessageAttachmentRemovedMetadata, ChannelMessageDeletedMetadata, ChannelMessageFilters, ChannelMessagePatchedMetadata, ChannelMessagePostedMetadata, ChannelParticipant, ChannelParticipantAddedMetadata, ChannelParticipantRemovedMetadata, ChannelPreview, ChannelPreviewData, ChannelSender, ChannelSharePermission, ChannelThreadFilters, ChannelTopicEvent, ChannelType, ChannelUpdatedMetadata, ChannelWebhookRequest, ChannelWebhookResponse, ChannelWithParticipants, Chat, ChatFilters, CheckActiveCallData, CheckActiveCallError, CheckActiveCallErrors, CheckActiveCallResponse, CheckActiveCallResponses, ClaimedPairing, ClaimHarnessPairingData, ClaimHarnessPairingError, ClaimHarnessPairingErrors, ClaimHarnessPairingResponse, ClaimHarnessPairingResponses, ClaimPairingRequest, ClientOptions, CloudStorageItemType, CollabSurfaceResponse, CollabSurfaceTokenResponse, Comment, CommentThread, ConferenceProvider, CopyDocumentData, CopyDocumentError, CopyDocumentErrors, CopyDocumentQueryParams, CopyDocumentRequest, CopyDocumentResponse, CopyDocumentResponse2, CopyDocumentResponses, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentRequest, CreateAgentResponse, CreateAgentResponses, CreateAnchorData, CreateAnchorError, CreateAnchorErrors, CreateAnchorResponse, CreateAnchorResponses, CreateBotRequest, CreateBulkDocumentResponse, CreateBulkDocumentResponseData, CreateChannelData, CreateChannelError, CreateChannelErrors, CreateChannelRequest, CreateChannelResponse, CreateChannelResponse2, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotError, CreateChannelScopedBotErrors, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse, CreateChannelScopedBotResponse2, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenError, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponse, CreateCollabSurfaceTokenResponses, CreateCommentData, CreateCommentError, CreateCommentErrors, CreateCommentRequest, CreateCommentResponse, CreateCommentResponse2, CreateCommentResponses, CreateCrmCommentData, CreateCrmCommentError, CreateCrmCommentErrors, CreateCrmCommentRequest, CreateCrmCommentResponse, CreateCrmCommentResponses, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateInstructionsDocumentResponse, CreateInstructionsHandlerData, CreateInstructionsHandlerError, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponse, CreateInstructionsHandlerResponses, CreateMarkdownDocumentRequest, CreateMarkdownDocumentResponse, CreateMarkdownHandlerData, CreateMarkdownHandlerError, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponse, CreateMarkdownHandlerResponses, CreatePairingRequest, CreateProjectHandlerData, CreateProjectHandlerError, CreateProjectHandlerErrors, CreateProjectHandlerResponse, CreateProjectHandlerResponses, CreateProjectRequest, CreateProjectResponse, CreateReminderData, CreateReminderError, CreateReminderErrors, CreateReminderRequest, CreateReminderResponse, CreateReminderResponses, CreateSkillHandlerData, CreateSkillHandlerError, CreateSkillHandlerErrors, CreateSkillHandlerResponse, CreateSkillHandlerResponses, CreateSkillRequest, CreateSkillResponse, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmComment, CrmCommentEntityType, CrmCommentThread, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CrmThread, CustomSpeakerAssignment, DataType, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorInfo, DeleteAnchorResponse, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, DeleteCommentData, DeleteCommentError, DeleteCommentErrors, DeleteCommentRequest, DeleteCommentResponse, DeleteCommentResponse2, DeleteCommentResponses, DeleteCrmCommentData, DeleteCrmCommentError, DeleteCrmCommentErrors, DeleteCrmCommentResponse, DeleteCrmCommentResponses, DeleteCrmCommentResult, DeleteDocumentData, DeleteDocumentError, DeleteDocumentErrors, DeleteDocumentResponse, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionError, DeleteEntityMentionErrors, DeleteEntityMentionResponse, DeleteEntityMentionResponse2, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessError, DeleteHarnessErrors, DeleteHarnessResponse, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerError, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponse, DeleteHistoryHandlerResponses, DeleteMessageData, DeleteMessageError, DeleteMessageErrors, DeleteMessageQuery, DeleteMessageResponse, DeleteMessageResponses, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteReminderData, DeleteReminderError, DeleteReminderErrors, DeleteReminderResponse, DeleteReminderResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, DeleteThreadInfo, DeleteUnthreadedAnchorRequest, DeleteUnthreadedAnchorResponse, DeleteUnthreadedPdfAnchorRequest, DeleteUserApiKeyData, DeleteUserApiKeyError, DeleteUserApiKeyErrors, DeleteUserApiKeyResponse, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationError, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponse, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerError, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookError, DeleteWebhookErrors, DeleteWebhookResponse, DeleteWebhookResponses, DocumentBasic, DocumentContent, DocumentContentLocation, DocumentContentState, DocumentContentUploadedMetadata, DocumentCopiedMetadata, DocumentCreatedMetadata, DocumentDeletedMetadata, DocumentFilters, DocumentInteractionMetadata, DocumentMetadata, DocumentMetadataWithContent, DocumentPermissionsToken, DocumentPermissionsTokenRequest, DocumentPermissionsTokenResponse, DocumentPreview, DocumentPreviewData, DocumentPreviewDataSubType, DocumentPurgedMetadata, DocumentResponse, DocumentResponseMetadata, DocumentResponseMetadataWithContent, DocumentStorageServiceApiVersion, DocumentSubType, DocumentSyncContentUpdatedMetadata, DocumentTeamShareResponse, DocumentTopicEvent, DocumentUpdatedMetadata, EditAnchorData, EditAnchorError, EditAnchorErrors, EditAnchorRequest, EditAnchorResponse, EditAnchorResponse2, EditAnchorResponses, EditCallRecordData, EditCallRecordError, EditCallRecordErrors, EditCallRecordRequest, EditCallRecordResponse, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptError, EditCallTranscriptErrors, EditCallTranscriptRequest, EditCallTranscriptResponse, EditCallTranscriptResponses, EditCommentData, EditCommentError, EditCommentErrors, EditCommentRequest, EditCommentResponse, EditCommentResponse2, EditCommentResponses, EditCrmCommentData, EditCrmCommentError, EditCrmCommentErrors, EditCrmCommentRequest, EditCrmCommentResponse, EditCrmCommentResponses, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EntityFilters, EntityPermission, EntityPermissionResponse, EntityReference, EntityType, ErrorResponse, EventReminderOverride, EventReminders, EventStatus, EventTime, EventTransparency, EventType, EventVisibility, ExcludedDefaultView, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerError, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExcludeDefaultViewRequest, ExportDocumentData, ExportDocumentError, ExportDocumentErrors, ExportDocumentResponse, ExportDocumentResponse2, ExportDocumentResponses, Favorite, FavoriteEntityRef, FavoritesList, FileSystemNodeWithIds, FileType, FileTypeUpdate, FolderItem, ForeignEntity, ForeignEntityFilters, GenericErrorResponse, GenericResponse, GenericSuccessResponse, GetActiveCallsData, GetActiveCallsError, GetActiveCallsErrors, GetActiveCallsResponse, GetActiveCallsResponses, GetActivityData, GetActivityError, GetActivityErrors, GetActivityResponse, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesError, GetAttachmentReferencesErrors, GetAttachmentReferencesResponse, GetAttachmentReferencesResponse2, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewError, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewRequest, GetBatchCallRecordPreviewResponse, GetBatchCallRecordPreviewResponse2, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewError, GetBatchChannelPreviewErrors, GetBatchChannelPreviewRequest, GetBatchChannelPreviewResponse, GetBatchChannelPreviewResponse2, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerError, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponse, GetBatchPreviewHandlerResponses, GetBatchPreviewRequest, GetBatchPreviewResponse, GetBatchProjectPreviewData, GetBatchProjectPreviewError, GetBatchProjectPreviewErrors, GetBatchProjectPreviewRequest, GetBatchProjectPreviewResponse, GetBatchProjectPreviewResponse2, GetBatchProjectPreviewResponses, GetCallRecordData, GetCallRecordError, GetCallRecordErrors, GetCallRecordResponse, GetCallRecordResponses, GetChannelAttachmentsData, GetChannelAttachmentsError, GetChannelAttachmentsErrors, GetChannelAttachmentsResponse, GetChannelAttachmentsResponses, GetChannelData, GetChannelError, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkError, GetChannelJoinLinkErrors, GetChannelJoinLinkResponse, GetChannelJoinLinkResponses, GetChannelMessagesCatchUpData, GetChannelMessagesCatchUpError, GetChannelMessagesCatchUpErrors, GetChannelMessagesCatchUpResponse, GetChannelMessagesCatchUpResponses, GetChannelMessagesData, GetChannelMessagesError, GetChannelMessagesErrors, GetChannelMessagesResponse, GetChannelMessagesResponses, GetChannelParticipantsData, GetChannelParticipantsError, GetChannelParticipantsErrors, GetChannelParticipantsResponse, GetChannelParticipantsResponses, GetChannelResponse, GetChannelResponses, GetChannelsData, GetChannelsError, GetChannelsErrors, GetChannelsResponse, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceError, GetCollabSurfaceErrors, GetCollabSurfaceResponse, GetCollabSurfaceResponses, GetCompanyData, GetCompanyError, GetCompanyErrors, GetCompanyResponse, GetCompanyResponses, GetContactByEmailData, GetContactByEmailError, GetContactByEmailErrors, GetContactByEmailResponse, GetContactByEmailResponse2, GetContactByEmailResponses, GetContactData, GetContactError, GetContactErrors, GetContactResponse, GetContactResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsError, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponse, GetCrmTeamSettingsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, GetDocumentCommentsData, GetDocumentCommentsError, GetDocumentCommentsErrors, GetDocumentCommentsResponse, GetDocumentCommentsResponses, GetDocumentData, GetDocumentError, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsError, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponse, GetDocumentGithubPullRequestsResponses, GetDocumentKeyResponse, GetDocumentKeyResponseData, GetDocumentListHandlerData, GetDocumentListHandlerError, GetDocumentListHandlerErrors, GetDocumentListHandlerResponse, GetDocumentListHandlerResponses, GetDocumentListResult, GetDocumentLocationV3Data, GetDocumentLocationV3Error, GetDocumentLocationV3Errors, GetDocumentLocationV3Response, GetDocumentLocationV3Responses, GetDocumentPermissionsResponseDataV2, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenError, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponse, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Error, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Response, GetDocumentPermissionsV2Responses, GetDocumentProcessingResult, GetDocumentProcessingResultData, GetDocumentProcessingResultError, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponse, GetDocumentProcessingResultResponse2, GetDocumentProcessingResultResponses, GetDocumentResponse, GetDocumentResponse2, GetDocumentResponseData, GetDocumentResponses, GetDocumentSearchResponse, GetDocumentShortIdData, GetDocumentShortIdError, GetDocumentShortIdErrors, GetDocumentShortIdResponse, GetDocumentShortIdResponses, GetDocumentsResponse, GetDocumentTeamShareData, GetDocumentTeamShareError, GetDocumentTeamShareErrors, GetDocumentTeamShareResponse, GetDocumentTeamShareResponses, GetDocumentUserAccessLevelResponse, GetDocumentVersionData, GetDocumentVersionError, GetDocumentVersionErrors, GetDocumentVersionResponse, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerError, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponse, GetDocumentViewsHandlerResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponse, GetEntityPermissionResponses, GetForeignEntityData, GetForeignEntityError, GetForeignEntityErrors, GetForeignEntityResponse, GetForeignEntityResponses, GetHarnessPairingData, GetHarnessPairingError, GetHarnessPairingErrors, GetHarnessPairingResponse, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerError, GetHistoryHandlerErrors, GetHistoryHandlerResponse, GetHistoryHandlerResponses, GetInstructionsDocumentResponse, GetInstructionsHandlerData, GetInstructionsHandlerError, GetInstructionsHandlerErrors, GetInstructionsHandlerResponse, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupError, GetItemsSoupErrors, GetItemsSoupResponse, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerError, GetLocationHandlerErrors, GetLocationHandlerResponse, GetLocationHandlerResponses, GetMessageWithContextData, GetMessageWithContextError, GetMessageWithContextErrors, GetMessageWithContextResponse, GetMessageWithContextResponse2, GetMessageWithContextResponses, GetOrCreateAction, GetOrCreateCallData, GetOrCreateCallError, GetOrCreateCallErrors, GetOrCreateCallResponse, GetOrCreateCallResponses, GetOrCreateChannelResponse, GetOrCreateDmData, GetOrCreateDmError, GetOrCreateDmErrors, GetOrCreateDmRequest, GetOrCreateDmResponse, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateError, GetOrCreatePrivateErrors, GetOrCreatePrivateRequest, GetOrCreatePrivateResponse, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerError, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponse, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerError, GetPinsHandlerErrors, GetPinsHandlerResponse, GetPinsHandlerResponses, GetPinsResponse, GetProjectContentHandlerData, GetProjectContentHandlerError, GetProjectContentHandlerErrors, GetProjectContentHandlerResponse, GetProjectContentHandlerResponses, GetProjectContentResponse, GetProjectHandlerData, GetProjectHandlerError, GetProjectHandlerErrors, GetProjectHandlerResponse, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Error, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Response, GetProjectPermissionsV2Responses, GetProjectResponse, GetProjectResponseData, GetProjectsHandlerData, GetProjectsHandlerError, GetProjectsHandlerErrors, GetProjectsHandlerResponse, GetProjectsHandlerResponses, GetProjectsResponse, GetProjectUserAccessLevelData, GetProjectUserAccessLevelError, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponse, GetProjectUserAccessLevelResponses, GetReminderData, GetReminderError, GetReminderErrors, GetReminderResponse, GetReminderResponses, GetRingStatusData, GetRingStatusError, GetRingStatusErrors, GetRingStatusResponse, GetRingStatusResponses, GetSelfBotData, GetSelfBotError, GetSelfBotErrors, GetSelfBotResponse, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessError, GetSelfHarnessErrors, GetSelfHarnessResponse, GetSelfHarnessResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, GetThreadRepliesData, GetThreadRepliesError, GetThreadRepliesErrors, GetThreadRepliesResponse, GetThreadRepliesResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerError, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponse, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationError, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponse, GetUserDocumentViewLocationResponses, GetUserHistoryResponse, GetViewsHandlerData, GetViewsHandlerError, GetViewsHandlerErrors, GetViewsHandlerResponse, GetViewsHandlerResponses, GetWebhookData, GetWebhookError, GetWebhookErrors, GetWebhookResponse, GetWebhookResponses, GithubPullRequest, GithubPullRequestCheckRun, GithubPullRequestComment, GithubPullRequestsResponse, GroupedInitialParams, GroupedPageParams, GroupedSoupGroupPage, GroupedSoupInitialPage, GroupedSoupPage, GroupedSoupSort, HandlerData, HandlerError, HandlerErrors, HandlerResponse, HandlerResponses, Harness, HarnessAgent, HarnessId, HarnessOwner, HarnessSession, HashMap, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, HighlightType, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, Item, ItemWithUserAccessLevel, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, LatestMessage, LeaveCallResponse, LeaveChannelData, LeaveChannelError, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallError, LeaveOrEndCallErrors, LeaveOrEndCallResponse, LeaveOrEndCallResponses, LinkShare, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListBotChannelsData, ListBotChannelsError, ListBotChannelsErrors, ListBotChannelsResponse, ListBotChannelsResponses, ListCompanyContactsData, ListCompanyContactsError, ListCompanyContactsErrors, ListCompanyContactsResponse, ListCompanyContactsResponses, ListCrmCommentsData, ListCrmCommentsError, ListCrmCommentsErrors, ListCrmCommentsResponse, ListCrmCommentsResponses, ListFavoritesData, ListFavoritesError, ListFavoritesErrors, ListFavoritesResponse, ListFavoritesResponses, ListHarnessAgentsData, ListHarnessAgentsError, ListHarnessAgentsErrors, ListHarnessAgentsResponse, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesError, ListHarnessesErrors, ListHarnessesResponse, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsError, ListHarnessSessionsErrors, ListHarnessSessionsResponse, ListHarnessSessionsResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponse, ListOccurrencesResponses, ListRemindersData, ListRemindersError, ListRemindersErrors, ListRemindersResponse, ListRemindersResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponse, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysError, ListUserApiKeysErrors, ListUserApiKeysResponse, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksError, ListWebhooksErrors, ListWebhooksResponse, ListWebhooksResponse2, ListWebhooksResponses, LocationResponseData, LocationResponseV3, MacroUserIdStr, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponse, MentionPreviewsResponses, Mentions, NewChannelAttachment, NotificationFilters, NotificationState, PairingDetails, Params, ParticipantRole, PatchBotRequest, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchMessageData, PatchMessageError, PatchMessageErrors, PatchMessageRequest, PatchMessageResponse, PatchMessageResponses, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfAnchorRequest, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PdfPlaceableCommentAnchorRequest, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostChannelMessagesData, PostChannelMessagesError, PostChannelMessagesErrors, PostChannelMessagesResponse, PostChannelMessagesResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessageData, PostMessageError, PostMessageErrors, PostMessageRequest, PostMessageResponse, PostMessageResponse2, PostMessageResponses, PostReactionData, PostReactionError, PostReactionErrors, PostReactionRequest, PostReactionResponse, PostReactionResponses, PostSoupAstRequest, PostSoupRequest, PostTypingData, PostTypingError, PostTypingErrors, PostTypingRequest, PostTypingResponse, PostTypingResponses, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresignedUrl, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyDefinition, PropertyFilter, PropertyInput, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, ReactionAction, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, Reminder, ReminderFilters, ReminderSchedule, RemindersList, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotError, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponse, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityError, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsError, RemoveParticipantsErrors, RemoveParticipantsRequest, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerError, RemovePinHandlerErrors, RemovePinHandlerResponse, RemovePinHandlerResponses, ReorderFavoritesData, ReorderFavoritesError, ReorderFavoritesErrors, ReorderFavoritesRequest, ReorderFavoritesResponses, ReorderPinRequest, ReorderPinsHandlerData, ReorderPinsHandlerError, ReorderPinsHandlerErrors, ReorderPinsHandlerResponse, ReorderPinsHandlerResponses, ReplaceCrmStagesRequest, RequestedHarnessScope, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, ResolveChannelMessageData, ResolveChannelMessageError, ResolveChannelMessageErrors, ResolveChannelMessageResponse, ResolveChannelMessageResponses, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RingStatus, RingStatusResponse, S3ObjectInfo, SaveBomPart, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SessionDeletedMetadata, SessionIdentity, SessionOpenedMetadata, SessionRenamedMetadata, SessionSettledMetadata, SessionStoppedMetadata, SetCompanyHiddenData, SetCompanyHiddenError, SetCompanyHiddenErrors, SetCompanyHiddenRequest, SetCompanyHiddenResponse, SetCompanyHiddenResponses, SetCompanyNameRequest, SetContactHiddenData, SetContactHiddenError, SetContactHiddenErrors, SetContactHiddenRequest, SetContactHiddenResponse, SetContactHiddenResponses, SetContactNameRequest, SetCrmCompanyNameData, SetCrmCompanyNameError, SetCrmCompanyNameErrors, SetCrmCompanyNameResponse, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameError, SetCrmContactNameErrors, SetCrmContactNameResponse, SetCrmContactNameResponses, SetDocumentTeamShareData, SetDocumentTeamShareError, SetDocumentTeamShareErrors, SetDocumentTeamShareRequest, SetDocumentTeamShareResponse, SetDocumentTeamShareResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetPropertyValue, SharedEmailFilter, SharePermissionV2, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmDomain, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupReminderReference, SoupReminderSchedule, SoupReminderSoupPropertiesField, SoupThreadInfo, SoupThreadReply, StarterDocumentsResponse, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, TagFilterMode, TaskFilters, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, Thread, ThreadOrigin, ThreadResponse, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TranscriptSegmentRequest, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingAction, UnthreadedPdfUuidRequest, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmTeamSettingsRequest, UpdateOperation, UpdateReminderData, UpdateReminderError, UpdateReminderErrors, UpdateReminderRequest, UpdateReminderResponse, UpdateReminderResponses, UpdateSharePermissionRequestV2, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UpsertHistoryHandlerData, UpsertHistoryHandlerError, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponse, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationError, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationRequest, UpsertUserDocumentViewLocationResponse, UpsertUserDocumentViewLocationResponses, UserApiKeyId, UserApiKeyInfo, UserApiKeysList, UserDocumentsResponse, UserDocumentViewLocation, UserDocumentViewLocationResponse, UserPinsResponse, UserViewsResponse, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenError, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponse, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookError, ValidateWebhookErrors, ValidateWebhookResponse, ValidateWebhookResponse2, ValidateWebhookResponses, Vec, View, ViewPatch, ViewsResponse, WaitingForInputMetadata, Webhook, WebhookEvent, WebhookFilter, WebhookScope, WebhookStatus, WebhookValidationTestEvent, WithCallId, WithChannelId, WithDocumentId, WithProjectId } from './types.gen';+export type { AccessLevel, ActiveCallsResponse, ActiveCallSummary, ActivityType, AddFavoriteData, AddFavoriteError, AddFavoriteErrors, AddFavoriteRequest, AddFavoriteResponse, AddFavoriteResponses, AddParticipantsData, AddParticipantsError, AddParticipantsErrors, AddParticipantsRequest, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerError, AddPinHandlerErrors, AddPinHandlerResponse, AddPinHandlerResponses, AddPinRequest, Agent, AgentActionId, AgentChannelScope, AgentMcpServer, AgentMcpServers, AgentSessionFilters, AgentSessionLifecycleEvent, Anchor, AnchorId, AnchorRequest, AnchorResponse, AnnotationIncrementalUpdate, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelContextMessage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelMessage, ApiChannelMessageKind, ApiChannelMessagesPage, ApiChannelParticipant, ApiChannelWithLatest, ApiCountedReaction, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiMessageAttachment, ApiMessageSender, ApiMessageSenderType, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, ApiResolvedChannelMessage, ApiThreadInfo, ApiThreadReply, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AttendeeResponseStatus, BasicDocument, BasicDocumentSubType, BomPart, Bot, BotChannel, BotChannelType, BotId, BotKind, BotOwner, 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, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData, CallRecordTranscriptSegment, CallStatus, CallTokenResponse, CallWebhookData, CallWebhookError, CallWebhookErrors, CallWebhookResponses, Channel, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelEventAttachment, ChannelFilters, ChannelJoinCodeResponse, ChannelMentionedMetadata, ChannelMessage, ChannelMessageAttachmentCreatedMetadata, ChannelMessageAttachmentRemovedMetadata, ChannelMessageDeletedMetadata, ChannelMessageFilters, ChannelMessagePatchedMetadata, ChannelMessagePostedMetadata, ChannelParticipant, ChannelParticipantAddedMetadata, ChannelParticipantRemovedMetadata, ChannelPreview, ChannelPreviewData, ChannelSender, ChannelSharePermission, ChannelThreadFilters, ChannelTopicEvent, ChannelType, ChannelUpdatedMetadata, ChannelWebhookRequest, ChannelWebhookResponse, ChannelWithParticipants, Chat, ChatFilters, CheckActiveCallData, CheckActiveCallError, CheckActiveCallErrors, CheckActiveCallResponse, CheckActiveCallResponses, ClaimedPairing, ClaimHarnessPairingData, ClaimHarnessPairingError, ClaimHarnessPairingErrors, ClaimHarnessPairingResponse, ClaimHarnessPairingResponses, ClaimPairingRequest, ClientOptions, CloudStorageItemType, CollabSurfaceResponse, CollabSurfaceTokenResponse, Comment, CommentThread, ConferenceProvider, CopyDocumentData, CopyDocumentError, CopyDocumentErrors, CopyDocumentQueryParams, CopyDocumentRequest, CopyDocumentResponse, CopyDocumentResponse2, CopyDocumentResponses, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentRequest, CreateAgentResponse, CreateAgentResponses, CreateAnchorData, CreateAnchorError, CreateAnchorErrors, CreateAnchorResponse, CreateAnchorResponses, CreateBotRequest, CreateBulkDocumentResponse, CreateBulkDocumentResponseData, CreateChannelData, CreateChannelError, CreateChannelErrors, CreateChannelRequest, CreateChannelResponse, CreateChannelResponse2, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotError, CreateChannelScopedBotErrors, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse, CreateChannelScopedBotResponse2, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenError, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponse, CreateCollabSurfaceTokenResponses, CreateCommentData, CreateCommentError, CreateCommentErrors, CreateCommentRequest, CreateCommentResponse, CreateCommentResponse2, CreateCommentResponses, CreateCrmCommentData, CreateCrmCommentError, CreateCrmCommentErrors, CreateCrmCommentRequest, CreateCrmCommentResponse, CreateCrmCommentResponses, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateInstructionsDocumentResponse, CreateInstructionsHandlerData, CreateInstructionsHandlerError, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponse, CreateInstructionsHandlerResponses, CreateMarkdownDocumentRequest, CreateMarkdownDocumentResponse, CreateMarkdownHandlerData, CreateMarkdownHandlerError, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponse, CreateMarkdownHandlerResponses, CreatePairingRequest, CreateProjectHandlerData, CreateProjectHandlerError, CreateProjectHandlerErrors, CreateProjectHandlerResponse, CreateProjectHandlerResponses, CreateProjectRequest, CreateProjectResponse, CreateReminderData, CreateReminderError, CreateReminderErrors, CreateReminderRequest, CreateReminderResponse, CreateReminderResponses, CreateSkillHandlerData, CreateSkillHandlerError, CreateSkillHandlerErrors, CreateSkillHandlerResponse, CreateSkillHandlerResponses, CreateSkillRequest, CreateSkillResponse, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmComment, CrmCommentEntityType, CrmCommentThread, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CrmThread, CustomSpeakerAssignment, DataType, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorInfo, DeleteAnchorResponse, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, DeleteCommentData, DeleteCommentError, DeleteCommentErrors, DeleteCommentRequest, DeleteCommentResponse, DeleteCommentResponse2, DeleteCommentResponses, DeleteCrmCommentData, DeleteCrmCommentError, DeleteCrmCommentErrors, DeleteCrmCommentResponse, DeleteCrmCommentResponses, DeleteCrmCommentResult, DeleteDocumentData, DeleteDocumentError, DeleteDocumentErrors, DeleteDocumentResponse, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionError, DeleteEntityMentionErrors, DeleteEntityMentionResponse, DeleteEntityMentionResponse2, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessError, DeleteHarnessErrors, DeleteHarnessResponse, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerError, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponse, DeleteHistoryHandlerResponses, DeleteMessageData, DeleteMessageError, DeleteMessageErrors, DeleteMessageQuery, DeleteMessageResponse, DeleteMessageResponses, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteReminderData, DeleteReminderError, DeleteReminderErrors, DeleteReminderResponse, DeleteReminderResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, DeleteThreadInfo, DeleteUnthreadedAnchorRequest, DeleteUnthreadedAnchorResponse, DeleteUnthreadedPdfAnchorRequest, DeleteUserApiKeyData, DeleteUserApiKeyError, DeleteUserApiKeyErrors, DeleteUserApiKeyResponse, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationError, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponse, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerError, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookError, DeleteWebhookErrors, DeleteWebhookResponse, DeleteWebhookResponses, DocumentBasic, DocumentContent, DocumentContentLocation, DocumentContentState, DocumentContentUploadedMetadata, DocumentCopiedMetadata, DocumentCreatedMetadata, DocumentDeletedMetadata, DocumentFilters, DocumentInteractionMetadata, DocumentMetadata, DocumentMetadataWithContent, DocumentPermissionsToken, DocumentPermissionsTokenRequest, DocumentPermissionsTokenResponse, DocumentPreview, DocumentPreviewData, DocumentPreviewDataSubType, DocumentPurgedMetadata, DocumentResponse, DocumentResponseMetadata, DocumentResponseMetadataWithContent, DocumentStorageServiceApiVersion, DocumentSubType, DocumentSyncContentUpdatedMetadata, DocumentTeamShareResponse, DocumentTopicEvent, DocumentUpdatedMetadata, EditAnchorData, EditAnchorError, EditAnchorErrors, EditAnchorRequest, EditAnchorResponse, EditAnchorResponse2, EditAnchorResponses, EditCallRecordData, EditCallRecordError, EditCallRecordErrors, EditCallRecordRequest, EditCallRecordResponse, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptError, EditCallTranscriptErrors, EditCallTranscriptRequest, EditCallTranscriptResponse, EditCallTranscriptResponses, EditCommentData, EditCommentError, EditCommentErrors, EditCommentRequest, EditCommentResponse, EditCommentResponse2, EditCommentResponses, EditCrmCommentData, EditCrmCommentError, EditCrmCommentErrors, EditCrmCommentRequest, EditCrmCommentResponse, EditCrmCommentResponses, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EntityFilters, EntityPermission, EntityPermissionResponse, EntityReference, EntityType, ErrorResponse, EventReminderOverride, EventReminders, EventStatus, EventTime, EventTransparency, EventType, EventVisibility, ExcludedDefaultView, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerError, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExcludeDefaultViewRequest, ExportDocumentData, ExportDocumentError, ExportDocumentErrors, ExportDocumentResponse, ExportDocumentResponse2, ExportDocumentResponses, Favorite, FavoriteEntityRef, FavoritesList, FileSystemNodeWithIds, FileType, FileTypeUpdate, FolderItem, ForeignEntity, ForeignEntityFilters, GenericErrorResponse, GenericResponse, GenericSuccessResponse, GetActiveCallsData, GetActiveCallsError, GetActiveCallsErrors, GetActiveCallsResponse, GetActiveCallsResponses, GetActivityData, GetActivityError, GetActivityErrors, GetActivityResponse, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesError, GetAttachmentReferencesErrors, GetAttachmentReferencesResponse, GetAttachmentReferencesResponse2, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewError, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewRequest, GetBatchCallRecordPreviewResponse, GetBatchCallRecordPreviewResponse2, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewError, GetBatchChannelPreviewErrors, GetBatchChannelPreviewRequest, GetBatchChannelPreviewResponse, GetBatchChannelPreviewResponse2, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerError, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponse, GetBatchPreviewHandlerResponses, GetBatchPreviewRequest, GetBatchPreviewResponse, GetBatchProjectPreviewData, GetBatchProjectPreviewError, GetBatchProjectPreviewErrors, GetBatchProjectPreviewRequest, GetBatchProjectPreviewResponse, GetBatchProjectPreviewResponse2, GetBatchProjectPreviewResponses, GetCallRecordData, GetCallRecordError, GetCallRecordErrors, GetCallRecordResponse, GetCallRecordResponses, GetChannelAttachmentsData, GetChannelAttachmentsError, GetChannelAttachmentsErrors, GetChannelAttachmentsResponse, GetChannelAttachmentsResponses, GetChannelData, GetChannelError, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkError, GetChannelJoinLinkErrors, GetChannelJoinLinkResponse, GetChannelJoinLinkResponses, GetChannelMessagesCatchUpData, GetChannelMessagesCatchUpError, GetChannelMessagesCatchUpErrors, GetChannelMessagesCatchUpResponse, GetChannelMessagesCatchUpResponses, GetChannelMessagesData, GetChannelMessagesError, GetChannelMessagesErrors, GetChannelMessagesResponse, GetChannelMessagesResponses, GetChannelParticipantsData, GetChannelParticipantsError, GetChannelParticipantsErrors, GetChannelParticipantsResponse, GetChannelParticipantsResponses, GetChannelResponse, GetChannelResponses, GetChannelsData, GetChannelsError, GetChannelsErrors, GetChannelsResponse, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceError, GetCollabSurfaceErrors, GetCollabSurfaceResponse, GetCollabSurfaceResponses, GetCompanyData, GetCompanyError, GetCompanyErrors, GetCompanyResponse, GetCompanyResponses, GetContactByEmailData, GetContactByEmailError, GetContactByEmailErrors, GetContactByEmailResponse, GetContactByEmailResponse2, GetContactByEmailResponses, GetContactData, GetContactError, GetContactErrors, GetContactResponse, GetContactResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsError, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponse, GetCrmTeamSettingsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, GetDocumentCommentsData, GetDocumentCommentsError, GetDocumentCommentsErrors, GetDocumentCommentsResponse, GetDocumentCommentsResponses, GetDocumentData, GetDocumentError, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsError, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponse, GetDocumentGithubPullRequestsResponses, GetDocumentKeyResponse, GetDocumentKeyResponseData, GetDocumentListHandlerData, GetDocumentListHandlerError, GetDocumentListHandlerErrors, GetDocumentListHandlerResponse, GetDocumentListHandlerResponses, GetDocumentListResult, GetDocumentLocationV3Data, GetDocumentLocationV3Error, GetDocumentLocationV3Errors, GetDocumentLocationV3Response, GetDocumentLocationV3Responses, GetDocumentPermissionsResponseDataV2, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenError, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponse, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Error, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Response, GetDocumentPermissionsV2Responses, GetDocumentProcessingResult, GetDocumentProcessingResultData, GetDocumentProcessingResultError, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponse, GetDocumentProcessingResultResponse2, GetDocumentProcessingResultResponses, GetDocumentResponse, GetDocumentResponse2, GetDocumentResponseData, GetDocumentResponses, GetDocumentSearchResponse, GetDocumentShortIdData, GetDocumentShortIdError, GetDocumentShortIdErrors, GetDocumentShortIdResponse, GetDocumentShortIdResponses, GetDocumentsResponse, GetDocumentTeamShareData, GetDocumentTeamShareError, GetDocumentTeamShareErrors, GetDocumentTeamShareResponse, GetDocumentTeamShareResponses, GetDocumentUserAccessLevelResponse, GetDocumentVersionData, GetDocumentVersionError, GetDocumentVersionErrors, GetDocumentVersionResponse, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerError, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponse, GetDocumentViewsHandlerResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponse, GetEntityPermissionResponses, GetForeignEntityData, GetForeignEntityError, GetForeignEntityErrors, GetForeignEntityResponse, GetForeignEntityResponses, GetHarnessPairingData, GetHarnessPairingError, GetHarnessPairingErrors, GetHarnessPairingResponse, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerError, GetHistoryHandlerErrors, GetHistoryHandlerResponse, GetHistoryHandlerResponses, GetInstructionsDocumentResponse, GetInstructionsHandlerData, GetInstructionsHandlerError, GetInstructionsHandlerErrors, GetInstructionsHandlerResponse, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupError, GetItemsSoupErrors, GetItemsSoupResponse, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerError, GetLocationHandlerErrors, GetLocationHandlerResponse, GetLocationHandlerResponses, GetMessageWithContextData, GetMessageWithContextError, GetMessageWithContextErrors, GetMessageWithContextResponse, GetMessageWithContextResponse2, GetMessageWithContextResponses, GetOrCreateAction, GetOrCreateCallData, GetOrCreateCallError, GetOrCreateCallErrors, GetOrCreateCallResponse, GetOrCreateCallResponses, GetOrCreateChannelResponse, GetOrCreateDmData, GetOrCreateDmError, GetOrCreateDmErrors, GetOrCreateDmRequest, GetOrCreateDmResponse, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateError, GetOrCreatePrivateErrors, GetOrCreatePrivateRequest, GetOrCreatePrivateResponse, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerError, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponse, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerError, GetPinsHandlerErrors, GetPinsHandlerResponse, GetPinsHandlerResponses, GetPinsResponse, GetProjectContentHandlerData, GetProjectContentHandlerError, GetProjectContentHandlerErrors, GetProjectContentHandlerResponse, GetProjectContentHandlerResponses, GetProjectContentResponse, GetProjectHandlerData, GetProjectHandlerError, GetProjectHandlerErrors, GetProjectHandlerResponse, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Error, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Response, GetProjectPermissionsV2Responses, GetProjectResponse, GetProjectResponseData, GetProjectsHandlerData, GetProjectsHandlerError, GetProjectsHandlerErrors, GetProjectsHandlerResponse, GetProjectsHandlerResponses, GetProjectsResponse, GetProjectUserAccessLevelData, GetProjectUserAccessLevelError, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponse, GetProjectUserAccessLevelResponses, GetReminderData, GetReminderError, GetReminderErrors, GetReminderResponse, GetReminderResponses, GetRingStatusData, GetRingStatusError, GetRingStatusErrors, GetRingStatusResponse, GetRingStatusResponses, GetSelfBotData, GetSelfBotError, GetSelfBotErrors, GetSelfBotResponse, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessError, GetSelfHarnessErrors, GetSelfHarnessResponse, GetSelfHarnessResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, GetThreadRepliesData, GetThreadRepliesError, GetThreadRepliesErrors, GetThreadRepliesResponse, GetThreadRepliesResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerError, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponse, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationError, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponse, GetUserDocumentViewLocationResponses, GetUserHistoryResponse, GetViewsHandlerData, GetViewsHandlerError, GetViewsHandlerErrors, GetViewsHandlerResponse, GetViewsHandlerResponses, GetWebhookData, GetWebhookError, GetWebhookErrors, GetWebhookResponse, GetWebhookResponses, GithubPullRequest, GithubPullRequestCheckRun, GithubPullRequestComment, GithubPullRequestsResponse, GroupedInitialParams, GroupedPageParams, GroupedSoupGroupPage, GroupedSoupInitialPage, GroupedSoupPage, GroupedSoupSort, HandlerData, HandlerError, HandlerErrors, HandlerResponse, HandlerResponses, Harness, HarnessAgent, HarnessId, HarnessOwner, HarnessSession, HashMap, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, HighlightType, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, Item, ItemWithUserAccessLevel, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, LatestMessage, LeaveCallResponse, LeaveChannelData, LeaveChannelError, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallError, LeaveOrEndCallErrors, LeaveOrEndCallResponse, LeaveOrEndCallResponses, LinkShare, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListBotChannelsData, ListBotChannelsError, ListBotChannelsErrors, ListBotChannelsResponse, ListBotChannelsResponses, ListCompanyContactsData, ListCompanyContactsError, ListCompanyContactsErrors, ListCompanyContactsResponse, ListCompanyContactsResponses, ListCrmCommentsData, ListCrmCommentsError, ListCrmCommentsErrors, ListCrmCommentsResponse, ListCrmCommentsResponses, ListFavoritesData, ListFavoritesError, ListFavoritesErrors, ListFavoritesResponse, ListFavoritesResponses, ListHarnessAgentsData, ListHarnessAgentsError, ListHarnessAgentsErrors, ListHarnessAgentsResponse, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesError, ListHarnessesErrors, ListHarnessesResponse, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsError, ListHarnessSessionsErrors, ListHarnessSessionsResponse, ListHarnessSessionsResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponse, ListOccurrencesResponses, ListRemindersData, ListRemindersError, ListRemindersErrors, ListRemindersResponse, ListRemindersResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponse, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysError, ListUserApiKeysErrors, ListUserApiKeysResponse, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksError, ListWebhooksErrors, ListWebhooksResponse, ListWebhooksResponse2, ListWebhooksResponses, LocationResponseData, LocationResponseV3, MacroUserIdStr, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponse, MentionPreviewsResponses, Mentions, NewChannelAttachment, NotificationFilters, NotificationState, PairingDetails, Params, ParticipantRole, PatchBotRequest, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchMessageData, PatchMessageError, PatchMessageErrors, PatchMessageRequest, PatchMessageResponse, PatchMessageResponses, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfAnchorRequest, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PdfPlaceableCommentAnchorRequest, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostChannelMessagesData, PostChannelMessagesError, PostChannelMessagesErrors, PostChannelMessagesResponse, PostChannelMessagesResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessageData, PostMessageError, PostMessageErrors, PostMessageRequest, PostMessageResponse, PostMessageResponse2, PostMessageResponses, PostReactionData, PostReactionError, PostReactionErrors, PostReactionRequest, PostReactionResponse, PostReactionResponses, PostSoupAstRequest, PostSoupRequest, PostTypingData, PostTypingError, PostTypingErrors, PostTypingRequest, PostTypingResponse, PostTypingResponses, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresignedUrl, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyDefinition, PropertyFilter, PropertyInput, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, ReactionAction, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, Reminder, ReminderFilters, ReminderSchedule, RemindersList, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotError, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponse, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityError, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsError, RemoveParticipantsErrors, RemoveParticipantsRequest, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerError, RemovePinHandlerErrors, RemovePinHandlerResponse, RemovePinHandlerResponses, ReorderFavoritesData, ReorderFavoritesError, ReorderFavoritesErrors, ReorderFavoritesRequest, ReorderFavoritesResponses, ReorderPinRequest, ReorderPinsHandlerData, ReorderPinsHandlerError, ReorderPinsHandlerErrors, ReorderPinsHandlerResponse, ReorderPinsHandlerResponses, ReplaceCrmStagesRequest, RequestedHarnessScope, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, ResolveChannelMessageData, ResolveChannelMessageError, ResolveChannelMessageErrors, ResolveChannelMessageResponse, ResolveChannelMessageResponses, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RingStatus, RingStatusResponse, S3ObjectInfo, SaveBomPart, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SessionDeletedMetadata, SessionIdentity, SessionOpenedMetadata, SessionRenamedMetadata, SessionSettledMetadata, SessionStoppedMetadata, SetCompanyHiddenData, SetCompanyHiddenError, SetCompanyHiddenErrors, SetCompanyHiddenRequest, SetCompanyHiddenResponse, SetCompanyHiddenResponses, SetCompanyNameRequest, SetContactHiddenData, SetContactHiddenError, SetContactHiddenErrors, SetContactHiddenRequest, SetContactHiddenResponse, SetContactHiddenResponses, SetContactNameRequest, SetCrmCompanyNameData, SetCrmCompanyNameError, SetCrmCompanyNameErrors, SetCrmCompanyNameResponse, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameError, SetCrmContactNameErrors, SetCrmContactNameResponse, SetCrmContactNameResponses, SetDocumentTeamShareData, SetDocumentTeamShareError, SetDocumentTeamShareErrors, SetDocumentTeamShareRequest, SetDocumentTeamShareResponse, SetDocumentTeamShareResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetPropertyValue, SharedEmailFilter, SharePermissionV2, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmDomain, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupReminderReference, SoupReminderSchedule, SoupReminderSoupPropertiesField, SoupThreadInfo, SoupThreadReply, StarterDocumentsResponse, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, TagFilterMode, TaskFilters, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, Thread, ThreadOrigin, ThreadResponse, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TranscriptSegmentRequest, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingAction, UnthreadedPdfUuidRequest, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmTeamSettingsRequest, UpdateOperation, UpdateReminderData, UpdateReminderError, UpdateReminderErrors, UpdateReminderRequest, UpdateReminderResponse, UpdateReminderResponses, UpdateSharePermissionRequestV2, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UpsertHistoryHandlerData, UpsertHistoryHandlerError, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponse, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationError, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationRequest, UpsertUserDocumentViewLocationResponse, UpsertUserDocumentViewLocationResponses, UserApiKeyId, UserApiKeyInfo, UserApiKeysList, UserDocumentsResponse, UserDocumentViewLocation, UserDocumentViewLocationResponse, UserPinsResponse, UserViewsResponse, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenError, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponse, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookError, ValidateWebhookErrors, ValidateWebhookResponse, ValidateWebhookResponse2, ValidateWebhookResponses, Vec, View, ViewPatch, ViewsResponse, WaitingForInputMetadata, Webhook, WebhookEvent, WebhookFilter, WebhookScope, WebhookStatus, WebhookValidationTestEvent, WithCallId, WithChannelId, WithDocumentId, WithProjectId } from './types.gen';diff --git a/packages/sdk/generated/storage/types.gen.ts b/packages/sdk/generated/storage/types.gen.tsindex 791efb3480..a34b2619f0 100644--- a/packages/sdk/generated/storage/types.gen.ts+++ b/packages/sdk/generated/storage/types.gen.ts@@ -174,6 +174,27 @@ export type AgentMcpServers = {servers: Array<AgentMcpServer>;};+/**+ * Filters for agent sessions.+ */+export type AgentSessionFilters = {+ /**+ * Agent session ids to filter by. Empty to include all accessible sessions.+ */+ ids?: Array<string>;+ /**+ * Opt this query into agent sessions at all. Agent sessions are off by+ * default — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].+ * Asking for specific `ids` or `owners` also opts in.+ */+ include?: boolean;+ /**+ * Filter by session owner. Examples: ['macro|[email protected]']. Empty to+ * include every owner.+ */+ owners?: Array<string>;+};+/*** Events publishable to [`MacroAgentSessionLifecycleTopic`].*@@ -802,6 +823,12 @@ export type ApiCountedReaction = {* Wire-format entity filter AST accepted by soup AST endpoints.*/export type ApiEntityFilterAst = {+ /**+ * Filters applied to agent sessions (wire key `asf`). Like reminders,+ * empty/omitted returns **no** agent sessions: they are opt-in, so the+ * caller must send `inc`, an id, or an owner to get any.+ */+ asf?: unknown;/*** filters applied to canonical calendar events*/@@ -5035,6 +5062,10 @@ export type EnsureCollabSurfaceRequest = {* a bundle of all of the filters for each entity type*/export type EntityFilters = {+ /**+ * the bundled [AgentSessionFilters]+ */+ agent_session_filters?: AgentSessionFilters;/*** the bundled [CalendarEventFilters]*/@@ -7627,6 +7658,61 @@ export type SimpleMention = {entity_type: string;};+/**+ * An agent session as displayed in Soup.+ *+ * Mirrors [`crate::chat::SoupChat`]: an agent session is the coding-agent+ * counterpart of a chat, so it carries the same identity, ownership, and+ * recency fields plus the session's last known status.+ */+export type SoupAgentSessionSoupPropertiesField = {+ /**+ * Properties attached to the entity.+ */+ properties: Array<SoupProperty>;+} & {+ /**+ * The bot running this session+ */+ botId: string;+ /**+ * The time the session was created+ */+ createdAt: string;+ /**+ * The agent session uuid+ */+ id: string;+ /**+ * The user-facing name of the session+ */+ name: string;+ /**+ * Who the session belongs to+ */+ ownerId: string;+ /**+ * The session's last known status.+ *+ * `no_messages` until the first system event arrives, `disconnected` if+ * the connection dropped without a clean close, otherwise the wire name+ * of the most recent system event (for example `session/end`).+ */+ status: string;+ /**+ * The channel thread the session was opened from, when any+ */+ threadId?: string | null;+ /**+ * The time the session was last modified+ */+ updatedAt: string;+ /**+ * The time the session was last viewed by the requesting user+ */+ viewedAt?: string | null;+};+/*** API representation of a soup item with its per-viewer enrichments.*/@@ -8441,6 +8527,12 @@ export type SoupItem = {*/data: SoupReminderSoupPropertiesField;tag: 'reminder';+} | {+ /**+ * Agent session item.+ */+ data: SoupAgentSessionSoupPropertiesField;+ tag: 'agentSession';};/**diff --git a/packages/sdk/specs/agent-harness.json b/packages/sdk/specs/agent-harness.jsonindex 9f079d8c48..6a2ae69114 100644--- a/packages/sdk/specs/agent-harness.json+++ b/packages/sdk/specs/agent-harness.json@@ -228,6 +228,66 @@}}},+ "/agent-sessions/preview": {+ "post": {+ "tags": ["agent-sessions"],+ "summary": "Preview a batch of agent sessions for rendering chips.",+ "description": "No per-id access extractor: a chip has to render for a session the caller\ncannot open, so access is answered per id in the body rather than\nenforced on the request. The caller learns the fields a chip shows for\nsessions they may view, and only existence for the rest.",+ "operationId": "preview_agent_sessions",+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PreviewAgentSessionsRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "description": "",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PreviewAgentSessionsResponse"+ }+ }+ }+ },+ "400": {+ "description": "more than the maximum number of session ids",+ "content": {+ "text/plain": {+ "schema": {+ "type": "string"+ }+ }+ }+ },+ "401": {+ "description": "",+ "content": {+ "text/plain": {+ "schema": {+ "type": "string"+ }+ }+ }+ },+ "500": {+ "description": "",+ "content": {+ "text/plain": {+ "schema": {+ "type": "string"+ }+ }+ }+ }+ }+ }+ },"/agent-sessions/{session_id}": {"get": {"tags": ["agent-sessions"],@@ -1054,6 +1114,115 @@}}},+ "AgentSessionPreviewData": {+ "type": "object",+ "description": "The fields a chip renders for a session the caller may view.\n\nClients deserialize this, so both derives are used.",+ "required": [+ "id",+ "name",+ "ownerId",+ "botId",+ "status",+ "createdAt",+ "modifiedAt"+ ],+ "properties": {+ "botId": {+ "type": "string",+ "format": "uuid",+ "description": "The bot running the agent."+ },+ "createdAt": {+ "type": "string",+ "format": "date-time",+ "description": "When the session was created."+ },+ "id": {+ "type": "string",+ "format": "uuid",+ "description": "The session id."+ },+ "modifiedAt": {+ "type": "string",+ "format": "date-time",+ "description": "When the session was last modified."+ },+ "name": {+ "type": "string",+ "description": "User-facing session name."+ },+ "ownerId": {+ "type": "string",+ "description": "The user who owns the session."+ },+ "status": {+ "$ref": "#/components/schemas/SessionStatusDto",+ "description": "The session's last known status."+ }+ }+ },+ "AgentSessionPreviewDto": {+ "oneOf": [+ {+ "allOf": [+ {+ "$ref": "#/components/schemas/AgentSessionPreviewData",+ "description": "The caller may view the session."+ },+ {+ "type": "object",+ "required": ["type"],+ "properties": {+ "type": {+ "type": "string",+ "enum": ["access"]+ }+ }+ }+ ],+ "description": "The caller may view the session."+ },+ {+ "allOf": [+ {+ "$ref": "#/components/schemas/WithAgentSessionId",+ "description": "The session exists but the caller holds no grant on it."+ },+ {+ "type": "object",+ "required": ["type"],+ "properties": {+ "type": {+ "type": "string",+ "enum": ["no_access"]+ }+ }+ }+ ],+ "description": "The session exists but the caller holds no grant on it."+ },+ {+ "allOf": [+ {+ "$ref": "#/components/schemas/WithAgentSessionId",+ "description": "No session with this id exists."+ },+ {+ "type": "object",+ "required": ["type"],+ "properties": {+ "type": {+ "type": "string",+ "enum": ["does_not_exist"]+ }+ }+ }+ ],+ "description": "No session with this id exists."+ }+ ],+ "description": "What one requested id resolved to, on the wire.\n\nTagged the same way the chat and document preview endpoints tag theirs\n(`type` in `access` / `no_access` / `does_not_exist`), so a client that\nrenders those chips can render this one with the same branch.\n\nClients deserialize this, so both derives are used."+ },"AgentSessionQueueResponse": {"type": "object","description": "Response body for a session's queue: everything waiting, oldest first.\n\nA wrapper rather than a bare array so that anything which is about the\nresponse rather than about an entry has somewhere to go later without\nbreaking every client.",@@ -1481,6 +1650,35 @@"description": "Harness names accepted by the model discovery endpoint.","enum": ["in-memory", "cursor", "macrod"]},+ "PreviewAgentSessionsRequest": {+ "type": "object",+ "description": "Request body for `POST /agent-sessions/preview`.\n\nClients serialize this, so both derives are used.",+ "required": ["sessionIds"],+ "properties": {+ "sessionIds": {+ "type": "array",+ "items": {+ "type": "string",+ "format": "uuid"+ },+ "description": "The sessions to preview. Duplicates are collapsed server-side; at most\n[`MAX_PREVIEW_SESSION_IDS`](crate::domain::model::MAX_PREVIEW_SESSION_IDS)\ndistinct ids per request."+ }+ }+ },+ "PreviewAgentSessionsResponse": {+ "type": "object",+ "description": "Response body for `POST /agent-sessions/preview`: one entry per distinct\nrequested id, in no particular order.\n\nClients deserialize this, so both derives are used.",+ "required": ["previews"],+ "properties": {+ "previews": {+ "type": "array",+ "items": {+ "$ref": "#/components/schemas/AgentSessionPreviewDto"+ },+ "description": "What the caller may see of each requested session."+ }+ }+ },"QueuedActionDto": {"type": "object","description": "One action waiting in a session's queue.\n\nClients deserialize this, so both derives are used.",@@ -1596,6 +1794,18 @@}],"description": "Transport representation of a session's status, mirroring\n[`SessionStatus`]."+ },+ "WithAgentSessionId": {+ "type": "object",+ "description": "Just a session id, for the preview variants that carry nothing else.\n\nClients deserialize this, so both derives are used.",+ "required": ["id"],+ "properties": {+ "id": {+ "type": "string",+ "format": "uuid",+ "description": "The session id."+ }+ }}},"securitySchemes": {diff --git a/packages/sdk/specs/search.json b/packages/sdk/specs/search.jsonindex ff38d16210..815a639a14 100644--- a/packages/sdk/specs/search.json+++ b/packages/sdk/specs/search.json@@ -173,6 +173,30 @@},"components": {"schemas": {+ "AgentSessionFilters": {+ "type": "object",+ "description": "Filters for agent sessions.",+ "properties": {+ "ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Agent session ids to filter by. Empty to include all accessible sessions."+ },+ "include": {+ "type": "boolean",+ "description": "Opt this query into agent sessions at all. Agent sessions are off by\ndefault — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].\nAsking for specific `ids` or `owners` also opts in."+ },+ "owners": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Filter by session owner. Examples: ['macro|[email protected]']. Empty to\ninclude every owner."+ }+ }+ },"CalendarEventFilters": {"type": "object","description": "Filters for canonical calendar-event entities.",@@ -2022,6 +2046,10 @@"type": "object","description": "a bundle of all of the filters for each entity type","properties": {+ "agent_session_filters": {+ "$ref": "#/components/schemas/AgentSessionFilters",+ "description": "the bundled [AgentSessionFilters]"+ },"calendar_event_filters": {"$ref": "#/components/schemas/CalendarEventFilters","description": "the bundled [CalendarEventFilters]"diff --git a/packages/sdk/specs/storage.json b/packages/sdk/specs/storage.jsonindex 357adc5241..0a9317c70b 100644--- a/packages/sdk/specs/storage.json+++ b/packages/sdk/specs/storage.json@@ -12982,6 +12982,30 @@],"description": "Which Pipedream MCP servers an agent's sessions are handed.\n\nOne value for the whole choice, so a selection can never travel without\nits scope or a scope without its selection. Serialized with a `scope` tag,\nwhich the generated TypeScript sees as a discriminated union."},+ "AgentSessionFilters": {+ "type": "object",+ "description": "Filters for agent sessions.",+ "properties": {+ "ids": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Agent session ids to filter by. Empty to include all accessible sessions."+ },+ "include": {+ "type": "boolean",+ "description": "Opt this query into agent sessions at all. Agent sessions are off by\ndefault — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].\nAsking for specific `ids` or `owners` also opts in."+ },+ "owners": {+ "type": "array",+ "items": {+ "type": "string"+ },+ "description": "Filter by session owner. Examples: ['macro|[email protected]']. Empty to\ninclude every owner."+ }+ }+ },"AgentSessionLifecycleEvent": {"oneOf": [{@@ -14052,6 +14076,9 @@"type": "object","description": "Wire-format entity filter AST accepted by soup AST endpoints.","properties": {+ "asf": {+ "description": "Filters applied to agent sessions (wire key `asf`). Like reminders,\nempty/omitted returns **no** agent sessions: they are opt-in, so the\ncaller must send `inc`, an id, or an owner to get any."+ },"calf": {"description": "filters applied to canonical calendar events"},@@ -20145,6 +20172,10 @@"type": "object","description": "a bundle of all of the filters for each entity type","properties": {+ "agent_session_filters": {+ "$ref": "#/components/schemas/AgentSessionFilters",+ "description": "the bundled [AgentSessionFilters]"+ },"calendar_event_filters": {"$ref": "#/components/schemas/CalendarEventFilters","description": "the bundled [CalendarEventFilters]"@@ -24922,6 +24953,81 @@}}},+ "SoupAgentSession_SoupPropertiesField": {+ "allOf": [+ {+ "type": "object",+ "description": "Property fields that can be flattened into property-bearing Soup items.",+ "required": ["properties"],+ "properties": {+ "properties": {+ "type": "array",+ "items": {+ "$ref": "#/components/schemas/SoupProperty"+ },+ "description": "Properties attached to the entity."+ }+ }+ },+ {+ "type": "object",+ "required": [+ "id",+ "name",+ "ownerId",+ "botId",+ "status",+ "createdAt",+ "updatedAt"+ ],+ "properties": {+ "botId": {+ "type": "string",+ "format": "uuid",+ "description": "The bot running this session"+ },+ "createdAt": {+ "type": "string",+ "format": "date-time",+ "description": "The time the session was created"+ },+ "id": {+ "type": "string",+ "format": "uuid",+ "description": "The agent session uuid"+ },+ "name": {+ "type": "string",+ "description": "The user-facing name of the session"+ },+ "ownerId": {+ "type": "string",+ "description": "Who the session belongs to"+ },+ "status": {+ "type": "string",+ "description": "The session's last known status.\n\n`no_messages` until the first system event arrives, `disconnected` if\nthe connection dropped without a clean close, otherwise the wire name\nof the most recent system event (for example `session/end`)."+ },+ "threadId": {+ "type": ["string", "null"],+ "format": "uuid",+ "description": "The channel thread the session was opened from, when any"+ },+ "updatedAt": {+ "type": "string",+ "format": "date-time",+ "description": "The time the session was last modified"+ },+ "viewedAt": {+ "type": ["string", "null"],+ "format": "date-time",+ "description": "The time the session was last viewed by the requesting user"+ }+ }+ }+ ],+ "description": "An agent session as displayed in Soup.\n\nMirrors [`crate::chat::SoupChat`]: an agent session is the coding-agent\ncounterpart of a chat, so it carries the same identity, ownership, and\nrecency fields plus the session's last known status."+ },"SoupApiItem": {"allOf": [{@@ -26138,6 +26244,21 @@"enum": ["reminder"]}}+ },+ {+ "type": "object",+ "description": "Agent session item.",+ "required": ["data", "tag"],+ "properties": {+ "data": {+ "$ref": "#/components/schemas/SoupAgentSession_SoupPropertiesField",+ "description": "Agent session item."+ },+ "tag": {+ "type": "string",+ "enum": ["agentSession"]+ }+ }}],"description": "A single item in the Soup feed."diff --git a/packages/sdk/src/coverage/skipped.ts b/packages/sdk/src/coverage/skipped.tsindex 14a287509f..6f6dc128ec 100644--- a/packages/sdk/src/coverage/skipped.ts+++ b/packages/sdk/src/coverage/skipped.ts@@ -25,6 +25,7 @@ import type { Sdk as UnfurlSdk } from '../../generated/unfurl/sdk.gen';export const agentHarnessExcluded = ['loadAgentModelsHandler',+ 'previewAgentSessions',] as const satisfies readonly (keyof AgentHarnessSdk)[];export const agentHarnessBacklog =diff --git a/services/agent_harness_service/src/api/swagger.rs b/services/agent_harness_service/src/api/swagger.rsindex 6ef46c66fe..cbf4d60315 100644--- a/services/agent_harness_service/src/api/swagger.rs+++ b/services/agent_harness_service/src/api/swagger.rs@@ -7,11 +7,12 @@ use agent_harness::inbound::model_load::{use agent_runtime_protocol::domain::action::{AgentAction, AgentActionId};use agent_session::domain::model::{SandboxSize, SessionBot};use agent_session::inbound::axum_router::{- self, AgentSessionLogEntryDto, AgentSessionLogResponse, AgentSessionQueueResponse,- AgentSessionResponse, ControlRequest, ControlResponse, ControlStatusDto,- CreateAgentSessionRequest, CreateAgentSessionResponse, CreateSessionThread,- EditQueuedActionRequest, LogDirectionDto, LogFrameDto, QueuedActionDto,- RenameAgentSessionRequest, SandboxSizeBody, SessionStatusDto,+ self, AgentSessionLogEntryDto, AgentSessionLogResponse, AgentSessionPreviewData,+ AgentSessionPreviewDto, AgentSessionQueueResponse, AgentSessionResponse, ControlRequest,+ ControlResponse, ControlStatusDto, CreateAgentSessionRequest, CreateAgentSessionResponse,+ CreateSessionThread, EditQueuedActionRequest, LogDirectionDto, LogFrameDto,+ PreviewAgentSessionsRequest, PreviewAgentSessionsResponse, QueuedActionDto,+ RenameAgentSessionRequest, SandboxSizeBody, SessionStatusDto, WithAgentSessionId,};use utoipa::{Modify, OpenApi,@@ -38,6 +39,7 @@ impl Modify for SecurityAddon {paths(axum_router::create_agent_session_handler,axum_router::get_agent_session_handler,+ axum_router::preview_agent_sessions_handler,axum_router::rename_agent_session_handler,axum_router::get_agent_session_log_handler,axum_router::control_agent_session_handler,@@ -63,6 +65,11 @@ impl Modify for SecurityAddon {AgentAction,AgentActionId,AgentSessionResponse,+ PreviewAgentSessionsRequest,+ PreviewAgentSessionsResponse,+ AgentSessionPreviewDto,+ AgentSessionPreviewData,+ WithAgentSessionId,RenameAgentSessionRequest,SessionStatusDto,AgentSessionLogResponse,diff --git a/services/document_storage_service/src/api/graphql_soup.rs b/services/document_storage_service/src/api/graphql_soup.rsindex fc82308aa9..481a302eb3 100644--- a/services/document_storage_service/src/api/graphql_soup.rs+++ b/services/document_storage_service/src/api/graphql_soup.rs@@ -12,6 +12,7 @@ use axum::{routing::get,};use axum_extra::extract::Cached;+use bots::outbound::pg_bots_repo::PgBotsRepo;use complete_graph::GraphqlRequestParts;use graphql_soup::soup_item_loader;use macro_authorization::{@@ -166,6 +167,9 @@ fn insert_graphql_context_data(data.insert(state.soup_router_state.email_service());data.insert(state.entity_access_service.clone());data.insert(soup_item_loader);+ data.insert(complete_graph::agent_session_bot_loader(PgBotsRepo::new(+ state.readonly_db.0.clone(),+ )));data.insert(complete_graph::entity_properties_loader(macro_user_id.clone(),property_reader,diff --git a/static_assets/schema.graphql b/static_assets/schema.graphqlindex dc8c267ab6..40c98bfe95 100644--- a/static_assets/schema.graphql+++ b/static_assets/schema.graphql@@ -487,6 +487,63 @@ type GraphqlActivityUnknownAction {payload: JSON}+"""+The two operands of a recursive `AgentSessionFilterExpr` binary expression.+"""+input GraphqlAgentSessionBinaryExpr {+ """+ Left expression.+ """+ left: GraphqlAgentSessionExpr!+ """+ Right expression.+ """+ right: GraphqlAgentSessionExpr!+}++"""+A recursive `AgentSessionFilterExpr` filter expression.+"""+input GraphqlAgentSessionExpr @oneOf {+ """+ Both expressions must match.+ """+ and: GraphqlAgentSessionBinaryExpr+ """+ Either expression may match.+ """+ or: GraphqlAgentSessionBinaryExpr+ """+ Negate an expression.+ """+ not: GraphqlAgentSessionExpr+ """+ Match a literal.+ """+ literal: GraphqlAgentSessionLiteral+}++"""+GraphQL input representing the agent session literal.+"""+input GraphqlAgentSessionLiteral @oneOf {+ """+ Opt this query into agent sessions at all. Agent sessions are off by+ default, so without this (or an `id`/`owner`) Soup omits them entirely.+ Must be `true`; there is no literal for excluding agent sessions, that+ is the default.+ """+ include: Boolean+ """+ The id option.+ """+ id: ID+ """+ The owner option.+ """+ owner: String+}+"""Metadata for an AI response."""@@ -1856,6 +1913,10 @@ input GraphqlEntityFilterAst {"""reminderFilter: GraphqlReminderExpr"""+ The agent session filter to apply.+ """+ agentSessionFilter: GraphqlAgentSessionExpr+ """The properties filter to apply."""propertiesFilter: GraphqlFilterPropertiesExpr@@ -3446,6 +3507,24 @@ type GraphqlSelectOptionPropertyValue {optionIds: [ID!]!}+"""+Bot fields presented through an agent-session edge.+"""+type GraphqlSessionBot {+ """+ Stable global bot identity.+ """+ id: ID!+ """+ Bot display name.+ """+ name: String!+ """+ Optional bot avatar URL.+ """+ avatarUrl: String+}+"""A typed value accepted when setting an entity property."""@@ -3584,6 +3663,99 @@ enum GraphqlSortDirection {DESC}+"""+GraphQL representation of the soup agent session.+"""+type GraphqlSoupAgentSession implements GraphqlSoupEntity {+ """+ The unique identifier.+ """+ id: ID!+ """+ Canonical entity kind.+ """+ entityType: GraphqlSoupEntityType!+ """+ Server-only projection facts are unavailable for agent sessions.+ """+ cacheProjection: SoupCacheProjection+ """+ User-visible display name.+ """+ displayName: String+ """+ Common agent session metadata.++ `parent` is absent: a session is reachable through the channel thread+ it was opened from, but it is not contained by it the way a chat is+ contained by its project.+ """+ metadata: GraphqlEntityMetadata!+ """+ The name.+ """+ name: String!+ """+ The identifier of the owner.+ """+ ownerId: String!+ """+ The bot running this session.+ """+ botId: ID!+ """+ The bot running this session, when its profile still exists.+ """+ bot: GraphqlSessionBot+ """+ The channel thread the session was opened from, when any.+ """+ threadId: ID+ """+ The session's last known status: `no_messages`, `disconnected`, or the+ wire name of the most recent system event (for example `session/end`).+ """+ status: String!+ """+ The created timestamp in RFC 3339 format.+ """+ createdAt: String!+ """+ The updated timestamp in RFC 3339 format.+ """+ updatedAt: String!+ """+ The viewed timestamp in RFC 3339 format.+ """+ viewedAt: String+ """+ Properties assigned to this entity that the authenticated user may view.+ """+ properties: [GraphqlProperty!]!+ """+ Notifications associated with this entity for the authenticated user.+ """+ notifications: [GraphqlNotification!]!+ """+ Whether the authenticated viewer has favorited this entity.+ """+ isFavorited: Boolean!+ """+ The authenticated viewer's effective permission for this entity.+ """+ viewerPermission: GraphqlEntityPermission+ """+ The newest activity on this entity, newest first. Loaded lazily and+ batched across entities; an activity outage degrades to an empty+ timeline. Deeper history belongs to the viewer's activity feed.+ """+ activity(limit: Int): [GraphqlActivityEvent!]!+ """+ The viewer's frecency score for this entity, when loaded.+ """+ frecencyScore: Float+}+"""GraphQL representation of a Soup group bin."""@@ -4976,6 +5148,10 @@ enum GraphqlSoupEntityType {Reminder entity."""REMINDER+ """+ AI coding agent session entity.+ """+ AGENT_SESSION}"""