@bitefoundry/retrieviewer 0.0.4 → 0.0.6

package/ASSET-PROVENANCE.md

@@ -35,6 +35,18 @@ must be checked again for the final release bytes.
 
 ## Remaining limits
 
+0.0.6 re-registers only the36 watch samples of the existing behavior archive.
+The existing seated body/paws stay fixed while the authored head turns; no new
+image/photo/video reference is introduced. The offline preparation and source
+digest are in tools/prepare-watch-art.* and pet-q5-manifest.json. Butterfly wings
+are small geometric marks, using the same existing output buffer; dog poses
+reuse licensed gallop art. Existing attribution and CC BY-SA4.0 terms remain.
+
+0.0.5 extends that ninth licensed archive with four sleeping studies generated
+from the same existing puppy identity/pose references, approved by the owner in
+this conversation. COMFORT-ART.md and the comfort metadata record preparation,
+source hashes and size changes. No new downloaded photo/video input is introduced.
+
 Later source candidate: belly/sleep reuse existing licensed roll/rest frames.
 Tug adds eight built-in imagegen keys referenced only from the existing generated
 puppy sheet, not new photographs. COMFORT-ART.md records the prompt, source hash

package/BUTTERFLY.md

@@ -0,0 +1,30 @@
+# Rare butterfly encounter (0.0.6)
+
+No additional dog artwork, sprite archive, dependency, background process or
+timer. Existing short grounded gallops supply the bounding legs and ear motion;
+the visitor is drawn directly into the existing grayscale buffer before Braille
+conversion. Camera, stride-distance integration, contact correction and palette
+are unchanged. This is not a new up-looking/pouncing source illustration.
+
+The initial opportunity is scheduled after240–480 active simulation seconds.
+Only an awake, energetic puppy near the viewer may participate; sleep pressure
+takes priority. Subsequent opportunities are at least720 seconds apart, with
+up to480 additional random seconds. Hidden/paused time does not accumulate.
+An opportunity can be delayed by sleep or another coherent episode, rather than
+forcing a timer callback that wakes or interrupts the puppy.
+
+The puppy notices, makes three short alternating chases, watches the visitor fly
+away, returns and rests. Each target keeps the butterfly ahead of the muzzle.
+The visitor has an18-second visibility guard. Accepted ball/treat/tug clears the
+encounter and its obsolete route immediately, using normal actor recovery.
+A separate random stream leaves the existing ordinary episode/gait choices
+unchanged before the encounter.
+
+Checks: `node --test puppy-butterfly.test.mjs`, `npm test`.
+Generate a lightweight real-engine replay: `node tools/check-butterfly.mjs`.
+Its local `site-dist/butterfly-preview.html` loads prerecorded cropped Braille
+frames, not another full pet asset set. The replay is a QA artifact, not an npm
+asset or an alternate implementation. Serve only `site-dist` on a local address.
+
+Version0.0.6 includes this behavior. Existing0.0.5 registry artifacts remain
+unchanged. An already-running companion must be restarted after updating.

package/COMFORT-ART.md

@@ -1,5 +1,35 @@
 # Comfort extension art record
 
+## 0.0.5 sleeping studies
+
+Four owner-approved built-in imagegen originals (side, belly, curl, chin), using
+the existing `puppy-behaviors16-sheet.png` identity and `puppy-roll16-v4-sheet.png`
+pose references, extend the same CC BY-SA4.0 comfort archive. No new external
+photo or video input. Source PNGs remain local; metadata records SHA-256 hashes.
+Preparation: `node tools/prepare-sleep-art.mjs` with the preserved local studies.
+It keeps the nine existing tug keys pixel-identical and registers four new static
+keys to ground y=300. There are no duplicated right-facing images: source sampling
+reverses x. The pose is selected once per nap, not switched during a sleeping hold.
+A short rest-to-sleep/rest recovery blend uses existing scratch; the sleeping body
+itself is held, without scale pulsing. The z cue is silent.
+
+The archive grows from103549 to129148 bytes (+25599). Packed resident pixels grow
+from291337 to341139 (+49802 bytes). The renderer's mutually exclusive authored
+samplers now share one action-sized RGBA scratch, with320px subviews for smaller
+poses, replacing their separate buffers (2457600 bytes less before tug playback).
+Sleep display is capped at5fps in the desktop pump, while simulation advances
+normally and accepted interactions invalidate the next paint immediately.
+Ink presets only change the native painter color; no RGB sprite families or
+background capture are introduced. Actual RSS depends on host and allocator.
+
+The four prompts share: one complete naturally proportioned pale fluffy retriever,
+same bandana, closed eyes, grayscale fine fur on pure black, fixed slightly elevated
+camera, no text/bed/toy/background. Pose clauses: relaxed side sleep; belly-up with
+loosely bent paws and tiny tongue; loose curl with tail near muzzle; chin resting
+on forepaws. Source prompts and PNGs are preserved locally with the approved studies.
+
+The following section records the earlier0.0.4 preparation, not the new sleep keys.
+
 Source code MIT; generated puppy art and frame data CC BY-SA4.0, retaining the
 credits in ATTRIBUTION.md. This is a development-source record, not new legal
 clearance. No external photograph, YouTube frame or downloaded rig was introduced.

package/INSTALLING.md

