@rashidazarang/airtable-mcp 3.1.0 → 3.2.8

package/bin/airtable-mcp.js

@@ -2,43 +2,23 @@
 
 const { spawn } = require('child_process');
 const path = require('path');
+const fs = require('fs');
 
-// Find the Python interpreter
-const getPythonPath = () => {
-  try {
-    const whichPython = require('child_process').execSync('which python3.10').toString().trim();
-    return whichPython;
-  } catch (e) {
-    try {
-      const whichPython = require('child_process').execSync('which python3').toString().trim();
-      return whichPython;
-    } catch (e) {
-      return 'python';
-    }
-  }
-};
+const distServer = path.join(__dirname, '..', 'dist', 'typescript', 'airtable-mcp-server.js');
 
-const pythonPath = getPythonPath();
-const serverScript = path.join(__dirname, '..', 'airtable_mcp', 'src', 'server.py');
+if (!fs.existsSync(distServer)) {
+  console.error('Airtable MCP: compiled server not found.');
+  console.error('Run `npm install && npm run build` and try again.');
+  process.exit(1);
+}
 
-// Get the arguments
 const args = process.argv.slice(2);
-
-// Construct the full command
-const serverProcess = spawn(pythonPath, [serverScript, ...args], {
+const child = spawn(process.execPath, [distServer, ...args], {
   stdio: 'inherit',
+  env: process.env,
 });
 
-// Handle process exit
-serverProcess.on('close', (code) => {
-  process.exit(code);
-});
-
-// Handle signals
-process.on('SIGINT', () => {
-  serverProcess.kill('SIGINT');
-});
+child.on('close', (code) => process.exit(code));
 
-process.on('SIGTERM', () => {
-  serverProcess.kill('SIGTERM');
-}); 
+process.on('SIGINT', () => child.kill('SIGINT'));
+process.on('SIGTERM', () => child.kill('SIGTERM'));

package/dist/typescript/airtable-mcp-server.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.start = start;
+// Import via require to avoid TS type resolution issues with deep subpath exports
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { McpServer } = require('@modelcontextprotocol/sdk/server/mcp.js');
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
+const config_1 = require("./app/config");
+const logger_1 = require("./app/logger");
+const rateLimiter_1 = require("./app/rateLimiter");
+const airtable_client_1 = require("./app/airtable-client");
+const governance_1 = require("./app/governance");
+const exceptions_1 = require("./app/exceptions");
+const tools_1 = require("./app/tools");
+const PROTOCOL_VERSION = '2024-11-05';
+function buildContext(config, rootLogger) {
+    const baseLimiter = new rateLimiter_1.RateLimiter({ maxRequestsPerSecond: 5 });
+    const patLimiter = new rateLimiter_1.RateLimiter({ maxRequestsPerSecond: 50 });
+    const airtable = new airtable_client_1.AirtableClient(config.auth.personalAccessToken, {
+        baseLimiter,
+        patLimiter,
+        logger: rootLogger.child({ component: 'airtable_client' }),
+        userAgent: `airtable-brain-mcp/${config.version}`,
+        patHash: config.auth.patHash
+    });
+    const governance = new governance_1.GovernanceService(config.governance);
+    const exceptions = new exceptions_1.ExceptionStore(config.exceptionQueueSize, rootLogger);
+    return {
+        config,
+        logger: rootLogger,
+        airtable,
+        governance,
+        exceptions
+    };
+}
+async function start() {
+    const config = (0, config_1.loadConfig)();
+    const logger = new logger_1.Logger(config.logLevel, { component: 'server' });
+    const context = buildContext(config, logger);
+    const server = new McpServer({
+        name: 'airtable-brain',
+        version: config.version,
+        protocolVersion: PROTOCOL_VERSION
+    }, {
+        capabilities: {
+            tools: {},
+            prompts: {},
+            resources: {}
+        },
+        instructions: 'Use describe and query tools for read flows. All mutations require diff review and idempotency keys.'
+    });
+    (0, tools_1.registerAllTools)(server, context);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('Airtable Brain MCP server ready', {
+        version: config.version,
+        protocolVersion: PROTOCOL_VERSION
+    });
+    const shutdown = async (signal) => {
+        logger.info('Shutting down due to signal', { signal });
+        await server.close();
+        await transport.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', () => void shutdown('SIGINT'));
+    process.on('SIGTERM', () => void shutdown('SIGTERM'));
+}
+if (typeof require !== 'undefined' && require.main === module) {
+    start().catch((error) => {
+        // eslint-disable-next-line no-console
+        console.error('Failed to start Airtable Brain MCP server:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=airtable-mcp-server.js.map

package/dist/typescript/airtable-mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"airtable-mcp-server.js","sourceRoot":"","sources":["../../src/typescript/airtable-mcp-server.ts"],"names":[],"mappings":";;;AA0CA,sBA0CC;AAlFD,kFAAkF;AAClF,8DAA8D;AAC9D,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,yCAAyC,CAAC,CAAC;AACzE,8DAA8D;AAC9D,MAAM,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,2CAA2C,CAAC,CAAC;AACtF,yCAA0C;AAC1C,yCAAsC;AACtC,mDAAgD;AAChD,2DAAuD;AACvD,iDAAqD;AACrD,iDAAkD;AAClD,uCAA+C;AAG/C,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAEtC,SAAS,YAAY,CAAC,MAAqC,EAAE,UAAkB;IAC7E,MAAM,WAAW,GAAG,IAAI,yBAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,IAAI,yBAAW,CAAC,EAAE,oBAAoB,EAAE,EAAE,EAAE,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,IAAI,gCAAc,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;QACnE,WAAW;QACX,UAAU;QACV,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;QAC1D,SAAS,EAAE,sBAAsB,MAAM,CAAC,OAAO,EAAE;QACjD,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO;KAC7B,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,8BAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,IAAI,2BAAc,CAAC,MAAM,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IAE7E,OAAO;QACL,MAAM;QACN,MAAM,EAAE,UAAU;QAClB,QAAQ;QACR,UAAU;QACV,UAAU;KACX,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,KAAK;IACzB,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEpE,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,eAAe,EAAE,gBAAgB;KAClC,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE;SACd;QACD,YAAY,EACV,sGAAsG;KACzG,CACF,CAAC;IAEF,IAAA,wBAAgB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;QAC7C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,eAAe,EAAE,gBAAgB;KAClC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACxC,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACvD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC9D,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACtB,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/typescript/app/airtable-client.js

@@ -0,0 +1,327 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirtableClient = void 0;
+const node_https_1 = __importDefault(require("node:https"));
+const node_url_1 = require("node:url");
+const promises_1 = require("node:timers/promises");
+const errors_1 = require("../errors");
+function toQueryString(query) {
+    if (!query) {
+        return '';
+    }
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            value.forEach((item) => params.append(`${key}[]`, String(item)));
+        }
+        else {
+            params.append(key, String(value));
+        }
+    }
+    const queryString = params.toString();
+    return queryString.length > 0 ? `?${queryString}` : '';
+}
+function parseRetryAfter(headers) {
+    const retryAfter = headers['retry-after'];
+    if (!retryAfter)
+        return undefined;
+    const parsedSeconds = Number(retryAfter);
+    if (!Number.isNaN(parsedSeconds)) {
+        return parsedSeconds * 1000;
+    }
+    const retryDate = new Date(retryAfter);
+    if (!Number.isNaN(retryDate.getTime())) {
+        return Math.max(retryDate.getTime() - Date.now(), 0);
+    }
+    return undefined;
+}
+class AirtableClient {
+    constructor(personalAccessToken, options) {
+        this.pat = personalAccessToken;
+        this.baseLimiter = options.baseLimiter;
+        this.patLimiter = options.patLimiter;
+        this.logger = options.logger;
+        this.userAgent = options.userAgent;
+        this.patHash = options.patHash;
+        this.maxRetries = options.maxRetries ?? 3;
+    }
+    async listBases() {
+        return this.request({
+            method: 'GET',
+            path: '/v0/meta/bases'
+        });
+    }
+    async getBase(baseId) {
+        return this.request({
+            method: 'GET',
+            path: `/v0/meta/bases/${encodeURIComponent(baseId)}`,
+            baseId
+        });
+    }
+    async listTables(baseId) {
+        return this.request({
+            method: 'GET',
+            path: `/v0/meta/bases/${encodeURIComponent(baseId)}/tables`,
+            baseId
+        });
+    }
+    async queryRecords(baseId, table, query) {
+        const requestOptions = {
+            method: 'GET',
+            path: `/v0/${encodeURIComponent(baseId)}/${encodeURIComponent(table)}`,
+            baseId
+        };
+        if (query && Object.keys(query).length > 0) {
+            requestOptions.query = query;
+        }
+        return this.request(requestOptions);
+    }
+    async createRecords(baseId, table, payload, idempotencyKey) {
+        const requestOptions = {
+            method: 'POST',
+            path: `/v0/${encodeURIComponent(baseId)}/${encodeURIComponent(table)}`,
+            baseId,
+            body: payload
+        };
+        if (idempotencyKey) {
+            requestOptions.idempotencyKey = idempotencyKey;
+        }
+        return this.request(requestOptions);
+    }
+    async updateRecords(baseId, table, payload, idempotencyKey) {
+        const requestOptions = {
+            method: 'PATCH',
+            path: `/v0/${encodeURIComponent(baseId)}/${encodeURIComponent(table)}`,
+            baseId,
+            body: payload
+        };
+        if (idempotencyKey) {
+            requestOptions.idempotencyKey = idempotencyKey;
+        }
+        return this.request(requestOptions);
+    }
+    async upsertRecords(baseId, table, payload, idempotencyKey) {
+        const requestOptions = {
+            method: 'PATCH',
+            path: `/v0/${encodeURIComponent(baseId)}/${encodeURIComponent(table)}`,
+            baseId,
+            body: payload
+        };
+        if (idempotencyKey) {
+            requestOptions.idempotencyKey = idempotencyKey;
+        }
+        return this.request(requestOptions);
+    }
+    async request(options) {
+        const { baseId } = options;
+        if (baseId) {
+            await this.baseLimiter.schedule(baseId);
+        }
+        await this.patLimiter.schedule(this.patHash);
+        return this.withRetry(() => this.performRequest(options));
+    }
+    async withRetry(fn) {
+        let attempt = 0;
+        let lastError;
+        while (attempt < this.maxRetries) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                attempt += 1;
+                if (error instanceof errors_1.RateLimitError) {
+                    const delayMs = error.retryAfterMs ?? this.backoffWithJitter(attempt);
+                    this.logger.warn('Rate limited, backing off', {
+                        attempt,
+                        delayMs
+                    });
+                    await (0, promises_1.setTimeout)(delayMs);
+                    continue;
+                }
+                if (error instanceof errors_1.InternalServerError && attempt < this.maxRetries) {
+                    const delayMs = this.backoffWithJitter(attempt);
+                    this.logger.warn('Upstream error, retrying', {
+                        attempt,
+                        delayMs
+                    });
+                    await (0, promises_1.setTimeout)(delayMs);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        if (lastError instanceof errors_1.AirtableBrainError) {
+            throw lastError.withContext({ attempt: this.maxRetries, totalAttempts: this.maxRetries });
+        }
+        throw lastError;
+    }
+    backoffWithJitter(attempt) {
+        const baseDelay = Math.min(1000 * 2 ** (attempt - 1), 8000);
+        const jitter = Math.random() * 250;
+        return baseDelay + jitter;
+    }
+    performRequest(options) {
+        const { method = 'GET', path, query, body, idempotencyKey } = options;
+        const logger = this.logger.child({
+            op: 'airtable_request',
+            method,
+            path,
+            baseId: options.baseId,
+            patHash: this.patHash
+        });
+        const queryString = toQueryString(query);
+        const url = new node_url_1.URL(`https://api.airtable.com${path}${queryString}`);
+        const payload = body === undefined ? undefined : JSON.stringify(body);
+        return new Promise((resolve, reject) => {
+            const request = node_https_1.default.request({
+                method,
+                hostname: url.hostname,
+                path: url.pathname + url.search,
+                headers: {
+                    Authorization: `Bearer ${this.pat}`,
+                    'Content-Type': 'application/json',
+                    'User-Agent': this.userAgent,
+                    ...(payload ? { 'Content-Length': Buffer.byteLength(payload) } : {}),
+                    ...(idempotencyKey ? { 'Idempotency-Key': idempotencyKey } : {})
+                }
+            }, (response) => {
+                const chunks = [];
+                response.on('data', (chunk) => {
+                    chunks.push(chunk);
+                });
+                response.on('end', () => {
+                    const rawBody = Buffer.concat(chunks).toString('utf8');
+                    let parsedBody;
+                    if (rawBody.length > 0) {
+                        try {
+                            parsedBody = JSON.parse(rawBody);
+                        }
+                        catch (error) {
+                            reject(new errors_1.InternalServerError('Failed to parse Airtable response', {
+                                cause: error,
+                                status: response.statusCode ?? 0
+                            }));
+                            return;
+                        }
+                    }
+                    const result = {
+                        status: response.statusCode ?? 0,
+                        body: parsedBody,
+                        headers: response.headers
+                    };
+                    try {
+                        if (result.status >= 200 && result.status < 300) {
+                            resolve(parsedBody);
+                            return;
+                        }
+                        reject(this.toDomainError(result, options));
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                });
+            });
+            request.on('error', (error) => {
+                logger.error('Network error calling Airtable', {
+                    error: error instanceof Error ? error.message : String(error)
+                });
+                reject(new errors_1.InternalServerError('Network error communicating with Airtable', {
+                    cause: error
+                }));
+            });
+            request.setTimeout(30000, () => {
+                request.destroy();
+                reject(new errors_1.InternalServerError('Airtable request timed out', {
+                    status: 504
+                }));
+            });
+            if (payload) {
+                request.write(payload);
+            }
+            request.end();
+        });
+    }
+    toDomainError(response, request) {
+        const { status, body, headers } = response;
+        const { type: upstreamErrorType, message: upstreamErrorMessage } = this.safeExtractErrorInfo(body);
+        const requestId = this.extractRequestId(headers);
+        const baseContext = {
+            endpoint: request.path,
+            ...(request.baseId && { baseId: request.baseId }),
+            ...(upstreamErrorType && { upstreamErrorType }),
+            ...(upstreamErrorMessage && { upstreamErrorMessage }),
+            ...(requestId && { upstreamRequestId: requestId })
+        };
+        if (status === 401 || status === 403) {
+            return new errors_1.AuthError('Authentication failed with Airtable', {
+                status,
+                context: baseContext
+            });
+        }
+        if (status === 404) {
+            return new errors_1.NotFoundError('Requested resource was not found in Airtable', {
+                status,
+                context: baseContext
+            });
+        }
+        if (status === 409) {
+            return new errors_1.ConflictError('Airtable reported a conflict', {
+                status,
+                context: baseContext
+            });
+        }
+        if (status === 400 || status === 422) {
+            return new errors_1.AirtableValidationError('Airtable validation error', {
+                status,
+                context: baseContext
+            });
+        }
+        if (status === 429) {
+            const retryAfterMs = parseRetryAfter(headers);
+            return new errors_1.RateLimitError('Airtable rate limit exceeded', {
+                status,
+                ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+                context: baseContext
+            });
+        }
+        if (status >= 500) {
+            return new errors_1.InternalServerError('Airtable returned an internal error', {
+                status,
+                context: baseContext
+            });
+        }
+        return new errors_1.InternalServerError('Unexpected Airtable response', {
+            status,
+            context: baseContext
+        });
+    }
+    safeExtractErrorInfo(body) {
+        if (body && typeof body === 'object' && 'error' in body) {
+            const error = body.error;
+            if (error && typeof error === 'object') {
+                const errorObj = error;
+                const result = {};
+                if (typeof errorObj.type === 'string') {
+                    result.type = errorObj.type;
+                }
+                if (typeof errorObj.message === 'string') {
+                    result.message = errorObj.message;
+                }
+                return result;
+            }
+        }
+        return {};
+    }
+    extractRequestId(headers) {
+        const requestId = headers['x-airtable-request-id'];
+        return typeof requestId === 'string' ? requestId : undefined;
+    }
+}
+exports.AirtableClient = AirtableClient;
+//# sourceMappingURL=airtable-client.js.map

package/dist/typescript/app/airtable-client.js.map

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

package/dist/typescript/app/config.js

@@ -0,0 +1,151 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const dotenv_1 = require("dotenv");
+const types_1 = require("./types");
+const errors_1 = require("../errors");
+const validateApiKey_1 = require("./validateApiKey");
+(0, dotenv_1.config)();
+const DEFAULT_EXCEPTION_QUEUE_SIZE = 500;
+function parseCsv(value) {
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+function hashSecret(secret) {
+    return (0, node_crypto_1.createHash)('sha256').update(secret).digest('hex').slice(0, 12);
+}
+function resolveLogLevel() {
+    const raw = (process.env.LOG_LEVEL || 'info').toLowerCase();
+    if (raw === 'error' || raw === 'warn' || raw === 'info' || raw === 'debug') {
+        return raw;
+    }
+    return 'info';
+}
+function determineAllowedBases(defaultBaseId) {
+    const fromEnv = parseCsv(process.env.AIRTABLE_ALLOWED_BASES || process.env.AIRTABLE_BASE_ALLOWLIST);
+    const baseSet = new Set();
+    if (defaultBaseId) {
+        baseSet.add(defaultBaseId);
+    }
+    fromEnv.forEach((base) => baseSet.add(base));
+    // Allow empty base list - users can use list_bases tool to discover bases
+    // and then specify them dynamically in tool calls
+    return Array.from(baseSet);
+}
+function parseAllowedTables(raw) {
+    if (!raw) {
+        return [];
+    }
+    const tables = [];
+    for (const entry of raw.split(',')) {
+        const trimmed = entry.trim();
+        if (!trimmed)
+            continue;
+        const [baseId, table] = trimmed.split(':');
+        if (!baseId || !table) {
+            throw new errors_1.GovernanceError(`Invalid AIRTABLE_ALLOWED_TABLES entry "${trimmed}". Expected format baseId:tableName.`);
+        }
+        tables.push({ baseId: baseId.trim(), table: table.trim() });
+    }
+    return tables;
+}
+function readGovernanceFile() {
+    const explicitPath = process.env.AIRTABLE_GOVERNANCE_PATH;
+    const fallbackPath = node_path_1.default.resolve(process.cwd(), 'config', 'governance.json');
+    const filePath = explicitPath || fallbackPath;
+    if (!node_fs_1.default.existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        const raw = node_fs_1.default.readFileSync(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const partialSchema = types_1.governanceOutputSchema.partial();
+        const result = partialSchema.parse(parsed);
+        return result;
+    }
+    catch (error) {
+        throw new errors_1.GovernanceError(`Failed to parse governance configuration at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function buildGovernanceSnapshot(allowedBases) {
+    const baseSnapshot = {
+        allowedBases,
+        allowedTables: [],
+        allowedOperations: ['describe', 'query', 'create', 'update', 'upsert'],
+        piiFields: [],
+        redactionPolicy: 'mask_on_inline',
+        loggingPolicy: 'minimal',
+        retentionDays: 7
+    };
+    const overrides = readGovernanceFile();
+    const envAllowedTables = parseAllowedTables(process.env.AIRTABLE_ALLOWED_TABLES);
+    const merged = {
+        ...baseSnapshot,
+        ...(overrides ?? {})
+    };
+    // Ensure allow-lists include env tables/bases.
+    const bases = new Set(merged.allowedBases);
+    allowedBases.forEach((base) => bases.add(base));
+    merged.allowedBases = Array.from(bases);
+    if (overrides?.allowedTables || envAllowedTables.length > 0) {
+        const tableSet = new Map();
+        (overrides?.allowedTables ?? []).forEach((table) => {
+            tableSet.set(`${table.baseId}:${table.table}`, table);
+        });
+        envAllowedTables.forEach((table) => {
+            tableSet.set(`${table.baseId}:${table.table}`, table);
+        });
+        merged.allowedTables = Array.from(tableSet.values());
+    }
+    return types_1.governanceOutputSchema.parse(merged);
+}
+function loadConfig() {
+    const personalAccessToken = process.env.AIRTABLE_PAT ||
+        process.env.AIRTABLE_TOKEN ||
+        process.env.AIRTABLE_API_TOKEN ||
+        process.env.AIRTABLE_API_KEY;
+    if (!personalAccessToken) {
+        throw new errors_1.GovernanceError('Missing Airtable credentials. Set AIRTABLE_PAT (preferred) or AIRTABLE_TOKEN.');
+    }
+    const defaultBaseId = process.env.AIRTABLE_DEFAULT_BASE ?? process.env.AIRTABLE_BASE_ID ?? process.env.AIRTABLE_BASE;
+    const allowedBases = determineAllowedBases(defaultBaseId);
+    const governance = buildGovernanceSnapshot(allowedBases);
+    // Validate token format and collect warnings
+    const tokenValidation = (0, validateApiKey_1.validateApiKey)(personalAccessToken);
+    if (tokenValidation.warnings.length > 0) {
+        // Log warnings to stderr (will be visible in MCP server logs)
+        tokenValidation.warnings.forEach((warning) => {
+            console.error(`[airtable-mcp] Token warning: ${warning}`);
+        });
+    }
+    const auth = {
+        personalAccessToken,
+        patHash: hashSecret(personalAccessToken),
+        allowedBases,
+        tokenFormatWarnings: tokenValidation.warnings
+    };
+    if (defaultBaseId) {
+        auth.defaultBaseId = defaultBaseId;
+    }
+    return {
+        version: process.env.npm_package_version || '0.0.0',
+        auth,
+        governance,
+        logLevel: resolveLogLevel(),
+        exceptionQueueSize: Number.parseInt(process.env.EXCEPTION_QUEUE_SIZE || '', 10) > 0
+            ? Number.parseInt(process.env.EXCEPTION_QUEUE_SIZE, 10)
+            : DEFAULT_EXCEPTION_QUEUE_SIZE
+    };
+}
+//# sourceMappingURL=config.js.map

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

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

package/dist/typescript/app/context.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/typescript/app/context.ts"],"names":[],"mappings":""}