mcp-dataverse 0.1.0

package/dist/tools/actions.tools.js

@@ -0,0 +1,179 @@
+import { z } from 'zod';
+export const actionTools = [
+    {
+        name: 'dataverse_execute_action',
+        description: 'Executes a global (unbound) Dataverse action that is not tied to a specific record — for example WinOpportunity, SendEmail, or custom process actions. Use dataverse_execute_bound_action when the action must operate on a particular record. Actions differ from functions in that they are state-changing operations; for read-only operations use dataverse_execute_function.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                actionName: { type: 'string', description: 'Action logical name (e.g., "WinOpportunity")' },
+                parameters: { type: 'object', description: 'Action parameters' },
+            },
+            required: ['actionName'],
+        },
+    },
+    {
+        name: 'dataverse_execute_function',
+        description: 'Executes a global (unbound) Dataverse OData function that is read-only and returns data without side effects — for example RetrieveTotalRecordCount or InitializeFrom. Use dataverse_execute_action for state-changing operations. Use dataverse_execute_bound_action when the function/action requires a specific record context.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                functionName: {
+                    type: 'string',
+                    description: 'Function name (e.g., "WhoAmI", "RetrieveTotalRecordCount")',
+                },
+                parameters: { type: 'object', description: 'Function parameters as string key-value pairs' },
+            },
+            required: ['functionName'],
+        },
+    },
+    {
+        name: 'dataverse_execute_bound_action',
+        description: 'Executes a Dataverse action bound to a specific record instance, passing the entity set name and record GUID as context (e.g., QualifyLead on a lead, or a custom action scoped to an account). The actionName should not include the Microsoft.Dynamics.CRM namespace prefix. Use dataverse_execute_action for global unbound actions that do not require a record context.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                entitySetName: { type: 'string' },
+                id: { type: 'string', description: 'Record GUID' },
+                actionName: { type: 'string', description: 'Action name (without Microsoft.Dynamics.CRM prefix)' },
+                parameters: { type: 'object', description: 'Action parameters' },
+            },
+            required: ['entitySetName', 'id', 'actionName'],
+        },
+    },
+    {
+        name: 'dataverse_retrieve_dependencies_for_delete',
+        description: 'Checks what solution components would block deletion of a specific component. Provide the Dataverse component type code (1=Entity, 2=Attribute, 26=SavedQuery, 29=Workflow, 92=PluginAssembly) and the component GUID. Use before deleting shared Dataverse customization components.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                componentType: {
+                    type: 'number',
+                    description: 'Dataverse component type code (1=Entity, 2=Attribute, 29=Workflow, 92=PluginAssembly)',
+                },
+                objectId: { type: 'string', description: 'Component GUID' },
+            },
+            required: ['componentType', 'objectId'],
+        },
+    },
+    {
+        name: 'dataverse_execute_bound_function',
+        description: 'Executes a Dataverse function bound to a specific record (e.g., CalculateRollupField, GetQuantityAvailable). Use for read-only computed operations on a single record. Unlike bound actions, bound functions do not modify data.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                entitySetName: { type: 'string', description: 'OData entity set name of the table (e.g., "accounts")' },
+                id: { type: 'string', description: 'GUID of the record' },
+                functionName: { type: 'string', description: 'Name of the bound function (e.g., "CalculateRollupField")' },
+                parameters: {
+                    type: 'object',
+                    description: 'Function parameters as key-value pairs of strings',
+                    additionalProperties: { type: 'string' },
+                },
+            },
+            required: ['entitySetName', 'id', 'functionName'],
+        },
+    },
+    {
+        name: 'dataverse_list_dependencies',
+        description: 'Lists workflows, Power Automate flows, Business Rules, and custom actions that reference a given table. Use to detect hidden dependencies before modifying or removing a table. Returns component name, type, state (Active/Draft), trigger event (Create/Update/Delete), and count.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tableName: {
+                    type: 'string',
+                    description: 'Logical name of the table to check (e.g., "account", "contact")',
+                },
+                componentType: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: ['Workflow', 'Flow', 'BusinessRule', 'Action', 'BusinessProcessFlow', 'Plugin', 'CustomAPI'],
+                    },
+                    description: 'Filter by component type. Default: all types.',
+                },
+            },
+            required: ['tableName'],
+        },
+    },
+];
+/** Allow only identifier-safe names: letters, digits, underscores, dots (for namespace prefixes). */
+const SAFE_API_NAME = /^[a-zA-Z0-9_.]+$/;
+const ExecuteActionInput = z.object({
+    actionName: z
+        .string()
+        .min(1)
+        .regex(SAFE_API_NAME, 'actionName must contain only letters, digits, underscores, or dots'),
+    parameters: z.record(z.unknown()).optional().default({}),
+});
+const ExecuteFunctionInput = z.object({
+    functionName: z
+        .string()
+        .min(1)
+        .regex(SAFE_API_NAME, 'functionName must contain only letters, digits, underscores, or dots'),
+    parameters: z.record(z.string()).optional().default({}),
+});
+const ExecuteBoundActionInput = z.object({
+    entitySetName: z.string().min(1),
+    id: z.string().uuid(),
+    actionName: z
+        .string()
+        .min(1)
+        .regex(SAFE_API_NAME, 'actionName must contain only letters, digits, underscores, or dots'),
+    parameters: z.record(z.unknown()).optional().default({}),
+});
+const RetrieveDependenciesForDeleteInput = z.object({
+    componentType: z.number().int().positive(),
+    objectId: z.string().uuid(),
+});
+const VALID_COMPONENT_TYPES = ['Workflow', 'Flow', 'BusinessRule', 'Action', 'BusinessProcessFlow', 'Plugin', 'CustomAPI'];
+const ListTableDependenciesInput = z.object({
+    tableName: z.string().min(1),
+    componentType: z.array(z.enum(VALID_COMPONENT_TYPES)).optional(),
+});
+const ExecuteBoundFunctionInput = z.object({
+    entitySetName: z.string().min(1),
+    id: z.string().uuid(),
+    functionName: z
+        .string()
+        .min(1)
+        .regex(SAFE_API_NAME, 'functionName must contain only letters, digits, underscores, or dots'),
+    parameters: z.record(z.string()).optional().default({}),
+});
+export async function handleActionTool(name, args, client) {
+    switch (name) {
+        case 'dataverse_execute_action': {
+            const { actionName, parameters } = ExecuteActionInput.parse(args);
+            const result = await client.executeAction(actionName, parameters);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        case 'dataverse_execute_function': {
+            const { functionName, parameters } = ExecuteFunctionInput.parse(args);
+            const result = await client.executeFunction(functionName, parameters);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        case 'dataverse_execute_bound_action': {
+            const { entitySetName, id, actionName, parameters } = ExecuteBoundActionInput.parse(args);
+            const result = await client.executeBoundAction(entitySetName, id, actionName, parameters);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        case 'dataverse_list_dependencies': {
+            const { tableName, componentType } = ListTableDependenciesInput.parse(args);
+            const result = await client.listTableDependencies(tableName, componentType);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        case 'dataverse_retrieve_dependencies_for_delete': {
+            const { componentType, objectId } = RetrieveDependenciesForDeleteInput.parse(args);
+            const result = await client.listDependencies(componentType, objectId);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        case 'dataverse_execute_bound_function': {
+            const { entitySetName, id, functionName, parameters } = ExecuteBoundFunctionInput.parse(args);
+            const result = await client.executeBoundFunction(entitySetName, id, functionName, parameters);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        default:
+            throw new Error(`Unknown action tool: ${name}`);
+    }
+}
+//# sourceMappingURL=actions.tools.js.map

package/dist/tools/actions.tools.js.map

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

package/dist/tools/annotations.tools.d.ts

@@ -0,0 +1,82 @@
+import type { DataverseAdvancedClient } from '../dataverse/dataverse-client-advanced.js';
+export declare const annotationTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            recordId: {
+                type: string;
+                description: string;
+            };
+            includeContent: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            top: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            mimeTypeFilter: {
+                type: string;
+                description: string;
+            };
+            entitySetName?: never;
+            notetext?: never;
+            subject?: never;
+            filename?: never;
+            mimetype?: never;
+            documentbody?: never;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            recordId: {
+                type: string;
+                description: string;
+            };
+            entitySetName: {
+                type: string;
+                description: string;
+            };
+            notetext: {
+                type: string;
+                description: string;
+            };
+            subject: {
+                type: string;
+                description: string;
+            };
+            filename: {
+                type: string;
+                description: string;
+            };
+            mimetype: {
+                type: string;
+                description: string;
+            };
+            documentbody: {
+                type: string;
+                description: string;
+            };
+            includeContent?: never;
+            top?: never;
+            mimeTypeFilter?: never;
+        };
+        required: string[];
+    };
+})[];
+export declare function handleAnnotationTool(name: string, args: unknown, client: DataverseAdvancedClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=annotations.tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.tools.d.ts","sourceRoot":"","sources":["../../src/tools/annotations.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAsBzF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuE3B,CAAC;AAEF,wBAAsB,oBAAoB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,uBAAuB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAmH7D"}

package/dist/tools/annotations.tools.js

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+const GetAnnotationsInput = z.object({
+    recordId: z.string().uuid(),
+    includeContent: z.boolean().optional().default(false),
+    top: z.number().int().positive().max(100).optional().default(20),
+    mimeTypeFilter: z.string().optional(),
+});
+const CreateAnnotationInput = z.object({
+    recordId: z.string().uuid(),
+    entitySetName: z.string().min(1),
+    notetext: z.string().optional(),
+    subject: z.string().optional(),
+    filename: z.string().optional(),
+    mimetype: z.string().optional(),
+    documentbody: z.string().optional(),
+}).refine(data => Boolean(data.notetext) || Boolean(data.documentbody), { message: 'At least one of notetext or documentbody is required' });
+export const annotationTools = [
+    {
+        name: 'dataverse_get_annotations',
+        description: 'Retrieves notes and file attachments (annotations) linked to a Dataverse record. Returns note text, file metadata (name, size, MIME type), owner, and timestamps. Set includeContent=true to also retrieve base64 file content (warning: can be very large).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                recordId: {
+                    type: 'string',
+                    description: "The parent record's GUID",
+                },
+                includeContent: {
+                    type: 'boolean',
+                    description: 'If true, include documentbody (base64). WARNING: can be very large.',
+                    default: false,
+                },
+                top: {
+                    type: 'number',
+                    description: 'Maximum number of annotations to return (default 20, max 100)',
+                    default: 20,
+                },
+                mimeTypeFilter: {
+                    type: 'string',
+                    description: 'Filter by MIME type (e.g. "application/pdf")',
+                },
+            },
+            required: ['recordId'],
+        },
+    },
+    {
+        name: 'dataverse_create_annotation',
+        description: 'Creates a note or file attachment (annotation) linked to a Dataverse record. Provide notetext for a text note, documentbody (base64) for a file attachment, or both. The parent record is identified by entitySetName and recordId.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                recordId: {
+                    type: 'string',
+                    description: "The parent record's GUID",
+                },
+                entitySetName: {
+                    type: 'string',
+                    description: 'The OData entity set name of the parent record (e.g., "accounts", "contacts")',
+                },
+                notetext: {
+                    type: 'string',
+                    description: 'Text content of the note',
+                },
+                subject: {
+                    type: 'string',
+                    description: 'Subject/title of the note',
+                },
+                filename: {
+                    type: 'string',
+                    description: 'File name (required when attaching a file)',
+                },
+                mimetype: {
+                    type: 'string',
+                    description: 'MIME type of the file (e.g., "application/pdf")',
+                },
+                documentbody: {
+                    type: 'string',
+                    description: 'Base64-encoded file content',
+                },
+            },
+            required: ['recordId', 'entitySetName'],
+        },
+    },
+];
+export async function handleAnnotationTool(name, args, client) {
+    switch (name) {
+        case 'dataverse_get_annotations': {
+            const params = GetAnnotationsInput.parse(args);
+            const selectFields = [
+                'annotationid',
+                'subject',
+                'notetext',
+                'filename',
+                'filesize',
+                'mimetype',
+                'isdocument',
+                'createdon',
+                'modifiedon',
+            ];
+            if (params.includeContent) {
+                selectFields.push('documentbody');
+            }
+            const filterParts = [`_objectid_value eq ${params.recordId}`];
+            if (params.mimeTypeFilter) {
+                filterParts.push(`mimetype eq '${params.mimeTypeFilter.replace(/'/g, "''")}'`);
+            }
+            const response = await client.query('annotations', {
+                select: selectFields,
+                filter: filterParts.join(' and '),
+                expand: 'ownerid($select=name)',
+                orderby: 'createdon desc',
+                top: params.top,
+            });
+            const rows = (response.value ?? []);
+            const annotations = rows.map((row) => {
+                const result = {
+                    id: row['annotationid'] ?? '',
+                    subject: row['subject'] ?? null,
+                    noteText: row['notetext'] ?? null,
+                    isDocument: row['isdocument'] === true,
+                    createdOn: row['createdon'] ?? '',
+                    modifiedOn: row['modifiedon'] ?? '',
+                    owner: row['ownerid']?.['name'] ?? null,
+                };
+                if (row['isdocument'] === true) {
+                    result.fileName = row['filename'] ?? null;
+                    result.fileSize = row['filesize'] ?? null;
+                    result.mimeType = row['mimetype'] ?? null;
+                }
+                if (params.includeContent && row['documentbody']) {
+                    result.documentBody = row['documentbody'];
+                }
+                return result;
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ recordId: params.recordId, annotations, count: annotations.length }, null, 2),
+                    },
+                ],
+            };
+        }
+        case 'dataverse_create_annotation': {
+            const params = CreateAnnotationInput.parse(args);
+            const data = {
+                'objectid@odata.bind': `/${params.entitySetName}(${params.recordId})`,
+            };
+            if (params.notetext !== undefined)
+                data['notetext'] = params.notetext;
+            if (params.subject !== undefined)
+                data['subject'] = params.subject;
+            if (params.filename !== undefined)
+                data['filename'] = params.filename;
+            if (params.mimetype !== undefined)
+                data['mimetype'] = params.mimetype;
+            if (params.documentbody !== undefined) {
+                data['documentbody'] = params.documentbody;
+                data['isdocument'] = true;
+            }
+            const annotationId = await client.createRecord('annotations', data);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            created: true,
+                            annotationId,
+                            parentRecordId: params.recordId,
+                            entitySetName: params.entitySetName,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`Unknown annotation tool: ${name}`);
+    }
+}
+//# sourceMappingURL=annotations.tools.js.map

