@cplace/mcp-server 1.9.1 → 1.10.5

package/dist/tools/type-management.js

@@ -1,122 +1,303 @@
-import { z } from "zod";
-import { debugLogWithTag } from "../logger.js";
+import { z } from 'zod';
+import { debugLogWithTag } from '../logger.js';
 const TOOL_MANAGE_TYPE_DEFINITION = 'cplace_manage_type_definition';
 const TOOL_MANAGE_ATTRIBUTE_DEFINITION = 'cplace_manage_attribute_definition';
 const TOOL_DELETE_TYPE_DEFINITION = 'cplace_delete_type_definition';
 const TOOL_DELETE_ATTRIBUTE_DEFINITION = 'cplace_delete_attribute_definition';
+const TOOL_LIST_CUSTOM_CONSTRAINT_TYPES = 'cplace_list_custom_constraint_types';
+let cachedCustomConstraintTypes = null;
+const MANAGE_ATTRIBUTE_BASE_DESCRIPTION = 'Create or update attribute definitions within existing type definitions. Supports all major constraint types including string, number, boolean, date, reference, enumeration, and specialized types like rich text and colors. Provides comprehensive configuration options for display properties, validation, and low-code integration.';
+export function buildManageAttributeDefinitionDescription(customTypes) {
+    if (customTypes && customTypes.length > 0) {
+        const lines = customTypes.map((ct) => {
+            const mult = ct.allowedMultiplicities && ct.allowedMultiplicities.length > 0
+                ? `multiplicity: ${ct.allowedMultiplicities.join(', ')}`
+                : 'any multiplicity';
+            return `- ${ct.constraintName} (${mult})`;
+        });
+        return `${MANAGE_ATTRIBUTE_BASE_DESCRIPTION}\n\nCustom constraint types detected at startup:\n${lines.join('\n')}\nFor live/authoritative list, call cplace_list_custom_constraint_types.`;
+    }
+    return `${MANAGE_ATTRIBUTE_BASE_DESCRIPTION}\n\nCustom constraint types from installed plugins are supported. Call cplace_list_custom_constraint_types to see names and allowed multiplicities.`;
+}
+export async function primeCustomConstraintTypeCache(client) {
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), 5000);
+        try {
+            const result = await client.makeApiRequest('json/custom-constraint-types', 'GET');
+            clearTimeout(timeoutId);
+            const entries = Array.isArray(result) ? result : (result?.result ?? []);
+            if (Array.isArray(entries)) {
+                cachedCustomConstraintTypes = entries;
+                TYPE_MANAGEMENT_TOOL_DEFINITIONS[TOOL_MANAGE_ATTRIBUTE_DEFINITION].description =
+                    buildManageAttributeDefinitionDescription(cachedCustomConstraintTypes);
+                debugLogWithTag('TYPE_MANAGEMENT', `Primed custom constraint type cache with ${entries.length} entries`);
+            }
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    catch (error) {
+        debugLogWithTag('TYPE_MANAGEMENT', `Failed to prime custom constraint type cache: ${error instanceof Error ? error.message : String(error)}`);
+        cachedCustomConstraintTypes = null;
+    }
+}
+function appendCustomConstraintHintIfNeeded(errorText) {
+    const isUnknownType = errorText.includes('Unknown constraint type');
+    const isBadMultiplicity = errorText.includes('Multiplicity') && errorText.includes('not allowed');
+    if (isUnknownType || isBadMultiplicity) {
+        return (errorText +
+            '\n\nHint: call cplace_list_custom_constraint_types to see supported custom constraint names and their allowed multiplicities.');
+    }
+    return errorText;
+}
 export const TYPE_MANAGEMENT_TOOL_DEFINITIONS = {
     [TOOL_MANAGE_TYPE_DEFINITION]: {
-        description: "Create or update type definitions in a workspace with comprehensive configuration options. All properties from the enhanced read endpoint are available for both creation and updates to enable complete type configuration.",
+        description: 'Create or update type definitions in a workspace with comprehensive configuration options. All properties from the enhanced read endpoint are available for both creation and updates to enable complete type configuration.',
         inputSchema: {
-            operation: z.enum(["create", "update"]).describe("Operation type: 'create' for new type definitions, 'update' for existing type definitions"),
-            workspaceId: z.string().optional().describe("Required for both: Target workspace ID (e.g., 'abc123')"),
-            typeInternalName: z.string().optional().describe("Type internal name (e.g., 'cf.example.myType') - no trailing dot (NOT `typeId` or `typeName`)"),
-            localizedNames: z.record(z.string()).optional().describe("Localized type names (singular) - e.g., {\"en\": \"My Type\", \"de\": \"Mein Typ\"}"),
-            localizedPlural: z.record(z.string()).optional().describe("Localized type names (plural) - e.g., {\"en\": \"My Types\", \"de\": \"Meine Typen\"}"),
-            description: z.string().optional().describe("Type description"),
-            showInExplorer: z.boolean().optional().describe("Whether to show in explorer (default: true for create)"),
-            readers: z.array(z.string()).optional().describe("Create only: Reader principal IDs (e.g., ['person/user1', 'group/editors'])"),
-            writers: z.array(z.string()).optional().describe("Create only: Writer principal IDs (e.g., ['person/user2'])"),
-            readersAreDefault: z.boolean().optional().describe("Create only: Whether readers use default permissions"),
-            writersAreDefault: z.boolean().optional().describe("Create only: Whether writers use default permissions"),
-            editorsMayDeletePages: z.boolean().optional().describe("Whether editors can delete pages (default: false for create)"),
-            showNewButton: z.boolean().optional().describe("Show 'New' button in UI (default: true for create)"),
-            showInGlobalNewDialog: z.boolean().optional().describe("Include in global new dialog (default: true for create)"),
-            showInGlobalSearch: z.boolean().optional().describe("Include in global search (default: true for create)"),
-            namesAreUnique: z.boolean().optional().describe("Create only: Whether page names must be unique (default: false)"),
-            enableIconLink: z.boolean().optional().describe("Enable icon linking (default: false for create)"),
-            hideTabVersions: z.boolean().optional().describe("Hide versions tab (default: false for create)"),
-            allowDivergentLayouts: z.boolean().optional().describe("Allow different layouts per page (default: false for create)"),
-            iconName: z.string().optional().describe("FontAwesome icon name (e.g., 'fa-project', 'fa-list') or visual icon identifier for update"),
-            nameGenerationPattern: z.string().optional().describe("Auto-naming pattern for pages of this type. When configured, page names can be auto-generated during creation. Angle-bracket DSL: `<attributeName>` for attribute values, `<#>` for sequential counter, `<#|numberFormat:\"0000\">` for zero-padded counter (zero-pad only via numberFormat filter, never via repeated `#`). Examples: `PROJ-<#>` → `PROJ-0`, `PROJ-1`; `PROJ-<#|numberFormat:\"000\">` → `PROJ-000`, `PROJ-001`; `<title>-<#|numberFormat:\"0000\">` → `ProjectAlpha-0001`. Pages can still override with explicit names. Leave empty to require explicit names."),
-            displayNameGenerationPattern: z.string().optional().describe("Display name pattern for UI representation. Same angle-bracket DSL as nameGenerationPattern (`<attributeName>`, `<#>`, `<#|numberFormat:\"000\">`). Shown in UI, separate from internal page name. Cross-field rule: if this pattern uses the counter `<#>`, then nameGenerationPattern must also use `<#>` — backend validation rejects otherwise."),
-            autocompleteDetailsPattern: z.string().optional().describe("Autocomplete display format. Angle-bracket DSL for attribute refs only (no counter — counters are instance-creation-time, autocomplete is display-only). Example: `<cf.myApp.title> - <cf.myApp.category>`. Tokens must be actual attribute internal names defined on the type."),
-            internalAttributeNamePrefix: z.string().optional().describe("Prefix for attribute names (e.g., 'cf.mycompany.risk' - no trailing dot)"),
-            localizedPageNamesMode: z.enum(["none", "optional", "optional_with_dialog", "mandatory"]).optional().describe("Localized naming mode")
+            operation: z
+                .enum(['create', 'update'])
+                .describe("Operation type: 'create' for new type definitions, 'update' for existing type definitions"),
+            workspaceId: z
+                .string()
+                .optional()
+                .describe("Required for both: Target workspace ID (e.g., 'abc123')"),
+            typeInternalName: z
+                .string()
+                .optional()
+                .describe("Type internal name (e.g., 'cf.example.myType') - no trailing dot (NOT `typeId` or `typeName`)"),
+            localizedNames: z
+                .record(z.string())
+                .optional()
+                .describe('Localized type names (singular) - e.g., {"en": "My Type", "de": "Mein Typ"}'),
+            localizedPlural: z
+                .record(z.string())
+                .optional()
+                .describe('Localized type names (plural) - e.g., {"en": "My Types", "de": "Meine Typen"}'),
+            description: z.string().optional().describe('Type description'),
+            showInExplorer: z
+                .boolean()
+                .optional()
+                .describe("Whether the type appears in the workspace navigation menu (UI label: 'Show in workspace navigation'). Default: false — the type is hidden from workspace navigation unless this is set explicitly to true."),
+            readers: z
+                .array(z.string())
+                .optional()
+                .describe("Create only: Reader principal IDs (e.g., ['person/user1', 'group/editors'])"),
+            writers: z
+                .array(z.string())
+                .optional()
+                .describe("Create only: Writer principal IDs (e.g., ['person/user2'])"),
+            readersAreDefault: z
+                .boolean()
+                .optional()
+                .describe('Create only: Whether readers use default permissions'),
+            writersAreDefault: z
+                .boolean()
+                .optional()
+                .describe('Create only: Whether writers use default permissions'),
+            editorsMayDeletePages: z
+                .boolean()
+                .optional()
+                .describe('Whether editors can delete pages (default: false for create)'),
+            showNewButton: z
+                .boolean()
+                .optional()
+                .describe("Show 'New' button in UI (default: true for create)"),
+            showInGlobalNewDialog: z
+                .boolean()
+                .optional()
+                .describe('Include in global new dialog (default: true for create)'),
+            showInGlobalSearch: z
+                .boolean()
+                .optional()
+                .describe('Include in global search (default: true for create)'),
+            namesAreUnique: z
+                .boolean()
+                .optional()
+                .describe('Create only: Whether page names must be unique (default: false)'),
+            enableIconLink: z
+                .boolean()
+                .optional()
+                .describe('Enable icon linking (default: false for create)'),
+            hideTabVersions: z
+                .boolean()
+                .optional()
+                .describe('Hide versions tab (default: false for create)'),
+            allowDivergentLayouts: z
+                .boolean()
+                .optional()
+                .describe('Allow different layouts per page (default: false for create)'),
+            iconName: z
+                .string()
+                .optional()
+                .describe("FontAwesome icon name (e.g., 'fa-project', 'fa-list') or visual icon identifier for update"),
+            nameGenerationPattern: z
+                .string()
+                .optional()
+                .describe('Auto-naming pattern for pages of this type. When configured, page names can be auto-generated during creation. Angle-bracket DSL: `<attributeName>` for attribute values, `<#>` for sequential counter, `<#|numberFormat:"0000">` for zero-padded counter (zero-pad only via numberFormat filter, never via repeated `#`). Examples: `PROJ-<#>` → `PROJ-0`, `PROJ-1`; `PROJ-<#|numberFormat:"000">` → `PROJ-000`, `PROJ-001`; `<title>-<#|numberFormat:"0000">` → `ProjectAlpha-0001`. Pages can still override with explicit names. Leave empty to require explicit names.'),
+            displayNameGenerationPattern: z
+                .string()
+                .optional()
+                .describe('Display name pattern for UI representation. Same angle-bracket DSL as nameGenerationPattern (`<attributeName>`, `<#>`, `<#|numberFormat:"000">`). Shown in UI, separate from internal page name. Cross-field rule: if this pattern uses the counter `<#>`, then nameGenerationPattern must also use `<#>` — backend validation rejects otherwise.'),
+            autocompleteDetailsPattern: z
+                .string()
+                .optional()
+                .describe('Autocomplete display format. Angle-bracket DSL for attribute refs only (no counter — counters are instance-creation-time, autocomplete is display-only). Example: `<cf.myApp.title> - <cf.myApp.category>`. Tokens must be actual attribute internal names defined on the type.'),
+            internalAttributeNamePrefix: z
+                .string()
+                .optional()
+                .describe("Prefix for attribute names (e.g., 'cf.mycompany.risk' - no trailing dot)"),
+            localizedPageNamesMode: z
+                .enum(['none', 'optional', 'optional_with_dialog', 'mandatory'])
+                .optional()
+                .describe('Localized naming mode'),
         },
-        annotations: { title: "Manage Type Definition" }
+        annotations: { title: 'Manage Type Definition' },
     },
     [TOOL_MANAGE_ATTRIBUTE_DEFINITION]: {
-        description: "Create or update attribute definitions within existing type definitions. Supports all major constraint types including string, number, boolean, date, reference, enumeration, and specialized types like rich text and colors. Provides comprehensive configuration options for display properties, validation, and low-code integration.",
+        description: buildManageAttributeDefinitionDescription(cachedCustomConstraintTypes),
         inputSchema: {
-            operation: z.enum(["create", "update"]).describe("Operation type: 'create' for new attribute definitions, 'update' for existing attribute definitions"),
+            operation: z
+                .enum(['create', 'update'])
+                .describe("Operation type: 'create' for new attribute definitions, 'update' for existing attribute definitions"),
             workspaceId: z.string().describe("Target workspace ID (e.g., 'abc123')"),
-            typeInternalName: z.string().describe("Target type internal name (e.g., 'cf.example.myType') (NOT `typeId` or `typeName`)"),
-            attributeName: z.string().describe("For create: short name (e.g., 'myAttribute') or full internal name — prefix auto-prepended if missing. For update: full internal name from create response (e.g., 'cf.cplace.myPlugin.myAttribute')"),
-            multiplicity: z.enum(["exactlyOne", "maximalOne", "atLeastOne", "arbitrary"]).optional().describe("Required for create (except linkedAttribute where it must be omitted). Optional for update."),
-            constraintConfig: z.object({
-                constraintType: z.enum([
-                    "string", "longString", "richString", "localizedString",
-                    "number", "boolean", "date", "color", "reference",
-                    "textEnumeration", "numberEnumeration", "dynamicEnumeration", "workflow",
-                    "linkedAttribute"
-                ]).describe("Constraint type. Note: linkedAttribute constraints cannot be updated via PATCH — delete and recreate instead."),
-                pattern: z.string().optional().describe("Regex pattern for string validation"),
-                patternErrorMessage: z.record(z.string()).optional().describe("Localized error messages for pattern validation"),
-                precision: z.number().optional().describe("Decimal precision (-1 for unlimited)"),
-                suffix: z.record(z.string()).optional().describe("Localized suffix text"),
-                specificity: z.enum(["date", "datetime", "time"]).optional().describe("Date specificity"),
-                withTime: z.boolean().optional().describe("Include time component"),
-                dateFormat: z.string().optional().describe("Display format"),
-                targetTypeNames: z.array(z.string()).optional().describe("Required for 'reference': Target type internal names (e.g., ['cf.example.targetType'])"),
-                targetEntityKind: z.string().optional().describe("Target entity kind"),
-                sameWorkspace: z.boolean().optional().describe("Restrict to same workspace"),
-                isHierarchy: z.boolean().optional().describe("Whether this is a hierarchical reference"),
-                inverseRoleName: z.record(z.string()).optional().describe("Localized inverse role name"),
-                elements: z.array(z.object({
-                    value: z.string().describe("Enumeration value"),
-                    localizedName: z.record(z.string()).describe("Localized display names"),
-                    icon: z.string().optional().describe("Optional icon name")
-                })).optional().describe("Required for 'textEnumeration'/'numberEnumeration': Enumeration elements"),
-                providerClass: z.string().optional().describe("Provider class for dynamicEnumeration"),
-                providerSimpleName: z.string().optional().describe("Provider simple name for dynamicEnumeration"),
-                linkedReferenceName: z.string().optional().describe("Required for 'linkedAttribute': name of a reference attribute on the same type"),
-                linkedPropertyName: z.string().optional().describe("Required for 'linkedAttribute': internal name of the property on the referenced type (e.g., 'cf.cplace.bo.name')")
-            }).optional().describe("Required for create: Constraint configuration object. Optional for update: New constraint configuration object (replaces existing)."),
-            localizedNames: z.record(z.string()).optional().describe("Localized attribute names - e.g., {\"en\": \"My Attribute\", \"de\": \"Mein Attribut\"}"),
-            localizedShortNames: z.record(z.string()).optional().describe("Localized short names - e.g., {\"en\": \"My Attr\", \"de\": \"Mein Attr\"}"),
-            localizedShortHelp: z.record(z.string()).optional().describe("Localized help text - e.g., {\"en\": \"Help text\", \"de\": \"Hilfetext\"}"),
-            readOnly: z.boolean().optional().describe("Whether attribute is read-only"),
-            showInTables: z.boolean().optional().describe("Show in table views"),
-            showInNewDialog: z.boolean().optional().describe("Show in new item dialogs"),
-            showValuesWithLineBreak: z.boolean().optional().describe("Display values with line breaks"),
-            showInAttributesWidget: z.boolean().optional().describe("Show in attribute widgets"),
-            showInColumnSelection: z.boolean().optional().describe("Include in column selection")
+            typeInternalName: z
+                .string()
+                .describe("Target type internal name (e.g., 'cf.example.myType') (NOT `typeId` or `typeName`)"),
+            attributeName: z
+                .string()
+                .describe("For create: short name (e.g., 'myAttribute') or full internal name — prefix auto-prepended if missing. For update: full internal name from create response (e.g., 'cf.cplace.myPlugin.myAttribute')"),
+            multiplicity: z
+                .enum(['exactlyOne', 'maximalOne', 'atLeastOne', 'arbitrary'])
+                .optional()
+                .describe('Required for create (except linkedAttribute where it must be omitted). Optional for update.'),
+            constraintConfig: z
+                .object({
+                constraintType: z
+                    .string()
+                    .describe("Built-in: 'string' | 'longString' | 'richString' | 'localizedString' | " +
+                    "'number' | 'boolean' | 'date' | 'color' | 'reference' | 'textEnumeration'. " +
+                    "Special: 'workflow', 'linkedAttribute'. " +
+                    'Custom constraints from installed plugins are also accepted by constraint name ' +
+                    "(e.g. 'cf.cplace.timeBoundedValues.customAttributeType'). " +
+                    'Call cplace_list_custom_constraint_types to see installed custom constraints. ' +
+                    'Note: linkedAttribute constraints cannot be updated via PATCH — delete and recreate.'),
+                pattern: z.string().optional().describe('Regex pattern for string validation'),
+                patternErrorMessage: z
+                    .record(z.string())
+                    .optional()
+                    .describe('Localized error messages for pattern validation'),
+                precision: z.number().optional().describe('Decimal precision (-1 for unlimited)'),
+                suffix: z.record(z.string()).optional().describe('Localized suffix text'),
+                specificity: z.enum(['date', 'datetime', 'time']).optional().describe('Date specificity'),
+                withTime: z.boolean().optional().describe('Include time component'),
+                dateFormat: z.string().optional().describe('Display format'),
+                targetTypeNames: z
+                    .array(z.string())
+                    .optional()
+                    .describe("Required for 'reference': Target type internal names (e.g., ['cf.example.targetType'])"),
+                targetEntityKind: z.string().optional().describe('Target entity kind'),
+                sameWorkspace: z.boolean().optional().describe('Restrict to same workspace'),
+                isHierarchy: z.boolean().optional().describe('Whether this is a hierarchical reference'),
+                inverseRoleName: z.record(z.string()).optional().describe('Localized inverse role name'),
+                elements: z
+                    .array(z.object({
+                    value: z.string().describe('Enumeration value'),
+                    localizedName: z.record(z.string()).describe('Localized display names'),
+                    icon: z.string().optional().describe('Optional icon name'),
+                }))
+                    .optional()
+                    .describe("Required for 'textEnumeration'/'numberEnumeration': Enumeration elements"),
+                providerClass: z.string().optional().describe('Provider class for dynamicEnumeration'),
+                providerSimpleName: z
+                    .string()
+                    .optional()
+                    .describe('Provider simple name for dynamicEnumeration'),
+                linkedReferenceName: z
+                    .string()
+                    .optional()
+                    .describe("Required for 'linkedAttribute': name of a reference attribute on the same type"),
+                linkedPropertyName: z
+                    .string()
+                    .optional()
+                    .describe("Required for 'linkedAttribute': internal name of the property on the referenced type (e.g., 'cf.cplace.bo.name')"),
+            })
+                .optional()
+                .describe('Required for create: Constraint configuration object. Optional for update: New constraint configuration object (replaces existing).'),
+            localizedNames: z
+                .record(z.string())
+                .optional()
+                .describe('Localized attribute names - e.g., {"en": "My Attribute", "de": "Mein Attribut"}'),
+            localizedShortNames: z
+                .record(z.string())
+                .optional()
+                .describe('Localized short names - e.g., {"en": "My Attr", "de": "Mein Attr"}'),
+            localizedShortHelp: z
+                .record(z.string())
+                .optional()
+                .describe('Localized help text - e.g., {"en": "Help text", "de": "Hilfetext"}'),
+            readOnly: z.boolean().optional().describe('Whether attribute is read-only'),
+            showInTables: z.boolean().optional().describe('Show in table views'),
+            showInNewDialog: z.boolean().optional().describe('Show in new item dialogs'),
+            showValuesWithLineBreak: z.boolean().optional().describe('Display values with line breaks'),
+            showInAttributesWidget: z.boolean().optional().describe('Show in attribute widgets'),
+            showInColumnSelection: z.boolean().optional().describe('Include in column selection'),
         },
-        annotations: { title: "Manage Attribute Definition" }
+        annotations: { title: 'Manage Attribute Definition' },
     },
     [TOOL_DELETE_TYPE_DEFINITION]: {
         description: "Delete a type definition and all its attributes, validators, change listeners, and alternative layouts. Cannot delete types that have existing pages or are referenced by other types' attributes.",
         inputSchema: {
-            workspaceId: z.string().describe("ID of the workspace containing the type (e.g., 'workspace/abc123')"),
-            typeInternalName: z.string().describe("Internal name of the type definition to delete (e.g., 'cf.example.Task') (NOT `typeId` or `typeName`)")
+            workspaceId: z
+                .string()
+                .describe("ID of the workspace containing the type (e.g., 'workspace/abc123')"),
+            typeInternalName: z
+                .string()
+                .describe("Internal name of the type definition to delete (e.g., 'cf.example.Task') (NOT `typeId` or `typeName`)"),
         },
-        annotations: { title: "Delete Type Definition" }
+        annotations: { title: 'Delete Type Definition' },
     },
     [TOOL_DELETE_ATTRIBUTE_DEFINITION]: {
-        description: "Delete an attribute definition from a type. Cannot delete attributes referenced by validators or change listeners — delete those first.",
+        description: 'Delete an attribute definition from a type. Cannot delete attributes referenced by validators or change listeners — delete those first.',
         inputSchema: {
-            workspaceId: z.string().describe("ID of the workspace containing the type (e.g., 'workspace/abc123')"),
-            typeInternalName: z.string().describe("Internal name of the type definition (e.g., 'cf.example.Task') (NOT `typeId` or `typeName`)"),
-            attributeName: z.string().describe("Internal name of the attribute to delete (e.g., 'cf.cplace.myPlugin.myAttribute')")
+            workspaceId: z
+                .string()
+                .describe("ID of the workspace containing the type (e.g., 'workspace/abc123')"),
+            typeInternalName: z
+                .string()
+                .describe("Internal name of the type definition (e.g., 'cf.example.Task') (NOT `typeId` or `typeName`)"),
+            attributeName: z
+                .string()
+                .describe("Internal name of the attribute to delete (e.g., 'cf.cplace.myPlugin.myAttribute')"),
         },
-        annotations: { title: "Delete Attribute Definition" }
-    }
+        annotations: { title: 'Delete Attribute Definition' },
+    },
+    [TOOL_LIST_CUSTOM_CONSTRAINT_TYPES]: {
+        description: "List custom constraint types registered by installed plugins. Returns each constraint's name, allowed multiplicities, and display name. Use the returned names as the 'constraintType' value when creating attributes with cplace_manage_attribute_definition.",
+        inputSchema: {},
+        annotations: { title: 'List Custom Constraint Types' },
+    },
 };
 export function registerTypeManagementTools(server, client) {
     server.registerTool(TOOL_MANAGE_TYPE_DEFINITION, TYPE_MANAGEMENT_TOOL_DEFINITIONS[TOOL_MANAGE_TYPE_DEFINITION], async (params) => {
         try {
-            if (params.operation === "create") {
+            if (params.operation === 'create') {
                 if (!params.workspaceId || !params.typeInternalName) {
                     return {
-                        content: [{ type: "text", text: "Error: Create operation requires workspaceId and typeInternalName parameters" }],
-                        isError: true
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Error: Create operation requires workspaceId and typeInternalName parameters',
+                            },
+                        ],
+                        isError: true,
                     };
                 }
                 debugLogWithTag('TYPE_CREATION', `Creating type definition: ${params.typeInternalName} in workspace: ${params.workspaceId}`);
                 const requestBody = {
                     workspaceId: params.workspaceId,
-                    internalName: params.typeInternalName
+                    internalName: params.typeInternalName,
                 };
                 if (params.localizedNames)
                     requestBody.localizedNames = params.localizedNames;
@@ -124,8 +305,7 @@ export function registerTypeManagementTools(server, client) {
                     requestBody.localizedPlural = params.localizedPlural;
                 if (params.description)
                     requestBody.description = params.description;
-                if (params.showInExplorer !== undefined)
-                    requestBody.showInExplorer = params.showInExplorer;
+                requestBody.showInExplorer = params.showInExplorer ?? false;
                 if (params.readers)
                     requestBody.readers = params.readers;
                 if (params.writers)
@@ -165,20 +345,25 @@ export function registerTypeManagementTools(server, client) {
                 const result = await client.makeApiRequest('json/type-definition', 'POST', undefined, requestBody);
                 debugLogWithTag('TYPE_CREATION', `Successfully created type definition: ${params.typeInternalName}`);
                 return {
-                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                 };
             }
             else {
                 if (!params.workspaceId || !params.typeInternalName) {
                     return {
-                        content: [{ type: "text", text: "Error: Update operation requires workspaceId and typeInternalName parameters" }],
-                        isError: true
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Error: Update operation requires workspaceId and typeInternalName parameters',
+                            },
+                        ],
+                        isError: true,
                     };
                 }
                 debugLogWithTag('TYPE_UPDATE', `Updating type definition: ${params.typeInternalName} in workspace: ${params.workspaceId}`);
                 const requestBody = {
                     workspaceId: params.workspaceId,
-                    typeInternalName: params.typeInternalName
+                    typeInternalName: params.typeInternalName,
                 };
                 if (params.localizedNames)
                     requestBody.localizedNames = params.localizedNames;
@@ -217,54 +402,94 @@ export function registerTypeManagementTools(server, client) {
                 const result = await client.makeApiRequest('json/type-definition', 'PATCH', undefined, requestBody);
                 debugLogWithTag('TYPE_UPDATE', `Successfully updated type definition: ${params.typeInternalName}`);
                 return {
-                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                 };
             }
         }
         catch (error) {
-            const operationText = params.operation === "create" ? "creating" : "updating";
-            debugLogWithTag(params.operation === "create" ? 'TYPE_CREATION' : 'TYPE_UPDATE', `Error ${operationText} type definition: ${error instanceof Error ? error.message : String(error)}`);
+            const operationText = params.operation === 'create' ? 'creating' : 'updating';
+            debugLogWithTag(params.operation === 'create' ? 'TYPE_CREATION' : 'TYPE_UPDATE', `Error ${operationText} type definition: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{
-                        type: "text",
-                        text: `Error ${operationText} type definition: ${error instanceof Error ? error.message : String(error)}`
-                    }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error ${operationText} type definition: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
     server.registerTool(TOOL_MANAGE_ATTRIBUTE_DEFINITION, TYPE_MANAGEMENT_TOOL_DEFINITIONS[TOOL_MANAGE_ATTRIBUTE_DEFINITION], async (params) => {
         try {
-            if (params.operation === "create") {
-                if (!params.workspaceId || !params.typeInternalName || !params.attributeName || !params.constraintConfig) {
+            if (params.operation === 'create') {
+                if (!params.workspaceId ||
+                    !params.typeInternalName ||
+                    !params.attributeName ||
+                    !params.constraintConfig) {
                     return {
-                        content: [{ type: "text", text: "Error: Create operation requires workspaceId, typeInternalName, attributeName, and constraintConfig parameters" }],
-                        isError: true
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Error: Create operation requires workspaceId, typeInternalName, attributeName, and constraintConfig parameters',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                if (params.constraintConfig.additionalConstraintData !== undefined) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Error: additionalConstraintData is not supported for custom constraint types in this version.',
+                            },
+                        ],
+                        isError: true,
                     };
                 }
                 const ct = params.constraintConfig.constraintType;
-                if (ct === "reference") {
-                    const isPersonReference = params.constraintConfig.targetEntityKind === "person";
-                    if (!isPersonReference && (!params.constraintConfig.targetTypeNames || params.constraintConfig.targetTypeNames.length === 0)) {
+                if (ct === 'reference') {
+                    const isPersonReference = params.constraintConfig.targetEntityKind === 'person';
+                    if (!isPersonReference &&
+                        (!params.constraintConfig.targetTypeNames ||
+                            params.constraintConfig.targetTypeNames.length === 0)) {
                         return {
-                            content: [{ type: "text", text: "Error: Reference attributes require 'targetTypeNames' in constraintConfig (e.g., [\"cf.example.targetType\"]). Without it, the attribute defaults to 'any content type'." }],
-                            isError: true
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: "Error: Reference attributes require 'targetTypeNames' in constraintConfig (e.g., [\"cf.example.targetType\"]). Without it, the attribute defaults to 'any content type'.",
+                                },
+                            ],
+                            isError: true,
                         };
                     }
                 }
-                if (ct === "textEnumeration" || ct === "numberEnumeration") {
-                    if (!params.constraintConfig.elements || params.constraintConfig.elements.length === 0) {
+                if (ct === 'textEnumeration' || ct === 'numberEnumeration') {
+                    if (!params.constraintConfig.elements ||
+                        params.constraintConfig.elements.length === 0) {
                         return {
-                            content: [{ type: "text", text: "Error: Enumeration attributes require 'elements' in constraintConfig with at least one element." }],
-                            isError: true
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: "Error: Enumeration attributes require 'elements' in constraintConfig with at least one element.",
+                                },
+                            ],
+                            isError: true,
                         };
                     }
                 }
-                if (ct === "linkedAttribute") {
-                    if (!params.constraintConfig.linkedReferenceName || !params.constraintConfig.linkedPropertyName) {
+                if (ct === 'linkedAttribute') {
+                    if (!params.constraintConfig.linkedReferenceName ||
+                        !params.constraintConfig.linkedPropertyName) {
                         return {
-                            content: [{ type: "text", text: "Error: Linked attributes require both 'linkedReferenceName' and 'linkedPropertyName' in constraintConfig." }],
-                            isError: true
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: "Error: Linked attributes require both 'linkedReferenceName' and 'linkedPropertyName' in constraintConfig.",
+                                },
+                            ],
+                            isError: true,
                         };
                     }
                 }
@@ -273,7 +498,7 @@ export function registerTypeManagementTools(server, client) {
                     workspaceId: params.workspaceId,
                     typeDefinitionInternalName: params.typeInternalName,
                     attributeName: params.attributeName,
-                    constraintConfig: params.constraintConfig
+                    constraintConfig: params.constraintConfig,
                 };
                 if (params.multiplicity)
                     requestBody.multiplicity = params.multiplicity;
@@ -298,21 +523,38 @@ export function registerTypeManagementTools(server, client) {
                 const result = await client.makeApiRequest('json/attribute-definition', 'POST', undefined, requestBody);
                 debugLogWithTag('ATTRIBUTE_CREATION', `Successfully created attribute: ${params.attributeName}`);
                 return {
-                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                 };
             }
             else {
                 if (!params.workspaceId || !params.typeInternalName || !params.attributeName) {
                     return {
-                        content: [{ type: "text", text: "Error: Update operation requires workspaceId, typeInternalName and attributeName parameters" }],
-                        isError: true
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Error: Update operation requires workspaceId, typeInternalName and attributeName parameters',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                if (params.constraintConfig &&
+                    params.constraintConfig.additionalConstraintData !== undefined) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Error: additionalConstraintData is not supported for custom constraint types in this version.',
+                            },
+                        ],
+                        isError: true,
                     };
                 }
                 debugLogWithTag('ATTRIBUTE_UPDATE', `Updating attribute: ${params.attributeName} for type: ${params.typeInternalName} in workspace: ${params.workspaceId}`);
                 const requestBody = {
                     workspaceId: params.workspaceId,
                     typeDefinitionInternalName: params.typeInternalName,
-                    attributeName: params.attributeName
+                    attributeName: params.attributeName,
                 };
                 if (params.multiplicity)
                     requestBody.multiplicity = params.multiplicity;
@@ -339,19 +581,39 @@ export function registerTypeManagementTools(server, client) {
                 const result = await client.makeApiRequest('json/attribute-definition', 'PATCH', undefined, requestBody);
                 debugLogWithTag('ATTRIBUTE_UPDATE', `Successfully updated attribute: ${params.attributeName}`);
                 return {
-                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                 };
             }
         }
         catch (error) {
-            const operationText = params.operation === "create" ? "creating" : "updating";
-            debugLogWithTag(params.operation === "create" ? 'ATTRIBUTE_CREATION' : 'ATTRIBUTE_UPDATE', `Error ${operationText} attribute: ${error instanceof Error ? error.message : String(error)}`);
+            const operationText = params.operation === 'create' ? 'creating' : 'updating';
+            debugLogWithTag(params.operation === 'create' ? 'ATTRIBUTE_CREATION' : 'ATTRIBUTE_UPDATE', `Error ${operationText} attribute: ${error instanceof Error ? error.message : String(error)}`);
+            const rawText = `Error ${operationText} attribute definition: ${error instanceof Error ? error.message : String(error)}`;
             return {
-                content: [{
-                        type: "text",
-                        text: `Error ${operationText} attribute definition: ${error instanceof Error ? error.message : String(error)}`
-                    }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: appendCustomConstraintHintIfNeeded(rawText),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool(TOOL_LIST_CUSTOM_CONSTRAINT_TYPES, TYPE_MANAGEMENT_TOOL_DEFINITIONS[TOOL_LIST_CUSTOM_CONSTRAINT_TYPES], async () => {
+        try {
+            const result = await client.makeApiRequest('json/custom-constraint-types', 'GET');
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing custom constraint types: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -360,17 +622,22 @@ export function registerTypeManagementTools(server, client) {
         try {
             const result = await client.makeApiRequest('json/type-definition', 'DELETE', {
                 workspaceId,
-                typeDefinitionInternalName: typeInternalName
+                typeDefinitionInternalName: typeInternalName,
             });
             debugLogWithTag('TYPE_DELETE', `Successfully deleted type definition '${typeInternalName}'`);
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `Error deleting type definition: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error deleting type definition: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -380,17 +647,22 @@ export function registerTypeManagementTools(server, client) {
             const result = await client.makeApiRequest('json/attribute-definition', 'DELETE', {
                 workspaceId,
                 typeDefinitionInternalName: typeInternalName,
-                attributeName
+                attributeName,
             });
             debugLogWithTag('ATTRIBUTE_DELETE', `Successfully deleted attribute '${attributeName}'`);
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `Error deleting attribute definition: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error deleting attribute definition: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });