@rashidazarang/airtable-mcp 3.1.0 → 3.2.5

package/dist/typescript/app/config.js

@@ -0,0 +1,141 @@
+"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");
+(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);
+    const auth = {
+        personalAccessToken,
+        patHash: hashSecret(personalAccessToken),
+        allowedBases
+    };
+    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":""}

package/dist/typescript/app/exceptions.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExceptionStore = void 0;
+const node_crypto_1 = require("node:crypto");
+function mapCategory(code) {
+    switch (code) {
+        case 'RateLimited':
+            return 'rate_limit';
+        case 'ValidationError':
+            return 'validation';
+        case 'AuthError':
+            return 'auth';
+        case 'ConflictError':
+            return 'conflict';
+        case 'GovernanceError':
+            return 'schema_drift';
+        default:
+            return 'other';
+    }
+}
+function mapSeverity(code) {
+    switch (code) {
+        case 'RateLimited':
+        case 'AuthError':
+        case 'ConflictError':
+        case 'GovernanceError':
+            return 'error';
+        case 'ValidationError':
+            return 'warning';
+        default:
+            return 'error';
+    }
+}
+class ExceptionStore {
+    constructor(capacity, logger) {
+        this.items = [];
+        this.capacity = capacity;
+        this.logger = logger.child({ component: 'exception_store' });
+    }
+    record(error, summary, details, proposedFix) {
+        const item = {
+            id: (0, node_crypto_1.randomUUID)(),
+            timestamp: new Date().toISOString(),
+            severity: mapSeverity(error.code),
+            category: mapCategory(error.code),
+            summary,
+            details,
+            proposedFix
+        };
+        this.items.unshift(item);
+        if (this.items.length > this.capacity) {
+            this.items.pop();
+        }
+        this.logger.debug('Recorded exception', { code: error.code });
+    }
+    list(params) {
+        const limit = params.limit ?? 100;
+        const cursorIndex = this.parseCursor(params.cursor);
+        let filtered = this.items;
+        if (params.since) {
+            filtered = filtered.filter((item) => item.timestamp > params.since);
+        }
+        if (params.severity) {
+            filtered = filtered.filter((item) => item.severity === params.severity);
+        }
+        const slice = filtered.slice(cursorIndex, cursorIndex + limit);
+        const nextCursor = cursorIndex + limit < filtered.length ? String(cursorIndex + limit) : undefined;
+        return {
+            items: slice,
+            cursor: nextCursor
+        };
+    }
+    parseCursor(cursor) {
+        if (!cursor) {
+            return 0;
+        }
+        const parsed = Number.parseInt(cursor, 10);
+        if (Number.isNaN(parsed) || parsed < 0) {
+            return 0;
+        }
+        return parsed;
+    }
+}
+exports.ExceptionStore = ExceptionStore;
+//# sourceMappingURL=exceptions.js.map

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

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

package/dist/typescript/app/governance.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GovernanceService = void 0;
+const errors_1 = require("../errors");
+class GovernanceService {
+    constructor(snapshot) {
+        this.snapshot = snapshot;
+        this.tablesByBase = this.buildTableIndex(snapshot);
+    }
+    ensureBaseAllowed(baseId) {
+        // If allowedBases is empty, allow all bases (user will use list_bases to discover)
+        if (this.snapshot.allowedBases.length > 0 && !this.snapshot.allowedBases.includes(baseId)) {
+            throw new errors_1.GovernanceError(`Base ${baseId} is not in the allow-list`, {
+                context: { baseId, governanceRule: 'allowedBases' }
+            });
+        }
+    }
+    ensureOperationAllowed(operation) {
+        if (!this.snapshot.allowedOperations.includes(operation)) {
+            throw new errors_1.GovernanceError(`Operation ${operation} is not permitted`, {
+                context: { governanceRule: 'allowedOperations' }
+            });
+        }
+    }
+    ensureTableAllowed(baseId, table) {
+        if (!this.isTableAllowed(baseId, table)) {
+            throw new errors_1.GovernanceError(`Table ${table} is not allowed in base ${baseId}`, {
+                context: { baseId, table, governanceRule: 'allowedTables' }
+            });
+        }
+    }
+    listPiiPolicies(baseId, table) {
+        return this.snapshot.piiFields
+            ?.filter((field) => field.baseId === baseId && field.table === table)
+            .map((field) => ({ field: field.field, policy: field.policy })) ?? [];
+    }
+    getSnapshot() {
+        return this.snapshot;
+    }
+    isTableAllowed(baseId, table) {
+        const allowedTables = this.tablesByBase.get(baseId);
+        if (!allowedTables || allowedTables.size === 0) {
+            return true;
+        }
+        return allowedTables.has(table);
+    }
+    buildTableIndex(snapshot) {
+        const map = new Map();
+        for (const item of snapshot.allowedTables ?? []) {
+            const baseTables = map.get(item.baseId) ?? new Set();
+            baseTables.add(item.table);
+            map.set(item.baseId, baseTables);
+        }
+        return map;
+    }
+}
+exports.GovernanceService = GovernanceService;
+//# sourceMappingURL=governance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../../src/typescript/app/governance.ts"],"names":[],"mappings":";;;AACA,sCAA4C;AAI5C,MAAa,iBAAiB;IAI5B,YAAY,QAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,iBAAiB,CAAC,MAAc;QAC9B,mFAAmF;QACnF,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1F,MAAM,IAAI,wBAAe,CAAC,QAAQ,MAAM,2BAA2B,EAAE;gBACnE,OAAO,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE;aACpD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sBAAsB,CAAC,SAAoB;QACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,wBAAe,CAAC,aAAa,SAAS,mBAAmB,EAAE;gBACnE,OAAO,EAAE,EAAE,cAAc,EAAE,mBAAmB,EAAE;aACjD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,KAAa;QAC9C,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,wBAAe,CAAC,SAAS,KAAK,2BAA2B,MAAM,EAAE,EAAE;gBAC3E,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE;aAC5D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,eAAe,CAAC,MAAc,EAAE,KAAa;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS;YAC5B,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC;aACpE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1E,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,cAAc,CAAC,MAAc,EAAE,KAAa;QAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAEO,eAAe,CAAC,QAA4B;QAClD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;YAChD,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;YAC7D,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AA7DD,8CA6DC"}

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":"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"}

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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"}