arc-1 0.9.13 → 0.9.15

package/dist/handlers/search.js

@@ -0,0 +1,208 @@
+/**
+ * SAPSearch handler — repository search (text, tadir lookup, info-system) + query transliteration
+ * helpers.
+ */
+import { AdtApiError } from '../adt/errors.js';
+import { classifyTextSearchError } from '../adt/features.js';
+import { cachedFeatures } from './feature-cache.js';
+import { normalizeObjectType } from './object-types.js';
+import { errorResult, textResult } from './shared.js';
+// ─── Search Helpers ─────────────────────────────────────────────────
+/**
+ * Transliterate non-ASCII characters in search queries.
+ * SAP object names are ASCII-only, so umlauts and accented characters
+ * never appear in object names. This prevents wasted searches with
+ * German terms like "*Schätzung*" that silently return empty results.
+ */
+export function transliterateQuery(query) {
+    // Explicit German umlaut replacements (must come before NFD decomposition)
+    let result = query
+        .replace(/ä/g, 'AE')
+        .replace(/Ä/g, 'AE')
+        .replace(/ö/g, 'OE')
+        .replace(/Ö/g, 'OE')
+        .replace(/ü/g, 'UE')
+        .replace(/Ü/g, 'UE')
+        .replace(/ß/g, 'SS');
+    // General fallback: strip remaining diacritics (é→e, ñ→n, etc.)
+    result = result.normalize('NFD').replace(/[\u0300-\u036f]/g, '');
+    return { normalized: result, changed: result !== query };
+}
+/**
+ * Detect if a search query looks like a field/column name rather than
+ * an object name. Field names are short, uppercase, and typically don't
+ * start with Z/Y (which are custom object prefixes).
+ */
+export function looksLikeFieldName(query) {
+    // Wildcard patterns are object searches, not field names
+    if (query.includes('*'))
+        return false;
+    if (query.length === 0 || query.length > 15)
+        return false;
+    // Must be uppercase letters, digits, underscores only
+    if (!/^[A-Z0-9_]+$/.test(query))
+        return false;
+    // Z/Y prefix → more likely an object name
+    if (/^[ZY]/.test(query))
+        return false;
+    return true;
+}
+export async function handleSAPSearch(client, args) {
+    const rawQuery = String(args.query ?? '');
+    const maxResults = Number(args.maxResults ?? 100);
+    const searchType = String(args.searchType ?? 'object');
+    if (searchType === 'tadir_lookup') {
+        const names = extractLookupNames(rawQuery, args.names);
+        if (names.length === 0) {
+            return errorResult('SAPSearch(searchType="tadir_lookup") requires names[] or query with at least one name.');
+        }
+        const objectTypes = extractLookupObjectTypes(args.objectType, args.objectTypes);
+        const rawSource = typeof args.source === 'string' ? args.source.toLowerCase() : 'adt';
+        const source = rawSource === 'db' || rawSource === 'both' ? rawSource : 'adt';
+        // Stamp each match with provenance so a merged 'both' result is unambiguous and
+        // viewer tooling can colour-code ghost rows. The DB path already stamps `_origin:'db'`
+        // (see `lookupObjectsViaDb`); we stamp ADT matches here.
+        const tagOrigin = (lookups, origin) => lookups.map((l) => ({
+            ...l,
+            matches: l.matches.map((m) => ({ ...m, _origin: m._origin ?? origin })),
+        }));
+        let finalLookups;
+        const wildcardNames = names.filter((name) => name.includes('*'));
+        const warnings = [];
+        let splitBrain = [];
+        if (source === 'adt') {
+            finalLookups = tagOrigin(await client.lookupObjects(names, { maxResults, objectTypes }), 'adt');
+        }
+        else if (source === 'db') {
+            // The 'db' path bypasses ADT info-system entirely; `lookupObjectsViaDb` already
+            // tags matches with `_origin:'db'`. Safety/scope gating runs at handleToolCall
+            // and in client.runQuery (FreeSQL operation), so unauthorized callers never reach here.
+            finalLookups = await client.lookupObjectsViaDb(names, { maxResults, objectTypes });
+        }
+        else {
+            // 'both' — parallel ADT + DB, merge per name with dedupe.
+            const [adtLookups, dbLookups] = await Promise.all([
+                client.lookupObjects(names, { maxResults, objectTypes }).then((r) => tagOrigin(r, 'adt')),
+                client.lookupObjectsViaDb(names, { maxResults, objectTypes }),
+            ]);
+            const dbByName = new Map(dbLookups.map((l) => [l.name.toUpperCase(), l]));
+            const adtByName = new Map(adtLookups.map((l) => [l.name.toUpperCase(), l]));
+            finalLookups = names.map((rawName) => {
+                const upper = rawName.toUpperCase();
+                const adt = adtByName.get(upper);
+                const db = dbByName.get(upper);
+                const adtMatches = adt?.matches ?? [];
+                const dbMatches = db?.matches ?? [];
+                // Dedupe by (baseObjectType, objectName) — TADIR stores bare types ('DDLS')
+                // while ADT info-system returns slash-form ('DDLS/DF'). Stripping the suffix
+                // keeps the same logical object from appearing twice in the merged matches.
+                // Preserve the more-specific slash form when both originate from ADT+DB.
+                const seen = new Map();
+                const baseKey = (m) => `${(m.objectType.split('/')[0] || m.objectType).toUpperCase()}\x00${m.objectName.toUpperCase()}`;
+                for (const m of adtMatches)
+                    seen.set(baseKey(m), m);
+                for (const m of dbMatches) {
+                    const k = baseKey(m);
+                    if (!seen.has(k))
+                        seen.set(k, m);
+                }
+                const mergedMatches = [...seen.values()];
+                // Split-brain detection: an object is divergent if exactly one source has matches.
+                // (Zero matches on both sides = consistent absence; matches on both = consistent presence.)
+                if (adtMatches.length > 0 !== dbMatches.length > 0) {
+                    splitBrain.push(rawName);
+                }
+                return { name: rawName, found: mergedMatches.length > 0, matches: mergedMatches };
+            });
+            // Compose human-friendly warnings per split-brain name. Keep them grounded in
+            // the most common cause (TADIR ghost from aborted create/delete) so LLM clients
+            // can suggest the right cleanup path without inventing a new pointer.
+            for (const name of splitBrain) {
+                const adt = adtByName.get(name.toUpperCase());
+                const db = dbByName.get(name.toUpperCase());
+                const adtHas = (adt?.matches.length ?? 0) > 0;
+                const dbHas = (db?.matches.length ?? 0) > 0;
+                if (dbHas && !adtHas) {
+                    warnings.push(`${name} exists in TADIR (DB) but ADT cannot resolve it — likely a TADIR ghost from an aborted create/delete cycle. Consider RS_DD_TADIR_CLEANUP or manual SE03 cleanup.`);
+                }
+                else if (adtHas && !dbHas) {
+                    warnings.push(`${name} resolves via ADT but is not present in the TADIR row scan — likely a release-time mismatch or a type filter excluding the row. Re-run with broader objectTypes or no filter to confirm.`);
+                }
+            }
+        }
+        // Dedupe split-brain names (defensive; merge loop should already avoid duplicates).
+        splitBrain = [...new Set(splitBrain)];
+        if (wildcardNames.length > 0) {
+            warnings.push(`tadir_lookup performs exact-name lookup; wildcard characters are treated literally for: ${wildcardNames.join(', ')}`);
+        }
+        const missing = finalLookups.filter((l) => !l.found).map((l) => l.name);
+        const matchCount = finalLookups.reduce((count, lookup) => count + lookup.matches.length, 0);
+        const payload = { count: matchCount, lookups: finalLookups, missing };
+        if (splitBrain.length > 0)
+            payload.splitBrain = splitBrain;
+        if (warnings.length > 0)
+            payload.warnings = warnings;
+        return textResult(JSON.stringify(payload, null, 2));
+    }
+    if (searchType === 'source_code') {
+        // Source code search: do NOT transliterate — source can contain umlauts in strings/comments
+        if (cachedFeatures?.textSearch && !cachedFeatures.textSearch.available) {
+            return errorResult(`Source code search is not available on this SAP system. ${cachedFeatures.textSearch.reason ?? ''}` +
+                `\nUse SAPSearch with searchType="object" to search by object name instead, or use SAPQuery to search metadata tables.`);
+        }
+        const objectType = args.objectType ? normalizeObjectType(String(args.objectType)) : undefined;
+        const packageName = args.packageName;
+        try {
+            const results = await client.searchSource(rawQuery, maxResults, objectType, packageName);
+            return textResult(JSON.stringify(results, null, 2));
+        }
+        catch (err) {
+            if (err instanceof AdtApiError) {
+                const permanentCodes = [401, 403, 404, 501];
+                if (permanentCodes.includes(err.statusCode)) {
+                    const classified = classifyTextSearchError(err.statusCode);
+                    return errorResult(`Source code search is not available on this SAP system. ${classified.reason ?? ''}` +
+                        `\nUse SAPSearch with searchType="object" to search by object name instead, or use SAPQuery to search metadata tables.`);
+                }
+            }
+            throw err;
+        }
+    }
+    // Object search: transliterate non-ASCII (SAP object names are ASCII-only)
+    const { normalized: query, changed: wasTransliterated } = transliterateQuery(rawQuery);
+    const transliterationNote = wasTransliterated
+        ? `Note: Query contained non-ASCII characters. Transliterated "${rawQuery}" → "${query}" (SAP object names are ASCII-only).\n\n`
+        : '';
+    const results = await client.searchObject(query, maxResults);
+    if (Array.isArray(results) && results.length === 0) {
+        let hint = '[]' +
+            '\n\n' +
+            transliterationNote +
+            'No objects found. If searching for custom objects, try Z* or Y* prefixes (e.g., "Z*ESTIM*"). ' +
+            'If you already found objects in a package, use SAPRead with type=DEVC to list all package contents instead of more searches.';
+        if (looksLikeFieldName(query)) {
+            const stripped = query.replace(/\*/g, '');
+            hint += `\nThis looks like a field/column name. Use SAPQuery("SELECT fieldname, rollname, domname FROM dd03l WHERE fieldname = '${stripped}'") or SAPRead(type='DDLS', include='elements') to find fields.`;
+        }
+        return textResult(hint);
+    }
+    return textResult(transliterationNote + JSON.stringify(results, null, 2));
+}
+function extractLookupNames(query, rawNames) {
+    const fromNames = Array.isArray(rawNames) ? rawNames.map((n) => String(n).trim()).filter(Boolean) : [];
+    const fromQuery = query
+        .split(/[,\s]+/)
+        .map((n) => n.trim())
+        .filter(Boolean);
+    return [...new Set([...fromNames, ...fromQuery].map((n) => n.toUpperCase()))];
+}
+function extractLookupObjectTypes(rawObjectType, rawObjectTypes) {
+    const types = Array.isArray(rawObjectTypes)
+        ? rawObjectTypes.map((t) => normalizeObjectType(String(t))).filter(Boolean)
+        : [];
+    if (typeof rawObjectType === 'string' && rawObjectType.trim()) {
+        types.push(normalizeObjectType(rawObjectType));
+    }
+    return [...new Set(types)];
+}
+//# sourceMappingURL=search.js.map

