@enfyra/mcp-server 0.1.69 → 0.1.71

package/dist/lib/schema-verification.js

@@ -0,0 +1,105 @@
+import { fetchTableWithDetails, normalizeTablesFromMetadata, } from './schema-mutation-coordinator.js';
+import { getId, normalizeColumnForTablePatch, normalizeColumnOptionsValue, normalizeColumnTypeForLiveMetadata, parseColumnTypeOptions, sanitizeExistingRelationForTablePatch, } from './schema-relation-contracts.js';
+function findMetadataTable(metadata, tableName) {
+    return normalizeTablesFromMetadata(metadata).find((table) => table?.name === tableName) || null;
+}
+export function metadataColumnNames(metadata, tableName) {
+    return (findMetadataTable(metadata, tableName)?.columns || [])
+        .map((column) => column?.name)
+        .filter(Boolean);
+}
+export function metadataColumnOptions(metadata, tableName, columnName) {
+    const column = (findMetadataTable(metadata, tableName)?.columns || [])
+        .find((item) => item?.name === columnName);
+    return parseColumnTypeOptions(column?.options);
+}
+export function summarizeCreatedTableSchema(table, fallbackName) {
+    if (!table)
+        return null;
+    const columns = (table.columns || [])
+        .map((column) => column?.name)
+        .filter(Boolean);
+    const relations = (table.relations || [])
+        .map((relation) => relation?.propertyName)
+        .filter(Boolean);
+    return {
+        tableName: table.name || fallbackName,
+        primaryKey: (table.columns || []).find((column) => column?.isPrimary)?.name || null,
+        fields: [...columns, ...relations].sort(),
+        columns,
+        relations,
+    };
+}
+export function getPatchableColumns(columns = []) {
+    return (columns || [])
+        .filter((column) => getId(column) !== null)
+        .map(normalizeColumnForTablePatch);
+}
+function getMissingIds(beforeIds, afterIds, excludedIds = []) {
+    const afterSet = new Set(afterIds.map(String));
+    const excludedSet = new Set(excludedIds.map(String));
+    return beforeIds
+        .map(String)
+        .filter((id) => !excludedSet.has(id) && !afterSet.has(id));
+}
+export async function verifyColumnCascade(ENFYRA_API_URL, tableId, beforeIds, { action, columnId, columnName, }) {
+    const tableData = await fetchTableWithDetails(ENFYRA_API_URL, tableId);
+    const afterColumns = getPatchableColumns(tableData.columns);
+    const afterIds = afterColumns.map((column) => String(getId(column)));
+    const excludedIds = action === 'delete' ? [columnId] : [];
+    const missingIds = getMissingIds(beforeIds, afterIds, excludedIds);
+    if (missingIds.length > 0) {
+        throw new Error(`Schema cascade verification failed: unrelated column ids disappeared: ${missingIds.join(', ')}`);
+    }
+    if (action === 'create' && !afterColumns.some((column) => column.name === columnName)) {
+        throw new Error(`Schema cascade verification failed: column "${columnName}" was not found after create.`);
+    }
+    if (action === 'delete' && afterIds.includes(String(columnId))) {
+        throw new Error(`Schema cascade verification failed: column ${columnId} still exists after delete.`);
+    }
+    if (action === 'update' && !afterIds.includes(String(columnId))) {
+        throw new Error(`Schema cascade verification failed: column ${columnId} was not found after update.`);
+    }
+    return afterColumns;
+}
+export async function verifyRelationCascade(ENFYRA_API_URL, tableId, beforeIds, { action, relationId, propertyName, }) {
+    const tableData = await fetchTableWithDetails(ENFYRA_API_URL, tableId);
+    const afterRelations = (tableData.relations || []).map(sanitizeExistingRelationForTablePatch);
+    const afterIds = afterRelations.map((relation) => String(getId(relation))).filter((id) => id !== 'null');
+    const excludedIds = action === 'delete' ? [relationId] : [];
+    const missingIds = getMissingIds(beforeIds, afterIds, excludedIds);
+    if (missingIds.length > 0) {
+        throw new Error(`Schema cascade verification failed: unrelated relation ids disappeared: ${missingIds.join(', ')}`);
+    }
+    if (action === 'create' && !afterRelations.some((relation) => relation.propertyName === propertyName)) {
+        throw new Error(`Schema cascade verification failed: relation "${propertyName}" was not found after create.`);
+    }
+    if (action === 'delete' && afterIds.includes(String(relationId))) {
+        throw new Error(`Schema cascade verification failed: relation ${relationId} still exists after delete.`);
+    }
+    return afterRelations;
+}
+export function buildColumnDefinition({ name, type, supportedTypes, isNullable, isUnique, isPublished, isUpdatable, isEncrypted, isPrimary, isGenerated, isSystem, defaultValue, description, options, }) {
+    const normalizedType = normalizeColumnTypeForLiveMetadata(type, supportedTypes).type;
+    const column = {
+        name,
+        type: normalizedType,
+        isNullable: isNullable ?? true,
+        isPrimary: isPrimary ?? false,
+        isGenerated: isGenerated ?? false,
+        isSystem: isSystem ?? false,
+        isPublished: isPublished ?? true,
+        isUpdatable: isUpdatable ?? true,
+        isEncrypted: isEncrypted ?? false,
+    };
+    if (isUnique !== undefined)
+        column.isUnique = isUnique;
+    if (defaultValue !== undefined)
+        column.defaultValue = defaultValue;
+    if (description !== undefined)
+        column.description = description;
+    if (options !== undefined)
+        column.options = normalizeColumnOptionsValue(options);
+    return column;
+}
+//# sourceMappingURL=schema-verification.js.map

