switchroom 0.15.39 → 0.15.41

package/dist/host-control/main.js

@@ -13811,6 +13811,8 @@ var AgentMemorySchema = exports_external.object({
     max_memories: exports_external.number().int().min(0).optional().describe("Cap on the number of memories injected into the prompt by " + "auto-recall, regardless of token budget. Plugin default is 12. " + "0 disables the cap (all memories Hindsight returns are injected)."),
     cache_ttl_secs: exports_external.number().int().min(0).optional().describe("Per-session recall cache TTL in seconds. When > 0, identical " + "(prompt, bank) within the same session reuse the cached recall " + "result instead of round-tripping to Hindsight. 0 disables. " + "Default is 600 (10 min) for switchroom-managed agents."),
     min_overlap: exports_external.number().min(0).max(1).optional().describe("Minimum Jaccard token overlap [0.0–1.0] between the user " + "prompt and a memory's text for the memory to be injected. " + "Drops low-relevance matches before the count cap so weak hits " + "don't fill the slot on real queries. 0.0 disables (default — " + "current behaviour). Try 0.10–0.20 to start; observe the " + "`overlap_dropped` field via `switchroom memory recall-log`."),
+    types: exports_external.array(exports_external.string()).optional().describe("Hindsight fact types to recall. Switchroom default is " + '["world", "experience", "observation"] — the synthesized ' + "`observation` tier is on by default. Set to " + '["world", "experience"] to opt out of observation-backed ' + "recall for this agent (or fleet-wide under defaults)."),
+    skip_trivial: exports_external.boolean().optional().describe("Skip recall on plausibly-stateless trivial turns (time/date/" + "greeting). Switchroom default true — saves the recall arm + " + "injected tokens on turns that never need memory, guarded so it " + "never skips a turn that references user/project/session state. " + "Set false to always run recall."),
     topic_filter_mode: exports_external.enum(["soft-preamble", "hard-filter"]).optional().describe("Supergroup-mode cross-topic memory behaviour. Default " + "(unset) → soft-preamble: recall returns memories from all " + "topics, and a 'Current topic: …' preamble tells the model " + "to self-scope. hard-filter: drop any recalled memory whose " + "metadata.thread_id differs from the active inbound's topic. " + "Flip to hard-filter when the recall_log shows binding " + "failures (model surfacing the right memory but applying " + "it to the wrong topic).")
   }).optional().describe("Auto-recall tuning knobs")
 }).optional();

package/dist/vault/approvals/kernel-server.js

@@ -11419,6 +11419,8 @@ var init_schema = __esm(() => {
       max_memories: exports_external.number().int().min(0).optional().describe("Cap on the number of memories injected into the prompt by " + "auto-recall, regardless of token budget. Plugin default is 12. " + "0 disables the cap (all memories Hindsight returns are injected)."),
       cache_ttl_secs: exports_external.number().int().min(0).optional().describe("Per-session recall cache TTL in seconds. When > 0, identical " + "(prompt, bank) within the same session reuse the cached recall " + "result instead of round-tripping to Hindsight. 0 disables. " + "Default is 600 (10 min) for switchroom-managed agents."),
       min_overlap: exports_external.number().min(0).max(1).optional().describe("Minimum Jaccard token overlap [0.0–1.0] between the user " + "prompt and a memory's text for the memory to be injected. " + "Drops low-relevance matches before the count cap so weak hits " + "don't fill the slot on real queries. 0.0 disables (default — " + "current behaviour). Try 0.10–0.20 to start; observe the " + "`overlap_dropped` field via `switchroom memory recall-log`."),
+      types: exports_external.array(exports_external.string()).optional().describe("Hindsight fact types to recall. Switchroom default is " + '["world", "experience", "observation"] — the synthesized ' + "`observation` tier is on by default. Set to " + '["world", "experience"] to opt out of observation-backed ' + "recall for this agent (or fleet-wide under defaults)."),
+      skip_trivial: exports_external.boolean().optional().describe("Skip recall on plausibly-stateless trivial turns (time/date/" + "greeting). Switchroom default true — saves the recall arm + " + "injected tokens on turns that never need memory, guarded so it " + "never skips a turn that references user/project/session state. " + "Set false to always run recall."),
       topic_filter_mode: exports_external.enum(["soft-preamble", "hard-filter"]).optional().describe("Supergroup-mode cross-topic memory behaviour. Default " + "(unset) → soft-preamble: recall returns memories from all " + "topics, and a 'Current topic: …' preamble tells the model " + "to self-scope. hard-filter: drop any recalled memory whose " + "metadata.thread_id differs from the active inbound's topic. " + "Flip to hard-filter when the recall_log shows binding " + "failures (model surfacing the right memory but applying " + "it to the wrong topic).")
     }).optional().describe("Auto-recall tuning knobs")
   }).optional();

