mcp-dataverse 0.3.8 → 0.3.9

package/dist/tools/metadata.tools.js

@@ -1,400 +0,0 @@
-import { z } from "zod";
-import { formatData, formatList } from "./output.utils.js";
-import { checkWriteGuardrails } from "./guardrails.js";
-export const metadataTools = [
-    {
-        name: "dataverse_list_tables",
-        description: "Lists all Dataverse tables. By default returns ONLY custom (non-system) tables. Set includeSystemTables=true to include all ~1700+ system tables. WHEN TO USE: Discovering which tables exist in the environment. BEST PRACTICES: Start without includeSystemTables to focus on custom tables; use dataverse_get_table_metadata for column details. WORKFLOW: explore_schema.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                includeSystemTables: {
-                    type: "boolean",
-                    description: "Include system tables. Default false = custom tables only.",
-                },
-            },
-            required: [],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: "dataverse_get_table_metadata",
-        description: "Returns full schema metadata for a Dataverse table: all attribute (column) logical names, display names, data types, required levels, and lookup target entities. Use this before writing queries or creating/updating records to confirm correct field names and types. Set includeAttributes=false if you only need table-level metadata without column details. WHEN TO USE: Before building queries or creating/updating records to validate field names, types, and required levels. BEST PRACTICES: Set includeAttributes=false for table-level info only; call once and reuse results. WORKFLOW: explore_schema.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                logicalName: {
-                    type: "string",
-                    description: 'The logical name of the table (e.g., "account", "contact", "new_mytable")',
-                },
-                includeAttributes: {
-                    type: "boolean",
-                    description: "Include attribute (column) definitions. Default: true",
-                },
-            },
-            required: ["logicalName"],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: "dataverse_get_relationships",
-        description: "Returns all relationship definitions (1:N, N:1, N:N) for a Dataverse table, including relationship schema names, referenced/referencing entity names, and lookup attribute names. Use to determine the correct relationshipName for dataverse_associate/dataverse_disassociate, or to map lookup fields before building FetchXML joins. Use relationshipType to filter results. WHEN TO USE: Finding relationship schema names for associate/disassociate, or mapping lookups for FetchXML joins. BEST PRACTICES: Filter by relationshipType to reduce output size. WORKFLOW: explore_schema.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                logicalName: {
-                    type: "string",
-                    description: "The logical name of the table",
-                },
-                relationshipType: {
-                    type: "string",
-                    enum: ["OneToMany", "ManyToOne", "ManyToMany", "All"],
-                    description: "Filter by relationship type. Default: All",
-                },
-            },
-            required: ["logicalName"],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: "dataverse_list_global_option_sets",
-        description: "Lists all global (shared) option sets defined in the Dataverse environment, returning their names and metadata IDs. Use this to discover available option sets before calling dataverse_get_option_set to retrieve their values. Prefer this over dataverse_get_table_metadata when you need to find option sets that are reused across multiple tables. WHEN TO USE: Discovering shared option sets reused across multiple tables. BEST PRACTICES: Follow up with dataverse_get_option_set to retrieve individual option values. WORKFLOW: explore_schema.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: "dataverse_get_option_set",
-        description: "Returns all option labels and their integer values for a named global option set. Use this to look up the numeric code for a picklist value before filtering records (e.g., statecode or statuscode equivalents), or to populate dropdowns with correct option values. WHEN TO USE: Looking up numeric codes for picklist filtering or record creation. BEST PRACTICES: Use the integer values in $filter expressions, not the label text. WORKFLOW: explore_schema.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                name: {
-                    type: "string",
-                    description: "The name of the global option set",
-                },
-            },
-            required: ["name"],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: "dataverse_get_entity_key",
-        description: "Returns all alternate key definitions for a Dataverse table. Useful before using dataverse_upsert to know which fields serve as alternate keys, their index status (Active/InProgress/Failed), and whether they are customizable. WHEN TO USE: Before using dataverse_upsert to verify which fields serve as alternate keys. BEST PRACTICES: Check that key index status is Active before relying on a key. WORKFLOW: explore_schema.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                tableName: {
-                    type: "string",
-                    description: 'Logical name of the table (e.g., "account", "contact")',
-                },
-            },
-            required: ["tableName"],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: "dataverse_get_attribute_option_set",
-        description: "Returns all option labels and integer values for a table-specific attribute (Picklist, Status, or State field). Use to look up the numeric codes for a column's choices before filtering or updating records. WHEN TO USE: Looking up option values for a specific table's picklist, status, or state column. BEST PRACTICES: Use the integer values in $filter and when setting fields in create/update. WORKFLOW: explore_schema.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                entityLogicalName: {
-                    type: "string",
-                    description: 'Logical name of the table (e.g., "account", "contact")',
-                },
-                attributeLogicalName: {
-                    type: "string",
-                    description: 'Logical name of the attribute (e.g., "statuscode", "industrycode")',
-                },
-            },
-            required: ["entityLogicalName", "attributeLogicalName"],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: "dataverse_update_entity",
-        description: "Updates configuration flags on an existing Dataverse entity definition — enables or disables Notes (HasNotes), Change Tracking, and Audit. " +
-            "Requires System Customizer or System Administrator privileges. WHEN TO USE: Enabling notes/attachments support, change tracking, or audit on a table. " +
-            "BEST PRACTICES: Set autoPublish=true (default) to make changes visible immediately. WORKFLOW: manage_solution.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                entityLogicalName: {
-                    type: "string",
-                    description: "Logical name of the entity to update (e.g. 'account', 'new_mytable')",
-                },
-                hasNotes: {
-                    type: "boolean",
-                    description: "Enable or disable the Notes/Attachments feature for this entity",
-                },
-                changeTrackingEnabled: {
-                    type: "boolean",
-                    description: "Enable or disable change tracking (required for delta sync)",
-                },
-                isAuditEnabled: {
-                    type: "boolean",
-                    description: "Enable or disable auditing on this entity",
-                },
-                autoPublish: {
-                    type: "boolean",
-                    description: "Publish the customization after update (default: true). Set false to defer publishing.",
-                },
-                confirm: {
-                    type: "boolean",
-                    description: "Must be true — confirms intentional schema modification to Dataverse entity metadata",
-                },
-            },
-            required: ["entityLogicalName", "confirm"],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-];
-const GetTableMetadataInput = z.object({
-    logicalName: z.string().min(1),
-    includeAttributes: z.boolean().optional().default(true),
-});
-const GetRelationshipsInput = z.object({
-    logicalName: z.string().min(1),
-    relationshipType: z
-        .enum(["OneToMany", "ManyToOne", "ManyToMany", "All"])
-        .optional(),
-});
-const ListTablesInput = z.object({
-    includeSystemTables: z
-        .boolean()
-        .default(false)
-        .optional()
-        .describe("Include system tables. Default false = custom tables only."),
-});
-const GetOptionSetInput = z.object({
-    name: z.string().min(1),
-});
-const GetEntityKeyInput = z.object({
-    tableName: z
-        .string()
-        .min(1)
-        .describe('Logical name of the table (e.g., "account", "contact")'),
-});
-const DV_NAME_RE = /^[a-z_][a-z0-9_]*$/;
-const GetAttributeOptionSetInput = z.object({
-    entityLogicalName: z
-        .string()
-        .min(1)
-        .regex(DV_NAME_RE, "Invalid Dataverse logical name"),
-    attributeLogicalName: z
-        .string()
-        .min(1)
-        .regex(DV_NAME_RE, "Invalid Dataverse logical name"),
-});
-const UpdateEntityInput = z
-    .object({
-    entityLogicalName: z
-        .string()
-        .min(1)
-        .regex(/^[a-z_][a-z0-9_]*$/, "Invalid logical name"),
-    confirm: z.literal(true, {
-        errorMap: () => ({
-            message: "Set confirm: true to modify entity metadata",
-        }),
-    }),
-    hasNotes: z.boolean().optional(),
-    changeTrackingEnabled: z.boolean().optional(),
-    isAuditEnabled: z.boolean().optional(),
-    autoPublish: z.boolean().optional().default(true),
-})
-    .refine((d) => d.hasNotes !== undefined ||
-    d.changeTrackingEnabled !== undefined ||
-    d.isAuditEnabled !== undefined, {
-    message: "At least one of hasNotes, changeTrackingEnabled, or isAuditEnabled must be provided",
-});
-export async function handleMetadataTool(name, args, client) {
-    switch (name) {
-        case "dataverse_list_tables": {
-            const { includeSystemTables = false } = ListTablesInput.parse(args ?? {});
-            const customOnly = !includeSystemTables;
-            const result = await client.listTables(customOnly);
-            const tables = Array.isArray(result) ? result : [];
-            return formatList(`tables (${customOnly ? "custom only" : "including system"})`, tables, [
-                "Use dataverse_get_table_metadata to inspect a specific table's columns and types",
-            ]);
-        }
-        case "dataverse_get_table_metadata": {
-            const { logicalName, includeAttributes } = GetTableMetadataInput.parse(args);
-            const result = await client.getTableMetadata(logicalName, includeAttributes);
-            const attributeCount = Array.isArray(result?.Attributes)
-                ? result.Attributes.length
-                : 0;
-            return formatData(`Metadata for ${logicalName}: ${attributeCount} attributes`, result, [
-                "Use dataverse_query to read records from this table",
-                "Use dataverse_get_relationships to see related tables",
-            ]);
-        }
-        case "dataverse_get_relationships": {
-            const { logicalName, relationshipType } = GetRelationshipsInput.parse(args);
-            const rawRelationships = await client.getRelationships(logicalName);
-            const lname = logicalName.toLowerCase();
-            const oneToMany = rawRelationships.filter((r) => r.RelationshipType === "OneToManyRelationship" &&
-                r.ReferencedEntity?.toLowerCase() === lname);
-            const manyToOne = rawRelationships.filter((r) => r.RelationshipType === "OneToManyRelationship" &&
-                r.ReferencingEntity?.toLowerCase() === lname);
-            const manyToMany = rawRelationships.filter((r) => r.RelationshipType === "ManyToManyRelationship");
-            const includeAll = !relationshipType || relationshipType === "All";
-            const allRels = [
-                ...(includeAll || relationshipType === "OneToMany" ? oneToMany : []),
-                ...(includeAll || relationshipType === "ManyToOne" ? manyToOne : []),
-                ...(includeAll || relationshipType === "ManyToMany" ? manyToMany : []),
-            ];
-            return formatData(`${allRels.length} relationships found for ${logicalName}`, {
-                tableName: logicalName,
-                oneToMany: includeAll || relationshipType === "OneToMany"
-                    ? oneToMany
-                    : undefined,
-                manyToOne: includeAll || relationshipType === "ManyToOne"
-                    ? manyToOne
-                    : undefined,
-                manyToMany: includeAll || relationshipType === "ManyToMany"
-                    ? manyToMany
-                    : undefined,
-            }, [
-                "Use dataverse_associate or dataverse_disassociate to manage N:N relationships",
-            ]);
-        }
-        case "dataverse_list_global_option_sets": {
-            const result = await client.listGlobalOptionSets();
-            const items = Array.isArray(result) ? result : [];
-            return formatList("global option sets", items, [
-                "Use dataverse_get_option_set with a name to see the values",
-            ]);
-        }
-        case "dataverse_get_option_set": {
-            const { name: optionSetName } = GetOptionSetInput.parse(args);
-            const result = await client.getOptionSet(optionSetName);
-            const options = Array.isArray(result?.Options)
-                ? result.Options
-                : [];
-            return formatData(`Option set '${optionSetName}': ${options.length} options`, result, [
-                "Use these values in $filter expressions or when creating/updating records",
-            ]);
-        }
-        case "dataverse_get_entity_key": {
-            const { tableName } = GetEntityKeyInput.parse(args);
-            const keys = await client.getEntityKeys(tableName);
-            return formatData(`${keys.length} alternate keys for ${tableName}`, { tableName, keys, count: keys.length }, [
-                "Use dataverse_upsert with these keys for create-or-update operations",
-            ]);
-        }
-        case "dataverse_get_attribute_option_set": {
-            const { entityLogicalName, attributeLogicalName } = GetAttributeOptionSetInput.parse(args);
-            const result = await client.getAttributeOptionSet(entityLogicalName, attributeLogicalName);
-            const options = Array.isArray(result?.options)
-                ? result.options
-                : [];
-            return formatData(`Attribute '${attributeLogicalName}' on '${entityLogicalName}': ${options.length} options`, result, [
-                "Use these integer values in $filter or when creating/updating records",
-            ]);
-        }
-        case "dataverse_update_entity": {
-            const { entityLogicalName, hasNotes, changeTrackingEnabled, isAuditEnabled, autoPublish, } = UpdateEntityInput.parse(args);
-            const writeWarnings = checkWriteGuardrails({
-                toolName: "dataverse_update_entity",
-                entitySetName: entityLogicalName,
-            }).map((w) => `[${w.severity.toUpperCase()}] ${w.code}: ${w.message}`);
-            const displayValues = {};
-            if (hasNotes !== undefined)
-                displayValues["HasNotes"] = hasNotes;
-            if (changeTrackingEnabled !== undefined)
-                displayValues["ChangeTrackingEnabled"] = changeTrackingEnabled;
-            if (isAuditEnabled !== undefined)
-                displayValues["IsAuditEnabled"] = isAuditEnabled;
-            const body = {
-                "@odata.type": "#Microsoft.Dynamics.CRM.EntityMetadata",
-            };
-            // HasNotes is Edm.Boolean (plain bool), NOT a BooleanManagedProperty
-            if (hasNotes !== undefined)
-                body["HasNotes"] = hasNotes;
-            if (changeTrackingEnabled !== undefined)
-                body["ChangeTrackingEnabled"] = changeTrackingEnabled;
-            // IsAuditEnabled is a BooleanManagedProperty — requires { Value: bool } wrapper
-            if (isAuditEnabled !== undefined)
-                body["IsAuditEnabled"] = { Value: isAuditEnabled };
-            try {
-                await client.updateEntityDefinition(entityLogicalName, body);
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                if (msg.includes("0x80060888")) {
-                    return formatData(`Cannot update entity '${entityLogicalName}': operation not supported by Dataverse.`, { error: "0x80060888", entityLogicalName, requestedChanges: displayValues }, [
-                        "IsAuditEnabled requires organization-level auditing to be enabled first: Power Platform admin center > Settings > Audit and logs > Start Auditing",
-                        "ChangeTrackingEnabled may be blocked if the entity is part of a managed solution",
-                        "HasNotes=true/false should work for custom (unmanaged) entities",
-                    ]);
-                }
-                throw err;
-            }
-            const changes = Object.entries(displayValues)
-                .map(([k, v]) => `${k}=${String(v)}`)
-                .join(", ");
-            let publishStatus = "autoPublish=false (skipped)";
-            if (autoPublish) {
-                await client.publishCustomizations({ entities: [entityLogicalName] });
-                publishStatus = "published successfully";
-            }
-            return formatData(`Entity '${entityLogicalName}' updated: ${changes}. ${publishStatus}.`, {
-                entityLogicalName,
-                changes: displayValues,
-                published: autoPublish,
-                ...(writeWarnings.length > 0 && { warnings: writeWarnings }),
-            }, [
-                "Use dataverse_get_table_metadata to verify the changes",
-                "Enable HasNotes=true before using dataverse_create_annotation",
-            ]);
-        }
-        default:
-            throw new Error(`Unknown metadata tool: ${name}`);
-    }
-}
-//# sourceMappingURL=metadata.tools.js.map

