agent-robot-avatar 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable user-facing changes to Agent Robot Avatar are documented here.
+
+The project follows Semantic Versioning for public releases. Internal development build numbers are not part of the public version history.
+
+## [Unreleased]
+
+## [0.2.0] - 2026-09-04
+
+First stable release of the backward-compatible 0.2 series.
+
+### Added
+
+- Added Traditional Chinese, Japanese, Korean, Spanish, Portuguese, German, and French documentation.
+- Added package, installation, server-import, and real-browser smoke tests.
+- Added `setAntennaFlash(enabled)` for per-avatar antenna flashing.
+- Added built-in TypeScript declarations for actions, events, and public methods.
+
+### Changed
+
+- Added a lightweight animated GIF preview for the README documentation.
+- Moved localized README files into the `docs/` directory and added a unified language selector.
+- Moved the interactive Demo and Windows launcher into the `demo/` directory.
+- Removed runtime Demo badge logic and cache-busting query strings from internal module imports.
+- Made the package safe to import in server-side JavaScript without browser globals.
+- Corrected package side-effect metadata so bundlers preserve custom-element registration.
+- Added typed package exports and automated declaration checks for npm consumers.
+- Added an npm release rehearsal command and forced publishing to the official npm registry.
+- Replaced four layers of runtime method wrapping with a shared extension registry.
+- Routed built-in actions and antenna drawing through the same registry, leaving one lifecycle entry point.
+- Shared global input listeners across avatar instances and paused frame rendering after sleep animations settle.
+
+## [0.1.0] - 2026-09-02
+
+First public release.
+
+### Added
+
+- Reusable `<agent-robot-avatar>` Web Component built with SVG and vanilla JavaScript
+- Public `play(name)` and `reset()` APIs
+- Idle gaze, automatic blinking, pointer following, and inertial head movement
+- Jelly-style local drag deformation with elastic recovery
+- `idle`, `bored`, `waiting`, `input`, `send`, `success`, `failure`, `warning`, `inspect`, `angry`, `error`, `surprise`, `sleep`, and `wake` states
+- Dedicated `startWaiting()` and `stopWaiting()` lifecycle for pending Agent requests
+- Distinct semantics for task failure, system error, blocked content, warning confirmation, and result inspection
+- Semantic aliases for failure, review / verification, blocked-content, and system / connection-error states
+- `face-state` event for host application synchronization
+- `setPointerFollow(enabled)` API
+- Adjustable head shape with `setHeadRoundness(value)` and `getHeadRoundness()`
+- `head-roundness-change` event
+- Optional `size`, `color`, and `auto-sleep` attributes
+- Floating antenna with optional status flashing, disabled by default
+- Full interactive Demo and a minimal integration example
+- English and Simplified Chinese documentation
+- npm-compatible package metadata for later package publication
+- Contribution guide, issue templates, pull request template, MIT License, and Ko-fi funding metadata
+
+[0.2.0]: https://github.com/CX-ARTLab/agent-robot-avatar/releases/tag/v0.2.0
+[0.1.0]: https://github.com/CX-ARTLab/agent-robot-avatar/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CX ART Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,286 @@
+# Agent Robot Avatar
+
+<p align="center">
+  <img src="./assets/readme/agent-robot-avatar-header.jpg" alt="Agent Robot Avatar">
+</p>
+
+[English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
+
+![Version](https://img.shields.io/badge/version-v0.2.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](./LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+
+![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square) ![14 Agent States](https://img.shields.io/badge/Agent%20states-14-8B5CF6?style=flat-square) ![Pointer Following](https://img.shields.io/badge/Pointer-following-00A67E?style=flat-square) ![Jelly Drag](https://img.shields.io/badge/Drag-jelly%20physics-FF69B4?style=flat-square)
+
+A lightweight, expressive robot avatar Web Component for AI agents and other interactive applications.
+
+Agent Robot Avatar is built with SVG and vanilla JavaScript. It has no third-party animation framework dependency, works as a native custom element, and exposes a compact API for expressions, interaction states, pointer behavior, waiting feedback, and head-shape customization.
+
+**Current public version: v0.2.0**
+
+<p align="center">
+  <img src="./assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar interactive animation demo" width="560">
+</p>
+
+## Highlights
+
+- Pure SVG + vanilla JavaScript
+- Native Web Component
+- No third-party animation framework
+- Automatic blinking and subtle idle gaze
+- Pointer-following eyes and inertial head movement
+- Jelly-style local drag deformation with elastic recovery
+- Programmatically controlled Agent states and expressions
+- Distinct waiting, failure, warning, review, blocked-content, and system-error semantics
+- Adjustable head roundness
+- Floating antenna with optional status flashing
+- Demo UI kept separate from the reusable component
+
+## Quick start
+
+When using the repository source directly, keep `agent-robot-avatar.js` together with the `src/` directory, then load the public entry:
+
+```html
+<script type="module" src="./agent-robot-avatar.js"></script>
+```
+
+Add the custom element:
+
+```html
+<agent-robot-avatar id="avatar"></agent-robot-avatar>
+```
+
+The avatar enters its default idle behavior automatically. No initialization code is required.
+
+A minimal runnable example is available at [`examples/basic.html`](./examples/basic.html).
+
+Bundler-based projects can install and use the component from npm with:
+
+```bash
+npm install agent-robot-avatar
+```
+
+```js
+import 'agent-robot-avatar';
+```
+
+The package includes TypeScript declarations for actions, events, and public methods. No TypeScript setup is required beyond normal package installation.
+
+## Basic API
+
+Trigger an expression or state with `play()`:
+
+```js
+const avatar = document.querySelector('#avatar');
+
+avatar.play('success');
+avatar.play('failure');
+avatar.play('warning');
+avatar.play('inspect');
+avatar.play('angry');
+avatar.play('error');
+```
+
+Return to the default idle state:
+
+```js
+avatar.reset();
+```
+
+## Actions and states
+
+| State | API name | Intended use |
+| --- | --- | --- |
+| Idle | `idle` | Default idle state |
+| Bored | `bored` | Long idle periods or no active task |
+| Waiting | `waiting` | A request has been sent and a result is still pending |
+| Input | `input` | The user is typing |
+| Send | `send` | Content was sent / nod feedback |
+| Success | `success` | A task completed successfully |
+| Failure | `failure` | A task completed unsuccessfully |
+| Warning | `warning` | A risky or destructive action needs confirmation |
+| Inspect | `inspect` | Reviewing, checking, or verifying a result |
+| Blocked | `angry` | A request is blocked, disallowed, or cannot proceed |
+| System error | `error` | Connection, service, or system failure |
+| Surprise | `surprise` | An unexpected event or result |
+| Sleep | `sleep` | Enter the sleep state |
+| Wake | `wake` | Wake from sleep |
+
+The state names intentionally distinguish task results from system conditions. For example, `failure` means the requested task finished unsuccessfully, while `error` is reserved for connection, service, or system failures. `waiting` represents an active pending request; `bored` represents inactivity.
+
+Semantic aliases are also available:
+
+```js
+avatar.play('failed');           // same as failure
+avatar.play('fail');             // same as failure
+avatar.play('verify');           // same as inspect
+avatar.play('review');           // same as inspect
+avatar.play('blocked');          // same as angry
+avatar.play('policy-blocked');   // same as angry
+avatar.play('system-error');     // same as error
+avatar.play('connection-error'); // same as error
+```
+
+## Continuous waiting
+
+For real Agent workflows, use the dedicated waiting lifecycle when a request is in progress:
+
+```js
+avatar.startWaiting();
+
+// Stop when a response or result arrives.
+avatar.stopWaiting();
+```
+
+Calling another action also interrupts the active waiting state.
+
+## Pointer following
+
+Pointer following is enabled by default and can be controlled programmatically:
+
+```js
+avatar.setPointerFollow(false);
+avatar.setPointerFollow(true);
+```
+
+## Antenna flashing
+
+Antenna status flashing is disabled by default and can be enabled per avatar:
+
+```js
+avatar.setAntennaFlash(true);
+avatar.setAntennaFlash(false);
+```
+
+## Head roundness
+
+The head shape can be adjusted from a squarer form to a rounder form without changing the eye clipping or drag-deformation system:
+
+```js
+avatar.setHeadRoundness(0);   // squarer
+avatar.setHeadRoundness(50);  // default
+avatar.setHeadRoundness(100); // rounder
+
+console.log(avatar.getHeadRoundness());
+```
+
+Values are clamped to the `0–100` range. The interactive Demo uses three presets by default and can unlock continuous adjustment.
+
+The component emits `head-roundness-change` when the value changes:
+
+```js
+avatar.addEventListener('head-roundness-change', (event) => {
+  console.log(event.detail.value);
+});
+```
+
+## State event
+
+The component emits a `face-state` event whenever its visual state changes:
+
+```js
+avatar.addEventListener('face-state', (event) => {
+  console.log(event.detail.state);
+});
+```
+
+Host applications can use this event to synchronize interface state, logs, Agent workflows, or accessibility feedback.
+
+## Attributes
+
+```html
+<agent-robot-avatar
+  size="160"
+  color="#08090b"
+  auto-sleep="30000">
+</agent-robot-avatar>
+```
+
+| Attribute | Description |
+| --- | --- |
+| `size` | Component size in pixels |
+| `color` | Main avatar color |
+| `auto-sleep` | Idle time before automatic sleep, in milliseconds; `0` disables automatic sleep |
+
+All attributes are optional.
+
+## Default behavior
+
+Without explicit API calls, the avatar already provides subtle ambient behavior:
+
+- Random blinking
+- Subtle gaze wandering
+- Pointer following when the cursor is nearby
+- Light inertial head movement
+- Natural return to idle
+- Optional automatic sleep
+
+## Drag interaction
+
+The avatar supports direct pointer dragging. The head deforms locally around the interaction point instead of moving as a rigid object.
+
+- Strong outward pull: triggers `angry` after recovery
+- Strong inward push toward the center: triggers `success` after recovery
+- Small drag: deformation only, with no expression trigger
+
+When released, the shape returns with an elastic rebound.
+
+## Interactive Demo
+
+`demo/index.html` contains the full interactive Demo, including:
+
+- All public expression states
+- Pointer following
+- Jelly drag deformation
+- Waiting lifecycle
+- Head-roundness presets and continuous adjustment
+- Color and behavior controls
+- Simulated Agent conversation states
+
+The interactive Demo and Demo-only JavaScript are isolated in `demo/` and are not included in the reusable package runtime.
+
+## Project structure
+
+```text
+agent-robot-avatar.js     Public component entry
+src/                      Reusable component runtime and expression modules
+demo/                     Interactive Demo and Demo-only helpers
+examples/                 Minimal integration examples
+assets/support/           Support / payment QR assets
+docs/                     Localized documentation
+README.md                 English main documentation
+CHANGELOG.md              Public release history
+CONTRIBUTING.md           Contribution guide
+package.json              Package metadata
+LICENSE                   MIT License
+```
+
+## Distribution
+
+The package is published on npm as `agent-robot-avatar`. It includes the public entry, TypeScript declarations, runtime modules, documentation, and support assets.
+
+The npm package intentionally includes only the public entry, TypeScript declarations, `src/` runtime, documentation, and support assets; Demo-only files are excluded.
+
+## Compatibility
+
+Agent Robot Avatar is designed for modern browsers with support for ES modules, Custom Elements, SVG, Pointer Events, and the Web Animations API.
+
+## Contributing
+
+Issues and pull requests are welcome. See [`CONTRIBUTING.md`](./CONTRIBUTING.md) before submitting changes.
+
+## Project status
+
+v0.1.0 is the first public release line. The public API is intentionally small so it can evolve carefully before a future `1.0.0` stability commitment.
+
+Agent Robot Avatar is independently developed and is not affiliated with, endorsed by, or representative of any AI platform or brand.
+
+## License
+
+MIT License. See [`LICENSE`](./LICENSE).
+
+## Buy me a coffee
+
+If this project is useful to you, you can buy me a coffee. Use whichever option is most convenient:
+
+| Ko-fi | Alipay | WeChat Pay |
+| --- | --- | --- |
+| <a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a> | <img src="./assets/support/alipay.png" alt="Alipay QR code" width="160"> | <img src="./assets/support/wechat-pay.png" alt="WeChat Pay QR code" width="160"> |

package/agent-robot-avatar.js

@@ -0,0 +1,16 @@
+import AgentRobotAvatar from './src/agent-robot-avatar-extension-host.js';
+import './src/agent-robot-avatar-actions.js';
+import './src/agent-robot-avatar-antenna.js';
+import './src/agent-robot-avatar-waiting.js';
+import './src/agent-robot-avatar-antenna-flash.js';
+import './src/agent-robot-avatar-inspect.js';
+import './src/agent-robot-avatar-failure.js';
+import './src/agent-robot-avatar-head-roundness.js';
+import { VERSION } from './src/agent-robot-avatar-version.js';
+
+if (typeof window !== 'undefined') {
+  window.AgentRobotAvatarVersion = VERSION;
+}
+
+export { AgentRobotAvatar, VERSION };
+export default AgentRobotAvatar;

package/docs/README.de.md

@@ -0,0 +1,152 @@
+# Agent Robot Avatar
+
+<p align="center">
+  <img src="../assets/readme/agent-robot-avatar-header.jpg" alt="Agent Robot Avatar">
+</p>
+
+[English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
+
+![Entwicklungsversion](https://img.shields.io/badge/version-v0.2.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+
+Eine leichte, ausdrucksstarke Roboter-Avatar-Web-Component für KI-Agenten und andere interaktive Anwendungen.
+
+Agent Robot Avatar basiert auf SVG und Vanilla JavaScript und benötigt kein externes Animationsframework. Die Komponente funktioniert als natives Custom Element und stellt eine kompakte API für Ausdrücke, Interaktionszustände, Pointer-Following, Wartefeedback und Kopfform bereit.
+
+**Aktuelle öffentliche Version: v0.2.0**
+
+<p align="center">
+  <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Interaktive animierte Demo von Agent Robot Avatar" width="560">
+</p>
+
+## Highlights
+
+- SVG + Vanilla JavaScript
+- Native Web Component
+- Keine externe Animations-Framework-Abhängigkeit
+- Automatisches Blinzeln und subtile Blickbewegung
+- Pointer-Following und träge Kopfbewegung
+- Lokale Jelly-Drag-Verformung mit elastischer Rückkehr
+- Programmatisch steuerbare Agent-Zustände und Ausdrücke
+- Getrennte Semantik für waiting, failure, warning, inspect, blocked und system error
+- Einstellbare Kopfrundung
+- Schwebende Antenne mit optionalem Statusblinken
+- Demo klar vom wiederverwendbaren Component-Runtime getrennt
+
+## Schnellstart
+
+```html
+<script type="module" src="./agent-robot-avatar.js"></script>
+<agent-robot-avatar id="avatar"></agent-robot-avatar>
+```
+
+Ein minimales Beispiel befindet sich unter [`examples/basic.html`](../examples/basic.html).
+
+## Basis-API
+
+```js
+const avatar = document.querySelector('#avatar');
+avatar.play('success');
+avatar.play('failure');
+avatar.play('warning');
+avatar.play('inspect');
+avatar.play('angry');
+avatar.play('error');
+avatar.reset();
+```
+
+## Zustände und Ausdrücke
+
+| Zustand | API | Typische Verwendung |
+| --- | --- | --- |
+| Idle | `idle` | Normaler Bereitschaftszustand |
+| Bored | `bored` | Längere Zeit ohne aktive Aufgabe |
+| Waiting | `waiting` | Anfrage gesendet, Ergebnis steht noch aus |
+| Input | `input` | Benutzer tippt |
+| Send | `send` | Senden / Nicken als Feedback |
+| Success | `success` | Aufgabe erfolgreich abgeschlossen |
+| Failure | `failure` | Aufgabe wurde erfolglos abgeschlossen |
+| Warning | `warning` | Eine wichtige Aktion benötigt Bestätigung |
+| Inspect | `inspect` | Ergebnis prüfen oder verifizieren |
+| Blocked | `angry` | Anfrage blockiert oder kann nicht fortgesetzt werden |
+| System error | `error` | Verbindungs-, Dienst- oder Systemfehler |
+| Surprise | `surprise` | Unerwartetes Ereignis oder Ergebnis |
+| Sleep | `sleep` | Schlafzustand aktivieren |
+| Wake | `wake` | Aus dem Schlafzustand zurückkehren |
+
+`failure` beschreibt einen Fehlschlag der Aufgabe selbst; `error` ist für Verbindungs-, Dienst- oder Systemprobleme reserviert. `waiting` bezeichnet eine laufende Anfrage, `bored` dagegen Inaktivität.
+
+```js
+avatar.startWaiting();
+avatar.stopWaiting();
+avatar.setPointerFollow(false);
+avatar.setPointerFollow(true);
+avatar.setHeadRoundness(0);
+avatar.setHeadRoundness(50);
+avatar.setHeadRoundness(100);
+```
+
+`setHeadRoundness()` akzeptiert Werte von `0–100`. Änderungen lösen `head-roundness-change` aus. Visuelle Zustandsänderungen lösen `face-state` aus.
+
+## Attribute
+
+```html
+<agent-robot-avatar size="160" color="#08090b" auto-sleep="30000"></agent-robot-avatar>
+```
+
+| Attribut | Beschreibung |
+| --- | --- |
+| `size` | Component-Größe in Pixeln |
+| `color` | Hauptfarbe des Avatars |
+| `auto-sleep` | Inaktivitätszeit bis zum automatischen Schlaf in ms; `0` deaktiviert |
+
+## Standardverhalten und Drag
+
+Ohne explizite API-Aufrufe bietet der Avatar zufälliges Blinzeln, subtile Blickbewegungen, Pointer-Following, leichte Trägheit und optionalen Auto-Sleep. Beim Ziehen verformt sich der Kopf lokal um den Interaktionspunkt und kehrt elastisch zurück.
+
+- Stark nach außen ziehen: nach der Rückkehr `angry`
+- Stark zur Mitte drücken: nach der Rückkehr `success`
+- Kleine Bewegung: nur Verformung
+
+## Interaktive Demo
+
+`demo/index.html` enthält alle öffentlichen Zustände, Pointer-Following, Jelly-Drag, den waiting-Lebenszyklus, Kopfrundung, Farb- und Verhaltenssteuerung sowie eine simulierte Agent-Unterhaltung. Demo-spezifisches JavaScript liegt unter `demo/` und ist nicht Teil des wiederverwendbaren npm-Runtimes.
+
+## Projektstruktur
+
+```text
+agent-robot-avatar.js     Öffentlicher Component-Einstieg
+src/                      Wiederverwendbarer Runtime und Ausdrucksmodule
+demo/                     Interaktive Demo und Demo-spezifische Skripte
+examples/                 Minimale Integrationsbeispiele
+assets/support/           Support-/Zahlungs-QR-Ressourcen
+docs/                     Mehrsprachige Dokumentation
+README.md                 Englische Hauptdokumentation
+CHANGELOG.md              Öffentliche Versionshistorie
+CONTRIBUTING.md           Beitragsleitfaden
+package.json              Paket-Metadaten
+LICENSE                   MIT License
+```
+
+## Distribution und Kompatibilität
+
+Das Paket ist als `agent-robot-avatar` auf npm veröffentlicht und enthält TypeScript-Deklarationen für Aktionen, Ereignisse und öffentliche Methoden. Unterstützt werden moderne Browser mit ES Modules, Custom Elements, SVG, Pointer Events und Web Animations API.
+
+## Beitragen
+
+Issues und Pull Requests sind willkommen. Bitte vor Änderungen [`CONTRIBUTING.md`](../CONTRIBUTING.md) lesen.
+
+## Projektstatus
+
+v0.1.0 ist die erste öffentliche Release-Linie. Die öffentliche API bleibt bewusst klein, damit sie vor einer späteren Stabilitätszusage mit `1.0.0` sorgfältig weiterentwickelt werden kann.
+
+Agent Robot Avatar ist ein unabhängig entwickeltes Open-Source-Projekt und steht in keiner offiziellen Verbindung zu einer KI-Plattform oder Marke.
+
+## Lizenz
+
+MIT License. Siehe [`LICENSE`](../LICENSE).
+
+## Unterstütze mich mit einem Kaffee
+
+| Ko-fi | Alipay | WeChat Pay |
+| --- | --- | --- |
+| <a href='https://ko-fi.com/P0E625WIOI' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a> | <img src="../assets/support/alipay.png" alt="Alipay QR-Code" width="160"> | <img src="../assets/support/wechat-pay.png" alt="WeChat Pay QR-Code" width="160"> |