mcp-quickbase 2.1.0 → 2.2.0

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

@@ -0,0 +1,126 @@
+import { BaseTool } from "../base";
+import { QuickbaseClient } from "../../client/quickbase";
+/**
+ * Field information in a relationship
+ */
+export interface RelationshipFieldInfo {
+    /**
+     * The ID of the field
+     */
+    id: number;
+    /**
+     * The label (display name) of the field
+     */
+    label: string;
+    /**
+     * The type of the field
+     */
+    type: string;
+}
+/**
+ * Relationship between two tables
+ */
+export interface Relationship {
+    /**
+     * 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 in the child table
+     */
+    foreignKeyField: RelationshipFieldInfo;
+    /**
+     * Whether this is a cross-app relationship
+     */
+    isCrossApp: boolean;
+    /**
+     * Lookup fields in the child table that pull data from the parent
+     */
+    lookupFields: RelationshipFieldInfo[];
+    /**
+     * Summary fields in the parent table that aggregate data from the child
+     */
+    summaryFields: RelationshipFieldInfo[];
+}
+/**
+ * Parameters for get_relationships tool
+ */
+export interface GetRelationshipsParams {
+    /**
+     * The ID of the table to get relationships for
+     */
+    table_id: string;
+    /**
+     * Number of relationships to skip (for pagination)
+     */
+    skip?: number;
+}
+/**
+ * Response from getting relationships
+ */
+export interface GetRelationshipsResult {
+    /**
+     * Array of relationships
+     */
+    relationships: Relationship[];
+    /**
+     * Metadata about the response
+     */
+    metadata: {
+        /**
+         * Total number of relationships for the table
+         */
+        totalRelationships: number;
+        /**
+         * Number of relationships returned in this response
+         */
+        numRelationships: number;
+        /**
+         * Number of relationships skipped
+         */
+        skip: number;
+    };
+}
+/**
+ * Tool for retrieving all table-to-table relationships for a specified table
+ */
+export declare class GetRelationshipsTool extends BaseTool<GetRelationshipsParams, GetRelationshipsResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for get_relationships
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            skip: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the get_relationships tool
+     * @param params Tool parameters
+     * @returns Relationships for the table
+     */
+    protected run(params: GetRelationshipsParams): Promise<GetRelationshipsResult>;
+}

