Interface: ScriptRow

Defined in: src/core/agent/scripts/types.ts:45

One call of a declared code-running tool (Tool.script), on the findings ledger — F1 (the program submitted) and F2 (what its execution record proves), and nothing about any value.

Filed by the dispatch loop (stages/toolCalls.ts) while .namesAndNumbersFromEvidence({ code: 'match' }) or .scriptTravelsWithTheAnswer() is on, through ONE writer (rows.ts · recordScriptRow): the call's row is KEPT CURRENT — its outcome is written when the call settles, and a row that never settles stays submitted. At the next turn boundary (seed) the row keeps its facts and loses its text.

Properties

argument

readonly argument: string

Defined in: src/core/agent/scripts/types.ts:59

The declared argument that carried the program.

---

bytes

readonly bytes: number

Defined in: src/core/agent/scripts/types.ts:63

UTF-8 bytes of the program submitted to the tool.

---

dispatch

readonly dispatch: number

Defined in: src/core/agent/scripts/types.ts:55

The library's identity for the call: the 1-based order of the actual dispatch within its turn (rows.ts · recordScriptRow). A pause and its settlement share it; a later call that reuses the provider id is a new dispatch. Rows are counted, read and matched by it.

---

exitCode?

readonly optional exitCode?: number

Defined in: src/core/agent/scripts/types.ts:73

Exactly the runner's exit code, only when it supplied one.

---

iteration

readonly iteration: number

Defined in: src/core/agent/scripts/types.ts:82

---

kind

readonly kind: "script"

Defined in: src/core/agent/scripts/types.ts:46

---

language?

readonly optional language?: string

Defined in: src/core/agent/scripts/types.ts:61

The declared language, when the tool declared one.

---

lines

readonly lines: number

Defined in: src/core/agent/scripts/types.ts:65

Lines of that program (LF-separated; 0 for an empty program).

---

outcome

readonly outcome: ScriptLabel

Defined in: src/core/agent/scripts/types.ts:71

---

resultWithheld?

readonly optional resultWithheld?: "over-ceiling"

Defined in: src/core/agent/scripts/types.ts:77

The tool's own resultCeiling replaced the delivered result.

---

rewritten?

readonly optional rewritten?: true

Defined in: src/core/agent/scripts/types.ts:79

A before-tool rule changed the program before dispatch; the earlier text is on no row.

---

serviceError?

readonly optional serviceError?: true

Defined in: src/core/agent/scripts/types.ts:75

The runner's failure verdict was the service's, with no exit code.

---

text?

readonly optional text?: string

Defined in: src/core/agent/scripts/types.ts:70

The program submitted to the tool, byte for byte. ABSENT over MAX_SCRIPT_BYTES, and after the row's turn ended.

---

tool

readonly tool: string

Defined in: src/core/agent/scripts/types.ts:57

The name the model called.

---

toolCallId

readonly toolCallId: string

Defined in: src/core/agent/scripts/types.ts:48

The provider's id for the call — display only; two calls may share one.

---

turn

readonly turn: number

Defined in: src/core/agent/scripts/types.ts:81

AgentState.turnNumber when the call was made.