arc-1 0.6.0 → 0.6.2

package/dist/handlers/tools.js

@@ -49,6 +49,10 @@ const SAPREAD_TYPES_ONPREM = [
     'MESSAGES',
     'TEXT_ELEMENTS',
     'VARIANTS',
+    'BSP',
+    'BSP_DEPLOY',
+    'API_STATE',
+    'INACTIVE_OBJECTS',
 ];
 /** SAPRead types available on BTP ABAP Environment (no PROG, INCL, VIEW, TEXT_ELEMENTS, VARIANTS) */
 const SAPREAD_TYPES_BTP = [
@@ -70,20 +74,47 @@ const SAPREAD_TYPES_BTP = [
     'SYSTEM',
     'COMPONENTS',
     'MESSAGES',
+    'BSP',
+    'BSP_DEPLOY',
+    'API_STATE',
+    'INACTIVE_OBJECTS',
 ];
-const SAPREAD_DESC_ONPREM = 'Read SAP ABAP objects. Types: PROG, CLAS, INTF, FUNC, FUGR (use expand_includes=true to get all include sources), INCL, DDLS, DDLX (CDS metadata extensions — UI annotations), BDEF, SRVD, SRVB (service bindings — returns structured binding info: OData version, publish status, service definition ref), TABL, VIEW, STRU (DDIC structures like BAPIRET2 — returns CDS-like source), DOMA (DDIC domains — returns type info, value table, fixed values), DTEL (data elements — returns domain, labels, search help), TRAN (transaction codes — returns description, program, package), TABLE_CONTENTS, DEVC, SOBJ (BOR business objects — returns method catalog or full implementation), SYSTEM, COMPONENTS, MESSAGES, TEXT_ELEMENTS, VARIANTS. For CLAS: omit include to get the full class source (definition + implementation combined). The include param is optional — use it only to read class-local sections: definitions (local types), implementations (local helper classes), macros, testclasses (ABAP Unit). For CLAS with method param: use method="*" to list all methods with signatures and visibility, or method="method_name" to read a single method implementation (95% fewer tokens than full source). For SOBJ: returns BOR method catalog; use method param to read a specific method implementation.';
-const SAPREAD_DESC_BTP = 'Read SAP ABAP objects (BTP ABAP Environment). Types: CLAS, INTF, FUNC (released/custom only), FUGR (released/custom only), DDLS (CDS views — primary data model on BTP), DDLX (CDS metadata extensions — UI annotations for Fiori Elements), BDEF (RAP behavior definitions), SRVD (service definitions), SRVB (service bindings — returns structured binding info: OData version, publish status, service definition ref), TABL (custom tables only), STRU (DDIC structures — returns CDS-like source), DOMA (DDIC domains — type info, value table, fixed values), DTEL (data elements — domain, labels, search help), TABLE_CONTENTS (custom tables and released CDS only — SAP standard tables are blocked), DEVC, SYSTEM, COMPONENTS, MESSAGES (custom message classes only). For CLAS: omit include to get the full class source. The include param reads class-local sections: definitions, implementations, macros, testclasses. For CLAS with method param: use method="*" to list all methods with signatures and visibility, or method="method_name" to read a single method (95% fewer tokens). Note: PROG, INCL, VIEW, TRAN, TEXT_ELEMENTS, VARIANTS are not available on BTP — use CLAS with IF_OO_ADT_CLASSRUN for console applications, and DDLS for data models instead of classic views.';
+const SAPREAD_DESC_ONPREM = 'Read SAP ABAP objects. Types: PROG, CLAS, INTF, FUNC, FUGR (use expand_includes=true to get all include sources), INCL, DDLS, DDLX (CDS metadata extensions — UI annotations), BDEF, SRVD, SRVB (service bindings — returns structured binding info: OData version, publish status, service definition ref), TABL, VIEW, STRU (DDIC structures like BAPIRET2 — returns CDS-like source), DOMA (DDIC domains — returns type info, value table, fixed values), DTEL (data elements — returns domain, labels, search help), TRAN (transaction codes — returns description, program, package), TABLE_CONTENTS, DEVC, SOBJ (BOR business objects — returns method catalog or full implementation), SYSTEM, COMPONENTS, MESSAGES, TEXT_ELEMENTS, VARIANTS. For CLAS: omit include to get the full class source (definition + implementation combined). The include param is optional — use it only to read class-local sections: definitions (local types), implementations (local helper classes), macros, testclasses (ABAP Unit). For CLAS with method param: use method="*" to list all methods with signatures and visibility, or method="method_name" to read a single method implementation (95% fewer tokens than full source). For SOBJ: returns BOR method catalog; use method param to read a specific method implementation. BSP (deployed UI5/Fiori apps — list apps, browse files, read content; use name to browse app structure, include for subfolder or file), BSP_DEPLOY (query deployed UI5 apps via ABAP Repository OData Service — returns name, package, description). API_STATE (API release state — checks if an object is released for ABAP Cloud / S/4HANA Clean Core; returns contract states C0-C4, successor info; use objectType param for non-class objects). INACTIVE_OBJECTS (list all objects pending activation — no name param needed; use before SAPActivate batch_activate to see what needs activating).';
+const SAPREAD_DESC_BTP = 'Read SAP ABAP objects (BTP ABAP Environment). Types: CLAS, INTF, FUNC (released/custom only), FUGR (released/custom only), DDLS (CDS views — primary data model on BTP), DDLX (CDS metadata extensions — UI annotations for Fiori Elements), BDEF (RAP behavior definitions), SRVD (service definitions), SRVB (service bindings — returns structured binding info: OData version, publish status, service definition ref), TABL (custom tables only), STRU (DDIC structures — returns CDS-like source), DOMA (DDIC domains — type info, value table, fixed values), DTEL (data elements — domain, labels, search help), TABLE_CONTENTS (custom tables and released CDS only — SAP standard tables are blocked), DEVC, SYSTEM, COMPONENTS, MESSAGES (custom message classes only). For CLAS: omit include to get the full class source. The include param reads class-local sections: definitions, implementations, macros, testclasses. For CLAS with method param: use method="*" to list all methods with signatures and visibility, or method="method_name" to read a single method (95% fewer tokens). Note: PROG, INCL, VIEW, TRAN, TEXT_ELEMENTS, VARIANTS are not available on BTP — use CLAS with IF_OO_ADT_CLASSRUN for console applications, and DDLS for data models instead of classic views. BSP (deployed UI5/Fiori apps — list apps, browse files, read content; use name to browse app structure, include for subfolder or file), BSP_DEPLOY (query deployed UI5 apps via ABAP Repository OData Service — returns name, package, description). API_STATE (API release state — checks if an object is released for ABAP Cloud / Clean Core; returns contract states C0-C4, successor info; essential for cloud development; use objectType param for non-class objects). INACTIVE_OBJECTS (list all objects pending activation — no name param needed; use before SAPActivate batch_activate to see what needs activating).';
 // ─── SAPWrite Types ─────────────────────────────────────────────────
-const SAPWRITE_TYPES_ONPREM = ['PROG', 'CLAS', 'INTF', 'FUNC', 'INCL', 'DDLS', 'DDLX', 'BDEF', 'SRVD'];
-const SAPWRITE_TYPES_BTP = ['CLAS', 'INTF', 'DDLS', 'DDLX', 'BDEF', 'SRVD'];
-const SAPWRITE_DESC_ONPREM = 'Create or update ABAP source code. Handles lock/modify/unlock automatically. Supports PROG, CLAS, INTF, FUNC, INCL, DDLS, DDLX, BDEF, SRVD. ' +
+const SAPWRITE_TYPES_ONPREM = [
+    'PROG',
+    'CLAS',
+    'INTF',
+    'FUNC',
+    'INCL',
+    'DDLS',
+    'DDLX',
+    'BDEF',
+    'SRVD',
+    'SRVB',
+    'TABL',
+    'DOMA',
+    'DTEL',
+    'MSAG',
+];
+const SAPWRITE_TYPES_BTP = ['CLAS', 'INTF', 'DDLS', 'DDLX', 'BDEF', 'SRVD', 'SRVB', 'TABL', 'DOMA', 'DTEL', 'MSAG'];
+const SAPWRITE_DESC_ONPREM = 'Create or update ABAP source code and DDIC metadata. Handles lock/modify/unlock automatically. Supports PROG, CLAS, INTF, FUNC, INCL, DDLS, DDLX, BDEF, SRVD, SRVB, TABL, DOMA, DTEL, MSAG. ' +
+    'TABL uses source-based writes via /source/main (define table syntax), similar to DDLS/BDEF/SRVD. ' +
+    'DOMA/DTEL use metadata XML writes (not /source/main): provide DDIC fields like dataType, length, fixedValues, typeKind, labels, searchHelp. ' +
+    'MSAG (message classes) use metadata XML writes: provide "messages" array with {number, shortText} entries. Create empty then update, or provide messages at creation. ' +
+    'SRVB (service bindings) use metadata XML writes: provide serviceDefinition (SRVD name) plus optional bindingType/category. ' +
     'For edit_method: surgically replace a single method body in a CLAS without sending the full class source. ' +
     'Provide just the new method implementation code in "source" — 95% fewer tokens than full-class updates. ' +
-    'For batch_create: create and activate multiple objects in a single call — ideal for RAP stacks. Pass "objects" array with dependency order.';
-const SAPWRITE_DESC_BTP = 'Create or update ABAP source code (BTP ABAP Environment). Handles lock/modify/unlock automatically. Supports CLAS, INTF, DDLS, DDLX, BDEF, SRVD. ' +
+    'For batch_create: create and activate multiple objects in a single call — ideal for RAP stacks (TABL → DDLS → BDEF → SRVD). Pass "objects" array with dependency order.';
+const SAPWRITE_DESC_BTP = 'Create or update ABAP source code and DDIC metadata (BTP ABAP Environment). Handles lock/modify/unlock automatically. Supports CLAS, INTF, DDLS, DDLX, BDEF, SRVD, SRVB, TABL, DOMA, DTEL, MSAG. ' +
+    'TABL supports custom table source writes via /source/main (define table syntax). ' +
+    'DOMA/DTEL use metadata XML writes (not /source/main): provide DDIC fields like dataType, length, fixedValues, typeKind, labels, searchHelp. ' +
+    'MSAG (message classes) use metadata XML writes: provide "messages" array with {number, shortText} entries. ' +
+    'SRVB (service bindings) use metadata XML writes: provide serviceDefinition (SRVD name) plus optional bindingType/category. ' +
     'Must use ABAP Cloud language version (no classic statements). Only Z*/Y* namespace allowed on BTP. ' +
     'For edit_method: surgically replace a single method body in a CLAS without sending the full class source. ' +
-    'For batch_create: create and activate multiple objects in a single call — ideal for RAP stacks.';
+    'For batch_create: create and activate multiple objects in a single call — ideal for RAP stacks (TABL → DDLS → BDEF → SRVD).';
 // ─── SAPContext Types ───────────────────────────────────────────────
 const SAPCONTEXT_TYPES_ONPREM = ['CLAS', 'INTF', 'PROG', 'FUNC', 'DDLS'];
 const SAPCONTEXT_TYPES_BTP = ['CLAS', 'INTF', 'DDLS'];
@@ -102,7 +133,10 @@ const SAPCONTEXT_DESC_ONPREM = 'Get compressed dependency context for an ABAP ob
     'Filtering: SAP standard objects (CL_ABAP_*, IF_ABAP_*, CX_SY_*) are excluded — the LLM already knows standard SAP APIs. ' +
     'Custom objects (Z*, Y*) are prioritized.\n\n' +
     'Use SAPContext BEFORE writing code that modifies or extends existing objects. ' +
-    'Use SAPRead to get the full source of the target object, then SAPContext to understand its dependencies.';
+    'Use SAPRead to get the full source of the target object, then SAPContext to understand its dependencies.\n\n' +
+    'For CDS analysis: Use SAPContext instead of reading each view in the dependency chain individually. ' +
+    'A single SAPContext call on a consumption view (e.g., ZC_*) returns all dependent interface views, tables, and associations — ' +
+    'replacing 5-10 separate SAPRead calls. Only use targeted SAPRead for metadata extensions (DDLX) or service bindings (SRVB) that SAPContext does not cover.';
 const SAPCONTEXT_DESC_BTP = 'Get compressed dependency context for an ABAP object or CDS entity (BTP ABAP Environment). Returns only the public API contracts ' +
     '(method signatures, interface definitions, type declarations) of all objects that the target depends on — ' +
     'NOT the full source code. This is the most token-efficient way to understand dependencies.\n\n' +
@@ -113,7 +147,10 @@ const SAPCONTEXT_DESC_BTP = 'Get compressed dependency context for an ABAP objec
     "Each dependency's full source is included. Essential for CDS unit test generation.\n\n" +
     'On BTP: released SAP objects (CL_ABAP_*, IF_ABAP_*) are included since they form the primary development API surface. ' +
     'Custom objects (Z*, Y*) are also included.\n\n' +
-    'Use SAPContext BEFORE writing code that modifies or extends existing objects.';
+    'Use SAPContext BEFORE writing code that modifies or extends existing objects.\n\n' +
+    'For CDS analysis: Use SAPContext instead of reading each view in the dependency chain individually. ' +
+    'A single SAPContext call on a consumption view returns all dependent interface views, tables, and associations — ' +
+    'replacing 5-10 separate SAPRead calls.';
 // ─── SAPQuery ───────────────────────────────────────────────────────
 const SAPQUERY_DESC_ONPREM = 'Execute ABAP SQL queries against SAP tables. Returns structured data with column names and rows. ' +
     'Powerful for reverse-engineering: query metadata tables like DD02L (table catalog), DD03L (field catalog), ' +
@@ -135,28 +172,52 @@ const SAPSEARCH_DESC_BTP = 'Search for ABAP objects or search within source code
     '2. Source code search (searchType="source_code"): Full-text search within ABAP source code.\n\n' +
     "Tips: On BTP, focus on classes (CL_*), interfaces (IF_*), CDS views (I_*), and custom Z/Y objects.\n\nNote: Searches object names only (classes, CDS views, etc.) — field/column names are not searchable here. To find fields by name, use SAPRead(type='DDLS', include='elements') for CDS views.";
 // ─── SAPTransport ───────────────────────────────────────────────────
-const SAPTRANSPORT_DESC_ONPREM = 'Manage CTS transport requests: list, get details, create, and release.';
-const SAPTRANSPORT_DESC_BTP = 'Manage transport requests (BTP ABAP Environment): list, get details, create, and release. ' +
+const SAPTRANSPORT_DESC_ONPREM = 'Manage CTS transport requests (SE09/SE10 equivalent). ' +
+    'Actions: list (defaults to current user, modifiable transports — both Workbench and Customizing), ' +
+    'get (details with tasks and objects), create (K=Workbench, W=Customizing, T=Transport of Copies), ' +
+    'release, delete, reassign (change owner), release_recursive (release tasks first, then parent), ' +
+    'check (check if a package requires a transport — provide type, name, package). ' +
+    'Transport IDs look like A4HK900123. Status: D=modifiable, R=released.';
+const SAPTRANSPORT_DESC_BTP = 'Manage transport requests (BTP ABAP Environment, SE09/SE10 equivalent). ' +
+    'Actions: list (defaults to current user, modifiable transports — both Workbench and Customizing), ' +
+    'get (details with tasks and objects), create (K=Workbench, W=Customizing, T=Transport of Copies), ' +
+    'release, delete, reassign (change owner), release_recursive (release tasks first, then parent), ' +
+    'check (check if a package requires a transport — provide type, name, package). ' +
     'On BTP, transport release triggers a gCTS push to the software component Git repository. ' +
     'Import into target systems is done via the Manage Software Components app or Cloud Transport Management Service (cTMS), not via this tool.';
 // ─── SAPManage ──────────────────────────────────────────────────────
 const SAPMANAGE_DESC_ONPREM = 'Probe and report SAP system capabilities. Use this BEFORE attempting operations that depend on optional ' +
-    'features (abapGit, RAP/CDS, AMDP, HANA, UI5/Fiori, CTS transports).\n\n' +
+    'features (abapGit, RAP/CDS, AMDP, HANA, UI5/Fiori, CTS transports, FLP customization). Also handles package (DEVC) lifecycle operations.\n\n' +
     'Actions:\n' +
     '- "features": Get cached feature status from last probe (fast, no SAP round-trip). ' +
     'Returns which features are available, their mode (auto/on/off), and when they were last probed.\n' +
-    '- "probe": Re-probe the SAP system now (makes 7 parallel requests, ~1-2s). ' +
-    'Use this on first use or if you suspect feature availability has changed.\n\n' +
+    '- "probe": Re-probe the SAP system now (makes 8 parallel requests, ~1-2s). ' +
+    'Use this on first use or if you suspect feature availability has changed.\n' +
+    '- "cache_stats": Show object cache health and warmup state.\n' +
+    '- "create_package": Create a package (DEVC) via ADT packages API.\n' +
+    '- "delete_package": Delete an existing package.\n' +
+    '- "flp_list_catalogs": List FLP business catalogs.\n' +
+    '- "flp_list_groups": List FLP groups.\n' +
+    '- "flp_list_tiles": List tiles in a catalog (requires "catalogId").\n' +
+    '- "flp_create_catalog": Create a business catalog (requires "domainId", "title").\n' +
+    '- "flp_create_group": Create a group (requires "groupId", "title").\n' +
+    '- "flp_create_tile": Create a tile in a catalog (requires "catalogId", "tile").\n' +
+    '- "flp_add_tile_to_group": Add a catalog tile to a group (requires "groupId", "catalogId", "tileInstanceId").\n' +
+    '- "flp_delete_catalog": Delete a business catalog (requires "catalogId").\n\n' +
     'Returns JSON with features, each having: id, available (bool), mode, message, and probedAt timestamp. ' +
     'Also returns systemType ("btp" or "onprem") for understanding available capabilities. ' +
     '"available: false" means do NOT attempt operations that depend on it.';
 const SAPMANAGE_DESC_BTP = 'Probe and report SAP system capabilities (BTP ABAP Environment). ' +
-    'Returns feature status and system type.\n\n' +
+    'Returns feature status and system type. Also handles package (DEVC) lifecycle operations.\n\n' +
     'Actions:\n' +
     '- "features": Get cached feature status from last probe.\n' +
-    '- "probe": Re-probe the SAP system now.\n\n' +
+    '- "probe": Re-probe the SAP system now.\n' +
+    '- "cache_stats": Show object cache health and warmup state.\n' +
+    '- "create_package": Create a package (DEVC) via ADT packages API.\n' +
+    '- "delete_package": Delete an existing package.\n' +
+    '- FLP actions: flp_list_catalogs, flp_list_groups, flp_list_tiles, flp_create_catalog, flp_create_group, flp_create_tile, flp_add_tile_to_group, flp_delete_catalog.\n\n' +
     'Returns JSON with features and systemType="btp". On BTP, RAP/CDS and transports are always available. ' +
-    'abapGit, AMDP, UI5/BSP may not be available depending on the BTP ABAP configuration.';
+    'abapGit, AMDP, UI5/BSP, and FLP customization may not be available depending on the BTP ABAP configuration.';
 // ─── SAPSearch Builder ─────────────────────────────────────────────
 /** Strip source_code-specific lines from a SAPSearch description when textSearch is unavailable */
 function stripSourceCodeLines(desc) {
@@ -263,6 +324,10 @@ export function getToolDefinitions(config, textSearchAvailable) {
                     },
                     maxRows: { type: 'number', description: 'For TABLE_CONTENTS: max rows to return (default 100)' },
                     sqlFilter: { type: 'string', description: 'For TABLE_CONTENTS: SQL WHERE clause filter' },
+                    objectType: {
+                        type: 'string',
+                        description: 'For API_STATE: SAP object type (CLAS, INTF, PROG, FUGR, TABL, DDLS, etc.) — auto-detected from name if omitted',
+                    },
                 },
                 required: ['type'],
             },
