@bitefoundry/retrieviewer 0.0.14 → 0.0.15

package/ATTENTION.md

@@ -58,8 +58,14 @@ a remote server does not automatically give a local Windows pet remote access.
 
 ## Behavior and limits
 
-- A new exact Room/Seat/generation/turn/request cues one connected sit-and-look-left.
+- A new exact Room/Seat/generation/turn/request cues one connected attention episode:
+  brake/recover and face the user, approach using the existing world path if more
+  than 0.8 m from the near check-in point, then sit and look left. Near pets stay
+  in place. Resolution during approach brakes the obsolete journey naturally.
   Left means the sidebar direction, not a detected button coordinate.
+- The rule cue is accepted before optional inference starts. LLM latency, failure
+  or disagreement never delays, repeats or retracts a confirmed pending alert.
+  This does not remove the existing five-second source polling interval.
 - Explicit ball/treat/tug interactions win. A rejected cue retries only while
   its source fact is fresh. Distinct cues are at least 20 seconds apart.
 - Resolved/disconnected/stale facts clear the cue. Source errors are unavailable,
@@ -76,11 +82,35 @@ These are separate short runs, not a steady-state/peak comparison or a guarantee
 of 1 MiB overhead. Native-helper and transient StackBite CLI memory are additional.
 No new image payload, model or runtime package dependency was added.
 
-Windows additionally displays a small count/offline label in the existing control
-bar. Non-Windows helpers do not yet display that label; their live StackBite
+Windows displays the pending Seat's bounded `role_title` and approval/input kind
+in the existing control bar, with ellipsis and a full-text hover tooltip. The
+local `watch.target` and `attentionLabel` diagnostics expose that same target.
+Names are at most 64 UTF-16 code units, control/directional characters are removed,
+and no task text is retained. Labels never enter model input or saved settings.
+Renaming/replacing a target refreshes the label even if the count is unchanged;
+renaming alone is not a new alert. Missing names use the Seat ID as a fallback.
+Non-Windows helpers do not yet display that label; their live StackBite
 integration remains unverified. Capture/overlay support is a separate platform
 question. No new Wayland or AlmaLinux compatibility claim is made here.
 
+Version 0.0.15 includes these rule-first/target/approach improvements after the
+0.0.14 baseline. A simulated frozen
+LLM and a time-skipped distant notification are available in the local preview.
+They never write StackBite state or make model requests. Real provider events
+still depend on StackBite publishing trustworthy `needs_input` metadata.
+
+Working-copy verification on 2026-10-24: focused tests cover immediate delivery
+with hung/disagreeing advice, local-only bounded labels, same-count renaming,
+late-result cancellation, far-to-near motion, and resolution during approach.
+An owned Windows worker/native-helper run displayed and renamed the actual label,
+cleared it to `Watching`, preserved direct ball priority and exited both children.
+The fixture run used about 112 MiB Node RSS (no LLM), excluding the helper/CLI.
+Matched short watch-off native startup probes of published 0.0.14 and the working
+copy both rounded to 106 MiB Node RSS. These are not steady-state or peak-memory
+guarantees. All nine packaged art archives are byte-identical; no dependency,
+additional resident process or observer timer was added. Labels are bounded
+metadata, not a promise of literally zero additional bytes or allocations.
+
 ## Reuse decision
 
 The first source already exists in StackBite, so a fixed-argv adapter is smaller

package/BRAIN.md

@@ -55,17 +55,21 @@ truncated output, tool calls and responses over 32 KiB. No returned text is run,
 typed, used as a coordinate, or displayed as a factual summary.
 
 This first connection is **advisory on known pending-input facts**, not screen
-understanding. A confirmed approval/question cannot be suppressed by an LLM:
-`notify` follows the model; `ignore` is overridden by the rule; uncertain/errors
-fall back. Diagnostics distinguish `model_notify`, `rule_override`, and
-`rule_fallback`. With only kind/count facts, the model adds little semantic value;
+understanding. Since 0.0.15, a confirmed approval/question is
+delivered by the rule first; optional model work starts only after the pet accepts
+the cue. It cannot delay, suppress, repeat or retract the cue. Diagnostics show
+`rule_first` while advice is pending, then `model_notify` for agreement,
+`rule_override` for disagreement, or `rule_fallback` for uncertain/errors.
+The 0.0.14 baseline waited for advice. With only kind/count facts, the model adds little semantic value;
 this slice establishes a bounded backend before optional richer perception.
 
-Each exact pending item is judged once while fresh. Resolution, generation
+Each accepted exact pending item is judged once while fresh; rejected cues during
+direct play do not spend requests. Seat display names stay local. Resolution, generation
 replacement, stale source, pause, hide and shutdown cancel its request; late
 answers cannot resurrect a notice. Direct ball/treat/tug still wins. Animation
