14 Commits

Author	SHA1	Message	Date
martmull	a68e05682b	Serverless built updates (#17351) ... follow up of https://github.com/twentyhq/twenty/pull/17317	2026-01-22 15:04:29 +00:00
martmull	1917c1c9b9	Add forwardedRequestHeaders in routeTriggers (#17151) ... - add `forwardedRequestHeaders` `string[]` column in `core.routeTrigger` - filter request headers and forward filtered headers to function payload (avoid spreading unexpectedly token or cookie) - add `forwardedRequestHeaders` option in twenty-sdk `defineFunction` util BREAKING for actual routeTrigger payload but only 16 to migrate in production	2026-01-16 09:19:28 +00:00
Félix Malfait	0173e40a20	feat: Serverless Functions as AI Tools (#16919) ... ## Summary This PR enables serverless functions to be exposed as AI tools, allowing them to be used by AI agents. ### Changes - Added new `SERVERLESS_FUNCTION` tool category - Added `toolDescription`, `toolInputSchema`, and `toolOutputSchema` fields to serverless functions - Created database migration for the new schema columns - Added tool index query and resolver for fetching available tools - Added Settings AI page tabs (Skills, Tools, Settings) with new tools table - Added utility to convert tool schema to JSON schema format - Updated frontend to display tools in the settings page ### Implementation Details - Serverless functions can now define tool metadata (description, input/output schemas) - These functions are automatically registered in the tool registry - The tool index endpoint allows querying available tools with their schemas - Settings page now has a dedicated Tools tab showing all available tools	2026-01-05 11:13:06 +01:00
martmull	a6cc80eedd	1751 extensibility twenty sdk v2 use twenty sdk to define a serverless function trigger (#15347) ... This PR adds 2 columns handlerPath and handlerName in serverlessFunction to locate the entrypoint of a serverless in a codebase It adds the following decorators in twenty-sdk: - ServerlessFunction - DatabaseEventTrigger - RouteTrigger - CronTrigger - ApplicationVariable It still supports deprecated entity.manifest.jsonc Overall code needs to be cleaned a little bit, but it should work properly so you can try to test if the DEVX fits your needs See updates in hello-world application ```typescript import axios from 'axios'; import { DatabaseEventTrigger, ServerlessFunction, RouteTrigger, CronTrigger, ApplicationVariable, } from 'twenty-sdk'; @ApplicationVariable({ universalIdentifier: 'dedc53eb-9c12-4fe2-ba86-4a2add19d305', key: 'TWENTY_API_KEY', description: 'Twenty API Key', isSecret: true, }) @DatabaseEventTrigger({ universalIdentifier: '203f1df3-4a82-4d06-a001-b8cf22a31156', eventName: 'person.created', }) @RouteTrigger({ universalIdentifier: 'c9f84c8d-b26d-40d1-95dd-4f834ae5a2c6', path: '/post-card/create', httpMethod: 'GET', isAuthRequired: false, }) @CronTrigger({ universalIdentifier: 'dd802808-0695-49e1-98c9-d5c9e2704ce2', pattern: '0 0 1 1 *', // Every year 1st of January }) @ServerlessFunction({ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf', }) class CreateNewPostCard { main = async (params: { recipient: string }): Promise<string> => { const { recipient } = params; const options = { method: 'POST', url: 'http://localhost:3000/rest/postCards', headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${process.env.TWENTY_API_KEY}`, }, data: { name: recipient ?? 'Unknown' }, }; try { const { data } = await axios.request(options); console.log(`New post card to "${recipient}" created`); return data; } catch (error) { console.error(error); throw error; } }; } export const createNewPostCardHandler = new CreateNewPostCard().main; ``` ### [edit] V2 After the v1 proposal, I see that using a class method to define the serverless function handler is pretty confusing. Lets leave serverlessFunction configuration decorators on the class, but move the handler like before. Here is the v2 hello-world serverless function: ```typescript import axios from 'axios'; import { DatabaseEventTrigger, ServerlessFunction, RouteTrigger, CronTrigger, ApplicationVariable, } from 'twenty-sdk'; @ApplicationVariable({ universalIdentifier: 'dedc53eb-9c12-4fe2-ba86-4a2add19d305', key: 'TWENTY_API_KEY', description: 'Twenty API Key', isSecret: true, }) @DatabaseEventTrigger({ universalIdentifier: '203f1df3-4a82-4d06-a001-b8cf22a31156', eventName: 'person.created', }) @RouteTrigger({ universalIdentifier: 'c9f84c8d-b26d-40d1-95dd-4f834ae5a2c6', path: '/post-card/create', httpMethod: 'GET', isAuthRequired: false, }) @CronTrigger({ universalIdentifier: 'dd802808-0695-49e1-98c9-d5c9e2704ce2', pattern: '0 0 1 1 *', // Every year 1st of January }) @ServerlessFunction({ universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf', }) export class ServerlessFunctionDefinition {} export const main = async (params: { recipient: string }): Promise<string> => { const { recipient } = params; const options = { method: 'POST', url: 'http://localhost:3000/rest/postCards', headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${process.env.TWENTY_API_KEY}`, }, data: { name: recipient ?? 'Unknown' }, }; try { const { data } = await axios.request(options); console.log(`New post card to "${recipient}" created`); return data; } catch (error) { console.error(error); throw error; } }; ``` ### [edit] V3 After the v2 proposal, we don't really like decorators on empty classes. We decided to go with a Vercel approach with a config constant ```typescript import axios from 'axios'; import { ServerlessFunctionConfig } from 'twenty-sdk'; export const main = async (params: { recipient: string }): Promise<string> => { const { recipient } = params; const options = { method: 'POST', url: 'http://localhost:3000/rest/postCards', headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${process.env.TWENTY_API_KEY}`, }, data: { name: recipient ?? 'Unknown' }, }; try { const { data } = await axios.request(options); console.log(`New post card to "${recipient}" created`); return data; } catch (error) { console.error(error); throw error; } }; export const config: ServerlessFunctionConfig = { universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf', routeTriggers: [ { universalIdentifier: 'c9f84c8d-b26d-40d1-95dd-4f834ae5a2c6', path: '/post-card/create', httpMethod: 'GET', isAuthRequired: false, } ], cronTriggers: [ { universalIdentifier: 'dd802808-0695-49e1-98c9-d5c9e2704ce2', pattern: '0 0 1 1 *', // Every year 1st of January } ], databaseEventTriggers: [ { universalIdentifier: '203f1df3-4a82-4d06-a001-b8cf22a31156', eventName: 'person.created', } ] } ```	2025-10-29 16:51:43 +00:00
martmull	b16ab1b7c9	1518 extensibility front add an application section in settings (#15056) ... Protected by IS_APPLICATION_ENABLED featureFlag Add `Application` section in settings <img width="301" height="137" alt="image" src="https://github.com/user-attachments/assets/ee53bdd2-36f6-45c6-8646-17b1e08abf00" /> A `settings/applications` route listing all installed applications <img width="661" height="428" alt="image" src="https://github.com/user-attachments/assets/69d534c4-4e9e-452a-a3d9-ded0223bb457" /> Introduce a new Tag for application managed items <img width="885" height="759" alt="image" src="https://github.com/user-attachments/assets/19767be5-61e5-4bd2-a51d-54ed9bfb1923" /> A `settings/applications/<application_id>` details setting page listing all objects, serverlessFunctions and agents created by the application: <img width="917" height="778" alt="image" src="https://github.com/user-attachments/assets/7fc056a6-1d73-4242-b2eb-6f8955d8597d" /> A `settings/applications/<application_id>/<serverless_function_id>` <img width="905" height="652" alt="image" src="https://github.com/user-attachments/assets/56ca0021-26bf-42cb-9abf-34879f16050a" /> Add trigger tab in serverless function details (readonly for now) <img width="899" height="724" alt="image" src="https://github.com/user-attachments/assets/5eeefa35-f2a4-4fd8-a640-7b5c5891f226" /> Set object, serverless and agent setting detail pages readonly for managed items <img width="1075" height="859" alt="image" src="https://github.com/user-attachments/assets/57c73d69-4980-47a2-b752-8dc5ab494530" /> <img width="648" height="582" alt="image" src="https://github.com/user-attachments/assets/5ad5f3f7-3bc3-4e40-870a-4981c6492524" /> <img width="982" height="692" alt="image" src="https://github.com/user-attachments/assets/7ad756c4-5d33-4a0a-9eb8-416c040362b9" /> <img width="1077" height="647" alt="image" src="https://github.com/user-attachments/assets/e086b9f5-4062-4d10-82a9-4023de3cad3f" />	2025-10-15 17:13:29 +02:00
martmull	5252384f14	1588 serverless follow ups 2 (#14998)	2025-10-09 12:56:59 +02:00
martmull	cb010d90fe	998 workflow restore (#12417) ... Add a post hook to restore workflow sub-entities	2025-06-03 15:28:43 +02:00
martmull	f8f9bb2b78	Serverless function timeout concerns (#9689) ... closes https://github.com/twentyhq/core-team-issues/issues/242 - unify timeout behavior between local and lambda - add timeout in serverless entity - set timeout default to 300s (5min)	2025-01-17 13:49:02 +00:00
martmull	354ee86cb9	8311 serverless function functions can be executed with any input (#8380) ... - remove ts-morph - update inputSchema shape  https://github.com/user-attachments/assets/913cd305-9e7c-48da-b20f-c974a8ac7cea ## TODO - have inputTypes to match the inputSchema type (string, number, boolean, etc...), only string for now - handle required/optional inputs - handle case when inputSchema changes, fix data reset when switching function	2024-11-08 16:15:27 +00:00
Thomas Trompette	be8141ce5e	Infer function input in workflow step (#8308) ... - add `inputSchema` column in serverless function. This is an array of parameters, with their name and type - on serverless function id update, get the `inputSchema` + store empty settings in step - from step settings, build the form TODO in next PR: - use field type to decide what kind of form should be printed - have a strategy to handle object as input https://github.com/user-attachments/assets/ed96f919-24b5-4baf-a051-31f76f45e575	2024-11-05 14:57:06 +01:00
martmull	e767f16dbe	7415 serverless functions update environment variables in a dedicated tab in settings functions not a env file (#7939) ...    	2024-10-22 14:51:03 +02:00
martmull	62fe1d0e88	6653 serverless functions store and use environment variables in serverless function scripts (#7390) ...  	2024-10-03 13:56:17 +02:00
martmull	6f9aa1e870	6654 serverless functions add a deploy button disable deploy when autosave (#6715) ... - improvements on serverless function behavior (autosave performances, deploy on execution only) - add versioning to serverless functions - add a publish endpoint to create a new version of a serverless function - add deploy and reset to lastVersion button in the settings section: <img width="736" alt="image" src="https://github.com/user-attachments/assets/2001f8d2-07a4-4f79-84dd-ec74b6f301d3">	2024-08-23 12:06:03 +02:00
martmull	00fea17920	Serverless function UI (#6388) ... https://www.figma.com/design/xt8O9mFeLl46C5InWwoMrN/Twenty?node-id=36235-120877 Did not do the file manager part. A Function is defined using one unique file at the moment Feature protected by featureFlag `IS_FUNCTION_SETTINGS_ENABLED` ## Demo https://github.com/user-attachments/assets/0acb8291-47b4-4521-a6fa-a88b9198609b	2024-07-29 13:03:09 +02:00