package/dist/vault/broker/server.js

@@ -11419,6 +11419,8 @@ var init_schema = __esm(() => {
       max_memories: exports_external.number().int().min(0).optional().describe("Cap on the number of memories injected into the prompt by " + "auto-recall, regardless of token budget. Plugin default is 12. " + "0 disables the cap (all memories Hindsight returns are injected)."),
       cache_ttl_secs: exports_external.number().int().min(0).optional().describe("Per-session recall cache TTL in seconds. When > 0, identical " + "(prompt, bank) within the same session reuse the cached recall " + "result instead of round-tripping to Hindsight. 0 disables. " + "Default is 600 (10 min) for switchroom-managed agents."),
       min_overlap: exports_external.number().min(0).max(1).optional().describe("Minimum Jaccard token overlap [0.0–1.0] between the user " + "prompt and a memory's text for the memory to be injected. " + "Drops low-relevance matches before the count cap so weak hits " + "don't fill the slot on real queries. 0.0 disables (default — " + "current behaviour). Try 0.10–0.20 to start; observe the " + "`overlap_dropped` field via `switchroom memory recall-log`."),
+      types: exports_external.array(exports_external.string()).optional().describe("Hindsight fact types to recall. Switchroom default is " + '["world", "experience", "observation"] — the synthesized ' + "`observation` tier is on by default. Set to " + '["world", "experience"] to opt out of observation-backed ' + "recall for this agent (or fleet-wide under defaults)."),
+      skip_trivial: exports_external.boolean().optional().describe("Skip recall on plausibly-stateless trivial turns (time/date/" + "greeting). Switchroom default true — saves the recall arm + " + "injected tokens on turns that never need memory, guarded so it " + "never skips a turn that references user/project/session state. " + "Set false to always run recall."),
       topic_filter_mode: exports_external.enum(["soft-preamble", "hard-filter"]).optional().describe("Supergroup-mode cross-topic memory behaviour. Default " + "(unset) → soft-preamble: recall returns memories from all " + "topics, and a 'Current topic: …' preamble tells the model " + "to self-scope. hard-filter: drop any recalled memory whose " + "metadata.thread_id differs from the active inbound's topic. " + "Flip to hard-filter when the recall_log shows binding " + "failures (model surfacing the right memory but applying " + "it to the wrong topic).")
     }).optional().describe("Auto-recall tuning knobs")
   }).optional();
@@ -16355,6 +16357,9 @@ class VaultBroker {
     this.passphrase = passphrase;
     this._setReadinessSentinel(true);
   }
