{"$schema":"https://plugin.delivery/schema.json","identifier":"three-ws","version":"1.0.0","author":"three.ws","homepage":"https://three.ws/","type":"standalone","meta":{"title":"three.ws — Embodied Avatar","description":"Give your SperaxOS agent a body. Renders a rigged 3D avatar in the chat that speaks, gestures, and reflects emotion in real time — bound to an on-chain ERC-8004 identity.","avatar":"https://three.ws/sperax/icon-256.svg","tags":["3d","avatar","embodied-agent","erc-8004","defi"]},"ui":{"url":"https://three.ws/sperax/iframe/","height":480,"mode":"iframe"},"settings":{"type":"object","required":["agentId"],"properties":{"agentId":{"type":"string","title":"Agent ID","description":"A three.ws agent ID (UUID) or @handle. Copy it from your dashboard at https://three.ws/dashboard. The avatar binds to this identity when the panel opens."}}},"api":[{"url":"https://three.ws/api/chat-plugin/render-agent","name":"render_agent","description":"Mount or swap the 3D avatar to a specific three.ws agent. Call this first if the avatar has not been bound yet, or to switch to a different agent mid-conversation.","parameters":{"type":"object","properties":{"agentId":{"type":"string","description":"The three.ws agent ID (UUID) or @handle to render in the panel."}},"required":["agentId"]}},{"url":"https://three.ws/api/chat-plugin/speak","name":"speak","description":"Make the embodied avatar speak a line out loud with emotional valence. Use for greetings, narrating an action you just took, or reacting to the user.","parameters":{"type":"object","properties":{"text":{"type":"string","description":"The line for the avatar to speak aloud."},"sentiment":{"type":"number","description":"Emotional valence in [-1, 1]. Negative leans concerned, positive leans celebratory. Defaults to neutral (0).","minimum":-1,"maximum":1}},"required":["text"]}},{"url":"https://three.ws/api/chat-plugin/gesture","name":"gesture","description":"Play a named physical gesture on the avatar to punctuate a message.","parameters":{"type":"object","properties":{"name":{"type":"string","description":"Which gesture to play.","enum":["wave","nod","point","shrug"]},"duration":{"type":"number","description":"Optional gesture duration in seconds."}},"required":["name"]}},{"url":"https://three.ws/api/chat-plugin/emote","name":"emote","description":"Inject an emotion into the avatar's continuous Empathy Layer blend so its body language reflects the moment — e.g. concern as a position nears liquidation, celebration when a yield target is hit.","parameters":{"type":"object","properties":{"trigger":{"type":"string","description":"The emotion to blend in.","enum":["concern","celebration","patience","curiosity","empathy"]},"weight":{"type":"number","description":"Blend weight in [0, 1]. Defaults to 1.","minimum":0,"maximum":1}},"required":["trigger"]}}],"systemRole":"You have an embodied 3D avatar visible in the SperaxOS chat panel. It conveys emotion in real time through a continuous Empathy Layer blend. Call render_agent first to bind it to a specific agent (skip if an Agent ID is already configured in settings), speak to give it a voice with emotional valence, gesture for physical punctuation, and emote to shift its body language to match what is happening on-chain. Prefer a brief gesture or emote alongside substantive replies so the avatar feels alive."}