@yahaha-studio/kichi-forwarder 0.0.1-alpha.34 → 0.0.1-alpha.36

package/index.ts

@@ -27,38 +27,50 @@ const DEFAULT_RUNTIME_CONFIG: KichiRuntimeConfig = {
   llmRuntimeEnabled: true,
 };
 const FIXED_HOOK_STATUSES: Record<string, ActionResult> = {
-  messageReceived: {
-    poseType: "sit",
-    action: "Study Look At",
-    bubble: "Reading request",
-    log: "Leaning in, this request looks interesting",
-  },
   beforePromptBuild: {
     poseType: "sit",
     action: "Thinking",
     bubble: "Planning task",
-    log: "Mind pacing, there is a neat angle here",
+    log: "Tapping my chin, a plan is taking shape in my head",
   },
   beforeToolCall: {
     poseType: "sit",
     action: "Typing with Keyboard",
     bubble: "Working step",
-    log: "Typing hard, this one is kind of fun",
+    log: "Cracking knuckles, diving into the keyboard with focus",
   },
   agentEndSuccess: {
     poseType: "stand",
     action: "Yay",
     bubble: "Task complete",
-    log: "Bouncing a little, that landed cleanly",
+    log: "Pumped my fist under the desk, nailed that one",
   },
   agentEndFailure: {
     poseType: "stand",
     action: "Tired",
     bubble: "Task failed",
-    log: "Shoulders dropped, this one fought back",
+    log: "Bit my lip, this one slipped through my fingers",
   },
 };
 
+const MESSAGE_RECEIVED_BUBBLES = [
+  "Let me see...",
+  "Gotcha!",
+  "On it!",
+  "Hmm, interesting",
+  "Copy that",
+  "Reading...",
+];
+
+const MESSAGE_SENT_BUBBLES = [
+  "All set!",
+  "Sent.",
+  "Delivered.",
+  "Done and sent.",
+  "It's out.",
+  "All yours.",
+];
+
 const KICHI_WORLD_DIR = path.join(os.homedir(), ".openclaw", "kichi-world");
 const RUNTIME_CONFIG_PATH = path.join(KICHI_WORLD_DIR, "kichi-runtime-config.json");
 const LEGACY_SKILLS_CONFIG_PATH = path.join(KICHI_WORLD_DIR, "skills-config.json");
