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

package/build/tools/integration-tools.js

@@ -0,0 +1,324 @@
+/**
+ * Integration Tools - 5 tools for integration audit and environment variables
+ */
+import { z } from 'zod';
+export function registerIntegrationTools(server, ctx) {
+    server.tool("get-service-endpoints", `Get all service endpoints (webhooks, Azure Service Bus, REST) configured in the environment.
+
+Service endpoints are external URLs that Dataverse can call via SDK message processing steps.
+Use this to discover outbound integration touchpoints.
+
+Optionally validate endpoint URLs against required patterns (e.g. your organization's domains).
+Flagged endpoints are those whose URLs do NOT match any of the provided patterns.
+
+Returns:
+- Endpoint name, full URL, contract type (OneWay/TwoWay/Queue/Topic/REST/EventHub/Webhook/EventGrid)
+- Authentication type (Anonymous/HttpHeader/WebKey/SASKey/etc.)
+- Number of SDK message steps using each endpoint
+- Summary statistics by type and auth method
+- Flagged endpoints (when requiredUrlStrings provided)`, {
+        maxRecords: z.number().optional().describe("Maximum endpoints to return (default: 100)"),
+        requiredUrlStrings: z.array(z.string()).optional().describe("URL patterns to validate against. Endpoints not matching any pattern are flagged.\n\nExamples:\n  - Validate production URLs: `[\"mycompany.com\"]`\n  - Multiple environments: `[\"prod.mycompany.com\", \"staging.mycompany.com\"]`"),
+        outputFormat: z.enum(["summary", "full"]).optional().describe("Output format: 'summary' shows flagged items only, 'full' shows everything (default: full)"),
+        excludeOotb: z.boolean().optional().describe("Exclude Microsoft out-of-the-box (OOTB) components from results (default: true). Set to false to include all items."),
+    }, async ({ maxRecords, requiredUrlStrings, outputFormat, excludeOotb }) => {
+        try {
+            const service = ctx.pp;
+            const ootb = excludeOotb ?? true;
+            if (requiredUrlStrings && requiredUrlStrings.length > 0) {
+                const result = await service.getServiceEndpointsValidated(maxRecords ?? 100, requiredUrlStrings, ootb);
+                const lines = [];
+                lines.push(`# Service Endpoints (${result.summary.total} found, ${result.summary.flagged} flagged)`);
+                lines.push('');
+                if (result.flaggedEndpoints.length > 0) {
+                    lines.push('## Flagged Endpoints');
+                    lines.push('');
+                    lines.push('| Name | URL | Issue |');
+                    lines.push('|------|-----|-------|');
+                    for (const f of result.flaggedEndpoints) {
+                        lines.push(`| ${f.endpoint.name} | ${f.endpoint.url} | ${f.urlIssue} |`);
+                    }
+                    lines.push('');
+                }
+                if (outputFormat !== 'summary') {
+                    lines.push('## All Endpoints');
+                    lines.push('');
+                    lines.push('| Name | URL |');
+                    lines.push('|------|-----|');
+                    for (const ep of result.allEndpoints) {
+                        lines.push(`| ${ep.name} | ${ep.url} |`);
+                    }
+                    lines.push('');
+                }
+                return { content: [{ type: "text", text: lines.join('\n') }] };
+            }
+            const result = await service.getServiceEndpoints(maxRecords ?? 100, ootb);
+            const ootbNote = result.summary.ootbExcluded ? `, ${result.summary.ootbExcluded} OOTB excluded` : '';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Service Endpoints (${result.summary.total} found${ootbNote}):\n\n${JSON.stringify(result, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting service endpoints:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get service endpoints: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("get-webhook-registrations", `Get all webhook-type SDK message processing steps in the environment.
+
+Webhooks are registrations that call external service endpoints when Dataverse events occur.
+This identifies inbound integration patterns where external systems receive notifications.
+
+Returns:
+- Webhook name and endpoint URL
+- Trigger entity and message (Create/Update/Delete)
+- Filtering attributes and execution stage
+- Enabled/disabled status
+- Summary by entity and message type`, {
+        maxRecords: z.number().optional().describe("Maximum webhooks to return (default: 100)"),
+        excludeOotb: z.boolean().optional().describe("Exclude Microsoft out-of-the-box (OOTB) components from results (default: true). Set to false to include all items."),
+    }, async ({ maxRecords, excludeOotb }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getWebhookRegistrations(maxRecords ?? 100, excludeOotb ?? true);
+            const ootbNote = result.summary.ootbExcluded ? `, ${result.summary.ootbExcluded} OOTB excluded` : '';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Webhook Registrations (${result.summary.total} found, ${result.summary.enabledCount} enabled${ootbNote}):\n\n${JSON.stringify(result, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting webhook registrations:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get webhook registrations: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("analyze-flow-complexity", `Analyze Power Automate flow complexity and calculate risk scores.
+
+Now includes URL extraction and hardcoded secret detection per flow.
+
+Complexity scoring factors:
+- Action count (base complexity)
+- Unique connectors (integration surface, +2 each)
+- HTTP/REST connectors (external dependency, +5 each)
+- Premium connectors (licensing concern, +3 each)
+- Conditions/switches (+2 each)
+- Loops (+3 each)
+- Parallel branches (+3 each)
+- Error handling scopes (+1 each)
+
+Risk levels: Low (0-20), Medium (21-50), High (51-100), Critical (>100)
+
+Use flowId to analyze a single flow, or omit to analyze all flows.`, {
+        flowId: z.string().optional().describe("Specific flow ID to analyze (omit for all flows)"),
+        maxFlows: z.number().optional().describe("Maximum flows to analyze when flowId not specified (default: 0 = unlimited)"),
+        outputFormat: z.enum(["summary", "full"]).optional().describe("Output format: 'summary' shows flagged items and stats only, 'full' shows all details (default: full)"),
+        excludeOotb: z.boolean().optional().describe("Exclude Microsoft out-of-the-box (OOTB/managed) flows from analysis (default: true). Set to false to include all flows."),
+    }, async ({ flowId, maxFlows, outputFormat, excludeOotb }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.analyzeFlowComplexity(flowId, maxFlows ?? 0, excludeOotb ?? true);
+            const lines = [];
+            const ootbNote = result.summary.ootbExcluded ? `, ${result.summary.ootbExcluded} OOTB excluded` : '';
+            lines.push(`# Flow Complexity Analysis (${result.summary.total} flows${ootbNote})`);
+            lines.push('');
+            lines.push(`- Average Score: ${result.summary.averageComplexity}`);
+            lines.push(`- By Risk: Low=${result.summary.byRiskLevel.Low}, Medium=${result.summary.byRiskLevel.Medium}, High=${result.summary.byRiskLevel.High}, Critical=${result.summary.byRiskLevel.Critical}`);
+            lines.push(`- URLs Found: ${result.summary.totalUrlsFound ?? 0}`);
+            lines.push(`- Secret Warnings: ${result.summary.totalSecretWarnings ?? 0} in ${result.summary.flowsWithSecretWarnings ?? 0} flows`);
+            if (result.summary.uniqueEnvironmentVariables && result.summary.uniqueEnvironmentVariables.length > 0) {
+                lines.push(`- Environment Variables Referenced: ${result.summary.uniqueEnvironmentVariables.join(', ')}`);
+            }
+            lines.push('');
+            if (result.summary.highRiskFlows.length > 0) {
+                lines.push('## High/Critical Risk Flows');
+                for (const name of result.summary.highRiskFlows) {
+                    const flow = result.flows.find(f => f.name === name);
+                    if (flow) {
+                        lines.push(`- **${name}** - Score: ${flow.complexity.score} (${flow.complexity.riskLevel})`);
+                    }
+                }
+                lines.push('');
+            }
+            const flowsWithSecrets = result.flows.filter(f => f.secretWarnings && f.secretWarnings.length > 0);
+            if (flowsWithSecrets.length > 0) {
+                lines.push('## Security Warnings');
+                lines.push('');
+                lines.push('| Flow | Action | Field | Warning |');
+                lines.push('|------|--------|-------|---------|');
+                for (const flow of flowsWithSecrets) {
+                    for (const w of flow.secretWarnings) {
+                        lines.push(`| ${flow.name} | ${w.actionName} | ${w.fieldPath} | ${w.message} |`);
+                    }
+                }
+                lines.push('');
+            }
+            if (outputFormat !== 'summary') {
+                lines.push('## Full Details');
+                lines.push('');
+                lines.push('```json');
+                lines.push(JSON.stringify(result, null, 2));
+                lines.push('```');
+            }
+            return { content: [{ type: "text", text: lines.join('\n') }] };
+        }
+        catch (error) {
+            console.error("Error analyzing flow complexity:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to analyze flow complexity: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("gen-integration-audit", `Generate a comprehensive integration audit report for the PowerPlatform environment.
+
+This top-down report aggregates all integration touchpoints:
+
+OUTBOUND: Service endpoints, flows with HTTP/external calls, plugins with external access
+INBOUND: Webhook registrations, flows with external triggers
+COMPLEXITY: Flow complexity scores, risk levels, URL extraction, secret detection
+ENVIRONMENT: Environment variable inventory with URL validation
+PLUGINS: Plugin assembly inventory
+
+Includes URL validation (flag endpoints/variables not matching required patterns),
+hardcoded secret detection in flows, and environment variable analysis.
+
+Returns a pre-formatted Markdown report. Use outputFormat="summary" for a compact view.`, {
+        maxFlows: z.number().optional().describe("Maximum flows to analyze (default: 0 = unlimited)"),
+        maxRecords: z.number().optional().describe("Maximum records to return for service endpoints, webhooks, and plugin assemblies (default: 100). Increase to get all items in large environments."),
+        requiredUrlStrings: z.array(z.string()).optional().describe("URL patterns to validate against. Endpoints and env vars not matching are flagged.\n\nExamples:\n  - `[\"mycompany.com\"]`\n  - `[\"prod.api.com\", \"staging.api.com\"]`"),
+        outputFormat: z.enum(["summary", "full"]).optional().describe("Output format: 'summary' shows flagged items and stats only, 'full' shows everything (default: full)"),
+        excludeOotb: z.boolean().optional().describe("Exclude Microsoft out-of-the-box (OOTB) components from results (default: true). Set to false to include all items."),
+    }, async ({ maxFlows, maxRecords, requiredUrlStrings, outputFormat, excludeOotb }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.generateIntegrationAuditReport(maxFlows ?? 0, requiredUrlStrings, outputFormat, excludeOotb ?? true, maxRecords ?? 100);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: result.markdownReport,
+                    },
+                    {
+                        type: "text",
+                        text: `\n\n---\n\n**Full JSON Data:**\n\n${JSON.stringify({
+                            summary: result.summary,
+                            riskAssessment: result.riskAssessment,
+                            outbound: {
+                                serviceEndpointCount: result.outbound.serviceEndpoints.length,
+                                httpFlowCount: result.outbound.httpFlows.length,
+                                externalPluginCount: result.outbound.externalPlugins.length,
+                            },
+                            inbound: {
+                                webhookCount: result.inbound.webhooks.length,
+                                externalTriggerFlowCount: result.inbound.externalTriggerFlows.length,
+                            },
+                            complexity: result.complexity.summary,
+                        }, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error generating integration audit report:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to generate integration audit report: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("get-env-variables", `Get all environment variable definitions from the PowerPlatform environment.
+
+Environment variables store configuration values (URLs, connection strings, feature flags)
+that can be referenced by flows and other components. Sensitive variables are masked.
+
+Optionally validate URL-type variables against required patterns to flag diverging values
+(e.g. variables pointing to wrong environments).
+
+Returns:
+- Schema name, display name, type (String/Number/Boolean/JSON/Secret)
+- Current value, default value, and effective value
+- Managed status and sensitivity flag
+- Diverging variables (when requiredUrlStrings provided)`, {
+        maxRecords: z.number().optional().describe("Maximum variables to return (default: 500)"),
+        requiredUrlStrings: z.array(z.string()).optional().describe("URL patterns to validate against. URL-type variables not matching any pattern are flagged.\n\nExamples:\n  - `[\"mycompany.com\"]`\n  - `[\"prod.api.com\", \"staging.api.com\"]`"),
+        outputFormat: z.enum(["summary", "full"]).optional().describe("Output format: 'summary' shows diverging variables only, 'full' shows everything (default: full)"),
+        excludeOotb: z.boolean().optional().describe("Exclude Microsoft out-of-the-box (OOTB) components from results (default: true). Set to false to include all items."),
+    }, async ({ maxRecords, requiredUrlStrings, outputFormat, excludeOotb }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getEnvironmentVariables(maxRecords ?? 500, requiredUrlStrings, excludeOotb ?? true);
+            const ootbNote = result.summary.ootbExcluded ? `, ${result.summary.ootbExcluded} OOTB excluded` : '';
+            const lines = [];
+            lines.push(`# Environment Variables (${result.summary.total} found${ootbNote})`);
+            lines.push('');
+            lines.push(`Types: ${Object.entries(result.summary.byType).map(([k, v]) => `${k}=${v}`).join(', ')}`);
+            lines.push('');
+            if (result.divergingVariables.length > 0) {
+                lines.push('## Diverging Variables');
+                lines.push('');
+                lines.push('| Schema Name | Display Name | Value | Reason |');
+                lines.push('|-------------|-------------|-------|--------|');
+                for (const d of result.divergingVariables) {
+                    const val = d.variable.isSensitive ? '***' : (d.variable.effectiveValue ?? '(none)');
+                    lines.push(`| ${d.variable.schemaName} | ${d.variable.displayName} | ${val} | ${d.reason} |`);
+                }
+                lines.push('');
+            }
+            if (outputFormat !== 'summary') {
+                lines.push('## All Variables');
+                lines.push('');
+                lines.push('| Schema Name | Display Name | Type | Effective Value | Managed |');
+                lines.push('|-------------|-------------|------|-----------------|---------|');
+                for (const v of result.allVariables) {
+                    const val = v.isSensitive ? (v.maskedValue ?? '***') : (v.effectiveValue ?? v.defaultValue ?? '(none)');
+                    const managed = v.isManaged ? 'Yes' : 'No';
+                    lines.push(`| ${v.schemaName} | ${v.displayName} | ${v.type} | ${val} | ${managed} |`);
+                }
+                lines.push('');
+            }
+            return { content: [{ type: "text", text: lines.join('\n') }] };
+        }
+        catch (error) {
+            console.error("Error getting environment variables:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get environment variables: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=integration-tools.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-tools.d.ts","sourceRoot":"","sources":["../../src/tools/metadata-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,CA8L5E"}

package/build/tools/metadata-tools.js

@@ -0,0 +1,165 @@
+/**
+ * Metadata Tools - 5 tools for entity metadata inspection
+ */
+import { z } from 'zod';
+export function registerMetadataTools(server, ctx) {
+    server.tool("get-entity-metadata", "Get metadata about a PowerPlatform entity", {
+        entityName: z.string().describe("The logical name of the entity"),
+    }, async ({ entityName }) => {
+        try {
+            const service = ctx.pp;
+            const metadata = await service.getEntityMetadata(entityName);
+            const metadataStr = JSON.stringify(metadata, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Entity metadata for '${entityName}':\n\n${metadataStr}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting entity metadata:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get entity metadata: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("get-entity-attributes", "Get attributes/fields of a PowerPlatform entity. Use filtering options to reduce response size for large entities.", {
+        entityName: z.string().describe("The logical name of the entity"),
+        prefix: z.string().optional().describe("Filter attributes by schema name prefix (e.g., 'si_' to get only custom columns)"),
+        attributeType: z.enum(['String', 'Integer', 'Boolean', 'DateTime', 'Decimal', 'Double', 'Money', 'Lookup', 'Picklist', 'State', 'Status', 'Uniqueidentifier', 'Memo', 'BigInt', 'Owner', 'Customer', 'PartyList']).optional().describe("Filter by attribute type"),
+        maxAttributes: z.number().optional().describe("Maximum number of attributes to return (omit for all)"),
+    }, async ({ entityName, prefix, attributeType, maxAttributes }) => {
+        try {
+            const service = ctx.pp;
+            const result = await service.getEntityAttributes(entityName, {
+                prefix,
+                attributeType,
+                maxAttributes
+            });
+            const attributesStr = JSON.stringify(result, null, 2);
+            let message = `Attributes for entity '${entityName}' (${result.returnedCount} returned)`;
+            if (prefix) {
+                message += `\nFiltered by prefix: ${prefix}`;
+            }
+            if (attributeType) {
+                message += `\nFiltered by type: ${attributeType}`;
+            }
+            if (result.hasMore) {
+                message += `\n⚠️ More attributes available - ${result.totalBeforeFilter} total before limit`;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${message}:\n\n${attributesStr}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting entity attributes:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get entity attributes: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("get-entity-attribute", "Get a specific attribute/field of a PowerPlatform entity", {
+        entityName: z.string().describe("The logical name of the entity"),
+        attributeName: z.string().describe("The logical name of the attribute")
+    }, async ({ entityName, attributeName }) => {
+        try {
+            const service = ctx.pp;
+            const attribute = await service.getEntityAttribute(entityName, attributeName);
+            const attributeStr = JSON.stringify(attribute, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Attribute '${attributeName}' for entity '${entityName}':\n\n${attributeStr}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting entity attribute:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get entity attribute: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("get-entity-relationships", "Get relationships (one-to-many and many-to-many) for a PowerPlatform entity", {
+        entityName: z.string().describe("The logical name of the entity"),
+    }, async ({ entityName }) => {
+        try {
+            const service = ctx.pp;
+            const relationships = await service.getEntityRelationships(entityName);
+            const relationshipsStr = JSON.stringify(relationships, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Relationships for entity '${entityName}':\n\n${relationshipsStr}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting entity relationships:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get entity relationships: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool("get-global-option-set", "Get a global option set definition by name", {
+        optionSetName: z.string().describe("The name of the global option set"),
+    }, async ({ optionSetName }) => {
+        try {
+            const service = ctx.pp;
+            const optionSet = await service.getGlobalOptionSet(optionSetName);
+            const optionSetStr = JSON.stringify(optionSet, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Global option set '${optionSetName}':\n\n${optionSetStr}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error("Error getting global option set:", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to get global option set: ${error.message}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=metadata-tools.js.map

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

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

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

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

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

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