@enfyra/mcp-server 0.1.69 → 0.1.71

package/dist/lib/dynamic-script-context-contract.d.ts

@@ -0,0 +1,100 @@
+export declare function buildDynamicScriptContextTypeContract(): {
+    authority: string;
+    aliases: string[];
+    values: {
+        '@BODY': {
+            type: string;
+            guarantee: string;
+        };
+        '@QUERY': {
+            type: string;
+            declaration: string;
+            guarantee: string;
+        };
+        '@PARAMS': {
+            type: string;
+            guarantee: string;
+        };
+        '@USER': {
+            type: string;
+            guarantee: string;
+        };
+        '@DATA': {
+            type: string;
+            guarantee: string;
+        };
+        '@STATUS': {
+            type: string;
+            guarantee: string;
+        };
+        '@ERROR': {
+            type: string;
+            declaration: string;
+            guarantee: string;
+        };
+        '@ENV': {
+            type: string;
+            guarantee: string;
+        };
+        '@SHARE': {
+            type: string;
+            guarantee: string;
+        };
+        '@REQ': {
+            type: string;
+            declaration: string[];
+            guarantee: string;
+        };
+        '@API': {
+            type: string;
+            declaration: string;
+            guarantee: string;
+        };
+        '@UPLOADED_FILE': {
+            type: string;
+            declaration: string;
+            guarantee: string;
+        };
+        '@FLOW': {
+            type: string;
+            declaration: string;
+            guarantee: string;
+        };
+        '@FLOW_PAYLOAD': {
+            type: string;
+            guarantee: string;
+        };
+        '@FLOW_LAST': {
+            type: string;
+            guarantee: string;
+        };
+        '@FLOW_META': {
+            type: string;
+            guarantee: string;
+        };
+    };
+    repositories: {
+        declaration: string;
+        guarantee: string;
+        access: string;
+    };
+    services: {
+        '@HELPERS': string[];
+        '@CACHE': string[];
+        '@STORAGE': string[];
+        '@SOCKET': {
+            global: string;
+            bound: string;
+        };
+        '@RES': string;
+        '@TRIGGER': string;
+        '$ctx.$transaction': string;
+        '@LOGS': string;
+        '@THROW': string[];
+        '@PKGS': string;
+    };
+    bridge: {
+        async: string;
+        sync: string;
+    };
+};

package/dist/lib/dynamic-script-context-contract.js

