arc-1 1.4.0 → 1.5.0

package/dist/handlers/syntax.js

@@ -0,0 +1,35 @@
+import { syntaxCheck } from '../adt/devtools.js';
+import { normalizeObjectType, objectUrlForType } from './object-types.js';
+import { textResult, toolJson } from './shared.js';
+/** Shared wire and result contract for both syntax-check entry points. */
+export async function handleSyntaxCheck(client, args) {
+    const type = normalizeObjectType(String(args.type ?? ''));
+    const name = String(args.name ?? '');
+    const objectUrl = objectUrlForType(type, name);
+    const version = args.version === 'inactive' ? 'inactive' : args.version === 'active' ? 'active' : undefined;
+    const content = typeof args.source === 'string' ? args.source : undefined;
+    const opts = {};
+    if (version)
+        opts.version = version;
+    if (content !== undefined)
+        opts.content = content;
+    const result = await syntaxCheck(client.http, client.safety, objectUrl, Object.keys(opts).length > 0 ? opts : undefined);
+    // Fail closed: SAP checked nothing (object does not exist yet) → never report "clean", or
+    // callers read hasErrors:false as "SAP will accept this source".
+    if (!result.checked) {
+        return textResult(toolJson({
+            ...result,
+            hasErrors: true,
+            messages: [
+                {
+                    severity: 'error',
+                    text: `Not checked — ${(result.statusText || 'SAP did not process this check').replace(/\.$/, '')}. The source was NOT validated; create the object first (SAPWrite action="create"), then re-run the syntax check.`,
+                    line: 0,
+                    column: 0,
+                },
+            ],
+        }));
+    }
+    return textResult(toolJson(result));
+}
+//# sourceMappingURL=syntax.js.map

package/dist/handlers/syntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.js","sourceRoot":"","sources":["../../src/handlers/syntax.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAmB,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEpE,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAiB,EAAE,IAA6B;IACtF,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5G,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,MAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,MAAM,IAAI,GAA0D,EAAE,CAAC;IACvE,IAAI,OAAO;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACpC,IAAI,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,MAAM,EACb,SAAS,EACT,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAChD,CAAC;IACF,0FAA0F;IAC1F,iEAAiE;IACjE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,UAAU,CACf,QAAQ,CAAC;YACP,GAAG,MAAM;YACT,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE;gBACR;oBACE,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,UAAU,IAAI,gCAAgC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mHAAmH;oBACpN,IAAI,EAAE,CAAC;oBACP,MAAM,EAAE,CAAC;iBACV;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/handlers/tool-descriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-descriptions.d.ts","sourceRoot":"","sources":["../../src/handlers/tool-descriptions.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAwDvG,eAAO,MAAM,oBAAoB,QAAwE,CAAC;AAC1G,eAAO,MAAM,iBAAiB,QAAqE,CAAC"}
+{"version":3,"file":"tool-descriptions.d.ts","sourceRoot":"","sources":["../../src/handlers/tool-descriptions.ts"],"names":[],"mappings":"AAAA,uGAAuG;AA0DvG,eAAO,MAAM,oBAAoB,QAAwE,CAAC;AAC1G,eAAO,MAAM,iBAAiB,QAAqE,CAAC"}

package/dist/handlers/tool-descriptions.js

@@ -10,10 +10,11 @@
 const SAPWRITE_LEAD = 'Change ABAP objects in the SAP system: create, update, delete, and targeted source edits. Use it ' +
     'when the request is to PERSIST a change — write, add, implement, refactor, or remove ABAP code ' +
     'or DDIC metadata. Reading is SAPRead; searching is SAPSearch; dependency analysis is SAPContext; ' +
-    'checking or formatting source without saving it is SAPLint or SAPDiagnose. ';
+    'local lint/formatting is SAPLint; SAP syntax checks use SAPRead(type="SYNTAX"). ';
 const SAPWRITE_BODY_ONPREM = 
 // The purpose and supported types already live in SAPWRITE_LEAD and the type property.
 'Handles lock/modify/unlock automatically. TTYP needs rowType + optional rowTypeKind. ' +
+    'ENQU: SAPRead JSON in source; create needs primaryTable. Entries need explicit lockMode/parameterWanted; update refuses lockParameters=[]. Then SAPActivate. ' +
     'Type codes are auto-normalized and case-insensitive (e.g., "CLAS/OC" → "CLAS"). For delete, only type and name are required (plus optional transport). ' +
     'Source objects (PROG/CLAS/INTF/DDLS/DCLS/DDLX/BDEF/SRVD/TABL/INCL) write via /source/main. CLAS update: pass include=definitions|implementations|macros|testclasses to write a local include; omit for source/main. ' +
     'TABL create: "TABL"/"TABL/DT" → transparent table (16-char name); "TABL/DS" → structure (30-char, namespaces OK); update/delete/activate auto-discover the subtype. ' +
@@ -23,19 +24,20 @@ const SAPWRITE_BODY_ONPREM =
     'FUNC: needs "group"; pass structured `parameters` for the signature (read back via SAPRead includeSignature=true). ' +
     "INCL with group=: create/delete FUGR structural includes (name must start with L<GROUP>, e.g. LZFOOF01); SAP maintains the main program's INCLUDE line. " +
     'edit_method: replace one CLAS method body via source (95% fewer tokens than full-class). Local-class methods use the qualified specifier (e.g. "lhc_project~approve_project"); auto-routing: lhc_*/lcl_* → implementations, ltc_* → testclasses (override with include=); zif_*~* stays on /source/main. ' +
-    'edit_unit: replace one FORM/MODULE block in PROG/INCL using unit+source; group= supports FUGR includes. ' +
+    'edit_unit/add_unit: replace/add one FORM/MODULE in PROG/INCL using unit+source; group= supports FUGR includes. ' +
     'batch_create: preflight all objects, then create+activate in dependency order; failures report per-object persistence. scaffold_rap_handlers / generate_behavior_implementation: derive RAP behavior-pool handlers from the BDEF (the latter auto-discovers the BDEF via rootEntityRef and activates by default). ' +
