@sema-agent/core/dist/tools/fs/shell-read-face.d.ts

Stateless, task-oriented AI agent core

/**
 * The words a shell-read finding is said in, by the FACE it is about — the ONE choice of verb the read station's account
 * (what the approval card discloses and the refusal states) and the gate's approval card sentence both take, so one finding
 * is never "writes" on one surface and "reads" on the other. A finding whose witness is a write target
 * (`ShellReadVerdict.face === "write"`) is said as a write; every other finding — a read's, the text's own structure —
 * as a read. A leaf: the station and the gate both import it, and it imports nothing.
 */
export interface ShellReadFaceWords {
    /** The claim's verb: `this command writes …`, `tool "Bash" reads …`. */
    readonly verb: "writes" | "reads";
    /** Its object's participle: `… could not establish what is written / read`. */
    readonly participle: "written" | "read";
}
/** The words of a finding on `face` (absent ⇒ a read's). */
export declare function shellReadFaceWords(face: "write" | undefined): ShellReadFaceWords;