samagotchi 0.76.0 → 0.77.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2bec0eb4ac3d46dcca5ca46f2496c4c419d1373ea595fcceae35d5a96098899
-  data.tar.gz: b9be22b2481f7489457eceb98eb1ace0cc3b58988ab34790d0c40197dc586ccc
+  metadata.gz: 433cf999c039d529cdf878223e798ed00b23efc0a35393c48111c0b1f7b597a7
+  data.tar.gz: eb13e65818fc0b2efaa04d28315d9693856ff77861d5643d668702fe80cdeca1
 SHA512:
-  metadata.gz: f8d1c6f29de97f66b9ece157418f02628939f98c9a94926bbde5536fd2e1d126ca42cfce51497290f32e225d0ac169b81eda6e4aa1836c1d4d7bdd94d1d4c929
-  data.tar.gz: 9811070c6def3fe473d2e5fba2a044c25e1d843c12097b738a14854e1a9c6064e84f1b77ae56960166fceac101eb06aca6cbcb03c148e3017c034594cdb246a0
+  metadata.gz: 58012cc677a1b2c14e358dabed798856f88a8a74f59dff1606f08dca297ae78d5f89d69c392b2254523308996a67a86ff828205e07a7eac7ea0b7adf99961d79
+  data.tar.gz: 7332bff82c9060f9ad9a77063891ced098572ce28861fbe2a65ab9486076478d40f1731fec13f41ec9dc4a15fc60e14ac023b40255c0356993bfe22969817986

data/CHANGELOG.md

@@ -8,6 +8,30 @@ and commands may change between minor versions. How releases are made:
 
 ## [Unreleased]
 
+## [0.77.0] - 2026-10-17
+
+### Changed
+
+- A session's worker starts about 80 ms faster: it loads the HTML parser (Nokogiri) only when `web_fetch` first reads
+  an HTML page.
+
+### Fixed
+
+- Web: toasts stack (up to three) instead of replacing one another, so a later notice no longer hides a sticky error
+  such as "Can't send: …"; each one has its own timer and ✕.
+- After `/model`, a session's card drops the old model's context % right away (the new window's %, or none while it
+  is unknown), in every tab and after a reload, instead of keeping it until the next turn ends.
+- Web: the context chip and its tooltip update as soon as a generation starts, not at its first chunk.
+- Web: a model ref longer than 40 characters is cut in the middle in the ctx tooltip's per-model rows, so it no
+  longer stretches the tooltip.
+- REPL (`--no-shared`): the status row drops the old context % after `/model` when the new window is unknown.
+- source-links: a URL in the terminal answer no longer takes in trailing punctuation (`.`, `,`, `)` …) or an unmatched
+  `]`, the same as in the web.
+- `chi bundle build` skips a symlinked memory (`notes.md is a symlink (not included)`) instead of copying the file it
+  links to into the bundle.
+
+Update with `chi update` (the system bundle 0.77.0, `source-links` 0.5.1), then restart `chi web`.
+
 ## [0.76.0] - 2026-10-17
 
 ### Security
@@ -3221,7 +3245,8 @@ and long-lived sessions.
 - A macOS desktop helper (`chi desktop install`): a "Send to chi" Service and a
   hotkey panel that send selected text or the clipboard to your sessions.
 
-[Unreleased]: https://github.com/dm1try/samagotchi/compare/v0.76.0...HEAD
+[Unreleased]: https://github.com/dm1try/samagotchi/compare/v0.77.0...HEAD
+[0.77.0]: https://github.com/dm1try/samagotchi/compare/v0.76.0...v0.77.0
 [0.76.0]: https://github.com/dm1try/samagotchi/compare/v0.75.0...v0.76.0
 [0.75.0]: https://github.com/dm1try/samagotchi/compare/v0.74.0...v0.75.0
 [0.74.0]: https://github.com/dm1try/samagotchi/compare/v0.73.0...v0.74.0

