import { workflowUnknownInput } from "../../application/investigation/WorkflowUnknown.js"; import type { EvidenceMcpServer } from "../EvidenceMcpServer.js"; import { runAdmittedToolOperation } from "../admittedToolOperation.js"; import { recordEvidenceSources } from "../../application/investigation/recordEvidenceSources.js"; import { executeManagedNativeBoundaries } from "../../application/managed/ManagedNativeVerificationService.js"; import { logToolExecution } from "../toolLogging.js"; import { toolRegistrationOptions } from "../toolRegistrationOptions.js"; import { toolContract } from "../../contracts/toolContracts.js"; import type { ManagedWorkflowToolRegistration } from "./types.js"; const nativeVerificationContract = toolContract( "verify_managed_native_boundaries", ); /** Register the managed/native boundary verification workflow tool. */ export const registerVerifyManagedNativeBoundaries = ( server: EvidenceMcpServer, options: ManagedWorkflowToolRegistration, ): void => { server.registerTool( nativeVerificationContract.name, toolRegistrationOptions(nativeVerificationContract), async (input, context) => runAdmittedToolOperation( server, options.withAdmittedAnalysis, nativeVerificationContract.name, context.mcpReq.signal, async () => { const result = await logToolExecution( options.logger, nativeVerificationContract.name, () => Promise.resolve( executeManagedNativeBoundaries( input, options.session.evidenceForAnalysis.bind(options.session), { signal: context.mcpReq.signal }, ), ), ); if (!result.ok) return server.delivery.toCallToolResult( result, nativeVerificationContract, ); const execution = result.value; const recordedSources = recordEvidenceSources( options.recordEvidence, execution.sourceEvidence, { evidence: execution.evidence }, ); if (!recordedSources.ok) return server.delivery.toCallToolResult( recordedSources, nativeVerificationContract, ); const unknownInput = execution.hasUnknowns ? workflowUnknownInput(execution.evidence.evidence_id, { question: "Which managed/native boundaries remain unresolved or contradicted by the supplied native Evidence?", severity: "medium", domain: "managed-native-verification", required_authority: "shipped-artifact", required_confidence: "observed", required_environment: null, recommended_probes: [ { operation: "inspect_managed_native_boundaries", rationale: "Review the inspection Evidence coverage and limit diagnostics; this operation has no page override, so unresolved declarations must remain unknown.", }, { operation: "analyze_function", rationale: "Analyze the provider-resolved native function candidate for the declared export.", }, ], relationships: [], }) : undefined; const output = unknownInput === undefined ? options.recordEvidence?.(execution.evidence) : unknownInput.ok ? options.recordEvidenceWithUnknown?.( execution.evidence, unknownInput.value, ) : unknownInput; return server.delivery.toEvidenceToolResult( execution.evidence, nativeVerificationContract, output, ); }, ), ); };