@bitefoundry/retrieviewer 0.0.10 → 0.0.11

package/ASSET-PROVENANCE.md

@@ -95,6 +95,13 @@ puppy sheet, not new photographs. COMFORT-ART.md records the prompt, source hash
 and fixed-scale preparation. The ninth archive is covered explicitly by
 ASSETS-LICENSE.md and ATTRIBUTION.md. Original sheet PNGs remain outside npm.
 
+Local candidate2026-10-24 changes only offline watch-frame selection: the same
+15 approved whole-body drawings are held, not crossfaded into double contours.
+Source sheet SHA256 and registration stay unchanged; `watchRegistration` now
+records the exact36 source-key indices and `pixelBlending:false`. No new generated
+or photographic input, asset family or attribution is added. Existing CC BY-SA4.0
+terms and all non-watch pixels remain unchanged. See WATCH-REDRAW.md for the A/B.
+
 Copyrightability of AI-generated expression, the precise derivative-work analysis,
 and worldwide name clearance are not conclusively determined here. Existing
 domestic trademark research records possible similar marks; owning an npm scope

package/EMBEDDING.md

@@ -30,6 +30,12 @@ pet.dispose();
 - Frame contains text,columns,rows,artProfile,pixels,state,report,placement,
   projection,mouth,contacts. pixels is a **borrowed** RGBA buffer: valid only until
   next frame/dispose; copy if retaining. The wrapper also retains no frame.
+- needsFrame(frameOptions): optional pre-render check for a host that only needs
+  changed pictures. False means a known held pose and all visible objects match
+  the last frame. Always keep calling step(dt); needs/cooldowns/autonomy continue.
+  Moving poses, gestures, visitors and sleep cues conservatively return true.
+  frame() itself never skips or returns stale metadata. Force a frame when the
+  host loses its display contents (for example after hiding or reconnecting).
 - camera:{viewportWidth,viewportHeight,rect:{left,top,width,height}} places a pane
   within a larger viewport. Keep it consistent across time for metric perspective.
 - interact('ball'|'treat'): false while busy/cooling down; unknown kind throws.

package/PUPPY-MEMORY.md

@@ -1,5 +1,37 @@
 # Runtime weight and performance
 
+## Held-pose invalidation (local candidate, 2026-10-24)
+
+The desktop pump now asks `pet.needsFrame(viewport)` before rasterization. Only
+known held seated/down poses qualify; the key includes their source selection,
+world position, camera/grid and visible objects. Moving/turning poses, gestures,
+butterflies and sleep cues take the normal rendering path. Simulation, needs,
+cooldowns and autonomous decisions still advance. Accepted input, viewport
+revision and pause/resume invalidate immediately. `frame()` itself still paints
+and returns current metadata and the same borrowed-buffer contract. One small
+key is retained, not another raster; no dependency, timer or process is added.
+
+Same seed731, 480x135 cells, 450 ticks at30Hz, first throw at tick24, brake return:
+without the hint450 renderer calls, with it300; both publish259 identical native
+frames (transport SHA256 `4069444df1bc5c1a43375ff8f3f9a4cee9bc9965c047ae5f6bfecdcc01721985`).
+During one settled1s offer, full renderer calls fall from30 to0. One local pair
+measured CPU2469ms ->1499ms; timing is a sample, not a universal CPU saving.
+Reproduce with `node tools/benchmark-held-render.mjs`.
+
+Offscreen fresh-process diagnostic-GC RSS is effectively unchanged: loaded
+102,940,672 ->102,952,960 bytes; rendered179,982,336 ->180,019,200 bytes.
+The retained ArrayBuffer difference is -19,124 bytes, mainly fewer unique watch
+samples. This is a CPU/allocation-work improvement, NOT a large desktop RAM cut.
+No live native-helper RSS or Linux/macOS performance was measured in this pass.
+
+Long-run treat/tug attention now replans a local brake from the current speed:
+`d = v*v/(2*a)`, retaining heading, distance-driven gait phase and existing
+run/walk deceleration. It cancels obsolete waypoints rather than waiting for a
+15m trip to finish. A hand-fed treat appears immediately; recovery at the tested
+rear-running speeds finishes in1.08-1.94s, including turning and sitting.
+Existing roll/tug/walk-entry recovery still reaches connected source endpoints.
+This does not change ball-return variants or multiply physical simulation time.
+
 ## Spatial autonomy and allocation pass (0.0.10)
 
 Autonomous strolls, dashes and butterfly visits no longer end with an unconditional

