@centrali-io/centrali-mcp 4.2.13 → 4.2.14

package/dist/tools/describe.js

@@ -1208,13 +1208,16 @@ function registerDescribeTools(server) {
                                 fields: "FormFieldDef[] — array of field definitions directly on the block object",
                                 field_shape: {
                                     key: "string — maps to the record's data field name",
-                                    label: "string — display label",
-                                    type: "'text' | 'number' | 'email' | 'date' | 'boolean' | 'select' | 'textarea'",
-                                    required: "boolean (default: false)",
+                                    label: "string — display label (unused for hidden fields)",
+                                    type: "'text' | 'number' | 'email' | 'date' | 'boolean' | 'select' | 'textarea' | 'hidden'",
+                                    required: "boolean (default: false) — ignored for hidden fields",
                                     placeholder: "string | null",
+                                    defaultValue: "string | number | boolean | { source: 'auth' | 'system', field: string } — static value or derived default. For hidden fields, this is the value injected at submit time. For visible fields, this pre-populates the input. Derived sources: auth.userId, auth.email, auth.name (from logged-in user), system.now (server timestamp). Derived defaults are resolved server-side.",
+                                    resolveErrorMessage: "string | null — custom error message shown when a derived defaultValue cannot be resolved (e.g. user not signed in). Defaults to 'This form requires you to be signed in' for auth source.",
                                     options: "For 'select' type: { label: string, value: string }[] — inline static options",
                                     optionSource: "For 'select' type (alternative): { type: 'static' | 'dynamic', staticOptions?: [{label, value}], dynamicRef?: 'collection-uuid', labelField?, valueField? }",
                                 },
+                                HIDDEN_FIELDS: "Fields with type 'hidden' are NOT rendered to end users but their defaultValue is included in the form submission payload. Use for auto-populated values like status, provider, userId, timestamps. Static defaults are injected directly; derived defaults (auth/system) are resolved securely on the server.",
                                 allowed_actions: ["create-record", "update-record", "invoke-trigger"],
                                 default_activation: "form-submit",
                                 param_source: "form",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@centrali-io/centrali-mcp",
-  "version": "4.2.13",
+  "version": "4.2.14",
   "description": "Centrali MCP Server - AI assistant integration for Centrali workspaces",
   "main": "dist/index.js",
   "type": "commonjs",

package/src/tools/describe.ts

@@ -1405,13 +1405,16 @@ export function registerDescribeTools(server: McpServer) {
                   fields: "FormFieldDef[] — array of field definitions directly on the block object",
                   field_shape: {
                     key: "string — maps to the record's data field name",
-                    label: "string — display label",
-                    type: "'text' | 'number' | 'email' | 'date' | 'boolean' | 'select' | 'textarea'",
-                    required: "boolean (default: false)",
+                    label: "string — display label (unused for hidden fields)",
+                    type: "'text' | 'number' | 'email' | 'date' | 'boolean' | 'select' | 'textarea' | 'hidden'",
+                    required: "boolean (default: false) — ignored for hidden fields",
                     placeholder: "string | null",
+                    defaultValue: "string | number | boolean | { source: 'auth' | 'system', field: string } — static value or derived default. For hidden fields, this is the value injected at submit time. For visible fields, this pre-populates the input. Derived sources: auth.userId, auth.email, auth.name (from logged-in user), system.now (server timestamp). Derived defaults are resolved server-side.",
+                    resolveErrorMessage: "string | null — custom error message shown when a derived defaultValue cannot be resolved (e.g. user not signed in). Defaults to 'This form requires you to be signed in' for auth source.",
                     options: "For 'select' type: { label: string, value: string }[] — inline static options",
                     optionSource: "For 'select' type (alternative): { type: 'static' | 'dynamic', staticOptions?: [{label, value}], dynamicRef?: 'collection-uuid', labelField?, valueField? }",
                   },
+                  HIDDEN_FIELDS: "Fields with type 'hidden' are NOT rendered to end users but their defaultValue is included in the form submission payload. Use for auto-populated values like status, provider, userId, timestamps. Static defaults are injected directly; derived defaults (auth/system) are resolved securely on the server.",
                   allowed_actions: ["create-record", "update-record", "invoke-trigger"],
                   default_activation: "form-submit",
                   param_source: "form",