@opentabs-dev/opentabs-plugin-airtable 0.0.74

package/dist/airtable-api.d.ts

@@ -0,0 +1,12 @@
+export declare const isAuthenticated: () => boolean;
+export declare const waitForAuth: () => Promise<boolean>;
+export declare const getUserId: () => string;
+/** GET request to Airtable internal API with stringifiedObjectParams query */
+export declare const apiGet: <T>(endpoint: string, params?: Record<string, unknown>, options?: {
+    appId?: string;
+}) => Promise<T>;
+/** POST request to Airtable internal API with stringifiedObjectParams body + CSRF */
+export declare const apiPost: <T>(endpoint: string, params?: Record<string, unknown>, options?: {
+    appId?: string;
+}) => Promise<T>;
+//# sourceMappingURL=airtable-api.d.ts.map

package/dist/airtable-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"airtable-api.d.ts","sourceRoot":"","sources":["../src/airtable-api.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,eAAe,QAAO,OAA6B,CAAC;AAEjE,eAAO,MAAM,WAAW,QAAO,OAAO,CAAC,OAAO,CAI3C,CAAC;AAEJ,eAAO,MAAM,SAAS,QAAO,MAI5B,CAAC;AAyBF,8EAA8E;AAC9E,eAAO,MAAM,MAAM,GAAU,CAAC,EAC5B,UAAU,MAAM,EAChB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,UAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,KAC/B,OAAO,CAAC,CAAC,CA+BX,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,OAAO,GAAU,CAAC,EAC7B,UAAU,MAAM,EAChB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,UAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,KAC/B,OAAO,CAAC,CAAC,CAiCX,CAAC"}

package/dist/airtable-api.js

