Skip to content

armgit / macro

Public Imported from GitHub
0

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

feat(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.json
index 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.json
new file mode 100644
index 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.json
new file mode 100644
index 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.json
new file mode 100644
index 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.lock
index 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.tsx
index 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.ts
index 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.tsx
index 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.ts
index 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.ts
index 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 thread
diff --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.ts
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.json
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.json
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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 = zod
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('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 = zod
updated_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 = zod
updated_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.ts
index 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.ts
index 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: 'G
type 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: 'Graph
type 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: 'GraphqlSoupP
type 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_Fragment
diff --git a/apps/web/src/lib/service-clients/service-storage/openapi.json b/apps/web/src/lib/service-clients/service-storage/openapi.json
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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, never
diff --git a/crates/agent_session/src/domain/service.rs b/crates/agent_session/src/domain/service.rs
index 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 @@ where
self.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 @@ where
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 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.rs
index 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.rs
index 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 @@ where
S: 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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::Resul
Ok(())
}
+#[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.rs
index 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.toml
index 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.rs
index 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 @@ where
type 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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, So
let 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, So
EntityType::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, So
ForeignEntityLiteral::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.rs
index 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 @@ where
GraphqlSoupEntityType::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.rs
index 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.rs
index 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_properties
diff --git a/crates/item_filter_index/src/test.rs b/crates/item_filter_index/src/test.rs
index 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.rs
index 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 operations
use 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 events
pub 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.rs
new file mode 100644
index 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.rs
index 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.rs
new file mode 100644
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.rs
new file mode 100644
index 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.rs
new file mode 100644
index 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.rs
index 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.rs
index 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.ts
index 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-ts
export { 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.ts
index 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.ts
index 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.ts
index 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-ts
export { 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.ts
index 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.ts
index 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-ts
export { 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.ts
index 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.json
index 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.json
index 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.json
index 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.ts
index 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.rs
index 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.rs
index 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.graphql
index 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
}
"""