@@ -6,6 +6,10 @@ Desktop setup (Node20+; [OS requirements and verification](DESKTOP-PLATFORMS.md)
 2. `retrieviewer desktop` — select the app window in the picker.
 
 No agent configuration is needed for this separate transparent companion.
+Choose the dot ink at launch: `retrieviewer desktop --ink gold`, or
+`retrieviewer desktop --ink dark` on light backgrounds. Default: `cream`.
+Exit an existing companion before changing ink. Presets reuse the same Braille
+mask and native painter, without new color sprites or screen capture.
 Windows and AlmaLinux8/GLIBC2.28 X11 have live test evidence. macOS support is
 experimental and not runtime verified; native Wayland is unsupported. Linux needs
 system Python3.6+, X11/Xrender/Xext and a compositor; Windows needs the .NET

package/PUPPY-MEMORY.md

@@ -1,5 +1,37 @@
 # Runtime weight and performance
 
+## Node compressed crops (0.0.6)
+
+Node now stores each validated Q5 crop as a small DEFLATE block, using built-in
+`node:zlib`; only the existing two-frame LRU is expanded. The original archive
+buffer is released. Browser hosts keep the portable bit-packed implementation.
+No added runtime dependency, process, timer, lower resolution or lost pose.
+
+Same Windows host, fresh processes, same450-frame ball sequence:
+
+| Metric | 0.0.5 | 0.0.6 |
+| --- | ---: | ---: |
+| Loaded ArrayBuffers, after native close callbacks + diagnostic GC | 59.7 MiB | 21.4 MiB |
+| Rendered ArrayBuffers | 67.3 MiB | 29.0 MiB |
+| Mean frame time | 3.39 ms | 3.39 ms |
+| P95 frame time | 6.11 ms | 6.27 ms |
+| Initial load | 653 ms | 910 ms |
+| Actual Windows overlay worker RSS, short owned-window checks | 130 MiB | 96–106 MiB |
+
+The450-frame output hash is unchanged. `puppy-node-cache.test.mjs` compares every
+packaged source frame in both stores, including the separately repaired watch
+art. These samples are not a RAM ceiling: V8, allocator retention, viewport and
+activity change RSS. The helper is separate. The large off-screen benchmark
+peaked at267/238 MiB; do not substitute the short96–106 MiB samples for that peak.
+Evidence: tools/benchmark-pet.mjs, local dist/006-paired-{before,after}.json and
+dist/006-native-{before,source}.log. Diagnostic GC is never enabled in the pet.
+Shrinking V8's young generation was tested but increased rendering cost, so no
+global or embedded-host V8 flags are imposed.
+
+Watch repair adds no frame count; its archive is15,422 bytes smaller. Butterfly
+chasing adds no dog images or persistent image buffer; see BUTTERFLY.md. Existing
+sleep, colors, wake-on-interaction and5fps sleeping repaint remain unchanged.
+
 ## Comfort behaviors (0.0.4)
 
 Belly-up flopping and eyes-closed sleeping reuse the existing action/rest art.

package/README.ko.md

@@ -4,7 +4,9 @@
 <p align="center"><a href="https://bitefoundry.github.io/retrieviewer/?lang=ko">직접 만나 보기</a> · <a href="README.md">English</a> · <a href="https://www.npmjs.com/package/@bitefoundry/retrieviewer">npm</a> · <a href="https://github.com/BiteFoundry/retrieviewer/issues">피드백</a></p>
 
 앱 창 위에서 혼자 걷고, 뛰고, 앉아서 쉬는 보송한 점자 도트 리트리버예요.
-발라당 누워 쉬거나 눈을 감고 잠들기도 해요. 가끔 공·간식·터그로 놀아주세요.
+옆잠, 발라당, 몸 말기, 앞발에 턱 괴기. 조용하면 양쪽으로 누워 잠들어요.
+가끔 공·간식·터그로 놀아주세요.
+가끔 찾아오는 나비를 쫓기도 해요.
 나머지 시간에는 각자의 일을 하면 돼요.
 [BiteFoundry](https://github.com/BiteFoundry)가 만듭니다.
 런타임에는 계정, 모델 API, 텔레메트리가 필요하지 않아요.
@@ -31,6 +33,11 @@ Node.js/npm이 없다면 [먼저 설치](PREREQUISITES.md)해 주세요.
 통과시킵니다. 앱 창 단위로 동작하고, 대상 창이 비활성화·최소화되면 숨습니다.
 자동 시작이나 셸 래퍼는 등록하지 않아요.
 
+도트 색은 실행할 때 고를 수 있어요. 기본은 크림색이고, 골드색은
+`retrieviewer desktop --ink gold`, 밝은 배경에는
+`retrieviewer desktop --ink dark`를 쓰세요. 실행 중이라면 먼저 종료하고 다시
+실행하세요. 배경을 캡처하지 않고, 같은 도트에 색만 바꿉니다.
+
 > **Cursor / VS Code Remote SSH 사용자:** 원격 서버의 터미널이 아닌,
 > Cursor 화면이 떠 있는 **로컬 PC의 PowerShell/터미널**에 설치하세요.
 > 서버의 `DISPLAY=:1`은 서버 쪽 X11 화면을 뜻합니다. VNC로 그 화면을 보고

package/README.md

@@ -12,7 +12,8 @@
 </p>
 
 A fluffy, autonomous Braille-art retriever that hangs out above an app window.
-It wanders, runs, flops belly-up and naps. Toss a ball, offer a treat or play tug.
+It wanders, runs, flops belly-up and naps. Occasionally it chases a butterfly.
+Toss a ball, offer a treat or play tug.
 Get back to your thing.
 
 Made by [BiteFoundry](https://github.com/BiteFoundry). No model API, account or
@@ -40,6 +41,10 @@ click-through native overlay—not a patched app, shell wrapper or injected MCP
 widget. It follows a whole app window, not a tab, and hides when that window is
 inactive or minimized. No automatic startup entry is installed.
 
+Choose the dot color at launch: `retrieviewer desktop --ink gold`, or
+`retrieviewer desktop --ink dark` for light backgrounds. Default: `cream`.
+Quit a running companion first. Colors reuse the same artwork; no screen capture.
+
 > **Cursor / VS Code Remote SSH:** run those commands in your **local** computer's
 > terminal, not the remote server's terminal. The puppy belongs where the window
 > is displayed. A server's `DISPLAY=:1` refers to that server's X11 display, which

package/RELEASING.md

@@ -1,4 +1,13 @@
-# Retrieviewer 0.0.4 release process
+# Retrieviewer 0.0.6 release process
+
+Current target: `@bitefoundry/retrieviewer@0.0.6`, public `latest`. The owner
+explicitly requested Node memory optimization, repaired watch motion, completed
+butterfly encounters and npm publication on2026-10-23. Built-in Node zlib keeps
+each Q5 crop compressed; portable browser storage stays unchanged. Watch art
+reuses existing drawings with canonical seated paws/body. Butterfly encounters
+reuse gallop poses with no extra dog archive. MIT/CC BY-SA4.0 unchanged.
+Preserve0.0.5 and all earlier registry bytes; publish only the exact tested0.0.6
+tarball. The historical scope below is not current verification evidence.
 
 Target: `@bitefoundry/retrieviewer@0.0.4`, public npm registry, `latest` tag.
 The npm organization `bitefoundry` uses the free public-packages plan; account

package/integrations/linux-overlay/overlay.py

@@ -180,6 +180,12 @@ class Companion(object):
         if kind == 'quit':
             self.quit()
         elif kind == 'loaded':
+            palette = {'cream': (248, 242, 232), 'gold': (231, 184, 103), 'dark': (67, 48, 24)}
+            ink = message.get('ink', 'cream')
+            if ink not in palette:
+                raise OverlayError('Invalid ink')
+            self.tiles.ink = palette[ink]
+            self.tiles.cache.clear()
             self.loaded = True
             self.set_status('playing')
             if self.test_mode:

package/integrations/macos-overlay/overlay.jxa

@@ -238,7 +238,7 @@ function createCore(io, options) {
     if (s.quitting) return;
     if (!m || typeof m !== 'object') throw new Error('Invalid overlay message');
     if (m.type === 'quit') { quit(); return; }
-    if (m.type === 'loaded') { s.loaded = true; io.status(TEXT.playing); io.loaded(); return; }
+    if (m.type === 'loaded') { var palette = {cream:[248,242,232,245],gold:[231,184,103,245],dark:[67,48,24,245]}; var ink = m.ink || 'cream'; if (!Object.prototype.hasOwnProperty.call(palette,ink)) throw new Error('Invalid ink'); INK=palette[ink]; s.loaded = true; io.status(TEXT.playing); io.loaded(); return; }
     if (m.type === 'interaction') { io.status(m.accepted === true ? TEXT.accepted : TEXT.busy); return; }
     if (m.type === 'error') { io.status(TEXT.engineError); quit(); return; }
     if (m.type === 'frame') {

package/integrations/windows-overlay/Overlay.cs

@@ -61,6 +61,7 @@ class QuietWindow : Form {
 sealed class PetWindow : QuietWindow {
     protected override CreateParams CreateParams {get{CreateParams p=base.CreateParams;p.ExStyle|=0x80000|0x20;return p;}} // LAYERED + TRANSPARENT
     internal int PaintedDots;
+    internal Color Ink=Color.FromArgb(245,248,242,232);
     internal Bitmap PaintFrame(Dictionary<string,object> m,int cell,Rectangle canvas){
         int cols=Program.Int(m,"columns"),rows=Program.Int(m,"rows"),cx=Program.Int(m,"x"),cy=Program.Int(m,"y");
         string text=Program.Str(m,"text");
@@ -69,7 +70,7 @@ sealed class PetWindow : QuietWindow {
         string[] lines=text.Split('\n');if(lines.Length!=rows)throw new Exception("Invalid overlay row count");
         Bitmap image=new Bitmap(cols*cell,rows*cell*2,PixelFormat.Format32bppPArgb);
         try{
-            using(Graphics g=Graphics.FromImage(image))using(Brush ink=new SolidBrush(Color.FromArgb(245,248,242,232))){
+            using(Graphics g=Graphics.FromImage(image))using(Brush ink=new SolidBrush(Ink)){
                 g.Clear(Color.Transparent);g.SmoothingMode=System.Drawing.Drawing2D.SmoothingMode.AntiAlias;
                 int[] dx={0,0,0,1,1,1,0,1},dy={0,1,2,0,1,2,3,3};float step=cell/2f,diameter=Math.Max(1.1f,step*.48f);PaintedDots=0;
                 for(int y=0;y<rows;y++){
@@ -149,7 +150,7 @@ sealed class Companion : ApplicationContext {
             for(;;){Dictionary<string,object> m;lock(inputLock){if(messages.Count==0)break;m=messages.Dequeue();}
                 string type=Program.Str(m,"type");
                 if(type=="quit"){Quit();return;}
-                if(type=="loaded"){loaded=true;status.Text="함께 노는 중";if(testMode)((Button)bar.Controls[0]).PerformClick();continue;}
+                if(type=="loaded"){string ink=m.ContainsKey("ink")?Program.Str(m,"ink"):"cream";if(ink!="cream"&&ink!="gold"&&ink!="dark")throw new Exception("Invalid ink");pet.Ink=ink=="gold"?Color.FromArgb(245,231,184,103):ink=="dark"?Color.FromArgb(245,67,48,24):Color.FromArgb(245,248,242,232);loaded=true;status.Text="함께 노는 중";if(testMode)((Button)bar.Controls[0]).PerformClick();continue;}
                 if(type=="interaction"){status.Text=Program.Bool(m,"accepted")?"좋아!":"잠깐 기다려";continue;}
                 if(type=="error"){status.Text="엔진 오류";Quit();return;}
                 if(type=="frame"){

package/integrations/windows-overlay/desktop.mjs

@@ -93,13 +93,14 @@ export async function desktopHelper(options={}){
  throw Error('Linux desktop needs system Python3.6+ (AlmaLinux8 platform-python is supported). No packages or system settings were installed.');
 }
 export async function startDesktop(options={}){
+ const ink=options.ink??'cream';if(!['cream','gold','dark'].includes(ink))throw Error('Invalid desktop ink');
  // Fail before creating any cache/session on unsupported desktops (e.g. Wayland).
  desktopPlatform(options);
  const status=await desktopStatus(options);if(status.running)return {...status,alreadyRunning:true};
  if(status.stale)await stopDesktop(options);
  const helper=await desktopHelper(options);
  return new Promise((resolve,reject)=>{
-  const child=spawn(process.execPath,[fileURLToPath(new URL('./worker.mjs',import.meta.url)),'--helper-spec',JSON.stringify(helper)],{detached:true,windowsHide:true,stdio:['ignore','ignore','ignore','ipc'],env:{...process.env,RETRIEVIEWER_HOME:getConfigPaths(options).root}});
+  const child=spawn(process.execPath,[fileURLToPath(new URL('./worker.mjs',import.meta.url)),'--helper-spec',JSON.stringify(helper)],{detached:true,windowsHide:true,stdio:['ignore','ignore','ignore','ipc'],env:{...process.env,RETRIEVIEWER_HOME:getConfigPaths(options).root,RETRIEVIEWER_INK:ink}});
   let settled=false;const finish=(error,message)=>{if(settled)return;settled=true;clearTimeout(timer);if(child.connected)child.disconnect();child.unref();error?reject(error):resolve(message);};
   const timer=setTimeout(()=>{if(child.connected)child.send({command:'abort'});finish(Error('Desktop startup timed out; no agent settings changed'));},20000);
   child.on('error',error=>finish(error));child.on('message',message=>message.error?finish(Error(message.error)):finish(null,message));child.on('exit',code=>finish(Error('Desktop exited during startup ('+code+')')));

package/integrations/windows-overlay/protocol.mjs

@@ -20,23 +20,25 @@ export function cropFrame(frame,revision){
 
 // Request/ack rendering: never queue obsolete frames behind a slow native painter.
 export function createFramePump({pet,send,now=()=>performance.now()}){
- let viewport=null,inFlight=false,last=null,lastFrame=null,revision=0,paused=false,disposed=false;
+ let viewport=null,inFlight=false,last=null,lastFrame=null,revision=0,paused=false,disposed=false,nextPaint=0;
  const alive=()=>{if(disposed)throw Error('Overlay pump is disposed');};
  return {
-  viewport(message){alive();const next=viewportOf(message);revision=message.revision;viewport=next;last=null;lastFrame=null;},
-  pause(value){alive();paused=!!value;last=null;lastFrame=null;},
+  viewport(message){alive();const next=viewportOf(message);revision=message.revision;viewport=next;last=null;lastFrame=null;nextPaint=0;},
+  pause(value){alive();paused=!!value;last=null;lastFrame=null;nextPaint=0;},
   ack(){alive();inFlight=false;},
   tick(){
    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);const frame=cropFrame(pet.frame(viewport),revision);
+   pet.step(dt);if(t<nextPaint)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;
   },
-  interact(kind){alive();if(!['ball','treat','tug'].includes(kind))throw Error('Invalid overlay interaction');const accepted=pet.interact(kind);if(accepted)lastFrame=null;return accepted;},
+  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;},
   dispose(){if(!disposed){disposed=true;viewport=lastFrame=null;pet.dispose();}},
  };

package/integrations/windows-overlay/worker.mjs

@@ -61,6 +61,6 @@ try{
  const {createPet}=await import('../../retrieviewer.mjs');const pet=await createPet();
  if(stopping)pet.dispose();else{
   pump=createFramePump({pet,send:write});if(pendingViewport)pump.viewport(pendingViewport);
-  write({type:'loaded'});timer=setInterval(()=>{try{pump.tick();}catch(error){write({type:'error',message:error.message});stop();}},1000/spec.fps);
+  write({type:'loaded',ink:process.env.RETRIEVIEWER_INK??'cream'});timer=setInterval(()=>{try{pump.tick();}catch(error){write({type:'error',message:error.message});stop();}},1000/spec.fps);
  }
 }catch(error){sendParent({error:error.message});await stop();}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitefoundry/retrieviewer",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "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/",
@@ -89,6 +89,7 @@
     "PUPPY-MEMORY.md",
     "PUPPY-Q5-COMPARISON.md",
     "COMFORT-ART.md",
+    "BUTTERFLY.md",
     "examples/embed.mjs",
     "examples/live.mjs",
     "examples/plugin.mjs",

package/pet-q5-manifest.json

@@ -80,11 +80,20 @@
    "uniqueFrames": 142,
    "sourceSha256": "7918261fb64c57a91739729841fd84c6dd53891196c7fb76ee9c27712ab6ef5d",
    "sourcePackedSha256": "7785ef65b8a2a5bf6f7ce600fe9957a60d9af82066ff49275bba061eac5392d1",
-   "encodedBytes": 7031343,
-   "gzipBytes": 1450156,
-   "residentPixelBytes": 4373034,
-   "encodedSha256": "38cfdfcee9c857c56a14f0a9734cb3301b4a04cb8e1ae3fb2e2b2ffe3666240f",
-   "quantizedSha256": "3c8f40416d2fff1c1031d3ad8917ea885998a786126d5973dfee4102893a0a53"
+   "encodedBytes": 6185813,
+   "gzipBytes": 1434734,
+   "residentPixelBytes": 3845581,
+   "encodedSha256": "8e4811c4c72337d094770596b2b73e2f468f92884e6de2e14880ce9b9ad6f351",
+   "quantizedSha256": "500dcc9b5edbadf97159fc9256e9d942578e13e36f14c6fecda649a97214318b",
+   "watchRegistration": {
+    "sourceVersion": "0.0.5",
+    "sourceEncodedSha256": "38cfdfcee9c857c56a14f0a9734cb3301b4a04cb8e1ae3fb2e2b2ffe3666240f",
+    "canonicalSeat": 50,
+    "bodyFromY": 210,
+    "neckBlendFromY": 180,
+    "headTranslateY": 8,
+    "unchangedOtherFrames": true
+   }
   },
   "puppy-paper-actions-v9": {
    "file": "puppy-paper-actions-v9-q5.bin.gz",

package/puppy-comfort-sprites.mjs

@@ -12,14 +12,22 @@ export function comfortFrameIndex(progress,info){
  return loop[Math.floor((seconds-.65)/.28)%loop.length];
 }
 
-export function createComfortSpriteSampler(bytes,info){
- if(!isGrayFrameSource(bytes)||info?.version!==1||info.width!==320||info.height!==320||info.frames!==9)throw Error('Invalid comfort sprites');
- const frames=grayFrameReader(bytes,320,320,info.frames);let rgba=null;
+export function createComfortSpriteSampler(bytes,info,output){
+ if(!isGrayFrameSource(bytes)||![1,2].includes(info?.version)||info.width!==320||info.height!==320||info.frames!==(info.version===2?13:9))throw Error('Invalid comfort sprites');
+ if(output!==undefined&&(!(output instanceof Uint8ClampedArray)||output.length!==320*320*4))throw Error('Invalid comfort output');
+ const frames=grayFrameReader(bytes,320,320,info.frames);let rgba=output??null;
+ if(rgba)for(let i=3;i<rgba.length;i+=4)rgba[i]=255;
  return pose=>{
-  if(pose?.clip!=='tug')throw Error('Invalid comfort clip');
+  if(!['tug','sleep'].includes(pose?.clip))throw Error('Invalid comfort clip');
   if(!rgba){rgba=new Uint8ClampedArray(320*320*4);for(let i=3;i<rgba.length;i+=4)rgba[i]=255;}
-  const index=comfortFrameIndex(pose.progress,info),frame=frames.getFrame(index);
-  for(let i=0,j=0;i<frame.length;i++,j+=4)rgba[j]=rgba[j+1]=rgba[j+2]=frame[i];
+  const index=pose.clip==='sleep'?info.sleep?.[pose.variant]:comfortFrameIndex(pose.progress,info);
+  if(!Number.isInteger(index))throw Error('Invalid sleep variant');
+  const frame=frames.getFrame(index),base=pose.base,blend=pose.blend??1;
+  if(!Number.isFinite(blend)||blend<0||blend>1)throw Error('Invalid sleep blend');
+  for(let i=0,j=0;i<frame.length;i++,j+=4){
+   const v=frame[pose.right?Math.floor(i/320)*320+319-i%320:i];
+   rgba[j]=rgba[j+1]=rgba[j+2]=base&&blend<1?Math.round(base[j]+(v-base[j])*blend):v;
+  }
   return rgba;
  };
 }

package/puppy-companion-comfort.json

@@ -1,16 +1,17 @@
 {
-  "version": 1,
+  "version": 2,
   "width": 320,
   "height": 320,
-  "frames": 9,
+  "frames": 13,
   "clips": [
-    "tug"
+    "tug",
+    "sleep"
   ],
-  "gzipBytes": 103549,
-  "residentPixelBytes": 291337,
+  "gzipBytes": 129148,
+  "residentPixelBytes": 341139,
   "sourceSheetSha256": "10fde9dacca5cb45acd68f387e7ed3bcf88cd72cf0f9c4220d31d819db91731e",
   "neutralSha256": "19f89a8bcb5a937e528593a8f36db846a0d45a5ee398f1b0873c056e5be2fa0a",
-  "encodedSha256": "e046e214da585ffda65e8d2c1a86c589af589325b792634f128ab8b71f6dbf3a",
+  "encodedSha256": "35327cc103b1f7ac2ff1b09ed98658fd8ff1dcef322de9c9b18071a4358b7b87",
   "method": "Built-in imagegen authored tug keys. One fixed scale, ground/center translation only. Exact existing Q5 seat first/last. No expanded tween film or live body deformation.",
   "registration": {
     "sheetSize": [
@@ -73,5 +74,67 @@
         "dy": 74
       }
     ]
+  },
+  "sleep": {
+    "side": 9,
+    "belly": 10,
+    "curl": 11,
+    "chin": 12
+  },
+  "sleepRegistration": [
+    {
+      "key": "side",
+      "sourceBounds": [
+        26,
+        461,
+        1234,
+        873
+      ],
+      "width": 254,
+      "scale": 0.21026490066225165,
+      "ground": 300
+    },
+    {
+      "key": "belly",
+      "sourceBounds": [
+        28,
+        413,
+        1239,
+        881
+      ],
+      "width": 224,
+      "scale": 0.18497109826589594,
+      "ground": 300
+    },
+    {
+      "key": "curl",
+      "sourceBounds": [
+        44,
+        373,
+        1213,
+        992
+      ],
+      "width": 216,
+      "scale": 0.1847733105218135,
+      "ground": 300
+    },
+    {
+      "key": "chin",
+      "sourceBounds": [
+        116,
+        435,
+        1218,
+        953
+      ],
+      "width": 198,
+      "scale": 0.17967332123411978,
+      "ground": 300
+    }
+  ],
+  "sleepSourceHashes": {
+    "side": "85c567eb0958a213ee5b93d0a8592639489f5f29dded35e0d1d22e920ed1fe9f",
+    "belly": "e1967d9156a119d04e25fd6428fe5dcdbd2156c5e4eba0347217847874006109",
+    "curl": "10c9a85701af3587c48c1d8158972a07026e79a18a2375d86108538eda05aae7",
+    "chin": "e971eaa6861b597f0dba3a487403cee5f120cba0a9f9584d831b5634d096dee7"
   }
 }

package/puppy-companion-life.mjs

@@ -13,12 +13,15 @@ const OFFER={x:0,z:.3};
 const TREAT_OFFSET={z:.08,height:.25};
 const COOLDOWN={ball:6,treat:15,tug:20};
 const FLIGHT=.65,BALL_PEAK=.75,CARRY_HEIGHT=.19,SETTLE_FALLBACK=.6,MAX_DT=.25,ARRIVE=.05;
+// Active simulation seconds, never a wall-clock timer that wakes a hidden pet.
+export const BUTTERFLY_RULES=Object.freeze({firstMin:240,firstSpread:240,cooldownMin:720,cooldownSpread:480,maxVisible:18});
 const LABEL={
  start:'기다리는 중',pause:'잠시 느긋하게 둘러보는 중',lie:'엎드리는 중',rest:'엎드려 쉬는 중',recover:'앉아서 기운 차리는 중',
  sit:'앉는 중',watch:'앉아서 지켜보는 중',look:'고개를 돌려 살피는 중',observe:'가만히 주변 관찰 중',
  stroll:'옆으로 살짝 걸어가는 중',sniff:'잠깐 멈춰 주변을 살피는 중',dash:'저 멀리 달려가는 중',far:'멀리서 둘러보는 중',home:'제자리로 돌아오는 중',
  patrol:'주변을 왕복 산책하는 중',scan:'양쪽을 번갈아 살피는 중',roll:'느긋하게 뒹구는 중',play:'신나서 한 바퀴 도는 중',checkin:'가까이 와서 함께 쉬는 중',
  belly:'배를 보이고 발라당 쉬는 중',sleep:'새근새근 잠자는 중',tug:'장난감을 물고 당기는 중',
+ butterflyNotice:'나비를 발견하고 귀를 쫑긋하는 중',butterfly:'나비를 폴짝폴짝 쫓는 중',butterflyBye:'날아가는 나비를 바라보는 중',
  fetch:'공을 쫓아가는 중',pickup:'공을 무는 중',carry:'공을 물고 돌아오는 중',drop:'공을 내려놓는 중',offer:'공을 내려놓고 기다리는 중',
  treatSit:'간식 앞에 앉는 중',chew:'간식 먹는 중'
 };
@@ -39,10 +42,13 @@ export function createCompanionLife(actor,{seed=731,energy=.8}={}){
  if(!Number.isFinite(energy)||energy<0||energy>1)throw RangeError('energy must be within 0..1');
 
  const rand=mulberry32(seed),range=(a,b)=>a+(b-a)*rand(),side=()=>rand()<.5?'left':'right';
- const needs={energy,social:.5,curiosity:.5};
+ // Separate stream: the rare encounter does not perturb ordinary episodes/gaits.
+ const encounterRand=mulberry32(seed^0x4bf17a93),encounterRange=(a,b)=>a+(b-a)*encounterRand();
+ let nextButterfly=BUTTERFLY_RULES.firstMin+encounterRange(0,BUTTERFLY_RULES.firstSpread),butterfly=null;
+ const needs={energy,social:.5,curiosity:.5,drowsiness:0};
  const cooldowns={ball:0,treat:0,tug:0};
  const episodeCooldowns={roll:0,play:0,belly:0,sleep:0};
- let clock=0,decisions=0,lastEpisode=null;
+ let clock=0,decisions=0,lastEpisode=null,quiet=0;
  let queue=[],hold=0,holdIntent=null,waiting=null,gesture=null;
  let intent='start',label=LABEL.start,pending=null,active=null,ball=null,treat=null;
 
@@ -58,6 +64,32 @@ export function createCompanionLife(actor,{seed=731,energy=.8}={}){
  const sit=step=>cmd('sit',[],step,()=>!seatedAnyVariant());
  const lie=()=>cmd('lie',[],'lie',()=>actor.state!=='down');
  const walkTo=x=>cmd('walk',()=>{const dx=x-actor.sample(clock).x;return [dx<0?'left':'right',Math.abs(dx)];},'patrol',()=>Math.abs(x-actor.sample(clock).x)>.002);
+ const butterflyPoint=()=>{
+  if(!butterfly)return null;
+  const elapsed=clock-butterfly.since,p=clamp(elapsed/.65,0,1),ease=p*p*(3-2*p);
+  const leaving=butterfly.leaving?clamp((clock-butterfly.leaving)/1.1,0,1):0;
+  return {x:butterfly.from.x+(butterfly.to.x-butterfly.from.x)*ease+.025*Math.sin(elapsed*5)+leaving*.2*butterfly.side,
+   z:butterfly.from.z+(butterfly.to.z-butterfly.from.z)*ease,
+   height:.45+.045*Math.sin((clock-butterfly.start)*6)+leaving*.35,
+   phase:((clock-butterfly.start)*5)%1,opacity:1-leaving};
+ };
+ const butterflyEpisode=()=>{
+  const s=actor.sample(clock),direction=encounterRand()<.5?-1:1;
+  const targets=[clamp(s.x+direction*.36,-.5,.5),clamp(s.x-direction*.38,-.5,.5),clamp(s.x+direction*.24,-.5,.5)];
+  const z=s.z;
+  const moveFly=x=>fx(()=>{
+   const from=butterflyPoint()??{x:s.x-direction*.28,z};
+   const heading=x<actor.sample(clock).x?-1:1;
+   // The dog root is its body center, NOT its nose. Keep the visitor ahead of
+   // the muzzle on each leg, rather than hovering behind the running face.
+   butterfly={start:butterfly?.start??clock,since:clock,from:{x:from.x,z:from.z},to:{x:x+heading*.23,z},side:heading,leaving:0};
+  });
+  // Look names are dog-relative: its left is the viewer's right.
+  return [sit('butterflyNotice'),moveFly(targets[0]),cmd('look',[direction<0?'right':'left'],'butterflyNotice'),wait(.8,'butterflyNotice'),
+   ...targets.flatMap((x,i)=>[...(i?[moveFly(x)]:[]),cmd(typeof actor.chase==='function'?'chase':'go',[x,z],'butterfly'),wait(.3,'butterfly')]),
+   fx(()=>{if(butterfly)butterfly.leaving=clock;}),wait(1.1,'butterflyBye'),fx(()=>{butterfly=null;needs.energy-=.12;needs.curiosity-=.25;}),
+   home(),sit('recover'),wait(range(3,6),'recover')];
+ };
 
  // Each episode is a short coherent plan; a pause always leads in so autonomy never stalls.
  const EPISODES={
@@ -72,7 +104,8 @@ export function createCompanionLife(actor,{seed=731,energy=.8}={}){
   checkin:()=>[home(),sit('sit'),cmd('look',[side()],'look'),wait(range(5,10),'checkin'),fx(()=>{needs.social-=.4;})],
   play:()=>[cmd('spin',[],'play'),wait(range(1,2),'pause'),sit('sit'),wait(range(2,4),'watch'),fx(()=>{needs.energy-=.12;needs.curiosity-=.2;})],
   belly:()=>[cmd('belly',[range(5,9)],'belly'),wait(range(2,4),'watch'),fx(()=>{needs.energy+=.08;needs.curiosity-=.15;})],
-  sleep:()=>[cmd('sleep',[range(22,38)],'sleep'),wait(range(2,4),'recover'),fx(()=>{needs.energy+=.3;})],
+  sleep:()=>[cmd('sleep',[range(65,110),['side','curl','chin','belly'][Math.floor(rand()*4)],rand()<.5],'sleep'),wait(range(2,4),'recover'),fx(()=>{needs.energy+=.3;})],
+  butterfly:butterflyEpisode,
  };
  const weights=()=>{
   const {energy:e,social:s,curiosity:c}=needs;
@@ -87,6 +120,13 @@ export function createCompanionLife(actor,{seed=731,energy=.8}={}){
   const w=weights();if(lastEpisode)w[lastEpisode]=0;
   const kinds=Object.keys(w),total=kinds.reduce((sum,k)=>sum+w[k],0);
   let pick=rand()*total,kind=kinds.find(k=>(pick-=w[k])<0)??'observe';
+  // Quiet-time sleep pressure is independent of energy restored by sitting.
+  // Wait for the current coherent episode to end; never yank a running puppy.
+  if(quiet>=120&&needs.drowsiness>=.35&&episodeCooldowns.sleep===0&&lastEpisode!=='sleep'&&typeof actor.sleep==='function')kind='sleep';
+  const position=actor.sample(clock);
+  if(kind!=='sleep'&&clock>=nextButterfly&&quiet>=15&&needs.energy>.6&&needs.drowsiness<.35&&position.z> -1.2){
+   kind='butterfly';nextButterfly=clock+BUTTERFLY_RULES.cooldownMin+encounterRange(0,BUTTERFLY_RULES.cooldownSpread);
+  }
   lastEpisode=kind;decisions++;
   if(kind==='roll')episodeCooldowns.roll=90;
   if(kind==='play')episodeCooldowns.play=120;
@@ -123,6 +163,9 @@ export function createCompanionLife(actor,{seed=731,energy=.8}={}){
  function drift(dt){
   const resting=holdIntent==='rest'||holdIntent==='recover'||actor.state==='sleep'||intent==='belly';
   needs.energy+=resting?.04*dt:-.004*dt;
+  const asleep=actor.state==='sleep';
+  needs.drowsiness+=asleep?-dt/60:dt/240;
+  quiet=active||pending||asleep?0:quiet+dt;
   if(!active){needs.curiosity+=.01*dt;needs.social+=.008*dt;}
   for(const k in needs)needs[k]=clamp(needs[k],0,1);
  }
@@ -133,6 +176,10 @@ export function createCompanionLife(actor,{seed=731,energy=.8}={}){
   for(const k in cooldowns)cooldowns[k]=Math.max(0,cooldowns[k]-dt);
   for(const k in episodeCooldowns)episodeCooldowns[k]=Math.max(0,episodeCooldowns[k]-dt);
   drift(dt);
+  // A stalled or externally substituted actor must not leave a permanent insect.
+  if(butterfly&&clock-butterfly.start>BUTTERFLY_RULES.maxVisible){
+   butterfly=null;queue=[sit('recover'),wait(3,'recover')];hold=0;holdIntent=null;gesture=null;waiting=null;actor.rest();
+  }
   const safe=SAFE.has(actor.state);
   if(waiting){
    waiting.age+=dt;if(!safe)waiting.left=true;
@@ -168,6 +215,11 @@ export function createCompanionLife(actor,{seed=731,energy=.8}={}){
   if(!['ball','treat','tug'].includes(kind))return false;
   if(kind==='tug'&&typeof actor.tug!=='function')return false;
   if(pending||active||cooldowns[kind]>0)return false;
+  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.
@@ -205,8 +257,8 @@ export function createCompanionLife(actor,{seed=731,energy=.8}={}){
    const interaction=active??pending;
    return {
     intent,label:pending?`${label} · ${PENDING_LABEL[pending]}`:label,episode:lastEpisode,interaction,busy:interaction!==null,
-    ball:ballReport(),treat:treatReport(),tug:actor.state==='tug'?{progress:actor.sample(clock).comfortPose?.progress??0,grip:1}:null,
-    snore:actor.state==='sleep'?((clock%3.6)/3.6):null,energy:needs.energy,decisions,cooldowns:{...cooldowns},
+    ball:ballReport(),treat:treatReport(),butterfly:butterflyPoint(),tug:actor.state==='tug'?{progress:actor.sample(clock).comfortPose?.progress??0,grip:1}:null,
+    snore:actor.state==='sleep'?((clock%3.6)/3.6):null,energy:needs.energy,drowsiness:needs.drowsiness,decisions,cooldowns:{...cooldowns},
     // Local hold clock only: progress freezes between updates; null outside the stationary hold.
     gesture:gesture&&SAFE.has(actor.state)?{clip:gesture.clip,progress:clamp(gesture.elapsed/gesture.duration,0,1)}:null
    };

package/puppy-companion-objects.mjs

@@ -7,6 +7,22 @@ export function paintCompanionObjects(pixels,width,height,projection,report,stat
  // Interaction drawings already include the toy/food. Never paint a second
  // floating ball over the baked mouth, or a biscuit through the puppy's chest.
  if(report.gesture)return pixels;
+ // Tiny procedural butterfly: two paired wings and a body. World-space size,
+ // same fixed camera and palette as the pet; no image/cache or extra render pass.
+ if(report.butterfly){
+  const b=report.butterfly,p=projection.project(b.x,b.height,b.z);
+  const edge=projection.project(b.x+.04,b.height,b.z),up=projection.project(b.x,b.height+.035,b.z);
+  const cx=p.x*width,cy=p.y*height,rx=Math.abs(edge.x-p.x)*width,ry=Math.abs(up.y-p.y)*height;
+  const opening=.22+.78*Math.abs(Math.sin(b.phase*Math.PI)),tone=Math.round(235*b.opacity);
+  if([cx,cy,rx,ry,opening,tone].every(Number.isFinite)&&rx>0&&ry>0&&tone>0)
+   for(let y=Math.max(0,Math.floor(cy-ry));y<Math.min(height,Math.ceil(cy+ry));y++)
+    for(let x=Math.max(0,Math.floor(cx-rx));x<Math.min(width,Math.ceil(cx+rx));x++){
+     const u=(x+.5-cx)/rx,v=(y+.5-cy)/ry,a=Math.abs(u)/opening;
+     const wing=((a-.5)/.44)**2+((v+.28)/.56)**2<1||((a-.36)/.29)**2+((v-.43)/.37)**2<1;
+     const body=Math.abs(u)<.1&&Math.abs(v)<.7;
+     if(wing||body){const j=(y*width+x)*4;pixels[j]=pixels[j+1]=pixels[j+2]=Math.max(pixels[j],body?tone:Math.round(tone*(.65+.35*a)));}
+    }
+ }
  // A quiet, tiny rising "z" suggests snoring. The sleeping dog itself remains
  // the original eyes-closed source pose: no chest/body zoom or squashing.
  if(Number.isFinite(report.snore)&&state.state==='sleep'){

package/puppy-companion-sprites.mjs

@@ -1,11 +1,13 @@
 import {grayFrameReader,isGrayFrameSource} from './puppy-frame-store.mjs';
 // Prebaked interaction samples; the original seat is the exact shared endpoint.
 // Pure sampling, no live image morph, root motion, camera or pose-size fitting.
-export function createCompanionSpriteSampler(bytes,info){
+export function createCompanionSpriteSampler(bytes,info,output){
  const n=320*320;
  if(!isGrayFrameSource(bytes)||info?.width!==320||info.height!==320||info.samples!==9||!Number.isInteger(info.pairs)||info.pairs<1||info.pairs>128||bytes.byteLength!==info.pairs*9*n)throw Error('Invalid companion sprite cache');
  for(const key of ['treat-eat','ball-pickup','ball-drop'])if(!Array.isArray(info.clips?.[key])||!info.clips[key].length||!info.clips[key].every(p=>Number.isInteger(p)&&p>=0&&p<info.pairs))throw Error('Invalid companion sprite clip');
- const frames=grayFrameReader(bytes,320,320,info.pairs*9),rgba=new Uint8ClampedArray(n*4);for(let i=3;i<rgba.length;i+=4)rgba[i]=255;
+ const frames=grayFrameReader(bytes,320,320,info.pairs*9),rgba=output??new Uint8ClampedArray(n*4);
+ if(!(rgba instanceof Uint8ClampedArray)||rgba.length!==n*4)throw Error('Invalid sprite output');
+ for(let i=3;i<rgba.length;i+=4)rgba[i]=255;
  return({clip,progress})=>{
   const list=info.clips[clip];if(!list||!Number.isFinite(progress)||progress<0||progress>1)throw Error('Invalid companion sprite pose');
   const q=progress*list.length,index=Math.min(list.length-1,Math.floor(q)),s=Math.round((q-index)*8),frame=frames.getFrame(list[index]*9+s);

package/puppy-frame-predictive.mjs

@@ -10,8 +10,9 @@
 //  20 u32[logicalFrameCount] logical -> unique index
 //  then uniqueCount records of u32 x,y,w,h,offset,length (length = h*(w+1))
 //  then the filtered rows of every unique crop, contiguous in order.
-// At load every crop is unfiltered once and kept as 5-bit packed indices; the
-// filtered input is not retained. Full frames are rebuilt on demand (LRU of 2).
+// At load every crop is validated. The portable store keeps 5-bit packed indices;
+// an optional host codec compresses each filtered crop instead (Node zlib).
+// Neither retains the input archive. Full frames rebuild on demand (LRU of 2).
 const MAGIC=[0x52,0x56,0x51,0x35],RVF1=[0x52,0x56,0x46,0x31],HEADER=20,RECORD=24,MAX_SIDE=16384,BITS=5;
 
 export const quantize5=v=>Math.round(v*31/255);
@@ -80,7 +81,8 @@ function unfilterRow(type,src,at,cur,prev,w){
 
 // Validate and unfilter. Only the returned typed arrays survive; `bytes` is
 // not referenced by the store built from them.
-function decode(bytes,{frameIndices}={}){
+function decode(bytes,{frameIndices,codec}={}){
+ if(codec&&(typeof codec.compress!=='function'||typeof codec.expand!=='function'))fail('codec');
  if(!(bytes instanceof Uint8Array))fail('bytes');
  if(!isPredictiveFrames(bytes)||bytes.length<HEADER)fail('magic');
  const view=new DataView(bytes.buffer,bytes.byteOffset,bytes.byteLength),u32=at=>view.getUint32(at,true);
@@ -107,27 +109,30 @@ function decode(bytes,{frameIndices}={}){
  }
  if(bytes.length!==data+total)fail('pixel length');
  if(pixels*BITS>0xffffffff)fail('pixel count');
- const packed=new Uint8Array(Math.ceil(pixels*BITS/8));
+ const packed=codec?null:new Uint8Array(Math.ceil(pixels*BITS/8)),chunks=codec?new Array(unique):null;
  let cur=new Uint8Array(width),prev=new Uint8Array(width),at=data,pos=0;
  for(let u=0;u<unique;u++){
-  const w=rects[u*5+2],h=rects[u*5+3];prev.fill(0);
+  const w=rects[u*5+2],h=rects[u*5+3],start=at;prev.fill(0);
   for(let y=0;y<h;y++){
    unfilterRow(bytes[at],bytes,at+1,cur,prev,w);at+=w+1;
    for(let x=0;x<w;x++){
-    const q=cur[x];if(q>31)fail('quantized value');if(needed&&!needed[u])continue;
+    const q=cur[x];if(q>31)fail('quantized value');if(codec||(needed&&!needed[u]))continue;
     const i=pos>>>3,s=pos&7;packed[i]|=(q<<s)&255;if(s>3)packed[i+1]|=q>>(8-s);pos+=BITS;
    }
    const t=prev;prev=cur;cur=t;
   }
+  if(codec&&h&&(!needed||needed[u]))chunks[u]=Uint8Array.from(codec.compress(bytes.subarray(start,at)));
  }
- return{width,height,frameCount,unique,map,rects,packed,retained};
+ return{width,height,frameCount,unique,map,rects,packed,retained,chunks,codec};
 }
 
-function createStore({width,height,frameCount,unique,map,rects,packed,retained}){
+function createStore({width,height,frameCount,unique,map,rects,packed,retained,chunks,codec}){
  const n=width*height,slots=[{unique:-1,frame:null},{unique:-1,frame:null}];let decodes=0,hits=0;
+ const pixelBytes=packed?.byteLength??chunks.reduce((sum,c)=>sum+(c?.byteLength??0),0);
+ const cur=codec?new Uint8Array(width):null,prev=codec?new Uint8Array(width):null;
  return Object.freeze({
-  width,height,frameCount,uniqueCount:unique,byteLength:n*frameCount,residentPixelBytes:packed.byteLength,
-  get residentBytes(){return packed.byteLength+map.byteLength+rects.byteLength+(retained?.byteLength??0)+slots.reduce((s,e)=>s+(e.frame?.byteLength??0),0);},
+  width,height,frameCount,uniqueCount:unique,byteLength:n*frameCount,residentPixelBytes:pixelBytes,
+  get residentBytes(){return pixelBytes+map.byteLength+rects.byteLength+(cur?.byteLength??0)+(prev?.byteLength??0)+(retained?.byteLength??0)+slots.reduce((s,e)=>s+(e.frame?.byteLength??0),0);},
   stats(){return{decodes,hits,cachedFrames:slots.filter(e=>e.frame).length};},
   getFrame(index){
    if(!Number.isInteger(index)||index<0||index>=frameCount)fail('frame index');
@@ -138,6 +143,18 @@ function createStore({width,height,frameCount,unique,map,rects,packed,retained})
    const slot=slots.pop();slots.unshift(slot);decodes++;
    const frame=slot.frame??=new Uint8Array(n),k=u*5,x=rects[k],y=rects[k+1],w=rects[k+2],h=rects[k+3];
    frame.fill(0);slot.unique=u;
+   if(codec){
+    if(!h)return frame;
+    const rows=codec.expand(chunks[u],h*(w+1));
+    if(rows.length!==h*(w+1))fail('expanded length');
+    prev.fill(0);
+    for(let r=0,at=0;r<h;r++,at+=w+1){
+     unfilterRow(rows[at],rows,at+1,cur,prev,w);
+     for(let c=0;c<w;c++)frame[(y+r)*width+x+c]=DISPLAY[cur[c]];
+     prev.set(cur.subarray(0,w));
+    }
+    return frame;
+   }
    let pos=rects[k+4]*BITS;
    for(let r=0;r<h;r++){
     const row=(y+r)*width+x;

package/puppy-paper-actions.mjs

@@ -37,11 +37,13 @@ export function paperActionPose(name,progress,info){
  if(!Number.isFinite(blend))throw Error('Invalid paper action: blend');
  return{pair:list[index],blend};
 }
-export function createPaperActionSampler(bytes,info){
+export function createPaperActionSampler(bytes,info,output){
  if(!isGrayFrameSource(bytes))throw Error('Invalid action cache: bytes');
  validatePaperActionInfo(info,bytes.byteLength);
  const stride=info.width*info.height,pairs=info.pairs,frames=grayFrameReader(bytes,info.width,info.height,pairs*9);
- const out=new Uint8ClampedArray(stride*4);for(let i=3;i<out.length;i+=4)out[i]=255;
+ const out=output??new Uint8ClampedArray(stride*4);
+ if(!(out instanceof Uint8ClampedArray)||out.length!==stride*4)throw Error('Invalid action output');
+ for(let i=3;i<out.length;i+=4)out[i]=255;
  return state=>{const p=paperActionPose(state.actionName,state.actionProgress,info),sample=Math.round(p.blend*8);
   if(p.pair>=pairs||sample<0||sample>8)throw Error('Invalid paper action: sample out of range');
   const frame=frames.getFrame(p.pair*9+sample);for(let i=0,j=0;i<stride;i++,j+=4)out[j]=out[j+1]=out[j+2]=frame[i];return out;};

package/puppy-paper-behaviors.mjs

@@ -5,4 +5,4 @@ export function paperBehaviorPose(state,info){
  const q=Math.min(list.length-1e-9,progress*list.length),i=Math.floor(q),blend=Math.round((q-i)*8)/8;
  return{pair:list[i],blend};
 }
-export function createPaperBehaviorSampler(bytes,info){const sample=createRearSampler(bytes,info);return state=>{const p=paperBehaviorPose(state,info);return sample(p.pair,p.blend);};}
+export function createPaperBehaviorSampler(bytes,info,output){const sample=createRearSampler(bytes,info,output);return state=>{const p=paperBehaviorPose(state,info);return sample(p.pair,p.blend);};}

package/puppy-paper-contact.mjs

@@ -91,9 +91,11 @@ export function footSourcePoint(x,y,pins){
  return chosen?{x:x-chosen.dx*best,y:y-chosen.dy*best}:{x,y};
 }
 
-export function createRearSampler(bytes,info){
+export function createRearSampler(bytes,info,output){
  if(!isGrayFrameSource(bytes)||info.pairs!==18||info.samples!==9||bytes.byteLength!==18*9*320*320)throw Error('Invalid rear sprite cache');
- const frames=grayFrameReader(bytes,320,320,18*9),out=new Uint8ClampedArray(320*320*4);for(let i=3;i<out.length;i+=4)out[i]=255;
+ const frames=grayFrameReader(bytes,320,320,18*9),out=output??new Uint8ClampedArray(320*320*4);
+ if(!(out instanceof Uint8ClampedArray)||out.length!==320*320*4)throw Error('Invalid rear output');
+ for(let i=3;i<out.length;i+=4)out[i]=255;
  return(pair,blend)=>{
   if(!Number.isInteger(pair)||pair<0||pair>=18||!Number.isFinite(blend)||blend<0||blend>1)throw Error('Invalid rear pose');
   const frame=frames.getFrame(pair*9+Math.round(blend*8));

package/puppy-paper-seat.mjs

@@ -1,9 +1,11 @@
 import {grayFrameReader,isGrayFrameSource} from './puppy-frame-store.mjs';
 // Exact cached samples; no live crossfade. Reverse the same path to stand up.
-export function createPaperSeatSampler(bytes,info){
+export function createPaperSeatSampler(bytes,info,output){
  const stride=320*320;
  if(!isGrayFrameSource(bytes)||info.width!==320||info.height!==320||info.pairs!==3||info.samples!==17||bytes.byteLength!==3*17*stride)throw Error('Invalid paper sitting cache');
- const frames=grayFrameReader(bytes,320,320,3*17),out=new Uint8ClampedArray(stride*4);for(let i=3;i<out.length;i+=4)out[i]=255;
+ const frames=grayFrameReader(bytes,320,320,3*17),out=output??new Uint8ClampedArray(stride*4);
+ if(!(out instanceof Uint8ClampedArray)||out.length!==stride*4)throw Error('Invalid seat output');
+ for(let i=3;i<out.length;i+=4)out[i]=255;
  return progress=>{
   if(!Number.isFinite(progress)||progress<0||progress>1)throw Error('Invalid paper sitting progress');
   const q=progress*3,pair=Math.min(2,Math.floor(q)),sample=Math.round((q-pair)*16),frame=frames.getFrame(pair*17+sample);

package/puppy-paper.mjs

@@ -28,6 +28,13 @@ export function createPaperComfortTimings(actionInfo,{key=PAPER_COMFORT_TIMINGS.
 }
 const comfortDuration=(name,seconds)=>{if(typeof seconds!=='number'||!Number.isFinite(seconds)||seconds<=0||seconds>PAPER_COMFORT_LIMITS[name])throw Error(`Invalid ${name} duration`);};
 const comfortEase=u=>u<=0?0:u>=1?1:u*u*(3-2*u);
+// Turn, hold the gaze, then return. Progress addresses the two authored edges;
+// the paws and torso are registered to the same seated source in both edges.
+export const PAPER_WATCH_TIMING=Object.freeze({turn:.6,hold:.65,back:.65,total:1.9});
+export function paperWatchProgress(age){
+ const {turn,hold,back}=PAPER_WATCH_TIMING;
+ return age<turn?.5*comfortEase(age/turn):age<turn+hold?.5:.5+.5*comfortEase((age-turn-hold)/back);
+}
 
 // Original artwork only. Physics supplies ground travel; no procedural dog is drawn.
 export function createPaperActor(animal,info,{manualTricks=false,trickTimings=null,walkTransitions=false,comfortTimings=PAPER_COMFORT_TIMINGS}={}){
@@ -40,7 +47,7 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
  let straight=false,seatProgress=0,seatVariant='default',travel=null,approachPlan=null,travelAge=0,travelDistance=0,motionSpeed=0,motionStage='rest',completed=false;
  let watchSide='left',restProgress=0,idleHold=2.5;
  let pendingAction=null,activeAction=null,actionDone=null,deferred=null,movementMode='run',stayDown=false,manualDown=false,spinReady=false;
- let comfort=null,comfortSeconds=0;
+ let comfort=null,comfortSeconds=0,sleepLook=null,nextSleepLook={variant:'side',right:false};
  const director=createPaperDirector();
  const points=[[.12,PAPER_GROUND.away]];
  const enter=s=>{state=s;age=0;};
@@ -99,7 +106,7 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
   pendingAction=null;
   if(name==='sit'){enter('idle');return;}
   if(name==='belly'){const seconds=comfortSeconds;playAction('lie-down',()=>startBelly(seconds),.65);return;}
-  if(name==='sleep'){stayDown=false;comfort={kind:'sleep',seconds:comfortSeconds};enter('recline');return;}
+  if(name==='sleep'){stayDown=false;sleepLook={...nextSleepLook};comfort={kind:'sleep',seconds:comfortSeconds};enter('recline');return;}
   if(name==='tug'){stop();comfort={kind:'tug',seconds:comfortSeconds};enter('tug');return;}
   if(name==='lie'){
    if(manualTricks){playAction('lie-down',()=>{manualDown=true;enter('down');drain();},.65);}
@@ -160,7 +167,7 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
   lie(){const name=manualDown||activeAction?.name==='lie-down'||restProgress>0?'sit':'lie';return dispatch(()=>requestAction(name));},
   // Comfort poses: bounded finite seconds; same dispatch safety as tricks.
   belly(seconds=6){comfortDuration('belly',seconds);return dispatch(()=>{comfortSeconds=seconds;return requestAction('belly');},{keepDown:true});},
-  sleep(seconds=25){comfortDuration('sleep',seconds);return dispatch(()=>{comfortSeconds=seconds;return requestAction('sleep');});},
+  sleep(seconds=25,variant='side',right=false){comfortDuration('sleep',seconds);if(!['side','belly','curl','chin'].includes(variant)||typeof right!=='boolean')throw Error('Invalid sleep pose');return dispatch(()=>{comfortSeconds=seconds;nextSleepLook={variant,right};return requestAction('sleep');});},
   tug(seconds=6){comfortDuration('tug',seconds);return dispatch(()=>{comfortSeconds=seconds;return requestAction('tug');});},
   rest(){return dispatch(()=>{route=false;target=null;waypoints=[];pendingAction=null;stayDown=false;comfort=null;stop();if(restProgress>0){enter('wake');}else if(state==='watch'||state==='arrival-exit'){/* finish shared return */}else if(seatProgress>0||state==='rise'||state==='sit-down')enter('sit-down');else if(!['idle','view-turn','turn'].includes(state))enter('finish');});},
   update(dt){
@@ -196,7 +203,7 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
    else if(state==='sit-down'){seatProgress=Math.min(1,seatProgress+dt/(snappyPreparation()?.35:.95));if(seatProgress===1){seatVariant='default';enter('idle');if(pendingAction)prepareDirection();}}
    else if(state==='rise'){seatProgress=Math.max(0,seatProgress-prepareDt/(snappyPreparation()?.28:.65));if(seatProgress===0){if(seatVariant==='arrival')enter('arrival-exit');else prepareDirection();}}
    else if(state==='arrival-exit'&&age>=.22){seatVariant='default';prepareDirection();}
-   else if(state==='watch'&&age>=1.4){if(pendingAction)prepareDirection();else if(target)enter('rise');else enter('idle');}
+   else if(state==='watch'&&age>=PAPER_WATCH_TIMING.total){if(pendingAction)prepareDirection();else if(target)enter('rise');else enter('idle');}
    else if(state==='recline'){const end=stayDown?.25:1;restProgress=Math.min(end,restProgress+dt/1.8);if(restProgress===end)enter(stayDown?'down':comfort?.kind==='sleep'?'sleep':'nap');}
    else if(state==='sleep'&&age>=comfort.seconds){comfort=null;enter('wake');}
    else if(state==='tug'&&tugProgress()>=1){comfort=null;enter('idle');drain();}
@@ -209,7 +216,8 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
    if(![12,24,30].includes(poseFps))throw Error('Invalid pose cadence');
    let pair=20,blend=0,kind=state,rearPair=null,approachPair=null;
    let seat=state==='sit-down'||state==='rise'||seatProgress>0?Math.round(seatProgress*48)/48:null;
-   let behavior=null,behaviorProgress=0,comfortPose=state==='tug'?{clip:'tug',progress:tugProgress()}:null;
+   if(restProgress===0&&state!=='recline')sleepLook=null;
+   let behavior=null,behaviorProgress=0,comfortPose=state==='tug'?{clip:'tug',progress:tugProgress()}:sleepLook&&restProgress>.72?{clip:'sleep',...sleepLook,blend:comfortEase((restProgress-.72)/.28)}:null;
    if(activeAction?.comfort)kind=activeAction.comfort;
    let actionName=activeAction?.name??(state==='run'&&movementMode==='walk'?'walk':null),actionProgress=activeAction?(activeAction.timing?activeAction.timing.progressAt(age):Math.min(1,age/activeAction.duration)):phase;
    if(manualDown&&state==='down'){actionName='lie-down';actionProgress=1;}
@@ -221,7 +229,7 @@ export function createPaperActor(animal,info,{manualTricks=false,trickTimings=nu
    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(state==='arrival-exit'){behavior='finish';behaviorProgress=Math.min(1,age/.22);}
-   if(state==='watch'){behavior=`watch-${watchSide}`;behaviorProgress=Math.min(1,age/1.4);}
+   if(state==='watch'){behavior=`watch-${watchSide}`;behaviorProgress=paperWatchProgress(age);}
    if(restProgress>0||state==='recline'||state==='wake'||state==='nap'){behavior='rest';behaviorProgress=restProgress;}
    if(state==='run'||state==='finish'){
     const p=state==='finish'?phase+(Math.ceil(phase)-phase)*Math.min(1,age/.22):phase;
@@ -251,14 +259,20 @@ export function createPaperRenderer(cache,info,meta,width,height,{rear,approach,
  if(![width,height].every(Number.isInteger)||width<2||height<2||width*height>1_000_000)throw Error('Invalid paper grid');
  const tween=createCachedTween(cache,info),renderMeta={...meta,pairs:info.pair_map,run_sequence:info.run_sequence};
  const out=new Uint8ClampedArray(width*height*4),area=createPaperAreaSampler();
- const rearSample=rear?createRearSampler(rear.bytes,rear.info):null,lock=createPaperFootLock({maxImageStretch:pawTransport?1.45:Infinity});
- const approachSample=approach?createRearSampler(approach.bytes,approach.info):null;
- const seatSample=seat?createPaperSeatSampler(seat.bytes,seat.info):null;
- const arrivalSeatSample=arrivalSeat?createPaperSeatSampler(arrivalSeat.bytes,arrivalSeat.info):null;
- const behaviorSample=behaviors?createPaperBehaviorSampler(behaviors.bytes,behaviors.info):null;
- const interactionSample=interactions?createCompanionSpriteSampler(interactions.bytes,interactions.info):null;
- const comfortSample=comfort?createComfortSpriteSampler(comfort.bytes,comfort.info):null;
- const actionSample=actions?createPaperActionSampler(actions.bytes,actions.info):null,actionArea=actions?createPaperAreaSampler(actions.info.width):null;
+ // Only one authored source is drawn at a time. Small samplers borrow a view of
+ // the action-sized scratch. A sleep blend reads each base pixel before writing
+ // that same pixel, so it needs no second image or per-frame temporary buffer.
+ const actionScratch=new Uint8ClampedArray(Math.max(320*320,(actions?.info.width??320)*(actions?.info.height??320))*4);
+ const spriteScratch=actionScratch.subarray(0,320*320*4);
+ for(let i=3;i<actionScratch.length;i+=4)actionScratch[i]=255;
+ const rearSample=rear?createRearSampler(rear.bytes,rear.info,spriteScratch):null,lock=createPaperFootLock({maxImageStretch:pawTransport?1.45:Infinity});
+ const approachSample=approach?createRearSampler(approach.bytes,approach.info,spriteScratch):null;
+ const seatSample=seat?createPaperSeatSampler(seat.bytes,seat.info,spriteScratch):null;
+ const arrivalSeatSample=arrivalSeat?createPaperSeatSampler(arrivalSeat.bytes,arrivalSeat.info,spriteScratch):null;
+ const behaviorSample=behaviors?createPaperBehaviorSampler(behaviors.bytes,behaviors.info,spriteScratch):null;
+ const interactionSample=interactions?createCompanionSpriteSampler(interactions.bytes,interactions.info,spriteScratch):null;
+ const comfortSample=comfort?createComfortSpriteSampler(comfort.bytes,comfort.info,spriteScratch):null;
+ const actionSample=actions?createPaperActionSampler(actions.bytes,actions.info,actionScratch.subarray(0,actions.info.width*actions.info.height*4)):null,actionArea=actions?createPaperAreaSampler(actions.info.width):null;
  const walkEpisodes=actions?createPaperSupportEpisodes(actions.info.feet,actions.info.clips.walk,9):null;
  const sourceEpisodes=rear?{
   front:createPaperSupportEpisodes(rear.info.frontFeet,[0,1,2,3,4,5,6,7],17),
@@ -276,7 +290,7 @@ export function createPaperRenderer(cache,info,meta,width,height,{rear,approach,
   const isInteraction=isComfort||state.interactionPose&&interactionSample;
   const isBehavior=!isInteraction&&state.behavior&&behaviorSample;
   const isAction=!isInteraction&&state.actionName&&actionSample,sourceN=isAction?actions.info.width:320,originX=(sourceN-320)/2,originY=(sourceN/320-1)*300;
-  const image=isComfort?comfortSample(state.comfortPose):isInteraction?interactionSample(state.interactionPose):isAction?actionSample(state):isBehavior?behaviorSample(state):isSeat?(state.seatVariant==='arrival'&&arrivalSeatSample?arrivalSeatSample:seatSample)(state.seatProgress):isApproach?approachSample(state.approachPair,state.blend):isRear?rearSample(state.rearPair,state.blend):tween(state),side=height*size,sideX=side/pixelAspect;
+  const image=isComfort?comfortSample({...state.comfortPose,...state.comfortPose.clip==='sleep'&&state.comfortPose.blend<1&&behaviorSample?{base:behaviorSample({behavior:'rest',behaviorProgress:state.behaviorProgress})}:{}}):isInteraction?interactionSample(state.interactionPose):isAction?actionSample(state):isBehavior?behaviorSample(state):isSeat?(state.seatVariant==='arrival'&&arrivalSeatSample?arrivalSeatSample:seatSample)(state.seatProgress):isApproach?approachSample(state.approachPair,state.blend):isRear?rearSample(state.rearPair,state.blend):tween(state),side=height*size,sideX=side/pixelAspect;
   // Quantize source lookup only, never the projected rectangle. Rounding side,
   // left and top first introduced whole-body scale/position jumps at thresholds.
   const left=width*x-sideX/2,floor=isInteraction||isAction||isBehavior||isSeat||isRear||isApproach?0:cleanGroundOffset(state,renderMeta),top=height*y-(300-floor)/320*side;

package/retrieviewer-cli.mjs

@@ -13,7 +13,7 @@ Usage:
   retrieviewer doctor [--agent ID] [--json]
   retrieviewer agents [--json]
   retrieviewer preview [--original]
-  retrieviewer desktop
+  retrieviewer desktop [--ink cream|gold|dark]
   retrieviewer desktop-status [--json]
   retrieviewer desktop-stop
   retrieviewer desktop-clean --yes
@@ -32,15 +32,17 @@ export function parseArguments(args){
  const [command='help',...rest]=args,options={};
  for(let i=0;i<rest.length;i++){
   const token=rest[i];
-  if(token==='--agent'){
-   if(options.agent||!rest[i+1]||rest[i+1].startsWith('-'))throw Error('--agent requires one ID');
-   options.agent=rest[++i];
+  if(token==='--agent'||token==='--ink'){
+   const key=token.slice(2);
+   if(options[key]||!rest[i+1]||rest[i+1].startsWith('-'))throw Error(token+' requires one value');
+   options[key]=rest[++i];
   }else if(['--yes','--json','--dry-run','--original'].includes(token))options[token.slice(2)]=true;
   else throw Error('Unknown argument: '+token);
  }
  if(options.agent&&!AGENTS.some(a=>a.id===options.agent))throw Error('Unknown agent: '+options.agent);
+ if(options.ink&&!['cream','gold','dark'].includes(options.ink))throw Error('--ink must be cream, gold or dark');
  if(!['help','--help','-h','enable','disable','disconnect','status','doctor','agents','preview','desktop','desktop-status','desktop-stop','desktop-clean','desktop-remove'].includes(command))throw Error('Unknown command: '+command);
- const allowed={enable:['agent','yes','json','dry-run'],disconnect:['agent','yes','json','dry-run'],disable:['agent','json'],status:['agent','json'],doctor:['agent','json'],agents:['json'],preview:['original'],'desktop-status':['json'],'desktop-clean':['yes'],'desktop-remove':['yes']};
+ const allowed={desktop:['ink'],enable:['agent','yes','json','dry-run'],disconnect:['agent','yes','json','dry-run'],disable:['agent','json'],status:['agent','json'],doctor:['agent','json'],agents:['json'],preview:['original'],'desktop-status':['json'],'desktop-clean':['yes'],'desktop-remove':['yes']};
  for(const key of Object.keys(options))if(!(allowed[command]??[]).includes(key))throw Error(`--${key} is not supported by ${command}`);
  return {command,options};
 }
@@ -51,7 +53,7 @@ export async function runCli(args,{input=process.stdin,output=process.stdout,err
   if(['desktop-clean','desktop-remove'].includes(command)&&!options.yes)throw Error('Use '+command+' --yes to remove only the companion cache.');
   const api=desktop??await import('./integrations/windows-overlay/desktop.mjs');
   const action={'desktop':'startDesktop','desktop-status':'desktopStatus','desktop-stop':'stopDesktop','desktop-clean':'cleanDesktop','desktop-remove':'removeDesktop'}[command];
-  emit(await api[action]());return 0;
+  emit(await api[action](options.ink?{ink:options.ink}:{}));return 0;
  }
  if(command==='preview'){await import('./examples/live.mjs');return 0;}
  if(['status','doctor','agents'].includes(command)){

package/retrieviewer.d.mts

@@ -42,10 +42,14 @@ export interface LifeReport {
   interaction: 'ball' | 'treat' | 'tug' | null;
   busy: boolean;
   energy: number;
+  /** Awake-time sleep pressure; ordinary sitting does not erase it. */
+  drowsiness: number;
   decisions: number;
   cooldowns: {ball: number; treat: number; tug: number};
   gesture: {clip: string; progress: number} | null;
   ball: {x: number; z: number; height: number; carried: boolean} | null;
+  /** Rare autonomous visitor; absent during direct user interactions. */
+  butterfly: {x: number; z: number; height: number; phase: number; opacity: number} | null;
   treat: {x: number; z: number; height: number} | null;
   /** Tug-of-war state while a tug interaction is active. */
   tug: {progress: number; grip: number} | null;

package/retrieviewer.mjs

@@ -60,9 +60,16 @@ async function gunzip(bytes){
 // life, renderer and output. Last dispose drops the shared lease, not other pets.
 const sharedAssets=new Map();
 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.
+ let codec;
+ if(typeof process!=='undefined'&&process.versions?.node){
+  const {deflateRawSync,inflateRawSync}=await import('node:zlib');
+  codec={compress:bytes=>deflateRawSync(bytes,{level:1}),expand:(bytes,size)=>inflateRawSync(bytes,{maxOutputLength:size})};
+ }
  const load=async name=>bytesOf(name,await loadAsset(name));
  const json=async name=>JSON.parse(new TextDecoder().decode(await load(name)));
- const frames=async (name,options)=>readPackedFrames(await gunzip(await load(name)),options);
+ const frames=async (name,options)=>readPackedFrames(await gunzip(await load(name)),{...options,codec});
  // One family at a time: never inflate all eight legacy-sized buffers together.
  const data={assets:{}};
  data.info=await json(PET_ASSETS.strideInfo);data.meta=await json(PET_ASSETS.stableInfo);