The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
Fireflies: port app to the CallRecording standard object (#22642)
nitin525ed74b2f98
diff --git a/packages/twenty-apps/public/twenty-fireflies/README.md b/packages/twenty-apps/public/twenty-fireflies/README.mdindex 3834409da17..1ad4fb021b0 100644--- a/packages/twenty-apps/public/twenty-fireflies/README.md+++ b/packages/twenty-apps/public/twenty-fireflies/README.md@@ -1,9 +1,10 @@# Fireflies for Twenty-Sync [Fireflies](https://fireflies.ai) call transcripts and AI summaries onto-the matching `CalendarEvent` in your Twenty CRM — searchable, in context, and-ready for AI agents and workflows to act on. Plus on-demand workflow tools to-sync, list, and search Fireflies calls from the AI chat or workflow builder.+Sync [Fireflies](https://fireflies.ai) call transcripts and AI summaries into+`CallRecording` records linked to the matching `CalendarEvent` in your Twenty+CRM — searchable, in context, and ready for AI agents and workflows to act+on. Plus on-demand workflow tools to sync, list, and search Fireflies calls+from the AI chat or workflow builder.## What this app does@@ -13,8 +14,9 @@ sync, list, and search Fireflies calls from the AI chat or workflow builder.`meeting.summarized` webhook.3. For each event, this app fetches the relevant data via the FirefliesGraphQL API.-4. It finds the matching `CalendarEvent` in Twenty and writes the content- into either the **Transcript** or **Summary** field on that event.+4. It upserts a `CallRecording` record (one per Fireflies call) with the+ diarized transcript and the AI summary, linked to the matching+ `CalendarEvent` when one is found.Alongside the webhook, three [Workflow tools](#workflow-tools) let youtrigger Fireflies actions from the AI chat or as steps inside a workflow,@@ -38,18 +40,22 @@ Both identifiers are populated by Twenty's calendar drivers on every syncedCalendarEvent, so any meeting that's been pulled in via Google / Outlook /CalDAV calendar sync will match exactly. The matcher does **not** fall backto fuzzy URL matching — if the transcript can't be tied to a synced calendar-event, the call is treated as an orphan and skipped (see-[Limitations](#limitations) below). This avoids silently writing transcripts-to the wrong event.+event, the CallRecording is still created, just without a linked calendar+event. This avoids silently linking transcripts to the wrong event.## What gets added to your Twenty workspace-Two new fields on the standard **CalendarEvent** object:+The app writes to the standard **CallRecording** object (no new schema):-- **Transcript** — rich-text field, speaker-attributed (e.g. *"**Sarah:**- Hi there"*, then *"**John:** Doing well, thanks."*).-- **Summary** — rich-text field with the Fireflies AI summary: a bullet-list- overview, action items grouped by speaker, topics discussed, and keywords.+- One CallRecording per Fireflies call, with a deterministic id — the+ `meeting.transcribed` webhook, the `meeting.summarized` webhook, and manual+ syncs all converge on the same record.+- **Transcript** — the diarized transcript (speaker names and sentence-level+ timestamps) stored in the CallRecording `transcript` field.+- **Summary** — the Fireflies AI summary (overview, action items, topics,+ keywords) stored as rich text in the CallRecording `summary` field.+- **Title, start/end time, external recording id, and the CalendarEvent+ link** filled from the Fireflies call metadata.Plus three workflow tools — see [Workflow tools](#workflow-tools) below.@@ -58,16 +64,16 @@ Plus three workflow tools — see [Workflow tools](#workflow-tools) below.Once the API key is configured, three tools become available in the workflowbuilder and the AI chat — covering the cases the webhook can't:-- **Sync Fireflies Call** — *"sync the Fireflies call `01HXYZ...` onto its- CalendarEvent now"*. As a workflow step: provide `transcriptId`. Runs the+- **Sync Fireflies Call** — *"sync the Fireflies call `01HXYZ...` into a+ CallRecording now"*. As a workflow step: provide `transcriptId`. Runs thesame pipeline as the webhook (fetch transcript + AI summary, find matching- CalendarEvent, write Transcript + Summary fields) on demand. Use cases:+ CalendarEvent, upsert the CallRecording) on demand. Use cases:**backfilling** historical calls that happened before the app wasinstalled; **recovering** from a missed webhook (e.g. the calendar eventhadn't synced yet when Fireflies pushed); or triggering a sync from aworkflow instead of waiting for Fireflies. Output includes- `calendarEventId`, `updatedFields`, and a per-field outcome breakdown so- partial successes are visible.+ `callRecordingId`, `calendarEventId`, `updatedFields`, and a per-field+ outcome breakdown so partial successes are visible.- **List Fireflies Calls By Participant** — *"show me my last 5 calls with[email protected]"*. As a workflow step: provide `participantEmail` (andoptional `limit`, max 50). Returns recent Fireflies calls — newest first —@@ -82,8 +88,8 @@ builder and the AI chat — covering the cases the webhook can't:The list-by-participant and search tools return the same compact call shape:`id`, `title`, `date`, `durationMinutes`, `participants`, `hostEmail`,-`transcriptUrl`, `meetingLink`. To then sync any of those calls onto its-CalendarEvent, pass the `id` from a list result into **Sync Fireflies Call**.+`transcriptUrl`, `meetingLink`. To then sync any of those calls into a+CallRecording, pass the `id` from a list result into **Sync Fireflies Call**.## Installing@@ -96,24 +102,38 @@ CalendarEvent, pass the `id` from a list result into **Sync Fireflies Call**.> webhook, your Twenty admin needs to follow the> [Self-hosting setup](#self-hosting-setup-admin-only) section.+## Upgrading from 0.1.x++Version 0.1.x stored transcripts and summaries as two rich-text fields on+CalendarEvent. Upgrading removes those fields **and their stored content** —+recordings now live on the standard CallRecording object instead.++The removed content is a cache of Fireflies data: any call still available+in Fireflies can be re-ingested as a CallRecording by passing its id to+**Sync Fireflies Call** (find ids with the list / search tools). An+automatic history backfill on install and upgrade is planned as a follow-up.+## LimitationsWhat this connector intentionally does **not** support in v1:-- **Calls without a matching CalendarEvent (orphan calls).** Ad-hoc calls- that were never on anyone's synced calendar are skipped. The webhook logs- the skip reason; the transcript still lives in Fireflies. Synthetic event- creation for orphans is planned for v2.+- **Audio / video media ingestion.** Fireflies' `audio_url` / `video_url`+ are not downloaded yet; the CallRecording holds the transcript and summary+ only. Media ingestion is planned for a follow-up.- **Fireflies sentiment, speaker analytics, transcript chapters.** Onlythe raw transcript and the AI summary (overview, action items, topics,keywords) are synced today.+- **Calls without a matching CalendarEvent (orphan calls).** These are no+ longer skipped — the CallRecording is created — but it stays unlinked+ until the calendar event syncs; re-running **Sync Fireflies Call** after+ the calendar sync fills the link.- **Per-user Fireflies accounts.** All transcripts come through oneworkspace-shared API key (set by the admin). Per-user OAuth-styleconnections require extending Twenty's connection provider system and areplanned once we have evidence that workspace-shared is too coarse.-- **Editing transcripts or summaries in Twenty.** The fields are writable- but the next Fireflies sync overwrites any manual edits — treat them as- read-only.+- **Editing transcripts or summaries in Twenty.** The CallRecording fields+ are writable but the next Fireflies sync overwrites any manual edits —+ treat them as read-only.## Troubleshooting@@ -121,12 +141,12 @@ What this connector intentionally does **not** support in v1:|---|---|---|| Webhook returns `Fireflies is not configured` | `FIREFLIES_API_KEY` not set | Admin: paste the API key in **Settings → Applications → Fireflies → Settings** || Webhook returns `Invalid webhook signature` | `FIREFLIES_WEBHOOK_SECRET` mismatch between Fireflies and Twenty | Re-copy the signing secret from the Fireflies webhook configuration and paste it into the Twenty app settings |-| Webhook returns `skipped: No CalendarEvent matched the transcript by external ID or iCalUid` | The meeting was never on a synced calendar in Twenty, or the workspace has no Google/Outlook/CalDAV calendar connection set up | Connect the relevant calendar provider in **Settings → Accounts** so the calendar event lands in Twenty with `eventExternalId` and `iCalUid` populated. Manually-created CalendarEvents are intentionally not matched in v1 |+| CallRecording is created but has no linked CalendarEvent | The meeting was never on a synced calendar in Twenty, or the workspace has no Google/Outlook/CalDAV calendar connection set up | Connect the relevant calendar provider in **Settings → Accounts** so the calendar event lands in Twenty with `eventExternalId` and `iCalUid` populated, then re-run **Sync Fireflies Call** for that transcript. Manually-created CalendarEvents are intentionally not matched in v1 || Transcript appears empty | Fireflies returned no sentences (call too short, audio failed) | Check the call in the Fireflies dashboard; nothing this app can do || Summary appears empty | Fireflies hasn't summarized the call yet, or the call was too short to summarize | Fireflies sends `meeting.summarized` separately from `meeting.transcribed` (typically a minute or two later); ensure that event is subscribed to in your Webhooks V2 config || Summary is populated but Transcript isn't (or vice versa) | Only one of the two Fireflies events is subscribed to | Subscribe to both `meeting.transcribed` and `meeting.summarized` in your Fireflies Webhooks V2 configuration || Fireflies API errors with `401` | API key wrong, rotated, or revoked | Generate a new key in Fireflies → Integrations → Fireflies API → Regenerate, then update `FIREFLIES_API_KEY` |-| **Sync Fireflies Call** reports `No fields were updated` | The Fireflies call's `calendar_id` / `cal_id` doesn't match any CalendarEvent's `iCalUid` or `eventExternalId` (orphan call), or the per-field outcomes show transient Fireflies API failures | Check the `fieldOutcomes` array in the result — `skipped` means orphan call (same limitation as the webhook); `error` means Fireflies-side failure (retry, or inspect the error message) |+| **Sync Fireflies Call** reports `No CallRecording was written` | Fireflies returned no transcript sentences and no summary for the call, or the per-field outcomes show transient Fireflies API failures | Check the `fieldOutcomes` array in the result — `skipped` means Fireflies had no content for that field; `error` means Fireflies-side failure (retry, or inspect the error message) || **List / Search** tools return `count: 0` for a contact you've definitely talked to | Email mismatch — Fireflies stores the address as the participant joined the meeting with, which may differ from the contact's primary address in Twenty (aliases, plus-addressing, work vs. personal) | Try the contact's other known email addresses; cross-check the `participants` list on a known matching call |---@@ -162,9 +182,9 @@ supported.`openssl rand -hex 32`). Save it; you'll paste it into Twenty next.4. Under **Events**, subscribe to **both**:- **`meeting.transcribed`** — fires when the transcript is ready and- writes it to the **Transcript** field.+ writes it to the CallRecording's **Transcript** field.- **`meeting.summarized`** — fires once Fireflies finishes its AI summary- and writes it to the **Summary** field.+ and writes it to the CallRecording's **Summary** field.Subscribing to only one is fine if you don't want the other fieldpopulated; the app dispatches per event.5. **Save** the configuration.@@ -175,7 +195,8 @@ supported.2. Paste the Fireflies API key into the `FIREFLIES_API_KEY` row.3. Paste the signing secret into the `FIREFLIES_WEBHOOK_SECRET` row.-After saving, the next time Fireflies finishes processing a recording, the-transcript will land on the matching CalendarEvent within a few seconds;-the summary follows once Fireflies finishes the AI summarization step-(typically a minute or two later — Fireflies sends two separate webhooks).+After saving, the next time Fireflies finishes processing a recording, a+CallRecording with the transcript will appear (linked to the matching+CalendarEvent) within a few seconds; the summary follows once Fireflies+finishes the AI summarization step (typically a minute or two later —+Fireflies sends two separate webhooks).diff --git a/packages/twenty-apps/public/twenty-fireflies/package.json b/packages/twenty-apps/public/twenty-fireflies/package.jsonindex cd0a93f31fa..b7dcff7a293 100644--- a/packages/twenty-apps/public/twenty-fireflies/package.json+++ b/packages/twenty-apps/public/twenty-fireflies/package.json@@ -1,6 +1,6 @@{"name": "@twentyhq/twenty-fireflies",- "version": "0.1.0",+ "version": "0.2.0","description": "Fireflies call-transcript connector for Twenty","license": "MIT","engines": {@@ -28,8 +28,8 @@"oxlint": "^0.16.0","react": "^18.2.0","react-dom": "^18.2.0",- "twenty-client-sdk": "^2.16.0",- "twenty-sdk": "^2.16.0",+ "twenty-client-sdk": "^2.18.0",+ "twenty-sdk": "^2.18.0","typescript": "^5.9.3","vite-tsconfig-paths": "^4.2.1","vitest": "^4.0.0"diff --git a/packages/twenty-apps/public/twenty-fireflies/public/gallery/summary-on-calendar-event.png b/packages/twenty-apps/public/twenty-fireflies/public/gallery/summary-on-calendar-event.pngdeleted file mode 100644index 3a97276e1ef..00000000000Binary files a/packages/twenty-apps/public/twenty-fireflies/public/gallery/summary-on-calendar-event.png and /dev/null differdiff --git a/packages/twenty-apps/public/twenty-fireflies/public/gallery/transcript-on-calendar-event.png b/packages/twenty-apps/public/twenty-fireflies/public/gallery/transcript-on-calendar-event.pngdeleted file mode 100644index d671ed55481..00000000000Binary files a/packages/twenty-apps/public/twenty-fireflies/public/gallery/transcript-on-calendar-event.png and /dev/null differdiff --git a/packages/twenty-apps/public/twenty-fireflies/src/__tests__/twenty-fireflies.integration-test.ts b/packages/twenty-apps/public/twenty-fireflies/src/__tests__/twenty-fireflies.integration-test.tsindex d81520194f0..4d0af6b506a 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/__tests__/twenty-fireflies.integration-test.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/__tests__/twenty-fireflies.integration-test.ts@@ -1,7 +1,12 @@+import { CoreApiClient } from 'twenty-client-sdk/core';import { MetadataApiClient } from 'twenty-client-sdk/metadata';import { describe, expect, it } from 'vitest';import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';+import {+ CALL_RECORDING_REQUEST_STATUS,+ CALL_RECORDING_STATUS,+} from 'src/logic-functions/constants/call-recording-status';describe('App installation', () => {it('should find the installed Fireflies app in the applications list', async () => {@@ -23,3 +28,86 @@ describe('App installation', () => {expect(matchingApplication).toBeDefined();});});++// The published twenty-client-sdk types only export CoreApiClient/CoreSchema;+// the enum exports appear at runtime after dev:generate-client regenerates the+// client against the server, hence the cast and the runtime guard.+type GeneratedCoreSchemaRuntime = {+ enumCallRecordingStatusEnum?: Record<string, string>;+};++const getServerCallRecordingStatuses = async (): Promise<string[]> => {+ const generatedCoreSchema = (await import(+ 'twenty-client-sdk/core'+ )) as unknown as GeneratedCoreSchemaRuntime;+ const statusEnum = generatedCoreSchema.enumCallRecordingStatusEnum;++ if (statusEnum === undefined) {+ throw new Error(+ 'enumCallRecordingStatusEnum is missing from twenty-client-sdk/core; regenerate the client against a running server (yarn twenty dev) before the integration suite',+ );+ }++ return Object.values(statusEnum);+};++describe('CallRecording status contract', () => {+ it('should accept every status and request status value the app mirrors', async () => {+ const client = new CoreApiClient();+ const serverCallRecordingStatuses = await getServerCallRecordingStatuses();++ expect(serverCallRecordingStatuses).toEqual(+ expect.arrayContaining(Object.values(CALL_RECORDING_STATUS)),+ );++ const created = await client.mutation({+ createCallRecording: {+ __args: {+ data: {+ title: 'Fireflies integration test recording',+ status: CALL_RECORDING_STATUS.PROCESSING,+ recordingRequestStatus: CALL_RECORDING_REQUEST_STATUS.REQUESTED,+ },+ },+ id: true,+ status: true,+ recordingRequestStatus: true,+ },+ });++ const callRecordingId = created.createCallRecording?.id;++ expect(callRecordingId).toBeDefined();+ expect(created.createCallRecording?.status).toBe(+ CALL_RECORDING_STATUS.PROCESSING,+ );+ expect(created.createCallRecording?.recordingRequestStatus).toBe(+ CALL_RECORDING_REQUEST_STATUS.REQUESTED,+ );++ if (callRecordingId === undefined) {+ throw new Error('Expected call recording creation to return an id');+ }++ const updated = await client.mutation({+ updateCallRecording: {+ __args: {+ id: callRecordingId,+ data: { status: CALL_RECORDING_STATUS.COMPLETED },+ },+ status: true,+ },+ });++ expect(updated.updateCallRecording?.status).toBe(+ CALL_RECORDING_STATUS.COMPLETED,+ );++ await client.mutation({+ destroyCallRecording: {+ __args: { id: callRecordingId },+ id: true,+ },+ });+ });+});diff --git a/packages/twenty-apps/public/twenty-fireflies/src/application.config.ts b/packages/twenty-apps/public/twenty-fireflies/src/application.config.tsindex 06429787b64..af0342f3458 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/application.config.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/application.config.ts@@ -10,13 +10,11 @@ export default defineApplication({universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,displayName: 'Twenty Fireflies',description:- 'Sync Fireflies call transcripts and AI summaries onto matching CalendarEvent records in Twenty, and trigger sync / list / search of Fireflies calls from workflows and the AI chat.',+ 'Sync Fireflies call transcripts and AI summaries into CallRecording records linked to matching CalendarEvents in Twenty, and trigger sync / list / search of Fireflies calls from workflows and the AI chat.',logoUrl: 'public/twenty-fireflies.svg',author: 'Twenty',category: 'Productivity',screenshots: [- 'public/gallery/transcript-on-calendar-event.png',- 'public/gallery/summary-on-calendar-event.png','public/gallery/workflow-builder-actions.png','public/gallery/app-settings.png',],diff --git a/packages/twenty-apps/public/twenty-fireflies/src/constants/universal-identifiers.ts b/packages/twenty-apps/public/twenty-fireflies/src/constants/universal-identifiers.tsindex e6d6808a1a3..a8adca1945a 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/constants/universal-identifiers.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/constants/universal-identifiers.ts@@ -10,12 +10,6 @@ export const FIREFLIES_API_KEY_VARIABLE_UNIVERSAL_IDENTIFIER =export const FIREFLIES_WEBHOOK_SECRET_VARIABLE_UNIVERSAL_IDENTIFIER ='a1ef34d9-f0e7-483e-9909-fce2757bdd23';-export const TRANSCRIPT_ON_CALENDAR_EVENT_FIELD_UNIVERSAL_IDENTIFIER =- 'e444c83b-0d28-41e2-8c3f-4ede9eb88a75';--export const SUMMARY_ON_CALENDAR_EVENT_FIELD_UNIVERSAL_IDENTIFIER =- 'c5f8a3e2-7b91-4d2e-b6a4-9f3e1d5c8a02';-export const FIREFLIES_WEBHOOK_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER ='e0c2d033-0ef4-4b92-9e64-2d8f2e4c497e';diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/constants/call-recording-status.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/constants/call-recording-status.tsnew file mode 100644index 00000000000..3f242047a9d--- /dev/null+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/constants/call-recording-status.ts@@ -0,0 +1,9 @@+// TODO: duplicated from core CallRecording select options — import once a shared package exists.+export const CALL_RECORDING_STATUS = {+ PROCESSING: 'PROCESSING',+ COMPLETED: 'COMPLETED',+} as const;++export const CALL_RECORDING_REQUEST_STATUS = {+ REQUESTED: 'REQUESTED',+} as const;diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/fireflies-sync-call.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/fireflies-sync-call.tsindex 92c7d21f888..a9e781355ff 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/fireflies-sync-call.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/fireflies-sync-call.ts@@ -9,7 +9,7 @@ export default defineLogicFunction({universalIdentifier: FIREFLIES_SYNC_CALL_UNIVERSAL_IDENTIFIER,name: 'fireflies-sync-call',description:- 'Sync a single Fireflies call onto its matching CalendarEvent on demand: fetches both transcript and AI summary from Fireflies and writes them to the Transcript and Summary fields. Same matching rules as the webhook (Fireflies calendar_id / cal_id ↔ Twenty eventExternalId or iCalUid). Useful for backfilling history, recovering from a missed webhook, or syncing on a workflow trigger instead of waiting for Fireflies to push.',+ 'Sync a single Fireflies call into a CallRecording record on demand: fetches both transcript and AI summary from Fireflies and upserts them onto one CallRecording linked to the matching CalendarEvent. Same matching rules as the webhook (Fireflies calendar_id / cal_id ↔ Twenty eventExternalId or iCalUid). Useful for backfilling history, recovering from a missed webhook, or syncing on a workflow trigger instead of waiting for Fireflies to push.',timeoutSeconds: 60,toolTriggerSettings: {inputSchema: firefliesSyncCallInputSchema,@@ -25,6 +25,7 @@ export default defineLogicFunction({message: { type: 'string' },error: { type: 'string' },transcriptId: { type: 'string' },+ callRecordingId: { type: 'string' },calendarEventId: { type: 'string' },updatedFields: { type: 'array', items: { type: 'string' } },fieldOutcomes: {diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/fireflies-webhook.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/fireflies-webhook.tsindex 48d8fa986d4..657ab4bac90 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/fireflies-webhook.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/fireflies-webhook.ts@@ -56,7 +56,7 @@ export default defineLogicFunction({universalIdentifier: FIREFLIES_WEBHOOK_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,name: 'fireflies-webhook',description:- 'Receives Fireflies webhook events when a transcript is ready, then writes the transcript onto the matching CalendarEvent.',+ 'Receives Fireflies webhook events when a transcript or summary is ready, then upserts a CallRecording record linked to the matching CalendarEvent.',timeoutSeconds: 60,handler: firefliesWebhookRouteHandler,httpRouteTriggerSettings: {diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/handlers/fireflies-sync-call-handler.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/handlers/fireflies-sync-call-handler.tsindex 33407baebf3..d9eeb566dd3 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/handlers/fireflies-sync-call-handler.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/handlers/fireflies-sync-call-handler.ts@@ -9,8 +9,9 @@ import {import { getFirefliesApiKey } from 'src/logic-functions/utils/get-fireflies-api-key';import {type FirefliesSyncableField,- syncFirefliesFieldToCalendarEvent,-} from 'src/logic-functions/utils/sync-fireflies-field-to-calendar-event';+ type SyncFirefliesCallResult,+ syncFirefliesCallToCallRecording,+} from 'src/logic-functions/utils/sync-fireflies-call-to-call-recording';const ALL_FIELDS: FirefliesSyncableField[] = ['transcript', 'summary'];@@ -49,16 +50,19 @@ export const firefliesSyncCallHandler = async (const client = new CoreApiClient();- const results = await Promise.all(- ALL_FIELDS.map((field) =>- syncFirefliesFieldToCalendarEvent({+ // Sequential: both fields upsert the same row, concurrent runs would race on the create.+ const results: SyncFirefliesCallResult[] = [];++ for (const field of ALL_FIELDS) {+ results.push(+ await syncFirefliesCallToCallRecording({apiKey: apiKeyResult.apiKey,client,transcriptId,field,}),- ),- );+ );+ }const fieldOutcomes: FirefliesSyncCallFieldOutcome[] = results.map((result) => {@@ -80,9 +84,10 @@ export const firefliesSyncCallHandler = async (.filter((outcome) => outcome.status === 'updated').map((outcome) => outcome.field);- const calendarEventId = results.find(- (result) => result.status === 'updated',- )?.calendarEventId;+ const updatedResult = results.find(+ (result): result is Extract<SyncFirefliesCallResult, { status: 'updated' }> =>+ result.status === 'updated',+ );if (updatedFields.length === 0) {const skipReasons = fieldOutcomes@@ -94,7 +99,7 @@ export const firefliesSyncCallHandler = async (return {success: false,- message: `No fields were updated on the matching CalendarEvent for Fireflies transcript ${transcriptId}.`,+ message: `No CallRecording was written for Fireflies transcript ${transcriptId}.`,error: [...errors, ...skipReasons].join(' | ') || 'No fields updated.',transcriptId,fieldOutcomes,@@ -111,14 +116,15 @@ export const firefliesSyncCallHandler = async (partialFailures.length > 0? `Synced ${updatedFields.join(' + ',- )} for Fireflies transcript ${transcriptId} (with errors on ${partialFailures+ )} onto the CallRecording for Fireflies transcript ${transcriptId} (with errors on ${partialFailures.map((outcome) => outcome.field).join(', ')}).`: `Synced ${updatedFields.join(' + ',- )} for Fireflies transcript ${transcriptId}.`,+ )} onto the CallRecording for Fireflies transcript ${transcriptId}.`,transcriptId,- calendarEventId,+ callRecordingId: updatedResult?.callRecordingId,+ calendarEventId: updatedResult?.calendarEventId,updatedFields,fieldOutcomes,};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/handlers/fireflies-webhook-handler.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/handlers/fireflies-webhook-handler.tsindex 0c28504f094..ca86fcbb872 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/handlers/fireflies-webhook-handler.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/handlers/fireflies-webhook-handler.ts@@ -5,8 +5,8 @@ import { type FirefliesWebhookResult } from 'src/logic-functions/types/firefliesimport { getFirefliesApiKey } from 'src/logic-functions/utils/get-fireflies-api-key';import {type FirefliesSyncableField,- syncFirefliesFieldToCalendarEvent,-} from 'src/logic-functions/utils/sync-fireflies-field-to-calendar-event';+ syncFirefliesCallToCallRecording,+} from 'src/logic-functions/utils/sync-fireflies-call-to-call-recording';const TRANSCRIPT_READY_EVENT = 'meeting.transcribed';const SUMMARY_READY_EVENT = 'meeting.summarized';@@ -47,7 +47,7 @@ export const firefliesWebhookHandler = async ({return { error: apiKeyResult.error, meetingId };}- const syncResult = await syncFirefliesFieldToCalendarEvent({+ const syncResult = await syncFirefliesCallToCallRecording({apiKey: apiKeyResult.apiKey,client: new CoreApiClient(),transcriptId: meetingId,@@ -65,6 +65,7 @@ export const firefliesWebhookHandler = async ({return {action: 'updated',field: syncResult.field,+ callRecordingId: syncResult.callRecordingId,calendarEventId: syncResult.calendarEventId,meetingId,};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-sync-call-result.type.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-sync-call-result.type.tsindex 070e0c05913..53edb999665 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-sync-call-result.type.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-sync-call-result.type.ts@@ -1,4 +1,4 @@-import { type FirefliesSyncableField } from 'src/logic-functions/utils/sync-fireflies-field-to-calendar-event';+import { type FirefliesSyncableField } from 'src/logic-functions/utils/sync-fireflies-call-to-call-recording';export type FirefliesSyncCallFieldOutcome =| { field: FirefliesSyncableField; status: 'updated' }@@ -10,6 +10,7 @@ export type FirefliesSyncCallResult = {message: string;error?: string;transcriptId?: string;+ callRecordingId?: string;calendarEventId?: string;updatedFields?: FirefliesSyncableField[];fieldOutcomes?: FirefliesSyncCallFieldOutcome[];diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-transcript.type.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-transcript.type.tsindex da82410363e..819534b5231 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-transcript.type.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-transcript.type.ts@@ -2,6 +2,7 @@ export type FirefliesTranscriptSentence = {speaker_name: string | null;text: string;start_time: number | null;+ end_time?: number | null;};export type FirefliesSummary = {diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-webhook-payload.type.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-webhook-payload.type.tsindex 13984849119..4d5dfd6ac11 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-webhook-payload.type.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/types/fireflies-webhook-payload.type.ts@@ -11,7 +11,8 @@ export type FirefliesWebhookResult =| {action: 'updated';field: FirefliesSyncedField;- calendarEventId: string;+ callRecordingId: string;+ calendarEventId?: string;meetingId: string;}| { skipped: true; reason: string; meetingId?: string }diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/__tests__/compute-call-recording-id-for-fireflies-meeting.test.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/__tests__/compute-call-recording-id-for-fireflies-meeting.test.tsnew file mode 100644index 00000000000..791ade49e90--- /dev/null+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/__tests__/compute-call-recording-id-for-fireflies-meeting.test.ts@@ -0,0 +1,26 @@+import { describe, expect, it } from 'vitest';++import { computeCallRecordingIdForFirefliesMeeting } from 'src/logic-functions/utils/compute-call-recording-id-for-fireflies-meeting';++const UUID_V4_PATTERN =+ /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;++describe('computeCallRecordingIdForFirefliesMeeting', () => {+ it('should produce a valid v4-shaped UUID', () => {+ const id = computeCallRecordingIdForFirefliesMeeting('01K1234ABCD');++ expect(id).toMatch(UUID_V4_PATTERN);+ });++ it('should be deterministic for the same meeting id', () => {+ expect(computeCallRecordingIdForFirefliesMeeting('meeting-a')).toBe(+ computeCallRecordingIdForFirefliesMeeting('meeting-a'),+ );+ });++ it('should differ for different meeting ids', () => {+ expect(computeCallRecordingIdForFirefliesMeeting('meeting-a')).not.toBe(+ computeCallRecordingIdForFirefliesMeeting('meeting-b'),+ );+ });+});diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/__tests__/format-transcript-as-markdown.test.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/__tests__/format-transcript-as-markdown.test.tsdeleted file mode 100644index 42b58154e00..00000000000--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/__tests__/format-transcript-as-markdown.test.ts+++ /dev/null@@ -1,87 +0,0 @@-import { describe, expect, it } from 'vitest';--import { type FirefliesTranscript } from 'src/logic-functions/types/fireflies-transcript.type';-import { formatTranscriptAsMarkdown } from 'src/logic-functions/utils/format-transcript-as-markdown';--const buildTranscript = (- sentences: FirefliesTranscript['sentences'],-): FirefliesTranscript => ({- id: 'abc',- title: 'Test call',- date: 1700000000000,- duration: 30,- meeting_link: 'https://zoom.us/j/1234',- participants: ['[email protected]'],- organizer_email: '[email protected]',- sentences,-});--describe('formatTranscriptAsMarkdown', () => {- it('returns a placeholder when there are no sentences', () => {- const result = formatTranscriptAsMarkdown(buildTranscript([]));-- expect(result).toContain('Fireflies returned no transcript content');- });-- it('returns a placeholder when sentences is null', () => {- const result = formatTranscriptAsMarkdown(buildTranscript(null));-- expect(result).toContain('Fireflies returned no transcript content');- });-- it('groups consecutive sentences from the same speaker into one paragraph', () => {- const result = formatTranscriptAsMarkdown(- buildTranscript([- { speaker_name: 'Sarah', text: 'Hi there', start_time: 0 },- { speaker_name: 'Sarah', text: 'How are you?', start_time: 1 },- { speaker_name: 'John', text: 'Doing well, thanks.', start_time: 2 },- ]),- );-- expect(result).toBe(- '**Sarah:** Hi there How are you?\n\n**John:** Doing well, thanks.',- );- });-- it('falls back to "Speaker" when the speaker name is missing', () => {- const result = formatTranscriptAsMarkdown(- buildTranscript([{ speaker_name: null, text: 'Hello', start_time: 0 }]),- );-- expect(result).toBe('**Speaker:** Hello');- });-- it('falls back to "Speaker" when the speaker name is whitespace-only', () => {- const result = formatTranscriptAsMarkdown(- buildTranscript([- { speaker_name: ' ', text: 'Hello', start_time: 0 },- { speaker_name: '\n\t', text: 'World', start_time: 1 },- ]),- );-- expect(result).toBe('**Speaker:** Hello World');- });-- it('skips empty sentence text', () => {- const result = formatTranscriptAsMarkdown(- buildTranscript([- { speaker_name: 'Sarah', text: ' ', start_time: 0 },- { speaker_name: 'Sarah', text: 'Hello', start_time: 1 },- ]),- );-- expect(result).toBe('**Sarah:** Hello');- });-- it('returns the placeholder when every sentence is whitespace-only', () => {- const result = formatTranscriptAsMarkdown(- buildTranscript([- { speaker_name: 'Sarah', text: ' ', start_time: 0 },- { speaker_name: 'John', text: '\n\t', start_time: 1 },- { speaker_name: null, text: '', start_time: 2 },- ]),- );-- expect(result).toContain('Fireflies returned no transcript content');- });-});diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/__tests__/map-fireflies-sentences-to-transcript-entries.test.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/__tests__/map-fireflies-sentences-to-transcript-entries.test.tsnew file mode 100644index 00000000000..782f8bdc9e7--- /dev/null+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/__tests__/map-fireflies-sentences-to-transcript-entries.test.ts@@ -0,0 +1,79 @@+import { describe, expect, it } from 'vitest';++import { mapFirefliesSentencesToTranscriptEntries } from 'src/logic-functions/utils/map-fireflies-sentences-to-transcript-entries';++describe('mapFirefliesSentencesToTranscriptEntries', () => {+ it('should map sentences to diarized entries with relative timestamps', () => {+ const entries = mapFirefliesSentencesToTranscriptEntries([+ {+ speaker_name: 'Sarah',+ text: 'Hi there, how are you?',+ start_time: 1.5,+ end_time: 3.2,+ },+ {+ speaker_name: 'John',+ text: 'Doing well, thanks.',+ start_time: 4,+ end_time: 5.5,+ },+ ]);++ expect(entries).toEqual([+ {+ participant: { name: 'Sarah' },+ words: [+ {+ text: 'Hi there, how are you?',+ start_timestamp: { relative: 1.5 },+ end_timestamp: { relative: 3.2 },+ },+ ],+ },+ {+ participant: { name: 'John' },+ words: [+ {+ text: 'Doing well, thanks.',+ start_timestamp: { relative: 4 },+ end_timestamp: { relative: 5.5 },+ },+ ],+ },+ ]);+ });++ it('should omit end_timestamp when end_time is missing so players span to the next entry', () => {+ const entries = mapFirefliesSentencesToTranscriptEntries([+ { speaker_name: 'Sarah', text: 'Hello.', start_time: 2 },+ ]);++ expect(entries[0].words[0]).toEqual({+ text: 'Hello.',+ start_timestamp: { relative: 2 },+ });+ });++ it('should omit timestamps when start_time is null', () => {+ const entries = mapFirefliesSentencesToTranscriptEntries([+ { speaker_name: 'Sarah', text: 'Hello.', start_time: null },+ ]);++ expect(entries[0].words[0]).toEqual({ text: 'Hello.' });+ });++ it('should label missing speakers and skip empty sentences', () => {+ const entries = mapFirefliesSentencesToTranscriptEntries([+ { speaker_name: null, text: 'Unattributed line.', start_time: 0 },+ { speaker_name: 'Sarah', text: ' ', start_time: 1 },+ ]);++ expect(entries).toHaveLength(1);+ expect(entries[0].participant.name).toBe('Speaker');+ });++ it('should return an empty array for null or undefined sentences', () => {+ expect(mapFirefliesSentencesToTranscriptEntries(null)).toEqual([]);+ expect(mapFirefliesSentencesToTranscriptEntries(undefined)).toEqual([]);+ });+});diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/compute-call-recording-id-for-fireflies-meeting.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/compute-call-recording-id-for-fireflies-meeting.tsnew file mode 100644index 00000000000..a411d8b10df--- /dev/null+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/compute-call-recording-id-for-fireflies-meeting.ts@@ -0,0 +1,18 @@+import { createHash } from 'crypto';++// Same Fireflies meeting → same id, so all webhooks and syncs converge on one row.+export const computeCallRecordingIdForFirefliesMeeting = (+ firefliesMeetingId: string,+): string => {+ const bytes = createHash('sha256')+ .update(`fireflies:${firefliesMeetingId}`)+ .digest();++ // v4 version/variant bits so server-side UUID validation accepts the hash.+ bytes[6] = (bytes[6] & 0x0f) | 0x40;+ bytes[8] = (bytes[8] & 0x3f) | 0x80;++ const hex = bytes.subarray(0, 16).toString('hex');++ return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;+};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/fetch-fireflies-summary.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/fetch-fireflies-summary.tsindex a0fdc5644ba..a651f6ff96b 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/fetch-fireflies-summary.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/fetch-fireflies-summary.ts@@ -9,6 +9,7 @@ const SUMMARY_QUERY = `transcript(id: $transcriptId) {idtitle+ datedurationmeeting_linkparticipantsdiff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/fetch-fireflies-transcript.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/fetch-fireflies-transcript.tsindex f4feac5083b..06dadb78516 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/fetch-fireflies-transcript.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/fetch-fireflies-transcript.ts@@ -9,6 +9,7 @@ const TRANSCRIPT_QUERY = `transcript(id: $transcriptId) {idtitle+ datedurationmeeting_linkparticipants@@ -20,6 +21,7 @@ const TRANSCRIPT_QUERY = `speaker_nametextstart_time+ end_time}}}diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/find-matching-calendar-event.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/find-matching-calendar-event.tsindex 58ee50a3e01..b763178a068 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/find-matching-calendar-event.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/find-matching-calendar-event.ts@@ -112,6 +112,6 @@ export const findMatchingCalendarEvent = async ({return {matched: false,reason:- 'No CalendarEvent matched the transcript by external ID or iCalUid. Either the meeting was never on a synced calendar, or its calendar sync (Google/Outlook/CalDAV) is not configured in Twenty. Orphan calls are skipped in v1.',+ 'No CalendarEvent matched the transcript by external ID or iCalUid. Either the meeting was never on a synced calendar, or its calendar sync (Google/Outlook/CalDAV) is not configured in Twenty. The CallRecording is created without a linked calendar event.',};};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/format-transcript-as-markdown.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/format-transcript-as-markdown.tsdeleted file mode 100644index 18dfbbbd905..00000000000--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/format-transcript-as-markdown.ts+++ /dev/null@@ -1,57 +0,0 @@-import { isNonEmptyArray, isNonEmptyString } from '@sniptt/guards';-import { isDefined } from 'src/utils/is-defined';--import { type FirefliesTranscript } from 'src/logic-functions/types/fireflies-transcript.type';--const UNKNOWN_SPEAKER_LABEL = 'Speaker';-const EMPTY_TRANSCRIPT_MESSAGE =- '_Fireflies returned no transcript content for this meeting._';--export const formatTranscriptAsMarkdown = (- transcript: FirefliesTranscript,-): string => {- const sentences = transcript.sentences ?? [];-- const lines: string[] = [];- let currentSpeaker: string | null = null;- let currentLines: string[] = [];-- const flush = () => {- if (!isNonEmptyArray(currentLines)) {- return;- }-- const speakerLabel = isDefined(currentSpeaker)- ? currentSpeaker- : UNKNOWN_SPEAKER_LABEL;-- lines.push(`**${speakerLabel}:** ${currentLines.join(' ')}`);- currentLines = [];- };-- for (const sentence of sentences) {- const text = sentence.text.trim();-- if (!isNonEmptyString(text)) {- continue;- }-- const trimmedSpeaker = sentence.speaker_name?.trim();- const speaker = isNonEmptyString(trimmedSpeaker) ? trimmedSpeaker : null;-- if (speaker !== currentSpeaker) {- flush();- currentSpeaker = speaker;- }-- currentLines.push(text);- }-- flush();-- if (!isNonEmptyArray(lines)) {- return EMPTY_TRANSCRIPT_MESSAGE;- }-- return lines.join('\n\n');-};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/map-fireflies-sentences-to-transcript-entries.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/map-fireflies-sentences-to-transcript-entries.tsnew file mode 100644index 00000000000..07106943220--- /dev/null+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/map-fireflies-sentences-to-transcript-entries.ts@@ -0,0 +1,63 @@+import { isNonEmptyString } from '@sniptt/guards';++import { type FirefliesTranscriptSentence } from 'src/logic-functions/types/fireflies-transcript.type';++const UNKNOWN_SPEAKER_LABEL = 'Speaker';++export type TranscriptEntryWord = {+ text: string;+ start_timestamp?: { relative: number };+ end_timestamp?: { relative: number };+};++export type TranscriptEntry = {+ participant: { name: string };+ words: TranscriptEntryWord[];+};++const isFiniteNumber = (value: number | null | undefined): value is number =>+ typeof value === 'number' && Number.isFinite(value);++// Fireflies only exposes sentence-level timing, so each sentence becomes a single-word entry.+export const mapFirefliesSentencesToTranscriptEntries = (+ sentences: FirefliesTranscriptSentence[] | null | undefined,+): TranscriptEntry[] => {+ if (!Array.isArray(sentences)) {+ return [];+ }++ return sentences.flatMap((sentence) => {+ const text = sentence.text?.trim();++ if (!isNonEmptyString(text)) {+ return [];+ }++ const speakerName = sentence.speaker_name?.trim();+ const startSeconds = sentence.start_time;+ // No end_time → leave end_timestamp unset so players span the entry+ // until the next timestamped sentence instead of a single instant.+ const endSeconds = sentence.end_time;++ return [+ {+ participant: {+ name: isNonEmptyString(speakerName)+ ? speakerName+ : UNKNOWN_SPEAKER_LABEL,+ },+ words: [+ {+ text,+ ...(isFiniteNumber(startSeconds)+ ? { start_timestamp: { relative: startSeconds } }+ : {}),+ ...(isFiniteNumber(endSeconds)+ ? { end_timestamp: { relative: endSeconds } }+ : {}),+ },+ ],+ },+ ];+ });+};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/sync-fireflies-call-to-call-recording.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/sync-fireflies-call-to-call-recording.tsnew file mode 100644index 00000000000..735854cd36a--- /dev/null+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/sync-fireflies-call-to-call-recording.ts@@ -0,0 +1,186 @@+import { isNonEmptyArray, isNonEmptyString } from '@sniptt/guards';+import { type CoreApiClient } from 'twenty-client-sdk/core';+import { isDefined } from 'src/utils/is-defined';++import {+ CALL_RECORDING_REQUEST_STATUS,+ CALL_RECORDING_STATUS,+} from 'src/logic-functions/constants/call-recording-status';+import { type FirefliesTranscript } from 'src/logic-functions/types/fireflies-transcript.type';+import { computeCallRecordingIdForFirefliesMeeting } from 'src/logic-functions/utils/compute-call-recording-id-for-fireflies-meeting';+import { fetchFirefliesSummary } from 'src/logic-functions/utils/fetch-fireflies-summary';+import { fetchFirefliesTranscript } from 'src/logic-functions/utils/fetch-fireflies-transcript';+import { findMatchingCalendarEvent } from 'src/logic-functions/utils/find-matching-calendar-event';+import { formatSummaryAsMarkdown } from 'src/logic-functions/utils/format-summary-as-markdown';+import { mapFirefliesSentencesToTranscriptEntries } from 'src/logic-functions/utils/map-fireflies-sentences-to-transcript-entries';+import {+ type CallRecordingWriteFields,+ upsertCallRecording,+} from 'src/logic-functions/utils/upsert-call-recording';++export type FirefliesSyncableField = 'transcript' | 'summary';++export type SyncFirefliesCallResult =+ | {+ status: 'updated';+ field: FirefliesSyncableField;+ callRecordingId: string;+ calendarEventId?: string;+ created: boolean;+ }+ | { status: 'skipped'; field: FirefliesSyncableField; reason: string }+ | { status: 'error'; field: FirefliesSyncableField; error: string };++const MINUTES_TO_MILLISECONDS = 60_000;++const buildTimestampFields = (+ transcript: FirefliesTranscript,+): Pick<CallRecordingWriteFields, 'startedAt' | 'endedAt'> => {+ const dateMs = transcript.date;++ if (!isDefined(dateMs) || !Number.isFinite(dateMs)) {+ return {};+ }++ const startedAt = new Date(dateMs).toISOString();++ // Fireflies duration is in minutes.+ const durationMinutes = transcript.duration;++ if (!isDefined(durationMinutes) || !Number.isFinite(durationMinutes)) {+ return { startedAt };+ }++ return {+ startedAt,+ endedAt: new Date(+ dateMs + durationMinutes * MINUTES_TO_MILLISECONDS,+ ).toISOString(),+ };+};++export const syncFirefliesCallToCallRecording = async ({+ apiKey,+ client,+ transcriptId,+ field,+}: {+ apiKey: string;+ client: CoreApiClient;+ transcriptId: string;+ field: FirefliesSyncableField;+}): Promise<SyncFirefliesCallResult> => {+ const fetchResult =+ field === 'transcript'+ ? await fetchFirefliesTranscript({ apiKey, transcriptId })+ : await fetchFirefliesSummary({ apiKey, transcriptId });++ if (!fetchResult.ok) {+ return { status: 'error', field, error: fetchResult.errorMessage };+ }++ const firefliesTranscript = fetchResult.data;++ const fieldUpdate = buildFieldUpdate({ field, firefliesTranscript });++ if (fieldUpdate.empty) {+ return { status: 'skipped', field, reason: fieldUpdate.reason };+ }++ const match = await findMatchingCalendarEvent({+ client,+ transcript: firefliesTranscript,+ });+ const calendarEventId = match.matched ? match.calendarEventId : undefined;++ const callRecordingId = computeCallRecordingIdForFirefliesMeeting(+ firefliesTranscript.id,+ );++ const title = firefliesTranscript.title?.trim();+ const sharedFields: CallRecordingWriteFields = {+ ...(isNonEmptyString(title) ? { title } : {}),+ externalRecordingId: firefliesTranscript.id,+ ...buildTimestampFields(firefliesTranscript),+ ...(isDefined(calendarEventId) ? { calendarEventId } : {}),+ ...fieldUpdate.fields,+ };++ try {+ const upsertResult = await upsertCallRecording(client, {+ id: callRecordingId,+ createFields: {+ ...sharedFields,+ recordingRequestStatus: CALL_RECORDING_REQUEST_STATUS.REQUESTED,+ status: sharedFields.status ?? CALL_RECORDING_STATUS.PROCESSING,+ },+ updateFields: sharedFields,+ });++ return {+ status: 'updated',+ field,+ callRecordingId: upsertResult.callRecordingId,+ calendarEventId,+ created: upsertResult.created,+ };+ } catch (error) {+ return {+ status: 'error',+ field,+ error: `Failed to upsert CallRecording ${callRecordingId} for Fireflies transcript ${transcriptId}: ${+ (error as Error).message+ }`,+ };+ }+};++const buildFieldUpdate = ({+ field,+ firefliesTranscript,+}: {+ field: FirefliesSyncableField;+ firefliesTranscript: FirefliesTranscript;+}):+ | { empty: false; fields: CallRecordingWriteFields }+ | { empty: true; reason: string } => {+ if (field === 'transcript') {+ const entries = mapFirefliesSentencesToTranscriptEntries(+ firefliesTranscript.sentences,+ );++ if (!isNonEmptyArray(entries)) {+ return {+ empty: true,+ reason:+ 'Fireflies returned no transcript sentences for this meeting; nothing to sync.',+ };+ }++ return {+ empty: false,+ fields: {+ transcript: entries,+ status: CALL_RECORDING_STATUS.COMPLETED,+ },+ };+ }++ if (!isDefined(firefliesTranscript.summary)) {+ return {+ empty: true,+ reason:+ 'Fireflies returned no summary content for this meeting; nothing to sync.',+ };+ }++ return {+ empty: false,+ fields: {+ summary: {+ markdown: formatSummaryAsMarkdown(firefliesTranscript),+ blocknote: null,+ },+ },+ };+};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/sync-fireflies-field-to-calendar-event.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/sync-fireflies-field-to-calendar-event.tsdeleted file mode 100644index abfd4462a09..00000000000--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/sync-fireflies-field-to-calendar-event.ts+++ /dev/null@@ -1,102 +0,0 @@-import { type CoreApiClient } from 'twenty-client-sdk/core';--import { type FirefliesTranscript } from 'src/logic-functions/types/fireflies-transcript.type';-import { fetchFirefliesSummary } from 'src/logic-functions/utils/fetch-fireflies-summary';-import { fetchFirefliesTranscript } from 'src/logic-functions/utils/fetch-fireflies-transcript';-import { type FirefliesApiResult } from 'src/logic-functions/utils/fireflies-api-request';-import { findMatchingCalendarEvent } from 'src/logic-functions/utils/find-matching-calendar-event';-import { formatSummaryAsMarkdown } from 'src/logic-functions/utils/format-summary-as-markdown';-import { formatTranscriptAsMarkdown } from 'src/logic-functions/utils/format-transcript-as-markdown';-import { updateCalendarEventSummary } from 'src/logic-functions/utils/update-calendar-event-summary';-import { updateCalendarEventTranscript } from 'src/logic-functions/utils/update-calendar-event-transcript';--export type FirefliesSyncableField = 'transcript' | 'summary';--export type SyncFirefliesFieldResult =- | {- status: 'updated';- field: FirefliesSyncableField;- calendarEventId: string;- }- | { status: 'skipped'; field: FirefliesSyncableField; reason: string }- | { status: 'error'; field: FirefliesSyncableField; error: string };--type FieldSyncStrategy = {- fetch: (args: {- apiKey: string;- transcriptId: string;- }) => Promise<FirefliesApiResult<FirefliesTranscript>>;- format: (transcript: FirefliesTranscript) => string;- update: (args: {- client: CoreApiClient;- calendarEventId: string;- markdown: string;- }) => Promise<void>;-};--const FIELD_SYNC_STRATEGIES: Record<FirefliesSyncableField, FieldSyncStrategy> =- {- transcript: {- fetch: fetchFirefliesTranscript,- format: formatTranscriptAsMarkdown,- update: updateCalendarEventTranscript,- },- summary: {- fetch: fetchFirefliesSummary,- format: formatSummaryAsMarkdown,- update: updateCalendarEventSummary,- },- };--export const syncFirefliesFieldToCalendarEvent = async ({- apiKey,- client,- transcriptId,- field,-}: {- apiKey: string;- client: CoreApiClient;- transcriptId: string;- field: FirefliesSyncableField;-}): Promise<SyncFirefliesFieldResult> => {- const strategy = FIELD_SYNC_STRATEGIES[field];-- const fetchResult = await strategy.fetch({ apiKey, transcriptId });-- if (!fetchResult.ok) {- return { status: 'error', field, error: fetchResult.errorMessage };- }-- const match = await findMatchingCalendarEvent({- client,- transcript: fetchResult.data,- });-- if (!match.matched) {- return { status: 'skipped', field, reason: match.reason };- }-- const markdown = strategy.format(fetchResult.data);-- try {- await strategy.update({- client,- calendarEventId: match.calendarEventId,- markdown,- });- } catch (error) {- return {- status: 'error',- field,- error: `Failed to update CalendarEvent ${match.calendarEventId} ${field}: ${- (error as Error).message- }`,- };- }-- return {- status: 'updated',- field,- calendarEventId: match.calendarEventId,- };-};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/update-calendar-event-summary.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/update-calendar-event-summary.tsdeleted file mode 100644index 6d997b812ec..00000000000--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/update-calendar-event-summary.ts+++ /dev/null@@ -1,26 +0,0 @@-import { type CoreApiClient } from 'twenty-client-sdk/core';--export const updateCalendarEventSummary = async ({- client,- calendarEventId,- markdown,-}: {- client: CoreApiClient;- calendarEventId: string;- markdown: string;-}): Promise<void> => {- await client.mutation({- updateCalendarEvent: {- __args: {- id: calendarEventId,- data: {- summary: {- markdown,- blocknote: null,- },- },- },- id: true,- },- });-};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/update-calendar-event-transcript.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/update-calendar-event-transcript.tsdeleted file mode 100644index 117737c07dc..00000000000--- a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/update-calendar-event-transcript.ts+++ /dev/null@@ -1,26 +0,0 @@-import { type CoreApiClient } from 'twenty-client-sdk/core';--export const updateCalendarEventTranscript = async ({- client,- calendarEventId,- markdown,-}: {- client: CoreApiClient;- calendarEventId: string;- markdown: string;-}): Promise<void> => {- await client.mutation({- updateCalendarEvent: {- __args: {- id: calendarEventId,- data: {- transcript: {- markdown,- blocknote: null,- },- },- },- id: true,- },- });-};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/upsert-call-recording.ts b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/upsert-call-recording.tsnew file mode 100644index 00000000000..5d5c9d51fee--- /dev/null+++ b/packages/twenty-apps/public/twenty-fireflies/src/logic-functions/utils/upsert-call-recording.ts@@ -0,0 +1,96 @@+import { type CoreApiClient } from 'twenty-client-sdk/core';+import { isDefined } from 'src/utils/is-defined';++export type CallRecordingWriteFields = {+ title?: string;+ status?: string;+ recordingRequestStatus?: string;+ externalRecordingId?: string;+ startedAt?: string;+ endedAt?: string;+ transcript?: unknown;+ summary?: { markdown: string; blocknote: null };+ calendarEventId?: string;+};++type UpsertCallRecordingResult = {+ callRecordingId: string;+ created: boolean;+};++const findCallRecordingId = async (+ client: CoreApiClient,+ id: string,+): Promise<string | undefined> => {+ const queryResult = await client.query({+ callRecordings: {+ __args: {+ filter: { id: { eq: id } },+ first: 1,+ },+ edges: {+ node: {+ id: true,+ },+ },+ },+ });++ return queryResult.callRecordings?.edges?.[0]?.node?.id ?? undefined;+};++const updateCallRecording = async (+ client: CoreApiClient,+ id: string,+ data: CallRecordingWriteFields,+): Promise<void> => {+ await client.mutation({+ updateCallRecording: {+ __args: { id, data },+ id: true,+ },+ });+};++export const upsertCallRecording = async (+ client: CoreApiClient,+ {+ id,+ createFields,+ updateFields,+ }: {+ id: string;+ createFields: CallRecordingWriteFields;+ updateFields: CallRecordingWriteFields;+ },+): Promise<UpsertCallRecordingResult> => {+ const existingId = await findCallRecordingId(client, id);++ if (isDefined(existingId)) {+ await updateCallRecording(client, id, updateFields);++ return { callRecordingId: id, created: false };+ }++ try {+ await client.mutation({+ createCallRecording: {+ __args: { data: { id, ...createFields } },+ id: true,+ },+ });++ return { callRecordingId: id, created: true };+ } catch (error) {+ // A concurrent create on the same deterministic id may have won the race.+ const raceWinnerId = await findCallRecordingId(client, id);++ if (!isDefined(raceWinnerId)) {+ throw error;+ }++ await updateCallRecording(client, id, updateFields);++ return { callRecordingId: id, created: false };+ }+};diff --git a/packages/twenty-apps/public/twenty-fireflies/src/roles/default-function.role.ts b/packages/twenty-apps/public/twenty-fireflies/src/roles/default-function.role.tsindex 07caa9ab20d..f8d07c136aa 100644--- a/packages/twenty-apps/public/twenty-fireflies/src/roles/default-function.role.ts+++ b/packages/twenty-apps/public/twenty-fireflies/src/roles/default-function.role.ts@@ -9,7 +9,7 @@ export default defineApplicationRole({universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,label: 'Twenty Fireflies sync role',description:- 'Reads CalendarEvent and CalendarChannelEventAssociation to locate the meeting matching a Fireflies call (from an incoming webhook or from the on-demand Sync Fireflies Call workflow tool), and updates that CalendarEvent to write the synced transcript and summary fields. The list / search workflow tools only call the Fireflies API and do not require any Twenty object permissions.',+ 'Reads CalendarEvent and CalendarChannelEventAssociation to locate the meeting matching a Fireflies call (from an incoming webhook or from the on-demand Sync Fireflies Call workflow tool), and writes the synced transcript and summary into a CallRecording record linked to that meeting. The list / search workflow tools only call the Fireflies API and do not require any Twenty object permissions.',canReadAllObjectRecords: false,canUpdateAllObjectRecords: false,canSoftDeleteAllObjectRecords: false,@@ -23,7 +23,7 @@ export default defineApplicationRole({objectUniversalIdentifier:STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.calendarEvent.universalIdentifier,canReadObjectRecords: true,- canUpdateObjectRecords: true,+ canUpdateObjectRecords: false,canSoftDeleteObjectRecords: false,canDestroyObjectRecords: false,},@@ -36,6 +36,14 @@ export default defineApplicationRole({canSoftDeleteObjectRecords: false,canDestroyObjectRecords: false,},+ {+ objectUniversalIdentifier:+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.callRecording.universalIdentifier,+ canReadObjectRecords: true,+ canUpdateObjectRecords: true,+ canSoftDeleteObjectRecords: false,+ canDestroyObjectRecords: false,+ },],fieldPermissions: [],permissionFlagUniversalIdentifiers: [],diff --git a/packages/twenty-apps/public/twenty-fireflies/src/schema/fields/summary-on-calendar-event.field.ts b/packages/twenty-apps/public/twenty-fireflies/src/schema/fields/summary-on-calendar-event.field.tsdeleted file mode 100644index 8fc80657506..00000000000--- a/packages/twenty-apps/public/twenty-fireflies/src/schema/fields/summary-on-calendar-event.field.ts+++ /dev/null@@ -1,20 +0,0 @@-import {- defineField,- FieldType,- STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,-} from 'twenty-sdk/define';--import { SUMMARY_ON_CALENDAR_EVENT_FIELD_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';--export default defineField({- universalIdentifier: SUMMARY_ON_CALENDAR_EVENT_FIELD_UNIVERSAL_IDENTIFIER,- objectUniversalIdentifier:- STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.calendarEvent.universalIdentifier,- type: FieldType.RICH_TEXT,- name: 'summary',- label: 'Summary',- description:- 'AI-generated meeting summary synced from Fireflies. Includes overview, action items, and keywords. Populated automatically when Fireflies finishes summarizing a recording that matches this calendar event.',- icon: 'IconNotes',- isNullable: true,-});diff --git a/packages/twenty-apps/public/twenty-fireflies/src/schema/fields/transcript-on-calendar-event.field.ts b/packages/twenty-apps/public/twenty-fireflies/src/schema/fields/transcript-on-calendar-event.field.tsdeleted file mode 100644index 7c09d0bf422..00000000000--- a/packages/twenty-apps/public/twenty-fireflies/src/schema/fields/transcript-on-calendar-event.field.ts+++ /dev/null@@ -1,20 +0,0 @@-import {- defineField,- FieldType,- STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,-} from 'twenty-sdk/define';--import { TRANSCRIPT_ON_CALENDAR_EVENT_FIELD_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';--export default defineField({- universalIdentifier: TRANSCRIPT_ON_CALENDAR_EVENT_FIELD_UNIVERSAL_IDENTIFIER,- objectUniversalIdentifier:- STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.calendarEvent.universalIdentifier,- type: FieldType.RICH_TEXT,- name: 'transcript',- label: 'Transcript',- description:- 'Call transcript synced from Fireflies. Populated automatically when a Fireflies recording finishes processing and matches this calendar event.',- icon: 'IconMicrophone',- isNullable: true,-});diff --git a/packages/twenty-apps/public/twenty-fireflies/yarn.lock b/packages/twenty-apps/public/twenty-fireflies/yarn.lockindex 1389bfca725..379ce447ee6 100644--- a/packages/twenty-apps/public/twenty-fireflies/yarn.lock+++ b/packages/twenty-apps/public/twenty-fireflies/yarn.lock@@ -953,8 +953,8 @@ __metadata:oxlint: "npm:^0.16.0"react: "npm:^18.2.0"react-dom: "npm:^18.2.0"- twenty-client-sdk: "npm:^2.16.0"- twenty-sdk: "npm:^2.16.0"+ twenty-client-sdk: "npm:^2.18.0"+ twenty-sdk: "npm:^2.18.0"typescript: "npm:^5.9.3"vite-tsconfig-paths: "npm:^4.2.1"vitest: "npm:^4.0.0"@@ -2888,22 +2888,22 @@ __metadata:languageName: nodelinkType: hard-"twenty-client-sdk@npm:2.16.0, twenty-client-sdk@npm:^2.16.0":- version: 2.16.0- resolution: "twenty-client-sdk@npm:2.16.0"+"twenty-client-sdk@npm:2.18.0, twenty-client-sdk@npm:^2.18.0":+ version: 2.18.0+ resolution: "twenty-client-sdk@npm:2.18.0"dependencies:"@genql/runtime": "npm:^2.10.0"esbuild: "npm:^0.28.1"graphql: "npm:^16.8.1"lodash: "npm:^4.17.21"prettier: "npm:^3.8.3"- checksum: 10c0/f990220bec103a04ca50dc8bb38c295e94a4e51b27a3188f4a0ae515c204b76bf87f5591739eb705b97e7aa5a9aa6a215d0d4da05297e50a0392801ea64a2234+ checksum: 10c0/3b7d6ca4e7b59c04cd2348af0f2ba8de153e70d565b4a38c2744b44998dfcc6c2bdb84ba6315cec208953d8c6fa7573ab33c17355f971f279299d470c57be06elanguageName: nodelinkType: hard-"twenty-sdk@npm:^2.16.0":- version: 2.16.0- resolution: "twenty-sdk@npm:2.16.0"+"twenty-sdk@npm:^2.18.0":+ version: 2.18.0+ resolution: "twenty-sdk@npm:2.18.0"dependencies:"@sniptt/guards": "npm:^0.2.0"axios: "npm:^1.16.0"@@ -2922,12 +2922,12 @@ __metadata:semver: "npm:7.6.3"sharp: "npm:^0.34.5"tinyglobby: "npm:^0.2.15"- twenty-client-sdk: "npm:2.16.0"+ twenty-client-sdk: "npm:2.18.0"typescript: "npm:^5.9.3"uuid: "npm:^13.0.2"bin:twenty: dist/cli.cjs- checksum: 10c0/528f275f8bda022061a52c3563af514d2257f291fc5a232be90ca6011c50ff18a250984b6c68fc8e4c690644c92e1ccb0b89c511b8a19d832455c8860f2751a8+ checksum: 10c0/7e6d300894c427029e4124047614b55988671c914332613acb38f830cee11ecc480ff2a586b6153756aab1b7fa7f4520cf072c9db1428cd9ce9b9f7a62dfcd64languageName: nodelinkType: hard