package/dist/handlers/search.js.map

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

package/dist/handlers/shared.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared primitives for the intent handlers: the MCP tool-result type and its two constructors.
+ *
+ * `textResult`/`errorResult` are used by every handler, so they live in a dependency-free module
+ * that handler modules can import without pulling in the whole dispatcher.
+ */
+/** MCP tool call result */
+export interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function textResult(text: string): ToolResult;
+export declare function errorResult(message: string): ToolResult;
+/** True when an error body carries an Open-SQL parser/grammar signature (SAPQuery + error hints). */
+export declare function hasSqlParserSignature(text: string): boolean;
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/handlers/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2BAA2B;AAC3B,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEnD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAEvD;AAED,qGAAqG;AACrG,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAU3D"}

package/dist/handlers/shared.js

@@ -0,0 +1,23 @@
+/**
+ * Shared primitives for the intent handlers: the MCP tool-result type and its two constructors.
+ *
+ * `textResult`/`errorResult` are used by every handler, so they live in a dependency-free module
+ * that handler modules can import without pulling in the whole dispatcher.
+ */
+export function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function errorResult(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+/** True when an error body carries an Open-SQL parser/grammar signature (SAPQuery + error hints). */
+export function hasSqlParserSignature(text) {
+    const normalized = text.toLowerCase();
+    return (normalized.includes('only one select statement is allowed') ||
+        normalized.includes('only select statement is allowed') ||
+        normalized.includes('invalid query string') ||
+        normalized.includes('due to grammar') ||
+        normalized.includes('is invalid here') ||
+        normalized.includes('is invalid at this position'));
+}
+//# sourceMappingURL=shared.js.map

package/dist/handlers/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/handlers/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,CACL,UAAU,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QAC3D,UAAU,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACvD,UAAU,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAC3C,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACrC,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACtC,UAAU,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CACnD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Single source of truth for the per-tool object-type lists.
+ *
+ * Before this module these arrays were hand-duplicated in both `tools.ts` (JSON Schema enums
+ * for LLM clients) and `schemas.ts` (Zod runtime validation), with no check that the two copies
+ * agreed. Drift here is a correctness bug: a type advertised to the LLM but rejected by Zod (or
+ * vice-versa). Both files now import from here, and `tests/unit/handlers/registry-sync.test.ts`
+ * asserts the JSON-Schema enums, the Zod enums, and the dispatch switch all stay in agreement.
+ *
+ * Each tool has ONE `*_TYPE_TABLE` listing every type with a `btp` flag (true = available on BTP
+ * ABAP Environment). The ONPREM (superset) and BTP arrays are DERIVED from that table, so they can
+ * never disagree and there is no separate on-prem-only list to keep in sync.
+ *
+ * To add/remove a SAPRead/SAPWrite/SAPContext type:
+ *   1. Add/remove ONE row in the matching `*_TYPE_TABLE` below, with its `btp` flag. (Exception:
+ *      server-driven types — their rows derive from `SDO_TYPES`, so register the type in
+ *      src/adt/server-driven.ts instead and both tables pick it up.)
+ *   2. Add/remove the matching `case` in the tool's handler module: SAPRead → src/handlers/read.ts,
+ *      SAPWrite → src/handlers/write.ts (note write routes by URL via objectBasePath/server-driven,
+ *      not a per-type switch — see the registry-sync write-routing guard), SAPContext →
+ *      src/handlers/context.ts.
+ *   3. Add/remove the ACTION_POLICY entry if it needs a non-default scope (src/authz/policy.ts).
+ * The registry-sync + validate:policy checks will fail loudly if any of these drift.
+ *
+ * The derived arrays keep literal element types (`.map`/`.filter` over an `as const` table), so both
+ * `z.enum(...)` (needs a readonly string list) and the JSON-Schema `enum: [...]` consume the exact
+ * same literal set, in table order.
+ */
+/** All SAPRead object types available on on-premise (the superset). */
+export declare const SAPREAD_TYPES_ONPREM: ("PROG" | "CLAS" | "INTF" | "INCL" | "FUGR" | "DDLS" | "DCLS" | "BDEF" | "SRVD" | "DDLX" | "SRVB" | "TABL" | "DOMA" | "DTEL" | "MSAG" | "DEVC" | "TRAN" | "VIEW" | "SKTD" | "FUNC" | "DESD" | "DTSC" | "CSNM" | "EVTB" | "EVTO" | "COTA" | "TABLE_CONTENTS" | "TABLE_QUERY" | "SOBJ" | "SYSTEM" | "COMPONENTS" | "MESSAGES" | "TEXT_ELEMENTS" | "VARIANTS" | "BSP" | "BSP_DEPLOY" | "API_STATE" | "INACTIVE_OBJECTS" | "AUTH" | "FEATURE_TOGGLE" | "FTG2" | "ENHO" | "VERSIONS" | "VERSION_SOURCE")[];
+/** SAPRead types available on BTP ABAP Environment (the `btp: true` rows). */
+export declare const SAPREAD_TYPES_BTP: ("CLAS" | "INTF" | "FUGR" | "DDLS" | "DCLS" | "BDEF" | "SRVD" | "DDLX" | "SRVB" | "TABL" | "DOMA" | "DTEL" | "MSAG" | "DEVC" | "SKTD" | "FUNC" | "DESD" | "DTSC" | "CSNM" | "EVTB" | "EVTO" | "COTA" | "TABLE_CONTENTS" | "TABLE_QUERY" | "SYSTEM" | "COMPONENTS" | "MESSAGES" | "BSP" | "BSP_DEPLOY" | "API_STATE" | "INACTIVE_OBJECTS")[];
+/** All SAPWrite object types available on on-premise (the superset). */
+export declare const SAPWRITE_TYPES_ONPREM: ("PROG" | "CLAS" | "INTF" | "INCL" | "FUGR" | "DDLS" | "DCLS" | "BDEF" | "SRVD" | "DDLX" | "SRVB" | "TABL" | "DOMA" | "DTEL" | "MSAG" | "SKTD" | "TABL/DT" | "TABL/DS" | "FUNC" | "DESD" | "DTSC" | "CSNM" | "EVTB" | "EVTO" | "COTA")[];
+/** SAPWrite types available on BTP ABAP Environment (the `btp: true` rows). */
+export declare const SAPWRITE_TYPES_BTP: ("CLAS" | "INTF" | "DDLS" | "DCLS" | "BDEF" | "SRVD" | "DDLX" | "SRVB" | "TABL" | "DOMA" | "DTEL" | "MSAG" | "SKTD" | "TABL/DT" | "TABL/DS" | "DESD" | "DTSC" | "CSNM" | "EVTB" | "EVTO" | "COTA")[];
+/** SAPContext types on on-premise. */
+export declare const SAPCONTEXT_TYPES_ONPREM: ("PROG" | "CLAS" | "INTF" | "DDLS" | "FUNC")[];
+/** SAPContext types on BTP. */
+export declare const SAPCONTEXT_TYPES_BTP: ("CLAS" | "INTF" | "DDLS")[];
+export type SapReadType = (typeof SAPREAD_TYPES_ONPREM)[number];
+export type SapWriteType = (typeof SAPWRITE_TYPES_ONPREM)[number];
+export type SapContextType = (typeof SAPCONTEXT_TYPES_ONPREM)[number];
+//# sourceMappingURL=tool-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/handlers/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAiFH,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,ueAAsB,CAAC;AACxD,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,6UAAmB,CAAC;AA8BlD,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,0OAAuB,CAAC;AAC1D,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,sMAAoB,CAAC;AAYpD,sCAAsC;AACtC,eAAO,MAAM,uBAAuB,gDAAyB,CAAC;AAC9D,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,8BAAsB,CAAC;AAIxD,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

@@ -0,0 +1,152 @@
+/**
+ * Single source of truth for the per-tool object-type lists.
+ *
+ * Before this module these arrays were hand-duplicated in both `tools.ts` (JSON Schema enums
+ * for LLM clients) and `schemas.ts` (Zod runtime validation), with no check that the two copies
+ * agreed. Drift here is a correctness bug: a type advertised to the LLM but rejected by Zod (or
+ * vice-versa). Both files now import from here, and `tests/unit/handlers/registry-sync.test.ts`
+ * asserts the JSON-Schema enums, the Zod enums, and the dispatch switch all stay in agreement.
+ *
+ * Each tool has ONE `*_TYPE_TABLE` listing every type with a `btp` flag (true = available on BTP
+ * ABAP Environment). The ONPREM (superset) and BTP arrays are DERIVED from that table, so they can
+ * never disagree and there is no separate on-prem-only list to keep in sync.
+ *
+ * To add/remove a SAPRead/SAPWrite/SAPContext type:
+ *   1. Add/remove ONE row in the matching `*_TYPE_TABLE` below, with its `btp` flag. (Exception:
+ *      server-driven types — their rows derive from `SDO_TYPES`, so register the type in
+ *      src/adt/server-driven.ts instead and both tables pick it up.)
+ *   2. Add/remove the matching `case` in the tool's handler module: SAPRead → src/handlers/read.ts,
+ *      SAPWrite → src/handlers/write.ts (note write routes by URL via objectBasePath/server-driven,
+ *      not a per-type switch — see the registry-sync write-routing guard), SAPContext →
+ *      src/handlers/context.ts.
+ *   3. Add/remove the ACTION_POLICY entry if it needs a non-default scope (src/authz/policy.ts).
+ * The registry-sync + validate:policy checks will fail loudly if any of these drift.
+ *
+ * The derived arrays keep literal element types (`.map`/`.filter` over an `as const` table), so both
+ * `z.enum(...)` (needs a readonly string list) and the JSON-Schema `enum: [...]` consume the exact
+ * same literal set, in table order.
+ */
+import { SDO_TYPES } from '../adt/server-driven.js';
+/**
+ * Pull the on-prem (all rows) + BTP (btp:true rows) type arrays out of an `as const` type table.
+ * The return type is annotated explicitly — inside the generic body `r.type` is seen as plain
+ * `string` (property access resolves via the constraint), so without the annotation every derived
+ * array and union would silently widen from literal types to `string`, losing compile-time typo
+ * protection for consumers. Throws on a duplicate `type` row at module load: Zod's z.enum would
+ * silently dedupe it while the JSON-Schema `enum:` shipped to LLM clients would carry the
+ * duplicate — strict clients reject such a schema, and no equality test could catch it because
+ * every comparison derives from this same table.
+ */
+function deriveTypeArrays(table) {
+    const seen = new Set();
+    for (const row of table) {
+        if (seen.has(row.type))
+            throw new Error(`tool-registry: duplicate type row '${row.type}' in a *_TYPE_TABLE`);
+        seen.add(row.type);
+    }
+    return {
+        onprem: table.map((r) => r.type),
+        btp: table.filter((r) => r.btp).map((r) => r.type),
+    };
+}
+// ─── SAPRead ────────────────────────────────────────────────────────
+const SAPREAD_TYPE_TABLE = [
+    { type: 'PROG', btp: false },
+    { type: 'CLAS', btp: true },
+    { type: 'INTF', btp: true },
+    { type: 'FUNC', btp: true },
+    { type: 'FUGR', btp: true },
+    { type: 'INCL', btp: false },
+    { type: 'DDLS', btp: true },
+    { type: 'DCLS', btp: true },
+    { type: 'DDLX', btp: true },
+    { type: 'BDEF', btp: true },
+    { type: 'SRVD', btp: true },
+    { type: 'SRVB', btp: true },
+    { type: 'SKTD', btp: true },
+    { type: 'TABL', btp: true },
+    { type: 'VIEW', btp: false },
+    { type: 'DOMA', btp: true },
+    { type: 'DTEL', btp: true },
+    { type: 'TRAN', btp: false },
+    { type: 'TABLE_CONTENTS', btp: true },
+    { type: 'TABLE_QUERY', btp: true },
+    { type: 'DEVC', btp: true },
+    { type: 'SOBJ', btp: false },
+    { type: 'SYSTEM', btp: true },
+    { type: 'COMPONENTS', btp: true },
+    // MSAG is the canonical TADIR R3TR type for message classes (table T100). 'MESSAGES' is kept as a
+    // deprecated alias for one minor release; both resolve to the same handler. See
+    // research/abap-types/types/msag.md and docs/plans/completed/audit-symmetry-and-ftg2-rename.md.
+    { type: 'MSAG', btp: true },
+    { type: 'MESSAGES', btp: true },
+    { type: 'TEXT_ELEMENTS', btp: false },
+    { type: 'VARIANTS', btp: false },
+    { type: 'BSP', btp: true },
+    { type: 'BSP_DEPLOY', btp: true },
+    { type: 'API_STATE', btp: true },
+    { type: 'INACTIVE_OBJECTS', btp: true },
+    { type: 'AUTH', btp: false },
+    // FTG2 is an ARC-1-private invented identifier (see research/abap-types/types/ftg2.md).
+    // FEATURE_TOGGLE is the new canonical name; FTG2 stays as deprecated alias for one minor.
+    { type: 'FEATURE_TOGGLE', btp: false },
+    { type: 'FTG2', btp: false },
+    { type: 'ENHO', btp: false },
+    { type: 'VERSIONS', btp: false },
+    { type: 'VERSION_SOURCE', btp: false },
+    // Server-driven objects (ABAP Platform 2025 / SAP_BASIS 8.16+) — generic AFF read path,
+    // discovery-gated (src/adt/server-driven.ts). Rows DERIVE from SDO_TYPES, so registering a type
+    // there is the only step: btp is true by construction (SDO types are 8.16+; runtime availability
+    // is discovery-gated), and deriveTypeArrays' duplicate guard throws if a hand row ever collides.
+    ...SDO_TYPES.map((t) => ({ type: t, btp: true })),
+];
+const sapReadTypes = deriveTypeArrays(SAPREAD_TYPE_TABLE);
+/** All SAPRead object types available on on-premise (the superset). */
+export const SAPREAD_TYPES_ONPREM = sapReadTypes.onprem;
+/** SAPRead types available on BTP ABAP Environment (the `btp: true` rows). */
+export const SAPREAD_TYPES_BTP = sapReadTypes.btp;
+// ─── SAPWrite ───────────────────────────────────────────────────────
+const SAPWRITE_TYPE_TABLE = [
+    { type: 'PROG', btp: false },
+    { type: 'CLAS', btp: true },
+    { type: 'INTF', btp: true },
+    { type: 'FUNC', btp: false },
+    { type: 'FUGR', btp: false },
+    { type: 'INCL', btp: false },
+    { type: 'DDLS', btp: true },
+    { type: 'DCLS', btp: true },
+    { type: 'DDLX', btp: true },
+    { type: 'BDEF', btp: true },
+    { type: 'SRVD', btp: true },
+    { type: 'SRVB', btp: true },
+    { type: 'SKTD', btp: true },
+    { type: 'TABL', btp: true },
+    // Subtype routing for create — see docs/plans/completed/fix-tabl-ds-create-routing.md.
+    { type: 'TABL/DT', btp: true },
+    { type: 'TABL/DS', btp: true },
+    { type: 'DOMA', btp: true },
+    { type: 'DTEL', btp: true },
+    { type: 'MSAG', 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 })),
+];
+const sapWriteTypes = deriveTypeArrays(SAPWRITE_TYPE_TABLE);
+/** All SAPWrite object types available on on-premise (the superset). */
+export const SAPWRITE_TYPES_ONPREM = sapWriteTypes.onprem;
+/** SAPWrite types available on BTP ABAP Environment (the `btp: true` rows). */
+export const SAPWRITE_TYPES_BTP = sapWriteTypes.btp;
+// ─── SAPContext ─────────────────────────────────────────────────────
+const SAPCONTEXT_TYPE_TABLE = [
+    { type: 'CLAS', btp: true },
+    { type: 'INTF', btp: true },
+    { type: 'PROG', btp: false },
+    { type: 'FUNC', btp: false },
+    { type: 'DDLS', btp: true },
+];
+const sapContextTypes = deriveTypeArrays(SAPCONTEXT_TYPE_TABLE);
+/** SAPContext types on on-premise. */
+export const SAPCONTEXT_TYPES_ONPREM = sapContextTypes.onprem;
+/** SAPContext types on BTP. */
+export const SAPCONTEXT_TYPES_BTP = sapContextTypes.btp;
+//# sourceMappingURL=tool-registry.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -18,10 +18,19 @@
  */
 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). */
+export interface ToolAnnotations {
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+    title?: string;
+}
 export interface ToolDefinition {
     name: string;
     description: string;
     inputSchema: Record<string, unknown>;
+    annotations?: ToolAnnotations;
 }
 export declare function getToolDefinitions(config: ServerConfig, textSearchAvailable?: boolean, resolvedFeatures?: ResolvedFeatures): ToolDefinition[];
 //# sourceMappingURL=tools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/handlers/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAgiBD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,mBAAmB,CAAC,EAAE,OAAO,EAC7B,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,cAAc,EAAE,CAsnClB"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/handlers/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYvD,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;AAgbD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,mBAAmB,CAAC,EAAE,OAAO,EAC7B,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,cAAc,EAAE,CA6nClB"}