mirrors/hermes-agent
1
0
Fork 0
mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-07-01 12:02:05 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

feat(desktop): ground the roaming pet — sprite-paced walk + feet on surface

Browse source 
Walk speed is derived from the sprite's animation loop + on-screen size (one body-width per loop) instead of a fixed px/s, so it steps rather than glides; the pet also sinks a few px so its feet meet the surface instead of hovering.
This commit is contained in:
Brooklyn Nicholson 2026-06-29 14:47:37 -05:00
parent b72c9e1b2c
commit 0e2a5a3206
2 changed files with 17 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

1
apps/desktop/src/components/pet/floating-pet.tsx
View file

@ -390,6 +390,7 @@ export function FloatingPet() {
containerRef,
enabled: roamEnabled && active && !overlayActive && atRest,
isInteracting: isDragging,
loopMs: info.loopMs ?? 1100,
petH,
petW
})

21
apps/desktop/src/components/pet/use-pet-roam.ts
View file

@ -28,7 +28,10 @@ const PERCH_SELECTORS = ['[data-slot="composer-surface"]', '[data-slot="profile-
// the bar rather than covering it.
const FLOOR_BAR_SELECTOR = '[data-slot="statusbar"]'
const WALK_SPEED_PX_S = 58
// Foot-sync: advance this many body-widths per animation loop so the walk reads
// as steps, not a glide. Actual px/s is derived from the sprite's loop duration
// and on-screen size (see `walkSpeedPxS`).
const STRIDE_PER_LOOP = 0.8
// Downward acceleration for falls between ledges — fast enough to read as a drop.
const GRAVITY_PX_S2 = 5200
// Time to spring up onto a higher ledge.
@ -44,6 +47,9 @@ const HOP_CHANCE = 0.45
// ledge (or this many px, whichever is larger), up to the room available.
const STROLL_MIN_FRACTION = 0.45
const STROLL_MIN_PX = 110
// Sprites carry a few px of transparent padding below the feet; sink the pet by
// this much so the visible feet meet the surface instead of hovering above it.
const FEET_DROP_PX = 4
// Snap distances: "on this ledge" / arrived at a walk target.
const GROUND_EPS = 2
const ARRIVE_EPS = 1.5
@ -118,6 +124,8 @@ interface PetRoamOptions {
isInteracting: () => boolean
petW: number
petH: number
/** Sprite animation loop duration (ms) — paces the walk to the leg cadence. */
loopMs: number
/** Persist the resting position back to React state when the loop settles. */
commit: (point: Point) => void
}
@ -143,7 +151,7 @@ interface PetRoamOptions {
* the shared `$petState`, and `$petRoamDir` (-1/0/1) lets the floating pet pick
* the directional run row + mirror for the travel direction.
*/
export function usePetRoam({ enabled, containerRef, isInteracting, petW, petH, commit }: PetRoamOptions): void {
export function usePetRoam({ enabled, containerRef, isInteracting, petW, petH, loopMs, commit }: PetRoamOptions): void {
useEffect(() => {
if (!enabled) {
$petMotion.set(null)
@ -158,7 +166,10 @@ export function usePetRoam({ enabled, containerRef, isInteracting, petW, petH, c
return
}
const groundTop = (ledge: Ledge): number => ledge.y - petH
// Pace the stride to the sprite: one body-width per animation loop.
const walkSpeedPxS = (petW * STRIDE_PER_LOOP) / (loopMs / 1000)
const groundTop = (ledge: Ledge): number => ledge.y - petH + FEET_DROP_PX
// A stroll destination on `ledge` that actually goes somewhere: lean toward
// the side with more room (so the pet crosses the app rather than shuffling
@ -330,7 +341,7 @@ export function usePetRoam({ enabled, containerRef, isInteracting, petW, petH, c
case 'walk': {
const remaining = walkTargetX - cur.x
const stepDist = WALK_SPEED_PX_S * dt
const stepDist = walkSpeedPxS * dt
if (Math.abs(remaining) <= Math.max(ARRIVE_EPS, stepDist)) {
cur.x = walkTargetX
@ -403,5 +414,5 @@ export function usePetRoam({ enabled, containerRef, isInteracting, petW, petH, c
// the loop stops re-asserting it.
commit({ ...cur })
}
}, [enabled, petW, petH, containerRef, isInteracting, commit])
}, [enabled, petW, petH, loopMs, containerRef, isInteracting, commit])
}