mcp-dataverse 0.1.0

package/dist/tools/solution.tools.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+const ListSolutionsInput = z.object({
+    includeManaged: z.boolean().optional().default(false),
+    nameFilter: z.string().optional(),
+    top: z.number().int().min(1).max(200).optional().default(50),
+});
+const SolutionComponentsInput = z.object({
+    solutionName: z.string().min(1).describe('Unique name of the solution (not the display name)'),
+    componentType: z
+        .number()
+        .int()
+        .optional()
+        .describe('Filter by Dataverse component type code (1=Entity, 29=Workflow, 97=WebResource, 90=PluginAssembly, etc.). Omit for all types.'),
+    top: z.number().int().min(1).max(5000).default(200).optional(),
+});
+const PublishCustomizationsInput = z.object({
+    components: z
+        .object({
+        entities: z.array(z.string()).optional().describe('Entity logical names to publish'),
+        webResources: z.array(z.string()).optional().describe('Web resource names to publish'),
+        optionSets: z.array(z.string()).optional().describe('Global OptionSet names to publish'),
+    })
+        .optional()
+        .describe('Specific components to publish. If omitted, ALL unpublished customizations are published.'),
+});
+export const solutionTools = [
+    {
+        name: 'dataverse_list_solutions',
+        description: 'Lists Dataverse solutions in the environment. By default returns only unmanaged solutions. Set includeManaged=true to include managed (imported) solutions. Use nameFilter to search by unique name.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                includeManaged: {
+                    type: 'boolean',
+                    description: 'Include managed (imported) solutions. Default: false',
+                },
+                nameFilter: {
+                    type: 'string',
+                    description: 'Filter solutions by unique name (contains match)',
+                },
+                top: {
+                    type: 'number',
+                    description: 'Maximum number of solutions to return (default 50, max 200)',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'dataverse_solution_components',
+        description: 'Lists all components in a named Dataverse solution (entities, attributes, workflows, web resources, plugins, etc.). Use the unique solution name (not display name). Optionally filter by component type code (1=Entity, 29=Workflow, 97=WebResource, 90=PluginAssembly).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                solutionName: { type: 'string', description: 'Unique name of the solution' },
+                componentType: { type: 'number', description: 'Filter by component type code' },
+                top: { type: 'number', description: 'Max results (default 200, max 5000)' },
+            },
+            required: ['solutionName'],
+        },
+    },
+    {
+        name: 'dataverse_publish_customizations',
+        description: 'Publishes unpublished Dataverse customizations. Without parameters, publishes ALL pending customizations (equivalent to clicking "Publish All" in Power Apps maker portal). Optionally specify entities, webResources, or optionSets to publish only those components. WARNING: Publishing all can take 30-120 seconds in large environments.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                components: {
+                    type: 'object',
+                    description: 'Specific components. Omit to publish all.',
+                    properties: {
+                        entities: { type: 'array', items: { type: 'string' } },
+                        webResources: { type: 'array', items: { type: 'string' } },
+                        optionSets: { type: 'array', items: { type: 'string' } },
+                    },
+                },
+            },
+            required: [],
+        },
+    },
+];
+export async function handleSolutionTool(name, args, client) {
+    switch (name) {
+        case 'dataverse_list_solutions': {
+            const params = ListSolutionsInput.parse(args ?? {});
+            const filterParts = ['isvisible eq true'];
+            if (!params.includeManaged) {
+                filterParts.push('ismanaged eq false');
+            }
+            if (params.nameFilter) {
+                filterParts.push(`contains(uniquename,'${params.nameFilter.replace(/'/g, "''")}')`);
+            }
+            const result = await client.query('solutions', {
+                select: ['solutionid', 'uniquename', 'friendlyname', 'version', 'ismanaged', 'installedon'],
+                filter: filterParts.join(' and '),
+                expand: 'publisherid($select=friendlyname)',
+                orderby: 'friendlyname asc',
+                top: params.top,
+            });
+            const solutions = (result.value ?? []).map(s => ({
+                solutionId: s['solutionid'],
+                uniqueName: s['uniquename'],
+                friendlyName: s['friendlyname'],
+                version: s['version'],
+                isManaged: s['ismanaged'],
+                installedOn: s['installedon'],
+                publisher: s['publisherid']?.['friendlyname'] ?? null,
+            }));
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ solutions, count: solutions.length }, null, 2),
+                    }],
+            };
+        }
+        case 'dataverse_solution_components': {
+            const { solutionName, componentType, top = 200 } = SolutionComponentsInput.parse(args);
+            const result = await client.getSolutionComponents(solutionName, componentType, top);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        case 'dataverse_publish_customizations': {
+            const { components } = PublishCustomizationsInput.parse(args ?? {});
+            const result = await client.publishCustomizations(components);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        default:
+            throw new Error(`Unknown solution tool: ${name}`);
+    }
+}
+//# sourceMappingURL=solution.tools.js.map

