Agent Lifecycle

Status: Canonical
Owner: PL-003
Last updated: 2026-07-05

---

stateDiagram-v2
    [*] --> Registered: Product registers agent
    Registered --> Idle: Configuration loaded
    Idle --> Active: Conversation started
    Active --> Processing: User message
    Processing --> Active: Turn complete
    Active --> Idle: Session timeout
    Idle --> Suspended: Policy violation
    Suspended --> Idle: Admin resume
    Active --> Retired: Version deprecated
    Retired --> [*]

---

Phases

Phase	Owner	Description
Registration	Product AI module	Agent key, persona, capabilities, tools
Configuration	PL-003 + PL-004	Prompt version, model pin from registry
Activation	PL-003	Session bound to clinic/user context
Turn processing	PL-003	Intent → plan → execute → respond
Retirement	PL-004 + governance	Deprecate version; agent reads-only

---

Related

• conversation-lifecycle.md
• PLATFORMS/PL-003-ai-runtime.md
• AGENTS/README.md

Breadcrumbs: Home → AI → Agent Lifecycle