@rashidazarang/airtable-mcp 3.1.0 → 3.2.8

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

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerWebhookTools = registerWebhookTools;
+const handleError_1 = require("./handleError");
+const response_1 = require("./response");
+function registerWebhookTools(server, ctx) {
+    server.registerTool('list_webhooks', { description: 'List Airtable webhooks for the default base.' }, async (_args) => {
+        try {
+            const baseId = ctx.config.auth.defaultBaseId || ctx.config.auth.allowedBases[0];
+            if (!baseId)
+                throw new Error('No base configured');
+            const body = await ctx.airtable.queryRecords(baseId, 'meta/webhooks');
+            return (0, response_1.createToolResponse)({ webhooks: body });
+        }
+        catch (error) {
+            return (0, handleError_1.handleToolError)('list_webhooks', error, ctx);
+        }
+    });
+    server.registerTool('create_webhook', { description: 'Create a new webhook for a base.' }, async (args) => {
+        try {
+            const baseId = args.baseId || ctx.config.auth.defaultBaseId || ctx.config.auth.allowedBases[0];
+            if (!baseId)
+                throw new Error('No base configured');
+            const payload = { notificationUrl: String(args.notificationUrl || '') };
+            const result = await ctx.airtable.createRecords(baseId, 'meta/webhooks', payload);
+            return (0, response_1.createToolResponse)({ webhook: result });
+        }
+        catch (error) {
+            return (0, handleError_1.handleToolError)('create_webhook', error, ctx);
+        }
+    });
+    server.registerTool('refresh_webhook', { description: 'Refresh webhook expiration.' }, async (args) => {
+        try {
+            const baseId = args.baseId || ctx.config.auth.defaultBaseId || ctx.config.auth.allowedBases[0];
+            if (!baseId)
+                throw new Error('No base configured');
+            const result = await ctx.airtable.updateRecords(baseId, `meta/webhooks/${String(args.webhookId)}/refresh`, {});
+            return (0, response_1.createToolResponse)({ webhook: result });
+        }
+        catch (error) {
+            return (0, handleError_1.handleToolError)('refresh_webhook', error, ctx);
+        }
+    });
+}
+//# sourceMappingURL=webhooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../../src/typescript/app/tools/webhooks.ts"],"names":[],"mappings":";;AAKA,oDA8CC;AAjDD,+CAAgD;AAChD,yCAAgD;AAEhD,SAAgB,oBAAoB,CAAC,MAAiB,EAAE,GAAe;IACrE,MAAM,CAAC,YAAY,CACjB,eAAe,EACf,EAAE,WAAW,EAAE,8CAA8C,EAAE,EAC/D,KAAK,EAAE,KAA8B,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChF,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YACtE,OAAO,IAAA,6BAAkB,EAAC,EAAE,QAAQ,EAAE,IAA+B,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,6BAAe,EAAC,eAAe,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACtD,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB,EAAE,WAAW,EAAE,kCAAkC,EAAE,EACnD,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC3G,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACnD,MAAM,OAAO,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;YACxE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,OAAc,CAAC,CAAC;YACzF,OAAO,IAAA,6BAAkB,EAAC,EAAE,OAAO,EAAE,MAAiC,EAAE,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,6BAAe,EAAC,gBAAgB,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB,EAAE,WAAW,EAAE,6BAA6B,EAAE,EAC9C,KAAK,EAAE,IAA6B,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC3G,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,iBAAiB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAS,CAAC,CAAC;YACtH,OAAO,IAAA,6BAAkB,EAAC,EAAE,OAAO,EAAE,MAAiC,EAAE,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,6BAAe,EAAC,iBAAiB,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/typescript/app/types.js

