mcp-quickbase 2.0.5 → 2.2.0

package/dist/tools/configure_cache.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigureCacheTool = void 0;
 const base_1 = require("./base");
 const logger_1 = require("../utils/logger");
-const logger = (0, logger_1.createLogger)('ConfigureCacheTool');
+const logger = (0, logger_1.createLogger)("ConfigureCacheTool");
 /**
  * Tool for configuring the caching behavior of the Quickbase connector
  */
@@ -15,28 +15,28 @@ class ConfigureCacheTool extends base_1.BaseTool {
      */
     constructor(client, cacheService) {
         super(client);
-        this.name = 'configure_cache';
-        this.description = 'Configures caching behavior for Quickbase operations';
+        this.name = "configure_cache";
+        this.description = "Configures caching behavior for Quickbase operations";
         /**
          * Parameter schema for configure_cache
          */
         this.paramSchema = {
-            type: 'object',
+            type: "object",
             properties: {
                 enabled: {
-                    type: 'boolean',
-                    description: 'Whether to enable caching (default: true)'
+                    type: "boolean",
+                    description: "Whether to enable caching (default: true)",
                 },
                 clear: {
-                    type: 'boolean',
-                    description: 'Whether to clear all existing caches (default: false)'
+                    type: "boolean",
+                    description: "Whether to clear all existing caches (default: false)",
                 },
                 ttl: {
-                    type: 'number',
-                    description: 'Cache time-to-live in seconds'
-                }
+                    type: "number",
+                    description: "Cache time-to-live in seconds",
+                },
             },
-            required: []
+            required: [],
         };
         this.cacheService = cacheService;
     }
