@cplace/mcp-server 1.12.4 → 1.13.1

package/dist/plugins/core/widget-specifications/cf.cplace.layoutTabsWidget.widget/_overview.md

@@ -1,8 +1,8 @@
 ## Overview
 
-Enables you to organize different layout alternatives of a type in tabs.
+Organize a type's alternative layouts as tabs.
 
-The Alternative Layouts as Tabs widget can be used to display alternative layouts of the current type or page in the form of tabs on a cplace page. This allows widgets and information contained on a page to be structured and arranged in a meaningful manner.
+The Alternative Layouts as Tabs widget displays a type's alternative layouts as tabs on a cplace page, so widgets and information on the page can be structured and arranged in a meaningful manner. Alternative layouts are **type-scoped**: every tab is a layout defined on the page's type and shared by all pages of that type. The widget cannot scope a tab set to a single page on a shared type — in script mode it filters which of the type's layouts show per page, but it cannot create a per-page-unique tab set. A surface that needs its own view switcher needs its own type.
 
 ## Use Cases
 

package/dist/plugins/core/widget-specifications/cf.cplace.layoutTabsWidget.widget/_summary.md

@@ -1 +1 @@
-Enables you to organize different layout alternatives of a type in tabs, allowing users to switch between different layout views of the same page.
+Organizes a type's alternative layouts as tabs, letting users switch between layout views of the same page. Tabs are type-scoped: every tab is an alternative layout defined on the page's type and shared by all pages of that type — the widget cannot create a per-page-unique tab set on a shared type.

package/dist/plugins/core/widget-specifications/cf.cplace.platform.tableWidget/_implementation.md

@@ -8,4 +8,5 @@
 1. Configure `search` (and optionally `connectedWidgetId` for master-detail)
 2. Define visible columns via `columns` attribute
 3. Optionally configure sorting (`multiSortColumns`), filtering (`filters`), and grouping (`groupColumn`)
+   - `groupColumn` takes a single attribute-name string; custom names are single-quoted like `columns`, with an optional `groupOrder` (`asc`/`desc`). Single grouping is live-verified (validates and renders). Multi-level grouping via `enableMultiGrouping` + `multiGroupColumns` exists on current cplace (absent in 25.3/25.4). See the `groupColumn` attribute spec.
 4. Configure display options via `displayOptions` multi-enum (always include `showLinksInNameColumn` unless explicitly told otherwise)

package/dist/plugins/core/widget-specifications/cf.cplace.platform.tableWidget/_overview.md

@@ -4,7 +4,7 @@ Displays a list of search results.
 
 The Table Widget is a next-generation table implementation that presents search results in a tabular format with modern web component architecture. It serves as both a primary data display component and a powerful data producer for connected widgets, supporting advanced features like multi-column sorting, dynamic filtering, and customizable column configurations.
 
-**Status**: Beta (requires feature flag `newTableEnabled`)
+**Status**: Preferred table widget for new implementations. Marked `@Beta` in the platform API (the interface may still evolve), but it does **not** require a runtime feature flag.
 
 ## Key Capabilities
 
@@ -101,7 +101,6 @@ The Table Widget is a next-generation table implementation that presents search
 
 Use the Table Widget when:
 - You need a modern, feature-rich table implementation
-- The `newTableEnabled` feature flag is active in your environment
 - You're building new pages requiring table functionality
 - You need master-detail patterns with connected widgets
 - You want to provide search results to multiple visualization widgets
@@ -109,7 +108,6 @@ Use the Table Widget when:
 ### Prerequisites and Dependencies
 
 **Required**:
-- Feature flag `newTableEnabled` must be active
 - Valid search definition in configuration
 - Widget must be embedded in a page
 
@@ -122,8 +120,6 @@ Use the Table Widget when:
 
 The widget is marked with `@Beta` annotation, indicating:
 - API may undergo changes in future releases
-- Feature flag controls availability in production
-- Monitor feature flag status in target environments
 - Consider migration planning if replacing legacy table widgets
 
 ## Common Patterns
@@ -164,20 +160,17 @@ Parent-child table relationship:
 **Table Widget advantages**:
 - Modern web component architecture (vs. legacy AngularJS)
 - Cleaner producer interface implementation
-- Feature-flagged for controlled rollout
 - Better separation of concerns in state management
 
 **When to use Table Widget**:
 - New implementations on modern infrastructure
-- When `newTableEnabled` feature flag is active
 - For new pages requiring table functionality
 
 **When to use Embedded Search as Table**:
 - Legacy pages still on AngularJS