-ticks never await HTTP. Network timeout is 3 seconds; a host-tick guard falls back
-within 3.5 seconds of active time even if a custom judge hangs. `brain-check`
+ticks never await HTTP. Network timeout is 3 seconds; a host-tick guard discards
+hung advice within 3.5 seconds of active time, without delaying the already-issued
+rule alert. `brain-check`
 allows 8 seconds for diagnosis, not for normal pet reactions.
 
 ## Resource and request limits
@@ -109,7 +113,13 @@ pending event, and worker/painter both exited. Node RSS was about 128 MiB in tha
 short run, excluding helper/CLI memory. This is not an incremental or steady-state
 RAM measurement. Existing live companion state was not changed.
 
-All 217 applicable tests passed (two macOS-only checks skipped), including mocked
+For the 0.0.14 baseline, all 217 applicable tests passed (two macOS-only checks skipped), including mocked
 JSON validation, price ceilings, timeout, cache, budget, cancellation and stale
 results. The earlier free Gemma attempt returned 429 and never produced a verified
 live decision; it is no longer the selected backend. Privacy restrictions remain.
+
+The 0.0.15 rule-first candidate passed 223 applicable tests (two macOS-only checks
+skipped), fresh installed-consumer checks and an owned Windows fixture run with
+actual native target-label renaming/clearing. Hung/disagreeing advice is tested
+with mock judges: those tests do not make paid requests. The model request body
+and privacy/price restrictions are unchanged.

package/README.ko.md

@@ -109,6 +109,8 @@ npm uninstall -g @bitefoundry/retrieviewer
 ## StackBite 알림
 
 0.0.14부터 [승인·입력 대기 알림](ATTENTION.md)을 선택해서 켤 수 있어요.
+0.0.15는 LLM을 기다리지 않고 알리고, Windows에 Seat 이름과 대기 종류를 표시해요.
+강아지도 기존 그림으로 가까이 와서 알림 방향을 봐요. 이름은 외부로 보내지 않아요.
 화면 캡처나 자동 승인 없이 현재 Room의 메타데이터만 읽어요.
 업데이트 후, 화면이 보이는 PC의 실행 중인 StackBite Seat에서 실행하세요.
 

package/README.md

@@ -137,6 +137,10 @@ It is opt-in and does not capture screens or operate other apps.
 An [optional paid DeepSeek/OpenRouter backend](./BRAIN.md) can judge anonymous event metadata;
 offline rules remain the default and preserve confirmed pending alerts.
 
