d365fo-mcp 1.0.0

package/dist/tools/getLabelInfo.js

@@ -0,0 +1,138 @@
+/**
+ * Get Label Info Tool
+ * Returns all language translations for a specific label ID.
+ * Also lists all available label files (AxLabelFile IDs) for a model.
+ */
+import { z } from 'zod';
+const GetLabelInfoArgsSchema = z.object({
+    labelId: z
+        .string()
+        .optional()
+        .describe('Exact label ID to look up (e.g. MyFeature, BatchGroup). ' +
+        'Omit to list available label files for the model instead.'),
+    labelFileId: z
+        .string()
+        .optional()
+        .describe('Label file ID (e.g. ContosoExt, SYS, ApplicationPlatform)'),
+    model: z.string().optional().describe('Model to filter by (e.g. ContosoExt)'),
+});
+export async function getLabelInfoTool(request, context) {
+    try {
+        const args = GetLabelInfoArgsSchema.parse(request.params.arguments);
+        const { symbolIndex } = context;
+        const { labelId, labelFileId, model } = args;
+        // Mode A: no labelId → list available AxLabelFile IDs
+        if (!labelId) {
+            let files = symbolIndex.getLabelFileIds(model);
+            // When a specific labelFileId is requested, narrow the listing to it and
+            // additionally surface the physical .label.txt path for each language so
+            // the caller never has to shell out to locate the file on disk.
+            if (labelFileId) {
+                files = files.filter(f => f.labelFileId.toLowerCase() === labelFileId.toLowerCase());
+            }
+            if (files.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No label files found` +
+                                (labelFileId ? ` matching labelFileId "${labelFileId}"` : '') +
+                                (model ? ` for model "${model}"` : '') +
+                                `.\n` +
+                                `Make sure labels are indexed (run build-database with INCLUDE_LABELS=true).`,
+                        },
+                    ],
+                };
+            }
+            const lines = [
+                labelFileId
+                    ? `Label file "${labelFileId}"${model ? ` in model "${model}"` : ''}:`
+                    : `Available AxLabelFile IDs${model ? ` in model "${model}"` : ''}:`,
+                '',
+            ];
+            for (const f of files) {
+                lines.push(`  LabelFileId : ${f.labelFileId}`);
+                lines.push(`  Model       : ${f.model}`);
+                lines.push(`  Languages   : ${f.languages}`);
+                // Physical file paths per language (only when a specific file was asked for,
+                // so the generic "list everything" view stays compact).
+                if (labelFileId) {
+                    const paths = symbolIndex.getLabelFilePaths(f.labelFileId, model);
+                    if (paths.length > 0) {
+                        lines.push(`  Files       :`);
+                        for (const p of paths) {
+                            lines.push(`    [${p.language.padEnd(6)}] ${p.filePath}`);
+                        }
+                    }
+                    else {
+                        lines.push(`  Files       : (no physical path indexed — label rows may predate path tracking; ` +
+                            `re-run build-database with INCLUDE_LABELS=true to populate file paths)`);
+                    }
+                }
+                lines.push('');
+            }
+            lines.push(`💡 Use labels(action="search") to find a label by text, or labels(action="info") with labelId to see all translations.`);
+            return { content: [{ type: 'text', text: lines.join('\n') }] };
+        }
+        // Mode B: look up a specific label ID
+        const rows = symbolIndex.getLabelById(labelId, labelFileId, model);
+        if (rows.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Label "${labelId}" not found` +
+                            (labelFileId ? ` in label file "${labelFileId}"` : '') +
+                            (model ? ` in model "${model}"` : '') +
+                            '.\n\n' +
+                            `💡 Try labels(action="search") to find labels by text, or omit labelId to list available label files.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const first = rows[0];
+        const ref = `@${first.labelFileId}:${labelId}`;
+        const lines = [
+            `Label: ${ref}`,
+            `Model: ${first.model}  |  LabelFile: ${first.labelFileId}`,
+            '',
+            'Translations:',
+        ];
+        // Group by language, sorted
+        const sorted = [...rows].sort((a, b) => {
+            // en-US first, then alphabetical
+            if (a.language === 'en-US')
+                return -1;
+            if (b.language === 'en-US')
+                return 1;
+            return a.language.localeCompare(b.language);
+        });
+        for (const r of sorted) {
+            lines.push(`  [${r.language.padEnd(6)}]  ${r.text}`);
+        }
+        // Comment from en-US (or first available)
+        const enUS = rows.find(r => r.language === 'en-US') ?? rows[0];
+        if (enUS.comment) {
+            lines.push('');
+            lines.push(`Comment: ${enUS.comment}`);
+        }
+        lines.push('');
+        lines.push('Usage in X++:');
+        lines.push(`  literalStr("${ref}")`);
+        lines.push('');
+        lines.push('Usage in metadata XML:');
+        lines.push(`  <Label>${ref}</Label>`);
+        lines.push(`  <HelpText>${ref}</HelpText>`);
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error getting label info: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+// Tool registration (name, description, inputSchema) lives inline in
+// src/server/mcpServer.ts - the single source of truth for tool instructions.
+//# sourceMappingURL=getLabelInfo.js.map

package/dist/tools/getLabelInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLabelInfo.js","sourceRoot":"","sources":["../../src/tools/getLabelInfo.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,0DAA0D;QACxD,2DAA2D,CAC9D;IACH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;IACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CAC9E,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAwB,EAAE,OAAyB;IACxF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACpE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;QAChC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAE7C,sDAAsD;QACtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,KAAK,GAAG,WAAW,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAE/C,yEAAyE;YACzE,yEAAyE;YACzE,gEAAgE;YAChE,IAAI,WAAW,EAAE,CAAC;gBAChB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;YACvF,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EACF,sBAAsB;gCACtB,CAAC,WAAW,CAAC,CAAC,CAAC,0BAA0B,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gCAC7D,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gCACtC,KAAK;gCACL,6EAA6E;yBAChF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAa;gBACtB,WAAW;oBACT,CAAC,CAAC,eAAe,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,cAAc,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;oBACtE,CAAC,CAAC,4BAA4B,KAAK,CAAC,CAAC,CAAC,cAAc,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;gBACtE,EAAE;aACH,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC/C,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;gBAE7C,6EAA6E;gBAC7E,wDAAwD;gBACxD,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,KAAK,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;oBAClE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;wBAC9B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;4BACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;wBAC5D,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,IAAI,CACR,oFAAoF;4BACpF,wEAAwE,CACzE,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YACD,KAAK,CAAC,IAAI,CACR,wHAAwH,CACzH,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACjE,CAAC;QAED,sCAAsC;QACtC,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QAEnE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,UAAU,OAAO,aAAa;4BAC9B,CAAC,WAAW,CAAC,CAAC,CAAC,mBAAmB,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;4BACtD,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;4BACrC,OAAO;4BACP,uGAAuG;qBAC1G;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,WAAW,IAAI,OAAO,EAAE,CAAC;QAE/C,MAAM,KAAK,GAAa;YACtB,UAAU,GAAG,EAAE;YACf,UAAU,KAAK,CAAC,KAAK,mBAAmB,KAAK,CAAC,WAAW,EAAE;YAC3D,EAAE;YACF,eAAe;SAChB,CAAC;QAEF,4BAA4B;QAC5B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrC,iCAAiC;YACjC,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;gBAAE,OAAO,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;gBAAE,OAAO,CAAC,CAAC;YACrC,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,0CAA0C;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,aAAa,CAAC,CAAC;QAE5C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,8EAA8E"}

package/dist/tools/getMethod.d.ts

@@ -0,0 +1,19 @@
+/**
+ * get_method Tool — unified method-reader entry point.
+ *
+ * Replaces the two per-aspect method tools (get_method_signature,
+ * get_method_source) with one tool discriminated by `include`:
+ *   • signature → modifiers/return type/params/attributes (cheap, for CoC)
+ *   • source    → full X++ body
+ *   • both      → signature followed by source (default)
+ *
+ * Both underlying handlers are bridge-backed readers that work in write-only
+ * mode via IMetadataProvider; handler files stay where they are — only the MCP
+ * surface is consolidated.
+ */
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { XppServerContext } from '../types/context.js';
+export declare const METHOD_INCLUDES: readonly ['signature', 'source', 'both'];
+export type MethodInclude = (typeof METHOD_INCLUDES)[number];
+export declare function getMethodTool(request: CallToolRequest, context: XppServerContext): Promise<any>;
+//# sourceMappingURL=getMethod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getMethod.d.ts","sourceRoot":"","sources":["../../src/tools/getMethod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,eAAO,MAAM,eAAe,YAAI,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAY7D,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,gBAuDtF"}

package/dist/tools/getMethod.js

@@ -0,0 +1,77 @@
+/**
+ * get_method Tool — unified method-reader entry point.
+ *
+ * Replaces the two per-aspect method tools (get_method_signature,
+ * get_method_source) with one tool discriminated by `include`:
+ *   • signature → modifiers/return type/params/attributes (cheap, for CoC)
+ *   • source    → full X++ body
+ *   • both      → signature followed by source (default)
+ *
+ * Both underlying handlers are bridge-backed readers that work in write-only
+ * mode via IMetadataProvider; handler files stay where they are — only the MCP
+ * surface is consolidated.
+ */
+import { z } from 'zod';
+import { getMethodSignatureTool } from './methodSignature.js';
+import { getMethodSourceTool } from './getMethodSource.js';
+export const METHOD_INCLUDES = ['signature', 'source', 'both'];
+const GetMethodArgsSchema = z
+    .object({
+    include: z.enum(METHOD_INCLUDES).optional().default('both'),
+})
+    .passthrough();
+function subRequest(name, args) {
+    return { method: 'tools/call', params: { name, arguments: args } };
+}
+export async function getMethodTool(request, context) {
+    const parsed = GetMethodArgsSchema.safeParse(request.params.arguments ?? {});
+    if (!parsed.success) {
+        return {
+            content: [{ type: 'text', text: `❌ get_method: invalid arguments — ${parsed.error.message}` }],
+            isError: true,
+        };
+    }
+    const { include, ...rest } = parsed.data;
+    if (!rest.className) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ get_method: missing required parameter "className".\n\n` +
+                        `Usage: get_method(className="MyClass", methodName="myMethod")\n\n` +
+                        `If you only know the method name, use search(query="myMethod", type="method") first ` +
+                        `to find which class it belongs to.`,
+                }],
+            isError: true,
+        };
+    }
+    if (include === 'signature') {
+        return getMethodSignatureTool(subRequest('get_method_signature', rest), context);
+    }
+    if (include === 'source') {
+        return getMethodSourceTool(subRequest('get_method_source', rest), context);
+    }
+    // both: signature first (cheap context), then full source.
+    const sig = await getMethodSignatureTool(subRequest('get_method_signature', rest), context);
+    const src = await getMethodSourceTool(subRequest('get_method_source', rest), context);
+    const sigOk = Boolean(sig && !sig.isError);
+    const srcOk = Boolean(src && !src.isError);
+    // Source is the authoritative payload. Some members (e.g. classDeclaration)
+    // have a valid source but no parseable signature, so the signature path emits
+    // a misleading "method not found" error. When the source succeeded, only keep
+    // the parts that actually succeeded — never surface a signature-only failure.
+    const parts = [
+        ...(sigOk ? sig.content : []),
+        ...(srcOk ? src.content : []),
+    ];
+    if (parts.length > 0) {
+        return { content: parts, isError: false };
+    }
+    // Both failed — return the source error (its "not found" hint is more useful).
+    return {
+        content: [...(src?.content ?? sig?.content ?? [])],
+        isError: true,
+    };
+}
+// Tool registration (name, description, inputSchema) lives inline in
+// src/server/mcpServer.ts — the single source of truth for tool instructions.
+//# sourceMappingURL=getMethod.js.map

