@cplace/mcp-server 1.9.1 → 1.10.5

package/dist/tools/board-widget.js

@@ -1,63 +1,102 @@
-import { z } from "zod";
-import { debugLogWithTag } from "../logger.js";
+import { z } from 'zod';
+import { debugLogWithTag } from '../logger.js';
 import { LayoutContextSchema } from './layout.js';
-import { findWidgetById, buildUpdateRequestBody, determineApiEndpoint, buildRequestParams } from './widget-tool-helpers.js';
+import { findWidgetById, buildUpdateRequestBody, determineApiEndpoint, buildRequestParams, } from './widget-tool-helpers.js';
 const TOOL_BOARD_GET_CONFIGURATION = 'cplace_board_get_configuration';
 const TOOL_BOARD_CONFIGURE_CARDS = 'cplace_board_configure_cards';
 const TOOL_BOARD_CONFIGURE_COLUMNS = 'cplace_board_configure_columns';
 const TOOL_BOARD_CONFIGURE_SWIMLANES = 'cplace_board_configure_swimlanes';
 const TOOL_BOARD_CONFIGURE_VISUAL = 'cplace_board_configure_visual';
 const BOARD_WIDGET_TYPE = 'cf.cplace.cboard.main.board';
-const CardDisplaySchema = z.object({
-    dateAttribute: z.string().optional().describe("Attribute for date shown in card footer (e.g., 'cf.myType.dueDate')"),
-    tagAttributes: z.array(z.string()).optional().describe("Attributes for colored tag badges on cards (e.g., ['cf.myType.category'])"),
-    colorAttribute: z.object({
-        attribute: z.string().describe("Enumeration attribute for dynamic left-border color (e.g., 'cf.myType.status')"),
-        colorMapping: z.record(z.string()).describe("Map of enumeration values to hex colors (e.g., {\"Open\": \"#4CAF50\", \"Closed\": \"#F44336\"})")
-    }).optional().describe("Dynamic card border color based on an enumeration attribute"),
-    iconAttributes: z.array(z.object({
-        attribute: z.string().describe("Attribute name for icon indicator"),
-        enabled: z.boolean().optional().default(true).describe("Whether this icon is active (default: true)")
-    })).optional().describe("Attributes shown as icon indicators on cards")
-}).optional();
+const CardDisplaySchema = z
+    .object({
+    dateAttribute: z
+        .string()
+        .optional()
+        .describe("Attribute for date shown in card footer (e.g., 'cf.myType.dueDate')"),
+    tagAttributes: z
+        .array(z.string())
+        .optional()
+        .describe("Attributes for colored tag badges on cards (e.g., ['cf.myType.category'])"),
+    colorAttribute: z
+        .object({
+        attribute: z
+            .string()
+            .describe("Enumeration attribute for dynamic left-border color (e.g., 'cf.myType.status')"),
+        colorMapping: z
+            .record(z.string())
+            .describe('Map of enumeration values to hex colors (e.g., {"Open": "#4CAF50", "Closed": "#F44336"})'),
+    })
+        .optional()
+        .describe('Dynamic card border color based on an enumeration attribute'),
+    iconAttributes: z
+        .array(z.object({
+        attribute: z.string().describe('Attribute name for icon indicator'),
+        enabled: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe('Whether this icon is active (default: true)'),
+    }))
+        .optional()
+        .describe('Attributes shown as icon indicators on cards'),
+})
+    .optional();
 const CardConfigurationSchema = z.object({
-    searchId: z.string().describe("Unique identifier for this card source - used to link columns/swimlanes"),
-    search: z.string().describe("WARNING: Do not manually construct! Use cplaceJson from cplace_search_pages response. Must have 'filters' array, e.g., {\"filters\":[{\"relativeSpace\":\"true\"},{\"types\":[\"cf.myType\"]}]}"),
-    typeId: z.string().optional().describe("Explicit page type (optional, inferred from search)"),
-    cardDisplay: CardDisplaySchema
+    searchId: z
+        .string()
+        .describe('Unique identifier for this card source - used to link columns/swimlanes'),
+    search: z
+        .string()
+        .describe('WARNING: Do not manually construct! Use cplaceJson from cplace_search_pages response. Must have \'filters\' array, e.g., {"filters":[{"relativeSpace":"true"},{"types":["cf.myType"]}]}'),
+    typeId: z.string().optional().describe('Explicit page type (optional, inferred from search)'),
+    cardDisplay: CardDisplaySchema,
 });
-const CardsInputSchema = z.array(CardConfigurationSchema)
+const CardsInputSchema = z
+    .array(CardConfigurationSchema)
     .min(1)
