Enum RunStep 

pub enum RunStep {
    Call {
        call: Box<dyn PendingCall>,
        stdout: String,
    },
    Complete {
        value: Value,
        stdout: String,
    },
    Raised {
        message: String,
        stdout: String,
    },
}

Available on crate features agents and codeact only.

The result of advancing the interpreter to its next host-relevant stop.

Every variant carries the stdout (e.g. print) the script produced since the previous step. Runtimes that capture output attach it (see RunStep::with_stdout); those that don’t leave it empty. The driver surfaces captured output back to the model so it can see what its code printed. Construct values with RunStep::call, RunStep::complete, and RunStep::raised.

Variants

Call

The script called an external function (a tool). Resume it to continue.

Fields

call: Box<dyn PendingCall>

The paused external-function call.

stdout: String

Output the script produced since the previous step (empty if none or if the runtime does not capture output).

Complete

The script ran to completion; carries the returned value (decoded to JSON).

Fields

value: Value

The value the script returned, decoded to JSON.

stdout: String

Output the script produced since the previous step.

Raised

The script failed: an error propagated to the top. The message is the runtime’s native error rendering, fed back to the model verbatim. This also covers resource-limit cancellations and parse/compile failures — the framework does not care which; the message says so.

Fields

message: String

The runtime’s native error rendering.

stdout: String

Output the script produced before the error.

Implementations

impl RunStep

pub fn call(call: Box<dyn PendingCall>) -> RunStep

A tool-call step with no captured output.

pub fn complete(value: Value) -> RunStep

A completion step with no captured output.

pub fn raised(message: impl Into<String>) -> RunStep

A script-error step with no captured output.

pub fn with_stdout(self, stdout: impl Into<String>) -> RunStep

Attach captured stdout to this step (builder-style).

Example

use adk_agent::codeact::RunStep;
use serde_json::json;

let step = RunStep::complete(json!({"type": "final_result", "value": 1}))
    .with_stdout("hello\n");

Trait Implementations

impl Debug for RunStep

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

Formats the value using the given formatter.