package/dist/lib/schema-verification.js.map

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

package/dist/lib/script-tools.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Enfyra MCP — stdio server (loaded by index.ts / dist/index.js).
+ */
+export declare function registerScriptTools(server: any, ENFYRA_API_URL: any): void;

package/dist/lib/script-tools.js

@@ -0,0 +1,127 @@
+/**
+ * Enfyra MCP — stdio server (loaded by index.ts / dist/index.js).
+ */
+import { z } from 'zod';
+import { fetchAPI, validateTableName } from './fetch.js';
+import { assertDynamicCodeKnowledgeAck, assertGlobalRulesAck, dynamicCodeKnowledgeAckParam, globalRulesAckParam, } from './required-knowledge.js';
+import { writeSourceArtifact } from './source-artifacts.js';
+import { SCRIPT_BACKED_TABLES, fetchScriptRecord, prepareGenericMutation, replaceOccurrence, scriptRecordLabel, sha256, sourcePreview, summarizeMutationResult, } from './enfyra-tool-logic.js';
+export function registerScriptTools(server, ENFYRA_API_URL) {
+    server.tool('get_script_source', [
+        'Fetch the full editable source for one script-backed metadata record without preview truncation.',
+        'Use search_runtime_zone first and pass the returned nextInspect.input to inspect the concrete record. The inspection already returns exact source artifacts.',
+        'Call get_script_source only when a fresh artifact is needed for that located record. Never guess or probe record ids.',
+    ].join(' '), {
+        tableName: z.enum(SCRIPT_BACKED_TABLES).describe('Script-backed table to read'),
+        id: z.string().describe('Concrete record id returned by search_runtime_zone, inspect output, or a successful create/update operation. Never guess an id.'),
+    }, async ({ tableName, id }) => {
+        const { primaryKey, record, sourceField, sourceCode } = await fetchScriptRecord(tableName, id);
+        const sourceArtifact = writeSourceArtifact({ tableName, id, fieldName: sourceField, source: sourceCode });
+        return { content: [{ type: 'text', text: JSON.stringify({
+                        tableName,
+                        id,
+                        primaryKey,
+                        sourceField,
+                        sourceFile: sourceArtifact.tmpFile,
+                        sourcePreview: sourceArtifact.preview,
+                        sourceLength: sourceCode.length,
+                        sourceSha256: sha256(sourceCode),
+                        scriptLanguage: record.scriptLanguage || record.language || null,
+                        record: scriptRecordLabel(tableName, record),
+                    }, null, 2) }] };
+    });
+    server.tool('patch_script_source', [
+        'Patch sourceCode on a script-backed record using exact search/replace with optional hash checking.',
+        'By default this returns a preview only. Set apply=true to validate through /admin/script/validate and save.',
+        'Use get_script_source first for long scripts, then patch only the exact block you intend to change.',
+    ].join(' '), {
+        tableName: z.enum(SCRIPT_BACKED_TABLES).describe('Script-backed table to patch'),
+        id: z.string().describe('Record ID to patch'),
+        oldText: z.string().describe('Exact text to replace'),
+        newText: z.string().describe('Replacement text'),
+        occurrence: z.enum(['first', 'all']).optional().default('all').describe('Replace first occurrence or all occurrences.'),
+        expectedSourceSha256: z.string().optional().describe('Optional SHA-256 from get_script_source; fails if source changed.'),
+        scriptLanguage: z.string().optional().describe('Script language to save. Defaults to existing scriptLanguage or javascript.'),
+        apply: z.boolean().optional().default(false).describe('false returns preview only; true validates and saves.'),
+        globalRulesAckKey: globalRulesAckParam(z).optional().describe('Required when apply=true. Use globalRulesAckKey from get_enfyra_required_knowledge.'),
+        knowledgeAckKey: dynamicCodeKnowledgeAckParam(z).optional().describe('Required when apply=true. Use dynamicCodeAckKey from get_enfyra_required_knowledge.'),
+    }, async ({ tableName, id, oldText, newText, occurrence, expectedSourceSha256, scriptLanguage, apply, globalRulesAckKey, knowledgeAckKey }) => {
+        const { record, sourceField, sourceCode } = await fetchScriptRecord(tableName, id);
+        if (sourceField !== 'sourceCode') {
+            throw new Error(`patch_script_source only saves sourceCode records. Record uses "${sourceField}"; use update_records intentionally for this legacy field.`);
+        }
+        const beforeHash = sha256(sourceCode);
+        if (expectedSourceSha256 && expectedSourceSha256 !== beforeHash) {
+            throw new Error(`Source hash mismatch. Current sha256 is ${beforeHash}; re-read with get_script_source before patching.`);
+        }
+        const { occurrences, patched, replaced } = replaceOccurrence(sourceCode, oldText, newText, occurrence || 'all');
+        const afterHash = sha256(patched);
+        const payload = {
+            action: apply ? 'patch_script_source_applied' : 'patch_script_source_preview',
+            tableName,
+            id,
+            sourceField,
+            sourceLengthBefore: sourceCode.length,
+            sourceLengthAfter: patched.length,
+            sourceSha256Before: beforeHash,
+            sourceSha256After: afterHash,
+            occurrences,
+            replaced,
+            preview: {
+                before: sourcePreview(sourceCode, oldText),
+                after: sourcePreview(patched, newText),
+            },
+            next: apply ? undefined : 'Call patch_script_source again with apply=true and expectedSourceSha256 set to sourceSha256Before to validate and save.',
+        };
+        if (!apply) {
+            return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+        }
+        assertGlobalRulesAck(globalRulesAckKey);
+        assertDynamicCodeKnowledgeAck(knowledgeAckKey);
+        const language = scriptLanguage || record.scriptLanguage || 'javascript';
+        const prepared = await prepareGenericMutation(tableName, JSON.stringify({ sourceCode: patched, scriptLanguage: language }));
+        const result = await fetchAPI(ENFYRA_API_URL, `/${tableName}/${encodeURIComponent(String(id))}`, { method: 'PATCH', body: JSON.stringify(prepared.payload) });
+        return { content: [{ type: 'text', text: JSON.stringify({
+                        ...payload,
+                        ...summarizeMutationResult(result, 'patch_script_source_applied', tableName),
+                        id,
+                        scriptLanguage: language,
+                        scriptValidation: prepared.scriptValidation,
+                    }, null, 2) }] };
+    });
+    server.tool('update_script_source', [
+        'Update sourceCode on a script-backed record without forcing the caller to JSON-escape long code.',
+        'Use this for enfyra_flow_step, enfyra_route_handler, enfyra_pre_hook, enfyra_post_hook, enfyra_websocket_event, enfyra_websocket, enfyra_oauth_config, and enfyra_bootstrap_script.',
+        'The tool validates sourceCode through /admin/script/validate before saving and never accepts compiledCode.',
+    ].join(' '), {
+        tableName: z.enum([
+            'enfyra_route_handler',
+            'enfyra_pre_hook',
+            'enfyra_post_hook',
+            'enfyra_flow_step',
+            'enfyra_websocket_event',
+            'enfyra_websocket',
+            'enfyra_oauth_config',
+            'enfyra_bootstrap_script',
+        ]).describe('Script-backed table to update'),
+        id: z.string().describe('Record ID to update'),
+        sourceCode: z.string().describe('Editable script sourceCode. Pass the raw code string; do not JSON-escape it yourself.'),
+        scriptLanguage: z.string().optional().default('javascript').describe('Script language, usually javascript or typescript'),
+        globalRulesAckKey: globalRulesAckParam(z),
+        knowledgeAckKey: dynamicCodeKnowledgeAckParam(z),
+    }, async ({ tableName, id, sourceCode, scriptLanguage, globalRulesAckKey, knowledgeAckKey }) => {
+        assertGlobalRulesAck(globalRulesAckKey);
+        assertDynamicCodeKnowledgeAck(knowledgeAckKey);
+        validateTableName(tableName);
+        const prepared = await prepareGenericMutation(tableName, JSON.stringify({ sourceCode, scriptLanguage }));
+        const result = await fetchAPI(ENFYRA_API_URL, `/${tableName}/${encodeURIComponent(String(id))}`, { method: 'PATCH', body: JSON.stringify(prepared.payload) });
+        return { content: [{ type: 'text', text: JSON.stringify({
+                        ...summarizeMutationResult(result, 'updated_script_source', tableName),
+                        id,
+                        sourceLength: sourceCode.length,
+                        scriptLanguage,
+                        scriptValidation: prepared.scriptValidation,
+                    }, null, 2) }] };
+    });
+}
+//# sourceMappingURL=script-tools.js.map

