samagotchi 0.59.0 → 0.60.0

data/lib/samagotchi/system_prompt.rb

@@ -11,6 +11,7 @@ require_relative "model_notes"
 require_relative "bundle_needs"
 require_relative "memory_bundle/index_size"
 require_relative "thinking"
+require_relative "prompt_files"
 
 module Samagotchi
   # The system prompt an Engine gives its model: the base prompt (tool
@@ -24,8 +25,6 @@ module Samagotchi
   # tools a plugin replaces, the attached session, the thinking level) is
   # read at build time through the lookups; the memory lists are fixed.
   class SystemPrompt
-    AGENT_DESCRIPTION_FILE = "AGENTS.md"
-
     # The model a session runs on, as the prompt names it: the resolved
     # ref, its host ("name, host:port" or url), the memory overlay key, and
     # what a llama.cpp server says it serves when that differs (else nil).
@@ -51,8 +50,10 @@ module Samagotchi
     #   model's (none: the section is left out)
     # @param memories [Array<String>] the --memory list
     # @param muted_memory_names [Array<String>] normalized (MutedMemories)
+    # @param appended_files [Array<String>] chi --append-system-prompt's
+    #   files (absolute paths), after config.yml's append_system_prompt:
     def initialize(profile:, tools:, session:, thinking:, model: -> {}, model_notes: -> { [] }, memories: [],
-                   muted_memory_names: [])
+                   muted_memory_names: [], appended_files: [])
       @profile_lookup = profile
       @model_lookup = model
       @model_notes_lookup = model_notes
@@ -61,6 +62,14 @@ module Samagotchi
       @thinking_lookup = thinking
       @muted_memory_names = muted_memory_names
       @requested_memories = effective_preload_list(preload_memory_list(memories))
+      # Read once, as the memories: list is: a config edit is picked up by
+      # a new process. The files' text is read at each build.
+      @config_appended = begin
+        ConfigFile.appended_prompt_files
+      rescue StandardError
+        []
+      end
+      @cli_appended = Array(appended_files).map { |path| File.expand_path(path.to_s) }
     end
 
     # @return [Array<String>] the names the session preloads, known before
@@ -81,16 +90,20 @@ module Samagotchi
       @built ||= {}
       @index_sizes ||= {}
       @notes_loaded ||= {}
+      @files_loaded ||= {}
       unless @built.key?(key)
         @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
         )
         @index_sizes[key] = @measured_index
         @notes_loaded[key] = @section_notes || []
+        @files_loaded[key] = @section_files.freeze
       end
       @memory_index = @index_sizes[key]
       @prompt_notes = @notes_loaded[key]
+      @prompt_files = @files_loaded[key]
       @built[key]
     end
 
@@ -108,6 +121,14 @@ module Samagotchi
     # @return [Array<ModelNotes::Note>, nil]
     attr_reader :prompt_notes
 
+    # The files whose text the prompt #build returned last holds, as
+    # absolute paths in prompt order: the AGENTS.md chain, then the
+    # appended files (append_system_prompt:, --append-system-prompt). [] before a
+    # build and after #reset!. Read when the prompt is built, as the
+    # sections are.
+    # @return [Array<String>]
+    def prompt_files = @prompt_files || []
+
     # Drops the built prompts: the next #build reads the profile, tools,
     # indexes and memories again (a model or profile switch, changed tools).
     def reset!
@@ -115,6 +136,8 @@ module Samagotchi
       @index_sizes = nil
       @notes_loaded = nil
       @prompt_notes = nil
+      @files_loaded = nil
+      @prompt_files = nil
       @stable_lengths = nil
     end
 
@@ -295,7 +318,7 @@ module Samagotchi
         "System memories:\n#{indexes[:system]}"
       ].join("\n\n")
       stable = [thinking_token + base, rg_guidance, system_identity_section, model_notes_section, explicit_memory_section,
-                project_specific_description, memory_sections]
+                project_specific_description, appended_section, memory_sections]
       stable_text = stable.compact.join("\n")
       volatile = [current_model, project_location, current_session].compact
       return with_tail_declarations(stable_text, chat: chat, layers: layers) if volatile.empty?
@@ -464,26 +487,59 @@ module Samagotchi
 
     # ── Project / rg helpers ───────────────────────────────────────────────────
 