-- When `newTableEnabled` feature flag is not active
 - Existing implementations that don't need migration
 
-The Table Widget is the preferred choice for new implementations. Embedded Search as Table is the legacy version — use it only when `newTableEnabled` is not available or for maintaining existing implementations.
+The Table Widget is the preferred choice for new implementations. Embedded Search as Table is the legacy version — use it only for maintaining existing implementations.
 
 ## Related Widgets
 

package/dist/plugins/core/widget-specifications/cf.cplace.platform.tableWidget/columns.md

@@ -13,6 +13,7 @@
 **Important**:
 - **Custom attributes** require single quotes around the attribute name: `"'cf.cplace.myType.attributeName'"`
 - **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `"name"`
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 - The pseudo-column **`_name_`** renders the page's display name with navigation link and is distinct from the builtin `name` attribute.
 
 **Note**: Order in array determines column display order. Hidden columns (`visible: false`) can still be used for sorting/filtering.

package/dist/plugins/core/widget-specifications/cf.cplace.platform.tableWidget/groupColumn.md

@@ -0,0 +1,13 @@
+**Groups table rows by the value of a single attribute.**
+
+**Format**: a single attribute-name string (not an array), plus an optional `groupOrder`.
+- **Custom attributes** require single quotes around the attribute name: `"'cf.cplace.myType.attributeName'"`
+- **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `"name"`
+- **`groupOrder`**: `"asc"` or `"desc"`.
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so the single-quoted token needs no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
+
+Live-verified on a current-version instance: the apostrophe-wrapped custom token validates (`VALID_COMPLETE`), is stored byte-for-byte, and renders visible grouping (rows grouped under "Status: Draft" / "Status: Active"). The **bare** custom name (no apostrophes) is rejected with `VALIDATION_ERROR` "Invalid Value" — the apostrophes are the discriminator. Read-back returns the stored value in the `\'`-escaped single-quoted form.
+
+**Precondition — the attribute must be in the widget's `search`**: `groupColumn`'s legal options are computed live from the widget's `search`; the search's result type(s) must expose the attribute for it to appear in the enumeration. **If a correctly-quoted token still errors, check `search` first** — do not re-try quoting variants. (Reported edge, not re-verified live: if the `search` JSON is malformed, the option set collapses to a single `name`, so only `groupColumn: "name"` validates until `search` is fixed.)
+
+**Multi-level grouping (current cplace)**: `enableMultiGrouping: true` + `multiGroupColumns` is the multi-level grouping path on current cplace. Both are **declared** attributes of the current tableWidget definition (confirm via `cplace_get_widget_definition`). They are **absent in 25.3/25.4** — on an older instance `groupColumn` is the only grouping path. The exact `multiGroupColumns` JSON is version-dependent; obtain it by configuring multi-grouping once in the UI, then reading it back via `cplace_get_layout_script`, rather than hand-authoring a literal.

package/dist/plugins/core/widget-specifications/cf.cplace.platform.tableWidget/multiSortColumns.md

@@ -12,5 +12,6 @@
 **Important**:
 - **Custom attributes** require single quotes around the attribute name: `"'cf.cplace.myType.attributeName'"`
 - **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `"name"`
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 
 **Note**: `sortingPriorityIndex` determines which sort applies first (lower = higher priority).

package/dist/plugins/core/widget-specifications/cf.cplace.tableDetailViewWidget.widget/attributes.md

@@ -3,5 +3,6 @@
 **Value Format**:
 - **Custom attributes**: Use fully qualified names like `'cf.cplace.solution.taskTitle'`
 - **Built-in attributes**: Use simple feature names like `name`, `creator`, `created`
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 
 **Note**: The enumeration provider dynamically populates available attributes based on the connected table widget's type. Only attributes from the table's result type are selectable.

package/dist/plugins/core/widget-specifications/cf.platform.connectedBarChart/attributeName.md

@@ -3,6 +3,7 @@
 **Important**:
 - **Custom attributes** require single quotes around the attribute name: `'cf.cplace.myApp.myAttribute'`
 - **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `name`
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 
 **Validation**: Before setting this attribute, verify that the attribute actually exists on the type returned by the data source (connected table or standalone search). Using a non-existent attribute will result in an empty or broken chart.
 

package/dist/plugins/core/widget-specifications/cf.platform.connectedMatrix/attributeXName.md

