Struct SpawnRequest 

pub struct SpawnRequest {
    pub prompt: String,
    pub label: Option<String>,
    pub model: Option<String>,
    pub isolation_worktree: bool,
    pub tool_allowlist: Option<Vec<String>>,
    pub interactive: bool,
    pub frontmatter_path: Option<PathBuf>,
    pub timeout_secs: Option<u64>,
    pub provider_ref: Option<String>,
    pub permission_posture: PermissionPosture,
}

A Prospero-level request to launch a new agent. Worktree isolation is the default for parallel work on one codebase; opt out with isolation_worktree: false.

Fields

prompt: String

Initial prompt / task.

label: Option<String>

Optional human-readable label.

model: Option<String>

Optional model override.

isolation_worktree: bool

Run in an isolated git worktree. Defaults to true via SpawnRequest::new.

tool_allowlist: Option<Vec<String>>

Optional tool allowlist.

interactive: bool

Run in interactive mode (the worker awaits operator input instead of finishing). Defaults to false via SpawnRequest::new.

frontmatter_path: Option<PathBuf>

Optional agent-template / frontmatter markdown file, forwarded to caliband’s SpawnSpec.frontmatter_path. None ⇒ no template (#6).

timeout_secs: Option<u64>

Kill the agent after this many seconds of wall-clock time (#221). None ⇒ it runs until it finishes or someone stops it.

Enforced by prospero, not caliband: the deadline is recorded in the event log at spawn, so it survives the replica that set it.

provider_ref: Option<String>

Which of the target workspace’s named providers to bind, under the k8s config plane (→ CalibanTask.spec.providerRef). None ⇒ the operator picks the workspace’s defaultProvider. Ignored by LocalFleet, whose provider comes from the repo’s stored config. (#142)

permission_posture: PermissionPosture

How this session handles tool calls needing permission (#238). Defaults to PermissionPosture::Supervised via SpawnRequest::new. Authorization for Unattended is the caller’s job — the API requires an admin scope (ADR-0010) and, in-cluster, the operator additionally requires the Workspace to allow it.

Implementations

impl SpawnRequest

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

A spawn request with worktree isolation on by default.

Trait Implementations

impl Clone for SpawnRequest

fn clone(&self) -> SpawnRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpawnRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SpawnRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SpawnRequest

fn eq(&self, other: &SpawnRequest) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for SpawnRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SpawnRequest