-    # AGENTS.md in the cwd, else at the top of its git work tree.
+    # The AGENTS.md chain from the top of the git work tree down to the cwd
+    # (PromptFiles.agents_sections), one section per file with text.
     def project_specific_description
       return nil if skip_agent_description?
 
-      path = agent_description_path
-      return nil unless path
-
-      content = File.read(path, encoding: "UTF-8").strip
-      return nil if content.empty?
+      sections = PromptFiles.agents_sections(Dir.pwd)
+      return nil if sections.empty?
 
-      "Project specific description:\n#{content}"
+      @section_files&.concat(sections.map(&:path))
+      sections.map(&:text).join("\n\n")
     rescue StandardError
       nil
     end
 
-    def agent_description_path
+    # The appended files' text, right after AGENTS.md (the stable, cached
+    # part): config.yml's append_system_prompt: entries first (a relative
+    # one against the cwd, as AGENTS.md is found; a missing one is skipped),
+    # then --append-system-prompt's. A file the AGENTS.md chain holds, a
+    # repeat and an empty or vanished file are left out.
+    def appended_section
       cwd = Dir.pwd
-      [cwd, MemoryPaths.work_tree_root(cwd)].compact.uniq
-        .map { |dir| File.join(dir, AGENT_DESCRIPTION_FILE) }
-        .find { |path| File.file?(path) }
+      top = MemoryPaths.work_tree_root(cwd)
+      seen = Set.new((skip_agent_description? ? [] : PromptFiles.agents_paths(cwd)).map { |path| canonical_path(path) })
+      sections = []
+      appended_candidates(cwd).each do |path, source|
+        next unless seen.add?(canonical_path(path))
+
+        unless File.file?(path)
+          Log.debug(:config, "appended_prompt_file_missing", path: path, source: source)
+          next
+        end
+        text = PromptFiles.section(path, "Appended from #{PromptFiles.display_path(path, top: top)}:")
+        next unless text
+
+        @section_files&.push(path)
+        sections << text
+      end
+      sections.empty? ? nil : sections.join("\n\n")
+    rescue StandardError
+      nil
+    end
+
+    # [absolute path, "config" | "cli"], in prompt order.
+    def appended_candidates(cwd)
+      @config_appended.map { |entry| [File.expand_path(entry, cwd), "config"] } +
+        @cli_appended.map { |path| [path, "cli"] }
+    end
+
+    # The same file however it's spelled (/tmp vs /private/tmp on macOS).
+    def canonical_path(path)
+      File.realpath(path)
+    rescue SystemCallError
+      File.expand_path(path)
     end
 
     # Where the session runs and which project memory folder it uses. Only

data/lib/samagotchi/terminal_ui/attach_launcher.rb

@@ -37,6 +37,8 @@ module Samagotchi
       # @param memories [Array<String>] --memory: a new session's worker
       #   preloads them (an existing session keeps its own list)
       # @param muted_memories [Array<String>] --mute: hidden from a new session
+      # @param appended_prompt_files [Array<String>] --append-system-prompt's
+      #   files (absolute): a new session's setup carries them
       # @param llm_context [Hash{Symbol => String}] --llm-context* as typed
       #   (LLMContextOverride.update): a new session starts with them; a
       #   resumed or attached one's worker gets a /llm-context, after the
@@ -48,9 +50,10 @@ module Samagotchi
       #   :failed when the --model switch didn't go through, or (input from a
       #   pipe) :turn_failed / :empty_answer / :unanswered (AttachedLoop#run)
       def run(attach: nil, shared: false, resume: nil, prompt: nil, model: nil, no_interrupt: false, default_input: true,
-              memories: [], muted_memories: [], llm_context: {}, thinking: nil)
+              memories: [], muted_memories: [], llm_context: {}, thinking: nil, appended_prompt_files: [])
         client = connect(attach: attach, shared: shared, resume: resume, model: model,
-                         memories: memories, muted_memories: muted_memories, llm_context: llm_context, thinking: thinking)
+                         memories: memories, muted_memories: muted_memories, llm_context: llm_context, thinking: thinking,
+                         appended_prompt_files: appended_prompt_files)
         commands = []
         commands << "/model #{model}" if model && (attach || resume)
         commands << LLMContextOverride.command_line(llm_context) if (attach || resume) && !llm_context.empty?
