genexus-mcp 1.3.1 → 2.0.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.
- package/README.md +13 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -103,13 +103,17 @@ Notes:
|
|
|
103
103
|
## 🛠️ Tool Surface (Skills)
|
|
104
104
|
*(See `GEMINI.md` for extended guidelines).* The worker natively exposes the following tools to the MCP Router:
|
|
105
105
|
|
|
106
|
-
- **Search & Discovery**: `genexus_query`, `genexus_read`, `
|
|
107
|
-
- **Editing & Architecture**: `genexus_edit`, `
|
|
106
|
+
- **Search & Discovery**: `genexus_query`, `genexus_read`, `genexus_inspect`, `genexus_list_objects`, `genexus_properties`
|
|
107
|
+
- **Editing & Architecture**: `genexus_edit`, `genexus_create_object`, `genexus_refactor`, `genexus_forge`
|
|
108
108
|
- **Analysis:** `genexus_analyze`, `genexus_inject_context`, `genexus_doc`, `genexus_explain_code`, `genexus_summarize`
|
|
109
109
|
- **File System & Assets**: `genexus_asset`, `genexus_export_object`, `genexus_import_object`
|
|
110
110
|
- **History & DB**: `genexus_history`, `genexus_get_sql`, `genexus_structure`
|
|
111
111
|
- **Native Layout SDK**: `genexus_layout` (`get_tree`, `find_controls`, `set_property`, `set_properties`, `rename_printblock`, `add_printblock`, `get_preview`, `scan_mutators`)
|
|
112
112
|
|
|
113
|
+
> **`genexus_edit` modes:** `xml` (default — full XML replacement), `ops` (typed semantic op catalog: `set_attribute`, `add_attribute`, `remove_attribute`, `add_rule`, `remove_rule`, `set_property`), `patch` (JSON-Patch RFC 6902 array over canonical JSON object; legacy string-form patch also accepted for backward compatibility).
|
|
114
|
+
>
|
|
115
|
+
> **All write tools** accept `dryRun: true` (returns a preview `plan` envelope without mutating the KB) and `idempotencyKey` (safe retries — concurrent calls with same key are coalesced; results cached for 15 min by default).
|
|
116
|
+
|
|
113
117
|
Layout color note:
|
|
114
118
|
- For `ForeColor`, `BackColor`, `BorderColor`, send color values as palette names (`Black`, `Blue`, `Red`, `Transparent`) or RGB token (`R; G; B|`) to avoid nested SDK wrappers.
|
|
115
119
|
- **Lifecycle & Build**: `genexus_lifecycle`, `genexus_test`, `genexus_format`
|
|
@@ -119,10 +123,14 @@ Layout color note:
|
|
|
119
123
|
|
|
120
124
|
For `tools/call`, the gateway keeps MCP compatibility and adds lightweight response metadata:
|
|
121
125
|
|
|
122
|
-
- `
|
|
123
|
-
- `
|
|
126
|
+
- `_meta.schemaVersion` currently `mcp-axi/2`
|
|
127
|
+
- `_meta.tool` with the normalized tool name
|
|
124
128
|
- collection helpers such as `returned`, `total`, `empty`, and (when inferable) `hasMore` and `nextOffset`
|
|
125
|
-
- truncation signals via `
|
|
129
|
+
- truncation signals via `_meta.truncated` plus contextual `help`
|
|
130
|
+
- `_meta.idempotent: true` on cache-hit responses
|
|
131
|
+
- `_meta.batched: true` on `targets[]` multi-object responses
|
|
132
|
+
- `_meta.dryRun: true` on dry-run preview responses
|
|
133
|
+
- `_meta.removedTools` advertised on `initialize` for proactive agent detection of removed tools
|
|
126
134
|
|
|
127
135
|
For list-heavy calls (`genexus_query`, `genexus_list_objects`), optional arguments can reduce token usage:
|
|
128
136
|
|