Struct ShellObservation 

pub struct ShellObservation {
    pub source: String,
    pub content: String,
}

One unit of shell activity the human produced beside the agent.

This is not a tool call (the agent didn’t run it) and not the human’s instruction (they didn’t ask for anything) — it is ambient context. Construct one per tap, then call into_mem_message to fold it into the next turn’s context.

use newt_core::agentic::ShellObservation;

let obs = ShellObservation::new("zsh", "$ cargo test\n   Compiling newt-core\n");
let msg = obs.into_mem_message();
assert_eq!(msg.role, newt_core::Role::User);
assert!(msg.content.contains("cargo test"));

Fields

source: String

Where the activity came from — a shell name ("zsh", "bash"), a tier label ("typescript", "pty"), or any short tag the consumer chooses. Purely descriptive; it is shown to the model verbatim (after trimming).

content: String

The raw shell content the human produced (command line, output, or both). Never rendered raw — redacted_content scrubs credentials before it reaches a MemMessage.

Implementations

impl ShellObservation

pub fn new(source: impl Into<String>, content: impl Into<String>) -> Self

Build an observation from a source tag and raw shell content.

pub fn redacted_content(&self) -> String

The observation content after credential redaction — the only form allowed to leave this type. Runs the exact redact_secrets pass the compression summarizer applies to its input, so an sk-… key, a GitHub token, a Bearer … header, an AKIA… id, a JWT, a private-key block, or a password=… assignment in shell output becomes [REDACTED] before it can reach the model.

pub fn into_mem_message(self) -> MemMessage

Render the (redacted) observation into a MemMessage ready to append to the assembled message list before chat_complete.

The message carries the User role — the role a human-originated turn uses — but its content opens with SHELL_OBSERVATION_PREFIX so the model reads it as “here is what the human just did,” never as a fresh instruction or a tool result. The source tag is included for orientation; the body is the redacted content.

Trait Implementations

impl Clone for ShellObservation

fn clone(&self) -> ShellObservation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ShellObservation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ShellObservation

impl PartialEq for ShellObservation

fn eq(&self, other: &ShellObservation) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ShellObservation