@@ -117,9 +120,11 @@ module Samagotchi
       # @return [BridgeClient] a client for the live Bridge of the session
       # @raise [Error]
       def connect(attach: nil, shared: false, resume: nil, model: nil, state_dir: nil, wait: BRIDGE_WAIT,
-                  memories: [], muted_memories: [], llm_context: {}, thinking: nil, err: $stderr)
+                  memories: [], muted_memories: [], llm_context: {}, thinking: nil, appended_prompt_files: [], err: $stderr)
         sd = state_dir || Session.default_state_dir
-        warn_memory_flags_ignored(attach || resume, memories, muted_memories, err) if attach || resume
+        if attach || resume
+          warn_memory_flags_ignored(attach || resume, memories, muted_memories, err, appended_prompt_files: appended_prompt_files)
+        end
         if attach
           live = connect_existing(attach, sd)
           return live if live
@@ -134,7 +139,8 @@ module Samagotchi
                     SessionManager.spawn_session(prompt: nil, model_name: model && model_ref(model), state_dir: sd,
                                                  memories: memories, muted_memories: muted_memories,
                                                  setup: SessionSetup.new(llm_context: llm_context.empty? ? nil : LLMContextOverride.update(nil, llm_context),
-                                                                         thinking: Thinking.session_level(thinking)))
+                                                                         thinking: Thinking.session_level(thinking),
+                                                                         appended_prompt_files: appended_prompt_files))
                   end
         client = BridgeClient.wait_for(session.id, session_dir: Session.session_dir(session.id, state_dir: sd), timeout: wait)
         client || raise(Error, "the worker for session #{session.id} did not start its Bridge in time")
@@ -150,16 +156,19 @@ module Samagotchi
       end
 
       # An existing session's prompt is built from its own session fields:
-      # --memory/--mute given with --attach or --resume are ignored, with a
-      # line saying so (printed before the live region opens).
-      def warn_memory_flags_ignored(session_id, memories, muted_memories, err)
+      # --memory/--mute/--append-system-prompt given with --attach or
+      # --resume are ignored, with a line saying so (printed before the live
+      # region opens).
+      def warn_memory_flags_ignored(session_id, memories, muted_memories, err, appended_prompt_files: [])
         flags = []
         flags << "--memory" unless Array(memories).empty?
         flags << "--mute" unless Array(muted_memories).empty?
+        flags << "--append-system-prompt" unless Array(appended_prompt_files).empty?
         return if flags.empty?
 
         verb = flags.size == 1 ? "applies" : "apply"
-        err.puts "(#{flags.join(" and ")} #{verb} to a new session; #{session_id}'s prompt is already built)"
+        names = flags.size > 2 ? "#{flags[0..-2].join(", ")} and #{flags.last}" : flags.join(" and ")
+        err.puts "(#{names} #{verb} to a new session; #{session_id}'s prompt is already built)"
       end
 
       # @return [BridgeClient, nil] the running worker's, or nil when none runs

data/lib/samagotchi/terminal_ui/formatting.rb

@@ -8,6 +8,7 @@ require_relative "../steer"
 require_relative "../steer_cut"
 require_relative "../memory_bundle/index_size"
 require_relative "../prompt_note"
+require_relative "../prompt_files"
 
 module Samagotchi
   class TerminalUI
@@ -404,6 +405,16 @@ module Samagotchi
         "#{"~" if source.to_s == "estimate"}#{number} tok/s"
       end
 
+      # The prompt files (absolute paths) named as the prompt names them:
+      # relative to this checkout's top, else with ~; nil with none.
+      def prompt_files_text(paths)
+        list = Array(paths).map(&:to_s).reject(&:empty?)
+        return nil if list.empty?
+
+        top = MemoryPaths.work_tree_root(Dir.pwd)
+        list.map { |path| PromptFiles.display_path(path, top: top) }.join(", ")
+      end
+
       # "~3.4k tokens in this session's prompt (system 2.0k, project 1.4k)":
       # the memory indexes the session's prompt holds (the snapshot's
       # memory_index, symbol or string keys); "" without one. As ctx.js