package/RELEASING.md

@@ -1,4 +1,21 @@
-# Retrieviewer 0.0.10 release process
+# Retrieviewer 0.0.11 release process
+
+Current target: `@bitefoundry/retrieviewer@0.0.11`, public `latest`.
+On2026-10-24 the owner accepted the reviewed candidate and authorized immediate
+release. This scope removes blended watch contours while retaining all15 approved
+whole-body keys, interrupts treat/tug journeys with velocity-continuous braking,
+and checks held-pose dirtiness before rasterization. Existing fetch patterns and
+all three return choices remain. No new runtime dependency, timer or process.
+RAM is effectively unchanged; this pass reduces repeated CPU/allocation work.
+
+Build a fresh exact tarball, install outside the source tree, compare every
+installed byte, check its owned Windows native lifecycle and bilingual browser
+runtime, then publish that exact tarball. Verify registry integrity and GitHub
+Pages runtime bytes afterwards. Do not restart the user's existing companion.
+Earlier npm artifacts remain immutable. MIT code / CC BY-SA4.0 artwork and
+experimental macOS / X11-only Linux boundaries remain unchanged.
+
+## Previous 0.0.10 scope (historical)
 
 The owner explicitly requested publication and website deployment after reviewing
 the repaired watch/fetch motion and restoring the original braking return as an

package/WATCH-REDRAW.md

@@ -159,6 +159,17 @@ after accepting candidates; the pending package tarball is obsolete.
 
 ## Local review
 
+Local follow-up (2026-10-24): source-key selection replaces the pixel crossfade
+in `prepare-watch-redraw.py`. All15 registered whole-body keys, common scale,
+ground registration,36 logical samples and canonical seat endpoints remain.
+Each sample is now one exact authored key; outward/return paths reuse the same
+bytes instead of drawing two semi-transparent muzzles/shoulders. No new image,
+geometry warp or runtime blend is introduced. Non-watch decoded pixels remain
+byte-exact. The behavior archive drops from1,286,465 to1,270,759 gzip bytes.
+`dist/watch-no-ghost-v1/` preserves the candidate and source-key receipt;
+`git show HEAD:puppy-paper-behaviors-q5.bin.gz` remains the immutable release A/B.
+Automated checks do not replace final owner approval of the new held-key cadence.
+
 - `node tools/prepare-watch-redraw.mjs` writes a candidate, not shipped assets.
 - `node tools/check-watch-redraw.mjs` makes a same-state old/new text replay.
 - `node tools/prepare-scramble-art.mjs` writes a candidate, not shipped assets.

package/integrations/windows-overlay/protocol.mjs

@@ -30,13 +30,16 @@ export function createFramePump({pet,send,now=()=>performance.now()}){
    alive();if(inFlight||!viewport||paused)return false;
    const t=now(),dt=last===null?0:Math.max(0,(t-last)/1000);last=t;
    pet.step(dt);if(t<nextPaint)return false;
+   // Do this BEFORE rasterization/Braille conversion. Older embedders without
+   // the optional hint retain the original byte-comparison fallback below.
+   if(lastFrame&&pet.needsFrame?.(viewport)===false)return false;
    const source=pet.frame(viewport),frame=cropFrame(source,revision);
    nextPaint=source.state?.state==='sleep'?t+200:0;
    // A held seat/down pose can be byte-identical for seconds. Advance the life
    // clock normally but avoid JSON, IPC, bitmap allocation and native repaint.
    if(lastFrame&&frame.x===lastFrame.x&&frame.y===lastFrame.y&&frame.columns===lastFrame.columns&&frame.rows===lastFrame.rows&&frame.text===lastFrame.text)return false;
    inFlight=true;
-   try{send(frame);lastFrame=frame;}catch(error){inFlight=false;throw error;}return true;
+   try{send(frame);lastFrame=frame;}catch(error){inFlight=false;lastFrame=null;nextPaint=0;throw error;}return true;
   },
   interact(kind){alive();if(!['ball','treat','tug'].includes(kind))throw Error('Invalid overlay interaction');const accepted=pet.interact(kind);if(accepted){lastFrame=null;nextPaint=0;}return accepted;},
   get hidden(){return !viewport||paused;},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitefoundry/retrieviewer",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "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/pet-q5-manifest.json

