// head — first `lines` lines of `text`
//
// Fewer lines than requested returns the whole text. `lines <= 0`
// returns "". Returns a subslice of `text` — no allocation, no copy.
~pub tor head { text: string, lines: i64 } -> string

// tail — last `lines` lines of `text`
//
// Errors live at the end of tool output; this is the single most-used
// op in the profiles grammar. A trailing newline does not mint a
// phantom empty line. Subslice return, no allocation.
~pub tor tail { text: string, lines: i64 } -> string

// below — everything after the line containing `marker`
//
// The "failing tests:" cut from the profiles grammar: keep what is
// below the marker line, drop the header above it. Marker absent →
// the text unchanged (nothing to cut is an honest answer, not an
// error). Marker on the last line → "".
~pub tor below { text: string, marker: string } -> string

// dedup — first occurrence wins, order preserved
//
// Progress-bar spam and repeated noise lines collapse to one line
// each. The one allocating op in v0: the output buffer lives on
// page_allocator and is handed back — the produced program's own
// accounting owns the lifetime (same convention as pcre2's error
// messages and odds' transport bodies).
~pub tor dedup { text: string } -> string

// remove.lines / extract.lines — the grammar's line filters
//
// Caller hands a BARE pattern; winnow owns wrapping, compiling, and
// freeing the regex. The result is an owned `*String<view!>` the
// caller must `std/string:free`.
~pub tor extract.lines { pattern: string, text: string }
| ok std/string:*String<view!>
| err string

~pub tor remove.lines { pattern: string, text: string }
| ok std/string:*String<view!>
| err string

// grep — does `text` contain a match of `pattern` at all?
~pub tor grep { pattern: string, text: string }
| yes
| no
| err string