@@ -600,6 +611,9 @@ module Samagotchi
         # The model notes the session's prompt carried (Engine#prompt_notes).
         notes = PromptNote.text(snapshot[:prompt_notes])
         lines << "model notes:      #{notes}" unless notes.empty?
+        # The files whose text is in the prompt (SystemPrompt#prompt_files).
+        files = prompt_files_text(snapshot[:prompt_files])
+        lines << "prompt files:     #{files}" if files
         llm_context = llm_context_stats_text(snapshot[:llm_context])
         lines << "llm context:      #{llm_context}" if llm_context
         thinking = setting_stats_text(snapshot[:thinking])

data/lib/samagotchi/terminal_ui.rb

@@ -92,8 +92,12 @@ module Samagotchi
     #   (LLMContextOverride.update): set on the new or resumed session
     # @param thinking [String, nil] --thinking as typed: the new or resumed
     #   session's own level (default unsets it)
+    # @param appended_prompt_files [Array<String>] --append-system-prompt's
+    #   files (absolute): a new session saves them; a resumed one's own come
+    #   first, and the merge goes only to the Engine (as --memory's does)
     def initialize(prompt: nil, client: nil, host_registry: nil, profile: nil, session_id: nil, no_interrupt: false, no_default_input: false, model_name: nil, memories: [], muted_memories: [], non_interactive: false, surface: nil,
-                   spinner_tick_interval: AttachedView::TICK_INTERVAL, spinner_clock: nil, scratch: false, llm_context: {}, thinking: nil)
+                   spinner_tick_interval: AttachedView::TICK_INTERVAL, spinner_clock: nil, scratch: false, llm_context: {}, thinking: nil,
+                   appended_prompt_files: [])
       @scratch        = scratch
       @thinking_word  = thinking
       @prompt         = prompt
@@ -142,9 +146,11 @@ module Samagotchi
       # session started attached with mutes keeps them here.
       @requested_memories = Array(memories)
       @muted_memory_names = Array(muted_memories)
+      @appended_prompt_files = Array(appended_prompt_files)
       if @resume_session
         @requested_memories = (@resume_session.preloaded_memory_names + @requested_memories).uniq
         @muted_memory_names = (@resume_session.muted_memory_names + @muted_memory_names).uniq
+        @appended_prompt_files = (@resume_session.appended_prompt_files + @appended_prompt_files).uniq
       end
       # Every terminal write goes through the surface. The REPL swaps in a
       # live region when the terminal can show one (#assist_loop), unless it
@@ -178,6 +184,7 @@ module Samagotchi
         model_typed: no_default ? @resumed_model_typed : nil,
         memories: @requested_memories,
         muted_memories: @muted_memory_names,
+        appended_prompt_files: @appended_prompt_files,
         recap: scratch ? nil : recap_config,
         scratch: scratch,
         reminders: {
@@ -258,7 +265,8 @@ module Samagotchi
         working_directory: Dir.pwd,
         preloaded_memory_names: @requested_memories,
         muted_memory_names: @muted_memory_names,
-        scratch: @scratch
+        scratch: @scratch,
+        setup: SessionSetup.new(appended_prompt_files: @appended_prompt_files)
       ))
       # --llm-context*: the session's own values, over a resumed one's.
       # Saved at once on a resumed one: leaving before a turn keeps them.
@@ -628,7 +636,7 @@ module Samagotchi
     # Run one REPL turn (a prompt, or a continue/reminder turn with nil) through
     # Engine#run_turn, rendering via @renderer.
     # @param images [Array<Hash>] the prompt's `@path` images ({path:})
-    def run_engine_turn(session, prompt, continue: false, max_iterations: IterationLimit.for, images: [])
+    def run_engine_turn(session, prompt, continue: false, max_iterations: IterationLimit.for, images: [], resumed: false, resume_from: nil)
       cancellation_controller = CancellationController.new
       @active_cancel_controller = cancellation_controller
       @renderer.begin_turn
@@ -646,7 +654,9 @@ module Samagotchi
           cancel_controller: cancellation_controller,
           pending_input: method(:drain_steering),
           continue: continue,
-          images: images
+          images: images,
+          resumed: resumed,
+          resume_from: resume_from
         )
       end
     rescue Interrupt
@@ -774,9 +784,11 @@ module Samagotchi
       end
       return show_command_result(answer) unless answer.resume
 
