Skip to content

Latest commit

 

History

History
65 lines (48 loc) · 2.67 KB

CONTEXT.md

File metadata and controls

65 lines (48 loc) · 2.67 KB

Code Agent Runtime

This glossary defines the runtime artifacts produced and maintained by a code agent so that public output, diagnostics, evaluation data, and resumable state remain distinct.

Language

Agent Run: A bounded execution that starts with an instruction and ends when the agent stops autonomous work. Avoid: Session, turn

Run Output: The public result or event protocol that one agent run emits to its caller. Avoid: Trace, transcript

Run Result Object: A single public object that summarizes how one Agent Run ended, including its final result and optional usage metadata. Avoid: Trajectory, session export

Public Event Stream: A caller-facing Run Output that exposes a stable, selected sequence of Agent Run events as they occur. Avoid: Internal event bus, execution trace

Source Record: An agent-specific record observed at a CLI, SDK, or protocol boundary and consumed by an adapter; it may already be a projection of the agent's internal state. Avoid: Native event, journal entry

Native Event: An agent-independent runtime fact accepted by the core directly or normalized from a Source Record. Avoid: Source record, public event record, trajectory step

Journal Entry: A Native Event together with the identity, ordering, and recording metadata required for durable history. Avoid: Persistence envelope, trajectory step

Event Journal: A durable append-only sequence of Journal Entries for an Agent Run from which derived artifacts can be rebuilt. Avoid: Trajectory, session, public event stream

Partial Content: An unfinished representation of a message, reasoning block, or tool input that is exposed before the logical content is complete. Avoid: Final message, completed event

Content Delta: The incremental fragment or change relative to content already emitted for the same logical item. Avoid: Partial snapshot, final message

Terminal Event: The final Public Event Stream record that explicitly states how an Agent Run ended. Avoid: EOF, last message

Execution Trace: A diagnostic record of runtime activity retained to explain failures, timing, and internal behavior. Avoid: Run output, trajectory

Trajectory: A task-scoped record of observations, actions, results, and outcome prepared for evaluation or offline analysis. Avoid: Execution trace, session, transcript

ATIF Trajectory: A Trajectory represented by the Agent Trajectory Interchange Format and exposed as the runtime's public trajectory contract. Avoid: Event journal, native trajectory

Session: Durable agent state that can span multiple runs and supports continuing or branching prior work. Avoid: Agent run, trajectory, transcript