feat(codecompanion-workspace.json): update workspace configuration with new paths and more detailed system prompts

chore(server.ts): improve port configuration and environment variable support

Author: ivo-toby

AI-ACTIONS-PLAN.md

@@ -1,16 +1,22 @@
 {
   "name": "Contentful MCP",
   "version": "1.0.0",
-  "system_prompt": "Contentful MCP is a tool for interacting with the Contentful API, providing functionality for working with entries, assets, content types, and AI Actions within the Contentful headless CMS platform. This project is organized into handlers for different entity types, with support for standard CRUD operations as well as specialized bulk actions.",
+  "system_prompt": "Contentful MCP is a TypeScript-based Model Context Protocol (MCP) implementation for interacting with Contentful's Content Management API, particularly focusing on AI Actions integration. The project follows a modular architecture with handlers for different entity types (entries, assets, content types, AI actions), and includes utility functions for generating schemas and validating inputs.",
+  "vars": {
+    "typescript_path": "src/types",
+    "handlers_path": "src/handlers",
+    "utils_path": "src/utils",
+    "config_path": "src/config"
+  },
   "groups": [
     {
       "name": "Core",
-      "system_prompt": "I've grouped core files together into a group called \"${group_name}\". These files represent the main entry points and configuration for the Contentful MCP project.\n\nBelow are the relevant files which we will be discussing:\n\n${group_files}",
+      "system_prompt": "I've grouped core files together into a group called \"${group_name}\". These files represent the main entry points and configuration for the Contentful MCP project. They handle client setup, API connectivity, and server initialization.\n\nBelow are the relevant files which we will be discussing:\n\n${group_files}",
       "data": ["index", "ai-actions-client", "client"]
     },
     {
       "name": "Handlers",
-      "system_prompt": "I've grouped handler files together into a group called \"${group_name}\". These files contain the implementation of various API handlers for different entity types in Contentful.\n\nBelow are the relevant files which we will be discussing:\n\n${group_files}",
+      "system_prompt": "I've grouped handler files together into a group called \"${group_name}\". These files contain the implementation of various API handlers for different entity types in Contentful, providing CRUD operations and specialized functions.\n\nBelow are the relevant files which we will be discussing:\n\n${group_files}",
       "data": [
         "entry-handlers",
         "asset-handlers",
@@ -22,86 +28,85 @@
     },
     {
       "name": "Types",
-      "system_prompt": "I've grouped type definition files together into a group called \"${group_name}\". These files define the TypeScript interfaces and types used throughout the project.\n\nBelow are the relevant files which we will be discussing:\n\n${group_files}",
+      "system_prompt": "I've grouped type definition files together into a group called \"${group_name}\". These files define the TypeScript interfaces and types used throughout the project, providing type safety and documentation.\n\nBelow are the relevant files which we will be discussing:\n\n${group_files}",
       "data": ["ai-actions-types", "tools-types"]
     },
     {
       "name": "Utils",
-      "system_prompt": "I've grouped utility files together into a group called \"${group_name}\". These files provide helper functions and utilities used across the project.\n\nBelow are the relevant files which we will be discussing:\n\n${group_files}",
+      "system_prompt": "I've grouped utility files together into a group called \"${group_name}\". These files provide helper functions and utilities used across the project for common operations and data transformations.\n\nBelow are the relevant files which we will be discussing:\n\n${group_files}",
       "data": ["ai-action-tool-generator", "summarizer", "validation"]
     }
   ],
   "data": {
     "index": {
       "type": "file",
       "path": "src/index.ts",
-      "description": "The main entry point for the Contentful MCP project."
+      "description": "The main entry point for the Contentful MCP project where handlers are registered and the server is initialized."
     },
     "ai-actions-client": {
       "type": "file",
-      "path": "src/config/ai-actions-client.ts",
-      "description": "Configuration for the AI Actions client used to interact with Contentful's AI Actions API."
+      "path": "${config_path}/ai-actions-client.ts",
+      "description": "Configuration for the AI Actions client used to interact with Contentful's AI Actions API, with specialized authentication and endpoint handling."
     },
     "client": {
       "type": "file",
-      "path": "src/config/client.ts",
-      "description": "Configuration for the main Contentful client used to interact with the Contentful API."
+      "path": "${config_path}/client.ts",
+      "description": "Configuration for the main Contentful client used to interact with the Contentful API, handling authentication and base configuration."
     },
     "entry-handlers": {
       "type": "file",
-      "path": "src/handlers/entry-handlers.ts",
-      "description": "Handlers for CRUD operations and other actions on Contentful entries."
+      "path": "${handlers_path}/entry-handlers.ts",
+      "description": "Handlers for CRUD operations and other actions on Contentful entries, including bulk publishing and unpublishing functionality."
     },
     "asset-handlers": {
       "type": "file",
-      "path": "src/handlers/asset-handlers.ts",
-      "description": "Handlers for CRUD operations and other actions on Contentful assets."
+      "path": "${handlers_path}/asset-handlers.ts",
+      "description": "Handlers for CRUD operations and other actions on Contentful assets, including upload, update and publishing."
     },
     "content-type-handlers": {
       "type": "file",
-      "path": "src/handlers/content-type-handlers.ts",
-      "description": "Handlers for CRUD operations and other actions on Contentful content types."
+      "path": "${handlers_path}/content-type-handlers.ts",
+      "description": "Handlers for CRUD operations and other actions on Contentful content types, defining the structure of entries."
     },
     "ai-action-handlers": {
       "type": "file",
-      "path": "src/handlers/ai-action-handlers.ts",
-      "description": "Handlers for CRUD operations and other actions on Contentful AI Actions."
+      "path": "${handlers_path}/ai-action-handlers.ts",
+      "description": "Handlers for CRUD operations and other actions on Contentful AI Actions, including invocation and result retrieval."
     },
     "bulk-action-handlers": {
       "type": "file",
-      "path": "src/handlers/bulk-action-handlers.ts",
-      "description": "Handlers for bulk operations on Contentful entities."
+      "path": "${handlers_path}/bulk-action-handlers.ts",
+      "description": "Handlers for bulk operations on Contentful entities, optimizing performance for operations on multiple items."
     },
     "space-handlers": {
       "type": "file",
-      "path": "src/handlers/space-handlers.ts",
-      "description": "Handlers for operations on Contentful spaces."
+      "path": "${handlers_path}/space-handlers.ts",
+      "description": "Handlers for operations on Contentful spaces, providing top-level organization functionality."
     },
     "ai-actions-types": {
       "type": "file",
-      "path": "src/types/ai-actions.ts",
-      "description": "Type definitions for AI Actions entities and operations."
+      "path": "${typescript_path}/ai-actions.ts",
+      "description": "Type definitions for AI Actions entities and operations, including configuration, templates, and variables schemas."
     },
     "tools-types": {
       "type": "file",
-      "path": "src/types/tools.ts",
-      "description": "Type definitions for the tools used in the project."
+      "path": "${typescript_path}/tools.ts",
+      "description": "Type definitions for the MCP tools used in the project, defining the interface between the model and Contentful."
     },
     "ai-action-tool-generator": {
       "type": "file",
-      "path": "src/utils/ai-action-tool-generator.ts",
-      "description": "Utility for generating tool configurations for AI Actions."
+      "path": "${utils_path}/ai-action-tool-generator.ts",
+      "description": "Utility for generating tool configurations for AI Actions, mapping parameters and creating JSON schemas."
     },
     "summarizer": {
       "type": "file",
-      "path": "src/utils/summarizer.ts",
-      "description": "Utility for summarizing content and responses."
+      "path": "${utils_path}/summarizer.ts",
+      "description": "Utility for summarizing content and responses to provide concise information to the model."
     },
     "validation": {
       "type": "file",
-      "path": "src/utils/validation.ts",
-      "description": "Utility for validating input data and responses."
+      "path": "${utils_path}/validation.ts",
+      "description": "Utility for validating input data and responses to ensure data integrity and proper formatting."
     }
   }
-}
-
+}

