@uvrn/mcp 1.0.0

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,qCAAkC;AAIlC,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,MAAM;IACF,KAAK,CAAS;IAEtB,YAAY,YAAsB,MAAM;QACtC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;CACF;AAEY,QAAA,MAAM,GAAG,IAAI,MAAM,CAAC,eAAM,CAAC,QAAQ,CAAC,CAAC"}

package/dist/prompts/templates.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MCP Prompt Templates
+ * Provides reusable prompt templates for common Delta Engine tasks
+ */
+export interface PromptTemplate {
+    name: string;
+    description: string;
+    template: string;
+    parameters?: string[];
+}
+/**
+ * Prompt: verify_data
+ * Template for data verification queries
+ */
+export declare const verifyDataPrompt: PromptTemplate;
+/**
+ * Prompt: create_bundle
+ * Template for bundle creation guidance
+ */
+export declare const createBundlePrompt: PromptTemplate;
+/**
+ * Prompt: analyze_receipt
+ * Template for receipt analysis
+ */
+export declare const analyzeReceiptPrompt: PromptTemplate;
+/**
+ * Get prompt by name
+ */
+export declare function getPrompt(name: string): Promise<PromptTemplate>;
+/**
+ * List all available prompts
+ */
+export declare function listPrompts(): Promise<PromptTemplate[]>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/prompts/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/prompts/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAkB9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAkBhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAkBlC,CAAC;AAEF;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAgBrE;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAE7D"}

package/dist/prompts/templates.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * MCP Prompt Templates
+ * Provides reusable prompt templates for common Delta Engine tasks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeReceiptPrompt = exports.createBundlePrompt = exports.verifyDataPrompt = void 0;
+exports.getPrompt = getPrompt;
+exports.listPrompts = listPrompts;
+const logger_1 = require("../logger");
+/**
+ * Prompt: verify_data
+ * Template for data verification queries
+ */
+exports.verifyDataPrompt = {
+    name: 'verify_data',
+    description: 'Template for verifying data across multiple sources',
+    parameters: ['claim', 'sources'],
+    template: `I need to verify the following claim using Delta Engine:
+
+Claim: {{claim}}
+
+Please help me:
+1. Create a DeltaBundle with data from these sources: {{sources}}
+2. Run the delta_run_engine tool to process the bundle
+3. Analyze the receipt and explain:
+   - What is the consensus outcome?
+   - What is the final delta between sources?
+   - Are the sources in agreement within the threshold?
+   - What rounds were needed to reach the outcome?
+
+Format the bundle with appropriate thresholdPct and dataSpecs.`,
+};
+/**
+ * Prompt: create_bundle
+ * Template for bundle creation guidance
+ */
+exports.createBundlePrompt = {
+    name: 'create_bundle',
+    description: 'Guide user through creating a DeltaBundle',
+    parameters: ['claim'],
+    template: `I want to create a DeltaBundle to verify: {{claim}}
+
+Please guide me through:
+1. What data sources should I include? (minimum 2 required)
+2. What metrics should I compare across sources?
+3. What threshold percentage should I use?
+4. Help me structure the bundle JSON with:
+   - bundleId: unique identifier
+   - claim: the verification claim
+   - dataSpecs: array of at least 2 data specifications
+   - thresholdPct: acceptable variance (0.0 to 1.0)
+   - maxRounds: optional, defaults to 5
+
+Once we have the bundle structure, we can use delta_validate_bundle to check it before running.`,
+};
+/**
+ * Prompt: analyze_receipt
+ * Template for receipt analysis
+ */
+exports.analyzeReceiptPrompt = {
+    name: 'analyze_receipt',
+    description: 'Analyze a Delta Engine receipt',
+    parameters: ['receipt_json'],
+    template: `Please analyze this Delta Engine receipt:
+
+{{receipt_json}}
+
+Help me understand:
+1. What was being verified? (bundleId and sources)
+2. What was the outcome? (consensus or indeterminate)
+3. What was the final delta between sources?
+4. How many rounds were needed?
+5. For each round, what were the deltas by metric?
+6. Is the receipt hash valid? (use delta_verify_receipt to check)
+7. What does this tell us about data agreement across sources?
+
+Provide a clear explanation of the verification results.`,
+};
+/**
+ * Get prompt by name
+ */
+async function getPrompt(name) {
+    logger_1.logger.debug('getPrompt called', { name });
+    switch (name) {
+        case 'verify_data':
+            return exports.verifyDataPrompt;
+        case 'create_bundle':
+            return exports.createBundlePrompt;
+        case 'analyze_receipt':
+            return exports.analyzeReceiptPrompt;
+        default:
+            throw new Error(`Unknown prompt: ${name}`);
+    }
+}
+/**
+ * List all available prompts
+ */
+async function listPrompts() {
+    return [exports.verifyDataPrompt, exports.createBundlePrompt, exports.analyzeReceiptPrompt];
+}
+//# sourceMappingURL=templates.js.map

