@oddessentials/agent-guild 1.31.0 → 1.33.0

package/web/yard/model.mjs

@@ -121,6 +121,13 @@ export function marksFor(s, mode) {
   const crew = waiting.length > shown.length ? 'waiting' : mode === 'rest' && !agents.length && !s.shells?.length ? 'asleep' : null;
   return { crew, helpers: shown.map(a => a.id) };
 }
+export const onFire = s => s.status !== 'exited' && (s.agents?.length || 0) + (s.shells?.length || 0) > SHOWN_HELPERS;
+export function fireTint(r, g, b) {
+  const max = Math.max(r, g, b), spread = max - Math.min(r, g, b);
+  const hue = !spread ? 0 : max === r ? ((g - b) / spread + 6) % 6 : max === g ? (b - r) / spread + 2 : (r - g) / spread + 4;
+  const s = Math.min((max ? spread / max : 0) * 1.25, 1), v = Math.max(max, .9);
+  return [5, 3, 1].map(n => { const k = (n + hue) % 6; return v - v * s * Math.max(0, Math.min(k, 4 - k, 1)); });
+}
 export function hash(value) {
   let n = 0;
   for (const char of String(value)) n = ((n << 5) - n + char.charCodeAt(0)) | 0;
@@ -434,6 +441,139 @@ export function clipFor(id, mode, n) {
   if (mode === 'work') return n % 3 === 2 && h % 2 ? set[1] : set[0];
   return n % 3 === 2 ? set[1 + (h % (set.length - 1))] : set[0];
 }
+export const VIBE = {
+  // Must stay inside the ground every world keeps clear (Clearance.live_distance in agent-guild-builders).
+  roam: { radius: 13.2, half: 12.5, front: 30.5, split: 3, margin: .9, edge: 1.2, head: 2.4 },
+  flight: { height: [8.5, 12], lap: [26, 44], reach: [.45, 1], scale: 1.3, top: 2 },
+};
+export function vibeFrame(aspect, top = 0, bottom = 0) {
+  const { target, zoom } = overviewFor(aspect), height = CAMERA.height / zoom, width = height * aspect, { edge } = VIBE.roam;
+  return { target, right: [edge - width / 2, width / 2 - edge], up: [(bottom - .5) * height + edge, (.5 - top) * height - edge] };
+}
+export function inVibeFrame(frame, x, y, z) {
+  const { right, up } = viewBasis(), d = [x - frame.target[0], y - frame.target[1], z - frame.target[2]];
+  const r = dot(d, right), u = dot(d, up);
+  return r >= frame.right[0] && r <= frame.right[1] && u >= frame.up[0] && u <= frame.up[1];
+}
+function unit(value) {
+  let h = hash(value);
+  h = Math.imul(h ^ (h >>> 16), 0x45d9f3b); h = Math.imul(h ^ (h >>> 16), 0x45d9f3b);
+  return ((h ^ (h >>> 16)) >>> 0) / 4294967296;
+}
+// Clip the visible ground polygon to an axis-aligned interval. Destination
+// geometry only: this neither builds nor checks a route.
+function vibeClip(points, axis, low, high) {
+  for (const [edge, sign] of [[low, 1], [high, -1]]) {
+    const next = [];
+    for (let i = 0; i < points.length; i++) {
+      const a = points[i], b = points[(i + 1) % points.length], da = sign * (a[axis] - edge), db = sign * (b[axis] - edge);
+      if (da >= 0) next.push(a);
+      if ((da < 0) !== (db < 0)) { const t = da / (da - db); next.push({ x: a.x + t * (b.x - a.x), z: a.z + t * (b.z - a.z) }); }
+    }
+    points = next;
+  }
+  return points;
+}
+// A missed sample is not an empty view. Obstacle x edges divide the ground
+// into at most 2B+1 bands, each with at most B+1 free z intervals. Check those
+// finite regions, not a grid whose spacing could miss a narrow opening.
+function vibeGap(polygon, boxes, near, far, seed) {
+  const { radius, half, front } = VIBE.roam;
+  polygon = vibeClip(vibeClip(polygon, 'x', -radius, radius), 'z', near, far);
+  const point = points => {
+    if (points.length < 3) return null;
+    const area = points.reduce((sum, a, i) => { const b = points[(i + 1) % points.length]; return sum + a.x * b.z - b.x * a.z; }, 0);
+    if (Math.abs(area) < 1e-10) return null;
+    const center = { x: 0, z: 0 };
+    for (const p of points) { center.x += p.x / points.length; center.z += p.z / points.length; }
+    const p = points[Math.floor(seed * points.length)], t = .25 + seed / 2;
+    return { x: center.x + (p.x - center.x) * t, z: center.z + (p.z - center.z) * t };
+  };
+  const ground = points => {
+    const p = point(points);
+    if (!p) return null;
+    if (Math.hypot(p.x, p.z) < radius || (Math.abs(p.x) <= half && p.z >= 0 && p.z <= front)) return p;
+    const apron = point(vibeClip(vibeClip(points, 'x', -half, half), 'z', 0, front));
+    if (apron) return apron;
+    // The plaza's obstacle excludes the circle's centre from every free
+    // region, so its nearest point is on an edge. Move from it into the
+    // polygon, staying inside the circle even for a small circular sliver.
+    let nearest = null, distance = Infinity;
+    for (let i = 0; i < points.length; i++) {
+      const a = points[i], b = points[(i + 1) % points.length], dx = b.x - a.x, dz = b.z - a.z;
+      const t = clamp(-(a.x * dx + a.z * dz) / (dx * dx + dz * dz || 1), 0, 1), q = { x: a.x + t * dx, z: a.z + t * dz }, d = Math.hypot(q.x, q.z);
+      if (d < distance) { nearest = q; distance = d; }
+    }
+    if (distance >= radius) return null;
+    const t = Math.min(.5, (radius - distance) / (2 * Math.hypot(p.x - nearest.x, p.z - nearest.z)));
+    return { x: nearest.x + t * (p.x - nearest.x), z: nearest.z + t * (p.z - nearest.z) };
+  };
+  if (!point(polygon)) return null;
+  const left = Math.min(...polygon.map(p => p.x)), right = Math.max(...polygon.map(p => p.x));
+  const edges = [...new Set([left, right, ...boxes.flatMap(b => [b.x - b.half, b.x + b.half]).filter(x => x > left && x < right)])].sort((a, b) => a - b);
+  const start = Math.floor(seed * (edges.length - 1));
+  for (let i = 0; i < edges.length - 1; i++) {
+    const k = (start + i) % (edges.length - 1), lo = edges[k], hi = edges[k + 1], x = (lo + hi) / 2;
+    const blocked = boxes.filter(b => Math.abs(x - b.x) < b.half).map(b => [b.z - b.half, b.z + b.half]).sort((a, b) => a[0] - b[0]);
+    let z = near;
+    for (const [low, high] of [...blocked, [far, far]]) {
+      if (low > z) {
+        const p = ground(vibeClip(vibeClip(polygon, 'x', lo, hi), 'z', z, Math.min(low, far)));
+        if (p) return p;
+      }
+      z = Math.max(z, high);
+      if (z >= far) break;
+    }
+  }
+  return null;
+}
+export function vibeStop(id, n, providers, props = [], frame = null) {
+  const { radius, half, front, split, margin, head } = VIBE.roam;
+  const [near, far] = (n + hash(id)) % 2 ? [split, front] : [-radius, split];
+  const boxes = [...obstacles(providers).map(box => ({ ...box, half: box.half + margin })),
+    ...props.map(p => ({ x: p.x, z: p.z, half: STAGING.station.half + margin }))];
+  const clear = (x, z) => (Math.hypot(x - STAGING.plaza.x, z - STAGING.plaza.z) <= radius || (Math.abs(x) <= half && z >= 0 && z <= front))
+    && !boxes.some(box => Math.abs(x - box.x) < box.half && Math.abs(z - box.z) < box.half);
+  if (frame) {
+    const { right, up, forward } = viewBasis(), [r0, r1] = frame.right, u0 = frame.up[0], u1 = frame.up[1] - head * up[1];
+    const at = (r, u) => {
+      const s = (-frame.target[1] - u * up[1]) / forward[1];
+      return { x: frame.target[0] + r * right[0] + u * up[0] + s * forward[0], z: frame.target[2] + r * right[2] + u * up[2] + s * forward[2] };
+    };
+    if (r1 > r0 && u1 > u0) {
+      const polygon = [at(r0, u0), at(r1, u0), at(r1, u1), at(r0, u1)];
+      for (const [low, high] of [[near, far], near === split ? [-radius, split] : [split, front]]) {
+        for (let k = 0; k < 48; k++) {
+          const p = at(r0 + unit(id + ':vibe:x:' + n + ':' + k) * (r1 - r0), u0 + unit(id + ':vibe:z:' + n + ':' + k) * (u1 - u0));
+          const x = round(p.x), z = round(p.z);
+          if (z >= low && z <= high && clear(x, z) && inVibeFrame(frame, x, 0, z) && inVibeFrame(frame, x, head, z)) return { x, z };
+        }
+        const p = vibeGap(polygon, boxes, low, high, unit(id + ':vibe:gap:' + n));
+        if (p) return p;
+      }
+    }
+  }
+  // No usable visible ground (or no frame): keep the original seeded walk.
+  // Never turn a crowded/covered view into a stationary, repeatedly retried unit.
+  for (let k = 0; k < 48; k++) {
+    const x = round((unit(id + ':vibe:x:' + n + ':' + k) * 2 - 1) * radius), z = round(near + unit(id + ':vibe:z:' + n + ':' + k) * (far - near));
+    if (clear(x, z)) return { x, z };
+  }
+  return { x: STAGING.plaza.x, z: round(STAGING.plaza.z + STAGING.plaza.half + margin + STAGING.station.half) };
+}
+export function vibeFlight(key, seconds, frame, companionHeight = 1) {
+  const { height, lap, reach, top, scale } = VIBE.flight, { right, up, forward } = viewBasis();
+  const pick = (name, [low, high]) => low + unit(key + ':vibe:' + name) * (high - low);
+  const out = pick('reach', reach), turn = unit(key + ':vibe:turn') < .5 ? 1 : -1, lobes = 2 + Math.floor(unit(key + ':vibe:lobes') * 3);
+  const angle = turn * 2 * Math.PI * (seconds / pick('lap', lap) + unit(key + ':vibe:start'));
+  const wide = out * (1 + .12 * Math.sin(lobes * angle + pick('phase', [0, 2 * Math.PI]))) / 1.12;
+  const y = (height[0] + height[1]) / 2 + (height[1] - height[0]) / 2 * Math.sin(2 * angle + pick('rise', [0, 2 * Math.PI]));
+  const [r0, r1] = frame.right, u0 = frame.up[0], u1 = frame.up[1] - Math.max(top, companionHeight * scale * up[1]);
+  const r = (r0 + r1) / 2 + Math.cos(angle) * Math.max(0, r1 - r0) / 2 * wide;
+  const u = (u0 + u1) / 2 + Math.sin(angle) * Math.max(0, u1 - u0) / 2 * wide;
+  const s = (y - frame.target[1] - u * up[1]) / forward[1];
+  return { x: frame.target[0] + r * right[0] + u * up[0] + s * forward[0], y, z: frame.target[2] + r * right[2] + u * up[2] + s * forward[2] };
+}
 // Where a session's helpers stand, around it, as the renderer has always placed them.
 export function helperOffset(i, count) {
   const angle = (i / Math.min(count, 6)) * Math.PI * 2;

package/web/yard/renderer.js

@@ -1,6 +1,7 @@
 import * as T from './vendor/engine.js';
 import { WORLDS, PROVIDER_ORDER, characterIndex, GILDED, CAMERA, SUN, minZoom, overviewFor, clampPan, viewBasis, providerPositions, sessionPose, familiarPose, hash,
-  stage, nextStagingChange, doorFor, arrives, route, clipFor, helperOffset, stationProp, hallActivity, lookTarget, lookLimits, yardExtras, playableClip, STAGING, photoSize, marksFor, SHOWN_HELPERS } from './model.mjs';
+  stage, nextStagingChange, doorFor, arrives, route, clipFor, helperOffset, stationProp, hallActivity, lookTarget, lookLimits, yardExtras, playableClip, STAGING, photoSize, marksFor, SHOWN_HELPERS, onFire, VIBE, vibeStop, vibeFlight, vibeFrame, inVibeFrame } from './model.mjs';
+import { Aura, auraShapes, EMBER_SIZE } from './aura.js';
 
 const ASSETS = new URL('./assets/', import.meta.url);
 const vector = new T.Vector3();
@@ -16,7 +17,7 @@ const pieceFiles = (skin, slot, piece) => (slot === 'companion' ? [0, 1, 2, 3].m
 const vector2 = new T.Vector2();
 // How fast characters turn to a new heading, in radians a second, and how
 // long a clip change blends.
-const TURN = 7, FADE = .3;
+const TURN = 7, FADE = .3, TAG = 44;
 // Models rigged before the staging contract name their clips differently.
 const LEGACY = { walk: 'working', idle_0: 'resting', idle_1: 'resting', idle_2: 'resting', pause: 'resting', work_0: 'working', work_1: 'working', idle: 'resting', move: 'working' };
 // How bright a hall's glow grows at low and high activity, over what the
@@ -102,6 +103,21 @@ function checkPiece({scene,animations}) {
     });
   } finally {disposeSkeletons(probe);}
 }
