samagotchi 0.94.0 → 0.96.0

data/lib/samagotchi/session_continue.rb

@@ -83,7 +83,7 @@ module Samagotchi
     # follows the chain to its new end instead.
     # @param id_or_ref [String] an id, a prefix, or last:<id> (SessionChain.resolve)
     # @param prompt [String, nil] its first message (nil: it starts idle)
-    # @param title [String, nil] what the lists show before the first turn;
+    # @param preview [String, nil] what the lists show before the first turn;
     #   by default the prompt, else the previous link's preview
     # @return [Session] the new link (#model_warning as spawn_session's,
     #   #moved_children: the delegates it took over, #opener:
@@ -92,7 +92,7 @@ module Samagotchi
     # @raise [Refused] continued already, delegates open that can't
     #   move, or its folder is gone
     # @raise [ArchiveRefused, OwnedByTUI] as archive_session
-    def self.run(id_or_ref, prompt: nil, title: nil, model: nil, state_dir: nil, recap_wait: RECAP_WAIT, archive_wait: 5)
+    def self.run(id_or_ref, prompt: nil, preview: nil, model: nil, state_dir: nil, recap_wait: RECAP_WAIT, archive_wait: 5)
       sd = state_dir || Session.default_state_dir
       TRIES.times do |try|
         id = SessionChain.resolve(id_or_ref, state_dir: sd)
@@ -100,7 +100,7 @@ module Samagotchi
           follow = id_or_ref.to_s.strip.start_with?(SessionChain::LAST_PREFIX) && try < TRIES - 1
           next :moved if follow && SessionChain.next_of(id, state_dir: sd)
 
