samagotchi 0.95.0 → 0.97.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_inbox.rb

@@ -359,6 +359,35 @@ module Samagotchi
     end
     private_class_method :unmark_removed
 
+    # How old a per-input tombstone (input/removed/, TurnCheckpoint's
+    # input/settled/) gets before a worker's start prunes it (#prune_old).
+    # A wait reads one at its next poll (ReplyWait::POLL_INTERVAL) and a
+    # later `chi send --wait --turn` reads a settled one at its start, so
+    # only a wait whose process slept (a closed laptop) or one started long
+    # after needs it to stay. A removed one gone under a live wait would
+    # read as a merge (the wrong reply), so the age is generous: a week,
+    # half the session retention (14 days), for one small file per
+    # file-delivered command or dequeue.
+    TOMBSTONE_MAX_AGE = 7 * 24 * 3600
+
+    # Deletes the files in input/<+subdir+> last written more than
+    # +max_age+ seconds ago; one that can't be read or deleted stays.
+    # @return [Integer] how many went
+    def self.prune_old(session_dir, subdir, max_age: TOMBSTONE_MAX_AGE)
+      cutoff = Time.now - max_age
+      Dir.glob(File.join(session_dir, INPUT_DIR, subdir, "*")).count do |file|
+        next false unless File.mtime(file) < cutoff
+
+        File.delete(file)
+        true
+      rescue SystemCallError
+        false
+      end
+    end
+
+    # The removed tombstones past +max_age+ (#prune_old).
+    def self.prune_removed(session_dir, max_age: TOMBSTONE_MAX_AGE) = prune_old(session_dir, REMOVED_DIR, max_age: max_age)
+
     # @return [Boolean] whether the queued input +enqueued_id+ was removed
     #   before it ran (#take_queued_input's tombstone), or is being removed:
     #   the tombstone goes first, so while its claimed file is still there

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
 
@@ -1171,6 +1177,17 @@ module Samagotchi
       def error = ack["error"]
 
       def detail = ack["detail"]
+
+      # What the worker applied (a Bridge ack only): the delivery asked for,
+      # or next_step for a --queue that found no turn running; nil from the
+      # input file or a worker older than delivery.
+      def delivery = ack["delivery"]
+
+      # A --cut's outcome ("now", "waits", "off"), nil when nothing was cut.
+      def cut = ack["cut"]
+
+      # The steer cut-after seconds, with a cut that waits only.
+      def cut_after = ack["cut_after"]
     end
 
     # Hand a user message to the session the way a UI does, for the web

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/terminal_ui/attached_loop.rb

@@ -727,6 +727,8 @@ module Samagotchi
           @screen.commit("#{paint("model>", 36)} #{output}")
         end
         prefill_confirm(event)
+        # /title from any client: the row's title follows.
+        @status.update(title: event[:title]) if Array(event[:changed]).include?("title")
         return unless event[:model_name]
 
         # After the output, so the status row changes with the line saying why.

data/lib/samagotchi/terminal_ui/status_row.rb

@@ -5,7 +5,7 @@ require_relative "formatting"
 module Samagotchi
   class TerminalUI
     # The status row under the prompt, the same for both TUIs:
-    # `status> model=… | ↳ parent | ⑂ 2 running · 1 waiting | ctx=12.3% (under20) | mem: … | muted: …`.
+    # `status> Title | model=… | ↳ parent | ⑂ 2 running · 1 waiting | ctx=12.3% (under20) | mem: … | muted: …`.
     # A UI feeds it what it learns (attached mode from the Bridge's events,
     # the REPL from its Engine's) through #update, and the row is redrawn in
     # the surface's status slot only when its text changes.
@@ -15,6 +15,8 @@ module Samagotchi
       # Memory names shown before ", +N".
       MEMORY_LIMIT = 8
       # What the row shows:
+      #   title                 the session's own title (Session#title; not
+      #                         the first message's preview), or nil
       #   model, default_model  the model in use, and the config's default
       #                         (named beside another model)
       #   served                [served, asked, expected]: what the server said it
@@ -29,12 +31,17 @@ module Samagotchi
       #                         records them as used)
       #   muted                 its --mute list
       #   running               a turn runs: the row trails STEER_HINT