package/dist/tools/metadata.tools.js.map

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

package/dist/tools/org.tools.d.ts

@@ -1,32 +0,0 @@
-import type { DataverseAdvancedClient } from "../dataverse/dataverse-client-advanced.js";
-export declare const orgTools: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            top: {
-                type: string;
-                description: string;
-            };
-            includeDisabled: {
-                type: string;
-                description: string;
-            };
-        };
-        required: never[];
-    };
-    annotations: {
-        readOnlyHint: boolean;
-        destructiveHint: boolean;
-        idempotentHint: boolean;
-        openWorldHint: boolean;
-    };
-}[];
-export declare function handleOrgTool(name: string, args: unknown, client: DataverseAdvancedClient): Promise<{
-    content: Array<{
-        type: "text";
-        text: string;
-    }>;
-}>;
-//# sourceMappingURL=org.tools.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"org.tools.d.ts","sourceRoot":"","sources":["../../src/tools/org.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAQzF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;GA0BpB,CAAC;AAUF,wBAAsB,aAAa,CACjC,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,CAwC7D"}

package/dist/tools/org.tools.js

@@ -1,65 +0,0 @@
-import { z } from "zod";
-import { formatData } from "./output.utils.js";
-const ListBusinessUnitsInput = z.object({
-    top: z.number().int().positive().max(200).optional().default(50),
-    includeDisabled: z.boolean().optional().default(false),
-});
-export const orgTools = [
-    {
-        name: "dataverse_list_business_units",
-        description: "Lists business units in the Dataverse environment. Returns name, ID, parent business unit ID, disabled status, and creation date. By default only active business units are returned. WHEN TO USE: Finding business unit IDs for user management, team setup, or security role scope. BEST PRACTICES: The root business unit is the parent of all others; filter disabled units by default. WORKFLOW: explore_schema.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                top: {
-                    type: "number",
-                    description: "Maximum number of results (default 50, max 200)",
-                },
-                includeDisabled: {
-                    type: "boolean",
-                    description: "Include disabled business units (default false)",
-                },
-            },
-            required: [],
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    },
-];
-export async function handleOrgTool(name, args, client) {
-    switch (name) {
-        case "dataverse_list_business_units": {
-            const { top, includeDisabled } = ListBusinessUnitsInput.parse(args ?? {});
-            const filter = includeDisabled ? undefined : "isdisabled eq false";
-            const result = await client.query("businessunits", {
-                select: [
-                    "businessunitid",
-                    "name",
-                    "parentbusinessunitid",
-                    "isdisabled",
-                    "createdon",
-                ],
-                ...(filter ? { filter } : {}),
-                orderby: "name asc",
-                top,
-            });
-            const units = result.value.map((bu) => ({
-                id: bu.businessunitid,
-                name: bu.name,
-                parentBusinessUnitId: bu.parentbusinessunitid ?? null,
-                isDisabled: bu.isdisabled,
-                createdOn: bu.createdon,
-            }));
-            return formatData(`${units.length} business units found`, { businessUnits: units, count: units.length }, [
-                "Use business unit IDs for user management or security role assignment",
-            ]);
-        }
-        default:
-            throw new Error(`Unknown org tool: ${name}`);
-    }
-}
-//# sourceMappingURL=org.tools.js.map

