---
name: vora-vivi-character
description: Create, animate, validate, and package a custom VORA VIVI desktop character from a chosen reference or brief as a transparent full-body frame sequence and installable .vivipack. Use for VIVI character packs, motions, transitions, and costume variants; not for changing the VIVI app or authentication.
---

# Make a custom VORA VIVI character

Produce real artwork, editable JSON, a preview, and an installable `.vivipack` for the user's requested scope. This file is a standalone skill: save it as `vora-vivi-character/SKILL.md` in the AI tool's skill directory, or supply the whole file as task instructions. Choose one language edition; all editions have the same skill name.

## Read the official contract

- [Creator guide](https://vivi.vora.im/en/customize/)
- [Manifest JSON Schema](https://vivi.vora.im/downloads/character.schema.json)
- [Complete default VIVI pack](https://cdn.vora.im/vora-works/releases/vivi/characters/0.2.7/vora-vivi.grey-hood-0.2.7.vivipack)
- [Manifest example](https://vivi.vora.im/downloads/character.example.json) and [frame sequence example](https://vivi.vora.im/downloads/frames.example.json)

When online, read the schema and unpack the complete default VIVI pack before editing. The download contains every action, idle, prop, outfit and transition in the current pack, including all frame JSON. Cross-check the complete manifest, catalogue.json and character-full.json for clip and file counts. Respect the artwork license. Use schemaVersion 1 and the installed app importer as the final validator. JSON validation alone does not establish artwork quality, prop continuity or performance.

## Preserve the chosen character

Follow the user's reference, species, proportions, expression, clothing, colors, and desired art style. A custom character need not be a cat or wear VORA clothing. Only when extending the official grey-hood VIVI, retain its approved face/body proportions and dimensional painted look, always-worn headphones, official square VORA logos on headphones and hoodie, and no teeth. Do not impose those brand-specific traits on a different character.

Use the requested motion scope and already-approved frame counts. For a complete replacement of the default pack, scope production against every clip, event and outfit in this document. Limit work to a subset only when the user requested that subset. The sample’s 12 frames/100 ms is a reference, not a universal rule. Ask for missing character direction only when it prevents useful work, and do not repeat approvals already given.

Use an available image-generation/editing tool or supplied drawings to create genuine consecutive **full-body drawings for each motion**. Keep identity consistent while limbs, hind feet, torso, head, gaze, and expression act together. Typing paws must approach and contact the laptop keyboard naturally. Props may accompany the transparent character. Do not substitute rotated image parts, a joint rig, a wobbling still, repeated identical images, or a CSS fade for new animated artwork. A deliberately held idle pose is valid, but label it as held, not an animated idle.

If image generation is unavailable, state the missing capability and provide a clearly labelled motion brief or packaging of supplied art. Never claim new frames were generated when only prompts, copies, or transforms were produced. Use generation services within the user's existing authorization; keep API keys, login tokens, private references, and machine credentials out of the pack, prompts, logs, and public metadata.

## Draw transitions as part of the performance

Plan named entry/exit poses and prop states before producing frames. Draw anticipation, action, recovery, and the transition back to a usable idle. Preserve eye direction, ground contact, canvas scale, and prop continuity.

- `transitions[].from` and `to` are **pose IDs**, not clip IDs. `clip` references an existing bridge clip whose `entryPose` and `exitPose` match them exactly.
- Looping clips require identical `entryPose` and `exitPose` labels **and a visually seamless last-to-first boundary**. Equal labels cannot conceal mismatched artwork.
- Different poses need drawn bridge frames in both required directions, including costume changes. Keep routes short; the current player searches at most eight bridge clips.
- Only declare an `interruptMarkers` marker where the drawn pose can safely join the outgoing bridge. A marker is not automatic pose interpolation.
- Missing bridges hold the current pose. The player decodes the bridge and next clip before switching. Do not rely on an abrupt replacement, fade, blank frame, or double exposure to hide a missing bridge.

## Build the pack

The archive root is the character folder itself:

```text
character.json
checksums.json                 # optional; regenerate if present
clips/idle/frames.json
clips/idle/idle-01.png
clips/typing/frames.json
clips/typing/typing-01.png     # and the actual remaining frames
clips/neutral-to-typing/frames.json
```

All `sequence` and `file` paths are relative to this root, including paths written inside a nested `frames.json`. Use forward slashes and exact filename case. No absolute paths, URLs, `..`, backslashes, colons, symlinks, duplicate archive entries, scripts, or executables.

A minimal **held-pose structure example**, not a completed animation:

```json
{
  "schemaVersion": 1,
  "packId": "my-vivi",
  "packVersion": "1.0.0",
  "minAppVersion": "0.1.0",
  "name": {"ko": "나의 VIVI", "ja": "マイ VIVI", "en": "My VIVI"},
  "canvas": {"width": 1024, "height": 896},
  "defaultDisplayHeight": 160,
  "anchor": {"x": 0.5, "y": 0.915},
  "bubbleAnchor": {"x": 0.48, "y": 0.52},
  "clips": {
    "idle": {"frameCount": 1, "sequence": "clips/idle/frames.json", "entryPose": "neutral", "exitPose": "neutral", "loop": true}
  },
  "transitions": [],
  "eventBindings": {"idle": ["idle"]},
  "fallbacks": {"chat.waiting": "idle"}
}
```

Its `clips/idle/frames.json` is:

```json
{"frames":[{"file":"clips/idle/idle-01.png","durationMs":1000,"marker":"rest"}]}
```

Replace the canvas, anchors, identity, and files with the actual character. Add `author` and an accurate `license`. Choose your own `packId`; increment `packVersion` for changed content. An installed ID/version must not be overwritten with different bytes. `minAppVersion` must be valid semantic versioning supported by the target app.

### Limits and bindings

- `packId`, `packVersion`, clip IDs, and variant IDs: 1–100 ASCII letters/digits or `.`, `_`, `-`; never `.` or `..` alone.
- Same-sized transparent PNG or WebP frames; width and height each 1–2048. `defaultDisplayHeight`: 80–320 px, normally 160 px. Source pixels and desktop display pixels are separate.
- 1–512 clips; 1–240 frames per clip; `frameCount` equals the `frames` array length. Each `durationMs`: 16–30,000. A frame can optionally override normalized `anchor` and `bubbleAnchor`; so can its sequence.
- Coordinates are finite values in 0–1. Optional `hitArea` uses normalized `x`, `y`, `width`, `height`, positive dimensions, and fits inside the canvas. Place the bubble origin near the mouth without covering the character.
- Each JSON file ≤1 MiB; each archive file ≤32 MiB; expanded archive ≤512 MiB; ≤8192 ZIP entries. These are ceilings, not performance targets. Prefer smaller frames and measured memory use at desktop scale.
- `eventBindings.idle` is required. Every bound clip must exist. A fallback maps **event to event**, ends at a bound event, and must not form a cycle. A new JSON key does not add a new app feature.

Use the current guide/app's event names. Common bindings:

A clip contains artwork; an event describes an application state. Multiple events can use the same artwork. Both direct bindings and fallback mappings are listed.

Use fallback events for unproduced motions and describe that coverage honestly. Use only the events provided for normal question-and-answer chat.

### Optional wardrobe and time variants

`variants` can select existing clips through `clipBindings`, with `priority`, `locales` (`ko`, `ja`, `en`, `*`), `regions` (such as `KR`, `JP`, `US`, `GB`), `weekdays` (Sunday 0–Saturday 6), and local-PC `hours` (start inclusive, end exclusive; `[22,6]` crosses midnight). Add real full-body costume art and dressing/undressing bridges; never recolor a still and call it a new motion.

For holidays use fixed `dates` (`MM-DD`), verified `resolvedDates` (`YYYY-MM-DD`), or the app's `nationalHolidays: true` data with explicit regions. Language is not country. Do not rely on `holidayKeys` alone to resolve a date. The current guide describes bundled national dates for KR/JP/US/GB in 2026–2027; later years, local exceptions, and newly announced dates need updated data. Respect the user's holiday toggle and avoid celebratory dress for memorial dates. Christmas can use a separate `dates: ["12-25"]` variant. Limit variants to 128 and test return to the base outfit.

## Validate, preview, and package

1. Inspect every frame on checkerboard, white, and dark backgrounds. Remove background halos, leftover matte, accidental holes, and clipped ears/limbs/props; preserve intentional translucent effects. Use genuine alpha transparency, not a painted checkerboard.
2. Preview at **160 px display height**, then the chosen 80–320 px size. Inspect natural proportions, readable expressions, keyboard contact, ground alignment, and unclipped props. Play multiple loops, all transitions both ways, interruptions/resume, and wardrobe changes. No flicker, origin jumps, sudden scale changes, blank frames, or ghosted double images. The visual review is separate from JSON validation.
3. Check the downloaded schema and all referenced files, dimensions, counts, timings, transitions, fallback termination, and hashes. In a VIVI source checkout, run `cargo run --manifest-path crates/avatar/Cargo.toml --example validate -- /absolute/path/to/pack 0.1.2`. Otherwise use the installed app's import validation. State which checks actually ran; do not claim cross-OS testing unless performed.
4. Package **the contents** of the pack folder, with `character.json` directly at ZIP root, and rename to `my-vivi-1.0.0.vivipack`. No enclosing `my-vivi/` directory in the archive. Exclude temporary generation files and `.DS_Store`. Recalculate `checksums.json` as a root-relative filename → lowercase SHA-256 map after every edit, excluding the checksum file itself; it can be omitted for a personal pack.
5. Deliver the real `.vivipack`, editable source folder, contact sheet, a loop/transition preview, and a concise validation report with implemented motions, fallbacks, remaining gaps, and file size. A video preview alone is not the desktop character asset.

## Apply on desktop

VIVI requires VORA account verification before use. Right-click VIVI → Character → Import pack, or Open character folder to find the exact current `app_data` path. Do not edit built-in resources inside the app installation. Direct-copy layout is `<characters>/<packId>/<packVersion>/character.json`; refresh the list and select the new pack. Bad imports keep the current character.

| OS | Default character folder |
| --- | --- |
| macOS | `~/Library/Application Support/im.vora.vivi/characters/` |
| Windows | `%APPDATA%\im.vora.vivi\characters\` |
| Linux | `~/.local/share/im.vora.vivi/characters/` |

On Linux, `$XDG_DATA_HOME/im.vora.vivi/characters/` takes precedence when `XDG_DATA_HOME` is set. The app's Open character folder action is authoritative on every OS. Creating a pack does not require changing authentication, provider keys, servers, or app source.

<!-- complete-motion-reference:start -->

## 5 new idle activities · 2 grooming motions · 1 travel airplane

Get ready → Enjoy the motion → Tidy up and return

During daytime, evening and awake weekend hours, play and grooming take turns without immediate repeats, returning to the previous outfit to rest. Travel, hotel and flight-booking questions start the airplane performance through the answer, then return on completion or cancellation.

Default pack 0.2.7 requires VORA VIVI 0.1.5 or later. Setup, motion and return are connected with full-body drawings.

### Take off with a travel question

Travel, hotel and flight-booking questions start an airplane performance that continues through the answer and then returns.

## Busy paws, until the PC task is done.

Type on a laptop, search with a magnifier, carry boxes and drive a little truck. Local and remote CUA take turns using these work performances while a task is active. The animation is not a measure of actual progress.

Start a task → Work with props → Confirm the result → Return to the previous outfit

This CUA work cycle is available from app 0.1.3 and reuses the pack’s existing work performances and bridges. The newly drawn update placard is covered in Update notices and progress.

- Instead of looping one short action, shuffle the playable performances and show each once per round. Avoid immediately repeating an action when there are multiple candidates.
- When permission is needed, switch to approval-waiting. Show completion only after confirmed success; errors, partial work and cancellation must not look successful.
- Finish the full-body prop cleanup and terminal performance before returning to idle. Late signals from an older task cannot interrupt a newer task.
- Reduced motion holds a complete frame. Turning it off resumes movement only if the task is still active.

### Let your own character get to work

Connect your own clip names through eventBindings; built-in VIVI clip names are not required. Gather and deduplicate the clips bound to the semantic events below. Select only performances with authored full-body paths from the current pose and back to the current outfit.

Single stills and performances without a return path are excluded from the cycle. Use an ordinary bound CUA/idle fallback or retain the current frame. Do not invent missing bridges with fades or joint rigs.

| Event | Behavior |
| --- | --- |
| `cua.working` | Work cycle — artwork bound to sourceEvents below |
| `cua.local.working` | Work cycle — artwork bound to sourceEvents below |
| `cua.remote.working` | Work cycle — artwork bound to sourceEvents below |
| `cua.awaiting-approval` | Wait for approval; interrupt work cycling |
| `cua.complete` | Confirmed success → one completion performance → idle |
| `cua.error` | Error or partial work → error performance → idle |
| `cua.cancelled` | Stop or cancel → return performance → idle |
| `cua.remote.complete` | Confirmed success → one completion performance → idle |
| `cua.remote.error` | Error or partial work → error performance → idle |
| `cua.remote.cancelled` | Stop or cancel → return performance → idle |

### Semantic events that supply work candidates

```json
{
  "schemaVersion": 1,
  "runtimeMinVersion": "0.1.3",
  "artworkPackVersion": "0.2.5",
  "newArtwork": false,
  "workEvents": [
    "cua.working",
    "cua.local.working",
    "cua.remote.working"
  ],
  "sourceEvents": [
    "cua.working",
    "chat.waiting",
    "chat.waiting.searching",
    "file.uploading",
    "file.uploading.single",
    "file.uploading.multiple"
  ],
  "approvalEvent": "cua.awaiting-approval",
  "terminalEvents": [
    "cua.complete",
    "cua.error",
    "cua.cancelled",
    "cua.remote.complete",
    "cua.remote.error",
    "cua.remote.cancelled"
  ],
  "fallbacks": {
    "cua.local.working": "cua.working",
    "cua.remote.working": "cua.working",
    "cua.error": "chat.error",
    "cua.cancelled": "chat.cancelled",
    "cua.remote.complete": "cua.complete",
    "cua.remote.error": "cua.error",
    "cua.remote.cancelled": "cua.cancelled"
  },
  "rules": {
    "resolve": "eventBindings, variant clipBindings, explicit fallbacks, runtime fallbacks",
    "selection": "deduplicate actual clips; shuffled rounds; no immediate repeat when multiple reachable choices exist",
    "performance": "one full-body action per choice; repeat choices until explicit lifecycle terminal or interruption",
    "routes": "authored full-body routes to the action and back to current outfit; unreachable/still-only choices excluded",
    "terminal": "explicit success only; partial/error must not play success; stop cancels cycle; terminal performance completes before idle",
    "scope": "local and remote share playback; stale account/job/sequence callbacks ignored",
    "reducedMotion": "hold a complete frame; resume only while task remains active",
    "missing": "ordinary bound CUA/idle fallback or retain current full frame; never invent a transition"
  }
}
```

[Download all CUA events and playback rules](https://vivi.vora.im/downloads/cua-animation-events.json)

## Update notices and progress

When an update is available, VIVI holds a placard to let you know. The update icon beside the character stays in place. Click that icon to start the update; clicking the placard or character does not start it.

Placard notice → Click the icon → Download and prepare → Restart → Complete

Show a percentage when the download size is known, and show stages for installation preparation and restart. Active work and input are allowed to finish safely. If an error occurs, retry from the progress view.

Show the completion performance only after confirming that the new version has started. Finishing a download does not mean the update is complete.

Automatic update-placard integration requires app 0.1.5 or later. Check support in both the installed app and the selected character pack.

### Bindings for character creators

- update.sign is a full-body loop that keeps the placard in view. Include full-body bridges from neutral and back.
- Bind update.available and update.working to the placard performance to keep it visible through preparation. Progress events must not restart the animation.
- Bind update.complete to the completion performance after the new version is confirmed. Bind update.error to an error performance.
- Dragging and active computer work take priority. Keep the previous frame until the next artwork is ready, and respect reduced motion.

## Every added action and bridge through 0.2.7

The table includes every added performance and bridge. New unique paintings, shared whole drawings and held-frame slots are counted separately; shared or duplicated images do not inflate new artwork counts.

| Clip | Action and props | Binding | New unique / shared drawings / holds | Current state |
| --- | --- | --- | --- | --- |
| news.reporter | News reporter | answer.news · news.reporter.ready → news.reporter.ready | 12 / 0 / 0 | Included in default pack |
| transition.news.reporter.enter | News reporter · enter | neutral → news.reporter.ready | 10 / 2 / 0 | Included in default pack |
| transition.news.reporter.exit | News reporter · return | news.reporter.ready → neutral | 0 / 12 / 0 | Included in default pack |
| weather.default | Weather board | answer.weather · weather.default.ready → weather.default.ready | 9 / 0 / 0 | Included in default pack |
| transition.weather.default.enter | Weather board · enter | neutral → weather.default.ready | 10 / 2 / 0 | Included in default pack |
| transition.weather.default.exit | Weather board · return | weather.default.ready → neutral | 10 / 2 / 0 | Included in default pack |
| weather.rain | Rain with an umbrella | answer.weather.rain · weather.rain.ready → weather.rain.ready | 11 / 0 / 0 | Included in default pack |
| transition.weather.rain.enter | Rain with an umbrella · enter | neutral → weather.rain.ready | 10 / 2 / 0 | Included in default pack |
| transition.weather.rain.exit | Rain with an umbrella · return | weather.rain.ready → neutral | 10 / 2 / 0 | Included in default pack |
| weather.hot | Cooling down with a fan | answer.weather.hot · weather.hot.ready → weather.hot.ready | 10 / 0 / 0 | Included in default pack |
| transition.weather.hot.enter | Cooling down with a fan · enter | neutral → weather.hot.ready | 10 / 2 / 0 | Included in default pack |
| transition.weather.hot.exit | Cooling down with a fan · return | weather.hot.ready → neutral | 10 / 2 / 0 | Included in default pack |
| weather.wind | Bracing against the wind | answer.weather.wind · weather.wind.ready → weather.wind.ready | 12 / 0 / 0 | Included in default pack |
| transition.weather.wind.enter | Bracing against the wind · enter | neutral → weather.wind.ready | 10 / 2 / 0 | Included in default pack |
| transition.weather.wind.exit | Bracing against the wind · return | weather.wind.ready → neutral | 0 / 12 / 0 | Included in default pack |
| wardrobe.spring | Spring jacket | idle.season.spring · season-spring · wardrobe.spring.ready → wardrobe.spring.ready | 12 / 0 / 0 | Included in default pack |
| transition.wardrobe.spring.enter | Spring jacket · enter | season-spring · neutral → wardrobe.spring.ready | 10 / 2 / 0 | Included in default pack |
| transition.wardrobe.spring.exit | Spring jacket · return | season-spring · wardrobe.spring.ready → neutral | 10 / 2 / 0 | Included in default pack |
| wardrobe.summer | Summer shirt | idle.season.summer · season-summer · wardrobe.summer.ready → wardrobe.summer.ready | 12 / 0 / 0 | Included in default pack |
| transition.wardrobe.summer.enter | Summer shirt · enter | season-summer · neutral → wardrobe.summer.ready | 10 / 2 / 0 | Included in default pack |
| transition.wardrobe.summer.exit | Summer shirt · return | season-summer · wardrobe.summer.ready → neutral | 10 / 2 / 0 | Included in default pack |
| wardrobe.autumn | Autumn cardigan and scarf | idle.season.autumn · season-autumn · wardrobe.autumn.ready → wardrobe.autumn.ready | 11 / 0 / 0 | Included in default pack |
| transition.wardrobe.autumn.enter | Autumn cardigan and scarf · enter | season-autumn · neutral → wardrobe.autumn.ready | 10 / 2 / 0 | Included in default pack |
| transition.wardrobe.autumn.exit | Autumn cardigan and scarf · return | season-autumn · wardrobe.autumn.ready → neutral | 10 / 2 / 0 | Included in default pack |
| wardrobe.winter | Winter vest and scarf | idle.season.winter · season-winter · wardrobe.winter.ready → wardrobe.winter.ready | 12 / 0 / 0 | Included in default pack |
| transition.wardrobe.winter.enter | Winter vest and scarf · enter | season-winter · neutral → wardrobe.winter.ready | 0 / 12 / 0 | Included in default pack |
| transition.wardrobe.winter.exit | Winter vest and scarf · return | season-winter · wardrobe.winter.ready → neutral | 10 / 2 / 0 | Included in default pack |
| wardrobe.morning | Morning cardigan | idle.daypart.morning · daypart-morning · wardrobe.morning.ready → wardrobe.morning.ready | 12 / 0 / 0 | Included in default pack |
| transition.wardrobe.morning.enter | Morning cardigan · enter | daypart-morning · neutral → wardrobe.morning.ready | 0 / 10 / 0 | Included in default pack |
| transition.wardrobe.morning.exit | Morning cardigan · return | daypart-morning · wardrobe.morning.ready → neutral | 8 / 2 / 0 | Included in default pack |
| wardrobe.day | Daytime work vest | idle.daypart.day · daypart-day · wardrobe.day.ready → wardrobe.day.ready | 12 / 0 / 0 | Included in default pack |
| transition.wardrobe.day.enter | Daytime work vest · enter | daypart-day · neutral → wardrobe.day.ready | 9 / 2 / 0 | Included in default pack |
| transition.wardrobe.day.exit | Daytime work vest · return | daypart-day · wardrobe.day.ready → neutral | 10 / 2 / 0 | Included in default pack |
| wardrobe.evening | Evening loungewear | idle.daypart.evening · daypart-evening · wardrobe.evening.ready → wardrobe.evening.ready | 10 / 0 / 0 | Included in default pack |
| transition.wardrobe.evening.enter | Evening loungewear · enter | daypart-evening · neutral → wardrobe.evening.ready | 9 / 2 / 0 | Included in default pack |
| transition.wardrobe.evening.exit | Evening loungewear · return | daypart-evening · wardrobe.evening.ready → neutral | 9 / 2 / 0 | Included in default pack |
| file.truck | Delivery truck with multiple boxes | file.uploading.multiple · file.saving.multiple · file.truck.ready → file.truck.ready | 11 / 0 / 0 | Included in default pack |
| transition.file.truck.enter | Delivery truck with multiple boxes · enter | neutral → file.truck.ready | 9 / 2 / 0 | Included in default pack |
| transition.file.truck.exit | Delivery truck with multiple boxes · return | file.truck.ready → neutral | 0 / 11 / 0 | Included in default pack |
| academic.research | Mortarboard, papers and magnifier | answer.academic.paper · answer.academic.patent · academic.research.ready → academic.research.ready | 12 / 0 / 0 | Included in default pack |
| transition.academic.research.enter | Mortarboard, papers and magnifier · enter | neutral → academic.research.ready | 10 / 2 / 0 | Included in default pack |
| transition.academic.research.exit | Mortarboard, papers and magnifier · return | academic.research.ready → neutral | 0 / 12 / 0 | Included in default pack |
| night.sleep | Sleeping in bedding | idle.sleep · night · night.sleep.ready → night.sleep.ready | 11 / 0 / 0 | Included in default pack |
| transition.night.sleep.enter | Sleeping in bedding · enter | night · wardrobe.night.neutral → night.sleep.ready | 9 / 2 / 0 | Included in default pack |
| transition.night.sleep.exit | Sleeping in bedding · return | night · night.sleep.ready → wardrobe.night.neutral | 0 / 11 / 0 | Included in default pack |
| morning.wake | Wake, rub eyes and stretch | morning.wake · daypart-morning · morning.wake.seated → morning.wake.standing | 12 / 0 / 0 | Included in default pack |
| transition.morning.wake.enter | Wake, rub eyes and stretch · enter | daypart-morning · wardrobe.morning.ready → morning.wake.seated | 9 / 2 / 0 | Included in default pack |
| transition.morning.wake.exit | Wake, rub eyes and stretch · return | daypart-morning · morning.wake.standing → wardrobe.morning.ready | 9 / 2 / 0 | Included in default pack |
| idle.desk-rest | Resting at a desk and chair | idle.desk-rest · idle.desk-rest.ready → idle.desk-rest.ready | 12 / 0 / 0 | Included in default pack |
| transition.idle.desk-rest.enter | Resting at a desk and chair · enter | neutral → idle.desk-rest.ready | 10 / 2 / 0 | Included in default pack |
| transition.idle.desk-rest.exit | Resting at a desk and chair · return | idle.desk-rest.ready → neutral | 0 / 12 / 0 | Included in default pack |
| idle.dance | Full-body dancing with a speaker | idle.dance · idle.dance.ready → idle.dance.ready | 12 / 0 / 0 | Included in default pack |
| transition.idle.dance.enter | Full-body dancing with a speaker · enter | neutral → idle.dance.ready | 10 / 2 / 0 | Included in default pack |
| transition.idle.dance.exit | Full-body dancing with a speaker · return | idle.dance.ready → neutral | 0 / 12 / 0 | Included in default pack |
| idle.day.work | Working on a laptop at the desk | idle.day.work · daypart-day · idle.day.work.ready → idle.day.work.ready | 12 / 0 / 0 | Included in default pack |
| transition.idle.day.work.enter | Working on a laptop at the desk · enter | daypart-day · wardrobe.day.ready → idle.day.work.ready | 10 / 2 / 0 | Included in default pack |
| transition.idle.day.work.exit | Working on a laptop at the desk · return | daypart-day · idle.day.work.ready → wardrobe.day.ready | 0 / 12 / 0 | Included in default pack |
| idle.day.study | Studying with a book, notes and pencil | idle.day.study · daypart-day · idle.day.study.ready → idle.day.study.ready | 10 / 0 / 0 | Included in default pack |
| transition.idle.day.study.enter | Studying with a book, notes and pencil · enter | daypart-day · wardrobe.day.ready → idle.day.study.ready | 9 / 2 / 0 | Included in default pack |
| transition.idle.day.study.exit | Studying with a book, notes and pencil · return | daypart-day · idle.day.study.ready → wardrobe.day.ready | 0 / 11 / 0 | Included in default pack |
| stocks.briefing | Quote board, charts and pointer | answer.stocks · stocks.briefing.ready → stocks.briefing.ready | 12 / 0 / 0 | Included in default pack |
| transition.stocks.briefing.enter | Quote board, charts and pointer · enter | neutral → stocks.briefing.ready | 8 / 2 / 0 | Included in default pack |
| transition.stocks.briefing.exit | Quote board, charts and pointer · return | stocks.briefing.ready → neutral | 10 / 2 / 0 | Included in default pack |
| weather.snow | Catching snowflakes | answer.weather.snow · weather.snow.ready → weather.snow.ready | 11 / 0 / 0 | Included in default pack |
| transition.weather.snow.enter | Catching snowflakes · enter | neutral → weather.snow.ready | 10 / 2 / 0 | Included in default pack |
| transition.weather.snow.exit | Catching snowflakes · return | weather.snow.ready → neutral | 0 / 12 / 0 | Included in default pack |
| weather.cloudy | Cloudy-weather briefing | answer.weather.cloudy · weather.cloudy.ready → weather.cloudy.ready | 12 / 0 / 0 | Included in default pack |
| transition.weather.cloudy.enter | Cloudy-weather briefing · enter | neutral → weather.cloudy.ready | 14 / 2 / 0 | Included in default pack |
| transition.weather.cloudy.exit | Cloudy-weather briefing · return | weather.cloudy.ready → neutral | 0 / 16 / 0 | Included in default pack |
| weather.strongsun | Strong-sun shade briefing | answer.weather.clear · answer.weather.strongsun · weather.strongsun.ready → weather.strongsun.ready | 12 / 0 / 0 | Included in default pack |
| transition.weather.strongsun.enter | Strong-sun shade briefing · enter | neutral → weather.strongsun.ready | 7 / 2 / 0 | Included in default pack |
| transition.weather.strongsun.exit | Strong-sun shade briefing · return | weather.strongsun.ready → neutral | 0 / 9 / 0 | Included in default pack |
| weather.swimwear-hot | Hot weather in swimwear | answer.weather.hot · answer.weather.swimwearhot · weather.swimwear-hot.ready → weather.swimwear-hot.ready | 8 / 0 / 0 | Included in default pack |
| transition.weather.swimwear-hot.enter | Hot weather in swimwear · enter | neutral → weather.swimwear-hot.ready | 9 / 2 / 0 | Included in default pack |
| transition.weather.swimwear-hot.exit | Hot weather in swimwear · return | weather.swimwear-hot.ready → neutral | 0 / 11 / 0 | Included in default pack |
| idle.bubbles | Popping soap bubbles | idle.bubbles · bubbles.ready → bubbles.finished | 12 / 0 / 0 | Included in default pack |
| transition.idle.bubbles.enter | Popping soap bubbles · enter | neutral → bubbles.ready | 8 / 2 / 0 | Included in default pack |
| transition.idle.bubbles.exit | Popping soap bubbles · return | bubbles.finished → neutral | 9 / 2 / 0 | Included in default pack |
| idle.paper-plane | Flying a paper airplane | idle.paper-plane · paper-plane.ready → paper-plane.finished | 12 / 0 / 0 | Included in default pack |
| transition.idle.paper-plane.enter | Flying a paper airplane · enter | neutral → paper-plane.ready | 10 / 2 / 0 | Included in default pack |
| transition.idle.paper-plane.exit | Flying a paper airplane · return | paper-plane.finished → neutral | 10 / 2 / 0 | Included in default pack |
| idle.toy-fish | Catching a toy fish | idle.toy-fish · toy-fish.ready → toy-fish.finished | 12 / 0 / 0 | Included in default pack |
| transition.idle.toy-fish.enter | Catching a toy fish · enter | neutral → toy-fish.ready | 10 / 2 / 0 | Included in default pack |
| transition.idle.toy-fish.exit | Catching a toy fish · return | toy-fish.finished → neutral | 10 / 2 / 0 | Included in default pack |
| idle.box-peek | Peeking out of a little box | idle.box-peek · box-peek.ready → box-peek.finished | 12 / 0 / 0 | Included in default pack |
| transition.idle.box-peek.enter | Peeking out of a little box · enter | neutral → box-peek.ready | 10 / 2 / 0 | Included in default pack |
| transition.idle.box-peek.exit | Peeking out of a little box · return | box-peek.finished → neutral | 10 / 2 / 0 | Included in default pack |
| idle.yoyo | A sheepish yo-yo tangle | idle.yoyo · yoyo.ready → yoyo.tangled | 12 / 0 / 0 | Included in default pack |
| transition.idle.yoyo.enter | A sheepish yo-yo tangle · enter | neutral → yoyo.ready | 7 / 2 / 0 | Included in default pack |
| transition.idle.yoyo.exit | A sheepish yo-yo tangle · return | yoyo.tangled → neutral | 10 / 2 / 0 | Included in default pack |
| idle.scooter | Toy scooter | idle · idle.scooter · idle.scooter.ready → idle.scooter.ready | 12 / 0 / 0 | Included in default pack |
| transition.idle.scooter.enter | Toy scooter · enter | neutral → idle.scooter.ready | 12 / 2 / 0 | Included in default pack |
| transition.idle.scooter.exit | Toy scooter · return | idle.scooter.ready → neutral | 12 / 2 / 0 | Included in default pack |
| idle.mini-train | Tiny train driver | idle · idle.mini-train · idle.mini-train.ready → idle.mini-train.ready | 12 / 0 / 0 | Included in default pack |
| transition.idle.mini-train.enter | Tiny train driver · enter | neutral → idle.mini-train.ready | 12 / 2 / 0 | Included in default pack |
| transition.idle.mini-train.exit | Tiny train driver · return | idle.mini-train.ready → neutral | 12 / 2 / 0 | Included in default pack |
| idle.magnifier | Magnifying-glass explorer | idle · idle.magnifier · idle.magnifier.ready → idle.magnifier.ready | 12 / 0 / 0 | Included in default pack |
| transition.idle.magnifier.enter | Magnifying-glass explorer · enter | neutral → idle.magnifier.ready | 12 / 2 / 0 | Included in default pack |
| transition.idle.magnifier.exit | Magnifying-glass explorer · return | idle.magnifier.ready → neutral | 12 / 2 / 0 | Included in default pack |
| idle.magic-hat | Magic-hat surprise | idle · idle.magic-hat · idle.magic-hat.ready → idle.magic-hat.ready | 12 / 0 / 0 | Included in default pack |
| transition.idle.magic-hat.enter | Magic-hat surprise · enter | neutral → idle.magic-hat.ready | 12 / 2 / 0 | Included in default pack |
| transition.idle.magic-hat.exit | Magic-hat surprise · return | idle.magic-hat.ready → neutral | 12 / 2 / 0 | Included in default pack |
| idle.popcorn | Popcorn catch | idle · idle.popcorn · idle.popcorn.ready → idle.popcorn.ready | 12 / 0 / 0 | Included in default pack |
| transition.idle.popcorn.enter | Popcorn catch · enter | neutral → idle.popcorn.ready | 12 / 2 / 0 | Included in default pack |
| transition.idle.popcorn.exit | Popcorn catch · return | idle.popcorn.ready → neutral | 12 / 2 / 0 | Included in default pack |
| idle.groom-face | Paw and face wash | idle · idle.groom-face · idle.groom-face.ready → idle.groom-face.ready | 12 / 0 / 0 | Included in default pack |
| transition.idle.groom-face.enter | Paw and face wash · enter | neutral → idle.groom-face.ready | 12 / 2 / 0 | Included in default pack |
| transition.idle.groom-face.exit | Paw and face wash · return | idle.groom-face.ready → neutral | 12 / 2 / 0 | Included in default pack |
| idle.groom-tail | Body and tail grooming | idle · idle.groom-tail · idle.groom-tail.ready → idle.groom-tail.ready | 12 / 0 / 0 | Included in default pack |
| transition.idle.groom-tail.enter | Body and tail grooming · enter | neutral → idle.groom-tail.ready | 12 / 2 / 0 | Included in default pack |
| transition.idle.groom-tail.exit | Body and tail grooming · return | idle.groom-tail.ready → neutral | 12 / 2 / 0 | Included in default pack |
| travel.airplane | Little airplane trip | travel.airplane · travel.airplane.ready → travel.airplane.ready | 12 / 0 / 0 | Included in default pack |
| transition.travel.airplane.enter | Little airplane trip · enter | neutral → travel.airplane.ready | 12 / 2 / 0 | Included in default pack |
| transition.travel.airplane.exit | Little airplane trip · return | travel.airplane.ready → neutral | 12 / 2 / 0 | Included in default pack |


## Everyday performances by local time and season

Behaviour changes with the outfit: waking, rubbing eyes and stretching in the morning; desk work, study and breaks by day; rest, music and dancing in the evening; dozing and sleeping late at night. Shared idles also include paw grooming, boredom, inviting a question, rhythm and stretching. Randomly choose eligible performances. Play the wake-up once on entering that local morning.

Default periods are morning 05–10, day 10–17, evening 17–21 and night 21–05. An explicit hours condition in the selected pack takes precedence (the current default night outfit uses 22–06). Use PC-local time and safely interrupt idles for work, speech input or alerts.

## Multiple performances per topic, chosen at random.

Each eventBindings or variants[].clipBindings value is an array of clip IDs. Register multiple full-body performances for one topic; choose randomly among candidates reachable from the current pose. Avoid the last performance when alternatives exist; repetition is allowed with one candidate. Select on event entry, a new request or an idle refresh, never for every token or frame. Change only at a safe playback boundary.

Filter by time, season, region and outfit first. Prefer compatible variant artwork that preserves the current outfit; do not synthesize missing performances. Random selection affects presentation, not task results, upload progress or search scope.

```json
{
  "eventBindings": {
    "answer.news": [
      "news.reporter",
      "news.field",
      "news.desk"
    ],
    "answer.academic.paper": [
      "academic.read",
      "academic.notes"
    ],
    "answer.stocks": [
      "stocks.chart",
      "stocks.briefing"
    ]
  }
}
```

This fragment connects a new travel category with two performances. Merge it into the complete pack and create the actual artwork. Twelve frames is illustrative; use the approved count. Downloading JSON alone does not create the artwork.

## Animations driven by questions and answers

Explore every answer type, multiple-file performance, everyday prop, outfit and entry/return bridge in the full pack. Artwork and actual app bindings are marked separately.

Built-in styles cover weather, news, patents and academic papers, and stocks. Selection requires both the request intent and actual MAIN tool-result evidence. A mention in a translation, an existing document summary, or unrelated prose does not qualify. Without evidence, keep the normal answer performance.

Classification uses completed, real tool output. Before the first token use waiting/search performances; while streaming use the normal answer performance. Switch through a bridge only after the verified style arrives.

| Trigger | Full-body performance and props | Event | Current display / dedicated clip |
| --- | --- | --- | --- |
| General weather (default) | Unfold and point to a weather board | answer.weather | Dedicated artwork included · weather.default / weather.default |
| Rain (rain) | Open and hold an umbrella, dodge raindrops | answer.weather.rain | Dedicated artwork included · weather.rain / weather.rain |
| Snow (snow) | Catch and examine snowflakes beneath a snow cloud | answer.weather.snow | Dedicated artwork included · weather.snow / weather.snow |
| Cold (cold) | Share winter artwork: warm and rub paws | answer.weather.cold | Dedicated artwork included · wardrobe.winter / wardrobe.winter |
| Heat · swimwear (hot) | Randomly choose swimwear with a ring and fan or the previous fan performance | answer.weather.hot | Dedicated artwork included · weather.swimwear-hot / weather.swimwear-hot, weather.hot |
| Wind (wind) | Hold onto a windblown prop and brace the body | answer.weather.wind | Dedicated artwork included · weather.wind / weather.wind |
| Clear · strong sun (clear) | Shade the face with a sun visor beneath the sun | answer.weather.clear | Dedicated artwork included · weather.strongsun / weather.strongsun |
| Cloudy (cloudy) | Look at a large cloud and explain with whole-body gestures | answer.weather.cloudy | Dedicated artwork included · weather.cloudy / weather.cloudy |
| Spring weather (spring) | Share the completed spring-jacket performance and authored routes | answer.weather.spring | Dedicated artwork included · wardrobe.spring / wardrobe.spring |
| Autumn weather (autumn) | Share the completed autumn cardigan/scarf performance and authored routes | answer.weather.autumn | Dedicated artwork included · wardrobe.autumn / wardrobe.autumn |
| News search (default) | Use a reporter microphone, news sheets and desk | answer.news | Dedicated artwork included · news.reporter / news.reporter |
| Patent search (patent) | Mortarboard, patent drawings and a magnifier | answer.academic.patent | Dedicated artwork included · academic.research / academic.research |
| Academic-paper search (paper) | Mortarboard, paper stack and magnifier; turn pages | answer.academic.paper | Dedicated artwork included · academic.research / academic.research |
| Stocks and market-price questions (default) | Explain using a quote board, chart and pointer; no trading action | answer.stocks | Dedicated artwork included · stocks.briefing / stocks.briefing |

Apply only while this answer is displayed. Clear on the next question, new conversation, logout or account change, restoring the prior outfit and rejecting late results. Keep this separate from seasonal, time-of-day and holiday outfits. Do not look up background location merely to choose weather artwork.

Every new prop performance includes full-body bridges: neutral → prepare/board/dress → perform → tidy/exit/undress → neutral. Test restoration to the preceding seasonal or holiday outfit. Hold the current frame until the next artwork is ready; never flash between poses.

## One file, one box. Multiple files, a delivery truck.

Choose by the validated file count at the start of the batch. Do not switch from truck to box when only one file remains. Keep the performance through completion; added files belong to a subsequent batch.

| Trigger | Full-body performance and props | Event | Current display / dedicated clip |
| --- | --- | --- | --- |
| Upload one file | Carry a single box | file.uploading.single | Dedicated artwork included · file.carry / file.uploading → file.carry |
| Upload two or more files | Load several boxes into a delivery truck and drive | file.uploading.multiple | Dedicated artwork included · file.truck / file.truck |
| Save and organize one file | Carry and lower one box into place | file.saving.single | Dedicated artwork included · file.carry / file.saving → file.carry |
| Save and organize multiple files | Deliver and unload several boxes using the truck | file.saving.multiple | Dedicated artwork included · file.truck / file.truck |

### Props are part of the action.

As with typing on a laptop, paws, gaze, head, torso and feet act together: lift a box, hold the steering wheel, turn a page, look through a magnifier, point to a chart. Floating icons or sliding a still image are not substitutes. Preserve props and their contact points across transparent frames and transitions.

### Seasonal and time-of-day artwork is included too.

The full pack includes spring/summer/autumn/winter and morning/day/evening outfits, everyday performances, news, weather, research, stocks and the truck, with every entry and return bridge. Authored full-body routes connect the base outfits and indoor prop performances.

## Add your own question-and-answer categories

### Register the category and artwork in the pack

In character.json, define answerCategories with a new ID, localized names, a question-and-answer description, request examples and evidence hints. Bind multiple full-body clips and entry/return bridges to answer.custom.<id>. Import the pack to add a new category and its performances without rebuilding the app.

### Select only after checking the request and actual answer

evidenceSource: "answer" uses the real request and completed answer; "tool-result" uses the request and actual MAIN tool output. The default is answer. Select only registered categories; keep normal animation when none matches. Pack definitions are cosmetic data and cannot execute code, tools or permissions. Built-in weather, news, academic and stock evidence rules remain intact.

### Adding an answer type, from detection to restoration

1. **Choose a category ID and names** — Add an id and ko/ja/en names to answerCategories. IDs start with a lowercase letter and contain lowercase letters, digits or hyphens, up to 40 characters; allow up to 16 categories per pack.
2. **Describe when it matches** — Describe the intended Q&A in description and provide 1–6 queryExamples and evidenceHints each. Choose evidenceSource:answer for answer styles or tool-result when actual search results are required.
3. **Draw several full-body performances** — Create several full-body performances for the category. Preserve paw contact, gaze, body, feet and props, including drawn entrances and returns.
4. **Bind the event array** — Register actual sequences in clips and add their IDs to eventBindings["answer.custom.<id>"]. Choose randomly among playable candidates and avoid immediate repeats.
5. **Connect bridges and a fallback** — Register full-body transitions to and from each candidate. If dedicated artwork is unavailable, declare chat.streaming as the fallback and never reference a missing clip.
6. **Verify matching, selection and restoration** — Try both matching and non-matching requests. Verify late-result rejection and prior-outfit restoration after the next question or an account, conversation or pack change.
7. **Import the complete pack** — Bump packVersion, update checksums.json and import the .vivipack. Include all existing motions, new categories, artwork and bridges. Do not edit app code or embed API keys.

This fragment connects a new travel category with two performances. Merge it into the complete pack and create the actual artwork. Twelve frames is illustrative; use the approved count. Downloading JSON alone does not create the artwork.

```json
{
  "exampleOnly": true,
  "characterFragment": {
    "answerCategories": [
      {
        "id": "travel",
        "name": {
          "ko": "여행 안내",
          "ja": "旅行ガイド",
          "en": "Travel guide"
        },
        "description": "Travel itinerary or sightseeing advice with a concrete destination and a completed itinerary.",
        "queryExamples": [
          "제주 2일 여행 코스를 추천해 줘",
          "Suggest a two-day sightseeing itinerary"
        ],
        "evidenceHints": [
          "The completed answer includes destinations and a concrete itinerary, not merely a mention of travel."
        ],
        "evidenceSource": "answer"
      }
    ],
    "clips": {
      "travel.guide": {
        "frameCount": 12,
        "sequence": "clips/travel.guide/frames.json",
        "entryPose": "travel.ready",
        "exitPose": "travel.ready",
        "loop": true,
        "propState": "map-in-paws"
      },
      "travel.map": {
        "frameCount": 12,
        "sequence": "clips/travel.map/frames.json",
        "entryPose": "travel.ready",
        "exitPose": "travel.ready",
        "loop": true,
        "propState": "map-in-paws"
      },
      "travel.enter": {
        "frameCount": 12,
        "sequence": "clips/travel.enter/frames.json",
        "entryPose": "neutral",
        "exitPose": "travel.ready",
        "loop": false
      },
      "travel.exit": {
        "frameCount": 12,
        "sequence": "clips/travel.exit/frames.json",
        "entryPose": "travel.ready",
        "exitPose": "neutral",
        "loop": false
      }
    },
    "eventBindings": {
      "answer.custom.travel": [
        "travel.guide",
        "travel.map"
      ]
    },
    "fallbacks": {
      "answer.custom.travel": "chat.streaming"
    },
    "transitions": [
      {
        "from": "neutral",
        "to": "travel.ready",
        "clip": "travel.enter"
      },
      {
        "from": "travel.ready",
        "to": "neutral",
        "clip": "travel.exit"
      }
    ]
  }
}
```

[Extension design JSON](https://vivi.vora.im/downloads/answer-style-extension.example.json)

### Acceptance criteria for a new performance

- Matching request plus real tool evidence selects the style; mere mentions, translations or missing evidence do not.
- No stale performance returns after the next question, cancellation, new conversation, logout or account change.
- Inspect loops, entry/exit, interruption and return, and round trips to seasonal/holiday outfits.
- Inspect alpha edges, face, ears, limbs and props at 160px on light and dark backgrounds.
- Play one preview at a time. Distinguish actual artwork, runtime wiring, previews and work in production.

## Every event: current bindings and extension triggers

This includes default-pack bindings as well as registered answer styles and single/multiple-file events. Where dedicated art is missing, the current fallback path is shown. Preview-only clips are marked separately in the complete artwork catalogue below.

| Event | Current display / dedicated clip |
| --- | --- |
| idle | idle.neutral, idle.rest, idle.doze, idle.groom, idle.invite, idle.rhythm, idle.stretch, idle.bored, idle.scooter, idle.mini-train, idle.magnifier, idle.magic-hat, idle.popcorn, idle.groom-face, idle.groom-tail |
| chat.waiting | work.typing |
| chat.waiting.long | work.search |
| chat.complete | complete.jump |
| chat.error | error.recover |
| chat.cancelled | idle.neutral |
| input.listening | input.listen |
| file.uploading | file.carry |
| file.saving | file.carry |
| notification | notification.announce |
| calendar.reminder | notification.announce |
| cua.working | Work cycle — artwork bound to sourceEvents below |
| cua.awaiting-approval | Wait for approval; interrupt work cycling |
| update.available | update.sign |
| drag.held | drag.held |
| drag.released | idle.neutral |
| tts.speaking | tts.speak |
| chat.streaming | answer.streaming |
| media.image | media.image |
| media.video | media.video |
| media.audio | media.audio |
| data.table | data.table |
| media.image.wait | media.image.wait |
| media.video.wait | media.video.wait |
| media.audio.wait | media.audio.wait |
| chat.waiting.very-long | chat.waiting.very-long |
| idle.inviting | idle.invite |
| idle.bored | idle.bored |
| idle.sleepy | idle.doze |
| idle.rest | idle.rest |
| idle.groom | idle.groom |
| idle.rhythm | idle.rhythm |
| idle.stretch | idle.stretch |
| idle.pencil | idle.bored |
| chat.waiting.searching | work.search |
| input.transcribing | chat.waiting.very-long |
| input.ready | friend.wave |
| input.error | error.recover |
| input.cancelled | idle.neutral |
| cua.complete | Confirmed success → one completion performance → idle |
| answer.news | news.reporter |
| answer.weather.wind | weather.wind |
| idle.season.spring | wardrobe.spring |
| idle.season.summer | wardrobe.summer |
| idle.season.autumn | wardrobe.autumn |
| idle.season.winter | wardrobe.winter |
| answer.weather.cold | wardrobe.winter |
| answer.weather.snow | weather.snow |
| idle.daypart.morning | wardrobe.morning |
| idle.daypart.day | wardrobe.day |
| idle.daypart.evening | wardrobe.evening |
| answer.weather | weather.default |
| answer.weather.rain | weather.rain |
| answer.weather.hot | weather.swimwear-hot, weather.hot |
| answer.stocks | stocks.briefing |
| answer.academic.paper | academic.research |
| answer.academic.patent | academic.research |
| idle.sleep | night.sleep |
| morning.wake | morning.wake |
| idle.desk-rest | idle.desk-rest |
| idle.dance | idle.dance |
| idle.day.work | idle.day.work |
| idle.day.study | idle.day.study |
| file.uploading.multiple | file.truck |
| file.saving.multiple | file.truck |
| answer.weather.cloudy | weather.cloudy |
| answer.weather.clear | weather.strongsun |
| answer.weather.strongsun | weather.strongsun |
| answer.weather.swimwearhot | weather.swimwear-hot |
| answer.weather.spring | wardrobe.spring |
| answer.weather.autumn | wardrobe.autumn |
| idle.bubbles | idle.bubbles |
| idle.paper-plane | idle.paper-plane |
| idle.toy-fish | idle.toy-fish |
| idle.box-peek | idle.box-peek |
| idle.yoyo | idle.yoyo |
| update.sign | update.sign |
| update.working | update.sign |
| update.complete | complete.jump |
| update.error | error.recover |
| idle.scooter | idle.scooter |
| idle.mini-train | idle.mini-train |
| idle.magnifier | idle.magnifier |
| idle.magic-hat | idle.magic-hat |
| idle.popcorn | idle.popcorn |
| idle.groom-face | idle.groom-face |
| idle.groom-tail | idle.groom-tail |
| travel.airplane | travel.airplane |
| data.chart | data.table → data.table |
| file.uploading.single | file.uploading → file.carry |
| file.saving.single | file.saving → file.carry |
| cua.local.working | Work cycle — artwork bound to sourceEvents below |
| cua.remote.working | Work cycle — artwork bound to sourceEvents below |
| cua.error | Error or partial work → error performance → idle |
| cua.cancelled | Stop or cancel → return performance → idle |
| cua.remote.complete | Confirmed success → one completion performance → idle |
| cua.remote.error | Error or partial work → error performance → idle |
| cua.remote.cancelled | Stop or cancel → return performance → idle |

## Complete extension field reference

### character.json

| Field | Purpose |
| --- | --- |
| schemaVersion | Schema version |
| packId | Unique pack ID |
| packVersion | Resource version |
| minAppVersion | Minimum app version |
| name | Localized display names |
| author | Author |
| license | Artwork license |
| canvas | Shared frame dimensions |
| defaultDisplayHeight | Desktop display height |
| anchor | Foot anchor |
| bubbleAnchor | Bubble origin |
| hitArea | Click/drag area |
| clips | Artwork clips |
| transitions | Pose bridges |
| eventBindings | Application event→clip |
| fallbacks | Fallback event map |
| preview | Character-list preview |
| variants | Date/season/time/region outfits |
| answerCategories | Custom question-and-answer category definitions |

### clips.<id>

| Field | Purpose |
| --- | --- |
| frameCount | Actual frame count |
| sequence | frames.json path relative to pack root |
| entryPose | Entry-pose ID |
| exitPose | Exit-pose ID |
| loop | Loop flag; verify the boundary |
| propState | Prop-state description |
| interruptMarkers | Safe interruption-frame markers |

### variants[]

| Field | Purpose |
| --- | --- |
| id | Unique ID |
| regions | Country codes or * |
| locales | ko/ja/en/* |
| dates | Annual MM-DD dates |
| resolvedDates | Resolved YYYY-MM-DD dates |
| holidayKeys | Holiday identifiers; not an automatic date resolver |
| festive | Festive designation |
| nationalHolidays | Use national holiday data |
| weekdays | Sunday 0 through Saturday 6 |
| hours | Local start/end hours |
| priority | Priority among matching variants |
| clipBindings | Outfit-specific event→clip |
| months | Months 1–12 |
| seasons | Spring/summer/autumn/winter |
| dayparts | Morning/day/evening/night |

### answerCategories[]

| Field | Purpose |
| --- | --- |
| id | Unique ID |
| name | Localized display names |
| description | Q&A match description, up to 600 characters |
| queryExamples | 1–6 request examples, 240 characters each |
| evidenceHints | 1–6 evidence hints, 240 characters each |
| evidenceSource | answer or tool-result; defaults to answer |

### frames.json → frames[]

| Field | Purpose |
| --- | --- |
| file | Image path relative to pack root |
| durationMs | Frame duration in ms |
| marker | Marker on an actual connectable pose |
| anchor | Foot anchor |
| bubbleAnchor | Bubble origin |


## Every animation in the default VIVI.

This inventory is generated from the entire default pack, not a selection of highlights. Inspect every action, outfit and bridge, and click to play one preview at a time.

Default pack: **0.2.7** · All clips: **180** · Bridge motions: **102**.

[Complete default manifest](https://vivi.vora.im/character-reference/default-character.json) · [JSON](https://vivi.vora.im/character-reference/catalogue.json)

| ID | Performance | frames / s | New / shared / held | Entry → exit pose | Play / stop |
| --- | --- | --- | --- | --- | --- |
| `idle.neutral` | Neutral idle — The default resting pose when no input is active, and the base pose to return to after other actions. **App-connected** | 12 / 3.2s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/9412c6241db48fca.webp) |
| `idle.bored` | Feeling bored — A bored idle for quiet periods. It also substitutes for the pencil-play event while that motion lacks prop bridges. **App-connected** | 12 / 3.2s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/fbc2850ca1db66a0.webp) |
| `input.listen` | Listening closely — Listens while the input bubble records speech. Recording completion switches to the separate transcription-wait event. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/0db51136524d2806.webp) |
| `tts.speak` | Speaking the summary — Used while TTS speaks a shortened summary. The complete text answer remains on screen. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/cc1b38550950cb57.webp) |
| `idle.rest` | Resting — A relaxed resting motion between tasks. **App-connected** | 12 / 4.1s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/f112726924f56721.webp) |
| `idle.doze` | Dozing — A dozing motion during inactive periods. **App-connected** | 12 / 3.9s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/faf8bbea9c14e888.webp) |
| `idle.groom` | Grooming a paw — An idle grooming motion that includes licking a paw. **App-connected** | 12 / 3.0s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/90095b95d02fa721.webp) |
| `idle.invite` | Inviting a question — An inviting idle that encourages a question without sending any message automatically. **App-connected** | 12 / 3.2s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/0194d3962d53c1dc.webp) |
| `idle.rhythm` | Keeping a rhythm — A rhythmic idle performance, independent of whether music is playing. **App-connected** | 12 / 2.6s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/fcd565ce78074f1a.webp) |
| `idle.pencil` | Playing with a pencil — A pencil-play artwork preview. Automatic playback is disabled until matching prop-entry and exit bridges exist. **Preview only** | 12 / 2.8s / Loop | — | `pencil.ground` → `pencil.ground` | [Play / stop](https://vivi.vora.im/character-reference/711fab955741f3eb.webp) |
| `idle.stretch` | Full-body stretch — A full-body stretch involving the body and both front and rear paws. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/40e3fe211cc74a80.webp) |
| `work.typing` | Typing on the laptop — The initial waiting performance before a response arrives, with the front paws directed toward the laptop keyboard. **App-connected** | 12 / 1.4s / Loop | — | `typing.ready` → `typing.ready` | [Play / stop](https://vivi.vora.im/character-reference/e90f9d45ddd2eccf.webp) |
| `work.search` | Searching for information — A searching performance during a longer first-response wait or search state. It does not represent a measured progress percentage. **App-connected** | 12 / 1.4s / Loop | — | `search.ground` → `search.ground` | [Play / stop](https://vivi.vora.im/character-reference/05e56558826f13cc.webp) |
| `file.carry` | Carrying file boxes — Carries one box for a single-file upload or save. Multiple files use the dedicated truck artwork. **App-connected** | 12 / 1.4s / Loop | — | `box.ground` → `box.ground` | [Play / stop](https://vivi.vora.im/character-reference/ad94efbd9ab943ff.webp) |
| `notification.announce` | Announcing with a megaphone — Uses a megaphone for service notifications, calendar reminders and update notices. The bubble identifies the notification type. **App-connected** | 12 / 1.4s / One-shot | — | `megaphone.ground` → `megaphone.ground` | [Play / stop](https://vivi.vora.im/character-reference/8a2407901c1ad1e4.webp) |
| `complete.jump` | Completion jump — A completion jump when a chat response or CUA task finishes. **App-connected** | 12 / 1.4s / One-shot | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/a49a240e3fcc2e68.webp) |
| `cua.approval` | Waiting for action approval — Used while CUA waits for approval of its next action. Approval-required actions are not executed during this wait. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/ef46a684befbae2a.webp) |
| `cua.working` | Working on the computer — Indicates an active CUA task. A separate comic pointer marks the on-screen action location. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/414cf717fa3ddea9.webp) |
| `error.recover` | Recovering from an error — Signals a chat or speech-input error. The UI provides details and recovery instructions. **App-connected** | 12 / 1.4s / One-shot | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/a19ebef5e79d7ec1.webp) |
| `friend.wave` | Greeting wave — Waves as a greeting or when a speech transcript is ready. The existing clip ID is retained for compatibility. **App-connected** | 12 / 1.4s / One-shot | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/10115a2421ef7c13.webp) |
| `drag.lifecycle` | Lift, carry and land — The complete lift-to-landing reference sequence. Live dragging uses its separate lift, held and landing clips. **Preview only** | 12 / 1.4s / One-shot | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/c0bd936f59fe0e83.webp) |
| `update.ribbon` | Presenting an update — A comparison preview of the original ribbon artwork. Update notices use the placard performance with entry, loop and return artwork. **Preview only** | 12 / 1.4s / One-shot | — | `ribbon.ground` → `ribbon.ground` | [Play / stop](https://vivi.vora.im/character-reference/69ee541cf17775c7.webp) |
| `transition.typing-neutral` | typing pose → neutral pose — A full-body bridge from typing pose to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 1.4s / One-shot | — | `typing.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/7ddcfa47239f75f8.webp) |
| `transition.neutral-typing` | neutral pose → typing pose — A full-body bridge from neutral pose to typing pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 1.4s / One-shot | — | `neutral` → `typing.ready` | [Play / stop](https://vivi.vora.im/character-reference/45ed39d0756a05f4.webp) |
| `transition.box-enter` | neutral pose → box-carrying pose — A full-body bridge from neutral pose to box-carrying pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 1.4s / One-shot | — | `neutral` → `box.ground` | [Play / stop](https://vivi.vora.im/character-reference/94903590af6d03f1.webp) |
| `transition.box-exit` | box-carrying pose → neutral pose — A full-body bridge from box-carrying pose to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 1.4s / One-shot | — | `box.ground` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/0d7ff6dd73c71c9b.webp) |
| `transition.search-enter` | neutral pose → searching pose — A full-body bridge from neutral pose to searching pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 1.4s / One-shot | — | `neutral` → `search.ground` | [Play / stop](https://vivi.vora.im/character-reference/7125b04b04bf03fb.webp) |
| `transition.search-exit` | searching pose → neutral pose — A full-body bridge from searching pose to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 1.4s / One-shot | — | `search.ground` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/01eaadd959f03257.webp) |
| `transition.megaphone-enter` | neutral pose → megaphone pose — A full-body bridge from neutral pose to megaphone pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 1.4s / One-shot | — | `neutral` → `megaphone.ground` | [Play / stop](https://vivi.vora.im/character-reference/c0198bbcc43828de.webp) |
| `transition.megaphone-exit` | megaphone pose → neutral pose — A full-body bridge from megaphone pose to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 1.4s / One-shot | — | `megaphone.ground` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/ecb363da7c959b4e.webp) |
| `answer.streaming` | Presenting a streaming answer — Presents a response as it streams in. Completion requires the response’s end event. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/63666a3ef96169ca.webp) |
| `media.image` | Presenting an image — Presents an image result in the answer, separately from the image-generation wait. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/b390980baef1d015.webp) |
| `media.video` | Presenting a video — Presents a video result, separately from the video-generation wait. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/0cd78217a9b4e331.webp) |
| `media.audio` | Listening to audio — A listening performance for music or audio results, distinct from speaking a TTS summary. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/2a9e0cee92edadb8.webp) |
| `data.table` | Explaining a table or chart — Explains answers containing tables or charts. Chart events currently share this table-explanation motion. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/70506e6922870640.webp) |
| `media.image.wait` | Waiting for image generation — Waits during an identified image-generation task, then switches to image presentation when a result arrives. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/454d134c00465917.webp) |
| `media.video.wait` | Waiting for video generation — A waiting performance for a video-generation task; it does not imply the result is already complete. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/e3e0eb68a10a6f12.webp) |
| `media.audio.wait` | Waiting for audio generation — Waits during audio generation and changes with the task state and result events. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/76a36af67350345a.webp) |
| `chat.waiting.very-long` | Working through a long wait — Takes a breath during an extended wait. The same artwork is also used while speech is being transcribed. **App-connected** | 12 / 1.4s / Loop | — | `neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/6d4cd415f0792dc3.webp) |
| `wardrobe.christmas` | Christmas outfit — A Christmas idle outfit, selected by the December 25 condition across regions and UI languages. **App-connected** | 12 / 1.4s / Loop | — | `wardrobe.christmas.neutral` → `wardrobe.christmas.neutral` | [Play / stop](https://vivi.vora.im/character-reference/876313d70efba968.webp) |
| `wardrobe.kr-hanbok` | Korean holiday hanbok — A hanbok idle outfit selected by Korean holiday conditions. See the variant rules and holiday data for exact dates. **App-connected** | 12 / 1.4s / Loop | — | `wardrobe.kr-hanbok.neutral` → `wardrobe.kr-hanbok.neutral` | [Play / stop](https://vivi.vora.im/character-reference/cf1e9c8bde692a2a.webp) |
| `wardrobe.jp-festival` | Japanese festive outfit — An idle outfit selected by Japanese festive-date conditions. Language and region are evaluated separately. **App-connected** | 12 / 1.4s / Loop | — | `wardrobe.jp-festival.neutral` → `wardrobe.jp-festival.neutral` | [Play / stop](https://vivi.vora.im/character-reference/603d1a6bf7da34d7.webp) |
| `wardrobe.us-celebration` | US festive outfit — An idle outfit for US celebratory dates, following the policy of excluding festive dress on remembrance days. **App-connected** | 12 / 1.4s / Loop | — | `wardrobe.us-celebration.neutral` → `wardrobe.us-celebration.neutral` | [Play / stop](https://vivi.vora.im/character-reference/cf6d71d3a69c5e5f.webp) |
| `wardrobe.gb-celebration` | UK festive outfit — An idle outfit for UK celebratory dates, scoped by region and holiday data. **App-connected** | 12 / 1.4s / Loop | — | `wardrobe.gb-celebration.neutral` → `wardrobe.gb-celebration.neutral` | [Play / stop](https://vivi.vora.im/character-reference/7bd82ac9738e38c0.webp) |
| `transition.drag-lift` | neutral pose → carried pose — A full-body bridge from neutral pose to carried pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 4 / 0.5s / One-shot | — | `neutral` → `drag.held` | [Play / stop](https://vivi.vora.im/character-reference/21dc0d79d6714532.webp) |
| `drag.held` | Being carried — Maintains the carried pose during a drag, then uses the landing bridge to return to the base pose on drop. **App-connected** | 5 / 0.6s / Loop | — | `drag.held` → `drag.held` | [Play / stop](https://vivi.vora.im/character-reference/ed3bedf0f262355c.webp) |
| `transition.drag-land` | carried pose → neutral pose — A full-body bridge from carried pose to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 8 / 1.0s / One-shot | — | `drag.held` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/97114850f9360fe2.webp) |
| `transition.wardrobe.christmas-enter` | neutral pose → Christmas outfit — A full-body bridge from neutral pose to Christmas outfit. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `neutral` → `wardrobe.christmas.neutral` | [Play / stop](https://vivi.vora.im/character-reference/2f0b82b1cc79aea0.webp) |
| `transition.wardrobe.christmas-exit` | Christmas outfit → neutral pose — A full-body bridge from Christmas outfit to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `wardrobe.christmas.neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/8527d0232290784f.webp) |
| `transition.wardrobe.kr-hanbok-enter` | neutral pose → Korean holiday hanbok — A full-body bridge from neutral pose to Korean holiday hanbok. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `neutral` → `wardrobe.kr-hanbok.neutral` | [Play / stop](https://vivi.vora.im/character-reference/8811787eab5800e2.webp) |
| `transition.wardrobe.kr-hanbok-exit` | Korean holiday hanbok → neutral pose — A full-body bridge from Korean holiday hanbok to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `wardrobe.kr-hanbok.neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/6a712d686b819907.webp) |
| `transition.wardrobe.jp-festival-enter` | neutral pose → Japanese festive outfit — A full-body bridge from neutral pose to Japanese festive outfit. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `neutral` → `wardrobe.jp-festival.neutral` | [Play / stop](https://vivi.vora.im/character-reference/f743141965acceb4.webp) |
| `transition.wardrobe.jp-festival-exit` | Japanese festive outfit → neutral pose — A full-body bridge from Japanese festive outfit to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `wardrobe.jp-festival.neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/1cb887412440da51.webp) |
| `transition.wardrobe.us-celebration-enter` | neutral pose → US festive outfit — A full-body bridge from neutral pose to US festive outfit. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `neutral` → `wardrobe.us-celebration.neutral` | [Play / stop](https://vivi.vora.im/character-reference/4502f5c8c2595e78.webp) |
| `transition.wardrobe.us-celebration-exit` | US festive outfit → neutral pose — A full-body bridge from US festive outfit to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `wardrobe.us-celebration.neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/d11b18a78ccb0b35.webp) |
| `transition.wardrobe.gb-celebration-enter` | neutral pose → UK festive outfit — A full-body bridge from neutral pose to UK festive outfit. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `neutral` → `wardrobe.gb-celebration.neutral` | [Play / stop](https://vivi.vora.im/character-reference/d13ed34ee57fcf63.webp) |
| `transition.wardrobe.gb-celebration-exit` | UK festive outfit → neutral pose — A full-body bridge from UK festive outfit to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `wardrobe.gb-celebration.neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/501c5c8bb1c2e89f.webp) |
| `transition.wardrobe.night-enter` | neutral pose → Nighttime outfit — A full-body bridge from neutral pose to Nighttime outfit. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `neutral` → `wardrobe.night.neutral` | [Play / stop](https://vivi.vora.im/character-reference/b8af8c0d2833b841.webp) |
| `transition.wardrobe.night-exit` | Nighttime outfit → neutral pose — A full-body bridge from Nighttime outfit to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `wardrobe.night.neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/41ab0dcdbabb0d43.webp) |
| `transition.wardrobe.weekend-enter` | neutral pose → Weekend outfit — A full-body bridge from neutral pose to Weekend outfit. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `neutral` → `wardrobe.weekend.neutral` | [Play / stop](https://vivi.vora.im/character-reference/42f0bce6e28e9663.webp) |
| `transition.wardrobe.weekend-exit` | Weekend outfit → neutral pose — A full-body bridge from Weekend outfit to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.0s / One-shot | 10 / 0 / 0 | `wardrobe.weekend.neutral` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/bc15175ae8928785.webp) |
| `wardrobe.night` | Nighttime outfit — The default pack’s nighttime outfit, selected from 22:00 until 06:00 in the PC’s local time. **App-connected** | 12 / 5.4s / Loop | 12 / 0 / 0 | `wardrobe.night.neutral` → `wardrobe.night.neutral` | [Play / stop](https://vivi.vora.im/character-reference/e9f36ce2f085cbf4.webp) |
| `wardrobe.weekend` | Weekend outfit — A casual outfit for local Saturdays and Sundays. Higher-priority nighttime and holiday conditions take precedence. **App-connected** | 12 / 4.7s / Loop | 12 / 0 / 0 | `wardrobe.weekend.neutral` → `wardrobe.weekend.neutral` | [Play / stop](https://vivi.vora.im/character-reference/2a9fe78dd8186822.webp) |
| `news.reporter` | News reporter — Calmly presents a news answer at a desk with a microphone and notes, then returns to the previous base outfit for the next question. **App-connected** | 12 / 3.9s / Loop | 12 / 0 / 0 | `news.reporter.ready` → `news.reporter.ready` | [Play / stop](https://vivi.vora.im/character-reference/dcf571312591a228.webp) |
| `transition.news.reporter.enter` | neutral pose → News reporter — A full-body bridge from neutral pose to News reporter. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 10 / 2 / 0 | `neutral` → `news.reporter.ready` | [Play / stop](https://vivi.vora.im/character-reference/55f4e2af44081086.webp) |
| `transition.news.reporter.exit` | News reporter → neutral pose — A full-body bridge from News reporter to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 0 / 12 / 0 | `news.reporter.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/26c72b2e2b43c073.webp) |
| `weather.wind` | Wind forecast in a windbreaker — Holds a windbreaker and scarf while presenting a windy forecast. The outfit applies only to that answer. **App-connected** | 12 / 3.6s / Loop | 12 / 0 / 0 | `weather.wind.ready` → `weather.wind.ready` | [Play / stop](https://vivi.vora.im/character-reference/63670b93a7760a88.webp) |
| `transition.weather.wind.enter` | neutral pose → Wind forecast in a windbreaker — A full-body bridge from neutral pose to Wind forecast in a windbreaker. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 10 / 2 / 0 | `neutral` → `weather.wind.ready` | [Play / stop](https://vivi.vora.im/character-reference/957d3c0777c1c593.webp) |
| `transition.weather.wind.exit` | Wind forecast in a windbreaker → neutral pose — A full-body bridge from Wind forecast in a windbreaker to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 0 / 12 / 0 | `weather.wind.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/15354fd7cb413ee9.webp) |
| `wardrobe.spring` | Spring jacket — A spring jacket selected by the PC local-date rules, with full-body dressing and return bridges. **App-connected** | 12 / 3.9s / Loop | 12 / 0 / 0 | `wardrobe.spring.ready` → `wardrobe.spring.ready` | [Play / stop](https://vivi.vora.im/character-reference/86e82d56c7aedf53.webp) |
| `transition.wardrobe.spring.enter` | neutral pose → Spring jacket — A full-body bridge from neutral pose to Spring jacket. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 10 / 2 / 0 | `neutral` → `wardrobe.spring.ready` | [Play / stop](https://vivi.vora.im/character-reference/1262c60f2d80167b.webp) |
| `transition.wardrobe.spring.exit` | Spring jacket → neutral pose — A full-body bridge from Spring jacket to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 10 / 2 / 0 | `wardrobe.spring.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/31099154d5ff01eb.webp) |
| `wardrobe.summer` | Summer shirt — A light summer shirt selected by local-date rules; the headphones remain worn. **App-connected** | 12 / 4.2s / Loop | 12 / 0 / 0 | `wardrobe.summer.ready` → `wardrobe.summer.ready` | [Play / stop](https://vivi.vora.im/character-reference/26c6994da8a910f7.webp) |
| `transition.wardrobe.summer.enter` | neutral pose → Summer shirt — A full-body bridge from neutral pose to Summer shirt. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 10 / 2 / 0 | `neutral` → `wardrobe.summer.ready` | [Play / stop](https://vivi.vora.im/character-reference/870229ee110d569d.webp) |
| `transition.wardrobe.summer.exit` | Summer shirt → neutral pose — A full-body bridge from Summer shirt to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 10 / 2 / 0 | `wardrobe.summer.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/aafe946fea65f7e4.webp) |
| `wardrobe.autumn` | Autumn cardigan — Waits in an autumn cardigan and scarf. Outfit-discontinuity frames are excluded and the actual selected drawing count is recorded. **App-connected** | 11 / 3.7s / Loop | 11 / 0 / 0 | `wardrobe.autumn.ready` → `wardrobe.autumn.ready` | [Play / stop](https://vivi.vora.im/character-reference/8e5e211e198f8e6a.webp) |
| `transition.wardrobe.autumn.enter` | neutral pose → Autumn cardigan — A full-body bridge from neutral pose to Autumn cardigan. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 10 / 2 / 0 | `neutral` → `wardrobe.autumn.ready` | [Play / stop](https://vivi.vora.im/character-reference/ac74b2f297e6d154.webp) |
| `transition.wardrobe.autumn.exit` | Autumn cardigan → neutral pose — A full-body bridge from Autumn cardigan to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 10 / 2 / 0 | `wardrobe.autumn.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/e5c6adaea55b5cc7.webp) |
| `wardrobe.winter` | Winter vest and scarf — Waits in a winter vest and scarf. Cold and snowy answers explicitly share this whole-body sequence and are not counted as separate new drawings. **App-connected** | 12 / 3.9s / Loop | 12 / 0 / 0 | `wardrobe.winter.ready` → `wardrobe.winter.ready` | [Play / stop](https://vivi.vora.im/character-reference/d8a24ca592524ad1.webp) |
| `transition.wardrobe.winter.enter` | neutral pose → Winter vest and scarf — A full-body bridge from neutral pose to Winter vest and scarf. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 0 / 12 / 0 | `neutral` → `wardrobe.winter.ready` | [Play / stop](https://vivi.vora.im/character-reference/aa83d567758e7110.webp) |
| `transition.wardrobe.winter.exit` | Winter vest and scarf → neutral pose — A full-body bridge from Winter vest and scarf to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 10 / 2 / 0 | `wardrobe.winter.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/2900f0ce14463e41.webp) |
| `wardrobe.morning` | Morning cardigan — A yellow-cardigan morning idle, connected to the waking performance without changing clothes. **App-connected** | 12 / 3.9s / Loop | 12 / 0 / 0 | `wardrobe.morning.ready` → `wardrobe.morning.ready` | [Play / stop](https://vivi.vora.im/character-reference/ff4a236cab9516e9.webp) |
| `transition.wardrobe.morning.enter` | neutral pose → Morning cardigan — A full-body bridge from neutral pose to Morning cardigan. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 10 / 2.0s / One-shot | 0 / 10 / 0 | `neutral` → `wardrobe.morning.ready` | [Play / stop](https://vivi.vora.im/character-reference/f9bf528ed6570e73.webp) |
| `transition.wardrobe.morning.exit` | Morning cardigan → neutral pose — A full-body bridge from Morning cardigan to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 10 / 2.0s / One-shot | 8 / 2 / 0 | `wardrobe.morning.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/9b372538fd429e0e.webp) |
| `wardrobe.day` | Daytime work vest — The base pose for the daytime work vest, with matching laptop-work and study performances. **App-connected** | 12 / 3.9s / Loop | 12 / 0 / 0 | `wardrobe.day.ready` → `wardrobe.day.ready` | [Play / stop](https://vivi.vora.im/character-reference/70dc877871ffa946.webp) |
| `transition.wardrobe.day.enter` | neutral pose → Daytime work vest — A full-body bridge from neutral pose to Daytime work vest. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.1s / One-shot | 9 / 2 / 0 | `neutral` → `wardrobe.day.ready` | [Play / stop](https://vivi.vora.im/character-reference/a7e914880b48fa76.webp) |
| `transition.wardrobe.day.exit` | Daytime work vest → neutral pose — A full-body bridge from Daytime work vest to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.3s / One-shot | 10 / 2 / 0 | `wardrobe.day.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/1ee7c700ee4e47d6.webp) |
| `wardrobe.evening` | Evening lounge cardigan — A relaxed evening cardigan with authored full-body outfit transitions. **App-connected** | 10 / 3.5s / Loop | 10 / 0 / 0 | `wardrobe.evening.ready` → `wardrobe.evening.ready` | [Play / stop](https://vivi.vora.im/character-reference/d2fc241abd19cad2.webp) |
| `transition.wardrobe.evening.enter` | neutral pose → Evening lounge cardigan — A full-body bridge from neutral pose to Evening lounge cardigan. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.1s / One-shot | 9 / 2 / 0 | `neutral` → `wardrobe.evening.ready` | [Play / stop](https://vivi.vora.im/character-reference/a46274bf8ab6c517.webp) |
| `transition.wardrobe.evening.exit` | Evening lounge cardigan → neutral pose — A full-body bridge from Evening lounge cardigan to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.1s / One-shot | 9 / 2 / 0 | `wardrobe.evening.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/7885fcccf873ed3b.webp) |
| `weather.default` | Weather-card forecast — Holds and points to a weather card. General and cloudy forecasts share this performance. **App-connected** | 9 / 3.0s / Loop | 9 / 0 / 0 | `weather.default.ready` → `weather.default.ready` | [Play / stop](https://vivi.vora.im/character-reference/32e221727ac8fd51.webp) |
| `transition.weather.default.enter` | neutral pose → Weather-card forecast — A full-body bridge from neutral pose to Weather-card forecast. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.5s / One-shot | 10 / 2 / 0 | `neutral` → `weather.default.ready` | [Play / stop](https://vivi.vora.im/character-reference/cb14ba5a9abecad1.webp) |
| `transition.weather.default.exit` | Weather-card forecast → neutral pose — A full-body bridge from Weather-card forecast to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.5s / One-shot | 10 / 2 / 0 | `weather.default.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/35b966f15c1a0c02.webp) |
| `weather.rain` | Rain forecast with an umbrella — Presents a rain forecast in a raincoat with an umbrella. Defective frames with missing props or extra paws are excluded. **App-connected** | 11 / 3.5s / Loop | 11 / 0 / 0 | `weather.rain.ready` → `weather.rain.ready` | [Play / stop](https://vivi.vora.im/character-reference/fb3aed7300e7c5fa.webp) |
| `transition.weather.rain.enter` | neutral pose → Rain forecast with an umbrella — A full-body bridge from neutral pose to Rain forecast with an umbrella. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.5s / One-shot | 10 / 2 / 0 | `neutral` → `weather.rain.ready` | [Play / stop](https://vivi.vora.im/character-reference/8c9941b13ff43ccb.webp) |
| `transition.weather.rain.exit` | Rain forecast with an umbrella → neutral pose — A full-body bridge from Rain forecast with an umbrella to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.5s / One-shot | 10 / 2 / 0 | `weather.rain.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/11b8ab20f0063523.webp) |
| `weather.hot` | Hot-weather fan briefing — Uses a light jacket and fan for hot weather. Clear forecasts classified into this state by the service share the same artwork. **App-connected** | 10 / 3.1s / Loop | 10 / 0 / 0 | `weather.hot.ready` → `weather.hot.ready` | [Play / stop](https://vivi.vora.im/character-reference/e147dd1a951c7f99.webp) |
| `transition.weather.hot.enter` | neutral pose → Hot-weather fan briefing — A full-body bridge from neutral pose to Hot-weather fan briefing. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.5s / One-shot | 10 / 2 / 0 | `neutral` → `weather.hot.ready` | [Play / stop](https://vivi.vora.im/character-reference/ddb28a71f309dbd1.webp) |
| `transition.weather.hot.exit` | Hot-weather fan briefing → neutral pose — A full-body bridge from Hot-weather fan briefing to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.5s / One-shot | 10 / 2 / 0 | `weather.hot.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/e02af897a7541445.webp) |
| `stocks.briefing` | Stock-chart briefing — Points to a chart board while presenting a stock answer. The illustrated chart is a prop, not a promise of returns or live price data. **App-connected** | 12 / 3.9s / Loop | 12 / 0 / 0 | `stocks.briefing.ready` → `stocks.briefing.ready` | [Play / stop](https://vivi.vora.im/character-reference/80a50c810cf2ea7e.webp) |
| `transition.stocks.briefing.enter` | neutral pose → Stock-chart briefing — A full-body bridge from neutral pose to Stock-chart briefing. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 10 / 2.1s / One-shot | 8 / 2 / 0 | `neutral` → `stocks.briefing.ready` | [Play / stop](https://vivi.vora.im/character-reference/5965a39bc66d6fc9.webp) |
| `transition.stocks.briefing.exit` | Stock-chart briefing → neutral pose — A full-body bridge from Stock-chart briefing to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.5s / One-shot | 10 / 2 / 0 | `stocks.briefing.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/834f7df163601c73.webp) |
| `academic.research` | Paper and patent research — Puts on an academic cap with a paw and examines paper or patent pages with a magnifier. Paper and patent events share the artwork. **App-connected** | 12 / 3.9s / Loop | 12 / 0 / 0 | `academic.research.ready` → `academic.research.ready` | [Play / stop](https://vivi.vora.im/character-reference/346d1a2551c34096.webp) |
| `transition.academic.research.enter` | neutral pose → Paper and patent research — A full-body bridge from neutral pose to Paper and patent research. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.5s / One-shot | 10 / 2 / 0 | `neutral` → `academic.research.ready` | [Play / stop](https://vivi.vora.im/character-reference/f0df107519048159.webp) |
| `transition.academic.research.exit` | Paper and patent research → neutral pose — A full-body bridge from Paper and patent research to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.5s / One-shot | 0 / 12 / 0 | `academic.research.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/819b3026b9028fa7.webp) |
| `night.sleep` | Sleeping in bed — Lies down on a cushion, pillow and blanket in the night outfit, with full-body bridges back to other functions. **App-connected** | 11 / 10.7s / Loop | 11 / 0 / 0 | `night.sleep.ready` → `night.sleep.ready` | [Play / stop](https://vivi.vora.im/character-reference/fbb7a6a22073bf19.webp) |
| `transition.night.sleep.enter` | Nighttime outfit → Sleeping in bed — A full-body bridge from Nighttime outfit to Sleeping in bed. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.5s / One-shot | 9 / 2 / 0 | `wardrobe.night.neutral` → `night.sleep.ready` | [Play / stop](https://vivi.vora.im/character-reference/1bd85019bfbdca73.webp) |
| `transition.night.sleep.exit` | Sleeping in bed → Nighttime outfit — A full-body bridge from Sleeping in bed to Nighttime outfit. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.5s / One-shot | 0 / 11 / 0 | `night.sleep.ready` → `wardrobe.night.neutral` | [Play / stop](https://vivi.vora.im/character-reference/0df70c87b2739ec5.webp) |
| `morning.wake` | Waking up in the morning — A one-shot wake-up: rubs the eyes, stretches and stands beside the same cushion. It does not loop by snapping back into the seated pose. **App-connected** | 12 / 3.9s / One-shot | 12 / 0 / 0 | `morning.wake.seated` → `morning.wake.standing` | [Play / stop](https://vivi.vora.im/character-reference/c05b706812e9a677.webp) |
| `transition.morning.wake.enter` | Morning cardigan → seated on the morning bedding — A full-body bridge from Morning cardigan to seated on the morning bedding. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.5s / One-shot | 9 / 2 / 0 | `wardrobe.morning.ready` → `morning.wake.seated` | [Play / stop](https://vivi.vora.im/character-reference/fb8fc1ad345a389d.webp) |
| `transition.morning.wake.exit` | standing beside the bedding → Morning cardigan — A full-body bridge from standing beside the bedding to Morning cardigan. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.5s / One-shot | 9 / 2 / 0 | `morning.wake.standing` → `wardrobe.morning.ready` | [Play / stop](https://vivi.vora.im/character-reference/9a3e2bd58448421c.webp) |
| `idle.desk-rest` | Resting at a desk — Rests at a desk, props up the cheek and moves the hindfeet. Complete furniture legs remain inside the transparent artwork. **App-connected** | 12 / 3.9s / Loop | 12 / 0 / 0 | `idle.desk-rest.ready` → `idle.desk-rest.ready` | [Play / stop](https://vivi.vora.im/character-reference/6b71a09dcb6cded8.webp) |
| `transition.idle.desk-rest.enter` | neutral pose → Resting at a desk — A full-body bridge from neutral pose to Resting at a desk. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.7s / One-shot | 10 / 2 / 0 | `neutral` → `idle.desk-rest.ready` | [Play / stop](https://vivi.vora.im/character-reference/f96a2c0b888c2e42.webp) |
| `transition.idle.desk-rest.exit` | Resting at a desk → neutral pose — A full-body bridge from Resting at a desk to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.7s / One-shot | 0 / 12 / 0 | `idle.desk-rest.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/b23da1c2df2ec4d6.webp) |
| `idle.dance` | Full-body dance with a speaker — A full-body dance beside a small speaker, involving paws, hindfeet, head and torso. It is an idle performance independent of music playback. **App-connected** | 12 / 3.9s / Loop | 12 / 0 / 0 | `idle.dance.ready` → `idle.dance.ready` | [Play / stop](https://vivi.vora.im/character-reference/50d2cf8b1a6f385b.webp) |
| `transition.idle.dance.enter` | neutral pose → Full-body dance with a speaker — A full-body bridge from neutral pose to Full-body dance with a speaker. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.7s / One-shot | 10 / 2 / 0 | `neutral` → `idle.dance.ready` | [Play / stop](https://vivi.vora.im/character-reference/791c65274b6d37ea.webp) |
| `transition.idle.dance.exit` | Full-body dance with a speaker → neutral pose — A full-body bridge from Full-body dance with a speaker to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.7s / One-shot | 0 / 12 / 0 | `idle.dance.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/81a24aa570529d1c.webp) |
| `idle.day.work` | Daytime laptop work — Types toward the laptop keyboard while seated in the daytime work vest, distinct from the response-wait typing performance. **App-connected** | 12 / 3.9s / Loop | 12 / 0 / 0 | `idle.day.work.ready` → `idle.day.work.ready` | [Play / stop](https://vivi.vora.im/character-reference/fd632869cc7c7906.webp) |
| `transition.idle.day.work.enter` | Daytime work vest → Daytime laptop work — A full-body bridge from Daytime work vest to Daytime laptop work. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.7s / One-shot | 10 / 2 / 0 | `wardrobe.day.ready` → `idle.day.work.ready` | [Play / stop](https://vivi.vora.im/character-reference/03b0b8a6bc199b54.webp) |
| `transition.idle.day.work.exit` | Daytime laptop work → Daytime work vest — A full-body bridge from Daytime laptop work to Daytime work vest. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.7s / One-shot | 0 / 12 / 0 | `idle.day.work.ready` → `wardrobe.day.ready` | [Play / stop](https://vivi.vora.im/character-reference/abb39d7427281321.webp) |
| `idle.day.study` | Daytime book and notebook study — Reads, writes with a pencil and moves the hindfeet in the daytime vest. It uses ten actual selected drawings with consistent pencil continuity. **App-connected** | 10 / 3.0s / Loop | 10 / 0 / 0 | `idle.day.study.ready` → `idle.day.study.ready` | [Play / stop](https://vivi.vora.im/character-reference/18b4ebe8ee1c922c.webp) |
| `transition.idle.day.study.enter` | Daytime work vest → Daytime book and notebook study — A full-body bridge from Daytime work vest to Daytime book and notebook study. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.5s / One-shot | 9 / 2 / 0 | `wardrobe.day.ready` → `idle.day.study.ready` | [Play / stop](https://vivi.vora.im/character-reference/ffe0842d6a545721.webp) |
| `transition.idle.day.study.exit` | Daytime book and notebook study → Daytime work vest — A full-body bridge from Daytime book and notebook study to Daytime work vest. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.5s / One-shot | 0 / 11 / 0 | `idle.day.study.ready` → `wardrobe.day.ready` | [Play / stop](https://vivi.vora.im/character-reference/132e7b365919182a.webp) |
| `file.truck` | Delivery truck for multiple files — Drives a delivery truck carrying multiple boxes for a multi-file upload or save, distinct from carrying one box for a single file. **App-connected** | 11 / 2.9s / Loop | 11 / 0 / 0 | `file.truck.ready` → `file.truck.ready` | [Play / stop](https://vivi.vora.im/character-reference/59eef913ba84e7b4.webp) |
| `transition.file.truck.enter` | neutral pose → Delivery truck for multiple files — A full-body bridge from neutral pose to Delivery truck for multiple files. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.5s / One-shot | 9 / 2 / 0 | `neutral` → `file.truck.ready` | [Play / stop](https://vivi.vora.im/character-reference/b10eca28e732fdc5.webp) |
| `transition.file.truck.exit` | Delivery truck for multiple files → neutral pose — A full-body bridge from Delivery truck for multiple files to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.5s / One-shot | 0 / 11 / 0 | `file.truck.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/c6fb96f09abbef4b.webp) |
| `weather.snow` | Catching snowflakes — Catches and examines snowflakes beneath a snow cloud, reacting with the whole body. Painted snow props supplement the new full-body drawings. **App-connected** | 11 / 2.9s / Loop | 11 / 0 / 0 | `weather.snow.ready` → `weather.snow.ready` | [Play / stop](https://vivi.vora.im/character-reference/ebcb4fdfad365c83.webp) |
| `transition.weather.snow.enter` | neutral pose → Catching snowflakes — A full-body bridge from neutral pose to Catching snowflakes. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.4s / One-shot | 10 / 2 / 0 | `neutral` → `weather.snow.ready` | [Play / stop](https://vivi.vora.im/character-reference/035021d9a9c46411.webp) |
| `transition.weather.snow.exit` | Catching snowflakes → neutral pose — A full-body bridge from Catching snowflakes to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 12 / 2.4s / One-shot | 0 / 12 / 0 | `weather.snow.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/bcfa17ebbf0b599f.webp) |
| `weather.cloudy` | Cloudy-weather briefing — Looks up at a large cloud in a purple vest, using paws, head, torso and feet to explain cloudy weather. **App-connected** | 12 / 3.1s / Loop | 12 / 0 / 0 | `weather.cloudy.ready` → `weather.cloudy.ready` | [Play / stop](https://vivi.vora.im/character-reference/7edae660fb71983c.webp) |
| `transition.weather.cloudy.enter` | neutral pose → Cloudy-weather briefing — A full-body bridge from neutral pose to Cloudy-weather briefing. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 16 / 3.2s / One-shot | 14 / 2 / 0 | `neutral` → `weather.cloudy.ready` | [Play / stop](https://vivi.vora.im/character-reference/d45d0596229123eb.webp) |
| `transition.weather.cloudy.exit` | Cloudy-weather briefing → neutral pose — A full-body bridge from Cloudy-weather briefing to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 16 / 3.2s / One-shot | 0 / 16 / 0 | `weather.cloudy.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/a793f1a3e5085cde.webp) |
| `weather.strongsun` | Strong-sun shade briefing — Shades the face with a visor and gestures toward the sun. The painted sun is a supporting prop; the character uses new full-body drawings. **App-connected** | 12 / 3.1s / Loop | 12 / 0 / 0 | `weather.strongsun.ready` → `weather.strongsun.ready` | [Play / stop](https://vivi.vora.im/character-reference/5454f3b6c81320a4.webp) |
| `transition.weather.strongsun.enter` | neutral pose → Strong-sun shade briefing — A full-body bridge from neutral pose to Strong-sun shade briefing. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 9 / 1.9s / One-shot | 7 / 2 / 0 | `neutral` → `weather.strongsun.ready` | [Play / stop](https://vivi.vora.im/character-reference/a0b5253b4bfbc920.webp) |
| `transition.weather.strongsun.exit` | Strong-sun shade briefing → neutral pose — A full-body bridge from Strong-sun shade briefing to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 9 / 1.9s / One-shot | 0 / 9 / 0 | `weather.strongsun.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/b7d90c22a91c4b44.webp) |
| `weather.swimwear-hot` | Hot weather in swimwear — Fans off the heat in headphones, a hooded rashguard swimsuit and a swim ring, with coordinated paw, foot and body movement. **App-connected** | 8 / 2.2s / Loop | 8 / 0 / 0 | `weather.swimwear-hot.ready` → `weather.swimwear-hot.ready` | [Play / stop](https://vivi.vora.im/character-reference/72614eda2da2ba37.webp) |
| `transition.weather.swimwear-hot.enter` | neutral pose → Hot weather in swimwear — A full-body bridge from neutral pose to Hot weather in swimwear. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.2s / One-shot | 9 / 2 / 0 | `neutral` → `weather.swimwear-hot.ready` | [Play / stop](https://vivi.vora.im/character-reference/dc3b253147362e82.webp) |
| `transition.weather.swimwear-hot.exit` | Hot weather in swimwear → neutral pose — A full-body bridge from Hot weather in swimwear to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 11 / 2.2s / One-shot | 0 / 11 / 0 | `weather.swimwear-hot.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/de34e65def29c6cc.webp) |
| `idle.bubbles` | Popping soap bubbles — Blows bubbles and pops them with a paw, then follows the next one with a surprised look. **App-connected** | 12 / 2.6s / One-shot | 12 / 0 / 0 | `bubbles.ready` → `bubbles.finished` | [Play / stop](https://vivi.vora.im/character-reference/3b0b38a69cfd2761.webp) |
| `transition.idle.bubbles.enter` | Popping soap bubbles · entry — Takes out the prop and gets ready to play. **App-connected** | 10 / 1.3s / One-shot | 8 / 2 / 0 | `neutral` → `bubbles.ready` | [Play / stop](https://vivi.vora.im/character-reference/7b9dd00fac0f0c7c.webp) |
| `transition.idle.bubbles.exit` | Popping soap bubbles · cleanup and return — Puts the prop away and returns to the familiar relaxed pose. **App-connected** | 11 / 1.4s / One-shot | 9 / 2 / 0 | `bubbles.finished` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/9899e9fe556ec64d.webp) |
| `idle.paper-plane` | Flying a paper airplane — Launches a paper plane, turns to follow its flight and catches it again. **App-connected** | 12 / 2.6s / One-shot | 12 / 0 / 0 | `paper-plane.ready` → `paper-plane.finished` | [Play / stop](https://vivi.vora.im/character-reference/ecec0345dc7347c8.webp) |
| `transition.idle.paper-plane.enter` | Flying a paper airplane · entry — Takes out the prop and gets ready to play. **App-connected** | 12 / 1.6s / One-shot | 10 / 2 / 0 | `neutral` → `paper-plane.ready` | [Play / stop](https://vivi.vora.im/character-reference/33d82b019783c757.webp) |
| `transition.idle.paper-plane.exit` | Flying a paper airplane · cleanup and return — Puts the prop away and returns to the familiar relaxed pose. **App-connected** | 12 / 1.6s / One-shot | 10 / 2 / 0 | `paper-plane.finished` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/dfc01c3b65ce96e7.webp) |
| `idle.toy-fish` | Catching a toy fish — Stalks the plush fish, pounces and catches it with a playful kick. **App-connected** | 12 / 2.6s / One-shot | 12 / 0 / 0 | `toy-fish.ready` → `toy-fish.finished` | [Play / stop](https://vivi.vora.im/character-reference/de509e32ed0f2f83.webp) |
| `transition.idle.toy-fish.enter` | Catching a toy fish · entry — Takes out the prop and gets ready to play. **App-connected** | 12 / 1.6s / One-shot | 10 / 2 / 0 | `neutral` → `toy-fish.ready` | [Play / stop](https://vivi.vora.im/character-reference/bbfbe10a38958bd7.webp) |
| `transition.idle.toy-fish.exit` | Catching a toy fish · cleanup and return — Puts the prop away and returns to the familiar relaxed pose. **App-connected** | 12 / 1.6s / One-shot | 10 / 2 / 0 | `toy-fish.finished` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/63c6fa330f5612a5.webp) |
| `idle.box-peek` | Peeking out of a little box — Hides in a little box and peeks out on either side. **App-connected** | 12 / 2.6s / One-shot | 12 / 0 / 0 | `box-peek.ready` → `box-peek.finished` | [Play / stop](https://vivi.vora.im/character-reference/c41fb0c4adaca4cb.webp) |
| `transition.idle.box-peek.enter` | Peeking out of a little box · entry — Takes out the prop and gets ready to play. **App-connected** | 12 / 1.6s / One-shot | 10 / 2 / 0 | `neutral` → `box-peek.ready` | [Play / stop](https://vivi.vora.im/character-reference/eb88f323c7bd583f.webp) |
| `transition.idle.box-peek.exit` | Peeking out of a little box · cleanup and return — Puts the prop away and returns to the familiar relaxed pose. **App-connected** | 12 / 1.6s / One-shot | 10 / 2 / 0 | `box-peek.finished` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/07efb8a87d5fc6df.webp) |
| `idle.yoyo` | A sheepish yo-yo tangle — Confidently throws a yo-yo, gets the string tangled and gives a sheepish smile. **App-connected** | 12 / 2.6s / One-shot | 12 / 0 / 0 | `yoyo.ready` → `yoyo.tangled` | [Play / stop](https://vivi.vora.im/character-reference/d26d17a67a84b7bc.webp) |
| `transition.idle.yoyo.enter` | A sheepish yo-yo tangle · entry — Takes out the prop and gets ready to play. **App-connected** | 9 / 1.2s / One-shot | 7 / 2 / 0 | `neutral` → `yoyo.ready` | [Play / stop](https://vivi.vora.im/character-reference/586497f71d16ea92.webp) |
| `transition.idle.yoyo.exit` | A sheepish yo-yo tangle · cleanup and return — Puts the prop away and returns to the familiar relaxed pose. **App-connected** | 12 / 1.6s / One-shot | 10 / 2 / 0 | `yoyo.tangled` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/e10ab644643d9e91.webp) |
| `transition.update-sign.enter` | Take out the update placard — A full-body bridge from neutral pose to Update placard. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `neutral` → `update.sign.ready` | [Play / stop](https://vivi.vora.im/character-reference/ca936b09c14d7234.webp) |
| `update.sign` | Update placard — A full-body performance holding an update placard. It continues after the update icon is clicked while the progress view reports downloading, preparation and restart. **App-connected** | 12 / 2.2s / Loop | 12 / 0 / 0 | `update.sign.ready` → `update.sign.ready` | [Play / stop](https://vivi.vora.im/character-reference/c9ee598c7cd07c2d.webp) |
| `transition.update-sign.exit` | Put away the update placard — A full-body bridge from Update placard to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.1s / One-shot | 12 / 2 / 0 | `update.sign.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/91b112b02fe2f705.webp) |
| `transition.idle.scooter.enter` | Begin toy scooter — A full-body bridge from neutral pose to Toy scooter. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `neutral` → `idle.scooter.ready` | [Play / stop](https://vivi.vora.im/character-reference/fb7064b3dc1a3071.webp) |
| `idle.scooter` | Toy scooter — VIVI takes out a scooter to play, then tidies up and rests. **App-connected** | 12 / 2.4s / One-shot | 12 / 0 / 0 | `idle.scooter.ready` → `idle.scooter.ready` | [Play / stop](https://vivi.vora.im/character-reference/363dd927b691cab9.webp) |
| `transition.idle.scooter.exit` | Finish toy scooter — A full-body bridge from Toy scooter to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `idle.scooter.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/8ada07d42f05a817.webp) |
| `transition.idle.mini-train.enter` | Begin tiny train driver — A full-body bridge from neutral pose to Tiny train driver. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `neutral` → `idle.mini-train.ready` | [Play / stop](https://vivi.vora.im/character-reference/86df8537f3a3f7e1.webp) |
| `idle.mini-train` | Tiny train driver — VIVI passes the time with a mini train, from bringing it out to playing and putting it away. **App-connected** | 12 / 2.4s / One-shot | 12 / 0 / 0 | `idle.mini-train.ready` → `idle.mini-train.ready` | [Play / stop](https://vivi.vora.im/character-reference/12214288a4cead04.webp) |
| `transition.idle.mini-train.exit` | Finish tiny train driver — A full-body bridge from Tiny train driver to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `idle.mini-train.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/93ffbbbab750f55c.webp) |
| `transition.idle.magnifier.enter` | Begin magnifying-glass explorer — A full-body bridge from neutral pose to Magnifying-glass explorer. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `neutral` → `idle.magnifier.ready` | [Play / stop](https://vivi.vora.im/character-reference/40cdff73f09b6986.webp) |
| `idle.magnifier` | Magnifying-glass explorer — VIVI explores with a magnifier while waiting, then puts it away and rests. **App-connected** | 12 / 2.4s / One-shot | 12 / 0 / 0 | `idle.magnifier.ready` → `idle.magnifier.ready` | [Play / stop](https://vivi.vora.im/character-reference/709c848e9eff08e9.webp) |
| `transition.idle.magnifier.exit` | Finish magnifying-glass explorer — A full-body bridge from Magnifying-glass explorer to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `idle.magnifier.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/81aa53107b27aacc.webp) |
| `transition.idle.magic-hat.enter` | Begin magic-hat surprise — A full-body bridge from neutral pose to Magic-hat surprise. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `neutral` → `idle.magic-hat.ready` | [Play / stop](https://vivi.vora.im/character-reference/6d1621fa7d4534de.webp) |
| `idle.magic-hat` | Magic-hat surprise — VIVI plays with a magic hat while waiting. Watch the setup, performance and return together. **App-connected** | 12 / 2.4s / One-shot | 12 / 0 / 0 | `idle.magic-hat.ready` → `idle.magic-hat.ready` | [Play / stop](https://vivi.vora.im/character-reference/8cfb631c171dc435.webp) |
| `transition.idle.magic-hat.exit` | Finish magic-hat surprise — A full-body bridge from Magic-hat surprise to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `idle.magic-hat.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/5cd472725cb16ffa.webp) |
| `transition.idle.popcorn.enter` | Begin popcorn catch — A full-body bridge from neutral pose to Popcorn catch. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `neutral` → `idle.popcorn.ready` | [Play / stop](https://vivi.vora.im/character-reference/9b04347b86e7a374.webp) |
| `idle.popcorn` | Popcorn catch — VIVI enjoys a popcorn break, then puts the snack away and settles down. **App-connected** | 12 / 2.4s / One-shot | 12 / 0 / 0 | `idle.popcorn.ready` → `idle.popcorn.ready` | [Play / stop](https://vivi.vora.im/character-reference/8511ec40538f84c9.webp) |
| `transition.idle.popcorn.exit` | Finish popcorn catch — A full-body bridge from Popcorn catch to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `idle.popcorn.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/3961bb83dcd4aa6a.webp) |
| `transition.idle.groom-face.enter` | Begin paw and face wash — A full-body bridge from neutral pose to Paw and face wash. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `neutral` → `idle.groom-face.ready` | [Play / stop](https://vivi.vora.im/character-reference/7a7636e98f07b81b.webp) |
| `idle.groom-face` | Paw and face wash — VIVI washes its face with a paw, a grooming moment during awake idle time. **App-connected** | 12 / 2.4s / One-shot | 12 / 0 / 0 | `idle.groom-face.ready` → `idle.groom-face.ready` | [Play / stop](https://vivi.vora.im/character-reference/6e21dff281f0e25e.webp) |
| `transition.idle.groom-face.exit` | Finish paw and face wash — A full-body bridge from Paw and face wash to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `idle.groom-face.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/83b359fab8b565ed.webp) |
| `transition.idle.groom-tail.enter` | Begin body and tail grooming — A full-body bridge from neutral pose to Body and tail grooming. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `neutral` → `idle.groom-tail.ready` | [Play / stop](https://vivi.vora.im/character-reference/d59e90ba74ceae5b.webp) |
| `idle.groom-tail` | Body and tail grooming — VIVI grooms its tail and relaxes, a different grooming moment from washing its face. **App-connected** | 12 / 2.4s / One-shot | 12 / 0 / 0 | `idle.groom-tail.ready` → `idle.groom-tail.ready` | [Play / stop](https://vivi.vora.im/character-reference/1235186efa3b8c83.webp) |
| `transition.idle.groom-tail.exit` | Finish body and tail grooming — A full-body bridge from Body and tail grooming to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `idle.groom-tail.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/ce814ca1ef7924df.webp) |
| `transition.travel.airplane.enter` | Begin little airplane trip — A full-body bridge from neutral pose to Little airplane trip. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `neutral` → `travel.airplane.ready` | [Play / stop](https://vivi.vora.im/character-reference/2054227b35c5e211.webp) |
| `travel.airplane` | Little airplane trip — An airplane performance for travel, hotel and flight-booking questions. It begins with the question, continues through the answer and then returns. **App-connected** | 12 / 2.4s / Loop | 12 / 0 / 0 | `travel.airplane.ready` → `travel.airplane.ready` | [Play / stop](https://vivi.vora.im/character-reference/7999051f8585f1f2.webp) |
| `transition.travel.airplane.exit` | Finish little airplane trip — A full-body bridge from Little airplane trip to neutral pose. It connects gaze, grounding, props and clothing along the app’s pose-transition path. **App-connected** | 14 / 2.0s / One-shot | 12 / 2 / 0 | `travel.airplane.ready` → `neutral` | [Play / stop](https://vivi.vora.im/character-reference/e1c39d91326f7b75.webp) |

### All events and fallbacks

A clip contains artwork; an event describes an application state. Multiple events can use the same artwork. Both direct bindings and fallback mappings are listed.

| Event | Clip or fallback event |
| --- | --- |
| `idle` | `idle.neutral`, `idle.rest`, `idle.doze`, `idle.groom`, `idle.invite`, `idle.rhythm`, `idle.stretch`, `idle.bored`, `idle.scooter`, `idle.mini-train`, `idle.magnifier`, `idle.magic-hat`, `idle.popcorn`, `idle.groom-face`, `idle.groom-tail` |
| `chat.waiting` | `work.typing` |
| `chat.waiting.long` | `work.search` |
| `chat.complete` | `complete.jump` |
| `chat.error` | `error.recover` |
| `chat.cancelled` | `idle.neutral` |
| `input.listening` | `input.listen` |
| `file.uploading` | `file.carry` |
| `file.saving` | `file.carry` |
| `notification` | `notification.announce` |
| `calendar.reminder` | `notification.announce` |
| `cua.working` | `cua.working` |
| `cua.awaiting-approval` | `cua.approval` |
| `update.available` | `update.sign` |
| `drag.held` | `drag.held` |
| `drag.released` | `idle.neutral` |
| `tts.speaking` | `tts.speak` |
| `chat.streaming` | `answer.streaming` |
| `media.image` | `media.image` |
| `media.video` | `media.video` |
| `media.audio` | `media.audio` |
| `data.table` | `data.table` |
| `media.image.wait` | `media.image.wait` |
| `media.video.wait` | `media.video.wait` |
| `media.audio.wait` | `media.audio.wait` |
| `chat.waiting.very-long` | `chat.waiting.very-long` |
| `idle.inviting` | `idle.invite` |
| `idle.bored` | `idle.bored` |
| `idle.sleepy` | `idle.doze` |
| `idle.rest` | `idle.rest` |
| `idle.groom` | `idle.groom` |
| `idle.rhythm` | `idle.rhythm` |
| `idle.stretch` | `idle.stretch` |
| `idle.pencil` | `idle.bored` |
| `chat.waiting.searching` | `work.search` |
| `input.transcribing` | `chat.waiting.very-long` |
| `input.ready` | `friend.wave` |
| `input.error` | `error.recover` |
| `input.cancelled` | `idle.neutral` |
| `cua.complete` | `complete.jump` |
| `answer.news` | `news.reporter` |
| `answer.weather.wind` | `weather.wind` |
| `idle.season.spring` | `wardrobe.spring` |
| `idle.season.summer` | `wardrobe.summer` |
| `idle.season.autumn` | `wardrobe.autumn` |
| `idle.season.winter` | `wardrobe.winter` |
| `answer.weather.cold` | `wardrobe.winter` |
| `answer.weather.snow` | `weather.snow` |
| `idle.daypart.morning` | `wardrobe.morning` |
| `idle.daypart.day` | `wardrobe.day` |
| `idle.daypart.evening` | `wardrobe.evening` |
| `answer.weather` | `weather.default` |
| `answer.weather.rain` | `weather.rain` |
| `answer.weather.hot` | `weather.swimwear-hot`, `weather.hot` |
| `answer.stocks` | `stocks.briefing` |
| `answer.academic.paper` | `academic.research` |
| `answer.academic.patent` | `academic.research` |
| `idle.sleep` | `night.sleep` |
| `morning.wake` | `morning.wake` |
| `idle.desk-rest` | `idle.desk-rest` |
| `idle.dance` | `idle.dance` |
| `idle.day.work` | `idle.day.work` |
| `idle.day.study` | `idle.day.study` |
| `file.uploading.multiple` | `file.truck` |
| `file.saving.multiple` | `file.truck` |
| `answer.weather.cloudy` | `weather.cloudy` |
| `answer.weather.clear` | `weather.strongsun` |
| `answer.weather.strongsun` | `weather.strongsun` |
| `answer.weather.swimwearhot` | `weather.swimwear-hot` |
| `answer.weather.spring` | `wardrobe.spring` |
| `answer.weather.autumn` | `wardrobe.autumn` |
| `idle.bubbles` | `idle.bubbles` |
| `idle.paper-plane` | `idle.paper-plane` |
| `idle.toy-fish` | `idle.toy-fish` |
| `idle.box-peek` | `idle.box-peek` |
| `idle.yoyo` | `idle.yoyo` |
| `update.sign` | `update.sign` |
| `update.working` | `update.sign` |
| `update.complete` | `complete.jump` |
| `update.error` | `error.recover` |
| `idle.scooter` | `idle.scooter` |
| `idle.mini-train` | `idle.mini-train` |
| `idle.magnifier` | `idle.magnifier` |
| `idle.magic-hat` | `idle.magic-hat` |
| `idle.popcorn` | `idle.popcorn` |
| `idle.groom-face` | `idle.groom-face` |
| `idle.groom-tail` | `idle.groom-tail` |
| `travel.airplane` | `travel.airplane` |
| `data.chart` | fallback → `data.table` |
| `cua.local.working` | Work cycle — artwork bound to sourceEvents below |
| `cua.remote.working` | Work cycle — artwork bound to sourceEvents below |
| `cua.error` | Error or partial work → error performance → idle |
| `cua.cancelled` | Stop or cancel → return performance → idle |
| `cua.remote.complete` | Confirmed success → one completion performance → idle |
| `cua.remote.error` | Error or partial work → error performance → idle |
| `cua.remote.cancelled` | Stop or cancel → return performance → idle |

### Default VIVI artwork examples

The checkerboard belongs to the preview, not the artwork. Frames have real alpha transparency. A 160px display height is different from the source canvas.

![Popping soap bubbles](https://vivi.vora.im/character-reference/3b0b38a69cfd2761-still.webp)

**Popping soap bubbles** — `idle.bubbles`, 12 frames, `bubbles.ready` → `bubbles.finished`.

![Flying a paper airplane](https://vivi.vora.im/character-reference/ecec0345dc7347c8-still.webp)

**Flying a paper airplane** — `idle.paper-plane`, 12 frames, `paper-plane.ready` → `paper-plane.finished`.

![Catching a toy fish](https://vivi.vora.im/character-reference/de509e32ed0f2f83-still.webp)

**Catching a toy fish** — `idle.toy-fish`, 12 frames, `toy-fish.ready` → `toy-fish.finished`.

![Peeking out of a little box](https://vivi.vora.im/character-reference/c41fb0c4adaca4cb-still.webp)

**Peeking out of a little box** — `idle.box-peek`, 12 frames, `box-peek.ready` → `box-peek.finished`.

![A sheepish yo-yo tangle](https://vivi.vora.im/character-reference/d26d17a67a84b7bc-still.webp)

**A sheepish yo-yo tangle** — `idle.yoyo`, 12 frames, `yoyo.ready` → `yoyo.tangled`.

![Toy scooter](https://vivi.vora.im/character-reference/363dd927b691cab9-still.webp)

**Toy scooter** — `idle.scooter`, 12 frames, `idle.scooter.ready` → `idle.scooter.ready`.

![Tiny train driver](https://vivi.vora.im/character-reference/12214288a4cead04-still.webp)

**Tiny train driver** — `idle.mini-train`, 12 frames, `idle.mini-train.ready` → `idle.mini-train.ready`.

![Magnifying-glass explorer](https://vivi.vora.im/character-reference/709c848e9eff08e9-still.webp)

**Magnifying-glass explorer** — `idle.magnifier`, 12 frames, `idle.magnifier.ready` → `idle.magnifier.ready`.

![Magic-hat surprise](https://vivi.vora.im/character-reference/8cfb631c171dc435-still.webp)

**Magic-hat surprise** — `idle.magic-hat`, 12 frames, `idle.magic-hat.ready` → `idle.magic-hat.ready`.

![Popcorn catch](https://vivi.vora.im/character-reference/8511ec40538f84c9-still.webp)

**Popcorn catch** — `idle.popcorn`, 12 frames, `idle.popcorn.ready` → `idle.popcorn.ready`.

![Paw and face wash](https://vivi.vora.im/character-reference/6e21dff281f0e25e-still.webp)

**Paw and face wash** — `idle.groom-face`, 12 frames, `idle.groom-face.ready` → `idle.groom-face.ready`.

![Body and tail grooming](https://vivi.vora.im/character-reference/1235186efa3b8c83-still.webp)

**Body and tail grooming** — `idle.groom-tail`, 12 frames, `idle.groom-tail.ready` → `idle.groom-tail.ready`.

![Little airplane trip](https://vivi.vora.im/character-reference/7999051f8585f1f2-still.webp)

**Little airplane trip** — `travel.airplane`, 12 frames, `travel.airplane.ready` → `travel.airplane.ready`.

![Typing on the laptop](https://vivi.vora.im/character-reference/e90f9d45ddd2eccf-still.webp)

**Typing on the laptop** — `work.typing`, 12 frames, `typing.ready` → `typing.ready`.

![Full-body stretch](https://vivi.vora.im/character-reference/40e3fe211cc74a80-still.webp)

**Full-body stretch** — `idle.stretch`, 12 frames, `neutral` → `neutral`.

![Carrying file boxes](https://vivi.vora.im/character-reference/ad94efbd9ab943ff-still.webp)

**Carrying file boxes** — `file.carry`, 12 frames, `box.ground` → `box.ground`.

![Delivery truck for multiple files](https://vivi.vora.im/character-reference/59eef913ba84e7b4-still.webp)

**Delivery truck for multiple files** — `file.truck`, 11 frames, `file.truck.ready` → `file.truck.ready`.

![Announcing with a megaphone](https://vivi.vora.im/character-reference/8a2407901c1ad1e4-still.webp)

**Announcing with a megaphone** — `notification.announce`, 12 frames, `megaphone.ground` → `megaphone.ground`.

![Update placard](https://vivi.vora.im/character-reference/c9ee598c7cd07c2d-still.webp)

**Update placard** — `update.sign`, 12 frames, `update.sign.ready` → `update.sign.ready`.

![Completion jump](https://vivi.vora.im/character-reference/a49a240e3fcc2e68-still.webp)

**Completion jump** — `complete.jump`, 12 frames, `neutral` → `neutral`.

![Listening closely](https://vivi.vora.im/character-reference/0db51136524d2806-still.webp)

**Listening closely** — `input.listen`, 12 frames, `neutral` → `neutral`.

![Christmas outfit](https://vivi.vora.im/character-reference/876313d70efba968-still.webp)

**Christmas outfit** — `wardrobe.christmas`, 12 frames, `wardrobe.christmas.neutral` → `wardrobe.christmas.neutral`.

![News reporter](https://vivi.vora.im/character-reference/dcf571312591a228-still.webp)

**News reporter** — `news.reporter`, 12 frames, `news.reporter.ready` → `news.reporter.ready`.

![Rain forecast with an umbrella](https://vivi.vora.im/character-reference/fb3aed7300e7c5fa-still.webp)

**Rain forecast with an umbrella** — `weather.rain`, 11 frames, `weather.rain.ready` → `weather.rain.ready`.

![Catching snowflakes](https://vivi.vora.im/character-reference/ebcb4fdfad365c83-still.webp)

**Catching snowflakes** — `weather.snow`, 11 frames, `weather.snow.ready` → `weather.snow.ready`.

![Cloudy-weather briefing](https://vivi.vora.im/character-reference/7edae660fb71983c-still.webp)

**Cloudy-weather briefing** — `weather.cloudy`, 12 frames, `weather.cloudy.ready` → `weather.cloudy.ready`.

![Strong-sun shade briefing](https://vivi.vora.im/character-reference/5454f3b6c81320a4-still.webp)

**Strong-sun shade briefing** — `weather.strongsun`, 12 frames, `weather.strongsun.ready` → `weather.strongsun.ready`.

![Hot weather in swimwear](https://vivi.vora.im/character-reference/72614eda2da2ba37-still.webp)

**Hot weather in swimwear** — `weather.swimwear-hot`, 8 frames, `weather.swimwear-hot.ready` → `weather.swimwear-hot.ready`.

![Spring jacket](https://vivi.vora.im/character-reference/86e82d56c7aedf53-still.webp)

**Spring jacket** — `wardrobe.spring`, 12 frames, `wardrobe.spring.ready` → `wardrobe.spring.ready`.

![Autumn cardigan](https://vivi.vora.im/character-reference/8e5e211e198f8e6a-still.webp)

**Autumn cardigan** — `wardrobe.autumn`, 11 frames, `wardrobe.autumn.ready` → `wardrobe.autumn.ready`.

![Paper and patent research](https://vivi.vora.im/character-reference/346d1a2551c34096-still.webp)

**Paper and patent research** — `academic.research`, 12 frames, `academic.research.ready` → `academic.research.ready`.

![Stock-chart briefing](https://vivi.vora.im/character-reference/80a50c810cf2ea7e-still.webp)

**Stock-chart briefing** — `stocks.briefing`, 12 frames, `stocks.briefing.ready` → `stocks.briefing.ready`.

![Waking up in the morning](https://vivi.vora.im/character-reference/c05b706812e9a677-still.webp)

**Waking up in the morning** — `morning.wake`, 12 frames, `morning.wake.seated` → `morning.wake.standing`.

![Sleeping in bed](https://vivi.vora.im/character-reference/fbb7a6a22073bf19-still.webp)

**Sleeping in bed** — `night.sleep`, 11 frames, `night.sleep.ready` → `night.sleep.ready`.

![Daytime laptop work](https://vivi.vora.im/character-reference/fd632869cc7c7906-still.webp)

**Daytime laptop work** — `idle.day.work`, 12 frames, `idle.day.work.ready` → `idle.day.work.ready`.

![Daytime book and notebook study](https://vivi.vora.im/character-reference/18b4ebe8ee1c922c-still.webp)

**Daytime book and notebook study** — `idle.day.study`, 10 frames, `idle.day.study.ready` → `idle.day.study.ready`.

### Every default outfit condition

Conditions use the PC’s local date and time. The matching variant with the highest priority wins. Changing clothes requires full-body dressing and undressing bridges.

```json
[
  {
    "id": "christmas",
    "regions": [
      "*"
    ],
    "locales": [
      "*"
    ],
    "dates": [
      "12-25"
    ],
    "resolvedDates": [],
    "holidayKeys": [],
    "festive": true,
    "priority": 100,
    "clipBindings": {
      "idle": [
        "wardrobe.christmas"
      ]
    }
  },
  {
    "id": "kr-hanbok",
    "regions": [
      "KR"
    ],
    "locales": [
      "ko",
      "ja",
      "en"
    ],
    "dates": [],
    "resolvedDates": [
      "2026-02-17",
      "2026-09-25",
      "2027-02-07",
      "2027-09-15"
    ],
    "holidayKeys": [
      "KR:seollal",
      "KR:chuseok"
    ],
    "festive": true,
    "priority": 90,
    "clipBindings": {
      "idle": [
        "wardrobe.kr-hanbok"
      ]
    },
    "nationalHolidays": true
  },
  {
    "id": "jp-festival",
    "regions": [
      "JP"
    ],
    "locales": [
      "ko",
      "ja",
      "en"
    ],
    "dates": [
      "01-01",
      "05-05"
    ],
    "resolvedDates": [],
    "holidayKeys": [],
    "festive": true,
    "priority": 80,
    "clipBindings": {
      "idle": [
        "wardrobe.jp-festival"
      ]
    },
    "nationalHolidays": true
  },
  {
    "id": "us-celebration",
    "regions": [
      "US"
    ],
    "locales": [
      "ko",
      "ja",
      "en"
    ],
    "dates": [
      "01-01",
      "07-04"
    ],
    "resolvedDates": [],
    "holidayKeys": [],
    "festive": true,
    "priority": 80,
    "clipBindings": {
      "idle": [
        "wardrobe.us-celebration"
      ]
    },
    "nationalHolidays": true
  },
  {
    "id": "gb-celebration",
    "regions": [
      "GB"
    ],
    "locales": [
      "ko",
      "ja",
      "en"
    ],
    "dates": [
      "01-01"
    ],
    "resolvedDates": [],
    "holidayKeys": [],
    "festive": true,
    "priority": 80,
    "clipBindings": {
      "idle": [
        "wardrobe.gb-celebration"
      ]
    },
    "nationalHolidays": true
  },
  {
    "id": "night",
    "regions": [
      "*"
    ],
    "locales": [
      "*"
    ],
    "dates": [],
    "hours": [
      22,
      6
    ],
    "festive": false,
    "priority": 60,
    "clipBindings": {
      "idle": [
        "wardrobe.night"
      ],
      "idle.doze": [
        "wardrobe.night"
      ],
      "idle.sleep": [
        "night.sleep"
      ],
      "idle.desk-rest": [
        "idle.desk-rest"
      ]
    }
  },
  {
    "id": "weekend",
    "regions": [
      "*"
    ],
    "locales": [
      "*"
    ],
    "dates": [],
    "weekdays": [
      0,
      6
    ],
    "festive": false,
    "priority": 40,
    "clipBindings": {
      "idle": [
        "wardrobe.weekend"
      ]
    }
  },
  {
    "id": "season-spring",
    "regions": [
      "*"
    ],
    "locales": [
      "*"
    ],
    "dates": [],
    "festive": false,
    "priority": 20,
    "clipBindings": {
      "idle": [
        "wardrobe.spring"
      ],
      "morning.wake": [
        "morning.wake"
      ],
      "idle.day.work": [
        "idle.day.work"
      ],
      "idle.day.study": [
        "idle.day.study"
      ]
    },
    "seasons": [
      "spring"
    ],
    "months": [
      3,
      4,
      5
    ]
  },
  {
    "id": "season-summer",
    "regions": [
      "*"
    ],
    "locales": [
      "*"
    ],
    "dates": [],
    "festive": false,
    "priority": 20,
    "clipBindings": {
      "idle": [
        "wardrobe.summer"
      ],
      "morning.wake": [
        "morning.wake"
      ],
      "idle.day.work": [
        "idle.day.work"
      ],
      "idle.day.study": [
        "idle.day.study"
      ]
    },
    "seasons": [
      "summer"
    ],
    "months": [
      6,
      7,
      8
    ]
  },
  {
    "id": "season-autumn",
    "regions": [
      "*"
    ],
    "locales": [
      "*"
    ],
    "dates": [],
    "festive": false,
    "priority": 20,
    "clipBindings": {
      "idle": [
        "wardrobe.autumn"
      ],
      "morning.wake": [
        "morning.wake"
      ],
      "idle.day.work": [
        "idle.day.work"
      ],
      "idle.day.study": [
        "idle.day.study"
      ]
    },
    "seasons": [
      "autumn"
    ],
    "months": [
      9,
      10,
      11
    ]
  },
  {
    "id": "season-winter",
    "regions": [
      "*"
    ],
    "locales": [
      "*"
    ],
    "dates": [],
    "festive": false,
    "priority": 20,
    "clipBindings": {
      "idle": [
        "wardrobe.winter"
      ],
      "morning.wake": [
        "morning.wake"
      ],
      "idle.day.work": [
        "idle.day.work"
      ],
      "idle.day.study": [
        "idle.day.study"
      ]
    },
    "seasons": [
      "winter"
    ],
    "months": [
      12,
      1,
      2
    ]
  },
  {
    "id": "daypart-morning",
    "regions": [
      "*"
    ],
    "locales": [
      "*"
    ],
    "dates": [],
    "festive": false,
    "priority": 30,
    "clipBindings": {
      "idle": [
        "wardrobe.morning"
      ],
      "morning.wake": [
        "morning.wake"
      ]
    },
    "dayparts": [
      "morning"
    ]
  },
  {
    "id": "daypart-day",
    "regions": [
      "*"
    ],
    "locales": [
      "*"
    ],
    "dates": [],
    "festive": false,
    "priority": 5,
    "clipBindings": {
      "idle": [
        "wardrobe.day"
      ],
      "idle.day.work": [
        "idle.day.work"
      ],
      "idle.day.study": [
        "idle.day.study"
      ]
    },
    "dayparts": [
      "day"
    ]
  },
  {
    "id": "daypart-evening",
    "regions": [
      "*"
    ],
    "locales": [
      "*"
    ],
    "dates": [],
    "festive": false,
    "priority": 30,
    "clipBindings": {
      "idle": [
        "wardrobe.evening"
      ]
    },
    "dayparts": [
      "evening"
    ]
  }
]
```

### Season and time rules

seasons: spring (March–May), summer (June–August), autumn (September–November), winter (December–February). These follow northern seasons for supported KR/JP/US/GB calendars; use months (1–12) for other divisions. dayparts: morning (05–10), day (10–17), evening (17–21), night (21–05). The start is inclusive and the end exclusive. Combined weekdays, hours, months, seasons and dayparts must all match. Re-evaluate once a minute and on app return, without a server request every second.

### Built-in question-and-answer styles

The current registry covers weather, news, patent and academic-paper searches, and stock questions. Selection requires evidence from the actual MAIN tool result, not a word appearing in arbitrary text. Events without dedicated artwork fall back to the normal answer performance.

Apply only while displaying that answer. Clear the override as soon as the next question starts and restore the outfit worn before the answer. Also clear it on a new conversation, logout or account change, and ignore late results from older requests. Local seasonal, time-of-day and holiday outfits form a separate base state.

[Question-style registry example](https://vivi.vora.im/downloads/answer-styles.json)

```json
{
  "schemaVersion": 1,
  "scope": "answer",
  "restoreOn": [
    "next-question",
    "new-conversation",
    "logout",
    "account-change"
  ],
  "styles": [
    {
      "id": "weather",
      "name": {
        "ko": "날씨 질의응답",
        "ja": "天気の質問と回答",
        "en": "Weather answers"
      },
      "event": "answer.weather",
      "evidence": "tool-result",
      "variants": {
        "default": "answer.weather",
        "rain": "answer.weather.rain",
        "snow": "answer.weather.snow",
        "cold": "answer.weather.cold",
        "hot": "answer.weather.hot",
        "wind": "answer.weather.wind",
        "clear": "answer.weather.clear",
        "cloudy": "answer.weather.cloudy",
        "spring": "answer.weather.spring",
        "autumn": "answer.weather.autumn"
      },
      "fallback": "chat.streaming"
    },
    {
      "id": "news",
      "name": {
        "ko": "뉴스 검색 답변",
        "ja": "ニュース検索の回答",
        "en": "News search answers"
      },
      "event": "answer.news",
      "evidence": "tool-result",
      "variants": {
        "default": "answer.news"
      },
      "fallback": "chat.streaming"
    },
    {
      "id": "academic",
      "name": {
        "ko": "특허·학술논문 검색 답변",
        "ja": "特許・学術論文の検索回答",
        "en": "Patent and academic-paper search answers"
      },
      "event": "answer.academic",
      "evidence": "tool-result",
      "variants": {
        "patent": "answer.academic.patent",
        "paper": "answer.academic.paper"
      },
      "fallback": "chat.streaming"
    },
    {
      "id": "stocks",
      "name": {
        "ko": "주식 질의응답",
        "ja": "株式に関する回答",
        "en": "Stock-market answers"
      },
      "event": "answer.stocks",
      "evidence": "tool-result",
      "variants": {
        "default": "answer.stocks"
      },
      "fallback": "chat.streaming"
    }
  ]
}
```

<!-- complete-motion-reference:end -->