-    .describe("Array of card source configurations. Order determines display priority.");
+    .describe('Array of card source configurations. Order determines display priority.');
 const LocalizedNamesSchema = z.object({
-    en: z.string().describe("English name"),
-    de: z.string().optional().describe("German name (optional)")
+    en: z.string().describe('English name'),
+    de: z.string().optional().describe('German name (optional)'),
 });
 const MappingSchema = z.object({
-    searchId: z.string().describe("Must match a searchId from card configurations"),
+    searchId: z.string().describe('Must match a searchId from card configurations'),
     attribute: z.string().describe("Attribute determining placement (e.g., 'cf.myType.status')"),
-    values: z.array(z.string()).optional().describe("Enumeration attribute values mapping to this column/swimlane"),
-    referenceValues: z.array(z.string()).optional().describe("Reference attribute values as page UIDs (e.g., '6a0pydt3gd31ea3d42hdhqf4t')"),
-    dateRange: z.object({
+    values: z
+        .array(z.string())
+        .optional()
+        .describe('Enumeration attribute values mapping to this column/swimlane'),
+    referenceValues: z
+        .array(z.string())
+        .optional()
+        .describe("Reference attribute values as page UIDs (e.g., '6a0pydt3gd31ea3d42hdhqf4t')"),
+    dateRange: z
+        .object({
         start: z.string(),
-        end: z.string()
-    }).optional().describe("Date range for date-type attribute mapping")
+        end: z.string(),
+    })
+        .optional()
+        .describe('Date range for date-type attribute mapping'),
 });
 const StaticColumnSchema = z.object({
-    columnId: z.string().describe("Unique identifier for this column"),
+    columnId: z.string().describe('Unique identifier for this column'),
     names: LocalizedNamesSchema,
-    mappings: z.array(MappingSchema).min(1).describe("Value mappings per card source")
+    mappings: z.array(MappingSchema).min(1).describe('Value mappings per card source'),
 });
 const StaticSwimlaneSchema = z.object({
-    swimlaneId: z.string().describe("Unique identifier for this swimlane"),
+    swimlaneId: z.string().describe('Unique identifier for this swimlane'),
     names: LocalizedNamesSchema,
-    mappings: z.array(MappingSchema).min(1).describe("Value mappings per card source")
+    mappings: z.array(MappingSchema).min(1).describe('Value mappings per card source'),
 });
 const DynamicConfigSchema = z.object({
-    mappedAttributes: z.array(z.object({
+    mappedAttributes: z
+        .array(z.object({
         searchId: z.string(),
-        attribute: z.string()
-    })).min(1).describe("Attribute mappings per card source. Dynamic mode requires enumeration attributes.")
+        attribute: z.string(),
+    }))
+        .min(1)
+        .describe('Attribute mappings per card source. Dynamic mode requires enumeration attributes.'),
 });
 const BOARD_TOOL_DEFINITIONS = {
     [TOOL_BOARD_GET_CONFIGURATION]: {
@@ -72,9 +111,9 @@ Returns the current state of:
 WORKFLOW: Use this tool first, then modify the relevant section and pass to the corresponding configure tool.`,
         inputSchema: {
             context: LayoutContextSchema,
-            widgetId: z.string().describe("The board widget ID (e.g., 'id_abc123')")
+            widgetId: z.string().describe("The board widget ID (e.g., 'id_abc123')"),
         },
-        annotations: { title: "Get Board Configuration" }
+        annotations: { title: 'Get Board Configuration' },
     },
     [TOOL_BOARD_CONFIGURE_CARDS]: {
         description: `Configure card sources for a board widget. Declares the complete set of card sources - existing sources not in the array will be removed.
@@ -104,10 +143,10 @@ WORKFLOW:
 3. Call this tool with the complete desired cards array`,
         inputSchema: {
             context: LayoutContextSchema,
-            widgetId: z.string().describe("The board widget ID"),
-            cards: CardsInputSchema
+            widgetId: z.string().describe('The board widget ID'),
+            cards: CardsInputSchema,
         },
-        annotations: { title: "Configure Board Cards" }
+        annotations: { title: 'Configure Board Cards' },
     },
     [TOOL_BOARD_CONFIGURE_COLUMNS]: {
         description: `Configure column structure for a board widget. Declares the complete column configuration.
@@ -137,12 +176,15 @@ WORKFLOW:
 4. Call this tool with complete desired state`,
         inputSchema: {
             context: LayoutContextSchema,
-            widgetId: z.string().describe("The board widget ID"),
-            mode: z.enum(["static", "dynamic"]).describe("Column generation mode"),
-            columns: z.array(StaticColumnSchema).optional().describe("Static column definitions (required for static mode)"),
-            dynamicConfig: DynamicConfigSchema.optional().describe("Dynamic column configuration (required for dynamic mode)")
+            widgetId: z.string().describe('The board widget ID'),
+            mode: z.enum(['static', 'dynamic']).describe('Column generation mode'),
+            columns: z
+                .array(StaticColumnSchema)
+                .optional()
+                .describe('Static column definitions (required for static mode)'),
+            dynamicConfig: DynamicConfigSchema.optional().describe('Dynamic column configuration (required for dynamic mode)'),
         },
-        annotations: { title: "Configure Board Columns" }
+        annotations: { title: 'Configure Board Columns' },
     },
     [TOOL_BOARD_CONFIGURE_SWIMLANES]: {
         description: `Configure swimlane structure for a board widget. Swimlanes create horizontal groupings within columns.
@@ -170,13 +212,16 @@ WORKFLOW:
 4. Call this tool with complete desired state`,
         inputSchema: {
             context: LayoutContextSchema,
-            widgetId: z.string().describe("The board widget ID"),
-            enabled: z.boolean().describe("false = no swimlanes (flat board)"),
-            mode: z.enum(["static", "dynamic"]).optional().describe("Swimlane generation mode (required when enabled)"),
-            swimlanes: z.array(StaticSwimlaneSchema).optional().describe("Static swimlane definitions"),
-            dynamicConfig: DynamicConfigSchema.optional().describe("Dynamic swimlane configuration")
+            widgetId: z.string().describe('The board widget ID'),
+            enabled: z.boolean().describe('false = no swimlanes (flat board)'),
+            mode: z
+                .enum(['static', 'dynamic'])
+                .optional()
+                .describe('Swimlane generation mode (required when enabled)'),
+            swimlanes: z.array(StaticSwimlaneSchema).optional().describe('Static swimlane definitions'),
+            dynamicConfig: DynamicConfigSchema.optional().describe('Dynamic swimlane configuration'),
         },
-        annotations: { title: "Configure Board Swimlanes" }
+        annotations: { title: 'Configure Board Swimlanes' },
     },
     [TOOL_BOARD_CONFIGURE_VISUAL]: {
         description: `Configure visual settings for a board widget. Controls UI features and display options.
@@ -193,37 +238,61 @@ Available settings:
 Omitted settings retain their current values (this tool does partial updates for visual settings).`,
         inputSchema: {
             context: LayoutContextSchema,
-            widgetId: z.string().describe("The board widget ID"),
-            showCardCount: z.boolean().optional().describe("Show card count in column headers"),
+            widgetId: z.string().describe('The board widget ID'),
+            showCardCount: z.boolean().optional().describe('Show card count in column headers'),
             enableQuickAdd: z.boolean().optional().describe("Show '+' button to create new cards"),
-            showUnmappedContainer: z.boolean().optional().describe("Show container for cards without valid column mapping"),
-            unmappedContainerNames: LocalizedNamesSchema.optional().describe("Localized names for unmapped container"),
-            enableCardDetailsView: z.boolean().optional().describe("Show card details inline instead of navigation"),
-            showSpaceAfterLastColumn: z.boolean().optional().describe("Add visual spacing after last column"),
-            enableRecentHistory: z.boolean().optional().describe("Show button to highlight recently changed cards"),
-            recentHistoryWeeks: z.number().optional().describe("Time range for 'recent' cards (default: 2)")
+            showUnmappedContainer: z
+                .boolean()
+                .optional()
+                .describe('Show container for cards without valid column mapping'),
+            unmappedContainerNames: LocalizedNamesSchema.optional().describe('Localized names for unmapped container'),
+            enableCardDetailsView: z
+                .boolean()
+                .optional()
+                .describe('Show card details inline instead of navigation'),
+            showSpaceAfterLastColumn: z
+                .boolean()
+                .optional()
+                .describe('Add visual spacing after last column'),
+            enableRecentHistory: z
+                .boolean()
+                .optional()
+                .describe('Show button to highlight recently changed cards'),
+            recentHistoryWeeks: z
+                .number()
+                .optional()
+                .describe("Time range for 'recent' cards (default: 2)"),
         },
-        annotations: { title: "Configure Board Visual Settings" }
-    }
+        annotations: { title: 'Configure Board Visual Settings' },
+    },
 };
 function extractWidgetConfiguration(widget) {
     const config = {};
     const CBOARD_PREFIX = 'cf.cplace.cboard.';
-    const KNOWN_ATTRS = ['searchConfigurations', 'columnMapping', 'swimlaneMapping', 'visualComponents'];
+    const KNOWN_ATTRS = [
+        'searchConfigurations',
+        'columnMapping',
+        'swimlaneMapping',
+        'visualComponents',
+    ];
     const parseSearchConfigurations = (value) => {
-        return (value || []).map((v) => {
+        return (value || [])
+            .map((v) => {
             try {
                 return JSON.parse(v);
             }
             catch {
                 return null;
             }
-        }).filter((v) => v !== null);
+        })
+            .filter((v) => v !== null);
     };
     const getShortName = (name) => {
         return name.startsWith(CBOARD_PREFIX) ? name.slice(CBOARD_PREFIX.length) : name;
     };
-    if (widget.configuration && typeof widget.configuration === 'object' && !Array.isArray(widget.configuration)) {
+    if (widget.configuration &&
+        typeof widget.configuration === 'object' &&
+        !Array.isArray(widget.configuration)) {
         for (const [key, value] of Object.entries(widget.configuration)) {
             const shortName = getShortName(key);
             if (shortName === 'searchConfigurations') {
@@ -247,12 +316,12 @@ function extractWidgetConfiguration(widget) {
     return config;
 }
 function validateSearchIdReferences(referencedIds, availableIds, contextDescription) {
-    const invalidIds = referencedIds.filter(id => !availableIds.includes(id));
+    const invalidIds = referencedIds.filter((id) => !availableIds.includes(id));
     if (invalidIds.length > 0) {
         return {
             valid: false,
-            error: `${contextDescription} references unknown searchId(s): ${invalidIds.map(id => `'${id}'`).join(', ')}. ` +
-                `Available searchIds: [${availableIds.map(id => `'${id}'`).join(', ')}]`
+            error: `${contextDescription} references unknown searchId(s): ${invalidIds.map((id) => `'${id}'`).join(', ')}. ` +
+                `Available searchIds: [${availableIds.map((id) => `'${id}'`).join(', ')}]`,
         };
     }
     return { valid: true };
@@ -262,7 +331,7 @@ function transformRawToFriendly(rawConfig) {
         const card = {
             searchId: sc.searchId,
             search: sc.search,
-            typeId: sc.typeId
+            typeId: sc.typeId,
         };
         const hasCardDisplay = sc.visibleDateAttribute || sc.attributeTags || sc.colorAttribute || sc.customIconAttributes;
         if (hasCardDisplay) {
@@ -276,13 +345,13 @@ function transformRawToFriendly(rawConfig) {
             if (sc.colorAttribute) {
                 card.cardDisplay.colorAttribute = {
                     attribute: sc.colorAttribute.attributeSimpleName,
-                    colorMapping: sc.colorAttribute.selection || {}
+                    colorMapping: sc.colorAttribute.selection || {},
                 };
             }
             if (sc.customIconAttributes?.length) {
                 card.cardDisplay.iconAttributes = sc.customIconAttributes.map((cia) => ({
                     attribute: cia.attributeSimpleName,
-                    enabled: cia.enabled
+                    enabled: cia.enabled,
                 }));
             }
         }
@@ -336,28 +405,29 @@ function transformMappingToFriendly(raw, elementType) {
     }
     if (raw.dynamic) {
         return {
-            mode: "dynamic",
+            mode: 'dynamic',
             ...(elementType === 'swimlane' && { enabled: true }),
             dynamicConfig: {
                 mappedAttributes: raw.mappedAttributes?.map((ma) => ({
                     searchId: ma.searchId,
-                    attribute: ma.attributeSimpleName
+                    attribute: ma.attributeSimpleName,
                 })),
                 timeGranularity: raw.timeGranularity?.toLowerCase(),
                 dateRange: raw.dateRange,
-                dateFormatId: raw.dateFormatId
-            }
+                dateFormatId: raw.dateFormatId,
+            },
         };
     }
     return {
-        mode: "static",
+        mode: 'static',
         ...(elementType === 'swimlane' && { enabled: true }),
         [pluralField]: raw.elements?.map((el) => ({
             [idField]: el.id,
             names: el.localizedNames,
             mappings: el.mappedValues?.map((mv) => ({
                 searchId: mv.searchId,
-                attribute: raw.mappedAttributes?.find((ma) => ma.searchId === mv.searchId)?.attributeSimpleName,
+                attribute: raw.mappedAttributes?.find((ma) => ma.searchId === mv.searchId)
+                    ?.attributeSimpleName,
                 values: mv.values?.length ? mv.values : undefined,
                 referenceValues: mv.referenceValues?.length
                     ? mv.referenceValues.map((rv) => {
@@ -365,9 +435,9 @@ function transformMappingToFriendly(raw, elementType) {
                         return uid.startsWith('page/') ? uid.slice(5) : uid;
                     })
                     : undefined,
-                dateRange: mv.dateRange || undefined
-            }))
-        }))
+                dateRange: mv.dateRange || undefined,
+            })),
+        })),
     };
 }
 function transformVisualToFriendly(raw) {
@@ -379,15 +449,15 @@ function transformVisualToFriendly(raw) {
         enableCardDetailsView: raw.cardDetailsViewEnabled,
         showSpaceAfterLastColumn: raw.spaceAfterLastColumnEnabled,
         enableRecentHistory: raw.recentHistoryButtonEnabled,
-        recentHistoryWeeks: raw.recentHistoryTimeRangeWeeks
+        recentHistoryWeeks: raw.recentHistoryTimeRangeWeeks,
     };
 }
 function transformCardsToRaw(cards) {
-    return cards.map(card => {
+    return cards.map((card) => {
         const raw = {
             searchId: card.searchId,
             search: card.search,
-            typeId: card.typeId
+            typeId: card.typeId,
         };
         if (card.cardDisplay) {
             if (card.cardDisplay.dateAttribute) {
@@ -399,13 +469,13 @@ function transformCardsToRaw(cards) {
             if (card.cardDisplay.colorAttribute) {
                 raw.colorAttribute = {
                     attributeSimpleName: card.cardDisplay.colorAttribute.attribute,
-                    selection: card.cardDisplay.colorAttribute.colorMapping
+                    selection: card.cardDisplay.colorAttribute.colorMapping,
                 };
             }
             if (card.cardDisplay.iconAttributes) {
                 raw.customIconAttributes = card.cardDisplay.iconAttributes.map((ia) => ({
                     enabled: ia.enabled !== false,
-                    attributeSimpleName: ia.attribute
+                    attributeSimpleName: ia.attribute,
                 }));
             }
         }
@@ -419,8 +489,8 @@ function transformMappedValuesToRaw(mapping) {
         referenceValues: (mapping.referenceValues || []).map((uid) => ({
             linkUid: uid.startsWith('page/') ? uid : `page/${uid}`,
             linkName: '',
-            linkIcon: ''
-        }))
+            linkIcon: '',
+        })),
     };
     if (mapping.dateRange) {
         raw.dateRange = mapping.dateRange;
@@ -428,14 +498,14 @@ function transformMappedValuesToRaw(mapping) {
     return raw;
 }
 function transformColumnsToRaw(columnsConfig) {
-    if (columnsConfig.mode === "dynamic") {
+    if (columnsConfig.mode === 'dynamic') {
         return JSON.stringify({
             dynamic: true,
             mappedAttributes: columnsConfig.dynamicConfig.mappedAttributes.map((ma) => ({
                 searchId: ma.searchId,
-                attributeSimpleName: ma.attribute
+                attributeSimpleName: ma.attribute,
             })),
-            elements: []
+            elements: [],
         });
     }
     const mappedAttributesMap = new Map();
@@ -448,13 +518,13 @@ function transformColumnsToRaw(columnsConfig) {
         dynamic: false,
         mappedAttributes: Array.from(mappedAttributesMap.entries()).map(([searchId, attr]) => ({
             searchId,
-            attributeSimpleName: attr
+            attributeSimpleName: attr,
         })),
         elements: columnsConfig.columns.map((col) => ({
             id: col.columnId,
             localizedNames: col.names,
-            mappedValues: col.mappings.map(transformMappedValuesToRaw)
-        }))
+            mappedValues: col.mappings.map(transformMappedValuesToRaw),
+        })),
     });
 }
 function transformSwimlanesToRaw(swimlanesConfig) {
@@ -462,17 +532,17 @@ function transformSwimlanesToRaw(swimlanesConfig) {
         return JSON.stringify({
             dynamic: false,
             mappedAttributes: [],
-            elements: []
+            elements: [],
         });
     }
-    if (swimlanesConfig.mode === "dynamic") {
+    if (swimlanesConfig.mode === 'dynamic') {
         return JSON.stringify({
             dynamic: true,
             mappedAttributes: swimlanesConfig.dynamicConfig.mappedAttributes.map((ma) => ({
                 searchId: ma.searchId,
-                attributeSimpleName: ma.attribute
+                attributeSimpleName: ma.attribute,
             })),
-            elements: []
+            elements: [],
         });
     }
     const mappedAttributesMap = new Map();
@@ -485,13 +555,13 @@ function transformSwimlanesToRaw(swimlanesConfig) {
         dynamic: false,
         mappedAttributes: Array.from(mappedAttributesMap.entries()).map(([searchId, attr]) => ({
             searchId,
-            attributeSimpleName: attr
+            attributeSimpleName: attr,
         })),
         elements: swimlanesConfig.swimlanes.map((sl) => ({
             id: sl.swimlaneId,
             localizedNames: sl.names,
-            mappedValues: sl.mappings.map(transformMappedValuesToRaw)
-        }))
+            mappedValues: sl.mappings.map(transformMappedValuesToRaw),
+        })),
     });
 }
 function transformVisualToRaw(friendlyVisual) {
@@ -503,7 +573,7 @@ function transformVisualToRaw(friendlyVisual) {
         enableCardDetailsView: 'cardDetailsViewEnabled',
         showSpaceAfterLastColumn: 'spaceAfterLastColumnEnabled',
         enableRecentHistory: 'recentHistoryButtonEnabled',
-        recentHistoryWeeks: 'recentHistoryTimeRangeWeeks'
+        recentHistoryWeeks: 'recentHistoryTimeRangeWeeks',
     };
     const raw = {};
     for (const [friendlyName, rawName] of Object.entries(fieldMapping)) {
@@ -529,11 +599,13 @@ async function getCurrentBoardConfig(client, context, widgetId) {
         const friendlyConfig = transformRawToFriendly(rawConfig);
         return {
             cards: friendlyConfig.cards,
-            visualComponents: friendlyConfig.visualComponents
+            visualComponents: friendlyConfig.visualComponents,
         };
     }
     catch (error) {
-        return { error: `Failed to get current configuration: ${error instanceof Error ? error.message : String(error)}` };
+        return {
+            error: `Failed to get current configuration: ${error instanceof Error ? error.message : String(error)}`,
+        };
     }
 }
 export function registerBoardWidgetTools(server, client) {
@@ -546,154 +618,203 @@ export function registerBoardWidgetTools(server, client) {
             const widget = findWidgetById(layoutResult.rows, widgetId);
             if (!widget) {
                 return {
-                    content: [{ type: "text", text: `Board widget with ID '${widgetId}' not found in layout` }],
-                    isError: true
+                    content: [
+                        { type: 'text', text: `Board widget with ID '${widgetId}' not found in layout` },
+                    ],
+                    isError: true,
                 };
             }
             if (widget.widgetType !== BOARD_WIDGET_TYPE) {
                 return {
-                    content: [{ type: "text", text: `Widget '${widgetId}' is not a board widget (found: ${widget.widgetType})` }],
-                    isError: true
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Widget '${widgetId}' is not a board widget (found: ${widget.widgetType})`,
+                        },
+                    ],
+                    isError: true,
                 };
             }
             const rawConfig = extractWidgetConfiguration(widget);
