@cplace/test-mcp-server 1.3.7 → 1.3.8

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

@@ -0,0 +1,11 @@
+**Configuration Modes**:
+- `search`: Query pages via embedded search (most common)
+  - Requires: `search` attribute with `cplaceJson` value from `cplace_search_pages`
+- `connectedWidget`: React to selection from another widget on the page
+  - Requires: `connectedWidgetId` pointing to the source widget
+
+**Typical Configuration Workflow**:
+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`)
+4. Configure display options via `displayOptions` multi-enum

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

@@ -0,0 +1,16 @@
+**Warning**: Every column must reference an attribute that actually exists on the **target type** being displayed in the table. Before configuring columns, use cplace MCP tools to look up the target type's actual attributes and verify that each column attribute name exists. Never assume or reconstruct attribute names. Columns referencing non-existent attributes will fail silently or produce errors.
+
+**JSON Format**:
+```json
+[
+  {"name": "'cf.cplace.myType.attributeName'", "visible": true},
+  {"name": "'cf.cplace.myType.otherAttribute'", "visible": false},
+  {"name": "name", "visible": true}
+]
+```
+
+**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"`
+
+**Note**: Order in array determines column display order. Hidden columns (`visible: false`) can still be used for sorting/filtering.

package/dist/widget-specifications/cf.cplace.platform.tableWidget/displayOptions.md

@@ -0,0 +1,12 @@
+**Multi-select enum** controlling table display behavior. Selected values enable the corresponding feature.
+
+**Available options**:
+- `showToolbar`: Show the toolbar with action buttons
+- `showQueryBar`: Show the query/filter bar above the table
+- `showColumnHeader`: Show column headers
+- `showStatusBar`: Show the status bar (pagination) below the table
+- `showLinksInNameColumn`: Make entity names clickable links
+- `showNewButton`: Show the "Create New" button
+- `displayRowsInCompactMode`: Display rows in compact/single-spaced mode
+
+**Note**: When a new widget is created, default display options are applied automatically. The defaults include all options except `displayRowsInCompactMode`.

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

@@ -0,0 +1,16 @@
+**JSON Format**:
+```json
+[
+  {"sortColumn": "'cf.cplace.myType.attribute1'", "sortOrder": "asc", "sortingPriorityIndex": 1},
+  {"sortColumn": "'cf.cplace.myType.attribute2'", "sortOrder": "desc", "sortingPriorityIndex": 2},
+  {"sortColumn": "name", "sortOrder": "asc", "sortingPriorityIndex": 3}
+]
+```
+
+**Valid sortOrder values**: `"asc"`, `"desc"`
+
+**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"`
+
+**Note**: `sortingPriorityIndex` determines which sort applies first (lower = higher priority).

package/dist/widget-specifications/cf.cplace.platform.tableWidget/search.md

@@ -0,0 +1,21 @@
+**Warning**: Do not manually construct search JSON!
+
+**Correct Usage**: Use the cplaceJson field from cplace_search_pages response
+
+**Workflow**:
+1. Call cplace_search_pages with your desired filter
+2. Take the cplaceJson field from the response
+3. Use that value for the search configuration
+
+**Relative Filters** (e.g., "show items referencing current page"):
+
+When using `relativeReference` filters, you MUST provide a real page UID as context:
+
+```
+cplace_search_pages(
+  search_filter: [{"relativeReference": {"attribute": "myType.refAttr", "operator": "embeddingCustomEntity"}}],
+  embeddingEntityUid: "page/abc123"  // ← Real page UID required!
+)
+```
+
+Without a concrete `embeddingEntityUid`, the relative filter won't be included in the returned `cplaceJson`.

package/dist/widget-specifications/cf.platform.embeddedSearchAsTable/_implementation.md

@@ -1,6 +1,6 @@
 **Configuration Modes**:
 - `search`: Query pages via embedded search (most common)
-  - Requires: `search` attribute with cplaceJson from `cplace_search_pages`
+  - Requires: `search` attribute with `cplaceJson` value from `cplace_search_pages`
 - `connectedTable`: Display data from another table widget on the page
   - Requires: `connectedTableWidgetId` pointing to the source widget
 

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

@@ -1,4 +1,4 @@
-**Warning**: Every column must reference an attribute that actually exists on the type being displayed in the table. Before configuring columns, check the type's data model to confirm which attributes are available. Columns referencing non-existent attributes will fail silently or produce errors.
+**Warning**: Every column must reference an attribute that actually exists on the **target type** being displayed in the table. Before configuring columns, use cplace MCP tools to look up the target type's actual attributes and verify that each column attribute name exists. Never assume or reconstruct attribute names. Columns referencing non-existent attributes will fail silently or produce errors.
 
 **JSON Format**:
 ```json

package/dist/widget-specifications/cf.platform.embeddedSearchAsTable/search.md

@@ -1,6 +1,6 @@
 **Warning**: Do not manually construct search JSON!
 
-**Correct Usage**: Use the cplaceJson field from cplace_search_pages response
+**Correct Usage**: Use the `cplaceJson` field from cplace_search_pages response
 
 **Workflow**:
 1. Call cplace_search_pages with your desired filter

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cplace/test-mcp-server",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "description": "MCP server that provides Claude Desktop with tools to interact with cplace APIs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",