@rashidazarang/airtable-mcp 3.0.0 → 3.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/README.md +210 -43
  2. package/bin/airtable-mcp.js +12 -32
  3. package/dist/typescript/airtable-mcp-server.js +77 -0
  4. package/dist/typescript/airtable-mcp-server.js.map +1 -0
  5. package/dist/typescript/app/airtable-client.js +325 -0
  6. package/dist/typescript/app/airtable-client.js.map +1 -0
  7. package/dist/typescript/app/config.js +141 -0
  8. package/dist/typescript/app/config.js.map +1 -0
  9. package/dist/typescript/app/context.js +3 -0
  10. package/dist/typescript/app/context.js.map +1 -0
  11. package/dist/typescript/app/exceptions.js +85 -0
  12. package/dist/typescript/app/exceptions.js.map +1 -0
  13. package/dist/typescript/app/governance.js +58 -0
  14. package/dist/typescript/app/governance.js.map +1 -0
  15. package/dist/typescript/app/logger.js +47 -0
  16. package/dist/typescript/app/logger.js.map +1 -0
  17. package/dist/typescript/app/rateLimiter.js +37 -0
  18. package/dist/typescript/app/rateLimiter.js.map +1 -0
  19. package/dist/typescript/app/tools/create.js +54 -0
  20. package/dist/typescript/app/tools/create.js.map +1 -0
  21. package/dist/typescript/app/tools/describe.js +146 -0
  22. package/dist/typescript/app/tools/describe.js.map +1 -0
  23. package/dist/typescript/app/tools/handleError.js +54 -0
  24. package/dist/typescript/app/tools/handleError.js.map +1 -0
  25. package/dist/typescript/app/tools/index.js +24 -0
  26. package/dist/typescript/app/tools/index.js.map +1 -0
  27. package/dist/typescript/app/tools/listBases.js +52 -0
  28. package/dist/typescript/app/tools/listBases.js.map +1 -0
  29. package/dist/typescript/app/tools/listExceptions.js +18 -0
  30. package/dist/typescript/app/tools/listExceptions.js.map +1 -0
  31. package/dist/typescript/app/tools/listGovernance.js +17 -0
  32. package/dist/typescript/app/tools/listGovernance.js.map +1 -0
  33. package/dist/typescript/app/tools/query.js +126 -0
  34. package/dist/typescript/app/tools/query.js.map +1 -0
  35. package/dist/typescript/app/tools/update.js +56 -0
  36. package/dist/typescript/app/tools/update.js.map +1 -0
  37. package/dist/typescript/app/tools/upsert.js +65 -0
  38. package/dist/typescript/app/tools/upsert.js.map +1 -0
  39. package/dist/typescript/app/tools/webhooks.js +44 -0
  40. package/dist/typescript/app/tools/webhooks.js.map +1 -0
  41. package/dist/typescript/app/types.js +282 -0
  42. package/dist/typescript/app/types.js.map +1 -0
  43. package/dist/typescript/apps-sdk/mappers.js +70 -0
  44. package/dist/typescript/apps-sdk/mappers.js.map +1 -0
  45. package/dist/typescript/errors.js +75 -0
  46. package/dist/typescript/errors.js.map +1 -0
  47. package/dist/typescript/index.js +27 -0
  48. package/dist/typescript/index.js.map +1 -0
  49. package/package.json +63 -17
  50. package/tsconfig.json +44 -0
  51. package/types/typescript/airtable-mcp-server.d.ts +2 -0
  52. package/types/typescript/app/airtable-client.d.ts +49 -0
  53. package/types/typescript/app/config.d.ts +16 -0
  54. package/types/typescript/app/context.d.ts +12 -0
  55. package/types/typescript/app/exceptions.d.ts +12 -0
  56. package/types/typescript/app/governance.d.ts +18 -0
  57. package/types/typescript/app/logger.d.ts +13 -0
  58. package/types/typescript/app/rateLimiter.d.ts +13 -0
  59. package/types/typescript/app/tools/create.d.ts +3 -0
  60. package/types/typescript/app/tools/describe.d.ts +3 -0
  61. package/types/typescript/app/tools/handleError.d.ts +8 -0
  62. package/types/typescript/app/tools/index.d.ts +3 -0
  63. package/types/typescript/app/tools/listBases.d.ts +33 -0
  64. package/types/typescript/app/tools/listExceptions.d.ts +3 -0
  65. package/types/typescript/app/tools/listGovernance.d.ts +3 -0
  66. package/types/typescript/app/tools/query.d.ts +3 -0
  67. package/types/typescript/app/tools/update.d.ts +3 -0
  68. package/types/typescript/app/tools/upsert.d.ts +3 -0
  69. package/types/typescript/app/tools/webhooks.d.ts +3 -0
  70. package/types/typescript/app/types.d.ts +830 -0
  71. package/types/typescript/apps-sdk/mappers.d.ts +53 -0
  72. package/types/typescript/errors.d.ts +55 -0
  73. package/types/typescript/index.d.ts +10 -0
  74. package/types/typescript/prompt-templates.d.ts +5 -0
  75. package/types/typescript/test-suite.d.ts +33 -0
  76. package/types/typescript/tools-schemas.d.ts +5 -0
  77. package/airtable_simple.js +0 -1561
  78. package/airtable_simple_production.js +0 -1564
  79. package/examples/airtable-crud-example.js +0 -203
  80. package/examples/building-mcp.md +0 -6666
  81. package/examples/claude_config.json +0 -4
  82. package/examples/claude_simple_config.json +0 -7
  83. package/examples/env-demo.js +0 -172
  84. package/examples/example-tasks-update.json +0 -23
  85. package/examples/example-tasks.json +0 -26
  86. package/examples/example_usage.md +0 -124
  87. package/examples/python_debug_patch.txt +0 -27
  88. package/examples/sample-transform.js +0 -76
  89. package/examples/windsurf_mcp_config.json +0 -17