-            const isUnconfigured = (!rawConfig.searchConfigurations || rawConfig.searchConfigurations.length === 0)
-                && !rawConfig.columnMapping
-                && !rawConfig.swimlaneMapping;
+            const isUnconfigured = (!rawConfig.searchConfigurations || rawConfig.searchConfigurations.length === 0) &&
+                !rawConfig.columnMapping &&
+                !rawConfig.swimlaneMapping;
             if (isUnconfigured) {
                 debugLogWithTag('BOARD', `Board widget ${widgetId} is unconfigured (no card sources or mappings)`);
                 return {
-                    content: [{ type: "text", text: JSON.stringify({
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
                                 context,
                                 widgetId,
                                 configuration: {
-                                    status: "unconfigured",
+                                    status: 'unconfigured',
                                     cards: [],
                                     columns: null,
                                     swimlanes: null,
-                                    visualComponents: null
-                                }
-                            }, null, 2) }]
+                                    visualComponents: null,
+                                },
+                            }, null, 2),
+                        },
+                    ],
                 };
             }
             const friendlyConfig = transformRawToFriendly(rawConfig);
             debugLogWithTag('BOARD', `Successfully retrieved board configuration with ${friendlyConfig.cards?.length || 0} card sources`);
             return {
-                content: [{ type: "text", text: JSON.stringify({
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
                             context,
                             widgetId,
                             configuration: {
-                                status: "configured",
-                                ...friendlyConfig
-                            }
-                        }, null, 2) }]
+                                status: 'configured',
+                                ...friendlyConfig,
+                            },
+                        }, null, 2),
+                    },
+                ],
             };
         }
         catch (error) {
             debugLogWithTag('BOARD', `Error getting board configuration: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Failed to get board configuration: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get board configuration: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
     server.registerTool(TOOL_BOARD_CONFIGURE_CARDS, BOARD_TOOL_DEFINITIONS[TOOL_BOARD_CONFIGURE_CARDS], async ({ context, widgetId, cards }) => {
         debugLogWithTag('BOARD', `Configuring ${cards.length} card sources for widget ${widgetId}`);
         try {
-            const searchIds = cards.map(c => c.searchId);
+            const searchIds = cards.map((c) => c.searchId);
             const duplicates = searchIds.filter((id, i) => searchIds.indexOf(id) !== i);
             if (duplicates.length > 0) {
                 return {
-                    content: [{ type: "text", text: `Duplicate searchId(s) found: ${[...new Set(duplicates)].join(', ')}. Each searchId must be unique.` }],
-                    isError: true
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Duplicate searchId(s) found: ${[...new Set(duplicates)].join(', ')}. Each searchId must be unique.`,
+                        },
+                    ],
+                    isError: true,
                 };
             }
             const rawSearchConfigurations = transformCardsToRaw(cards);
             const endpoint = determineApiEndpoint(context);