@@ -4,5 +4,6 @@
 - **Custom attributes** require single quotes around the attribute name inside the string value: `"'cf.cplace.myApp.myAttribute'"`
 - **Builtin attributes** (e.g., `name`, `createdAt`) are specified without inner quotes: `"name"`
 - Without inner quotes, the widget silently fails and shows "Please complete the widget configuration"
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 
 **Validation**: Before setting this attribute, verify it exists on the type returned by the connected table's search. Using a non-existent or incorrectly quoted attribute results in a broken widget with no useful error message.

package/dist/plugins/core/widget-specifications/cf.platform.connectedMatrix/attributeYName.md

@@ -4,5 +4,6 @@
 - **Custom attributes** require single quotes around the attribute name inside the string value: `"'cf.cplace.myApp.myAttribute'"`
 - **Builtin attributes** (e.g., `name`, `createdAt`) are specified without inner quotes: `"name"`
 - Without inner quotes, the widget silently fails and shows "Please complete the widget configuration"
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 
 **Validation**: Before setting this attribute, verify it exists on the type returned by the connected table's search. Using a non-existent or incorrectly quoted attribute results in a broken widget with no useful error message.

package/dist/plugins/core/widget-specifications/cf.platform.connectedPieChart/attributeName.md

@@ -3,6 +3,7 @@
 **Important**:
 - **Custom attributes** require single quotes around the attribute name: `'cf.cplace.myApp.myAttribute'`
 - **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `name`
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 
 **Validation**: Before setting this attribute, verify that the attribute actually exists on the type returned by the data source (connected table or standalone search). Using a non-existent attribute will result in an empty or broken chart.
 

package/dist/plugins/core/widget-specifications/cf.platform.connectedSingleAttribute/_implementation.md

@@ -5,7 +5,7 @@
 
 **Typical Configuration Workflow**:
 1. Set `singleSelectionWidgetId` to the table/selection widget that provides entity selection
-   - Use `"<empty>"` when embedded inside a `cf.platform.connectedAttributesGroup` widget
+   - Omit entirely when embedded inside a `cf.platform.connectedAttributesGroup` widget (the parent provides the connection)
 2. Set `attributeName`
 3. Configure display options:
    - `withValue` and `withLabel` (at least one must be true)

package/dist/plugins/core/widget-specifications/cf.platform.connectedSingleAttribute/attributeName.md

@@ -3,6 +3,7 @@
 **Important**:
 - **Custom attributes** require single quotes around the attribute name: `'cf.cplace.myApp.myAttribute'`
 - **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `name`
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 
 **Workflow**:
 1. Call `cplace_get_type_datamodel` for the type displayed in the connected table

package/dist/plugins/core/widget-specifications/cf.platform.connectedSingleAttribute/singleSelectionWidgetId.md

@@ -1,3 +1,3 @@
 **Valid Values**:
-- When embedded inside a `cf.cplace.platform.connectedAttributesGroup` widget, use `"<empty>"` as the value - the parent widget provides the actual table connection
+- When embedded inside a `cf.cplace.platform.connectedAttributesGroup` widget, omit this key entirely (or leave it empty) - the parent widget provides the actual table connection. Passing a value here causes a validation error.
 - When the connection goes against a `cf.platform.treeTable` widget - insert the widget ID

package/dist/plugins/core/widget-specifications/cf.platform.embeddedSearchAsTable/columns.md

@@ -12,5 +12,6 @@
 **Important**:
 - **Custom attributes** require single quotes around the attribute name: `"'cf.cplace.myType.attributeName'"`
 - **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `"name"`
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 
 **Note**: Order in array determines column display order. Hidden columns (`visible: false`) can still be used for sorting/filtering.

package/dist/plugins/core/widget-specifications/cf.platform.embeddedSearchAsTable/multiSortColumns.md

@@ -12,5 +12,6 @@
 **Important**:
 - **Custom attributes** require single quotes around the attribute name: `"'cf.cplace.myType.attributeName'"`
 - **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `"name"`
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 
 **Note**: `sortingPriorityIndex` determines which sort applies first (lower = higher priority).

package/dist/plugins/core/widget-specifications/cf.platform.singleAttribute/_implementation.md

@@ -5,7 +5,7 @@
 **Typical Configuration Workflow**:
 1. Set `entity` to the page whose attribute should be displayed
    - Leave empty for current page