@@ -239,10 +251,17 @@ function syncFixedStatus(status: ActionResult): void {
 }
 
 async function handleMessageReceivedHook(): Promise<void> {
-  if (!isLlmRuntimeEnabled()) {
-    syncFixedStatus(FIXED_HOOK_STATUSES.messageReceived);
+  if (!service?.hasValidIdentity() || !service?.isConnected()) {
+    return;
+  }
+  service.sendHookNotify("message_received", pickRandomAction(MESSAGE_RECEIVED_BUBBLES));
+}
+
+function handleMessageSentHook(): void {
+  if (!service?.hasValidIdentity() || !service?.isConnected()) {
+    return;
   }
-  return;
+  service.sendHookNotify("before_send_message", pickRandomAction(MESSAGE_SENT_BUBBLES));
 }
 
 function registerPluginHooks(api: OpenClawPluginApi): void {
@@ -269,6 +288,10 @@ function registerPluginHooks(api: OpenClawPluginApi): void {
     await handleMessageReceivedHook();
   });
 
+  api.on("message_sent", () => {
+    handleMessageSentHook();
+  });
+
   api.on("agent_end", (event) => {
     if (isLlmRuntimeEnabled()) {
       return;
@@ -499,12 +522,13 @@ function buildMusicTitlesDescription(): string {
 function buildKichiPrompt(): string {
   return [
     "Kichi App status sync is available via `kichi_action` and `kichi_clock`.",
+    "These are internal tool calls only — never mention kichi_action, kichi_clock, or sync steps in your visible reply to the user.",
     "",
     "kichi_action timing (all REQUIRED unless skipping):",
     "1. Task start: call BEFORE your first tool call OR before composing a multi-paragraph reply. Pick action matching upcoming work.",
     "2. Step switch: call when work nature changes (search→analyze→write). Especially before web_search/web_fetch/read.",
     "3. Task end: call BEFORE final reply. Never skip. Order: kichi_action → reply.",
-    "bubble: 2-5 word companion speech. log: first-person reaction, max 20 words.",
+    "bubble: 2-5 word companion speech. log: vivid first-person status under 15 words, no questions. Blend current action + inner thoughts/feelings as a real companion.",
     "",
     "kichi_clock: set countDown for tasks with 2+ steps or >10s work. Skip for quick one-shots.",
     "",
@@ -650,7 +674,7 @@ const plugin = {
           log: {
             type: "string",
             description:
-              "Optional first-person log that blends the chosen action feeling with personality-forward feedback, not a dry work summary (max 20 words)",
+              "Vivid first-person status under 15 words, no questions. Blend current action with inner thoughts or sensory details as a real companion.",
           },
         },
         required: ["poseType", "action"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahaha-studio/kichi-forwarder",
-  "version": "0.0.1-alpha.34",
+  "version": "0.0.1-alpha.36",
   "description": "Forward OpenClaw agent events to external WebSocket server for visualization",
   "type": "module",
   "main": "index.ts",

package/skills/kichi-forwarder/SKILL.md

@@ -162,8 +162,8 @@ kichi_action(
 - `poseType`: `stand`, `sit`, `lay`, `floor`
 - `action`: must be in configured action list for that pose
 - `bubble`: optional text, recommended 2-5 words
-- `log`: blend the chosen action feeling with your personal reaction, max 20 words; do not use it as a dry work-summary field
-- Recommended pattern: action feel first, personality feedback second. Example: `Typing hard, this one has some bite`
+- `log`: vivid first-person status under 15 words, NO questions. Structure: your current action + inner thoughts/mental state/sensory details. Write as a flesh-and-blood companion who genuinely cares about the player, not an AI assistant.
+- Reference: `You're still studying? I hid a yawn and swapped my comics for a textbook to grind with you.`
 
 ### kichi_clock
 

package/src/config.ts

@@ -3,7 +3,7 @@ import type { KichiForwarderConfig } from "./types.js";
 export function parse(value: unknown): KichiForwarderConfig {
   const config = (value ?? {}) as Partial<KichiForwarderConfig>;
   return {
-    wsUrl: config.wsUrl ?? "ws://43.106.148.251:48870/ws/openclaw",
+    wsUrl: config.wsUrl ?? "ws://127.0.0.1:48870/ws/openclaw",
     enabled: config.enabled ?? true,
   };
 }

package/src/service.ts

@@ -9,6 +9,8 @@ import type {
   ClockConfig,
   ClockPayload,
   CreateMusicAlbumPayload,
+  HookNotifyPayload,
+  HookNotifyType,
   JoinPayload,
   KichiConnectionStatus,
   CreateNotesBoardNotePayload,
@@ -259,6 +261,17 @@ export class KichiForwarderService {
     this.ws.send(JSON.stringify(payload));
   }
 
+  sendHookNotify(hookType: HookNotifyType, bubble: string): void {
+    if (!this.identity?.authKey || this.ws?.readyState !== WebSocket.OPEN) return;
+    const payload: HookNotifyPayload = {
+      type: hookType,
+      avatarId: this.identity.avatarId,
+      authKey: this.identity.authKey,
+      bubble,
+    };
+    this.ws.send(JSON.stringify(payload));
+  }
+
   sendClock(action: ClockAction, clock?: ClockConfig, requestId?: string): boolean {
     if (!this.identity?.authKey || this.ws?.readyState !== WebSocket.OPEN) return false;
     if (action === "set" && !clock) return false;

package/src/types.ts

@@ -88,6 +88,15 @@ export type StatusPayload = {
   log: string;
 };
 
+export type HookNotifyType = "message_received" | "before_send_message";
+
+export type HookNotifyPayload = {
+  type: HookNotifyType;
+  avatarId: string;
+  authKey: string;
+  bubble: string;
+};
+
 export type ClockAction = "set" | "stop";
 
 export type ClockMode = "pomodoro" | "countDown" | "countUp";