d365fo-mcp 1.0.0

package/dist/tools/securityPolicyInfo.js

@@ -0,0 +1,49 @@
+/**
+ * Get Security Policy Info Tool
+ * Reads an AxSecurityPolicy (row-level / OLS) from the SQLite index: the primary
+ * (constrained) table, the policy query, the operation it covers, and whether
+ * the primary table itself is constrained. Azure-safe READ tool.
+ */
+import { z } from 'zod';
+const GetSecurityPolicyInfoArgsSchema = z.object({
+    policyName: z.string().describe('Name of the AxSecurityPolicy (e.g. "DMFMyDefinitionGroups")'),
+});
+export async function getSecurityPolicyInfoTool(request, context) {
+    try {
+        const { policyName } = GetSecurityPolicyInfoArgsSchema.parse(request.params.arguments);
+        const db = context.symbolIndex.getReadDb();
+        // COLLATE NOCASE is safe on this side table (#686): security_policies holds
+        // one row per policy (thousands at most), so a mismatch costs a small scan —
+        // unlike `symbols`, where the same shape scans 1.17M rows.
+        const policy = db.prepare(`SELECT policy_name, primary_table, query_name, operation, constrained_table, label, model
+       FROM security_policies WHERE policy_name = ? COLLATE NOCASE LIMIT 1`).get(policyName);
+        if (!policy) {
+            return {
+                content: [{ type: 'text', text: `Security policy "${policyName}" not found.\n\nTip: run extract-metadata + build-database to index AxSecurityPolicy objects, or search(type="security-policy").` }],
+                isError: true,
+            };
+        }
+        // policy.policy_name is canonical — keeps this symbols probe BINARY.
+        const file = db.prepare(`SELECT file_path FROM symbols WHERE name = ? AND type = 'security-policy' LIMIT 1`).get(policy.policy_name);
+        const lines = [];
+        lines.push(`# AxSecurityPolicy: \`${policy.policy_name}\``);
+        lines.push('');
+        lines.push(`**Model:** ${policy.model}`);
+        if (policy.label)
+            lines.push(`**Label:** ${policy.label}`);
+        lines.push(`**Primary (constrained) table:** ${policy.primary_table ? `\`${policy.primary_table}\`` : '— none'}`);
+        lines.push(`**Policy query:** ${policy.query_name ? `\`${policy.query_name}\`` : '— none'}`);
+        lines.push(`**Operation:** ${policy.operation || '— (default)'}`);
+        lines.push(`**Primary table constrained:** ${policy.constrained_table ? 'Yes' : 'No'}`);
+        if (file?.file_path)
+            lines.push(`**File:** \`${file.file_path}\``);
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `❌ Error getting security policy info: ${error instanceof Error ? error.message : 'Unknown error'}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=securityPolicyInfo.js.map

package/dist/tools/securityPolicyInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"securityPolicyInfo.js","sourceRoot":"","sources":["../../src/tools/securityPolicyInfo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;CAC/F,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAAwB,EAAE,OAAyB;IACjG,IAAI,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,GAAG,+BAA+B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvF,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;QAE3C,4EAA4E;QAC5E,6EAA6E;QAC7E,2DAA2D;QAC3D,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACvB;2EACqE,CACtE,CAAC,GAAG,CAAC,UAAU,CAGH,CAAC;QAEd,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,UAAU,kIAAkI,EAAE,CAAC;gBACnM,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,qEAAqE;QACrE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACrB,mFAAmF,CACpF,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAuC,CAAC;QAEhE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,yBAAyB,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,oCAAoC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClH,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7F,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,SAAS,IAAI,aAAa,EAAE,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,kCAAkC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxF,IAAI,IAAI,EAAE,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QAEnE,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,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yCAAyC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC;YACtI,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/securityPrivilegeXml.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared builder for AxSecurityPrivilege XML.
+ *
+ * createD365File.ts and generateD365Xml.ts each expose a mirrored
+ * XmlTemplateGenerator class; both delegate here so the two cannot drift.
+ *
+ * Element order matches the Microsoft metadata serializer, verified against
+ * real shipped privileges in
+ *   ApplicationCommon\AxSecurityPrivilege\AgentFeedEntity{Maintain,View}.xml:
+ *   • AxSecurityDataEntityPermission children:  Grant, Name, Fields, Methods
+ *     (Grant FIRST — unlike AxSecurityEntryPointReference, which is Name-first)
+ *   • <Grant> CRUD elements are alphabetical:   Correct, Create, Delete, Read, Update
+ *
+ * properties.label         – label id (default: @TODO:LabelId)
+ * properties.targetObject  – ObjectName of the target menu item (optional)
+ * properties.objectType    – MenuItemDisplay | MenuItemAction | MenuItemOutput (default: MenuItemDisplay)
+ * properties.accessLevel   – 'view' | 'maintain' | 'read' (default: 'view' = Read only)
+ * properties.dataEntity    – Name of the data entity to grant permissions on (optional)
+ */
+export declare function buildAxSecurityPrivilegeXml(name: string, properties?: Record<string, any>): string;
+//# sourceMappingURL=securityPrivilegeXml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"securityPrivilegeXml.d.ts","sourceRoot":"","sources":["../../src/tools/securityPrivilegeXml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CA0ClG"}

package/dist/tools/securityPrivilegeXml.js

@@ -0,0 +1,61 @@
+/**
+ * Shared builder for AxSecurityPrivilege XML.
+ *
+ * createD365File.ts and generateD365Xml.ts each expose a mirrored
+ * XmlTemplateGenerator class; both delegate here so the two cannot drift.
+ *
+ * Element order matches the Microsoft metadata serializer, verified against
+ * real shipped privileges in
+ *   ApplicationCommon\AxSecurityPrivilege\AgentFeedEntity{Maintain,View}.xml:
+ *   • AxSecurityDataEntityPermission children:  Grant, Name, Fields, Methods
+ *     (Grant FIRST — unlike AxSecurityEntryPointReference, which is Name-first)
+ *   • <Grant> CRUD elements are alphabetical:   Correct, Create, Delete, Read, Update
+ *
+ * properties.label         – label id (default: @TODO:LabelId)
+ * properties.targetObject  – ObjectName of the target menu item (optional)
+ * properties.objectType    – MenuItemDisplay | MenuItemAction | MenuItemOutput (default: MenuItemDisplay)
+ * properties.accessLevel   – 'view' | 'maintain' | 'read' (default: 'view' = Read only)
+ * properties.dataEntity    – Name of the data entity to grant permissions on (optional)
+ */
+export function buildAxSecurityPrivilegeXml(name, properties) {
+    const label = properties?.label || '@TODO:LabelId';
+    const targetObject = properties?.targetObject;
+    const objType = properties?.objectType || 'MenuItemDisplay';
+    const al = (properties?.accessLevel || 'view').toLowerCase();
+    let entryPointsXml;
+    if (targetObject) {
+        const grantXml = al === 'maintain'
+            ? '\t\t\t\t<Read>Allow</Read>\n\t\t\t\t<Update>Allow</Update>\n\t\t\t\t<Create>Allow</Create>\n\t\t\t\t<Delete>Allow</Delete>'
+            : '\t\t\t\t<Read>Allow</Read>';
+        entryPointsXml = `\n\t\t<AxSecurityEntryPointReference>\n\t\t\t<Name>${targetObject}</Name>\n\t\t\t<Grant>\n${grantXml}\n\t\t\t</Grant>\n\t\t\t<ObjectName>${targetObject}</ObjectName>\n\t\t\t<ObjectType>${objType}</ObjectType>\n\t\t\t<Forms />\n\t\t</AxSecurityEntryPointReference>\n\t`;
+    }
+    else {
+        entryPointsXml = '';
+    }
+    const dataEntity = properties?.dataEntity;
+    let dataEntityPermissionsXml;
+    if (dataEntity) {
+        // CRUD elements alphabetical, matching the Microsoft serializer.
+        const grantXml = al === 'maintain'
+            ? '\t\t\t\t<Correct>Allow</Correct>\n\t\t\t\t<Create>Allow</Create>\n\t\t\t\t<Delete>Allow</Delete>\n\t\t\t\t<Read>Allow</Read>\n\t\t\t\t<Update>Allow</Update>'
+            : '\t\t\t\t<Read>Allow</Read>';
+        // Grant comes before Name for data-entity permissions.
+        dataEntityPermissionsXml = `\n\t\t<AxSecurityDataEntityPermission>\n\t\t\t<Grant>\n${grantXml}\n\t\t\t</Grant>\n\t\t\t<Name>${dataEntity}</Name>\n\t\t\t<Fields />\n\t\t\t<Methods />\n\t\t</AxSecurityDataEntityPermission>\n\t`;
+    }
+    else {
+        dataEntityPermissionsXml = '';
+    }
+    const dataEntityPermissionsElement = dataEntityPermissionsXml
+        ? `<DataEntityPermissions>${dataEntityPermissionsXml}</DataEntityPermissions>`
+        : '<DataEntityPermissions />';
+    return `<?xml version="1.0" encoding="utf-8"?>
+<AxSecurityPrivilege xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
+\t<Name>${name}</Name>
+\t<Label>${label}</Label>
+\t${dataEntityPermissionsElement}
+\t<DirectAccessPermissions />
+\t<EntryPoints>${entryPointsXml}</EntryPoints>
+\t<FormControlOverrides />
+</AxSecurityPrivilege>`;
+}
+//# sourceMappingURL=securityPrivilegeXml.js.map

package/dist/tools/securityPrivilegeXml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"securityPrivilegeXml.js","sourceRoot":"","sources":["../../src/tools/securityPrivilegeXml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAY,EAAE,UAAgC;IACxF,MAAM,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,eAAe,CAAC;IACnD,MAAM,YAAY,GAAuB,UAAU,EAAE,YAAY,CAAC;IAClE,MAAM,OAAO,GAAW,UAAU,EAAE,UAAU,IAAI,iBAAiB,CAAC;IACpE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,WAAW,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAE7D,IAAI,cAAsB,CAAC;IAC3B,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,EAAE,KAAK,UAAU;YAChC,CAAC,CAAC,4HAA4H;YAC9H,CAAC,CAAC,4BAA4B,CAAC;QACjC,cAAc,GAAG,sDAAsD,YAAY,2BAA2B,QAAQ,uCAAuC,YAAY,oCAAoC,OAAO,0EAA0E,CAAC;IACjS,CAAC;SAAM,CAAC;QACN,cAAc,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,UAAU,GAAuB,UAAU,EAAE,UAAU,CAAC;IAC9D,IAAI,wBAAgC,CAAC;IACrC,IAAI,UAAU,EAAE,CAAC;QACf,iEAAiE;QACjE,MAAM,QAAQ,GAAG,EAAE,KAAK,UAAU;YAChC,CAAC,CAAC,8JAA8J;YAChK,CAAC,CAAC,4BAA4B,CAAC;QACjC,uDAAuD;QACvD,wBAAwB,GAAG,0DAA0D,QAAQ,iCAAiC,UAAU,yFAAyF,CAAC;IACpO,CAAC;SAAM,CAAC;QACN,wBAAwB,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,4BAA4B,GAAG,wBAAwB;QAC3D,CAAC,CAAC,0BAA0B,wBAAwB,0BAA0B;QAC9E,CAAC,CAAC,2BAA2B,CAAC;IAEhC,OAAO;;UAEC,IAAI;WACH,KAAK;IACZ,4BAA4B;;iBAEf,cAAc;;uBAER,CAAC;AACxB,CAAC"}

package/dist/tools/serviceInfo.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Get Service Info Tool
+ * Reads an AxService from the SQLite index: backing class, external name,
+ * exposed operations, owning service group(s), and the computed REST endpoint
+ * (/api/services/<ServiceGroup>/<Service>/<Operation>).
+ *
+ * Backed by the static symbol index (Azure-safe READ tool) — services are not
+ * served by the C# bridge, so there is no bridge fast-path here.
+ */
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { XppServerContext } from '../types/context.js';
+export declare function getServiceInfoTool(request: CallToolRequest, context: XppServerContext): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    isError?: undefined;
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=serviceInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serviceInfo.d.ts","sourceRoot":"","sources":["../../src/tools/serviceInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAQ5D,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;;;;;GAyF3F"}

package/dist/tools/serviceInfo.js

@@ -0,0 +1,93 @@
+/**
+ * Get Service Info Tool
+ * Reads an AxService from the SQLite index: backing class, external name,
+ * exposed operations, owning service group(s), and the computed REST endpoint
+ * (/api/services/<ServiceGroup>/<Service>/<Operation>).
+ *
+ * Backed by the static symbol index (Azure-safe READ tool) — services are not
+ * served by the C# bridge, so there is no bridge fast-path here.
+ */
+import { z } from 'zod';
+import { canonicalSymbolName } from '../utils/symbolLookup.js';
+const GetServiceInfoArgsSchema = z.object({
+    serviceName: z.string().describe('Name of the AxService object (e.g. "AifUserSessionService")'),
+    includeOperations: z.boolean().optional().default(true).describe('Include the list of service operations and computed endpoints'),
+});
+export async function getServiceInfoTool(request, context) {
+    try {
+        const args = GetServiceInfoArgsSchema.parse(request.params.arguments);
+        const { includeOperations } = args;
+        const db = context.symbolIndex.getReadDb();
+        // Resolve the caller's casing to the canonical AOT name once (#686), then
+        // keep every probe below BINARY and on-index.
+        const serviceName = canonicalSymbolName(db, args.serviceName, ['service']) ?? args.serviceName;
+        const symbol = db.prepare(`SELECT name, signature, description, model, file_path FROM symbols WHERE name = ? AND type = 'service' LIMIT 1`).get(serviceName);
+        if (!symbol) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Service "${serviceName}" not found.\n\nTip: run extract-metadata + build-database to index AxService objects, or check the name with search(type="service").`,
+                    }],
+                isError: true,
+            };
+        }
+        const operations = db.prepare(`SELECT operation_name, method_name, idempotent FROM service_operations WHERE service_name = ? ORDER BY operation_name`).all(serviceName);
+        const groups = db.prepare(`SELECT DISTINCT group_name FROM service_group_members WHERE service_name = ? ORDER BY group_name`).all(serviceName);
+        const serviceClass = symbol.signature || undefined;
+        const externalName = symbol.description || undefined;
+        const lines = [];
+        lines.push(`# AxService: \`${symbol.name}\``);
+        lines.push('');
+        lines.push(`**Model:** ${symbol.model}`);
+        lines.push(`**Backing class:** ${serviceClass ? `\`${serviceClass}\`` : '— (none set)'}`);
+        if (externalName)
+            lines.push(`**External name:** ${externalName}`);
+        lines.push(`**File:** \`${symbol.file_path}\``);
+        if (groups.length > 0) {
+            lines.push(`**Service group(s):** ${groups.map(g => `\`${g.group_name}\``).join(', ')}`);
+        }
+        else {
+            lines.push(`**Service group(s):** — not a member of any indexed AxServiceGroup`);
+        }
+        lines.push('');
+        if (includeOperations) {
+            lines.push(`## Operations (${operations.length})`);
+            lines.push('');
+            if (operations.length === 0) {
+                lines.push('*(no operations indexed)*');
+            }
+            else {
+                lines.push('| Operation | Method | Idempotent |');
+                lines.push('|-----------|--------|------------|');
+                for (const op of operations) {
+                    lines.push(`| \`${op.operation_name}\` | \`${op.method_name}\` | ${op.idempotent ? 'Yes' : 'No'} |`);
+                }
+                lines.push('');
+                // REST endpoint: /api/services/<ServiceGroup>/<Service>/<Operation>
+                // The route segment is the AxService Name, not the external name.
+                lines.push('## REST endpoint(s)');
+                lines.push('');
+                const groupNames = groups.length > 0 ? groups.map(g => g.group_name) : ['<ServiceGroup>'];
+                const sampleOp = operations[0].operation_name;
+                for (const g of groupNames) {
+                    lines.push(`- \`/api/services/${g}/${symbol.name}/${sampleOp}\``);
+                }
+                if (groups.length === 0) {
+                    lines.push('');
+                    lines.push('> Service is not in an indexed group — add it to an AxServiceGroup to expose it.');
+                }
+            }
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Error getting service info: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=serviceInfo.js.map