package/dist/tools/getMethod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMethod.js","sourceRoot":"","sources":["../../src/tools/getMethod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAGxE,MAAM,mBAAmB,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;CAC5D,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,SAAS,UAAU,CAAC,IAAY,EAAE,IAA6B;IAC7D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAwB,EAAE,OAAyB;IACrF,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qCAAqC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9F,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,2DAA2D;wBAC3D,mEAAmE;wBACnE,sFAAsF;wBACtF,oCAAoC;iBACvC,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,OAAO,sBAAsB,CAAC,UAAU,CAAC,sBAAsB,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,mBAAmB,CAAC,UAAU,CAAC,mBAAmB,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED,2DAA2D;IAC3D,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC,UAAU,CAAC,sBAAsB,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5F,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,mBAAmB,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACtF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE3C,4EAA4E;IAC5E,8EAA8E;IAC9E,8EAA8E;IAC9E,8EAA8E;IAC9E,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/B,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,+EAA+E;IAC/E,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QAClD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,8EAA8E"}

package/dist/tools/getMethodSource.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Get Method Source Tool
+ * Returns the full X++ source code of a method.
+ *
+ * PRIMARY: C# bridge (IMetadataProvider) — 100% reliable, always available on VM.
+ * SQLite "did you mean?" kept only on error path.
+ */
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { XppServerContext } from '../types/context.js';
+export declare function getMethodSourceTool(request: CallToolRequest, context: XppServerContext): Promise<import("../bridge/bridgeAdapter.js").ToolResult | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=getMethodSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getMethodSource.d.ts","sourceRoot":"","sources":["../../src/tools/getMethodSource.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAc5D,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB;;;;;;GA4D5F"}

