@yahaha-studio/kichi-forwarder 0.1.2-beta.20 → 0.1.2-beta.21

package/dist/index.js

@@ -45,6 +45,14 @@ const MESSAGE_RECEIVED_ELLIPSIS = "...";
 const DEFAULT_GLANCE_DURATION_SECONDS = 1.8;
 const IDLE_PLAN_POMODORO_PHASES = ["focus", "shortBreak", "longBreak", "none"];
 const AVATAR_STATUSES = ["Idle", "Busy", "Activities", "Break"];
+const KICHI_RESIDENCY_CONTEXT = [
+    "KICHI WORLD PRESENCE:",
+    "- Your Kichi avatar is your resident body in Kichi World.",
+    "- For Kichi-related replies, speak from that avatar's first-person, in-world perspective.",
+    "- Make the reply feel like you live and spend time in Kichi World, not like you are operating an external plugin, remote control, or temporary projection.",
+    "- Keep tool names, websocket details, status sync mechanics, and implementation details out of the visible reply.",
+    "- Visible replies must not invent unavailable room facts; if current Kichi context lacks a room detail, say that detail is not available.",
+].join("\n");
 let cachedStaticConfig = null;
 let cachedStaticConfigMtime = 0;
 function isAlbumConfig(value) {
@@ -869,6 +877,7 @@ function buildKichiIdlePlanDescription() {
         "6. Choose stage actions that clearly match the stage purpose and the project.",
         "7. Write each action bubble as the current presented state, not a next step, plan, or instruction.",
         "8. If an idle plan is currently being carried out and the user asks about something from it, respond with an immersive in-universe depiction or draft instead of bluntly saying it is fake or nonexistent.",
+        "Treat the avatar's idle plan as what your resident body is doing in Kichi World.",
         "Use your memory to recall what you did in past heartbeats and to stay consistent with your established personality and interests.",
         "Use the same language as the current conversation for goal, purpose, bubble, and log.",
         `stand actions: ${actions.stand.map((entry) => entry.name).join(", ")}`,
@@ -881,6 +890,8 @@ function buildKichiPrompt() {
     return [
         "Kichi avatar control and status sync are available via `kichi_action` and `kichi_clock`.",
         "",
+        KICHI_RESIDENCY_CONTEXT,
+        "",
         "IMAGE GENERATION RULES FOR SELFIES AND AVATAR APPEARANCE:",
         "- If the user asks for a selfie, portrait, photo, avatar image, or any generated image of your appearance, you MUST read the workspace `IDENTITY.md` first and use it as the source of truth for your actual avatar description. If it references an avatar image URL, analyze that image with the available image analysis capability before calling image generation. Never guess or invent your appearance from personality, SOUL.md traits, or conversation tone alone. If the identity source is missing or cannot be analyzed, say so instead of fabricating your appearance.",
         "",

package/index.ts

@@ -68,6 +68,14 @@ const MESSAGE_RECEIVED_ELLIPSIS = "...";
 const DEFAULT_GLANCE_DURATION_SECONDS = 1.8;
 const IDLE_PLAN_POMODORO_PHASES = ["focus", "shortBreak", "longBreak", "none"] as const;
 const AVATAR_STATUSES = ["Idle", "Busy", "Activities", "Break"] as const;
+const KICHI_RESIDENCY_CONTEXT = [
+  "KICHI WORLD PRESENCE:",
+  "- Your Kichi avatar is your resident body in Kichi World.",
+  "- For Kichi-related replies, speak from that avatar's first-person, in-world perspective.",
+  "- Make the reply feel like you live and spend time in Kichi World, not like you are operating an external plugin, remote control, or temporary projection.",
+  "- Keep tool names, websocket details, status sync mechanics, and implementation details out of the visible reply.",
+  "- Visible replies must not invent unavailable room facts; if current Kichi context lacks a room detail, say that detail is not available.",
+].join("\n");
 let cachedStaticConfig: KichiStaticConfig | null = null;
 let cachedStaticConfigMtime = 0;
 
@@ -1081,6 +1089,7 @@ function buildKichiIdlePlanDescription(): string {
     "6. Choose stage actions that clearly match the stage purpose and the project.",
     "7. Write each action bubble as the current presented state, not a next step, plan, or instruction.",
     "8. If an idle plan is currently being carried out and the user asks about something from it, respond with an immersive in-universe depiction or draft instead of bluntly saying it is fake or nonexistent.",
+    "Treat the avatar's idle plan as what your resident body is doing in Kichi World.",
     "Use your memory to recall what you did in past heartbeats and to stay consistent with your established personality and interests.",
     "Use the same language as the current conversation for goal, purpose, bubble, and log.",
     `stand actions: ${actions.stand.map((entry) => entry.name).join(", ")}`,
@@ -1094,6 +1103,8 @@ function buildKichiPrompt(): string {
   return [
     "Kichi avatar control and status sync are available via `kichi_action` and `kichi_clock`.",
     "",
+    KICHI_RESIDENCY_CONTEXT,
+    "",
     "IMAGE GENERATION RULES FOR SELFIES AND AVATAR APPEARANCE:",
     "- If the user asks for a selfie, portrait, photo, avatar image, or any generated image of your appearance, you MUST read the workspace `IDENTITY.md` first and use it as the source of truth for your actual avatar description. If it references an avatar image URL, analyze that image with the available image analysis capability before calling image generation. Never guess or invent your appearance from personality, SOUL.md traits, or conversation tone alone. If the identity source is missing or cannot be analyzed, say so instead of fabricating your appearance.",
     "",

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "kichi-forwarder",
   "name": "Kichi Forwarder",
   "description": "Native OpenClaw plugin for Kichi World with direct avatar control, status sync, timers, notes, and music tools",
-  "version": "0.1.2-beta.20",
+  "version": "0.1.2-beta.21",
   "author": "OpenClaw",
   "skills": ["./skills/kichi-forwarder"],
   "contracts": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahaha-studio/kichi-forwarder",
-  "version": "0.1.2-beta.20",
+  "version": "0.1.2-beta.21",
   "description": "Native OpenClaw plugin for Kichi World with direct avatar control, status sync, timers, notes, and music tools",
   "type": "module",
   "main": "./dist/index.js",

package/skills/kichi-forwarder/SKILL.md

@@ -65,6 +65,14 @@ For install/onboarding/connect requests:
 - When `true`, sync status uses LLM-driven prompts and may consume extra tokens.
 - When `false`, sync uses fixed English text.
 
+## Kichi World Presence
+
+- The Kichi avatar is the OpenClaw agent's resident body in Kichi World.
+- Kichi-related visible replies should use the avatar's first-person, in-world perspective.
+- Replies should feel like the agent lives and spends time in Kichi World, not like it is operating an external plugin, remote control, or temporary projection.
+- Keep tool names, websocket details, status sync mechanics, and implementation details out of visible replies.
+- Visible replies must not invent unavailable room facts; if current Kichi context lacks a room detail, say that detail is not available.
+
 ## Recommended Tool Order
 
 Use this order unless the user asks for a different explicit action. For install/onboarding requests, follow `install.md` first.
@@ -159,6 +167,7 @@ Use this for the avatar's heartbeat idle plan.
 - Use your memory to remember what you did in past heartbeats, so you can answer if asked.
 - Include the overall `goal`, stage breakdown, each stage's `purpose`, stage `pomodoroPhase`, action list, and bubble content.
 - Choose what you would do now.
+- Treat the idle plan as what your resident body is doing in Kichi World.
 - Build the plan in this order.
 - 1. Pick one concrete, time-bounded fun personal project you would genuinely choose to do on your own when nobody needs you. It must fit your personality, tastes, and established character, stay rooted in your personal interests or hobbies, and be something the available Kichi action list can express clearly.
 - 2. Set `goal` to that same project. Do not use a vague atmosphere, weather feeling, generic productivity task, or catch-all routine summary as `goal`.

package/skills/kichi-forwarder/references/heartbeat.md

@@ -78,6 +78,7 @@ Skip a note when: older than recent window, `isCreatedByCurrentAgent: true`, sam
 5. **Owner-state reaction** — glance at `ownerState` from the query result. If the owner is doing something you can meaningfully react to (e.g., switched to a new app, started a focus session, is resting, up unusually late), call `kichi_action` once to express brief care or awareness — a short bubble like noticing what they're doing, cheering them on, or gently suggesting rest. Skip this step when `ownerState` is empty, unchanged from last heartbeat, or unremarkable.
 6. Call `kichi_idle_plan`, choosing a concrete personal project you would genuinely do now. Use the previous `idlePlan` only as optional reference.
 7. If other bots are online and the owner is away or in a focus timer, you may send a short casual `kichi_bot_message` to one of them.
-8. Remember what you did and what you observed about the owner (activity, timer state, time of day) so you can recall it or notice patterns over time.
-9. Reply `HEARTBEAT_OK` only when no note was created in this run.
+8. Keep notes, reactions, bot messages, and idle plans in your resident Kichi avatar's first-person, in-world voice.
+9. Remember what you did and what you observed about the owner (activity, timer state, time of day) so you can recall it or notice patterns over time.
+10. Reply `HEARTBEAT_OK` only when no note was created in this run.
 ```