package/dist/tools/annotations.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.tools.js","sourceRoot":"","sources":["../../src/tools/annotations.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACrD,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,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC,MAAM,CACL,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAC5D,EAAE,OAAO,EAAE,sDAAsD,EAAE,CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B;QACI,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACP,8PAA8P;QAClQ,WAAW,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACR,QAAQ,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBAC1C;gBACD,cAAc,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EACP,qEAAqE;oBACzE,OAAO,EAAE,KAAK;iBACjB;gBACD,GAAG,EAAE;oBACD,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+DAA+D;oBAC5E,OAAO,EAAE,EAAE;iBACd;gBACD,cAAc,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC9D;aACJ;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACzB;KACJ;IACD;QACI,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACP,qOAAqO;QACzO,WAAW,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACR,QAAQ,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBAC1C;gBACD,aAAa,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EACP,+EAA+E;iBACtF;gBACD,QAAQ,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBAC1C;gBACD,OAAO,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;iBAC3C;gBACD,QAAQ,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC5D;gBACD,QAAQ,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iDAAiD;iBACjE;gBACD,YAAY,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6BAA6B;iBAC7C;aACJ;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC;SAC1C;KACJ;CACJ,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,IAAY,EACZ,IAAa,EACb,MAA+B;IAE/B,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,2BAA2B,CAAC,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAE/C,MAAM,YAAY,GAAG;gBACjB,cAAc;gBACd,SAAS;gBACT,UAAU;gBACV,UAAU;gBACV,UAAU;gBACV,UAAU;gBACV,YAAY;gBACZ,WAAW;gBACX,YAAY;aACf,CAAC;YACF,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACtC,CAAC;YAED,MAAM,WAAW,GAAG,CAAC,sBAAsB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9D,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,WAAW,CAAC,IAAI,CACZ,gBAAgB,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAC/D,CAAC;YACN,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAA0B,aAAa,EAAE;gBACxE,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;gBACjC,MAAM,EAAE,uBAAuB;gBAC/B,OAAO,EAAE,gBAAgB;gBACzB,GAAG,EAAE,MAAM,CAAC,GAAG;aAClB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAmC,CAAC;YAEtE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACjC,MAAM,MAAM,GAA4B;oBACpC,EAAE,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;oBAC7B,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI;oBAC/B,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI;oBACjC,UAAU,EAAE,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI;oBACtC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE;oBACjC,UAAU,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE;oBACnC,KAAK,EACA,GAAG,CAAC,SAAS,CAAoC,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI;iBAC3E,CAAC;gBAEF,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC7B,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;oBAC1C,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;oBAC1C,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;gBAC9C,CAAC;gBAED,IAAI,MAAM,CAAC,cAAc,IAAI,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC/C,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC;gBAC9C,CAAC;gBAED,OAAO,MAAM,CAAC;YAClB,CAAC,CAAC,CAAC;YAEH,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,EACrE,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;QAED,KAAK,6BAA6B,CAAC,CAAC,CAAC;YACjC,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEjD,MAAM,IAAI,GAA4B;gBAClC,qBAAqB,EAAE,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,QAAQ,GAAG;aACxE,CAAC;YACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;gBAAE,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;YACtE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;gBAAE,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;YACnE,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;gBAAE,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;YACtE,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;gBAAE,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;YACtE,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACpC,IAAI,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;gBAC3C,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;YAC9B,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YAEpE,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB;4BACI,OAAO,EAAE,IAAI;4BACb,YAAY;4BACZ,cAAc,EAAE,MAAM,CAAC,QAAQ;4BAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;yBACtC,EACD,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;QAED;YACI,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;AACL,CAAC"}

package/dist/tools/audit.tools.d.ts

@@ -0,0 +1,45 @@
+import type { DataverseAdvancedClient } from '../dataverse/dataverse-client-advanced.js';
+export declare const auditTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            recordId: {
+                type: string;
+                description: string;
+            };
+            entityLogicalName: {
+                type: string;
+                description: string;
+            };
+            userId: {
+                type: string;
+                description: string;
+            };
+            fromDate: {
+                type: string;
+                description: string;
+            };
+            top: {
+                type: string;
+                description: string;
+            };
+            operations: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: never[];
+    };
+}[];
+export declare function handleAuditTool(name: string, args: unknown, client: DataverseAdvancedClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=audit.tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.tools.d.ts","sourceRoot":"","sources":["../../src/tools/audit.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAkBzF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCtB,CAAC;AAgEF,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,CA+E7D"}