-   - Use `"<empty>"` when embedded inside a `cf.platform.attributesGroup` widget
+   - Omit entirely when embedded inside a `cf.platform.attributesGroup` widget (the parent provides the entity)
 2. Set `quotedAttributeName` to the attribute to display
 3. Configure display options:
    - `withValue` and `withLabel` (at least one must be true)

package/dist/plugins/core/widget-specifications/cf.platform.singleAttribute/cf.platform.entity.md

@@ -3,8 +3,7 @@
 **Valid Values**:
 - Empty/null: Use the current (embedding) page
 - Page UID: Reference to a specific page whose attribute should be displayed
-- `"<empty>"`: Special value when embedded inside a `cf.platform.attributesGroup` widget
 
-**Warning**: When embedded inside a `cf.platform.attributesGroup` widget, leave this empty or use `"<empty>"` - the parent widget provides the target entity.
+**Warning**: When embedded inside a `cf.platform.attributesGroup` widget, omit this key entirely (or leave it empty) - the parent widget provides the target entity. Passing a value here causes a validation error.
 
 **Note**: This parameter is hidden from the edit UI when the widget is embedded inside `cf.platform.attributesGroup`.

package/dist/plugins/core/widget-specifications/cf.platform.singleAttribute/cf.platform.quotedAttributeName.md

@@ -3,6 +3,7 @@
 **Important**:
 - **Custom attributes** require single quotes around the attribute name: `'cf.cplace.myApp.myAttribute'`
 - **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`, `_writers`) are specified without quotes: `name`
+- **Inside a `layout.define` string**: wrap the config value in a **double-quoted** outer JS string so these single-quoted tokens need no escaping — see the `cplace_execute_layout_script` tool description (quoting/escaping note). Never wrap it in a single-quoted string with unescaped inner `'` (throws `SyntaxError`).
 
 **Workflow**:
 1. Call `cplace_get_type_datamodel` for the type of the target page

package/dist/plugins/layouts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layouts.d.ts","sourceRoot":"","sources":["../../src/plugins/layouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAoBpD,eAAO,MAAM,aAAa,EAAE,SAuB3B,CAAC"}
+{"version":3,"file":"layouts.d.ts","sourceRoot":"","sources":["../../src/plugins/layouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAwBpD,eAAO,MAAM,aAAa,EAAE,SA2B3B,CAAC"}

package/dist/plugins/layouts.js

@@ -5,6 +5,7 @@ import { registerRichStringWidgetTools, RICHSTRING_WIDGET_TOOL_DEFINITIONS, } fr
 import { registerLayoutRichStringWidgetTools, LAYOUT_RICHSTRING_WIDGET_TOOL_DEFINITIONS, } from '../tools/layout-richstring-widgets.js';
 import { registerBoardWidgetTools, BOARD_TOOL_DEFINITIONS } from '../tools/board-widget.js';
 import { registerLayoutTools, LAYOUT_TOOL_DEFINITIONS } from '../tools/layout.js';
+import { registerEmbeddedWidgetLayoutTools, EMBEDDED_WIDGET_LAYOUT_TOOL_DEFINITIONS, } from '../tools/embedded-widget-layout.js';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
 const __filename = fileURLToPath(import.meta.url);
@@ -30,6 +31,10 @@ export const layoutsPlugin = {
         },
         'board-widget': { register: registerBoardWidgetTools, toolDefinitions: BOARD_TOOL_DEFINITIONS },
         layout: { register: registerLayoutTools, toolDefinitions: LAYOUT_TOOL_DEFINITIONS },
+        'embedded-widget-layout': {
+            register: registerEmbeddedWidgetLayoutTools,
+            toolDefinitions: EMBEDDED_WIDGET_LAYOUT_TOOL_DEFINITIONS,
+        },
     },
 };
 //# sourceMappingURL=layouts.js.map

package/dist/plugins/layouts.js.map