@@ -291,7 +356,9 @@ export function getToolDefinitions(config, textSearchAvailable) {
                     type: {
                         type: 'string',
                         enum: btp ? SAPWRITE_TYPES_BTP : SAPWRITE_TYPES_ONPREM,
-                        description: 'Object type (for create/update/delete/edit_method)',
+                        description: btp
+                            ? 'Object type (for create/update/delete/edit_method). Supported: CLAS, INTF, DDLS, DDLX, BDEF, SRVD, TABL, DOMA, DTEL.'
+                            : 'Object type (for create/update/delete/edit_method). Supported: PROG, CLAS, INTF, FUNC, INCL, DDLS, DDLX, BDEF, SRVD, TABL, DOMA, DTEL.',
                     },
                     name: { type: 'string', description: 'Object name (for create/update/delete/edit_method)' },
                     source: { type: 'string', description: 'ABAP source code (for create/update/edit_method)' },
@@ -303,8 +370,59 @@ export function getToolDefinitions(config, textSearchAvailable) {
                         type: 'string',
                         description: 'Object description for create action (defaults to name if omitted). Max 60 chars for most types.',
                     },
-                    package: { type: 'string', description: 'Package for new objects (default $TMP)' },
-                    transport: { type: 'string', description: 'Transport request number (for transportable packages)' },
+                    package: {
+                        type: 'string',
+                        description: 'Package for new objects (default $TMP). Non-$TMP packages require a transport number.',
+                    },
+                    transport: {
+                        type: 'string',
+                        description: 'Transport request number. Required for non-$TMP packages. Use SAPTransport(action="list") to find or SAPTransport(action="create") to create one.',
+                    },
+                    dataType: { type: 'string', description: 'DOMA/DTEL: ABAP data type (e.g., CHAR, NUMC, DEC)' },
+                    length: { type: 'number', description: 'DOMA/DTEL: data type length' },
+                    decimals: { type: 'number', description: 'DOMA/DTEL: decimal places' },
+                    outputLength: { type: 'number', description: 'DOMA: output length' },
+                    conversionExit: { type: 'string', description: 'DOMA: conversion exit (e.g., ALPHA)' },
+                    signExists: { type: 'boolean', description: 'DOMA: signed values allowed' },
+                    lowercase: { type: 'boolean', description: 'DOMA: lowercase characters allowed' },
+                    fixedValues: {
+                        type: 'array',
+                        description: 'DOMA: fixed value ranges',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                low: { type: 'string', description: 'Low value (required)' },
+                                high: { type: 'string', description: 'High value for ranges (optional)' },
+                                description: { type: 'string', description: 'Value description (optional)' },
+                            },
+                            required: ['low'],
+                        },
+                    },
+                    valueTable: { type: 'string', description: 'DOMA: value table reference (e.g., T001)' },
+                    typeKind: {
+                        type: 'string',
+                        enum: ['domain', 'predefinedAbapType'],
+                        description: 'DTEL: type source (domain reference or predefined ABAP type)',
+                    },
+                    typeName: { type: 'string', description: 'DTEL: domain/type name reference (for typeKind=domain)' },
+                    domainName: { type: 'string', description: 'DTEL: alias for typeName when referencing a domain' },
+                    shortLabel: { type: 'string', description: 'DTEL: short field label' },
+                    mediumLabel: { type: 'string', description: 'DTEL: medium field label' },
+                    longLabel: { type: 'string', description: 'DTEL: long field label' },
+                    headingLabel: { type: 'string', description: 'DTEL: heading field label' },
+                    searchHelp: { type: 'string', description: 'DTEL: search help name' },
+                    searchHelpParameter: { type: 'string', description: 'DTEL: search help parameter' },
+                    setGetParameter: { type: 'string', description: 'DTEL: SET/GET parameter ID' },
+                    defaultComponentName: { type: 'string', description: 'DTEL: default component name' },
+                    changeDocument: { type: 'boolean', description: 'DTEL: enable change document flag' },
+                    serviceDefinition: { type: 'string', description: 'SRVB: service definition name (SRVD) to bind to' },
+                    bindingType: { type: 'string', description: 'SRVB: binding type (default: ODATA)' },
+                    category: {
+                        type: 'string',
+                        enum: ['0', '1'],
+                        description: 'SRVB: binding category (0=UI, 1=Web API; default: 0)',
+                    },
+                    version: { type: 'string', description: 'SRVB: service version (default: 0001)' },
                     objects: {
                         type: 'array',
                         items: {
@@ -313,17 +431,58 @@ export function getToolDefinitions(config, textSearchAvailable) {
                                 type: {
                                     type: 'string',
                                     enum: btp ? SAPWRITE_TYPES_BTP : SAPWRITE_TYPES_ONPREM,
-                                    description: 'Object type',
+                                    description: 'Object type (includes TABL for RAP stack bootstrapping)',
                                 },
                                 name: { type: 'string', description: 'Object name' },
                                 source: { type: 'string', description: 'ABAP source code (optional — some objects have no source)' },
                                 description: { type: 'string', description: 'Object description (defaults to name if omitted)' },
+                                dataType: { type: 'string', description: 'DOMA/DTEL: ABAP data type' },
+                                length: { type: 'number', description: 'DOMA/DTEL: data type length' },
+                                decimals: { type: 'number', description: 'DOMA/DTEL: decimal places' },
+                                outputLength: { type: 'number', description: 'DOMA: output length' },
+                                conversionExit: { type: 'string', description: 'DOMA: conversion exit' },
+                                signExists: { type: 'boolean', description: 'DOMA: signed values allowed' },
+                                lowercase: { type: 'boolean', description: 'DOMA: lowercase allowed' },
+                                fixedValues: {
+                                    type: 'array',
+                                    description: 'DOMA: fixed value ranges',
+                                    items: {
+                                        type: 'object',
+                                        properties: {
+                                            low: { type: 'string' },
+                                            high: { type: 'string' },
+                                            description: { type: 'string' },
+                                        },
+                                        required: ['low'],
+                                    },
+                                },
+                                valueTable: { type: 'string', description: 'DOMA: value table' },
+                                typeKind: { type: 'string', enum: ['domain', 'predefinedAbapType'], description: 'DTEL: type mode' },
+                                typeName: { type: 'string', description: 'DTEL: domain/type name reference' },
+                                domainName: { type: 'string', description: 'DTEL: alias for typeName' },
+                                shortLabel: { type: 'string', description: 'DTEL: short field label' },
+                                mediumLabel: { type: 'string', description: 'DTEL: medium field label' },
+                                longLabel: { type: 'string', description: 'DTEL: long field label' },
+                                headingLabel: { type: 'string', description: 'DTEL: heading field label' },
+                                searchHelp: { type: 'string', description: 'DTEL: search help' },
+                                searchHelpParameter: { type: 'string', description: 'DTEL: search help parameter' },
+                                setGetParameter: { type: 'string', description: 'DTEL: SET/GET parameter ID' },
+                                defaultComponentName: { type: 'string', description: 'DTEL: default component name' },
+                                changeDocument: { type: 'boolean', description: 'DTEL: change document flag' },
+                                serviceDefinition: { type: 'string', description: 'SRVB: service definition (SRVD)' },
+                                bindingType: { type: 'string', description: 'SRVB: binding type (default ODATA)' },
+                                category: {
+                                    type: 'string',
+                                    enum: ['0', '1'],
+                                    description: 'SRVB: binding category (0=UI, 1=Web API)',
+                                },
+                                version: { type: 'string', description: 'SRVB: service version (default 0001)' },
                             },
                             required: ['type', 'name'],
                         },
                         description: 'For batch_create: ordered list of objects to create and activate. Each object needs type, name, and source (if applicable). ' +
-                            'Objects are created and activated in array order — put dependencies first (e.g., CDS view before projection, BDEF after CDS views). ' +
-                            'Example: [{type:"DDLS",name:"ZI_TRAVEL",source:"..."},{type:"BDEF",name:"ZI_TRAVEL",source:"..."},{type:"SRVD",name:"ZSD_TRAVEL",source:"..."}]',
+                            'Objects are created and activated in array order — put dependencies first (e.g., TABL before DDLS, BDEF after DDLS). ' +
+                            'Example: [{type:"TABL",name:"ZTRAVEL",source:"..."},{type:"DDLS",name:"ZI_TRAVEL",source:"..."},{type:"BDEF",name:"ZI_TRAVEL",source:"..."},{type:"SRVD",name:"ZSD_TRAVEL",source:"..."}]',
                     },
                 },
                 required: ['action'],
