mcp-quickbase 2.0.5 → 2.2.0

package/dist/tools/records/update_record.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateRecordTool = void 0;
 const base_1 = require("../base");
 const logger_1 = require("../../utils/logger");
-const logger = (0, logger_1.createLogger)('UpdateRecordTool');
+const logger = (0, logger_1.createLogger)("UpdateRecordTool");
 /**
  * Tool for updating an existing record in a Quickbase table
  */
@@ -14,29 +14,29 @@ class UpdateRecordTool extends base_1.BaseTool {
      */
     constructor(client) {
         super(client);
-        this.name = 'update_record';
-        this.description = 'Updates an existing record in a Quickbase table';
+        this.name = "update_record";
+        this.description = "Updates an existing record in a Quickbase table";
         /**
          * Parameter schema for update_record
          */
         this.paramSchema = {
-            type: 'object',
+            type: "object",
             properties: {
                 table_id: {
-                    type: 'string',
-                    description: 'The ID of the Quickbase table'
+                    type: "string",
+                    description: "The ID of the Quickbase table",
                 },
                 record_id: {
-                    type: 'string',
-                    description: 'The ID of the record to update'
+                    type: "string",
+                    description: "The ID of the record to update",
                 },
                 data: {
-                    type: 'object',
-                    description: 'The updated data for the record',
-                    additionalProperties: true
-                }
+                    type: "object",
+                    description: "The updated data for the record",
+                    additionalProperties: true,
+                },
             },
-            required: ['table_id', 'record_id', 'data']
+            required: ["table_id", "record_id", "data"],
         };
     }
     /**
@@ -46,13 +46,13 @@ class UpdateRecordTool extends base_1.BaseTool {
      */
     async run(params) {
         const { table_id, record_id, data } = params;
-        logger.info('Updating record in Quickbase table', {
+        logger.info("Updating record in Quickbase table", {
             tableId: table_id,
-            recordId: record_id
+            recordId: record_id,
         });
         // Validate data
-        if (!data || typeof data !== 'object' || Object.keys(data).length === 0) {
-            throw new Error('Update data is required and must be a non-empty object');
+        if (!data || typeof data !== "object" || Object.keys(data).length === 0) {
+            throw new Error("Update data is required and must be a non-empty object");
         }
         // Prepare record data
         // Convert data to { [fieldId]: { value: fieldValue } } format expected by the API
@@ -63,35 +63,37 @@ class UpdateRecordTool extends base_1.BaseTool {
         // Prepare request body
         const body = {
             to: table_id,
-            data: [{
+            data: [
+                {
                     id: record_id,
-                    ...recordData
-                }]
+                    ...recordData,
+                },
+            ],
         };
         // Update the record
         const response = await this.client.request({
-            method: 'POST',
-            path: '/records',
-            body
+            method: "POST",
+            path: "/records",
+            body,
         });
         if (!response.success || !response.data) {
-            logger.error('Failed to update record', {
+            logger.error("Failed to update record", {
                 error: response.error,
                 tableId: table_id,
-                recordId: record_id
+                recordId: record_id,
             });
-            throw new Error(response.error?.message || 'Failed to update record');
+            throw new Error(response.error?.message || "Failed to update record");
         }
-        logger.info('Successfully updated record', {
+        logger.info("Successfully updated record", {
             recordId: record_id,
             tableId: table_id,
-            updatedFields: Object.keys(data)
+            updatedFields: Object.keys(data),
         });
         return {
             recordId: record_id,
             tableId: table_id,
             updatedTime: new Date().toISOString(),
-            updatedFields: Object.keys(data)
+            updatedFields: Object.keys(data),
         };
     }
 }

package/dist/tools/records/update_record.js.map

@@ -1 +1 @@
-{"version":3,"file":"update_record.js","sourceRoot":"","sources":["../../../src/tools/records/update_record.ts"],"names":[],"mappings":";;;AAAA,kCAAmC;AAEnC,+CAAkD;AAElD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,kBAAkB,CAAC,CAAC;AAgDhD;;GAEG;AACH,MAAa,gBAAiB,SAAQ,eAAgD;IA2BpF;;;OAGG;IACH,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QA/BT,SAAI,GAAG,eAAe,CAAC;QACvB,gBAAW,GAAG,iDAAiD,CAAC;QAEvE;;WAEG;QACI,gBAAW,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;oBAC9C,oBAAoB,EAAE,IAAI;iBAC3B;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC;SAC5C,CAAC;IAQF,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,GAAG,CAAC,MAA0B;QAC5C,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAE7C,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;YAChD,OAAO,EAAE,QAAQ;YACjB,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;QAEH,gBAAgB;QAChB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,sBAAsB;QACtB,kFAAkF;QAClF,MAAM,UAAU,GAAmC,EAAE,CAAC;QAEtD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;QAChC,CAAC;QAED,uBAAuB;QACvB,MAAM,IAAI,GAAwB;YAChC,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,CAAC;oBACL,EAAE,EAAE,SAAS;oBACb,GAAG,UAAU;iBACd,CAAC;SACH,CAAC;QAEF,oBAAoB;QACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACzC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU;YAChB,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE;gBACtC,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,OAAO,EAAE,QAAQ;gBACjB,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,yBAAyB,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;YACzC,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,QAAQ;YACjB,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;SACjC,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,QAAQ;YACjB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;SACjC,CAAC;IACJ,CAAC;CACF;AAnGD,4CAmGC"}
+{"version":3,"file":"update_record.js","sourceRoot":"","sources":["../../../src/tools/records/update_record.ts"],"names":[],"mappings":"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"}

package/dist/tools/registry.d.ts

@@ -1,4 +1,4 @@
-import { McpTool, ToolRegistry } from '../types/mcp';
+import { McpTool, ToolRegistry } from "../types/mcp";
 /**
  * Implementation of the MCP Tool Registry
  * Manages all available MCP tools

package/dist/tools/registry.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toolRegistry = exports.ToolRegistryImpl = void 0;
 const logger_1 = require("../utils/logger");
-const logger = (0, logger_1.createLogger)('ToolRegistry');
+const logger = (0, logger_1.createLogger)("ToolRegistry");
 /**
  * Implementation of the MCP Tool Registry
  * Manages all available MCP tools

package/dist/tools/relationships/create_relationship.d.ts

@@ -0,0 +1,150 @@
+import { BaseTool } from "../base";
+import { QuickbaseClient } from "../../client/quickbase";
+import { RelationshipFieldInfo } from "./get_relationships";
+/**
+ * Valid accumulation types for summary fields
+ */
+export type SummaryAccumulationType = "SUM" | "COUNT" | "AVG" | "MAX" | "MIN";
+/**
+ * Parameters for create_relationship tool
+ */
+export interface CreateRelationshipParams {
+    /**
+     * The ID of the child table (DBID) where the relationship reference field will be created
+     */
+    table_id: string;
+    /**
+     * The ID of the parent table (DBID) to link to
+     */
+    parent_table_id: string;
+    /**
+     * Optional label for the foreign key reference field created in the child table
+     */
+    foreign_key_label?: string;
+    /**
+     * Optional array of parent field IDs to create as lookup fields in the child table
+     */
+    lookup_field_ids?: number[];
+    /**
+     * Optional child field ID to summarize in the parent table
+     */
+    summary_field_id?: number;
+    /**
+     * Optional label for the summary field created in the parent table
+     */
+    summary_label?: string;
+    /**
+     * Accumulation type for the summary field (required if summary_field_id is provided)
+     */
+    summary_accumulation_type?: SummaryAccumulationType;
+    /**
+     * Optional Quickbase query filter for the summary field
+     */
+    summary_where?: string;
+}
+/**
+ * Result from creating a relationship
+ */
+export interface CreateRelationshipResult {
+    /**
+     * The ID of the relationship (same as the foreign key field ID)
+     */
+    id: number;
+    /**
+     * The ID of the parent table
+     */
+    parentTableId: string;
+    /**
+     * The ID of the child table
+     */
+    childTableId: string;
+    /**
+     * The foreign key field created in the child table
+     */
+    foreignKeyField: RelationshipFieldInfo;
+    /**
+     * Lookup fields created in the child table
+     */
+    lookupFields: RelationshipFieldInfo[];
+    /**
+     * Summary fields created in the parent table
+     */
+    summaryFields: RelationshipFieldInfo[];
+}
+/**
+ * Tool for creating a new table-to-table relationship in Quickbase.
+ *
+ * Creates a reference field in the child table linking to the parent table.
+ * Optionally creates lookup fields and/or summary fields.
+ */
+export declare class CreateRelationshipTool extends BaseTool<CreateRelationshipParams, CreateRelationshipResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for create_relationship with conditional validation
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            parent_table_id: {
+                type: string;
+                description: string;
+            };
+            foreign_key_label: {
+                type: string;
+                description: string;
+            };
+            lookup_field_ids: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            summary_field_id: {
+                type: string;
+                description: string;
+            };
+            summary_label: {
+                type: string;
+                description: string;
+            };
+            summary_accumulation_type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            summary_where: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        if: {
+            properties: {
+                summary_field_id: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+        then: {
+            required: string[];
+        };
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the create_relationship tool
+     * @param params Tool parameters
+     * @returns Created relationship details
+     */
+    protected run(params: CreateRelationshipParams): Promise<CreateRelationshipResult>;
+}

package/dist/tools/relationships/create_relationship.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateRelationshipTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)("CreateRelationshipTool");
+/**
+ * Tool for creating a new table-to-table relationship in Quickbase.
+ *
+ * Creates a reference field in the child table linking to the parent table.
+ * Optionally creates lookup fields and/or summary fields.
+ */
+class CreateRelationshipTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = "create_relationship";
+        this.description = "Creates a new table-to-table relationship linking a child table to a parent table. " +
+            "This creates a reference field in the child table. Optionally creates lookup fields " +
+            "(to display parent data in child records) and/or a summary field (to aggregate child " +
+            "data in parent records). Relationships can only be created between tables in the same " +
+            "application. This operation is SAFE and does not modify existing data.";
+        /**
+         * Parameter schema for create_relationship with conditional validation
+         */
+        this.paramSchema = {
+            type: "object",
+            properties: {
+                table_id: {
+                    type: "string",
+                    description: "The ID of the child Quickbase table (DBID) where the relationship reference field will be created",
+                },
+                parent_table_id: {
+                    type: "string",
+                    description: "The ID of the parent Quickbase table (DBID) to link to",
+                },
+                foreign_key_label: {
+                    type: "string",
+                    description: "Optional label for the foreign key reference field created in the child table",
+                },
+                lookup_field_ids: {
+                    type: "array",
+                    items: {
+                        type: "number",
+                    },
+                    description: "Optional array of parent field IDs to create as lookup fields in the child table",
+                },
+                summary_field_id: {
+                    type: "number",
+                    description: "Optional child field ID to summarize in the parent table",
+                },
+                summary_label: {
+                    type: "string",
+                    description: "Optional label for the summary field created in the parent table",
+                },
+                summary_accumulation_type: {
+                    type: "string",
+                    enum: ["SUM", "COUNT", "AVG", "MAX", "MIN"],
+                    description: "Accumulation type for the summary field. Required when summary_field_id is provided. " +
+                        "Valid values: SUM, COUNT, AVG, MAX, MIN",
+                },
+                summary_where: {
+                    type: "string",
+                    description: "Optional Quickbase query filter for the summary field (e.g., \"{6.EX.'Active'}\")",
+                },
+            },
+            required: ["table_id", "parent_table_id"],
+            // Conditional validation: summary_accumulation_type is required when summary_field_id is provided
+            if: {
+                properties: { summary_field_id: { type: "number" } },
+                required: ["summary_field_id"],
+            },
+            then: {
+                required: ["summary_accumulation_type"],
+            },
+        };
+    }
+    /**
+     * Run the create_relationship tool
+     * @param params Tool parameters
+     * @returns Created relationship details
+     */
+    async run(params) {
+        const { table_id, parent_table_id, foreign_key_label, lookup_field_ids, summary_field_id, summary_label, summary_accumulation_type, summary_where, } = params;
+        logger.info("Creating relationship between tables", {
+            childTableId: table_id,
+            parentTableId: parent_table_id,
+            hasLookupFields: !!lookup_field_ids?.length,
+            hasSummaryField: !!summary_field_id,
+        });
+        // Validate conditional requirement: summary_accumulation_type required when summary_field_id is provided
+        if (summary_field_id !== undefined && !summary_accumulation_type) {
+            const errorMessage = "summary_accumulation_type is required when summary_field_id is provided. " +
+                "Valid values: SUM, COUNT, AVG, MAX, MIN";
+            logger.error("Validation failed", { error: errorMessage });
+            throw new Error(errorMessage);
+        }
+        // Build the request body according to Quickbase API format
+        const body = {
+            parentTableId: parent_table_id,
+        };
+        // Add optional foreign key label
+        if (foreign_key_label) {
+            body.foreignKeyField = {
+                label: foreign_key_label,
+            };
+        }
+        // Add lookup fields if provided
+        if (lookup_field_ids && lookup_field_ids.length > 0) {
+            body.lookupFieldIds = lookup_field_ids;
+        }
+        // Add summary field configuration if provided
+        if (summary_field_id !== undefined && summary_accumulation_type) {
+            const summaryField = {
+                summaryFid: summary_field_id,
+                accumulationType: summary_accumulation_type,
+            };
+            if (summary_label) {
+                summaryField.label = summary_label;
+            }
+            if (summary_where) {
+                summaryField.where = summary_where;
+            }
+            body.summaryFields = [summaryField];
+        }
+        // Create the relationship
+        const response = await this.client.request({
+            method: "POST",
+            path: `/tables/${table_id}/relationship`,
+            body,
+        });
+        if (!response.success || !response.data) {
+            logger.error("Failed to create relationship", {
+                error: response.error,
+                childTableId: table_id,
+                parentTableId: parent_table_id,
+            });
+            throw new Error(response.error?.message || "Failed to create relationship");
+        }
+        // Parse and transform the API response
+        const data = response.data;
+        const foreignKeyField = data.foreignKeyField;
+        const lookupFields = data.lookupFields;
+        const summaryFields = data.summaryFields;
+        const result = {
+            id: data.id,
+            parentTableId: data.parentTableId,
+            childTableId: data.childTableId,
+            foreignKeyField: foreignKeyField
+                ? {
+                    id: foreignKeyField.id,
+                    label: foreignKeyField.label,
+                    type: foreignKeyField.type,
+                }
+                : { id: 0, label: "", type: "" },
+            lookupFields: (lookupFields || []).map((field) => ({
+                id: field.id,
+                label: field.label,
+                type: field.type,
+            })),
+            summaryFields: (summaryFields || []).map((field) => ({
+                id: field.id,
+                label: field.label,
+                type: field.type,
+            })),
+        };
+        logger.info("Successfully created relationship", {
+            relationshipId: result.id,
+            childTableId: result.childTableId,
+            parentTableId: result.parentTableId,
+            lookupFieldsCreated: result.lookupFields.length,
+            summaryFieldsCreated: result.summaryFields.length,
+        });
+        return result;
+    }
+}
+exports.CreateRelationshipTool = CreateRelationshipTool;
+//# sourceMappingURL=create_relationship.js.map

package/dist/tools/relationships/create_relationship.js.map

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

package/dist/tools/relationships/delete_relationship.d.ts

@@ -0,0 +1,66 @@
+import { BaseTool } from "../base";
+import { QuickbaseClient } from "../../client/quickbase";
+/**
+ * Parameters for delete_relationship tool
+ */
+export interface DeleteRelationshipParams {
+    /**
+     * The ID of the child table (DBID) containing the relationship
+     */
+    table_id: string;
+    /**
+     * The ID of the relationship to delete
+     */
+    relationship_id: number;
+}
+/**
+ * Result from deleting a relationship
+ */
+export interface DeleteRelationshipResult {
+    /**
+     * The ID of the deleted relationship
+     */
+    relationshipId: number;
+    /**
+     * Whether the deletion was successful
+     */
+    deleted: boolean;
+}
+/**
+ * Tool for deleting a table-to-table relationship in Quickbase.
+ *
+ * WARNING: This is a DESTRUCTIVE operation that permanently deletes
+ * the relationship and all associated lookup and summary fields.
+ */
+export declare class DeleteRelationshipTool extends BaseTool<DeleteRelationshipParams, DeleteRelationshipResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for delete_relationship
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            relationship_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the delete_relationship tool
+     * @param params Tool parameters
+     * @returns Deletion confirmation
+     */
+    protected run(params: DeleteRelationshipParams): Promise<DeleteRelationshipResult>;
+}

package/dist/tools/relationships/delete_relationship.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteRelationshipTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)("DeleteRelationshipTool");
+/**
+ * Tool for deleting a table-to-table relationship in Quickbase.
+ *
+ * WARNING: This is a DESTRUCTIVE operation that permanently deletes
+ * the relationship and all associated lookup and summary fields.
+ */
+class DeleteRelationshipTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = "delete_relationship";
+        this.description = "WARNING: DESTRUCTIVE OPERATION - Permanently deletes an entire table-to-table " +
+            "relationship INCLUDING ALL LOOKUP AND SUMMARY FIELDS associated with it. All data " +
+            "in those fields will be permanently lost and CANNOT be recovered. The reference " +
+            "field in the child table will NOT be deleted (it will remain and may need to be " +
+            "manually deleted using field deletion tools if no longer needed). Before using " +
+            "this tool:\n" +
+            "1. Use get_relationships to see what fields will be deleted\n" +
+            "2. Confirm with the user that they want to proceed\n" +
+            "3. Consider if you only need to delete specific fields instead\n\n" +
+            "Only use this tool when you are certain the entire relationship should be removed.";
+        /**
+         * Parameter schema for delete_relationship
+         */
+        this.paramSchema = {
+            type: "object",
+            properties: {
+                table_id: {
+                    type: "string",
+                    description: "The ID of the child Quickbase table (DBID) containing the relationship",
+                },
+                relationship_id: {
+                    type: "number",
+                    description: "The ID of the relationship to delete",
+                },
+            },
+            required: ["table_id", "relationship_id"],
+        };
+    }
+    /**
+     * Run the delete_relationship tool
+     * @param params Tool parameters
+     * @returns Deletion confirmation
+     */
+    async run(params) {
+        const { table_id, relationship_id } = params;
+        // Use logger.warn for destructive operations
+        logger.warn("Deleting relationship", {
+            tableId: table_id,
+            relationshipId: relationship_id,
+        });
+        // Delete the relationship
+        const response = await this.client.request({
+            method: "DELETE",
+            path: `/tables/${table_id}/relationship/${relationship_id}`,
+        });
+        if (!response.success) {
+            logger.error("Failed to delete relationship", {
+                error: response.error,
+                tableId: table_id,
+                relationshipId: relationship_id,
+            });
+            throw new Error(response.error?.message || "Failed to delete relationship");
+        }
+        logger.warn("Successfully deleted relationship", {
+            tableId: table_id,
+            relationshipId: relationship_id,
+        });
+        return {
+            relationshipId: relationship_id,
+            deleted: true,
+        };
+    }
+}
+exports.DeleteRelationshipTool = DeleteRelationshipTool;
+//# sourceMappingURL=delete_relationship.js.map

package/dist/tools/relationships/delete_relationship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_relationship.js","sourceRoot":"","sources":["../../../src/tools/relationships/delete_relationship.ts"],"names":[],"mappings":";;;AAAA,kCAAmC;AAEnC,+CAAkD;AAElD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,wBAAwB,CAAC,CAAC;AAgCtD;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,eAG3C;IAiCC;;;OAGG;IACH,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QArCT,SAAI,GAAG,qBAAqB,CAAC;QAC7B,gBAAW,GAChB,gFAAgF;YAChF,oFAAoF;YACpF,kFAAkF;YAClF,kFAAkF;YAClF,iFAAiF;YACjF,cAAc;YACd,+DAA+D;YAC/D,sDAAsD;YACtD,oEAAoE;YACpE,oFAAoF,CAAC;QAEvF;;WAEG;QACI,gBAAW,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,wEAAwE;iBAC3E;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,iBAAiB,CAAC;SAC1C,CAAC;IAQF,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,GAAG,CACjB,MAAgC;QAEhC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;QAE7C,6CAA6C;QAC7C,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;YACnC,OAAO,EAAE,QAAQ;YACjB,cAAc,EAAE,eAAe;SAChC,CAAC,CAAC;QAEH,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B;YAClE,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,WAAW,QAAQ,iBAAiB,eAAe,EAAE;SAC5D,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE;gBAC5C,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,OAAO,EAAE,QAAQ;gBACjB,cAAc,EAAE,eAAe;aAChC,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CACb,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,+BAA+B,CAC3D,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;YAC/C,OAAO,EAAE,QAAQ;YACjB,cAAc,EAAE,eAAe;SAChC,CAAC,CAAC;QAEH,OAAO;YACL,cAAc,EAAE,eAAe;YAC/B,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF;AAvFD,wDAuFC"}