package/dist/tools/solution.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solution.tools.js","sourceRoot":"","sources":["../../src/tools/solution.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7D,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IAC9F,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CACP,+HAA+H,CAChI;IACH,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACpF,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACtF,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;KACzF,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,2FAA2F,CAC5F;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACT,sMAAsM;QACxM,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,cAAc,EAAE;oBACd,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,sDAAsD;iBACpE;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kDAAkD;iBAChE;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6DAA6D;iBAC3E;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EACT,2QAA2Q;QAC7Q,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;gBAC5E,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;gBAC/E,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;aAC5E;YACD,QAAQ,EAAE,CAAC,cAAc,CAAC;SAC3B;KACF;IACD;QACE,IAAI,EAAE,kCAAkC;QACxC,WAAW,EACT,+UAA+U;QACjV,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2CAA2C;oBACxD,UAAU,EAAE;wBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;wBACtD,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;wBAC1D,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;qBACzD;iBACF;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,IAAa,EACb,MAA+B;IAE/B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,0BAA0B,CAAC,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAEpD,MAAM,WAAW,GAAa,CAAC,mBAAmB,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC3B,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACzC,CAAC;YACD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,WAAW,CAAC,IAAI,CACd,wBAAwB,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAClE,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAA0B,WAAW,EAAE;gBACtE,MAAM,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC;gBAC3F,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;gBACjC,MAAM,EAAE,mCAAmC;gBAC3C,OAAO,EAAE,kBAAkB;gBAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;aAChB,CAAC,CAAC;YAEH,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC/C,UAAU,EAAE,CAAC,CAAC,YAAY,CAAC;gBAC3B,UAAU,EAAE,CAAC,CAAC,YAAY,CAAC;gBAC3B,YAAY,EAAE,CAAC,CAAC,cAAc,CAAC;gBAC/B,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;gBACrB,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC;gBACzB,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC;gBAC7B,SAAS,EAAG,CAAC,CAAC,aAAa,CAAoC,EAAE,CAAC,cAAc,CAAC,IAAI,IAAI;aAC1F,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtE,CAAC;aACH,CAAC;QACJ,CAAC;QACD,KAAK,+BAA+B,CAAC,CAAC,CAAC;YACrC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,YAAY,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;YACpF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QACD,KAAK,kCAAkC,CAAC,CAAC,CAAC;YACxC,MAAM,EAAE,UAAU,EAAE,GAAG,0BAA0B,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAC9D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/tools/teams.tools.d.ts

