import type { ServerContext } from "@modelcontextprotocol/server"; import { setImmediate } from "node:timers/promises"; import { AnalysisError } from "../domain/analysisErrorBase.js"; import { cancelledBy } from "../domain/analysisErrorCore.js"; import { err, ok } from "../domain/result.js"; import { mcpProgressReporter, type McpProgressContext } from "./mcpProgress.js"; import type { EvidenceWorkflowExecution } from "../application/investigation/EvidenceWorkflowExecution.js"; import { withEvidenceSources, type AnalysisResultWithSources, } from "../application/investigation/recordEvidenceSources.js"; export interface DerivedOperationContext extends McpProgressContext { readonly mcpReq: McpProgressContext["mcpReq"] & Pick; } /** Run synchronous derived work with transport yields and a publication guard. */ export const runDerivedOperation = async ( context: DerivedOperationContext, operation: string, compute: () => Value, retainCompleted?: (value: Value) => EvidenceWorkflowExecution, ): Promise> => { const progress = mcpProgressReporter(context); await progress.report({ phase: "prepare", completed: 0, total: 2, message: `Preparing ${operation}`, }); await setImmediate(); if (context.mcpReq.signal.aborted) return err(cancelledBy(operation, context.mcpReq.signal)); let value: Value; try { value = compute(); } catch (cause: unknown) { // Typed causes already name the failed constraint; keep their issues. if (cause instanceof AnalysisError) return err(cause); throw cause; } const cancelledCompletion = (): AnalysisResultWithSources => { const completed = retainCompleted?.(value); return withEvidenceSources( err( cancelledBy( operation, context.mcpReq.signal, completed === undefined ? {} : { partialObservation: completed.evidence }, ), ), completed?.sources ?? [], ); }; await progress.report({ phase: "compute", completed: 1, total: 2, message: `Computed ${operation}`, }); await setImmediate(); if (context.mcpReq.signal.aborted) return cancelledCompletion(); await progress.report({ phase: "complete", completed: 2, total: 2, message: `Completed ${operation}`, terminal: true, }); if (context.mcpReq.signal.aborted) return cancelledCompletion(); return ok(value); };