data/docs/internals/engine.md

@@ -290,7 +290,7 @@ One iteration with tool calls:
   replace it; known-names corrects a misspelled name this way, and the model gets one line saying what ran).
 - Emits `:tool_call_started` {iteration, call_count, call_index, tool, call, params, label (plugin tools),
   title, called_as, via, view, ref, refs}. The row fields (title, called_as, via, view, ref) come from `ToolRowFields.for`, which the
-  reload (`Web::MessageParts#tool_part`, after `BuiltinCalls.unwrap_saved`) calls too. `ToolRowFields::ACTIVITY_KEYS` (title, called_as, via) travel
+  reload (`MessageParts#tool_part`, after `BuiltinCalls.unwrap_saved`) calls too. `ToolRowFields::ACTIVITY_KEYS` (title, called_as, via) travel
   inside `activity` on the completed event; `EVENT_KEYS` (view, ref, refs) go top-level on both events.
   `Bridge::TurnAccumulator` (snapshot and replay) and the web (`activity.js` `ACTIVITY_FIELDS` /
   `EVENT_FIELDS`) copy them by these lists, so a new row field is added there. `ref` is `FileRef.for` (a

data/docs/plugins.md

@@ -990,6 +990,48 @@ context_providers:
   the PATH may be another one, such as macOS's 2.6).
 - The command follows [the contract](context.md#the-command-contract).
 
+## Stable for bundles
+
+Bundles normally use only `chi.*` and `ctx`; the constants and helpers below
+are the rest of the surface they may use. A change to any of them gets a
+CHANGELOG line and bumps the shipped bundles that use it. Anything else under
+`Samagotchi::` is internal.
+
+**Stable**
+
+1. `Samagotchi::Plugin::Api` / `chi.*` as documented above, including
+   `Samagotchi::Plugin::ToolResult`, `Samagotchi::Plugin::ModelError` (and its
+   subclass `Samagotchi::Plugin::ModelCancelled`),
+   `Samagotchi::Plugin::Service::Stopped`, `Samagotchi::Plugin::Sessions::Error`
+   and `Samagotchi::Plugin::AttachedContext::Error`.
+2. `Samagotchi::Plugin::Peer` as a base class. A subclass defines `post`,
+   `check_hint!`, `paired_lines`, `transport_line`, `peer_dir` and
+   `setup_paragraph` (optionally `skill_substitutions`), and sets `NAME`,
+   `APP`, `COMMAND`, `USAGE`, `OUTBOX` and `SCRIPTS_DIRS`. These constants are
+   read as `self.class::X`. See the [claude-peer](#the-claude-peer-bundle) and
+   [codex-peer](#the-codex-peer-bundle) bundles.
+3. `Samagotchi::Tools::ToolIndex::Tool` and `Samagotchi::Tools::ToolIndex::Group`
+   values, `Samagotchi::Tools::ToolIndex.schema_note` and
+   `Samagotchi::Tools::ToolIndex.spec_tokens` (used by the mcp bundle).
+4. `Samagotchi::Tools::Execute::NAME`, `TIMEOUT_PREFIX`, `HANDED_OVER` and
+   `Samagotchi::Tools::Execute.timeout_seconds`.
+5. `Samagotchi::Tools::TaskRuntime::TASKS_DIR` and `EXIT_CODE_FILENAME`.
+6. `Samagotchi::AtomicFile.write`, `Samagotchi::Log.warn` /
+   `Samagotchi::Log.debug`, `Samagotchi::Config.get` and
+   `Samagotchi::VERSION`.
+
+**Used by shipped bundles today, but internal** (may change without notice; a
+bundle that needs one should ask for an API instead):
+
+- `Samagotchi::Tools::MemoryRead.memories_dir`, `Samagotchi::MemoryPaths.scope_dir`,
+  `Samagotchi::ConfigFile.global_path` and
+  `Samagotchi::Config.validate_yaml_sections`.
+- `Samagotchi::Ref` / `Samagotchi::RefAction` constants and
+  `Samagotchi::TokenUsage::CHARS_PER_TOKEN`.
+- `Samagotchi::ProcessGroup.stop`, `Samagotchi::Guardrails::ShellLex` and
+  `Samagotchi::Guardrails::GitInfo`.
+- `Samagotchi::Tools::Execute.const_get` reflection.
+
 ## The btw bundle
 
 `chi bundle install btw` (or the `dev` profile) installs the bundle shipped with chi. It is written

data/lib/samagotchi/answer_command.rb

@@ -117,7 +117,7 @@ module Samagotchi
       # turn queued behind it; nil (an older worker): the next reply.
       turn = ReplyWait.own_turn(session, session_dir: Session.session_dir(id, state_dir: @state_dir))
 
-      if pending && pending[:id].to_s == qid
+      if pending && pending.id.to_s == qid
         return failure(not_dismissable(pending)) if options[:dismiss] && ParentReport.continue?(pending)
 
         selected = selection(pending, options) or return @selection_status
@@ -140,7 +140,7 @@ module Samagotchi
     # exact label wins over a number.
     # @return [Array<String>, nil] nil after a usage error
     def selection(pending, options)
-      offered = Array(pending[:options]).map(&:to_s)
+      offered = Array(pending.options).map(&:to_s)
       labels = options[:options].map do |given|
         next given if offered.include?(given)
 
@@ -151,7 +151,7 @@ module Samagotchi
         @selection_status = usage_failure("no option #{given}; the options: #{listed}")
         return nil
       end
-      if labels.uniq.size > 1 && !pending[:multi_select]
+      if labels.uniq.size > 1 && !pending.multi_select
         @selection_status = usage_failure("one option only: the question is single-select")
         return nil
       end
@@ -163,7 +163,7 @@ module Samagotchi
     # Deny, text alone or a dismissal always passes: each one denies. The
     # worker checks it again with its own config.
     def approval_refusal(pending, selected, _id)
-      offered = Array(pending[:options]).map(&:to_s)
+      offered = Array(pending.options).map(&:to_s)
       indices = selected.map { |label| offered.index(label) }
       reason = Guardrails::ParentApprovals.refusal(pending, indices, setting: Guardrails::ParentApprovals.setting)
       reason && Guardrails::ParentApprovals.message(reason)
@@ -177,7 +177,7 @@ module Samagotchi
 
     # A step-limit question can't be left unanswered: the turn waits on it.
     def not_dismissable(pending)
-      "the step-limit question can't be dismissed: answer #{Array(pending[:options]).join(" or ")} " \
+      "the step-limit question can't be dismissed: answer #{Array(pending.options).join(" or ")} " \
         "(--option Stop --text WHY stops it)"
     end
 

data/lib/samagotchi/bridge.rb

@@ -260,7 +260,7 @@ module Samagotchi
           recap: @accumulator.recap,
           saved_recap: @engine.saved_recap,
           continue_offer: @accumulator.continue_offer,
-          pending_question: @engine.pending_question,
+          pending_question: @engine.pending_question&.to_h,
           guardrail_warning: @engine.guardrail_warning,
           plugin_warning: @engine.plugin_warning,
           init_tasks: @engine.init_tasks,
@@ -1178,8 +1178,8 @@ module Samagotchi
     # still that relay's.
     def relay_closed(qid, relay_id, reason)
       pending = @engine.pending_question
-      relay = pending && pending[:relayed_to]
-      unless pending && pending[:id].to_s == qid && relay && (relay[:relay_id] || relay["relay_id"]).to_s == relay_id
+      relay = pending&.relayed_to
+      unless pending && pending.id.to_s == qid && relay && (relay[:relay_id] || relay["relay_id"]).to_s == relay_id
         return [{}, 409, { error: "question_not_pending", detail: "no question #{qid} relayed by #{relay_id}" }]
       end
       return [{}, 409, { error: "question_not_pending", detail: "no pending question #{qid}" }] unless @engine.annotate_question(qid, relayed_to: nil, reason: reason)

data/lib/samagotchi/bundles/source-links/hooks/source_links.rb

@@ -76,6 +76,7 @@ class SourceLinks
   # A bare URL (scheme-anchored, so it can't start inside a markdown label),
   # and a markdown link (label in group 1, target in group 2).
   URL_SPAN = %r{[a-z][a-z0-9+.-]*://\S+}i
+  TRAILING_URL_PUNCTUATION = /[.,;:!?'"]+\z/
   MARKDOWN_LINK = /\[([^\]]*)\]\(([^)]*)\)/
   # A fenced code block's opening line (up to 3 spaces, then ``` or ~~~).
   FENCE_OPEN = /\A {0,3}(`{3,}|~{3,})/
@@ -328,35 +329,36 @@ class SourceLinks
 
   # The [start, end) character ranges of the answer that are a bare URL
   # (scheme-anchored, `[a-z][a-z0-9+.\-]*://\S+`). A ref inside one is not
-  # linked again. The span stops at the first `)` that no `(` inside the URL
-  # balances — so `(https://x.com/a)` ends before the `)`, while
-  # `…/Foo_(bar)` keeps it.
+  # linked again. Trailing punctuation and a trailing `]` without a `[` are
+  # excluded; balanced parentheses and brackets stay part of the URL.
   def bare_url_spans(text)
     spans = []
     text.scan(URL_SPAN) do
       match = Regexp.last_match
-      finish = trim_url_end(match[0], match.begin(0), match.end(0))
+      finish = trim_url_end(match[0], match.begin(0))
       spans << [match.begin(0), finish] if finish > match.begin(0)
     end
     spans
   end
 
-  # The end offset of a URL match after trimming its tail: the span stops at
-  # the first `)` that no `(` inside the URL balances.
-  def trim_url_end(url, start, finish)
+  # The end offset of a URL match after trimming it like notice_links.js.
+  def trim_url_end(url, start)
+    trimmed = url.sub(TRAILING_URL_PUNCTUATION, "")
     depth = 0
-    url.each_char.with_index do |char, index|
+    trimmed.each_char.with_index do |char, index|
       if char == "("
         depth += 1
       elsif char == ")"
         if depth.zero?
-          finish = start + index
+          trimmed = trimmed[0...index]
           break
         end
         depth -= 1
       end
     end
-    finish
+    trimmed = trimmed.sub(/\]+\z/, "") if trimmed.end_with?("]") && !trimmed.include?("[")
+    trimmed = trimmed.sub(TRAILING_URL_PUNCTUATION, "")
+    start + trimmed.length
   end
 
   # A markdown link's label and target ranges, with the target text. A ref in

data/lib/samagotchi/bundles/source-links/manifest.yml

@@ -1,6 +1,6 @@
 ---
 name: source-links
-version: 0.5.0
+version: 0.5.1
 scope: system
 description: Links source refs (JIRA tickets, GitHub issues, …) in the model's answer — inline links in the web, and a one-line note after the turn (note false turns it off); sources are configured patterns
 trust_level: reviewed
@@ -9,7 +9,7 @@ files:
   source_links.md: sha256:ace01a0f7c308a0ae54ece714c31c0e6d7a49c372d98111030e6d268320bed3a
 hooks:
   source_links.rb:
-    sha256: sha256:8d84c68be88972737905925bc9fc4bd941007fb945e8104e9f6b3d61a1186b89
+    sha256: sha256:c41249ec0bbb708ec7827e1d0f66689dfbbc415c1da5fe33f5d3a8ec8e5eaa2f
     event: after_turn
     on_error: log
     priority: 90

data/lib/samagotchi/bundles/system/manifest.yml

@@ -1,6 +1,6 @@
 ---
 name: samagotchi-system
-version: 0.76.0
+version: 0.77.0
 scope: system
 description: Default system memories — identity, self map, config modification protocol, memory guide and the delegated-session rules
 files:

data/lib/samagotchi/child_reports.rb

@@ -254,7 +254,7 @@ module Samagotchi
     def reportable?(wait)
       case wait.status
       when :done, :no_reply, :error then true
-      when :waiting_for_answer then [nil, "", "continue"].include?(wait.question&.dig(:kind)&.to_s)
+      when :waiting_for_answer then [nil, "", "continue"].include?(wait.question&.kind&.to_s)
       else false
       end
     end

data/lib/samagotchi/engine.rb

@@ -242,10 +242,7 @@ module Samagotchi
       wire_kernel(kernel, muted_memories)
       Log.debug(:model, "backend", provider: backend.provider) if Log.level?(:debug)
       @resume_session = session_id ? Session.load(session_id) : nil
-      @prompt_builder = SystemPrompt.new(profile: -> { self.profile }, tools: -> { @tools }, session: -> { @session },
-                                         thinking: -> { turn_thinking }, model: -> { model_identity },
-                                         model_notes: -> { model_notes }, memories: memories,
-                                         muted_memory_names: @muted_memory_names, appended_files: appended_prompt_files)
+      @prompt_builder = build_system_prompt(memories, appended_prompt_files)
       @session = nil
       @session_observer = SessionObserver.new
       @metrics = SessionMetrics.new
@@ -268,10 +265,7 @@ module Samagotchi
       # One shared poller for the whole idle layer (reminders + optional
       # recap). Both jobs read the activity seam above; the scheduler owns
       # the single background thread and isolates per-job failures.
-      @idle_scheduler = IdleScheduler.new(
-        engine: self,
-        jobs: [@reminders, @recap].compact
-      )
+      @idle_scheduler = build_idle_scheduler
       subscribe_session_observers
     end
 
@@ -388,6 +382,21 @@ module Samagotchi
     end
     private :build_plugin_tasks
 
+    # The system prompt's live sources and this session's fixed inputs.
+    def build_system_prompt(memories, appended_prompt_files)
+      SystemPrompt.new(profile: -> { profile }, tools: -> { @tools }, session: -> { @session },
+                       thinking: -> { turn_thinking }, model: -> { model_identity },
+                       model_notes: -> { model_notes }, memories: memories,
+                       muted_memory_names: @muted_memory_names, appended_files: appended_prompt_files)
+    end
+    private :build_system_prompt
+
+    # The idle layer's shared scheduler (see #initialize for when).
+    def build_idle_scheduler
+      IdleScheduler.new(engine: self, jobs: [@reminders, @recap].compact)
+    end
+    private :build_idle_scheduler
+
     # A monotonically-increasing clock (wall clock can jump backwards; the idle
     # detector must never treat a jump as "activity"). Injectable for specs.
     def monotonic_now
@@ -1218,7 +1227,7 @@ module Samagotchi
     #   :last_prompt   [String, nil] the last user prompt (empty string if none)
     #   :event_seq     [Integer]   @session_observer.event_count
     #   :metrics       [Hash]      @metrics.snapshot (per-session analytics)
-    #   :pending_question [Hash, nil] current pending structured question
+    #   :pending_question [Hash, nil] the pending question (PendingQuestion#to_h)
     #   :used_memory_names [Array<String>] deduped memory names active this session
     #   :prompt_notes  [Array<Hash>] the model notes the prompt carried
     #     ({name:, scope:, chars:, digest:}; #prompt_notes)
@@ -1244,7 +1253,7 @@ module Samagotchi
         last_prompt: @session&.last_prompt,
         event_seq: @session_observer&.event_count,
         metrics: metrics,
-        pending_question: @question_desk.pending,
+        pending_question: @question_desk.pending&.to_h,
         used_memory_names: @used_memories.names,
         preloaded_memory_names: preloaded_memory_names,
         muted_memory_names: @muted_memory_names.dup,
@@ -1554,7 +1563,7 @@ module Samagotchi
 
     # ── Ask-user-question (structured qualification) ──────────────────────────
 
-    # @return [Hash, nil] current pending question (thread-safe copy)
+    # @return [PendingQuestion, nil] the question pending now
     def pending_question
       @question_desk.pending
     end
@@ -1580,7 +1589,7 @@ module Samagotchi
 
     # Publish a standing question that blocks nobody (QuestionDesk#post: a
     # worker's step-limit question).
-    # @return [Hash, nil] the pending question, nil while another is open
+    # @return [PendingQuestion, nil] the pending question, nil while another is open
     def post_question(fields, on_answer:, on_superseded_close: nil)
       @question_desk.post(fields, on_answer: on_answer, on_superseded_close: on_superseded_close)
     end

data/lib/samagotchi/guardrails/parent_approvals.rb

@@ -93,7 +93,7 @@ module Samagotchi
       # guardrail rules or approvals: by its rule, its paths or its command
       # (the dirs as this process's environment and config.yml name them).
       def protected?(pending)
-        facts = fetch(pending, :approval)
+        facts = pending.approval
         return false unless facts.is_a?(Hash)
         return true if PROTECTED_RULES.include?(fetch(facts, :rule).to_s)
         return true if fetch(facts, :source).to_s == ProtectedPaths::SOURCE
@@ -137,13 +137,13 @@ module Samagotchi
 
       # An approval: its kind says so, or it carries approval facts.
       def approval?(pending)
-        fetch(pending, :kind).to_s == Approval::KIND || !fetch(pending, :approval).nil?
+        pending.kind.to_s == Approval::KIND || !pending.approval.nil?
       end
 
       # The offered scopes, in option order, or nil when they are missing,
       # empty, not strings, or leave no option after them for Deny.
       def scopes(pending)
-        facts = fetch(pending, :approval)
+        facts = pending.approval
         scopes = facts.is_a?(Hash) ? fetch(facts, :scopes) : nil
         return nil unless scopes.is_a?(Array) && !scopes.empty? && scopes.all?(String)
         return nil unless scopes.size < options(pending).size
@@ -160,7 +160,7 @@ module Samagotchi
         index == options.size - 1 && options[index].to_s == Approval::DENY
       end
 
-      def options(pending) = Array(fetch(pending, :options))
+      def options(pending) = Array(pending.options)
 
       def fetch(hash, key)
         return nil unless hash.is_a?(Hash)

data/lib/samagotchi/guardrails/parent_continue.rb

@@ -24,12 +24,12 @@ module Samagotchi
       end
 
       # Why a parent may not give this answer, or nil.
-      # @param pending [Hash] the pending question (symbol or string keys)
+      # @param pending [PendingQuestion] the pending question
       # @param selected [Array<String>] the selected labels
       # @return [Symbol, nil] :stop_only
       def refusal(pending, selected, allowed: allowed?)
         return nil if allowed
-        return nil unless (pending[:kind] || pending["kind"]).to_s == KIND
+        return nil unless pending.kind.to_s == KIND
 
         Array(selected).map(&:to_s).include?(CONTINUE) ? :stop_only : nil
       end

data/lib/samagotchi/memory_bundle/builder.rb

@@ -110,6 +110,8 @@ module Samagotchi
       def select_memories(target_dir, name)
         candidates = Dir.glob(File.join(target_dir, "*.md")).sort
                         .reject { |p| File.basename(p) == "index.md" || File.basename(p).start_with?(".") }
+        symlinks, candidates = candidates.partition { |path| File.symlink?(path) }
+        @warnings.concat(symlinks.map { |path| "#{File.basename(path)} is a symlink (not included)" })
         if candidates.empty?
           raise BuildError, "No memories to build in #{@scope} scope (#{target_dir}): no .md files found"
         end