+function girth(scene) {
+  const probe=T.cloneSkeleton(scene);
+  try {
+    probe.updateMatrixWorld(true);
+    const inverse=new T.Matrix4().copy(probe.matrixWorld).invert(),local=new T.Matrix4();
+    let left=Infinity,right=-Infinity,back=Infinity,front=-Infinity;
+    probe.traverse(node=>{
+      if(!node.isSkinnedMesh)return;
+      node.skeleton.update();node.computeBoundingBox();
+      const {min,max}=node.boundingBox.applyMatrix4(local.multiplyMatrices(inverse,node.matrixWorld));
+      left=Math.min(left,min.x);right=Math.max(right,max.x);back=Math.min(back,min.z);front=Math.max(front,max.z);
+    });
+    return Math.max(right-left,front-back,0);
+  } finally {disposeSkeletons(probe);}
+}
 function disposeTree(root) {
   disposeSkeletons(root);
   const geometries=new Set(),materials=new Set();
@@ -139,15 +155,16 @@ function disposeWorld(root) {
 }
 export class YardRenderer {
   // clock gives the time staging is judged at; tests pass a fixed one.
-  constructor(host,labels,{select,open,error=noop,piece=noop,clock=Date.now}) {
-    this.host=host;this.labels=labels;this.onSelect=select;this.onOpen=open;this.onError=error;this.onPiece=piece;this.clock=clock;
+  constructor(host,labels,{select,open,error=noop,piece=noop,clock=Date.now,cover=[]}) {
+    this.host=host;this.labels=labels;this.cover=cover;this.onSelect=select;this.onOpen=open;this.onError=error;this.onPiece=piece;this.clock=clock;
     this.pieceSets={};this.shownPieces={skin:null,pieces:{}};this.pieceLoaders=new Map();this.preloads=new Map();
     this.scene=new T.Scene();this.units=new Map();this.halls=new Map();this.slots=new Map();this.cache=new Map();
     this.loadingManager=new T.LoadingManager();
     this.providers=[];this.sessions=[];this.selected=null;this.world=null;this.skin=null;this.request=0;this.worldRequest=0;this.pending=null;
     this.staged=null;this.seen=new Set();this.stageTimer=0;this.sparks=[];this.shows=[];this.marks=new T.Group();this.scene.add(this.marks);this.glyphs=null;this.markPlane=new T.PlaneGeometry(1,1);
+    this.pointScale={value:1};this.auraShapes=auraShapes();
     this.props=new Map();this.propSpots=[];this.station=null;this.effects=null;
-    this.active=false;this.reduced=false;this.disposed=false;this.frame=0;this.lastTime=0;this.dirty=true;
+    this.active=false;this.reduced=false;this.vibe=false;this.vibeTime=0;this.vibeFrames={stop:null,flight:vibeFrame(1)};this.disposed=false;this.frame=0;this.lastTime=0;this.dirty=true;
     this.crowd=null;this.rows=new Map();
     this.list=Object.assign(document.createElement('div'),{className:'yard-crowd-list',id:'yard-crowd-list-'+(++crowdLists),hidden:true});
     this.list.setAttribute('role','group');
@@ -195,7 +212,7 @@ export class YardRenderer {
     this.canvas.addEventListener('pointerdown',this.onPointerDown);
     this.canvas.addEventListener('click',this.onClick);
     this.canvas.addEventListener('dblclick',this.onDouble);
-    this.resizeObserver=new ResizeObserver(()=>this.resize());this.resizeObserver.observe(host);
+    this.resizeObserver=new ResizeObserver(()=>this.resize());for(const el of [host,...cover])this.resizeObserver.observe(el);
     this.resize();this.overview();
   }
   async asset(name,url) {
@@ -278,6 +295,7 @@ export class YardRenderer {
   }
   dropModel(unit) {
     for(const mixer of unit.mixers){mixer.stopAllAction();mixer.uncacheRoot(mixer.getRoot());}
+    unit.aura?.bind(null);
     if(unit.model){unit.root.remove(unit.model);disposeSkeletons(unit.model);}
     Object.assign(unit,{mixers:[],model:null,loaded:false,loading:false,animations:null,action:null,clip:null,lookBones:null,looking:false,load:(unit.load||0)+1});
   }
@@ -474,7 +492,7 @@ export class YardRenderer {
     const w=this.host.clientWidth,h=this.host.clientHeight;
     if(!w||!h)return;
     this.renderer.setSize(w,h,false);
-    if(this.effects)this.effects.points.material.uniforms.scale.value=this.renderer.getDrawingBufferSize(vector2).y/2;
+    this.pointScale.value=this.renderer.getDrawingBufferSize(vector2).y/2;
     const half=CAMERA.height/2;
     this.camera.left=-half*w/h;this.camera.right=half*w/h;
     this.camera.top=half;this.camera.bottom=-half;
@@ -482,8 +500,22 @@ export class YardRenderer {
     this.camera.zoom=T.MathUtils.clamp(this.camera.zoom,this.controls.minZoom,this.controls.maxZoom);
     this.camera.updateProjectionMatrix();
     this.dirty=true;
+    this.frameVibe(w,h);
     if(this.atOverview)this.overview();else this.drawOnce();
   }
+  frameVibe(w,h) {
+    const box=this.host.getBoundingClientRect();let top=0,bottom=0;
+    for(const el of this.cover){
+      const r=el.getBoundingClientRect();
+      if(!r.width||!r.height)continue;
+      if(r.top+r.bottom<box.top+box.bottom)top=Math.max(top,r.bottom-box.top);else bottom=Math.max(bottom,box.bottom-r.top);
+    }
+    top=T.MathUtils.clamp(top,0,h);bottom=T.MathUtils.clamp(bottom,0,h);
+    this.vibeFrames={stop:vibeFrame(w/h,(top+TAG)/h,bottom/h),flight:vibeFrame(w/h,top/h,bottom/h)};
+    if(!this.vibing())return;
+    const {stop}=this.vibeFrames,{head}=VIBE.roam;
+    for(const unit of this.units.values())if(unit.moving&&unit.target&&!(inVibeFrame(stop,unit.target.x,0,unit.target.z)&&inVibeFrame(stop,unit.target.x,head,unit.target.z)))this.roam(unit);
+  }
   overview() {
     const {target,zoom}=overviewFor((this.camera.right-this.camera.left)/(this.camera.top-this.camera.bottom));
     this.atOverview=true;
@@ -671,6 +703,9 @@ export class YardRenderer {
       unit.label.style.setProperty('--unit-color',session.provider.color||'#d0ba82');
       unit.label.setAttribute('aria-label',session.name+', '+unit.label.children[1].textContent);
       unit.ring.material.opacity=place.mode==='work'?.65:place.mode==='done'?.15:.35;
+      const burning=onFire(session);
+      if(burning&&!unit.aura){unit.aura=new Aura(session.id,this.auraShapes,this.pointScale);unit.root.add(unit.aura.group);unit.aura.bind(unit.model,unit.girth,unit.height);}
+      unit.aura?.set(burning,session.provider.color||'#d0ba82',this.reduced);
     }
     for(const id of live)this.seen.add(id);
     this.select(this.selected);this.dirty=true;this.drawOnce();
@@ -695,6 +730,7 @@ export class YardRenderer {
       yard=yardExtras(yard,'character');
       unit.speed=yard.stride/yard.cycle;
       unit.events=yard.events;unit.height=yard.height;unit.surface=yard.surface;unit.look=lookLimits(yard.look);
+      unit.girth=asset.girth??=girth(asset.scene);unit.aura?.bind(model,unit.girth,unit.height);
       const neck=model.getObjectByName('Neck'),head=model.getObjectByName('Head');
       unit.lookBones=neck&&head&&model.getObjectByName('LeftUpperLeg')?{neck,head}:null;
       this.scaleProp(unit.session?.id||session.id);
@@ -757,7 +793,7 @@ export class YardRenderer {
     geometry.setAttribute('size',new T.BufferAttribute(new Float32Array(PARTICLES),1));
     geometry.setAttribute('alpha',new T.BufferAttribute(new Float32Array(PARTICLES),1));
     const material=new T.ShaderMaterial({
-      uniforms:{color:{value:new T.Color(preset.color)},scale:{value:1}},
+      uniforms:{color:{value:new T.Color(preset.color)},scale:this.pointScale},
       vertexShader:`attribute float size;attribute float alpha;varying float vAlpha;uniform float scale;
         void main(){vAlpha=alpha;gl_Position=projectionMatrix*modelViewMatrix*vec4(position,1.);gl_PointSize=size*scale*projectionMatrix[1][1];}`,
       fragmentShader:`uniform vec3 color;varying float vAlpha;
@@ -922,6 +958,7 @@ export class YardRenderer {
   goTo(unit,place) {
     const target=unit.target;
     unit.mode=place.mode;
+    if(this.vibing()){if(!unit.moving)this.roam(unit);return;}
     if(target&&target.x===place.x&&target.z===place.z){unit.target=place;if(!unit.moving)this.play(unit);return;}
     unit.target=place;
     const at={x:unit.root.position.x,z:unit.root.position.z};
@@ -929,12 +966,33 @@ export class YardRenderer {
     else {unit.path=route(at,place,this.providers,this.propSpots);unit.moving=true;}
     this.play(unit);
   }
+  roam(unit) {
+    unit.roamed=(unit.roamed??-1)+1;
+    const at={x:unit.root.position.x,z:unit.root.position.z},stop=vibeStop(unit.session.id,unit.roamed,this.providers,this.propSpots,this.vibeFrames.stop);
+    unit.target=stop;unit.path=route(at,stop,this.providers,this.propSpots);unit.moving=true;
+    this.play(unit);
+  }
+  vibing() { return this.vibe&&!this.reduced; }
+  setVibe(value) {
+    if(this.vibe===Boolean(value))return;
+    const was=this.vibing();
+    this.vibe=Boolean(value);
+    if(was!==this.vibing())this.restage();
+  }
+  restage() {
+    if(!this.staged)return;
+    for(const [id,unit]of this.units){
+      const place=this.staged.places.get(id);
+      if(place){unit.target=null;this.goTo(unit,place);}
+    }
+    this.dirty=true;this.drawOnce();
+  }
   // Straight to its place, helpers with it.
   arrive(unit) {
     const place=unit.target;
     unit.root.position.set(place.x,.17,place.z);unit.path=[];unit.heading=place.face;unit.moving=false;
     if(unit.model)unit.model.rotation.y=unit.heading;
-    for(const helper of unit.helpers)helper.model.position.set(place.x+helper.offset.x,.27,place.z+helper.offset.z);
+    for(const helper of unit.helpers){helper.model.position.set(place.x+helper.offset.x,.27,place.z+helper.offset.z);helper.model.scale.setScalar(.45);}
   }
   // The clip a character should be playing now: the walk while it moves,
   // otherwise its mode's seeded sequence (model.mjs clipFor).
@@ -966,7 +1024,7 @@ export class YardRenderer {
   // Moves a walking character along its path at its stride's speed, turning
   // smoothly, and turns a standing one to face its place.
   advance(unit,dt) {
-    const root=unit.root.position;
+    const root=unit.root.position,vibing=this.vibing();
     let want=unit.target?.face??unit.heading;
     if(unit.moving&&unit.path.length) {
       let step=unit.speed*dt;
@@ -976,7 +1034,7 @@ export class YardRenderer {
         if(d<=step){root.x=next.x;root.z=next.z;unit.path.shift();step-=d;}
         else {root.x+=dx/d*step;root.z+=dz/d*step;step=0;}
       }
-      if(!unit.path.length){unit.moving=false;this.play(unit);}
+      if(!unit.path.length){if(vibing)this.roam(unit);else {unit.moving=false;this.play(unit);}}
       this.dirty=true;
     }
     const turn=angleTo(unit.heading,want);
@@ -988,13 +1046,15 @@ export class YardRenderer {
     // Helpers trail their character, closing most of the gap in a second.
     const pull=1-Math.exp(-4*dt);
     for(const helper of unit.helpers){
-      const tx=root.x+helper.offset.x,tz=root.z+helper.offset.z,p=helper.model.position;
-      const dx=tx-p.x,dz=tz-p.z,far=Math.hypot(dx,dz);
-      p.x+=dx*pull;p.z+=dz*pull;
+      const to=vibing?vibeFlight(unit.session.id+':'+helper.id,this.vibeTime,this.vibeFrames.flight,helper.height):{x:root.x+helper.offset.x,y:.27,z:root.z+helper.offset.z};
+      const p=helper.model.position,dx=to.x-p.x,dy=to.y-p.y,dz=to.z-p.z,far=Math.hypot(dx,dz);
+      const size=vibing?VIBE.flight.scale:.45,grow=size-helper.model.scale.x;
+      p.x+=dx*pull;p.y+=dy*pull;p.z+=dz*pull;
+      if(grow)helper.model.scale.setScalar(Math.abs(grow)<1e-3?size:helper.model.scale.x+grow*pull);
       if(far>.05)helper.model.rotation.y=Math.atan2(dx,dz);
       const moving=far>.08;
       if(moving!==helper.moving){helper.moving=moving;this.helperClip(helper,moving?'move':helper.pose);}
-      if(far>1e-3)this.dirty=true;
+      if(far>1e-3||Math.abs(dy)>1e-3||grow)this.dirty=true;
     }
     this.fire(unit);
   }
@@ -1134,13 +1194,20 @@ export class YardRenderer {
       spark.points.geometry.attributes.position.needsUpdate=true;
     }
   }
+  restHelper(unit,helper) {
+    helper.model.position.set(unit.root.position.x+helper.offset.x,.27,unit.root.position.z+helper.offset.z);
+    helper.model.scale.setScalar(.45);
+    helper.moving=false;helper.mixer.stopAllAction();helper.action=null;
+    this.helperClip(helper,helper.pose);
+    helper.mixer.update(0);
+  }
   helperClip(helper,name) {
     const clip=helper.clips.find(c=>c.name===name)||helper.clips.find(c=>c.name===LEGACY[name])||helper.clips[0];
     if(!clip)return;
     const action=helper.mixer.clipAction(clip);
     if(action===helper.action)return;
     action.reset().play();
-    if(helper.action){if(this.reduced)helper.action.stop();else helper.action.crossFadeTo(action,FADE,false);}
+    if(helper.action)helper.action.crossFadeTo(action,FADE,false);
     helper.action=action;
   }
   clearHelpers(unit) {
@@ -1154,9 +1221,15 @@ export class YardRenderer {
     const kinds=WORLDS[this.skin].helpers,source=this.pieceSource('companion');
     const signature=JSON.stringify([source?.revision??null,agents]);
     if(unit.helperSignature===signature)return;
-    this.clearHelpers(unit);
+    const shown=agents.slice(0,SHOWN_HELPERS);
+    unit.helpers=unit.helpers.filter(helper=>{
+      if(shown.some(agent=>agent.id===helper.id))return true;
+      unit.crew.remove(helper.model);helper.mixer.stopAllAction();helper.mixer.uncacheRoot(helper.model);disposeSkeletons(helper.model);
+      return false;
+    });
     unit.helperSignature=signature;
-    const rev=unit.revision,generation=this.request;
+    const rev=++unit.revision,generation=this.request;
+    this.dirty=true;this.drawOnce();
     const stale=()=>this.disposed||generation!==this.request||rev!==unit.revision||!unit.root.parent;
     let pieces=null;
     if(source&&agents.length){
@@ -1171,26 +1244,31 @@ export class YardRenderer {
     }
     // The full helper count and all helper details remain in the canonical inspector.
     // Small squads preserve readable character silhouettes at the overview scale.
-    await Promise.all(agents.slice(0,SHOWN_HELPERS).map(async(agent,i)=>{
+    await Promise.all(shown.map(async(agent,i)=>{
+      const offset=helperOffset(i,agents.length),existing=unit.helpers.find(helper=>helper.id===agent.id);
+      if(existing){
+        existing.offset=offset;existing.pose=agent.pose;
+        if(this.reduced)this.restHelper(unit,existing);
+        else if(!existing.moving&&!this.vibing())this.helperClip(existing,agent.pose);
+        this.dirty=true;this.drawOnce();
+        return;
+      }
       try {
         const n=hash(agent.name||agent.id)%4;
         const asset=pieces?pieces[n]:await this.asset((agent.shell?kinds.shell:kinds.agent)+n);
         if(stale())return;
         const model=T.cloneSkeleton(asset.scene);
         model.traverse(n=>{if(n.isSkinnedMesh)n.frustumCulled=false;});
-        const offset=helperOffset(i,agents.length);
         model.scale.setScalar(.45);model.position.set(unit.root.position.x+offset.x,.27,unit.root.position.z+offset.z);
         unit.crew.add(model);
         const mixer=new T.AnimationMixer(model);
         let yard=null;asset.scene.traverse(n=>{if(n.userData?.yard)yard=n.userData.yard;});
-        const helper={id:agent.id,top:yardExtras(yard,'helper').height*model.scale.y,model,mixer,offset,pose:agent.pose,clips:asset.animations,moving:false,action:null};
-        this.helperClip(helper,agent.pose);
-        mixer.update(.3+(hash(agent.id)%40)/10);
+        const helper={id:agent.id,height:yardExtras(yard,'helper').height,get top(){return this.height*this.model.scale.y;},model,mixer,offset,pose:agent.pose,clips:asset.animations,moving:false,action:null};
+        if(this.reduced)this.restHelper(unit,helper);
+        else {this.helperClip(helper,agent.pose);mixer.update(.3+(hash(agent.id)%40)/10);}
         unit.helpers.push(helper);
         this.dirty=true;this.drawOnce();
       } catch {
-        // The next state transition can rebuild this incomplete squad. Routine
-        // unchanged updates do not call helpers(), so failure cannot loop.
         if(!stale())unit.helperSignature=null;
       }
     }));
@@ -1215,9 +1293,10 @@ export class YardRenderer {
     const w=this.host.clientWidth,h=this.host.clientHeight,buffer=this.renderer.getDrawingBufferSize(new T.Vector2());
     const size=photoSize(w,h,buffer.x,buffer.y);
     const viewport=this.renderer.getViewport({copy:v=>v.clone()}),ratio=this.renderer.getPixelRatio();
-    const particleScale=this.effects?.points.material.uniforms.scale,scale=particleScale?.value;
+    const particleScale=this.pointScale,scale=particleScale.value;
     const fireworks=this.sparks.filter(s=>s.firework).map(s=>({material:s.points.material,size:s.points.material.size}));
-    const radius=Math.max((this.effects?Math.max(...this.effects.preset.size):0)*size.height*this.camera.projectionMatrix.elements[5]/4,
+    const embers=[...this.units.values()].some(unit=>unit.aura)?EMBER_SIZE:0;
+    const radius=Math.max(Math.max(embers,...(this.effects?this.effects.preset.size:[]))*size.height*this.camera.projectionMatrix.elements[5]/4,
       ...fireworks.map(s=>s.size*size.scale/2));
     const pad=Math.ceil(radius)+1,tw=buffer.x+2*pad,th=buffer.y+2*pad;
     const canvas=Object.assign(document.createElement('canvas'),{width:size.width,height:size.height});
@@ -1231,7 +1310,7 @@ export class YardRenderer {
       // Keep particle centers within a padded frustum. Extending the viewport
       // beyond the canvas crops the margins without enlarging the live buffer.
       this.renderer.setViewport(-pad/ratio,-pad/ratio,tw/ratio,th/ratio);
-      if(particleScale)particleScale.value=th/2;
+      particleScale.value=th/2;
       for(const {x,y}of size.tiles) {
         this.camera.setViewOffset(size.width,size.height,x-pad,y-pad,tw,th);
         this.renderer.render(this.scene,this.camera);
@@ -1240,7 +1319,7 @@ export class YardRenderer {
     } finally {
       for(const spark of fireworks)spark.material.size=spark.size;
       this.renderer.setViewport(viewport);
-      if(particleScale)particleScale.value=scale;
+      particleScale.value=scale;
       this.camera.clearViewOffset();
       this.select(this.selected);
       this.renderer.render(this.scene,this.camera);
@@ -1262,7 +1341,7 @@ export class YardRenderer {
     this.pointer.set((event.clientX-rect.left)/rect.width*2-1,-(event.clientY-rect.top)/rect.height*2+1);
     this.ray.setFromCamera(this.pointer,this.camera);
     // A skinned mesh keeps the bounds of the pose it first had; picking needs the pose on screen.
-    for(const unit of this.units.values())for(const root of [unit.root,unit.crew])root?.traverse(n=>{if(!n.isSkinnedMesh)return;n.computeBoundingSphere();if(n.boundingBox)n.computeBoundingBox();});
+    for(const unit of this.units.values())for(const root of [unit.root,unit.crew])root?.traverse(n=>{if(!n.isSkinnedMesh||n.userData.aura)return;n.computeBoundingSphere();if(n.boundingBox)n.computeBoundingBox();});
     const hits=this.ray.intersectObjects([...this.halls.values(),...this.units.values()].flatMap(i=>i.crew?[i.root,i.crew]:[i.root]),true);
     for(const hit of hits) { for(let node=hit.object;node;node=node.parent) if(node.userData.entity)return node.userData.entity; }
     return null;
@@ -1343,9 +1422,13 @@ export class YardRenderer {
     this.list.style.top=Math.max(6,ct+half+4+lh<=h-6?ct+half+4:ct-half-4-lh)+'px';
   }
   setReducedMotion(value) {
+    const was=this.vibing();
     this.reduced=value;
+    if(was!==this.vibing())this.restage();
     if(value)for(const unit of this.units.values()){this.unlook(unit);unit.lookYaw=0;unit.lookPitch=0;}
     if(value)for(const unit of this.units.values())if(unit.moving&&unit.target){this.arrive(unit);this.play(unit);}
+    if(value)for(const unit of this.units.values())for(const helper of unit.helpers)this.restHelper(unit,helper);
+    for(const unit of this.units.values())unit.aura?.set(unit.aura.active,unit.aura.color,value);
     if(value){for(const item of this.halls.values())item.level=item.target;this.glow();this.stillEffects();this.clearFireworks();}
     this.dirty=true;this.drawOnce();
   }
@@ -1372,12 +1455,14 @@ export class YardRenderer {
   // Advances walks, turns, helpers, clips, glances, sparks and the halls'
   // glow and effects by dt seconds, without drawing.
   step(dt) {
+    const vibing=this.vibing();
+    if(vibing)this.vibeTime+=dt;
     for(const unit of this.units.values()) {
       this.advance(unit,dt);
       // Characters out of view animate five times a second, enough to stay
       // in step for when the camera comes back to them.
       let step=dt;
-      if(unit.offscreen){unit.lag=(unit.lag||0)+dt;if(unit.lag<.2)continue;step=unit.lag;}
+      if(unit.offscreen&&!vibing){unit.lag=(unit.lag||0)+dt;if(unit.lag<.2)continue;step=unit.lag;}
       unit.lag=0;
       this.unlook(unit);
       for(const mixer of unit.mixers)mixer.update(step);
@@ -1388,6 +1473,7 @@ export class YardRenderer {
     this.updateSparks(dt);
     this.updateHalls(dt);
     this.stepMarks(dt);
+    for(const unit of this.units.values())if(unit.aura?.advance(dt))this.dirty=true;
   }
   drawOnce() { if(this.active)this.schedule(); }
   mark(unit,place) {
@@ -1440,6 +1526,7 @@ export class YardRenderer {
     for(const mixer of unit.mixers){mixer.stopAllAction();mixer.uncacheRoot(mixer.getRoot());}
     for(const helper of unit.helpers){helper.mixer.stopAllAction();helper.mixer.uncacheRoot(helper.model);}
     for(const mark of unit.marks?.values()||[])this.dropMark(mark);
+    unit.aura?.dispose();
     disposeSkeletons(unit.root);disposeSkeletons(unit.crew);
     this.scene.remove(unit.root);this.scene.remove(unit.crew);unit.label.remove();unit.ring.geometry.dispose();unit.ring.material.dispose();
   }
@@ -1456,6 +1543,7 @@ export class YardRenderer {
     disposeWorld(this.world);
     for(const entry of this.cache.values())entry.then(a=>disposeTree(a.scene)).catch(noop);this.cache.clear();
     for(const texture of Object.values(this.glyphs||{}))texture.dispose();this.markPlane.dispose();
+    for(const shape of Object.values(this.auraShapes))shape.dispose();
     this.sun.shadow.map?.dispose();
     this.canvas.removeEventListener('webglcontextlost',this.contextLost);
     this.canvas.removeEventListener('pointerdown',this.onPointerDown);

package/web/yard/view.js

@@ -169,6 +169,20 @@ export function initYard(controller) {
     button.disabled = !renderer || disposed || motion.matches;
     button.title = motion.matches ? 'Fireworks off: reduced motion is enabled' : 'Fireworks in this Yard only';
   };
+  let vibe = false;
+  try { vibe = localStorage.getItem('agentGuild.vibe') === 'on'; } catch {}
+  const vibeButton = () => {
+    const button = $('yard-vibe');
+    button.setAttribute('aria-pressed', String(vibe));
+    button.disabled = motion.matches;
+    button.title = motion.matches ? 'Vibes Mode off: reduced motion is enabled' : vibe ? 'Vibes Mode is on in every Yard' : 'Vibes Mode: everyone roams, in every Yard';
+  };
+  const toggleVibe = () => {
+    vibe = !vibe;
+    try { localStorage.setItem('agentGuild.vibe', vibe ? 'on' : 'off'); } catch {}
+    renderer?.setVibe(vibe);
+    vibeButton();
+  };
   const sceneVisible = () => view === 'yard' && !$('app').hidden && document.visibilityState !== 'hidden' && $('terminal-panel').hidden;
   const skinEntry = (skin = root.dataset.skin) => (window.agentGuildSkins || []).find((item) => item.id === skin) || null;
   const yardOff = root.dataset.yard === 'none';
@@ -281,6 +295,7 @@ export function initYard(controller) {
           open: id => controller.openSession(id),
           error: () => { if (attempt === sceneAttempt) failScene(); },
           piece: pieceDrawn,
+          cover: [...document.querySelectorAll('.yard-heading > *, #yard-stage .yard-overlay')],
         });
         pendingRenderer = candidate;
         // Appearance can change while the first world is loading.
@@ -299,6 +314,7 @@ export function initYard(controller) {
         renderer = candidate;
         lastSkin = skin; lastTheme = theme; lastRevision = revision;
         renderer.setReducedMotion(motion.matches);
+        renderer.setVibe(vibe);
         renderer.update(snapshot.providers, snapshot.sessions);
         renderer.select(selected);
         renderer.setActive(sceneVisible());
@@ -465,6 +481,8 @@ export function initYard(controller) {
   $('yard-zoom-out').addEventListener('click',() => renderer?.zoom(1/1.2));
   $('yard-fireworks').addEventListener('click',celebrate);
   fireworksButton();
+  $('yard-vibe').addEventListener('click',toggleVibe);
+  vibeButton();
   $('yard-photo').hidden = !controller.photo;
   $('yard-photo').addEventListener('click',async () => {
     let YardPhoto;
@@ -490,7 +508,7 @@ export function initYard(controller) {
     setView(preferYard && skinAllowsYard() ? 'yard' : 'cards', { remember: false });
     renderer?.setActive(sceneVisible());
   };
-  const motionChange = () => { renderer?.setReducedMotion(motion.matches); fireworksButton(); };
+  const motionChange = () => { renderer?.setReducedMotion(motion.matches); fireworksButton(); vibeButton(); };
   const pageHide = () => renderer?.setActive(false);
   const observer = new MutationObserver((records) => {
     if (records.some((record) => record.attributeName === 'data-skin' || record.attributeName === 'data-theme')) onAppearance();
@@ -507,6 +525,7 @@ export function initYard(controller) {
   return { update, select, setView, closePhoto, celebrate, dispose() {
     closePhoto();
     $('yard-fireworks').removeEventListener('click',celebrate);
+    $('yard-vibe').removeEventListener('click',toggleVibe);
     disposed=true; fireworksButton(); sceneAttempt++; worldAttempt++; clearTimeout(swapReveal); observer.disconnect(); pendingRenderer?.dispose(); renderer?.dispose();
     document.removeEventListener('visibilitychange',visibility);
     motion.removeEventListener('change',motionChange);

package/web/yard/yard.css

@@ -265,3 +265,4 @@
 @container (max-width:440px) { .yard-play-text { display:none; } .yard-play-link { padding:0 7px; } }
 @container (max-width:380px) { .yard-play:not(.yard-play-solo) .yard-play-link { display:none; } .yard-play-chip { --play-more-w:44px; } .yard-play-more { padding:0; } .yard-play-more::before { display:none; } .yard-play-more-orb { display:block; grid-area:1 / 1; } .yard-play-caret { grid-area:1 / 1; place-self:end; width:9px; height:6px; margin:0 7px 6px 0; stroke-width:2.2; } }
 @container (max-width:340px) { :root:is([data-skin="orbital"],[data-skin="gnomeland"],[data-skin="goblinville"],[data-skin="grove"],[data-skin="guild"],[data-skin="professional"]) :is(.yard-eyebrow, #yard-subtitle) { display:none; } }
+#yard-vibe[aria-pressed="true"] { border-color:var(--accent); color:var(--accent); }