@@ -0,0 +1,146 @@
+import { ToolError, getPageGlobal, parseRetryAfterMs, waitUntil } from '@opentabs-dev/plugin-sdk';
+// --- Auth detection ---
+// Airtable uses HttpOnly session cookies. Auth is detected via window.initData
+// which contains sessionUserId and csrfToken for authenticated users.
+const getAuth = () => {
+    const sessionUserId = getPageGlobal('initData.sessionUserId');
+    const csrfToken = getPageGlobal('initData.csrfToken');
+    if (typeof sessionUserId !== 'string' || typeof csrfToken !== 'string')
+        return null;
+    // Public share context users start with usrPAGESHARE — these are not real users
+    if (sessionUserId.startsWith('usrPAGESHARE'))
+        return null;
+    return { userId: sessionUserId, csrfToken };
+};
+export const isAuthenticated = () => getAuth() !== null;
+export const waitForAuth = () => waitUntil(() => isAuthenticated(), { interval: 500, timeout: 5000 }).then(() => true, () => false);
+export const getUserId = () => {
+    const auth = getAuth();
+    if (!auth)
+        throw ToolError.auth('Not authenticated — please log in to Airtable.');
+    return auth.userId;
+};
+const getCsrf = () => {
+    const auth = getAuth();
+    if (!auth)
+        throw ToolError.auth('Not authenticated — please log in to Airtable.');
+    return auth.csrfToken;
+};
+// --- Request helpers ---
+const COMMON_HEADERS = {
+    'x-airtable-inter-service-client': 'webClient',
+    'x-requested-with': 'XMLHttpRequest',
+};
+const getTimezone = () => {
+    try {
+        return Intl.DateTimeFormat().resolvedOptions().timeZone;
+    }
+    catch {
+        return 'UTC';
+    }
+};
+// --- API callers ---
+/** GET request to Airtable internal API with stringifiedObjectParams query */
+export const apiGet = async (endpoint, params = {}, options = {}) => {
+    if (!getAuth())
+        throw ToolError.auth('Not authenticated — please log in to Airtable.');
+    const qs = new URLSearchParams({
+        stringifiedObjectParams: JSON.stringify(params),
+        requestId: `req${Math.random().toString(36).slice(2, 10)}`,
+    });
+    const headers = {
+        ...COMMON_HEADERS,
+        'x-time-zone': getTimezone(),
+    };
+    if (options.appId)
+        headers['x-airtable-application-id'] = options.appId;
+    let response;
+    try {
+        response = await fetch(`/v0.3/${endpoint}?${qs}`, {
+            credentials: 'include',
+            headers,
+            signal: AbortSignal.timeout(30_000),
+        });
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === 'TimeoutError')
+            throw ToolError.timeout(`API request timed out: ${endpoint}`);
+        throw new ToolError(`Network error: ${err instanceof Error ? err.message : String(err)}`, 'network_error', {
+            category: 'internal',
+            retryable: true,
+        });
+    }
+    return handleResponse(response, endpoint);
+};
+/** POST request to Airtable internal API with stringifiedObjectParams body + CSRF */
+export const apiPost = async (endpoint, params = {}, options = {}) => {
+    if (!getAuth())
+        throw ToolError.auth('Not authenticated — please log in to Airtable.');
+    const headers = {
+        ...COMMON_HEADERS,
+        'Content-Type': 'application/json',
+        'x-time-zone': getTimezone(),
+    };
+    if (options.appId)
+        headers['x-airtable-application-id'] = options.appId;
+    let response;
+    try {
+        response = await fetch(`/v0.3/${endpoint}`, {
+            method: 'POST',
+            credentials: 'include',
+            headers,
+            body: JSON.stringify({
+                stringifiedObjectParams: JSON.stringify(params),
+                requestId: `req${Math.random().toString(36).slice(2, 10)}`,
+                _csrf: getCsrf(),
+            }),
+            signal: AbortSignal.timeout(30_000),
+        });
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === 'TimeoutError')
+            throw ToolError.timeout(`API request timed out: ${endpoint}`);
+        throw new ToolError(`Network error: ${err instanceof Error ? err.message : String(err)}`, 'network_error', {
+            category: 'internal',
+            retryable: true,
+        });
+    }
+    return handleResponse(response, endpoint);
+};
+// --- Response handler ---
+const handleResponse = async (response, endpoint) => {
+    if (!response.ok) {
+        const errorBody = (await response.text().catch(() => '')).substring(0, 512);
+        if (response.status === 429) {
+            const retryAfter = response.headers.get('Retry-After');
+            const retryMs = retryAfter !== null ? parseRetryAfterMs(retryAfter) : undefined;
+            throw ToolError.rateLimited(`Rate limited: ${endpoint} — ${errorBody}`, retryMs);
+        }
+        if (response.status === 401)
+            throw ToolError.auth(`Auth error (${response.status}): ${errorBody}`);
+        if (response.status === 403) {
+            // Airtable uses 403 for both auth and permission errors — distinguish by error body
+            if (errorBody.includes('INVALID_PERMISSIONS'))
+                throw ToolError.validation(`Permission denied: ${endpoint} — ${errorBody}`);
+            throw ToolError.auth(`Auth error (${response.status}): ${errorBody}`);
+        }
+        if (response.status === 404)
+            throw ToolError.notFound(`Not found: ${endpoint} — ${errorBody}`);
+        if (response.status === 422)
+            throw ToolError.validation(`Invalid request: ${endpoint} — ${errorBody}`);
+        throw ToolError.internal(`API error (${response.status}): ${endpoint} — ${errorBody}`);
+    }
+    if (response.status === 204)
+        return {};
+    const json = (await response.json());
+    if (json.error) {
+        const errMsg = json.error.message ?? json.error.type ?? 'Unknown error';
+        if (json.error.type === 'NOT_FOUND' || json.error.type === 'MODEL_ID_NOT_FOUND')
+            throw ToolError.notFound(`Not found: ${endpoint} — ${errMsg}`);
+        if (json.error.type === 'INVALID_REQUEST' || json.error.type === 'INVALID_MODEL_ID')
+            throw ToolError.validation(`Invalid request: ${endpoint} — ${errMsg}`);
+        throw ToolError.internal(`API error: ${endpoint} — ${errMsg}`);
+    }
+    return (json.data ?? json);
+};
+//# sourceMappingURL=airtable-api.js.map