@@ -0,0 +1,291 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.governanceOutputSchema = exports.listExceptionsOutputSchema = exports.exceptionItemSchema = exports.listExceptionsInputSchema = exports.upsertOutputSchema = exports.upsertInputSchema = exports.updateInputSchema = exports.updateOutputSchema = exports.createOutputSchema = exports.createInputSchema = exports.queryOutputSchema = exports.queryInputShape = exports.queryInputSchema = exports.describeOutputSchema = exports.describeInputShape = exports.describeInputSchema = exports.detailLevelSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Shared Zod schemas and TypeScript types for Airtable Brain tools.
+ * Keep these aligned with the JSON Schemas under docs/prd/schemas.
+ */
+/**
+ * Detail level for schema operations to optimize LLM context usage.
+ * - tableIdentifiersOnly: Only table IDs and names
+ * - identifiersOnly: Table, field, and view IDs and names
+ * - full: Complete details including field types, options, descriptions
+ */
+exports.detailLevelSchema = zod_1.z.enum(['tableIdentifiersOnly', 'identifiersOnly', 'full']);
+const describeInputBase = zod_1.z
+    .object({
+    scope: zod_1.z.enum(['base', 'table']),
+    baseId: zod_1.z.string().min(1, 'baseId is required'),
+    table: zod_1.z
+        .string()
+        .min(1, 'table is required when scope=table')
+        .optional(),
+    detailLevel: exports.detailLevelSchema.optional().default('full'),
+    // Deprecated: use detailLevel instead
+    includeFields: zod_1.z.boolean().optional().default(true),
+    includeViews: zod_1.z.boolean().optional().default(false)
+})
+    .strict();
+exports.describeInputSchema = describeInputBase.superRefine((data, ctx) => {
+    if (data.scope === 'table' && !data.table) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['table'],
+            message: 'table is required when scope is "table"'
+        });
+    }
+});
+exports.describeInputShape = describeInputBase.shape;
+const describeFieldSchema = zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    type: zod_1.z.string(),
+    options: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional()
+})
+    .passthrough();
+const describeTableSchema = zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    primaryFieldId: zod_1.z.string().optional(),
+    fields: zod_1.z.array(describeFieldSchema).optional(),
+    views: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())).optional()
+})
+    .passthrough();
+exports.describeOutputSchema = zod_1.z
+    .object({
+    base: zod_1.z
+        .object({
+        id: zod_1.z.string(),
+        name: zod_1.z.string()
+    })
+        .passthrough(),
+    tables: zod_1.z.array(describeTableSchema).optional(),
+    views: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())).optional()
+})
+    .strict();
+const sortDirectionSchema = zod_1.z.enum(['asc', 'desc']);
+const queryInputBase = zod_1.z
+    .object({
+    baseId: zod_1.z.string().min(1, 'baseId is required'),
+    table: zod_1.z.string().min(1, 'table is required'),
+    fields: zod_1.z.array(zod_1.z.string().min(1)).optional(),
+    filterByFormula: zod_1.z.string().optional(),
+    view: zod_1.z.string().optional(),
+    sorts: zod_1.z
+        .array(zod_1.z
+        .object({
+        field: zod_1.z.string().min(1),
+        direction: sortDirectionSchema.optional().default('asc')
+    })
+        .strict())
+        .optional(),
+    pageSize: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional(),
+    maxRecords: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .optional(),
+    offset: zod_1.z.string().optional(),
+    returnFieldsByFieldId: zod_1.z.boolean().optional().default(false)
+})
+    .strict();
+exports.queryInputSchema = queryInputBase;
+exports.queryInputShape = queryInputBase.shape;
+const recordSchema = zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    createdTime: zod_1.z.string().optional(),
+    fields: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())
+})
+    .strict();
+exports.queryOutputSchema = zod_1.z
+    .object({
+    records: zod_1.z.array(recordSchema),
+    offset: zod_1.z.string().optional(),
+    summary: zod_1.z
+        .object({
+        returned: zod_1.z.number().int().nonnegative(),
+        hasMore: zod_1.z.boolean()
+    })
+        .strict()
+        .optional()
+})
+    .strict();
+exports.createInputSchema = zod_1.z
+    .object({
+    baseId: zod_1.z.string().min(1),
+    table: zod_1.z.string().min(1),
+    records: zod_1.z
+        .array(zod_1.z
+        .object({
+        fields: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())
+    })
+        .strict())
+        .min(1),
+    typecast: zod_1.z.boolean().optional().default(false),
+    idempotencyKey: zod_1.z.string().min(1).optional(),
+    dryRun: zod_1.z.boolean().optional().default(false)
+})
+    .strict();
+const createDiffSchema = zod_1.z
+    .object({
+    added: zod_1.z.number().int().nonnegative(),
+    updated: zod_1.z.number().int().nonnegative(),
+    unchanged: zod_1.z.number().int().nonnegative()
+})
+    .strict();
+exports.createOutputSchema = zod_1.z
+    .object({
+    diff: createDiffSchema,
+    records: zod_1.z.array(recordSchema).optional(),
+    dryRun: zod_1.z.boolean(),
+    warnings: zod_1.z.array(zod_1.z.string()).optional()
+})
+    .strict();
+const conflictSchema = zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    field: zod_1.z.string(),
+    before: zod_1.z.unknown().optional(),
+    after: zod_1.z.unknown().optional(),
+    current: zod_1.z.unknown()
+})
+    .strict();
+const mutationDiffSchema = zod_1.z
+    .object({
+    added: zod_1.z.number().int().nonnegative(),
+    updated: zod_1.z.number().int().nonnegative(),
+    unchanged: zod_1.z.number().int().nonnegative(),
+    conflicts: zod_1.z.number().int().nonnegative()
+})
+    .strict();
+exports.updateOutputSchema = zod_1.z
+    .object({
+    diff: mutationDiffSchema,
+    records: zod_1.z.array(recordSchema).optional(),
+    dryRun: zod_1.z.boolean(),
+    conflicts: zod_1.z.array(conflictSchema).optional()
+})
+    .strict();
+exports.updateInputSchema = zod_1.z
+    .object({
+    baseId: zod_1.z.string().min(1),
+    table: zod_1.z.string().min(1),
+    records: zod_1.z
+        .array(zod_1.z
+        .object({
+        id: zod_1.z.string(),
+        fields: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())
+    })
+        .strict())
+        .min(1),
+    typecast: zod_1.z.boolean().optional().default(false),
+    idempotencyKey: zod_1.z.string().min(1).optional(),
+    dryRun: zod_1.z.boolean().optional().default(false),
+    conflictStrategy: zod_1.z
+        .enum(['fail_on_conflict', 'server_merge', 'client_merge'])
+        .optional()
+        .default('fail_on_conflict'),
+    ifUnchangedHash: zod_1.z.string().optional()
+})
+    .strict();
+exports.upsertInputSchema = zod_1.z
+    .object({
+    baseId: zod_1.z.string().min(1),
+    table: zod_1.z.string().min(1),
+    records: zod_1.z
+        .array(zod_1.z
+        .object({
+        fields: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())
+    })
+        .strict())
+        .min(1),
+    performUpsert: zod_1.z
+        .object({
+        fieldsToMergeOn: zod_1.z.array(zod_1.z.string().min(1)).min(1)
+    })
+        .strict(),
+    typecast: zod_1.z.boolean().optional().default(false),
+    idempotencyKey: zod_1.z.string().min(1).optional(),
+    dryRun: zod_1.z.boolean().optional().default(false),
+    conflictStrategy: zod_1.z
+        .enum(['fail_on_conflict', 'server_merge', 'client_merge'])
+        .optional()
+        .default('fail_on_conflict')
+})
+    .strict();
+exports.upsertOutputSchema = zod_1.z
+    .object({
+    diff: mutationDiffSchema,
+    records: zod_1.z.array(recordSchema).optional(),
+    dryRun: zod_1.z.boolean(),
+    conflicts: zod_1.z.array(conflictSchema).optional()
+})
+    .strict();
+exports.listExceptionsInputSchema = zod_1.z
+    .object({
+    since: zod_1.z.string().optional(),
+    severity: zod_1.z.enum(['info', 'warning', 'error']).optional(),
+    limit: zod_1.z.number().int().min(1).max(500).optional().default(100),
+    cursor: zod_1.z.string().optional()
+})
+    .strict();
+exports.exceptionItemSchema = zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    timestamp: zod_1.z.string(),
+    severity: zod_1.z.enum(['info', 'warning', 'error']),
+    category: zod_1.z.enum(['rate_limit', 'validation', 'auth', 'conflict', 'schema_drift', 'other']),
+    summary: zod_1.z.string(),
+    details: zod_1.z.string().optional(),
+    proposedFix: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional()
+})
+    .strict();
+exports.listExceptionsOutputSchema = zod_1.z
+    .object({
+    items: zod_1.z.array(exports.exceptionItemSchema),
+    cursor: zod_1.z.string().optional()
+})
+    .strict();
+const allowedOperations = ['describe', 'query', 'create', 'update', 'upsert'];
+exports.governanceOutputSchema = zod_1.z
+    .object({
+    allowedBases: zod_1.z.array(zod_1.z.string()),
+    allowedTables: zod_1.z
+        .array(zod_1.z
+        .object({
+        baseId: zod_1.z.string(),
+        table: zod_1.z.string()
+    })
+        .strict())
+        .optional()
+        .default([]),
+    allowedOperations: zod_1.z
+        .array(zod_1.z.enum(allowedOperations))
+        .default([...allowedOperations]),
+    piiFields: zod_1.z
+        .array(zod_1.z
+        .object({
+        baseId: zod_1.z.string(),
+        table: zod_1.z.string(),
+        field: zod_1.z.string(),
+        policy: zod_1.z.enum(['mask', 'hash', 'drop'])
+    })
+        .strict())
+        .optional()
+        .default([]),
+    redactionPolicy: zod_1.z.enum(['mask_all_pii', 'mask_on_inline', 'none']).default('mask_on_inline'),
+    loggingPolicy: zod_1.z.enum(['errors_only', 'minimal', 'verbose']).default('minimal'),
+    retentionDays: zod_1.z.number().int().min(0).default(7)
+})
+    .strict();
+//# sourceMappingURL=types.js.map

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

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