+      # The run the offer's turn started: the Continue keeps its reasoning.
+      resume_from = @turn_flow.resume_from
       @turn_flow.before_continue_turn
       begin
-        result = run_engine_turn(session, nil, continue: true)
+        result = run_engine_turn(session, nil, continue: true, resumed: true, resume_from: resume_from)
       rescue LLM::ProviderError
         # The renderer showed the failure (:turn_failed).
         @surface.commit(turn_end_hint("continue prompt preserved"))

data/lib/samagotchi/turn_flow.rb

@@ -42,8 +42,9 @@ module Samagotchi
       [:invalid, nil]
     end
 
-    # @return [Hash, nil] the pending continue offer: {context:, no_interrupt:}
-    #   (context summarizes the interrupted turn for a "no, <reason>")
+    # @return [Hash, nil] the pending continue offer: {context:, no_interrupt:,
+    #   run_start:, model:} (context summarizes the interrupted turn for a
+    #   "no, <reason>"; run_start and model are #resume_from's)
     attr_reader :offer
 
     # How many times the conversation went back to a checkpoint (a failed
@@ -94,7 +95,11 @@ module Samagotchi
       end
 
       if result.resumable?
-        @offer = { context: interrupted_turn_context(result), no_interrupt: no_interrupt }
+        # A Continue that ran out again goes on from the run the chain
+        # started; any other turn's offer (a prompt's, a wake's) from its own.
+        run_start = (continue && resume_from) || result.run_start
+        @offer = { context: interrupted_turn_context(result), no_interrupt: no_interrupt, run_start: run_start,
+                   model: @engine.effective_model_name }
         :continue_offered
       else
         @offer = nil
@@ -143,6 +148,20 @@ module Samagotchi
       :restored
     end
 
+    # Where a Continue of the pending offer resumes: the run its turn (or
+    # the first turn of a chain of Continues) started (ModelResult#run_start),
+    # so the Continue keeps that run's reasoning (Engine#run_turn
+    # resume_from:). nil with no offer, and after a model change while the
+    # offer stands: another model's reasoning isn't replayed, the Continue
+    # starts cold. A cancelled or failed Continue keeps the offer, and so
+    # this; every way the offer goes takes it along.
+    # @return [Integer, nil]
+    def resume_from
+      return nil unless @offer && @offer[:model] == @engine.effective_model_name
+
+      @offer[:run_start]
+    end
+
     # Answer the offer with no (Stop): the interrupted turn stays, as
     # after a Ctrl-C or a new prompt (!rollback still erases it), and the
     # model reads that it wasn't continued: a note, or the user's reason

data/lib/samagotchi/version.rb

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

data/lib/samagotchi/web/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><defs><linearGradient id="g" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#7aa5ff"/><stop offset="1" stop-color="#8957e5"/></linearGradient></defs><rect x="1" y="1" width="30" height="30" rx="7.5" fill="url(#g)"/><g fill="none" stroke="#fff" stroke-width="3.2" stroke-linecap="round" stroke-linejoin="round"><path d="M7.8 9.6c2.3-1.3 4-.7 5.2 1.4l6 10.1c1.2 2.1 2.9 2.7 5.2 1.4"/><path d="M22.6 9.2 9.4 22.8"/></g></svg>

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

@@ -3,6 +3,7 @@
 <head>
 <meta charset="utf-8">
 <title>Chi</title>