package/dist/tools/getMethodSource.js

@@ -0,0 +1,161 @@
+/**
+ * Get Method Source Tool
+ * Returns the full X++ source code of a method.
+ *
+ * PRIMARY: C# bridge (IMetadataProvider) — 100% reliable, always available on VM.
+ * SQLite "did you mean?" kept only on error path.
+ */
+import { z } from 'zod';
+import { tryBridgeMethodSource } from '../bridge/bridgeAdapter.js';
+import { canonicalSymbolName } from '../utils/symbolLookup.js';
+const GetMethodSourceArgsSchema = z.object({
+    className: z.string().describe('Name of the class containing the method'),
+    methodName: z.string().describe('Name of the method'),
+});
+/** Object types that can own methods. */
+const OBJECT_TYPES = ['class', 'table', 'view', 'data-entity'];
+const OBJECT_TYPES_SQL = `(${OBJECT_TYPES.map(t => `'${t}'`).join(', ')})`;
+export async function getMethodSourceTool(request, context) {
+    try {
+        const args = GetMethodSourceArgsSchema.parse(request.params.arguments);
+        const { methodName } = args;
+        // Resolve the caller's casing to the canonical AOT name once, up front.
+        // X++ treats AOT identifiers case-insensitively but the index stores the
+        // canonical name, and every lookup below (bridge included) matches by exact
+        // name — so a casing mismatch would otherwise miss all three layers and
+        // report a false "not found" (#686, e.g. WhsrfControlData → WHSRFControlData,
+        // whose own filename disagrees with its AOT name).
+        const className = resolveClassName(context, args.className);
+        // C# bridge (IMetadataProvider — live D365FO metadata, always available)
+        const bridgeResult = await tryBridgeMethodSource(context.bridge, className, methodName);
+        if (bridgeResult)
+            return bridgeResult;
+        // Fallback: parse XML file from disk (same pattern as classInfo.ts)
+        const xmlResult = await tryXmlMethodSource(context, className, methodName);
+        if (xmlResult)
+            return xmlResult;
+        // Bridge and XML both unavailable — try fuzzy name suggestions from SQLite
+        let hint = '';
+        try {
+            const db = context.symbolIndex.getReadDb();
+            const candidates = db.prepare(`SELECT name, signature FROM symbols
+         WHERE type = 'method' AND parent_name = ? AND name LIKE ?
+         ORDER BY name LIMIT 10`).all(className, `%${methodName.replace(/^parm/i, '')}%`);
+            if (candidates.length > 0) {
+                hint = '\n\n**Similar methods on this class:**\n' +
+                    candidates.map(c => `- \`${c.signature || c.name}\``).join('\n');
+            }
+            else if (/^parm/i.test(methodName)) {
+                const parmMethods = db.prepare(`SELECT name, signature FROM symbols
+           WHERE type = 'method' AND parent_name = ? AND name LIKE 'parm%'
+           ORDER BY name LIMIT 15`).all(className);
+                if (parmMethods.length > 0) {
+                    hint = '\n\n**Available parm* methods on this class:**\n' +
+                        parmMethods.map(c => `- \`${c.signature || c.name}\``).join('\n');
+                }
+            }
+        }
+        catch { /* DB not available */ }
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Method **${className}.${methodName}** not found.${hint}\n\nUse \`get_object_info(objectType="class", name="${className}")\` to see all available methods.`,
+                }],
+            isError: true,
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `❌ Error: ${err instanceof Error ? err.message : String(err)}` }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Canonical (as-indexed) casing for a method owner, falling back to the name as
+ * given when the index has no match or is unavailable — an unresolved name still
+ * flows through to the normal "not found" path.
+ *
+ * Index-safe by construction: `canonicalSymbolName` probes exact case on
+ * idx_name_type first and only falls back to FTS. Matching with
+ * `name = ? COLLATE NOCASE` here instead would drop to a scan of every
+ * class/table/view row (~86k rows, 4–8 s warm) and the parent_name hint query
+ * below would cost ~48 s — past the MCP client timeout. See src/utils/symbolLookup.ts.
+ */
+function resolveClassName(context, requested) {
+    try {
+        return canonicalSymbolName(context.symbolIndex.getReadDb(), requested, OBJECT_TYPES) ?? requested;
+    }
+    catch {
+        return requested; // DB not available — bridge/XML may still resolve it
+    }
+}
+/**
+ * Try XML file parsing for method source.
+ * Fallback when C# bridge is unavailable (Azure, Linux, bridge not running).
+ * Mirrors the pattern from classInfo.ts: parse XML with timeout guard.
+ */
+async function tryXmlMethodSource(context, className, methodName) {
+    const { parser, symbolIndex } = context;
+    if (!parser)
+        return null;
+    // Locate the class file path from SQLite. `className` is already canonical
+    // (resolveClassName), so this stays a BINARY probe on idx_name_type.
+    let classRow;
+    try {
+        const rdb = symbolIndex.getReadDb();
+        classRow = rdb.prepare(`
+      SELECT file_path, model, type
+      FROM symbols
+      WHERE type IN ${OBJECT_TYPES_SQL} AND name = ?
+      ORDER BY CASE type WHEN 'class' THEN 0 WHEN 'table' THEN 1 ELSE 2 END, model
+      LIMIT 1
+    `).get(className);
+    }
+    catch { /* DB not available */ }
+    if (!classRow?.file_path)
+        return null;
+    try {
+        const parseResult = await Promise.race([
+            parseByObjectType(parser, classRow.file_path, classRow.model, classRow.type),
+            new Promise(resolve => setTimeout(() => resolve({ success: false, error: 'timeout' }), 3000)),
+        ]);
+        if (!parseResult.success || !parseResult.data)
+            return null;
+        const method = parseResult.data.methods.find((m) => m.name.toLowerCase() === methodName.toLowerCase());
+        if (!method?.source)
+            return null;
+        // Detect [SysObsolete] / [Obsolete]
+        const obsoleteMatch = method.source.match(/\[\s*SysObsolete\s*\(\s*['"]([^'"]*)['"]/i)
+            ?? method.source.match(/\[\s*Obsolete\s*\(\s*['"]([^'"]*)['"]/i);
+        const obsoleteWarning = obsoleteMatch
+            ? `\n\n> ⚠️ **This method is marked obsolete.** Do NOT generate calls to it.\n> Replacement hint from the attribute: _"${obsoleteMatch[1]}"_\n> Read the hint above and use the stated replacement instead.`
+            : '';
+        // `method.name` is the AOT's own spelling; the find above is
+        // case-insensitive, so echoing `methodName` would print the caller's casing
+        // for a member that doesn't exist under it (#691). The bridge path already
+        // renders the authoritative `ms.methodName`.
+        const text = `## ${className}.${method.name}\n\n` +
+            `_Source: XML file parsing (bridge unavailable)_\n` +
+            obsoleteWarning +
+            `\n\`\`\`xpp\n${method.source}\n\`\`\``;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (e) {
+        console.error(`[getMethodSource] XML parse for ${className}.${methodName} failed: ${e}`);
+        return null;
+    }
+}
+/**
+ * Dispatch to the correct parser based on object type.
+ * Tables, views, and data-entities have different XML structures than classes.
+ */
+function parseByObjectType(parser, filePath, modelName, objectType) {
+    switch (objectType) {
+        case 'table': return parser.parseTableFile(filePath, modelName);
+        case 'view':
+        case 'data-entity': return parser.parseViewFile(filePath, modelName);
+        default: return parser.parseClassFile(filePath, modelName);
+    }
+}
+//# sourceMappingURL=getMethodSource.js.map

package/dist/tools/getMethodSource.js.map

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

package/dist/tools/getObjectInfo.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Get Object Info Tool — unified single-object metadata reader.
+ *
+ * Replaces the per-type get_*_info tools (get_class_info, get_table_info, …,
+ * get_service_info, get_macro_info) with one tool discriminated by `objectType`.
+ * Dispatches to the existing handler for that type via the shared READER_DISPATCH
+ * registry; type-specific knobs go in `options` and are passed through.
+ *
+ * Always available across server modes: bridge-backed types (class/table/…)
+ * work on the local VM, SQLite-backed types (service/map/config-key/…) work on
+ * Azure read-only. When the backing source is absent the underlying handler
+ * returns a clear "not found / needs index / needs VM" message.
+ */
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { XppServerContext } from '../types/context.js';
+export declare function getObjectInfoTool(request: CallToolRequest, context: XppServerContext): Promise<any>;
+//# sourceMappingURL=getObjectInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getObjectInfo.d.ts","sourceRoot":"","sources":["../../src/tools/getObjectInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA0B5D,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,gBAqD1F"}

package/dist/tools/getObjectInfo.js

@@ -0,0 +1,88 @@
+/**
+ * Get Object Info Tool — unified single-object metadata reader.
+ *
+ * Replaces the per-type get_*_info tools (get_class_info, get_table_info, …,
+ * get_service_info, get_macro_info) with one tool discriminated by `objectType`.
+ * Dispatches to the existing handler for that type via the shared READER_DISPATCH
+ * registry; type-specific knobs go in `options` and are passed through.
+ *
+ * Always available across server modes: bridge-backed types (class/table/…)
+ * work on the local VM, SQLite-backed types (service/map/config-key/…) work on
+ * Azure read-only. When the backing source is absent the underlying handler
+ * returns a clear "not found / needs index / needs VM" message.
+ */
+import { z } from 'zod';
+import { READER_DISPATCH, OBJECT_INFO_TYPES, withNotFoundGuidance } from './objectInfoRegistry.js';
+import { completionTool } from './completion.js';
+const GetObjectInfoArgsSchema = z.object({
+    objectType: z.enum(OBJECT_INFO_TYPES).describe('Kind of object to read: class, table, form, query, view, enum, edt, report, ' +
+        'data-entity, menu-item, service, map, config-key, security-policy, macro. ' +
+        'Extension types list every extension of a base object: table-extension, ' +
+        'form-extension, enum-extension, edt-extension, data-entity-extension, class-extension. ' +
+        'For any *-extension the name may be either the full extension name ' +
+        '(e.g. "CustInvoiceJour.Extension") or just the base object name — ' +
+        'both are accepted; the base object name is extracted automatically.'),
+    name: z.string().min(1).describe('Exact object name (use search/search(queries=[...]) first if unsure).'),
+    // Top-level class shortcuts — accepted directly so callers don't need to nest them in options.
+    methodOffset: z.number().optional().describe('[class] Pagination offset for methods. Classes with >15 methods are paged; pass multiples of 15 to get the next page.'),
+    compact: z.boolean().optional().describe('[class] true = signatures only (default), false = include full method source bodies.'),
+    options: z.record(z.string(), z.any()).optional().describe('Optional type-specific flags forwarded to the reader. ' +
+        'Class: { "compact": false } for full source, { "methodOffset": 15 } for next method page, ' +
+        '{ "members": "names" } for fast member-name list (add "prefix" to filter). ' +
+        'Report: { "includeRdl": true }. Form: { "searchControl": "AccountNum" }. Macro: { "filter": "Path" }.'),
+});
+export async function getObjectInfoTool(request, context) {
+    const parsed = GetObjectInfoArgsSchema.safeParse(request.params.arguments ?? {});
+    if (!parsed.success) {
+        return {
+            content: [{ type: 'text', text: `❌ get_object_info: invalid arguments — ${parsed.error.message}` }],
+            isError: true,
+        };
+    }
+    const { objectType, name, methodOffset, compact, options: rawOptions } = parsed.data;
+    // Merge top-level class shortcuts into options so dispatch.buildArgs sees them.
+    const options = { ...rawOptions };
+    if (methodOffset !== undefined)
+        options.methodOffset = methodOffset;
+    if (compact !== undefined)
+        options.compact = compact;
+    // Folded code_completion: a fast member-name list for classes.
+    // get_object_info(objectType="class", name, options:{ members:"names", prefix? })
+    if (options?.members === 'names') {
+        if (objectType !== 'class') {
+            return {
+                content: [{ type: 'text', text: `❌ get_object_info: options.members="names" is only supported for objectType="class". For "${objectType}" omit it to get full metadata.` }],
+                isError: true,
+            };
+        }
+        const completionRequest = {
+            method: 'tools/call',
+            params: {
+                name: 'code_completion',
+                arguments: {
+                    className: name,
+                    prefix: options.prefix,
+                    includeWorkspace: options.includeWorkspace,
+                    workspacePath: options.workspacePath,
+                },
+            },
+        };
+        return completionTool(completionRequest, context);
+    }
+    const dispatch = READER_DISPATCH[objectType];
+    if (!dispatch) {
+        return {
+            content: [{ type: 'text', text: `❌ get_object_info: unsupported objectType "${objectType}".` }],
+            isError: true,
+        };
+    }
+    const subRequest = {
+        method: 'tools/call',
+        params: { name: dispatch.toolName, arguments: dispatch.buildArgs(name, options) },
+    };
+    const result = await dispatch.tool(subRequest, context);
+    return withNotFoundGuidance(result, name, objectType);
+}
+// Tool registration (name, description, inputSchema) lives inline in
+// src/server/mcpServer.ts — the single source of truth for tool instructions.
+//# sourceMappingURL=getObjectInfo.js.map

package/dist/tools/getObjectInfo.js.map

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

package/dist/tools/getTablePatterns.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Get Table Patterns Tool
+ * Analyzes common field types, index patterns, and relation structures
+ * Used for smart table generation
+ */
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { XppServerContext } from '../types/context.js';
+export interface FieldPattern {
+    name: string;
+    edt: string;
+    frequency: number;
+    mandatoryCount: number;
+}
+export interface IndexPattern {
+    fields: string[];
+    unique: boolean;
+    frequency: number;
+}
+export interface RelationPattern {
+    targetTable: string;
+    frequency: number;
+    constraints: Array<{
+        field: string;
+        relatedField: string;
+    }>;
+}
+export declare function handleGetTablePatterns(args: {
+    tableGroup?: string;
+    similarTo?: string;
+    limit?: number;
+}, symbolIndex: any): Promise<any>;
+export declare function getTablePatternsTool(request: CallToolRequest, context: XppServerContext): Promise<{
+    isError?: undefined;
+    content: {
+        type: string;
+        text: string;
+    }[];
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=getTablePatterns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getTablePatterns.d.ts","sourceRoot":"","sources":["../../src/tools/getTablePatterns.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAW5D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACjE,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,GAAG,CAAC,CAiBd;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;;;;;GAmC7F"}