+  reload(config) {
+    this.config = config;
+  }
   _setReadinessSentinel(ready) {
     const p = process.env.SWITCHROOM_VAULT_BROKER_READY_PATH;
     if (!p || p.length === 0)
@@ -16425,6 +16430,9 @@ class VaultBroker {
   _getSecretsRef() {
     return this.secrets;
   }
+  _getConfigRef() {
+    return this.config;
+  }
   bindAgentSocket(socketPath) {
     const abs = resolve6(socketPath);
     const agentName = socketPathToAgent(abs);
@@ -17856,6 +17864,19 @@ async function main() {
   }
   const broker = new VaultBroker;
   registerShutdownHandlers(broker);
+  process.on("SIGHUP", () => {
+    (async () => {
+      try {
+        const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_loader(), exports_loader));
+        broker.reload(loadConfig2(configPath));
+        process.stdout.write(`vault-broker: SIGHUP reload — config refreshed
+`);
+      } catch (err) {
+        process.stderr.write(`vault-broker: SIGHUP reload failed (keeping previous config): ${err.message}
+`);
+      }
+    })();
+  });
   if (perAgentTargets.length > 0) {
     await broker.start(legacySocketPath, configPath, vaultPath);
     process.stdout.write(`vault-broker: legacy socket listening on ${legacySocketPath}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "switchroom",
-  "version": "0.15.39",
+  "version": "0.15.41",
   "description": "Run Claude Code 24/7 on your Claude Pro/Max subscription over Telegram. Open-source alternative to OpenClaw and NanoClaw — no API keys.",
   "type": "module",
   "bin": {

package/profiles/_base/start.sh.hbs

@@ -332,6 +332,21 @@ export HINDSIGHT_RECALL_CACHE_TTL_SECS={{hindsightRecallCacheTtlSecs}}
 {{#if (isNumber hindsightRecallMinOverlap)}}
 export HINDSIGHT_RECALL_MIN_OVERLAP={{hindsightRecallMinOverlap}}
 {{/if}}
+# Recall fact types (memory.recall.types cascade). Switchroom default is
+# world,experience,observation (the synthesized `observation` tier is ON
+# by default, set in the plugin settings.json). Export only when the
+# operator OPTED OUT via switchroom.yaml — comma-separated; the env value
+# wins over settings.json. e.g. ["world","experience"] drops
+# observation-backed recall for this agent.
+{{#if hindsightRecallTypes}}
+export HINDSIGHT_RECALL_TYPES="{{hindsightRecallTypes}}"
+{{/if}}
+# Trivial-turn recall skip (memory.recall.skip_trivial cascade). On by
+# default (plugin settings.json). Export only when the operator overrode
+# it; set false to always run recall.
+{{#if hindsightRecallSkipTrivial}}
+export HINDSIGHT_RECALL_SKIP_TRIVIAL={{hindsightRecallSkipTrivial}}
+{{/if}}
 # PR6 — supergroup-mode topic tagging. JSON map of {alias: thread_id}
 # parsed by retain.py + recall.py to (a) stamp chat_id/thread_id/topic_alias
 # into retained memory metadata and (b) emit a "Current topic: …" preamble

package/telegram-plugin/dist/gateway/gateway.js

@@ -23922,6 +23922,8 @@ var init_schema = __esm(() => {
       max_memories: exports_external.number().int().min(0).optional().describe("Cap on the number of memories injected into the prompt by " + "auto-recall, regardless of token budget. Plugin default is 12. " + "0 disables the cap (all memories Hindsight returns are injected)."),
       cache_ttl_secs: exports_external.number().int().min(0).optional().describe("Per-session recall cache TTL in seconds. When > 0, identical " + "(prompt, bank) within the same session reuse the cached recall " + "result instead of round-tripping to Hindsight. 0 disables. " + "Default is 600 (10 min) for switchroom-managed agents."),
       min_overlap: exports_external.number().min(0).max(1).optional().describe("Minimum Jaccard token overlap [0.0\u20131.0] between the user " + "prompt and a memory's text for the memory to be injected. " + "Drops low-relevance matches before the count cap so weak hits " + "don't fill the slot on real queries. 0.0 disables (default \u2014 " + "current behaviour). Try 0.10\u20130.20 to start; observe the " + "`overlap_dropped` field via `switchroom memory recall-log`."),
+      types: exports_external.array(exports_external.string()).optional().describe("Hindsight fact types to recall. Switchroom default is " + '["world", "experience", "observation"] \u2014 the synthesized ' + "`observation` tier is on by default. Set to " + '["world", "experience"] to opt out of observation-backed ' + "recall for this agent (or fleet-wide under defaults)."),
+      skip_trivial: exports_external.boolean().optional().describe("Skip recall on plausibly-stateless trivial turns (time/date/" + "greeting). Switchroom default true \u2014 saves the recall arm + " + "injected tokens on turns that never need memory, guarded so it " + "never skips a turn that references user/project/session state. " + "Set false to always run recall."),
       topic_filter_mode: exports_external.enum(["soft-preamble", "hard-filter"]).optional().describe("Supergroup-mode cross-topic memory behaviour. Default " + "(unset) \u2192 soft-preamble: recall returns memories from all " + "topics, and a 'Current topic: \u2026' preamble tells the model " + "to self-scope. hard-filter: drop any recalled memory whose " + "metadata.thread_id differs from the active inbound's topic. " + "Flip to hard-filter when the recall_log shows binding " + "failures (model surfacing the right memory but applying " + "it to the wrong topic).")
     }).optional().describe("Auto-recall tuning knobs")
   }).optional();
@@ -54519,9 +54521,9 @@ function readTurnActiveMarkerAgeMs(stateDir, now) {
 }
 
 // ../src/build-info.ts
-var VERSION = "0.15.39";
-var COMMIT_SHA = "69e5a2e8";
-var COMMIT_DATE = "2026-06-18T12:27:21+10:00";
+var VERSION = "0.15.41";
+var COMMIT_SHA = "01f41098";
+var COMMIT_DATE = "2026-06-18T14:13:42+10:00";
 var LATEST_PR = null;
 var COMMITS_AHEAD_OF_TAG = 4;
 

package/vendor/hindsight-memory/scripts/lib/config.py

@@ -98,6 +98,15 @@ ENV_OVERRIDES = {
     # [0.0, 1.0]. Set by start.sh from agents.<name>.memory.recall.min_overlap
     # (cascading through defaults). 0.0 = off (current behaviour).
     "HINDSIGHT_RECALL_MIN_OVERLAP": ("recallMinOverlap", float),
+    # Switchroom-local: recall fact types (comma-separated). Set by start.sh
+    # from agents.<name>.memory.recall.types only when the operator overrode
+    # the switchroom default (world,experience,observation) — i.e. the
+    # opt-out path for the synthesized `observation` tier.
+    "HINDSIGHT_RECALL_TYPES": ("recallTypes", list),
+    # Switchroom-local: trivial-turn recall skip (Phase 6a). Set by start.sh
+    # from agents.<name>.memory.recall.skip_trivial only on override; the
+    # switchroom default is on (recall.py falls back to True).
+    "HINDSIGHT_RECALL_SKIP_TRIVIAL": ("recallSkipTrivial", bool),
     "HINDSIGHT_RECALL_MAX_QUERY_CHARS": ("recallMaxQueryChars", int),
     "HINDSIGHT_RECALL_CONTEXT_TURNS": ("recallContextTurns", int),
     "HINDSIGHT_API_PORT": ("apiPort", int),
@@ -121,6 +130,9 @@ def _cast_env(value: str, typ):
             return int(value)
         if typ is float:
             return float(value)
+        if typ is list:
+            # Comma-separated → list of trimmed, non-empty strings.
+            return [t.strip() for t in value.split(",") if t.strip()]
         return value
     except (ValueError, AttributeError):
         return None

package/vendor/hindsight-memory/scripts/recall.py

@@ -42,6 +42,7 @@ Exit codes:
 import hashlib
 import json
 import os
+import re
 import sys
 import time
 
@@ -466,6 +467,57 @@ def read_transcript_messages(transcript_path: str) -> list:
     return messages
 
 
+# Switchroom Phase 6a — stateless-prompt classifier for the recall skip.
+# Returns True ONLY for prompts that provably never need user memory: the
+# current time/date/day, or a bare greeting. Biased hard toward False —
+# any personal pronoun, memory verb, or context word means "could need
+# memory → recall anyway". Trap case: "what host am I on" reads trivial
+# but needs memory; the "i" token blocks the skip.
+_TRIVIAL_GREETINGS = frozenset({
+    "hi", "hello", "hey", "heya", "hiya", "yo", "howdy", "sup",
+    "hey there", "hello there", "hi there",
+    "morning", "good morning", "good afternoon", "good evening", "evening",
+})
+# Any of these as a whole word → do NOT skip (prompt may depend on stored
+# user / project / session state).
+_STATEFUL_SIGNALS = frozenset({
+    "i", "im", "ive", "id", "me", "my", "mine", "myself",
+    "we", "our", "ours", "us", "you", "your", "yours",
+    "remember", "recall", "forget", "forgot", "remind",
+    "last", "earlier", "yesterday", "before", "again", "previously", "recent",
+    "project", "task", "status", "config", "setup", "host", "machine",
+    "running", "deploy", "agent", "memory", "note", "noted",
+})
+# Matched against an apostrophe-stripped form, so "what's"→"whats",
+# "today's"→"todays". Covers "what time is it", "what's the time",
+# "what day is it", "what's today's date", "current time", "time?".
+_STATELESS_QUESTION_RE = re.compile(
+    r"^(?:what(?:s| is)?\s+)?"
+    r"(?:the\s+|current\s+|todays\s+)?"
+    r"(?:time|date|day(?:\s+of\s+(?:the\s+)?week)?)"
+    r"(?:\s+is\s+it)?(?:\s+(?:right\s+now|now|today))?"
+    r"\s*\??$"
+)
+
+
+def _is_trivial_stateless(ack_form, stripped):
+    text = (stripped or "").lower().strip()
+    core = text.strip(" \t\n\r.,!?…👍👌✅🆗🙏")
+    if not core:
+        return False
+    core_noapos = core.replace("'", "")
+    # If any token signals personal / project / session state, bail —
+    # apostrophes stripped so "i'm"/"i've" tokenise to im/ive (stateful).
+    tokens = re.findall(r"[a-z]+", core_noapos)
+    if any(tok in _STATEFUL_SIGNALS for tok in tokens):
+        return False
+    if core in _TRIVIAL_GREETINGS:
+        return True
+    if _STATELESS_QUESTION_RE.match(core_noapos):
+        return True
+    return False
+
+
 def main():
     config = load_config()
 
@@ -522,6 +574,18 @@ def main():
         debug_log(config, f"Prompt is ack-only ({_ack_form!r}), skipping recall")
         return
 
+    # Switchroom Phase 6a (RFC hindsight-synthesis-layers.md) — skip recall
+    # on plausibly-stateless trivial asks (time/date/day, bare greetings)
+    # when `recallSkipTrivial` is on. Same conservatism as the ack-skip:
+    # a false negative (skipping a turn that DID need memory) costs the
+    # remember-across-sessions continuity, so `_is_trivial_stateless`
+    # bails the instant the prompt carries any personal/stateful signal
+    # (a pronoun, a memory verb, "project", etc.). It only skips an exact
+    # stateless form — never a content-classifier guess.
+    if config.get("recallSkipTrivial", True) and _is_trivial_stateless(_ack_form, _stripped):
+        debug_log(config, f"Prompt is trivial/stateless ({_ack_form!r}), skipping recall")
+        return
+
     session_id = hook_input.get("session_id") or ""
 
     # Switchroom #303 — push a "📚 recalling memories" status to the

package/vendor/hindsight-memory/scripts/tests/test_recall_trivial_skip.py

@@ -0,0 +1,101 @@
+"""Switchroom Phase 6a — unit tests for recall.py's trivial-stateless skip.
+
+`_is_trivial_stateless` gates the auto-recall hook: it returns True only
+for prompts that provably never need user memory (current time/date/day,
+bare greetings), so the ~1-2s recall arm + ~1024 injected tokens are
+skipped on those turns. The load-bearing property is the NO-FALSE-NEGATIVE
+guarantee: a prompt that could need memory must never be skipped, because
+skipping it would breach the remember-across-sessions continuity job. The
+KEEP corpus below is that no-regression gate.
+
+Stdlib-only.
+"""
+
+import os
+import sys
+import unittest
+
+SCRIPTS_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
+if SCRIPTS_DIR not in sys.path:
+    sys.path.insert(0, SCRIPTS_DIR)
+
+from recall import _is_trivial_stateless  # noqa: E402
+
+
+# Prompts that provably never need user/session memory — safe to skip.
+TRIVIAL = [
+    "what time is it",
+    "what time is it?",
+    "what time is it now",
+    "what's the time",
+    "time?",
+    "current time",
+    "what's the date",
+    "whats the date",
+    "what's today's date",
+    "what day is it",
+    "what day is it?",
+    "what day is it today",
+    "what day of the week is it",
+    "hi",
+    "hello",
+    "hey",
+    "hey there",
+    "good morning",
+    "morning",
+]
+
+# Prompts that depend on (or might depend on) stored user/project/session
+# state — must NEVER be skipped. This is the no-regression gate.
+NEEDS_MEMORY = [
+    "what host am I on?",          # reads trivial, but needs memory — the "i" trap
+    "what's my config",
+    "what was I frustrated about",
+    "remind me what we discussed",
+    "what's the date for my deadline",   # has 'my'
+    "what's the date of our last deploy",  # 'our'/'last'/'deploy'
+    "what projects do I have",
+    "do you remember my preference",
+    "what's the status of the deploy",
+    "summarize our last conversation",
+    "hello, can you check my open items",  # greeting + real ask
+    "what time did I say the meeting was",  # 'time' but 'i'/'say'
+    "what should I work on",
+    "tell me about the project",
+    "what's the weather",          # stateless-ish but not in the time/date set → recall anyway
+    "how do I fix this",
+]
+
+
+class TestTrivialStatelessSkip(unittest.TestCase):
+    def test_trivial_prompts_are_skipped(self):
+        for p in TRIVIAL:
+            with self.subTest(prompt=p):
+                self.assertTrue(
+                    _is_trivial_stateless("", p),
+                    f"expected trivial/stateless skip for {p!r}",
+                )
+
+    def test_memory_prompts_are_never_skipped(self):
+        # The critical safety invariant — zero false negatives.
+        for p in NEEDS_MEMORY:
+            with self.subTest(prompt=p):
+                self.assertFalse(
+                    _is_trivial_stateless("", p),
+                    f"FALSE NEGATIVE: would skip recall for {p!r} which may need memory",
+                )
+
+    def test_empty_and_whitespace_do_not_skip_here(self):
+        # The <5-char / empty guards live earlier in main(); the classifier
+        # itself returns False for empty so it never short-circuits oddly.
+        self.assertFalse(_is_trivial_stateless("", ""))
+        self.assertFalse(_is_trivial_stateless("", "   "))
+
+    def test_personal_pronoun_blocks_skip(self):
+        # Even a time question is kept the moment a stateful token appears.
+        self.assertTrue(_is_trivial_stateless("", "what time is it"))
+        self.assertFalse(_is_trivial_stateless("", "what time is it for my call"))
+
+
+if __name__ == "__main__":
+    unittest.main()

package/vendor/hindsight-memory/tests/test_config.py

@@ -42,7 +42,7 @@ class TestLoadConfig:
         cfg = load_config()
         assert cfg["autoRecall"] is True
         assert cfg["autoRetain"] is True
-        assert cfg["recallBudget"] == "mid"
+        assert cfg["recallBudget"] == "low"
         assert cfg["retainEveryNTurns"] == 10
 
     def test_settings_json_overrides_defaults(self, tmp_path, monkeypatch):
@@ -75,7 +75,7 @@ class TestLoadConfig:
         monkeypatch.setenv("CLAUDE_PLUGIN_ROOT", str(tmp_path))
         (tmp_path / "settings.json").write_text("not valid json{{")
         cfg = load_config()
-        assert cfg["recallBudget"] == "mid"  # default still applies
+        assert cfg["recallBudget"] == "low"  # default still applies
 
     def test_null_values_in_settings_json_not_applied(self, tmp_path, monkeypatch):
         monkeypatch.setenv("CLAUDE_PLUGIN_ROOT", str(tmp_path))
@@ -112,7 +112,7 @@ class TestLoadConfig:
         # HOME points to tmp_path where no .hindsight/claude-code.json exists
         monkeypatch.setenv("HOME", str(tmp_path))
         cfg = load_config()
-        assert cfg["recallBudget"] == "mid"  # default
+        assert cfg["recallBudget"] == "low"  # default
 
     def test_env_var_wins_over_user_config(self, tmp_path, monkeypatch):
         plugin_root = tmp_path / "plugin"