Struct SpawnBody 

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

Body for POST /api/workspaces/{repo}/agents.

Fields

prompt: String

Initial prompt / task.

label: Option<String>

Optional label.

model: Option<String>

Optional model override.

isolation: Option<String>

Isolation mode: "worktree" (default) or "shared".

tool_allowlist: Option<Vec<String>>

Optional tool allowlist.

interactive: bool

Run the agent in interactive mode (awaits operator input).

frontmatter_path: Option<String>

Optional agent-template / frontmatter markdown file path (#6).

provider_ref: Option<String>

Which named workspace provider to bind (k8s config plane → CalibanTask.providerRef). None ⇒ the workspace’s default (#142).

timeout_secs: Option<u64>

Kill the agent after this many seconds of wall-clock time (#221). Absent ⇒ no limit. Enforced by prospero, not by the agent.

permission_posture: PermissionPosture

How this session handles tool calls needing permission (#238). Absent ⇒ PermissionPosture::Supervised. Asking for PermissionPosture::Unattended requires an admin-scope credential (ADR-0010); the handler rejects it otherwise.

Implementations

impl SpawnBody

pub fn isolation_worktree(&self) -> bool

Whether this spawn should get an isolated git worktree.

Isolation defaults to worktree; only the explicit string "shared" opts out. Kept here (not in the api adapter) because it is the meaning of the field, and both ends need to agree on it — the dashboard reads it back to render the isolation control.

Trait Implementations

impl Clone for SpawnBody

fn clone(&self) -> SpawnBody

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpawnBody

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

Formats the value using the given formatter.

impl Default for SpawnBody

fn default() -> SpawnBody

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SpawnBody

fn deserialize<__D>( __deserializer: __D, ) -> Result<SpawnBody, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SpawnBody

impl JsonSchema for SpawnBody

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 SpawnBody

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SpawnBody

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SpawnBody