package/dist/airtable-api.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { OpenTabsPlugin } from '@opentabs-dev/plugin-sdk';
+import type { ToolDefinition } from '@opentabs-dev/plugin-sdk';
+declare class AirtablePlugin extends OpenTabsPlugin {
+    readonly name = "airtable";
+    readonly description = "OpenTabs plugin for Airtable \u2014 read and write data in Airtable bases, tables, and records through the authenticated browser session.";
+    readonly displayName = "Airtable";
+    readonly urlPatterns: string[];
+    readonly homepage = "https://airtable.com";
+    readonly tools: ToolDefinition[];
+    isReady(): Promise<boolean>;
+}
+declare const _default: AirtablePlugin;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAW/D,cAAM,cAAe,SAAQ,cAAc;IACzC,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,+IACqH;IACzI,SAAkB,WAAW,cAAc;IAC3C,QAAQ,CAAC,WAAW,WAA4B;IAChD,SAAkB,QAAQ,0BAA0B;IACpD,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAS9B;IAEI,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAIlC;;AAED,wBAAoC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+import { OpenTabsPlugin } from '@opentabs-dev/plugin-sdk';
+import { isAuthenticated, waitForAuth } from './airtable-api.js';
+import { createComment } from './tools/create-comment.js';
+import { getBaseSchema } from './tools/get-base-schema.js';
+import { getFieldChoices } from './tools/get-field-choices.js';
+import { getRecord } from './tools/get-record.js';
+import { getRecordActivity } from './tools/get-record-activity.js';
+import { listRecords } from './tools/list-records.js';
+import { listWorkspaces } from './tools/list-workspaces.js';
+import { updateCell } from './tools/update-cell.js';
+class AirtablePlugin extends OpenTabsPlugin {
+    name = 'airtable';
+    description = 'OpenTabs plugin for Airtable — read and write data in Airtable bases, tables, and records through the authenticated browser session.';
+    displayName = 'Airtable';
+    urlPatterns = ['*://*.airtable.com/*'];
+    homepage = 'https://airtable.com';
+    tools = [
+        listWorkspaces,
+        getBaseSchema,
+        listRecords,
+        getRecord,
+        updateCell,
+        getRecordActivity,
+        createComment,
+        getFieldChoices,
+    ];
+    async isReady() {
+        if (isAuthenticated())
+            return true;
+        return waitForAuth();
+    }
+}
+export default new AirtablePlugin();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,cAAe,SAAQ,cAAc;IAChC,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAClB,sIAAsI,CAAC;IACvH,WAAW,GAAG,UAAU,CAAC;IAClC,WAAW,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC9B,QAAQ,GAAG,sBAAsB,CAAC;IAC3C,KAAK,GAAqB;QACjC,cAAc;QACd,aAAa;QACb,WAAW;QACX,SAAS;QACT,UAAU;QACV,iBAAiB;QACjB,aAAa;QACb,eAAe;KAChB,CAAC;IAEF,KAAK,CAAC,OAAO;QACX,IAAI,eAAe,EAAE;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC;CACF;AAED,eAAe,IAAI,cAAc,EAAE,CAAC"}

package/dist/tools/create-comment.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export declare const createComment: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    base_id: z.ZodString;
+    table_id: z.ZodString;
+    record_id: z.ZodString;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodBoolean;
+}, z.core.$strip>>;
+//# sourceMappingURL=create-comment.d.ts.map

package/dist/tools/create-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-comment.d.ts","sourceRoot":"","sources":["../../src/tools/create-comment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,aAAa;;;;;;;kBA4BxB,CAAC"}

package/dist/tools/create-comment.js

