import {
createAiActionTool,
CreateAiActionToolParams,
} from './createAiAction.js';
import {
invokeAiActionTool,
InvokeAiActionToolParams,
} from './invokeAiAction.js';
import {
getAiActionInvocationTool,
GetAiActionInvocationToolParams,
} from './getAiActionInvocation.js';
import {
deleteAiActionTool,
DeleteAiActionToolParams,
} from './deleteAiAction.js';
import { getAiActionTool, GetAiActionToolParams } from './getAiAction.js';
import { listAiActionTool, ListAiActionToolParams } from './listAiActions.js';
import {
publishAiActionTool,
PublishAiActionToolParams,
} from './publishAiAction.js';
import {
unpublishAiActionTool,
UnpublishAiActionToolParams,
} from './unpublishAiAction.js';
import {
updateAiActionTool,
UpdateAiActionToolParams,
} from './updateAiAction.js';
import type { ContentfulConfig } from '../../config/types.js';
export function createAiActionTools(config: ContentfulConfig) {
const createAiAction = createAiActionTool(config);
const invokeAiAction = invokeAiActionTool(config);
const getAiActionInvocation = getAiActionInvocationTool(config);
const deleteAiAction = deleteAiActionTool(config);
const getAiAction = getAiActionTool(config);
const listAiAction = listAiActionTool(config);
const publishAiAction = publishAiActionTool(config);
const unpublishAiAction = unpublishAiActionTool(config);
const updateAiAction = updateAiActionTool(config);
return {
createAiAction: {
title: 'create_ai_action',
description:
'Create a new AI action with clear instructions and well-defined variables. Best practices: (1) Use descriptive names that indicate the action\'s purpose, (2) Write specific, actionable instructions in the template, (3) Define meaningful variables with clear names like "sourceContent", "targetLocale", "entryId", or "contentType", (4) Embed variables into the template using the format {{var.{variableId}}}, (5) Consider the content editor\'s workflow and make the action intuitive to use. Example variables: content fields to process, locales for translation, reference entries, formatting preferences, or validation rules.',
inputParams: CreateAiActionToolParams.shape,
annotations: {
readOnlyHint: false,
destructiveHint: false,
idempotentHint: false,
openWorldHint: false,
},
tool: createAiAction,
},
invokeAiAction: {
title: 'invoke_ai_action',
description:
'Invoke an AI action with variables. MANDATORY BULK OPERATIONS: You MUST ALWAYS use bulk operations when processing multiple content pieces by adding multiple items to the fields array - never make separate calls. VARIABLES: Can be (1) String values for simple text input, or (2) Entity references to read from specific entry fields using {"entityId": "entryId", "entityPath": "fields.fieldName.locale", "entityType": "Entry"}. POLLING: Automatically polls every 3 seconds for up to 60 seconds. CRITICAL FOLLOW-UP: After invoking AI actions, you MUST immediately take the next step to complete the workflow. The tool response will provide specific guidance on required next steps - you must follow this guidance.',
inputParams: InvokeAiActionToolParams.shape,
annotations: {
readOnlyHint: false,
destructiveHint: false,
idempotentHint: false,
openWorldHint: true, // Interacts with external AI services
},
tool: invokeAiAction,
},
getAiActionInvocation: {
title: 'get_ai_action_invocation',
description:
'Retrieve information about a specific AI action invocation by its ID.',
inputParams: GetAiActionInvocationToolParams.shape,
annotations: {
readOnlyHint: true,
openWorldHint: false,
},
tool: getAiActionInvocation,
},
deleteAiAction: {
title: 'delete_ai_action',
description: 'Delete a specific AI action from your Contentful space',
inputParams: DeleteAiActionToolParams.shape,
annotations: {
readOnlyHint: false,
destructiveHint: true,
idempotentHint: true, // Deleting same item multiple times has same effect
openWorldHint: false,
},
tool: deleteAiAction,
},
getAiAction: {
title: 'get_ai_action',
description:
'Retrieve details about a specific AI action including its configuration, instructions, and defined variables',
inputParams: GetAiActionToolParams.shape,
annotations: {
readOnlyHint: true,
openWorldHint: false,
},
tool: getAiAction,
},
listAiActions: {
title: 'list_ai_actions',
description:
'List AI actions in a space. Returns a maximum of 3 items per request. Use skip parameter to paginate through results.',
inputParams: ListAiActionToolParams.shape,
annotations: {
readOnlyHint: true,
openWorldHint: false,
},
tool: listAiAction,
},
publishAiAction: {
title: 'publish_ai_action',
description:
'Publish an AI action to make it available for use in the Contentful web app',
inputParams: PublishAiActionToolParams.shape,
annotations: {
readOnlyHint: false,
destructiveHint: false,
idempotentHint: true, // Publishing same item multiple times has same effect
openWorldHint: false,
},
tool: publishAiAction,
},
unpublishAiAction: {
title: 'unpublish_ai_action',
description:
'Unpublish an AI action to remove it from use in the Contentful web app',
inputParams: UnpublishAiActionToolParams.shape,
annotations: {
readOnlyHint: false,
destructiveHint: false,
idempotentHint: true, // Unpublishing same item multiple times has same effect
openWorldHint: false,
},
tool: unpublishAiAction,
},
updateAiAction: {
title: 'update_ai_action',
description:
'Update an existing AI action. Your updates will be merged with the existing AI action data, so you only need to provide the fields you want to change.',
inputParams: UpdateAiActionToolParams.shape,
annotations: {
readOnlyHint: false,
destructiveHint: false,
idempotentHint: false,
openWorldHint: false,
},
tool: updateAiAction,
},
};
}