package/dist/typescript/app/validateApiKey.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * API key format validation for Airtable Personal Access Tokens.
+ *
+ * Provides helpful warnings when token format appears incorrect,
+ * without blocking startup (token might still work in edge cases).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateApiKey = validateApiKey;
+exports.getTokenFormatWarnings = getTokenFormatWarnings;
+/**
+ * Validates Airtable API key format and returns warnings for common issues.
+ *
+ * @param apiKey - The API key to validate
+ * @returns Validation result with warnings array
+ */
+function validateApiKey(apiKey) {
+    const warnings = [];
+    if (!apiKey || apiKey.trim().length === 0) {
+        return {
+            isValid: false,
+            warnings: ['No API key provided. Set AIRTABLE_PAT environment variable.']
+        };
+    }
+    const trimmedKey = apiKey.trim();
+    // Check for whitespace
+    if (apiKey !== trimmedKey) {
+        warnings.push('API key contains leading or trailing whitespace. This has been trimmed.');
+    }
+    // Check dot count (PATs have exactly one dot separating prefix from secret)
+    const dotCount = (trimmedKey.match(/\./g) || []).length;
+    if (dotCount === 0) {
+        warnings.push(`Expected one dot (.) in API key, found ${dotCount}. ` +
+            'Ensure you copied the entire token, not just the token ID.');
+    }
+    else if (dotCount > 1) {
+        warnings.push(`Expected one dot (.) in API key, found ${dotCount}. ` +
+            'Ensure you copied the API key correctly.');
+    }
+    // Check length (typical PAT is around 82 characters)
+    if (trimmedKey.length < 70) {
+        warnings.push(`API key seems too short (${trimmedKey.length} characters). ` +
+            'Personal Access Tokens are typically around 82 characters.');
+    }
+    else if (trimmedKey.length > 100) {
+        warnings.push(`API key seems too long (${trimmedKey.length} characters). ` +
+            'Personal Access Tokens are typically around 82 characters.');
+    }
+    // Check for legacy API key format (starts with 'key')
+    if (trimmedKey.startsWith('key')) {
+        warnings.push('This appears to be an old-style API key (starts with "key"). ' +
+            'Please create a Personal Access Token at https://airtable.com/create/tokens instead.');
+    }
+    // Check for valid PAT prefix
+    if (!trimmedKey.startsWith('pat') && !trimmedKey.startsWith('key')) {
+        warnings.push('API key does not start with expected prefix ("pat" for Personal Access Token). ' +
+            'Verify you copied the correct token.');
+    }
+    return {
+        isValid: warnings.length === 0,
+        warnings
+    };
+}
+/**
+ * Get token format warnings for inclusion in error messages.
+ * Only returns warnings if issues are detected.
+ *
+ * @param apiKey - The API key to check
+ * @returns Array of warning strings, empty if token format looks valid
+ */
+function getTokenFormatWarnings(apiKey) {
+    const result = validateApiKey(apiKey);
+    return result.warnings;
+}
+//# sourceMappingURL=validateApiKey.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateApiKey.js","sourceRoot":"","sources":["../../../src/typescript/app/validateApiKey.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAaH,wCAgEC;AASD,wDAGC;AAlFD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,MAAc;IAC3C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,CAAC,6DAA6D,CAAC;SAC1E,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAEjC,uBAAuB;IACvB,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;IAC3F,CAAC;IAED,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACxD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CACX,0CAA0C,QAAQ,IAAI;YACtD,4DAA4D,CAC7D,CAAC;IACJ,CAAC;SAAM,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CACX,0CAA0C,QAAQ,IAAI;YACtD,0CAA0C,CAC3C,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CACX,4BAA4B,UAAU,CAAC,MAAM,gBAAgB;YAC7D,4DAA4D,CAC7D,CAAC;IACJ,CAAC;SAAM,IAAI,UAAU,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CACX,2BAA2B,UAAU,CAAC,MAAM,gBAAgB;YAC5D,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED,sDAAsD;IACtD,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CACX,+DAA+D;YAC/D,sFAAsF,CACvF,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,QAAQ,CAAC,IAAI,CACX,iFAAiF;YACjF,sCAAsC,CACvC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC9B,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAAC,MAAc;IACnD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC"}

