samagotchi 0.31.0 → 0.33.0

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

@@ -472,6 +472,12 @@ body.has-session #history{padding-bottom:calc(var(--dock-h,160px) + 32px)}
 #composer .actions-col button{white-space:nowrap;font-size:12px;padding:0 12px;height:28px;min-height:28px;line-height:28px}
 #composer .actions-col .split{order:3;display:flex;gap:4px;margin-left:auto}
 #composer #actionBtn{min-width:64px;font-weight:600}
+/* In a session the composer is one row: the text field (one line, growing with its text; fitPrompt sets its height)
+   and Cancel · Send at its bottom right. The key hint is in the placeholder there, so its row goes. */
+body.has-session #composer{flex-direction:row;align-items:flex-end;padding:10px}
+body.has-session #composer textarea{min-height:0}
+body.has-session #composeHint{display:none}
+body.has-session #composer .actions-col{flex-wrap:nowrap;flex-shrink:0}
 /* The model picker (start page only): reads as a label, "host:model ▾", left of Start; a native select under a drawn caret. */
 /* A select is as wide as its widest option: a hidden copy of the chosen name (data-value) sizes the box to that name instead, and the select fills it. */
 #composer .actions-col .model-pick{order:0;position:relative;display:inline-block;max-width:min(50%,380px);height:28px;min-height:28px;padding:0 22px 0 8px;border-radius:8px;overflow:hidden;background:transparent;color:var(--text-muted);font-size:12px;line-height:28px;text-align:left;text-overflow:ellipsis;transition:background .12s ease,color .12s ease}
@@ -651,7 +657,8 @@ body.stage-view #dock,body.stage-view #dock:focus-within{background:transparent;
 #infoBar .meta .copy-attach{padding:2px 8px;border-radius:6px;font-size:11px;font-weight:600;background:var(--bg-raised);color:var(--text-2);border:1px solid var(--border-strong)}
 #infoBar .meta .copy-attach:hover{color:var(--text-hover);border-color:var(--border-strong)}
 #infoBar .meta .status{font-size:11px;padding:2px 6px;border-radius:999px}
-#infoBar .meta .dir{font-family:ui-monospace,monospace;font-size:11px;color:var(--text-muted);word-break:break-all}
+/* The whole path on one line: a long one loses its start ("…/project/dir", the end is what tells dirs apart); the title holds all of it. */
+#infoBar .meta .dir{font-family:ui-monospace,monospace;font-size:11px;color:var(--text-muted);max-width:48ch;min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;direction:rtl;text-align:left}
 /* The footer sits on the card's glass: its chips are tinted, not solid, so the glass reads through them. */
 #infoBar .meta .model{font-size:11px;padding:2px 6px;border-radius:6px;background:color-mix(in srgb,var(--bg-hover) 55%,transparent);color:var(--text-3)}
 /* The memory chip ("mem 2", when the session used some): phones only, where the "mem: …" line is hidden. */
@@ -663,7 +670,7 @@ body.stage-view #dock,body.stage-view #dock:focus-within{background:transparent;
 #infoBar .meta .worker-restart{padding:1px 8px;border-radius:5px;font-size:11px;font-weight:600;background:var(--bg-raised);color:var(--warn-bright);border:1px solid var(--warn-border)}
 #infoBar .meta .worker-restart:hover:not(:disabled){background:var(--warn-border);color:var(--on-warn)}
 #infoBar .meta .worker-restart:disabled{opacity:.7;cursor:default}
-#infoBar .preview-line{font-size:13px;word-break:break-word;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;line-clamp:2;overflow:hidden;line-height:1.4;max-height:2.8em}
+#infoBar .preview-line{font-size:13px;word-break:break-word;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:1;line-clamp:1;overflow:hidden;line-height:1.4;max-height:1.4em}
 #infoBar .preview-line .preview, #infoBar .preview-line .mem{word-break:break-word}
 #infoBar .mem{font-size:12px;color:var(--text-muted)}
 #infoBar button{padding:4px 12px;border-radius:8px;font-size:12px;font-weight:600}
@@ -673,6 +680,38 @@ body.stage-view #dock,body.stage-view #dock:focus-within{background:transparent;
 #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)}
