The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
feat(teams): record inbound Teams messages as assistant requests (#27348)
Abdul Rahmand565e86ea0be
diff --git a/packages/twenty-apps/public/teams/src/features/chat/constants/universal-identifiers.ts b/packages/twenty-apps/public/teams/src/features/chat/constants/universal-identifiers.tsindex 503cb2a1a4b..a460c492992 100644--- a/packages/twenty-apps/public/teams/src/features/chat/constants/universal-identifiers.ts+++ b/packages/twenty-apps/public/teams/src/features/chat/constants/universal-identifiers.ts@@ -42,3 +42,54 @@ export const TEAMS_ASSISTANT_REQUEST_OBJECT_UNIVERSAL_IDENTIFIER =export const TEAMS_USER_LINK_OBJECT_UNIVERSAL_IDENTIFIER ='2ea0b632-8492-4a81-abbc-850f7f403bb8';++export const TEAMS_ASSISTANT_REQUEST_NAME_FIELD_UNIVERSAL_IDENTIFIER =+ '22317853-51d7-44b2-9e60-0e9f5a05ac40';++export const TEAMS_ASSISTANT_REQUEST_ACTIVITY_ID_FIELD_UNIVERSAL_IDENTIFIER =+ 'fe7bea49-fa2d-4b68-a47e-7433a78439c5';++export const TEAMS_ASSISTANT_REQUEST_CONVERSATION_ID_FIELD_UNIVERSAL_IDENTIFIER =+ '5c0236d9-adbb-4601-a4f3-328d241378f7';++export const TEAMS_ASSISTANT_REQUEST_CONVERSATION_TYPE_FIELD_UNIVERSAL_IDENTIFIER =+ '96d7082a-4dee-4790-ab1c-d32e1b9543f5';++export const TEAMS_ASSISTANT_REQUEST_SERVICE_URL_FIELD_UNIVERSAL_IDENTIFIER =+ 'c52e0123-efcc-4817-af03-1f46fdad9324';++export const TEAMS_ASSISTANT_REQUEST_TENANT_ID_FIELD_UNIVERSAL_IDENTIFIER =+ 'd84a806a-da80-4e73-9f30-648290157275';++export const TEAMS_ASSISTANT_REQUEST_USER_ID_FIELD_UNIVERSAL_IDENTIFIER =+ 'dfb9e4eb-76cf-4c50-a835-b0b8f3fde649';++export const TEAMS_ASSISTANT_REQUEST_USER_AAD_OBJECT_ID_FIELD_UNIVERSAL_IDENTIFIER =+ '5d059e2d-a570-4af5-a820-381b12e19f72';++export const TEAMS_ASSISTANT_REQUEST_WORKSPACE_MEMBER_FIELD_UNIVERSAL_IDENTIFIER =+ 'ba4a6a49-d86d-4c07-af87-f102adfabf7b';++export const TEAMS_ASSISTANT_REQUESTS_ON_WORKSPACE_MEMBER_FIELD_UNIVERSAL_IDENTIFIER =+ '34c69ef9-c4e2-4d0a-a52b-6b4a437eb3f2';++export const TEAMS_ASSISTANT_REQUEST_TEXT_FIELD_UNIVERSAL_IDENTIFIER =+ '45c99b78-3dac-4408-825f-2da0c03168be';++export const TEAMS_ASSISTANT_REQUEST_RESPONSE_FIELD_UNIVERSAL_IDENTIFIER =+ 'a376aedf-72ec-4332-bef7-1556edacd7d1';++export const TEAMS_ASSISTANT_REQUEST_STATUS_FIELD_UNIVERSAL_IDENTIFIER =+ '6ee72afe-d749-4fea-b37f-af1552884b94';++export const TEAMS_ASSISTANT_REQUEST_ERROR_FIELD_UNIVERSAL_IDENTIFIER =+ '9436ccc1-3757-4f1e-a8a7-b7048159f47b';++export const TEAMS_ASSISTANT_REQUEST_TEAMS_ACTIVITY_INDEX_UNIVERSAL_IDENTIFIER =+ 'c376a4c9-ce5e-49b6-b174-7965e1bfa0b4';++export const TEAMS_ASSISTANT_REQUEST_TEAMS_ACTIVITY_INDEX_CONVERSATION_ID_FIELD_UNIVERSAL_IDENTIFIER =+ 'c00b79ef-1dc1-46c2-bfb3-8839fb52f7ad';++export const TEAMS_ASSISTANT_REQUEST_TEAMS_ACTIVITY_INDEX_ACTIVITY_ID_FIELD_UNIVERSAL_IDENTIFIER =+ 'fb9d5cf5-6178-465c-a734-fafef3cba9ae';diff --git a/packages/twenty-apps/public/teams/src/features/chat/fields/teams-assistant-requests-on-workspace-member.field.ts b/packages/twenty-apps/public/teams/src/features/chat/fields/teams-assistant-requests-on-workspace-member.field.tsnew file mode 100644index 00000000000..40ad881b278--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/fields/teams-assistant-requests-on-workspace-member.field.ts@@ -0,0 +1,33 @@+import {+ defineField,+ FieldType,+ RelationType,+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,+} from 'twenty-sdk/define';++import {+ TEAMS_ASSISTANT_REQUEST_OBJECT_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_WORKSPACE_MEMBER_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUESTS_ON_WORKSPACE_MEMBER_FIELD_UNIVERSAL_IDENTIFIER,+} from 'src/features/chat/constants/universal-identifiers';++export default defineField({+ universalIdentifier:+ TEAMS_ASSISTANT_REQUESTS_ON_WORKSPACE_MEMBER_FIELD_UNIVERSAL_IDENTIFIER,+ objectUniversalIdentifier:+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.workspaceMember.universalIdentifier,+ type: FieldType.RELATION,+ name: 'teamsAssistantRequests',+ label: 'Teams assistant requests',+ description: 'Teams requests the assistant ran as this member.',+ icon: 'IconMessage',+ isNullable: true,+ relationTargetObjectMetadataUniversalIdentifier:+ TEAMS_ASSISTANT_REQUEST_OBJECT_UNIVERSAL_IDENTIFIER,+ relationTargetFieldMetadataUniversalIdentifier:+ TEAMS_ASSISTANT_REQUEST_WORKSPACE_MEMBER_FIELD_UNIVERSAL_IDENTIFIER,+ universalSettings: {+ relationType: RelationType.ONE_TO_MANY,+ },+ isUIEditable: false,+});diff --git a/packages/twenty-apps/public/teams/src/features/chat/indexes/teams-assistant-request-teams-activity.index.ts b/packages/twenty-apps/public/teams/src/features/chat/indexes/teams-assistant-request-teams-activity.index.tsnew file mode 100644index 00000000000..c6e054d93c6--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/indexes/teams-assistant-request-teams-activity.index.ts@@ -0,0 +1,32 @@+import { defineIndex } from 'twenty-sdk/define';++import {+ TEAMS_ASSISTANT_REQUEST_ACTIVITY_ID_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_CONVERSATION_ID_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_OBJECT_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_TEAMS_ACTIVITY_INDEX_ACTIVITY_ID_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_TEAMS_ACTIVITY_INDEX_CONVERSATION_ID_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_TEAMS_ACTIVITY_INDEX_UNIVERSAL_IDENTIFIER,+} from 'src/features/chat/constants/universal-identifiers';++export default defineIndex({+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_TEAMS_ACTIVITY_INDEX_UNIVERSAL_IDENTIFIER,+ objectUniversalIdentifier:+ TEAMS_ASSISTANT_REQUEST_OBJECT_UNIVERSAL_IDENTIFIER,+ isUnique: true,+ fields: [+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_TEAMS_ACTIVITY_INDEX_CONVERSATION_ID_FIELD_UNIVERSAL_IDENTIFIER,+ fieldUniversalIdentifier:+ TEAMS_ASSISTANT_REQUEST_CONVERSATION_ID_FIELD_UNIVERSAL_IDENTIFIER,+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_TEAMS_ACTIVITY_INDEX_ACTIVITY_ID_FIELD_UNIVERSAL_IDENTIFIER,+ fieldUniversalIdentifier:+ TEAMS_ASSISTANT_REQUEST_ACTIVITY_ID_FIELD_UNIVERSAL_IDENTIFIER,+ },+ ],+});diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/constants/teams-assistant-request-status.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/constants/teams-assistant-request-status.tsnew file mode 100644index 00000000000..61d95c45e9d--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/constants/teams-assistant-request-status.ts@@ -0,0 +1,6 @@+export const TEAMS_ASSISTANT_REQUEST_STATUS = {+ PENDING: 'PENDING',+ PROCESSING: 'PROCESSING',+ DONE: 'DONE',+ FAILED: 'FAILED',+} as const;diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/constants/teams-assistant-request-timeout-seconds.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/constants/teams-assistant-request-timeout-seconds.tsnew file mode 100644index 00000000000..ae142f0c140--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/constants/teams-assistant-request-timeout-seconds.ts@@ -0,0 +1 @@+export const TEAMS_ASSISTANT_REQUEST_TIMEOUT_SECONDS = 60 * 4;diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/data/create-teams-assistant-request.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/data/create-teams-assistant-request.tsnew file mode 100644index 00000000000..3744b3263f1--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/data/create-teams-assistant-request.ts@@ -0,0 +1,34 @@+import { isNonEmptyString } from '@sniptt/guards';+import { type CoreApiClient } from 'twenty-client-sdk/core';++import { type TeamsAssistantRequestDraft } from 'src/features/chat/logic-functions/types/teams-assistant-request-draft.type';+import { buildTeamsAssistantRequestName } from 'src/features/chat/logic-functions/utils/build-teams-assistant-request-name';++export const createTeamsAssistantRequest = async ({+ client,+ draft,+}: {+ client: CoreApiClient;+ draft: TeamsAssistantRequestDraft;+}): Promise<string> => {+ const mutationResult = await client.mutation({+ createTeamsAssistantRequest: {+ __args: {+ data: {+ ...draft,+ name: buildTeamsAssistantRequestName(draft.requestText),+ requestText: { blocknote: null, markdown: draft.requestText },+ },+ },+ id: true,+ },+ });++ const requestId = mutationResult.createTeamsAssistantRequest?.id;++ if (!isNonEmptyString(requestId)) {+ throw new Error('createTeamsAssistantRequest did not return an id');+ }++ return requestId;+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/data/find-teams-assistant-request-by-teams-activity.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/data/find-teams-assistant-request-by-teams-activity.tsnew file mode 100644index 00000000000..c801f286fbc--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/data/find-teams-assistant-request-by-teams-activity.ts@@ -0,0 +1,49 @@+import { type CoreApiClient } from 'twenty-client-sdk/core';+import { isDefined } from 'twenty-sdk/utils';++import { type TeamsAssistantRequestRecord } from 'src/features/chat/logic-functions/types/teams-assistant-request-record.type';++export const findTeamsAssistantRequestByTeamsActivity = async ({+ client,+ teamsConversationId,+ teamsActivityId,+}: {+ client: CoreApiClient;+ teamsConversationId: string;+ teamsActivityId: string;+}): Promise<TeamsAssistantRequestRecord | undefined> => {+ const queryResult = await client.query({+ teamsAssistantRequests: {+ __args: {+ filter: {+ teamsConversationId: { eq: teamsConversationId },+ teamsActivityId: { eq: teamsActivityId },+ },+ first: 1,+ },+ edges: {+ node: {+ id: true,+ status: true,+ teamsActivityId: true,+ teamsConversationId: true,+ teamsConversationType: true,+ teamsServiceUrl: true,+ teamsTenantId: true,+ teamsUserId: true,+ teamsUserAadObjectId: true,+ requestText: { markdown: true },+ updatedAt: true,+ },+ },+ },+ });++ const node = queryResult.teamsAssistantRequests?.edges?.[0]?.node;++ if (!isDefined(node)) {+ return undefined;+ }++ return { ...node, requestText: node.requestText?.markdown ?? undefined };+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/teams-activities-enqueue.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/teams-activities-enqueue.tsnew file mode 100644index 00000000000..ff6c304fbfa--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/teams-activities-enqueue.ts@@ -0,0 +1,14 @@+import { defineLogicFunction } from 'twenty-sdk/define';++import { TEAMS_ACTIVITIES_ENQUEUE_UNIVERSAL_IDENTIFIER } from 'src/features/chat/constants/universal-identifiers';+import { TEAMS_ASSISTANT_REQUEST_TIMEOUT_SECONDS } from 'src/features/chat/logic-functions/constants/teams-assistant-request-timeout-seconds';+import { enqueueTeamsAssistantRequest } from 'src/features/chat/logic-functions/utils/enqueue-teams-assistant-request';++export default defineLogicFunction({+ universalIdentifier: TEAMS_ACTIVITIES_ENQUEUE_UNIVERSAL_IDENTIFIER,+ name: 'teams-activities-enqueue',+ description:+ 'Receives a verified Microsoft Teams message activity from the activities route, in the workspace that claimed its tenant. When chat is enabled, records it as a pending Teams Assistant Request, once per conversation and activity id, and hands the request back for answering.',+ timeoutSeconds: TEAMS_ASSISTANT_REQUEST_TIMEOUT_SECONDS,+ handler: enqueueTeamsAssistantRequest,+});diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-activities-dispatch-payload.type.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-activities-dispatch-payload.type.tsnew file mode 100644index 00000000000..5a99e1682e6--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-activities-dispatch-payload.type.ts@@ -0,0 +1,7 @@+import { type TeamsInboundActivity } from 'src/features/chat/logic-functions/types/teams-inbound-activity.type';++export type TeamsActivitiesDispatchPayload = {+ activity: TeamsInboundActivity;+ serviceUrl: string;+ tenantId: string;+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-activities-enqueue-result.type.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-activities-enqueue-result.type.tsnew file mode 100644index 00000000000..eef791e94a5--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-activities-enqueue-result.type.ts@@ -0,0 +1,7 @@+import { type TeamsAssistantRequestRecord } from 'src/features/chat/logic-functions/types/teams-assistant-request-record.type';++export type TeamsActivitiesEnqueueResult = {+ ok: boolean;+ skipped?: string;+ request?: TeamsAssistantRequestRecord;+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-activity-entity.type.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-activity-entity.type.tsnew file mode 100644index 00000000000..b919ce00894--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-activity-entity.type.ts@@ -0,0 +1,7 @@+import { type TeamsChannelAccount } from 'src/features/chat/logic-functions/types/teams-channel-account.type';++export type TeamsActivityEntity = {+ type?: string;+ text?: string;+ mentioned?: TeamsChannelAccount;+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-assistant-request-draft.type.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-assistant-request-draft.type.tsnew file mode 100644index 00000000000..9b5ffc70a69--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-assistant-request-draft.type.ts@@ -0,0 +1,10 @@+export type TeamsAssistantRequestDraft = {+ teamsActivityId: string;+ teamsConversationId: string;+ teamsConversationType: string;+ teamsServiceUrl: string;+ teamsTenantId: string;+ teamsUserId: string;+ teamsUserAadObjectId: string;+ requestText: string;+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-assistant-request-record.type.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-assistant-request-record.type.tsnew file mode 100644index 00000000000..3e28424df26--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-assistant-request-record.type.ts@@ -0,0 +1,8 @@+import { type TeamsAssistantRequestDraft } from 'src/features/chat/logic-functions/types/teams-assistant-request-draft.type';++export type TeamsAssistantRequestRecord =+ Partial<TeamsAssistantRequestDraft> & {+ id: string;+ status?: string;+ updatedAt?: string;+ };diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-channel-account.type.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-channel-account.type.tsnew file mode 100644index 00000000000..7d7990b2a4a--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-channel-account.type.ts@@ -0,0 +1,5 @@+export type TeamsChannelAccount = {+ id?: string;+ aadObjectId?: string;+ role?: string;+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-inbound-activity.type.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-inbound-activity.type.tsnew file mode 100644index 00000000000..48494e6f718--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/types/teams-inbound-activity.type.ts@@ -0,0 +1,15 @@+import { type TeamsActivityEntity } from 'src/features/chat/logic-functions/types/teams-activity-entity.type';+import { type TeamsChannelAccount } from 'src/features/chat/logic-functions/types/teams-channel-account.type';++export type TeamsInboundActivity = {+ type?: string;+ id?: string;+ text?: string;+ from?: TeamsChannelAccount;+ recipient?: TeamsChannelAccount;+ conversation?: {+ id?: string;+ conversationType?: string;+ };+ entities?: TeamsActivityEntity[];+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/build-teams-assistant-request-name.test.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/build-teams-assistant-request-name.test.tsnew file mode 100644index 00000000000..c5b58962005--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/build-teams-assistant-request-name.test.ts@@ -0,0 +1,13 @@+import { describe, expect, it } from 'vitest';++import { buildTeamsAssistantRequestName } from 'src/features/chat/logic-functions/utils/build-teams-assistant-request-name';++describe('buildTeamsAssistantRequestName', () => {+ it('should not split a multi-code-point emoji when truncating', () => {+ const familyEmoji = 'π¨βπ©βπ§';++ expect(+ buildTeamsAssistantRequestName(`${'a'.repeat(57)}${familyEmoji}`),+ ).toBe(`${'a'.repeat(57)}β¦`);+ });+});diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/enqueue-teams-assistant-request-record.test.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/enqueue-teams-assistant-request-record.test.tsnew file mode 100644index 00000000000..0087246addd--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/enqueue-teams-assistant-request-record.test.ts@@ -0,0 +1,173 @@+import { beforeEach, describe, expect, it, vi } from 'vitest';++import { TEAMS_ASSISTANT_REQUEST_STATUS } from 'src/features/chat/logic-functions/constants/teams-assistant-request-status';+import { TEAMS_ASSISTANT_REQUEST_TIMEOUT_SECONDS } from 'src/features/chat/logic-functions/constants/teams-assistant-request-timeout-seconds';+import { enqueueTeamsAssistantRequestRecord } from 'src/features/chat/logic-functions/utils/enqueue-teams-assistant-request-record';++const {+ coreApiClientMock,+ findTeamsAssistantRequestByTeamsActivityMock,+ createTeamsAssistantRequestMock,+} = vi.hoisted(() => ({+ coreApiClientMock: vi.fn(),+ findTeamsAssistantRequestByTeamsActivityMock: vi.fn(),+ createTeamsAssistantRequestMock: vi.fn(),+}));++vi.mock('twenty-client-sdk/core', () => ({+ CoreApiClient: coreApiClientMock,+}));++vi.mock(+ 'src/features/chat/logic-functions/data/find-teams-assistant-request-by-teams-activity',+ () => ({+ findTeamsAssistantRequestByTeamsActivity:+ findTeamsAssistantRequestByTeamsActivityMock,+ }),+);++vi.mock(+ 'src/features/chat/logic-functions/data/create-teams-assistant-request',+ () => ({ createTeamsAssistantRequest: createTeamsAssistantRequestMock }),+);++const REQUEST_DRAFT = {+ teamsActivityId: '1700000000000',+ teamsConversationId: 'a:personal-conversation',+ teamsConversationType: 'personal',+ teamsServiceUrl: 'https://smba.trafficmanager.net/amer/',+ teamsTenantId: 'tenant-id',+ teamsUserId: '29:user-id',+ teamsUserAadObjectId: 'aad-user-id',+ requestText: 'how many open deals does Acme have?',+};++describe('enqueueTeamsAssistantRequestRecord', () => {+ beforeEach(() => {+ vi.clearAllMocks();+ coreApiClientMock.mockImplementation(function () {+ return {};+ });+ });++ it('should record a new request as pending and hand it back', async () => {+ findTeamsAssistantRequestByTeamsActivityMock.mockResolvedValue(undefined);+ createTeamsAssistantRequestMock.mockResolvedValue('request-1');++ const result = await enqueueTeamsAssistantRequestRecord(REQUEST_DRAFT);++ expect(findTeamsAssistantRequestByTeamsActivityMock).toHaveBeenCalledWith({+ client: expect.anything(),+ teamsConversationId: 'a:personal-conversation',+ teamsActivityId: '1700000000000',+ });+ expect(result).toEqual({+ ok: true,+ request: {+ id: 'request-1',+ status: TEAMS_ASSISTANT_REQUEST_STATUS.PENDING,+ ...REQUEST_DRAFT,+ },+ });+ });++ it('should hand back an unanswered request so a retry can resume it', async () => {+ const pendingRequest = {+ id: 'request-1',+ status: TEAMS_ASSISTANT_REQUEST_STATUS.PENDING,+ ...REQUEST_DRAFT,+ };++ findTeamsAssistantRequestByTeamsActivityMock.mockResolvedValue(+ pendingRequest,+ );++ const result = await enqueueTeamsAssistantRequestRecord(REQUEST_DRAFT);++ expect(result).toEqual({ ok: true, request: pendingRequest });+ expect(createTeamsAssistantRequestMock).not.toHaveBeenCalled();+ });++ it('should skip a request another execution is already answering', async () => {+ findTeamsAssistantRequestByTeamsActivityMock.mockResolvedValue({+ id: 'request-1',+ status: TEAMS_ASSISTANT_REQUEST_STATUS.PROCESSING,+ updatedAt: new Date().toISOString(),+ ...REQUEST_DRAFT,+ });++ const result = await enqueueTeamsAssistantRequestRecord(REQUEST_DRAFT);++ expect(result).toEqual({+ ok: true,+ skipped: 'Teams activity is already queued',+ });+ });++ it('should skip a request that was already answered', async () => {+ findTeamsAssistantRequestByTeamsActivityMock.mockResolvedValue({+ id: 'request-1',+ status: TEAMS_ASSISTANT_REQUEST_STATUS.DONE,+ ...REQUEST_DRAFT,+ });++ const result = await enqueueTeamsAssistantRequestRecord(REQUEST_DRAFT);++ expect(result).toEqual({+ ok: true,+ skipped: 'Teams activity is already queued',+ });+ });++ it('should hand back a request whose execution died mid-answer', async () => {+ const staleRequest = {+ id: 'request-1',+ status: TEAMS_ASSISTANT_REQUEST_STATUS.PROCESSING,+ updatedAt: new Date(+ Date.now() - (TEAMS_ASSISTANT_REQUEST_TIMEOUT_SECONDS + 1) * 1000,+ ).toISOString(),+ ...REQUEST_DRAFT,+ };++ findTeamsAssistantRequestByTeamsActivityMock.mockResolvedValue(+ staleRequest,+ );++ const result = await enqueueTeamsAssistantRequestRecord(REQUEST_DRAFT);++ expect(result).toEqual({ ok: true, request: staleRequest });+ });++ it('should hand back the winning record when losing the create race', async () => {+ const pendingRequest = {+ id: 'request-1',+ status: TEAMS_ASSISTANT_REQUEST_STATUS.PENDING,+ ...REQUEST_DRAFT,+ };++ findTeamsAssistantRequestByTeamsActivityMock+ .mockResolvedValueOnce(undefined)+ .mockResolvedValueOnce(pendingRequest);+ createTeamsAssistantRequestMock.mockRejectedValue(+ new Error('duplicate key value violates unique constraint'),+ );++ const result = await enqueueTeamsAssistantRequestRecord(REQUEST_DRAFT);++ expect(result).toEqual({ ok: true, request: pendingRequest });+ expect(findTeamsAssistantRequestByTeamsActivityMock).toHaveBeenCalledTimes(+ 2,+ );+ });++ it('should surface create failures that are not duplicates', async () => {+ findTeamsAssistantRequestByTeamsActivityMock.mockResolvedValue(undefined);+ createTeamsAssistantRequestMock.mockRejectedValue(+ new Error('connection refused'),+ );++ await expect(+ enqueueTeamsAssistantRequestRecord(REQUEST_DRAFT),+ ).rejects.toThrow('connection refused');+ });+});diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/enqueue-teams-assistant-request.test.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/enqueue-teams-assistant-request.test.tsnew file mode 100644index 00000000000..1ec2d15ffce--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/enqueue-teams-assistant-request.test.ts@@ -0,0 +1,84 @@+import { beforeEach, describe, expect, it, vi } from 'vitest';++import { CHAT_ENABLED_APPLICATION_VARIABLE_KEY } from 'src/features/chat/constants/chat-enabled-application-variable-key';+import { type TeamsActivitiesDispatchPayload } from 'src/features/chat/logic-functions/types/teams-activities-dispatch-payload.type';+import { enqueueTeamsAssistantRequest } from 'src/features/chat/logic-functions/utils/enqueue-teams-assistant-request';++const { featureFlags, enqueueTeamsAssistantRequestRecordMock } = vi.hoisted(+ () => ({+ featureFlags: { IS_CHAT_ASSISTANT_ENABLED: true },+ enqueueTeamsAssistantRequestRecordMock: vi.fn(),+ }),+);++vi.mock('src/constants/feature-flags', () => ({+ FEATURE_FLAGS: featureFlags,+}));++vi.mock(+ 'src/features/chat/logic-functions/utils/enqueue-teams-assistant-request-record',+ () => ({+ enqueueTeamsAssistantRequestRecord: enqueueTeamsAssistantRequestRecordMock,+ }),+);++const PAYLOAD: TeamsActivitiesDispatchPayload = {+ activity: {+ type: 'message',+ id: '1700000000000',+ text: 'how many open deals does Acme have?',+ from: { id: '29:user-id' },+ recipient: { id: '28:bot-app-id' },+ conversation: {+ id: 'a:personal-conversation',+ conversationType: 'personal',+ },+ },+ serviceUrl: 'https://smba.trafficmanager.net/amer/',+ tenantId: 'tenant-id',+};++describe('enqueueTeamsAssistantRequest', () => {+ beforeEach(() => {+ vi.clearAllMocks();+ featureFlags.IS_CHAT_ASSISTANT_ENABLED = true;+ process.env[CHAT_ENABLED_APPLICATION_VARIABLE_KEY] = 'true';+ enqueueTeamsAssistantRequestRecordMock.mockResolvedValue({+ ok: true,+ request: { id: 'request-1' },+ });+ });++ it('should record a message when chat is enabled', async () => {+ const result = await enqueueTeamsAssistantRequest(PAYLOAD);++ expect(enqueueTeamsAssistantRequestRecordMock).toHaveBeenCalledWith(+ expect.objectContaining({+ teamsActivityId: '1700000000000',+ teamsTenantId: 'tenant-id',+ requestText: 'how many open deals does Acme have?',+ }),+ );+ expect(result).toEqual({ ok: true, request: { id: 'request-1' } });+ });++ it('should skip when the workspace turned chat off', async () => {+ process.env[CHAT_ENABLED_APPLICATION_VARIABLE_KEY] = 'false';++ expect(await enqueueTeamsAssistantRequest(PAYLOAD)).toEqual({+ ok: true,+ skipped: 'Chat is disabled',+ });+ expect(enqueueTeamsAssistantRequestRecordMock).not.toHaveBeenCalled();+ });++ it('should skip while the chat feature is unavailable', async () => {+ featureFlags.IS_CHAT_ASSISTANT_ENABLED = false;++ expect(await enqueueTeamsAssistantRequest(PAYLOAD)).toEqual({+ ok: true,+ skipped: 'Chat is disabled',+ });+ expect(enqueueTeamsAssistantRequestRecordMock).not.toHaveBeenCalled();+ });+});diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/parse-teams-assistant-request.test.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/parse-teams-assistant-request.test.tsnew file mode 100644index 00000000000..2b1a74bc829--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/__tests__/parse-teams-assistant-request.test.ts@@ -0,0 +1,171 @@+import { describe, expect, it } from 'vitest';++import { type TeamsActivitiesDispatchPayload } from 'src/features/chat/logic-functions/types/teams-activities-dispatch-payload.type';+import { type TeamsInboundActivity } from 'src/features/chat/logic-functions/types/teams-inbound-activity.type';+import { parseTeamsAssistantRequest } from 'src/features/chat/logic-functions/utils/parse-teams-assistant-request';++const BOT_ID = '28:bot-app-id';+const SERVICE_URL = 'https://smba.trafficmanager.net/amer/';+const TENANT_ID = 'tenant-id';++const buildPayload = (+ activity: Partial<TeamsInboundActivity>,+): TeamsActivitiesDispatchPayload => ({+ activity: {+ type: 'message',+ id: '1700000000000',+ text: 'how many open deals does Acme have?',+ from: { id: '29:user-id', aadObjectId: 'aad-user-id' },+ recipient: { id: BOT_ID },+ conversation: {+ id: 'a:personal-conversation',+ conversationType: 'personal',+ },+ ...activity,+ },+ serviceUrl: SERVICE_URL,+ tenantId: TENANT_ID,+});++describe('parseTeamsAssistantRequest', () => {+ it('should turn a personal chat message into a request draft', () => {+ expect(parseTeamsAssistantRequest(buildPayload({}))).toEqual({+ request: {+ teamsActivityId: '1700000000000',+ teamsConversationId: 'a:personal-conversation',+ teamsConversationType: 'personal',+ teamsServiceUrl: SERVICE_URL,+ teamsTenantId: TENANT_ID,+ teamsUserId: '29:user-id',+ teamsUserAadObjectId: 'aad-user-id',+ requestText: 'how many open deals does Acme have?',+ },+ });+ });++ it('should strip the bot mention and keep other mentions as plain names', () => {+ const parsed = parseTeamsAssistantRequest(+ buildPayload({+ text: '<at>Twenty</at> assign the Acme deal to <at>John Smith</at>\n',+ conversation: {+ id: '19:[email protected];messageid=1699999999999',+ conversationType: 'channel',+ },+ entities: [+ {+ type: 'mention',+ text: '<at>Twenty</at>',+ mentioned: { id: BOT_ID.toUpperCase() },+ },+ {+ type: 'mention',+ text: '<at>John Smith</at>',+ mentioned: { id: '29:other-user-id' },+ },+ ],+ }),+ );++ expect(parsed.request).toMatchObject({+ teamsConversationType: 'channel',+ requestText: 'assign the Acme deal to John Smith',+ });+ });++ it('should keep line breaks and indentation in the request', () => {+ const parsed = parseTeamsAssistantRequest(+ buildPayload({+ text: '<at>Twenty</at> import these leads:\nname,email\n Jane,[email protected]',+ entities: [+ {+ type: 'mention',+ text: '<at>Twenty</at>',+ mentioned: { id: BOT_ID },+ },+ ],+ }),+ );++ expect(parsed.request?.requestText).toBe(+ 'import these leads:\nname,email\n Jane,[email protected]',+ );+ });++ it('should close the gap left by a bot mention in the middle of a sentence', () => {+ const parsed = parseTeamsAssistantRequest(+ buildPayload({+ text: 'hey <at>Twenty</at> list my open deals',+ entities: [+ {+ type: 'mention',+ text: '<at>Twenty</at>',+ mentioned: { id: BOT_ID },+ },+ ],+ }),+ );++ expect(parsed.request?.requestText).toBe('hey list my open deals');+ });++ it('should skip a message that only mentions the bot', () => {+ expect(+ parseTeamsAssistantRequest(+ buildPayload({+ text: '<at>Twenty</at> ',+ entities: [+ {+ type: 'mention',+ text: '<at>Twenty</at>',+ mentioned: { id: BOT_ID },+ },+ ],+ }),+ ),+ ).toEqual({ request: null, skipReason: 'Empty request text' });+ });++ it('should skip activities that are not messages', () => {+ expect(+ parseTeamsAssistantRequest(buildPayload({ type: 'conversationUpdate' })),+ ).toEqual({+ request: null,+ skipReason: 'Unhandled activity type: conversationUpdate',+ });+ });++ it('should skip messages sent by a bot, with or without a bot role', () => {+ expect(+ parseTeamsAssistantRequest(+ buildPayload({ from: { id: 'bot-id', role: 'bot' } }),+ ),+ ).toEqual({ request: null, skipReason: 'Not a user message' });+ expect(+ parseTeamsAssistantRequest(+ buildPayload({ from: { id: '28:other-bot-app-id' } }),+ ),+ ).toEqual({ request: null, skipReason: 'Not a user message' });+ });++ it('should skip channel messages that do not mention the bot', () => {+ expect(+ parseTeamsAssistantRequest(+ buildPayload({+ conversation: {+ id: '19:[email protected];messageid=1699999999999',+ conversationType: 'channel',+ },+ }),+ ),+ ).toEqual({ request: null, skipReason: 'Bot is not mentioned' });+ });++ it('should skip activities missing the ids needed to answer', () => {+ expect(+ parseTeamsAssistantRequest(buildPayload({ conversation: {} })),+ ).toEqual({+ request: null,+ skipReason: 'Activity is missing required fields',+ });+ });+});diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/build-teams-assistant-request-name.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/build-teams-assistant-request-name.tsnew file mode 100644index 00000000000..e0af174d595--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/build-teams-assistant-request-name.ts@@ -0,0 +1,28 @@+const TEAMS_ASSISTANT_REQUEST_NAME_MAX_LENGTH = 60;++const graphemeSegmenter = new Intl.Segmenter(undefined, {+ granularity: 'grapheme',+});++const countCodePoints = (text: string): number => [...text].length;++export const buildTeamsAssistantRequestName = (requestText: string): string => {+ if (countCodePoints(requestText) <= TEAMS_ASSISTANT_REQUEST_NAME_MAX_LENGTH) {+ return requestText;+ }++ const { truncatedText } = Array.from(+ graphemeSegmenter.segment(requestText),+ ({ segment }) => segment,+ ).reduce(+ ({ truncatedText, isFull }, grapheme) =>+ isFull ||+ countCodePoints(truncatedText + grapheme) >=+ TEAMS_ASSISTANT_REQUEST_NAME_MAX_LENGTH+ ? { truncatedText, isFull: true }+ : { truncatedText: truncatedText + grapheme, isFull: false },+ { truncatedText: '', isFull: false },+ );++ return `${truncatedText}β¦`;+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/collect-teams-bot-mention-texts.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/collect-teams-bot-mention-texts.tsnew file mode 100644index 00000000000..72339552814--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/collect-teams-bot-mention-texts.ts@@ -0,0 +1,17 @@+import { isNonEmptyString } from '@sniptt/guards';++import { type TeamsInboundActivity } from 'src/features/chat/logic-functions/types/teams-inbound-activity.type';++export const collectTeamsBotMentionTexts = ({+ entities,+ recipient,+}: TeamsInboundActivity): string[] =>+ (entities ?? [])+ .filter(+ (entity) =>+ entity.type === 'mention' &&+ isNonEmptyString(recipient?.id) &&+ entity.mentioned?.id?.toLowerCase() === recipient.id.toLowerCase(),+ )+ .map((entity) => entity.text)+ .filter(isNonEmptyString);diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/enqueue-teams-assistant-request-record.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/enqueue-teams-assistant-request-record.tsnew file mode 100644index 00000000000..5408fa3f293--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/enqueue-teams-assistant-request-record.ts@@ -0,0 +1,63 @@+import { CoreApiClient } from 'twenty-client-sdk/core';+import { isDefined } from 'twenty-sdk/utils';++import { TEAMS_ASSISTANT_REQUEST_STATUS } from 'src/features/chat/logic-functions/constants/teams-assistant-request-status';+import { createTeamsAssistantRequest } from 'src/features/chat/logic-functions/data/create-teams-assistant-request';+import { findTeamsAssistantRequestByTeamsActivity } from 'src/features/chat/logic-functions/data/find-teams-assistant-request-by-teams-activity';+import { type TeamsActivitiesEnqueueResult } from 'src/features/chat/logic-functions/types/teams-activities-enqueue-result.type';+import { type TeamsAssistantRequestDraft } from 'src/features/chat/logic-functions/types/teams-assistant-request-draft.type';+import { type TeamsAssistantRequestRecord } from 'src/features/chat/logic-functions/types/teams-assistant-request-record.type';+import { isDuplicateRecordError } from 'src/features/chat/logic-functions/utils/is-duplicate-record-error';+import { isTeamsAssistantRequestResumable } from 'src/features/chat/logic-functions/utils/is-teams-assistant-request-resumable';++const ALREADY_QUEUED_SKIP_REASON = 'Teams activity is already queued';++const resolveExistingRequest = (+ existingRequest: TeamsAssistantRequestRecord | undefined,+): TeamsActivitiesEnqueueResult =>+ isDefined(existingRequest) &&+ isTeamsAssistantRequestResumable(existingRequest)+ ? { ok: true, request: existingRequest }+ : { ok: true, skipped: ALREADY_QUEUED_SKIP_REASON };++export const enqueueTeamsAssistantRequestRecord = async (+ request: TeamsAssistantRequestDraft,+): Promise<TeamsActivitiesEnqueueResult> => {+ const client = new CoreApiClient();+ const teamsActivityLookup = {+ client,+ teamsConversationId: request.teamsConversationId,+ teamsActivityId: request.teamsActivityId,+ };++ const existingRequest =+ await findTeamsAssistantRequestByTeamsActivity(teamsActivityLookup);++ if (isDefined(existingRequest)) {+ return resolveExistingRequest(existingRequest);+ }++ try {+ const requestId = await createTeamsAssistantRequest({+ client,+ draft: request,+ });++ return {+ ok: true,+ request: {+ id: requestId,+ status: TEAMS_ASSISTANT_REQUEST_STATUS.PENDING,+ ...request,+ },+ };+ } catch (error) {+ if (isDuplicateRecordError(error)) {+ return resolveExistingRequest(+ await findTeamsAssistantRequestByTeamsActivity(teamsActivityLookup),+ );+ }++ throw error;+ }+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/enqueue-teams-assistant-request.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/enqueue-teams-assistant-request.tsnew file mode 100644index 00000000000..6e46aa495a8--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/enqueue-teams-assistant-request.ts@@ -0,0 +1,28 @@+import { FEATURE_FLAGS } from 'src/constants/feature-flags';+import { CHAT_ENABLED_APPLICATION_VARIABLE_KEY } from 'src/features/chat/constants/chat-enabled-application-variable-key';+import { type TeamsActivitiesDispatchPayload } from 'src/features/chat/logic-functions/types/teams-activities-dispatch-payload.type';+import { type TeamsActivitiesEnqueueResult } from 'src/features/chat/logic-functions/types/teams-activities-enqueue-result.type';+import { enqueueTeamsAssistantRequestRecord } from 'src/features/chat/logic-functions/utils/enqueue-teams-assistant-request-record';+import { parseTeamsAssistantRequest } from 'src/features/chat/logic-functions/utils/parse-teams-assistant-request';+import { isFeatureEnabled } from 'src/utils/is-feature-enabled';++export const enqueueTeamsAssistantRequest = async (+ payload: TeamsActivitiesDispatchPayload,+): Promise<TeamsActivitiesEnqueueResult> => {+ const isChatEnabled = isFeatureEnabled({+ isAvailable: FEATURE_FLAGS.IS_CHAT_ASSISTANT_ENABLED,+ settingValue: process.env[CHAT_ENABLED_APPLICATION_VARIABLE_KEY],+ });++ if (!isChatEnabled) {+ return { ok: true, skipped: 'Chat is disabled' };+ }++ const parsed = parseTeamsAssistantRequest(payload);++ if (parsed.request === null) {+ return { ok: true, skipped: parsed.skipReason };+ }++ return await enqueueTeamsAssistantRequestRecord(parsed.request);+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/is-duplicate-record-error.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/is-duplicate-record-error.tsnew file mode 100644index 00000000000..566aca06cb8--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/is-duplicate-record-error.ts@@ -0,0 +1,5 @@+const DUPLICATE_RECORD_MESSAGE_PATTERN = /duplicate (entry|key)/i;++export const isDuplicateRecordError = (error: unknown): boolean =>+ error instanceof Error &&+ DUPLICATE_RECORD_MESSAGE_PATTERN.test(error.message);diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/is-teams-assistant-request-resumable.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/is-teams-assistant-request-resumable.tsnew file mode 100644index 00000000000..e84fd0971f4--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/is-teams-assistant-request-resumable.ts@@ -0,0 +1,26 @@+import { isNonEmptyString } from '@sniptt/guards';++import { TEAMS_ASSISTANT_REQUEST_STATUS } from 'src/features/chat/logic-functions/constants/teams-assistant-request-status';+import { TEAMS_ASSISTANT_REQUEST_TIMEOUT_SECONDS } from 'src/features/chat/logic-functions/constants/teams-assistant-request-timeout-seconds';+import { type TeamsAssistantRequestRecord } from 'src/features/chat/logic-functions/types/teams-assistant-request-record.type';++export const isTeamsAssistantRequestResumable = (+ record: Pick<TeamsAssistantRequestRecord, 'status' | 'updatedAt'>,+ { nowMs = Date.now() }: { nowMs?: number } = {},+): boolean => {+ if (record.status === TEAMS_ASSISTANT_REQUEST_STATUS.PENDING) {+ return true;+ }++ if (+ record.status !== TEAMS_ASSISTANT_REQUEST_STATUS.PROCESSING ||+ !isNonEmptyString(record.updatedAt)+ ) {+ return false;+ }++ return (+ new Date(record.updatedAt).getTime() <+ nowMs - TEAMS_ASSISTANT_REQUEST_TIMEOUT_SECONDS * 1000+ );+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/normalize-teams-request-text.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/normalize-teams-request-text.tsnew file mode 100644index 00000000000..aeb7fc640eb--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/normalize-teams-request-text.ts@@ -0,0 +1,25 @@+import { type TeamsInboundActivity } from 'src/features/chat/logic-functions/types/teams-inbound-activity.type';+import { collectTeamsBotMentionTexts } from 'src/features/chat/logic-functions/utils/collect-teams-bot-mention-texts';++const MENTION_TAG_PATTERN = /<at>(.*?)<\/at>/g;++const joinAroundRemovedMention = (left: string, right: string): string => {+ const trimmedLeft = left.replace(/[ \t]+$/, '');+ const trimmedRight = right.replace(/^[ \t]+/, '');+ const separator =+ /\S$/.test(trimmedLeft) && /^\S/.test(trimmedRight) ? ' ' : '';++ return `${trimmedLeft}${separator}${trimmedRight}`;+};++export const normalizeTeamsRequestText = (+ activity: TeamsInboundActivity,+): string =>+ collectTeamsBotMentionTexts(activity)+ .reduce(+ (remainingText, botMentionText) =>+ remainingText.split(botMentionText).reduce(joinAroundRemovedMention),+ activity.text ?? '',+ )+ .replace(MENTION_TAG_PATTERN, '$1')+ .trim();diff --git a/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/parse-teams-assistant-request.ts b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/parse-teams-assistant-request.tsnew file mode 100644index 00000000000..595b66a8772--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/logic-functions/utils/parse-teams-assistant-request.ts@@ -0,0 +1,75 @@+import { isNonEmptyArray, isNonEmptyString } from '@sniptt/guards';++import { type TeamsActivitiesDispatchPayload } from 'src/features/chat/logic-functions/types/teams-activities-dispatch-payload.type';+import { type TeamsAssistantRequestDraft } from 'src/features/chat/logic-functions/types/teams-assistant-request-draft.type';+import { collectTeamsBotMentionTexts } from 'src/features/chat/logic-functions/utils/collect-teams-bot-mention-texts';+import { normalizeTeamsRequestText } from 'src/features/chat/logic-functions/utils/normalize-teams-request-text';++const BOT_ACCOUNT_ID_PREFIX = '28:';++const PERSONAL_CONVERSATION_TYPE = 'personal';++type ParsedTeamsAssistantRequest =+ | { request: TeamsAssistantRequestDraft }+ | { request: null; skipReason: string };++export const parseTeamsAssistantRequest = ({+ activity,+ serviceUrl,+ tenantId,+}: TeamsActivitiesDispatchPayload): ParsedTeamsAssistantRequest => {+ if (activity.type !== 'message') {+ return {+ request: null,+ skipReason: `Unhandled activity type: ${activity.type}`,+ };+ }++ const senderId = activity.from?.id;++ if (+ activity.from?.role === 'bot' ||+ senderId?.startsWith(BOT_ACCOUNT_ID_PREFIX)+ ) {+ return { request: null, skipReason: 'Not a user message' };+ }++ const conversationId = activity.conversation?.id;++ if (+ !isNonEmptyString(activity.id) ||+ !isNonEmptyString(conversationId) ||+ !isNonEmptyString(senderId)+ ) {+ return { request: null, skipReason: 'Activity is missing required fields' };+ }++ const conversationType =+ activity.conversation?.conversationType ?? PERSONAL_CONVERSATION_TYPE;++ if (+ conversationType !== PERSONAL_CONVERSATION_TYPE &&+ !isNonEmptyArray(collectTeamsBotMentionTexts(activity))+ ) {+ return { request: null, skipReason: 'Bot is not mentioned' };+ }++ const requestText = normalizeTeamsRequestText(activity);++ if (!isNonEmptyString(requestText)) {+ return { request: null, skipReason: 'Empty request text' };+ }++ return {+ request: {+ teamsActivityId: activity.id,+ teamsConversationId: conversationId,+ teamsConversationType: conversationType,+ teamsServiceUrl: serviceUrl,+ teamsTenantId: tenantId,+ teamsUserId: senderId,+ teamsUserAadObjectId: activity.from?.aadObjectId ?? '',+ requestText,+ },+ };+};diff --git a/packages/twenty-apps/public/teams/src/features/chat/objects/teams-assistant-request.object.ts b/packages/twenty-apps/public/teams/src/features/chat/objects/teams-assistant-request.object.tsnew file mode 100644index 00000000000..10bfe4f8e04--- /dev/null+++ b/packages/twenty-apps/public/teams/src/features/chat/objects/teams-assistant-request.object.ts@@ -0,0 +1,201 @@+import {+ defineObject,+ FieldType,+ OnDeleteAction,+ RelationType,+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,+} from 'twenty-sdk/define';++import {+ TEAMS_ASSISTANT_REQUEST_ACTIVITY_ID_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_CONVERSATION_ID_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_CONVERSATION_TYPE_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_ERROR_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_NAME_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_OBJECT_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_RESPONSE_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_SERVICE_URL_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_STATUS_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_TENANT_ID_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_TEXT_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_USER_AAD_OBJECT_ID_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_USER_ID_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUEST_WORKSPACE_MEMBER_FIELD_UNIVERSAL_IDENTIFIER,+ TEAMS_ASSISTANT_REQUESTS_ON_WORKSPACE_MEMBER_FIELD_UNIVERSAL_IDENTIFIER,+} from 'src/features/chat/constants/universal-identifiers';+import { TEAMS_ASSISTANT_REQUEST_STATUS } from 'src/features/chat/logic-functions/constants/teams-assistant-request-status';++export default defineObject({+ universalIdentifier: TEAMS_ASSISTANT_REQUEST_OBJECT_UNIVERSAL_IDENTIFIER,+ nameSingular: 'teamsAssistantRequest',+ namePlural: 'teamsAssistantRequests',+ labelSingular: 'Teams Assistant Request',+ labelPlural: 'Teams Assistant Requests',+ description:+ 'A request sent to the Twenty assistant from Microsoft Teams (mention or personal chat), with its processing status and response.',+ icon: 'IconMessage',+ labelIdentifierFieldMetadataUniversalIdentifier:+ TEAMS_ASSISTANT_REQUEST_NAME_FIELD_UNIVERSAL_IDENTIFIER,+ fields: [+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_NAME_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.TEXT,+ label: 'Name',+ description: 'Short preview of the request',+ icon: 'IconAbc',+ name: 'name',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_ACTIVITY_ID_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.TEXT,+ label: 'Teams activity ID',+ description:+ 'Bot Framework activity id of the message, used with the conversation id for deduplication',+ icon: 'IconHash',+ name: 'teamsActivityId',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_CONVERSATION_ID_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.TEXT,+ label: 'Teams conversation ID',+ description: 'Chat or channel thread the request came from',+ icon: 'IconHash',+ name: 'teamsConversationId',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_CONVERSATION_TYPE_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.TEXT,+ label: 'Teams conversation type',+ description: 'Teams conversationType (personal, groupChat, channel)',+ icon: 'IconHash',+ name: 'teamsConversationType',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_SERVICE_URL_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.TEXT,+ label: 'Teams service URL',+ description: 'Verified Bot Connector endpoint the answer is posted to',+ icon: 'IconLink',+ name: 'teamsServiceUrl',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_TENANT_ID_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.TEXT,+ label: 'Microsoft tenant ID',+ description: 'Microsoft tenant the request came from',+ icon: 'IconBuilding',+ name: 'teamsTenantId',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_USER_ID_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.TEXT,+ label: 'Teams user ID',+ description: 'Teams user who sent the request',+ icon: 'IconUser',+ name: 'teamsUserId',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_USER_AAD_OBJECT_ID_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.TEXT,+ label: 'Microsoft Entra user ID',+ description: 'Entra object id of the sender, when Teams provides it',+ icon: 'IconUser',+ name: 'teamsUserAadObjectId',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_WORKSPACE_MEMBER_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.RELATION,+ label: 'Ran as',+ description:+ 'Workspace member the assistant acted as; empty when the Teams account is not mapped',+ icon: 'IconUserCircle',+ name: 'workspaceMember',+ isNullable: true,+ relationTargetObjectMetadataUniversalIdentifier:+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.workspaceMember+ .universalIdentifier,+ relationTargetFieldMetadataUniversalIdentifier:+ TEAMS_ASSISTANT_REQUESTS_ON_WORKSPACE_MEMBER_FIELD_UNIVERSAL_IDENTIFIER,+ universalSettings: {+ relationType: RelationType.MANY_TO_ONE,+ onDelete: OnDeleteAction.SET_NULL,+ joinColumnName: 'workspaceMemberId',+ },+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_TEXT_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.RICH_TEXT,+ label: 'Request',+ description: 'Message text with the bot mention stripped',+ icon: 'IconMessage',+ name: 'requestText',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_RESPONSE_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.RICH_TEXT,+ label: 'Response',+ description: 'Assistant answer posted back to Teams',+ icon: 'IconMessageReply',+ name: 'responseText',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_STATUS_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.SELECT,+ label: 'Status',+ icon: 'IconProgress',+ defaultValue: `'${TEAMS_ASSISTANT_REQUEST_STATUS.PENDING}'`,+ options: [+ {+ id: 'aebd04b2-426d-4137-8ffb-93ed1f10a2f7',+ value: TEAMS_ASSISTANT_REQUEST_STATUS.PENDING,+ label: 'Pending',+ position: 0,+ color: 'gray',+ },+ {+ id: '8bc52347-9bc3-4424-9309-259c2a7a7b60',+ value: TEAMS_ASSISTANT_REQUEST_STATUS.PROCESSING,+ label: 'Processing',+ position: 1,+ color: 'blue',+ },+ {+ id: '6fcf9ea7-ff9e-4f2c-8f33-13c99eb5a457',+ value: TEAMS_ASSISTANT_REQUEST_STATUS.DONE,+ label: 'Done',+ position: 2,+ color: 'green',+ },+ {+ id: '6f4098c6-fb33-4da7-a165-2e2e394dc86b',+ value: TEAMS_ASSISTANT_REQUEST_STATUS.FAILED,+ label: 'Failed',+ position: 3,+ color: 'red',+ },+ ],+ name: 'status',+ },+ {+ universalIdentifier:+ TEAMS_ASSISTANT_REQUEST_ERROR_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.TEXT,+ label: 'Error',+ description: 'Failure reason when the assistant could not answer',+ icon: 'IconAlertTriangle',+ name: 'errorMessage',+ },+ ],+});diff --git a/packages/twenty-apps/public/teams/src/roles/default-function.role.ts b/packages/twenty-apps/public/teams/src/roles/default-function.role.tsindex 5b2c3e428a0..14f2f9ac621 100644--- a/packages/twenty-apps/public/teams/src/roles/default-function.role.ts+++ b/packages/twenty-apps/public/teams/src/roles/default-function.role.ts@@ -4,12 +4,13 @@ import {} from 'twenty-sdk/define';import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';+import { TEAMS_ASSISTANT_REQUEST_OBJECT_UNIVERSAL_IDENTIFIER } from 'src/features/chat/constants/universal-identifiers';export default defineApplicationRole({universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,label: 'Twenty Microsoft Teams tools role',description:- 'Reads calendar events to match Teams meetings and writes imported transcripts to Call Recordings. Chat tools only forward requests to Microsoft Teams using the configured bot credentials.',+ 'Reads calendar events to match Teams meetings and writes imported transcripts to Call Recordings. Tracks assistant requests received from Teams. Chat tools only forward requests to Microsoft Teams using the configured bot credentials.',canReadAllObjectRecords: false,canUpdateAllObjectRecords: false,canSoftDeleteAllObjectRecords: false,@@ -35,6 +36,14 @@ export default defineApplicationRole({canSoftDeleteObjectRecords: false,canDestroyObjectRecords: false,},+ {+ objectUniversalIdentifier:+ TEAMS_ASSISTANT_REQUEST_OBJECT_UNIVERSAL_IDENTIFIER,+ canReadObjectRecords: true,+ canUpdateObjectRecords: true,+ canSoftDeleteObjectRecords: false,+ canDestroyObjectRecords: false,+ },],fieldPermissions: [],permissionFlagUniversalIdentifiers: [],