package/dist/prompts/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/prompts/templates.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAsFH,8BAgBC;AAKD,kCAEC;AA3GD,sCAAmC;AASnC;;;GAGG;AACU,QAAA,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,qDAAqD;IAClE,UAAU,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;IAChC,QAAQ,EAAE;;;;;;;;;;;;;+DAamD;CAC9D,CAAC;AAEF;;;GAGG;AACU,QAAA,kBAAkB,GAAmB;IAChD,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,2CAA2C;IACxD,UAAU,EAAE,CAAC,OAAO,CAAC;IACrB,QAAQ,EAAE;;;;;;;;;;;;;gGAaoF;CAC/F,CAAC;AAEF;;;GAGG;AACU,QAAA,oBAAoB,GAAmB;IAClD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,gCAAgC;IAC7C,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,QAAQ,EAAE;;;;;;;;;;;;;yDAa6C;CACxD,CAAC;AAEF;;GAEG;AACI,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,eAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,wBAAgB,CAAC;QAE1B,KAAK,eAAe;YAClB,OAAO,0BAAkB,CAAC;QAE5B,KAAK,iBAAiB;YACpB,OAAO,4BAAoB,CAAC;QAE9B;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,WAAW;IAC/B,OAAO,CAAC,wBAAgB,EAAE,0BAAkB,EAAE,4BAAoB,CAAC,CAAC;AACtE,CAAC"}

package/dist/resources/handlers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MCP Resource Handlers
+ * Provides access to schemas and stored data via MCP resources
+ */
+/**
+ * Schema resources
+ */
+export declare function getBundleSchema(): Promise<unknown>;
+export declare function getReceiptSchema(): Promise<unknown>;
+/**
+ * Receipt retrieval by UVRN
+ * Note: In Phase A.3, we don't have persistent storage yet
+ * This is a placeholder for future implementation
+ */
+export declare function getReceiptByUvrn(uvrn: string): Promise<unknown>;
+/**
+ * Bundle retrieval by ID
+ * Note: In Phase A.3, we don't have persistent storage yet
+ * This is a placeholder for future implementation
+ */
+export declare function getBundleById(id: string): Promise<unknown>;
+/**
+ * Resource URI parser
+ */
+export declare function parseResourceUri(uri: string): {
+    type: string;
+    id?: string;
+};
+/**
+ * Main resource handler
+ */
+export declare function handleResource(uri: string): Promise<unknown>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/resources/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/resources/handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AAEH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAGxD;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAGzD;AAED;;;;GAIG;AAEH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKrE;AAED;;;;GAIG;AAEH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhE;AAED;;GAEG;AAEH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CA0B3E;AAED;;GAEG;AAEH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBlE"}