@@ -1 +1 @@
-{"version":3,"file":"layouts.js","sourceRoot":"","sources":["../../src/plugins/layouts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,mCAAmC,EACnC,yCAAyC,GAC1C,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,cAAc;IACvB,WAAW,EACT,oIAAoI;IACtI,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE;QACP,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,eAAe,EAAE,uBAAuB,EAAE;QACzE,cAAc,EAAE;YACd,QAAQ,EAAE,uBAAuB;YACjC,eAAe,EAAE,4BAA4B;SAC9C;QACD,oBAAoB,EAAE;YACpB,QAAQ,EAAE,6BAA6B;YACvC,eAAe,EAAE,kCAAkC;SACpD;QACD,2BAA2B,EAAE;YAC3B,QAAQ,EAAE,mCAAmC;YAC7C,eAAe,EAAE,yCAAyC;SAC3D;QACD,cAAc,EAAE,EAAE,QAAQ,EAAE,wBAAwB,EAAE,eAAe,EAAE,sBAAsB,EAAE;QAC/F,MAAM,EAAE,EAAE,QAAQ,EAAE,mBAAmB,EAAE,eAAe,EAAE,uBAAuB,EAAE;KACpF;CACF,CAAC"}
+{"version":3,"file":"layouts.js","sourceRoot":"","sources":["../../src/plugins/layouts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,mCAAmC,EACnC,yCAAyC,GAC1C,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EACL,iCAAiC,EACjC,uCAAuC,GACxC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,cAAc;IACvB,WAAW,EACT,oIAAoI;IACtI,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE;QACP,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,eAAe,EAAE,uBAAuB,EAAE;QACzE,cAAc,EAAE;YACd,QAAQ,EAAE,uBAAuB;YACjC,eAAe,EAAE,4BAA4B;SAC9C;QACD,oBAAoB,EAAE;YACpB,QAAQ,EAAE,6BAA6B;YACvC,eAAe,EAAE,kCAAkC;SACpD;QACD,2BAA2B,EAAE;YAC3B,QAAQ,EAAE,mCAAmC;YAC7C,eAAe,EAAE,yCAAyC;SAC3D;QACD,cAAc,EAAE,EAAE,QAAQ,EAAE,wBAAwB,EAAE,eAAe,EAAE,sBAAsB,EAAE;QAC/F,MAAM,EAAE,EAAE,QAAQ,EAAE,mBAAmB,EAAE,eAAe,EAAE,uBAAuB,EAAE;QACnF,wBAAwB,EAAE;YACxB,QAAQ,EAAE,iCAAiC;YAC3C,eAAe,EAAE,uCAAuC;SACzD;KACF;CACF,CAAC"}

package/dist/tools/embedded-widget-layout.d.ts

@@ -0,0 +1,99 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { CplaceApiClient } from '../api.js';
+export declare const EMBEDDED_WIDGET_LAYOUT_TOOL_DEFINITIONS: {
+    readonly cplace_add_widget_to_embedded_layout: {
+        readonly description: "Add a single child widget into a container widget's embedded layout (e.g. a \"Grouped Attributes\" widget: cf.cplace.platform.attributesGroup or cf.cplace.platform.connectedAttributesGroup), in place, and return the new widget's server-assigned id.\n\nUse this to add ONE embedded child without rebuilding the whole container. Unlike cplace_edit_layout (which regenerates EVERY widget id), this preserves the ids of all other widgets.\n\nWorks on both page and type layouts (set via context). Placement is index-based: rowIndex/columnIndex/widgetIndex. There is no before/after-widget placement. A non-existing rowIndex appends a new full-width row; a non-existing columnIndex adds to the last existing column.\n\nDISCOVERY: find the container widget id with cplace_get_layout_widget_details; verify the child widgetType and its config attribute names with cplace_get_widget_definition.\n\nReturns newWidgetId — use it to configure or cross-reference the widget you just added.";
+        readonly inputSchema: {
+            readonly context: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"page">;
+                pageUID: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "page";
+                pageUID: string;
+            }, {
+                type: "page";
+                pageUID: string;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                workspaceId: z.ZodString;
+                typeInternalName: z.ZodString;
+                alternativeLayoutName: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }>]>, {
+                type: "page";
+                pageUID: string;
+            } | {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }, unknown>;
+            readonly containerWidgetId: z.ZodString;
+            readonly layoutAttributeName: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            readonly widgetType: z.ZodString;
+            readonly rowIndex: z.ZodEffects<z.ZodNumber, number, unknown>;
+            readonly columnIndex: z.ZodEffects<z.ZodNumber, number, unknown>;
+            readonly widgetIndex: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, unknown>>;
+            readonly configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        };
+        readonly annotations: {
+            readonly title: "Add Widget to Embedded Layout";
+        };
+    };
+    readonly cplace_remove_widget_from_embedded_layout: {
+        readonly description: "Remove a single child widget from a container widget's embedded layout (e.g. a \"Grouped Attributes\" widget: cf.cplace.platform.attributesGroup or cf.cplace.platform.connectedAttributesGroup), by widget id, in place.\n\nUse this to delete ONE embedded child without rebuilding the whole container. Unlike cplace_edit_layout (which round-trips through layout.define and regenerates EVERY widget id), this preserves the ids of all other widgets — the safe choice when embedded widgets are cross-referenced.\n\nWorks on both page and type layouts (set via context).\n\nDISCOVERY: find the container widget id and its embedded children with cplace_get_layout_widget_details. layoutAttributeName defaults to the standard grouped-attributes key; look it up with cplace_get_widget_definition only for other container kinds.\n\nIf the widget id is not present in the container, the call fails with a clear error (it does NOT silently succeed).";
+        readonly inputSchema: {
+            readonly context: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"page">;
+                pageUID: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "page";
+                pageUID: string;
+            }, {
+                type: "page";
+                pageUID: string;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                workspaceId: z.ZodString;
+                typeInternalName: z.ZodString;
+                alternativeLayoutName: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }>]>, {
+                type: "page";
+                pageUID: string;
+            } | {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }, unknown>;
+            readonly containerWidgetId: z.ZodString;
+            readonly layoutAttributeName: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            readonly widgetId: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Remove Widget from Embedded Layout";
+        };
+    };
+};
+export declare function registerEmbeddedWidgetLayoutTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=embedded-widget-layout.d.ts.map

