@uvrn/mcp 1.0.0

package/dist/tools/handlers.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * MCP Tool Handlers
+ * Implements the three core tools for Delta Engine MCP server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRunEngine = handleRunEngine;
+exports.handleValidateBundle = handleValidateBundle;
+exports.handleVerifyReceipt = handleVerifyReceipt;
+const core_1 = require("@uvrn/core");
+const types_1 = require("../types");
+const logger_1 = require("../logger");
+const config_1 = require("../config");
+/**
+ * Tool: delta_run_engine
+ * Executes the Delta Engine on a provided bundle
+ */
+async function handleRunEngine(input) {
+    logger_1.logger.debug('handleRunEngine called', { bundleId: input.bundle?.bundleId });
+    try {
+        // Validate input structure
+        if (!input.bundle || typeof input.bundle !== 'object') {
+            throw new types_1.ValidationError('Invalid input: bundle must be an object');
+        }
+        const bundle = input.bundle;
+        // Enforce MAX_BUNDLE_SIZE if configured
+        if (config_1.config.maxBundleSize) {
+            const bundleSize = JSON.stringify(bundle).length;
+            if (bundleSize > config_1.config.maxBundleSize) {
+                throw new types_1.ValidationError(`Bundle size (${bundleSize} bytes) exceeds maximum allowed size (${config_1.config.maxBundleSize} bytes)`, { bundleSize, maxBundleSize: config_1.config.maxBundleSize });
+            }
+        }
+        // Explicitly validate bundle structure before execution
+        const validationResult = (0, core_1.validateBundle)(bundle);
+        if (!validationResult.valid) {
+            throw new types_1.ValidationError(`Bundle validation failed: ${validationResult.error}`, { validationResult });
+        }
+        // Run the engine
+        const receipt = (0, core_1.runDeltaEngine)(bundle, {
+            timestamp: input.options?.timestamp,
+        });
+        logger_1.logger.info('Engine executed successfully', {
+            bundleId: bundle.bundleId,
+            outcome: receipt.outcome,
+        });
+        return {
+            receipt,
+            success: true,
+        };
+    }
+    catch (error) {
+        // Preserve validation errors as-is
+        if (error instanceof types_1.ValidationError) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        const errorDetails = config_1.config.verboseErrors ? { originalError: error } : undefined;
+        logger_1.logger.error('Engine execution failed', { error: message });
+        throw new types_1.ExecutionError(`Engine execution failed: ${message}`, errorDetails);
+    }
+}
+/**
+ * Tool: delta_validate_bundle
+ * Validates bundle structure without executing
+ */
+async function handleValidateBundle(input) {
+    logger_1.logger.debug('handleValidateBundle called');
+    try {
+        // Validate input structure
+        if (!input.bundle || typeof input.bundle !== 'object') {
+            return {
+                valid: false,
+                error: 'Invalid input: bundle must be an object',
+                details: 'The provided bundle is not a valid object',
+            };
+        }
+        const bundle = input.bundle;
+        const result = (0, core_1.validateBundle)(bundle);
+        logger_1.logger.info('Bundle validation completed', {
+            valid: result.valid,
+            bundleId: bundle.bundleId,
+        });
+        return {
+            valid: result.valid,
+            error: result.error,
+            details: result.valid
+                ? `Bundle "${bundle.bundleId}" is valid with ${bundle.dataSpecs.length} data specs`
+                : result.error,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger_1.logger.error('Bundle validation error', { error: message });
+        return {
+            valid: false,
+            error: 'Validation error',
+            details: message,
+        };
+    }
+}
+/**
+ * Tool: delta_verify_receipt
+ * Verifies receipt integrity and hash chain
+ */
+async function handleVerifyReceipt(input) {
+    logger_1.logger.debug('handleVerifyReceipt called');
+    try {
+        // Validate input structure
+        if (!input.receipt || typeof input.receipt !== 'object') {
+            return {
+                verified: false,
+                error: 'Invalid input: receipt must be an object',
+                details: 'The provided receipt is not a valid object',
+            };
+        }
+        const receipt = input.receipt;
+        const result = (0, core_1.verifyReceipt)(receipt);
+        logger_1.logger.info('Receipt verification completed', {
+            verified: result.verified,
+            bundleId: receipt.bundleId,
+        });
+        return {
+            verified: result.verified,
+            recomputedHash: result.recomputedHash,
+            error: result.error,
+            details: result.verified
+                ? `Receipt for bundle "${receipt.bundleId}" is valid. Hash verified: ${receipt.hash}`
+                : result.error,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger_1.logger.error('Receipt verification error', { error: message });
+        return {
+            verified: false,
+            error: 'Verification error',
+            details: message,
+        };
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/tools/handlers.js.map

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

package/dist/tools/schemas.d.ts

@@ -0,0 +1,147 @@
+/**
+ * MCP Tool Schemas
+ * JSON Schema definitions for tool inputs
+ */
+export declare const runEngineSchema: {
+    type: string;
+    properties: {
+        bundle: {
+            type: string;
+            description: string;
+            properties: {
+                bundleId: {
+                    type: string;
+                    description: string;
+                };
+                claim: {
+                    type: string;
+                    description: string;
+                };
+                dataSpecs: {
+                    type: string;
+                    description: string;
+                    minItems: number;
+                    items: {
+                        type: string;
+                        properties: {
+                            id: {
+                                type: string;
+                            };
+                            label: {
+                                type: string;
+                            };
+                            sourceKind: {
+                                type: string;
+                                enum: string[];
+                            };
+                            originDocIds: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                };
+                            };
+                            metrics: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                    properties: {
+                                        key: {
+                                            type: string;
+                                        };
+                                        value: {
+                                            type: string;
+                                        };
+                                        unit: {
+                                            type: string;
+                                        };
+                                        ts: {
+                                            type: string;
+                                        };
+                                    };
+                                    required: string[];
+                                };
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                thresholdPct: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    exclusiveMinimum: boolean;
+                    maximum: number;
+                };
+                maxRounds: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        options: {
+            type: string;
+            description: string;
+            properties: {
+                timestamp: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+    };
+    required: string[];
+};
+export declare const validateBundleSchema: {
+    type: string;
+    properties: {
+        bundle: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+};
+export declare const verifyReceiptSchema: {
+    type: string;
+    properties: {
+        receipt: {
+            type: string;
+            description: string;
+            properties: {
+                bundleId: {
+                    type: string;
+                };
+                deltaFinal: {
+                    type: string;
+                };
+                sources: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                rounds: {
+                    type: string;
+                };
+                suggestedFixes: {
+                    type: string;
+                };
+                outcome: {
+                    type: string;
+                    enum: string[];
+                };
+                ts: {
+                    type: string;
+                };
+                hash: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    required: string[];
+};
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkE3B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;CAShC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuB/B,CAAC"}

package/dist/tools/schemas.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * MCP Tool Schemas
+ * JSON Schema definitions for tool inputs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyReceiptSchema = exports.validateBundleSchema = exports.runEngineSchema = void 0;
+exports.runEngineSchema = {
+    type: 'object',
+    properties: {
+        bundle: {
+            type: 'object',
+            description: 'DeltaBundle to process',
+            properties: {
+                bundleId: { type: 'string', description: 'Unique bundle identifier' },
+                claim: { type: 'string', description: 'Claim being verified' },
+                dataSpecs: {
+                    type: 'array',
+                    description: 'Array of data specifications (minimum 2)',
+                    minItems: 2,
+                    items: {
+                        type: 'object',
+                        properties: {
+                            id: { type: 'string' },
+                            label: { type: 'string' },
+                            sourceKind: {
+                                type: 'string',
+                                enum: ['report', 'metric', 'chart', 'meta']
+                            },
+                            originDocIds: { type: 'array', items: { type: 'string' } },
+                            metrics: {
+                                type: 'array',
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        key: { type: 'string' },
+                                        value: { type: 'number' },
+                                        unit: { type: 'string' },
+                                        ts: { type: 'string' },
+                                    },
+                                    required: ['key', 'value'],
+                                },
+                            },
+                        },
+                        required: ['id', 'label', 'sourceKind', 'originDocIds', 'metrics'],
+                    },
+                },
+                thresholdPct: {
+                    type: 'number',
+                    description: 'Threshold percentage (must be > 0 and <= 1.0)',
+                    minimum: 0.001,
+                    exclusiveMinimum: true,
+                    maximum: 1,
+                },
+                maxRounds: {
+                    type: 'number',
+                    description: 'Maximum rounds (default: 5)',
+                },
+            },
+            required: ['bundleId', 'claim', 'dataSpecs', 'thresholdPct'],
+        },
+        options: {
+            type: 'object',
+            description: 'Optional execution options',
+            properties: {
+                timestamp: {
+                    type: 'string',
+                    description: 'ISO timestamp for receipt envelope',
+                },
+            },
+        },
+    },
+    required: ['bundle'],
+};
+exports.validateBundleSchema = {
+    type: 'object',
+    properties: {
+        bundle: {
+            type: 'object',
+            description: 'DeltaBundle to validate (same structure as runEngine)',
+        },
+    },
+    required: ['bundle'],
+};
+exports.verifyReceiptSchema = {
+    type: 'object',
+    properties: {
+        receipt: {
+            type: 'object',
+            description: 'DeltaReceipt to verify',
+            properties: {
+                bundleId: { type: 'string' },
+                deltaFinal: { type: 'number' },
+                sources: { type: 'array', items: { type: 'string' } },
+                rounds: { type: 'array' },
+                suggestedFixes: { type: 'array' },
+                outcome: {
+                    type: 'string',
+                    enum: ['consensus', 'indeterminate']
+                },
+                ts: { type: 'string' },
+                hash: { type: 'string', description: 'SHA-256 hash of canonical payload' },
+            },
+            required: ['bundleId', 'deltaFinal', 'sources', 'rounds', 'outcome', 'hash'],
+        },
+    },
+    required: ['receipt'],
+};
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * MCP Server Type Definitions
+ * Extends uvrn-core types with MCP-specific interfaces
+ */
+import type { DeltaBundle, DeltaReceipt, DeltaRound, DataSpec, MetricPoint, ValidationResult, VerifyResult, Outcome, EngineOpts } from '@uvrn/core';
+export type { DeltaBundle, DeltaReceipt, DeltaRound, DataSpec, MetricPoint, ValidationResult, VerifyResult, Outcome, EngineOpts, };
+/**
+ * MCP Tool Input/Output Types
+ */
+export interface RunEngineInput {
+    bundle: DeltaBundle;
+    options?: {
+        timestamp?: string;
+    };
+}
+export interface RunEngineOutput {
+    receipt: DeltaReceipt;
+    success: true;
+}
+export interface ValidateBundleInput {
+    bundle: DeltaBundle;
+}
+export interface ValidateBundleOutput {
+    valid: boolean;
+    error?: string;
+    details?: string;
+}
+export interface VerifyReceiptInput {
+    receipt: DeltaReceipt;
+}
+export interface VerifyReceiptOutput {
+    verified: boolean;
+    recomputedHash?: string;
+    error?: string;
+    details?: string;
+}
+/**
+ * MCP Resource Types
+ */
+export interface ResourceUriParams {
+    uvrn?: string;
+    id?: string;
+}
+/**
+ * MCP Error Types
+ */
+export declare class MCPError extends Error {
+    code: string;
+    details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+export declare class ValidationError extends MCPError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ExecutionError extends MCPError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ResourceNotFoundError extends MCPError {
+    constructor(resourceId: string);
+}
+/**
+ * Configuration Types
+ */
+export interface ServerConfig {
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    storagePath?: string;
+    maxBundleSize?: number;
+    verboseErrors?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,UAAU,EACX,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,UAAU,GACX,CAAC;AAEF;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AAEH,qBAAa,QAAS,SAAQ,KAAK;IAGxB,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,OAAO;gBAFxB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,UAAU,EAAE,MAAM;CAI/B;AAED;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/types.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * MCP Server Type Definitions
+ * Extends uvrn-core types with MCP-specific interfaces
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceNotFoundError = exports.ExecutionError = exports.ValidationError = exports.MCPError = void 0;
+/**
+ * MCP Error Types
+ */
+class MCPError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'MCPError';
+    }
+}
+exports.MCPError = MCPError;
+class ValidationError extends MCPError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', details);
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+class ExecutionError extends MCPError {
+    constructor(message, details) {
+        super(message, 'EXECUTION_ERROR', details);
+        this.name = 'ExecutionError';
+    }
+}
+exports.ExecutionError = ExecutionError;
+class ResourceNotFoundError extends MCPError {
+    constructor(resourceId) {
+        super(`Resource not found: ${resourceId}`, 'RESOURCE_NOT_FOUND', { resourceId });
+        this.name = 'ResourceNotFoundError';
+    }
+}
+exports.ResourceNotFoundError = ResourceNotFoundError;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA0EH;;GAEG;AAEH,MAAa,QAAS,SAAQ,KAAK;IAGxB;IACA;IAHT,YACE,OAAe,EACR,IAAY,EACZ,OAAiB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AATD,4BASC;AAED,MAAa,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,MAAa,cAAe,SAAQ,QAAQ;IAC1C,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC;AAED,MAAa,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,UAAkB;QAC5B,KAAK,CAAC,uBAAuB,UAAU,EAAE,EAAE,oBAAoB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@uvrn/mcp",
+  "version": "1.0.0",
+  "description": "UVRN MCP server — AI-native bundle processing",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "uvrn-mcp": "dist/index.js"
+  },
+  "keywords": [
+    "uvrn",
+    "mcp",
+    "verification",
+    "receipt",
+    "ai"
+  ],
+  "author": "UVRN",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@uvrn/core": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "prettier": "^3.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\""
+  }
+}