@defai.digital/mcp-server 13.0.3

package/dist/tools/trace.js

@@ -0,0 +1,191 @@
+import { createListResponse, successResponse, } from '../utils/response.js';
+import { storeArtifact } from '../utils/artifact-store.js';
+import { LIMIT_TRACES } from '@defai.digital/contracts';
+/**
+ * Trace list tool definition
+ */
+export const traceListTool = {
+    name: 'trace_list',
+    description: 'List recent execution traces',
+    idempotent: true,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            limit: {
+                type: 'number',
+                description: 'Maximum number of traces to return',
+                default: LIMIT_TRACES,
+            },
+            status: {
+                type: 'string',
+                description: 'Filter by status',
+                enum: ['success', 'failure', 'running'],
+            },
+        },
+    },
+};
+/**
+ * Trace get tool definition
+ */
+export const traceGetTool = {
+    name: 'trace_get',
+    description: 'Get detailed information about a specific trace',
+    idempotent: true,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            traceId: {
+                type: 'string',
+                description: 'The ID of the trace to retrieve',
+            },
+        },
+        required: ['traceId'],
+    },
+};
+/**
+ * Trace analyze tool definition
+ */
+export const traceAnalyzeTool = {
+    name: 'trace_analyze',
+    description: 'Analyze a trace for performance issues or errors',
+    idempotent: true,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            traceId: {
+                type: 'string',
+                description: 'The ID of the trace to analyze',
+            },
+        },
+        required: ['traceId'],
+    },
+};
+/**
+ * Handler for trace_list tool
+ * INV-MCP-RESP-002: Arrays limited to 10 items with pagination
+ */
+export const handleTraceList = (args) => {
+    const status = args.status;
+    // Sample traces
+    const traces = [
+        {
+            id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+            label: 'data-pipeline',
+            status: 'success',
+            durationMs: 5000,
+        },
+        {
+            id: 'b2c3d4e5-f6a7-8901-bcde-f12345678901',
+            label: 'code-review',
+            status: 'success',
+            durationMs: 5000,
+        },
+        {
+            id: 'c3d4e5f6-a7b8-9012-cdef-123456789012',
+            label: 'deploy-staging',
+            status: 'failure',
+            durationMs: 2000,
+        },
+    ];
+    const filtered = status !== undefined
+        ? traces.filter((t) => t.status === status)
+        : traces;
+    // Use createListResponse for automatic pagination (max 10 items)
+    return Promise.resolve(createListResponse(filtered, {
+        domain: 'traces',
+        idField: 'id',
+        labelField: 'label',
+        limit: 10,
+    }));
+};
+/**
+ * Handler for trace_get tool
+ * INV-MCP-RESP-001: Response < 10KB with summary, events stored as artifact
+ */
+export const handleTraceGet = async (args) => {
+    const traceId = args.traceId;
+    const now = new Date();
+    // Sample trace detail - full events stored as artifact
+    const fullEvents = [
+        {
+            eventId: crypto.randomUUID(),
+            type: 'run.start',
+            sequence: 0,
+            timestamp: new Date(now.getTime() - 60000).toISOString(),
+            payload: { workflowId: 'data-pipeline' },
+        },
+        {
+            eventId: crypto.randomUUID(),
+            type: 'decision.routing',
+            sequence: 1,
+            timestamp: new Date(now.getTime() - 59500).toISOString(),
+            payload: {
+                selectedModel: 'claude-3-5-sonnet-20241022',
+                provider: 'anthropic',
+            },
+        },
+        {
+            eventId: crypto.randomUUID(),
+            type: 'step.execute',
+            sequence: 2,
+            timestamp: new Date(now.getTime() - 59000).toISOString(),
+            payload: { stepId: 'step-1', stepName: 'Initialize' },
+            status: 'success',
+            durationMs: 500,
+        },
+        {
+            eventId: crypto.randomUUID(),
+            type: 'step.execute',
+            sequence: 3,
+            timestamp: new Date(now.getTime() - 57000).toISOString(),
+            payload: { stepId: 'step-2', stepName: 'Process' },
+            status: 'success',
+            durationMs: 2000,
+        },
+        {
+            eventId: crypto.randomUUID(),
+            type: 'run.end',
+            sequence: 4,
+            timestamp: new Date(now.getTime() - 55000).toISOString(),
+            payload: { success: true },
+            status: 'success',
+        },
+    ];
+    // Store full events as artifact
+    const artifactRef = await storeArtifact(`trace:${traceId}`, { events: fullEvents });
+    // Return summary with only first/last events
+    return successResponse(`Trace ${traceId}: success (5000ms, ${fullEvents.length} events)`, {
+        traceId,
+        workflowId: 'data-pipeline',
+        status: 'success',
+        durationMs: 5000,
+        eventCount: fullEvents.length,
+        // Only include first and last events in response
+        firstEvent: { type: fullEvents[0]?.type, timestamp: fullEvents[0]?.timestamp },
+        lastEvent: { type: fullEvents[fullEvents.length - 1]?.type, status: 'success' },
+        artifactRef,
+        hasMore: true,
+    });
+};
+/**
+ * Handler for trace_analyze tool
+ * INV-MCP-RESP-006: Response includes summary field with key metrics only
+ */
+export const handleTraceAnalyze = (args) => {
+    const traceId = args.traceId;
+    // Return optimized analysis with summary and key metrics
+    return Promise.resolve(successResponse('Trace OK: 5000ms, 3 steps, no issues', {
+        traceId,
+        status: 'success',
+        performance: {
+            totalDuration: 5000,
+            stepCount: 3,
+            slowestStep: 'Process (2000ms)',
+        },
+        issueCount: 0,
+        recommendationCount: 1,
+        // Only include top recommendation
+        topRecommendation: 'Consider caching step-2 results',
+    }));
+};
+//# sourceMappingURL=trace.js.map

