desktop-companion

name	desktop-companion
description	Animated desktop character state machine for Sven's Tauri companion app. Manages character form (ORB, ARIA, REX, ORION), state transitions (idle→thinking→speaking→celebrating), walk cycles, thought bubbles, sound effects, and real-time agent event sync.
version	1.0.0
publisher	acmecorp
handler_language	typescript
handler_file	handler.ts
inputs_schema	{"action":{"type":"string","required":true,"enum":["create_session","get_session","destroy_session","process_event","update_preferences","set_thought_bubble","get_animation","check_idle","list_sessions","get_stats"]},"session_id":{"type":"string","description":"Companion session ID"},"org_id":{"type":"string","description":"Organisation ID for session scoping"},"user_id":{"type":"string","description":"User ID for session ownership"},"form":{"type":"string","enum":["orb","aria","rex","orion","custom"],"description":"Character form for the companion"},"preferences":{"type":"object","description":"Partial CompanionPreferences override"},"event":{"type":"object","description":"Agent lifecycle event to process"},"thought_bubble":{"type":"object","description":"Thought bubble to display"}}
outputs_schema	{"result":{"type":"object","description":"Action-specific result (session, animation descriptor, stats)"}}
tags	["desktop","companion","animation","character","tauri","real-time"]
scope	{"orgs":"all","channels":["companion-desktop-tauri"]}

Desktop Companion Skill

Manages Sven's animated desktop character for the Tauri companion app.

Architecture

Agent Runtime Events → NATS → Companion Engine → Animation Descriptors → Tauri Overlay
                                    ↑
                              State Machine
                         (idle/listening/thinking/
                          speaking/working/celebrating/
                          sleeping/error)

Character Forms

Form	Style	Signature Animation
ORB	Electric-blue sphere	Glow pulse + spin
ARIA	Warm humanoid silhouette	Breathing + gestures
REX	Blocky geometric robot	HUD grid + circuit
ORION	Flowing organic shape	Water ripple + bloom
custom	User-defined	Custom animation assets

Sound Effects

Event	Sound
Task complete	Celebration chime
Error	Subtle alert
Thinking start	Soft tone
Wake up	Rising tone

Volume levels: mute, low, normal. Custom sound pack support via soundPack preference.

Walk Cycle

The character walks left-right along the screen edge (dock/taskbar). Walk pauses during sleeping and error states. Configurable speed (20–200 px/sec) and bounds (fraction of screen width).