support_desk 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: afefc82399ac7abf6a331cc44fceb5fd160694fea8c83025af5e5888399a18d2
-  data.tar.gz: c209e7f207e89de6e4e0b48ecdd8b2dfd4e7011b352cf2eaf52c82dd9b13260f
+  metadata.gz: f20ef59f51139224d4dc822bc4d96eced0d5517e6b308399f707d43eef11d229
+  data.tar.gz: fde3321433991bb1c7aa89a944e57a5fa4cd7cf19da1ba3444f8a81289b962ab
 SHA512:
-  metadata.gz: 773a60b0710143ef412597a9789b2c37e5a41d99cbb965e5908d6035c11dcd5d97b0353c4f0777e5fd1e7644414ad01afa7c19379402a83e3cb9ef81353d0896
-  data.tar.gz: 120b9347b36642f5248ba4c6e95b1898886f666913729cedc28d02b0177e3a97c5136e12ab8052501921a2b812488d55359ed326ac361dd5cb9c5af76b1ff55f
+  metadata.gz: 0fcd4009a005176029c7f2c07dc5f4a4dd7c6bee5a46428025d9ccc56d30f9b2a76170713d9362a3f5aab658f34c0f9c0ad151d048969fc7b7a0ea3b641ec724
+  data.tar.gz: ae545aeec1cac66db40a3df1777fd2c7747dda0103c99d7424b55d06cbbd6dd67cb9cb8b1685e642d97f82153afc2ea149257967957da63b2e1524a7c437bf52

data/CHANGELOG.md

