Struct CreateTerminalRequest 

#[non_exhaustive]
pub struct CreateTerminalRequest {
    pub session_id: SessionId,
    pub command: String,
    pub args: Vec<String>,
    pub env: Vec<EnvVariable>,
    pub cwd: Option<PathBuf>,
    pub output_byte_limit: Option<u64>,
    pub meta: Option<Meta>,
}

Request to create a new terminal and execute a command.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

session_id: SessionId

The session ID for this request.

command: String

The command to execute.

args: Vec<String>

Array of command arguments.

env: Vec<EnvVariable>

Environment variables for the command.

cwd: Option<PathBuf>

Working directory for the command (absolute path).

output_byte_limit: Option<u64>

Maximum number of output bytes to retain.

When the limit is exceeded, the Client truncates from the beginning of the output to stay within the limit.

The Client MUST ensure truncation happens at a character boundary to maintain valid string output, even if this means the retained output is slightly less than the specified limit.

meta: Option<Meta>

The _meta property is reserved by ACP to allow clients and agents to attach additional metadata to their interactions. Implementations MUST NOT make assumptions about values at these keys.

See protocol docs: Extensibility

Implementations

impl CreateTerminalRequest

pub fn new(session_id: impl Into<SessionId>, command: impl Into<String>) -> Self

pub fn args(self, args: Vec<String>) -> Self

Array of command arguments.

pub fn env(self, env: Vec<EnvVariable>) -> Self

Environment variables for the command.

pub fn cwd(self, cwd: impl IntoOption<PathBuf>) -> Self

Working directory for the command (absolute path).

pub fn output_byte_limit(self, output_byte_limit: impl IntoOption<u64>) -> Self

Maximum number of output bytes to retain.

When the limit is exceeded, the Client truncates from the beginning of the output to stay within the limit.

The Client MUST ensure truncation happens at a character boundary to maintain valid string output, even if this means the retained output is slightly less than the specified limit.

pub fn meta(self, meta: impl IntoOption<Meta>) -> Self

The _meta property is reserved by ACP to allow clients and agents to attach additional metadata to their interactions. Implementations MUST NOT make assumptions about values at these keys.

See protocol docs: Extensibility

Trait Implementations

impl Clone for CreateTerminalRequest

fn clone(&self) -> CreateTerminalRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CreateTerminalRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CreateTerminalRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for CreateTerminalRequest

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for CreateTerminalRequest

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for CreateTerminalRequest

impl StructuralPartialEq for CreateTerminalRequest