-    'Server-driven objects (discovery-gated): DESD/CSNM/EVTB/EVTO/COTA/UIAD take AFF JSON in "source"; DTSC/DSFD/DTDC/DRTY take DDL text — create/update/delete, then SAPActivate. ' +
+    'Server-driven objects (discovery-gated): AFF JSON source (DTSC/DSFD/DTDC/DRTY: DDL); create/update/delete. APLO/UIAD save active; others need SAPActivate. SAJC/SAJT create require source.generalInformation.className/catalogName. ' +
     'edit_text_symbols: CLAS/PROG/FUGR textPart=symbols (default; one "@MaxLength:NN\\nNNN=text" per symbol, blank-line separated), selections ("PARAM=Label") or headings. CLAS: symbols only. Immediately active; needs ADT textelements. ' +
     'Full per-type field reference: docs_page SAPWrite. ';
-const SAPWRITE_BODY_BTP = 'Create or update ABAP source code and DDIC metadata (BTP ABAP Environment). Handles lock/modify/unlock automatically. Supports CLAS, INTF, DDLS, DCLS, DDLX, BDEF, SRVD, SRVB, SKTD/KTD, TABL, TABL/DT, TABL/DS, DOMA, DTEL, MSAG. ' +
+const SAPWRITE_BODY_BTP = 'BTP ABAP Environment: handles lock/modify/unlock automatically. ' +
     'Must use ABAP Cloud language version (no classic statements); only Z*/Y* namespace. Type codes are auto-normalized (e.g. "CLAS/OC" → "CLAS"). For delete, only type and name are required (plus optional transport). ' +
     'Source objects (CLAS/INTF/DDLS/DCLS/DDLX/BDEF/SRVD/TABL) write via /source/main. CLAS update: pass include=definitions|implementations|macros|testclasses for a local include; omit for source/main. ' +
     'Metadata-XML writes (not /source/main): DOMA/DTEL (dataType, length, fixedValues, typeKind, labels, searchHelp; deactivateInputHistory=true disables input history); MSAG (messages array of {number, shortText}); SRVB (serviceDefinition, odataVersion V2/V4, optional category 0=UI/1=Web API). ' +
     'SKTD/KTD (Markdown docs on a KTD-capable object; KTD aliases SKTD): create needs refObjectType (e.g. "DDLS/DF"); "name" MUST equal the parent name; update takes Markdown in source; then SAPActivate(type="SKTD"). ' +
     'edit_method: replace one CLAS method body via source. Local-class methods use the qualified specifier (e.g. "lhc_project~approve_project"); auto-routing lhc_*/lcl_* → implementations, ltc_* → testclasses (override with include=). ' +
     'batch_create: preflight all objects, then create+activate in dependency order; failures report per-object persistence. scaffold_rap_handlers / generate_behavior_implementation: derive RAP behavior-pool handlers from the BDEF (the latter auto-discovers via rootEntityRef and activates by default). ' +
-    'Server-driven objects (discovery-gated): DESD/CSNM/EVTB/EVTO/COTA/UIAD take AFF JSON in "source"; DTSC/DSFD/DTDC/DRTY take DDL text — create/update/delete, then SAPActivate. ' +
+    'ENQU: SAPRead JSON in source; create needs primaryTable. Entries need explicit lockMode/parameterWanted; update refuses lockParameters=[]. Then SAPActivate. ' +
+    'Server-driven objects (discovery-gated): AFF JSON source (DTSC/DSFD/DTDC/DRTY: DDL); create/update/delete. APLO/UIAD save active; others need SAPActivate. SAJC/SAJT create require source.generalInformation.className/catalogName. ' +
     'Full per-type field reference: docs_page SAPWrite. ';
 // Appended to both SAPWrite descriptions (see the composition at the bottom). The schema lists every
 // optional field for every object type/action, but each call uses only a small subset — GPT/OpenAI