+<link rel="icon" href="/assets/favicon.svg" type="image/svg+xml">
 <meta name="viewport" content="width=device-width,initial-scale=1">
 <style>
 :root{color-scheme:dark;--bg:#0b0d11;--bg-panel:#151821;--bg-inset:#0f1115;--bg-raised:#22262f;--bg-hover:#1b1f27;--border:#1f232b;--border-strong:#2d333f;--text:#e6e8eb;--text-bright:#f0f3f6;--text-2:#c9d1d9;--text-3:#9aa4b2;--text-muted:#8b949e;--text-faint:#6e7681;--accent:#7aa5ff;--accent-strong:#1f6feb;--accent-bg:#1b2336;--accent-ring:rgba(122,165,255,.18);--primary:#2a68d1;--ok:#3fb950;--ok-text:#7ee787;--ok-bg:#1a2e1a;--warn:#d29922;--warn-text:#e3b341;--warn-bright:#f2cc60;--warn-bg:#2b2108;--warn-border:#6b5416;--danger:#f85149;--danger-bg:#da3633;--danger-text:#ff7b72;--danger-bg-dim:#3d1f1f;--think:#8957e5;--think-text:#d2a8ff;--accent-border:#223150;--pick-border:#79c0ff;--accent-tint:color-mix(in srgb,var(--accent) 7%,transparent);--narr:color-mix(in srgb,var(--accent) 38%,var(--text-muted));

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

@@ -6,6 +6,11 @@
 // an answer or a step's text (ref_scan.js; a link whose text is one too).
 // The DOM carries data-ref-kind and the target's attributes, never what a
 // click does: those are the ref's targets, kept per kind in REF_ACTIONS.
+// A plugin's ref (the server's Ref: {kind, target, label?, actions}) is
+// bound to its element by bindRef: its label and its URL actions live in a
+// WeakMap off the DOM, and refTarget reads them first. Its actions join the
+// kind's own (the `actions` entry); a kind the page has no table for runs
+// only those.
 // A plain click runs the first one available (the main target); a ref
 // with more shows a ▾ on hover that opens a menu of all of them
 // (ref_menu.js), and a tap opens it. A ref with a target is a tab stop
@@ -26,6 +31,55 @@ export function refAttrs(ref) {
   return ` data-ref-kind="${escapeHtml(ref.kind)}"${attr("path", ref.path)}${attr("line", ref.line)}${attr("end-line", ref.end_line)}`;
 }
 
+// A kind, as the server's Ref allows it (Ref::KIND).
+const KIND = /^[a-z][a-z0-9_-]{0,31}$/;
+
+// A plugin's ref data per element (bindRef): {kind, target, label,
+// actions}. A WeakMap, so a redrawn element takes its data with it.
+const REF_DATA = new WeakMap();
+
+// +url+ as the page opens it when it is an http(s) one, else null. The
+// server checks it too (Ref, RefAction); the page never opens another
+// scheme a plugin gave (javascript:, data:, an editor's).
+export function httpUrl(url) {
+  if (typeof url !== "string") return null;
+  try {
+    const parsed = new URL(url.trim());
+    return parsed.protocol === "http:" || parsed.protocol === "https:" ? parsed.href : null;
+  } catch {
+    return null;
+  }
+}
+
+// Makes +el+ the ref +ref+ (the server's Ref#to_h): the ref class and the
+// data attributes every ref carries (a file's path and lines, as refAttrs),
+// its label and its actions in the WeakMap. An action without an id, a
+// label or an http(s) URL is dropped; a kind the server's Ref refuses binds
+// nothing. A rebind replaces the target attributes. +el+, or null without one.
+export function bindRef(el, ref) {
+  if (!el) return null;
+  if (typeof ref?.kind !== "string" || !KIND.test(ref.kind)) return el;
+  const target = ref.target || {};
+  el.classList.add("ref");
+  el.dataset.refKind = ref.kind;
+  for (const [name, value] of [["refPath", target.path], ["refLine", target.line], ["refEndLine", target.end_line]]) {
+    if (value) el.dataset[name] = String(value);
+    else delete el.dataset[name];
+  }
+  const actions = (Array.isArray(ref.actions) ? ref.actions : []).flatMap((action) => {
+    const url = httpUrl(action?.url);
+    return url && action.id && action.label ? [{ id: String(action.id), label: String(action.label), url }] : [];
+  });
+  REF_DATA.set(el, { kind: ref.kind, target, label: ref.label || null, actions });
+  return el;
+}
+
+// The same URL either way (a link's href against an action's URL).
+function sameUrl(a, b) {
+  const url = httpUrl(a);
+  return !!url && url === httpUrl(b);
+}
+
 // The URL +template+ ({path}, {line}; web.editor) opens +path+ at +line+
 // (1 when none) with: each path segment encoded, the slashes kept. "" with
 // no template or path.
@@ -41,16 +95,38 @@ export function editorUrl(template, path, line) {
 // editorUrl}, the server's capabilities.editor and editor_url) and
 // +target+ (refTarget's). A secondary one (copy) joins a ref that has
 // another, never alone. A line (a diff or read line) has its click only.
+// A link whose text is the ref (github-pr's PR diff): its href stays the
+// plain click's, which the browser follows. Its label is the ref's action
+// with the same URL (the menu shows them once), else the old guess from
+// the URL (an old session's link has no ref data).
+const LINK = Object.freeze({
+  id: "link",
+  label: (target) => target.actions?.find((action) => sameUrl(action.url, target.href))?.label ||
+    (/\/pull\/\d+\/files\b/.test(target.href) ? "PR diff" : "Open link"),
+  available: (_viewer, target) => !!target.href,
+  run: (target, _viewer, env) => env.openLink(target.href),
+});
+
+// The ref's own actions (a plugin's, bindRef), one target each, for every
+// viewer (a URL opens on a phone too): a new tab with no opener and no
+// referrer. One with the link's URL, or an earlier one's, isn't repeated.
+// Not on a diff or read line (its click only), which shares its title's data.
+const URL_ACTIONS = Object.freeze({
+  id: "actions",
+  expand: (target) => (target.actions || [])
+    .filter((action, at, all) => !sameUrl(action.url, target.href) && all.findIndex((other) => sameUrl(other.url, action.url)) === at)
+    .map((action) => Object.freeze({
+      id: `url:${action.id}`,
+      label: () => action.label,
+      available: (_viewer, target) => !target.isLine,
+      run: (_target, _viewer, env) => env.openLink(action.url),
+      hint: () => action.url,
+    })),
+});
+
 export const REF_ACTIONS = Object.freeze({
   file: Object.freeze([
-    // A link whose text is the ref (github-pr's PR diff): its href stays
-    // the plain click's, which the browser follows.
-    Object.freeze({
-      id: "link",
-      label: (target) => (/\/pull\/\d+\/files\b/.test(target.href) ? "PR diff" : "Open link"),
-      available: (_viewer, target) => !!target.href,
-      run: (target, _viewer, env) => env.openLink(target.href),
-    }),
+    LINK,
     Object.freeze({
       id: "editor",
       label: () => "Open in editor",
@@ -63,6 +139,7 @@ export const REF_ACTIONS = Object.freeze({
       // The hover hint: it opens the file as it is now.
       hint: (target) => `Open the current file in your editor${target.line ? ` at line ${target.line}` : ""}`,
     }),
+    URL_ACTIONS,
     // The row that touched the file, in the turn: not for a row's own
     // title or lines (they are in the turn already).
     Object.freeze({
@@ -80,13 +157,18 @@ export const REF_ACTIONS = Object.freeze({
       run: (target, _viewer, env) => env.copy(target.path),
     }),
   ]),
+  // Any other kind (a plugin's issue, commit, …): its link, then its actions.
+  "*": Object.freeze([LINK, URL_ACTIONS]),
 });
 
 // The targets +viewer+ has for +target+ (refTarget's), in order; none
 // when only a secondary one is.
 export function refActions(target, viewer, actions = REF_ACTIONS) {
   if (!target) return [];
-  const found = (actions[target.kind] || []).filter((action) => action.available(viewer, target));
+  // Own keys only: a kind named like an Object property ("constructor") is
+  // any other kind.
+  const table = (Object.hasOwn(actions, target.kind) ? actions[target.kind] : actions["*"]) || [];
+  const found = table.flatMap((action) => (action.expand ? action.expand(target) : [action])).filter((action) => action.available(viewer, target));
   return found.some((action) => !action.secondary) ? found : [];
 }
 
@@ -97,8 +179,9 @@ const OWNERS = ".activity-row, .bubble.approval";
 // A line of the owner's file: a diff line, or a read row's numbered line.
 const LINES = ".diff-line[data-line], .read-line[data-line]";
 
-// What a click on +el+ points at: {kind, path, line, owner, el, isLine,
-// href} or null. A row title (or an approval card's path) opens its file
+// What a click on +el+ points at: {kind, path, id, label, actions, line,
+// owner, el, isLine, href} or null (+id+, +label+ and +actions+ a plugin's
+// ref's, bindRef: the WeakMap is read first). A row title (or an approval card's path) opens its file
 // at the lines the call named (an edit without any at its first changed
 // line); a diff line (or a hunk header) or a read row's numbered line, in
 // a row or a card with a ref, opens that file at that line. +el+ is the
@@ -109,7 +192,8 @@ export function refTarget(el) {
   if (title) {
     const owner = title.closest(OWNERS);
     const href = title.matches("a[href]") ? title.getAttribute("href") : null;
-    return { ...targetOf(title), line: Number(title.dataset.refLine) || firstChange(owner), owner: owner || title, el: title, isLine: false, href };
+    const own = targetOf(title);
+    return { ...own, line: own.line || firstChange(owner), owner: owner || title, el: title, isLine: false, href };
   }
   const diffLine = el?.closest?.(LINES);
   const owner = diffLine?.closest(OWNERS);
@@ -119,7 +203,13 @@ export function refTarget(el) {
 }
 
 function targetOf(el) {
-  return { kind: el.dataset.refKind, path: el.dataset.refPath || "" };
+  const data = REF_DATA.get(el);
+  if (!data) return { kind: el.dataset.refKind, path: el.dataset.refPath || "", line: Number(el.dataset.refLine) || null, id: null, label: null, actions: [] };
+  // Bound data is the whole ref: no fallback to the attributes.
+  const { target } = data;
+  return {
+    kind: data.kind, path: target.path || "", line: Number(target.line) || null, id: target.id ?? null, label: data.label, actions: data.actions,
+  };
 }
 
 // An edit/write without a line range opens at its first changed line (its
@@ -235,9 +325,11 @@ function defaultOpen(url) {
   else window.location.href = url;
 }
 
-// A link ref's href from the menu: a new tab, as the answer's links open.
+// A link ref's href or a ref's URL action: a new tab, as the answer's
+// links open, with no opener and no referrer (the page's LAN URL and
+// session id stay here).
 function defaultOpenLink(href) {
-  window.open(href, "_blank", "noopener");
+  window.open(href, "_blank", "noopener,noreferrer");
 }
 
 // One delegated listener set on +root+ for every ref on the page.

data/lib/samagotchi/worker.rb

@@ -367,6 +367,7 @@ module Samagotchi
         # (re)spawn.
         memories: @session.preloaded_memory_names,
         muted_memories: @session.muted_memory_names,
+        appended_prompt_files: @session.appended_prompt_files,
         reminders: {
           callback: lambda { |due_names|
             # A reminder is due: the loop runs a reminder turn for it once

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: samagotchi
 version: !ruby/object:Gem::Version
-  version: 0.59.0
+  version: 0.60.0
 platform: ruby
 authors:
 - Dmitry Dedov
@@ -178,6 +178,8 @@ files:
 - lib/samagotchi/broadcast_command.rb
 - lib/samagotchi/bundle_command.rb
 - lib/samagotchi/bundle_needs.rb
+- lib/samagotchi/bundles/agents-md/manifest.yml
+- lib/samagotchi/bundles/agents-md/plugin.rb
 - lib/samagotchi/bundles/btw/manifest.yml
 - lib/samagotchi/bundles/btw/plugin.rb
 - lib/samagotchi/bundles/check-in/manifest.yml
@@ -392,6 +394,7 @@ files:
 - lib/samagotchi/process_group.rb
 - lib/samagotchi/project_scope.rb
 - lib/samagotchi/prompt.rb
+- lib/samagotchi/prompt_files.rb
 - lib/samagotchi/prompt_history.rb
 - lib/samagotchi/prompt_literal_guard.rb
 - lib/samagotchi/prompt_note.rb
@@ -403,6 +406,7 @@ files:
 - lib/samagotchi/recap_setup.rb
 - lib/samagotchi/recap_store.rb
 - lib/samagotchi/redacted_inspect.rb
+- lib/samagotchi/ref.rb
 - lib/samagotchi/relay.rb
 - lib/samagotchi/relay_desk.rb
 - lib/samagotchi/relay_verifier.rb
@@ -542,6 +546,7 @@ files:
 - lib/samagotchi/web/public/data.js
 - lib/samagotchi/web/public/diff_view.js
 - lib/samagotchi/web/public/families_view.js
+- lib/samagotchi/web/public/favicon.svg
 - lib/samagotchi/web/public/format.js
 - lib/samagotchi/web/public/hold.js
 - lib/samagotchi/web/public/images.js