package/dist/tools/trace.js.map

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

package/dist/tools/workflow.d.ts

@@ -0,0 +1,26 @@
+import type { MCPTool, ToolHandler } from '../types.js';
+/**
+ * Workflow run tool definition
+ */
+export declare const workflowRunTool: MCPTool;
+/**
+ * Workflow list tool definition
+ */
+export declare const workflowListTool: MCPTool;
+/**
+ * Workflow describe tool definition
+ */
+export declare const workflowDescribeTool: MCPTool;
+/**
+ * Handler for workflow_run tool
+ */
+export declare const handleWorkflowRun: ToolHandler;
+/**
+ * Handler for workflow_list tool
+ */
+export declare const handleWorkflowList: ToolHandler;
+/**
+ * Handler for workflow_describe tool
+ */
+export declare const handleWorkflowDescribe: ToolHandler;
+//# sourceMappingURL=workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/tools/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AA4CvE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,OAiB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAkB9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAalC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAqE/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAiDhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAyDpC,CAAC"}

package/dist/tools/workflow.js

@@ -0,0 +1,269 @@
+import { createWorkflowRunner, createWorkflowLoader, findWorkflowDir, defaultStepExecutor, } from '@defai.digital/workflow-engine';
+import { LIMIT_WORKFLOWS } from '@defai.digital/contracts';
+import { getStepExecutor } from '../bootstrap.js';
+// Check if we're in test environment
+const isTestEnv = process.env.VITEST === 'true' || process.env.NODE_ENV === 'test';
+// ============================================================================
+// Workflow Loader Singleton
+// ============================================================================
+let _workflowLoader = null;
+function getWorkflowLoader() {
+    if (_workflowLoader === null) {
+        const workflowDir = findWorkflowDir(process.cwd()) ?? 'examples/workflows';
+        _workflowLoader = createWorkflowLoader({ workflowsDir: workflowDir });
+    }
+    return _workflowLoader;
+}
+/**
+ * Get the appropriate step executor based on environment
+ * Uses placeholder in tests, production executor otherwise
+ */
+function getWorkflowStepExecutor() {
+    if (isTestEnv) {
+        return defaultStepExecutor;
+    }
+    return getStepExecutor();
+}
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+/**
+ * Workflow run tool definition
+ */
+export const workflowRunTool = {
+    name: 'workflow_run',
+    description: 'Execute a workflow by ID with optional input parameters',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            workflowId: {
+                type: 'string',
+                description: 'The ID of the workflow to execute',
+            },
+            input: {
+                type: 'object',
+                description: 'Optional input parameters for the workflow',
+            },
+        },
+        required: ['workflowId'],
+    },
+};
+/**
+ * Workflow list tool definition
+ */
+export const workflowListTool = {
+    name: 'workflow_list',
+    description: 'List all available workflows',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            status: {
+                type: 'string',
+                description: 'Filter by status (active, inactive, draft)',
+                enum: ['active', 'inactive', 'draft'],
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of workflows to return',
+                default: LIMIT_WORKFLOWS,
+            },
+        },
+    },
+};
+/**
+ * Workflow describe tool definition
+ */
+export const workflowDescribeTool = {
+    name: 'workflow_describe',
+    description: 'Get detailed information about a specific workflow',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            workflowId: {
+                type: 'string',
+                description: 'The ID of the workflow to describe',
+            },
+        },
+        required: ['workflowId'],
+    },
+};
+// ============================================================================
+// Tool Handlers
+// ============================================================================
+/**
+ * Handler for workflow_run tool
+ */
+export const handleWorkflowRun = async (args) => {
+    const workflowId = args.workflowId;
+    const input = args.input ?? {};
+    try {
+        // Load workflow from file
+        const loader = getWorkflowLoader();
+        const workflow = await loader.load(workflowId);
+        if (!workflow) {
+            const available = await loader.loadAll();
+            const ids = available.map(w => w.workflowId).slice(0, 5).join(', ');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Workflow "${workflowId}" not found`,
+                            availableWorkflows: ids,
+                            hint: 'Use workflow_list to see all available workflows',
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Create workflow runner with production step executor
+        // Uses placeholder executor in test environment to avoid real LLM calls
+        const runner = createWorkflowRunner({
+            stepExecutor: getWorkflowStepExecutor(),
+        });
+        // Execute workflow
+        const result = await runner.run(workflow, input);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: result.success,
+                        workflowId: workflow.workflowId,
+                        name: workflow.name,
+                        version: workflow.version,
+                        stepsCompleted: result.stepResults.map((s) => ({
+                            stepId: s.stepId,
+                            success: s.success,
+                            durationMs: s.durationMs,
+                        })),
+                        output: result.output,
+                        totalDurationMs: result.totalDurationMs,
+                        error: result.error,
+                    }, null, 2),
+                },
+            ],
+            isError: !result.success,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error executing workflow: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+/**
+ * Handler for workflow_list tool
+ */
+export const handleWorkflowList = async (args) => {
+    const status = args.status;
+    const limit = args.limit ?? LIMIT_WORKFLOWS;
+    try {
+        const loader = getWorkflowLoader();
+        const allWorkflows = await loader.listAll();
+        // Filter by status if specified
+        const filtered = status !== undefined
+            ? allWorkflows.filter((w) => w.status === status)
+            : allWorkflows;
+        // Apply limit
+        const limited = filtered.slice(0, limit);
+        // Format for output
+        const workflows = limited.map((w) => ({
+            id: w.id,
+            name: w.name,
+            version: w.version,
+            description: w.description,
+            stepCount: w.stepCount,
+            status: w.status,
+        }));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        count: workflows.length,
+                        total: allWorkflows.length,
+                        workflows,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error listing workflows: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+/**
+ * Handler for workflow_describe tool
+ */
+export const handleWorkflowDescribe = async (args) => {
+    const workflowId = args.workflowId;
+    try {
+        const loader = getWorkflowLoader();
+        const workflow = await loader.load(workflowId);
+        if (!workflow) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Workflow "${workflowId}" not found`,
+                            hint: 'Use workflow_list to see all available workflows',
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Format workflow for output
+        const description = {
+            workflowId: workflow.workflowId,
+            name: workflow.name,
+            version: workflow.version,
+            description: workflow.description,
+            steps: workflow.steps.map((step) => ({
+                stepId: step.stepId,
+                name: step.name,
+                type: step.type,
+                timeout: step.timeout,
+                config: step.config,
+            })),
+            metadata: workflow.metadata,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(description, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error describing workflow: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+//# sourceMappingURL=workflow.js.map

package/dist/tools/workflow.js.map

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

package/dist/trace-wrapper.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 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 type { ToolHandler } from './types.js';
+import { type ToolTraceEvent } from '@defai.digital/contracts';
+/**
+ * Collects trace events for analysis and persistence
+ */
+export interface TraceCollector {
+    /**
+     * Records a tool trace event
+     */
+    record(event: ToolTraceEvent): void;
+    /**
+     * Gets all recorded events
+     */
+    getEvents(): ToolTraceEvent[];
+    /**
+     * Clears recorded events
+     */
+    clear(): void;
+}
+/**
+ * In-memory trace collector implementation
+ */
+export declare class InMemoryTraceCollector implements TraceCollector {
+    private events;
+    private readonly maxEvents;
+    constructor(maxEvents?: number);
+    record(event: ToolTraceEvent): void;
+    getEvents(): ToolTraceEvent[];
+    clear(): void;
+    /**
+     * Gets summary statistics
+     */
+    getSummary(): {
+        totalInvocations: number;
+        successCount: number;
+        failureCount: number;
+        avgDurationMs: number;
+        byTool: Record<string, number>;
+    };
+}
+/**
+ * Sets the global trace collector
+ */
+export declare function setTraceCollector(collector: TraceCollector): void;
+/**
+ * Gets the global trace collector
+ */
+export declare function getTraceCollector(): TraceCollector | undefined;
+/**
+ * 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 declare function withTracing(toolName: string, handler: ToolHandler, collector?: TraceCollector): ToolHandler;
+/**
+ * Wraps all handlers in a registry with tracing
+ */
+export declare function wrapHandlersWithTracing(handlers: Record<string, ToolHandler>, collector?: TraceCollector): Record<string, ToolHandler>;
+/**
+ * Initializes default trace collector if not already set
+ * Returns the collector, which may be InMemoryTraceCollector or a custom implementation
+ */
+export declare function initializeDefaultTracing(): TraceCollector;
+/**
+ * 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 declare function getInMemoryTraceCollector(): InMemoryTraceCollector | undefined;
+//# sourceMappingURL=trace-wrapper.d.ts.map

package/dist/trace-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-wrapper.d.ts","sourceRoot":"","sources":["../src/trace-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAMrF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,SAAS,IAAI,cAAc,EAAE,CAAC;IAE9B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,SAAO;IAI5B,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAQnC,SAAS,IAAI,cAAc,EAAE;IAI7B,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,UAAU,IAAI;QACZ,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC;CAqBF;AAWD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,cAAc,GACzB,WAAW,CAiDb;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACrC,SAAS,CAAC,EAAE,cAAc,GACzB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAQ7B;AAMD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,CAKzD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,sBAAsB,GAAG,SAAS,CAK9E"}