@defai.digital/mcp-server 13.0.3

package/dist/trace-wrapper.js

@@ -0,0 +1,151 @@
+/**
+ * MCP Tool Trace Wrapper
+ *
+ * Wraps tool handlers with tracing for observability.
+ *
+ * Invariants:
+ * - INV-MCP-007: Every tool call produces exactly one trace
+ * - INV-MCP-008: Trace includes input/output/duration/success
+ */
+import { createToolTraceEvent } from '@defai.digital/contracts';
+/**
+ * In-memory trace collector implementation
+ */
+export class InMemoryTraceCollector {
+    events = [];
+    maxEvents;
+    constructor(maxEvents = 1000) {
+        this.maxEvents = maxEvents;
+    }
+    record(event) {
+        this.events.push(event);
+        // Trim old events if over limit
+        if (this.events.length > this.maxEvents) {
+            this.events = this.events.slice(-this.maxEvents);
+        }
+    }
+    getEvents() {
+        return [...this.events];
+    }
+    clear() {
+        this.events = [];
+    }
+    /**
+     * Gets summary statistics
+     */
+    getSummary() {
+        const byTool = {};
+        let totalDuration = 0;
+        let successCount = 0;
+        for (const event of this.events) {
+            byTool[event.toolName] = (byTool[event.toolName] ?? 0) + 1;
+            totalDuration += event.durationMs;
+            if (event.success) {
+                successCount++;
+            }
+        }
+        return {
+            totalInvocations: this.events.length,
+            successCount,
+            failureCount: this.events.length - successCount,
+            avgDurationMs: this.events.length > 0 ? totalDuration / this.events.length : 0,
+            byTool,
+        };
+    }
+}
+// ============================================================================
+// Global Trace Collector
+// ============================================================================
+/**
+ * Global trace collector instance
+ */
+let globalCollector;
+/**
+ * Sets the global trace collector
+ */
+export function setTraceCollector(collector) {
+    globalCollector = collector;
+}
+/**
+ * Gets the global trace collector
+ */
+export function getTraceCollector() {
+    return globalCollector;
+}
+// ============================================================================
+// Trace Wrapper Functions
+// ============================================================================
+/**
+ * Wraps a single tool handler with tracing
+ *
+ * INV-MCP-007: Every tool call produces exactly one trace event
+ * INV-MCP-008: Trace includes input/output/duration/success
+ */
+export function withTracing(toolName, handler, collector) {
+    return async (args) => {
+        const startTime = Date.now();
+        const effectiveCollector = collector ?? globalCollector;
+        try {
+            // Execute the handler
+            const result = await handler(args);
+            const durationMs = Date.now() - startTime;
+            // INV-MCP-007: Record trace event
+            if (effectiveCollector !== undefined) {
+                const firstContent = result.content.length > 0 ? result.content[0] : undefined;
+                const traceEvent = createToolTraceEvent(toolName, args, durationMs, !result.isError, {
+                    output: firstContent?.text,
+                });
+                effectiveCollector.record(traceEvent);
+            }
+            return result;
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            // INV-MCP-007: Record trace event even on error
+            if (effectiveCollector !== undefined) {
+                const traceEvent = createToolTraceEvent(toolName, args, durationMs, false, {
+                    errorCode: 'TOOL_ERROR',
+                    errorMessage: message,
+                });
+                effectiveCollector.record(traceEvent);
+            }
+            // Re-throw to let the server handle it
+            throw error;
+        }
+    };
+}
+/**
+ * Wraps all handlers in a registry with tracing
+ */
+export function wrapHandlersWithTracing(handlers, collector) {
+    const wrapped = {};
+    for (const [name, handler] of Object.entries(handlers)) {
+        wrapped[name] = withTracing(name, handler, collector);
+    }
+    return wrapped;
+}
+// ============================================================================
+// Default Initialization
+// ============================================================================
+/**
+ * Initializes default trace collector if not already set
+ * Returns the collector, which may be InMemoryTraceCollector or a custom implementation
+ */
+export function initializeDefaultTracing() {
+    if (globalCollector === undefined) {
+        globalCollector = new InMemoryTraceCollector();
+    }
+    return globalCollector;
+}
+/**
+ * Gets the trace collector as InMemoryTraceCollector if it is one
+ * Returns undefined if no collector is set or if it's a different implementation
+ */
+export function getInMemoryTraceCollector() {
+    if (globalCollector instanceof InMemoryTraceCollector) {
+        return globalCollector;
+    }
+    return undefined;
+}
+//# sourceMappingURL=trace-wrapper.js.map

