@yahaha-studio/kichi-forwarder 0.0.1-alpha.33 → 0.0.1-alpha.35

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;
   }
-  return;
+  service.sendHookNotify("message_received", pickRandomAction(MESSAGE_RECEIVED_BUBBLES));
+}
+
+function handleMessageSentHook(): void {
+  if (!service?.hasValidIdentity() || !service?.isConnected()) {
+    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;
@@ -501,16 +524,13 @@ function buildKichiPrompt(): string {
     "Kichi App status sync is available via `kichi_action` and `kichi_clock`.",
     "",
     "kichi_action timing (all REQUIRED unless skipping):",
-    "1. Task start: call BEFORE your first tool call. Pick action matching upcoming work.",
+    "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.",
-    "Skip start/switch only if entire turn is a short reply with zero tool calls.",
-    "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.",
     "",
-    "kichi_music_album_create: call kichi_query_status first. Tracks from ~/kichi-world/album-config.json.",
-    "",
     "Skip all sync if: user opts out, task is kichi config/test, or user requests specific pose.",
   ].join("\n");
 }
@@ -653,7 +673,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/openclaw.plugin.json

@@ -1,10 +1,10 @@
-{
-  "id": "kichi-forwarder",
-  "name": "Kichi Forwarder",
+{
+  "id": "kichi-forwarder",
+  "name": "Kichi Forwarder",
   "description": "Sync agent lifecycle/status to Kichi world and provide Kichi timer/noteboard tools",
-  "version": "0.2.1",
-  "author": "OpenClaw",
-  "skills": ["./skills/kichi-forwarder"],
+  "version": "0.0.1",
+  "author": "OpenClaw",
+  "skills": ["./skills/kichi-forwarder"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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

package/skills/kichi-forwarder/SKILL.md

@@ -162,9 +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`: optional first-person inner reaction or personality-forward feedback, max 20 words
-- `log` should blend the chosen action feeling with your personal reaction; 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/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";