@@ -0,0 +1,27 @@
+import type { DataverseAdvancedClient } from '../dataverse/dataverse-client-advanced.js';
+export declare const teamTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            top: {
+                type: string;
+                description: string;
+            };
+            teamType: {
+                type: string;
+                enum: number[];
+                description: string;
+            };
+        };
+        required: never[];
+    };
+}[];
+export declare function handleTeamTool(name: string, args: unknown, client: DataverseAdvancedClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=teams.tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"teams.tools.d.ts","sourceRoot":"","sources":["../../src/tools/teams.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAczF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;GAsBrB,CAAC;AAEF,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAqC7D"}

package/dist/tools/teams.tools.js

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+const TEAM_TYPE_LABELS = {
+    0: 'Owner',
+    1: 'Access',
+    2: 'Office',
+    3: 'Security',
+};
+const ListTeamsInput = z.object({
+    top: z.number().int().positive().max(200).optional().default(50),
+    teamType: z.union([z.literal(0), z.literal(1), z.literal(2), z.literal(3)]).optional(),
+});
+export const teamTools = [
+    {
+        name: 'dataverse_list_teams',
+        description: 'Lists Dataverse teams in the environment. Useful for finding team owners for record assignment and sharing. ' +
+            'teamtype: 0=Owner, 1=Access, 2=AAD Office Group, 3=AAD Security Group.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                top: {
+                    type: 'number',
+                    description: 'Maximum number of teams to return (1–200, default 50)',
+                },
+                teamType: {
+                    type: 'number',
+                    enum: [0, 1, 2, 3],
+                    description: 'Filter by team type: 0=Owner, 1=Access, 2=Office Group, 3=Security Group',
+                },
+            },
+            required: [],
+        },
+    },
+];
+export async function handleTeamTool(name, args, client) {
+    switch (name) {
+        case 'dataverse_list_teams': {
+            const { top, teamType } = ListTeamsInput.parse(args);
+            const select = [
+                'teamid',
+                'name',
+                'teamtype',
+                'description',
+                'isdefault',
+                'createdon',
+                '_businessunitid_value',
+            ];
+            const queryOptions = { select, top, orderby: 'name asc' };
+            if (teamType !== undefined) {
+                queryOptions.filter = `teamtype eq ${teamType}`;
+            }
+            const result = await client.query('teams', queryOptions);
+            const teams = result.value.map(team => ({
+                ...team,
+                teamTypeName: TEAM_TYPE_LABELS[team['teamtype']] ?? 'Unknown',
+            }));
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ teams, count: teams.length }, null, 2),
+                    }],
+            };
+        }
+        default:
+            throw new Error(`Unknown team tool: ${name}`);
+    }
+}
+//# sourceMappingURL=teams.tools.js.map

package/dist/tools/teams.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams.tools.js","sourceRoot":"","sources":["../../src/tools/teams.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,gBAAgB,GAA2B;IAC/C,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,UAAU;CACd,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAChE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,8GAA8G;YAC9G,wEAAwE;QAC1E,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uDAAuD;iBACrE;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBAClB,WAAW,EAAE,0EAA0E;iBACxF;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAAa,EACb,MAA+B;IAE/B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG;gBACb,QAAQ;gBACR,MAAM;gBACN,UAAU;gBACV,aAAa;gBACb,WAAW;gBACX,WAAW;gBACX,uBAAuB;aACxB,CAAC;YACF,MAAM,YAAY,GAKd,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;YACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,YAAY,CAAC,MAAM,GAAG,eAAe,QAAQ,EAAE,CAAC;YAClD,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAA0B,OAAO,EAAE,YAAY,CAAC,CAAC;YAClF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtC,GAAG,IAAI;gBACP,YAAY,EAAE,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAW,CAAC,IAAI,SAAS;aACxE,CAAC,CAAC,CAAC;YACJ,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC9D,CAAC;aACH,CAAC;QACJ,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/tools/trace.tools.d.ts

@@ -0,0 +1,63 @@
+import type { DataverseAdvancedClient } from '../dataverse/dataverse-client-advanced.js';
+export declare const traceTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            top: {
+                type: string;
+                description: string;
+            };
+            pluginTypeFilter: {
+                type: string;
+                description: string;
+            };
+            messageFilter: {
+                type: string;
+                description: string;
+            };
+            entityFilter: {
+                type: string;
+                description: string;
+            };
+            exceptionsOnly: {
+                type: string;
+                description: string;
+            };
+            failedOnly?: never;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            top: {
+                type: string;
+                description: string;
+            };
+            failedOnly: {
+                type: string;
+                description: string;
+            };
+            entityFilter: {
+                type: string;
+                description: string;
+            };
+            pluginTypeFilter?: never;
+            messageFilter?: never;
+            exceptionsOnly?: never;
+        };
+        required: never[];
+    };
+})[];
+export declare function handleTraceTool(name: string, args: unknown, client: DataverseAdvancedClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=trace.tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.tools.d.ts","sourceRoot":"","sources":["../../src/tools/trace.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AA2DzF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuDtB,CAAC;AAwBF,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA8G7D"}

package/dist/tools/trace.tools.js

@@ -0,0 +1,218 @@
+import { z } from 'zod';
+const OPERATION_TYPE_NAMES = {
+    0: 'Execute',
+    1: 'Create',
+    2: 'Retrieve',
+    3: 'RetrieveMultiple',
+    4: 'GetParent',
+    5: 'Update',
+    6: 'Delete',
+    7: 'Assign',
+};
+const STATUS_CODE_NAMES = {
+    0: 'Waiting',
+    10: 'WaitingForResources',
+    20: 'InProgress',
+    21: 'Pausing',
+    22: 'Canceling',
+    30: 'Succeeded',
+    31: 'Failed',
+    32: 'Canceled',
+};
+const STATE_CODE_NAMES = {
+    0: 'ReadyToRun',
+    1: 'Suspended',
+    2: 'Locked',
+    3: 'Completed',
+};
+const PLUGIN_TRACE_SELECT = [
+    'plugintracelogid',
+    'typename',
+    'messagename',
+    'primaryentity',
+    'depth',
+    'operationtype',
+    'exceptiondetails',
+    'messageblock',
+    'createdon',
+    'performanceexecutionduration',
+    'correlationid',
+    'requestid',
+];
+const WORKFLOW_TRACE_SELECT = [
+    'asyncoperationid',
+    'name',
+    'operationtype',
+    'statuscode',
+    'statecode',
+    'message',
+    'createdon',
+    'startedon',
+    'completedon',
+    'regardingobjecttypecode',
+];
+export const traceTools = [
+    {
+        name: 'dataverse_get_plugin_trace_logs',
+        description: "Retrieves recent plugin and custom workflow activity trace logs from Dataverse. Shows execution details including plugin type name, triggering message, entity, execution duration, trace messages written by the developer, and exception details if the plugin failed. Requires the Plugin Trace Log feature to be enabled in Dataverse settings (Settings > Administration > System Settings > Customization tab > 'Enable logging to plugin trace log'). Essential for debugging plugin failures in production.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                top: {
+                    type: 'number',
+                    description: 'Max records to return (default 50, max 200)',
+                },
+                pluginTypeFilter: {
+                    type: 'string',
+                    description: "Filter by plugin type name (substring match, e.g. 'AccountValidation')",
+                },
+                messageFilter: {
+                    type: 'string',
+                    description: "Filter by message name (e.g. 'Create', 'Update')",
+                },
+                entityFilter: {
+                    type: 'string',
+                    description: "Filter by entity logical name (e.g. 'account')",
+                },
+                exceptionsOnly: {
+                    type: 'boolean',
+                    description: 'Return only traces where an exception occurred (default false)',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'dataverse_get_workflow_trace_logs',
+        description: 'Retrieves background workflow (Power Automate classic / legacy workflow engine) execution records from Dataverse. These are the AsyncOperation records for workflow-type operations, useful for diagnosing failures in background workflows and real-time workflows running asynchronously. Note: For modern cloud flows (Power Automate), use the Power Automate portal instead.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                top: {
+                    type: 'number',
+                    description: 'Max records (default 50, max 200)',
+                },
+                failedOnly: {
+                    type: 'boolean',
+                    description: 'Return only failed workflows (statuscode eq 31, default false)',
+                },
+                entityFilter: {
+                    type: 'string',
+                    description: "Filter by regarding entity type (e.g. 'account')",
+                },
+            },
+            required: [],
+        },
+    },
+];
+const GetPluginTraceInput = z.object({
+    top: z.number().int().positive().max(200).optional().default(50),
+    pluginTypeFilter: z.string().optional(),
+    messageFilter: z.string().optional(),
+    entityFilter: z.string().optional(),
+    exceptionsOnly: z.boolean().optional().default(false),
+});
+const GetWorkflowTraceInput = z.object({
+    top: z.number().int().positive().max(200).optional().default(50),
+    failedOnly: z.boolean().optional().default(false),
+    entityFilter: z.string().optional(),
+});
+function str(val) {
+    return typeof val === 'string' ? val : '';
+}
+function numOrNull(val) {
+    return typeof val === 'number' ? val : null;
+}
+export async function handleTraceTool(name, args, client) {
+    switch (name) {
+        case 'dataverse_get_plugin_trace_logs': {
+            const params = GetPluginTraceInput.parse(args);
+            const filterParts = [];
+            if (params.pluginTypeFilter) {
+                filterParts.push(`contains(typename,'${params.pluginTypeFilter.replace(/'/g, "''")}')`);
+            }
+            if (params.messageFilter) {
+                filterParts.push(`messagename eq '${params.messageFilter.replace(/'/g, "''")}'`);
+            }
+            if (params.entityFilter) {
+                filterParts.push(`primaryentity eq '${params.entityFilter.replace(/'/g, "''")}'`);
+            }
+            if (params.exceptionsOnly) {
+                filterParts.push('exceptiondetails ne null');
+            }
+            const filter = filterParts.length > 0 ? filterParts.join(' and ') : undefined;
+            const response = await client.query('plugintracelog', {
+                select: PLUGIN_TRACE_SELECT,
+                orderby: 'createdon desc',
+                top: params.top,
+                ...(filter !== undefined ? { filter } : {}),
+            });
+            const rows = (response.value ?? []);
+            const logs = rows.map((row) => {
+                const opType = typeof row['operationtype'] === 'number' ? row['operationtype'] : 0;
+                const exceptionDetails = row['exceptiondetails'];
+                return {
+                    id: str(row['plugintracelogid']),
+                    typeName: str(row['typename']),
+                    message: str(row['messagename']),
+                    entity: str(row['primaryentity']),
+                    depth: typeof row['depth'] === 'number' ? row['depth'] : 0,
+                    operationType: opType,
+                    operationTypeName: OPERATION_TYPE_NAMES[opType] ?? String(opType),
+                    createdOn: str(row['createdon']),
+                    durationMs: numOrNull(row['performanceexecutionduration']),
+                    correlationId: str(row['correlationid']),
+                    requestId: str(row['requestid']),
+                    hasException: exceptionDetails != null && exceptionDetails !== '',
+                    exceptionDetails: typeof exceptionDetails === 'string' ? exceptionDetails : null,
+                    messageBlock: typeof row['messageblock'] === 'string' ? row['messageblock'] : null,
+                };
+            });
+            const result = { total: logs.length, logs };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        case 'dataverse_get_workflow_trace_logs': {
+            const params = GetWorkflowTraceInput.parse(args);
+            const filterParts = ['operationtype eq 10'];
+            if (params.failedOnly) {
+                filterParts.push('statuscode eq 31');
+            }
+            if (params.entityFilter) {
+                filterParts.push(`regardingobjecttypecode eq '${params.entityFilter.replace(/'/g, "''")}'`);
+            }
+            const filter = filterParts.join(' and ');
+            const response = await client.query('asyncoperations', {
+                select: WORKFLOW_TRACE_SELECT,
+                filter,
+                orderby: 'createdon desc',
+                top: params.top,
+            });
+            const rows = (response.value ?? []);
+            const workflows = rows.map((row) => {
+                const statusCode = typeof row['statuscode'] === 'number' ? row['statuscode'] : 0;
+                const stateCode = typeof row['statecode'] === 'number' ? row['statecode'] : 0;
+                const errorMsg = row['message'];
+                return {
+                    id: str(row['asyncoperationid']),
+                    name: str(row['name']),
+                    statusCode,
+                    statusName: STATUS_CODE_NAMES[statusCode] ?? String(statusCode),
+                    stateCode,
+                    stateName: STATE_CODE_NAMES[stateCode] ?? String(stateCode),
+                    createdOn: str(row['createdon']),
+                    startedOn: typeof row['startedon'] === 'string' ? row['startedon'] : null,
+                    completedOn: typeof row['completedon'] === 'string' ? row['completedon'] : null,
+                    regardingEntityType: typeof row['regardingobjecttypecode'] === 'string'
+                        ? row['regardingobjecttypecode']
+                        : null,
+                    errorMessage: typeof errorMsg === 'string' ? errorMsg : null,
+                };
+            });
+            const result = { total: workflows.length, workflows };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        default:
+            throw new Error(`Unknown trace tool: ${name}`);
+    }
+}
+//# sourceMappingURL=trace.tools.js.map

package/dist/tools/trace.tools.js.map

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

package/dist/tools/tracking.tools.d.ts

@@ -0,0 +1,35 @@
+import type { DataverseAdvancedClient } from '../dataverse/dataverse-client-advanced.js';
+export declare const trackingTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            entitySetName: {
+                type: string;
+                description: string;
+            };
+            deltaToken: {
+                anyOf: {
+                    type: string;
+                }[];
+                description: string;
+            };
+            select: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+export declare function handleTrackingTool(name: string, args: unknown, client: DataverseAdvancedClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=tracking.tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.tools.d.ts","sourceRoot":"","sources":["../../src/tools/tracking.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEzF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;GAyBzB,CAAC;AAQF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAO7D"}

package/dist/tools/tracking.tools.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+export const trackingTools = [
+    {
+        name: 'dataverse_change_detection',
+        description: 'Detects new, modified, and deleted records since a previous sync using Dataverse change tracking (delta queries). On first call, pass deltaToken=null to get an initial snapshot and receive a token. On subsequent calls, pass the returned token to retrieve only changes since last sync. Change tracking must be enabled on the table in Dataverse settings. Returns newAndModified records, deleted record IDs, and the nextDeltaToken for the next call.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                entitySetName: {
+                    type: 'string',
+                    description: 'OData entity set name (e.g., "accounts")',
+                },
+                deltaToken: {
+                    anyOf: [{ type: 'string' }, { type: 'null' }],
+                    description: 'Delta token from a previous call, or null for the initial sync',
+                },
+                select: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Columns to return (recommended to minimise payload)',
+                },
+            },
+            required: ['entitySetName', 'deltaToken'],
+        },
+    },
+];
+const ChangeDetectionInput = z.object({
+    entitySetName: z.string().min(1),
+    deltaToken: z.string().nullable(),
+    select: z.array(z.string()).optional(),
+});
+export async function handleTrackingTool(name, args, client) {
+    if (name === 'dataverse_change_detection') {
+        const { entitySetName, deltaToken, select } = ChangeDetectionInput.parse(args);
+        const result = await client.getChangedRecords(entitySetName, deltaToken, select);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    throw new Error(`Unknown tracking tool: ${name}`);
+}
+//# sourceMappingURL=tracking.tools.js.map

package/dist/tools/tracking.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.tools.js","sourceRoot":"","sources":["../../src/tools/tracking.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACT,gcAAgc;QAClc,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,aAAa,EAAE;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0CAA0C;iBACxD;gBACD,UAAU,EAAE;oBACV,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBAC7C,WAAW,EAAE,gEAAgE;iBAC9E;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,qDAAqD;iBACnE;aACF;YACD,QAAQ,EAAE,CAAC,eAAe,EAAE,YAAY,CAAC;SAC1C;KACF;CACF,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,IAAa,EACb,MAA+B;IAE/B,IAAI,IAAI,KAAK,4BAA4B,EAAE,CAAC;QAC1C,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC"}