Struct Spec 

pub struct Spec {
    pub name: Name,
    pub purpose: Purpose,
    pub allowed_tools: Vec<ToolName>,
    pub forbidden_actions: Vec<ForbiddenAction>,
    pub default_review_gates: Vec<ReviewGate>,
}

Domain contract for one bounded automation agent.

A spec describes what an agent is meant to help with, which narrow tools may be exposed to it, which live operational actions are outside its authority, and which deterministic review gates must remain in the app workflow.

Fields

name: Name

Stable workflow-facing agent name.

This is an identifier such as manager-daily-brief or booking-triage, not a human display label. It connects prompt packets, outputs, and audit evidence back to the spec that constrained the agent run.

purpose: Purpose

Business purpose for the agent’s draft or evidence work.

The purpose should state the resort operation being supported, such as summarizing labor risk, drafting customer-safe follow-up, or routing vaccine-document ambiguity; it does not grant live-action authority.

allowed_tools: Vec<ToolName>

Tool names the runtime may expose to this agent.

These should be read-only, draft-only, or task-creation surfaces scoped to the workflow. They are the positive capability list for context building, not permission to bypass review gates or mutate source systems.

forbidden_actions: Vec<ForbiddenAction>

Live or unsafe actions the agent must not perform directly.

Examples include confirming bookings, promising availability, changing labor schedules, waiving deposits, diagnosing pets, or sending customer messages without approval.

default_review_gates: Vec<ReviewGate>

Human or deterministic app review gates required for the workflow.

These gates keep manager approval, customer-message approval, medical document review, and similar authority outside the model-generated output.

Implementations

impl Spec

pub fn builder() -> SpecBuilder

Create an instance of Spec using the builder syntax

Trait Implementations

impl Clone for Spec

fn clone(&self) -> Spec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Spec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Spec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Spec

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

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 Spec

impl StructuralPartialEq for Spec