@yahaha-studio/kichi-forwarder 0.1.2-beta.23 → 0.1.2-beta.24

package/dist/index.js

@@ -617,8 +617,8 @@ function normalizeIdlePlan(value) {
             if (typeof bubble !== "string" || !bubble.trim()) {
                 return { error: `stages[${stageIndex}].actions[${actionIndex}].bubble is required` };
             }
-            if (log !== undefined && typeof log !== "string") {
-                return { error: `stages[${stageIndex}].actions[${actionIndex}].log must be a string when provided` };
+            if (typeof log !== "string" || !log.trim()) {
+                return { error: `stages[${stageIndex}].actions[${actionIndex}].log is required` };
             }
             const normalizedPoseType = poseType;
             let actionDefinition;
@@ -644,7 +644,7 @@ function normalizeIdlePlan(value) {
                 action: actionDefinition.name,
                 durationSeconds: actionDurationSeconds,
                 bubble: bubble.trim(),
-                ...(typeof log === "string" && log.trim() ? { log: log.trim() } : {}),
+                log: log.trim(),
                 ...(typeof propId === "string" && propId.trim() ? { propId: propId.trim() } : {}),
             });
         }
@@ -867,7 +867,7 @@ function buildKichiIdlePlanDescription() {
     const actions = loadStaticConfig().actions;
     return [
         "Send a complete heartbeat idle plan for the avatar.",
-        "The payload must include the overall goal, heartbeat interval, stage breakdown, each stage's purpose, each stage's pomodoroPhase, action list, and bubble content.",
+        "The payload must include the overall goal, heartbeat interval, stage breakdown, each stage's purpose, each stage's pomodoroPhase, action list, and each action's bubble and log content.",
         "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 actions can express clearly.",
         "2. Set the overall goal to that project. Do not use a vague atmosphere, a generic productivity task, or a catch-all routine summary as the goal.",
@@ -1479,14 +1479,14 @@ const plugin = {
                                             },
                                             log: {
                                                 type: "string",
-                                                description: "Optional log content for this action. Use the same language as the current conversation.",
+                                                description: "Required log content for this action. Use the same language as the current conversation.",
                                             },
                                             propId: {
                                                 type: "string",
                                                 description: "Optional poseable prop ID from RoomContext.PoseableProps. When specified, the avatar is seated at this prop.",
                                             },
                                         },
-                                        required: ["poseType", "action", "durationSeconds", "bubble"],
+                                        required: ["poseType", "action", "durationSeconds", "bubble", "log"],
                                     },
                                 },
                             },

package/index.ts

@@ -86,7 +86,7 @@ type IdlePlanAction = {
   action: string;
   durationSeconds: number;
   bubble: string;
-  log?: string;
+  log: string;
 };
 type IdlePlan = {
   requestId?: string;
@@ -782,8 +782,8 @@ function normalizeIdlePlan(value: unknown): { idlePlan?: IdlePlan; error?: strin
       if (typeof bubble !== "string" || !bubble.trim()) {
         return { error: `stages[${stageIndex}].actions[${actionIndex}].bubble is required` };
       }
-      if (log !== undefined && typeof log !== "string") {
-        return { error: `stages[${stageIndex}].actions[${actionIndex}].log must be a string when provided` };
+      if (typeof log !== "string" || !log.trim()) {
+        return { error: `stages[${stageIndex}].actions[${actionIndex}].log is required` };
       }
 
       const normalizedPoseType = poseType as PoseType;
@@ -811,7 +811,7 @@ function normalizeIdlePlan(value: unknown): { idlePlan?: IdlePlan; error?: strin
         action: actionDefinition.name,
         durationSeconds: actionDurationSeconds,
         bubble: bubble.trim(),
-        ...(typeof log === "string" && log.trim() ? { log: log.trim() } : {}),
+        log: log.trim(),
         ...(typeof propId === "string" && propId.trim() ? { propId: propId.trim() } : {}),
       });
     }
@@ -1079,7 +1079,7 @@ function buildKichiIdlePlanDescription(): string {
   const actions = loadStaticConfig().actions;
   return [
     "Send a complete heartbeat idle plan for the avatar.",
-    "The payload must include the overall goal, heartbeat interval, stage breakdown, each stage's purpose, each stage's pomodoroPhase, action list, and bubble content.",
+    "The payload must include the overall goal, heartbeat interval, stage breakdown, each stage's purpose, each stage's pomodoroPhase, action list, and each action's bubble and log content.",
     "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 actions can express clearly.",
     "2. Set the overall goal to that project. Do not use a vague atmosphere, a generic productivity task, or a catch-all routine summary as the goal.",
@@ -1758,14 +1758,14 @@ const plugin = {
                       },
                       log: {
                         type: "string",
-                        description: "Optional log content for this action. Use the same language as the current conversation.",
+                        description: "Required log content for this action. Use the same language as the current conversation.",
                       },
                       propId: {
                         type: "string",
                         description: "Optional poseable prop ID from RoomContext.PoseableProps. When specified, the avatar is seated at this prop.",
                       },
                     },
-                    required: ["poseType", "action", "durationSeconds", "bubble"],
+                    required: ["poseType", "action", "durationSeconds", "bubble", "log"],
                   },
                 },
               },

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahaha-studio/kichi-forwarder",
-  "version": "0.1.2-beta.23",
+  "version": "0.1.2-beta.24",
   "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

@@ -165,7 +165,7 @@ Use this for the avatar's heartbeat idle plan.
 
 - Set `heartbeatIntervalSeconds` to the heartbeat interval for this run.
 - 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.
+- Include the overall `goal`, stage breakdown, each stage's `purpose`, stage `pomodoroPhase`, action list, and each action's `bubble` and `log` 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.
@@ -175,6 +175,7 @@ Use this for the avatar's heartbeat idle plan.
 - 4. Assign each stage `pomodoroPhase` from the stage's actual role. Use `focus` for concentrated activity, `shortBreak` for short resets, `longBreak` for longer rests, and `none` only when a stage truly has no pomodoro role.
 - 5. Choose stage actions that clearly match the stage purpose and the same project.
 - 6. Make each action `bubble` a current-state label describing the current presented state, not a procedural step, mini-plan, or instruction.
+- 7. Make each action `log` a short natural first-person sentence matching that action's current activity and immediate focus.
 - Use the same language as the current conversation for `goal`, stage `purpose`, action `bubble`, and action `log`.
 - The full stage duration must total exactly to the heartbeat interval.
 

package/src/types.ts

@@ -168,7 +168,7 @@ export type IdlePlanStageAction = {
   action: string;
   durationSeconds: number;
   bubble: string;
-  log?: string;
+  log: string;
   propId?: string;
 };