-          run_locked(id, prompt: prompt, title: title, model: model, state_dir: sd, recap_wait: recap_wait,
+          run_locked(id, prompt: prompt, preview: preview, model: model, state_dir: sd, recap_wait: recap_wait,
                          archive_wait: archive_wait)
         end
         return result unless result == :moved
@@ -116,7 +116,7 @@ module Samagotchi
       end
     end
 
-    private_class_method def self.run_locked(id, prompt:, title:, model:, state_dir:, recap_wait:, archive_wait:)
+    private_class_method def self.run_locked(id, prompt:, preview:, model:, state_dir:, recap_wait:, archive_wait:)
       previous = Session.load(id, state_dir: state_dir)
       checked = check!(previous, state_dir, model: model)
       plan = checked.plan
@@ -132,7 +132,7 @@ module Samagotchi
       archive = SessionManager.archive_session(id, state_dir: state_dir, wait: archive_wait, except: plan.move)
       archived = archive[:archived] - already
       begin
-        spawn_continuation(previous, prompt: prompt, title: title, choice: checked.choice, state_dir: state_dir,
+        spawn_continuation(previous, prompt: prompt, preview: preview, choice: checked.choice, state_dir: state_dir,
                                      move: plan.move)
       rescue StandardError
         # Nothing started: the delegates go back, what this archived goes
@@ -194,16 +194,16 @@ module Samagotchi
 
     # The new link, holding off any worker but its own (ChildMove.starting?)
     # while +move+ goes to it.
-    private_class_method def self.spawn_continuation(previous, prompt:, title:, choice:, state_dir:, move:)
+    private_class_method def self.spawn_continuation(previous, prompt:, preview:, choice:, state_dir:, move:)
       recap = RecapStore.read(Session.session_dir(previous.id, state_dir: state_dir))
       start = prompt.to_s.strip.empty? ? nil : prompt
-      title = previous.first_preview if title.to_s.strip.empty? && start.nil?
+      preview = previous.first_preview if preview.to_s.strip.empty? && start.nil?
       before_spawn = lambda do |link|
         ChildMove.mark_starting(link.id, state_dir: state_dir)
         ChildMove.apply(move, from: previous.id, to: link.id, state_dir: state_dir)
       end
       link = SessionManager.spawn_session(
-        prompt: start, title: title, working_directory: previous.working_directory,
+        prompt: start, preview: preview, title: previous.title, working_directory: previous.working_directory,
         model_name: choice.model, setup: SessionSetup.of(previous),
         continues: previous.id, note: SessionChain.note_text(previous, recap: recap),
         note_source: SessionChain::NOTE_SOURCE, state_dir: state_dir, before_spawn: before_spawn

data/lib/samagotchi/session_delete_command.rb

@@ -80,7 +80,7 @@ module Samagotchi
     end
 
     def preview_of(id)
-      text = Session.load(id, state_dir: @state_dir).first_preview.to_s.gsub(/\s+/, " ").strip
+      text = Session.load(id, state_dir: @state_dir).display_title.gsub(/\s+/, " ").strip
       return nil if text.empty?
 
       text.length > PREVIEW_LIMIT ? "#{text[0, PREVIEW_LIMIT - 1]}…" : text

data/lib/samagotchi/session_manager.rb

@@ -138,8 +138,11 @@ module Samagotchi
     # @param messages [Array<Hash>] a conversation to start from (a plugin's
     #   ctx.sessions.fork); its image refs are copied from +images_from+
     # @param images_from [String, nil] the session dir the seed's images are in
-    # @param title [String, nil] what the lists show before the first turn
+    # @param preview [String, nil] what the lists show before the first turn
     #   (the prompt's preview by default, else the seed's first user message)
+    # @param title [String, nil] the session's own name (Session#title; a
+    #   continue's link inherits its previous link's), saved before the
+    #   worker starts: the worker owns the file from then on
     # @param setup [SessionSetup] the session's own settings (chi
     #   --llm-context; a fork and a continue copy their session's; a delegate
     #   child the toolkit its delegate call named); without a toolkit the
@@ -156,7 +159,7 @@ module Samagotchi
     #   and #model_warning: an id its host's saved list doesn't have
     def self.spawn_session(prompt:, mode: "assist", working_directory: nil, model_name: nil, state_dir: nil,
                            memories: [], muted_memories: [], parent_id: nil, messages: [], images_from: nil,
-                           title: nil, delegate: false, setup: SessionSetup.new, continues: nil, note: nil,
+                           preview: nil, title: nil, delegate: false, setup: SessionSetup.new, continues: nil, note: nil,
                            note_source: "chi", before_spawn: nil)
       sd = state_dir || Session.default_state_dir
       # The resolved ref is stored (a resumed session keeps its model when an
@@ -189,7 +192,8 @@ module Samagotchi
       session.last_prompt = prompt
       # The worker takes last_prompt and clears it, and messages are saved at
       # the turn's end: until then this is the only preview a list has.
-      session.first_preview = Session.preview_of(title.to_s.strip.empty? ? prompt : title)
+      session.first_preview = Session.preview_of(preview.to_s.strip.empty? ? prompt : preview)
+      session.title = title
       session_dir = Session.session_dir(session.id, state_dir: sd)
       unless session.messages.empty?
         session.messages, dropped = ImageStore.copy_refs(session.messages, from: images_from, to: session_dir)
@@ -321,7 +325,7 @@ module Samagotchi
         owned = !!owner&.worker?
         next if live && !owned
 
-        { id: s.id, short_id: s.id[0, 8], desc: summary_desc(s), preview: summary_preview(s), cwd: s.working_directory,
+        { id: s.id, short_id: s.id[0, 8], desc: summary_desc(s), preview: summary_preview(s), title: s.title, cwd: s.working_directory,
           project: s.project_root(cache: roots), updated_at: s.updated_at, status: s.status, live: owned, busy: owned && s.status == Session::STATUS_RUNNING,
           owner: owner&.kind, recap: RecapStore.preview(Session.session_dir(s.id, state_dir: sd)),
           ctx_pct: SessionMetrics.saved_context_pct(Session.session_dir(s.id, state_dir: sd),
@@ -464,10 +468,12 @@ module Samagotchi
       cut(summary_text(session), SUMMARY_PREVIEW_LIMIT)
     end
 
-    # A session as one line of text for the lists: its last prompt, else the
-    # first message it was started with (a session command like `/model x`,
-    # or a first turn not saved yet).
+    # A session as one line of text for the lists: its title (/title), else
+    # its last prompt, else the first message it was started with (a session
+    # command like `/model x`, or a first turn not saved yet).
     def self.summary_text(session)
+      return one_line(session.title) unless session.title.to_s.strip.empty?
+
       one_line(session.last_prompt.to_s.strip.empty? ? session.first_preview.to_s : session.last_prompt.to_s)
     end
 

data/lib/samagotchi/sessions_command.rb

@@ -198,11 +198,12 @@ module Samagotchi
         # scratch: a `chi scratch` session (deleted when its REPL ends, a
         # leftover one at the next sweep)
         # ctx_pct: how full the context was after the last turn, or nil
+        # title: the session's own name (/title; desc shows it too), or nil
         # waiting: the kind of question it waits on (question, approval,
         # hook: chi answer or the web answers it), or nil; waiting_id: its
         # id, for chi answer --question; relayed_to: the parent session (short
         # id) whose card it also waits in (the approval relay), or nil
-        keys = %i[id short_id desc cwd project updated_at live busy owner recap parent_id continues delegate archived scratch ctx_pct
+        keys = %i[id short_id desc title cwd project updated_at live busy owner recap parent_id continues delegate archived scratch ctx_pct
                   waiting waiting_id relayed_to stopped_by]
         @stdout.puts JSON.generate(summaries.map { |summary| summary.slice(*keys) })
       when "tsv"
@@ -215,9 +216,10 @@ module Samagotchi
                   else summary[:live] ? "live" : summary[:status].to_s
                   end
           # The saved recap's first sentence says more than the last prompt
-          # (text only: tsv and json keep desc for pickers).
+          # (text only: tsv and json keep desc for pickers); a title (in
+          # desc) says what the user named it.
           desc = summary[:desc]
-          if summary[:recap]
+          if summary[:recap] && !summary[:title]
             desc = [File.basename(summary[:cwd].to_s), summary[:recap]].reject(&:empty?).join(" · ")
             desc = "#{desc[0, 59]}…" if desc.length > 60
           end
@@ -245,11 +247,11 @@ module Samagotchi
       order ||= "desc"
       sessions = Samagotchi::SessionManager.list_sessions(sort: sort, order: order, limit: limit, project_root: project,
                                                           include_archived: include_archived)
-      # The saved recap's first sentence, else the last prompt (or the first
-      # message, before any turn), cut as before.
+      # The session's title, else the saved recap's first sentence, else the
+      # last prompt (or the first message, before any turn), cut as before.
       state_dir = Samagotchi::Session.default_state_dir
       list_text = lambda do |s|
-        recap = Samagotchi::RecapStore.preview(Samagotchi::Session.session_dir(s.id, state_dir: state_dir))
+        recap = s.title ? nil : Samagotchi::RecapStore.preview(Samagotchi::Session.session_dir(s.id, state_dir: state_dir))
         (recap || Samagotchi::SessionManager.summary_text(s))[0, 60]
       end
       # How full the context was after the last turn: "ctx 12%", counted

data/lib/samagotchi/system_prompt.rb

@@ -96,7 +96,7 @@ module Samagotchi
         @section_notes = nil
         @section_files = []
         @built[key] = system_prompt_with_index(
-          assist_system_prompt(chat: chat, thinking: thinking, layers: layers), chat: chat, thinking: thinking, layers: layers
+          assist_system_prompt(chat: chat, layers: layers), chat: chat, thinking: thinking, layers: layers
         )
         @index_sizes[key] = @measured_index
         @notes_loaded[key] = @section_notes || []
@@ -151,9 +151,8 @@ module Samagotchi
 
     # The base prompt (specs, plugins' declarations), with Gemma's tool
     # declarations at its end as #build has them.
-    def base(chat: false, thinking: nil, layers: [])
-      with_tail_declarations(assist_system_prompt(chat: chat, thinking: thinking, layers: layers), chat: chat,
-                                                                                                  layers: layers)
+    def base(chat: false, layers: [])
+      with_tail_declarations(assist_system_prompt(chat: chat, layers: layers), chat: chat, layers: layers)
     end
 
     # Names activated via preloaded --memory entries during prompt
@@ -195,27 +194,14 @@ module Samagotchi
       end
     end
 
-    # Only Qwen has an explicit thinking-close marker, so only Qwen can
-    # reliably have this preamble parsed back out of its thinking block.
-    # With thinking off there is no thinking to begin with it.
-    def turn_preamble_instruction(thinking = nil)
-      return "" unless profile.name == "qwen36"
-      return "" if Samagotchi::Config.get("thinking.turn_preamble") == false
-      return "" if (thinking || turn_thinking) == :off
-
-      "\nTurn preamble: as the very first line of your thinking, write \"TURN: \" followed by a short present-tense action phrase (max 8 words) describing what you are about to do, e.g. \"TURN: reading project config\". Then continue reasoning normally.\n"
-    end
-
     # ── System prompts ─────────────────────────────────────────────────────────
 
-    # @param chat [Boolean] for the chat loop: no tool declarations, call
-    #   syntax or turn preamble (its tools go as schemas with each request)
-    # @param thinking [Symbol, nil] the level (Thinking); nil: the effective model's
-    def assist_system_prompt(chat: false, thinking: nil, layers: [])
+    # @param chat [Boolean] for the chat loop: no tool declarations or call
+    #   syntax (its tools go as schemas with each request)
+    def assist_system_prompt(chat: false, layers: [])
       return chat_system_prompt if chat
 
       hint = tool_call_hint
-      turn_preamble = turn_preamble_instruction(thinking)
       # Gemma 4's template declares the tools at the end of the system turn
       # (#system_prompt_with_index puts them there).
       tools = if gemma_tail_declarations?
@@ -228,7 +214,7 @@ module Samagotchi
         You are Chi (pronounced "chee"), the friendly name for the Samagotchi assistant harness. #{tools}
         #{hint}
         You may make multiple tool calls. After seeing tool results, continue reasoning or answer the user.
-        #{turn_preamble}
+
         #{ToolDeclarations::SMALL_CONTEXT_PROTOCOL}
 
         #{assist_guidance}

data/lib/samagotchi/terminal_ui/thinking_line.rb

@@ -20,8 +20,6 @@ module Samagotchi
 
       # Enough text to find the newest sentence in; scanning grows with it.
       BUFFER_LIMIT = 2000
-      # The Qwen turn preamble's first line ("TURN: reading the config").
-      TURN_PREFIX = /\ATURN:\s*/i
       # Where a raw stream's thinking ends: a boundary, so its last words
       # don't run into the answer's first.
       THOUGHT_CLOSE = %r{<channel\|>|</think>}
@@ -65,8 +63,8 @@ module Samagotchi
       # @return [Symbol, nil] :thinking or :writing
       attr_reader :label
 
-      # The sentence as a row shows it: no TURN: prefix, markdown plain.
-      def sentence = strip_markdown(@ticker.line.sub(TURN_PREFIX, ""))
+      # The sentence as a row shows it: markdown plain.
+      def sentence = strip_markdown(@ticker.line)
 
       # #sentence cut to +room+ columns, with an ellipsis when cut.
       def fit(room)

data/lib/samagotchi/thinking.rb

@@ -27,6 +27,14 @@ module Samagotchi
     # An empty thought after the Qwen assistant cue: the model answers at once
     # (what the server's own template does with enable_thinking false).
     QWEN_EMPTY_THOUGHT = "<think>\n\n</think>\n\n"
+    # An open thought after the Qwen assistant cue, as a Qwen3.5+ template
+    # writes it with thinking on: without it Qwen3.6 writes an empty thought
+    # at once and never thinks (#opens_thought?).
+    QWEN_OPEN_THOUGHT = "<think>\n"
+    # A Jinja string literal that ends with the open thought: '<think>\n'
+    # (a Qwen3.5+ generation prompt). Qwen3's writes only the empty one,
+    # '<think>\n\n</think>\n\n', with thinking off.
+    OPEN_THOUGHT_LITERAL = /<think>(?:\\n|\n)['"]/
     # Gemma 4's empty thought channel after the model cue, as its chat
     # template writes it with enable_thinking false (only where a model turn
     # starts: Prompt.prefill_for).
@@ -168,15 +176,40 @@ module Samagotchi
       caps.is_a?(Hash) && caps["supports_reasoning_effort"] == false
     end
 
+    # Whether a llama.cpp /props answer (+props+, Client::ServerProps)
+    # carries a chat template whose generation prompt opens a thought
+    # (Qwen3.5 and later: `assistant\n` then '<think>\n' unless
+    # enable_thinking is false). Read from the template's last
+    # add_generation_prompt branch on: the message loop before it writes
+    # earlier turns' thoughts. false when there is no template (a router's
+    # own /props, an unloaded model, a failed probe).
+    def opens_thought?(props)
+      return false unless props.respond_to?(:answered?) && props.answered? && props.body.is_a?(Hash)
+
+      template = props.body["chat_template"]
+      return false unless template.is_a?(String)
+
+      cue = template.rindex("add_generation_prompt")
+      !cue.nil? && OPEN_THOUGHT_LITERAL.match?(template[cue..])
+    end
+
     # The native prompt's switch for +level+ under +profile+.
     # @param profile [ModelProfile]
+    # @param opens_thought [Boolean] the server's template opens a thought
+    #   after the cue (#opens_thought?): qwen36 then gets the open thought
+    #   at every level but off, as the template has it
     # @return [Native]
-    def native(level, profile)
+    def native(level, profile, opens_thought: false)
       off = level == :off
       honoured = !EFFORTS.include?(level)
       case profile&.name
       when "gemma4" then Native.new(system_token: off ? "" : GEMMA_THINK_TOKEN, prefill: off ? GEMMA_EMPTY_THOUGHT : "", honoured: honoured)
-      when "qwen36" then Native.new(system_token: "", prefill: off ? QWEN_EMPTY_THOUGHT : "", honoured: honoured)
+      when "qwen36"
+        prefill = if off then QWEN_EMPTY_THOUGHT
+                  elsif opens_thought then QWEN_OPEN_THOUGHT
+                  else ""
+                  end
+        Native.new(system_token: "", prefill: prefill, honoured: honoured)
       else Native.new(system_token: "", prefill: "", honoured: level == DEFAULT)
       end
     end

data/lib/samagotchi/thinking_notices.rb

@@ -102,16 +102,23 @@ module Samagotchi
     private
 
     # An effort on a native host, which has no knob for it: said once per
-    # session and host.
+    # session and host. A qwen36 whose server template opens a thought
+    # (Thinking.opens_thought?, from the /props answer the profile probe
+    # cached) thinks at every effort, the same.
     def announce_level(level, target)
       return if target.entry.chat?
 
       profile = @profile.call
       return if Thinking.native(level, profile).honoured
 
-      notice_once(:unsupported, target, :info,
-                  "#{level} isn't supported by native #{profile.name} on #{target.entry.name}; " \
-                  "thinking stays as the model has it")
+      text = if profile&.name == "qwen36" && Thinking.opens_thought?(target.client&.cached_server_props(model: target.bare_model))
+               "#{level} isn't supported by native #{profile.name} on #{target.entry.name}; " \
+                 "it thinks, with no effort control (low, medium and high think the same)"
+             else
+               "#{level} isn't supported by native #{profile.name} on #{target.entry.name}; " \
+                 "thinking stays as the model has it"
+             end
+      notice_once(:unsupported, target, :info, text)
     rescue StandardError => e
       failed(:announce_level, e)
     end

data/lib/samagotchi/title_command.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Samagotchi
+  # /title, the session's own name (Session#title): with no argument, the
+  # title and what shows without one; `/title TEXT` names the session
+  # (whitespace collapsed, cut at 80 characters as a preview is), saved at
+  # once; `/title --clear` drops it, and the lists show the first message
+  # again. Anyone who may send the session a command may name it (a parent
+  # agent its delegates too). It runs mid-turn as well (anytime): the save
+  # takes the session's lock and writes a running turn's checkpoint, as a
+  # turn's own saves do.
+  class TitleCommand
+    NAME = "/title"
+    CLEAR = "--clear"
+    USAGE = "usage: #{NAME} [TEXT|#{CLEAR}]".freeze
+    # As long as a preview (Session.preview_of) may be.
+    LIMIT = 80
+
+    # @param engine [Engine] #session
+    # @param save [#call] saves the session after a change
+    def initialize(engine:, save:)
+      @engine = engine
+      @save = save
+    end
+
+    # @param args [String] what follows /title
+    # @return [Array(String, Boolean, Symbol)] the reply, whether the
+    #   title changed, and :ok or :error
+    def run(args)
+      session = @engine.session or return ["no session yet", false, :error]
+      text = args.to_s.gsub(/\s+/, " ").strip
+      return [listing(session), false, :ok] if text.empty?
+      # "--clear and more" is a slip, not a title.
+      return [USAGE, false, :error] if text.start_with?("#{CLEAR} ")
+
+      title = if text == CLEAR then nil
+              elsif text.length > LIMIT then "#{text[0, LIMIT]}…"
+              else text
+              end
+      return ["#{listing(session)}\n(no change)", false, :ok] if title == session.title
+
+      session.title = title
+      # The command itself as the session's first line (chi send --new
+      # "/title X", a web first message) became its preview: it goes, and
+      # the save derives the preview from the first user message again.
+      session.first_preview = "" if session.first_preview.to_s.start_with?(NAME)
+      @save.call(session)
+      [listing(session), true, :ok]
+    end
+
+    private
+
+    # "title: Coordinator", or "title: none (shows the first message: hey chi …)"
+    def listing(session)
+      return "title: #{session.title}" if session.title
+
+      preview = session.first_preview.to_s
+      "title: none (shows #{preview.empty? ? "the first message" : "the first message: #{preview}"})"
+    end
+  end
+end

data/lib/samagotchi/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Samagotchi
-  VERSION = "0.94.0"
+  VERSION = "0.96.0"
   # Sent as the User-Agent of every HTTP request chi makes.
   USER_AGENT = "chi/#{VERSION}"
 end

data/lib/samagotchi/vision_support.rb

@@ -61,9 +61,6 @@ module Samagotchi
 
     def self.native(target, _entry, profile, trust_config:)
       client = target.client
-      transport = client.transport.name
-      return no("#{transport} hosts take no images (only llama.cpp does)") unless transport == :llama_cpp
-
       props = client.server_props(model: target.bare_model)
       return no("can't reach /props for the media marker") unless props&.answered?
 

data/lib/samagotchi/web/app.rb

@@ -681,7 +681,7 @@ module Samagotchi
         # next; the list and the notifications name the session by it
         # until that turn is saved.
         preview = idle ? body["preview"].to_s.strip : ""
-        folder[:title] = preview unless preview.empty?
+        folder[:preview] = preview unless preview.empty?
         setup = SessionSetup.new(llm_context: llm_context, thinking: thinking, bundle_settings: bundle_settings)
         folder[:setup] = setup unless setup.empty?
         begin
@@ -725,7 +725,7 @@ module Samagotchi
 
         preview = idle ? body["preview"].to_s.strip : ""
         model = (body["model"] || body["model_name"]).to_s.strip
-        session, error = continue_from(given, prompt: idle ? nil : prompt.to_s, title: preview.empty? ? nil : preview,
+        session, error = continue_from(given, prompt: idle ? nil : prompt.to_s, preview: preview.empty? ? nil : preview,
                                               model: model.empty? ? nil : model)
         return error if error
 
@@ -742,8 +742,8 @@ module Samagotchi
       # SessionManager.continue_session, its refusals as responses: [session,
       # nil] or [nil, the response]. Only its own errors: what fails after
       # the new link started is not a refusal of it.
-      def continue_from(given, prompt:, title:, model:)
-        [@manager.continue_session(given, prompt: prompt, title: title, model: model, state_dir: @state_dir), nil]
+      def continue_from(given, prompt:, preview:, model:)
+        [@manager.continue_session(given, prompt: prompt, preview: preview, model: model, state_dir: @state_dir), nil]
       rescue SessionContinue::Refused => e
         extra = e.reason == :continued ? { next_id: e.ids.first } : { ids: e.ids }
         [nil, json_response(409, { error: e.reason.to_s, detail: e.message, **extra })]

data/lib/samagotchi/web/public/app.js

@@ -85,6 +85,7 @@ import { createToasts } from "./toasts.js";
 import { createUnqueue } from "./unqueue.js";
 import { createStartPage } from "./start_page.js";
 import { createSessionActions } from "./session_actions.js";
+import { createRename } from "./session_rename.js";
 import { createSendTurn } from "./send_turn.js";
 
 const $ = (s) => document.querySelector(s);
@@ -495,6 +496,14 @@ const sessionActions = createSessionActions({
   closeLiveStream: () => streamControl?.close(),
   workerGone,
 });
+// ✎: /title through the chips' path (session_rename.js).
+const rename = createRename({
+  button: $("#infoRenameBtn"),
+  session: () => selected,
+  titleOf: (id) => lists.sessionsById().get(id)?.title || null,
+  run: (line) => runSessionCommand(line),
+});
+
 const { confirmDelete, leaveGoneSession, continueSelected, archiveOne, setArchived } = sessionActions;
 
 // All sessions: its own view at #/sessions, so the browser's back button
@@ -1046,6 +1055,9 @@ function updateInfoBar() {
   const deleteBtn = document.getElementById("infoDeleteBtn");
   const archiveBtn = document.getElementById("infoArchiveBtn");
   const continueBtn = document.getElementById("infoContinueBtn");
+  const renameBtn = document.getElementById("infoRenameBtn");
+  if (renameBtn) renameBtn.style.display = buttons.rename.shown ? "" : "none";
+  rename.follow(buttons.rename.shown ? selected : null);
   if (continueBtn) {
     continueBtn.style.display = buttons.continue.shown ? "" : "none";
     continueBtn.disabled = buttons.continue.disabled;

data/lib/samagotchi/web/public/chains.js

@@ -36,9 +36,11 @@ export function isOpener(text) {
 // reads its chain's first link's title instead, so the links of a chain
 // keep its name. Its own title when the first link isn't in +byId+ (id →
 // session; deleted, or a walk a missing link cut short) or is the opener too.
+// A link with a title of its own (/title; a new link inherits it) reads it,
+// and a titled first link names its chain.
 export function chainTitle(s, byId) {
   const own = previewForCard(s);
-  if (!s?.continues || !isOpener(s.first_preview || s.last_prompt)) return own;
+  if (s?.title || !s?.continues || !isOpener(s.first_preview || s.last_prompt)) return own;
   const seen = new Set([s.id]);
   let at = s;
   while (at.continues) {
@@ -47,7 +49,7 @@ export function chainTitle(s, byId) {
     seen.add(prev.id);
     at = prev;
   }
-  return isOpener(at.first_preview || at.last_prompt) ? own : previewForCard(at);
+  return !at.title && isOpener(at.first_preview || at.last_prompt) ? own : previewForCard(at);
 }
 
 // The open session's title (app.js updateSessionTitle: the top bar and the
@@ -55,9 +57,10 @@ export function chainTitle(s, byId) {
 // (+shown+, its summary, has continues) reads +cardTitle+(shown) whatever
 // its first message: a web link inherits its chain's title, and its first
 // message is an opener (the constant or the user's own). Else +first+,
-// unless it is the opener. +shown+ null: not listed yet, +first+.
+// unless it is the opener. A titled session (/title) reads its card's too.
+// +shown+ null: not listed yet, +first+.
 export function openTitle({ shown, first, cardTitle }) {
-  if (shown && (shown.continues || isOpener(first))) return cardTitle(shown);
+  if (shown && (shown.title || shown.continues || isOpener(first))) return cardTitle(shown);
   return first;
 }
 
@@ -213,13 +216,23 @@ export function chainChipTemplate(f, { open = false } = {}) {
 
 // The chain's list (the chip's popover): one row per other link, newest
 // first: status dot, "#N", its date (with its HH:MM when another link of
-// the chain, the head too, started the same day: chainStamp), its recap's first sentence (else
-// its preview), the waiting / stopped badge, archived. A row's click opens
+// the chain, the head too, started the same day: chainStamp), its own title (/title) when it
+// differs from the head's (a link inherits its chain's: the card says it), else its recap's
+// first sentence, else its preview, the waiting / stopped badge, archived. A row's click opens
 // that link (families_view.js's popover binds .family-row[data-id]).
 // @param activeId the open session's id (its row is .active)
+// A chain row's words: a name of its own (not the one it shares with the
+// head), else what tells the link apart: its recap, else its preview (an
+// opener's read as the chain's, chainTitle, with its own title left out).
+function rowTitle(s, headTitle, byId) {
+  if (s.title && s.title !== headTitle) return s.title;
+  return s.recap || chainTitle({ ...s, title: null }, byId);
+}
+
 export function chainRowsTemplate(f, { activeId = null, now = Date.now() } = {}) {
-  const byId = new Map((f?.chain?.links || []).map((s) => [s.id, s]));
   const links = f?.chain?.links || [];
+  const byId = new Map(links.map((s) => [s.id, s]));
+  const headTitle = (byId.get(f?.head?.id) || f?.head)?.title || null;
   const rows = chainOthers(f).map(({ session: s, n }) => {
     const cls = ["family-row", "chain-row"];
     if (activeId && s.id === activeId) cls.push("active");
@@ -231,7 +244,7 @@ export function chainRowsTemplate(f, { activeId = null, now = Date.now() } = {})
     const tip = `${s.id} · ${s.status || ""}${ago ? ` · updated ${ago}` : ""}`;
     return html`<div class=${cls.join(" ")} data-id=${s.id} style=${"--depth:1"} role=${"listitem"}><button type="button" class="fr-open"
       title=${tip}>${rowDotTemplate(s, waiting)}<span class="cr-n">#${n}</span>${
-      date ? html`<span class=${date.length > 10 ? "cr-date timed" : "cr-date"}>${date}</span>` : nothing}<span class="fr-preview">${s.recap || chainTitle(s, byId)}</span>${
+      date ? html`<span class=${date.length > 10 ? "cr-date timed" : "cr-date"}>${date}</span>` : nothing}<span class="fr-preview">${rowTitle(s, headTitle, byId)}</span>${
       rowBadgesTemplate(waiting, stopped)}${s.archived ? archivedBadge : nothing}</button></div>`;
   });
   return html`<div class="family-rows chain-rows" role="list">${rows}</div>`;

data/lib/samagotchi/web/public/format.js

@@ -58,8 +58,9 @@ export function firstPreview(text) {
 }
 
 export function previewForCard(session) {
-  // Unified card preview: first message (80) else previewOf(last_prompt)
-  const raw = session.first_preview || session.last_prompt || "";
+  // Unified card preview: its title (/title), else its first message (80),
+  // else its last prompt.
+  const raw = session.title || session.first_preview || session.last_prompt || "";
   return firstPreview(raw) || "\u2014";
 }
 
@@ -69,7 +70,7 @@ const DELETE_PREVIEW_CHARS = 40;
 // list's owner can be stale (a worker idle-exits), so a worker is only
 // "stopped if it's still running", never promised.
 export function deleteConfirmText(session) {
-  const n = normalize(session.first_preview || session.last_prompt || "");
+  const n = normalize(session.title || session.first_preview || session.last_prompt || "");
   const preview = clip(n, DELETE_PREVIEW_CHARS + 1);
   const shortId = session.short_id || String(session.id).slice(0, 8);
   const lines = [

data/lib/samagotchi/web/public/index.html

@@ -887,6 +887,10 @@ body.stage-view .turn-stage{position:absolute;left:0;right:0;bottom:100%;margin-
 #infoBar #infoStopBtn{background:var(--bg-raised);color:var(--warn-text);border:1px solid var(--border-strong)}
 #infoBar #infoStopBtn:hover{background:var(--warn-bg);border-color:var(--warn-border)}
 #infoBar #infoArchiveBtn{background:transparent;color:var(--text-muted);border:1px solid var(--border-strong)}
+#infoBar #infoRenameBtn{background:transparent;color:var(--text-muted);border:1px solid transparent}
+#infoBar #infoRenameBtn:hover{color:var(--text);background:var(--bg-hover)}
+/* ✎'s input (session_rename.js), in the button's place. */
+#infoBar .rename-input{flex:0 1 18em;min-width:6em;font:inherit;font-size:12px;padding:3px 8px;border-radius:8px;border:1px solid var(--accent-border);background:var(--bg-raised);color:var(--text);outline:none}
 #infoBar #infoArchiveBtn:hover{color:var(--text);background:var(--bg-hover)}
 #infoBar #infoDeleteBtn{background:transparent;color:var(--text-muted);border:1px solid transparent}
 #infoBar #infoDeleteBtn:hover{color:var(--on-solid);background:var(--danger-bg);border-color:var(--danger-bg)}
@@ -976,6 +980,8 @@ body.has-session.composer-folded #infoBar{border-top-color:transparent}
   #infoBar>button{font-size:0;line-height:0;padding:5px 7px}
   #infoBar>button::before{content:"";display:block;width:14px;height:14px;background:currentColor;-webkit-mask:var(--icon) center/contain no-repeat;mask:var(--icon) center/contain no-repeat}
   #infoBar #infoArchiveBtn{--icon:var(--icon-archive)}
+  #infoBar #infoRenameBtn{--icon:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='black' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M10.5 2.5l3 3L5.5 13.5H2.5v-3z'/%3E%3C/svg%3E")}
+  #infoBar .rename-input{flex:1 1 8em;font-size:16px}
   #infoBar #infoArchiveBtn.archived{--icon:var(--icon-unarchive)}
   #infoBar #infoContinueBtn{--icon:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='black' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M3 8h9M8.5 4.5 12 8l-3.5 3.5'/%3E%3C/svg%3E")}
   #infoBar #infoCancelBtn{--icon:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='black' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect x='4' y='4' width='8' height='8' rx='1.5'/%3E%3C/svg%3E")}
@@ -1300,6 +1306,7 @@ a{color:var(--accent)}
         <div class="info" id="infoText"></div>
         <div id="contextChips" aria-label="Attached context" hidden></div>
         <button class="ghost" id="infoCancelBtn" title="Cancel the running turn, whoever sent it" style="display:none">Stop turn</button>
+        <button class="ghost" id="infoRenameBtn" title="Rename this session" aria-label="Rename this session" style="display:none">✎</button>
         <button class="ghost" id="infoContinueBtn" title="Continue: start the next link of this session's chain from its recap (this one is archived)" style="display:none">continue →</button>
         <button class="ghost" id="infoArchiveBtn" title="Archive: hide from the lists, keep for good" style="display:none">archive</button>
         <button class="ghost" id="infoStopBtn" title="Stop session (terminate worker)" style="display:none">stop session</button>

data/lib/samagotchi/web/public/info_bar_model.js

@@ -42,6 +42,8 @@ export function infoButtons({ id, state, chain, archived, continuing, streaming
   const busy = !!id && continuing;
   return {
     continue: { shown: !!id && !chain.next && state.owner !== "tui", disabled: busy, text: busy ? "continuing…" : "continue →" },
+    // ✎: /title from the web (a plain terminal's session takes no commands).
+    rename: { shown: !!id && state.owner !== "tui" },
     delete: { shown: !!id },
     archive: {
       shown: !!id,