Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/rulvar / ChildResultPage

Interface: ChildResultPage

Defined in: packages/core/dist/index.d.ts

One page of a settled child's FULL output, returned by the opt-in get_child_result tool. The digest is a wake signal truncated to 400 characters; this is the whole evidence, paged so a large result can be read without overflowing the orchestrator's context in one call (v1.40.0 improvement plan, the narrow RV-201 slice). The content is a deterministic serialization of the child's output (the raw string when the output IS a string, else its JCS-independent JSON.stringify) for a settled ok child, or the child's errorMessage otherwise, so the orchestrator can read WHY a child failed as readily as what it produced; a limit child carrying a structured terminal partial serves { error, partial } instead (RV-210 close-out), so the collected work is pageable in full. Everything here is a pure read of already durable journal state, so a resume reproduces it with no new spend.

Properties

PropertyTypeDescriptionDefined in
artifacts{ id: string; kind: string; label?: string; }[]The child's artifacts, id and kind, so the model knows what read_child_artifact can fetch.packages/core/dist/index.d.ts
contentstringThe page: content.length is at most the requested (clamped) maxChars.packages/core/dist/index.d.ts
facts?ChildExecutionFactsThe child's execution facts (RV1503), under the executionFacts opt-in only.packages/core/dist/index.d.ts
handlenumber-packages/core/dist/index.d.ts
hasMorebooleanTrue when more characters remain past this page; call again with a higher offset.packages/core/dist/index.d.ts
offsetnumberThe character offset this page starts at, counted from zero.packages/core/dist/index.d.ts
statusstring-packages/core/dist/index.d.ts
totalCharsnumberLength of the whole serialized result, in characters.packages/core/dist/index.d.ts