@@ -0,0 +1,28 @@
+import { defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { apiPost } from '../airtable-api.js';
+export const createComment = defineTool({
+    name: 'create_comment',
+    displayName: 'Create Comment',
+    description: 'Add a comment to a record. Comments are visible to all collaborators on the base.',
+    summary: 'Add a comment to a record',
+    icon: 'message-square',
+    group: 'Records',
+    input: z.object({
+        base_id: z.string().describe('Base ID (app prefix)'),
+        table_id: z.string().describe('Table ID (tbl prefix)'),
+        record_id: z.string().describe('Record ID (rec prefix)'),
+        text: z.string().describe('Comment text'),
+    }),
+    output: z.object({
+        success: z.boolean().describe('Whether the comment was created'),
+    }),
+    handle: async (params) => {
+        await apiPost(`row/${params.record_id}/createRowComment`, {
+            tableId: params.table_id,
+            text: params.text,
+        }, { appId: params.base_id });
+        return { success: true };
+    },
+});
+//# sourceMappingURL=create-comment.js.map

package/dist/tools/create-comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-comment.js","sourceRoot":"","sources":["../../src/tools/create-comment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,mFAAmF;IAChG,OAAO,EAAE,2BAA2B;IACpC,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;KAC1C,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KACjE,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,OAAO,CACX,OAAO,MAAM,CAAC,SAAS,mBAAmB,EAC1C;YACE,OAAO,EAAE,MAAM,CAAC,QAAQ;YACxB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,EACD,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAC1B,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/get-base-schema.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const getBaseSchema: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    base_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    tables: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodString;
+            description: z.ZodString;
+        }, z.core.$strip>>;
+        views: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-base-schema.d.ts.map

package/dist/tools/get-base-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-base-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-base-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4BxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;kBA6BxB,CAAC"}

package/dist/tools/get-base-schema.js

