@cplace/mcp-server 1.16.0 → 2.1.0

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.
Files changed (162) hide show
  1. package/README.md +37 -110
  2. package/dist/backend-capabilities.d.ts +15 -1
  3. package/dist/backend-capabilities.d.ts.map +1 -1
  4. package/dist/backend-capabilities.js +26 -1
  5. package/dist/backend-capabilities.js.map +1 -1
  6. package/dist/capability-gating.d.ts +35 -0
  7. package/dist/capability-gating.d.ts.map +1 -0
  8. package/dist/capability-gating.js +169 -0
  9. package/dist/capability-gating.js.map +1 -0
  10. package/dist/index.js +88 -41
  11. package/dist/index.js.map +1 -1
  12. package/dist/lint-on-write.d.ts +14 -0
  13. package/dist/lint-on-write.d.ts.map +1 -0
  14. package/dist/lint-on-write.js +29 -0
  15. package/dist/lint-on-write.js.map +1 -0
  16. package/dist/plugin-registry.d.ts +1 -1
  17. package/dist/plugin-registry.d.ts.map +1 -1
  18. package/dist/plugin-registry.js +28 -13
  19. package/dist/plugin-registry.js.map +1 -1
  20. package/dist/plugins/core/widget-specifications/cf.cplace.platform.tableWidget/search.md +10 -0
  21. package/dist/plugins/core/widget-specifications/cf.platform.connectedBarChart/search.md +6 -0
  22. package/dist/plugins/core/widget-specifications/cf.platform.connectedPieChart/search.md +6 -0
  23. package/dist/plugins/core/widget-specifications/cf.platform.embeddedSearchAsList/search.md +6 -0
  24. package/dist/plugins/core/widget-specifications/cf.platform.embeddedSearchAsTable/search.md +6 -0
  25. package/dist/plugins/low-code.d.ts.map +1 -1
  26. package/dist/plugins/low-code.js +5 -0
  27. package/dist/plugins/low-code.js.map +1 -1
  28. package/dist/searchConversion.d.ts +6 -0
  29. package/dist/searchConversion.d.ts.map +1 -1
  30. package/dist/searchConversion.js +219 -132
  31. package/dist/searchConversion.js.map +1 -1
  32. package/dist/searchEditorShape.d.ts +10 -0
  33. package/dist/searchEditorShape.d.ts.map +1 -0
  34. package/dist/searchEditorShape.js +103 -0
  35. package/dist/searchEditorShape.js.map +1 -0
  36. package/dist/searchSchema.d.ts +119 -119
  37. package/dist/searchSchema.d.ts.map +1 -1
  38. package/dist/searchSchema.js +102 -50
  39. package/dist/searchSchema.js.map +1 -1
  40. package/dist/session-responses.d.ts +23 -0
  41. package/dist/session-responses.d.ts.map +1 -0
  42. package/dist/session-responses.js +17 -0
  43. package/dist/session-responses.js.map +1 -0
  44. package/dist/strict-schemas.d.ts +8 -0
  45. package/dist/strict-schemas.d.ts.map +1 -0
  46. package/dist/strict-schemas.js +202 -0
  47. package/dist/strict-schemas.js.map +1 -0
  48. package/dist/tools/app-configuration.d.ts +1 -0
  49. package/dist/tools/app-configuration.d.ts.map +1 -1
  50. package/dist/tools/app-configuration.js +1 -0
  51. package/dist/tools/app-configuration.js.map +1 -1
  52. package/dist/tools/apps-catalog.d.ts.map +1 -1
  53. package/dist/tools/apps-catalog.js +11 -5
  54. package/dist/tools/apps-catalog.js.map +1 -1
  55. package/dist/tools/change-listeners.d.ts +2 -0
  56. package/dist/tools/change-listeners.d.ts.map +1 -1
  57. package/dist/tools/change-listeners.js +42 -16
  58. package/dist/tools/change-listeners.js.map +1 -1
  59. package/dist/tools/common-schemas.d.ts +5 -0
  60. package/dist/tools/common-schemas.d.ts.map +1 -1
  61. package/dist/tools/common-schemas.js +13 -0
  62. package/dist/tools/common-schemas.js.map +1 -1
  63. package/dist/tools/csv-export.d.ts +122 -119
  64. package/dist/tools/csv-export.d.ts.map +1 -1
  65. package/dist/tools/csv-export.js +17 -2
  66. package/dist/tools/csv-export.js.map +1 -1
  67. package/dist/tools/enum-providers.d.ts.map +1 -1
  68. package/dist/tools/enum-providers.js +21 -7
  69. package/dist/tools/enum-providers.js.map +1 -1
  70. package/dist/tools/get-operations.d.ts +1 -1
  71. package/dist/tools/get-operations.d.ts.map +1 -1
  72. package/dist/tools/get-operations.js +3 -1
  73. package/dist/tools/get-operations.js.map +1 -1
  74. package/dist/tools/job-scripts.d.ts.map +1 -1
  75. package/dist/tools/job-scripts.js +19 -11
  76. package/dist/tools/job-scripts.js.map +1 -1
  77. package/dist/tools/layout-richstring-widgets.d.ts +2 -2
  78. package/dist/tools/layout-richstring-widgets.d.ts.map +1 -1
  79. package/dist/tools/layout-richstring-widgets.js +16 -6
  80. package/dist/tools/layout-richstring-widgets.js.map +1 -1
  81. package/dist/tools/layout.d.ts +115 -2
  82. package/dist/tools/layout.d.ts.map +1 -1
  83. package/dist/tools/layout.js +39 -14
  84. package/dist/tools/layout.js.map +1 -1
  85. package/dist/tools/linting.d.ts +1 -1
  86. package/dist/tools/linting.js +1 -1
  87. package/dist/tools/linting.js.map +1 -1
  88. package/dist/tools/page-action-simulation.d.ts +51 -1
  89. package/dist/tools/page-action-simulation.d.ts.map +1 -1
  90. package/dist/tools/page-action-simulation.js +2 -2
  91. package/dist/tools/page-action-simulation.js.map +1 -1
  92. package/dist/tools/page-actions.d.ts.map +1 -1
  93. package/dist/tools/page-actions.js +19 -11
  94. package/dist/tools/page-actions.js.map +1 -1
  95. package/dist/tools/pages.d.ts +3 -3
  96. package/dist/tools/pages.d.ts.map +1 -1
  97. package/dist/tools/pages.js +54 -15
  98. package/dist/tools/pages.js.map +1 -1
  99. package/dist/tools/ppt-export-schemas.d.ts +6 -6
  100. package/dist/tools/ppt-export.d.ts +4 -4
  101. package/dist/tools/profile-management.d.ts +4 -0
  102. package/dist/tools/profile-management.d.ts.map +1 -1
  103. package/dist/tools/profile-management.js +6 -4
  104. package/dist/tools/profile-management.js.map +1 -1
  105. package/dist/tools/resource-planner-widget.d.ts +4 -4
  106. package/dist/tools/richstring-widgets.js +3 -3
  107. package/dist/tools/richstring-widgets.js.map +1 -1
  108. package/dist/tools/script.d.ts +25 -2
  109. package/dist/tools/script.d.ts.map +1 -1
  110. package/dist/tools/script.js +5 -4
  111. package/dist/tools/script.js.map +1 -1
  112. package/dist/tools/search.d.ts +142 -122
  113. package/dist/tools/search.d.ts.map +1 -1
  114. package/dist/tools/search.js +71 -23
  115. package/dist/tools/search.js.map +1 -1
  116. package/dist/tools/system.d.ts +2 -1
  117. package/dist/tools/system.d.ts.map +1 -1
  118. package/dist/tools/system.js +2 -2
  119. package/dist/tools/system.js.map +1 -1
  120. package/dist/tools/type-management.d.ts +15 -14
  121. package/dist/tools/type-management.d.ts.map +1 -1
  122. package/dist/tools/type-management.js +168 -51
  123. package/dist/tools/type-management.js.map +1 -1
  124. package/dist/tools/validators.d.ts +1 -1
  125. package/dist/tools/validators.d.ts.map +1 -1
  126. package/dist/tools/validators.js +24 -8
  127. package/dist/tools/validators.js.map +1 -1
  128. package/dist/tools/version-check.d.ts +3 -2
  129. package/dist/tools/version-check.d.ts.map +1 -1
  130. package/dist/tools/version-check.js +39 -101
  131. package/dist/tools/version-check.js.map +1 -1
  132. package/dist/tools/widget-simulation-legacy.d.ts +50 -0
  133. package/dist/tools/widget-simulation-legacy.d.ts.map +1 -0
  134. package/dist/tools/widget-simulation-legacy.js +99 -0
  135. package/dist/tools/widget-simulation-legacy.js.map +1 -0
  136. package/dist/tools/widget-simulation.d.ts +1 -0
  137. package/dist/tools/widget-simulation.d.ts.map +1 -1
  138. package/dist/tools/widget-simulation.js +3 -1
  139. package/dist/tools/widget-simulation.js.map +1 -1
  140. package/dist/tools/wizards.d.ts.map +1 -1
  141. package/dist/tools/wizards.js +3 -2
  142. package/dist/tools/wizards.js.map +1 -1
  143. package/dist/tools/workflow-execution.d.ts +1 -0
  144. package/dist/tools/workflow-execution.d.ts.map +1 -1
  145. package/dist/tools/workflow-execution.js +5 -1
  146. package/dist/tools/workflow-execution.js.map +1 -1
  147. package/dist/tools/workflow-scripts.d.ts +2 -2
  148. package/dist/tools/workflow-scripts.d.ts.map +1 -1
  149. package/dist/tools/workflow-scripts.js +21 -11
  150. package/dist/tools/workflow-scripts.js.map +1 -1
  151. package/dist/tools/workflow.d.ts +5 -2
  152. package/dist/tools/workflow.d.ts.map +1 -1
  153. package/dist/tools/workflow.js +26 -3
  154. package/dist/tools/workflow.js.map +1 -1
  155. package/dist/tools/workspace-core.d.ts +3 -2
  156. package/dist/tools/workspace-core.d.ts.map +1 -1
  157. package/dist/tools/workspace-core.js +26 -8
  158. package/dist/tools/workspace-core.js.map +1 -1
  159. package/dist/utils.d.ts.map +1 -1
  160. package/dist/utils.js +17 -0
  161. package/dist/utils.js.map +1 -1
  162. package/package.json +4 -4
