initial spec for pipe input

As discussed in #942, input/pipe needs specs to evolve. Here is a proposal of an initial version