Skip to main content

Module cell_hints

Module cell_hints 

Source
Expand description

Situational hints (ultron/rlm/hints.ts CellHints, ultron/rlm/loop-detector.ts): the host watches how a lane uses the runtime and ends a cell’s result with at most one short tagged line, [hint:<tag>] ..., when something worth knowing happened in that cell: a command detached into a job, a long wait on a job whose completion would have arrived as an event, polling, truncated output, a large file read into a string, the same exception three cells in a row, the same cell run again and again, or a lane stuck in a loop of failing or alternating cells. Mutes and per-tag counts are HintsModule’s (hints.mute). Hints are off unless ULTRON_HINTS=on.

Structs§

CellHints
CellHintsOptions
CellOutcome
How a cell ended, as the rlm tool reports it.
LoopDetector
ToolLoopDetector.
LoopLimits
Thresholds of the stuck-loop detector (LoopLimits).
LoopTrip

Constants§

DEFAULT_BLOCKED_SECONDS
DEFAULT_HINT_MAX_PER_TAG
DEFAULT_READ_HANDLE_BYTES
HINTS_ENV
HINTS_MAX_ENV

Functions§

alternation_length
Length of the A, B, A, B run (A differs from B) that ends the history; 0 when there is none.
bash_failed
Whether a finished bash command failed: a timeout, or a non-zero exit (1 is an answer for a query command).
hint_max_per_tag
hintMaxPerTag: ULTRON_HINTS_MAX, a non-negative integer, else 3.
hints_enabled
Hints are off unless ULTRON_HINTS is on (or 1, true, yes).
loop_hint_text
The stuck-loop hint text for a trip.
normalize_cell
Code with whitespace and digits removed, so cells differing only in those compare equal.
read_handle_bytes
readHandleBytes: ULTRON_READ_HANDLE_BYTES, a positive integer, else 256 KiB.

Type Aliases§

LaneWoken
Whether the host wakes a lane when its work ends (its event wording says “end your turn”).