package/dist/trace-wrapper.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,185 @@
+/**
+ * MCP Tool definition
+ * INV-MCP-004: Tools MUST declare idempotency
+ */
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: MCPSchema;
+    /**
+     * Output schema for the tool result
+     * INV-MCP-006: Tools SHOULD declare output schemas
+     */
+    outputSchema?: MCPSchema;
+    /**
+     * Whether the tool is idempotent (can be safely retried)
+     * INV-MCP-004: Tools MUST declare idempotency
+     */
+    idempotent?: boolean;
+    /**
+     * Error codes that are safe to retry
+     */
+    retryableErrors?: string[];
+}
+/**
+ * MCP Schema (JSON Schema subset)
+ */
+export interface MCPSchema {
+    type: 'object';
+    properties: Record<string, MCPProperty>;
+    required?: string[];
+}
+/**
+ * MCP Property definition (JSON Schema subset)
+ */
+export interface MCPProperty {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description?: string | undefined;
+    enum?: string[] | undefined;
+    items?: MCPProperty | undefined;
+    default?: unknown;
+    minItems?: number | undefined;
+    maxItems?: number | undefined;
+    minimum?: number | undefined;
+    maximum?: number | undefined;
+    properties?: Record<string, MCPProperty> | undefined;
+    required?: string[] | undefined;
+    additionalProperties?: MCPProperty | boolean | undefined;
+}
+/**
+ * MCP Tool call request
+ */
+export interface MCPToolCall {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * MCP Tool call result
+ */
+export interface MCPToolResult {
+    content: MCPContent[];
+    isError?: boolean | undefined;
+}
+/**
+ * MCP Content block
+ */
+export interface MCPContent {
+    type: 'text' | 'image' | 'resource';
+    text?: string | undefined;
+    data?: string | undefined;
+    mimeType?: string | undefined;
+}
+/**
+ * MCP Server configuration
+ */
+export interface MCPServerConfig {
+    name: string;
+    version: string;
+    description?: string | undefined;
+}
+/**
+ * Tool handler function
+ */
+export type ToolHandler = (args: Record<string, unknown>) => Promise<MCPToolResult>;
+/**
+ * MCP message types
+ */
+export interface MCPRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown> | undefined;
+}
+export interface MCPResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: unknown;
+    error?: MCPError | undefined;
+}
+export interface MCPError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * Standard MCP error codes
+ */
+export declare const MCPErrorCodes: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+};
+/**
+ * MCP Resource definition
+ */
+export interface MCPResource {
+    /** Resource URI (e.g., "automatosx://workflows") */
+    uri: string;
+    /** Display name */
+    name: string;
+    /** Description */
+    description?: string | undefined;
+    /** MIME type of resource content */
+    mimeType?: string | undefined;
+}
+/**
+ * MCP Resource content
+ */
+export interface MCPResourceContent {
+    /** Resource URI */
+    uri: string;
+    /** MIME type */
+    mimeType: string;
+    /** Text content */
+    text?: string | undefined;
+    /** Binary content (base64) */
+    blob?: string | undefined;
+}
+/**
+ * Resource handler function
+ */
+export type ResourceHandler = (uri: string, params?: Record<string, string>) => Promise<MCPResourceContent>;
+/**
+ * MCP Prompt argument definition
+ */
+export interface MCPPromptArgument {
+    /** Argument name */
+    name: string;
+    /** Description */
+    description?: string | undefined;
+    /** Whether required */
+    required?: boolean | undefined;
+}
+/**
+ * MCP Prompt definition
+ */
+export interface MCPPrompt {
+    /** Prompt name */
+    name: string;
+    /** Description */
+    description?: string | undefined;
+    /** Arguments */
+    arguments?: MCPPromptArgument[] | undefined;
+}
+/**
+ * MCP Prompt message
+ */
+export interface MCPPromptMessage {
+    /** Role */
+    role: 'user' | 'assistant';
+    /** Content */
+    content: {
+        type: 'text';
+        text: string;
+    };
+}
+/**
+ * Prompt handler function
+ */
+export type PromptHandler = (args: Record<string, string>) => Promise<{
+    description?: string;
+    messages: MCPPromptMessage[];
+}>;
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * Standard MCP error codes
+ */
+export const MCPErrorCodes = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqHA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,WAAW,EAAE,CAAC,KAAK;IACnB,eAAe,EAAE,CAAC,KAAK;IACvB,gBAAgB,EAAE,CAAC,KAAK;IACxB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;CACd,CAAC"}

