@mcp-consultant-tools/powerplatform 27.0.0 → 28.0.0-beta.4

package/build/tools/plugin-tools.js

@@ -0,0 +1,137 @@
+/**
+ * Plugin Tools - 4 tools for plugin inspection
+ */
+import { z } from 'zod';
+export function registerPluginTools(server, ctx) {
+    server.tool("get-plugin-assemblies", "Get a list of all plugin assemblies in the environment", {
+        includeManaged: z.boolean().optional().describe("Include managed assemblies (default: false)"),
+        maxRecords: z.number().optional().describe("Maximum number of assemblies to return (default: 100)"),
+    }, async ({ includeManaged, maxRecords }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getPluginAssemblies(includeManaged || false, maxRecords || 100);
+            const resultStr = JSON.stringify(result, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${result.totalCount} plugin assemblies:\n\n${resultStr}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting plugin assemblies:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get plugin assemblies: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("get-plugin-asm-full", "Get comprehensive information about a plugin assembly including all types, steps, images, and validation", {
+        assemblyName: z.string().describe("The name of the plugin assembly"),
+        includeDisabled: z.boolean().optional().describe("Include disabled steps (default: false)"),
+    }, async ({ assemblyName, includeDisabled }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getPluginAssemblyComplete(assemblyName, includeDisabled || false);
+            const resultStr = JSON.stringify(result, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Plugin assembly '${assemblyName}' complete information:\n\n${resultStr}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting plugin assembly:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get plugin assembly: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("get-entity-plugins", "Get all plugins that execute on a specific entity, organized by message and execution order", {
+        entityName: z.string().describe("The logical name of the entity"),
+        messageFilter: z.string().optional().describe("Filter by message name (e.g., 'Create', 'Update', 'Delete')"),
+        includeDisabled: z.boolean().optional().describe("Include disabled steps (default: false)"),
+    }, async ({ entityName, messageFilter, includeDisabled }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getEntityPluginPipeline(entityName, messageFilter, includeDisabled || false);
+            const resultStr = JSON.stringify(result, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Plugin pipeline for entity '${entityName}':\n\n${resultStr}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting entity plugin pipeline:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get entity plugin pipeline: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("get-plugin-trace-logs", "Query plugin trace logs with filtering and exception parsing", {
+        entityName: z.string().optional().describe("Filter by entity logical name"),
+        messageName: z.string().optional().describe("Filter by message name (e.g., 'Update')"),
+        correlationId: z.string().optional().describe("Filter by correlation ID"),
+        pluginStepId: z.string().optional().describe("Filter by specific step ID"),
+        exceptionOnly: z.boolean().optional().describe("Only return logs with exceptions (default: false)"),
+        hoursBack: z.number().optional().describe("How many hours back to search (default: 24)"),
+        maxRecords: z.number().optional().describe("Maximum number of logs to return (default: 50)"),
+    }, async ({ entityName, messageName, correlationId, pluginStepId, exceptionOnly, hoursBack, maxRecords }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getPluginTraceLogs({
+                entityName,
+                messageName,
+                correlationId,
+                pluginStepId,
+                exceptionOnly: exceptionOnly || false,
+                hoursBack: hoursBack || 24,
+                maxRecords: maxRecords || 50
+            });
+            const resultStr = JSON.stringify(result, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Plugin trace logs (found ${result.totalCount}):\n\n${resultStr}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting plugin trace logs:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get plugin trace logs: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=plugin-tools.js.map

package/build/tools/plugin-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-tools.js","sourceRoot":"","sources":["../../src/tools/plugin-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,mBAAmB,CAAC,MAAW,EAAE,GAAmB;IAClE,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,wDAAwD,EACxD;QACE,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC9F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;KACpG,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,UAAU,EAAO,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,cAAc,IAAI,KAAK,EAAE,UAAU,IAAI,GAAG,CAAC,CAAC;YAC7F,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAElD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,SAAS,MAAM,CAAC,UAAU,0BAA0B,SAAS,EAAE;qBACtE;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oCAAoC,KAAK,CAAC,OAAO,EAAE;qBAC1D;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,0GAA0G,EAC1G;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACpE,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;KAC5F,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,eAAe,EAAO,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,yBAAyB,CAAC,YAAY,EAAE,eAAe,IAAI,KAAK,CAAC,CAAC;YAC/F,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAElD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oBAAoB,YAAY,8BAA8B,SAAS,EAAE;qBAChF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YACvD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,kCAAkC,KAAK,CAAC,OAAO,EAAE;qBACxD;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,6FAA6F,EAC7F;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QACjE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;QAC5G,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;KAC5F,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAO,EAAE,EAAE;QAC5D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,uBAAuB,CAAC,UAAU,EAAE,aAAa,EAAE,eAAe,IAAI,KAAK,CAAC,CAAC;YAC1G,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAElD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,+BAA+B,UAAU,SAAS,SAAS,EAAE;qBACpE;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;YAC9D,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,yCAAyC,KAAK,CAAC,OAAO,EAAE;qBAC/D;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,8DAA8D,EAC9D;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAC3E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACtF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QACzE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QAC1E,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;QACnG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACxF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;KAC7F,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAO,EAAE,EAAE;QAC5G,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC;gBAC9C,UAAU;gBACV,WAAW;gBACX,aAAa;gBACb,YAAY;gBACZ,aAAa,EAAE,aAAa,IAAI,KAAK;gBACrC,SAAS,EAAE,SAAS,IAAI,EAAE;gBAC1B,UAAU,EAAE,UAAU,IAAI,EAAE;aAC7B,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAElD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,4BAA4B,MAAM,CAAC,UAAU,SAAS,SAAS,EAAE;qBACxE;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oCAAoC,KAAK,CAAC,OAAO,EAAE;qBAC1D;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/security-tools.d.ts

@@ -0,0 +1,3 @@
+import type { ServiceContext } from '../types.js';
+export declare function registerSecurityTools(server: any, ctx: ServiceContext): void;
+//# sourceMappingURL=security-tools.d.ts.map

package/build/tools/security-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-tools.d.ts","sourceRoot":"","sources":["../../src/tools/security-tools.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAyN5E"}

package/build/tools/security-tools.js

@@ -0,0 +1,187 @@
+/**
+ * Security Tools - 4 tools for connection references and security roles
+ */
+import { z } from 'zod';
+export function registerSecurityTools(server, ctx) {
+    server.tool("get-connection-references", `Get all connection references in the environment with their connection status and connector details.
+
+Connection references define the connector configurations used by Power Automate flows and other components.
+Returns a summary with counts by connector type, plus the full list of connection references.`, {
+        maxRecords: z.number().optional().describe("Maximum records to return (default: 100)"),
+        managedOnly: z.boolean().optional().describe("Filter to managed connection references only (default: false)"),
+        hasConnection: z.boolean().optional().describe("Filter: true = only with connections set, false = only without connections"),
+    }, async ({ maxRecords, managedOnly, hasConnection }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getConnectionReferences({
+                maxRecords,
+                managedOnly,
+                hasConnection,
+            });
+            const summaryLines = [
+                `Total: ${result.summary.total}`,
+                `With connection: ${result.summary.withConnection}`,
+                `Without connection: ${result.summary.withoutConnection}`,
+                `Managed: ${result.summary.managed}, Unmanaged: ${result.summary.unmanaged}`,
+                '',
+                'By connector:',
+                ...Object.entries(result.summary.byConnector)
+                    .sort(([, a], [, b]) => b - a)
+                    .map(([name, count]) => `  ${name}: ${count}`),
+            ];
+            const refLines = result.references.map((r) => `- ${r.displayName} (${r.logicalName})\n` +
+                `  Connector: ${r.connectorId}\n` +
+                `  Connection: ${r.connectionId ? r.connectionId : 'Not set'}\n` +
+                `  State: ${r.stateCode === 0 ? 'Active' : 'Inactive'} | Managed: ${r.isManaged}`);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Connection References\n\n${summaryLines.join('\n')}\n\n${refLines.join('\n\n')}`,
+                    }],
+            };
+        }
+        catch (error) {
+            console.error("Error getting connection references:", error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Failed to get connection references: ${error.message}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get-security-roles", `Get custom security roles defined in the environment. By default excludes well-known system roles (System Administrator, System Customizer, etc.).
+
+Useful for security audits and understanding what custom roles exist in the environment.`, {
+        solutionUniqueName: z.string().optional().describe("Filter to roles in a specific solution"),
+        excludeSystemRoles: z.boolean().optional().describe("Exclude System Administrator, System Customizer, and other built-in roles (default: true)"),
+        maxRecords: z.number().optional().describe("Maximum records to return (default: 100)"),
+    }, async ({ solutionUniqueName, excludeSystemRoles, maxRecords }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getSecurityRoles({
+                solutionUniqueName,
+                excludeSystemRoles,
+                maxRecords,
+            });
+            const summaryLines = [
+                `Total: ${result.summary.total}`,
+                `Managed: ${result.summary.managed}, Unmanaged: ${result.summary.unmanaged}`,
+                result.summary.systemRolesExcluded > 0
+                    ? `System roles excluded: ${result.summary.systemRolesExcluded}`
+                    : null,
+            ].filter(Boolean);
+            const roleLines = result.roles.map((r) => `- ${r.name}\n` +
+                `  ID: ${r.roleId}\n` +
+                `  Unique ID: ${r.roleIdUnique}\n` +
+                `  Managed: ${r.isManaged} | Customizable: ${r.isCustomizable}`);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Security Roles\n\n${summaryLines.join('\n')}\n\n${roleLines.join('\n\n')}`,
+                    }],
+            };
+        }
+        catch (error) {
+            console.error("Error getting security roles:", error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Failed to get security roles: ${error.message}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get-security-role-privileges", `Get the privilege assignments for a specific security role, showing what entities/actions the role grants access to.
+
+Results are grouped by entity, showing the access depth (User/Business Unit/Parent:Child BU/Organization) for each action (Create, Read, Write, Delete, Append, AppendTo, Assign, Share).`, {
+        roleId: z.string().describe("The role ID (GUID) to get privileges for"),
+        entityFilter: z.string().optional().describe("Filter privileges to a specific entity name (partial match)"),
+        accessRightFilter: z.string().optional().describe("Filter by access right: Create, Read, Write, Delete, Append, AppendTo, Assign, Share"),
+    }, async ({ roleId, entityFilter, accessRightFilter }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getSecurityRolePrivileges({
+                roleId,
+                entityFilter,
+                accessRightFilter,
+            });
+            const summaryLines = [
+                `Role ID: ${result.roleId}`,
+                `Total privileges: ${result.summary.total}`,
+                `Entities: ${result.summary.entityCount}`,
+                '',
+                'By access right:',
+                ...Object.entries(result.summary.byAccessRight)
+                    .sort(([, a], [, b]) => b - a)
+                    .map(([right, count]) => `  ${right}: ${count}`),
+            ];
+            const entityLines = Object.entries(result.groupedByEntity)
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([entity, privs]) => {
+                const privLines = privs.map((p) => `    ${p.accessRight}: ${p.depth}`);
+                return `  ${entity}:\n${privLines.join('\n')}`;
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Security Role Privileges\n\n${summaryLines.join('\n')}\n\nPrivileges by Entity:\n${entityLines.join('\n\n')}`,
+                    }],
+            };
+        }
+        catch (error) {
+            console.error("Error getting security role privileges:", error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Failed to get security role privileges: ${error.message}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get-security-roles-by-solution", `Get all security roles that are components of a specific solution.
+
+Queries solution components with componenttype=20 (Security Role) and fetches role details.
+Optionally includes a privilege summary for each role (slower due to additional API calls).`, {
+        solutionUniqueName: z.string().describe("The solution unique name to get roles from"),
+        includePrivileges: z.boolean().optional().describe("Include privilege count summary per role (default: false, slower)"),
+    }, async ({ solutionUniqueName, includePrivileges }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getSecurityRolesBySolution({
+                solutionUniqueName,
+                includePrivileges,
+            });
+            const roleLines = result.roles.map((r) => {
+                let line = `- ${r.name}\n` +
+                    `  ID: ${r.roleId}\n` +
+                    `  Managed: ${r.isManaged} | Customizable: ${r.isCustomizable}`;
+                if (r.privilegeSummary) {
+                    line += `\n  Privileges: ${r.privilegeSummary.total} across ${r.privilegeSummary.entityCount} entities`;
+                }
+                return line;
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: `Security Roles in Solution '${result.solutionUniqueName}'\n\n` +
+                            `Total: ${result.summary.total}\n\n${roleLines.join('\n\n')}`,
+                    }],
+            };
+        }
+        catch (error) {
+            console.error("Error getting security roles by solution:", error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Failed to get security roles by solution: ${error.message}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=security-tools.js.map

package/build/tools/security-tools.js.map

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

package/build/tools/solution-tools.d.ts

@@ -0,0 +1,3 @@
+import type { ServiceContext } from '../types.js';
+export declare function registerSolutionTools(server: any, ctx: ServiceContext): void;
+//# sourceMappingURL=solution-tools.d.ts.map

package/build/tools/solution-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solution-tools.d.ts","sourceRoot":"","sources":["../../src/tools/solution-tools.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CA4V5E"}

package/build/tools/solution-tools.js

@@ -0,0 +1,283 @@
+/**
+ * Solution Tools - 8 tools for solution management and validation
+ */
+import { z } from 'zod';
+export function registerSolutionTools(server, ctx) {
+    server.tool("get-publishers", "Get all solution publishers (excluding system publishers)", {}, async () => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getPublishers();
+            const publishers = result.value || [];
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${publishers.length} publisher(s):\n\n` +
+                            publishers.map((p) => `- ${p.friendlyname} (${p.uniquename})\n  Prefix: ${p.customizationprefix}\n  ID: ${p.publisherid}`).join('\n')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            console.error("Error getting publishers:", error);
+            return {
+                content: [{ type: "text", text: `Failed to get publishers: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("get-solutions", "Get all visible solutions in the environment", {}, async () => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getSolutions();
+            const solutions = result.value || [];
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${solutions.length} solution(s):\n\n` +
+                            solutions.map((s) => `- ${s.friendlyname} (${s.uniquename})\n  Version: ${s.version}\n  ID: ${s.solutionid}`).join('\n')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            console.error("Error getting solutions:", error);
+            return {
+                content: [{ type: "text", text: `Failed to get solutions: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("get-solution-components", "List all components in a solution, grouped by component type. Returns component IDs, types, and behavior settings.", {
+        solutionUniqueName: z.string().describe("The unique name of the solution to list components for"),
+    }, async ({ solutionUniqueName }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getSolutionComponents(solutionUniqueName);
+            const components = result.value || [];
+            const componentTypeNames = {
+                1: 'Entity', 2: 'Attribute', 3: 'Relationship', 9: 'OptionSet',
+                10: 'EntityRelationship', 13: 'ManagedProperty', 20: 'Policy',
+                24: 'Privilege', 25: 'PrivilegeObjectTypeCode', 26: 'Role',
+                29: 'Workflow', 31: 'Report', 36: 'Template', 37: 'Contract Template',
+                38: 'Article Template', 39: 'Mail Merge Template', 44: 'Duplicate Rule',
+                46: 'Duplicate Rule Condition', 48: 'Entity Map', 49: 'Attribute Map',
+                59: 'SavedQuery', 60: 'Form', 61: 'WebResource', 62: 'SiteMap',
+                63: 'Connection Role', 65: 'Hierarchy Rule', 66: 'Custom Control',
+                70: 'FieldSecurityProfile', 71: 'FieldPermission', 80: 'AppModule',
+                91: 'PluginAssembly', 92: 'PluginType', 93: 'SDKMessageProcessingStep',
+                95: 'ServiceEndpoint', 150: 'RoutingRule', 152: 'SLA',
+                154: 'ConvertRule', 300: 'Canvas App', 371: 'Connector',
+                372: 'EnvironmentVariableDefinition', 373: 'EnvironmentVariableValue',
+                380: 'AIModel', 381: 'AIConfiguration',
+            };
+            const grouped = {};
+            for (const c of components) {
+                const type = c.componenttype;
+                if (!grouped[type])
+                    grouped[type] = [];
+                grouped[type].push(c);
+            }
+            const lines = [`Found ${components.length} component(s) in solution '${solutionUniqueName}':\n`];
+            for (const [type, items] of Object.entries(grouped)) {
+                const typeName = componentTypeNames[Number(type)] || `Type ${type}`;
+                lines.push(`\n${typeName} (${items.length}):`);
+                for (const item of items) {
+                    lines.push(`  - ${item.objectid} (behavior: ${item.rootcomponentbehavior ?? 'include subcomponents'})`);
+                }
+            }
+            return {
+                content: [{ type: "text", text: lines.join('\n') }]
+            };
+        }
+        catch (error) {
+            console.error("Error getting solution components:", error);
+            return {
+                content: [{ type: "text", text: `Failed to get solution components: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("check-dependencies", "Check dependencies before deleting a component", {
+        componentId: z.string().describe("Component ID (GUID or MetadataId)"),
+        componentType: z.number().describe("Component type: 1=Entity, 2=Attribute, 9=OptionSet, 24=Form, 26=SavedQuery, 29=Workflow, 60=SystemForm, 61=WebResource")
+    }, async ({ componentId, componentType }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.checkDependencies(componentId, componentType);
+            const dependencies = result.EntityCollection?.Entities || [];
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${dependencies.length} dependenc${dependencies.length === 1 ? 'y' : 'ies'} for component '${componentId}':\n\n` +
+                            (dependencies.length > 0
+                                ? dependencies.map((d) => `- ${d.Attributes?.dependentcomponentobjectid || 'Unknown'}\n  Type: ${d.Attributes?.dependentcomponenttype || 'Unknown'}`).join('\n')
+                                : 'No dependencies found - component can be safely deleted')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            console.error("Error checking dependencies:", error);
+            return {
+                content: [{ type: "text", text: `Failed to check dependencies: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("validate-schema-name", "Validate a schema name against PowerPlatform naming rules", {
+        schemaName: z.string().describe("Schema name to validate"),
+        prefix: z.string().describe("Required customization prefix")
+    }, async ({ schemaName, prefix }) => {
+        try {
+            const service = ctx.pp;
+            const result = service.validateSchemaName(schemaName, prefix);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Schema Name Validation for '${schemaName}':\n\n` +
+                            `Valid: ${result.valid ? '✅' : '❌'}\n\n` +
+                            (result.errors.length > 0
+                                ? `Errors:\n${result.errors.map(e => `- ${e}`).join('\n')}`
+                                : 'No validation errors')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            console.error("Error validating schema name:", error);
+            return {
+                content: [{ type: "text", text: `Failed to validate schema name: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("check-delete-eligibility", "Check if a component can be safely deleted", {
+        componentId: z.string().describe("Component ID (GUID or MetadataId)"),
+        componentType: z.number().describe("Component type: 1=Entity, 2=Attribute, 9=OptionSet, 24=Form, 26=SavedQuery, 29=Workflow, 60=SystemForm, 61=WebResource")
+    }, async ({ componentId, componentType }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.checkDeleteEligibility(componentId, componentType);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Delete Eligibility for component '${componentId}':\n\n` +
+                            `Can Delete: ${result.canDelete ? '✅ Yes' : '❌ No'}\n` +
+                            `Dependencies: ${result.dependencies.length}\n\n` +
+                            (result.dependencies.length > 0
+                                ? `Blocking Dependencies:\n${result.dependencies.map((d) => `- ${d.Attributes?.dependentcomponentobjectid || 'Unknown'}`).join('\n')}`
+                                : 'No blocking dependencies - component can be safely deleted')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            console.error("Error checking delete eligibility:", error);
+            return {
+                content: [{ type: "text", text: `Failed to check delete eligibility: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("validate-dataverse", "Validate Dataverse entities against internal best practices for column naming, prefixes, configuration, and entity icons. Checks schema name casing, lookup naming conventions, option set scope (all must be global), required columns, publisher prefix compliance, and entity icon assignment. Supports solution-based validation or explicit entity list with configurable time range filtering.", {
+        solutionUniqueName: z.string().optional().describe("Solution unique name to validate (e.g., 'RTPICore', 'MCPTestCore'). Mutually exclusive with entityLogicalNames."),
+        entityLogicalNames: z.array(z.string()).optional().describe("Explicit list of entity logical names to validate (e.g., ['sic_strikeaction', 'sic_application']). Mutually exclusive with solutionUniqueName."),
+        publisherPrefix: z.string().describe("Publisher prefix to validate against (e.g., 'sic_'). Required."),
+        recentDays: z.number().optional().describe("Only validate columns created in the last N days. Set to 0 to validate all columns regardless of age. Default: 30."),
+        includeRefDataTables: z.boolean().optional().describe("Include RefData tables (schema starts with prefix + 'ref_') in validation. Default: true."),
+        rules: z.array(z.string()).optional().describe("Specific rules to validate: 'prefix', 'lowercase', 'lookup', 'optionset', 'required-column', 'entity-icon'. Default: all rules."),
+        maxEntities: z.number().optional().describe("Maximum number of entities to validate (safety limit). Default: 0 (unlimited)."),
+        requiredColumns: z.array(z.string()).optional().describe("List of required column schema names to check for (without prefix). Use '{prefix}' placeholder which will be replaced with publisherPrefix at runtime. Default: ['{prefix}updatedbyprocess']. Example: ['{prefix}sqlcreatedon', '{prefix}sqlmodifiedon'] for SQL timestamp columns.")
+    }, async ({ solutionUniqueName, entityLogicalNames, publisherPrefix, recentDays, includeRefDataTables, rules, maxEntities, requiredColumns }) => {
+        try {
+            if (!solutionUniqueName && !entityLogicalNames) {
+                return {
+                    content: [{ type: "text", text: "Error: Either solutionUniqueName or entityLogicalNames must be provided" }],
+                    isError: true
+                };
+            }
+            if (solutionUniqueName && entityLogicalNames) {
+                return {
+                    content: [{ type: "text", text: "Error: solutionUniqueName and entityLogicalNames are mutually exclusive" }],
+                    isError: true
+                };
+            }
+            const service = ctx.pp;
+            const result = await service.validateBestPractices(solutionUniqueName, entityLogicalNames, publisherPrefix, recentDays ?? 30, includeRefDataTables ?? true, rules ?? ['prefix', 'lowercase', 'lookup', 'optionset', 'required-column', 'entity-icon'], maxEntities ?? 0, requiredColumns ?? ['{prefix}updatedbyprocess']);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            console.error("Error validating best practices:", error);
+            return {
+                content: [{ type: "text", text: `Failed to validate best practices: ${error.message}` }],
+                isError: true
+            };
+        }
+    });
+    server.tool("generate-dbml-schema", `Generates DBML (Database Markup Language) schema from Dataverse entities.
+
+Accepts solution names, explicit entity lists, or both. Returns DBML text
+and a clickable dbdiagram.io URL for visualization.
+
+DBML output includes:
+- Table definitions with columns and types
+- Primary key markers [pk]
+- Foreign key relationships (Ref: statements) for all lookups
+
+Example output:
+\`\`\`dbml
+Table si_directdebit {
+    si_directdebitid uniqueidentifier [pk]
+    si_name nvarchar
+    si_accountid lookup
+}
+Ref: si_directdebit.si_accountid > account.accountid
+\`\`\``, {
+        solutions: z.array(z.string()).optional()
+            .describe('One or more solution unique names to extract entities from'),
+        entities: z.array(z.string()).optional()
+            .describe('Explicit list of entity logical names to include'),
+        includeSystemColumns: z.boolean().optional()
+            .describe('Include system columns like createdon, modifiedon (default: false)'),
+        includeStateStatus: z.boolean().optional()
+            .describe('Include statecode/statuscode columns (default: false)'),
+        prefix: z.string().optional()
+            .describe('Only include columns matching this prefix (e.g., "si_")'),
+        depth: z.number().optional()
+            .describe('Relationship traversal depth for discovering related entities (default: 0)'),
+        includePolymorphicLookups: z.boolean().optional()
+            .describe('Include Customer/Owner/PartyList lookups (default: true)'),
+    }, async (params) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.generateDbmlSchema(params);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error generating DBML schema:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to generate DBML schema: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=solution-tools.js.map