@cplace/mcp-server 1.7.1 → 1.7.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/api.d.ts +3 -0
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +93 -69
- package/dist/api.js.map +1 -1
- package/dist/plugins/core/app-catalog/cf.cplace.navigationTileWidget/README.md +2 -0
- package/dist/plugins/core/widget-specifications/cf.cplace.cboard.main.board/_implementation.md +3 -0
- package/dist/plugins/core/widget-specifications/cf.cplace.lowCodeWidgets.lowCodeText/_implementation.md +11 -0
- package/dist/plugins/core/widget-specifications/cf.cplace.platform.attributesGroup/_implementation.md +6 -1
- package/dist/plugins/core/widget-specifications/cf.cplace.platform.connectedAttributesGroup/_implementation.md +5 -0
- package/dist/plugins/core/widget-specifications/cf.cplace.platform.tableWidget/_overview.md +2 -2
- package/dist/plugins/core/widget-specifications/cf.cplace.platform.tableWidget/_summary.md +1 -1
- package/dist/plugins/core/widget-specifications/cf.platform.connectedMatrix/_implementation.md +14 -0
- package/dist/plugins/core/widget-specifications/cf.platform.connectedMatrix/_overview.md +2 -0
- package/dist/plugins/core/widget-specifications/cf.platform.connectedMatrix/_summary.md +1 -1
- package/dist/plugins/core/widget-specifications/cf.platform.connectedMatrix/attributeXName.md +8 -0
- package/dist/plugins/core/widget-specifications/cf.platform.connectedMatrix/attributeYName.md +8 -0
- package/dist/plugins/core/widget-specifications/cf.platform.embeddedSearchAsTable/_overview.md +1 -1
- package/dist/plugins/core/widget-specifications/cf.platform.embeddedSearchAsTable/_summary.md +1 -1
- package/dist/tools/change-listeners.d.ts.map +1 -1
- package/dist/tools/change-listeners.js +6 -2
- package/dist/tools/change-listeners.js.map +1 -1
- package/dist/tools/common-schemas.d.ts +8 -0
- package/dist/tools/common-schemas.d.ts.map +1 -1
- package/dist/tools/common-schemas.js +48 -0
- package/dist/tools/common-schemas.js.map +1 -1
- package/dist/tools/csv-export.d.ts +2 -2
- package/dist/tools/csv-export.d.ts.map +1 -1
- package/dist/tools/csv-export.js +6 -1
- package/dist/tools/csv-export.js.map +1 -1
- package/dist/tools/documents.js +1 -1
- package/dist/tools/documents.js.map +1 -1
- package/dist/tools/layout-richstring-widgets.d.ts.map +1 -1
- package/dist/tools/layout-richstring-widgets.js +5 -2
- package/dist/tools/layout-richstring-widgets.js.map +1 -1
- package/dist/tools/layout.d.ts.map +1 -1
- package/dist/tools/layout.js +1 -1
- package/dist/tools/layout.js.map +1 -1
- package/dist/tools/pages.d.ts +3 -2
- package/dist/tools/pages.d.ts.map +1 -1
- package/dist/tools/pages.js +53 -5
- package/dist/tools/pages.js.map +1 -1
- package/dist/tools/richstring-widgets.d.ts.map +1 -1
- package/dist/tools/richstring-widgets.js +5 -2
- package/dist/tools/richstring-widgets.js.map +1 -1
- package/dist/tools/script.d.ts.map +1 -1
- package/dist/tools/script.js +3 -2
- package/dist/tools/script.js.map +1 -1
- package/dist/tools/search.d.ts +2 -2
- package/dist/tools/search.d.ts.map +1 -1
- package/dist/tools/search.js +6 -2
- package/dist/tools/search.js.map +1 -1
- package/dist/tools/type-management.d.ts.map +1 -1
- package/dist/tools/type-management.js +43 -11
- package/dist/tools/type-management.js.map +1 -1
- package/dist/tools/wizards.d.ts.map +1 -1
- package/dist/tools/wizards.js +54 -17
- package/dist/tools/wizards.js.map +1 -1
- package/dist/tools/workflow-scripts.d.ts.map +1 -1
- package/dist/tools/workflow-scripts.js +2 -1
- package/dist/tools/workflow-scripts.js.map +1 -1
- package/dist/tools/workflow.js +6 -6
- package/dist/tools/workflow.js.map +1 -1
- package/dist/tools/workspace-core.js +1 -1
- package/dist/tools/workspace-core.js.map +1 -1
- package/package.json +21 -20
package/dist/api.d.ts
CHANGED
|
@@ -173,6 +173,9 @@ export declare class CplaceApiClient {
|
|
|
173
173
|
private config;
|
|
174
174
|
private urlPrefix;
|
|
175
175
|
constructor(config: CplaceConfig, urlPrefix?: string);
|
|
176
|
+
private buildHeaders;
|
|
177
|
+
private buildUrl;
|
|
178
|
+
private request;
|
|
176
179
|
makeApiRequest<T extends keyof ApiEndpoints>(endpoint: T, method?: 'GET' | 'POST' | 'PATCH' | 'DELETE', params?: Record<string, any>, data?: any): Promise<ApiEndpoints[T]>;
|
|
177
180
|
makeApiRequest<T = any>(endpoint: string, method?: 'GET' | 'POST' | 'PATCH' | 'DELETE', params?: Record<string, any>, data?: any): Promise<T>;
|
|
178
181
|
makeRawApiRequest(endpoint: string, method?: 'GET' | 'POST' | 'PATCH' | 'DELETE', params?: Record<string, any>, data?: any): Promise<any>;
|
package/dist/api.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
|
package/dist/api.js
CHANGED
|
@@ -1,6 +1,20 @@
|
|
|
1
|
-
import axios from 'axios';
|
|
2
1
|
import { debugLogWithTag } from './logger.js';
|
|
3
2
|
export const DEFAULT_URL_PREFIX = 'cplace-api/cf.cplace.citizenAi/mcp';
|
|
3
|
+
class HttpError extends Error {
|
|
4
|
+
status;
|
|
5
|
+
statusText;
|
|
6
|
+
data;
|
|
7
|
+
constructor(status, statusText, data) {
|
|
8
|
+
super(`Request failed with status code ${status}`);
|
|
9
|
+
this.name = 'HttpError';
|
|
10
|
+
this.status = status;
|
|
11
|
+
this.statusText = statusText;
|
|
12
|
+
this.data = data;
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
function isHttpError(error) {
|
|
16
|
+
return error instanceof HttpError;
|
|
17
|
+
}
|
|
4
18
|
export class CplaceApiClient {
|
|
5
19
|
config;
|
|
6
20
|
urlPrefix;
|
|
@@ -8,6 +22,74 @@ export class CplaceApiClient {
|
|
|
8
22
|
this.config = config;
|
|
9
23
|
this.urlPrefix = urlPrefix;
|
|
10
24
|
}
|
|
25
|
+
buildHeaders(method) {
|
|
26
|
+
const headers = {
|
|
27
|
+
'X-Cplace-Api-Token': this.config.apiToken,
|
|
28
|
+
'Content-Type': 'application/json',
|
|
29
|
+
'Accept': 'application/json'
|
|
30
|
+
};
|
|
31
|
+
if (method === 'POST' || method === 'PATCH' || method === 'DELETE') {
|
|
32
|
+
headers['X-Requested-With'] = 'XMLHttpRequest';
|
|
33
|
+
headers['X-CSRF-TOKEN'] = 'fetch';
|
|
34
|
+
}
|
|
35
|
+
return headers;
|
|
36
|
+
}
|
|
37
|
+
buildUrl(endpoint, params) {
|
|
38
|
+
const url = new URL(`${this.urlPrefix}/${endpoint}`, this.config.url);
|
|
39
|
+
if (params) {
|
|
40
|
+
for (const [key, value] of Object.entries(params)) {
|
|
41
|
+
if (value === undefined || value === null)
|
|
42
|
+
continue;
|
|
43
|
+
if (Array.isArray(value)) {
|
|
44
|
+
for (const v of value) {
|
|
45
|
+
url.searchParams.append(key, String(v));
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
else {
|
|
49
|
+
url.searchParams.append(key, String(value));
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
return url.toString();
|
|
54
|
+
}
|
|
55
|
+
async request(endpoint, method, params, data) {
|
|
56
|
+
const headers = this.buildHeaders(method);
|
|
57
|
+
const url = this.buildUrl(endpoint, method === 'GET' || method === 'DELETE' ? params : undefined);
|
|
58
|
+
debugLogWithTag('API_CLIENT', `Full URL: ${url}`);
|
|
59
|
+
debugLogWithTag('API_CLIENT', `Headers: ${JSON.stringify(headers)}`);
|
|
60
|
+
debugLogWithTag('API_CLIENT', `About to make ${method} request`);
|
|
61
|
+
const init = { method, headers };
|
|
62
|
+
if (method === 'POST' || method === 'PATCH') {
|
|
63
|
+
debugLogWithTag('API_CLIENT', `${method} request body: ${JSON.stringify(data)}`);
|
|
64
|
+
init.body = data !== undefined ? JSON.stringify(data) : undefined;
|
|
65
|
+
}
|
|
66
|
+
else if (method === 'DELETE' && data !== undefined) {
|
|
67
|
+
init.body = JSON.stringify(data);
|
|
68
|
+
}
|
|
69
|
+
const response = await fetch(url, init);
|
|
70
|
+
debugLogWithTag('API_CLIENT', `Response status: ${response.status}`);
|
|
71
|
+
const contentType = response.headers.get('content-type') || '';
|
|
72
|
+
const text = await response.text();
|
|
73
|
+
let parsed;
|
|
74
|
+
if (text.length === 0) {
|
|
75
|
+
parsed = undefined;
|
|
76
|
+
}
|
|
77
|
+
else if (contentType.includes('application/json')) {
|
|
78
|
+
try {
|
|
79
|
+
parsed = JSON.parse(text);
|
|
80
|
+
}
|
|
81
|
+
catch {
|
|
82
|
+
parsed = text;
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
else {
|
|
86
|
+
parsed = text;
|
|
87
|
+
}
|
|
88
|
+
if (!response.ok) {
|
|
89
|
+
throw new HttpError(response.status, response.statusText, parsed);
|
|
90
|
+
}
|
|
91
|
+
return { status: response.status, data: parsed };
|
|
92
|
+
}
|
|
11
93
|
async makeApiRequest(endpoint, method = 'GET', params, data) {
|
|
12
94
|
debugLogWithTag('API_CLIENT', `Making ${method} request to endpoint: ${endpoint}`);
|
|
13
95
|
debugLogWithTag('API_CLIENT', `Params: ${JSON.stringify(params)}`);
|
|
@@ -16,38 +98,7 @@ export class CplaceApiClient {
|
|
|
16
98
|
throw new Error('CPLACE_URL and API_TOKEN environment variables are required');
|
|
17
99
|
}
|
|
18
100
|
try {
|
|
19
|
-
const
|
|
20
|
-
'X-Cplace-Api-Token': this.config.apiToken,
|
|
21
|
-
'Content-Type': 'application/json',
|
|
22
|
-
'Accept': 'application/json'
|
|
23
|
-
};
|
|
24
|
-
if (method === 'POST' || method === 'PATCH' || method === 'DELETE') {
|
|
25
|
-
headers['X-Requested-With'] = 'XMLHttpRequest';
|
|
26
|
-
headers['X-CSRF-TOKEN'] = 'fetch';
|
|
27
|
-
}
|
|
28
|
-
const url = new URL(`${this.urlPrefix}/${endpoint}`, this.config.url).toString();
|
|
29
|
-
debugLogWithTag('API_CLIENT', `Full URL: ${url}`);
|
|
30
|
-
debugLogWithTag('API_CLIENT', `Headers: ${JSON.stringify(headers)}`);
|
|
31
|
-
let response;
|
|
32
|
-
debugLogWithTag('API_CLIENT', `About to make ${method} request`);
|
|
33
|
-
if (method === 'GET') {
|
|
34
|
-
response = await axios.get(url, { headers, params });
|
|
35
|
-
}
|
|
36
|
-
else if (method === 'POST') {
|
|
37
|
-
debugLogWithTag('API_CLIENT', `POST request body: ${JSON.stringify(data)}`);
|
|
38
|
-
response = await axios.post(url, data, { headers });
|
|
39
|
-
}
|
|
40
|
-
else if (method === 'PATCH') {
|
|
41
|
-
debugLogWithTag('API_CLIENT', `PATCH request body: ${JSON.stringify(data)}`);
|
|
42
|
-
response = await axios.patch(url, data, { headers });
|
|
43
|
-
}
|
|
44
|
-
else if (method === 'DELETE') {
|
|
45
|
-
response = await axios.delete(url, { headers, params, data });
|
|
46
|
-
}
|
|
47
|
-
else {
|
|
48
|
-
throw new Error(`Unsupported HTTP method: ${method}`);
|
|
49
|
-
}
|
|
50
|
-
debugLogWithTag('API_CLIENT', `Response status: ${response.status}`);
|
|
101
|
+
const response = await this.request(endpoint, method, params, data);
|
|
51
102
|
const responseData = response.data;
|
|
52
103
|
if (responseData.result !== undefined) {
|
|
53
104
|
const result = responseData.result;
|
|
@@ -76,11 +127,11 @@ export class CplaceApiClient {
|
|
|
76
127
|
}
|
|
77
128
|
}
|
|
78
129
|
catch (error) {
|
|
79
|
-
if (
|
|
80
|
-
debugLogWithTag('API_CLIENT', `HTTP Error: ${error.
|
|
81
|
-
debugLogWithTag('API_CLIENT', `Response data: ${JSON.stringify(error.
|
|
130
|
+
if (isHttpError(error)) {
|
|
131
|
+
debugLogWithTag('API_CLIENT', `HTTP Error: ${error.status} - ${error.statusText}`);
|
|
132
|
+
debugLogWithTag('API_CLIENT', `Response data: ${JSON.stringify(error.data)}`);
|
|
82
133
|
debugLogWithTag('API_CLIENT', `Full error: ${error.message}`);
|
|
83
|
-
throw new Error(`Request failed: ${error.message} (Status: ${error.
|
|
134
|
+
throw new Error(`Request failed: ${error.message} (Status: ${error.status})`);
|
|
84
135
|
}
|
|
85
136
|
else {
|
|
86
137
|
debugLogWithTag('API_CLIENT', `Non-HTTP error: ${error}`);
|
|
@@ -96,41 +147,14 @@ export class CplaceApiClient {
|
|
|
96
147
|
throw new Error('CPLACE_URL and API_TOKEN environment variables are required');
|
|
97
148
|
}
|
|
98
149
|
try {
|
|
99
|
-
const
|
|
100
|
-
'X-Cplace-Api-Token': this.config.apiToken,
|
|
101
|
-
'Content-Type': 'application/json',
|
|
102
|
-
'Accept': 'application/json'
|
|
103
|
-
};
|
|
104
|
-
if (method === 'POST' || method === 'PATCH' || method === 'DELETE') {
|
|
105
|
-
headers['X-Requested-With'] = 'XMLHttpRequest';
|
|
106
|
-
headers['X-CSRF-TOKEN'] = 'fetch';
|
|
107
|
-
}
|
|
108
|
-
const url = new URL(`${this.urlPrefix}/${endpoint}`, this.config.url).toString();
|
|
109
|
-
debugLogWithTag('API_CLIENT', `Full URL: ${url}`);
|
|
110
|
-
let response;
|
|
111
|
-
if (method === 'GET') {
|
|
112
|
-
response = await axios.get(url, { headers, params });
|
|
113
|
-
}
|
|
114
|
-
else if (method === 'POST') {
|
|
115
|
-
response = await axios.post(url, data, { headers });
|
|
116
|
-
}
|
|
117
|
-
else if (method === 'PATCH') {
|
|
118
|
-
response = await axios.patch(url, data, { headers });
|
|
119
|
-
}
|
|
120
|
-
else if (method === 'DELETE') {
|
|
121
|
-
response = await axios.delete(url, { headers, params, data });
|
|
122
|
-
}
|
|
123
|
-
else {
|
|
124
|
-
throw new Error(`Unsupported HTTP method: ${method}`);
|
|
125
|
-
}
|
|
126
|
-
debugLogWithTag('API_CLIENT', `Response status: ${response.status}`);
|
|
150
|
+
const response = await this.request(endpoint, method, params, data);
|
|
127
151
|
return response.data;
|
|
128
152
|
}
|
|
129
153
|
catch (error) {
|
|
130
|
-
if (
|
|
131
|
-
debugLogWithTag('API_CLIENT', `HTTP Error: ${error.
|
|
132
|
-
debugLogWithTag('API_CLIENT', `Response data: ${JSON.stringify(error.
|
|
133
|
-
throw new Error(`Request failed: ${error.message} (Status: ${error.
|
|
154
|
+
if (isHttpError(error)) {
|
|
155
|
+
debugLogWithTag('API_CLIENT', `HTTP Error: ${error.status} - ${error.statusText}`);
|
|
156
|
+
debugLogWithTag('API_CLIENT', `Response data: ${JSON.stringify(error.data)}`);
|
|
157
|
+
throw new Error(`Request failed: ${error.message} (Status: ${error.status})`);
|
|
134
158
|
}
|
|
135
159
|
else {
|
|
136
160
|
debugLogWithTag('API_CLIENT', `Non-HTTP error: ${error}`);
|
package/dist/api.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Tile Navigation (cf.cplace.navigationTileWidget)
|
|
2
2
|
|
|
3
|
+
> **Not recommended for new implementations.** The visual appearance does not meet modern UX standards. Consider alternatives: workspace navigation, Breadcrumbs App (`cf.cplace.breadcrumbs`), Landing Page App (`cf.cplace.landingPage`), or Title and Page Links Widget (`cf.cplace.documentation.navigationWidget`). Use only when explicitly requested.
|
|
4
|
+
|
|
3
5
|
## Overview
|
|
4
6
|
|
|
5
7
|
The Tile Navigation app provides a widget for navigating from one cplace page to another without using the workspace navigation menu. It displays clickable tiles representing pages in a hierarchy, enabling intuitive page-to-page navigation.
|
package/dist/plugins/core/widget-specifications/cf.cplace.cboard.main.board/_implementation.md
CHANGED
|
@@ -59,3 +59,6 @@ Card display is configured via `cardDisplay` in card configuration. Available di
|
|
|
59
59
|
- `iconAttributes`: Icon indicators (array of `{attribute, enabled}` objects)
|
|
60
60
|
|
|
61
61
|
Columns and swimlanes are restricted to the attribute types listed above.
|
|
62
|
+
|
|
63
|
+
**Column Attribute Type Restriction**:
|
|
64
|
+
The attribute used for column mapping must be of type `textEnumeration`, `reference`, or `date`. Workflow-managed attributes are NOT supported as column attributes — the board will show "The board is not properly configured." If the type uses a workflow attribute for status and a board visualization is needed, create a mirror `textEnumeration` attribute with the same values as the workflow states, and add a change listener to keep it in sync.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
**Embedding Requirement**: This widget MUST be embedded inside a Rich String (`cf.cplace.platform.demoRichString`) container. It cannot be placed directly as a top-level widget on a layout. The platform API silently accepts direct placement, but the frontend rejects it at render time with: "Invalid embedding: Low-Code text widget can only be embedded in rich string widgets."
|
|
2
|
+
|
|
3
|
+
**Correct Placement Workflow**:
|
|
4
|
+
1. Create a `demoRichString` (Rich String) container widget on the layout
|
|
5
|
+
2. Use the rich string insertion tool to embed the `lowCodeText` widget inside the container
|
|
6
|
+
3. Never place `lowCodeText` directly in a layout row/column
|
|
7
|
+
|
|
8
|
+
**Script Context**:
|
|
9
|
+
- The embedding page is accessed via `embeddingPage` (NOT `currentPage`)
|
|
10
|
+
- To count pages: use `search.findAllPages()` with iteration (NOT `search.getResultCount()` — this method does not exist)
|
|
11
|
+
- The script must return an HTML string (e.g., `'<span>' + count + '</span>'`)
|
|
@@ -10,4 +10,9 @@
|
|
|
10
10
|
- For `relative`: Set `relativeSelection` to a reference attribute name
|
|
11
11
|
- For `embedding`: No additional configuration needed
|
|
12
12
|
3. Configure the `layout` using dedicated MCP Tools for Managing Embedded Layouts
|
|
13
|
-
4. Optionally customize appearance (`showFrame`, `singleColumn`) and behavior (`enableMultiEdit`)
|
|
13
|
+
4. Optionally customize appearance (`showFrame`, `singleColumn`) and behavior (`enableMultiEdit`)
|
|
14
|
+
|
|
15
|
+
**Frontend Mode** (`cf.cplace.platform.useNewFrontend`):
|
|
16
|
+
- Controls whether the widget renders using the modern frontend implementation
|
|
17
|
+
- **Always set to `true`** for new implementations to enable the modern rendering pipeline
|
|
18
|
+
- When `true`, child Single Attribute widgets inherit this setting automatically
|
|
@@ -15,3 +15,8 @@ This is a **container widget** that holds an embedded layout grid. It contains n
|
|
|
15
15
|
- Widget subscribes to selection events from the connected table widget
|
|
16
16
|
- When user selects a row in the table, this widget refreshes to show attributes of that entity
|
|
17
17
|
- Currently only table widgets (`cf.cplace.platform.table`) can be used as selection sources
|
|
18
|
+
|
|
19
|
+
**Frontend Mode** (`cf.cplace.platform.useNewFrontend`):
|
|
20
|
+
- Controls whether the widget renders using the modern frontend implementation
|
|
21
|
+
- **Always set to `true`** for new implementations to enable the modern rendering pipeline
|
|
22
|
+
- When `true`, child Connected Single Attribute widgets inherit this setting automatically
|
|
@@ -159,7 +159,7 @@ Parent-child table relationship:
|
|
|
159
159
|
|
|
160
160
|
## Comparison with Other Table Widgets
|
|
161
161
|
|
|
162
|
-
### vs. Embedded Search as Table (EMBEDDED_SEARCH_AS_TABLE)
|
|
162
|
+
### vs. Embedded Search as Table (EMBEDDED_SEARCH_AS_TABLE) — This widget is preferred
|
|
163
163
|
|
|
164
164
|
**Table Widget advantages**:
|
|
165
165
|
- Modern web component architecture (vs. legacy AngularJS)
|
|
@@ -177,7 +177,7 @@ Parent-child table relationship:
|
|
|
177
177
|
- When `newTableEnabled` feature flag is not active
|
|
178
178
|
- Existing implementations that don't need migration
|
|
179
179
|
|
|
180
|
-
The Table Widget is the
|
|
180
|
+
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.
|
|
181
181
|
|
|
182
182
|
## Related Widgets
|
|
183
183
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
Displays a list of search results in an interactive, configurable table format with advanced features like sorting, filtering, column configuration, and widget connectivity. Use for structured data display and as a data source for connected widgets through master-detail patterns.
|
|
1
|
+
Preferred table widget for new implementations. Displays a list of search results in an interactive, configurable table format with advanced features like sorting, filtering, column configuration, and widget connectivity. Use for structured data display and as a data source for connected widgets through master-detail patterns.
|
package/dist/plugins/core/widget-specifications/cf.platform.connectedMatrix/_implementation.md
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
**Data Source**: Uses a connected table widget (`TABLE_WIDGET_ID`) as data source. Unlike bar/pie charts, the matrix does not support a standalone `search` fallback — a connected table is always required.
|
|
2
|
+
|
|
3
|
+
**Axis Attributes — Quoting Convention**:
|
|
4
|
+
- **Custom attributes** require single quotes inside the string value: `"'cf.cplace.myApp.myAttribute'"`
|
|
5
|
+
- **Builtin attributes** are specified without inner quotes: `"name"`
|
|
6
|
+
- Without the inner single quotes, custom attributes silently fail — the widget shows "Please complete the widget configuration" despite the attribute being set.
|
|
7
|
+
- This follows the same quoting convention as `connectedBarChart`'s `attributeName`.
|
|
8
|
+
|
|
9
|
+
**Typical Configuration Workflow**:
|
|
10
|
+
1. Set `TABLE_WIDGET_ID` to connect to an existing table widget on the same page
|
|
11
|
+
2. Select `attributeXName` — the attribute for the X-axis (horizontal). Must use single-quoted format for custom attributes.
|
|
12
|
+
3. Select `attributeYName` — the attribute for the Y-axis (vertical). Same quoting convention.
|
|
13
|
+
4. Optionally set axis styles (`plain`, `label`, `arrow`, `profile-line`, `profile-column`)
|
|
14
|
+
5. Optionally set `MAX_RESULTS` to limit the number of data points
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
## Overview
|
|
2
2
|
|
|
3
|
+
> **Do not use this widget unless explicitly requested.** Consider bar charts, tables with grouping, or other visualization approaches for two-dimensional data analysis.
|
|
4
|
+
|
|
3
5
|
Visualizes the content of a table broken down according to two search criteria.
|
|
4
6
|
|
|
5
7
|
The Connected Matrix Widget organizes pages from a search result into a two-dimensional grid structure based on two configurable attributes. Each axis represents a categorical dimension (such as team members, time periods, risk levels, or features), and the intersection cells contain the pages matching those coordinate combinations.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
Visualizes the content of a table broken down according to two search criteria. Positions pages based on two configurable attributes (X and Y axes) to show distribution patterns and relationships.
|
|
1
|
+
**Not recommended for new implementations unless explicitly requested.** Visualizes the content of a table broken down according to two search criteria. Positions pages based on two configurable attributes (X and Y axes) to show distribution patterns and relationships. Consider bar charts, tables with grouping, or other visualization approaches instead.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
**Warning**: The attribute must exist on the type visualized by the connected table!
|
|
2
|
+
|
|
3
|
+
**Important — Quoting Convention**:
|
|
4
|
+
- **Custom attributes** require single quotes around the attribute name inside the string value: `"'cf.cplace.myApp.myAttribute'"`
|
|
5
|
+
- **Builtin attributes** (e.g., `name`, `createdAt`) are specified without inner quotes: `"name"`
|
|
6
|
+
- Without inner quotes, the widget silently fails and shows "Please complete the widget configuration"
|
|
7
|
+
|
|
8
|
+
**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.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
**Warning**: The attribute must exist on the type visualized by the connected table!
|
|
2
|
+
|
|
3
|
+
**Important — Quoting Convention**:
|
|
4
|
+
- **Custom attributes** require single quotes around the attribute name inside the string value: `"'cf.cplace.myApp.myAttribute'"`
|
|
5
|
+
- **Builtin attributes** (e.g., `name`, `createdAt`) are specified without inner quotes: `"name"`
|
|
6
|
+
- Without inner quotes, the widget silently fails and shows "Please complete the widget configuration"
|
|
7
|
+
|
|
8
|
+
**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.embeddedSearchAsTable/_overview.md
CHANGED
|
@@ -11,7 +11,7 @@ The Embedded Search Table displays a filtered list of pages in a tabular format.
|
|
|
11
11
|
- Display related entities on a page detail view
|
|
12
12
|
|
|
13
13
|
**Alternatives:**
|
|
14
|
-
- **New Table Widget** -
|
|
14
|
+
- **New Table Widget** (`cf.cplace.platform.tableWidget`) - **Preferred alternative for new implementations.** Modern web component architecture with multi-column sorting, advanced filtering, and multi-producer support.
|
|
15
15
|
- **Embedded Search as List** - Simpler card-based display without columns
|
|
16
16
|
|
|
17
17
|
## Operating Modes
|
package/dist/plugins/core/widget-specifications/cf.platform.embeddedSearchAsTable/_summary.md
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
Generates a table of search results
|
|
1
|
+
Legacy table widget. Generates a table of search results with support for master-detail interactions, column configuration, and user-driven sorting. **Prefer `cf.cplace.platform.tableWidget` for new implementations.**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"change-listeners.d.ts","sourceRoot":"","sources":["../../src/tools/change-listeners.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;
|
|
1
|
+
{"version":3,"file":"change-listeners.d.ts","sourceRoot":"","sources":["../../src/tools/change-listeners.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;AAY5C,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CnC,CAAC;AAEX,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAkMrF"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { debugLogWithTag } from "../logger.js";
|
|
3
3
|
import { applyStrReplace } from '../str-replace-utils.js';
|
|
4
|
+
import { CPLACEJS_COMMON_API_CHEAT_SHEET } from "./common-schemas.js";
|
|
4
5
|
const TOOL_GET_CHANGE_LISTENERS_BY_TYPE = 'cplace_get_change_listeners_by_type';
|
|
5
6
|
const TOOL_MANAGE_CHANGE_LISTENER = 'cplace_manage_change_listener';
|
|
6
7
|
const TOOL_EDIT_CHANGE_LISTENER = 'cplace_edit_change_listener';
|
|
@@ -21,8 +22,8 @@ export const CHANGE_LISTENER_TOOL_DEFINITIONS = {
|
|
|
21
22
|
workspaceId: z.string().describe("Required: Target workspace ID (e.g., 'abc123')"),
|
|
22
23
|
typeInternalName: z.string().describe("Required: Type internal name (e.g., 'cf.example.Project')"),
|
|
23
24
|
identifier: z.string().describe("Required: Unique identifier for the listener"),
|
|
24
|
-
script: z.string().optional().describe("⚠️ REQUIRED: Review cplace Low-Code documentation before writing change listener scripts. Access via web (https://docs.cplace.io/lowcode/features/change-listeners/), MCP tools, or local file system."),
|
|
25
|
-
attributeNames: z.array(z.string()).optional().describe("
|
|
25
|
+
script: z.string().optional().describe("⚠️ REQUIRED: Review cplace Low-Code documentation before writing change listener scripts. Access via web (https://docs.cplace.io/lowcode/features/change-listeners/), MCP tools, or local file system." + CPLACEJS_COMMON_API_CHEAT_SHEET),
|
|
26
|
+
attributeNames: z.array(z.string()).optional().describe("Trigger attributes that activate this listener when modified. Required for create (at least one). Optional for update (replaces all existing trigger attributes)."),
|
|
26
27
|
enabled: z.boolean().optional().describe("For update only: Enable/disable the listener"),
|
|
27
28
|
localizedNames: z.record(z.string()).optional().describe("Optional: Localized display names (e.g., {\"en\": \"My Listener\", \"de\": \"Mein Listener\"})"),
|
|
28
29
|
description: z.string().optional().describe("Optional: Description of the listener")
|
|
@@ -114,6 +115,9 @@ export function registerChangeListenerTools(server, client) {
|
|
|
114
115
|
if (params.description !== undefined) {
|
|
115
116
|
requestBody.description = params.description;
|
|
116
117
|
}
|
|
118
|
+
if (params.attributeNames !== undefined) {
|
|
119
|
+
requestBody.attributeNames = params.attributeNames;
|
|
120
|
+
}
|
|
117
121
|
const result = await client.makeApiRequest('json/change-listener', 'PATCH', undefined, requestBody);
|
|
118
122
|
return {
|
|
119
123
|
content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"change-listeners.js","sourceRoot":"","sources":["../../src/tools/change-listeners.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;
|
|
1
|
+
{"version":3,"file":"change-listeners.js","sourceRoot":"","sources":["../../src/tools/change-listeners.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export declare function validateNotJsonString(value: unknown, paramName: string, expectedShape: 'object' | 'array'): {
|
|
3
|
+
isError: true;
|
|
4
|
+
message: string;
|
|
5
|
+
} | null;
|
|
6
|
+
export declare function scalarOrSingleArray<T extends z.ZodTypeAny>(schema: T): z.ZodEffects<T, T["_output"], unknown>;
|
|
7
|
+
export declare function unwrapSingleElementArrays(record: Record<string, any> | undefined | null): Record<string, any> | undefined | null;
|
|
8
|
+
export declare const CPLACEJS_COMMON_API_CHEAT_SHEET = "\n\nCommon cplaceJS APIs (avoid these known pitfalls):\n- Iterate pages: `cplace.each(pages, function(page) { ... })` \u2014 do NOT use `cplace.utils().iterator()` (does not exist)\n- First match: `Iterables.getFirst(pages, null)` \u2014 do NOT use `search.findFirstPage()` (does not exist)\n- Update from change listener: `cplace.actions().updatePage(changeEvent.getEntity(), {...})` \u2014 do NOT use `page.registerAttributeForUpdate()` (does not exist)\n- Return values must be primitives or plain maps \u2014 do NOT return Java `ArrayList` or results of `cplace.map()` directly; they fail serialization";
|
|
1
9
|
export declare const DATE_TIME_FORMAT_DESCRIPTION = "Date/time values use consistent formats across all operations:\n\nSUPPORTED FORMATS:\n1. Date-only: \"YYYY-MM-DD\" (e.g., \"2024-01-15\")\n - Represents the start of day in the server timezone\n - Use for date-based operations where time precision doesn't matter\n - Recommended format when exact time is not critical\n\n2. Datetime: \"YYYY-MM-DDTHH:mm:ss\" (e.g., \"2024-01-15T14:00:00\")\n - No timezone suffix (interpreted as server local time)\n - Use for time-sensitive operations requiring precision\n - Server timezone is assumed to be UTC";
|
|
2
10
|
export declare const DATE_FILTER_FORMAT_DESCRIPTION = "Date filter values MUST use date-only format: YYYY-MM-DD\n\nIMPORTANT: Date filters enforce strict date-only precision for predictable query behavior.\nDatetime formats with time components are NOT supported.";
|
|
3
11
|
//# sourceMappingURL=common-schemas.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"common-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/common-schemas.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"common-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/common-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,QAAQ,GAAG,OAAO,GAChC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB3C;AAMD,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,0CAKpE;AAUD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAWhI;AAOD,eAAO,MAAM,+BAA+B,mmBAMyG,CAAC;AAKtJ,eAAO,MAAM,4BAA4B,mjBAWC,CAAC;AAG3C,eAAO,MAAM,8BAA8B,qNAGc,CAAC"}
|
|
@@ -1,3 +1,51 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export function validateNotJsonString(value, paramName, expectedShape) {
|
|
3
|
+
if (typeof value !== 'string')
|
|
4
|
+
return null;
|
|
5
|
+
try {
|
|
6
|
+
const parsed = JSON.parse(value);
|
|
7
|
+
const parsedIsArray = Array.isArray(parsed);
|
|
8
|
+
const parsedIsObject = parsed !== null && typeof parsed === 'object' && !parsedIsArray;
|
|
9
|
+
if ((expectedShape === 'array' && parsedIsArray) || (expectedShape === 'object' && parsedIsObject)) {
|
|
10
|
+
const exampleGood = expectedShape === 'object' ? '{"foo":"bar"}' : '[{"foo":"bar"}]';
|
|
11
|
+
const exampleBad = expectedShape === 'object' ? '"{\\"foo\\":\\"bar\\"}"' : '"[{\\"foo\\":\\"bar\\"}]"';
|
|
12
|
+
return {
|
|
13
|
+
isError: true,
|
|
14
|
+
message: `Parameter '${paramName}' must be a JSON ${expectedShape}, not a JSON string. Pass the structured value directly, e.g. ${exampleGood} — NOT ${exampleBad}.`,
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
catch {
|
|
19
|
+
}
|
|
20
|
+
return null;
|
|
21
|
+
}
|
|
22
|
+
export function scalarOrSingleArray(schema) {
|
|
23
|
+
return z.preprocess((val) => {
|
|
24
|
+
if (Array.isArray(val) && val.length === 1)
|
|
25
|
+
return val[0];
|
|
26
|
+
return val;
|
|
27
|
+
}, schema);
|
|
28
|
+
}
|
|
29
|
+
export function unwrapSingleElementArrays(record) {
|
|
30
|
+
if (!record || typeof record !== 'object' || Array.isArray(record))
|
|
31
|
+
return record;
|
|
32
|
+
const result = {};
|
|
33
|
+
for (const [key, value] of Object.entries(record)) {
|
|
34
|
+
if (Array.isArray(value) && value.length === 1 && typeof value[0] === 'boolean') {
|
|
35
|
+
result[key] = value[0];
|
|
36
|
+
continue;
|
|
37
|
+
}
|
|
38
|
+
result[key] = value;
|
|
39
|
+
}
|
|
40
|
+
return result;
|
|
41
|
+
}
|
|
42
|
+
export const CPLACEJS_COMMON_API_CHEAT_SHEET = `
|
|
43
|
+
|
|
44
|
+
Common cplaceJS APIs (avoid these known pitfalls):
|
|
45
|
+
- Iterate pages: \`cplace.each(pages, function(page) { ... })\` — do NOT use \`cplace.utils().iterator()\` (does not exist)
|
|
46
|
+
- First match: \`Iterables.getFirst(pages, null)\` — do NOT use \`search.findFirstPage()\` (does not exist)
|
|
47
|
+
- Update from change listener: \`cplace.actions().updatePage(changeEvent.getEntity(), {...})\` — do NOT use \`page.registerAttributeForUpdate()\` (does not exist)
|
|
48
|
+
- Return values must be primitives or plain maps — do NOT return Java \`ArrayList\` or results of \`cplace.map()\` directly; they fail serialization`;
|
|
1
49
|
export const DATE_TIME_FORMAT_DESCRIPTION = `Date/time values use consistent formats across all operations:
|
|
2
50
|
|
|
3
51
|
SUPPORTED FORMATS:
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"common-schemas.js","sourceRoot":"","sources":["../../src/tools/common-schemas.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"common-schemas.js","sourceRoot":"","sources":["../../src/tools/common-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,UAAU,qBAAqB,CACnC,KAAc,EACd,SAAiB,EACjB,aAAiC;IAEjC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,cAAc,GAAG,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC;QACvF,IAAI,CAAC,aAAa,KAAK,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,KAAK,QAAQ,IAAI,cAAc,CAAC,EAAE,CAAC;YACnG,MAAM,WAAW,GAAG,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC;YACrF,MAAM,UAAU,GAAG,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,2BAA2B,CAAC;YACxG,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,cAAc,SAAS,oBAAoB,aAAa,iEAAiE,WAAW,UAAU,UAAU,GAAG;aACrK,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;IAET,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAMD,MAAM,UAAU,mBAAmB,CAAyB,MAAS;IACnE,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,MAAM,CAAC,CAAC;AACb,CAAC;AAUD,MAAM,UAAU,yBAAyB,CAAC,MAA8C;IACtF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAClF,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAChF,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;qJAMsG,CAAC;AAKtJ,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;0CAWF,CAAC;AAG3C,MAAM,CAAC,MAAM,8BAA8B,GAAG;;;yDAGW,CAAC"}
|
|
@@ -7,7 +7,7 @@ export declare const CSV_EXPORT_TOOL_DEFINITIONS: {
|
|
|
7
7
|
readonly inputSchema: {
|
|
8
8
|
readonly workspaceId: z.ZodOptional<z.ZodString>;
|
|
9
9
|
readonly typeInternalName: z.ZodString;
|
|
10
|
-
readonly searchFilter: z.ZodArray<z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
|
|
10
|
+
readonly searchFilter: z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
|
|
11
11
|
name: z.ZodObject<{
|
|
12
12
|
equals: z.ZodString;
|
|
13
13
|
}, "strip", z.ZodTypeAny, {
|
|
@@ -3443,7 +3443,7 @@ export declare const CSV_EXPORT_TOOL_DEFINITIONS: {
|
|
|
3443
3443
|
attribute: string;
|
|
3444
3444
|
})[];
|
|
3445
3445
|
})[];
|
|
3446
|
-
}>]>, "many">;
|
|
3446
|
+
}>]>, "many">, z.ZodString]>;
|
|
3447
3447
|
readonly limit: z.ZodDefault<z.ZodNumber>;
|
|
3448
3448
|
readonly offset: z.ZodDefault<z.ZodNumber>;
|
|
3449
3449
|
readonly attributes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|