+/* Attached context (context_chips.js): a row of its own under the meta; not the composer's #chips/.chip. */
+#contextChips{order:5;flex-basis:100%;display:flex;flex-wrap:wrap;gap:6px;align-items:center;min-width:0}
+#contextChips[hidden]{display:none}
+#contextChips.only-add{flex-basis:auto}
+#infoBar .ctx-chip.ctx-add{border-style:dashed;color:var(--text-muted);background:transparent}
+.ctx-add-form{display:flex;flex-direction:column;gap:6px;margin:0}
+.ctx-add-form .ctx-pop-head strong{font-family:inherit}
+.ctx-add-input{width:100%;box-sizing:border-box;padding:6px 8px;border-radius:7px;border:1px solid var(--border-strong);background:var(--bg-inset);color:var(--text);font:13px/1.4 inherit}
+.ctx-add-input:focus{outline:none;border-color:var(--accent-border)}
+#infoBar .ctx-chip{display:inline-flex;align-items:center;gap:5px;padding:2px 9px;border-radius:999px;font:600 11px/1.5 ui-monospace,monospace;background:color-mix(in srgb,var(--bg-hover) 55%,transparent);color:var(--text-3);border:1px solid var(--border-strong);white-space:nowrap}
+#infoBar .ctx-chip:hover,#infoBar .ctx-chip.open{color:var(--text);border-color:var(--accent-border);background:var(--accent-bg)}
+#infoBar .ctx-chip.empty{color:var(--text-faint);border-style:dashed}
+#infoBar .ctx-chip.error{color:var(--danger-text);border-color:color-mix(in srgb,var(--danger) 55%,transparent);background:var(--danger-bg-dim)}
+.ctx-dot{width:7px;height:7px;border-radius:50%;background:var(--accent);box-shadow:0 0 0 2px var(--accent-ring)}
+.ctx-popover{position:fixed;z-index:60;max-height:min(60vh,520px);overflow:auto;padding:12px 14px;border-radius:12px;background:var(--bg-panel);color:var(--text-2);border:1px solid var(--border-strong);box-shadow:var(--toast-shadow);font-size:13px;line-height:1.45;display:flex;flex-direction:column;gap:6px}
+.ctx-popover[hidden]{display:none}
+.ctx-pop-head{display:flex;align-items:baseline;gap:8px}
+.ctx-pop-head strong{font-family:ui-monospace,monospace;color:var(--text-bright)}
+.ctx-pop-kind{font-size:11px;color:var(--text-muted)}
+.ctx-pop-close{margin-left:auto;padding:0 6px;border:none;background:transparent;color:var(--text-muted);font-size:16px;line-height:1}
+.ctx-pop-close:hover{color:var(--text)}
+.ctx-pop-why{color:var(--text)}
+.ctx-pop-hint{font-size:12px;color:var(--accent);word-break:break-all}
+.ctx-pop-summary{padding:6px 8px;border-radius:8px;background:var(--bg-inset);border-left:3px solid var(--accent-border)}
+.ctx-pop-meta{font-size:11px;color:var(--text-muted)}
+.ctx-pop-error{font-size:12px;color:var(--danger-text)}
+.ctx-pop-text{margin:0;max-height:240px;overflow:auto;padding:8px;border-radius:8px;background:var(--bg-inset);font:12px/1.45 ui-monospace,monospace;white-space:pre-wrap;word-break:break-word;color:var(--text-2)}
+.ctx-pop-actions{display:flex;gap:8px;justify-content:flex-end}
+.ctx-pop-actions button{padding:3px 10px;border-radius:7px;font-size:12px;font-weight:600;background:var(--bg-raised);color:var(--text-2);border:1px solid var(--border-strong)}
+.ctx-pop-actions button:hover{color:var(--text-hover)}
+.ctx-pop-actions .ctx-pop-detach{color:var(--text-muted);background:transparent}
+.ctx-pop-actions .ctx-pop-detach:hover{color:var(--danger-text);border-color:color-mix(in srgb,var(--danger) 55%,transparent)}
 /* Phones: the footer is one line; its meta scrolls sideways (all of it stays reachable) and the first-message line, the strip card's title, goes. */
 @media(max-width:600px){
   /* The key hint: cut off at this width, and phones have no Shift+Enter. */
@@ -688,7 +727,13 @@ body.stage-view #dock,body.stage-view #dock:focus-within{background:transparent;
   #infoBar .meta .status{order:-1}
   /* After the status (same order, later in the DOM): the meta scrolls, and only its start is in sight. */
   #infoBar .meta .mem-chip{display:inline;order:-1}
-  #infoBar .meta .dir{word-break:normal}
+  /* The chips get a second line of their own (only when there are some), scrolling sideways. */
+  #infoBar:has(#contextChips:not([hidden])){flex-wrap:wrap;row-gap:4px}
+  #contextChips{flex-wrap:nowrap;overflow-x:auto;scrollbar-width:none}
+  /* The meta scrolls here: a lone "+ URL" would take its width, so it gets the row too. */
+  #contextChips.only-add{flex-basis:100%}
+  #contextChips::-webkit-scrollbar{display:none}
+  #contextChips>*{flex-shrink:0}
   #infoBar button{padding:4px 8px}
   /* Icon-only buttons (the words stay as the accessible name, the title says more): the meta gets the width. */
   #infoBar>button{font-size:0;line-height:0;padding:5px 7px}
@@ -892,6 +937,7 @@ a{color:var(--accent)}
       </div>
       <div id="infoBar">
         <div class="info" id="infoText"></div>
+        <div id="contextChips" aria-label="Attached context" hidden></div>
         <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</button>
         <button class="ghost" id="infoDeleteBtn" title="Delete session (for good)" style="display:none">delete</button>

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

@@ -13,9 +13,11 @@ export function notifyState({ hasNotification, secureContext, permission, wanted
 }
 
 // A finished turn shorter than this was watched: no "done". Not a turn
-// chi ran for a delegate child's report (last_turn origin delegate_report):
-// nobody started it, so nobody watched it.
+// chi ran for a delegate child's report (last_turn origin delegate_report)
+// or an attached context change (context): nobody started it, so nobody
+// watched it.
 export const DONE_MIN_SECONDS = 10;
+const UNWATCHED_ORIGINS = ["delegate_report", "context"];
 
 // The step-limit question (kind "continue": a turn ran out of iterations
 // and asks whether to go on) has its own reason: "out of steps".
@@ -68,7 +70,7 @@ export function attentionFor(prev, next) {
   if (next.parent_id) return null;
   const key = `${next.id}:${turn.ended_at}`;
   if (turn.outcome === "failed") return { reason: "failed", sessionId: next.id, key };
-  if (turn.outcome === "completed" && (Number(turn.seconds) >= DONE_MIN_SECONDS || turn.origin === "delegate_report")) {
+  if (turn.outcome === "completed" && (Number(turn.seconds) >= DONE_MIN_SECONDS || UNWATCHED_ORIGINS.includes(turn.origin))) {
     return { reason: "done", sessionId: next.id, key };
   }
   return null;

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

@@ -163,14 +163,13 @@ export function approvalAllowed(pq, answer) {
 }
 
 // What the card says when an answer or a dismissal didn't go through. 503
-// (the server found no live bridge) reads as the session not running; any
-// other failure — the worker's own (the server maps it to a 502
+// not_live (the server found no live bridge) reads as the session not
+// running; any other failure — the worker's own (the server maps it to a 502
 // bridge_error) or the connection's — shows what it said, so a worker that
 // failed the request is not mistaken for one that is gone.
 export function answerErrorText(error) {
-  const status = error?.status;
   const message = String(error?.message ?? error ?? "");
-  if (status === 503 || /not_live/.test(message)) return "Session is not running — restart it to answer.";
+  if (error?.status === 503 || error?.code === "not_live") return "Session is not running — restart it to answer.";
   return message;
 }
 

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

@@ -0,0 +1,13 @@
+// The texts the running turn already shows (its generations as they close,
+// the bubbles a render drew): turn_completed's answer gets a bubble of its
+// own only when it isn't one of them (it wasn't streamed). A new turn starts
+// over, so an earlier turn's "Done." doesn't hide this one's.
+export function createShownTexts() {
+  let seen = new Set();
+  return {
+    turnStarted() { seen = new Set(); },
+    seed(texts) { seen = new Set(texts.filter(Boolean)); },
+    saw(text) { if (text) seen.add(text); },
+    shows(text) { return seen.has(text); },
+  };
+}

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

@@ -0,0 +1,18 @@
+// A block redrawn every tick (the info bar, once a second while a turn
+// runs) keeps its nodes: +html+ is written only when it changed, so a
+// shown tooltip stays up and a press on one of its buttons isn't lost to a
+// rewrite between mousedown and mouseup. +live+ ({selector: text}) names
+// the parts that change every tick (a running clock): +html+ carries them
+// empty and only their text is set, so a tick alone rewrites nothing else.
+const shown = new WeakMap();
+
+export function renderStable(el, html, live = {}) {
+  if (shown.get(el) !== html) {
+    el.innerHTML = html;
+    shown.set(el, html);
+  }
+  for (const [selector, text] of Object.entries(live)) {
+    const part = el.querySelector(selector);
+    if (part && part.textContent !== text) part.textContent = text;
+  }
+}

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

@@ -112,6 +112,10 @@ export function turnRecordAt(timing, index) {
   return Array.isArray(records) ? records[index] || null : null;
 }
 
+// A history item that starts a turn: a prompt, or the note a context wake
+// turn starts with (turn_start).
+const startsTurn = (item) => item?.role === "user" || (item?.role === "note" && item.turn_start === true);
+
 // For each history item, the turn index its timing shows under, or null. A
 // turn with tool calls holds several assistant messages; only the last one
 // before the next user message carries the turn's timing. A turn with none
@@ -122,7 +126,7 @@ export function timedTurnIndexes(items) {
   let turnIndex = -1;
   let carrier = null;
   items.forEach((item, i) => {
-    if (item?.role === "user") {
+    if (startsTurn(item)) {
       if (carrier !== null) result[carrier] = turnIndex;
       turnIndex += 1;
       carrier = i;
@@ -150,14 +154,14 @@ export function turnGroups(items, timing) {
   let turnIndex = -1;
   let turn = null;
   items.forEach((item, i) => {
-    if (item?.role === "note") {
+    if (item?.role === "note" && !startsTurn(item)) {
       groups.push({ kind: "note", i });
     } else if (item?.role === "steer") {
       if (turn) turn.steers.push(i);
       else groups.push({ kind: "steer", i });
     } else if (item?.role === "user" && item.merged && turn) {
       turn.merged.push(i);
-    } else if (item?.role === "user") {
+    } else if (startsTurn(item)) {
       turnIndex += 1;
       turn = { kind: "turn", turnIndex, turnId: item.turn_id, user: i, texts: [], steers: [], merged: [] };
       groups.push(turn);

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

@@ -93,7 +93,13 @@ export function isOwn(clientId, myId) {
 
 // As the TUI labels them (Formatting::CLIENT_LABELS); this file's label
 // helpers and the TUI's agree per spec/shared/labels_matrix.json.
-const CLIENT_LABELS = Object.freeze({ tui: "tui", web: "web", system: "reminder", delegate: "delegate", child: "delegate report" });
+// By the whole id or its prefix (up to and with its first ":"); an id
+// chi doesn't know is "automatic", not the user (ClientId.human?).
+const CLIENT_LABELS = Object.freeze({
+  "tui:": "tui", "web:": "web", "system:": "reminder", "delegate:": "delegate", "child:": "delegate report",
+  "cli:send": "chi send", "cli:answer": "chi answer", plugin: "plugin",
+});
+const AUTOMATIC_LABEL = "automatic";
 
 // A delegate child's report comes in as client child:<id8> (ChildReports).
 const REPORT_CLIENT = "child:";
@@ -101,10 +107,17 @@ export function isReportClient(clientId) {
   return String(clientId || "").startsWith(REPORT_CLIENT);
 }
 
-// The label on another client's prompt, by its client_id prefix.
+// A turn chi ran because an attached context source changed: context:<name>.
+const CONTEXT_CLIENT = "context:";
+
+// The label on another client's prompt, by its client_id prefix; a context
+// change's turn as "context <name> changed".
 export function clientLabel(clientId) {
   if (!clientId) return null;
-  return CLIENT_LABELS[String(clientId).split(":", 1)[0]] || "user";
+  const id = String(clientId);
+  if (id.startsWith(CONTEXT_CLIENT) && id.length > CONTEXT_CLIENT.length) return `context ${id.slice(CONTEXT_CLIENT.length)} changed`;
+  const colon = id.indexOf(":");
+  return CLIENT_LABELS[id] || (colon >= 0 && CLIENT_LABELS[id.slice(0, colon + 1)]) || AUTOMATIC_LABEL;
 }
 
 // The note for reminders a turn got (a reminder turn has no prompt).

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

@@ -390,7 +390,7 @@ export function createTurnView({
     }
     writeClosedLabel(entry, gen);
     if (!entry.toggled) entry.el.open = false;
-    // Every generation's text goes into seenContent (the turn output dedupe).
+    // Every generation's text goes into the shown texts (the turn output dedupe).
     const k = normalize(gen.text);
     if (k) sawText(k);
   }
@@ -826,7 +826,10 @@ export function turnHistoryHtml(items, timing, { thumbs }) {
     if (group.kind === "steer") return steerHtml(group.i, true);
     if (group.kind === "answer") return answerHtml(items[group.answer], "");
     const prompt = items[group.user];
-    const parts = [`<div class="bubble user"${copySourceAttr(prompt, false)}>${originLabelHtml(prompt)}<div class="user-message">${messageBodyHtml(prompt).body}${thumbs(prompt.images)}</div></div>`];
+    // A context wake turn starts with its note.
+    const parts = [prompt.role === "note"
+      ? `<div class="bubble note">${noteHtml(prompt)}</div>`
+      : `<div class="bubble user"${copySourceAttr(prompt, false)}>${originLabelHtml(prompt)}<div class="user-message">${messageBodyHtml(prompt).body}${thumbs(prompt.images)}</div></div>`];
     const [only] = group.steps;
     const ended = group.answer !== null || group.emptyAnswer != null;
     const textless = only && (only.i === null || !String(items[only.i].content ?? ""));

data/lib/samagotchi/worker.rb

@@ -1,7 +1,11 @@
 # frozen_string_literal: true
 
 require "fileutils"
+require "securerandom"
+require "time"
 
+require_relative "client_id"
+require_relative "config"
 require_relative "events"
 require_relative "session"
 require_relative "session_inbox"
@@ -18,6 +22,8 @@ require_relative "iteration_limit"
 require_relative "session_commands"
 require_relative "model_profile"
 require_relative "child_reports"
+require_relative "context_absorber"
+require_relative "context_poller"
 require_relative "tools/task_runtime"
 
 module Samagotchi
@@ -51,6 +57,9 @@ module Samagotchi
     # gets it over the Bridge a moment after it starts, and that message's
     # turn goes first (the reports join it).
     WAKE_START_GRACE = 2.0
+    # One context wake per source in this long (D5): later changes inside
+    # it arrive as notes.
+    CONTEXT_WAKE_WINDOW = 600
     # How much of a command's output goes into its :command_ran.
     COMMAND_OUTPUT_LIMIT = 4096
     BUSY_OUTPUT = "busy: wait for the turn to end"
@@ -168,6 +177,9 @@ module Samagotchi
       })
       # This session's own delegate children's news (rings in children/).
       @child_reports = ChildReports.new(session_id: @session_id, state_dir: @state_dir)
+      # Its attached context's notes (ContextSources).
+      @context_absorber = ContextAbsorber.new(session_id: @session_id, state_dir: @state_dir,
+                                              project_root: @session.project_root)
       # /model's default is the config's, as in the REPL; the Engine started
       # on the session's model.
       @default_model = ModelProfile.required_model_name(nil)
@@ -211,6 +223,11 @@ module Samagotchi
         # the background, shown by the UIs; a turn waits only for the ones
         # that bring tools.
         @engine.start_init_tasks!
+        # Attached context's commands, in the background; a new text wakes
+        # the loop to absorb it. Not activity: the idle exit stops it.
+        @context_poller = ContextPoller.new(session_id: @session_id, state_dir: @state_dir,
+                                            project_root: @session.project_root, cwd: @session.working_directory,
+                                            on_change: -> { @waker.wake }).start
         loop do
           # Check if the session was externally marked as stopped. Not
           # stopped_on_disk?, which reads a vanished file as "not stopped":
@@ -223,7 +240,10 @@ module Samagotchi
           next if run_queued_commands
 
           # Between turns, so the next turn (the first one too) sees them.
+          # A change that asks to wake may start a turn here (C4), but not
+          # ahead of an exit or restart a client asked for: it is a note then.
           absorb_notes
+          next if absorb_context(wake: nothing_queued? && !@exit_requested)
 
           if (prompt = take_initial_prompt)
             run_initial_prompt(prompt) unless initial_command(prompt)
@@ -263,8 +283,14 @@ module Samagotchi
         # step-limit question stays in the file (a save here would write
         # over a stop's status): with no live worker the lists don't read
         # it as waiting, and the next worker drops it (drop_dead_question).
+        # The context poller first: a command it runs goes (its process
+        # group) before the Engine does.
+        @context_poller&.stop
         @engine&.shutdown
         @bridge&.stop
+        # The process exits next: a parent wake it rang for (a crash's
+        # ring comes just above) must spawn the parent's worker first.
+        ChildRing.await_wakes
       end
     end
 
@@ -372,6 +398,123 @@ module Samagotchi
       claimed.each { |file| FileUtils.rm_f(file) }
     end
 
+    # The attached context's notes (ContextAbsorber), between turns. Not
+    # into a session with no turn yet (+before_turn+: one is about to
+    # run): auto-attached context alone doesn't make a session worth
+    # keeping. Saved, then the subscriptions written (a crash between the
+    # two re-delivers; the note ids dedupe).
+    # +wake+: the session is idle with nothing queued, so an update whose
+    # source asked to wake may start a turn (#context_wake_for): its note
+    # goes in as the turn's first message.
+    # @return [Boolean] whether a wake turn ran
+    def absorb_context(before_turn: false, wake: false)
+      return false unless before_turn || conversation_started?
+      return false if stopped_on_disk?
+
+      batch = @context_absorber.pending
+      return false unless batch
+
+      waking = wake ? context_wake_for(batch) : nil
+      turn_id = SecureRandom.uuid if waking
+      batch.deliveries.each do |delivery|
+        next unless delivery.note
+
+        note = delivery == waking ? delivery.wake_note.merge(turn_start: true, turn_id: turn_id) : delivery.note
+        @engine.add_context_note(@session, note)
+      end
+      # Saved even when every note was there already: after a failed save
+      # they are in memory only.
+      return false if batch.notes.any? && !save_or_log(:context) { @session.save(state_dir: @state_dir) }
+
+      @context_absorber.commit(waking ? woken(batch, waking) : batch)
+      return false unless waking
+
+      run_context_wake_turn(waking, turn_id)
+      true
+    rescue SystemCallError, IOError => e
+      Log.exception(:worker, "context_failed", e)
+      false
+    end
+
+    # No input file or queued command waits: the loop would go idle.
+    def nothing_queued? = @command_queue.empty? && SessionInbox.find_new_input_files(@session_dir).empty?
+
+    # The update in +batch+ that may start a wake turn now: its source
+    # asked (wake: true), context.wake is on, the shared wake step's
+    # conditions hold (no continue offer, wakes not paused by a failed one,
+    # under session.max_wakes in a row with no human input, past the start
+    # grace) and the source hasn't woken the session in the last
+    # CONTEXT_WAKE_WINDOW. The others stay plain notes. Within the start
+    # grace a change is a note: it came while the session was away.
+    def context_wake_for(batch, now: Time.now)
+      candidates = batch.deliveries.select(&:wake_note)
+      return nil if candidates.empty? || !context_wakes_on?
+      return nil if @wakes_paused || @turn_flow.awaiting_continue? || wake_grace_left.positive?
+
+      if @wakes_in_a_row >= max_wakes
+        Log.info(:worker, "context_wake_held", reason: "max_wakes", names: candidates.map(&:name).join(","))
+        return nil
+      end
+      candidates.find { |delivery| !woke_lately?(delivery.subscription, now) }
+    end
+
+    def context_wakes_on? = Config.get("context.wake") != false
+
+    def woke_lately?(subscription, now)
+      at = subscription&.wakes_at && Time.iso8601(subscription.wakes_at)
+      at ? now - at < CONTEXT_WAKE_WINDOW : false
+    rescue ArgumentError
+      false
+    end
+
+    # +batch+ with +waking+'s subscription recording the wake (the 10-minute window).
+    def woken(batch, waking)
+      stamped = waking.with(subscription: waking.subscription.with(wakes_at: Time.now.iso8601))
+      batch.with(deliveries: batch.deliveries.map { |delivery| delivery == waking ? stamped : delivery })
+    end
+
+    # A turn nobody typed for a changed source (a context wake): a continue
+    # turn from context:<name> whose first message is the wake note already
+    # in the conversation (named by +turn_id+), on the same rules as a
+    # delegate report's wake turn: it counts toward session.max_wakes, and
+    # a failure goes back to before the turn (the note stays, as a plain
+    # one: #unmark_wake_note) and pauses wakes until a human's input.
+    # +waking+: the ContextAbsorber::Delivery that woke it.
+    def run_context_wake_turn(waking, turn_id)
+      name = waking.name
+      @wakes_in_a_row += 1
+      Log.info(:worker, "context_wake_turn", name: name, in_a_row: @wakes_in_a_row)
+      @turn_flow.before_prompt_turn
+      run_engine_turn(nil, continue: true, origin: { client_id: "#{ClientId::CONTEXT_PREFIX}#{name}" },
+                           id: turn_id, max_iterations: IterationLimit.for) do |result, error|
+        if error
+          note = TurnNote.failed(error.respond_to?(:summary) ? error.summary : error.message)
+          @turn_flow.prompt_turn_failed(note: note)
+          unmark_wake_note(turn_id, waking.note)
+          @wakes_paused = true
+        else
+          @continue_offer.after_turn(result)
+        end
+      end
+    end
+
+    # A failed wake turn kept nothing but its note: the update goes back to
+    # a plain note (no turn start, the background wording), so a reload
+    # draws no empty turn for it.
+    def unmark_wake_note(turn_id, note)
+      messages = @engine.messages_checkpoint
+      index = messages.index { |m| m[:turn_start] && m[:turn_id] == turn_id }
+      return unless index
+
+      messages[index] = ContextNote.message(**note)
+      @engine.rollback_to(messages)
+    end
+
+    # Whether the session has had a turn: a user or assistant message.
+    def conversation_started?
+      Array(@session.messages).any? { |m| %w[user assistant model].include?((m[:role] || m["role"]).to_s) }
+    end
+
     # The first prompt (spawn_session's): a delegate child's task, which is
     # its parent's although no client sent it.
     def run_initial_prompt(prompt)
@@ -400,6 +543,8 @@ module Samagotchi
     #   its continue turn
     # @param images [Array<Hash>] the prompt's image refs ({file:, name:})
     def run_prompt(prompt, origin, no_interrupt: false, images: [])
+      # A first turn sees the context attached before it.
+      absorb_context(before_turn: true)
       user_input(origin&.dig(:client_id))
       @continue_offer.drop(origin)
       @turn_flow.before_prompt_turn
@@ -425,11 +570,11 @@ module Samagotchi
       @engine.clear_due_reminder_names!
       return false unless @engine.reminders_due?
 
-      @continue_offer.drop({ client_id: SessionManager::REMINDER_CLIENT_ID })
+      @continue_offer.drop({ client_id: ClientId::REMINDER })
       # A failure has no prompt to hand back (the Engine announced
       # :turn_failed). The offer went before the turn
       # (ContinueOffer#drop); either way the rollback window closes.
-      run_engine_turn(nil, continue: true, origin: { client_id: SessionManager::REMINDER_CLIENT_ID },
+      run_engine_turn(nil, continue: true, origin: { client_id: ClientId::REMINDER },
                            max_iterations: IterationLimit.for) { @turn_flow.after_reminder_turn }
       true
     end
@@ -633,8 +778,11 @@ module Samagotchi
       rescue StandardError => e
         error = e
         # Still running: no turn of the Engine's ended (it never began).
+        # It ends here, failed, as an Engine turn would record it: a wait
+        # (ReplyWait) tells a turn's end by last_turn.
         if @session.status == Session::STATUS_RUNNING
           @session.status = Session::STATUS_IDLE
+          @engine.record_last_turn(@session, "failed", 0, turn_args[:origin], { type: :turn_failed })
           Log.warn(:worker, "turn_not_begun", error: e.class.name, msg: e.message)
         end
       ensure
@@ -674,12 +822,12 @@ module Samagotchi
     # Whether the turn starting now is a delegate child's parent's: its
     # task (the initial prompt), a follow-up, a continue the parent
     # answered, a reminder, anything but a human typing into the child
-    # (ArchiveStore.user_input?), and any turn after a question the parent
+    # (ClientId.human?), and any turn after a question the parent
     # was rung about.
     def reports_to_parent?(origin)
       return false unless @session.delegate?
 
-      @initial_turn || @owes_parent || !ArchiveStore.user_input?(origin&.dig(:client_id))
+      @initial_turn || @owes_parent || !ClientId.human?(origin&.dig(:client_id))
     end
 
     # The Engine published a question (after the question desk saved it).
@@ -897,11 +1045,11 @@ module Samagotchi
       Log.info(:worker, "idle_exit", idle_s: @idle_exit.idle_seconds.round)
     end
 
-    # A human's input (ArchiveStore.user_input?) un-archives the session;
+    # A human's input (ClientId.human?) un-archives the session;
     # a delegate's, a plugin's or a reminder's doesn't.
     # It also resets the delegate-report wakes (budget and pause).
     def user_input(client_id)
-      return unless ArchiveStore.user_input?(client_id)
+      return unless ClientId.human?(client_id)
 
       ArchiveStore.user_input(@session_id, state_dir: @state_dir)
       @wakes_in_a_row = 0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: samagotchi
 version: !ruby/object:Gem::Version
-  version: 0.31.0
+  version: 0.33.0
 platform: ruby
 authors:
 - Dmitry Dedov
@@ -125,6 +125,7 @@ files:
 - docs/architecture.md
 - docs/cli.md
 - docs/configuration.md
+- docs/context.md
 - docs/desktop.md
 - docs/guardrails.md
 - docs/hooks.md
@@ -170,6 +171,9 @@ files:
 - lib/samagotchi/bundles/check-in/plugin.rb
 - lib/samagotchi/bundles/core/manifest.yml
 - lib/samagotchi/bundles/dev/manifest.yml
+- lib/samagotchi/bundles/github-pr/manifest.yml
+- lib/samagotchi/bundles/github-pr/plugin.rb
+- lib/samagotchi/bundles/github-pr/scripts/pr_context.rb
 - lib/samagotchi/bundles/guardrails/guardrails.md
 - lib/samagotchi/bundles/guardrails/guardrails/rules.yml
 - lib/samagotchi/bundles/guardrails/guardrails/small-models.yml
@@ -199,12 +203,19 @@ files:
 - lib/samagotchi/cli/flags.rb
 - lib/samagotchi/cli/parent_wait.rb
 - lib/samagotchi/client.rb
+- lib/samagotchi/client_id.rb
 - lib/samagotchi/command_steps.rb
 - lib/samagotchi/commands/registry.rb
 - lib/samagotchi/config.rb
 - lib/samagotchi/config_text_edit.rb
+- lib/samagotchi/context_absorber.rb
+- lib/samagotchi/context_command.rb
+- lib/samagotchi/context_fetch.rb
 - lib/samagotchi/context_note.rb
+- lib/samagotchi/context_poller.rb
+- lib/samagotchi/context_providers.rb
 - lib/samagotchi/context_quote.rb
+- lib/samagotchi/context_sources.rb
 - lib/samagotchi/context_status.rb
 - lib/samagotchi/context_usage.rb
 - lib/samagotchi/context_window.rb
@@ -315,6 +326,7 @@ files:
 - lib/samagotchi/paths.rb
 - lib/samagotchi/pending_input_queue.rb
 - lib/samagotchi/plugin/api.rb
+- lib/samagotchi/plugin/attached_context.rb
 - lib/samagotchi/plugin/context.rb
 - lib/samagotchi/plugin/loader.rb
 - lib/samagotchi/plugin/service.rb
@@ -323,6 +335,7 @@ files:
 - lib/samagotchi/plugin/tool_result.rb
 - lib/samagotchi/plugin_session_state.rb
 - lib/samagotchi/plugin_tasks.rb
+- lib/samagotchi/process_group.rb
 - lib/samagotchi/project_scope.rb
 - lib/samagotchi/prompt.rb
 - lib/samagotchi/prompt_history.rb
@@ -394,6 +407,7 @@ files:
 - lib/samagotchi/tools/builtin_calls.rb
 - lib/samagotchi/tools/builtins.rb
 - lib/samagotchi/tools/cancel_reminder.rb
+- lib/samagotchi/tools/context_read.rb
 - lib/samagotchi/tools/delegate.rb
 - lib/samagotchi/tools/delegate_cursor.rb
 - lib/samagotchi/tools/delegate_relay.rb
@@ -448,6 +462,7 @@ files:
 - lib/samagotchi/web/public/command_list.js
 - lib/samagotchi/web/public/command_view.js
 - lib/samagotchi/web/public/composer_size.js
+- lib/samagotchi/web/public/context_chips.js
 - lib/samagotchi/web/public/copy.js
 - lib/samagotchi/web/public/ctx.js
 - lib/samagotchi/web/public/data.js
@@ -470,6 +485,8 @@ files:
 - lib/samagotchi/web/public/sentences.js
 - lib/samagotchi/web/public/session_state.js
 - lib/samagotchi/web/public/sessions_list.js
+- lib/samagotchi/web/public/shown_texts.js
+- lib/samagotchi/web/public/stable_html.js
 - lib/samagotchi/web/public/stage_model.js
 - lib/samagotchi/web/public/stage_view.js
 - lib/samagotchi/web/public/strip.js