samagotchi 0.37.0 → 0.38.0

data/lib/samagotchi/bundles/system/config_modification_protocol.md

@@ -99,7 +99,7 @@ bundles:
     after: 50                  # tool calls in one turn with no answer before the first check
     every: 50                  # then again every N more
     mode: ask                  # ask (a card) | nudge (nudge the model by itself) | notify; message:, ignore_tools: [...]
-  mcp:                         # tools become mcp_<server>_<tool>; /mcp lists them
+  mcp:                         # the model searches the tools (find_mcp_tools) and calls one (mcp_call, <server>/<tool>); /mcp lists them
     timeout: 60                # per call, seconds; startup_timeout: 10
     servers:
       files:                   # server name
@@ -107,11 +107,12 @@ bundles:
         env: {NODE_OPTIONS: "--no-warnings"}   # optional, added to chi's env
         cwd: ~/scratch                         # optional; default the session's cwd
         tools: [read_*, list_directory]        # optional filter (globs)
+        description: files in ~/scratch        # optional: the server's line in find_mcp_tools (default: its instructions' first sentence)
         attach_image_paths: true               # default: an answer that is only an image's path (temp dir/cwd) is attached as a picture
         start: lazy                            # default: tools from the saved tools/list, the server starts on the first call; eager: with every session
 ```
 
-A guardrail rule's `tool:` may be a glob (`tool: "mcp_*"`, verdict `ask`) to cover every MCP tool; see `docs/guardrails.md`. The mcp bundle saves each server's tool list in `$XDG_STATE_HOME/samagotchi/plugins/mcp/tools-<server>.json` (keyed by a digest of command/env/cwd): a changed server config is picked up by the next session start, which shows "Starting MCP server x (config changed, …)".
+A guardrail rule's `tool:` may be a glob (`tool: "mcp_*"`, verdict `ask`) to cover every MCP tool: an `mcp_call` acts as `mcp_<server>_<tool>`, so `tool: "mcp_github_*"` covers one server's (a `find_mcp_tools` search is never asked about); see `docs/guardrails.md`. A server's optional `description:` is its line in `find_mcp_tools`' description. The mcp bundle saves each server's tool list in `$XDG_STATE_HOME/samagotchi/plugins/mcp/tools-<server>.json` (keyed by a digest of command/env/cwd): a changed server config is picked up by the next session start, which shows "Starting MCP server x (config changed, …)".
 
 **Preservation rule**: `ConfigFile.write_default_model!` and `ConfigFile.write_model_alias!` (`/model --default`, `/model --alias`) change one key on its own line of the text (`ConfigTextEdit`: the user's comments and layout stay; a new key goes at the end of its section, a missing section at the end of the file), check that the result parses to the old data plus that key (else they dump the whole file from it), and write through `AtomicFile` (a unique temp file renamed over config.yml, through a symlink, keeping its mode). Never overwrite the file with only scalar keys — that would clobber `hooks:` / `model_aliases:` / `hosts:` / `recap:` / `guardrails:` / `bundles:`.
 

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

@@ -1,11 +1,11 @@
 ---
 name: samagotchi-system
-version: 0.37.0
+version: 0.38.0
 scope: system
 description: Default system memories — identity, self map, config modification protocol, memory guide and the delegated-session rules
 files:
   identity.md: sha256:29c2f7df9f6c5acbc5ec17000a4490741e55e426af15ca0d81c8706edd9bd027
-  self_map.md: sha256:37063eb74fdcb4cde748f17193ff23f832723eb38f81aff086f48f410ce7497b
-  config_modification_protocol.md: sha256:ec0b0c7023dbf03b93879e51cd5cdc38b22d43a2e5984ee11e8542ace077c3be
+  self_map.md: sha256:245813bd5bd9a0a86eef095ba78b057dd3bfaa389de36d213971f88b51da7cd6
+  config_modification_protocol.md: sha256:648b19b1b9f7ca35fccdd69fee4c9886cb8cfb3748ae86affef7457c12164399
   memory_guide.md: sha256:f7049304a333be842b761037bab5c8e31e890b8f4ad12f092b14ee8deb053c51
   delegated.md: sha256:aedaa1e756a244904c5560fff0424e06fb468bbdcb0358bccefe321d67cd2614

data/lib/samagotchi/bundles/system/self_map.md

@@ -45,7 +45,7 @@
   commands (`anytime:` ones run mid-turn), model tools (they can return images I see), hooks,
   cards, side answers (`ask_model`),
   child sessions and services (e.g. MCP server processes). Shipped: `btw` (`/btw` side question),
-  `mcp` (MCP server tools; a screenshot comes as a picture), `guardrails` (rules), `known-names` (typo guard), `source-links`
+  `mcp` (MCP server tools, searched with find_mcp_tools and called with mcp_call; a screenshot comes as a picture), `guardrails` (rules), `known-names` (typo guard), `source-links`
   (turns source refs like JIRA-123 in an answer into links in the web, and a one-line note), `loop-guard`
   (denies a repeated tool call with the same result, stops the turn after a few, and cuts thinking that
   repeats itself, asking me again), `check-in` (after N tool

data/lib/samagotchi/desktop/macos/App.swift

@@ -4,7 +4,8 @@
 // running after the first launch. `ChiHelper --login on|off|status` (run
 // directly by chi desktop) manages the login item and exits;
 // `ChiHelper --kitty list|send` is the kitty targets' seam (Kitty.swift),
-// `ChiHelper --model-pick` the model chooser's (Models.swift).
+// `ChiHelper --model-pick` the model chooser's (Models.swift),
+// `ChiHelper --broadcast` the Everyone row's (Broadcast.swift).
 import AppKit
 import ServiceManagement
 
@@ -107,6 +108,9 @@ struct ChiHelperMain {
     if args.count >= 2, args[1] == "--model-pick" {
       exit(modelPickCommand(Array(args.dropFirst(2))))
     }
+    if args.count >= 2, args[1] == "--broadcast" {
+      exit(broadcastCommand(Array(args.dropFirst(2))))
+    }
     let app = NSApplication.shared
     let delegate = AppDelegate()
     app.delegate = delegate

data/lib/samagotchi/desktop/macos/Broadcast.swift

@@ -0,0 +1,97 @@
+// The note interface's "Everyone it concerns" row: ⌘⏎ runs `chi broadcast`
+// with the note on stdin instead of `chi note` for picked sessions; chi
+// finds the sessions it concerns (tags, then a triage model). The panel
+// shows "broadcasting…", then the summary line, and stays open; `chi
+// broadcast log` has the details. `ChiHelper --broadcast` is the build
+// spec's seam.
+import Foundation
+
+enum Broadcast {
+  /// broadcast.triage_deadline's default (20 s) + 10 s, for a launch file
+  /// written before it carried broadcast_timeout.
+  static let defaultTimeout: TimeInterval = 30
+
+  /// The launch file's broadcast_timeout (Desktop::MacOS.broadcast_timeout:
+  /// the triage deadline, then the deliveries and chi's start), not
+  /// ChiRunner's 10 s.
+  static func timeout(_ launch: LaunchConfig?) -> TimeInterval {
+    guard let seconds = launch?.broadcastTimeout, seconds > 0 else { return defaultTimeout }
+    return seconds
+  }
+
+  struct Outcome {
+    let ok: Bool
+    let message: String
+  }
+
+  /// What the panel says once chi broadcast ended: the broadcast's id and
+  /// its summary line ("b-7f3a1c9e: delivered 4 · skipped 2"); on a failure,
+  /// the summary, the failed recipients' lines and stderr (a refusal is
+  /// stderr alone).
+  static func outcome(_ result: Result<ChiResult, ChiError>, timeout: TimeInterval) -> Outcome {
+    let r: ChiResult
+    switch result {
+    case .failure(let error): return Outcome(ok: false, message: error.description)
+    case .success(let done): r = done
+    }
+    if r.timedOut {
+      return Outcome(ok: false, message: "chi broadcast took over \(Int(timeout)) s and was stopped; "
+                                       + "the note may be partly delivered (chi broadcast log)")
+    }
+    let lines = r.stdout.split(separator: "\n").map { $0.trimmingCharacters(in: .whitespaces) }.filter { !$0.isEmpty }
+    // "broadcast b-7f3a1c9e  "…"": the first line names it.
+    let id = lines.first.flatMap { line -> String? in
+      let words = line.split(separator: " ")
+      return words.count >= 2 && words[0] == "broadcast" && words[1].hasPrefix("b-") ? String(words[1]) : nil
+    }
+    let summary = lines.last { $0.hasPrefix("delivered ") }.map { line in id.map { "\($0): \(line)" } ?? line }
+    if r.status == 0 {
+      return Outcome(ok: true, message: [summary ?? "Broadcast.", "details: chi broadcast log"].joined(separator: "\n"))
+    }
+    let failed = lines.filter { $0.split(separator: " ").dropFirst().first == "failed" }
+    let err = r.stderr.trimmingCharacters(in: .whitespacesAndNewlines)
+    let parts = ([summary].compactMap { $0 } + failed + [err]).filter { !$0.isEmpty }
+    return Outcome(ok: false, message: parts.isEmpty ? "chi broadcast failed (exit \(r.status))" : parts.joined(separator: "\n"))
+  }
+}
+
+extension ChiRunner {
+  /// `chi broadcast` with +note+ on stdin, under Broadcast.timeout.
+  /// Calls back on +queue+ with the outcome and the timeout it had.
+  func broadcast(_ note: String, queue: DispatchQueue = .main,
+                 completion: @escaping (Broadcast.Outcome, TimeInterval) -> Void) {
+    let timeout = Broadcast.timeout(try? loadLaunch())
+    run(["broadcast"], stdin: Data(note.utf8), timeout: timeout, queue: queue) { result in
+      completion(Broadcast.outcome(result, timeout: timeout), timeout)
+    }
+  }
+}
+
+/// `ChiHelper --broadcast [--launch PATH]`: the note on stdin, the outcome
+/// as JSON on stdout ({"ok", "message", "timeout"}); exit 1 when not ok.
+func broadcastCommand(_ args: [String]) -> Int32 {
+  var args = args
+  var launchPath = ChiRunner.launchPath
+  while !args.isEmpty {
+    let arg = args.removeFirst()
+    switch arg {
+    case "--launch" where !args.isEmpty: launchPath = args.removeFirst()
+    default:
+      FileHandle.standardError.write("usage: ChiHelper --broadcast [--launch PATH]\n".data(using: .utf8)!)
+      return 2
+    }
+  }
+  let note = String(decoding: FileHandle.standardInput.readDataToEndOfFile(), as: UTF8.self)
+  let queue = DispatchQueue(label: "broadcast-command")
+  let done = DispatchSemaphore(value: 0)
+  var status: Int32 = 0
+  ChiRunner(launchPath: launchPath).broadcast(note, queue: queue) { outcome, timeout in
+    let out: [String: Any] = ["ok": outcome.ok, "message": outcome.message, "timeout": Int(timeout)]
+    let data = try! JSONSerialization.data(withJSONObject: out, options: [.sortedKeys])
+    print(String(decoding: data, as: UTF8.self))
+    status = outcome.ok ? 0 : 1
+    done.signal()
+  }
+  done.wait()
+  return status
+}