package/dist/handlers/tool-descriptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-descriptions.js","sourceRoot":"","sources":["../../src/handlers/tool-descriptions.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG;;;;;;;GAOG;AACH,MAAM,aAAa,GACjB,mGAAmG;IACnG,iGAAiG;IACjG,mGAAmG;IACnG,6EAA6E,CAAC;AAEhF,MAAM,oBAAoB;AACxB,uFAAuF;AACvF,uFAAuF;IACvF,yJAAyJ;IACzJ,sNAAsN;IACtN,sKAAsK;IACtK,oVAAoV;IACpV,2OAA2O;IAC3O,0GAA0G;IAC1G,qHAAqH;IACrH,0JAA0J;IAC1J,2SAA2S;IAC3S,0GAA0G;IAC1G,oTAAoT;IACpT,gLAAgL;IAChL,yOAAyO;IACzO,qDAAqD,CAAC;AAExD,MAAM,iBAAiB,GACrB,qOAAqO;IACrO,uNAAuN;IACvN,uMAAuM;IACvM,qSAAqS;IACrS,sNAAsN;IACtN,wOAAwO;IACxO,2SAA2S;IAC3S,gLAAgL;IAChL,qDAAqD,CAAC;AAExD,qGAAqG;AACrG,mGAAmG;AACnG,iGAAiG;AACjG,4FAA4F;AAC5F,mGAAmG;AACnG,MAAM,8BAA8B,GAClC,iGAAiG;IACjG,4GAA4G,CAAC;AAE/G,oGAAoG;AACpG,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,GAAG,oBAAoB,GAAG,8BAA8B,CAAC;AAC1G,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,GAAG,iBAAiB,GAAG,8BAA8B,CAAC"}
+{"version":3,"file":"tool-descriptions.js","sourceRoot":"","sources":["../../src/handlers/tool-descriptions.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG;;;;;;;GAOG;AACH,MAAM,aAAa,GACjB,mGAAmG;IACnG,iGAAiG;IACjG,mGAAmG;IACnG,kFAAkF,CAAC;AAErF,MAAM,oBAAoB;AACxB,uFAAuF;AACvF,uFAAuF;IACvF,+JAA+J;IAC/J,yJAAyJ;IACzJ,sNAAsN;IACtN,sKAAsK;IACtK,oVAAoV;IACpV,2OAA2O;IAC3O,0GAA0G;IAC1G,qHAAqH;IACrH,0JAA0J;IAC1J,2SAA2S;IAC3S,iHAAiH;IACjH,oTAAoT;IACpT,uOAAuO;IACvO,yOAAyO;IACzO,qDAAqD,CAAC;AAExD,MAAM,iBAAiB,GACrB,kEAAkE;IAClE,uNAAuN;IACvN,uMAAuM;IACvM,qSAAqS;IACrS,sNAAsN;IACtN,wOAAwO;IACxO,2SAA2S;IAC3S,+JAA+J;IAC/J,uOAAuO;IACvO,qDAAqD,CAAC;AAExD,qGAAqG;AACrG,mGAAmG;AACnG,iGAAiG;AACjG,4FAA4F;AAC5F,mGAAmG;AACnG,MAAM,8BAA8B,GAClC,iGAAiG;IACjG,4GAA4G,CAAC;AAE/G,oGAAoG;AACpG,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,GAAG,oBAAoB,GAAG,8BAA8B,CAAC;AAC1G,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,GAAG,iBAAiB,GAAG,8BAA8B,CAAC"}

package/dist/handlers/tool-registry.d.ts

@@ -29,14 +29,14 @@
 import type { ResolvedFeatures } from '../adt/types.js';
 import type { ServerConfig } from '../server/types.js';
 /** All SAPRead object types available on on-premise (the superset). */
-export declare const SAPREAD_TYPES_ONPREM: ("API_STATE" | "AUTH" | "BDEF" | "BSP" | "BSP_DEPLOY" | "CLAS" | "COMPONENTS" | "COTA" | "CSNM" | "DCLS" | "DDLS" | "DDLX" | "DESD" | "DEVC" | "DOMA" | "DRTY" | "DSFD" | "DTDC" | "DTEL" | "DTSC" | "ENHO" | "EVTB" | "EVTO" | "FEATURE_TOGGLE" | "FTG2" | "FUGR" | "FUNC" | "INACTIVE_OBJECTS" | "INCL" | "INTF" | "KTD" | "MESSAGES" | "MSAG" | "PROG" | "SKTD" | "SOBJ" | "SRVB" | "SRVD" | "SYSTEM" | "TABL" | "TABLE_CONTENTS" | "TABLE_QUERY" | "TEXT_ELEMENTS" | "TRAN" | "TTYP" | "UIAD" | "VARIANTS" | "VERSIONS" | "VERSION_SOURCE" | "VIEW")[];
+export declare const SAPREAD_TYPES_ONPREM: ("API_STATE" | "APLO" | "AUTH" | "BDEF" | "BSP" | "BSP_DEPLOY" | "CLAS" | "COMPONENTS" | "COTA" | "CSNM" | "DCLS" | "DDLS" | "DDLX" | "DESD" | "DEVC" | "DOMA" | "DRTY" | "DSFD" | "DTDC" | "DTEL" | "DTSC" | "ENHO" | "ENQU" | "EVTB" | "EVTO" | "FEATURE_TOGGLE" | "FTG2" | "FUGR" | "FUNC" | "INACTIVE_OBJECTS" | "INCL" | "INTF" | "KTD" | "MESSAGES" | "MSAG" | "PROG" | "SAJC" | "SAJT" | "SKTD" | "SOBJ" | "SRVB" | "SRVD" | "SYNTAX" | "SYSTEM" | "TABL" | "TABLE_CONTENTS" | "TABLE_QUERY" | "TEXT_ELEMENTS" | "TRAN" | "TTYP" | "UIAD" | "VARIANTS" | "VERSIONS" | "VERSION_SOURCE" | "VIEW")[];
 /** SAPRead types available on BTP ABAP Environment (the `btp: true` rows). */
-export declare const SAPREAD_TYPES_BTP: ("API_STATE" | "BDEF" | "BSP" | "BSP_DEPLOY" | "CLAS" | "COMPONENTS" | "COTA" | "CSNM" | "DCLS" | "DDLS" | "DDLX" | "DESD" | "DEVC" | "DOMA" | "DRTY" | "DSFD" | "DTDC" | "DTEL" | "DTSC" | "EVTB" | "EVTO" | "FUGR" | "FUNC" | "INACTIVE_OBJECTS" | "INTF" | "KTD" | "MESSAGES" | "MSAG" | "SKTD" | "SRVB" | "SRVD" | "SYSTEM" | "TABL" | "TABLE_CONTENTS" | "TABLE_QUERY" | "UIAD")[];
+export declare const SAPREAD_TYPES_BTP: ("API_STATE" | "APLO" | "BDEF" | "BSP" | "BSP_DEPLOY" | "CLAS" | "COMPONENTS" | "COTA" | "CSNM" | "DCLS" | "DDLS" | "DDLX" | "DESD" | "DEVC" | "DOMA" | "DRTY" | "DSFD" | "DTDC" | "DTEL" | "DTSC" | "ENQU" | "EVTB" | "EVTO" | "FUGR" | "FUNC" | "INACTIVE_OBJECTS" | "INTF" | "KTD" | "MESSAGES" | "MSAG" | "SAJC" | "SAJT" | "SKTD" | "SRVB" | "SRVD" | "SYNTAX" | "SYSTEM" | "TABL" | "TABLE_CONTENTS" | "TABLE_QUERY" | "UIAD")[];
 export declare const ATC_BATCH_TYPES_BTP: ("BDEF" | "CLAS" | "DCLS" | "DDLS" | "DDLX" | "DOMA" | "DTEL" | "FUGR" | "INTF" | "PROG" | "SRVB" | "SRVD" | "TABL")[];
 /** All SAPWrite object types available on on-premise (the superset). */
-export declare const SAPWRITE_TYPES_ONPREM: ("BDEF" | "CLAS" | "COTA" | "CSNM" | "DCLS" | "DDLS" | "DDLX" | "DESD" | "DOMA" | "DRTY" | "DSFD" | "DTDC" | "DTEL" | "DTSC" | "EVTB" | "EVTO" | "FUGR" | "FUNC" | "INCL" | "INTF" | "KTD" | "MSAG" | "PROG" | "SKTD" | "SRVB" | "SRVD" | "TABL" | "TABL/DS" | "TABL/DT" | "TTYP" | "UIAD")[];
+export declare const SAPWRITE_TYPES_ONPREM: ("APLO" | "BDEF" | "CLAS" | "COTA" | "CSNM" | "DCLS" | "DDLS" | "DDLX" | "DESD" | "DOMA" | "DRTY" | "DSFD" | "DTDC" | "DTEL" | "DTSC" | "ENQU" | "EVTB" | "EVTO" | "FUGR" | "FUNC" | "INCL" | "INTF" | "KTD" | "MSAG" | "PROG" | "SAJC" | "SAJT" | "SKTD" | "SRVB" | "SRVD" | "TABL" | "TABL/DS" | "TABL/DT" | "TTYP" | "UIAD")[];
 /** SAPWrite types available on BTP ABAP Environment (the `btp: true` rows). */
-export declare const SAPWRITE_TYPES_BTP: ("BDEF" | "CLAS" | "COTA" | "CSNM" | "DCLS" | "DDLS" | "DDLX" | "DESD" | "DOMA" | "DRTY" | "DSFD" | "DTDC" | "DTEL" | "DTSC" | "EVTB" | "EVTO" | "INTF" | "KTD" | "MSAG" | "SKTD" | "SRVB" | "SRVD" | "TABL" | "TABL/DS" | "TABL/DT" | "UIAD")[];
+export declare const SAPWRITE_TYPES_BTP: ("APLO" | "BDEF" | "CLAS" | "COTA" | "CSNM" | "DCLS" | "DDLS" | "DDLX" | "DESD" | "DOMA" | "DRTY" | "DSFD" | "DTDC" | "DTEL" | "DTSC" | "ENQU" | "EVTB" | "EVTO" | "INTF" | "KTD" | "MSAG" | "SAJC" | "SAJT" | "SKTD" | "SRVB" | "SRVD" | "TABL" | "TABL/DS" | "TABL/DT" | "UIAD")[];
 /** SAPContext types on on-premise. */
 export declare const SAPCONTEXT_TYPES_ONPREM: ("CLAS" | "DDLS" | "FUNC" | "INTF" | "PROG" | "TABL")[];
 /** SAPContext types on BTP. */

package/dist/handlers/tool-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/handlers/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAkFvD,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,4hBAAsB,CAAC;AACxD,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,yXAAmB,CAAC;AAIlD,eAAO,MAAM,mBAAmB,wHAE/B,CAAC;AAiCF,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,+RAAuB,CAAC;AAC1D,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,kPAAoB,CAAC;AAapD,sCAAsC;AACtC,eAAO,MAAM,uBAAuB,yDAAyB,CAAC;AAC9D,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,uCAAsB,CAAC;AAIxD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,gBAAgB,GAAG,aAAa,CAAC,EAC5D,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GACvE,OAAO,CAKT;AAID,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/handlers/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAqFvD,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,2kBAAsB,CAAC;AACxD,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,waAAmB,CAAC;AAIlD,eAAO,MAAM,mBAAmB,wHAE/B,CAAC;AAkCF,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,mUAAuB,CAAC;AAC1D,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,sRAAoB,CAAC;AAapD,sCAAsC;AACtC,eAAO,MAAM,uBAAuB,yDAAyB,CAAC;AAC9D,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,uCAAsB,CAAC;AAIxD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,gBAAgB,GAAG,aAAa,CAAC,EAC5D,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GACvE,OAAO,CAKT;AAID,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/handlers/tool-registry.js

@@ -73,6 +73,8 @@ const SAPREAD_TYPE_TABLE = [
     { type: 'DTEL', btp: true },
     { type: 'TRAN', btp: false },
     { type: 'TTYP', btp: false },
+    // DDIC lock objects: one XML metadata document, returned as JSON. Live-verified on-prem 8.16 + BTP trial.
+    { type: 'ENQU', btp: true },
     { type: 'TABLE_CONTENTS', btp: true },
     { type: 'TABLE_QUERY', btp: true },
     { type: 'DEVC', btp: true },
@@ -90,6 +92,7 @@ const SAPREAD_TYPE_TABLE = [
     { type: 'BSP_DEPLOY', btp: true },
     { type: 'API_STATE', btp: true },
     { type: 'INACTIVE_OBJECTS', btp: true },
+    { type: 'SYNTAX', btp: true },
     { type: 'AUTH', btp: false },
     // FTG2 is an ARC-1-private invented identifier (see docs/research/abap-types/types/ftg2.md).
     // FEATURE_TOGGLE is the new canonical name; FTG2 stays as deprecated alias for one minor.
@@ -137,6 +140,7 @@ const SAPWRITE_TYPE_TABLE = [
     { type: 'DTEL', btp: true },
     { type: 'MSAG', btp: true },
     { type: 'TTYP', btp: false },
+    { type: 'ENQU', btp: true },
     // Server-driven objects (8.16+) — write via the generic blue:blueSource + AFF JSON engine.
     // Rows derive from SDO_TYPES exactly like the SAPRead table above.
     ...SDO_TYPES.map((t) => ({ type: t, btp: true })),

package/dist/handlers/tool-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/handlers/tool-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/handlers/tool-registry.ts"],"names":[],"mappings":"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"}

package/dist/handlers/tools.d.ts

@@ -1,19 +1,4 @@
-/**
- * Tool definitions for ARC-1's 12 intent-based MCP tools.
- *
- * Each tool has:
- * - name: The MCP tool name (SAPRead, SAPWrite, etc.)
- * - description: Rich LLM-friendly description
- * - inputSchema: JSON Schema for tool arguments
- *
- * Group operations by intent, with a `type` parameter for object routing.
- * This keeps the LLM's tool selection simple and the context window small.
- *
- * Tool definitions adapt based on system type (BTP vs on-premise):
- * - BTP ABAP Environment: removes unavailable types (PROG, INCL, VIEW,
- *   TEXT_ELEMENTS, VARIANTS), adjusts descriptions for restricted features
- * - On-premise: full tool set with all types and descriptions
- */
+/** Intent-based tool schemas; BTP omits classic object types and adjusts descriptions. */
 import type { ResolvedFeatures } from '../adt/types.js';
 import type { ServerConfig } from '../server/types.js';
 /** MCP tool behavior annotations (a subset of the spec; all optional, all advisory hints). */

package/dist/handlers/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/handlers/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoBvD,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C;AAoVD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,mBAAmB,CAAC,EAAE,OAAO,EAC7B,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,OAAO,GAAE,qBAA0B,GAClC,cAAc,EAAE,CA01ClB"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/handlers/tools.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAU1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoBvD,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C;AA6UD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,mBAAmB,CAAC,EAAE,OAAO,EAC7B,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,OAAO,GAAE,qBAA0B,GAClC,cAAc,EAAE,CAw2ClB"}

package/dist/handlers/tools.js

@@ -1,19 +1,4 @@
-/**
- * Tool definitions for ARC-1's 12 intent-based MCP tools.
- *
- * Each tool has:
- * - name: The MCP tool name (SAPRead, SAPWrite, etc.)
- * - description: Rich LLM-friendly description
- * - inputSchema: JSON Schema for tool arguments
- *
- * Group operations by intent, with a `type` parameter for object routing.
- * This keeps the LLM's tool selection simple and the context window small.
- *
- * Tool definitions adapt based on system type (BTP vs on-premise):
- * - BTP ABAP Environment: removes unavailable types (PROG, INCL, VIEW,
- *   TEXT_ELEMENTS, VARIANTS), adjusts descriptions for restricted features
- * - On-premise: full tool set with all types and descriptions
- */
+/** Intent-based tool schemas; BTP omits classic object types and adjusts descriptions. */
 import { ATC_BATCH_MAX_OBJECTS, ATC_BATCH_NAME_MAX_LENGTH, ATC_BATCH_NAME_PATTERN, ATC_BATCH_TYPES, } from '../adt/atc-batch.js';
 import { KTD_SHORT_TEXT_MAX_LENGTH } from '../adt/ddic-xml.js';
 import { TEXT_ELEMENT_PARTS } from '../adt/text-elements.js';
@@ -28,16 +13,11 @@ import { SAPWRITE_DESC_BTP, SAPWRITE_DESC_ONPREM } from './tool-descriptions.js'
 import { ATC_BATCH_TYPES_BTP, isGitToolVisible, SAPCONTEXT_TYPES_BTP, SAPCONTEXT_TYPES_ONPREM, SAPREAD_TYPES_BTP, SAPREAD_TYPES_ONPREM, SAPWRITE_TYPES_BTP, SAPWRITE_TYPES_ONPREM, } from './tool-registry.js';
 import { BATCH_CREATE_MAX_OBJECTS } from './write/batch-results.js';
 /**
- * Read-only / destructive hints for the 12 standard tools. Clients use them to badge tools
- * and to decide auto-approval (read-only tools are safe to auto-run); they are also required
- * for the Claude Desktop Extensions Directory. Hyperfocused mode's universal tool is left
- * unannotated because it can both read and write.
+ * Read-only / destructive hints for standard tools, required by the Claude Desktop Extensions Directory.
+ * Hyperfocused mode stays unannotated because it can both read and write.
  *
- * These MUST agree with ACTION_POLICY (src/authz/policy.ts): a tool is read-only iff none of
- * its actions mutate (opType ∉ MUTATING_OPS), and destructive iff it has a delete action.
- * tool-annotations.test.ts derives the expected values from ACTION_POLICY and fails on drift —
- * e.g. SAPLint is NOT read-only because action=set_formatter_settings PUTs ADT settings, and
- * SAPWrite/SAPTransport/SAPGit are destructive because they can delete/unlink/overwrite objects.
+ * Keep hints consistent with ACTION_POLICY; tool-annotations.test.ts derives expected values.
+ * SAPLint mutates formatter settings; SAPWrite/SAPTransport/SAPGit can delete or unlink objects.
  */
 const TOOL_ANNOTATIONS = {
     // Read-only: every action is non-mutating.
@@ -61,16 +41,14 @@ const TOOL_ANNOTATIONS = {
 function isBtpMode(config) {
     return config.systemType === 'btp';
 }
-const SAPREAD_DESC_ONPREM = 'Read SAP ABAP source or metadata. For purpose, explanations, specs, reviews or pre-change context, prefer SAPContext first. DDIC metadata: omit format (default text); structured is CLAS-only for ordinary reads. ' +
+const SAPREAD_DESC_ONPREM = 'Read SAP ABAP source, metadata or syntax-check results. For purpose, explanations, specs, reviews or pre-change context, prefer SAPContext first. DDIC metadata: omit format (default text); structured is CLAS-only for ordinary reads. ' +
     'Types: PROG, CLAS, INTF, FUNC, FUGR (expand_includes=true for all include sources), INCL, DDLS, DCLS, DDLX, BDEF, SRVD, SRVB, SKTD/KTD (KTD aliases SKTD), TABL (covers both transparent tables AND DDIC structures — no separate STRU type), TTYP, VIEW, DOMA, DTEL, TRAN, TABLE_CONTENTS (single-column filter), TABLE_QUERY (multi-column WHERE via the freestyle endpoint; gated by allowDataPreview; CDS views need SAP_BASIS 752+), DEVC, SOBJ (BOR — method param reads one method), SYSTEM, COMPONENTS, MSAG, TEXT_ELEMENTS, VARIANTS, BSP, BSP_DEPLOY, API_STATE (contract states C0-C4; objectType for non-class), INACTIVE_OBJECTS (no name; pending-activation list), AUTH, FEATURE_TOGGLE, ENHO, VERSIONS, VERSION_SOURCE. AUTH/FEATURE_TOGGLE/ENHO/VERSIONS/VERSION_SOURCE are on-prem only. ' +
-    'CLAS: method="*" for signatures, method="NAME" for one body, or grep. Global class declaration/implementation: MAIN (omit include). definitions/implementations contain local helpers. Details: docs_page SAPRead. ' +
-    'grep: case-insensitive regex; returns matching lines, context and line numbers, with owning class/method for CLAS. ' +
-    'Optional version parameter: source types default active; "inactive" requests the draft (SAP may return active if none); "auto" uses the developer view. DTEL omitted/auto uses its developer view; explicit values pass through. Active source reads note when a draft exists.';
-const SAPREAD_DESC_BTP = 'Read SAP ABAP source or metadata (BTP ABAP Environment). For purpose, explanations, specs, reviews or pre-change context, prefer SAPContext first. DDIC metadata: omit format (default text); structured is CLAS-only for ordinary reads. ' +
+    'SYNTAX: read-only SAP check (objectType+name, optional source for unsaved text). CLAS: method="*" for signatures, method="NAME" for one body, or grep. Global class declaration/implementation: MAIN (omit include). definitions/implementations contain local helpers. ' +
+    'grep: case-insensitive regex; returns matching lines, context and line numbers, with owning class/method for CLAS.';
+const SAPREAD_DESC_BTP = 'Read SAP ABAP source, metadata or syntax-check results (BTP ABAP Environment). For purpose, explanations, specs, reviews or pre-change context, prefer SAPContext first. DDIC metadata: omit format (default text); structured is CLAS-only for ordinary reads. ' +
     'Types: CLAS, INTF, FUNC (released/custom only), FUGR (released/custom only), DDLS (primary data model on BTP), DCLS, DDLX, BDEF, SRVD, SRVB, SKTD/KTD (KTD aliases SKTD), TABL (custom tables AND structures — no separate STRU type), DOMA, DTEL, TABLE_CONTENTS (custom tables + released CDS only; standard tables blocked), TABLE_QUERY (multi-column WHERE on custom tables + released CDS; needs SAP_BASIS 752+), DEVC, SYSTEM, COMPONENTS, MSAG (custom only), BSP, BSP_DEPLOY, API_STATE (contract states C0-C4; objectType for non-class), INACTIVE_OBJECTS (no name; pending-activation list). PROG/INCL/VIEW/TRAN/TEXT_ELEMENTS/VARIANTS and VERSIONS/VERSION_SOURCE are not available on BTP (use CLAS with IF_OO_ADT_CLASSRUN for console apps, DDLS for data models). ' +
-    'CLAS: method="*" for signatures, method="NAME" for one body, or grep. Global class declaration/implementation: MAIN (omit include). definitions/implementations contain local helpers. Details: docs_page SAPRead. ' +
-    'grep: case-insensitive regex; returns matching lines, context and line numbers, with owning class/method for CLAS. ' +
-    'Optional version parameter: source types default active; "inactive" requests the draft (SAP may return active if none); "auto" uses the developer view. DTEL omitted/auto uses its developer view; explicit values pass through.';
+    'SYNTAX: read-only SAP check (objectType+name, optional source for unsaved text). CLAS: method="*" for signatures, method="NAME" for one body, or grep. Global class declaration/implementation: MAIN (omit include). definitions/implementations contain local helpers. ' +
+    'grep: case-insensitive regex; returns matching lines, context and line numbers, with owning class/method for CLAS.';
 // ─── SAPContext Types ───────────────────────────────────────────────
 const SAPCONTEXT_DESC_ONPREM = 'Primary tool for understanding ABAP/CDS objects before specs, reviews, explanations, or changes — use instead of SAPRead when the user asks what an object does. Returns intent first (the object KTD when available) then compressed dependency contracts. Use SAPRead after SAPContext for exact source/method bodies/grep/drafts.\n\n' +
     "Decision rule — pick the action from the user's question:\n" +
@@ -328,9 +306,8 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
                     type: {
                         type: 'string',
                         enum: btp ? SAPREAD_TYPES_BTP : SAPREAD_TYPES_ONPREM,
-                        description: btp
-                            ? 'Object type to read (BTP): CLAS, INTF, FUNC, FUGR, DDLS, DCLS, DDLX, BDEF, SRVD, SRVB, SKTD or KTD (Knowledge Transfer Documents), TABL (transparent tables and DDIC structures), DOMA, DTEL, MSAG, TABLE_CONTENTS, TABLE_QUERY, DEVC, SYSTEM, COMPONENTS, BSP, BSP_DEPLOY, API_STATE, INACTIVE_OBJECTS. Server-driven objects (discovery-gated; XML metadata; source is AFF JSON, or DDL text for DTSC/DSFD/DTDC/DRTY): DESD (Logical External Schema), EVTB (RAP Event Binding), EVTO (RAP Event Object), DTSC (Static Cache), CSNM (CSN Model), COTA (Communication Target), DSFD (Scalar Function Def), DTDC (Dynamic Cache), UIAD (Launchpad App Descriptor Item), DRTY (CDS Type). Deprecated alias: MESSAGES (use MSAG).'
-                            : 'Object type to read (on-prem): PROG, CLAS, INTF, FUNC, FUGR, INCL, DDLS, DCLS, DDLX, BDEF, SRVD, SRVB, SKTD or KTD (Knowledge Transfer Documents), TABL (transparent tables and DDIC structures), TTYP, VIEW, DOMA, DTEL, MSAG, TRAN, TABLE_CONTENTS, TABLE_QUERY, DEVC, SOBJ, SYSTEM, COMPONENTS, TEXT_ELEMENTS, VARIANTS, BSP, BSP_DEPLOY, API_STATE, INACTIVE_OBJECTS, AUTH, FEATURE_TOGGLE, ENHO, VERSIONS, VERSION_SOURCE. Server-driven objects (discovery-gated; XML metadata; source is AFF JSON, or DDL text for DTSC/DSFD/DTDC/DRTY): DESD (Logical External Schema), EVTB (RAP Event Binding), EVTO (RAP Event Object), DTSC (Static Cache), CSNM (CSN Model), COTA (Communication Target), DSFD (Scalar Function Def), DTDC (Dynamic Cache), UIAD (Launchpad App Descriptor Item), DRTY (CDS Type). Deprecated aliases: MESSAGES (use MSAG), FTG2 (use FEATURE_TOGGLE).',
+                        description: 'Object or metadata type. TABL includes DDIC structures; KTD aliases SKTD (Knowledge Transfer Documents). SYNTAX checks objectType+name. Server-driven objects use discovery-gated XML metadata and AFF JSON source (DTSC/DSFD/DTDC/DRTY use DDL text). DESD logical external schema; EVTB event binding; EVTO event object; CSNM CSN model; COTA communication target; DTSC static cache; DTDC dynamic cache; DSFD scalar function; UIAD launchpad descriptor; DRTY CDS type; APLO log object; SAJC/SAJT job catalog/template. Deprecated: MESSAGES→MSAG.' +
+                            (btp ? ' ENQU lock object as JSON.' : ' FTG2→FEATURE_TOGGLE. ENQU lock object as JSON.'),
                     },
                     name: { type: 'string', description: 'Object name (e.g., ZTEST_PROGRAM, ZCL_ORDER, MARA)' },
                     action: {
@@ -391,13 +368,13 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
                         }),
                     format: {
                         type: 'string',
-                        enum: ['text', 'structured'],
-                        description: 'Default "text" (TABL/TTYP/DTEL/DOMA/INTF metadata included). DEVC: array in first text block + listing metadata in second; "structured" returns {objects, listing}. CLAS "structured": metadata + all includes; prefer method/grep for targeted reads. action="diff": "structured" returns JSON {hasDifferences, identical, added, removed, diff, version labels}; default is a patch.',
+                        enum: ['text', 'structured', 'editable'],
+                        description: 'Default text. editable: fresh {source, sourceHash} for guarded SAPWrite; omit version/method/grep, select CLAS include. structured: CLAS metadata+includes, DEVC {objects,listing}, or action=diff JSON. DEVC text returns the array then listing metadata; diff text returns a patch.',
                     },
                     version: {
                         type: 'string',
                         enum: ['active', 'inactive', 'auto'],
-                        description: 'Version to read. Source: "active" (default); "inactive" requests the draft (SAP may return active if none); "auto" uses the developer view. DTEL: omitted/"auto" uses its developer view; explicit values pass through.',
+                        description: 'Source defaults active; inactive requests a draft (SAP may return active if none); auto selects developer view. DTEL/ENQU/server-driven types default to developer view. Server-driven types return an error if SAP cannot confirm an explicit version (e.g. no draft).',
                     },
                     includeSignature: {
                         type: 'boolean',
@@ -421,9 +398,13 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
                     },
                     objectType: {
                         type: 'string',
-                        description: 'For API_STATE and VERSIONS: SAP object type (CLAS, INTF, PROG, FUNC, INCL, DDLS, DCLS, BDEF, SRVD, etc.). For API_STATE: auto-detected from name if omitted. For VERSIONS: required to pick the correct revisions endpoint (e.g., "FUNC" + group for function modules); inferred from CL_/IF_/CX_ name prefixes when possible, defaults to PROG.' +
+                        description: 'SYNTAX: required repository type (e.g. CLAS, PROG, DDLS). API_STATE: inferred if omitted. VERSIONS: type selects the endpoint (FUNC needs group); inferred from CL_/IF_/CX_, else PROG.' +
                             (btp ? '' : ' TEXT_ELEMENTS: PROG (default), CLAS or FUGR.'),
                     },
+                    source: {
+                        type: 'string',
+                        description: 'SYNTAX only: proposed source to check without saving. Omit to check stored version (default active; inactive checks draft). Object must exist; version=auto is unsupported.',
+                    },
                     versionUri: {
                         type: 'string',
                         description: 'VERSION_SOURCE: canonical source/revision URI from VERSIONS .revisions[].uri; rejects unrelated ADT endpoints, absolute URLs, traversal, queries, and fragments.',
@@ -478,7 +459,7 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
                             'update',
                             'delete',
                             'edit_method',
-                            ...(btp ? [] : ['edit_unit']),
+                            ...(btp ? [] : ['edit_unit', 'add_unit']),
                             'edit_class_definition',
                             'add_method',
                             'edit_method_signature',
@@ -495,7 +476,7 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
                         // especially the destructive and refusing ones, whose behaviour is not guessable.
                         description: 'Write action. create/update/delete: whole-object writes (update replaces /source/main, or one class-local include when include= is set). ' +
                             'edit_method: replace a single method body — the token-cheap path for class edits. ' +
-                            (btp ? '' : 'edit_unit: replace one FORM or MODULE block inside a PROG/INCL. ') +
+                            (btp ? '' : 'edit_unit replaces a FORM/MODULE in PROG/INCL; add_unit appends one at EOF. ') +
                             'batch_create: create and activate many objects in one call; order is preserved, so list dependencies first. ' +
                             'Class surgery (CLAS, all on /source/main unless noted): edit_class_definition replaces the global DEFINITION block — or a class-local include when include= is set — and refuses a diff that would leave the class non-activatable; ' +
                             'add_method inserts a METHODS clause plus an empty IMPL stub (abstract=true skips the stub); ' +
@@ -511,20 +492,24 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
                         type: 'string',
                         enum: btp ? SAPWRITE_TYPES_BTP : SAPWRITE_TYPES_ONPREM,
                         description: btp
-                            ? 'Object type (for create/update/delete/edit_method/edit_class_definition/add_method/edit_method_signature/delete_method/change_method_visibility). Supported on BTP: CLAS, INTF, DDLS, DCLS, DDLX, BDEF, SRVD, SRVB, SKTD or KTD (Knowledge Transfer Documents), TABL, TABL/DT, TABL/DS, DOMA, DTEL, MSAG. Class-section surgery actions require type=CLAS. Server-driven objects (discovery-gated): DESD/CSNM/EVTB/EVTO/COTA take AFF JSON in "source"; DTSC/DSFD/DTDC/DRTY take DDL text — create/update/delete, then SAPActivate. UIAD: checks AFF JSON; create honors header.abapLanguageVersion. Manual cloudDevelopment items are editable; generated items may be read-only.'
-                            : 'Object type (for create/update/delete/edit_method/edit_unit/edit_class_definition/add_method/edit_method_signature/delete_method/change_method_visibility). Supported on-prem: PROG, CLAS, INTF, FUNC, FUGR, INCL, DDLS, DCLS, DDLX, BDEF, SRVD, SRVB, SKTD or KTD (Knowledge Transfer Documents), TABL, TABL/DT, TABL/DS, DOMA, DTEL, MSAG. Class-section surgery actions require CLAS. Server-driven objects (discovery-gated): DESD/CSNM/EVTB/EVTO/COTA take AFF JSON in "source"; DTSC/DSFD/DTDC/DRTY take DDL text — create/update/delete, then SAPActivate. UIAD: validates AFF JSON and saves active; create honors header.abapLanguageVersion. Manual cloudDevelopment items are editable; generated items can be read-only.',
+                            ? 'Object type (for create/update/delete/edit_method/edit_class_definition/add_method/edit_method_signature/delete_method/change_method_visibility). Supported on BTP: CLAS, INTF, DDLS, DCLS, DDLX, BDEF, SRVD, SRVB, SKTD or KTD (Knowledge Transfer Documents), TABL, TABL/DT, TABL/DS, DOMA, DTEL, MSAG. Class-section surgery actions require type=CLAS. UIAD: checks AFF JSON; create honors header.abapLanguageVersion. Manual cloudDevelopment items are editable; generated items may be read-only.'
+                            : 'Object type (for create/update/delete/edit_method/edit_unit/add_unit/edit_class_definition/add_method/edit_method_signature/delete_method/change_method_visibility). Supported on-prem: PROG, CLAS, INTF, FUNC, FUGR, INCL, DDLS, DCLS, DDLX, BDEF, SRVD, SRVB, SKTD or KTD (Knowledge Transfer Documents), TABL, TABL/DT, TABL/DS, DOMA, DTEL, MSAG. Class-section surgery actions require CLAS. UIAD: validates AFF JSON and saves active; create honors header.abapLanguageVersion. Manual cloudDevelopment items are editable; generated items can be read-only.',
                     },
                     name: {
                         type: 'string',
                         description: btp
                             ? 'Object name (for create/update/delete/edit_method/edit_class_definition/add_method/edit_method_signature/delete_method/change_method_visibility).'
-                            : 'Object name (for create/update/delete/edit_method/edit_unit/edit_class_definition/add_method/edit_method_signature/delete_method/change_method_visibility).',
+                            : 'Object name (for create/update/delete/edit_method/edit_unit/add_unit/edit_class_definition/add_method/edit_method_signature/delete_method/change_method_visibility).',
+                    },
+                    expectedSourceHash: {
+                        type: 'string',
+                        description: 'SHA-256 from SAPRead(format=editable). Refuses changed source under the lock. Text-source update and class/procedural surgery only; whole addressed source/include, not just the edited unit. Omitted/blank: no cross-call protection.',
                     },
                     source: {
                         type: 'string',
                         description: btp
                             ? 'ABAP source. create/update: full body. DDLS: type=DDLS; Cloud permits eligible `extend view entity`, not legacy `extend view`. edit_method: body. edit_class_definition without include=: only global CLASS…DEFINITION…ENDCLASS block (no IMPLEMENTATION); with include=: full replacement include. edit_method_signature: only new METHODS clause. Not used by add_method/delete_method/change_method_visibility (use `method`/`visibility`). SKTD/KTD: one "## <node>" section per node (any name or id the SAPRead node index lists); update MERGES, so unaddressed nodes keep their text; an unmatched node-shaped heading aborts it.'
-                            : 'Source. create/update: full body. DDLS: type=DDLS for `extend view`/`extend view entity`; legacy needs a Standard ABAP package. edit_method: body. edit_unit: complete FORM/MODULE. edit_class_definition without include=: only global CLASS…DEFINITION…ENDCLASS block (no IMPLEMENTATION); with include=: full replacement include. edit_method_signature: only METHODS clause. Not used by add_method/delete_method/change_method_visibility (use `method`/`visibility`). SKTD/KTD: one "## <node>" section per node (any name or id the SAPRead node index lists); update MERGES, so unaddressed nodes keep their text; an unmatched node-shaped heading aborts it.',
+                            : 'Source. create/update: full body. DDLS: type=DDLS for `extend view`/`extend view entity`; legacy needs a Standard ABAP package. edit_method: body. edit_unit/add_unit: complete FORM/MODULE. edit_class_definition without include=: only global CLASS…DEFINITION…ENDCLASS block (no IMPLEMENTATION); with include=: full replacement include. edit_method_signature: only METHODS clause. Not used by add_method/delete_method/change_method_visibility (use `method`/`visibility`). SKTD/KTD: one "## <node>" section per node (any name or id the SAPRead node index lists); update MERGES, so unaddressed nodes keep their text; an unmatched node-shaped heading aborts it.',
                     },
                     include: {
                         type: 'string',
@@ -549,7 +534,7 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
                         : {
                             unit: {
                                 type: 'string',
-                                description: 'edit_unit FORM/MODULE name in a PROG or INCL (case-insensitive).',
+                                description: 'edit_unit/add_unit: existing/new FORM or MODULE name (case-insensitive).',
                             },
                         }),
                     visibility: {
@@ -599,7 +584,7 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
                     },
                     group: {
                         type: 'string',
-                        description: 'For FUNC: parent function-group name. Required for FUNC create (the FUGR must already exist — create it first via SAPWrite type=FUGR). Auto-resolved via search for FUNC update/delete if omitted.',
+                        description: 'FUNC: existing FUGR; required for create, otherwise resolved. INCL: group for L<group>…; omit for standalone.',
                     },
                     ...(btp ? {} : FuncProcessing.FUNCTION_PROCESSING_TOOL_PROPERTIES),
                     dataType: { type: 'string', description: 'DOMA/DTEL: ABAP data type (e.g., CHAR, NUMC, DEC)' },
@@ -937,7 +922,7 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
             '- "list_rules": list rules + current config (no source).\n' +
             '- "format": pretty-print via SAP\'s ADT formatter (needs source).\n' +
             '- "get_formatter_settings" / "set_formatter_settings": read/update the system\'s global PrettyPrinter (indentation bool, style keywordUpper|keywordLower|keywordAuto|none; set is blocked read-only).\n' +
-            'lint/lint_and_fix/list_rules run locally; format/*_formatter_settings call SAP. For ATC/syntax/unit tests use SAPDiagnose.',
+            'lint/lint_and_fix/list_rules run locally; format/*_formatter_settings call SAP. Syntax: SAPRead(type="SYNTAX"); ATC/unit tests: SAPDiagnose.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -970,13 +955,13 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
     }, {
         name: 'SAPDiagnose',
         description: 'ABAP diagnostics and runtime analysis. Actions:\n' +
-            '- "syntax": syntax-check (name+type; optional version; optional source = pre-write dry-run, nothing written).\n' +
+            '- "syntax": compatibility check; when available prefer SAPRead(type="SYNTAX", objectType, name, version?, source?).\n' +
             '- "unittest": harmless ABAP Unit for CLAS/PROG/FUGR or DEVC (exact; includeSubpackages recurses).\n' +
             '- "unittest_ci": harmless package tests with source reconciliation; empty/incomplete runs fail.\n' +
             '- "atc": run ATC checks (name+type or objects [{type,name}], max 20; omit variant to bind the system default; unknown variant = error). "atc_variants": list variants + that default (variant = name filter; read-only).\n' +
             '- "atc_ci": package ATC CI; requires available API and verified selection.\n' +
             '- "cds_testcases": SAP-suggested ABAP Unit test cases for a CDS entity (name; read-only; SAP_BASIS 8.16+).\n' +
-            '- "object_state": compare active vs inactive source versions (name+type; CLAS compares all includes). Returns ETags/hashes/divergence flags.\n' +
+            '- "object_state": active/inactive ETags, hashes and divergence (name+type; CLAS: all includes). Server-driven types unsupported.\n' +
             '- "quickfix": proposals at name+type+source+line (optional column/sourceUri).\n' +
             '- "apply_quickfix": return proposal text deltas without writing; needs quickfix inputs + proposalUri/proposalUserContent.\n' +
             '- "dumps": list/read ST22 short dumps (no id = list, newest first, user/from/to/maxResults; id = read; includeFullText, sections).\n' +
@@ -1448,6 +1433,10 @@ export function getToolDefinitions(config, textSearchAvailable, resolvedFeatures
                         enum: ['create', 'modify'],
                         description: 'Check mode: create (default) or modify.',
                     },
+                    group: {
+                        type: 'string',
+                        description: 'check/history: parent group for INCL L<group>… or a new FUNC; existing FUNC auto-resolves.',
+                    },
                     pgmid: {
                         type: 'string',
                         description: 'Program ID for remove_object: "R3TR" (whole object) or "LIMU" (sub-object). Required — object type alone does not determine pgmid.',