test_assistant_service.py 90 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680
  1. """Tests for the assistant service (Phase 2) using synthetic event streams."""
  2. import itertools
  3. import json
  4. import re
  5. import threading
  6. import time
  7. from typing import Any
  8. from stt_daemon import events
  9. from stt_daemon.assistant.inference import InferenceJob, InferenceQueue
  10. from stt_daemon.assistant.service import EXECUTE_BUSY, AssistantService
  11. from stt_daemon.assistant.triage import TriageAnalyzer
  12. from stt_daemon.assistant.triage_dump import TriageDumper
  13. from stt_daemon.config import Config
  14. _sequence = itertools.count(1)
  15. # A real analyzer (pure, stdlib-only helpers) backing the fake's retention
  16. # guard so guard behaviour is exercised end to end.
  17. _real_analyzer = TriageAnalyzer(Config().triage)
  18. class Clock:
  19. def __init__(self, start=1000.0):
  20. self.t = float(start)
  21. def __call__(self):
  22. return self.t
  23. def advance(self, dt):
  24. self.t += float(dt)
  25. class FakeSubscriber:
  26. def events(self):
  27. return iter(())
  28. def close(self):
  29. pass
  30. def _service():
  31. cfg = Config()
  32. clock = Clock()
  33. emitted: list[dict] = []
  34. def emit(type_, **fields):
  35. emitted.append({"type": type_, **fields})
  36. service = AssistantService(cfg, FakeSubscriber(), emit=emit, time_fn=clock)
  37. return service, emitted, clock
  38. def _ev(type_, clock, **fields):
  39. event = {"v": 1, "type": type_, "seq": next(_sequence), "ts": clock()}
  40. event.update(fields)
  41. return event
  42. def _transcript(clock, text, ts=None, session_dir=None):
  43. event = {
  44. "v": 1,
  45. "type": events.TRANSCRIPT,
  46. "seq": next(_sequence),
  47. "ts": clock() if ts is None else ts,
  48. "text": text,
  49. }
  50. if session_dir is not None:
  51. event["session_dir"] = session_dir
  52. return event
  53. def test_ready_requires_matching_segment_done():
  54. service, _, clock = _service()
  55. service.handle_event(_ev(events.SPEECH_START, clock))
  56. assert service.ready() is False
  57. service.handle_event(_ev(events.SPEECH_STOP, clock, seg_id=1))
  58. assert service.ready() is False # awaiting segment 1
  59. service.handle_event(_ev(events.SEGMENT_DONE, clock, seg_id=1, emitted=True))
  60. assert service.ready() is True
  61. def test_stale_segment_done_does_not_satisfy_later_turn():
  62. service, _, clock = _service()
  63. service.handle_event(_ev(events.SPEECH_STOP, clock, seg_id=1))
  64. service.handle_event(_ev(events.SPEECH_START, clock))
  65. service.handle_event(_ev(events.SPEECH_STOP, clock, seg_id=2))
  66. service.handle_event(_ev(events.SEGMENT_DONE, clock, seg_id=1, emitted=True))
  67. assert service.ready() is False # still awaiting segment 2
  68. service.handle_event(_ev(events.SEGMENT_DONE, clock, seg_id=2, emitted=True))
  69. assert service.ready() is True
  70. def test_gated_segment_done_clears_readiness():
  71. service, _, clock = _service()
  72. service.handle_event(_ev(events.SPEECH_STOP, clock, seg_id=3))
  73. service.handle_event(_ev(events.SEGMENT_DONE, clock, seg_id=3, emitted=False))
  74. assert service.ready() is True
  75. def test_speech_stop_without_seg_id_clears_readiness():
  76. """A discarded turn closes with speech_stop but no seg_id; readiness must recover."""
  77. service, _, clock = _service()
  78. service.handle_event(_ev(events.SPEECH_START, clock))
  79. assert service.ready() is False
  80. service.handle_event(_ev(events.SPEECH_STOP, clock)) # discarded: no seg_id
  81. assert service.speech_open is False
  82. assert service.awaited_seg_id is None
  83. assert service.ready() is True
  84. def test_status_resets_stale_speech_state_on_reconnect():
  85. service, _, clock = _service()
  86. service.handle_event(_ev(events.SPEECH_START, clock))
  87. assert service.speech_open is True
  88. service.handle_event(_ev(events.STATUS, clock, capture="x", segments_done=0))
  89. assert service.speech_open is False
  90. assert service.awaited_seg_id is None
  91. assert service.ready() is True
  92. def test_command_buffer_uses_arm_timestamp():
  93. service, _, clock = _service()
  94. clock.advance(10)
  95. assert service.arm() is True
  96. arm_ts = service.arm_ts
  97. assert arm_ts is not None
  98. # Replayed transcript from before arming is ignored.
  99. service.handle_event(_transcript(clock, "old", ts=arm_ts - 5))
  100. assert service.command_text == ""
  101. service.handle_event(_transcript(clock, "what time is it"))
  102. assert service.command_text == "what time is it"
  103. def test_mutual_exclusion_between_command_and_chat():
  104. service, _, _ = _service()
  105. assert service.toggle_chat() is True
  106. assert service.arm() is False # cannot arm in chat
  107. assert service.toggle_chat() is True # back to idle
  108. assert service.arm() is True
  109. assert service.toggle_chat() is False # cannot chat while armed
  110. def test_arm_timeout_disarms_and_emits_error():
  111. service, emitted, clock = _service()
  112. service.arm()
  113. clock.advance(service.cfg.assistant.command_arm_timeout_s + 0.1)
  114. service.tick()
  115. assert service.modes.mode.value == "idle"
  116. assert service.command_text == ""
  117. assert any(e["type"] == "error" and e["code"] == "arm_timeout" for e in emitted)
  118. def test_long_speech_does_not_disarm():
  119. service, emitted, clock = _service()
  120. service.arm()
  121. service.handle_event(_ev(events.SPEECH_START, clock))
  122. clock.advance(service.cfg.assistant.command_arm_timeout_s + 30.0)
  123. service.tick()
  124. assert service.modes.mode.value == "command_armed"
  125. assert not any(e["type"] == "error" for e in emitted)
  126. def test_captured_command_survives_arm_timeout():
  127. service, emitted, clock = _service()
  128. service.arm()
  129. service.handle_event(_transcript(clock, "what time is it"))
  130. service.handle_event(_ev(events.SPEECH_STOP, clock, seg_id=1))
  131. service.handle_event(_ev(events.SEGMENT_DONE, clock, seg_id=1, emitted=True))
  132. clock.advance(service.cfg.assistant.command_arm_timeout_s + 30.0)
  133. service.tick()
  134. assert service.modes.mode.value == "command_armed"
  135. assert service.command_text == "what time is it"
  136. assert not any(e["type"] == "error" for e in emitted)
  137. def test_stt_stall_cancels_armed_command():
  138. service, emitted, clock = _service()
  139. service.handle_event(_ev(events.HEARTBEAT, clock, worker_stall_s=0.0))
  140. service.arm()
  141. clock.advance(service.cfg.assistant.stall_timeout_ms / 1000.0 + 0.5)
  142. service.tick()
  143. assert service.modes.mode.value == "idle"
  144. assert any(e["type"] == "error" and e["code"] == "stt_stall" for e in emitted)
  145. def test_worker_stall_marks_stt_degraded():
  146. service, _, clock = _service()
  147. long_stall = service.cfg.assistant.worker_stall_ms / 1000.0 + 1.0
  148. service.handle_event(_ev(events.HEARTBEAT, clock, worker_stall_s=long_stall))
  149. assert service.stt_ok() is False
  150. assert service.ready() is False
  151. def test_chat_idle_timeout_exits_chat():
  152. service, _, clock = _service()
  153. assert service.toggle_chat() is True
  154. clock.advance(service.cfg.assistant.chat_idle_timeout_s + 0.1)
  155. service.tick()
  156. assert service.modes.mode.value == "idle"
  157. def test_chat_exit_phrase_exits_chat():
  158. service, _, clock = _service()
  159. assert service.toggle_chat() is True
  160. service.handle_event(_transcript(clock, "That's all."))
  161. assert service.modes.mode.value == "idle"
  162. assert service.chat_history == []
  163. def test_viewer_detached_exits_chat_and_forgets_history():
  164. service, _, clock = _service()
  165. assert service.toggle_chat() is True
  166. service.handle_event(_transcript(clock, "hello"))
  167. assert service.viewer_detached() is True
  168. assert service.modes.mode.value == "idle"
  169. assert service.chat_history == []
  170. def test_viewer_detached_is_noop_outside_chat():
  171. service, _, _ = _service()
  172. assert service.viewer_detached() is False
  173. assert service.modes.mode.value == "idle"
  174. def test_exit_chat_invokes_chat_reset():
  175. cfg = Config()
  176. resets: list[int] = []
  177. service = AssistantService(
  178. cfg, FakeSubscriber(), time_fn=Clock(), chat_reset=lambda: resets.append(1)
  179. )
  180. service.toggle_chat()
  181. service.viewer_detached()
  182. assert resets == [1]
  183. def test_chat_accumulates_turns():
  184. service, _, clock = _service()
  185. service.toggle_chat()
  186. for text in ("hello there", "how are you"):
  187. service.handle_event(_transcript(clock, text))
  188. assert service.chat_history == ["Unknown: hello there", "Unknown: how are you"]
  189. def test_execute_requires_readiness():
  190. service, _, clock = _service()
  191. service.arm()
  192. service.handle_event(_transcript(clock, "do it"))
  193. service.handle_event(_ev(events.SPEECH_START, clock))
  194. assert service.execute() is None # speech still open
  195. assert service.modes.mode.value == "command_armed"
  196. service.handle_event(_ev(events.SPEECH_STOP, clock, seg_id=1))
  197. assert service.execute() is None # awaiting segment 1
  198. service.handle_event(_ev(events.SEGMENT_DONE, clock, seg_id=1, emitted=True))
  199. assert service.execute() == "do it"
  200. assert service.modes.mode.value == "executing"
  201. assert service.finish() is True
  202. assert service.modes.mode.value == "idle"
  203. def test_execute_reports_busy_when_queue_rejects():
  204. service, emitted, clock = _service()
  205. # A zero-capacity lane rejects the priority command job on submit.
  206. service._inference = InferenceQueue(size=0)
  207. service.executor = object()
  208. service.arm()
  209. service.handle_event(_transcript(clock, "do it"))
  210. service.handle_event(_ev(events.SPEECH_STOP, clock, seg_id=1))
  211. service.handle_event(_ev(events.SEGMENT_DONE, clock, seg_id=1, emitted=True))
  212. assert service.execute() is EXECUTE_BUSY
  213. assert service.modes.mode.value == "idle"
  214. assert not any(e.get("code") == "busy" for e in emitted)
  215. def test_turn_ended_requires_quiet_gap():
  216. service, _, clock = _service()
  217. service.handle_event(_ev(events.SPEECH_STOP, clock, seg_id=1))
  218. service.handle_event(_ev(events.SEGMENT_DONE, clock, seg_id=1, emitted=True))
  219. assert service.ready() is True
  220. assert service.turn_ended() is False
  221. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  222. assert service.turn_ended() is True
  223. def test_emits_mode_and_command_text():
  224. service, emitted, clock = _service()
  225. service.arm()
  226. assert {"type": "mode", "mode": "command_armed"} in emitted
  227. service.handle_event(_transcript(clock, "hi"))
  228. assert any(e["type"] == "command_text" and e["text"] == "hi" for e in emitted)
  229. def test_cancel_clears_command_buffer():
  230. service, _, clock = _service()
  231. service.arm()
  232. service.handle_event(_transcript(clock, "hi"))
  233. assert service.cancel() is True
  234. assert service.modes.mode.value == "idle"
  235. assert service.command_text == ""
  236. assert service.arm_ts is None
  237. def test_pending_chat_is_not_lost_across_threads():
  238. """Transcripts appended on the reader thread while the ticker dispatches
  239. must all reach the model: the join-and-clear in _dispatch_chat is atomic,
  240. and the user bubble is emitted by the worker in _run_chat."""
  241. cfg = Config()
  242. cfg.assistant.turn_gap_s = 0.01
  243. dispatched: list[str] = []
  244. lock = threading.Lock()
  245. def emit(type_, **fields):
  246. if type_ == "chat_message" and fields.get("role") == "user":
  247. with lock:
  248. dispatched.append(fields["text"])
  249. service = AssistantService(cfg, FakeSubscriber(), emit=emit, chat_fn=lambda text: "ok")
  250. service.toggle_chat()
  251. service.start()
  252. try:
  253. total = 200
  254. producer = threading.Thread(
  255. target=lambda: [
  256. service.handle_event(
  257. {
  258. "v": 1,
  259. "type": events.TRANSCRIPT,
  260. "seq": i,
  261. "ts": time.time(),
  262. "text": f"w{i}",
  263. }
  264. )
  265. for i in range(total)
  266. ],
  267. daemon=True,
  268. )
  269. producer.start()
  270. deadline = time.time() + 10.0
  271. while time.time() < deadline:
  272. service.tick()
  273. with lock:
  274. words = sum(len(text.split()) for text in dispatched)
  275. done = words == 2 * total
  276. if not producer.is_alive() and done:
  277. break
  278. time.sleep(0.002)
  279. producer.join(timeout=5)
  280. with lock:
  281. words = sum(len(text.split()) for text in dispatched)
  282. assert words == 2 * total
  283. finally:
  284. service.stop()
  285. def _full_queue_service():
  286. service, emitted, clock = _service()
  287. service.toggle_chat()
  288. service._inference = InferenceQueue(size=1)
  289. service._inference.submit(
  290. InferenceJob(name="blocker", run=lambda: None, evictable=False)
  291. )
  292. return service, emitted, clock
  293. def test_chat_refusal_rebuffers_and_emits_queue_full_once():
  294. """A refused chat submit re-buffers under lock and emits queue_full on flip."""
  295. service, emitted, _ = _full_queue_service()
  296. service._pending_chat = ["hello world"]
  297. service._dispatch_chat()
  298. assert service._pending_chat == ["hello world"]
  299. assert service._chat_queue_full is True
  300. errors = [e for e in emitted if e["type"] == "error" and e.get("code") == "queue_full"]
  301. assert len(errors) == 1
  302. assert [e for e in emitted if e["type"] == "chat_message"] == []
  303. service._dispatch_chat()
  304. assert service._pending_chat == ["hello world"]
  305. errors = [e for e in emitted if e["type"] == "error" and e.get("code") == "queue_full"]
  306. assert len(errors) == 1
  307. def test_chat_dispatch_success_clears_latch_without_user_bubble():
  308. """Success clears the latch; the user bubble comes from _run_chat, not dispatch."""
  309. service, emitted, _ = _full_queue_service()
  310. service._pending_chat = ["hello world"]
  311. service._chat_queue_full = True
  312. service._inference.drop(lambda j: True)
  313. service._dispatch_chat()
  314. assert service._pending_chat == []
  315. assert service._chat_queue_full is False
  316. assert [e for e in emitted if e["type"] == "chat_message"] == []
  317. def test_run_chat_emits_user_first_then_reply():
  318. service, emitted, _ = _service()
  319. service.chat_fn = lambda text: "reply!"
  320. service._run_chat("hello")
  321. assert emitted == [
  322. {"type": "chat_message", "role": "user", "text": "hello"},
  323. {"type": "chat_message", "role": "assistant", "text": "reply!"},
  324. ]
  325. def test_chat_notify_emits_compaction_note():
  326. service, emitted, _ = _service()
  327. service.chat_notify("compacted", turns=4)
  328. assert {
  329. "type": "chat_message",
  330. "role": "note",
  331. "text": "Compacted 4 earlier turns into a summary.",
  332. } in emitted
  333. def test_chat_notify_emits_truncated_error():
  334. service, emitted, _ = _service()
  335. service.chat_notify("truncated", message="cut off")
  336. assert {"type": "error", "code": "truncated", "message": "cut off"} in emitted
  337. def test_clear_empties_chat_history():
  338. service, emitted, clock = _service()
  339. service.toggle_chat()
  340. for text in ("hello", "how are you"):
  341. service.handle_event(_transcript(clock, text))
  342. assert service.chat_history == ["Unknown: hello", "Unknown: how are you"]
  343. assert len(service._pending_chat) == 2
  344. assert service.clear() is True
  345. assert service.chat_history == []
  346. assert service._pending_chat == []
  347. assert {"type": "cleared"} in emitted
  348. def test_clear_invokes_chat_reset():
  349. cfg = Config()
  350. resets: list[int] = []
  351. service = AssistantService(
  352. cfg, FakeSubscriber(), time_fn=Clock(), chat_reset=lambda: resets.append(1)
  353. )
  354. service.toggle_chat()
  355. service.clear()
  356. assert resets == [1]
  357. def test_clear_does_not_change_mode():
  358. service, _, clock = _service()
  359. service.toggle_chat()
  360. assert service.modes.mode.value == "chat"
  361. service.clear()
  362. assert service.modes.mode.value == "chat"
  363. def test_clear_always_returns_true():
  364. service, _, _ = _service()
  365. assert service.clear() is True
  366. service.toggle_chat()
  367. service.handle_event(_ev(events.TRANSCRIPT, Clock(), text="test"))
  368. assert service.clear() is True
  369. def test_heartbeat_emits_inference_depth_and_in_flight():
  370. """Calling tick() emits heartbeat with inference_depth (int) and inference_in_flight (bool)."""
  371. service, emitted, clock = _service()
  372. service.tick()
  373. heartbeats = [e for e in emitted if e["type"] == "heartbeat"]
  374. assert len(heartbeats) == 1
  375. heartbeat = heartbeats[0]
  376. assert "inference_depth" in heartbeat
  377. assert isinstance(heartbeat["inference_depth"], int)
  378. assert "inference_in_flight" in heartbeat
  379. assert isinstance(heartbeat["inference_in_flight"], bool)
  380. def test_status_contains_inference_depth_and_in_flight():
  381. """status() snapshot contains inference_depth (int) and inference_in_flight (bool)."""
  382. service, _, _ = _service()
  383. status = service.status()
  384. assert "inference_depth" in status
  385. assert isinstance(status["inference_depth"], int)
  386. assert "inference_in_flight" in status
  387. assert isinstance(status["inference_in_flight"], bool)
  388. _AUTO = object()
  389. class FakeTriage:
  390. def __init__(
  391. self,
  392. questions=_AUTO,
  393. state_pair=("ok", ""),
  394. escalate=False,
  395. parsed=_AUTO,
  396. normalized=_AUTO,
  397. gate=True,
  398. ):
  399. if questions is _AUTO:
  400. questions = {"urgency": {"type": "noul", "instructions": "how urgent"}}
  401. self._questions = questions
  402. self._state_pair = state_pair
  403. self._escalate = escalate
  404. self._parsed = parsed
  405. self._normalized = normalized
  406. self._gate = gate
  407. self.build_state_calls: list[tuple] = []
  408. self.normalize_calls: list = []
  409. self.prompt_calls: list[tuple] = []
  410. self.gate_calls: list = []
  411. @property
  412. def questions(self):
  413. return self._questions
  414. def state(self):
  415. return self._state_pair
  416. def build_state(self, window):
  417. self.build_state_calls.append(tuple(window))
  418. return "\n".join("- " + str(item) for item in (window or []))
  419. def normalize(self, payload):
  420. self.normalize_calls.append(payload)
  421. if self._normalized is not _AUTO:
  422. return self._normalized
  423. if not isinstance(payload, dict):
  424. return {}
  425. signals = {"order": [], "items": {}, "escalated": False, "input_tokens": 0}
  426. signals.update(payload)
  427. if self._escalate:
  428. signals["escalated"] = True
  429. return signals
  430. def build_brief_prompt(self, deltas, signals):
  431. self.prompt_calls.append(
  432. (tuple(deltas), dict(signals) if isinstance(signals, dict) else signals)
  433. )
  434. return "BRIEF-PROMPT"
  435. def build_pinned_brief_prompt(self, current_brief, deltas, signals):
  436. self.prompt_calls.append(
  437. (tuple(deltas), dict(signals) if isinstance(signals, dict) else signals)
  438. )
  439. body = "\n".join("- " + d for d in deltas)
  440. return (
  441. f"CURRENT BRIEF:\n{current_brief or '(none yet)'}\n\nNEW UTTERANCES:\n{body}"
  442. )
  443. def extract_bullets(self, brief):
  444. return _real_analyzer.extract_bullets(brief)
  445. def restore_missing_bullets(self, new_brief, prior_brief):
  446. return _real_analyzer.restore_missing_bullets(new_brief, prior_brief)
  447. def parse_brief(self, text):
  448. if self._parsed is _AUTO:
  449. return text if text else None
  450. return self._parsed
  451. def should_update_brief(self, signals):
  452. self.gate_calls.append(signals)
  453. return self._gate
  454. class FakeBriefFile:
  455. """Recording stand-in for BriefFile (write/clear/set_directory never raise)."""
  456. def __init__(self):
  457. self.writes: list[str] = []
  458. self.clears = 0
  459. self.directories: list[str] = []
  460. def set_directory(self, directory):
  461. self.directories.append(directory)
  462. def write(self, text):
  463. self.writes.append(text)
  464. def clear(self):
  465. self.clears += 1
  466. class FakeLane:
  467. def __init__(self, ready=True):
  468. self._ready = ready
  469. self.submits: list[tuple] = []
  470. self.drops = 0
  471. self.predict_gate = threading.Event()
  472. def ready(self):
  473. return self._ready
  474. def state(self):
  475. return ("ok", "") if self._ready else ("loading", "")
  476. def submit(self, state, questions, lang, generation):
  477. self.submits.append((state, questions, lang, generation))
  478. return True
  479. def drop_pending(self):
  480. self.drops += 1
  481. class FakeDebugSink:
  482. def __init__(self):
  483. self.events: list[tuple] = []
  484. def emit(self, type_, **fields):
  485. self.events.append((type_, fields))
  486. def _ok_reply(text):
  487. return "ok"
  488. def _triage_service(
  489. triage=None,
  490. lane=None,
  491. brief_fn=None,
  492. chat_fn: Any = _AUTO,
  493. brief_file=None,
  494. brief_reset=None,
  495. chat_reset=None,
  496. debug_sink=None,
  497. ):
  498. cfg = Config()
  499. cfg.assistant.turn_gap_s = 0.5
  500. clock = Clock()
  501. emitted: list[dict] = []
  502. def emit(type_, **fields):
  503. emitted.append({"type": type_, **fields})
  504. if triage is None:
  505. triage = FakeTriage()
  506. if lane is None:
  507. lane = FakeLane()
  508. if chat_fn is _AUTO:
  509. chat_fn = _ok_reply
  510. factory = (lambda: debug_sink) if debug_sink is not None else None
  511. service = AssistantService(
  512. cfg,
  513. FakeSubscriber(),
  514. emit=emit,
  515. time_fn=clock,
  516. triage=triage,
  517. laya_lane=lane,
  518. brief_fn=brief_fn,
  519. brief_reset=brief_reset,
  520. brief_file=brief_file,
  521. chat_fn=chat_fn,
  522. chat_reset=chat_reset,
  523. debug_sink_factory=factory,
  524. )
  525. return service, emitted, clock, triage, lane
  526. def _triage_events(emitted):
  527. return [e for e in emitted if e["type"] == "triage"]
  528. def _escalated_payload():
  529. return {"order": [], "items": {}, "escalated": True, "input_tokens": 3}
  530. def test_triage_status_disabled_when_no_analyzer():
  531. service, _, _ = _service()
  532. status = service.status()
  533. assert status["triage_state"] == "disabled"
  534. assert status["triage_reason"] == ""
  535. assert status["triage"] is None
  536. def test_triage_status_reflects_analyzer():
  537. service, _, _, _, _ = _triage_service(
  538. triage=FakeTriage(state_pair=("loading", "warming up"))
  539. )
  540. status = service.status()
  541. assert status["triage_state"] == "loading"
  542. assert status["triage_reason"] == "warming up"
  543. assert status["triage"] is None
  544. def test_status_contains_questions_from_analyzer():
  545. questions = {
  546. "urgency": {"type": "noul", "instructions": "how urgent"},
  547. "sentiment": {"type": "score", "instructions": "tone", "criteria": ["low", "high"]},
  548. }
  549. service, _, _, triage, _ = _triage_service(triage=FakeTriage(questions=questions))
  550. status = service.status()
  551. assert status["questions"] == questions
  552. assert status["questions"] is triage.questions
  553. def test_status_questions_none_without_analyzer():
  554. service, _, _ = _service()
  555. assert service.status()["questions"] is None
  556. def test_status_event_carries_questions():
  557. service, emitted, _, triage, _ = _triage_service()
  558. service.tick()
  559. statuses = [e for e in emitted if e["type"] == "status"]
  560. assert len(statuses) == 1
  561. assert statuses[0]["questions"] is triage.questions
  562. def test_triage_captures_transcript_lang():
  563. service, _, clock, _, _ = _triage_service()
  564. assert service._last_transcript_lang is None
  565. event = _transcript(clock, "hola")
  566. event["lang"] = "es"
  567. service.handle_event(event)
  568. assert service._last_transcript_lang == "es"
  569. service.handle_event(_transcript(clock, "hello"))
  570. assert service._last_transcript_lang is None
  571. def test_maybe_triage_passes_lang_to_lane():
  572. service, _, clock, _, lane = _triage_service()
  573. event = _transcript(clock, "hola")
  574. event["lang"] = "es"
  575. service.handle_event(event)
  576. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  577. service.tick()
  578. assert len(lane.submits) == 1
  579. _, _, lang, _ = lane.submits[0]
  580. assert lang == "es"
  581. def test_maybe_triage_runs_in_idle_mode():
  582. service, _, clock, triage, lane = _triage_service()
  583. service.handle_event(_transcript(clock, "hello"))
  584. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  585. service.tick()
  586. assert len(lane.submits) == 1
  587. state, questions, lang, gen = lane.submits[0]
  588. assert state == "- hello"
  589. assert questions is triage.questions
  590. assert lang is None
  591. assert gen == 0
  592. assert triage.build_state_calls == [("hello",)]
  593. assert service.triage_history == ["hello"]
  594. def test_maybe_triage_uses_transcript_buffer_not_chat_history():
  595. service, _, clock, triage, lane = _triage_service(chat_fn=None)
  596. service.chat_history = ["stale chat only"]
  597. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  598. service.tick()
  599. assert lane.submits == []
  600. assert triage.build_state_calls == []
  601. service.handle_event(_transcript(clock, "hello"))
  602. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  603. service.tick()
  604. assert len(lane.submits) == 1
  605. assert triage.build_state_calls == [("hello",)]
  606. def test_maybe_triage_requires_settled_turn():
  607. service, _, clock, _, lane = _triage_service()
  608. service.handle_event(_transcript(clock, "hello"))
  609. service.tick()
  610. assert lane.submits == []
  611. def test_maybe_triage_periodic_fires_before_turn_settles():
  612. service, _, clock, _, lane = _triage_service()
  613. service.cfg.triage.periodic_s = 0.2
  614. service.handle_event(_transcript(clock, "hello"))
  615. assert service.turn_ended() is False
  616. clock.advance(0.25) # due (0.2) yet still quieter than turn_gap_s (0.5)
  617. service.tick()
  618. assert service.turn_ended() is False
  619. assert len(lane.submits) == 1
  620. assert lane.submits[0][0] == "- hello"
  621. def test_maybe_triage_periodic_disabled_ignores_accumulating_speech():
  622. service, _, clock, _, lane = _triage_service()
  623. service.cfg.triage.periodic_s = 0.0
  624. service.handle_event(_transcript(clock, "hello"))
  625. clock.advance(0.25)
  626. service.tick()
  627. assert service.turn_ended() is False
  628. assert lane.submits == []
  629. def test_maybe_triage_periodic_rearms_after_submit():
  630. service, _, clock, _, lane = _triage_service()
  631. service.cfg.triage.periodic_s = 0.2
  632. service.handle_event(_transcript(clock, "first"))
  633. clock.advance(0.25)
  634. service.tick()
  635. assert len(lane.submits) == 1
  636. service.tick()
  637. service.tick()
  638. assert len(lane.submits) == 1 # identical window, no new speech
  639. service.handle_event(_transcript(clock, "second"))
  640. clock.advance(0.25)
  641. service.tick()
  642. assert len(lane.submits) == 2
  643. assert lane.submits[1][0] == "- first\n- second"
  644. def test_triage_debug_emits_submit_and_result():
  645. sink = FakeDebugSink()
  646. service, _, clock, _, lane = _triage_service(debug_sink=sink)
  647. service.handle_event(_transcript(clock, "hello"))
  648. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  649. service.tick()
  650. submits = [event for event in sink.events if event[0] == "triage-submit"]
  651. assert submits == [
  652. ("triage-submit", {"trigger": "settled", "window": 1, "generation": 0})
  653. ]
  654. _, _, _, gen = lane.submits[0]
  655. service._on_triage_result(gen, _escalated_payload())
  656. results = [event for event in sink.events if event[0] == "triage-result"]
  657. assert len(results) == 1
  658. assert results[0][1]["escalated"] is True
  659. assert results[0][1]["generation"] == 0
  660. def test_triage_debug_marks_periodic_trigger():
  661. sink = FakeDebugSink()
  662. service, _, clock, _, lane = _triage_service(debug_sink=sink)
  663. service.cfg.triage.periodic_s = 0.2
  664. service.handle_event(_transcript(clock, "hello"))
  665. clock.advance(0.25)
  666. service.tick()
  667. submits = [event for event in sink.events if event[0] == "triage-submit"]
  668. assert submits[0][1]["trigger"] == "periodic"
  669. def test_triage_debug_emits_brief_dispatch():
  670. sink = FakeDebugSink()
  671. service, _, clock, _, lane = _triage_service(
  672. brief_fn=lambda prompt: "RAW", debug_sink=sink
  673. )
  674. service.handle_event(_transcript(clock, "hello"))
  675. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  676. service.tick()
  677. _, _, _, gen = lane.submits[0]
  678. service._on_triage_result(gen, _escalated_payload())
  679. brief = [event for event in sink.events if event[0] == "triage-brief"]
  680. assert brief == [("triage-brief", {"action": "dispatch", "generation": 0})]
  681. def test_triage_debug_emits_brief_gate_skip():
  682. sink = FakeDebugSink()
  683. service, _, clock, _, lane = _triage_service(
  684. triage=FakeTriage(gate=False), brief_fn=lambda prompt: "RAW", debug_sink=sink
  685. )
  686. service.handle_event(_transcript(clock, "hello"))
  687. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  688. service.tick()
  689. _, _, _, gen = lane.submits[0]
  690. service._on_triage_result(gen, _escalated_payload())
  691. brief = [event for event in sink.events if event[0] == "triage-brief"]
  692. assert brief == [
  693. ("triage-brief", {"action": "skip", "reason": "gate", "generation": 0})
  694. ]
  695. def test_maybe_triage_skips_unready_lane():
  696. service, _, clock, _, lane = _triage_service(lane=FakeLane(ready=False))
  697. service.handle_event(_transcript(clock, "hello"))
  698. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  699. service.tick()
  700. assert lane.submits == []
  701. def test_maybe_triage_skips_without_questions():
  702. service, _, clock, triage, lane = _triage_service(
  703. triage=FakeTriage(questions=None)
  704. )
  705. service.handle_event(_transcript(clock, "hello"))
  706. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  707. service.tick()
  708. assert lane.submits == []
  709. assert triage.build_state_calls == []
  710. def test_maybe_triage_dedupes_identical_window():
  711. service, _, clock, triage, lane = _triage_service()
  712. service.handle_event(_transcript(clock, "hello"))
  713. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  714. service.tick()
  715. assert len(lane.submits) == 1
  716. state, questions, lang, gen = lane.submits[0]
  717. assert state == "- hello"
  718. assert questions is triage.questions
  719. assert lang is None
  720. assert gen == 0
  721. service.tick()
  722. service.tick()
  723. assert len(lane.submits) == 1
  724. service.handle_event(_transcript(clock, "second"))
  725. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  726. service.tick()
  727. assert len(lane.submits) == 2
  728. assert lane.submits[1][0] == "- hello\n- second"
  729. def test_second_transcript_produces_second_submit():
  730. service, _, clock, _, lane = _triage_service()
  731. service.handle_event(_transcript(clock, "first"))
  732. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  733. service.tick()
  734. assert len(lane.submits) == 1
  735. service.handle_event(_transcript(clock, "second"))
  736. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  737. service.tick()
  738. assert len(lane.submits) == 2
  739. assert lane.submits[1][0] == "- first\n- second"
  740. def test_tick_under_50ms_with_blocked_lane():
  741. service, _, clock, _, lane = _triage_service()
  742. assert not lane.predict_gate.is_set()
  743. service.toggle_chat()
  744. service.handle_event(_transcript(clock, "hello"))
  745. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  746. start = time.perf_counter()
  747. service.tick()
  748. elapsed = time.perf_counter() - start
  749. assert len(lane.submits) == 1
  750. assert elapsed < 0.05
  751. def test_on_triage_result_emits_signals():
  752. service, emitted, clock, _, lane = _triage_service()
  753. service.toggle_chat()
  754. service.handle_event(_transcript(clock, "hello"))
  755. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  756. service.tick()
  757. _, _, _, gen = lane.submits[0]
  758. payload = {
  759. "order": ["urgency"],
  760. "items": {"urgency": {"kind": "noul"}},
  761. "escalated": False,
  762. "input_tokens": 12,
  763. }
  764. service._on_triage_result(gen, payload)
  765. staged = _triage_events(emitted)
  766. assert len(staged) == 1
  767. assert staged[0]["stage"] == "signals"
  768. assert staged[0]["triage"] == service.last_triage
  769. assert staged[0]["triage"]["escalated"] is False
  770. assert staged[0]["triage"]["input_tokens"] == 12
  771. assert service.status()["triage"] == service.last_triage
  772. def test_triage_events_carry_the_server_timestamp():
  773. service, emitted, clock, _, lane = _triage_service(brief_fn=lambda prompt: "RAW")
  774. service.toggle_chat()
  775. service.handle_event(_transcript(clock, "hello"))
  776. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  777. service.tick()
  778. _, _, _, gen = lane.submits[0]
  779. expected_ts = clock()
  780. service._on_triage_result(gen, _escalated_payload())
  781. signals = [e for e in _triage_events(emitted) if e.get("stage") == "signals"]
  782. assert len(signals) == 1
  783. assert isinstance(signals[0]["ts"], (int, float))
  784. assert signals[0]["ts"] == expected_ts
  785. job = [j for j in service._inference._queue if j.name == "brief-update"][0]
  786. job.run()
  787. contents = [e for e in _triage_events(emitted) if e.get("stage") == "content"]
  788. assert len(contents) == 1
  789. assert isinstance(contents[0]["ts"], (int, float))
  790. assert contents[0]["ts"] == expected_ts # content reuses the signals timestamp
  791. def test_on_triage_result_suppresses_stale_generation():
  792. service, emitted, clock, _, lane = _triage_service()
  793. service.toggle_chat()
  794. service.handle_event(_transcript(clock, "hello"))
  795. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  796. service.tick()
  797. _, _, _, gen = lane.submits[0]
  798. service.clear()
  799. service._on_triage_result(gen, _escalated_payload())
  800. assert service.last_triage is None
  801. assert [e for e in _triage_events(emitted) if e.get("stage") == "signals"] == []
  802. service.handle_event(_transcript(clock, "hello"))
  803. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  804. service.tick()
  805. assert len(lane.submits) == 2
  806. def test_pending_brief_capped_by_char_budget():
  807. """The buffer keeps the newest deltas within budget, dropping the oldest."""
  808. service, _, clock, _, _ = _triage_service(brief_fn=lambda prompt: "RAW")
  809. service.cfg.triage.brief_pending_char_budget = 30
  810. service.handle_event(_transcript(clock, "aaa"))
  811. service.handle_event(_transcript(clock, "bbbb"))
  812. assert service._pending_brief == ["Unknown: aaa", "Unknown: bbbb"]
  813. service.handle_event(_transcript(clock, "ccccc"))
  814. assert service._pending_brief == ["Unknown: bbbb", "Unknown: ccccc"]
  815. assert service.triage_history == ["aaa", "bbbb", "ccccc"]
  816. def test_pending_brief_untouched_without_triage():
  817. service, _, clock = _service()
  818. service.handle_event(_transcript(clock, "hello"))
  819. assert service._pending_brief == []
  820. assert service.triage_history == ["hello"]
  821. def test_on_triage_result_accepts_non_chat_mode():
  822. service, emitted, clock, _, lane = _triage_service()
  823. service.handle_event(_transcript(clock, "hello"))
  824. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  825. service.tick()
  826. _, _, _, gen = lane.submits[0]
  827. window = service._last_triage_window
  828. service._on_triage_result(gen, _escalated_payload())
  829. assert service.last_triage is not None
  830. assert service._last_triage_window == window
  831. assert [e.get("stage") for e in _triage_events(emitted)] == ["signals"]
  832. def test_on_triage_result_ignores_none_payload():
  833. service, emitted, clock, _, lane = _triage_service()
  834. service.toggle_chat()
  835. service.handle_event(_transcript(clock, "hello"))
  836. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  837. service.tick()
  838. _, _, _, gen = lane.submits[0]
  839. service._on_triage_result(gen, None)
  840. assert service.last_triage is None
  841. assert _triage_events(emitted) == []
  842. def test_none_payload_dispatches_nothing_and_keeps_deltas():
  843. """A Laya predict failure never dispatches: no job, no events, deltas stay."""
  844. calls: list[str] = []
  845. service, emitted, clock, _, lane = _triage_service(
  846. brief_fn=lambda prompt: calls.append(prompt) or "RAW"
  847. )
  848. service.toggle_chat()
  849. service.handle_event(_transcript(clock, "hello"))
  850. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  851. service.tick()
  852. _, _, _, gen = lane.submits[0]
  853. assert service._pending_brief == ["Unknown: hello"]
  854. service._on_triage_result(gen, None)
  855. assert service.last_triage is None
  856. assert [e.get("stage") for e in _triage_events(emitted)] == []
  857. assert [j.name for j in service._inference._queue] == ["chat"]
  858. assert calls == []
  859. assert service._pending_brief == ["Unknown: hello"]
  860. assert service._brief_outstanding is False
  861. def test_none_payload_without_brief_fn_enqueues_nothing():
  862. service, emitted, clock, _, lane = _triage_service()
  863. service.toggle_chat()
  864. service.handle_event(_transcript(clock, "hello"))
  865. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  866. service.tick()
  867. _, _, _, gen = lane.submits[0]
  868. service._on_triage_result(gen, None)
  869. assert service.last_triage is None
  870. assert _triage_events(emitted) == []
  871. assert [j.name for j in service._inference._queue] == ["chat"]
  872. assert service._pending_brief == ["Unknown: hello"]
  873. def test_on_triage_result_ignores_empty_signals():
  874. service, emitted, clock, _, lane = _triage_service(
  875. triage=FakeTriage(normalized={})
  876. )
  877. service.toggle_chat()
  878. service.handle_event(_transcript(clock, "hello"))
  879. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  880. service.tick()
  881. _, _, _, gen = lane.submits[0]
  882. service._on_triage_result(gen, _escalated_payload())
  883. assert service.last_triage is None
  884. assert _triage_events(emitted) == []
  885. def test_substantive_turn_dispatches_one_brief_job():
  886. """A substantive settled turn calls the gate once and queues one brief job."""
  887. service, emitted, clock, triage, lane = _triage_service(
  888. triage=FakeTriage(escalate=True), brief_fn=lambda prompt: "RAW"
  889. )
  890. service.toggle_chat()
  891. service.handle_event(_transcript(clock, "we might churn"))
  892. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  893. service.tick()
  894. _, _, _, gen = lane.submits[0]
  895. service._on_triage_result(
  896. gen, {"order": [], "items": {}, "escalated": False, "input_tokens": 0}
  897. )
  898. assert service.last_triage is not None
  899. assert service.last_triage["escalated"] is True
  900. assert service._last_brief_signals == service.last_triage
  901. assert service._inference.depth() == 2
  902. assert [j.name for j in service._inference._queue] == ["chat", "brief-update"]
  903. assert [e.get("stage") for e in _triage_events(emitted)] == ["signals"]
  904. assert len(triage.gate_calls) == 1
  905. assert service._brief_outstanding is True
  906. assert service._brief_token == 1
  907. def test_brief_dispatches_without_escalation():
  908. service, _, clock, _, lane = _triage_service(brief_fn=lambda prompt: "RAW")
  909. service.toggle_chat()
  910. service.handle_event(_transcript(clock, "all calm"))
  911. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  912. service.tick()
  913. _, _, _, gen = lane.submits[0]
  914. service._on_triage_result(
  915. gen, {"order": [], "items": {}, "escalated": False, "input_tokens": 0}
  916. )
  917. assert service.last_triage is not None
  918. assert service._inference.depth() == 2
  919. assert [j.name for j in service._inference._queue] == ["chat", "brief-update"]
  920. def test_gated_out_turn_skips_brief():
  921. """A gated-out turn stores signals but never calls brief_fn."""
  922. calls: list[str] = []
  923. service, emitted, clock, triage, lane = _triage_service(
  924. triage=FakeTriage(gate=False),
  925. brief_fn=lambda prompt: calls.append(prompt) or "RAW",
  926. )
  927. service.toggle_chat()
  928. service.handle_event(_transcript(clock, "small talk"))
  929. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  930. service.tick()
  931. _, _, _, gen = lane.submits[0]
  932. service._on_triage_result(gen, _escalated_payload())
  933. assert service.last_triage is not None
  934. assert "brief" not in service.last_triage # no prior brief to retain
  935. assert [e.get("stage") for e in _triage_events(emitted)] == ["signals"]
  936. assert calls == []
  937. assert [j.name for j in service._inference._queue] == ["chat"]
  938. assert service._brief_outstanding is False
  939. assert len(triage.gate_calls) == 1
  940. def test_gated_out_turn_retains_previous_brief():
  941. """A gated-out settled turn keeps the last accepted brief in the panel."""
  942. service, emitted, clock, triage, lane = _triage_service(
  943. triage=FakeTriage(gate=False), brief_fn=lambda prompt: "RAW"
  944. )
  945. service.toggle_chat()
  946. signals = _escalated_payload()
  947. service._last_brief_signals = signals
  948. token = _seed_brief(service, "Unknown: first")
  949. service._run_brief_update(0, signals, service._now(), token)
  950. assert service.last_triage is not None
  951. assert service.last_triage["brief"] == "RAW"
  952. emitted.clear()
  953. service.handle_event(_transcript(clock, "small talk"))
  954. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  955. service.tick()
  956. _, _, _, gen = lane.submits[0]
  957. service._on_triage_result(gen, _escalated_payload())
  958. assert service.last_triage is not None
  959. assert service.last_triage["brief"] == "RAW"
  960. assert "brief" not in service._last_brief_signals # raw signals stay raw
  961. staged = [e for e in _triage_events(emitted) if e.get("stage") == "signals"]
  962. assert len(staged) == 1
  963. assert staged[0]["triage"] == service.last_triage
  964. assert staged[0]["triage"]["brief"] == "RAW"
  965. assert len(triage.gate_calls) == 1
  966. def test_gated_out_turn_retains_brief_when_extract_disabled():
  967. """`extract_enabled = false` skips the dispatch but still retains the brief."""
  968. service, emitted, clock, _, lane = _triage_service(
  969. triage=FakeTriage(gate=False), brief_fn=lambda prompt: "RAW"
  970. )
  971. service.toggle_chat()
  972. signals = _escalated_payload()
  973. service._last_brief_signals = signals
  974. token = _seed_brief(service, "Unknown: first")
  975. service._run_brief_update(0, signals, service._now(), token)
  976. assert service.last_triage is not None
  977. assert service.last_triage["brief"] == "RAW"
  978. service.cfg.triage.extract_enabled = False
  979. emitted.clear()
  980. service.handle_event(_transcript(clock, "small talk"))
  981. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  982. service.tick()
  983. _, _, _, gen = lane.submits[0]
  984. service._on_triage_result(gen, _escalated_payload())
  985. assert service.last_triage is not None
  986. assert service.last_triage["brief"] == "RAW"
  987. assert [j.name for j in service._inference._queue] == ["chat"]
  988. staged = [e for e in _triage_events(emitted) if e.get("stage") == "signals"]
  989. assert staged[0]["triage"]["brief"] == "RAW"
  990. def test_gated_out_turn_retains_brief_without_brief_fn():
  991. """No brief_fn means no dispatch, but a retained brief is still carried."""
  992. service, emitted, clock, _, lane = _triage_service(triage=FakeTriage(gate=False))
  993. service.toggle_chat()
  994. service.last_triage = {**_escalated_payload(), "brief": "KEEP"}
  995. emitted.clear()
  996. service.handle_event(_transcript(clock, "small talk"))
  997. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  998. service.tick()
  999. _, _, _, gen = lane.submits[0]
  1000. service._on_triage_result(gen, _escalated_payload())
  1001. assert service.last_triage["brief"] == "KEEP"
  1002. staged = [e for e in _triage_events(emitted) if e.get("stage") == "signals"]
  1003. assert staged[0]["triage"]["brief"] == "KEEP"
  1004. def test_later_accepted_update_replaces_retained_brief():
  1005. """A later accepted update overwrites the retained brief text."""
  1006. texts = iter(["OLD", "NEW"])
  1007. service, emitted, _, _, _ = _triage_service(brief_fn=lambda prompt: next(texts))
  1008. service.toggle_chat()
  1009. signals = _escalated_payload()
  1010. service._last_brief_signals = signals
  1011. token = _seed_brief(service, "Unknown: first")
  1012. service._run_brief_update(0, signals, service._now(), token)
  1013. assert service.last_triage is not None
  1014. assert service.last_triage["brief"] == "OLD"
  1015. token = _seed_brief(service, "Unknown: second")
  1016. service._run_brief_update(0, signals, service._now(), token)
  1017. assert service.last_triage is not None
  1018. assert service.last_triage["brief"] == "NEW"
  1019. contents = [e for e in _triage_events(emitted) if e.get("stage") == "content"]
  1020. assert contents[-1]["triage"]["brief"] == "NEW"
  1021. service.clear()
  1022. assert service.last_triage is None
  1023. def test_no_brief_when_disabled_in_config():
  1024. calls: list[str] = []
  1025. service, _, clock, _, lane = _triage_service(
  1026. triage=FakeTriage(escalate=True),
  1027. brief_fn=lambda prompt: calls.append(prompt) or "RAW",
  1028. )
  1029. service.cfg.triage.extract_enabled = False
  1030. service.toggle_chat()
  1031. service.handle_event(_transcript(clock, "churn risk"))
  1032. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1033. service.tick()
  1034. _, _, _, gen = lane.submits[0]
  1035. service._on_triage_result(gen, _escalated_payload())
  1036. assert service.last_triage is not None
  1037. assert service.last_triage["escalated"] is True
  1038. assert calls == []
  1039. assert [j.name for j in service._inference._queue] == ["chat"]
  1040. def test_no_brief_without_brief_fn():
  1041. service, _, clock, _, lane = _triage_service(triage=FakeTriage(escalate=True))
  1042. service.toggle_chat()
  1043. service.handle_event(_transcript(clock, "churn risk"))
  1044. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1045. service.tick()
  1046. _, _, _, gen = lane.submits[0]
  1047. service._on_triage_result(gen, _escalated_payload())
  1048. assert service.last_triage is not None
  1049. assert [j.name for j in service._inference._queue] == ["chat"]
  1050. assert service._brief_outstanding is False
  1051. def test_brief_refused_when_queue_full():
  1052. """A refused submit leaves deltas buffered and the outstanding flag clear."""
  1053. service, emitted, clock, _, lane = _triage_service(
  1054. triage=FakeTriage(escalate=True), brief_fn=lambda prompt: "RAW"
  1055. )
  1056. service._inference = InferenceQueue(size=2)
  1057. service.toggle_chat()
  1058. service.handle_event(_transcript(clock, "churn risk"))
  1059. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1060. service.tick()
  1061. assert service._inference.depth() == 1
  1062. _, _, _, gen = lane.submits[0]
  1063. service._on_triage_result(gen, _escalated_payload())
  1064. assert service._inference.depth() == 1
  1065. assert service._inference._queue[0].name == "chat"
  1066. assert service.last_triage is not None
  1067. assert service.last_triage["escalated"] is True
  1068. assert [e.get("stage") for e in _triage_events(emitted)] == ["signals"]
  1069. assert service._pending_brief == ["Unknown: churn risk"]
  1070. assert service._brief_outstanding is False
  1071. def test_second_result_while_outstanding_is_refused():
  1072. """At most one brief job is outstanding: the second turn only stores signals."""
  1073. service, emitted, clock, _, lane = _triage_service(brief_fn=lambda prompt: "RAW")
  1074. service.toggle_chat()
  1075. service.handle_event(_transcript(clock, "first"))
  1076. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1077. service.tick()
  1078. _, _, _, gen0 = lane.submits[0]
  1079. service._on_triage_result(gen0, _escalated_payload())
  1080. assert [j.name for j in service._inference._queue] == ["chat", "brief-update"]
  1081. service.handle_event(_transcript(clock, "second"))
  1082. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1083. service.tick()
  1084. _, _, _, gen1 = lane.submits[1]
  1085. service._on_triage_result(gen1, _escalated_payload())
  1086. jobs = [j for j in service._inference._queue if j.name == "brief-update"]
  1087. assert len(jobs) == 1
  1088. assert [e.get("stage") for e in _triage_events(emitted)] == ["signals", "signals"]
  1089. assert service._brief_outstanding is True
  1090. assert service._pending_brief == ["Unknown: first", "Unknown: second"]
  1091. def _seed_brief(service, *deltas):
  1092. service._pending_brief = list(deltas)
  1093. service._brief_outstanding = True
  1094. return service._brief_token
  1095. def test_retention_guard_reappends_fact_dropped_by_model():
  1096. """A prior bullet the model omitted is deterministically restored."""
  1097. prior = (
  1098. "Summary: rolling\n\nPrior Details:\n"
  1099. "- The budget was $305 million.\n"
  1100. "- Sense could find prey.\n"
  1101. )
  1102. new = "Summary: newer\n\nPrior Details:\n- Sense could find prey.\n"
  1103. service, emitted, _, _, _ = _triage_service(brief_fn=lambda prompt: new)
  1104. service.last_triage = {**_escalated_payload(), "brief": prior}
  1105. service._pending_brief = ["Unknown: more"]
  1106. service._brief_outstanding = True
  1107. service._run_brief_update(0, _escalated_payload(), service._now(), service._brief_token)
  1108. assert service.last_triage is not None
  1109. brief = service.last_triage["brief"]
  1110. assert "- Sense could find prey." in brief
  1111. assert "- The budget was $305 million." in brief
  1112. assert brief.count("- Sense could find prey.") == 1
  1113. def test_retention_guard_leaves_complete_brief_unchanged():
  1114. """A brief that already carries every prior bullet is stored verbatim."""
  1115. prior = "Prior Details:\n- fact one\n- fact two\n"
  1116. new = "Summary: newer\n\nPrior Details:\n- fact one\n- fact two\n"
  1117. service, _, _, _, _ = _triage_service(brief_fn=lambda prompt: new)
  1118. service.last_triage = {**_escalated_payload(), "brief": prior}
  1119. service._pending_brief = ["Unknown: more"]
  1120. service._brief_outstanding = True
  1121. service._run_brief_update(0, _escalated_payload(), service._now(), service._brief_token)
  1122. assert service.last_triage is not None
  1123. assert service.last_triage["brief"] == new
  1124. def test_pinned_prompt_carries_prior_brief_and_new_utterances():
  1125. """The brief request hands the model the pinned current brief + new deltas."""
  1126. seen: list[str] = []
  1127. service, _, _, _, _ = _triage_service(
  1128. brief_fn=lambda prompt: seen.append(prompt) or "UPDATED"
  1129. )
  1130. service.last_triage = {**_escalated_payload(), "brief": "PRIOR BRIEF TEXT"}
  1131. service._pending_brief = ["Unknown: hello there"]
  1132. service._brief_outstanding = True
  1133. service._run_brief_update(0, _escalated_payload(), service._now(), service._brief_token)
  1134. assert len(seen) == 1
  1135. assert seen[0].startswith("CURRENT BRIEF:\nPRIOR BRIEF TEXT")
  1136. assert "NEW UTTERANCES:\n- Unknown: hello there" in seen[0]
  1137. def test_brief_merges_content_and_writes_file():
  1138. brief_file = FakeBriefFile()
  1139. service, emitted, _, triage, _ = _triage_service(
  1140. brief_fn=lambda prompt: "the brief", brief_file=brief_file
  1141. )
  1142. service.toggle_chat()
  1143. signals = _escalated_payload()
  1144. service._last_brief_signals = signals
  1145. token = _seed_brief(service, "Unknown: hello")
  1146. ts = service._now()
  1147. service._run_brief_update(0, signals, ts, token)
  1148. contents = [e for e in _triage_events(emitted) if e.get("stage") == "content"]
  1149. assert len(contents) == 1
  1150. assert contents[0]["triage"] == {**signals, "brief": "the brief"}
  1151. assert service.last_triage == contents[0]["triage"]
  1152. assert triage.prompt_calls == [(("Unknown: hello",), signals)]
  1153. assert brief_file.writes == ["the brief"]
  1154. assert service._pending_brief == []
  1155. assert service._brief_outstanding is False
  1156. def test_empty_brief_requeues_deltas():
  1157. """A `""` reply keeps signals, re-buffers the deltas, and clears the flag."""
  1158. service, emitted, _, _, _ = _triage_service(brief_fn=lambda prompt: "")
  1159. service.toggle_chat()
  1160. signals = _escalated_payload()
  1161. service.last_triage = signals
  1162. service._last_brief_signals = signals
  1163. token = _seed_brief(service, "Unknown: hello")
  1164. ts = service._now()
  1165. service._run_brief_update(0, signals, ts, token)
  1166. assert [e for e in _triage_events(emitted) if e.get("stage") == "content"] == []
  1167. assert service.last_triage == signals
  1168. assert "brief" not in service.last_triage
  1169. assert service._pending_brief == ["Unknown: hello"]
  1170. assert service._brief_outstanding is False
  1171. def test_brief_error_requeues_and_clears_flag():
  1172. """A raising brief_fn leaves the flag clear and the deltas buffered."""
  1173. def boom(prompt):
  1174. raise RuntimeError("llm down")
  1175. service, emitted, _, _, _ = _triage_service(brief_fn=boom)
  1176. service.toggle_chat()
  1177. token = _seed_brief(service, "Unknown: hello")
  1178. ts = service._now()
  1179. service._run_brief_update(0, _escalated_payload(), ts, token)
  1180. assert _triage_events(emitted) == []
  1181. assert service.last_triage is None
  1182. assert service._pending_brief == ["Unknown: hello"]
  1183. assert service._brief_outstanding is False
  1184. def test_brief_empty_buffer_returns_early():
  1185. """An empty buffer returns early: no call, no event, flag cleared."""
  1186. calls: list[str] = []
  1187. service, emitted, _, _, _ = _triage_service(
  1188. brief_fn=lambda prompt: calls.append(prompt) or "RAW"
  1189. )
  1190. service.toggle_chat()
  1191. service._brief_outstanding = True
  1192. token = service._brief_token
  1193. ts = service._now()
  1194. assert service._pending_brief == []
  1195. service._run_brief_update(0, _escalated_payload(), ts, token)
  1196. assert calls == []
  1197. assert _triage_events(emitted) == []
  1198. assert service._brief_outstanding is False
  1199. def test_brief_suppressed_after_reset():
  1200. service, emitted, _, _, _ = _triage_service(brief_fn=lambda prompt: "RAW")
  1201. service.toggle_chat()
  1202. service._pending_brief = ["Unknown: hello"]
  1203. service._reset_triage()
  1204. emitted.clear()
  1205. service._run_brief_update(0, _escalated_payload(), service._now(), 0)
  1206. assert _triage_events(emitted) == []
  1207. assert service.last_triage is None
  1208. assert service._pending_brief == ["Unknown: hello"]
  1209. def test_brief_works_after_leaving_chat():
  1210. seen = []
  1211. service, emitted, _, _, _ = _triage_service(
  1212. brief_fn=lambda prompt: seen.append(prompt) or "RAW"
  1213. )
  1214. service.toggle_chat()
  1215. assert service.modes.exit_chat() is True
  1216. token = _seed_brief(service, "Unknown: hello")
  1217. signals = _escalated_payload()
  1218. service._last_brief_signals = signals
  1219. service._run_brief_update(0, signals, service._now(), token)
  1220. assert seen != []
  1221. assert [e.get("stage") for e in _triage_events(emitted)] == ["content"]
  1222. assert service.last_triage is not None
  1223. assert service.last_triage["brief"] == "RAW"
  1224. def test_deltas_arriving_during_call_survive_and_flush():
  1225. """Deltas appended mid-call are not consumed; the finally flushes them."""
  1226. service, emitted, clock, _, _ = _triage_service()
  1227. service.toggle_chat()
  1228. signals = _escalated_payload()
  1229. service._last_brief_signals = signals
  1230. token = _seed_brief(service, "Unknown: first")
  1231. appended: list[int] = []
  1232. def _brief(prompt):
  1233. if not appended:
  1234. appended.append(1)
  1235. service.handle_event(_transcript(clock, "during call"))
  1236. return "first brief"
  1237. service._brief_fn = _brief
  1238. service._run_brief_update(0, signals, clock(), token)
  1239. contents = [e for e in _triage_events(emitted) if e.get("stage") == "content"]
  1240. assert len(contents) == 1
  1241. assert contents[0]["triage"]["brief"] == "first brief"
  1242. flushed = [j for j in service._inference._queue if j.name == "brief-update"]
  1243. assert len(flushed) == 1
  1244. assert service._brief_outstanding is True
  1245. assert service._pending_brief == ["Unknown: during call"]
  1246. flushed[0].run()
  1247. contents = [e for e in _triage_events(emitted) if e.get("stage") == "content"]
  1248. assert len(contents) == 2
  1249. assert contents[1]["triage"]["brief"] == "first brief"
  1250. assert service._pending_brief == []
  1251. assert service._brief_outstanding is False
  1252. def test_in_flight_brief_after_clear_emits_and_writes_nothing():
  1253. """Stale in-flight job: no event, no file write, no requeue, flag untouched."""
  1254. brief_file = FakeBriefFile()
  1255. service, emitted, clock, _, lane = _triage_service(
  1256. brief_fn=lambda prompt: "RAW", brief_file=brief_file
  1257. )
  1258. service.toggle_chat()
  1259. service.handle_event(_transcript(clock, "hello"))
  1260. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1261. service.tick()
  1262. _, _, _, gen = lane.submits[0]
  1263. service._on_triage_result(gen, _escalated_payload())
  1264. job = [j for j in service._inference._queue if j.name == "brief-update"][0]
  1265. assert service._brief_outstanding is True
  1266. service.clear()
  1267. assert service._brief_outstanding is False
  1268. token_after_clear = service._brief_token
  1269. emitted.clear()
  1270. job.run()
  1271. assert [e for e in _triage_events(emitted)] == []
  1272. assert brief_file.writes == []
  1273. assert service._pending_brief == []
  1274. assert service.last_triage is None
  1275. assert service._brief_token == token_after_clear
  1276. assert service._brief_outstanding is False
  1277. def test_clear_resets_triage():
  1278. resets: list[int] = []
  1279. chats: list[int] = []
  1280. brief_file = FakeBriefFile()
  1281. service, emitted, clock, _, lane = _triage_service(
  1282. triage=FakeTriage(escalate=True),
  1283. brief_fn=lambda prompt: "RAW",
  1284. brief_file=brief_file,
  1285. brief_reset=lambda: resets.append(1),
  1286. chat_reset=lambda: chats.append(1),
  1287. )
  1288. service.toggle_chat()
  1289. service.handle_event(_transcript(clock, "churn"))
  1290. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1291. service.tick()
  1292. _, _, _, gen = lane.submits[0]
  1293. service._on_triage_result(gen, _escalated_payload())
  1294. assert service._inference.depth() == 2
  1295. assert service._pending_brief == ["Unknown: churn"]
  1296. assert service._brief_outstanding is True
  1297. token_before = service._brief_token
  1298. assert service.clear() is True
  1299. assert service._triage_generation == 1
  1300. assert service.last_triage is None
  1301. assert service._last_triage_window == ()
  1302. assert service.triage_history == []
  1303. assert service._pending_brief == []
  1304. assert service._brief_token == token_before + 1
  1305. assert service._brief_outstanding is False
  1306. assert service._last_brief_signals is None
  1307. assert resets == [1]
  1308. assert brief_file.clears == 1
  1309. assert chats == [1]
  1310. assert lane.drops == 1
  1311. assert service._inference.depth() == 0
  1312. assert list(service._inference._queue) == []
  1313. cleared = [e for e in _triage_events(emitted) if e.get("stage") == "cleared"]
  1314. assert len(cleared) == 1
  1315. assert cleared[0]["triage"] is None
  1316. assert {"type": "cleared"} in emitted
  1317. signals_before = len(
  1318. [e for e in _triage_events(emitted) if e.get("stage") == "signals"]
  1319. )
  1320. service._on_triage_result(gen, _escalated_payload())
  1321. assert service.last_triage is None
  1322. assert (
  1323. len([e for e in _triage_events(emitted) if e.get("stage") == "signals"])
  1324. == signals_before
  1325. )
  1326. submits_before = len(lane.submits)
  1327. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1328. service.tick()
  1329. assert len(lane.submits) == submits_before
  1330. def test_exit_chat_does_not_reset_triage():
  1331. chats: list[int] = []
  1332. bresets: list[int] = []
  1333. brief_file = FakeBriefFile()
  1334. service, emitted, clock, _, lane = _triage_service(
  1335. brief_fn=lambda prompt: "RAW",
  1336. chat_reset=lambda: chats.append(1),
  1337. brief_reset=lambda: bresets.append(1),
  1338. brief_file=brief_file,
  1339. )
  1340. service.toggle_chat()
  1341. service.handle_event(_transcript(clock, "hello"))
  1342. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1343. service.tick()
  1344. assert len(lane.submits) == 1
  1345. _, _, _, gen = lane.submits[0]
  1346. service._on_triage_result(gen, _escalated_payload())
  1347. assert service.last_triage is not None
  1348. assert service._triage_generation == 0
  1349. assert service.toggle_chat() is True
  1350. assert service.modes.mode.value == "idle"
  1351. assert service._triage_generation == 0
  1352. assert service.last_triage is not None
  1353. assert service._last_triage_window == ("hello",)
  1354. assert service.triage_history == ["hello"]
  1355. assert service._pending_brief == ["Unknown: hello"]
  1356. assert service._last_brief_signals is not None
  1357. assert service._brief_outstanding is True
  1358. assert lane.drops == 0
  1359. cleared = [e for e in _triage_events(emitted) if e.get("stage") == "cleared"]
  1360. assert cleared == []
  1361. assert chats == [1]
  1362. assert bresets == []
  1363. assert brief_file.clears == 0
  1364. def test_toggle_chat_enter_does_not_touch_triage():
  1365. """Entering chat resets only the chat buffers; the brief engine is independent."""
  1366. bresets: list[int] = []
  1367. brief_file = FakeBriefFile()
  1368. service, emitted, clock, _, lane = _triage_service(
  1369. brief_fn=lambda prompt: "RAW",
  1370. brief_reset=lambda: bresets.append(1),
  1371. brief_file=brief_file,
  1372. )
  1373. service.handle_event(_transcript(clock, "hello"))
  1374. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1375. service.tick()
  1376. _, _, _, gen = lane.submits[0]
  1377. service._on_triage_result(gen, _escalated_payload())
  1378. triage_before = service.last_triage
  1379. pending_before = list(service._pending_brief)
  1380. assert service.toggle_chat() is True
  1381. assert service.modes.mode.value == "chat"
  1382. assert service._triage_generation == 0
  1383. assert service.last_triage is triage_before
  1384. assert service._last_triage_window == ("hello",)
  1385. assert service.triage_history == ["hello"]
  1386. assert service._pending_brief == pending_before
  1387. assert service._last_brief_signals is not None
  1388. assert service._brief_outstanding is True
  1389. assert lane.drops == 0
  1390. assert bresets == []
  1391. assert brief_file.clears == 0
  1392. cleared = [e for e in _triage_events(emitted) if e.get("stage") == "cleared"]
  1393. assert cleared == []
  1394. def test_clear_without_triage_emits_no_triage_event():
  1395. service, emitted, _ = _service()
  1396. brief_file = FakeBriefFile()
  1397. bresets: list[int] = []
  1398. service._brief_file = brief_file
  1399. service._brief_reset = lambda: bresets.append(1)
  1400. service.clear()
  1401. assert {"type": "cleared"} in emitted
  1402. assert _triage_events(emitted) == []
  1403. assert brief_file.clears == 1
  1404. assert bresets == []
  1405. def test_stale_brief_after_clear_does_not_clear_newer_dispatch_flag():
  1406. """A stale in-flight job must not clear a newer dispatch's outstanding flag."""
  1407. brief_file = FakeBriefFile()
  1408. service, emitted, clock, _, lane = _triage_service(
  1409. brief_fn=lambda prompt: "RAW", brief_file=brief_file
  1410. )
  1411. service.toggle_chat()
  1412. service.handle_event(_transcript(clock, "hello"))
  1413. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1414. service.tick()
  1415. _, _, _, gen = lane.submits[0]
  1416. service._on_triage_result(gen, _escalated_payload())
  1417. stale_job = [j for j in service._inference._queue if j.name == "brief-update"][0]
  1418. assert service._brief_outstanding is True
  1419. service.clear()
  1420. # A fresh turn dispatches a new brief AFTER clear bumped the token.
  1421. service.handle_event(_transcript(clock, "fresh"))
  1422. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1423. service.tick()
  1424. _, _, _, gen2 = lane.submits[1]
  1425. service._on_triage_result(gen2, _escalated_payload())
  1426. assert service._brief_outstanding is True
  1427. newer_token = service._brief_token
  1428. pending_before = list(service._pending_brief)
  1429. triage_before = service.last_triage
  1430. emitted.clear()
  1431. stale_job.run()
  1432. assert _triage_events(emitted) == []
  1433. assert brief_file.writes == []
  1434. assert service._pending_brief == pending_before
  1435. assert service._brief_outstanding is True
  1436. assert service._brief_token == newer_token
  1437. assert service.last_triage is triage_before
  1438. def test_clear_resets_chat_latch():
  1439. service, emitted, _ = _service()
  1440. service.toggle_chat()
  1441. service._chat_queue_full = True
  1442. service._pending_chat = ["stuck text"]
  1443. service.clear()
  1444. assert service._chat_queue_full is False
  1445. assert service._pending_chat == []
  1446. assert {"type": "cleared"} in emitted
  1447. def test_triage_end_to_end_signals_content_cleared():
  1448. """Two settled turns collapse into ONE brief job (single-outstanding guard).
  1449. The second `_on_triage_result` is refused as `"outstanding"`, so the queue
  1450. holds one `brief-update` that consumes both deltas and emits one `content`.
  1451. The panel keeps the FIRST turn's signals until the next settled turn (lag).
  1452. """
  1453. prompts: list[str] = []
  1454. service, emitted, clock, triage, lane = _triage_service(
  1455. brief_fn=lambda prompt: prompts.append(prompt) or "the brief"
  1456. )
  1457. service.toggle_chat()
  1458. service.handle_event(_transcript(clock, "first thought"))
  1459. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1460. service.tick()
  1461. assert len(lane.submits) == 1
  1462. _, _, _, gen0 = lane.submits[0]
  1463. service._on_triage_result(
  1464. gen0, {"order": ["urgency"], "items": {}, "escalated": False, "input_tokens": 1}
  1465. )
  1466. assert [e.get("stage") for e in _triage_events(emitted)] == ["signals"]
  1467. assert prompts == []
  1468. assert service.last_triage is not None
  1469. assert service.last_triage["escalated"] is False
  1470. assert [j.name for j in service._inference._queue] == ["chat", "brief-update"]
  1471. triage._escalate = True
  1472. service.handle_event(_transcript(clock, "we might churn"))
  1473. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1474. service.tick()
  1475. assert len(lane.submits) == 2
  1476. _, _, _, gen1 = lane.submits[1]
  1477. service._on_triage_result(gen1, _escalated_payload())
  1478. assert [e.get("stage") for e in _triage_events(emitted)] == ["signals", "signals"]
  1479. assert [j.name for j in service._inference._queue] == [
  1480. "chat",
  1481. "brief-update",
  1482. "chat",
  1483. ]
  1484. for job in [j for j in service._inference._queue if j.name == "brief-update"]:
  1485. job.run()
  1486. contents = [e for e in _triage_events(emitted) if e.get("stage") == "content"]
  1487. assert len(contents) == 1
  1488. assert len(prompts) == 1
  1489. deltas, _ = triage.prompt_calls[0]
  1490. assert deltas == ("Unknown: first thought", "Unknown: we might churn")
  1491. assert contents[0]["triage"]["escalated"] is False
  1492. assert contents[0]["triage"]["brief"] == "the brief"
  1493. assert service.last_triage == contents[0]["triage"]
  1494. assert service.status()["triage"] == contents[0]["triage"]
  1495. service.clear()
  1496. cleared = [e for e in _triage_events(emitted) if e.get("stage") == "cleared"]
  1497. assert len(cleared) == 1
  1498. assert cleared[0]["triage"] is None
  1499. assert service.last_triage is None
  1500. service._on_triage_result(gen1, _escalated_payload())
  1501. assert [e.get("stage") for e in _triage_events(emitted)] == [
  1502. "signals",
  1503. "signals",
  1504. "content",
  1505. "cleared",
  1506. ]
  1507. assert service.toggle_chat() is True
  1508. service.handle_event(_transcript(clock, "idle thought"))
  1509. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1510. service.tick()
  1511. assert len(lane.submits) == 3
  1512. assert lane.submits[2][0].endswith("- idle thought")
  1513. def test_tick_emits_status_on_triage_state_change():
  1514. service, emitted, _, triage, _ = _triage_service(
  1515. triage=FakeTriage(state_pair=("loading", "warming up"))
  1516. )
  1517. service.tick()
  1518. statuses = [e for e in emitted if e["type"] == "status"]
  1519. assert len(statuses) == 1
  1520. assert statuses[0]["triage_state"] == "loading"
  1521. assert statuses[0]["triage_reason"] == "warming up"
  1522. assert "triage" in statuses[0]
  1523. triage._state_pair = ("ok", "")
  1524. service.tick()
  1525. statuses = [e for e in emitted if e["type"] == "status"]
  1526. assert len(statuses) == 2
  1527. assert statuses[1]["triage_state"] == "ok"
  1528. assert statuses[1]["triage_reason"] == ""
  1529. assert "triage" in statuses[1]
  1530. service.tick()
  1531. assert len([e for e in emitted if e["type"] == "status"]) == 2
  1532. def test_no_status_emitted_when_triage_disabled():
  1533. service, emitted, _ = _service()
  1534. service.tick()
  1535. service.tick()
  1536. assert [e for e in emitted if e["type"] == "status"] == []
  1537. def test_tick_heals_triage_panel_after_lane_ready():
  1538. import time as _time
  1539. from pathlib import Path
  1540. from stt_daemon.assistant.laya_lane import LayaLane
  1541. from stt_daemon.assistant.triage import TriageAnalyzer
  1542. from stt_daemon.tui.state import ViewState
  1543. class _FakeRouter:
  1544. def preload(self, names):
  1545. return self
  1546. def predict(self, state, questions, model=None, lang=None, **kwargs):
  1547. if "_warmup" in questions:
  1548. return {"model": model, "answers": {}, "usage": {}, "routing": {}}
  1549. return {
  1550. "model": model,
  1551. "answers": {
  1552. "frustration": {
  1553. "noul": 0.1,
  1554. "confidence": 0.9,
  1555. "answer_confidence": 0.9,
  1556. },
  1557. "urgency": {
  1558. "choice": "low",
  1559. "confidence": 0.9,
  1560. "answer_confidence": 0.9,
  1561. },
  1562. },
  1563. "usage": {"input_tokens": 5},
  1564. }
  1565. def _factory(**kwargs):
  1566. return _FakeRouter()
  1567. cfg = Config()
  1568. cfg.assistant.turn_gap_s = 0.5
  1569. cfg.triage.questions_file = str(
  1570. Path(__file__).resolve().parent.parent / "questions.example.json"
  1571. )
  1572. clock = Clock()
  1573. emitted: list[dict] = []
  1574. def emit(type_, **fields):
  1575. emitted.append({"type": type_, **fields})
  1576. analyzer = TriageAnalyzer(cfg.triage)
  1577. assert analyzer.questions, "example questions must load"
  1578. holder: dict = {}
  1579. lane = LayaLane(
  1580. cfg.triage,
  1581. agent_factory=_factory,
  1582. on_result=lambda gen, payload: holder["svc"]._on_triage_result(gen, payload),
  1583. on_state=lambda state, reason: analyzer.refresh(state, reason),
  1584. )
  1585. service = AssistantService(
  1586. cfg,
  1587. FakeSubscriber(),
  1588. emit=emit,
  1589. time_fn=clock,
  1590. triage=analyzer,
  1591. laya_lane=lane,
  1592. chat_fn=_ok_reply,
  1593. )
  1594. holder["svc"] = service
  1595. try:
  1596. lane.start()
  1597. deadline = _time.monotonic() + 5.0
  1598. while not lane.ready() and _time.monotonic() < deadline:
  1599. _time.sleep(0.005)
  1600. assert lane.ready(), "lane did not become ready"
  1601. assert analyzer.state() == ("ok", "")
  1602. service.tick()
  1603. statuses = [e for e in emitted if e["type"] == "status"]
  1604. assert statuses, "tick emitted no status after lane ready"
  1605. assert statuses[-1]["triage_state"] == "ok"
  1606. service.handle_event(_transcript(clock, "hello"))
  1607. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1608. service.tick()
  1609. deadline = _time.monotonic() + 5.0
  1610. while service.last_triage is None and _time.monotonic() < deadline:
  1611. _time.sleep(0.005)
  1612. assert service.last_triage is not None, "no triage signals from lane"
  1613. view = ViewState()
  1614. for event in emitted:
  1615. view.ingest(event)
  1616. assert view.triage_state == "ok"
  1617. lines = view.triage_lines()
  1618. assert lines
  1619. assert not any("unavailable" in line for line in lines)
  1620. assert not any("loading" in line for line in lines)
  1621. finally:
  1622. lane.stop()
  1623. def _dump_brief(prompt, on_io=None):
  1624. """Brief fake that mimics LlmClient.chat's on_io phases."""
  1625. if on_io is not None:
  1626. on_io({"phase": "request", "url": "http://llm/v1", "body": {"prompt": prompt}})
  1627. on_io({"phase": "response", "payload": {"content": "parsed"}, "error": None})
  1628. return "BRIEF"
  1629. def _run_triage_flow(service, emitted, clock, lane, payload):
  1630. service.toggle_chat()
  1631. service.handle_event(_transcript(clock, "hello"))
  1632. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1633. service.tick()
  1634. _, _, _, gen = lane.submits[0]
  1635. service._on_triage_result(gen, payload)
  1636. return gen
  1637. def _dump_files(tmp_path):
  1638. return list(tmp_path.rglob("*.json"))
  1639. def test_dump_writes_full_laya_and_llm_io(tmp_path):
  1640. service, emitted, clock, triage, lane = _triage_service(brief_fn=_dump_brief)
  1641. service._triage_dump = TriageDumper(True, directory=str(tmp_path))
  1642. service.cfg.triage.dump_io = True
  1643. _run_triage_flow(service, emitted, clock, lane, _escalated_payload())
  1644. jobs = [j for j in service._inference._queue if j.name == "brief-update"]
  1645. assert len(jobs) == 1
  1646. jobs[0].run()
  1647. files = _dump_files(tmp_path)
  1648. assert len(files) == 1
  1649. assert re.fullmatch(r"\d{6}-\d{3}\.json", files[0].name)
  1650. data = json.loads(files[0].read_text(encoding="utf-8"))
  1651. assert data["ts"] == clock()
  1652. assert isinstance(data["iso"], str) and data["iso"]
  1653. assert data["laya"]["request"]["state"] == "- hello"
  1654. assert data["laya"]["request"]["questions"] == triage.questions
  1655. assert data["laya"]["request"]["model"] == "multilingual"
  1656. assert data["laya"]["request"]["max_len"] == 1024
  1657. assert data["laya"]["response"] == _escalated_payload()
  1658. assert data["laya"]["error"] is None
  1659. assert data["llm"]["request"]["url"] == "http://llm/v1"
  1660. assert data["llm"]["request"]["body"] == {
  1661. "prompt": "CURRENT BRIEF:\n(none yet)\n\nNEW UTTERANCES:\n- Unknown: hello"
  1662. }
  1663. assert data["llm"]["response"] == {"content": "parsed"}
  1664. assert data["llm"]["error"] is None
  1665. assert service._triage_dump._pending == {}
  1666. def test_dump_laya_error_writes_laya_only_and_keeps_deltas(tmp_path):
  1667. """A Laya predict failure finalizes the Laya half with `llm: null`.
  1668. Nothing is dispatched, so no LLM half is ever recorded and the buffered
  1669. deltas survive for the next settled turn.
  1670. """
  1671. service, emitted, clock, _, lane = _triage_service(brief_fn=_dump_brief)
  1672. service._triage_dump = TriageDumper(True, directory=str(tmp_path))
  1673. service.cfg.triage.dump_io = True
  1674. _run_triage_flow(service, emitted, clock, lane, None)
  1675. assert [j.name for j in service._inference._queue] == ["chat"]
  1676. assert service._pending_brief == ["Unknown: hello"]
  1677. files = _dump_files(tmp_path)
  1678. assert len(files) == 1
  1679. data = json.loads(files[0].read_text(encoding="utf-8"))
  1680. assert data["laya"]["response"] is None
  1681. assert data["laya"]["error"] == "predict failed"
  1682. assert data["llm"] is None
  1683. assert service._triage_dump._pending == {}
  1684. def test_dump_without_brief_has_laya_only(tmp_path):
  1685. service, emitted, clock, _, lane = _triage_service(brief_fn=_dump_brief)
  1686. service._triage_dump = TriageDumper(True, directory=str(tmp_path))
  1687. service.cfg.triage.dump_io = True
  1688. service.cfg.triage.extract_enabled = False
  1689. _run_triage_flow(service, emitted, clock, lane, _escalated_payload())
  1690. files = _dump_files(tmp_path)
  1691. assert len(files) == 1
  1692. data = json.loads(files[0].read_text(encoding="utf-8"))
  1693. assert data["laya"]["response"] == _escalated_payload()
  1694. assert data["llm"] is None
  1695. assert service._triage_dump._pending == {}
  1696. def test_dump_queue_full_has_laya_only(tmp_path):
  1697. service, emitted, clock, _, lane = _triage_service(brief_fn=_dump_brief)
  1698. service._triage_dump = TriageDumper(True, directory=str(tmp_path))
  1699. service.cfg.triage.dump_io = True
  1700. service._inference = InferenceQueue(size=2)
  1701. _run_triage_flow(service, emitted, clock, lane, _escalated_payload())
  1702. assert service._inference.depth() == 1
  1703. assert [j.name for j in service._inference._queue] == ["chat"]
  1704. assert service._pending_brief == ["Unknown: hello"]
  1705. files = _dump_files(tmp_path)
  1706. assert len(files) == 1
  1707. data = json.loads(files[0].read_text(encoding="utf-8"))
  1708. assert data["laya"]["response"] == _escalated_payload()
  1709. assert data["llm"] is None
  1710. assert service._triage_dump._pending == {}
  1711. def test_dump_disabled_writes_nothing(tmp_path):
  1712. service, emitted, clock, _, lane = _triage_service(
  1713. brief_fn=lambda prompt: "RAW"
  1714. )
  1715. assert service._triage_dump.enabled is False
  1716. service._triage_dump = TriageDumper(False, directory=str(tmp_path))
  1717. _run_triage_flow(service, emitted, clock, lane, _escalated_payload())
  1718. jobs = [j for j in service._inference._queue if j.name == "brief-update"]
  1719. assert len(jobs) == 1
  1720. jobs[0].run()
  1721. assert _dump_files(tmp_path) == []
  1722. def test_dump_stale_result_discards_without_file(tmp_path):
  1723. service, emitted, clock, triage, lane = _triage_service(brief_fn=_dump_brief)
  1724. service._triage_dump = TriageDumper(True, directory=str(tmp_path))
  1725. service.cfg.triage.dump_io = True
  1726. service.toggle_chat()
  1727. service.handle_event(_transcript(clock, "hello"))
  1728. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1729. service.tick()
  1730. _, _, _, gen = lane.submits[0]
  1731. real_normalize = triage.normalize
  1732. def stale_normalize(payload):
  1733. # Simulate a clear landing between the first check/begin and the re-check.
  1734. service._triage_generation += 1
  1735. return real_normalize(payload)
  1736. triage.normalize = stale_normalize
  1737. service._on_triage_result(gen, _escalated_payload())
  1738. assert _dump_files(tmp_path) == []
  1739. assert service._triage_dump._pending == {}
  1740. def test_dump_stale_brief_discards_without_file(tmp_path):
  1741. service, _, clock, _, _ = _triage_service(brief_fn=_dump_brief)
  1742. service._triage_dump = TriageDumper(True, directory=str(tmp_path))
  1743. service.cfg.triage.dump_io = True
  1744. ts = clock()
  1745. service._triage_dump.begin(ts, laya={"request": {}, "response": {}, "error": None})
  1746. service._pending_brief = ["Unknown: hello"]
  1747. service._triage_generation += 1 # stale before the brief even starts
  1748. service._run_brief_update(0, _escalated_payload(), ts, service._brief_token)
  1749. assert _dump_files(tmp_path) == []
  1750. assert service._triage_dump._pending == {}
  1751. assert service._pending_brief == ["Unknown: hello"]
  1752. def test_dump_brief_cleared_mid_flight_writes_nothing(tmp_path):
  1753. service, _, clock, _, _ = _triage_service(brief_fn=_dump_brief)
  1754. service._triage_dump = TriageDumper(True, directory=str(tmp_path))
  1755. service.cfg.triage.dump_io = True
  1756. def stale_brief(prompt, on_io=None):
  1757. # Simulate a clear landing mid-LLM-call (after the request phase fired).
  1758. service._triage_generation += 1
  1759. if on_io is not None:
  1760. on_io({"phase": "request", "url": "http://llm/v1", "body": {}})
  1761. on_io({"phase": "response", "payload": {"c": 1}, "error": None})
  1762. return "RAW"
  1763. service._brief_fn = stale_brief
  1764. service._pending_brief = ["Unknown: hello"]
  1765. service._brief_outstanding = True
  1766. token = service._brief_token
  1767. ts = clock()
  1768. service._triage_dump.begin(ts, laya={"request": {}, "response": {}, "error": None})
  1769. service._run_brief_update(0, _escalated_payload(), ts, token)
  1770. assert _dump_files(tmp_path) == []
  1771. assert service._triage_dump._pending == {}
  1772. assert service._pending_brief == []
  1773. assert service._brief_outstanding is False
  1774. def test_dump_gated_out_writes_laya_only_and_no_pending(tmp_path):
  1775. """A turn the gate leaves out writes `llm: null` and leaks no pending record."""
  1776. service, emitted, clock, triage, lane = _triage_service(
  1777. triage=FakeTriage(escalate=True, gate=False), brief_fn=_dump_brief
  1778. )
  1779. service._triage_dump = TriageDumper(True, directory=str(tmp_path))
  1780. service.cfg.triage.dump_io = True
  1781. _run_triage_flow(service, emitted, clock, lane, _escalated_payload())
  1782. assert [j.name for j in service._inference._queue] == ["chat"]
  1783. assert len(triage.gate_calls) == 1
  1784. files = _dump_files(tmp_path)
  1785. assert len(files) == 1
  1786. data = json.loads(files[0].read_text(encoding="utf-8"))
  1787. assert data["laya"]["response"] == _escalated_payload()
  1788. assert data["llm"] is None
  1789. assert service._triage_dump._pending == {}
  1790. def test_dump_coalesced_update_writes_laya_only_then_llm_only_flush(tmp_path):
  1791. """A coalesced turn writes a Laya-only record; the later flush a separate llm-only one."""
  1792. service, emitted, clock, _, lane = _triage_service(brief_fn=_dump_brief)
  1793. service._triage_dump = TriageDumper(True, directory=str(tmp_path))
  1794. service.cfg.triage.dump_io = True
  1795. service.toggle_chat()
  1796. service.handle_event(_transcript(clock, "first"))
  1797. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1798. service.tick()
  1799. _, _, _, gen0 = lane.submits[0]
  1800. service._on_triage_result(gen0, _escalated_payload())
  1801. service.handle_event(_transcript(clock, "second"))
  1802. clock.advance(service.cfg.assistant.turn_gap_s + 0.1)
  1803. service.tick()
  1804. _, _, _, gen1 = lane.submits[1]
  1805. service._on_triage_result(gen1, _escalated_payload())
  1806. assert service._brief_outstanding is True
  1807. appended: list[int] = []
  1808. def _brief(prompt, on_io=None):
  1809. if not appended:
  1810. appended.append(1)
  1811. service.handle_event(_transcript(clock, "during call"))
  1812. if on_io is not None:
  1813. on_io({"phase": "request", "url": "http://llm/v1", "body": {"prompt": prompt}})
  1814. on_io({"phase": "response", "payload": {"content": "parsed"}, "error": None})
  1815. return "BRIEF"
  1816. service._brief_fn = _brief
  1817. clock.advance(1.0)
  1818. job = [j for j in service._inference._queue if j.name == "brief-update"][0]
  1819. service._inference._queue.remove(job)
  1820. job.run()
  1821. flushed = [j for j in service._inference._queue if j.name == "brief-update"]
  1822. assert len(flushed) == 1
  1823. flushed[0].run()
  1824. assert service._triage_dump._pending == {}
  1825. records = [
  1826. json.loads(path.read_text(encoding="utf-8")) for path in _dump_files(tmp_path)
  1827. ]
  1828. assert len(records) == 3
  1829. coalesced = [r for r in records if r["laya"] is not None and r["llm"] is None]
  1830. flushed_records = [r for r in records if r["laya"] is None and r["llm"] is not None]
  1831. both = [r for r in records if r["laya"] is not None and r["llm"] is not None]
  1832. assert len(coalesced) == 1
  1833. assert len(flushed_records) == 1
  1834. assert len(both) == 1
  1835. assert coalesced[0]["ts"] != flushed_records[0]["ts"]
  1836. assert flushed_records[0]["llm"]["request"]["body"] == {
  1837. "prompt": "CURRENT BRIEF:\nBRIEF\n\nNEW UTTERANCES:\n- Unknown: during call"
  1838. }
  1839. def test_chat_client_failure_emits_llm_error_and_service_survives():
  1840. """Adversarial (a): a chat client raising on `chat` surfaces as an `llm_error`
  1841. event and the service keeps functioning afterwards."""
  1842. from stt_daemon.assistant.llm import ConversationEngine, LlmError
  1843. class BoomClient:
  1844. def chat(self, messages, max_tokens=None, timeout_s=None, **kwargs):
  1845. raise LlmError("boom")
  1846. engine = ConversationEngine(Config().llm, BoomClient(), system_prompt="SYS")
  1847. service, emitted, clock = _service()
  1848. service.chat_fn = engine.send
  1849. assert service.toggle_chat() is True
  1850. service._run_chat("hello")
  1851. errors = [e for e in emitted if e["type"] == "error" and e.get("code") == "llm_error"]
  1852. assert errors and "boom" in errors[-1]["message"]
  1853. assert service.toggle_chat() is True
  1854. assert service.modes.mode.value == "idle"
  1855. # ---------------------------------------------------------------------------
  1856. # Conversation session adoption (SESSION/TRANSCRIPT session_dir).
  1857. # ---------------------------------------------------------------------------
  1858. def _session_event(clock, session_dir):
  1859. event = _ev(events.SESSION, clock)
  1860. event["session_id"] = session_dir.rsplit("/", 1)[-1]
  1861. event["session_dir"] = session_dir
  1862. return event
  1863. def _ring(service, clock, *items):
  1864. """Feed a daemon-seeded replay window: status -> items -> ring_end."""
  1865. service.handle_event(_ev(events.STATUS, clock))
  1866. for item in items:
  1867. service.handle_event(item)
  1868. service.handle_event(_ev(events.RING_END, clock))
  1869. def _cleared(emitted):
  1870. return [e for e in _triage_events(emitted) if e.get("stage") == "cleared"]
  1871. def test_status_includes_session_dir_without_brief_file():
  1872. service, _, clock = _service()
  1873. assert service.status()["session_dir"] is None
  1874. service.handle_event(_session_event(clock, "transcripts/2026-09-30-12-47-29"))
  1875. assert service.status()["session_dir"] == "transcripts/2026-09-30-12-47-29"
  1876. def test_live_session_event_sets_session_and_records_directory():
  1877. brief_file = FakeBriefFile()
  1878. service, _, clock, _, _ = _triage_service(brief_file=brief_file)
  1879. session = "transcripts/2026-09-30-12-47-29"
  1880. service.handle_event(_session_event(clock, session))
  1881. assert service.status()["session_dir"] == session
  1882. assert brief_file.directories == [session]
  1883. assert service._triage_generation == 0
  1884. def test_live_transcript_session_sets_session_without_wiping_utterance():
  1885. brief_file = FakeBriefFile()
  1886. service, _, clock, _, _ = _triage_service(brief_file=brief_file)
  1887. session = "transcripts/s1"
  1888. service.handle_event(_transcript(clock, "hello", session_dir=session))
  1889. assert service.status()["session_dir"] == session
  1890. assert brief_file.directories == [session]
  1891. assert service.triage_history == ["hello"]
  1892. assert service._pending_brief == ["Unknown: hello"]
  1893. assert service._triage_generation == 0
  1894. def test_brief_write_lands_under_session_dir(tmp_path):
  1895. from stt_daemon.assistant.brief_file import BriefFile
  1896. brief_file = BriefFile(True)
  1897. service, _, clock, _, _ = _triage_service(brief_file=brief_file)
  1898. session = str(tmp_path / "transcripts" / "s1")
  1899. service.handle_event(_transcript(clock, "hello", session_dir=session))
  1900. brief_file.write("the brief")
  1901. path = tmp_path / "transcripts" / "s1" / "brief.md"
  1902. assert path.read_text(encoding="utf-8") == "the brief"
  1903. def test_live_session_change_resets_triage_and_keeps_chat():
  1904. brief_file = FakeBriefFile()
  1905. resets: list[int] = []
  1906. service, emitted, clock, _, lane = _triage_service(
  1907. brief_file=brief_file, brief_reset=lambda: resets.append(1)
  1908. )
  1909. service.toggle_chat()
  1910. service.handle_event(_transcript(clock, "hello"))
  1911. service.handle_event(_session_event(clock, "transcripts/a"))
  1912. service.last_triage = {"signals": 1}
  1913. service._pending_brief = ["stale"]
  1914. emitted.clear()
  1915. service.handle_event(_session_event(clock, "transcripts/b"))
  1916. assert service.status()["session_dir"] == "transcripts/b"
  1917. assert service.last_triage is None
  1918. assert service._pending_brief == []
  1919. assert service._triage_generation == 1
  1920. assert service.chat_history == ["Unknown: hello"]
  1921. assert resets == [1]
  1922. assert lane.drops == 1
  1923. assert brief_file.directories == ["transcripts/a", "transcripts/b"]
  1924. assert len(_cleared(emitted)) == 1
  1925. def test_sessionless_transcript_does_not_reset():
  1926. service, _, clock, _, _ = _triage_service()
  1927. service.handle_event(_session_event(clock, "transcripts/a"))
  1928. service.last_triage = {"signals": 1}
  1929. service.handle_event(_transcript(clock, "hello"))
  1930. assert service._triage_generation == 0
  1931. assert service.last_triage == {"signals": 1}
  1932. assert service.status()["session_dir"] == "transcripts/a"
  1933. def test_same_dir_readoption_does_not_reset():
  1934. brief_file = FakeBriefFile()
  1935. service, _, clock, _, _ = _triage_service(brief_file=brief_file)
  1936. session = "transcripts/a"
  1937. service.handle_event(_session_event(clock, session))
  1938. service.last_triage = {"signals": 1}
  1939. service.handle_event(_transcript(clock, "again", session_dir=session))
  1940. assert service._triage_generation == 0
  1941. assert service.last_triage == {"signals": 1}
  1942. assert brief_file.directories == [session]
  1943. def test_session_change_without_brief_file_does_not_raise():
  1944. service, _, clock, _, _ = _triage_service(brief_file=None)
  1945. service.handle_event(_session_event(clock, "transcripts/a"))
  1946. service.handle_event(_session_event(clock, "transcripts/b"))
  1947. assert service.status()["session_dir"] == "transcripts/b"
  1948. assert service._triage_generation == 1
  1949. def test_replay_single_session_adopts_without_reset():
  1950. brief_file = FakeBriefFile()
  1951. service, emitted, clock, _, _ = _triage_service(brief_file=brief_file)
  1952. session = "transcripts/a"
  1953. _ring(service, clock, _transcript(clock, "hello", session_dir=session))
  1954. assert service.status()["session_dir"] == session
  1955. assert brief_file.directories == [session]
  1956. assert service._triage_generation == 0
  1957. assert _cleared(emitted) == []
  1958. assert service.triage_history == ["hello"]
  1959. def test_replay_two_sessions_commits_newest_and_resets_once():
  1960. brief_file = FakeBriefFile()
  1961. service, emitted, clock, _, _ = _triage_service(brief_file=brief_file)
  1962. a, b = "transcripts/a", "transcripts/b"
  1963. _ring(
  1964. service,
  1965. clock,
  1966. _session_event(clock, a),
  1967. _transcript(clock, "old turn", session_dir=a),
  1968. _session_event(clock, b),
  1969. _transcript(clock, "new turn", session_dir=b),
  1970. )
  1971. assert service.status()["session_dir"] == b
  1972. assert brief_file.directories == [b]
  1973. assert service._triage_generation == 1
  1974. assert service.last_triage is None
  1975. assert service._pending_brief == []
  1976. assert len(_cleared(emitted)) == 1
  1977. def test_reconnect_tailing_current_session_is_noop():
  1978. brief_file = FakeBriefFile()
  1979. service, emitted, clock, _, _ = _triage_service(brief_file=brief_file)
  1980. session = "transcripts/a"
  1981. service.handle_event(_session_event(clock, session))
  1982. service.last_triage = {"signals": 1}
  1983. emitted.clear()
  1984. _ring(service, clock, _transcript(clock, "replayed", session_dir=session))
  1985. assert service.status()["session_dir"] == session
  1986. assert brief_file.directories == [session]
  1987. assert service._triage_generation == 0
  1988. assert service.last_triage == {"signals": 1}
  1989. assert _cleared(emitted) == []
  1990. def test_reconnect_older_to_current_resets_once_without_rewind():
  1991. brief_file = FakeBriefFile()
  1992. service, emitted, clock, _, _ = _triage_service(brief_file=brief_file)
  1993. a, b = "transcripts/a", "transcripts/b"
  1994. service.handle_event(_session_event(clock, a))
  1995. service.last_triage = {"signals": 1}
  1996. emitted.clear()
  1997. _ring(
  1998. service,
  1999. clock,
  2000. _session_event(clock, a),
  2001. _transcript(clock, "old", session_dir=a),
  2002. _session_event(clock, b),
  2003. _transcript(clock, "new", session_dir=b),
  2004. )
  2005. assert service.status()["session_dir"] == b
  2006. assert brief_file.directories == [a, b]
  2007. assert service._triage_generation == 1
  2008. assert service.last_triage is None
  2009. assert len(_cleared(emitted)) == 1
  2010. def test_reconnect_only_newer_session_resets_once():
  2011. brief_file = FakeBriefFile()
  2012. service, _, clock, _, _ = _triage_service(brief_file=brief_file)
  2013. a, b = "transcripts/a", "transcripts/b"
  2014. service.handle_event(_session_event(clock, a))
  2015. service.last_triage = {"signals": 1}
  2016. _ring(service, clock, _transcript(clock, "new", session_dir=b))
  2017. assert service.status()["session_dir"] == b
  2018. assert service._triage_generation == 1
  2019. assert service.last_triage is None
  2020. assert brief_file.directories == [a, b]
  2021. def test_reconnect_span_older_current_clears_buffered_older_turns():
  2022. """A RING_END whose ring spanned an older session resets even when the
  2023. newest session already matches the adopted directory (no re-set_directory)."""
  2024. brief_file = FakeBriefFile()
  2025. service, emitted, clock, _, _ = _triage_service(brief_file=brief_file)
  2026. a, b = "transcripts/a", "transcripts/b"
  2027. _ring(service, clock, _session_event(clock, a))
  2028. assert service._triage_generation == 0
  2029. service.handle_event(_transcript(clock, "old turn", session_dir=a))
  2030. assert service._pending_brief == ["Unknown: old turn"]
  2031. service.handle_event(_session_event(clock, b))
  2032. assert service._triage_generation == 1
  2033. service.handle_event(_transcript(clock, "new turn", session_dir=b))
  2034. assert service._pending_brief == ["Unknown: new turn"]
  2035. emitted.clear()
  2036. _ring(
  2037. service,
  2038. clock,
  2039. _session_event(clock, a),
  2040. _transcript(clock, "old turn", session_dir=a),
  2041. _session_event(clock, b),
  2042. _transcript(clock, "new turn", session_dir=b),
  2043. )
  2044. assert service.status()["session_dir"] == b
  2045. assert brief_file.directories == [a, b]
  2046. assert service._pending_brief == []
  2047. assert service._triage_generation == 2
  2048. assert len(_cleared(emitted)) == 1
  2049. def test_daemon_restart_new_session_resets_once():
  2050. brief_file = FakeBriefFile()
  2051. service, _, clock, _, _ = _triage_service(brief_file=brief_file)
  2052. service.handle_event(_session_event(clock, "transcripts/a"))
  2053. service.last_triage = {"signals": 1}
  2054. service.handle_event(_session_event(clock, "transcripts/b"))
  2055. assert service.status()["session_dir"] == "transcripts/b"
  2056. assert service._triage_generation == 1
  2057. assert service.last_triage is None
  2058. assert brief_file.directories == ["transcripts/a", "transcripts/b"]