+Version 0.0.15 alerts without waiting for the model, shows the Seat name and
+pending kind locally on Windows, and lets the puppy approach before looking
+toward the sidebar. It reuses existing artwork; names never enter model input.
+
 After updating, run inside a live StackBite Seat on the display computer:
 
 ```sh

package/RELEASING.md

@@ -1,4 +1,22 @@
-# Retrieviewer 0.0.14 release process
+# Retrieviewer 0.0.15 release process
+
+Current target: `@bitefoundry/retrieviewer@0.0.15`, public `latest`.
+On 2026-10-24 the owner authorized npm publication of the reviewed rule-first
+attention update. The optional model now runs after a confirmed rule cue is
+accepted; no model response can delay, retract or repeat that cue. Windows
+displays a bounded local Seat name and approval/input kind with a hover tooltip.
+The pet reuses existing front contact, travel and whole-body look material;
+resolved approaches brake naturally and direct play keeps priority.
+
+Keep all nine art archives, runtime dependencies, provider/privacy restrictions,
+price ceilings and request bounds unchanged. Build/install a fresh exact tarball,
+compare every shipped byte, run the full suite and owned native checks, then
+publish that same artifact. Verify registry integrity and a fresh public-registry
+consumer. No StackBite changes, real approval actions, screen capture, host patch,
+live pet restart or website deployment are authorized by this release request.
+macOS/Linux live notification behavior remains unverified.
+
+## Previous 0.0.14 scope (historical)
 
 Current target: `@bitefoundry/retrieviewer@0.0.14`, public `latest`.
 On 2026-10-24 the owner authorized npm publication of the metadata-only StackBite

package/integrations/stackbite/attention.mjs

@@ -24,11 +24,11 @@ export function projectStackBiteSeats(value,{roomId}={}){
    const turnId=Number.isSafeInteger(status.turn_id)&&status.turn_id>0?status.turn_id:null;
    const requestId=identifier(status.input_request_id)?status.input_request_id:undefined;
    if(turnId===null&&requestId===undefined)continue;
-   items.push({id:seat.seat_key,generation:seat.generation,turnId,...requestId===undefined?{}:{requestId},kind:status.input_kind==='approval'?'approval':'input'});
+   items.push({id:seat.seat_key,generation:seat.generation,turnId,...requestId===undefined?{}:{requestId},kind:status.input_kind==='approval'?'approval':'input',label:seat.role_title});
   }else{
    // Older explicit lifecycle facts are accepted only with an exact turn.
    if(!['awaiting_user','blocked'].includes(seat.lifecycle_state)||!Number.isSafeInteger(seat.turn_id)||seat.turn_id<1)continue;
-   items.push({id:seat.seat_key,generation:seat.generation,turnId:seat.turn_id,kind:seat.provider_permission_pending===true||seat.input_kind==='approval'?'approval':'input'});
+   items.push({id:seat.seat_key,generation:seat.generation,turnId:seat.turn_id,kind:seat.provider_permission_pending===true||seat.input_kind==='approval'?'approval':'input',label:seat.role_title});
   }
  }
  return validateAttentionSnapshot({source:'stackbite',scope:roomId,items});

package/integrations/windows-overlay/Overlay.cs

@@ -110,12 +110,12 @@ sealed class Companion : ApplicationContext {
     readonly JavaScriptSerializer json=new JavaScriptSerializer();readonly object inputLock=new object();
     readonly Queue<Dictionary<string,object>> messages=new Queue<Dictionary<string,object>>();
     TargetItem target;Form pickerWindow;QuietWindow testTarget;readonly bool testMode;Rectangle canvas;int revision=0,cell=8;bool visible=false,paused=false,loaded=false,quitting=false,picking=false,announced=false;
-    Label status=new Label();Mutex mutex;string attentionText=null;
+    Label status=new Label();readonly ToolTip attentionTip=new ToolTip();Mutex mutex;string attentionText=null;
     internal Companion(Mutex single,bool diagnostic){
         mutex=single;testMode=diagnostic;bar.Text="Retrieviewer controls";bar.Size=new Size(538,40);bar.BackColor=Color.FromArgb(28,30,34);bar.ForeColor=Color.White;
         bar.Font=new Font("Segoe UI",9);bar.Controls.Add(MakeButton("Ball",8,()=>Interact("ball")));bar.Controls.Add(MakeButton("Treat",76,()=>Interact("treat")));
         bar.Controls.Add(MakeButton("Tug",144,()=>Interact("tug")));bar.Controls.Add(MakeButton("Window",212,ChooseTarget));bar.Controls.Add(MakeButton("Pause",280,TogglePause));bar.Controls.Add(MakeButton("Quit",348,Quit));
-        status.AutoSize=false;status.Location=new Point(422,12);status.Size=new Size(112,22);status.Text="Loading...";bar.Controls.Add(status);
+        status.AutoSize=false;status.AutoEllipsis=true;status.UseMnemonic=false;status.Location=new Point(422,12);status.Size=new Size(112,22);status.Text="Loading...";bar.Controls.Add(status);
         ContextMenuStrip menu=new ContextMenuStrip();menu.Items.Add("Choose window",null,(s,e)=>ChooseTarget());menu.Items.Add("Hide / resume",null,(s,e)=>TogglePause());menu.Items.Add("Quit",null,(s,e)=>Quit());
         tray.Icon=SystemIcons.Application;tray.Text="Retrieviewer · Choose window";tray.ContextMenuStrip=menu;tray.Visible=true;tray.DoubleClick+=(s,e)=>ChooseTarget();
         // Handles are created on the UI thread before the reader can signal EOF.
@@ -154,8 +154,8 @@ sealed class Companion : ApplicationContext {
                 if(type=="interaction"){status.Text=attentionText??(Program.Bool(m,"accepted")?"Ready!":"Please wait");continue;}
                 if(type=="attention"){
                     int count=Program.Int(m,"count");string state=Program.Str(m,"state");
-                    if(count<0||count>32)throw new Exception("Invalid attention count");
-                    attentionText=state=="connected"?(count>0?count+" need input":"Watching"):state=="paused"?"Watch paused":state=="connecting"?"Connecting...":"Watch offline";status.Text=attentionText;
+                    attentionText=Program.AttentionText(state,count,m.ContainsKey("label")?Program.Str(m,"label"):"",m.ContainsKey("kind")?Program.Str(m,"kind"):"");status.Text=attentionText;attentionTip.SetToolTip(status,attentionText);
+                    Program.Emit(new {type="attention-label",text=attentionText});
                     continue;
                 }
                 if(type=="error"){status.Text="Engine error";Quit();return;}
@@ -216,7 +216,7 @@ sealed class Companion : ApplicationContext {
         }
     }
     void Quit(){if(quitting)return;quitting=true;clock.Stop();if(pickerWindow!=null)pickerWindow.Close();pet.Close();bar.Close();tray.Visible=false;tray.Dispose();Program.Emit(new {type="quit"});ExitThread();}
-    protected override void Dispose(bool disposing){if(disposing){clock.Dispose();pet.Dispose();bar.Dispose();tray.Dispose();if(testTarget!=null)testTarget.Dispose();if(mutex!=null){mutex.ReleaseMutex();mutex.Dispose();mutex=null;}}base.Dispose(disposing);}
+    protected override void Dispose(bool disposing){if(disposing){clock.Dispose();attentionTip.Dispose();pet.Dispose();bar.Dispose();tray.Dispose();if(testTarget!=null)testTarget.Dispose();if(mutex!=null){mutex.ReleaseMutex();mutex.Dispose();mutex=null;}}base.Dispose(disposing);}
 }
 
 static class Program {
@@ -226,6 +226,17 @@ static class Program {
     internal static int Int(Dictionary<string,object> m,string key){return Convert.ToInt32(m[key]);}
     internal static string Str(Dictionary<string,object> m,string key){return Convert.ToString(m[key]);}
     internal static bool Bool(Dictionary<string,object> m,string key){return Convert.ToBoolean(m[key]);}
+    internal static string AttentionText(string state,int count,string label,string kind){
+        if(count<0||count>32||label.Length>64)throw new Exception("Invalid attention metadata");
+        foreach(char c in label)if(char.IsControl(c)||(c>=0x200b&&c<=0x200f)||(c>=0x202a&&c<=0x202e)||(c>=0x2060&&c<=0x206f))throw new Exception("Invalid attention label");
+        if(state=="connected"){
+            if(count==0)return "Watching";
+            if(label.Length==0)return count+" need input";
+            if(kind!="approval"&&kind!="input")throw new Exception("Invalid attention kind");
+            return label+" - "+(kind=="approval"?"Approval pending":"Input pending")+(count>1?" (+"+(count-1)+")":"");
+        }
+        return state=="paused"?"Watch paused":state=="connecting"?"Connecting...":"Watch offline";
+    }
     [STAThread] static int Main(string[] args){
         try{
             // GUI-subsystem processes have redirected handles but no console code
@@ -269,8 +280,9 @@ static class Program {
             Native.ShowWindow(target.Handle,4);Application.DoEvents();bool restored=!Native.IsIconic(target.Handle);
             bool focus=Native.GetForegroundWindow()==foreground;
             bool gridBounds=GridCell(3840,2160)==8&&GridCell(7680,4320)==12&&GridCell(32000,18000)==0&&GridCell(int.MaxValue,int.MaxValue)==0&&GridCell(0,0)==0;
-            bool passed=clickThrough&&noActivate&&layered&&follows&&minimized&&hidden&&restored&&focus&&pet.PaintedDots>0&&gridBounds;
-            Emit(new {type="self-test",passed=passed,gridBounds=gridBounds,clickThroughStyle=clickThrough,noActivateStyle=noActivate,layered=layered,followGeometry=follows,expectedX=expectedX,expectedY=expectedY,actualX=actual.Left,actualY=actual.Top,minimize=minimized,hide=hidden,restore=restored,foregroundPreserved=focus,dots=pet.PaintedDots,proof=proof});return passed?0:1;
+            bool labels=AttentionText("connected",2,"Worker & Review","approval")=="Worker & Review - Approval pending (+1)"&&AttentionText("connected",0,"","")=="Watching";
+            bool passed=clickThrough&&noActivate&&layered&&follows&&minimized&&hidden&&restored&&focus&&pet.PaintedDots>0&&gridBounds&&labels;
+            Emit(new {type="self-test",passed=passed,attentionLabels=labels,gridBounds=gridBounds,clickThroughStyle=clickThrough,noActivateStyle=noActivate,layered=layered,followGeometry=follows,expectedX=expectedX,expectedY=expectedY,actualX=actual.Left,actualY=actual.Top,minimize=minimized,hide=hidden,restore=restored,foregroundPreserved=focus,dots=pet.PaintedDots,proof=proof});return passed?0:1;
         }
     }
 }

package/integrations/windows-overlay/worker.mjs

@@ -10,7 +10,7 @@ import {controlAddress,parseHelperSpec} from '../desktop/platform.mjs';
 
 let helper,pump,timer,server,session,paths,owned=false,stopping=false,frames=0,paintedFrames=0,visible=false,selected=false,pickerVisible=false,pendingViewport=null,lastInteraction=null;
 let nativeError=null,ready=false,detached=false;
-let attention=null,brain=null;
+let attention=null,brain=null,attentionLabel=null;
 const returnStyle=process.env.RETRIEVIEWER_RETURN_STYLE??'auto';
 const watchSource=process.env.RETRIEVIEWER_WATCH??'off';
 const brainSource=process.env.RETRIEVIEWER_BRAIN??'off';
@@ -44,7 +44,7 @@ try{
    body+=bytes.toString('utf8');if(body.length>2048)return socket.destroy();if(!body.includes('\n'))return;
    let command;try{command=JSON.parse(body.split('\n')[0]);}catch{return socket.destroy();}
    if(command.token!==session.token||!['status','stop'].includes(command.command))return socket.destroy();
-   socket.end(JSON.stringify(command.command==='stop'?{stopped:true}:{running:true,reachable:true,selected,visible,pickerVisible,frames,paintedFrames,lastInteraction,returnStyle,watch:{source:watchSource,...attention?.status??{state:'off',pendingCount:0}},brain:brain?.status??{provider:'off',state:'off'},pid:process.pid,painterPid:helper?.pid,rssBytes:process.memoryUsage().rss})+'\n');
+   socket.end(JSON.stringify(command.command==='stop'?{stopped:true}:{running:true,reachable:true,selected,visible,pickerVisible,frames,paintedFrames,lastInteraction,returnStyle,attentionLabel,watch:{source:watchSource,...attention?.status??{state:'off',pendingCount:0}},brain:brain?.status??{provider:'off',state:'off'},pid:process.pid,painterPid:helper?.pid,rssBytes:process.memoryUsage().rss})+'\n');
    if(command.command==='stop')stop();
   });
  });
@@ -66,6 +66,7 @@ try{
    else if(m.type==='picker')pickerVisible=m.visible===true;
    else if(m.type==='viewport'){pendingViewport=m;visible=m.visible;selected=m.selected===true;pump?.viewport(m);}
    else if(m.type==='ack'){frames++;if(m.painted)paintedFrames++;pump?.ack();}
+   else if(m.type==='attention-label'){if(typeof m.text!=='string'||m.text.length>160)throw Error('Invalid attention label');attentionLabel=m.text;}
    else if(m.type==='pause')pump?.pause(m.paused);
    else if(m.type==='interact'){const accepted=pump?.interact(m.kind)??false;lastInteraction={kind:m.kind,accepted};write({type:'interaction',kind:m.kind,accepted});}
    else if(m.type==='quit')stop();
@@ -83,7 +84,7 @@ try{
    attention=createAttentionMonitor({readSnapshot:source.readSnapshot,...brain?{judgeNotice:input=>brain.decide(input)}:{},onNotice:notice=>pump.notify(notice),onClear:()=>pump.clearNotice(),onChange:status=>{
     // Older POSIX helpers deliberately reject unknown message types. They can
     // run the visual cue, but only the Windows bar implements this status label.
-    if(spec.mode==='windows-overlay')write({type:'attention',state:status.state,count:status.pendingCount});
+    if(spec.mode==='windows-overlay')write({type:'attention',state:status.state,count:status.pendingCount,label:status.target?.label??'',kind:status.target?.kind??''});
    }});
   }
   write({type:'loaded',ink:process.env.RETRIEVIEWER_INK??'cream'});timer=setInterval(()=>{try{attention?.tick({active:!pump.hidden});pump.tick();}catch(error){write({type:'error',message:error.message});stop();}},1000/spec.fps);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitefoundry/retrieviewer",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "A fluffy Braille desktop pet for Windows and Linux X11, with experimental macOS support and an embeddable TUI engine.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://bitefoundry.github.io/retrieviewer/",

package/puppy-companion-life.mjs

@@ -26,7 +26,7 @@ const LABEL={
  belly:'배를 보이고 발라당 쉬는 중',sleep:'새근새근 잠자는 중',tug:'장난감을 물고 당기는 중',
  butterflyNotice:'나비를 발견하고 귀를 쫑긋하는 중',butterfly:'나비를 폴짝폴짝 쫓는 중',butterflyBye:'날아가는 나비를 바라보는 중',
  fetch:'공을 쫓아가는 중',miss:'굴러가는 공을 한 번 놓친 중',reChase:'공을 다시 쫓아가는 중',tumble:'우당탕 균형을 되찾는 중',pickup:'공을 무는 중',carry:'공을 물고 돌아오는 중',drop:'공을 내려놓는 중',offer:'공을 내려놓고 기다리는 중',
- treatSit:'간식 앞에 앉는 중',chew:'간식 먹는 중',notifySit:'확인할 일을 발견하고 앉는 중',notify:'확인할 일이 있는 쪽을 바라보는 중'
+ treatSit:'간식 앞에 앉는 중',chew:'간식 먹는 중',notifySit:'확인할 일을 발견하고 앉는 중',notifyContact:'확인할 일이 있어 사용자를 바라보는 중',notifyCome:'확인할 일을 알려주러 가까이 오는 중',notify:'확인할 일이 있는 쪽을 바라보는 중'
 };
 const PENDING_LABEL={treat:'곧 간식',tug:'곧 터그놀이'};
 // Baked interaction clips, played only while holding at the shared seated endpoint.
@@ -238,7 +238,11 @@ export function createCompanionLife(actor,{seed=731,energy=.8,returnStyle='auto'
   if(pending&&!active)startInteraction();
   if(notice?.phase==='queued'&&!active&&!pending){
    notice.phase='showing';
-   queue=[sit('notifySit'),cmd('look',[notice.side],'notify'),wait(2.5,'notify'),fx(()=>{notice=null;})];
+   const far=()=>{const s=actor.sample(clock);return Math.hypot(s.x-HOME.x,s.z-HOME.z)>.8;};
+   queue=[sit('notifySit'),wait(.45,'notifyContact'),
+    fx(()=>{if(far())notice.phase='approaching';}),cmd('go',[HOME.x,HOME.z],'notifyCome',far),
+    sit('notifySit'),fx(()=>{notice.phase='showing';}),wait(.6,'notifyContact'),
+    cmd('look',[notice.side],'notify'),wait(2.5,'notify'),fx(()=>{notice=null;})];
   }
   // Run instant effects; stop at the first hold or issued command (at most one command per update).
   for(;;){
@@ -311,7 +315,10 @@ export function createCompanionLife(actor,{seed=731,energy=.8,returnStyle='auto'
 
  function clearNotice(){
   if(!notice)return;
+  const approaching=notice.phase==='approaching';
   notice=null;queue=[];hold=0;holdIntent=null;gesture=null;waiting=null;
+  intent='recover';label=LABEL.recover;
+  if(approaching)actor.attend?.();
   // Let any connected head turn/sit finish naturally. No snap or new route.
  }
  function notify({kind,side='left'}={}){

package/retrieviewer-attention.d.mts

@@ -1,15 +1,17 @@
 export interface AttentionSnapshot {
  source: string;
  scope: string;
- items: {id: string; generation: string; turnId: number | null; requestId?: string; kind: 'approval' | 'input'}[];
+ /** label is a bounded local display name, never remote model input. */
+ items: {id: string; generation: string; turnId: number | null; requestId?: string; kind: 'approval' | 'input'; label?: string}[];
 }
 export interface AttentionStatus {
  state: 'connecting' | 'connected' | 'unavailable' | 'paused' | 'stale' | 'off';
  pendingCount: number;
+ target: {seatId: string; label: string; kind: 'approval' | 'input'} | null;
  retainedNotices: number;
  inFlight: boolean;
  judging?: boolean;
- lastJudgment?: 'model_notify' | 'rule_override' | 'rule_fallback' | null;
+ lastJudgment?: 'rule_first' | 'model_notify' | 'rule_override' | 'rule_fallback' | null;
 }
 export function validateAttentionSnapshot(value: unknown): AttentionSnapshot;
 /** Host owns tick/lifetime. Import and construction start no timers or I/O. */
@@ -18,7 +20,7 @@ export function createAttentionMonitor(options: {
  onNotice: (notice: {kind: 'approval' | 'input'; side: 'left'}) => boolean;
  onClear?: () => void;
  onChange?: (status: AttentionStatus) => void;
- /** Anonymous metadata only. Confirmed pending alerts cannot be suppressed. */
+ /** Anonymous metadata only. Runs after the immediate rule alert, never delays or suppresses it. */
  judgeNotice?: (input: {kind: 'approval' | 'input'; pendingCount: number; signal: AbortSignal}) => Promise<{decision: 'notify' | 'ignore' | 'uncertain'}>;
  judgeTimeoutMs?: number;
  now?: () => number;

package/retrieviewer-attention.mjs

@@ -2,14 +2,18 @@
 // Screen/app text is data, never an instruction or an executable action.
 const MAX_ITEMS=32,MAX_SEEN=128;
 const bounded=(value,max=128)=>typeof value==='string'&&value.length>0&&value.length<=max&&!/[\x00-\x1f\x7f]/.test(value);
+// Cosmetic, local-only metadata. Never let a malformed title hide a real alert.
+const localLabel=value=>typeof value==='string'?value.slice(0,256).replace(/[\x00-\x1f\x7f-\x9f\u200b-\u200f\u202a-\u202e\u2060-\u206f]/g,'').replace(/\s+/g,' ').trim().slice(0,64).replace(/[\ud800-\udbff]$/,'')||undefined:undefined;
 export function validateAttentionSnapshot(value){
  if(!value||!bounded(value.source,32)||!bounded(value.scope,256)||!Array.isArray(value.items)||value.items.length>MAX_ITEMS)throw Error('Invalid attention snapshot');
  const identities=new Set();
  const items=value.items.map(item=>{
   if(!item||!bounded(item.id)||!bounded(item.generation)||!(item.turnId===null||Number.isSafeInteger(item.turnId)&&item.turnId>=1)||item.requestId!==undefined&&!bounded(item.requestId)||item.turnId===null&&item.requestId===undefined||!['approval','input'].includes(item.kind))throw Error('Invalid attention item');
   const key=JSON.stringify([item.id,item.generation,item.turnId,item.requestId??null]);if(identities.has(key))throw Error('Duplicate attention item');identities.add(key);
-  // Do not retain arbitrary source fields, output text, prompts, paths or tokens.
-  return {id:item.id,generation:item.generation,turnId:item.turnId,...item.requestId===undefined?{}:{requestId:item.requestId},kind:item.kind};
+  // No arbitrary source fields, output text, prompts, paths or tokens. A Seat's
+  // bounded display label is for local status only, never the remote judge.
+  const label=localLabel(item.label);
+  return {id:item.id,generation:item.generation,turnId:item.turnId,...item.requestId===undefined?{}:{requestId:item.requestId},kind:item.kind,...label?{label}:{}};
  });
  return {source:value.source,scope:value.scope,items};
 }
@@ -19,14 +23,19 @@ export function createAttentionMonitor({readSnapshot,onNotice,onClear=()=>{},onC
  if(judgeNotice!==undefined&&typeof judgeNotice!=='function')throw TypeError('judgeNotice must be a function');
  if(!Number.isFinite(judgeTimeoutMs)||judgeTimeoutMs<100||judgeTimeoutMs>15000)throw RangeError('Invalid judge timeout');
  if(!Number.isFinite(intervalMs)||intervalMs<1000||intervalMs>60000||!Number.isFinite(staleMs)||staleMs<intervalMs*2||staleMs>300000||!Number.isFinite(noticeCooldownMs)||noticeCooldownMs<1000||noticeCooldownMs>300000)throw RangeError('Invalid attention timing');
- let disposed=false,paused=false,flight=null,nextRead=0,nextNotice=0,lastSuccess=null,snapshot=null,state='connecting',lastReport='',cueKey=null,judgment=null,lastJudgment=null;
+ let disposed=false,paused=false,flight=null,nextRead=0,nextNotice=0,lastSuccess=null,snapshot=null,state='connecting',lastReport='',cueKey=null,judgment=null,lastJudgment=null,target=null,targetKey='';
  const seen=new Map();
  const identity=(value,item)=>JSON.stringify([value.source,value.scope,item.id,item.generation,item.turnId,item.requestId??null]);
- const clearCue=()=>{if(cueKey!==null){cueKey=null;onClear();}};
+ const refreshTarget=()=>{
+  const item=snapshot?.items.find(row=>identity(snapshot,row)===cueKey)??snapshot?.items.find(row=>row.kind==='approval')??snapshot?.items[0];
+  target=item?{seatId:item.id,label:item.label??(item.id.length<=32?item.id:'Seat '+item.id.slice(-8)),kind:item.kind}:null;
+  targetKey=JSON.stringify(target);
+ };
+ const clearCue=()=>{if(cueKey!==null){cueKey=null;refreshTarget();onClear();}};
  const cancelJudgment=()=>{const old=judgment;judgment=null;old?.controller.abort();};
- const report=()=>({state,pendingCount:snapshot?.items.length??0,retainedNotices:seen.size,inFlight:flight!==null,...judgeNotice?{judging:!!judgment&&!judgment.ready,lastJudgment}:{}});
- const changed=()=>{const key=state+'|'+(snapshot?.items.length??0);if(key!==lastReport){lastReport=key;onChange(report());}};
- const clear=next=>{snapshot=null;lastSuccess=null;state=next;cancelJudgment();clearCue();changed();};
+ const report=()=>({state,pendingCount:snapshot?.items.length??0,target:target?{...target}:null,retainedNotices:seen.size,inFlight:flight!==null,...judgeNotice?{judging:!!judgment&&!judgment.ready,lastJudgment}:{}});
+ const changed=()=>{const key=state+'|'+(snapshot?.items.length??0)+'|'+targetKey+'|'+!!judgment+'|'+lastJudgment;if(key!==lastReport){lastReport=key;onChange(report());}};
+ const clear=next=>{snapshot=null;refreshTarget();lastSuccess=null;state=next;cancelJudgment();clearCue();changed();};
  function startRead(t){
   const operation={controller:new AbortController()};flight=operation;nextRead=t+intervalMs;
   operation.done=(async()=>{
@@ -38,6 +47,7 @@ export function createAttentionMonitor({readSnapshot,onNotice,onClear=()=>{},onC
     snapshot=result;lastSuccess=now();state='connected';
     if(cueKey!==null&&!snapshot.items.some(item=>identity(snapshot,item)===cueKey))clearCue();
     if(judgment&&!snapshot.items.some(item=>identity(snapshot,item)===judgment.key))cancelJudgment();
+    refreshTarget();
    }catch{
     if(disposed||paused||flight!==operation)return;
     // No source stderr, credentials, or stale pending facts escape on failure.
@@ -58,35 +68,33 @@ export function createAttentionMonitor({readSnapshot,onNotice,onClear=()=>{},onC
    if(paused){paused=false;nextRead=t;state='connecting';changed();}
    if(snapshot&&t-lastSuccess>=staleMs)clear('stale');
    if(!flight&&t>=nextRead)startRead(t);
+   // Advice settles independently of alert delivery. It cannot delay, retract,
+   // repeat, or move an already-confirmed human-input notification.
+   if(judgment){
+    if(!judgment.ready&&t-judgment.start>=judgeTimeoutMs){judgment.ready=true;judgment.decision='uncertain';judgment.controller.abort();}
+    if(judgment.ready){lastJudgment=judgment.decision==='notify'?'model_notify':judgment.decision==='ignore'?'rule_override':'rule_fallback';judgment=null;}
+   }
    // A refresh already in flight may resolve/replace the candidate. Do not emit
    // an old cue in the microtask gap just before that fresh snapshot arrives.
    if(!flight&&snapshot&&state==='connected'&&t<lastSuccess+staleMs&&t>=nextNotice){
     // Approval and generic input for the same exact turn are one notification.
     let item=null;
     for(const row of snapshot.items)if(!seen.has(identity(snapshot,row))){if(!item)item=row;if(row.kind==='approval'){item=row;break;}}
-    if(item&&judgeNotice){
-     const key=identity(snapshot,item);
-     if(judgment?.key!==key){
-      cancelJudgment();const operation={key,controller:new AbortController(),ready:false,start:t};judgment=operation;
+    if(item&&onNotice({kind:item.kind,side:'left'})===true){
+     const key=identity(snapshot,item);seen.set(key,true);cueKey=key;
+     refreshTarget();
+     if(judgeNotice){
+      cancelJudgment();lastJudgment='rule_first';
+      const operation={key,controller:new AbortController(),ready:false,start:t};judgment=operation;
       const facts={kind:item.kind,pendingCount:snapshot.items.length,signal:operation.controller.signal};
-      // Only anonymous enums/counts leave the coordinator; identities stay local.
       operation.done=Promise.resolve().then(()=>{if(operation.controller.signal.aborted)throw Error('Canceled judgment');return judgeNotice(facts);}).then(result=>{
        if(judgment===operation&&!disposed&&!paused&&!operation.controller.signal.aborted){operation.decision=['notify','ignore','uncertain'].includes(result?.decision)?result.decision:'uncertain';operation.ready=true;}
       },()=>{if(judgment===operation&&!disposed&&!paused){operation.decision='uncertain';operation.ready=true;}});
      }
-     if(!judgment.ready&&t-judgment.start>=judgeTimeoutMs){judgment.ready=true;judgment.decision='uncertain';judgment.controller.abort();}
-     if(!judgment.ready){changed();return;}
-     // These are confirmed pending human-input facts, not speculative screen
-     // guesses. A model may advise, but may never hide them or authorize input.
-    }
-    if(item&&onNotice({kind:item.kind,side:'left'})===true){
-     if(judgment)lastJudgment=judgment.decision==='notify'?'model_notify':judgment.decision==='ignore'?'rule_override':'rule_fallback';
-     const key=identity(snapshot,item);seen.set(key,true);cueKey=key;
      // Still-pending identities cannot be evicted into repeated notifications.
      const live=new Set(snapshot.items.map(row=>identity(snapshot,row)));
      for(const prior of seen.keys()){if(seen.size<=MAX_SEEN)break;if(!live.has(prior))seen.delete(prior);}
      nextNotice=t+noticeCooldownMs;
-     cancelJudgment();
     }
    }
    changed();
@@ -94,6 +102,6 @@ export function createAttentionMonitor({readSnapshot,onNotice,onClear=()=>{},onC
   get status(){return report();},
   // For host shutdown/verification, not a second polling loop.
   async settled(){await flight?.done;await judgment?.done;},
-  dispose(){if(disposed)return;disposed=true;const old=flight;flight=null;old?.controller.abort();cancelJudgment();clearCue();snapshot=null;seen.clear();state='off';},
+  dispose(){if(disposed)return;disposed=true;const old=flight;flight=null;old?.controller.abort();cancelJudgment();snapshot=null;refreshTarget();clearCue();seen.clear();state='off';},
  };
 }

package/retrieviewer.d.mts

@@ -41,7 +41,7 @@ export interface PetState {
 }
 export interface LifeReport {
   /** Metadata-triggered visual cue only. No host input or approval authority. */
-  attention: {kind: 'approval' | 'input'; side: 'left' | 'right'; phase: 'queued' | 'showing'} | null;
+  attention: {kind: 'approval' | 'input'; side: 'left' | 'right'; phase: 'queued' | 'approaching' | 'showing'} | null;
   /** Last selected autonomous episode; null before the first decision. */
   episode: string | null;
   intent: string;