> ## Documentation Index
> Fetch the complete documentation index at: https://docs.narrativebanking.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Coach guide

> Integration guidance for Coach conversations, streaming responses, and follow-up workflows.

Coach is the in-product conversational assistant your users talk to when they need clarity on what is happening in their business and what to do next. In the current app experience, users ask free-form questions, get guided answers in chat, open linked detail views, and continue with follow-up prompts that turn insight into concrete next steps.

## What's new in v1.5.12

`v1.5.12` makes Coach faster for common questions and account-aware for same-currency multi-account users.

* Coach can reason over multiple connected same-currency bank accounts.
* Internal transfers between connected accounts are not treated as business income or spending.
* Common question types use a faster response path while preserving answer quality for deeper transaction analysis.
* Streaming responses, saved history, citations, follow-up questions, and product-surface handoffs remain compatible.
* Users can expand collapsed progress details to understand what Coach is checking without seeing internal operational detail.

## What's new in v1.5.11

`v1.5.11` connects Coach to journey progress and follow-through.

* Coach includes a "Help me set clear goals" entry point until the user has shared specific goals and challenges.
* Briefings lead with Money actions before Growth opportunities so users can build the financial picture first.
* Coach can ask about bookmarked action status to help users return to priorities they already chose.
* Journey-related Coach copy uses guidance language and avoids regulated financial recommendation framing.
* Goal and challenge capture for journey progress is distinct from broad onboarding direction.

## What's new in v1.5.8

`v1.5.8` improves Coach reliability, spending explanations, and reporting readiness.

* Coach gives clearer spending breakdowns by category.
* Coach handles partial failures more clearly when a tool, model call, context assembly step, or data source is unavailable.
* Error responses are more specific and are designed to avoid fabrication while offering a next-best action.
* Transaction-level behavioural signals and sector context can improve the grounding available to Coach where tenant configuration and data availability support it.

## Functional flow

<AccordionGroup>
  <Accordion title="1. Initialize or restore a session">
    Load current conversation context and prior history when the user opens Coach.
  </Accordion>

  <Accordion title="2. Stream responses for each user message">
    Render assistant output incrementally so users see progress instead of waiting for one final payload.
  </Accordion>

  <Accordion title="3. Separate content and control handling">
    Handle text chunks, completion signals, and runtime errors as different event types in the UI.
  </Accordion>

  <Accordion title="4. Explain limitations explicitly">
    When data or tools are unavailable, show a specific limitation and a safe next step rather than a generic failure message.
  </Accordion>

  <Accordion title="5. Run follow-up workflows after completion">
    After each completed answer, enable feedback capture and optional guided next-question suggestions.
  </Accordion>

  <Accordion title="6. Capture journey goals and follow-through">
    Record specific goals, challenges, and action-status updates from confirmed Coach interactions so journey progress reflects real user intent.
  </Accordion>

  <Accordion title="7. Preserve account-aware context">
    Keep Coach answers grounded in the connected same-currency account set and avoid treating internal transfers as income or spending.
  </Accordion>
</AccordionGroup>

## Integration considerations

<Columns cols={2}>
  <Card title="Session model" icon="https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/frontend-shell.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=13c676d362a2a3a7a60bfa0fae245ad6" width="64" height="64" data-path="SVG/frontend-shell.svg">
    Keep conversation state bound to authenticated user context so resumes and restores remain coherent.
  </Card>

  <Card title="Streaming lifecycle" icon="https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/coach-chat.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=48321b24059ca857f3f87b96dae8e1a6" width="64" height="64" data-path="SVG/coach-chat.svg">
    Design the UI around in-progress, completed, interrupted, and degraded answer states.
  </Card>

  <Card title="Context binding" icon="https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/domain-services.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=4d68cb4946e69d67738f55ee16264633" width="64" height="64" data-path="SVG/domain-services.svg">
    Attach conversations to relevant product entities so follow-up guidance stays grounded.
  </Card>

  <Card title="Connected account context" icon="https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/database.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=4eb7c552d3b697a6147a07f1b9ee5a43" width="64" height="64" data-path="SVG/database.svg">
    Preserve account-aware context when users ask about cash movement, transfers, spending, or income across connected accounts.
  </Card>

  <Card title="Feedback loop" icon="https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/refusal-behavior.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=7f2e9e92249aa3eb1c27b298f31fd56f" width="64" height="64" data-path="SVG/refusal-behavior.svg">
    Capture explicit user sentiment after messages complete to improve assistant relevance over time.
  </Card>
</Columns>

## Common risk patterns

* Session restore drift after account or context switches.
* Duplicate client rendering when stream completion is not handled idempotently.
* Feedback double-submission when retries are not deduplicated.
* Generic error states that hide whether data is unavailable, still processing, or outside the current product scope.