@@ -0,0 +1,163 @@
+export function buildDynamicScriptContextTypeContract() {
+    return {
+        authority: [
+            'These are script-visible types that the ESV and isolated executor runtime guarantee for the listed surface.',
+            'Do not add typeof, Array.isArray, existence, or callable guards around a documented container, service, method, or result envelope.',
+            'Validate user-controlled field values inside @BODY, @QUERY, and @PARAMS when the business contract requires it. Check documented nullable values such as @USER and @UPLOADED_FILE when the selected route can omit them. @DATA remains unknown for a custom handler result.',
+        ].join(' '),
+        aliases: [
+            'type Id = string | number',
+            'type RuntimeRecord = Record<string, unknown>',
+            'type Filter = Record<string, unknown>',
+            'type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue }',
+        ],
+        values: {
+            '@BODY': {
+                type: 'JsonValue',
+                guarantee: 'The surface payload, defaulting to {} when absent. Use the route, flow, or websocket input contract to access known fields directly; validate only business-level field constraints.',
+            },
+            '@QUERY': {
+                type: 'QueryContext',
+                declaration: 'type QueryContext = { filter: Filter; _filter: Filter; deep?: RuntimeRecord; _deep?: RuntimeRecord; aggregate?: RuntimeRecord; fields?: string | string[]; sort?: string | string[]; page?: string | number; limit?: string | number; meta?: string | string[]; debugMode?: string | boolean; [key: string]: unknown }',
+                guarantee: 'Always an object. For a valid parsed request, filter and _filter are objects and deep/_deep/aggregate are parsed objects. Other REST query values normally arrive as strings. Do not guard the @QUERY container; reject malformed serialized query input instead of silently normalizing its framework shape.',
+            },
+            '@PARAMS': {
+                type: 'Record<string, string>',
+                guarantee: 'Always an object, defaulting to {}. Declared route parameters are strings.',
+            },
+            '@USER': {
+                type: 'RuntimeRecord | null',
+                guarantee: 'The authenticated Enfyra user record, otherwise null. It is non-null after an authenticated route or websocket boundary; public routes and anonymously triggered flows must handle null when identity is required.',
+            },
+            '@DATA': {
+                type: 'unknown',
+                guarantee: 'In a post-hook this is the handler result. Canonical CRUD results use CollectionResult; custom handlers may return any JSON-serializable value.',
+            },
+            '@STATUS': {
+                type: 'number',
+                guarantee: 'Available in post-hooks and set to the current HTTP status, including error status on the handler error path.',
+            },
+            '@ERROR': {
+                type: 'DynamicScriptError | undefined',
+                declaration: 'type DynamicScriptError = { message: string; name: string; stack: string; statusCode: number; details: unknown; timestamp: string }',
+                guarantee: 'Defined in post-hooks only when the handler path failed.',
+            },
+            '@ENV': {
+                type: 'Record<string, string | undefined>',
+                guarantee: 'Always an object. ESV removes DB_URI, DB_REPLICA_URIS, REDIS_URI, SECRET_KEY, and ADMIN_PASSWORD.',
+            },
+            '@SHARE': {
+                type: '{ $logs: unknown[] }',
+                guarantee: 'Always an object with a $logs array for the current execution batch.',
+            },
+            '@REQ': {
+                type: 'HttpRequestContext | WebsocketRequestContext',
+                declaration: [
+                    'type HttpRequestContext = { method: string; url: string; headers: Record<string, string | string[] | undefined>; query: QueryContext; params: Record<string, string>; ip: string | null; hostname: string; protocol: string; path: string; originalUrl: string; rawBody?: string }',
+                    "type WebsocketRequestContext = { method: 'WS_CONNECT' | 'WS_EVENT' | 'WS_CONNECT_TEST' | 'WS_EVENT_TEST'; url: string; headers: RuntimeRecord; ip: string | null; user: RuntimeRecord | null }",
+                ],
+                guarantee: 'Present in HTTP and websocket contexts; not part of the flow or OAuth provisioning surface.',
+            },
+            '@API': {
+                type: 'ApiExecutionContext',
+                declaration: 'type ApiExecutionContext = { request: { method: string; url: string; timestamp: string; correlationId?: string; userAgent?: string; ip?: string }; response?: { statusCode: number; responseTime: number; timestamp: string }; error?: DynamicScriptError }',
+                guarantee: 'Present in HTTP and websocket contexts. response/error are populated for post-hook completion and error handling.',
+            },
+            '@UPLOADED_FILE': {
+                type: 'UploadedFileInfo | undefined',
+                declaration: 'type UploadedFileInfo = { originalname: string; mimetype: string; encoding: string; path?: string; size: number; fieldname: string }',
+                guarantee: 'Defined only for a multipart request containing a file. It is disk-backed metadata; do not expect a buffer.',
+            },
+            '@FLOW': {
+                type: 'FlowContext',
+                declaration: 'type FlowContext = { $payload: JsonValue; $last: unknown; $meta: { flowId: Id; flowName: string; executionId: Id; depth: number; startedAt: string; currentStep?: string }; [stepKey: string]: unknown }',
+                guarantee: 'Present in flow steps. Each completed step key is assigned its result and $last is updated to that result.',
+            },
+            '@FLOW_PAYLOAD': {
+                type: 'JsonValue',
+                guarantee: 'Alias of @FLOW.$payload.',
+            },
+            '@FLOW_LAST': {
+                type: 'unknown',
+                guarantee: 'Alias of @FLOW.$last; null before the first completed step.',
+            },
+            '@FLOW_META': {
+                type: 'FlowContext["$meta"]',
+                guarantee: 'Alias of @FLOW.$meta.',
+            },
+        },
+        repositories: {
+            declaration: [
+                'type CollectionResult<T = RuntimeRecord> = { data: T[]; meta?: { totalCount?: number; filterCount?: number; aggregate?: unknown; [key: string]: unknown }; count?: number; [key: string]: unknown }',
+                'type RepositoryFindOptions = { filter?: Filter; fields?: string | string[]; limit?: number; sort?: string; meta?: string | string[]; aggregate?: RuntimeRecord; deep?: Record<string, RuntimeRecord> }',
+                'interface DynamicRepository { find(options?: RepositoryFindOptions): Promise<CollectionResult>; exists(filter?: Filter): Promise<boolean>; create(options: { data: RuntimeRecord | RuntimeRecord[]; fields?: string | string[]; batch?: boolean }): Promise<CollectionResult | { accepted: true; batch: true; count: number }>; update(options: { id: Id; data: RuntimeRecord; fields?: string | string[] }): Promise<CollectionResult>; delete(options: { id: Id }): Promise<{ message: string; statusCode: 200 }> }',
+            ].join('\n'),
+            guarantee: 'find/create/update return CollectionResult in normal non-batch use and data is always an array. Never guard result.data with Array.isArray. Use result.data[0] after a proven match, or result.data?.[0] ?? null when zero rows is valid.',
+            access: '@REPOS.main is the secure current-route repository. @REPOS.secure.<table> and #secure.<table> are secure explicit repositories. @REPOS.<table> and #<table> are trusted explicit repositories.',
+        },
+        services: {
+            '@HELPERS': [
+                '$jwt(payload: RuntimeRecord, expiresIn: string): Promise<string> — HTTP and GraphQL only',
+                '$bcrypt.hash(plain: string): Promise<string>',
+                '$bcrypt.compare(plain: string, hash: string): Promise<boolean>',
+                'autoSlug(text: string): Promise<string>',
+                '$fetch(url: string, options?): Promise<unknown | string | ArrayBuffer>',
+                '$sleep(ms: number): Promise<void>',
+                '$crypto.randomUUID(): Promise<string>',
+                "$crypto.randomBytes(size?: number, encoding?: 'hex' | 'base64' | 'base64url'): Promise<string>",
+                "$crypto.sha256(value: string, encoding?: 'hex' | 'base64' | 'base64url'): Promise<string>",
+                "$crypto.hmacSha256(value: string, secret: string, encoding?: 'hex' | 'base64' | 'base64url'): Promise<string>",
+                '$crypto.generateSshKeyPair(comment?: string): Promise<{ publicKey: string; privateKey: string }>',
+                '$rateLimit.check/byIp/byUser/byRoute/byIpGlobal/byUserGlobal/status(...): Promise<{ allowed: boolean; remaining: number; resetAt: number; retryAfter: number; limit: number; window: number }> — HTTP dynamic routes only',
+                '$rateLimit.reset(key: string): Promise<void> — HTTP dynamic routes only',
+            ],
+            '@CACHE': [
+                'acquire(key: string, value: unknown, ttlMs: number): Promise<boolean>',
+                'release(key: string, value: unknown): Promise<boolean>',
+                'get(key: string): Promise<unknown>',
+                'set(key: string, value: unknown, ttlMs: number): Promise<void>',
+                'exists(key: string, value: unknown): Promise<boolean>',
+                'deleteKey(key: string): Promise<void>',
+                'setNoExpire(key: string, value: unknown): Promise<void>',
+            ],
+            '@STORAGE': [
+                '$upload(options: { file?: UploadedFileInfo; originalname?: string; filename?: string; mimetype?: string; buffer?: ArrayBuffer; size?: number; encoding?: string; folder?: Id | { id: Id }; storageConfig?: Id; title?: string; description?: string }): Promise<RuntimeRecord>',
+                '$update(fileId: Id, options: RuntimeRecord): Promise<RuntimeRecord>',
+                '$delete(fileId: Id): Promise<RuntimeRecord>',
+                '$registerFile(options: RuntimeRecord & { mimetype: string; location: string; storageConfig: Id | { id: Id } }): Promise<RuntimeRecord>',
+            ],
+            '@SOCKET': {
+                global: 'HTTP/flow global socket: emitToUser(userId, event, data), emitToRoom(path, room, event, data), emitToGateway(path, event, data), broadcast(event, data) return Promise<void>; roomSize(room) returns Promise<number>.',
+                bound: 'The bound websocket socket also exposes reply(event, data), join(room), leave(room), emitToCurrentRoom(room, event, data), broadcastToRoom(room, event, data), and disconnect(), all returning Promise<void>.',
+            },
+            '@RES': 'HTTP handler only: stream(readable, options?): Promise<void>. The response stream starts asynchronously; return after awaiting it.',
+            '@TRIGGER': 'trigger(flowIdOrName: Id, payload?: JsonValue): Promise<{ jobId: string; flowId: Id } | { triggered: true; flowId: Id; flowName: string }>.',
+            '$ctx.$transaction': 'Raw-only $ctx.$transaction.run<T>(callback: () => Promise<T>): Promise<T>. Only repository operations participate in rollback.',
+            '@LOGS': 'Synchronous callable: (...values: unknown[]) => void. Prefer @LOGS(message, details?).',
+            '@THROW': [
+                'Every method returns never synchronously; do not await throw helpers.',
+                'http(statusCode: number, message: string, details?: unknown): never',
+                'businessLogic/validation/database/dbQuery/schema/fileUpload(message: string, details?: unknown): never',
+                'config(message: string, configKey?: string): never',
+                'notFound(resource: string, identifier?: string): never',
+                'duplicate(resource: string, field: string, value: string): never',
+                'unauthorized/forbidden(message?: string): never',
+                'tokenExpired/invalidToken(): never',
+                'externalService(service: string, message: string, details?: unknown): never',
+                'serviceUnavailable(service: string): never',
+                'rateLimit(limit: number, window: string): never',
+                'scriptError(message: string, scriptId?: string, details?: unknown): never',
+                'scriptTimeout(timeoutMs: number, scriptId?: string): never',
+                'fileNotFound(filePath: string): never',
+                'fileSizeExceeded(maxSize: string, actualSize: string): never',
+                "'400'/'404'/'409'/'422'/'429'/'500'/'503'(message: string, details?: unknown): never; '401'/'403'(message?: string): never",
+            ],
+            '@PKGS': 'Record<string, package module>. Package calls may be async or thenable according to the installed package; await operations that produce values.',
+        },
+        bridge: {
+            async: 'In script code, calls through @REPOS, @HELPERS, @CACHE, @STORAGE, @SOCKET, @RES, and @TRIGGER cross the executor bridge and return promises. Await them.',
+            sync: '@LOGS and @THROW execute synchronously. Do not await them.',
+        },
+    };
+}
+//# sourceMappingURL=dynamic-script-context-contract.js.map

