@rashidazarang/airtable-mcp 3.0.0 → 3.2.5

package/dist/typescript/app/logger.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const LEVEL_ORDER = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3
+};
+class Logger {
+    constructor(level, context = {}) {
+        this.level = level;
+        this.context = context;
+    }
+    child(context) {
+        return new Logger(this.level, { ...this.context, ...context });
+    }
+    error(message, metadata = {}) {
+        this.log('error', message, metadata);
+    }
+    warn(message, metadata = {}) {
+        this.log('warn', message, metadata);
+    }
+    info(message, metadata = {}) {
+        this.log('info', message, metadata);
+    }
+    debug(message, metadata = {}) {
+        this.log('debug', message, metadata);
+    }
+    log(level, message, metadata) {
+        if (LEVEL_ORDER[level] > LEVEL_ORDER[this.level]) {
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        const output = {
+            timestamp,
+            level,
+            message,
+            ...this.context,
+            ...(Object.keys(metadata).length > 0 ? { metadata } : {})
+        };
+        // eslint-disable-next-line no-console
+        console.log(JSON.stringify(output));
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/typescript/app/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/typescript/app/logger.ts"],"names":[],"mappings":";;;AAEA,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAIF,MAAa,MAAM;IAIjB,YAAY,KAAe,EAAE,UAAuB,EAAE;QACpD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAoB;QACxB,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,WAAwB,EAAE;QAC/C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,WAAwB,EAAE;QAC9C,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,WAAwB,EAAE;QAC9C,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,WAAwB,EAAE;QAC/C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,QAAqB;QACjE,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG;YACb,SAAS;YACT,KAAK;YACL,OAAO;YACP,GAAG,IAAI,CAAC,OAAO;YACf,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1D,CAAC;QAEF,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,CAAC;CACF;AA9CD,wBA8CC"}

package/dist/typescript/app/rateLimiter.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiter = void 0;
+const promises_1 = require("node:timers/promises");
+/**
+ * Lightweight token-based rate limiter to enforce Airtable quotas.
+ * Maintains per-key queues to preserve ordering and fairness.
+ */
+class RateLimiter {
+    constructor({ maxRequestsPerSecond }) {
+        this.lockByKey = new Map();
+        this.nextAvailableByKey = new Map();
+        if (maxRequestsPerSecond <= 0) {
+            throw new Error('maxRequestsPerSecond must be greater than zero');
+        }
+        this.minIntervalMs = Math.ceil(1000 / maxRequestsPerSecond);
+    }
+    async schedule(key) {
+        const previous = this.lockByKey.get(key) ?? Promise.resolve();
+        let release = () => undefined;
+        const current = new Promise((resolve) => {
+            release = resolve;
+        });
+        this.lockByKey.set(key, previous.then(() => current));
+        await previous;
+        const now = Date.now();
+        const availableAt = this.nextAvailableByKey.get(key) ?? now;
+        const waitMs = Math.max(availableAt - now, 0);
+        if (waitMs > 0) {
+            await (0, promises_1.setTimeout)(waitMs);
+        }
+        this.nextAvailableByKey.set(key, Date.now() + this.minIntervalMs);
+        release();
+    }
+}
+exports.RateLimiter = RateLimiter;
+//# sourceMappingURL=rateLimiter.js.map

package/dist/typescript/app/rateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.js","sourceRoot":"","sources":["../../../src/typescript/app/rateLimiter.ts"],"names":[],"mappings":";;;AAAA,mDAA2D;AAE3D;;;GAGG;AACH,MAAa,WAAW;IAKtB,YAAY,EAAE,oBAAoB,EAAoC;QAHrD,cAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;QAC7C,uBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;QAG9D,IAAI,oBAAoB,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC9D,IAAI,OAAO,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,GAAG,CAChB,GAAG,EACH,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAC7B,CAAC;QAEF,MAAM,QAAQ,CAAC;QAEf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAA,qBAAK,EAAC,MAAM,CAAC,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AApCD,kCAoCC"}

package/dist/typescript/app/tools/create.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCreateTool = registerCreateTool;
+const types_1 = require("../types");
+const handleError_1 = require("./handleError");
+function chunk(arr, size) {
+    const out = [];
+    for (let i = 0; i < arr.length; i += size)
+        out.push(arr.slice(i, i + size));
+    return out;
+}
+function registerCreateTool(server, ctx) {
+    server.registerTool('create', {
+        description: 'Create Airtable records (requires diff-before-write via dryRun first).',
+        inputSchema: types_1.createInputSchema.shape,
+        outputSchema: types_1.createOutputSchema.shape
+    }, async (raw) => {
+        try {
+            const args = types_1.createInputSchema.parse(raw);
+            ctx.governance.ensureOperationAllowed('create');
+            ctx.governance.ensureBaseAllowed(args.baseId);
+            ctx.governance.ensureTableAllowed(args.baseId, args.table);
+            const logger = ctx.logger.child({ tool: 'create', baseId: args.baseId, table: args.table });
+            if (args.dryRun) {
+                const structuredContent = {
+                    diff: { added: args.records.length, updated: 0, unchanged: 0 },
+                    dryRun: true,
+                    records: args.records.map((r) => ({ id: 'pending', fields: r.fields }))
+                };
+                return { structuredContent, content: [] };
+            }
+            const chunks = chunk(args.records, 10);
+            const aggregated = [];
+            for (let i = 0; i < chunks.length; i++) {
+                const body = { records: chunks[i], typecast: args.typecast ?? false };
+                const headerKey = args.idempotencyKey ? `${args.idempotencyKey}:${i}` : undefined;
+                const response = await ctx.airtable.createRecords(args.baseId, args.table, body, headerKey);
+                if (Array.isArray(response?.records))
+                    aggregated.push(...response.records);
+            }
+            const structuredContent = {
+                diff: { added: aggregated.length, updated: 0, unchanged: 0 },
+                records: aggregated.map((r) => ({ id: String(r.id), fields: r.fields || {} })),
+                dryRun: false
+            };
+            logger.info('Create completed', { added: aggregated.length });
+            return { structuredContent, content: [] };
+        }
+        catch (error) {
+            return (0, handleError_1.handleToolError)('create', error, ctx);
+        }
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/typescript/app/tools/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../src/typescript/app/tools/create.ts"],"names":[],"mappings":";;AAgBA,gDAiDC;AA/DD,oCAKkB;AAClB,+CAAgD;AAEhD,SAAS,KAAK,CAAI,GAAQ,EAAE,IAAY;IACtC,MAAM,GAAG,GAAU,EAAE,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC5E,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAiB,EAAE,GAAe;IACnE,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;QACE,WAAW,EAAE,wEAAwE;QACrF,WAAW,EAAE,yBAAiB,CAAC,KAAK;QACpC,YAAY,EAAE,0BAAkB,CAAC,KAAK;KACvC,EACD,KAAK,EAAE,GAAgB,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,yBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;YAChD,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9C,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAE3D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAE5F,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,iBAAiB,GAAiB;oBACtC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;oBAC9D,MAAM,EAAE,IAAI;oBACZ,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;iBACxE,CAAC;gBACF,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAAW,EAAE,CAAC;YACrD,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACvC,MAAM,UAAU,GAAU,EAAE,CAAC;YAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvC,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC;gBACtE,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAClF,MAAM,QAAQ,GAAQ,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;gBACjG,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC;oBAAE,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC7E,CAAC;YAED,MAAM,iBAAiB,GAAiB;gBACtC,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;gBAC5D,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9E,MAAM,EAAE,KAAK;aACd,CAAC;YAEF,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAAW,EAAE,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,6BAAe,EAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/typescript/app/tools/describe.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDescribeTool = registerDescribeTool;
+const types_1 = require("../types");
+const errors_1 = require("../../errors");
+const handleError_1 = require("./handleError");
+function normalizeField(raw) {
+    const source = raw;
+    const field = {
+        id: String(source?.id ?? ''),
+        name: String(source?.name ?? ''),
+        type: String(source?.type ?? '')
+    };
+    if (source?.description && typeof source.description === 'string') {
+        field.description = source.description;
+    }
+    if (source?.options && typeof source.options === 'object') {
+        field.options = source.options;
+    }
+    return field;
+}
+function normalizeView(raw) {
+    const source = raw;
+    const view = {
+        id: String(source?.id ?? ''),
+        name: String(source?.name ?? '')
+    };
+    if (source?.type && typeof source.type === 'string') {
+        view.type = source.type;
+    }
+    return view;
+}
+function normalizeTable(raw, { includeFields, includeViews }) {
+    const source = raw;
+    const table = {
+        id: String(source?.id ?? ''),
+        name: String(source?.name ?? '')
+    };
+    if (source?.primaryFieldId && typeof source.primaryFieldId === 'string') {
+        table.primaryFieldId = source.primaryFieldId;
+    }
+    if (includeFields && Array.isArray(source?.fields)) {
+        table.fields = source.fields.map((field) => normalizeField(field));
+    }
+    if (includeViews && Array.isArray(source?.views)) {
+        table.views = source.views.map((view) => normalizeView(view));
+    }
+    return table;
+}
+function registerDescribeTool(server, ctx) {
+    server.registerTool('describe', {
+        description: 'Describe Airtable base or table schema.',
+        inputSchema: types_1.describeInputShape,
+        outputSchema: types_1.describeOutputSchema.shape
+    }, async (args, _extra) => {
+        try {
+            const input = types_1.describeInputSchema.parse(args);
+            ctx.governance.ensureOperationAllowed('describe');
+            ctx.governance.ensureBaseAllowed(input.baseId);
+            const includeFields = input.includeFields ?? true;
+            const includeViews = input.includeViews ?? false;
+            const logger = ctx.logger.child({
+                tool: 'describe',
+                baseId: input.baseId,
+                scope: input.scope
+            });
+            const [baseInfo, tableInfo] = await Promise.all([
+                ctx.airtable.getBase(input.baseId),
+                ctx.airtable.listTables(input.baseId)
+            ]);
+            const baseName = typeof baseInfo?.name === 'string'
+                ? String(baseInfo.name)
+                : input.baseId;
+            const rawTables = Array.isArray(tableInfo?.tables)
+                ? tableInfo.tables
+                : [];
+            const tables = rawTables
+                .filter((rawTable) => {
+                const record = rawTable;
+                const tableId = typeof record.id === 'string' ? record.id : '';
+                const tableName = typeof record.name === 'string' ? record.name : '';
+                const idAllowed = tableId
+                    ? ctx.governance.isTableAllowed(input.baseId, tableId)
+                    : false;
+                const nameAllowed = tableName
+                    ? ctx.governance.isTableAllowed(input.baseId, tableName)
+                    : false;
+                return idAllowed || nameAllowed;
+            })
+                .map((table) => normalizeTable(table, { includeFields, includeViews }));
+            let selectedTables = tables;
+            if (input.scope === 'table') {
+                const target = tables.find((tableRecord) => String(tableRecord.id) === input.table ||
+                    String(tableRecord.name).toLowerCase() === input.table?.toLowerCase());
+                if (!target) {
+                    const context = { baseId: input.baseId };
+                    if (input.table) {
+                        context.table = input.table;
+                    }
+                    throw new errors_1.NotFoundError(`Table ${input.table} not found in base ${input.baseId}`, {
+                        context
+                    });
+                }
+                const targetId = String(target.id);
+                const targetName = String(target.name);
+                if (!ctx.governance.isTableAllowed(input.baseId, targetId) &&
+                    !ctx.governance.isTableAllowed(input.baseId, targetName)) {
+                    const context = { baseId: input.baseId };
+                    if (input.table) {
+                        context.table = input.table;
+                    }
+                    throw new errors_1.GovernanceError(`Table ${input.table} is not allowed in base ${input.baseId}`, {
+                        context
+                    });
+                }
+                selectedTables = [target];
+            }
+            const structuredContent = {
+                base: {
+                    id: input.baseId,
+                    name: baseName
+                },
+                tables: selectedTables
+            };
+            if (input.scope === 'base' && includeViews) {
+                structuredContent.views = rawTables
+                    .flatMap((table) => {
+                    const record = table;
+                    return Array.isArray(record.views) ? record.views : [];
+                })
+                    .map((view) => normalizeView(view));
+            }
+            logger.debug('Describe completed', {
+                tableCount: selectedTables.length
+            });
+            return {
+                structuredContent,
+                content: []
+            };
+        }
+        catch (error) {
+            return (0, handleError_1.handleToolError)('describe', error, ctx);
+        }
+    });
+}
+//# sourceMappingURL=describe.js.map

package/dist/typescript/app/tools/describe.js.map

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

package/dist/typescript/app/tools/handleError.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleToolError = handleToolError;
+const errors_1 = require("../../errors");
+function toUserMessage(error) {
+    switch (error.code) {
+        case 'RateLimited':
+            return 'Airtable rate limit exceeded. Please retry after backoff.';
+        case 'ValidationError':
+            return 'Airtable rejected the request. Check field names and values.';
+        case 'AuthError':
+            return 'Authentication failed. Verify the Airtable token scopes and base access.';
+        case 'ConflictError':
+            return 'The record changed since it was fetched. Refresh data and review the diff.';
+        case 'NotFound':
+            return 'Requested Airtable resource was not found. Confirm the base and table identifiers.';
+        case 'GovernanceError':
+            return 'Operation blocked by governance allow-lists.';
+        default:
+            return 'Unexpected Airtable error. Please retry or check the exceptions queue.';
+    }
+}
+function handleToolError(toolName, error, ctx) {
+    if (error instanceof errors_1.AirtableBrainError) {
+        ctx.logger.error(`${toolName} failed`, {
+            code: error.code,
+            status: error.status,
+            retryAfterMs: error.retryAfterMs
+        });
+        ctx.exceptions.record(error, `${toolName} failed`, error.message);
+        return {
+            isError: true,
+            content: [
+                {
+                    type: 'text',
+                    text: toUserMessage(error)
+                }
+            ]
+        };
+    }
+    ctx.logger.error(`${toolName} failed with unknown error`, {
+        error: error instanceof Error ? error.message : String(error)
+    });
+    return {
+        isError: true,
+        content: [
+            {
+                type: 'text',
+                text: 'Unexpected server error. Check logs for details.'
+            }
+        ]
+    };
+}
+//# sourceMappingURL=handleError.js.map

package/dist/typescript/app/tools/handleError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleError.js","sourceRoot":"","sources":["../../../../src/typescript/app/tools/handleError.ts"],"names":[],"mappings":";;AAsBA,0CAgCC;AAtDD,yCAAkD;AAGlD,SAAS,aAAa,CAAC,KAAyB;IAC9C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,aAAa;YAChB,OAAO,2DAA2D,CAAC;QACrE,KAAK,iBAAiB;YACpB,OAAO,8DAA8D,CAAC;QACxE,KAAK,WAAW;YACd,OAAO,0EAA0E,CAAC;QACpF,KAAK,eAAe;YAClB,OAAO,4EAA4E,CAAC;QACtF,KAAK,UAAU;YACb,OAAO,oFAAoF,CAAC;QAC9F,KAAK,iBAAiB;YACpB,OAAO,8CAA8C,CAAC;QACxD;YACE,OAAO,wEAAwE,CAAC;IACpF,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAAC,QAAgB,EAAE,KAAc,EAAE,GAAe;IAC/E,IAAI,KAAK,YAAY,2BAAkB,EAAE,CAAC;QACxC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,SAAS,EAAE;YACrC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,YAAY,EAAE,KAAK,CAAC,YAAY;SACjC,CAAC,CAAC;QACH,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,QAAQ,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAClE,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC;iBAC3B;aACF;SACF,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,4BAA4B,EAAE;QACxD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAC9D,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,kDAAkD;aACzD;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/typescript/app/tools/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAllTools = registerAllTools;
+const listBases_1 = require("./listBases");
+const describe_1 = require("./describe");
+const query_1 = require("./query");
+const listGovernance_1 = require("./listGovernance");
+const listExceptions_1 = require("./listExceptions");
+const create_1 = require("./create");
+const update_1 = require("./update");
+const upsert_1 = require("./upsert");
+const webhooks_1 = require("./webhooks");
+function registerAllTools(server, ctx) {
+    (0, listBases_1.registerListBasesTool)(server, ctx);
+    (0, describe_1.registerDescribeTool)(server, ctx);
+    (0, query_1.registerQueryTool)(server, ctx);
+    (0, listGovernance_1.registerGovernanceTool)(server, ctx);
+    (0, listExceptions_1.registerExceptionsTool)(server, ctx);
+    (0, create_1.registerCreateTool)(server, ctx);
+    (0, update_1.registerUpdateTool)(server, ctx);
+    (0, upsert_1.registerUpsertTool)(server, ctx);
+    (0, webhooks_1.registerWebhookTools)(server, ctx);
+}
+//# sourceMappingURL=index.js.map

package/dist/typescript/app/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/typescript/app/tools/index.ts"],"names":[],"mappings":";;AAYA,4CAUC;AApBD,2CAAoD;AACpD,yCAAkD;AAClD,mCAA4C;AAC5C,qDAA0D;AAC1D,qDAA0D;AAC1D,qCAA8C;AAC9C,qCAA8C;AAC9C,qCAA8C;AAC9C,yCAAkD;AAElD,SAAgB,gBAAgB,CAAC,MAAiB,EAAE,GAAe;IACjE,IAAA,iCAAqB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,IAAA,+BAAoB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,IAAA,yBAAiB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAA,uCAAsB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,IAAA,uCAAsB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,IAAA,2BAAkB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,IAAA,2BAAkB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,IAAA,2BAAkB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,IAAA,+BAAoB,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/typescript/app/tools/listBases.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerListBasesTool = registerListBasesTool;
+const zod_1 = require("zod");
+const handleError_1 = require("./handleError");
+// Schema for list_bases output
+const listBasesOutputSchema = zod_1.z.object({
+    bases: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        name: zod_1.z.string(),
+        permissionLevel: zod_1.z.string().optional()
+    }))
+});
+function registerListBasesTool(server, ctx) {
+    server.registerTool('list_bases', {
+        description: 'List all accessible Airtable bases with their names, IDs, and permission levels',
+        inputSchema: {},
+        outputSchema: listBasesOutputSchema.shape
+    }, async (_args, _extra) => {
+        try {
+            ctx.logger.info('Listing accessible Airtable bases');
+            const response = await ctx.airtable.listBases();
+            const bases = response.bases;
+            if (!bases || bases.length === 0) {
+                const structuredContent = {
+                    bases: []
+                };
+                return {
+                    structuredContent,
+                    content: []
+                };
+            }
+            const normalizedBases = bases.map((base) => ({
+                id: String(base.id ?? ''),
+                name: String(base.name ?? ''),
+                permissionLevel: base.permissionLevel ? String(base.permissionLevel) : undefined
+            }));
+            const structuredContent = {
+                bases: normalizedBases
+            };
+            ctx.logger.info('Successfully listed bases', { count: bases.length });
+            return {
+                structuredContent,
+                content: []
+            };
+        }
+        catch (error) {
+            return (0, handleError_1.handleToolError)('list_bases', error, ctx);
+        }
+    });
+}
+//# sourceMappingURL=listBases.js.map

package/dist/typescript/app/tools/listBases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listBases.js","sourceRoot":"","sources":["../../../../src/typescript/app/tools/listBases.ts"],"names":[],"mappings":";;AAkBA,sDA8CC;AA9DD,6BAAwB;AACxB,+CAAgD;AAEhD,+BAA+B;AAC/B,MAAM,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,OAAC,CAAC,KAAK,CACZ,OAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;QAChB,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACvC,CAAC,CACH;CACF,CAAC,CAAC;AAIH,SAAgB,qBAAqB,CAAC,MAAiB,EAAE,GAAe;IACtE,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,WAAW,EAAE,iFAAiF;QAC9F,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,qBAAqB,CAAC,KAAK;KAC1C,EACD,KAAK,EAAE,KAAc,EAAE,MAAe,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YAErD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;YAE7B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,MAAM,iBAAiB,GAAoB;oBACzC,KAAK,EAAE,EAAE;iBACV,CAAC;gBACF,OAAO;oBACL,iBAAiB;oBACjB,OAAO,EAAE,EAAW;iBACrB,CAAC;YACJ,CAAC;YAED,MAAM,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;gBAChD,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC7B,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS;aACjF,CAAC,CAAC,CAAC;YAEJ,MAAM,iBAAiB,GAAoB;gBACzC,KAAK,EAAE,eAAe;aACvB,CAAC;YAEF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAEtE,OAAO;gBACL,iBAAiB;gBACjB,OAAO,EAAE,EAAW;aACrB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,6BAAe,EAAC,YAAY,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/typescript/app/tools/listExceptions.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerExceptionsTool = registerExceptionsTool;
+const types_1 = require("../types");
+function registerExceptionsTool(server, ctx) {
+    server.registerTool('list_exceptions', {
+        description: 'List recent exceptions and remediation proposals.',
+        inputSchema: types_1.listExceptionsInputSchema.shape,
+        outputSchema: types_1.listExceptionsOutputSchema.shape
+    }, async (args) => {
+        const snapshot = ctx.exceptions.list(args);
+        return {
+            structuredContent: snapshot,
+            content: []
+        };
+    });
+}
+//# sourceMappingURL=listExceptions.js.map

package/dist/typescript/app/tools/listExceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listExceptions.js","sourceRoot":"","sources":["../../../../src/typescript/app/tools/listExceptions.ts"],"names":[],"mappings":";;AAQA,wDAgBC;AAvBD,oCAIkB;AAGlB,SAAgB,sBAAsB,CAAC,MAAiB,EAAE,GAAe;IACvE,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EAAE,mDAAmD;QAChE,WAAW,EAAE,iCAAyB,CAAC,KAAK;QAC5C,YAAY,EAAE,kCAA0B,CAAC,KAAK;KAC/C,EACD,KAAK,EAAE,IAAyB,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO;YACL,iBAAiB,EAAE,QAAQ;YAC3B,OAAO,EAAE,EAAW;SACrB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/typescript/app/tools/listGovernance.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGovernanceTool = registerGovernanceTool;
+const types_1 = require("../types");
+function registerGovernanceTool(server, ctx) {
+    server.registerTool('list_governance', {
+        description: 'Return governance allow-lists and PII masking policies.',
+        outputSchema: types_1.governanceOutputSchema.shape
+    }, async () => {
+        const snapshot = ctx.governance.getSnapshot();
+        return {
+            structuredContent: snapshot,
+            content: []
+        };
+    });
+}
+//# sourceMappingURL=listGovernance.js.map

package/dist/typescript/app/tools/listGovernance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listGovernance.js","sourceRoot":"","sources":["../../../../src/typescript/app/tools/listGovernance.ts"],"names":[],"mappings":";;AAIA,wDAeC;AAlBD,oCAAkD;AAGlD,SAAgB,sBAAsB,CAAC,MAAiB,EAAE,GAAe;IACvE,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EAAE,yDAAyD;QACtE,YAAY,EAAE,8BAAsB,CAAC,KAAK;KAC3C,EACD,KAAK,IAAI,EAAE;QACT,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QAC9C,OAAO;YACL,iBAAiB,EAAE,QAAQ;YAC3B,OAAO,EAAE,EAAW;SACrB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/typescript/app/tools/query.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerQueryTool = registerQueryTool;
+const node_crypto_1 = require("node:crypto");
+const types_1 = require("../types");
+const handleError_1 = require("./handleError");
+function maskValue(value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(() => '••••');
+    }
+    if (typeof value === 'object') {
+        return '[redacted]';
+    }
+    return '••••';
+}
+function hashValue(value) {
+    const serialized = typeof value === 'string' ? value : JSON.stringify(value ?? '');
+    return (0, node_crypto_1.createHash)('sha256').update(serialized).digest('hex');
+}
+function applyPiiPolicies(fields, policies) {
+    if (!policies.length) {
+        return fields;
+    }
+    const result = { ...fields };
+    for (const policy of policies) {
+        if (!(policy.field in result))
+            continue;
+        switch (policy.policy) {
+            case 'drop':
+                delete result[policy.field];
+                break;
+            case 'mask':
+                result[policy.field] = maskValue(result[policy.field]);
+                break;
+            case 'hash':
+                result[policy.field] = hashValue(result[policy.field]);
+                break;
+            default:
+                break;
+        }
+    }
+    return result;
+}
+function registerQueryTool(server, ctx) {
+    server.registerTool('query', {
+        description: 'Query Airtable records with filtering, sorting, and pagination.',
+        inputSchema: types_1.queryInputShape,
+        outputSchema: types_1.queryOutputSchema.shape
+    }, async (args, _extra) => {
+        try {
+            const input = types_1.queryInputSchema.parse(args);
+            ctx.governance.ensureOperationAllowed('query');
+            ctx.governance.ensureBaseAllowed(input.baseId);
+            ctx.governance.ensureTableAllowed(input.baseId, input.table);
+            const logger = ctx.logger.child({
+                tool: 'query',
+                baseId: input.baseId,
+                table: input.table
+            });
+            const queryParams = {};
+            if (input.fields) {
+                queryParams.fields = input.fields;
+            }
+            if (input.filterByFormula) {
+                queryParams.filterByFormula = input.filterByFormula;
+            }
+            if (input.view) {
+                queryParams.view = input.view;
+            }
+            if (input.pageSize) {
+                queryParams.pageSize = input.pageSize;
+            }
+            if (input.maxRecords) {
+                queryParams.maxRecords = input.maxRecords;
+            }
+            if (input.offset) {
+                queryParams.offset = input.offset;
+            }
+            if (typeof input.returnFieldsByFieldId === 'boolean') {
+                queryParams.returnFieldsByFieldId = input.returnFieldsByFieldId;
+            }
+            if (input.sorts) {
+                input.sorts.forEach((sort, index) => {
+                    queryParams[`sort[${index}][field]`] = sort.field;
+                    queryParams[`sort[${index}][direction]`] = sort.direction ?? 'asc';
+                });
+            }
+            const response = await ctx.airtable.queryRecords(input.baseId, input.table, queryParams);
+            const rawRecords = Array.isArray(response?.records)
+                ? response.records
+                : [];
+            const piiPolicies = ctx.governance.listPiiPolicies(input.baseId, input.table);
+            const sanitizedRecords = rawRecords.map((record) => {
+                const fields = typeof record.fields === 'object' && record.fields !== null ? record.fields : {};
+                return {
+                    id: String(record.id ?? ''),
+                    createdTime: record.createdTime ? String(record.createdTime) : undefined,
+                    fields: applyPiiPolicies(fields, piiPolicies)
+                };
+            });
+            const structuredContent = {
+                records: sanitizedRecords,
+                offset: typeof response?.offset === 'string' ? response.offset : undefined,
+                summary: {
+                    returned: sanitizedRecords.length,
+                    hasMore: Boolean(response?.offset)
+                }
+            };
+            logger.debug('Query completed', {
+                returned: sanitizedRecords.length,
+                hasMore: structuredContent.summary?.hasMore
+            });
+            return {
+                structuredContent,
+                content: []
+            };
+        }
+        catch (error) {
+            return (0, handleError_1.handleToolError)('query', error, ctx);
+        }
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/typescript/app/tools/query.js.map

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