-      FIELDS = %i[model default_model served parent_id children context used_memories preloaded muted running].freeze
+      FIELDS = %i[title model default_model served parent_id children context used_memories preloaded muted running].freeze
 
       # The tail while a turn runs: where a typed line goes (the next step)
       # and the two other choices. Dropped whole first when the row is cut.
       STEER_HINT = " · typing goes in at the next step (/cut, /queue)"
 
+      # The longest title shown, and the share of the row it may take on a
+      # narrow terminal: the rest of the row still fits.
+      TITLE_MAX = 32
+      TITLE_SHARE = 3
+
       # The turn events that end a turn (the hint goes).
       TURN_END_EVENTS = %i[turn_completed turn_canceled turn_failed].freeze
 
@@ -74,6 +81,7 @@ module Samagotchi
         fields.merge!(model: state[:model_name], default_model: default_model) if state[:model_name]
         STATE_LISTS.each { |field, key| fields[field] = Array(state[key]) if state.key?(key) }
         fields[:parent_id] = state[:parent_id] if state.key?(:parent_id)
+        fields[:title] = state[:title] if state.key?(:title)
         # The last turn's ctx, so it shows before the next turn's.
         fields[:context] = state[:context_status] if state[:context_status].is_a?(Hash)
         update(**fields)
@@ -126,7 +134,8 @@ module Samagotchi
           model_text = status_model_text(model, @values[:default_model], served: served, served_for: served_for,
                                                                          expected: expected.is_a?(String))
         end
-        segments = [model_text,
+        segments = [title_text(@values[:title], width),
+                    model_text,
                     parent ? "↳ #{parent.to_s[0, 8]}" : "",
                     children_text(@values[:children]),
                     status_context_text(estimate: @values[:context]),
@@ -147,6 +156,18 @@ module Samagotchi
         segments[0..-2] + ["#{segments.last}#{STEER_HINT}"]
       end
 
+      # The title cut to TITLE_MAX, and to a TITLE_SHARE-th of +width+
+      # (the row's other segments come after it); "" without one.
+      def title_text(title, width)
+        title = title.to_s.strip
+        return "" if title.empty?
+
+        max = [TITLE_MAX, width / TITLE_SHARE].min
+        return title if title.length <= max
+
+        max > 1 ? "#{title[0, max - 1]}…" : ""
+      end
+
       # `⑂ 2 running · 1 waiting`, the counts there are; "" with neither (no
       # children, or all ended). Not "not reported": a REPL parent is never
       # given its children's replies (no wakes there), and a worker moves

data/lib/samagotchi/terminal_ui.rb

@@ -889,6 +889,7 @@ module Samagotchi
         if command
           show_command_result(command)
           refresh_status_row(clear_unknown_context: true) if command.changed.include?(:model)
+          refresh_status_row if command.changed.include?(:title)
           persist_recent_history(input) if command.shell
           return
         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/tools/memory.rb

@@ -356,7 +356,7 @@ module Samagotchi
         ([file] + overlay_files(dir, entry_name, index_text)).each { |path| trash.move(path) }
         Samagotchi::MemoryBundle::IndexUpdater.remove_index(resolved_scope, entry_name)
         "Memory '#{entry_name}' removed from #{resolved_scope} scope: moved to #{trash.dir} " \
-          "(`chi bundle trash` lists and empties it); index line dropped."
+          "(`chi bundle trash` lists and empties it)#{"; index line dropped" if line}."
       end
 
       # The entry's model overlays: <name>.<key>.md with a key ModelOverlay

data/lib/samagotchi/turn_checkpoint.rb

@@ -86,6 +86,12 @@ module Samagotchi
       settled_record(id)
     end
 
+    # The settled outcomes past +max_age+ (SessionInbox.prune_old).
+    # @return [Integer] how many went
+    def self.prune_settled(session_dir, max_age: SessionInbox::TOMBSTONE_MAX_AGE)
+      SessionInbox.prune_old(session_dir, SETTLED_DIR, max_age: max_age)
+    end
+
     def self.settled_record(id, ended_at: nil, seconds: nil)
       LastTurn.new(outcome: "canceled", cancel_reason: WORKER_STOPPED, ended_at: ended_at, seconds: seconds, enqueued_id: id)
     end

data/lib/samagotchi/version.rb

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

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,