package/dist/tools/serviceInfo.js.map

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

package/dist/tools/suggestEdt.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Suggest EDT Tool
+ * Intelligent EDT suggestion based on field name fuzzy matching
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { XppSymbolIndex } from '../metadata/symbolIndex.js';
+interface SuggestEdtArgs {
+    fieldName: string;
+    context?: string;
+    limit?: number;
+}
+export declare const suggestEdtTool: Tool;
+export declare function handleSuggestEdt(args: SuggestEdtArgs, symbolIndex: XppSymbolIndex): Promise<any>;
+export {};
+//# sourceMappingURL=suggestEdt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggestEdt.d.ts","sourceRoot":"","sources":["../../src/tools/suggestEdt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,UAAU,cAAc;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,cAAc,EAAE,IAqB5B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,WAAW,EAAE,cAAc,GAC1B,OAAO,CAAC,GAAG,CAAC,CAwId"}

package/dist/tools/suggestEdt.js

@@ -0,0 +1,348 @@
+/**
+ * Suggest EDT Tool
+ * Intelligent EDT suggestion based on field name fuzzy matching
+ */
+export const suggestEdtTool = {
+    name: 'suggest_edt',
+    description: 'Suggest Extended Data Types (EDT) for a field name using fuzzy matching on indexed EDT metadata. Considers field name patterns, context, and common usage.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            fieldName: {
+                type: 'string',
+                description: 'Field name to suggest EDT for (e.g., "CustomerAccount", "OrderAmount", "TransDate")',
+            },
+            context: {
+                type: 'string',
+                description: 'Optional context (e.g., "sales order", "ledger journal") to improve suggestions',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of suggestions (default: 5)',
+            },
+        },
+        required: ['fieldName'],
+    },
+};
+export async function handleSuggestEdt(args, symbolIndex) {
+    const { fieldName, context, limit = 5 } = args;
+    console.log(`[suggestEdt] Suggesting EDT for field: ${fieldName}, context: ${context}`);
+    const db = symbolIndex.getReadDb();
+    // Strategy 1: Exact match on EDT name
+    const exactMatch = db.prepare(`
+    SELECT edt_name, extends, enum_type, reference_table, label
+    FROM edt_metadata
+    WHERE edt_name = ?
+    LIMIT 1
+  `).get(fieldName);
+    if (exactMatch) {
+        console.log(`[suggestEdt] Found exact EDT match: ${exactMatch.edt_name}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        fieldName,
+                        suggestions: [
+                            {
+                                edt: exactMatch.edt_name,
+                                confidence: 1.0,
+                                reason: 'Exact match on EDT name',
+                                extends: exactMatch.extends,
+                                enumType: exactMatch.enum_type,
+                                referenceTable: exactMatch.reference_table,
+                                label: exactMatch.label,
+                            },
+                        ],
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    // Strategy 2: Fuzzy match on EDT name (case-insensitive, substring)
+    const fuzzyMatches = db.prepare(`
+    SELECT edt_name, extends, enum_type, reference_table, label
+    FROM edt_metadata
+    WHERE edt_name LIKE ? OR edt_name LIKE ?
+    ORDER BY LENGTH(edt_name) ASC
+    LIMIT ?
+  `).all(`%${fieldName}%`, `%${fieldName.toLowerCase()}%`, limit * 2);
+    console.log(`[suggestEdt] Found ${fuzzyMatches.length} fuzzy matches`);
+    // Strategy 3: Pattern-based heuristics
+    const heuristicSuggestions = getHeuristicSuggestions(fieldName, context);
+    // Merge and rank suggestions
+    const suggestions = [];
+    const seen = new Set();
+    for (const match of fuzzyMatches) {
+        if (seen.has(match.edt_name))
+            continue;
+        seen.add(match.edt_name);
+        const confidence = calculateConfidence(fieldName, match.edt_name, context);
+        suggestions.push({
+            edt: match.edt_name,
+            confidence,
+            reason: `Fuzzy match (similarity: ${Math.round(confidence * 100)}%)`,
+            extends: match.extends,
+            enumType: match.enum_type,
+            referenceTable: match.reference_table,
+            label: match.label,
+        });
+    }
+    for (const heuristic of heuristicSuggestions) {
+        if (seen.has(heuristic.edt))
+            continue;
+        seen.add(heuristic.edt);
+        const edtExists = db.prepare(`
+      SELECT edt_name, extends, enum_type, reference_table, label
+      FROM edt_metadata
+      WHERE edt_name = ?
+      LIMIT 1
+    `).get(heuristic.edt);
+        if (edtExists) {
+            suggestions.push({
+                edt: heuristic.edt,
+                confidence: heuristic.confidence,
+                reason: heuristic.reason,
+                extends: edtExists.extends,
+                enumType: edtExists.enum_type,
+                referenceTable: edtExists.reference_table,
+                label: edtExists.label,
+            });
+        }
+    }
+    suggestions.sort((a, b) => b.confidence - a.confidence);
+    const topSuggestions = suggestions.slice(0, limit);
+    console.log(`[suggestEdt] Returning ${topSuggestions.length} suggestions`);
+    // Fallback: no suggestions found — recommend a new EDT configuration
+    if (topSuggestions.length === 0) {
+        const recommended = recommendNewEdt(fieldName, context);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        fieldName,
+                        context,
+                        suggestions: [],
+                        fallback: {
+                            message: 'No suitable existing EDT found in the symbol index. Recommended configuration for a new EDT:',
+                            recommendedNewEdt: recommended,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    fieldName,
+                    context,
+                    suggestions: topSuggestions,
+                }, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Recommend a new EDT configuration when no existing EDT is found
+ */
+function recommendNewEdt(fieldName, _context) {
+    const nameLower = fieldName.toLowerCase();
+    if (/amount|price|cost|value|sum/i.test(nameLower)) {
+        return {
+            name: fieldName,
+            extends: 'Amount',
+            label: `@MyModel:${fieldName}`,
+            properties: { Extends: 'Amount', NoOfDecimals: '2' },
+            note: 'Extends Amount (Real) — suitable for monetary values. Adjust NoOfDecimals as needed.',
+        };
+    }
+    if (/qty|quantity/i.test(nameLower)) {
+        return {
+            name: fieldName,
+            extends: 'Qty',
+            label: `@MyModel:${fieldName}`,
+            properties: { Extends: 'Qty', NoOfDecimals: '2' },
+            note: 'Extends Qty (Real) — suitable for inventory quantities.',
+        };
+    }
+    if (/date$/i.test(nameLower)) {
+        return {
+            name: fieldName,
+            extends: 'Date',
+            label: `@MyModel:${fieldName}`,
+            properties: { Extends: 'Date' },
+            note: 'Extends Date — suitable for calendar date fields.',
+        };
+    }
+    if (/datetime/i.test(nameLower)) {
+        return {
+            name: fieldName,
+            extends: 'TransDateTime',
+            label: `@MyModel:${fieldName}`,
+            properties: { Extends: 'TransDateTime' },
+            note: 'Extends TransDateTime (UtcDateTime) — suitable for timestamp fields.',
+        };
+    }
+    if (/id$/i.test(nameLower) || /num$/i.test(nameLower)) {
+        return {
+            name: fieldName,
+            extends: 'SysGroup',
+            label: `@MyModel:${fieldName}`,
+            stringSize: 20,
+            properties: { Extends: 'SysGroup', StringSize: '20' },
+            note: 'Extends SysGroup (String 10) — suitable for ID/number fields. Adjust StringSize.',
+        };
+    }
+    if (/description|desc|name|text|remark|comment|note/i.test(nameLower)) {
+        return {
+            name: fieldName,
+            extends: 'Description',
+            label: `@MyModel:${fieldName}`,
+            stringSize: 60,
+            properties: { Extends: 'Description', StringSize: '60' },
+            note: 'Extends Description (String 60) — suitable for text/name fields. Adjust StringSize.',
+        };
+    }
+    if (/percent|pct/i.test(nameLower)) {
+        return {
+            name: fieldName,
+            extends: 'Percent',
+            label: `@MyModel:${fieldName}`,
+            properties: { Extends: 'Percent', NoOfDecimals: '2' },
+            note: 'Extends Percent (Real) — suitable for percentage fields.',
+        };
+    }
+    if (/flag|enabled|active|status|bool/i.test(nameLower)) {
+        return {
+            name: fieldName,
+            extends: 'NoYesId',
+            label: `@MyModel:${fieldName}`,
+            properties: { Extends: 'NoYesId' },
+            note: 'Extends NoYesId (Integer) — suitable for boolean/flag fields.',
+        };
+    }
+    return {
+        name: fieldName,
+        extends: 'SysGroup',
+        label: `@MyModel:${fieldName}`,
+        stringSize: 30,
+        properties: { Extends: 'SysGroup', StringSize: '30' },
+        note: 'Generic string EDT. Review the base type (Extends) and StringSize for your specific use case.',
+    };
+}
+/**
+ * Calculate confidence score based on string similarity
+ */
+function calculateConfidence(fieldName, edtName, context) {
+    const field = fieldName.toLowerCase();
+    const edt = edtName.toLowerCase();
+    if (field === edt)
+        return 1.0;
+    if (edt.includes(field)) {
+        return 0.9 - (edt.length - field.length) * 0.01;
+    }
+    if (field.includes(edt)) {
+        return 0.8 - (field.length - edt.length) * 0.01;
+    }
+    const distance = levenshteinDistance(field, edt);
+    const maxLength = Math.max(field.length, edt.length);
+    const similarity = 1 - distance / maxLength;
+    if (context && edt.includes(context.toLowerCase())) {
+        return Math.min(similarity + 0.1, 1.0);
+    }
+    return Math.max(similarity, 0.3);
+}
+/**
+ * Levenshtein distance algorithm
+ */
+function levenshteinDistance(a, b) {
+    const matrix = [];
+    for (let i = 0; i <= b.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= a.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+/**
+ * Get heuristic EDT suggestions based on field name patterns
+ */
+function getHeuristicSuggestions(fieldName, context) {
+    const nameLower = fieldName.toLowerCase();
+    const suggestions = [];
+    const patterns = [
+        [/^recid$/i, 'RecId', 'Standard RecId field'],
+        [/name/i, 'Name', 'Field contains "name"'],
+        [/description|desc/i, 'Description', 'Field contains "description"'],
+        [/amount/i, 'AmountMST', 'Field contains "amount"'],
+        [/quantity|qty/i, 'Qty', 'Field contains "quantity"'],
+        [/price/i, 'PriceUnit', 'Field contains "price"'],
+        [/date/i, 'TransDate', 'Field contains "date"'],
+        [/time|datetime/i, 'TransDateTime', 'Field contains "time"'],
+        [/account/i, 'LedgerAccount', 'Field contains "account"'],
+        [/customer|cust(?!om)/i, 'CustAccount', 'Field contains "customer"'],
+        [/vendor|vend/i, 'VendAccount', 'Field contains "vendor"'],
+        [/item/i, 'ItemId', 'Field contains "item"'],
+        [/percent|pct/i, 'Percent', 'Field contains "percent"'],
+        [/status/i, 'NoYesId', 'Field contains "status"'],
+        [/enabled|active/i, 'NoYesId', 'Field contains "enabled/active"'],
+        [/warehouse/i, 'InventLocationId', 'Field contains "warehouse"'],
+        [/site/i, 'InventSiteId', 'Field contains "site"'],
+        [/dimension/i, 'DimensionDefault', 'Field contains "dimension"'],
+        [/currency/i, 'CurrencyCode', 'Field contains "currency"'],
+        [/phone/i, 'Phone', 'Field contains "phone"'],
+        [/email/i, 'Email', 'Field contains "email"'],
+        [/address/i, 'AddressStreet', 'Field contains "address"'],
+        [/id$/i, 'RefRecId', 'Field ends with "Id"'],
+    ];
+    for (const [pattern, edt, reason] of patterns) {
+        if (pattern.test(nameLower)) {
+            suggestions.push({
+                edt,
+                confidence: 0.85,
+                reason,
+            });
+        }
+    }
+    if (context) {
+        const contextLower = context.toLowerCase();
+        if (contextLower.includes('sales') || contextLower.includes('order')) {
+            if (nameLower.includes('customer')) {
+                suggestions.push({ edt: 'CustAccount', confidence: 0.9, reason: 'Context: sales/order' });
+            }
+            if (nameLower.includes('line')) {
+                suggestions.push({ edt: 'LineNum', confidence: 0.85, reason: 'Context: sales/order lines' });
+            }
+        }
+        if (contextLower.includes('inventory') || contextLower.includes('stock')) {
+            if (nameLower.includes('location')) {
+                suggestions.push({ edt: 'InventLocationId', confidence: 0.9, reason: 'Context: inventory' });
+            }
+            if (nameLower.includes('item')) {
+                suggestions.push({ edt: 'ItemId', confidence: 0.9, reason: 'Context: inventory' });
+            }
+        }
+        if (contextLower.includes('ledger') || contextLower.includes('journal')) {
+            if (nameLower.includes('account')) {
+                suggestions.push({ edt: 'LedgerAccount', confidence: 0.9, reason: 'Context: ledger/journal' });
+            }
+        }
+    }
+    return suggestions;
+}
+//# sourceMappingURL=suggestEdt.js.map