@@ -77,14 +77,14 @@
    "width": 320,
    "height": 320,
    "frames": 162,
-   "uniqueFrames": 128,
+   "uniqueFrames": 126,
    "sourceSha256": "7918261fb64c57a91739729841fd84c6dd53891196c7fb76ee9c27712ab6ef5d",
    "sourcePackedSha256": "7785ef65b8a2a5bf6f7ce600fe9957a60d9af82066ff49275bba061eac5392d1",
-   "encodedBytes": 5918897,
-   "gzipBytes": 1286465,
-   "residentPixelBytes": 3680463,
-   "encodedSha256": "06b2ab8e0d4ff42600818c8eb96bba4089ba77560c6e9b98a662af3967271c2d",
-   "quantizedSha256": "07d919258ed32175fed81cfe848f5336edaf88706a3b04bfb51506f82c1b2083",
+   "encodedBytes": 5797825,
+   "gzipBytes": 1270759,
+   "residentPixelBytes": 3605128,
+   "encodedSha256": "cb045558ca490436c5d6703f6468daba26f20ed76bc886e829787889253ccbb9",
+   "quantizedSha256": "eb5007588c9f1843a9279fa21ee701e0f1ac3238d2dda70cc8e8c0c900e3c34b",
    "watchRegistration": {
     "sourceSize": [
      1619,
@@ -99,6 +99,45 @@
     "nonlinearWarp": false,
     "perKeyScale": false,
     "runtimeCompositing": false,
+    "pixelBlending": false,
+    "sourceKeys": [
+     7,
+     8,
+     9,
+     10,
+     11,
+     11,
+     12,
+     13,
+     14,
+     14,
+     13,
+     12,
+     11,
+     11,
+     10,
+     9,
+     8,
+     7,
+     7,
+     6,
+     5,
+     4,
+     3,
+     3,
+     2,
+     1,
+     0,
+     0,
+     1,
+     2,
+     3,
+     3,
+     4,
+     5,
+     6,
+     7
+    ],
     "keys": 15,
     "frames": 36,
     "sourceSheetSha256": "34b9bbca507f82c739c39e4b42e2390202863189d6d1b5e6e8ca7293555e19d3",

package/puppy-companion-life.mjs

@@ -1,8 +1,8 @@
 // Autonomous companion "life" controller layered over a paper puppy actor.
 // The parent calls actor.update(dt) THEN life.update(dt). Commands are only issued
 // while the actor rests at a shared safe endpoint (idle/down); everything else waits.
-// Exception: an accepted ball throw reacts at once via actor.chase (the actor owns safe
-// interruption); actors without chase fall back to go at the next safe endpoint.
+// Accepted interactions ask the actor for safe interruption: chase for a ball,
+// attend for a hand-fed treat/tug. Substitute actors can use safe-endpoint fallback.
 // Parameters are authored for feel, not canine science.
 import {paperCameraPoint,paperGroundTarget,PAPER_SCREEN,PAPER_CAMERA} from './puppy-paper-world.mjs';
 import {createBallPath,createFetchPatterns} from './puppy-companion-ball.mjs';
@@ -260,12 +260,15 @@ export function createCompanionLife(actor,{seed=731,energy=.8,returnStyle='auto'
   quiet=0;
   if(butterfly||lastEpisode==='butterfly'){
    butterfly=null;queue=[];hold=0;holdIntent=null;gesture=null;waiting=null;
-   if(kind!=='ball')actor.sit();
   }
   if(kind==='treat'||kind==='tug'){
    pending=kind;
-   // The pet wakes through its authored recovery, not after a long sleep timer.
-   if(['sleep','belly'].includes(actor.sample(clock).state))actor.sit();
+   queue=[];hold=0;holdIntent=null;gesture=null;waiting=null;
+   // Show the hand now, not several seconds later after the old route ends.
+   if(kind==='treat')treat=true;
+   if(typeof actor.attend==='function')actor.attend();
+   // Backward-compatible substitute actors may only support sleep recovery.
+   else if(['sleep','belly'].includes(actor.sample(clock).state))actor.sit();
    return true;
   }
   // Ball: launch now and drop obsolete controller plans; the actor's own state is left to chase.

package/puppy-paper.mjs

@@ -1,7 +1,7 @@
 import {createCachedTween,retimeRun,cleanGroundOffset} from './puppy-clean.mjs';
 import {createPaperFootLock,footSourcePoint,createRearSampler,createPaperSupportEpisodes} from './puppy-paper-contact.mjs';
 import {createPaperSeatSampler} from './puppy-paper-seat.mjs';
-import {planPaperRun,planPaperWalk,planPaperCarry,planPaperStumble,paperWalkTarget,planPaperApproach,planPaperApproachTravel,PAPER_GAITS,PAPER_GROUND,paperGroundTarget} from './puppy-paper-world.mjs';
+import {planPaperRun,planPaperWalk,planPaperCarry,planPaperStumble,planPaperTravel,paperWalkTarget,planPaperApproach,planPaperApproachTravel,PAPER_DYNAMICS,PAPER_GAITS,PAPER_GROUND,paperGroundTarget} from './puppy-paper-world.mjs';
 import {createPaperDirector} from './puppy-paper-director.mjs';
 import {createPaperBehaviorSampler,paperBehaviorPose} from './puppy-paper-behaviors.mjs';
 import {createPaperAreaSampler} from './puppy-paper-area.mjs';
@@ -97,6 +97,9 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
  const playAction=(name,done,duration=PAPER_ACTION_DURATIONS[name])=>{const timing=trickTimings?.[name];duration=timing?.duration??duration;if(!Number.isFinite(duration)||duration<=0)throw Error('Invalid paper action duration');activeAction={name,duration,timing};actionDone=done;stop();enter('action');};
  const finishTrick=name=>{if(name!=='spin'){view='approach';flip=false;seatProgress=1;seatVariant='default';enter('idle');}else{view='front';flip=false;seatProgress=0;enter('settle');}drain();};
  const issue=(skipEntry=false)=>{
+  // The walk-enter drawing finishes at a shared standing endpoint. A direct
+  // interaction queued during it must not start the obsolete walk afterwards.
+  if(skipEntry&&deferred){drain();return;}
   if(movementMode==='walk'&&!skipEntry){playAction('walk-enter',()=>issue(true));return;}
   arrived=false;completed=false;travelAge=0;travelDistance=0;const x=animal.position.x,z=animal.position.z;if(straight&&view==='approach')target[0]=x;
   const dx=target[0]-x,dz=target[1]-z,distance=Math.hypot(dx,dz),run=movementMode==='walk'?planPaperWalk(distance):planPaperRun(distance);phase=Math.ceil(phase);
@@ -182,6 +185,22 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
   }
  }
  return{
+  // Attention interrupts a journey, not its momentum. Continue the current
+  // heading/gait while braking from the actual velocity, then recover to sit.
+  // Rolls/tugs still finish their connected authored recovery via dispatch.
+  attend(){
+   if(state!=='run'||!travel||!target||motionSpeed<1e-8)return dispatch(()=>requestAction('sit',{urgent:true}),{urgent:true});
+   const n=Math.hypot(travel.dx,travel.dz),remaining=Math.max(0,travel.plan.distance-(travelDistance-(travel.distanceBase??0)));
+   const a=movementMode==='walk'?PAPER_DYNAMICS.walkDeceleration:PAPER_DYNAMICS.deceleration;
+   const distance=Math.min(remaining,motionSpeed**2/(2*a));
+   if(!n||distance<1e-10)return dispatch(()=>requestAction('sit',{urgent:true}),{urgent:true});
+   const x=animal.position.x,z=animal.position.z,dx=travel.dx/n*distance,dz=travel.dz/n*distance;
+   const plan=planPaperTravel(distance,{speed:motionSpeed,startSpeed:motionSpeed,deceleration:motionSpeed**2/(2*distance)});
+   travel={...travel,x,z,dx,dz,plan,distanceBase:travelDistance,attending:true};
+   travelAge=0;target=[x+dx,z+dz];waypoints=[];route=false;deferred=null;
+   pendingAction='sit';preparationRate=3;scrambleArmed=false;completed=false;
+   return true;
+  },
   go(x,z){if(![x,z].every(Number.isFinite))throw Error('Invalid paper target');return dispatch(()=>{route=false;go(x,z);});},
   // Eager attention changes preparation/recovery cadence only. Existing dispatch
   // keeps actions/walks at safe endpoints; root physics and gait are unchanged.
@@ -210,7 +229,7 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
    let enteredScramble=false;
    if(state==='run'&&travel&&target){
     travelAge+=dt;const p=travel.plan.at(travelAge),ratio=travel.plan.distance?p.distance/travel.plan.distance:1;
-    travelDistance=p.distance;motionSpeed=p.speed;motionStage=p.stage;
+    travelDistance=(travel.distanceBase??0)+p.distance;motionSpeed=p.speed;motionStage=p.stage;
     const gain=travel.plan.distance?p.speed/travel.plan.distance:0;
     animal.follow({x:travel.x+travel.dx*ratio,y:0,z:travel.z+travel.dz*ratio},{x:travel.dx*gain,y:0,z:travel.dz*gain},{heading:travel.heading});
     arrived=p.done;
@@ -240,7 +259,7 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
    director.update(dt,state==='run',distance);
    if(state==='run'){
     phase+=distance/(travel.carry&&travelDistance<travel.carry.runDistance?PAPER_GAITS.approach.stride:travel.stride);
-    if(target&&arrived){completed=true;stop();target=null;if(movementMode==='walk')playAction('walk-exit',()=>{movementMode='run';enter(walkTransitions?'idle':'settle');drain();});else enter('finish');}
+    if(target&&arrived){completed=true;stop();target=null;if(movementMode==='walk')playAction('walk-exit',()=>{movementMode='run';enter(walkTransitions?'idle':'settle');if(pendingAction)prepareDirection();else drain();});else enter('finish');}
    }else if(state==='action'&&age>=activeAction.duration){
     const done=actionDone;activeAction=null;actionDone=null;done();
    }else if(state==='launch'&&age>=launchSeconds()){
@@ -281,7 +300,7 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
    // This clip is a calibrated standing half-turn, not walk-specific motion.
    // The old turn's intro/outro added an unrelated squat to every reversal.
    if(walkTransitions&&state==='turn'){actionName='walk-turn';actionProgress=Math.min(1,age/turnSeconds());}
-   if(view==='approach'&&approachPlan&&(state==='run'||(state==='finish'&&completed))){const p=approachPlan.at(travelDistance);if(state==='finish'){behavior='brake';behaviorProgress=1;}else if(p.clip!=='run'){behavior=p.clip;behaviorProgress=p.progress;}}
+   if(view==='approach'&&approachPlan&&(state==='run'||(state==='finish'&&completed))){const p=approachPlan.at(travelDistance);if(state==='finish'&&!travel?.attending){behavior='brake';behaviorProgress=1;}else if(p.clip!=='run'){behavior=p.clip;behaviorProgress=p.progress;}}
    if(view==='approach'&&travel?.carry&&(state==='run'||state==='finish')){
     const p=state==='finish'?{clip:'carry-settle',progress:1}:travel.carry.poseAt(travelDistance);
     if(p.clip!=='run'){comfortPose=p;behavior=null;actionName=null;}

package/retrieviewer.d.mts

@@ -89,6 +89,8 @@ export interface Pet {
   /** Seconds. Fixed 60 Hz simulation, at most .1 s catch-up per call. */
   step(dt: number): number;
   frame(options: FrameOptions): PetFrame;
+  /** Conservative pre-render check for held poses. Simulation still needs step(). */
+  needsFrame(options: FrameOptions): boolean;
   /** False when busy or cooling down. */
   interact(kind: 'ball' | 'treat' | 'tug'): boolean;
   /** Sets the next throw's return style. Does not interrupt a fetch in progress. */

package/retrieviewer.mjs

@@ -59,6 +59,20 @@ async function gunzip(bytes){
 // Only immutable art/metadata is shared. Each pet still owns its animal, actor,
 // life, renderer and output. Last dispose drops the shared lease, not other pets.
 const sharedAssets=new Map();
+// Conservative pre-render invalidation: only known held source poses qualify.
+// Moving poses, gestures, sleep cues and visitors always take the normal path.
+// One small key, no second pixel buffer or animation cache. Needs/cooldowns are
+// intentionally absent: they still advance, but do not draw anything themselves.
+function heldFrameKey(state,report,{columns,rows,cellAspect=.5,camera,poseFps=24,contactEnabled=true}={}){
+ const seated=state.state==='idle'&&state.seatProgress===1&&!state.behavior&&!state.actionName&&!state.comfortPose;
+ const down=state.state==='down'&&(state.actionName==='lie-down'&&state.actionProgress===1||state.behavior==='rest');
+ if((!seated&&!down)||report.gesture||report.butterfly||report.snore!==null&&report.snore!==undefined)return null;
+ return JSON.stringify([columns,rows,cellAspect,poseFps,!!contactEnabled,camera?.viewportWidth,camera?.viewportHeight,
+  camera?.rect?.left,camera?.rect?.top,camera?.rect?.width,camera?.rect?.height,
+  state.state,state.x,state.z,state.bodyLift??0,state.view,state.flip,state.seatProgress,state.seatVariant,
+  state.actionName,down?state.actionProgress:0,state.behavior,state.behaviorProgress,
+  report.ball,report.treat]);
+}
 async function loadPetAssets(loadAsset,artProfile){
  // Node keeps filtered crops compressed; only the existing two-frame LRU is
  // expanded. Browser bundles retain the portable bit-packed implementation.
@@ -114,7 +128,7 @@ export async function createPet({loadAsset=defaultLoadAsset,seed,energy,pawTrans
   actor=createPaperActor(animal,info,{manualTricks:true,trickTimings:createSnappyTrickTimings(assets.actions.info),comfortTimings:createPaperComfortTimings(assets.actions.info),walkTransitions:true,scrambleSeconds:assets.comfort.info.scramble?.duration??0,fetchMotions:assets.comfort.info.version>=4?assets.comfort.info:null});
   life=createCompanionLife(actor,{seed,returnStyle,...energy===undefined?{}:{energy}});
  }catch(e){animal?.dispose?.();release();throw e;}
- let paint=null,paintKey='',time=0,acc=0,disposed=false;
+ let paint=null,paintKey='',time=0,acc=0,disposed=false,lastHeldFrameKey=null;
  const alive=()=>{if(disposed)throw Error('Pet is disposed');};
  return {
   // Fixed 1/60 s simulation; host deltas are clamped to 0.1 s so a stalled host
@@ -125,6 +139,9 @@ export async function createPet({loadAsset=defaultLoadAsset,seed,energy,pawTrans
    while(acc>=STEP_SECONDS-1e-9){actor.update(STEP_SECONDS);life.update(STEP_SECONDS);time+=STEP_SECONDS;acc=Math.max(0,acc-STEP_SECONDS);n++;}
    return n;
   },
+  // Optional host optimization. False only when a known held pose and all
+  // visible objects/settings match the last frame; frame() itself never skips.
+  needsFrame(options){alive();const key=heldFrameKey(actor.sample(time,{poseFps:options?.poseFps??24}),life.report,options);return key===null||key!==lastHeldFrameKey;},
   // Plain Braille text sized exactly columns x rows (2x4 dots per cell). `pixels`
   // is the renderer's buffer, valid only until the next frame()/dispose().
   frame({columns,rows,cellAspect=.5,camera,poseFps=24,contactEnabled=true}={}){
@@ -141,6 +158,7 @@ export async function createPet({loadAsset=defaultLoadAsset,seed,energy,pawTrans
    const placement=projection.placement(state.x,state.z,state.bodyLift??0),pixels=paint(state,{...placement,contactEnabled:!!contactEnabled});
    paintCompanionObjects(pixels,width,height,projection,report,state,paint.lastMouth);
    const {text}=rgbaToBraille(pixels,width,height,{method:'stable',brightness:1.18,contrast:1.1});
+   lastHeldFrameKey=heldFrameKey(state,report,{columns,rows,cellAspect,camera,poseFps,contactEnabled});
    return {text,columns,rows,pixels,state,report,placement,projection,artProfile,mouth:paint.lastMouth,contacts:paint.report()};
   },
   // 'ball' | 'treat' | 'tug'. False when busy or cooling down; unknown kinds throw.
@@ -151,7 +169,7 @@ export async function createPet({loadAsset=defaultLoadAsset,seed,energy,pawTrans
   dispose(){
    if(disposed)return;disposed=true;
    try{animal.dispose?.();}finally{
-    animal=actor=life=paint=cache=info=meta=null;paintKey='';
+    animal=actor=life=paint=cache=info=meta=null;paintKey='';lastHeldFrameKey=null;
     for(const k of BUNDLES)assets[k]=null;
     release();
    }