Twenty Files

Two breaking changes ship in this release. Install job inputs no longer carry a version field; remove it from any call sites. AI model configuration moves from name-based pickers to a five-tier system; update any code that references specific model identifiers.

yarn twenty pull now writes views, page layouts, navigation menu items, and translations as typed define* files. yarn twenty apply no longer prunes translations when your project has no locales/ folder, and empty built files no longer abort the upload batch.

Two new FieldMetadata flags ship: isSearchable controls which fields feed the search vector, and isAuditLogged keeps scheduled writes off the record timeline. definePageLayoutWidget lets an app place a widget on a tab it does not own.

⚠️ Breaking changes

• TriggerInstallApplicationJobInput no longer carries a version field; the installer resolves version from the app registration. Remove version from any call sites. (#25502) by @martmull
• AI model configuration now uses five named tiers (EXTRA_FAST, FAST, BALANCED, SMART, EXTRA_SMART) instead of model names; update any code that references specific AI model identifiers. (#25721) by @FelixMalfait

🌟 Highlights

• Breaking: TriggerInstallApplicationJobInput no longer carries a version field; the installer resolves version from the app registration. Remove version from any call sites. (#25502)
• Breaking: AI model selection now uses five named tiers instead of model names; update any code that referenced specific AI model identifiers. (#25721)
• yarn twenty pull now writes views, page layouts, navigation menu items, and published translations as typed define* files, completing round-trip sync of the app manifest. (#25606)
• create-twenty-app scaffolds locales/en.json with an empty catalog so new projects declare their translation set from the first sync. (#25539)
• definePageLayoutWidget lets an app place a widget on a tab it does not own; declare it in manifest.pageLayoutWidgets. (#25651)
• yarn twenty apply no longer wipes published translations when there is no locales/ folder, and empty built files no longer abort the upload batch. (#25535)

✨ New features

• isSearchable is now available on FieldMetadata; use it to identify which fields contribute to an object's search vector. (#25166) by @prastoin
• Apps can call reportAppConnectionAuthFailure to mark a connection credential as broken when it fails at call time, triggering the reconnect UI in settings. (#25297) by @abdulrahmancodes
• messageCampaign.scheduledAt is now available; set it to queue a campaign for later delivery instead of sending immediately. (#25563) by @neo773
• isAuditLogged is now available on FieldMetadata; fields with it set to false are excluded from the record timeline. (#25641) by @FelixMalfait
• definePageLayoutWidget lets an app place a single widget on a tab it does not own; declare it in manifest.pageLayoutWidgets. (#25651) by @Weiko
• Logic functions can now receive batched database events by setting batchSize on databaseEventTriggerSettings, instead of one job per event. (#25726) by @martmull

💅 Improvements & UX

• exportApplication now fills manifest.translations with compiled catalogs so a raw export carries translation data. (#25566) by @Weiko
• yarn twenty pull now writes an app's published translations back into locales/ files. (#25567) by @Weiko
• yarn twenty pull now writes views as .view.ts files using defineView and standalone view fields as .view-field.ts files using defineViewField. (#25606) by @Weiko
• yarn twenty pull now writes page layouts as definePageLayout() files and standalone tabs as definePageLayoutTab() files. (#25655) by @Weiko
• yarn twenty pull now writes navigation menu items as defineNavigationMenuItem() files, including items from the Custom app. (#25705) by @Weiko
• applicationConnectedAccounts(applicationId) is a new query that returns all non-archived app connections the caller can use, including workspace-shared connections. (#25708) by @abdulrahmancodes

🐛 Bug fixes

• yarn twenty apply no longer wipes published translations when your project has no locales/ folder. (#25535) by @Weiko
• yarn twenty apply and yarn twenty dev now skip empty built files on upload and report a rejected batch once rather than once per file. (#25568) by @Weiko
• twenty-ui is republished as 1.0.0-alpha.2 under MIT; update your dependency if you pulled an earlier alpha that carried the old AGPL license. (#25738) by @MauryaQbit

🔧 Developer & API

• create-twenty-app now scaffolds locales/en.json with an empty catalog so new projects declare their translation set from the first sync. (#25539) by @Weiko

🎉 New contributors

• @grootbro made their first contribution in https://github.com/twentyhq/twenty/pull/25537
• @claxman made their first contribution in https://github.com/twentyhq/twenty/pull/25555
• @Hermi941 made their first contribution in https://github.com/twentyhq/twenty/pull/25658
• @addyCooks made their first contribution in https://github.com/twentyhq/twenty/pull/25671
• @twenty-pr-author[bot] made their first contribution in https://github.com/twentyhq/twenty/pull/25713
• @NiklasDah made their first contribution in https://github.com/twentyhq/twenty/pull/25720
• @breken-ai made their first contribution in https://github.com/twentyhq/twenty/pull/25751
• @MauryaQbit made their first contribution in https://github.com/twentyhq/twenty/pull/25738

Full Changelog: https://github.com/twentyhq/twenty/compare/sdk/v2.39.0...sdk/v2.40.0