package/dist/resources/handlers.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * MCP Resource Handlers
+ * Provides access to schemas and stored data via MCP resources
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBundleSchema = getBundleSchema;
+exports.getReceiptSchema = getReceiptSchema;
+exports.getReceiptByUvrn = getReceiptByUvrn;
+exports.getBundleById = getBundleById;
+exports.parseResourceUri = parseResourceUri;
+exports.handleResource = handleResource;
+const types_1 = require("../types");
+const logger_1 = require("../logger");
+const schemas_1 = require("../tools/schemas");
+/**
+ * Schema resources
+ */
+async function getBundleSchema() {
+    logger_1.logger.debug('getBundleSchema called');
+    return schemas_1.runEngineSchema.properties.bundle;
+}
+async function getReceiptSchema() {
+    logger_1.logger.debug('getReceiptSchema called');
+    return schemas_1.verifyReceiptSchema.properties.receipt;
+}
+/**
+ * Receipt retrieval by UVRN
+ * Note: In Phase A.3, we don't have persistent storage yet
+ * This is a placeholder for future implementation
+ */
+async function getReceiptByUvrn(uvrn) {
+    logger_1.logger.debug('getReceiptByUvrn called', { uvrn });
+    // TODO: Implement receipt storage/retrieval in future phase
+    throw new types_1.ResourceNotFoundError(`Receipt with UVRN ${uvrn} not found (storage not yet implemented)`);
+}
+/**
+ * Bundle retrieval by ID
+ * Note: In Phase A.3, we don't have persistent storage yet
+ * This is a placeholder for future implementation
+ */
+async function getBundleById(id) {
+    logger_1.logger.debug('getBundleById called', { id });
+    // TODO: Implement bundle storage/retrieval in future phase
+    throw new types_1.ResourceNotFoundError(`Bundle with ID ${id} not found (storage not yet implemented)`);
+}
+/**
+ * Resource URI parser
+ */
+function parseResourceUri(uri) {
+    logger_1.logger.debug('parseResourceUri', { uri });
+    // mcp://delta-engine/schema/bundle
+    if (uri === 'mcp://delta-engine/schema/bundle') {
+        return { type: 'schema-bundle' };
+    }
+    // mcp://delta-engine/schema/receipt
+    if (uri === 'mcp://delta-engine/schema/receipt') {
+        return { type: 'schema-receipt' };
+    }
+    // mcp://delta-engine/receipts/{uvrn}
+    const receiptMatch = uri.match(/^mcp:\/\/delta-engine\/receipts\/(.+)$/);
+    if (receiptMatch) {
+        return { type: 'receipt', id: receiptMatch[1] };
+    }
+    // mcp://delta-engine/bundles/{id}
+    const bundleMatch = uri.match(/^mcp:\/\/delta-engine\/bundles\/(.+)$/);
+    if (bundleMatch) {
+        return { type: 'bundle', id: bundleMatch[1] };
+    }
+    throw new types_1.ResourceNotFoundError(`Invalid resource URI: ${uri}`);
+}
+/**
+ * Main resource handler
+ */
+async function handleResource(uri) {
+    const parsed = parseResourceUri(uri);
+    switch (parsed.type) {
+        case 'schema-bundle':
+            return getBundleSchema();
+        case 'schema-receipt':
+            return getReceiptSchema();
+        case 'receipt':
+            if (!parsed.id)
+                throw new types_1.ResourceNotFoundError('Receipt UVRN missing');
+            return getReceiptByUvrn(parsed.id);
+        case 'bundle':
+            if (!parsed.id)
+                throw new types_1.ResourceNotFoundError('Bundle ID missing');
+            return getBundleById(parsed.id);
+        default:
+            throw new types_1.ResourceNotFoundError(`Unknown resource type: ${parsed.type}`);
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/resources/handlers.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Delta Engine MCP Server
+ * Main server implementation using MCP SDK
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * Create and configure the MCP server
+ */
+export declare function createServer(): Server;
+/**
+ * Start the MCP server
+ */
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAuBnE;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAuPrC;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAcjD"}

package/dist/server.js

@@ -0,0 +1,256 @@
+"use strict";
+/**
+ * Delta Engine MCP Server
+ * Main server implementation using MCP SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+exports.startServer = startServer;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const logger_1 = require("./logger");
+const handlers_1 = require("./tools/handlers");
+const schemas_1 = require("./tools/schemas");
+const handlers_2 = require("./resources/handlers");
+const templates_1 = require("./prompts/templates");
+const types_1 = require("./types");
+/**
+ * Create and configure the MCP server
+ */
+function createServer() {
+    const server = new index_js_1.Server({
+        name: 'delta-engine-mcp',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {},
+        },
+    });
+    /**
+     * Tool Handlers
+     */
+    // List available tools
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+        logger_1.logger.debug('ListTools request received');
+        return {
+            tools: [
+                {
+                    name: 'delta_run_engine',
+                    description: 'Execute the Delta Engine on a bundle to verify data consensus across sources. ' +
+                        'Returns a DeltaReceipt with outcome (consensus/indeterminate) and round-by-round analysis.',
+                    inputSchema: schemas_1.runEngineSchema,
+                },
+                {
+                    name: 'delta_validate_bundle',
+                    description: 'Validate a DeltaBundle structure without executing the engine. ' +
+                        'Checks required fields, data types, and structural integrity.',
+                    inputSchema: schemas_1.validateBundleSchema,
+                },
+                {
+                    name: 'delta_verify_receipt',
+                    description: 'Verify the integrity of a DeltaReceipt by recomputing its hash. ' +
+                        'Ensures the receipt has not been tampered with.',
+                    inputSchema: schemas_1.verifyReceiptSchema,
+                },
+            ],
+        };
+    });
+    // Handle tool calls
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        logger_1.logger.debug('CallTool request received', { tool: request.params.name });
+        try {
+            switch (request.params.name) {
+                case 'delta_run_engine': {
+                    const result = await (0, handlers_1.handleRunEngine)(request.params.arguments);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case 'delta_validate_bundle': {
+                    const result = await (0, handlers_1.handleValidateBundle)(request.params.arguments);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case 'delta_verify_receipt': {
+                    const result = await (0, handlers_1.handleVerifyReceipt)(request.params.arguments);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                default:
+                    throw new Error(`Unknown tool: ${request.params.name}`);
+            }
+        }
+        catch (error) {
+            logger_1.logger.error('Tool execution error', { error });
+            if (error instanceof types_1.MCPError) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: error.message,
+                                code: error.code,
+                                details: error.details,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: message,
+                            code: 'INTERNAL_ERROR',
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    /**
+     * Resource Handlers
+     */
+    // List available resources
+    server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => {
+        logger_1.logger.debug('ListResources request received');
+        return {
+            resources: [
+                {
+                    uri: 'mcp://delta-engine/schema/bundle',
+                    name: 'DeltaBundle Schema',
+                    description: 'JSON schema for DeltaBundle structure',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'mcp://delta-engine/schema/receipt',
+                    name: 'DeltaReceipt Schema',
+                    description: 'JSON schema for DeltaReceipt structure',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'mcp://delta-engine/receipts/{uvrn}',
+                    name: 'Receipt by UVRN',
+                    description: 'Retrieve a DeltaReceipt by its UVRN (Note: Storage not yet implemented in Phase A.3)',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'mcp://delta-engine/bundles/{id}',
+                    name: 'Bundle by ID',
+                    description: 'Retrieve a DeltaBundle by its ID (Note: Storage not yet implemented in Phase A.3)',
+                    mimeType: 'application/json',
+                },
+            ],
+        };
+    });
+    // Handle resource reads
+    server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
+        logger_1.logger.debug('ReadResource request received', { uri: request.params.uri });
+        try {
+            const data = await (0, handlers_2.handleResource)(request.params.uri);
+            return {
+                contents: [
+                    {
+                        uri: request.params.uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger_1.logger.error('Resource read error', { error });
+            throw error;
+        }
+    });
+    /**
+     * Prompt Handlers
+     */
+    // List available prompts
+    server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => {
+        logger_1.logger.debug('ListPrompts request received');
+        const prompts = await (0, templates_1.listPrompts)();
+        return {
+            prompts: prompts.map((p) => ({
+                name: p.name,
+                description: p.description,
+                arguments: p.parameters?.map((param) => ({
+                    name: param,
+                    description: `Parameter: ${param}`,
+                    required: true,
+                })) || [],
+            })),
+        };
+    });
+    // Handle prompt requests
+    server.setRequestHandler(types_js_1.GetPromptRequestSchema, async (request) => {
+        logger_1.logger.debug('GetPrompt request received', { prompt: request.params.name });
+        try {
+            const prompt = await (0, templates_1.getPrompt)(request.params.name);
+            // Substitute parameters if provided
+            let text = prompt.template;
+            if (request.params.arguments) {
+                Object.entries(request.params.arguments).forEach(([key, value]) => {
+                    text = text.replace(new RegExp(`{{${key}}}`, 'g'), String(value));
+                });
+            }
+            return {
+                description: prompt.description,
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text,
+                        },
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger_1.logger.error('Prompt error', { error });
+            throw error;
+        }
+    });
+    return server;
+}
+/**
+ * Start the MCP server
+ */
+async function startServer() {
+    logger_1.logger.info('Starting Delta Engine MCP Server...');
+    const server = createServer();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    logger_1.logger.info('Delta Engine MCP Server started successfully');
+    logger_1.logger.info('Server capabilities:', {
+        tools: 3,
+        resources: 4,
+        prompts: 3,
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/handlers.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP Tool Handlers
+ * Implements the three core tools for Delta Engine MCP server
+ */
+import { RunEngineInput, RunEngineOutput, ValidateBundleInput, ValidateBundleOutput, VerifyReceiptInput, VerifyReceiptOutput } from '../types';
+/**
+ * Tool: delta_run_engine
+ * Executes the Delta Engine on a provided bundle
+ */
+export declare function handleRunEngine(input: RunEngineInput): Promise<RunEngineOutput>;
+/**
+ * Tool: delta_validate_bundle
+ * Validates bundle structure without executing
+ */
+export declare function handleValidateBundle(input: ValidateBundleInput): Promise<ValidateBundleOutput>;
+/**
+ * Tool: delta_verify_receipt
+ * Verifies receipt integrity and hash chain
+ */
+export declare function handleVerifyReceipt(input: VerifyReceiptInput): Promise<VerifyReceiptOutput>;
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EAGpB,MAAM,UAAU,CAAC;AAIlB;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAyDrF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAsC/B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAuC9B"}