-            const searchConfigurationsValue = rawSearchConfigurations.map(sc => JSON.stringify(sc));
+            const searchConfigurationsValue = rawSearchConfigurations.map((sc) => JSON.stringify(sc));
             debugLogWithTag('BOARD', `searchConfigurationsValue: ${JSON.stringify(searchConfigurationsValue)}`);
             const requestBody = buildUpdateRequestBody(context, widgetId, {
-                'cf.cplace.cboard.searchConfigurations': searchConfigurationsValue
+                'cf.cplace.cboard.searchConfigurations': searchConfigurationsValue,
             });
             await client.makeApiRequest(endpoint, 'PATCH', undefined, requestBody);
             debugLogWithTag('BOARD', `Successfully configured ${cards.length} card sources`);
             return {
-                content: [{ type: "text", text: JSON.stringify({
-                            operation: "CONFIGURE_CARDS",
-                            status: "SUCCESS",
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            operation: 'CONFIGURE_CARDS',
+                            status: 'SUCCESS',
                             context,
                             widgetId,
                             cardCount: cards.length,
                             searchIds: searchIds,
-                            message: `Board cards configured successfully with ${cards.length} source(s)`
-                        }, null, 2) }]
+                            message: `Board cards configured successfully with ${cards.length} source(s)`,
+                        }, null, 2),
+                    },
+                ],
             };
         }
         catch (error) {
             debugLogWithTag('BOARD', `Error configuring cards: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Failed to configure board cards: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to configure board cards: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
     server.registerTool(TOOL_BOARD_CONFIGURE_COLUMNS, BOARD_TOOL_DEFINITIONS[TOOL_BOARD_CONFIGURE_COLUMNS], async ({ context, widgetId, mode, columns, dynamicConfig }) => {
         debugLogWithTag('BOARD', `Configuring columns (${mode} mode) for widget ${widgetId}`);
         try {
-            if (mode === "static" && (!columns || columns.length === 0)) {
+            if (mode === 'static' && (!columns || columns.length === 0)) {
                 return {
-                    content: [{ type: "text", text: "Static mode requires at least one column definition" }],
-                    isError: true
+                    content: [
+                        { type: 'text', text: 'Static mode requires at least one column definition' },
+                    ],
+                    isError: true,
                 };
             }
-            if (mode === "dynamic" && !dynamicConfig) {
+            if (mode === 'dynamic' && !dynamicConfig) {
                 return {
-                    content: [{ type: "text", text: "Dynamic mode requires dynamicConfig" }],
-                    isError: true
+                    content: [{ type: 'text', text: 'Dynamic mode requires dynamicConfig' }],
+                    isError: true,
                 };
             }
             const currentConfig = await getCurrentBoardConfig(client, context, widgetId);
             if (currentConfig.error) {
                 return {
-                    content: [{ type: "text", text: currentConfig.error }],
-                    isError: true
+                    content: [{ type: 'text', text: currentConfig.error }],
+                    isError: true,
                 };
             }
             const availableSearchIds = currentConfig.cards?.map((c) => c.searchId) || [];
-            const referencedIds = mode === "static"
-                ? [...new Set(columns.flatMap(col => col.mappings.map(m => m.searchId)))]
-                : (dynamicConfig?.mappedAttributes || []).map(ma => ma.searchId);
-            const validation = validateSearchIdReferences(referencedIds, availableSearchIds, "Column configuration");
+            const referencedIds = mode === 'static'
+                ? [...new Set(columns.flatMap((col) => col.mappings.map((m) => m.searchId)))]
+                : (dynamicConfig?.mappedAttributes || []).map((ma) => ma.searchId);
+            const validation = validateSearchIdReferences(referencedIds, availableSearchIds, 'Column configuration');
             if (!validation.valid) {
                 return {
-                    content: [{ type: "text", text: validation.error }],
-                    isError: true
+                    content: [{ type: 'text', text: validation.error }],
+                    isError: true,
                 };
             }
             const rawColumnMapping = transformColumnsToRaw({ mode, columns, dynamicConfig });
             const endpoint = determineApiEndpoint(context);
             const requestBody = buildUpdateRequestBody(context, widgetId, {
-                'cf.cplace.cboard.columnMapping': rawColumnMapping
+                'cf.cplace.cboard.columnMapping': rawColumnMapping,
             });
             await client.makeApiRequest(endpoint, 'PATCH', undefined, requestBody);
             debugLogWithTag('BOARD', `Successfully configured columns in ${mode} mode`);
             return {
-                content: [{ type: "text", text: JSON.stringify({
-                            operation: "CONFIGURE_COLUMNS",
-                            status: "SUCCESS",
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            operation: 'CONFIGURE_COLUMNS',
+                            status: 'SUCCESS',
                             context,
                             widgetId,
                             mode,
-                            columnCount: mode === "static" ? columns.length : "dynamic",
-                            message: `Board columns configured successfully (${mode} mode)`
-                        }, null, 2) }]
+                            columnCount: mode === 'static' ? columns.length : 'dynamic',
+                            message: `Board columns configured successfully (${mode} mode)`,
+                        }, null, 2),
+                    },
+                ],
             };
         }
         catch (error) {
             debugLogWithTag('BOARD', `Error configuring columns: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Failed to configure board columns: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to configure board columns: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -704,81 +825,103 @@ export function registerBoardWidgetTools(server, client) {
                 const rawSwimlaneMapping = transformSwimlanesToRaw({ enabled: false });
                 const endpoint = determineApiEndpoint(context);
                 const requestBody = buildUpdateRequestBody(context, widgetId, {
-                    'cf.cplace.cboard.swimlaneMapping': rawSwimlaneMapping
+                    'cf.cplace.cboard.swimlaneMapping': rawSwimlaneMapping,
                 });
                 await client.makeApiRequest(endpoint, 'PATCH', undefined, requestBody);
                 return {
-                    content: [{ type: "text", text: JSON.stringify({
-                                operation: "CONFIGURE_SWIMLANES",
-                                status: "SUCCESS",
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                operation: 'CONFIGURE_SWIMLANES',
+                                status: 'SUCCESS',
                                 context,
                                 widgetId,
                                 enabled: false,
-                                message: "Board swimlanes disabled (flat board)"
-                            }, null, 2) }]
+                                message: 'Board swimlanes disabled (flat board)',
+                            }, null, 2),
+                        },
+                    ],
                 };
             }
             if (!mode) {
                 return {
-                    content: [{ type: "text", text: "Mode is required when swimlanes are enabled" }],
-                    isError: true
+                    content: [{ type: 'text', text: 'Mode is required when swimlanes are enabled' }],
+                    isError: true,
                 };
             }
