@addai/tables-mcp 0.7.0

package/dist/tools/rows.js

@@ -0,0 +1,244 @@
+import { z } from 'zod';
+import { mcpError, mcpResult } from '../helpers/errors.js';
+import { buildColumnMap, translateToIds } from '../helpers/mapped-columns.js';
+import { findOptionViolations, formatOptionViolations, addMissingOptions, } from '../helpers/validate-options.js';
+export function registerRowTools(server, client) {
+    // ── list_rows ──
+    server.tool('list_rows', 'List rows from a table with optional filtering and sorting. Returns data with human-readable column names. Call get_table_schema first to understand the columns.', {
+        table_id: z.string().uuid().describe('The table to read rows from'),
+        page: z.number().int().positive().default(1).optional().describe('Page number (default 1)'),
+        page_size: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .default(50)
+            .optional()
+            .describe('Rows per page, max 200 (default 50)'),
+        sort_by: z
+            .enum(['created_date', 'updated_date', 'sort_order'])
+            .default('created_date')
+            .optional()
+            .describe('Field to sort by'),
+        sort_order: z
+            .enum(['asc', 'desc'])
+            .default('asc')
+            .optional()
+            .describe('Sort direction'),
+        filters: z
+            .array(z.object({
+            column: z.string().describe('Column name (human-readable, not UUID)'),
+            operator: z
+                .enum([
+                'eq', 'neq', 'contains', 'gt', 'lt', 'gte', 'lte', 'is_null', 'not_null',
+                'equals', 'not_equals', 'is', 'is_not', 'not_contains', 'starts_with', 'ends_with',
+                'greater_than', 'less_than', 'greater_than_or_equal', 'less_than_or_equal',
+                'is_empty', 'is_not_empty', 'is_any_of', 'is_none_of',
+                'is_checked', 'is_not_checked', 'is_true', 'is_false',
+            ])
+                .describe('Filter operator'),
+            value: z.unknown().optional().describe('Value to compare against'),
+        }))
+            .optional()
+            .describe('Filter rows by column values'),
+        columns: z
+            .array(z.string())
+            .optional()
+            .describe('Return only these columns (by name) — much smaller payloads. Omit for all columns. Ideal for scans/rankings, e.g. ["Name","Status","Impact","Effort"].'),
+    }, async ({ table_id, page, page_size, sort_by, sort_order, filters, columns }) => {
+        const params = {
+            mapped_columns: 'true',
+            page: String(page ?? 1),
+            page_size: String(page_size ?? 50),
+        };
+        if (sort_by)
+            params.sort_by = sort_by;
+        if (sort_order)
+            params.sort_order = sort_order;
+        if (columns && columns.length > 0)
+            params.columns = columns.join(',');
+        // Translate column name filters to column ID filters
+        if (filters && filters.length > 0) {
+            const colMap = await buildColumnMap(client, table_id);
+            const apiFilters = filters.map((f) => ({
+                column_id: colMap.nameToId.get(f.column) || f.column,
+                operator: f.operator,
+                value: f.value,
+            }));
+            params.filters = JSON.stringify(apiFilters);
+        }
+        const res = await client.get(`/tables/${table_id}/rows`, params);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({
+            rows: res.data,
+            pagination: res.pagination,
+        });
+    });
+    // ── get_row ──
+    server.tool('get_row', 'Fetch a single row/record by its ID and return its full contents with human-readable column names. ' +
+        'If you already know which table the record is in, pass table_id (fastest). ' +
+        'If you only have the record ID (e.g. a task/bug id) omit table_id — the server finds which table it ' +
+        'belongs to (works for both native and BYODB/direct-query tables) and returns that table context, so ' +
+        'you can immediately update it or comment on it without hunting for the table_id first. Returns { row, table }.', {
+        row_id: z
+            .string()
+            .min(1)
+            .describe('The record/row ID (primary key). For BYODB tables this is the external primary key value.'),
+        table_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Optional — the table the record is in, if you already know it. Omit to resolve automatically from the row ID.'),
+    }, async ({ row_id, table_id }) => {
+        const params = { mapped_columns: 'true' };
+        const path = table_id
+            ? `/tables/${table_id}/rows/${row_id}`
+            : `/rows/${encodeURIComponent(row_id)}`;
+        const res = await client.get(path, params);
+        if (res.error)
+            return mcpError(res.error.message);
+        // The resolver endpoint also returns a `table` context block; the per-table
+        // endpoint does not. Surface whichever is present.
+        const table = res.table;
+        return mcpResult(table !== undefined ? { row: res.data, table } : { row: res.data });
+    });
+    // ── create_rows ──
+    server.tool('create_rows', 'Create one or more rows in a table. Use column names (not UUIDs) as keys. For select/multiselect columns, values must match the column\'s defined options exactly — an unmatched value is rejected with the list of valid options (set add_missing_options: true to add it as a new option instead). Call get_table_schema first to know the column names.', {
+        table_id: z.string().uuid().describe('The table to add rows to'),
+        rows: z
+            .array(z.record(z.string(), z.unknown()))
+            .min(1)
+            .describe('Array of row objects. Keys are column names, values are cell data. ' +
+            'For select: use the option value string (e.g. "High"). ' +
+            'For date: use ISO 8601 (e.g. "2026-04-01"). ' +
+            'For boolean: use true/false. ' +
+            'For multiselect: use an array of strings.'),
+        add_missing_options: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('When true, any select/multiselect value that is not already a configured option is ' +
+            'added as a new option on that column (auto-assigned colour) before the rows are written. ' +
+            'When false (default), unmatched values are rejected with an error listing the valid options.'),
+    }, async ({ table_id, rows, add_missing_options }) => {
+        const colMap = await buildColumnMap(client, table_id);
+        // Validate select/multiselect values against configured options.
+        const violations = findOptionViolations(rows, colMap);
+        if (violations.length > 0) {
+            if (!add_missing_options)
+                return mcpError(formatOptionViolations(violations));
+            const addRes = await addMissingOptions(client, table_id, violations, colMap);
+            if (addRes.error)
+                return mcpError(addRes.error);
+        }
+        // Translate column names to UUIDs
+        const apiRows = rows.map((row) => ({
+            data: translateToIds(row, colMap),
+        }));
+        const res = await client.post(`/tables/${table_id}/rows`, { rows: apiRows });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({
+            message: `Created ${res.count || apiRows.length} row(s)`,
+            rows: res.data,
+        });
+    });
+    // ── update_rows ──
+    server.tool('update_rows', 'Update one or more existing rows. Specify row IDs and the columns to change. Only specified columns are updated; others remain unchanged. Use column names, not UUIDs. For select/multiselect columns, values must match the column\'s defined options exactly — an unmatched value is rejected (set add_missing_options: true to add it as a new option instead).', {
+        table_id: z.string().uuid().describe('The table containing the rows'),
+        updates: z
+            .array(z.object({
+            row_id: z.string().uuid().describe('The row ID to update'),
+            data: z
+                .record(z.string(), z.unknown())
+                .describe('Column name → new value pairs'),
+        }))
+            .min(1)
+            .max(500)
+            .describe('Array of row updates'),
+        add_missing_options: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('When true, any select/multiselect value that is not already a configured option is ' +
+            'added as a new option on that column (auto-assigned colour) before the rows are written. ' +
+            'When false (default), unmatched values are rejected with an error listing the valid options.'),
+    }, async ({ table_id, updates, add_missing_options }) => {
+        const colMap = await buildColumnMap(client, table_id);
+        // Validate select/multiselect values against configured options.
+        const violations = findOptionViolations(updates.map((u) => u.data), colMap);
+        if (violations.length > 0) {
+            if (!add_missing_options)
+                return mcpError(formatOptionViolations(violations));
+            const addRes = await addMissingOptions(client, table_id, violations, colMap);
+            if (addRes.error)
+                return mcpError(addRes.error);
+        }
+        if (updates.length === 1) {
+            // Single row update
+            const update = updates[0];
+            const translatedData = translateToIds(update.data, colMap);
+            const res = await client.patch(`/tables/${table_id}/rows/${update.row_id}`, {
+                data: translatedData,
+            });
+            if (res.error)
+                return mcpError(res.error.message);
+            return mcpResult({ message: 'Row updated', row: res.data });
+        }
+        // Bulk update
+        const apiRows = updates.map((u) => ({
+            id: u.row_id,
+            data: translateToIds(u.data, colMap),
+        }));
+        const res = await client.post('/rows/bulk-update', {
+            table_id,
+            rows: apiRows,
+        });
+        if (res.error)
+            return mcpError(res.error.message);
+        // Surface per-row failures — the API returns { data, updated_count, errors },
+        // and a total failure (e.g. an unsupported table kind) must not look like an
+        // empty-array success.
+        const bulk = res;
+        const updatedRows = Array.isArray(bulk.data) ? bulk.data : [];
+        const bulkErrors = bulk.errors ?? [];
+        const updatedCount = bulk.updated_count ?? updatedRows.length;
+        if (updatedCount === 0) {
+            const detail = bulkErrors.length
+                ? ' ' + bulkErrors.map((e) => `${e.id}: ${e.error}`).join('; ')
+                : '';
+            return mcpError(`No rows were updated (${bulkErrors.length} error(s)).${detail}`);
+        }
+        return mcpResult({
+            message: `Updated ${updatedCount} row(s)` +
+                (bulkErrors.length ? `, ${bulkErrors.length} failed` : ''),
+            rows: updatedRows,
+            updated_count: updatedCount,
+            ...(bulkErrors.length ? { errors: bulkErrors } : {}),
+        });
+    });
+    // ── delete_rows ──
+    server.tool('delete_rows', 'Delete one or more rows from a table. This action cannot be undone.', {
+        table_id: z.string().uuid().describe('The table containing the rows'),
+        row_ids: z
+            .array(z.string().uuid())
+            .min(1)
+            .describe('Array of row IDs to delete'),
+    }, async ({ table_id, row_ids }) => {
+        if (row_ids.length === 1) {
+            const res = await client.delete(`/tables/${table_id}/rows/${row_ids[0]}`);
+            if (res.error)
+                return mcpError(res.error.message);
+            return mcpResult({ message: 'Row deleted' });
+        }
+        const res = await client.post('/rows/bulk-delete', {
+            table_id,
+            row_ids,
+        });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+}
+//# sourceMappingURL=rows.js.map

package/dist/tools/rows.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AiTablesClient } from '../api-client.js';
+export declare function registerSearchTools(server: McpServer, client: AiTablesClient): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAWvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,QAgG5E"}

package/dist/tools/search.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { mcpError, mcpResult } from '../helpers/errors.js';
+// Column types that contain searchable text
+const TEXT_COLUMN_TYPES = new Set([
+    'text', 'richtext', 'email', 'url', 'phone',
+    'select', 'multiselect', 'tags', 'label',
+    'country', 'location',
+]);
+export function registerSearchTools(server, client) {
+    // ── search_rows ──
+    server.tool('search_rows', 'Search for rows containing specific text across all text-based columns. Useful for finding rows without knowing which column contains the data.', {
+        table_id: z.string().uuid().describe('The table to search in'),
+        query: z.string().min(1).describe('The text to search for (case-insensitive)'),
+        max_results: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(20)
+            .optional()
+            .describe('Maximum results to return (default 20)'),
+    }, async ({ table_id, query, max_results }) => {
+        // Fetch columns to know which are text-searchable
+        const colRes = await client.get(`/tables/${table_id}/columns`);
+        if (colRes.error)
+            return mcpError(colRes.error.message);
+        const columns = colRes.data || [];
+        const textColumnIds = columns
+            .filter((c) => TEXT_COLUMN_TYPES.has(c.column_type))
+            .map((c) => c.id);
+        const idToName = new Map(columns.map((c) => [c.id, c.name]));
+        if (textColumnIds.length === 0) {
+            return mcpResult({ message: 'No text-searchable columns in this table', rows: [] });
+        }
+        // Fetch rows (up to 1000 for search)
+        const rowRes = await client.get(`/tables/${table_id}/rows`, {
+            page_size: '1000',
+            page: '1',
+        });
+        if (rowRes.error)
+            return mcpError(rowRes.error.message);
+        const rows = rowRes.data || [];
+        // Client-side text search across text columns
+        const lowerQuery = query.toLowerCase();
+        const limit = max_results ?? 20;
+        const matches = [];
+        for (const row of rows) {
+            if (matches.length >= limit)
+                break;
+            const data = row.data || {};
+            let found = false;
+            for (const colId of textColumnIds) {
+                const value = data[colId];
+                if (value == null)
+                    continue;
+                const str = Array.isArray(value) ? value.join(' ') : String(value);
+                if (str.toLowerCase().includes(lowerQuery)) {
+                    found = true;
+                    break;
+                }
+            }
+            if (found) {
+                // Map column IDs to names in the result
+                const mappedData = {};
+                for (const [key, value] of Object.entries(data)) {
+                    mappedData[idToName.get(key) || key] = value;
+                }
+                matches.push({ id: row.id, data: mappedData });
+            }
+        }
+        return mcpResult({
+            query,
+            matches: matches.length,
+            rows: matches,
+        });
+    });
+    // ── export_table ──
+    server.tool('export_table', 'Export all data from a table including column definitions and all rows. Returns human-readable column names.', {
+        table_id: z.string().uuid().describe('The table to export'),
+    }, async ({ table_id }) => {
+        const res = await client.get(`/tables/${table_id}/export`, {
+            mapped_columns: 'true',
+        });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/structure.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AiTablesClient } from '../api-client.js';
+export declare function registerStructureTools(server: McpServer, client: AiTablesClient): void;
+//# sourceMappingURL=structure.d.ts.map

package/dist/tools/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../src/tools/structure.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA6BvD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,QA0L/E"}

package/dist/tools/structure.js

@@ -0,0 +1,172 @@
+import { z } from 'zod';
+import { mcpError, mcpResult } from '../helpers/errors.js';
+import { buildColumnPayload, mergeSelectOptions } from '../helpers/column-settings.js';
+const columnSchema = z.object({
+    name: z.string().describe('Column name'),
+    type: z
+        .string()
+        .describe('Column type. Common types: text, number, boolean, date, select, multiselect, ' +
+        'tags, label, rating, progress, email, url, phone, richtext, people, ' +
+        'duration, timeline, checklist, country, autonumber'),
+    options: z
+        .array(z.string())
+        .optional()
+        .describe("For select/multiselect/tags: list of option values. Colors are auto-assigned. Example: ['Todo', 'In Progress', 'Done']"),
+    required: z.boolean().optional().default(false),
+    settings: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe('Advanced column settings override. Usually not needed — the server applies smart defaults.'),
+});
+export function registerStructureTools(server, client) {
+    // ── create_table ──
+    server.tool('create_table', 'Create a new table in a database with columns. The server automatically configures column settings (adds colors to select options, applies smart defaults). If you omit columns, defaults are: Name (text), Notes (richtext), Status (select).', {
+        database_id: z.string().uuid().describe('The database to create the table in'),
+        name: z.string().min(1).describe('Table name'),
+        description: z.string().optional().describe('Table description'),
+        columns: z
+            .array(columnSchema)
+            .optional()
+            .describe('Column definitions. Omit for default columns (Name, Notes, Status).'),
+    }, async ({ database_id, name, description, columns }) => {
+        // Build enriched column payloads
+        let apiColumns;
+        if (columns && columns.length > 0) {
+            apiColumns = columns.map((col) => buildColumnPayload(col));
+        }
+        const body = {
+            database_id,
+            name,
+        };
+        if (description)
+            body.description = description;
+        if (apiColumns)
+            body.columns = apiColumns;
+        const res = await client.post('/tables', body);
+        if (res.error)
+            return mcpError(res.error.message);
+        // Fetch the created table with columns to show the full result
+        const table = res.data;
+        const tableId = table?.id;
+        if (tableId) {
+            const full = await client.get(`/tables/${tableId}`);
+            if (full.data)
+                return mcpResult(full.data);
+        }
+        return mcpResult(table);
+    });
+    // ── update_table ──
+    server.tool('update_table', 'Update a table\'s name, description, or icon. Only the fields you pass are changed. To change columns use add_columns / update_column.', {
+        table_id: z.string().uuid().describe('The table to update'),
+        name: z.string().min(1).optional().describe('New table name'),
+        description: z.string().optional().describe('New table description'),
+        icon: z.string().optional().describe('New icon name'),
+    }, async ({ table_id, name, description, icon }) => {
+        const body = {};
+        if (name !== undefined)
+            body.name = name;
+        if (description !== undefined)
+            body.description = description;
+        if (icon !== undefined)
+            body.icon = icon;
+        if (Object.keys(body).length === 0) {
+            return mcpError('Nothing to update — provide name, description, or icon');
+        }
+        const res = await client.patch(`/tables/${table_id}`, body);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: 'Table updated', table: res.data });
+    });
+    // ── delete_table ──
+    server.tool('delete_table', 'Permanently delete a table and ALL of its columns and rows. This cannot be undone — confirm with the user before calling.', {
+        table_id: z.string().uuid().describe('The table to delete'),
+    }, async ({ table_id }) => {
+        const res = await client.delete(`/tables/${table_id}`);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: 'Table deleted' });
+    });
+    // ── add_columns ──
+    server.tool('add_columns', 'Add one or more columns to an existing table. For select/multiselect, provide option values and colors will be auto-assigned.', {
+        table_id: z.string().uuid().describe('The table to add columns to'),
+        columns: z
+            .array(columnSchema)
+            .min(1)
+            .describe('Column definitions to add'),
+    }, async ({ table_id, columns }) => {
+        const created = [];
+        for (const col of columns) {
+            const payload = buildColumnPayload(col);
+            const res = await client.post(`/tables/${table_id}/columns`, payload);
+            if (res.error) {
+                return mcpError(`Failed to create column "${col.name}": ${res.error.message}`);
+            }
+            created.push(res.data);
+        }
+        return mcpResult({
+            message: `Added ${created.length} column(s)`,
+            columns: created,
+        });
+    });
+    // ── update_column ──
+    server.tool('update_column', 'Update a column\'s name, settings, or options. For select/multiselect: include ALL options (existing + new) — the full list replaces the current one. Get column_id from get_table_schema.', {
+        table_id: z.string().uuid().describe('The table containing the column'),
+        column_id: z
+            .string()
+            .uuid()
+            .describe('The column ID to update (get this from get_table_schema)'),
+        name: z.string().optional().describe('New column name'),
+        options: z
+            .array(z.string())
+            .optional()
+            .describe('For select/multiselect: the complete list of options. ' +
+            'Existing options keep their colors; new options get auto-assigned colors.'),
+        settings: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Column settings to update (replaces entire settings object)'),
+    }, async ({ table_id, column_id, name, options, settings }) => {
+        const body = {};
+        if (name)
+            body.name = name;
+        if (options) {
+            // Fetch existing column to preserve colors
+            const tableRes = await client.get(`/tables/${table_id}`);
+            const table = tableRes.data;
+            const columns = (table?.columns || []);
+            const existing = columns.find((c) => c.id === column_id);
+            if (existing) {
+                const existingSettings = existing.column_settings || {};
+                const existingOptions = (existingSettings.options || []);
+                const merged = mergeSelectOptions(existingOptions, options);
+                body.column_settings = { ...existingSettings, ...settings, options: merged };
+            }
+            else {
+                // Column not found in table response, just assign fresh colors
+                const { assignColors } = await import('../helpers/column-settings.js');
+                body.column_settings = { ...settings, options: assignColors(options) };
+            }
+        }
+        else if (settings) {
+            body.column_settings = settings;
+        }
+        if (Object.keys(body).length === 0) {
+            return mcpError('Nothing to update — provide name, options, or settings');
+        }
+        const res = await client.patch(`/tables/${table_id}/columns/${column_id}`, body);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: 'Column updated', column: res.data });
+    });
+    // ── delete_column ──
+    server.tool('delete_column', 'Permanently delete a column from a table, including its data in every row. This cannot be undone — confirm with the user before calling. Get column_id from get_table_schema.', {
+        table_id: z.string().uuid().describe('The table containing the column'),
+        column_id: z.string().uuid().describe('The column to delete (from get_table_schema)'),
+    }, async ({ table_id, column_id }) => {
+        const res = await client.delete(`/tables/${table_id}/columns/${column_id}`);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: 'Column deleted' });
+    });
+}
+//# sourceMappingURL=structure.js.map

package/dist/tools/structure.js.map

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

package/dist/tools/views.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AiTablesClient } from '../api-client.js';
+export declare function registerViewTools(server: McpServer, client: AiTablesClient): void;
+//# sourceMappingURL=views.d.ts.map

package/dist/tools/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../src/tools/views.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAoBvD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,QAuL1E"}