Struct App 

pub struct App {

    pub public_id: AppId,
    pub internal_id: Uuid,
    pub org_id: i64,
    pub name: String,
    pub description: Option<String>,
    pub harness_id: HarnessId,
    pub agent_id: Option<AgentId>,
    pub agent_version_policy: AgentVersionPolicy,
    pub agent_version_id: Option<AgentVersionId>,
    pub agent_identity_id: Option<AgentIdentityId>,
    pub owner_principal_id: PrincipalId,
    pub resolved_owner_user_id: Option<Uuid>,
    pub owner: Option<PrincipalSummary>,
    pub effective_owner: Option<PrincipalSummary>,
    pub channels: Vec<AppChannel>,
    pub status: AppStatus,
    pub published_at: Option<DateTime<Utc>>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub archived_at: Option<DateTime<Utc>>,
    pub deleted_at: Option<DateTime<Utc>>,
}

App configuration for deploying agents to channels. An app binds a harness and optional agent to distribution channels with a publish lifecycle.

Fields

public_id: AppId

External identifier (app_<32-hex>). Shown as “id” in API.

internal_id: Uuid

Internal UUID primary key. Used for FK references. Never exposed in API.

org_id: i64

Organization ID. Internal only, not exposed in API.

name: String

Display name of the app.

description: Option<String>

Human-readable description of what the app does.

harness_id: HarnessId

ID of the harness to use (format: harness_{32-hex}).

agent_id: Option<AgentId>

Optional ID of the agent to use (format: agent_{32-hex}).

agent_version_policy: AgentVersionPolicy

Version resolution policy for the optional agent.

agent_version_id: Option<AgentVersionId>

Pinned agent version. Required when policy is pinned.

agent_identity_id: Option<AgentIdentityId>

Optional virtual identity that represents the app in unattended/channel execution.

owner_principal_id: PrincipalId

Owning principal for this app.

resolved_owner_user_id: Option<Uuid>

Denormalized effective human owner of the owning principal lineage.

owner: Option<PrincipalSummary>

Owning principal summary.

effective_owner: Option<PrincipalSummary>

Effective human owner summary.

channels: Vec<AppChannel>

Distribution channels attached to this app.

status: AppStatus

Current lifecycle status.

published_at: Option<DateTime<Utc>>

Timestamp when the app was last published.

created_at: DateTime<Utc>

Timestamp when the app was created.

updated_at: DateTime<Utc>

Timestamp when the app was last updated.

archived_at: Option<DateTime<Utc>>

Timestamp when the app was archived.

deleted_at: Option<DateTime<Utc>>

Timestamp when the app was deleted.

Implementations

impl App

pub fn slack_channel(&self) -> Option<&AppChannel>

Find the first Slack channel on this app.

pub fn ag_ui_channel(&self) -> Option<&AppChannel>

Find the first enabled AG-UI channel on this app.

pub fn schedule_channel(&self) -> Option<&AppChannel>

Find the first enabled schedule channel on this app.

pub fn webhook_channel(&self) -> Option<&AppChannel>

Find the first enabled webhook channel on this app.

pub fn fcp_channel(&self) -> Option<&AppChannel>

Find the first enabled FCP channel on this app.

pub fn a2a_channel(&self) -> Option<&AppChannel>

Find the first enabled A2A channel on this app.

pub fn channel_by_id(&self, id: &AppChannelId) -> Option<&AppChannel>

Find a channel by its public ID.

Trait Implementations

impl Clone for App

fn clone(&self) -> App

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for App

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for App

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for App

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

where __S: Serializer,

Serialize this value into the given Serde serializer.