package/dist/tools/relationships/get_relationships.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetRelationshipsTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)("GetRelationshipsTool");
+/**
+ * Tool for retrieving all table-to-table relationships for a specified table
+ */
+class GetRelationshipsTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = "get_relationships";
+        this.description = "Gets all table-to-table relationships for a specified table. Returns both relationships " +
+            "where this table is the child (has reference fields pointing to parents) and where this " +
+            "table is the parent (has child tables referencing it). Use this tool to explore table " +
+            "structure and understand data connections before modifying relationships.";
+        /**
+         * Parameter schema for get_relationships
+         */
+        this.paramSchema = {
+            type: "object",
+            properties: {
+                table_id: {
+                    type: "string",
+                    description: "The ID of the Quickbase table (DBID)",
+                },
+                skip: {
+                    type: "number",
+                    description: "Number of relationships to skip for pagination (default: 0)",
+                },
+            },
+            required: ["table_id"],
+        };
+    }
+    /**
+     * Run the get_relationships tool
+     * @param params Tool parameters
+     * @returns Relationships for the table
+     */
+    async run(params) {
+        const { table_id, skip = 0 } = params;
+        logger.info("Getting relationships for table", { tableId: table_id, skip });
+        // Prepare query parameters
+        const queryParams = {};
+        if (skip > 0) {
+            queryParams.skip = skip.toString();
+        }
+        // Get relationships for the table
+        const response = await this.client.request({
+            method: "GET",
+            path: `/tables/${table_id}/relationships`,
+            params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
+        });
+        if (!response.success || !response.data) {
+            logger.error("Failed to get relationships", {
+                error: response.error,
+                tableId: table_id,
+            });
+            throw new Error(response.error?.message || "Failed to get relationships");
+        }
+        // Parse and validate the API response
+        const data = response.data;
+        // Validate relationships array exists
+        const rawRelationships = data.relationships;
+        if (!Array.isArray(rawRelationships)) {
+            logger.error("Relationships response missing relationships array", {
+                data,
+            });
+            throw new Error("Relationships response does not contain relationships array");
+        }
+        // Transform API response to our interface
+        const relationships = rawRelationships.map((rel) => {
+            const foreignKeyField = rel.foreignKeyField;
+            const lookupFields = rel.lookupFields;
+            const summaryFields = rel.summaryFields;
+            return {
+                id: rel.id,
+                parentTableId: rel.parentTableId,
+                childTableId: rel.childTableId,
+                foreignKeyField: foreignKeyField
+                    ? {
+                        id: foreignKeyField.id,
+                        label: foreignKeyField.label,
+                        type: foreignKeyField.type,
+                    }
+                    : { id: 0, label: "", type: "" },
+                isCrossApp: rel.isCrossApp || false,
+                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,
+                })),
+            };
+        });
+        // Extract metadata from response
+        const metadata = data.metadata;
+        const totalRelationships = metadata?.totalRelationships ?? relationships.length;
+        const numRelationships = metadata?.numRelationships ?? relationships.length;
+        logger.info(`Found ${relationships.length} relationships for table`, {
+            tableId: table_id,
+            totalRelationships,
+            numRelationships,
+            skip,
+        });
+        return {
+            relationships,
+            metadata: {
+                totalRelationships,
+                numRelationships,
+                skip,
+            },
+        };
+    }
+}
+exports.GetRelationshipsTool = GetRelationshipsTool;
+//# sourceMappingURL=get_relationships.js.map

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

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

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

@@ -0,0 +1,14 @@
+import { QuickbaseClient } from "../../client/quickbase";
+/**
+ * Register all relationship management tools with the registry
+ * @param client Quickbase client
+ */
+export declare function registerRelationshipTools(client: QuickbaseClient): void;
+export { GetRelationshipsTool } from "./get_relationships";
+export type { GetRelationshipsParams, GetRelationshipsResult, Relationship, RelationshipFieldInfo, } from "./get_relationships";
+export { CreateRelationshipTool } from "./create_relationship";
+export type { CreateRelationshipParams, CreateRelationshipResult, SummaryAccumulationType, } from "./create_relationship";
+export { UpdateRelationshipTool } from "./update_relationship";
+export type { UpdateRelationshipParams, UpdateRelationshipResult, } from "./update_relationship";
+export { DeleteRelationshipTool } from "./delete_relationship";
+export type { DeleteRelationshipParams, DeleteRelationshipResult, } from "./delete_relationship";