package/dist/lib/dynamic-script-context-contract.js.map

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

package/dist/lib/enfyra-mcp-server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createEnfyraMcpServer(): McpServer;
+export declare function runEnfyraMcpServer(): Promise<void>;

package/dist/lib/enfyra-mcp-server.js

@@ -0,0 +1,79 @@
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { initAuth } from './auth.js';
+import { registerDynamicRepositoryBuilder } from './dynamic-repository-builder.js';
+import { ENFYRA_API_TOKEN, ENFYRA_API_URL, MCP_DYNAMIC_TOOLS, MCP_PROFILE, MCP_TOOLSET, resolveCatalogToolAvailability, } from './enfyra-tool-logic.js';
+import { registerDiscoveryTools } from './discovery-tools.js';
+import { registerIdentityTools } from './identity-tools.js';
+import { registerLogTools } from './log-tools.js';
+import { buildMcpServerInstructions } from './mcp-instructions.js';
+import { startMcpUsageTelemetry } from './mcp-usage-telemetry.js';
+import { registerMethodTools } from './method-tools.js';
+import { registerOAuthProviderTools } from './oauth-tools.js';
+import { registerPackageTools } from './package-tools.js';
+import { registerPlatformOperationTools } from './platform-operation-tools.js';
+import { registerRecordTools } from './record-tools.js';
+import { installColumnarToolFormatter } from './response-format.js';
+import { registerRouteTools } from './route-tools.js';
+import { startRuntimeCacheSocket } from './runtime-cache-socket.js';
+import { registerRuntimeZoneTools } from './runtime-zone-tools.js';
+import { registerScriptTools } from './script-tools.js';
+import { readSourceArtifactResource } from './source-artifacts.js';
+import { registerSystemTools } from './system-tools.js';
+import { registerTableTools } from './table-tools.js';
+import { registerToolCatalogTools } from './tool-catalog.js';
+import { installToolAnnotations } from './tool-contracts.js';
+import { installToolOutputContracts } from './tool-output-contracts.js';
+import { installToolsetFilter, summarizeToolsetForInstructions, } from './toolset-filter.js';
+import { registerWorkflowToolPack } from './workflow-tool-packs.js';
+export function createEnfyraMcpServer() {
+    initAuth(ENFYRA_API_URL, ENFYRA_API_TOKEN);
+    const server = new McpServer({
+        name: 'enfyra-mcp',
+        version: '1.0.0',
+    }, {
+        instructions: buildMcpServerInstructions(ENFYRA_API_URL, {
+            toolsetSummary: summarizeToolsetForInstructions(MCP_TOOLSET, MCP_PROFILE, MCP_DYNAMIC_TOOLS),
+        }),
+    });
+    installToolOutputContracts(server);
+    installColumnarToolFormatter(server);
+    const toolsetState = installToolsetFilter(server, MCP_TOOLSET, MCP_PROFILE, { dynamic: MCP_DYNAMIC_TOOLS });
+    installToolAnnotations(server);
+    startMcpUsageTelemetry(ENFYRA_API_URL, `${MCP_TOOLSET}:${MCP_PROFILE}`);
+    server.registerResource('enfyra-source-artifact', new ResourceTemplate('enfyra-source://artifact/{artifactId}', { list: undefined }), {
+        title: 'Enfyra source artifact',
+        description: 'Process-scoped source or diff artifact created by an Enfyra MCP inspect or preview tool.',
+        mimeType: 'text/plain',
+    }, async (uri) => ({ contents: [readSourceArtifactResource(uri.href)] }));
+    registerDiscoveryTools(server, ENFYRA_API_URL);
+    registerRecordTools(server, ENFYRA_API_URL);
+    registerScriptTools(server, ENFYRA_API_URL);
+    registerMethodTools(server, ENFYRA_API_URL);
+    registerRouteTools(server, ENFYRA_API_URL);
+    registerTableTools(server, ENFYRA_API_URL, { toolset: MCP_TOOLSET });
+    registerPlatformOperationTools(server, ENFYRA_API_URL);
+    registerRuntimeZoneTools(server, ENFYRA_API_URL);
+    registerOAuthProviderTools(server, ENFYRA_API_URL);
+    registerDynamicRepositoryBuilder(server);
+    registerSystemTools(server, ENFYRA_API_URL);
+    registerLogTools(server, ENFYRA_API_URL);
+    registerIdentityTools(server, ENFYRA_API_URL);
+    registerPackageTools(server, ENFYRA_API_URL);
+    registerToolCatalogTools(server, toolsetState, {
+        resolveAvailability: resolveCatalogToolAvailability,
+    });
+    registerWorkflowToolPack(server, toolsetState);
+    return server;
+}
+export async function runEnfyraMcpServer() {
+    console.error('Starting Enfyra MCP Server...');
+    console.error(`API URL: ${ENFYRA_API_URL}`);
+    console.error(`Auth: ${ENFYRA_API_TOKEN ? 'API token configured' : 'Not configured'}`);
+    const server = createEnfyraMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    startRuntimeCacheSocket(ENFYRA_API_URL);
+    console.error('Enfyra MCP Server running on stdio');
+}
+//# sourceMappingURL=enfyra-mcp-server.js.map