AI-ACTIONS-README.md

@@ -210,12 +210,28 @@ function getHandler(name: string) {
 // Handler for dynamic AI Action tools
 async function handleAiActionInvocation(actionId: string, args: any) {
   try {
-    // The getInvocationParams method now handles parameter translation
+    console.error(`Handling AI Action invocation for ${actionId} with args:`, JSON.stringify(args))
+    
+    // Get the parameters using the updated getInvocationParams
     const params = aiActionToolContext.getInvocationParams(actionId, args)
 
+    // Directly use the variables property from getInvocationParams
+    const invocationParams = {
+      spaceId: params.spaceId,
+      environmentId: params.environmentId,
+      aiActionId: params.aiActionId,
+      outputFormat: params.outputFormat,
+      waitForCompletion: params.waitForCompletion,
+      // Use variables directly - this is what we modified in getInvocationParams
+      rawVariables: params.variables
+    }
+    
+    console.error(`Invoking AI Action with params:`, JSON.stringify(invocationParams))
+    
     // Invoke the AI Action
-    return aiActionHandlers.invokeAiAction(params)
+    return aiActionHandlers.invokeAiAction(invocationParams)
   } catch (error) {
+    console.error(`Error invoking AI Action:`, error)
     return {
       isError: true,
       message: error instanceof Error ? error.message : String(error)