package/dist/typescript/errors.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Error taxonomy aligned with Airtable Brain guardrails.
+ *
+ * All tool errors should use these types so the LLM can reason about
+ * retry behaviour and user messaging. Avoid leaking raw Airtable payloads
+ * through error messages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GovernanceError = exports.InternalServerError = exports.NotFoundError = exports.ConflictError = exports.AuthError = exports.AirtableValidationError = exports.RateLimitError = exports.AirtableBrainError = void 0;
+class AirtableBrainError extends Error {
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = code;
+        this.code = code;
+        if (options.cause !== undefined) {
+            this.cause = options.cause;
+        }
+        if (options.status !== undefined) {
+            this.status = options.status;
+        }
+        if (options.retryAfterMs !== undefined) {
+            this.retryAfterMs = options.retryAfterMs;
+        }
+        this.context = options.context ?? {};
+    }
+    withContext(context) {
+        Object.assign(this.context, context);
+        return this;
+    }
+}
+exports.AirtableBrainError = AirtableBrainError;
+class RateLimitError extends AirtableBrainError {
+    constructor(message, options = {}) {
+        super('RateLimited', message, options);
+    }
+}
+exports.RateLimitError = RateLimitError;
+class AirtableValidationError extends AirtableBrainError {
+    constructor(message, options = {}) {
+        super('ValidationError', message, options);
+    }
+}
+exports.AirtableValidationError = AirtableValidationError;
+class AuthError extends AirtableBrainError {
+    constructor(message, options = {}) {
+        super('AuthError', message, options);
+    }
+}
+exports.AuthError = AuthError;
+class ConflictError extends AirtableBrainError {
+    constructor(message, options = {}) {
+        super('ConflictError', message, options);
+    }
+}
+exports.ConflictError = ConflictError;
+class NotFoundError extends AirtableBrainError {
+    constructor(message, options = {}) {
+        super('NotFound', message, options);
+    }
+}
+exports.NotFoundError = NotFoundError;
+class InternalServerError extends AirtableBrainError {
+    constructor(message, options = {}) {
+        super('InternalError', message, options);
+    }
+}
+exports.InternalServerError = InternalServerError;
+class GovernanceError extends AirtableBrainError {
+    constructor(message, options = {}) {
+        super('GovernanceError', message, options);
+    }
+}
+exports.GovernanceError = GovernanceError;
+//# sourceMappingURL=errors.js.map