package/dist/lib/enfyra-mcp-server.js.map

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

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

@@ -0,0 +1,7 @@
+export * from './tool-runtime-config.js';
+export * from './tool-metadata-operations.js';
+export * from './tool-permission-profile.js';
+export * from './tool-record-operations.js';
+export * from './tool-script-operations.js';
+export * from './tool-route-inspection.js';
+export * from './enfyra-tool-types.js';

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

@@ -0,0 +1,8 @@
+export * from './tool-runtime-config.js';
+export * from './tool-metadata-operations.js';
+export * from './tool-permission-profile.js';
+export * from './tool-record-operations.js';
+export * from './tool-script-operations.js';
+export * from './tool-route-inspection.js';
+export * from './enfyra-tool-types.js';
+//# sourceMappingURL=enfyra-tool-logic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enfyra-tool-logic.js","sourceRoot":"","sources":["../../src/lib/enfyra-tool-logic.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC"}

package/dist/lib/enfyra-tool-types.d.ts

@@ -0,0 +1,27 @@
+export type AnyRecord = Record<string, any>;
+export type MethodPatchBody = {
+    buttonColor?: string;
+    textColor?: string;
+    name?: string;
+};
+export type RouteCreateBody = {
+    path: string;
+    isEnabled: boolean;
+    description: string;
+    availableMethods: any;
+    mainTable?: {
+        id: any;
+    };
+    publicMethods?: any;
+};
+export type RouteHandlerBody = {
+    route: {
+        id: string | number;
+    };
+    method: {
+        id: any;
+    };
+    sourceCode: string;
+    scriptLanguage: 'javascript' | 'typescript';
+    timeout?: number;
+};

package/dist/lib/enfyra-tool-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=enfyra-tool-types.js.map

package/dist/lib/enfyra-tool-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enfyra-tool-types.js","sourceRoot":"","sources":["../../src/lib/enfyra-tool-types.ts"],"names":[],"mappings":""}

package/dist/lib/extension-api-builders.d.ts

@@ -0,0 +1,17 @@
+import { AnyRecord } from './platform-shared-operations.js';
+export declare function buildExtensionApiUsageSnippet(input?: AnyRecord): {
+    action: string;
+    operation: string;
+    snippet: string;
+    contract: string[];
+};
+export declare function buildExtensionNotifySnippet(input?: AnyRecord): {
+    action: string;
+    snippet: string;
+    contract: string[];
+};
+export declare function buildExtensionConfirmSnippet(input?: AnyRecord): {
+    action: string;
+    snippet: string;
+    contract: string[];
+};