Conversation Lifecycle

Status: Canonical
Last updated: 2026-07-05

---

sequenceDiagram
    participant U as User
    participant UI as Product UI
    participant RT as PL-003 TurnOrchestrator
    participant INT as Intent Pipeline
    participant PL as Planner
    participant TOOL as Tool Registry
    participant PR as Provider Gateway

    U->>UI: Message
    UI->>RT: AgentTurnRequest DTO
    RT->>INT: Classify intent
    INT->>PL: Signals + intent
    PL->>TOOL: Select tools
    alt LLM reasoning required
        PL->>PR: Completion request
        PR-->>PL: Structured output
    end
    TOOL->>TOOL: Execute with permissions
    TOOL-->>RT: ToolResult DTOs
    RT-->>UI: AgentTurnResponse DTO
    UI-->>U: Rendered response
    RT->>RT: Trace to PL-006

---

Turn invariants

• Every turn produces a trace record (PL-006)
• Tool failures are structured — never silent swallow
• Clinic scoping enforced before tool execution (PRD-001)

---

Related

• intent-understanding.md
• execution.md

Breadcrumbs: Home → AI → Conversation Lifecycle