data/lib/samagotchi/desktop/macos/ChiRunner.swift

@@ -9,6 +9,13 @@ struct LaunchConfig: Decodable {
   let env: [String: String]?
   /// Agents in kitty windows (Kitty.swift); nil = none.
   let kitty: KittySettings?
+  /// Seconds `chi broadcast` may take (Broadcast.swift); nil = the default.
+  let broadcastTimeout: Double?
+
+  enum CodingKeys: String, CodingKey {
+    case version, argv, env, kitty
+    case broadcastTimeout = "broadcast_timeout"
+  }
 }
 
 enum ChiError: Error, CustomStringConvertible {
@@ -102,9 +109,11 @@ final class ChiRunner {
   }
 
   /// Runs `chi <args>` through ProcessRunner (no pipe deadlock near the
-  /// 16 KiB note cap). Calls back on the main queue.
+  /// 16 KiB note cap). Calls back on +queue+ (the main queue by default; a
+  /// headless seam waits on another one); a launch file that can't be read
+  /// calls back at once.
   /// @param timeout this call's limit instead of the runner's
-  func run(_ args: [String], stdin: Data? = nil, timeout: TimeInterval? = nil,
+  func run(_ args: [String], stdin: Data? = nil, timeout: TimeInterval? = nil, queue: DispatchQueue = .main,
            completion: @escaping (Result<ChiResult, ChiError>) -> Void) {
     let config: LaunchConfig
     do { config = try loadLaunch() } catch let error as ChiError {
@@ -115,7 +124,7 @@ final class ChiRunner {
 
     ProcessRunner.run(executable: config.argv[0], args: Array(config.argv.dropFirst()) + args,
                       env: ProcessInfo.processInfo.environment.merging(config.env ?? [:]) { _, baked in baked },
-                      stdin: stdin, timeout: timeout ?? self.timeout, completion: completion)
+                      stdin: stdin, timeout: timeout ?? self.timeout, queue: queue, completion: completion)
   }
 
   /// The live sessions, oldest started first, then up to +recentCount+

data/lib/samagotchi/desktop/macos/Panel.swift

@@ -1,11 +1,12 @@
 // The Spotlight-like panel: a message line on top, the images (a screenshot,
 // Finder files, drops) as thumbnails, the text (selection or clipboard)
-// below as quoted context, then a "New session" row and the targets: live
-// sessions, agents in kitty windows (Kitty.swift), recent sessions. ⏎
-// sends a message (`chi send`, or `chi send --new` on the new row, with
-// `--image` per image; pasted with Enter into a kitty window), ⌘⏎ a note
-// (`chi note`, text only), ⌥⏎ a paste without Enter (kitty windows only),
-// ⇧⏎ a newline. ⌘M (or a click on the new row's model) opens the model
+// below as quoted context, then a "New session" row, an "Everyone it
+// concerns" row and the targets: live sessions, agents in kitty windows
+// (Kitty.swift), recent sessions. ⏎ sends a message (`chi send`, or `chi
+// send --new` on the new row, with `--image` per image; pasted with Enter
+// into a kitty window), ⌘⏎ a note (`chi note`, text only; `chi broadcast`
+// on the Everyone row, Broadcast.swift), ⌥⏎ a paste without Enter (kitty
+// windows only), ⇧⏎ a newline. ⌘M (or a click on the new row's model) opens the model
 // chooser for a new session in place of the targets (Models.swift).
 import AppKit
 import SwiftUI
@@ -41,6 +42,9 @@ final class PanelModel: ObservableObject {
   var touched = false
   /// The "New session" row; never together with sessions (`--new` takes no ids).
   @Published var newSelected = false
+  /// The "Everyone it concerns" row: ⌘⏎ broadcasts (`chi broadcast`);
+  /// never together with the new row or picked targets.
+  @Published var everyoneSelected = false
   /// The model a new session starts on (`chi self --model`), for the new
   /// row's hint; nil while unknown.
   @Published var newModel: String?
@@ -72,8 +76,11 @@ final class PanelModel: ObservableObject {
   }
   var trimmedPrompt: String { prompt.trimmingCharacters(in: .whitespacesAndNewlines) }
   var hasContext: Bool { !text.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty }
+  /// A note's text (stdin of `chi note`): the message line, then the context.
+  var noteText: String { [trimmedPrompt, hasContext ? text : ""].filter { !$0.isEmpty }.joined(separator: "\n\n") }
   var sendEnabled: Bool {
-    canSend && (newSelected || !selectedIds.isEmpty || !selectedKitty.isEmpty) && (!trimmedPrompt.isEmpty || hasContext)
+    canSend && (newSelected || everyoneSelected || !selectedIds.isEmpty || !selectedKitty.isEmpty)
+      && (!trimmedPrompt.isEmpty || hasContext)
   }
   var live: [LiveSession] { sessions.filter { !$0.recent } }
 
@@ -134,6 +141,7 @@ final class PanelModel: ObservableObject {
   func openPicker() {
     touched = true
     newSelected = true
+    everyoneSelected = false
     selected = []
     modelQuery = ""
     pickerIndex = chooserRows.firstIndex(where: isCurrent) ?? 0
@@ -155,6 +163,7 @@ final class PanelModel: ObservableObject {
   func choose(_ row: ModelRow) {
     pickTouched = true
     newSelected = true
+    everyoneSelected = false
     selected = []
     if row.kind == .standard {
       pickedModel = nil
@@ -192,13 +201,20 @@ final class PanelModel: ObservableObject {
 
   func toggle(_ id: String) {
     touched = true
-    if selected.contains(id) { selected.remove(id) } else { selected.insert(id); newSelected = false }
+    if selected.contains(id) { selected.remove(id) } else { selected.insert(id); newSelected = false; everyoneSelected = false }
   }
 
   func toggleNew() {
     touched = true
     newSelected.toggle()
-    if newSelected { selected = [] }
+    if newSelected { selected = []; everyoneSelected = false }
+  }
+
+  /// The preselected session is dropped: a broadcast picks its own.
+  func toggleEveryone() {
+    touched = true
+    everyoneSelected.toggle()
+    if everyoneSelected { selected = []; newSelected = false }
   }
 
   /// Where a new session starts: the helper runs in $HOME, which is in no
@@ -228,6 +244,7 @@ final class PanelModel: ObservableObject {
   /// Who the message goes to, for the placeholder: chi, or the one agent
   /// when only kitty windows running it are chosen.
   var addressee: String {
+    if everyoneSelected { return "everyone it concerns" }
     let agents = Set(selectedKitty.map(\.agent))
     return agents.count == 1 && selectedIds.isEmpty && !newSelected ? agents.first! : "chi"
   }
@@ -257,8 +274,7 @@ struct PanelView: View {
 
   var body: some View {
     VStack(spacing: 0) {
-      // The message is required with images, as in the web.
-      TextField(model.images.isEmpty ? "Ask \(model.addressee)…" : "Say something about the image…", text: $model.prompt, axis: .vertical)
+      TextField(placeholder, text: $model.prompt, axis: .vertical)
         .textFieldStyle(.plain)
         .font(.system(size: 17))
         .lineLimit(1...4)
@@ -294,6 +310,12 @@ struct PanelView: View {
     .onAppear { promptFocused = true }
   }
 
+  /// The message is required with images, as in the web.
+  var placeholder: String {
+    if model.everyoneSelected { return "Tell everyone it concerns… (⌘⏎)" }
+    return model.images.isEmpty ? "Ask \(model.addressee)…" : "Say something about the image…"
+  }
+
   @ViewBuilder var imageStrip: some View {
     if !model.images.isEmpty {
       ScrollView(.horizontal, showsIndicators: false) {
@@ -326,6 +348,7 @@ struct PanelView: View {
           }.padding(10)
         default:
           newRow
+          everyoneRow
           let live = model.live.count, kitty = model.kittyWindows.count
           ForEach(Array(model.targets.prefix(9).enumerated()), id: \.element.id) { index, target in
             if index == live && kitty > 0 { groupHeader("kitty", first: index == 0) }
@@ -416,6 +439,32 @@ struct PanelView: View {
     .background(RoundedRectangle(cornerRadius: 7).fill(on ? Color.accentColor.opacity(0.14) : Color.clear))
   }
 
+  /// `chi broadcast` instead of picked sessions (⌘B): ⌘⏎ shares the note
+  /// with the sessions chi finds it concerns.
+  var everyoneRow: some View {
+    let on = model.everyoneSelected
+    return Button(action: { model.toggleEveryone() }) {
+      HStack(spacing: 10) {
+        Image(systemName: "antenna.radiowaves.left.and.right")
+          .font(.system(size: 14))
+          .foregroundColor(on ? .accentColor : .secondary)
+          .frame(width: 18)
+        VStack(alignment: .leading, spacing: 1) {
+          Text("Everyone it concerns").font(.system(size: 13, weight: .medium)).lineLimit(1)
+          Text("a note for the sessions chi finds it concerns: ⌘⏎").font(.system(size: 11)).foregroundColor(.secondary).lineLimit(1)
+        }
+        Spacer()
+        Text("⌘B").font(.system(size: 11, design: .rounded)).foregroundColor(.secondary)
+      }
+      .padding(.horizontal, 8).padding(.vertical, 6)
+      .background(RoundedRectangle(cornerRadius: 7).fill(on ? Color.accentColor.opacity(0.14) : Color.clear))
+      .contentShape(Rectangle())
+    }
+    .buttonStyle(.plain)
+    .help("chi broadcast: sessions sharing a tag with the note get it, a triage model judges the rest; "
+          + "a first line naming a project keeps it there. Details: chi broadcast log")
+  }
+
   /// The new session's model: grey for the default, accent for a pick; a
   /// click (or ⌘M) opens the chooser.
   var modelLabel: some View {
@@ -528,15 +577,18 @@ struct PanelView: View {
 
   var footer: some View {
     HStack(spacing: 10) {
-      HStack(spacing: 4) {
-        Image(systemName: "arrow.down.doc").font(.system(size: 11)).foregroundColor(.secondary)
-        TextField("source", text: $model.source)
-          .textFieldStyle(.plain)
-          .font(.system(size: 12))
-          .frame(width: 90)
+      // A broadcast's source is "broadcast": no field, more room for its summary.
+      if !model.everyoneSelected {
+        HStack(spacing: 4) {
+          Image(systemName: "arrow.down.doc").font(.system(size: 11)).foregroundColor(.secondary)
+          TextField("source", text: $model.source)
+            .textFieldStyle(.plain)
+            .font(.system(size: 12))
+            .frame(width: 90)
+        }
+        .padding(.horizontal, 8).padding(.vertical, 4)
+        .background(Capsule().fill(Color.primary.opacity(0.07)))
       }
-      .padding(.horizontal, 8).padding(.vertical, 4)
-      .background(Capsule().fill(Color.primary.opacity(0.07)))
 
       HStack(spacing: 0) {
         if !model.origin.isEmpty {
@@ -564,17 +616,26 @@ struct PanelView: View {
         Button("Paste ⌥⏎") { send(.paste) }
           .disabled(!model.sendEnabled)
           .help("paste it into the agent's input without Enter: add more, then press Enter there")
+      } else if model.everyoneSelected {
+        Button("Broadcast ⌘⏎") { send(.note) }
+          .disabled(!model.sendEnabled)
+          .help("share it as a note with every session it concerns (chi broadcast); starts no turn")
       } else {
         Button("Note ⌘⏎") { send(.note) }
           .disabled(!model.sendEnabled || !model.selectedKitty.isEmpty || model.newSelected)
           .help(model.newSelected ? "a note needs a session: pick one, or ⏎ starts a new one with the message"
                                   : "add it as background the model sees on its next turn; starts no turn")
       }
-      Button(action: { send(.message) }) {
-        if model.phase == .sending { ProgressView().controlSize(.small) } else { Text("Send ⏎") }
+      // A broadcast is a note: no Send.
+      if model.everyoneSelected {
+        if model.phase == .sending { ProgressView().controlSize(.small) }
+      } else {
+        Button(action: { send(.message) }) {
+          if model.phase == .sending { ProgressView().controlSize(.small) } else { Text("Send ⏎") }
+        }
+        .disabled(!model.sendEnabled)
+        .help("send it as your message: a turn runs")
       }
-      .disabled(!model.sendEnabled)
-      .help("send it as your message: a turn runs")
     }
     .padding(.horizontal, 14).padding(.vertical, 10)
   }
@@ -744,7 +805,7 @@ final class PanelController: NSObject, NSWindowDelegate {
     return true
   }
 
-  /// ⌘1…⌘9 toggle a target, ⌘0 the new row; ⌘M opens or closes the model
+  /// ⌘1…⌘9 toggle a target, ⌘0 the new row, ⌘B the Everyone row; ⌘M opens or closes the model
   /// chooser, where ⌘1…⌘9 pick a row.
   private func handleKey(_ event: NSEvent) -> Bool {
     let command = event.modifierFlags.intersection(.deviceIndependentFlagsMask) == .command
@@ -759,6 +820,11 @@ final class PanelController: NSObject, NSWindowDelegate {
       model.choose(rows[n - 1])
       return true
     }
+    // By key code, as ⌘M.
+    if command, event.keyCode == 11 {
+      model.toggleEveryone()
+      return true
+    }
     let targets = model.targets
     guard command, let chars = event.charactersIgnoringModifiers, let n = Int(chars),
           n <= min(targets.count, 9) else { return false }
@@ -770,6 +836,7 @@ final class PanelController: NSObject, NSWindowDelegate {
   /// @param returnTo the app to give focus back to on close
   func show(text: String, images: [PanelImage] = [], origin: String, source: String, returnTo app: NSRunningApplication?) {
     returnTo = app
+    opens += 1
     // A show on an open panel resets it without a close.
     dropImages()
     model.prompt = ""
@@ -780,6 +847,7 @@ final class PanelController: NSObject, NSWindowDelegate {
     model.source = source
     model.message = ""
     model.newSelected = false
+    model.everyoneSelected = false
     model.selected = []
     model.touched = false
     model.pickerOpen = false
@@ -875,6 +943,7 @@ final class PanelController: NSObject, NSWindowDelegate {
   /// finished. Images the helper wrote are copied for kitty first (chi's
   /// send deletes them) and deleted only after every job.
   func send(_ kind: SendKind) {
+    if model.everyoneSelected { broadcast(kind); return }
     let ids = model.selectedIds
     let windows = model.selectedKitty
     let new = model.newSelected
@@ -953,6 +1022,35 @@ final class PanelController: NSObject, NSWindowDelegate {
     }
   }
 
+  /// Counts the panel's opens: a broadcast that ends after a reopen leaves
+  /// the new open alone.
+  private var opens = 0
+
+  /// The Everyone row: `chi broadcast` with the note (the source field is
+  /// not used: a broadcast's source is "broadcast"). It stays open with
+  /// the summary line (Esc closes): no auto-close.
+  private func broadcast(_ kind: SendKind) {
+    if kind != .note {
+      NSSound.beep()
+      model.message = "A broadcast is a note: ⌘⏎"
+      return
+    }
+    if !model.images.isEmpty {
+      NSSound.beep()
+      model.message = "A broadcast is text only: remove the images"
+      return
+    }
+    guard model.sendEnabled else { NSSound.beep(); return }
+    model.phase = .sending
+    model.message = "broadcasting…"
+    let open = opens
+    runner.broadcast(model.noteText) { [weak self] outcome, _ in
+      guard let self, self.opens == open else { return }
+      self.model.phase = outcome.ok ? .sent : .failed
+      self.model.message = outcome.message
+    }
+  }
+
   struct SendOutcome {
     let ok: Bool
     let message: String
@@ -980,8 +1078,7 @@ final class PanelController: NSObject, NSWindowDelegate {
       args = ["note"]
       let source = model.source.trimmingCharacters(in: .whitespacesAndNewlines)
       if !source.isEmpty { args += ["--source", source] }
-      let parts = [prompt, model.hasContext ? model.text : ""].filter { !$0.isEmpty }
-      stdin = Data(parts.joined(separator: "\n\n").utf8)
+      stdin = Data(model.noteText.utf8)
     }
     if !new { args += ids }
     // Reading, converting and a new worker's start take longer than text.

data/lib/samagotchi/desktop/macos.rb

@@ -41,6 +41,10 @@ module Samagotchi
       ENV_ALLOWLIST = %w[XDG_CONFIG_HOME XDG_STATE_HOME GEM_HOME GEM_PATH RUBYLIB].freeze
       # Without it Ruby reads stdin as US-ASCII and non-ASCII notes break.
       LANG = "en_US.UTF-8"
+      # chi broadcast's default triage deadline, and the helper's seconds on
+      # top of it (MacOS.broadcast_timeout).
+      BROADCAST_TRIAGE_DEADLINE = 20
+      BROADCAST_MARGIN = 10
 
       # Runs a command without a shell; [output, success].
       class Runner
@@ -62,11 +66,25 @@ module Samagotchi
         { "listen_on" => listen_on, "binary" => get.call("kitty.binary").to_s, "agents" => agents }
       end
 
+      # The helper as chi desktop and chi update make it: the settings it
+      # bakes into the launch file read from the config.
+      def self.from_config(register: true)
+        new(register: register, kitty: kitty_settings, broadcast_timeout: broadcast_timeout)
+      end
+
+      # Seconds the helper gives `chi broadcast` before it stops it: the
+      # triage deadline, then the deliveries and chi's own start. Baked into
+      # the launch file: a changed deadline reaches the helper with chi update.
+      def self.broadcast_timeout(get = Config.method(:get))
+        (get.call("broadcast.triage_deadline") || BROADCAST_TRIAGE_DEADLINE).to_f + BROADCAST_MARGIN
+      end
+
       attr_reader :app_dir, :support_dir
 
       def initialize(app_dir: nil, support_dir: nil, env: ENV, runner: Runner.new,
                      source_dir: SelfReport::SOURCE_DIR, ruby: RbConfig.ruby, version: VERSION,
-                     arch: nil, sources_dir: SOURCES_DIR, register: true, chi_path: nil, kitty: nil)
+                     arch: nil, sources_dir: SOURCES_DIR, register: true, chi_path: nil, kitty: nil,
+                     broadcast_timeout: nil)
         home = env["HOME"] || Dir.home
         @app_dir = app_dir || File.join(home, "Applications")
         @support_dir = support_dir || File.join(home, "Library", "Application Support", APP_NAME)
@@ -80,6 +98,7 @@ module Samagotchi
         @sources_dir = sources_dir
         @register = register
         @kitty = kitty
+        @broadcast_timeout = broadcast_timeout
       end
 
       def app_path = File.join(@app_dir, "#{APP_NAME}.app")
@@ -93,12 +112,13 @@ module Samagotchi
       # shell's PATH), and the allowlisted env. chi is an installed gem's
       # RubyGems wrapper (it activates the gem and outlives upgrades and
       # `gem cleanup`), else this checkout's bin/chi. The kitty section only
-      # when kitty.listen_on is set.
+      # when kitty.listen_on is set; the broadcast timeout when given.
       def launch_config
         env = { "LANG" => LANG }
         ENV_ALLOWLIST.each { |name| env[name] = @env[name] unless @env[name].to_s.empty? }
         config = { "version" => @version, "argv" => [@ruby, @chi_path], "env" => env, "sources_sha" => sources_sha }
         config["kitty"] = @kitty if @kitty
+        config["broadcast_timeout"] = @broadcast_timeout if @broadcast_timeout
         config
       end
 
@@ -122,13 +142,15 @@ module Samagotchi
       end
 
       # The launch file names another chi version or path than this one, or
-      # other kitty settings: refresh_launch_file fixes that without a rebuild.
+      # other kitty settings or broadcast timeout: refresh_launch_file fixes
+      # that without a rebuild.
       def launch_outdated?
         launch = read_launch
-        launch["version"] != @version || Array(launch["argv"]) != launch_config["argv"] || launch["kitty"] != @kitty
+        launch["version"] != @version || Array(launch["argv"]) != launch_config["argv"] || launch["kitty"] != @kitty ||
+          launch["broadcast_timeout"] != @broadcast_timeout
       end
 
-      # Rewrite the launch file for this chi and the kitty settings, keeping
+      # Rewrite the launch file for this chi and its settings, keeping
       # the env it was installed with. The app reads it at each send: no restart.
       def refresh_launch_file
         config = launch_config

data/lib/samagotchi/desktop_command.rb

@@ -41,7 +41,7 @@ module Samagotchi
       @argv = argv.dup
       @stdout = stdout
       @stderr = stderr
-      @platform = platform || ->(register:) { Desktop::MacOS.new(register: register, kitty: Desktop::MacOS.kitty_settings) }
+      @platform = platform || Desktop::MacOS.method(:from_config)
       @supported = supported
     end
 

data/lib/samagotchi/engine.rb

@@ -1531,8 +1531,9 @@ module Samagotchi
     # @param on_event [Proc, nil] receives event hashes
     # @param max_iterations [Integer, nil] max kernel iterations (nil: IterationLimit.for)
     # @param cancel_controller [CancellationController, nil]
-    # @param max_tool_output_chars [Integer, nil] per-output char cap for the
-    #   :tool_call_completed event's `output:` (nil → max_tool_output_chars)
+    # @param max_tool_output_chars [Integer, nil] per-output char cap on what
+    #   the model gets back and the :tool_call_completed event's `output:`
+    #   (nil → max_tool_output_chars)
     # @return [LLM::ModelResult]
     # @param pending_input [#call, nil] optional drain proc returning
     #   Array<String> of steering messages queued while the turn runs; drained

data/lib/samagotchi/kernel_loop.rb

@@ -176,8 +176,9 @@ module Samagotchi
     # @param on_stream_event [Proc, nil]         optional callback for generation events
     # @param cancel_controller [CancellationController, nil] optional cancellation source
     # @param model_name [String, nil]            optional per-run model override
-    # @param max_tool_output_chars [Integer, nil] per-output char cap for the
-    #   :tool_call_completed event's `output:` (nil → max_tool_output_chars)
+    # @param max_tool_output_chars [Integer, nil] per-output char cap on what
+    #   the model gets back and the :tool_call_completed event's `output:`
+    #   (nil → max_tool_output_chars)
     # @param pending_input [#call, nil]  optional drain proc returning
     #   Array<String> of user steering messages queued while the turn runs.
     #   Drained at iteration boundaries (llama.cpp's /completion cannot accept
@@ -223,7 +224,8 @@ module Samagotchi
       @model_key_fallback = fallback
     end
 
-    # Resolve the per-output character cap for the emitted tool call events.
+    # Resolve the per-output character cap for the tool outputs the model
+    # gets back and the emitted tool call events.
     #
     # Precedence: an explicit override wins, then max_tool_output_chars
     # (Config). A non-positive value falls back to
@@ -539,7 +541,7 @@ module Samagotchi
       runs = ToolResponse.run_batch(tool_runner, calls, iteration: turn.iteration, emit: turn.emit,
                                                         on_stream_event: turn.on_stream_event, cap: turn.cap)
       turn.tool_activity.concat(ToolResponse.activities(runs))
-      # One entry for the batch: the full outputs joined (ToolResponse.joined).
+      # One entry for the batch: the capped outputs joined (ToolResponse.joined).
       turn.conversation << ToolResponse.joined(runs)
       turn.pending_tool_calls = true
       :next

data/lib/samagotchi/plugin/api.rb

@@ -178,9 +178,11 @@ module Samagotchi
       # down) and returns a short summary ("3 tools") or raises (the UIs
       # show a warn card). Every UI shows it running (the label) and done.
       # @param label [String] what it does, shown while it runs
-      # @param provides_tools [Boolean] it registers tools (chi.replace_tools):
-      #   a turn sent meanwhile waits for it before its first model request,
-      #   up to +timeout+; a Ctrl-C ends the wait
+      # @param provides_tools [Boolean] it provides what the plugin's tools
+      #   need (its own, or through chi.replace_tools; the mcp bundle's
+      #   index of a server's tools): a turn sent meanwhile waits for it
+      #   before its first model request, up to +timeout+; a Ctrl-C ends
+      #   the wait
       # @param quiet [Boolean] shown only if it fails (a background refresh)
       # @param timeout [Numeric, nil] seconds a turn waits for it (default 60)
       # @param failed [String, nil] the warn card's short title if it raises