@@ -46,22 +46,22 @@ class ConfigureCacheTool extends base_1.BaseTool {
      * @returns Configuration result
      */
     async run(params) {
-        logger.info('Configuring cache', params);
+        logger.info("Configuring cache", params);
         const result = {
             cacheEnabled: this.cacheService.isEnabled(),
-            cacheCleared: false
+            cacheCleared: false,
         };
         // Clear cache if requested
         if (params.clear) {
             this.cacheService.clear();
             result.cacheCleared = true;
-            logger.info('Cache cleared');
+            logger.info("Cache cleared");
         }
         // Enable/disable cache if specified
         if (params.enabled !== undefined) {
             this.cacheService.setEnabled(params.enabled);
             result.cacheEnabled = params.enabled;
-            logger.info(`Cache ${params.enabled ? 'enabled' : 'disabled'}`);
+            logger.info(`Cache ${params.enabled ? "enabled" : "disabled"}`);
         }
         // Set TTL if specified
         if (params.ttl !== undefined && params.ttl > 0) {

package/dist/tools/configure_cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"configure_cache.js","sourceRoot":"","sources":["../../src/tools/configure_cache.ts"],"names":[],"mappings":";;;AAAA,iCAAkC;AAGlC,4CAA+C;AAE/C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,oBAAoB,CAAC,CAAC;AA0ClD;;GAEG;AACH,MAAa,kBAAmB,SAAQ,eAAoD;IA+B1F;;;;OAIG;IACH,YAAY,MAAuB,EAAE,YAA0B;QAC7D,KAAK,CAAC,MAAM,CAAC,CAAC;QApCT,SAAI,GAAG,iBAAiB,CAAC;QACzB,gBAAW,GAAG,sDAAsD,CAAC;QAE5E;;WAEG;QACI,gBAAW,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,2CAA2C;iBACzD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,uDAAuD;iBACrE;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;aACF;YACD,QAAQ,EAAE,EAAE;SACb,CAAC;QAcA,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,GAAG,CAAC,MAA4B;QAC9C,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAyB;YACnC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE;YAC3C,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,2BAA2B;QAC3B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/B,CAAC;QAED,oCAAoC;QACpC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,uBAAuB;QACvB,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC/C,wBAAwB;YACxB,mEAAmE;YACnE,MAAM,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC;YACtD,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC;QAC/B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA9ED,gDA8EC"}
+{"version":3,"file":"configure_cache.js","sourceRoot":"","sources":["../../src/tools/configure_cache.ts"],"names":[],"mappings":";;;AAAA,iCAAkC;AAGlC,4CAA+C;AAE/C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,oBAAoB,CAAC,CAAC;AA0ClD;;GAEG;AACH,MAAa,kBAAmB,SAAQ,eAGvC;IA+BC;;;;OAIG;IACH,YAAY,MAAuB,EAAE,YAA0B;QAC7D,KAAK,CAAC,MAAM,CAAC,CAAC;QApCT,SAAI,GAAG,iBAAiB,CAAC;QACzB,gBAAW,GAAG,sDAAsD,CAAC;QAE5E;;WAEG;QACI,gBAAW,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,2CAA2C;iBACzD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,uDAAuD;iBACrE;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;aACF;YACD,QAAQ,EAAE,EAAE;SACb,CAAC;QAcA,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,GAAG,CACjB,MAA4B;QAE5B,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAyB;YACnC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE;YAC3C,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,2BAA2B;QAC3B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/B,CAAC;QAED,oCAAoC;QACpC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,uBAAuB;QACvB,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC/C,wBAAwB;YACxB,mEAAmE;YACnE,MAAM,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC;YACtD,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC;QAC/B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAnFD,gDAmFC"}

package/dist/tools/fields/create_field.d.ts

@@ -1,5 +1,5 @@
-import { BaseTool } from '../base';
-import { QuickbaseClient } from '../../client/quickbase';
+import { BaseTool } from "../base";
+import { QuickbaseClient } from "../../client/quickbase";
 /**
  * Field property definitions for various field types
  */
@@ -27,15 +27,16 @@ export interface CreateFieldParams {
      */
     table_id: string;
     /**
-     * Name of the field
+     * Display label for the field
      */
     field_name: string;
     /**
-     * Type of the field (e.g., text, numeric, date, etc.)
+     * Type of the field: text, text-multi-line, rich-text, numeric, currency,
+     * percent, rating, date, datetime, checkbox, user, email, url, phone, address, file
      */
     field_type: string;
     /**
-     * Description of the field
+     * Help text shown to users when editing the field (stored as fieldHelp)
      */
     description?: string;
     /**
@@ -60,9 +61,9 @@ export interface CreateFieldResult {
      */
     fieldType: string;
     /**
-     * The description of the created field
+     * Help text for the field (shown to users when editing)
      */
-    description?: string;
+    fieldHelp?: string;
     /**
      * The ID of the table the field was created in
      */

package/dist/tools/fields/create_field.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateFieldTool = void 0;
 const base_1 = require("../base");
 const logger_1 = require("../../utils/logger");
-const logger = (0, logger_1.createLogger)('CreateFieldTool');
+const logger = (0, logger_1.createLogger)("CreateFieldTool");
 /**
  * Tool for creating a new field in a Quickbase table
  */
@@ -14,36 +14,42 @@ class CreateFieldTool extends base_1.BaseTool {
      */
     constructor(client) {
         super(client);
-        this.name = 'create_field';
-        this.description = 'Creates a new field in a Quickbase table';
+        this.name = "create_field";
+        this.description = "Creates a new field in a Quickbase table. " +
+            "Valid field_type values: text, text-multi-line, text-multiple-choice, rich-text, " +
+            "numeric, currency, percent, rating, date, datetime, timestamp, timeofday, duration, " +
+            "checkbox, user, multiuser, email, url, phone, address, file. " +
+            "Use options to set field properties like maxLength, defaultValue, numLines, etc.";
         /**
          * Parameter schema for create_field
          */
         this.paramSchema = {
-            type: 'object',
+            type: "object",
             properties: {
                 table_id: {
-                    type: 'string',
-                    description: 'The ID of the table'
+                    type: "string",
+                    description: "The ID of the table (e.g., 'bqx7xkw3r')",
                 },
                 field_name: {
-                    type: 'string',
-                    description: 'Name of the field'
+                    type: "string",
+                    description: "Display label for the field",
                 },
                 field_type: {
-                    type: 'string',
-                    description: 'Type of the field (e.g., text, number, date)'
+                    type: "string",
+                    description: "Field type: text, text-multi-line, rich-text, numeric, currency, " +
+                        "percent, rating, date, datetime, checkbox, user, email, url, phone, address, file",
                 },
                 description: {
-                    type: 'string',
-                    description: 'Description of the field'
+                    type: "string",
+                    description: "Help text shown to users when editing the field (stored as fieldHelp)",
                 },
                 options: {
-                    type: 'object',
-                    description: 'Additional field options'
-                }
+                    type: "object",
+                    description: "Field properties: appearsByDefault, findEnabled, required, unique, " +
+                        "maxLength (text), numLines (multi-line), defaultValue, etc.",
+                },
             },
-            required: ['table_id', 'field_name', 'field_type']
+            required: ["table_id", "field_name", "field_type"],
         };
     }
     /**
@@ -53,48 +59,52 @@ class CreateFieldTool extends base_1.BaseTool {
      */
     async run(params) {
         const { table_id, field_name, field_type, description, options } = params;
-        logger.info('Creating new field in Quickbase table', {
+        logger.info("Creating new field in Quickbase table", {
             tableId: table_id,
             fieldName: field_name,
-            fieldType: field_type
+            fieldType: field_type,
         });
         // Prepare request body
+        // Note: Quickbase API uses 'fieldHelp' at root level for help text (not 'description')
         const body = {
             label: field_name,
             fieldType: field_type,
-            description: description || ''
         };
+        // Add fieldHelp if description provided (maps to root-level fieldHelp)
+        if (description) {
+            body.fieldHelp = description;
+        }
         // Add properties if provided
-        if (options) {
+        if (options && Object.keys(options).length > 0) {
             body.properties = { ...options };
         }
         // Create the field
         const response = await this.client.request({
-            method: 'POST',
+            method: "POST",
             path: `/fields?tableId=${table_id}`,
-            body
+            body,
         });
         if (!response.success || !response.data) {
-            logger.error('Failed to create field', {
+            logger.error("Failed to create field", {
                 error: response.error,
                 tableId: table_id,
-                fieldName: field_name
+                fieldName: field_name,
             });
-            throw new Error(response.error?.message || 'Failed to create field');
+            throw new Error(response.error?.message || "Failed to create field");
         }
         const field = response.data;
-        logger.info('Successfully created field', {
+        logger.info("Successfully created field", {
             fieldId: field.id,
             tableId: table_id,
-            fieldName: field.label
+            fieldName: field.label,
         });
         return {
             fieldId: field.id,
             label: field.label,
             fieldType: field.fieldType,
-            description: field.description,
+            fieldHelp: field.fieldHelp,
             tableId: table_id,
-            ...field
+            ...field,
         };
     }
 }

package/dist/tools/fields/create_field.js.map

@@ -1 +1 @@
-{"version":3,"file":"create_field.js","sourceRoot":"","sources":["../../../src/tools/fields/create_field.ts"],"names":[],"mappings":";;;AAAA,kCAAmC;AAEnC,+CAAkD;AAElD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,iBAAiB,CAAC,CAAC;AAqG/C;;GAEG;AACH,MAAa,eAAgB,SAAQ,eAA8C;IAkCjF;;;OAGG;IACH,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QAtCT,SAAI,GAAG,cAAc,CAAC;QACtB,gBAAW,GAAG,0CAA0C,CAAC;QAEhE;;WAEG;QACI,gBAAW,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qBAAqB;iBACnC;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mBAAmB;iBACjC;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC5D;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC;SACnD,CAAC;IAQF,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,GAAG,CAAC,MAAyB;QAC3C,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAE1E,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE;YACnD,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,UAAU;YACrB,SAAS,EAAE,UAAU;SACtB,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,IAAI,GAAwB;YAChC,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE,UAAU;YACrB,WAAW,EAAE,WAAW,IAAI,EAAE;SAC/B,CAAC;QAEF,6BAA6B;QAC7B,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,UAAU,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QACnC,CAAC;QAED,mBAAmB;QACnB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACzC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,mBAAmB,QAAQ,EAAE;YACnC,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;gBACrC,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,OAAO,EAAE,QAAQ;gBACjB,SAAS,EAAE,UAAU;aACtB,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,wBAAwB,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAA2B,CAAC;QAEnD,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;YACxC,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,KAAK,CAAC,KAAK;SACvB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,OAAO,EAAE,QAAQ;YACjB,GAAG,KAAK;SACT,CAAC;IACJ,CAAC;CACF;AArGD,0CAqGC"}
+{"version":3,"file":"create_field.js","sourceRoot":"","sources":["../../../src/tools/fields/create_field.ts"],"names":[],"mappings":"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"}

package/dist/tools/fields/delete_field.d.ts

@@ -0,0 +1,79 @@
+import { BaseTool } from "../base";
+import { QuickbaseClient } from "../../client/quickbase";
+/**
+ * Parameters for delete_field tool
+ */
+export interface DeleteFieldParams {
+    /**
+     * The ID of the table containing the field
+     */
+    table_id: string;
+    /**
+     * The ID of the field to delete
+     */
+    field_id: string;
+    /**
+     * Optional explicit confirmation for deletion
+     */
+    confirm_deletion?: boolean;
+}
+/**
+ * Response from deleting a field
+ */
+export interface DeleteFieldResult {
+    /**
+     * The ID of the deleted field
+     */
+    deletedFieldId: string;
+    /**
+     * The ID of the table the field was deleted from
+     */
+    tableId: string;
+    /**
+     * Confirmation message
+     */
+    message: string;
+}
+/**
+ * Tool for deleting a field from a Quickbase table.
+ *
+ * WARNING: This operation is destructive and cannot be undone.
+ * All data stored in the field will be permanently lost.
+ * System fields (IDs 1-5) cannot be deleted.
+ */
+export declare class DeleteFieldTool extends BaseTool<DeleteFieldParams, DeleteFieldResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for delete_field
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            field_id: {
+                type: string;
+                description: string;
+            };
+            confirm_deletion: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the delete_field tool
+     * @param params Tool parameters
+     * @returns Deletion confirmation
+     */
+    protected run(params: DeleteFieldParams): Promise<DeleteFieldResult>;
+}

package/dist/tools/fields/delete_field.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteFieldTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)("DeleteFieldTool");
+/**
+ * System field IDs that cannot be deleted
+ * 1 = Record ID
+ * 2 = Date Created
+ * 3 = Date Modified
+ * 4 = Record Owner
+ * 5 = Last Modified By
+ */
+const SYSTEM_FIELD_IDS = ["1", "2", "3", "4", "5"];
+/**
+ * Tool for deleting a field from a Quickbase table.
+ *
+ * WARNING: This operation is destructive and cannot be undone.
+ * All data stored in the field will be permanently lost.
+ * System fields (IDs 1-5) cannot be deleted.
+ */
+class DeleteFieldTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = "delete_field";
+        this.description = "Deletes a field from a Quickbase table. WARNING: This operation is destructive and cannot be undone. All data in the field will be permanently lost. System fields (Record ID, Date Created, Date Modified, Record Owner, Last Modified By) cannot be deleted.";
+        /**
+         * Parameter schema for delete_field
+         */
+        this.paramSchema = {
+            type: "object",
+            properties: {
+                table_id: {
+                    type: "string",
+                    description: "The ID of the Quickbase table containing the field",
+                },
+                field_id: {
+                    type: "string",
+                    description: "The ID of the field to delete",
+                },
+                confirm_deletion: {
+                    type: "boolean",
+                    description: "Optional explicit confirmation for deletion (recommended for safety)",
+                },
+            },
+            required: ["table_id", "field_id"],
+        };
+    }
+    /**
+     * Run the delete_field tool
+     * @param params Tool parameters
+     * @returns Deletion confirmation
+     */
+    async run(params) {
+        const { table_id, field_id } = params;
+        logger.info("Attempting to delete field from Quickbase table", {
+            tableId: table_id,
+            fieldId: field_id,
+        });
+        // System field protection - reject field IDs 1-5
+        if (SYSTEM_FIELD_IDS.includes(field_id)) {
+            logger.warn("Attempted to delete system field", {
+                tableId: table_id,
+                fieldId: field_id,
+            });
+            throw new Error("Cannot delete system fields (Record ID, Date Created, Date Modified, Record Owner, Last Modified By). Field IDs 1-5 are protected.");
+        }
+        // Delete the field
+        // Quickbase API uses DELETE /fields?tableId=... with fieldIds array in body
+        const response = await this.client.request({
+            method: "DELETE",
+            path: `/fields?tableId=${table_id}`,
+            body: {
+                fieldIds: [parseInt(field_id, 10)],
+            },
+        });
+        if (!response.success) {
+            logger.error("Failed to delete field", {
+                error: response.error,
+                tableId: table_id,
+                fieldId: field_id,
+            });
+            throw new Error(response.error?.message || "Failed to delete field");
+        }
+        // Invalidate cache after successful deletion
+        this.client.invalidateCache(`fields:${table_id}`);
+        this.client.invalidateCache(`field:${table_id}:${field_id}`);
+        logger.info("Successfully deleted field", {
+            fieldId: field_id,
+            tableId: table_id,
+        });
+        return {
+            deletedFieldId: field_id,
+            tableId: table_id,
+            message: `Field ${field_id} has been successfully deleted from table ${table_id}.`,
+        };
+    }
+}
+exports.DeleteFieldTool = DeleteFieldTool;
+//# sourceMappingURL=delete_field.js.map

package/dist/tools/fields/delete_field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_field.js","sourceRoot":"","sources":["../../../src/tools/fields/delete_field.ts"],"names":[],"mappings":";;;AAAA,kCAAmC;AAEnC,+CAAkD;AAElD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,iBAAiB,CAAC,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AA0CnD;;;;;;GAMG;AACH,MAAa,eAAgB,SAAQ,eAGpC;IA4BC;;;OAGG;IACH,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QAhCT,SAAI,GAAG,cAAc,CAAC;QACtB,gBAAW,GAChB,gQAAgQ,CAAC;QAEnQ;;WAEG;QACI,gBAAW,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oDAAoD;iBAClE;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,sEAAsE;iBACzE;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;SACnC,CAAC;IAQF,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,GAAG,CAAC,MAAyB;QAC3C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAEtC,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE;YAC7D,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QAEH,iDAAiD;QACjD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;gBAC9C,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CACb,oIAAoI,CACrI,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACzC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,mBAAmB,QAAQ,EAAE;YACnC,IAAI,EAAE;gBACJ,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;gBACrC,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,wBAAwB,CAAC,CAAC;QACvE,CAAC;QAED,6CAA6C;QAC7C,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,SAAS,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC;QAE7D,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;YACxC,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QAEH,OAAO;YACL,cAAc,EAAE,QAAQ;YACxB,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,SAAS,QAAQ,6CAA6C,QAAQ,GAAG;SACnF,CAAC;IACJ,CAAC;CACF;AAjGD,0CAiGC"}

package/dist/tools/fields/get_field.d.ts

@@ -0,0 +1,91 @@
+import { BaseTool } from "../base";
+import { QuickbaseClient } from "../../client/quickbase";
+/**
+ * Parameters for get_field tool
+ */
+export interface GetFieldParams {
+    /**
+     * The ID of the table containing the field
+     */
+    table_id: string;
+    /**
+     * The ID of the field to retrieve
+     */
+    field_id: string;
+}
+/**
+ * Response from getting a field
+ */
+export interface GetFieldResult {
+    /**
+     * The ID of the field
+     */
+    fieldId: string;
+    /**
+     * The label (display name) of the field
+     */
+    label: string;
+    /**
+     * The type of the field
+     */
+    fieldType: string;
+    /**
+     * The description of the field
+     */
+    description?: string;
+    /**
+     * Whether the field is required
+     */
+    required?: boolean;
+    /**
+     * Whether the field is unique
+     */
+    unique?: boolean;
+    /**
+     * Additional properties of the field
+     */
+    properties?: Record<string, any>;
+    /**
+     * The ID of the table containing the field
+     */
+    tableId: string;
+    /**
+     * Additional details about the field
+     */
+    [key: string]: any;
+}
+/**
+ * Tool for retrieving detailed information about a single field by ID
+ */
+export declare class GetFieldTool extends BaseTool<GetFieldParams, GetFieldResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for get_field
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            field_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the get_field tool
+     * @param params Tool parameters
+     * @returns Field information
+     */
+    protected run(params: GetFieldParams): Promise<GetFieldResult>;
+}

package/dist/tools/fields/get_field.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetFieldTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)("GetFieldTool");
+/**
+ * Tool for retrieving detailed information about a single field by ID
+ */
+class GetFieldTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = "get_field";
+        this.description = "Retrieves detailed information about a single field in a Quickbase table by its field ID";
+        /**
+         * Parameter schema for get_field
+         */
+        this.paramSchema = {
+            type: "object",
+            properties: {
+                table_id: {
+                    type: "string",
+                    description: "The ID of the Quickbase table containing the field",
+                },
+                field_id: {
+                    type: "string",
+                    description: "The ID of the field to retrieve",
+                },
+            },
+            required: ["table_id", "field_id"],
+        };
+    }
+    /**
+     * Run the get_field tool
+     * @param params Tool parameters
+     * @returns Field information
+     */
+    async run(params) {
+        const { table_id, field_id } = params;
+        logger.info("Retrieving field from Quickbase table", {
+            tableId: table_id,
+            fieldId: field_id,
+        });
+        // Get the field
+        const response = await this.client.request({
+            method: "GET",
+            path: `/fields/${field_id}?tableId=${table_id}`,
+        });
+        if (!response.success || !response.data) {
+            logger.error("Failed to retrieve field", {
+                error: response.error,
+                tableId: table_id,
+                fieldId: field_id,
+            });
+            throw new Error(response.error?.message || "Failed to retrieve field");
+        }
+        const field = response.data;
+        logger.info("Successfully retrieved field", {
+            fieldId: field.id,
+            tableId: table_id,
+            label: field.label,
+            fieldType: field.fieldType,
+        });
+        return {
+            fieldId: field.id,
+            label: field.label,
+            fieldType: field.fieldType,
+            description: field.description,
+            required: field.required,
+            unique: field.unique,
+            properties: field.properties,
+            tableId: table_id,
+            ...field,
+        };
+    }
+}
+exports.GetFieldTool = GetFieldTool;
+//# sourceMappingURL=get_field.js.map

package/dist/tools/fields/get_field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_field.js","sourceRoot":"","sources":["../../../src/tools/fields/get_field.ts"],"names":[],"mappings":";;;AAAA,kCAAmC;AAEnC,+CAAkD;AAElD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,cAAc,CAAC,CAAC;AAmE5C;;GAEG;AACH,MAAa,YAAa,SAAQ,eAAwC;IAuBxE;;;OAGG;IACH,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QA3BT,SAAI,GAAG,WAAW,CAAC;QACnB,gBAAW,GAChB,0FAA0F,CAAC;QAE7F;;WAEG;QACI,gBAAW,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oDAAoD;iBAClE;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;SACnC,CAAC;IAQF,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,GAAG,CAAC,MAAsB;QACxC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAEtC,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE;YACnD,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QAEH,gBAAgB;QAChB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACzC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,WAAW,QAAQ,YAAY,QAAQ,EAAE;SAChD,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE;gBACvC,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,0BAA0B,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAA2B,CAAC;QAEnD,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;YAC1C,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,QAAQ;YACjB,GAAG,KAAK;SACT,CAAC;IACJ,CAAC;CACF;AAhFD,oCAgFC"}

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

@@ -1,8 +1,10 @@
-import { QuickbaseClient } from '../../client/quickbase';
+import { QuickbaseClient } from "../../client/quickbase";
 /**
  * Register all field management tools with the registry
  * @param client Quickbase client
  */
 export declare function registerFieldTools(client: QuickbaseClient): void;
-export * from './create_field';
-export * from './update_field';
+export * from "./create_field";
+export * from "./get_field";
+export * from "./update_field";
+export * from "./delete_field";