@@ -4,6 +4,63 @@ All notable changes to this project are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-10-19
+
+Intended as **0.5.0**: "Need help?" in the corner. **Requires chats >= 0.7.1**
+(its tray and its `:unread_changed` event). No migration; nothing changes
+until you render the launcher.
+
+### Added
+
+- **The launcher.** `support_launcher` puts a "Need help?" tab in the
+  bottom-right corner: in chats' messaging dock's tray, beside its bar
+  (`chats_dock { support_launcher }`), or in a corner of its own when there is
+  no dock. Its panel is this engine's own screens in a frame — their open
+  cases, a new case (the wizard, with the promise under the form), a case's
+  thread — so nobody leaves the page they are on. chats draws and runs the
+  chrome (one menu open at a time, the windows giving it room, Escape,
+  memory, the phone's round button and full-screen sheet); this engine ships
+  no JavaScript for it. `show_for: :everyone` shows it to visitors who are
+  signed out too, whose panel says how to reach the desk (sign in through
+  `/support`, the desk's `config.email`, the host's `help_url:`).
+- **The panel is the pages.** A request from the panel's frame
+  (`Turbo-Frame: support_desk_panel`, `SupportDesk::Launcher.panel_request?`)
+  is answered with the screen's panel template (`support_desk/panel/home`,
+  `new`, `case`, and the limit wall) inside `layouts/support_desk/panel`;
+  every other request renders exactly as before. In the panel a new case
+  opens in the panel, and so does any case, whatever `thread_page` says. A
+  case there is chats' compact thread body (`window: true`), which reads
+  itself once the panel is open (the server never reads a panel render: a
+  frame loading behind a closed panel must not put the badge out). The limit
+  wall has its own panel screen (`support_desk/panel/rate_limited`, the
+  page's content from `tickets/_limit_wall`).
+- **A live badge.** `unread_support_count` on the requester's
+  `[requester, :support_desk]` stream, replaced wherever chats says an unread
+  count in a case may have moved (`Chats.on(:unread_changed)`), the case's own
+  notices included, and asked again from `GET /support/tickets/badge` when the
+  stream missed one. The Messages badge never counts it. One small job per
+  message in a case, counting as it renders, whether or not the host renders
+  a launcher: a job cannot tell whether anybody listens, and a switch would
+  let a launcher's badge silently never move.
+- `support_panel?`, `support_desk_top_frame` (the frame a link that leaves a
+  step targets: `"_top"` on a page, the panel in the panel), and
+  `support_desk_slot` with two slots, `panel_top` and `panel_footer`.
+- `support_desk.launcher.*` in en and es; `rails g support_desk:views` ejects
+  the launcher and its panel's screens too (`--views launcher`).
+
+### Changed
+
+- The requester partials that targeted `_top` (`_pick_topic`, `_pick_thing`,
+  `_write`, `_wizard_header`) use `support_desk_top_frame`, and
+  `support_thread_path` leads to the ticket page in the panel. **If you
+  ejected them and use the launcher**, make the same change in your copies,
+  or their links leave the panel for the page.
+- The dummy app loads Turbo and Stimulus for real (its importmap pinned
+  neither, so the browser tests ran on plain HTML), and two tests that leaned
+  on that were corrected: the console's refused send is rendered in place by
+  Turbo, and the thread page under chats 0.6's two panes shows the inbox's
+  badged desk row beside the thread.
+
 ## [0.4.0] - 2026-10-18
 
 ### Added

data/README.md

@@ -505,12 +505,88 @@ Both surfaces are pushed screens, never modals: every wizard step is a real
 URL, so the back gesture and cold-boot deep links work.
 
 
+### "Need help?" in the corner: the launcher
+
+The support pages are where help lives; the launcher is the door that is
+always there. One line puts a **Need help?** tab in the bottom-right corner,
+and its panel is the same screens in a frame: their open cases, a new case
+(the wizard, with the promise under the form), a case's thread. Nobody leaves
+the page they were on.
+
+```erb
+<%# A host with chats' messaging dock: the launcher sits in the dock's tray, beside its bar %>
+<%= chats_dock do %>
+  <%= support_launcher %>
+<% end %>
+
+<%# A host without the dock: the launcher brings the corner with it %>
+<%= support_launcher %>
+```
+
+![The launcher beside the messaging dock's bar](https://raw.githubusercontent.com/rameerez/support_desk/main/screenshots/launcher/bar.png)
+
+| Their cases | A case, in the panel | A new one |
+| --- | --- | --- |
+| ![The panel: the way to a new case with its promise, and the open cases](https://raw.githubusercontent.com/rameerez/support_desk/main/screenshots/launcher/panel.png) | ![A case's thread in the panel, an answer signed by the agent](https://raw.githubusercontent.com/rameerez/support_desk/main/screenshots/launcher/case.png) | ![The wizard's last step in the panel, the promise under the form](https://raw.githubusercontent.com/rameerez/support_desk/main/screenshots/launcher/new.png) |
+
+It is an item of chats' **tray** (chats >= 0.7.1), so chats draws the tab,
+the panel's chrome and the phone's sheet, and runs them: one menu open at a
+time with the Messages panel, the windows giving it room rather than being
+covered, Escape, the open item remembered on a desk, a 48px round button and a
+full-screen sheet on a phone (`chats_dock launcher: false` takes the buttons
+away). The look is the dock's, themed with the same `--chats-dock-*`
+variables. This engine ships no JavaScript of its own for it.
+
+- **The panel is the pages.** A request from the panel's frame
+  (`Turbo-Frame: support_desk_panel`) is answered with the screen's panel
+  template (`support_desk/panel/home`, `new`, `case`) inside
+  `layouts/support_desk/panel`; every other request renders exactly as before.
+  Links that leave a step target the panel instead of the page
+  (`support_desk_top_frame`), a case opens in the panel whatever
+  `thread_page` says (`support_thread_path`), and a new case opens there
+  after it is sent. ⤢ opens the case's page; "All your conversations" the
+  list, closed ones included.
+- **A case in the panel is chats' thread**, the compact body a dock window
+  renders: live, the composer at the bottom, the desk's signature, the way to
+  a person. It is read only while the panel is open (the tray item is the
+  thread's read gate), and when the page itself shows the same case (its
+  page, or a dock window), the panel goes back to the list rather than show
+  it twice.
+- **The badge** is `unread_support_count`, unread messages across their own
+  cases (the number `support_unread_badge` shows), live on the requester's
+  `[requester, :support_desk]` stream: it moves wherever chats says an unread
+  count may have moved (`:unread_changed`), the case's own notices included,
+  and catches up from `GET /support/tickets/badge` when the stream missed one.
+  It never touches the Messages badge, which counts the inbox (your
+  `inbox_scope` applied): a host that keeps support out of the inbox gets two
+  separate numbers. The open list reloads in place when it moves.
+- **Signed out**, `support_launcher show_for: :everyone` shows the same tab,
+  and its panel says how to reach you: sign in (through `/support`, so your
+  own authentication asks and brings them back), the desk's `config.email`
+  for those who can't, and your help centre (`help_url:`).
+
+<img src="https://raw.githubusercontent.com/rameerez/support_desk/main/screenshots/launcher/phone-sheet.png" alt="A phone: the panel is a full-screen sheet" width="240"> <img src="https://raw.githubusercontent.com/rameerez/support_desk/main/screenshots/launcher/signed-out.png" alt="Signed out: how to reach the desk" width="400">
+
+```erb
+<%= support_launcher show_for: :everyone, help_url: "https://example.com/help" %>
+```
+
+The words are `support_desk.launcher.*` (override them in your own locale
+files); the icon is `support_desk/launcher/_icon` (eject it to draw your own).
+Two slots put your own content in the panel, above and below it:
+`app/views/support_desk/slots/_panel_top.html.erb` and `_panel_footer.html.erb`
+(both get `requester:`, nil when signed out). The `/support` pages stay the
+place support lives; keep your Support links to them.
+
 ### Every helper the requester views can use
 
 | helper | what it renders |
 |---|---|
 | `link_to_support(about:, text:, **html)` | the door into the wizard (nothing when there is nobody to ask, or nothing they may ask about) |
+| `support_launcher(show_for: :signed_in, help_url: nil)` | the ["Need help?" launcher](#need-help-in-the-corner-the-launcher), in chats' tray |
 | `support_unread_badge` | unread support messages, counted against the chats read horizon |
+| `support_panel?` / `support_desk_top_frame` | whether this render answers the launcher's panel; the frame a link that leaves a step targets (`"_top"`, or the panel) |
+| `support_desk_slot(name, **locals)` | the launcher panel's `panel_top` / `panel_footer` slots |
 | `support_desk_styles` | the bundled stylesheet tag for your `<head>` |
 | `support_reply_promise` | "We usually reply in under 24 hours", from `reply_within` (also `SupportDesk.config.desk(key).reply_promise`) |
 | `support_ticket_state(ticket)` | "We're on it" · "We replied" · "We wrote to you" · "Closed" |
@@ -532,8 +608,9 @@ the screens yours:
 rails generate support_desk:views
 ```
 
-That copies `app/views/support_desk/tickets/**` and the two rows this engine
-contributes to chats' screens (`app/views/chats/slots/**`) into your app,
+That copies `app/views/support_desk/tickets/**`, the launcher and its panel's
+screens (`support_desk/launcher/**`, `support_desk/panel/**`) and the two rows
+this engine contributes to chats' screens (`app/views/chats/slots/**`) into your app,
 where they shadow the gem's copies — the Devise move. Delete your copy and
 the default comes back; upgrade the gem and your copy is untouched. Every
 view helper the templates use stays available afterwards, so an ejected copy
@@ -1680,7 +1757,7 @@ that is exactly when a seat gets stranded.
 
 ## Compatibility
 
-Rails 7.2, 8.0 and 8.1; Ruby >= 3.2; PostgreSQL, SQLite and MySQL; bigint or UUID primary keys (the migration follows your app's `primary_key_type`).
+Rails 7.2, 8.0 and 8.1; Ruby >= 3.2; PostgreSQL, SQLite and MySQL; bigint or UUID primary keys (the migration follows your app's `primary_key_type`). chats >= 0.7.1 (0.5.0 and later: the launcher sits in chats' tray and its badge listens to chats' `:unread_changed`).
 
 PostgreSQL and SQLite enforce unique new-case creation, one open assignment per ticket and
 one pending proposal per ticket with **partial unique indexes**. New submissions reuse an existing open case. Reopening
@@ -1764,7 +1841,7 @@ SupportDesk::VERSION
 
 After checking out the repo, run `bundle install`, then `bundle exec rake ci`. The dummy app lives in `test/dummy` and mounts all three surfaces the way a real host does: the requester engine at `/messages/support`, `chats` at `/messages`, and the turnkey console at `/admin/support` — plus the same console again inside a host-owned `madmin` namespace, because "the console uses only the public API" is a claim that needs a second implementation to be worth anything.
 
-`chats` is the kernel this gem is a product on and the two are developed in lockstep. support_desk requires `chats >= 0.5.1, < 1.0`. Until that is on rubygems, the bundle takes the reviewed chats package from `vendor/cache` (provenance and checksum in `vendor/cache/README.md`), so `bundle exec rake ci` needs no network and no sibling checkout.
+`chats` is the kernel this gem is a product on and the two are developed in lockstep. support_desk requires `chats >= 0.7.1, < 1.0`. Until that is on rubygems, the bundle takes the reviewed chats package from `vendor/cache` (provenance, checksum and the step that adds it in `vendor/cache/README.md`), so `bundle exec rake ci` needs no network and no sibling checkout.
 
 ## Contributing
 

data/app/assets/stylesheets/support_desk.css

@@ -250,3 +250,80 @@
      only the error notice carries colours of its own. */
   .support-desk-error { background: #3f1d1d; color: #fecaca; }
 }
+
+/* --- The launcher's panel (0.5.0) ------------------------------------------- *
+ *
+ * `support_launcher` is an item of chats' tray: chats draws its tab, the
+ * panel's chrome and the phone's sheet. This is the content: a frame that
+ * fills the panel and scrolls inside it. Rows, the empty state, "All your
+ * conversations" and a case's header wear the dock's own classes
+ * (.chats-dock__list, .chats-dock__see-all, .chats-window__header), so a
+ * host's dock theme reaches them too.
+ */
+.support-desk-launcher__name { overflow: hidden; text-overflow: ellipsis; }
+
+.support-desk-panel {
+  display: flex;
+  flex-direction: column;
+  flex: 1;
+  min-height: 0;
+  font-size: 0.875rem;
+}
+.support-desk-panel__screen {
+  display: flex;
+  flex-direction: column;
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+}
+.support-desk-panel__screen > .support-desk-door { margin: 0.75rem; }
+.support-desk-panel__all { margin-top: auto; gap: 0.4rem; }
+/* inline-block: the link's underline (a host's, on hover) stops at the count. */
+.support-desk-panel__count { display: inline-block; font-weight: 400; color: var(--support-desk-text-muted); }
+.support-desk-panel__loading { margin: auto; padding: 1.5rem; text-align: center; }
+
+/* The wizard, compacted to the panel's width. */
+.support-desk-panel__wizard .support-desk-wizard__header { padding: 0.85rem 0.85rem 0.15rem; }
+.support-desk-panel__wizard .support-desk-wizard__ask { font-size: 1.05rem; }
+.support-desk-panel__wizard :is(.support-desk-choice, .support-desk-card, .support-desk-error, .support-desk-notice) {
+  margin-inline: 0.75rem;
+}
+.support-desk-panel__wizard .support-desk-choice { padding: 0.7rem 0.85rem; }
+.support-desk-panel__wizard .support-desk-form { padding: 0 0.75rem 1rem; }
+.support-desk-panel__wizard .support-desk-form__input { padding: 0.65rem 0.8rem; }
+
+/* A case: the dock window's header, and the way to a person under it. */
+.support-desk-panel__nav { padding: 0 4px; gap: 2px; }
+.support-desk-panel__heading { padding: 0 6px; }
+.support-desk-panel__human {
+  flex: none;
+  padding: 0.5rem 0.75rem;
+  border-bottom: 1px solid var(--chats-dock-edge, var(--support-desk-border));
+}
+.support-desk-panel__human .support-desk-notice__title { margin: 0; font-size: 0.8125rem; }
+
+/* Signed out: how to reach the desk. */
+.support-desk-panel__signed-out { gap: 0.75rem; padding: 1rem; }
+.support-desk-panel__lead,
+.support-desk-panel__promise,
+.support-desk-panel__note { margin: 0; }
+.support-desk-panel__lead { font-size: 0.9375rem; font-weight: 600; }
+.support-desk-panel__promise,
+.support-desk-panel__note { color: var(--support-desk-text-muted); }
+.support-desk-panel__note a,
+.support-desk-panel__link { color: inherit; font-weight: 600; }
+
+/* A phone: the sheet fills the screen; fields at 16px, or iOS zooms in. */
+@media (max-width: 699.98px), (max-height: 499.98px) {
+  .support-desk-panel { font-size: 1rem; }
+  .support-desk-panel__wizard .support-desk-form__input { font-size: 16px; }
+}
+
+/* The wall in the panel: its title at the panel's size, room around it. */
+.support-desk-panel__wall { padding-bottom: 1rem; }
+.support-desk-panel__wall .chats-inbox__header { padding: 0.85rem 0.85rem 0.25rem; }
+.support-desk-panel__wall .chats-inbox__title { font-size: 1.05rem; margin: 0; }
+.support-desk-panel__wall :is(.support-desk-notice__title, .support-desk-form) { margin-inline: 0.75rem; padding-inline: 0; }
+.support-desk-panel__wall > .support-desk-button,
+.support-desk-panel__wall .support-desk-button { margin: 0.5rem 0.75rem 0; }

data/app/controllers/support_desk/application_controller.rb

@@ -81,13 +81,29 @@ module SupportDesk
       respond_to?(:chats) ? chats : Chats::Engine.routes.url_helpers
     end
 
+    # Whether this request is the launcher's panel (SupportDesk::Launcher):
+    # then the screens answer with the panel's templates.
+    def support_panel?
+      SupportDesk::Launcher.panel_request?(request)
+    end
+
+    # A screen: +page+ on the page, or, in the launcher's panel, +panel+
+    # inside the panel's frame (layouts/support_desk/panel) and nothing else
+    # of the layout.
+    def render_screen(page, panel: page, **options)
+      return render(page, **options) unless support_panel?
+
+      render panel, layout: "support_desk/panel", **options
+    end
+
     # Where a case is read and answered: its chats conversation, in the
     # chats inbox (`thread_page = :chats`) or on this engine's ticket page
     # (`:support`). Never a second thread UI of our own: that page renders
-    # chats' thread.
+    # chats' thread. In the launcher's panel, always the ticket page, which
+    # answers the panel with the case inside it.
     def conversation_path_for(ticket)
       return root_path if ticket.conversation.nil?
-      return ticket_path(ticket.reference) if SupportDesk.config.support_thread_page?
+      return ticket_path(ticket.reference) if support_panel? || SupportDesk.config.support_thread_page?
 
       chats_routes.conversation_path(ticket.conversation)
     end

data/app/controllers/support_desk/tickets_controller.rb

@@ -32,12 +32,22 @@ module SupportDesk
       @closed_tickets = tickets.closed.newest_first.limit(CLOSED_TICKETS_SHOWN).to_a
       @closed_count = tickets.closed.count
       @unread_counts = unread_counts_for(@open_tickets + @closed_tickets)
+      render_screen :index, panel: "support_desk/panel/home"
     end
 
     # The wizard. One URL, three frames — which one renders is the wizard's
-    # answer, never a param we trust.
+    # answer, never a param we trust. In the launcher's panel, the same step
+    # in the panel's one frame.
     def new
-      render :new
+      render_wizard
+    end
+
+    # The launcher's badge, as the Turbo Stream its own stream would have
+    # sent: chats' tray asks for it when that stream may have missed one.
+    def badge
+      render turbo_stream: turbo_stream.replace(SupportDesk::Launcher::BADGE_ID,
+                                                partial: SupportDesk::Launcher::BADGE_PARTIAL,
+                                                locals: { count: current_requester.unread_support_count })
     end
 
     # Open the case and hand the requester straight to the conversation.
@@ -49,20 +59,20 @@ module SupportDesk
     def create
       if message.blank? && files.empty?
         @error = t("support_desk.wizard.message_required")
-        return render :new, status: :unprocessable_entity
+        return render_wizard(status: :unprocessable_entity)
       end
 
       ticket = @wizard.open!(message, files: files)
       redirect_to conversation_path_for(ticket)
     rescue ActiveRecord::RecordInvalid => e
       @error = e.record.errors.full_messages.to_sentence
-      render :new, status: :unprocessable_entity
+      render_wizard(status: :unprocessable_entity)
     rescue SupportDesk::RateLimited, SupportDesk::TooManyOpenTickets => e
       render_limit_wall(e)
     rescue SupportDesk::InvalidTransition
       # The form was submitted from a step that isn't the composer (a stale
       # tab, a hand-rolled POST): re-render the step they are actually on.
-      render :new, status: :unprocessable_entity
+      render_wizard(status: :unprocessable_entity)
     rescue SupportDesk::NotAllowed, SupportDesk::NotSupportable, SupportDesk::NotARequester
       # The subject passed the wizard's check and failed the model's, or this
       # account stopped being able to write between the form and the submit.
@@ -75,12 +85,14 @@ module SupportDesk
     # to. Under `thread_page = :chats` the case is read in the inbox's thread,
     # so this is a redirect and nothing else. Under `:support` it is the page
     # the case is read on: chats' own thread, with its back link leading
-    # here rather than to an inbox support is not part of.
+    # here rather than to an inbox support is not part of. In the launcher's
+    # panel it is always the case, inside the panel, whatever `thread_page`
+    # says.
     def show
       ticket = find_ticket
-      return redirect_to conversation_path_for(ticket) unless SupportDesk.config.support_thread_page? && ticket.conversation
+      return render_thread(ticket) if ticket.conversation && (support_panel? || SupportDesk.config.support_thread_page?)
 
-      render_thread(ticket)
+      redirect_to conversation_path_for(ticket)
     end
 
     # "Prefiero hablar con una persona." The one thing a requester can
@@ -130,9 +142,21 @@ module SupportDesk
       # reading the case; the visit that follows reads it. Read through the
       # last message on the page, not merely "now": an acknowledgement pinned
       # one tick after the message it answers may sit just ahead of the clock.
-      @participant&.read!(at: [ Time.current, @messages.last&.created_at ].compact.max) unless prefetch_request?
+      #
+      # Not in the launcher's panel: there the thread is the compact one a
+      # dock window renders, and it reads itself once the panel is open and
+      # the requester is with it (chats' read gate, which the tray keeps). A
+      # frame that loads behind a closed panel must not put the badge out.
+      unless prefetch_request? || support_panel?
+        @participant&.read!(at: [ Time.current, @messages.last&.created_at ].compact.max)
+      end
+
+      render_screen :show, panel: "support_desk/panel/case"
+    end
 
-      render :show
+    # The wizard's step: the page's three frames, or the panel's one.
+    def render_wizard(**options)
+      render_screen :new, panel: "support_desk/panel/new", **options
     end
 
     # The case's conversation, as chats' own endpoints would find it: chats'
@@ -199,7 +223,7 @@ module SupportDesk
                                        .includes(:desk, :subject, conversation: { last_message: :sender })
                                        .recent_activity_first.to_a
       @unread_counts = unread_counts_for(@open_tickets)
-      render :rate_limited, status: :too_many_requests
+      render_screen :rate_limited, panel: "support_desk/panel/rate_limited", status: :too_many_requests
     end
 
     # One grouped query for every row's badge (see

data/app/helpers/support_desk/engine_helper.rb

@@ -16,6 +16,14 @@ module SupportDesk
     # Which frame the wizard renders on each of its three steps.
     WIZARD_PARTIALS = { topic: "pick_topic", subject: "pick_thing", compose: "write" }.freeze
 
+    # Who sees the launcher.
+    LAUNCHER_AUDIENCES = %i[signed_in everyone].freeze
+
+    # The launcher panel's slots: a host drops
+    # `app/views/support_desk/slots/_<name>.html.erb` in and it renders there
+    # (gets `requester:`, nil for a visitor who is signed out).
+    SLOTS = %w[panel_top panel_footer].freeze
+
     # The door: "¿Necesitas ayuda con esto?" next to a record, or "Contactar
     # con soporte" on its own.
     #
@@ -70,6 +78,62 @@ module SupportDesk
       render partial: "support_desk/tickets/human_door", locals: { ticket: ticket }
     end
 
+    # The "Need help?" launcher: an item of chats' tray (chats >= 0.7.0),
+    # bottom-right, whose panel is this engine's own screens — their cases,
+    # a new one (the wizard, with the promise), a case's thread — in a frame.
+    #
+    #   <%= chats_dock do %>                    <%# beside the messaging dock's bar %>
+    #     <%= support_launcher %>
+    #   <% end %>
+    #
+    #   <%= support_launcher %>                 <%# no dock: a corner of its own %>
+    #
+    #   show_for:  :signed_in (default) shows it to requesters only;
+    #              :everyone also to visitors who are signed out, whose panel
+    #              says how to reach the desk (sign in, its address, help_url)
+    #   help_url:  the host's public help centre, linked from the panel
+    #
+    # Renders nothing for a visitor who is signed out under :signed_in. The
+    # /support pages stay what they are; the panel is a window onto them.
+    def support_launcher(show_for: :signed_in, help_url: nil)
+      unless LAUNCHER_AUDIENCES.include?(show_for)
+        raise ArgumentError, "support_launcher(show_for:) is one of #{LAUNCHER_AUDIENCES.inspect}, not #{show_for.inspect}"
+      end
+
+      requester = support_desk_requester
+      return if requester.nil? && show_for == :signed_in
+
+      chats_tray { render("support_desk/launcher/launcher", requester: requester, help_url: help_url) }
+    end
+
+    # Whether this render answers the launcher's panel (its frame asked):
+    # the screens then render their panel templates, and links stay inside.
+    def support_panel?
+      SupportDesk::Launcher.panel_request?(respond_to?(:request) ? request : nil)
+    end
+
+    # The frame a link that leaves the current screen targets: the whole page
+    # ("_top"), or, in the launcher's panel, the panel itself (nil: the
+    # nearest frame).
+    #
+    #   link_to "Back", root_path, data: { turbo_frame: support_desk_top_frame }
+    def support_desk_top_frame
+      support_panel? ? nil : "_top"
+    end
+
+    # Render a host's slot partial when it exists (see SLOTS). Absent slots
+    # cost one memoized lookup and render nothing; a name outside SLOTS is
+    # never looked up.
+    def support_desk_slot(name, **locals)
+      key = name.to_s
+      return unless SLOTS.include?(key)
+
+      @support_desk_slots ||= {}
+      @support_desk_slots[key] = lookup_context.exists?("support_desk/slots/#{key}", [], true) unless
+        @support_desk_slots.key?(key)
+      render(partial: "support_desk/slots/#{key}", locals: locals) if @support_desk_slots[key]
+    end
+
     # --- What the bundled views render with -----------------------------------
 
     # The gem's bundled stylesheet, into the host layout's <head> — where a
@@ -177,11 +241,12 @@ module SupportDesk
 
     # Where a case is read and answered: its chats conversation, or the
     # engine's own ticket page under `thread_page = :support` (by reference:
-    # the URL people read back from a screen). Falls back to the ticket URL
-    # (which redirects to the same place) for the one case that has no
-    # conversation yet, so a link is never dead.
+    # the URL people read back from a screen) and in the launcher's panel,
+    # whose ticket page is the case inside the panel. Falls back to the
+    # ticket URL (which redirects to the same place) for the one case that
+    # has no conversation yet, so a link is never dead.
     def support_thread_path(ticket)
-      return support_desk_routes.ticket_path(ticket.reference) if SupportDesk.config.support_thread_page?
+      return support_desk_routes.ticket_path(ticket.reference) if support_panel? || SupportDesk.config.support_thread_page?
       return support_desk_routes.ticket_path(ticket) if ticket.conversation.nil? || !respond_to?(:chats_routes)
 
       chats_routes.conversation_path(ticket.conversation)

data/app/views/layouts/support_desk/panel.html.erb

@@ -0,0 +1,6 @@
+<%# The launcher's panel (SupportDesk::Launcher): a screen answering the
+    panel's frame is the screen inside that frame, and nothing else of the
+    host's layout. Turbo takes the frame's content into the panel. %>
+<%= turbo_frame_tag SupportDesk::Launcher::FRAME do %>
+  <%= yield %>
+<% end %>

data/app/views/support_desk/launcher/_badge.html.erb

@@ -0,0 +1,6 @@
+<%# The launcher's badge: unread messages across the requester's cases
+    (`unread_support_count`), hidden at zero. What their
+    `[requester, :support_desk]` stream replaces (SupportDesk::Launcher, which
+    hands it the requester and lets it count as it renders) and GET
+    tickets/badge answers. Locals: count, or requester. %>
+<%= chats_tray_badge local_assigns.fetch(:count) { requester.unread_support_count }, id: SupportDesk::Launcher::BADGE_ID %>

data/app/views/support_desk/launcher/_icon.html.erb

@@ -0,0 +1,6 @@
+<%# The launcher's icon (a question mark in a circle). Eject this partial to
+    draw your own (an icon set's lifebuoy, your logo). %>
+<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round"
+     stroke-linejoin="round" aria-hidden="true" focusable="false">
+  <path d="M9.879 7.519c1.171-1.025 3.071-1.025 4.242 0 1.172 1.025 1.172 2.687 0 3.712-.203.179-.43.326-.67.442-.745.361-1.45.999-1.45 1.827v.75M21 12a9 9 0 1 1-18 0 9 9 0 0 1 18 0Zm-9 5.25h.008v.008H12v-.008Z"/>
+</svg>

data/app/views/support_desk/launcher/_launcher.html.erb

@@ -0,0 +1,40 @@
+<%# The "Need help?" launcher (`support_launcher`): one item of chats' tray,
+    beside the messaging dock's bar or in a corner of its own. chats draws the
+    tab, the panel's chrome and the phone's sheet, and runs them (one open at
+    a time, Escape, memory, the badge's catch-up); this is what is ours: the
+    words, the icon, the live badge and the panel's content.
+
+    Signed in, the panel is a lazy frame onto this engine's own screens (the
+    list, the wizard, a case), answered with their panel templates
+    (SupportDesk::TicketsController). `data-chats-tray-home`: if the page
+    ever shows the case the panel shows, the panel goes back to the list.
+    `refresh: :morph`: the list reloads in place when the badge moves.
+    Signed out, a short panel says how to reach the desk.
+
+    Locals: requester (nil when signed out), help_url. %>
+<% desk_key = requester ? requester.class.support_desk_key : :default %>
+<% desk = SupportDesk.config.desk(desk_key) %>
+<%= stylesheet_link_tag "support_desk" %>
+<%= chats_tray_item :support,
+      label: t("support_desk.launcher.label"),
+      title: safe_join([ tag.span(desk.name, class: "support-desk-launcher__name"), support_desk_badge(desk_key) ]),
+      icon: render("support_desk/launcher/icon"),
+      badge: (safe_join([ turbo_stream_from(requester, :support_desk),
+                          render("support_desk/launcher/badge", count: requester.unread_support_count) ]) if requester),
+      badge_url: (support_desk_routes.badge_tickets_path if requester) do %>
+  <% if requester %>
+    <%= turbo_frame_tag SupportDesk::Launcher::FRAME,
+          src: support_desk_routes.root_path,
+          loading: :lazy,
+          refresh: :morph,
+          class: "support-desk support-desk-panel",
+          data: { chats_tray_home: support_desk_routes.root_path } do %>
+      <%# Until the frame loads, and for good without JavaScript. %>
+      <p class="support-desk-panel__loading">
+        <%= link_to t("support_desk.launcher.open"), support_desk_routes.root_path, data: { turbo_frame: "_top" } %>
+      </p>
+    <% end %>
+  <% else %>
+    <%= render "support_desk/launcher/signed_out", desk: desk, help_url: help_url %>
+  <% end %>
+<% end %>

data/app/views/support_desk/launcher/_signed_out.html.erb

@@ -0,0 +1,25 @@
+<%# The launcher's panel for a visitor who is signed out
+    (`support_launcher show_for: :everyone`): how to reach the desk. Signing
+    in goes through /support, so the host's own authentication asks for it
+    and brings them back here; the desk's address is for those who can't
+    sign in (often why they need help); the help centre when the host has
+    one. Locals: desk (its configuration), help_url. %>
+<div class="support-desk support-desk-panel support-desk-panel__screen support-desk-panel__signed-out">
+  <%= support_desk_slot :panel_top, requester: nil %>
+
+  <p class="support-desk-panel__lead"><%= t(".lead") %></p>
+  <% if (promise = desk.reply_promise) %>
+    <p class="support-desk-panel__promise"><%= promise %></p>
+  <% end %>
+
+  <%= link_to t(".sign_in"), support_desk_routes.root_path, class: "support-desk-button", data: { turbo_frame: "_top" } %>
+
+  <% if desk.email.present? %>
+    <p class="support-desk-panel__note"><%= t(".email_html", email: mail_to(desk.email)) %></p>
+  <% end %>
+  <% if help_url.present? %>
+    <%= link_to t(".help"), help_url, class: "support-desk-panel__link" %>
+  <% end %>
+
+  <%= support_desk_slot :panel_footer, requester: nil %>
+</div>

data/app/views/support_desk/panel/case.html.erb

@@ -0,0 +1,36 @@
+<%# A case in the launcher's panel (GET /tickets/:id from the panel's
+    frame): chats' own thread body, the compact one a dock window renders
+    (`window: true`: live, read only while the panel is open, the composer at
+    the bottom, the desk's signature on its answers), under the panel's way
+    back to the list and out to the case's page, in a dock window's header
+    classes so the two look alike wherever a host themes them. %>
+<%= render layout: "chats/conversations/thread",
+           locals: {
+             conversation: @conversation,
+             messages: @messages,
+             more: @more_messages,
+             first_unread_id: @first_unread_id,
+             counterpart: chats_counterpart,
+             window: true
+           } do %>
+  <header class="chats-window__header support-desk-panel__nav">
+    <%= link_to support_desk_routes.root_path, class: "chats-window__icon",
+                title: t("support_desk.wizard.back"), "aria-label": t("support_desk.wizard.back") do %>
+      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"
+           stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M19 12H5m6-6-6 6 6 6"/></svg>
+    <% end %>
+    <span class="chats-window__identity support-desk-panel__heading">
+      <span class="chats-window__name"><%= @ticket.label %></span>
+      <span class="chats-window__subject"><%= support_ticket_state(@ticket) %></span>
+    </span>
+    <%= link_to support_desk_routes.ticket_path(@ticket.reference), class: "chats-window__icon",
+                title: t("support_desk.launcher.open_page"), "aria-label": t("support_desk.launcher.open_page"),
+                data: { turbo_frame: "_top" } do %>
+      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"
+           stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M15 3h6v6M9 21H3v-6M21 3l-7 7M3 21l7-7"/></svg>
+    <% end %>
+  </header>
+  <% if (door = support_human_door(@ticket)).present? %>
+    <div class="support-desk-panel__human"><%= door %></div>
+  <% end %>
+<% end %>

data/app/views/support_desk/panel/home.html.erb

@@ -0,0 +1,36 @@
+<%# The launcher's panel, first screen (GET / from the panel's frame): the
+    way to a new case with the promise on it, their open cases as the same
+    rows the page has (each opens in the panel), and the way to the page,
+    where the closed ones are. `data-chats-tray-refresh`: chats' tray reloads
+    this screen (morphed in place) when the launcher's badge moves. %>
+<div class="support-desk-panel__screen" data-chats-tray-refresh>
+  <%= support_desk_slot :panel_top, requester: current_requester %>
+
+  <%= render "support_desk/tickets/door" %>
+
+  <% if @open_tickets.any? %>
+    <%# The dock's own list classes: the same compact rows as its recent list. %>
+    <ul class="chats-inbox__list chats-dock__list">
+      <%= render partial: "support_desk/tickets/ticket_row", collection: @open_tickets, as: :ticket,
+                 locals: { unread_counts: @unread_counts } %>
+    </ul>
+  <% else %>
+    <div class="chats-empty">
+      <p class="chats-empty__title"><%= t("support_desk.tickets.empty_title") %></p>
+      <p class="chats-empty__hint"><%= t("support_desk.tickets.empty_hint") %></p>
+    </div>
+  <% end %>
+
+  <% if @open_tickets.any? || @closed_count.positive? %>
+    <%# The dock's "See all messages", for support. %>
+    <%= link_to support_desk_routes.root_path, class: "chats-dock__see-all support-desk-panel__all",
+                data: { turbo_frame: "_top" } do %>
+      <%= t("support_desk.launcher.all") %>
+      <% if @closed_count.positive? %>
+        <span class="support-desk-panel__count"><%= t("support_desk.tickets.closed_section", count: @closed_count) %></span>
+      <% end %>
+    <% end %>
+  <% end %>
+
+  <%= support_desk_slot :panel_footer, requester: current_requester %>
+</div>

data/app/views/support_desk/panel/new.html.erb

@@ -0,0 +1,8 @@
+<%# The wizard in the launcher's panel (GET /new from the panel's frame):
+    the same step partials as the page, in the panel's one frame instead of
+    the page's `support_wizard` (and never `advance`: the address bar is the
+    host's page). Every step's links navigate the panel; the form posts from
+    it and the new case opens in it. %>
+<div class="support-desk-panel__screen support-desk-panel__wizard">
+  <%= render support_wizard_partial(@wizard), wizard: @wizard, error: @error %>
+</div>

data/app/views/support_desk/panel/rate_limited.html.erb

@@ -0,0 +1,5 @@
+<%# The wall in the launcher's panel: the same content as the page's, in a screen that scrolls
+    inside the panel. %>
+<div class="support-desk-panel__screen support-desk-panel__wall">
+  <%= render "support_desk/tickets/limit_wall" %>
+</div>

data/app/views/support_desk/tickets/_limit_wall.html.erb

@@ -0,0 +1,33 @@
+<%# The wall's content (rate_limited.html.erb on a page, support_desk/panel/rate_limited in the
+    launcher's panel): why, the cases they already have, and what they wrote. %>
+<header class="chats-inbox__header">
+  <h1 class="chats-inbox__title"><%= t("support_desk.limits.#{@limit_reason}_title") %></h1>
+</header>
+
+<p class="support-desk-notice__title">
+  <%= t("support_desk.limits.#{@limit_reason}", count: @open_tickets.size) %>
+</p>
+
+<% if @open_tickets.any? %>
+  <ul class="chats-inbox__list">
+    <%= render partial: "support_desk/tickets/ticket_row",
+               collection: @open_tickets,
+               as: :ticket,
+               locals: { unread_counts: @unread_counts } %>
+  </ul>
+<% end %>
+
+<%# Whatever they had typed comes with them. The wall sends them into a
+    conversation they already have, and the words they just wrote are not
+    ours to throw away — kept on the page to copy rather than pushed
+    through a URL, where it would land in logs and browser history. %>
+<% if params[:message].present? %>
+  <div class="support-desk-form">
+    <p class="support-desk-form__promise"><%= t("support_desk.limits.your_message") %></p>
+    <%= text_area_tag :message, params[:message], rows: 6, readonly: true,
+                      class: "support-desk-form__input", id: "support_desk_kept_message" %>
+  </div>
+<% end %>
+
+<%= link_to t("support_desk.wizard.back_to_list"), support_desk_routes.root_path,
+            class: "support-desk-button" %>

data/app/views/support_desk/tickets/_pick_thing.html.erb

@@ -14,7 +14,7 @@
         <% if open_ticket %>
           <%= link_to support_thread_path(open_ticket),
                       class: "support-desk-choice support-desk-choice--taken",
-                      data: { turbo_frame: "_top" } do %>
+                      data: { turbo_frame: support_desk_top_frame } do %>
             <span class="support-desk-choice__label"><%= record.support_label %></span>
             <span class="support-desk-choice__hint"><%= t("support_desk.wizard.already_open") %> ›</span>
           <% end %>

data/app/views/support_desk/tickets/_pick_topic.html.erb

@@ -25,6 +25,6 @@
   <div class="chats-empty">
     <p class="chats-empty__title"><%= t("support_desk.wizard.no_topics") %></p>
     <%= link_to t("support_desk.wizard.back_to_list"), support_desk_routes.root_path,
-                class: "support-desk-button", data: { turbo_frame: "_top" } %>
+                class: "support-desk-button", data: { turbo_frame: support_desk_top_frame } %>
   </div>
 <% end %>

data/app/views/support_desk/tickets/_wizard_header.html.erb

@@ -10,7 +10,7 @@
     <%= link_to t("support_desk.wizard.back"),
                 support_desk_routes.root_path,
                 class: "support-desk-wizard__back",
-                data: { turbo_frame: "_top" } %>
+                data: { turbo_frame: support_desk_top_frame } %>
   <% end %>
 
   <% if (ask = local_assigns[:ask] || wizard.ask) %>

data/app/views/support_desk/tickets/_write.html.erb

@@ -3,7 +3,8 @@
 
     The form targets `_top`: it POSTs to /tickets and the answer is a
     redirect into the conversation, which must replace the page, not land
-    inside the wizard frame. %>
+    inside the wizard frame. In the launcher's panel it targets the panel
+    (support_desk_top_frame), and the new case opens there. %>
 <%= render "support_desk/tickets/wizard_header", wizard: wizard, error: error,
            ask: t("support_desk.wizard.write") %>
 
@@ -14,7 +15,7 @@
   <div class="support-desk-notice">
     <p class="support-desk-notice__title"><%= t("support_desk.wizard.already_open") %></p>
     <%= link_to t("support_desk.doors.existing"), support_thread_path(existing),
-                class: "support-desk-button", data: { turbo_frame: "_top" } %>
+                class: "support-desk-button", data: { turbo_frame: support_desk_top_frame } %>
   </div>
 <% else %>
   <%= render "support_desk/tickets/context_card", subject: wizard.subject if wizard.subject %>
@@ -23,7 +24,7 @@
                 multipart: true,
                 method: :post,
                 class: "support-desk-form",
-                data: { turbo_frame: "_top" } do %>
+                data: { turbo_frame: support_desk_top_frame } do %>
     <% wizard.state_params.each do |name, value| %>
       <%= hidden_field_tag name, value %>
     <% end %>

data/app/views/support_desk/tickets/rate_limited.html.erb

@@ -6,35 +6,5 @@
 <%= support_desk_styles %>
 
 <div class="chats chats-inbox support-desk">
-  <header class="chats-inbox__header">
-    <h1 class="chats-inbox__title"><%= t("support_desk.limits.#{@limit_reason}_title") %></h1>
-  </header>
-
-  <p class="support-desk-notice__title">
-    <%= t("support_desk.limits.#{@limit_reason}", count: @open_tickets.size) %>
-  </p>
-
-  <% if @open_tickets.any? %>
-    <ul class="chats-inbox__list">
-      <%= render partial: "support_desk/tickets/ticket_row",
-                 collection: @open_tickets,
-                 as: :ticket,
-                 locals: { unread_counts: @unread_counts } %>
-    </ul>
-  <% end %>
-
-  <%# Whatever they had typed comes with them. The wall sends them into a
-      conversation they already have, and the words they just wrote are not
-      ours to throw away — kept on the page to copy rather than pushed
-      through a URL, where it would land in logs and browser history. %>
-  <% if params[:message].present? %>
-    <div class="support-desk-form">
-      <p class="support-desk-form__promise"><%= t("support_desk.limits.your_message") %></p>
-      <%= text_area_tag :message, params[:message], rows: 6, readonly: true,
-                        class: "support-desk-form__input", id: "support_desk_kept_message" %>
-    </div>
-  <% end %>
-
-  <%= link_to t("support_desk.wizard.back_to_list"), support_desk_routes.root_path,
-              class: "support-desk-button" %>
+  <%= render "support_desk/tickets/limit_wall" %>
 </div>

data/config/locales/support_desk.en.yml

@@ -93,6 +93,16 @@ en:
       about: "Need help with %{subject}?"
       existing: "See your support conversation"
       new_conversation: "Start a new conversation"
+    launcher:
+      label: "Need help?"
+      open: "Open support"
+      all: "All your conversations"
+      open_page: "Open in a page"
+      signed_out:
+        lead: "Sign in and write to us: your conversations with us are kept in your account."
+        sign_in: "Sign in to write to us"
+        email_html: "Can't sign in? Write to %{email}."
+        help: "Visit the help centre"
     inbox:
       empty_hint: "Need help? Write to us"
     limits:

data/config/locales/support_desk.es.yml

@@ -109,6 +109,16 @@ es:
       about: "¿Necesitas ayuda con %{subject}?"
       existing: "Ver tu conversación de soporte"
       new_conversation: "Abrir una nueva conversación"
+    launcher:
+      label: "¿Necesitas ayuda?"
+      open: "Abrir soporte"
+      all: "Todas tus conversaciones"
+      open_page: "Abrir en una página"
+      signed_out:
+        lead: "Inicia sesión y escríbenos: tus conversaciones con nosotros se guardan en tu cuenta."
+        sign_in: "Inicia sesión para escribirnos"
+        email_html: "¿No puedes iniciar sesión? Escribe a %{email}."
+        help: "Visita el centro de ayuda"
     inbox:
       empty_hint: "¿Necesitas ayuda? Escríbenos"
     limits:

data/config/routes.rb

@@ -19,6 +19,10 @@ SupportDesk::Engine.routes.draw do
   # for emails and notifications, that never has to know where chats is
   # mounted.
   resources :tickets, only: %i[create show] do
+    # The launcher's badge, as a Turbo Stream: what its stream missed
+    # (a reconnect, a return to the tab), asked again by chats' tray.
+    get :badge, on: :collection
+
     # The door out of a machine. It is a POST on the CASE rather than
     # anything to do with chats, because it is a fact about the case: from
     # here on a person is expected, whatever the assistant would have done

data/lib/generators/support_desk/views_generator.rb

@@ -23,15 +23,21 @@ module SupportDesk
 
       # Which groups to eject. `tickets` is every requester screen (the list,
       # the wizard's three frames, the rows and the doors); `slots` is the
-      # row this engine contributes to chats' inbox.
+      # row this engine contributes to chats' inbox; `launcher` is the
+      # "Need help?" launcher (its tab, badge, icon and signed-out panel) and
+      # the screens its panel shows.
       class_option :views,
                    type: :array,
-                   default: %w[tickets slots],
-                   desc: "Which view groups to copy (tickets, slots)"
+                   default: %w[tickets slots launcher],
+                   desc: "Which view groups to copy (tickets, slots, launcher)"
 
       def copy_views
         directory "support_desk/tickets", "app/views/support_desk/tickets" if include?("tickets")
         directory "chats/slots", "app/views/chats/slots" if include?("slots")
+        return unless include?("launcher")
+
+        directory "support_desk/launcher", "app/views/support_desk/launcher"
+        directory "support_desk/panel", "app/views/support_desk/panel"
       end
 
       def show_styling_tip

data/lib/support_desk/launcher.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module SupportDesk
+  # The "Need help?" launcher (`support_launcher`): an item of chats' tray
+  # (chats >= 0.7.0), beside the messaging dock's bar or in a corner of its
+  # own, whose panel is this engine's own pages in a frame.
+  #
+  # This module is the launcher's two names and its live badge:
+  #
+  #   FRAME     the panel's turbo frame. A request that carries it
+  #             (`Turbo-Frame: support_desk_panel`) is answered with the
+  #             panel's templates (SupportDesk::TicketsController).
+  #   BADGE_ID  the badge the requester's `[requester, :support_desk]`
+  #             stream replaces.
+  #
+  # The badge is `requester.unread_support_count`: unread messages across
+  # their own cases, against chats' read horizon, with no listing scope. It
+  # never touches the Messages badge, which counts `messager.chats` (the
+  # host's inbox_scope applied). It moves wherever chats says an unread count
+  # may have moved (`Chats.on(:unread_changed)`: every message, the case's
+  # own notices included, and a read), for a conversation that is a case's.
+  module Launcher
+    FRAME = "support_desk_panel"
+    BADGE_ID = "support_desk_launcher_badge"
+    BADGE_PARTIAL = "support_desk/launcher/badge"
+
+    class << self
+      # Whether +request+ is the panel's: its frame asked for it. Then the
+      # requester's screens answer with the panel's templates, every link
+      # stays inside it, and a new case opens in it.
+      def panel_request?(request)
+        request&.headers&.[]("Turbo-Frame") == FRAME
+      end
+
+      # chats' `:unread_changed`, filtered to support: a case's conversation
+      # (its subject is the ticket, no query needed) and a seat that asks
+      # for help (a requester; a desk or an agent's console has no launcher).
+      def unread_changed(messager, conversation)
+        return unless conversation&.subject_type == SupportDesk::Ticket.polymorphic_name
+        return unless messager.respond_to?(:unread_support_count)
+
+        broadcast_badge_of(messager)
+      end
+
+      # Replace +requester+'s launcher badge, wherever it is on screen: one
+      # job, which counts when it renders (nothing is counted in the request
+      # that wrote the message). A missed one heals on the launcher's
+      # catch-up (GET tickets/badge).
+      #
+      # It runs whether or not this host renders a launcher: there is no
+      # telling, from a job, whether anybody is listening, and a switch for it
+      # would let a launcher's badge silently never move. Support is
+      # human-paced, so this is one small job per message in a case.
+      def broadcast_badge_of(requester)
+        Turbo::StreamsChannel.broadcast_replace_later_to(
+          requester, :support_desk,
+          target: BADGE_ID,
+          partial: BADGE_PARTIAL,
+          locals: { requester: requester }
+        )
+      end
+    end
+  end
+end

data/lib/support_desk/models/concerns/requester.rb

@@ -93,9 +93,13 @@ module SupportDesk
     end
 
     # Unread messages across every support conversation this requester has,
-    # counted against the chats read horizon — the number for a nav badge.
+    # counted against the chats read horizon — the number for a nav badge
+    # and the launcher's. Counted through the cases they can open
+    # (Ticket.conversations_of: their seat still there, the same scope the
+    # case page and chats' lookup use), so the badge never counts a case that
+    # would 404.
     def unread_support_count
-      conversation_ids = support_tickets.where.not(conversation_id: nil).distinct.pluck(:conversation_id)
+      conversation_ids = SupportDesk::Ticket.conversations_of(self).reorder(nil).distinct.pluck(:id)
       return 0 if conversation_ids.empty?
 
       Chats::Conversation.unread_counts_for(self, conversation_ids).values.sum

data/lib/support_desk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SupportDesk
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/support_desk.rb

@@ -330,9 +330,11 @@ module SupportDesk
 
     # --- The chats seam -------------------------------------------------------------
 
-    # Subscribe the gem's own `:message_created` listener, which is what
+    # Subscribe the gem's own chats listeners: `:message_created`, which is what
     # keeps `awaiting`, the SLA clocks and reopen-on-reply true without
-    # anybody remembering to call anything.
+    # anybody remembering to call anything, and `:unread_changed`, which
+    # keeps the launcher's badge live.
+
     #
     # Safe to call as often as you like: chats replaces a subscriber
     # registered under the same `key:` rather than stacking another one.
@@ -346,6 +348,11 @@ module SupportDesk
         # the Ticket class is a new object after each reload.
         SupportDesk::Ticket.for_conversation(message.conversation)&.register!(message)
       end
+      # The launcher's badge (chats >= 0.7.0): wherever an unread count in a
+      # case's conversation may have moved, the case's own notices included.
+      Chats.on(:unread_changed, key: :support_desk_launcher) do |messager:, conversation:|
+        SupportDesk::Launcher.unread_changed(messager, conversation)
+      end
       self
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: support_desk
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - rameerez
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-18 00:00:00.000000000 Z
+date: 2026-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -56,7 +56,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.1
+        version: 0.7.1
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -66,7 +66,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.1
+        version: 0.7.1
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -147,6 +147,7 @@ files:
 - app/helpers/support_desk/thread_helper.rb
 - app/views/chats/slots/_inbox_top.html.erb
 - app/views/chats/slots/_locked_composer.html.erb
+- app/views/layouts/support_desk/panel.html.erb
 - app/views/support_desk/console/tickets/_actions.html.erb
 - app/views/support_desk/console/tickets/_assignment.html.erb
 - app/views/support_desk/console/tickets/_composer.html.erb
@@ -162,9 +163,18 @@ files:
 - app/views/support_desk/console/tickets/index.html.erb
 - app/views/support_desk/console/tickets/new.html.erb
 - app/views/support_desk/console/tickets/show.html.erb
+- app/views/support_desk/launcher/_badge.html.erb
+- app/views/support_desk/launcher/_icon.html.erb
+- app/views/support_desk/launcher/_launcher.html.erb
+- app/views/support_desk/launcher/_signed_out.html.erb
+- app/views/support_desk/panel/case.html.erb
+- app/views/support_desk/panel/home.html.erb
+- app/views/support_desk/panel/new.html.erb
+- app/views/support_desk/panel/rate_limited.html.erb
 - app/views/support_desk/tickets/_context_card.html.erb
 - app/views/support_desk/tickets/_door.html.erb
 - app/views/support_desk/tickets/_human_door.html.erb
+- app/views/support_desk/tickets/_limit_wall.html.erb
 - app/views/support_desk/tickets/_pick_thing.html.erb
 - app/views/support_desk/tickets/_pick_topic.html.erb
 - app/views/support_desk/tickets/_ticket_row.html.erb
@@ -213,6 +223,7 @@ files:
 - lib/support_desk/engine.rb
 - lib/support_desk/errors.rb
 - lib/support_desk/events.rb
+- lib/support_desk/launcher.rb
 - lib/support_desk/macros.rb
 - lib/support_desk/message_signatures.rb
 - lib/support_desk/models/application_record.rb