package/dist/typescript/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/typescript/errors.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAgCH,MAAa,kBAAmB,SAAQ,KAAK;IAM3C,YAAY,IAAuB,EAAE,OAAe,EAAE,UAAgC,EAAE;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAoC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9D,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,WAAW,CAAC,OAA8B;QACxC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA1BD,gDA0BC;AAED,MAAa,cAAe,SAAQ,kBAAkB;IACpD,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAJD,wCAIC;AAED,MAAa,uBAAwB,SAAQ,kBAAkB;IAC7D,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AAJD,0DAIC;AAED,MAAa,SAAU,SAAQ,kBAAkB;IAC/C,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;CACF;AAJD,8BAIC;AAED,MAAa,aAAc,SAAQ,kBAAkB;IACnD,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF;AAJD,sCAIC;AAED,MAAa,aAAc,SAAQ,kBAAkB;IACnD,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF;AAJD,sCAIC;AAED,MAAa,mBAAoB,SAAQ,kBAAkB;IACzD,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF;AAJD,kDAIC;AAED,MAAa,eAAgB,SAAQ,kBAAkB;IACrD,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AAJD,0CAIC"}

package/dist/typescript/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Airtable MCP Server - Main Export
+ *
+ * This module exports the main server functionality for programmatic use.
+ * For CLI usage, use the bin/airtable-mcp.js executable.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.start = void 0;
+var airtable_mcp_server_1 = require("./airtable-mcp-server");
+Object.defineProperty(exports, "start", { enumerable: true, get: function () { return airtable_mcp_server_1.start; } });
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/typescript/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/typescript/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,6DAA8C;AAArC,4GAAA,KAAK,OAAA;AACd,2CAAyB"}