package/dist/tools/org.tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"org.tools.js","sourceRoot":"","sources":["../../src/tools/org.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,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,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EACT,uZAAuZ;QACzZ,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iDAAiD;iBAC/D;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,iDAAiD;iBAC/D;aACF;YACD,QAAQ,EAAE,EAAE;SACb;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF;CACF,CAAC;AAUF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,IAAa,EACb,MAA+B;IAE/B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,+BAA+B,CAAC,CAAC,CAAC;YACrC,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAE1E,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC;YAEnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAe,eAAe,EAAE;gBAC/D,MAAM,EAAE;oBACN,gBAAgB;oBAChB,MAAM;oBACN,sBAAsB;oBACtB,YAAY;oBACZ,WAAW;iBACZ;gBACD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,UAAU;gBACnB,GAAG;aACJ,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACtC,EAAE,EAAE,EAAE,CAAC,cAAc;gBACrB,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,oBAAoB,EAAE,EAAE,CAAC,oBAAoB,IAAI,IAAI;gBACrD,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,SAAS,EAAE,EAAE,CAAC,SAAS;aACxB,CAAC,CAAC,CAAC;YAEJ,OAAO,UAAU,CACf,GAAG,KAAK,CAAC,MAAM,uBAAuB,EACtC,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,EAC7C;gBACE,uEAAuE;aACxE,CACF,CAAC;QACJ,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/tools/output.utils.d.ts

@@ -1,63 +0,0 @@
-import type { ToolResult } from "./tool-registry.js";
-/**
- * Describes a missing environment-level prerequisite that prevents a tool from
- * operating. Surface this to the agent so it can explain the required admin
- * action to the user in a structured, parseable way.
- */
-export interface EnvironmentPrerequisite {
-    /** Broad category of the limitation. */
-    type: "feature_disabled" | "permission_required" | "schema_missing";
-    /** Short display name of the missing feature/capability. */
-    feature: string;
-    /** One-sentence explanation of why the tool cannot proceed. */
-    cannotProceedBecause: string;
-    /** Primary portal where the fix must be applied. */
-    adminPortal: "Power Platform Admin Center" | "Power Apps Maker Portal" | "Azure AD" | "N/A";
-    /** Ordered navigation steps for the administrator. */
-    steps: string[];
-    /**
-     * Name of an MCP tool that can apply the fix programmatically,
-     * so the agent can offer to do it automatically instead of
-     * sending the user to the portal.
-     */
-    fixableViaToolName?: string;
-}
-interface StructuredOutput {
-    summary: string;
-    data: unknown;
-    suggestions?: string[] | undefined;
-    warnings?: string[] | undefined;
-    /**
-     * Present when the tool is blocked by a missing environment-level
-     * prerequisite. The agent should read this field and present the
-     * steps to the user rather than treating the response as a data result.
-     */
-    prerequisite?: EnvironmentPrerequisite | undefined;
-}
-/**
- * Wraps a structured output into the MCP tool result format.
- * Every tool handler should use this for consistent, LLM-friendly responses.
- */
-export declare function formatToolOutput(output: StructuredOutput): ToolResult;
-/**
- * Convenience: wrap raw data with a summary line and optional suggestions.
- */
-export declare function formatData(summary: string, data: unknown, suggestions?: string[], warnings?: string[]): ToolResult;
-/**
- * Format a count-based result (list of items).
- */
-export declare function formatList(label: string, items: unknown[], suggestions?: string[]): ToolResult;
-/**
- * Returns a structured "cannot proceed — environment prerequisite missing"
- * response. The tool should RETURN this instead of throwing so that the
- * agent receives a parseable JSON payload it can relay to the user.
- */
-export declare function formatPrerequisiteError(prerequisite: EnvironmentPrerequisite): ToolResult;
-/**
- * Merges OData formatted-value annotations into each record.
- * Transforms `{ statuscode: 1, "statuscode@OData.Community.Display.V1.FormattedValue": "Active" }`
- * into `{ statuscode: { value: 1, label: "Active" } }`.
- */
-export declare function mergeFormattedValues<T>(records: T[]): T[];
-export {};
-//# sourceMappingURL=output.utils.d.ts.map

package/dist/tools/output.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"output.utils.d.ts","sourceRoot":"","sources":["../../src/tools/output.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,wCAAwC;IACxC,IAAI,EAAE,kBAAkB,GAAG,qBAAqB,GAAG,gBAAgB,CAAC;IACpE,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,WAAW,EACP,6BAA6B,GAC7B,yBAAyB,GACzB,UAAU,GACV,KAAK,CAAC;IACV,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAChC;;;;OAIG;IACH,YAAY,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;CACpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CASrE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,UAAU,CAEZ;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EAAE,EAChB,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,UAAU,CAMZ;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,uBAAuB,GACpC,UAAU,CAMZ;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAuBzD"}