package/dist/lib/script-tools.js.map

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

package/dist/lib/system-tools.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Enfyra MCP — stdio server (loaded by index.ts / dist/index.js).
+ */
+export declare function registerSystemTools(server: any, ENFYRA_API_URL: any): void;

package/dist/lib/system-tools.js

@@ -0,0 +1,41 @@
+/**
+ * Enfyra MCP — stdio server (loaded by index.ts / dist/index.js).
+ */
+import { z } from 'zod';
+import { fetchAPI } from './fetch.js';
+import { assertGlobalRulesAck, globalRulesAckParam, } from './required-knowledge.js';
+import { jsonContent } from './response-format.js';
+export function registerSystemTools(server, ENFYRA_API_URL) {
+    // ============================================================================
+    // CACHE & SYSTEM TOOLS
+    // ============================================================================
+    server.tool('reload_all', 'Reload all caches (metadata, routes, GraphQL)', {
+        globalRulesAckKey: globalRulesAckParam(z),
+    }, async ({ globalRulesAckKey }) => {
+        assertGlobalRulesAck(globalRulesAckKey);
+        const result = await fetchAPI(ENFYRA_API_URL, '/admin/reload', { method: 'POST' });
+        return jsonContent({ action: 'reloaded_all', result });
+    });
+    server.tool('reload_metadata', 'Reload metadata cache only', {
+        globalRulesAckKey: globalRulesAckParam(z),
+    }, async ({ globalRulesAckKey }) => {
+        assertGlobalRulesAck(globalRulesAckKey);
+        const result = await fetchAPI(ENFYRA_API_URL, '/admin/reload/metadata', { method: 'POST' });
+        return jsonContent({ action: 'reloaded_metadata', result });
+    });
+    server.tool('reload_routes', 'Reload routes cache only', {
+        globalRulesAckKey: globalRulesAckParam(z),
+    }, async ({ globalRulesAckKey }) => {
+        assertGlobalRulesAck(globalRulesAckKey);
+        const result = await fetchAPI(ENFYRA_API_URL, '/admin/reload/routes', { method: 'POST' });
+        return jsonContent({ action: 'reloaded_routes', result });
+    });
+    server.tool('reload_graphql', 'Reload GraphQL schema', {
+        globalRulesAckKey: globalRulesAckParam(z),
+    }, async ({ globalRulesAckKey }) => {
+        assertGlobalRulesAck(globalRulesAckKey);
+        const result = await fetchAPI(ENFYRA_API_URL, '/admin/reload/graphql', { method: 'POST' });
+        return jsonContent({ action: 'reloaded_graphql', result });
+    });
+}
+//# sourceMappingURL=system-tools.js.map