@@ -0,0 +1,56 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.registerUpdateTool = registerUpdateTool;
4
+ const types_1 = require("../types");
5
+ const handleError_1 = require("./handleError");
6
+ function chunk(arr, size) {
7
+ const out = [];
8
+ for (let i = 0; i < arr.length; i += size)
9
+ out.push(arr.slice(i, i + size));
10
+ return out;
11
+ }
12
+ function registerUpdateTool(server, ctx) {
13
+ server.registerTool('update', {
14
+ description: 'Update Airtable records (requires diff-before-write via dryRun first).',
15
+ inputSchema: types_1.updateInputSchema.shape,
16
+ outputSchema: types_1.updateOutputSchema.shape
17
+ }, async (raw) => {
18
+ try {
19
+ const args = types_1.updateInputSchema.parse(raw);
20
+ ctx.governance.ensureOperationAllowed('update');
21
+ ctx.governance.ensureBaseAllowed(args.baseId);
22
+ ctx.governance.ensureTableAllowed(args.baseId, args.table);
23
+ const logger = ctx.logger.child({ tool: 'update', baseId: args.baseId, table: args.table });
24
+ if (args.dryRun) {
25
+ const structuredContent = {
26
+ diff: { added: 0, updated: args.records.length, unchanged: 0, conflicts: 0 },
27
+ dryRun: true,
28
+ records: args.records.map((r) => ({ id: r.id, fields: r.fields })),
29
+ conflicts: []
30
+ };
31
+ return { structuredContent, content: [] };
32
+ }
33
+ const chunks = chunk(args.records, 10);
34
+ const aggregated = [];
35
+ for (let i = 0; i < chunks.length; i++) {
36
+ const body = { records: chunks[i], typecast: args.typecast ?? false };
37
+ const headerKey = args.idempotencyKey ? `${args.idempotencyKey}:${i}` : undefined;
38
+ const response = await ctx.airtable.updateRecords(args.baseId, args.table, body, headerKey);
39
+ if (Array.isArray(response?.records))
40
+ aggregated.push(...response.records);
41
+ }
42
+ const structuredContent = {
43
+ diff: { added: 0, updated: aggregated.length, unchanged: 0, conflicts: 0 },
44
+ records: aggregated.map((r) => ({ id: String(r.id), fields: r.fields || {} })),
45
+ dryRun: false,
46
+ conflicts: []
47
+ };
48
+ logger.info('Update completed', { updated: aggregated.length });
49
+ return { structuredContent, content: [] };
50
+ }
51
+ catch (error) {
52
+ return (0, handleError_1.handleToolError)('update', error, ctx);
53
+ }
54
+ });
55
+ }
56
+ //# sourceMappingURL=update.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../src/typescript/app/tools/update.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,65 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.registerUpsertTool = registerUpsertTool;
4
+ const types_1 = require("../types");
5
+ const handleError_1 = require("./handleError");
6
+ function chunk(arr, size) {
7
+ const out = [];
8
+ for (let i = 0; i < arr.length; i += size)
9
+ out.push(arr.slice(i, i + size));
10
+ return out;
11
+ }
12
+ function registerUpsertTool(server, ctx) {
13
+ server.registerTool('upsert', {
14
+ description: 'Upsert Airtable records using performUpsert.fieldsToMergeOn.',
15
+ inputSchema: types_1.upsertInputSchema.shape,
16
+ outputSchema: types_1.upsertOutputSchema.shape
17
+ }, async (raw) => {
18
+ try {
19
+ const args = types_1.upsertInputSchema.parse(raw);
20
+ ctx.governance.ensureOperationAllowed('upsert');
21
+ ctx.governance.ensureBaseAllowed(args.baseId);
22
+ ctx.governance.ensureTableAllowed(args.baseId, args.table);
23
+ const logger = ctx.logger.child({ tool: 'upsert', baseId: args.baseId, table: args.table });
24
+ const matchedBy = args.performUpsert.fieldsToMergeOn;
25
+ if (args.dryRun) {
26
+ const structuredContent = {
27
+ diff: { added: args.records.length, updated: 0, unchanged: 0, conflicts: 0 },
28
+ dryRun: true,
29
+ records: args.records.map((r) => ({ id: 'pending', fields: r.fields })),
30
+ conflicts: []
31
+ };
32
+ // Note: Upsert output in PRD expects 'matchedBy' array and no conflicts property; keep consistent with docs
33
+ // When using strict PRD output, we can omit conflicts and include matchedBy
34
+ structuredContent.matchedBy = matchedBy;
35
+ delete structuredContent.conflicts;
36
+ return { structuredContent, content: [] };
37
+ }
38
+ const chunks = chunk(args.records, 10);
39
+ const aggregated = [];
40
+ for (let i = 0; i < chunks.length; i++) {
41
+ const body = {
42
+ records: chunks[i],
43
+ typecast: args.typecast ?? false,
44
+ performUpsert: { fieldsToMergeOn: matchedBy }
45
+ };
46
+ const headerKey = args.idempotencyKey ? `${args.idempotencyKey}:${i}` : undefined;
47
+ const response = await ctx.airtable.upsertRecords(args.baseId, args.table, body, headerKey);
48
+ if (Array.isArray(response?.records))
49
+ aggregated.push(...response.records);
50
+ }
51
+ const structuredContent = {
52
+ diff: { added: 0, updated: aggregated.length, unchanged: 0 },
53
+ matchedBy,
54
+ records: aggregated.map((r) => ({ id: String(r.id), fields: r.fields || {} })),
55
+ dryRun: false
56
+ };
57
+ logger.info('Upsert completed', { processed: aggregated.length, matchedBy });
58
+ return { structuredContent, content: [] };
59
+ }
60
+ catch (error) {
61
+ return (0, handleError_1.handleToolError)('upsert', error, ctx);
62
+ }
63
+ });
64
+ }
65
+ //# sourceMappingURL=upsert.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upsert.js","sourceRoot":"","sources":["../../../../src/typescript/app/tools/upsert.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.registerWebhookTools = registerWebhookTools;
4
+ const handleError_1 = require("./handleError");
5
+ function registerWebhookTools(server, ctx) {
6
+ server.registerTool('list_webhooks', { description: 'List Airtable webhooks for the default base.' }, async (_args) => {
7
+ try {
8
+ const baseId = ctx.config.auth.defaultBaseId || ctx.config.auth.allowedBases[0];
9
+ if (!baseId)
10
+ throw new Error('No base configured');
11
+ const body = await ctx.airtable.queryRecords(baseId, 'meta/webhooks');
12
+ return { structuredContent: { webhooks: body }, content: [] };
13
+ }
14
+ catch (error) {
15
+ return (0, handleError_1.handleToolError)('list_webhooks', error, ctx);
16
+ }
17
+ });
18
+ server.registerTool('create_webhook', { description: 'Create a new webhook for a base.' }, async (args) => {
19
+ try {
20
+ const baseId = args.baseId || ctx.config.auth.defaultBaseId || ctx.config.auth.allowedBases[0];
21
+ if (!baseId)
22
+ throw new Error('No base configured');
23
+ const payload = { notificationUrl: String(args.notificationUrl || '') };
24
+ const result = await ctx.airtable.createRecords(baseId, 'meta/webhooks', payload);
25
+ return { structuredContent: { webhook: result }, content: [] };
26
+ }
27
+ catch (error) {
28
+ return (0, handleError_1.handleToolError)('create_webhook', error, ctx);
29
+ }
30
+ });
31
+ server.registerTool('refresh_webhook', { description: 'Refresh webhook expiration.' }, async (args) => {
32
+ try {
33
+ const baseId = args.baseId || ctx.config.auth.defaultBaseId || ctx.config.auth.allowedBases[0];
34
+ if (!baseId)
35
+ throw new Error('No base configured');
36
+ const result = await ctx.airtable.updateRecords(baseId, `meta/webhooks/${String(args.webhookId)}/refresh`, {});
37
+ return { structuredContent: { webhook: result }, content: [] };
38
+ }
39
+ catch (error) {
40
+ return (0, handleError_1.handleToolError)('refresh_webhook', error, ctx);
41
+ }
42
+ });
43
+ }
44
+ //# sourceMappingURL=webhooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../../src/typescript/app/tools/webhooks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,282 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ 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 = void 0;
4
+ const zod_1 = require("zod");
5
+ /**
6
+ * Shared Zod schemas and TypeScript types for Airtable Brain tools.
7
+ * Keep these aligned with the JSON Schemas under docs/prd/schemas.
8
+ */
9
+ const describeInputBase = zod_1.z
10
+ .object({
11
+ scope: zod_1.z.enum(['base', 'table']),
12
+ baseId: zod_1.z.string().min(1, 'baseId is required'),
13
+ table: zod_1.z
14
+ .string()
15
+ .min(1, 'table is required when scope=table')
16
+ .optional(),
17
+ includeFields: zod_1.z.boolean().optional().default(true),
18
+ includeViews: zod_1.z.boolean().optional().default(false)
19
+ })
20
+ .strict();
21
+ exports.describeInputSchema = describeInputBase.superRefine((data, ctx) => {
22
+ if (data.scope === 'table' && !data.table) {
23
+ ctx.addIssue({
24
+ code: zod_1.z.ZodIssueCode.custom,
25
+ path: ['table'],
26
+ message: 'table is required when scope is "table"'
27
+ });
28
+ }
29
+ });
30
+ exports.describeInputShape = describeInputBase.shape;
31
+ const describeFieldSchema = zod_1.z
32
+ .object({
33
+ id: zod_1.z.string(),
34
+ name: zod_1.z.string(),
35
+ type: zod_1.z.string(),
36
+ options: zod_1.z.record(zod_1.z.unknown()).optional()
37
+ })
38
+ .passthrough();
39
+ const describeTableSchema = zod_1.z
40
+ .object({
41
+ id: zod_1.z.string(),
42
+ name: zod_1.z.string(),
43
+ description: zod_1.z.string().optional(),
44
+ primaryFieldId: zod_1.z.string().optional(),
45
+ fields: zod_1.z.array(describeFieldSchema).optional(),
46
+ views: zod_1.z.array(zod_1.z.record(zod_1.z.unknown())).optional()
47
+ })
48
+ .passthrough();
49
+ exports.describeOutputSchema = zod_1.z
50
+ .object({
51
+ base: zod_1.z
52
+ .object({
53
+ id: zod_1.z.string(),
54
+ name: zod_1.z.string()
55
+ })
56
+ .passthrough(),
57
+ tables: zod_1.z.array(describeTableSchema).optional(),
58
+ views: zod_1.z.array(zod_1.z.record(zod_1.z.unknown())).optional()
59
+ })
60
+ .strict();
61
+ const sortDirectionSchema = zod_1.z.enum(['asc', 'desc']);
62
+ const queryInputBase = zod_1.z
63
+ .object({
64
+ baseId: zod_1.z.string().min(1, 'baseId is required'),
65
+ table: zod_1.z.string().min(1, 'table is required'),
66
+ fields: zod_1.z.array(zod_1.z.string().min(1)).optional(),
67
+ filterByFormula: zod_1.z.string().optional(),
68
+ view: zod_1.z.string().optional(),
69
+ sorts: zod_1.z
70
+ .array(zod_1.z
71
+ .object({
72
+ field: zod_1.z.string().min(1),
73
+ direction: sortDirectionSchema.optional().default('asc')
74
+ })
75
+ .strict())
76
+ .optional(),
77
+ pageSize: zod_1.z
78
+ .number()
79
+ .int()
80
+ .min(1)
81
+ .max(100)
82
+ .optional(),
83
+ maxRecords: zod_1.z
84
+ .number()
85
+ .int()
86
+ .min(1)
87
+ .optional(),
88
+ offset: zod_1.z.string().optional(),
89
+ returnFieldsByFieldId: zod_1.z.boolean().optional().default(false)
90
+ })
91
+ .strict();
92
+ exports.queryInputSchema = queryInputBase;
93
+ exports.queryInputShape = queryInputBase.shape;
94
+ const recordSchema = zod_1.z
95
+ .object({
96
+ id: zod_1.z.string(),
97
+ createdTime: zod_1.z.string().optional(),
98
+ fields: zod_1.z.record(zod_1.z.unknown())
99
+ })
100
+ .strict();
101
+ exports.queryOutputSchema = zod_1.z
102
+ .object({
103
+ records: zod_1.z.array(recordSchema),
104
+ offset: zod_1.z.string().optional(),
105
+ summary: zod_1.z
106
+ .object({
107
+ returned: zod_1.z.number().int().nonnegative(),
108
+ hasMore: zod_1.z.boolean()
109
+ })
110
+ .strict()
111
+ .optional()
112
+ })
113
+ .strict();
114
+ exports.createInputSchema = zod_1.z
115
+ .object({
116
+ baseId: zod_1.z.string().min(1),
117
+ table: zod_1.z.string().min(1),
118
+ records: zod_1.z
119
+ .array(zod_1.z
120
+ .object({
121
+ fields: zod_1.z.record(zod_1.z.unknown())
122
+ })
123
+ .strict())
124
+ .min(1),
125
+ typecast: zod_1.z.boolean().optional().default(false),
126
+ idempotencyKey: zod_1.z.string().min(1).optional(),
127
+ dryRun: zod_1.z.boolean().optional().default(false)
128
+ })
129
+ .strict();
130
+ const createDiffSchema = zod_1.z
131
+ .object({
132
+ added: zod_1.z.number().int().nonnegative(),
133
+ updated: zod_1.z.number().int().nonnegative(),
134
+ unchanged: zod_1.z.number().int().nonnegative()
135
+ })
136
+ .strict();
137
+ exports.createOutputSchema = zod_1.z
138
+ .object({
139
+ diff: createDiffSchema,
140
+ records: zod_1.z.array(recordSchema).optional(),
141
+ dryRun: zod_1.z.boolean(),
142
+ warnings: zod_1.z.array(zod_1.z.string()).optional()
143
+ })
144
+ .strict();
145
+ const conflictSchema = zod_1.z
146
+ .object({
147
+ id: zod_1.z.string(),
148
+ field: zod_1.z.string(),
149
+ before: zod_1.z.unknown().optional(),
150
+ after: zod_1.z.unknown().optional(),
151
+ current: zod_1.z.unknown()
152
+ })
153
+ .strict();
154
+ const mutationDiffSchema = zod_1.z
155
+ .object({
156
+ added: zod_1.z.number().int().nonnegative(),
157
+ updated: zod_1.z.number().int().nonnegative(),
158
+ unchanged: zod_1.z.number().int().nonnegative(),
159
+ conflicts: zod_1.z.number().int().nonnegative()
160
+ })
161
+ .strict();
162
+ exports.updateOutputSchema = zod_1.z
163
+ .object({
164
+ diff: mutationDiffSchema,
165
+ records: zod_1.z.array(recordSchema).optional(),
166
+ dryRun: zod_1.z.boolean(),
167
+ conflicts: zod_1.z.array(conflictSchema).optional()
168
+ })
169
+ .strict();
170
+ exports.updateInputSchema = zod_1.z
171
+ .object({
172
+ baseId: zod_1.z.string().min(1),
173
+ table: zod_1.z.string().min(1),
174
+ records: zod_1.z
175
+ .array(zod_1.z
176
+ .object({
177
+ id: zod_1.z.string(),
178
+ fields: zod_1.z.record(zod_1.z.unknown())
179
+ })
180
+ .strict())
181
+ .min(1),
182
+ typecast: zod_1.z.boolean().optional().default(false),
183
+ idempotencyKey: zod_1.z.string().min(1).optional(),
184
+ dryRun: zod_1.z.boolean().optional().default(false),
185
+ conflictStrategy: zod_1.z
186
+ .enum(['fail_on_conflict', 'server_merge', 'client_merge'])
187
+ .optional()
188
+ .default('fail_on_conflict'),
189
+ ifUnchangedHash: zod_1.z.string().optional()
190
+ })
191
+ .strict();
192
+ exports.upsertInputSchema = zod_1.z
193
+ .object({
194
+ baseId: zod_1.z.string().min(1),
195
+ table: zod_1.z.string().min(1),
196
+ records: zod_1.z
197
+ .array(zod_1.z
198
+ .object({
199
+ fields: zod_1.z.record(zod_1.z.unknown())
200
+ })
201
+ .strict())
202
+ .min(1),
203
+ performUpsert: zod_1.z
204
+ .object({
205
+ fieldsToMergeOn: zod_1.z.array(zod_1.z.string().min(1)).min(1)
206
+ })
207
+ .strict(),
208
+ typecast: zod_1.z.boolean().optional().default(false),
209
+ idempotencyKey: zod_1.z.string().min(1).optional(),
210
+ dryRun: zod_1.z.boolean().optional().default(false),
211
+ conflictStrategy: zod_1.z
212
+ .enum(['fail_on_conflict', 'server_merge', 'client_merge'])
213
+ .optional()
214
+ .default('fail_on_conflict')
215
+ })
216
+ .strict();
217
+ exports.upsertOutputSchema = zod_1.z
218
+ .object({
219
+ diff: mutationDiffSchema,
220
+ records: zod_1.z.array(recordSchema).optional(),
221
+ dryRun: zod_1.z.boolean(),
222
+ conflicts: zod_1.z.array(conflictSchema).optional()
223
+ })
224
+ .strict();
225
+ exports.listExceptionsInputSchema = zod_1.z
226
+ .object({
227
+ since: zod_1.z.string().optional(),
228
+ severity: zod_1.z.enum(['info', 'warning', 'error']).optional(),
229
+ limit: zod_1.z.number().int().min(1).max(500).optional().default(100),
230
+ cursor: zod_1.z.string().optional()
231
+ })
232
+ .strict();
233
+ exports.exceptionItemSchema = zod_1.z
234
+ .object({
235
+ id: zod_1.z.string(),
236
+ timestamp: zod_1.z.string(),
237
+ severity: zod_1.z.enum(['info', 'warning', 'error']),
238
+ category: zod_1.z.enum(['rate_limit', 'validation', 'auth', 'conflict', 'schema_drift', 'other']),
239
+ summary: zod_1.z.string(),
240
+ details: zod_1.z.string().optional(),
241
+ proposedFix: zod_1.z.record(zod_1.z.unknown()).optional()
242
+ })
243
+ .strict();
244
+ exports.listExceptionsOutputSchema = zod_1.z
245
+ .object({
246
+ items: zod_1.z.array(exports.exceptionItemSchema),
247
+ cursor: zod_1.z.string().optional()
248
+ })
249
+ .strict();
250
+ const allowedOperations = ['describe', 'query', 'create', 'update', 'upsert'];
251
+ exports.governanceOutputSchema = zod_1.z
252
+ .object({
253
+ allowedBases: zod_1.z.array(zod_1.z.string()),
254
+ allowedTables: zod_1.z
255
+ .array(zod_1.z
256
+ .object({
257
+ baseId: zod_1.z.string(),
258
+ table: zod_1.z.string()
259
+ })
260
+ .strict())
261
+ .optional()
262
+ .default([]),
263
+ allowedOperations: zod_1.z
264
+ .array(zod_1.z.enum(allowedOperations))
265
+ .default([...allowedOperations]),
266
+ piiFields: zod_1.z
267
+ .array(zod_1.z
268
+ .object({
269
+ baseId: zod_1.z.string(),
270
+ table: zod_1.z.string(),
271
+ field: zod_1.z.string(),
272
+ policy: zod_1.z.enum(['mask', 'hash', 'drop'])
273
+ })
274
+ .strict())
275
+ .optional()
276
+ .default([]),
277
+ redactionPolicy: zod_1.z.enum(['mask_all_pii', 'mask_on_inline', 'none']).default('mask_on_inline'),
278
+ loggingPolicy: zod_1.z.enum(['errors_only', 'minimal', 'verbose']).default('minimal'),
279
+ retentionDays: zod_1.z.number().int().min(0).default(7)
280
+ })
281
+ .strict();
282
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/typescript/app/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,70 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.toInlineResultCard = toInlineResultCard;
4
+ exports.toFullscreenGrid = toFullscreenGrid;
5
+ exports.buildDiffModalForCreate = buildDiffModalForCreate;
6
+ exports.buildDiffModalForUpdate = buildDiffModalForUpdate;
7
+ function toInlineResultCard(table, result) {
8
+ const sample = result.records.slice(0, 5);
9
+ const colSet = new Set();
10
+ for (const r of sample)
11
+ Object.keys(r.fields || {}).forEach((k) => colSet.add(k));
12
+ const columns = Array.from(colSet).map((k) => ({ key: k, label: k }));
13
+ return {
14
+ title: `${table}`,
15
+ subtitle: sample.length > 0 && typeof result.summary?.returned === 'number'
16
+ ? `Showing ${sample.length} of ${result.summary.returned}${result.summary.hasMore ? '+' : ''}`
17
+ : undefined,
18
+ columns,
19
+ rows: sample.map((r) => ({ id: r.id, ...r.fields })),
20
+ pagination: { hasMore: Boolean(result.summary?.hasMore), nextOffset: result.offset },
21
+ actions: ['view_fullscreen', 'export_csv'],
22
+ state: sample.length === 0 ? 'empty' : 'ready'
23
+ };
24
+ }
25
+ function toFullscreenGrid(_table, result, selection = []) {
26
+ const colSet = new Set();
27
+ for (const r of result.records)
28
+ Object.keys(r.fields || {}).forEach((k) => colSet.add(k));
29
+ const columns = Array.from(colSet).map((k) => ({ key: k, label: k }));
30
+ return {
31
+ columns,
32
+ rows: result.records.map((r) => ({ id: r.id, ...(r.fields || {}) })),
33
+ filters: {},
34
+ sorts: [],
35
+ selection,
36
+ toolbarActions: ['propose_edit', 'upsert_by_key', 'export_csv'],
37
+ state: result.records.length === 0 ? 'empty' : 'ready'
38
+ };
39
+ }
40
+ function buildDiffModalForCreate(output, idempotencyKey) {
41
+ const changes = [];
42
+ for (const r of output.records || []) {
43
+ const fields = r.fields || {};
44
+ for (const [field, after] of Object.entries(fields)) {
45
+ changes.push({ recordId: r.id || 'new', field, before: null, after, status: 'add' });
46
+ }
47
+ }
48
+ return {
49
+ changes,
50
+ idempotencyKey,
51
+ confirmAction: 'create',
52
+ cancelAction: 'close'
53
+ };
54
+ }
55
+ function buildDiffModalForUpdate(output, idempotencyKey) {
56
+ const changes = [];
57
+ for (const r of output.records || []) {
58
+ const fields = r.fields || {};
59
+ for (const [field, after] of Object.entries(fields)) {
60
+ changes.push({ recordId: r.id, field, before: undefined, after, status: 'update' });
61
+ }
62
+ }
63
+ return {
64
+ changes,
65
+ idempotencyKey,
66
+ confirmAction: 'update',
67
+ cancelAction: 'close'
68
+ };
69
+ }
70
+ //# sourceMappingURL=mappers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mappers.js","sourceRoot":"","sources":["../../../src/typescript/apps-sdk/mappers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ "use strict";
2
+ /**
3
+ * Error taxonomy aligned with Airtable Brain guardrails.
4
+ *
5
+ * All tool errors should use these types so the LLM can reason about
6
+ * retry behaviour and user messaging. Avoid leaking raw Airtable payloads
7
+ * through error messages.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.GovernanceError = exports.InternalServerError = exports.NotFoundError = exports.ConflictError = exports.AuthError = exports.AirtableValidationError = exports.RateLimitError = exports.AirtableBrainError = void 0;
11
+ class AirtableBrainError extends Error {
12
+ constructor(code, message, options = {}) {
13
+ super(message);
14
+ this.name = code;
15
+ this.code = code;
16
+ if (options.cause !== undefined) {
17
+ this.cause = options.cause;
18
+ }
19
+ if (options.status !== undefined) {
20
+ this.status = options.status;
21
+ }
22
+ if (options.retryAfterMs !== undefined) {
23
+ this.retryAfterMs = options.retryAfterMs;
24
+ }
25
+ this.context = options.context ?? {};
26
+ }
27
+ withContext(context) {
28
+ Object.assign(this.context, context);
29
+ return this;
30
+ }
31
+ }
32
+ exports.AirtableBrainError = AirtableBrainError;
33
+ class RateLimitError extends AirtableBrainError {
34
+ constructor(message, options = {}) {
35
+ super('RateLimited', message, options);
36
+ }
37
+ }
38
+ exports.RateLimitError = RateLimitError;
39
+ class AirtableValidationError extends AirtableBrainError {
40
+ constructor(message, options = {}) {
41
+ super('ValidationError', message, options);
42
+ }
43
+ }
44
+ exports.AirtableValidationError = AirtableValidationError;
45
+ class AuthError extends AirtableBrainError {
46
+ constructor(message, options = {}) {
47
+ super('AuthError', message, options);
48
+ }
49
+ }
50
+ exports.AuthError = AuthError;
51
+ class ConflictError extends AirtableBrainError {
52
+ constructor(message, options = {}) {
53
+ super('ConflictError', message, options);
54
+ }
55
+ }
56
+ exports.ConflictError = ConflictError;
57
+ class NotFoundError extends AirtableBrainError {
58
+ constructor(message, options = {}) {
59
+ super('NotFound', message, options);
60
+ }
61
+ }
62
+ exports.NotFoundError = NotFoundError;
63
+ class InternalServerError extends AirtableBrainError {
64
+ constructor(message, options = {}) {
65
+ super('InternalError', message, options);
66
+ }
67
+ }
68
+ exports.InternalServerError = InternalServerError;
69
+ class GovernanceError extends AirtableBrainError {
70
+ constructor(message, options = {}) {
71
+ super('GovernanceError', message, options);
72
+ }
73
+ }
74
+ exports.GovernanceError = GovernanceError;
75
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/typescript/errors.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA8BH,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"}