@@ -0,0 +1,29 @@
+import { defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { apiGet } from '../airtable-api.js';
+import { mapTable, tableSchema } from './schemas.js';
+export const getBaseSchema = defineTool({
+    name: 'get_base_schema',
+    displayName: 'Get Base Schema',
+    description: 'Get the full schema of an Airtable base including all tables, fields (columns), and views. Use this to understand the structure before reading or writing records.',
+    summary: 'Get all tables, fields, and views in a base',
+    icon: 'database',
+    group: 'Bases',
+    input: z.object({
+        base_id: z.string().describe('Base ID (app prefix, e.g., "appCJ2w2lRQp9Vxm0")'),
+    }),
+    output: z.object({
+        tables: z.array(tableSchema).describe('All tables in the base with their fields and views'),
+    }),
+    handle: async (params) => {
+        const data = await apiGet(`application/${params.base_id}/read`, {
+            includeDataForTableIds: [],
+            shouldIncludeSchemaChecksum: false,
+            mayOnlyIncludeRowAndCellDataForIncludedViews: true,
+            allowMsgpackOfResult: false,
+        }, { appId: params.base_id });
+        const tables = (data.tableSchemas ?? []).map(mapTable);
+        return { tables };
+    },
+});
+//# sourceMappingURL=get-base-schema.js.map

package/dist/tools/get-base-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-base-schema.js","sourceRoot":"","sources":["../../src/tools/get-base-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA0BrD,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EACT,oKAAoK;IACtK,OAAO,EAAE,6CAA6C;IACtD,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;KAChF,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,oDAAoD,CAAC;KAC5F,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,IAAI,GAAG,MAAM,MAAM,CACvB,eAAe,MAAM,CAAC,OAAO,OAAO,EACpC;YACE,sBAAsB,EAAE,EAAE;YAC1B,2BAA2B,EAAE,KAAK;YAClC,4CAA4C,EAAE,IAAI;YAClD,oBAAoB,EAAE,KAAK;SAC5B,EACD,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAC1B,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvD,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/get-field-choices.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const getFieldChoices: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    base_id: z.ZodString;
+    table_id: z.ZodString;
+    field_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    choices: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        color: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-field-choices.d.ts.map

package/dist/tools/get-field-choices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-field-choices.d.ts","sourceRoot":"","sources":["../../src/tools/get-field-choices.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,eAAO,MAAM,eAAe;;;;;;;;;;kBA4C1B,CAAC"}

package/dist/tools/get-field-choices.js

@@ -0,0 +1,41 @@
+import { ToolError, defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { apiGet } from '../airtable-api.js';
+import { mapChoice, selectChoiceSchema } from './schemas.js';
+export const getFieldChoices = defineTool({
+    name: 'get_field_choices',
+    displayName: 'Get Field Choices',
+    description: 'Get the available choices for a single-select or multi-select field. Returns choice IDs, names, and colors. Use the choice ID (sel prefix) when setting cell values for select fields.',
+    summary: 'Get select/multi-select field choices',
+    icon: 'list',
+    group: 'Fields',
+    input: z.object({
+        base_id: z.string().describe('Base ID (app prefix)'),
+        table_id: z.string().describe('Table ID (tbl prefix)'),
+        field_id: z.string().describe('Field/column ID (fld prefix) — must be a select or multiSelect type'),
+    }),
+    output: z.object({
+        choices: z.array(selectChoiceSchema).describe('Available choices for the field'),
+    }),
+    handle: async (params) => {
+        const data = await apiGet(`application/${params.base_id}/read`, {
+            includeDataForTableIds: [],
+            shouldIncludeSchemaChecksum: false,
+            mayOnlyIncludeRowAndCellDataForIncludedViews: true,
+            allowMsgpackOfResult: false,
+        }, { appId: params.base_id });
+        const table = (data.tableSchemas ?? []).find(t => t.id === params.table_id);
+        if (!table)
+            throw ToolError.notFound(`Table ${params.table_id} not found`);
+        const field = (table.columns ?? []).find(c => c.id === params.field_id);
+        if (!field)
+            throw ToolError.notFound(`Field ${params.field_id} not found in table ${params.table_id}`);
+        if (field.type !== 'select' && field.type !== 'multiSelect')
+            throw ToolError.validation(`Field ${params.field_id} is type "${field.type}", not a select field`);
+        const choicesMap = field.typeOptions?.choices ?? {};
+        const choiceOrder = field.typeOptions?.choiceOrder ?? Object.keys(choicesMap);
+        const choices = choiceOrder.map(id => mapChoice(choicesMap[id] ?? { id }));
+        return { choices };
+    },
+});
+//# sourceMappingURL=get-field-choices.js.map

package/dist/tools/get-field-choices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-field-choices.js","sourceRoot":"","sources":["../../src/tools/get-field-choices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAqB7D,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACxC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,mBAAmB;IAChC,WAAW,EACT,wLAAwL;IAC1L,OAAO,EAAE,uCAAuC;IAChD,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACtD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;KACrG,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KACjF,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,IAAI,GAAG,MAAM,MAAM,CACvB,eAAe,MAAM,CAAC,OAAO,OAAO,EACpC;YACE,sBAAsB,EAAE,EAAE;YAC1B,2BAA2B,EAAE,KAAK;YAClC,4CAA4C,EAAE,IAAI;YAClD,oBAAoB,EAAE,KAAK;SAC5B,EACD,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAC1B,CAAC;QAEF,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,SAAS,MAAM,CAAC,QAAQ,YAAY,CAAC,CAAC;QAE3E,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,SAAS,MAAM,CAAC,QAAQ,uBAAuB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEvG,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;YACzD,MAAM,SAAS,CAAC,UAAU,CAAC,SAAS,MAAM,CAAC,QAAQ,aAAa,KAAK,CAAC,IAAI,uBAAuB,CAAC,CAAC;QAErG,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE9E,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAE3E,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/get-record-activity.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const getRecordActivity: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    base_id: z.ZodString;
+    table_id: z.ZodString;
+    record_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    activities: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        user_id: z.ZodString;
+        user_name: z.ZodString;
+        timestamp: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+    comments: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        author_name: z.ZodString;
+        text: z.ZodString;
+        created_time: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-record-activity.d.ts.map

package/dist/tools/get-record-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-record-activity.d.ts","sourceRoot":"","sources":["../../src/tools/get-record-activity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyCxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;kBAsE5B,CAAC"}

package/dist/tools/get-record-activity.js

@@ -0,0 +1,73 @@
+import { defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { apiGet } from '../airtable-api.js';
+const stripHtml = (html) => html.replace(/<[^>]+>/g, '').trim();
+const activitySchema = z.object({
+    id: z.string().describe('Activity ID'),
+    type: z.string().describe('Activity type (e.g., cellUpdate, rowCreated)'),
+    user_id: z.string().describe('User ID who performed the action'),
+    user_name: z.string().describe('User display name'),
+    timestamp: z.string().describe('ISO 8601 timestamp'),
+    description: z.string().describe('Human-readable description of the change'),
+});
+export const getRecordActivity = defineTool({
+    name: 'get_record_activity',
+    displayName: 'Get Record Activity',
+    description: 'Get the activity history and comments for a record. Returns a chronological list of changes (cell updates, record creation, comments, etc.) with user attribution.',
+    summary: 'Get activity history and comments for a record',
+    icon: 'history',
+    group: 'Records',
+    input: z.object({
+        base_id: z.string().describe('Base ID (app prefix)'),
+        table_id: z.string().describe('Table ID (tbl prefix)'),
+        record_id: z.string().describe('Record ID (rec prefix)'),
+    }),
+    output: z.object({
+        activities: z.array(activitySchema).describe('Activity history for the record'),
+        comments: z
+            .array(z.object({
+            id: z.string().describe('Comment ID'),
+            author_name: z.string().describe('Comment author name'),
+            text: z.string().describe('Comment text'),
+            created_time: z.string().describe('ISO 8601 creation timestamp'),
+        }))
+            .describe('Comments on the record'),
+    }),
+    handle: async (params) => {
+        const data = await apiGet(`row/${params.record_id}/readRowActivitiesAndComments`, { tableId: params.table_id }, { appId: params.base_id });
+        const users = data.rowActivityOrCommentUserObjById ?? {};
+        const activityInfos = data.rowActivityInfoById ?? {};
+        const orderedIds = data.orderedActivityAndCommentIds ?? [];
+        const activities = orderedIds
+            .filter(id => activityInfos[id] !== undefined)
+            .map(id => {
+            const info = activityInfos[id];
+            const userId = info.originatingUserId ?? '';
+            const user = users[userId] ?? {};
+            return {
+                id,
+                type: info.groupType ?? '',
+                user_id: userId,
+                user_name: user.name ?? '',
+                timestamp: info.createdTime ?? '',
+                description: stripHtml(info.diffRowHtml ?? ''),
+            };
+        });
+        const commentRecords = data.commentsById ?? {};
+        const comments = orderedIds
+            .filter(id => commentRecords[id] !== undefined)
+            .map(id => {
+            const c = commentRecords[id];
+            const commentUserId = c.userId ?? '';
+            const commentUser = users[commentUserId] ?? {};
+            return {
+                id,
+                author_name: commentUser.name ?? '',
+                text: c.text ?? '',
+                created_time: c.createdTime ?? '',
+            };
+        });
+        return { activities, comments };
+    },
+});
+//# sourceMappingURL=get-record-activity.js.map

package/dist/tools/get-record-activity.js.map

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

package/dist/tools/get-record.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const getRecord: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    base_id: z.ZodString;
+    table_id: z.ZodString;
+    record_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    record: z.ZodObject<{
+        id: z.ZodString;
+        created_time: z.ZodString;
+        cell_values: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-record.d.ts.map

package/dist/tools/get-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-record.d.ts","sourceRoot":"","sources":["../../src/tools/get-record.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,eAAO,MAAM,SAAS;;;;;;;;;;kBAkCpB,CAAC"}

package/dist/tools/get-record.js

@@ -0,0 +1,34 @@
+import { ToolError, defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { apiGet } from '../airtable-api.js';
+import { mapRecord, recordSchema } from './schemas.js';
+export const getRecord = defineTool({
+    name: 'get_record',
+    displayName: 'Get Record',
+    description: 'Get a single record (row) by its ID. Returns all cell values for the record.',
+    summary: 'Get a single record by ID',
+    icon: 'file-text',
+    group: 'Records',
+    input: z.object({
+        base_id: z.string().describe('Base ID (app prefix)'),
+        table_id: z.string().describe('Table ID (tbl prefix)'),
+        record_id: z.string().describe('Record ID (rec prefix)'),
+    }),
+    output: z.object({
+        record: recordSchema.describe('The requested record'),
+    }),
+    handle: async (params) => {
+        const data = await apiGet(`application/${params.base_id}/read`, {
+            includeDataForTableIds: [params.table_id],
+            shouldIncludeSchemaChecksum: false,
+            mayOnlyIncludeRowAndCellDataForIncludedViews: false,
+            allowMsgpackOfResult: false,
+        }, { appId: params.base_id });
+        const tableData = (data.tableDatas ?? []).find(td => td.id === params.table_id || td.tableId === params.table_id);
+        const row = (tableData?.rows ?? []).find(r => r.id === params.record_id);
+        if (!row)
+            throw ToolError.notFound(`Record ${params.record_id} not found in table ${params.table_id}`);
+        return { record: mapRecord(row) };
+    },
+});
+//# sourceMappingURL=get-record.js.map

package/dist/tools/get-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-record.js","sourceRoot":"","sources":["../../src/tools/get-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAkBvD,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,8EAA8E;IAC3F,OAAO,EAAE,2BAA2B;IACpC,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;KACzD,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KACtD,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,IAAI,GAAG,MAAM,MAAM,CACvB,eAAe,MAAM,CAAC,OAAO,OAAO,EACpC;YACE,sBAAsB,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;YACzC,2BAA2B,EAAE,KAAK;YAClC,4CAA4C,EAAE,KAAK;YACnD,oBAAoB,EAAE,KAAK;SAC5B,EACD,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAC1B,CAAC;QAEF,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,OAAO,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClH,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC;QAEzE,IAAI,CAAC,GAAG;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,UAAU,MAAM,CAAC,SAAS,uBAAuB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEvG,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IACpC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/list-records.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const listRecords: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    base_id: z.ZodString;
+    table_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    records: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        created_time: z.ZodString;
+        cell_values: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=list-records.d.ts.map

package/dist/tools/list-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-records.d.ts","sourceRoot":"","sources":["../../src/tools/list-records.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,eAAO,MAAM,WAAW;;;;;;;;;kBAgCtB,CAAC"}

package/dist/tools/list-records.js

@@ -0,0 +1,31 @@
+import { defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { apiGet } from '../airtable-api.js';
+import { mapRecord, recordSchema } from './schemas.js';
+export const listRecords = defineTool({
+    name: 'list_records',
+    displayName: 'List Records',
+    description: 'List all records (rows) in a table. Returns record IDs, creation times, and cell values keyed by field ID. Use get_base_schema first to learn the field IDs and their types.',
+    summary: 'List all records in a table',
+    icon: 'table',
+    group: 'Records',
+    input: z.object({
+        base_id: z.string().describe('Base ID (app prefix)'),
+        table_id: z.string().describe('Table ID (tbl prefix)'),
+    }),
+    output: z.object({
+        records: z.array(recordSchema).describe('All records in the table'),
+    }),
+    handle: async (params) => {
+        const data = await apiGet(`application/${params.base_id}/read`, {
+            includeDataForTableIds: [params.table_id],
+            shouldIncludeSchemaChecksum: false,
+            mayOnlyIncludeRowAndCellDataForIncludedViews: false,
+            allowMsgpackOfResult: false,
+        }, { appId: params.base_id });
+        const tableData = (data.tableDatas ?? []).find(td => td.id === params.table_id || td.tableId === params.table_id);
+        const records = (tableData?.rows ?? []).map(mapRecord);
+        return { records };
+    },
+});
+//# sourceMappingURL=list-records.js.map