package/README.md CHANGED
@@ -12,25 +12,46 @@ A hosted MCP server is available at [mcp.cplace.com](https://mcp.cplace.com/). T
12
12
 
13
13
  #### Claude Code
14
14
  ```bash
15
- claude mcp add --transport http cplace https://mcp.cplace.com --header "cplace-url: https://${CPLACE_PROJECT_API_TOKEN}@base.cplace.io"
15
+ claude mcp add --transport http cplace-base https://mcp.cplace.com --header "cplace-url: https://${CPLACE_PROJECT_API_TOKEN}@base.cplace.io"
16
16
  ```
17
17
 
18
+ The name you register (`cplace-base` here) becomes part of every tool name, as in `mcp__cplace-base__cplace_search_pages`. Skills in the cplace marketplace expect `cplace-base` for base.cplace.io. For any other instance, pick one name per instance, such as `cplace-dev` for a project's dev instance.
19
+
18
20
  You can optionally choose which tool profiles to load for the connection with a `cplace-profiles` header (HTTP/remote only). It uses the same value grammar as `--profiles=` and is read only when the connection is established (reconnect to change it):
19
21
 
20
22
  ```bash
21
23
  # Load core + types-write + low-code
22
- claude mcp add --transport http cplace https://mcp.cplace.com \
24
+ claude mcp add --transport http cplace-base https://mcp.cplace.com \
23
25
  --header "cplace-url: https://${CPLACE_PROJECT_API_TOKEN}@base.cplace.io" \
24
26
  --header "cplace-profiles: types-write+low-code"
25
27
 
26
28
  # Load all available profiles
27
- claude mcp add --transport http cplace https://mcp.cplace.com \
29
+ claude mcp add --transport http cplace-base https://mcp.cplace.com \
28
30
  --header "cplace-url: https://${CPLACE_PROJECT_API_TOKEN}@base.cplace.io" \
29
31
  --header "cplace-profiles: all"
30
32
  ```
31
33
 
32
34
  When set, the `cplace-profiles` header takes precedence over any saved preference for that token+tenant. If omitted (or empty), the server falls back to the stored preference, then `--profiles=`, then the `core` default. See [Profile Resolution Priority](#profile-resolution-priority).
33
35
 
36
+ #### Strict input schemas (OpenAI strict-mode gateways)
37
+
38
+ Some gateways, such as those that call OpenAI models in strict mode, refuse tool schemas with optional parameters or open objects. For them, send the `cplace-schemas: strict` header (or start a local server with `--schemas=strict`). Like `cplace-profiles`, it is read only when the connection is established.
39
+
40
+ ```bash
41
+ claude mcp add --transport http cplace-base https://mcp.cplace.com \
42
+ --header "cplace-url: https://${CPLACE_PROJECT_API_TOKEN}@base.cplace.io" \
43
+ --header "cplace-schemas: strict"
44
+ ```
45
+
46
+ In such a connection every parameter is listed as required:
47
+
48
+ - An unused parameter is sent as `null`.
49
+ - A map, such as localized names, is a list of `{"key": …, "value": …}` entries.
50
+ - A value of any shape, such as page attributes, is a string holding JSON.
51
+ - Limits and defaults are stated in the parameter description.
52
+
53
+ The tools behave the same as in a standard connection. Without the header, nothing changes.
54
+
34
55
  #### Claude Desktop
35
56
 
36
57
  Claude Desktop cannot connect to the remote server directly: its connector UI supports only authless or OAuth servers, and the cplace MCP server authenticates via custom headers (`cplace-url`, `cplace-api-token`). Use the [local installation](#local-installation-alternative) below, or bridge the remote server with `mcp-remote`:
@@ -38,7 +59,7 @@ Claude Desktop cannot connect to the remote server directly: its connector UI su
38
59
  ```json
39
60
  {
40
61
  "mcpServers": {
41
- "cplace": {
62
+ "cplace-your-instance": {
42
63
  "command": "npx",
43
64
  "args": [
44
65
  "-y", "mcp-remote", "https://mcp.cplace.com/mcp",
@@ -62,7 +83,7 @@ By default, only the core tools are loaded. Add this entry to your Claude Deskto
62
83
  ```json
63
84
  {
64
85
  "mcpServers": {
65
- "cplace": {
86
+ "cplace-your-instance": {
66
87
  "command": "npx",
67
88
  "args": ["-y", "@cplace/mcp-server@latest"],
68
89
  "env": {
@@ -78,7 +99,7 @@ By default, only the core tools are loaded. Add this entry to your Claude Deskto
78
99
  ```json
79
100
  {
80
101
  "mcpServers": {
81
- "cplace": {
102
+ "cplace-your-instance": {
82
103
  "command": "npx",
83
104
  "args": ["-y", "@cplace/mcp-server@latest"],
84
105
  "env": {
@@ -95,7 +116,7 @@ Claude Code has built-in Tool Search that defers tool loading until needed, so t
95
116
 
96
117
  **Option 1: Separate credentials**
97
118
  ```bash
98
- claude mcp add cplace \
119
+ claude mcp add cplace-your-instance \
99
120
  --env CPLACE_URL=https://your-cplace-instance.com/your-tenant \
100
121
  --env API_TOKEN=your-api-token \
101
122
  -- npx -y @cplace/mcp-server@latest --profiles=all
@@ -103,7 +124,7 @@ claude mcp add cplace \
103
124
 
104
125
  **Option 2: URL-embedded credentials**
105
126
  ```bash
106
- claude mcp add cplace \
127
+ claude mcp add cplace-your-instance \
107
128
  --env CPLACE_URL=https://your-api-token@your-cplace-instance.com/your-tenant \
108
129
  -- npx -y @cplace/mcp-server@latest --profiles=all
109
130
  ```
@@ -174,11 +195,7 @@ The following configuration properties must be set for API Token authentication
174
195
 
175
196
  ## Usage
176
197
 
177
- 1. Obtain an API Token for your cplace system (see [cplace documentation](https://docs.cplace.io/lowcode/low-code-cli/authentication/))
178
- * Navigate to your user profile in cplace
179
- * Click on "Action" -> "View my API Tokens" ![api-tokens.png](api-tokens.png)
180
- * Create a new API Token
181
- * Copy the token value ![copy-token.png](copy-token.png)
198
+ 1. In your cplace user profile, create an API token and copy the token value. The value is shown only once. For instructions, see ["API Tokens"](https://kb.cplace.com/user-manual/using-cplace/changing-user-settings/api-tokens) in the cplace user manual. For how the MCP server uses the token, see ["Configuration"](https://kb.cplace.com/cplace-mcp-server/configuration).
182
199
  2. Configure your credentials (see Installation section above)
183
200
  3. If Claude Desktop is running, close it
184
201
  4. Add the MCP server configuration to Claude Desktop
@@ -186,108 +203,18 @@ The following configuration properties must be set for API Token authentication
186
203
 
187
204
  ## Version Compatibility
188
205
 
189
- The MCP server and the cplace backend plugin ([cplace-mcp-endpoints](https://github.com/collaborationFactory/cplace-mcp-endpoints)) must be synchronized to work correctly. Version mismatches can occur when either component is upgraded independently.
190
-
191
- The pairing rule is simple: **MCP server `x.y.*` pairs with backend `x.y`.** Patch releases of the MCP server never require a backend update; a release that needs backend changes bumps the minor version on both sides together. The cplace release line (25.4, 26.1, ...) does not determine compatibility — the build date of your deployment does.
206
+ `@latest` works against every backend from cplace-mcp-endpoints 1.12 up. You do not need to pick a server version for your backend. The server reads what the backend can do when the session starts and offers only the tools it supports.
192
207
 
193
- See [COMPATIBILITY.md](COMPATIBILITY.md) for the full compatibility matrix: which backend version is in which cplace builds, per release line.
208
+ A backend below 1.12 is refused at startup. The message names the server line to pin, for example `@cplace/mcp-server@1.11`. Use it as shown in [Installing a Specific Version](#installing-a-specific-version), or upgrade the backend.
194
209
 
195
- ### Checking Version Compatibility
196
-
197
- Ask Claude to check version compatibility:
210
+ To see what your backend supports, ask Claude:
198
211
  ```
199
212
  Check the version compatibility between the MCP server and the cplace backend
200
213
  ```
201
214
 
202
- Claude will internally use the `cplace_check_version_compatibility` tool to perform the check.
203
-
204
- ### Understanding the Results
205
-
206
- Claude will report one of these outcomes:
207
-
208
- #### ✅ Compatible
209
-
210
- Your MCP server package version matches what the backend expects. Everything is working correctly, and no action is needed.
211
-
212
- #### ⚠️ Version Mismatch
213
-
214
- The versions don't match. There are two possible scenarios:
215
-
216
- ##### Scenario 1: MCP Server Newer Than Backend
217
-
218
- ```
219
- ⚠️ Version Mismatch Detected
220
-
221
- Your MCP server package is newer than what the cplace backend currently supports:
222
-
223
- - Your MCP server package version: 1.0.5
224
- - Backend expects version: 1.0.2
225
- ```
226
-
227
- **What This Means:** The cplace backend hasn't been upgraded yet to support features in your MCP server package version. This could lead to unexpected behavior or errors when using certain tools.
228
-
229
- **Resolution Options:**
230
-
231
- **Option A: Downgrade MCP Server (Recommended for Local Installations)**
232
-
233
- If you're using a local MCP server installation, you can downgrade to match the backend version. Follow the instructions in the [Installing a Specific Version](#installing-a-specific-version) section above to install version `1.0.2` (the version your backend expects).
234
-
235
- Example for Claude Desktop:
236
- ```json
237
- {
238
- "mcpServers": {
239
- "cplace": {
240
- "command": "npx",
241
- "args": ["-y", "@cplace/mcp-server@1.0.2"],
242
- "env": {
243
- "CPLACE_URL": "https://your-cplace-instance.com/your-tenant",
244
- "API_TOKEN": "your-api-token"
245
- }
246
- }
247
- }
248
- }
249
- ```
250
-
251
- After updating the configuration, close and reopen Claude Desktop, then run the version check again to confirm compatibility.
252
-
253
- **Option B: Upgrade Backend**
254
-
255
- Contact your cplace administrator to upgrade the backend deployment to the latest version.
256
-
257
- ##### Scenario 2: Backend Newer Than MCP Server
258
-
259
- ```
260
- ⚠️ Version Mismatch Detected
261
-
262
- Your cplace backend has been upgraded and now expects a newer package version:
263
-
264
- - Your MCP server package version: 1.0.2
265
- - Backend expects version: 1.0.5
266
- ```
267
-
268
- **What This Means:** The backend has been upgraded with new features that require a newer MCP server package version.
269
-
270
- **Resolution:**
271
-
272
- The MCP server will automatically upgrade to the latest version on the next restart when using `@latest`. If you're using a version-pinned installation (e.g., `@1.0.2`), update your configuration to either specify the new version or use `@latest` to always fetch the newest version:
273
-
274
- Example for Claude Desktop (auto-upgrade to latest):
275
- ```json
276
- {
277
- "mcpServers": {
278
- "cplace": {
279
- "command": "npx",
280
- "args": ["-y", "@cplace/mcp-server@latest"],
281
- "env": {
282
- "CPLACE_URL": "https://your-cplace-instance.com/your-tenant",
283
- "API_TOKEN": "your-api-token"
284
- }
285
- }
286
- }
287
- }
288
- ```
215
+ Claude runs `cplace_check_version_compatibility`. It reports whether the backend is supported, the capabilities it found, and the tools and parameters it left out for this backend.
289
216
 
290
- Close and reopen Claude Desktop to apply the changes, then run the version check again to confirm compatibility.
217
+ See [COMPATIBILITY.md](COMPATIBILITY.md) for the rules and the capability table.
291
218
 
292
219
  ## Changing the cplace System
293
220
 
@@ -401,7 +328,7 @@ These tools are always registered regardless of which profiles are active.
401
328
 
402
329
  **Utilities:**
403
330
  - `cplace_get_icon_names` - Get all available icon names in the cplace system (FontAwesome, cplace custom, HUI utility icons)
404
- - `cplace_check_version_compatibility` - Check version compatibility between the MCP server and the cplace backend API
331
+ - `cplace_check_version_compatibility` - Check whether this server supports the connected cplace backend, and which tools and parameters it left out for it
405
332
 
406
333
  **Apps Catalog:**
407
334
  - `cplace_list_apps_catalog` - List all apps in the cplace apps catalog with their overview, dependencies, and investigation status
@@ -416,7 +343,7 @@ Essential operations including workspace navigation, page CRUD operations, searc
416
343
  **Workspace Management:**
417
344
  - `cplace_list_workspaces` - Get all workspaces with essential properties
418
345
  - `cplace_get_workspace_details` - Get comprehensive details about a specific workspace including all metadata, permissions, type definitions, styling, and configuration
419
- - `cplace_list_types` - List all types available in a workspace
346
+ - `cplace_list_types` - List the types available in a workspace, optionally only those whose name contains a text (`nameContains`)
420
347
  - `cplace_get_type_datamodel` - Get the datamodel of a type including its attributes, constraints, and permissions
421
348
 
422
349
  **Page Operations:**
@@ -2,7 +2,7 @@ import type { CplaceApiClient, VersionApiResponse } from './api.js';
2
2
  export declare const FLOOR_LABEL = "1.12";
3
3
  export declare const FROZEN_LABEL = "1.17";
4
4
  export declare const DETECTION_TIMEOUT_MS = 5000;
5
- export type Capability = 'decoded-widget-v1' | 'workflow.guards-enforced' | 'script.nested-results' | 'constraint.clear' | 'workflow.state-before-scripts' | 'layout.keep-inherited-widgets' | 'app-configuration.read' | 'change-listener.event-types' | 'widget-sim.script-contexts';
5
+ export type Capability = 'decoded-widget-v1' | 'workflow.guards-enforced' | 'script.nested-results' | 'constraint.clear' | 'workflow.state-before-scripts' | 'layout.keep-inherited-widgets' | 'app-configuration.read' | 'change-listener.event-types' | 'widget-sim.script-contexts' | 'workflow.update-keeps-scripts' | 'search.begins-with-prefix' | 'search.failure-reported' | 'layout.validation-warnings' | 'type-definition.update-permissions' | 'layout.remove-unknown-id-fails' | 'layout.script-keeps-widget-ids' | 'search.dropped-filters-rejected' | 'decoded-widget.property-values-validated' | 'reference.update-to-any' | 'constraint.show-in-menu-if-hierarchy' | 'page.package-inclusion' | 'type-definition.default-package-inclusion' | 'constraint.script' | 'constraint.search' | 'workflow.default-state-applied';
6
6
  interface TableEntry {
7
7
  capability: Capability;
8
8
  since: string;
@@ -17,7 +17,20 @@ export interface BackendSnapshot {
17
17
  capabilities: ReadonlySet<string>;
18
18
  belowFloor: boolean;
19
19
  }
20
+ export declare function labelGte(a: string, b: string): boolean;
20
21
  export declare function computeSnapshot(response: VersionApiResponse): BackendSnapshot;
22
+ export declare function belowFloorMessage(snapshot: BackendSnapshot): string;
23
+ export declare class BelowFloorError extends Error {
24
+ constructor(snapshot: BackendSnapshot);
25
+ }
26
+ export declare function floorRefusalBody(error: BelowFloorError): {
27
+ jsonrpc: "2.0";
28
+ error: {
29
+ code: number;
30
+ message: string;
31
+ };
32
+ id: null;
33
+ };
21
34
  export declare class BackendCapabilities {
22
35
  private readonly client;
23
36
  private readonly timeoutMs;
@@ -31,6 +44,7 @@ export declare class BackendCapabilities {
31
44
  static unknown(reason: string): BackendCapabilities;
32
45
  get snapshot(): BackendSnapshot | undefined;
33
46
  get unknownReason(): string | undefined;
47
+ assertAboveFloor(): void;
34
48
  gateHas(capability: Capability): boolean;
35
49
  guardHas(capability: Capability): Promise<boolean>;
36
50
  refreshIfUnknown(): Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"backend-capabilities.d.ts","sourceRoot":"","sources":["../src/backend-capabilities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAWpE,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,MAAM,MAAM,UAAU,GAClB,mBAAmB,GACnB,0BAA0B,GAC1B,uBAAuB,GACvB,kBAAkB,GAClB,+BAA+B,GAC/B,+BAA+B,GAC/B,wBAAwB,GACxB,6BAA6B,GAC7B,4BAA4B,CAAC;AAEjC,UAAU,UAAU;IAClB,UAAU,EAAE,UAAU,CAAC;IAEvB,KAAK,EAAE,MAAM,CAAC;IAEd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAUjD,CAAC;AAOF,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC;CACrB;AAUD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,kBAAkB,GAAG,eAAe,CAwC7E;AAwBD,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,KAAK,CAAC,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAgB;IAEhC,OAAO;WASM,MAAM,CACjB,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAM/B,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB;IAKnD,IAAI,QAAQ,IAAI,eAAe,GAAG,SAAS,CAE1C;IAED,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAGD,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAKlC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAMlD,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAYvC,KAAK,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IASzC,OAAO,CAAC,KAAK;IASb,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAalC"}
1
+ {"version":3,"file":"backend-capabilities.d.ts","sourceRoot":"","sources":["../src/backend-capabilities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAapE,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,MAAM,MAAM,UAAU,GAClB,mBAAmB,GACnB,0BAA0B,GAC1B,uBAAuB,GACvB,kBAAkB,GAClB,+BAA+B,GAC/B,+BAA+B,GAC/B,wBAAwB,GACxB,6BAA6B,GAC7B,4BAA4B,GAC5B,+BAA+B,GAC/B,2BAA2B,GAC3B,yBAAyB,GACzB,4BAA4B,GAC5B,oCAAoC,GACpC,gCAAgC,GAChC,gCAAgC,GAChC,iCAAiC,GACjC,0CAA0C,GAC1C,yBAAyB,GACzB,sCAAsC,GACtC,wBAAwB,GACxB,2CAA2C,GAC3C,mBAAmB,GACnB,mBAAmB,GACnB,gCAAgC,CAAC;AAErC,UAAU,UAAU;IAClB,UAAU,EAAE,UAAU,CAAC;IAEvB,KAAK,EAAE,MAAM,CAAC;IAEd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAWjD,CAAC;AAOF,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC;CACrB;AAGD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAItD;AAGD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,kBAAkB,GAAG,eAAe,CAwC7E;AAGD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAMnE;AAGD,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,QAAQ,EAAE,eAAe;CAItC;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe;;;;;;;EAMtD;AAwBD,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,KAAK,CAAC,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAgB;IAEhC,OAAO;WASM,MAAM,CACjB,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAM/B,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB;IAKnD,IAAI,QAAQ,IAAI,eAAe,GAAG,SAAS,CAE1C;IAED,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAGD,gBAAgB,IAAI,IAAI;IAOxB,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAKlC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAMlD,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAYvC,KAAK,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IASzC,OAAO,CAAC,KAAK;IASb,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAalC"}
@@ -1,4 +1,5 @@
1
1
  import semver from 'semver';
2
+ import { SERVER_VERSION } from './server-identity.js';
2
3
  export const FLOOR_LABEL = '1.12';
3
4
  export const FROZEN_LABEL = '1.17';
4
5
  export const DETECTION_TIMEOUT_MS = 5000;
@@ -12,9 +13,10 @@ export const CAPABILITY_TABLE = [
12
13
  { capability: 'app-configuration.read', since: '1.15' },
13
14
  { capability: 'change-listener.event-types', since: '1.15', platform: '26.2' },
14
15
  { capability: 'widget-sim.script-contexts', since: '1.16' },
16
+ { capability: 'decoded-widget.property-values-validated', since: '1.16' },
15
17
  ];
16
18
  const FLOOR_CAPABILITIES = CAPABILITY_TABLE.filter((entry) => !entry.platform && labelGte(FLOOR_LABEL, entry.since)).map((entry) => entry.capability);
17
- function labelGte(a, b) {
19
+ export function labelGte(a, b) {
18
20
  const left = semver.coerce(a);
19
21
  const right = semver.coerce(b);
20
22
  return !!left && !!right && semver.gte(left, right);
@@ -52,6 +54,24 @@ export function computeSnapshot(response) {
52
54
  belowFloor: !labelGte(label, FLOOR_LABEL),
53
55
  };
54
56
  }
57
+ export function belowFloorMessage(snapshot) {
58
+ return (`This cplace backend reports cplace-mcp-endpoints ${snapshot.label}. ` +
59
+ `@cplace/mcp-server ${SERVER_VERSION} supports backends from ${FLOOR_LABEL} up. ` +
60
+ `Pin the matching server, for example \`npx -y @cplace/mcp-server@${snapshot.label}\`, or upgrade the backend.`);
61
+ }
62
+ export class BelowFloorError extends Error {
63
+ constructor(snapshot) {
64
+ super(belowFloorMessage(snapshot));
65
+ this.name = 'BelowFloorError';
66
+ }
67
+ }
68
+ export function floorRefusalBody(error) {
69
+ return {
70
+ jsonrpc: '2.0',
71
+ error: { code: -32000, message: `Bad Request: ${error.message}` },
72
+ id: null,
73
+ };
74
+ }
55
75
  async function runDetection(client, timeoutMs) {
56
76
  const signal = AbortSignal.timeout(timeoutMs);
57
77
  try {
@@ -89,6 +109,11 @@ export class BackendCapabilities {
89
109
  get unknownReason() {
90
110
  return this.known ? undefined : this.reason;
91
111
  }
112
+ assertAboveFloor() {
113
+ if (this.known?.belowFloor) {
114
+ throw new BelowFloorError(this.known);
115
+ }
116
+ }
92
117
  gateHas(capability) {
93
118
  return this.known ? this.known.capabilities.has(capability) : true;
94
119
  }
@@ -1 +1 @@
1
- {"version":3,"file":"backend-capabilities.js","sourceRoot":"","sources":["../src/backend-capabilities.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"backend-capabilities.js","sourceRoot":"","sources":["../src/backend-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAYtD,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAElC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AAEnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAyCzC,MAAM,CAAC,MAAM,gBAAgB,GAA0B;IACrD,EAAE,UAAU,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE;IACjD,EAAE,UAAU,EAAE,0BAA0B,EAAE,KAAK,EAAE,MAAM,EAAE;IACzD,EAAE,UAAU,EAAE,uBAAuB,EAAE,KAAK,EAAE,MAAM,EAAE;IACtD,EAAE,UAAU,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE;IACjD,EAAE,UAAU,EAAE,+BAA+B,EAAE,KAAK,EAAE,MAAM,EAAE;IAC9D,EAAE,UAAU,EAAE,+BAA+B,EAAE,KAAK,EAAE,MAAM,EAAE;IAC9D,EAAE,UAAU,EAAE,wBAAwB,EAAE,KAAK,EAAE,MAAM,EAAE;IACvD,EAAE,UAAU,EAAE,6BAA6B,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE;IAC9E,EAAE,UAAU,EAAE,4BAA4B,EAAE,KAAK,EAAE,MAAM,EAAE;IAC3D,EAAE,UAAU,EAAE,0CAA0C,EAAE,KAAK,EAAE,MAAM,EAAE;CAC1E,CAAC;AAGF,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,MAAM,CAChD,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CACjE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AAYnC,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC;AAGD,MAAM,UAAU,eAAe,CAAC,QAA4B;IAC1D,MAAM,UAAU,GAAG,QAAQ,EAAE,UAAU,CAAC;IACxC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,oDAAoD,UAAU,GAAG,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;IAC1C,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC;IAEjD,IAAI,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO;YACL,UAAU;YACV,KAAK;YACL,eAAe;YACf,MAAM,EAAE,MAAM;YACd,YAAY;YACZ,UAAU,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACjE,CAAC;IACJ,CAAC;IAGD,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,gBAAgB,CAAC,MAAM,CACrB,CAAC,KAAK,EAAE,EAAE,CACR,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;QAC5B,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CACxF,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CACnC,CAAC;IACF,OAAO;QACL,UAAU;QACV,KAAK;QACL,eAAe;QACf,MAAM,EAAE,OAAO;QACf,YAAY;QACZ,UAAU,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;KAC1C,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,iBAAiB,CAAC,QAAyB;IACzD,OAAO,CACL,oDAAoD,QAAQ,CAAC,KAAK,IAAI;QACtE,sBAAsB,cAAc,2BAA2B,WAAW,OAAO;QACjF,oEAAoE,QAAQ,CAAC,KAAK,6BAA6B,CAChH,CAAC;AACJ,CAAC;AAGD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,QAAyB;QACnC,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAGD,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,OAAO;QACL,OAAO,EAAE,KAAc;QACvB,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,gBAAgB,KAAK,CAAC,OAAO,EAAE,EAAE;QACjE,EAAE,EAAE,IAAI;KACT,CAAC;AACJ,CAAC;AAID,KAAK,UAAU,YAAY,CAAC,MAAuB,EAAE,SAAiB;IACpE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAC1C,cAAc,EACd,KAAK,EACL,SAAS,EACT,SAAS,EACT,MAAM,CACP,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,sCAAsC,SAAS,KAAK,EAAE,CAAC;QAC1E,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC;AAGD,MAAM,OAAO,mBAAmB;IAMX;IACA;IANX,KAAK,CAAmB;IACxB,MAAM,CAAU;IAChB,OAAO,CAAiB;IAEhC,YACmB,MAAmC,EACnC,SAAiB,EAClC,KAAsB;QAFL,WAAM,GAAN,MAAM,CAA6B;QACnC,cAAS,GAAT,SAAS,CAAQ;QAGlC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAGD,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,MAAuB,EACvB,IAA6B;QAE7B,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,oBAAoB,CAAC;QAC1D,OAAO,IAAI,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC3F,CAAC;IAGD,MAAM,CAAC,OAAO,CAAC,MAAc;QAC3B,OAAO,IAAI,mBAAmB,CAAC,SAAS,EAAE,oBAAoB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IAGD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9C,CAAC;IAGD,gBAAgB;QACd,IAAI,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;YAC3B,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAGD,OAAO,CAAC,UAAsB;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,CAAC;IAGD,KAAK,CAAC,QAAQ,CAAC,UAAsB;QACnC,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;IAC3D,CAAC;IAGD,KAAK,CAAC,gBAAgB;QACpB,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEvC,IAAI,CAAC,OAAO,KAAK,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;aACvD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;aACpC,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QAC3B,CAAC,CAAC,CAAC;QACL,MAAM,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAGD,KAAK,CAAC,QAA4B;QAChC,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,KAAsB;QAClC,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC7B,CAAC;IACH,CAAC;IAGD,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;YACvB,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe;YAC3C,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE;YACjD,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;YACjC,KAAK,EAAE,WAAW;SACnB,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,35 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { type ZodRawShape, type ZodTypeAny } from 'zod';
3
+ import type { BackendCapabilities, Capability } from './backend-capabilities.js';
4
+ import { type InputSchemaMode } from './strict-schemas.js';
5
+ export declare function requires<T extends ZodTypeAny>(schema: T, capability: Capability): T;
6
+ export declare function ifCap(capability: Capability, text: string): string;
7
+ export declare function ifNoCap(capability: Capability, text: string): string;
8
+ export declare function resolveText(text: string, has: (capability: string) => boolean): string;
9
+ export declare function resolveShape(shape: ZodRawShape, has: (capability: string) => boolean): {
10
+ shape: ZodRawShape;
11
+ dropped: string[];
12
+ };
13
+ export interface Guard {
14
+ capability: Capability;
15
+ refuse(args: any, backend: BackendCapabilities): string | undefined;
16
+ }
17
+ export interface GatingDeclarations {
18
+ requires?: Capability;
19
+ unless?: Capability;
20
+ guards?: readonly Guard[];
21
+ }
22
+ export declare function backendHas(backend: BackendCapabilities): (capability: string) => boolean;
23
+ export declare function isOffered(config: GatingDeclarations, has: (capability: string) => boolean): boolean;
24
+ export interface GatingReport {
25
+ gatedTools: string[];
26
+ gatedParameters: string[];
27
+ }
28
+ export declare function backendName(backend: BackendCapabilities): string;
29
+ export declare function gateServer(server: McpServer, backend: BackendCapabilities, options?: {
30
+ inputSchemas?: InputSchemaMode;
31
+ }): {
32
+ server: McpServer;
33
+ report: GatingReport;
34
+ };
35
+ //# sourceMappingURL=capability-gating.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capability-gating.d.ts","sourceRoot":"","sources":["../src/capability-gating.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAK,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AA6B7B,wBAAgB,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,GAAG,CAAC,CAGnF;AAGD,wBAAgB,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE;AAGD,wBAAgB,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE;AAKD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAItF;AAsED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GACnC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAG3C;AAED,MAAM,WAAW,KAAK;IAEpB,UAAU,EAAE,UAAU,CAAC;IAEvB,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAAC;CACrE;AAGD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CAC3B;AAGD,wBAAgB,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAExF;AAUD,wBAAgB,SAAS,CACvB,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GACnC,OAAO,CAET;AAGD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAGD,wBAAgB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAGhE;AAqDD,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,eAAe,CAAA;CAAO,GAC/C;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAmD7C"}
@@ -0,0 +1,169 @@
1
+ import { z } from 'zod';
2
+ import { fromStrictArguments, StrictArgumentError, toStrictSchema, } from './strict-schemas.js';
3
+ const requiredBySchema = new WeakMap();
4
+ export function requires(schema, capability) {
5
+ requiredBySchema.set(schema, capability);
6
+ return schema;
7
+ }
8
+ export function ifCap(capability, text) {
9
+ return `⟦+${capability}⟧${text}⟦/⟧`;
10
+ }
11
+ export function ifNoCap(capability, text) {
12
+ return `⟦-${capability}⟧${text}⟦/⟧`;
13
+ }
14
+ const MARKER = /⟦([+-])([^⟧]+)⟧([\s\S]*?)⟦\/⟧/g;
15
+ export function resolveText(text, has) {
16
+ return text.replace(MARKER, (_match, sign, capability, body) => (sign === '+') === has(capability) ? body : '');
17
+ }
18
+ const CHILD_KEY = {
19
+ ZodOptional: 'innerType',
20
+ ZodNullable: 'innerType',
21
+ ZodDefault: 'innerType',
22
+ ZodArray: 'type',
23
+ ZodEffects: 'schema',
24
+ };
25
+ function rebuild(node, def) {
26
+ const Ctor = node.constructor;
27
+ return new Ctor({ ...node._def, ...def });
28
+ }
29
+ function resolveNode(node, has, path, dropped) {
30
+ const description = node._def.description;
31
+ const resolved = description === undefined ? undefined : resolveText(description, has);
32
+ const changes = {};
33
+ const typeName = node._def.typeName;
34
+ const childKey = CHILD_KEY[typeName];
35
+ if (childKey) {
36
+ const child = node._def[childKey];
37
+ const next = resolveNode(child, has, path, dropped);
38
+ if (next !== child)
39
+ changes[childKey] = next;
40
+ }
41
+ else if (typeName === 'ZodObject') {
42
+ const shape = node.shape;
43
+ const before = dropped.length;
44
+ const next = resolveShapeAt(shape, has, `${path}.`, dropped);
45
+ if (next !== shape)
46
+ changes.shape = () => next;
47
+ if (dropped.length > before)
48
+ changes.unknownKeys = 'strict';
49
+ }
50
+ if (resolved !== description)
51
+ changes.description = resolved;
52
+ return Object.keys(changes).length > 0 ? rebuild(node, changes) : node;
53
+ }
54
+ function resolveShapeAt(shape, has, prefix, dropped) {
55
+ let changed = false;
56
+ const next = {};
57
+ for (const [key, schema] of Object.entries(shape)) {
58
+ const capability = requiredBySchema.get(schema);
59
+ if (capability && !has(capability)) {
60
+ dropped.push(`${prefix}${key}`);
61
+ changed = true;
62
+ continue;
63
+ }
64
+ const resolved = resolveNode(schema, has, `${prefix}${key}`, dropped);
65
+ if (resolved !== schema)
66
+ changed = true;
67
+ next[key] = resolved;
68
+ }
69
+ return changed ? next : shape;
70
+ }
71
+ export function resolveShape(shape, has) {
72
+ const dropped = [];
73
+ return { shape: resolveShapeAt(shape, has, '', dropped), dropped };
74
+ }
75
+ export function backendHas(backend) {
76
+ return (capability) => backend.gateHas(capability);
77
+ }
78
+ function lacksRequirement(config, has) {
79
+ return !!config.requires && !has(config.requires);
80
+ }
81
+ export function isOffered(config, has) {
82
+ return !(config.unless && has(config.unless)) && !lacksRequirement(config, has);
83
+ }
84
+ export function backendName(backend) {
85
+ const label = backend.snapshot?.label;
86
+ return label ? `Backend ${label}` : 'This backend';
87
+ }
88
+ function errorResult(text) {
89
+ return { content: [{ type: 'text', text }], isError: true };
90
+ }
91
+ function guardHandler(guards, backend, handler) {
92
+ return async (...callArgs) => {
93
+ for (const guard of guards) {
94
+ if (await backend.guardHas(guard.capability))
95
+ continue;
96
+ const message = guard.refuse(callArgs[0], backend);
97
+ if (message === undefined)
98
+ continue;
99
+ const reason = backend.unknownReason;
100
+ return errorResult(reason === undefined
101
+ ? message
102
+ : `Backend detection failed (${reason}), so this server treats the backend as lacking ${guard.capability}. ${message}`);
103
+ }
104
+ return handler(...callArgs);
105
+ };
106
+ }
107
+ function invalidArguments(name, message) {
108
+ return errorResult(`Input validation error: Invalid arguments for tool ${name}: ${message}`);
109
+ }
110
+ function strictHandler(name, original, handler) {
111
+ return async (args, ...rest) => {
112
+ let mapped;
113
+ try {
114
+ mapped = fromStrictArguments(args ?? {}, original);
115
+ }
116
+ catch (error) {
117
+ if (error instanceof StrictArgumentError)
118
+ return invalidArguments(name, error.message);
119
+ throw error;
120
+ }
121
+ const parsed = await original.safeParseAsync(mapped);
122
+ if (!parsed.success)
123
+ return invalidArguments(name, parsed.error.message);
124
+ return handler(parsed.data, ...rest);
125
+ };
126
+ }
127
+ export function gateServer(server, backend, options = {}) {
128
+ const report = { gatedTools: [], gatedParameters: [] };
129
+ const registered = new Set();
130
+ const has = backendHas(backend);
131
+ const registerTool = (name, config, handler) => {
132
+ const { requires: required, unless, guards, ...rest } = config;
133
+ if (!isOffered({ requires: required, unless }, has)) {
134
+ if (lacksRequirement({ requires: required }, has) && !registered.has(name)) {
135
+ report.gatedTools.push(name);
136
+ }
137
+ return undefined;
138
+ }
139
+ const next = { ...rest };
140
+ if (typeof rest.description === 'string')
141
+ next.description = resolveText(rest.description, has);
142
+ let run = guards?.length ? guardHandler(guards, backend, handler) : handler;
143
+ if (rest.inputSchema) {
144
+ const { shape, dropped } = resolveShape(rest.inputSchema, has);
145
+ const original = z.object(shape).strict();
146
+ if (options.inputSchemas === 'strict') {
147
+ next.inputSchema = toStrictSchema(shape, name);
148
+ run = strictHandler(name, original, run);
149
+ }
150
+ else {
151
+ next.inputSchema = original;
152
+ }
153
+ report.gatedParameters.push(...dropped.map((key) => `${name}.${key}`));
154
+ }
155
+ registered.add(name);
156
+ report.gatedTools = report.gatedTools.filter((tool) => tool !== name);
157
+ return server.registerTool(name, next, run);
158
+ };
159
+ const gated = new Proxy(server, {
160
+ get(target, property) {
161
+ if (property === 'registerTool')
162
+ return registerTool;
163
+ const value = Reflect.get(target, property, target);
164
+ return typeof value === 'function' ? value.bind(target) : value;
165
+ },
166
+ });
167
+ return { server: gated, report };
168
+ }
169
+ //# sourceMappingURL=capability-gating.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capability-gating.js","sourceRoot":"","sources":["../src/capability-gating.ts"],"names":[],"mappings":"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"}