samagotchi 0.153.0 → 0.154.1

data/lib/samagotchi/worker.rb

@@ -14,6 +14,7 @@ require_relative "turn_note"
 require_relative "steer"
 require_relative "turn_origin"
 require_relative "worker_idle_exit"
+require_relative "degrade"
 require_relative "hold_stop"
 require_relative "children_status"
 require_relative "worker_wakes"
@@ -51,7 +52,7 @@ module Samagotchi
   # It runs the session's Engine and Bridge, takes queued prompts from the
   # input dir one turn at a time, and returns when nobody has used it for the
   # idle-exit timeout. A failed turn is rolled back and its prompt handed back
-  # (:prompt_restored), as in the REPL, and the loop goes on. A stop marked on
+  # (:prompt_restored), and the loop goes on. A stop marked on
   # disk exits the process; an error outside a turn marks the session and
   # exits with 1.
   #
@@ -188,6 +189,10 @@ module Samagotchi
     # checks again then).
     def discard? = @discard
 
+    # Whether this worker runs a `chi scratch` session: deleted as it leaves
+    # (SessionManager.run_session_loop).
+    def scratch? = !!@session&.scratch
+
     # Whether delegate reports wait that an idle parent runs a turn for
     # (#wake_state): SessionManager.run_session_loop starts a new worker
     # for them after this one leaves. Reports the budget or a failure held
@@ -201,8 +206,9 @@ module Samagotchi
     #   to exit (Bridge POST /exit), :restart when it asked for a restart
     #   (the caller starts a new worker), :stopped when the session was stopped
     #   (chi stop), :signal when a signal stopped it (WorkerSignals),
-    #   :crashed when the loop raised (the session is marked errored);
-    #   SessionManager.run_session_loop turns it into the exit
+    #   :crashed when the loop raised (the session is marked errored),
+    #   :scratch_left when a scratch session's terminal is gone (the caller
+    #   deletes it); SessionManager.run_session_loop turns it into the exit
     def run
       # The thread a signal's expired grace raises in (the main thread in a
       # worker process).
@@ -248,6 +254,8 @@ module Samagotchi
     # The session, its Engine and what runs its turns, before anyone can
     # reach it.
     def start
+      # A scratch worker's grace for its terminal's first stream counts from here.
+      @started_at = monotonic_now
       # The wake turns' budget (delegate reports, attached context, peers), from now.
       @wakes = WorkerWakes.new(grace: WAKE_START_GRACE)
       # This worker holds the session now (a continue's starting marker held
@@ -340,7 +348,7 @@ module Samagotchi
                                      @bridge.queue_command(line, client_id: client_id, after_file: after_file,
                                                                  enqueued_id: enqueued_id, author: author)
                                    })
