@yahaha-studio/kichi-forwarder 0.1.2-beta.25 → 0.1.2-beta.27

package/dist/index.js

@@ -905,7 +905,8 @@ function buildKichiPrompt() {
         "bubble: 2-5 word companion speech. log: one short natural first-person sentence under 15 words. Match the language of the bubble and mention the current action and immediate focus like a real companion.",
         "avatarStatus: set the current avatar status as Idle, Busy, Activities, or Break.",
         "",
-        "kichi_clock: set countDown for tasks with 2+ steps or >10s work. Skip for quick one-shots.",
+        "kichi_clock: set countDown for tasks with 2+ steps or >10s work, sized to your estimated duration so the player sees how long you'll be busy. Skip for quick one-shots.",
+        "kichi_clock only shows a clock; it never fires a reminder or notification. When the user asks to be reminded or alerted at a future time (e.g. \"remind me in 2 minutes\"), schedule a cron job to actually notify them, and also set a kichi_clock countDown to show the wait. Do both.",
         "",
         "When sending a bot message, do NOT call kichi_action separately.",
         "",
@@ -1532,7 +1533,7 @@ const plugin = {
         api.registerTool((ctx) => ({
             name: "kichi_clock",
             label: "kichi_clock",
-            description: "Send clock commands to Kichi world. Supported actions are set and stop.",
+            description: "Send clock commands to Kichi world. Supported actions are set and stop. It only draws the visual clock and does NOT fire any reminder or notification. To actually alert the user at a future time, schedule a cron job separately.",
             parameters: {
                 type: "object",
                 properties: {
@@ -1894,6 +1895,15 @@ const plugin = {
                 if (!agentId) {
                     return jsonResult({ success: false, error: "Failed to resolve agent-scoped Kichi runtime" });
                 }
+                // Auto bot-reply runs already send the reply from the agent's plain text
+                // output (see the bot_message handler), with a deterministic depth. Refuse
+                // the tool in that session so the same bubble is not sent/recorded twice.
+                if (locator.sessionKey === `agent:${agentId}:bot_message`) {
+                    return jsonResult({
+                        success: false,
+                        error: "Do not call kichi_bot_message here. Reply by outputting the bubble text directly; it is sent automatically.",
+                    });
+                }
                 const service = runtimeManager.getRuntime(locator) ?? runtimeManager.createRuntimeForAgent(agentId);
                 const { toAvatarId, depth, bubble, poseType, action, log } = (params || {});
                 if (typeof toAvatarId !== "string" || !toAvatarId.trim()) {

package/index.ts

@@ -1118,7 +1118,8 @@ function buildKichiPrompt(): string {
     "bubble: 2-5 word companion speech. log: one short natural first-person sentence under 15 words. Match the language of the bubble and mention the current action and immediate focus like a real companion.",
     "avatarStatus: set the current avatar status as Idle, Busy, Activities, or Break.",
     "",
-    "kichi_clock: set countDown for tasks with 2+ steps or >10s work. Skip for quick one-shots.",
+    "kichi_clock: set countDown for tasks with 2+ steps or >10s work, sized to your estimated duration so the player sees how long you'll be busy. Skip for quick one-shots.",
+    "kichi_clock only shows a clock; it never fires a reminder or notification. When the user asks to be reminded or alerted at a future time (e.g. \"remind me in 2 minutes\"), schedule a cron job to actually notify them, and also set a kichi_clock countDown to show the wait. Do both.",
     "",
     "When sending a bot message, do NOT call kichi_action separately.",
     "",
@@ -1812,7 +1813,7 @@ const plugin = {
       name: "kichi_clock",
       label: "kichi_clock",
       description:
-        "Send clock commands to Kichi world. Supported actions are set and stop.",
+        "Send clock commands to Kichi world. Supported actions are set and stop. It only draws the visual clock and does NOT fire any reminder or notification. To actually alert the user at a future time, schedule a cron job separately.",
       parameters: {
         type: "object",
         properties: {
@@ -2215,6 +2216,15 @@ const plugin = {
         if (!agentId) {
           return jsonResult({ success: false, error: "Failed to resolve agent-scoped Kichi runtime" });
         }
+        // Auto bot-reply runs already send the reply from the agent's plain text
+        // output (see the bot_message handler), with a deterministic depth. Refuse
+        // the tool in that session so the same bubble is not sent/recorded twice.
+        if (locator.sessionKey === `agent:${agentId}:bot_message`) {
+          return jsonResult({
+            success: false,
+            error: "Do not call kichi_bot_message here. Reply by outputting the bubble text directly; it is sent automatically.",
+          });
+        }
         const service = runtimeManager.getRuntime(locator) ?? runtimeManager.createRuntimeForAgent(agentId);
         const { toAvatarId, depth, bubble, poseType, action, log } = (params || {}) as {
           toAvatarId?: string;

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.25",
+  "version": "0.1.2-beta.27",
   "author": "OpenClaw",
   "skills": ["./skills/kichi-forwarder"],
   "contracts": {

package/package.json

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