-            if (mode === "static" && (!swimlanes || swimlanes.length === 0)) {
+            if (mode === 'static' && (!swimlanes || swimlanes.length === 0)) {
                 return {
-                    content: [{ type: "text", text: "Static mode requires at least one swimlane definition" }],
-                    isError: true
+                    content: [
+                        { type: 'text', text: 'Static mode requires at least one swimlane definition' },
+                    ],
+                    isError: true,
                 };
             }
-            if (mode === "dynamic" && !dynamicConfig) {
+            if (mode === 'dynamic' && !dynamicConfig) {
                 return {
-                    content: [{ type: "text", text: "Dynamic mode requires dynamicConfig" }],
-                    isError: true
+                    content: [{ type: 'text', text: 'Dynamic mode requires dynamicConfig' }],
+                    isError: true,
                 };
             }
             const currentConfig = await getCurrentBoardConfig(client, context, widgetId);
             if (currentConfig.error) {
                 return {
-                    content: [{ type: "text", text: currentConfig.error }],
-                    isError: true
+                    content: [{ type: 'text', text: currentConfig.error }],
+                    isError: true,
                 };
             }
             const availableSearchIds = currentConfig.cards?.map((c) => c.searchId) || [];
-            const referencedIds = mode === "static"
-                ? [...new Set(swimlanes.flatMap(sl => sl.mappings.map(m => m.searchId)))]
-                : (dynamicConfig?.mappedAttributes || []).map(ma => ma.searchId);
-            const validation = validateSearchIdReferences(referencedIds, availableSearchIds, "Swimlane configuration");
+            const referencedIds = mode === 'static'
+                ? [...new Set(swimlanes.flatMap((sl) => sl.mappings.map((m) => m.searchId)))]
+                : (dynamicConfig?.mappedAttributes || []).map((ma) => ma.searchId);
+            const validation = validateSearchIdReferences(referencedIds, availableSearchIds, 'Swimlane configuration');
             if (!validation.valid) {
                 return {
-                    content: [{ type: "text", text: validation.error }],
-                    isError: true
+                    content: [{ type: 'text', text: validation.error }],
+                    isError: true,
                 };
             }
-            const rawSwimlaneMapping = transformSwimlanesToRaw({ enabled: true, mode, swimlanes, dynamicConfig });
+            const rawSwimlaneMapping = transformSwimlanesToRaw({
+                enabled: true,
+                mode,
+                swimlanes,
+                dynamicConfig,
+            });
             const endpoint = determineApiEndpoint(context);
             const requestBody = buildUpdateRequestBody(context, widgetId, {
-                'cf.cplace.cboard.swimlaneMapping': rawSwimlaneMapping
+                'cf.cplace.cboard.swimlaneMapping': rawSwimlaneMapping,
             });
             await client.makeApiRequest(endpoint, 'PATCH', undefined, requestBody);
             debugLogWithTag('BOARD', `Successfully configured swimlanes in ${mode} mode`);
             return {
-                content: [{ type: "text", text: JSON.stringify({
-                            operation: "CONFIGURE_SWIMLANES",
-                            status: "SUCCESS",
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            operation: 'CONFIGURE_SWIMLANES',
+                            status: 'SUCCESS',
                             context,
                             widgetId,
                             enabled: true,
                             mode,
-                            swimlaneCount: mode === "static" ? swimlanes.length : "dynamic",
-                            message: `Board swimlanes configured successfully (${mode} mode)`
-                        }, null, 2) }]
+                            swimlaneCount: mode === 'static' ? swimlanes.length : 'dynamic',
+                            message: `Board swimlanes configured successfully (${mode} mode)`,
+                        }, null, 2),
+                    },
+                ],
             };
         }
         catch (error) {
             debugLogWithTag('BOARD', `Error configuring swimlanes: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Failed to configure board swimlanes: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to configure board swimlanes: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -788,8 +931,8 @@ export function registerBoardWidgetTools(server, client) {
             const currentConfig = await getCurrentBoardConfig(client, context, widgetId);
             if (currentConfig.error) {
                 return {
-                    content: [{ type: "text", text: currentConfig.error }],
-                    isError: true
+                    content: [{ type: 'text', text: currentConfig.error }],
+                    isError: true,
                 };
             }
             const currentVisual = currentConfig.visualComponents || {};
@@ -799,27 +942,37 @@ export function registerBoardWidgetTools(server, client) {
             const rawVisualComponents = JSON.stringify(mergedRaw);
             const endpoint = determineApiEndpoint(context);
             const requestBody = buildUpdateRequestBody(context, widgetId, {
-                'cf.cplace.cboard.visualComponents': rawVisualComponents
+                'cf.cplace.cboard.visualComponents': rawVisualComponents,
             });
             await client.makeApiRequest(endpoint, 'PATCH', undefined, requestBody);
             debugLogWithTag('BOARD', `Successfully configured visual settings`);
-            const appliedSettings = Object.keys(visualSettings).filter(k => visualSettings[k] !== undefined);
+            const appliedSettings = Object.keys(visualSettings).filter((k) => visualSettings[k] !== undefined);
             return {
-                content: [{ type: "text", text: JSON.stringify({
-                            operation: "CONFIGURE_VISUAL",
-                            status: "SUCCESS",
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            operation: 'CONFIGURE_VISUAL',
+                            status: 'SUCCESS',
                             context,
                             widgetId,
                             appliedSettings,
-                            message: "Board visual settings configured successfully"
-                        }, null, 2) }]
+                            message: 'Board visual settings configured successfully',
+                        }, null, 2),
+                    },
+                ],
             };
         }
         catch (error) {
             debugLogWithTag('BOARD', `Error configuring visual settings: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Failed to configure board visual settings: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to configure board visual settings: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });