mcp-dataverse 0.3.7 → 0.3.9

package/dist/tools/trace.tools.js

@@ -1,233 +0,0 @@
-import { z } from "zod";
-import { esc } from "../dataverse/dataverse-client.utils.js";
-import { formatData } from "./output.utils.js";
-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",
-];
-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. WHEN TO USE: Debugging plugin failures or performance issues in production. BEST PRACTICES: Enable Plugin Trace Log in Dataverse settings first; filter by plugin name or entity to narrow results. WORKFLOW: inspect_audit.",
-        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: [],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-    {
-        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. WHEN TO USE: Diagnosing failures in classic/legacy background workflows. BEST PRACTICES: Use failedOnly=true to focus on errors; for modern cloud flows use Power Automate portal. WORKFLOW: inspect_audit.",
-        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: [],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-];
-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,'${esc(params.pluginTypeFilter)}')`);
-            }
-            if (params.messageFilter) {
-                filterParts.push(`messagename eq '${esc(params.messageFilter)}'`);
-            }
-            if (params.entityFilter) {
-                filterParts.push(`primaryentity eq '${esc(params.entityFilter)}'`);
-            }
-            if (params.exceptionsOnly) {
-                filterParts.push("exceptiondetails ne null");
-            }
-            const filter = filterParts.length > 0 ? filterParts.join(" and ") : undefined;
-            const response = await client.query("plugintracelogs", {
-                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 formatData(`${logs.length} plugin trace logs found`, result, [
-                "Filter by plugin name or correlation ID for specific traces",
-            ]);
-        }
-        case "dataverse_get_workflow_trace_logs": {
-            const params = GetWorkflowTraceInput.parse(args);
-            const filterParts = ["operationtype eq 10"];
-            if (params.failedOnly) {
-                filterParts.push("statuscode eq 31");
-            }
-            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,
-                    errorMessage: typeof errorMsg === "string" ? errorMsg : null,
-                };
-            });
-            const result = { total: workflows.length, workflows };
-            return formatData(`${workflows.length} workflow trace logs found`, result, ["Filter by status or entity type for specific workflow traces"]);
-        }
-        default:
-            throw new Error(`Unknown trace tool: ${name}`);
-    }
-}
-//# sourceMappingURL=trace.tools.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,41 +0,0 @@
-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[];
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-}[];
-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

@@ -1 +0,0 @@
-{"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;AAIzF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCzB,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,CAuC7D"}

package/dist/tools/tracking.tools.js

@@ -1,76 +0,0 @@
-import { z } from "zod";
-import { safeEntitySetName } from "./validation.utils.js";
-import { formatData, formatPrerequisiteError } from "./output.utils.js";
-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. WHEN TO USE: Incremental sync — detecting records created, updated, or deleted since a previous snapshot. BEST PRACTICES: Store the deltaToken persistently; always specify $select to minimize payload. WORKFLOW: query_data.",
-        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"],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-];
-const ChangeDetectionInput = z.object({
-    entitySetName: safeEntitySetName,
-    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);
-        let result;
-        try {
-            result = await client.getChangedRecords(entitySetName, deltaToken, select);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (/change.?track|0x80072491/i.test(msg)) {
-                return formatPrerequisiteError({
-                    type: "feature_disabled",
-                    feature: "Change Tracking",
-                    cannotProceedBecause: `Change tracking is not enabled on '${entitySetName}', so delta queries cannot be executed.`,
-                    adminPortal: "Power Apps Maker Portal",
-                    steps: [
-                        `Open Power Apps maker portal (make.powerapps.com)`,
-                        `Navigate to Tables → search for '${entitySetName}'`,
-                        `Open the table → click the Settings (gear) icon`,
-                        `Enable "Track changes"`,
-                        `Save the table, then publish customizations`,
-                    ],
-                    fixableViaToolName: "dataverse_update_entity",
-                });
-            }
-            throw err;
-        }
-        const changed = Array.isArray(result?.newAndModified)
-            ? result.newAndModified
-            : [];
-        return formatData(`${changed.length} changed records detected`, result, [
-            "Store the returned deltaToken for subsequent incremental sync",
-        ]);
-    }
-    throw new Error(`Unknown tracking tool: ${name}`);
-}
-//# sourceMappingURL=tracking.tools.js.map

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

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

package/dist/tools/users.tools.d.ts

@@ -1,141 +0,0 @@
-import type { DataverseAdvancedClient } from "../dataverse/dataverse-client-advanced.js";
-export declare const userTools: ({
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            userId: {
-                type: string;
-                description: string;
-            };
-            search?: never;
-            businessUnitId?: never;
-            includeDisabled?: never;
-            includeApplicationUsers?: never;
-            top?: never;
-            nameContains?: never;
-            roleId?: never;
-            confirm?: never;
-        };
-        required: string[];
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            search: {
-                type: string;
-                description: string;
-            };
-            businessUnitId: {
-                type: string;
-                description: string;
-            };
-            includeDisabled: {
-                type: string;
-                description: string;
-            };
-            includeApplicationUsers: {
-                type: string;
-                description: string;
-            };
-            top: {
-                type: string;
-                description: string;
-            };
-            userId?: never;
-            nameContains?: never;
-            roleId?: never;
-            confirm?: never;
-        };
-        required?: never;
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            nameContains: {
-                type: string;
-                description: string;
-            };
-            businessUnitId: {
-                type: string;
-                description: string;
-            };
-            top: {
-                type: string;
-                description: string;
-            };
-            userId?: never;
-            search?: never;
-            includeDisabled?: never;
-            includeApplicationUsers?: never;
-            roleId?: never;
-            confirm?: never;
-        };
-        required: never[];
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            userId: {
-                type: string;
-                description: string;
-            };
-            roleId: {
-                type: string;
-                description: string;
-            };
-            confirm: {
-                type: string;
-                description: string;
-            };
-            search?: never;
-            businessUnitId?: never;
-            includeDisabled?: never;
-            includeApplicationUsers?: never;
-            top?: never;
-            nameContains?: never;
-        };
-        required: string[];
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-})[];
-export declare function handleUserTool(name: string, args: unknown, client: DataverseAdvancedClient): Promise<{
-    content: Array<{
-        type: "text";
-        text: string;
-    }>;
-}>;
-//# sourceMappingURL=users.tools.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"users.tools.d.ts","sourceRoot":"","sources":["../../src/tools/users.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAsCzF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyJrB,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,CAgN7D"}