package/dist/utils/artifact-store.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Artifact Store Utility
+ *
+ * Stores large MCP results externally so they don't pollute conversation context.
+ * Uses the memory domain with a dedicated 'artifacts' namespace.
+ *
+ * Invariants:
+ * - INV-MCP-RESP-005: Large results stored as artifacts with artifactRef
+ */
+/**
+ * Store an artifact and return its reference URI
+ *
+ * @param key - Artifact key (e.g., "bugfix:scan:12345")
+ * @param data - Data to store
+ * @returns Artifact reference URI (e.g., "ax://bugfix/scan:12345")
+ */
+export declare function storeArtifact(key: string, data: unknown): Promise<string>;
+/**
+ * Retrieve an artifact by its reference URI
+ *
+ * @param ref - Artifact reference URI (e.g., "ax://bugfix/scan:12345")
+ * @returns The stored data, or undefined if not found
+ */
+export declare function retrieveArtifact(ref: string): Promise<unknown | undefined>;
+/**
+ * Check if an artifact exists
+ */
+export declare function hasArtifact(ref: string): Promise<boolean>;
+/**
+ * Delete an artifact
+ */
+export declare function deleteArtifact(ref: string): Promise<boolean>;
+/**
+ * List artifacts by domain
+ */
+export declare function listArtifacts(domain: string): Promise<string[]>;
+/**
+ * Clear all artifacts (for testing)
+ */
+export declare function clearArtifacts(): void;
+/**
+ * Get artifact cache size (for monitoring)
+ */
+export declare function getArtifactCacheSize(): number;
+/**
+ * Get total artifact cache memory estimate (rough)
+ */
+export declare function getArtifactCacheMemory(): number;
+//# sourceMappingURL=artifact-store.d.ts.map

package/dist/utils/artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.d.ts","sourceRoot":"","sources":["../../src/utils/artifact-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAYhF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYrE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAM/C"}

package/dist/utils/artifact-store.js