-      # /model's default is the config's, as in the REPL; the Engine started
+      # /model's default is the config's; the Engine started
       # on the session's model.  nil when there is no default.model.
       @default_model = ModelProfile.default_model_name
       @commands = SessionCommands.new(engine: @engine, turn_flow: @turn_flow,
@@ -416,6 +424,31 @@ module Samagotchi
       @context_poller = ContextPoller.new(session_id: @session_id, state_dir: @state_dir,
                                           project_root: @session.project_root, cwd: @session.working_directory,
                                           on_change: -> { @waker.wake }).start
+      @scratch_watch = start_scratch_watch if @session.scratch
+    end
+
+    # A scratch session's turn never runs on with no terminal: a turn
+    # waiting on a question or an approval would keep the worker up for
+    # nobody. Each tick while a turn runs and its terminal is gone
+    # (#scratch_unattended?), the question is dropped and the turn
+    # cancelled as a stop cancels it; the idle pass then leaves
+    # (:scratch_left) and the session is deleted.
+    def start_scratch_watch
+      Thread.new do
+        loop do
+          sleep(@poll_interval)
+          Degrade.call(:worker, "scratch_watch_failed") { cancel_unattended_turn }
+        end
+      end.tap { |thread| thread.report_on_exception = false }
+    end
+
+    def cancel_unattended_turn
+      return unless @engine.turn_running? && scratch_unattended?
+
+      Log.info(:worker, "scratch_turn_cancelled", sid: @session_id)
+      @engine.cancel_question(SessionManager::STOP_CANCEL_REASON) if @engine.pending_question
+      @engine.cancel_current_turn!(SessionManager::STOP_CANCEL_REASON.to_sym)
+      @waker.wake
     end
 
     # One pass of the loop: the first work found runs (queued commands, a
@@ -468,6 +501,7 @@ module Samagotchi
       return if run_wake_turn
       return if run_task_wake
       return if run_due_reminders
+      return left(:scratch_left) if scratch_unattended? && !@engine.turn_running? && leave_scratch
       return left(:idle_exit) if @idle_exit.due? && leave_idle
 
       leaving = @exit_requested && leave_on_request
@@ -553,6 +587,7 @@ module Samagotchi
     TEARDOWN_LEAVE_WAIT = 10
 
     def teardown
+      @scratch_watch&.kill
       @config_restart_unsubscribe&.call
       @context_poller&.stop
       drop_queued_commands
@@ -571,6 +606,8 @@ module Samagotchi
       engine = nil
       engine = Samagotchi::Engine.new(
         model_name: @session.model_name,
+        # `chi scratch`: no memory_write, no delegates, approvals in memory.
+        scratch: @session.scratch,
         model_typed: @session.model_typed,
         # The session's --memory and --mute lists: the same prompt on every
         # (re)spawn.
@@ -783,7 +820,7 @@ module Samagotchi
     end
 
     # A participant's cap in dollars: their own, else the config's.
-    def participant_cap(entry) = entry&.cap.is_a?(Numeric) ? entry.cap.to_f : Web::Grants.default_cap
+    def participant_cap(entry) = entry&.cap.is_a?(Numeric) ? entry.cap.to_f : Grants.default_cap
 
     # A participant's cleaned name, else their id.
     def participant_label(author, name)
@@ -830,7 +867,7 @@ module Samagotchi
       nil
     end
 
-    # A due reminder runs as a continue turn, as in the REPL: Engine#run_turn
+    # A due reminder runs as a continue turn: Engine#run_turn
     # injects the reminders as a tail system message, and no user message is
     # added. A prompt's turn may have injected them already (a stale latch):
     # then there is nothing to run.
@@ -1414,7 +1451,7 @@ module Samagotchi
     # WorkerInbound.save_or_log: a failed save between turns is logged.
     def save_or_log(at, &) = WorkerInbound.save_or_log(at, &)
 
-    # Back to the conversation before the failed turn, as the REPL does (so
+    # Back to the conversation before the failed turn (so
     # failed prompts don't pile up as consecutive user messages), and each
     # prompt it took (its own and any merged into it) goes back to its
     # sender, who can send it again. The rollback and the announcements are
@@ -1559,6 +1596,60 @@ module Samagotchi
       end
     end
 
+    # How long a scratch worker waits for its terminal's first stream
+    # (AttachLauncher attaches within BRIDGE_WAIT of the spawn).
+    SCRATCH_JOIN_GRACE = 30
+
+    # How long a scratch worker's terminal may have no stream open, after
+    # it had one, before it counts as gone: twice the attached terminal's
+    # whole reconnect ladder (TerminalUI::LocalLink#reconnect_delays), so
+    # a reconnect gap (a dropped stream, a slow worker) never reads as a
+    # terminal that left.
+    SCRATCH_GONE_AFTER = 2 * BridgeClient::EventStream::REDISCOVER_DELAYS.sum
+
+    # Whether this is a `chi scratch` session's worker whose terminal is
+    # gone: no terminal stream (a tui: client id's) open for
+    # SCRATCH_GONE_AFTER, after a stream was (a killed TUI's closes as its
+    # writer reads the hang-up), or none came within SCRATCH_JOIN_GRACE.
+    # Any other stream (a web tab's, which chi web refuses for a scratch
+    # session anyway) never keeps it. Its terminal deletes it on every way
+    # out it sees; this is for the ones it doesn't (kill -9, a closed
+    # terminal window).
+    def scratch_unattended?
+      return false unless @session&.scratch && @bridge
+
+      if @bridge.open_streams_of(ClientId::TUI_PREFIX).positive?
+        @unattended_since = nil
+        return false
+      end
+      return monotonic_now - @started_at >= SCRATCH_JOIN_GRACE unless @bridge.streams_served.positive?
+
+      # Set by the first look (the scratch watch or the idle pass) that
+      # finds no stream; a stream back resets it above.
+      @unattended_since ||= monotonic_now
+      monotonic_now - @unattended_since >= SCRATCH_GONE_AFTER
+    end
+
+    def monotonic_now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+
+    # #leave_idle for a scratch worker its terminal left: checked again with
+    # the event log held, then the intake closes. The session is deleted
+    # once the lock is free (SessionManager.run_session_loop: :scratch_left).
+    # @return [Boolean] false when a client came back since
+    def leave_scratch
+      stop_bridge_after do
+        @engine.synchronize_events do
+          # A turn still running is the scratch watch's to cancel first.
+          next false unless scratch_unattended? && !@engine.turn_running?
+
+          @bridge&.close_intake
+          @engine.stop_idle(join: false)
+          Log.info(:worker, "scratch_left", served: @bridge.streams_served)
+          true
+        end
+      end
+    end
+
     # Check again with the event log held, which the Bridge holds while it
     # queues a POST /turn, then close the Bridge's intake so no client can
     # queue one after the check, and stop the idle jobs (reminder callback,
@@ -1694,6 +1785,9 @@ module Samagotchi
     # @return [WorkerIdleExit::Hold, nil]
     def exit_hold(client_id, kind:, stop:, ask:)
       if kind == :restart
+        # A scratch session's worker ends with its terminal: never restarted.
+        return WorkerIdleExit::Hold.new(reason: :scratch) if @session.scratch
+
         hold = @idle_exit.hold_for_restart
         return hold && WorkerIdleExit::Hold.new(reason: hold)
       end
@@ -1792,7 +1886,7 @@ module Samagotchi
     # A restart keeps even an empty session (a new worker takes it over at
     # once) and leaves the recap to the conversation's next real pause.
     def left(result)
-      deleting = result == :exit_requested && @exit_deletes
+      deleting = (result == :exit_requested && @exit_deletes) || result == :scratch_left
       # The attached context goes with this process: a change that landed after
       # the leaving pass looked at it has no later pass to note it, so note it
       # here (no wake turn: the worker is on its way out). Not into a session
@@ -1805,7 +1899,7 @@ module Samagotchi
       # session /exit --delete deletes next: its save could land after the
       # delete and write the session back.
       @task_wakes.absorb unless deleting
-      return result if result == :restart
+      return result if %i[restart scratch_left].include?(result)
 
       @discard = empty_session?
       write_recap_on_leave unless @discard || deleting

data/lib/samagotchi/worker_link.rb

@@ -23,9 +23,9 @@ module Samagotchi
   #   past START_LIMIT without one;
   # - Leaving: the worker closed its Bridge and holds the lock for its last work;
   # - Skew: a worker whose sidecar speaks a newer PROTOCOL than this chi;
-  # - Stale: a sidecar, but the lock is free (or a chi REPL holds it, which
+  # - Stale: a sidecar, but the lock is free (or a one-turn chi run holds it, which
   #   writes none): its worker died;
-  # - None: no worker and no sidecar, or a chi REPL.
+  # - None: no worker and no sidecar, or a one-turn chi run.
   # A kernel releases a dead worker's lock, so a free lock is the proof of
   # death a TCP probe never gave (a port can be reused by another session's
   # Bridge).
@@ -80,7 +80,7 @@ module Samagotchi
     end
 
     # No worker: no sidecar in the session folder, and no worker's lock (a
-    # chi REPL's, +owner+, is no worker's).
+    # one-turn chi run's, +owner+, is no worker's).
     None = Data.define(:owner) do
       def initialize(owner: nil) = super
 

data/lib/samagotchi/working_set_command.rb

@@ -3,6 +3,7 @@
 require_relative "working_set"
 require_relative "working_set_steer"
 require_relative "tools/memory"
+require_relative "session"
 
 module Samagotchi
   # /working-set: with no arguments the session's working set (WorkingSet,
@@ -50,7 +51,7 @@ module Samagotchi
       return [listing, [], :ok] if verb.nil?
       raise ArgumentError, USAGE unless VERBS.include?(verb) && !words.empty?
 
-      session = @engine.session or raise ArgumentError, "no session yet"
+      session = @engine.session or raise ArgumentError, Session::NONE_YET
       cwd = session.working_directory
       strategy = @engine.working_set_strategy
       messages = @engine.clone_messages(session.messages)
@@ -79,7 +80,7 @@ module Samagotchi
     # The set under the strategy the next turn runs, and the pending ops.
     def listing
       session = @engine.session
-      return "no session yet" unless session
+      return Session::NONE_YET unless session
 
       messages = Array(session.messages)
       items = WorkingSet.build(messages, cwd: session.working_directory, strategy: @engine.working_set_strategy,

data/lib/samagotchi.rb

@@ -7,7 +7,6 @@ require_relative "samagotchi/prompt"
 require_relative "samagotchi/client"
 require_relative "samagotchi/debug_log"
 require_relative "samagotchi/delivery"
-require_relative "samagotchi/pending_input_queue"
 require_relative "samagotchi/kernel_loop"
 require_relative "samagotchi/session"
 require_relative "samagotchi/terminal_ui"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: samagotchi
 version: !ruby/object:Gem::Version
-  version: 0.153.0
+  version: 0.154.1
 platform: ruby
 authors:
 - Dmitry Dedov
@@ -185,6 +185,7 @@ files:
 - lib/samagotchi/answer_display.rb
 - lib/samagotchi/answer_refs.rb
 - lib/samagotchi/answer_tail.rb
+- lib/samagotchi/answer_text.rb
 - lib/samagotchi/archive_store.rb
 - lib/samagotchi/atomic_file.rb
 - lib/samagotchi/block_renderers.rb
@@ -335,6 +336,7 @@ files:
 - lib/samagotchi/cut.rb
 - lib/samagotchi/cut_policy.rb
 - lib/samagotchi/debug_log.rb
+- lib/samagotchi/degrade.rb
 - lib/samagotchi/delivery.rb
 - lib/samagotchi/desktop.rb
 - lib/samagotchi/desktop/macos.rb
@@ -356,6 +358,26 @@ files:
 - lib/samagotchi/effective_model.rb
 - lib/samagotchi/empty_answer_retry.rb
 - lib/samagotchi/engine.rb
+- lib/samagotchi/engine/cards.rb
+- lib/samagotchi/engine/context_judge.rb
+- lib/samagotchi/engine/events.rb
+- lib/samagotchi/engine/guardrails.rb
+- lib/samagotchi/engine/hooks.rb
+- lib/samagotchi/engine/messages.rb
+- lib/samagotchi/engine/model_settings.rb
+- lib/samagotchi/engine/models.rb
+- lib/samagotchi/engine/objectives.rb
+- lib/samagotchi/engine/participants.rb
+- lib/samagotchi/engine/plugins.rb
+- lib/samagotchi/engine/questions.rb
+- lib/samagotchi/engine/recap.rb
+- lib/samagotchi/engine/session.rb
+- lib/samagotchi/engine/side_requests.rb
+- lib/samagotchi/engine/steering.rb
+- lib/samagotchi/engine/toolkit.rb
+- lib/samagotchi/engine/turn_end.rb
+- lib/samagotchi/engine/turn_helpers.rb
+- lib/samagotchi/engine/verify.rb
 - lib/samagotchi/engine_peers.rb
 - lib/samagotchi/engine_snapshots.rb
 - lib/samagotchi/event_fanout.rb
@@ -367,6 +389,7 @@ files:
 - lib/samagotchi/generation_phase.rb
 - lib/samagotchi/git_env.rb
 - lib/samagotchi/git_head.rb
+- lib/samagotchi/grants.rb
 - lib/samagotchi/guardrail_wiring.rb
 - lib/samagotchi/guardrails.rb
 - lib/samagotchi/guardrails/approval.rb
@@ -526,11 +549,13 @@ files:
 - lib/samagotchi/objectives_audit.rb
 - lib/samagotchi/objectives_check.rb
 - lib/samagotchi/objectives_command.rb
+- lib/samagotchi/objectives_edit.rb
 - lib/samagotchi/output_formatter.rb
 - lib/samagotchi/owner_lock.rb
 - lib/samagotchi/owner_prompt.rb
 - lib/samagotchi/parent_answers_command.rb
 - lib/samagotchi/parent_report.rb
+- lib/samagotchi/participant_exposure.rb
 - lib/samagotchi/participant_messages.rb
 - lib/samagotchi/participant_mode.rb
 - lib/samagotchi/participant_name.rb
@@ -538,7 +563,6 @@ files:
 - lib/samagotchi/participants_watch.rb
 - lib/samagotchi/paths.rb
 - lib/samagotchi/peer_sources.rb
-- lib/samagotchi/pending_input_queue.rb
 - lib/samagotchi/pending_question.rb
 - lib/samagotchi/plugin/api.rb
 - lib/samagotchi/plugin/attached_context.rb
@@ -557,6 +581,7 @@ files:
 - lib/samagotchi/plugin/tool_spec.rb
 - lib/samagotchi/plugin_session_state.rb
 - lib/samagotchi/plugin_tasks.rb
+- lib/samagotchi/private_files.rb
 - lib/samagotchi/process_group.rb
 - lib/samagotchi/project_env.rb
 - lib/samagotchi/project_scope.rb
@@ -578,6 +603,7 @@ files:
 - lib/samagotchi/recap_setup.rb
 - lib/samagotchi/recap_store.rb
 - lib/samagotchi/recap_title.rb
+- lib/samagotchi/redact.rb
 - lib/samagotchi/redacted_inspect.rb
 - lib/samagotchi/ref.rb
 - lib/samagotchi/relay.rb
@@ -643,6 +669,7 @@ files:
 - lib/samagotchi/steer.rb
 - lib/samagotchi/steer_cut.rb
 - lib/samagotchi/steer_cut_after.rb
+- lib/samagotchi/stream_event.rb
 - lib/samagotchi/system_one.rb
 - lib/samagotchi/system_one/answer.rb
 - lib/samagotchi/system_one/approval_label.rb
@@ -674,7 +701,6 @@ files:
 - lib/samagotchi/terminal_ui/attached_loop/queueing.rb
 - lib/samagotchi/terminal_ui/attached_loop/sending.rb
 - lib/samagotchi/terminal_ui/attached_view.rb
-- lib/samagotchi/terminal_ui/between_turns.rb
 - lib/samagotchi/terminal_ui/event_renderer.rb
 - lib/samagotchi/terminal_ui/exit_lines.rb
 - lib/samagotchi/terminal_ui/formatting.rb
@@ -685,6 +711,7 @@ files:
 - lib/samagotchi/terminal_ui/line_reader.rb
 - lib/samagotchi/terminal_ui/live_region.rb
 - lib/samagotchi/terminal_ui/local_link.rb
+- lib/samagotchi/terminal_ui/log_tail.rb
 - lib/samagotchi/terminal_ui/model_segments_text.rb
 - lib/samagotchi/terminal_ui/one_shot_sink.rb
 - lib/samagotchi/terminal_ui/own_turns.rb
@@ -696,7 +723,6 @@ files:
 - lib/samagotchi/terminal_ui/reline_seam.rb
 - lib/samagotchi/terminal_ui/remote_connector.rb
 - lib/samagotchi/terminal_ui/remote_link.rb
-- lib/samagotchi/terminal_ui/repl_input.rb
 - lib/samagotchi/terminal_ui/screen.rb
 - lib/samagotchi/terminal_ui/status_row.rb
 - lib/samagotchi/terminal_ui/surface.rb
@@ -810,20 +836,17 @@ files:
 - lib/samagotchi/web/block_renderer_routes.rb
 - lib/samagotchi/web/capabilities.rb
 - lib/samagotchi/web/editor.rb
-- lib/samagotchi/web/grants.rb
 - lib/samagotchi/web/info_probe.rb
 - lib/samagotchi/web/lan.rb
 - lib/samagotchi/web/link_codes.rb
 - lib/samagotchi/web/markdown_renderer.rb
 - lib/samagotchi/web/message_display.rb
 - lib/samagotchi/web/participant_access.rb
-- lib/samagotchi/web/participant_exposure.rb
 - lib/samagotchi/web/participant_review.rb
 - lib/samagotchi/web/participant_stream_filter.rb
 - lib/samagotchi/web/participant_view.rb
 - lib/samagotchi/web/participants_admin.rb
 - lib/samagotchi/web/principal.rb
-- lib/samagotchi/web/private_files.rb
 - lib/samagotchi/web/project_list.rb
 - lib/samagotchi/web/proxy_gate.rb
 - lib/samagotchi/web/public/activity.js
@@ -844,6 +867,7 @@ files:
 - lib/samagotchi/web/public/block_source.js
 - lib/samagotchi/web/public/bubbles.js
 - lib/samagotchi/web/public/card.js
+- lib/samagotchi/web/public/card_stamps.js
 - lib/samagotchi/web/public/cards_place.js
 - lib/samagotchi/web/public/chains.js
 - lib/samagotchi/web/public/chip_popover.js

data/lib/samagotchi/pending_input_queue.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-module Samagotchi
-  # Thread-safe FIFO of user steering messages submitted while a turn is
-  # running. UIs (TUI, web, background workers) are push-only producers;
-  # KernelLoop drains the queue at iteration boundaries and injects the
-  # messages into the conversation. True mid-stream injection is impossible
-  # with llama.cpp's /completion API, so draining only happens between full
-  # LLM responses / tool dispatches.
-  #
-  # Usage:
-  #   queue = PendingInputQueue.new
-  #   queue.push("please also check the specs")
-  #   kernel.run(messages, pending_input: queue.method(:drain))
-  class PendingInputQueue
-    def initialize
-      @mutex = Mutex.new
-      @messages = []
-    end
-
-    # Append a message to the queue. Nil/empty strings are ignored.
-    # +seq+ is the sender's own order number for it (the REPL numbers every
-    # line it takes during a turn, so its leftovers keep send order across
-    # this queue and its after-turn list: #drain_entries).
-    def push(text, seq: nil)
-      text = text.to_s
-      return if text.empty?
-
-      @mutex.synchronize { @messages << [seq, text] }
-      nil
-    end
-
-    # Remove and return all queued messages in FIFO order. Non-blocking.
-    # @return [Array<String>]
-    def drain = drain_entries.map(&:last)
-
-    # #drain with each message's +seq+ (nil when pushed without one).
-    # @return [Array(Integer|nil, String)]
-    def drain_entries
-      @mutex.synchronize do
-        drained = @messages
-        @messages = []
-        drained
-      end
-    end
-
-    def empty?
-      @mutex.synchronize { @messages.empty? }
-    end
-
-    def size
-      @mutex.synchronize { @messages.size }
-    end
-  end
-end

data/lib/samagotchi/terminal_ui/between_turns.rb

@@ -1,138 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "formatting"
-require_relative "event_renderer"
-
-module Samagotchi
-  class TerminalUI
-    # What the REPL prints between turns: cards and plugins' notices shown
-    # outside a turn, anytime commands' output, plugins' init lines and load
-    # warnings, and a recap written while idle.
-    #
-    # They are announced on other threads (the Engine's observers, the idle
-    # scheduler, an anytime command's own), where they are only kept; the
-    # main thread prints them at the open prompt (#flush_recap,
-    # #flush_cards), after the command that showed them. One that comes
-    # while a turn runs prints at once (above the live region) where the
-    # turn wouldn't print it itself.
-    class BetweenTurns
-      include Formatting
-
-      # A plugin's init task and a load warning: shown between turns too.
-      INIT_EVENTS = %i[plugin_init_started plugin_init_finished guardrail_warning].freeze
-
-      # @param surface [Surface] where lines print (swapped with #surface=)
-      # @param view [AttachedView] turns the activity row for init tasks
-      # @param renderer [EventRenderer] draws cards
-      # @param turn_running [#call] whether a turn runs now
-      # @param quiet [Boolean] a --non-interactive run: no init lines
-      # @param gaps [GapClock, nil] the session's last activity: a recap
-      #   after a quiet gap has its divider
-      def initialize(surface:, view:, renderer:, turn_running:, quiet: false, gaps: nil)
-        @surface = surface
-        @view = view
-        @renderer = renderer
-        @turn_running = turn_running
-        @quiet = quiet
-        @cards = Queue.new
-        @recap = nil
-        @gaps = gaps
-      end
-
-      attr_writer :surface
-
-      # The Engine's observer for cards, notices and init events (any
-      # thread). A card or a plugin's notice shown outside a turn is kept
-      # for the next flush; one shown during a turn is a turn event, the
-      # turn's sink prints it where it happens (EventRenderer).
-      #
-      # An anytime command's (event[:anytime]) print as it shows them: on
-      # the main thread (the command runs at the prompt) or beside a running
-      # turn, else at the next flush.
-      #
-      # A plugin's init task (chi.init) turns the activity row while it runs
-      # and prints a line when it is done; a load warning announced before
-      # the first turn, one. Beside a running turn they print at once.
-      def observe(event)
-        if INIT_EVENTS.include?(event[:type])
-          return if @quiet
-          return @view.init_started(event) if event[:type] == :plugin_init_started
-
-          @view.init_finished(event) if event[:type] == :plugin_init_finished
-          return show(event) if turn_running?
-
-          return @cards << event
-        end
-        return unless (event[:type] == :card && !event[:in_turn]) || (event[:type] == :hook_notice && event[:between_turns])
-        return show(event) if event[:anytime] && (Thread.current == Thread.main || turn_running?)
-
-        @cards << event
-      end
-
-      # Keep an item for the next flush (any thread).
-      def keep(item)
-        @cards << item
-      end
-
-      # An anytime command's output: beside a running turn at once, else at
-      # the next flush.
-      def show_or_keep(item)
-        turn_running? ? show(item) : keep(item)
-      end
-
-      # The Engine's observer for :recap_ready (the idle scheduler's thread):
-      # kept for #flush_recap. One collected just as a turn started describes
-      # the chat before it, and is dropped.
-      def take_recap(event)
-        return unless event[:type] == :recap_ready
-        return if event[:recap].to_s.strip.empty? || turn_running?
-
-        @recap = { text: event[:recap].to_s, at: event[:created_at] }
-      end
-
-      # Print a recap written while idle (main thread, at the open prompt).
-      def flush_recap
-        recap = @recap
-        return unless recap
-
-        @recap = nil
-        line = @gaps&.divider
-        @surface.commit(gap_divider(line)) if line
-        @surface.commit(recap_block(recap[:text], at: recap[:at]))
-      end
-
-      # Print the cards, notices and anytime commands' output kept since the
-      # last flush (main thread). A card replaced later in the same batch
-      # (the same id: btw's "thinking…", then its answer) prints once, as its
-      # last.
-      def flush_cards
-        items = []
-        loop { items << @cards.pop(true) }
-      rescue ThreadError
-        items.each_with_index do |item, index|
-          replaced = item[:type] == :card && items.drop(index + 1).any? { |later| later[:type] == :card && later[:id] == item[:id] }
-          show(item) unless replaced
-        end
-        nil
-      end
-
-      # A card, a notice, an anytime command's output (:command_output), a
-      # plugin init task's done line or a load warning.
-      def show(item)
-        case item[:type]
-        when :card then @renderer.render_card(item)
-        when :command_output then @surface.commit(item[:text])
-        when :guardrail_warning then @surface.commit(EventRenderer.load_warning_line(item))
-        when :plugin_init_finished
-          line = EventRenderer.init_line(item)
-          @surface.commit(line) if line
-        else @surface.commit(EventRenderer.hook_notice_line(item))
-        end
-      end
-
-      private
-
-      def turn_running? = @turn_running.call
-    end
-  end
-end