@@ -332,13 +491,29 @@ export function getToolDefinitions(config, textSearchAvailable) {
         tools.push({
             name: 'SAPActivate',
             description: 'Activate (publish) ABAP objects. Supports single object or batch activation.\n' +
-                'For batch: pass "objects" array with {type, name} entries to activate multiple objects in one call. ' +
-                'Essential for RAP stacks where DDLS, BDEF, SRVD, DDLX, and SRVB depend on each other and must be activated together.',
+                'ALWAYS prefer batch activation when activating 2+ objects — pass "objects" array with {type, name} entries. ' +
+                'Batch activation is more efficient (one SAP round-trip) and works for ANY combination of objects, not just dependent ones. ' +
+                'It is required for RAP stacks where DDLS, BDEF, SRVD depend on each other, but equally useful for unrelated objects like multiple DTELs or DOMAs.\n' +
+                'For publish_srvb/unpublish_srvb: publish or unpublish an OData service binding (SRVB) — makes the OData service available for consumption.',
             inputSchema: {
                 type: 'object',
                 properties: {
-                    name: { type: 'string', description: 'Object name (for single activation)' },
+                    action: {
+                        type: 'string',
+                        enum: ['activate', 'publish_srvb', 'unpublish_srvb'],
+                        description: 'Action to perform. "activate" (default): activate ABAP objects. ' +
+                            '"publish_srvb": publish a service binding to make OData service available. ' +
+                            '"unpublish_srvb": unpublish a service binding.',
+                    },
+                    name: { type: 'string', description: 'Object name (for single activation or publish/unpublish)' },
                     type: { type: 'string', description: 'Object type (PROG, CLAS, DDLS, DDLX, BDEF, SRVD, SRVB, etc.)' },
+                    version: { type: 'string', description: 'Service version for publish/unpublish (default: "0001")' },
+                    preaudit: {
+                        type: 'boolean',
+                        description: 'Request pre-activation audit from SAP (default: true). ' +
+                            'When true, SAP checks for issues before activating and returns warnings/errors. ' +
+                            'Set to false to skip pre-audit for faster activation when confident the code is correct.',
+                    },
                     objects: {
                         type: 'array',
                         items: {
@@ -349,8 +524,8 @@ export function getToolDefinitions(config, textSearchAvailable) {
                             },
                             required: ['type', 'name'],
                         },
-                        description: 'For batch activation: array of objects to activate together. ' +
-                            'Use for RAP stacks: [{type:"DDLS",name:"ZI_TRAVEL"},{type:"CLAS",name:"ZBP_I_TRAVEL"},{type:"BDEF",name:"ZI_TRAVEL"},{type:"DDLS",name:"ZC_TRAVEL"},{type:"BDEF",name:"ZC_TRAVEL"},{type:"DDLX",name:"ZC_TRAVEL"},{type:"SRVD",name:"ZSD_TRAVEL"}]',
+                        description: 'Batch activation: array of objects to activate in one call. Use whenever activating 2+ objects. ' +
+                            'Works for any mix of types — e.g., [{type:"DOMA",name:"Z_DOM"},{type:"DTEL",name:"Z_DEL"}] or RAP stacks like [{type:"DDLS",name:"ZI_TRAVEL"},{type:"BDEF",name:"ZI_TRAVEL"},{type:"SRVD",name:"ZSD_TRAVEL"}].',
                     },
                 },
             },
@@ -359,14 +534,14 @@ export function getToolDefinitions(config, textSearchAvailable) {
     tools.push({
         name: 'SAPNavigate',
         description: btp
-            ? 'Navigate code (BTP ABAP Environment): find definitions, references (where-used), and code completion. Use for "go to definition", "where is this used?", and auto-complete. For references: uses the full scope-based Where-Used API returning detailed results with line numbers, snippets, and package info. Optional objectType filter narrows results to a specific ADT type in slash format (e.g., CLAS/OC, PROG/P). On BTP, navigation scope is limited to released SAP objects and custom Z/Y objects.'
-            : 'Navigate code: find definitions, references (where-used), and code completion. Use for "go to definition", "where is this used?", and auto-complete. For references: uses the full scope-based Where-Used API returning detailed results with line numbers, snippets, and package info. Optional objectType filter narrows results to a specific ADT type in slash format (e.g., CLAS/OC, PROG/P). You can use type+name instead of uri (e.g., type="CLAS", name="ZCL_ORDER") for a where-used list without needing the full ADT URI.',
+            ? 'Navigate code (BTP ABAP Environment): find definitions, references (where-used), code completion, and class hierarchy. Use for "go to definition", "where is this used?", "what does this class inherit?", and auto-complete. For references: uses the full scope-based Where-Used API returning detailed results with line numbers, snippets, and package info. Optional objectType filter narrows results to a specific ADT type in slash format (e.g., CLAS/OC, PROG/P). On BTP, navigation scope is limited to released SAP objects and custom Z/Y objects.'
+            : 'Navigate code: find definitions, references (where-used), code completion, and class hierarchy. Use for "go to definition", "where is this used?", "what does this class inherit?", and auto-complete. For references: uses the full scope-based Where-Used API returning detailed results with line numbers, snippets, and package info. Optional objectType filter narrows results to a specific ADT type in slash format (e.g., CLAS/OC, PROG/P). For hierarchy: returns superclass, implemented interfaces, and direct subclasses via SEOMETAREL. You can use type+name instead of uri (e.g., type="CLAS", name="ZCL_ORDER") for a where-used list without needing the full ADT URI.',
         inputSchema: {
             type: 'object',
             properties: {
                 action: {
                     type: 'string',
-                    enum: ['definition', 'references', 'completion'],
+                    enum: ['definition', 'references', 'completion', 'hierarchy'],
                     description: 'Navigation action',
                 },
                 uri: {
@@ -388,18 +563,23 @@ export function getToolDefinitions(config, textSearchAvailable) {
             },
             required: ['action'],
         },
-    }, {
-        name: 'SAPQuery',
-        description: btp ? SAPQUERY_DESC_BTP : SAPQUERY_DESC_ONPREM,
-        inputSchema: {
-            type: 'object',
-            properties: {
-                sql: { type: 'string', description: 'ABAP SQL SELECT statement' },
-                maxRows: { type: 'number', description: 'Maximum rows (default 100)' },
+    });
+    // SAPQuery — only registered when free SQL is allowed
+    if (!config.blockFreeSQL) {
+        tools.push({
+            name: 'SAPQuery',
+            description: btp ? SAPQUERY_DESC_BTP : SAPQUERY_DESC_ONPREM,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sql: { type: 'string', description: 'ABAP SQL SELECT statement' },
+                    maxRows: { type: 'number', description: 'Maximum rows (default 100)' },
+                },
+                required: ['sql'],
             },
-            required: ['sql'],
-        },
-    }, {
+        });
+    }
+    tools.push({
         name: 'SAPLint',
         description: 'Run local abaplint rules on ABAP source code. System-aware: auto-selects cloud or on-prem rules based on detected system type.\n\n' +
             'Actions:\n' +
@@ -518,8 +698,86 @@ export function getToolDefinitions(config, textSearchAvailable) {
                 properties: {
                     action: {
                         type: 'string',
-                        enum: ['features', 'probe', 'cache_stats'],
-                        description: 'Action: "features" for cached status, "probe" to re-check SAP system, "cache_stats" for object cache statistics',
+                        enum: [
+                            'features',
+                            'probe',
+                            'cache_stats',
+                            'create_package',
+                            'delete_package',
+                            'flp_list_catalogs',
+                            'flp_list_groups',
+                            'flp_list_tiles',
+                            'flp_create_catalog',
+                            'flp_create_group',
+                            'flp_create_tile',
+                            'flp_add_tile_to_group',
+                            'flp_delete_catalog',
+                        ],
+                        description: 'Action to execute. Includes package lifecycle (create/delete) and FLP actions for catalogs/groups/tiles via PAGE_BUILDER_CUST OData service.',
+                    },
+                    name: {
+                        type: 'string',
+                        description: 'Package name (required for create_package and delete_package).',
+                    },
+                    description: {
+                        type: 'string',
+                        description: 'Package description (required for create_package).',
+                    },
+                    superPackage: {
+                        type: 'string',
+                        description: 'Parent package for create_package (defaults to empty root package).',
+                    },
+                    softwareComponent: {
+                        type: 'string',
+                        description: 'Software component for create_package (default: LOCAL).',
+                    },
+                    transportLayer: {
+                        type: 'string',
+                        description: 'Transport layer for create_package (optional; required by some transportable landscapes).',
+                    },
+                    packageType: {
+                        type: 'string',
+                        enum: ['development', 'structure', 'main'],
+                        description: 'Package type for create_package (default: development).',
+                    },
+                    transport: {
+                        type: 'string',
+                        description: 'Optional transport request (corrNr) for create_package or delete_package.',
+                    },
+                    catalogId: {
+                        type: 'string',
+                        description: 'FLP catalog identifier — accepts either full ID (X-SAP-UI2-CATALOGPAGE:MY_CAT) or domain ID (MY_CAT). Required for flp_list_tiles, flp_create_tile, flp_add_tile_to_group, flp_delete_catalog.',
+                    },
+                    groupId: {
+                        type: 'string',
+                        description: 'FLP group/page identifier (required for flp_create_group, flp_add_tile_to_group).',
+                    },
+                    title: {
+                        type: 'string',
+                        description: 'Title for FLP catalog/group creation.',
+                    },
+                    domainId: {
+                        type: 'string',
+                        description: 'Domain ID for FLP catalog creation (e.g., ZARC1_SALES).',
+                    },
+                    tileInstanceId: {
+                        type: 'string',
+                        description: 'Tile instance ID in the source catalog (required for flp_add_tile_to_group).',
+                    },
+                    tile: {
+                        type: 'object',
+                        description: 'Tile definition for flp_create_tile.',
+                        properties: {
+                            id: { type: 'string', description: 'Tile ID (client-side logical id).' },
+                            title: { type: 'string', description: 'Display title.' },
+                            icon: { type: 'string', description: 'Optional icon URI.' },
+                            semanticObject: { type: 'string', description: 'Semantic object for intent navigation.' },
+                            semanticAction: { type: 'string', description: 'Semantic action for intent navigation.' },
+                            url: { type: 'string', description: 'Optional target URL.' },
+                            subtitle: { type: 'string', description: 'Optional subtitle text.' },
+                            info: { type: 'string', description: 'Optional info text.' },
+                        },
+                        required: ['id', 'title', 'semanticObject', 'semanticAction'],
                     },
                 },
                 required: ['action'],
@@ -534,10 +792,42 @@ export function getToolDefinitions(config, textSearchAvailable) {
             inputSchema: {
                 type: 'object',
                 properties: {
-                    action: { type: 'string', enum: ['list', 'get', 'create', 'release'], description: 'Transport action' },
-                    id: { type: 'string', description: 'Transport request ID (for get/release)' },
-                    description: { type: 'string', description: 'Description (for create)' },
-                    user: { type: 'string', description: 'Filter by user (for list)' },
+                    action: {
+                        type: 'string',
+                        enum: ['list', 'get', 'create', 'release', 'delete', 'reassign', 'release_recursive', 'check'],
+                        description: 'list: show transports (defaults to current user, modifiable only). ' +
+                            'get: fetch transport details including tasks and objects. ' +
+                            'create: create a new transport request. ' +
+                            'release: release a single transport or task. ' +
+                            'delete: delete a transport (use recursive=true to delete tasks first). ' +
+                            'reassign: change transport owner (use recursive=true for tasks too). ' +
+                            'release_recursive: release all unreleased tasks first, then the transport itself. ' +
+                            'check: check if a transport is needed for a package/object (requires type, name, package).',
+                    },
+                    id: {
+                        type: 'string',
+                        description: 'Transport request ID, e.g. A4HK900123 (required for get/release/delete/reassign/release_recursive)',
+                    },
+                    description: { type: 'string', description: 'Transport description text (required for create)' },
+                    name: { type: 'string', description: 'Object name (for check action)' },
+                    package: { type: 'string', description: 'Package name (for check action)' },
+                    user: {
+                        type: 'string',
+                        description: 'SAP username to filter by (for list). Defaults to the current SAP user. Use "*" to list all users.',
+                    },
+                    status: {
+                        type: 'string',
+                        description: 'Transport status filter (for list). D=modifiable (default), R=released, "*"=all statuses.',
+                    },
+                    type: {
+                        type: 'string',
+                        description: 'For create: transport type K=Workbench (default), W=Customizing, T=Transport of Copies. For check: object type (PROG, CLAS, DDLS, etc.)',
+                    },
+                    owner: { type: 'string', description: 'New owner SAP username (required for reassign)' },
+                    recursive: {
+                        type: 'boolean',
+                        description: 'Apply recursively to child tasks (for delete/reassign). release_recursive always recurses.',
+                    },
                 },
                 required: ['action'],
             },