@@ -0,0 +1,102 @@
+/**
+ * Artifact Store Utility
+ *
+ * Stores large MCP results externally so they don't pollute conversation context.
+ * Uses the memory domain with a dedicated 'artifacts' namespace.
+ *
+ * Invariants:
+ * - INV-MCP-RESP-005: Large results stored as artifacts with artifactRef
+ */
+// In-memory artifact store for when memory domain is not available
+const artifactCache = new Map();
+/**
+ * Store an artifact and return its reference URI
+ *
+ * @param key - Artifact key (e.g., "bugfix:scan:12345")
+ * @param data - Data to store
+ * @returns Artifact reference URI (e.g., "ax://bugfix/scan:12345")
+ */
+export async function storeArtifact(key, data) {
+    // Store in memory cache
+    artifactCache.set(key, data);
+    // Generate reference URI
+    const [domain, ...rest] = key.split(':');
+    const id = rest.join(':') || key;
+    return `ax://${domain}/${id}`;
+}
+/**
+ * Retrieve an artifact by its reference URI
+ *
+ * @param ref - Artifact reference URI (e.g., "ax://bugfix/scan:12345")
+ * @returns The stored data, or undefined if not found
+ */
+export async function retrieveArtifact(ref) {
+    // Parse reference URI
+    const match = /^ax:\/\/([^/]+)\/(.+)$/.exec(ref);
+    if (!match) {
+        throw new Error(`Invalid artifact reference: ${ref}`);
+    }
+    const [, domain, id] = match;
+    const key = `${domain}:${id}`;
+    // Retrieve from memory cache
+    return artifactCache.get(key);
+}
+/**
+ * Check if an artifact exists
+ */
+export async function hasArtifact(ref) {
+    const match = /^ax:\/\/([^/]+)\/(.+)$/.exec(ref);
+    if (!match)
+        return false;
+    const [, domain, id] = match;
+    const key = `${domain}:${id}`;
+    return artifactCache.has(key);
+}
+/**
+ * Delete an artifact
+ */
+export async function deleteArtifact(ref) {
+    const match = /^ax:\/\/([^/]+)\/(.+)$/.exec(ref);
+    if (!match)
+        return false;
+    const [, domain, id] = match;
+    const key = `${domain}:${id}`;
+    return artifactCache.delete(key);
+}
+/**
+ * List artifacts by domain
+ */
+export async function listArtifacts(domain) {
+    const prefix = `${domain}:`;
+    const refs = [];
+    for (const key of artifactCache.keys()) {
+        if (key.startsWith(prefix)) {
+            const id = key.slice(prefix.length);
+            refs.push(`ax://${domain}/${id}`);
+        }
+    }
+    return refs;
+}
+/**
+ * Clear all artifacts (for testing)
+ */
+export function clearArtifacts() {
+    artifactCache.clear();
+}
+/**
+ * Get artifact cache size (for monitoring)
+ */
+export function getArtifactCacheSize() {
+    return artifactCache.size;
+}
+/**
+ * Get total artifact cache memory estimate (rough)
+ */
+export function getArtifactCacheMemory() {
+    let total = 0;
+    for (const value of artifactCache.values()) {
+        total += JSON.stringify(value).length;
+    }
+    return total;
+}
+//# sourceMappingURL=artifact-store.js.map

package/dist/utils/artifact-store.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP Server Utilities
+ */
+export { wrapResponse, successResponse, errorResponse, createListResponse, createScanResponse, createCountSummary, createListSummary, type ResponseLimits, type MCPResponseContract, type WrapResponseOptions, type ListResponseOptions, type ScanResultItem, type ScanResponseOptions, type ArtifactStoreFn, DEFAULT_LIMITS, } from './response.js';
+export { storeArtifact, retrieveArtifact, hasArtifact, deleteArtifact, listArtifacts, clearArtifacts, getArtifactCacheSize, getArtifactCacheMemory, } from './artifact-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EAEjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAEpB,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,10 @@
+/**
+ * MCP Server Utilities
+ */
+export { 
+// Response wrapper
+wrapResponse, successResponse, errorResponse, createListResponse, createScanResponse, createCountSummary, createListSummary, 
+// Constants
+DEFAULT_LIMITS, } from './response.js';
+export { storeArtifact, retrieveArtifact, hasArtifact, deleteArtifact, listArtifacts, clearArtifacts, getArtifactCacheSize, getArtifactCacheMemory, } from './artifact-store.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO;AACL,mBAAmB;AACnB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB;AASjB,YAAY;AACZ,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}