package/dist/lib/system-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-tools.js","sourceRoot":"","sources":["../../src/lib/system-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAqC,MAAM,YAAY,CAAC;AAmBzE,OAAO,EAIL,oBAAoB,EAKpB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAgC,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAsBjF,MAAM,UAAU,mBAAmB,CAAC,MAAM,EAAE,cAAc;IACxD,+EAA+E;IAC/E,uBAAuB;IACvB,+EAA+E;IAE/E,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,+CAA+C,EAAE;QACzE,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC;KAC1C,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE;QACjC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACnF,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,4BAA4B,EAAE;QAC3D,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC;KAC1C,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE;QACjC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,wBAAwB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5F,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,0BAA0B,EAAE;QACvD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC;KAC1C,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE;QACjC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,sBAAsB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1F,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,uBAAuB,EAAE;QACrD,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC;KAC1C,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE;QACjC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,uBAAuB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3F,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/table-tool-logic.d.ts

@@ -0,0 +1,5 @@
+export * from './schema-mutation-coordinator.js';
+export * from './schema-table-contracts.js';
+export * from './schema-relation-contracts.js';
+export * from './schema-verification.js';
+export * from './schema-tool-types.js';

package/dist/lib/table-tool-logic.js

@@ -0,0 +1,6 @@
+export * from './schema-mutation-coordinator.js';
+export * from './schema-table-contracts.js';
+export * from './schema-relation-contracts.js';
+export * from './schema-verification.js';
+export * from './schema-tool-types.js';
+//# sourceMappingURL=table-tool-logic.js.map

