Struct PromptRunParams 

pub struct PromptRunParams {
    pub cwd: String,
    pub prompt: String,
    pub model: Option<String>,
    pub effort: Option<ReasoningEffort>,
    pub approval_policy: ApprovalPolicy,
    pub sandbox_policy: SandboxPolicy,
    pub privileged_escalation_approved: bool,
    pub attachments: Vec<PromptAttachment>,
    pub timeout: Duration,
    pub output_schema: Option<Value>,
}

Fields

cwd: String

prompt: String

model: Option<String>

effort: Option<ReasoningEffort>

approval_policy: ApprovalPolicy

sandbox_policy: SandboxPolicy

privileged_escalation_approved: bool

Explicit opt-in gate for privileged sandbox usage (SEC-004). Default stays false to preserve safe-by-default posture.

attachments: Vec<PromptAttachment>

timeout: Duration

output_schema: Option<Value>

Implementations

impl PromptRunParams

pub fn new(cwd: impl Into<String>, prompt: impl Into<String>) -> Self

Create prompt-run params with safe defaults. Allocation: two String allocations for cwd/prompt. Complexity: O(n), n = input lengths.

pub fn with_model(self, model: impl Into<String>) -> Self

Set explicit model override. Allocation: one String. Complexity: O(model length).

pub fn with_effort(self, effort: ReasoningEffort) -> Self

Set explicit reasoning effort. Allocation: none. Complexity: O(1).

pub fn with_approval_policy(self, approval_policy: ApprovalPolicy) -> Self

Set approval policy override. Allocation: none. Complexity: O(1).

pub fn with_sandbox_policy(self, sandbox_policy: SandboxPolicy) -> Self

Set sandbox policy override. Allocation: depends on sandbox payload move/clone at callsite. Complexity: O(1).

pub fn allow_privileged_escalation(self) -> Self

Explicitly approve privileged sandbox escalation for this run. Callers are expected to set approval policy + scope alongside this flag.

pub fn with_timeout(self, timeout: Duration) -> Self

Set prompt timeout. Allocation: none. Complexity: O(1).

pub fn with_output_schema(self, output_schema: Value) -> Self

Set one optional JSON Schema for the final assistant message.

pub fn with_attachment(self, attachment: PromptAttachment) -> Self

Add one generic attachment. Allocation: amortized O(1) push. Complexity: O(1).

pub fn attach_path(self, path: impl Into<String>) -> Self

Add one @path attachment. Allocation: one String. Complexity: O(path length).

pub fn attach_path_with_placeholder( self, path: impl Into<String>, placeholder: impl Into<String>, ) -> Self

Add one @path attachment with placeholder. Allocation: two Strings. Complexity: O(path + placeholder length).

pub fn attach_image_url(self, url: impl Into<String>) -> Self

Add one remote image attachment. Allocation: one String. Complexity: O(url length).

pub fn attach_local_image(self, path: impl Into<String>) -> Self

Add one local image attachment. Allocation: one String. Complexity: O(path length).

pub fn attach_skill( self, name: impl Into<String>, path: impl Into<String>, ) -> Self

Add one skill attachment. Allocation: two Strings. Complexity: O(name + path length).

Trait Implementations

impl Clone for PromptRunParams

fn clone(&self) -> PromptRunParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PromptRunParams

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

Formats the value using the given formatter.

impl PartialEq for PromptRunParams

fn eq(&self, other: &PromptRunParams) -> 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 PromptRunParams