Struct OpenCodeConfig 

pub struct OpenCodeConfig { /* private fields */ }

Selects Kit-owned spawning or exclusive attachment for OpenCode.

Examples

use std::time::Duration;
use agents_kit::{
    config::{BackendConfig, OpenCodeConfig},
    KitError,
};

let external_opencode = || -> Result<BackendConfig, KitError> {
    let opencode = OpenCodeConfig::external(
        "http://127.0.0.1:4096",
        Duration::from_secs(10),
        Duration::from_secs(60),
        Duration::from_secs(30),
    )?;
    Ok(opencode.into())
};
let backend = external_opencode()?;
assert!(matches!(backend, BackendConfig::OpenCode(_)));

Implementations

impl OpenCodeConfig

pub fn spawn( executable: PathBuf, arguments: Vec<OsString>, address: SocketAddr, startup_timeout: Duration, request_timeout: Duration, idle_stream_timeout: Duration, ) -> Result<Self, KitError>

Configures a Kit-owned OpenCode process on a loopback address.

Extra arguments may not replace the Kit-owned serve, hostname, or port routing.

This creates passive configuration; it does not start the executable.

Errors

Returns crate::error::ErrorKind::InvalidConfig when: The executable is empty, the address is not loopback with a nonzero port, arguments replace owned routing, startup/request timeout is zero, or stream silence is below thirty seconds.

use agents_kit::config::OpenCodeConfig;
use std::time::Duration;
let config = OpenCodeConfig::spawn("opencode".into(), vec![],
    "127.0.0.1:4096".parse().unwrap(), Duration::from_secs(15),
    Duration::from_secs(60), Duration::from_secs(30))?;
let backend: agents_kit::config::BackendConfig = config.into();
assert!(matches!(backend, agents_kit::config::BackendConfig::OpenCode(_)));

pub fn external( base_url: impl AsRef<str>, connect_timeout: Duration, request_timeout: Duration, idle_stream_timeout: Duration, ) -> Result<Self, KitError>

Configures exclusive attachment to a caller-managed OpenCode server.

The base URL must be credential-free HTTP or HTTPS. Caller-owned server configuration is not mutated by this attachment.

This creates passive configuration without contacting the server. A path prefix is retained with a trailing slash.

Errors

Returns crate::error::ErrorKind::InvalidConfig when: The URL is malformed or not credential-free HTTP(S), has query/fragment components, a connect/request timeout is zero, or stream silence is below thirty seconds.

use agents_kit::config::OpenCodeConfig;
use std::time::Duration;
let config = OpenCodeConfig::external("http://127.0.0.1:4096",
    Duration::from_secs(10), Duration::from_secs(60), Duration::from_secs(30))?;
assert!(OpenCodeConfig::external("http://127.0.0.1:4096?token=example",
    Duration::from_secs(10), Duration::from_secs(60), Duration::from_secs(30)).is_err());

Trait Implementations

impl Clone for OpenCodeConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpenCodeConfig

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

Formats the value using the given formatter.

impl From<OpenCodeConfig> for BackendConfig

fn from(config: OpenCodeConfig) -> Self

Converts to this type from the input type.