Struct MontyRuntimeBuilder 

pub struct MontyRuntimeBuilder { /* private fields */ }

Available on crate feature codeact-monty only.

Builder for MontyRuntime.

Implementations

impl MontyRuntimeBuilder

pub fn new() -> MontyRuntimeBuilder

Create a builder seeded with the conservative default limits (5s wall-clock per advance, 256 MiB memory) and a fully sandboxed OS policy (no filesystem access, empty environment, host clock enabled).

pub fn resource_limits(self, limits: ResourceLimits) -> MontyRuntimeBuilder

Replace the full set of resource limits.

pub fn unlimited(self) -> MontyRuntimeBuilder

Remove all resource caps except Monty’s built-in recursion guard.

Use this only for trusted scripts. LLM-generated code should keep the default time/memory caps so an accidental infinite loop or runaway allocation cannot block the calling task. Equivalent to resource_limits(ResourceLimits::default()).

Example

use adk_codeact_monty::MontyRuntime;

let runtime = MontyRuntime::builder().unlimited().build();

pub fn max_duration(self, duration: Duration) -> MontyRuntimeBuilder

Cap wall-clock execution time for each interpreter step.

The limit applies per start/resume advance (time spent in your tools between steps does not count), and restarts after deserialization.

pub fn max_memory(self, bytes: usize) -> MontyRuntimeBuilder

Cap approximate heap memory (bytes) a script may use.

pub fn additional_prompt(self, text: impl Into<String>) -> MontyRuntimeBuilder

Append extra text to the language briefing in the system prompt (e.g. domain conventions, additional usage rules).

pub fn os_access(self, access: OsAccess) -> MontyRuntimeBuilder

Replace the whole OS-access policy.

Use this when you have built an OsAccess separately; otherwise reach for the per-aspect shortcuts Self::allow_path, Self::environ, Self::environ_var, and Self::system_clock.

pub fn allow_path( self, virtual_path: impl Into<String>, host_path: impl Into<PathBuf>, access: PathAccess, ) -> MontyRuntimeBuilder

Make a host directory available to scripts at virtual_path, read-only or read-write.

Scripts reach it through pathlib.Path against virtual_path (e.g. /data); Monty enforces the mount boundary so a script can never escape it. By default no paths are accessible. See OsAccessBuilder::allow_path.

Example

use adk_codeact_monty::{MontyRuntime, PathAccess};

let runtime = MontyRuntime::builder()
    .allow_path("/data", "/srv/agent/data", PathAccess::ReadOnly)
    .build();

pub fn environ<K, V>( self, vars: impl IntoIterator<Item = (K, V)>, ) -> MontyRuntimeBuilder

where K: Into<String>, V: Into<String>,

Replace the environment map exposed to scripts via os.getenv / os.environ. Empty by default — the host process environment is never exposed implicitly.

pub fn environ_var( self, key: impl Into<String>, value: impl Into<String>, ) -> MontyRuntimeBuilder

Add or overwrite a single environment variable visible to scripts.

pub fn system_clock(self, enabled: bool) -> MontyRuntimeBuilder

Enable or disable host-clock access (date.today() / datetime.now()). Enabled by default.

pub fn build(self) -> MontyRuntime

Finish building the runtime.

Trait Implementations

impl Default for MontyRuntimeBuilder

fn default() -> MontyRuntimeBuilder

Returns the “default value” for a type.