package/dist/tools/embedded-widget-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-widget-layout.d.ts","sourceRoot":"","sources":["../../src/tools/embedded-widget-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA8C5C,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgF1C,CAAC;AAEX,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAqN3F"}

package/dist/tools/embedded-widget-layout.js

@@ -0,0 +1,249 @@
+import { z } from 'zod';
+import { debugLogWithTag } from '../logger.js';
+import { checkResponseSize } from '../utils.js';
+import { LayoutContextSchema } from './layout.js';
+import { buildRequestParams } from './widget-tool-helpers.js';
+import { coerceNumber, unwrapSingleElementArrays } from './common-schemas.js';
+const TOOL_ADD_EMBEDDED_WIDGET = 'cplace_add_widget_to_embedded_layout';
+const TOOL_REMOVE_EMBEDDED_WIDGET = 'cplace_remove_widget_from_embedded_layout';
+const DEFAULT_LAYOUT_ATTRIBUTE_NAME = 'cf.cplace.platform.attributesGroup.layout';
+const DEBUG_TAG = 'EMBEDDED_WIDGET_LAYOUT';
+function determineEmbeddedEndpoint(context) {
+    return context.type === 'page'
+        ? 'json/page/embeddedWidgetLayout'
+        : 'json/type/embeddedWidgetLayout';
+}
+function buildEmbeddedRequestParams(context, containerWidgetId, layoutAttributeName) {
+    return { ...buildRequestParams(context), containerWidgetId, layoutAttributeName };
+}
+async function readEmbeddedLayout(client, context, containerWidgetId, layoutAttributeName) {
+    const endpoint = determineEmbeddedEndpoint(context);
+    const params = buildEmbeddedRequestParams(context, containerWidgetId, layoutAttributeName);
+    return await client.makeApiRequest(endpoint, 'GET', params);
+}
+function extractEmbeddedWidgetIds(embeddedLayout) {
+    const widgets = embeddedLayout?.widgets;
+    if (!Array.isArray(widgets))
+        return [];
+    return widgets.map((w) => w?.id).filter((id) => typeof id === 'string');
+}
+export const EMBEDDED_WIDGET_LAYOUT_TOOL_DEFINITIONS = {
+    [TOOL_ADD_EMBEDDED_WIDGET]: {
+        description: `Add a single child widget into a container widget's embedded layout (e.g. a "Grouped Attributes" widget: cf.cplace.platform.attributesGroup or cf.cplace.platform.connectedAttributesGroup), in place, and return the new widget's server-assigned id.
+
+Use this to add ONE embedded child without rebuilding the whole container. Unlike cplace_edit_layout (which regenerates EVERY widget id), this preserves the ids of all other widgets.
+
+Works on both page and type layouts (set via context). Placement is index-based: rowIndex/columnIndex/widgetIndex. There is no before/after-widget placement. A non-existing rowIndex appends a new full-width row; a non-existing columnIndex adds to the last existing column.
+
+DISCOVERY: find the container widget id with cplace_get_layout_widget_details; verify the child widgetType and its config attribute names with cplace_get_widget_definition.
+
+Returns newWidgetId — use it to configure or cross-reference the widget you just added.`,
+        inputSchema: {
+            context: LayoutContextSchema,
+            containerWidgetId: z
+                .string()
+                .describe('The id of the container widget to add the child into (find via cplace_get_layout_widget_details)'),
+            layoutAttributeName: z
+                .string()
+                .optional()
+                .default(DEFAULT_LAYOUT_ATTRIBUTE_NAME)
+                .describe(`The container's embedded-layout attribute key. Defaults to '${DEFAULT_LAYOUT_ATTRIBUTE_NAME}' (correct for both attributesGroup and connectedAttributesGroup). Override only for other container kinds — look up via cplace_get_widget_definition.`),
+            widgetType: z
+                .string()
+                .describe("The widget type of the new child (e.g. 'cf.platform.attributes'). Verify embeddability with cplace_get_widget_definition."),
+            rowIndex: coerceNumber(z.number()).describe('Target row index (0-based). A non-existing index appends a new full-width row.'),
+            columnIndex: coerceNumber(z.number()).describe('Target column index within the row (0-based). A non-existing index adds to the last existing column.'),
+            widgetIndex: coerceNumber(z.number())
+                .optional()
+                .describe('Insertion index within the column (0-based, default 0). -1 appends.'),
+            configuration: z
+                .record(z.any())
+                .optional()
+                .describe(`Optional widget configuration as attribute-name → value pairs (same convention as layout.define config). Verify attribute names with cplace_get_widget_definition — some are fully qualified. Localized strings use locale maps: { en: "Title", de: "Titel" }. Omit 'cf.platform.entity' (it defaults to the current context).`),
+        },
+        annotations: { title: 'Add Widget to Embedded Layout' },
+    },
+    [TOOL_REMOVE_EMBEDDED_WIDGET]: {
+        description: `Remove a single child widget from a container widget's embedded layout (e.g. a "Grouped Attributes" widget: cf.cplace.platform.attributesGroup or cf.cplace.platform.connectedAttributesGroup), by widget id, in place.
+
+Use this to delete ONE embedded child without rebuilding the whole container. Unlike cplace_edit_layout (which round-trips through layout.define and regenerates EVERY widget id), this preserves the ids of all other widgets — the safe choice when embedded widgets are cross-referenced.
+
+Works on both page and type layouts (set via context).
+
+DISCOVERY: find the container widget id and its embedded children with cplace_get_layout_widget_details. layoutAttributeName defaults to the standard grouped-attributes key; look it up with cplace_get_widget_definition only for other container kinds.
+
+If the widget id is not present in the container, the call fails with a clear error (it does NOT silently succeed).`,
+        inputSchema: {
+            context: LayoutContextSchema,
+            containerWidgetId: z
+                .string()
+                .describe("The id of the container widget whose embedded layout holds the child (find via cplace_get_layout_widget_details, e.g. '_a1b2c3')"),
+            layoutAttributeName: z
+                .string()
+                .optional()
+                .default(DEFAULT_LAYOUT_ATTRIBUTE_NAME)
+                .describe(`The container's embedded-layout attribute key. Defaults to '${DEFAULT_LAYOUT_ATTRIBUTE_NAME}', which is correct for both cf.cplace.platform.attributesGroup and cf.cplace.platform.connectedAttributesGroup. Override only for other container kinds — look up the key via cplace_get_widget_definition.`),
+            widgetId: z
+                .string()
+                .describe('The id of the embedded child widget to remove (find via cplace_get_layout_widget_details)'),
+        },
+        annotations: { title: 'Remove Widget from Embedded Layout' },
+    },
+};
+export function registerEmbeddedWidgetLayoutTools(server, client) {
+    server.registerTool(TOOL_ADD_EMBEDDED_WIDGET, EMBEDDED_WIDGET_LAYOUT_TOOL_DEFINITIONS[TOOL_ADD_EMBEDDED_WIDGET], async ({ context, containerWidgetId, layoutAttributeName, widgetType, rowIndex, columnIndex, widgetIndex, configuration, }) => {
+        debugLogWithTag(DEBUG_TAG, `ADD ${widgetType} to container ${containerWidgetId} in ${context.type} layout`);
+        try {
+            const before = await readEmbeddedLayout(client, context, containerWidgetId, layoutAttributeName);
+            const beforeIds = new Set(extractEmbeddedWidgetIds(before));
+            const position = { rowIndex, columnIndex };
+            if (widgetIndex !== undefined)
+                position.widgetIndex = widgetIndex;
+            const operation = { type: 'ADD', widgetType, position };
+            const normalizedConfig = unwrapSingleElementArrays(configuration);
+            if (normalizedConfig && Object.keys(normalizedConfig).length > 0) {
+                operation.configuration = normalizedConfig;
+            }
+            const endpoint = determineEmbeddedEndpoint(context);
+            const body = {
+                ...buildEmbeddedRequestParams(context, containerWidgetId, layoutAttributeName),
+                operation,
+            };
+            const raw = await client.makeRawApiRequest(endpoint, 'PATCH', undefined, body);
+            if (raw?.success !== true) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to add embedded widget: ${raw?.errorMessage || 'Unknown error'}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const after = typeof raw.result === 'string' ? JSON.parse(raw.result) : raw.result;
+            const newIds = extractEmbeddedWidgetIds(after).filter((id) => !beforeIds.has(id));
+            if (newIds.length !== 1) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Add could not be verified: expected exactly one new widget in container '${containerWidgetId}' but found ${newIds.length}${newIds.length ? ` (${newIds.join(', ')})` : ''}. The layout may have changed concurrently, or the add did not take effect. Inspect with cplace_get_layout_widget_details.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const response = {
+                operation: 'ADD_EMBEDDED_WIDGET',
+                success: true,
+                context,
+                containerWidgetId: raw.containerWidgetId ?? containerWidgetId,
+                newWidgetId: newIds[0],
+                widgetType,
+            };
+            const sizeCheck = checkResponseSize(response);
+            if (sizeCheck.tooLarge) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Widget added (id ${newIds[0]}) but the confirmation response was too large. Inspect with cplace_get_layout_widget_details.`,
+                        },
+                    ],
+                };
+            }
+            debugLogWithTag(DEBUG_TAG, `Added ${widgetType} as ${newIds[0]} to ${containerWidgetId}`);
+            return { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] };
+        }
+        catch (error) {
+            debugLogWithTag(DEBUG_TAG, `Error adding embedded widget: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error adding embedded widget: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool(TOOL_REMOVE_EMBEDDED_WIDGET, EMBEDDED_WIDGET_LAYOUT_TOOL_DEFINITIONS[TOOL_REMOVE_EMBEDDED_WIDGET], async ({ context, containerWidgetId, layoutAttributeName, widgetId }) => {
+        debugLogWithTag(DEBUG_TAG, `REMOVE ${widgetId} from container ${containerWidgetId} in ${context.type} layout`);
+        try {
+            const before = await readEmbeddedLayout(client, context, containerWidgetId, layoutAttributeName);
+            const beforeIds = extractEmbeddedWidgetIds(before);
+            if (!beforeIds.includes(widgetId)) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Widget '${widgetId}' is not present in the embedded layout of container '${containerWidgetId}'. Nothing was removed. Call cplace_get_layout_widget_details on the container to list its current embedded child ids.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const endpoint = determineEmbeddedEndpoint(context);
+            const body = {
+                ...buildEmbeddedRequestParams(context, containerWidgetId, layoutAttributeName),
+                operation: { type: 'REMOVE', widgetId },
+            };
+            const raw = await client.makeRawApiRequest(endpoint, 'PATCH', undefined, body);
+            if (raw?.success !== true) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to remove embedded widget: ${raw?.errorMessage || 'Unknown error'}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const after = typeof raw.result === 'string' ? JSON.parse(raw.result) : raw.result;
+            const afterIds = extractEmbeddedWidgetIds(after);
+            if (afterIds.includes(widgetId)) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Backend reported success but widget '${widgetId}' is still present in container '${containerWidgetId}'. The removal did not take effect.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const response = {
+                operation: 'REMOVE_EMBEDDED_WIDGET',
+                success: true,
+                context,
+                containerWidgetId: raw.containerWidgetId ?? containerWidgetId,
+                removedWidgetId: widgetId,
+                remainingWidgetIds: afterIds,
+            };
+            const sizeCheck = checkResponseSize(response);
+            if (sizeCheck.tooLarge) {
+                const compact = { ...response };
+                delete compact.remainingWidgetIds;
+                return { content: [{ type: 'text', text: JSON.stringify(compact, null, 2) }] };
+            }
+            debugLogWithTag(DEBUG_TAG, `Removed ${widgetId} from ${containerWidgetId}`);
+            return { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] };
+        }
+        catch (error) {
+            debugLogWithTag(DEBUG_TAG, `Error removing embedded widget: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error removing embedded widget: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=embedded-widget-layout.js.map