package/dist/lib/table-tool-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-tool-logic.js","sourceRoot":"","sources":["../../src/lib/table-tool-logic.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC"}

package/dist/lib/table-tools.d.ts

@@ -1,87 +1,4 @@
-type AnyRecord = Record<string, any>;
-type ConstraintGroup = string[];
-type ColumnPatch = AnyRecord & {
-    id?: unknown;
-    _id?: unknown;
-    name?: string;
-    type?: string;
-    isNullable?: boolean;
-    isPrimary?: boolean;
-    isGenerated?: boolean;
-    isSystem?: boolean;
-    isPublished?: boolean;
-    isUpdatable?: boolean;
-    isEncrypted?: boolean;
-    isUnique?: boolean;
-    defaultValue?: unknown;
-    description?: string;
-    options?: unknown;
-};
-type RelationPatch = AnyRecord & {
-    id?: unknown;
-    _id?: unknown;
-    targetTable?: unknown;
-    type?: string;
-    propertyName?: string;
-    inversePropertyName?: string | null;
-    mappedBy?: unknown;
-    isNullable?: boolean;
-    onDelete?: string;
-    description?: string;
-};
-export declare function assertColumnContractBroadening(existingColumn: AnyRecord, requested: AnyRecord, toolset?: string): string[];
-export declare function buildPrimaryColumnForDbType(dbType: string | null | undefined): ColumnPatch;
-export declare function normalizeTablesFromMetadata(metadata: any): any[];
-export declare function resolveTableFromMetadata(metadata: any, tableId: any): any;
-export declare function resolveTableFromMetadataByName(metadata: any, tableName: any): any;
-export declare function resolveTableIdentifierFromMetadata(metadata: any, tableRef: any, label?: string): any;
-/**
- * Helper: fetch table with full columns and relations.
- * Schema cascade tools resolve the table catalog entry first, then request the
- * complete permission-projected schema from /metadata/:name.
- */
-export declare function fetchTableWithDetails(ENFYRA_API_URL: any, tableId: any): Promise<AnyRecord>;
-export declare function normalizeCreateTableDefinitions(items: AnyRecord[]): {
-    _requestedTableName?: string;
-    relations?: any;
-    name: string;
-}[];
-export declare function computeBatchCleanupOrder(items: AnyRecord[]): string[];
-export declare function assertIndexesDoNotReferenceUniqueFields(indexes: ConstraintGroup[], uniques: ConstraintGroup[]): void;
-export declare function normalizeRelationForTablePatch(relation: AnyRecord): RelationPatch;
-export declare function normalizeRelationType(type: unknown): string;
-export declare function sanitizeExistingRelationForTablePatch(relation: AnyRecord): RelationPatch;
-export declare function resolveRelationTargetsFromMetadata(metadata: any, relations: RelationPatch[]): (RelationPatch | {
-    targetTable: any;
-    id?: unknown;
-    _id?: unknown;
-    type?: string;
-    propertyName?: string;
-    inversePropertyName?: string | null;
-    mappedBy?: unknown;
-    isNullable?: boolean;
-    onDelete?: string;
-    description?: string;
-})[];
-export declare function getSupportedColumnTypesFromMetadata(metadata: AnyRecord): string[];
-export declare function normalizeColumnTypeForLiveMetadata(type: unknown, supportedTypes?: string[]): {
-    type: string;
-    changed: boolean;
-    originalType: string;
-};
-export declare function normalizeColumnsForLiveMetadata(columns: AnyRecord[], supportedTypes: string[]): {
-    columns: AnyRecord[];
-    normalizations: {
-        column: string;
-        from: string;
-        to: string;
-    }[];
-};
-export declare function buildColumnDefinition({ name, type, supportedTypes, isNullable, isUnique, isPublished, isUpdatable, isEncrypted, isPrimary, isGenerated, isSystem, defaultValue, description, options, }: AnyRecord): ColumnPatch;
-/**
- * Register table tools with MCP server
- */
+export * from './table-tool-logic.js';
 export declare function registerTableTools(server: any, ENFYRA_API_URL: any, options?: {
     toolset?: string;
 }): void;
-export {};