package/dist/tools/relationships/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteRelationshipTool = exports.UpdateRelationshipTool = exports.CreateRelationshipTool = exports.GetRelationshipsTool = void 0;
+exports.registerRelationshipTools = registerRelationshipTools;
+const registry_1 = require("../registry");
+const logger_1 = require("../../utils/logger");
+const get_relationships_1 = require("./get_relationships");
+const create_relationship_1 = require("./create_relationship");
+const update_relationship_1 = require("./update_relationship");
+const delete_relationship_1 = require("./delete_relationship");
+const logger = (0, logger_1.createLogger)("RelationshipTools");
+/**
+ * Register all relationship management tools with the registry
+ * @param client Quickbase client
+ */
+function registerRelationshipTools(client) {
+    logger.info("Registering relationship management tools");
+    // Register get_relationships tool (RELS.1002)
+    registry_1.toolRegistry.registerTool(new get_relationships_1.GetRelationshipsTool(client));
+    // Register create_relationship tool (RELS.2001)
+    registry_1.toolRegistry.registerTool(new create_relationship_1.CreateRelationshipTool(client));
+    // Register update_relationship tool (RELS.2002)
+    registry_1.toolRegistry.registerTool(new update_relationship_1.UpdateRelationshipTool(client));
+    // Register delete_relationship tool (RELS.3001)
+    registry_1.toolRegistry.registerTool(new delete_relationship_1.DeleteRelationshipTool(client));
+    logger.info("Relationship management tools registered");
+}
+// Export relationship tools
+var get_relationships_2 = require("./get_relationships");
+Object.defineProperty(exports, "GetRelationshipsTool", { enumerable: true, get: function () { return get_relationships_2.GetRelationshipsTool; } });
+var create_relationship_2 = require("./create_relationship");
+Object.defineProperty(exports, "CreateRelationshipTool", { enumerable: true, get: function () { return create_relationship_2.CreateRelationshipTool; } });
+var update_relationship_2 = require("./update_relationship");
+Object.defineProperty(exports, "UpdateRelationshipTool", { enumerable: true, get: function () { return update_relationship_2.UpdateRelationshipTool; } });
+var delete_relationship_2 = require("./delete_relationship");
+Object.defineProperty(exports, "DeleteRelationshipTool", { enumerable: true, get: function () { return delete_relationship_2.DeleteRelationshipTool; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/relationships/index.ts"],"names":[],"mappings":";;;AAcA,8DAgBC;AA7BD,0CAA2C;AAC3C,+CAAkD;AAClD,2DAA2D;AAC3D,+DAA+D;AAC/D,+DAA+D;AAC/D,+DAA+D;AAE/D,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,mBAAmB,CAAC,CAAC;AAEjD;;;GAGG;AACH,SAAgB,yBAAyB,CAAC,MAAuB;IAC/D,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAEzD,8CAA8C;IAC9C,uBAAY,CAAC,YAAY,CAAC,IAAI,wCAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5D,gDAAgD;IAChD,uBAAY,CAAC,YAAY,CAAC,IAAI,4CAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9D,gDAAgD;IAChD,uBAAY,CAAC,YAAY,CAAC,IAAI,4CAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9D,gDAAgD;IAChD,uBAAY,CAAC,YAAY,CAAC,IAAI,4CAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9D,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;AAC1D,CAAC;AAED,4BAA4B;AAC5B,yDAA2D;AAAlD,yHAAA,oBAAoB,OAAA;AAQ7B,6DAA+D;AAAtD,6HAAA,sBAAsB,OAAA;AAO/B,6DAA+D;AAAtD,6HAAA,sBAAsB,OAAA;AAM/B,6DAA+D;AAAtD,6HAAA,sBAAsB,OAAA"}

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

@@ -0,0 +1,139 @@
+import { BaseTool } from "../base";
+import { QuickbaseClient } from "../../client/quickbase";
+import { RelationshipFieldInfo } from "./get_relationships";
+import { SummaryAccumulationType } from "./create_relationship";
+/**
+ * Parameters for update_relationship tool
+ */
+export interface UpdateRelationshipParams {
+    /**
+     * The ID of the child table (DBID) containing the relationship
+     */
+    table_id: string;
+    /**
+     * The ID of the relationship (same as the foreign key field ID)
+     */
+    relationship_id: number;
+    /**
+     * Optional array of parent field IDs to add 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 updating a relationship
+ */
+export interface UpdateRelationshipResult {
+    /**
+     * 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 in the child table
+     */
+    foreignKeyField: RelationshipFieldInfo;
+    /**
+     * All lookup fields in the child table (existing + newly added)
+     */
+    lookupFields: RelationshipFieldInfo[];
+    /**
+     * All summary fields in the parent table (existing + newly added)
+     */
+    summaryFields: RelationshipFieldInfo[];
+}
+/**
+ * Tool for updating an existing table-to-table relationship in Quickbase.
+ *
+ * ADDITIVE ONLY - adds lookup fields and/or summary fields to existing relationships.
+ * Does not delete existing fields from the relationship.
+ */
+export declare class UpdateRelationshipTool extends BaseTool<UpdateRelationshipParams, UpdateRelationshipResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for update_relationship with conditional validation
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            relationship_id: {
+                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 update_relationship tool
+     * @param params Tool parameters
+     * @returns Updated relationship details
+     */
+    protected run(params: UpdateRelationshipParams): Promise<UpdateRelationshipResult>;
+}

package/dist/tools/relationships/update_relationship.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateRelationshipTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)("UpdateRelationshipTool");
+/**
+ * Tool for updating an existing table-to-table relationship in Quickbase.
+ *
+ * ADDITIVE ONLY - adds lookup fields and/or summary fields to existing relationships.
+ * Does not delete existing fields from the relationship.
+ */
+class UpdateRelationshipTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = "update_relationship";
+        this.description = "Adds lookup fields and/or summary fields to an existing relationship. This operation " +
+            "is ADDITIVE ONLY - it will not delete existing lookup or summary fields. Use this to " +
+            "enhance relationships with additional calculated fields. To remove fields from a " +
+            "relationship, you must delete them individually using the field deletion tools.";
+        /**
+         * Parameter schema for update_relationship with conditional validation
+         */
+        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 update (same as the foreign key field ID)",
+                },
+                lookup_field_ids: {
+                    type: "array",
+                    items: {
+                        type: "number",
+                    },
+                    description: "Optional array of parent field IDs to add 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", "relationship_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 update_relationship tool
+     * @param params Tool parameters
+     * @returns Updated relationship details
+     */
+    async run(params) {
+        const { table_id, relationship_id, lookup_field_ids, summary_field_id, summary_label, summary_accumulation_type, summary_where, } = params;
+        logger.info("Updating relationship", {
+            childTableId: table_id,
+            relationshipId: relationship_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 = {};
+        // 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];
+        }
+        // Update the relationship
+        const response = await this.client.request({
+            method: "POST",
+            path: `/tables/${table_id}/relationship/${relationship_id}`,
+            body,
+        });
+        if (!response.success || !response.data) {
+            logger.error("Failed to update relationship", {
+                error: response.error,
+                childTableId: table_id,
+                relationshipId: relationship_id,
+            });
+            throw new Error(response.error?.message || "Failed to update 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 updated relationship", {
+            relationshipId: result.id,
+            childTableId: result.childTableId,
+            parentTableId: result.parentTableId,
+            totalLookupFields: result.lookupFields.length,
+            totalSummaryFields: result.summaryFields.length,
+        });
+        return result;
+    }
+}
+exports.UpdateRelationshipTool = UpdateRelationshipTool;
+//# sourceMappingURL=update_relationship.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update_relationship.js","sourceRoot":"","sources":["../../../src/tools/relationships/update_relationship.ts"],"names":[],"mappings":";;;AAAA,kCAAmC;AAEnC,+CAAkD;AAIlD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,wBAAwB,CAAC,CAAC;AA6EtD;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,eAG3C;IAiEC;;;OAGG;IACH,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QArET,SAAI,GAAG,qBAAqB,CAAC;QAC7B,gBAAW,GAChB,uFAAuF;YACvF,uFAAuF;YACvF,mFAAmF;YACnF,iFAAiF,CAAC;QAEpF;;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,EACT,yEAAyE;iBAC5E;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;qBACf;oBACD,WAAW,EACT,+EAA+E;iBAClF;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACxE;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,kEAAkE;iBACrE;gBACD,yBAAyB,EAAE;oBACzB,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;oBAC3C,WAAW,EACT,uFAAuF;wBACvF,yCAAyC;iBAC5C;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,mFAAmF;iBACtF;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,iBAAiB,CAAC;YACzC,kGAAkG;YAClG,EAAE,EAAE;gBACF,UAAU,EAAE,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBACpD,QAAQ,EAAE,CAAC,kBAAkB,CAAC;aAC/B;YACD,IAAI,EAAE;gBACJ,QAAQ,EAAE,CAAC,2BAA2B,CAAC;aACxC;SACF,CAAC;IAQF,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,GAAG,CACjB,MAAgC;QAEhC,MAAM,EACJ,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,yBAAyB,EACzB,aAAa,GACd,GAAG,MAAM,CAAC;QAEX,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;YACnC,YAAY,EAAE,QAAQ;YACtB,cAAc,EAAE,eAAe;YAC/B,eAAe,EAAE,CAAC,CAAC,gBAAgB,EAAE,MAAM;YAC3C,eAAe,EAAE,CAAC,CAAC,gBAAgB;SACpC,CAAC,CAAC;QAEH,yGAAyG;QACzG,IAAI,gBAAgB,KAAK,SAAS,IAAI,CAAC,yBAAyB,EAAE,CAAC;YACjE,MAAM,YAAY,GAChB,2EAA2E;gBAC3E,yCAAyC,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;QAED,2DAA2D;QAC3D,MAAM,IAAI,GAA4B,EAAE,CAAC;QAEzC,gCAAgC;QAChC,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,cAAc,GAAG,gBAAgB,CAAC;QACzC,CAAC;QAED,8CAA8C;QAC9C,IAAI,gBAAgB,KAAK,SAAS,IAAI,yBAAyB,EAAE,CAAC;YAChE,MAAM,YAAY,GAA4B;gBAC5C,UAAU,EAAE,gBAAgB;gBAC5B,gBAAgB,EAAE,yBAAyB;aAC5C,CAAC;YAEF,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,CAAC,KAAK,GAAG,aAAa,CAAC;YACrC,CAAC;YAED,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,CAAC,KAAK,GAAG,aAAa,CAAC;YACrC,CAAC;YAED,IAAI,CAAC,aAAa,GAAG,CAAC,YAAY,CAAC,CAAC;QACtC,CAAC;QAED,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B;YAClE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,WAAW,QAAQ,iBAAiB,eAAe,EAAE;YAC3D,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE;gBAC5C,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,YAAY,EAAE,QAAQ;gBACtB,cAAc,EAAE,eAAe;aAChC,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CACb,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,+BAA+B,CAC3D,CAAC;QACJ,CAAC;QAED,uCAAuC;QACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAE3B,MAAM,eAAe,GAAG,IAAI,CAAC,eAEhB,CAAC;QACd,MAAM,YAAY,GAAG,IAAI,CAAC,YAEb,CAAC;QACd,MAAM,aAAa,GAAG,IAAI,CAAC,aAEd,CAAC;QAEd,MAAM,MAAM,GAA6B;YACvC,EAAE,EAAE,IAAI,CAAC,EAAY;YACrB,aAAa,EAAE,IAAI,CAAC,aAAuB;YAC3C,YAAY,EAAE,IAAI,CAAC,YAAsB;YACzC,eAAe,EAAE,eAAe;gBAC9B,CAAC,CAAC;oBACE,EAAE,EAAE,eAAe,CAAC,EAAY;oBAChC,KAAK,EAAE,eAAe,CAAC,KAAe;oBACtC,IAAI,EAAE,eAAe,CAAC,IAAc;iBACrC;gBACH,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;YAClC,YAAY,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CACpC,CAAC,KAA8B,EAAE,EAAE,CAAC,CAAC;gBACnC,EAAE,EAAE,KAAK,CAAC,EAAY;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAe;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAc;aAC3B,CAAC,CACH;YACD,aAAa,EAAE,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CACtC,CAAC,KAA8B,EAAE,EAAE,CAAC,CAAC;gBACnC,EAAE,EAAE,KAAK,CAAC,EAAY;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAe;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAc;aAC3B,CAAC,CACH;SACF,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;YAC/C,cAAc,EAAE,MAAM,CAAC,EAAE;YACzB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,iBAAiB,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM;YAC7C,kBAAkB,EAAE,MAAM,CAAC,aAAa,CAAC,MAAM;SAChD,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA5MD,wDA4MC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-quickbase",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Work with Quickbase via Model Context Protocol",
   "main": "dist/mcp-stdio-server.js",
   "types": "dist/mcp-stdio-server.d.ts",