proofscan 0.10.22 → 0.10.23

package/dist/plans/runner.js

@@ -0,0 +1,360 @@
+/**
+ * Plan runner - executes validation plans against MCP servers
+ * Phase 5.2: MCP validation scenario execution
+ * Phase 5.3: Unified session recording (events.db + proofs.db)
+ */
+import { ulid } from 'ulid';
+import { StdioConnection } from '../transports/stdio.js';
+import { PlansStore } from './store.js';
+import { EventsStore } from '../db/events-store.js';
+import { writeAllArtifacts } from './artifacts.js';
+export class PlanRunner {
+    configDir;
+    store;
+    eventsStore;
+    constructor(configDir) {
+        this.configDir = configDir;
+        this.store = new PlansStore(configDir);
+        this.eventsStore = new EventsStore(configDir);
+    }
+    /**
+     * Run a plan against a connector
+     * Records session in both proofs.db (runs table) and events.db (sessions/events)
+     */
+    async run(plan, connector, options = {}) {
+        const timeout = (options.timeout || 30) * 1000;
+        const dryRun = options.dryRun || false;
+        const runId = ulid();
+        const startedAt = new Date().toISOString();
+        // Parse plan definition
+        const def = JSON.parse(JSON.stringify(await import('yaml').then(yaml => yaml.parse(plan.content_yaml))));
+        // Create run record in proofs.db (unless dry run)
+        if (!dryRun) {
+            this.store.createRun({
+                runId,
+                planName: plan.name,
+                planDigest: plan.digest_sha256,
+                connectorId: connector.id,
+                artifactPath: `artifacts/${runId}`,
+            });
+        }
+        // Create session in events.db (unless dry run)
+        const session = dryRun
+            ? { session_id: `dry-run-${Date.now()}` }
+            : this.eventsStore.createSession(connector.id);
+        const sessionId = session.session_id;
+        // Track RPC calls for events.db
+        const rpcIdMap = new Map();
+        const steps = [];
+        const inventory = {};
+        let finalStatus = 'completed';
+        // Check transport type
+        if (connector.transport.type !== 'stdio') {
+            const endedAt = new Date().toISOString();
+            if (!dryRun) {
+                this.eventsStore.saveEvent(sessionId, 'client_to_server', 'transport_event', {
+                    rawJson: JSON.stringify({ type: 'error', message: `Unsupported transport type: ${connector.transport.type}` }),
+                });
+                this.eventsStore.endSession(sessionId, 'error');
+            }
+            const errorResult = {
+                runId,
+                planName: plan.name,
+                planDigest: plan.digest_sha256,
+                connectorId: connector.id,
+                status: 'failed',
+                steps: [],
+                inventory,
+                startedAt,
+                endedAt,
+                sessionId: dryRun ? undefined : sessionId,
+            };
+            if (!dryRun) {
+                this.store.completeRun(runId, 'failed');
+                writeAllArtifacts(options.outDir || this.configDir, errorResult, def, plan.content_yaml, plan.content_normalized);
+            }
+            return errorResult;
+        }
+        const transport = connector.transport;
+        const connection = new StdioConnection(transport);
+        try {
+            // Log connection attempt
+            if (!dryRun) {
+                this.eventsStore.saveEvent(sessionId, 'client_to_server', 'transport_event', {
+                    rawJson: JSON.stringify({
+                        type: 'connect_attempt',
+                        command: transport.command,
+                        args: transport.args,
+                        plan: plan.name,
+                        runId,
+                    }),
+                });
+            }
+            // Set up message logging for events.db
+            connection.on('message', (msg, raw) => {
+                if (dryRun)
+                    return;
+                const isRequest = 'method' in msg && 'id' in msg && msg.id !== null;
+                const isNotification = 'method' in msg && !('id' in msg);
+                const isResponse = 'id' in msg && !('method' in msg);
+                const direction = isResponse ? 'server_to_client' :
+                    (isRequest || isNotification) && !('id' in msg && 'result' in msg) ? 'client_to_server' : 'server_to_client';
+                let kind;
+                if (isRequest)
+                    kind = 'request';
+                else if (isNotification)
+                    kind = 'notification';
+                else if (isResponse)
+                    kind = 'response';
+                else
+                    kind = 'transport_event';
+                let rpcId;
+                // Handle RPC tracking
+                if (isRequest && 'id' in msg && msg.id !== null && 'method' in msg) {
+                    const rpcCall = this.eventsStore.saveRpcCall(sessionId, String(msg.id), msg.method);
+                    rpcIdMap.set(msg.id, rpcCall.rpc_id);
+                    rpcId = rpcCall.rpc_id;
+                }
+                else if (isResponse && 'id' in msg && msg.id !== null) {
+                    rpcId = rpcIdMap.get(msg.id);
+                    if (rpcId) {
+                        const resp = msg;
+                        this.eventsStore.completeRpcCall(sessionId, String(msg.id), !resp.error, resp.error?.code);
+                    }
+                }
+                this.eventsStore.saveEvent(sessionId, direction, kind, {
+                    rpcId: rpcId || (('id' in msg && msg.id !== null) ? String(msg.id) : undefined),
+                    rawJson: raw,
+                });
+            });
+            connection.on('stderr', (data) => {
+                if (!dryRun) {
+                    this.eventsStore.saveEvent(sessionId, 'server_to_client', 'transport_event', {
+                        rawJson: JSON.stringify({ type: 'stderr', data: data.trim() }),
+                    });
+                }
+            });
+            connection.on('error', (error) => {
+                if (!dryRun) {
+                    this.eventsStore.saveEvent(sessionId, 'server_to_client', 'transport_event', {
+                        rawJson: JSON.stringify({ type: 'error', message: error.message }),
+                    });
+                }
+            });
+            // Connect to MCP server
+            await connection.connect();
+            if (!dryRun) {
+                this.eventsStore.saveEvent(sessionId, 'server_to_client', 'transport_event', {
+                    rawJson: JSON.stringify({ type: 'connected' }),
+                });
+            }
+            // Execute each step
+            for (let i = 0; i < def.steps.length; i++) {
+                const step = def.steps[i];
+                const stepResult = await this.executeStep(connection, step, i, inventory, timeout);
+                steps.push(stepResult);
+                // Update inventory based on response
+                if (!stepResult.skipped && stepResult.response?.result) {
+                    this.updateInventory(inventory, step.mcp, stepResult.response.result);
+                }
+                // Track failures
+                if (!stepResult.skipped && stepResult.response?.error) {
+                    if (finalStatus === 'completed') {
+                        finalStatus = 'partial';
+                    }
+                }
+            }
+            // Check if all non-skipped steps failed
+            const executed = steps.filter(s => !s.skipped);
+            const failed = executed.filter(s => s.response?.error);
+            if (executed.length > 0 && failed.length === executed.length) {
+                finalStatus = 'failed';
+            }
+        }
+        catch (err) {
+            // Fatal error during execution
+            finalStatus = 'failed';
+            const errorStep = {
+                stepIndex: steps.length,
+                method: 'execution_error',
+                skipped: false,
+                request: { method: 'execution_error', params: {} },
+                response: { error: { message: err instanceof Error ? err.message : String(err) } },
+                startedAt: new Date().toISOString(),
+                endedAt: new Date().toISOString(),
+                durationMs: 0,
+            };
+            steps.push(errorStep);
+            if (!dryRun) {
+                this.eventsStore.saveEvent(sessionId, 'client_to_server', 'transport_event', {
+                    rawJson: JSON.stringify({ type: 'execution_error', error: err instanceof Error ? err.message : String(err) }),
+                });
+            }
+        }
+        finally {
+            connection.close();
+        }
+        const endedAt = new Date().toISOString();
+        // End session in events.db
+        if (!dryRun) {
+            this.eventsStore.saveEvent(sessionId, 'client_to_server', 'transport_event', {
+                rawJson: JSON.stringify({ type: 'disconnected', plan: plan.name, runId, status: finalStatus }),
+            });
+            this.eventsStore.endSession(sessionId, finalStatus === 'failed' ? 'error' : 'normal');
+        }
+        const result = {
+            runId,
+            planName: plan.name,
+            planDigest: plan.digest_sha256,
+            connectorId: connector.id,
+            status: finalStatus,
+            steps,
+            inventory,
+            startedAt,
+            endedAt,
+            sessionId: dryRun ? undefined : sessionId,
+        };
+        // Complete run in proofs.db and write artifacts (unless dry run)
+        if (!dryRun) {
+            this.store.completeRun(runId, finalStatus);
+            writeAllArtifacts(options.outDir || this.configDir, result, def, plan.content_yaml, plan.content_normalized);
+        }
+        return result;
+    }
+    /**
+     * Execute a single plan step
+     */
+    async executeStep(connection, step, index, inventory, timeout) {
+        const startedAt = new Date().toISOString();
+        // Check when condition
+        if (step.when) {
+            const shouldExecute = this.evaluateWhenCondition(step.when, inventory);
+            if (!shouldExecute) {
+                const endedAt = new Date().toISOString();
+                return {
+                    stepIndex: index,
+                    method: step.mcp,
+                    skipped: true,
+                    skipReason: `Condition not met: ${step.when}`,
+                    request: { method: step.mcp, params: {} },
+                    startedAt,
+                    endedAt,
+                    durationMs: new Date(endedAt).getTime() - new Date(startedAt).getTime(),
+                };
+            }
+        }
+        // Build request params based on method
+        const params = this.buildRequestParams(step.mcp);
+        try {
+            const response = await connection.sendRequest(step.mcp, params, timeout);
+            const endedAt = new Date().toISOString();
+            return {
+                stepIndex: index,
+                method: step.mcp,
+                skipped: false,
+                request: { method: step.mcp, params },
+                response: {
+                    result: response.result,
+                    error: response.error,
+                },
+                startedAt,
+                endedAt,
+                durationMs: new Date(endedAt).getTime() - new Date(startedAt).getTime(),
+            };
+        }
+        catch (err) {
+            const endedAt = new Date().toISOString();
+            return {
+                stepIndex: index,
+                method: step.mcp,
+                skipped: false,
+                request: { method: step.mcp, params },
+                response: {
+                    error: {
+                        code: -1,
+                        message: err instanceof Error ? err.message : String(err),
+                    },
+                },
+                startedAt,
+                endedAt,
+                durationMs: new Date(endedAt).getTime() - new Date(startedAt).getTime(),
+            };
+        }
+    }
+    /**
+     * Build request params for MCP method
+     */
+    buildRequestParams(method) {
+        switch (method) {
+            case 'initialize':
+                return {
+                    protocolVersion: '2024-11-05',
+                    capabilities: {},
+                    clientInfo: {
+                        name: 'proofscan',
+                        version: '1.0.0',
+                    },
+                };
+            case 'tools/list':
+            case 'resources/list':
+            case 'prompts/list':
+                return {};
+            default:
+                return {};
+        }
+    }
+    /**
+     * Evaluate a when condition against current inventory
+     */
+    evaluateWhenCondition(condition, inventory) {
+        // Parse condition: capabilities.<field>
+        const match = condition.match(/^capabilities\.(\w+)$/);
+        if (!match) {
+            return false;
+        }
+        const field = match[1];
+        const capabilities = inventory.capabilities;
+        if (!capabilities) {
+            return false;
+        }
+        // Check if field exists and is truthy
+        const value = capabilities[field];
+        return value !== undefined && value !== null && value !== false;
+    }
+    /**
+     * Update inventory based on response
+     */
+    updateInventory(inventory, method, result) {
+        switch (method) {
+            case 'initialize': {
+                const initResult = result;
+                if (initResult.capabilities) {
+                    inventory.capabilities = initResult.capabilities;
+                }
+                break;
+            }
+            case 'tools/list': {
+                const toolsResult = result;
+                if (toolsResult.tools) {
+                    inventory.tools = toolsResult.tools;
+                }
+                break;
+            }
+            case 'resources/list': {
+                const resourcesResult = result;
+                if (resourcesResult.resources) {
+                    inventory.resources = resourcesResult.resources;
+                }
+                break;
+            }
+            case 'prompts/list': {
+                const promptsResult = result;
+                if (promptsResult.prompts) {
+                    inventory.prompts = promptsResult.prompts;
+                }
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/plans/runner.js.map

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

package/dist/plans/schema.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Plans schema definitions
+ * Phase 5.2: Validation plans for MCP servers
+ */
+/**
+ * Plan step definition - a single MCP method call
+ */
+export interface PlanStep {
+    /** MCP method to call: 'initialize' | 'tools/list' | 'resources/list' | 'prompts/list' */
+    mcp: string;
+    /** Conditional execution: 'capabilities.tools' | 'capabilities.resources' | 'capabilities.prompts' */
+    when?: string;
+}
+/**
+ * Plan definition as parsed from YAML
+ */
+export interface PlanDefinition {
+    /** Schema version (must be 1) */
+    version: 1;
+    /** Optional plan name (overridden by DB record name) */
+    name?: string;
+    /** Optional description */
+    description?: string;
+    /** Validation steps to execute */
+    steps: PlanStep[];
+}
+/**
+ * Plan record stored in database
+ */
+export interface Plan {
+    /** Unique plan name (identifier) */
+    name: string;
+    /** Schema version */
+    schema_version: number;
+    /** Original YAML content */
+    content_yaml: string;
+    /** Normalized YAML/JSON for digest calculation */
+    content_normalized: string;
+    /** SHA-256 digest of normalized content */
+    digest_sha256: string;
+    /** Optional description */
+    description: string | null;
+    /** Default connector ID */
+    default_connector: string | null;
+    /** Source of the plan: 'manual' | 'import' | 'builtin' */
+    source: 'manual' | 'import' | 'builtin';
+    /** Creation timestamp (ISO) */
+    created_at: string;
+    /** Last update timestamp (ISO) */
+    updated_at: string;
+}
+/**
+ * Run status
+ */
+export type RunStatus = 'running' | 'completed' | 'failed' | 'partial' | 'crashed';
+/**
+ * Run record stored in database
+ */
+export interface Run {
+    /** Unique run ID (ULID) */
+    run_id: string;
+    /** Plan name (may be null if plan was deleted) */
+    plan_name: string | null;
+    /** Plan digest at time of execution */
+    plan_digest: string;
+    /** Connector ID used for execution */
+    connector_id: string;
+    /** Run status */
+    status: RunStatus;
+    /** Relative path to artifacts directory */
+    artifact_path: string;
+    /** Start timestamp (ISO) */
+    started_at: string;
+    /** End timestamp (ISO) - null if still running */
+    ended_at: string | null;
+    /** Record creation timestamp (ISO) */
+    created_at: string;
+}
+/**
+ * Step result from plan execution
+ */
+export interface StepResult {
+    /** Step index (0-based) */
+    stepIndex: number;
+    /** MCP method called */
+    method: string;
+    /** Whether step was skipped due to when condition */
+    skipped: boolean;
+    /** Reason for skipping (if skipped) */
+    skipReason?: string;
+    /** Request sent */
+    request: {
+        method: string;
+        params: unknown;
+    };
+    /** Response received (if not skipped) */
+    response?: {
+        result?: unknown;
+        error?: unknown;
+    };
+    /** Start timestamp (ISO) */
+    startedAt: string;
+    /** End timestamp (ISO) */
+    endedAt: string;
+    /** Duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * Inventory collected during plan execution
+ */
+export interface RunInventory {
+    /** Capabilities from initialize response */
+    capabilities?: unknown;
+    /** Tools from tools/list response */
+    tools?: unknown[];
+    /** Resources from resources/list response */
+    resources?: unknown[];
+    /** Prompts from prompts/list response */
+    prompts?: unknown[];
+}
+/**
+ * Complete run result
+ */
+export interface RunResult {
+    /** Run ID */
+    runId: string;
+    /** Plan name */
+    planName: string;
+    /** Plan digest */
+    planDigest: string;
+    /** Connector ID */
+    connectorId: string;
+    /** Final status */
+    status: 'completed' | 'failed' | 'partial';
+    /** Step results */
+    steps: StepResult[];
+    /** Collected inventory */
+    inventory: RunInventory;
+    /** Start timestamp */
+    startedAt: string;
+    /** End timestamp */
+    endedAt: string;
+}
+/**
+ * Run metadata written to meta.json
+ */
+export interface RunMeta {
+    /** Run ID */
+    runId: string;
+    /** Plan name */
+    planName: string;
+    /** Plan digest at time of run */
+    planDigest: string;
+    /** Connector ID */
+    connectorId: string;
+    /** Run status */
+    status: RunStatus;
+    /** Start timestamp */
+    startedAt: string;
+    /** End timestamp */
+    endedAt?: string;
+    /** Total steps count */
+    totalSteps: number;
+    /** Passed steps count */
+    passedSteps: number;
+    /** Failed steps count */
+    failedSteps: number;
+    /** Skipped steps count */
+    skippedSteps: number;
+    /** Relative artifact path */
+    artifactPath: string;
+}
+/**
+ * Supported MCP methods in plans
+ */
+export declare const SUPPORTED_MCP_METHODS: readonly ["initialize", "tools/list", "resources/list", "prompts/list"];
+/**
+ * Supported when conditions
+ */
+export declare const SUPPORTED_WHEN_CONDITIONS: readonly ["capabilities.tools", "capabilities.resources", "capabilities.prompts"];
+/**
+ * Validate plan name format
+ */
+export declare function isValidPlanName(name: string): boolean;
+/**
+ * Validate plan definition
+ */
+export declare function validatePlanDefinition(def: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/plans/schema.d.ts.map

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

package/dist/plans/schema.js

@@ -0,0 +1,81 @@
+/**
+ * Plans schema definitions
+ * Phase 5.2: Validation plans for MCP servers
+ */
+/**
+ * Supported MCP methods in plans
+ */
+export const SUPPORTED_MCP_METHODS = [
+    'initialize',
+    'tools/list',
+    'resources/list',
+    'prompts/list',
+];
+/**
+ * Supported when conditions
+ */
+export const SUPPORTED_WHEN_CONDITIONS = [
+    'capabilities.tools',
+    'capabilities.resources',
+    'capabilities.prompts',
+];
+/**
+ * Validate plan name format
+ */
+export function isValidPlanName(name) {
+    return /^[a-z0-9_-]+$/.test(name);
+}
+/**
+ * Validate plan definition
+ */
+export function validatePlanDefinition(def) {
+    const errors = [];
+    if (!def || typeof def !== 'object') {
+        return { valid: false, errors: ['Plan must be an object'] };
+    }
+    const plan = def;
+    // Check version
+    if (plan.version !== 1) {
+        errors.push(`Invalid version: expected 1, got ${plan.version}`);
+    }
+    // Check steps
+    if (!Array.isArray(plan.steps)) {
+        errors.push('steps must be an array');
+        return { valid: false, errors };
+    }
+    if (plan.steps.length === 0) {
+        errors.push('steps array cannot be empty');
+    }
+    // Validate each step
+    for (let i = 0; i < plan.steps.length; i++) {
+        const step = plan.steps[i];
+        if (!step || typeof step !== 'object') {
+            errors.push(`Step ${i}: must be an object`);
+            continue;
+        }
+        if (typeof step.mcp !== 'string') {
+            errors.push(`Step ${i}: mcp must be a string`);
+            continue;
+        }
+        if (!SUPPORTED_MCP_METHODS.includes(step.mcp)) {
+            errors.push(`Step ${i}: unsupported mcp method '${step.mcp}'`);
+        }
+        if (step.when !== undefined) {
+            if (typeof step.when !== 'string') {
+                errors.push(`Step ${i}: when must be a string`);
+            }
+            else if (!SUPPORTED_WHEN_CONDITIONS.includes(step.when)) {
+                errors.push(`Step ${i}: unsupported when condition '${step.when}'`);
+            }
+        }
+    }
+    // Check that initialize is first step (if present)
+    if (plan.steps.length > 0) {
+        const firstStep = plan.steps[0];
+        if (firstStep.mcp !== 'initialize') {
+            errors.push('First step must be "initialize"');
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=schema.js.map

package/dist/plans/schema.js.map

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